@agent-native/core 0.79.26 → 0.79.27

package/corpus/core/docs/content/locales/ar-SA/pure-agent-apps.mdx

@@ -12,13 +12,57 @@ description: "التطبيقات التي يكون فيها الوكيل هو ا
 ينتمي. لا يزال تطبيقًا حقيقيًا: actions، الجلسات، حالة التطبيق، السجل،
 الإعدادات وبيانات الاعتماد وسجلات المشاركة كلها موجودة في SQL.
 
-```an-diagram title="حلقة وكيل التطبيق هي الباب الأمامي" summary="تصل العديد من نقاط الدخول إلى حلقة وكيل واحدة عبر إجراءات وحالة SQL-backed؛ تعود النتائج إلى المكان الذي جاء منه الطلب. تتم إضافة واجهة المستخدم فقط عندما يحتاج البشر إلى الإشراف."
-{
-  "html": "<div class=\"diagram-pure\"><div class=\"diagram-col\"><div class=\"diagram-pill\">Terminal</div><div class=\"diagram-pill\">Slack · بريد</div><div class=\"diagram-pill\">مهمة مجدولة</div><div class=\"diagram-pill\">Another agent (A2A)</div><div class=\"diagram-pill\">Chat</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">حلقة وكيل التطبيق</span><small class=\"diagram-muted\">الإجراءات · الجلسات · حالة التطبيق في SQL</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>تعود النتيجة<br><small class=\"diagram-muted\">to where it belongs</small></div></div>",
-  "css": ".diagram-pure{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-pure .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-pure .diagram-arrow{font-size:22px;line-height:1}.diagram-pure .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+<Diagram id="doc-block-1l5rx7k" title={"حلقة وكيل التطبيق هي الباب الأمامي"} summary={"تصل العديد من نقاط الدخول إلى حلقة وكيل واحدة عبر إجراءات وحالة SQL-backed؛ تعود النتائج إلى المكان الذي جاء منه الطلب. تتم إضافة واجهة المستخدم فقط عندما يحتاج البشر إلى الإشراف."}>
+
+```html
+<div class="diagram-pure">
+  <div class="diagram-col">
+    <div class="diagram-pill">Terminal</div>
+    <div class="diagram-pill">Slack · بريد</div>
+    <div class="diagram-pill">مهمة مجدولة</div>
+    <div class="diagram-pill">Another agent (A2A)</div>
+    <div class="diagram-pill">Chat</div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel center" data-rough>
+    <span class="diagram-pill accent">حلقة وكيل التطبيق</span
+    ><small class="diagram-muted"
+      >الإجراءات · الجلسات · حالة التطبيق في SQL</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box" data-rough>
+    تعود النتيجة<br /><small class="diagram-muted">to where it belongs</small>
+  </div>
+</div>
+```
+
+```css
+.diagram-pure {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-pure .diagram-col {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.diagram-pure .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-pure .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
 }
 ```
 
+</Diagram>
+
 قم بالوصول إلى هذا الشكل عند تشغيل العمل في الخلفية، ويترك الإخراج
 ، فإن المجال عبارة عن طلقة واحدة، أو أنك تقوم بإنشاء نموذج أولي. لا يزال الوكيل بحاجة إلى UI —
 ليست لوحة تحكم، ولكنها مكان يمكن للبشر الإشراف عليه وتكوينه وتوجيهه —

package/corpus/core/docs/content/locales/ar-SA/real-time-collaboration.mdx

@@ -36,13 +36,53 @@ description: "تحرير تعاوني متعدد المستخدمين حيث ي
 
 يحتوي نظام التعاون على خمس طبقات متشابكة.
 
-```an-diagram title="خمس طبقات متشابكة" summary="بدءًا من CRDT في الذاكرة وحتى وسيلة النقل التي تحمل التحديثات بين النظراء — تحتوي كل طبقة على وظيفة واحدة."
-{
-  "html": "<div class=\"diagram-stack\"><div class=\"diagram-card layer\"><span class=\"diagram-pill accent\">1 &middot; Yjs Y.Doc</span><small class=\"diagram-muted\">CRDT &mdash; دمج بلا تعارض، بلا منسق</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">2 &middot; المحتوى القانوني في SQL</span><small class=\"diagram-muted\">_collab_docs &mdash; durable source of truth, versioned</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">3 &middot; تسوية محكومة بـ updatedAt</span><small class=\"diagram-muted\">تنتشر تعديلات الوكيل عبر تحديث SQL</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">4 &middot; انتخاب العميل القائد</span><small class=\"diagram-muted\">علامة تبويب واحدة فقط تطبق اللقطة</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill ok\">5 &middot; مسار SSE السريع + الاستطلاع</span><small class=\"diagram-muted\">نحو عشرات المللي ثانية، ويتراجع إلى استطلاع كل ثانيتين في أي مكان</small></div></div>",
-  "css": ".diagram-stack{display:flex;flex-direction:column;gap:8px}.diagram-stack .layer{display:flex;flex-direction:column;gap:4px;padding:12px 14px}"
+<Diagram id="doc-block-1l6ef14" title={"خمس طبقات متشابكة"} summary={"بدءًا من CRDT في الذاكرة وحتى وسيلة النقل التي تحمل التحديثات بين النظراء — تحتوي كل طبقة على وظيفة واحدة."}>
+
+```html
+<div class="diagram-stack">
+  <div class="diagram-card layer">
+    <span class="diagram-pill accent">1 &middot; Yjs Y.Doc</span
+    ><small class="diagram-muted">CRDT &mdash; دمج بلا تعارض، بلا منسق</small>
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill">2 &middot; المحتوى القانوني في SQL</span
+    ><small class="diagram-muted"
+      >_collab_docs &mdash; durable source of truth, versioned</small
+    >
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill">3 &middot; تسوية محكومة بـ updatedAt</span
+    ><small class="diagram-muted">تنتشر تعديلات الوكيل عبر تحديث SQL</small>
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill">4 &middot; انتخاب العميل القائد</span
+    ><small class="diagram-muted">علامة تبويب واحدة فقط تطبق اللقطة</small>
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill ok">5 &middot; مسار SSE السريع + الاستطلاع</span
+    ><small class="diagram-muted"
+      >نحو عشرات المللي ثانية، ويتراجع إلى استطلاع كل ثانيتين في أي مكان</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-stack {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.diagram-stack .layer {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 12px 14px;
 }
 ```
 
+</Diagram>
+
 ### 1. Yjs Y.Doc (طبقة CRDT)
 
 كل مستند تعاوني عبارة عن `Y.Doc` يحتوي على أنواع مشتركة — عادةً ما يكون
@@ -100,13 +140,67 @@ description: "تحرير تعاوني متعدد المستخدمين حيث ي
 
 تستخدم أخطاء الشبكة التراجع الأسي مع عدم الاستقرار، بحد أقصى 15 ثانية تقريبًا.
 
-```an-diagram title="مساران للتحرير، أحدهما مدمج" summary="تدفق ضغطات المفاتيح البشرية Y.Doc → الخادم → SSE. تمر تعديلات الوكيل عبر SQL: يتم تحديث مطبات الإجراء عند تسوية العميل الرئيسي، ثم يُدخل التغيير مرة أخرى إلى Yjs."
-{
-  "html": "<div class=\"diagram-collab\"><div class=\"lane\"><span class=\"diagram-pill\">تعديل بشري</span><div class=\"diagram-node\">Y.Doc update<br><small class=\"diagram-muted\">تأخير debounce ~80 مللي ثانية</small></div><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\" data-rough>POST /update<br><small class=\"diagram-muted\">apply + persist</small></div><span class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box diagram-accent\">SSE push<br><small class=\"diagram-muted\">to all peers</small></div></div><div class=\"lane\"><span class=\"diagram-pill warn\">تعديل الوكيل</span><div class=\"diagram-node\">الإجراء يكتب SQL<br><small class=\"diagram-muted\">يحدث updatedAt</small></div><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\" data-rough>العميل القائد<br><small class=\"diagram-muted\">setContent إلى Y.Doc</small></div><span class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box diagram-accent\">POST /update<br><small class=\"diagram-muted\">re-enters Yjs &middot; SSE push</small></div></div></div>",
-  "css": ".diagram-collab{display:flex;flex-direction:column;gap:14px}.diagram-collab .lane{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-collab .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-1c1vbo3" title={"مساران للتحرير، أحدهما مدمج"} summary={"تدفق ضغطات المفاتيح البشرية Y.Doc → الخادم → SSE. تمر تعديلات الوكيل عبر SQL: يتم تحديث مطبات الإجراء عند تسوية العميل الرئيسي، ثم يُدخل التغيير مرة أخرى إلى Yjs."}>
+
+```html
+<div class="diagram-collab">
+  <div class="lane">
+    <span class="diagram-pill">تعديل بشري</span>
+    <div class="diagram-node">
+      Y.Doc update<br /><small class="diagram-muted"
+        >تأخير debounce ~80 مللي ثانية</small
+      >
+    </div>
+    <span class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box" data-rough>
+      POST /update<br /><small class="diagram-muted">apply + persist</small>
+    </div>
+    <span class="diagram-arrow diagram-accent" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box diagram-accent">
+      SSE push<br /><small class="diagram-muted">to all peers</small>
+    </div>
+  </div>
+  <div class="lane">
+    <span class="diagram-pill warn">تعديل الوكيل</span>
+    <div class="diagram-node">
+      الإجراء يكتب SQL<br /><small class="diagram-muted">يحدث updatedAt</small>
+    </div>
+    <span class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box" data-rough>
+      العميل القائد<br /><small class="diagram-muted"
+        >setContent إلى Y.Doc</small
+      >
+    </div>
+    <span class="diagram-arrow diagram-accent" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box diagram-accent">
+      POST /update<br /><small class="diagram-muted"
+        >re-enters Yjs &middot; SSE push</small
+      >
+    </div>
+  </div>
+</div>
+```
+
+```css
+.diagram-collab {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+.diagram-collab .lane {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+.diagram-collab .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 ## البدء السريع {#quickstart}
 
 ### 1. تثبيت الحزم

package/corpus/core/docs/content/locales/ar-SA/recurring-jobs.mdx

@@ -113,13 +113,68 @@ Summarize overnight emails.`,
 
 المجدول هو مكون إضافي لإطار العمل (روتين `processRecurringJobs()` الداخلي) يتم تشغيله أثناء العملية: يتم تنشيط `setInterval` كل 60 ثانية (مع تأخير بدء التشغيل لمدة 10 ثوانٍ) داخل المكون الإضافي لدردشة الوكيل، أينما كان الخادم قيد التشغيل.
 
-```an-diagram title="علامة جدولة واحدة" summary="كل ستينيات القرن الماضي، يجد المجدول المهام المستحقة، ويقوم بتشغيل كل منها كسلسلة وكيل جديدة، ويكتب النتيجة مرة أخرى إلى ملف المهمة."
-{
-  "html": "<div class=\"sched\"><div class=\"diagram-box accent\"><code>setInterval</code> &bull; 60s &#8635;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">1 &middot; scan</span><small class=\"diagram-muted\">list every enabled <code>jobs/*.md</code> across all owners</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">2 &middot; due?</span><small class=\"diagram-muted\">compare <code>nextRun</code> to now</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card accent\"><span class=\"diagram-pill accent\">3 &middot; run</span><small class=\"diagram-muted\">fresh agent thread, job body as the user message &mdash; actions, SQL, A2A, email</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card ok\"><span class=\"diagram-pill ok\">4 &middot; record</span><small class=\"diagram-muted\">write <code>lastRun</code> / <code>lastStatus</code> / <code>lastError</code>, recompute <code>nextRun</code></small></div></div>",
-  "css": ".sched{display:flex;flex-direction:column;gap:6px;max-width:520px}.sched .diagram-card{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.sched .diagram-box{align-self:flex-start}.sched .diagram-arrow{font-size:18px;align-self:center}"
+<Diagram id="doc-block-1y301ov" title={"علامة جدولة واحدة"} summary={"كل ستينيات القرن الماضي، يجد المجدول المهام المستحقة، ويقوم بتشغيل كل منها كسلسلة وكيل جديدة، ويكتب النتيجة مرة أخرى إلى ملف المهمة."}>
+
+```html
+<div class="sched">
+  <div class="diagram-box accent">
+    <code>setInterval</code> &bull; 60s &#8635;
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">1 &middot; scan</span
+    ><small class="diagram-muted"
+      >list every enabled <code>jobs/*.md</code> across all owners</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">2 &middot; due?</span
+    ><small class="diagram-muted">compare <code>nextRun</code> to now</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card accent">
+    <span class="diagram-pill accent">3 &middot; run</span
+    ><small class="diagram-muted"
+      >fresh agent thread, job body as the user message &mdash; actions, SQL,
+      A2A, email</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card ok">
+    <span class="diagram-pill ok">4 &middot; record</span
+    ><small class="diagram-muted"
+      >write <code>lastRun</code> / <code>lastStatus</code> /
+      <code>lastError</code>, recompute <code>nextRun</code></small
+    >
+  </div>
+</div>
+```
+
+```css
+.sched {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  max-width: 520px;
+}
+.sched .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 10px 14px;
+}
+.sched .diagram-box {
+  align-self: flex-start;
+}
+.sched .diagram-arrow {
+  font-size: 18px;
+  align-self: center;
 }
 ```
 
+</Diagram>
+
 <Callout id="doc-block-j6yn07" tone="risk">
 
 **Scale-to-zero caveat.** The scheduler is in-process, so on serverless hosts jobs only fire while an instance is warm. If reliable scheduling matters, keep an instance warm with keep-alive pings or use an always-on host (Fly, Render, a VPS).

package/corpus/core/docs/content/locales/ar-SA/routing.mdx

@@ -21,14 +21,53 @@ description: "التوجيه المستند إلى الملفات لتطبيقا
 
 بادئة مقطع بـ `$` لمعلمة ديناميكية. البادئة بـ `_` لجعلها مسار تخطيط بلا مسار (لا يوجد مقطع URL). تستخدم القوالب `flatRoutes()` — ملف التدوين النقطي أعلاه هو ملف أساسي؛ يعمل أيضًا نموذج المجلد المتداخل `inbox/route.tsx`.
 
-```an-diagram title="تخطيط بلا مسار يلتف الصفحات" summary="يعرض تخطيط _app.tsx (لا يوجد مقطع URL) الصدفة المشتركة مرة واحدة؛ يتم عرض الصفحات المطابقة داخل <Outlet/> الخاص بها، لذلك لا يتم إعادة تحميل الشريط الجانبي للوكيل أبدًا أثناء التنقل."
-{
-"html": "<div class=\"diagram-layout\" data-rough><div class=\"diagram-shell\"><span class=\"diagram-pill accent\">_app.tsx</span><small class=\"diagram-muted\">تخطيط بلا مسار · غلاف دائم + شريط الوكيل</small><div class=\"diagram-outlet\" data-rough><small class=\"diagram-muted\">&lt;Outlet/&gt; — the matched page</small><div class=\"diagram-row\"><span class=\"diagram-pill\">_index.tsx &rarr; /</span><span class=\"diagram-pill\">settings.tsx &rarr; /settings</span><span class=\"diagram-pill\">inbox.$threadId.tsx &rarr; /inbox/:threadId</span></div></div></div></div>",
-"css": ".diagram-layout .diagram-shell{display:flex;flex-direction:column;gap:8px;padding:16px}.diagram-layout .diagram-outlet{display:flex;flex-direction:column;gap:8px;padding:14px;margin-top:6px}.diagram-layout .diagram-row{display:flex;flex-wrap:wrap;gap:8px;margin-top:4px}"
-}
+<Diagram id="doc-block-2d9jmv" title={"تخطيط بلا مسار يلتف الصفحات"} summary={"يعرض تخطيط _app.tsx (لا يوجد مقطع URL) الصدفة المشتركة مرة واحدة؛ يتم عرض الصفحات المطابقة داخل <Outlet/> الخاص بها، لذلك لا يتم إعادة تحميل الشريط الجانبي للوكيل أبدًا أثناء التنقل."}>
+
+```html
+<div class="diagram-layout" data-rough>
+  <div class="diagram-shell">
+    <span class="diagram-pill accent">_app.tsx</span
+    ><small class="diagram-muted"
+      >تخطيط بلا مسار · غلاف دائم + شريط الوكيل</small
+    >
+    <div class="diagram-outlet" data-rough>
+      <small class="diagram-muted">&lt;Outlet/&gt; — the matched page</small>
+      <div class="diagram-row">
+        <span class="diagram-pill">_index.tsx &rarr; /</span
+        ><span class="diagram-pill">settings.tsx &rarr; /settings</span
+        ><span class="diagram-pill"
+          >inbox.$threadId.tsx &rarr; /inbox/:threadId</span
+        >
+      </div>
+    </div>
+  </div>
+</div>
+```
 
+```css
+.diagram-layout .diagram-shell {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 16px;
+}
+.diagram-layout .diagram-outlet {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  margin-top: 6px;
+}
+.diagram-layout .diagram-row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-top: 4px;
+}
 ```
 
+</Diagram>
+
 ## إضافة صفحة جديدة {#adding-a-page}
 
 قم بإنشاء الملف وتصدير المكون الافتراضي:

package/corpus/core/docs/content/locales/ar-SA/sandbox-adapters.mdx

@@ -40,13 +40,52 @@ search: "المحولات، محول وضع الحماية، محول cli، رم
 
 يعني إبقاء العقد محدودًا أن المحول البعيد يرث نفس الوضع الأمني. تحافظ العملية الأصلية على ملكية كل شيء يحمل سرًا: فهي تبني وحدة وضع الحماية، وتدير جسر المضيف المحلي (الذي يحتفظ بسياق الطلب ويطبق قوائم المضيف المسموح بها + حراس SSRF)، وينظف البيئة، وينسق المخرجات. يتلقى المحول فقط مصدر وحدة **غير سري** تم إعداده بالفعل بالإضافة إلى حدود الموارد — فهو مسؤول فقط عن تشغيله والتقاط حالة stdout/stderr/exit.
 
-```an-diagram title="يحتفظ الوالد بالأسرار؛ يقوم المحول بتشغيل التعليمات البرمجية فقط" summary="يقوم رمز التشغيل ببناء الوحدة وتشغيل جسر الاسترجاع؛ يتلقى المحول وحدة غير سرية + حدود ويعيد stdout/stderr/exit."
-{
-  "html": "<div class=\"diagram-sandbox\"><div class=\"diagram-box\" data-rough><strong>العملية الأم</strong><small class=\"diagram-muted\">يبني الوحدة · جسر loopback · تنظيف البيئة · تنسيق الإخراج</small></div><div class=\"diagram-col\"><div class=\"diagram-pill accent\">non-secret module + limits &rarr;</div><div class=\"diagram-pill ok\">&larr; stdout / stderr / exitCode</div><div class=\"diagram-pill\">&harr; bridge calls (127.0.0.1)</div></div><div class=\"diagram-panel center\" data-rough><strong>SandboxAdapter.run</strong><small class=\"diagram-muted\">عملية فرعية محلية · Docker · بعيد · دائم</small></div></div>",
-  "css": ".diagram-sandbox{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-sandbox .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-sandbox .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+<Diagram id="doc-block-1pjn3nu" title={"يحتفظ الوالد بالأسرار؛ يقوم المحول بتشغيل التعليمات البرمجية فقط"} summary={"يقوم رمز التشغيل ببناء الوحدة وتشغيل جسر الاسترجاع؛ يتلقى المحول وحدة غير سرية + حدود ويعيد stdout/stderr/exit."}>
+
+```html
+<div class="diagram-sandbox">
+  <div class="diagram-box" data-rough>
+    <strong>العملية الأم</strong
+    ><small class="diagram-muted"
+      >يبني الوحدة · جسر loopback · تنظيف البيئة · تنسيق الإخراج</small
+    >
+  </div>
+  <div class="diagram-col">
+    <div class="diagram-pill accent">non-secret module + limits &rarr;</div>
+    <div class="diagram-pill ok">&larr; stdout / stderr / exitCode</div>
+    <div class="diagram-pill">&harr; bridge calls (127.0.0.1)</div>
+  </div>
+  <div class="diagram-panel center" data-rough>
+    <strong>SandboxAdapter.run</strong
+    ><small class="diagram-muted"
+      >عملية فرعية محلية · Docker · بعيد · دائم</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-sandbox {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-sandbox .diagram-col {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.diagram-sandbox .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
 }
 ```
 
+</Diagram>
+
 ## الواجهة {#interface}
 
 يعيش خط التماس في قلب `packages/core/src/coding-tools/sandbox/` — `adapter.ts` (العقد)، `index.ts` (التحديد: `getSandboxAdapter()` / `registerSandboxAdapter()`)، و`local-child-process-adapter.ts` (الافتراضي). يتم توصيله داخل العبوة بواسطة `run-code.ts`؛ يقوم المضيف بتوصيل واجهة خلفية مختلفة من خلال مساعد التسجيل `index.ts` (أو، بالنسبة لواجهة Docker الخلفية, عبر [blueprint](/docs/blueprint-installer) الذي يحرر هذه الملفات مباشرة).

package/corpus/core/docs/content/locales/ar-SA/security.mdx

@@ -9,13 +9,45 @@ description: "نموذج الأمان لتطبيقات الوكيل الأصلي
 
 ## ما تحصل عليه مجانًا، وما تملكه {#what-you-own}
 
-```an-diagram title="الدفاع في طبقات" summary="يمتلك الإطار معظم سطح التهديد؛ أنت تمتلك شيئين - وضع علامات على الجداول لتحديد نطاق المدخلات الخارجية والتحقق من صحتها."
-{
-  "html": "<div class=\"sec-layers\"><div class=\"diagram-card free\"><span class=\"diagram-pill ok\">يمتلكه الإطار</span><small class=\"diagram-muted\">SQL isolation &middot; parameterized queries &middot; XSS escaping &middot; auth guard &middot; CSRF cookies &middot; secret encryption</small></div><div class=\"diagram-card you\"><span class=\"diagram-pill warn\">أنت تملك التحكم</span><small class=\"diagram-muted\">A. tag tables with ownableColumns() &amp; route through access guards<br>B. give every action a Zod schema &amp; send user URLs through the SSRF guard</small></div></div>",
-  "css": ".sec-layers{display:flex;flex-direction:column;gap:12px}.sec-layers .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px}"
+<Diagram id="doc-block-3en0hq" title={"الدفاع في طبقات"} summary={"يمتلك الإطار معظم سطح التهديد؛ أنت تمتلك شيئين - وضع علامات على الجداول لتحديد نطاق المدخلات الخارجية والتحقق من صحتها."}>
+
+```html
+<div class="sec-layers">
+  <div class="diagram-card free">
+    <span class="diagram-pill ok">يمتلكه الإطار</span
+    ><small class="diagram-muted"
+      >SQL isolation &middot; parameterized queries &middot; XSS escaping
+      &middot; auth guard &middot; CSRF cookies &middot; secret
+      encryption</small
+    >
+  </div>
+  <div class="diagram-card you">
+    <span class="diagram-pill warn">أنت تملك التحكم</span
+    ><small class="diagram-muted"
+      >A. tag tables with ownableColumns() &amp; route through access guards<br />B.
+      give every action a Zod schema &amp; send user URLs through the SSRF
+      guard</small
+    >
+  </div>
+</div>
+```
+
+```css
+.sec-layers {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.sec-layers .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 14px 16px;
 }
 ```
 
+</Diagram>
+
 عند البناء على الأنماط القياسية، يتعامل إطار العمل بالفعل مع معظم سطح التهديد نيابةً عنك:
 
 - **عزل البيانات** — تتم إعادة كتابة الوكيل SQL بحيث يمكنه فقط رؤية صفوف المستخدم الحالي (والمؤسسة النشطة). انظر [Data Scoping](#data-scoping).
@@ -122,13 +154,53 @@ const res = await ssrfSafeFetch(userProvidedUrl, {}, { maxRedirects: 3 });
 session.orgId → AGENT_ORG_ID → SQL row scoping
 ```
 
-```an-diagram title="خط أنابيب النطاق" summary="لا يلمس الوكيل SQL الجداول الأساسية مباشرة أبدًا - فهو يقرأ من خلال عرض مؤقت محدد للهوية الحالية، لذلك يمكن لاسم الجدول المجرد إرجاع الصفوف المملوكة فقط."
-{
-  "html": "<div class=\"scope-pipe\"><div class=\"diagram-node\">جلسة مسجلة الدخول<br><small class=\"diagram-muted\">email &middot; orgId</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Request context<br><small class=\"diagram-muted\">AGENT_ORG_ID</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Temporary VIEW<br><small class=\"diagram-muted\">WHERE owner_email = ? AND org_id = ?</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node ok\">SQL الوكيل<br><small class=\"diagram-muted\">bare table names only</small></div></div>",
-  "css": ".scope-pipe{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.scope-pipe .diagram-node{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.scope-pipe .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-u1dtvr" title={"خط أنابيب النطاق"} summary={"لا يلمس الوكيل SQL الجداول الأساسية مباشرة أبدًا - فهو يقرأ من خلال عرض مؤقت محدد للهوية الحالية، لذلك يمكن لاسم الجدول المجرد إرجاع الصفوف المملوكة فقط."}>
+
+```html
+<div class="scope-pipe">
+  <div class="diagram-node">
+    جلسة مسجلة الدخول<br /><small class="diagram-muted"
+      >email &middot; orgId</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node">
+    Request context<br /><small class="diagram-muted">AGENT_ORG_ID</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box">
+    Temporary VIEW<br /><small class="diagram-muted"
+      >WHERE owner_email = ? AND org_id = ?</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node ok">
+    SQL الوكيل<br /><small class="diagram-muted">bare table names only</small>
+  </div>
+</div>
+```
+
+```css
+.scope-pipe {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.scope-pipe .diagram-node {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 10px 14px;
+}
+.scope-pipe .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 تحمل جلسة تسجيل الدخول `email` و(عندما تكون المؤسسة نشطة) `orgId`. ينشئ إطار العمل سياق الطلب من تلك الجلسة، ويكشف المؤسسة النشطة للوكيل SQL باسم `AGENT_ORG_ID`، ويعيد كتابة كل استعلام حتى يتمكن فقط من رؤية الصفوف التي تمتلكها الهوية الحالية. ينطبق نفس المسار سواء كان الاستعلام يأتي من UI أو إجراء أو وكيل — لا يمكن للوكيل قراءة البيانات الخاصة بمؤسسة ليس المستخدم عضوًا فيها.
 
 ### تحديد النطاق لكل مستخدم (`owner_email`)