@agent-native/core 0.77.3 → 0.77.4

package/corpus/core/docs/content/locales/de-DE/what-is-agent-native.md

@@ -26,13 +26,13 @@ Das ist die Erfahrung, für die Agent-Native entwickelt wurde. Hier erfahren Sie
 
 Es gibt einen Fortschritt, den die meisten Teams erklimmen, ähnlich einer Leiter, und die meisten stoppen eine Sprosse zu früh.
 
-### Rung 1 – ein einzelner LLM-Aufruf (das Anti-Muster) {#rung-one}
+### Stufe 1 – ein einzelner LLM-Aufruf (das Anti-Muster) {#rung-one}
 
 Ein Textfeld sendet eine Eingabeaufforderung, die KI gibt eine Zeichenfolge zurück und Sie zeigen sie an. Vielleicht mit einem Spinner. Es gibt keine Möglichkeit für den Benutzer, den Kurs zu korrigieren, keine Möglichkeit für die KI, Maßnahmen zu ergreifen, keine Möglichkeit zu sehen, was passiert ist oder warum.
 
 Das sieht man überall: „KI-Funktionen“, bei denen es sich im Grunde um eine „Zusammenfassen“-Schaltfläche handelt, die an ein SaaS-Produkt geschraubt ist. Sie sehen in Demos beeindruckend aus und zerbrechen, sobald die Realität durcheinander gerät. Das ist kein Produkt; Das ist ein Spielzeug.
 
-### Rung 2 – ein Chat mit Tools {#rung-two}
+### Stufe 2 – ein Chat mit Tools {#rung-two}
 
 Jetzt kann die KI _Dinge erledigen_. Es verfügt über Tools – „E-Mail entwerfen“, „Kontakte suchen“, „Abfrage ausführen“ – und eine Chat-Oberfläche, auf der es direkt vor Ihnen funktioniert und Tool-Aufrufe und Ergebnisse anzeigt, während es ausgeführt wird. So sehen Claude, ChatGPT und Cursor unter der Haube aus.
 
@@ -52,7 +52,7 @@ Das ist Rang 3. Das ist Agent-nativ.
 
 ```an-diagram title="Das Leiterprinzip" summary="Die meisten Teams bleiben bei Stufe 1 oder 2 stehen. Agent-nativ ist Stufe 3 – eine echte App und ein echter Agent über eine gemeinsame Aktionsoberfläche."
 {
-  "html": "<div class=\"diagram-ladder\"><div class=\"diagram-card rung rung-3\"><span class=\"diagram-pill accent\">Rung 3 · agent-native</span><strong>Agent + UI as equal partners</strong><small class=\"diagram-muted\">One action surface. Every agent tool is also a button; every button runs the same logic the agent uses.</small></div><div class=\"diagram-card rung rung-2\"><span class=\"diagram-pill\">Rung 2</span><strong>A chat with tools</strong><small class=\"diagram-muted\">The agent can act — but it is still just a chat window. No dashboards, lists, or shortcuts.</small></div><div class=\"diagram-card rung rung-1\"><span class=\"diagram-pill warn\">Rung 1</span><strong>A single LLM call</strong><small class=\"diagram-muted\">Prompt in, string out. Impressive in a demo; breaks the moment reality gets messy.</small></div></div>",
+  "html": "<div class=\"diagram-ladder\"><div class=\"diagram-card rung rung-3\"><span class=\"diagram-pill accent\">Stufe 3 · agent-native</span><strong>Agent + UI als gleichberechtigte Partner</strong><small class=\"diagram-muted\">One action surface. Every agent tool is also a button; every button runs the same logic the agent uses.</small></div><div class=\"diagram-card rung rung-2\"><span class=\"diagram-pill\">Stufe 2</span><strong>Ein Chat mit Tools</strong><small class=\"diagram-muted\">Der Agent kann handeln, ist aber weiter nur ein Chatfenster. Keine Dashboards, Listen oder Shortcuts.</small></div><div class=\"diagram-card rung rung-1\"><span class=\"diagram-pill warn\">Stufe 1</span><strong>Ein einzelner LLM-Aufruf</strong><small class=\"diagram-muted\">Prompt in, string out. Impressive in a demo; breaks the moment reality gets messy.</small></div></div>",
   "css": ".diagram-ladder{display:flex;flex-direction:column;gap:14px}.diagram-ladder .rung{display:flex;flex-direction:column;gap:6px;padding:16px 18px}.diagram-ladder .rung-2{margin-inline-end:48px}.diagram-ladder .rung-1{margin-inline-end:96px}"
 }
 ```
@@ -91,7 +91,7 @@ Dies ist das bestimmende Prinzip.
 
 ```an-diagram title="Ein System, zwei Wege hinein" summary="Der Agent und die Benutzeroberfläche schreiben in dieselben Aktionen und dieselbe Datenbank. Was der eine tut, der andere sieht es."
 {
-  "html": "<div class=\"diagram-parity\"><div class=\"diagram-col\"><div class=\"diagram-node\">Human<br><small class=\"diagram-muted\">clicks, forms, shortcuts</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">natural language · A2A · Slack</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">SQL-Datenbank</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">UI updates live</div></div>",
+  "html": "<div class=\"diagram-parity\"><div class=\"diagram-col\"><div class=\"diagram-node\">Human<br><small class=\"diagram-muted\">Klicks, Formulare, Shortcuts</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">natürliche Sprache · A2A · Slack</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">SQL-Datenbank</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">UI aktualisiert live</div></div>",
   "css": ".diagram-parity{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-parity .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-parity .diagram-arrow{font-size:22px;line-height:1}.diagram-parity .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -165,9 +165,9 @@ Wenn Sie eine agentennative App erstellen oder erweitern, ist hier das zentrale
   "language": "ts",
   "code": "import { defineAction } from \"@agent-native/core/action\";\nimport { z } from \"zod\";\n\nexport default defineAction({\n  description: \"Reply to an email thread\",\n  schema: z.object({ emailId: z.string(), body: z.string() }),\n  run: async ({ emailId, body }) => {\n    // db and schema come from your app's server/db setup\n    await db.insert(schema.replies).values({ emailId, body });\n  },\n});",
   "annotations": [
-    { "lines": "5", "label": "Tool surface", "note": "The `description` is what the agent reads to decide when to call this as a tool." },
+    { "lines": "5", "label": "Werkzeugoberfläche", "note": "`description` ist das, was der Agent liest, um zu entscheiden, wann er dies als Tool aufrufen soll." },
     { "lines": "6", "label": "Typisierter Vertrag", "note": "Ein zod `schema` validiert Eingaben von **jeder** Oberfläche — Agent, UI, HTTP, MCP und A2A." },
-    { "lines": "7-10", "label": "One implementation", "note": "The `run` body is the single source of truth. The UI button and the agent tool both execute exactly this." }
+    { "lines": "7-10", "label": "Eine Implementierung", "note": "Der `run`-Körper ist die einzige Quelle der Wahrheit. Sowohl die UI-Schaltfläche als auch das Agententool führen genau dies aus." }
   ]
 }
 ```

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

@@ -18,7 +18,7 @@ Workspace-Verbindungen sind das Grundgerüst für wiederverwendbare Integrations
 
 ```an-diagram title="Einmal verbinden, Apps gewähren, Anmeldeinformationen wiederverwenden" summary="Eine Verbindung enthält Anbietermetadaten (niemals Geheimnisse) und CredentialRefs, die auf den Tresor verweisen. Per App-Zuschüsse wird es freigeschaltet. Apps lesen einen einzelnen Bereitschaftsstatus."
 {
-  "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, status, scopes, config &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>",
+  "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, Status, Scopes, Konfiguration &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}"
 }
 ```
@@ -58,32 +58,32 @@ await upsertWorkspaceConnectionGrant({
 });
 ```
 
-```an-schema title="The connection model" summary="A connection records safe provider metadata and credentialRefs (pointers, not secrets). Each grant unlocks one app — one connection, many grants."
+```an-schema title="Das Verbindungsmodell" summary="A connection records safe provider metadata and credentialRefs (pointers, not secrets). Each grant unlocks one app — one connection, many grants."
 {
   "entities": [
     {
       "id": "conn",
       "name": "workspace_connections",
-      "note": "Named provider account. Never stores secret values.",
+      "note": "Benanntes Anbieterkonto. Speichert niemals geheime Werte.",
       "fields": [
         { "name": "id", "type": "string", "pk": true, "note": "e.g. acme-slack" },
-        { "name": "provider", "type": "string", "note": "stable provider id, e.g. slack" },
+        { "name": "provider", "type": "string", "note": "stabile Anbieter-ID, z.B. locker" },
         { "name": "label", "type": "string" },
         { "name": "accountId", "type": "string", "nullable": true },
         { "name": "accountLabel", "type": "string", "nullable": true },
         { "name": "status", "type": "string", "note": "e.g. connected" },
         { "name": "scopes", "type": "string[]", "nullable": true },
-        { "name": "config", "type": "json", "nullable": true, "note": "safe, non-secret config" },
+        { "name": "config", "type": "json", "nullable": true, "note": "sichere, nicht geheime Konfiguration" },
         { "name": "credentialRefs", "type": "json", "nullable": true, "note": "pointers to vault keys, e.g. { key, scope }" }
       ]
     },
     {
       "id": "grant",
       "name": "workspace_connection_grants",
-      "note": "Per-app permission to use a connection.",
+      "note": "Berechtigung pro App, eine Verbindung zu verwenden.",
       "fields": [
         { "name": "connectionId", "type": "string", "fk": "conn.id" },
-        { "name": "appId", "type": "string", "note": "e.g. brain, analytics" }
+        { "name": "appId", "type": "string", "note": "z.B. Gehirn, Analytik" }
       ]
     }
   ],
@@ -208,7 +208,7 @@ Metadaten des Workspace-Verbindungsanbieters antworten: „Welcher Anbieter ist
 
 ```an-diagram title="Verbindungsspeicher vs. Tresor" summary="Der Tresor ist Eigentümer des geheimen Werts. Die Verbindung besitzt Provider-Metadaten sowie CredentialRefs (Zeiger). Zur Ausführungszeit löst die App den Verweis über eine gewährte Verbindung auf und liest den Wert aus dem Tresor."
 {
-  "html": "<div class=\"diagram-vault\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection store</span><div class=\"diagram-box\" data-rough>provider account + metadata<br><small class=\"diagram-muted\">status, scopes, config</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\">App action</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\">never returned to the agent or UI</small></div></div></div>",
+  "html": "<div class=\"diagram-vault\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Verbindungsspeicher</span><div class=\"diagram-box\" data-rough>provider account + metadata<br><small class=\"diagram-muted\">Status, Scopes, Konfiguration</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\">App-Action</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\">nie an Agent oder UI zurückgegeben</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}"
 }
 ```
@@ -220,7 +220,7 @@ Beides zusammen verwenden:
 3. Jede App liest Anbietermetadaten aus dem Katalog und Verbindungs-/Gewährungszusammenfassungen aus dem freigegebenen Speicher.
 4. Die App UI zeigt Bereitschaft an: verbunden, gewährt, aber fehlerhaft, benötigt Genehmigung, fehlende Anmeldeinformationen oder nur Metadaten.
 5. App-spezifisch SQL speichert nur app-spezifische Quell-IDs, Cursor, Filter, Synchronisierungsfenster, Metrikdefinitionen, Überprüfungsregeln und Benutzerauswahlen.
-6. App actions löst Anmeldeinformationen zur Ausführungszeit über gewährte Verbindungsreferenzen und den Tresor auf und gibt niemals geheime Werte zurück.
+6. App-Actions löst Anmeldeinformationen zur Ausführungszeit über gewährte Verbindungsreferenzen und den Tresor auf und gibt niemals geheime Werte zurück.
 
 ### Laufzeit des Anbieterlesers
 

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

@@ -11,7 +11,7 @@ Dieser Leitfaden behandelt die betriebliche Seite der Ausführung eines agentenn
 
 ```an-diagram title="Zwei Governance-Ebenen" summary="Git regelt den Code; Dispatch regelt die Laufzeit. Sie ergänzen sich – wiederholen Sie nicht das eine in dem anderen."
 {
-  "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 und 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>",
   "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 @@ Die CODEOWNERS-Datei von GitHub weist Prüfer automatisch PRs zu, basierend auf
 # Framework core — affects every app; platform team reviews all changes
 packages/core/                     @your-org/platform-team
 
-# Dispatch control plane — secrets, integrations, workspace resources
+# Dispatch Kontrollebene – Geheimnisse, Integrationen, Arbeitsbereichsressourcen
 templates/dispatch/                @your-org/platform-team
 
-# Per-app ownership — each team reviews their own app
+# Besitz pro App – jedes Team überprüft seine eigene 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
+# Konfiguration auf Arbeitsbereichsebene – umfassende Überprüfung, da sie jeden betrifft
 .github/                           @your-org/platform-team
 package.json                       @your-org/platform-team
 pnpm-workspace.yaml                @your-org/platform-team
@@ -132,7 +132,7 @@ Beim Überprüfen von PRs in dieser Umgebung:
 
 Die [Dispatch](/docs/dispatch)-App ist die Laufzeitsteuerungsebene des Arbeitsbereichs. Es ergänzt die Governance auf Git-Ebene durch die Laufzeit-Governance:
 
-| Bedenken                                 | Git / GitHub            | Versand                                                            |
+| Bedenken                                 | Git und GitHub          | Versand                                                            |
 | ---------------------------------------- | ----------------------- | ------------------------------------------------------------------ |
 | Wer kann Code ändern?                    | CODEOWNERS, Zweigschutz | —                                                                  |
 | Wer kann auf Geheimnisse zugreifen?      | —                       | Vault-Richtlinie, Zuschüsse, Antragsworkflow                       |

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

@@ -13,7 +13,7 @@ Der Clou: **Es sind SQL-Zeilen, keine Dateisystemdateien.** Jeder Benutzer erhä
 
 ```an-diagram title="Ein Claude-Code-Arbeitsbereich, aber gespeichert in SQL" summary="Dieselbe Anpassungsebene – Anweisungen, Fähigkeiten, Speicher, Agenten, Jobs, MCP – außer dass jede Datei eine Zeile in einer gemeinsam genutzten, mandantenfähigen Datenbank ist."
 {
-  "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-Datenbank</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-Arbeitsbereich</span><small class=\"diagram-muted\">rows in one SQL-Datenbank</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\">eine Codebasis, viele Nutzer, scoped <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 @@ Diese Pfade gelten für alle drei Bereiche – Arbeitsbereich, Organisation/App
 
 ```an-diagram title="Drei Bereiche, eine effektive Datei" summary="Die Laufzeit löst beim Lesen den gleichen Pfad über Arbeitsbereiche, Apps und persönliche Bereiche hinweg auf – der spezifischste Bereich gewinnt."
 {
-  "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\">unternehmensweite Defaults aus 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\">Organisation / 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>",
   "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}"
 }
 ```
@@ -74,7 +74,7 @@ Diese Pfade gelten für alle drei Bereiche – Arbeitsbereich, Organisation/App
 3. Speichern, zum **Chat** wechseln, alles fragen – der Agent folgt sofort der neuen Regel.
 
 ```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": "Kein Neustart, keine erneute Bereitstellung. `AGENTS.md` wird zu Beginn jeder Runde gelesen, sodass eine von Ihnen gespeicherte Änderung jetzt das Verhalten des Agenten bei der nächsten Nachricht ändert." }
 ```
 
 **Nächste Schritte, wann immer Sie möchten:**
@@ -96,10 +96,10 @@ Der Pfad bestimmt, wie der Agent eine Ressource nutzt (siehe Tabelle in [Overvie
 Ein nützliches Starterpaket für einen neuen Arbeitsbereich:
 
 ```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              # was das Unternehmen macht, ICP, Produkte, Links
+context/brand.md                # Stimme, visuelle Identität, Rechtschreibung, verbotene Verwendung
+context/messaging.md            # Positionierung, Wertvorstellungen, Beweispunkte, Einwände
+instructions/guardrails.md      # Compliance-, Eskalations- und Genehmigungsregeln
 skills/company-voice/SKILL.md   # on-demand guidance for customer-facing writing
 agents/<slug>.md                # reusable custom agent profiles
 ```
@@ -119,7 +119,7 @@ Halten Sie `context/`-Dateien kurz und sachlich – ein paar Punkte, die der Age
 ```text
 <!-- context/brand.md -->
 
-# Brand
+# Marke
 
 - Voice: direct, warm, concrete
 - Use: "workspace", "agent", "team"
@@ -183,18 +183,18 @@ Benutzer können diese Speicherdateien direkt auf der Registerkarte „Arbeitsbe
 
 Jede dieser Oberflächen – `AGENTS.md`, skills, Speicher, benutzerdefinierte Agenten, MCP-Server – hat die gleiche zugrunde liegende Ressourcenform: ein `path` + `scope` + `content`, die auf die gleiche Weise angesprochen und aufgelöst wird.
 
-```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="Das Workspace-Ressourcenmodell" summary="Eine Ressourcenform unterstützt jede Arbeitsbereichsdatei. Die Laufzeit verschlüsselt es nach Pfad und Umfang und löst den effektiven Wert beim Lesen auf."
 {
   "entities": [
     {
       "id": "resource",
       "name": "workspace resource",
-      "note": "A single file in a user's workspace — instructions, skill, memory, agent, MCP config, or job.",
+      "note": "Eine einzelne Datei im Arbeitsbereich eines Benutzers – Anweisungen, Skill, Speicher, Agent, MCP Konfiguration oder Job.",
       "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": "Auf welcher Ebene befindet sich diese Reihe?" },
         { "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 Körper" }
       ]
     }
   ]
@@ -221,12 +221,12 @@ Benutzerdefinierte Agenten verwenden YAML-Frontmatter und Markdown-Anweisungen:
 {
   "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# Rolle\n\nYou are a focused design agent.\n\n## Verantwortlichkeiten\n\n- Layouts und Interaktionsabläufe überprüfen\n- Stärkere visuelle Ausrichtung vorschlagen\n- Prägnant und eigensinnig sein",
   "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` ist das, was im `@`-Dropdown-Menü angezeigt wird und an das der Hauptagent delegiert." },
+    { "lines": "3-4", "label": "Wann delegieren?", "note": "`description` ist das, was der Orchestrator liest, um zu entscheiden, dass dieses Profil zu einer Aufgabe passt." },
+    { "lines": "5", "label": "Modell", "note": "`inherit` verwendet das Modell des Hauptagenten wieder. Überschreiben Sie es nur, wenn das Profil eindeutig ein anderes Modell benötigt." },
+    { "lines": "6", "note": "`tools: inherit` vorerst – das Feld ist für zukünftige Tool-Richtlinien pro Agent reserviert." }
   ]
 }
 ```
@@ -303,21 +303,21 @@ REST Endpunkte automatisch gemountet:
 Der Agent verwendet diese integrierten actions. Sie können sie auch von Ihrem eigenen actions:
 
 ```bash
-# List all resources
+# Listen Sie alle Ressourcen auf
 pnpm action resource-list --scope all
 
-# Read a resource
+# Lesen Sie eine Ressource
 pnpm action resource-read --path "skills/my-skill/SKILL.md"
 
-# Read inherited workspace context managed by Dispatch
+# Liest den von Dispatch verwalteten geerbten Arbeitsbereichskontext
 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..."
+# Schreiben Sie eine Ressource
+pnpm action resource-write --path "notes/meeting.md" --content "# Besprechungsnotizen ...“
 
-# Delete a resource
+# Löschen Sie eine Ressource
 pnpm action resource-delete --path "notes/old.md"
 ```

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

@@ -1,15 +1,15 @@
 ---
-title: "Anweisungen für Schreibagenten & Skills"
+title: "Anweisungen für Schreibagenten & Fähigkeiten"
 description: "So schreiben Sie großartige Agentenanweisungen für eine agentennative App oder Vorlage: AGENTS.md, skills und Toolbeschreibungen."
 ---
 
-# Anweisungen für Schreibagenten & Skills
+# Anweisungen für Schreibagenten & Fähigkeiten
 
 Das Verhalten des Agenten in einer agentennativen App ist nur so gut wie die Anweisungen, die Sie ihm geben. Drei Oberflächen tragen diese Anleitung: `AGENTS.md` (die Karte), skills (die tiefen Tauchgänge) und Aktions-/Werkzeugbeschreibungen (wie der Agent das richtige Werkzeug auswählt). Schreiben Sie jedes einzelne zum schnellen Auffinden, nicht für Prosa.
 
 ```an-diagram title="Drei erstellte Oberflächen + eine Laufzeitoberfläche" summary="AGENTS.md und Werkzeugbeschreibungen werden bei jeder Runde geladen; Kompetenzbelastung bei Bedarf; application_state wird live von Ihrer Benutzeroberfläche geschrieben."
 {
-  "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\">Jeder Turn</span><strong>AGENTS.md</strong><small class=\"diagram-muted\">die Karte: Zweck, Kernregeln, State-Keys, Action- + Skill-Index</small></div><div class=\"diagram-card always\" data-rough><span class=\"diagram-pill accent\">Jeder Turn</span><strong>Tool-Beschreibungen</strong><small class=\"diagram-muted\">steuert Tool-Auswahl — je ein präziser Satz</small></div><div class=\"diagram-card ondemand\" data-rough><span class=\"diagram-pill\">Bei Bedarf</span><strong>Fähigkeiten</strong><small class=\"diagram-muted\">tiefes How-to, geladen wenn die Beschreibung greift</small></div><div class=\"diagram-card runtime\" data-rough><span class=\"diagram-pill ok\">Live</span><strong>application_state</strong><small class=\"diagram-muted\">von deiner UI geschrieben: Navigation, Auswahl, Fokus</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,39 +22,39 @@ Das Verhalten des Agenten in einer agentennativen App ist nur so gut wie die Anw
 - **Kernregeln** – die Handvoll Invarianten, die immer gelten müssen (Daten in SQL, Operationen durchlaufen actions, KI geht durch den Agenten-Chat, Schemaänderungen sind additiv). Kurze, zwingende Aufzählungszeichen.
 - **Anwendungsstatusschlüssel** – die `navigation`/Auswahl-/Fokusschlüssel, die der Agent liest, um anhand ihrer Form zu erfahren, was der Benutzer sieht.
 - **Aktionstabelle** – eine kompakte Tabelle mit Aktionsnamen und Zweck.
-- **Skills-Index** – eine Liste der vorhandenen skills und wann sie jeweils gelesen werden sollen.
+- **Fähigkeiten-Index** – eine Liste der vorhandenen skills und wann sie jeweils gelesen werden sollen.
 
 Wenn ein Abschnitt über einen Bildschirm hinauswächst, gehört er zu einer Fertigkeit. `AGENTS.md` antwortet mit „Was ist diese App und was kann ich tun“, nicht mit „Wie genau mache ich das Schwierige?“.
 
 ```markdown
-# Projects App
+# Projekte-App
 
-One workspace for projects, tasks, and notes. Agent and UI share the same SQL
-data and the same actions.
+Ein Arbeitsbereich für Projekte, Aufgaben und Notizen. Agent und UI teilen dieselben SQL-Daten
+und dieselben actions.
 
-## Core Rules
+## Grundregeln
 
-- Data lives in SQL via Drizzle. Use actions for all writes.
-- All AI work goes through the agent chat; never call an LLM inline.
-- Schema changes are additive only.
+- Daten leben in SQL über Drizzle. Verwenden Sie actions für alle Schreibvorgänge.
+- Alle KI-Arbeit läuft über den Agenten-Chat; rufen Sie niemals ein LLM inline auf.
+- Schemaänderungen sind nur additiv.
 
-## Application State
+## Anwendungsstatus
 
 - `navigation.view`: `home` | `project`
-- `navigation.projectId`: selected project on a project page
+- `navigation.projectId`: ausgewähltes Projekt auf einer Projektseite
 
-## Actions
+## Aktionen
 
-| Action           | Purpose                     |
-| ---------------- | --------------------------- |
-| `list-projects`  | List accessible projects    |
-| `create-project` | Create a project            |
-| `update-project` | Rename or archive a project |
+| Action           | Zweck                                   |
+| ---------------- | --------------------------------------- |
+| `list-projects`  | Zugängliche Projekte auflisten          |
+| `create-project` | Ein Projekt erstellen                   |
+| `update-project` | Ein Projekt umbenennen oder archivieren |
 
-## Skills
+## Fähigkeiten
 
-- `project-imports` — read before importing legacy CSV exports.
-- `sharing` — read before exposing a project to other users.
+- `project-imports` — vor dem Import alter CSV-Exporte lesen.
+- `sharing` — vor dem Freigeben eines Projekts für andere Benutzer lesen.
 ```
 
 ## Einzelquelle AGENTS.md {#single-source}
@@ -84,12 +84,12 @@ Schreiben Sie `SKILL.md` als die schlanke, unverzichtbare Ebene: die Regel, die
 
 ```text
 .agents/skills/project-imports/
-├── SKILL.md            # rule + happy path + do/don't
+├── SKILL.md            # Regel + glücklicher Weg + do/don't
 └── references/
-    └── csv-format.md   # full column spec, encodings, edge cases
+    └── csv-format.md   # Vollständige Spaltenspezifikation, Kodierungen, Randfälle
 ```
 
-Dadurch bleibt die stets geladene Oberfläche klein und die Tiefe lässt sich skalieren, ohne den Kontext aufzublähen. Das vollständige Skill-Format finden Sie im [Skills Guide](/docs/skills-guide).
+Dadurch bleibt die stets geladene Oberfläche klein und die Tiefe lässt sich skalieren, ohne den Kontext aufzublähen. Das vollständige Skill-Format finden Sie im [Fähigkeiten Guide](/docs/skills-guide).
 
 ## Aktionsorientierte Tabellen schreiben {#action-tables}
 
@@ -114,9 +114,9 @@ defineAction({
 });
 ```
 
-## Skills vs. actions {#skills-vs-actions}
+## Fähigkeiten vs. actions {#skills-vs-actions}
 
-Skills und actions ergänzen sich. Eine Fertigkeit ist eine Anleitung, die der Agent liest; ein
+Fähigkeiten und actions ergänzen sich. Eine Fertigkeit ist eine Anleitung, die der Agent liest; ein
 Aktion ist Code, den der Agent ausführen kann.
 
 | Bedarf                                                                                         | Verwenden                                  |
@@ -151,7 +151,7 @@ Jede Anleitung, die Sie verfassen, landet auf einer von vier Oberflächen. Wenn
 | Oberfläche                    | Wer schreibt es            | Wenn es geladen ist                                                      | Was dorthin gehört                                                       |
 | ----------------------------- | -------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
 | `AGENTS.md`-Anweisungen       | Sie (Entwickler)           | Jede Runde als Orientierung                                              | Zweck, Kernregeln, Statusschlüssel, Aktionsindex, skills-Index           |
-| Skills (`SKILL.md`)           | Sie (Entwickler)           | Auf Anfrage, wenn der Agent entscheidet, dass die Fähigkeit relevant ist | Schritt-für-Schritt-Anleitung für ein bestimmtes Muster, Do/Don't-Listen |
+| Fähigkeiten (`SKILL.md`)      | Sie (Entwickler)           | Auf Anfrage, wenn der Agent entscheidet, dass die Fähigkeit relevant ist | Schritt-für-Schritt-Anleitung für ein bestimmtes Muster, Do/Don't-Listen |
 | Aktionsbeschreibungen (Tools) | Sie (Entwickler)           | Jede Runde, wie die Werkzeugliste                                        | Was die Aktion bewirkt, was sie zurückgibt, Parametersemantik            |
 | `application_state`-Kontext   | Ihr UI-Code (zur Laufzeit) | Jede Runde, als Live-App-Status                                          | Aktuelle Navigation, Auswahl, fokussiertes Objekt, URL                   |
 
@@ -163,11 +163,11 @@ Jede Anleitung, die Sie verfassen, landet auf einer von vier Oberflächen. Wenn
 ## Was gehört wohin {#what-goes-where}
 
 - **AGENTS.md** – gilt für die gesamte App, in jeder Runde: Zweck, Kernregeln, Statusschlüssel, Aktionsindex, skills-Index.
-- **Skills** – wiederverwendbare Anleitung für ein bestimmtes Muster, die bei Bedarf geladen wird. Gilt für alle, die in der App arbeiten.
+- **Fähigkeiten** – wiederverwendbare Anleitung für ein bestimmtes Muster, die bei Bedarf geladen wird. Gilt für alle, die in der App arbeiten.
 - **Speicher (`memory/MEMORY.md`)** – Präferenzen und Korrekturen pro Benutzer, keine verfasste Anleitung.
 
 ## Was kommt als nächstes? {#whats-next}
 
-- [Skills Guide](/docs/skills-guide) – das Skill-Dateiformat, das Framework skills und das App-gestützte skills.
+- [Fähigkeiten Guide](/docs/skills-guide) – das Skill-Dateiformat, das Framework skills und das App-gestützte skills.
 - [Creating Templates](/docs/creating-templates) – wie `AGENTS.md` und skills in eine versandfähige Vorlage passen.
 - [The four-area checklist](/docs/key-concepts#four-area-checklist) – das Vier-Bereichs-Modell, das jedes Merkmal erfüllen muss.

package/corpus/core/docs/content/locales/es-ES/a2a-protocol.md

@@ -22,7 +22,7 @@ Conceptos clave:
 
 ```an-diagram title="Un agente le entrega el trabajo a otro" summary="Un agente de correo descubre la tarjeta del agente de análisis, envía un mensaje JSON-RPC y recupera una tarea completada."
 {
-  "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>Agente de Mail</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\">tarea · completada</div></div><div class=\"diagram-card\" data-rough><strong>Agente de Analytics</strong><small class=\"diagram-muted\">ejecuta run-query y devuelve el resultado</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 @@ Todos los métodos se llaman a través de `POST /_agent-native/a2a` con formato
 | `tasks/get`      | Obtener una tarea por ID: se utiliza para sondear una tarea asincrónica hasta su finalización                                                     | `id`                          |
 | `tasks/cancel`   | Cancelar una tarea en ejecución                                                                                                                   | `id`                          |
 
-```an-api title="Primary A2A endpoint" summary="All JSON-RPC methods are POSTed here. message/send shown."
+```an-api title="Endpoint A2A principal" summary="Todos los métodos JSON-RPC son POSTed aquí. Se muestra message/send."
 {
   "method": "POST",
   "path": "/_agent-native/a2a",
-  "summary": "Send a message and wait for the completed task",
+  "summary": "Envía un mensaje y espera a que se complete la tarea.",
   "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 @@ Cuando se llama a `message/send` con `async: true`, el controlador JSON-RPC pone
 
 ```an-diagram title="Ciclo de vida de tareas asíncronas sin servidor" summary="async:true vuelve a funcionar en milisegundos, luego una nueva ejecución ejecuta el bucle del agente mientras la persona que llama sondea."
 {
-  "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\">~milisegundos</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>POST autoactivado /_agent-native/a2a/_process-task<br><small class=\"diagram-muted\">token HMAC · ejecución nueva · timeout completo</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 @@ Los mensajes contienen partes escritas: texto, datos estructurados y archivos pu
   "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": "Instrucciones sencillas en lenguaje natural que el agente lee." },
+    { "lines": "5", "label": "data part", "note": "Argumentos JSON estructurados, por ejemplo un rango de fechas, pasados junto con el prompt." },
+    { "lines": "6-9", "label": "file part", "note": "Adjunte un archivo por nombre, `mimeType` y base64 `bytes`." }
   ]
 }
 ```

package/corpus/core/docs/content/locales/es-ES/actions.md

@@ -21,7 +21,7 @@ sidecar integrado o como pantalla de aplicación completa, consulte [Agent Surfa
 
 ```an-diagram title="Una definición, siete consumidores" summary="Un único defineAction() se distribuye en todas las superficies (agente, UI, HTTP, MCP, A2A y CLI) con un esquema validado y un cuerpo run()."
 {
-  "html": "<div class=\"diagram-fanout\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">defineAction()</span><small class=\"diagram-muted\">schema + run(), defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><div class=\"diagram-node\">Agent tool<br><small class=\"diagram-muted\">JSON Schema in context</small></div><div class=\"diagram-node\">React hooks<br><small class=\"diagram-muted\">useActionQuery/Mutation</small></div><div class=\"diagram-node\">callAction()<br><small class=\"diagram-muted\">imperative client</small></div><div class=\"diagram-node\">HTTP<br><small class=\"diagram-muted\">/_agent-native/actions/:name</small></div><div class=\"diagram-node\">MCP tool<br><small class=\"diagram-muted\">external hosts</small></div><div class=\"diagram-node\">A2A tool<br><small class=\"diagram-muted\">other agent-native apps</small></div><div class=\"diagram-node\">CLI<br><small class=\"diagram-muted\">pnpm action &lt;name&gt;</small></div></div></div>",
+  "html": "<div class=\"diagram-fanout\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">defineAction()</span><small class=\"diagram-muted\">schema + run(), definido una vez</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><div class=\"diagram-node\">Herramienta del agente<br><small class=\"diagram-muted\">JSON Schema en contexto</small></div><div class=\"diagram-node\">Hooks de React<br><small class=\"diagram-muted\">useActionQuery/Mutation</small></div><div class=\"diagram-node\">callAction()<br><small class=\"diagram-muted\">cliente imperativo</small></div><div class=\"diagram-node\">HTTP<br><small class=\"diagram-muted\">/_agent-native/actions/:name</small></div><div class=\"diagram-node\">Herramienta MCP<br><small class=\"diagram-muted\">hosts externos</small></div><div class=\"diagram-node\">Herramienta A2A<br><small class=\"diagram-muted\">otras apps agent-native</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}"
 }
 ```
@@ -434,7 +434,7 @@ export default defineAction({
 
 Los discriminantes integrados son `"data-table"`, `"data-chart"` y
 `"data-insights"`, con esquemas y constructores seguros para el servidor en
-`@agent-native/core/data-widgets`. Ver [Native Chat UI](/docs/native-chat-ui)
+`@agent-native/core/data-widgets`. Ver [Native Interfaz de chat](/docs/native-chat-ui)
 para obtener el contrato de resultados completo y la guía de tiempo de ejecución BYO, o
 [Agent Surfaces](/docs/agent-surfaces) sobre cómo puede permanecer la misma acción
 Sin cabeza, renderizado en el chat o ampliado a pantalla completa.

package/corpus/core/docs/content/locales/es-ES/agent-mentions.md

@@ -31,7 +31,7 @@ En ambos casos, su agente principal ve la respuesta y puede hacer referencia a e
 
 ```an-diagram title="Donde se dirige una mención @" summary="El servidor divide cada mención por tipo: los agentes personalizados se ejecutan localmente, los agentes conectados pasan por A2A; ambas respuestas se pliegan al contexto del agente principal."
 {
-  "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\">El servidor resuelve</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\">Agente personalizado<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\">Agente conectado<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}"
 }
 ```
@@ -123,9 +123,9 @@ Las plantillas pueden registrar proveedores de menciones personalizados para agr
 {
   "filename": "server/mentions/contacts.ts",
   "language": "ts",
-  "code": "import type { MentionProvider } from \"@agent-native/core/server\";\n\nconst contactsProvider: MentionProvider = {\n  id: \"contacts\",\n  label: \"Contacts\",\n\n  // Search for mentionable items\n  async search(query: string) {\n    const contacts = await db.query.contacts.findMany({\n      where: like(contacts.name, `%${query}%`),\n      limit: 10,\n    });\n    return contacts.map((c) => ({\n      id: c.id,\n      label: c.name,\n      description: c.email,\n      type: \"contact\",\n    }));\n  },\n\n  // Resolve a mention into context for the agent\n  async resolve(id: string) {\n    const contact = await db.query.contacts.findFirst({\n      where: eq(contacts.id, id),\n    });\n    return {\n      type: \"context\",\n      text: `Contact: ${contact.name} (${contact.email})`,\n    };\n  },\n};",
+  "code": "import type { MentionProvider } from \"@agent-native/core/server\";\n\nconst contactsProvider: MentionProvider = {\n  id: \"contacts\",\n  label: \"Contacts\",\n\n  // Buscar 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": "Identidad", "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." }
   ]