@agent-native/core 0.76.5 → 0.76.6

package/docs/content/locales/es-ES/template-brain.md

@@ -0,0 +1,324 @@
+---
+title: "Cerebro"
+description: "Chat empresarial limpio respaldado por memoria institucional citada, ingesta de fuentes revisables e integraciones de espacios de trabajo reutilizables."
+---
+
+# Cerebro
+
+El cerebro es un chat empresarial limpio respaldado por la citada memoria institucional. La gente pregunta
+preguntas en inglés sencillo; Respuestas cerebrales a partir de conocimientos aprobados de la empresa con
+enlaces al hilo, reunión, transcripción, problema o captura de webhook de Slack
+eso respalda la respuesta.
+
+El cerebro ingiere canales Slack aprobados, grabaciones de clips y Granola Team-space
+notas, problemas/PR de GitHub y cargas útiles de transcripción/webhook genéricos. Se almacena crudo
+captura, destila hechos/decisiones/procesos duraderos y enruta información confidencial o
+Recuerdos de baja confianza a través de la revisión antes de que se conviertan en conocimiento de la empresa.
+
+La superficie del producto es simple a propósito: **Preguntar** es el chat principal
+experiencia, mientras que **Fuentes**, **Revisión** y **Conocimiento** son administración/soporte
+superficies para conectar datos, aprobar propuestas e inspeccionar la memoria citada.
+
+```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>"
+}
+```
+
+Cuando abres la aplicación, **Preguntar** está al frente y al centro: un chat limpio y revisado
+memoria de la empresa. **Fuentes**, **Revisión** y **Conocimiento** se encuentran junto a él como
+superficies de administración para conectar datos, aprobar propuestas e inspeccionar citas
+entradas.
+
+## Cuándo elegirlo
+
+Utilice Brain cuando su equipo quiera que los agentes respondan preguntas como "¿por qué lo hicimos?
+¿esta decisión sobre el producto?", "¿cómo funciona esta característica en desarrollo?" o "¿qué
+¿Cambió en este proceso?" con enlaces a la conversación fuente, reunión,
+o problema.
+
+Brain y Dispatch son complementarios pero realizan trabajos diferentes:
+
+- **Brain es propietario de la memoria de la empresa.** Ingiere fuentes y revisa capturas sin procesar
+  destila hechos/decisiones/procesos duraderos, respuestas de la evidencia citada y
+  expone conocimientos aprobados a los agentes.
+- **Dispatch posee el plano de control del espacio de trabajo.** Centraliza la mensajería,
+  secretos, trabajos recurrentes, aprobaciones, orquestación A2A y distribución
+  y aprobación de recursos en todo el espacio de trabajo.
+
+En un espacio de trabajo de múltiples aplicaciones, Dispatch puede enviar una pregunta a Brain a través de A2A y
+puede otorgar credenciales de proveedor compartido a Brain. Brain sigue siendo el especialista en
+Ingestión, revisión, recuperación de fuentes aprobadas y respuestas citadas de Company Brain.
+Brain expone la recuperación de solo lectura basada en citas como su capacidad pública A2A
+para que las aplicaciones de Dispatch y hermanas puedan hacer preguntas sobre la memoria de la empresa: el agente A2A
+La tarjeta son metadatos de descubrimiento público, mientras que la recuperación aún se realiza dentro de Brain.
+superficie de acción autenticada.
+
+## Qué puedes hacer con él
+
+- **Pregunte las preguntas citadas.** Preguntar es la superficie principal del producto: una conversación limpia
+  memoria de la empresa revisada, con estado de origen, recuento de revisiones y sugerencias
+  las preguntas se mantienen en segundo plano. Cada respuesta enlaza con el hilo Slack,
+  reunión, asunto o captura que lo respalde.
+- **Conectar fuentes aprobadas.** Configurar manual, webhook genérico, Clips, Slack,
+  Fuentes de granola y GitHub. Las fuentes son compartidas por la organización de forma predeterminada, por lo que la empresa
+  La memoria es útil para todo el espacio de trabajo.
+- **Revisar antes de publicar.** Las memorias propuestas obtienen una ruta de revisión de primera clase
+  donde los revisores editan el texto, inspeccionan la evidencia/vínculos de fuentes y aprueban o
+  rechazar. Las entradas de alta confianza y no confidenciales se pueden publicar inmediatamente;
+  Las entradas confidenciales o de nivel de empresa se ponen en cola como propuestas.
+- **Inspeccionar el conocimiento citado.** La ruta del Conocimiento muestra destilado, atómico
+  entradas con tipo, tema, entidades, confianza, citas de evidencia exacta y
+  reemplazar enlaces.
+- **Reutilizar integraciones de espacios de trabajo.** Las fuentes cerebrales pueden reutilizar espacios de trabajo compartidos
+  concesiones de conexión en lugar de volver a ingresar tokens de proveedor. La página de fuentes
+  muestra registros de origen de Brain junto a las concesiones de conexión reutilizables y al proveedor
+  preparación.
+- **Memoria aprobada en espejo como contexto ambiental.** Las entradas canónicas aprobadas pueden
+  duplicar los recursos del espacio de trabajo en `context/company-brain/...` para otros
+  pueden usarlos como contexto. Ambos flujos obtienen una vista previa del Markdown exacto antes del
+  el recurso se escribe o se elimina.
+
+## Cómo empezar
+
+Demostración en vivo: [brain.agent-native.com](https://brain.agent-native.com).
+
+1. **Pruebe la demostración.** Abra Preguntar y elija **Iniciar demostración**. El cerebro siembra una pequeña
+   corpus de decisión de producto, ejecuta comprobaciones de confianza y formula una pregunta citada
+   puedes ver respuestas, citas, reseñas y comportamientos no encontrados antes de agregar
+   datos reales de la empresa.
+2. **Agregue una fuente.** Comience con un único canal Slack, Granola Team-space
+   feed, repositorio GitHub, exportación de clips o webhook de transcripción genérico. Mantener
+   el alcance es pequeño hasta que las citas y la calidad de las reseñas se vean bien.
+3. **Revisar antes de publicar.** Utilice Revisar para inspeccionar pruebas y editar el texto.
+   y aprobar solo la memoria duradera de la empresa.
+4. **Pregunte a la fuente.** Utilice Preguntar para preguntas que deban basarse en
+   conocimientos aprobados, no registros de chat sin procesar.
+
+Para una demostración pública, el corpus inicial demuestra la retirada del producto por decisión,
+enlaces de citas, comportamiento de sustitución, control de reseñas, redacción, contenido personal
+exclusión y comportamiento honesto de no encontrado sin conectar un espacio de trabajo real.
+
+### Indicaciones útiles
+
+- "¿Qué decidimos sobre el precio anual y dónde se discutió eso?"
+- "Encuentre el cambio más reciente en el proceso de incorporación y cite la fuente."
+- "Resuma lo que significa esta discusión sobre GitHub para el plan de lanzamiento."
+- "Revise las propuestas de memoria pendientes y marque cualquier cosa que sea demasiado vaga para publicar".
+- "¿Qué fuentes están obsoletas o fallan en la sincronización?"
+
+## Para desarrolladores
+
+El resto de este documento es para cualquiera que bifurque la plantilla Brain o la amplíe.
+
+### Inicio rápido
+
+```bash
+npx @agent-native/core@latest create my-brain --standalone --template brain
+cd my-brain
+pnpm install
+pnpm dev
+```
+
+Abre la aplicación y elige **Iniciar demostración** para ver la memoria citada sin conectar un espacio de trabajo real.
+
+### Modelo de datos
+
+Brain utiliza intencionalmente la búsqueda de texto SQL y la expansión de consultas agentes.
+no se requiere una base de datos vectorial, por lo que la plantilla sigue siendo portátil en todo SQLite,
+Postgres, Neon, D1, Turso y hosts similares. El estado de la aplicación refleja el
+ruta actual, filtros e ID seleccionados para que el agente siempre conozca la ruta actual
+navegación y selección.
+
+El esquema del cerebro vive en `templates/brain/server/db/schema.ts`. Ocho mesas:
+
+| Tabla                    | Qué contiene                                                                                                                                                             |
+| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `brain_sources`          | Configuración del conector: proveedor, canales/repositorios permitidos, cursores de sincronización, postura de revisión, `ingest_token_hash`, `status`, `last_synced_at` |
+| `brain_source_shares`    | Concesiones de participación por fuente (espectador/editor/administrador)                                                                                                |
+| `brain_raw_captures`     | Transcripciones, exportaciones de canales, notas e importaciones de webhooks con clave de deduplicación `external_id`, `content_hash`, tipo y estado de destilación      |
+| `brain_knowledge`        | Entradas atómicas destiladas: tipo (decisión/hecho/proceso/…), tema, entidades, citas de evidencia, confianza, `publish_tier`, enlaces reemplazados                      |
+| `brain_knowledge_shares` | Subvenciones para compartir conocimientos                                                                                                                                |
+| `brain_proposals`        | Elementos de revisión pendientes: propuesta de creación/actualización/archivo con evidencia y notas del revisor                                                          |
+| `brain_proposal_shares`  | Subvenciones de acciones por propuesta                                                                                                                                   |
+| `brain_sync_runs`        | Registro de auditoría de sincronización: proveedor, estado, estadísticas JSON, error, marcas de tiempo de inicio/finalización                                            |
+| `brain_ingest_queue`     | Cola de destilación en segundo plano: operación, estado, prioridad, recuento de reintentos, `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" }
+  ]
+}
+```
+
+### Clave actions
+
+Agrupados por área (`templates/brain/actions/`):
+
+- **Gestión de fuentes**: `create-source`, `update-source`, `delete-source`, `get-source`, `list-sources`, `sync-source`, `sync-due-sources`, `run-slack-pilot`, `test-slack-connection`
+- **Ingestión de captura**: `import-capture`, `import-transcript`, `list-captures`, `get-capture`, `mark-capture-distilled`, `resanitize-captures`
+- **Destilación** — `enqueue-distillation`, `enqueue-captures-distillation`, `claim-distillation`, `retry-distillation`, `list-distillation-queue`
+- **Conocimiento y revisión** — `write-knowledge`, `get-knowledge`, `list-knowledge`, `set-knowledge-canonical`, `preview-canonical-resource`, `list-proposals`, `review-proposal`, `approve-proposal`, `reject-proposal`, `update-proposal`
+- **Búsqueda y recuperación**: `ask-brain`, `search-knowledge`, `search-everything`
+- **Configuración**: `get-brain-settings`, `update-brain-settings`, `set-settings`, `get-settings`
+- **Evaluación y demostración**: `seed-demo-data`, `run-demo-eval`, `run-retrieval-eval`
+- **Contexto y navegación** — `view-screen`, `navigate`
+- **Proveedor API** — `provider-api-catalog`, `provider-api-docs`, `provider-api-request`
+
+### Conectando fuentes
+
+Brain resuelve primero las credenciales del proveedor de una conexión de espacio de trabajo otorgada
+luego desde credenciales de almacén registradas o Brain-local compatibles con versiones anteriores.
+Las credenciales de origen cerebral no recurren a variables de entorno de nivel de implementación.
+Si ya existe un proveedor compartido, conceda acceso a Brain en lugar de copiarlo
+mismo secreto en un entorno específico del cerebro.
+
+**Slack.** Cree una fuente con alcance para ID de canal específicos. El conector
+verifica cada conversación configurada, rechaza DM y MPIM y almacena el cursor
+estado para que cada sincronización se reanude donde se detuvo la última. Un flujo de implementación seguro en
+Cada tarjeta de origen Slack le permite **Probar** la credencial y la lista de permitidos sin
+leer el historial, ejecutar una pequeña muestra de **Piloto seguro**, **Revisar capturas**,
+y aprobar en la **cola de revisión** antes de que algo se pueda consultar. Concede el
+bot solo los alcances que la fuente necesita (validación de credenciales, lista de permitidos
+verificación, historial de canales permitidos y enlaces permanentes duraderos).
+
+**Granola.** Cree una fuente con una ventana de sondeo y un tamaño de página. granola
+Las claves Enterprise API exponen notas del espacio de equipo, no notas o carpetas privadas. Cerebro
+almacena el resumen de la nota, la transcripción, los asistentes, los metadatos del calendario y la fuente
+URL como captura cruda antes de la destilación.
+
+**GitHub.** Cree una fuente con alcance para repositorios aprobados. El conector
+importa problemas limitados y contexto de solicitud de extracción con fuentes estables URL que pueden
+destilarse como Slack o contexto de reunión. Esto es ingestión de contexto cerebral, no
+un reemplazo para los informes GitHub estilo Analytics.
+
+**Clips y webhooks genéricos.** Brain expone un webhook firmado para Clips y
+importaciones genéricas de transcripción/captura en `/api/_agent-native/brain/ingest`. Crear
+una fuente con un `sourceKey` para recibir un token al portador y luego enviar un
+`RawCapturePayload` con `Authorization: Bearer <ingestToken>`. Fuentes genéricas
+use la misma forma de carga útil para transcripciones de llamadas, investigación de clientes e importaciones
+notas o cualquier otra fuente que pueda producir una captura limitada.
+
+```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" }
+  ]
+}
+```
+
+Las fuentes Slack, Granola y GitHub pueden optar por `autoSync` en segundo plano con un
+cadencia de la encuesta una vez que se demuestra la calidad de la revisión.
+
+### Privacidad y puertas
+
+El cerebro está diseñado para la memoria de la empresa, no para la vigilancia personal:
+
+- La sincronización Slack solo lee canales configurados explícitamente y rechaza DM/MPIM.
+- La sincronización de Granola lee notas del espacio de equipo expuestas por API de Granola, no privadas
+  notas o carpetas privadas.
+- Las capturas sin procesar se eliminan de las superficies de listado/búsqueda de forma predeterminada; revisores
+  y los flujos de destilación solicitan vistas previas o contenido sin procesar solo cuando es necesario.
+- Las configuraciones de origen pueden requerir revisión antes de que el conocimiento destilado sea duradero
+  memoria de la empresa.
+- La configuración controla el nivel de publicación predeterminado, ya sea que se requiera conocimiento del nivel de empresa
+  aprobación, requisitos de citación, redacción de correo electrónico y error del conector
+  notificaciones.
+
+### Personalizarlo
+
+Brain sigue el contrato de cuatro áreas nativo del agente: cambia el comportamiento editando
+el área coincidente y el agente puede realizar estas modificaciones por usted:
+
+- `templates/brain/app/routes/` — la superficie UI: preguntar, buscar, conocer
+  Revisión, fuentes, configuración y rutas del equipo.
+- `templates/brain/actions/`: cada operación invocable por el agente (importaciones, origen
+  gestión, informes piloto, destilación, revisión de propuestas, búsqueda de citas,
+  navegación/contexto). Agregue un nuevo archivo con `defineAction` para exponer un nuevo
+  capacidad.
+- `templates/brain/.agents/skills/`: orientación específica del cerebro para la destilación
+  y recuperación. Actualice o agregue una habilidad cuando le enseñe al agente un nuevo flujo de trabajo.
+- `templates/brain/AGENTS.md`: guía para agentes de nivel superior. Actualizar cuando agregues importante
+  características.
+- `templates/brain/server/db/schema.ts`: modelo de datos. Solo migraciones aditivas;
+  La ruta, los filtros y los ID seleccionados se reflejan en `application_state` para el agente
+  contexto.
+
+Pídale al agente que realice cambios por usted; puede editar su propia fuente. Ver
+[Self-Modifying Code](/docs/key-concepts#agent-modifies-code).
+
+## ¿Qué sigue?
+
+- [**Dispatch**](/docs/dispatch): el plano de control del espacio de trabajo
+- [**Dispatch template**](/docs/template-dispatch): la aplicación de coordinación de andamios
+- [**Workspace**](/docs/workspace): recursos compartidos entre aplicaciones
+- [**A2A Protocol**](/docs/a2a-protocol): delegación entre aplicaciones

package/docs/content/locales/es-ES/template-calendar.md

@@ -0,0 +1,194 @@
+---
+title: "Calendario"
+description: "Un calendario impulsado por agentes con sincronización Google Calendar y enlaces de reserva estilo Calendly. Programe, busque espacios y administre la disponibilidad en un inglés sencillo."
+---
+
+# Calendario
+
+Una aplicación de calendario impulsada por agentes. Conecte su Google Calendar y el agente podrá leer su agenda, encontrar espacios libres, crear eventos y administrar enlaces de reserva estilo Calendly, todo en inglés sencillo. Reemplaza el combo Google Calendar + Calendly con una aplicación de tu propiedad.
+
+```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>"
+}
+```
+
+Cuando abres la aplicación, la vista del calendario activo es la superficie principal. El agente aún sabe qué día, semana o evento estás viendo, por lo que puedes decir "programar una llamada de 30 minutos con Alex en este día" sin tener que explicarlo todo.
+
+```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}"
+}
+```
+
+## Qué puedes hacer con él
+
+- **Vea su Google Calendar real** en vista de día, semana o mes, con varias cuentas superpuestas.
+- **Suscríbase a las fuentes ICS** (tiempo libre de recursos humanos, horarios de conferencias, calendarios de equipo): solo lectura, combinados en la misma vista.
+- **Establezca disponibilidad semanal** con soporte de zona horaria: el agente usa esto cuando busca espacios libres.
+- **Cree enlaces de reserva públicos** en `/book/{slug}` para cosas como "introducción de 15 minutos" o "demostración de 30 minutos". Configure duraciones, campos personalizados y qué herramienta de conferencia usar.
+- **Pregúntele al agente cualquier cosa relacionada con el horario**: "¿Estoy libre el jueves por la tarde?" "Encuentra un espacio de 1 hora la próxima semana y ponle 'Planificación con Alex'". "Pausar mi enlace de reserva de demostración."
+- **Comparte enlaces de reserva** con compañeros de equipo para que ellos también puedan administrarlos.
+
+## Para empezar
+
+Demostración en vivo: [calendar.agent-native.com](https://calendar.agent-native.com).
+
+Cuando abres la aplicación por primera vez:
+
+1. Haga clic en **Configuración**.
+2. Haga clic en **Conectar Google Calendar** y apruebe.
+3. (Opcional) Conecta más cuentas de Google si quieres superponer personal y trabajo.
+4. Abre la vista principal: se cargará tu calendario real.
+
+Para crear su primer enlace de reserva:
+
+1. Haga clic en **Enlaces de reserva** en la barra lateral.
+2. Haga clic en **Nuevo enlace de reserva**, establezca un título y una duración.
+3. Comparte el URL público: los visitantes eligen entre los espacios disponibles.
+
+O simplemente pregúntele al agente: "Cree un enlace de introducción de reserva de 15 minutos con un campo de nombre".
+
+### Indicaciones útiles
+
+- "¿Qué hay en mi calendario hoy?"
+- "¿Tengo libre el jueves por la tarde durante 30 minutos?"
+- "Busca un espacio de 1 hora la próxima semana y ponle 'Planificación con Alex'".
+- "Reprograme este evento para el viernes a las 2 p. m.". (cuando se selecciona un evento)
+- "Cambiar a la vista de día y saltar al próximo lunes."
+- "Crea un enlace de reserva llamado 'Introducción de 15 minutos' a los 15 minutos con un campo de nota."
+- "Pausar el enlace de reserva de mi 'demostración de 30 minutos'."
+- "Bloquear los viernes por la tarde según mi disponibilidad."
+- "¿Qué reuniones tengo sobre el 'lanzamiento' este mes?"
+
+El agente consultará a Google Calendar en vivo para cualquier pregunta sobre el cronograma; nunca adivinará.
+
+## Para desarrolladores
+
+El resto de este documento es para cualquiera que bifurque la plantilla de Calendario o la amplíe.
+
+### Inicio rápido
+
+Crea un nuevo espacio de trabajo con la plantilla Calendario:
+
+```bash
+npx @agent-native/core@latest create my-app --standalone --template calendar
+cd my-app
+pnpm install
+pnpm dev
+```
+
+Abre `http://localhost:8082` (el puerto de desarrollo predeterminado de Calendar).
+
+Para conectar Google Calendar en desarrollo, abra la vista Configuración, pegue un `GOOGLE_CLIENT_ID` y un `GOOGLE_CLIENT_SECRET` de [Google Cloud Console](https://console.cloud.google.com/) y haga clic en "Conectar Google Calendar". La redirección OAuth URI es `http://localhost:8082/_agent-native/google/callback` en desarrollo. Los tokens se almacenan en la tabla `oauth_tokens` SQL y se actualizan automáticamente.
+
+### Características clave
+
+**Vistas de calendario en vivo.** Vistas de día, semana y mes leídas directamente desde cuentas de Google conectadas, con feeds ICS opcionales de solo lectura estratificados en el mismo horario.
+
+**Disponibilidad y búsqueda de espacios libres.** Las reglas de disponibilidad semanal, la compatibilidad con zonas horarias y los eventos existentes alimentan la misma acción de disponibilidad que utilizan UI y el agente.
+
+**Enlaces de reserva.** Las páginas públicas `/book/{slug}` recopilan nombre, correo electrónico, campos personalizados, preferencias de conferencia y tokens de cancelación/reprogramación.
+
+**Gestión compartible.** Los enlaces de reserva son privados de forma predeterminada, pero se pueden compartir con compañeros de equipo a través del marco compartido actions.
+
+**Vistas previas de eventos en línea.** El agente puede insertar tarjetas de eventos compactas en el chat con título, hora, ubicación, asistentes y un botón para regresar.
+
+### Trabajar con el agente
+
+El agente ve lo que estás mirando. La vista del calendario actual, la fecha seleccionada y el evento seleccionado se incluyen en cada mensaje como un bloque `current-screen`, por lo que puedes decir "este evento" o "este día" y se resuelve correctamente.
+
+Debajo del capó, el agente llama a actions como `list-events`, `check-availability`, `create-event`, `navigate` y `update-availability`. Debido a que los eventos se encuentran en Google Calendar, el agente siempre consulta el API en lugar de adivinar; no devolverá resultados vacíos sin ejecutar primero un script.
+
+### Modelo de datos
+
+Definido en `templates/calendar/server/db/schema.ts`. Sólo los datos que no son eventos se almacenan localmente:
+
+- `bookings`: citas confirmadas desde páginas de reservas públicas. Almacena nombre, correo electrónico, inicio, fin, slug, notas opcionales, respuestas de campos personalizados, enlace de reunión, un `cancelToken` para que el público administre URL y un estado de `confirmed` o `cancelled`.
+- `booking_links`: definiciones de enlaces estilo Calendly. Slug, título, descripción, `duration` principal, lista `durations` opcional, `customFields`, `conferencing`, `color` y una bandera `isActive`. Utiliza el `ownableColumns` del marco para que se aplique el sistema de uso compartido.
+- `booking_slug_redirects`: recuerda viejos slugs cuando se cambia el nombre de un enlace para que los URL públicos existentes sigan funcionando.
+- `booking_link_shares`: comparte subvenciones para enlaces de reserva.
+
+```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" }
+  ]
+}
+```
+
+Las reglas de disponibilidad y la configuración por usuario se encuentran en la tabla de configuración, con la clave `calendar-availability`. Los tokens OAuth de Google se encuentran en la tabla marco `oauth_tokens`. El estado efímero UI (vista actual, fecha, evento seleccionado) vive en `application_state` bajo la clave `navigation`.
+
+### Personalizarlo
+
+Cada parte de la aplicación es fuente editable. Empiece aquí:
+
+- `templates/calendar/actions/`: cada operación invocable por el agente. Agregue un nuevo archivo con `defineAction` para exponer la nueva capacidad tanto al agente como al frontend. Archivos clave: `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/`: el UI. `_app._index.tsx` es el calendario, `_app.availability.tsx` es el editor de horarios, `_app.booking-links._index.tsx` y `_app.booking-links.$id.tsx` administran los enlaces de reservas, `_app.bookings.tsx` enumera las reservas, `_app.settings.tsx` es la configuración y `book.$slug.tsx` más `meet.$username.$slug.tsx` son las páginas de reservas públicas.
+- `templates/calendar/server/db/schema.ts`: agrega columnas o tablas con Drizzle. Mantenga el código independiente del dialecto para que la plantilla se ejecute en SQLite, Postgres, Turso, D1 y Neon.
+- `templates/calendar/AGENTS.md`: instrucciones del agente. Actualízalo cuando le enseñes al agente nuevas capacidades o convenciones.
+- `templates/calendar/.agents/skills/`: patrones detallados que sigue el agente. skills relevantes: `event-management`, `availability-booking`, `real-time-sync`, `storing-data`, `delegate-to-agent`, `frontend-design`.
+- `templates/calendar/shared/api.ts`: los tipos de TypeScript compartidos (`AvailabilityConfig`, `BookingLink`, `ExternalCalendar`, etc.) utilizados tanto por el servidor como por el cliente.
+
+Si agrega una función, recuerde actualizar las cuatro áreas: UI, acción, habilidad o entrada AGENTS.md y cualquier estado de la aplicación que el agente necesite ver. Eso es lo que mantiene al agente y al UI en paridad.