beplus-mcp 0.30.0 → 0.32.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,8 @@ import { createHash } from "crypto";
 
 // src/canvas/api.ts
 var PINNED_CORE_VERSION = "ca7b3b406184c7f679f555c3a008013197182b23";
+var RUN_REQUEST_TIMEOUT_MS = 4e4;
+var FOCUS_REQUEST_TIMEOUT_MS = 12e3;
 function errorRaw(err) {
   if (!(err instanceof ApiError)) return void 0;
   const raw = err.body?.error?.raw;
@@ -24126,13 +24128,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 +24143,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 +24165,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 +24202,30 @@ 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}`);
+  }
+  // ── enquadrar a aba do Canvas (CF1) ───────────────────────────────────────
+  /** Pede para a aba do Canvas da pessoa enquadrar nós. O servidor espera a aba até 5 s. */
+  focusRequest(boardId4, body2) {
+    return this.req("POST", `/boards/${boardId4}/focus-requests`, { body: body2, timeoutMs: FOCUS_REQUEST_TIMEOUT_MS });
   }
   /** Só para os testes conferirem o aprendizado. */
   get currentCoreVersion() {
@@ -24483,8 +24501,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 +24557,13 @@ function makeEdge(init) {
 }
 var setValue = (value) => ({ kind: "value", value });
 var unsetValue = () => ({ kind: "unset" });
-function removeNodeOps(doc, nodeId) {
+function removeNodeOps(doc, nodeId3) {
   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 === nodeId3 || doc.edges[id].target === nodeId3).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, nodeId3) ? doc.nodeHistory[nodeId3] : void 0;
+  if (history) for (const resultId of [...history].reverse()) ops.push({ type: "history.remove", nodeId: nodeId3, resultId });
+  ops.push({ type: "node.remove", nodeId: nodeId3 });
   return ops;
 }
 function batchOf(ops) {
@@ -24561,14 +24579,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 +24964,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, nodeId3) {
+  const node = doc.nodes[nodeId3];
   const kind = nodeKind(node) ?? node.type;
   return `"${oneLine(nodeName(node), 60)}" (${kind}, ${node.id})`;
 }
@@ -24971,13 +24989,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, nodeId3, outputKey) {
+  const ids = doc.nodeHistory?.[nodeId3];
   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[nodeId3]?.data.history;
   if (Array.isArray(history)) {
     const i = history.findIndex(
       (h) => typeof h === "object" && h !== null && !Array.isArray(h) && outputKeyOf(h) === outputKey
@@ -25447,17 +25465,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, nodeId3) {
+  const node = doc.nodes[nodeId3];
+  if (!node) throw new CanvasToolError(`N\xF3 ${nodeId3} 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 ${nodeId3} ("${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, nodeId3) {
   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 +25484,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, nodeId3);
   }
   return JSON.stringify(out);
 }
-function sequenceHint(u, nodeId) {
+function sequenceHint(u, nodeId3) {
   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" + (nodeId3 ? "." : ", 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 +25548,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 nodeId3 = 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 (nodeId3) {
+            const node = needMediaNode(doc, nodeId3);
             const replacing = args.replace ?? holdsOne(doc, node);
             const items = replacing ? [item] : [...itemsOf(node), item];
             if (items.length > MAX_MEDIA_ITEMS) {
@@ -25559,7 +25577,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;
+          nodeId3 = created.id;
           return {
             ops: [{ type: "node.add", nodeId: created.id, node: created }],
             targets: [],
@@ -25575,7 +25593,363 @@ 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, nodeId3), "", sequenceHint(u, nodeId3)].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}`);
+  }
+  if (estimate.omitted) {
+    lines.push(`\u2026 e mais ${estimate.omitted} n\xF3(s) fora da lista (a resposta da aba foi cortada pelo tamanho; o total vale para todos).`);
+  }
+  const cached2 = estimate.cached ?? nodes.filter((n) => !n.willRun && !n.afterApproval).length;
+  if (cached2) lines.push(`Em cache (n\xE3o rodam): ${cached2}.`);
+  const later = estimate.counts?.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).`);
+  const unknown2 = estimate.counts?.unknown ?? estimate.unknown?.length ?? 0;
+  if (unknown2) {
+    lines.push(`Sem estimativa: ${unknown2} 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 explain2(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) {
+        explain2(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] : [],
+          ...answer.estimate?.omitted ? { omitted: answer.estimate.omitted } : {}
+        });
+      }
+      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") explain2(e);
+        why = reason === "no-tab" ? "Nenhuma aba do Canvas sua est\xE1 aberta neste board." : "Nenhuma aba aberta conhece este pedido.";
+      }
+      const known = node_ids ? void 0 : remembered.get(requestId);
+      const ids = node_ids ?? known?.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).`;
+      }
+      const partial2 = known?.omitted ? ` (parcial: s\xF3 os ${ids.length} n\xF3s que a aba listou; outros ${known.omitted} ficaram fora da resposta. Para eles, chame com node_ids)` : "";
+      return `${why} Pelo estado de execu\xE7\xE3o do board${partial2}:
+${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.omitted) lines.push(`\u2026 e mais ${a.omitted} n\xF3(s) fora da lista (a resposta da aba foi cortada pelo tamanho).`);
+  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/tools/canvas-focus.ts
+var MAX_IDS = 100;
+var nodeId2 = external_exports.string().min(1).max(128);
+var fmtZoom = (z) => new Intl.NumberFormat("pt-BR", { maximumFractionDigits: 2 }).format(z);
+function explain(e, usesPat) {
+  if (!(e instanceof ApiError)) throw e;
+  const reason = errorRaw(e)?.reason;
+  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 (ou recarregar a aba) e tente de novo. Nada mudou."
+    );
+  }
+  if (reason === "tab-timeout") {
+    throw new CanvasToolError("A aba do Canvas n\xE3o respondeu em 5 s. Ela pode ter enquadrado; chamar de novo n\xE3o faz mal.");
+  }
+  if (reason === "tab-bad-answer") {
+    throw new CanvasToolError("A aba do Canvas respondeu fora do contrato. Pe\xE7a para recarregar a aba e tente de novo.");
+  }
+  if (e.httpStatus === 404) {
+    if (!/board/i.test(e.message)) {
+      throw new CanvasToolError("O servidor do Canvas ainda n\xE3o tem o enquadramento pelo MCP (academy-backend sem a CF1). Nada mudou.");
+    }
+    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 && (!usesPat || /ialab:/.test(e.message))) {
+    throw new CanvasToolError("O login pelo navegador deste MCP n\xE3o tem a permiss\xE3o que o enquadramento exige. Rode `beplus-mcp login` de novo e autorize.");
+  }
+  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 enquadramento (60 por minuto). Espere um minuto.");
+  throw e;
+}
+function focusText(a) {
+  const tab = a.tab;
+  const name = tab?.title ? `"${tab.title}"` : "aberta";
+  const found = a.found ?? 0;
+  const selected = a.selected ?? 0;
+  const zoom = typeof a.zoom === "number" ? ` Zoom ${fmtZoom(a.zoom)}.` : "";
+  const lines = [
+    `Enquadrado na aba do Canvas ${name}: ${found} n\xF3(s)${selected > 0 ? `, ${selected} selecionado(s)` : ", sem mexer na sele\xE7\xE3o"}.${zoom}`
+  ];
+  if (tab?.human !== void 0 || tab?.relayed !== void 0) {
+    const who2 = tab.human === false ? "Aba de agente (link ?frame): nenhuma aba do usu\xE1rio estava vis\xEDvel neste board." : "Aba do usu\xE1rio (a que ele est\xE1 olhando).";
+    const via = tab.relayed ? " Repassado pela aba que o servidor escolheu." : "";
+    lines.push(`${who2}${via}`);
+  }
+  if (a.mode === "follow") {
+    lines.push("Modo seguir: a aba acompanha essa \xE1rea e fica presa nela at\xE9 o usu\xE1rio clicar no \xD7 da p\xEDlula.");
+  } else if (a.mode === "light") {
+    lines.push("Uma vez s\xF3: a aba n\xE3o fica presa; o usu\xE1rio segue mexendo \xE0 vontade.");
+  }
+  const missing = a.missing ?? [];
+  if (missing.length > 0) {
+    const more = a.missingMore ? ` e mais ${a.missingMore}` : "";
+    lines.push(`N\xE3o existem no board (ou est\xE3o arquivados): ${missing.join(", ")}${more}.`);
+  }
+  if (tab?.visible === false) lines.push("A aba est\xE1 escondida (atr\xE1s de outra): pe\xE7a para o usu\xE1rio traz\xEA-la para a frente.");
+  if (tab?.montage) lines.push("O usu\xE1rio est\xE1 no editor (Montagem aberta nessa aba): o board foi enquadrado por tr\xE1s e aparece quando ele fechar a Montagem.");
+  if (tab?.wasFramed) lines.push("Essa aba estava enquadrada em outra \xE1rea (talvez a de outro agente) e agora mostra esta.");
+  return lines.join("\n");
+}
+function registerCanvasFocusTools(server, api, run) {
+  server.registerTool(
+    "canvas_focus",
+    {
+      title: "Canvas: enquadrar a aba do usu\xE1rio",
+      description: 'Mostra "olha aqui" ao usu\xE1rio: leva a aba do Canvas que ele est\xE1 olhando neste board (a vis\xEDvel, que n\xE3o \xE9 aba de agente aberta por link ?frame; sem nenhuma, a de um agente) at\xE9 n\xF3s ou uma se\xE7\xE3o, sem anima\xE7\xE3o, e seleciona os n\xF3s (select: false n\xE3o mexe na sele\xE7\xE3o). Padr\xE3o: enquadra e seleciona UMA vez; a aba n\xE3o fica presa e o usu\xE1rio segue mexendo. follow: true segue a \xE1rea e prende a aba at\xE9 o \xD7 (modo ?frame: acompanha as mudan\xE7as, titulo na p\xEDlula e no nome da aba); use s\xF3 quando ele pedir para acompanhar. N\xC3O gasta e N\xC3O escreve no board. Diga node_ids e/ou section_id (at\xE9 100 ids; com os dois, a sele\xE7\xE3o fica nos node_ids). zoom: "fit" (padr\xE3o, cabe na tela) ou n\xFAmero de 0.07 a 4. Devolve qual aba enquadrou (nome, se \xE9 a do usu\xE1rio ou de agente, se veio repassada, se est\xE1 escondida, se ele est\xE1 no editor da Montagem) e os ids que n\xE3o existem. Sem aba: pe\xE7a para abrir (ou recarregar) o board no Canvas. Chamar de novo com a mesma \xE1rea \xE9 seguro.',
+      inputSchema: {
+        board_id: external_exports.string().uuid().describe("Id (uuid) do board."),
+        node_ids: external_exports.array(nodeId2).min(1).max(MAX_IDS).optional().describe("Os n\xF3s a mostrar (e selecionar)."),
+        section_id: nodeId2.optional().describe("Uma se\xE7\xE3o: enquadra a se\xE7\xE3o e o que est\xE1 dentro dela."),
+        titulo: external_exports.string().trim().min(1).max(80).optional().describe('Com follow: texto da p\xEDlula e do nome da aba ("<titulo> \xB7 <board>"). Sem follow n\xE3o aparece.'),
+        zoom: external_exports.union([external_exports.literal("fit"), external_exports.number().finite().min(0.07).max(4)]).optional().describe('"fit" (padr\xE3o): a \xE1rea cabe na tela, zoom at\xE9 100%. N\xFAmero: zoom fixo, com a \xE1rea no meio.'),
+        select: external_exports.boolean().optional().describe("false: n\xE3o mexe na sele\xE7\xE3o. Padr\xE3o: seleciona os n\xF3s."),
+        follow: external_exports.boolean().optional().describe("true: segue a \xE1rea e prende a aba at\xE9 o \xD7 da p\xEDlula. Padr\xE3o false: enquadra e seleciona uma vez, sem prender.")
+      },
+      annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }
+    },
+    async (args) => run(async () => {
+      const nodeIds = args.node_ids ? [...new Set(args.node_ids)] : [];
+      if (nodeIds.length === 0 && !args.section_id) {
+        throw new CanvasToolError("Diga o que mostrar: node_ids (os n\xF3s), section_id (uma se\xE7\xE3o) ou os dois.");
+      }
+      if (nodeIds.length + (args.section_id ? 1 : 0) > MAX_IDS) {
+        throw new CanvasToolError(`At\xE9 ${MAX_IDS} ids por pedido (node_ids mais a se\xE7\xE3o).`);
+      }
+      let answer;
+      try {
+        answer = await api.focusRequest(args.board_id, {
+          ...nodeIds.length ? { nodeIds } : {},
+          ...args.section_id ? { sectionId: args.section_id } : {},
+          ...args.titulo ? { title: args.titulo } : {},
+          ...args.zoom !== void 0 ? { zoom: args.zoom } : {},
+          ...args.select !== void 0 ? { select: args.select } : {},
+          ...args.follow !== void 0 ? { follow: args.follow } : {}
+        });
+      } catch (e) {
+        explain(e, api.usesPat);
+      }
+      if (answer.ok !== true) {
+        throw new CanvasToolError(`A aba recusou, nada mudou (${answer.reason ?? "sem motivo"}): ${answer.message ?? ""}`.trim());
+      }
+      return focusText(answer);
     })
   );
 }
@@ -25737,7 +26111,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 +26244,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, nodeId3) {
+    const node = doc.nodes[nodeId3];
+    if (!node) throw new CanvasToolError(`N\xF3 ${nodeId3} n\xE3o existe no board. Releia com canvas_read_board.`);
     return node;
   }
   function portWarning(doc, source, sourcePort, target, targetPort) {
@@ -25987,7 +26361,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 +26383,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 +26492,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 +26549,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 +26577,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 +26629,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 +26728,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 +26755,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 +26799,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 +26815,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 +26832,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 +26848,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 +26859,15 @@ 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);
+  registerCanvasFocusTools(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.32.0") return "0.32.0";
   try {
     const pkg = require2("../package.json");
     return pkg.version ?? "0.0.0-unknown";
@@ -26506,7 +26882,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 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.",
+  'Mostrar algo ao usu\xE1rio ("olha aqui"): canvas_focus leva a aba do Canvas que ele est\xE1 olhando at\xE9 os n\xF3s e os seleciona uma vez, sem prender a aba, sem gasto e sem escrita no board. follow: true prende a aba na \xE1rea at\xE9 o \xD7: s\xF3 se ele pedir.',
   '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");