beplus-mcp 0.26.0 → 0.27.0

package/dist/index.js

@@ -916,10 +916,10 @@ var require_codegen = __commonJS({
         return this._leafNode(new Throw(error2));
       }
       // start self-balancing block
-      block(body, nodeCount) {
+      block(body2, nodeCount) {
         this._blockStarts.push(this._nodes.length);
-        if (body)
-          this.code(body).endBlock(nodeCount);
+        if (body2)
+          this.code(body2).endBlock(nodeCount);
         return this;
       }
       // end the current self-balancing block
@@ -2344,15 +2344,15 @@ var require_validate = __commonJS({
       validateFunction(it, () => (0, boolSchema_1.topBoolOrEmptySchema)(it));
     }
     exports.validateFunctionCode = validateFunctionCode;
-    function validateFunction({ gen, validateName, schema, schemaEnv, opts }, body) {
+    function validateFunction({ gen, validateName, schema, schemaEnv, opts }, body2) {
       if (opts.code.es5) {
         gen.func(validateName, (0, codegen_1._)`${names_1.default.data}, ${names_1.default.valCxt}`, schemaEnv.$async, () => {
           gen.code((0, codegen_1._)`"use strict"; ${funcSourceUrl(schema, opts)}`);
           destructureValCxtES5(gen, opts);
-          gen.code(body);
+          gen.code(body2);
         });
       } else {
-        gen.func(validateName, (0, codegen_1._)`${names_1.default.data}, ${destructureValCxt(opts)}`, schemaEnv.$async, () => gen.code(funcSourceUrl(schema, opts)).code(body));
+        gen.func(validateName, (0, codegen_1._)`${names_1.default.data}, ${destructureValCxt(opts)}`, schemaEnv.$async, () => gen.code(funcSourceUrl(schema, opts)).code(body2));
       }
     }
     function destructureValCxt(opts) {
@@ -21156,11 +21156,11 @@ var EMPTY_COMPLETION_RESULT = {
 var ApiError = class extends Error {
   httpStatus;
   body;
-  constructor(httpStatus, message, body) {
+  constructor(httpStatus, message, body2) {
     super(message);
     this.name = "ApiError";
     this.httpStatus = httpStatus;
-    this.body = body;
+    this.body = body2;
   }
 };
 function apiErrorToUserMessage(err) {
@@ -21244,14 +21244,14 @@ var BeplusClient = class {
     }
     return json2 && typeof json2 === "object" && "result" in json2 ? json2.result : json2;
   }
-  startGeneration(body) {
-    return this.request("POST", "/generations", { body });
+  startGeneration(body2) {
+    return this.request("POST", "/generations", { body: body2 });
   }
   listProjects() {
     return this.request("GET", "/projects");
   }
-  createProject(body) {
-    return this.request("POST", "/projects", { body });
+  createProject(body2) {
+    return this.request("POST", "/projects", { body: body2 });
   }
   getActiveProject() {
     return this.request("GET", "/projects/active");
@@ -21263,8 +21263,8 @@ var BeplusClient = class {
   listClients() {
     return this.request("GET", "/clients");
   }
-  createClient(body) {
-    return this.request("POST", "/clients", { body });
+  createClient(body2) {
+    return this.request("POST", "/clients", { body: body2 });
   }
   setActiveClient(client) {
     return this.request("PUT", "/clients/active", { body: { client } });
@@ -21286,8 +21286,8 @@ var BeplusClient = class {
       }
     });
   }
-  tts(body) {
-    return this.request("POST", "/tts", { body, timeoutMs: 9e4 });
+  tts(body2) {
+    return this.request("POST", "/tts", { body: body2, timeoutMs: 9e4 });
   }
   models() {
     return this.request("GET", "/models");
@@ -21302,11 +21302,11 @@ var BeplusClient = class {
   me(billing) {
     return this.request("GET", "/me", { query: { billing } });
   }
-  readProvenance(body) {
-    return this.request("POST", "/read-provenance", { body, timeoutMs: 3e4 });
+  readProvenance(body2) {
+    return this.request("POST", "/read-provenance", { body: body2, timeoutMs: 3e4 });
   }
-  analyzeMedia(body) {
-    return this.request("POST", "/analyze-media", { body, timeoutMs: 3e5 });
+  analyzeMedia(body2) {
+    return this.request("POST", "/analyze-media", { body: body2, timeoutMs: 3e5 });
   }
   searchCalls(query) {
     return this.request("GET", "/calls", {
@@ -22874,7 +22874,7 @@ function registerAudioTools(server, client, cfg) {
     },
     async (args) => {
       try {
-        const body = compact({
+        const body2 = compact({
           text: args.text,
           voice: args.voice,
           model: args.model,
@@ -22882,7 +22882,7 @@ function registerAudioTools(server, client, cfg) {
           multiSpeaker: args.multi_speaker,
           project: args.project ?? cfg.activeProject ?? void 0
         });
-        const res = await client.tts(body);
+        const res = await client.tts(body2);
         const parts = [`Custo: ${res.diamond_cost} \u{1F48E}`];
         if (res.diamonds_refunded) parts.push(`Estorno: ${res.diamonds_refunded} \u{1F48E}`);
         const projLine = res.project_code ? `
@@ -23378,11 +23378,11 @@ function fmtDate(iso) {
 function callLine(c) {
   const company = c.company_name ? ` \xB7 ${c.company_name}` : "";
   const proj = c.project_name ? ` \xB7 ${c.client_name ? c.client_name + " / " : ""}${c.project_name}` : "";
-  const who = c.speakers.length ? ` \xB7 ${c.speakers.join(", ")}` : c.participant_count ? ` \xB7 ${c.participant_count} falantes` : "";
+  const who2 = c.speakers.length ? ` \xB7 ${c.speakers.join(", ")}` : c.participant_count ? ` \xB7 ${c.participant_count} falantes` : "";
   const vis = VIS_LABEL[c.visibility] ?? c.visibility;
   const flag = c.status !== "ready" ? ` [${c.status}]` : "";
   return `\u2022 ${c.title ?? "(sem t\xEDtulo)"}${flag}
-  ${fmtDate(c.date)} \xB7 ${fmtDuration(c.duration_sec)} \xB7 ${vis}${company}${proj}${who}
+  ${fmtDate(c.date)} \xB7 ${fmtDuration(c.duration_sec)} \xB7 ${vis}${company}${proj}${who2}
   id: ${c.id}`;
 }
 function renderCall(c) {
@@ -23475,6 +23475,12 @@ function errorRaw(err) {
   const raw = err.body?.error?.raw;
   return raw && typeof raw === "object" ? raw : void 0;
 }
+var commentPacing = {
+  perMinute: 50,
+  retryWaitsMs: [5e3, 15e3, 45e3],
+  now: () => Date.now(),
+  sleep: (ms) => new Promise((r) => setTimeout(r, Math.max(0, ms)))
+};
 var CanvasApi = class {
   constructor(client, cfg) {
     this.client = client;
@@ -23484,6 +23490,8 @@ var CanvasApi = class {
   cfg;
   coreVersion = PINNED_CORE_VERSION;
   userId = null;
+  /** Instantes das escritas de comentário no último minuto. */
+  writes = [];
   req(method, path, opts = {}) {
     return this.client.request(method, path, { ...opts, base: this.cfg.canvasBase });
   }
@@ -23499,16 +23507,16 @@ var CanvasApi = class {
   listBoards(kind = "board") {
     return this.req("GET", "/boards", { query: { kind } });
   }
-  createBoard(body) {
-    return this.req("POST", "/boards", { body });
+  createBoard(body2) {
+    return this.req("POST", "/boards", { body: body2 });
   }
-  snapshot(boardId2) {
-    return this.req("GET", `/boards/${boardId2}`);
+  snapshot(boardId3) {
+    return this.req("GET", `/boards/${boardId3}`);
   }
   /** Replay depois de `after`. `null` quando o servidor manda reler a foto (410). */
-  async opsAfter(boardId2, after) {
+  async opsAfter(boardId3, after) {
     try {
-      const { envelopes } = await this.req("GET", `/boards/${boardId2}/ops`, {
+      const { envelopes } = await this.req("GET", `/boards/${boardId3}/ops`, {
         query: { after }
       });
       return envelopes;
@@ -23517,8 +23525,8 @@ var CanvasApi = class {
       throw e;
     }
   }
-  async commit(boardId2, ops) {
-    const send = () => this.req("POST", `/boards/${boardId2}/ops`, {
+  async commit(boardId3, ops) {
+    const send = () => this.req("POST", `/boards/${boardId3}/ops`, {
       body: { coreVersion: this.coreVersion, ops }
     });
     try {
@@ -23539,14 +23547,51 @@ var CanvasApi = class {
       }
     }
   }
-  members(boardId2) {
-    return this.req("GET", `/boards/${boardId2}/members`);
+  members(boardId3) {
+    return this.req("GET", `/boards/${boardId3}/members`);
+  }
+  putMember(boardId3, userId, role) {
+    return this.req("PUT", `/boards/${boardId3}/members/${userId}`, { body: { role } });
   }
-  putMember(boardId2, userId, role) {
-    return this.req("PUT", `/boards/${boardId2}/members/${userId}`, { body: { role } });
+  removeMember(boardId3, userId) {
+    return this.req("DELETE", `/boards/${boardId3}/members/${userId}`);
   }
-  removeMember(boardId2, userId) {
-    return this.req("DELETE", `/boards/${boardId2}/members/${userId}`);
+  // ── comentários (academy-backend #313) ────────────────────────────────────
+  listComments(boardId3, status = "open") {
+    return this.req("GET", `/boards/${boardId3}/comments`, { query: { status } });
+  }
+  /**
+   * Escrita de comentário passa por aqui: o back limita a 60 por minuto por pessoa
+   * (balde fixo, sem Retry-After). O MCP se espaça abaixo do teto e, se ainda
+   * assim vier 429 (a pessoa também comentando no Canvas), espera e tenta de novo.
+   */
+  async write(method, path, body2) {
+    const p = commentPacing;
+    const now = p.now();
+    this.writes = this.writes.filter((t) => now - t < 6e4);
+    if (this.writes.length >= p.perMinute) {
+      await p.sleep(this.writes[0] + 6e4 - now);
+      this.writes.shift();
+    }
+    for (let attempt = 0; ; attempt++) {
+      this.writes.push(p.now());
+      try {
+        return await this.req(method, path, body2 === void 0 ? {} : { body: body2 });
+      } catch (e) {
+        if (!(e instanceof ApiError) || e.httpStatus !== 429 || attempt >= p.retryWaitsMs.length) throw e;
+        await p.sleep(p.retryWaitsMs[attempt]);
+      }
+    }
+  }
+  /** Raiz ou resposta. O back devolve sempre a THREAD DA RAIZ (resposta nova = última de `replies`). */
+  createComment(boardId3, body2) {
+    return this.write("POST", `/boards/${boardId3}/comments`, body2);
+  }
+  resolveComment(boardId3, commentId2) {
+    return this.write("POST", `/boards/${boardId3}/comments/${commentId2}/resolve`);
+  }
+  reopenComment(boardId3, commentId2) {
+    return this.write("POST", `/boards/${boardId3}/comments/${commentId2}/reopen`);
   }
   /** Só para os testes conferirem o aprendizado. */
   get currentCoreVersion() {
@@ -23563,6 +23608,8 @@ var CoreMismatchError = class extends Error {
   }
   serverVersion;
 };
+var CanvasToolError = class extends Error {
+};
 
 // src/canvas/catalog.ts
 var WORKFLOW_NODE_TYPE = "workflow";
@@ -23816,8 +23863,8 @@ function checkOp(op) {
       return null;
   }
 }
-function envelope(boardId2, op, actorId) {
-  return { id: randomUUID(), boardId: boardId2, clientId: CLIENT_ID, actorId, seq: null, ts: Date.now(), op };
+function envelope(boardId3, op, actorId) {
+  return { id: randomUUID(), boardId: boardId3, clientId: CLIENT_ID, actorId, seq: null, ts: Date.now(), op };
 }
 function checkEnvelope(env) {
   const bad = checkOp(env.op);
@@ -24067,6 +24114,289 @@ function touchedNodes(envelopes) {
   return out;
 }
 
+// src/canvas/comments.ts
+function mmss(t) {
+  const total = Math.max(0, Math.floor(t));
+  const h = Math.floor(total / 3600);
+  const m = Math.floor(total % 3600 / 60);
+  const s = total % 60;
+  const pad = (n) => String(n).padStart(2, "0");
+  return h ? `${h}:${pad(m)}:${pad(s)}` : `${pad(m)}:${pad(s)}`;
+}
+function nodeRef(doc, nodeId) {
+  const node = doc.nodes[nodeId];
+  const kind = nodeKind(node) ?? node.type;
+  return `"${oneLine(nodeName(node), 60)}" (${kind}, ${node.id})`;
+}
+function hashString(text) {
+  let h1 = 3735928559;
+  let h2 = 1103547991;
+  for (let i = 0; i < text.length; i += 1) {
+    const ch = text.charCodeAt(i);
+    h1 = Math.imul(h1 ^ ch, 2654435761);
+    h2 = Math.imul(h2 ^ ch, 1597334677);
+  }
+  h1 = Math.imul(h1 ^ h1 >>> 16, 2246822507) ^ Math.imul(h2 ^ h2 >>> 13, 3266489909);
+  h2 = Math.imul(h2 ^ h2 >>> 16, 2246822507) ^ Math.imul(h1 ^ h1 >>> 13, 3266489909);
+  const hex = (n) => (n >>> 0).toString(16).padStart(8, "0");
+  return hex(h2) + hex(h1);
+}
+function outputKeyOf(entry) {
+  for (const field of [entry.resultId, entry.id, entry.generationId]) {
+    if (typeof field === "string" && field !== "" && field.length <= 128) return field;
+  }
+  if (typeof entry.url === "string" && entry.url !== "") return `url-${hashString(entry.url)}`;
+  return null;
+}
+function versionOf(doc, nodeId, outputKey) {
+  const ids = doc.nodeHistory?.[nodeId];
+  if (Array.isArray(ids)) {
+    const i = ids.indexOf(outputKey);
+    if (i >= 0) return i + 1;
+  }
+  const history = doc.nodes[nodeId]?.data.history;
+  if (Array.isArray(history)) {
+    const i = history.findIndex(
+      (h) => typeof h === "object" && h !== null && !Array.isArray(h) && outputKeyOf(h) === outputKey
+    );
+    if (i >= 0) return history.length - i;
+  }
+  return null;
+}
+function describeAnchor(anchor, doc) {
+  if (!anchor || anchor.kind === "point") return { text: "no board" };
+  const exists = !!doc.nodes[anchor.nodeId];
+  if (!exists) {
+    return { text: `no n\xF3 ${anchor.nodeId}`, gone: "o n\xF3 foi apagado" };
+  }
+  const ref = nodeRef(doc, anchor.nodeId);
+  switch (anchor.kind) {
+    case "node":
+      return { text: `no n\xF3 ${ref}`, nodeId: anchor.nodeId };
+    case "output": {
+      const v = versionOf(doc, anchor.nodeId, anchor.outputKey);
+      return v === null ? { text: `numa vers\xE3o de ${ref} (${anchor.outputKey})`, nodeId: anchor.nodeId, gone: "essa vers\xE3o n\xE3o est\xE1 mais no hist\xF3rico do n\xF3" } : { text: `na vers\xE3o ${v} de ${ref}`, nodeId: anchor.nodeId };
+    }
+    case "timecode": {
+      const node = doc.nodes[anchor.nodeId];
+      const kind = nodeKind(node);
+      const t = mmss(Number(anchor.t) || 0);
+      if (kind === "montage") {
+        const name = nodeName(node);
+        const title = name === KINDS.montage.title ? "" : ` "${oneLine(name, 60)}"`;
+        return { text: `em ${t} da Montagem${title} (${node.id})`, nodeId: anchor.nodeId };
+      }
+      return { text: `em ${t} de ${ref}`, nodeId: anchor.nodeId };
+    }
+    default:
+      return { text: "no board" };
+  }
+}
+function who(c) {
+  return c.author?.name?.trim() || "algu\xE9m";
+}
+function reactionsText(r) {
+  if (Array.isArray(r)) {
+    const parts = r.map((x) => {
+      const rec = x ?? {};
+      const emoji2 = typeof rec.emoji === "string" ? rec.emoji : null;
+      const n = typeof rec.count === "number" ? rec.count : Array.isArray(rec.userIds) ? rec.userIds.length : Array.isArray(rec.users) ? rec.users.length : 1;
+      return emoji2 ? `${emoji2}${n > 1 ? `\xD7${n}` : ""}` : null;
+    }).filter(Boolean);
+    return parts.join(" ");
+  }
+  if (r && typeof r === "object") {
+    return Object.entries(r).map(([emoji2, v]) => {
+      const n = Array.isArray(v) ? v.length : typeof v === "number" ? v : 1;
+      return `${emoji2}${n > 1 ? `\xD7${n}` : ""}`;
+    }).join(" ");
+  }
+  return "";
+}
+var MAX_REPLIES = 5;
+function threadLines(t, doc) {
+  const where = describeAnchor(t.anchor, doc);
+  const state = t.resolvedAt ? " \xB7 RESOLVIDO" : "";
+  const reacts = reactionsText(t.reactions);
+  const lines = t.deleted ? [`- ${t.id} \xB7 ${where.text}${state}`, "  (coment\xE1rio raiz apagado: n\xE3o d\xE1 para responder nem resolver)"] : [`- ${t.id} \xB7 ${where.text} \xB7 ${who(t)}${state}${reacts ? ` \xB7 ${reacts}` : ""}`, `  pedido: ${oneLine(t.body ?? "", 400)}`];
+  if (where.gone && !t.deleted) lines.push(`  \u26A0 ALVO SUMIU: ${where.gone}. Responda com pergunta, n\xE3o resolva.`);
+  const replies = Array.isArray(t.replies) ? t.replies : [];
+  for (const r of replies.slice(-MAX_REPLIES)) {
+    lines.push(r.deleted ? "  \u21B3 (resposta apagada)" : `  \u21B3 ${who(r)}: ${oneLine(r.body ?? "", 140)}`);
+  }
+  if (replies.length > MAX_REPLIES) lines.splice(lines.length - MAX_REPLIES, 0, `  \u21B3 \u2026 ${replies.length - MAX_REPLIES} resposta(s) antes`);
+  return lines;
+}
+function commentsSummary(threads, doc, status) {
+  const label = status === "resolved" ? "resolvido(s)" : status === "all" ? "no total" : "aberto(s)";
+  if (!threads.length) return `Nenhum coment\xE1rio ${label === "no total" ? "no board" : label}.`;
+  const out = [`${threads.length} coment\xE1rio(s) ${label}:`];
+  for (const t of threads) out.push(...threadLines(t, doc));
+  return out.join("\n");
+}
+
+// src/tools/canvas-comments.ts
+var boardId = external_exports.string().uuid().describe("Id (uuid) do board.");
+var commentId = external_exports.string().min(1).max(128).describe("Id do coment\xE1rio raiz, como sai em canvas_list_comments.");
+var body = external_exports.string().trim().min(1).max(4e3);
+var mentions = external_exports.array(external_exports.string().uuid()).max(50).optional().describe("userIds a marcar (opcional; quem n\xE3o \xE9 membro \xE9 ignorado).");
+function registerCanvasCommentTools(server, api, run) {
+  async function onComment(fn) {
+    try {
+      return await fn();
+    } catch (e) {
+      if (!(e instanceof ApiError)) throw e;
+      if (e.httpStatus === 404) {
+        throw new CanvasToolError("Coment\xE1rio (ou board) n\xE3o encontrado ou apagado. Liste de novo com canvas_list_comments.");
+      }
+      if (e.httpStatus === 400) throw new CanvasToolError(`O servidor recusou o coment\xE1rio: ${e.message}.`);
+      if (e.httpStatus === 403 && (!api.usesPat || /ialab:/.test(e.message))) {
+        throw new CanvasToolError(
+          "O login pelo navegador deste MCP n\xE3o tem a permiss\xE3o ialab:spend, que toda escrita de coment\xE1rio exige. Rode `beplus-mcp login` de novo e autorize a permiss\xE3o de gastar/editar."
+        );
+      }
+      if (e.httpStatus === 403) throw new CanvasToolError(`Sem permiss\xE3o: ${e.message}.`);
+      if (e.httpStatus === 429) {
+        throw new CanvasToolError(
+          "Limite de escrita em coment\xE1rios (60 por minuto por pessoa) mesmo depois de esperar. Pare o lote, diga \xE0 pessoa quais j\xE1 foram fechados e siga daqui a 1 minuto a partir do pr\xF3ximo."
+        );
+      }
+      throw e;
+    }
+  }
+  const newReplyId = (thread) => {
+    const last = thread?.replies?.at(-1);
+    return last?.id ?? "?";
+  };
+  server.registerTool(
+    "canvas_list_comments",
+    {
+      title: "Canvas: listar coment\xE1rios",
+      description: "Lista os coment\xE1rios de um board (padr\xE3o: abertos): id, onde est\xE1 (n\xF3, vers\xE3o, minutagem da Montagem ou board), autor, pedido e respostas. Avisa quando o alvo sumiu. S\xF3 leitura.",
+      inputSchema: {
+        board_id: boardId,
+        status: external_exports.enum(["open", "resolved", "all"]).optional().describe("open (padr\xE3o), resolved ou all.")
+      },
+      annotations: { readOnlyHint: true, openWorldHint: false }
+    },
+    async ({ board_id, status }) => run(async () => {
+      const st = status ?? "open";
+      const [snap, threads] = await Promise.all([api.snapshot(board_id), api.listComments(board_id, st)]);
+      const text = commentsSummary(threads, snap.doc, st);
+      const open2 = threads.some((t) => !t.resolvedAt);
+      return open2 ? `${text}
+
+Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_* e feche com canvas_resolve_comment dizendo o que fez.` : text;
+    })
+  );
+  server.registerTool(
+    "canvas_reply_comment",
+    {
+      title: "Canvas: responder coment\xE1rio",
+      description: "Responde numa thread de coment\xE1rio sem resolver. Use para perguntar quando o pedido \xE9 amb\xEDguo ou o alvo sumiu.",
+      inputSchema: { board_id: boardId, comment_id: commentId, body, mentions },
+      annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
+    },
+    async ({ board_id, comment_id, body: text, mentions: m }) => run(async () => {
+      const thread = await onComment(
+        () => api.createComment(board_id, { body: text, parentId: comment_id, ...m?.length ? { mentions: m } : {} })
+      );
+      const open2 = thread?.resolvedAt ? "A thread est\xE1 resolvida; reabra com canvas_reopen_comment se precisar." : "A thread segue aberta.";
+      return `\u2705 Resposta ${newReplyId(thread)} em ${comment_id}: "${oneLine(text, 120)}". ${open2}`;
+    })
+  );
+  server.registerTool(
+    "canvas_resolve_comment",
+    {
+      title: "Canvas: resolver coment\xE1rio",
+      description: "Fecha um coment\xE1rio depois de aplicar o ajuste. done \xE9 obrigat\xF3rio: uma frase curta dizendo o que foi feito (vira resposta na thread antes de resolver). N\xE3o resolva pedido amb\xEDguo nem com alvo sumido: responda com pergunta.",
+      inputSchema: {
+        board_id: boardId,
+        comment_id: commentId,
+        done: external_exports.string().trim().min(3).max(500).describe('O que foi feito, ex.: "troquei a fala do b2 e encurtei o b3".')
+      },
+      annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
+    },
+    async ({ board_id, comment_id, done }) => run(async () => {
+      const thread = await onComment(() => api.createComment(board_id, { body: done, parentId: comment_id }));
+      const replyId = newReplyId(thread);
+      try {
+        await onComment(() => api.resolveComment(board_id, comment_id));
+      } catch (e) {
+        const why = e instanceof Error ? e.message : String(e);
+        throw new CanvasToolError(
+          `A resposta "${oneLine(done, 80)}" (${replyId}) foi postada em ${comment_id}, mas resolver falhou: ${why} N\xE3o repita canvas_resolve_comment (postaria a resposta de novo): avise a pessoa para resolver no Canvas.`
+        );
+      }
+      return `\u2705 Resolvido ${comment_id}: "${oneLine(done, 120)}" (resposta ${replyId}).`;
+    })
+  );
+  server.registerTool(
+    "canvas_reopen_comment",
+    {
+      title: "Canvas: reabrir coment\xE1rio",
+      description: "Reabre um coment\xE1rio resolvido. why (opcional) vira resposta na thread explicando o motivo.",
+      inputSchema: { board_id: boardId, comment_id: commentId, why: external_exports.string().trim().min(1).max(1e3).optional() },
+      annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
+    },
+    async ({ board_id, comment_id, why }) => run(async () => {
+      await onComment(() => api.reopenComment(board_id, comment_id));
+      if (why) await onComment(() => api.createComment(board_id, { body: why, parentId: comment_id }));
+      return `\u2705 Reaberto ${comment_id}${why ? ` com a resposta "${oneLine(why, 120)}"` : ""}.`;
+    })
+  );
+  server.registerTool(
+    "canvas_comment",
+    {
+      title: "Canvas: comentar",
+      description: "Cria um coment\xE1rio novo (raiz), ancorado para aparecer no lugar certo do Canvas. Use para deixar uma pergunta ou observa\xE7\xE3o para a pessoa. \xC2ncora: node_id (no n\xF3); node_id + output_key (numa vers\xE3o gerada); node_id + t em segundos (minutagem da Montagem ou do v\xEDdeo); x,y (ponto do board); nada = acima do conte\xFAdo do board.",
+      inputSchema: {
+        board_id: boardId,
+        body,
+        node_id: external_exports.string().min(1).max(64).optional(),
+        output_key: external_exports.string().min(1).max(128).optional().describe("Id da vers\xE3o (resultado) do n\xF3."),
+        t: external_exports.number().finite().min(0).optional().describe("Segundos desde o in\xEDcio."),
+        x: external_exports.number().finite().optional(),
+        y: external_exports.number().finite().optional(),
+        mentions
+      },
+      annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
+    },
+    async (args) => run(async () => {
+      if (!args.node_id && (args.output_key !== void 0 || args.t !== void 0)) {
+        throw new CanvasToolError("output_key e t precisam de node_id.");
+      }
+      if (args.output_key !== void 0 && args.t !== void 0) throw new CanvasToolError("Use output_key ou t, n\xE3o os dois.");
+      if (args.x === void 0 !== (args.y === void 0)) throw new CanvasToolError("Informe x e y juntos.");
+      const snap = await api.snapshot(args.board_id);
+      let anchor;
+      if (args.node_id) {
+        if (!snap.doc.nodes[args.node_id]) {
+          throw new CanvasToolError(`N\xF3 ${args.node_id} n\xE3o existe no board. Releia com canvas_read_board.`);
+        }
+        if (args.output_key !== void 0) anchor = { kind: "output", nodeId: args.node_id, outputKey: args.output_key };
+        else if (args.t !== void 0) anchor = { kind: "timecode", nodeId: args.node_id, t: args.t };
+        else anchor = { kind: "node", nodeId: args.node_id, dx: 0, dy: 0 };
+      } else if (args.x !== void 0 && args.y !== void 0) {
+        anchor = { kind: "point", x: args.x, y: args.y };
+      } else {
+        const nodes = Object.values(snap.doc.nodes);
+        anchor = nodes.length ? { kind: "point", x: Math.min(...nodes.map((n) => n.position.x)), y: Math.min(...nodes.map((n) => n.position.y)) - 80 } : { kind: "point", x: 0, y: 0 };
+      }
+      const created = await onComment(
+        () => api.createComment(args.board_id, {
+          body: args.body,
+          anchor,
+          ...args.mentions?.length ? { mentions: args.mentions } : {}
+        })
+      );
+      const where = describeAnchor(anchor, snap.doc).text;
+      const at = anchor.kind === "point" && args.x !== void 0 ? ` em (${args.x}, ${args.y})` : "";
+      return `\u2705 Coment\xE1rio ${created?.id ?? ""} criado ${where}${at}.`.replace("  ", " ");
+    })
+  );
+}
+
 // src/tools/canvas.ts
 var REJECT_TEXT = {
   "node-missing": "o n\xF3 n\xE3o existe mais (algu\xE9m apagou)",
@@ -24076,9 +24406,7 @@ var REJECT_TEXT = {
 };
 var SECTION_Z = -1e3;
 var GAP = 80;
-var CanvasToolError = class extends Error {
-};
-var boardId = external_exports.string().uuid().describe("Id (uuid) do board, como sai em canvas_list_boards.");
+var boardId2 = external_exports.string().uuid().describe("Id (uuid) do board, como sai em canvas_list_boards.");
 var nodeIdArg = external_exports.string().min(1).max(128);
 var point = external_exports.object({ x: external_exports.number().finite(), y: external_exports.number().finite() });
 function registerCanvasTools(server, client, cfg) {
@@ -24222,7 +24550,7 @@ Aviso: ${changesSince(theirs, doc)}.`;
       title: "Canvas: ler board",
       description: "L\xEA um board: n\xF3s (id, tipo, nome, campos principais), liga\xE7\xF5es e v\xEDnculo com o IA Lab, sem m\xEDdia. Obrigat\xF3rio antes de editar (vale para a sess\xE3o). node_ids devolve o data completo desses n\xF3s.",
       inputSchema: {
-        board_id: boardId,
+        board_id: boardId2,
         node_ids: external_exports.array(nodeIdArg).max(20).optional().describe("N\xF3s para ver o data inteiro (sem blobs).")
       },
       annotations: { readOnlyHint: true, openWorldHint: false }
@@ -24294,7 +24622,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
       title: "Canvas: adicionar n\xF3",
       description: `Adiciona um n\xF3 (n\xE3o executa). kind: ${kindList()}. data completa o padr\xE3o do tipo; label d\xE1 o nome. Sem position, nasce ao lado do n\xF3 ligado ou \xE0 direita do board. inputs/outputs j\xE1 ligam o n\xF3 no mesmo passo.`,
       inputSchema: {
-        board_id: boardId,
+        board_id: boardId2,
         kind: external_exports.string().min(1).max(40),
         label: external_exports.string().trim().min(1).max(120).optional().describe("Nome do cart\xE3o (data.label)."),
         data: external_exports.record(external_exports.unknown()).optional().describe("Campos do data. Ex.: narration {blocks:[{id,text}]}, text {text}, prompt {template}."),
@@ -24342,7 +24670,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
       title: "Canvas: editar n\xF3",
       description: "Muda campos do data de um n\xF3, chave a chave (null apaga a chave), sem executar. label renomeia. N\xE3o troca o tipo. Leia o n\xF3 com node_ids antes para n\xE3o sobrescrever o que outra pessoa escreveu.",
       inputSchema: {
-        board_id: boardId,
+        board_id: boardId2,
         node_id: nodeIdArg,
         data: external_exports.record(external_exports.unknown()).optional().describe("Chaves de data a gravar. Valor null apaga a chave."),
         label: external_exports.string().trim().min(1).max(120).optional(),
@@ -24379,7 +24707,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
       title: "Canvas: ligar portas",
       description: "Liga a sa\xEDda de um n\xF3 \xE0 entrada de outro (ids e portas de canvas_read_board). Liga\xE7\xE3o repetida \xE9 ignorada.",
       inputSchema: {
-        board_id: boardId,
+        board_id: boardId2,
         source: nodeIdArg,
         source_port: external_exports.string().min(1).max(80),
         target: nodeIdArg,
@@ -24406,7 +24734,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
       title: "Canvas: apagar n\xF3s/liga\xE7\xF5es",
       description: "Apaga n\xF3s (com as liga\xE7\xF5es e varia\xE7\xF5es deles) e/ou liga\xE7\xF5es, num passo s\xF3. Irrevers\xEDvel pelo MCP: confirme com o usu\xE1rio antes. N\xE3o apaga o board.",
       inputSchema: {
-        board_id: boardId,
+        board_id: boardId2,
         node_ids: external_exports.array(nodeIdArg).max(200).optional(),
         edge_ids: external_exports.array(nodeIdArg).max(200).optional()
       },
@@ -24450,7 +24778,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
     {
       title: "Canvas: renomear board",
       description: "Troca o t\xEDtulo do board (board.set). Precisa de papel de editor ou dono.",
-      inputSchema: { board_id: boardId, title: external_exports.string().trim().min(1).max(200) },
+      inputSchema: { board_id: boardId2, title: external_exports.string().trim().min(1).max(200) },
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
     async ({ board_id, title }) => run(
@@ -24466,7 +24794,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
     {
       title: "Canvas: membros do board",
       description: "Lista quem tem acesso ao board (userId, nome, papel). S\xF3 leitura.",
-      inputSchema: { board_id: boardId },
+      inputSchema: { board_id: boardId2 },
       annotations: { readOnlyHint: true, openWorldHint: false }
     },
     async ({ board_id }) => run(async () => {
@@ -24483,7 +24811,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
       title: "Canvas: adicionar membro",
       description: "D\xE1 acesso ao board (ou troca o papel) para um usu\xE1rio pelo userId (uuid). S\xF3 o dono pode. Ainda n\xE3o h\xE1 busca por e-mail: pe\xE7a o userId ou copie de canvas_list_members de outro board.",
       inputSchema: {
-        board_id: boardId,
+        board_id: boardId2,
         user_id: external_exports.string().uuid(),
         role: external_exports.enum(["editor", "viewer"]).describe("editor edita; viewer s\xF3 v\xEA.")
       },
@@ -24499,7 +24827,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
     {
       title: "Canvas: remover membro",
       description: "Tira o acesso de algu\xE9m ao board (o dono tira qualquer um; quem n\xE3o \xE9 dono s\xF3 sai sozinho). O dono n\xE3o sai.",
-      inputSchema: { board_id: boardId, user_id: external_exports.string().uuid() },
+      inputSchema: { board_id: boardId2, user_id: external_exports.string().uuid() },
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
     async ({ board_id, user_id }) => run(async () => {
@@ -24507,13 +24835,14 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
       return `\u2705 ${user_id} n\xE3o tem mais acesso ao board.`;
     })
   );
+  registerCanvasCommentTools(server, api, run);
 }
 
 // src/version.ts
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
 function readVersion() {
-  if ("0.26.0") return "0.26.0";
+  if ("0.27.0") return "0.27.0";
   try {
     const pkg = require2("../package.json");
     return pkg.version ?? "0.0.0-unknown";
@@ -24528,7 +24857,8 @@ var SERVER_INSTRUCTIONS = [
   "BePlus: tudo roda pela conta do usu\xE1rio (diamantes, limites e hist\xF3rico na plataforma).",
   'M\xEDdia: generate_* gasta diamantes; confira com estimate_cost antes de lotes grandes. Sem project, a gera\xE7\xE3o cai no projeto ativo; billing:"personal" cobra do usu\xE1rio.',
   "Calls: search_calls acha, get_call traz a transcri\xE7\xE3o.",
-  "Canvas online (canvas_*): leia com canvas_read_board antes de editar e siga o estado lido. Cada edi\xE7\xE3o vai num passo s\xF3; se outra pessoa mexeu nos mesmos n\xF3s, a ferramenta recusa e pede releitura. As ferramentas canvas_* n\xE3o geram m\xEDdia nem gastam diamantes: quem roda os n\xF3s \xE9 o usu\xE1rio no Canvas. D\xEA nome (label) aos n\xF3s, n\xE3o invente tipos nem portas, e confirme antes de canvas_delete."
+  "Canvas online (canvas_*): leia com canvas_read_board antes de editar e siga o estado lido. Cada edi\xE7\xE3o vai num passo s\xF3; se outra pessoa mexeu nos mesmos n\xF3s, a ferramenta recusa e pede releitura. As ferramentas canvas_* n\xE3o geram m\xEDdia nem gastam diamantes: quem roda os n\xF3s \xE9 o usu\xE1rio no Canvas. D\xEA nome (label) aos n\xF3s, n\xE3o invente tipos nem portas, e confirme antes de canvas_delete.",
+  '"Aplica os coment\xE1rios" do board: canvas_list_comments (abertos) \u2192 para cada um, leia o n\xF3 ancorado com canvas_read_board (node_ids), aplique a edi\xE7\xE3o pelas canvas_* e feche com canvas_resolve_comment dizendo em uma frase o que fez. Coment\xE1rio amb\xEDguo ou com alvo sumido: responda com pergunta (canvas_reply_comment) e n\xE3o resolva. D\xFAvida sua sobre um n\xF3: canvas_comment ancorado nele. As escritas j\xE1 saem espa\xE7adas (60/min); se ainda vier limite, pare e diga de onde seguir.'
 ].join("\n");
 function buildServer(cfg) {
   const server = new McpServer({ name: "beplus", version: VERSION }, { instructions: SERVER_INSTRUCTIONS });
@@ -24782,16 +25112,16 @@ async function json(url, init) {
     throw new Error(`Nao consegui falar com ${new URL(url).origin}. Confira a rede e o BEPLUS_API_URL.`);
   }
   const text = await res.text();
-  let body;
+  let body2;
   try {
-    body = text ? JSON.parse(text) : void 0;
+    body2 = text ? JSON.parse(text) : void 0;
   } catch {
   }
   if (!res.ok) {
-    const msg = body?.message ?? body?.error_description ?? body?.error ?? `HTTP ${res.status}`;
+    const msg = body2?.message ?? body2?.error_description ?? body2?.error ?? `HTTP ${res.status}`;
     throw new Error(`${msg} (${url})`);
   }
-  return body;
+  return body2;
 }
 async function discover(apiUrl2) {
   const meta = await json(`${apiUrl2}/.well-known/oauth-authorization-server`);