@agent-native/core 0.76.5 → 0.76.6

package/corpus/core/docs/content/locales/ar-SA/dispatch.md

@@ -0,0 +1,146 @@
+---
+title: "إرسال"
+description: "مستوى التحكم في مساحة العمل: مخزن الأسرار ومركز التكامل والمفوض عبر التطبيقات وصندوق البريد المركزي لـ Slack والبريد الإلكتروني وTelegram وWhatsApp."
+---
+
+# إرسال
+
+Dispatch هو التطبيق المركزي الذي يقع أمام كل تطبيق آخر في مساحة العمل لديك ويتعامل مع الأسرار وعمليات التكامل والمراسلة والتفويض عبر التطبيقات. إنه **مستوى التحكم في مساحة العمل** — الوكيل الوحيد الذي يتحدث إليه فريقك، وبيانات اعتماد المكان الوحيد، وجهاز التوجيه الوحيد الذي يقرر التطبيق المتخصص الذي يجب أن يتعامل مع طلب معين.
+
+> **إرسال القالب مقابل `@agent-native/dispatch` الحزمة.** تغطي هذه الصفحة مفهوم تطبيق/قالب Dispatch — ما يفعله ولماذا تريده. حزمة `@agent-native/dispatch` npm هي وقت تشغيل منشور بشكل منفصل يجمع منطق خادم قالب Dispatch (المخزن وعمليات التكامل والوجهات والمهام المجدولة والتفويض عبر التطبيقات) كحزمة منسدلة لمساحات العمل التي تعمل على توسيعها. بالنسبة للتطبيق المدمج نفسه (الطرق، الشاشات، دليل الوكيل)، راجع [Dispatch template](/docs/template-dispatch).
+
+بدون Dispatch، سينتهي الأمر بكل تطبيق في مساحة عمل متعددة التطبيقات بإعادة تنفيذ نفس السباكة: روبوت Slack الخاص به، ومتجره السري الخاص، والوظائف المجدولة الخاصة به، ونسخته الخاصة من تعليمات مساحة العمل. يؤدي تدوير مفتاح API واحد إلى عشر عمليات إعادة توزيع. إضافة سياسة جديدة تتحول إلى عشرة نسخ ولصق. تعمل Dispatch على تجميع كل ذلك في تطبيق واحد حتى يواصل الآخرون التركيز على نطاقهم.
+
+```an-diagram title="Dispatch as the workspace control plane" summary="One inbox, one vault, one MCP gateway, and shared resources sit in front of the domain apps, which Dispatch reaches as A2A peers."
+{
+  "html": "<div class=\"dsp-hub\"><div class=\"diagram-node\">Users &amp; external agents<br><small class=\"diagram-muted\">Slack · email · Telegram · WhatsApp · MCP</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel dsp-control\" data-rough><span class=\"diagram-pill accent\">Dispatch &mdash; control plane</span><div class=\"dsp-caps\"><span class=\"diagram-pill\">Central inbox</span><span class=\"diagram-pill\">Secret vault</span><span class=\"diagram-pill\">Cross-app delegation</span><span class=\"diagram-pill\">MCP gateway</span><span class=\"diagram-pill\">Workspace resources</span></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"dsp-peers\"><div class=\"diagram-box\" data-rough>Mail</div><div class=\"diagram-box\" data-rough>Calendar</div><div class=\"diagram-box\" data-rough>Analytics</div></div><small class=\"diagram-muted\">domain apps &mdash; A2A peers</small></div>",
+  "css": ".dsp-hub{display:flex;flex-direction:column;align-items:center;gap:10px}.dsp-hub .dsp-control{display:flex;flex-direction:column;align-items:center;gap:10px;width:100%}.dsp-hub .dsp-caps{display:flex;gap:8px;flex-wrap:wrap;justify-content:center}.dsp-hub .dsp-peers{display:flex;gap:10px;flex-wrap:wrap;justify-content:center}"
+}
+```
+
+## عندما تريد الإرسال {#when}
+
+قم بالتواصل مع Dispatch عندما يكون أي مما يلي صحيحًا:
+
+- أنت تقوم بتشغيل [multi-app workspace](/docs/multi-app-workspace) - البريد والتقويم والتحليلات والمحتوى - ولا تريد روبوت Slack واحد لكل تطبيق.
+- تريد **صندوق بريد واردًا واحدًا لـ "الوكيل"** حتى يتمكن المستخدمون من إرسال رسالة مباشرة إلى برنامج تتبُّع واحد والتطبيق المتخصص المناسب يتولى العمل خلف الكواليس.
+- لديك **أسرار على مستوى مساحة العمل** (مفتاح شريطي، مفتاح OpenAI، رموز API لجهة خارجية) تحتاجها العديد من التطبيقات وتريد قبوًا واحدًا بدلاً من نسخ القيم في كل `.env`.
+- تريد **تدفق الموافقة في وقت التشغيل** أمام التغييرات الحساسة (الوجهات المحفوظة، وتعديلات السياسة) حتى يتمكن غير المسؤولين من طلبها ويمكن للمسؤولين تسجيل الخروج بدون نشر التعليمات البرمجية.
+- تريد **مشاركة skills، والتعليمات، وملفات تعريف الوكلاء، وخوادم MCP** التي ترثها التطبيقات في مساحة العمل — تتغير مرة واحدة، وتصل إلى الجميع.
+
+إذا كنت تقوم بتشغيل قالب واحد مستقل، فلن تحتاج إلى Dispatch - حيث يمكن لكل قالب توصيل عمليات تكامل المراسلة الخاصة به مباشرةً. راجع [Messaging](/docs/messaging) للتعرف على الإعداد المستقل.
+
+## ما يفعله ديسباتش {#what-it-does}
+
+سبع إمكانيات، جميعها موجودة أعلى قاعدة بيانات مساحة العمل نفسها التي تستخدمها التطبيقات الأخرى:
+
+| القدرة                    | ما يقدمه لك                                                                         | إعداده                                                      |
+| ------------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------- |
+| **البريد الوارد المركزي** | يصل Slack والبريد الإلكتروني وTelegram وWhatsApp إلى وكيل واحد بذاكرة مشتركة وأدوات | **الإعدادات ← المراسلة** ([Messaging](/docs/messaging))     |
+| **خزنة سرية**             | قم بتخزين كل بيانات الاعتماد مرة واحدة؛ التدوير في مكان واحد عبر كل تطبيق           | **Vault** + وضع الوصول (جميع التطبيقات أو اليدوي)           |
+| **التفويض عبر التطبيقات** | توجيه الطلب إلى التطبيق المتخصص المناسب عبر A2A والردود داخل سلسلة الرسائل          | تلقائي ([A2A](/docs/a2a-protocol))                          |
+| **بوابة MCP الموحدة**     | يصل موصل MCP واحد للوكلاء الخارجيين إلى كل تطبيق مساحة عمل ممنوح                    | [External Agents](/docs/external-agents)                    |
+| **موارد مساحة العمل**     | المؤلف skills/التعليمات/الملفات الشخصية مرة واحدة؛ ترثها التطبيقات في وقت التشغيل   | **الموارد** ([Workspace](/docs/workspace#global-resources)) |
+| **الأحلام**               | مراجعة عمليات التشغيل/التعليقات السابقة واقتراح تحسينات دائمة لكي توافق عليها       | **علامة تبويب الأحلام**                                     |
+| **تدفق الموافقة**         | تغييرات وقت التشغيل الحساسة للبوابة خلف مراجعة المشرف المضمنة                       | **سياسة الموافقة على الإرسال**                              |
+
+تم تفصيل كل منها أدناه.
+
+### البريد الوارد المركزي
+
+يتدفق كل من Slack والبريد الإلكتروني وTelegram وWhatsApp إلى حلقة وكيل Dispatch. قم بتوصيل كل منصة مرة واحدة في **الإعدادات → المراسلة** وتصل كل قناة إلى نفس الوكيل بنفس الذاكرة والأدوات. تنتهي رسالة Slack المباشرة والبريد الإلكتروني إلى `agent@yourcompany.com` كسطحين في سجل محادثة واحد، وليس روبوتين منفصلين. راجع [Messaging](/docs/messaging) للحصول على بيانات الاعتماد وخطاف الويب URLs.
+
+### خزنة سرية
+
+قم بتخزين بيانات الاعتماد مرة واحدة في قبو Dispatch. بشكل افتراضي، يكون الوصول إلى المخزن **جميع التطبيقات**: كل مفتاح محفوظ متاح لكل تطبيق مساحة عمل، ويقوم `sync-vault-to-app` بدفع المخزن الكامل إلى التطبيق المستهدف. يمكن لمساحات العمل التي تحتاج إلى فصل أكثر صرامة تحويل المخزن إلى الوضع **اليدوي**، حيث تكون المنح الصريحة لكل تطبيق مطلوبة قبل المزامنة. يمكن لغير المسؤولين **طلب** سرًا لأحد التطبيقات؛ المشرفون **الموافقة**، مما يؤدي إلى إنشاء السر، وفي سير العمل اليدوي، المنحة. يتم تسجيل كل قراءة ومنح ومزامنة وتدوير في سجل التدقيق. وهذا ما يجعل "تدوير مفتاح OpenAI" عملية بنقرة واحدة عبر عشرة تطبيقات بدلاً من عشرة علاقات عامة.
+
+### التفويض عبر التطبيقات
+
+يكتشف Dispatch تلقائيًا التطبيقات الأخرى في مساحة العمل الخاصة بك كأقران A2A - بدون تسجيل يدوي، ولا يوجد تكوين لكل تطبيق. عندما يسأل المستخدم "تلخيص عمليات الاشتراك في الأسبوع الماضي" في Slack، تتعرف Dispatch على ذلك كطلب تحليلات وتستدعي تطبيق التحليلات عبر [A2A](/docs/a2a-protocol). عندما يطلبون "صياغة رد على أليس"، فإنه يوجه إلى تطبيق البريد. تقوم Dispatch بنشر الإجابة النهائية مرة أخرى في الموضوع الأصلي. توجد القاعدة السلوكية في تعليمات وكيل الإرسال: ينتمي عمل المجال إلى تطبيق المجال. ديسباتش هي المُنسقة وليست المتخصصة.
+
+### بوابة MCP الموحدة
+
+يمكن أن يكون Dispatch هو موصل MCP الفردي للوكلاء الخارجيين: قم بإضافة `https://dispatch.agent-native.com/_agent-native/mcp` مرة واحدة في Claude أو ChatGPT أو Codex أو Cursor، وسيصل تخويل واحد إلى كل تطبيق مساحة عمل ممنوح بدلاً من موصل واحد لكل تطبيق. راجع [External Agents](/docs/external-agents) للاطلاع على تدفق الاتصال الكامل ومنح التطبيقات وOAuth ومعاينات تطبيقات MCP المضمنة.
+
+```an-api
+{
+  "method": "POST",
+  "path": "/_agent-native/mcp",
+  "summary": "Unified MCP gateway endpoint",
+  "description": "The single MCP connector URL external agents add (e.g. `https://dispatch.agent-native.com/_agent-native/mcp`). One authorization here reaches every **granted** workspace app instead of wiring one connector per app. App grants, OAuth, and inline MCP App previews are covered in [External Agents](/docs/external-agents).",
+  "auth": "Standard remote MCP OAuth, handled by the framework. The granted-app set scopes which workspace apps the connector can reach.",
+  "responses": [
+    { "status": "200", "description": "MCP JSON-RPC response — tools, resources, and MCP App UI resources aggregated across granted workspace apps." }
+  ]
+}
+```
+
+### موارد مساحة العمل
+
+يمكن تأليف Skills وتعليمات الدرابزين وملفات تعريف الوكيل والموارد المرجعية مرة واحدة في Dispatch ويتم توريثها بواسطة بقية مساحة العمل. الموارد ذات نطاق **جميع التطبيقات** عالمية: يقوم Dispatch بتخزينها مرة واحدة في نطاق مساحة العمل، ويقرأها كل وكيل تطبيق في وقت التشغيل. ولا يتم نسخها في كل تطبيق، ولا توجد خطوة يدوية لمزامنة موارد مساحة العمل. يمكن للموارد المشتركة للتطبيق والموارد الشخصية تجاوز الإعدادات الافتراضية لمساحة العمل أو تضييقها محليًا.
+
+راجع [Workspace — Global resources](/docs/workspace#global-resources) للاطلاع على جدول المسار الأساسي وحزمة البداية ونموذج التجاوز.
+
+تستخدم موارد الخادم MCP JSON وهي HTTP فقط عن قصد. قم بتخزين الرموز المميزة في
+إرسال Vault ومنح هذه المفاتيح أو مزامنتها مع التطبيقات المستهدفة والإشارة إليها
+من الرؤوس التي تحتوي على `${keys.NAME}`، وبالتالي لا توجد بيانات الاعتماد الأولية في
+نص المصدر.
+
+تسلط صفحة **الموارد** الضوء على حزمة البدء الموصى بها حتى يتمكن المسؤولون من معرفة الملفات الموجودة بسرعة، واستعادة ملفات البدء المفقودة دون استبدال الملفات الموجودة، وتحرير محتوياتها. قم بتوسيع أي مورد لمعاينة مكدس وقت التشغيل الفعال الخاص به لتطبيق/مستخدم محدد. تحتوي كل بطاقة تطبيق أيضًا على طريقة عرض **سياق** تعرض بالضبط ما يتلقاه هذا التطبيق.
+
+### الأحلام
+
+تقوم Dispatch Dreams بمراجعة عمليات التشغيل السابقة للوكيل، والتعليقات، والتقييمات، والإخفاقات المتكررة لاقتراح تحسينات دائمة. تقرير الأحلام هو عبارة عن سطح مراجعة، وليس إعادة كتابة صامتة: يمكنه اقتراح تحديثات للذاكرة الشخصية، أو تنظيف الذاكرة التي لا معنى لها، أو تعديلات `LEARNINGS.md` المشتركة، أو تعليمات مساحة العمل/المهارة/المعرفة/موارد الوكيل، أو المهام المتكررة، ويرتبط كل اقتراح بعمليات التشغيل التي تبرره. تتطلب التعليمات المشتركة والموارد على مستوى الفريق المراجعة قبل تطبيقها، خاصة عندما تأتي الأدلة من Slack أو البريد الإلكتروني أو Telegram أو WhatsApp أو محتوى الويب.
+
+قبل اقتراح الكتابة، تقارن Dreams الأدلة بمؤشر الذاكرة الشخصية وملاحظات `memory/*.md` الموجودة و`LEARNINGS.md` المشتركة. إذا تم تسجيل الدرس بالفعل، فسيسجل التقرير أنه تم تخطيه؛ إذا كانت الذاكرة الشخصية ذات الصلة تبدو قديمة، فإن الاقتراح يستهدف تلك الملاحظة الموجودة بدلاً من إنشاء نسخة مكررة.
+
+ابدأ من علامة التبويب **الأحلام** في Dispatch. قم بتشغيل تمرير يدوي أولاً، وافتح ورقة مراجعة الاقتراح لمقارنة الهدف الحالي بالمحتوى المقترح والأدلة المصدرية، ثم قم بتطبيق التغييرات التي تريد الاحتفاظ بها فقط. بمجرد أن تكون التقارير مفيدة باستمرار، يمكن لـ Dispatch إنشاء مهمة أحلام متكررة تستمر في إنتاج المقترحات دون التطبيق التلقائي للتغييرات المشتركة أو على مستوى التعليمات.
+
+### تدفق الموافقة
+
+يمكن لـ Dispatch إدخال التغييرات الحساسة في وقت التشغيل خلف مراجعة المشرف. يغطي هذا اليوم **الوجهات المحفوظة** (قنوات Slack وعناوين البريد الإلكتروني التي يمكن للوكيل إرسالها بشكل استباقي)، و**مقترحات الأحلام** المشتركة/الفريقية**، و**مورد مساحة العمل** لجميع التطبيقات** الذي ينشئ/يحدث/يحذف، و**سياسة الموافقة على الإرسال** نفسها. عند تمكين السياسة، يتم وضع التغيير في قائمة الانتظار ويظهر الوكيل معاينة موافقة مضمنة مباشرة في الدردشة - يوافق المسؤولون أو يرفضون دون مغادرة المحادثة.
+
+## كيفية تدفق رسالة Slack عبر Dispatch {#flow}
+
+تناول مثالًا واحدًا شاملاً. يقوم المستخدم بإرسال رسالة مباشرة إلى الروبوت: _"تلخيص عمليات الاشتراك في الأسبوع الماضي."_
+
+1. **Slack → خطاف الويب.** Slack `POST` إلى `/_agent-native/integrations/slack/webhook` في تطبيق Dispatch. يتحقق المعالج من التوقيع و**يدرج صفًا في `integration_pending_tasks`**، ثم يطلق `POST` ذاتي الاستهداف إلى معالجه الخاص ويعيد `200` على الفور حتى لا يحاول Slack إعادة المحاولة.
+2. **تنفيذ جديد للمعالج.** تعمل نقطة نهاية المعالج في تنفيذ وظيفة جديدة تمامًا مع انتهاء المهلة الكاملة الخاصة بها. فهو يطالب بالمهمة ذريًا ويبدأ حلقة الوكيل.
+3. **يقرر وكيل الإرسال.** يقرأ الوكيل الرسالة، ويتعرف على "عمليات الاشتراك" باعتبارها هدفًا للتحليلات، ويستدعي `call-agent` مقابل [A2A endpoint](/docs/a2a-protocol) لتطبيق التحليلات. يتم تنفيذ عمل SQL الفعلي هناك.
+4. **تم نشر الرد في سلسلة المحادثات.** يقوم وكيل التحليلات بإرجاع نتيجة. يقوم Dispatch بتنسيقه ونشره مرة أخرى في نفس سلسلة Slack التي كتبها المستخدم، باستخدام الهوية المرتبطة إذا كانت هناك واحدة (بحيث يتصرف الوكيل وفقًا لأذونات الطالب، وليس أذونات مالك مساحة العمل).
+5. **الاسترداد في حالة وفاة أي شيء.** إذا تعطل المعالج في منتصف الرحلة - انتهاء مهلة A2A، أو خطأ في عامل المصب، أو تجميد الوظيفة - فإن مهمة إعادة المحاولة تمسح المهام العالقة كل 60 ثانية وتعيد تشغيل المعالج. ما يصل إلى ثلاث محاولات قبل أن يتم وضع علامة `failed` على المهمة.
+
+```an-diagram title="A Slack message through Dispatch" summary="Slack enqueues into SQL, a fresh execution drains it, the Dispatch agent delegates the domain work over A2A, and the reply lands back in the originating thread. A 60s retry job recovers anything that dies mid-flight."
+{
+  "html": "<div class=\"dsp-flow\"><div class=\"dsp-row\"><div class=\"diagram-node\">Slack DM<br><small class=\"diagram-muted\">\"summarize last week's signups\"</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><strong>/slack/webhook</strong><br><small class=\"diagram-muted\">verify + INSERT pending task</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">200</div></div><div class=\"dsp-row\"><div class=\"diagram-box\" data-rough><strong>fresh processor</strong><br><small class=\"diagram-muted\">claim task · start agent loop</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">Dispatch agent decides</span><small class=\"diagram-muted\">analytics intent &rarr; call-agent</small></div></div><div class=\"dsp-row\"><div class=\"diagram-box\" data-rough>Analytics app<br><small class=\"diagram-muted\">A2A peer · runs the SQL work</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">reply posted in thread</div></div><div class=\"diagram-panel dsp-retry\" data-rough><span class=\"diagram-pill warn\">recovery</span> <span class=\"diagram-muted\">if the processor crashes &mdash; A2A timeout, downstream error, freeze &mdash; the 60s retry job re-fires it (&le;3 attempts) so the Slack reply still arrives</span> <span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</span></div></div>",
+  "css": ".dsp-flow{display:flex;flex-direction:column;gap:12px}.dsp-flow .dsp-row{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.dsp-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}.dsp-flow .dsp-retry{display:flex;align-items:center;gap:8px;flex-wrap:wrap}"
+}
+```
+
+ينطبق نفس التدفق على البريد الإلكتروني، وTelegram، وWhatsApp - يتغير المحول فقط.
+
+## قصة الموثوقية {#reliability}
+
+تم تصميم المسار بالكامل ليظل موجودًا على كل مضيف بدون خادم (Netlify وVercel وCloudflare Workers) دون الاعتماد على عمليات API الخاصة بالتنفيذ في الخلفية الخاصة بالمنصة.
+
+- **Webhook → قائمة انتظار SQL → معالج التنفيذ الجديد. ** لا تعمل حلقة الوكيل مطلقًا داخل معالج webhook. وظيفة المعالج الوحيدة هي التحقق من رقم 200 وإدراجه في قائمة الانتظار وإرجاعه. يؤدي التنفيذ الجديد المنفصل إلى استنزاف قائمة الانتظار، لذلك لا يمكن مطلقًا ربط تشغيل الوكيل البطيء بخطاف الويب الوارد أو التسبب في إعادة محاولة النظام الأساسي.
+- **استقصاء استمرار A2A.** عندما يقوم Dispatch بتفويض تطبيق آخر، فإنه يستقصي المهمة النهائية بمهلة محددة. إذا استغرق وكيل المتلقي وقتًا طويلاً جدًا أو تعطل، فإن Dispatch يسجل الاستمرارية وتلتقطه مهمة إعادة المحاولة — ويظل رد Slack الخاص بالمستخدم يصل.
+- **A2A عبر التطبيقات الموقعة تلقائيًا.** تعمل مساحات العمل المستضافة متعددة التطبيقات على إنشاء بيانات اعتماد A2A لكل تطبيق تلقائيًا في وقت النشر، بحيث يمكن للتطبيقات الموجودة في نفس مساحة العمل الاتصال ببعضها البعض دون لصق سر JWT على الإطلاق. تقرأ طبقة اكتشاف الوكيل في Dispatch تلك الاعتمادات من قاعدة بيانات مساحة العمل بحيث تظهر التطبيقات المضافة حديثًا كأقران قابلة للاستدعاء تلقائيًا.
+
+## الإعداد {#setup}
+
+ثلاث خطوات قصيرة:
+
+1. **قم ببناء مساحة عمل تتضمن Dispatch.** قم بتشغيل `npx @agent-native/core@latest create my-company-platform` واختر `dispatch` بجانب أي قوالب مجال تريدها. يوجد Dispatch في `apps/dispatch` وتوجد بقية التطبيقات بجانبه. انظر [Multi-App Workspace](/docs/multi-app-workspace).
+2. **توصيل الرسائل.** افتح **الإعدادات ← المراسلة** في الإرسال وانقر على اتصال بـ Slack أو البريد الإلكتروني أو Telegram أو WhatsApp. تتطابق حقول النموذج مع env vars في مستند [Messaging](/docs/messaging) — ارجع هناك لمعرفة ما تحتاجه كل منصة.
+3. **إضافة تطبيقات أخرى.** قم بتشغيل `npx @agent-native/core@latest add-app` من جذر مساحة العمل لكل تطبيق مجال. تظهر تلقائيًا كأقران A2A في `list-workspace-apps` الخاصة بـ Dispatch - لا يوجد تسجيل يدوي، ولا تحرير بطاقة الوكيل. ستبدأ ديسباتش في التفويض إليهم بمجرد أن تصبح بطاقات الوكيل الخاصة بهم متاحة.
+
+ثم أضف بيانات الاعتماد إلى المخزن وقم (اختياريًا) بتأليف موارد مساحة العمل العامة ضمن **الموارد**. لا يزال من الممكن مزامنة مفاتيح Vault أو منحها وفقًا لوضع الوصول؛ يتم توريث جميع موارد مساحة عمل التطبيق تلقائيًا. إذا كنت بحاجة إلى عزل سري لكل تطبيق، بدّل إعداد الوصول إلى المخزن إلى الوضع اليدوي قبل منح التطبيقات الفردية.
+
+## انظر أيضًا {#see-also}
+
+- [Dispatch template](/docs/template-dispatch) — التطبيق الفعلي المعزز، مع كتالوج الإجراءات الكامل ودليل الوكلاء
+- [Messaging](/docs/messaging) — ربط Slack والبريد الإلكتروني وتيليجرام وواتساب
+- [A2A Protocol](/docs/a2a-protocol) — كيفية عمل التفويض عبر التطبيقات تحت الغطاء
+- [Multi-App Workspace](/docs/multi-app-workspace) — شكل النشر الذي تم تصميم Dispatch من أجله
+- [Workspace Governance](/docs/workspace-management) — إدارة git/GitHub التي تقترن بإدارة وقت تشغيل Dispatch

package/corpus/core/docs/content/locales/ar-SA/drop-in-agent.md

@@ -0,0 +1,260 @@
+---
+title: "وكيل الدخول"
+description: "قم بتثبيت دردشة الوكيل + مساحة العمل في أي تطبيق React باستخدام <AgentPanel>، و<AgentSidebar>، وsendToAgentChat()."
+---
+
+# وكيل الدخول
+
+> **صفحة المطور.** هذه الصفحة مخصصة للمطورين الذين يقومون بدمج الوكيل في تطبيق React. للتعرف على تجربة المستخدم النهائي في العمل مع الوكيل، راجع [Using Your Agent](/docs/using-your-agent).
+
+لست بحاجة إلى إنشاء وكيل أصلي من البداية. يتم شحن دردشة الوكيل وعلامة تبويب مساحة العمل ومحطة CLI والإدخال الصوتي وجميع البنية التحتية ذات الصلة كمجموعة من مكونات React التي تضعها في أي تطبيق.
+
+> **المتطلبات الأساسية:** يجب أن يقوم الخادم بتشغيل `agent-chat-plugin` (يتم تركيبه تلقائيًا في كل قالب). إذا كنت تبدأ من الصفر، فراجع [Server](/docs/server).
+>
+> هل تحتاج إلى خريطة API العامة بدلاً من البرنامج التعليمي؟ انظر [Component API](/docs/components).
+
+## نظرة سريعة على المكونات {#components}
+
+| المكون                | ما هو                                                                            | استخدمه عندما                                            |
+| --------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| `<AgentSidebar>`      | يغلف تخطيط التطبيق الجذر ويضيف لوحة جانبية قابلة للتبديل تحتوي على الوكيل الكامل | تريد أن يكون الوكيل متاحًا بجانب تطبيقك على كل شاشة      |
+| `<AgentToggleButton>` | فتح/إغلاق `<AgentSidebar>` (ضعه في رأسك)                                         | إقران مع `<AgentSidebar>`                                |
+| `<AgentPanel>`        | اللوحة الأولية نفسها — الدردشة + CLI + علامات تبويب مساحة العمل                  | تريد التحكم الكامل في التخطيط، أو صفحة وكيل مخصصة        |
+| `<AgentChatSurface>`  | سطح دردشة/صفحة مزود بأسلاك مسبقة                                                 | تريد الدردشة بدون غلاف الشريط الجانبي                    |
+| `<AssistantChat>`     | عارض الدردشة ذو المستوى الأدنى مع ربطات الملحن/السجل                             | تحتاج إلى كروم مخصص للمحادثة القياسية UI                 |
+| `sendToAgentChat()`   | إرسال رسالة إلى الدردشة برمجيًا                                                  | زر يقوم بتسليم العمل إلى الوكيل بدلاً من التشغيل المضمّن |
+| `useActionMutation()` | مجمّع الواجهة الأمامية الآمنة حول الإجراء                                        | يحتاج UI إلى تشغيل نفس العملية التي ستجريها أداة الوكيل  |
+
+يتم تصدير كل هذه العناصر من `@agent-native/core/client`.
+
+```an-diagram title="The mount model" summary="<AgentSidebar> wraps your existing layout. Your routes render in the main area; the agent panel mounts beside them. <AgentPanel> is the same panel without the wrapper."
+{
+  "html": "<div class=\"diagram-mount\"><div class=\"diagram-box sidebar\" data-rough><span class=\"diagram-pill accent\">&lt;AgentSidebar&gt;</span><div class=\"inner\"><div class=\"diagram-node main\">Your app<br><small class=\"diagram-muted\">children: header + &lt;Outlet/&gt;</small></div><div class=\"diagram-node panel\">Agent panel<br><small class=\"diagram-muted\">chat &middot; CLI &middot; workspace</small></div></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-card alt\"><span class=\"diagram-pill\">&lt;AgentPanel&gt;</span><small class=\"diagram-muted\">same panel, no wrapper &mdash; you own the layout</small></div></div>",
+  "css": ".diagram-mount{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-mount .sidebar{display:flex;flex-direction:column;gap:8px;padding:14px}.diagram-mount .inner{display:flex;gap:10px}.diagram-mount .main{flex:2}.diagram-mount .panel{flex:1}.diagram-mount .alt{display:flex;flex-direction:column;gap:6px;padding:14px}.diagram-mount .diagram-arrow{font-size:22px;line-height:1}"
+}
+```
+
+## حالة 80%: `<AgentSidebar>` {#sidebar}
+
+الإعداد الأكثر شيوعًا هو الشريط الجانبي الذي يفتح من اليمين على أي شاشة.
+قم بلف تخطيط الجذر الموجود لديك باستخدام `<AgentSidebar>`؛ مهما تم تمريره كـ
+يبقى الأطفال في منطقة التطبيق الرئيسية. دردشة الوكيل هي اللوحة الجانبية.
+
+```an-annotated-code title="Wrapping the root layout with <AgentSidebar>"
+{
+  "filename": "app/root.tsx",
+  "language": "tsx",
+  "code": "import { Outlet } from \"react-router\";\nimport { AgentSidebar, AgentToggleButton } from \"@agent-native/core/client\";\n\nexport default function Root() {\n  return (\n    <AgentSidebar\n      emptyStateText=\"How can I help?\"\n      suggestions={[\n        \"Summarize my inbox\",\n        \"Draft a reply to the latest email\",\n        \"Show me yesterday's signup numbers\",\n      ]}\n      dynamicSuggestions\n      defaultSidebarWidth={420}\n      position=\"right\"\n    >\n      <header>\n        <AgentToggleButton />\n      </header>\n\n      <main>\n        <Outlet />\n      </main>\n    </AgentSidebar>\n  );\n}",
+  "annotations": [
+    { "lines": "6", "label": "Wrapper", "note": "`<AgentSidebar>` wraps your whole layout. It adds the toggleable side panel; everything you pass as children stays in the main app area." },
+    { "lines": "8-12", "label": "Starter prompts", "note": "`suggestions` render as clickable chips on the empty chat." },
+    { "lines": "13", "label": "Context-aware chips", "note": "`dynamicSuggestions` merges screen-aware prompts (e.g. \"Summarize this selection\") with your static ones. On by default." },
+    { "lines": "18-20", "label": "Toggle button", "note": "Put `<AgentToggleButton />` anywhere in your header to open and close the panel." },
+    { "lines": "22-24", "label": "Your app", "note": "`<Outlet/>` (your routes) renders in the main area, untouched." }
+  ]
+}
+```
+
+هذا كل شيء. أصبح لدى المستخدم الآن وكيل قابل للتبديل في كل صفحة - مع سجل الدردشة، وعلامة تبويب مساحة العمل، ومحطة CLI، والإدخال الصوتي، ووضع ملء الشاشة. تستمر الحالة عبر عمليات إعادة التحميل عبر `localStorage`.
+
+### الدعائم
+
+- **`children`** — التخطيط والمسارات العادية لتطبيقك. المقدمة في المنطقة الرئيسية. يتم تثبيت لوحة الوكيل بجانبها على سطح المكتب وفوقها على الهاتف المحمول/ملء الشاشة.
+- **`emptyStateText`** — تظهر الترحيب عندما لا تحتوي الدردشة على رسائل. الافتراضي: `"How can I help you?"`.
+- **`suggestions`** — يتم عرض مطالبات البدء كشرائح قابلة للنقر عندما تكون فارغة.
+- **`dynamicSuggestions`** — تم دمج شرائح المطالبة المدركة للسياق مع `suggestions`. ممكّن افتراضيًا؛ قم بتمرير `false` لعرض الاقتراحات الثابتة فقط، أو `{ max, includeStatic, getSuggestions }` للتخصيص.
+- **`defaultSidebarWidth`** — عرض البكسل الأولي (للتثبيت فقط؛ تغيير حجم المستخدم وتجاوز القيمة المحفوظة). الافتراضي: `380`.
+- **`position`** — `"left"` أو `"right"`. الافتراضي: `"right"`.
+- **`defaultOpen`** — ما إذا كان الشريط الجانبي يبدأ مفتوحًا (سطح المكتب فقط). الافتراضي: `false`.
+
+## الـ 20% الأخرى: `<AgentPanel>` {#panel}
+
+عندما تحتاج إلى التحكم الكامل في التخطيط - مسار `/chat` مخصص، أو لوحة مضمنة في عمود جانبي تديره، أو نافذة منبثقة - قم بعرض `<AgentPanel>` مباشرةً:
+
+```tsx
+// app/routes/agent.tsx
+import { AgentPanel } from "@agent-native/core/client";
+
+export default function AgentRoute() {
+  return (
+    <div className="h-screen">
+      <AgentPanel defaultMode="chat" className="h-full" />
+    </div>
+  );
+}
+```
+
+يمنحك `<AgentPanel>` علامات التبويب الأولية (الدردشة / CLI / مساحة العمل) بدون غلاف الشريط الجانبي، أو زر الطي، أو أي ثبات للحالة. ضعها أينما تريد؛ يمكنك التعامل مع التخطيط.
+
+### الدعائم المحددة
+
+- **`defaultMode`** — `"chat"` أو `"cli"`. الافتراضي: `"chat"`.
+- **`className`** — فئة CSS للحاوية الخارجية.
+- **`onCollapse`** — إذا تم توفيره، فسيظهر زر طي في الرأس.
+- **`isFullscreen`** / **`onToggleFullscreen`** — قم بتوصيل حالة ملء الشاشة الخارجية إذا كنت تريد عمودًا مركزيًا بنمط Claude.
+- **`storageKey`** — مساحة الاسم لمفاتيح `localStorage`. يكون ذلك مفيدًا عند عرض لوحات متعددة (مثيلات تطبيق أو مساحات عمل مختلفة) في نفس الصفحة.
+
+الدعائم الكاملة: `AgentPanelProps` في `@agent-native/core/client`.
+
+## الرسائل البرمجية: `sendToAgentChat()` {#send}
+
+زر يقوم بتسليم العمل إلى الوكيل (بدلاً من تشغيل استدعاء `llm()` المضمن - النمط المضاد من [ladder](/docs/what-is-agent-native#the-ladder)):
+
+```tsx
+import { sendToAgentChat } from "@agent-native/core/client";
+
+<Button
+  onClick={() =>
+    sendToAgentChat({
+      message: "Generate a chart showing signups by source",
+      context: `Dashboard ID: ${dashboardId}, date range: last 30 days`,
+      submit: true,
+    })
+  }
+>
+  Generate chart
+</Button>;
+```
+
+### الخيارات
+
+- **`message`** — المطالبة المرئية التي تظهر في الدردشة.
+- **`context`** — سياق مخفي مُلحق بالموجه (النص المحدد، موضع المؤشر، معرف الكيان الحالي — أي شيء يجب أن يعرفه الوكيل ولكن لا ينبغي للمستخدم رؤيته مرتين).
+- **`submit`** — `true` للتشغيل التلقائي، و`false` للتعبئة المسبقة ولكن انتظر. تجاهل استخدام المشروع الافتراضي.
+- **`newTab`** — أنشئ سلسلة محادثات منفصلة لهذه المطالبة.
+- **`background`** — مع `newTab`، قم بالتشغيل دون تركيز الخيط الجديد. يتم تتبع المسار المخفي في `RunsTray`.
+- **`openSidebar`** — تم ضبطه على `false` للإرسال في الخلفية/الصامت. يفتح الإعداد الافتراضي الشريط الجانبي حتى يرى المستخدم الاستجابة.
+- **`type`** — يحتفظ `"content"` (افتراضي) بالعمل في وكيل التطبيق المضمن. يوجه `"code"` إلى إطار تحرير التعليمات البرمجية (للاطلاع على تغييرات التعليمات البرمجية المكتوبة بواسطة الوكيل، راجع [Frames](/docs/frames)).
+
+يُرجع `sendToAgentChat` `tabId` مستقرًا يمكنك استخدامه لتتبع تشغيل الدردشة.
+
+للعمل الصامت، قم بإقران `newTab` و`background` و`openSidebar: false`:
+
+```ts
+sendToAgentChat({
+  message: "Summarize the selected thread and save the summary",
+  context: `Thread id: ${threadId}`,
+  submit: true,
+  newTab: true,
+  background: true,
+  openSidebar: false,
+});
+```
+
+لا يزال هذا وكيلًا كاملاً يتم تشغيله باستخدام الأدوات، وactions، وحالة مؤشر الترابط، والتشغيل
+التتبع. إنه ببساطة لا يسرق التركيز من حالة الشريط الجانبي الحالية للمستخدم.
+
+عندما يتم تضمين نفس المسار كتطبيق MCP، يتم إرساله
+تتم إعادة توجيه مكالمات `sendToAgentChat()` إلى الدردشة المضيفة حيثما تكون مدعومة؛ انظر
+[Client](/docs/client#sendtoagentchat) لسلوك جسر تطبيق MCP.
+
+إذا كنت تريد حالة تحميل، فاستخدم الخطاف `useSendToAgentChat()` - فهو يُرجع كلاً من `send` و`isGenerating`:
+
+```ts
+import { useSendToAgentChat } from "@agent-native/core/client";
+
+const { send, isGenerating } = useSendToAgentChat();
+```
+
+## عندما لا يكون الشريط الجانبي للأسهم مناسبًا {#custom-chat-ui}
+
+يغطي `<AgentSidebar>` و`<AgentPanel>` معظم التطبيقات. عندما تحتاج إلى امتلاك
+التخطيط حول الوكيل، أو إذا كنت ترغب في تعزيز المحادثة مع الوكيل
+الذي أنشأته في مكان آخر، قم بإسقاط طبقة - ولكن استمر في السماح لإطار العمل بامتلاك
+وقت التشغيل، وactions، والحالة المدعومة SQL:
+
+- **امتلك Chrome خلال وقت التشغيل القياسي.** استخدم `<AgentChatSurface>` لـ
+  مسار دردشة مخصص، أو `<AssistantChat>` عندما تريد رؤوسًا مخصصة،
+  والحالات الفارغة حول المحادثة القياسية. خريطة الطبقة الكاملة —
+  يعيش كل مكون وخطاف وملحن ومحول مع مسارات الاستيراد في
+  [Component API](/docs/components#agent-chat-ui).
+- **إحضار وقت تشغيل الوكيل الخاص بك.** إذا كان ينبغي على الوكيل الذي أنشأته في مكان آخر
+  دعم المحادثة بينما يحتفظ Agent-Native بالملحن والنص والأداة
+  البطاقات والموافقات والأدوات الأصلية، قم بتمرير `AgentChatRuntime` إلى
+  `<AssistantChat runtime={...} />`. الموصلات
+  (`createHttpAgentChatRuntime()` وOpenAI / Claude / Vercel AI / AG-UI
+  المساعدون) وعقد الحدث موثق في
+  [Native Chat UI — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes).
+
+أيًا كانت الطبقة التي تختارها، احتفظ بحالة التطبيق المدعومة بـ actions وSQL كعقد،
+وتجنب النشر مباشرة إلى `/_agent-native/agent-chat` من المنتج UI. إذا كان
+المساعد المسمى مفقود لسطح مخصص حقيقي، قم بإضافة هذا المساعد أولاً لذلك
+لا يتعلم كود العميل عملية نقل ثانية مخصصة.
+
+## Typesafe actions من UI: `useActionMutation()` {#use-action-mutation}
+
+عندما يحتاج UI إلى تشغيل نفس العملية، سيتم تشغيل أداة الوكيل - الدرجة 3 من [ladder](/docs/what-is-agent-native#rung-three) - استخدم `useActionMutation`:
+
+```tsx
+import { useActionMutation } from "@agent-native/core/client";
+
+const { mutate, isPending } = useActionMutation("reply-to-email");
+
+<Button onClick={() => mutate({ emailId, body: "Thanks!" })}>
+  Send Reply
+</Button>;
+```
+
+تأتي وسائط النوع الآمن من مخطط zod في `defineAction()`. راجع [Actions](/docs/actions) للتعرف على نظام العمل الكامل.
+
+```an-callout
+{
+  "tone": "decision",
+  "body": "**`useActionMutation` vs `sendToAgentChat`.** Run the operation directly with `useActionMutation` when the user clicked a deterministic button (\"Send reply\"). Hand it to `sendToAgentChat` when the work needs the agent's reasoning, tools, or multi-step planning. Never call an inline `llm()` from UI — that is rung 1 of the [ladder](/docs/what-is-agent-native#the-ladder)."
+}
+```
+
+## التحديد + التعرف على المؤشر {#selection}
+
+يمكن للوكيل رؤية ما حدده المستخدم - النص والخلايا والشرائح وجهات الاتصال - عبر مفتاحي `navigation` و`selection` في حالة التطبيق. تستخدم الدردشة الفارغة أيضًا هذه المفاتيح لتقديم اقتراحات ديناميكية مثل "تلخيص هذا التحديد" أو "تحسين هذه الشريحة" عندما تجعلها الشاشة الحالية ذات صلة. إذا كنت تريد من Cmd-I (أو ما شابه) إرسال نطاق محدد إلى الدردشة كسياق، راجع [Context Awareness](/docs/context-awareness).
+
+## تجميع كل ذلك معًا {#putting-it-together}
+
+الإعداد المنسدلة النموذجي:
+
+```tsx
+// app/root.tsx
+import {
+  AgentSidebar,
+  AgentToggleButton,
+  sendToAgentChat,
+} from "@agent-native/core/client";
+
+export default function Root() {
+  return (
+    <AgentSidebar suggestions={["Draft a reply", "Summarize selection"]}>
+      <Header>
+        <AgentToggleButton />
+      </Header>
+
+      <Main>
+        <YourRoutes />
+      </Main>
+    </AgentSidebar>
+  );
+}
+```
+
+```tsx
+// Anywhere else in the app
+<Button
+  onClick={() =>
+    sendToAgentChat({
+      message: "Summarize this thread",
+      context: `Thread id: ${threadId}`,
+      submit: true,
+    })
+  }
+>
+  Summarize
+</Button>
+```
+
+يرى المستخدم زر الدردشة في الرأس، ويمكنه فتحه، ويمكنه التحدث إلى الوكيل. تعمل أزرارك اليدوية مع نفس الوكيل بدلاً من إجراء مكالمات LLM لمرة واحدة.
+
+## ما هي الخطوة التالية
+
+- [**Actions**](/docs/actions) — `defineAction()` و`useActionMutation()`
+- [**Context Awareness**](/docs/context-awareness) — الاختيار، التنقل، شاشة العرض
+- [**Workspace**](/docs/workspace) — ما تحتويه علامة تبويب مساحة العمل (skills، الذاكرة، خوادم MCP، المهام المجدولة)
+- [**Voice Input**](/docs/voice-input) — الميكروفون الموجود في مؤلف الدردشة

package/corpus/core/docs/content/locales/ar-SA/durable-resume.md

@@ -0,0 +1,65 @@
+---
+title: "سيرة ذاتية متينة"
+description: "عند مقاطعة تشغيل الوكيل المستضاف واستئنافه، لا تتم إعادة تشغيل استدعاءات أدوات التأثير الجانبي المكتملة - حيث يقوم دفتر يومية استدعاء الأدوات المشتق من دفتر الأستاذ المتين بحظر عمليات الإرسال والتكاليف والتذاكر المكررة."
+---
+
+# سيرة ذاتية متينة
+
+> **لمن هذا:** أي شخص يريد فهم كيفية تشغيل إطار العمل
+> الآثار الجانبية المكررة. هذا سلوك مدمج — يوجد
+> لا يوجد شيء يمكن توصيله.
+
+تتم مقاطعة تشغيل الوكيل المستضاف: تصل وظيفة بدون خادم إلى مهلة صعبة في منتصف الدفق، وتسقط البوابة الاتصال عند 45 ثانية، ويتوقف المقبس، وتبدأ المنصة في العمل على البارد. يتعافى إطار العمل بالفعل من هذه المشكلات عن طريق حفظ بادئة المحادثة وإعادة تشغيل استدعاء LLM ("المتابعة من حيث توقفت"). لكن التعافي وحده له ميزة حادة: إذا كانت المحاولة التي تمت مقاطعتها **أرسلت بالفعل بريدًا إلكترونيًا أو أنشأت تذكرة**، فقد تفعل السيرة الذاتية الساذجة نفس الشيء مرة أخرى.
+
+السيرة الذاتية الدائمة تسد هذه الفجوة. عند الاستئناف، يعرف إطار العمل استدعاءات أدوات التأثير الجانبي التي تم إكمالها بالفعل ويرفض إعادة تشغيلها — على طبقتين.
+
+```an-diagram title="Two layers block duplicate side effects on resume" summary="The journal reads the durable ledger and classifies prior calls; layer 1 tells the model, layer 2 hard-blocks a re-dispatched write that matches a completed entry."
+{
+  "html": "<div class=\"diagram-durable\"><div class=\"diagram-box\" data-rough>Run-event ledger<br><small class=\"diagram-muted\">tool_start / tool_done</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><strong>Tool-call journal</strong><small class=\"diagram-ok\">completed = start+done</small><small class=\"diagram-warn\">interrupted = start, no done</small></div><div class=\"diagram-col\"><div class=\"diagram-pill\">Layer 1 · prompt note &rarr; model</div><div class=\"diagram-pill accent\">Layer 2 · hard-block re-dispatched write</div></div></div>",
+  "css": ".diagram-durable{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-durable .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-durable .diagram-arrow{font-size:22px;line-height:1}.diagram-durable .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## سجل استدعاء الأداة {#journal}
+
+إن دفتر اليومية عبارة عن **قراءة خالصة عبر دفتر الأستاذ المتين لحدث التشغيل** — ولا يوجد رابط تسجيل جديد في المسار السريع. يقوم بتصنيف استدعاءات الأداة المسجلة بالفعل للدورة الحالية:
+
+- **مكتمل** — `tool_start` مع `tool_done` المطابق. تم إجراء المكالمة وحدث أثرها الجانبي وتم تسجيل نتيجتها. **لا تقم بإعادة التشغيل.**
+- **تمت المقاطعة** — `tool_start` مع **لا** يطابق `tool_done`. بدأت المكالمة، وقد يكون أثرها الجانبي قد وصل أو لا، وقد أكل الانقطاع النتيجة. النتيجة غير معروفة.
+
+تعكس المطابقة كيفية إعادة بناء المنعطفات المتينة في مكان آخر: زوج `tool_done` مع أقدم `tool_start` الذي لا يزال مفتوحًا لنفس اسم الأداة (FIFO لكل أداة). يقوم حدث `clear` (المخرجات الجزئية المهملة) بإعادة تعيين رصيد كل دورة بحيث لا تترك الأجزاء المهجورة مكالمات وهمية مفتوحة.
+
+## الطبقة 1: مذكرة يومية على مستوى المطالبة {#prompt-note}
+
+عند استئناف التشغيل (مهلة بسيطة، أو مهلة بوابة، أو أي خطأ نقل قابل للاستئناف)، يُلحق إطار العمل **ملاحظة يومية منظمة** بمطالبة الاستئناف، مباشرةً بعد تنبيه "المتابعة من حيث توقفت". توضح الملاحظة النموذج بنص عادي:
+
+- الأداة التي تستدعي **مكتملة بالفعل** (مع نتائج قصيرة) لذلك تعيد استخدامها و **لا** تعيد تشغيلها، و
+- استدعاءات الأداة **التي تمت مقاطعتها بنتيجة غير معروفة** لذا فهي تتحقق من الحالة قبل افتراض النجاح أو الفشل.
+
+عندما تكون المجلة فارغة (دورة بدون نشاط أداة، أو متابعة نظيفة)، لا يتم إلحاق أي شيء إضافي ويصبح سلوك السيرة الذاتية بايتًا مقابل بايت كما كان من قبل. تعتبر الملاحظة أفضل جهد: قراءة دفتر الأستاذ الفاشلة لا تمنع أبدًا عملية استرداد قد تنجح.
+
+## الطبقة الثانية: الكتلة الصلبة لطبقة الأدوات {#hard-block}
+
+الملاحظة الفورية تعتبر استشارية - فالنموذج حسن التصرف يستجيب لها، ولكن النموذج ليس ضمانًا. لذا فإن الحلقة تفرضها أيضًا على طبقة الأداة.
+
+قبل تشغيل الحلقة في مقطع مستأنف، تقوم بالتقاط لقطات للمجلة مرة واحدة (تلتقط فقط الأجزاء **السابقة** من هذا المنعطف المنطقي). عندما يعيد النموذج إرسال أداة **كتابة** التي يتطابق اسم أداتها **وإدخالها** مع إدخال دفتر يومية مكتمل، فإن الدائرة القصيرة: تقوم بإرجاع النتيجة المسجلة بدلاً من تنفيذ الإجراء، مع ملاحظة أن الاستدعاء قد اكتمل بالفعل في محاولة تمت مقاطعتها سابقًا ولم تتم إعادة تشغيله لتجنب تأثير جانبي مكرر.
+
+الخصائص الرئيسية:
+
+- **أدوات الكتابة فقط.** للقراءة فقط (`readOnly` / GET) لا يتم حظر actions أبدًا — إعادة القراءة آمنة وغير فعالة.
+- **المحتوى المعنون.** المطابقة موجودة على اسم الأداة + توقيع الإدخال، لذا فإن المكالمة المستأنفة الموجودة في موضع مختلف في الدور لا تزال متطابقة؛ يتم التعامل مع مكالمة _different_ (وسيطات مختلفة) على أنها جديدة وتعمل بشكل طبيعي.
+- **يستهلك مرة واحدة.** تتم المطالبة بكل إدخال مكتمل عند مطابقته، لذلك لا تؤدي مكالمتان جديدتان متطابقتان ومتميزتان بالفعل في نفس المنعطف إلى حدوث ماس كهربائي عند إكمال سجل واحد.
+- **المكالمات الجديدة لم يتم لمسها.** تظهر مكالمة الدور الأول في دفتر يومية فارغ؛ لا شيء يتغير بالنسبة للتشغيل العادي.
+
+```an-callout
+{
+  "tone": "success",
+  "body": "Together the two layers mean an interrupted run that already had a real side effect resumes **without repeating it** — no duplicate emails, charges, or tickets — while genuinely new work still runs. Read-only actions are never blocked; re-reading is always safe."
+}
+```
+
+## ذات صلة
+
+- [**Real-Time Sync**](/docs/real-time-collaboration) — كيفية تدفق دفتر الأستاذ للتشغيل الدائم إلى العميل وإعادة تشغيله عند إعادة الاتصال.
+- [**Actions**](/docs/actions) - تشير علامات `readOnly` إلى أنها آمنة لإعادة التشغيل؛ يتم التعامل مع كل شيء آخر على أنه آثار جانبية.
+- [**In-Loop Processors**](/docs/processors) — وصلة تقوية داخلية أخرى.