@agent-native/core 0.76.7 → 0.76.9

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

@@ -14,7 +14,7 @@ description: "اكتب حالات اختبار *.eval.ts التي تقوم بت
 
 يقوم المشغل بحل محرك/نموذج غير موفر الخدمة من السجل الحالي - لا يوجد نموذج مضمن - لذلك تعمل المجموعة نفسها على أي محرك تم تكوين التطبيق من أجله.
 
-```an-diagram title="From fixed input to deploy gate" summary="The runner actually runs the agent loop on each case, scores the output, and exits non-zero if any scorer falls below threshold — making it a drop-in CI gate."
+```an-diagram title="من المدخلات الثابتة لنشر البوابة" summary="يقوم العداء فعليًا بتشغيل حلقة الوكيل في كل حالة، ويسجل المخرجات، ويخرج من الصفر إذا انخفض أي مسجل عن العتبة - مما يجعله بوابة CI قابلة للإسقاط."
 {
   "html": "<div class=\"eval-flow\"><div class=\"diagram-node\">*.eval.ts<br><small class=\"diagram-muted\">prompt + expected behavior</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Run the agent loop<br><small class=\"diagram-muted\">real engine/model</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Scorers<br><small class=\"diagram-muted\">every one must pass threshold</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box ok\">exit 0 &rarr; deploy</div><div class=\"diagram-box warn\">exit 1 &rarr; block</div></div></div>",
   "css": ".eval-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.eval-flow .diagram-node{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.eval-flow .diagram-col{display:flex;flex-direction:column;gap:8px}.eval-flow .diagram-arrow{font-size:22px;line-height:1}"
@@ -80,7 +80,7 @@ interface AgentRunOutput {
 
 يبني `createScorer` هدافًا من أسلوب Mastra ذو 4 خطوات. مطلوب `generateScore` فقط:
 
-```an-diagram title="The 4-step scorer pipeline" summary="preprocess and analyze default to identity; only generateScore is required. analyze can run plain JS or call an LLM judge via ctx."
+```an-diagram title="خط أنابيب الهداف ذو الأربع خطوات" summary="المعالجة المسبقة والتحليل الافتراضي للهوية؛ مطلوب فقط generatorScore. يمكن للتحليل تشغيل JS عادي أو استدعاء القاضي LLM عبر ctx."
 {
   "html": "<div class=\"scorer\"><div class=\"diagram-card\"><span class=\"diagram-pill\">preprocess(run)</span><small class=\"diagram-muted\">transform the run/output &middot; optional</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">analyze(x, ctx)</span><small class=\"diagram-muted\">plain JS or LLM judge &middot; optional</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">generateScore(a)</span><small class=\"diagram-muted\">&rarr; 0..1 normalized &middot; <strong>required</strong></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">generateReason</span><small class=\"diagram-muted\">human-readable why &middot; optional</small></div></div>",
   "css": ".scorer{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.scorer .diagram-card{display:flex;flex-direction:column;gap:2px;padding:8px 12px}.scorer .diagram-arrow{font-size:20px;line-height:1}"

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

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

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

@@ -19,7 +19,7 @@ search: "Claude ChatGPT Claude الكود Codex المؤشر Claude Cowork MCP
 
 يقوم جسر الوكيل الخارجي بإغلاق الحلقة. أولاً، تقوم بتوصيل الوكيل الخاص بك بتطبيق **مستضاف** — إما عن طريق لصق MCP URL الخاص بالتطبيق في مضيف دردشة مثل Claude أو ChatGPT، أو عن طريق تشغيل تدفق المطور CLI لوكلاء الترميز المحليين. ثم يقوم الوكيل بالعمل على MCP ويسلم المستخدم إما **MCP App** UI المضمن في المضيفين المتوافقين أو رابط **"فتح في <app> →"** واحد يفتح التطبيق الحقيقي الذي يركز على ما تم إنتاجه بالضبط. إنها تعيد استخدام عقد `navigate` / `application_state` الحالي الذي يستنزف UI بالفعل كل ثانيتين (انظر [Context Awareness](/docs/context-awareness)) - لا توجد آلية تنقل ثانية.
 
-```an-diagram title="The external-agent round-trip" summary="An external host calls a tool over MCP; the app returns an artifact plus an Open link. Clicking it resolves the browser session and focuses the artifact in the running UI — the link carries no privileged state."
+```an-diagram title="رحلة ذهابًا وإيابًا للوكيل الخارجي" summary="يقوم مضيف خارجي باستدعاء أداة عبر MCP؛ يقوم التطبيق بإرجاع قطعة أثرية بالإضافة إلى رابط مفتوح. يؤدي النقر فوقه إلى حل جلسة المتصفح وتركيز العنصر في واجهة المستخدم قيد التشغيل - لا يحمل الرابط أي حالة مميزة."
 {
   "html": "<div class=\"xa-trip\"><div class=\"diagram-box\" data-rough>External host<br><small class=\"diagram-muted\">Claude &middot; ChatGPT &middot; Codex &middot; Cursor</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">MCP tool call</span><small class=\"diagram-muted\">e.g. <code>manage-draft</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>App produces artifact<br><small class=\"diagram-muted\">+ <code>Open in &lt;app&gt; &rarr;</code> deep link / MCP App</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>User clicks link</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill ok\"><code>/_agent-native/open</code></span><small class=\"diagram-muted\">resolves the <strong>browser</strong> session</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Writes <code>navigate</code> app-state<br><small class=\"diagram-muted\">UI focuses the artifact</small></div></div>",
   "css": ".xa-trip{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.xa-trip .center{display:flex;flex-direction:column;align-items:center;gap:4px}.xa-trip .diagram-arrow{font-size:22px;line-height:1}.xa-trip code{font-size:.85em}"
@@ -247,7 +247,7 @@ https://dispatch.agent-native.com/_agent-native/mcp
 
 يقدم خادم MCP **كتالوجًا مضغوطًا بشكل افتراضي لكل متصل** - الموصلات المستضافة (ChatGPT، Claude)، وعملاء التعليمات البرمجية (Claude Code، Cursor، Codex)، والوكيل CLI/stdio المحلي على حد سواء. يتم عرض سطح الإجراء الكامل فقط عند الاشتراك الصريح. لا يتم استنتاج الكتالوج أبدًا من اسم العميل أو وكيل المستخدم.
 
-```an-diagram title="Two catalog tiers" summary="Every caller gets the compact tier by default; the full ~105-tool surface is opt-in only. tool-search bridges the gap so nothing is ever truly hidden."
+```an-diagram title="مستويين من الكتالوج" summary="يحصل كل متصل على المستوى المدمج بشكل افتراضي؛ سطح الأداة الكامل ~ 105 قابل للاشتراك فقط. يعمل البحث عن الأدوات على سد الفجوة بحيث لا يتم إخفاء أي شيء على الإطلاق."
 {
   "html": "<div class=\"xa-tiers\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill ok\">Compact / connector tier &middot; default</span><strong>~20&ndash;30 tools</strong><small class=\"diagram-muted\">Template-declared app actions + cross-app builtins (<code>list_apps</code>, <code>open_app</code>, <code>ask_app</code>, <code>create_embed_session</code>) + always-present <code>tool-search</code>.</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">Full tier &middot; opt-in</span><strong>~105 tools</strong><small class=\"diagram-muted\">Explicit opt-in only: <code>--full-catalog</code> token or <code>AGENT_NATIVE_MCP_FULL_CATALOG=1</code>.</small></div></div><p class=\"diagram-muted note\"><code>tool-search</code> reaches any full-tier tool on demand &mdash; so the compact default keeps context small without hiding capability.</p>",
   "css": ".xa-tiers{display:flex;align-items:stretch;gap:14px;flex-wrap:wrap}.xa-tiers .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;flex:1;min-width:240px}.xa-tiers .diagram-arrow{align-self:center;font-size:24px;line-height:1}.xa-tiers .note{flex-basis:100%;margin:4px 0 0;font-size:.85em}.xa-tiers code{font-size:.85em}"

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

@@ -28,7 +28,7 @@ Agent-native مخصص للأشخاص الذين يريدون تطبيقًا حق
 
 تعمل معظم التطبيقات على تشغيل الذكاء الاصطناعي كفكرة لاحقة لا يمكنها في الواقع القيام بأشياء في التطبيق. في تطبيق الوكيل الأصلي، يكون الوكيل مواطنًا من الدرجة الأولى يشترك في نفس actions وقاعدة البيانات والحالة مثل UI، لذا يمكنه فعل أي شيء يمكن أن تفعله الأزرار - وتعديل التعليمات البرمجية الخاصة بالتطبيق. انظر [What Is Agent-Native?](/docs/what-is-agent-native#the-ladder).
 
-```an-diagram title="Bolted-on AI vs. agent-native" summary="A bolted-on chat sidebar lives in its own world. An agent-native agent shares the same actions, database, and state as the UI."
+```an-diagram title="الذكاء الاصطناعي المثبت مقابل agent-native" summary="يعيش الشريط الجانبي للدردشة المثبت في عالمه الخاص. يشارك وكيل agent-native نفس الإجراءات وقاعدة البيانات والحالة مثل واجهة المستخدم."
 {
   "html": "<div class=\"diagram-vs\"><div class=\"diagram-col\"><span class=\"diagram-pill warn\">Bolted-on AI</span><div class=\"diagram-node\">Chat sidebar</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>separate AI world<br><small class=\"diagram-muted\">can't touch the app</small></div><div class=\"diagram-box diagram-muted\">App UI &amp; data</div></div><div class=\"diagram-divider\" aria-hidden=\"true\"></div><div class=\"diagram-col\"><span class=\"diagram-pill ok\">Agent-native</span><div class=\"diagram-row2\"><div class=\"diagram-node\">UI</div><div class=\"diagram-node\">Agent</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>shared actions, DB &amp; state</div></div></div>",
   "css": ".diagram-vs{display:flex;align-items:stretch;gap:18px;flex-wrap:wrap}.diagram-vs .diagram-col{display:flex;flex-direction:column;gap:8px;align-items:center;flex:1;min-width:200px}.diagram-vs .diagram-row2{display:flex;gap:8px}.diagram-vs .diagram-arrow{font-size:20px;line-height:1}.diagram-vs .diagram-divider{width:1px;align-self:stretch;background:currentColor;opacity:.15}"
@@ -126,7 +126,7 @@ Anthropic Claude وOpenAI (عائلة GPT-5) وGoogle Gemini وأي مزود ي
 
 يوفر SSE نفس العملية لكتابة مسار فوري للمتصفح، ويظل استطلاع عداد الإصدار خفيف الوزن هو البديل لأنه يعمل في كل بيئة نشر - بما في ذلك بيئة بدون خادم وبيئة الحافة، حيث قد لا تكون المقابس الدائمة متاحة. انظر [Key Concepts — Live sync](/docs/key-concepts#polling-sync).
 
-```an-diagram title="SSE first, polling fallback" summary="Same-process writes stream instantly; a version-counter poll keeps serverless, edge, and cross-process writes convergent."
+```an-diagram title="SSE أولاً، إجراء الاقتراع الاحتياطي" summary="نفس العملية تكتب الدفق على الفور؛ يحافظ استطلاع الإصدار المضاد على تقارب عمليات الكتابة بدون خادم والحواف والعمليات المشتركة."
 {
   "html": "<div class=\"diagram-transport\"><div class=\"diagram-box\" data-rough>DB write</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">SSE<br><small class=\"diagram-muted\">/_agent-native/events &middot; instant</small></div><div class=\"diagram-node\">Poll<br><small class=\"diagram-muted\">/_agent-native/poll &middot; universal fallback</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Browser refetch</div></div>",
   "css": ".diagram-transport{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-transport .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-transport .diagram-arrow{font-size:22px;line-height:1}"

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

@@ -17,7 +17,7 @@ description: "قم بتكوين مساحة تخزين تحميل الملفات
 2. **موفر Builder.io** — مدمج، يتم تنشيطه تلقائيًا عند اتصال Builder.io
 3. **الاحتياطي SQL** — يخزن الملفات بتنسيق base64 في قاعدة البيانات (مناسب للتطوير، وليس للإنتاج)
 
-```an-diagram title="Provider resolution order" summary="uploadFile() picks the first configured provider in order. The SQL fallback always exists so uploads work with zero setup."
+```an-diagram title="ترتيب حل الموفر" summary="uploadFile() يختار الموفر الأول الذي تم تكوينه بالترتيب. الخيار الاحتياطي SQL موجود دائمًا، لذا تعمل التحميلات بدون أي إعداد."
 {
   "html": "<div class=\"diagram-upload\"><div class=\"diagram-box\" data-rough>uploadFile()<br><small class=\"diagram-muted\">POST /_agent-native/file-upload</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-step\"><span class=\"diagram-pill accent\">1</span><div class=\"diagram-node\">User-registered<br><small class=\"diagram-muted\">registerFileUploadProvider() — S3, R2, GCS…</small></div></div><div class=\"diagram-step\"><span class=\"diagram-pill\">2</span><div class=\"diagram-node\">Builder.io<br><small class=\"diagram-muted\">auto when connected — CDN-served</small></div></div><div class=\"diagram-step\"><span class=\"diagram-pill warn\">3</span><div class=\"diagram-node\">SQL fallback<br><small class=\"diagram-muted\">base64 in DB — dev only</small></div></div></div></div>",
   "css": ".diagram-upload{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-upload .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-upload .diagram-step{display:flex;align-items:center;gap:8px}.diagram-upload .diagram-arrow{font-size:22px;line-height:1}"

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

@@ -20,7 +20,7 @@ description: "إطار التطوير المحلي، ولوحة الوكيل ا
 رمز تطبيقك متطابق بغض النظر عن الإطار الذي يستضيفه. يتحدث الوكيل
 إلى تطبيقك من خلال نفس actions وحالة التطبيق في كل حالة.
 
-```an-diagram title="Three frames, one runtime" summary="Your app and the agent panel are the same in every frame; only the wrapper around them changes."
+```an-diagram title="ثلاثة إطارات، وقت تشغيل واحد" summary="تطبيقك ولوحة الوكيل متماثلان في كل إطار؛ فقط الغلاف المحيط بهم يتغير."
 {
   "html": "<div class=\"diagram-frames\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">Embedded panel</span><small class=\"diagram-muted\">ships in every app · dev + prod</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Local dev frame</span><small class=\"diagram-muted\">app in an iframe + panel + CLI terminal</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Builder.io cloud frame</span><small class=\"diagram-muted\">hosted: collaboration · visual edit · parallel runs</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>Same runtime<br><small class=\"diagram-muted\">your app · actions · application state</small></div></div>",
   "css": ".diagram-frames{display:flex;flex-direction:column;gap:10px;align-items:stretch}.diagram-frames .diagram-card{display:flex;flex-direction:column;gap:4px;padding:12px 16px}.diagram-frames .diagram-arrow{font-size:22px;line-height:1;align-self:center}"
@@ -57,7 +57,7 @@ description: "إطار التطوير المحلي، ولوحة الوكيل ا
   قائمة أدوات الترميز وعقود UI المشتركة، راجع
   [Agent-Native Code UI](/docs/code-agents-ui).
 
-```an-diagram title="Code-request gating" summary="A code-typed message needs a code-capable frame. With one connected, the request routes there; without one, the panel explains code changes need Desktop or Builder."
+```an-diagram title="بوابة طلب الكود" summary="تحتاج الرسالة المكتوبة بالرمز إلى إطار قادر على البرمجة. مع اتصال واحد، يتم توجيه الطلب إلى هناك؛ بدون واحد، تشرح اللوحة أن تغييرات التعليمات البرمجية تحتاج إلى Desktop أو Builder."
 {
   "html": "<div class=\"diagram-gate\"><div class=\"diagram-node\" data-rough>message<br><small class=\"diagram-muted\">type: \\\"code\\\"</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough>code-capable frame connected?</div><div class=\"diagram-col\"><div class=\"diagram-pill ok\">yes &rarr; route to frame, show code-agent indicator</div><div class=\"diagram-pill warn\">no &rarr; dialog: needs Desktop or Builder</div></div></div>",
   "css": ".diagram-gate{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-gate .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-gate .diagram-arrow{font-size:22px;line-height:1}.diagram-gate .center{text-align:center}"

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

@@ -19,12 +19,12 @@ description: "قم بإنشاء تطبيق وكيل، وافهم التعليم
 كل شيء بعد (كتابة التعليمات، إضافة skills، تعريف actions، التشغيل
 الوكيل) هو نفسه في كلتا الحالتين.
 
-```an-file-tree title="A basic Agent-Native agent"
+```an-file-tree title="agent أساسي من Agent-Native"
 {
   "entries": [
-    { "path": "AGENTS.md", "note": "always-on instructions: purpose, rules, tone, and the map of what the agent can do" },
-    { "path": ".agents/skills/customer-research/SKILL.md", "note": "a reusable playbook the agent loads when the task matches" },
-    { "path": "actions/summarize-week.ts", "note": "typed code the agent, UI, CLI, HTTP, MCP, A2A, jobs, and webhooks can run" }
+    { "path": "AGENTS.md", "note": "تعليمات دائمة: الهدف، القواعد، النبرة، وخريطة ما يستطيع agent فعله" },
+    { "path": ".agents/skills/customer-research/SKILL.md", "note": "playbook قابل لإعادة الاستخدام يحمّله agent عندما تطابق المهمة" },
+    { "path": "actions/summarize-week.ts", "note": "code typed يمكن لل agent و UI و CLI و HTTP و MCP و A2A و jobs و webhooks تشغيله" }
   ]
 }
 ```
@@ -121,7 +121,7 @@ pnpm dev
 يمكن الآن الوصول إلى هذا الإجراء الواحد من خلال الدردشة UI، وCLI، وHTTP، وMCP، وA2A،
 المهام المجدولة، وwebhooks. حدد مرة واحدة، اتصل من أي مكان.
 
-```an-diagram title="One action, every surface" summary="A single defineAction file fans out to every consumer with no extra wiring."
+```an-diagram title="إجراء واحد، على كل سطح" summary="يتم إرسال ملف defineAction واحد إلى كل مستهلك بدون أي أسلاك إضافية."
 {
   "html": "<div class=\"diagram-fan\"><div class=\"diagram-box\" data-rough>defineAction</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-surfaces\"><span class=\"diagram-pill\">Chat UI</span><span class=\"diagram-pill\">CLI</span><span class=\"diagram-pill\">HTTP</span><span class=\"diagram-pill\">MCP</span><span class=\"diagram-pill\">A2A</span><span class=\"diagram-pill\">Scheduled jobs</span><span class=\"diagram-pill\">Webhooks</span></div></div>",
   "css": ".diagram-fan{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-fan .diagram-surfaces{display:flex;flex-wrap:wrap;gap:8px;max-width:420px}.diagram-fan .diagram-arrow{font-size:22px;line-height:1}"

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

@@ -23,7 +23,7 @@ search: "وكلاء تسخير AgentHarness ai-sdk رمز HarnessAgent Claude Co
 حلقة خاصة بها من البداية إلى النهاية، لذا فإن Agent-Native يقودها كجلسة، وليس كجلسة واحدة
 استدعاء النموذج.
 
-```an-diagram title="A harness owns its loop; Agent-Native drives the session" summary="The AgentHarness substrate creates/resumes the native session, streams its events into the normal transcript, and persists resumeState in SQL between turns."
+```an-diagram title="يمتلك الحزام حلقته. Agent-Native يقود الجلسة" summary="تقوم الركيزة AgentHarness creates/resumes بالجلسة الأصلية، بتدفق أحداثها إلى النص العادي، وتستمر في حالة الاستئناف في SQL بين المنعطفات."
 {
   "html": "<div class=\"diagram-harness\"><div class=\"diagram-box\" data-rough><strong>AgentHarness substrate</strong><small class=\"diagram-muted\">@agent-native/core/agent/harness</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><strong>Native harness loop</strong><small class=\"diagram-muted\">Claude Code · Codex · Pi — own tools, sandbox, compaction</small></div><div class=\"diagram-col\"><div class=\"diagram-pill accent\">events &rarr; transcript</div><div class=\"diagram-pill ok\">resumeState &rarr; SQL session</div></div></div>",
   "css": ".diagram-harness{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-harness .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-harness .diagram-arrow{font-size:22px;line-height:1}.diagram-harness .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
@@ -213,7 +213,7 @@ const run = startAgentHarnessRun({
 **غير شفاف** — يقوم Agent-Native بتخزينه وإعادته، ولكن لا يتم فحصه أو فحصه مطلقًا
 يفسرها.
 
-```an-diagram title="Resume across turns, processes, and deploys" summary="Each turn detaches an opaque resumeState into SQL; the next turn feeds it back into createSession instead of replaying chat history."
+```an-diagram title="الاستئناف عبر المنعطفات والعمليات والنشر" summary="يقوم كل دور بفصل حالة السيرة الذاتية المبهمة إلى SQL؛ المنعطف التالي يعيده مرة أخرى إلى createSession بدلاً من إعادة تشغيل سجل الدردشة."
 {
   "html": "<div class=\"diagram-resume\"><div class=\"diagram-node\" data-rough>Turn N<br><small class=\"diagram-muted\">streamTurn</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>detach &rarr; resumeState<br><small class=\"diagram-muted\">opaque · SQL harness session</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>Turn N+1<br><small class=\"diagram-muted\">createSession.resumeState</small></div></div>",
   "css": ".diagram-resume{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-resume .diagram-arrow{font-size:22px;line-height:1}"

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

@@ -14,7 +14,7 @@ description: "إيقاف الوكيل مؤقتًا قبل تشغيل الإجر
 
 قم بتعيين `needsApproval` على `defineAction`. يقبل قيمة منطقية أو مسندًا:
 
-```an-annotated-code title="Gating the one consequential action"
+```an-annotated-code title="بوابات العمل التبعي واحد"
 {
   "filename": "actions/send-email.ts",
   "language": "ts",
@@ -70,7 +70,7 @@ description: "إيقاف الوكيل مؤقتًا قبل تشغيل الإجر
 
 ## من النهاية إلى النهاية {#flow}
 
-```an-diagram title="The approval interrupt" summary="A gated call pauses the turn before run() fires. Approval re-issues the turn carrying the call's key; only then does the side effect happen."
+```an-diagram title="مقاطعة الموافقة" summary="تقوم المكالمة المسورة بإيقاف الدور مؤقتًا قبل تشغيل run(). الموافقة تعيد إصدار الدور الذي يحمل مفتاح الاتصال؛ عندها فقط يحدث التأثير الجانبي."
 {
   "html": "<div class=\"diagram-approve\"><div class=\"diagram-box\" data-rough>Agent calls send-email</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel warn\" data-rough><strong>Gate truthy, call not yet approved</strong><small class=\"diagram-muted\">loop emits tool_start + approval_required { tool, input, approvalKey }</small><span class=\"diagram-pill warn\">turn pauses &mdash; run() did NOT execute</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>Human clicks Approve in chat<br><small class=\"diagram-muted\">client re-issues the turn with approvedToolCalls: [approvalKey]</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel ok\" data-rough><span class=\"diagram-pill ok\">Gate sees the key &rarr; run() executes &rarr; email sends</span></div></div>",
   "css": ".diagram-approve{display:flex;flex-direction:column;align-items:center;gap:8px}.diagram-approve .diagram-panel{display:flex;flex-direction:column;gap:6px;align-items:center;padding:12px 16px;text-align:center}.diagram-approve .diagram-arrow{font-size:22px;line-height:1}"

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

@@ -115,6 +115,8 @@ function SettingsPage() {
 غير مترجم. إذا لم تكن اللغة تحتوي على Markdown مترجمة لصفحة ما، فإن موقع المستندات
 يعود إلى اللغة الإنجليزية لتلك الصفحة مع الاستمرار في ترجمة التنقل وchrome.
 
+قد يحتوي Docs Markdown على كتل مرئية منظمة `an-*`. ترجم حقول النص الظاهرة للمستخدم عندما يكون ذلك منطقياً، مثل عناوين file-tree و `entries[].note`، ونصوص callout، و labels الخاصة بال tabs، و labels/notes في annotated-code. اترك المعرفات الثابتة كما هي: filenames و paths و env vars و route strings و action names و language tags و code snippets و JSON keys و protocol names.
+
 ## Actions والإصرار
 
 يرث كل تطبيق:

package/docs/content/locales/ar-SA/key-concepts.md

@@ -17,9 +17,9 @@ description: "كيفية عمل تطبيقات الوكيل الأصلية: acti
 >
 > **الكمبيوتر** — قاعدة البيانات، المتصفح، تنفيذ التعليمات البرمجية. يعمل الوكلاء مباشرةً باستخدام SQL والأدوات المضمنة؛ خوادم MCP هي إضافات اختيارية وليست أساسية.
 
-```an-diagram title="Agent, application, and computer" summary="Three layers working together over one shared SQL store. The agent and the application both read and write the same data."
+```an-diagram title="الوكيل والتطبيق والكمبيوتر" summary="ثلاث طبقات تعمل معًا في متجر SQL واحد مشترك. يقوم كل من الوكيل والتطبيق بقراءة وكتابة نفس البيانات."
 {
-  "html": "<div class=\"diagram-arch\"><div class=\"diagram-row\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Agent</span><small class=\"diagram-muted\">reads + writes data, runs actions, modifies code</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">Application</span><small class=\"diagram-muted\">action-only, chat, control plane, or full React UI</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;&nbsp;&uarr;</div><div class=\"diagram-box\" data-rough>Computer<br><small class=\"diagram-muted\">SQL database · browser · code execution</small></div></div>",
+  "html": "<div class=\"diagram-arch\"><div class=\"diagram-row\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Agent</span><small class=\"diagram-muted\">يقرأ + يكتب البيانات، وينفذ الإجراءات، ويعدل التعليمات البرمجية</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">Application</span><small class=\"diagram-muted\">الإجراء فقط، أو الدردشة، أو مستوى التحكم، أو واجهة المستخدم React الكاملة</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;&nbsp;&uarr;</div><div class=\"diagram-box\" data-rough>حاسوب<br><small class=\"diagram-muted\">SQL قاعدة البيانات · المتصفح · تنفيذ التعليمات البرمجية</small></div></div>",
   "css": ".diagram-arch{display:flex;flex-direction:column;align-items:center;gap:10px}.diagram-arch .diagram-row{display:flex;gap:12px;flex-wrap:wrap;justify-content:center}.diagram-arch .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:220px}.diagram-arch .diagram-arrow{font-size:20px;line-height:1}.diagram-arch .diagram-box{text-align:center;padding:12px 18px}"
 }
 ```
@@ -31,12 +31,12 @@ description: "كيفية عمل تطبيقات الوكيل الأصلية: acti
 يحتوي كل تطبيق وكيل أصلي على نفس العناصر الأساسية للوكيل، بغض النظر عما إذا كان
 يجب أن يكون سطح المنتج بدون رأس، أو للدردشة أولاً، أو UI كاملاً:
 
-```an-file-tree title="Guidance and behavior"
+```an-file-tree title="الإرشاد والسلوك"
 {
   "entries": [
-    { "path": "AGENTS.md", "note": "always-on instructions: purpose, core rules, state keys, action index, skills index" },
-    { "path": ".agents/skills/<name>/SKILL.md", "note": "reusable behavior: workflow steps, policies, examples, references, and do/don't lists" },
-    { "path": "actions/<name>.ts", "note": "executable capability: typed operation exposed to the agent, UI, CLI, HTTP, MCP, A2A, jobs, and webhooks" }
+    { "path": "AGENTS.md", "note": "تعليمات دائمة: الهدف، القواعد الأساسية، state keys، فهرس actions، فهرس skills" },
+    { "path": ".agents/skills/<name>/SKILL.md", "note": "سلوك قابل لإعادة الاستخدام: خطوات workflow، سياسات، أمثلة، مراجع، وقوائم ما يجب فعله وما لا يجب فعله" },
+    { "path": "actions/<name>.ts", "note": "قدرة قابلة للتنفيذ: عملية typed مكشوفة لل agent و UI و CLI و HTTP و MCP و A2A و jobs و webhooks" }
   ]
 }
 ```
@@ -211,7 +211,7 @@ useDbSync({ queryClient });
 4. إعادة جلب الخطافات `useActionQuery` والخطافات `useQuery` ذات الإصدار المصدر
 5. تعرض المكونات البيانات الجديدة دون إعادة تحميل الصفحة
 
-```an-diagram title="Live sync flow" summary="An agent write becomes a UI render with no manual refresh — SSE first, polling as the universal fallback."
+```an-diagram title="تدفق المزامنة الحية" summary="تصبح كتابة الوكيل عرضًا لواجهة المستخدم بدون تحديث يدوي - SSE أولاً، ويتم الاستقصاء كإجراء احتياطي عالمي."
 {
   "html": "<div class=\"diagram-sync\"><div class=\"diagram-node\">Agent action<br><small class=\"diagram-muted\">writes to DB</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Change event<br><small class=\"diagram-muted\">source: action / settings</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">useDbSync</span><small class=\"diagram-muted\">SSE &middot; poll fallback</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Query refetch<br><small class=\"diagram-muted\">render, no reload</small></div></div>",
   "css": ".diagram-sync{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-sync .diagram-arrow{font-size:22px;line-height:1}.diagram-sync .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:10px 14px}"

package/docs/content/locales/ar-SA/local-file-mode.md

@@ -46,7 +46,7 @@ description: "قم بتشغيل تطبيقات الوكيل الأصلية با
 لا يزال المحرر يقوم بتحرير المستندات؛ والفرق هو ما إذا كانت هذه المستندات قد تم حلها
 إلى صفوف SQL أو الملفات المحلية.
 
-```an-diagram title="Same actions, two sources of truth" summary="The UI and agent call identical actions in both modes. The action layer decides whether each call resolves to SQL rows or repo files."
+```an-diagram title="نفس الأفعال، مصدران للحقيقة" summary="تستدعي واجهة المستخدم والوكيل إجراءات متطابقة في كلا الوضعين. تقرر طبقة الإجراء ما إذا كان كل استدعاء سيحل إلى صفوف SQL أو ملفات الريبو."
 {
   "html": "<div class=\"diagram-mode\"><div class=\"diagram-col entry\"><div class=\"diagram-node\">Content UI</div><div class=\"diagram-node\">Agent + actions<br><small class=\"diagram-muted\">list/get/update-document</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-row resolve\"><div class=\"diagram-panel\" data-rough><span class=\"diagram-pill accent\">Database mode</span><small class=\"diagram-muted\">SQL rows via Drizzle</small><small class=\"diagram-muted\">hosted · sharing · comments · history</small></div><div class=\"diagram-panel\" data-rough><span class=\"diagram-pill ok\">Local File Mode</span><small class=\"diagram-muted\">repo files via agent-native.json</small><small class=\"diagram-muted\">Git review · coding-agent edits</small></div></div></div>",
   "css": ".diagram-mode{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-mode .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-mode .diagram-arrow{font-size:22px;line-height:1}.diagram-mode .resolve{display:flex;gap:12px;flex-wrap:wrap}.diagram-mode .diagram-panel{display:flex;flex-direction:column;gap:4px;padding:12px 14px}"
@@ -57,21 +57,21 @@ description: "قم بتشغيل تطبيقات الوكيل الأصلية با
 
 يمكن أن تكون مساحة عمل المحتوى صغيرة مثل هذا:
 
-```an-file-tree title="A Content workspace repo"
+```an-file-tree title="repo لـ Content workspace"
 {
   "entries": [
-    { "path": "agent-native.json", "note": "declares which folders are content roots and their kinds" },
-    { "path": "docs/", "note": "content root — shows in the sidebar as pages" },
+    { "path": "agent-native.json", "note": "يعلن أي folders هي content roots وأنواعها" },
+    { "path": "docs/", "note": "content root: يظهر في الشريط الجانبي كصفحات" },
     { "path": "docs/getting-started.mdx" },
     { "path": "docs/guides/custom-components.mdx" },
-    { "path": "blog/", "note": "content root" },
+    { "path": "blog/", "note": "جذر محتوى" },
     { "path": "blog/launch-post.mdx" },
-    { "path": "resources/", "note": "content root" },
+    { "path": "resources/", "note": "جذر محتوى" },
     { "path": "resources/messaging/positioning.md" },
-    { "path": "components/", "note": "NOT a content root — preview component library MDX can import" },
+    { "path": "components/", "note": "ليس content root: مكتبة مكونات preview يمكن لـ MDX استيرادها" },
     { "path": "components/FrameworkTabs.tsx" },
     { "path": "components/Callout.tsx" },
-    { "path": "extensions/", "note": "NOT a content root — local extension library (sandboxed widgets)" },
+    { "path": "extensions/", "note": "ليس content root: مكتبة extensions محلية (widgets داخل sandbox)" },
     { "path": "extensions/doc-status/extension.json" },
     { "path": "extensions/doc-status/index.html" }
   ]

package/docs/content/locales/ar-SA/mcp-apps.md

@@ -30,7 +30,7 @@ description: "قم بتأليف تطبيقات MCP التفاعلية UI وتض
 
 لا تكتب بخط اليد تطبيقات HTML MCP العادية لمرة واحدة للمنتج UI؛ إذا كان الإجراء يحتاج إلى سطح مخصص، فأضف أو أعد استخدام مسار/مكون حقيقي للتطبيق أولاً وقم بتضمين هذا المسار.
 
-```an-diagram title="MCP App embed round-trip" summary="The action's link target is also the embed target. Capable hosts load the same signed app route inline; everyone else falls back to the deep link."
+```an-diagram title="MCP تضمين التطبيق ذهابًا وإيابًا" summary="هدف الارتباط الخاص بالإجراء هو أيضًا هدف التضمين. يقوم المضيفون القادرون بتحميل نفس مسار التطبيق الموقع بشكل مضمّن؛ يعود الجميع إلى الرابط العميق."
 {
   "html": "<div class=\"diagram-embed\"><div class=\"diagram-card\" data-rough><strong>Action</strong><small class=\"diagram-muted\">`link` target = MCP App embed target</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>embedApp()</strong><span class=\"diagram-pill accent\">create_embed_session</span><small class=\"diagram-muted\">mints short-lived embed session</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>/_agent-native/embed/start</strong><small class=\"diagram-muted\">exchanges one-time SQL ticket</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>Signed app route</strong><span class=\"diagram-pill ok\">real React route</span><small class=\"diagram-muted\">short-lived browser session</small></div><div class=\"diagram-fallback\"><span class=\"diagram-pill warn\">no MCP Apps support</span><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>&quot;Open in … &rarr;&quot; deep link</div></div></div>",
 "css": ".diagram-embed{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-embed .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:140px}.diagram-embed .diagram-arrow{font-size:22px;line-height:1}.diagram-embed .diagram-fallback{display:flex;flex-direction:column;align-items:center;gap:6px;margin-inline-start:8px}"
@@ -54,7 +54,7 @@ export default defineAction({
 });
 ```
 
-```an-annotated-code title="The mcpApp resource config"
+```an-annotated-code title="تكوين موارد mcpApp"
 {
   "filename": "actions/review-draft.ts",
   "language": "ts",
@@ -79,7 +79,7 @@ export default defineAction({
 
 تضمينات تطبيق MCP عبارة عن تضمينات للمسار، وليست منتجات صغيرة منفصلة. يبدأ `embedApp()` من هدف `link` للإجراء، وينشئ جلسة تضمين قصيرة الأجل، ويطلق مسار التطبيق الموقع. يمكن لمضيفي MCP Apps القياسيين التنقل في إطار تطبيق MCP نفسه عندما يتمكن المضيف من ترطيب المسار مباشرة.
 
-```an-diagram title="Two host bridge paths, one signed route" summary="Claude transplants the hydrated route and uses the direct ui/_bridge; ChatGPT gets a controlled iframe via window.openai and relays host actions over postMessage. Both point at the same signed app route."
+```an-diagram title="مساران للجسر المضيف، وطريق واحد موقّع" summary="يقوم كلود بزرع المسار المائي ويستخدم ui/_bridge المباشر؛ يحصل ChatGPT على إطار iframe يتم التحكم فيه عبر window.openai ويقوم بترحيل إجراءات المضيف عبر postMessage. كلاهما يشيران إلى نفس مسار التطبيق الموقع."
 {
   "html": "<div class=\"diagram-bridge\"><div class=\"diagram-col\"><div class=\"diagram-card\" data-rough><strong>Claude web</strong><span class=\"diagram-pill accent\">single-frame transplant</span><small class=\"diagram-muted\">hydrates signed app HTML in Claude's iframe, then direct`ui/_` host bridge</small></div><div class=\"diagram-card\" data-rough><strong>ChatGPT web</strong><span class=\"diagram-pill accent\">controlled route iframe</span><small class=\"diagram-muted\">`window.openai`host APIs ·`agentNative.mcpHost.*` postMessage relay</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Same signed app route<br><small class=\"diagram-muted\">normal route + React components</small></div></div>",
 "css": ".diagram-bridge{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-bridge .diagram-col{display:flex;flex-direction:column;gap:12px}.diagram-bridge .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;max-width:300px}.diagram-bridge .diagram-arrow{font-size:22px;line-height:1}.diagram-bridge .diagram-box{padding:16px 18px;text-align:center}"

package/docs/content/locales/ar-SA/mcp-clients.md

@@ -20,7 +20,7 @@ description: "قم بتوصيل تطبيق الوكيل الأصلي بخواد
 
 يتم تحليل كل مصدر في وقت تشغيل واحد **مدير MCP**، وكل أداة يتعلمها يتم وضعها في سجل أدوات الوكيل تحت بادئة `mcp__<server-id>__<tool>` مقاومة للتصادم — يمكن البحث فيها عن طريق النية من خلال `tool-search`.
 
-```an-diagram title="Client direction: many sources, one tool registry" summary="Config files, env, and runtime UI all merge into the MCP manager; its tools appear prefixed and tool-searchable alongside your app's actions. This is the mirror of the server direction."
+```an-diagram title="توجيه العميل: العديد من المصادر وسجل أداة واحد" summary="يتم دمج ملفات التكوين وenv وواجهة المستخدم الخاصة بوقت التشغيل في مدير MCP؛ تظهر أدواته مسبوقة وقابلة للبحث عن الأدوات جنبًا إلى جنب مع إجراءات تطبيقك. هذه هي مرآة اتجاه الخادم."
 {
   "html": "<div class=\"mcp-merge\"><div class=\"diagram-col sources\"><div class=\"diagram-box\" data-rough>Workspace <code>mcp.config.json</code><br><small class=\"diagram-muted\">shared across apps</small></div><div class=\"diagram-box\" data-rough>App-root <code>mcp.config.json</code><br><small class=\"diagram-muted\">per-app override</small></div><div class=\"diagram-box\" data-rough><code>MCP_SERVERS</code> env<br><small class=\"diagram-muted\">CI / production</small></div><div class=\"diagram-box\" data-rough>Remote via settings UI<br><small class=\"diagram-muted\">personal &amp; org scope</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">MCP manager</span><small class=\"diagram-muted\">merge &middot; hot-reload</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col out\"><div class=\"diagram-node\">Agent tool registry<br><small class=\"diagram-muted\"><code>mcp__&lt;server-id&gt;__&lt;tool&gt;</code></small></div><div class=\"diagram-node\"><code>tool-search</code><br><small class=\"diagram-muted\">discover by intent</small></div></div></div>",
   "css": ".mcp-merge{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.mcp-merge .diagram-col{display:flex;flex-direction:column;gap:8px}.mcp-merge .center{display:flex;flex-direction:column;align-items:center;gap:4px}.mcp-merge .diagram-arrow{font-size:22px;line-height:1}.mcp-merge code{font-size:.85em}"
@@ -102,7 +102,7 @@ description: "قم بتوصيل تطبيق الوكيل الأصلي بخواد
 
 الشكل صغير: خريطة `servers` مرتبطة بمعرف الخادم، حيث يكون كل إدخال إما مشغل stdio (`command` + `args` + `env` اختياري) أو إدخال `{ "type": "http", "url", "headers" }` عن بعد.
 
-```an-annotated-code title="mcp.config.json, annotated"
+```an-annotated-code title="mcp.config.json، مشروح"
 {
   "filename": "mcp.config.json",
   "language": "jsonc",
@@ -202,7 +202,7 @@ MCP_SERVERS='{"servers":{"zapier":{"type":"http","url":"https://mcp.example.com/
 
 Dispatch هو المركز التقليدي - فهو ينسق بالفعل عبر التطبيقات.
 
-```an-diagram title="Hub model: one app serves org-scope MCP servers" summary="Dispatch holds the org-scope MCP servers; consumer apps pull and merge them as mcp__hub_<orgId>_<name>__*. Only org-scope rows are shared — personal credentials stay put."
+```an-diagram title="نموذج Hub: يخدم تطبيق واحد خوادم MCP ذات النطاق التنظيمي" summary="Dispatch يحمل خوادم MCP ذات النطاق التنظيمي؛ تقوم تطبيقات المستهلك بسحبها ودمجها كـ mcp__hub_<orgId>_<name>__*. تتم مشاركة صفوف نطاق المؤسسة فقط، وتظل بيانات الاعتماد الشخصية في مكانها."
 {
   "html": "<div class=\"mcp-hub\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">Dispatch hub</span><small class=\"diagram-muted\">org-scope MCP servers</small><small class=\"diagram-muted\"><code>GET /mcp/hub/servers</code></small></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\">&rarr;</div></div><div class=\"diagram-col consumers\"><div class=\"diagram-box\" data-rough>Mail<br><small class=\"diagram-muted\"><code>mcp__hub_&lt;orgId&gt;_&lt;name&gt;__*</code></small></div><div class=\"diagram-box\" data-rough>Clips<br><small class=\"diagram-muted\">pull + merge each ~60s</small></div></div></div><p class=\"diagram-muted note\">Bearer-gated by <code>AGENT_NATIVE_MCP_HUB_TOKEN</code>. Personal (user-scope) servers are never re-exposed.</p>",
   "css": ".mcp-hub{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.mcp-hub .center{display:flex;flex-direction:column;align-items:center;gap:4px}.mcp-hub .diagram-col{display:flex;flex-direction:column;gap:10px}.mcp-hub .arrows .diagram-arrow{font-size:22px;line-height:1}.mcp-hub .note{margin:8px 0 0;font-size:.85em}.mcp-hub code{font-size:.85em}"

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

@@ -30,7 +30,7 @@ MCP هو البروتوكول القياسي لتوصيل أدوات الذكا
 - **جهاز التحكم عن بعد القياسي MCP OAuth** — اكتشاف OAuth 2.1، تسجيل العميل الديناميكي، رمز التفويض + PKCE، تدوير رمز التحديث
 - **الرجوع الاحتياطي لمصادقة الحامل** — يستخدم `ACCESS_TOKEN` أو `ACCESS_TOKENS` أو JWTs المتصلة للعملاء الذين لا يمكنهم تشغيل OAuth
 
-```an-diagram title="Your app as an MCP server" summary="External hosts connect over Streamable HTTP. Each action is one tool; ask-agent delegates to the full agent loop."
+```an-diagram title="تطبيقك كخادم MCP" summary="يتصل المضيفون الخارجيون عبر HTTP القابل للتدفق. كل عمل هو أداة واحدة؛ مندوبو Ask-agent إلى حلقة الوكيل الكاملة."
 {
   "html": "<div class=\"diagram-mcp\"><div class=\"diagram-col\"><div class=\"diagram-node\">Claude</div><div class=\"diagram-node\">ChatGPT</div><div class=\"diagram-node\">Cursor · Codex</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\"><span class=\"diagram-pill accent\">POST /_agent-native/mcp</span><small class=\"diagram-muted\">Streamable HTTP</small><small class=\"diagram-muted\">initialize &rarr; tools/list &rarr; tools/call</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\" data-rough>each action<br><small class=\"diagram-muted\">= one tool</small></div><div class=\"diagram-box\" data-rough>ask-agent<br><small class=\"diagram-muted\">&rarr; full agent loop</small></div></div></div>",
   "css": ".diagram-mcp{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.diagram-mcp .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-mcp .diagram-panel{display:flex;flex-direction:column;align-items:center;gap:4px}.diagram-mcp .diagram-arrow{font-size:20px;line-height:1}"
@@ -194,7 +194,7 @@ WWW-Authenticate: Bearer resource_metadata="https://dispatch.agent-native.com/.w
 | `/_agent-native/mcp/oauth/authorize`      | تخويل المتصفح + الموافقة                    |
 | `/_agent-native/mcp/oauth/token`          | منح رمز التفويض ورمز التحديث                |
 
-```an-diagram title="OAuth discovery flow" summary="A 401 kicks off discovery, registration, and a PKCE authorize → token exchange. The Bearer token is audience-bound and scoped."
+```an-diagram title="OAuth تدفق الاكتشاف" summary="يبدأ 401 عملية الاكتشاف والتسجيل وتفويض PKCE → تبادل الرمز المميز. الرمز المميز لحامله مرتبط بالجمهور ومحدد النطاق."
 {
   "html": "<div class=\"diagram-oauth\"><div class=\"diagram-box\" data-rough>first request<br><small class=\"diagram-muted\">no token</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill warn\">401 · WWW-Authenticate</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\"><span class=\"diagram-pill\">/.well-known/oauth-protected-resource</span><span class=\"diagram-pill\">/.well-known/oauth-authorization-server</span><small class=\"diagram-muted\">discover</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-pill\">register</div><div class=\"diagram-pill\">authorize (PKCE)</div><div class=\"diagram-pill\">token</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Bearer access token<br><small class=\"diagram-muted\">audience-bound · mcp:read / write / apps</small></div></div>",
   "css": ".diagram-oauth{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-oauth .diagram-panel{display:flex;flex-direction:column;align-items:center;gap:4px}.diagram-oauth .diagram-col{display:flex;flex-direction:column;gap:6px}.diagram-oauth .diagram-arrow{font-size:20px;line-height:1}"

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

@@ -18,7 +18,7 @@ description: "تحدث إلى وكيلك من Slack أو البريد الإلك
 - **نفس الوكيل، نفس الذاكرة.** كل ما تقوله على Slack يتم تذكره عندما ترسله بالبريد الإلكتروني لاحقًا. تشترك دردشة الويب والرسائل الخارجية في سجل موضوع واحد.
 - للحصول على تنبيهات أحادية الاتجاه داخل التطبيق (رمز الجرس، webhooks)، راجع [Notifications](/docs/notifications).
 
-```an-diagram title="Many channels, one agent" summary="Every platform fans into the same agent loop and the same SQL thread history — so a Slack DM and an email continue the same conversation."
+```an-diagram title="العديد من القنوات، وكيل واحد" summary="تنضم كل منصة إلى نفس حلقة الوكيل ونفس سجل سلاسل الرسائل SQL - لذلك تواصل رسالة مباشرة Slack وبريد إلكتروني نفس المحادثة."
 {
   "html": "<div class=\"msg-fanin\"><div class=\"diagram-col\"><div class=\"diagram-node\">Slack</div><div class=\"diagram-node\">Email</div><div class=\"diagram-node\">Telegram</div><div class=\"diagram-node\">WhatsApp</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">One agent loop</span><small class=\"diagram-muted\">same memory · same tools</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>One SQL thread history<br><small class=\"diagram-muted\">web chat + external messages share it</small></div></div>",
   "css": ".msg-fanin{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.msg-fanin .diagram-col{display:flex;flex-direction:column;gap:8px}.msg-fanin .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
@@ -231,7 +231,7 @@ https://your-clips.example.com/api/slack/unfurl
 3. تعمل نقطة نهاية المعالج في **تنفيذ وظيفة جديدة** بميزانية المهلة الكاملة الخاصة بها. فهو يطالب بالمهمة ذريًا (`pending` → `processing` عبر `claimPendingTask`)، ويقوم بتشغيل حلقة الوكيل، وينشر الرد من خلال المحول، ويضع علامة على المهمة `completed`.
 4. تقوم مهمة إعادة المحاولة المتكررة (`startPendingTasksRetryJob`، كل 60 ثانية) بمسح المهام العالقة في `pending` >90 ثانية أو `processing` > 5 دقائق وتعيد تشغيل المعالج. تم تحديد 3 محاولات، ثم تم وضع علامة `failed`.
 
-```an-diagram title="Inbound webhook lifecycle" summary="The webhook only verifies, enqueues, and returns 200. A fresh function execution drains the queue and runs the agent loop, with a 60s retry job as the safety net."
+```an-diagram title="دورة حياة خطاف الويب الوارد" summary="يقوم خطاف الويب فقط بالتحقق من الرقم 200 وإدراجه في قائمة الانتظار وإرجاعه. يؤدي تنفيذ وظيفة جديدة إلى استنزاف قائمة الانتظار وتشغيل حلقة الوكيل، مع إعادة المحاولة لمدة 60 ثانية كشبكة أمان."
 {
   "html": "<div class=\"msg-flow\"><div class=\"msg-row\"><div class=\"diagram-node\">Platform<br><small class=\"diagram-muted\">Slack · email · etc.</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><strong>/webhook</strong><br><small class=\"diagram-muted\">verify signature + parse</small><br><span class=\"diagram-pill\">INSERT pending task</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">return 200</div></div><div class=\"msg-fire\"><span class=\"diagram-muted\">fire-and-forget</span> <span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</span></div><div class=\"msg-row\"><div class=\"diagram-box\" data-rough><strong>/process-task</strong><br><small class=\"diagram-muted\">fresh execution · own timeout</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">claim</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">agent loop</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">adapter.sendResponse</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">completed</div></div><div class=\"diagram-panel msg-retry\" data-rough><span class=\"diagram-pill warn\">every 60s</span> <span class=\"diagram-muted\">retry job sweeps stuck tasks (pending &gt;90s · processing &gt;5min) and re-fires /process-task &mdash; capped at 3 attempts, then <strong>failed</strong></span></div></div>",
   "css": ".msg-flow{display:flex;flex-direction:column;gap:12px}.msg-flow .msg-row{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.msg-flow .msg-fire{display:flex;align-items:center;gap:8px;padding-inline-start:12px}.msg-flow .msg-retry{display:flex;align-items:center;gap:8px;flex-wrap:wrap}"

package/docs/content/locales/ar-SA/migration-workbench.md

@@ -9,7 +9,7 @@ description: "الترحيل هو هدف مضمن/ترحيل في مساحة ع
 هدف `/migrate` داخل مساحة عمل [Agent-Native Code](/docs/code-agents-ui).
 يتم تشغيله كجلسة تعليمات برمجية عادية يمكنك استئنافها والإرفاق بها وفحصها وإيقافها.
 
-```an-diagram title="/migrate is a Code session, not a separate app" summary="A path, URL, or description goes in; the run shares the same store, transcript, and controls as every other Code session, and can emit a portable dossier."
+```an-diagram title="/migrate عبارة عن جلسة تعليمات برمجية، وليست تطبيقًا منفصلاً" summary="يتم إدخال المسار، URL، أو الوصف؛ يشترك التشغيل في نفس المخزن والنص وعناصر التحكم مثل أي جلسة تعليمات برمجية أخرى، ويمكن أن يصدر ملفًا محمولاً."
 {
   "html": "<div class=\"diagram-migrate\"><div class=\"diagram-col\"><div class=\"diagram-pill\">./local-app</div><div class=\"diagram-pill\">https://example.com</div><div class=\"diagram-pill\">--describe \\\"...\\\"</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">/migrate goal</span><small class=\"diagram-muted\">same store · transcript · run controls</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\" data-rough>Migrated app</div><div class=\"diagram-pill ok\">--emit dossier</div></div></div>",
   "css": ".diagram-migrate{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-migrate .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-migrate .diagram-arrow{font-size:22px;line-height:1}.diagram-migrate .center{display:flex;flex-direction:column;align-items:center;gap:4px}"

package/docs/content/locales/ar-SA/multi-app-workspace.md

@@ -45,16 +45,16 @@ npx @agent-native/core@latest create my-company-platform
 
 تحصل على pnpm monorepo مع الحزمة المشتركة الخاصة، و`package.json` الجذري الذي يربط اكتشاف مساحة العمل، و`.env` مشترك، ودليل فرعي واحد لكل تطبيق اخترته:
 
-```an-file-tree title="A scaffolded workspace"
+```an-file-tree title="workspace مولد"
 {
   "entries": [
-    { "path": "package.json", "note": "declares agent-native.workspaceCore" },
+    { "path": "package.json", "note": "يعلن agent-native.workspaceCore" },
     { "path": "pnpm-workspace.yaml", "note": "packages: [\"packages/*\", \"apps/*\"]" },
-    { "path": ".env.example", "note": "shared ANTHROPIC_API_KEY, A2A_SECRET, DATABASE_URL, ..." },
+    { "path": ".env.example", "note": "ANTHROPIC_API_KEY و A2A_SECRET و DATABASE_URL و ... مشتركة" },
     { "path": "packages/shared/", "note": "@my-company-platform/shared" },
-    { "path": "packages/shared/src/server/", "note": "plugin overrides only when needed" },
-    { "path": "packages/shared/src/client/", "note": "shared React code only when needed" },
-    { "path": "packages/shared/AGENTS.md", "note": "workspace-wide instructions" },
+    { "path": "packages/shared/src/server/", "note": "plugin overrides عند الحاجة فقط" },
+    { "path": "packages/shared/src/client/", "note": "React code مشترك عند الحاجة فقط" },
+    { "path": "packages/shared/AGENTS.md", "note": "تعليمات على مستوى workspace" },
     { "path": "apps/mail/" },
     { "path": "apps/calendar/" },
     { "path": "apps/forms/" }
@@ -115,7 +115,7 @@ pnpm dev
 
 يتم الدمج حسب اسم الملف. إذا كان التطبيق يوفر ملفًا محليًا موجودًا أيضًا في المنبع، فسيفوز الملف المحلي. إذا لم يحدث ذلك، فسيتم تطبيق الإصدار المشترك لمساحة العمل. إذا لم توفر المشاركة واحدًا أيضًا، فسيتم تفعيل إطار العمل الافتراضي. وينطبق هذا على المكونات الإضافية، skills، وactions، و`AGENTS.md`.
 
-```an-diagram title="Three layers, merged by file name" summary="Each app resolves plugins, skills, actions, and AGENTS.md from app-local first, then the shared package, then the framework default."
+```an-diagram title="ثلاث طبقات، مدمجة حسب اسم الملف" summary="يحل كل تطبيق المكونات الإضافية والمهارات والإجراءات وAGENTS.md من التطبيق المحلي أولاً، ثم الحزمة المشتركة، ثم إطار العمل الافتراضي."
 {
   "html": "<div class=\"layer\"><div class=\"diagram-card accent\"><span class=\"diagram-pill accent\">1 &middot; App local</span><small class=\"diagram-muted\"><code>apps/&lt;name&gt;/</code> &mdash; highest priority</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">2 &middot; Workspace shared</span><small class=\"diagram-muted\"><code>packages/shared/</code> &mdash; the mid-layer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">3 &middot; Framework default</span><small class=\"diagram-muted\"><code>@agent-native/core</code> &mdash; lowest</small></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box ok\">first match wins</div></div>",
   "css": ".layer{display:flex;flex-direction:column;align-items:center;gap:6px}.layer .diagram-card{display:flex;flex-direction:column;gap:3px;padding:12px 16px;width:320px}.layer .diagram-arrow{font-size:18px;line-height:1}.layer .diagram-box{margin-top:2px}"
@@ -225,7 +225,7 @@ npx @agent-native/core@latest deploy
 
 تم إنشاء كل تطبيق باستخدام `APP_BASE_PATH=/<name>` و`VITE_APP_BASE_PATH=/<name>` ويتم إصداره من خلال الإعداد المسبق المحدد Nitro. يعد Cloudflare Pages هو الإعداد المسبق الافتراضي ويستخدم عامل إرسال في `dist/_worker.js` بالإضافة إلى `_routes.json`. Netlify مدعوم مع `npx @agent-native/core@latest deploy --preset netlify`؛ فهو يصدر وظائف التطبيق ضمن `.netlify/functions-internal/<app>-server` ويقوم بإنشاء عمليات إعادة توجيه تترك الأصول الثابتة غير قسرية بحيث يخدم CDN الملفات أولاً. Vercel مدعوم بـ `npx @agent-native/core@latest deploy --preset vercel`؛ فهو يكتب حزمة `.vercel/output` الجذرية باستخدام Vercel’s Build Output API.
 
-```an-diagram title="Unified deploy: one origin, one path per app" summary="Every app ships behind a single origin, so login sessions and cross-app A2A are free."
+```an-diagram title="النشر الموحد: أصل واحد ومسار واحد لكل تطبيق" summary="يأتي كل تطبيق من مصدر واحد، لذا فإن جلسات تسجيل الدخول والتطبيقات المشتركة A2A مجانية."
 {
   "html": "<div class=\"deploy\"><div class=\"diagram-box accent\">your-agents.com<br><small class=\"diagram-muted\">one DNS record &middot; one cert &middot; one CDN</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"deploy-apps\"><div class=\"diagram-box\">/mail/*</div><div class=\"diagram-box\">/calendar/*</div><div class=\"diagram-box\">/forms/*</div></div><div class=\"diagram-pill ok\">shared login cookie on the apex &bull; same-origin A2A, no CORS</div></div>",
   "css": ".deploy{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.deploy .deploy-apps{display:flex;flex-direction:column;gap:8px}.deploy .diagram-arrow{font-size:24px}.deploy .diagram-pill{flex-basis:100%}"