beplus-mcp 0.47.0 → 0.49.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -28759,11 +28759,21 @@ ${calls.map(callLine).join("\n\n")}`);
28759
28759
  }
28760
28760
 
28761
28761
  // src/tools/canvas.ts
28762
- import { createHash as createHash2 } from "crypto";
28762
+ import { createHash as createHash3 } from "crypto";
28763
28763
 
28764
28764
  // src/canvas/api.ts
28765
28765
  import { createHash } from "crypto";
28766
28766
  var import_canvas_core = __toESM(require_canvas_core(), 1);
28767
+
28768
+ // src/canvas/tab-locks.ts
28769
+ var MINUTE = 6e4;
28770
+ function describeLock(lock, now = Date.now()) {
28771
+ const minutes = Math.max(1, Math.ceil((Date.parse(lock.expiresAt) - now) / MINUTE));
28772
+ const doing = lock.label ? `, "${lock.label}"` : "";
28773
+ return `a aba ${lock.tabId.slice(0, 8)} est\xE1 com a sess\xE3o ${lock.sessionId} de ${lock.holder}${doing}, por at\xE9 ${minutes} min se ela n\xE3o escrever mais`;
28774
+ }
28775
+
28776
+ // src/canvas/api.ts
28767
28777
  var PINNED_CORE_VERSION = "ca7b3b406184c7f679f555c3a008013197182b23";
28768
28778
  var RUN_REQUEST_TIMEOUT_MS = 4e4;
28769
28779
  var FOCUS_REQUEST_TIMEOUT_MS = 12e3;
@@ -28874,6 +28884,27 @@ var CanvasApi = class {
28874
28884
  boardLoads.set(loadKey, load);
28875
28885
  return load;
28876
28886
  }
28887
+ /**
28888
+ * Só estes nós. Com o board em cache, o delta já resolve e custa menos que a rota; sem cache, a
28889
+ * rota evita baixar o board inteiro. 404 pode ser servidor antigo: a foto decide se o board existe.
28890
+ */
28891
+ async readNodes(boardId4, ids) {
28892
+ if (!boardStore.has(this.cacheKey(boardId4))) {
28893
+ try {
28894
+ return await this.req("GET", `/boards/${boardId4}/nodes`, { query: { ids: ids.join(",") } });
28895
+ } catch (e) {
28896
+ if (!(e instanceof ApiError) || e.httpStatus !== 404) throw e;
28897
+ }
28898
+ }
28899
+ const snap = await this.snapshot(boardId4);
28900
+ const known = ids.filter((id) => Object.hasOwn(snap.doc.nodes, id));
28901
+ return {
28902
+ title: snap.title,
28903
+ seq: snap.seq,
28904
+ nodes: Object.fromEntries(known.map((id) => [id, snap.doc.nodes[id]])),
28905
+ missing: ids.filter((id) => !known.includes(id))
28906
+ };
28907
+ }
28877
28908
  async load(boardId4, key, needRuns) {
28878
28909
  const entry = boardStore.get(key);
28879
28910
  if (entry && !needRuns && this.coreVersion === PINNED_CORE_VERSION) {
@@ -28971,8 +29002,26 @@ var CanvasApi = class {
28971
29002
  }
28972
29003
  throw again;
28973
29004
  }
29005
+ } finally {
29006
+ const entry = boardStore.get(this.cacheKey(boardId4));
29007
+ if (entry) entry.checkedAt = -Infinity;
29008
+ }
29009
+ }
29010
+ tabLocks(boardId4) {
29011
+ return this.req("GET", `/boards/${boardId4}/tab-locks`);
29012
+ }
29013
+ async lockTab(boardId4, tabId, session, label) {
29014
+ try {
29015
+ return await this.req("PUT", `/boards/${boardId4}/tabs/${encodeURIComponent(tabId)}/lock`, { body: { session, label } });
29016
+ } catch (e) {
29017
+ const raw = errorRaw(e);
29018
+ if (raw?.reason !== "tab-locked" || !raw.lockedBy) throw e;
29019
+ throw new CanvasToolError(`N\xE3o travou: ${describeLock(raw.lockedBy)}.`);
28974
29020
  }
28975
29021
  }
29022
+ unlockTab(boardId4, tabId, session) {
29023
+ return this.req("DELETE", `/boards/${boardId4}/tabs/${encodeURIComponent(tabId)}/lock`, { query: { session } });
29024
+ }
28976
29025
  members(boardId4) {
28977
29026
  return this.req("GET", `/boards/${boardId4}/members`);
28978
29027
  }
@@ -29974,15 +30023,15 @@ function rowsLines(rows) {
29974
30023
  if (rows.length > MAX_BLOCKS) out.push(` \xB7 \u2026 +${rows.length - MAX_BLOCKS} linhas`);
29975
30024
  return out;
29976
30025
  }
29977
- function nodeLines(node, run, aba) {
30026
+ function nodeLines(node, run, aba2) {
29978
30027
  const kind = nodeKind(node);
29979
30028
  const spec = kind ? KINDS[kind] : void 0;
29980
- const head = `- ${node.id} \xB7 ${kind ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" @(${Math.round(node.position.x)},${Math.round(node.position.y)}) ${sizeLabel(node)}` + (aba ? ` \xB7 aba=${aba}` : "");
30029
+ const head = `- ${node.id} \xB7 ${kind ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" @(${Math.round(node.position.x)},${Math.round(node.position.y)}) ${sizeLabel(node)}` + (aba2 ? ` \xB7 aba=${aba2}` : "");
29981
30030
  const facts = [];
29982
30031
  const extra = [];
29983
30032
  const d = node.data;
29984
30033
  if (d.archived) facts.push("ARQUIVADO");
29985
- if (aba && isTabSection(node)) facts.push("\xE9 aba");
30034
+ if (aba2 && isTabSection(node)) facts.push("\xE9 aba");
29986
30035
  const approval = d.approval?.state;
29987
30036
  if (typeof approval === "string") facts.push(`aprova\xE7\xE3o: ${approval}`);
29988
30037
  if (Array.isArray(d.history)) facts.push(`${d.history.length} gera\xE7\xE3o(\xF5es)`);
@@ -30007,7 +30056,7 @@ function nodeLines(node, run, aba) {
30007
30056
  for (const [key, value] of Object.entries(d)) {
30008
30057
  if (NAME_KEYS.has(key) || HEAVY_KEYS.has(key) || key === main) continue;
30009
30058
  if (["blocks", "rows", "items", "archived", "approval"].includes(key)) continue;
30010
- if (aba && (key === TAB_ID_FIELD || key === TAB_FIELD && isTabSection(node))) continue;
30059
+ if (aba2 && (key === TAB_ID_FIELD || key === TAB_FIELD && isTabSection(node))) continue;
30011
30060
  const s = scalar(value);
30012
30061
  if (s !== null) facts.push(`${key}=${s}`);
30013
30062
  else if (Array.isArray(value)) facts.push(`${key}=[${value.length}]`);
@@ -30337,9 +30386,9 @@ function registerCanvasCommentTools(server, api, run) {
30337
30386
  },
30338
30387
  annotations: { readOnlyHint: true, openWorldHint: false }
30339
30388
  },
30340
- async ({ board_id, status }) => run(async () => {
30389
+ async ({ board_id: board_id2, status }) => run(async () => {
30341
30390
  const st = status ?? "open";
30342
- const [snap, threads] = await Promise.all([api.snapshot(board_id), api.listComments(board_id, st)]);
30391
+ const [snap, threads] = await Promise.all([api.snapshot(board_id2), api.listComments(board_id2, st)]);
30343
30392
  const text = commentsSummary(threads, snap.doc, st);
30344
30393
  const open3 = threads.some((t) => !t.resolvedAt);
30345
30394
  return open3 ? `${text}
@@ -30355,9 +30404,9 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
30355
30404
  inputSchema: { board_id: boardId, comment_id: commentId, body, mentions },
30356
30405
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
30357
30406
  },
30358
- async ({ board_id, comment_id, body: text, mentions: m }) => run(async () => {
30407
+ async ({ board_id: board_id2, comment_id, body: text, mentions: m }) => run(async () => {
30359
30408
  const thread = await onComment(
30360
- () => api.createComment(board_id, { body: text, parentId: comment_id, ...m?.length ? { mentions: m } : {} })
30409
+ () => api.createComment(board_id2, { body: text, parentId: comment_id, ...m?.length ? { mentions: m } : {} })
30361
30410
  );
30362
30411
  const open3 = thread?.resolvedAt ? "A thread est\xE1 resolvida; reabra com canvas_reopen_comment se precisar." : "A thread segue aberta.";
30363
30412
  return `\u2705 Resposta ${newReplyId(thread)} em ${comment_id}: "${oneLine2(text, 120)}". ${open3}`;
@@ -30375,11 +30424,11 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
30375
30424
  },
30376
30425
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
30377
30426
  },
30378
- async ({ board_id, comment_id, done }) => run(async () => {
30379
- const thread = await onComment(() => api.createComment(board_id, { body: done, parentId: comment_id }));
30427
+ async ({ board_id: board_id2, comment_id, done }) => run(async () => {
30428
+ const thread = await onComment(() => api.createComment(board_id2, { body: done, parentId: comment_id }));
30380
30429
  const replyId = newReplyId(thread);
30381
30430
  try {
30382
- await onComment(() => api.resolveComment(board_id, comment_id));
30431
+ await onComment(() => api.resolveComment(board_id2, comment_id));
30383
30432
  } catch (e) {
30384
30433
  const why = e instanceof Error ? e.message : String(e);
30385
30434
  throw new CanvasToolError(
@@ -30397,9 +30446,9 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
30397
30446
  inputSchema: { board_id: boardId, comment_id: commentId, why: external_exports.string().trim().min(1).max(1e3).optional() },
30398
30447
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
30399
30448
  },
30400
- async ({ board_id, comment_id, why }) => run(async () => {
30401
- await onComment(() => api.reopenComment(board_id, comment_id));
30402
- if (why) await onComment(() => api.createComment(board_id, { body: why, parentId: comment_id }));
30449
+ async ({ board_id: board_id2, comment_id, why }) => run(async () => {
30450
+ await onComment(() => api.reopenComment(board_id2, comment_id));
30451
+ if (why) await onComment(() => api.createComment(board_id2, { body: why, parentId: comment_id }));
30403
30452
  return `\u2705 Reaberto ${comment_id}${why ? ` com a resposta "${oneLine2(why, 120)}"` : ""}.`;
30404
30453
  })
30405
30454
  );
@@ -30501,8 +30550,8 @@ function layoutOps(doc, a) {
30501
30550
  }
30502
30551
  return ops;
30503
30552
  }
30504
- function scopeFor(doc, rows, aba) {
30505
- const tab = aba ? resolveTab(doc, aba) : void 0;
30553
+ function scopeFor(doc, rows, aba2) {
30554
+ const tab = aba2 ? resolveTab(doc, aba2) : void 0;
30506
30555
  if (!hasTabs(doc)) return void 0;
30507
30556
  const arranged = rows.flatMap((r) => [...r.title ? [r.title] : [], ...r.left, ...r.right]);
30508
30557
  const homes = new Set(arranged.map((id) => homeTabOf(doc, id)));
@@ -30845,6 +30894,7 @@ URL: ${u.url}`;
30845
30894
  return {
30846
30895
  ops: [{ type: "node.add", nodeId: created.id, node: created }],
30847
30896
  targets: [],
30897
+ place: { [created.id]: tab === void 0 ? {} : { tab } },
30848
30898
  done: `N\xF3 M\xEDdia "${oneLine2(nodeName(created), 40)}" criado: ${created.id}.${placementNote(doc, created)}`
30849
30899
  };
30850
30900
  });
@@ -30871,6 +30921,7 @@ var statusPacing = {
30871
30921
  now: () => Date.now(),
30872
30922
  sleep: (ms) => new Promise((r) => setTimeout(r, Math.max(0, ms)))
30873
30923
  };
30924
+ var byServer = (a) => a.via === "server";
30874
30925
  var sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
30875
30926
  var seconds = (ms) => `${new Intl.NumberFormat("pt-BR", { maximumFractionDigits: 1 }).format(ms / 1e3)} s`;
30876
30927
  function timingsLine(t) {
@@ -30945,12 +30996,12 @@ function registerCanvasRunTools(server, api, run) {
30945
30996
  const unknownFate = requestId && (e.httpStatus === 0 || e.httpStatus === 408 || reason === "tab-timeout" || reason === "tab-bad-answer" || e.httpStatus >= 500 && e.httpStatus !== 501);
30946
30997
  if (unknownFate) {
30947
30998
  throw new CanvasToolError(
30948
- `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.`
30999
+ `N\xE3o d\xE1 para saber se o pedido 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, nada roda duas vezes.`
30949
31000
  );
30950
31001
  }
30951
31002
  if (reason === "no-tab") {
30952
31003
  throw new CanvasToolError(
30953
- "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."
31004
+ "Este pedido precisa de uma aba do Canvas, e nenhuma 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."
30954
31005
  );
30955
31006
  }
30956
31007
  if (e.httpStatus === 404 && reason !== "unknown-request") {
@@ -30972,7 +31023,7 @@ function registerCanvasRunTools(server, api, run) {
30972
31023
  function answerText(a, requestId, max, titleOf) {
30973
31024
  const est = estimateLines(a.estimate, titleOf);
30974
31025
  const total = a.estimate ? `${dia(a.estimate.total)} (teto ${fmt2(max)})` : "";
30975
- const again = a.repeated ? " (a aba j\xE1 tinha recebido este request_id; esta \xE9 a mesma resposta)" : "";
31026
+ const again = a.repeated ? " (este request_id j\xE1 tinha chegado; esta \xE9 a mesma resposta)" : "";
30976
31027
  if (a.status === "estimate") {
30977
31028
  return [
30978
31029
  `Estimativa, nada rodou${again}. Modo ${modeText(a.mode)}. Total agora: ${total}.`,
@@ -30984,7 +31035,7 @@ function registerCanvasRunTools(server, api, run) {
30984
31035
  if (a.status === "nothing") return `Nada para rodar${again}: ${a.message ?? "o board j\xE1 est\xE1 em dia."}`;
30985
31036
  const willRun = (a.estimate?.nodes ?? []).filter((n) => n.willRun).map((n) => n.nodeId);
30986
31037
  return [
30987
- `Rodando pela sua aba do Canvas${again}. Modo ${modeText(a.mode)}. Estimativa: ${total}.`,
31038
+ `${byServer(a) ? "Rodando no servidor, sem depender de aba aberta" : "Rodando pela sua aba do Canvas"}${again}. Modo ${modeText(a.mode)}. Estimativa: ${total}.`,
30988
31039
  ...est,
30989
31040
  `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.`,
30990
31041
  timingsLine(a.timings)
@@ -30998,7 +31049,7 @@ function registerCanvasRunTools(server, api, run) {
30998
31049
  "canvas_run",
30999
31050
  {
31000
31051
  title: "Canvas: rodar n\xF3s",
31001
- 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.",
31052
+ description: "Roda n\xF3s do board no servidor, sem precisar de aba aberta. GASTA DIAMANTES no modo Real. 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). O teto \xE9 conferido de novo antes de cada n\xF3 pago; texto reserva o pior caso. 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). Composi\xE7\xE3o, montagem, exporta\xE7\xE3o, Contexto, arquivo que s\xF3 existe no navegador e especialista pr\xF3prio dependem da aba do usu\xE1rio: com ela aberta, o pedido vai para ela; sem ela, recusa antes de gastar e diz qual n\xF3. simulated: true s\xF3 vale com a aba no modo Simulado. Prompt com PT editado e sem aplicar no EN: 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.",
31002
31053
  inputSchema: {
31003
31054
  board_id: boardId2,
31004
31055
  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)."),
@@ -31006,8 +31057,8 @@ function registerCanvasRunTools(server, api, run) {
31006
31057
  all: external_exports.boolean().optional().describe("true: Rodar tudo (s\xF3 o que mudou)."),
31007
31058
  max_diamonds: external_exports.number().finite().min(0).max(1e6).describe("Teto de diamantes desta execu\xE7\xE3o. Obrigat\xF3rio."),
31008
31059
  dry_run: external_exports.boolean().optional().describe("true: s\xF3 estima, nada roda."),
31009
- simulated: external_exports.boolean().optional().describe("true: o pedido \xE9 para o modo Simulado (a aba precisa estar nele)."),
31010
- label: external_exports.string().trim().min(1).max(80).optional().describe('Quem pede, como a aba mostra ("Rodando a pedido de \u2026").'),
31060
+ simulated: external_exports.boolean().optional().describe("true: o pedido \xE9 para o modo Simulado, que roda na aba (ela precisa estar nele)."),
31061
+ label: external_exports.string().trim().min(1).max(80).optional().describe('Quem pede, como o board mostra ("Rodando a pedido de \u2026").'),
31011
31062
  request_id: external_exports.string().uuid().optional().describe("S\xF3 para repetir um pedido cujo destino ficou incerto.")
31012
31063
  },
31013
31064
  annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
@@ -31025,7 +31076,8 @@ function registerCanvasRunTools(server, api, run) {
31025
31076
  dryRun: args.dry_run === true,
31026
31077
  simulated: args.simulated === true,
31027
31078
  label,
31028
- earlyAck: true
31079
+ earlyAck: true,
31080
+ clientId: CLIENT_ID
31029
31081
  });
31030
31082
  } catch (e) {
31031
31083
  explain2(e, requestId);
@@ -31039,13 +31091,13 @@ function registerCanvasRunTools(server, api, run) {
31039
31091
  }
31040
31092
  if (wasAccepted) answer = { ...answer, repeated: false };
31041
31093
  if (answer.ok === true && answer.status === "accepted") {
31042
- return `A aba recebeu o pedido e ainda est\xE1 estimando e conferindo (board grande). request_id: ${requestId}. Acompanhe com canvas_run_status; para a resposta completa, chame canvas_run de novo com o MESMO request_id (\xE9 seguro: a aba n\xE3o roda duas vezes). N\xC3O pe\xE7a com outro id.`;
31094
+ return `O pedido chegou e ainda est\xE1 sendo estimado e conferido (board grande). request_id: ${requestId}. Acompanhe com canvas_run_status; para a resposta completa, chame canvas_run de novo com o MESMO request_id (\xE9 seguro: nada roda duas vezes). N\xC3O pe\xE7a com outro id.`;
31043
31095
  }
31044
31096
  const titleOf = lacksTitles(answer.estimate?.nodes) ? await titles(args.board_id) : (id) => id;
31045
31097
  if (answer.ok !== true) {
31046
31098
  const est = estimateLines(answer.estimate, titleOf);
31047
31099
  throw new CanvasToolError(
31048
- [`A aba recusou, nada rodou (${answer.reason ?? "sem motivo"}): ${answer.message ?? ""}`.trim(), ...est].join("\n")
31100
+ [`${byServer(answer) ? "O servidor" : "A aba"} recusou, nada rodou (${answer.reason ?? "sem motivo"}): ${answer.message ?? ""}`.trim(), ...est].join("\n")
31049
31101
  );
31050
31102
  }
31051
31103
  const nodeIds = (answer.estimate?.nodes ?? []).filter((n) => n.willRun).map((n) => n.nodeId);
@@ -31063,7 +31115,7 @@ function registerCanvasRunTools(server, api, run) {
31063
31115
  "canvas_run_status",
31064
31116
  {
31065
31117
  title: "Canvas: andamento da execu\xE7\xE3o",
31066
- 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.",
31118
+ description: "Andamento de um pedido do canvas_run: estado de cada n\xF3, estimado e gasto. Vem do servidor ou da aba 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.",
31067
31119
  inputSchema: {
31068
31120
  board_id: boardId2,
31069
31121
  request_id: external_exports.string().uuid().describe("O request_id que o canvas_run devolveu."),
@@ -31071,7 +31123,7 @@ function registerCanvasRunTools(server, api, run) {
31071
31123
  },
31072
31124
  annotations: { readOnlyHint: true, openWorldHint: true }
31073
31125
  },
31074
- async ({ board_id, request_id, node_ids }) => run(async () => {
31126
+ async ({ board_id: board_id2, request_id, node_ids }) => run(async () => {
31075
31127
  const requestId = request_id.toLowerCase();
31076
31128
  const since = statusPacing.now() - (lastStatusAt.get(requestId) ?? -Infinity);
31077
31129
  if (since < statusPacing.minIntervalMs) await statusPacing.sleep(statusPacing.minIntervalMs - since);
@@ -31080,8 +31132,8 @@ function registerCanvasRunTools(server, api, run) {
31080
31132
  while (lastStatusAt.size > MAX_REMEMBERED) lastStatusAt.delete(lastStatusAt.keys().next().value);
31081
31133
  let why = "";
31082
31134
  try {
31083
- const status = await api.runStatus(board_id, requestId);
31084
- return statusText(status, lacksTitles(status.nodes) ? await titles(board_id) : (id) => id);
31135
+ const status = await api.runStatus(board_id2, requestId);
31136
+ return statusText(status, lacksTitles(status.nodes) ? await titles(board_id2) : (id) => id);
31085
31137
  } catch (e) {
31086
31138
  const reason = errorRaw(e)?.reason;
31087
31139
  if (!(e instanceof ApiError) || reason !== "unknown-request" && reason !== "no-tab") explain2(e);
@@ -31094,12 +31146,12 @@ function registerCanvasRunTools(server, api, run) {
31094
31146
  }
31095
31147
  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)` : "";
31096
31148
  return `${why} Pelo estado de execu\xE7\xE3o do board${partial2}:
31097
- ${fromRuns(await api.snapshot(board_id, { runs: true }), ids)}`;
31149
+ ${fromRuns(await api.snapshot(board_id2, { runs: true }), ids)}`;
31098
31150
  })
31099
31151
  );
31100
31152
  }
31101
31153
  var STATE_TEXT = {
31102
- preparing: "a aba est\xE1 estimando e conferindo",
31154
+ preparing: "estimando e conferindo",
31103
31155
  running: "rodando",
31104
31156
  done: "terminou",
31105
31157
  failed: "terminou com erro",
@@ -31320,6 +31372,55 @@ function lockViolation(doc, ops) {
31320
31372
  return null;
31321
31373
  }
31322
31374
 
31375
+ // src/tools/canvas-locks.ts
31376
+ var board_id = external_exports.string().uuid();
31377
+ var aba = external_exports.string().trim().min(1).max(128).describe("Id da se\xE7\xE3o da aba ou o come\xE7o \xFAnico dele (o aba=\u2026 da leitura).");
31378
+ function registerCanvasLockTools(server, deps) {
31379
+ const { api, run } = deps;
31380
+ const needOwnSession = () => {
31381
+ if (isRemoteMode()) throw new CanvasToolError("A trava de aba precisa de uma sess\xE3o pr\xF3pria, e esta conex\xE3o roda no servidor da BePlus: use o MCP local.");
31382
+ };
31383
+ server.registerTool(
31384
+ "canvas_lock_tab",
31385
+ {
31386
+ title: "Canvas: travar aba",
31387
+ description: "Marca a aba como desta sess\xE3o: outras sess\xF5es do Claude leem, mas a escrita delas nessa aba \xE9 recusada. A pessoa no navegador n\xE3o \xE9 barrada. Vale 15 minutos, renovados a cada escrita desta sess\xE3o no board, ent\xE3o sess\xE3o morta solta sozinha. Chamar de novo renova. Se outra sess\xE3o segura a aba, recusa dizendo quem. Solte com canvas_unlock_tab ao terminar.",
31388
+ inputSchema: {
31389
+ board_id,
31390
+ aba,
31391
+ label: external_exports.string().trim().min(1).max(120).optional().describe("O que esta sess\xE3o est\xE1 fazendo: aparece para quem for recusado.")
31392
+ },
31393
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
31394
+ },
31395
+ async (args) => run(async () => {
31396
+ needOwnSession();
31397
+ const { doc } = await api.snapshot(args.board_id);
31398
+ const tab = resolveTab(doc, args.aba);
31399
+ const lock = await api.lockTab(args.board_id, tab, CLIENT_ID, args.label);
31400
+ return `\u2705 Aba "${tabTitle(doc.nodes[tab])}" travada para esta sess\xE3o (${lock.sessionId}) at\xE9 ${lock.expiresAt}; cada escrita renova.`;
31401
+ })
31402
+ );
31403
+ server.registerTool(
31404
+ "canvas_unlock_tab",
31405
+ {
31406
+ title: "Canvas: soltar aba",
31407
+ description: "Solta a aba que esta sess\xE3o travou com canvas_lock_tab. Trava de outra sess\xE3o n\xE3o muda: ela s\xF3 some quando a dona solta ou vence.",
31408
+ inputSchema: { board_id, aba },
31409
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
31410
+ },
31411
+ async (args) => run(async () => {
31412
+ needOwnSession();
31413
+ const { doc } = await api.snapshot(args.board_id);
31414
+ const tab = resolveTab(doc, args.aba);
31415
+ const { released } = await api.unlockTab(args.board_id, tab, CLIENT_ID);
31416
+ const name = `"${tabTitle(doc.nodes[tab])}"`;
31417
+ if (released) return `\u2705 Aba ${name} solta.`;
31418
+ const other = (await api.tabLocks(args.board_id)).find((l) => l.tabId === tab);
31419
+ return other ? `Nada mudou: ${describeLock(other)}.` : `A aba ${name} j\xE1 estava livre.`;
31420
+ })
31421
+ );
31422
+ }
31423
+
31323
31424
  // src/canvas/mentions.ts
31324
31425
  var VIA_MENTION = "viaMention";
31325
31426
  var PROMPT_REFS_INPUT = "refs";
@@ -31451,16 +31552,79 @@ function describeMentionSync(sync, name) {
31451
31552
  return parts.length ? ` ${parts.join(". ")}.` : "";
31452
31553
  }
31453
31554
 
31555
+ // src/canvas/text-file.ts
31556
+ import { createHash as createHash2 } from "crypto";
31557
+ import { readFile as readFile3, realpath, stat as stat4 } from "fs/promises";
31558
+ import { extname as extname4 } from "path";
31559
+ var TEXT_FILE_EXTENSIONS = ["txt", "md", "markdown", "csv", "tsv", "srt", "vtt"];
31560
+ var MAX_TEXT_FILE_BYTES = MAX_OP_BYTES - 4 * 1024;
31561
+ var kb = (bytes) => (bytes / 1024).toFixed(1).replace(".", ",");
31562
+ async function readTextFile(ref) {
31563
+ const refuse = (why) => new CanvasToolError(`Arquivo "${ref}": ${why} Nada foi gravado.`);
31564
+ let abs;
31565
+ try {
31566
+ abs = toLocalPath(ref);
31567
+ } catch (e) {
31568
+ if (e instanceof ApiError) {
31569
+ throw refuse("esta conex\xE3o roda no servidor da BePlus, que n\xE3o enxerga o seu computador. Mande o texto direto em data ou value.");
31570
+ }
31571
+ throw refuse("o caminho n\xE3o \xE9 v\xE1lido.");
31572
+ }
31573
+ if (isRemoteRef(ref)) throw refuse("aqui vale s\xF3 caminho local, n\xE3o URL.");
31574
+ let real;
31575
+ let size;
31576
+ try {
31577
+ real = await realpath(abs);
31578
+ const info = await stat4(real);
31579
+ if (!info.isFile()) throw refuse("n\xE3o \xE9 um arquivo comum.");
31580
+ size = info.size;
31581
+ } catch (e) {
31582
+ if (e instanceof CanvasToolError) throw e;
31583
+ throw refuse("n\xE3o encontrei ou n\xE3o consegui abrir.");
31584
+ }
31585
+ const ext = extname4(real).slice(1).toLowerCase();
31586
+ if (!TEXT_FILE_EXTENSIONS.includes(ext)) {
31587
+ throw refuse(`${ext ? `a extens\xE3o .${ext}` : "arquivo sem extens\xE3o"} n\xE3o \xE9 aceita. Aceitas: ${TEXT_FILE_EXTENSIONS.join(", ")}.`);
31588
+ }
31589
+ const tooLarge2 = (bytes) => refuse(`d\xE1 ${kb(bytes)} KB para enviar, acima do teto de ${kb(MAX_TEXT_FILE_BYTES)} KB (uma opera\xE7\xE3o do Canvas leva at\xE9 64 KB). Divida o texto em mais de um campo.`);
31590
+ if (size > MAX_TEXT_FILE_BYTES) throw tooLarge2(size);
31591
+ let buf;
31592
+ try {
31593
+ buf = await readFile3(real);
31594
+ } catch {
31595
+ throw refuse("n\xE3o consegui ler.");
31596
+ }
31597
+ let text;
31598
+ try {
31599
+ if (buf.includes(0)) throw new Error("nul");
31600
+ text = new TextDecoder("utf-8", { fatal: true }).decode(buf);
31601
+ } catch {
31602
+ throw refuse("parece bin\xE1rio ou n\xE3o est\xE1 em UTF-8. Salve como texto UTF-8.");
31603
+ }
31604
+ if (!text.trim()) throw refuse("est\xE1 vazio.");
31605
+ const json = JSON.stringify(text);
31606
+ const wire = Buffer.byteLength(json);
31607
+ if (wire > MAX_TEXT_FILE_BYTES) throw tooLarge2(wire);
31608
+ return { text, bytes: buf.byteLength, hash: createHash2("sha256").update(json).digest("hex").slice(0, 12) };
31609
+ }
31610
+ function describeTextFiles(read) {
31611
+ if (!read.length) return "";
31612
+ return ` Lido de arquivo: ${read.map((r) => `${r.path} \u2190 "${r.ref}" (${r.file.bytes} bytes, sha256 ${r.file.hash})`).join("; ")}.`;
31613
+ }
31614
+
31454
31615
  // src/tools/canvas.ts
31455
31616
  var REJECT_TEXT = {
31456
31617
  "node-missing": "o n\xF3 n\xE3o existe mais (algu\xE9m apagou)",
31457
31618
  "edge-endpoint-missing": "uma ponta da liga\xE7\xE3o n\xE3o existe mais",
31458
31619
  "invalid-op": "opera\xE7\xE3o inv\xE1lida ou repetida",
31459
- "too-large": "opera\xE7\xE3o grande demais (64 KB) ou com m\xEDdia embutida"
31620
+ "too-large": "opera\xE7\xE3o grande demais (64 KB) ou com m\xEDdia embutida",
31621
+ "tab-locked": "a aba est\xE1 travada por outra sess\xE3o"
31460
31622
  };
31623
+ var rejectText = (o) => o.lockedBy ? describeLock(o.lockedBy) : REJECT_TEXT[o.rejected] ?? o.rejected;
31461
31624
  var READ = "Exige canvas_read_board nesta sess\xE3o (e de novo depois de uma recusa). ";
31462
31625
  var MENTION_NOTE = 'Prompt: {{var}} no template + data.mentions {var: {node, port}} (o !! de um Bloco \xE9 port "text") j\xE1 cria, no mesmo passo, a liga\xE7\xE3o fina de men\xE7\xE3o que o Canvas desenha; tirar a var ou a men\xE7\xE3o tira a liga\xE7\xE3o. ';
31463
31626
  var MONTAGE_NOTE = "Montagem: musicGainDb, duckingDb e fadeMs valem s\xF3 para a montagem autom\xE1tica (clipes ligados) e n\xE3o mexem na timeline do editor (data.timeline; data.sequence \xE9 o legado); o volume dela fica nos clipes (gainDb, gainKeyframes, fades) e nas faixas (gainDb de cada faixa, master).";
31627
+ var FILE_NOTE = `Texto grande (prompt, roteiro): salve num arquivo local e passe o caminho, n\xE3o digite na chamada. S\xF3 ${TEXT_FILE_EXTENSIONS.join(", ")}, UTF-8, at\xE9 ${MAX_TEXT_FILE_BYTES / 1024} KB; n\xE3o vale no conector remoto. `;
31464
31628
  function dataSegments(path) {
31465
31629
  const p = path?.trim() ?? "";
31466
31630
  if (!p || p === "data") return [];
@@ -31468,6 +31632,32 @@ function dataSegments(path) {
31468
31632
  if (segs.some((seg) => !seg)) throw new CanvasToolError(`Caminho "${p}" tem segmento vazio (dois pontos seguidos ou ponto na ponta).`);
31469
31633
  return segs;
31470
31634
  }
31635
+ async function withDataFiles(raw, files) {
31636
+ const data = structuredClone(raw ?? {});
31637
+ const read = [];
31638
+ for (const [asked, ref] of Object.entries(files ?? {})) {
31639
+ const at = `data_files["${asked}"]`;
31640
+ const segs = dataSegments(asked);
31641
+ if (!segs.length) throw new CanvasToolError(`${at}: informe um caminho dentro do data, n\xE3o o data inteiro.`);
31642
+ const path = segs.join(".");
31643
+ const badPath = checkNodePath(`data.${path}`);
31644
+ if (badPath) throw new CanvasToolError(`${at}: ${badPath}.`);
31645
+ let cur = data;
31646
+ for (const [i, seg] of segs.slice(0, -1).entries()) {
31647
+ const next = Object.hasOwn(cur, seg) ? cur[seg] : cur[seg] = {};
31648
+ if (!next || typeof next !== "object" || Array.isArray(next)) {
31649
+ throw new CanvasToolError(`${at}: data.${segs.slice(0, i + 1).join(".")} n\xE3o \xE9 objeto, e o caminho n\xE3o entra nele.`);
31650
+ }
31651
+ cur = next;
31652
+ }
31653
+ const leaf = segs[segs.length - 1];
31654
+ if (Object.hasOwn(cur, leaf)) throw new CanvasToolError(`${at}: data.${path} j\xE1 veio neste pedido. Mande o valor por um lugar s\xF3.`);
31655
+ const file = await readTextFile(ref);
31656
+ cur[leaf] = file.text;
31657
+ read.push({ path, ref, file });
31658
+ }
31659
+ return { data, note: describeTextFiles(read) };
31660
+ }
31471
31661
  function legacySequenceGuard(node, key) {
31472
31662
  if (key === "sequence" && nodeKind(node) === "montage" && node.data.timeline !== void 0) {
31473
31663
  throw new CanvasToolError(
@@ -31542,7 +31732,7 @@ function registerCanvasTools(server, client, cfg) {
31542
31732
  const snap = await api.snapshot(id, { fresh: true });
31543
31733
  if (snap.role === "viewer") throw new CanvasToolError("Voc\xEA \xE9 s\xF3 leitor neste board: pe\xE7a ao dono para te dar papel de editor.");
31544
31734
  const doc = snap.doc;
31545
- const { ops, done, targets } = await build2(doc, snap);
31735
+ const { ops, done, targets, place } = await build2(doc, snap);
31546
31736
  if (!ops.length) return `Nada a mudar. ${done}`;
31547
31737
  if (opts.layoutOnly && !ops.every(isLayoutOp)) throw new Error("layout_only com opera\xE7\xE3o fora de posi\xE7\xE3o/tamanho");
31548
31738
  const locked = lockViolation(doc, ops);
@@ -31571,14 +31761,17 @@ function registerCanvasTools(server, client, cfg) {
31571
31761
  Aviso: ${changesSince(theirs, doc)}.`;
31572
31762
  }
31573
31763
  if (opts.split) return commitSplit(id, ops, done, note, !!opts.layoutOnly);
31574
- const env = envelope(id, batchOf(ops), await api.me());
31764
+ const env = { ...envelope(id, batchOf(ops), await api.me()), ...place && { place } };
31575
31765
  const bad = checkEnvelope(env);
31576
31766
  if (bad) throw new CanvasToolError(`Edi\xE7\xE3o recusada antes de enviar: ${bad}.`);
31577
31767
  const res = await commitOps(id, [env]);
31578
31768
  const outcome = res.outcomes.find((o) => o.opId === env.id);
31769
+ if (outcome && "rejected" in outcome && outcome.rejected === "tab-locked") {
31770
+ throw new CanvasToolError(`O servidor recusou a edi\xE7\xE3o: ${rejectText(outcome)}. Nada foi aplicado. Ler continua valendo; para escrever, espere soltar ou use outra aba.`);
31771
+ }
31579
31772
  if (!outcome || "rejected" in outcome) {
31580
31773
  if (!opts.layoutOnly) seen.delete(id);
31581
- const why = outcome && "rejected" in outcome ? REJECT_TEXT[outcome.rejected] ?? outcome.rejected : "sem resposta do servidor";
31774
+ const why = outcome && "rejected" in outcome ? rejectText(outcome) : "sem resposta do servidor";
31582
31775
  throw new CanvasToolError(`O servidor recusou a edi\xE7\xE3o: ${why}. Nada foi aplicado. Releia com canvas_read_board.`);
31583
31776
  }
31584
31777
  if (!opts.layoutOnly) seen.set(id, res.seq);
@@ -31612,10 +31805,10 @@ Aviso: ${changesSince(theirs, doc)}.`;
31612
31805
  const lines = envs.map((env, i) => {
31613
31806
  const paths = pathsOf(env.op);
31614
31807
  const span = paths.length > 1 ? `${paths[0]} \u2026 ${paths[paths.length - 1]}` : paths[0];
31615
- const kb = (Buffer.byteLength(JSON.stringify(env)) / 1024).toFixed(1).replace(".", ",");
31808
+ const kb2 = (Buffer.byteLength(JSON.stringify(env)) / 1024).toFixed(1).replace(".", ",");
31616
31809
  const o = outcomes.get(env.id);
31617
- const result = o && "seq" in o ? `seq ${o.seq}` : (failed++, `RECUSADO (${o && "rejected" in o ? REJECT_TEXT[o.rejected] ?? o.rejected : "sem resposta do servidor"}): nada deste envelope entrou`);
31618
- return `- envelope ${i + 1}/${envs.length}: ${paths.length} caminho(s) (${span}), ${kb} KB \u2192 ${result}`;
31810
+ const result = o && "seq" in o ? `seq ${o.seq}` : (failed++, `RECUSADO (${o && "rejected" in o ? rejectText(o) : "sem resposta do servidor"}): nada deste envelope entrou`);
31811
+ return `- envelope ${i + 1}/${envs.length}: ${paths.length} caminho(s) (${span}), ${kb2} KB \u2192 ${result}`;
31619
31812
  });
31620
31813
  if (failed) {
31621
31814
  if (!layoutOnly) seen.delete(id);
@@ -31746,7 +31939,7 @@ ${lines.join("\n")}${note}`;
31746
31939
  "canvas_read_board",
31747
31940
  {
31748
31941
  title: "Canvas: ler board",
31749
- 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. Cada cart\xE3o diz a aba (aba=<id curto> ou aba=avulsos), o topo conta os cart\xF5es de cada aba e aba l\xEA uma aba s\xF3.',
31942
+ 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 s\xF3 o data desses n\xF3s, sem o resto do board, com cada corte marcado (path=\u2026); o valor inteiro (ex.: data.sequence da Montagem) sai no canvas_read_node. Cada cart\xE3o diz a aba (aba=<id curto> ou aba=avulsos), o topo conta os cart\xF5es de cada aba e aba l\xEA uma aba s\xF3.',
31750
31943
  inputSchema: {
31751
31944
  board_id: boardId3,
31752
31945
  node_ids: external_exports.array(nodeIdArg2).max(20).optional().describe("N\xF3s para ver o data (sem blobs, cortes marcados)."),
@@ -31754,11 +31947,26 @@ ${lines.join("\n")}${note}`;
31754
31947
  },
31755
31948
  annotations: { readOnlyHint: true, openWorldHint: false }
31756
31949
  },
31757
- async ({ board_id, node_ids, aba }) => run(async () => {
31758
- const snap = await api.snapshot(board_id);
31759
- const tab = aba ? resolveTab(snap.doc, aba, { allowAvulsos: true }) : void 0;
31760
- seen.set(board_id, snap.seq);
31950
+ async ({ board_id: board_id2, node_ids, aba: aba2 }) => run(async () => {
31951
+ if (node_ids?.length && !aba2) {
31952
+ const read = await api.readNodes(board_id2, node_ids);
31953
+ if (!seen.has(board_id2)) seen.set(board_id2, read.seq);
31954
+ const found = node_ids.flatMap((n) => read.nodes[n] ? [read.nodes[n]] : []);
31955
+ return [
31956
+ `Board "${read.title}" \xB7 id ${board_id2} \xB7 seq ${read.seq} \xB7 ${node_ids.length} n\xF3(s) pedido(s)`,
31957
+ "",
31958
+ ...found.flatMap((n) => nodeLines(n)),
31959
+ "",
31960
+ "Detalhe:",
31961
+ ...node_ids.map((n) => read.nodes[n] ? nodeDetail(read.nodes[n]) : `${n}: n\xE3o existe`)
31962
+ ].join("\n");
31963
+ }
31964
+ const snap = await api.snapshot(board_id2);
31965
+ const tab = aba2 ? resolveTab(snap.doc, aba2, { allowAvulsos: true }) : void 0;
31966
+ seen.set(board_id2, snap.seq);
31761
31967
  const parts = [boardSummary(snap, { tab })];
31968
+ const locks = await api.tabLocks(board_id2).catch(() => []);
31969
+ if (locks.length) parts.push("", "Travas de sess\xE3o:", ...locks.map((l) => `- ${describeLock(l)}`));
31762
31970
  if (node_ids?.length) {
31763
31971
  parts.push("", "Detalhe:");
31764
31972
  for (const n of node_ids) parts.push(snap.doc.nodes[n] ? nodeDetail(snap.doc.nodes[n]) : `${n}: n\xE3o existe`);
@@ -31780,9 +31988,9 @@ ${lines.join("\n")}${note}`;
31780
31988
  },
31781
31989
  annotations: { readOnlyHint: true, openWorldHint: false }
31782
31990
  },
31783
- async ({ board_id, node_id, path, offset, max_chars }) => run(async () => {
31784
- const snap = await api.snapshot(board_id);
31785
- const node = snap.doc.nodes[node_id];
31991
+ async ({ board_id: board_id2, node_id, path, offset, max_chars }) => run(async () => {
31992
+ const read = await api.readNodes(board_id2, [node_id]);
31993
+ const node = read.nodes[node_id];
31786
31994
  if (!node) throw new CanvasToolError(`N\xF3 ${node_id} n\xE3o existe no board. Releia com canvas_read_board.`);
31787
31995
  let value = visibleData(node.data);
31788
31996
  let segments = dataSegments(path);
@@ -31815,10 +32023,10 @@ ${lines.join("\n")}${note}`;
31815
32023
  const from = Math.min(offset ?? 0, total);
31816
32024
  const size = max_chars ?? 4e4;
31817
32025
  const to = Math.min(from + size, total);
31818
- const hash = createHash2("sha256").update(json).digest("hex").slice(0, 12);
32026
+ const hash = createHash3("sha256").update(json).digest("hex").slice(0, 12);
31819
32027
  const where = `data${segments.length ? `.${segments.join(".")}` : ""}`;
31820
32028
  const at = readMeasured(node)?.at;
31821
- const head = `${node.id} \xB7 ${nodeKind(node) ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" \xB7 board seq ${snap.seq} \xB7 tamanho ${sizeLabel(node)}${at ? ` \xB7 medido em ${at}` : ""} \xB7 ${where}${which}: ${total} caracteres (JSON compacto) \xB7 sha256 ${hash}`;
32029
+ const head = `${node.id} \xB7 ${nodeKind(node) ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" \xB7 board seq ${read.seq} \xB7 tamanho ${sizeLabel(node)}${at ? ` \xB7 medido em ${at}` : ""} \xB7 ${where}${which}: ${total} caracteres (JSON compacto) \xB7 sha256 ${hash}`;
31822
32030
  const part = from === 0 && to === total ? "Inteiro, abaixo." : `Parte: caracteres ${from} a ${to} de ${total}. ${to < total ? `Falta o resto: chame de novo com offset=${to}.` : "Esta \xE9 a \xFAltima parte."}`;
31823
32031
  return `${head}
31824
32032
  ${part}
@@ -31879,12 +32087,13 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31879
32087
  "canvas_add_node",
31880
32088
  {
31881
32089
  title: "Canvas: adicionar n\xF3",
31882
- 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 (com aba, no fim do conte\xFAdo da aba); aba grava data.abaId. Texto livre (label) sem size {w} nasce na largura do tamanho do texto: titulo 2000, subtitulo 1200, corpo 320. Prompt sem size nasce com 1024 \xD7 516; gerador de imagem ou v\xEDdeo, com altura 516 e a largura do aspect_ratio (16:9 917, 9:16 290, 1:1 516). inputs/outputs j\xE1 ligam o n\xF3 no mesmo passo. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
32090
+ 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 (com aba, no fim do conte\xFAdo da aba); aba grava data.abaId. Texto livre (label) sem size {w} nasce na largura do tamanho do texto: titulo 2000, subtitulo 1200, corpo 320. Prompt sem size nasce com 1024 \xD7 516; gerador de imagem ou v\xEDdeo, com altura 516 e a largura do aspect_ratio (16:9 917, 9:16 290, 1:1 516). inputs/outputs j\xE1 ligam o n\xF3 no mesmo passo. ${FILE_NOTE}data_files {"template": "/tmp/prompt.md"} grava o texto do arquivo nesse caminho do data, igual a ter vindo em data. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
31883
32091
  inputSchema: {
31884
32092
  board_id: boardId3,
31885
32093
  kind: external_exports.string().min(1).max(40),
31886
32094
  label: external_exports.string().trim().min(1).max(120).optional().describe("Nome do cart\xE3o (data.label)."),
31887
32095
  data: external_exports.record(external_exports.unknown()).optional().describe("Campos do data. Ex.: narration {blocks:[{id,text}]}, text {text}, prompt {template}."),
32096
+ data_files: external_exports.record(external_exports.string().min(1).max(4096)).optional().describe('Texto vindo de arquivo local: { "<caminho no data>": "<arquivo>" }. Ex.: { "template": "/tmp/prompt.md" }. Prefira a digitar texto grande em data.'),
31888
32097
  aba: abaArg(ABA_ADD_NODE),
31889
32098
  position: point.optional(),
31890
32099
  size: sizeArg.optional(),
@@ -31898,7 +32107,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31898
32107
  const spec = KINDS[args.kind];
31899
32108
  if (!spec) throw new CanvasToolError(`Tipo "${args.kind}" desconhecido. Tipos: ${kindList()}.`);
31900
32109
  const me = await api.me();
31901
- const data = { ...spec.data, ...parseData(args.data), [KIND_FIELD]: args.kind };
32110
+ const input = await withDataFiles(args.data, args.data_files);
32111
+ const data = { ...spec.data, ...parseData(input.data), [KIND_FIELD]: args.kind };
31902
32112
  if (args.label) data.label = args.label;
31903
32113
  if (typeof args.size === "string") data.size = textSizeFor(args.kind, args.size);
31904
32114
  const box = birthBox(args.kind, spec, data, args.size && typeof args.size !== "string" ? boxOf(args.size) : void 0);
@@ -31914,7 +32124,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31914
32124
  if (tab !== void 0) data[TAB_ID_FIELD] = tab;
31915
32125
  const near = args.inputs?.[0] ? doc.nodes[args.inputs[0].from] : args.outputs?.[0] ? doc.nodes[args.outputs[0].to] : void 0;
31916
32126
  const nearTab = near ? homeTabOf(doc, near.id) ?? void 0 : void 0;
31917
- const position = args.position ?? placeFor(doc, box, tab === void 0 ? near : void 0, args.inputs?.[0] ? "right" : "left", tab ?? nearTab);
32127
+ const side = args.inputs?.[0] ? "right" : "left";
32128
+ const position = args.position ?? placeFor(doc, box, tab === void 0 ? near : void 0, side, tab ?? nearTab);
31918
32129
  const zIndex = args.kind === "section" ? SECTION_Z : Object.values(doc.nodes).reduce((t, n) => Math.max(t, n.zIndex), 0) + 1;
31919
32130
  const node = makeNode({ type: WORKFLOW_NODE_TYPE, data, position, size: box, zIndex, createdBy: me });
31920
32131
  const links = [
@@ -31931,11 +32142,12 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31931
32142
  }
31932
32143
  const edges = edgeOps(doc, links, me, /* @__PURE__ */ new Set([node.id]));
31933
32144
  const drawn = edges.ops.flatMap((op) => op.type === "edge.add" ? [op.edge] : []);
31934
- const mention = await mentionOps(doc, [{ node, data: node.data, keys: Object.keys(args.data ?? {}) }], drawn);
32145
+ const mention = await mentionOps(doc, [{ node, data: node.data, keys: Object.keys(input.data) }], drawn);
31935
32146
  return {
31936
32147
  ops: [{ type: "node.add", nodeId: node.id, node }, ...edges.ops, ...mention.ops],
31937
32148
  targets: links.map((l) => l.source === node.id ? l.target : l.source),
31938
- done: `N\xF3 ${args.kind} "${nodeName(node)}" criado: ${node.id}${edges.ops.length ? ` com ${edges.ops.length} liga\xE7\xE3o(\xF5es)` : ""}.${placementNote(doc, node)}${edges.warn}${mention.note}`
32149
+ ...args.position ? {} : { place: { [node.id]: tab !== void 0 ? { tab } : near ? { near: near.id, side } : {} } },
32150
+ done: `N\xF3 ${args.kind} "${nodeName(node)}" criado: ${node.id}${edges.ops.length ? ` com ${edges.ops.length} liga\xE7\xE3o(\xF5es)` : ""}.${placementNote(doc, node)}${edges.warn}${mention.note}${input.note}`
31939
32151
  };
31940
32152
  })
31941
32153
  )
@@ -31944,7 +32156,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31944
32156
  "canvas_update_node",
31945
32157
  {
31946
32158
  title: "Canvas: editar n\xF3",
31947
- 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. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
32159
+ 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) ou gravar texto grande por arquivo, use canvas_patch_node, por caminho; v\xE1rios n\xF3s de uma vez, canvas_update_nodes. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
31948
32160
  inputSchema: {
31949
32161
  board_id: boardId3,
31950
32162
  node_id: nodeIdArg2,
@@ -32024,7 +32236,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32024
32236
  "canvas_patch_node",
32025
32237
  {
32026
32238
  title: "Canvas: gravar por caminho",
32027
- 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. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
32239
+ description: `Grava v\xE1rios caminhos dentro do data de um n\xF3, sem executar: {path, value} grava, {path, file} grava o texto de um arquivo local, {path, unset: true} apaga. ${READ}${FILE_NOTE}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. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
32028
32240
  inputSchema: {
32029
32241
  board_id: boardId3,
32030
32242
  node_id: nodeIdArg2,
@@ -32032,7 +32244,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32032
32244
  external_exports.object({
32033
32245
  path: external_exports.string().trim().min(1).max(500).describe('Caminho dentro do data (ex.: "timeline.meta.fps"); aceita o prefixo "data.".'),
32034
32246
  value: external_exports.unknown().optional().describe("Valor JSON a gravar (null grava null)."),
32035
- unset: external_exports.literal(true).optional().describe("true apaga a chave.")
32247
+ unset: external_exports.literal(true).optional().describe("true apaga a chave."),
32248
+ file: external_exports.string().min(1).max(4096).optional().describe('Arquivo local cujo texto vira o valor, no lugar de value. Ex.: "/tmp/prompt.md". Prefira a digitar texto grande em value.')
32036
32249
  })
32037
32250
  ).min(1).max(5e3)
32038
32251
  },
@@ -32049,6 +32262,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32049
32262
  let absent = 0;
32050
32263
  const mentionKeys = /* @__PURE__ */ new Set();
32051
32264
  let mentionAt = -1;
32265
+ const read = [];
32052
32266
  for (const [i, item] of args.sets.entries()) {
32053
32267
  const at = `sets[${i}] (${item.path})`;
32054
32268
  const segs = dataSegments(item.path);
@@ -32061,7 +32275,10 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32061
32275
  if (MENTION_KEYS.includes(segs[0])) mentionKeys.add(segs[0]);
32062
32276
  const unset = item.unset === true;
32063
32277
  const hasValue = item.value !== void 0;
32064
- if (unset === hasValue) throw new CanvasToolError(`${at}: mande value OU unset: true.`);
32278
+ const hasFile = item.file !== void 0;
32279
+ if ([unset, hasValue, hasFile].filter(Boolean).length !== 1) {
32280
+ throw new CanvasToolError(`${at}: mande s\xF3 um de value, unset: true ou file.`);
32281
+ }
32065
32282
  if (hasValue && !isJson(item.value)) throw new CanvasToolError(`${at}: value n\xE3o \xE9 JSON v\xE1lido.`);
32066
32283
  let cur = work;
32067
32284
  for (const [j, seg] of segs.slice(0, -1).entries()) {
@@ -32096,7 +32313,9 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32096
32313
  if (MENTION_KEYS.includes(segs[0])) mentionAt = ops.length;
32097
32314
  continue;
32098
32315
  }
32099
- const value = item.value;
32316
+ const file = item.file === void 0 ? null : await readTextFile(item.file);
32317
+ if (file) read.push({ path: segs.join("."), ref: item.file, file });
32318
+ const value = file ? file.text : item.value;
32100
32319
  if (cur && Object.hasOwn(cur, leaf) && JSON.stringify(cur[leaf]) === JSON.stringify(value)) {
32101
32320
  same++;
32102
32321
  continue;
@@ -32112,7 +32331,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32112
32331
  return {
32113
32332
  ops,
32114
32333
  targets: [node.id],
32115
- done: `N\xF3 "${oneLine2(nodeName(node), 40)}" (${node.id}): ${written} caminho(s) gravado(s)` + (skipped ? ` (ignorados: ${skipped})` : "") + mention.note
32334
+ done: `N\xF3 "${oneLine2(nodeName(node), 40)}" (${node.id}): ${written} caminho(s) gravado(s)` + (skipped ? ` (ignorados: ${skipped})` : "") + mention.note + describeTextFiles(read)
32116
32335
  };
32117
32336
  },
32118
32337
  { split: true }
@@ -32199,8 +32418,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32199
32418
  inputSchema: { board_id: boardId3, title: external_exports.string().trim().min(1).max(200) },
32200
32419
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
32201
32420
  },
32202
- async ({ board_id, title }) => run(
32203
- () => edit(board_id, async (doc) => ({
32421
+ async ({ board_id: board_id2, title }) => run(
32422
+ () => edit(board_id2, async (doc) => ({
32204
32423
  ops: doc.title === title ? [] : [{ type: "board.set", field: "title", value: setValue(title) }],
32205
32424
  targets: [],
32206
32425
  done: `Board renomeado: "${doc.title}" \u2192 "${title}"`
@@ -32215,8 +32434,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32215
32434
  inputSchema: { board_id: boardId3 },
32216
32435
  annotations: { readOnlyHint: true, openWorldHint: false }
32217
32436
  },
32218
- async ({ board_id }) => run(async () => {
32219
- const members = await api.members(board_id);
32437
+ async ({ board_id: board_id2 }) => run(async () => {
32438
+ const members = await api.members(board_id2);
32220
32439
  return members.map((m) => {
32221
32440
  const name = [m.firstName, m.lastName].filter(Boolean).join(" ") || m.nickname || "(sem nome)";
32222
32441
  return `- ${m.userId} \xB7 ${name} \xB7 ${m.role}`;
@@ -32235,8 +32454,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32235
32454
  },
32236
32455
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
32237
32456
  },
32238
- async ({ board_id, user_id, role }) => run(async () => {
32239
- const r = await api.putMember(board_id, user_id, role);
32457
+ async ({ board_id: board_id2, user_id, role }) => run(async () => {
32458
+ const r = await api.putMember(board_id2, user_id, role);
32240
32459
  return `\u2705 ${r.userId} agora \xE9 ${r.role} no board.`;
32241
32460
  })
32242
32461
  );
@@ -32248,13 +32467,14 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32248
32467
  inputSchema: { board_id: boardId3, user_id: external_exports.string().uuid() },
32249
32468
  annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
32250
32469
  },
32251
- async ({ board_id, user_id }) => run(async () => {
32252
- await api.removeMember(board_id, user_id);
32470
+ async ({ board_id: board_id2, user_id }) => run(async () => {
32471
+ await api.removeMember(board_id2, user_id);
32253
32472
  return `\u2705 ${user_id} n\xE3o tem mais acesso ao board.`;
32254
32473
  })
32255
32474
  );
32256
32475
  registerCanvasCommentTools(server, api, run);
32257
32476
  registerCanvasMediaTools(server, { api, cfg, run, edit, seen, placeFor });
32477
+ registerCanvasLockTools(server, { api, run });
32258
32478
  registerCanvasLayoutTools(server, { api, run, edit });
32259
32479
  registerCanvasRunTools(server, api, run);
32260
32480
  registerCanvasFocusTools(server, api, run);
@@ -32264,7 +32484,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32264
32484
  import { createRequire } from "module";
32265
32485
  var require2 = createRequire(import.meta.url);
32266
32486
  function readVersion() {
32267
- if ("0.47.0") return "0.47.0";
32487
+ if ("0.49.0") return "0.49.0";
32268
32488
  try {
32269
32489
  const pkg = require2("../package.json");
32270
32490
  return pkg.version ?? "0.0.0-unknown";
@@ -32279,7 +32499,7 @@ var SERVER_INSTRUCTIONS = [
32279
32499
  "BePlus: tudo roda pela conta do usu\xE1rio (diamantes, limites e hist\xF3rico na plataforma).",
32280
32500
  'M\xEDdia: generate_* e elevenlabs_* gastam 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.',
32281
32501
  "Calls: search_calls acha, get_call traz a transcri\xE7\xE3o.",
32282
- "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.",
32502
+ "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 no servidor 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.",
32283
32503
  "Cada aba \xE9 um plano: ao criar, passe aba (id da se\xE7\xE3o) em canvas_add_node e canvas_upload_media, sen\xE3o o cart\xE3o pode cair em Avulsos. canvas_read_board com aba l\xEA uma aba s\xF3.",
32284
32504
  '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.',
32285
32505
  '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.',