# Agenda no contexto e no fechamento do agente

A reserva persistida em `calendar_appointments` é a fonte de data, hora e situação.
O resumo do contato conserva a conversa; não substitui a consulta da agenda.

```mermaid
flowchart LR
    Banco[calendar_appointments] --> Abertura[Compromissos do contato no fuso da reserva]
    Abertura --> Resposta[Modelo e ferramentas de agenda]
    Resposta --> Acoes[Ações nativas concluídas ou recusadas]
    Acoes --> Releitura[Agenda atual depois das ações]
    Banco --> Releitura
    Releitura --> Fechamento[Modelo de fechamento]
    Fechamento --> Resumo[lead_checkpoints]
    Resumo --> Proximo[Próximo turno]
    Banco --> Proximo
    Banco --> Revisor[Revisor semântico antes do envio]
    Revisor --> Envio[Confirmação fiel ou veto visível na execução]
```

## Contratos

- A reserva feita em turno anterior não deixa recibo no turno seguinte. Quando a
  revisão semântica tem evidência comercial e o turno não tentou mexer na agenda,
  o turno lê em `calendar_appointments` as reservas `confirmed` e futuras do
  contato (`lerReservasConfirmadasDoContato`), com filtro de organização e contato
  no SQL, e as entrega em `evidencias_agendamento`, o mesmo campo dos recibos. Ver
  [`docs/specs/promessas-com-evidencias-consultadas.md`](../specs/promessas-com-evidencias-consultadas.md).
  `pending` não comprova. Nenhuma reserva autoriza preço, gratuidade ou promessa
  de resultado. O texto fixo de follow-up não recebe essa leitura.

- `compromissos-do-contato.ts` mantém o recorte por organização, contato,
  compromissos não cancelados e término futuro. Exibe a hora local com o fuso
  da reserva e o mesmo instante em ISO com offset, além do local que o revisor
  confere. O teto continua em cinco;
  o aviso de truncamento e a situação de Google Meet permanecem.
- `crm_list_appointments` e os resultados de escrita de agenda incluem rótulos
  locais. Os campos absolutos usados para executar as ações são preservados.
  Uma recusa de negócio continua sendo recusa, inclusive quando o transporte
  da ferramenta termina com sucesso.
- `agendaNoFechamento` relê depois das ferramentas se a abertura tinha reservas
  ou se o turno usou uma ferramenta de agenda. Não acrescenta chamada ao
  modelo. Não faz essa leitura para propostas de prévia ainda não executadas.
- O fechamento usa `result.responseMessages`, a fita completa de todas as
  etapas. `result.response.messages` contém apenas a última etapa no SDK atual
  e pode omitir justamente a marcação feita antes do envio. As partes de
  ferramenta dessa fita chegam ao fechamento como TEXTO (`toolPartsAsText`, em
  `prune-tool-results.ts`): a chamada de fechamento vai sem `tools`, e a API da
  Anthropic recusa tool_use/tool_result sem tools definidas. Cada resultado tem
  teto em `PRUNE_TOOL_RESULTS_MIN_RESULT_TOKENS`.
- O fechamento recebe a nova leitura e a orientação de substituir fatos
  superados, preservando pedidos e preferências. Uma lista vazia significa
  ausência de compromissos ativos e futuros nesse recorte, não agenda livre.
- Falha da releitura é registrada como desconhecimento. Não vira lista vazia
  nem provoca repetição de uma mensagem já enviada. O modelo ainda redige
  o resumo: esta mudança melhora suas fontes, não valida toda frase gerada.

## Alcance e limites

No fechamento original descrito nesta seção, os escritores, permissões, isolamento, confirmação humana, distribuição de
atendimento e integrações externas não mudam. Não há configuração nova nem
alteração de banco. A atividade e os eventos continuam vindo dos escritores
nativos; o resumo não executa nem desfaz uma reserva.

Testes reproduzíveis:

- `tests/unit/agenda-horarios-locais-no-turno.test.ts`: fusos, horário de verão,
  releitura, ausência de reserva e falha da consulta.
- `tests/unit/mcp-escrita-de-agenda-tem-horario-local.test.ts`: contrato local
  dos resultados e conservação de recusas, situação e instantes.
- `tests/invariants/agenda-atual-no-fechamento.test.ts`: motor completo com
  PostgreSQL descartável, alteração durante o turno e checkpoint persistido.
  Usa dublê de modelo; não mede a semântica de um provedor real.

## Serviços programados

A expansão opt-in está descrita em `docs/testing/agendas-de-servicos.md`. Ela acrescenta programação/ocorrência/capacidade e destino Google ao escritor, mantendo o fechamento como leitor. O contexto factual comum lê os estados atuais depois da ferramenta, inclusive participante, regra guardada, revisão do serviço e publicação verificável. Consulta não comprova reserva; reserva não comprova comunicação, publicação ou presença. A lista da turma de outros contatos não entra no contexto desse atendimento.