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

ایجنٹ پوڈ AI ایجنٹ رن ٹائمز کے لیے ایک پورٹیبل کمانڈ سینٹر ہے — ایک ایسی جگہ جہاں سے ایجنٹوں کے ماحول کا انتظام کیا جا سکتا ہے، چاہے وہ کہیں بھی چل رہے ہوں۔ ہر رن ٹائم کے لیے یہ فائل سسٹم، لاگز، ٹرمینل، کنفیگریشن، ہیلتھ، لائف سائیکل، کلین اپ اور پروویژننگ کا انتظام کرتا ہے، مشینوں، ہارنیسز اور نیٹ ورک باؤنڈریز کے پار۔ یہ attach-first ہے: آپ اسے اپنے پہلے سے چلنے والے رن ٹائمز کی طرف اشارہ کرتے ہیں، یا اسے نئے بنانے دیتے ہیں۔ آرکیٹیکچر تین ٹائروں پر مشتمل ہے۔ آپریٹر کا سامنا کرنے والا کنسول ایک SvelteKit اسٹیٹک SPA ہے جو HTTPS اور WSS کے ذریعے ہب سے بات کرتا ہے۔ ہب Bun، Hono اور Postgres (Drizzle کے ذریعے) پر بنایا گیا ہے اور یہ نوڈ/اسٹیشن رجسٹری، کنکشن بروکر، اندراج اور تصدیقی سروس (Better Auth)، آڈٹ اور ایکٹیویٹی لاگ، اور پروویژننگ ڈرائیور ہوسٹ کا کام کرتا ہے۔ نوڈ-ایجنٹ ایک اسٹیٹک Go بائنری ہے جو ہر ہوسٹ پر انسٹال ہوتی ہے اور WSS کے ذریعے ہب کو *آؤٹ* ڈائل کرتی ہے، اس لیے یہ NAT اور CGNAT کے پیچھے بھی کام کرتی ہے بغیر ان باؤنڈ پورٹس کھولے۔ ہر نوڈ-ایجنٹ ہارنیس ڈیسکرپٹرز چلاتا ہے اور کنٹریکٹ وربز کو مقامی طور پر انجام دیتا ہے۔ ایجنٹ پوڈ کئی ایجنٹ ہارنیسز کے لیے ڈیسکرپٹرز فراہم کرتا ہے — Hermes، OpenClaw، Claude Code، Codex، OpenCode اور Pi — جو `apps/node-agent/cmd/agentpod-node/registry.go` میں رجسٹرڈ ہیں۔ ہر ڈیسکرپٹر ہارنیس کے مقامی CLI یا API کو لپیٹ کر رن ٹائمز کی فہرست بناتا ہے، کنفیگ، لاگز اور ورک اسپیس تلاش کرتا ہے، اور ہر ہارنیس کی انٹروسپیکشن کو دوبارہ ایجاد کیے بغیر لائف سائیکل آپریشنز نافذ کرتا ہے۔ ڈیپلائمنٹ سیدھا ہے: ہب کو Postgres اور Bun کے ساتھ چلائیں (پہلی شروع پر خودکار مائیگریشن)، کنسول کو pnpm کے ساتھ build کریں اور اسٹیٹک آؤٹ پٹ کو Cloudflare Pages یا کسی بھی اسٹیٹک ہوسٹ پر ہب کے رجسٹریبل ڈومین کے ذیلی ڈومین پر تعینات کریں (تاکہ Better Auth سیشن کوکی same-site رہے)، پھر curl-piped انسٹال اسکرپٹ کے ذریعے ٹارگٹ ہوسٹس پر نوڈ-ایجنٹس کو رجسٹر کریں جو systemd سروس انسٹال کرتا ہے۔ linux/darwin × amd64/arm64 کے لیے پری بلٹ بائنریز ہر `v*` ٹیگ پر GitHub Actions کے ذریعے شائع ہوتی ہیں۔ اسٹیٹس سنگل-آپریٹر ہے: ایک ایڈمن اکاؤنٹ، پہلے صارف کے بعد سائن اپ بند ہو جاتا ہے، ریلیزز `v0.1.x` ٹیگ ہوتی ہیں۔ ٹیننٹ آئسولیشن باؤنڈری مکمل ہو چکی ہے — ایک `tenants` ٹیبل، ہر اسکوپڈ ٹیبل پر `tenant_id`، اور ایک `tenantScope()` ہیلپر جو بغیر اس کے کوئری بنانے سے انکار کرتا ہے، یونٹ ٹیسٹس کے ساتھ مضبوط کیا گیا ہے۔ آج سب کچھ سنگل بوٹسٹریپ ٹیننٹ `fleet_00000000000000000000` کے تحت چلتا ہے؛ جو باقی ہے وہ وہی ہے جو باؤنڈری استعمال کرتی ہے: orgs، پرنسپلز اور بلنگ۔ پچھلی OpenCode پر مبنی پروڈکٹ `v0.0.4-opencode` ٹیگ پر منجمد ہے اور دستاویزات `docs/archive/` میں محفوظ ہیں۔ لائسنس MIT ہے۔