@agent-native/core 0.77.2 → 0.77.4

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

@@ -18,7 +18,7 @@ await notify(
 );
 ```
 
-```an-diagram title="مكالمة واحدة، وجهات عديدة" summary="يقوم notify() دائمًا بكتابة صف البريد الوارد الخاص بنطاق المالك، وتوجيهه إلى كل قناة مسجلة بالتوازي (أفضل جهد)، ثم إرسال الإشعارات المرسلة في ناقل الأحداث."
+```an-diagram title="مكالمة واحدة، وجهات عديدة" summary="يقوم notify() دائمًا بكتابة صف البريد الوارد الخاص بنطاق المالك, وتوجيهه إلى كل قناة مسجلة بالتوازي (أفضل جهد)، ثم إرسال الإشعارات المرسلة في ناقل الأحداث."
 {
   "html": "<div class=\"diagram-notify\"><div class=\"diagram-node\">notify(input, { owner })<br><small class=\"diagram-muted\">any server code &middot; action, automation, plugin</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel fan\" data-rough><div class=\"fan-row\"><span class=\"diagram-pill accent\">inbox</span><div class=\"diagram-box\" data-rough>notifications table &rarr; bell UI<br><small class=\"diagram-muted\">always on &middot; owner-scoped</small></div></div><div class=\"fan-row\"><span class=\"diagram-pill\">webhook</span><div class=\"diagram-box\" data-rough>POST JSON to NOTIFICATIONS_WEBHOOK_URL<br><small class=\"diagram-muted\">best-effort</small></div></div><div class=\"fan-row\"><span class=\"diagram-pill\">custom</span><div class=\"diagram-box\" data-rough>registerNotificationChannel(...)<br><small class=\"diagram-muted\">best-effort &middot; runs in parallel</small></div></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill ok\">notification.sent</span><small class=\"diagram-muted\">event bus &middot; automations can chain</small></div></div>",
   "css": ".diagram-notify{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-notify .fan{display:flex;flex-direction:column;gap:10px;padding:14px}.diagram-notify .fan-row{display:flex;align-items:center;gap:10px}.diagram-notify .diagram-card{display:flex;flex-direction:column;gap:6px;padding:12px 14px}.diagram-notify .diagram-arrow{font-size:22px;line-height:1}"
@@ -46,7 +46,7 @@ await notify(
 
 ```an-diagram title="القنوات وخطورتها" summary="البريد الوارد قيد التشغيل دائمًا؛ يحتاج خطاف الويب إلى env var؛ يتم تسجيل القنوات المخصصة عند بدء التشغيل. تؤدي درجة الخطورة إلى تصميم الشارة ويتم تمريرها إلى كل قناة."
 {
-  "html": "<div class=\"diagram-channels\"><div class=\"diagram-panel col\" data-rough><strong>Channels</strong><div class=\"diagram-box\" data-rough>inbox<br><small class=\"diagram-muted\">always on &mdash; part of the primitive</small></div><div class=\"diagram-box\" data-rough>webhook<br><small class=\"diagram-muted\">needs NOTIFICATIONS_WEBHOOK_URL</small></div><div class=\"diagram-box\" data-rough>custom<br><small class=\"diagram-muted\">registerNotificationChannel()</small></div></div><div class=\"diagram-panel col\" data-rough><strong>Severity drives the badge</strong><div class=\"sev-row\"><span class=\"diagram-pill\">info</span><span class=\"diagram-muted\">confirmations, FYI</span></div><div class=\"sev-row\"><span class=\"diagram-pill warn\">warning</span><span class=\"diagram-muted\">look at soon</span></div><div class=\"sev-row\"><span class=\"diagram-pill accent\">critical</span><span class=\"diagram-muted\">needs immediate attention</span></div></div></div>",
+  "html": "<div class=\"diagram-channels\"><div class=\"diagram-panel col\" data-rough><strong>Channels</strong><div class=\"diagram-box\" data-rough>inbox<br><small class=\"diagram-muted\">always on &mdash; part of the primitive</small></div><div class=\"diagram-box\" data-rough>webhook<br><small class=\"diagram-muted\">needs NOTIFICATIONS_WEBHOOK_URL</small></div><div class=\"diagram-box\" data-rough>custom<br><small class=\"diagram-muted\">registerNotificationChannel()</small></div></div><div class=\"diagram-panel col\" data-rough><strong>تحدد الخطورة الشارة</strong><div class=\"sev-row\"><span class=\"diagram-pill\">info</span><span class=\"diagram-muted\">تأكيدات، FYI</span></div><div class=\"sev-row\"><span class=\"diagram-pill warn\">warning</span><span class=\"diagram-muted\">look at soon</span></div><div class=\"sev-row\"><span class=\"diagram-pill accent\">critical</span><span class=\"diagram-muted\">needs immediate attention</span></div></div></div>",
   "css": ".diagram-channels{display:flex;gap:16px;flex-wrap:wrap;align-items:flex-start}.diagram-channels .col{display:flex;flex-direction:column;gap:10px;padding:14px;min-width:240px}.diagram-channels .sev-row{display:flex;align-items:center;gap:10px}"
 }
 ```
@@ -155,11 +155,11 @@ interface NotificationMeta {
 | `POST`   | `/_agent-native/notifications/read-all`             |
 | `DELETE` | `/_agent-native/notifications/:id`                  |
 
-```an-api title="List notifications" summary="The route behind listNotifications() — scoped to the authenticated session's email."
+```an-api title="قائمة الإشعارات" summary="The route behind listNotifications() — scoped to the authenticated session's email."
 {
   "method": "GET",
   "path": "/_agent-native/notifications?unread=true&limit=50",
-  "summary": "List recent notifications for the current user",
+  "summary": "قم بإدراج الإشعارات الأخيرة للمستخدم الحالي",
   "auth": "Authenticated session; results are scoped to the session's email.",
   "params": [
     { "name": "unread", "in": "query", "type": "boolean", "required": false, "description": "When true, returns only unread notifications." },
@@ -220,7 +220,7 @@ export function HeaderBar() {
 ## كيفية العمل {#internals}
 
 - **نطاق المالك** — يحتوي كل صف على عمود `owner`؛ يتم تصفية كل استعلام عليه؛ يستخدم كل مسار البريد الإلكتروني للجلسة المصادق عليها. لا يرى المستخدمون أبدًا إشعارات بعضهم البعض.
-- **تكامل الاستقصاء** — تستدعي كل طفرة `recordChange()`، لذا يتم إبطال صحة القوالب التي تستخدم [`useDbSync`](/docs/client) تلقائيًا دون أي أسلاك إضافية.
+- **تكامل الاستقصاء** — تستدعي كل طفرة `recordChange()`, لذا يتم إبطال صحة القوالب التي تستخدم [`useDbSync`](/docs/client) تلقائيًا دون أي أسلاك إضافية.
 - **توزيع أفضل جهد** — يتم اكتشاف أخطاء القناة وتسجيلها؛ لا تؤدي إحدى القنوات الفاشلة إلى منع القنوات الأخرى أو الكتابة في البريد الوارد.
 - **أطلق النار وانسى** — يعود `notify()` بعد اكتمال الكتابة في البريد الوارد؛ تعمل القنوات المخصصة في الخلفية.
 

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

@@ -35,7 +35,7 @@ description: "تتبعات الوكيل، وعمليات التقييم، وال
 
 ```an-diagram title="كل شوط يغذي الحلقة" summary="ينتج عن تشغيل وكيل واحد تتبعًا ونتائج تلقائية وخطافًا للتعليقات - يتم تخزين كل ذلك في SQL الخاص بالتطبيق ويظهر على لوحة المعلومات. تقوم التجارب بتقسيم حركة المرور عبر متغيرات التكوين."
 {
-  "html": "<div class=\"obs-loop\"><div class=\"diagram-node\">Agent run<br><small class=\"diagram-muted\">production-agent.ts</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Captured automatically</span><small class=\"diagram-muted\">tokens &middot; cost &middot; latency &middot; tool calls</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Traces &amp; spans</div><div class=\"diagram-box\">Evals (5 scorers + LLM judge)</div><div class=\"diagram-box\">Feedback &amp; frustration index</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node ok\">Dashboard<br><small class=\"diagram-muted\">scoped to the signed-in user</small></div></div>",
+  "html": "<div class=\"obs-loop\"><div class=\"diagram-node\">تشغيل الوكيل<br><small class=\"diagram-muted\">production-agent.ts</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">يلتقط تلقائيا</span><small class=\"diagram-muted\">tokens &middot; cost &middot; latency &middot; tool calls</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Traces &amp; spans</div><div class=\"diagram-box\">Evals (5 scorers + LLM judge)</div><div class=\"diagram-box\">Feedback &amp; frustration index</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node ok\">Dashboard<br><small class=\"diagram-muted\">scoped to the signed-in user</small></div></div>",
   "css": ".obs-loop{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.obs-loop .diagram-col{display:flex;flex-direction:column;gap:8px}.obs-loop .diagram-arrow{font-size:22px;line-height:1}.obs-loop .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```

package/docs/content/locales/ar-SA/observational-memory.md

@@ -21,7 +21,7 @@ description: "ضغط الخلفية ثلاثي الطبقات (الخام الأ
 
 ```an-diagram title="ثلاث طبقات، مقطرة إلى الأخيرة" summary="تُطوى البادئة الأقدم إلى ملاحظات مؤرخة وانعكاس قوس طويل؛ فقط أحدث المنعطفات تبقى حرفية."
 {
-  "html": "<div class=\"om\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Reflections</span><small class=\"diagram-muted\">long-arc summary, condensed from the observation log</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&uarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Observations</span><small class=\"diagram-muted\">dense, dated entries folding stretches of raw messages</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&uarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill ok\">Recent raw messages</span><small class=\"diagram-muted\">last N turns, kept <strong>verbatim</strong> — never folded</small></div></div>",
+  "html": "<div class=\"om\"><div class=\"diagram-card\"><span class=\"diagram-pill\">تأملات</span><small class=\"diagram-muted\">ملخص طويل المدى مكثف من سجل الملاحظات</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&uarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">ملاحظات</span><small class=\"diagram-muted\">إدخالات مؤرخة ومكثفة تطوي مقاطع من الرسائل الخام</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&uarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill ok\">الرسائل الخام الأخيرة</span><small class=\"diagram-muted\">last N turns, kept <strong>verbatim</strong> — لا تُطوى أبدًا</small></div></div>",
   "css": ".om{display:flex;flex-direction:column-reverse;align-items:stretch;gap:8px}.om .diagram-card{display:flex;flex-direction:column;gap:4px;padding:12px 16px}.om .diagram-arrow{text-align:center;font-size:20px;line-height:1}"
 }
 ```
@@ -37,7 +37,7 @@ description: "ضغط الخلفية ثلاثي الطبقات (الخام الأ
 
 ```an-diagram title="تمريرتان من أفضل المحاولات بعد منعطف نظيف" summary="كل تمريرة محظورة أقل من عتبتها، لذا فإن تشغيل الضاغط في كل دورة يعد رخيصًا. يتم ابتلاع الفشل ولا يضيف الكمون أبدًا."
 {
-  "html": "<div class=\"om-pass\"><div class=\"diagram-node\">Clean turn ends<br><small class=\"diagram-muted\">fire-and-forget</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Observer</span><small class=\"diagram-muted\">unobserved tokens &gt; 30k? &rarr; fold into one observation</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Reflector</span><small class=\"diagram-muted\">observation log &gt; 40k? &rarr; condense into a reflection</small></div></div>",
+  "html": "<div class=\"om-pass\"><div class=\"diagram-node\">ينتهي الدور النظيف<br><small class=\"diagram-muted\">fire-and-forget</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Observer</span><small class=\"diagram-muted\">unobserved tokens &gt; 30k? &rarr; fold into one observation</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Reflector</span><small class=\"diagram-muted\">observation log &gt; 40k? &rarr; condense into a reflection</small></div></div>",
   "css": ".om-pass{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.om-pass .diagram-node,.om-pass .diagram-card{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.om-pass .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```

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

@@ -12,7 +12,7 @@ description: "قائمة التحقق من الإعداد للتهيئة الت
 
 ```an-diagram title="قائمة التحقق من الإعداد" summary="مطلوب فقط توصيل محرك AI. تقوم اللوحة بتتبع الإكمال والإخفاء التلقائي بمجرد الانتهاء من كل ما هو مطلوب."
 {
-  "html": "<div class=\"ob\"><div class=\"diagram-card\"><span class=\"diagram-pill warn\">required</span><strong>Connect an AI engine</strong><small class=\"diagram-muted\">Connect Builder (one click) or paste an LLM key</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">optional</span><strong>Database</strong><small class=\"diagram-muted\">set <code>DATABASE_URL</code></small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">optional</span><strong>Authentication</strong><small class=\"diagram-muted\">OAuth / access token</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">optional</span><strong>Email delivery</strong><small class=\"diagram-muted\">Resend / SendGrid</small></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">all required done &rarr; panel auto-hides</div></div>",
+  "html": "<div class=\"ob\"><div class=\"diagram-card\"><span class=\"diagram-pill warn\">required</span><strong>وصل محرك AI</strong><small class=\"diagram-muted\">Connect Builder (one click) or paste an LLM key</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">optional</span><strong>Database</strong><small class=\"diagram-muted\">set <code>DATABASE_URL</code></small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">optional</span><strong>Authentication</strong><small class=\"diagram-muted\">OAuth / access token</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">optional</span><strong>تسليم البريد الإلكتروني</strong><small class=\"diagram-muted\">Resend / SendGrid</small></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">all required done &rarr; panel auto-hides</div></div>",
   "css": ".ob{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.ob .diagram-card{display:flex;flex-direction:column;gap:3px;padding:12px 14px}.ob .diagram-arrow{font-size:22px}"
 }
 ```
@@ -100,11 +100,11 @@ description: "قائمة التحقق من الإعداد للتهيئة الت
 | `POST /_agent-native/onboarding/reopen`             | مسح الرفض (إعادة إظهار اللوحة)      |
 | `GET /_agent-native/onboarding/dismissed`           | قراءة الفصل + العلامة الكاملة       |
 
-```an-api title="List onboarding steps"
+```an-api title="قم بإدراج خطوات الإعداد"
 {
   "method": "GET",
   "path": "/_agent-native/onboarding/steps",
-  "summary": "List all registered steps with their completion status",
+  "summary": "قم بإدراج جميع الخطوات المسجلة مع حالة اكتمالها",
   "description": "Drives the sidebar checklist — returns each step's id, title, methods, required flag, and whether `isComplete` currently passes.",
   "responses": [
     { "status": "200", "description": "Array of steps with completion status for the current user/app." }
@@ -120,11 +120,11 @@ description: "قائمة التحقق من الإعداد للتهيئة الت
   "language": "ts",
   "code": "import { defineNitroPlugin } from \"@agent-native/core/server\";\nimport { registerOnboardingStep } from \"@agent-native/core/onboarding\";\nimport { listOAuthAccounts } from \"@agent-native/core/oauth-tokens\";\n\nexport default defineNitroPlugin(() => {\n  registerOnboardingStep({\n    id: \"gmail\",\n    order: 100,\n    title: \"Connect Gmail\",\n    description: \"Grant read/send access so the agent can work with email.\",\n    methods: [\n      {\n        id: \"oauth\",\n        kind: \"link\",\n        primary: true,\n        label: \"Sign in with Google\",\n        payload: { url: \"/_agent-native/google/auth-url?scope=mail\", external: false },\n      },\n      {\n        id: \"delegate\",\n        kind: \"agent-task\",\n        label: \"Let the agent set it up\",\n        badge: \"beta\",\n        payload: { prompt: \"Walk me through connecting Gmail. Set env vars as needed.\" },\n      },\n    ],\n    isComplete: async () => {\n      const accounts = await listOAuthAccounts(\"google\");\n      return accounts.length > 0;\n    },\n  });\n});",
   "annotations": [
-    { "lines": "5", "label": "Auto-mounted", "note": "Register from a Nitro plugin — the framework handles rendering, completion tracking, and dismissal." },
-    { "lines": "7", "label": "Stable id", "note": "Re-registering with the same `id` after defaults load overrides a built-in step." },
-    { "lines": "12-19", "label": "Primary method", "note": "`primary: true` marks the big CTA. `kind: \"link\"` sends the user into the OAuth flow." },
-    { "lines": "20-26", "label": "Delegate path", "note": "`kind: \"agent-task\"` hands the setup to the agent chat with a prompt." },
-    { "lines": "28-31", "label": "Completion check", "note": "`isComplete` runs server-side. OAuth tokens live in the `oauth_tokens` store — check it, not `process.env.GMAIL_REFRESH_TOKEN`." }
+    { "lines": "5", "label": "مثبتة تلقائيًا", "note": "قم بالتسجيل من مكون إضافي Nitro - يعالج إطار العمل العرض وتتبع الإكمال والفصل." },
+    { "lines": "7", "label": "معرف المكدس", "note": "إعادة التسجيل بنفس `id` بعد تحميل الإعدادات الافتراضية يتجاوز خطوة مضمنة." },
+    { "lines": "12-19", "label": "الطريقة الأساسية", "note": "`primary: true` marks the big CTA. `kind: \"link\"` sends the user into the OAuth flow." },
+    { "lines": "20-26", "label": "مسار التفويض", "note": "`kind: \"agent-task\"` hands the setup to the agent chat with a prompt." },
+    { "lines": "28-31", "label": "التحقق من الإكمال", "note": "`isComplete` يعمل من جانب الخادم. رموز OAuth موجودة في متجر `oauth_tokens` - تحقق منها، وليس `process.env.GMAIL_REFRESH_TOKEN`." }
   ]
 }
 ```

package/docs/content/locales/ar-SA/plan-plugin.md

@@ -16,7 +16,7 @@ description: "قم بتثبيت خطة Agent-Native skills (/visual-plan، /visu
 
 ```an-diagram title="ثلاث طرق، حزمة واحدة" summary="يقوم كل من المكون الإضافي CLI، وClaude Code، والمكون الإضافي Codex بتثبيت نفس المهارتين بالإضافة إلى موصل الخطة المستضاف."
 {
-  "html": "<div class=\"diagram-routes\"><div class=\"diagram-col\"><div class=\"diagram-node\">Universal CLI<br><small class=\"diagram-muted\">skills add visual-plan</small></div><div class=\"diagram-node\">Claude Code plugin<br><small class=\"diagram-muted\">/plugin install</small></div><div class=\"diagram-node\">Codex plugin<br><small class=\"diagram-muted\">codex plugin add</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">/visual-plan</span><span class=\"diagram-pill accent\">/visual-recap</span><small class=\"diagram-muted\">two skills</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Plan MCP connector<br><small class=\"diagram-muted\">plan.agent-native.com/_agent-native/mcp</small></div></div>",
+  "html": "<div class=\"diagram-routes\"><div class=\"diagram-col\"><div class=\"diagram-node\">Universal CLI<br><small class=\"diagram-muted\">skills add visual-plan</small></div><div class=\"diagram-node\">إضافة Claude Code<br><small class=\"diagram-muted\">/plugin install</small></div><div class=\"diagram-node\">إضافة Codex<br><small class=\"diagram-muted\">codex plugin add</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">/visual-plan</span><span class=\"diagram-pill accent\">/visual-recap</span><small class=\"diagram-muted\">two skills</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Plan MCP connector<br><small class=\"diagram-muted\">plan.agent-native.com/_agent-native/mcp</small></div></div>",
   "css": ".diagram-routes{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-routes .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-routes .diagram-arrow{font-size:22px;line-height:1}.diagram-routes .center{display:flex;flex-direction:column;align-items:center;gap:4px;text-align:center}.diagram-routes .center .diagram-pill{margin:2px}"
 }
 ```
@@ -84,7 +84,7 @@ npx @agent-native/core@latest plan local serve --dir plans/<slug> --kind plan --
 
 ```an-diagram title="وضع الملفات المستضافة مقابل وضع الملفات المحلية" summary="بشكل افتراضي، يتم نشر المهارات من خلال الموصل؛ يقوم وضع الملفات المحلية بكتابة MDX على القرص ومعاينته عبر جسر مضيف محلي بدلاً من ذلك."
 {
-  "html": "<div class=\"diagram-modes\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Default · hosted</span><strong>Publish to the Plan app</strong><small class=\"diagram-muted\">MCP connector &rarr; hosted DB &rarr; share links, comments, history, screenshots</small></div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">Local-files privacy</span><strong>Write MDX to disk</strong><small class=\"diagram-muted\">plan.mdx + canvas.mdx + prototype.mdx &rarr; localhost bridge &rarr; hosted Plan UI reads local source. No DB writes until <code>publish-visual-plan</code>.</small></div></div>",
+  "html": "<div class=\"diagram-modes\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">افتراضي · مستضاف</span><strong>النشر إلى تطبيق Plan</strong><small class=\"diagram-muted\">MCP connector &rarr; hosted DB &rarr; share links, comments, history, screenshots</small></div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">خصوصية الملفات المحلية</span><strong>اكتب MDX إلى القرص</strong><small class=\"diagram-muted\">plan.mdx + canvas.mdx + prototype.mdx &rarr; localhost bridge &rarr; hosted Plan UI reads local source. No كتابة في قاعدة البياناتs until <code>publish-visual-plan</code>.</small></div></div>",
   "css": ".diagram-modes{display:flex;gap:14px;flex-wrap:wrap}.diagram-modes .diagram-card{flex:1 1 260px;display:flex;flex-direction:column;gap:6px;padding:16px 18px}"
 }
 ```
@@ -156,7 +156,7 @@ npx @agent-native/core@latest recap doctor
 ```bash
 codex plugin marketplace add BuilderIO/agent-native
 codex plugin add agent-native-visual-plans@agent-native-apps
-codex mcp login plan   # OAuth in the browser
+codex mcp login plan   # OAuth في المتصفح
 ```
 
 بعد التثبيت، **ابدأ سلسلة Codex جديدة** حتى يتم تحميل الأدوات skills وMCP في الجلسة. يشحن البرنامج المساعد موصل URL فقط (`[mcp_servers.plan]` → `https://plan.agent-native.com/_agent-native/mcp`)؛ يقوم `codex mcp login plan` بتشغيل التدفق OAuth. يعمل مسار CLI العالمي أعلاه أيضًا مع Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) إذا كنت تفضل أمرًا واحدًا يتم تثبيته والمصادقة عليه معًا، أو عندما تريد الملفات المحلية أو وضع الاستضافة الذاتية.

package/docs/content/locales/ar-SA/pr-visual-recap.md

@@ -26,7 +26,7 @@ PR Visual Recap هو إجراء GitHub يحول كل طلب سحب إلى **مر
 
 ```an-diagram title="ماذا يحدث في كل دفعة للعلاقات العامة" summary="يغذي الفرق المحدود وكيل ترميز حقيقي، والذي يقوم بتأليف ملخص؛ يقوم سير العمل بالتقاط لقطات شاشة له وإدراج تعليق واحد ثابت."
 {
-  "html": "<div class=\"diagram-recap\"><div class=\"diagram-node\">PR push<br><small class=\"diagram-muted\">bounded base&hellip;head diff</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Coding agent<br><small class=\"diagram-muted\">Claude Code / Codex reads diff</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">create-visual-recap</span><small class=\"diagram-muted\">publishes recap plan</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Headless Chrome<br><small class=\"diagram-muted\">light + dark screenshots</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">One sticky PR comment<br><small class=\"diagram-muted\">inline screenshot + plan link</small></div></div><div class=\"diagram-foot diagram-muted\">Plus an informational <span class=\"diagram-pill\">Visual Recap</span> check &mdash; non-blocking, never required.</div>",
+  "html": "<div class=\"diagram-recap\"><div class=\"diagram-node\">دفع PR<br><small class=\"diagram-muted\">bounded base&hellip;head diff</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">وكيل البرمجة<br><small class=\"diagram-muted\">Claude Code / Codex يقرأ diff</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">create-visual-recap</span><small class=\"diagram-muted\">publishes recap plan</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Chrome بلا واجهة<br><small class=\"diagram-muted\">light + dark screenshots</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">تعليق PR ثابت واحد<br><small class=\"diagram-muted\">inline screenshot + plan link</small></div></div><div class=\"diagram-foot diagram-muted\">Plus an informational <span class=\"diagram-pill\">Visual Recap</span> check &mdash; non-blocking, never required.</div>",
   "css": ".diagram-recap{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-recap .diagram-arrow{font-size:20px;line-height:1}.diagram-recap .center{display:flex;flex-direction:column;align-items:center;gap:4px;text-align:center}.diagram-recap .diagram-foot{flex-basis:100%;margin-top:10px;font-size:13px}"
 }
 ```
@@ -159,7 +159,7 @@ npx @agent-native/core@latest recap setup
 
 ```an-diagram title="بوابة موافقة Fork PR" summary="لا يحصل ممثلو العلاقات العامة في Fork على أي أسرار بشكل افتراضي؛ يعمل المؤلفون الموثوق بهم تلقائيًا، ويتطلب المساهمون الخارجيون ملصقًا جديدًا لملخص المشرف."
 {
-  "html": "<div class=\"diagram-fork\"><div class=\"diagram-node\">Fork PR opened<br><small class=\"diagram-muted\">main workflow has no secrets</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill ok\">Trusted author</span><small class=\"diagram-muted\">OWNER, MEMBER, or COLLABORATOR runs automatically</small></div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">Outside contributor</span><small class=\"diagram-muted\">maintainer reviews diff, then applies <code>recap</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\">Gate checks<br><small class=\"diagram-muted\">fork PR? &amp; trusted or fresh label?</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">Recap runs<br><small class=\"diagram-muted\">base-repo code only · fork diff is text input</small></div></div>",
+  "html": "<div class=\"diagram-fork\"><div class=\"diagram-node\">تم فتح PR من fork<br><small class=\"diagram-muted\">main workflow has no secrets</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill ok\">مؤلف موثوق</span><small class=\"diagram-muted\">OWNER أو MEMBER أو COLLABORATOR يعمل تلقائيًا</small></div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">مساهم خارجي</span><small class=\"diagram-muted\">يراجع المشرف diff ثم يطبقه <code>recap</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\">فحوصات البوابة<br><small class=\"diagram-muted\">fork PR? &amp; trusted or fresh label?</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">تشغيلات الملخص<br><small class=\"diagram-muted\">كود base-repo فقط · diff من fork هو إدخال نصي</small></div></div>",
   "css": ".diagram-fork{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-fork .diagram-arrow{font-size:20px;line-height:1}.diagram-fork .center{display:flex;flex-direction:column;align-items:center;gap:4px;text-align:center}.diagram-fork .diagram-card{display:flex;flex-direction:column;gap:6px;padding:12px 14px}"
 }
 ```
@@ -272,15 +272,15 @@ npx @agent-native/core@latest plan local serve --dir plans/pr-123-visual-recap -
 كل سطر غير فارغ وغير تعليقي هو إما **سلسلة فرعية حرفية** أو نمط **`/regex/flags`**:
 
 ```
-# Lines starting with # are comments.
+# الأسطر التي تبدأ بـ # هي تعليقات.
 
-# Literal substring — any diff line containing this string is allowed.
+# سلسلة فرعية حرفية — أي سطر مختلف يحتوي على هذه السلسلة مسموح به.
 sk-test-fixture1234567890abcdef
 
 # Regex pattern — written as /pattern/flags (JS syntax).
 /^.STRIPE_KEY=sk-test-/i
 
-# Another literal.
+# حرفية أخرى.
 EXAMPLE_API_KEY=placeholder-value
 ```
 
@@ -315,10 +315,10 @@ EXAMPLE_API_KEY=placeholder-value
 ```yaml
 name: PR Visual Recap
 
-# Thin caller — the full workflow logic lives in BuilderIO/agent-native.
-# Fixes and improvements reach this repo automatically on each run.
-# To pin a specific version for reproducibility replace '@main' with a
-# tag or SHA, e.g. '@v1.2.3' or '@abc1234'.
+# المتصل البسيط — منطق سير العمل الكامل موجود في BuilderIO/agent-native.
+# تصل الإصلاحات والتحسينات إلى هذا الريبو تلقائيًا في كل مرة يتم تشغيلها.
+# لتثبيت إصدار محدد قابل لإعادة الإنتاج، استبدل '@main' بـ
+# وسم أو SHA، مثل '@v1.2.3' أو '@abc1234'.
 
 on:
   pull_request:
@@ -351,10 +351,10 @@ jobs:
 ### التثبيت عبر CLI
 
 ```bash
-# Write the thin caller instead of the full copy:
+# اكتب المتصل الرقيق بدلاً من النسخة الكاملة:
 npx @agent-native/core@latest recap setup --reusable
 
-# Or with a pinned ref for reproducibility:
+# أو مع مرجع مثبت لقابلية التكرار:
 npx @agent-native/core@latest recap setup --reusable --ref v1.2.3
 ```
 

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

@@ -9,13 +9,13 @@ description: "حلقة المراقبة الداخلية/خطافات الدرا
 
 ```an-diagram title="حيث تطلق الخطافات الثلاثة أثناء الركض" summary="يراقب processOutputStream كل قطعة، وتستدعي أداة البوابات processOutputStep كل استجابة، ويسجل processOutputResult حكمًا في النهاية. يمكن إحباط أي خطاف باستخدام TripWire."
 {
-  "html": "<div class=\"diagram-proc\"><div class=\"diagram-node\" data-rough>stream chunks<br><small class=\"diagram-muted\">processOutputStream</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>per model response<br><small class=\"diagram-muted\">processOutputStep — gate tool calls</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>run end<br><small class=\"diagram-muted\">processOutputResult — verdict</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-pill warn\">abort() &rarr; TripWire &rarr; tripwire event</div></div>",
+  "html": "<div class=\"diagram-proc\"><div class=\"diagram-node\" data-rough>stream chunks<br><small class=\"diagram-muted\">processOutputStream</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>per model response<br><small class=\"diagram-muted\">processOutputStep — يضبط استدعاءات الأدوات</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>run end<br><small class=\"diagram-muted\">processOutputResult — الحكم</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-pill warn\">abort() &rarr; TripWire &rarr; tripwire event</div></div>",
   "css": ".diagram-proc{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-proc .diagram-arrow{font-size:22px;line-height:1}.diagram-proc .diagram-pill{flex-basis:100%}"
 }
 ```
 
 > [!WARNING]
-> المعالج هو **تكوين**، وليس أداة، وليس إجراءً، وليس تأليفًا DSL. تقوم المعالجات فقط بمراقبة وتعديل حالة نطاق الدفق الخاصة بها و`abort()`. ولا تحدد أبدًا سلوك التطبيق، أو تستبدل actions، أو تظهر للنموذج. تنتمي عمليات التطبيق إلى [actions](/docs/actions).
+> المعالج هو **تكوين**، وليس أداة، وليس إجراءً، وليس تأليفًا DSL. تقوم المعالجات فقط بمراقبة وتعديل حالة نطاق الدفق الخاصة بها و`abort()`. ولا تحدد أبدًا سلوك التطبيق، أو تستبدل actions, أو تظهر للنموذج. تنتمي عمليات التطبيق إلى [actions](/docs/actions).
 
 ## الخطافات {#hooks}
 

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

@@ -113,7 +113,7 @@ await deleteRun("run-id", "steve@builder.io");
 | `GET`    | `/_agent-native/runs/:id`         |
 | `DELETE` | `/_agent-native/runs/:id`         |
 
-```an-api title="List active runs" method="GET" path="/_agent-native/runs"
+```an-api title="قائمة عمليات التشغيل النشطة" method="GET" path="/_agent-native/runs"
 {
   "method": "GET",
   "path": "/_agent-native/runs",
@@ -182,13 +182,13 @@ event: run.progress.updated
 condition: "status is failed"
 mode: agentic
 ---
-Notify me that run {{runId}} has failed.
+إشعار me that run {{runId}} has failed.
 ```
 
 ## كيفية العمل {#internals}
 
 - **نطاق المالك** — يحتوي كل صف على عمود `owner`؛ يتم تصفية كل استعلام عليه. يرى المستخدمون عمليات التشغيل الخاصة بهم فقط.
-- **تكامل الاستقصاء** — تستدعي كل طفرة `recordChange()`، لذا يتم إبطال صحة القوالب التي تستخدم [`useDbSync`](/docs/client) تلقائيًا دون أي أسلاك إضافية.
+- **تكامل الاستقصاء** — تستدعي كل طفرة `recordChange()`, لذا يتم إبطال صحة القوالب التي تستخدم [`useDbSync`](/docs/client) تلقائيًا دون أي أسلاك إضافية.
 - **اسم الجدول** — يحتوي إطار العمل أيضًا على جدول `agent_runs` لتتبع دورة حياة دورة حياة الوكيل الداخلي للدردشة. يستخدم التقدم البدائي `progress_runs` للفصل بين الاهتمامين.
 - **تثبيت النسبة المئوية** — يتم تثبيت القيم على `[0, 100]` وتقريبها إلى عدد صحيح عند الكتابة.
 

package/docs/content/locales/ar-SA/pure-agent-apps.md

@@ -14,7 +14,7 @@ description: "التطبيقات التي يكون فيها الوكيل هو ا
 
 ```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 · email</div><div class=\"diagram-pill\">Scheduled job</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\">App-agent loop</span><small class=\"diagram-muted\">actions · sessions · app state in SQL</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Result returns<br><small class=\"diagram-muted\">to where it belongs</small></div></div>",
+  "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}"
 }
 ```

package/docs/content/locales/ar-SA/real-time-collaboration.md

@@ -38,7 +38,7 @@ 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; conflict-free merge, no coordinator</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">2 &middot; SQL canonical content</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-gated reconcile</span><small class=\"diagram-muted\">agent edits propagate via the SQL bump</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">4 &middot; Lead-client election</span><small class=\"diagram-muted\">exactly one tab applies the snapshot</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill ok\">5 &middot; SSE fast-path + polling</span><small class=\"diagram-muted\">~tens of ms, degrades to 2s poll anywhere</small></div></div>",
+  "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}"
 }
 ```
@@ -102,7 +102,7 @@ description: "تحرير تعاوني متعدد المستخدمين حيث ي
 
 ```an-diagram title="مساران للتحرير، أحدهما مدمج" summary="تدفق ضغطات المفاتيح البشرية Y.Doc → الخادم → SSE. تمر تعديلات الوكيل عبر SQL: يتم تحديث مطبات الإجراء عند تسوية العميل الرئيسي، ثم يُدخل التغيير مرة أخرى إلى Yjs."
 {
-  "html": "<div class=\"diagram-collab\"><div class=\"lane\"><span class=\"diagram-pill\">Human edit</span><div class=\"diagram-node\">Y.Doc update<br><small class=\"diagram-muted\">debounce ~80ms</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\">Agent edit</span><div class=\"diagram-node\">Action writes SQL<br><small class=\"diagram-muted\">bumps updatedAt</small></div><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\" data-rough>Lead client<br><small class=\"diagram-muted\">setContent into 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>",
+  "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}"
 }
 ```
@@ -248,13 +248,13 @@ useEffect(() => {
 يعد إجراء `edit-document` الخاص بقالب المحتوى هو الطريقة الأساسية التي يقوم بها الوكلاء بإجراء تغييرات على المستندات في الوضع التعاوني:
 
 ```bash
-# Single edit
+# تعديل فردي
 pnpm action edit-document --id doc123 --find "old text" --replace "new text"
 
-# Batch edits
+# التعديلات المجمعة
 pnpm action edit-document --id doc123 --edits '[{"find":"old","replace":"new"}]'
 
-# Delete text
+# حذف النص
 pnpm action edit-document --id doc123 --find "delete me" --replace ""
 ```
 
@@ -625,7 +625,7 @@ undoManager.redo(); // Shift+Cmd+Z
 ```an-callout
 {
   "tone": "risk",
-  "body": "**Same-region simultaneous rewrite is last-write-wins.** If the agent rewrites a passage while a human has unsaved edits in the *exact same region*, the lead-client snapshot can clobber the in-flight human edit. Edits in different regions always merge cleanly via the CRDT. For structured documents, use granular server-side merge to sidestep this entirely."
+  "body": "**إعادة الكتابة المتزامنة لنفس المنطقة هي الفوز الأخير.** إذا أعاد الوكيل كتابة مقطع بينما كان لدى الإنسان تعديلات غير محفوظة في *نفس المنطقة بالضبط*، يمكن للقطة العميل الرئيسي أن تعرقل التحرير البشري أثناء الرحلة. يتم دائمًا دمج التعديلات في المناطق المختلفة بشكل نظيف عبر CRDT. بالنسبة للمستندات المنظمة، استخدم الدمج الدقيق من جانب الخادم لتجنب ذلك تمامًا."
 }
 ```
 

package/docs/content/locales/ar-SA/recurring-jobs.md

@@ -17,12 +17,12 @@ description: "تعمل المطالبات المجدولة بواسطة Cron ع
 {
   "filename": "jobs/morning-digest.md",
   "language": "markdown",
-  "code": "---\nschedule: \"0 7 * * *\"\nenabled: true\nrunAs: creator\n---\n\n# Morning digest\n\nSummarize the emails received overnight. Group by sender domain.\nPin the top 3 threads that look like they need a reply today to the\n\"Needs reply\" label. Draft replies for any that are obvious.",
+  "code": "---\nschedule: \"0 7 * * *\"\nenabled: true\nrunAs: creator\n---\n\n# الملخص الصباحي\n\nتلخيص رسائل البريد الإلكتروني المستلمة خلال الليل. التجميع حسب مجال المرسل.\nقم بتثبيت أهم 3 سلاسل رسائل تبدو وكأنها تحتاج إلى رد اليوم في التصنيف\n\"يلزم الرد\". مسودة ردود على أي ردود واضحة.",
   "annotations": [
-    { "lines": "2", "label": "When", "note": "Standard 5-field cron — `0 7 * * *` is every day at 07:00." },
-    { "lines": "3", "label": "Pause switch", "note": "Flip to `false` to stop the job without deleting it." },
-    { "lines": "4", "label": "Identity", "note": "`creator` runs with the owner's identity and `ANTHROPIC_API_KEY`; `shared` uses the org's key." },
-    { "lines": "7-12", "label": "The prompt", "note": "The body is just a prompt — the agent runs it at each firing with all its normal tools and workspace context." }
+    { "lines": "2", "label": "متى", "note": "كرون قياسي ذو 5 حقول — `0 7 * * *` كل يوم في الساعة 07:00." },
+    { "lines": "3", "label": "مفتاح الإيقاف المؤقت", "note": "Flip to `false` to stop the job without deleting it." },
+    { "lines": "4", "label": "الهوية", "note": "`creator` runs with the owner's identity and `ANTHROPIC_API_KEY`; `shared` uses the org's key." },
+    { "lines": "7-12", "label": "الموجه", "note": "النص هو مجرد موجه — يقوم الوكيل بتشغيله عند كل إطلاق بكل أدواته العادية وسياق مساحة العمل." }
   ]
 }
 ```

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

@@ -23,7 +23,7 @@ description: "التوجيه المستند إلى الملفات لتطبيقا
 
 ```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\">pathless layout · persistent shell + agent sidebar</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>",
+"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}"
 }
 

package/docs/content/locales/ar-SA/sandbox-adapters.md

@@ -42,14 +42,14 @@ search: "المحولات، محول وضع الحماية، محول cli، رم
 
 ```an-diagram title="يحتفظ الوالد بالأسرار؛ يقوم المحول بتشغيل التعليمات البرمجية فقط" summary="يقوم رمز التشغيل ببناء الوحدة وتشغيل جسر الاسترجاع؛ يتلقى المحول وحدة غير سرية + حدود ويعيد stdout/stderr/exit."
 {
-  "html": "<div class=\"diagram-sandbox\"><div class=\"diagram-box\" data-rough><strong>Parent process</strong><small class=\"diagram-muted\">builds module · loopback bridge · env scrub · output format</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\">local child · Docker · remote · durable</small></div></div>",
+  "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}"
 }
 ```
 
 ## الواجهة {#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) الذي يحرر هذه الملفات مباشرة).
+يعيش خط التماس في قلب `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) الذي يحرر هذه الملفات مباشرة).
 
 ```an-file-tree title="نقطة وصل sandbox في core"
 {
@@ -135,7 +135,7 @@ registerSandboxAdapter(adapter)  →  AGENT_NATIVE_SANDBOX  →  local default
 يحدد المحول المضمن حسب المعرف. حاليًا يتم توصيل `local` (الافتراضي) فقط؛ تعود القيم غير المعروفة إلى المستوى المحلي بدلاً من فشل التشغيل.
 
 ```bash
-AGENT_NATIVE_SANDBOX=local   # the default — explicit
+AGENT_NATIVE_SANDBOX=local   # الافتراضي — صريح
 ```
 
 ### `registerSandboxAdapter()` {#register}

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

@@ -11,7 +11,7 @@ description: "نموذج الأمان لتطبيقات الوكيل الأصلي
 
 ```an-diagram title="الدفاع في طبقات" summary="يمتلك الإطار معظم سطح التهديد؛ أنت تمتلك شيئين - وضع علامات على الجداول لتحديد نطاق المدخلات الخارجية والتحقق من صحتها."
 {
-  "html": "<div class=\"sec-layers\"><div class=\"diagram-card free\"><span class=\"diagram-pill ok\">Framework owns</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\">You own</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>",
+  "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}"
 }
 ```
@@ -26,7 +26,7 @@ description: "نموذج الأمان لتطبيقات الوكيل الأصلي
 
 يترك هذا سطحًا صغيرًا عليك التفكير فيه:
 
-- **أ. ضع علامة على جداولك لتحديد النطاق.** أضف `owner_email` (و `org_id` لبيانات الفريق) عبر [`ownableColumns()`](#data-scoping)، وقم بتوجيه Drizzle للقراءة/الكتابة من خلال [access guards](#access-guards).
+- **أ. ضع علامة على جداولك لتحديد النطاق.** أضف `owner_email` (و `org_id` لبيانات الفريق) عبر [`ownableColumns()`](#data-scoping), وقم بتوجيه Drizzle للقراءة/الكتابة من خلال [access guards](#access-guards).
 - **ب. التحقق من صحة المدخلات الخارجية وتوجيهها.** أعط كل إجراء Zod [`schema:`](#input-validation)، وأرسل أي جلب من جانب الخادم للمستخدم/الوكيل URL من خلال [SSRF guard](#ssrf).
 
 احصل على هذين الأمرين بشكل صحيح والباقي هو الإعدادات الافتراضية. [Production Checklist](#production-checklist) هو تأكيد من صفحة واحدة قبل الشحن.
@@ -86,7 +86,7 @@ await exec(`INSERT INTO notes (title) VALUES ('${title}')`);
 ```an-callout
 {
   "tone": "risk",
-  "body": "Never build SQL by string concatenation or template literals. Pass user input as `args` to `exec` / `db-query`, or use Drizzle — both always parameterize. The `pnpm guards` checks catch unscoped and concatenated queries at CI time."
+  "body": "لا تقم أبدًا بإنشاء SQL عن طريق تسلسل السلسلة أو القيم الحرفية للقالب. قم بتمرير إدخال المستخدم كـ `args` إلى `exec` / `db-query`، أو استخدم Drizzle — كلاهما يحددان المعلمات دائمًا. تقوم عمليات التحقق `pnpm guards` بالتقاط الاستعلامات غير ذات النطاق والمتسلسلة في وقت CI."
 }
 ```
 
@@ -97,7 +97,7 @@ await exec(`INSERT INTO notes (title) VALUES ('${title}')`);
 - لا تستخدم أبدًا `dangerouslySetInnerHTML` مع المحتوى الذي يتحكم فيه المستخدم
 - لا تستخدم مطلقًا `innerHTML` أو `eval()` أو `document.write()`
 - لتحرير النص المنسق، استخدم TipTap (تبعية إطار العمل) — حيث يتم التنقيح من خلال مخططه
-- لعرض تخفيض السعر، استخدم `react-markdown` - فهو يتحول إلى عناصر React بأمان
+- لعرض Markdown، استخدم `react-markdown` - فهو يتحول إلى عناصر React بأمان
 
 ## الجلب من جانب الخادم (SSRF) {#ssrf}
 
@@ -125,7 +125,7 @@ session.orgId → AGENT_ORG_ID → SQL row scoping
 
 ```an-diagram title="خط أنابيب النطاق" summary="لا يلمس الوكيل SQL الجداول الأساسية مباشرة أبدًا - فهو يقرأ من خلال عرض مؤقت محدد للهوية الحالية، لذلك يمكن لاسم الجدول المجرد إرجاع الصفوف المملوكة فقط."
 {
-  "html": "<div class=\"scope-pipe\"><div class=\"diagram-node\">Signed-in session<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\">Agent SQL<br><small class=\"diagram-muted\">bare table names only</small></div></div>",
+  "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}"
 }
 ```
@@ -189,7 +189,7 @@ export const projects = table("projects", {
 });
 ```
 
-```an-schema title="What ownableColumns() adds" summary="The three columns that make a table tenant-aware and shareable."
+```an-schema title="What ownableColumns() adds" summary="الأعمدة الثلاثة التي تجعل الجدول مدركًا للمستأجر وقابلاً للمشاركة."
 {
   "entities": [
     {
@@ -198,8 +198,8 @@ export const projects = table("projects", {
       "note": "Any table that spreads ...ownableColumns()",
       "fields": [
         { "name": "owner_email", "type": "text", "nullable": false, "note": "Creator. Auto-filled by write actions; auto-injected on INSERT." },
-        { "name": "org_id", "type": "text", "nullable": true, "note": "Owner's active org at creation. Drives org-visibility checks." },
-        { "name": "visibility", "type": "enum", "nullable": false, "note": "private | org | public — coarse default, defaults to private." }
+        { "name": "org_id", "type": "text", "nullable": true, "note": "مؤسسة المالك النشطة عند الإنشاء. يقود عمليات التحقق من رؤية المؤسسة." },
+        { "name": "visibility", "type": "enum", "nullable": false, "note": "خاص | منظمة | عام - افتراضي خشن، افتراضي خاص." }
       ]
     }
   ]
@@ -219,8 +219,8 @@ export const projects = table("projects", {
 ### التحقق
 
 ```bash
-pnpm action db-check-scoping           # Check all tables have owner_email
-pnpm action db-check-scoping --require-org  # Also require org_id
+pnpm action db-check-scoping           # تحقق من أن كافة الجداول تحتوي على Owner_email
+pnpm action db-check-scoping --require-org  # يتطلب أيضًا org_id
 ```
 
 ## إدارة الأسرار {#secrets}