عن المشروع

core-agent هو أساس Go جاهز للإنتاج لوكلاء LLM متعددي الأدوار، مبني على مجموعة تطوير الوكلاء (ADK) من Google. يوفّر الربط الأساسي — المزوّدون، وMCP، والمهارات، والأذونات، والجلسات الدائمة، والربط عن بُعد، وواجهة Bubble Tea TUI داخل العملية، وواجهة CLI بلا واجهة رسومية — كي تركّز المشاريع اللاحقة على أدواتها ومنطق منتجاتها. **وقت التشغيل**: محادثة متعددة الأدوار عبر مشغّل ADK مع إرسال متوازٍ لاستدعاءات الأدوات. يتضمن واجهة Bubble Tea TUI داخل العملية كسطح TTY افتراضي، وبديل REPL سطري عبر --no-tui، ووسم بناء slim يُسقط شجرة TUI. يدعم الوضع المستقل عمّالاً دون إشراف مع ميزانيات للأدوار/الرموز/التكلفة/الوقت الفعلي، وإنهاءً مدفوعاً بالنموذج، واستعادة بعد الأعطال عبر نقاط تحقق دائمة. تشمل قدرات البقاء في الجلسات الطويلة ضغط السياق التلقائي بعد الدور عند نحو 85% من الاستخدام، ومهام فرعية بمغلّفات أدوات وكيلية تُبقي مخرجات الأدوات الضخمة خارج سياق الأصل، ونقاط تحقق عند حدود المهام. **المزوّدون**: Gemini API وVertex AI (مع GoogleSearch وURLContext من جهة الخادم)، وAnthropic Claude عبر api.anthropic.com وعبر Vertex AI كمهايئ نموذج أصلي. تتيح المزوّدات الوهمية (echo، وإعادة تشغيل JSONL مكتوبة، وتسجيل الجلسات) اختباراً دون بيانات اعتماد. ويتيح نظام بوّابة ثلاثي الحالات محايد تجاه المزوّد للأدوات المدمجة من جهة الخادم (web_search، url_context، code_execution) بقاء وضع الوصول إلى الإنترنت عند تبديل المزوّدين. **التعليمات والأدوات وMCP والمهارات**: تعليمات أساسية في AGENTS.md مع دليل تراكب، وتوجيه @include لتركيب متعدد الملفات، وثلاثة نطاقات (user، user-home، project) مع بدائل CLAUDE.md/GEMINI.md. يغطي كتالوج الأدوات المدمجة عمليات الملفات (read، write، edit، delete، outline)، والبحث (glob، grep)، والبيانات/الشبكة (json_query، fetch_url)، والصدفة (bash)، والتخطيط (todo، record_plan)، والتحقق (wait_and_verify)، والمطالبة التفاعلية (ask_user). خوادم MCP تُعرَّف في mcp.json بنقل stdio وStreamable HTTP، وأدوات مُنَطَّقة، وتوجيه مقيّد بالأذونات. مهارات متوافقة مع Claude تُكتشف تلقائياً من ملفات SKILL.md مع إعلانات المتطلبات (مثل shell، kubectl، gcloud) التي تُحجب عند بدء التشغيل إن لم تُلبَّ. **الأذونات**: أوضاع ask/allow/yolo مع قوائم سماح/منع قائمة على الأنماط، وفرض نطاق المسار على أدوات الملفات، وقائمة سماح لنطاق URL لـ fetch_url، وقائمة منع bash غير قابلة للتجاوز. يمكن لفرض التخطيط أولاً أن يتطلب خطة مسجّلة قبل استدعاءات الأدوات المُعدِّلة (الوضع المطلوب) أو تسجيل الخطط دون حجب (الوضع الاستشاري للتشغيلات دون إشراف). تعمل واجهة Prompter القابلة للتوصيل عبر TTY أو بلا واجهة أو TUI أو واجهات ويب مخصصة. **الاستمرارية والمراقبة**: جلسات دائمة وسجل تدقيق عبر SQLite (Go خالص، بلا CGO)، أو Postgres، أو MySQL مع seq أحادي الاتجاه، وإعادة تشغيل، ومراقبة مباشرة، وقفل الجلسات لاستئناف آمن بعد الأعطال متعدد العمليات. تصدير OpenTelemetry اختياري (console/OTLP، معطّل افتراضياً). تتبّع الرموز والتكلفة لكل نموذج مع تسعير طبقى (تحديث LiteLLM اليومي، وتجاوزات لكل إعداد). **الربط عن بُعد وسطح المشغّل**: HTTP + SSE مع مراقبة مباشرة ونقاط inject/wake عبر mTLS ومصادقة bearer. ضوابط hold/interrupt/pause للمشغّل لإلغاء الدور الجاري وإيقاف الحلقة. عميل TUI عن بُعد (ثنائي مُصدَّر بإصدار منفصل) بتكافؤ كامل لأوامر الشرطة المائلة، وتذييل تكلفة لكل دور، ونوافذ موافقة أدوات مباشرة، وتبديل الجلسات. خادم متعدد الجلسات مع هوية لكل متصل، وقوائم ACL (Owner/Viewers/Contributors)، ومنح أذونات، وتراكبات تعليمات، ونسب تدقيق؛ تبقى الجلسات بعد إعادة تشغيل الخادم. اكتشاف بطاقة الوكيل عبر /.well-known/agent-card.json بشكل A2A AgentCard. تسجيل الأقران لاكتشاف الأسطول بنمط hub-and-spoke. **الوكلاء الفرعيون**: تفويض متزامن داخل العملية عبر agent.WithSubagents، ووكلاء فرعيون في الخلفية عبر spawn_agent/stop_agent مع دفع النتائج كتقارير Background. إنشاء عن بُعد عبر RemoteAgentSpawner المزوَّد من المستهلك لـ gRPC أو K8s Jobs أو Cloud Run. تُبَثّ أحداث الوكلاء الفرعيين إلى سجل تدقيق الأصل تحت وسم Branch. **حاوية Kubernetes Triage الجانبية**: يراقب lookout-watch أحداث Kubernetes، ويُصفّي ويزيل التكرار، ويحقن الحوادث المطابقة في جلسات لكل حادثة لحلقات diagnose-fix-verify عبر GKE MCP، مقيّدة بفرض التخطيط أولاً. **التثبيت**: تثبيت Go (يتطلب Go 1.26+)، وثنائيات جاهزة موقّعة بـ Sigstore (linux/darwin × amd64/arm64)، وصور حاويات distroless متعددة المعماريات (خادم كامل + TUI، وslim بلا واجهة، وعميل TUI فقط). مرخّص بموجب Apache-2.0.