@agent-native/core 0.77.3 → 0.77.4

package/corpus/core/docs/content/locales/ar-SA/workspace-management.md

@@ -11,7 +11,7 @@ description: "التفرع، CODEOWNERS، مراجعة العلاقات العا
 
 ```an-diagram title="طائرتان للحكم" summary="Git يحكم التعليمات البرمجية؛ Dispatch يحكم وقت التشغيل. إنهما متكاملان، فلا تنسخ أحدهما داخل الآخر."
 {
-  "html": "<div class=\"gov\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Git / GitHub</span><strong>Code governance</strong><div class=\"gov-list\"><span class=\"diagram-pill\">CODEOWNERS</span><span class=\"diagram-pill\">branch protection</span><span class=\"diagram-pill\">PR review</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>",
+  "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}"
 }
 ```
@@ -64,16 +64,16 @@ main                         ← production
 # Framework core — affects every app; platform team reviews all changes
 packages/core/                     @your-org/platform-team
 
-# Dispatch control plane — secrets, integrations, workspace resources
+# مستوى التحكم في الإرسال - الأسرار، والتكامل، وموارد مساحة العمل
 templates/dispatch/                @your-org/platform-team
 
-# Per-app ownership — each team reviews their own app
+# ملكية كل تطبيق — يقوم كل فريق بمراجعة التطبيق الخاص به
 templates/mail/                    @your-org/mail-team
 templates/analytics/               @your-org/analytics-team
 templates/calendar/                @your-org/calendar-team
 # ... add an entry per app
 
-# Workspace-level config — broad review since it affects everyone
+# التكوين على مستوى مساحة العمل — مراجعة واسعة النطاق نظرًا لأنه يؤثر على الجميع
 .github/                           @your-org/platform-team
 package.json                       @your-org/platform-team
 pnpm-workspace.yaml                @your-org/platform-team

package/corpus/core/docs/content/locales/ar-SA/workspace.md

@@ -13,7 +13,7 @@ description: "تخصيص Claude على مستوى التعليمات البرم
 
 ```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 workspace</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\">one codebase, many users, scoped <code>u:&lt;email&gt;:&hellip;</code></small></div></div>",
+  "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}"
 }
 ```
@@ -53,7 +53,7 @@ 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\">company-wide defaults from 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\">Organization / app</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>",
+  "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}"
 }
 ```
@@ -65,7 +65,7 @@ description: "تخصيص Claude على مستوى التعليمات البرم
 1. افتح علامة التبويب **مساحة العمل** → **مشتركة** → `AGENTS.md` (قم بإنشائها باستخدام `+` → **ملف** إذا كان مفقودًا).
 2. أضف قاعدة واحدة، على سبيل المثال:
 
-   ```تخفيض السعر
+   ```Markdown
    ## النغمة
 
    كن موجزًا. ابدأ بالإجابة.
@@ -74,7 +74,7 @@ description: "تخصيص Claude على مستوى التعليمات البرم
 3. احفظ، وانتقل إلى **الدردشة**، واسأل عن أي شيء — يتبع الوكيل القاعدة الجديدة على الفور.
 
 ```an-callout
-{ "tone": "info", "body": "No restart, no redeploy. `AGENTS.md` is read at the start of every turn, so an edit you save now changes the agent's behavior on the very next message." }
+{ "tone": "info", "body": "لا إعادة تشغيل ولا إعادة نشر. تتم قراءة `AGENTS.md` في بداية كل دورة، لذا فإن التعديل الذي تحفظه الآن يغير سلوك الوكيل في الرسالة التالية." }
 ```
 
 **الخطوات التالية، عندما تريدها:**
@@ -96,10 +96,10 @@ description: "تخصيص Claude على مستوى التعليمات البرم
 حزمة بداية مفيدة لمساحة عمل جديدة:
 
 ```text
-context/company.md              # what the company does, ICP, products, links
-context/brand.md                # voice, visual identity, spelling, forbidden usage
-context/messaging.md            # positioning, value props, proof points, objections
-instructions/guardrails.md      # compliance, escalation, and approval rules
+context/company.md              # ما تفعله الشركة ICP المنتجات والروابط
+context/brand.md                # الصوت، الهوية البصرية، التهجئة، الاستخدام المحظور
+context/messaging.md            # تحديد المواقع، دعائم القيمة، نقاط الإثبات، الاعتراضات
+instructions/guardrails.md      # قواعد الامتثال والتصعيد والموافقة
 skills/company-voice/SKILL.md   # on-demand guidance for customer-facing writing
 agents/<slug>.md                # reusable custom agent profiles
 ```
@@ -119,7 +119,7 @@ workspace context/brand.md
 ```text
 <!-- context/brand.md -->
 
-# Brand
+# العلامة التجارية
 
 - Voice: direct, warm, concrete
 - Use: "workspace", "agent", "team"
@@ -183,18 +183,18 @@ instructions/legal-review-policy.md
 
 كل سطح من هذه الأسطح — `AGENTS.md`، skills، الذاكرة، الوكلاء المخصصون، خوادم MCP — هو نفس شكل المورد الأساسي: `path` + `scope` + `content`، ويتم التعامل معه وحله بنفس الطريقة.
 
-```an-schema title="The workspace resource model" summary="One resource shape backs every workspace file. The runtime keys it by path and scope and resolves the effective value on read."
+```an-schema title="نموذج موارد مساحة العمل" summary="يدعم شكل مورد واحد كل ملف مساحة عمل. يقوم وقت التشغيل بمفاتيحه حسب المسار والنطاق ويحل القيمة الفعالة عند القراءة."
 {
   "entities": [
     {
       "id": "resource",
       "name": "workspace resource",
-      "note": "A single file in a user's workspace — instructions, skill, memory, agent, MCP config, or job.",
+      "note": "ملف واحد في مساحة عمل المستخدم - التعليمات، أو المهارة، أو الذاكرة، أو الوكيل، أو تكوين MCP، أو المهمة.",
       "fields": [
         { "name": "path", "type": "string", "note": "Canonical path, e.g. AGENTS.md, skills/<slug>/SKILL.md" },
-        { "name": "scope", "type": "workspace | shared | personal", "note": "Which level this row lives at" },
+        { "name": "scope", "type": "workspace | shared | personal", "note": "في أي مستوى يعيش هذا الصف" },
         { "name": "owner", "type": "string", "nullable": true, "note": "u:<email> for personal scope" },
-        { "name": "content", "type": "text", "note": "Markdown / JSON / YAML body" }
+        { "name": "content", "type": "text", "note": "Markdown / JSON / YAML الجسم" }
       ]
     }
   ]
@@ -221,12 +221,12 @@ Skills هي ملفات موارد Markdown ضمن مسار `skills/` (يفضل `
 {
   "filename": "agents/design.md",
   "language": "markdown",
-  "code": "---\nname: Design\ndescription: >-\n  Reviews layouts, interaction patterns, and product UX decisions.\nmodel: inherit\ntools: inherit\ndelegate-default: false\n---\n\n# Role\n\nYou are a focused design agent.\n\n## Responsibilities\n\n- Review layouts and interaction flows\n- Suggest stronger visual direction\n- Be concise and opinionated",
+  "code": "---\nname: Design\ndescription: >-\n  Reviews layouts, interaction patterns, and product UX decisions.\nmodel: inherit\ntools: inherit\ndelegate-default: false\n---\n\n# الدور\n\nأنت وكيل تصميم مركّز.\n\n## المسؤوليات\n\n- مراجعة التخطيطات وتدفقات التفاعل\n- اقتراح اتجاه مرئي أقوى\n- كن موجزًا وصاحب رأي",
   "annotations": [
-    { "lines": "2", "label": "@mention handle", "note": "`name` is what appears in the `@`-dropdown and what the main agent delegates to." },
-    { "lines": "3-4", "label": "When to delegate", "note": "The `description` is what the orchestrator reads to decide this profile fits a task." },
-    { "lines": "5", "label": "Model", "note": "`inherit` reuses the main agent's model. Override only when the profile clearly needs a different one." },
-    { "lines": "6", "note": "`tools: inherit` for now — the field is reserved for future per-agent tool policies." }
+    { "lines": "2", "label": "@mention handle", "note": "`name` هو ما يظهر في القائمة المنسدلة `@` وما يفوضه الوكيل الرئيسي." },
+    { "lines": "3-4", "label": "متى يتم التفويض", "note": "`description` هو ما يقرأه المنسق ليقرر أن ملف التعريف هذا يناسب المهمة." },
+    { "lines": "5", "label": "نموذج", "note": "`inherit` يعيد استخدام نموذج الوكيل الرئيسي. يتم التجاوز فقط عندما يحتاج ملف التعريف بوضوح إلى ملف تعريف مختلف." },
+    { "lines": "6", "note": "`tools: inherit` في الوقت الحالي — الحقل محجوز لسياسات الأدوات المستقبلية لكل وكيل." }
   ]
 }
 ```
@@ -303,21 +303,21 @@ Skills هي ملفات موارد Markdown ضمن مسار `skills/` (يفضل `
 يستخدم الوكيل هذه actions المضمنة. يمكنك أيضًا الاتصال بهم من actions الخاص بك:
 
 ```bash
-# List all resources
+# قم بإدراج كافة الموارد
 pnpm action resource-list --scope all
 
-# Read a resource
+# اقرأ أحد الموارد
 pnpm action resource-read --path "skills/my-skill/SKILL.md"
 
-# Read inherited workspace context managed by Dispatch
+# قراءة سياق مساحة العمل الموروثة التي يديرها Dispatch
 pnpm action resource-read --scope workspace --path "context/brand.md"
 
 # Show workspace -> organization/app -> personal precedence for a path
 pnpm action resource-effective --path "context/brand.md"
 
-# Write a resource
-pnpm action resource-write --path "notes/meeting.md" --content "# Meeting Notes..."
+# اكتب مصدرًا
+pnpm action resource-write --path "notes/meeting.md" --content "# ملاحظات الاجتماع..."
 
-# Delete a resource
+# حذف مورد
 pnpm action resource-delete --path "notes/old.md"
 ```

package/corpus/core/docs/content/locales/ar-SA/writing-agent-instructions.md

@@ -1,15 +1,15 @@
 ---
-title: "تعليمات وكيل الكتابة وSkills"
+title: "تعليمات وكيل الكتابة والمهارات"
 description: "كيفية كتابة تعليمات رائعة للوكيل لتطبيق أو قالب أصلي للوكيل: AGENTS.md وskills وأوصاف الأدوات."
 ---
 
-# تعليمات وكيل الكتابة وSkills
+# تعليمات وكيل الكتابة والمهارات
 
 يكون سلوك الوكيل في التطبيق الأصلي للوكيل جيدًا بقدر جودة الإرشادات التي تقدمها له. ثلاثة أسطح تحمل هذا التوجيه: `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\">Every turn</span><strong>AGENTS.md</strong><small class=\"diagram-muted\">the map: purpose, core rules, state keys, action + skills index</small></div><div class=\"diagram-card always\" data-rough><span class=\"diagram-pill accent\">Every turn</span><strong>Tool descriptions</strong><small class=\"diagram-muted\">drive tool selection — one precise sentence each</small></div><div class=\"diagram-card ondemand\" data-rough><span class=\"diagram-pill\">On demand</span><strong>Skills</strong><small class=\"diagram-muted\">deep how-to, loaded when the description fires</small></div><div class=\"diagram-card runtime\" data-rough><span class=\"diagram-pill ok\">Live</span><strong>application_state</strong><small class=\"diagram-muted\">written by your UI: navigation, selection, focus</small></div></div>",
+  "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}"
 }
 ```
@@ -22,28 +22,28 @@ description: "كيفية كتابة تعليمات رائعة للوكيل لت
 - **القواعد الأساسية** — مجموعة من الثوابت التي يجب الاحتفاظ بها دائمًا (البيانات في SQL، والعمليات تمر عبر actions، ويمر الذكاء الاصطناعي عبر دردشة الوكيل، وتكون تغييرات المخطط إضافية). رصاصات قصيرة وضرورية.
 - **مفاتيح حالة التطبيق** — مفاتيح `navigation`/التحديد/التركيز التي يقرأها الوكيل لمعرفة ما ينظر إليه المستخدم وشكله.
 - **جدول الإجراءات** — جدول مضغوط يتضمن اسم الإجراء والغرض.
-- **فهرس Skills** — قائمة بـ skills الموجودة ومتى يجب قراءة كل منها.
+- **فهرس المهارات** — قائمة بـ skills الموجودة ومتى يجب قراءة كل منها.
 
 إذا تجاوز القسم الشاشة، فهو ينتمي إلى مهارة. يجيب `AGENTS.md` على "ما هذا التطبيق وماذا يمكنني أن أفعل"، وليس "كيف أفعل الشيء الصعب بالضبط".
 
 ```markdown
-# Projects App
+# تطبيق المشاريع
 
 One workspace for projects, tasks, and notes. Agent and UI share the same SQL
 data and the same actions.
 
-## Core Rules
+## القواعد الأساسية
 
-- Data lives in SQL via Drizzle. Use actions for all writes.
+- Data lives in SQL عبر Drizzle. Use actions for all writes.
 - All AI work goes through the agent chat; never call an LLM inline.
 - Schema changes are additive only.
 
-## Application State
+## حالة التطبيق
 
 - `navigation.view`: `home` | `project`
 - `navigation.projectId`: selected project on a project page
 
-## Actions
+## الإجراءات
 
 | Action           | Purpose                     |
 | ---------------- | --------------------------- |
@@ -51,7 +51,7 @@ data and the same actions.
 | `create-project` | Create a project            |
 | `update-project` | Rename or archive a project |
 
-## Skills
+## المهارات
 
 - `project-imports` — read before importing legacy CSV exports.
 - `sharing` — read before exposing a project to other users.
@@ -84,12 +84,12 @@ description: >-
 
 ```text
 .agents/skills/project-imports/
-├── SKILL.md            # rule + happy path + do/don't
+├── SKILL.md            # القاعدة + المسار السعيد + do/don't
 └── references/
-    └── csv-format.md   # full column spec, encodings, edge cases
+    └── csv-format.md   # مواصفات العمود الكامل، والترميزات، وحالات الحافة
 ```
 
-يؤدي ذلك إلى إبقاء السطح الذي يتم تحميله دائمًا صغيرًا ويسمح بقياس العمق دون انتفاخ السياق. راجع [Skills Guide](/docs/skills-guide) للحصول على تنسيق المهارات الكاملة.
+يؤدي ذلك إلى إبقاء السطح الذي يتم تحميله دائمًا صغيرًا ويسمح بقياس العمق دون انتفاخ السياق. راجع [المهارات Guide](/docs/skills-guide) للحصول على تنسيق المهارات الكاملة.
 
 ## اكتب جداول موجهة نحو العمل {#action-tables}
 
@@ -114,9 +114,9 @@ defineAction({
 });
 ```
 
-## Skills ضد actions {#skills-vs-actions}
+## المهارات ضد actions {#skills-vs-actions}
 
-Skills وactions متكاملان. المهارة هي التوجيه الذي يقرأه الوكيل؛
+المهارات وactions متكاملان. المهارة هي التوجيه الذي يقرأه الوكيل؛
 الإجراء هو رمز يمكن للوكيل تشغيله.
 
 | الحاجة                                                                          | استخدام               |
@@ -151,7 +151,7 @@ Skills وactions متكاملان. المهارة هي التوجيه الذي
 | السطح                    | من يكتبها                        | عندما يتم تحميله                               | ما الذي ينتمي إليه                                                |
 | ------------------------ | -------------------------------- | ---------------------------------------------- | ----------------------------------------------------------------- |
 | تعليمات `AGENTS.md`      | أنت (المطور)                     | كل منعطف، كتوجيه                               | الغرض، القواعد الأساسية، مفاتيح الحالة، فهرس الإجراء، فهرس skills |
-| Skills (`SKILL.md`)      | أنت (المطور)                     | عند الطلب عندما يقرر الوكيل أن المهارة ذات صلة | كيفية تنفيذ نمط معين خطوة بخطوة، وقوائم المهام المحظورة           |
+| المهارات (`SKILL.md`)    | أنت (المطور)                     | عند الطلب عندما يقرر الوكيل أن المهارة ذات صلة | كيفية تنفيذ نمط معين خطوة بخطوة، وقوائم المهام المحظورة           |
 | أوصاف الإجراء (الأدوات)  | أنت (المطور)                     | كل منعطف، كقائمة الأدوات                       | ما يفعله الإجراء، وما يُرجعه، ودلالات المعلمات                    |
 | سياق `application_state` | رمز UI الخاص بك (في وقت التشغيل) | كل منعطف، كحالة التطبيق المباشر                | التنقل الحالي، التحديد، الكائن الذي تم التركيز عليه، URL          |
 
@@ -163,11 +163,11 @@ Skills وactions متكاملان. المهارة هي التوجيه الذي
 ## ماذا يحدث وأين {#what-goes-where}
 
 - **AGENTS.md** — ينطبق على التطبيق بأكمله، في كل دورة: الغرض، والقواعد الأساسية، ومفاتيح الحالة، وفهرس الإجراء، وفهرس skills.
-- **Skills** — طريقة عمل قابلة لإعادة الاستخدام لنمط معين، ويتم تحميلها عند الطلب. ينطبق على جميع العاملين في التطبيق.
+- **المهارات** — طريقة عمل قابلة لإعادة الاستخدام لنمط معين، ويتم تحميلها عند الطلب. ينطبق على جميع العاملين في التطبيق.
 - **الذاكرة (`memory/MEMORY.md`)** — التفضيلات والتصحيحات لكل مستخدم، وليس توجيهات المؤلف.
 
 ## ما هي الخطوة التالية {#whats-next}
 
-- [Skills Guide](/docs/skills-guide) — تنسيق ملف المهارات، وإطار العمل skills، وskills المدعوم بالتطبيق.
+- [المهارات Guide](/docs/skills-guide) — تنسيق ملف المهارات، وإطار العمل skills، وskills المدعوم بالتطبيق.
 - [Creating Templates](/docs/creating-templates) — كيف يتناسب `AGENTS.md` وskills مع القالب القابل للشحن.
 - [The four-area checklist](/docs/key-concepts#four-area-checklist) — نموذج المناطق الأربع الذي يجب أن تلبيه كل ميزة.

package/corpus/core/docs/content/locales/de-DE/a2a-protocol.md

@@ -22,7 +22,7 @@ Schlüsselkonzepte:
 
 ```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\">task · completed</div></div><div class=\"diagram-card\" data-rough><strong>Analytics agent</strong><small class=\"diagram-muted\">runs run-query, returns result</small></div></div>",
+  "html": "<div class=\"diagram-handoff\"><div class=\"diagram-card\"><strong>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}"
 }
 ```
@@ -119,11 +119,11 @@ Alle Methoden werden über `POST /_agent-native/a2a` im JSON-RPC 2.0-Format aufg
 | `tasks/get`      | Eine Aufgabe nach ID abrufen – wird verwendet, um eine asynchrone Aufgabe bis zum Abschluss abzurufen                                                                   | `id`                          |
 | `tasks/cancel`   | Eine laufende Aufgabe abbrechen                                                                                                                                         | `id`                          |
 
-```an-api title="Primary A2A endpoint" summary="All JSON-RPC methods are POSTed here. message/send shown."
+```an-api title="Primärer A2A-Endpunkt" summary="Alle JSON-RPC-Methoden sind hier POSTed. message/send angezeigt."
 {
   "method": "POST",
   "path": "/_agent-native/a2a",
-  "summary": "Send a message and wait for the completed task",
+  "summary": "Senden Sie eine Nachricht und warten Sie auf die abgeschlossene Aufgabe",
   "description": "JSON-RPC 2.0 endpoint for `message/send`, `message/stream`, `tasks/get`, and `tasks/cancel`. Pass `async: true` to return immediately in `working` state and poll with `tasks/get`.",
   "auth": "JWT bearer signed with A2A_SECRET (or legacy apiKeyEnv static token)",
   "params": [
@@ -148,7 +148,7 @@ Wenn `message/send` mit `async: true` aufgerufen wird, stellt der Handler JSON-R
 
 ```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\">~milliseconds</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>self-fire POST /_agent-native/a2a/_process-task<br><small class=\"diagram-muted\">HMAC token · fresh execution · full timeout</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-pill\">tasks/get (poll)</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-pill ok\">completed</div></div></div>",
+  "html": "<div class=\"diagram-async\"><div class=\"diagram-box\" data-rough>message/send<br><small class=\"diagram-muted\">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."
 }
@@ -165,9 +165,9 @@ Nachrichten enthalten typisierte Teile – Text, strukturierte Daten und Dateien
   "language": "json",
   "code": "{\n  \"role\": \"user\",\n  \"parts\": [\n    { \"type\": \"text\", \"text\": \"Show signups by source\" },\n    { \"type\": \"data\", \"data\": { \"dateRange\": \"last-30d\" } },\n    {\n      \"type\": \"file\",\n      \"file\": { \"name\": \"report.csv\", \"mimeType\": \"text/csv\", \"bytes\": \"...\" }\n    }\n  ]\n}",
   "annotations": [
-    { "lines": "4", "label": "text part", "note": "Plain natural-language instruction the agent reads." },
-    { "lines": "5", "label": "data part", "note": "Structured JSON arguments — e.g. a date range — passed alongside the prompt." },
-    { "lines": "6-9", "label": "file part", "note": "Attach a file by name, `mimeType`, and base64 `bytes`." }
+    { "lines": "4", "label": "text part", "note": "Einfache Anweisungen in natürlicher Sprache, die der Agent vorliest." },
+    { "lines": "5", "label": "data part", "note": "Strukturierte JSON-Argumente – z.B. ein Datumsbereich – wird zusammen mit der Eingabeaufforderung übergeben." },
+    { "lines": "6-9", "label": "file part", "note": "Hängen Sie eine Datei mit Namen, `mimeType` und base64 `bytes` an." }
   ]
 }
 ```

package/corpus/core/docs/content/locales/de-DE/actions.md

@@ -21,7 +21,7 @@ eingebetteter Sidecar oder als vollständiger App-Bildschirm, siehe [Agent Surfa
 
 ```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(), defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><div class=\"diagram-node\">Agent tool<br><small class=\"diagram-muted\">JSON Schema in context</small></div><div class=\"diagram-node\">React hooks<br><small class=\"diagram-muted\">useActionQuery/Mutation</small></div><div class=\"diagram-node\">callAction()<br><small class=\"diagram-muted\">imperative client</small></div><div class=\"diagram-node\">HTTP<br><small class=\"diagram-muted\">/_agent-native/actions/:name</small></div><div class=\"diagram-node\">MCP tool<br><small class=\"diagram-muted\">external hosts</small></div><div class=\"diagram-node\">A2A tool<br><small class=\"diagram-muted\">other agent-native apps</small></div><div class=\"diagram-node\">CLI<br><small class=\"diagram-muted\">pnpm action &lt;name&gt;</small></div></div></div>",
+  "html": "<div class=\"diagram-fanout\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">defineAction()</span><small class=\"diagram-muted\">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}"
 }
 ```
@@ -73,7 +73,7 @@ Führen Sie dann die App-Agent-Schleife für den Ordner aus:
 pnpm agent "Call hello for Steve and explain the result"
 ```
 
-Das ist die gleiche App-Agent-Schleife wie Ihre geplanten Jobs, Chat UI, externer MCP
+Das ist die gleiche App-Agent-Schleife wie Ihre geplanten Jobs, Chat-Oberfläche, externer MCP
 Tools und zukünftige Bildschirme werden verwendet. Chat- und Domänenvorlagen dienen zum Hinzufügen von UI
 um actions, keine erforderliche Voraussetzung für die Aktion selbst.
 
@@ -170,7 +170,7 @@ Für eine `GET`-Aktion wird `leadId` als Abfrageparameter übergeben: `/_agent-n
 - **`http: { method: "GET" | "POST" | "PUT" | "DELETE" }`** – Standard `POST`. `GET` actions werden automatisch als `readOnly` markiert, sodass erfolgreiche Anrufe keine UI-Umfrageaktualisierung auslösen.
 - **`http: { path: "..." }`** – überschreibt den gemounteten URL unter `/_agent-native/actions/`. Standardmäßig wird der Dateiname verwendet. **Pfadüberschreibungen ändern den URL nur für direkte HTTP-Aufrufer** – `useActionQuery`, `useActionMutation` und `callAction` rufen unabhängig von dieser Überschreibung immer `/_agent-native/actions/<name>` auf, sodass das Überschreiben des Pfads diese Hooks zu 404 macht. Verwenden Sie Pfadüberschreibungen nur für externe HTTP-Aufrufer. Beachten Sie auch, dass `:param`-Routensegmente im Override-Pfad **nicht** in `run()`-Argumente geparst werden – nur Abfragezeichenfolgenparameter und JSON-Textfelder.
 - **`http: false`** – Deaktivieren Sie den HTTP-Endpunkt vollständig. Nur Agent + CLI.
-- **`readOnly: true`** – Überspringen Sie die Poll-Aktualisierung explizit, auch für POST actions, die nicht mutieren.
+- **`readOnly: true`** – Überspringen Sie die Polling-Aktualisierung explizit, auch für POST actions, die nicht mutieren.
 - **`parallelSafe: true`** – ermöglicht die gleichzeitige Ausführung einer Mutationsaktion mit anderen Werkzeugaufrufen für die gleiche Drehung. Legen Sie dies nur fest, wenn die Aktion intern nebenläufigkeitssicher und reihenfolgeunabhängig ist. mutierende actions-Serialisierung standardmäßig.
 
 ### Halten Sie die Aktionsfläche klein {#small-surface}
@@ -324,7 +324,7 @@ export default defineAction({
 });
 ```
 
-`needsApproval` akzeptiert auch ein Prädikat `(args, ctx) => boolean | Promise<boolean>` zum bedingten Gaten (z. B. nur externe Empfänger, nur oberhalb eines Schwellenwerts); es **schlägt nicht geschlossen**, sodass ein Wurf als „Genehmigung erforderlich“ gilt. Wenn das Tor wahr und nicht genehmigt ist, stoppt die Schleife die Runde und der Nebeneffekt wird erst ausgelöst, wenn ein Mensch im Chat UI zustimmt.
+`needsApproval` akzeptiert auch ein Prädikat `(args, ctx) => boolean | Promise<boolean>` zum bedingten Gaten (z. B. nur externe Empfänger, nur oberhalb eines Schwellenwerts); es **schlägt nicht geschlossen**, sodass ein Wurf als „Genehmigung erforderlich“ gilt. Wenn das Tor wahr und nicht genehmigt ist, stoppt die Schleife die Runde und der Nebeneffekt wird erst ausgelöst, wenn ein Mensch im Chat-Oberfläche zustimmt.
 
 > [!WARNING]
 > Halten Sie Genehmigungen selten. Jede Gated-Aktion stellt einen harten Stopp in der Agentenschleife dar. Die Standardeinstellung ist **off** und sollte bei fast jeder Aktion ausgeschaltet sein. Siehe [Human-in-the-Loop Approvals](/docs/human-approval) für das Prädikat API, das `approval_required`-Ereignis und den vollständigen Ablauf.
@@ -434,7 +434,7 @@ export default defineAction({
 
 Die integrierten Diskriminanten sind `"data-table"`, `"data-chart"` und
 `"data-insights"`, mit serversicheren Buildern und Schemas in
-`@agent-native/core/data-widgets`. Siehe [Native Chat UI](/docs/native-chat-ui)
+`@agent-native/core/data-widgets`. Siehe [Native Chat-Oberfläche](/docs/native-chat-ui)
 für den vollständigen Ergebnisvertrag und die BYO-Laufzeitanleitung, oder
 [Agent Surfaces](/docs/agent-surfaces) dafür, wie die gleiche Aktion beibehalten werden kann
 kopflos, im Chat rendern oder in einen Vollbildmodus verwandeln.

package/corpus/core/docs/content/locales/de-DE/agent-mentions.md

@@ -5,7 +5,7 @@ description: "Markieren Sie benutzerdefinierte Agenten, verbundene Agenten und D
 
 # Agentenerwähnungen
 
-Geben Sie `@` in den Chat-Composer ein, um benutzerdefinierte Agenten, verbundene Agenten, Dateien und Ressourcen zu erwähnen.
+Geben Sie `@` in den Chat-Verfassenr ein, um benutzerdefinierte Agenten, verbundene Agenten, Dateien und Ressourcen zu erwähnen.
 
 ## Übersicht {#overview}
 
@@ -15,7 +15,7 @@ So orchestrieren Sie Multi-Agent-Workflows von einem einzigen Chat aus. Bitten S
 
 ## Agenten erwähnen {#mentioning-agents}
 
-So erwähnen Sie einen Agenten im Chat Composer:
+So erwähnen Sie einen Agenten im Chat Verfassenr:
 
 1. Geben Sie `@` ein, um das Erwähnungs-Popover zu öffnen
 2. Durchsuchen oder durchsuchen Sie die Liste der verfügbaren Agenten
@@ -31,7 +31,7 @@ In beiden Fällen sieht Ihr Hauptagent die Antwort und kann darauf verweisen ode
 
 ```an-diagram title="Wohin eine @-Erwähnung führt" summary="Der Server unterteilt jede Erwähnung nach Typ: Benutzerdefinierte Agenten werden lokal ausgeführt, verbundene Agenten gehen über A2A – beide Antworten werden in den Kontext des Hauptagenten zurückgeführt."
 {
-  "html": "<div class=\"diagram-mention\"><div class=\"diagram-node\">@-mention<br><small class=\"diagram-muted\">in the composer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">Server resolves</span><small class=\"diagram-muted\">extract refs by type</small></div><div class=\"diagram-col\"><div class=\"row\"><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\">Custom agent<br><small class=\"diagram-muted\">agents/*.md &middot; runs local</small></div></div><div class=\"row\"><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\">Connected agent<br><small class=\"diagram-muted\">A2A peer &middot; remote call</small></div></div></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box diagram-accent\">&lt;agent-response&gt;<br><small class=\"diagram-muted\">injected into main agent</small></div></div>",
+  "html": "<div class=\"diagram-mention\"><div class=\"diagram-node\">@-mention<br><small class=\"diagram-muted\">in the composer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">Server löst auf</span><small class=\"diagram-muted\">extract refs by type</small></div><div class=\"diagram-col\"><div class=\"row\"><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\">Benutzerdefinierter Agent<br><small class=\"diagram-muted\">agents/*.md &middot; runs local</small></div></div><div class=\"row\"><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\">Verbundener Agent<br><small class=\"diagram-muted\">A2A peer &middot; remote call</small></div></div></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box diagram-accent\">&lt;agent-response&gt;<br><small class=\"diagram-muted\">injected into main agent</small></div></div>",
   "css": ".diagram-mention{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-mention .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px}.diagram-mention .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-mention .row{display:flex;align-items:center;gap:8px}.diagram-mention .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -125,7 +125,7 @@ Vorlagen können benutzerdefinierte Erwähnungsanbieter registrieren, um domäne
   "language": "ts",
   "code": "import type { MentionProvider } from \"@agent-native/core/server\";\n\nconst contactsProvider: MentionProvider = {\n  id: \"contacts\",\n  label: \"Contacts\",\n\n  // Search for mentionable items\n  async search(query: string) {\n    const contacts = await db.query.contacts.findMany({\n      where: like(contacts.name, `%${query}%`),\n      limit: 10,\n    });\n    return contacts.map((c) => ({\n      id: c.id,\n      label: c.name,\n      description: c.email,\n      type: \"contact\",\n    }));\n  },\n\n  // Resolve a mention into context for the agent\n  async resolve(id: string) {\n    const contact = await db.query.contacts.findFirst({\n      where: eq(contacts.id, id),\n    });\n    return {\n      type: \"context\",\n      text: `Contact: ${contact.name} (${contact.email})`,\n    };\n  },\n};",
   "annotations": [
-    { "lines": "4-5", "label": "Identity", "note": "`id` namespaces the provider; `label` is the section heading shown in the `@` popover." },
+    { "lines": "4-5", "label": "Identität", "note": "`id` namespaces the provider; `label` is the section heading shown in the `@` popover." },
     { "lines": "8-9", "label": "search", "note": "Runs as the user types after `@`. Return up to a handful of matches as `{ id, label, description, type }`." },
     { "lines": "23-24", "label": "resolve", "note": "Called when the message is sent. Turns a picked id into `{ type: \"context\", text }` that is injected into the agent's context." }
   ]

package/corpus/core/docs/content/locales/de-DE/agent-surfaces.md

@@ -13,13 +13,13 @@ Anwendung.
 Der sinnvolle Weg zur Auswahl besteht nicht zuerst nach dem Protokoll. Wählen Sie die Produktoberfläche
 Sie möchten, dann verwenden Sie das passende Grundelement.
 
-| Oberfläche                      | Verwenden Sie es, wenn                                                                                                                   | Beginnen Sie mit                                                                            |
-| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
-| **Kopfloser Agent**             | Code, Jobs, Skripte, eine andere App oder ein anderer Agent sollten die Arbeit direkt aufrufen.                                          | `agent-native create --headless`, `defineAction`, `agent-native agent`, HTTP, CLI, MCP, A2A |
-| **Rich-Chat auf Agent-Native**  | Sie möchten einen eigenständigen oder eingebetteten Chat, der durch die integrierte Agentenschleife unterstützt wird.                    | [Chat template](/docs/template-chat), `<AgentChatSurface>`, `<AssistantChat>`               |
-| **Rich-Chat auf Ihrem Agenten** | Sie haben den Agent woanders erstellt und möchten den Composer, das Transkript, die Toolkarten und die nativen Widgets von Agent-Native. | `AgentChatRuntime`, `<AssistantChat runtime={runtime}>`                                     |
-| **Eingebetteter Sidecar**       | Sie haben bereits eine SaaS-App und möchten daneben einen Agenten mit Seitenkontext und Hostbefehlen.                                    | `createAgentNativeEmbeddedPlugin()`, `AgentNativeEmbedded`                                  |
-| **Vollständige Bewerbung**      | Menschen und Agenten sollten robuste Bildschirme, Daten, Navigation und Zusammenarbeit gemeinsam nutzen.                                 | Vorlagen, actions, SQL-Status, Kontextbewusstsein                                           |
+| Oberfläche                      | Verwenden Sie es, wenn                                                                                                                     | Beginnen Sie mit                                                                            |
+| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- |
+| **Kopfloser Agent**             | Code, Jobs, Skripte, eine andere App oder ein anderer Agent sollten die Arbeit direkt aufrufen.                                            | `agent-native create --headless`, `defineAction`, `agent-native agent`, HTTP, CLI, MCP, A2A |
+| **Rich-Chat auf Agent-Native**  | Sie möchten einen eigenständigen oder eingebetteten Chat, der durch die integrierte Agentenschleife unterstützt wird.                      | [Chat template](/docs/template-chat), `<AgentChatSurface>`, `<AssistantChat>`               |
+| **Rich-Chat auf Ihrem Agenten** | Sie haben den Agent woanders erstellt und möchten den Verfassenr, das Transkript, die Toolkarten und die nativen Widgets von Agent-Native. | `AgentChatRuntime`, `<AssistantChat runtime={runtime}>`                                     |
+| **Eingebetteter Sidecar**       | Sie haben bereits eine SaaS-App und möchten daneben einen Agenten mit Seitenkontext und Hostbefehlen.                                      | `createAgentNativeEmbeddedPlugin()`, `AgentNativeEmbedded`                                  |
+| **Vollständige Bewerbung**      | Menschen und Agenten sollten robuste Bildschirme, Daten, Navigation und Zusammenarbeit gemeinsam nutzen.                                   | Vorlagen, actions, SQL-Status, Kontextbewusstsein                                           |
 
 Das sind Stufen, keine separaten Produkte. Ein Workflow kann als Headless starten
 Agent mit einer Aktion, erscheint im Chat als Tabelle oder Diagramm und wird später zum
@@ -27,7 +27,7 @@ Vollbild in einer App, ohne den vom Agenten aufgerufenen Vorgang zu ändern.
 
 ```an-diagram title="Das Oberflächenspektrum" summary="Eine Aktionsoberfläche, vier Produktformen – jede fügt eine Benutzeroberfläche hinzu, ohne die Bedienung darunter zu ändern."
 {
-  "html": "<div class=\"diagram-spectrum\"><div class=\"diagram-card\"><strong>Headless</strong><small class=\"diagram-muted\">actions, jobs, scripts, other agents</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Rich chat</strong><small class=\"diagram-muted\">composer, transcript, tool cards</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Embedded sidecar</strong><small class=\"diagram-muted\">agent beside an existing app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">most UI</span><strong>Full application</strong><small class=\"diagram-muted\">durable screens, data, collaboration</small></div></div><div class=\"diagram-base\" data-rough><span class=\"diagram-muted\">same actions · same SQL · same agent loop</span></div>",
+  "html": "<div class=\"diagram-spectrum\"><div class=\"diagram-card\"><strong>Headless</strong><small class=\"diagram-muted\">actions, Jobs, Skripte, andere Agenten</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Rich Chat</strong><small class=\"diagram-muted\">Composer, Transkript, Tool-Karten</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Eingebetteter Sidecar</strong><small class=\"diagram-muted\">agent beside an existing app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">meiste UI</span><strong>Vollständige Anwendung</strong><small class=\"diagram-muted\">dauerhafte Screens, Daten, Zusammenarbeit</small></div></div><div class=\"diagram-base\" data-rough><span class=\"diagram-muted\">gleiche actions · gleiches SQL · gleiche Agentenschleife</span></div>",
   "css": ".diagram-spectrum{display:flex;align-items:stretch;gap:10px;flex-wrap:wrap}.diagram-spectrum .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:150px;flex:1}.diagram-spectrum .diagram-arrow{align-self:center;font-size:22px;line-height:1}.diagram-base{margin-top:12px;padding:10px 14px;text-align:center}"
 }
 ```
@@ -110,11 +110,11 @@ Eine Aktion ist dann aufrufbar als:
 - **UI** – bis `useActionQuery`, `useActionMutation` oder `callAction`
 - **Agent-Tool** – aus der integrierten Chat-Schleife
 
-```an-api title="Calling an action over HTTP"
+```an-api title="Aufrufen einer Aktion über HTTP"
 {
   "method": "POST",
   "path": "/_agent-native/actions/summarize-week",
-  "summary": "Invoke any action by name over HTTP",
+  "summary": "Jede Aktion namentlich über HTTP aufrufen",
   "description": "Every `defineAction` is auto-mounted at `/_agent-native/actions/<name>`. The JSON body is validated against the action's zod schema before `run` executes.",
   "request": {
     "contentType": "application/json",
@@ -268,12 +268,12 @@ export function ProjectChat({ threadId }: { threadId: string }) {
 
 Actions kann explizite native Widget-Ergebnisse zurückgeben, sodass die Chat-Ausgabe nicht einfach ist
 Text. Tabellen, Diagramme und getippte Produktkarten werden als Erstanbieter-React
-Komponenten im Chat, ohne Iframes. Siehe [Native Chat UI](/docs/native-chat-ui).
+Komponenten im Chat, ohne Iframes. Siehe [Native Chat-Oberfläche](/docs/native-chat-ui).
 
 ## Rich-Chat auf Ihrem Agenten {#byo-agent}
 
 Verwenden Sie diesen Pfad, wenn Ihr Agent bereits mit einem anderen Framework erstellt wurde oder
-Laufzeit und Sie möchten Agent-Natives Chat UI darum herum. `AgentChatRuntime` ist der
+Laufzeit und Sie möchten Agent-Natives Chat-Oberfläche darum herum. `AgentChatRuntime` ist der
 Grenze: Ihre Laufzeit streamt normalisierte Ereignisse und Agent-Native rendert die
 Komponist, Transkript, Toolaufrufe, Genehmigungen, native Widgets und App-Layout.
 
@@ -300,7 +300,7 @@ Beanspruchen Sie A2UI-Unterstützung. ACP wird an einer bestimmten Stelle unters
 Kodierungsagent (Gemini CLI, Claude Code, …) über den
 [harness layer](/docs/harness-agents#acp), nicht als Chat-Laufzeit hier.
 
-[Native Chat UI — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes)
+[Native Chat-Oberfläche — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes)
 ist das kanonische Zuhause für die Ereignisformen, die Laufzeithelfer und `chatUI`
 Tool-Ergebnis-Metadaten. Beginnen Sie dort, wenn Sie einen externen Agenten in den Chat einbinden.
 
@@ -347,7 +347,7 @@ export function AppShell({ children }) {
 
 ```an-diagram title="Wie der Sidecar eine Brücke zu einer Host-App herstellt" summary="Das Plugin mountet Agent-Native-Routen serverseitig; Der Sidecar React streamt den Seitenkontext ein und Hostbefehle aus."
 {
-  "html": "<div class=\"diagram-sidecar\"><div class=\"diagram-panel\"><strong>Host app</strong><small class=\"diagram-muted\">your existing SaaS</small><div class=\"diagram-node\">getContext()<br><small class=\"diagram-muted\">route · selection</small></div><div class=\"diagram-node\">onNavigate / onRefresh<br><small class=\"diagram-muted\">host commands</small></div></div><div class=\"diagram-col-arrows\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div></div><div class=\"diagram-panel accent-panel\"><span class=\"diagram-pill accent\">AgentNativeEmbedded</span><small class=\"diagram-muted\">agent + workspace</small><div class=\"diagram-box\" data-rough>Agent-Native routes<br><small class=\"diagram-muted\">mounted by the server plugin</small></div></div></div>",
+  "html": "<div class=\"diagram-sidecar\"><div class=\"diagram-panel\"><strong>Host-App</strong><small class=\"diagram-muted\">Ihr vorhandenes SaaS</small><div class=\"diagram-node\">getContext()<br><small class=\"diagram-muted\">Route · Auswahl</small></div><div class=\"diagram-node\">onNavigate / onRefresh<br><small class=\"diagram-muted\">Host-Befehle</small></div></div><div class=\"diagram-col-arrows\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div></div><div class=\"diagram-panel accent-panel\"><span class=\"diagram-pill accent\">AgentNativeEmbedded</span><small class=\"diagram-muted\">agent + workspace</small><div class=\"diagram-box\" data-rough>Agent-Native-Routen<br><small class=\"diagram-muted\">mounted by the server plugin</small></div></div></div>",
   "css": ".diagram-sidecar{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-sidecar .diagram-panel{display:flex;flex-direction:column;gap:8px;padding:14px 16px;min-width:200px}.diagram-sidecar .diagram-col-arrows{display:flex;flex-direction:column;gap:6px}.diagram-sidecar .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -374,13 +374,13 @@ Sie möchten eine vollständige Produktform.
 
 ## So wählen Sie aus {#how-to-choose}
 
-| Wenn Sie denken...                                                              | Auswählen                    |
-| ------------------------------------------------------------------------------- | ---------------------------- |
-| „Ich brauche nur ein aufrufbares Tool oder einen Workflow.“                     | Kopfloser Agent              |
-| „Ich möchte den Agenten des Frameworks, aber Chat sollte der Haupt-UI sein.“    | Rich-Chat auf Agent-Native   |
-| „Ich habe bereits einen Agenten; dafür brauche ich einen ausgefeilten Chat UI.“ | Rich-Chat über Ihren Agenten |
-| „Ich habe bereits eine SaaS-App. Fügen Sie daneben einen Agenten hinzu.“        | Eingebetteter Sidecar        |
-| „Der Agent und UI sollten sich gemeinsam als Produkt weiterentwickeln.“         | Vollständige Bewerbung       |
+| Wenn Sie denken...                                                                      | Auswählen                    |
+| --------------------------------------------------------------------------------------- | ---------------------------- |
+| „Ich brauche nur ein aufrufbares Tool oder einen Workflow.“                             | Kopfloser Agent              |
+| „Ich möchte den Agenten des Frameworks, aber Chat sollte der Haupt-UI sein.“            | Rich-Chat auf Agent-Native   |
+| „Ich habe bereits einen Agenten; dafür brauche ich einen ausgefeilten Chat-Oberfläche.“ | Rich-Chat über Ihren Agenten |
+| „Ich habe bereits eine SaaS-App. Fügen Sie daneben einen Agenten hinzu.“                | Eingebetteter Sidecar        |
+| „Der Agent und UI sollten sich gemeinsam als Produkt weiterentwickeln.“                 | Vollständige Bewerbung       |
 
 Halten Sie den Vertrag klein: Definieren Sie dauerhafte Operationen als actions, geben Sie explizit zurück
 Widget-Ergebnisse, wenn der Chat umfangreiches UI benötigt, und Vollbildanzeigen nur hinzufügen, wenn Benutzer
@@ -389,7 +389,7 @@ müssen persistente Objekte durchsuchen, vergleichen, konfigurieren oder zusamme
 ## Verwandte Dokumente {#related-docs}
 
 - [Actions](/docs/actions) – Definieren Sie den Headless-Vorgang einmal.
-- [Native Chat UI](/docs/native-chat-ui) – typisierte Aktionsergebnisse im Chat rendern.
+- [Native Chat-Oberfläche](/docs/native-chat-ui) – typisierte Aktionsergebnisse im Chat rendern.
 - [Drop-in Agent](/docs/drop-in-agent) – Chat-, Seitenleisten- oder Bedienfeldoberflächen bereitstellen.
 - [Component API](/docs/components) – React Chat-/Komponistenstücke auf niedrigerer Ebene.
 - [Embedding SDK](/docs/embedding-sdk) – Agent-Native zu einer vorhandenen App hinzufügen.