@agent-native/core 0.76.7 → 0.76.8

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

@@ -12,9 +12,9 @@ description: "امنح الوكيل وصولاً منظمًا إلى أي أدا
 
 يحتوي محول CLI على أداة سطر أوامر واحدة (`gh`، `ffmpeg`، `stripe`، `aws`) حتى يتمكن الوكيل من اكتشافها والتحقق من تثبيتها وتشغيلها باستخدام نتيجة كود stdout/stderr/exit متسقة. بدون هذا التماس، يعيد كل نص برمجي اختراع كيفية استدعاء CLI وتحليل مخرجاته.
 
-```an-diagram title="CLI adapter → registry → action surface" summary="ShellCliAdapter wraps a binary; CliRegistry collects adapters for discovery; defineAction exposes one call on the agent + UI action surface."
+```an-diagram title="CLI محول → التسجيل → سطح العمل" summary="ShellCliAdapter يلتف ثنائي؛ يقوم CliRegistry بجمع المحولات لاكتشافها؛ يكشف defineAction عن مكالمة واحدة على سطح عمل الوكيل + واجهة المستخدم."
 {
-  "html": "<div class=\"diagram-cli\"><div class=\"diagram-node\" data-rough>gh · ffmpeg · stripe<br><small class=\"diagram-muted\">command-line tools</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>ShellCliAdapter<br><small class=\"diagram-muted\">isAvailable · execute</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough>CliRegistry<br><small class=\"diagram-muted\">describe() for discovery</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">defineAction</div></div>",
+  "html": "<div class=\"diagram-cli\"><div class=\"diagram-node\" data-rough>gh · ffmpeg · الشريط<br><small class=\"diagram-muted\">أدوات سطر الأوامر</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>ShellCliAdapter<br><small class=\"diagram-muted\">متاح · تنفيذ</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough>كليريجستري<br><small class=\"diagram-muted\">وصف () للاكتشاف</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">defineAction</div></div>",
   "css": ".diagram-cli{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-cli .diagram-arrow{font-size:22px;line-height:1}.diagram-cli .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```

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

@@ -15,9 +15,9 @@ description: "الخطافات والأدوات المساعدة React لتطب
 
 الطريقة الأساسية لقراءة بيانات التطبيق وكتابتها من المتصفح هي من خلال خطافات الإجراء. لا تكتب أبدًا مكالمات `fetch` يدويًا إلى مسارات `/_agent-native/*` - استخدم المساعدين المحددين بدلاً من ذلك (راجع [Actions](/docs/actions)).
 
-```an-diagram title="The browser data loop" summary="Hooks read and write through actions; useDbSync watches the database so agent and background writes refetch the same caches automatically."
+```an-diagram title="حلقة بيانات المتصفح" summary="خطافات القراءة والكتابة من خلال الإجراءات؛ يراقب useDbSync قاعدة البيانات حتى يقوم الوكيل والخلفية بإعادة جلب نفس ذاكرات التخزين المؤقت تلقائيًا."
 {
-  "html": "<div class=\"diagram-client\"><div class=\"diagram-col\"><div class=\"diagram-node\">useActionQuery<br><small class=\"diagram-muted\">cached read</small></div><div class=\"diagram-node\">useActionMutation<br><small class=\"diagram-muted\">write + invalidate</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-box\" data-rough>Actions<br><small class=\"diagram-muted\">/_agent-native/actions/*</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-panel\" data-rough><strong>SQL database</strong></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-pill ok\">useDbSync &rarr; refetch on change</div></div>",
+  "html": "<div class=\"diagram-client\"><div class=\"diagram-col\"><div class=\"diagram-node\">useActionQuery<br><small class=\"diagram-muted\">قراءة مخبأة</small></div><div class=\"diagram-node\">useActionMutation<br><small class=\"diagram-muted\">كتابة + إبطال</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-box\" data-rough>Actions<br><small class=\"diagram-muted\">/_agent-native/actions/*</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-panel\" data-rough><strong>SQL قاعدة البيانات</strong></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-pill ok\">useDbSync &rarr; الإعادة على التغيير</div></div>",
   "css": ".diagram-client{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-client .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-client .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -376,9 +376,9 @@ function DashboardView({ id }) {
 - ** الطفرات التي بدأتها UI:** عند تنفيذ إجراء من UI باستخدام `useActionMutation`، تقوم الطفرة على الفور بإطلاق حدث محلي مع `source: "action"` عند النجاح. يؤدي هذا إلى تشغيل **إعادة جلب فورية ومتفائلة** لجميع مفاتيح الاستعلام اعتمادًا على هذا الإجراء، مع تجنب التأخير البصري.
 - **طفرات الخلفية أو الوكيل:** عندما يقوم وكيل الذكاء الاصطناعي أو خطاف الويب أو عامل الخلفية بتغيير البيانات، يتم بث التحديث إلى العميل. يلتقط `useDbSync` الخاص بالعميل هذا إما على الفور عبر SSE (الأحداث المرسلة من الخادم) أو يعود إلى **علامة الاستقصاء التي تبلغ ثانيتين**. ثم يبرز إصدار مفتاح الاستعلام، مما يؤدي إلى إعادة جلب الخلفية.
 
-```an-diagram title="Two paths to a refetch" summary="A local mutation invalidates its own caches instantly; a remote write reaches this tab over SSE, or the polling tick as a fallback."
+```an-diagram title="طريقان للإعادة" summary="تؤدي الطفرة المحلية إلى إبطال ذاكرة التخزين المؤقت الخاصة بها على الفور؛ تصل الكتابة عن بعد إلى علامة التبويب هذه عبر SSE، أو علامة الاستقصاء كإجراء احتياطي."
 {
-  "html": "<div class=\"diagram-latency\"><div class=\"diagram-col\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill ok\">This tab</span><strong>useActionMutation</strong><small class=\"diagram-muted\">fires source: \"action\" on success &rarr; instant local refetch</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">Agent · webhook · other tab</span><strong>Remote write</strong><small class=\"diagram-muted\">SSE push, or the ~2s polling tick as fallback &rarr; version bumps &rarr; background refetch</small></div></div></div>",
+  "html": "<div class=\"diagram-latency\"><div class=\"diagram-col\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill ok\">علامة التبويب هذه</span><strong>useActionMutation</strong><small class=\"diagram-muted\">مصدر الحرائق: \"العمل\" على النجاح &rarr; الاسترداد المحلي الفوري</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">الوكيل · خطاف الويب · علامة تبويب أخرى</span><strong>الكتابة عن بعد</strong><small class=\"diagram-muted\">دفع SSE، أو علامة الاستقصاء ~2s كبديل &rarr; المطبات الإصدار &rarr; إعادة الخلفية</small></div></div></div>",
   "css": ".diagram-latency .diagram-col{display:flex;flex-direction:column;gap:12px}.diagram-latency .diagram-card{display:flex;flex-direction:column;gap:4px;padding:14px 16px}"
 }
 ```

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

@@ -51,9 +51,9 @@ description: "ابتكر منتج SaaS فعالاً واجعله ملكك - بم
 
 المسار من "أريد SaaS الخاص بي" إلى "لدي SaaS الخاص بي" قصير:
 
-```an-diagram title="Fork and customize" summary="Pick a finished product, brand it, evolve it in plain English, and ship it to your own domain."
+```an-diagram title="شوكة وتخصيص" summary="اختر منتجًا نهائيًا، وقم بوضع علامة تجارية عليه، وقم بتطويره بلغة إنجليزية بسيطة، ثم اشحنه إلى النطاق الخاص بك."
 {
-  "html": "<div class=\"diagram-fork\"><div class=\"diagram-card\"><span class=\"diagram-pill\">1</span><strong>Pick</strong><small class=\"diagram-muted\">a complete template</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">2</span><strong>Brand</strong><small class=\"diagram-muted\">name, colors, logo, copy</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">3</span><strong>Customize</strong><small class=\"diagram-muted\">ask the agent &#8635;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill ok\">4</span><strong>Ship</strong><small class=\"diagram-muted\">your own domain</small></div></div>",
+  "html": "<div class=\"diagram-fork\"><div class=\"diagram-card\"><span class=\"diagram-pill\">1</span><strong>يختار</strong><small class=\"diagram-muted\">قالب كامل</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">2</span><strong>ماركة</strong><small class=\"diagram-muted\">الاسم والألوان والشعار والنسخة</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">3</span><strong>تخصيص</strong><small class=\"diagram-muted\">اسأل الوكيل &#8635;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill ok\">4</span><strong>سفينة</strong><small class=\"diagram-muted\">المجال الخاص بك</small></div></div>",
   "css": ".diagram-fork{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-fork .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:130px}.diagram-fork .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -74,9 +74,9 @@ description: "ابتكر منتج SaaS فعالاً واجعله ملكك - بم
 
 النتيجة: مرونة على مستوى الكود Claude لكل مستخدم، مع اقتصاديات نشر SaaS العادية.
 
-```an-diagram title="Why per-user forks scale" summary="Two ideas keep the fork-and-customize model practical: the agent does the maintenance, and per-user customization lives in SQL — not in per-user code."
+```an-diagram title="لماذا مقياس الشوكات لكل مستخدم" summary="هناك فكرتان تجعلان نموذج الشوكة والتخصيص عمليًا: يقوم الوكيل بالصيانة، ويعيش التخصيص لكل مستخدم في SQL - وليس في التعليمات البرمجية لكل مستخدم."
 {
-  "html": "<div class=\"diagram-why\"><div class=\"diagram-panel\" data-rough><strong>Shared codebase</strong><small class=\"diagram-muted\">one app, deployed once</small><div class=\"diagram-pill accent\">agent does the maintenance</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-panel\" data-rough><strong>Per-user layer in SQL</strong><small class=\"diagram-muted\">skills · memory · instructions · MCP · sub-agents</small><div class=\"diagram-pill ok\">no per-user code</div></div></div>",
+  "html": "<div class=\"diagram-why\"><div class=\"diagram-panel\" data-rough><strong>قاعدة التعليمات البرمجية المشتركة</strong><small class=\"diagram-muted\">تطبيق واحد، تم نشره مرة واحدة</small><div class=\"diagram-pill accent\">الوكيل يقوم بالصيانة</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-panel\" data-rough><strong>طبقة لكل مستخدم في SQL</strong><small class=\"diagram-muted\">المهارات · الذاكرة · التعليمات · SQL · الوكلاء الفرعيون</small><div class=\"diagram-pill ok\">لا يوجد رمز لكل مستخدم</div></div></div>",
   "css": ".diagram-why{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-why .diagram-panel{display:flex;flex-direction:column;gap:8px;padding:14px 18px;min-width:240px;flex:1}.diagram-why .diagram-arrow{font-size:24px;line-height:1}"
 }
 ```

package/docs/content/locales/ar-SA/code-agents-ui.md

@@ -25,9 +25,9 @@ description: "قم بإنشاء وتخصيص أسطح التعليمات الب
 - **سطح المكتب**: تضيف علامة التبويب Code في الشريط الجانبي الأيسر تشغيل الوحدة الطرفية الأصلي، وعروض الويب للتطبيق، والروابط العميقة لسطح المكتب أثناء استخدام نفس نموذج التشغيل.
 - **UI المشتركة**: يعرض `@agent-native/code-agents-ui` سطح React القابل لإعادة الاستخدام.
 
-```an-diagram title="Three layers over one run store" summary="CLI, Desktop, and the shared UI are different surfaces over the same file-backed run store and executor; hosts adapt it via the CodeAgentsHost contract."
+```an-diagram title="ثلاث طبقات فوق مخزن تشغيل واحد" summary="CLI، Desktop، وواجهة المستخدم المشتركة هي أسطح مختلفة على نفس مخزن التشغيل والمنفذ المدعوم بالملف؛ يقوم المضيفون بتكييفه عبر عقد CodeAgentsHost."
 {
-  "html": "<div class=\"diagram-layers\"><div class=\"diagram-row\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">CLI</span><small class=\"diagram-muted\">start · resume · status · stop</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Desktop</span><small class=\"diagram-muted\">native terminal · webviews · deep links</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">Shared UI</span><small class=\"diagram-muted\">@agent-native/code-agents-ui</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill\">CodeAgentsHost</span><small class=\"diagram-muted\">host contract</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>File-backed run store + executor<br><small class=\"diagram-muted\">@agent-native/core/code-agents</small></div></div>",
+  "html": "<div class=\"diagram-layers\"><div class=\"diagram-row\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">CLI</span><small class=\"diagram-muted\">البدء · الاستئناف · الحالة · التوقف</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Desktop</span><small class=\"diagram-muted\">المحطة الأصلية · مشاهدات الويب · الروابط العميقة</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">واجهة المستخدم المشتركة</span><small class=\"diagram-muted\">@agent-native/code-agents-ui</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill\">CodeAgentsHost</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\">@agent-native/core/code-agents</small></div></div>",
   "css": ".diagram-layers{display:flex;flex-direction:column;gap:10px;align-items:center}.diagram-layers .diagram-row{display:flex;gap:12px;flex-wrap:wrap;justify-content:center}.diagram-layers .diagram-card{display:flex;flex-direction:column;gap:4px;padding:12px 16px}.diagram-layers .diagram-arrow{font-size:22px;line-height:1}.diagram-layers .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -373,9 +373,9 @@ npx @agent-native/core@latest migrate ./my-next-app --out ../migrated-app   # sh
 5. يقرأ الهاتف المحمول `hosts` و`runs` و`transcript` من Dispatch؛ لا يتحدث أبدًا
    مباشرة إلى سطح المكتب.
 
-```an-diagram title="Remote Dispatch is outbound-only" summary="Mobile never talks to the desktop directly. Desktop long-polls Dispatch, claims commands, drives the local run store, and mirrors results back."
+```an-diagram title="البعيد Dispatch للخارج فقط" summary="لا يتحدث الهاتف المحمول مطلقًا مع سطح المكتب مباشرة. Desktop الاستقصاءات الطويلة Dispatch، يطالب بالأوامر، ويحرك مخزن التشغيل المحلي، ويعكس النتائج مرة أخرى."
 {
-  "html": "<div class=\"diagram-remote\"><div class=\"diagram-node\" data-rough>Mobile / Telegram<br><small class=\"diagram-muted\">/code · sessions</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Dispatch relay<br><small class=\"diagram-muted\">hosts · runs · transcript</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div><div class=\"diagram-node\" data-rough>Desktop<br><small class=\"diagram-muted\">long-polls · claims · drives run store</small></div></div>",
+  "html": "<div class=\"diagram-remote\"><div class=\"diagram-node\" data-rough>موبايل / تليجرام<br><small class=\"diagram-muted\">/الكود · الجلسات</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Dispatch التتابع<br><small class=\"diagram-muted\">المضيفين · يدير · نسخة</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div><div class=\"diagram-node\" data-rough>Desktop<br><small class=\"diagram-muted\">استطلاعات الرأي الطويلة · المطالبات · محركات الأقراص التي تدير المتجر</small></div></div>",
   "css": ".diagram-remote{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-remote .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```

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

@@ -25,9 +25,9 @@ import { ResourcesPanel } from "@agent-native/core/client/resources";
 `@agent-native/core/client` أو مسار فرعي `@agent-native/core/client/*` مركّز
 لذلك يختار القائمون على التجميع الإدخال الآمن للمتصفح.
 
-```an-diagram title="Drop down a layer, not out of the framework" summary="Each layer keeps the same runtime — actions, thread state, and SQL-backed sync — while giving you more control over the chrome."
+```an-diagram title="المنسدلة طبقة، وليس خارج الإطار" summary="تحتفظ كل طبقة بنفس وقت التشغيل — الإجراءات، وحالة مؤشر الترابط، ومزامنة SQL-backed — بينما تمنحك مزيدًا من التحكم في Chrome."
 {
-  "html": "<div class=\"diagram-layers\"><div class=\"diagram-card layer\"><span class=\"diagram-pill accent\">&lt;AgentSidebar&gt;</span><small class=\"diagram-muted\">Whole sidebar around your app. The 80% case.</small></div><div class=\"diagram-card layer l2\"><span class=\"diagram-pill\">&lt;AgentPanel&gt; &middot; &lt;AgentChatSurface&gt;</span><small class=\"diagram-muted\">The panel or a chat page in your own layout.</small></div><div class=\"diagram-card layer l3\"><span class=\"diagram-pill\">&lt;AssistantChat&gt; + runtime</span><small class=\"diagram-muted\">Own the chrome; optionally pass a BYO AgentChatRuntime.</small></div><div class=\"diagram-card layer l4\"><span class=\"diagram-pill\">&lt;PromptComposer&gt; &middot; &lt;AgentConversation&gt;</span><small class=\"diagram-muted\">Composer and transcript primitives only.</small></div><div class=\"diagram-rail\" data-rough>Same runtime: actions &middot; thread state &middot; SQL-backed sync</div></div>",
+  "html": "<div class=\"diagram-layers\"><div class=\"diagram-card layer\"><span class=\"diagram-pill accent\">&lt;AgentSidebar&gt;</span><small class=\"diagram-muted\">الشريط الجانبي بأكمله حول تطبيقك. حالة 80%.</small></div><div class=\"diagram-card layer l2\"><span class=\"diagram-pill\">&lt;AgentPanel&gt; &middot; &lt;AgentChatSurface&gt;</span><small class=\"diagram-muted\">اللوحة أو صفحة الدردشة في التخطيط الخاص بك.</small></div><div class=\"diagram-card layer l3\"><span class=\"diagram-pill\">&lt;AssistantChat&gt; + وقت التشغيل</span><small class=\"diagram-muted\">امتلك الكروم؛ قم بتمرير BYO AgentChatRuntime بشكل اختياري.</small></div><div class=\"diagram-card layer l4\"><span class=\"diagram-pill\">&lt;PromptComposer&gt; &middot; &lt;محادثة الوكيل&gt;</span><small class=\"diagram-muted\">الملحن والنسخة الأولية فقط.</small></div><div class=\"diagram-rail\" data-rough>نفس وقت التشغيل: الإجراءات &middot; حالة الخيط &middot; BYO-backed مزامنة</div></div>",
   "css": ".diagram-layers{display:flex;flex-direction:column;gap:10px}.diagram-layers .layer{display:flex;flex-direction:column;gap:4px;padding:12px 14px}.diagram-layers .l2{margin-inline-start:24px}.diagram-layers .l3{margin-inline-start:48px}.diagram-layers .l4{margin-inline-start:72px}.diagram-layers .diagram-rail{margin-top:6px;padding:10px 14px;text-align:center}"
 }
 ```
@@ -178,9 +178,9 @@ import { PromptComposer } from "@agent-native/core/client/composer";
 | `useCollaborativeMap()` / `useCollaborativeArray()` | جرّب حالة Y.Map/Y.Array المنظمة عندما يكون تعاون نص النص المنسق غير مناسب. |
 | `dedupeCollabUsersByEmail()`                        | إنشاء مجموعة صور رمزية مخصصة بدون علامات تبويب مكررة لنفس المستخدم.        |
 
-```an-diagram title="Presence: humans and the agent share one awareness layer" summary="useCollaborativeDoc owns the awareness instance; client hooks publish cursors and selections; server helpers let an agent action appear as a live participant."
+```an-diagram title="الحضور: يتشارك البشر والوكيل في طبقة وعي واحدة" summary="useCollaborativeDoc يمتلك مثيل الوعي؛ تقوم خطافات العميل بنشر المؤشرات والتحديدات؛ يسمح مساعدو الخادم بإجراء الوكيل بالظهور كمشارك مباشر."
 {
-  "html": "<div class=\"diagram-presence\"><div class=\"diagram-col\"><div class=\"diagram-node\">Humans<br><small class=\"diagram-muted\">usePresence &middot; cursors, selection</small></div><div class=\"diagram-node diagram-accent\">Agent action<br><small class=\"diagram-muted\">agentUpdateSelection()</small></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\">useCollaborativeDoc</span><small class=\"diagram-muted\">awareness layer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">&lt;PresenceBar&gt; &middot; &lt;LiveCursorOverlay&gt;<br><small class=\"diagram-muted\">render everyone, agent included</small></div></div>",
+  "html": "<div class=\"diagram-presence\"><div class=\"diagram-col\"><div class=\"diagram-node\">البشر<br><small class=\"diagram-muted\">usePresence &middot; المؤشرات، الاختيار</small></div><div class=\"diagram-node diagram-accent\">عمل الوكيل<br><small class=\"diagram-muted\">وكيلUpdateSelection()</small></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\">useCollaborativeDoc</span><small class=\"diagram-muted\">طبقة الوعي</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">&lt;شريط الوجود&gt; &middot; &lt;LiveCursorOverlay&gt;<br><small class=\"diagram-muted\">تقديم الجميع، بما في ذلك الوكيل</small></div></div>",
   "css": ".diagram-presence{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-presence .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-presence .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px}.diagram-presence .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```

package/docs/content/locales/ar-SA/context-awareness.md

@@ -24,9 +24,9 @@ description: "كيف يعرف الوكيل ما ينظر إليه المستخد
 5. **التسليم الفوري** -- تستدعي عناصر التحكم UI `sendToAgentChat()` عندما تتحول النقرة إلى وكيل
 6. **`navigate`** -- أمر يتم تنفيذه مرة واحدة من الوكيل لإخبار UI بالمكان الذي يجب أن يذهب إليه
 
-```an-diagram title="How the agent sees what you see" summary="The UI writes lightweight state keys; view-screen hydrates them into real records; the agent can write navigate back to move the UI."
+```an-diagram title="كيف يرى الوكيل ما تراه" summary="تكتب واجهة المستخدم مفاتيح حالة خفيفة الوزن؛ تعمل شاشة العرض على ترطيبها وتحويلها إلى سجلات حقيقية؛ يمكن للوكيل كتابة التنقل مرة أخرى لتحريك واجهة المستخدم."
 {
-  "html": "<div class=\"diagram-ctx\"><div class=\"diagram-card col\"><span class=\"diagram-pill\">UI writes</span><div class=\"diagram-node\">navigation<br><small class=\"diagram-muted\">view, open ids</small></div><div class=\"diagram-node\">__url__<br><small class=\"diagram-muted\">shareable filters</small></div><div class=\"diagram-node\">selection<br><small class=\"diagram-muted\">rows, blocks, shapes</small></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\">view-screen</span><small class=\"diagram-muted\">reads state &middot; fetches records</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Agent acts<br><small class=\"diagram-muted\">on the real object</small></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box diagram-accent\">navigate<br><small class=\"diagram-muted\">agent moves the UI</small></div></div>",
+  "html": "<div class=\"diagram-ctx\"><div class=\"diagram-card col\"><span class=\"diagram-pill\">يكتب واجهة المستخدم</span><div class=\"diagram-node\">ملاحة<br><small class=\"diagram-muted\">عرض، معرفات مفتوحة</small></div><div class=\"diagram-node\">__url__<br><small class=\"diagram-muted\">مرشحات قابلة للمشاركة</small></div><div class=\"diagram-node\">اختيار<br><small class=\"diagram-muted\">الصفوف والكتل والأشكال</small></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\">view-screen</span><small class=\"diagram-muted\">يقرأ الدولة &middot; جلب السجلات</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">تصرفات الوكيل<br><small class=\"diagram-muted\">على الكائن الحقيقي</small></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box diagram-accent\">التنقل<br><small class=\"diagram-muted\">يقوم الوكيل بنقل واجهة المستخدم</small></div></div>",
   "css": ".diagram-ctx{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-ctx .col{display:flex;flex-direction:column;gap:8px;padding:14px}.diagram-ctx .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px}.diagram-ctx .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -191,16 +191,32 @@ await setClientAppState(
 
 يجب أن يحتوي كل قالب على إجراء `view-screen`. فهو يقرأ حالة التنقل والاختيار، ويجلب البيانات ذات الصلة، ويعيد لقطة لما يراه المستخدم. هذه هي عيون الوكيل.
 
-```an-annotated-code title="view-screen — the agent's eyes"
+```an-annotated-code title="شاشة العرض - عيون الوكيل"
 {
   "filename": "actions/view-screen.ts",
   "language": "ts",
   "code": "import { defineAction } from \"@agent-native/core/action\";\nimport { readAppState } from \"@agent-native/core/application-state\";\nimport { eq, inArray } from \"drizzle-orm\";\nimport { z } from \"zod\";\nimport { getDb, schema } from \"../server/db/index.js\";\n\nexport default defineAction({\n  description:\n    \"See what the user is currently looking at on screen.\",\n  schema: z.object({}),\n  http: false,\n  run: async () => {\n    const navigation = (await readAppState(\"navigation\")) as any;\n    const selection = (await readAppState(\"selection\")) as any;\n    const screen: Record<string, unknown> = {};\n    if (navigation) screen.navigation = navigation;\n    if (selection) screen.selection = selection;\n\n    const db = getDb();\n\n    // Fetch data based on what the user is viewing\n    if (navigation?.view === \"inbox\") {\n      screen.emailList = await db\n        .select()\n        .from(schema.emails)\n        .where(eq(schema.emails.label, navigation.label));\n    }\n    if (navigation?.threadId) {\n      screen.thread = await db\n        .select()\n        .from(schema.threads)\n        .where(eq(schema.threads.id, navigation.threadId));\n    }\n    if (selection?.kind === \"email.messages\") {\n      screen.selectedMessages = await db\n        .select()\n        .from(schema.emails)\n        .where(inArray(schema.emails.id, selection.messageIds));\n    }\n\n    if (Object.keys(screen).length === 0) {\n      return \"No application state found. Is the app running?\";\n    }\n    return screen;\n  },\n});",
   "annotations": [
-    { "lines": "10-11", "label": "Tool surface", "note": "The agent reads this description to know it can call `view-screen` to see the current UI." },
-    { "lines": "13", "label": "http: false", "note": "Internal action — not exposed over HTTP. The agent and `pnpm action` call it, not the browser." },
-    { "lines": "15-16", "label": "Read state", "note": "Pulls the lightweight `navigation` and `selection` keys the UI wrote." },
-    { "lines": "23-37", "label": "Hydrate", "note": "Turns those IDs into **fresh** records straight from SQL, so the agent verifies the live object before acting." }
+    {
+      "lines": "10-11",
+      "label": "سطح الأداة",
+      "note": "يقرأ الوكيل هذا الوصف ليعرف أنه يمكنه الاتصال بـ `view-screen` لرؤية واجهة المستخدم الحالية."
+    },
+    {
+      "lines": "13",
+      "label": "http: خطأ",
+      "note": "الإجراء الداخلي — لم يتم الكشف عنه عبر HTTP. الوكيل و `pnpm action` يسمونه، وليس المتصفح."
+    },
+    {
+      "lines": "15-16",
+      "label": "قراءة الدولة",
+      "note": "يسحب المفاتيح `navigation` و`selection` خفيفة الوزن التي كتبتها واجهة المستخدم."
+    },
+    {
+      "lines": "23-37",
+      "label": "هيدرات",
+      "note": "يحول هذه المعرفات إلى سجلات **حديثة** مباشرة من SQL، بحيث يتحقق الوكيل من الكائن المباشر قبل التصرف."
+    }
   ]
 }
 ```
@@ -365,9 +381,9 @@ useDbSync({
 - عند معالجة أحداث المزامنة، يقوم UI بتصفية الأحداث المطابقة لقيمة `ignoreSource` الخاصة به -- لذلك لا يقوم بإعادة جلب البيانات التي كتبها للتو
 - لا تزال الأحداث من الوكلاء وعلامات التبويب الأخرى وactions تحدث بشكل طبيعي
 
-```an-diagram title="Source tagging stops self-refetch jitter" summary="A tab ignores sync events stamped with its own TAB_ID, but still reacts to agent and other-tab writes."
+```an-diagram title="تعمل علامات المصدر على إيقاف عدم استقرار الإرجاع الذاتي" summary="تتجاهل علامة التبويب أحداث المزامنة التي تم ختمها بـ TAB_ID الخاص بها، ولكنها لا تزال تتفاعل مع عمليات كتابة الوكيل وعلامات التبويب الأخرى."
 {
-  "html": "<div class=\"diagram-jitter\"><div class=\"diagram-node\">This tab writes<br><small class=\"diagram-muted\">X-Request-Source: TAB_ID</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Server stores source<br>on the event</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill warn\">source == TAB_ID &rarr; ignored</div><small class=\"diagram-muted\">no refetch, no flicker</small><div class=\"diagram-pill ok\">agent / other tab &rarr; applied</div><small class=\"diagram-muted\">UI updates live</small></div></div>",
+  "html": "<div class=\"diagram-jitter\"><div class=\"diagram-node\">علامة التبويب هذه تكتب<br><small class=\"diagram-muted\">طلب X-المصدر: TAB_ID</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>مصدر مخازن الخادم<br>على الحدث</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill warn\">المصدر == TAB_ID &rarr; تم تجاهله</div><small class=\"diagram-muted\">لا الإعادة، لا وميض</small><div class=\"diagram-pill ok\">وكيل / علامة التبويب الأخرى &rarr; مُطبَّق</div><small class=\"diagram-muted\">تحديثات واجهة المستخدم مباشرة</small></div></div>",
   "css": ".diagram-jitter{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-jitter .col{display:flex;flex-direction:column;gap:6px;padding:14px}.diagram-jitter .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```

package/docs/content/locales/ar-SA/creating-templates.md

@@ -39,23 +39,23 @@ npx @agent-native/core@latest create my-platform
 
 يتبع كل قالب نفس التنسيق العام:
 
-```an-file-tree title="Template project layout"
+```an-file-tree title="بنية مشروع ال template"
 {
   "title": "my-template/",
   "entries": [
-    { "path": "app/", "note": "React frontend" },
-    { "path": "app/root.tsx", "note": "HTML shell and providers" },
-    { "path": "app/routes/", "note": "React Router file routes" },
-    { "path": "app/components/", "note": "Template UI" },
-    { "path": "app/hooks/", "note": "UI state and data hooks" },
-    { "path": "actions/", "note": "defineAction operations — the single source of truth" },
-    { "path": "server/db/schema.ts", "note": "Drizzle schema" },
-    { "path": "server/plugins/db.ts", "note": "additive migrations" },
-    { "path": "server/plugins/", "note": "startup integrations" },
-    { "path": "server/routes/api/", "note": "custom routes only when actions are not enough" },
-    { "path": "shared/types.ts", "note": "shared client/server types" },
-    { "path": ".agents/skills/", "note": "<skill>/SKILL.md — agent guidance for complex workflows" },
-    { "path": "AGENTS.md", "note": "template-specific agent instructions" },
+    { "path": "app/", "note": "واجهة React" },
+    { "path": "app/root.tsx", "note": "HTML shell و providers" },
+    { "path": "app/routes/", "note": "مسارات ملفات React Router" },
+    { "path": "app/components/", "note": "UI الخاصة بال template" },
+    { "path": "app/hooks/", "note": "hooks لحالة UI والبيانات" },
+    { "path": "actions/", "note": "عمليات defineAction: المصدر الوحيد للحقيقة" },
+    { "path": "server/db/schema.ts", "note": "مخطط Drizzle" },
+    { "path": "server/plugins/db.ts", "note": "migrations إضافية" },
+    { "path": "server/plugins/", "note": "تكاملات بدء التشغيل" },
+    { "path": "server/routes/api/", "note": "routes مخصصة فقط عندما لا تكفي actions" },
+    { "path": "shared/types.ts", "note": "client/server types مشتركة" },
+    { "path": ".agents/skills/", "note": "<skill>/SKILL.md: إرشادات agent لل workflows المعقدة" },
+    { "path": "AGENTS.md", "note": "تعليمات agent خاصة بال template" },
     { "path": "package.json" },
     { "path": "react-router.config.ts" },
     { "path": "vite.config.ts" }
@@ -67,7 +67,7 @@ npx @agent-native/core@latest create my-platform
 
 تربط المناطق الأربع لكل قالب معًا من خلال سطح عمل مشترك واحد وقاعدة بيانات SQL واحدة - الوكيل وUI شريكان متساويان في نفس العمليات:
 
-```an-diagram title="How a template's four areas connect" summary="The UI and the agent both reach SQL through the same actions; application state and polling sync keep them aligned."
+```an-diagram title="كيف تتصل المناطق الأربع للقالب" summary="يصل كل من واجهة المستخدم والوكيل إلى SQL من خلال نفس الإجراءات؛ حالة التطبيق ومزامنة الاستقصاء تحافظ على توافقهما."
 {
   "html": "<div class=\"diagram-tmpl\"><div class=\"diagram-col\"><div class=\"diagram-node\">React UI<br><small class=\"diagram-muted\">app/routes · components</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">AGENTS.md · skills</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">defineAction()</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>SQL via Drizzle<br><small class=\"diagram-muted\">additive schema</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-pill ok\">Polling sync</div></div>",
   "css": ".diagram-tmpl{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-tmpl .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-tmpl .diagram-arrow{font-size:22px;line-height:1}.diagram-tmpl .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
@@ -149,7 +149,7 @@ Actions هي المصدر الوحيد لحقيقة سلوك التطبيق. ي
   "annotations": [
     { "lines": "2", "note": "`getDb` is created per app via `createGetDb(schema)` in `server/db/index.ts`." },
     { "lines": "8", "label": "Tool surface", "note": "The `description` is what the agent reads to decide when to call this action as a tool." },
-    { "lines": "9-11", "label": "عقد typed", "note": "One zod `schema` validates input from the agent, the UI, HTTP, MCP, and A2A." },
+    { "lines": "9-11", "label": "عقد typed", "note": "يقوم zod `schema` واحد بالتحقق من الإدخال من agent وواجهة المستخدم وHTTP وMCP وA2A." },
     { "lines": "18-19", "label": "Scoped write", "note": "Stamp `ownerEmail` / `orgId` from `ctx` so the row is correctly scoped for sharing and access checks." }
   ]
 }

package/docs/content/locales/ar-SA/cross-app-sso.md

@@ -26,7 +26,7 @@ description: "قم بتسجيل الدخول مرة واحدة عبر كل تط
 
 يعد التدفق بمثابة تفويض قياسي ← رمز مميز موقّع ← إعادة توجيه رد الاتصال، حيث يكون البريد الإلكتروني هو الشيء الوحيد الذي يتجاوز حدود الثقة.
 
-```an-diagram title="Identity federation flow" summary="Dispatch authenticates the human and returns a short-lived signed assertion of one thing — the verified email. The app links by email and mints its own local session."
+```an-diagram title="تدفق اتحاد الهوية" summary="Dispatch يصادق على المستخدم ويعيد تأكيدًا موقعًا قصير الأمد لشيء واحد - البريد الإلكتروني الذي تم التحقق منه. يرتبط التطبيق عبر البريد الإلكتروني ويشكل جلسة محلية خاصة به."
 {
   "html": "<div class=\"diagram-sso\"><div class=\"diagram-card\" data-rough><strong>Client app</strong><small class=\"diagram-muted\">own user store</small></div><div class=\"diagram-step\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><span class=\"diagram-pill\">authorize</span></div><div class=\"diagram-card\" data-rough><strong>Dispatch</strong><small class=\"diagram-muted\">identity authority</small><span class=\"diagram-pill accent\">authenticates human</span></div><div class=\"diagram-step\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><span class=\"diagram-pill accent\">302 + signed JWT</span></div><div class=\"diagram-card\" data-rough><strong>App callback</strong><small class=\"diagram-muted\">verify signature · scope:identity · exp &le; 2 min</small><span class=\"diagram-pill ok\">JIT-link by email</span><span class=\"diagram-pill ok\">mint local session</span></div></div>",
   "css": ".diagram-sso{display:flex;align-items:stretch;gap:12px;flex-wrap:wrap}.diagram-sso .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:150px}.diagram-sso .diagram-step{display:flex;flex-direction:column;align-items:center;justify-content:center;gap:6px}.diagram-sso .diagram-arrow{font-size:22px;line-height:1}"
@@ -109,7 +109,7 @@ AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.agent-native.com
 
 الرابط في الوقت المناسب هو قرار واحد مُعتمد بالكامل على البريد الإلكتروني الذي تم التحقق منه:
 
-```an-diagram title="JIT-link decision" summary="Linking is keyed on the verified email and is additive only — existing accounts are reused unchanged, new emails create a fresh local user."
+```an-diagram title="JIT-link القرار" summary="يتم الارتباط على البريد الإلكتروني الذي تم التحقق منه ويكون إضافيًا فقط - تتم إعادة استخدام الحسابات الحالية دون تغيير، وتنشئ رسائل البريد الإلكتروني الجديدة مستخدمًا محليًا جديدًا."
 {
   "html": "<div class=\"diagram-jit\"><div class=\"diagram-node\" data-rough>Verified email<br><small class=\"diagram-muted\">from signed identity JWT</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-branch\"><div class=\"diagram-box\" data-rough>Local user exists?<span class=\"diagram-pill ok\">yes &rarr; reuse unchanged</span><span class=\"diagram-pill accent\">no &rarr; create local user</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Mint normal local session</div></div></div>",
   "css": ".diagram-jit{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-jit .diagram-node{display:flex;flex-direction:column;gap:4px;padding:12px 14px}.diagram-jit .diagram-branch{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-jit .diagram-box{display:flex;flex-direction:column;gap:6px;padding:12px 14px}.diagram-jit .diagram-arrow{font-size:22px;line-height:1}"

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

@@ -7,7 +7,7 @@ description: "قم بتوصيل قاعدة بيانات SQL المحمولة ب
 
 تستخدم التطبيقات الأصلية للوكيل [Drizzle ORM](https://orm.drizzle.team) وتدعم واجهات SQL الخلفية المحمولة. بالنسبة لأي شيء يتجاوز التطوير المحلي، قم بتوصيل قاعدة بيانات SQL المستمرة — Postgres، أو libSQL/Turso، أو واجهة خلفية أخرى متوافقة مع Drizzle — عن طريق تعيين `DATABASE_URL`. عند عدم تعيين هذا المتغير، يعود التطبيق إلى ملف SQLite المحلي بدون تكوين حتى تتمكن من البدء في التطوير على الفور.
 
-```an-diagram title="One schema, many backends" summary="App code uses the framework's dialect-agnostic helpers. The dialect is auto-detected from DATABASE_URL at runtime; unset means a local SQLite file."
+```an-diagram title="مخطط واحد والعديد من الواجهات الخلفية" summary="يستخدم رمز التطبيق مساعدين محايدين للهجة في إطار العمل. يتم اكتشاف اللهجة تلقائيًا من DATABASE_URL في وقت التشغيل؛ عدم الضبط يعني ملف SQLite محلي."
 {
   "html": "<div class=\"diagram-db\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">@agent-native/core/db/schema</span><small class=\"diagram-muted\">table · text · integer · real · now</small><small class=\"diagram-muted\">+ Drizzle query DSL</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>DATABASE_URL<br><small class=\"diagram-muted\">dialect auto-detected</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><span class=\"diagram-pill\">Postgres<br><small class=\"diagram-muted\">Neon · Supabase</small></span><span class=\"diagram-pill\">libSQL / Turso</span><span class=\"diagram-pill\">Cloudflare D1</span><span class=\"diagram-pill warn\">SQLite file<br><small class=\"diagram-muted\">unset = local dev only</small></span></div></div>",
   "css": ".diagram-db{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-db .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px 16px}.diagram-db .diagram-arrow{font-size:22px;line-height:1}.diagram-db .diagram-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}"
@@ -162,7 +162,7 @@ Raw SQL ليس رمز التطبيق الافتراضي API. استخدمه فق
 
 بدلاً من الدفع مباشرة، يجب تطبيق تغييرات المخطط عبر عمليات ترحيل SQL التي يتم تنفيذها عند بدء تشغيل التطبيق. قم بتنفيذ عمليات الترحيل الإضافية داخل مكون إضافي للخادم (على سبيل المثال، `server/plugins/db.ts`) عن طريق استدعاء مساعد `runMigrations()` الخاص بإطار العمل:
 
-```an-annotated-code title="An additive migration plugin"
+```an-annotated-code title="البرنامج المساعد الهجرة المضافة"
 {
   "filename": "server/plugins/db.ts",
   "language": "ts",

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

@@ -28,7 +28,7 @@ npx @agent-native/core@latest deploy
 
 يتم إنشاء كل تطبيق باستخدام `APP_BASE_PATH=/<name>` و`VITE_APP_BASE_PATH=/<name>`، ثم يتم تجميعه للإعداد المسبق المستهدف Nitro. يعد Cloudflare Pages هو الإعداد المسبق الافتراضي ويستخدم عامل إرسال تم إنشاؤه في `dist/_worker.js`؛ يستخدم Netlify وظيفة واحدة لكل تطبيق في `.netlify/functions-internal/<app>-server` بالإضافة إلى عمليات إعادة التوجيه التي تم إنشاؤها؛ يكتب Vercel `.vercel/output` على مستوى مساحة العمل باستخدام Build Output API.
 
-```an-diagram title="One origin, many apps" summary="Each workspace app is built with its own base path and mounted under a path prefix on a single origin — so login and cross-app A2A are same-origin and free."
+```an-diagram title="أصل واحد، والعديد من التطبيقات" summary="يتم إنشاء كل تطبيق مساحة عمل بمسار أساسي خاص به ويتم تثبيته أسفل بادئة مسار على أصل واحد - لذا فإن تسجيل الدخول والتطبيقات المشتركة A2A هما نفس الأصل ومجاني."
 {
   "html": "<div class=\"diagram-ws\"><div class=\"diagram-panel\" data-rough><strong>https://your-agents.com</strong><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/mail/*</span><small class=\"diagram-muted\">apps/mail</small></div><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/calendar/*</span><small class=\"diagram-muted\">apps/calendar</small></div><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/forms/*</span><small class=\"diagram-muted\">apps/forms</small></div></div><div class=\"diagram-col wins\"><span class=\"diagram-pill ok\">shared login session</span><span class=\"diagram-pill ok\">zero-config cross-app A2A</span></div></div>",
   "css": ".diagram-ws{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.diagram-ws .diagram-panel{display:flex;flex-direction:column;gap:6px;padding:14px 16px}.diagram-ws .diagram-row{display:flex;align-items:center;gap:8px}.diagram-ws .wins{display:flex;flex-direction:column;gap:8px;align-items:flex-start}"
@@ -70,20 +70,20 @@ npx @agent-native/core@latest deploy --preset vercel
 
 عند تشغيل `npx @agent-native/core@latest build`، يقوم Nitro ببناء كل من العميل SPA والخادم API في `.output/`:
 
-```an-file-tree title="Build output"
+```an-file-tree title="مخرجات build"
 {
   "entries": [
-    { "path": ".output/", "note": "self-contained — copy to any environment and run" },
-    { "path": ".output/public/", "note": "built SPA (static assets)" },
-    { "path": ".output/server/index.mjs", "note": "server entry point" },
-    { "path": ".output/server/chunks/", "note": "server code chunks" }
+    { "path": ".output/", "note": "مكتف ذاتياً: انسخه إلى أي environment وشغّله" },
+    { "path": ".output/public/", "note": "SPA مبنية (static assets)" },
+    { "path": ".output/server/index.mjs", "note": "نقطة دخول server" },
+    { "path": ".output/server/chunks/", "note": "أجزاء كود الخادم" }
   ]
 }
 ```
 
 الإخراج مستقل بذاته - انسخ `.output/` إلى أي بيئة وقم بتشغيله.
 
-```an-diagram title="Build to deploy" summary="One source tree builds to a Nitro preset; the same self-contained output runs on Node, Vercel, Netlify, Cloudflare, AWS, or Deno. Every instance points at the same persistent DATABASE_URL."
+```an-diagram title="بناء للنشر" summary="يتم بناء شجرة مصدر واحدة على إعداد مسبق Nitro؛ يتم تشغيل نفس الإخراج المستقل على Node، أو Vercel، أو Netlify، أو Cloudflare، أو AWS، أو Deno. يشير كل مثيل إلى نفس DATABASE_URL المستمر."
 {
   "html": "<div class=\"diagram-deploy\"><div class=\"diagram-box\" data-rough>App source</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">build</span><small class=\"diagram-muted\">Nitro preset</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><span class=\"diagram-pill\">Node.js</span><span class=\"diagram-pill\">Vercel</span><span class=\"diagram-pill\">Netlify</span><span class=\"diagram-pill\">Cloudflare</span><span class=\"diagram-pill\">AWS Lambda</span><span class=\"diagram-pill\">Deno</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Persistent DATABASE_URL<br><small class=\"diagram-muted\">shared by every instance</small></div></div>",
   "css": ".diagram-deploy{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-deploy .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px 16px}.diagram-deploy .diagram-arrow{font-size:22px;line-height:1}.diagram-deploy .diagram-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:8px}"
@@ -95,12 +95,11 @@ npx @agent-native/core@latest deploy --preset vercel
 افتراضيًا، يتم إنشاء Nitro لـ Node.js. لاستهداف منصة مختلفة، قم بضبط الإعداد المسبق في `vite.config.ts`:
 
 ```ts
-import { defineConfig } from "@agent-native/core/vite";
+import { agentNative } from "@agent-native/core/vite";
+import { defineConfig } from "vite";
 
 export default defineConfig({
-  nitro: {
-    preset: "vercel",
-  },
+  plugins: [agentNative({ nitro: { preset: "vercel" } })],
 });
 ```
 
@@ -151,7 +150,7 @@ CMD ["node", ".output/server/index.mjs"]
 ```ts
 // vite.config.ts
 export default defineConfig({
-  nitro: { preset: "vercel" },
+  plugins: [agentNative({ nitro: { preset: "vercel" } })],
 });
 ```
 
@@ -182,7 +181,7 @@ npx @agent-native/core@latest deploy --preset vercel --build-only
 ```ts
 // vite.config.ts
 export default defineConfig({
-  nitro: { preset: "netlify" },
+  plugins: [agentNative({ nitro: { preset: "netlify" } })],
 });
 ```
 
@@ -201,7 +200,7 @@ npx @agent-native/core@latest deploy --preset netlify
 ```ts
 // vite.config.ts
 export default defineConfig({
-  nitro: { preset: "cloudflare_pages" },
+  plugins: [agentNative({ nitro: { preset: "cloudflare_pages" } })],
 });
 ```
 
@@ -210,7 +209,7 @@ export default defineConfig({
 ```ts
 // vite.config.ts
 export default defineConfig({
-  nitro: { preset: "aws_lambda" },
+  plugins: [agentNative({ nitro: { preset: "aws_lambda" } })],
 });
 ```
 
@@ -219,7 +218,7 @@ export default defineConfig({
 ```ts
 // vite.config.ts
 export default defineConfig({
-  nitro: { preset: "deno_deploy" },
+  plugins: [agentNative({ nitro: { preset: "deno_deploy" } })],
 });
 ```
 

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

@@ -11,7 +11,7 @@ Dispatch هو التطبيق المركزي الذي يقع أمام كل تطب
 
 بدون Dispatch، سينتهي الأمر بكل تطبيق في مساحة عمل متعددة التطبيقات بإعادة تنفيذ نفس السباكة: روبوت Slack الخاص به، ومتجره السري الخاص، والوظائف المجدولة الخاصة به، ونسخته الخاصة من تعليمات مساحة العمل. يؤدي تدوير مفتاح API واحد إلى عشر عمليات إعادة توزيع. إضافة سياسة جديدة تتحول إلى عشرة نسخ ولصق. تعمل Dispatch على تجميع كل ذلك في تطبيق واحد حتى يواصل الآخرون التركيز على نطاقهم.
 
-```an-diagram title="Dispatch as the workspace control plane" summary="One inbox, one vault, one MCP gateway, and shared resources sit in front of the domain apps, which Dispatch reaches as A2A peers."
+```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>",
   "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}"
@@ -110,7 +110,7 @@ Dispatch هو التطبيق المركزي الذي يقع أمام كل تطب
 4. **تم نشر الرد في سلسلة المحادثات.** يقوم وكيل التحليلات بإرجاع نتيجة. يقوم Dispatch بتنسيقه ونشره مرة أخرى في نفس سلسلة Slack التي كتبها المستخدم، باستخدام الهوية المرتبطة إذا كانت هناك واحدة (بحيث يتصرف الوكيل وفقًا لأذونات الطالب، وليس أذونات مالك مساحة العمل).
 5. **الاسترداد في حالة وفاة أي شيء.** إذا تعطل المعالج في منتصف الرحلة - انتهاء مهلة A2A، أو خطأ في عامل المصب، أو تجميد الوظيفة - فإن مهمة إعادة المحاولة تمسح المهام العالقة كل 60 ثانية وتعيد تشغيل المعالج. ما يصل إلى ثلاث محاولات قبل أن يتم وضع علامة `failed` على المهمة.
 
-```an-diagram title="A Slack message through Dispatch" summary="Slack enqueues into SQL, a fresh execution drains it, the Dispatch agent delegates the domain work over A2A, and the reply lands back in the originating thread. A 60s retry job recovers anything that dies mid-flight."
+```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>",
   "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

@@ -27,7 +27,7 @@ description: "قم بتثبيت دردشة الوكيل + مساحة العمل
 
 يتم تصدير كل هذه العناصر من `@agent-native/core/client`.
 
-```an-diagram title="The mount model" summary="<AgentSidebar> wraps your existing layout. Your routes render in the main area; the agent panel mounts beside them. <AgentPanel> is the same panel without the wrapper."
+```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>",
   "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}"
@@ -40,7 +40,7 @@ description: "قم بتثبيت دردشة الوكيل + مساحة العمل
 قم بلف تخطيط الجذر الموجود لديك باستخدام `<AgentSidebar>`؛ مهما تم تمريره كـ
 يبقى الأطفال في منطقة التطبيق الرئيسية. دردشة الوكيل هي اللوحة الجانبية.
 
-```an-annotated-code title="Wrapping the root layout with <AgentSidebar>"
+```an-annotated-code title="تغليف تخطيط الجذر بـ <AgentSidebar>"
 {
   "filename": "app/root.tsx",
   "language": "tsx",

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

@@ -13,7 +13,7 @@ description: "عند مقاطعة تشغيل الوكيل المستضاف وا
 
 السيرة الذاتية الدائمة تسد هذه الفجوة. عند الاستئناف، يعرف إطار العمل استدعاءات أدوات التأثير الجانبي التي تم إكمالها بالفعل ويرفض إعادة تشغيلها — على طبقتين.
 
-```an-diagram title="Two layers block duplicate side effects on resume" summary="The journal reads the durable ledger and classifies prior calls; layer 1 tells the model, layer 2 hard-blocks a re-dispatched write that matches a completed entry."
+```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>",
   "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

@@ -11,7 +11,7 @@ description: "قم بتضمين ملف جانبي Agent-Native في تطبيق S
 السيارة الجانبية المضمنة، أو التطبيق الكامل، تبدأ بـ
 [Agent Surfaces](/docs/agent-surfaces).
 
-```an-diagram title="The embedding membrane" summary="The host app supplies server-side auth and live page context; Agent-Native runs the durable sidecar and reaches the open tab through client actions and host commands."
+```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>",
   "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}"
@@ -373,7 +373,7 @@ const hostTools = createAgentNativeHostTools({
 
 بالنسبة لزميل العمل ذو النمط CLAW، يمكن لإطار iframe أيضًا تسجيل علامة تبويب المتصفح المباشرة الخاصة به مع الواجهة الخلفية الجانبية. يحصل الوكيل بعد ذلك على أدوات الواجهة الخلفية العادية التي تسجل الطلب، ويطالب به إطار iframe، وتنفذه الصفحة المضيفة، وترجع الواجهة الخلفية النتيجة إلى الوكيل.
 
-```an-diagram title="Server-mediated browser-session bridge" summary="A backend tool enqueues work; the registered tab claims it, runs it on the live page, and the result returns to the agent — so a backend/Slack/A2A agent can still touch the open tab."
+```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>",
   "css": ".diagram-bridge{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-bridge .diagram-arrow{font-size:22px;line-height:1}"