عن المشروع

affe-agent هي مكتبة TypeScript تعمل كنواة تنفيذ وكلاء أصلية لـ Effect، وتقع بين بدائيات 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 وweb doubles ومجموعات توافق - قابلية نقل عبر بيئات التشغيل Node وBun وDeno والبيئات الطرفية (Cloudflare Workers) المكتبة في الإصدار 0.0.1 (قبل الإصدار النهائي). التصميم مستقر، لكن البنية الأساسية لـ Effect v4 ما زالت في مرحلة الإصدار المرشّح، لذا يُتوقع حدوث تغييرات في واجهة برمجة التطبيقات من Effect حتى الإصدار العام (GA). يوصي المشروع بتثبيت الإصدارات الدقيقة لكل من affe-agent وeffect وموفري @effect/ai-* معًا. يتضمن المستودع أيضًا تطبيقات مرجعية: واجهة TUI محلية للبرمجة بملء الشاشة، وعميل CLI تقليدي، ونشر على Cloudflare Worker مع كائن Durable Object واحد لكل جلسة.