@agent-native/core 0.76.7 → 0.76.8

package/dist/vite/index.d.ts

@@ -1,4 +1,4 @@
-export { defineConfig, type ClientConfigOptions, type NitroOptions, } from "./client.js";
+export { agentNative, defineConfig, type AgentNativeVitePluginOptions, type ClientConfigOptions, type NitroOptions, } from "./client.js";
 export type { AgentNativeRouteWarmupConfigInput, AgentNativeRouteWarmupResolvedConfig, AgentNativeRouteWarmupStrategy, } from "../shared/route-warmup-config.js";
 export { actionTypesPlugin, generateActionRegistryForProject, } from "./action-types-plugin.js";
 export { agentsBundlePlugin } from "./agents-bundle-plugin.js";

package/dist/vite/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,iCAAiC,EACjC,oCAAoC,EACpC,8BAA8B,GAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,iBAAiB,EACjB,gCAAgC,GACjC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,wBAAwB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,iCAAiC,EACjC,oCAAoC,EACpC,8BAA8B,GAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,iBAAiB,EACjB,gCAAgC,GACjC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,wBAAwB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,uBAAuB,CAAC"}

package/dist/vite/index.js

@@ -1,4 +1,4 @@
-export { defineConfig, } from "./client.js";
+export { agentNative, defineConfig, } from "./client.js";
 export { actionTypesPlugin, generateActionRegistryForProject, } from "./action-types-plugin.js";
 export { agentsBundlePlugin } from "./agents-bundle-plugin.js";
 export { createAgentWebVitePlugin, } from "./agent-web-plugin.js";

package/dist/vite/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,GAGb,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,iBAAiB,EACjB,gCAAgC,GACjC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,wBAAwB,GAEzB,MAAM,uBAAuB,CAAC","sourcesContent":["export {\n  defineConfig,\n  type ClientConfigOptions,\n  type NitroOptions,\n} from \"./client.js\";\nexport type {\n  AgentNativeRouteWarmupConfigInput,\n  AgentNativeRouteWarmupResolvedConfig,\n  AgentNativeRouteWarmupStrategy,\n} from \"../shared/route-warmup-config.js\";\nexport {\n  actionTypesPlugin,\n  generateActionRegistryForProject,\n} from \"./action-types-plugin.js\";\nexport { agentsBundlePlugin } from \"./agents-bundle-plugin.js\";\nexport {\n  createAgentWebVitePlugin,\n  type AgentWebVitePluginOptions,\n} from \"./agent-web-plugin.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,YAAY,GAIb,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,iBAAiB,EACjB,gCAAgC,GACjC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,wBAAwB,GAEzB,MAAM,uBAAuB,CAAC","sourcesContent":["export {\n  agentNative,\n  defineConfig,\n  type AgentNativeVitePluginOptions,\n  type ClientConfigOptions,\n  type NitroOptions,\n} from \"./client.js\";\nexport type {\n  AgentNativeRouteWarmupConfigInput,\n  AgentNativeRouteWarmupResolvedConfig,\n  AgentNativeRouteWarmupStrategy,\n} from \"../shared/route-warmup-config.js\";\nexport {\n  actionTypesPlugin,\n  generateActionRegistryForProject,\n} from \"./action-types-plugin.js\";\nexport { agentsBundlePlugin } from \"./agents-bundle-plugin.js\";\nexport {\n  createAgentWebVitePlugin,\n  type AgentWebVitePluginOptions,\n} from \"./agent-web-plugin.js\";\n"]}

package/docs/content/deployment.md

@@ -95,12 +95,11 @@ The output is self-contained — copy `.output/` to any environment and run it.
 By default, Nitro builds for Node.js. To target a different platform, set the preset in your `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 @@ The Nitro `netlify` preset works well and, in practice, has given us much faster
 ```ts
 // vite.config.ts
 export default defineConfig({
-  nitro: { preset: "netlify" },
+  plugins: [agentNative({ nitro: { preset: "netlify" } })],
 });
 ```
 
@@ -201,7 +200,7 @@ The workspace build writes static assets under `dist/_workspace_static/` and rou
 ```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/internationalization.md

@@ -115,6 +115,12 @@ and leave routes, action names, protocol fields, env vars, and provider names
 untranslated. If a locale has no translated Markdown for a page, the docs site
 falls back to English for that page while still localizing navigation and chrome.
 
+Docs Markdown may include structured `an-*` visual blocks. Translate their
+user-facing prose fields where it makes sense, such as file-tree titles and
+`entries[].note`, callout bodies, tab labels, and annotated-code labels/notes.
+Keep stable identifiers unchanged: filenames, paths, env vars, route strings,
+action names, language tags, code snippets, JSON keys, and protocol names.
+
 ## Actions And Persistence
 
 Every app inherits:

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

@@ -20,9 +20,9 @@ A2A هو الركيزة الأساسية للتفويض عبر التطبيقا
 - **المهام** — تنشئ كل رسالة مهمة ذات دورة حياة (تم الإرسال، والعمل، والإكمال، والفشل، والإلغاء)
 - **مصادقة حامل JWT** — إنتاج A2A يتطلب `A2A_SECRET` أو `apiKeyEnv` قديم صريح
 
-```an-diagram title="One agent hands work to another" summary="A mail agent discovers the analytics agent's card, sends a JSON-RPC message, and gets a completed task back."
+```an-diagram title="وكيل يد واحد يعمل لآخر" summary="يكتشف وكيل البريد بطاقة وكيل التحليلات، ويرسل رسالة JSON-RPC، ويستعيد مهمة مكتملة."
 {
-  "html": "<div class=\"diagram-handoff\"><div class=\"diagram-card\"><strong>Mail agent</strong><small class=\"diagram-muted\">needs analytics</small></div><div class=\"diagram-col\"><div class=\"diagram-pill\">GET /.well-known/agent-card.json</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">POST /_agent-native/a2a<br><small class=\"diagram-muted\">message/send</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div><div class=\"diagram-pill ok\">task · completed</div></div><div class=\"diagram-card\" data-rough><strong>Analytics agent</strong><small class=\"diagram-muted\">runs run-query, returns result</small></div></div>",
+  "html": "<div class=\"diagram-handoff\"><div class=\"diagram-card\"><strong>وكيل البريد</strong><small class=\"diagram-muted\">يحتاج إلى تحليلات</small></div><div class=\"diagram-col\"><div class=\"diagram-pill\">GET /.well-known/agent-card.json</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">GET /_agent-native/a2a<br><small class=\"diagram-muted\">message/send</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div><div class=\"diagram-pill ok\">المهمة · اكتملت</div></div><div class=\"diagram-card\" data-rough><strong>وكيل التحليلات</strong><small class=\"diagram-muted\">تشغيل استعلام التشغيل، وإرجاع النتيجة</small></div></div>",
   "css": ".diagram-handoff{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.diagram-handoff .diagram-col{display:flex;flex-direction:column;align-items:center;gap:6px}.diagram-handoff .diagram-arrow{font-size:20px;line-height:1}"
 }
 ```
@@ -146,9 +146,9 @@ _(قد يختلف الإصدار؛ احصل على البطاقة المباشر
 
 عندما يتم استدعاء `message/send` باستخدام `async: true`، يقوم معالج JSON-RPC بإدراج المهمة في قائمة الانتظار وإطلاق POST ذاتيًا إلى مسار `/_agent-native/a2a/_process-task` داخلي بحيث يعمل المعالج في تنفيذ وظيفة جديدة مع مهلة كاملة خاصة به. تمت مصادقة هذا المسار باستخدام رمز HMAC المرتبط بمعرف المهمة (عمر 5 دقائق، موقع بـ `A2A_SECRET`). يتم تثبيته قبل المسار `/_agent-native/a2a` JSON-RPC، لذا لا تبتلعه مطابقة بادئة h3.
 
-```an-diagram title="Async task lifecycle on serverless" summary="async:true returns working in milliseconds, then a fresh execution runs the agent loop while the caller polls."
+```an-diagram title="دورة حياة مهمة غير متزامنة على خادم" summary="async:true يُرجع العمل بالمللي ثانية، ثم يقوم تنفيذ جديد بتشغيل حلقة الوكيل أثناء استقصاء المتصل."
 {
-  "html": "<div class=\"diagram-async\"><div class=\"diagram-box\" data-rough>message/send<br><small class=\"diagram-muted\">async: true</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\"><span class=\"diagram-pill\">enqueue task</span><span class=\"diagram-pill warn\">return working</span><small class=\"diagram-muted\">~milliseconds</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>self-fire POST /_agent-native/a2a/_process-task<br><small class=\"diagram-muted\">HMAC token · fresh execution · full timeout</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-pill\">tasks/get (poll)</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-pill ok\">completed</div></div></div>",
+  "html": "<div class=\"diagram-async\"><div class=\"diagram-box\" data-rough>message/send<br><small class=\"diagram-muted\">غير متزامن: صحيح</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\"><span class=\"diagram-pill\">مهمة سرد</span><span class=\"diagram-pill warn\">عودة العمل</span><small class=\"diagram-muted\">~ ميلي ثانية</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>إطلاق نار ذاتي POST /_agent-native/a2a/_process-task<br><small class=\"diagram-muted\">رمز POST المميز · تنفيذ جديد · مهلة كاملة</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-pill\">tasks/get (استطلاع)</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-pill ok\">مكتمل</div></div></div>",
   "css": ".diagram-async{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-async .diagram-panel{display:flex;flex-direction:column;align-items:center;gap:6px}.diagram-async .diagram-col{display:flex;flex-direction:column;align-items:center;gap:6px}.diagram-async .diagram-arrow{font-size:20px;line-height:1}",
   "caption": "A recurring sweeper re-claims any task left in flight if the function execution dies mid-run."
 }
@@ -160,14 +160,26 @@ _(قد يختلف الإصدار؛ احصل على البطاقة المباشر
 
 تحتوي الرسائل على أجزاء مكتوبة - يمكن للنصوص والبيانات المنظمة والملفات أن تنتقل في رسالة واحدة:
 
-```an-annotated-code title="A2A message with typed parts"
+```an-annotated-code title="A2A رسالة تحتوي على أجزاء مكتوبة"
 {
   "language": "json",
   "code": "{\n  \"role\": \"user\",\n  \"parts\": [\n    { \"type\": \"text\", \"text\": \"Show signups by source\" },\n    { \"type\": \"data\", \"data\": { \"dateRange\": \"last-30d\" } },\n    {\n      \"type\": \"file\",\n      \"file\": { \"name\": \"report.csv\", \"mimeType\": \"text/csv\", \"bytes\": \"...\" }\n    }\n  ]\n}",
   "annotations": [
-    { "lines": "4", "label": "text part", "note": "Plain natural-language instruction the agent reads." },
-    { "lines": "5", "label": "data part", "note": "Structured JSON arguments — e.g. a date range — passed alongside the prompt." },
-    { "lines": "6-9", "label": "file part", "note": "Attach a file by name, `mimeType`, and base64 `bytes`." }
+    {
+      "lines": "4",
+      "label": "جزء النص",
+      "note": "تعليمات بسيطة باللغة الطبيعية يقرأها الوكيل."
+    },
+    {
+      "lines": "5",
+      "label": "جزء البيانات",
+      "note": "وسيطات JSON المنظمة - على سبيل المثال نطاق زمني - تم تمريره بجانب المطالبة."
+    },
+    {
+      "lines": "6-9",
+      "label": "جزء الملف",
+      "note": "قم بإرفاق ملف بالاسم، `mimeType`، وbase64 `bytes`."
+    }
   ]
 }
 ```

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

@@ -19,9 +19,9 @@ Actions هي المصدر الوحيد للحقيقة لأي شيء يفعله
 إذا كنت تقرر ما إذا كنت ستكشف عن عملية بدون رأس، في الدردشة، في
 السيارة الجانبية المضمنة، أو كشاشة تطبيق كاملة، راجع [Agent Surfaces](/docs/agent-surfaces).
 
-```an-diagram title="One definition, seven consumers" summary="A single defineAction() fans out to every surface — agent, UI, HTTP, MCP, A2A, and CLI — with one validated schema and one run() body."
+```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\">schema + run(), defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><div class=\"diagram-node\">Agent tool<br><small class=\"diagram-muted\">JSON Schema in context</small></div><div class=\"diagram-node\">React hooks<br><small class=\"diagram-muted\">useActionQuery/Mutation</small></div><div class=\"diagram-node\">callAction()<br><small class=\"diagram-muted\">imperative client</small></div><div class=\"diagram-node\">HTTP<br><small class=\"diagram-muted\">/_agent-native/actions/:name</small></div><div class=\"diagram-node\">MCP tool<br><small class=\"diagram-muted\">external hosts</small></div><div class=\"diagram-node\">A2A tool<br><small class=\"diagram-muted\">other agent-native apps</small></div><div class=\"diagram-node\">CLI<br><small class=\"diagram-muted\">pnpm action &lt;name&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}"
 }
 ```
@@ -79,15 +79,27 @@ pnpm agent "Call hello for Steve and explain the result"
 
 ## تعريف الإجراء {#defining}
 
-```an-annotated-code title="Anatomy of an action"
+```an-annotated-code title="تشريح الفعل"
 {
   "filename": "actions/reply-to-email.ts",
   "language": "ts",
   "code": "import { defineAction } from \"@agent-native/core/action\";\nimport { z } from \"zod\";\n\nexport default defineAction({\n  description: \"Reply to an email thread in the user's voice.\",\n  schema: z.object({\n    emailId: z.string().describe(\"The id of the email to reply to.\"),\n    body: z.string().describe(\"The reply body, in markdown.\"),\n  }),\n  run: async ({ emailId, body }) => {\n    await db.insert(replies).values({ emailId, body });\n    return { ok: true, emailId };\n  },\n});",
   "annotations": [
-    { "lines": "5", "label": "Tool surface", "note": "`description` is what the agent reads to decide when to call this. The per-field `.describe()` calls flow into the JSON Schema too." },
-    { "lines": "6-9", "label": "عقد typed", "note": "One schema validates input from **every** surface and is converted to JSON Schema for the model. Invalid inputs never reach `run`." },
-    { "lines": "10-13", "label": "One implementation", "note": "The `run` body is the single source of truth — the UI button and the agent tool both execute exactly this." }
+    {
+      "lines": "5",
+      "label": "سطح الأداة",
+      "note": "`description` هو ما يقرأه الوكيل ليقرر متى يتم الاتصال به. تتدفق مكالمات `.describe()` لكل حقل إلى مخطط JSON أيضًا."
+    },
+    {
+      "lines": "6-9",
+      "label": "عقد typed",
+      "note": "يتحقق مخطط واحد من صحة الإدخال من **كل** السطح ويتم تحويله إلى مخطط JSON للنموذج. لا تصل المدخلات غير الصالحة أبدًا إلى `run`."
+    },
+    {
+      "lines": "10-13",
+      "label": "التنفيذ واحد",
+      "note": "يعد نص `run` المصدر الوحيد للحقيقة - حيث يقوم زر واجهة المستخدم وأداة الوكيل بتنفيذ ذلك بالضبط."
+    }
   ]
 }
 ```

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

@@ -29,9 +29,9 @@ description: "ضع علامة على الوكلاء المخصصين والوك
 
 في كلتا الحالتين، يرى وكيلك الرئيسي الاستجابة ويمكنه الرجوع إليها أو البناء عليها.
 
-```an-diagram title="Where an @-mention routes" summary="The server splits each mention by type: custom agents run locally, connected agents go over A2A — both responses fold back into the main agent's context."
+```an-diagram title="حيث @-طرق الإشارة" summary="يقوم الخادم بتقسيم كل إشارة حسب النوع: يتم تشغيل الوكلاء المخصصين محليًا، وينتقل الوكلاء المتصلون عبر A2A - يتم طي كلا الاستجابتين مرة أخرى في سياق الوكيل الرئيسي."
 {
-  "html": "<div class=\"diagram-mention\"><div class=\"diagram-node\">@-mention<br><small class=\"diagram-muted\">in the composer</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\">Server resolves</span><small class=\"diagram-muted\">extract refs by type</small></div><div class=\"diagram-col\"><div class=\"row\"><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\">Custom agent<br><small class=\"diagram-muted\">agents/*.md &middot; runs local</small></div></div><div class=\"row\"><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\">Connected agent<br><small class=\"diagram-muted\">A2A peer &middot; remote call</small></div></div></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box diagram-accent\">&lt;agent-response&gt;<br><small class=\"diagram-muted\">injected into main agent</small></div></div>",
+  "html": "<div class=\"diagram-mention\"><div class=\"diagram-node\">@-يذكر<br><small class=\"diagram-muted\">في الملحن</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">الخادم يحل</span><small class=\"diagram-muted\">استخراج المراجع حسب النوع</small></div><div class=\"diagram-col\"><div class=\"row\"><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\">وكيل مخصص<br><small class=\"diagram-muted\">وكلاء/*.md &middot; يدير المحلية</small></div></div><div class=\"row\"><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\">وكيل متصل<br><small class=\"diagram-muted\">A2A نظير &middot; مكالمة عن بعد</small></div></div></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box diagram-accent\">&lt;agent-response&gt;<br><small class=\"diagram-muted\">حقنها في العامل الرئيسي</small></div></div>",
   "css": ".diagram-mention{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-mention .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px}.diagram-mention .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-mention .row{display:flex;align-items:center;gap:8px}.diagram-mention .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -119,15 +119,27 @@ You are a focused design agent.
 
 يمكن للقوالب تسجيل موفري الإشارات المخصصة لإضافة عناصر قابلة للذكر خاصة بالمجال بخلاف الوكلاء والملفات. يقوم موفر الإشارة بتنفيذ واجهة `MentionProvider`:
 
-```an-annotated-code title="A custom MentionProvider"
+```an-annotated-code title="مزود ذكر مخصص"
 {
   "filename": "server/mentions/contacts.ts",
   "language": "ts",
   "code": "import type { MentionProvider } from \"@agent-native/core/server\";\n\nconst contactsProvider: MentionProvider = {\n  id: \"contacts\",\n  label: \"Contacts\",\n\n  // Search for mentionable items\n  async search(query: string) {\n    const contacts = await db.query.contacts.findMany({\n      where: like(contacts.name, `%${query}%`),\n      limit: 10,\n    });\n    return contacts.map((c) => ({\n      id: c.id,\n      label: c.name,\n      description: c.email,\n      type: \"contact\",\n    }));\n  },\n\n  // Resolve a mention into context for the agent\n  async resolve(id: string) {\n    const contact = await db.query.contacts.findFirst({\n      where: eq(contacts.id, id),\n    });\n    return {\n      type: \"context\",\n      text: `Contact: ${contact.name} (${contact.email})`,\n    };\n  },\n};",
   "annotations": [
-    { "lines": "4-5", "label": "Identity", "note": "`id` namespaces the provider; `label` is the section heading shown in the `@` popover." },
-    { "lines": "8-9", "label": "search", "note": "Runs as the user types after `@`. Return up to a handful of matches as `{ id, label, description, type }`." },
-    { "lines": "23-24", "label": "resolve", "note": "Called when the message is sent. Turns a picked id into `{ type: \"context\", text }` that is injected into the agent's context." }
+    {
+      "lines": "4-5",
+      "label": "هوية",
+      "note": "`id` مساحات الأسماء الموفر؛ `label` هو عنوان القسم الموضح في القائمة المنبثقة `@`."
+    },
+    {
+      "lines": "8-9",
+      "label": "يبحث",
+      "note": "يتم تشغيله أثناء قيام المستخدم بالكتابة بعد `@`. قم بإرجاع ما يصل إلى عدد قليل من التطابقات كـ `{ id, label, description, type }`."
+    },
+    {
+      "lines": "23-24",
+      "label": "حل",
+      "note": "يتم الاتصال به عند إرسال الرسالة. يحول المعرف المنتقى إلى `{ type: \"context\", text }` الذي يتم إدخاله في سياق الوكيل."
+    }
   ]
 }
 ```

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

@@ -25,9 +25,9 @@ Agent-Native قابل للتأليف بشكل متعمد. يمكنك استخد
 وكيل بإجراء واحد، يظهر في الدردشة كجدول أو مخطط، ويصبح فيما بعد
 ملء الشاشة في التطبيق دون تغيير العملية التي يستدعيها الوكيل.
 
-```an-diagram title="The surface spectrum" summary="One action surface, four product shapes — each adds UI without changing the operation underneath."
+```an-diagram title="الطيف السطحي" summary="سطح عمل واحد، وأربعة أشكال للمنتج - كل منها يضيف واجهة مستخدم دون تغيير العملية الموجودة أسفله."
 {
-  "html": "<div class=\"diagram-spectrum\"><div class=\"diagram-card\"><strong>Headless</strong><small class=\"diagram-muted\">actions, jobs, scripts, other agents</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Rich chat</strong><small class=\"diagram-muted\">composer, transcript, tool cards</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Embedded sidecar</strong><small class=\"diagram-muted\">agent beside an existing app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">most UI</span><strong>Full application</strong><small class=\"diagram-muted\">durable screens, data, collaboration</small></div></div><div class=\"diagram-base\" data-rough><span class=\"diagram-muted\">same actions · same SQL · same agent loop</span></div>",
+  "html": "<div class=\"diagram-spectrum\"><div class=\"diagram-card\"><strong>مقطوعة الرأس</strong><small class=\"diagram-muted\">الإجراءات والوظائف والبرامج النصية والوكلاء الآخرين</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>دردشة غنية</strong><small class=\"diagram-muted\">الملحن، النص، بطاقات الأدوات</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>عربة جانبية مدمجة</strong><small class=\"diagram-muted\">الوكيل بجانب تطبيق موجود</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">معظم واجهة المستخدم</span><strong>التطبيق الكامل</strong><small class=\"diagram-muted\">شاشات متينة، بيانات، تعاون</small></div></div><div class=\"diagram-base\" data-rough><span class=\"diagram-muted\">نفس الإجراءات · نفس SQL · نفس حلقة الوكيل</span></div>",
   "css": ".diagram-spectrum{display:flex;align-items:stretch;gap:10px;flex-wrap:wrap}.diagram-spectrum .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:150px;flex:1}.diagram-spectrum .diagram-arrow{align-self:center;font-size:22px;line-height:1}.diagram-base{margin-top:12px;padding:10px 14px;text-align:center}"
 }
 ```
@@ -345,9 +345,9 @@ export function AppShell({ children }) {
 }
 ```
 
-```an-diagram title="How the sidecar bridges to a host app" summary="The plugin mounts Agent-Native routes server-side; the React sidecar streams page context in and host commands out."
+```an-diagram title="كيف يتم ربط السيارة الجانبية بتطبيق مضيف" summary="يقوم البرنامج المساعد بتثبيت مسارات Agent-Native من جانب الخادم؛ يقوم React بتدفق سياق الصفحة الجانبية وأوامر المضيف للخارج."
 {
-  "html": "<div class=\"diagram-sidecar\"><div class=\"diagram-panel\"><strong>Host app</strong><small class=\"diagram-muted\">your existing SaaS</small><div class=\"diagram-node\">getContext()<br><small class=\"diagram-muted\">route · selection</small></div><div class=\"diagram-node\">onNavigate / onRefresh<br><small class=\"diagram-muted\">host commands</small></div></div><div class=\"diagram-col-arrows\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div></div><div class=\"diagram-panel accent-panel\"><span class=\"diagram-pill accent\">AgentNativeEmbedded</span><small class=\"diagram-muted\">agent + workspace</small><div class=\"diagram-box\" data-rough>Agent-Native routes<br><small class=\"diagram-muted\">mounted by the server plugin</small></div></div></div>",
+  "html": "<div class=\"diagram-sidecar\"><div class=\"diagram-panel\"><strong>التطبيق المضيف</strong><small class=\"diagram-muted\">SaaS الموجودة لديك</small><div class=\"diagram-node\">getContext()<br><small class=\"diagram-muted\">الطريق · الاختيار</small></div><div class=\"diagram-node\">على التنقل / على التحديث<br><small class=\"diagram-muted\">أوامر المضيف</small></div></div><div class=\"diagram-col-arrows\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div></div><div class=\"diagram-panel accent-panel\"><span class=\"diagram-pill accent\">AgentNativeEmbedded</span><small class=\"diagram-muted\">وكيل + مساحة عمل</small><div class=\"diagram-box\" data-rough>Agent-Native الطرق<br><small class=\"diagram-muted\">التي تم تركيبها بواسطة البرنامج المساعد للخادم</small></div></div></div>",
   "css": ".diagram-sidecar{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-sidecar .diagram-panel{display:flex;flex-direction:column;gap:8px;padding:14px 16px;min-width:200px}.diagram-sidecar .diagram-col-arrows{display:flex;flex-direction:column;gap:6px}.diagram-sidecar .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```

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

@@ -20,9 +20,9 @@ description: "يعمل مفوضو الوكلاء الرئيسيون مع الو
 
 تستمر حالة الوكيل الفرعي في جدول `application_state` SQL (ضمن `agent-task:<taskId>`)، لذلك تظل المهام قادرة على البقاء على قيد الحياة مع عمليات التشغيل الباردة بدون خادم والعمل عبر عمليات متعددة.
 
-```an-diagram title="Orchestrator and specialists" summary="The main chat delegates to sub-agents that run in their own threads and report back as inline chips."
+```an-diagram title="المنسقين والمتخصصين" summary="تقوم الدردشة الرئيسية بتفويض الوكلاء الفرعيين الذين يعملون في سلاسل الرسائل الخاصة بهم ويقدمون تقاريرهم كشرائح مضمنة."
 {
-  "html": "<div class=\"at-orc\"><div class=\"diagram-card main\"><span class=\"diagram-pill accent\">Main chat</span><small class=\"diagram-muted\">orchestrator &mdash; reads your request, delegates</small></div><div class=\"at-fan\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"at-subs\"><div class=\"diagram-box\">Code review<br><small class=\"diagram-muted\">own thread &amp; prompt</small></div><div class=\"diagram-box\">BigQuery analysis<br><small class=\"diagram-muted\">own tools</small></div><div class=\"diagram-box\">Email in voice<br><small class=\"diagram-muted\">own context</small></div></div></div><div class=\"diagram-pill\">each appears inline as a live chip &#8635;</div></div>",
+  "html": "<div class=\"at-orc\"><div class=\"diagram-card main\"><span class=\"diagram-pill accent\">الدردشة الرئيسية</span><small class=\"diagram-muted\">منسق &mdash; يقرأ طلبك، المندوبين</small></div><div class=\"at-fan\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"at-subs\"><div class=\"diagram-box\">مراجعة الكود<br><small class=\"diagram-muted\">الخيط الخاص &amp; اِسْتَدْعَى</small></div><div class=\"diagram-box\">تحليل BigQuery<br><small class=\"diagram-muted\">الأدوات الخاصة</small></div><div class=\"diagram-box\">البريد الإلكتروني في الصوت<br><small class=\"diagram-muted\">السياق الخاص</small></div></div></div><div class=\"diagram-pill\">يظهر كل منها مضمنًا كشريحة حية &#8635;</div></div>",
   "css": ".at-orc{display:flex;flex-direction:column;align-items:center;gap:12px}.at-orc .diagram-card{padding:14px 18px;display:flex;flex-direction:column;gap:4px;align-items:center}.at-orc .at-fan{display:flex;flex-direction:column;align-items:center;gap:8px}.at-orc .diagram-arrow{font-size:22px}.at-orc .at-subs{display:flex;gap:12px;flex-wrap:wrap;justify-content:center}.at-orc .diagram-box{text-align:center}"
 }
 ```
@@ -85,9 +85,9 @@ const task = await spawnTask({
 
 ## دورة حياة المهمة {#lifecycle}
 
-```an-diagram title="What spawnTask() does" summary="Each spawn creates a thread, persists state to SQL, and streams chip events through to completion."
+```an-diagram title="ما يفعله spawnTask()" summary="ينشئ كل نشر سلسلة رسائل، ويستمر في الحالة إلى SQL، ويقوم بتدفق أحداث الشريحة حتى الاكتمال."
 {
-  "html": "<div class=\"at-life\"><div class=\"diagram-box\"><code>spawnTask()</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">create thread</span><small class=\"diagram-muted\">new row in <code>chat_threads</code>, description as first message</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">persist state</span><small class=\"diagram-muted\"><code>agent-task:&lt;id&gt;</code> &rarr; <code>application_state</code>, status=running</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">stream</span><small class=\"diagram-muted\"><code>agent_task_started</code> &rarr; chip appears; <code>agent_task_step</code> &rarr; chip updates live</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card ok\"><span class=\"diagram-pill ok\">complete</span><small class=\"diagram-muted\">status=completed, write summary + preview, emit <code>agent_task_done</code></small></div></div>",
+  "html": "<div class=\"at-life\"><div class=\"diagram-box\"><code>مهمة تفرخ ()</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">إنشاء موضوع</span><small class=\"diagram-muted\">صف جديد في <code>chat_threads</code>، الوصف كرسالة أولى</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">استمرار الحالة</span><small class=\"diagram-muted\"><code>مهمة الوكيل:&lt;بطاقة تعريف&gt;</code> &rarr; <code>application_state</code>الحالة = قيد التشغيل</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">تدفق</span><small class=\"diagram-muted\"><code>agent_task_started</code> &rarr; تظهر الشريحة؛ <code>agent_task_step</code> &rarr; تحديثات الشريحة مباشرة</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card ok\"><span class=\"diagram-pill ok\">مكتمل</span><small class=\"diagram-muted\">الحالة = مكتملة، اكتب ملخصًا + معاينة، انبعاث <code>agent_task_done</code></small></div></div>",
   "css": ".at-life{display:flex;flex-direction:column;align-items:stretch;gap:6px;max-width:560px}.at-life .diagram-card{display:flex;flex-direction:column;gap:3px;padding:10px 14px}.at-life .diagram-box{align-self:flex-start}.at-life .diagram-arrow{font-size:18px;align-self:center}"
 }
 ```
@@ -138,9 +138,9 @@ interface AgentTask {
 
 الدردشة ذات المستوى الأعلى هي العمق `0`. العامل الفرعي الذي يولده هو العمق `1`؛ قد يظهر هذا العامل الفرعي مرة أخرى (العمق `2`)؛ تم رفض النشر الذي من شأنه إنشاء وكيل فرعي للعمق `3` **. الحد الأقصى الافتراضي هو **2\*\*.
 
-```an-diagram title="Delegation depth guard (default cap 2)" summary="Each level may spawn one deeper until the cap; a spawn past it is refused server-side."
+```an-diagram title="حارس عمق التفويض (الغطاء الافتراضي 2)" summary="قد يؤدي كل مستوى إلى ظهور مستوى أعمق حتى الغطاء؛ تفرخ الماضي تم رفضه من جانب الخادم."
 {
-  "html": "<div class=\"at-depth\"><div class=\"diagram-card ok\"><span class=\"diagram-pill\">depth 0</span><strong>Top-level chat</strong><small class=\"diagram-muted ok\">may spawn &darr;</small></div><div class=\"diagram-card ok\"><span class=\"diagram-pill\">depth 1</span><strong>Sub-agent</strong><small class=\"diagram-muted ok\">may spawn &darr;</small></div><div class=\"diagram-card warn\"><span class=\"diagram-pill warn\">depth 2</span><strong>Sub-agent's sub-agent</strong><small class=\"diagram-muted\">at the cap &mdash; may NOT spawn</small></div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">depth 3</span><strong>Refused</strong><small class=\"diagram-muted\">server-side error</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>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>",
   "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}"
 }
 ```

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

@@ -19,9 +19,9 @@ description: "اجعل المسارات العامة قابلة للزحف، و
 
 يؤدي إعداد `publicMcp: true` أيضًا إلى كشف actions التي تم اختيارها كنقطة نهاية MCP عامة، مما يسمح للوكلاء الخارجيين بالاتصال بهم مباشرة (راجع [MCP Protocol](/docs/mcp-protocol)).
 
-```an-diagram title="What a public route publishes" summary="A public route fans out into agent-friendly representations. Reading the route is separate from calling tools — tool access stays opt-in."
+```an-diagram title="ما ينشر الطريق العام" summary="يتحول الطريق العام إلى تمثيلات صديقة للوكلاء. تعد قراءة المسار منفصلة عن أدوات الاتصال — ويظل الوصول إلى الأداة قيد الاشتراك."
 {
-  "html": "<div class=\"diagram-web\"><div class=\"diagram-box\" data-rough>Public route<br><small class=\"diagram-muted\">derived from route access settings</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><span class=\"diagram-pill\">robots.txt</span><span class=\"diagram-pill\">sitemap.xml</span><span class=\"diagram-pill\">llms.txt</span><span class=\"diagram-pill\">.md mirror</span><span class=\"diagram-pill\">JSON-LD</span><span class=\"diagram-pill\">text/markdown</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col gate\"><span class=\"diagram-pill warn\">Tools stay private</span><small class=\"diagram-muted\">publicMcp + publicAgent.expose required</small></div></div>",
+  "html": "<div class=\"diagram-web\"><div class=\"diagram-box\" data-rough>الطريق العام<br><small class=\"diagram-muted\">المستمدة من إعدادات الوصول إلى الطريق</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><span class=\"diagram-pill\">robots.txt</span><span class=\"diagram-pill\">sitemap.xml</span><span class=\"diagram-pill\">llms.txt</span><span class=\"diagram-pill\">مرآة .MD</span><span class=\"diagram-pill\">JSON-LD</span><span class=\"diagram-pill\">text/markdown</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col gate\"><span class=\"diagram-pill warn\">تظل الأدوات خاصة</span><small class=\"diagram-muted\">مطلوب publicMcp + publicAgent.expose</small></div></div>",
   "css": ".diagram-web{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-web .diagram-arrow{font-size:22px;line-height:1}.diagram-web .diagram-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}.diagram-web .gate{display:flex;flex-direction:column;gap:4px;align-items:flex-start}"
 }
 ```
@@ -83,14 +83,22 @@ description: "اجعل المسارات العامة قابلة للزحف، و
 
 للكشف عن إجراء من خلال بروتوكول الوكيل العام، يجب أن يتم تمكين الإجراء:
 
-```an-annotated-code title="Opting one safe action onto the public surface"
+```an-annotated-code title="اختيار إجراء آمن واحد على السطح العام"
 {
   "filename": "actions/search-docs.ts",
   "language": "ts",
   "code": "export default defineAction({\n  description: \"Search published docs\",\n  readOnly: true,\n  publicAgent: {\n    expose: true,\n    readOnly: true,\n    requiresAuth: false,\n    isConsequential: false,\n    title: \"Search published docs\",\n  },\n  run: async (args) => {\n    // ...\n  },\n});",
   "annotations": [
-    { "lines": "4", "label": "Explicit opt-in", "note": "Without `publicAgent.expose === true`, the action never appears on any public agent surface — no matter how public its routes are." },
-    { "lines": "5-7", "label": "Self-describe safety", "note": "Mark it read-only, declare whether it needs auth, and flag whether it is consequential. Public MCP excludes consequential/write actions unless policy explicitly allows them." }
+    {
+      "lines": "4",
+      "label": "الاشتراك الصريح",
+      "note": "بدون `publicAgent.expose === true`، لن يظهر الإجراء أبدًا على أي سطح وكيل عام - بغض النظر عن مدى عمومية مساراته."
+    },
+    {
+      "lines": "5-7",
+      "label": "وصف السلامة الذاتية",
+      "note": "قم بوضع علامة عليها للقراءة فقط، وأعلن ما إذا كانت تحتاج إلى مصادقة، وحدد ما إذا كانت ذات أهمية. يستبعد MCP العام إجراءات consequential/write ما لم تسمح بها السياسة صراحةً."
+    }
   ]
 }
 ```

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

@@ -15,9 +15,9 @@ description: "تكامل أفضل للمصادقة مع البريد الإلك
 - **جهاز التحكم عن بعد MCP OAuth:** معيار OAuth 2.1 لمضيفي MCP مثل Claude Code وموصلات ChatGPT.
 - **مخصص:** قم بإحضار المصادقة الخاصة بك عبر رد الاتصال `getSession`.
 
-```an-diagram title="Three ways in, one session" summary="Browser visitors, programmatic MCP clients, and custom providers all resolve to the same AuthSession that downstream scoping reads."
+```an-diagram title="ثلاث طرق في جلسة واحدة" summary="يقوم كل زوار المستعرض وعملاء MCP الآليين والموفرين المخصصين بالتوصل إلى نفس AuthSession الذي يقرأه النطاق النهائي."
 {
-  "html": "<div class=\"auth-modes\"><div class=\"diagram-col\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Default</span><strong>Better Auth</strong><small class=\"diagram-muted\">email/password &middot; Google &middot; GitHub</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">Remote MCP OAuth</span><strong>OAuth 2.1 + PKCE</strong><small class=\"diagram-muted\">Claude Code, ChatGPT connectors</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">Custom</span><strong>getSession callback</strong><small class=\"diagram-muted\">Clerk &middot; Auth0 &middot; Firebase</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill ok\">AuthSession</span><small class=\"diagram-muted\">email &middot; orgId &middot; orgRole</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Request context &amp; data scoping</div></div>",
+  "html": "<div class=\"auth-modes\"><div class=\"diagram-col\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">تقصير</span><strong>مصادقة أفضل</strong><small class=\"diagram-muted\">email/password &middot; جوجل &middot; جيثب</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">جهاز التحكم عن بعد MCP OAuth</span><strong>OAuth 2.1 + MCP</strong><small class=\"diagram-muted\">موصلات Claude Code، ChatGPT</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">مخصص</span><strong>رد اتصال getSession</strong><small class=\"diagram-muted\">موظف &middot; مصادقة0 &middot; Firebase</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill ok\">AuthSession</span><small class=\"diagram-muted\">بريد إلكتروني &middot; orgId &middot; orgRole</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">سياق الطلب &amp; نطاق البيانات</div></div>",
   "css": ".auth-modes{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.auth-modes .diagram-col{display:flex;flex-direction:column;gap:10px}.auth-modes .diagram-card{display:flex;flex-direction:column;gap:4px;padding:10px 12px}.auth-modes .diagram-arrow{font-size:22px;line-height:1}.auth-modes .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -165,9 +165,9 @@ https://mail.agent-native.com/_agent-native/mcp
 
 تقوم طلبات MCP غير المصادق عليها بإرجاع تحدي `WWW-Authenticate` الذي يشير إلى `/.well-known/oauth-protected-resource`. يكتشف العميل بعد ذلك بيانات تعريف OAuth الخاصة بالتطبيق، ويسجل عميلًا عامًا ديناميكيًا، ويفتح صفحة ترخيص التطبيق، ويتبادل رمز التفويض مع PKCE للوصول إلى الرموز المميزة وتحديثها.
 
-```an-diagram title="Remote MCP OAuth handshake" summary="An OAuth-capable client bootstraps from just the MCP URL — challenge, discovery, dynamic registration, then a PKCE code exchange."
+```an-diagram title="البعيد MCP OAuth المصافحة" summary="يبدأ تشغيل العميل القادر على OAuth من مجرد التحدي MCP URL - والاكتشاف والتسجيل الديناميكي، ثم تبادل التعليمات البرمجية PKCE."
 {
-  "html": "<div class=\"mcp-flow\"><div class=\"diagram-node\">1 &middot; MCP request<br><small class=\"diagram-muted\">no token</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node warn\">2 &middot; 401 challenge<br><small class=\"diagram-muted\">WWW-Authenticate</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">3 &middot; Discover metadata<br><small class=\"diagram-muted\">.well-known</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">4 &middot; Register client<br><small class=\"diagram-muted\">dynamic, public</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">5 &middot; Authorize + PKCE<br><small class=\"diagram-muted\">code exchange</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node ok\">6 &middot; Access + refresh<br><small class=\"diagram-muted\">audience-bound</small></div></div>",
+  "html": "<div class=\"mcp-flow\"><div class=\"diagram-node\">1 &middot; طلب MCP<br><small class=\"diagram-muted\">لا رمز</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node warn\">2 &middot; تحدي 401<br><small class=\"diagram-muted\">WWW-Authenticate</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">3 &middot; اكتشف البيانات الوصفية<br><small class=\"diagram-muted\">.well-known</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">4 &middot; تسجيل العميل<br><small class=\"diagram-muted\">ديناميكية، عامة</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">5 &middot; تفويض + MCP<br><small class=\"diagram-muted\">تبادل الكود</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node ok\">6 &middot; الوصول + التحديث<br><small class=\"diagram-muted\">audience-bound</small></div></div>",
   "css": ".mcp-flow{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.mcp-flow .diagram-node{display:flex;flex-direction:column;gap:2px;padding:8px 12px}.mcp-flow .diagram-arrow{font-size:20px;line-height:1}"
 }
 ```

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

@@ -9,9 +9,9 @@ description: "عمليات التشغيل التلقائي المجدولة وا
 
 توسّع عمليات التشغيل الآلي [recurring jobs](/docs/recurring-jobs) من خلال **مشغلات الأحداث** و**شروط اللغة الطبيعية** و**HTTP** الصادرة عبر أداة `web-request`. إنهم يستخدمون نفس تنسيق الملف `jobs/<name>.md` والتخزين وسير العمل "إنشاء ثلاث طرق" كمهام متكررة - راجع [Recurring Jobs](/docs/recurring-jobs#job-file) للتعرف على التنسيق المشترك. تغطي هذه الصفحة فقط ما هو جديد في عمليات التشغيل الآلي المستندة إلى الأحداث.
 
-```an-diagram title="When X happens, do Y" summary="An event fires on the bus, an optional natural-language condition gates it, and the agent runs the automation body with full tool access."
+```an-diagram title="عندما يحدث X، افعل Y" summary="يتم إطلاق حدث على الحافلة، ويفتحها شرط اختياري للغة الطبيعية، ويقوم الوكيل بتشغيل جسم التشغيل الآلي مع إمكانية الوصول الكامل للأداة."
 {
-  "html": "<div class=\"auto-flow\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Event</span><small class=\"diagram-muted\"><code>calendar.booking.created</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">Condition</span><small class=\"diagram-muted\">Haiku checks: &ldquo;email ends with @builder.io&rdquo;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent\"><span class=\"diagram-pill accent\">Agent runs the body</span><small class=\"diagram-muted\">actions &middot; web-request &middot; MCP &middot; sub-agents</small></div></div>",
+  "html": "<div class=\"auto-flow\"><div class=\"diagram-card\"><span class=\"diagram-pill\">حدث</span><small class=\"diagram-muted\"><code>calendar.booking.created</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">حالة</span><small class=\"diagram-muted\">يتحقق هايكو: &ldquo;ينتهي البريد الإلكتروني بـ @builder.io&rdquo;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent\"><span class=\"diagram-pill accent\">وكيل يدير الجسم</span><small class=\"diagram-muted\">الإجراءات &middot; web-request &middot; MCP &middot; sub-agents</small></div></div>",
   "css": ".auto-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.auto-flow .diagram-card{display:flex;flex-direction:column;gap:4px;padding:14px 16px;min-width:180px}.auto-flow .diagram-arrow{font-size:22px}"
 }
 ```
@@ -39,16 +39,32 @@ description: "عمليات التشغيل التلقائي المجدولة وا
 
 المسار الثالث - كتابة ملف `jobs/<name>.md` يدويًا عبر `resourcePut` - يعمل تمامًا كما هو الحال مع [recurring jobs](/docs/recurring-jobs#creating). للحصول على أتمتة تعتمد على الحدث، يمكنك إضافة المادة الأمامية لمشغل الحدث أدناه إلى نفس الملف. تقوم المهمة التي يتم تشغيلها بواسطة حدث بتعيين `schedule: ""` وتوفر `triggerType: event` واسم `event` و`condition` اختياري:
 
-```an-annotated-code title="An event-triggered automation"
+```an-annotated-code title="أتمتة ناجمة عن الأحداث"
 {
   "filename": "jobs/slack-on-builder-booking.md",
   "language": "markdown",
   "code": "---\nschedule: \"\"\nenabled: true\ntriggerType: event\nevent: calendar.booking.created\ncondition: \"attendee email ends with @builder.io\"\nmode: agentic\ndomain: calendar\nrunAs: creator\n---\nSend a Slack message to #sales with the booking details.\nUse the web-request tool to POST to ${keys.SLACK_WEBHOOK}.",
   "annotations": [
-    { "lines": "2", "label": "No cron", "note": "Event triggers set `schedule` to `\"\"` — the cron field stays empty." },
-    { "lines": "4-5", "label": "The trigger", "note": "`triggerType: event` plus the `event` name subscribes this automation to the bus." },
-    { "lines": "6", "label": "Gate", "note": "An optional natural-language `condition`, evaluated by Haiku against the payload before dispatch." },
-    { "lines": "12", "label": "Server-side secret", "note": "`${keys.SLACK_WEBHOOK}` is resolved server-side — the raw value never enters the agent's context." }
+    {
+      "lines": "2",
+      "label": "لا كرون",
+      "note": "قم بتعيين مشغلات الأحداث `schedule` إلى `\"\"` - يظل حقل cron فارغًا."
+    },
+    {
+      "lines": "4-5",
+      "label": "الزناد",
+      "note": "`triggerType: event` بالإضافة إلى اسم `event` يشترك في هذه الأتمتة في الناقل."
+    },
+    {
+      "lines": "6",
+      "label": "بوابة",
+      "note": "لغة طبيعية اختيارية `condition`، يتم تقييمها بواسطة Haiku مقابل الحمولة قبل الإرسال."
+    },
+    {
+      "lines": "12",
+      "label": "سر من جانب الخادم",
+      "note": "يتم حل `${keys.SLACK_WEBHOOK}` من جانب الخادم - ولا تدخل القيمة الأولية مطلقًا في سياق الوكيل."
+    }
   ]
 }
 ```
@@ -208,9 +224,9 @@ Body: {"text": "New booking from ${attendeeEmail}"}
 
 ## كيف يعمل الإرسال {#dispatch}
 
-```an-diagram title="The dispatch path" summary="From a fired event to a completed agent run, gated by ownership scope and the natural-language condition."
+```an-diagram title="مسار الإرسال" summary="من حدث مطرود إلى تشغيل وكيل مكتمل، مقيد بنطاق الملكية وحالة اللغة الطبيعية."
 {
-  "html": "<div class=\"disp\"><div class=\"diagram-box accent\">event fired on the bus</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">match</span><small class=\"diagram-muted\">load enabled automations subscribed to this event name</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">scope</span><small class=\"diagram-muted\">keep only those owned by the event's owner (or shared)</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">condition</span><small class=\"diagram-muted\">Haiku yes/no on the payload &mdash; false &rarr; <code>skipped</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card accent\"><span class=\"diagram-pill accent\">run</span><small class=\"diagram-muted\"><code>runAgentLoop</code> with body as prompt, payload as context, 5-min timeout</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card ok\"><span class=\"diagram-pill ok\">record</span><small class=\"diagram-muted\">write <code>lastRun</code> / <code>lastStatus</code> / <code>lastError</code></small></div></div>",
+  "html": "<div class=\"disp\"><div class=\"diagram-box accent\">حدث إطلاق النار على الحافلة</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">مباراة</span><small class=\"diagram-muted\">تحميل الأتمتة التي تم تمكينها والمشتركة في اسم الحدث هذا</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">نِطَاق</span><small class=\"diagram-muted\">الاحتفاظ فقط بالأشياء المملوكة لمالك الحدث (أو المشتركة)</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">حالة</span><small class=\"diagram-muted\">Haiku yes/no على الحمولة &mdash; خطأ شنيع &rarr; <code>تم تخطيه</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card accent\"><span class=\"diagram-pill accent\">يجري</span><small class=\"diagram-muted\"><code>runAgentLoop</code> مع النص كموجه، والحمولة كسياق، ومهلة مدتها 5 دقائق</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card ok\"><span class=\"diagram-pill ok\">سِجِلّ</span><small class=\"diagram-muted\">يكتب <code>lastRun</code> / <code>lastStatus</code> / <code>lastError</code></small></div></div>",
   "css": ".disp{display:flex;flex-direction:column;gap:6px;max-width:540px}.disp .diagram-card{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.disp .diagram-box{align-self:flex-start}.disp .diagram-arrow{font-size:18px;align-self:center}"
 }
 ```

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

@@ -17,9 +17,9 @@ agent-native add provider stripe | claude
 agent-native add channel discord  | codex
 ```
 
-```an-diagram title="add prints a recipe; your coding agent applies it" summary="agent-native emits a Markdown blueprint to stdout (diagnostics to stderr); you pipe it into Claude Code or Codex, which edits your live repo with full context."
+```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 add<br><small class=\"diagram-muted\">&lt;kind&gt; &lt;name|URL&gt;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Markdown blueprint<br><small class=\"diagram-muted\">stdout · files to touch · rules · Verify</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough>Coding agent<br><small class=\"diagram-muted\">claude · codex</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">edits your live repo</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>مخطط تخفيض السعر<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}"
 }
 ```