@agent-native/core 0.76.5 → 0.76.6

package/docs/content/locales/de-DE/template-brain.md

@@ -0,0 +1,324 @@
+---
+title: "Gehirn"
+description: "Sauberer Unternehmenschat, unterstützt durch zitiertes institutionelles Gedächtnis, überprüfbare Quellenaufnahme und wiederverwendbare Arbeitsbereichsintegrationen."
+---
+
+# Gehirn
+
+Brain ist ein sauberer Unternehmenschat, der durch das zitierte institutionelle Gedächtnis gestützt wird. Die Leute fragen
+Fragen in einfachem Englisch; Brain-Antworten aus bewährtem Unternehmenswissen mit
+Links zurück zum Slack-Thread, Meeting, Transkript, Issue oder Webhook-Erfassung
+das unterstützt die Antwort.
+
+Brain nimmt genehmigte Slack-Kanäle, Clips-Aufnahmen und den Granola-Team-Bereich auf
+Notizen, GitHub-Probleme/PRs und generische Transkript-/Webhook-Nutzlasten. Es speichert Rohdaten
+erfasst, destilliert dauerhafte Fakten/Entscheidungen/Prozesse und leitet sensible Daten weiter
+Erinnerungen mit geringem Vertrauen durch Überprüfung, bevor sie zum Unternehmenswissen werden.
+
+Die Produktoberfläche bleibt bewusst einfach: **Fragen** ist der primäre Chat
+Erfahrung, während **Quellen**, **Rezension** und **Wissen** Administrator/Support sind
+Oberflächen zum Verbinden von Daten, zum Genehmigen von Vorschlägen und zum Überprüfen des zitierten Speichers.
+
+```an-diagram title="From source to cited answer" summary="Brain ingests approved sources into raw captures, distills durable memory, gates it through review, and only then answers with citations."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Sources</span><small class=\"diagram-muted\">Slack · Granola · GitHub · Clips · webhooks</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Raw captures<br><small class=\"diagram-muted\">deduped, redacted</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Distill<br><small class=\"diagram-muted\">facts · decisions · processes</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">Review</span><small class=\"diagram-muted\">sensitive / low-confidence queue</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill ok\">Knowledge</span><small class=\"diagram-muted\">approved, atomic</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Ask</span><small class=\"diagram-muted\">cited answer</small></div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-flow .diagram-card{display:flex;flex-direction:column;gap:4px;padding:10px 12px}.diagram-flow .diagram-box{display:flex;flex-direction:column;gap:4px}.diagram-flow .diagram-arrow{font-size:20px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Ask company memory</h1><span class='wf-pill accent'>42 approved memories</span><span class='wf-pill'>3 sources</span><div style='flex:1'></div><button>Sources</button><button>Review</button></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span data-icon='search' aria-label='Search'></span><strong style='flex:1'>Why did we choose usage pricing?</strong><button class='primary'>Ask</button></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Answer</strong><p style='margin:0'>The team chose usage pricing after pilots showed seat counts undercounted automation value.</p><div style='display:flex;gap:8px;flex-wrap:wrap'><span class='wf-pill accent'>Pricing RFC</span><span class='wf-pill'>Launch retro</span><span class='wf-pill'>Sales notes</span></div></div><div class='wf-card' style='flex:1;display:flex;flex-direction:column;gap:8px'><strong>Source timeline</strong><div class='wf-box'>May 3 · Decision captured</div><div class='wf-box'>May 8 · Customer evidence added</div><div class='wf-box'>May 12 · Legal note approved</div></div></div>"
+}
+```
+
+Wenn Sie die App öffnen, steht **Ask** im Vordergrund – ein sauberer, überprüfter Chat
+Firmengedächtnis. **Quellen**, **Rezension** und **Wissen** stehen daneben als
+Admin-Oberflächen zum Verbinden von Daten, Genehmigen von Vorschlägen und Einsehen zitierter Dokumente
+Einträge.
+
+## Wann sollte man es auswählen
+
+Verwenden Sie Brain, wenn Ihr Team möchte, dass Agenten Fragen wie „Warum haben wir es gemacht?“ beantworten sollen.
+diese Produktentscheidung?“, „Wie funktioniert diese in der Entwicklung befindliche Funktion?“ oder „Was
+in diesem Prozess geändert?“ mit Links zurück zur Quellkonversation, Besprechung,
+oder Problem.
+
+Brain und Dispatch ergänzen sich, erfüllen jedoch unterschiedliche Aufgaben:
+
+- **Brain besitzt das Unternehmensgedächtnis.** Es nimmt Quellen auf, überprüft Roherfassungen
+  destilliert dauerhafte Fakten/Entscheidungen/Prozesse, Antworten aus zitierten Beweisen und
+  stellt genehmigtes Wissen den Agenten zur Verfügung.
+- **Dispatch ist Eigentümer der Workspace-Steuerungsebene.** Es zentralisiert die Nachrichtenübermittlung
+  Geheimnisse, wiederkehrende Jobs, Genehmigungen, A2A-Orchestrierung und die Verteilung
+  und Genehmigung arbeitsbereichsweiter Ressourcen.
+
+In einem Multi-App-Arbeitsbereich kann Dispatch eine Frage über A2A und an Brain weiterleiten
+kann Brain Shared-Provider-Anmeldeinformationen gewähren. Brain bleibt der Spezialist für
+Genehmigte Quellenaufnahme, Überprüfung, Abruf und zitierte Antworten von Company Brain.
+Brain stellt den schreibgeschützten, durch Zitate unterstützten Abruf als seine öffentliche A2A-Funktion zur Verfügung
+damit Dispatch- und Geschwister-Apps Fragen zum Unternehmensspeicher stellen können – der A2A-Agent
+Karte sind öffentliche Discovery-Metadaten, während der Abruf weiterhin innerhalb von Brain erfolgt
+authentifizierte Aktionsoberfläche.
+
+## Was Sie damit machen können
+
+- **Stellen Sie zitierte Fragen.** Ask ist die Hauptproduktoberfläche: ein sauberer Chat.
+  überprüfter Unternehmensspeicher, mit Quellzustand, Überprüfungsanzahl und Vorschlägen
+  Fragen wurden zweitrangig gehalten. Jede Antwort verweist auf den Slack-Thread
+  Besprechung, Problem oder Aufnahme, die dies unterstützt.
+- **Genehmigte Quellen verbinden.** Konfigurieren Sie manuell, generischen Webhook, Clips, Slack,
+  Granola- und GitHub-Quellen. Die Quellen werden standardmäßig von der Organisation geteilt, also vom Unternehmen
+  Speicher ist für den gesamten Arbeitsbereich nützlich.
+- **Überprüfung vor der Veröffentlichung.** Vorgeschlagene Erinnerungen erhalten eine erstklassige Überprüfungsroute
+  wobei Prüfer den Wortlaut bearbeiten, Beweise/Quellenlinks prüfen und genehmigen oder
+  ablehnen. Nicht vertrauliche Einträge mit hoher Zuverlässigkeit können sofort veröffentlicht werden;
+  Einträge auf Unternehmensebene oder vertrauliche Einträge werden als Vorschläge in die Warteschlange gestellt.
+- **Zitiertes Wissen prüfen.** Die Wissensroute zeigt destilliertes, atomares Wissen
+  Einträge mit Art, Thema, Entitäten, Vertrauen, genauen Beweiszitaten und
+  Links ersetzen.
+- **Workspace-Integrationen wiederverwenden.** Brain-Quellen können gemeinsam genutzte Workspaces wiederverwenden
+  Verbindungsgewährung statt erneuter Eingabe von Provider-Tokens. Die Seite „Quellen“
+  zeigt Brain-Quellendatensätze neben wiederverwendbaren Verbindungsgewährungen und Anbietern an
+  Bereitschaft.
+- **Genehmigten Speicher als Umgebungskontext spiegeln.** Von Canonical genehmigte Einträge können
+  Spiegelung in Arbeitsbereichsressourcen unter `context/company-brain/...` und anderen
+  Apps können sie als Kontext verwenden. Beide Flows zeigen eine Vorschau des genauen Markdown vor dem
+  Ressource wurde geschrieben oder entfernt.
+
+## Erste Schritte
+
+Live-Demo: [brain.agent-native.com](https://brain.agent-native.com).
+
+1. **Testen Sie die Demo.** Öffnen Sie Ask und wählen Sie **Demo starten**. Brain Seeds ein kleines
+   Produktentscheidungskorpus, führt die Vertrauensprüfungen durch und stellt eine zitierte Frage dazu
+   Sie können vor dem Hinzufügen Antworten, Zitate, Rezensionen und nicht gefundenes Verhalten sehen
+   echte Unternehmensdaten.
+2. **Fügen Sie eine Quelle hinzu.** Beginnen Sie mit einem einzelnen Slack-Kanal, Granola Team-Space
+   -Feed, GitHub-Repository, Clips-Export oder generischer Transkript-Webhook. Behalten
+   Der Umfang wird klein gehalten, bis Zitate und Rezensionsqualität stimmen.
+3. **Überprüfen Sie vor der Veröffentlichung.** Verwenden Sie „Überprüfen“, um Beweise zu prüfen, Formulierungen zu bearbeiten usw.
+   und genehmigen Sie nur dauerhafte Unternehmensspeicher.
+4. **Fragen Sie von der Quelle.** Verwenden Sie „Fragen“ für Fragen, die fundiert sein sollten
+   geprüftes Wissen, keine rohen Chatprotokolle.
+
+Für eine öffentliche Demo demonstriert das gesetzte Korpus den Rückruf von Produktentscheidungen
+Zitierlinks, Ersetzungsverhalten, Bewertungs-Gating, Schwärzung, persönliche Inhalte
+Ausschluss und ehrliches, nicht gefundenes Verhalten ohne Verbindung zu einem echten Arbeitsbereich.
+
+### Nützliche Eingabeaufforderungen
+
+- „Was haben wir über die Jahrespreise entschieden und wo wurde das besprochen?“
+- „Finden Sie die letzte Änderung im Onboarding-Prozess und geben Sie die Quelle an.“
+- „Fassen Sie zusammen, was diese GitHub-Diskussion für den Einführungsplan bedeutet.“
+- „Überprüfen Sie die ausstehenden Speichervorschläge und markieren Sie alles, was zu vage für die Veröffentlichung ist.“
+- „Welche Quellen sind veraltet oder werden nicht synchronisiert?“
+
+## Für Entwickler
+
+Der Rest dieses Dokuments richtet sich an alle, die die Brain-Vorlage verzweigen oder erweitern.
+
+### Schnellstart
+
+```bash
+npx @agent-native/core@latest create my-brain --standalone --template brain
+cd my-brain
+pnpm install
+pnpm dev
+```
+
+Öffnen Sie die App und wählen Sie **Demo starten**, um den zitierten Speicher anzuzeigen, ohne einen echten Arbeitsbereich anzuschließen.
+
+### Datenmodell
+
+Brain nutzt absichtlich die SQL-Textsuche und die Agenten-Abfrageerweiterung – das gibt es
+keine Vektordatenbank erforderlich, daher bleibt die Vorlage über SQLite hinweg portierbar,
+Postgres, Neon, D1, Turso und ähnliche Hosts. Der Anwendungsstatus spiegelt den
+aktuelle Route, Filter und ausgewählte IDs, damit der Agent immer die aktuelle Route kennt
+Navigation und Auswahl.
+
+Das Schema von Brain befindet sich in `templates/brain/server/db/schema.ts`. Acht Tabellen:
+
+| Tabelle                  | Was es enthält                                                                                                                                                         |
+| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `brain_sources`          | Connector-Konfiguration – Anbieter, Kanäle/Repos auf der Zulassungsliste, Synchronisierungscursor, Überprüfungsstatus, `ingest_token_hash`, `status`, `last_synced_at` |
+| `brain_source_shares`    | Freigabegewährung pro Quelle (Betrachter/Redakteur/Administrator)                                                                                                      |
+| `brain_raw_captures`     | Transkripte, Kanalexporte, Notizen und Webhook-Importe mit `external_id`-Deduplizierungsschlüssel, `content_hash`, Art und Destillationsstatus                         |
+| `brain_knowledge`        | Destillierte atomare Einträge – Art (Entscheidung / Tatsache / Prozess / …), Thema, Entitäten, Beweiszitate, Vertrauen, `publish_tier`, Ersatzlinks                    |
+| `brain_knowledge_shares` | Zuteilungen pro Wissensanteil                                                                                                                                          |
+| `brain_proposals`        | Ausstehende Überprüfungselemente – vorgeschlagene Erstellung/Aktualisierung/Archivierung mit Beweisen und Prüfernotizen                                                |
+| `brain_proposal_shares`  | Aktienzuteilungen pro Vorschlag                                                                                                                                        |
+| `brain_sync_runs`        | Überwachungsprotokoll synchronisieren – Anbieter, Status, Statistiken JSON, Fehler, Start-/Endzeitstempel                                                              |
+| `brain_ingest_queue`     | Hintergrund-Destillationswarteschlange – Vorgang, Status, Priorität, Anzahl der Wiederholungen, `run_after`                                                            |
+
+```an-schema title="Brain data model" summary="Connectors produce raw captures; distillation turns captures into reviewable knowledge; proposals gate sensitive entries. Sync runs and the ingest queue track background work."
+{
+  "entities": [
+    { "id": "sources", "name": "brain_sources", "note": "Connector config", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "provider", "type": "text", "note": "slack / granola / github / clips / webhook" },
+      { "name": "ingest_token_hash", "type": "text" },
+      { "name": "status", "type": "text" },
+      { "name": "last_synced_at", "type": "timestamp", "nullable": true }
+    ] },
+    { "id": "source_shares", "name": "brain_source_shares", "note": "viewer / editor / admin", "fields": [
+      { "name": "source_id", "type": "id", "fk": "brain_sources.id" }
+    ] },
+    { "id": "captures", "name": "brain_raw_captures", "note": "Ingested raw payloads", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "source_id", "type": "id", "fk": "brain_sources.id" },
+      { "name": "external_id", "type": "text", "note": "dedupe key" },
+      { "name": "content_hash", "type": "text" },
+      { "name": "kind", "type": "text" }
+    ] },
+    { "id": "knowledge", "name": "brain_knowledge", "note": "Distilled atomic entries", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "kind", "type": "text", "note": "decision / fact / process" },
+      { "name": "topic", "type": "text" },
+      { "name": "entities", "type": "json" },
+      { "name": "confidence", "type": "real" },
+      { "name": "publish_tier", "type": "text" }
+    ] },
+    { "id": "knowledge_shares", "name": "brain_knowledge_shares", "fields": [
+      { "name": "knowledge_id", "type": "id", "fk": "brain_knowledge.id" }
+    ] },
+    { "id": "proposals", "name": "brain_proposals", "note": "Pending review items", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "op", "type": "text", "note": "create / update / archive" }
+    ] },
+    { "id": "proposal_shares", "name": "brain_proposal_shares", "fields": [
+      { "name": "proposal_id", "type": "id", "fk": "brain_proposals.id" }
+    ] },
+    { "id": "sync_runs", "name": "brain_sync_runs", "note": "Sync audit log", "fields": [
+      { "name": "source_id", "type": "id", "fk": "brain_sources.id" },
+      { "name": "status", "type": "text" },
+      { "name": "stats", "type": "json" }
+    ] },
+    { "id": "ingest_queue", "name": "brain_ingest_queue", "note": "Background distillation queue", "fields": [
+      { "name": "operation", "type": "text" },
+      { "name": "status", "type": "text" },
+      { "name": "priority", "type": "int" },
+      { "name": "run_after", "type": "timestamp", "nullable": true }
+    ] }
+  ],
+  "relations": [
+    { "from": "sources", "to": "captures", "kind": "1-n", "label": "ingested into" },
+    { "from": "knowledge", "to": "captures", "kind": "n-n", "label": "evidence" },
+    { "from": "knowledge", "to": "proposals", "kind": "1-n", "label": "gated by" },
+    { "from": "sources", "to": "sync_runs", "kind": "1-n", "label": "audited by" }
+  ]
+}
+```
+
+### Schlüssel actions
+
+Gruppiert nach Bereich (`templates/brain/actions/`):
+
+- **Quellenverwaltung** – `create-source`, `update-source`, `delete-source`, `get-source`, `list-sources`, `sync-source`, `sync-due-sources`, `run-slack-pilot`, `test-slack-connection`
+- **Aufnahme erfassen** – `import-capture`, `import-transcript`, `list-captures`, `get-capture`, `mark-capture-distilled`, `resanitize-captures`
+- **Destillation** – `enqueue-distillation`, `enqueue-captures-distillation`, `claim-distillation`, `retry-distillation`, `list-distillation-queue`
+- **Wissen & Rezension** – `write-knowledge`, `get-knowledge`, `list-knowledge`, `set-knowledge-canonical`, `preview-canonical-resource`, `list-proposals`, `review-proposal`, `approve-proposal`, `reject-proposal`, `update-proposal`
+- **Suchen und Abrufen** – `ask-brain`, `search-knowledge`, `search-everything`
+- **Einstellungen** – `get-brain-settings`, `update-brain-settings`, `set-settings`, `get-settings`
+- **Evaluierung und Demo** – `seed-demo-data`, `run-demo-eval`, `run-retrieval-eval`
+- **Kontext und Navigation** – `view-screen`, `navigate`
+- **Anbieter APIs** – `provider-api-catalog`, `provider-api-docs`, `provider-api-request`
+
+### Quellen verbinden
+
+Brain löst zuerst Anbieteranmeldeinformationen von einer gewährten Workspace-Verbindung auf
+dann von abwärtskompatiblen Brain-lokalen oder registrierten Tresor-Anmeldeinformationen.
+Brain-Quellenanmeldeinformationen greifen nicht auf Umgebungsvariablen auf Bereitstellungsebene zurück.
+Wenn bereits ein gemeinsam genutzter Anbieter vorhanden ist, gewähren Sie Brain-Zugriff, anstatt ihn zu kopieren
+dasselbe Geheimnis in einer gehirnspezifischen Umgebung.
+
+**Slack.** Erstellen Sie eine Quelle, die auf bestimmte Kanal-IDs beschränkt ist. Der Stecker
+überprüft jede konfigurierte Konversation, lehnt DMs und MPIMs ab und speichert den Cursor
+-Status, sodass jede Synchronisierung dort fortgesetzt wird, wo die letzte gestoppt wurde. Ein sicherer Rollout-Ablauf am
+Mit jeder Slack-Quellkarte können Sie die Anmeldeinformationen und die Zulassungsliste **testen**, ohne
+Lesen Sie den Verlauf, führen Sie ein kleines begrenztes **Safe Pilot**-Beispiel aus, **Überprüfen Sie Aufnahmen**,
+und in der **Überprüfungswarteschlange** genehmigen, bevor etwas abfragbar wird. Gewähren Sie die
+bot nur die Bereiche, die die Quelle benötigt (Anmeldeinformationsvalidierung, Zulassungsliste
+Verifizierung, Kanalverlauf auf der Zulassungsliste und dauerhafte Permalinks).
+
+**Granola.** Erstellen Sie eine Quelle mit einem Abfragefenster und einer Seitengröße. Müsli
+Enterprise-API-Schlüssel machen Teamspace-Notizen verfügbar, keine privaten Notizen oder Ordner. Gehirn
+speichert die Notizzusammenfassung, das Transkript, die Teilnehmer, Kalendermetadaten und die Quelle
+URL als Roherfassung vor der Destillation.
+
+**GitHub.** Erstellen Sie eine Quelle, die auf genehmigte Repositorys beschränkt ist. Der Stecker
+importiert begrenzten Issue- und Pull-Request-Kontext mit stabilen Quell-URLs, die dies können
+wie Slack oder Besprechungskontext destilliert werden. Dies ist die Aufnahme von Brain-Kontext, nicht
+ein Ersatz für GitHub-Berichte im Analytics-Stil.
+
+**Clips und generisches webhooks.** Brain stellt einen signierten Webhook für Clips und
+generische Transkript-/Capture-Importe bei `/api/_agent-native/brain/ingest`. Erstellen
+eine Quelle mit einem `sourceKey`, um ein Inhabertoken zu empfangen, und sendet dann ein
+`RawCapturePayload` mit `Authorization: Bearer <ingestToken>`. Allgemeine Quellen
+verwenden Sie die gleiche Nutzlastform für Anrufprotokolle, Kundenrecherchen und importierte Daten
+Notizen oder jede andere Quelle, die eine begrenzte Erfassung erstellen kann.
+
+```an-api title="Signed ingest webhook" summary="Clips and generic transcript/capture imports post a RawCapturePayload with a per-source bearer token."
+{
+  "method": "POST",
+  "path": "/api/_agent-native/brain/ingest",
+  "summary": "Import a raw capture from Clips or a generic source",
+  "auth": "Bearer <ingestToken> issued per source via its sourceKey",
+  "request": {
+    "contentType": "application/json",
+    "example": "RawCapturePayload — bounded transcript / capture body"
+  },
+  "responses": [
+    { "status": "200", "description": "Capture accepted and queued for distillation" },
+    { "status": "401", "description": "Missing or invalid ingest bearer token" }
+  ]
+}
+```
+
+Slack, Granola, and GitHub sources can opt into background `autoSync` with a
+Umfragerhythmus, sobald die Qualität der Bewertung nachgewiesen ist.
+
+### Datenschutz und Gating
+
+Brain ist für das Unternehmensgedächtnis konzipiert, nicht für die persönliche Überwachung:
+
+- Slack sync liest nur explizit konfigurierte Kanäle und lehnt DMs/MPIMs ab.
+- Granola-Synchronisierung liest Teamspace-Notizen, die von Granolas API bereitgestellt werden, nicht privat
+  Notizen oder private Ordner.
+- Roherfassungen werden standardmäßig aus den Listen-/Suchoberflächen entfernt; Rezensenten
+  und Destillationsflüsse fordern nur bei Bedarf Vorschauen oder Rohinhalte an.
+- Quellkonfigurationen müssen möglicherweise überprüft werden, bevor destilliertes Wissen dauerhaft wird
+  Unternehmensgedächtnis.
+- Einstellungen steuern die Standardveröffentlichungsstufe, ob Kenntnisse auf Unternehmensebene erforderlich sind
+  Genehmigung, Zitieranforderungen, E-Mail-Schwärzung und Connector-Fehler
+  Benachrichtigungen.
+
+### Anpassen
+
+Brain folgt dem agentennativen Vier-Bereiche-Vertrag – Verhalten durch Bearbeiten ändern
+den passenden Bereich, und der Agent kann diese Änderungen für Sie vornehmen:
+
+- `templates/brain/app/routes/` – die UI-Oberfläche: Fragen, Suchen, Wissen,
+  Überprüfung, Quellen, Einstellungen und Teamrouten.
+- `templates/brain/actions/` – jede vom Agenten aufrufbare Operation (Importe, Quelle
+  Management, Pilotberichte, Destillation, Vorschlagsprüfung, zitierte Suche,
+  Navigation/Kontext). Fügen Sie eine neue Datei mit `defineAction` hinzu, um eine neue
+  Fähigkeit.
+- `templates/brain/.agents/skills/` – Gehirnspezifische Anleitung zur Destillation
+  und Abruf. Aktualisieren oder fügen Sie eine Fertigkeit hinzu, wenn Sie dem Agenten einen neuen Arbeitsablauf beibringen.
+- `templates/brain/AGENTS.md` – Leitfaden für Agenten der obersten Ebene. Aktualisieren Sie, wenn Sie Major hinzufügen
+  Funktionen.
+- `templates/brain/server/db/schema.ts` – Datenmodell. Nur additive Migrationen;
+  Routen, Filter und ausgewählte IDs werden in `application_state` für Agenten gespiegelt
+  Kontext.
+
+Bitten Sie den Agenten, Änderungen für Sie vorzunehmen – er kann seine eigene Quelle bearbeiten. Siehe
+[Self-Modifying Code](/docs/key-concepts#agent-modifies-code).
+
+## Was kommt als nächstes?
+
+- [**Dispatch**](/docs/dispatch) – die Arbeitsbereichssteuerungsebene
+- [**Dispatch template**](/docs/template-dispatch) – die gerüstete Koordinations-App
+- [**Workspace**](/docs/workspace) – gemeinsame Ressourcen über Apps hinweg
+- [**A2A Protocol**](/docs/a2a-protocol) – App-übergreifende Delegierung

package/docs/content/locales/de-DE/template-calendar.md

@@ -0,0 +1,194 @@
+---
+title: "Kalender"
+description: "Ein von Agenten betriebener Kalender mit Google Calendar-Synchronisierung und Buchungslinks im Calendly-Stil. Planen Sie, finden Sie Slots und verwalten Sie die Verfügbarkeit in einfachem Englisch."
+---
+
+# Kalender
+
+Eine von einem Agenten betriebene Kalender-App. Schließen Sie Ihr Google Calendar an und der Agent kann Ihren Zeitplan lesen, freie Slots finden, Veranstaltungen erstellen und Buchungslinks im Calendly-Stil verwalten – alles in einfachem Englisch. Es ersetzt die Google Calendar + Calendly-Kombination durch eine App, die Sie besitzen.
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;min-height:530px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px;padding:14px 18px;border-bottom:1.4px solid var(--wf-line)'><button>Week</button><button>Today</button><button>‹</button><button>›</button><div style='flex:1'></div><strong>May 3-9, 2026</strong><div style='flex:1'></div><button class='primary'>New Event</button></div><div style='display:grid;grid-template-columns:56px repeat(7,minmax(0,1fr));grid-template-rows:36px repeat(5,72px);gap:7px;padding:14px;flex:1'><div></div><strong>Sun 3</strong><strong>Mon 4</strong><strong>Tue 5</strong><strong>Wed 6</strong><strong>Thu 7</strong><strong>Fri 8</strong><strong>Sat 9</strong><small class='wf-muted'>7 AM</small><div class='wf-box' style='opacity:.45'></div><div></div><div></div><div></div><div></div><div></div><div></div><small class='wf-muted'>9 AM</small><div class='wf-box'>All-hands</div><div class='wf-box'>Eng standup</div><div class='wf-box'>Eng standup</div><div class='wf-box'>Eng standup</div><div></div><div class='wf-box'>Planning</div><div></div><small class='wf-muted'>11 AM</small><div class='wf-box'>Design review</div><div></div><div class='wf-box'>Design crit</div><div class='wf-box'>Roadmap</div><div class='wf-box'>Friday demo</div><div></div><div></div><small class='wf-muted'>1 PM</small><div></div><div class='wf-box'>1:1</div><div class='wf-box'>Focus block</div><div></div><div></div><div class='wf-box'>All-hands</div><div></div><small class='wf-muted'>3 PM</small><div></div><div></div><div></div><div class='wf-box'>Skip-level</div><div></div><div></div><div></div></div></div>"
+}
+```
+
+Wenn Sie die App öffnen, ist die aktive Kalenderansicht die primäre Oberfläche. Der Agent weiß immer noch, um welchen Tag, welche Woche oder welches Ereignis es sich handelt, sodass Sie sagen können: „Vereinbaren Sie an diesem Tag ein 30-minütiges Gespräch mit Alex“, ohne alles zu buchstabieren.
+
+```an-diagram title="How a scheduling request flows" summary="Whether you click in the calendar or ask the agent, the same actions read live from Google Calendar and write back to the same view."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">You click<br><small class=\"diagram-muted\">drag, toolbar, shortcuts</small></div><div class=\"diagram-node\">You ask the agent<br><small class=\"diagram-muted\">\"find a 1-hour slot next week\"</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\">list-events · check-availability · create-event</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Google Calendar<br><small class=\"diagram-muted\">live, multi-account</small></div><div class=\"diagram-box\">SQL<br><small class=\"diagram-muted\">bookings · availability</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">Calendar view updates live</div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## Was Sie damit machen können
+
+- **Sehen Sie Ihr echtes Google Calendar** in der Tages-, Wochen- oder Monatsansicht mit mehreren überlagerten Konten.
+- **Abonnieren Sie ICS-Feeds** (Freistellung in der Personalabteilung, Konferenzpläne, Teamkalender) – schreibgeschützt, gemischt in derselben Ansicht.
+- **Legen Sie die wöchentliche Verfügbarkeit fest** mit Zeitzonenunterstützung – der Agent verwendet dies, wenn er freie Slots findet.
+- **Erstellen Sie öffentliche Buchungslinks** bei `/book/{slug}` für Dinge wie „15-minütige Einführung“ oder „30-minütige Demo“. Konfigurieren Sie Dauer, benutzerdefinierte Felder und das zu verwendende Konferenztool.
+- **Fragen Sie den Agenten nach Terminen**: „Habe ich Donnerstagnachmittag Zeit?“ „Suchen Sie sich nächste Woche einen einstündigen Slot und platzieren Sie dort ‚Planning with Alex‘.“ „Link zur Demo-Buchung pausieren.“
+- **Teilen Sie Buchungslinks** mit Teamkollegen, damit diese diese auch verwalten können.
+
+## Erste Schritte
+
+Live-Demo: [calendar.agent-native.com](https://calendar.agent-native.com).
+
+Wenn Sie die App zum ersten Mal öffnen:
+
+1. Klicken Sie auf **Einstellungen**.
+2. Klicken Sie auf **Google Calendar verbinden** und genehmigen Sie.
+3. (Optional) Verbinden Sie weitere Google-Konten, wenn Sie möchten, dass private und geschäftliche Konten überlagert werden.
+4. Öffnen Sie die Hauptansicht – Ihr echter Kalender wird geladen.
+
+So erstellen Sie Ihren ersten Buchungslink:
+
+1. Klicken Sie in der Seitenleiste auf **Buchungslinks**.
+2. Klicken Sie auf **Neuer Buchungslink** und legen Sie einen Titel und eine Dauer fest.
+3. Teilen Sie die Öffentlichkeit URL – Besucher wählen aus Ihren verfügbaren Slots.
+
+Oder fragen Sie einfach den Agenten: „Erstellen Sie einen 15-minütigen Einführungsbuchungslink mit einem Namensfeld.“
+
+### Nützliche Eingabeaufforderungen
+
+- „Was steht heute in meinem Kalender?“
+- „Habe ich am Donnerstagnachmittag 30 Minuten Zeit?“
+- „Suchen Sie sich nächste Woche einen einstündigen Slot und platzieren Sie dort ‚Planning with Alex‘.“
+- "Verschieben Sie diese Veranstaltung auf Freitag um 14:00 Uhr." (wenn ein Ereignis ausgewählt ist)
+- „Zur Tagesansicht wechseln und zum nächsten Montag springen.“
+- „Erstellen Sie einen Buchungslink mit dem Namen „15-Minuten-Einführung“ bei 15 Minuten mit einem Notizfeld.“
+- „Meinen Buchungslink „30-Minuten-Demo“ pausieren.“
+- „Freitagnachmittage je nach Verfügbarkeit blockieren.“
+- „Welche Besprechungen habe ich diesen Monat zum Thema „Launch“?“
+
+Der Agent fragt Google Calendar live bei jeder Terminfrage ab – er rät nie.
+
+## Für Entwickler
+
+Der Rest dieses Dokuments richtet sich an alle, die die Kalendervorlage verzweigen oder erweitern.
+
+### Schnellstart
+
+Erstellen Sie einen neuen Arbeitsbereich mit der Kalendervorlage:
+
+```bash
+npx @agent-native/core@latest create my-app --standalone --template calendar
+cd my-app
+pnpm install
+pnpm dev
+```
+
+Öffnen Sie `http://localhost:8082` (den standardmäßigen Kalender-Entwicklungsport).
+
+Um Google Calendar in Dev zu verbinden, öffnen Sie die Einstellungsansicht, fügen Sie einen `GOOGLE_CLIENT_ID` und einen `GOOGLE_CLIENT_SECRET` aus [Google Cloud Console](https://console.cloud.google.com/) ein und klicken Sie auf „Google Calendar verbinden“. Die OAuth-Umleitung URI ist `http://localhost:8082/_agent-native/google/callback` in der Entwicklung. Token werden in der Tabelle `oauth_tokens` SQL gespeichert und automatisch aktualisiert.
+
+### Hauptfunktionen
+
+**Live-Kalenderansichten.** Tages-, Wochen- und Monatsansichten, die direkt von verbundenen Google-Konten gelesen werden, mit optionalen schreibgeschützten ICS-Feeds, die in denselben Zeitplan eingebunden sind.
+
+**Verfügbarkeit und Suche nach freien Plätzen.** Wöchentliche Verfügbarkeitsregeln, Zeitzonenunterstützung und vorhandene Ereignisse füttern alle die gleiche Verfügbarkeitsaktion, die UI und der Agent verwenden.
+
+**Buchungslinks.** Auf öffentlichen `/book/{slug}`-Seiten werden Name, E-Mail, benutzerdefinierte Felder, Konferenzeinstellungen und Stornierungs-/Verschiebungstokens erfasst.
+
+**Gemeinsame Verwaltung.** Buchungslinks sind standardmäßig privat, können aber über das Framework-Sharing actions mit Teamkollegen geteilt werden.
+
+**Inline-Ereignisvorschauen.** Der Agent kann kompakte Ereigniskarten mit Titel, Zeit, Ort, Teilnehmern und einer Zurück-Schaltfläche in den Chat einbetten.
+
+### Zusammenarbeit mit dem Agenten
+
+Der Agent sieht, was Sie sehen. Die aktuelle Kalenderansicht, das ausgewählte Datum und das ausgewählte Ereignis sind in jeder Nachricht als `current-screen`-Block enthalten, sodass Sie „dieses Ereignis“ oder „diesen Tag“ sagen können und es korrekt aufgelöst wird.
+
+Unter der Haube nennt der Agent actions wie `list-events`, `check-availability`, `create-event`, `navigate` und `update-availability`. Da Ereignisse in Google Calendar gespeichert sind, fragt der Agent immer API ab, anstatt zu raten – er gibt keine leeren Ergebnisse zurück, ohne vorher ein Skript auszuführen.
+
+### Datenmodell
+
+Definiert in `templates/calendar/server/db/schema.ts`. Nur Nicht-Ereignisdaten werden lokal gespeichert:
+
+- `bookings` – bestätigte Termine von öffentlichen Buchungsseiten. Speichert Name, E-Mail, Anfang, Ende, Slug, optionale Notizen, benutzerdefinierte Feldantworten, Besprechungslink, einen `cancelToken` für die öffentliche Verwaltung URL und einen `confirmed`- oder `cancelled`-Status.
+- `booking_links` – die Linkdefinitionen im Calendly-Stil. Slug, Titel, Beschreibung, primäres `duration`, optionale `durations`-Liste, `customFields`, `conferencing`, `color` und ein `isActive`-Flag. Verwendet `ownableColumns` des Frameworks, sodass das Freigabesystem gilt.
+- `booking_slug_redirects` – erinnert sich an alte Slugs, wenn ein Link umbenannt wird, sodass bestehende öffentliche URLs weiterhin funktionieren.
+- `booking_link_shares` – Anteilszuschüsse für Buchungslinks.
+
+```an-schema title="Calendar data model" summary="Only non-event data is stored locally — events live in Google Calendar. Booking links use ownableColumns so the sharing system applies."
+{
+  "entities": [
+    {
+      "id": "booking_links",
+      "name": "booking_links",
+      "note": "Calendly-style link definitions (ownable)",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "slug", "type": "string", "note": "public page at /book/{slug}" },
+        { "name": "title", "type": "string" },
+        { "name": "description", "type": "string", "nullable": true },
+        { "name": "duration", "type": "int", "note": "primary duration in minutes" },
+        { "name": "durations", "type": "json", "nullable": true, "note": "alternative durations" },
+        { "name": "customFields", "type": "json", "nullable": true },
+        { "name": "conferencing", "type": "string", "note": "Google Meet / Zoom / custom" },
+        { "name": "color", "type": "string", "nullable": true },
+        { "name": "isActive", "type": "bool", "note": "pause without deleting" }
+      ]
+    },
+    {
+      "id": "bookings",
+      "name": "bookings",
+      "note": "Confirmed appointments from public booking pages",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "slug", "type": "string", "fk": "booking_links.slug" },
+        { "name": "name", "type": "string" },
+        { "name": "email", "type": "string" },
+        { "name": "start", "type": "datetime" },
+        { "name": "end", "type": "datetime" },
+        { "name": "notes", "type": "string", "nullable": true },
+        { "name": "customFields", "type": "json", "nullable": true, "note": "custom field responses" },
+        { "name": "meetingLink", "type": "string", "nullable": true },
+        { "name": "cancelToken", "type": "string", "note": "powers /booking/manage/{token}" },
+        { "name": "status", "type": "enum", "note": "confirmed | cancelled" }
+      ]
+    },
+    {
+      "id": "booking_slug_redirects",
+      "name": "booking_slug_redirects",
+      "note": "Keeps old public URLs working after a link is renamed",
+      "fields": [
+        { "name": "oldSlug", "type": "string", "pk": true },
+        { "name": "linkId", "type": "id", "fk": "booking_links.id" }
+      ]
+    },
+    {
+      "id": "booking_link_shares",
+      "name": "booking_link_shares",
+      "note": "Share grants for booking links",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "linkId", "type": "id", "fk": "booking_links.id" },
+        { "name": "principal", "type": "string", "note": "user or org" },
+        { "name": "role", "type": "enum", "note": "viewer | editor | admin" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "booking_links", "to": "bookings", "kind": "1-n", "label": "has bookings" },
+    { "from": "booking_links", "to": "booking_slug_redirects", "kind": "1-n", "label": "has old slugs" },
+    { "from": "booking_links", "to": "booking_link_shares", "kind": "1-n", "label": "has share grants" }
+  ]
+}
+```
+
+Verfügbarkeitsregeln und Konfiguration pro Benutzer sind in der Einstellungstabelle verfügbar, verschlüsselt durch `calendar-availability`. Google OAuth-Tokens befinden sich in der Framework-`oauth_tokens`-Tabelle. Der kurzlebige UI-Status (aktuelle Ansicht, Datum, ausgewähltes Ereignis) befindet sich in `application_state` unter dem Schlüssel `navigation`.
+
+### Anpassen
+
+Jeder Teil der App ist eine bearbeitbare Quelle. Beginnen Sie hier:
+
+- `templates/calendar/actions/` – jede vom Agenten aufrufbare Operation. Fügen Sie eine neue Datei mit `defineAction` hinzu, um neue Funktionen sowohl für den Agenten als auch für das Frontend verfügbar zu machen. Schlüsseldateien: `check-availability.ts`, `create-event.ts`, `list-events.ts`, `create-booking-link.ts`, `update-availability.ts`, `add-external-calendar.ts`, `navigate.ts`, `view-screen.ts`.
+- `templates/calendar/app/routes/` – der UI. `_app._index.tsx` ist der Kalender, `_app.availability.tsx` ist der Zeitplaneditor, `_app.booking-links._index.tsx` und `_app.booking-links.$id.tsx` verwalten Buchungslinks, `_app.bookings.tsx` listet Buchungen auf, `_app.settings.tsx` sind Einstellungen und `book.$slug.tsx` plus `meet.$username.$slug.tsx` sind die öffentlichen Buchungsseiten.
+- `templates/calendar/server/db/schema.ts` – Spalten oder Tabellen mit Drizzle hinzufügen. Halten Sie den Code dialektunabhängig, damit die Vorlage auf SQLite, Postgres, Turso, D1 und Neon läuft.
+- `templates/calendar/AGENTS.md` – Agentenanweisungen. Aktualisieren Sie dies, wenn Sie dem Agenten neue Fähigkeiten oder Konventionen beibringen.
+- `templates/calendar/.agents/skills/` – detaillierte Muster, denen der Agent folgt. Relevante skills: `event-management`, `availability-booking`, `real-time-sync`, `storing-data`, `delegate-to-agent`, `frontend-design`.
+- `templates/calendar/shared/api.ts` – die gemeinsam genutzten TypeScript-Typen (`AvailabilityConfig`, `BookingLink`, `ExternalCalendar` usw.), die sowohl vom Server als auch vom Client verwendet werden.
+
+Wenn Sie eine Funktion hinzufügen, denken Sie daran, alle vier Bereiche zu aktualisieren: UI, Aktion, Skill oder AGENTS.md-Eintrag und alle Anwendungsstatus, die der Agent sehen muss. Das ist es, was den Agenten und den UI in Parität hält.