প্রকল্প সম্পর্কে

A3S Cloud হলো একটি সেলফ-হোস্টেড, এজেন্ট-ফার্স্ট ডেভেলপার প্ল্যাটফর্ম। এর README-তে একটি কন্ট্রোল প্লেনের বর্ণনা দেওয়া হয়েছে যেখানে প্রোডাক্ট এবং ডিজায়ার্ড-স্টেট ট্রুথ Cloud-এ থাকে, টেকসই কাজের সমন্বয় A3S Flow দ্বারা করা হয়, লাইফসাইকেল কন্ট্রাক্ট A3S Runtime দ্বারা সংজ্ঞায়িত হয়, এক্সিকিউশন A3S Box দ্বারা পরিচালিত হয় এবং A3S Gateway হলো একমাত্র পাবলিক এজ। এই রিপোজিটরিটি MIT লাইসেন্সের অধীনে এবং এটি Rust 1.88 বা তার পরবর্তী সংস্করণ, PostgreSQL 17 বা সামঞ্জস্যপূর্ণ রিলিজ, A3S Box, একটি পিনড A3S Gateway রিভিশন এবং প্রোডাকশনের জন্য NATS JetStream (Worker বা Relay রোল) লক্ষ্য করে তৈরি। TypeScript ক্লায়েন্ট বা CLI ডেভেলপমেন্টের জন্য শুধুমাত্র Bun তালিকাভুক্ত করা হয়েছে। এর আর্কিটেকচার প্রতিটি সার্ভিসের জন্য একটি নির্দিষ্ট পথ অনুসরণ করে: Gateway এবং Identity-র মাধ্যমে পাবলিক ট্রাফিক গ্রহণ করা; A3S ORM-এর মাধ্যমে PostgreSQL-এ ডিজায়ার্ড স্টেট, আইডেমপোটেন্সি, অডিট এভিডেন্স এবং Outbox ফ্যাক্টস জমা করা; A3S Flow এবং Operations-এর মাধ্যমে টেকসই ওয়েট, রিট্রাই, রিপ্লে, অ্যাপ্রুভাল, কম্পেনসেশন এবং ক্যানসলেশনের সমন্বয় করা; Box-এ Runtime Task বা Service ইউনিটের মাধ্যমে Workloads এবং Fleet-এর সাহায্যে স্থাপন ও এক্সিকিউট করা; এবং সবশেষে Edge এবং Gateway-র মাধ্যমে ভার্সনড রুট স্ন্যাপশট পাবলিশ করা। Cloud কখনোই দ্বিতীয় রিকোয়েস্ট-বাইট প্রক্সি হিসেবে কাজ করে না। ছয়টি প্রোডাক্ট আউটকাম দুটি এক্সিকিউশন ক্লাসের মধ্যে বিভক্ত। AaaS-এর আওতায় কথোপকথন, এক্সিকিউশন, ইভেন্ট, অ্যাপ্রুভাল, চেকপয়েন্ট, ফর্ক এবং প্রোভাইডার বাইন্ডিং অন্তর্ভুক্ত। WaaS-এর আওতায় অন্টোলজি, ইমিউটেবল ডেফিনিশন এবং প্ল্যান, WorkflowRun, HumanTask এবং টাইপড নোড অর্ডার অন্তর্ভুক্ত। FaaS ইমিউটেবল Function রিলিজ প্রোফাইল পরিচালনা করে এবং ইনভোকেশনগুলো Executions, Workloads বা Connectors-এর কাছে অর্পণ করে। Durable Cell মানুষ এবং একাধিক এজেন্টের জন্য একটি নামযুক্ত, সিরিয়ালাইজড, হাইবারনেটেবল স্টেট স্পেস প্রদান করে। Model Inference মডেল রিভিশন, ডেপ্লয়মেন্ট, রাউটিং পলিসি, ব্যবহার এবং মূল্যায়ন পরিচালনা করে, যার স্বতন্ত্র রেপ্লিকা এবং মাল্টি-নোড প্রিফিল/ডিকোড গ্রুপ রয়েছে। Static Web সরাসরি Gateway থেকে ইমিউটেবল React, Vue এবং অন্যান্য অনুমোদিত রিলিজ পরিবেশন করে, যেখানে SSR একটি সাধারণ Service প্রোফাইল হিসেবে কাজ করে। একমাত্র সাধারণ এক্সিকিউশন ক্লাসগুলো হলো Task এবং Service। কুইক স্টার্ট-এ ডিপেন্ডেন্সি এবং একটি ডিটাচড কন্ট্রোল প্লেন ব্যবহার করা হয়, যার হেলথ এন্ডপয়েন্টগুলো হলো /api/v1/health/live এবং /api/v1/health/ready, এবং একটি OpenAPI এন্ডপয়েন্ট /api/v1/openapi.json-এ অবস্থিত। সার্ভিং প্রসেস শুরু করার আগে একটি ওয়ান-শট মাইগ্রেটর চালানো আবশ্যক। বুটস্ট্র্যাপ প্রথম Organization, সার্ভিস Principal, ওনার Membership, API টোকেন, বেসলাইন প্ল্যাটফর্ম-রোল পলিসি এবং PlatformOwner বাইন্ডিং তৈরি করে। মিউটেশনগুলো Bearer অথরাইজেশন এবং একটি আইডেমপোটেন্সি কি ব্যবহার করে। CLI-টি Bun দিয়ে চালানো হয় এবং এটি এনভায়রনমেন্ট ভেরিয়েবল বা স্ট্যান্ডার্ড ইনপুট থেকে ক্রেডেনশিয়াল পড়ে, কোনো CLI কনটেক্সট ফাইল থেকে নয়। প্রোডাকশনে API শুধুমাত্র A3S Gateway-র মাধ্যমে পাবলিশ করা হয়। README-তে বর্ণিত প্ল্যাটফর্ম সক্ষমতাগুলোর মধ্যে রয়েছে হোস্ট করা Git অথরিটি এবং এক্সটারনাল সোর্স রিভিশন, ওয়েবহুক, রিপ্রোডিউসিবল Box বিল্ড, প্রোভেন্যান্স, পুল-রিকোয়েস্ট প্রিভিউ, ইমিউটেবল আর্টিফ্যাক্ট এবং ডাইজেস্ট-প্রিজার্ভিং প্রমোশন। Supply অংশটি Git, OCI Registry এবং A3S Use Registry অথরিটিগুলোকে আলাদা করে। রান এবং স্কেল করার জন্য CPU পুল, GPU পুল, এক্সিলারেটর এবং টপোলজি কনস্ট্রেইন্ট, Claims, অ্যান্টি-অ্যাফিনিটি, গ্যাং প্লেসমেন্ট, মেইনটেন্যান্স, কোটা এবং প্রিম্পশন-এর জন্য একটি হেটেরোজিনিয়াস শিডিউলার ব্যবহৃত হয়, যাতে স্টেটলেস স্কেল-টু-জিরো এবং স্টেটফুল ড্রেন, ফেন্সিং, চেকপয়েন্ট এবং রিকভারি সুবিধা রয়েছে। স্টোর এবং সার্ভ করার জন্য এক্সটারনাল S3-কম্প্যাটিবল স্টোরেজের ওপর একটি টাইপড ইমিউটেবল-অবজেক্ট ক্লায়েন্ট, Gateway-মালিকানাধীন TLS এবং রাউটিং, এবং লগ, মেট্রিক্স, ট্রেস, SLO এবং ইনসিডেন্টের জন্য OpenTelemetry ব্যবহৃত হয়। গভর্ন্যান্সের আওতায় টেন্যান্ট আইসোলেশন, মেম্বারশিপ, Resource Grants, কোটা, ক্রেডেনশিয়াল, অডিট, Outbox, লাইফসাইকেল ক্লিনআপ, সিস্টেম-অ্যাডমিনিস্ট্রেটর RBAC প্লেন, স্বল্পমেয়াদী সাপোর্ট গ্র্যান্ট এবং ওয়ার্কলোড আইডেন্টিটি রিভিশন অন্তর্ভুক্ত। README-তে উল্লেখ করা হয়েছে যে A3S Cloud কোনো ম্যানেজমেন্ট ড্যাশবোর্ড প্রদান করে না; তবে এটি অ্যাপ্লিকেশন এবং এজেন্টের জন্য ইমিউটেবল React/Vue এবং অন্যান্য টেন্যান্ট ওয়েব রিলিজ হোস্ট করে, যা অন্যান্য ক্লায়েন্টের মতো একই Gateway এবং API ব্যবহার করে। অটোমেটিক CI এবং Box কনফরম্যান্স শুধুমাত্র রিলিজ-এ পুশ এবং রিলিজ-টার্গেটেড পুল রিকোয়েস্টের জন্য চলে; main ব্রাঞ্চ স্বয়ংক্রিয়ভাবে এই ওয়ার্কফ্লো শুরু করে না। ডেলিভারি স্ট্যাটাস শতাংশ-ভিত্তিক নয়, বরং গেট-চালিত। ২০২৬-০৯-০৬ তারিখ পর্যন্ত, README-তে টেন্যান্ট-স্কোপড Identity, PostgreSQL/A3S ORM, Operations/Flow, Outbox, পাবলিক API এবং মাইগ্রেশনগুলোকে Verified ফাউন্ডেশন হিসেবে তালিকাভুক্ত করা হয়েছে। ইনস্টলেশন স্কোপ এবং সিস্টেম-অ্যাডমিনিস্ট্রেটর RBAC হলো Verified কোর, যার একটি বিস্তৃত গেট বর্তমানে প্রক্রিয়াধীন। Workloads, Fleet, Runtime/Box, Gateway, supply, কোলাবরেশন এবং এন্টারপ্রাইজ কন্ট্রোলগুলো প্রক্রিয়াধীন রয়েছে, যার A0.4 রিয়েল-প্রোভাইডার গেট ভেরিফাইড। এজেন্ট এবং হোস্ট করা MCP প্রোডাক্ট লেনগুলো প্রক্রিয়াধীন এবং A0.4 ভেরিফাইড। অন্টোলজি ওয়ার্কফ্লো এবং AI অ্যাপ্লিকেশানস/ফাইলস প্রক্রিয়াধীন। অটোমেশনগুলোর একটি কম্পোনেন্ট ফাউন্ডেশন প্রক্রিয়াধীন। Data/S0 এবং Durable Cell-এর ফাউন্ডেশন প্রক্রিয়াধীন। ওয়ার্কলোড আইডেন্টিটির ভেরিফাইড ট্রাস্ট এবং WI2-C1/C2/C3a/C3b ফাউন্ডেশন রয়েছে, তবে ফ্লিট হার্ডওয়্যার অ্যাটেস্টেশন এবং পূর্ণ ইস্যুয়েন্স এখনও বাকি। FaaS, ডিস্ট্রিবিউটেড ইনফারেন্স, মডেল সাপ্লাই, Static Web, Runtime CI/CD এবং পূর্ণ HA অপারেশনগুলো পরিকল্পিত অথবা প্রাথমিক ফাউন্ডেশন পর্যায়ে রয়েছে। আর্কিটেকচার টার্গেটগুলো অ্যাভেইলেবিলিটি দাবি নয়; একটি সক্ষমতা তখনই রিলিজ করা হয় যখন ROADMAP.md-এ রিয়েল-প্রোভাইডার, ফেইলিওর, রিকভারি, ক্লিনআপ, আপগ্রেড এবং রিলিজ গেটগুলো Verified হিসেবে চিহ্নিত হয়।