Bíblia do escritor

Cada livro tem um conjunto de documentos de referência — um por kind — que o escritor de capítulos lê como cânone: characters, plot_outline, theme_outline, style_guide, style_references, worldbuilding, research_notes, glossary, synopsis, lore, setting_bible e era_research. Toda sobrescrita cria antes um snapshot do conteúdo anterior, então nada se perde. Um kind desconhecido retorna 400.

Listar documentos

Retorna os documentos salvos (kind, title, chars, updatedAt — sem o conteúdo) e também kinds, o catálogo completo com título e descrição curta de cada um, para você montar um seletor sem fixá-lo no código.

Ler um documento

Retorna { kind, title, content, attachments, updatedAt }, ou 404 quando ainda não há nada salvo para esse kind.

Gravar um documento

Cria ou atualiza o documento. Corpo: content (Markdown, até 200.000 caracteres) e um title opcional (o padrão é o título do kind no catálogo). O conteúdo anterior vai antes para a lista de revisões como snapshot.

curl -X PUT "$ANTHRA_BASE/books/$BOOK/documents/style_guide" \
  -H "authorization: Bearer $ANTHRA_TOKEN" \
  -H "content-type: application/json" \
  -d '{ "content": "## POV\nClose third, past tense. Never head-hop." }'

Rascunhar um documento com IA

Rascunha o documento a partir da premissa, dos outros documentos da bíblia do livro e dos primeiros capítulos escritos, e depois o salva. Cobra um crédito de assistência antes de o modelo rodar; o crédito é devolvido em qualquer falha, incluindo as duas recusas abaixo.

Respostas: 200 com o documento salvo (kind, title, content, chars); 409 confirmation_required com previousChars quando o documento não está vazio e force não foi enviado; 400 com needsPremise: true quando o livro ainda não tem premissa; 402 quando a conta está sem créditos.

Listar revisões

Snapshots salvos, dos mais recentes para os mais antigos: id, reason (o que o sobrescreveu), previousChars, previousAttachments e createdAt. O conteúdo é omitido — restaure um para vê-lo.

Restaurar uma revisão

Reverte o documento para o snapshot. O conteúdo atual vira snapshot antes, então a própria restauração pode ser desfeita. Um id de revisão que pertence a outro livro ou kind retorna 404.