beplus-mcp 0.25.0 → 0.27.0

package/README.md

@@ -112,6 +112,30 @@ Reinicie o cliente. Rode a tool **`whoami`** para confirmar o vínculo.
 | `get_balance` | Saldo de diamantes. |
 | `whoami` | Conta vinculada (link check do PAT). |
 
+### Canvas online (boards colaborativos)
+Falam com `/api/v1/canvas`. **Não geram mídia nem gastam diamantes**: montam o fluxo; quem roda os nós é a pessoa, no Canvas. Funcionam com PAT e com o `beplus-mcp login`: ler boards pede `ialab:read`; criar, editar e compartilhar pede `ialab:spend`.
+
+| Tool | O que faz |
+|------|-----------|
+| `canvas_list_boards` | Boards de que você é membro (id, título, papel, seq). |
+| `canvas_read_board` | Resumo compacto: nós (tipo, nome, campos principais), ligações, vínculo com o IA Lab. Sem mídia. `node_ids` traz o `data` inteiro de alguns nós. **Obrigatório antes de editar.** |
+| `canvas_create_board` | Cria board vazio ou `template: "narration"` (Contexto, Narração, Roteiro e Locução ligados). |
+| `canvas_add_node` | Adiciona nó de um tipo do catálogo, com `label`, `data` e ligações de entrada/saída no mesmo passo. |
+| `canvas_update_node` | Grava chaves do `data` (null apaga), renomeia (`label`) e move. |
+| `canvas_connect` | Liga saída → entrada. |
+| `canvas_delete` | Apaga nós (com ligações e variações) e/ou ligações. |
+| `canvas_rename_board` | Troca o título (`board.set`). |
+| `canvas_list_members` · `canvas_set_member` · `canvas_remove_member` | Membros e papéis (`editor`/`viewer`) por userId. |
+| `canvas_list_comments` | Comentários do board (padrão: abertos) com o lugar em texto ("no nó X", "na versão 2 de X", "em 01:12 da Montagem X", "no board"), autor, pedido e respostas. Avisa quando o alvo sumiu. |
+| `canvas_reply_comment` | Responde numa thread sem resolver (para perguntar). |
+| `canvas_resolve_comment` | Fecha o comentário com uma frase obrigatória dizendo o que foi feito, postada como resposta antes de resolver. |
+| `canvas_reopen_comment` | Reabre, com motivo opcional. |
+| `canvas_comment` | Cria comentário raiz ancorado (nó, versão, minutagem, ponto ou board), para deixar pergunta na tela da pessoa. |
+
+Concorrência: cada edição relê o board, vai num envelope só (um `seq`) e é recusada, sem aplicar nada, se outra pessoa mexeu nos mesmos nós desde a sua leitura. Recusas do servidor (`node-missing` e afins) voltam em português com "releia".
+
+"Aplica os comentários": `canvas_list_comments` → para cada um, ler o nó ancorado, aplicar pelas `canvas_*` e fechar com `canvas_resolve_comment` dizendo o que fez. Pedido ambíguo ou alvo sumido recebe pergunta (`canvas_reply_comment`) e fica aberto. As escritas de comentário respeitam o limite do back (60/min por pessoa): o MCP espaça as chamadas e, no 429, espera e tenta de novo. No login pelo navegador, escrever comentário exige `ialab:spend`.
+
 Toda geração mostra `Custo: N 💎 · Saldo: M 💎`. As tools de calls e listagem respeitam a visibilidade da equipe — só retornam o que a sua conta pode ver.
 
 ## Desenvolvimento