@agent-native/core 0.76.5 → 0.76.6

package/docs/content/locales/fr-FR/template-brain.md

@@ -0,0 +1,324 @@
+---
+title: "Cerveau"
+description: "Un chat d'entreprise propre soutenu par une mémoire institutionnelle citée, une ingestion de sources révisables et des intégrations d'espaces de travail réutilisables."
+---
+
+# Cerveau
+
+Brain est un chat d'entreprise propre soutenu par la mémoire institutionnelle citée. Les gens demandent
+questions en anglais simple ; Réponses cérébrales issues des connaissances approuvées de l'entreprise avec
+liens vers le fil de discussion, la réunion, la transcription, le problème ou la capture de webhook Slack
+qui soutient la réponse.
+
+Le cerveau ingère les chaînes Slack approuvées, les enregistrements de clips et l'espace Granola Team
+notes, problèmes/PR GitHub et charges utiles génériques de transcription/webhook. Il stocke brut
+capture, distille des faits/décisions/processus durables et achemine les informations sensibles ou
+Les souvenirs peu fiables sont examinés avant qu'ils ne deviennent des connaissances de l'entreprise.
+
+La surface du produit reste volontairement simple : **Ask** est le chat principal
+expérience, tandis que **Sources**, **Review** et **Knowledge** sont administrateur/support
+surfaces permettant de connecter les données, d'approuver les propositions et d'inspecter la mémoire citée.
+
+```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>"
+}
+```
+
+Lorsque vous ouvrez l'application, **Ask** est au premier plan : une conversation claire et révisée
+mémoire de l'entreprise. **Sources**, **Review** et **Knowledge** se trouvent à côté de lui comme
+interfaces d'administration permettant de connecter les données, d'approuver les propositions et d'inspecter les données citées
+entrées.
+
+## Quand le choisir
+
+Utilisez Brain lorsque votre équipe souhaite que les agents répondent à des questions telles que "Pourquoi avons-nous créé
+cette décision concernant le produit ?", "Comment fonctionne cette fonctionnalité en développement ?" ou "quoi
+a changé au cours de ce processus ? » avec des liens vers la conversation source, la réunion,
+ou problème.
+
+Brain et Dispatch sont complémentaires mais font des tâches différentes :
+
+- **Brain possède la mémoire de l'entreprise.** Il ingère les sources, examine les captures brutes,
+  distille des faits/décisions/processus durables, des réponses à partir de preuves citées, et
+  expose les connaissances approuvées aux agents.
+- **Dispatch est propriétaire du plan de contrôle de l'espace de travail.** Il centralise la messagerie,
+  secrets, tâches récurrentes, approbations, orchestration A2A et distribution
+  et approbation des ressources à l'échelle de l'espace de travail.
+
+Dans un espace de travail multi-applications, Dispatch peut acheminer une question vers Brain via A2A et
+peut accorder les informations d'identification du fournisseur partagé Brain. Brain reste le spécialiste des
+Ingestion, examen, récupération de sources approuvées et réponses citées de Company Brain.
+Brain expose la récupération en lecture seule basée sur des citations en tant que capacité publique A2A
+afin que les applications Dispatch et sœurs puissent poser des questions à la mémoire de l'entreprise – l'agent A2A
+la carte est une métadonnée de découverte publique, tandis que la récupération se produit toujours dans Brain's
+surface d'action authentifiée.
+
+## Ce que vous pouvez en faire
+
+- **Posez les questions citées.** Poser est la surface principale du produit : une discussion claire terminée
+  Mémoire de l'entreprise examinée, avec état de la source, nombre d'avis et suggestions
+  questions restées secondaires. Chaque réponse renvoie au fil de discussion Slack,
+  réunion, problème ou capture qui le prend en charge.
+- **Connectez les sources approuvées.** Configurez le manuel, le webhook générique, les clips, Slack,
+  Sources Granola et GitHub. Les sources sont partagées par l'organisation par défaut, donc l'entreprise
+  la mémoire est utile à tout l'espace de travail.
+- **Révisez avant de publier.** Les souvenirs proposés bénéficient d'un itinéraire de révision de première classe
+  où les réviseurs modifient le libellé, inspectent les liens vers les preuves/sources et approuvent ou
+  rejeter. Les entrées hautement fiables et non sensibles peuvent être publiées immédiatement ;
+  Les entrées sensibles ou au niveau de l'entreprise sont mises en file d'attente en tant que propositions.
+- **Inspectez les connaissances citées.** L'itinéraire des connaissances montre des connaissances distillées et atomiques
+  entrées avec type, sujet, entités, confiance, citations de preuves exactes et
+  remplacer les liens.
+- **Réutilisez les intégrations de l'espace de travail.** Les sources cérébrales peuvent réutiliser l'espace de travail partagé
+  octrois de connexion au lieu de ressaisir les jetons du fournisseur. La page Sources
+  affiche les enregistrements source Brain à côté des autorisations de connexion réutilisables et du fournisseur
+  préparation.
+- **Mémoire approuvée par miroir comme contexte ambiant.**Les entrées canoniques approuvées peuvent
+  miroir sur les ressources de l'espace de travail sous `context/company-brain/...` donc autre
+  les applications peuvent les utiliser comme contexte. Les deux flux prévisualisent le Markdown exact avant le
+  la ressource est écrite ou supprimée.
+
+## Démarrer
+
+Démo en direct : [brain.agent-native.com](https://brain.agent-native.com).
+
+1. **Essayez la démo.** Ouvrez Ask et choisissez **Démarrer la démo**. Le cerveau engendre un petit
+   corpus de décision produit, exécute les contrôles de confiance et pose une question citée ainsi
+   vous pouvez voir les réponses, les citations, les avis et les comportements introuvables avant d'ajouter
+   données réelles de l'entreprise.
+2. **Ajoutez une source.** Commencez avec une seule chaîne Slack, Granola Team-space
+   flux, référentiel GitHub, exportation de clips ou webhook de transcription générique. Conserver
+   la portée est réduite jusqu'à ce que les citations et la qualité des critiques semblent correctes.
+3. **Révisez avant de publier.** Utilisez Révision pour inspecter les preuves, modifier le libellé,
+   et approuvez uniquement la mémoire durable de l'entreprise.
+4. **Demandez à la source.** Utilisez Demandez des questions qui doivent être fondées
+   connaissances approuvées, pas de journaux de discussion bruts.
+
+Pour une démonstration publique, le corpus prédéfini démontre le rappel de décision de produit,
+liens de citation, comportement de remplacement, contrôle des avis, rédaction, contenu personnel
+exclusion et comportement honnête introuvable sans connexion à un véritable espace de travail.
+
+### Invites utiles
+
+- "Qu'avons-nous décidé concernant la tarification annuelle, et où en a-t-on discuté ?"
+- "Recherchez la modification la plus récente du processus d'intégration et citez la source."
+- "Résumez ce que cette discussion sur GitHub signifie pour le plan de lancement."
+- "Examinez les propositions de mémoire en attente et signalez tout ce qui est trop vague pour être publié."
+- "Quelles sources sont obsolètes ou la synchronisation échoue ?"
+
+## Pour les développeurs
+
+Le reste de ce document s'adresse à toute personne qui crée ou étend le modèle Brain.
+
+### Démarrage rapide
+
+```bash
+npx @agent-native/core@latest create my-brain --standalone --template brain
+cd my-brain
+pnpm install
+pnpm dev
+```
+
+Ouvrez l'application et choisissez **Démarrer la démo** pour voir la mémoire citée sans connecter un espace de travail réel.
+
+### Modèle de données
+
+Brain utilise intentionnellement la recherche de texte SQL et l'expansion des requêtes agentiques – il y en a
+aucune exigence de base de données vectorielles, le modèle reste donc portable sur SQLite,
+Postgres, Neon, D1, Turso et hôtes similaires. L'état de l'application reflète le
+itinéraire actuel, filtres et ID sélectionnés afin que l'agent connaisse toujours l'itinéraire actuel
+navigation et sélection.
+
+Le schéma du cerveau réside dans `templates/brain/server/db/schema.ts`. Huit tableaux :
+
+| Tableau                  | Ce qu'il contient                                                                                                                                                               |
+| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `brain_sources`          | Configuration du connecteur : fournisseur, canaux/dépôts sur liste autorisée, curseurs de synchronisation, posture de révision, `ingest_token_hash`, `status`, `last_synced_at` |
+| `brain_source_shares`    | Attributions de partage par source (spectateur/éditeur/administrateur)                                                                                                          |
+| `brain_raw_captures`     | Transcriptions, exportations de canaux, notes et importations de webhooks avec clé de déduplication `external_id`, `content_hash`, type et état de distillation                 |
+| `brain_knowledge`        | Entrées atomiques distillées – genre (décision/fait/processus/…), sujet, entités, citations de preuves, confiance, `publish_tier`, liens de remplacement                        |
+| `brain_knowledge_shares` | Subventions par partage de connaissances                                                                                                                                        |
+| `brain_proposals`        | Éléments d'examen en attente – proposition de création/mise à jour/archive avec preuves et notes du réviseur                                                                    |
+| `brain_proposal_shares`  | Attribution d'actions par proposition                                                                                                                                           |
+| `brain_sync_runs`        | Journal d'audit de synchronisation : fournisseur, statut, statistiques JSON, erreur, horodatages de début/fin                                                                   |
+| `brain_ingest_queue`     | File d'attente de distillation en arrière-plan : opération, état, priorité, nombre de tentatives, `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" }
+  ]
+}
+```
+
+### Clé actions
+
+Regroupés par zone (`templates/brain/actions/`) :
+
+- **Gestion des sources** — `create-source`, `update-source`, `delete-source`, `get-source`, `list-sources`, `sync-source`, `sync-due-sources`, `run-slack-pilot`, `test-slack-connection`
+- **Ingestion de capture** – `import-capture`, `import-transcript`, `list-captures`, `get-capture`, `mark-capture-distilled`, `resanitize-captures`
+- **Distillation** — `enqueue-distillation`, `enqueue-captures-distillation`, `claim-distillation`, `retry-distillation`, `list-distillation-queue`
+- **Connaissances et avis** — `write-knowledge`, `get-knowledge`, `list-knowledge`, `set-knowledge-canonical`, `preview-canonical-resource`, `list-proposals`, `review-proposal`, `approve-proposal`, `reject-proposal`, `update-proposal`
+- **Recherche et récupération** — `ask-brain`, `search-knowledge`, `search-everything`
+- **Paramètres** — `get-brain-settings`, `update-brain-settings`, `set-settings`, `get-settings`
+- **Évaluation et démo** — `seed-demo-data`, `run-demo-eval`, `run-retrieval-eval`
+- **Contexte et navigation** — `view-screen`, `navigate`
+- **Fournisseur APIs** — `provider-api-catalog`, `provider-api-docs`, `provider-api-request`
+
+### Connexion des sources
+
+Brain résout d'abord les informations d'identification du fournisseur à partir d'une connexion à un espace de travail accordée
+puis à partir d'informations d'identification Brain-local ou de coffre-fort enregistrées rétrocompatibles.
+Les informations d'identification de la source Brain ne dépendent pas des variables d'environnement au niveau du déploiement.
+Si un fournisseur partagé existe déjà, accordez l'accès à Brain au lieu de copier le
+même secret dans un paramètre spécifique au cerveau.
+
+**Slack.** Créez une source limitée à des ID de canal spécifiques. Le connecteur
+vérifie chaque conversation configurée, rejette les DM et MPIM et stocke le curseur
+état afin que chaque synchronisation reprenne là où la dernière s'est arrêtée. Un flux de déploiement sécurisé sur
+chaque carte source Slack vous permet de **Tester** les informations d'identification et la liste d'autorisation sans
+lecture de l'historique, exécution d'un petit échantillon **Safe pilot** plafonné, **Examen des captures**,
+et approuvez dans la **file d'attente de révision** avant que quoi que ce soit ne devienne interrogeable. Accorde le
+botez uniquement les étendues dont la source a besoin (validation des informations d'identification, liste verte
+vérification, historique des chaînes sur liste blanche et permaliens durables).
+
+**Granola.** Créez une source avec une fenêtre d'interrogation et une taille de page. Granola
+Les clés Enterprise API exposent les notes de l’espace d’équipe, et non les notes ou dossiers privés. Cerveau
+stocke le résumé des notes, la transcription, les participants, les métadonnées du calendrier et la source
+URL comme capture brute avant distillation.
+
+**GitHub.** Créez une source étendue aux référentiels approuvés. Le connecteur
+importe le contexte de problème limité et de demande d'extraction avec des sources stables URL qui peuvent
+être distillé comme Slack ou un contexte de réunion. Il s'agit d'une ingestion de contexte cérébral, pas
+un remplacement pour les rapports GitHub de style Analytics.
+
+**Clips et webhooks générique.** Brain expose un webhook signé pour les clips et
+importations de transcriptions/captures génériques sur `/api/_agent-native/brain/ingest`. Créer
+une source avec un `sourceKey` pour recevoir un jeton de porteur, puis envoyer un
+`RawCapturePayload` avec `Authorization: Bearer <ingestToken>`. Sources génériques
+utiliser la même forme de charge utile pour les transcriptions d'appels, la recherche client, importées
+notes, ou toute autre source pouvant produire une capture limitée.
+
+```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" }
+  ]
+}
+```
+
+Les sources Slack, Granola et GitHub peuvent activer `autoSync` en arrière-plan avec un
+cadence d'interrogation une fois la qualité des avis prouvée.
+
+### Confidentialité et contrôle
+
+Le cerveau est conçu pour la mémoire de l'entreprise, pas pour la surveillance personnelle :
+
+- La synchronisation Slack lit uniquement les canaux explicitement configurés et rejette les DM/MPIM.
+- La synchronisation Granola lit les notes de l'espace d'équipe exposées par le API de Granola, non privées
+  notes ou dossiers privés.
+- Les captures brutes sont supprimées des surfaces de liste/de recherche par défaut ; réviseurs
+  et les flux de distillation demandent des aperçus ou du contenu brut uniquement lorsque cela est nécessaire.
+- Les configurations sources peuvent nécessiter un examen avant que les connaissances distillées ne deviennent durables
+  mémoire de l'entreprise.
+- Les paramètres contrôlent le niveau de publication par défaut, si les connaissances au niveau de l'entreprise l'exigent
+  approbation, exigences de citation, rédaction d'e-mails et erreur de connecteur
+  notifications.
+
+### Le personnaliser
+
+Le cerveau suit le contrat à quatre domaines natif de l'agent – changez le comportement en modifiant
+la zone correspondante, et l'agent peut effectuer ces modifications pour vous :
+
+- `templates/brain/app/routes/` — la surface UI : demander, rechercher, connaissances,
+  Révision, sources, paramètres et itinéraires d'équipe.
+- `templates/brain/actions/` — chaque opération appelable par un agent (importations, source
+  gestion, rapports pilotes, distillation, examen des propositions, recherche citée,
+  navigation/contexte). Ajoutez un nouveau fichier avec `defineAction` pour exposer un nouveau
+  capacité.
+- `templates/brain/.agents/skills/` — Conseils spécifiques au cerveau pour la distillation
+  et récupération. Mettez à jour ou ajoutez une compétence lorsque vous enseignez à l'agent un nouveau flux de travail.
+- `templates/brain/AGENTS.md` : guide de l'agent de niveau supérieur. Mettez à jour lorsque vous ajoutez un majeur
+  fonctionnalités.
+- `templates/brain/server/db/schema.ts` — modèle de données. Migrations additives uniquement ;
+  l'itinéraire, les filtres et les ID sélectionnés sont mis en miroir dans `application_state` pour l'agent
+  contexte.
+
+Demandez à l'agent d'apporter des modifications à votre place : il peut modifier sa propre source. Voir
+[Self-Modifying Code](/docs/key-concepts#agent-modifies-code).
+
+## Quelle est la prochaine étape
+
+- [**Dispatch**](/docs/dispatch) — le plan de contrôle de l'espace de travail
+- [**Dispatch template**](/docs/template-dispatch) — l'application de coordination d'échafaudage
+- [**Workspace**](/docs/workspace) – ressources partagées entre les applications
+- [**A2A Protocol**](/docs/a2a-protocol) – délégation inter-applications

package/docs/content/locales/fr-FR/template-calendar.md

@@ -0,0 +1,194 @@
+---
+title: "Calendrier"
+description: "Un calendrier alimenté par un agent avec synchronisation Google Calendar et liens de réservation de style Calendly. Planifiez, trouvez des créneaux horaires et gérez la disponibilité grâce à un anglais simple."
+---
+
+# Calendrier
+
+Une application de calendrier alimentée par un agent. Connectez votre Google Calendar et l'agent peut lire votre emploi du temps, trouver des créneaux libres, créer des événements et gérer les liens de réservation de style Calendly, le tout dans un anglais simple. Il remplace le combo Google Calendar + Calendly par une application que vous possédez.
+
+```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>"
+}
+```
+
+Lorsque vous ouvrez l'application, la vue active du calendrier constitue la surface principale. L'agent sait toujours quel jour, semaine ou événement vous consultez, vous pouvez donc dire « planifier un appel de 30 minutes avec Alex ce jour-là » sans tout préciser.
+
+```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}"
+}
+```
+
+## Ce que vous pouvez en faire
+
+- **Voir votre véritable Google Calendar** en mode jour, semaine ou mois, avec plusieurs comptes superposés.
+- **Abonnez-vous aux flux ICS** (congés RH, horaires de conférence, calendriers d'équipe) – en lecture seule, mélangés dans la même vue.
+- **Définir la disponibilité hebdomadaire** avec prise en charge du fuseau horaire : l'agent l'utilise pour trouver des créneaux libres.
+- **Créez des liens de réservation publics** sur `/book/{slug}` pour des éléments tels que "Intro de 15 minutes" ou "Démo de 30 minutes". Configurez les durées, les champs personnalisés et l'outil de conférence à utiliser.
+- **Demandez à l'agent tout ce qui concerne l'horaire** : "Suis-je libre jeudi après-midi ?" "Trouvez un créneau d'une heure la semaine prochaine et inscrivez-y 'Planification avec Alex'." "Suspendre mon lien de réservation de démo."
+- **Partagez les liens de réservation** avec vos coéquipiers afin qu'ils puissent également les gérer.
+
+## Démarrer
+
+Démo en direct : [calendar.agent-native.com](https://calendar.agent-native.com).
+
+Lorsque vous ouvrez l'application pour la première fois :
+
+1. Cliquez sur **Paramètres**.
+2. Cliquez sur **Connecter Google Calendar** et approuvez.
+3. (Facultatif) Connectez davantage de comptes Google si vous souhaitez superposer vos comptes personnels et professionnels.
+4. Ouvrez la vue principale : votre véritable calendrier se chargera.
+
+Pour créer votre premier lien de réservation :
+
+1. Cliquez sur **Liens de réservation** dans la barre latérale.
+2. Cliquez sur **Nouveau lien de réservation**, définissez un titre et une durée.
+3. Partagez le URL public : les visiteurs choisissent parmi vos emplacements disponibles.
+
+Ou demandez simplement à l'agent : "Créez un lien de réservation d'introduction de 15 minutes avec un champ de nom."
+
+### Invites utiles
+
+- "Qu'y a-t-il sur mon agenda aujourd'hui ?"
+- "Suis-je libre jeudi après-midi pendant 30 minutes ?"
+- "Trouvez un créneau d'une heure la semaine prochaine et inscrivez-y "Planification avec Alex"."
+- "Reprogrammer cet événement au vendredi à 14h." (lorsqu'un événement est sélectionné)
+- "Passer à l'affichage quotidien et passer au lundi suivant."
+- "Créez un lien de réservation appelé "Intro de 15 min" à 15 minutes avec un champ de note."
+- "Suspendre mon lien de réservation 'Démo de 30 minutes'."
+- "Bloquer les vendredis après-midi selon mes disponibilités."
+- "Quelles réunions ai-je à propos du "lancement" ce mois-ci ?"
+
+L'agent interrogera Google Calendar en direct pour toute question de planning ; il ne devine jamais.
+
+## Pour les développeurs
+
+Le reste de ce document s'adresse à toute personne qui crée le modèle de calendrier ou l'étend.
+
+### Démarrage rapide
+
+Créez un nouvel espace de travail avec le modèle de calendrier :
+
+```bash
+npx @agent-native/core@latest create my-app --standalone --template calendar
+cd my-app
+pnpm install
+pnpm dev
+```
+
+Ouvrez `http://localhost:8082` (le port de développement du calendrier par défaut).
+
+Pour connecter Google Calendar en développement, ouvrez la vue Paramètres, collez un `GOOGLE_CLIENT_ID` et un `GOOGLE_CLIENT_SECRET` à partir de [Google Cloud Console](https://console.cloud.google.com/), puis cliquez sur « Connecter Google Calendar ». La redirection OAuth URI est `http://localhost:8082/_agent-native/google/callback` en développement. Les jetons sont stockés dans la table `oauth_tokens` SQL et s'actualisent automatiquement.
+
+### Fonctionnalités clés
+
+**Vues du calendrier en direct.** Les vues du jour, de la semaine et du mois sont lues directement à partir des comptes Google connectés, avec des flux ICS en lecture seule facultatifs superposés dans le même calendrier.
+
+**Disponibilité et recherche d'emplacements libres.** Les règles de disponibilité hebdomadaires, la prise en charge des fuseaux horaires et les événements existants alimentent tous la même action de disponibilité utilisée par le UI et l'agent.
+
+**Liens de réservation.** Les pages publiques `/book/{slug}` collectent le nom, l'adresse e-mail, les champs personnalisés, les préférences de conférence et les jetons d'annulation/reprogrammation.
+
+**Gestion partageable.** Les liens de réservation sont privés par défaut, mais peuvent être partagés avec des coéquipiers via le framework de partage actions.
+
+**Aperçus d'événements en ligne.** L'agent peut intégrer des cartes d'événements compactes dans le chat avec le titre, l'heure, le lieu, les participants et un bouton de retour en arrière.
+
+### Travailler avec l'agent
+
+L'agent voit ce que vous regardez. La vue actuelle du calendrier, la date sélectionnée et l'événement sélectionné sont inclus dans chaque message sous forme de bloc `current-screen`, vous pouvez donc dire « cet événement » ou « ce jour » et cela se résoudra correctement.
+
+Sous le capot, l'agent appelle actions comme `list-events`, `check-availability`, `create-event`, `navigate` et `update-availability`. Étant donné que les événements se trouvent dans Google Calendar, l'agent interroge toujours le API au lieu de deviner : il ne renverra pas de résultats vides sans exécuter au préalable un script.
+
+### Modèle de données
+
+Défini dans `templates/calendar/server/db/schema.ts`. Seules les données non événementielles sont stockées localement :
+
+- `bookings` : rendez-vous confirmés à partir des pages de réservation publiques. Stocke le nom, l'e-mail, le début, la fin, le slug, les notes facultatives, les réponses aux champs personnalisés, le lien de réunion, un `cancelToken` pour le public, gérer URL et un statut `confirmed` ou `cancelled`.
+- `booking_links` — les définitions de liens de style Calendly. Slug, titre, description, `duration` principal, liste `durations` facultative, `customFields`, `conferencing`, `color` et un indicateur `isActive`. Utilise le `ownableColumns` du framework pour que le système de partage s'applique.
+- `booking_slug_redirects` : mémorise les anciens slugs lorsqu'un lien est renommé afin que les URL publics existants continuent de fonctionner.
+- `booking_link_shares` – partager les subventions pour les liens de réservation.
+
+```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" }
+  ]
+}
+```
+
+Les règles de disponibilité et la configuration par utilisateur se trouvent dans le tableau des paramètres, saisis par `calendar-availability`. Les jetons Google OAuth résident dans la table framework `oauth_tokens`. L'état éphémère UI (vue actuelle, date, événement sélectionné) réside dans `application_state` sous la clé `navigation`.
+
+### Le personnaliser
+
+Chaque partie de l'application est une source modifiable. Commencez ici :
+
+- `templates/calendar/actions/` : chaque opération appelable par un agent. Ajoutez un nouveau fichier avec `defineAction` pour exposer de nouvelles fonctionnalités à la fois à l'agent et au frontend. Fichiers clés : `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/` — le UI. `_app._index.tsx` est le calendrier, `_app.availability.tsx` est l'éditeur de planning, `_app.booking-links._index.tsx` et `_app.booking-links.$id.tsx` gèrent les liens de réservation, `_app.bookings.tsx` répertorie les réservations, `_app.settings.tsx` est les paramètres et `book.$slug.tsx` plus `meet.$username.$slug.tsx` sont les pages de réservation publiques.
+- `templates/calendar/server/db/schema.ts` — ajoutez des colonnes ou des tableaux avec Drizzle. Gardez le code indépendant du dialecte afin que le modèle s'exécute sur SQLite, Postgres, Turso, D1 et Neon.
+- `templates/calendar/AGENTS.md` — instructions pour les agents. Mettez-le à jour lorsque vous enseignez à l'agent de nouvelles capacités ou conventions.
+- `templates/calendar/.agents/skills/` : modèles détaillés suivis par l'agent. skills concerné : `event-management`, `availability-booking`, `real-time-sync`, `storing-data`, `delegate-to-agent`, `frontend-design`.
+- `templates/calendar/shared/api.ts` — les types TypeScript partagés (`AvailabilityConfig`, `BookingLink`, `ExternalCalendar`, etc.) utilisés à la fois par le serveur et le client.
+
+Si vous ajoutez une fonctionnalité, n'oubliez pas de mettre à jour les quatre zones : UI, action, compétence ou entrée AGENTS.md, ainsi que tout état d'application que l'agent doit voir. C'est ce qui maintient l'agent et le UI à parité.