beplus-mcp 0.30.0 → 0.31.0

package/dist/index.js

@@ -6145,11 +6145,11 @@ var require_format = __commonJS({
           }
           function getFormat(fmtDef) {
             const code = fmtDef instanceof RegExp ? (0, codegen_1.regexpCode)(fmtDef) : opts.code.formats ? (0, codegen_1._)`${opts.code.formats}${(0, codegen_1.getProperty)(schema)}` : void 0;
-            const fmt2 = gen.scopeValue("formats", { key: schema, ref: fmtDef, code });
+            const fmt3 = gen.scopeValue("formats", { key: schema, ref: fmtDef, code });
             if (typeof fmtDef == "object" && !(fmtDef instanceof RegExp)) {
-              return [fmtDef.type || "string", fmtDef.validate, (0, codegen_1._)`${fmt2}.validate`];
+              return [fmtDef.type || "string", fmtDef.validate, (0, codegen_1._)`${fmt3}.validate`];
             }
-            return ["string", fmtDef, fmt2];
+            return ["string", fmtDef, fmt3];
           }
           function validCondition() {
             if (typeof formatDef == "object" && !(formatDef instanceof RegExp) && formatDef.async) {
@@ -6811,8 +6811,8 @@ var require_limit = __commonJS({
             ref: self.formats,
             code: opts.code.formats
           });
-          const fmt2 = gen.const("fmt", (0, codegen_1._)`${fmts}[${fCxt.schemaCode}]`);
-          cxt.fail$data((0, codegen_1.or)((0, codegen_1._)`typeof ${fmt2} != "object"`, (0, codegen_1._)`${fmt2} instanceof RegExp`, (0, codegen_1._)`typeof ${fmt2}.compare != "function"`, compareCode(fmt2)));
+          const fmt3 = gen.const("fmt", (0, codegen_1._)`${fmts}[${fCxt.schemaCode}]`);
+          cxt.fail$data((0, codegen_1.or)((0, codegen_1._)`typeof ${fmt3} != "object"`, (0, codegen_1._)`${fmt3} instanceof RegExp`, (0, codegen_1._)`typeof ${fmt3}.compare != "function"`, compareCode(fmt3)));
         }
         function validateFormat() {
           const format = fCxt.schema;
@@ -6822,15 +6822,15 @@ var require_limit = __commonJS({
           if (typeof fmtDef != "object" || fmtDef instanceof RegExp || typeof fmtDef.compare != "function") {
             throw new Error(`"${keyword}": format "${format}" does not define "compare" function`);
           }
-          const fmt2 = gen.scopeValue("formats", {
+          const fmt3 = gen.scopeValue("formats", {
             key: format,
             ref: fmtDef,
             code: opts.code.formats ? (0, codegen_1._)`${opts.code.formats}${(0, codegen_1.getProperty)(format)}` : void 0
           });
-          cxt.fail$data(compareCode(fmt2));
+          cxt.fail$data(compareCode(fmt3));
         }
-        function compareCode(fmt2) {
-          return (0, codegen_1._)`${fmt2}.compare(${data}, ${schemaCode}) ${KWDs[keyword].fail} 0`;
+        function compareCode(fmt3) {
+          return (0, codegen_1._)`${fmt3}.compare(${data}, ${schemaCode}) ${KWDs[keyword].fail} 0`;
         }
       },
       dependencies: ["format"]
@@ -23015,15 +23015,15 @@ function probeJpeg(b) {
 function probeWebp(b) {
   if (b.length < 30) return null;
   if (b.toString("ascii", 0, 4) !== "RIFF" || b.toString("ascii", 8, 12) !== "WEBP") return null;
-  const fmt2 = b.toString("ascii", 12, 16);
-  if (fmt2 === "VP8 ") {
+  const fmt3 = b.toString("ascii", 12, 16);
+  if (fmt3 === "VP8 ") {
     return { width: b.readUInt16LE(26) & 16383, height: b.readUInt16LE(28) & 16383 };
   }
-  if (fmt2 === "VP8L") {
+  if (fmt3 === "VP8L") {
     const bits = b.readUInt32LE(21);
     return { width: (bits & 16383) + 1, height: (bits >> 14 & 16383) + 1 };
   }
-  if (fmt2 === "VP8X") {
+  if (fmt3 === "VP8X") {
     const w = b[24] | b[25] << 8 | b[26] << 16;
     const h = b[27] | b[28] << 8 | b[29] << 16;
     return { width: w + 1, height: h + 1 };
@@ -24086,6 +24086,7 @@ import { createHash } from "crypto";
 
 // src/canvas/api.ts
 var PINNED_CORE_VERSION = "ca7b3b406184c7f679f555c3a008013197182b23";
+var RUN_REQUEST_TIMEOUT_MS = 4e4;
 function errorRaw(err) {
   if (!(err instanceof ApiError)) return void 0;
   const raw = err.body?.error?.raw;
@@ -24126,13 +24127,13 @@ var CanvasApi = class {
   createBoard(body2) {
     return this.req("POST", "/boards", { body: body2 });
   }
-  snapshot(boardId3) {
-    return this.req("GET", `/boards/${boardId3}`);
+  snapshot(boardId4) {
+    return this.req("GET", `/boards/${boardId4}`);
   }
   /** Replay depois de `after`. `null` quando o servidor manda reler a foto (410). */
-  async opsAfter(boardId3, after) {
+  async opsAfter(boardId4, after) {
     try {
-      const { envelopes } = await this.req("GET", `/boards/${boardId3}/ops`, {
+      const { envelopes } = await this.req("GET", `/boards/${boardId4}/ops`, {
         query: { after }
       });
       return envelopes;
@@ -24141,8 +24142,8 @@ var CanvasApi = class {
       throw e;
     }
   }
-  async commit(boardId3, ops) {
-    const send = () => this.req("POST", `/boards/${boardId3}/ops`, {
+  async commit(boardId4, ops) {
+    const send = () => this.req("POST", `/boards/${boardId4}/ops`, {
       body: { coreVersion: this.coreVersion, ops }
     });
     try {
@@ -24163,18 +24164,18 @@ var CanvasApi = class {
       }
     }
   }
-  members(boardId3) {
-    return this.req("GET", `/boards/${boardId3}/members`);
+  members(boardId4) {
+    return this.req("GET", `/boards/${boardId4}/members`);
   }
-  putMember(boardId3, userId, role) {
-    return this.req("PUT", `/boards/${boardId3}/members/${userId}`, { body: { role } });
+  putMember(boardId4, userId, role) {
+    return this.req("PUT", `/boards/${boardId4}/members/${userId}`, { body: { role } });
   }
-  removeMember(boardId3, userId) {
-    return this.req("DELETE", `/boards/${boardId3}/members/${userId}`);
+  removeMember(boardId4, userId) {
+    return this.req("DELETE", `/boards/${boardId4}/members/${userId}`);
   }
   // ── comentários (academy-backend #313) ────────────────────────────────────
-  listComments(boardId3, status = "open") {
-    return this.req("GET", `/boards/${boardId3}/comments`, { query: { status } });
+  listComments(boardId4, status = "open") {
+    return this.req("GET", `/boards/${boardId4}/comments`, { query: { status } });
   }
   /**
    * Escrita de comentário passa por aqui: o back limita a 60 por minuto por pessoa
@@ -24200,14 +24201,25 @@ var CanvasApi = class {
     }
   }
   /** 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);
+  createComment(boardId4, body2) {
+    return this.write("POST", `/boards/${boardId4}/comments`, body2);
   }
-  resolveComment(boardId3, commentId2) {
-    return this.write("POST", `/boards/${boardId3}/comments/${commentId2}/resolve`);
+  resolveComment(boardId4, commentId2) {
+    return this.write("POST", `/boards/${boardId4}/comments/${commentId2}/resolve`);
   }
-  reopenComment(boardId3, commentId2) {
-    return this.write("POST", `/boards/${boardId3}/comments/${commentId2}/reopen`);
+  reopenComment(boardId4, commentId2) {
+    return this.write("POST", `/boards/${boardId4}/comments/${commentId2}/reopen`);
+  }
+  // ── execução pela aba do Canvas (CR1, academy-backend #318) ───────────────
+  /**
+   * Pede para a aba do Canvas da pessoa rodar. O servidor espera a aba até 20 s;
+   * aqui a espera é maior para o prazo do servidor vencer antes do nosso.
+   */
+  runRequest(boardId4, body2) {
+    return this.req("POST", `/boards/${boardId4}/run-requests`, { body: body2, timeoutMs: RUN_REQUEST_TIMEOUT_MS });
+  }
+  runStatus(boardId4, requestId) {
+    return this.req("GET", `/boards/${boardId4}/run-requests/${requestId}`);
   }
   /** Só para os testes conferirem o aprendizado. */
   get currentCoreVersion() {
@@ -24483,8 +24495,8 @@ function checkOp(op) {
       return null;
   }
 }
-function envelope(boardId3, op, actorId) {
-  return { id: randomUUID(), boardId: boardId3, clientId: CLIENT_ID, actorId, seq: null, ts: Date.now(), op };
+function envelope(boardId4, op, actorId) {
+  return { id: randomUUID(), boardId: boardId4, clientId: CLIENT_ID, actorId, seq: null, ts: Date.now(), op };
 }
 function checkEnvelope(env) {
   const bad = checkOp(env.op);
@@ -24539,13 +24551,13 @@ function makeEdge(init) {
 }
 var setValue = (value) => ({ kind: "value", value });
 var unsetValue = () => ({ kind: "unset" });
-function removeNodeOps(doc, nodeId) {
+function removeNodeOps(doc, nodeId2) {
   const ops = [];
-  const edgeIds = Object.keys(doc.edges).filter((id) => doc.edges[id].source === nodeId || doc.edges[id].target === nodeId).sort();
+  const edgeIds = Object.keys(doc.edges).filter((id) => doc.edges[id].source === nodeId2 || doc.edges[id].target === nodeId2).sort();
   for (const edgeId of edgeIds) ops.push({ type: "edge.remove", edgeId });
-  const history = Object.hasOwn(doc.nodeHistory, nodeId) ? doc.nodeHistory[nodeId] : void 0;
-  if (history) for (const resultId of [...history].reverse()) ops.push({ type: "history.remove", nodeId, resultId });
-  ops.push({ type: "node.remove", nodeId });
+  const history = Object.hasOwn(doc.nodeHistory, nodeId2) ? doc.nodeHistory[nodeId2] : void 0;
+  if (history) for (const resultId of [...history].reverse()) ops.push({ type: "history.remove", nodeId: nodeId2, resultId });
+  ops.push({ type: "node.remove", nodeId: nodeId2 });
   return ops;
 }
 function batchOf(ops) {
@@ -24561,14 +24573,14 @@ var OpTooLargeError = class extends Error {
   op;
   bytes;
 };
-function packEnvelopes(boardId3, ops, actorId, limit = MAX_OP_BYTES - 1024) {
+function packEnvelopes(boardId4, ops, actorId, limit = MAX_OP_BYTES - 1024) {
   const bytes = (v) => Buffer.byteLength(JSON.stringify(v));
-  const overhead = bytes(envelope(boardId3, { type: "batch", ops: [] }, actorId));
+  const overhead = bytes(envelope(boardId4, { type: "batch", ops: [] }, actorId));
   const out = [];
   let cur = [];
   let size = overhead;
   const flush = () => {
-    if (cur.length) out.push(envelope(boardId3, batchOf(cur), actorId));
+    if (cur.length) out.push(envelope(boardId4, batchOf(cur), actorId));
     cur = [];
     size = overhead;
   };
@@ -24946,8 +24958,8 @@ function mmss(t) {
   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];
+function nodeRef(doc, nodeId2) {
+  const node = doc.nodes[nodeId2];
   const kind = nodeKind(node) ?? node.type;
   return `"${oneLine(nodeName(node), 60)}" (${kind}, ${node.id})`;
 }
@@ -24971,13 +24983,13 @@ function outputKeyOf(entry) {
   if (typeof entry.url === "string" && entry.url !== "") return `url-${hashString(entry.url)}`;
   return null;
 }
-function versionOf(doc, nodeId, outputKey) {
-  const ids = doc.nodeHistory?.[nodeId];
+function versionOf(doc, nodeId2, outputKey) {
+  const ids = doc.nodeHistory?.[nodeId2];
   if (Array.isArray(ids)) {
     const i = ids.indexOf(outputKey);
     if (i >= 0) return i + 1;
   }
-  const history = doc.nodes[nodeId]?.data.history;
+  const history = doc.nodes[nodeId2]?.data.history;
   if (Array.isArray(history)) {
     const i = history.findIndex(
       (h) => typeof h === "object" && h !== null && !Array.isArray(h) && outputKeyOf(h) === outputKey
@@ -25447,17 +25459,17 @@ function holdsOne(doc, node) {
   if (node.data.holds === "many") return false;
   return itemsOf(node).length === 1 && Object.values(doc.edges).some((e) => e.source === node.id);
 }
-function needMediaNode(doc, nodeId) {
-  const node = doc.nodes[nodeId];
-  if (!node) throw new CanvasToolError(`N\xF3 ${nodeId} n\xE3o existe no board. Releia com canvas_read_board.`);
+function needMediaNode(doc, nodeId2) {
+  const node = doc.nodes[nodeId2];
+  if (!node) throw new CanvasToolError(`N\xF3 ${nodeId2} n\xE3o existe no board. Releia com canvas_read_board.`);
   if (nodeKind(node) !== "media") {
     throw new CanvasToolError(
-      `O n\xF3 ${nodeId} ("${oneLine(nodeName(node), 40)}") \xE9 ${nodeKind(node) ?? node.type}, n\xE3o M\xEDdia. Passe o id de um n\xF3 media, ou omita node_id para criar um n\xF3 M\xEDdia novo.`
+      `O n\xF3 ${nodeId2} ("${oneLine(nodeName(node), 40)}") \xE9 ${nodeKind(node) ?? node.type}, n\xE3o M\xEDdia. Passe o id de um n\xF3 media, ou omita node_id para criar um n\xF3 M\xEDdia novo.`
     );
   }
   return node;
 }
-function payload(u, nodeId) {
+function payload(u, nodeId2) {
   const out = { url: u.url, mime: u.mime, bytes: u.bytes };
   if (u.meta.duration !== void 0) out.duration = u.meta.duration;
   if (u.meta.width !== void 0) out.width = u.meta.width;
@@ -25466,14 +25478,14 @@ function payload(u, nodeId) {
   out.media_item = mediaItem(u);
   if (u.kind !== "file") {
     out.sequence_asset = sequenceAsset(u);
-    out.libraryItemId = libraryItemId(u, nodeId);
+    out.libraryItemId = libraryItemId(u, nodeId2);
   }
   return JSON.stringify(out);
 }
-function sequenceHint(u, nodeId) {
+function sequenceHint(u, nodeId2) {
   if (u.kind === "file") return "Documento: entra no n\xF3 M\xEDdia, n\xE3o na timeline da Montagem.";
   const lines = [
-    "Num clipe da timeline da Montagem (data.timeline; data.sequence s\xF3 em n\xF3 que ainda n\xE3o migrou): use sequence_asset como `asset` e libraryItemId como est\xE1" + (nodeId ? "." : ", trocando <id do n\xF3 M\xEDdia> pelo id do n\xF3 onde o item ficou.")
+    "Num clipe da timeline da Montagem (data.timeline; data.sequence s\xF3 em n\xF3 que ainda n\xE3o migrou): use sequence_asset como `asset` e libraryItemId como est\xE1" + (nodeId2 ? "." : ", trocando <id do n\xF3 M\xEDdia> pelo id do n\xF3 onde o item ficou.")
   ];
   if (u.meta.duration !== void 0) {
     const at30 = Math.floor(u.meta.duration * 30 + 1e-9);
@@ -25530,14 +25542,14 @@ URL: ${u.url}`;
       if (!args.board_id) {
         return [head, "", payload(u), "", sequenceHint(u)].join("\n");
       }
-      const boardId3 = args.board_id;
-      let nodeId = args.node_id;
+      const boardId4 = args.board_id;
+      let nodeId2 = args.node_id;
       let done;
       try {
-        done = await edit(boardId3, async (doc) => {
+        done = await edit(boardId4, async (doc) => {
           const item = mediaItem(u);
-          if (nodeId) {
-            const node = needMediaNode(doc, nodeId);
+          if (nodeId2) {
+            const node = needMediaNode(doc, nodeId2);
             const replacing = args.replace ?? holdsOne(doc, node);
             const items = replacing ? [item] : [...itemsOf(node), item];
             if (items.length > MAX_MEDIA_ITEMS) {
@@ -25559,7 +25571,7 @@ URL: ${u.url}`;
             zIndex: Object.values(doc.nodes).reduce((t, n) => Math.max(t, n.zIndex), 0) + 1,
             createdBy: await api.me()
           });
-          nodeId = created.id;
+          nodeId2 = created.id;
           return {
             ops: [{ type: "node.add", nodeId: created.id, node: created }],
             targets: [],
@@ -25575,11 +25587,253 @@ N\xE3o suba de novo: releia com canvas_read_board e grave media_item em data.ite
 ${payload(u)}`
         );
       }
-      return [head, done, "", payload(u, nodeId), "", sequenceHint(u, nodeId)].join("\n");
+      return [head, done, "", payload(u, nodeId2), "", sequenceHint(u, nodeId2)].join("\n");
     })
   );
 }
 
+// src/tools/canvas-run.ts
+import { randomUUID as randomUUID3 } from "crypto";
+var MAX_REMEMBERED = 50;
+var boardId2 = external_exports.string().uuid().describe("Id (uuid) do board.");
+var nodeId = external_exports.string().min(1).max(128);
+var fmt2 = (n) => new Intl.NumberFormat("pt-BR").format(n);
+var dia = (n) => n === null || n === void 0 ? "sem estimativa" : `${fmt2(n)} \u{1F48E}`;
+function prettyClient(name) {
+  if (!name) return "MCP";
+  return name.split(/[-_\s]+/).filter(Boolean).map((w) => w[0].toUpperCase() + w.slice(1)).join(" ").slice(0, 80);
+}
+function modeText(mode) {
+  return mode === "simulated" ? "Simulado (n\xE3o gasta)" : mode === "live" ? "Real" : mode ?? "?";
+}
+function estimateLines(estimate, titleOf) {
+  if (!estimate) return [];
+  const lines = [];
+  const nodes = estimate.nodes ?? [];
+  const now = nodes.filter((n) => n.willRun);
+  for (const n of now) {
+    const cost = n.error ? `estimativa falhou (${n.error})` : dia(n.diamonds);
+    lines.push(`- ${n.title ?? titleOf(n.nodeId)} (${n.nodeId}): ${cost}`);
+  }
+  const cached2 = nodes.filter((n) => !n.willRun && !n.afterApproval).length;
+  if (cached2) lines.push(`Em cache (n\xE3o rodam): ${cached2}.`);
+  const later = estimate.later?.nodes?.length ?? 0;
+  if (later) lines.push(`Esperando aprova\xE7\xE3o no board depois disso: ${later} n\xF3(s), \u2248 ${dia(estimate.later?.total ?? 0)} (fora desta conta).`);
+  if (estimate.unknown?.length) {
+    lines.push(`Sem estimativa: ${estimate.unknown.length} n\xF3(s) (texto cobra por token; o total \xE9 piso).`);
+  }
+  return lines;
+}
+function targetOf(args) {
+  const given = [args.node_ids?.length ? 1 : 0, args.from_node_id ? 1 : 0, args.all ? 1 : 0].reduce((a, b) => a + b, 0);
+  if (given !== 1) {
+    throw new CanvasToolError("Diga o que rodar com UM destes: node_ids (os n\xF3s), from_node_id (daqui para frente) ou all: true (tudo).");
+  }
+  if (args.all) return { kind: "all" };
+  if (args.from_node_id) return { kind: "from", nodeId: args.from_node_id };
+  return { kind: "nodes", nodeIds: [...new Set(args.node_ids)] };
+}
+function registerCanvasRunTools(server, api, run) {
+  const remembered = /* @__PURE__ */ new Map();
+  const remember = (requestId, entry) => {
+    remembered.delete(requestId);
+    remembered.set(requestId, entry);
+    while (remembered.size > MAX_REMEMBERED) remembered.delete(remembered.keys().next().value);
+  };
+  async function titles(board) {
+    try {
+      const snap = await api.snapshot(board);
+      return (id) => snap.doc.nodes[id] ? nodeName(snap.doc.nodes[id]) : id;
+    } catch {
+      return (id) => id;
+    }
+  }
+  function explain(e, requestId) {
+    if (!(e instanceof ApiError)) throw e;
+    const reason = errorRaw(e)?.reason;
+    const unknownFate = requestId && (e.httpStatus === 0 || e.httpStatus === 408 || reason === "tab-timeout" || reason === "tab-bad-answer" || e.httpStatus >= 500 && e.httpStatus !== 501);
+    if (unknownFate) {
+      throw new CanvasToolError(
+        `N\xE3o d\xE1 para saber se a aba come\xE7ou a rodar (${e.message}). N\xC3O pe\xE7a um pedido novo: consulte canvas_run_status com request_id "${requestId}". Se precisar repetir, chame canvas_run com o mesmo request_id: \xE9 seguro, a aba n\xE3o roda duas vezes.`
+      );
+    }
+    if (reason === "no-tab") {
+      throw new CanvasToolError(
+        "Nenhuma aba do Canvas sua est\xE1 aberta neste board (ou a aba \xE9 de uma vers\xE3o sem esta fun\xE7\xE3o). Pe\xE7a para abrir o board no Canvas com a mesma conta deste MCP e tente de novo. Nada rodou."
+      );
+    }
+    if (e.httpStatus === 404 && reason !== "unknown-request") {
+      if (!/board/i.test(e.message)) {
+        throw new CanvasToolError("O servidor do Canvas ainda n\xE3o tem a execu\xE7\xE3o pelo MCP (academy-backend sem a CR1). Nada rodou.");
+      }
+      throw new CanvasToolError("Board n\xE3o encontrado, ou voc\xEA n\xE3o \xE9 membro dele. Confira o id em canvas_list_boards.");
+    }
+    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 rodar exige. Rode `beplus-mcp login` de novo e autorize."
+      );
+    }
+    if (e.httpStatus === 403) throw new CanvasToolError(`Sem permiss\xE3o para rodar neste board (s\xF3 dono e editor rodam): ${e.message}.`);
+    if (e.httpStatus === 400) throw new CanvasToolError(`O servidor recusou o pedido: ${e.message}.`);
+    if (e.httpStatus === 429) throw new CanvasToolError("Limite de pedidos de execu\xE7\xE3o (20 por minuto). Espere um minuto.");
+    throw e;
+  }
+  function answerText(a, requestId, max, titleOf) {
+    const est = estimateLines(a.estimate, titleOf);
+    const total = a.estimate ? `${dia(a.estimate.total)} (teto ${fmt2(max)})` : "";
+    const again = a.repeated ? " (a aba j\xE1 tinha recebido este request_id; esta \xE9 a mesma resposta)" : "";
+    if (a.status === "estimate") {
+      return [`Estimativa, nada rodou${again}. Modo ${modeText(a.mode)}. Total agora: ${total}.`, ...est, cabeLine(a, max)].filter(Boolean).join("\n");
+    }
+    if (a.status === "nothing") return `Nada para rodar${again}: ${a.message ?? "o board j\xE1 est\xE1 em dia."}`;
+    const willRun = (a.estimate?.nodes ?? []).filter((n) => n.willRun).map((n) => n.nodeId);
+    return [
+      `Rodando pela sua aba do Canvas${again}. Modo ${modeText(a.mode)}. Estimativa: ${total}.`,
+      ...est,
+      `request_id: ${requestId}. Andamento: canvas_run_status (board_id, request_id). Resultado: canvas_read_board com node_ids [${willRun.slice(0, 20).join(", ")}] quando terminar.`
+    ].join("\n");
+  }
+  function cabeLine(a, max) {
+    if (!a.estimate) return "";
+    return a.estimate.total <= max ? "Cabe no teto: repita sem dry_run para rodar." : `Passa do teto (${fmt2(max)}): s\xF3 roda com max_diamonds maior, se o usu\xE1rio autorizar.`;
+  }
+  server.registerTool(
+    "canvas_run",
+    {
+      title: "Canvas: rodar n\xF3s",
+      description: "Roda n\xF3s do board pela aba do Canvas que o usu\xE1rio tem aberta nele (mesma conta; sem aba aberta, nada roda). GASTA DIAMANTES no modo Real. A aba estima como o bot\xE3o Rodar e s\xF3 roda se a estimativa couber em max_diamonds (obrigat\xF3rio: o teto que o usu\xE1rio autorizou; nunca invente um valor alto). dry_run: true s\xF3 estima. Alvo, um destes: node_ids (roda esses n\xF3s mesmo em cache, gerando e gastando de novo, como o Rodar do cart\xE3o), from_node_id (o n\xF3 e tudo depois dele, tamb\xE9m de novo) ou all: true (s\xF3 o que mudou, como o Rodar tudo). simulated: true s\xF3 vale com a aba no modo Simulado; sem ele, a aba precisa estar no Real. Prompt com PT editado e sem aplicar no EN: a aba recusa e diz qual (aplique no cart\xE3o). Devolve o que vai rodar, o custo e o request_id; acompanhe com canvas_run_status e leia o resultado com canvas_read_board. Se a resposta disser que n\xE3o d\xE1 para saber se come\xE7ou, consulte o andamento e, para repetir, use o MESMO request_id.",
+      inputSchema: {
+        board_id: boardId2,
+        node_ids: external_exports.array(nodeId).min(1).max(100).optional().describe("Os n\xF3s a rodar (como o Rodar do cart\xE3o/sele\xE7\xE3o)."),
+        from_node_id: nodeId.optional().describe("Rodar daqui para frente: este n\xF3 e tudo que depende dele."),
+        all: external_exports.boolean().optional().describe("true: Rodar tudo (s\xF3 o que mudou)."),
+        max_diamonds: external_exports.number().finite().min(0).max(1e6).describe("Teto de diamantes desta execu\xE7\xE3o. Obrigat\xF3rio."),
+        dry_run: external_exports.boolean().optional().describe("true: s\xF3 estima, nada roda."),
+        simulated: external_exports.boolean().optional().describe("true: o pedido \xE9 para o modo Simulado (a aba precisa estar nele)."),
+        label: external_exports.string().trim().min(1).max(80).optional().describe('Quem pede, como a aba mostra ("Rodando a pedido de \u2026").'),
+        request_id: external_exports.string().uuid().optional().describe("S\xF3 para repetir um pedido cujo destino ficou incerto.")
+      },
+      annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
+    },
+    async (args) => run(async () => {
+      const target = targetOf(args);
+      const requestId = (args.request_id ?? randomUUID3()).toLowerCase();
+      const label = args.label ?? prettyClient(server.server.getClientVersion()?.name);
+      let answer;
+      try {
+        answer = await api.runRequest(args.board_id, {
+          requestId,
+          target,
+          maxDiamonds: args.max_diamonds,
+          dryRun: args.dry_run === true,
+          simulated: args.simulated === true,
+          label
+        });
+      } catch (e) {
+        explain(e, requestId);
+      }
+      const titleOf = await titles(args.board_id);
+      if (answer.ok !== true) {
+        const est = estimateLines(answer.estimate, titleOf);
+        throw new CanvasToolError(
+          [`A aba recusou, nada rodou (${answer.reason ?? "sem motivo"}): ${answer.message ?? ""}`.trim(), ...est].join("\n")
+        );
+      }
+      const nodeIds = (answer.estimate?.nodes ?? []).filter((n) => n.willRun).map((n) => n.nodeId);
+      if (answer.status === "started") {
+        remember(requestId, {
+          boardId: args.board_id,
+          nodeIds: nodeIds.length ? nodeIds : target.kind === "nodes" ? target.nodeIds : target.kind === "from" ? [target.nodeId] : []
+        });
+      }
+      return answerText(answer, requestId, args.max_diamonds, titleOf);
+    })
+  );
+  server.registerTool(
+    "canvas_run_status",
+    {
+      title: "Canvas: andamento da execu\xE7\xE3o",
+      description: "Andamento de um pedido do canvas_run: estado de cada n\xF3, estimado e gasto. Pergunta \xE0 aba do Canvas que rodou; se ela fechou, l\xEA o estado de execu\xE7\xE3o do board para os n\xF3s do pedido (os que este MCP lembra, ou node_ids). S\xF3 leitura.",
+      inputSchema: {
+        board_id: boardId2,
+        request_id: external_exports.string().uuid().describe("O request_id que o canvas_run devolveu."),
+        node_ids: external_exports.array(nodeId).min(1).max(100).optional().describe("Os n\xF3s a conferir, se o MCP n\xE3o lembra do pedido.")
+      },
+      annotations: { readOnlyHint: true, openWorldHint: true }
+    },
+    async ({ board_id, request_id, node_ids }) => run(async () => {
+      const requestId = request_id.toLowerCase();
+      let why = "";
+      try {
+        return statusText(await api.runStatus(board_id, requestId), await titles(board_id));
+      } catch (e) {
+        const reason = errorRaw(e)?.reason;
+        if (!(e instanceof ApiError) || reason !== "unknown-request" && reason !== "no-tab") explain(e);
+        why = reason === "no-tab" ? "Nenhuma aba do Canvas sua est\xE1 aberta neste board." : "Nenhuma aba aberta conhece este pedido.";
+      }
+      const ids = node_ids ?? remembered.get(requestId)?.nodeIds;
+      if (!ids?.length) {
+        return `${why} Sem a aba, o andamento sai do estado de execu\xE7\xE3o do board: chame de novo com node_ids (os n\xF3s que o pedido rodava).`;
+      }
+      return `${why} Pelo estado de execu\xE7\xE3o do board:
+${fromRuns(await api.snapshot(board_id), ids)}`;
+    })
+  );
+}
+var STATE_TEXT = {
+  preparing: "a aba est\xE1 estimando e conferindo",
+  running: "rodando",
+  done: "terminou",
+  failed: "terminou com erro",
+  cancelled: "cancelado",
+  refused: "recusado",
+  nothing: "nada para rodar",
+  estimate: "s\xF3 estimativa"
+};
+var NODE_TEXT = {
+  idle: "parado",
+  waiting: "esperando o montante",
+  queued: "na fila",
+  running: "rodando",
+  done: "pronto",
+  error: "erro",
+  cancelled: "cancelado",
+  skipped: "pulado (o montante falhou)",
+  blocked: "esperando aprova\xE7\xE3o",
+  claimed: "outra pessoa est\xE1 rodando",
+  cached: "em cache"
+};
+function statusText(a, titleOf) {
+  const head = [`Pedido ${a.requestId}: ${STATE_TEXT[a.state] ?? a.state}.`];
+  if (a.mode) head.push(`Modo ${modeText(a.mode)}.`);
+  if (typeof a.estimated === "number") head.push(`Estimado ${dia(a.estimated)}.`);
+  if (typeof a.spent === "number") head.push(`Gasto at\xE9 agora ${dia(a.spent)}.`);
+  const lines = [head.join(" ")];
+  if (a.message) lines.push(a.message);
+  for (const n of a.nodes ?? []) {
+    const extra = n.error ? `: ${n.error}` : n.message ? `: ${n.message}` : "";
+    const outs = typeof n.outputs === "number" && n.outputs > 0 ? ` (${n.outputs} sa\xEDda(s))` : "";
+    lines.push(`- ${n.title ?? titleOf(n.nodeId)} (${n.nodeId}): ${NODE_TEXT[n.status] ?? n.status}${outs}${extra}`);
+  }
+  if (a.state === "done" || a.state === "failed") lines.push("Leia o resultado com canvas_read_board (node_ids).");
+  return lines.join("\n");
+}
+function fromRuns(snap, ids) {
+  const byNode = new Map(snap.runs.map((r) => [r.nodeId, r]));
+  return ids.map((id) => {
+    const node = snap.doc.nodes[id];
+    const name = node ? nodeName(node) : id;
+    if (!node) return `- ${id}: o n\xF3 n\xE3o existe mais no board`;
+    const r = byNode.get(id);
+    const st = r?.state ?? null;
+    if (r?.claimedBy) return `- ${name} (${id}): rodando agora`;
+    if (!st?.status) return `- ${name} (${id}): sem estado de execu\xE7\xE3o no servidor (n\xE3o rodou, ou \xE9 n\xF3 que roda s\xF3 na aba)`;
+    const outs = Object.values(st.outputs ?? {}).reduce((sum, list) => sum + (Array.isArray(list) ? list.length : 0), 0);
+    const err = typeof st.error === "string" ? st.error : st.error?.message;
+    return `- ${name} (${id}): ${NODE_TEXT[st.status] ?? st.status}${outs ? ` (${outs} sa\xEDda(s))` : ""}${err ? `: ${err}` : ""}`;
+  }).join("\n");
+}
+
 // src/canvas/mentions.ts
 var VIA_MENTION = "viaMention";
 var PROMPT_REFS_INPUT = "refs";
@@ -25737,7 +25991,7 @@ function legacySequenceGuard(node, key) {
 }
 var SECTION_Z = -1e3;
 var GAP = 80;
-var boardId2 = external_exports.string().uuid().describe("Id (uuid) do board, como sai em canvas_list_boards.");
+var boardId3 = external_exports.string().uuid().describe("Id (uuid) do board, como sai em canvas_list_boards.");
 var nodeIdArg2 = external_exports.string().min(1).max(128);
 var point = external_exports.object({ x: external_exports.number().finite(), y: external_exports.number().finite() });
 var LABEL_TEXT_SIZES = ["titulo", "subtitulo", "corpo"];
@@ -25870,9 +26124,9 @@ ${lines.join("\n")}
     return `\u2705 ${done} em ${envs.length} envelope(s) (seq at\xE9 ${last}).
 ${lines.join("\n")}${note}`;
   }
-  function needNode(doc, nodeId) {
-    const node = doc.nodes[nodeId];
-    if (!node) throw new CanvasToolError(`N\xF3 ${nodeId} n\xE3o existe no board. Releia com canvas_read_board.`);
+  function needNode(doc, nodeId2) {
+    const node = doc.nodes[nodeId2];
+    if (!node) throw new CanvasToolError(`N\xF3 ${nodeId2} n\xE3o existe no board. Releia com canvas_read_board.`);
     return node;
   }
   function portWarning(doc, source, sourcePort, target, targetPort) {
@@ -25987,7 +26241,7 @@ ${lines.join("\n")}${note}`;
       title: "Canvas: ler board",
       description: 'L\xEA um board: n\xF3s (id, tipo, nome, posi\xE7\xE3o, tamanho, campos principais), liga\xE7\xF5es e v\xEDnculo com o IA Lab, sem m\xEDdia. Tamanho "medido" \xE9 o da tela; "gravado" \xE9 o piso (o cart\xE3o cresce com o conte\xFAdo). Obrigat\xF3rio antes de editar (vale para a sess\xE3o). node_ids devolve o data desses n\xF3s, com cada corte marcado (path=\u2026); o valor inteiro (ex.: data.sequence da Montagem) sai no canvas_read_node.',
       inputSchema: {
-        board_id: boardId2,
+        board_id: boardId3,
         node_ids: external_exports.array(nodeIdArg2).max(20).optional().describe("N\xF3s para ver o data (sem blobs, cortes marcados).")
       },
       annotations: { readOnlyHint: true, openWorldHint: false }
@@ -26009,7 +26263,7 @@ ${lines.join("\n")}${note}`;
       title: "Canvas: ler n\xF3 inteiro",
       description: 'Devolve o data de UM n\xF3 sem corte nenhum, em JSON compacto, para conferir e fazer diff. Na Montagem, sem path, vem a timeline do editor: data.timeline, ou data.sequence (legado) quando o n\xF3 ainda n\xE3o tem timeline, e o cabe\xE7alho diz qual veio. path escolhe um peda\xE7o ("items" da M\xEDdia, "timeline.meta"); "data" traz o data todo. Diz o tamanho total e o sha256; acima de max_chars vem em partes expl\xEDcitas (offset). N\xE3o substitui o canvas_read_board, que continua obrigat\xF3rio antes de editar. ' + MONTAGE_NOTE,
       inputSchema: {
-        board_id: boardId2,
+        board_id: boardId3,
         node_id: nodeIdArg2,
         path: external_exports.string().trim().max(200).optional().describe('Caminho dentro do data, com pontos (ex.: "timeline.meta", "items.0"). "data" = o data todo.'),
         offset: external_exports.number().int().min(0).optional().describe("In\xEDcio da parte, em caracteres (padr\xE3o 0)."),
@@ -26118,7 +26372,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). ${READ}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. ` + MENTION_NOTE + MONTAGE_NOTE,
       inputSchema: {
-        board_id: boardId2,
+        board_id: boardId3,
         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}."),
@@ -26175,7 +26429,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. ${READ}label renomeia; position move; size {w, h} muda a caixa (piso: o cart\xE3o cresce com o conte\xFAdo). N\xE3o troca o tipo. Cada chave \xE9 gravada inteira: leia antes com canvas_read_node e mande o valor completo j\xE1 revisado, para n\xE3o apagar o que outra pessoa escreveu. Para mudar partes de uma estrutura grande (clipes da timeline), use canvas_patch_node, por caminho; v\xE1rios n\xF3s de uma vez, canvas_update_nodes. ` + MENTION_NOTE + MONTAGE_NOTE,
       inputSchema: {
-        board_id: boardId2,
+        board_id: boardId3,
         node_id: nodeIdArg2,
         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(),
@@ -26203,7 +26457,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
       title: "Canvas: editar v\xE1rios n\xF3s",
       description: 'Muda v\xE1rios n\xF3s num passo s\xF3, cada um como no canvas_update_node (position, size, label, data com null apagando). layout_only: true aceita s\xF3 position e size {w, h}, n\xE3o exige leitura e n\xE3o recusa por "outra pessoa mexeu" (nesses dois campos vale quem grava por \xFAltimo). Sem layout_only, exige canvas_read_board nesta sess\xE3o e recusa se outra pessoa mexeu em algum desses n\xF3s. Quebra em envelopes de at\xE9 64 KB e relata cada um. Para arrumar linhas inteiras (t\xEDtulo, prompt, refer\xEAncia, gerador), use canvas_arrange_rows.',
       inputSchema: {
-        board_id: boardId2,
+        board_id: boardId3,
         nodes: external_exports.array(
           external_exports.object({
             node_id: nodeIdArg2,
@@ -26255,7 +26509,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
       title: "Canvas: gravar por caminho",
       description: `Grava v\xE1rios caminhos dentro do data de um n\xF3, sem executar: {path, value} grava, {path, unset: true} apaga. ${READ}O caminho atravessa objetos (o n\xEDvel que falta \xE9 criado) e n\xE3o entra em lista: para mudar um item de lista, grave a lista inteira. Quebra sozinho em envelopes de at\xE9 64 KB, em ordem, e devolve o resultado de cada um; entre envelopes n\xE3o h\xE1 atomicidade (o que entrou fica). Serve para mexer em partes de uma estrutura grande, como clipes da timeline da Montagem, sem reenviar tudo. Leia antes com canvas_read_node. ` + MENTION_NOTE + MONTAGE_NOTE,
       inputSchema: {
-        board_id: boardId2,
+        board_id: boardId3,
         node_id: nodeIdArg2,
         sets: external_exports.array(
           external_exports.object({
@@ -26354,7 +26608,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). ${READ}Liga\xE7\xE3o repetida \xE9 ignorada.`,
       inputSchema: {
-        board_id: boardId2,
+        board_id: boardId3,
         source: nodeIdArg2,
         source_port: external_exports.string().min(1).max(80),
         target: nodeIdArg2,
@@ -26381,7 +26635,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. ${READ}N\xE3o apaga o board.`,
       inputSchema: {
-        board_id: boardId2,
+        board_id: boardId3,
         node_ids: external_exports.array(nodeIdArg2).max(200).optional(),
         edge_ids: external_exports.array(nodeIdArg2).max(200).optional()
       },
@@ -26425,7 +26679,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). ${READ}Precisa de papel de editor ou dono.`,
-      inputSchema: { board_id: boardId2, title: external_exports.string().trim().min(1).max(200) },
+      inputSchema: { board_id: boardId3, title: external_exports.string().trim().min(1).max(200) },
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
     async ({ board_id, title }) => run(
@@ -26441,7 +26695,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: boardId2 },
+      inputSchema: { board_id: boardId3 },
       annotations: { readOnlyHint: true, openWorldHint: false }
     },
     async ({ board_id }) => run(async () => {
@@ -26458,7 +26712,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: boardId2,
+        board_id: boardId3,
         user_id: external_exports.string().uuid(),
         role: external_exports.enum(["editor", "viewer"]).describe("editor edita; viewer s\xF3 v\xEA.")
       },
@@ -26474,7 +26728,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: boardId2, user_id: external_exports.string().uuid() },
+      inputSchema: { board_id: boardId3, user_id: external_exports.string().uuid() },
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
     async ({ board_id, user_id }) => run(async () => {
@@ -26485,13 +26739,14 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
   registerCanvasCommentTools(server, api, run);
   registerCanvasMediaTools(server, { api, cfg, run, edit, seen, placeFor });
   registerCanvasLayoutTools(server, { api, run, edit });
+  registerCanvasRunTools(server, api, run);
 }
 
 // src/version.ts
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
 function readVersion() {
-  if ("0.30.0") return "0.30.0";
+  if ("0.31.0") return "0.31.0";
   try {
     const pkg = require2("../package.json");
     return pkg.version ?? "0.0.0-unknown";
@@ -26506,7 +26761,7 @@ 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 canvas_* n\xE3o geram m\xEDdia, exceto canvas_run: roda n\xF3s pela aba do Canvas aberta do usu\xE1rio e gasta diamantes; max_diamonds \xE9 o teto que o usu\xE1rio autorizou (dry_run s\xF3 estima). D\xEA nome (label) aos n\xF3s, n\xE3o invente tipos nem portas, e confirme antes de canvas_delete.",
   'Arrumar o board: o size gravado \xE9 piso (o cart\xE3o cresce com o conte\xFAdo); use o tamanho "medido" do canvas_read_board. \xC1rea de revis\xE3o: canvas_arrange_rows (uma linha por vers\xE3o); posi\xE7\xE3o/tamanho em lote: canvas_update_nodes com layout_only. N\xE3o afirme que nada se sobrep\xF5e com n\xF3 sem medida.',
   '"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");