lousho acp يقدّم أي Lousho agent بهذه الطريقة، فيمكنك أن
تحادثه وتتابع الـ tool calls وتوافق عليها من لوحة الـ agent في المحرر.
الأمر
<path> بطريقة lousho chat نفسها، و--model
يعمل بالشكل نفسه. بادئة vendor/ في الـ model تختار الـ provider؛
ومع OpenRouter استخدم openrouter/<vendor>/<model> (مثلاً
openrouter/openai/gpt-4o). المحرر هو الذي يبدأ العملية، وتظل تعمل حتى
يُغلق stdin. لا يحمل stdout إلا رسائل البروتوكول: الأخطاء،
وأي شيء يطبعه كود الـ agent بـ console.log، تذهب إلى stderr الذي
تعرضه المحررات في سجلاتها. مسار أو خيار خاطئ ينهي العملية برمز خروج 1 مع
الخطأ المرمّز (LOUSHO_CONFIG_INVALID، …) على stderr.
Zed
أضف الـ agent إلىsettings.json في Zed، ثم اختره من لوحة الـ agent:
lousho (أو استخدم
مسارًا مطلقًا إلى node_modules/.bin/lousho كـ command). مفاتيح الـ provider
تأتي من env أو من البيئة التي شُغِّل Zed فيها.
المدعوم
الإصدار 1 من البروتوكول. الـ agent يرد على:
طوال تنفيذ الدورة يرسل الـ agent إشعارات
session/update:
agent_message_chunkمع كتلة محتوىtextلكل قطعة نص يكتبها الـ model؛agent_thought_chunkمع كتلة محتوىtextلكل جزء من استدلال الـ model؛tool_call(status: 'in_progress'، وkind: 'other'، واسم الـ tool فيtitle، ومعاملاتها فيrawInput) عند بدء tool call؛tool_call_updateمعstatus: 'completed'(النتيجة كمحتوى نصي وكـrawOutput) أو'failed'(الخطأ) عند انتهائه.
task لا تُمرَّر إلى المحرر؛
الـ task نفسه يظهر كـ tool call واحد.
الصلاحيات. عندما تحتاج tool إلى approval (موافقة) — needsApproval أو قواعد permissions
التي تطلب ذلك — يرسل الـ agent للمحرر طلب session/request_permission
يتضمّن الـ tool call وخيارين: allow (Allow، allow_once)
وreject (Reject، reject_once). الإجابة تحسم الـ approval عبر
agent.approvals.streamResolve() والدورة المستأنفة تكمل بث
التحديثات؛ والرفض يعلّم الـ tool call بـ failed ويكمل الـ model عمله.
يمكن أن تسأل الدورة الواحدة عدة مرات.
الأسئلة. التوقف من نوع ask_question (askQuestion: true) لا يتحوّل إلى
طلب صلاحية، لأن إجابة المستخدم يمكن أن تكون نصًا حرًا. بدلًا من ذلك ينهي
الدورة بـ end_turn، ويصبح السؤال مع خياراته المرقّمة رسالة
الـ agent؛ والـ prompt التالي في الـ session هو الإجابة
(agent.approvals.streamAnswer()).
أسباب التوقف. end_turn للانتهاء الطبيعي، وmax_turn_requests عندما
ينفد maxSteps، وmax_tokens عندما تُستنفد إحدى ميزانيات limits أو يتوقف الـ model
عند حدّ مخرجاته، وrefusal عندما يمنع guardrail أو فلتر
المحتوى عند الـ provider يوقف الـ model، وcancelled بعد
session/cancel.
الأخطاء. الـ method غير المعروفة يُرَدّ عليها بخطأ JSON-RPC رقم -32601، وسطر
ليس JSON بـ -32700، وسطر هو JSON لكنه ليس كائن طلب (null، أو مصفوفة، أو نص،
أو رقم، أو method ليست نصًا) بـ -32600، وsessionId غير معروف أو prompt فارغ بـ -32602، وprompt
ثانٍ بينما آخر يعمل في الـ session نفسها بـ -32600. والـ run الذي يفشل
يُرَدّ عليه بـ -32603 مع رسالة الخطأ، ورمز خطأ الـ SDK الخاص به (مثلاً
LOUSHO_PROVIDER_RATE_LIMITED) في error.data.code. والـ params التي قيمتها null
أو ليست object تُقرأ كـ {}. والسطر المشوّه لا يوقف السيرفر أبدًا.
غير المدعوم
session/load(loadSession: false) وأوضاع الـ session.- طرق
fs/*وterminal/*الخاصة بالعميل: الـ agent يقرأ الملفات ويشغّل الأوامر بأدواته هو (أدوات مساحة العمل)، وليس عبر المحرر. - كتل الـ prompt من نوع الصور والصوت والموارد المضمَّنة (prompts نصية فقط).
- تحديثات
plan، وخيارا الصلاحيةallow_always/reject_always. - المصادقة (
authMethodsفارغة): مفاتيح الـ provider تأتي من البيئة.
في الكود
نواة البروتوكول هيserveAcp(agent, { input, write }): تقرأ أسطر JSON-RPC
من أي async iterable وتسلّم كل سطر صادر إلى write،
فيمكنك تقديمها على transport آخر أو تشغيلها في الاختبارات دون عملية.
وتُنجَز عندما ينتهي input، بعد إلغاء أي دورة جارية.
store لتحفظ سجلات محادثات sessions الـ ACP في AgentStore (مثل
SqliteStore)؛ افتراضيًا تستخدم store الخاص بالـ agent أو الذاكرة.