@agent-native/core 0.79.25 → 0.79.27

package/docs/content/locales/ar-SA/database.mdx

@@ -7,13 +7,61 @@ description: "قم بتوصيل قاعدة بيانات SQL المحمولة ب
 
 تستخدم التطبيقات الأصلية للوكيل [Drizzle ORM](https://orm.drizzle.team) وتدعم واجهات SQL الخلفية المحمولة. بالنسبة لأي شيء يتجاوز التطوير المحلي، قم بتوصيل قاعدة بيانات SQL المستمرة — Postgres، أو libSQL/Turso، أو واجهة خلفية أخرى متوافقة مع Drizzle — عن طريق تعيين `DATABASE_URL`. عند عدم تعيين هذا المتغير، يعود التطبيق إلى ملف SQLite المحلي بدون تكوين حتى تتمكن من البدء في التطوير على الفور.
 
-```an-diagram title="مخطط واحد والعديد من الواجهات الخلفية" summary="يستخدم رمز التطبيق مساعدين محايدين للهجة في إطار العمل. يتم اكتشاف اللهجة تلقائيًا من DATABASE_URL في وقت التشغيل؛ عدم الضبط يعني ملف SQLite محلي."
-{
-  "html": "<div class=\"diagram-db\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">@agent-native/core/db/schema</span><small class=\"diagram-muted\">table · text · integer · real · now</small><small class=\"diagram-muted\">+ Drizzle query DSL</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>DATABASE_URL<br><small class=\"diagram-muted\">dialect auto-detected</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><span class=\"diagram-pill\">Postgres<br><small class=\"diagram-muted\">Neon · Supabase</small></span><span class=\"diagram-pill\">libSQL / Turso</span><span class=\"diagram-pill\">Cloudflare D1</span><span class=\"diagram-pill warn\">SQLite file<br><small class=\"diagram-muted\">unset = local dev only</small></span></div></div>",
-  "css": ".diagram-db{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-db .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px 16px}.diagram-db .diagram-arrow{font-size:22px;line-height:1}.diagram-db .diagram-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}"
+<Diagram id="doc-block-9om0ep" title={"مخطط واحد والعديد من الواجهات الخلفية"} summary={"يستخدم رمز التطبيق مساعدين محايدين للهجة في إطار العمل. يتم اكتشاف اللهجة تلقائيًا من DATABASE_URL في وقت التشغيل؛ عدم الضبط يعني ملف SQLite محلي."}>
+
+```html
+<div class="diagram-db">
+  <div class="diagram-panel center" data-rough>
+    <span class="diagram-pill accent">@agent-native/core/db/schema</span
+    ><small class="diagram-muted">table · text · integer · real · now</small
+    ><small class="diagram-muted">+ Drizzle query DSL</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box" data-rough>
+    DATABASE_URL<br /><small class="diagram-muted">dialect auto-detected</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-grid">
+    <span class="diagram-pill"
+      >Postgres<br /><small class="diagram-muted">Neon · Supabase</small></span
+    ><span class="diagram-pill">libSQL / Turso</span
+    ><span class="diagram-pill">Cloudflare D1</span
+    ><span class="diagram-pill warn"
+      >SQLite file<br /><small class="diagram-muted"
+        >unset = local dev only</small
+      ></span
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-db {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.diagram-db .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
+  padding: 14px 16px;
+}
+.diagram-db .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-db .diagram-grid {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 8px;
 }
 ```
 
+</Diagram>
+
 ## الافتراضي المحلي: ملف SQLite {#default-sqlite}
 
 عند عدم تعيين `DATABASE_URL`، يقوم التطبيق بإنشاء قاعدة بيانات SQLite على `data/app.db`. هذا هو التكوين الافتراضي للتطوير المحلي - لا يتطلب أي إعداد. إنه مخصص للتنمية فقط؛ للإنتاج، قم بتعيين `DATABASE_URL` على قاعدة بيانات SQL المستمرة.

package/docs/content/locales/ar-SA/deployment.mdx

@@ -28,13 +28,60 @@ npx @agent-native/core@latest deploy
 
 يتم إنشاء كل تطبيق باستخدام `APP_BASE_PATH=/<name>` و`VITE_APP_BASE_PATH=/<name>`، ثم يتم تجميعه للإعداد المسبق المستهدف Nitro. يعد Cloudflare Pages هو الإعداد المسبق الافتراضي ويستخدم عامل إرسال تم إنشاؤه في `dist/_worker.js`؛ يستخدم Netlify وظيفة واحدة لكل تطبيق في `.netlify/functions-internal/<app>-server` بالإضافة إلى عمليات إعادة التوجيه التي تم إنشاؤها؛ يكتب Vercel `.vercel/output` على مستوى مساحة العمل باستخدام Build Output API.
 
-```an-diagram title="أصل واحد، والعديد من التطبيقات" summary="يتم إنشاء كل تطبيق مساحة عمل بمسار أساسي خاص به ويتم تثبيته أسفل بادئة مسار على أصل واحد - لذا فإن تسجيل الدخول والتطبيقات المشتركة A2A هما نفس الأصل ومجاني."
-{
-  "html": "<div class=\"diagram-ws\"><div class=\"diagram-panel\" data-rough><strong>https://your-agents.com</strong><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/mail/*</span><small class=\"diagram-muted\">apps/mail</small></div><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/calendar/*</span><small class=\"diagram-muted\">apps/calendar</small></div><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/forms/*</span><small class=\"diagram-muted\">apps/forms</small></div></div><div class=\"diagram-col wins\"><span class=\"diagram-pill ok\">shared login session</span><span class=\"diagram-pill ok\">A2A بين التطبيقات بلا إعداد</span></div></div>",
-  "css": ".diagram-ws{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.diagram-ws .diagram-panel{display:flex;flex-direction:column;gap:6px;padding:14px 16px}.diagram-ws .diagram-row{display:flex;align-items:center;gap:8px}.diagram-ws .wins{display:flex;flex-direction:column;gap:8px;align-items:flex-start}"
+<Diagram id="doc-block-rxsqim" title={"أصل واحد، والعديد من التطبيقات"} summary={"يتم إنشاء كل تطبيق مساحة عمل بمسار أساسي خاص به ويتم تثبيته أسفل بادئة مسار على أصل واحد - لذا فإن تسجيل الدخول والتطبيقات المشتركة A2A هما نفس الأصل ومجاني."}>
+
+```html
+<div class="diagram-ws">
+  <div class="diagram-panel" data-rough>
+    <strong>https://your-agents.com</strong>
+    <div class="diagram-row">
+      <span class="diagram-pill accent">/mail/*</span
+      ><small class="diagram-muted">apps/mail</small>
+    </div>
+    <div class="diagram-row">
+      <span class="diagram-pill accent">/calendar/*</span
+      ><small class="diagram-muted">apps/calendar</small>
+    </div>
+    <div class="diagram-row">
+      <span class="diagram-pill accent">/forms/*</span
+      ><small class="diagram-muted">apps/forms</small>
+    </div>
+  </div>
+  <div class="diagram-col wins">
+    <span class="diagram-pill ok">shared login session</span
+    ><span class="diagram-pill ok">A2A بين التطبيقات بلا إعداد</span>
+  </div>
+</div>
+```
+
+```css
+.diagram-ws {
+  display: flex;
+  align-items: center;
+  gap: 16px;
+  flex-wrap: wrap;
+}
+.diagram-ws .diagram-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 14px 16px;
+}
+.diagram-ws .diagram-row {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.diagram-ws .wins {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  align-items: flex-start;
 }
 ```
 
+</Diagram>
+
 يمنحك النشر بنفس المصدر فوزين كبيرين مجانًا:
 
 - **جلسة تسجيل الدخول المشتركة** — قم بتسجيل الدخول إلى أي تطبيق، حيث يتم تسجيل الدخول إلى كل تطبيق.
@@ -95,13 +142,61 @@ npx @agent-native/core@latest deploy --preset vercel
 
 الإخراج مستقل بذاته - انسخ `.output/` إلى أي بيئة وقم بتشغيله.
 
-```an-diagram title="بناء للنشر" summary="يتم بناء شجرة مصدر واحدة على إعداد مسبق Nitro؛ يتم تشغيل نفس الإخراج المستقل على Node، أو Vercel، أو Netlify، أو Cloudflare، أو AWS، أو Deno. يشير كل مثيل إلى نفس DATABASE_URL المستمر."
-{
-  "html": "<div class=\"diagram-deploy\"><div class=\"diagram-box\" data-rough>مصدر التطبيق</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">build</span><small class=\"diagram-muted\">Nitro preset</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><span class=\"diagram-pill\">Node.js</span><span class=\"diagram-pill\">Vercel</span><span class=\"diagram-pill\">Netlify</span><span class=\"diagram-pill\">Cloudflare</span><span class=\"diagram-pill\">AWS Lambda</span><span class=\"diagram-pill\">Deno</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>DATABASE_URL دائم<br><small class=\"diagram-muted\">shared by every instance</small></div></div>",
-  "css": ".diagram-deploy{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-deploy .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px 16px}.diagram-deploy .diagram-arrow{font-size:22px;line-height:1}.diagram-deploy .diagram-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:8px}"
+<Diagram id="doc-block-1dya5o5" title={"بناء للنشر"} summary={"يتم بناء شجرة مصدر واحدة على إعداد مسبق Nitro؛ يتم تشغيل نفس الإخراج المستقل على Node، أو Vercel، أو Netlify، أو Cloudflare، أو AWS، أو Deno. يشير كل مثيل إلى نفس DATABASE_URL المستمر."}>
+
+```html
+<div class="diagram-deploy">
+  <div class="diagram-box" data-rough>مصدر التطبيق</div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel center" data-rough>
+    <span class="diagram-pill accent">build</span
+    ><small class="diagram-muted">Nitro preset</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-grid">
+    <span class="diagram-pill">Node.js</span
+    ><span class="diagram-pill">Vercel</span
+    ><span class="diagram-pill">Netlify</span
+    ><span class="diagram-pill">Cloudflare</span
+    ><span class="diagram-pill">AWS Lambda</span
+    ><span class="diagram-pill">Deno</span>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box" data-rough>
+    DATABASE_URL دائم<br /><small class="diagram-muted"
+      >shared by every instance</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-deploy {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.diagram-deploy .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
+  padding: 14px 16px;
+}
+.diagram-deploy .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-deploy .diagram-grid {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 8px;
 }
 ```
 
+</Diagram>
+
 ## ضبط الإعداد المسبق {#setting-the-preset}
 
 افتراضيًا، يتم إنشاء Nitro لـ Node.js. لاستهداف منصة مختلفة، قم بضبط الإعداد المسبق في `vite.config.ts`:

package/docs/content/locales/ar-SA/dispatch.mdx

@@ -11,13 +11,66 @@ Dispatch هو التطبيق المركزي الذي يقع أمام كل تطب
 
 بدون Dispatch، سينتهي الأمر بكل تطبيق في مساحة عمل متعددة التطبيقات بإعادة تنفيذ نفس السباكة: روبوت Slack الخاص به، ومتجره السري الخاص، والوظائف المجدولة الخاصة به، ونسخته الخاصة من تعليمات مساحة العمل. يؤدي تدوير مفتاح API واحد إلى عشر عمليات إعادة توزيع. إضافة سياسة جديدة تتحول إلى عشرة نسخ ولصق. تعمل Dispatch على تجميع كل ذلك في تطبيق واحد حتى يواصل الآخرون التركيز على نطاقهم.
 
-```an-diagram title="Dispatch كمستوى التحكم في مساحة العمل" summary="يوجد صندوق بريد واحد، وقبو واحد، وبوابة MCP واحدة، وموارد مشتركة أمام تطبيقات النطاق، والتي يصل إليها Dispatch كأقران A2A."
-{
-  "html": "<div class=\"dsp-hub\"><div class=\"diagram-node\">Users &amp; external agents<br><small class=\"diagram-muted\">Slack · البريد · 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\">صندوق وارد مركزي</span><span class=\"diagram-pill\">خزنة الأسرار</span><span class=\"diagram-pill\">تفويض بين التطبيقات</span><span class=\"diagram-pill\">MCP gateway</span><span class=\"diagram-pill\">موارد مساحة العمل</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}"
+<Diagram id="doc-block-17t74c2" title={"Dispatch كمستوى التحكم في مساحة العمل"} summary={"يوجد صندوق بريد واحد، وقبو واحد، وبوابة MCP واحدة، وموارد مشتركة أمام تطبيقات النطاق، والتي يصل إليها Dispatch كأقران A2A."}>
+
+```html
+<div class="dsp-hub">
+  <div class="diagram-node">
+    Users &amp; external agents<br /><small class="diagram-muted"
+      >Slack · البريد · 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">صندوق وارد مركزي</span
+      ><span class="diagram-pill">خزنة الأسرار</span
+      ><span class="diagram-pill">تفويض بين التطبيقات</span
+      ><span class="diagram-pill">MCP gateway</span
+      ><span class="diagram-pill">موارد مساحة العمل</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;
 }
 ```
 
+</Diagram>
+
 ## عندما تريد الإرسال {#when}
 
 قم بالتواصل مع Dispatch عندما يكون أي مما يلي صحيحًا:
@@ -108,13 +161,86 @@ The single MCP connector URL external agents add (e.g. `https://dispatch.agent-n
 4. **تم نشر الرد في سلسلة المحادثات.** يقوم وكيل التحليلات بإرجاع نتيجة. يقوم Dispatch بتنسيقه ونشره مرة أخرى في نفس سلسلة Slack التي كتبها المستخدم، باستخدام الهوية المرتبطة إذا كانت هناك واحدة (بحيث يتصرف الوكيل وفقًا لأذونات الطالب، وليس أذونات مالك مساحة العمل).
 5. **الاسترداد في حالة وفاة أي شيء.** إذا تعطل المعالج في منتصف الرحلة - انتهاء مهلة A2A، أو خطأ في عامل المصب، أو تجميد الوظيفة - فإن مهمة إعادة المحاولة تمسح المهام العالقة كل 60 ثانية وتعيد تشغيل المعالج. ما يصل إلى ثلاث محاولات قبل أن يتم وضع علامة `failed` على المهمة.
 
-```an-diagram title="رسالة Slack عبر Dispatch" summary="يتم إدراج Slack في SQL، ويستنزفه تنفيذ جديد، ويقوم وكيل Dispatch بتفويض عمل المجال عبر A2A، ويعود الرد مرة أخرى إلى سلسلة المحادثات الأصلية. تعمل عملية إعادة المحاولة لمدة 60 ثانية على استعادة أي شيء يموت في منتصف الرحلة."
-{
-  "html": "<div class=\"dsp-flow\"><div class=\"dsp-row\"><div class=\"diagram-node\">رسالة Slack مباشرة<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\">تحقق + INSERT لمهمة معلقة</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\">استلام المهمة · بدء حلقة الوكيل</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 يقرر</span><small class=\"diagram-muted\">analytics intent &rarr; call-agent</small></div></div><div class=\"dsp-row\"><div class=\"diagram-box\" data-rough>تطبيق التحليلات<br><small class=\"diagram-muted\">نظير A2A · ينفذ عمل SQL</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}"
+<Diagram id="doc-block-13jtbce" title={"رسالة Slack عبر Dispatch"} summary={"يتم إدراج Slack في SQL، ويستنزفه تنفيذ جديد، ويقوم وكيل Dispatch بتفويض عمل المجال عبر A2A، ويعود الرد مرة أخرى إلى سلسلة المحادثات الأصلية. تعمل عملية إعادة المحاولة لمدة 60 ثانية على استعادة أي شيء يموت في منتصف الرحلة."}>
+
+```html
+<div class="dsp-flow">
+  <div class="dsp-row">
+    <div class="diagram-node">
+      رسالة Slack مباشرة<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"
+        >تحقق + INSERT لمهمة معلقة</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"
+        >استلام المهمة · بدء حلقة الوكيل</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 يقرر</span
+      ><small class="diagram-muted">analytics intent &rarr; call-agent</small>
+    </div>
+  </div>
+  <div class="dsp-row">
+    <div class="diagram-box" data-rough>
+      تطبيق التحليلات<br /><small class="diagram-muted"
+        >نظير A2A · ينفذ عمل SQL</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;
 }
 ```
 
+</Diagram>
+
 ينطبق نفس التدفق على البريد الإلكتروني، وTelegram، وWhatsApp - يتغير المحول فقط.
 
 ## قصة الموثوقية {#reliability}

package/docs/content/locales/ar-SA/drop-in-agent.mdx

@@ -27,13 +27,72 @@ description: "قم بتثبيت دردشة الوكيل + مساحة العمل
 
 يتم تصدير كل هذه العناصر من `@agent-native/core/client`.
 
-```an-diagram title="نموذج جبل" summary="<AgentSidebar> يغلف تخطيطك الحالي. يتم عرض مساراتك في المنطقة الرئيسية؛ يتم تركيب لوحة الوكيل بجانبهم. <AgentPanel> هي نفس اللوحة بدون الغلاف."
-{
-  "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\">تطبيقك<br><small class=\"diagram-muted\">children: header + &lt;Outlet/&gt;</small></div><div class=\"diagram-node 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}"
+<Diagram id="doc-block-aqmizx" title={"نموذج جبل"} summary={"<AgentSidebar> يغلف تخطيطك الحالي. يتم عرض مساراتك في المنطقة الرئيسية؛ يتم تركيب لوحة الوكيل بجانبهم. <AgentPanel> هي نفس اللوحة بدون الغلاف."}>
+
+```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">
+        تطبيقك<br /><small class="diagram-muted"
+          >children: header + &lt;Outlet/&gt;</small
+        >
+      </div>
+      <div class="diagram-node 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;
 }
 ```
 
+</Diagram>
+
 ## حالة 80%: `<AgentSidebar>` {#sidebar}
 
 الإعداد الأكثر شيوعًا هو الشريط الجانبي الذي يفتح من اليمين على أي شاشة.

package/docs/content/locales/ar-SA/durable-resume.mdx

@@ -13,13 +13,56 @@ description: "عند مقاطعة تشغيل الوكيل المستضاف وا
 
 السيرة الذاتية الدائمة تسد هذه الفجوة. عند الاستئناف، يعرف إطار العمل استدعاءات أدوات التأثير الجانبي التي تم إكمالها بالفعل ويرفض إعادة تشغيلها — على طبقتين.
 
-```an-diagram title="طبقتان تمنعان الآثار الجانبية المكررة في السيرة الذاتية" summary="تقرأ المجلة دفتر الأستاذ المتين وتصنف المكالمات السابقة؛ تخبر الطبقة الأولى النموذج، بينما تمنع الطبقة الثانية بشدة الكتابة المعاد إرسالها والتي تطابق الإدخال المكتمل."
-{
-  "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\">الطبقة 2 · كتابة معاد إرسالها بحظر صارم</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}"
+<Diagram id="doc-block-1asu7x4" title={"طبقتان تمنعان الآثار الجانبية المكررة في السيرة الذاتية"} summary={"تقرأ المجلة دفتر الأستاذ المتين وتصنف المكالمات السابقة؛ تخبر الطبقة الأولى النموذج، بينما تمنع الطبقة الثانية بشدة الكتابة المعاد إرسالها والتي تطابق الإدخال المكتمل."}>
+
+```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">
+      الطبقة 2 · كتابة معاد إرسالها بحظر صارم
+    </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;
 }
 ```
 
+</Diagram>
+
 ## سجل استدعاء الأداة {#journal}
 
 إن دفتر اليومية عبارة عن **قراءة خالصة عبر دفتر الأستاذ المتين لحدث التشغيل** — ولا يوجد رابط تسجيل جديد في المسار السريع. يقوم بتصنيف استدعاءات الأداة المسجلة بالفعل للدورة الحالية:

package/docs/content/locales/ar-SA/embedding-sdk.mdx

@@ -11,13 +11,56 @@ description: "قم بتضمين ملف جانبي Agent-Native في تطبيق S
 السيارة الجانبية المضمنة، أو التطبيق الكامل، تبدأ بـ
 [Agent Surfaces](/docs/agent-surfaces).
 
-```an-diagram title="غشاء التضمين" summary="يوفر التطبيق المضيف مصادقة من جانب الخادم وسياق الصفحة المباشرة؛ يقوم Agent-Native بتشغيل السيارة الجانبية المتينة ويصل إلى علامة التبويب المفتوحة من خلال إجراءات العميل وأوامر المضيف."
-{
-  "html": "<div class=\"diagram-embed\"><div class=\"diagram-box\" data-rough><strong>تطبيق SaaS المضيف</strong><small class=\"diagram-muted\">واجهتك ومصادقتك</small></div><div class=\"diagram-col\"><div class=\"diagram-pill accent\">getContext &rarr;</div><div class=\"diagram-pill\">&larr; إجراءات العميل</div><div class=\"diagram-pill\">&larr; أوامر المضيف</div></div><div class=\"diagram-panel center\" data-rough><strong>Agent-Native sidecar</strong><small class=\"diagram-muted\">دردشة دائمة · حالة التطبيق · الإضافات</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>SQL<br><small class=\"diagram-muted\">جداول الإطار</small></div></div>",
-  "css": ".diagram-embed{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-embed .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-embed .diagram-arrow{font-size:22px;line-height:1}.diagram-embed .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+<Diagram id="doc-block-rxyzmb" title={"غشاء التضمين"} summary={"يوفر التطبيق المضيف مصادقة من جانب الخادم وسياق الصفحة المباشرة؛ يقوم Agent-Native بتشغيل السيارة الجانبية المتينة ويصل إلى علامة التبويب المفتوحة من خلال إجراءات العميل وأوامر المضيف."}>
+
+```html
+<div class="diagram-embed">
+  <div class="diagram-box" data-rough>
+    <strong>تطبيق SaaS المضيف</strong
+    ><small class="diagram-muted">واجهتك ومصادقتك</small>
+  </div>
+  <div class="diagram-col">
+    <div class="diagram-pill accent">getContext &rarr;</div>
+    <div class="diagram-pill">&larr; إجراءات العميل</div>
+    <div class="diagram-pill">&larr; أوامر المضيف</div>
+  </div>
+  <div class="diagram-panel center" data-rough>
+    <strong>Agent-Native sidecar</strong
+    ><small class="diagram-muted">دردشة دائمة · حالة التطبيق · الإضافات</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box" data-rough>
+    SQL<br /><small class="diagram-muted">جداول الإطار</small>
+  </div>
+</div>
+```
+
+```css
+.diagram-embed {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-embed .diagram-col {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.diagram-embed .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-embed .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
 }
 ```
 
+</Diagram>
+
 ## ابدأ هنا: المكوّن الإضافي المتضمن بالبطاريات {#batteries-included}
 
 بالنسبة لمعظم مضيفي SaaS، **استخدم وقت التشغيل المضمن الكامل** — المكون الإضافي للخادم
@@ -373,13 +416,45 @@ const hostTools = createAgentNativeHostTools({
 
 بالنسبة لزميل العمل ذو النمط CLAW، يمكن لإطار iframe أيضًا تسجيل علامة تبويب المتصفح المباشرة الخاصة به مع الواجهة الخلفية الجانبية. يحصل الوكيل بعد ذلك على أدوات الواجهة الخلفية العادية التي تسجل الطلب، ويطالب به إطار iframe، وتنفذه الصفحة المضيفة، وترجع الواجهة الخلفية النتيجة إلى الوكيل.
 
-```an-diagram title="جسر جلسة المتصفح بوساطة الخادم" summary="أداة الواجهة الخلفية تحجز العمل؛ تطالب علامة التبويب المسجلة بها، وتقوم بتشغيلها على الصفحة المباشرة، وتعود النتيجة إلى الوكيل - لذلك لا يزال بإمكان وكيل backend/Slack/A2A لمس علامة التبويب المفتوحة."
-{
-  "html": "<div class=\"diagram-bridge\"><div class=\"diagram-node\" data-rough>وكيل الخلفية<br><small class=\"diagram-muted\">دردشة · Slack · A2A</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>enqueue request<br><small class=\"diagram-muted\">/_agent-native/browser-sessions</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>تتبناه علامة التبويب النشطة<br><small class=\"diagram-muted\">registered bridge</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">result &rarr; agent</div></div>",
-  "css": ".diagram-bridge{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-bridge .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-sh4wh5" title={"جسر جلسة المتصفح بوساطة الخادم"} summary={"أداة الواجهة الخلفية تحجز العمل؛ تطالب علامة التبويب المسجلة بها، وتقوم بتشغيلها على الصفحة المباشرة، وتعود النتيجة إلى الوكيل - لذلك لا يزال بإمكان وكيل backend/Slack/A2A لمس علامة التبويب المفتوحة."}>
+
+```html
+<div class="diagram-bridge">
+  <div class="diagram-node" data-rough>
+    وكيل الخلفية<br /><small class="diagram-muted">دردشة · Slack · A2A</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box" data-rough>
+    enqueue request<br /><small class="diagram-muted"
+      >/_agent-native/browser-sessions</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node" data-rough>
+    تتبناه علامة التبويب النشطة<br /><small class="diagram-muted"
+      >registered bridge</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-pill ok">result &rarr; agent</div>
+</div>
+```
+
+```css
+.diagram-bridge {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.diagram-bridge .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 في تطبيق Sidecar، ابدأ تشغيل جسر جلسة المتصفح مرة واحدة عند تثبيت iframe:
 
 ```tsx