Personagens

Os personagens carregam os eixos want / fear / lie no estilo de Truby, que orientam a noção que o escritor de capítulos tem de quem o personagem é, além de apelidos, papel, biografia e perfil de voz opcionais. Livros com vários pontos de vista precisam de pelo menos um personagem isPov: true.

Listar personagens

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

→ 200 {
  "data": [
    {
      "id": "8b0c…",
      "name": "Marin",
      "aliases": ["the salt-keeper"],
      "role": "protagonist",
      "bio": "Lighthouse keeper, raised by her grandmother in Tide's Cove.",
      "voiceProfile": "Spare, water-bound, never apologetic.",
      "want": "to keep the village safe through one more storm",
      "fear": "becoming the version of her mother she swore she wouldn't",
      "lie": "love is something you earn by being useful",
      "isPov": true
    }
  ]
}

Criar um personagem

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

{
  "name": "Selene",
  "role": "antagonist",
  "want": "to break the village's grip on the cove",
  "fear": "being forgotten",
  "lie": "control is the only love that doesn't decay",
  "isPov": false
}

Alterar + excluir um personagem

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

{
  "voiceProfile": "Clipped, generous with silence, never repeats herself."
}

DELETE /v1/books/{bookId}/characters/{characterId}
authorization: Bearer ant_live_…

→ 200 { "data": { "ok": true } }

As arestas de conflito que referenciavam o personagem excluído são removidas automaticamente.

Referência de campos

name — obrigatório, ≤ 120 caracteres.
aliases — até 20 nomes alternativos curtos.
role, bio, voiceProfile — texto livre; bio + voiceProfile podem ter até 2000 caracteres.
want / fear / lie — uma oração curta cada (≤ 240 caracteres). Definir qualquer um como null o remove do prompt do capítulo.
isPov — true marca o personagem como portador de ponto de vista.

Pelo MCP

list_characters, create_character, update_character e delete_character também estão disponíveis pelo servidor MCP. A matriz de conflitos é coberta por list_character_conflicts, add_character_conflict e remove_character_conflict.