beplus-mcp 0.46.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
@@ -24401,7 +24401,12 @@ var BeplusClient = class {
24401
24401
  offset: query.offset,
24402
24402
  // Only send when true — the backend treats truthy as "constrain".
24403
24403
  favorite: query.favorite ? "true" : void 0,
24404
- approved: query.approved ? "true" : void 0
24404
+ approved: query.approved ? "true" : void 0,
24405
+ project: query.project,
24406
+ user: query.user,
24407
+ scope: query.scope,
24408
+ type: query.type,
24409
+ cursor: query.cursor
24405
24410
  }
24406
24411
  });
24407
24412
  }
@@ -26425,34 +26430,44 @@ ${list}${flagsLine(status)}${draftHint}` }, ...blocks] };
26425
26430
  "list_generations",
26426
26431
  {
26427
26432
  title: "Listar gera\xE7\xF5es",
26428
- description: 'Lista as suas gera\xE7\xF5es (imagens/v\xEDdeos) mais recentes, com os flags de favorito ("like") e de plano aprovado. Use os filtros favorite=true / approved=true para ver s\xF3 as favoritadas ou s\xF3 as aprovadas. Retorna id, modelo, tipo, status, data, um trecho do prompt e (quando h\xE1) a URL.',
26433
+ description: 'Lista gera\xE7\xF5es. Sem filtro, traz as suas, com os flags de favorito ("like") e de plano aprovado (filtros favorite=true / approved=true, que valem s\xF3 para as suas). Com project, traz o projeto inteiro, de toda a equipe, e user filtra uma pessoa dentro dele. scope="team" traz as gera\xE7\xF5es conclu\xEDdas da equipe toda, e user sem project traz uma pessoa da equipe: os dois s\xE3o s\xF3 para admin. Retorna id, modelo, tipo, status, data, autor, um trecho do prompt e (quando h\xE1) a URL. Fora das suas, pagine com o cursor devolvido no fim da resposta.',
26429
26434
  inputSchema: {
26430
26435
  limit: external_exports.number().int().min(1).max(100).optional().describe("Quantas trazer (padr\xE3o 20, m\xE1x 100)."),
26431
26436
  offset: external_exports.number().int().min(0).optional().describe("Deslocamento para paginar (padr\xE3o 0)."),
26432
26437
  favorite: external_exports.boolean().optional().describe('S\xF3 as favoritadas ("like"). Padr\xE3o: todas.'),
26433
- approved: external_exports.boolean().optional().describe("S\xF3 as com plano aprovado. Padr\xE3o: todas.")
26438
+ approved: external_exports.boolean().optional().describe("S\xF3 as com plano aprovado. Padr\xE3o: todas."),
26439
+ project: external_exports.string().optional().describe('C\xF3digo ou id do projeto (ex.: "EP2-26"). Lista o projeto inteiro.'),
26440
+ user: external_exports.string().optional().describe("E-mail ou id da pessoa. Sem project, s\xF3 admin."),
26441
+ scope: external_exports.enum(["team"]).optional().describe('"team": toda a equipe, com ou sem projeto. S\xF3 admin.'),
26442
+ type: external_exports.enum(["image", "video", "audio", "music", "upscale"]).optional().describe("Filtra por tipo, junto de project, user ou scope."),
26443
+ cursor: external_exports.string().optional().describe("Pr\xF3xima p\xE1gina, devolvido na resposta anterior.")
26434
26444
  }
26435
26445
  },
26436
- async ({ limit, offset, favorite, approved }) => {
26446
+ async ({ limit, offset, favorite, approved, project, user, scope, type, cursor }) => {
26437
26447
  try {
26438
- const { generations } = await client.listGenerations({ limit, offset, favorite, approved });
26448
+ const { generations, nextCursor } = await client.listGenerations({ limit, offset, favorite, approved, project, user, scope, type, cursor });
26439
26449
  if (!generations.length) {
26440
- const scope = favorite && approved ? " (favoritadas + aprovadas)" : favorite ? " favoritadas" : approved ? " aprovadas" : "";
26441
- return textResult(`Nenhuma gera\xE7\xE3o${scope} encontrada.`);
26450
+ const filterLabel = favorite && approved ? " (favoritadas + aprovadas)" : favorite ? " favoritadas" : approved ? " aprovadas" : "";
26451
+ return textResult(`Nenhuma gera\xE7\xE3o${filterLabel} encontrada.`);
26442
26452
  }
26443
26453
  const lines = generations.map((g, i) => {
26444
- const type = g.model?.startsWith("topaz/upscale") ? "upscale" : g.generation_type || "image";
26454
+ const kind = g.model?.startsWith("topaz/upscale") ? "upscale" : g.generation_type || "image";
26445
26455
  const when = g.created_at ? new Date(g.created_at).toISOString().slice(0, 10) : "\u2014";
26446
26456
  const prompt = (g.prompt || "").replace(/\s+/g, " ").slice(0, 80);
26447
26457
  const url = firstOutputUrl(g.output);
26448
26458
  const marks = [g.is_favorite ? "\u2B50" : null, g.is_approved_plan ? "\u2714\uFE0F" : null].filter(Boolean).join(" ");
26449
26459
  const marksSuffix = marks ? ` ${marks}` : "";
26450
- return `${i + 1}. ${type} \xB7 ${g.status} \xB7 ${when} \xB7 ${g.model}${marksSuffix}
26460
+ const authorName = [g.author?.first_name, g.author?.last_name].filter(Boolean).join(" ");
26461
+ const authorSuffix = authorName ? ` \xB7 ${authorName}` : "";
26462
+ return `${i + 1}. ${kind} \xB7 ${g.status} \xB7 ${when} \xB7 ${g.model}${authorSuffix}${marksSuffix}
26451
26463
  ${g.id}
26452
26464
  "${prompt}"${url ? `
26453
26465
  ${url}` : ""}`;
26454
26466
  });
26455
- return textResult(lines.join("\n\n"));
26467
+ const more = nextCursor ? `
26468
+
26469
+ Pr\xF3xima p\xE1gina: cursor "${nextCursor}"` : "";
26470
+ return textResult(lines.join("\n\n") + more);
26456
26471
  } catch (e) {
26457
26472
  return errorResult(apiErrorToUserMessage(e));
26458
26473
  }
@@ -27847,11 +27862,21 @@ ${calls.map(callLine).join("\n\n")}`);
27847
27862
  }
27848
27863
 
27849
27864
  // src/tools/canvas.ts
27850
- import { createHash as createHash2 } from "crypto";
27865
+ import { createHash as createHash3 } from "crypto";
27851
27866
 
27852
27867
  // src/canvas/api.ts
27853
27868
  import { createHash } from "crypto";
27854
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
27855
27880
  var PINNED_CORE_VERSION = "ca7b3b406184c7f679f555c3a008013197182b23";
27856
27881
  var RUN_REQUEST_TIMEOUT_MS = 4e4;
27857
27882
  var FOCUS_REQUEST_TIMEOUT_MS = 12e3;
@@ -27962,6 +27987,27 @@ var CanvasApi = class {
27962
27987
  boardLoads.set(loadKey, load);
27963
27988
  return load;
27964
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
+ }
27965
28011
  async load(boardId4, key, needRuns) {
27966
28012
  const entry = boardStore.get(key);
27967
28013
  if (entry && !needRuns && this.coreVersion === PINNED_CORE_VERSION) {
@@ -28059,8 +28105,26 @@ var CanvasApi = class {
28059
28105
  }
28060
28106
  throw again;
28061
28107
  }
28108
+ } finally {
28109
+ const entry = boardStore.get(this.cacheKey(boardId4));
28110
+ if (entry) entry.checkedAt = -Infinity;
28062
28111
  }
28063
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)}.`);
28123
+ }
28124
+ }
28125
+ unlockTab(boardId4, tabId, session) {
28126
+ return this.req("DELETE", `/boards/${boardId4}/tabs/${encodeURIComponent(tabId)}/lock`, { query: { session } });
28127
+ }
28064
28128
  members(boardId4) {
28065
28129
  return this.req("GET", `/boards/${boardId4}/members`);
28066
28130
  }
@@ -29062,15 +29126,15 @@ function rowsLines(rows) {
29062
29126
  if (rows.length > MAX_BLOCKS) out.push(` \xB7 \u2026 +${rows.length - MAX_BLOCKS} linhas`);
29063
29127
  return out;
29064
29128
  }
29065
- function nodeLines(node, run, aba) {
29129
+ function nodeLines(node, run, aba2) {
29066
29130
  const kind = nodeKind(node);
29067
29131
  const spec = kind ? KINDS[kind] : void 0;
29068
- 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}` : "");
29069
29133
  const facts = [];
29070
29134
  const extra = [];
29071
29135
  const d = node.data;
29072
29136
  if (d.archived) facts.push("ARQUIVADO");
29073
- if (aba && isTabSection(node)) facts.push("\xE9 aba");
29137
+ if (aba2 && isTabSection(node)) facts.push("\xE9 aba");
29074
29138
  const approval = d.approval?.state;
29075
29139
  if (typeof approval === "string") facts.push(`aprova\xE7\xE3o: ${approval}`);
29076
29140
  if (Array.isArray(d.history)) facts.push(`${d.history.length} gera\xE7\xE3o(\xF5es)`);
@@ -29095,7 +29159,7 @@ function nodeLines(node, run, aba) {
29095
29159
  for (const [key, value] of Object.entries(d)) {
29096
29160
  if (NAME_KEYS.has(key) || HEAVY_KEYS.has(key) || key === main2) continue;
29097
29161
  if (["blocks", "rows", "items", "archived", "approval"].includes(key)) continue;
29098
- 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;
29099
29163
  const s = scalar(value);
29100
29164
  if (s !== null) facts.push(`${key}=${s}`);
29101
29165
  else if (Array.isArray(value)) facts.push(`${key}=[${value.length}]`);
@@ -29425,9 +29489,9 @@ function registerCanvasCommentTools(server, api, run) {
29425
29489
  },
29426
29490
  annotations: { readOnlyHint: true, openWorldHint: false }
29427
29491
  },
29428
- async ({ board_id, status }) => run(async () => {
29492
+ async ({ board_id: board_id2, status }) => run(async () => {
29429
29493
  const st = status ?? "open";
29430
- 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)]);
29431
29495
  const text = commentsSummary(threads, snap.doc, st);
29432
29496
  const open3 = threads.some((t) => !t.resolvedAt);
29433
29497
  return open3 ? `${text}
@@ -29443,9 +29507,9 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
29443
29507
  inputSchema: { board_id: boardId, comment_id: commentId, body, mentions },
29444
29508
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
29445
29509
  },
29446
- 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 () => {
29447
29511
  const thread = await onComment(
29448
- () => 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 } : {} })
29449
29513
  );
29450
29514
  const open3 = thread?.resolvedAt ? "A thread est\xE1 resolvida; reabra com canvas_reopen_comment se precisar." : "A thread segue aberta.";
29451
29515
  return `\u2705 Resposta ${newReplyId(thread)} em ${comment_id}: "${oneLine2(text, 120)}". ${open3}`;
@@ -29463,11 +29527,11 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
29463
29527
  },
29464
29528
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
29465
29529
  },
29466
- async ({ board_id, comment_id, done }) => run(async () => {
29467
- 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 }));
29468
29532
  const replyId = newReplyId(thread);
29469
29533
  try {
29470
- await onComment(() => api.resolveComment(board_id, comment_id));
29534
+ await onComment(() => api.resolveComment(board_id2, comment_id));
29471
29535
  } catch (e) {
29472
29536
  const why = e instanceof Error ? e.message : String(e);
29473
29537
  throw new CanvasToolError(
@@ -29485,9 +29549,9 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
29485
29549
  inputSchema: { board_id: boardId, comment_id: commentId, why: external_exports.string().trim().min(1).max(1e3).optional() },
29486
29550
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
29487
29551
  },
29488
- async ({ board_id, comment_id, why }) => run(async () => {
29489
- await onComment(() => api.reopenComment(board_id, comment_id));
29490
- 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 }));
29491
29555
  return `\u2705 Reaberto ${comment_id}${why ? ` com a resposta "${oneLine2(why, 120)}"` : ""}.`;
29492
29556
  })
29493
29557
  );
@@ -29589,8 +29653,8 @@ function layoutOps(doc, a) {
29589
29653
  }
29590
29654
  return ops;
29591
29655
  }
29592
- function scopeFor(doc, rows, aba) {
29593
- const tab = aba ? resolveTab(doc, aba) : void 0;
29656
+ function scopeFor(doc, rows, aba2) {
29657
+ const tab = aba2 ? resolveTab(doc, aba2) : void 0;
29594
29658
  if (!hasTabs(doc)) return void 0;
29595
29659
  const arranged = rows.flatMap((r) => [...r.title ? [r.title] : [], ...r.left, ...r.right]);
29596
29660
  const homes = new Set(arranged.map((id) => homeTabOf(doc, id)));
@@ -29933,6 +29997,7 @@ URL: ${u.url}`;
29933
29997
  return {
29934
29998
  ops: [{ type: "node.add", nodeId: created.id, node: created }],
29935
29999
  targets: [],
30000
+ place: { [created.id]: tab === void 0 ? {} : { tab } },
29936
30001
  done: `N\xF3 M\xEDdia "${oneLine2(nodeName(created), 40)}" criado: ${created.id}.${placementNote(doc, created)}`
29937
30002
  };
29938
30003
  });
@@ -29959,6 +30024,7 @@ var statusPacing = {
29959
30024
  now: () => Date.now(),
29960
30025
  sleep: (ms) => new Promise((r) => setTimeout(r, Math.max(0, ms)))
29961
30026
  };
30027
+ var byServer = (a) => a.via === "server";
29962
30028
  var sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
29963
30029
  var seconds = (ms) => `${new Intl.NumberFormat("pt-BR", { maximumFractionDigits: 1 }).format(ms / 1e3)} s`;
29964
30030
  function timingsLine(t) {
@@ -30033,12 +30099,12 @@ function registerCanvasRunTools(server, api, run) {
30033
30099
  const unknownFate = requestId && (e.httpStatus === 0 || e.httpStatus === 408 || reason === "tab-timeout" || reason === "tab-bad-answer" || e.httpStatus >= 500 && e.httpStatus !== 501);
30034
30100
  if (unknownFate) {
30035
30101
  throw new CanvasToolError(
30036
- `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.`
30037
30103
  );
30038
30104
  }
30039
30105
  if (reason === "no-tab") {
30040
30106
  throw new CanvasToolError(
30041
- "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."
30042
30108
  );
30043
30109
  }
30044
30110
  if (e.httpStatus === 404 && reason !== "unknown-request") {
@@ -30060,7 +30126,7 @@ function registerCanvasRunTools(server, api, run) {
30060
30126
  function answerText(a, requestId, max, titleOf) {
30061
30127
  const est = estimateLines(a.estimate, titleOf);
30062
30128
  const total = a.estimate ? `${dia(a.estimate.total)} (teto ${fmt2(max)})` : "";
30063
- 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)" : "";
30064
30130
  if (a.status === "estimate") {
30065
30131
  return [
30066
30132
  `Estimativa, nada rodou${again}. Modo ${modeText(a.mode)}. Total agora: ${total}.`,
@@ -30072,7 +30138,7 @@ function registerCanvasRunTools(server, api, run) {
30072
30138
  if (a.status === "nothing") return `Nada para rodar${again}: ${a.message ?? "o board j\xE1 est\xE1 em dia."}`;
30073
30139
  const willRun = (a.estimate?.nodes ?? []).filter((n) => n.willRun).map((n) => n.nodeId);
30074
30140
  return [
30075
- `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}.`,
30076
30142
  ...est,
30077
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.`,
30078
30144
  timingsLine(a.timings)
@@ -30086,7 +30152,7 @@ function registerCanvasRunTools(server, api, run) {
30086
30152
  "canvas_run",
30087
30153
  {
30088
30154
  title: "Canvas: rodar n\xF3s",
30089
- 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.",
30090
30156
  inputSchema: {
30091
30157
  board_id: boardId2,
30092
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)."),
@@ -30094,8 +30160,8 @@ function registerCanvasRunTools(server, api, run) {
30094
30160
  all: external_exports.boolean().optional().describe("true: Rodar tudo (s\xF3 o que mudou)."),
30095
30161
  max_diamonds: external_exports.number().finite().min(0).max(1e6).describe("Teto de diamantes desta execu\xE7\xE3o. Obrigat\xF3rio."),
30096
30162
  dry_run: external_exports.boolean().optional().describe("true: s\xF3 estima, nada roda."),
30097
- simulated: external_exports.boolean().optional().describe("true: o pedido \xE9 para o modo Simulado (a aba precisa estar nele)."),
30098
- 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").'),
30099
30165
  request_id: external_exports.string().uuid().optional().describe("S\xF3 para repetir um pedido cujo destino ficou incerto.")
30100
30166
  },
30101
30167
  annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
@@ -30113,7 +30179,8 @@ function registerCanvasRunTools(server, api, run) {
30113
30179
  dryRun: args.dry_run === true,
30114
30180
  simulated: args.simulated === true,
30115
30181
  label,
30116
- earlyAck: true
30182
+ earlyAck: true,
30183
+ clientId: CLIENT_ID
30117
30184
  });
30118
30185
  } catch (e) {
30119
30186
  explain2(e, requestId);
@@ -30127,13 +30194,13 @@ function registerCanvasRunTools(server, api, run) {
30127
30194
  }
30128
30195
  if (wasAccepted) answer = { ...answer, repeated: false };
30129
30196
  if (answer.ok === true && answer.status === "accepted") {
30130
- 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.`;
30131
30198
  }
30132
30199
  const titleOf = lacksTitles(answer.estimate?.nodes) ? await titles(args.board_id) : (id) => id;
30133
30200
  if (answer.ok !== true) {
30134
30201
  const est = estimateLines(answer.estimate, titleOf);
30135
30202
  throw new CanvasToolError(
30136
- [`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")
30137
30204
  );
30138
30205
  }
30139
30206
  const nodeIds = (answer.estimate?.nodes ?? []).filter((n) => n.willRun).map((n) => n.nodeId);
@@ -30151,7 +30218,7 @@ function registerCanvasRunTools(server, api, run) {
30151
30218
  "canvas_run_status",
30152
30219
  {
30153
30220
  title: "Canvas: andamento da execu\xE7\xE3o",
30154
- 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.",
30155
30222
  inputSchema: {
30156
30223
  board_id: boardId2,
30157
30224
  request_id: external_exports.string().uuid().describe("O request_id que o canvas_run devolveu."),
@@ -30159,7 +30226,7 @@ function registerCanvasRunTools(server, api, run) {
30159
30226
  },
30160
30227
  annotations: { readOnlyHint: true, openWorldHint: true }
30161
30228
  },
30162
- async ({ board_id, request_id, node_ids }) => run(async () => {
30229
+ async ({ board_id: board_id2, request_id, node_ids }) => run(async () => {
30163
30230
  const requestId = request_id.toLowerCase();
30164
30231
  const since = statusPacing.now() - (lastStatusAt.get(requestId) ?? -Infinity);
30165
30232
  if (since < statusPacing.minIntervalMs) await statusPacing.sleep(statusPacing.minIntervalMs - since);
@@ -30168,8 +30235,8 @@ function registerCanvasRunTools(server, api, run) {
30168
30235
  while (lastStatusAt.size > MAX_REMEMBERED) lastStatusAt.delete(lastStatusAt.keys().next().value);
30169
30236
  let why = "";
30170
30237
  try {
30171
- const status = await api.runStatus(board_id, requestId);
30172
- 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);
30173
30240
  } catch (e) {
30174
30241
  const reason = errorRaw(e)?.reason;
30175
30242
  if (!(e instanceof ApiError) || reason !== "unknown-request" && reason !== "no-tab") explain2(e);
@@ -30182,12 +30249,12 @@ function registerCanvasRunTools(server, api, run) {
30182
30249
  }
30183
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)` : "";
30184
30251
  return `${why} Pelo estado de execu\xE7\xE3o do board${partial2}:
30185
- ${fromRuns(await api.snapshot(board_id, { runs: true }), ids)}`;
30252
+ ${fromRuns(await api.snapshot(board_id2, { runs: true }), ids)}`;
30186
30253
  })
30187
30254
  );
30188
30255
  }
30189
30256
  var STATE_TEXT = {
30190
- preparing: "a aba est\xE1 estimando e conferindo",
30257
+ preparing: "estimando e conferindo",
30191
30258
  running: "rodando",
30192
30259
  done: "terminou",
30193
30260
  failed: "terminou com erro",
@@ -30408,6 +30475,55 @@ function lockViolation(doc, ops) {
30408
30475
  return null;
30409
30476
  }
30410
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
+
30411
30527
  // src/canvas/mentions.ts
30412
30528
  var VIA_MENTION = "viaMention";
30413
30529
  var PROMPT_REFS_INPUT = "refs";
@@ -30539,16 +30655,79 @@ function describeMentionSync(sync, name) {
30539
30655
  return parts.length ? ` ${parts.join(". ")}.` : "";
30540
30656
  }
30541
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
+
30542
30718
  // src/tools/canvas.ts
30543
30719
  var REJECT_TEXT = {
30544
30720
  "node-missing": "o n\xF3 n\xE3o existe mais (algu\xE9m apagou)",
30545
30721
  "edge-endpoint-missing": "uma ponta da liga\xE7\xE3o n\xE3o existe mais",
30546
30722
  "invalid-op": "opera\xE7\xE3o inv\xE1lida ou repetida",
30547
- "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"
30548
30725
  };
30726
+ var rejectText = (o) => o.lockedBy ? describeLock(o.lockedBy) : REJECT_TEXT[o.rejected] ?? o.rejected;
30549
30727
  var READ = "Exige canvas_read_board nesta sess\xE3o (e de novo depois de uma recusa). ";
30550
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. ';
30551
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. `;
30552
30731
  function dataSegments(path) {
30553
30732
  const p = path?.trim() ?? "";
30554
30733
  if (!p || p === "data") return [];
@@ -30556,6 +30735,32 @@ function dataSegments(path) {
30556
30735
  if (segs.some((seg) => !seg)) throw new CanvasToolError(`Caminho "${p}" tem segmento vazio (dois pontos seguidos ou ponto na ponta).`);
30557
30736
  return segs;
30558
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
+ }
30559
30764
  function legacySequenceGuard(node, key) {
30560
30765
  if (key === "sequence" && nodeKind(node) === "montage" && node.data.timeline !== void 0) {
30561
30766
  throw new CanvasToolError(
@@ -30630,7 +30835,7 @@ function registerCanvasTools(server, client, cfg) {
30630
30835
  const snap = await api.snapshot(id, { fresh: true });
30631
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.");
30632
30837
  const doc = snap.doc;
30633
- const { ops, done, targets } = await build2(doc, snap);
30838
+ const { ops, done, targets, place } = await build2(doc, snap);
30634
30839
  if (!ops.length) return `Nada a mudar. ${done}`;
30635
30840
  if (opts.layoutOnly && !ops.every(isLayoutOp)) throw new Error("layout_only com opera\xE7\xE3o fora de posi\xE7\xE3o/tamanho");
30636
30841
  const locked = lockViolation(doc, ops);
@@ -30659,14 +30864,17 @@ function registerCanvasTools(server, client, cfg) {
30659
30864
  Aviso: ${changesSince(theirs, doc)}.`;
30660
30865
  }
30661
30866
  if (opts.split) return commitSplit(id, ops, done, note, !!opts.layoutOnly);
30662
- const env = envelope(id, batchOf(ops), await api.me());
30867
+ const env = { ...envelope(id, batchOf(ops), await api.me()), ...place && { place } };
30663
30868
  const bad = checkEnvelope(env);
30664
30869
  if (bad) throw new CanvasToolError(`Edi\xE7\xE3o recusada antes de enviar: ${bad}.`);
30665
30870
  const res = await commitOps(id, [env]);
30666
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
+ }
30667
30875
  if (!outcome || "rejected" in outcome) {
30668
30876
  if (!opts.layoutOnly) seen.delete(id);
30669
- 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";
30670
30878
  throw new CanvasToolError(`O servidor recusou a edi\xE7\xE3o: ${why}. Nada foi aplicado. Releia com canvas_read_board.`);
30671
30879
  }
30672
30880
  if (!opts.layoutOnly) seen.set(id, res.seq);
@@ -30700,10 +30908,10 @@ Aviso: ${changesSince(theirs, doc)}.`;
30700
30908
  const lines = envs.map((env, i) => {
30701
30909
  const paths = pathsOf(env.op);
30702
30910
  const span = paths.length > 1 ? `${paths[0]} \u2026 ${paths[paths.length - 1]}` : paths[0];
30703
- const kb = (Buffer.byteLength(JSON.stringify(env)) / 1024).toFixed(1).replace(".", ",");
30911
+ const kb2 = (Buffer.byteLength(JSON.stringify(env)) / 1024).toFixed(1).replace(".", ",");
30704
30912
  const o = outcomes.get(env.id);
30705
- 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`);
30706
- 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}`;
30707
30915
  });
30708
30916
  if (failed) {
30709
30917
  if (!layoutOnly) seen.delete(id);
@@ -30834,7 +31042,7 @@ ${lines.join("\n")}${note}`;
30834
31042
  "canvas_read_board",
30835
31043
  {
30836
31044
  title: "Canvas: ler board",
30837
- 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.',
30838
31046
  inputSchema: {
30839
31047
  board_id: boardId3,
30840
31048
  node_ids: external_exports.array(nodeIdArg2).max(20).optional().describe("N\xF3s para ver o data (sem blobs, cortes marcados)."),
@@ -30842,11 +31050,26 @@ ${lines.join("\n")}${note}`;
30842
31050
  },
30843
31051
  annotations: { readOnlyHint: true, openWorldHint: false }
30844
31052
  },
30845
- async ({ board_id, node_ids, aba }) => run(async () => {
30846
- const snap = await api.snapshot(board_id);
30847
- const tab = aba ? resolveTab(snap.doc, aba, { allowAvulsos: true }) : void 0;
30848
- 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);
30849
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)}`));
30850
31073
  if (node_ids?.length) {
30851
31074
  parts.push("", "Detalhe:");
30852
31075
  for (const n of node_ids) parts.push(snap.doc.nodes[n] ? nodeDetail(snap.doc.nodes[n]) : `${n}: n\xE3o existe`);
@@ -30868,9 +31091,9 @@ ${lines.join("\n")}${note}`;
30868
31091
  },
30869
31092
  annotations: { readOnlyHint: true, openWorldHint: false }
30870
31093
  },
30871
- async ({ board_id, node_id, path, offset, max_chars }) => run(async () => {
30872
- const snap = await api.snapshot(board_id);
30873
- 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];
30874
31097
  if (!node) throw new CanvasToolError(`N\xF3 ${node_id} n\xE3o existe no board. Releia com canvas_read_board.`);
30875
31098
  let value = visibleData(node.data);
30876
31099
  let segments = dataSegments(path);
@@ -30903,10 +31126,10 @@ ${lines.join("\n")}${note}`;
30903
31126
  const from = Math.min(offset ?? 0, total);
30904
31127
  const size = max_chars ?? 4e4;
30905
31128
  const to = Math.min(from + size, total);
30906
- const hash = createHash2("sha256").update(json2).digest("hex").slice(0, 12);
31129
+ const hash = createHash3("sha256").update(json2).digest("hex").slice(0, 12);
30907
31130
  const where = `data${segments.length ? `.${segments.join(".")}` : ""}`;
30908
31131
  const at = readMeasured(node)?.at;
30909
- 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}`;
30910
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."}`;
30911
31134
  return `${head}
30912
31135
  ${part}
@@ -30967,12 +31190,13 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
30967
31190
  "canvas_add_node",
30968
31191
  {
30969
31192
  title: "Canvas: adicionar n\xF3",
30970
- 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,
30971
31194
  inputSchema: {
30972
31195
  board_id: boardId3,
30973
31196
  kind: external_exports.string().min(1).max(40),
30974
31197
  label: external_exports.string().trim().min(1).max(120).optional().describe("Nome do cart\xE3o (data.label)."),
30975
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.'),
30976
31200
  aba: abaArg(ABA_ADD_NODE),
30977
31201
  position: point.optional(),
30978
31202
  size: sizeArg.optional(),
@@ -30986,7 +31210,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
30986
31210
  const spec = KINDS[args.kind];
30987
31211
  if (!spec) throw new CanvasToolError(`Tipo "${args.kind}" desconhecido. Tipos: ${kindList()}.`);
30988
31212
  const me = await api.me();
30989
- 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 };
30990
31215
  if (args.label) data.label = args.label;
30991
31216
  if (typeof args.size === "string") data.size = textSizeFor(args.kind, args.size);
30992
31217
  const box = birthBox(args.kind, spec, data, args.size && typeof args.size !== "string" ? boxOf(args.size) : void 0);
@@ -31002,7 +31227,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31002
31227
  if (tab !== void 0) data[TAB_ID_FIELD] = tab;
31003
31228
  const near = args.inputs?.[0] ? doc.nodes[args.inputs[0].from] : args.outputs?.[0] ? doc.nodes[args.outputs[0].to] : void 0;
31004
31229
  const nearTab = near ? homeTabOf(doc, near.id) ?? void 0 : void 0;
31005
- 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);
31006
31232
  const zIndex = args.kind === "section" ? SECTION_Z : Object.values(doc.nodes).reduce((t, n) => Math.max(t, n.zIndex), 0) + 1;
31007
31233
  const node = makeNode({ type: WORKFLOW_NODE_TYPE, data, position, size: box, zIndex, createdBy: me });
31008
31234
  const links = [
@@ -31019,11 +31245,12 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31019
31245
  }
31020
31246
  const edges = edgeOps(doc, links, me, /* @__PURE__ */ new Set([node.id]));
31021
31247
  const drawn = edges.ops.flatMap((op) => op.type === "edge.add" ? [op.edge] : []);
31022
- 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);
31023
31249
  return {
31024
31250
  ops: [{ type: "node.add", nodeId: node.id, node }, ...edges.ops, ...mention.ops],
31025
31251
  targets: links.map((l) => l.source === node.id ? l.target : l.source),
31026
- 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}`
31027
31254
  };
31028
31255
  })
31029
31256
  )
@@ -31032,7 +31259,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31032
31259
  "canvas_update_node",
31033
31260
  {
31034
31261
  title: "Canvas: editar n\xF3",
31035
- 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,
31036
31263
  inputSchema: {
31037
31264
  board_id: boardId3,
31038
31265
  node_id: nodeIdArg2,
@@ -31112,7 +31339,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31112
31339
  "canvas_patch_node",
31113
31340
  {
31114
31341
  title: "Canvas: gravar por caminho",
31115
- 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,
31116
31343
  inputSchema: {
31117
31344
  board_id: boardId3,
31118
31345
  node_id: nodeIdArg2,
@@ -31120,7 +31347,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31120
31347
  external_exports.object({
31121
31348
  path: external_exports.string().trim().min(1).max(500).describe('Caminho dentro do data (ex.: "timeline.meta.fps"); aceita o prefixo "data.".'),
31122
31349
  value: external_exports.unknown().optional().describe("Valor JSON a gravar (null grava null)."),
31123
- 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.')
31124
31352
  })
31125
31353
  ).min(1).max(5e3)
31126
31354
  },
@@ -31137,6 +31365,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31137
31365
  let absent = 0;
31138
31366
  const mentionKeys = /* @__PURE__ */ new Set();
31139
31367
  let mentionAt = -1;
31368
+ const read = [];
31140
31369
  for (const [i, item] of args.sets.entries()) {
31141
31370
  const at = `sets[${i}] (${item.path})`;
31142
31371
  const segs = dataSegments(item.path);
@@ -31149,7 +31378,10 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31149
31378
  if (MENTION_KEYS.includes(segs[0])) mentionKeys.add(segs[0]);
31150
31379
  const unset = item.unset === true;
31151
31380
  const hasValue = item.value !== void 0;
31152
- 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
+ }
31153
31385
  if (hasValue && !isJson(item.value)) throw new CanvasToolError(`${at}: value n\xE3o \xE9 JSON v\xE1lido.`);
31154
31386
  let cur = work;
31155
31387
  for (const [j, seg] of segs.slice(0, -1).entries()) {
@@ -31184,7 +31416,9 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31184
31416
  if (MENTION_KEYS.includes(segs[0])) mentionAt = ops.length;
31185
31417
  continue;
31186
31418
  }
31187
- 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;
31188
31422
  if (cur && Object.hasOwn(cur, leaf) && JSON.stringify(cur[leaf]) === JSON.stringify(value)) {
31189
31423
  same++;
31190
31424
  continue;
@@ -31200,7 +31434,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31200
31434
  return {
31201
31435
  ops,
31202
31436
  targets: [node.id],
31203
- 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)
31204
31438
  };
31205
31439
  },
31206
31440
  { split: true }
@@ -31287,8 +31521,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31287
31521
  inputSchema: { board_id: boardId3, title: external_exports.string().trim().min(1).max(200) },
31288
31522
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
31289
31523
  },
31290
- async ({ board_id, title }) => run(
31291
- () => edit(board_id, async (doc) => ({
31524
+ async ({ board_id: board_id2, title }) => run(
31525
+ () => edit(board_id2, async (doc) => ({
31292
31526
  ops: doc.title === title ? [] : [{ type: "board.set", field: "title", value: setValue(title) }],
31293
31527
  targets: [],
31294
31528
  done: `Board renomeado: "${doc.title}" \u2192 "${title}"`
@@ -31303,8 +31537,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31303
31537
  inputSchema: { board_id: boardId3 },
31304
31538
  annotations: { readOnlyHint: true, openWorldHint: false }
31305
31539
  },
31306
- async ({ board_id }) => run(async () => {
31307
- const members = await api.members(board_id);
31540
+ async ({ board_id: board_id2 }) => run(async () => {
31541
+ const members = await api.members(board_id2);
31308
31542
  return members.map((m) => {
31309
31543
  const name = [m.firstName, m.lastName].filter(Boolean).join(" ") || m.nickname || "(sem nome)";
31310
31544
  return `- ${m.userId} \xB7 ${name} \xB7 ${m.role}`;
@@ -31323,8 +31557,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31323
31557
  },
31324
31558
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
31325
31559
  },
31326
- async ({ board_id, user_id, role }) => run(async () => {
31327
- 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);
31328
31562
  return `\u2705 ${r.userId} agora \xE9 ${r.role} no board.`;
31329
31563
  })
31330
31564
  );
@@ -31336,13 +31570,14 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31336
31570
  inputSchema: { board_id: boardId3, user_id: external_exports.string().uuid() },
31337
31571
  annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
31338
31572
  },
31339
- async ({ board_id, user_id }) => run(async () => {
31340
- 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);
31341
31575
  return `\u2705 ${user_id} n\xE3o tem mais acesso ao board.`;
31342
31576
  })
31343
31577
  );
31344
31578
  registerCanvasCommentTools(server, api, run);
31345
31579
  registerCanvasMediaTools(server, { api, cfg, run, edit, seen, placeFor });
31580
+ registerCanvasLockTools(server, { api, run });
31346
31581
  registerCanvasLayoutTools(server, { api, run, edit });
31347
31582
  registerCanvasRunTools(server, api, run);
31348
31583
  registerCanvasFocusTools(server, api, run);
@@ -31352,7 +31587,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31352
31587
  import { createRequire } from "module";
31353
31588
  var require2 = createRequire(import.meta.url);
31354
31589
  function readVersion() {
31355
- if ("0.46.0") return "0.46.0";
31590
+ if ("0.49.0") return "0.49.0";
31356
31591
  try {
31357
31592
  const pkg = require2("../package.json");
31358
31593
  return pkg.version ?? "0.0.0-unknown";
@@ -31367,7 +31602,7 @@ var SERVER_INSTRUCTIONS = [
31367
31602
  "BePlus: tudo roda pela conta do usu\xE1rio (diamantes, limites e hist\xF3rico na plataforma).",
31368
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.',
31369
31604
  "Calls: search_calls acha, get_call traz a transcri\xE7\xE3o.",
31370
- "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.",
31371
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.",
31372
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.',
31373
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.',