@agent-native/core 0.92.12 → 0.94.0

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

@@ -425,10 +425,9 @@ const brainCatalog = await listWorkspaceConnectionProviderCatalogForApp({
 
 ### إعداد طائرة التحكم في الإرسال
 
-يكشف Dispatch عن مستوى التحكم actions الذي يكتب نفس وظائف المتجر المشتركة التي يمكن للتطبيق الاتصال بها مباشرة:
+يكشف Dispatch عن إجراءات مستوى التحكم التي تكتب عبر وظائف المتجر المشتركة نفسها التي يمكن للتطبيق استدعاؤها مباشرة — إذ يتحقق إجراء `upsert-workspace-connection` من صحة الإدخال مقابل كتالوج الموفّرين، ثم يفوّض إلى `upsertWorkspaceConnection()` نفسها الموضحة في هذه الصفحة:
 
 ```ts
-// templates/dispatch/actions/upsert-workspace-connection.ts delegates to this.
 await upsertWorkspaceConnection({
   id: "team-slack",
   provider: "slack",
@@ -493,3 +492,11 @@ await upsertWorkspaceConnectionGrant({
 حافظ على الحدود صارمة: عرض بيانات تعريف الموفر آمن؛ تبقى قيم بيانات الاعتماد في المخزن.
 
 </details>
+
+## ما التالي {#whats-next}
+
+- [**Dispatch**](/docs/dispatch) — التطبيق الذي يدير عادةً إعداد اتصالات مساحة العمل والمخزن
+- [**الأمان**](/docs/security) — مخزن بيانات الاعتماد ونطاق الأسرار ونموذج الوصول الذي تشير إليه الاتصالات
+- [**التهيئة**](/docs/onboarding#checking-workspace-connections-in-onboarding) — التحقق من جاهزية الاتصال من قائمة إعداد القالب
+- [**عملاء MCP**](/docs/mcp-clients) — مشاركة بيانات اعتماد خادم MCP عبر مساحة العمل كنمط إعداد قابل لإعادة الاستخدام
+- [**Brain**](/docs/template-brain) — التطبيق المرجعي لصفحة مصادر الموفّرين المبنية على هذا النموذج

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

@@ -5,7 +5,11 @@ description: "تخصيص Claude على مستوى التعليمات البرم
 
 # مساحة العمل
 
-> **ما هو مستند مساحة العمل؟** تغطي هذه الصفحة **طبقة التخصيص** — ما هي مساحة العمل. للحصول على شكل النشر (مونوريبو واحد، العديد من التطبيقات) راجع [Multi-App Workspaces](/docs/multi-app-workspace)؛ بالنسبة للحوكمة (من يراجع ويوافق ويمتلك ماذا) راجع [Workspace Governance](/docs/workspace-management).
+<Callout tone="info">
+
+**ما هو مستند مساحة العمل؟** تغطي هذه الصفحة **طبقة التخصيص** — ما هي مساحة العمل. للحصول على شكل النشر (مونوريبو واحد، العديد من التطبيقات) راجع [Multi-App Workspaces](/docs/multi-app-workspace)؛ بالنسبة للحوكمة (من يراجع ويوافق ويمتلك ماذا) راجع [Workspace Governance](/docs/workspace-management).
+
+</Callout>
 
 يأتي كل تطبيق وكيل أصلي مزودًا بـ **مساحة عمل**: طبقة التخصيص التي تجعل الوكيل ملكًا لك. فهو يحتوي على تعليمات الفريق (`AGENTS.md`)، والتعلم المشترك (`LEARNINGS.md`)، والذاكرة المنظمة الشخصية (`memory/MEMORY.md`)، وskills الذي يسحبه الوكيل عند الطلب، والوكلاء الفرعيين المخصصين، والمهام المجدولة، وخوادم MCP المتصلة — كل ما تتوقعه من إعداد Claude Code / Codex.
 
@@ -82,7 +86,7 @@ description: "تخصيص Claude على مستوى التعليمات البرم
 | `CLAUDE.md` / skills لكل مشروع         | `AGENTS.md` لكل تطبيق + موارد ذاكرة مساحة العمل  |
 | تكوين MCP في ملف JSON                  | تكوين MCP في JSON _أو_ الإعدادات UI، لكل نطاق    |
 
-نفس الإمكانيات. اقتصاد مختلف. راجع [Templates](/docs/cloneable-saas) لمعرفة سبب أهمية ذلك بالنسبة إلى SaaS.
+نفس الإمكانيات. اقتصاد مختلف. راجع [التطبيقات](/docs/cloneable-saas) لمعرفة سبب أهمية ذلك بالنسبة إلى SaaS.
 
 ## نظرة عامة {#overview}
 
@@ -220,11 +224,9 @@ workspace context/brand.md
 -> personal context/brand.md
 ```
 
-اجعل ملفات `context/` قصيرة وواقعية — بضع نقاط يمكن للوكيل قراءتها:
-
-```text
-<!-- context/brand.md -->
+على سبيل المثال:
 
+```text filename="context/brand.md"
 # العلامة التجارية
 
 - Voice: direct, warm, concrete
@@ -389,15 +391,9 @@ Skills هي ملفات موارد Markdown ضمن مسار `skills/` (يفضل `
 
 استخدم الوكلاء المخصصين للتفويض داخل تطبيق واحد. استخدم الوكلاء المتصلين عندما تحتاج إلى الاتصال بتطبيق آخر عبر A2A.
 
-## @ وضع العلامات {#at-tagging}
-
-اكتب `@` في مدخلات الدردشة للإشارة إلى عناصر مساحة العمل. تظهر قائمة منسدلة عند المؤشر تعرض الوكلاء والملفات المطابقة. استخدم مفاتيح الأسهم للتنقل وEnter للاختيار. يظهر العنصر المحدد كشريحة مضمنة في الإدخال.
-
-عندما ترسل رسالة، يتم تمرير **الملفات/الموارد** كمراجع يمكن للوكيل قراءتها، ويعمل **الوكلاء المخصصون** محليًا باستخدام تعليمات ملفاتهم الشخصية، ويتم استدعاء **الوكلاء المتصلين** عبر A2A.
+## الإشارة بـ @ وأوامر / {#at-tagging}
 
-## / أوامر الشرطة المائلة {#slash-commands}
-
-اكتب `/` في بداية السطر لاستدعاء إحدى المهارات. تعرض القائمة المنسدلة skills المتاحة بأسمائها وأوصافها؛ يؤدي تحديد واحدة إلى إضافة شريحة مضمنة ويتضمن محتواها كسياق عند إرسال الرسالة. إذا لم يتم تكوين skills، فإن القائمة المنسدلة ترتبط بهذه المستندات.
+اكتب `@` في إدخال الدردشة للإشارة إلى وكيل أو ملف أو مورد، أو `/` لاستدعاء مهارة — يفتح كلاهما قائمة منسدلة عند المؤشر ويضيف شريحة مضمنة عند تحديد عنصر. راجع [إشارات الوكيل](/docs/agent-mentions) للآليات الكاملة (التوجيه و`MentionProvider` واختيار الوكيل الفرعي)، و[دليل المهارات](/docs/skills-guide) لمعرفة كيفية تأليف المهارات واكتشافها.
 
 ## وضع الكود مقابل وضع التطبيق {#dev-vs-prod}
 
@@ -417,10 +413,6 @@ Skills هي ملفات موارد Markdown ضمن مسار `skills/` (يفضل `
 
 راجع [Workspace Connections](/docs/workspace-connections) للتعرف على أمثلة التشغيل السريع والاتصال/المنح/بيانات الاعتماد API، وأمثلة Slack وHubSpot وGitHub الملموسة.
 
----
-
-# المرجع
-
 ## المورد API {#resource-api}
 
 يمكن إدارة الموارد من كود الخادم، actions، أو REST API.
@@ -464,3 +456,12 @@ pnpm action resource-write --path "notes/meeting.md" --content "# ملاحظات
 # حذف مورد
 pnpm action resource-delete --path "notes/old.md"
 ```
+
+## الخطوة التالية {#whats-next}
+
+- [**دليل المهارات**](/docs/skills-guide) — تأليف ملفات المهارات المشار إليها من `skills/` وتحديد نطاقها
+- [**إشارات الوكيل**](/docs/agent-mentions) — الآليات الكاملة لإشارات `@` وأوامر `/`
+- [**المهام المتكررة**](/docs/recurring-jobs) — جدولة المطالبات المنشأة من المهام المجدولة
+- [**حوكمة مساحة العمل**](/docs/workspace-management) — من يراجع تغييرات مساحة العمل ويوافق عليها ويمتلكها
+- [**مساحات العمل متعددة التطبيقات**](/docs/multi-app-workspace) — شكل النشر الذي تمتد إليه مساحة عمل واحدة
+- [**اتصالات مساحة العمل**](/docs/workspace-connections) — مشاركة بيانات اعتماد المزوّدين بين التطبيقات

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

@@ -11,7 +11,7 @@ Actions sind die einzige Quelle der Wahrheit für alles, was Ihre App tut. Defin
 - **Typsichere React-Hooks** – `useActionQuery("name")` und `useActionMutation("name")` im Frontend, Typen aus dem Schema abgeleitet.
 - **Imperative Client-Aufrufe** – `callAction("name", params)`, wenn ein Hook nicht passt.
 - **Framework-Transport** – wird automatisch vom Framework hinter diesen Hooks bereitgestellt und ist für externe HTTP-Clients verfügbar.
-- **Ein MCP-Tool** – verfügbar für benutzerdefinierte MCP-Apps von Claude, ChatGPT, Claude Desktop/Code, Cursor, Codex und alle anderen MCP-Clients.
+- **Ein MCP-Tool** – verfügbar für benutzerdefinierte MCP-Apps von Claude, ChatGPT, Claude Desktop/Code, Cursor, Codex und alle anderen MCP-Hosts.
 - **Ein A2A-Tool** – wird von anderen agentennativen Apps über A2A aufgerufen.
 - **Ein CLI-Befehl** – `pnpm action <name>` für Skripterstellung und Entwicklungsschleifen.
 
@@ -562,7 +562,7 @@ export default defineAction({
 });
 ```
 
-Behalten Sie `link` als Fallback für CLI- und Nicht-UI-MCP-Clients bei; Es ist auch das Startziel der Einbettung. Die Embed Bridge – die signierte Embed-Start-Sitzung, Transplantation vs. Controlled-Frame-Rendering, die `ui/*` Host Bridge, CSP und Height Clamping – ist Eigentum von [External Agents](/docs/external-agents#mcp-app-bridge).
+Behalten Sie `link` als Fallback für CLI- und Nicht-UI-MCP-Hosts bei; Es ist auch das Startziel der Einbettung. Die Embed Bridge – die signierte Embed-Start-Sitzung, Transplantation vs. Controlled-Frame-Rendering, die `ui/*` Host Bridge, CSP und Height Clamping – ist Eigentum von [External Agents](/docs/external-agents#mcp-app-bridge).
 
 ## Standard actions {#standard-actions}
 

package/docs/content/locales/de-DE/agent-native-toolkit.mdx

@@ -97,9 +97,9 @@ coherent kit instead of exposing package boundaries in the app.
 
 - [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
   `@agent-native/toolkit/ui/*`.
-- [App Adapters](/docs/toolkit-app-adapters) show how apps wrap Toolkit pieces
+- [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
   through local `@/components/*` adapters.
-- [Shell & Hooks](/docs/toolkit-shell-hooks) cover header actions, mobile hooks,
+- [Shell & Hooks](/docs/toolkit-ui#shell-hooks) cover header actions, mobile hooks,
   toasts, and small app-shell helpers.
 - [Component API](/docs/components) remains the lower-level reference for the
   public React exports.

package/docs/content/locales/de-DE/agent-surfaces.mdx

@@ -141,8 +141,7 @@ pnpm install
 
 Definieren Sie dann den dauerhaften Betrieb:
 
-```ts
-// actions/summarize-week.ts
+```ts filename="actions/summarize-week.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -496,12 +495,11 @@ Halten Sie den Vertrag klein: Definieren Sie dauerhafte Operationen als actions,
 Widget-Ergebnisse, wenn der Chat umfangreiches UI benötigt, und Vollbildanzeigen nur hinzufügen, wenn Benutzer
 müssen persistente Objekte durchsuchen, vergleichen, konfigurieren oder zusammenarbeiten.
 
-## Verwandte Dokumente {#related-docs}
+## Wie geht es weiter? {#related-docs}
 
-- [Actions](/docs/actions) – Definieren Sie den Headless-Vorgang einmal.
-- [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.
-- [External Agents](/docs/external-agents) – MCP-kompatible Hosts mit einer App verbinden.
-- [A2A Protocol](/docs/a2a-protocol) – Agenten von anderen Agenten anrufen.
+- [**Actions**](/docs/actions) – Definieren Sie den Vorgang einmal; jede Oberfläche oben ruft denselben auf
+- [**Native Chat-Oberfläche**](/docs/native-chat-ui) – Typisierte Aktionsergebnisse als Tabellen, Diagramme und Karten im Chat rendern
+- [**Generative UI**](/docs/generative-ui) – Temporäre oder persistierte Sandbox-UI direkt im Chat generieren
+- [**Automation-First Apps**](/docs/pure-agent-apps) – Das vollständige browserlose Muster für Jobs, Warteschlangen, Skripte und externe Agenten
+- [**External Agents**](/docs/external-agents) – MCP-kompatible Hosts mit einer App verbinden
+- [**A2A Protocol**](/docs/a2a-protocol) – Agenten aus anderen Agent-Native-Apps aufrufen

package/docs/content/locales/de-DE/agent-teams.mdx

@@ -239,6 +239,7 @@ interface AgentTask {
   summary: string; // full summary once completed
   currentStep: string; // latest step label (updated while running)
   createdAt: number;
+  delegationDepth?: number; // 1 for a direct sub-agent, 2 for a sub-agent of that sub-agent, etc.
   // Additional fields: parentThreadId, name, updatedAt, startedAt,
   // completedAt, runId, error
 }

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

@@ -15,7 +15,7 @@ Auth wird automatisch über `autoMountAuth(app)` im Authentifizierungsserver-Plu
 - **Remote MCP OAuth:** Standard OAuth 2.1 für MCP-Hosts wie Claude-Code und ChatGPT-Anschlüsse.
 - **Benutzerdefiniert:** Bringen Sie Ihre eigene Authentifizierung über den `getSession`-Rückruf mit.
 
-<Diagram id="doc-block-1hpxy2j" title="Drei Wege rein, eine Sitzung" summary={"Browserbesucher, programmatische MCP-Clients und benutzerdefinierte Anbieter werden alle in dieselbe AuthSession aufgelöst, die das Downstream-Scoping liest."}>
+<Diagram id="doc-block-1hpxy2j" title="Drei Wege rein, eine Sitzung" summary={"Browserbesucher, MCP-Hosts und benutzerdefinierte Anbieter werden alle in dieselbe AuthSession aufgelöst, die das Downstream-Scoping liest."}>
 
 ```html
 <div class="auth-modes">

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

@@ -476,10 +476,12 @@ Aktion, damit UI und Agent die gleiche Funktion nutzen.
 ```ts
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
+import { z } from "zod";
 
 export default defineAction({
   description: "Classify a short message",
-  run: async ({ body }: { body: string }) => {
+  schema: z.object({ body: z.string() }),
+  run: async ({ body }) => {
     const result = await completeText({
       systemPrompt: "Return exactly one label.",
       input: body,
@@ -494,3 +496,11 @@ export default defineAction({
 Verwenden Sie stattdessen `sendToAgentChat({ background: true, openSidebar: false })`, wenn
 Die Arbeit erfordert Tools, Status, Überprüfbarkeit, Benutzersteuerung oder mehrere Schritte
 Begründung.
+
+## Wie geht es weiter {#whats-next}
+
+- [**Drop-in Agent**](/docs/drop-in-agent) — `<AgentSidebar>` und `<AgentPanel>` mit einer tutorialorientierten Einführung einbinden
+- [**Native Chat UI**](/docs/native-chat-ui) — der Action-Ergebnisvertrag hinter Daten-Widgets und benutzerdefinierten Renderern
+- [**Actions**](/docs/actions) — `defineAction()`, Schemas und die von diesen Komponenten aufgerufene Action-Oberfläche
+- [**Real-Time Collaboration**](/docs/real-time-collaboration) — Kollaborations-Hooks und Anwesenheitskomponenten im Detail
+- [**Sharing**](/docs/sharing) — Verdrahtung von `<ShareButton>` und `<ShareDialog>` für besitzbare Ressourcen

package/docs/content/locales/de-DE/creating-templates.mdx

@@ -44,7 +44,6 @@ Jede Vorlage folgt dem gleichen allgemeinen Layout:
 <FileTree
   id="doc-block-153a4yn"
   title="Projektstruktur des Templates"
-  title="my-template/"
   entries={[
     {
       path: "app/",
@@ -172,8 +171,7 @@ Die vier Bereiche jeder Vorlage sind über eine gemeinsame Aktionsoberfläche un
 
 Definieren Sie Domänentabellen mit den Framework-Drizzle-Helfern, damit Schemata über SQLite, Postgres, D1, Turso, Supabase, Neon und andere unterstützte Backends hinweg portierbar bleiben:
 
-```ts
-// server/db/schema.ts
+```ts filename="server/db/schema.ts"
 import {
   table,
   text,
@@ -204,8 +202,7 @@ Schemaänderungen müssen additiv sein. Fügen Sie Tabellen und Spalten über `r
 
 Für App-Lese- und Schreibvorgänge verwenden Sie den Abfrage-Builder von Drizzle und die portablen Operatoren von `drizzle-orm`. Schreiben Sie keinen Produktcode mit rohem SQL, wenn Drizzle die Abfrage ausdrücken kann, und importieren Sie nicht aus `drizzle-orm/sqlite-core` oder `drizzle-orm/pg-core` in Vorlagen.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -349,8 +346,7 @@ Bevorzugen Sie für die App-Navigation einen `navigate`-Befehl, der einen gleich
 `path`, wenn URL bekannt ist. Schreiben Sie nicht auch `__set_url__` für denselben Zug;
 Dieser Schlüssel ist für die Framework-URL-Tools und nur URL-Filteränderungen reserviert.
 
-```ts
-// actions/navigate.ts
+```ts filename="actions/navigate.ts"
 import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { z } from "zod";

package/docs/content/locales/de-DE/cross-app-sso.mdx

@@ -9,7 +9,11 @@ Jede gehostete App bei `*.agent-native.com` führt ihre eigene Bereitstellung mi
 
 Dies ist das gleiche Vertrauensprimitiv, das [A2A](/docs/a2a-protocol) und [External Agents](/docs/external-agents) bereits verwenden – ein `A2A_SECRET`-signiertes JWT, das an der Anforderungsgrenze überprüft wird – angewendet auf den menschlichen Anmeldepfad anstelle von Agent-zu-Agent-Aufrufen.
 
-> **Einheitliche Bereitstellung vs. Bereitstellung pro Domäne.** Wenn Sie alle Apps an einem Ursprung hosten (`your-agents.com/mail`, `your-agents.com/calendar`), erhalten Sie bereits eine gemeinsame Anmeldung über eine einzige Cookie-Domäne – kein Verbund erforderlich. Cross-App SSO ist nur erforderlich, wenn Apps auf separaten Domänen ausgeführt werden. Siehe [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+<Callout tone="info">
+
+**Einheitliche Bereitstellung vs. Bereitstellung pro Domäne.** Wenn Sie alle Apps an einem Ursprung hosten (`your-agents.com/mail`, `your-agents.com/calendar`), erhalten Sie bereits eine gemeinsame Anmeldung über eine einzige Cookie-Domäne – kein Verbund erforderlich. Cross-App SSO ist nur erforderlich, wenn Apps auf separaten Domänen ausgeführt werden. Siehe [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+
+</Callout>
 
 ## Was und warum {#what-why}
 
@@ -86,15 +90,17 @@ Der Ablauf ist eine standardmäßige Autorisierung → Signiertes Token → Rüc
 
 </Diagram>
 
-1. **App → Versenden (autorisieren).** Die App sendet den Benutzer an die Identitätsbehörde:
+1. **App → Dispatch (Autorisierung).** Die app-seitige Route `GET /_agent-native/identity/login` (auf die die Schaltfläche „Mit Agent-Native anmelden“ verweist) erstellt die Weiterleitung und sendet den Benutzer an die Identitätsautorität:
 
-   ```
+   ```http
    GET https://dispatch.agent-native.com/_agent-native/identity/authorize
        ?app=<requesting-app>
        &redirect_uri=<app-callback-url>
        &state=<csrf-state>
    ```
 
+   `redirect_uri` ist die app-eigene Route `GET /_agent-native/identity/callback` – die Route, die in Schritt 3 das signierte Token empfängt.
+
 <Endpoint id="cross-app-sso-identity-authorize-de-de" title="Identity Authorize Endpoint" method="GET" path="/_agent-native/identity/authorize" summary={"Dispatch (Identitätsbehörde) authentifiziert den Menschen und leitet ihn mit einem signierten Identitätstoken zurück"} auth="Sitzung weiterleiten (interaktive Anmeldung, falls keine)" params={[
   {
     "name": "app",
@@ -143,7 +149,7 @@ Der Ablauf ist eine standardmäßige Autorisierung → Signiertes Token → Rüc
    | `scope`      | Immer `"identity"` – dieses Token autorisiert nur die Anmeldung                  |
    | `exp`        | **≤ 2 Minuten** ab Problem                                                       |
 
-4. **App verifiziert und JIT-Links per E-Mail.** Die App überprüft die Token-Signatur mit ihrem eigenen `A2A_SECRET`, überprüft `scope: "identity"` und `exp` und führt dann **Just-in-Time-Verknüpfung ausschließlich per verifizierter E-Mail** durch:
+4. **Die App überprüft und verknüpft Just-in-Time per E-Mail.** Die Route `GET /_agent-native/identity/callback` überprüft die Token-Signatur mit `A2A_SECRET`, prüft `scope: "identity"` und `exp` und führt dann **Just-in-Time-Verknüpfung ausschließlich anhand der verifizierten E-Mail-Adresse** durch:
    - Wenn ein lokaler Benutzer mit dieser E-Mail existiert → unverändert wiederverwenden.
    - Wenn nicht → erstellen Sie einen lokalen Benutzer für diese E-Mail.
 
@@ -290,9 +296,13 @@ Sobald eine App verifiziert ist, wiederholen Sie die Schritte 2–3 für die nä
 **5. Rollback = Deaktivieren Sie die Umgebungsvariable bei der Bereitstellung dieser App.**
 Um eine App zurückzusetzen, **entfernen Sie `AGENT_NATIVE_IDENTITY_HUB_URL` aus der Umgebung dieser App und stellen Sie sie erneut bereit/starten Sie sie neu.** Die App kehrt sofort zu ihrem vorherigen Authentifizierungsverhalten zurück. Es gibt **keine Datenänderung, die rückgängig gemacht werden kann** – Identitätszeilen wurden immer nur hinzugefügt, und das Deaktivieren der Variablen macht den Verbundpfad einfach wieder in den Ruhezustand. Die Umstellung und das Rollback jeder App sind unabhängig und umkehrbar.
 
-> Beim Rollout werden Benutzer abgemeldet, wenn jede App aktiviert wird (sie authentifizieren sich erneut über Dispatch), aber sie melden sich immer wieder beim **gleichen E-Mail-abgeglichenen Konto mit intakten Daten** an, da Identitätszeilen nie zerstört oder umbenannt, sondern nur hinzugefügt werden.
+<Callout tone="info">
+
+Beim Rollout werden Benutzer abgemeldet, wenn jede App aktiviert wird (sie authentifizieren sich erneut über Dispatch), aber sie melden sich immer wieder beim **gleichen E-Mail-abgeglichenen Konto mit intakten Daten** an, da Identitätszeilen nie zerstört oder umbenannt, sondern nur hinzugefügt werden.
+
+</Callout>
 
-## Verwandt {#related}
+## Wie geht es weiter? {#whats-next}
 
 - [Authentication](/docs/authentication) – lokale Authentifizierungsmodi, Sitzungen, Organisationen, die `A2A_SECRET`-Umgebungsvariable.
 - [A2A Protocol](/docs/a2a-protocol) – das signierte JWT-Vertrauensmodell mit Überprüfung an der Grenze, das hier wiederverwendet wird.

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

@@ -452,3 +452,11 @@ Weitere Informationen zum eingebetteten Agent-Panel im Vergleich zu Cloud-Frame-
 ## Mehrinstanzbereitstellungen {#multi-instance}
 
 Agent-native Apps speichern den gesamten Status in SQL über Drizzle und synchronisieren den UI über [polling](/docs/key-concepts#polling-sync) mit der Datenbank – kein Dateisystemstatus, keine Sticky Sessions, keine In-Memory-Caches. Das bedeutet, dass Bereitstellungen mit mehreren Instanzen und serverlosen Bereitstellungen sofort funktionieren: Richten Sie jede Instanz auf denselben `DATABASE_URL` und sie konvergieren automatisch. Siehe [Key Concepts — Data in SQL](/docs/key-concepts#data-in-sql) und [Portability](/docs/key-concepts#hosting-agnostic).
+
+## Wie geht es weiter?
+
+- [**Database**](/docs/database#production) — Wählen Sie vor der ersten Produktionsbereitstellung ein persistentes SQL-Backend
+- [**Security**](/docs/security) — Die Produktionscheckliste und die auf dieser Seite erwähnten Opt-in-Flags
+- [**Authentication**](/docs/authentication) — OAuth-Anmeldedaten und Umgebungsvariablen für den gewählten Authentifizierungsmodus
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — Das Workspace-Modell hinter dem Single-Origin-Build von `deploy`
+- [**Frames**](/docs/frames) — Das eingebettete Agent-Panel gegenüber dem Cloud-Frame von Builder.io für UI-Änderungen in der Produktion

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

@@ -11,6 +11,16 @@ Wenn Sie QuickBooks Online verwendet haben, haben Sie das Modell gesehen: QBO li
 
 Der Rahmen ist wichtig: Eine Erweiterung ist keine generische Sandbox „Machen Sie, was Sie wollen“. Es handelt sich um eine **Mini-App, die eine bestimmte Vorlage** – Mail, Analytics, Kalender, Clips, Design – erweitert und die actions und Daten dieser Vorlage verwendet. Eine Mail-Erweiterung liest E-Mails. Eine Analytics-Erweiterung liest die Metriken eines Dashboards. Eine Kalendererweiterung wirkt auf das offene Ereignis. Sie fühlen sich als Teil des Host-Produkts, weil sie Teil des Host-Produkts sind.
 
+> **Erweiterungen ergänzen die Benutzeroberfläche; sie schreiben die
+> Host-Benutzeroberfläche nicht um.** Eine Erweiterung wird auf einer eigenen
+> Seite oder in einem benannten [Slot](#slots) dargestellt, den die Vorlage
+> bereitstellt. Sie kann keine Elemente in beliebige native Komponenten
+> einfügen – zum Beispiel neben jeden Teilnehmer im Kalender –, sofern dort
+> kein Slot vorhanden ist. Für tiefere Anpassungen bitten Sie den Agenten, den
+> Quellcode der Vorlage zu bearbeiten. Die vollständige Anpassbarkeit des Codes
+> ist eine Kernfunktion von Agent Native; Erweiterungen sind die schnelle Ebene
+> ohne Bereitstellung.
+
 Drei Dinge sorgen dafür, dass Erweiterungen funktionieren:
 
 - **Kein Code, keine Bereitstellung.** Der Agent schreibt sie und sie sind in Sekundenschnelle live. Wird in der Datenbank gespeichert, nicht im Repo.

package/docs/content/locales/de-DE/external-agents.mdx

@@ -136,13 +136,9 @@ Snapshot, bis Sie ihn erneut aktualisieren/überprüfen, also scannen Sie den Co
 Tool- oder MCP-App-Metadatenänderungen. Wenn Sie noch alte Pro-App-Konnektoren haben
 neben Dispatch aktiviert, jeden veralteten Connector aktualisieren oder erneut verbinden; Aktualisierung
 Dispatch schreibt den zwischengespeicherten Kalender/Mail/usw. von ChatGPT oder Claude nicht neu.
-Schnappschüsse. Die Bereiche sind:
-
-| Geltungsbereich | Was es ermöglicht                                        |
-| --------------- | -------------------------------------------------------- |
-| `mcp:read`      | Schreibgeschützte Tools und Tool-/Ressourcenerkennung    |
-| `mcp:write`     | Entwurf, Aktualisierung und andere Änderungen actions    |
-| `mcp:apps`      | Inline-MCP-Apps, Diagramme, Dashboards, Entwürfe und UIs |
+Schnappschüsse. Die Bereiche `mcp:read` / `mcp:write` / `mcp:apps` sind
+dieselben, die unten unter [Standard-OAuth für Remote-MCP](#standard-oauth)
+beschrieben werden.
 
 Cursor, Goose, Postman, MCPJam und VS Code GitHub Copilot verwenden dieselbe Fernbedienung
 MCP URL über ihre eigenen MCP-Server UIs, wenn ihr Build Remote-OAuth unterstützt

package/docs/content/locales/de-DE/key-concepts.mdx

@@ -11,11 +11,9 @@ Wie agentennative Apps unter der Haube funktionieren – die Prinzipien und die
 
 Bei jeder agentennativen App arbeiten drei Dinge zusammen:
 
-> **Agent** – Autonome KI, die Daten liest, Daten schreibt, actions ausführt und Code ändert. Anpassbar mit skills und Anleitung.
->
-> **Anwendung** – Die Produktoberfläche um den Agenten. Dabei kann es sich zunächst um einen reinen Aktionsmodus, einen umfassenden Chat, eine kleine Steuerungsebene oder um eine vollständige React-UI mit Dashboards, Abläufen und Visualisierungen handeln.
->
-> **Computer** – Datenbank, Browser, Codeausführung. Agenten arbeiten direkt mit SQL und integrierten Tools; MCP-Server sind optionale Add-Ons, nicht die Grundlage.
+- **Agent** – Autonome KI, die Daten liest, Daten schreibt, actions ausführt und Code ändert. Anpassbar mit skills und Anleitung.
+- **Anwendung** – Die Produktoberfläche um den Agenten. Dabei kann es sich zunächst um einen reinen Aktionsmodus, einen umfassenden Chat, eine kleine Steuerungsebene oder um eine vollständige React-UI mit Dashboards, Abläufen und Visualisierungen handeln.
+- **Computer** – Datenbank, Browser, Codeausführung. Agenten arbeiten direkt mit SQL und integrierten Tools; MCP-Server sind optionale Add-Ons, nicht die Grundlage.
 
 <Diagram id="doc-block-1lep3dk" title="Agent, Anwendung und Computer" summary={"Drei Ebenen arbeiten über einen gemeinsamen SQL-Speicher zusammen. Der Agent und die Anwendung lesen und schreiben dieselben Daten."}>
 
@@ -278,8 +276,7 @@ Warum nicht einen LLM inline aufrufen?
 
 Wenn der Agent etwas Komplexes tun muss – einen API aufrufen, Daten verarbeiten, die Datenbank abfragen – führt er eine **Aktion** aus. Actions sind TypeScript-Dateien in `actions/`, die ein Standard-`defineAction()` exportieren:
 
-```ts
-// actions/fetch-data.ts
+```ts filename="actions/fetch-data.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -381,9 +378,8 @@ Ein _Frame_ ist die Umgebung, die den Agenten neben Ihrer App hostet – lokal i
 
 Agent-native Apps umfassen ein eingebettetes Agent-Panel, das den KI-Agenten neben der App UI bereitstellt. Dadurch funktioniert die Architektur: Der Agent benötigt einen Computer (Datenbank, Browser, Codeausführung) und die App benötigt den Agenten für die KI-Arbeit.
 
-> **Embedded Agent Panel** – Chat und optionales CLI-Terminal in jede App integriert. Unterstützt Claude-Code, Codex, Gemini, OpenCode und Builder.io. Läuft lokal. Kostenlos und Open Source.
->
-> **Cloud** – Bereitstellung in jeder Cloud mit Echtzeit-Zusammenarbeit, visueller Bearbeitung, Rollen und Berechtigungen. Am besten für Teams.
+- **Embedded Agent Panel** – Chat und optionales CLI-Terminal in jede App integriert. Unterstützt Claude-Code, Codex, Gemini, OpenCode und Builder.io. Läuft lokal. Kostenlos und Open Source.
+- **Cloud** – Bereitstellung in jeder Cloud mit Echtzeit-Zusammenarbeit, visueller Bearbeitung, Rollen und Berechtigungen. Am besten für Teams.
 
 ## Kontextbewusstsein {#context-awareness}
 
@@ -455,14 +451,11 @@ Die Übernahme des Frameworks ist vor allem deshalb wertvoll, weil Sie nichts me
 
 Das ist das „und alles andere“, was Sie sonst selbst zusammenkleben würden.
 
-## Tieftauchgänge {#deep-dives}
-
-Detaillierte Anleitungen zu bestimmten Mustern:
+## Wie geht es weiter? {#deep-dives}
 
-- [What Is Agent-Native?](/docs/what-is-agent-native) – die Vision und Philosophie
-- [Context Awareness](/docs/context-awareness) – Navigationsstatus, Bildschirmansicht, Navigationsbefehle
-- [Skills Guide](/docs/skills-guide) – Framework skills, Domäne skills, benutzerdefiniertes skills erstellen
-- [Native Chat-Oberfläche](/docs/native-chat-ui) – aktionsdeklarierte Tabellen, Diagramme und BYO-Laufzeitstatus
-- [Agent Surfaces](/docs/agent-surfaces) – Headless, Rich Chat, eingebetteter Sidecar und vollständige App-Pfade
-- [A2A Protocol](/docs/a2a-protocol) – Agent-zu-Agent-Kommunikation
-- [Multi-App Workspace](/docs/multi-app-workspace) – Hosten Sie viele Apps in einem Monorepo mit gemeinsamer Authentifizierung, skills, Komponenten und Anmeldeinformationen
+- [**What Is Agent-Native?**](/docs/what-is-agent-native) — Die Vision und Philosophie hinter diesen Regeln
+- [**Context Awareness**](/docs/context-awareness) — Navigationsstatus sowie view-screen- und navigate-Befehle im Detail
+- [**Skills Guide**](/docs/skills-guide) — Framework-Skills, Domänen-Skills und das Erstellen eigener Skills
+- [**Native Chat UI**](/docs/native-chat-ui) — Von Actions deklarierte Tabellen, Diagramme und die Haltung zu eigenen Laufzeiten
+- [**Agent Surfaces**](/docs/agent-surfaces) — Chat, native Inline-UI, vollständige App-Seiten, eingebettete Sidecars, Automatisierung und externe Agentenpfade
+- [**A2A Protocol**](/docs/a2a-protocol) — Agent-zu-Agent-Kommunikation

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

@@ -1,11 +1,15 @@
 ---
 title: "Nachrichten"
-description: "Sprechen Sie mit Ihrem Agenten über Slack, E-Mail, Telegram oder WhatsApp – derselbe Agent, derselbe Speicher, die gleichen Tools."
+description: "Sprechen Sie mit Ihrem Agenten über Slack, Microsoft Teams, Discord-Interaktionen, E-Mail, Telegram oder WhatsApp."
 ---
 
 # Nachrichten
 
-Verbinden Sie Ihren Agenten mit Slack, E-Mail, Telegram oder WhatsApp, damit Sie über die Apps, die Sie bereits verwenden, mit ihm chatten können. Es ist derselbe Agent – derselbe Speicher, die gleichen Tools, die gleichen Threads – nur von mehr Orten aus erreichbar.
+Verbinden Sie Ihren Agenten mit Slack, Microsoft Teams, Discord-Interaktionen, E-Mail, Telegram oder WhatsApp. Es ist derselbe Agent mit demselben Speicher, denselben Tools und demselben Verlauf.
+
+> **Genauer Supportumfang:** Teams validiert offizielle Bot-Framework-JWTs und antwortet in der ursprünglichen Unterhaltung. Discord unterstützt Slash-Befehle über Ed25519-signierte HTTP-Interaktionen mit verzögerter Bestätigung; normale Servernachrichten und DMs benötigen weiterhin eine Gateway-Laufzeit. Telegram erhält `message_thread_id`, und WhatsApp verwendet die eingehende `wamid` für kontextbezogene Antworten.
+>
+> Teams benötigt `MICROSOFT_TEAMS_APP_ID`, `MICROSOFT_TEAMS_APP_PASSWORD` und `MICROSOFT_TEAMS_ALLOWED_TENANT_IDS`. Discord benötigt `DISCORD_APPLICATION_ID` und `DISCORD_PUBLIC_KEY`. Telegram benötigt zusätzlich `TELEGRAM_WEBHOOK_SECRET`, WhatsApp zusätzlich `WHATSAPP_APP_SECRET`.
 
 > **Verwenden Sie die Dispatch-Vorlage?** All dies ist für Sie unter **Einstellungen → Nachrichten** eingerichtet. Klicken Sie, um jede Plattform zu verbinden – Sie müssen den Rest dieser Seite nicht lesen, es sei denn, Sie passen Ihre eigene Vorlage an oder erstellen sie. Siehe [Dispatch](/docs/dispatch) oder [Dispatch template reference](/docs/template-dispatch).
 
@@ -78,7 +82,6 @@ Verbinden Sie Ihren Agenten mit Slack, E-Mail, Telegram oder WhatsApp, damit Sie
    - `chat:write` – ermöglicht dem Agenten das Senden von Nachrichten
    - `app_mentions:read` – lässt den Agenten sehen, wann es @-erwähnt wird (optional)
    - `im:history` – ermöglicht dem Agenten, an ihn gesendete DMs zu lesen
-   - `assistant:write` – optional; Lässt Slack den nativen „Denkt...“-Status in Assistententhreads anzeigen
    - `users:read.email` – optional; hilft Vorlagen wie Mail bei der Überprüfung der Slack-Absender-E-Mail auf die Identität der Entwurfswarteschlange
 3. Klicken Sie oben auf dieser Seite auf **In Workspace installieren**. Mit Slack erhalten Sie ein **Bot-Benutzer-OAuth-Token**, das mit `xoxb-` beginnt. Kopieren Sie es.
 4. Gehen Sie in der Seitenleiste zu **Grundlegende Informationen** und kopieren Sie das **Signierungsgeheimnis**.
@@ -123,12 +126,84 @@ und `link_shared`-Ereignisse an den Clips-Unfurl-Handler.
 
 ### Tipps
 
-- **Kanalerwähnungen** – der Bot antwortet in Kanälen nur, wenn er @-erwähnt wird, um Störgeräusche zu vermeiden.
-- **DMs** – jede DM wird als private Konversation mit dem Agenten behandelt.
-- **Gleiche Identität, alle Kanäle** – wenn ein Slack-Benutzer dieselbe E-Mail-Adresse wie ein registrierter Benutzer in Ihrer App hat, behandelt der Agent ihn als dieselbe Person.
+- **Kanalerwähnungen** – Starten Sie Arbeit mit einer @Erwähnung. Antworten ohne Erwähnung gelten nur, solange genau dieser Thread aktive Arbeit enthält.
+- **DMs** – akzeptierte persönliche DMs sind private Unterhaltungen und erfordern ein verifiziertes Organisationsmitglied oder eine verknüpfte Slack-Identität.
+- **Identität** – DMs können eine verifizierte Slack-E-Mail demselben App-Benutzer zuordnen; verwaltete Kanäle verwenden ihre Dienstidentität und Richtlinie.
 - **Produktionszulassungslisten** – Legen Sie `SLACK_ALLOWED_TEAM_IDS` und für freigegebene Slack-Apps `SLACK_ALLOWED_API_APP_IDS` fest, damit ein gültiges Signaturgeheimnis nicht von einem unerwarteten Arbeitsbereich wiederverwendet werden kann.
 - **Clips-App entfaltet sich** – installierbare Agent-Native-Clips für Slack verwenden `SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET`, `SLACK_SIGNING_SECRET` und `/api/slack/oauth/callback`. Jeder verbundene Slack-Arbeitsbereich erhält seinen eigenen verschlüsselten Bot-Token in `app_secrets`; `SLACK_BOT_TOKEN` ist nur ein Legacy-Fallback für einen einzelnen Arbeitsbereich.
 
+### Verwaltetes Add to Slack
+
+Verwaltetes OAuth ist die empfohlene Einrichtung. Wählen Sie unter
+**Einstellungen → Messaging** die Option **Agent manifest**, laden Sie die
+hostspezifische Datei `agent-native-slack-manifest.json` herunter und importieren
+Sie sie in Slack unter **App Manifest**. Das Manifest aktiviert die aktuelle
+`agent_view`-Oberfläche und einen beschreibbaren **Messages**-Tab für DMs.
+Prüfen Sie anschließend diese Bot-Bereiche:
+
+App-Symbole sind nicht Bestandteil des Manifests. Laden Sie unter **Basic
+Information → Display Information** das Agent-Native-Symbol hoch, damit die
+Agents-Auswahl zur Produktmarke passt. Sie können das öffentliche
+`icon-512.svg` der App als Quelle verwenden und es bei Bedarf in ein von Slack
+unterstütztes Uploadformat konvertieren.
+
+```text
+assistant:write
+app_mentions:read
+   channels:history
+   channels:read
+   chat:write
+files:read
+   groups:history
+   groups:read
+   im:history
+im:read
+   mpim:history
+   mpim:read
+   pins:read
+   reactions:read
+users:read
+users:read.email
+```
+
+Setzen Sie die OAuth Redirect URL auf
+`https://your-app.example.com/_agent-native/integrations/slack/oauth/callback`,
+die Event Subscriptions Request URL auf
+`https://your-app.example.com/_agent-native/integrations/slack/webhook` und die
+Interactivity Request URL auf
+`https://your-app.example.com/_agent-native/integrations/slack/interactions`.
+Abonnieren Sie `app_home_opened`, `app_context_changed`, `app_mention`,
+`message.channels`, `message.groups`, `message.im` und `message.mpim`.
+Konfigurieren Sie `SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET`
+und `SLACK_SIGNING_SECRET`; klicken Sie dann unter **Einstellungen → Messaging**
+auf **Add to Slack**. Jede Installation besitzt einen verschlüsselten Token und
+team-, app-, kanal- und threadbezogene Konversationsschlüssel.
+
+Installieren Sie die Slack-App nach Änderungen an Manifest, Bereichen,
+Ereignissen, Agent View oder Messages-Tab erneut. `app_home_opened` erkennt das
+Öffnen der DMs, `app_context_changed` liefert den aktuell sichtbaren Slack-Kontext
+und `message.im` übermittelt Direktnachrichten. Slack-Administratoren können
+installierte Agenten organisationsweit ausblenden; Mitglieder können sie zudem
+aus ihrer eigenen oberen Leiste entfernen. Prüfen Sie bei einer erfolgreichen,
+aber unsichtbaren Installation diese Anzeigeeinstellungen oder öffnen Sie die App
+unter **Tools → Apps**.
+
+Persönliche Slack-DMs werden nur von verifizierten Mitgliedern der
+Agent-Native-Organisation oder von bereits verknüpften Slack-Identitäten
+angenommen. Richtlinien und Budgets des Dienstprinzipals eines Kanals sind davon
+getrennt.
+
+Antworten ohne Erwähnung steuern nur einen gerade aktiven Thread weiter; sonstiger
+Kanalverkehr wird ignoriert. Der Agent lädt begrenzten Thread-Kontext samt
+Reaktionen und Dateiverweisen und zeigt einen nativen Live-Arbeitsplan mit
+Abbrechen sowie Genehmigen/Ablehnen. DMs verwenden die persönliche Identität,
+verwaltete Kanäle eine ausdrückliche Dienstidentität mit Gast-, Slack-Connect-
+und Modellrichtlinien. Kanalspeicher wird nur auf ausdrücklichen Wunsch gespeichert
+oder gelöscht. Im Kanal erstellte Routinen liefern dorthin zurück. Tägliche oder
+monatliche Budgets für Organisation, Anfragende und Kanal werden mit vollständiger
+Audit-Lineage durchgesetzt. `assistant:write` aktiviert die Kontextereignisse von
+Agent View; `chat:write` ermöglicht Antworten und Live-Statusaktualisierungen.
+
 ## Telegramm einrichten {#telegram}
 
 ### Was Sie brauchen
@@ -435,7 +510,9 @@ POST /_agent-native/integrations/telegram/setup
 | E-Mail    | `EMAIL_AGENT_ADDRESS`, plus eines von `RESEND_API_KEY` oder `SENDGRID_API_KEY` | `EMAIL_INBOUND_WEBHOOK_SECRET`                        |
 | WhatsApp  | `WHATSAPP_ACCESS_TOKEN`, `WHATSAPP_VERIFY_TOKEN`, `WHATSAPP_PHONE_NUMBER_ID`   | —                                                     |
 
-Alle Anmeldeinformationen befinden sich in Umgebungsvariablen – niemals in der Datenbank, niemals im Quellcode. Verwenden Sie die Seitenleisteneinstellungen UI oder das Env-Panel Ihres Hosting-Anbieters.
+Integrations-Anmeldeinformationen werden zuerst aus bereichsbezogenen Geheimnissen des Integrationsbesitzers aufgelöst (Benutzer, Organisation, dann Arbeitsbereich); Bereitstellungs-Umgebungsvariablen sind ein Fallback für lokale oder bewusst mandantenfähige Einzel-Setups. Die Setup-UI speichert bereichsbezogene Geheimnisse; Werte werden weder an den Browser zurückgegeben noch im Quellcode gespeichert.
+
+Die integrierten Laufzeitadapter sind **Slack**, **Telegram**, **WhatsApp Cloud API** und **anbieterbasierte Webhook-E-Mail** (Resend oder SendGrid). Discord und Microsoft Teams sind nicht verbindbar, bis ein verifizierter Adapter implementiert und registriert wurde.
 
 ### Threading und Identität {#threading-and-identity}
 
@@ -481,13 +558,13 @@ import type {
 import type { EnvKeyConfig } from "@agent-native/core/server";
 
 const myAdapter: PlatformAdapter = {
-  platform: "discord",
-  label: "Discord",
+  platform: "my-chat",
+  label: "My Chat",
 
   // Env keys this adapter needs (rendered in the settings UI)
   getRequiredEnvKeys(): EnvKeyConfig[] {
     return [
-      { key: "DISCORD_BOT_TOKEN", label: "Discord Bot Token", required: true },
+      { key: "MY_CHAT_BOT_TOKEN", label: "My Chat Bot Token", required: true },
     ];
   },
 
@@ -507,10 +584,10 @@ const myAdapter: PlatformAdapter = {
   // Return null to silently ignore the event (bot messages, edits, etc.).
   async parseIncomingMessage(event: H3Event): Promise<IncomingMessage | null> {
     return {
-      platform: "discord",
+      platform: "my-chat",
       externalThreadId: "channel-or-thread-id",
       text: "the user's message",
-      senderId: "discord-user-id",
+      senderId: "my-chat-user-id",
       platformContext: { channelId: "channel-id" },
       timestamp: Date.now(),
     };
@@ -538,10 +615,10 @@ const myAdapter: PlatformAdapter = {
   // baseUrl is the app's public URL, used for status checks that need it.
   async getStatus(baseUrl?: string) {
     return {
-      platform: "discord",
-      label: "Discord",
+      platform: "my-chat",
+      label: "My Chat",
       enabled: true,
-      configured: !!process.env.DISCORD_BOT_TOKEN,
+      configured: !!process.env.MY_CHAT_BOT_TOKEN,
     };
   },
 };