Planejamento

A superfície de planejamento guarda as decisões travadas que todo prompt de capítulo e toda passada de esboço respeitam — declaração de tema, promessa ao leitor, autores de referência, estrutura de cenas, ponto de vista / tempo verbal, o elenco de personagens (com want / fear / lie), a matriz de conflitos, referências de clima e o avaliador / variantes de esboço.

Ler o plano

GET /v1/books/{bookId}/plan
authorization: Bearer ant_live_…

→ 200 {
  "data": {
    "themeStatement": "Love is what survives when control fails.",
    "readerPromise": "A literary novella about regret and tide.",
    "compAuthors": "Marilynne Robinson meets Anne Carson",
    "beatSheet": { "id": "freytag", "name": "Freytag's Pyramid" },
    "povLock": "third-limited",
    "tenseLock": "past",
    "povDepth": 70,
    "genre": "literary",
    "audience": "adult",
    "genreConfidence": 88,
    "audienceConfidence": 92,
    "autoDetectedGenre": true,
    "researchCitations": [
      { "title": "Tidal patterns of the Bay of Fundy", "url": "…" }
    ]
  }
}

Gravar qualquer subconjunto

Omita um campo para deixá-lo como está. Envie null para limpá-lo. O escritor de capítulos e o gerador de esboço usam os novos valores na próxima chamada de geração.

PATCH /v1/books/{bookId}/plan
content-type: application/json
authorization: Bearer ant_live_…

{
  "themeStatement": "A grandmother teaches the village a quieter way to grieve.",
  "compAuthors": "Marilynne Robinson meets Anne Carson",
  "beatSheetTemplate": "kishotenketsu",
  "tenseLock": "past",
  "povDepth": 80
}

Ids de estrutura de cenas válidos

save-the-cat
three-act
heros-journey
freytag
kishotenketsu
tell-promise-mean

Busque as definições completas dos modelos (beats, intenções, posições) em GET /v1/books/{bookId}/beat-sheets.

Pelo MCP

Claude Desktop / Claude Code com o token MCP da Anthra podem chamar get_plan e set_plan diretamente — mesmo formato de entrada, mesma validação, mesma cota de limite de taxa por token.