@agent-native/core 0.93.0 → 0.94.0

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/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/multi-tenancy.mdx

@@ -17,7 +17,7 @@ Ein neues `npx @agent-native/core@latest create`-Gerüst wird bereits geliefert
 - **Organisationswechsel** – die Sitzung verfolgt die aktive Organisation (`session.orgId`) und durch den Wechsel werden die Daten geändert, die der Benutzer und der Agent sehen.
 - **Datenisolierung pro Organisation** – jede Abfrage wird automatisch auf die aktive Organisation beschränkt.
 
-Wenn Sie Agent-nativ für ein CRM, einen Projekt-Tracker, einen Support-Posteingang oder ein anderes Team-Tool evaluieren, ist die mandantenfähige Grundlage bereits vorhanden. Alle Erstanbieter-Vorlagen sind mehrmandantenfähig – die Liste finden Sie unter [Cloneable SaaS templates](/docs/cloneable-saas).
+Wenn Sie Agent-nativ für ein CRM, einen Projekt-Tracker, einen Support-Posteingang oder ein anderes Team-Tool evaluieren, ist die mandantenfähige Grundlage bereits vorhanden. Alle Erstanbieter-Vorlagen sind mehrmandantenfähig – die Liste finden Sie unter [Vorlagen](/docs/cloneable-saas).
 
 <Diagram id="doc-block-5xksqg" title="Org-Mitgliedschaft und Isolation" summary={"Benutzer treten Organisationen als owner/admin/member bei. Jede besitzbare Zeile trägt den org_id des Mandanten, der sie besitzt, und keine Zeile verliert über die Grenze hinweg."}>
 
@@ -117,8 +117,8 @@ Mandantendaten werden durch eine `org_id`-Spalte isoliert (hinzugefügt von `own
 
 Dies ist dieselbe Pipeline, die für die Festlegung des Bereichs pro Benutzer verwendet wird. Informationen zur Mechanik auf SQL-Ebene, zum `ownableColumns()`-Vertrag und zu den Wachen `accessFilter` / `resolveAccess` / `assertAccess` finden Sie unter [Security → Data Scoping](/docs/security#data-scoping) – die einzige Quelle der Wahrheit für die Scoping-Pipeline.
 
-## Verwandte Dokumente {#related}
+## Wie geht es weiter? {#related}
 
-- [Authentication](/docs/authentication#organizations) – Sitzungen, soziale Anbieter und die Organisationsverwaltungsoberfläche
-- [Security → Data Scoping](/docs/security#data-scoping) – Isolation auf SQL-Ebene, der `ownableColumns()`-Vertrag und Zugriffsschutz
-- [Multi-App Workspace](/docs/multi-app-workspace) – Hosten mehrerer agentennativer Apps in einem Monorepo mit gemeinsamer Authentifizierung und RBAC
+- [**Authentication**](/docs/authentication#organizations) — Sitzungen, soziale Anbieter und die Organisationsverwaltungsoberfläche
+- [**Security — Data Scoping**](/docs/security#data-scoping) — Isolation auf SQL-Ebene, der `ownableColumns()`-Vertrag und Zugriffsschutz
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — Hosten mehrerer Agent-Native-Apps in einem Monorepo mit gemeinsamer Authentifizierung und RBAC

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

@@ -113,6 +113,7 @@ Der Schweregrad steuert den Badge-Stil im Dropdown-Menü und wird an die Kanäle
 | `inbox`   | Bleibt in der `notifications`-Tabelle; treibt die Glocke an UI | Immer an – Teil des Grundelements.                                   |
 | `webhook` | POST JSON zu einem konfigurierten URL                          | `NOTIFICATIONS_WEBHOOK_URL` Umgebungsvariable beim Start festgelegt. |
 
+E-Mail, Slack und Webhook werden neben dem Posteingang immer registriert. Bei der Zustellung werden zuerst die URL bzw. Empfänger aus den Metadaten der Benachrichtigung verwendet und dann die passende Umgebungsvariable. Ist beides nicht festgelegt, führt der Kanal bei der Ausgabe nichts aus.
 Der Webhook-Kanal löst `${keys.NAME}`-Referenzen sowohl im URL als auch im `NOTIFICATIONS_WEBHOOK_AUTH` anhand des Ad-hoc-[secrets](/docs/security) des Eigentümers auf, sodass der Rohwert niemals in den Kontext des Agenten gelangt. Es werden URL-Zulassungslisten pro Schlüssel erzwungen – dieselbe Regel, die das Automatisierungstool `web-request` verwendet.
 
 <Diagram id="doc-block-za29cd" title={"Kanäle und Schweregrad"} summary={"Der Posteingang ist immer aktiviert. Webhook benötigt eine Umgebungsvariable; Benutzerdefinierte Kanäle werden beim Start registriert. Der Schweregrad bestimmt die Gestaltung des Abzeichens und wird an alle Kanäle weitergegeben."}>
@@ -203,7 +204,7 @@ await notify(
 
 Registrieren Sie einen benutzerdefinierten Kanal von einem beliebigen Server-Plugin.
 
-```ts
+```ts filename="server/plugins/notifications-slack-ops.ts"
 import { registerNotificationChannel } from "@agent-native/core/notifications";
 
 registerNotificationChannel({
@@ -274,15 +275,15 @@ interface NotificationMeta {
 
 Wird durch das Core-Routes-Plugin bei `/_agent-native/notifications/*` gemountet. Alle Routen beziehen sich auf die E-Mail-Adresse der authentifizierten Sitzung.
 
-| Methode  | Pfad                                                |
-| -------- | --------------------------------------------------- |
-| `GET`    | `/_agent-native/notifications?unread=true&limit=50` |
-| `GET`    | `/_agent-native/notifications/count`                |
-| `POST`   | `/_agent-native/notifications/:id/read`             |
-| `POST`   | `/_agent-native/notifications/read-all`             |
-| `DELETE` | `/_agent-native/notifications/:id`                  |
+| Methode  | Pfad                                                           |
+| -------- | -------------------------------------------------------------- |
+| `GET`    | `/_agent-native/notifications?unread=true&limit=50&before=ISO` |
+| `GET`    | `/_agent-native/notifications/count`                           |
+| `POST`   | `/_agent-native/notifications/:id/read`                        |
+| `POST`   | `/_agent-native/notifications/read-all`                        |
+| `DELETE` | `/_agent-native/notifications/:id`                             |
 
-<Endpoint id="doc-block-fro2p7" title="Benachrichtigungen auflisten" summary={"The route behind listNotifications() — scoped to the authenticated session's email."} method="GET" path={"/_agent-native/notifications?unread=true&limit=50"} summary={"Letzte Benachrichtigungen für den aktuellen Benutzer auflisten"} auth={"Authenticated session; results are scoped to the session's email."} params={[
+<Endpoint id="doc-block-fro2p7" title="Benachrichtigungen auflisten" method="GET" path={"/_agent-native/notifications?unread=true&limit=50&before=ISO"} summary={"Letzte Benachrichtigungen für den aktuellen Benutzer auflisten"} auth={"Authenticated session; results are scoped to the session's email."} params={[
   {
     "name": "unread",
     "in": "query",
@@ -296,6 +297,13 @@ Wird durch das Core-Routes-Plugin bei `/_agent-native/notifications/*` gemountet
     "type": "number",
     "required": false,
     "description": "Max rows to return."
+  },
+  {
+    "name": "before",
+    "in": "query",
+    "type": "string",
+    "required": false,
+    "description": "ISO-Zeitstempel-Cursor – gibt für die Seitennavigation Benachrichtigungen zurück, die vor diesem Zeitpunkt erstellt wurden."
   }
 ]} responses={[
   {
@@ -308,7 +316,7 @@ Wird durch das Core-Routes-Plugin bei `/_agent-native/notifications/*` gemountet
 
 ## UI-Komponente {#ui}
 
-```tsx
+```tsx filename="app/components/HeaderBar.tsx"
 import { NotificationsBell } from "@agent-native/core/client/notifications";
 
 export function HeaderBar() {

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

@@ -51,8 +51,11 @@ Ein `Processor` ist ein schleifeninterner **Beobachter/Leitplanke** für den Age
 
 </Diagram>
 
-> [!WARNING]
-> Ein Prozessor ist eine **Konfiguration**, kein Werkzeug, keine Aktion und kein Authoring DSL. Prozessoren beobachten nur, verändern ihren eigenen Stream-Scope-Status und `abort()`. Sie definieren niemals das App-Verhalten, ersetzen actions oder erscheinen im Modell. App-Vorgänge gehören zu [actions](/docs/actions).
+<Callout id="doc-block-proc1cfg" tone="warning">
+
+Ein Prozessor ist eine **Konfiguration**, kein Werkzeug, keine Aktion und kein Authoring DSL. Prozessoren beobachten nur, verändern ihren eigenen Stream-Scope-Status und `abort()`. Sie definieren niemals das App-Verhalten, ersetzen actions oder erscheinen im Modell. App-Vorgänge gehören zu [actions](/docs/actions).
+
+</Callout>
 
 ## Die Haken {#hooks}
 
@@ -133,10 +136,13 @@ await runAgentLoop({
 
 **Kein Overhead, wenn nicht verwendet.** Die Schleife baut die Prozessorkette nur auf, wenn mindestens ein Prozessor bereitgestellt wird; Wenn `processors` weggelassen oder leer ist, wird keiner der Nahtcodes ausgeführt und die Schleife bleibt Byte für Byte unverändert. Hooks werden in der Reihenfolge der Registrierung ausgeführt und können synchron oder asynchron sein.
 
-> [!NOTE]
-> Der Loop-Level-Seam ist heute lieferbar und kann direkt von Subagenten, A2A, MCP und Tests aufgerufen werden. Das Einfädeln von `processors` durch den HTTP-Chat-Handler (damit ein Pro-Request-Resolver sie konfigurieren kann, ohne `runAgentLoop` direkt aufzurufen) ist eine praktische Installation, die noch nicht verkabelt ist – konfigurieren Sie Prozessoren vorerst an der `runAgentLoop`-Aufrufseite.
+<Callout id="doc-block-proc1note" tone="info">
+
+Der Loop-Level-Seam ist heute lieferbar und kann direkt von Subagenten, A2A, MCP und Tests aufgerufen werden. Das Einfädeln von `processors` durch den HTTP-Chat-Handler (damit ein Pro-Request-Resolver sie konfigurieren kann, ohne `runAgentLoop` direkt aufzurufen) ist eine praktische Installation, die noch nicht verkabelt ist – konfigurieren Sie Prozessoren vorerst an der `runAgentLoop`-Aufrufseite.
+
+</Callout>
 
-## Verwandt
+## Wie geht es weiter
 
 - [**Durable Resume**](/docs/durable-resume) – wie die Schleife Unterbrechungen übersteht, ohne abgeschlossene Nebenwirkungen erneut auszuführen.
 - [**Custom Agents & Teams**](/docs/agent-teams) – Subagenten führen dieselbe Schleife aus und können ihre eigenen Prozessoren tragen.

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

@@ -94,8 +94,7 @@ server/routes/
 
 Jede Route exportiert einen `defineEventHandler`:
 
-```ts
-// server/routes/api/health.get.ts
+```ts filename="server/routes/api/health.get.ts"
 import { defineEventHandler } from "h3";
 
 export default defineEventHandler(() => ({
@@ -135,8 +134,7 @@ Verwenden Sie die `http`-Option der action, um direkten HTTP-Zugriff zu formen:
 
 Für einen schreibgeschützten Status-endpoint behalten Sie ihn als action bei:
 
-```ts
-// actions/get-status.ts
+```ts filename="actions/get-status.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -169,8 +167,7 @@ was passiert ist. Für schmale serverseitige Transformationen, die absichtlich n
 Tools, Chat-Verlauf oder Ausführungsstatus verwenden `completeText()` als expliziten Escape
 Luke.
 
-```ts
-// actions/classify-message.ts
+```ts filename="actions/classify-message.ts"
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
 import { z } from "zod";
@@ -235,8 +232,7 @@ Actions, das vom Framework bereitgestellt wird, wird automatisch mit dem Anforde
 
 Plugins leben in `server/plugins/` und werden beim Start ausgeführt. Verwenden Sie sie für Migrationen, Anbietereinrichtung, wiederkehrende Jobs, Integrationsadapter und Framework-Plugin-Konfiguration.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -414,8 +410,12 @@ Eingehender webhooks sollte überprüft werden, bestehen bleiben und schnell zur
 
 </Diagram>
 
-> [!WARNING]
-> Verlassen Sie sich nicht auf unerwartete Versprechen, nachdem Sie eine Antwort zurückgegeben haben – serverlose Hosts frieren die Ausführung ein. Informationen zur kanonischen Integrationswarteschlange finden Sie unter [Messaging](/docs/messaging).
+<Callout tone="warning">
+  Verlassen Sie sich nicht auf unerwartete Versprechen, nachdem Sie eine Antwort
+  zurückgegeben haben – serverlose Hosts frieren die Ausführung ein.
+  Informationen zur kanonischen Integrationswarteschlange finden Sie unter
+  [Messaging](/docs/messaging).
+</Callout>
 
 ## Fortgeschritten: Fluchtluken {#advanced-escape-hatches}
 
@@ -457,3 +457,11 @@ const handler = createProductionAgentHandler({
   systemPrompt: "You are the app agent...",
 });
 ```
+
+## Wie geht es weiter?
+
+- [**Actions**](/docs/actions) – die Standardoberfläche für Operationen; verwenden Sie eine benutzerdefinierte Route nur, wenn sie dort nicht passt
+- [**Datenbank**](/docs/database) – das `getDb()`/`schema`-Muster, das benutzerdefinierte Routen und Actions importieren
+- [**Sicherheit**](/docs/security#access-guards) – `accessFilter`/`assertAccess` und das vollständige Datenscoping-Modell
+- [**Messaging**](/docs/messaging) – das kanonische Muster für die Integrationswarteschlange eingehender Webhooks
+- [**MCP-Protokoll**](/docs/mcp-protocol) – der `/_agent-native/mcp`-Endpunkt, den dieser Server automatisch einbindet

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

@@ -1,13 +1,13 @@
 ---
 title: "Freigabe und Datenschutz"
-description: "Freigabe im Google-Docs-Stil, in das Framework integriert. Jede vom Benutzer erstellte Ressource – Dokumente, Dashboards, Designs, Decks, Clips, Aufzeichnungen, Formulare – erhält standardmäßig dasselbe private Modell mit einer einheitlichen Freigabe UI."
+description: "Vertrautes, einheitliches Teilen, direkt in das Framework integriert. Jede benutzererstellte Ressource – Dokumente, Dashboards, Designs, Decks, Clips, Aufzeichnungen und Formulare – erhält dasselbe standardmäßig private Modell mit einer einheitlichen Freigabeoberfläche."
 ---
 
 # Freigabe und Datenschutz
 
 Jede Ressource, die ein Benutzer in einer agentennativen App erstellt – ein Dokument, ein Dashboard, ein Design, eine Präsentation, eine Bildschirmaufzeichnung, ein Besprechungsprotokoll, ein Formular, ein Buchungslink – ist **standardmäßig privat für den Ersteller**. Andere sehen es nur, wenn der Ersteller es ausdrücklich teilt oder seine Sichtbarkeit in `org` oder `public` ändert.
 
-Es sieht aus und funktioniert wie Google Docs. Die gleiche Schaltfläche zum Teilen, derselbe Dialog, das gleiche dreistufige Sichtbarkeitsmodell, die gleichen Gewährungen pro Benutzer/pro Organisation – für jede Vorlage, ohne Neuerfindung pro App.
+Es gibt überall ein vertrautes Freigabemodell: dieselbe Freigabeschaltfläche, derselbe Dialog, dasselbe dreistufige Sichtbarkeitsmodell und dieselben Berechtigungen pro Benutzer und Organisation – in jeder Vorlage, ohne Neuerfindung pro App.
 
 ## Warum ein Modell {#why}
 
@@ -92,7 +92,7 @@ Jede Vorlage, die vom Benutzer erstellte Arbeiten speichert, verwendet dieses Mo
 - **Inhalt** – Dokumente
 - **Folien** – Decks
 - **Design** – Designs und Assets
-- **Clips** – Bildschirmaufnahmen (Loom-Stil)
+- **Clips** – Bildschirmaufnahmen
 - **Plan** — visual plans and PR recaps
 - **Formulare** – Formulardefinitionen
 - **Kalender** – Veranstaltungen und Buchungslinks
@@ -115,7 +115,7 @@ Jede gemeinsam nutzbare Ressource erhält in ihrer Kopfzeile eine Schaltfläche
 
 - Sichtbarkeitsauswahl (`Private` / `Organization` / `Public link`).
 - Autovervollständigung „Personen oder Teams hinzufügen“ – Benutzer in der Organisation suchen oder eine E-Mail einfügen.
-- Ein `Benachrichtigen people`-Kontrollkästchen im Google Docs-Stil für individuelle E-Mail-Genehmigungen.
+- Ein Kontrollkästchen `Personen benachrichtigen` für individuelle E-Mail-Berechtigungen.
 - Eine Liste aktueller Gewährungen mit Rollenauswahl und einer Entfernungskontrolle.
 - Eine Schaltfläche zum Kopieren von Links, die die aktuelle Sichtbarkeit berücksichtigt.
 
@@ -270,7 +270,7 @@ export const deckShares = createSharesTable("deck_shares");
 
 Ein Registrierungsaufruf in `server/db/index.ts`:
 
-```ts
+```ts filename="server/db/index.ts"
 import { registerShareableResource } from "@agent-native/core/sharing";
 
 registerShareableResource({
@@ -315,9 +315,9 @@ For resources that execute code or carry elevated trust (like extensions), set `
 
 Die gemeinsame Nutzung erfolgt auf dem umfassenderen Datenscoping-Modell des Frameworks – der Listen-/Lese-/Schreibzugriff auf besitzbare Tabellen erfolgt über `accessFilter()` / `resolveAccess()` / `assertAccess()`, und mit `org_id` gekennzeichnete Ressourcen sind organisationsübergreifend unsichtbar. Siehe [Security → Data Scoping](/docs/security#data-scoping) für die vollständige Pipeline, den CI-Schutz und die Bedrohungsoberfläche.
 
-## Siehe auch {#see-also}
+## Wie geht es weiter? {#see-also}
 
-- [Security & Data Scoping](/docs/security) – das Zugriffsfilter- und Eigentumsmodell, auf dem das Teilen basiert.
-- [Authentication](/docs/authentication) – Sitzungen, Organisationen und wie Identität in den Anfragekontext fließt.
-- [Extensions](/docs/extensions#sharing) – Teilen in der Sandbox-Mini-App-Oberfläche.
-- [Creating Templates](/docs/creating-templates) – Verknüpfen von `ownableColumns` mit dem Schema einer neuen Vorlage.
+- [**Sicherheit – Datenscoping**](/docs/security#data-scoping) – das Zugriffsfilter- und Eigentumsmodell, auf dem das Teilen basiert
+- [**Authentifizierung**](/docs/authentication) – Sitzungen, Organisationen und wie Identität in den Anfragekontext fließt
+- [**Erweiterungen**](/docs/extensions#sharing) – Teilen in der Sandbox-Mini-App-Oberfläche
+- [**Vorlagen erstellen**](/docs/creating-templates) – `ownableColumns` mit dem Schema einer neuen Vorlage verbinden