منصوبے کے بارے میں

affe-agent ایک TypeScript لائبریری ہے جو ایفیکٹ-نیٹیو ایجنٹ ایگزیکیوشن کرنل کے طور پر کام کرتی ہے، جو Effect AI کے LanguageModel، Prompt، Tool، اور Toolkit پرائمیٹیو اور ایپلیکیشن پرت کے درمیان بیٹھتی ہے۔ یہ سیشن، رن، ٹرن، اسٹیئرنگ، فالو اپ، مداخلت، اور لائف سائیکل ایونٹ کی پرت فراہم کرتی ہے جسے ایجنٹ ایپلیکیشنز عام طور پر دوبارہ ایجاد کرتی ہیں۔ بنیادی ماڈل سیشنز → سبمیشنز → رنز → ٹرنز ہے، جس میں ایک اپینڈ-اونلی کینونیکل ہسٹری اور ٹائپ شدہ لائف سائیکل ایونٹس ہیں۔ کرنل چھوٹا اور قابل توسیع ہے چند سیون کے ذریعے: toolkit/tools، contextTransform، loop، permission، toolExecution، elicitation، InputChannel، eventSink/events، AgentSessionHost، LanguageModel، اور Sandbox۔ بیٹریاں ان سیون میں پلگ ہوتی ہیں تاکہ بنیادی حصے میں ترمیم کیے بغیر صلاحیتیں شامل کی جا سکیں۔ اہم صلاحیتوں میں شامل ہیں: - متعدد ٹرانسپورٹس: HTTP، RPC، AG-UI، A2A، MCP (v1 اور v2)، OpenAI-مطابق تکمیلیں، اور کنیکٹر (Slack) - کوڈنگ کے لیے بیٹریاں (سینڈ باکس پر فائل/شیل ٹولز)، ویب (تلاش، محفوظ فیچ، رینڈرڈ پیج کیپچر)، ذیلی ایجنٹس، میموری، مہارتیں، کمپیکشن، بجٹ (ٹوکن اور رقم کی حدیں)، ماڈل میٹا ڈیٹا، مشاہدہ، ریڈکشن، ڈیٹا، ہکس، شیڈولنگ، ٹری (برانچ ایبل سیشنز)، سیشنز (صفحہ بند ڈائریکٹری)، ایکسپورٹ (سنیشن اور JSONL)، بلاب اسٹوریج، پلگ ان، اور پری سیٹس - Effect Workflow کے ذریعے پائیدار عملدرآمد، کلسٹر سپورٹ اور Durable Streams کے ساتھ - سینڈ باکس تجرید جس میں پورٹیبل اور مقامی (Node) نفاذات ہیں - جانچ کی افادیت بشمول اسکرپٹ شدہ TestLanguageModel، AgentProbe، ویب ڈبلز، اور مطابقت کے سوٹ - Node، Bun، Deno، اور ایج رن ٹائمز (Cloudflare Workers) میں رن ٹائم پورٹیبلٹی لائبریری ورژن 0.0.1 (پری-ریلیز) پر ہے۔ ڈیزائن مستحکم ہے لیکن بنیادی Effect v4 سبسٹریٹ اب بھی ریلیز کینڈیڈیٹ پر ہے، لہذا Effect سے API تبدیلی کی توقع ہے جب تک GA نہ ہو۔ پروجیکٹ affe-agent، effect، اور @effect/ai-* فراہم کنندگان کے عین ورژن ایک ساتھ پن کرنے کی سفارش کرتا ہے۔ ریپوزٹری میں حوالہ ایپلیکیشنز بھی شامل ہیں: ایک مکمل اسکرین مقامی کوڈنگ TUI، ایک روایتی CLI کلائنٹ، اور ایک Cloudflare Worker تعیناتی جس میں فی سیشن ایک Durable Object ہے۔