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.
package/dist/index.js CHANGED
@@ -27862,11 +27862,21 @@ ${calls.map(callLine).join("\n\n")}`);
27862
27862
  }
27863
27863
 
27864
27864
  // src/tools/canvas.ts
27865
- import { createHash as createHash2 } from "crypto";
27865
+ import { createHash as createHash3 } from "crypto";
27866
27866
 
27867
27867
  // src/canvas/api.ts
27868
27868
  import { createHash } from "crypto";
27869
27869
  var import_canvas_core = __toESM(require_canvas_core(), 1);
27870
+
27871
+ // src/canvas/tab-locks.ts
27872
+ var MINUTE = 6e4;
27873
+ function describeLock(lock, now = Date.now()) {
27874
+ const minutes = Math.max(1, Math.ceil((Date.parse(lock.expiresAt) - now) / MINUTE));
27875
+ const doing = lock.label ? `, "${lock.label}"` : "";
27876
+ 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`;
27877
+ }
27878
+
27879
+ // src/canvas/api.ts
27870
27880
  var PINNED_CORE_VERSION = "ca7b3b406184c7f679f555c3a008013197182b23";
27871
27881
  var RUN_REQUEST_TIMEOUT_MS = 4e4;
27872
27882
  var FOCUS_REQUEST_TIMEOUT_MS = 12e3;
@@ -27977,6 +27987,27 @@ var CanvasApi = class {
27977
27987
  boardLoads.set(loadKey, load);
27978
27988
  return load;
27979
27989
  }
27990
+ /**
27991
+ * Só estes nós. Com o board em cache, o delta já resolve e custa menos que a rota; sem cache, a
27992
+ * rota evita baixar o board inteiro. 404 pode ser servidor antigo: a foto decide se o board existe.
27993
+ */
27994
+ async readNodes(boardId4, ids) {
27995
+ if (!boardStore.has(this.cacheKey(boardId4))) {
27996
+ try {
27997
+ return await this.req("GET", `/boards/${boardId4}/nodes`, { query: { ids: ids.join(",") } });
27998
+ } catch (e) {
27999
+ if (!(e instanceof ApiError) || e.httpStatus !== 404) throw e;
28000
+ }
28001
+ }
28002
+ const snap = await this.snapshot(boardId4);
28003
+ const known = ids.filter((id) => Object.hasOwn(snap.doc.nodes, id));
28004
+ return {
28005
+ title: snap.title,
28006
+ seq: snap.seq,
28007
+ nodes: Object.fromEntries(known.map((id) => [id, snap.doc.nodes[id]])),
28008
+ missing: ids.filter((id) => !known.includes(id))
28009
+ };
28010
+ }
27980
28011
  async load(boardId4, key, needRuns) {
27981
28012
  const entry = boardStore.get(key);
27982
28013
  if (entry && !needRuns && this.coreVersion === PINNED_CORE_VERSION) {
@@ -28074,8 +28105,26 @@ var CanvasApi = class {
28074
28105
  }
28075
28106
  throw again;
28076
28107
  }
28108
+ } finally {
28109
+ const entry = boardStore.get(this.cacheKey(boardId4));
28110
+ if (entry) entry.checkedAt = -Infinity;
28111
+ }
28112
+ }
28113
+ tabLocks(boardId4) {
28114
+ return this.req("GET", `/boards/${boardId4}/tab-locks`);
28115
+ }
28116
+ async lockTab(boardId4, tabId, session, label) {
28117
+ try {
28118
+ return await this.req("PUT", `/boards/${boardId4}/tabs/${encodeURIComponent(tabId)}/lock`, { body: { session, label } });
28119
+ } catch (e) {
28120
+ const raw = errorRaw(e);
28121
+ if (raw?.reason !== "tab-locked" || !raw.lockedBy) throw e;
28122
+ throw new CanvasToolError(`N\xE3o travou: ${describeLock(raw.lockedBy)}.`);
28077
28123
  }
28078
28124
  }
28125
+ unlockTab(boardId4, tabId, session) {
28126
+ return this.req("DELETE", `/boards/${boardId4}/tabs/${encodeURIComponent(tabId)}/lock`, { query: { session } });
28127
+ }
28079
28128
  members(boardId4) {
28080
28129
  return this.req("GET", `/boards/${boardId4}/members`);
28081
28130
  }
@@ -29077,15 +29126,15 @@ function rowsLines(rows) {
29077
29126
  if (rows.length > MAX_BLOCKS) out.push(` \xB7 \u2026 +${rows.length - MAX_BLOCKS} linhas`);
29078
29127
  return out;
29079
29128
  }
29080
- function nodeLines(node, run, aba) {
29129
+ function nodeLines(node, run, aba2) {
29081
29130
  const kind = nodeKind(node);
29082
29131
  const spec = kind ? KINDS[kind] : void 0;
29083
- 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}` : "");
29132
+ 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}` : "");
29084
29133
  const facts = [];
29085
29134
  const extra = [];
29086
29135
  const d = node.data;
29087
29136
  if (d.archived) facts.push("ARQUIVADO");
29088
- if (aba && isTabSection(node)) facts.push("\xE9 aba");
29137
+ if (aba2 && isTabSection(node)) facts.push("\xE9 aba");
29089
29138
  const approval = d.approval?.state;
29090
29139
  if (typeof approval === "string") facts.push(`aprova\xE7\xE3o: ${approval}`);
29091
29140
  if (Array.isArray(d.history)) facts.push(`${d.history.length} gera\xE7\xE3o(\xF5es)`);
@@ -29110,7 +29159,7 @@ function nodeLines(node, run, aba) {
29110
29159
  for (const [key, value] of Object.entries(d)) {
29111
29160
  if (NAME_KEYS.has(key) || HEAVY_KEYS.has(key) || key === main2) continue;
29112
29161
  if (["blocks", "rows", "items", "archived", "approval"].includes(key)) continue;
29113
- if (aba && (key === TAB_ID_FIELD || key === TAB_FIELD && isTabSection(node))) continue;
29162
+ if (aba2 && (key === TAB_ID_FIELD || key === TAB_FIELD && isTabSection(node))) continue;
29114
29163
  const s = scalar(value);
29115
29164
  if (s !== null) facts.push(`${key}=${s}`);
29116
29165
  else if (Array.isArray(value)) facts.push(`${key}=[${value.length}]`);
@@ -29440,9 +29489,9 @@ function registerCanvasCommentTools(server, api, run) {
29440
29489
  },
29441
29490
  annotations: { readOnlyHint: true, openWorldHint: false }
29442
29491
  },
29443
- async ({ board_id, status }) => run(async () => {
29492
+ async ({ board_id: board_id2, status }) => run(async () => {
29444
29493
  const st = status ?? "open";
29445
- const [snap, threads] = await Promise.all([api.snapshot(board_id), api.listComments(board_id, st)]);
29494
+ const [snap, threads] = await Promise.all([api.snapshot(board_id2), api.listComments(board_id2, st)]);
29446
29495
  const text = commentsSummary(threads, snap.doc, st);
29447
29496
  const open3 = threads.some((t) => !t.resolvedAt);
29448
29497
  return open3 ? `${text}
@@ -29458,9 +29507,9 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
29458
29507
  inputSchema: { board_id: boardId, comment_id: commentId, body, mentions },
29459
29508
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
29460
29509
  },
29461
- async ({ board_id, comment_id, body: text, mentions: m }) => run(async () => {
29510
+ async ({ board_id: board_id2, comment_id, body: text, mentions: m }) => run(async () => {
29462
29511
  const thread = await onComment(
29463
- () => api.createComment(board_id, { body: text, parentId: comment_id, ...m?.length ? { mentions: m } : {} })
29512
+ () => api.createComment(board_id2, { body: text, parentId: comment_id, ...m?.length ? { mentions: m } : {} })
29464
29513
  );
29465
29514
  const open3 = thread?.resolvedAt ? "A thread est\xE1 resolvida; reabra com canvas_reopen_comment se precisar." : "A thread segue aberta.";
29466
29515
  return `\u2705 Resposta ${newReplyId(thread)} em ${comment_id}: "${oneLine2(text, 120)}". ${open3}`;
@@ -29478,11 +29527,11 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
29478
29527
  },
29479
29528
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
29480
29529
  },
29481
- async ({ board_id, comment_id, done }) => run(async () => {
29482
- const thread = await onComment(() => api.createComment(board_id, { body: done, parentId: comment_id }));
29530
+ async ({ board_id: board_id2, comment_id, done }) => run(async () => {
29531
+ const thread = await onComment(() => api.createComment(board_id2, { body: done, parentId: comment_id }));
29483
29532
  const replyId = newReplyId(thread);
29484
29533
  try {
29485
- await onComment(() => api.resolveComment(board_id, comment_id));
29534
+ await onComment(() => api.resolveComment(board_id2, comment_id));
29486
29535
  } catch (e) {
29487
29536
  const why = e instanceof Error ? e.message : String(e);
29488
29537
  throw new CanvasToolError(
@@ -29500,9 +29549,9 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
29500
29549
  inputSchema: { board_id: boardId, comment_id: commentId, why: external_exports.string().trim().min(1).max(1e3).optional() },
29501
29550
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
29502
29551
  },
29503
- async ({ board_id, comment_id, why }) => run(async () => {
29504
- await onComment(() => api.reopenComment(board_id, comment_id));
29505
- if (why) await onComment(() => api.createComment(board_id, { body: why, parentId: comment_id }));
29552
+ async ({ board_id: board_id2, comment_id, why }) => run(async () => {
29553
+ await onComment(() => api.reopenComment(board_id2, comment_id));
29554
+ if (why) await onComment(() => api.createComment(board_id2, { body: why, parentId: comment_id }));
29506
29555
  return `\u2705 Reaberto ${comment_id}${why ? ` com a resposta "${oneLine2(why, 120)}"` : ""}.`;
29507
29556
  })
29508
29557
  );
@@ -29604,8 +29653,8 @@ function layoutOps(doc, a) {
29604
29653
  }
29605
29654
  return ops;
29606
29655
  }
29607
- function scopeFor(doc, rows, aba) {
29608
- const tab = aba ? resolveTab(doc, aba) : void 0;
29656
+ function scopeFor(doc, rows, aba2) {
29657
+ const tab = aba2 ? resolveTab(doc, aba2) : void 0;
29609
29658
  if (!hasTabs(doc)) return void 0;
29610
29659
  const arranged = rows.flatMap((r) => [...r.title ? [r.title] : [], ...r.left, ...r.right]);
29611
29660
  const homes = new Set(arranged.map((id) => homeTabOf(doc, id)));
@@ -29948,6 +29997,7 @@ URL: ${u.url}`;
29948
29997
  return {
29949
29998
  ops: [{ type: "node.add", nodeId: created.id, node: created }],
29950
29999
  targets: [],
30000
+ place: { [created.id]: tab === void 0 ? {} : { tab } },
29951
30001
  done: `N\xF3 M\xEDdia "${oneLine2(nodeName(created), 40)}" criado: ${created.id}.${placementNote(doc, created)}`
29952
30002
  };
29953
30003
  });
@@ -29974,6 +30024,7 @@ var statusPacing = {
29974
30024
  now: () => Date.now(),
29975
30025
  sleep: (ms) => new Promise((r) => setTimeout(r, Math.max(0, ms)))
29976
30026
  };
30027
+ var byServer = (a) => a.via === "server";
29977
30028
  var sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
29978
30029
  var seconds = (ms) => `${new Intl.NumberFormat("pt-BR", { maximumFractionDigits: 1 }).format(ms / 1e3)} s`;
29979
30030
  function timingsLine(t) {
@@ -30048,12 +30099,12 @@ function registerCanvasRunTools(server, api, run) {
30048
30099
  const unknownFate = requestId && (e.httpStatus === 0 || e.httpStatus === 408 || reason === "tab-timeout" || reason === "tab-bad-answer" || e.httpStatus >= 500 && e.httpStatus !== 501);
30049
30100
  if (unknownFate) {
30050
30101
  throw new CanvasToolError(
30051
- `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.`
30102
+ `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.`
30052
30103
  );
30053
30104
  }
30054
30105
  if (reason === "no-tab") {
30055
30106
  throw new CanvasToolError(
30056
- "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."
30107
+ "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."
30057
30108
  );
30058
30109
  }
30059
30110
  if (e.httpStatus === 404 && reason !== "unknown-request") {
@@ -30075,7 +30126,7 @@ function registerCanvasRunTools(server, api, run) {
30075
30126
  function answerText(a, requestId, max, titleOf) {
30076
30127
  const est = estimateLines(a.estimate, titleOf);
30077
30128
  const total = a.estimate ? `${dia(a.estimate.total)} (teto ${fmt2(max)})` : "";
30078
- const again = a.repeated ? " (a aba j\xE1 tinha recebido este request_id; esta \xE9 a mesma resposta)" : "";
30129
+ const again = a.repeated ? " (este request_id j\xE1 tinha chegado; esta \xE9 a mesma resposta)" : "";
30079
30130
  if (a.status === "estimate") {
30080
30131
  return [
30081
30132
  `Estimativa, nada rodou${again}. Modo ${modeText(a.mode)}. Total agora: ${total}.`,
@@ -30087,7 +30138,7 @@ function registerCanvasRunTools(server, api, run) {
30087
30138
  if (a.status === "nothing") return `Nada para rodar${again}: ${a.message ?? "o board j\xE1 est\xE1 em dia."}`;
30088
30139
  const willRun = (a.estimate?.nodes ?? []).filter((n) => n.willRun).map((n) => n.nodeId);
30089
30140
  return [
30090
- `Rodando pela sua aba do Canvas${again}. Modo ${modeText(a.mode)}. Estimativa: ${total}.`,
30141
+ `${byServer(a) ? "Rodando no servidor, sem depender de aba aberta" : "Rodando pela sua aba do Canvas"}${again}. Modo ${modeText(a.mode)}. Estimativa: ${total}.`,
30091
30142
  ...est,
30092
30143
  `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.`,
30093
30144
  timingsLine(a.timings)
@@ -30101,7 +30152,7 @@ function registerCanvasRunTools(server, api, run) {
30101
30152
  "canvas_run",
30102
30153
  {
30103
30154
  title: "Canvas: rodar n\xF3s",
30104
- 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.",
30155
+ 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.",
30105
30156
  inputSchema: {
30106
30157
  board_id: boardId2,
30107
30158
  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)."),
@@ -30109,8 +30160,8 @@ function registerCanvasRunTools(server, api, run) {
30109
30160
  all: external_exports.boolean().optional().describe("true: Rodar tudo (s\xF3 o que mudou)."),
30110
30161
  max_diamonds: external_exports.number().finite().min(0).max(1e6).describe("Teto de diamantes desta execu\xE7\xE3o. Obrigat\xF3rio."),
30111
30162
  dry_run: external_exports.boolean().optional().describe("true: s\xF3 estima, nada roda."),
30112
- simulated: external_exports.boolean().optional().describe("true: o pedido \xE9 para o modo Simulado (a aba precisa estar nele)."),
30113
- label: external_exports.string().trim().min(1).max(80).optional().describe('Quem pede, como a aba mostra ("Rodando a pedido de \u2026").'),
30163
+ simulated: external_exports.boolean().optional().describe("true: o pedido \xE9 para o modo Simulado, que roda na aba (ela precisa estar nele)."),
30164
+ label: external_exports.string().trim().min(1).max(80).optional().describe('Quem pede, como o board mostra ("Rodando a pedido de \u2026").'),
30114
30165
  request_id: external_exports.string().uuid().optional().describe("S\xF3 para repetir um pedido cujo destino ficou incerto.")
30115
30166
  },
30116
30167
  annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
@@ -30128,7 +30179,8 @@ function registerCanvasRunTools(server, api, run) {
30128
30179
  dryRun: args.dry_run === true,
30129
30180
  simulated: args.simulated === true,
30130
30181
  label,
30131
- earlyAck: true
30182
+ earlyAck: true,
30183
+ clientId: CLIENT_ID
30132
30184
  });
30133
30185
  } catch (e) {
30134
30186
  explain2(e, requestId);
@@ -30142,13 +30194,13 @@ function registerCanvasRunTools(server, api, run) {
30142
30194
  }
30143
30195
  if (wasAccepted) answer = { ...answer, repeated: false };
30144
30196
  if (answer.ok === true && answer.status === "accepted") {
30145
- 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.`;
30197
+ 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.`;
30146
30198
  }
30147
30199
  const titleOf = lacksTitles(answer.estimate?.nodes) ? await titles(args.board_id) : (id) => id;
30148
30200
  if (answer.ok !== true) {
30149
30201
  const est = estimateLines(answer.estimate, titleOf);
30150
30202
  throw new CanvasToolError(
30151
- [`A aba recusou, nada rodou (${answer.reason ?? "sem motivo"}): ${answer.message ?? ""}`.trim(), ...est].join("\n")
30203
+ [`${byServer(answer) ? "O servidor" : "A aba"} recusou, nada rodou (${answer.reason ?? "sem motivo"}): ${answer.message ?? ""}`.trim(), ...est].join("\n")
30152
30204
  );
30153
30205
  }
30154
30206
  const nodeIds = (answer.estimate?.nodes ?? []).filter((n) => n.willRun).map((n) => n.nodeId);
@@ -30166,7 +30218,7 @@ function registerCanvasRunTools(server, api, run) {
30166
30218
  "canvas_run_status",
30167
30219
  {
30168
30220
  title: "Canvas: andamento da execu\xE7\xE3o",
30169
- 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.",
30221
+ 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.",
30170
30222
  inputSchema: {
30171
30223
  board_id: boardId2,
30172
30224
  request_id: external_exports.string().uuid().describe("O request_id que o canvas_run devolveu."),
@@ -30174,7 +30226,7 @@ function registerCanvasRunTools(server, api, run) {
30174
30226
  },
30175
30227
  annotations: { readOnlyHint: true, openWorldHint: true }
30176
30228
  },
30177
- async ({ board_id, request_id, node_ids }) => run(async () => {
30229
+ async ({ board_id: board_id2, request_id, node_ids }) => run(async () => {
30178
30230
  const requestId = request_id.toLowerCase();
30179
30231
  const since = statusPacing.now() - (lastStatusAt.get(requestId) ?? -Infinity);
30180
30232
  if (since < statusPacing.minIntervalMs) await statusPacing.sleep(statusPacing.minIntervalMs - since);
@@ -30183,8 +30235,8 @@ function registerCanvasRunTools(server, api, run) {
30183
30235
  while (lastStatusAt.size > MAX_REMEMBERED) lastStatusAt.delete(lastStatusAt.keys().next().value);
30184
30236
  let why = "";
30185
30237
  try {
30186
- const status = await api.runStatus(board_id, requestId);
30187
- return statusText(status, lacksTitles(status.nodes) ? await titles(board_id) : (id) => id);
30238
+ const status = await api.runStatus(board_id2, requestId);
30239
+ return statusText(status, lacksTitles(status.nodes) ? await titles(board_id2) : (id) => id);
30188
30240
  } catch (e) {
30189
30241
  const reason = errorRaw(e)?.reason;
30190
30242
  if (!(e instanceof ApiError) || reason !== "unknown-request" && reason !== "no-tab") explain2(e);
@@ -30197,12 +30249,12 @@ function registerCanvasRunTools(server, api, run) {
30197
30249
  }
30198
30250
  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)` : "";
30199
30251
  return `${why} Pelo estado de execu\xE7\xE3o do board${partial2}:
30200
- ${fromRuns(await api.snapshot(board_id, { runs: true }), ids)}`;
30252
+ ${fromRuns(await api.snapshot(board_id2, { runs: true }), ids)}`;
30201
30253
  })
30202
30254
  );
30203
30255
  }
30204
30256
  var STATE_TEXT = {
30205
- preparing: "a aba est\xE1 estimando e conferindo",
30257
+ preparing: "estimando e conferindo",
30206
30258
  running: "rodando",
30207
30259
  done: "terminou",
30208
30260
  failed: "terminou com erro",
@@ -30423,6 +30475,55 @@ function lockViolation(doc, ops) {
30423
30475
  return null;
30424
30476
  }
30425
30477
 
30478
+ // src/tools/canvas-locks.ts
30479
+ var board_id = external_exports.string().uuid();
30480
+ 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).");
30481
+ function registerCanvasLockTools(server, deps) {
30482
+ const { api, run } = deps;
30483
+ const needOwnSession = () => {
30484
+ 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.");
30485
+ };
30486
+ server.registerTool(
30487
+ "canvas_lock_tab",
30488
+ {
30489
+ title: "Canvas: travar aba",
30490
+ 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.",
30491
+ inputSchema: {
30492
+ board_id,
30493
+ aba,
30494
+ label: external_exports.string().trim().min(1).max(120).optional().describe("O que esta sess\xE3o est\xE1 fazendo: aparece para quem for recusado.")
30495
+ },
30496
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
30497
+ },
30498
+ async (args) => run(async () => {
30499
+ needOwnSession();
30500
+ const { doc } = await api.snapshot(args.board_id);
30501
+ const tab = resolveTab(doc, args.aba);
30502
+ const lock = await api.lockTab(args.board_id, tab, CLIENT_ID, args.label);
30503
+ return `\u2705 Aba "${tabTitle(doc.nodes[tab])}" travada para esta sess\xE3o (${lock.sessionId}) at\xE9 ${lock.expiresAt}; cada escrita renova.`;
30504
+ })
30505
+ );
30506
+ server.registerTool(
30507
+ "canvas_unlock_tab",
30508
+ {
30509
+ title: "Canvas: soltar aba",
30510
+ 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.",
30511
+ inputSchema: { board_id, aba },
30512
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
30513
+ },
30514
+ async (args) => run(async () => {
30515
+ needOwnSession();
30516
+ const { doc } = await api.snapshot(args.board_id);
30517
+ const tab = resolveTab(doc, args.aba);
30518
+ const { released } = await api.unlockTab(args.board_id, tab, CLIENT_ID);
30519
+ const name = `"${tabTitle(doc.nodes[tab])}"`;
30520
+ if (released) return `\u2705 Aba ${name} solta.`;
30521
+ const other = (await api.tabLocks(args.board_id)).find((l) => l.tabId === tab);
30522
+ return other ? `Nada mudou: ${describeLock(other)}.` : `A aba ${name} j\xE1 estava livre.`;
30523
+ })
30524
+ );
30525
+ }
30526
+
30426
30527
  // src/canvas/mentions.ts
30427
30528
  var VIA_MENTION = "viaMention";
30428
30529
  var PROMPT_REFS_INPUT = "refs";
@@ -30554,16 +30655,79 @@ function describeMentionSync(sync, name) {
30554
30655
  return parts.length ? ` ${parts.join(". ")}.` : "";
30555
30656
  }
30556
30657
 
30658
+ // src/canvas/text-file.ts
30659
+ import { createHash as createHash2 } from "crypto";
30660
+ import { readFile as readFile3, realpath, stat as stat4 } from "fs/promises";
30661
+ import { extname as extname4 } from "path";
30662
+ var TEXT_FILE_EXTENSIONS = ["txt", "md", "markdown", "csv", "tsv", "srt", "vtt"];
30663
+ var MAX_TEXT_FILE_BYTES = MAX_OP_BYTES - 4 * 1024;
30664
+ var kb = (bytes) => (bytes / 1024).toFixed(1).replace(".", ",");
30665
+ async function readTextFile(ref) {
30666
+ const refuse = (why) => new CanvasToolError(`Arquivo "${ref}": ${why} Nada foi gravado.`);
30667
+ let abs;
30668
+ try {
30669
+ abs = toLocalPath(ref);
30670
+ } catch (e) {
30671
+ if (e instanceof ApiError) {
30672
+ 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.");
30673
+ }
30674
+ throw refuse("o caminho n\xE3o \xE9 v\xE1lido.");
30675
+ }
30676
+ if (isRemoteRef(ref)) throw refuse("aqui vale s\xF3 caminho local, n\xE3o URL.");
30677
+ let real;
30678
+ let size;
30679
+ try {
30680
+ real = await realpath(abs);
30681
+ const info = await stat4(real);
30682
+ if (!info.isFile()) throw refuse("n\xE3o \xE9 um arquivo comum.");
30683
+ size = info.size;
30684
+ } catch (e) {
30685
+ if (e instanceof CanvasToolError) throw e;
30686
+ throw refuse("n\xE3o encontrei ou n\xE3o consegui abrir.");
30687
+ }
30688
+ const ext = extname4(real).slice(1).toLowerCase();
30689
+ if (!TEXT_FILE_EXTENSIONS.includes(ext)) {
30690
+ throw refuse(`${ext ? `a extens\xE3o .${ext}` : "arquivo sem extens\xE3o"} n\xE3o \xE9 aceita. Aceitas: ${TEXT_FILE_EXTENSIONS.join(", ")}.`);
30691
+ }
30692
+ 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.`);
30693
+ if (size > MAX_TEXT_FILE_BYTES) throw tooLarge2(size);
30694
+ let buf;
30695
+ try {
30696
+ buf = await readFile3(real);
30697
+ } catch {
30698
+ throw refuse("n\xE3o consegui ler.");
30699
+ }
30700
+ let text;
30701
+ try {
30702
+ if (buf.includes(0)) throw new Error("nul");
30703
+ text = new TextDecoder("utf-8", { fatal: true }).decode(buf);
30704
+ } catch {
30705
+ throw refuse("parece bin\xE1rio ou n\xE3o est\xE1 em UTF-8. Salve como texto UTF-8.");
30706
+ }
30707
+ if (!text.trim()) throw refuse("est\xE1 vazio.");
30708
+ const json2 = JSON.stringify(text);
30709
+ const wire = Buffer.byteLength(json2);
30710
+ if (wire > MAX_TEXT_FILE_BYTES) throw tooLarge2(wire);
30711
+ return { text, bytes: buf.byteLength, hash: createHash2("sha256").update(json2).digest("hex").slice(0, 12) };
30712
+ }
30713
+ function describeTextFiles(read) {
30714
+ if (!read.length) return "";
30715
+ return ` Lido de arquivo: ${read.map((r) => `${r.path} \u2190 "${r.ref}" (${r.file.bytes} bytes, sha256 ${r.file.hash})`).join("; ")}.`;
30716
+ }
30717
+
30557
30718
  // src/tools/canvas.ts
30558
30719
  var REJECT_TEXT = {
30559
30720
  "node-missing": "o n\xF3 n\xE3o existe mais (algu\xE9m apagou)",
30560
30721
  "edge-endpoint-missing": "uma ponta da liga\xE7\xE3o n\xE3o existe mais",
30561
30722
  "invalid-op": "opera\xE7\xE3o inv\xE1lida ou repetida",
30562
- "too-large": "opera\xE7\xE3o grande demais (64 KB) ou com m\xEDdia embutida"
30723
+ "too-large": "opera\xE7\xE3o grande demais (64 KB) ou com m\xEDdia embutida",
30724
+ "tab-locked": "a aba est\xE1 travada por outra sess\xE3o"
30563
30725
  };
30726
+ var rejectText = (o) => o.lockedBy ? describeLock(o.lockedBy) : REJECT_TEXT[o.rejected] ?? o.rejected;
30564
30727
  var READ = "Exige canvas_read_board nesta sess\xE3o (e de novo depois de uma recusa). ";
30565
30728
  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. ';
30566
30729
  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).";
30730
+ 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. `;
30567
30731
  function dataSegments(path) {
30568
30732
  const p = path?.trim() ?? "";
30569
30733
  if (!p || p === "data") return [];
@@ -30571,6 +30735,32 @@ function dataSegments(path) {
30571
30735
  if (segs.some((seg) => !seg)) throw new CanvasToolError(`Caminho "${p}" tem segmento vazio (dois pontos seguidos ou ponto na ponta).`);
30572
30736
  return segs;
30573
30737
  }
30738
+ async function withDataFiles(raw, files) {
30739
+ const data = structuredClone(raw ?? {});
30740
+ const read = [];
30741
+ for (const [asked, ref] of Object.entries(files ?? {})) {
30742
+ const at = `data_files["${asked}"]`;
30743
+ const segs = dataSegments(asked);
30744
+ if (!segs.length) throw new CanvasToolError(`${at}: informe um caminho dentro do data, n\xE3o o data inteiro.`);
30745
+ const path = segs.join(".");
30746
+ const badPath = checkNodePath(`data.${path}`);
30747
+ if (badPath) throw new CanvasToolError(`${at}: ${badPath}.`);
30748
+ let cur = data;
30749
+ for (const [i, seg] of segs.slice(0, -1).entries()) {
30750
+ const next = Object.hasOwn(cur, seg) ? cur[seg] : cur[seg] = {};
30751
+ if (!next || typeof next !== "object" || Array.isArray(next)) {
30752
+ throw new CanvasToolError(`${at}: data.${segs.slice(0, i + 1).join(".")} n\xE3o \xE9 objeto, e o caminho n\xE3o entra nele.`);
30753
+ }
30754
+ cur = next;
30755
+ }
30756
+ const leaf = segs[segs.length - 1];
30757
+ if (Object.hasOwn(cur, leaf)) throw new CanvasToolError(`${at}: data.${path} j\xE1 veio neste pedido. Mande o valor por um lugar s\xF3.`);
30758
+ const file = await readTextFile(ref);
30759
+ cur[leaf] = file.text;
30760
+ read.push({ path, ref, file });
30761
+ }
30762
+ return { data, note: describeTextFiles(read) };
30763
+ }
30574
30764
  function legacySequenceGuard(node, key) {
30575
30765
  if (key === "sequence" && nodeKind(node) === "montage" && node.data.timeline !== void 0) {
30576
30766
  throw new CanvasToolError(
@@ -30645,7 +30835,7 @@ function registerCanvasTools(server, client, cfg) {
30645
30835
  const snap = await api.snapshot(id, { fresh: true });
30646
30836
  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.");
30647
30837
  const doc = snap.doc;
30648
- const { ops, done, targets } = await build2(doc, snap);
30838
+ const { ops, done, targets, place } = await build2(doc, snap);
30649
30839
  if (!ops.length) return `Nada a mudar. ${done}`;
30650
30840
  if (opts.layoutOnly && !ops.every(isLayoutOp)) throw new Error("layout_only com opera\xE7\xE3o fora de posi\xE7\xE3o/tamanho");
30651
30841
  const locked = lockViolation(doc, ops);
@@ -30674,14 +30864,17 @@ function registerCanvasTools(server, client, cfg) {
30674
30864
  Aviso: ${changesSince(theirs, doc)}.`;
30675
30865
  }
30676
30866
  if (opts.split) return commitSplit(id, ops, done, note, !!opts.layoutOnly);
30677
- const env = envelope(id, batchOf(ops), await api.me());
30867
+ const env = { ...envelope(id, batchOf(ops), await api.me()), ...place && { place } };
30678
30868
  const bad = checkEnvelope(env);
30679
30869
  if (bad) throw new CanvasToolError(`Edi\xE7\xE3o recusada antes de enviar: ${bad}.`);
30680
30870
  const res = await commitOps(id, [env]);
30681
30871
  const outcome = res.outcomes.find((o) => o.opId === env.id);
30872
+ if (outcome && "rejected" in outcome && outcome.rejected === "tab-locked") {
30873
+ 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.`);
30874
+ }
30682
30875
  if (!outcome || "rejected" in outcome) {
30683
30876
  if (!opts.layoutOnly) seen.delete(id);
30684
- const why = outcome && "rejected" in outcome ? REJECT_TEXT[outcome.rejected] ?? outcome.rejected : "sem resposta do servidor";
30877
+ const why = outcome && "rejected" in outcome ? rejectText(outcome) : "sem resposta do servidor";
30685
30878
  throw new CanvasToolError(`O servidor recusou a edi\xE7\xE3o: ${why}. Nada foi aplicado. Releia com canvas_read_board.`);
30686
30879
  }
30687
30880
  if (!opts.layoutOnly) seen.set(id, res.seq);
@@ -30715,10 +30908,10 @@ Aviso: ${changesSince(theirs, doc)}.`;
30715
30908
  const lines = envs.map((env, i) => {
30716
30909
  const paths = pathsOf(env.op);
30717
30910
  const span = paths.length > 1 ? `${paths[0]} \u2026 ${paths[paths.length - 1]}` : paths[0];
30718
- const kb = (Buffer.byteLength(JSON.stringify(env)) / 1024).toFixed(1).replace(".", ",");
30911
+ const kb2 = (Buffer.byteLength(JSON.stringify(env)) / 1024).toFixed(1).replace(".", ",");
30719
30912
  const o = outcomes.get(env.id);
30720
- 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`);
30721
- return `- envelope ${i + 1}/${envs.length}: ${paths.length} caminho(s) (${span}), ${kb} KB \u2192 ${result}`;
30913
+ 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`);
30914
+ return `- envelope ${i + 1}/${envs.length}: ${paths.length} caminho(s) (${span}), ${kb2} KB \u2192 ${result}`;
30722
30915
  });
30723
30916
  if (failed) {
30724
30917
  if (!layoutOnly) seen.delete(id);
@@ -30849,7 +31042,7 @@ ${lines.join("\n")}${note}`;
30849
31042
  "canvas_read_board",
30850
31043
  {
30851
31044
  title: "Canvas: ler board",
30852
- 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.',
31045
+ 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.',
30853
31046
  inputSchema: {
30854
31047
  board_id: boardId3,
30855
31048
  node_ids: external_exports.array(nodeIdArg2).max(20).optional().describe("N\xF3s para ver o data (sem blobs, cortes marcados)."),
@@ -30857,11 +31050,26 @@ ${lines.join("\n")}${note}`;
30857
31050
  },
30858
31051
  annotations: { readOnlyHint: true, openWorldHint: false }
30859
31052
  },
30860
- async ({ board_id, node_ids, aba }) => run(async () => {
30861
- const snap = await api.snapshot(board_id);
30862
- const tab = aba ? resolveTab(snap.doc, aba, { allowAvulsos: true }) : void 0;
30863
- seen.set(board_id, snap.seq);
31053
+ async ({ board_id: board_id2, node_ids, aba: aba2 }) => run(async () => {
31054
+ if (node_ids?.length && !aba2) {
31055
+ const read = await api.readNodes(board_id2, node_ids);
31056
+ if (!seen.has(board_id2)) seen.set(board_id2, read.seq);
31057
+ const found = node_ids.flatMap((n) => read.nodes[n] ? [read.nodes[n]] : []);
31058
+ return [
31059
+ `Board "${read.title}" \xB7 id ${board_id2} \xB7 seq ${read.seq} \xB7 ${node_ids.length} n\xF3(s) pedido(s)`,
31060
+ "",
31061
+ ...found.flatMap((n) => nodeLines(n)),
31062
+ "",
31063
+ "Detalhe:",
31064
+ ...node_ids.map((n) => read.nodes[n] ? nodeDetail(read.nodes[n]) : `${n}: n\xE3o existe`)
31065
+ ].join("\n");
31066
+ }
31067
+ const snap = await api.snapshot(board_id2);
31068
+ const tab = aba2 ? resolveTab(snap.doc, aba2, { allowAvulsos: true }) : void 0;
31069
+ seen.set(board_id2, snap.seq);
30864
31070
  const parts = [boardSummary(snap, { tab })];
31071
+ const locks = await api.tabLocks(board_id2).catch(() => []);
31072
+ if (locks.length) parts.push("", "Travas de sess\xE3o:", ...locks.map((l) => `- ${describeLock(l)}`));
30865
31073
  if (node_ids?.length) {
30866
31074
  parts.push("", "Detalhe:");
30867
31075
  for (const n of node_ids) parts.push(snap.doc.nodes[n] ? nodeDetail(snap.doc.nodes[n]) : `${n}: n\xE3o existe`);
@@ -30883,9 +31091,9 @@ ${lines.join("\n")}${note}`;
30883
31091
  },
30884
31092
  annotations: { readOnlyHint: true, openWorldHint: false }
30885
31093
  },
30886
- async ({ board_id, node_id, path, offset, max_chars }) => run(async () => {
30887
- const snap = await api.snapshot(board_id);
30888
- const node = snap.doc.nodes[node_id];
31094
+ async ({ board_id: board_id2, node_id, path, offset, max_chars }) => run(async () => {
31095
+ const read = await api.readNodes(board_id2, [node_id]);
31096
+ const node = read.nodes[node_id];
30889
31097
  if (!node) throw new CanvasToolError(`N\xF3 ${node_id} n\xE3o existe no board. Releia com canvas_read_board.`);
30890
31098
  let value = visibleData(node.data);
30891
31099
  let segments = dataSegments(path);
@@ -30918,10 +31126,10 @@ ${lines.join("\n")}${note}`;
30918
31126
  const from = Math.min(offset ?? 0, total);
30919
31127
  const size = max_chars ?? 4e4;
30920
31128
  const to = Math.min(from + size, total);
30921
- const hash = createHash2("sha256").update(json2).digest("hex").slice(0, 12);
31129
+ const hash = createHash3("sha256").update(json2).digest("hex").slice(0, 12);
30922
31130
  const where = `data${segments.length ? `.${segments.join(".")}` : ""}`;
30923
31131
  const at = readMeasured(node)?.at;
30924
- 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}`;
31132
+ 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}`;
30925
31133
  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."}`;
30926
31134
  return `${head}
30927
31135
  ${part}
@@ -30982,12 +31190,13 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
30982
31190
  "canvas_add_node",
30983
31191
  {
30984
31192
  title: "Canvas: adicionar n\xF3",
30985
- 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,
31193
+ 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,
30986
31194
  inputSchema: {
30987
31195
  board_id: boardId3,
30988
31196
  kind: external_exports.string().min(1).max(40),
30989
31197
  label: external_exports.string().trim().min(1).max(120).optional().describe("Nome do cart\xE3o (data.label)."),
30990
31198
  data: external_exports.record(external_exports.unknown()).optional().describe("Campos do data. Ex.: narration {blocks:[{id,text}]}, text {text}, prompt {template}."),
31199
+ 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.'),
30991
31200
  aba: abaArg(ABA_ADD_NODE),
30992
31201
  position: point.optional(),
30993
31202
  size: sizeArg.optional(),
@@ -31001,7 +31210,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31001
31210
  const spec = KINDS[args.kind];
31002
31211
  if (!spec) throw new CanvasToolError(`Tipo "${args.kind}" desconhecido. Tipos: ${kindList()}.`);
31003
31212
  const me = await api.me();
31004
- const data = { ...spec.data, ...parseData(args.data), [KIND_FIELD]: args.kind };
31213
+ const input = await withDataFiles(args.data, args.data_files);
31214
+ const data = { ...spec.data, ...parseData(input.data), [KIND_FIELD]: args.kind };
31005
31215
  if (args.label) data.label = args.label;
31006
31216
  if (typeof args.size === "string") data.size = textSizeFor(args.kind, args.size);
31007
31217
  const box = birthBox(args.kind, spec, data, args.size && typeof args.size !== "string" ? boxOf(args.size) : void 0);
@@ -31017,7 +31227,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31017
31227
  if (tab !== void 0) data[TAB_ID_FIELD] = tab;
31018
31228
  const near = args.inputs?.[0] ? doc.nodes[args.inputs[0].from] : args.outputs?.[0] ? doc.nodes[args.outputs[0].to] : void 0;
31019
31229
  const nearTab = near ? homeTabOf(doc, near.id) ?? void 0 : void 0;
31020
- const position = args.position ?? placeFor(doc, box, tab === void 0 ? near : void 0, args.inputs?.[0] ? "right" : "left", tab ?? nearTab);
31230
+ const side = args.inputs?.[0] ? "right" : "left";
31231
+ const position = args.position ?? placeFor(doc, box, tab === void 0 ? near : void 0, side, tab ?? nearTab);
31021
31232
  const zIndex = args.kind === "section" ? SECTION_Z : Object.values(doc.nodes).reduce((t, n) => Math.max(t, n.zIndex), 0) + 1;
31022
31233
  const node = makeNode({ type: WORKFLOW_NODE_TYPE, data, position, size: box, zIndex, createdBy: me });
31023
31234
  const links = [
@@ -31034,11 +31245,12 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31034
31245
  }
31035
31246
  const edges = edgeOps(doc, links, me, /* @__PURE__ */ new Set([node.id]));
31036
31247
  const drawn = edges.ops.flatMap((op) => op.type === "edge.add" ? [op.edge] : []);
31037
- const mention = await mentionOps(doc, [{ node, data: node.data, keys: Object.keys(args.data ?? {}) }], drawn);
31248
+ const mention = await mentionOps(doc, [{ node, data: node.data, keys: Object.keys(input.data) }], drawn);
31038
31249
  return {
31039
31250
  ops: [{ type: "node.add", nodeId: node.id, node }, ...edges.ops, ...mention.ops],
31040
31251
  targets: links.map((l) => l.source === node.id ? l.target : l.source),
31041
- 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}`
31252
+ ...args.position ? {} : { place: { [node.id]: tab !== void 0 ? { tab } : near ? { near: near.id, side } : {} } },
31253
+ 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}`
31042
31254
  };
31043
31255
  })
31044
31256
  )
@@ -31047,7 +31259,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31047
31259
  "canvas_update_node",
31048
31260
  {
31049
31261
  title: "Canvas: editar n\xF3",
31050
- 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,
31262
+ 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,
31051
31263
  inputSchema: {
31052
31264
  board_id: boardId3,
31053
31265
  node_id: nodeIdArg2,
@@ -31127,7 +31339,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31127
31339
  "canvas_patch_node",
31128
31340
  {
31129
31341
  title: "Canvas: gravar por caminho",
31130
- 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,
31342
+ 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,
31131
31343
  inputSchema: {
31132
31344
  board_id: boardId3,
31133
31345
  node_id: nodeIdArg2,
@@ -31135,7 +31347,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31135
31347
  external_exports.object({
31136
31348
  path: external_exports.string().trim().min(1).max(500).describe('Caminho dentro do data (ex.: "timeline.meta.fps"); aceita o prefixo "data.".'),
31137
31349
  value: external_exports.unknown().optional().describe("Valor JSON a gravar (null grava null)."),
31138
- unset: external_exports.literal(true).optional().describe("true apaga a chave.")
31350
+ unset: external_exports.literal(true).optional().describe("true apaga a chave."),
31351
+ 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.')
31139
31352
  })
31140
31353
  ).min(1).max(5e3)
31141
31354
  },
@@ -31152,6 +31365,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31152
31365
  let absent = 0;
31153
31366
  const mentionKeys = /* @__PURE__ */ new Set();
31154
31367
  let mentionAt = -1;
31368
+ const read = [];
31155
31369
  for (const [i, item] of args.sets.entries()) {
31156
31370
  const at = `sets[${i}] (${item.path})`;
31157
31371
  const segs = dataSegments(item.path);
@@ -31164,7 +31378,10 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31164
31378
  if (MENTION_KEYS.includes(segs[0])) mentionKeys.add(segs[0]);
31165
31379
  const unset = item.unset === true;
31166
31380
  const hasValue = item.value !== void 0;
31167
- if (unset === hasValue) throw new CanvasToolError(`${at}: mande value OU unset: true.`);
31381
+ const hasFile = item.file !== void 0;
31382
+ if ([unset, hasValue, hasFile].filter(Boolean).length !== 1) {
31383
+ throw new CanvasToolError(`${at}: mande s\xF3 um de value, unset: true ou file.`);
31384
+ }
31168
31385
  if (hasValue && !isJson(item.value)) throw new CanvasToolError(`${at}: value n\xE3o \xE9 JSON v\xE1lido.`);
31169
31386
  let cur = work;
31170
31387
  for (const [j, seg] of segs.slice(0, -1).entries()) {
@@ -31199,7 +31416,9 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31199
31416
  if (MENTION_KEYS.includes(segs[0])) mentionAt = ops.length;
31200
31417
  continue;
31201
31418
  }
31202
- const value = item.value;
31419
+ const file = item.file === void 0 ? null : await readTextFile(item.file);
31420
+ if (file) read.push({ path: segs.join("."), ref: item.file, file });
31421
+ const value = file ? file.text : item.value;
31203
31422
  if (cur && Object.hasOwn(cur, leaf) && JSON.stringify(cur[leaf]) === JSON.stringify(value)) {
31204
31423
  same++;
31205
31424
  continue;
@@ -31215,7 +31434,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31215
31434
  return {
31216
31435
  ops,
31217
31436
  targets: [node.id],
31218
- done: `N\xF3 "${oneLine2(nodeName(node), 40)}" (${node.id}): ${written} caminho(s) gravado(s)` + (skipped ? ` (ignorados: ${skipped})` : "") + mention.note
31437
+ done: `N\xF3 "${oneLine2(nodeName(node), 40)}" (${node.id}): ${written} caminho(s) gravado(s)` + (skipped ? ` (ignorados: ${skipped})` : "") + mention.note + describeTextFiles(read)
31219
31438
  };
31220
31439
  },
31221
31440
  { split: true }
@@ -31302,8 +31521,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31302
31521
  inputSchema: { board_id: boardId3, title: external_exports.string().trim().min(1).max(200) },
31303
31522
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
31304
31523
  },
31305
- async ({ board_id, title }) => run(
31306
- () => edit(board_id, async (doc) => ({
31524
+ async ({ board_id: board_id2, title }) => run(
31525
+ () => edit(board_id2, async (doc) => ({
31307
31526
  ops: doc.title === title ? [] : [{ type: "board.set", field: "title", value: setValue(title) }],
31308
31527
  targets: [],
31309
31528
  done: `Board renomeado: "${doc.title}" \u2192 "${title}"`
@@ -31318,8 +31537,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31318
31537
  inputSchema: { board_id: boardId3 },
31319
31538
  annotations: { readOnlyHint: true, openWorldHint: false }
31320
31539
  },
31321
- async ({ board_id }) => run(async () => {
31322
- const members = await api.members(board_id);
31540
+ async ({ board_id: board_id2 }) => run(async () => {
31541
+ const members = await api.members(board_id2);
31323
31542
  return members.map((m) => {
31324
31543
  const name = [m.firstName, m.lastName].filter(Boolean).join(" ") || m.nickname || "(sem nome)";
31325
31544
  return `- ${m.userId} \xB7 ${name} \xB7 ${m.role}`;
@@ -31338,8 +31557,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31338
31557
  },
31339
31558
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
31340
31559
  },
31341
- async ({ board_id, user_id, role }) => run(async () => {
31342
- const r = await api.putMember(board_id, user_id, role);
31560
+ async ({ board_id: board_id2, user_id, role }) => run(async () => {
31561
+ const r = await api.putMember(board_id2, user_id, role);
31343
31562
  return `\u2705 ${r.userId} agora \xE9 ${r.role} no board.`;
31344
31563
  })
31345
31564
  );
@@ -31351,13 +31570,14 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31351
31570
  inputSchema: { board_id: boardId3, user_id: external_exports.string().uuid() },
31352
31571
  annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
31353
31572
  },
31354
- async ({ board_id, user_id }) => run(async () => {
31355
- await api.removeMember(board_id, user_id);
31573
+ async ({ board_id: board_id2, user_id }) => run(async () => {
31574
+ await api.removeMember(board_id2, user_id);
31356
31575
  return `\u2705 ${user_id} n\xE3o tem mais acesso ao board.`;
31357
31576
  })
31358
31577
  );
31359
31578
  registerCanvasCommentTools(server, api, run);
31360
31579
  registerCanvasMediaTools(server, { api, cfg, run, edit, seen, placeFor });
31580
+ registerCanvasLockTools(server, { api, run });
31361
31581
  registerCanvasLayoutTools(server, { api, run, edit });
31362
31582
  registerCanvasRunTools(server, api, run);
31363
31583
  registerCanvasFocusTools(server, api, run);
@@ -31367,7 +31587,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31367
31587
  import { createRequire } from "module";
31368
31588
  var require2 = createRequire(import.meta.url);
31369
31589
  function readVersion() {
31370
- if ("0.47.0") return "0.47.0";
31590
+ if ("0.49.0") return "0.49.0";
31371
31591
  try {
31372
31592
  const pkg = require2("../package.json");
31373
31593
  return pkg.version ?? "0.0.0-unknown";
@@ -31382,7 +31602,7 @@ var SERVER_INSTRUCTIONS = [
31382
31602
  "BePlus: tudo roda pela conta do usu\xE1rio (diamantes, limites e hist\xF3rico na plataforma).",
31383
31603
  '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.',
31384
31604
  "Calls: search_calls acha, get_call traz a transcri\xE7\xE3o.",
31385
- "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.",
31605
+ "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.",
31386
31606
  "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.",
31387
31607
  '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.',
31388
31608
  '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.',