@agent-native/core 0.79.25 → 0.79.27

package/docs/content/locales/ar-SA/workspace-connections.mdx

@@ -16,13 +16,75 @@ description: "البيانات الوصفية للموفر المشترك وال
 - **credentialRef** — مؤشر إلى سر المخزن (`{ key: "SLACK_BOT_TOKEN", scope: "org" }`). يشير الاتصال إلى المكان الذي يعيش فيه الرمز المميز؛ القبو يحمل القيمة.
 - **الاستعداد** — الحالة المدمجة التي يراها التطبيق: `connected` (تم منحه + وجود بيانات الاعتماد)، أو `needs_grant`، أو `needs_credentials`، أو `needs_attention`، أو `not_configured`.
 
-```an-diagram title="اتصل مرة واحدة، وامنح التطبيقات، وأعد استخدام بيانات الاعتماد" summary="يحتوي الاتصال على بيانات تعريف الموفر (ليست أسرارًا أبدًا) وبيانات الاعتماد التي تشير إلى المخزن. تفتح المنح لكل تطبيق هذه الميزة. تقرأ التطبيقات حالة استعداد واحدة."
-{
-  "html": "<div class=\"diagram-conn\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection</span><div class=\"diagram-box\" data-rough>named provider account<br><small class=\"diagram-muted\">provider, label, الحالة، النطاقات، الإعدادات &middot; never stores secret values</small></div><div class=\"diagram-muted\">credentialRef &rarr; pointer to a vault secret</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill\">Grant</span><div class=\"diagram-box\" data-rough>per-app permission<br><small class=\"diagram-muted\">no grant = no credential access</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Readiness</span><small class=\"diagram-muted\">what the app sees</small><div class=\"sev-row\"><span class=\"diagram-pill ok\">connected</span><span class=\"diagram-pill warn\">needs_grant</span></div><div class=\"sev-row\"><span class=\"diagram-pill warn\">needs_credentials</span><span class=\"diagram-pill warn\">needs_attention</span></div><div class=\"sev-row\"><span class=\"diagram-pill\">not_configured</span></div></div></div>",
-  "css": ".diagram-conn{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-conn .col{display:flex;flex-direction:column;gap:8px;padding:14px;min-width:220px}.diagram-conn .diagram-arrow{font-size:22px;line-height:1}.diagram-conn .sev-row{display:flex;gap:8px;flex-wrap:wrap}"
+<Diagram id="doc-block-17u3697" title={"اتصل مرة واحدة، وامنح التطبيقات، وأعد استخدام بيانات الاعتماد"} summary={"يحتوي الاتصال على بيانات تعريف الموفر (ليست أسرارًا أبدًا) وبيانات الاعتماد التي تشير إلى المخزن. تفتح المنح لكل تطبيق هذه الميزة. تقرأ التطبيقات حالة استعداد واحدة."}>
+
+```html
+<div class="diagram-conn">
+  <div class="diagram-panel col" data-rough>
+    <span class="diagram-pill accent">Connection</span>
+    <div class="diagram-box" data-rough>
+      named provider account<br /><small class="diagram-muted"
+        >provider, label, الحالة، النطاقات، الإعدادات &middot; never stores
+        secret values</small
+      >
+    </div>
+    <div class="diagram-muted">
+      credentialRef &rarr; pointer to a vault secret
+    </div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel col" data-rough>
+    <span class="diagram-pill">Grant</span>
+    <div class="diagram-box" data-rough>
+      per-app permission<br /><small class="diagram-muted"
+        >no grant = no credential access</small
+      >
+    </div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel col" data-rough>
+    <span class="diagram-pill ok">Readiness</span
+    ><small class="diagram-muted">what the app sees</small>
+    <div class="sev-row">
+      <span class="diagram-pill ok">connected</span
+      ><span class="diagram-pill warn">needs_grant</span>
+    </div>
+    <div class="sev-row">
+      <span class="diagram-pill warn">needs_credentials</span
+      ><span class="diagram-pill warn">needs_attention</span>
+    </div>
+    <div class="sev-row"><span class="diagram-pill">not_configured</span></div>
+  </div>
+</div>
+```
+
+```css
+.diagram-conn {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-conn .col {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  min-width: 220px;
+}
+.diagram-conn .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-conn .sev-row {
+  display: flex;
+  gap: 8px;
+  flex-wrap: wrap;
 }
 ```
 
+</Diagram>
+
 ### مثال عملي: Slack
 
 قم بتوصيل Slack مرة واحدة ومنحه إلى Brain and Analytics:
@@ -260,13 +322,71 @@ const brainCatalog = await listWorkspaceConnectionProviderCatalogForApp({
 
 تجيب البيانات الوصفية لموفر اتصال مساحة العمل على السؤال التالي: "ما هو هذا الموفر، وما الذي يمكنه فعله، وما هي مفاتيح الاعتماد التي قد يحتاجها، وما هي القوالب التي يجب أن تقدمه؟"
 
-```an-diagram title="مخزن الاتصال مقابل المخزن" summary="يمتلك القبو القيمة السرية. يمتلك الاتصال بيانات تعريف الموفر بالإضافة إلى بيانات الاعتماد (المؤشرات). في وقت التنفيذ، يقوم التطبيق بحل المرجع من خلال اتصال ممنوح ويقرأ القيمة من المخزن."
-{
-  "html": "<div class=\"diagram-vault\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">مخزن الاتصالات</span><div class=\"diagram-box\" data-rough>provider account + metadata<br><small class=\"diagram-muted\">الحالة، النطاقات، الإعدادات</small></div><div class=\"diagram-box\" data-rough>credentialRef<br><small class=\"diagram-muted\">{ key: SLACK_BOT_TOKEN, scope: org }</small></div></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\">resolves at execution time through a granted ref</small><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Vault</span><div class=\"diagram-box\" data-rough>secret value<br><small class=\"diagram-muted\">لا تعاد أبدا إلى الوكيل أو الواجهة</small></div></div></div>",
-  "css": ".diagram-vault{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-vault .col{display:flex;flex-direction:column;gap:8px;padding:14px;min-width:220px}.diagram-vault .diagram-card{display:flex;flex-direction:column;gap:6px;padding:12px 14px}.diagram-vault .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-1r591ch" title={"مخزن الاتصال مقابل المخزن"} summary={"يمتلك القبو القيمة السرية. يمتلك الاتصال بيانات تعريف الموفر بالإضافة إلى بيانات الاعتماد (المؤشرات). في وقت التنفيذ، يقوم التطبيق بحل المرجع من خلال اتصال ممنوح ويقرأ القيمة من المخزن."}>
+
+```html
+<div class="diagram-vault">
+  <div class="diagram-panel col" data-rough>
+    <span class="diagram-pill accent">مخزن الاتصالات</span>
+    <div class="diagram-box" data-rough>
+      provider account + metadata<br /><small class="diagram-muted"
+        >الحالة، النطاقات، الإعدادات</small
+      >
+    </div>
+    <div class="diagram-box" data-rough>
+      credentialRef<br /><small class="diagram-muted"
+        >{ key: SLACK_BOT_TOKEN, scope: org }</small
+      >
+    </div>
+  </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"
+      >resolves at execution time through a granted ref</small
+    >
+    <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel col" data-rough>
+    <span class="diagram-pill ok">Vault</span>
+    <div class="diagram-box" data-rough>
+      secret value<br /><small class="diagram-muted"
+        >لا تعاد أبدا إلى الوكيل أو الواجهة</small
+      >
+    </div>
+  </div>
+</div>
+```
+
+```css
+.diagram-vault {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-vault .col {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  min-width: 220px;
+}
+.diagram-vault .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 12px 14px;
+}
+.diagram-vault .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 استخدم كلاهما معًا:
 
 1. يقوم الإرسال (أو مسار إعداد مساحة عمل آخر) بإنشاء سر المخزن الأساسي أو مرجع بيانات الاعتماد OAuth.

package/docs/content/locales/ar-SA/workspace-management.mdx

@@ -9,13 +9,59 @@ description: "التفرع، CODEOWNERS، مراجعة العلاقات العا
 
 يغطي هذا الدليل الجانب التشغيلي لتشغيل مساحة عمل الوكيل الأصلية - كيفية التفرع، ومن يراجع ماذا، وكيفية إعداد ملكية التعليمات البرمجية، وكيف يتناسب مستوى التحكم في Dispatch مع نموذج الإدارة الخاص بك.
 
-```an-diagram title="طائرتان للحكم" summary="Git يحكم التعليمات البرمجية؛ Dispatch يحكم وقت التشغيل. إنهما متكاملان، فلا تنسخ أحدهما داخل الآخر."
-{
-  "html": "<div class=\"gov\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Git وGitHub</span><strong>حوكمة الكود</strong><div class=\"gov-list\"><span class=\"diagram-pill\">CODEOWNERS</span><span class=\"diagram-pill\">branch protection</span><span class=\"diagram-pill\">مراجعة PR</span><span class=\"diagram-pill\">git log / blame</span></div></div><div class=\"diagram-pill diagram-muted\">+</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Dispatch</span><strong>Runtime governance</strong><div class=\"gov-list\"><span class=\"diagram-pill\">vault secrets &amp; grants</span><span class=\"diagram-pill\">workspace resources</span><span class=\"diagram-pill\">agent profiles</span><span class=\"diagram-pill\">approvals &amp; audit</span></div></div></div>",
-  "css": ".gov{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.gov .diagram-card{display:flex;flex-direction:column;gap:8px;padding:16px 18px;flex:1;min-width:240px}.gov .gov-list{display:flex;flex-wrap:wrap;gap:6px;margin-top:4px}"
+<Diagram id="doc-block-608ry9" title={"طائرتان للحكم"} summary={"Git يحكم التعليمات البرمجية؛ Dispatch يحكم وقت التشغيل. إنهما متكاملان، فلا تنسخ أحدهما داخل الآخر."}>
+
+```html
+<div class="gov">
+  <div class="diagram-card">
+    <span class="diagram-pill accent">Git وGitHub</span
+    ><strong>حوكمة الكود</strong>
+    <div class="gov-list">
+      <span class="diagram-pill">CODEOWNERS</span
+      ><span class="diagram-pill">branch protection</span
+      ><span class="diagram-pill">مراجعة PR</span
+      ><span class="diagram-pill">git log / blame</span>
+    </div>
+  </div>
+  <div class="diagram-pill diagram-muted">+</div>
+  <div class="diagram-card">
+    <span class="diagram-pill accent">Dispatch</span
+    ><strong>Runtime governance</strong>
+    <div class="gov-list">
+      <span class="diagram-pill">vault secrets &amp; grants</span
+      ><span class="diagram-pill">workspace resources</span
+      ><span class="diagram-pill">agent profiles</span
+      ><span class="diagram-pill">approvals &amp; audit</span>
+    </div>
+  </div>
+</div>
+```
+
+```css
+.gov {
+  display: flex;
+  align-items: center;
+  gap: 16px;
+  flex-wrap: wrap;
+}
+.gov .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 16px 18px;
+  flex: 1;
+  min-width: 240px;
+}
+.gov .gov-list {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin-top: 4px;
 }
 ```
 
+</Diagram>
+
 ## التفرع
 
 ### الفروع المميزة

package/docs/content/locales/ar-SA/workspace.mdx

@@ -11,13 +11,68 @@ description: "تخصيص Claude على مستوى التعليمات البرم
 
 التطور: ** إنها صفوف SQL، وليست ملفات نظام الملفات. ** يحصل كل مستخدم على مساحة العمل الخاصة به المخزنة في قاعدة البيانات. لا يوجد صندوق تطوير لتدويره، ولا توجد حاوية لكل مستخدم، ولا توجد ملفات لتحميلها. يمكن أن توفر SaaS متعددة المستأجرين لكل مستخدم وكيلًا قابلاً للتخصيص بالكامل مجانًا بشكل أساسي، لأن كل ذلك عبارة عن صفوف - الذاكرة الشخصية، وخوادم MCP الشخصية، وskills الشخصية، والوكلاء الفرعيين الشخصيين - وتستضيف قاعدة التعليمات البرمجية المشتركة كل منهم في وقت واحد.
 
-```an-diagram title="مساحة عمل Claude-Code، ولكن مخزنة في SQL" summary="نفس طبقة التخصيص - التعليمات، والمهارات، والذاكرة، والوكلاء، والوظائف، MCP - باستثناء كل ملف عبارة عن صف في قاعدة بيانات مشتركة متعددة المستأجرين."
-{
-  "html": "<div class=\"ws-map\"><div class=\"diagram-card cc\"><span class=\"diagram-pill warn\">Claude Code / Codex</span><small class=\"diagram-muted\">~/.claude/ on a local disk</small><div class=\"ws-files\"><span class=\"diagram-box\">CLAUDE.md</span><span class=\"diagram-box\">skills/</span><span class=\"diagram-box\">memory</span><span class=\"diagram-box\">mcp.json</span></div><small class=\"diagram-muted\">one codebase per developer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card an\"><span class=\"diagram-pill accent\">مساحة عمل Agent-native</span><small class=\"diagram-muted\">rows in one قاعدة بيانات SQL</small><div class=\"ws-rows\"><span class=\"diagram-pill\">AGENTS.md</span><span class=\"diagram-pill\">skills/&hellip;</span><span class=\"diagram-pill\">memory/&hellip;</span><span class=\"diagram-pill\">mcp-servers/&hellip;</span></div><small class=\"diagram-muted\">قاعدة كود واحدة، مستخدمون متعددون، بنطاقات <code>u:&lt;email&gt;:&hellip;</code></small></div></div>",
-  "css": ".ws-map{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.ws-map .diagram-card{display:flex;flex-direction:column;gap:8px;padding:16px 18px;flex:1;min-width:220px}.ws-map .ws-files,.ws-map .ws-rows{display:flex;flex-wrap:wrap;gap:6px;margin:4px 0}.ws-map .diagram-arrow{font-size:24px}"
+<Diagram id="doc-block-rv7x2e" title={"مساحة عمل Claude-Code، ولكن مخزنة في SQL"} summary={"نفس طبقة التخصيص - التعليمات، والمهارات، والذاكرة، والوكلاء، والوظائف، MCP - باستثناء كل ملف عبارة عن صف في قاعدة بيانات مشتركة متعددة المستأجرين."}>
+
+```html
+<div class="ws-map">
+  <div class="diagram-card cc">
+    <span class="diagram-pill warn">Claude Code / Codex</span
+    ><small class="diagram-muted">~/.claude/ on a local disk</small>
+    <div class="ws-files">
+      <span class="diagram-box">CLAUDE.md</span
+      ><span class="diagram-box">skills/</span
+      ><span class="diagram-box">memory</span
+      ><span class="diagram-box">mcp.json</span>
+    </div>
+    <small class="diagram-muted">one codebase per developer</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-card an">
+    <span class="diagram-pill accent">مساحة عمل Agent-native</span
+    ><small class="diagram-muted">rows in one قاعدة بيانات SQL</small>
+    <div class="ws-rows">
+      <span class="diagram-pill">AGENTS.md</span
+      ><span class="diagram-pill">skills/&hellip;</span
+      ><span class="diagram-pill">memory/&hellip;</span
+      ><span class="diagram-pill">mcp-servers/&hellip;</span>
+    </div>
+    <small class="diagram-muted"
+      >قاعدة كود واحدة، مستخدمون متعددون، بنطاقات
+      <code>u:&lt;email&gt;:&hellip;</code></small
+    >
+  </div>
+</div>
+```
+
+```css
+.ws-map {
+  display: flex;
+  align-items: center;
+  gap: 16px;
+  flex-wrap: wrap;
+}
+.ws-map .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 16px 18px;
+  flex: 1;
+  min-width: 220px;
+}
+.ws-map .ws-files,
+.ws-map .ws-rows {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin: 4px 0;
+}
+.ws-map .diagram-arrow {
+  font-size: 24px;
 }
 ```
 
+</Diagram>
+
 | رمز Claude / Codex                     | مساحة عمل الوكيل الأصلية                         |
 | -------------------------------------- | ------------------------------------------------ |
 | الملفات الموجودة على القرص المحلي لديك | الصفوف في قاعدة بيانات SQL المشتركة              |
@@ -51,13 +106,62 @@ description: "تخصيص Claude على مستوى التعليمات البرم
 
 تنطبق هذه المسارات عبر النطاقات الثلاثة كلها - مساحة العمل، والمؤسسة/التطبيق، والشخصية. يفوز النطاق الأحدث عند وجود نفس المسار على مستويات متعددة.
 
-```an-diagram title="ثلاثة نطاقات، ملف واحد فعال" summary="يحل وقت التشغيل نفس المسار عبر مساحة العمل والتطبيق والنطاقات الشخصية عند القراءة - يفوز النطاق الأكثر تحديدًا."
-{
-  "html": "<div class=\"ws-stack\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Workspace</span><small class=\"diagram-muted\">إعدادات افتراضية على مستوى الشركة من Dispatch</small><code>context/brand.md</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\">team override for one app</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Personal</span><small class=\"diagram-muted\">per-user override &mdash; wins</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">Effective <code>context/brand.md</code></div></div>",
-  "css": ".ws-stack{display:flex;flex-direction:column;align-items:flex-start;gap:8px}.ws-stack .diagram-card{display:flex;flex-direction:column;gap:4px;padding:12px 16px;min-width:280px}.ws-stack .diagram-arrow{font-size:20px;align-self:center}.ws-stack code{font-size:.85em}.ws-stack .diagram-box{align-self:center;margin-top:4px}"
+<Diagram id="doc-block-olr0y7" title={"ثلاثة نطاقات، ملف واحد فعال"} summary={"يحل وقت التشغيل نفس المسار عبر مساحة العمل والتطبيق والنطاقات الشخصية عند القراءة - يفوز النطاق الأكثر تحديدًا."}>
+
+```html
+<div class="ws-stack">
+  <div class="diagram-card">
+    <span class="diagram-pill">Workspace</span
+    ><small class="diagram-muted"
+      >إعدادات افتراضية على مستوى الشركة من Dispatch</small
+    ><code>context/brand.md</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">team override for one app</small
+    ><code>context/brand.md</code>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill accent">Personal</span
+    ><small class="diagram-muted">per-user override &mdash; wins</small
+    ><code>context/brand.md</code>
+  </div>
+  <div class="diagram-arrow diagram-accent" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box ok">Effective <code>context/brand.md</code></div>
+</div>
+```
+
+```css
+.ws-stack {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 8px;
+}
+.ws-stack .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 12px 16px;
+  min-width: 280px;
+}
+.ws-stack .diagram-arrow {
+  font-size: 20px;
+  align-self: center;
+}
+.ws-stack code {
+  font-size: 0.85em;
+}
+.ws-stack .diagram-box {
+  align-self: center;
+  margin-top: 4px;
 }
 ```
 
+</Diagram>
+
 ## الخطوات الأولى: جولة تفصيلية مدتها دقيقة واحدة {#getting-started}
 
 قم بتغيير سلوك الوكيل خلال 60 ثانية.

package/docs/content/locales/ar-SA/writing-agent-instructions.mdx

@@ -7,13 +7,50 @@ description: "كيفية كتابة تعليمات رائعة للوكيل لت
 
 يكون سلوك الوكيل في التطبيق الأصلي للوكيل جيدًا بقدر جودة الإرشادات التي تقدمها له. ثلاثة أسطح تحمل هذا التوجيه: `AGENTS.md` (الخريطة)، skills (الغوص العميق)، وأوصاف الإجراء/الأداة (كيف يختار الوكيل الأداة المناسبة). اكتب كل واحد منها لسرعة استرجاعها، وليس للنثر.
 
-```an-diagram title="ثلاثة أسطح مؤلفة + سطح واحد لوقت التشغيل" summary="AGENTS.md وأوصاف الأداة يتم تحميلها في كل دورة؛ تحميل المهارات عند الطلب؛ تتم كتابة application_state مباشرة بواسطة واجهة المستخدم الخاصة بك."
-{
-  "html": "<div class=\"diagram-surfaces\"><div class=\"diagram-card always\" data-rough><span class=\"diagram-pill accent\">كل دور</span><strong>AGENTS.md</strong><small class=\"diagram-muted\">الخريطة: الغرض، القواعد الأساسية، مفاتيح الحالة، فهرس الإجراءات + المهارات</small></div><div class=\"diagram-card always\" data-rough><span class=\"diagram-pill accent\">كل دور</span><strong>أوصاف الأدوات</strong><small class=\"diagram-muted\">توجه اختيار الأدوات — جملة دقيقة لكل أداة</small></div><div class=\"diagram-card ondemand\" data-rough><span class=\"diagram-pill\">عند الطلب</span><strong>المهارات</strong><small class=\"diagram-muted\">إرشادات معمقة، تحمل عندما ينطبق الوصف</small></div><div class=\"diagram-card runtime\" data-rough><span class=\"diagram-pill ok\">Live</span><strong>application_state</strong><small class=\"diagram-muted\">تكتبه واجهتك: التنقل، التحديد، التركيز</small></div></div>",
-  "css": ".diagram-surfaces{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px}.diagram-surfaces .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px}"
+<Diagram id="doc-block-90auqr" title={"ثلاثة أسطح مؤلفة + سطح واحد لوقت التشغيل"} summary={"AGENTS.md وأوصاف الأداة يتم تحميلها في كل دورة؛ تحميل المهارات عند الطلب؛ تتم كتابة application_state مباشرة بواسطة واجهة المستخدم الخاصة بك."}>
+
+```html
+<div class="diagram-surfaces">
+  <div class="diagram-card always" data-rough>
+    <span class="diagram-pill accent">كل دور</span><strong>AGENTS.md</strong
+    ><small class="diagram-muted"
+      >الخريطة: الغرض، القواعد الأساسية، مفاتيح الحالة، فهرس الإجراءات +
+      المهارات</small
+    >
+  </div>
+  <div class="diagram-card always" data-rough>
+    <span class="diagram-pill accent">كل دور</span><strong>أوصاف الأدوات</strong
+    ><small class="diagram-muted"
+      >توجه اختيار الأدوات — جملة دقيقة لكل أداة</small
+    >
+  </div>
+  <div class="diagram-card ondemand" data-rough>
+    <span class="diagram-pill">عند الطلب</span><strong>المهارات</strong
+    ><small class="diagram-muted">إرشادات معمقة، تحمل عندما ينطبق الوصف</small>
+  </div>
+  <div class="diagram-card runtime" data-rough>
+    <span class="diagram-pill ok">Live</span><strong>application_state</strong
+    ><small class="diagram-muted">تكتبه واجهتك: التنقل، التحديد، التركيز</small>
+  </div>
+</div>
+```
+
+```css
+.diagram-surfaces {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 12px;
+}
+.diagram-surfaces .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 14px 16px;
 }
 ```
 
+</Diagram>
+
 ## اجعل AGENTS.md صغيرًا وقابلاً للمسح {#small-agents-md}
 
 يتم تحميل `AGENTS.md` كاتجاه. يجب أن يكون أصغر شيء يسمح للوكيل بالتصرف بشكل صحيح، مع دفع كل شيء بعمق إلى skills. استهدف هذه الأقسام وأشياء أخرى قليلة:

package/docs/content/locales/de-DE/a2a-protocol.mdx

@@ -20,13 +20,55 @@ Schlüsselkonzepte:
 - **Aufgaben** – jede Nachricht erstellt eine Aufgabe mit einem Lebenszyklus (gesendet, in Arbeit, abgeschlossen, fehlgeschlagen, abgebrochen)
 - **JWT Trägerauthentifizierung** – Produktions-A2A erfordert `A2A_SECRET` oder ein explizites Legacy-`apiKeyEnv`
 
-```an-diagram title="Ein Agent übergibt die Arbeit an einen anderen" summary="Ein E-Mail-Agent erkennt die Karte des Analyseagenten, sendet eine JSON-RPC-Nachricht und erhält eine abgeschlossene Aufgabe zurück."
-{
-  "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\">Aufgabe · abgeschlossen</div></div><div class=\"diagram-card\" data-rough><strong>Analytics-Agent</strong><small class=\"diagram-muted\">führt run-query aus, gibt Ergebnis zurück</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}"
+<Diagram id="doc-block-wcc77o" title={"Ein Agent übergibt die Arbeit an einen anderen"} summary={"Ein E-Mail-Agent erkennt die Karte des Analyseagenten, sendet eine JSON-RPC-Nachricht und erhält eine abgeschlossene Aufgabe zurück."}>
+
+```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">Aufgabe · abgeschlossen</div>
+  </div>
+  <div class="diagram-card" data-rough>
+    <strong>Analytics-Agent</strong
+    ><small class="diagram-muted"
+      >führt run-query aus, gibt Ergebnis zurück</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;
 }
 ```
 
+</Diagram>
+
 ## Server-Setup {#server-setup}
 
 Die meisten Vorlagen erhalten A2A über das Framework-Agent-Chat-Plugin. Wenn Sie es selbst mounten, rufen Sie `mountA2A()` in einem Server-Plugin auf:
@@ -176,14 +218,62 @@ JSON-RPC 2.0 endpoint for `message/send`, `message/stream`, `tasks/get`, and `ta
 
 Wenn `message/send` mit `async: true` aufgerufen wird, stellt der Handler JSON-RPC die Aufgabe in die Warteschlange und löst selbst einen POST auf einer internen `/_agent-native/a2a/_process-task`-Route aus, sodass der Handler in einer neuen Funktionsausführung mit seinem eigenen vollständigen Timeout ausgeführt wird. Diese Route wird mit einem HMAC-Token authentifiziert, das an die Task-ID gebunden ist (Lebensdauer 5 Minuten, signiert mit `A2A_SECRET`). Es wird vor der Route `/_agent-native/a2a` JSON-RPC gemountet, sodass der Präfixabgleich von h3 es nicht verschluckt.
 
-```an-diagram title="Asynchroner Aufgabenlebenszyklus auf serverlosem Server" summary="async:true kehrt in Millisekunden zum Betrieb zurück, dann führt eine neue Ausführung die Agentenschleife aus, während der Anrufer abfragt."
-{
-  "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\">~Millisekunden</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>Selbstauslösender POST /_agent-native/a2a/_process-task<br><small class=\"diagram-muted\">HMAC-Token · frische Ausführung · volles 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>",
-  "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."
+<Diagram id="doc-block-1g6v7jz" title="Asynchroner Aufgabenlebenszyklus auf serverlosem Server" summary={"async:true kehrt in Millisekunden zum Betrieb zurück, dann führt eine neue Ausführung die Agentenschleife aus, während der Anrufer abfragt."} caption="A recurring sweeper re-claims any task left in flight if the function execution dies mid-run.">
+
+```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">~Millisekunden</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-box" data-rough>
+    Selbstauslösender POST /_agent-native/a2a/_process-task<br /><small
+      class="diagram-muted"
+      >HMAC-Token · frische Ausführung · volles 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>
+```
+
+```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;
 }
 ```
 
+</Diagram>
+
 > [!IMPORTANT]
 > **Serverlose Webhook- und Gateway-Zeitüberschreitungen:**
 > Gehostete Umgebungs-Gateways (wie Netlify, Vercel oder Cloudflare Pages) legen strenge Ausführungslimits (oft 10 bis 30 Sekunden) für öffentlich zugängliche HTTP-Routen fest. Da Agent-Schleifen viel Zeit in Anspruch nehmen können, um Abfragen auszuführen, Kontext abzurufen und Tools auszuführen, müssen Sie `async: true` verwenden, wenn Sie A2A-Endpunkte aufrufen oder externe webhooks verarbeiten. Dadurch wird sofort ein `working`-Status an das API-Gateway zurückgegeben, wodurch die Verbindung nur für einige Millisekunden geöffnet bleibt, während der selbstauslösende `/process-task` POST die Agentenschleife im Hintergrund ausführt. Blockieren Sie nicht die primäre HTTP-Anfrage, die auf den Abschluss der Agentenschleife wartet.

package/docs/content/locales/de-DE/actions.mdx

@@ -19,13 +19,76 @@ Eine Definition, sieben Verbraucher. Dies ist Sprosse 3 des [ladder](/docs/what-
 Wenn Sie entscheiden, ob Sie einen Vorgang kopflos, im Chat oder in einem
 eingebetteter Sidecar oder als vollständiger App-Bildschirm, siehe [Agent Surfaces](/docs/agent-surfaces).
 
-```an-diagram title="Eine Definition, sieben Verbraucher" summary="Ein einzelner defineAction() verteilt sich auf jede Oberfläche – Agent, UI, HTTP, MCP, A2A und CLI – mit einem validierten Schema und einem run()-Körper."
-{
-  "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(), einmal definiert</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><div class=\"diagram-node\">Agentenwerkzeug<br><small class=\"diagram-muted\">JSON Schema im Kontext</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\">imperativer Client</small></div><div class=\"diagram-node\">HTTP<br><small class=\"diagram-muted\">/_agent-native/actions/:name</small></div><div class=\"diagram-node\">MCP-Werkzeug<br><small class=\"diagram-muted\">externe Hosts</small></div><div class=\"diagram-node\">A2A-Tool<br><small class=\"diagram-muted\">andere agent-native Apps</small></div><div class=\"diagram-node\">CLI<br><small class=\"diagram-muted\">pnpm action &lt;name&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}"
+<Diagram id="doc-block-12eu8ac" title="Eine Definition, sieben Verbraucher" summary={"Ein einzelner defineAction() verteilt sich auf jede Oberfläche – Agent, UI, HTTP, MCP, A2A und CLI – mit einem validierten Schema und einem run()-Körper."}>
+
+```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(), einmal definiert</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-grid">
+    <div class="diagram-node">
+      Agentenwerkzeug<br /><small class="diagram-muted"
+        >JSON Schema im Kontext</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">imperativer Client</small>
+    </div>
+    <div class="diagram-node">
+      HTTP<br /><small class="diagram-muted"
+        >/_agent-native/actions/:name</small
+      >
+    </div>
+    <div class="diagram-node">
+      MCP-Werkzeug<br /><small class="diagram-muted">externe Hosts</small>
+    </div>
+    <div class="diagram-node">
+      A2A-Tool<br /><small class="diagram-muted"
+        >andere agent-native Apps</small
+      >
+    </div>
+    <div class="diagram-node">
+      CLI<br /><small class="diagram-muted">pnpm action &lt;name&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;
 }
 ```
 
+</Diagram>
+
 Wenn sowohl der UI als auch der Agent etwas tun müssen, greifen Sie zu einer Aktion – nicht zu einer benutzerdefinierten Aktion
 Route. Wenn ein routenförmiges Protokoll der richtige Aufruf ist, lesen Sie [Bevorzugen Sie Actions
 Für App Operations](/docs/server#actions-first).