@agent-native/core 0.79.25 → 0.79.27

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

@@ -15,13 +15,73 @@ description: "تكامل أفضل للمصادقة مع البريد الإلك
 - **جهاز التحكم عن بعد MCP OAuth:** معيار OAuth 2.1 لمضيفي MCP مثل Claude Code وموصلات ChatGPT.
 - **مخصص:** قم بإحضار المصادقة الخاصة بك عبر رد الاتصال `getSession`.
 
-```an-diagram title="ثلاث طرق في جلسة واحدة" summary="يقوم كل زوار المستعرض وعملاء MCP الآليين والموفرين المخصصين بالتوصل إلى نفس AuthSession الذي يقرأه النطاق النهائي."
-{
-  "html": "<div class=\"auth-modes\"><div class=\"diagram-col\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">تقصير</span><strong>مصادقة أفضل</strong><small class=\"diagram-muted\">email/password &middot; جوجل &middot; جيثب</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">جهاز التحكم عن بعد MCP OAuth</span><strong>OAuth 2.1 + MCP</strong><small class=\"diagram-muted\">موصلات Claude Code، ChatGPT</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">مخصص</span><strong>رد اتصال getSession</strong><small class=\"diagram-muted\">موظف &middot; مصادقة0 &middot; Firebase</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill ok\">AuthSession</span><small class=\"diagram-muted\">بريد إلكتروني &middot; orgId &middot; orgRole</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">سياق الطلب &amp; نطاق البيانات</div></div>",
-  "css": ".auth-modes{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.auth-modes .diagram-col{display:flex;flex-direction:column;gap:10px}.auth-modes .diagram-card{display:flex;flex-direction:column;gap:4px;padding:10px 12px}.auth-modes .diagram-arrow{font-size:22px;line-height:1}.auth-modes .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+<Diagram id="doc-block-5y2l0x" title={"ثلاث طرق في جلسة واحدة"} summary={"يقوم كل زوار المستعرض وعملاء MCP الآليين والموفرين المخصصين بالتوصل إلى نفس AuthSession الذي يقرأه النطاق النهائي."}>
+
+```html
+<div class="auth-modes">
+  <div class="diagram-col">
+    <div class="diagram-card">
+      <span class="diagram-pill accent">تقصير</span><strong>مصادقة أفضل</strong
+      ><small class="diagram-muted"
+        >email/password &middot; جوجل &middot; جيثب</small
+      >
+    </div>
+    <div class="diagram-card">
+      <span class="diagram-pill">جهاز التحكم عن بعد MCP OAuth</span
+      ><strong>OAuth 2.1 + MCP</strong
+      ><small class="diagram-muted">موصلات Claude Code، ChatGPT</small>
+    </div>
+    <div class="diagram-card">
+      <span class="diagram-pill">مخصص</span><strong>رد اتصال getSession</strong
+      ><small class="diagram-muted"
+        >موظف &middot; مصادقة0 &middot; Firebase</small
+      >
+    </div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel center">
+    <span class="diagram-pill ok">AuthSession</span
+    ><small class="diagram-muted"
+      >بريد إلكتروني &middot; orgId &middot; orgRole</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box">سياق الطلب &amp; نطاق البيانات</div>
+</div>
+```
+
+```css
+.auth-modes {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.auth-modes .diagram-col {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+.auth-modes .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 10px 12px;
+}
+.auth-modes .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.auth-modes .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
 }
 ```
 
+</Diagram>
+
 تدفق المتصفح هو نفس تدفق المصادقة الأفضل في كل مكان - لا يوجد **تجاوز مصادقة التطوير**، ولا يعود `getSession()` أبدًا إلى حارس `local@localhost`. ما يتغير بين البيئات هو احتكاك الاشتراك، وليس جدار تسجيل الدخول:
 
 | البيئة                  | سلوك التحميل الأول                                                                     | التحقق من البريد الإلكتروني                                |
@@ -164,13 +224,65 @@ https://mail.agent-native.com/_agent-native/mcp
 
 تقوم طلبات MCP غير المصادق عليها بإرجاع تحدي `WWW-Authenticate` الذي يشير إلى `/.well-known/oauth-protected-resource`. يكتشف العميل بعد ذلك بيانات تعريف OAuth الخاصة بالتطبيق، ويسجل عميلًا عامًا ديناميكيًا، ويفتح صفحة ترخيص التطبيق، ويتبادل رمز التفويض مع PKCE للوصول إلى الرموز المميزة وتحديثها.
 
-```an-diagram title="البعيد MCP OAuth المصافحة" summary="يبدأ تشغيل العميل القادر على OAuth من مجرد التحدي MCP URL - والاكتشاف والتسجيل الديناميكي، ثم تبادل التعليمات البرمجية PKCE."
-{
-  "html": "<div class=\"mcp-flow\"><div class=\"diagram-node\">1 &middot; طلب MCP<br><small class=\"diagram-muted\">لا رمز</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node warn\">2 &middot; تحدي 401<br><small class=\"diagram-muted\">WWW-Authenticate</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">3 &middot; اكتشف البيانات الوصفية<br><small class=\"diagram-muted\">.well-known</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">4 &middot; تسجيل العميل<br><small class=\"diagram-muted\">ديناميكية، عامة</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">5 &middot; تفويض + MCP<br><small class=\"diagram-muted\">تبادل الكود</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node ok\">6 &middot; الوصول + التحديث<br><small class=\"diagram-muted\">audience-bound</small></div></div>",
-  "css": ".mcp-flow{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.mcp-flow .diagram-node{display:flex;flex-direction:column;gap:2px;padding:8px 12px}.mcp-flow .diagram-arrow{font-size:20px;line-height:1}"
+<Diagram id="doc-block-awngem" title={"البعيد MCP OAuth المصافحة"} summary={"يبدأ تشغيل العميل القادر على OAuth من مجرد التحدي MCP URL - والاكتشاف والتسجيل الديناميكي، ثم تبادل التعليمات البرمجية PKCE."}>
+
+```html
+<div class="mcp-flow">
+  <div class="diagram-node">
+    1 &middot; طلب MCP<br /><small class="diagram-muted">لا رمز</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node warn">
+    2 &middot; تحدي 401<br /><small class="diagram-muted"
+      >WWW-Authenticate</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node">
+    3 &middot; اكتشف البيانات الوصفية<br /><small class="diagram-muted"
+      >.well-known</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node">
+    4 &middot; تسجيل العميل<br /><small class="diagram-muted"
+      >ديناميكية، عامة</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node">
+    5 &middot; تفويض + MCP<br /><small class="diagram-muted">تبادل الكود</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node ok">
+    6 &middot; الوصول + التحديث<br /><small class="diagram-muted"
+      >audience-bound</small
+    >
+  </div>
+</div>
+```
+
+```css
+.mcp-flow {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+.mcp-flow .diagram-node {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 8px 12px;
+}
+.mcp-flow .diagram-arrow {
+  font-size: 20px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 يتم توقيع رموز الوصول باستخدام `A2A_SECRET` عند تعيينها، وإلا مع `BETTER_AUTH_SECRET`. وهي تحمل هوية المستخدم/المؤسسة الموقعة ونطاقات `mcp:read` و/أو `mcp:write` و/أو `mcp:apps`، وهي مرتبطة بالجمهور بمورد MCP الدقيق URL. يتم تخزين رموز التحديث فقط كتجزئة ويتم تدويرها عند كل تحديث. يتم تشغيل استدعاءات الأدوات وقراءات موارد تطبيقات MCP داخل نفس سياق الطلب مثل المستخدم الذي قام بتسجيل الدخول؛ لا يتلقى إطار iframe لتطبيق MCP المضمن رموز OAuth الأولية أبدًا.
 
 يكتب `npx @agent-native/core@latest connect <url> --client claude-code` إدخال URL فقط MCP لهذا التدفق القياسي. بالنسبة للعملاء الذين لا يمكنهم تنفيذ MCP OAuth عن بعد، استخدم صفحة الاتصال أو البديل `npx @agent-native/core@latest connect --token <token>` لكتابة إدخال صريح للرمز المميز للحامل.

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

@@ -9,13 +9,52 @@ description: "عمليات التشغيل التلقائي المجدولة وا
 
 توسّع عمليات التشغيل الآلي [recurring jobs](/docs/recurring-jobs) من خلال **مشغلات الأحداث** و**شروط اللغة الطبيعية** و**HTTP** الصادرة عبر أداة `web-request`. إنهم يستخدمون نفس تنسيق الملف `jobs/<name>.md` والتخزين وسير العمل "إنشاء ثلاث طرق" كمهام متكررة - راجع [Recurring Jobs](/docs/recurring-jobs#job-file) للتعرف على التنسيق المشترك. تغطي هذه الصفحة فقط ما هو جديد في عمليات التشغيل الآلي المستندة إلى الأحداث.
 
-```an-diagram title="عندما يحدث X، افعل Y" summary="يتم إطلاق حدث على الحافلة، ويفتحها شرط اختياري للغة الطبيعية، ويقوم الوكيل بتشغيل جسم التشغيل الآلي مع إمكانية الوصول الكامل للأداة."
-{
-  "html": "<div class=\"auto-flow\"><div class=\"diagram-card\"><span class=\"diagram-pill\">حدث</span><small class=\"diagram-muted\"><code>calendar.booking.created</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">حالة</span><small class=\"diagram-muted\">يتحقق هايكو: &ldquo;ينتهي البريد الإلكتروني بـ @builder.io&rdquo;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent\"><span class=\"diagram-pill accent\">وكيل يدير الجسم</span><small class=\"diagram-muted\">الإجراءات &middot; web-request &middot; MCP &middot; sub-agents</small></div></div>",
-  "css": ".auto-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.auto-flow .diagram-card{display:flex;flex-direction:column;gap:4px;padding:14px 16px;min-width:180px}.auto-flow .diagram-arrow{font-size:22px}"
+<Diagram id="doc-block-abgxj6" title={"عندما يحدث X، افعل Y"} summary={"يتم إطلاق حدث على الحافلة، ويفتحها شرط اختياري للغة الطبيعية، ويقوم الوكيل بتشغيل جسم التشغيل الآلي مع إمكانية الوصول الكامل للأداة."}>
+
+```html
+<div class="auto-flow">
+  <div class="diagram-card">
+    <span class="diagram-pill">حدث</span
+    ><small class="diagram-muted"><code>calendar.booking.created</code></small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">حالة</span
+    ><small class="diagram-muted"
+      >يتحقق هايكو: &ldquo;ينتهي البريد الإلكتروني بـ @builder.io&rdquo;</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-card accent">
+    <span class="diagram-pill accent">وكيل يدير الجسم</span
+    ><small class="diagram-muted"
+      >الإجراءات &middot; web-request &middot; MCP &middot; sub-agents</small
+    >
+  </div>
+</div>
+```
+
+```css
+.auto-flow {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.auto-flow .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 14px 16px;
+  min-width: 180px;
+}
+.auto-flow .diagram-arrow {
+  font-size: 22px;
 }
 ```
 
+</Diagram>
+
 ## نوعان من المشغلات {#trigger-types}
 
 | اكتب       | يتم تشغيله عند                               | حقل المفتاح       |
@@ -225,13 +264,76 @@ Confirm an automation's wiring and condition without waiting for a real provider
 
 ## كيف يعمل الإرسال {#dispatch}
 
-```an-diagram title="مسار الإرسال" summary="من حدث مطرود إلى تشغيل وكيل مكتمل، مقيد بنطاق الملكية وحالة اللغة الطبيعية."
-{
-  "html": "<div class=\"disp\"><div class=\"diagram-box accent\">حدث إطلاق النار على الحافلة</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">مباراة</span><small class=\"diagram-muted\">تحميل الأتمتة التي تم تمكينها والمشتركة في اسم الحدث هذا</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">نِطَاق</span><small class=\"diagram-muted\">الاحتفاظ فقط بالأشياء المملوكة لمالك الحدث (أو المشتركة)</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">حالة</span><small class=\"diagram-muted\">Haiku yes/no على الحمولة &mdash; خطأ شنيع &rarr; <code>تم تخطيه</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card accent\"><span class=\"diagram-pill accent\">يجري</span><small class=\"diagram-muted\"><code>runAgentLoop</code> مع النص كموجه، والحمولة كسياق، ومهلة مدتها 5 دقائق</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card ok\"><span class=\"diagram-pill ok\">سِجِلّ</span><small class=\"diagram-muted\">يكتب <code>lastRun</code> / <code>lastStatus</code> / <code>lastError</code></small></div></div>",
-  "css": ".disp{display:flex;flex-direction:column;gap:6px;max-width:540px}.disp .diagram-card{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.disp .diagram-box{align-self:flex-start}.disp .diagram-arrow{font-size:18px;align-self:center}"
+<Diagram id="doc-block-znsz65" title={"مسار الإرسال"} summary={"من حدث مطرود إلى تشغيل وكيل مكتمل، مقيد بنطاق الملكية وحالة اللغة الطبيعية."}>
+
+```html
+<div class="disp">
+  <div class="diagram-box accent">حدث إطلاق النار على الحافلة</div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">مباراة</span
+    ><small class="diagram-muted"
+      >تحميل الأتمتة التي تم تمكينها والمشتركة في اسم الحدث هذا</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">نِطَاق</span
+    ><small class="diagram-muted"
+      >الاحتفاظ فقط بالأشياء المملوكة لمالك الحدث (أو المشتركة)</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill warn">حالة</span
+    ><small class="diagram-muted"
+      >Haiku yes/no على الحمولة &mdash; خطأ شنيع &rarr;
+      <code>تم تخطيه</code></small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card accent">
+    <span class="diagram-pill accent">يجري</span
+    ><small class="diagram-muted"
+      ><code>runAgentLoop</code> مع النص كموجه، والحمولة كسياق، ومهلة مدتها 5
+      دقائق</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card ok">
+    <span class="diagram-pill ok">سِجِلّ</span
+    ><small class="diagram-muted"
+      >يكتب <code>lastRun</code> / <code>lastStatus</code> /
+      <code>lastError</code></small
+    >
+  </div>
+</div>
+```
+
+```css
+.disp {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  max-width: 540px;
+}
+.disp .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 10px 14px;
+}
+.disp .diagram-box {
+  align-self: flex-start;
+}
+.disp .diagram-arrow {
+  font-size: 18px;
+  align-self: center;
 }
 ```
 
+</Diagram>
+
 ## مثال {#example}
 
 **المستخدم:** "عندما يقوم شخص ما بالحجز باستخدام بريد إلكتروني @builder.io، أرسل لي رسالة على Slack."

package/docs/content/locales/ar-SA/blueprint-installer.mdx

@@ -17,13 +17,51 @@ agent-native add provider stripe | claude
 agent-native add channel discord  | codex
 ```
 
-```an-diagram title="إضافة مطبوعات وصفة؛ يقوم وكيل الترميز الخاص بك بتطبيقه" summary="agent-native يُصدر مخطط Markdown إلى stdout (التشخيص إلى stderr)؛ تقوم بتوصيله إلى Claude Code أو Codex، والذي يقوم بتحرير الريبو المباشر الخاص بك بالسياق الكامل."
-{
-  "html": "<div class=\"diagram-bp\"><div class=\"diagram-node\" data-rough>agent-native إضافة<br><small class=\"diagram-muted\">&lt;عطوف&gt; &lt;الاسم|URL&gt;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>مخطط Markdown<br><small class=\"diagram-muted\">stdout · ملفات للمس · قواعد · التحقق</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough>وكيل الترميز<br><small class=\"diagram-muted\">كلود · المخطوطة</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">يقوم بتحرير الريبو المباشر الخاص بك</div></div>",
-  "css": ".diagram-bp{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-bp .diagram-arrow{font-size:22px;line-height:1}.diagram-bp .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+<Diagram id="doc-block-r926ue" title={"إضافة مطبوعات وصفة؛ يقوم وكيل الترميز الخاص بك بتطبيقه"} summary={"agent-native يُصدر مخطط Markdown إلى stdout (التشخيص إلى stderr)؛ تقوم بتوصيله إلى Claude Code أو Codex، والذي يقوم بتحرير الريبو المباشر الخاص بك بالسياق الكامل."}>
+
+```html
+<div class="diagram-bp">
+  <div class="diagram-node" data-rough>
+    agent-native إضافة<br /><small class="diagram-muted"
+      >&lt;عطوف&gt; &lt;الاسم|URL&gt;</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box" data-rough>
+    مخطط Markdown<br /><small class="diagram-muted"
+      >stdout · ملفات للمس · قواعد · التحقق</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel center" data-rough>
+    وكيل الترميز<br /><small class="diagram-muted">كلود · المخطوطة</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-pill ok">يقوم بتحرير الريبو المباشر الخاص بك</div>
+</div>
+```
+
+```css
+.diagram-bp {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.diagram-bp .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-bp .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
 }
 ```
 
+</Diagram>
+
 ## الاستخدام {#usage}
 
 ```bash

package/docs/content/locales/ar-SA/cli-adapters.mdx

@@ -12,13 +12,49 @@ description: "امنح الوكيل وصولاً منظمًا إلى أي أدا
 
 يحتوي محول CLI على أداة سطر أوامر واحدة (`gh`، `ffmpeg`، `stripe`، `aws`) حتى يتمكن الوكيل من اكتشافها والتحقق من تثبيتها وتشغيلها باستخدام نتيجة كود stdout/stderr/exit متسقة. بدون هذا التماس، يعيد كل نص برمجي اختراع كيفية استدعاء CLI وتحليل مخرجاته.
 
-```an-diagram title="CLI محول → التسجيل → سطح العمل" summary="ShellCliAdapter يلتف ثنائي؛ يقوم CliRegistry بجمع المحولات لاكتشافها؛ يكشف defineAction عن مكالمة واحدة على سطح عمل الوكيل + واجهة المستخدم."
-{
-  "html": "<div class=\"diagram-cli\"><div class=\"diagram-node\" data-rough>gh · ffmpeg · الشريط<br><small class=\"diagram-muted\">أدوات سطر الأوامر</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>ShellCliAdapter<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>كليريجستري<br><small class=\"diagram-muted\">وصف () للاكتشاف</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">defineAction</div></div>",
-  "css": ".diagram-cli{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-cli .diagram-arrow{font-size:22px;line-height:1}.diagram-cli .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+<Diagram id="doc-block-1tpkll1" title={"CLI محول → التسجيل → سطح العمل"} summary={"ShellCliAdapter يلتف ثنائي؛ يقوم CliRegistry بجمع المحولات لاكتشافها؛ يكشف defineAction عن مكالمة واحدة على سطح عمل الوكيل + واجهة المستخدم."}>
+
+```html
+<div class="diagram-cli">
+  <div class="diagram-node" data-rough>
+    gh · ffmpeg · الشريط<br /><small class="diagram-muted"
+      >أدوات سطر الأوامر</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box" data-rough>
+    ShellCliAdapter<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>
+    كليريجستري<br /><small class="diagram-muted">وصف () للاكتشاف</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-pill accent">defineAction</div>
+</div>
+```
+
+```css
+.diagram-cli {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.diagram-cli .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-cli .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
 }
 ```
 
+</Diagram>
+
 ## الواجهة {#the-interface}
 
 ينفذ كل محول CLI `CliAdapter`:

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

@@ -15,13 +15,51 @@ description: "الخطافات والأدوات المساعدة React لتطب
 
 الطريقة الأساسية لقراءة بيانات التطبيق وكتابتها من المتصفح هي من خلال خطافات الإجراء. لا تكتب أبدًا مكالمات `fetch` يدويًا إلى مسارات `/_agent-native/*` - استخدم المساعدين المحددين بدلاً من ذلك (راجع [Actions](/docs/actions)).
 
-```an-diagram title="حلقة بيانات المتصفح" summary="خطافات القراءة والكتابة من خلال الإجراءات؛ يراقب useDbSync قاعدة البيانات حتى يقوم الوكيل والخلفية بإعادة جلب نفس ذاكرات التخزين المؤقت تلقائيًا."
-{
-  "html": "<div class=\"diagram-client\"><div class=\"diagram-col\"><div class=\"diagram-node\">useActionQuery<br><small class=\"diagram-muted\">قراءة مخبأة</small></div><div class=\"diagram-node\">useActionMutation<br><small class=\"diagram-muted\">كتابة + إبطال</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-box\" data-rough>Actions<br><small class=\"diagram-muted\">/_agent-native/actions/*</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-panel\" data-rough><strong>SQL قاعدة البيانات</strong></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-pill ok\">useDbSync &rarr; الإعادة على التغيير</div></div>",
-  "css": ".diagram-client{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-client .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-client .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-12sq7bk" title={"حلقة بيانات المتصفح"} summary={"خطافات القراءة والكتابة من خلال الإجراءات؛ يراقب useDbSync قاعدة البيانات حتى يقوم الوكيل والخلفية بإعادة جلب نفس ذاكرات التخزين المؤقت تلقائيًا."}>
+
+```html
+<div class="diagram-client">
+  <div class="diagram-col">
+    <div class="diagram-node">
+      useActionQuery<br /><small class="diagram-muted">قراءة مخبأة</small>
+    </div>
+    <div class="diagram-node">
+      useActionMutation<br /><small class="diagram-muted">كتابة + إبطال</small>
+    </div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&harr;</div>
+  <div class="diagram-box" data-rough>
+    Actions<br /><small class="diagram-muted">/_agent-native/actions/*</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&harr;</div>
+  <div class="diagram-panel" data-rough>
+    <strong>SQL قاعدة البيانات</strong>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&#8635;</div>
+  <div class="diagram-pill ok">useDbSync &rarr; الإعادة على التغيير</div>
+</div>
+```
+
+```css
+.diagram-client {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.diagram-client .diagram-col {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+.diagram-client .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 ```tsx
 import {
   useActionQuery,
@@ -376,13 +414,47 @@ function DashboardView({ id }) {
 - ** الطفرات التي بدأتها UI:** عند تنفيذ إجراء من UI باستخدام `useActionMutation`، تقوم الطفرة على الفور بإطلاق حدث محلي مع `source: "action"` عند النجاح. يؤدي هذا إلى تشغيل **إعادة جلب فورية ومتفائلة** لجميع مفاتيح الاستعلام اعتمادًا على هذا الإجراء، مع تجنب التأخير البصري.
 - **طفرات الخلفية أو الوكيل:** عندما يقوم وكيل الذكاء الاصطناعي أو خطاف الويب أو عامل الخلفية بتغيير البيانات، يتم بث التحديث إلى العميل. يلتقط `useDbSync` الخاص بالعميل هذا إما على الفور عبر SSE (الأحداث المرسلة من الخادم) أو يعود إلى **علامة الاستقصاء التي تبلغ ثانيتين**. ثم يبرز إصدار مفتاح الاستعلام، مما يؤدي إلى إعادة جلب الخلفية.
 
-```an-diagram title="طريقان للإعادة" summary="تؤدي الطفرة المحلية إلى إبطال ذاكرة التخزين المؤقت الخاصة بها على الفور؛ تصل الكتابة عن بعد إلى علامة التبويب هذه عبر SSE، أو علامة الاستقصاء كإجراء احتياطي."
-{
-  "html": "<div class=\"diagram-latency\"><div class=\"diagram-col\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill ok\">علامة التبويب هذه</span><strong>useActionMutation</strong><small class=\"diagram-muted\">مصدر الحرائق: \"العمل\" على النجاح &rarr; الاسترداد المحلي الفوري</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">الوكيل · خطاف الويب · علامة تبويب أخرى</span><strong>الكتابة عن بعد</strong><small class=\"diagram-muted\">دفع SSE، أو علامة الاستقصاء ~2s كبديل &rarr; المطبات الإصدار &rarr; إعادة الخلفية</small></div></div></div>",
-  "css": ".diagram-latency .diagram-col{display:flex;flex-direction:column;gap:12px}.diagram-latency .diagram-card{display:flex;flex-direction:column;gap:4px;padding:14px 16px}"
+<Diagram id="doc-block-ymmrn1" title={"طريقان للإعادة"} summary={"تؤدي الطفرة المحلية إلى إبطال ذاكرة التخزين المؤقت الخاصة بها على الفور؛ تصل الكتابة عن بعد إلى علامة التبويب هذه عبر SSE، أو علامة الاستقصاء كإجراء احتياطي."}>
+
+```html
+<div class="diagram-latency">
+  <div class="diagram-col">
+    <div class="diagram-card" data-rough>
+      <span class="diagram-pill ok">علامة التبويب هذه</span
+      ><strong>useActionMutation</strong
+      ><small class="diagram-muted"
+        >مصدر الحرائق: "العمل" على النجاح &rarr; الاسترداد المحلي الفوري</small
+      >
+    </div>
+    <div class="diagram-card" data-rough>
+      <span class="diagram-pill accent"
+        >الوكيل · خطاف الويب · علامة تبويب أخرى</span
+      ><strong>الكتابة عن بعد</strong
+      ><small class="diagram-muted"
+        >دفع SSE، أو علامة الاستقصاء ~2s كبديل &rarr; المطبات الإصدار &rarr;
+        إعادة الخلفية</small
+      >
+    </div>
+  </div>
+</div>
+```
+
+```css
+.diagram-latency .diagram-col {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.diagram-latency .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 14px 16px;
 }
 ```
 
+</Diagram>
+
 ## cn(...المدخلات) {#cn}
 
 أداة مساعدة لدمج أسماء الفئات (clsx + tailwind-merge):

package/docs/content/locales/ar-SA/cloneable-saas.mdx

@@ -51,13 +51,54 @@ description: "ابتكر منتج SaaS فعالاً واجعله ملكك - بم
 
 المسار من "أريد SaaS الخاص بي" إلى "لدي SaaS الخاص بي" قصير:
 
-```an-diagram title="شوكة وتخصيص" summary="اختر منتجًا نهائيًا، وقم بوضع علامة تجارية عليه، وقم بتطويره بلغة إنجليزية بسيطة، ثم اشحنه إلى النطاق الخاص بك."
-{
-  "html": "<div class=\"diagram-fork\"><div class=\"diagram-card\"><span class=\"diagram-pill\">1</span><strong>يختار</strong><small class=\"diagram-muted\">قالب كامل</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">2</span><strong>ماركة</strong><small class=\"diagram-muted\">الاسم والألوان والشعار والنسخة</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">3</span><strong>تخصيص</strong><small class=\"diagram-muted\">اسأل الوكيل &#8635;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill ok\">4</span><strong>سفينة</strong><small class=\"diagram-muted\">المجال الخاص بك</small></div></div>",
-  "css": ".diagram-fork{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-fork .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:130px}.diagram-fork .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-1crom0h" title={"شوكة وتخصيص"} summary={"اختر منتجًا نهائيًا، وقم بوضع علامة تجارية عليه، وقم بتطويره بلغة إنجليزية بسيطة، ثم اشحنه إلى النطاق الخاص بك."}>
+
+```html
+<div class="diagram-fork">
+  <div class="diagram-card">
+    <span class="diagram-pill">1</span><strong>يختار</strong
+    ><small class="diagram-muted">قالب كامل</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">2</span><strong>ماركة</strong
+    ><small class="diagram-muted">الاسم والألوان والشعار والنسخة</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill accent">3</span><strong>تخصيص</strong
+    ><small class="diagram-muted">اسأل الوكيل &#8635;</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill ok">4</span><strong>سفينة</strong
+    ><small class="diagram-muted">المجال الخاص بك</small>
+  </div>
+</div>
+```
+
+```css
+.diagram-fork {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+.diagram-fork .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 14px 16px;
+  min-width: 130px;
+}
+.diagram-fork .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 1. **اختر نموذجًا.** استخدم منتقي CLI، أو تصفح المستندات واختر واحدًا للبدء منه.
 2. **العلامة التجارية.** قم بتغيير الاسم والألوان والشعار والنسخة. تعرض معظم النماذج ذلك في ملف تكوين واحد.
 3. **قم بتخصيصه.** اطلب من الوكيل إضافة العمود الذي تحتاجه، وتغيير كيفية اتصال مجموعات البريد الوارد بـ API الداخلي، وإضافة طريقة عرض جديدة. يقوم الوكيل بتحرير الكود؛ قمت بمراجعة الفرق.
@@ -74,13 +115,49 @@ description: "ابتكر منتج SaaS فعالاً واجعله ملكك - بم
 
 النتيجة: مرونة على مستوى الكود Claude لكل مستخدم، مع اقتصاديات نشر SaaS العادية.
 
-```an-diagram title="لماذا مقياس الشوكات لكل مستخدم" summary="هناك فكرتان تجعلان نموذج الشوكة والتخصيص عمليًا: يقوم الوكيل بالصيانة، ويعيش التخصيص لكل مستخدم في SQL - وليس في التعليمات البرمجية لكل مستخدم."
-{
-  "html": "<div class=\"diagram-why\"><div class=\"diagram-panel\" data-rough><strong>قاعدة التعليمات البرمجية المشتركة</strong><small class=\"diagram-muted\">تطبيق واحد، تم نشره مرة واحدة</small><div class=\"diagram-pill accent\">الوكيل يقوم بالصيانة</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-panel\" data-rough><strong>طبقة لكل مستخدم في SQL</strong><small class=\"diagram-muted\">المهارات · الذاكرة · التعليمات · SQL · الوكلاء الفرعيون</small><div class=\"diagram-pill ok\">لا يوجد رمز لكل مستخدم</div></div></div>",
-  "css": ".diagram-why{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-why .diagram-panel{display:flex;flex-direction:column;gap:8px;padding:14px 18px;min-width:240px;flex:1}.diagram-why .diagram-arrow{font-size:24px;line-height:1}"
+<Diagram id="doc-block-1sp9g9z" title={"لماذا مقياس الشوكات لكل مستخدم"} summary={"هناك فكرتان تجعلان نموذج الشوكة والتخصيص عمليًا: يقوم الوكيل بالصيانة، ويعيش التخصيص لكل مستخدم في SQL - وليس في التعليمات البرمجية لكل مستخدم."}>
+
+```html
+<div class="diagram-why">
+  <div class="diagram-panel" data-rough>
+    <strong>قاعدة التعليمات البرمجية المشتركة</strong
+    ><small class="diagram-muted">تطبيق واحد، تم نشره مرة واحدة</small>
+    <div class="diagram-pill accent">الوكيل يقوم بالصيانة</div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&harr;</div>
+  <div class="diagram-panel" data-rough>
+    <strong>طبقة لكل مستخدم في SQL</strong
+    ><small class="diagram-muted"
+      >المهارات · الذاكرة · التعليمات · SQL · الوكلاء الفرعيون</small
+    >
+    <div class="diagram-pill ok">لا يوجد رمز لكل مستخدم</div>
+  </div>
+</div>
+```
+
+```css
+.diagram-why {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-why .diagram-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px 18px;
+  min-width: 240px;
+  flex: 1;
+}
+.diagram-why .diagram-arrow {
+  font-size: 24px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 ## لا تريد الشوكة؟ {#hosted}
 
 ليس عليك القيام بذلك. كل قالب متاح أيضًا كتطبيق مستضاف على `agent-native.com` — `mail.agent-native.com`، `calendar.agent-native.com`، وما إلى ذلك. استخدم الإصدار المستضاف مجانًا أو مدفوع؛ fork فقط عندما تريد تغيير شيء لا يكشفه الإصدار المستضاف.