@agent-native/core 0.77.2 → 0.77.4

package/docs/content/locales/ar-SA/a2a-protocol.md

@@ -119,11 +119,11 @@ _(قد يختلف الإصدار؛ احصل على البطاقة المباشر
 | `tasks/get`      | جلب مهمة حسب المعرف - يُستخدم لاستقصاء مهمة غير متزامنة حتى اكتمالها                                  | `id`                          |
 | `tasks/cancel`   | إلغاء مهمة قيد التشغيل                                                                                | `id`                          |
 
-```an-api title="Primary A2A endpoint" summary="All JSON-RPC methods are POSTed here. message/send shown."
+```an-api title="نقطة النهاية الأساسية A2A" summary="جميع أساليب JSON-RPC منشورة هنا. message/send معروض."
 {
   "method": "POST",
   "path": "/_agent-native/a2a",
-  "summary": "Send a message and wait for the completed task",
+  "summary": "أرسل رسالة وانتظر اكتمال المهمة",
   "description": "JSON-RPC 2.0 endpoint for `message/send`, `message/stream`, `tasks/get`, and `tasks/cancel`. Pass `async: true` to return immediately in `working` state and poll with `tasks/get`.",
   "auth": "JWT bearer signed with A2A_SECRET (or legacy apiKeyEnv static token)",
   "params": [

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

@@ -19,9 +19,9 @@ Actions هي المصدر الوحيد للحقيقة لأي شيء يفعله
 إذا كنت تقرر ما إذا كنت ستكشف عن عملية بدون رأس، في الدردشة، في
 السيارة الجانبية المضمنة، أو كشاشة تطبيق كاملة، راجع [Agent Surfaces](/docs/agent-surfaces).
 
-```an-diagram title="تعريف واحد، سبعة مستهلكين" summary="ينتشر defineAction() واحد على كل سطح - الوكيل، وUI، وHTTP، وMCP، وA2A، وCLI - مع مخطط واحد تم التحقق منه ونص run() واحد."
+```an-diagram title="تعريف واحد، سبعة مستهلكين" summary="ينتشر defineAction() واحد على كل سطح - الوكيل، وUI، وHTTP، وMCP، وA2A, وCLI - مع مخطط واحد تم التحقق منه ونص run() واحد."
 {
-  "html": "<div class=\"diagram-fanout\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">defineAction()</span><small class=\"diagram-muted\">مخطط + تشغيل ()، تم تعريفه مرة واحدة</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><div class=\"diagram-node\">أداة الوكيل<br><small class=\"diagram-muted\">JSON المخطط في السياق</small></div><div class=\"diagram-node\">React خطافات<br><small class=\"diagram-muted\">useActionQuery/Mutation</small></div><div class=\"diagram-node\">كولأكشن ()<br><small class=\"diagram-muted\">العميل الحتمي</small></div><div class=\"diagram-node\">HTTP<br><small class=\"diagram-muted\">/_agent-native/actions/:اسم</small></div><div class=\"diagram-node\">أداة JSON<br><small class=\"diagram-muted\">المضيفين الخارجيين</small></div><div class=\"diagram-node\">أداة JSON<br><small class=\"diagram-muted\">تطبيقات agent-native الأخرى</small></div><div class=\"diagram-node\">CLI<br><small class=\"diagram-muted\">عمل pnpm &lt;اسم&gt;</small></div></div></div>",
+  "html": "<div class=\"diagram-fanout\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">defineAction()</span><small class=\"diagram-muted\">مخطط + تشغيل (), تم تعريفه مرة واحدة</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><div class=\"diagram-node\">أداة الوكيل<br><small class=\"diagram-muted\">JSON المخطط في السياق</small></div><div class=\"diagram-node\">React خطافات<br><small class=\"diagram-muted\">useActionQuery/Mutation</small></div><div class=\"diagram-node\">كولأكشن ()<br><small class=\"diagram-muted\">العميل الحتمي</small></div><div class=\"diagram-node\">HTTP<br><small class=\"diagram-muted\">/_agent-native/actions/:اسم</small></div><div class=\"diagram-node\">أداة JSON<br><small class=\"diagram-muted\">المضيفين الخارجيين</small></div><div class=\"diagram-node\">أداة JSON<br><small class=\"diagram-muted\">تطبيقات agent-native الأخرى</small></div><div class=\"diagram-node\">CLI<br><small class=\"diagram-muted\">عمل pnpm &lt;اسم&gt;</small></div></div></div>",
   "css": ".diagram-fanout{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-fanout .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px 16px}.diagram-fanout .diagram-arrow{font-size:22px;line-height:1}.diagram-fanout .diagram-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}"
 }
 ```
@@ -167,7 +167,7 @@ export default defineAction({
   "method": "GET",
   "path": "/_agent-native/actions/get-lead",
   "summary": "كل action يثبت هنا تلقائيا - اسم الملف هو اسم action.",
-  "description": "الافتراضي هو POST؛ `http: { method: \"GET\" }` يجعلها GET. تستدعي React hooks و `callAction` هذا المسار دائما بالاسم، بغض النظر عن أي تجاوز `http.path`.",
+  "description": "الافتراضي هو POST؛ `http: { method: \"GET\" }` يجعلها GET. تستدعي خطافات React و `callAction` هذا المسار دائما بالاسم، بغض النظر عن أي تجاوز `http.path`.",
   "auth": "ملف تعريف ارتباط للجلسة؛ تحمل استدعاءات الواجهة `X-Agent-Native-Frontend: 1`",
   "params": [
     { "name": "leadId", "in": "query", "type": "string", "required": true, "description": "تصل وسائط GET كمعاملات query؛ وتصل وسائط POST في جسم JSON." }
@@ -446,7 +446,7 @@ export default defineAction({
 
 المميزات المضمنة هي `"data-table"`، `"data-chart"`، و
 `"data-insights"`، مع أدوات إنشاء ومخططات آمنة للخادم في
-`@agent-native/core/data-widgets`. See [Native Chat UI](/docs/native-chat-ui)
+`@agent-native/core/data-widgets`. See [Native واجهة الدردشة](/docs/native-chat-ui)
 للحصول على عقد النتيجة الكاملة وإرشادات وقت تشغيل BYO، أو
 [Agent Surfaces](/docs/agent-surfaces) لمعرفة كيفية استمرار نفس الإجراء
 بدون رأس، أو يتم عرضه في الدردشة، أو يتم عرضه في وضع ملء الشاشة.
@@ -580,8 +580,8 @@ const args = parseArgs(["--name", "Steve", "--verbose", "--count=3"]);
 | ----------------------- | --------- | ------------------------------------------------------------- |
 | `loadEnv(path?)`        | `void`    | قم بتحميل `.env` من جذر المشروع (أو المسار المخصص).           |
 | `camelCaseArgs(args)`   | `Record`  | تحويل مفاتيح علبة الكباب إلى علبة الجمل.                      |
-| `isValidPath(p)`        | `boolean` | التحقق من صحة المسار النسبي (لا يوجد اجتياز، لا مطلق).        |
-| `isValidProjectPath(p)` | `boolean` | التحقق من صحة ارتباط المشروع (على سبيل المثال، `my-project`). |
+| `isValidPath(p)`        | `boolean` | التحقق من صحة المسار النسبي (لا يوجد اجتياز, لا مطلق).        |
+| `isValidProjectPath(p)` | `boolean` | التحقق من صحة ارتباط المشروع (على سبيل المثال, `my-project`). |
 | `ensureDir(dir)`        | `void`    | مساعد `mkdir -p`.                                             |
 | `fail(message)`         | `never`   | الطباعة إلى stderr و`exit(1)`.                                |
 

package/docs/content/locales/ar-SA/agent-surfaces.md

@@ -110,11 +110,11 @@ export default defineAction({
 - **UI** — من خلال `useActionQuery` أو `useActionMutation` أو `callAction`
 - **أداة الوكيل** — من حلقة الدردشة المضمنة
 
-```an-api title="Calling an action over HTTP"
+```an-api title="استدعاء إجراء عبر HTTP"
 {
   "method": "POST",
   "path": "/_agent-native/actions/summarize-week",
-  "summary": "Invoke any action by name over HTTP",
+  "summary": "استدعاء أي إجراء بالاسم عبر HTTP",
   "description": "Every `defineAction` is auto-mounted at `/_agent-native/actions/<name>`. The JSON body is validated against the action's zod schema before `run` executes.",
   "request": {
     "contentType": "application/json",
@@ -268,7 +268,7 @@ export function ProjectChat({ threadId }: { threadId: string }) {
 
 يمكن لـ Actions عرض نتائج عناصر واجهة مستخدم أصلية صريحة، لذا لا يقتصر الأمر على إخراج الدردشة
 نص. يتم عرض الجداول والمخططات وبطاقات المنتجات المكتوبة كـ React للطرف الأول
-مكونات في الدردشة، بدون إطارات iframe. انظر [Native Chat UI](/docs/native-chat-ui).
+مكونات في الدردشة، بدون إطارات iframe. انظر [Native واجهة الدردشة](/docs/native-chat-ui).
 
 ## دردشة غنية مع وكيلك {#byo-agent}
 
@@ -300,7 +300,7 @@ export function SupportAgentChat() {
 وكيل الترميز (Gemini CLI، Claude Code، ...) من خلال
 [harness layer](/docs/harness-agents#acp)، وليس وقت تشغيل الدردشة هنا.
 
-[Native Chat UI — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes)
+[Native واجهة الدردشة — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes)
 هو الموطن الأساسي لأشكال الأحداث، ومساعدي وقت التشغيل، و`chatUI`
 البيانات التعريفية لنتيجة الأداة. ابدأ من هنا عند توصيل وكيل خارجي بالدردشة.
 
@@ -389,7 +389,7 @@ export function AppShell({ children }) {
 ## المستندات ذات الصلة {#related-docs}
 
 - [Actions](/docs/actions) — حدد عملية مقطوعة الرأس مرة واحدة.
-- [Native Chat UI](/docs/native-chat-ui) — عرض نتائج الإجراءات المكتوبة في الدردشة.
+- [Native واجهة الدردشة](/docs/native-chat-ui) — عرض نتائج الإجراءات المكتوبة في الدردشة.
 - [Drop-in Agent](/docs/drop-in-agent) — قم بتثبيت الدردشة أو الشريط الجانبي أو أسطح اللوحات.
 - [Component API](/docs/components) — مقطوعات الدردشة/الملحن React ذات المستوى الأدنى.
 - [Embedding SDK](/docs/embedding-sdk) — أضف Agent-Native إلى تطبيق موجود.

package/docs/content/locales/ar-SA/agent-teams.md

@@ -81,7 +81,7 @@ const task = await spawnTask({
 });
 ```
 
-لن تستدعي معظم أكواد التطبيق هذا مباشرة - حيث يقوم إطار العمل بذلك تحت غطاء `@mentions` ولأداة `agent-teams`. يمكنك الوصول إلى `spawnTask()` فقط عندما تقوم بتوصيل نقطة دخول جديدة (على سبيل المثال، زر يبدأ مهمة خلفية تعمل كوكيل فرعي).
+لن تستدعي معظم أكواد التطبيق هذا مباشرة - حيث يقوم إطار العمل بذلك تحت غطاء `@mentions` ولأداة `agent-teams`. يمكنك الوصول إلى `spawnTask()` فقط عندما تقوم بتوصيل نقطة دخول جديدة (على سبيل المثال, زر يبدأ مهمة خلفية تعمل كوكيل فرعي).
 
 ## دورة حياة المهمة {#lifecycle}
 
@@ -92,7 +92,7 @@ const task = await spawnTask({
 }
 ```
 
-في أي وقت، يمكن للوكيل الأصلي استئناف الوكيل الفرعي من خلال المتابعة عبر `sendToTask(taskId, message)`. إذا كانت أخطاء الوكيل الفرعي، فإن `markTaskErrored(taskId, reason)` يسجل الفشل ويظهره للمستخدم.
+في أي وقت، يمكن للوكيل الأصلي استئناف الوكيل الفرعي من خلال المتابعة عبر `sendToTask(taskId, message)`. إذا كانت أخطاء الوكيل الفرعي, فإن `markTaskErrored(taskId, reason)` يسجل الفشل ويظهره للمستخدم.
 
 ميزة المراسلة ثنائية الاتجاه متينة. تتم متابعات الوالدين لتشغيل الوكلاء الفرعيين
 يتم تسليمها خلال دورة حياة المهمة؛ إذا لم يتمكن الوكيل الفرعي من استهلاكها في
@@ -140,7 +140,7 @@ interface AgentTask {
 
 ```an-diagram title="حارس عمق التفويض (الغطاء الافتراضي 2)" summary="قد يؤدي كل مستوى إلى ظهور مستوى أعمق حتى الغطاء؛ تفرخ الماضي تم رفضه من جانب الخادم."
 {
-  "html": "<div class=\"at-depth\"><div class=\"diagram-card ok\"><span class=\"diagram-pill\">العمق 0</span><strong>دردشة على أعلى مستوى</strong><small class=\"diagram-muted ok\">قد تفرخ &darr;</small></div><div class=\"diagram-card ok\"><span class=\"diagram-pill\">العمق 1</span><strong>Sub-agent</strong><small class=\"diagram-muted ok\">قد تفرخ &darr;</small></div><div class=\"diagram-card warn\"><span class=\"diagram-pill warn\">العمق 2</span><strong>الوكيل الفرعي للوكيل الفرعي</strong><small class=\"diagram-muted\">في الحد الأقصى &mdash; قد NOT تفرخ</small></div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">العمق 3</span><strong>رفض</strong><small class=\"diagram-muted\">خطأ من جانب الخادم</small></div></div>",
+  "html": "<div class=\"at-depth\"><div class=\"diagram-card ok\"><span class=\"diagram-pill\">العمق 0</span><strong>دردشة على أعلى مستوى</strong><small class=\"diagram-muted ok\">قد ينشئ &darr;</small></div><div class=\"diagram-card ok\"><span class=\"diagram-pill\">العمق 1</span><strong>وكيل فرعي</strong><small class=\"diagram-muted ok\">قد ينشئ &darr;</small></div><div class=\"diagram-card warn\"><span class=\"diagram-pill warn\">العمق 2</span><strong>وكيل فرعي لوكيل فرعي</strong><small class=\"diagram-muted\">عند الحد الأقصى &mdash; لا يمكنه إنشاء المزيد</small></div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">العمق 3</span><strong>مرفوض</strong><small class=\"diagram-muted\">خطأ من جانب الخادم</small></div></div>",
   "css": ".at-depth{display:flex;flex-direction:column;gap:8px}.at-depth .diagram-card{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.at-depth .rung-1,.at-depth .diagram-card:nth-child(2){margin-inline-start:24px}.at-depth .diagram-card:nth-child(3){margin-inline-start:48px}.at-depth .diagram-card:nth-child(4){margin-inline-start:72px}"
 }
 ```
@@ -159,7 +159,7 @@ interface AgentTask {
 | غير صالح / `>16` | تعود القيمة غير الصحيحة / السالبة / NaN إلى `2`؛ أي شيء أعلى من `16` يتم تثبيته على `16` لذا لا يمكن للخطأ المطبعي تعطيل الحماية مطلقًا. |
 
 ```bash
-AGENT_NATIVE_MAX_SUBAGENT_DEPTH=1   # sub-agents allowed, but they can't sub-delegate
+AGENT_NATIVE_MAX_SUBAGENT_DEPTH=1   # مسموح بالوكلاء الفرعيين، لكن لا يمكنهم التفويض من الباطن
 ```
 
 عندما يصل الوكيل الفرعي إلى الحد الأقصى أو أقل منه، يقوم إطار العمل بإدخال سطر في سياق وقت التشغيل الخاص به لإخباره بمدى عمقه وما إذا كان يمكنه تفويض المزيد، وبالتالي ينفق النموذج ميزانيته بشكل مناسب.

package/docs/content/locales/ar-SA/agent-web-surfaces.md

@@ -1,6 +1,6 @@
 ---
 title: "موقع الوكيل العام"
-description: "اجعل المسارات العامة قابلة للزحف، وقابلة للقراءة، والاستشهاد بها، ويمكن استدعاؤها اختياريًا بواسطة الوكلاء — robots.txt، وllms.txt، ومرايا تخفيض السعر، وJSON-LD، وسطح MCP العام."
+description: "اجعل المسارات العامة قابلة للزحف، وقابلة للقراءة، والاستشهاد بها، ويمكن استدعاؤها اختياريًا بواسطة الوكلاء — robots.txt، وllms.txt، ومرايا Markdown، وJSON-LD، وسطح MCP العام."
 ---
 
 # موقع الوكيل العام
@@ -130,7 +130,7 @@ const files = buildAgentWebStaticFiles({
       path: "/docs",
       title: "Docs",
       description: "Start here.",
-      markdown: "# Docs\n\nStart here.\n",
+      markdown: "# المستندات\n\nابدأ هنا.\n",
       markdownPath: "/docs/getting-started.md",
       lastmod: new Date(),
     },

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

@@ -107,8 +107,8 @@ AUTH_SKIP_EMAIL_VERIFICATION=1
 GOOGLE_SIGN_IN_CLIENT_ID=your-low-scope-sign-in-client-id
 GOOGLE_SIGN_IN_CLIENT_SECRET=your-low-scope-sign-in-client-secret
 
-# Backwards-compatible fallback, and provider OAuth credentials for templates
-# that connect to Google APIs such as Gmail or Calendar.
+# احتياطي متوافق مع الإصدارات السابقة وبيانات اعتماد الموفر OAuth للقوالب
+# التي تتصل بـ Google واجهات برمجة التطبيقات مثل Gmail أو Calendar.
 GOOGLE_CLIENT_ID=your-client-id
 GOOGLE_CLIENT_SECRET=your-client-secret
 
@@ -146,10 +146,10 @@ GITHUB_CLIENT_SECRET=your-client-secret
 `ACCESS_TOKEN` و`ACCESS_TOKENS` ليسا بمثابة مصادقة للمتصفح ولا يجعلان التطبيق خاصًا. وتظل فقط بمثابة بيانات اعتماد حامل ثابتة لعملاء MCP/connect الذين لا يمكنهم استخدام تدفق OAuth.
 
 ```bash
-# Single token
+# رمز مميز واحد
 ACCESS_TOKEN=my-secret-token
 
-# Multiple tokens
+# رموز مميزة متعددة
 ACCESS_TOKENS=token1,token2,token3
 ```
 

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

@@ -79,7 +79,7 @@ description: "عمليات التشغيل التلقائي المجدولة وا
 | `event`       | سلسلة                            | _(اختياري)_  | اسم الحدث المطلوب الاشتراك فيه (مشغّلات الحدث فقط)                                                                                                                  |
 | `condition`   | سلسلة                            | _(اختياري)_  | تم تقييم حالة اللغة الطبيعية قبل الإرسال                                                                                                                            |
 | `mode`        | `"agentic"` \| `"deterministic"` | `"agentic"`  | حلقة الوكيل الكاملة. (`"deterministic"` محجوز ولكن لم يتم تنفيذه بعد — يتم تخطي عمليات الأتمتة التي تقوم بتعيينه. استخدم `"agentic"` لجميع عمليات الأتمتة الحالية.) |
-| `domain`      | سلسلة                            | _(اختياري)_  | علامة التجميع (البريد، التقويم، المقاطع، إلخ.)                                                                                                                      |
+| `domain`      | سلسلة                            | _(اختياري)_  | علامة التجميع (البريد، التقويم، المقاطع, إلخ.)                                                                                                                      |
 
 بالنسبة لمشغل الحدث، `schedule` هو `""` (فارغ)؛ بالنسبة لمشغل الجدول الزمني فإنه يحمل تعبير cron. يكتب المرسل أيضًا نفس حقول `lastRun` / `lastStatus` / `lastError` المُدارة التي يكتبها المجدول، بالإضافة إلى حالة `"skipped"` عندما يتم تقييم الشرط إلى خطأ.
 
@@ -210,11 +210,11 @@ Body: {"text": "New booking from ${attendeeEmail}"}
 | `/_agent-native/secrets/adhoc`         | POST    | إنشاء أو تحديث مفتاح مخصص                          |
 | `/_agent-native/secrets/adhoc/:name`   | DELETE  | حذف مفتاح مخصص                                     |
 
-```an-api title="Fire a test event"
+```an-api title="إطلاق حدث اختباري"
 {
   "method": "POST",
   "path": "/_agent-native/automations/fire-test",
-  "summary": "Emit a test.event.fired event to validate event-triggered automations",
+  "summary": "قم بإصدار حدث test.event.fired للتحقق من صحة العمليات التلقائية التي يتم تشغيلها بواسطة الحدث",
   "description": "Confirm an automation's wiring and condition without waiting for a real provider event. Equivalent to the `manage-automations` action `fire-test`.",
   "responses": [
     { "status": "200", "description": "Event emitted; matching automations are dispatched through the normal condition + ownership path." }

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

@@ -19,7 +19,7 @@ agent-native add channel discord  | codex
 
 ```an-diagram title="إضافة مطبوعات وصفة؛ يقوم وكيل الترميز الخاص بك بتطبيقه" summary="agent-native يُصدر مخطط Markdown إلى stdout (التشخيص إلى stderr)؛ تقوم بتوصيله إلى Claude Code أو Codex، والذي يقوم بتحرير الريبو المباشر الخاص بك بالسياق الكامل."
 {
-  "html": "<div class=\"diagram-bp\"><div class=\"diagram-node\" data-rough>agent-native إضافة<br><small class=\"diagram-muted\">&lt;عطوف&gt; &lt;الاسم|URL&gt;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>مخطط تخفيض السعر<br><small class=\"diagram-muted\">stdout · ملفات للمس · قواعد · التحقق</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough>وكيل الترميز<br><small class=\"diagram-muted\">كلود · المخطوطة</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">يقوم بتحرير الريبو المباشر الخاص بك</div></div>",
+  "html": "<div class=\"diagram-bp\"><div class=\"diagram-node\" data-rough>agent-native إضافة<br><small class=\"diagram-muted\">&lt;عطوف&gt; &lt;الاسم|URL&gt;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>مخطط Markdown<br><small class=\"diagram-muted\">stdout · ملفات للمس · قواعد · التحقق</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough>وكيل الترميز<br><small class=\"diagram-muted\">كلود · المخطوطة</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">يقوم بتحرير الريبو المباشر الخاص بك</div></div>",
   "css": ".diagram-bp{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-bp .diagram-arrow{font-size:22px;line-height:1}.diagram-bp .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -28,7 +28,7 @@ agent-native add channel discord  | codex
 
 ```bash
 agent-native add <kind> <name>            # print a curated blueprint
-agent-native add <kind> <https://docs…>   # research-and-integrate from a URL
+agent-native add <kind> <https://docs…>   # البحث والتكامل من URL
 agent-native add --list                   # list available kinds and blueprints
 ```
 

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

@@ -60,7 +60,7 @@ const ffmpeg = new ShellCliAdapter({
 });
 ```
 
-الخيارات: `command` (مطلوب)، `description` (مطلوب)، `name` (افتراضي `command`)، `env` (مدمج مع `process.env`)، `cwd` (افتراضي `process.cwd()`)، و`timeoutMs` (افتراضي) `30000`).
+الخيارات: `command` (مطلوب)، `description` (مطلوب)، `name` (افتراضي `command`)، `env` (مدمج مع `process.env`)، `cwd` (افتراضي `process.cwd()`), و`timeoutMs` (افتراضي) `30000`).
 
 للحصول على مصادقة مخصصة، أو تحليل المخرجات، أو المعالجة المسبقة/اللاحقة، قم بتنفيذ `CliAdapter` مباشرةً بدلاً من استخدام `ShellCliAdapter`.
 

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

@@ -382,11 +382,11 @@ npx @agent-native/core@latest migrate ./my-next-app --out ../migrated-app   # sh
 
 نقاط نهاية الترحيل عن بعد الأساسية هي:
 
-```an-api title="Desktop claims queued work"
+```an-api title="يطالب سطح المكتب بالعمل في قائمة الانتظار"
 {
   "method": "POST",
   "path": "/_agent-native/integrations/remote/poll",
-  "summary": "Desktop long-polls the relay to claim enqueued commands",
+  "summary": "يقوم سطح المكتب باستقصاء طويل للمرحل للمطالبة بالأوامر الموضوعة في قائمة الانتظار",
   "description": "Outbound-only from a paired Desktop host. Desktop authenticates with its device token and claims work that mobile or Telegram enqueued.",
   "auth": "Desktop device token",
   "responses": [

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

@@ -58,7 +58,7 @@ import { ResourcesPanel } from "@agent-native/core/client/resources";
 المحادثة بينما يحتفظ Agent-Native بالملحن والنص وبطاقات الأدوات و
 عرض القطعة الأصلية. الموصلات أعلاه هي سطح API؛ وقت التشغيل
 يتم تدريس أشكال العقود والأحداث في
-[Native Chat UI — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes).
+[Native واجهة الدردشة — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes).
 إذا كنت تختار بين الوكلاء مقطوعي الرأس، والدردشة الغنية، والعربة الجانبية المضمنة، و
 أشكال التطبيق الكاملة، راجع [Agent Surfaces](/docs/agent-surfaces).
 
@@ -96,7 +96,7 @@ function CustomChat({ projectSlug }: { projectSlug: string }) {
 
 للحصول على نقطة نهاية إحضار الوكيل الخاص بك، أنشئ `AgentChatRuntime` باستخدام أحد
 الموصلات أعلاه وتمريرها إلى `<AssistantChat runtime={...} />`. انظر
-[Native Chat UI — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes)
+[Native واجهة الدردشة — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes)
 لاستخدام الموصل، ودفق الأحداث الذي تمت تسويته، ومتى يجب الوصول إليه
 `createHttpAgentChatRuntime()` مقابل موصل خاص بالبروتوكول.
 
@@ -151,7 +151,7 @@ import { PromptComposer } from "@agent-native/core/client/composer";
 داخل الدردشة بدلاً من JSON العادي. تتضمن المخرجات المدمجة القابلة لإعادة الاستخدام
 `DataTableWidget`، و`DataChartWidget`، و`DataWidgetResult`؛ يتم تصديرها
 من `@agent-native/core/client/chat` وإدخال العميل الجذر. انظر
-[Native Chat UI](/docs/native-chat-ui) لعقد نتيجة الإجراء.
+[Native واجهة الدردشة](/docs/native-chat-ui) لعقد نتيجة الإجراء.
 
 | API                              | استخدم عندما                                                                     |
 | -------------------------------- | -------------------------------------------------------------------------------- |
@@ -198,20 +198,20 @@ import {
 
 ## محرر منسق {#rich-editor}
 
-استخدم `@agent-native/core/client/editor` عندما تحتاج إلى محرر تخفيض السعر المشترك
+استخدم `@agent-native/core/client/editor` عندما تحتاج إلى محرر Markdown المشترك
 السطح الذي تستخدمه الخطط والمحتوى والموارد والمستندات التعاونية
 التجارب.
 
-| API                              | استخدم عندما                                                                                       |
-| -------------------------------- | -------------------------------------------------------------------------------------------------- |
-| `<SharedRichEditor>`             | أنت بحاجة إلى المحرر الحالي القابل للتكوين مع تسلسل تخفيض السعر، وYjs الاختيارية، وإضافات التطبيق. |
-| `<RichMarkdownEditor>`           | أنت بحاجة إلى الاسم المستعار المتوافق مع الإصدارات السابقة للمحرر الغني المشترك.                   |
-| `createSharedEditorExtensions()` | أنت تقوم بإنشاء محرر Tiptap الخاص بك ولكنك تريد مخطط إطار العمل ولهجات تخفيض السعر.                |
-| `<SlashCommandMenu>`             | تحتاج إلى أمر الشرطة المائلة المشترك UI لسطح Tiptap مخصص.                                          |
-| `<BubbleToolbar>`                | تحتاج إلى شريط أدوات التحديد المشترك للعلامات والروابط وactions المضمنة المخصصة.                   |
-| `createRegistryBlockNode()`      | تحتاج إلى عقد كتلة مدعومة بالتسجيل داخل محرر غني.                                                  |
-| `uploadEditorImage()`            | تريد إجراء تحميل صورة إطار العمل خلف كتلة الصور المشتركة للمحرر.                                   |
-| `useCollabReconcile()`           | أنت تقوم بربط سطح محرر مخصص بمستند Yjs مع الحفاظ على تخفيض السعر كحالة محفوظة.                     |
+| API                              | استخدم عندما                                                                                    |
+| -------------------------------- | ----------------------------------------------------------------------------------------------- |
+| `<SharedRichEditor>`             | أنت بحاجة إلى المحرر الحالي القابل للتكوين مع تسلسل Markdown، وYjs الاختيارية، وإضافات التطبيق. |
+| `<RichMarkdownEditor>`           | أنت بحاجة إلى الاسم المستعار المتوافق مع الإصدارات السابقة للمحرر الغني المشترك.                |
+| `createSharedEditorExtensions()` | أنت تقوم بإنشاء محرر Tiptap الخاص بك ولكنك تريد مخطط إطار العمل ولهجات Markdown.                |
+| `<SlashCommandMenu>`             | تحتاج إلى أمر الشرطة المائلة المشترك UI لسطح Tiptap مخصص.                                       |
+| `<BubbleToolbar>`                | تحتاج إلى شريط أدوات التحديد المشترك للعلامات والروابط وactions المضمنة المخصصة.                |
+| `createRegistryBlockNode()`      | تحتاج إلى عقد كتلة مدعومة بالتسجيل داخل محرر غني.                                               |
+| `uploadEditorImage()`            | تريد إجراء تحميل صورة إطار العمل خلف كتلة الصور المشتركة للمحرر.                                |
+| `useCollabReconcile()`           | أنت تقوم بربط سطح محرر مخصص بمستند Yjs مع الحفاظ على Markdown كحالة محفوظة.                     |
 
 المحرر الأساسي الذي يتم التحكم فيه هو مجرد تخفيض للداخل وتخفيض للخارج:
 

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

@@ -133,7 +133,7 @@ if (url?.searchParams) {
       "id": "hero-title",
       "selector": "[data-block-id='hero-title']",
       "label": "Hero title",
-      "text": "Q3 launch plan"
+      "text": "إطلاق الربع الثالث plan"
     }
   ],
   "capturedAt": 1780332977027
@@ -226,7 +226,7 @@ await setClientAppState(
 ```an-callout
 {
   "tone": "info",
-  "body": "**Keep `navigation` and `selection` small.** Store IDs plus short labels, not whole records. `view-screen` fetches the source of truth on demand, so stale or bulky state never reaches the agent."
+  "body": "**احتفظ بـ `navigation` و`selection` صغيرين.** معرفات المتجر بالإضافة إلى التسميات القصيرة، وليس السجلات الكاملة. `view-screen` يجلب مصدر الحقيقة عند الطلب، لذلك لا تصل الحالة القديمة أو الضخمة إلى الوكيل أبدًا."
 }
 ```
 
@@ -271,7 +271,7 @@ function askAgentAboutSelection(selection: {
 
 `sendToAgentChat()` هو برنامج تضمين المتصفح المدعوم لمسار الدردشة المرسلة والذي يُرى أحيانًا داخليًا باسم `agentNative.submitChat`. يجب أن يستدعي التطبيق UI المجمّع بدلاً من نشر `agentNative.submitChat` مباشرة لأن المجمّع يتعامل مع الأشرطة الجانبية المحلية، وتوجيه Builder/الإطار، وتوجيه مضيف التطبيق MCP، ومعرفات علامات التبويب، وتوجيه طلب التعليمات البرمجية.
 
-استخدم `agentChat.submit()` أو `agentChat.prefill()` لسياقات العقدة/البرنامج النصي حيث لا يوجد شريط جانبي للمتصفح. بشكل عام، يجب ألا يقوم الخادم actions باستدعاء `sendToAgentChat()` للمتصفح فقط؛ إذا كان الإجراء يحتاج إلى UI المفتوح ليطلب من الوكيل شيئًا ما، فاكتب طلبًا صغيرًا في `application_state` ودع جسر UI يرسله من المتصفح.
+استخدم `agentChat.submit()` أو `agentChat.prefill()` لسياقات العقدة/البرنامج النصي حيث لا يوجد شريط جانبي للمتصفح. بشكل عام, يجب ألا يقوم الخادم actions باستدعاء `sendToAgentChat()` للمتصفح فقط؛ إذا كان الإجراء يحتاج إلى UI المفتوح ليطلب من الوكيل شيئًا ما، فاكتب طلبًا صغيرًا في `application_state` ودع جسر UI يرسله من المتصفح.
 
 ### العناصر التي تم النقر عليها في المطالبة {#clicked-items-in-prompt}
 

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

@@ -69,7 +69,7 @@ npx @agent-native/core@latest create my-platform
 
 ```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>",
+  "html": "<div class=\"diagram-tmpl\"><div class=\"diagram-col\"><div class=\"diagram-node\">واجهة React<br><small class=\"diagram-muted\">app/routes · المكونات</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\">الإجراءات</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 عبر 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\">مزامنة بالاستقصاء</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}"
 }
 ```
@@ -137,9 +137,9 @@ export default runMigrations(
 
 استخدم مستندات [Database](/docs/database) و[Security](/docs/security) قبل إضافة المخططات التي تحتوي على بيانات المستخدم أو بيانات المؤسسة.
 
-## حدد العمليات كـ Actions {#actions}
+## حدد العمليات كـ الإجراءات {#actions}
 
-Actions هي المصدر الوحيد لحقيقة سلوك التطبيق. يستدعيها الوكيل كأدوات، وتستدعيها الواجهة الأمامية من خلال الخطافات، ويمكن للتطبيقات الأخرى الوصول إليها من خلال MCP/A2A.
+الإجراءات هي المصدر الوحيد لحقيقة سلوك التطبيق. يستدعيها الوكيل كأدوات، وتستدعيها الواجهة الأمامية من خلال الخطافات، ويمكن للتطبيقات الأخرى الوصول إليها من خلال MCP/A2A.
 
 ```an-annotated-code title="actions/create-project.ts"
 {
@@ -148,9 +148,9 @@ Actions هي المصدر الوحيد لحقيقة سلوك التطبيق. ي
   "code": "import { defineAction } from \"@agent-native/core/action\";\nimport { getDb } from \"../server/db/index.js\";\nimport { nanoid } from \"nanoid\";\nimport { z } from \"zod\";\nimport * as schema from \"../server/db/schema\";\n\nexport default defineAction({\n  description: \"Create a project.\",\n  schema: z.object({\n    title: z.string().min(1).describe(\"Project title\"),\n  }),\n  run: async ({ title }, ctx) => {\n    const db = getDb();\n    const id = nanoid();\n    await db.insert(schema.projects).values({\n      id,\n      title,\n      ownerEmail: ctx.userEmail,\n      orgId: ctx.orgId,\n    });\n    return { id, title };\n  },\n});",
   "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": "8", "label": "سطح الأداة", "note": "`description` هو ما يقرأه الوكيل ليقرر متى يتم استدعاء هذا الإجراء كأداة." },
     { "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." }
+    { "lines": "18-19", "label": "كتابة محددة النطاق", "note": "ختم `ownerEmail` / `orgId` من `ctx` بحيث يتم تحديد نطاق الصف بشكل صحيح لعمليات التحقق من المشاركة والوصول." }
   ]
 }
 ```
@@ -278,21 +278,21 @@ export default defineAction({
 الفهرس:
 
 ```markdown
-# My Template
+# القالب الخاص بي
 
 One workspace for projects, tasks, and notes.
 
-## Core Rules
+## القواعد الأساسية
 
-- Data lives in SQL via Drizzle. Use actions for all writes; schema is additive.
+- Data lives in SQL عبر Drizzle. Use actions for all writes; schema is additive.
 - Use `view-screen` before acting on "this project" if the screen is unclear.
 
-## Application State
+## حالة التطبيق
 
 - `navigation.view`: `home` | `project`
 - `navigation.projectId`: selected project on a project page
 
-## Actions
+## الإجراءات
 
 | Action           | Purpose                  |
 | ---------------- | ------------------------ |
@@ -316,11 +316,11 @@ name: project-imports
 description: How to import projects from the legacy CSV export.
 ---
 
-# Project Imports
+# واردات المشروع
 
 Use this skill when the user uploads a legacy project CSV.
 
-## Rules
+## القواعد
 
 - Validate required columns before creating rows.
 - Use `create-project` for each project so ownership and sync are correct.

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

@@ -28,7 +28,7 @@ description: "قم بتسجيل الدخول مرة واحدة عبر كل تط
 
 ```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>",
+  "html": "<div class=\"diagram-sso\"><div class=\"diagram-card\" data-rough><strong>تطبيق العميل</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>استدعاء التطبيق</strong><small class=\"diagram-muted\">verify signature · scope:identity · exp &le; 2 min</small><span class=\"diagram-pill ok\">ربط فوري عبر البريد</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}"
 }
 ```
@@ -103,7 +103,7 @@ AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.agent-native.com
 ```an-callout
 {
   "tone": "success",
-  "body": "**Safe to enable, safe to revert.** Identity writes are **additive only** — an existing same-email account is reused untouched, and a new email just inserts a fresh row. There is no schema change and nothing to migrate, so flipping `AGENT_NATIVE_IDENTITY_HUB_URL` on or off is fully reversible at any time, per app."
+  "body": "**آمن للتمكين، وآمن للرجوع.** تعد عمليات كتابة الهوية **إضافية فقط** — تتم إعادة استخدام حساب البريد الإلكتروني الحالي دون تغيير، ويقوم البريد الإلكتروني الجديد فقط بإدراج صف جديد. لا يوجد أي تغيير في المخطط ولا يوجد أي شيء لترحيله، لذا فإن تشغيل `AGENT_NATIVE_IDENTITY_HUB_URL` أو إيقاف تشغيله يمكن عكسه بالكامل في أي وقت لكل تطبيق."
 }
 ```
 
@@ -111,7 +111,7 @@ AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.agent-native.com
 
 ```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>",
+  "html": "<div class=\"diagram-jit\"><div class=\"diagram-node\" data-rough>بريد إلكتروني موثق<br><small class=\"diagram-muted\">من 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>إصدار جلسة محلية عادية</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

@@ -89,13 +89,13 @@ export const tasks = table("tasks", {
 
 يحدد الجدول `tasks` أعلاه نفس الأعمدة في كل واجهة خلفية:
 
-```an-schema title="The tasks table" summary="Defined once with the framework helpers; the dialect is chosen at runtime from DATABASE_URL."
+```an-schema title="جدول المهام" summary="يُعرّف مرة واحدة باستخدام مساعدات framework؛ ويُختار dialect في وقت التشغيل من DATABASE_URL."
 {
   "entities": [
     {
       "id": "tasks",
       "name": "tasks",
-      "note": "Domain table. Add owner_email (or ...ownableColumns()) so SQL-level scoping can filter rows to the authenticated user.",
+      "note": "جدول نطاق العمل. أضف owner_email (أو ...ownableColumns()) كي يقيّد scoping على مستوى SQL الصفوف بالمستخدم authenticated.",
       "fields": [
         { "name": "id", "type": "text", "pk": true, "nullable": false },
         { "name": "title", "type": "text", "nullable": false },
@@ -112,7 +112,7 @@ export const tasks = table("tasks", {
 
 لا تقم مطلقًا بالاستيراد من `drizzle-orm/sqlite-core` أو `drizzle-orm/pg-core` مباشرةً. استخدم دائمًا `@agent-native/core/db/schema`.
 
-يجب أن تتضمن الجداول التي تخزن البيانات التي تواجه المستخدم عمود `owner_email` حتى يتمكن نطاق مستوى SQL الخاص بإطار العمل من تصفية الصفوف للمستخدم المصادق عليه - راجع [Security](/docs/security#data-scoping). يجب أن تنشر الجداول التي تدعم أيضًا المشاركة مع مستخدمين أو مؤسسات أخرى `...ownableColumns()` بدلاً من ذلك، مما يضيف `owner_email`، و`org_id`، و`visibility` في مكالمة واحدة - راجع [Sharing](/docs/sharing#building).
+يجب أن تتضمن الجداول التي تخزن البيانات التي تواجه المستخدم عمود `owner_email` حتى يتمكن نطاق مستوى SQL الخاص بإطار العمل من تصفية الصفوف للمستخدم المصادق عليه - راجع [Security](/docs/security#data-scoping). يجب أن تنشر الجداول التي تدعم أيضًا المشاركة مع مستخدمين أو مؤسسات أخرى `...ownableColumns()` بدلاً من ذلك، مما يضيف `owner_email`، و`org_id`, و`visibility` في مكالمة واحدة - راجع [Sharing](/docs/sharing#building).
 
 للقراءة والكتابة، استخدم منشئ الاستعلامات والمشغلات المحمولة Drizzle من `drizzle-orm`:
 
@@ -134,7 +134,7 @@ await db.update(tasks).set({ done: true }).where(eq(tasks.id, taskId));
 
 ## فتحات الهروب SQL الخام {#raw-sql}
 
-Raw SQL ليس رمز التطبيق الافتراضي API. استخدمه فقط لعمليات الترحيل الإضافية، أو فحوصات السلامة، أو الاستعلامات المتقدمة التي تمت مراجعتها بعناية والتي لا يمكن لـ Drizzle التعبير عنها، أو الصيانة لمرة واحدة. اجعلها ذات معلمات وحيادية اللهجة. بالنسبة للطوابع الزمنية في مخططات Drizzle، تفضل `.default(now())`؛ بالنسبة للترحيل SQL، استخدم `runMigrations()` بحيث تظل عمليات إعادة كتابة التوافق المدعومة بإطار العمل وتبقى البيانات المرتبطة باللهجات مركزية.
+Raw SQL ليس رمز التطبيق الافتراضي API. استخدمه فقط لعمليات الترحيل الإضافية، أو فحوصات السلامة، أو الاستعلامات المتقدمة التي تمت مراجعتها بعناية والتي لا يمكن لـ Drizzle التعبير عنها، أو الصيانة لمرة واحدة. اجعلها ذات معلمات وحيادية اللهجة. بالنسبة للطوابع الزمنية في مخططات Drizzle، تفضل `.default(now())`؛ بالنسبة للترحيل SQL, استخدم `runMigrations()` بحيث تظل عمليات إعادة كتابة التوافق المدعومة بإطار العمل وتبقى البيانات المرتبطة باللهجات مركزية.
 
 بالنسبة للحالات التي تحتاج فيها حقًا إلى SQL خام خارج استعلامات Drizzle:
 
@@ -168,9 +168,9 @@ Raw SQL ليس رمز التطبيق الافتراضي API. استخدمه فق
   "language": "ts",
   "code": "import { runMigrations } from \"@agent-native/core/db\";\n\nexport default runMigrations(\n  [\n    {\n      version: 1,\n      sql: `ALTER TABLE projects ADD COLUMN IF NOT EXISTS sort_order INTEGER NOT NULL DEFAULT 0`,\n    },\n    {\n      // Dialect-gated: runs only on the matching backend. Omit the other key\n      // to make it a no-op on that dialect.\n      version: 2,\n      sql: {\n        postgres: `ALTER TABLE projects ADD COLUMN IF NOT EXISTS tsv tsvector`,\n        sqlite: `SELECT 1`, // no-op; tsvector is Postgres-only\n      },\n    },\n  ],\n  { table: \"my_app_migrations\" },\n);",
   "annotations": [
-    { "lines": "6-7", "label": "Additive only", "note": "`ADD COLUMN IF NOT EXISTS` is safe to re-run and never drops data. Renames look like drop+create to Drizzle, so add-then-migrate instead." },
-    { "lines": "13-16", "label": "Dialect gating", "note": "Pass an object keyed by dialect to run different SQL per backend. Make the other key a no-op (`SELECT 1`) for Postgres-only or SQLite-only features." },
-    { "lines": "19", "label": "Per-app version table", "note": "Each app tracks its own applied versions so migrations are idempotent across restarts and instances." }
+    { "lines": "6-7", "label": "مادة مضافة فقط", "note": "`ADD COLUMN IF NOT EXISTS` آمن لإعادة التشغيل ولا يسقط البيانات أبدًا. تبدو عمليات إعادة التسمية على شكل إسقاط + إنشاء إلى Drizzle، لذا قم بالإضافة ثم الترحيل بدلاً من ذلك." },
+    { "lines": "13-16", "label": "بوابة اللهجة", "note": "Pass an object keyed by dialect to run different SQL per backend. Make the other key a no-op (`SELECT 1`) for Postgres-only or SQLite-only features." },
+    { "lines": "19", "label": "جدول الإصدارات لكل تطبيق", "note": "يتتبع كل تطبيق الإصدارات المطبقة الخاصة به بحيث تكون عمليات الترحيل غير فعالة عبر عمليات إعادة التشغيل والمثيلات." }
   ]
 }
 ```

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

@@ -30,7 +30,7 @@ npx @agent-native/core@latest deploy
 
 ```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>",
+  "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\">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}"
 }
 ```
@@ -85,7 +85,7 @@ npx @agent-native/core@latest deploy --preset vercel
 
 ```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>",
+  "html": "<div class=\"diagram-deploy\"><div class=\"diagram-box\" data-rough>مصدر التطبيق</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill 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>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}"
 }
 ```
@@ -137,8 +137,8 @@ RUN pnpm build
 FROM node:24-slim
 WORKDIR /app
 COPY --from=build /app/.output .output
-# data/ is a runtime-created SQLite directory — do not copy a dev DB into prod.
-# For production, set DATABASE_URL to a hosted Postgres or Turso instance.
+# data/ هو دليل SQLite تم إنشاؤه في وقت التشغيل - لا تنسخ قاعدة بيانات التطوير إلى المنتج.
+# للإنتاج، قم بتعيين DATABASE_URL إلى مثيل Postgres أو Turso المستضاف.
 RUN mkdir -p /app/data
 ENV PORT=3000
 EXPOSE 3000