@agent-native/core 0.76.5 → 0.76.6

package/corpus/core/docs/content/locales/pt-BR/template-brain.md

@@ -0,0 +1,324 @@
+---
+title: "Cérebro"
+description: "Bate-papo limpo da empresa, apoiado pela memória institucional citada, ingestão de fontes revisáveis e integrações reutilizáveis de espaço de trabalho."
+---
+
+# Cérebro
+
+O cérebro é um bate-papo limpo da empresa, apoiado pela memória institucional citada. As pessoas perguntam
+perguntas em inglês simples; O cérebro responde a partir do conhecimento aprovado da empresa com
+links de volta para o thread Slack, reunião, transcrição, problema ou captura de webhook
+que apoia a resposta.
+
+Brain ingere canais Slack aprovados, gravações de clipes, Granola Team-space
+notas, problemas/PRs GitHub e cargas genéricas de transcrição/webhook. Ele armazena matéria-prima
+captura, destila fatos/decisões/processos duráveis e roteia informações sensíveis ou
+memórias de baixa confiança são revisadas antes de se tornarem conhecimento da empresa.
+
+A superfície do produto permanece simples de propósito: **Perguntar** é o chat principal
+experiência, enquanto **Fontes**, **Revisão** e **Conhecimento** são de administração/suporte
+superfícies para conectar dados, aprovar propostas e inspecionar a memória 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>"
+}
+```
+
+Quando você abre o aplicativo, **Ask** está em destaque: um bate-papo limpo e revisado
+memória da empresa. **Fontes**, **Revisão** e **Conhecimento** acompanham-no como
+superfícies administrativas para conectar dados, aprovar propostas e inspecionar citações
+entradas.
+
+## Quando escolher
+
+Use o Brain quando sua equipe quiser que os agentes respondam perguntas como "por que fizemos
+esta decisão do produto?", "como funciona esse recurso em desenvolvimento?" ou "o quê
+mudou neste processo?" com links para a conversa de origem, reunião,
+ou problema.
+
+Brain e Dispatch são complementares, mas fazem trabalhos diferentes:
+
+- **O cérebro é dono da memória da empresa.** Ele ingere fontes, analisa capturas brutas,
+  destila fatos/decisões/processos duráveis, respostas de evidências citadas e
+  expõe o conhecimento aprovado aos agentes.
+- **O Dispatch possui o plano de controle do espaço de trabalho.** Ele centraliza as mensagens,
+  segredos, trabalhos recorrentes, aprovações, orquestração A2A e distribuição
+  e aprovação de recursos para todo o espaço de trabalho.
+
+Em um espaço de trabalho com vários aplicativos, o Dispatch pode encaminhar uma pergunta para o Brain por meio de A2A e
+pode conceder credenciais de provedor compartilhadas ao Brain. Brain continua sendo o especialista em
+ingestão, revisão, recuperação de fontes aprovadas e respostas citadas do Company Brain.
+Brain expõe a recuperação somente leitura e baseada em citações como seu recurso público A2A
+para que os aplicativos Dispatch e irmãos possam fazer perguntas sobre a memória da empresa — o agente A2A
+cartão são metadados de descoberta pública, enquanto a recuperação ainda acontece dentro do Brain
+superfície de ação autenticada.
+
+## O que você pode fazer com isso
+
+- **Faça perguntas citadas.** Perguntar é a principal superfície do produto: um bate-papo limpo
+  memória da empresa revisada, com integridade da fonte, contagem de revisões e sugestões
+  perguntas mantidas em segundo plano. Cada resposta está vinculada ao tópico Slack,
+  reunião, problema ou captura que suporte isso.
+- **Conecte fontes aprovadas.** Configure manual, webhook genérico, Clips, Slack,
+  Granola e fontes GitHub. As fontes são compartilhadas pela organização por padrão, então a empresa
+  a memória é útil para todo o espaço de trabalho.
+- **Revise antes de publicar.** As memórias propostas recebem um caminho de revisão de primeira classe
+  onde os revisores editam o texto, inspecionam links de evidências/fontes e aprovam ou
+  rejeitar. Entradas de alta confiança e não confidenciais podem ser publicadas imediatamente;
+  Entradas confidenciais ou do nível da empresa são enfileiradas como propostas.
+- **Inspecione o conhecimento citado.** A rota Conhecimento mostra destilado, atômico
+  entradas com tipo, tópico, entidades, confiança, citações de evidências exatas e
+  substituir links.
+- **Reutilize integrações de espaços de trabalho.** Fontes cerebrais podem reutilizar espaços de trabalho compartilhados
+  concessões de conexão em vez de inserir novamente os tokens do provedor. A página Fontes
+  mostra registros de origem do Brain ao lado de provedores e concessões de conexão reutilizáveis
+  prontidão.
+- **Espelhe a memória aprovada como contexto de ambiente.** Entradas canônicas aprovadas podem
+  espelhar os recursos do espaço de trabalho em `context/company-brain/...` e outros
+  aplicativos podem usá-los como contexto. Ambos os fluxos visualizam o Markdown exato antes do
+  o recurso foi gravado ou removido.
+
+## Primeiros passos
+
+Demonstração ao vivo: [brain.agent-native.com](https://brain.agent-native.com).
+
+1. **Experimente a demonstração.** Abra o Ask e escolha **Iniciar demonstração**. O cérebro semeia um pequeno
+   corpus de decisão do produto, executa as verificações de confiança e faz uma pergunta citada, portanto
+   você pode ver respostas, citações, análises e comportamentos não encontrados antes de adicionar
+   dados reais da empresa.
+2. **Adicione uma fonte.** Comece com um único canal Slack, Granola Team-space
+   feed, repositório GitHub, exportação de clipes ou webhook de transcrição genérico. Manter
+   o escopo é pequeno até que as citações e a qualidade da revisão pareçam corretas.
+3. **Revise antes de publicar.** Use a revisão para inspecionar evidências, editar o texto,
+   e aprove apenas memórias duráveis da empresa.
+4. **Pergunte da fonte.** Use Perguntar para perguntas que devem ser fundamentadas
+   conhecimento aprovado, não registros brutos de bate-papo.
+
+Para uma demonstração pública, o corpus propagado demonstra o recall da decisão do produto,
+links de citação, comportamento de substituição, bloqueio de revisão, redação, conteúdo pessoal
+exclusão e comportamento honesto não encontrado sem conectar um espaço de trabalho real.
+
+### Instruções úteis
+
+- "O que decidimos sobre o preço anual e onde isso foi discutido?"
+- "Encontre a alteração mais recente no processo de integração e cite a fonte."
+- "Resuma o que esta discussão sobre GitHub significa para o plano de lançamento."
+- "Revise as propostas de memória pendentes e sinalize qualquer coisa muito vaga para ser publicada."
+- "Quais fontes estão desatualizadas ou com falha na sincronização?"
+
+## Para desenvolvedores
+
+O restante deste documento é para qualquer pessoa que faça bifurcação do modelo Brain ou estenda-o.
+
+### Início rápido
+
+```bash
+npx @agent-native/core@latest create my-brain --standalone --template brain
+cd my-brain
+pnpm install
+pnpm dev
+```
+
+Abra o aplicativo e escolha **Iniciar demonstração** para ver a memória citada sem conectar um espaço de trabalho real.
+
+### Modelo de dados
+
+O Brain usa intencionalmente a pesquisa de texto SQL e a expansão de consulta de agente — existe
+não há necessidade de banco de dados vetorial, portanto o modelo permanece portátil em SQLite,
+Postgres, Neon, D1, Turso e hosts semelhantes. O estado do aplicativo reflete o
+rota atual, filtros e IDs selecionados para que o agente sempre saiba a rota atual
+navegação e seleção.
+
+O esquema do cérebro reside em `templates/brain/server/db/schema.ts`. Oito tabelas:
+
+| Tabela                   | O que ele contém                                                                                                                                             |
+| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `brain_sources`          | Configuração do conector — provedor, canais/repos permitidos, cursores de sincronização, postura de revisão, `ingest_token_hash`, `status`, `last_synced_at` |
+| `brain_source_shares`    | Concessões de compartilhamento por origem (visualizador/editor/administrador)                                                                                |
+| `brain_raw_captures`     | Transcrições, exportações de canal, notas e importações de webhook com chave de desduplicação `external_id`, `content_hash`, tipo e status de destilação     |
+| `brain_knowledge`        | Entradas atômicas destiladas — tipo (decisão/fato/processo/…), tópico, entidades, citações de evidências, confiança, `publish_tier`, links de substituição   |
+| `brain_knowledge_shares` | Concessões de compartilhamento por conhecimento                                                                                                              |
+| `brain_proposals`        | Itens de revisão pendentes — proposta de criação/atualização/arquivamento com evidências e notas do revisor                                                  |
+| `brain_proposal_shares`  | Concessões de ações por proposta                                                                                                                             |
+| `brain_sync_runs`        | Registro de auditoria de sincronização — provedor, status, estatísticas JSON, erro, carimbos de data/hora de início/término                                  |
+| `brain_ingest_queue`     | Fila de destilação em segundo plano — operação, status, prioridade, contagem de novas tentativas, `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" }
+  ]
+}
+```
+
+### Chave actions
+
+Agrupado por área (`templates/brain/actions/`):
+
+- **Gerenciamento de origem** — `create-source`, `update-source`, `delete-source`, `get-source`, `list-sources`, `sync-source`, `sync-due-sources`, `run-slack-pilot`, `test-slack-connection`
+- **Ingestão de captura** — `import-capture`, `import-transcript`, `list-captures`, `get-capture`, `mark-capture-distilled`, `resanitize-captures`
+- **Destilação** — `enqueue-distillation`, `enqueue-captures-distillation`, `claim-distillation`, `retry-distillation`, `list-distillation-queue`
+- **Conhecimento e revisão** — `write-knowledge`, `get-knowledge`, `list-knowledge`, `set-knowledge-canonical`, `preview-canonical-resource`, `list-proposals`, `review-proposal`, `approve-proposal`, `reject-proposal`, `update-proposal`
+- **Pesquisa e recuperação** — `ask-brain`, `search-knowledge`, `search-everything`
+- **Configurações** — `get-brain-settings`, `update-brain-settings`, `set-settings`, `get-settings`
+- **Avaliação e demonstração** — `seed-demo-data`, `run-demo-eval`, `run-retrieval-eval`
+- **Contexto e navegação** — `view-screen`, `navigate`
+- **Provedor APIs** — `provider-api-catalog`, `provider-api-docs`, `provider-api-request`
+
+### Conectando fontes
+
+O Brain resolve primeiro as credenciais do provedor de uma conexão de espaço de trabalho concedida,
+em seguida, a partir de credenciais de cofre locais ou registradas do Brain compatíveis com versões anteriores.
+As credenciais de origem cerebral não recorrem a variáveis de ambiente no nível de implantação.
+Se já existir um provedor compartilhado, conceda acesso ao Brain em vez de copiar o
+mesmo segredo em um ambiente específico do Cérebro.
+
+**Slack.** Crie uma origem com escopo para IDs de canal específicos. O conector
+verifica cada conversa configurada, rejeita DMs e MPIMs e armazena o cursor
+estado para que cada sincronização seja retomada onde a última parou. Um fluxo de implementação seguro ativado
+cada placa de origem Slack permite **testar** a credencial e a lista de permissões sem
+ler o histórico, executar uma pequena amostra limitada do **Piloto seguro**, **Revisar capturas**,
+e aprove na **Fila de revisão** antes que qualquer coisa se torne questionável. Conceda o
+bot apenas os escopos que a fonte precisa (validação de credenciais, lista de permissões
+verificação, histórico de canais permitidos e links permanentes duráveis).
+
+**Granola.** Crie uma fonte com uma janela de votação e tamanho de página. Granola
+As chaves Enterprise API expõem notas do espaço da equipe, não notas ou pastas privadas. Cérebro
+armazena o resumo da nota, a transcrição, os participantes, os metadados do calendário e a fonte
+URL como captura bruta antes da destilação.
+
+**GitHub.** Crie uma fonte com escopo para repositórios aprovados. O conector
+importa problema limitado e contexto de solicitação pull com URLs de origem estáveis que podem
+ser destilado como Slack ou contexto de reunião. Esta é a ingestão de contexto cerebral, não
+um substituto para relatórios GitHub no estilo Analytics.
+
+**Clips e webhooks genérico.** Brain expõe um webhook assinado para Clips e
+importações genéricas de transcrição/captura em `/api/_agent-native/brain/ingest`. Criar
+uma fonte com um `sourceKey` para receber um token de portador e, em seguida, enviar um
+`RawCapturePayload` com `Authorization: Bearer <ingestToken>`. Fontes genéricas
+use o mesmo formato de carga útil para transcrições de chamadas, pesquisas de clientes, importadas
+notas ou qualquer outra fonte que possa produzir uma 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" }
+  ]
+}
+```
+
+As fontes Slack, Granola e GitHub podem ativar o `autoSync` em segundo plano com um
+cadência da pesquisa assim que a qualidade da avaliação for comprovada.
+
+### Privacidade e controle
+
+O cérebro foi projetado para a memória da empresa, não para a vigilância pessoal:
+
+- A sincronização Slack lê apenas canais configurados explicitamente e rejeita DMs/MPIMs.
+- A sincronização do Granola lê notas do espaço da equipe expostas pelo API do Granola, não privadas
+  notas ou pastas privadas.
+- As capturas brutas são editadas das superfícies de listagem/pesquisa por padrão; revisores
+  e os fluxos de destilação solicitam visualizações ou conteúdo bruto somente quando necessário.
+- As configurações de origem podem exigir revisão antes que o conhecimento destilado se torne durável
+  memória da empresa.
+- As configurações controlam o nível de publicação padrão, se o conhecimento do nível da empresa exigir
+  aprovação, requisitos de citação, redação de e-mail e erro de conector
+  notificações.
+
+### Personalizando
+
+Brain segue o contrato de quatro áreas do agente nativo – mude o comportamento editando
+a área correspondente e o agente pode fazer estas edições para você:
+
+- `templates/brain/app/routes/` — a superfície UI: Perguntar, Pesquisar, Conhecimento,
+  Revisão, fontes, configurações e rotas da equipe.
+- `templates/brain/actions/` — todas as operações que podem ser chamadas pelo agente (importações, origem
+  gestão, relatórios piloto, destilação, revisão de propostas, pesquisa citada,
+  navegação/contexto). Adicione um novo arquivo com `defineAction` para expor um novo
+  capacidade.
+- `templates/brain/.agents/skills/` — Orientação específica do cérebro para destilação
+  e recuperação. Atualize ou adicione uma habilidade ao ensinar um novo fluxo de trabalho ao agente.
+- `templates/brain/AGENTS.md` — guia de agente de nível superior. Atualizar ao adicionar major
+  recursos.
+- `templates/brain/server/db/schema.ts` — modelo de dados. Apenas migrações aditivas;
+  rota, filtros e IDs selecionados são espelhados em `application_state` para agente
+  contexto.
+
+Peça ao agente para fazer alterações para você — ele pode editar sua própria fonte. Veja
+[Self-Modifying Code](/docs/key-concepts#agent-modifies-code).
+
+## O que vem a seguir
+
+- [**Dispatch**](/docs/dispatch) — o plano de controle do espaço de trabalho
+- [**Dispatch template**](/docs/template-dispatch) — o aplicativo de coordenação de andaimes
+- [**Workspace**](/docs/workspace) — recursos compartilhados entre aplicativos
+- [**A2A Protocol**](/docs/a2a-protocol) — delegação entre aplicativos

package/corpus/core/docs/content/locales/pt-BR/template-calendar.md

@@ -0,0 +1,194 @@
+---
+title: "Calendário"
+description: "Um calendário desenvolvido por agente com sincronização Google Calendar e links de reserva no estilo Calendly. Agende, encontre vagas e gerencie a disponibilidade em inglês simples."
+---
+
+# Calendário
+
+Um aplicativo de calendário desenvolvido por agente. Conecte seu Google Calendar e o agente poderá ler sua programação, encontrar vagas gratuitas, criar eventos e gerenciar links de reserva no estilo Calendly - tudo em inglês simples. Ele substitui o combo Google Calendar + Calendly por um aplicativo que você possui.
+
+```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>"
+}
+```
+
+Quando você abre o aplicativo, a visualização do calendário ativo é a superfície principal. O agente ainda sabe em que dia, semana ou evento você está olhando, então você pode dizer “agende uma ligação de 30 minutos com Alex neste dia” sem explicar tudo.
+
+```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}"
+}
+```
+
+## O que você pode fazer com isso
+
+- **Veja seu Google Calendar real** em visualização diária, semanal ou mensal, com diversas contas sobrepostas.
+- **Assine os feeds ICS** (folgas do RH, programações de conferências, calendários da equipe) — somente leitura, misturados na mesma visualização.
+- **Defina a disponibilidade semanal** com suporte de fuso horário — o agente usa isso ao encontrar horários livres.
+- **Crie links de reservas públicas** em `/book/{slug}` para coisas como "introdução de 15 minutos" ou "demonstração de 30 minutos". Configure durações, campos personalizados e qual ferramenta de conferência usar.
+- **Pergunte ao agente qualquer coisa relacionada ao horário**: "Estou livre na quinta à tarde?" "Encontre um horário de 1 hora na próxima semana e coloque 'Planejando com Alex' nele." "Pausar meu link de reserva de demonstração."
+- **Compartilhe links de reserva** com colegas de equipe para que eles também possam gerenciá-los.
+
+## Primeiros passos
+
+Demonstração ao vivo: [calendar.agent-native.com](https://calendar.agent-native.com).
+
+Quando você abre o aplicativo pela primeira vez:
+
+1. Clique em **Configurações**.
+2. Clique em **Conectar Google Calendar** e aprove.
+3. (Opcional) Conecte mais contas do Google se quiser sobrepor pessoal e trabalho.
+4. Abra a visualização principal – seu calendário real será carregado.
+
+Para criar seu primeiro link de reserva:
+
+1. Clique em **Links de reserva** na barra lateral.
+2. Clique em **Novo link de reserva**, defina um título e uma duração.
+3. Compartilhe o URL público: os visitantes escolhem entre os slots disponíveis.
+
+Ou simplesmente pergunte ao agente: "Crie um link de introdução à reserva de 15 minutos com um campo de nome."
+
+### Instruções úteis
+
+- "O que está na minha agenda hoje?"
+- "Estou livre na quinta à tarde por 30 minutos?"
+- "Encontre um horário de 1 hora na próxima semana e coloque 'Planejando com Alex' nele."
+- "Reprogramar este evento para sexta-feira às 14h." (quando um evento é selecionado)
+- "Alternar para visualização diária e pular para a próxima segunda-feira."
+- "Crie um link de reserva chamado 'Introdução de 15 minutos' aos 15 minutos com um campo de observação."
+- "Pausar meu link de reserva de 'demonstração de 30 minutos'."
+- "Bloquear as tardes de sexta-feira conforme minha disponibilidade."
+- "Que reuniões terei sobre o 'lançamento' este mês?"
+
+O agente consultará Google Calendar ao vivo para qualquer questão de agendamento — ele nunca adivinha.
+
+## Para desenvolvedores
+
+O restante deste documento é para qualquer pessoa que faça bifurcação do modelo de calendário ou estenda-o.
+
+### Início rápido
+
+Crie um novo espaço de trabalho com o modelo Calendário:
+
+```bash
+npx @agent-native/core@latest create my-app --standalone --template calendar
+cd my-app
+pnpm install
+pnpm dev
+```
+
+Abra `http://localhost:8082` (a porta de desenvolvimento padrão do Agenda).
+
+Para conectar Google Calendar no dev, abra a visualização Configurações, cole um `GOOGLE_CLIENT_ID` e `GOOGLE_CLIENT_SECRET` de [Google Cloud Console](https://console.cloud.google.com/) e clique em "Conectar Google Calendar". O redirecionamento OAuth URI é `http://localhost:8082/_agent-native/google/callback` em dev. Os tokens são armazenados na tabela `oauth_tokens` SQL e atualizados automaticamente.
+
+### Principais recursos
+
+**Visualizações de calendário ao vivo.** Visualizações de dia, semana e mês lidas diretamente de contas do Google conectadas, com feeds ICS somente leitura opcionais dispostos em camadas na mesma programação.
+
+**Disponibilidade e pesquisa de slots gratuitos.** Regras de disponibilidade semanais, suporte de fuso horário e eventos existentes alimentam a mesma ação de disponibilidade que o UI e o agente usam.
+
+**Links de reserva.** As páginas públicas `/book/{slug}` coletam nome, e-mail, campos personalizados, preferências de conferência e tokens de cancelamento/reagendamento.
+
+**Gerenciamento compartilhável.** Os links de reserva são privados por padrão, mas podem ser compartilhados com colegas de equipe por meio da estrutura de compartilhamento actions.
+
+**Pré-visualizações de eventos inline.** O agente pode incorporar cartões de eventos compactos no chat com título, horário, local, participantes e um botão de retorno.
+
+### Trabalhando com o agente
+
+O agente vê o que você está olhando. A visualização atual do calendário, a data selecionada e o evento selecionado são incluídos em cada mensagem como um bloco `current-screen`, para que você possa dizer "este evento" ou "este dia" e tudo será resolvido corretamente.
+
+Nos bastidores, o agente chama actions como `list-events`, `check-availability`, `create-event`, `navigate` e `update-availability`. Como os eventos ocorrem em Google Calendar, o agente sempre consulta o API em vez de adivinhar — ele não retornará resultados vazios sem primeiro executar um script.
+
+### Modelo de dados
+
+Definido em `templates/calendar/server/db/schema.ts`. Apenas dados que não sejam de eventos são armazenados localmente:
+
+- `bookings` — agendamentos confirmados em páginas públicas de reservas. Armazena nome, e-mail, início, fim, slug, notas opcionais, respostas de campos personalizados, link de reunião, um `cancelToken` para o gerenciamento público URL e um status `confirmed` ou `cancelled`.
+- `booking_links` — as definições de link no estilo Calendly. Slug, título, descrição, `duration` primário, lista `durations` opcional, `customFields`, `conferencing`, `color` e um sinalizador `isActive`. Usa o `ownableColumns` da estrutura para que o sistema de compartilhamento seja aplicado.
+- `booking_slug_redirects` — lembra slugs antigos quando um link é renomeado para que URLs públicos existentes continuem funcionando.
+- `booking_link_shares` — compartilhe concessões para links 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" }
+  ]
+}
+```
+
+As regras de disponibilidade e a configuração por usuário estão na tabela de configurações, codificadas por `calendar-availability`. Os tokens Google OAuth residem na tabela `oauth_tokens` da estrutura. O estado efêmero UI (visualização atual, data, evento selecionado) reside em `application_state` sob a chave `navigation`.
+
+### Personalizando
+
+Cada parte do aplicativo é uma fonte editável. Comece aqui:
+
+- `templates/calendar/actions/` — todas as operações que podem ser chamadas pelo agente. Adicione um novo arquivo com `defineAction` para expor novos recursos ao agente e ao frontend. Arquivos principais: `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/` — o UI. `_app._index.tsx` é o calendário, `_app.availability.tsx` é o editor de agendamento, `_app.booking-links._index.tsx` e `_app.booking-links.$id.tsx` gerenciam links de reserva, `_app.bookings.tsx` lista reservas, `_app.settings.tsx` é Configurações e `book.$slug.tsx` mais `meet.$username.$slug.tsx` são as páginas de reserva públicas.
+- `templates/calendar/server/db/schema.ts` — adicione colunas ou tabelas com Drizzle. Mantenha o código independente do dialeto para que o modelo seja executado em SQLite, Postgres, Turso, D1 e Neon.
+- `templates/calendar/AGENTS.md` — instruções do agente. Atualize isso ao ensinar ao agente novos recursos ou convenções.
+- `templates/calendar/.agents/skills/` — padrões detalhados que o agente segue. skills relevante: `event-management`, `availability-booking`, `real-time-sync`, `storing-data`, `delegate-to-agent`, `frontend-design`.
+- `templates/calendar/shared/api.ts` — os tipos TypeScript compartilhados (`AvailabilityConfig`, `BookingLink`, `ExternalCalendar`, etc.) usados pelo servidor e pelo cliente.
+
+Se você adicionar um recurso, lembre-se de atualizar todas as quatro áreas: UI, ação, habilidade ou entrada AGENTS.md e qualquer estado do aplicativo que o agente precise ver. É isso que mantém o agente e o UI em paridade.