@agent-native/core 0.77.3 → 0.77.4

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

@@ -13,7 +13,7 @@ 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 · email · Telegram · WhatsApp · MCP</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel dsp-control\" data-rough><span class=\"diagram-pill accent\">Dispatch &mdash; control plane</span><div class=\"dsp-caps\"><span class=\"diagram-pill\">Central inbox</span><span class=\"diagram-pill\">Secret vault</span><span class=\"diagram-pill\">Cross-app delegation</span><span class=\"diagram-pill\">MCP gateway</span><span class=\"diagram-pill\">Workspace resources</span></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"dsp-peers\"><div class=\"diagram-box\" data-rough>Mail</div><div class=\"diagram-box\" data-rough>Calendar</div><div class=\"diagram-box\" data-rough>Analytics</div></div><small class=\"diagram-muted\">domain apps &mdash; A2A peers</small></div>",
+  "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}"
 }
 ```
@@ -66,7 +66,7 @@ Dispatch هو التطبيق المركزي الذي يقع أمام كل تطب
 {
   "method": "POST",
   "path": "/_agent-native/mcp",
-  "summary": "Unified MCP gateway endpoint",
+  "summary": "نقطة نهاية البوابة الموحدة MCP",
   "description": "The single MCP connector URL external agents add (e.g. `https://dispatch.agent-native.com/_agent-native/mcp`). One authorization here reaches every **granted** workspace app instead of wiring one connector per app. App grants, OAuth, and inline MCP App previews are covered in [External Agents](/docs/external-agents).",
   "auth": "Standard remote MCP OAuth, handled by the framework. The granted-app set scopes which workspace apps the connector can reach.",
   "responses": [
@@ -112,7 +112,7 @@ Dispatch هو التطبيق المركزي الذي يقع أمام كل تطب
 
 ```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 DM<br><small class=\"diagram-muted\">\"summarize last week's signups\"</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><strong>/slack/webhook</strong><br><small class=\"diagram-muted\">verify + INSERT pending task</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">200</div></div><div class=\"dsp-row\"><div class=\"diagram-box\" data-rough><strong>fresh processor</strong><br><small class=\"diagram-muted\">claim task · start agent loop</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">Dispatch agent decides</span><small class=\"diagram-muted\">analytics intent &rarr; call-agent</small></div></div><div class=\"dsp-row\"><div class=\"diagram-box\" data-rough>Analytics app<br><small class=\"diagram-muted\">A2A peer · runs the SQL work</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">reply posted in thread</div></div><div class=\"diagram-panel dsp-retry\" data-rough><span class=\"diagram-pill warn\">recovery</span> <span class=\"diagram-muted\">if the processor crashes &mdash; A2A timeout, downstream error, freeze &mdash; the 60s retry job re-fires it (&le;3 attempts) so the Slack reply still arrives</span> <span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</span></div></div>",
+  "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}"
 }
 ```

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

@@ -29,7 +29,7 @@ description: "قم بتثبيت دردشة الوكيل + مساحة العمل
 
 ```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\">Your app<br><small class=\"diagram-muted\">children: header + &lt;Outlet/&gt;</small></div><div class=\"diagram-node panel\">Agent panel<br><small class=\"diagram-muted\">chat &middot; CLI &middot; workspace</small></div></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-card alt\"><span class=\"diagram-pill\">&lt;AgentPanel&gt;</span><small class=\"diagram-muted\">same panel, no wrapper &mdash; you own the layout</small></div></div>",
+  "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}"
 }
 ```
@@ -44,13 +44,13 @@ description: "قم بتثبيت دردشة الوكيل + مساحة العمل
 {
   "filename": "app/root.tsx",
   "language": "tsx",
-  "code": "import { Outlet } from \"react-router\";\nimport { AgentSidebar, AgentToggleButton } from \"@agent-native/core/client\";\n\nexport default function Root() {\n  return (\n    <AgentSidebar\n      emptyStateText=\"How can I help?\"\n      suggestions={[\n        \"Summarize my inbox\",\n        \"Draft a reply to the latest email\",\n        \"Show me yesterday's signup numbers\",\n      ]}\n      dynamicSuggestions\n      defaultSidebarWidth={420}\n      position=\"right\"\n    >\n      <header>\n        <AgentToggleButton />\n      </header>\n\n      <main>\n        <Outlet />\n      </main>\n    </AgentSidebar>\n  );\n}",
+  "code": "import { Outlet } from \"react-router\";\nimport { AgentSidebar, AgentToggleButton } from \"@agent-native/core/client\";\n\nexport default function Root() {\n  return (\n    <AgentSidebar\n      emptyStateText=\"كيف يمكنني المساعدة؟\"\n      suggestions={[\n        \"Summarize my inbox\",\n        \"Draft a reply to the latest email\",\n        \"Show me yesterday's signup numbers\",\n      ]}\n      dynamicSuggestions\n      defaultSidebarWidth={420}\n      position=\"right\"\n    >\n      <header>\n        <AgentToggleButton />\n      </header>\n\n      <main>\n        <Outlet />\n      </main>\n    </AgentSidebar>\n  );\n}",
   "annotations": [
-    { "lines": "6", "label": "Wrapper", "note": "`<AgentSidebar>` wraps your whole layout. It adds the toggleable side panel; everything you pass as children stays in the main app area." },
-    { "lines": "8-12", "label": "Starter prompts", "note": "`suggestions` render as clickable chips on the empty chat." },
-    { "lines": "13", "label": "Context-aware chips", "note": "`dynamicSuggestions` merges screen-aware prompts (e.g. \"Summarize this selection\") with your static ones. On by default." },
-    { "lines": "18-20", "label": "Toggle button", "note": "Put `<AgentToggleButton />` anywhere in your header to open and close the panel." },
-    { "lines": "22-24", "label": "Your app", "note": "`<Outlet/>` (your routes) renders in the main area, untouched." }
+    { "lines": "6", "label": "المجمع", "note": "`<AgentSidebar>` wraps your whole layout. It adds the toggleable side panel; everything you pass as children stays in the main app area." },
+    { "lines": "8-12", "label": "يبدأ تشغيل المطالبات", "note": "يتم عرض `suggestions` كشرائح قابلة للنقر في الدردشة الفارغة." },
+    { "lines": "13", "label": "شرائح تدرك السياق", "note": "`dynamicSuggestions` merges screen-aware prompts (e.g. \"Summarize this selection\") with your static ones. On by default." },
+    { "lines": "18-20", "label": "زر التبديل", "note": "Put `<AgentToggleButton />` anywhere in your header to open and close the panel." },
+    { "lines": "22-24", "label": "تطبيقك", "note": "`<Outlet/>` (your routes) renders in the main area, untouched." }
   ]
 }
 ```
@@ -174,7 +174,7 @@ const { send, isGenerating } = useSendToAgentChat();
   `<AssistantChat runtime={...} />`. الموصلات
   (`createHttpAgentChatRuntime()` وOpenAI / Claude / Vercel AI / AG-UI
   المساعدون) وعقد الحدث موثق في
-  [Native Chat UI — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes).
+  [Native واجهة الدردشة — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes).
 
 أيًا كانت الطبقة التي تختارها، احتفظ بحالة التطبيق المدعومة بـ actions وSQL كعقد،
 وتجنب النشر مباشرة إلى `/_agent-native/agent-chat` من المنتج UI. إذا كان

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

@@ -15,7 +15,7 @@ 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\">Layer 2 · hard-block re-dispatched write</div></div></div>",
+  "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}"
 }
 ```

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

@@ -13,7 +13,7 @@ description: "قم بتضمين ملف جانبي Agent-Native في تطبيق S
 
 ```an-diagram title="غشاء التضمين" summary="يوفر التطبيق المضيف مصادقة من جانب الخادم وسياق الصفحة المباشرة؛ يقوم Agent-Native بتشغيل السيارة الجانبية المتينة ويصل إلى علامة التبويب المفتوحة من خلال إجراءات العميل وأوامر المضيف."
 {
-  "html": "<div class=\"diagram-embed\"><div class=\"diagram-box\" data-rough><strong>Host SaaS app</strong><small class=\"diagram-muted\">your UI, your auth</small></div><div class=\"diagram-col\"><div class=\"diagram-pill accent\">getContext &rarr;</div><div class=\"diagram-pill\">&larr; client actions</div><div class=\"diagram-pill\">&larr; host commands</div></div><div class=\"diagram-panel center\" data-rough><strong>Agent-Native sidecar</strong><small class=\"diagram-muted\">durable chat · app state · extensions</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\">framework tables</small></div></div>",
+  "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}"
 }
 ```
@@ -375,7 +375,7 @@ const hostTools = createAgentNativeHostTools({
 
 ```an-diagram title="جسر جلسة المتصفح بوساطة الخادم" summary="أداة الواجهة الخلفية تحجز العمل؛ تطالب علامة التبويب المسجلة بها، وتقوم بتشغيلها على الصفحة المباشرة، وتعود النتيجة إلى الوكيل - لذلك لا يزال بإمكان وكيل backend/Slack/A2A لمس علامة التبويب المفتوحة."
 {
-  "html": "<div class=\"diagram-bridge\"><div class=\"diagram-node\" data-rough>Backend agent<br><small class=\"diagram-muted\">chat · 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>Live tab claims it<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>",
+  "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}"
 }
 ```

package/docs/content/locales/ar-SA/evals.md

@@ -16,7 +16,7 @@ description: "اكتب حالات اختبار *.eval.ts التي تقوم بت
 
 ```an-diagram title="من المدخلات الثابتة لنشر البوابة" summary="يقوم العداء فعليًا بتشغيل حلقة الوكيل في كل حالة، ويسجل المخرجات، ويخرج من الصفر إذا انخفض أي مسجل عن العتبة - مما يجعله بوابة CI قابلة للإسقاط."
 {
-  "html": "<div class=\"eval-flow\"><div class=\"diagram-node\">*.eval.ts<br><small class=\"diagram-muted\">prompt + expected behavior</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Run the agent loop<br><small class=\"diagram-muted\">real engine/model</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Scorers<br><small class=\"diagram-muted\">every one must pass threshold</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box ok\">exit 0 &rarr; deploy</div><div class=\"diagram-box warn\">exit 1 &rarr; block</div></div></div>",
+  "html": "<div class=\"eval-flow\"><div class=\"diagram-node\">*.eval.ts<br><small class=\"diagram-muted\">prompt + expected behavior</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">تشغيل حلقة الوكيل<br><small class=\"diagram-muted\">real engine/model</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Scorers<br><small class=\"diagram-muted\">every one must pass threshold</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box ok\">exit 0 &rarr; deploy</div><div class=\"diagram-box warn\">exit 1 &rarr; block</div></div></div>",
   "css": ".eval-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.eval-flow .diagram-node{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.eval-flow .diagram-col{display:flex;flex-direction:column;gap:8px}.eval-flow .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -69,7 +69,7 @@ interface AgentRunOutput {
 
 | هداف                     | النتيجة                                                              | النموذج؟ |
 | ------------------------ | -------------------------------------------------------------------- | -------- |
-| `exactMatch(expected)`   | `1.0` إذا كان النص يساوي `expected` (مقتطع، غير حساس لحالة الأحرف)   | لا       |
+| `exactMatch(expected)`   | `1.0` إذا كان النص يساوي `expected` (مقتطع, غير حساس لحالة الأحرف)   | لا       |
 | `contains(needles)`      | جزء من السلاسل الفرعية المطلوبة موجودة (لذلك تظهر النتائج الجزئية)   | لا       |
 | `usesTool(toolName)`     | `1.0` إذا قام الوكيل باستدعاء تلك الأداة/الإجراء مرة واحدة على الأقل | لا       |
 | `llmJudge({ criteria })` | سجل LLM كحكم مقابل قواعد تقييم اللغة الطبيعية، → `0..1`              | نعم      |
@@ -122,7 +122,7 @@ const concise = createScorer({
 
 ```bash
 agent-native eval                    # run every *.eval.ts; non-zero exit on failure
-agent-native eval billing            # only files whose path contains "billing"
+agent-native eval billing            # فقط الملفات التي يحتوي مسارها على "billing"
 agent-native eval --json             # machine-readable report (for CI)
 agent-native eval --threshold 0.8    # override every eval's pass threshold (0..1)
 ```

package/docs/content/locales/ar-SA/extensions.md

@@ -24,7 +24,7 @@ description: "التطبيقات المصغرة التي ينشئها المست
 
 ```an-diagram title="جسر الرمل" summary="يعمل الامتداد HTML في إطار iframe معزول ولا يصل إلى المضيف إلا من خلال مجموعة ثابتة من مساعدي الجسر - يتم تحديد نطاق كل مكالمة والتحقق من الوصول إليها."
 {
-  "html": "<div class=\"ext-bridge\"><div class=\"diagram-card sandbox\" data-rough><span class=\"diagram-pill warn\">Sandboxed iframe</span><small class=\"diagram-muted\">Alpine.js HTML &middot; no host cookies, session, or DOM</small><div class=\"ext-helpers\"><span class=\"diagram-pill\">appAction</span><span class=\"diagram-pill\">appFetch</span><span class=\"diagram-pill\">dbQuery / dbExec</span><span class=\"diagram-pill\">extensionData</span><span class=\"diagram-pill\">extensionFetch</span></div></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Host template<br><small class=\"diagram-muted\">actions, auto-scoped SQL</small></div><div class=\"diagram-box\">Secret proxy<br><small class=\"diagram-muted\"><code>${keys.NAME}</code>, domain-locked</small></div><div class=\"diagram-box\">External APIs<br><small class=\"diagram-muted\">via extensionFetch only</small></div></div></div>",
+  "html": "<div class=\"ext-bridge\"><div class=\"diagram-card sandbox\" data-rough><span class=\"diagram-pill warn\">Sandboxed iframe</span><small class=\"diagram-muted\">Alpine.js HTML &middot; no host cookies, session, or DOM</small><div class=\"ext-helpers\"><span class=\"diagram-pill\">appAction</span><span class=\"diagram-pill\">appFetch</span><span class=\"diagram-pill\">dbQuery / dbExec</span><span class=\"diagram-pill\">extensionData</span><span class=\"diagram-pill\">extensionFetch</span></div></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">قالب المضيف<br><small class=\"diagram-muted\">إجراءات، SQL محدد النطاق تلقائيا</small></div><div class=\"diagram-box\">Secret proxy<br><small class=\"diagram-muted\"><code>${keys.NAME}</code>، مقفل بالنطاق</small></div><div class=\"diagram-box\">واجهات API خارجية<br><small class=\"diagram-muted\">عبر extensionFetch فقط</small></div></div></div>",
   "css": ".ext-bridge{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.ext-bridge .sandbox{display:flex;flex-direction:column;gap:8px;padding:16px 18px;flex:1;min-width:240px}.ext-bridge .ext-helpers{display:flex;flex-wrap:wrap;gap:6px;margin-top:4px}.ext-bridge .diagram-col{display:flex;flex-direction:column;gap:8px}.ext-bridge .diagram-arrow{font-size:24px}"
 }
 ```
@@ -222,7 +222,7 @@ description: "التطبيقات المصغرة التي ينشئها المست
 
 ```an-diagram title="فتحات تدفع السياق إلى القطعة" summary="يمتلك القالب المضيف فتحات مسماة؛ يؤدي تثبيت الامتداد إلى تغذيته window.slotContext لكل ما يشاهده المستخدم حاليًا."
 {
-"html": "<div class=\"slot\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Mail thread</span><small class=\"diagram-muted\">slot <code>mail.contact-sidebar.bottom</code></small></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box accent\"><code>window.slotContext</code><br><small class=\"diagram-muted\">{ contactEmail }</small></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">Contact notes</span><small class=\"diagram-muted\">loads notes for that contact &mdash; same widget, different context</small></div></div>",
+"html": "<div class=\"slot\"><div class=\"diagram-card\"><span class=\"diagram-pill\">سلسلة بريد</span><small class=\"diagram-muted\">slot <code>mail.contact-sidebar.bottom</code></small></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box accent\"><code>window.slotContext</code><br><small class=\"diagram-muted\">{ contactEmail }</small></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">ملاحظات جهة الاتصال</span><small class=\"diagram-muted\">loads notes for that contact &mdash; same widget, different context</small></div></div>",
 "css": ".slot{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.slot .diagram-card{display:flex;flex-direction:column;gap:4px;padding:14px 16px;min-width:180px}.slot .diagram-arrow{font-size:22px}"
 }
 

package/docs/content/locales/ar-SA/external-agents.md

@@ -21,7 +21,7 @@ search: "Claude ChatGPT Claude الكود Codex المؤشر Claude Cowork MCP
 
 ```an-diagram title="رحلة ذهابًا وإيابًا للوكيل الخارجي" summary="يقوم مضيف خارجي باستدعاء أداة عبر MCP؛ يقوم التطبيق بإرجاع قطعة أثرية بالإضافة إلى رابط مفتوح. يؤدي النقر فوقه إلى حل جلسة المتصفح وتركيز العنصر في واجهة المستخدم قيد التشغيل - لا يحمل الرابط أي حالة مميزة."
 {
-  "html": "<div class=\"xa-trip\"><div class=\"diagram-box\" data-rough>External host<br><small class=\"diagram-muted\">Claude &middot; ChatGPT &middot; Codex &middot; Cursor</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\">MCP tool call</span><small class=\"diagram-muted\">e.g. <code>manage-draft</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>App produces artifact<br><small class=\"diagram-muted\">+ <code>Open in &lt;app&gt; &rarr;</code> deep link / MCP App</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>User clicks link</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill ok\"><code>/_agent-native/open</code></span><small class=\"diagram-muted\">resolves the <strong>browser</strong> session</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Writes <code>navigate</code> app-state<br><small class=\"diagram-muted\">UI focuses the artifact</small></div></div>",
+  "html": "<div class=\"xa-trip\"><div class=\"diagram-box\" data-rough>مضيف خارجي<br><small class=\"diagram-muted\">Claude &middot; ChatGPT &middot; Codex &middot; Cursor</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\">أداة MCP call</span><small class=\"diagram-muted\">e.g. <code>manage-draft</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>ينتج التطبيق أثرًا<br><small class=\"diagram-muted\">+ <code>Open in &lt;app&gt; &rarr;</code> deep link / MCP App</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><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 ok\"><code>/_agent-native/open</code></span><small class=\"diagram-muted\">resolves the <strong>browser</strong> session</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Writes <code>navigate</code> app-state<br><small class=\"diagram-muted\">تركز الواجهة على الأثر</small></div></div>",
   "css": ".xa-trip{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.xa-trip .center{display:flex;flex-direction:column;align-items:center;gap:4px}.xa-trip .diagram-arrow{font-size:22px;line-height:1}.xa-trip code{font-size:.85em}"
 }
 ```
@@ -31,7 +31,7 @@ search: "Claude ChatGPT Claude الكود Codex المؤشر Claude Cowork MCP
 ## ما هو مسار الوكيل الذي تحتاجه؟ {#which-agent-path}
 
 - **مضيف MCP الخارجي:** استخدم هذه الصفحة عندما يقوم Claude أو ChatGPT أو Codex أو Cursor أو OpenCode أو GitHub Copilot / VS Code أو مضيف آخر متوافق مع MCP باستدعاء التطبيق الأصلي للوكيل المستضاف.
-- **وقت التشغيل الخاص بك خلف دردشة Agent-Native:** راجع [Agent Surfaces](/docs/agent-surfaces#byo-agent) و[Native Chat UI](/docs/native-chat-ui#byo-agent-runtimes) عندما يقوم وكيل تم إنشاؤه باستخدام إطار عمل آخر بتشغيل `<AssistantChat runtime={...}>`.
+- **وقت التشغيل الخاص بك خلف دردشة Agent-Native:** راجع [Agent Surfaces](/docs/agent-surfaces#byo-agent) و[Native واجهة الدردشة](/docs/native-chat-ui#byo-agent-runtimes) عندما يقوم وكيل تم إنشاؤه باستخدام إطار عمل آخر بتشغيل `<AssistantChat runtime={...}>`.
 - **تطبيقك الذي يستهلك أدوات MCP:** راجع [MCP Clients](/docs/mcp-clients) عندما يحتاج تطبيق وكيل أصلي إلى استدعاء الأدوات التي كشفها خادم MCP آخر.
 - **تطبيق أو وكيل آخر عبر A2A:** استخدم [Agent Mentions](/docs/agent-mentions) و[A2A](/docs/a2a-protocol) عندما يتعين على التطبيقات الأصلية للوكيل اكتشاف وتفويض بعضها البعض.
 - **الوكلاء الفرعيون المحليون المخصصون:** استخدم [Workspace](/docs/workspace) عندما تريد ملفات تعريف الوكيل المخصصة داخل مساحة العمل الأصلية للوكيل نفسها.
@@ -249,7 +249,7 @@ https://dispatch.agent-native.com/_agent-native/mcp
 
 ```an-diagram title="مستويين من الكتالوج" summary="يحصل كل متصل على المستوى المدمج بشكل افتراضي؛ سطح الأداة الكامل ~ 105 قابل للاشتراك فقط. يعمل البحث عن الأدوات على سد الفجوة بحيث لا يتم إخفاء أي شيء على الإطلاق."
 {
-  "html": "<div class=\"xa-tiers\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill ok\">Compact / connector tier &middot; default</span><strong>~20&ndash;30 tools</strong><small class=\"diagram-muted\">Template-declared app actions + cross-app builtins (<code>list_apps</code>, <code>open_app</code>, <code>ask_app</code>, <code>create_embed_session</code>) + always-present <code>tool-search</code>.</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">Full tier &middot; opt-in</span><strong>~105 tools</strong><small class=\"diagram-muted\">Explicit opt-in only: <code>--full-catalog</code> token or <code>AGENT_NATIVE_MCP_FULL_CATALOG=1</code>.</small></div></div><p class=\"diagram-muted note\"><code>tool-search</code> reaches any full-tier tool on demand &mdash; so the compact default keeps context small without hiding capability.</p>",
+  "html": "<div class=\"xa-tiers\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill ok\">Compact / connector tier &middot; default</span><strong>~20&ndash;30 tools</strong><small class=\"diagram-muted\">Template-declared app actions + cross-app builtins (<code>list_apps</code>, <code>open_app</code>, <code>ask_app</code>, <code>create_embed_session</code>) + always-present <code>tool-search</code>.</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">Full tier &middot; opt-in</span><strong>~105 أداة</strong><small class=\"diagram-muted\">Explicit opt-in only: <code>--full-catalog</code> token or <code>AGENT_NATIVE_MCP_FULL_CATALOG=1</code>.</small></div></div><p class=\"diagram-muted note\"><code>tool-search</code> reaches any full-tier tool on demand &mdash; so the compact default keeps context small without hiding capability.</p>",
   "css": ".xa-tiers{display:flex;align-items:stretch;gap:14px;flex-wrap:wrap}.xa-tiers .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;flex:1;min-width:240px}.xa-tiers .diagram-arrow{align-self:center;font-size:24px;line-height:1}.xa-tiers .note{flex-basis:100%;margin:4px 0 0;font-size:.85em}.xa-tiers code{font-size:.85em}"
 }
 ```
@@ -348,7 +348,7 @@ Claude Code calls: manage-draft(to: "john@example.com", subject: "Q3 Report", bo
 
 ### جسر تطبيقات MCP من الدرجة الأولى {#mcp-app-bridge}
 
-يبدأ `embedApp()` من هدف `link` للإجراء، وينشئ جلسة تضمين قصيرة الأجل، ويطلق مسار التطبيق الموقع. تستخدم شبكة Claude مسار زرع أحادي الإطار؛ يحصل ChatGPT على إطار iframe للمسار يتم التحكم فيه باستخدام مضيف `window.openai` APIs. تعرض كافة المسارات مسار React العادي. تستدعي المسارات المائية مباشرة `ui/update-model-context` و`ui/message` و`ui/open-link` و`ui/request-display-mode` عبر الجسر المضيف؛ يقوم مسار ChatGPT بترحيل نفس الطلبات عبر `agentNative.mcpHost.*` postMessage. `embedApp({ height })` الافتراضي هو `560px` ويتم تثبيته على `320-900px`.
+يبدأ `embedApp()` من هدف `link` للإجراء، وينشئ جلسة تضمين قصيرة الأجل, ويطلق مسار التطبيق الموقع. تستخدم شبكة Claude مسار زرع أحادي الإطار؛ يحصل ChatGPT على إطار iframe للمسار يتم التحكم فيه باستخدام مضيف `window.openai` APIs. تعرض كافة المسارات مسار React العادي. تستدعي المسارات المائية مباشرة `ui/update-model-context` و`ui/message` و`ui/open-link` و`ui/request-display-mode` عبر الجسر المضيف؛ يقوم مسار ChatGPT بترحيل نفس الطلبات عبر `agentNative.mcpHost.*` postMessage. `embedApp({ height })` الافتراضي هو `560px` ويتم تثبيته على `320-900px`.
 
 راجع [MCP Apps](/docs/mcp-apps) للحصول على تفاصيل الجسر الكاملة - الزرع مقابل الإطار المتحكم فيه، وأوضاع التضمين، وجداول `ui/*` وpostMessage، وقواعد `embedStartUrl`، وقواعد CSP، وتضمين الامتداد `srcDoc`، وتثبيت الارتفاع، وعميل الجسر المضيف الكامل API.
 
@@ -400,7 +400,7 @@ function composeDeepLink(draft: Record<string, string>): string {
   return buildDeepLink({
     app: "mail",
     view: "inbox",
-    compose: encodeComposeDraft(draft), // base64url JSON → compose-<id> draft
+    compose: encodeComposerDraft(draft), // base64url JSON → compose-<id> draft
   });
 }
 
@@ -424,7 +424,7 @@ export default defineAction({
 
 ### تطبيقات MCP الاختيارية UI {#mcp-apps}
 
-يمكن لـ Actions الإعلان عن مورد UI المضمّن باستخدام `mcpApp` للمضيفين الذين يدعمون ملحق MCP Apps. استخدم `embedRoute({ title, openLabel, path })` كغلاف ملائم، أو قم بتعيين `embedApp(...)` إلى `mcpApp.resource` مباشرة. كل تطبيق MCP هو طريق React حقيقي، وليس عنصر واجهة مستخدم عادي منفصل HTML. احتفظ دائمًا بمنشئ `link` - يستخدمه مضيفو CLI فقط، والعملاء الأقدم، والمضيفون من غير MCP-Apps كبديل.
+يمكن لـ Actions الإعلان عن مورد UI المضمّن باستخدام `mcpApp` للمضيفين الذين يدعمون ملحق MCP Apps. استخدم `embedRoute({ title, openLabel, path })` كغلاف ملائم, أو قم بتعيين `embedApp(...)` إلى `mcpApp.resource` مباشرة. كل تطبيق MCP هو طريق React حقيقي، وليس عنصر واجهة مستخدم عادي منفصل HTML. احتفظ دائمًا بمنشئ `link` - يستخدمه مضيفو CLI فقط، والعملاء الأقدم، والمضيفون من غير MCP-Apps كبديل.
 
 راجع [MCP Apps](/docs/mcp-apps) للحصول على دليل التأليف الكامل - `embedRoute` مقابل `embedApp`، وشكل تكوين `mcpApp`، وCSP، والارتفاع، ومسار التضمين `sendToAgentChat()`، ومساعدي عميل جسر المضيف.
 
@@ -432,7 +432,7 @@ export default defineAction({
 
 إن منشئ `link` **نقي ومتزامن — لا يوجد إدخال/إخراج، ولا انتظار**. يتم تشغيله بأقصى جهد: يتم ابتلاع رمية أو `null` أو `undefined` و **مطلقًا** يفشل استدعاء الأداة. فهو يقرأ فقط `args` و`result` للمكالمة؛ يجب ألا يستعلم عن قاعدة البيانات، أو يقرأ حالة التطبيق، أو يتصل بـ actions أخرى. قم بإرجاع `null` عندما لا يكون هناك شيء لفتحه.
 
-ترجع `buildDeepLink({ app, view, params?, to?, compose? })` المسار النسبي للتطبيق `/_agent-native/open?app=…&view=…&<recordId>=…`. تحول طبقة MCP ذلك إلى شبكة مطلقة URL (`toAbsoluteOpenUrl`، باستخدام أصل الطلب)، وسطح مكتب `agentnative://open?…` URL (`toDesktopOpenUrl`)، وامتداد VS Code URL (`toVsCodeOpenUrl`) لـ `vscode://builder.agent-native/open?url=…`؛ يستخدم رابط تخفيض السعر سطح المكتب URL عندما يشير العميل إلى `target: "desktop"`.
+ترجع `buildDeepLink({ app, view, params?, to?, compose? })` المسار النسبي للتطبيق `/_agent-native/open?app=…&view=…&<recordId>=…`. تحول طبقة MCP ذلك إلى شبكة مطلقة URL (`toAbsoluteOpenUrl`، باستخدام أصل الطلب)، وسطح مكتب `agentnative://open?…` URL (`toDesktopOpenUrl`), وامتداد VS Code URL (`toVsCodeOpenUrl`) لـ `vscode://builder.agent-native/open?url=…`؛ يستخدم رابط Markdown سطح المكتب URL عندما يشير العميل إلى `target: "desktop"`.
 
 ### مسار `/_agent-native/open` {#open-route}
 
@@ -442,7 +442,7 @@ export default defineAction({
 {
   "method": "GET",
   "path": "/_agent-native/open",
-  "summary": "Deep-link open route — focuses the browser UI on a record",
+  "summary": "المسار المفتوح للارتباط العميق — يركز المتصفح UI على سجل",
   "description": "Resolves the browser session, writes a one-shot `navigate` application-state command scoped to that session, and 302-redirects to a safe same-origin path. Always build the URL with `buildDeepLink(...)`; never hand-format it. Can be disabled per app with `disableOpenRoute`.",
   "auth": "Browser session via `getSession`. The auth guard bypasses this exact path; if unauthenticated it serves login HTML at the same URL, and the form reload re-enters authenticated (no `?next=` plumbing).",
   "params": [

package/docs/content/locales/ar-SA/faq.md

@@ -30,7 +30,7 @@ Agent-native مخصص للأشخاص الذين يريدون تطبيقًا حق
 
 ```an-diagram title="الذكاء الاصطناعي المثبت مقابل agent-native" summary="يعيش الشريط الجانبي للدردشة المثبت في عالمه الخاص. يشارك وكيل agent-native نفس الإجراءات وقاعدة البيانات والحالة مثل واجهة المستخدم."
 {
-  "html": "<div class=\"diagram-vs\"><div class=\"diagram-col\"><span class=\"diagram-pill warn\">Bolted-on AI</span><div class=\"diagram-node\">Chat sidebar</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>separate AI world<br><small class=\"diagram-muted\">can't touch the app</small></div><div class=\"diagram-box diagram-muted\">App UI &amp; data</div></div><div class=\"diagram-divider\" aria-hidden=\"true\"></div><div class=\"diagram-col\"><span class=\"diagram-pill ok\">Agent-native</span><div class=\"diagram-row2\"><div class=\"diagram-node\">UI</div><div class=\"diagram-node\">Agent</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>shared actions, DB &amp; state</div></div></div>",
+  "html": "<div class=\"diagram-vs\"><div class=\"diagram-col\"><span class=\"diagram-pill warn\">ذكاء اصطناعي ملحق</span><div class=\"diagram-node\">الشريط الجانبي للدردشة</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>عالم AI منفصل<br><small class=\"diagram-muted\">لا يمكنه لمس التطبيق</small></div><div class=\"diagram-box diagram-muted\">App UI &amp; data</div></div><div class=\"diagram-divider\" aria-hidden=\"true\"></div><div class=\"diagram-col\"><span class=\"diagram-pill ok\">Agent-native</span><div class=\"diagram-row2\"><div class=\"diagram-node\">UI</div><div class=\"diagram-node\">Agent</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>shared actions, DB &amp; state</div></div></div>",
   "css": ".diagram-vs{display:flex;align-items:stretch;gap:18px;flex-wrap:wrap}.diagram-vs .diagram-col{display:flex;flex-direction:column;gap:8px;align-items:center;flex:1;min-width:200px}.diagram-vs .diagram-row2{display:flex;gap:8px}.diagram-vs .diagram-arrow{font-size:20px;line-height:1}.diagram-vs .diagram-divider{width:1px;align-self:stretch;background:currentColor;opacity:.15}"
 }
 ```
@@ -124,11 +124,11 @@ Anthropic Claude وOpenAI (عائلة GPT-5) وGoogle Gemini وأي مزود ي
 
 ### لماذا SSE بالإضافة إلى الاقتراع بدلاً من WebSockets؟ {#why-polling-not-websockets}
 
-يوفر SSE نفس العملية لكتابة مسار فوري للمتصفح، ويظل استطلاع عداد الإصدار خفيف الوزن هو البديل لأنه يعمل في كل بيئة نشر - بما في ذلك بيئة بدون خادم وبيئة الحافة، حيث قد لا تكون المقابس الدائمة متاحة. انظر [Key Concepts — Live sync](/docs/key-concepts#polling-sync).
+يوفر SSE نفس العملية لكتابة مسار فوري للمتصفح، ويظل استطلاع عداد الإصدار خفيف الوزن هو البديل لأنه يعمل في كل بيئة نشر - بما في ذلك بيئة بدون خادم وبيئة الحافة، حيث قد لا تكون المقابس الدائمة متاحة. انظر [Key Concepts — مزامنة مباشرة](/docs/key-concepts#polling-sync).
 
 ```an-diagram title="SSE أولاً، إجراء الاقتراع الاحتياطي" summary="نفس العملية تكتب الدفق على الفور؛ يحافظ استطلاع الإصدار المضاد على تقارب عمليات الكتابة بدون خادم والحواف والعمليات المشتركة."
 {
-  "html": "<div class=\"diagram-transport\"><div class=\"diagram-box\" data-rough>DB write</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">SSE<br><small class=\"diagram-muted\">/_agent-native/events &middot; instant</small></div><div class=\"diagram-node\">Poll<br><small class=\"diagram-muted\">/_agent-native/poll &middot; universal fallback</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Browser refetch</div></div>",
+  "html": "<div class=\"diagram-transport\"><div class=\"diagram-box\" data-rough>كتابة في قاعدة البيانات</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">SSE<br><small class=\"diagram-muted\">/_agent-native/events &middot; instant</small></div><div class=\"diagram-node\">استقصاء<br><small class=\"diagram-muted\">/_agent-native/poll &middot; universal fallback</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>إعادة جلب المتصفح</div></div>",
   "css": ".diagram-transport{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-transport .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-transport .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```

package/docs/content/locales/ar-SA/file-uploads.md

@@ -19,16 +19,16 @@ description: "قم بتكوين مساحة تخزين تحميل الملفات
 
 ```an-diagram title="ترتيب حل الموفر" summary="uploadFile() يختار الموفر الأول الذي تم تكوينه بالترتيب. الخيار الاحتياطي SQL موجود دائمًا، لذا تعمل التحميلات بدون أي إعداد."
 {
-  "html": "<div class=\"diagram-upload\"><div class=\"diagram-box\" data-rough>uploadFile()<br><small class=\"diagram-muted\">POST /_agent-native/file-upload</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-step\"><span class=\"diagram-pill accent\">1</span><div class=\"diagram-node\">User-registered<br><small class=\"diagram-muted\">registerFileUploadProvider() — S3, R2, GCS…</small></div></div><div class=\"diagram-step\"><span class=\"diagram-pill\">2</span><div class=\"diagram-node\">Builder.io<br><small class=\"diagram-muted\">auto when connected — CDN-served</small></div></div><div class=\"diagram-step\"><span class=\"diagram-pill warn\">3</span><div class=\"diagram-node\">SQL fallback<br><small class=\"diagram-muted\">base64 in DB — dev only</small></div></div></div></div>",
+  "html": "<div class=\"diagram-upload\"><div class=\"diagram-box\" data-rough>uploadFile()<br><small class=\"diagram-muted\">POST /_agent-native/file-upload</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-step\"><span class=\"diagram-pill accent\">1</span><div class=\"diagram-node\">مسجل من المستخدم<br><small class=\"diagram-muted\">registerFileUploadProvider() — S3, R2, GCS…</small></div></div><div class=\"diagram-step\"><span class=\"diagram-pill\">2</span><div class=\"diagram-node\">Builder.io<br><small class=\"diagram-muted\">تلقائي عند الاتصال — مقدم عبر CDN</small></div></div><div class=\"diagram-step\"><span class=\"diagram-pill warn\">3</span><div class=\"diagram-node\">احتياطي SQL<br><small class=\"diagram-muted\">base64 في قاعدة البيانات — للتطوير فقط</small></div></div></div></div>",
   "css": ".diagram-upload{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-upload .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-upload .diagram-step{display:flex;align-items:center;gap:8px}.diagram-upload .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
 
-```an-api title="The upload endpoint" method="POST" path="/_agent-native/file-upload"
+```an-api title="نقطة نهاية التحميل" method="POST" path="/_agent-native/file-upload"
 {
   "method": "POST",
   "path": "/_agent-native/file-upload",
-  "summary": "Upload a file through the active provider and get back a public URL.",
+  "summary": "قم بتحميل ملف من خلال الموفر النشط واسترجع URL عام.",
   "description": "Dispatches to the first configured provider in resolution order. Check the active provider at `GET /_agent-native/file-upload/status`.",
   "request": { "contentType": "multipart/form-data" },
   "responses": [
@@ -117,6 +117,6 @@ const result = await uploadFile({
 if (result) {
   // Provider handled it — result.url is the public URL
 } else {
-  // No provider configured — handle SQL fallback yourself, or skip
+  // No provider configured — handle احتياطي SQL yourself, or skip
 }
 ```

package/docs/content/locales/ar-SA/frames.md

@@ -22,7 +22,7 @@ description: "إطار التطوير المحلي، ولوحة الوكيل ا
 
 ```an-diagram title="ثلاثة إطارات، وقت تشغيل واحد" summary="تطبيقك ولوحة الوكيل متماثلان في كل إطار؛ فقط الغلاف المحيط بهم يتغير."
 {
-  "html": "<div class=\"diagram-frames\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">Embedded panel</span><small class=\"diagram-muted\">ships in every app · dev + prod</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Local dev frame</span><small class=\"diagram-muted\">app in an iframe + panel + CLI terminal</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Builder.io cloud frame</span><small class=\"diagram-muted\">hosted: collaboration · visual edit · parallel runs</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>Same runtime<br><small class=\"diagram-muted\">your app · actions · application state</small></div></div>",
+  "html": "<div class=\"diagram-frames\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">لوحة مضمنة</span><small class=\"diagram-muted\">يأتي مع كل تطبيق · تطوير + إنتاج</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">إطار تطوير محلي</span><small class=\"diagram-muted\">تطبيق داخل iframe + لوحة + طرفية CLI</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">إطار سحابي Builder.io</span><small class=\"diagram-muted\">مستضاف: تعاون · تحرير مرئي · تشغيلات متوازية</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>نفس وقت التشغيل<br><small class=\"diagram-muted\">تطبيقك · الإجراءات · حالة التطبيق</small></div></div>",
   "css": ".diagram-frames{display:flex;flex-direction:column;gap:10px;align-items:stretch}.diagram-frames .diagram-card{display:flex;flex-direction:column;gap:4px;padding:12px 16px}.diagram-frames .diagram-arrow{font-size:22px;line-height:1;align-self:center}"
 }
 ```

package/docs/content/locales/ar-SA/getting-started.md

@@ -63,7 +63,7 @@ npx @agent-native/core@latest create my-agent --headless
 ثم قم بالتثبيت من المجلد الذي قمت بإنشائه:
 
 ```bash
-cd my-agent # or my-app if you chose the Chat template
+cd my-agent # أو تطبيقي إذا اخترت قالب الدردشة
 pnpm install
 ```
 
@@ -82,9 +82,9 @@ pnpm install
   "annotations": [
     { "lines": "5", "label": "وصف الأداة", "note": "يقرأ الوكيل `description` ليقرر متى يستدعيه كأداة." },
     { "lines": "6-8", "label": "عقد typed", "note": "يتحقق zod `schema` واحد من الإدخال من كل سطح: الوكيل، UI، HTTP، MCP وA2A." },
-    { "lines": "9", "label": "HTTP verb", "note": "Opt this action into an auto-mounted HTTP endpoint." },
-    { "lines": "10", "label": "Read-only", "note": "`readOnly` marks the action as safe to call without approval and cacheable for queries." },
-    { "lines": "11-13", "label": "One implementation", "note": "The `run` body is the single source of truth that every surface executes." }
+    { "lines": "9", "label": "فعل HTTP", "note": "اجعل هذا الإجراء متاحًا كنقطة نهاية HTTP تُركّب تلقائيًا." },
+    { "lines": "10", "label": "للقراءة فقط", "note": "تشير `readOnly` إلى أن الإجراء آمن للاستدعاء دون موافقة وقابل للتخزين المؤقت للاستعلامات." },
+    { "lines": "11-13", "label": "تنفيذ واحد", "note": "جسم `run` هو مصدر الحقيقة الوحيد الذي تنفذه كل الواجهات." }
   ]
 }
 ```
@@ -123,7 +123,7 @@ pnpm dev
 
 ```an-diagram title="إجراء واحد، على كل سطح" summary="يتم إرسال ملف defineAction واحد إلى كل مستهلك بدون أي أسلاك إضافية."
 {
-  "html": "<div class=\"diagram-fan\"><div class=\"diagram-box\" data-rough>defineAction</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-surfaces\"><span class=\"diagram-pill\">Chat UI</span><span class=\"diagram-pill\">CLI</span><span class=\"diagram-pill\">HTTP</span><span class=\"diagram-pill\">MCP</span><span class=\"diagram-pill\">A2A</span><span class=\"diagram-pill\">Scheduled jobs</span><span class=\"diagram-pill\">Webhooks</span></div></div>",
+  "html": "<div class=\"diagram-fan\"><div class=\"diagram-box\" data-rough>defineAction</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-surfaces\"><span class=\"diagram-pill\">واجهة الدردشة</span><span class=\"diagram-pill\">CLI</span><span class=\"diagram-pill\">HTTP</span><span class=\"diagram-pill\">MCP</span><span class=\"diagram-pill\">A2A</span><span class=\"diagram-pill\">مهام مجدولة</span><span class=\"diagram-pill\">Webhooks</span></div></div>",
   "css": ".diagram-fan{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-fan .diagram-surfaces{display:flex;flex-wrap:wrap;gap:8px;max-width:420px}.diagram-fan .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -138,7 +138,7 @@ pnpm dev
 ```an-callout
 {
   "tone": "info",
-  "body": "**Headless is still a real app.** The app-agent loop persists sessions, threads, runs, settings, and credentials in SQL — it is not a stateless prompt. You can add a UI later without touching your actions or state."
+  "body": "**لا يزال تطبيق Headless تطبيقًا حقيقيًا.** تستمر حلقة وكيل التطبيق في الجلسات والسلاسل وعمليات التشغيل والإعدادات وبيانات الاعتماد في SQL — وهي ليست مطالبة عديمة الحالة. يمكنك إضافة UI لاحقًا دون لمس أفعالك أو حالتك."
 }
 ```
 
@@ -165,7 +165,7 @@ export default function ChatRoute() {
   `useActionMutation()`.
 
 راجع [Drop-in Agent](/docs/drop-in-agent) للتعرف على مجموعة المكونات الكاملة، و
-[Native Chat UI](/docs/native-chat-ui) لعرض نتائج الإجراء على هيئة جداول
+[Native واجهة الدردشة](/docs/native-chat-ui) لعرض نتائج الإجراء على هيئة جداول
 المخططات والبطاقات المكتوبة بدلاً من النص العادي.
 
 **بدأت بدون رأس وتريد UI لاحقًا؟** قالب الدردشة _هو_ UI على الطريق المنحدر —
@@ -178,12 +178,12 @@ export default function ChatRoute() {
 
 ```text
 my-app/
-  actions/         # Agent-callable actions
-  app/             # React frontend (UI templates only; omitted when headless)
-  server/          # Nitro API server (routes, plugins)
-  AGENTS.md        # Always-on agent instructions
-  .agents/         # Skills the agent can pull in when relevant
-  data/app.db      # Local SQLite state when DATABASE_URL is unset
+  actions/         # إجراءات يمكن للوكيل استدعاؤها
+  app/             # واجهة React أمامية (لقوالب UI فقط؛ تُحذف في وضع headless)
+  server/          # خادم Nitro API (مسارات، إضافات)
+  AGENTS.md        # تعليمات الوكيل الدائمة
+  .agents/         # مهارات يمكن للوكيل جلبها عند الحاجة
+  data/app.db      # حالة SQLite محلية عند عدم ضبط DATABASE_URL
 ```
 
 ## إلى أين ستتجه بعد ذلك

package/docs/content/locales/ar-SA/harness-agents.md

@@ -215,7 +215,7 @@ const run = startAgentHarnessRun({
 
 ```an-diagram title="الاستئناف عبر المنعطفات والعمليات والنشر" summary="يقوم كل دور بفصل حالة السيرة الذاتية المبهمة إلى SQL؛ المنعطف التالي يعيده مرة أخرى إلى createSession بدلاً من إعادة تشغيل سجل الدردشة."
 {
-  "html": "<div class=\"diagram-resume\"><div class=\"diagram-node\" data-rough>Turn N<br><small class=\"diagram-muted\">streamTurn</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>detach &rarr; resumeState<br><small class=\"diagram-muted\">opaque · SQL harness session</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>Turn N+1<br><small class=\"diagram-muted\">createSession.resumeState</small></div></div>",
+  "html": "<div class=\"diagram-resume\"><div class=\"diagram-node\" data-rough>الدور N<br><small class=\"diagram-muted\">streamTurn</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>detach &rarr; resumeState<br><small class=\"diagram-muted\">معتم · جلسة حاضنة SQL</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>الدور N+1<br><small class=\"diagram-muted\">createSession.resumeState</small></div></div>",
   "css": ".diagram-resume{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-resume .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -267,7 +267,7 @@ const last = await getLatestAgentHarnessSessionForThread(threadId);
 حمولة `mcpApp` للأدوات الأصلية)، `approval-request`، `file-change`،
 `compaction`، و`usage`، و`error`، و`done`. لأن نتائج الأداة تتدفق عبر
 نفس الترجمة، ولا تزال الأدوات الأصلية التي تم الإعلان عنها عن إجراء تعرض - راجع
-[Native Chat UI](/docs/native-chat-ui).
+[Native واجهة الدردشة](/docs/native-chat-ui).
 
 ## يعمل في الخلفية وUI {#background-runs}
 
@@ -341,7 +341,7 @@ registerAgentHarness({
 
 ## المستندات ذات الصلة {#related-docs}
 
-- [Native Chat UI](/docs/native-chat-ui) — ضع وكيلك الخاص خلف الدردشة UI مع `AgentChatRuntime`.
+- [Native واجهة الدردشة](/docs/native-chat-ui) — ضع وكيلك الخاص خلف الدردشة UI مع `AgentChatRuntime`.
 - [Agent Surfaces](/docs/agent-surfaces) - اختر التطبيق بلا رأس، أو الدردشة، أو السيارة الجانبية، أو التطبيق الكامل.
 - [Agent-Native Code UI](/docs/code-agents-ui) — سطح مساحة عمل البرمجة القابلة لإعادة الاستخدام.
 - [Custom Agents & Teams](/docs/agent-teams) — عمليات التشغيل في الخلفية وتفويض الوكيل الفرعي.

package/docs/content/locales/ar-SA/human-approval.md

@@ -20,8 +20,8 @@ description: "إيقاف الوكيل مؤقتًا قبل تشغيل الإجر
   "language": "ts",
   "code": "export default defineAction({\n  description: \"Send an email via Gmail.\",\n  schema: z.object({\n    to: z.string(),\n    subject: z.string(),\n    body: z.string(),\n  }),\n  // Sending is outward-facing and hard to undo, so the agent can never send\n  // without a human approving the specific call. Drafting/queueing is\n  // unaffected — only the real send is gated.\n  needsApproval: true,\n  run: async (args) => {\n    /* ...actually send... */\n  },\n});",
   "annotations": [
-    { "lines": "10", "label": "The whole gate", "note": "One flag. With it truthy and the call unapproved, the loop stops before `run` — the model never reaches the side effect on its own." },
-    { "lines": "11-13", "label": "run() is untouched", "note": "The handler stays the same. Approval is enforced by the loop around it, not by anything inside `run`." }
+    { "lines": "10", "label": "الشارع كله", "note": "علم واحد. مع صدق المكالمة وعدم الموافقة على المكالمة، تتوقف الحلقة قبل `run` - لا يصل النموذج أبدًا إلى التأثير الجانبي من تلقاء نفسه." },
+    { "lines": "11-13", "label": "run() is untouched", "note": "يظل المعالج كما هو. يتم فرض الموافقة من خلال الحلقة المحيطة بها، وليس من خلال أي شيء داخل `run`." }
   ]
 }
 ```
@@ -72,7 +72,7 @@ description: "إيقاف الوكيل مؤقتًا قبل تشغيل الإجر
 
 ```an-diagram title="مقاطعة الموافقة" summary="تقوم المكالمة المسورة بإيقاف الدور مؤقتًا قبل تشغيل run(). الموافقة تعيد إصدار الدور الذي يحمل مفتاح الاتصال؛ عندها فقط يحدث التأثير الجانبي."
 {
-  "html": "<div class=\"diagram-approve\"><div class=\"diagram-box\" data-rough>Agent calls send-email</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel warn\" data-rough><strong>Gate truthy, call not yet approved</strong><small class=\"diagram-muted\">loop emits tool_start + approval_required { tool, input, approvalKey }</small><span class=\"diagram-pill warn\">turn pauses &mdash; run() did NOT execute</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>Human clicks Approve in chat<br><small class=\"diagram-muted\">client re-issues the turn with approvedToolCalls: [approvalKey]</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel ok\" data-rough><span class=\"diagram-pill ok\">Gate sees the key &rarr; run() executes &rarr; email sends</span></div></div>",
+  "html": "<div class=\"diagram-approve\"><div class=\"diagram-box\" data-rough>الوكيل يستدعي send-email</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel warn\" data-rough><strong>البوابة صحيحة، والاستدعاء لم يوافق عليه بعد</strong><small class=\"diagram-muted\">loop emits tool_start + approval_required { tool, input, approvalKey }</small><span class=\"diagram-pill warn\">turn pauses &mdash; run() did NOT execute</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>ينقر الإنسان موافقة في الدردشة<br><small class=\"diagram-muted\">يعيد العميل إرسال الدور مع approvedToolCalls: [approvalKey]</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel ok\" data-rough><span class=\"diagram-pill ok\">Gate sees the key &rarr; run() executes &rarr; email sends</span></div></div>",
   "css": ".diagram-approve{display:flex;flex-direction:column;align-items:center;gap:8px}.diagram-approve .diagram-panel{display:flex;flex-direction:column;gap:6px;align-items:center;padding:12px 16px;text-align:center}.diagram-approve .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```