Revisão de estrutura e sensibilidade

Verificações editoriais que você pode rodar antes (e durante) a escrita de um livro. As chamadas pagas são cobradas antes de o modelo rodar e devolvidas se ele falhar — os mesmos preços das ferramentas MCP correspondentes (grade_outline, generate_outline_variants, run_sensitivity_scan).

Ler a nota do esboço

GET/v1/books/{bookId}/outline-gradeescopo: books:read

Retorna a nota em cache — overallScore (0–100), dimensions (cinco eixos), critique, suggestions e weakChapters — e também stale: true quando o esboço mudou desde a avaliação. grade é null se ele nunca foi avaliado.

Avaliar o esboço

POST/v1/books/{bookId}/outline-gradeescopo: generation:run

Avalia de novo o esboço atual dos capítulos (precisa de pelo menos três capítulos) e guarda o resultado em cache. Custa um crédito de crítica.

Variantes de esboço

GET/v1/books/{bookId}/outline-variantsescopo: books:read
POST/v1/books/{bookId}/outline-variantsescopo: generation:run

POST gera uma nova rodada de três esboços concorrentes a partir da premissa, cada um com label, angle e uma lista completa de capítulos. Custa três créditos de esboço; exige uma premissa. GET retorna a rodada mais recente como { variants, round }.

Snapshots de esboço

GET/v1/books/{bookId}/outline-snapshotsescopo: books:read

Todos os snapshots feitos antes de uma alteração no esboço (para que uma edição estrutural possa ser revertida): id, label, createdAt, chapterCount e o outline completo.

Listar alertas de sensibilidade

GET/v1/books/{bookId}/sensitivityescopo: analytics:read

Todos os alertas do livro, dos mais recentes para os mais antigos: chapterId, category, severity, o excerpt sinalizado e a rationale do revisor.

Rodar uma varredura de sensibilidade

POST/v1/books/{bookId}/sensitivityescopo: generation:run

Varre um capítulo ({ "chapterId": "…" }) ou, com o corpo vazio, todos os capítulos escritos, e guarda os novos alertas. Custa um crédito de crítica por capítulo, cobrado antecipadamente; se a varredura falhar no meio, os capítulos não varridos são reembolsados e a resposta é um 502 com chaptersScanned. Varreduras do livro inteiro são limitadas a 30 capítulos (413 acima disso — varra capítulo por capítulo).

{ "data": { "chaptersScanned": 12, "flagsAdded": 3 } }

Descartar um alerta

DELETE/v1/books/{bookId}/sensitivity/{flagId}escopo: books:write

Exclui definitivamente um alerta do livro.