عن المشروع

AgentPod هي مركز قيادة محمول لبيئات تشغيل وكلاء الذكاء الاصطناعي — مكان واحد لإدارة البيئات التي تعيش فيها الوكلاء، أينما كانت تعمل. لكل بيئة تشغيل، يدير نظام الملفات والسجلات والطرفية والإعدادات والصحة ودورة الحياة والتنظيف والتوفير، عبر الأجهزة والمنصات وحدود الشبكة. وهو قائم على الإرفاق أولاً: توجّهه إلى بيئات تشغيل تديرها بالفعل، أو تتركه يوفّر بيئات جديدة. البنية مكوّنة من ثلاث طبقات. وحدة التحكم الموجّهة للمشغّل هي تطبيق صفحة واحدة ثابت SvelteKit يتصل بالمركز عبر HTTPS و WSS. المركز مبني على Bun و Hono و Postgres (عبر Drizzle) ويعمل كسجل للعقد/المحطات، ووسيط اتصالات، وخدمة تسجيل ومصادقة (Better Auth)، وسجل تدقيق ونشاط، ومضيف لسائق التوفير. وكيل العقدة هو ثنائي Go ثابت يُثبَّت على كل مضيف، ويتصل *خارجياً* بالمركز عبر WSS، لذا يعمل خلف NAT و CGNAT دون فتح منافذ واردة. كل وكيل عقدة يشغّل واصفات الحِزم وينفّذ أفعال العقد محلياً. يشحن AgentPod واصفات للعديد من حِزم الوكلاء — Hermes و OpenClaw و Claude Code و Codex و OpenCode و Pi — مسجلة في `apps/node-agent/cmd/agentpod-node/registry.go`. كل واصف يغلّف واجهة سطر الأوامر أو API الأصلية للحِزمة لتعداد بيئات التشغيل، وتحديد موقع الإعدادات والسجلات ومساحة العمل، وتنفيذ عمليات دورة الحياة دون إعادة اختراع استبطان كل حِزمة. النشر مباشر: شغّل المركز مع Postgres و Bun (مع ترحيل تلقائي عند أول تشغيل)، وابنِ وحدة التحكم باستخدام pnpm وانشر المخرجات الثابتة إلى Cloudflare Pages أو أي مضيف ثابت على نطاق فرعي من النطاق القابل للتسجيل للمركز (حتى تبقى جلسة Better Auth المخزّنة في ملف تعريف الارتباط ضمن نفس الموقع)، ثم سجّل وكلاء العقد على المضيفات المستهدفة عبر سكربت تثبيت يُنفَّذ من curl يضع خدمة systemd. تُنشر الثنائيات المجمّعة مسبقاً لأنظمة linux/darwin مع amd64/arm64 عند كل وسم `v*` عبر GitHub Actions. الحالة هي مشغّل واحد: حساب إداري واحد، يُغلق التسجيل بعد أول مستخدم، والإصدارات موسومة `v0.1.x`. حدود عزل المستأجرين قد اكتملت — جدول `tenants`، و`tenant_id` في كل جدول موسوم، ودالة `tenantScope()` ترفض بناء استعلام بدونها، مثبّتة باختبارات الوحدة. يعمل كل شيء اليوم تحت مستأجر التمهيد الفردي `fleet_00000000000000000000`؛ وما تبقى هو ما يستخدم الحدود: المؤسسات والمسؤولون والفواتير. المنتج السابق المبني على OpenCode مجمّد عند الوسم `v0.0.4-opencode` مع وثائق مؤرشفة تحت `docs/archive/`. مرخّص بموجب MIT.