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.
@@ -25299,7 +25299,12 @@ var BeplusClient = class {
25299
25299
  offset: query.offset,
25300
25300
  // Only send when true — the backend treats truthy as "constrain".
25301
25301
  favorite: query.favorite ? "true" : void 0,
25302
- approved: query.approved ? "true" : void 0
25302
+ approved: query.approved ? "true" : void 0,
25303
+ project: query.project,
25304
+ user: query.user,
25305
+ scope: query.scope,
25306
+ type: query.type,
25307
+ cursor: query.cursor
25303
25308
  }
25304
25309
  });
25305
25310
  }
@@ -27322,34 +27327,44 @@ ${list}${flagsLine(status)}${draftHint}` }, ...blocks] };
27322
27327
  "list_generations",
27323
27328
  {
27324
27329
  title: "Listar gera\xE7\xF5es",
27325
- 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.',
27330
+ 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.',
27326
27331
  inputSchema: {
27327
27332
  limit: external_exports.number().int().min(1).max(100).optional().describe("Quantas trazer (padr\xE3o 20, m\xE1x 100)."),
27328
27333
  offset: external_exports.number().int().min(0).optional().describe("Deslocamento para paginar (padr\xE3o 0)."),
27329
27334
  favorite: external_exports.boolean().optional().describe('S\xF3 as favoritadas ("like"). Padr\xE3o: todas.'),
27330
- approved: external_exports.boolean().optional().describe("S\xF3 as com plano aprovado. Padr\xE3o: todas.")
27335
+ approved: external_exports.boolean().optional().describe("S\xF3 as com plano aprovado. Padr\xE3o: todas."),
27336
+ project: external_exports.string().optional().describe('C\xF3digo ou id do projeto (ex.: "EP2-26"). Lista o projeto inteiro.'),
27337
+ user: external_exports.string().optional().describe("E-mail ou id da pessoa. Sem project, s\xF3 admin."),
27338
+ scope: external_exports.enum(["team"]).optional().describe('"team": toda a equipe, com ou sem projeto. S\xF3 admin.'),
27339
+ type: external_exports.enum(["image", "video", "audio", "music", "upscale"]).optional().describe("Filtra por tipo, junto de project, user ou scope."),
27340
+ cursor: external_exports.string().optional().describe("Pr\xF3xima p\xE1gina, devolvido na resposta anterior.")
27331
27341
  }
27332
27342
  },
27333
- async ({ limit, offset, favorite, approved }) => {
27343
+ async ({ limit, offset, favorite, approved, project, user, scope, type, cursor }) => {
27334
27344
  try {
27335
- const { generations } = await client.listGenerations({ limit, offset, favorite, approved });
27345
+ const { generations, nextCursor } = await client.listGenerations({ limit, offset, favorite, approved, project, user, scope, type, cursor });
27336
27346
  if (!generations.length) {
27337
- const scope = favorite && approved ? " (favoritadas + aprovadas)" : favorite ? " favoritadas" : approved ? " aprovadas" : "";
27338
- return textResult(`Nenhuma gera\xE7\xE3o${scope} encontrada.`);
27347
+ const filterLabel = favorite && approved ? " (favoritadas + aprovadas)" : favorite ? " favoritadas" : approved ? " aprovadas" : "";
27348
+ return textResult(`Nenhuma gera\xE7\xE3o${filterLabel} encontrada.`);
27339
27349
  }
27340
27350
  const lines = generations.map((g, i) => {
27341
- const type = g.model?.startsWith("topaz/upscale") ? "upscale" : g.generation_type || "image";
27351
+ const kind = g.model?.startsWith("topaz/upscale") ? "upscale" : g.generation_type || "image";
27342
27352
  const when = g.created_at ? new Date(g.created_at).toISOString().slice(0, 10) : "\u2014";
27343
27353
  const prompt = (g.prompt || "").replace(/\s+/g, " ").slice(0, 80);
27344
27354
  const url = firstOutputUrl(g.output);
27345
27355
  const marks = [g.is_favorite ? "\u2B50" : null, g.is_approved_plan ? "\u2714\uFE0F" : null].filter(Boolean).join(" ");
27346
27356
  const marksSuffix = marks ? ` ${marks}` : "";
27347
- return `${i + 1}. ${type} \xB7 ${g.status} \xB7 ${when} \xB7 ${g.model}${marksSuffix}
27357
+ const authorName = [g.author?.first_name, g.author?.last_name].filter(Boolean).join(" ");
27358
+ const authorSuffix = authorName ? ` \xB7 ${authorName}` : "";
27359
+ return `${i + 1}. ${kind} \xB7 ${g.status} \xB7 ${when} \xB7 ${g.model}${authorSuffix}${marksSuffix}
27348
27360
  ${g.id}
27349
27361
  "${prompt}"${url ? `
27350
27362
  ${url}` : ""}`;
27351
27363
  });
27352
- return textResult(lines.join("\n\n"));
27364
+ const more = nextCursor ? `
27365
+
27366
+ Pr\xF3xima p\xE1gina: cursor "${nextCursor}"` : "";
27367
+ return textResult(lines.join("\n\n") + more);
27353
27368
  } catch (e) {
27354
27369
  return errorResult(apiErrorToUserMessage(e));
27355
27370
  }
@@ -28744,11 +28759,21 @@ ${calls.map(callLine).join("\n\n")}`);
28744
28759
  }
28745
28760
 
28746
28761
  // src/tools/canvas.ts
28747
- import { createHash as createHash2 } from "crypto";
28762
+ import { createHash as createHash3 } from "crypto";
28748
28763
 
28749
28764
  // src/canvas/api.ts
28750
28765
  import { createHash } from "crypto";
28751
28766
  var import_canvas_core = __toESM(require_canvas_core(), 1);
28767
+
28768
+ // src/canvas/tab-locks.ts
28769
+ var MINUTE = 6e4;
28770
+ function describeLock(lock, now = Date.now()) {
28771
+ const minutes = Math.max(1, Math.ceil((Date.parse(lock.expiresAt) - now) / MINUTE));
28772
+ const doing = lock.label ? `, "${lock.label}"` : "";
28773
+ return `a aba ${lock.tabId.slice(0, 8)} est\xE1 com a sess\xE3o ${lock.sessionId} de ${lock.holder}${doing}, por at\xE9 ${minutes} min se ela n\xE3o escrever mais`;
28774
+ }
28775
+
28776
+ // src/canvas/api.ts
28752
28777
  var PINNED_CORE_VERSION = "ca7b3b406184c7f679f555c3a008013197182b23";
28753
28778
  var RUN_REQUEST_TIMEOUT_MS = 4e4;
28754
28779
  var FOCUS_REQUEST_TIMEOUT_MS = 12e3;
@@ -28859,6 +28884,27 @@ var CanvasApi = class {
28859
28884
  boardLoads.set(loadKey, load);
28860
28885
  return load;
28861
28886
  }
28887
+ /**
28888
+ * Só estes nós. Com o board em cache, o delta já resolve e custa menos que a rota; sem cache, a
28889
+ * rota evita baixar o board inteiro. 404 pode ser servidor antigo: a foto decide se o board existe.
28890
+ */
28891
+ async readNodes(boardId4, ids) {
28892
+ if (!boardStore.has(this.cacheKey(boardId4))) {
28893
+ try {
28894
+ return await this.req("GET", `/boards/${boardId4}/nodes`, { query: { ids: ids.join(",") } });
28895
+ } catch (e) {
28896
+ if (!(e instanceof ApiError) || e.httpStatus !== 404) throw e;
28897
+ }
28898
+ }
28899
+ const snap = await this.snapshot(boardId4);
28900
+ const known = ids.filter((id) => Object.hasOwn(snap.doc.nodes, id));
28901
+ return {
28902
+ title: snap.title,
28903
+ seq: snap.seq,
28904
+ nodes: Object.fromEntries(known.map((id) => [id, snap.doc.nodes[id]])),
28905
+ missing: ids.filter((id) => !known.includes(id))
28906
+ };
28907
+ }
28862
28908
  async load(boardId4, key, needRuns) {
28863
28909
  const entry = boardStore.get(key);
28864
28910
  if (entry && !needRuns && this.coreVersion === PINNED_CORE_VERSION) {
@@ -28956,8 +29002,26 @@ var CanvasApi = class {
28956
29002
  }
28957
29003
  throw again;
28958
29004
  }
29005
+ } finally {
29006
+ const entry = boardStore.get(this.cacheKey(boardId4));
29007
+ if (entry) entry.checkedAt = -Infinity;
28959
29008
  }
28960
29009
  }
29010
+ tabLocks(boardId4) {
29011
+ return this.req("GET", `/boards/${boardId4}/tab-locks`);
29012
+ }
29013
+ async lockTab(boardId4, tabId, session, label) {
29014
+ try {
29015
+ return await this.req("PUT", `/boards/${boardId4}/tabs/${encodeURIComponent(tabId)}/lock`, { body: { session, label } });
29016
+ } catch (e) {
29017
+ const raw = errorRaw(e);
29018
+ if (raw?.reason !== "tab-locked" || !raw.lockedBy) throw e;
29019
+ throw new CanvasToolError(`N\xE3o travou: ${describeLock(raw.lockedBy)}.`);
29020
+ }
29021
+ }
29022
+ unlockTab(boardId4, tabId, session) {
29023
+ return this.req("DELETE", `/boards/${boardId4}/tabs/${encodeURIComponent(tabId)}/lock`, { query: { session } });
29024
+ }
28961
29025
  members(boardId4) {
28962
29026
  return this.req("GET", `/boards/${boardId4}/members`);
28963
29027
  }
@@ -29959,15 +30023,15 @@ function rowsLines(rows) {
29959
30023
  if (rows.length > MAX_BLOCKS) out.push(` \xB7 \u2026 +${rows.length - MAX_BLOCKS} linhas`);
29960
30024
  return out;
29961
30025
  }
29962
- function nodeLines(node, run, aba) {
30026
+ function nodeLines(node, run, aba2) {
29963
30027
  const kind = nodeKind(node);
29964
30028
  const spec = kind ? KINDS[kind] : void 0;
29965
- const head = `- ${node.id} \xB7 ${kind ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" @(${Math.round(node.position.x)},${Math.round(node.position.y)}) ${sizeLabel(node)}` + (aba ? ` \xB7 aba=${aba}` : "");
30029
+ const head = `- ${node.id} \xB7 ${kind ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" @(${Math.round(node.position.x)},${Math.round(node.position.y)}) ${sizeLabel(node)}` + (aba2 ? ` \xB7 aba=${aba2}` : "");
29966
30030
  const facts = [];
29967
30031
  const extra = [];
29968
30032
  const d = node.data;
29969
30033
  if (d.archived) facts.push("ARQUIVADO");
29970
- if (aba && isTabSection(node)) facts.push("\xE9 aba");
30034
+ if (aba2 && isTabSection(node)) facts.push("\xE9 aba");
29971
30035
  const approval = d.approval?.state;
29972
30036
  if (typeof approval === "string") facts.push(`aprova\xE7\xE3o: ${approval}`);
29973
30037
  if (Array.isArray(d.history)) facts.push(`${d.history.length} gera\xE7\xE3o(\xF5es)`);
@@ -29992,7 +30056,7 @@ function nodeLines(node, run, aba) {
29992
30056
  for (const [key, value] of Object.entries(d)) {
29993
30057
  if (NAME_KEYS.has(key) || HEAVY_KEYS.has(key) || key === main) continue;
29994
30058
  if (["blocks", "rows", "items", "archived", "approval"].includes(key)) continue;
29995
- if (aba && (key === TAB_ID_FIELD || key === TAB_FIELD && isTabSection(node))) continue;
30059
+ if (aba2 && (key === TAB_ID_FIELD || key === TAB_FIELD && isTabSection(node))) continue;
29996
30060
  const s = scalar(value);
29997
30061
  if (s !== null) facts.push(`${key}=${s}`);
29998
30062
  else if (Array.isArray(value)) facts.push(`${key}=[${value.length}]`);
@@ -30322,9 +30386,9 @@ function registerCanvasCommentTools(server, api, run) {
30322
30386
  },
30323
30387
  annotations: { readOnlyHint: true, openWorldHint: false }
30324
30388
  },
30325
- async ({ board_id, status }) => run(async () => {
30389
+ async ({ board_id: board_id2, status }) => run(async () => {
30326
30390
  const st = status ?? "open";
30327
- const [snap, threads] = await Promise.all([api.snapshot(board_id), api.listComments(board_id, st)]);
30391
+ const [snap, threads] = await Promise.all([api.snapshot(board_id2), api.listComments(board_id2, st)]);
30328
30392
  const text = commentsSummary(threads, snap.doc, st);
30329
30393
  const open3 = threads.some((t) => !t.resolvedAt);
30330
30394
  return open3 ? `${text}
@@ -30340,9 +30404,9 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
30340
30404
  inputSchema: { board_id: boardId, comment_id: commentId, body, mentions },
30341
30405
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
30342
30406
  },
30343
- async ({ board_id, comment_id, body: text, mentions: m }) => run(async () => {
30407
+ async ({ board_id: board_id2, comment_id, body: text, mentions: m }) => run(async () => {
30344
30408
  const thread = await onComment(
30345
- () => api.createComment(board_id, { body: text, parentId: comment_id, ...m?.length ? { mentions: m } : {} })
30409
+ () => api.createComment(board_id2, { body: text, parentId: comment_id, ...m?.length ? { mentions: m } : {} })
30346
30410
  );
30347
30411
  const open3 = thread?.resolvedAt ? "A thread est\xE1 resolvida; reabra com canvas_reopen_comment se precisar." : "A thread segue aberta.";
30348
30412
  return `\u2705 Resposta ${newReplyId(thread)} em ${comment_id}: "${oneLine2(text, 120)}". ${open3}`;
@@ -30360,11 +30424,11 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
30360
30424
  },
30361
30425
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
30362
30426
  },
30363
- async ({ board_id, comment_id, done }) => run(async () => {
30364
- const thread = await onComment(() => api.createComment(board_id, { body: done, parentId: comment_id }));
30427
+ async ({ board_id: board_id2, comment_id, done }) => run(async () => {
30428
+ const thread = await onComment(() => api.createComment(board_id2, { body: done, parentId: comment_id }));
30365
30429
  const replyId = newReplyId(thread);
30366
30430
  try {
30367
- await onComment(() => api.resolveComment(board_id, comment_id));
30431
+ await onComment(() => api.resolveComment(board_id2, comment_id));
30368
30432
  } catch (e) {
30369
30433
  const why = e instanceof Error ? e.message : String(e);
30370
30434
  throw new CanvasToolError(
@@ -30382,9 +30446,9 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
30382
30446
  inputSchema: { board_id: boardId, comment_id: commentId, why: external_exports.string().trim().min(1).max(1e3).optional() },
30383
30447
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
30384
30448
  },
30385
- async ({ board_id, comment_id, why }) => run(async () => {
30386
- await onComment(() => api.reopenComment(board_id, comment_id));
30387
- if (why) await onComment(() => api.createComment(board_id, { body: why, parentId: comment_id }));
30449
+ async ({ board_id: board_id2, comment_id, why }) => run(async () => {
30450
+ await onComment(() => api.reopenComment(board_id2, comment_id));
30451
+ if (why) await onComment(() => api.createComment(board_id2, { body: why, parentId: comment_id }));
30388
30452
  return `\u2705 Reaberto ${comment_id}${why ? ` com a resposta "${oneLine2(why, 120)}"` : ""}.`;
30389
30453
  })
30390
30454
  );
@@ -30486,8 +30550,8 @@ function layoutOps(doc, a) {
30486
30550
  }
30487
30551
  return ops;
30488
30552
  }
30489
- function scopeFor(doc, rows, aba) {
30490
- const tab = aba ? resolveTab(doc, aba) : void 0;
30553
+ function scopeFor(doc, rows, aba2) {
30554
+ const tab = aba2 ? resolveTab(doc, aba2) : void 0;
30491
30555
  if (!hasTabs(doc)) return void 0;
30492
30556
  const arranged = rows.flatMap((r) => [...r.title ? [r.title] : [], ...r.left, ...r.right]);
30493
30557
  const homes = new Set(arranged.map((id) => homeTabOf(doc, id)));
@@ -30830,6 +30894,7 @@ URL: ${u.url}`;
30830
30894
  return {
30831
30895
  ops: [{ type: "node.add", nodeId: created.id, node: created }],
30832
30896
  targets: [],
30897
+ place: { [created.id]: tab === void 0 ? {} : { tab } },
30833
30898
  done: `N\xF3 M\xEDdia "${oneLine2(nodeName(created), 40)}" criado: ${created.id}.${placementNote(doc, created)}`
30834
30899
  };
30835
30900
  });
@@ -30856,6 +30921,7 @@ var statusPacing = {
30856
30921
  now: () => Date.now(),
30857
30922
  sleep: (ms) => new Promise((r) => setTimeout(r, Math.max(0, ms)))
30858
30923
  };
30924
+ var byServer = (a) => a.via === "server";
30859
30925
  var sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
30860
30926
  var seconds = (ms) => `${new Intl.NumberFormat("pt-BR", { maximumFractionDigits: 1 }).format(ms / 1e3)} s`;
30861
30927
  function timingsLine(t) {
@@ -30930,12 +30996,12 @@ function registerCanvasRunTools(server, api, run) {
30930
30996
  const unknownFate = requestId && (e.httpStatus === 0 || e.httpStatus === 408 || reason === "tab-timeout" || reason === "tab-bad-answer" || e.httpStatus >= 500 && e.httpStatus !== 501);
30931
30997
  if (unknownFate) {
30932
30998
  throw new CanvasToolError(
30933
- `N\xE3o d\xE1 para saber se a aba come\xE7ou a rodar (${e.message}). N\xC3O pe\xE7a um pedido novo: consulte canvas_run_status com request_id "${requestId}". Se precisar repetir, chame canvas_run com o mesmo request_id: \xE9 seguro, a aba n\xE3o roda duas vezes.`
30999
+ `N\xE3o d\xE1 para saber se o pedido come\xE7ou a rodar (${e.message}). N\xC3O pe\xE7a um pedido novo: consulte canvas_run_status com request_id "${requestId}". Se precisar repetir, chame canvas_run com o mesmo request_id: \xE9 seguro, nada roda duas vezes.`
30934
31000
  );
30935
31001
  }
30936
31002
  if (reason === "no-tab") {
30937
31003
  throw new CanvasToolError(
30938
- "Nenhuma aba do Canvas sua est\xE1 aberta neste board (ou a aba \xE9 de uma vers\xE3o sem esta fun\xE7\xE3o). Pe\xE7a para abrir o board no Canvas com a mesma conta deste MCP e tente de novo. Nada rodou."
31004
+ "Este pedido precisa de uma aba do Canvas, e nenhuma sua est\xE1 aberta neste board (ou a aba \xE9 de uma vers\xE3o sem esta fun\xE7\xE3o). Pe\xE7a para abrir o board no Canvas com a mesma conta deste MCP e tente de novo. Nada rodou."
30939
31005
  );
30940
31006
  }
30941
31007
  if (e.httpStatus === 404 && reason !== "unknown-request") {
@@ -30957,7 +31023,7 @@ function registerCanvasRunTools(server, api, run) {
30957
31023
  function answerText(a, requestId, max, titleOf) {
30958
31024
  const est = estimateLines(a.estimate, titleOf);
30959
31025
  const total = a.estimate ? `${dia(a.estimate.total)} (teto ${fmt2(max)})` : "";
30960
- const again = a.repeated ? " (a aba j\xE1 tinha recebido este request_id; esta \xE9 a mesma resposta)" : "";
31026
+ const again = a.repeated ? " (este request_id j\xE1 tinha chegado; esta \xE9 a mesma resposta)" : "";
30961
31027
  if (a.status === "estimate") {
30962
31028
  return [
30963
31029
  `Estimativa, nada rodou${again}. Modo ${modeText(a.mode)}. Total agora: ${total}.`,
@@ -30969,7 +31035,7 @@ function registerCanvasRunTools(server, api, run) {
30969
31035
  if (a.status === "nothing") return `Nada para rodar${again}: ${a.message ?? "o board j\xE1 est\xE1 em dia."}`;
30970
31036
  const willRun = (a.estimate?.nodes ?? []).filter((n) => n.willRun).map((n) => n.nodeId);
30971
31037
  return [
30972
- `Rodando pela sua aba do Canvas${again}. Modo ${modeText(a.mode)}. Estimativa: ${total}.`,
31038
+ `${byServer(a) ? "Rodando no servidor, sem depender de aba aberta" : "Rodando pela sua aba do Canvas"}${again}. Modo ${modeText(a.mode)}. Estimativa: ${total}.`,
30973
31039
  ...est,
30974
31040
  `request_id: ${requestId}. Andamento: canvas_run_status (board_id, request_id). Resultado: canvas_read_board com node_ids [${willRun.slice(0, 20).join(", ")}] quando terminar.`,
30975
31041
  timingsLine(a.timings)
@@ -30983,7 +31049,7 @@ function registerCanvasRunTools(server, api, run) {
30983
31049
  "canvas_run",
30984
31050
  {
30985
31051
  title: "Canvas: rodar n\xF3s",
30986
- description: "Roda n\xF3s do board pela aba do Canvas que o usu\xE1rio tem aberta nele (mesma conta; sem aba aberta, nada roda). GASTA DIAMANTES no modo Real. A aba estima como o bot\xE3o Rodar e s\xF3 roda se a estimativa couber em max_diamonds (obrigat\xF3rio: o teto que o usu\xE1rio autorizou; nunca invente um valor alto). dry_run: true s\xF3 estima. Alvo, um destes: node_ids (roda esses n\xF3s mesmo em cache, gerando e gastando de novo, como o Rodar do cart\xE3o), from_node_id (o n\xF3 e tudo depois dele, tamb\xE9m de novo) ou all: true (s\xF3 o que mudou, como o Rodar tudo). simulated: true s\xF3 vale com a aba no modo Simulado; sem ele, a aba precisa estar no Real. Prompt com PT editado e sem aplicar no EN: a aba recusa e diz qual (aplique no cart\xE3o). Devolve o que vai rodar, o custo e o request_id; acompanhe com canvas_run_status e leia o resultado com canvas_read_board. Se a resposta disser que n\xE3o d\xE1 para saber se come\xE7ou, consulte o andamento e, para repetir, use o MESMO request_id.",
31052
+ description: "Roda n\xF3s do board no servidor, sem precisar de aba aberta. GASTA DIAMANTES no modo Real. Estima como o bot\xE3o Rodar e s\xF3 roda se a estimativa couber em max_diamonds (obrigat\xF3rio: o teto que o usu\xE1rio autorizou; nunca invente um valor alto). O teto \xE9 conferido de novo antes de cada n\xF3 pago; texto reserva o pior caso. dry_run: true s\xF3 estima. Alvo, um destes: node_ids (roda esses n\xF3s mesmo em cache, gerando e gastando de novo, como o Rodar do cart\xE3o), from_node_id (o n\xF3 e tudo depois dele, tamb\xE9m de novo) ou all: true (s\xF3 o que mudou, como o Rodar tudo). Composi\xE7\xE3o, montagem, exporta\xE7\xE3o, Contexto, arquivo que s\xF3 existe no navegador e especialista pr\xF3prio dependem da aba do usu\xE1rio: com ela aberta, o pedido vai para ela; sem ela, recusa antes de gastar e diz qual n\xF3. simulated: true s\xF3 vale com a aba no modo Simulado. Prompt com PT editado e sem aplicar no EN: recusa e diz qual (aplique no cart\xE3o). Devolve o que vai rodar, o custo e o request_id; acompanhe com canvas_run_status e leia o resultado com canvas_read_board. Se a resposta disser que n\xE3o d\xE1 para saber se come\xE7ou, consulte o andamento e, para repetir, use o MESMO request_id.",
30987
31053
  inputSchema: {
30988
31054
  board_id: boardId2,
30989
31055
  node_ids: external_exports.array(nodeId).min(1).max(100).optional().describe("Os n\xF3s a rodar (como o Rodar do cart\xE3o/sele\xE7\xE3o)."),
@@ -30991,8 +31057,8 @@ function registerCanvasRunTools(server, api, run) {
30991
31057
  all: external_exports.boolean().optional().describe("true: Rodar tudo (s\xF3 o que mudou)."),
30992
31058
  max_diamonds: external_exports.number().finite().min(0).max(1e6).describe("Teto de diamantes desta execu\xE7\xE3o. Obrigat\xF3rio."),
30993
31059
  dry_run: external_exports.boolean().optional().describe("true: s\xF3 estima, nada roda."),
30994
- simulated: external_exports.boolean().optional().describe("true: o pedido \xE9 para o modo Simulado (a aba precisa estar nele)."),
30995
- label: external_exports.string().trim().min(1).max(80).optional().describe('Quem pede, como a aba mostra ("Rodando a pedido de \u2026").'),
31060
+ simulated: external_exports.boolean().optional().describe("true: o pedido \xE9 para o modo Simulado, que roda na aba (ela precisa estar nele)."),
31061
+ label: external_exports.string().trim().min(1).max(80).optional().describe('Quem pede, como o board mostra ("Rodando a pedido de \u2026").'),
30996
31062
  request_id: external_exports.string().uuid().optional().describe("S\xF3 para repetir um pedido cujo destino ficou incerto.")
30997
31063
  },
30998
31064
  annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
@@ -31010,7 +31076,8 @@ function registerCanvasRunTools(server, api, run) {
31010
31076
  dryRun: args.dry_run === true,
31011
31077
  simulated: args.simulated === true,
31012
31078
  label,
31013
- earlyAck: true
31079
+ earlyAck: true,
31080
+ clientId: CLIENT_ID
31014
31081
  });
31015
31082
  } catch (e) {
31016
31083
  explain2(e, requestId);
@@ -31024,13 +31091,13 @@ function registerCanvasRunTools(server, api, run) {
31024
31091
  }
31025
31092
  if (wasAccepted) answer = { ...answer, repeated: false };
31026
31093
  if (answer.ok === true && answer.status === "accepted") {
31027
- return `A aba recebeu o pedido e ainda est\xE1 estimando e conferindo (board grande). request_id: ${requestId}. Acompanhe com canvas_run_status; para a resposta completa, chame canvas_run de novo com o MESMO request_id (\xE9 seguro: a aba n\xE3o roda duas vezes). N\xC3O pe\xE7a com outro id.`;
31094
+ return `O pedido chegou e ainda est\xE1 sendo estimado e conferido (board grande). request_id: ${requestId}. Acompanhe com canvas_run_status; para a resposta completa, chame canvas_run de novo com o MESMO request_id (\xE9 seguro: nada roda duas vezes). N\xC3O pe\xE7a com outro id.`;
31028
31095
  }
31029
31096
  const titleOf = lacksTitles(answer.estimate?.nodes) ? await titles(args.board_id) : (id) => id;
31030
31097
  if (answer.ok !== true) {
31031
31098
  const est = estimateLines(answer.estimate, titleOf);
31032
31099
  throw new CanvasToolError(
31033
- [`A aba recusou, nada rodou (${answer.reason ?? "sem motivo"}): ${answer.message ?? ""}`.trim(), ...est].join("\n")
31100
+ [`${byServer(answer) ? "O servidor" : "A aba"} recusou, nada rodou (${answer.reason ?? "sem motivo"}): ${answer.message ?? ""}`.trim(), ...est].join("\n")
31034
31101
  );
31035
31102
  }
31036
31103
  const nodeIds = (answer.estimate?.nodes ?? []).filter((n) => n.willRun).map((n) => n.nodeId);
@@ -31048,7 +31115,7 @@ function registerCanvasRunTools(server, api, run) {
31048
31115
  "canvas_run_status",
31049
31116
  {
31050
31117
  title: "Canvas: andamento da execu\xE7\xE3o",
31051
- description: "Andamento de um pedido do canvas_run: estado de cada n\xF3, estimado e gasto. Pergunta \xE0 aba do Canvas que rodou; se ela fechou, l\xEA o estado de execu\xE7\xE3o do board para os n\xF3s do pedido (os que este MCP lembra, ou node_ids). S\xF3 leitura.",
31118
+ description: "Andamento de um pedido do canvas_run: estado de cada n\xF3, estimado e gasto. Vem do servidor ou da aba que rodou; se ela fechou, l\xEA o estado de execu\xE7\xE3o do board para os n\xF3s do pedido (os que este MCP lembra, ou node_ids). S\xF3 leitura.",
31052
31119
  inputSchema: {
31053
31120
  board_id: boardId2,
31054
31121
  request_id: external_exports.string().uuid().describe("O request_id que o canvas_run devolveu."),
@@ -31056,7 +31123,7 @@ function registerCanvasRunTools(server, api, run) {
31056
31123
  },
31057
31124
  annotations: { readOnlyHint: true, openWorldHint: true }
31058
31125
  },
31059
- async ({ board_id, request_id, node_ids }) => run(async () => {
31126
+ async ({ board_id: board_id2, request_id, node_ids }) => run(async () => {
31060
31127
  const requestId = request_id.toLowerCase();
31061
31128
  const since = statusPacing.now() - (lastStatusAt.get(requestId) ?? -Infinity);
31062
31129
  if (since < statusPacing.minIntervalMs) await statusPacing.sleep(statusPacing.minIntervalMs - since);
@@ -31065,8 +31132,8 @@ function registerCanvasRunTools(server, api, run) {
31065
31132
  while (lastStatusAt.size > MAX_REMEMBERED) lastStatusAt.delete(lastStatusAt.keys().next().value);
31066
31133
  let why = "";
31067
31134
  try {
31068
- const status = await api.runStatus(board_id, requestId);
31069
- return statusText(status, lacksTitles(status.nodes) ? await titles(board_id) : (id) => id);
31135
+ const status = await api.runStatus(board_id2, requestId);
31136
+ return statusText(status, lacksTitles(status.nodes) ? await titles(board_id2) : (id) => id);
31070
31137
  } catch (e) {
31071
31138
  const reason = errorRaw(e)?.reason;
31072
31139
  if (!(e instanceof ApiError) || reason !== "unknown-request" && reason !== "no-tab") explain2(e);
@@ -31079,12 +31146,12 @@ function registerCanvasRunTools(server, api, run) {
31079
31146
  }
31080
31147
  const partial2 = known?.omitted ? ` (parcial: s\xF3 os ${ids.length} n\xF3s que a aba listou; outros ${known.omitted} ficaram fora da resposta. Para eles, chame com node_ids)` : "";
31081
31148
  return `${why} Pelo estado de execu\xE7\xE3o do board${partial2}:
31082
- ${fromRuns(await api.snapshot(board_id, { runs: true }), ids)}`;
31149
+ ${fromRuns(await api.snapshot(board_id2, { runs: true }), ids)}`;
31083
31150
  })
31084
31151
  );
31085
31152
  }
31086
31153
  var STATE_TEXT = {
31087
- preparing: "a aba est\xE1 estimando e conferindo",
31154
+ preparing: "estimando e conferindo",
31088
31155
  running: "rodando",
31089
31156
  done: "terminou",
31090
31157
  failed: "terminou com erro",
@@ -31305,6 +31372,55 @@ function lockViolation(doc, ops) {
31305
31372
  return null;
31306
31373
  }
31307
31374
 
31375
+ // src/tools/canvas-locks.ts
31376
+ var board_id = external_exports.string().uuid();
31377
+ var aba = external_exports.string().trim().min(1).max(128).describe("Id da se\xE7\xE3o da aba ou o come\xE7o \xFAnico dele (o aba=\u2026 da leitura).");
31378
+ function registerCanvasLockTools(server, deps) {
31379
+ const { api, run } = deps;
31380
+ const needOwnSession = () => {
31381
+ if (isRemoteMode()) throw new CanvasToolError("A trava de aba precisa de uma sess\xE3o pr\xF3pria, e esta conex\xE3o roda no servidor da BePlus: use o MCP local.");
31382
+ };
31383
+ server.registerTool(
31384
+ "canvas_lock_tab",
31385
+ {
31386
+ title: "Canvas: travar aba",
31387
+ description: "Marca a aba como desta sess\xE3o: outras sess\xF5es do Claude leem, mas a escrita delas nessa aba \xE9 recusada. A pessoa no navegador n\xE3o \xE9 barrada. Vale 15 minutos, renovados a cada escrita desta sess\xE3o no board, ent\xE3o sess\xE3o morta solta sozinha. Chamar de novo renova. Se outra sess\xE3o segura a aba, recusa dizendo quem. Solte com canvas_unlock_tab ao terminar.",
31388
+ inputSchema: {
31389
+ board_id,
31390
+ aba,
31391
+ label: external_exports.string().trim().min(1).max(120).optional().describe("O que esta sess\xE3o est\xE1 fazendo: aparece para quem for recusado.")
31392
+ },
31393
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
31394
+ },
31395
+ async (args) => run(async () => {
31396
+ needOwnSession();
31397
+ const { doc } = await api.snapshot(args.board_id);
31398
+ const tab = resolveTab(doc, args.aba);
31399
+ const lock = await api.lockTab(args.board_id, tab, CLIENT_ID, args.label);
31400
+ return `\u2705 Aba "${tabTitle(doc.nodes[tab])}" travada para esta sess\xE3o (${lock.sessionId}) at\xE9 ${lock.expiresAt}; cada escrita renova.`;
31401
+ })
31402
+ );
31403
+ server.registerTool(
31404
+ "canvas_unlock_tab",
31405
+ {
31406
+ title: "Canvas: soltar aba",
31407
+ description: "Solta a aba que esta sess\xE3o travou com canvas_lock_tab. Trava de outra sess\xE3o n\xE3o muda: ela s\xF3 some quando a dona solta ou vence.",
31408
+ inputSchema: { board_id, aba },
31409
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
31410
+ },
31411
+ async (args) => run(async () => {
31412
+ needOwnSession();
31413
+ const { doc } = await api.snapshot(args.board_id);
31414
+ const tab = resolveTab(doc, args.aba);
31415
+ const { released } = await api.unlockTab(args.board_id, tab, CLIENT_ID);
31416
+ const name = `"${tabTitle(doc.nodes[tab])}"`;
31417
+ if (released) return `\u2705 Aba ${name} solta.`;
31418
+ const other = (await api.tabLocks(args.board_id)).find((l) => l.tabId === tab);
31419
+ return other ? `Nada mudou: ${describeLock(other)}.` : `A aba ${name} j\xE1 estava livre.`;
31420
+ })
31421
+ );
31422
+ }
31423
+
31308
31424
  // src/canvas/mentions.ts
31309
31425
  var VIA_MENTION = "viaMention";
31310
31426
  var PROMPT_REFS_INPUT = "refs";
@@ -31436,16 +31552,79 @@ function describeMentionSync(sync, name) {
31436
31552
  return parts.length ? ` ${parts.join(". ")}.` : "";
31437
31553
  }
31438
31554
 
31555
+ // src/canvas/text-file.ts
31556
+ import { createHash as createHash2 } from "crypto";
31557
+ import { readFile as readFile3, realpath, stat as stat4 } from "fs/promises";
31558
+ import { extname as extname4 } from "path";
31559
+ var TEXT_FILE_EXTENSIONS = ["txt", "md", "markdown", "csv", "tsv", "srt", "vtt"];
31560
+ var MAX_TEXT_FILE_BYTES = MAX_OP_BYTES - 4 * 1024;
31561
+ var kb = (bytes) => (bytes / 1024).toFixed(1).replace(".", ",");
31562
+ async function readTextFile(ref) {
31563
+ const refuse = (why) => new CanvasToolError(`Arquivo "${ref}": ${why} Nada foi gravado.`);
31564
+ let abs;
31565
+ try {
31566
+ abs = toLocalPath(ref);
31567
+ } catch (e) {
31568
+ if (e instanceof ApiError) {
31569
+ throw refuse("esta conex\xE3o roda no servidor da BePlus, que n\xE3o enxerga o seu computador. Mande o texto direto em data ou value.");
31570
+ }
31571
+ throw refuse("o caminho n\xE3o \xE9 v\xE1lido.");
31572
+ }
31573
+ if (isRemoteRef(ref)) throw refuse("aqui vale s\xF3 caminho local, n\xE3o URL.");
31574
+ let real;
31575
+ let size;
31576
+ try {
31577
+ real = await realpath(abs);
31578
+ const info = await stat4(real);
31579
+ if (!info.isFile()) throw refuse("n\xE3o \xE9 um arquivo comum.");
31580
+ size = info.size;
31581
+ } catch (e) {
31582
+ if (e instanceof CanvasToolError) throw e;
31583
+ throw refuse("n\xE3o encontrei ou n\xE3o consegui abrir.");
31584
+ }
31585
+ const ext = extname4(real).slice(1).toLowerCase();
31586
+ if (!TEXT_FILE_EXTENSIONS.includes(ext)) {
31587
+ throw refuse(`${ext ? `a extens\xE3o .${ext}` : "arquivo sem extens\xE3o"} n\xE3o \xE9 aceita. Aceitas: ${TEXT_FILE_EXTENSIONS.join(", ")}.`);
31588
+ }
31589
+ const tooLarge2 = (bytes) => refuse(`d\xE1 ${kb(bytes)} KB para enviar, acima do teto de ${kb(MAX_TEXT_FILE_BYTES)} KB (uma opera\xE7\xE3o do Canvas leva at\xE9 64 KB). Divida o texto em mais de um campo.`);
31590
+ if (size > MAX_TEXT_FILE_BYTES) throw tooLarge2(size);
31591
+ let buf;
31592
+ try {
31593
+ buf = await readFile3(real);
31594
+ } catch {
31595
+ throw refuse("n\xE3o consegui ler.");
31596
+ }
31597
+ let text;
31598
+ try {
31599
+ if (buf.includes(0)) throw new Error("nul");
31600
+ text = new TextDecoder("utf-8", { fatal: true }).decode(buf);
31601
+ } catch {
31602
+ throw refuse("parece bin\xE1rio ou n\xE3o est\xE1 em UTF-8. Salve como texto UTF-8.");
31603
+ }
31604
+ if (!text.trim()) throw refuse("est\xE1 vazio.");
31605
+ const json = JSON.stringify(text);
31606
+ const wire = Buffer.byteLength(json);
31607
+ if (wire > MAX_TEXT_FILE_BYTES) throw tooLarge2(wire);
31608
+ return { text, bytes: buf.byteLength, hash: createHash2("sha256").update(json).digest("hex").slice(0, 12) };
31609
+ }
31610
+ function describeTextFiles(read) {
31611
+ if (!read.length) return "";
31612
+ return ` Lido de arquivo: ${read.map((r) => `${r.path} \u2190 "${r.ref}" (${r.file.bytes} bytes, sha256 ${r.file.hash})`).join("; ")}.`;
31613
+ }
31614
+
31439
31615
  // src/tools/canvas.ts
31440
31616
  var REJECT_TEXT = {
31441
31617
  "node-missing": "o n\xF3 n\xE3o existe mais (algu\xE9m apagou)",
31442
31618
  "edge-endpoint-missing": "uma ponta da liga\xE7\xE3o n\xE3o existe mais",
31443
31619
  "invalid-op": "opera\xE7\xE3o inv\xE1lida ou repetida",
31444
- "too-large": "opera\xE7\xE3o grande demais (64 KB) ou com m\xEDdia embutida"
31620
+ "too-large": "opera\xE7\xE3o grande demais (64 KB) ou com m\xEDdia embutida",
31621
+ "tab-locked": "a aba est\xE1 travada por outra sess\xE3o"
31445
31622
  };
31623
+ var rejectText = (o) => o.lockedBy ? describeLock(o.lockedBy) : REJECT_TEXT[o.rejected] ?? o.rejected;
31446
31624
  var READ = "Exige canvas_read_board nesta sess\xE3o (e de novo depois de uma recusa). ";
31447
31625
  var MENTION_NOTE = 'Prompt: {{var}} no template + data.mentions {var: {node, port}} (o !! de um Bloco \xE9 port "text") j\xE1 cria, no mesmo passo, a liga\xE7\xE3o fina de men\xE7\xE3o que o Canvas desenha; tirar a var ou a men\xE7\xE3o tira a liga\xE7\xE3o. ';
31448
31626
  var MONTAGE_NOTE = "Montagem: musicGainDb, duckingDb e fadeMs valem s\xF3 para a montagem autom\xE1tica (clipes ligados) e n\xE3o mexem na timeline do editor (data.timeline; data.sequence \xE9 o legado); o volume dela fica nos clipes (gainDb, gainKeyframes, fades) e nas faixas (gainDb de cada faixa, master).";
31627
+ var FILE_NOTE = `Texto grande (prompt, roteiro): salve num arquivo local e passe o caminho, n\xE3o digite na chamada. S\xF3 ${TEXT_FILE_EXTENSIONS.join(", ")}, UTF-8, at\xE9 ${MAX_TEXT_FILE_BYTES / 1024} KB; n\xE3o vale no conector remoto. `;
31449
31628
  function dataSegments(path) {
31450
31629
  const p = path?.trim() ?? "";
31451
31630
  if (!p || p === "data") return [];
@@ -31453,6 +31632,32 @@ function dataSegments(path) {
31453
31632
  if (segs.some((seg) => !seg)) throw new CanvasToolError(`Caminho "${p}" tem segmento vazio (dois pontos seguidos ou ponto na ponta).`);
31454
31633
  return segs;
31455
31634
  }
31635
+ async function withDataFiles(raw, files) {
31636
+ const data = structuredClone(raw ?? {});
31637
+ const read = [];
31638
+ for (const [asked, ref] of Object.entries(files ?? {})) {
31639
+ const at = `data_files["${asked}"]`;
31640
+ const segs = dataSegments(asked);
31641
+ if (!segs.length) throw new CanvasToolError(`${at}: informe um caminho dentro do data, n\xE3o o data inteiro.`);
31642
+ const path = segs.join(".");
31643
+ const badPath = checkNodePath(`data.${path}`);
31644
+ if (badPath) throw new CanvasToolError(`${at}: ${badPath}.`);
31645
+ let cur = data;
31646
+ for (const [i, seg] of segs.slice(0, -1).entries()) {
31647
+ const next = Object.hasOwn(cur, seg) ? cur[seg] : cur[seg] = {};
31648
+ if (!next || typeof next !== "object" || Array.isArray(next)) {
31649
+ throw new CanvasToolError(`${at}: data.${segs.slice(0, i + 1).join(".")} n\xE3o \xE9 objeto, e o caminho n\xE3o entra nele.`);
31650
+ }
31651
+ cur = next;
31652
+ }
31653
+ const leaf = segs[segs.length - 1];
31654
+ if (Object.hasOwn(cur, leaf)) throw new CanvasToolError(`${at}: data.${path} j\xE1 veio neste pedido. Mande o valor por um lugar s\xF3.`);
31655
+ const file = await readTextFile(ref);
31656
+ cur[leaf] = file.text;
31657
+ read.push({ path, ref, file });
31658
+ }
31659
+ return { data, note: describeTextFiles(read) };
31660
+ }
31456
31661
  function legacySequenceGuard(node, key) {
31457
31662
  if (key === "sequence" && nodeKind(node) === "montage" && node.data.timeline !== void 0) {
31458
31663
  throw new CanvasToolError(
@@ -31527,7 +31732,7 @@ function registerCanvasTools(server, client, cfg) {
31527
31732
  const snap = await api.snapshot(id, { fresh: true });
31528
31733
  if (snap.role === "viewer") throw new CanvasToolError("Voc\xEA \xE9 s\xF3 leitor neste board: pe\xE7a ao dono para te dar papel de editor.");
31529
31734
  const doc = snap.doc;
31530
- const { ops, done, targets } = await build2(doc, snap);
31735
+ const { ops, done, targets, place } = await build2(doc, snap);
31531
31736
  if (!ops.length) return `Nada a mudar. ${done}`;
31532
31737
  if (opts.layoutOnly && !ops.every(isLayoutOp)) throw new Error("layout_only com opera\xE7\xE3o fora de posi\xE7\xE3o/tamanho");
31533
31738
  const locked = lockViolation(doc, ops);
@@ -31556,14 +31761,17 @@ function registerCanvasTools(server, client, cfg) {
31556
31761
  Aviso: ${changesSince(theirs, doc)}.`;
31557
31762
  }
31558
31763
  if (opts.split) return commitSplit(id, ops, done, note, !!opts.layoutOnly);
31559
- const env = envelope(id, batchOf(ops), await api.me());
31764
+ const env = { ...envelope(id, batchOf(ops), await api.me()), ...place && { place } };
31560
31765
  const bad = checkEnvelope(env);
31561
31766
  if (bad) throw new CanvasToolError(`Edi\xE7\xE3o recusada antes de enviar: ${bad}.`);
31562
31767
  const res = await commitOps(id, [env]);
31563
31768
  const outcome = res.outcomes.find((o) => o.opId === env.id);
31769
+ if (outcome && "rejected" in outcome && outcome.rejected === "tab-locked") {
31770
+ throw new CanvasToolError(`O servidor recusou a edi\xE7\xE3o: ${rejectText(outcome)}. Nada foi aplicado. Ler continua valendo; para escrever, espere soltar ou use outra aba.`);
31771
+ }
31564
31772
  if (!outcome || "rejected" in outcome) {
31565
31773
  if (!opts.layoutOnly) seen.delete(id);
31566
- const why = outcome && "rejected" in outcome ? REJECT_TEXT[outcome.rejected] ?? outcome.rejected : "sem resposta do servidor";
31774
+ const why = outcome && "rejected" in outcome ? rejectText(outcome) : "sem resposta do servidor";
31567
31775
  throw new CanvasToolError(`O servidor recusou a edi\xE7\xE3o: ${why}. Nada foi aplicado. Releia com canvas_read_board.`);
31568
31776
  }
31569
31777
  if (!opts.layoutOnly) seen.set(id, res.seq);
@@ -31597,10 +31805,10 @@ Aviso: ${changesSince(theirs, doc)}.`;
31597
31805
  const lines = envs.map((env, i) => {
31598
31806
  const paths = pathsOf(env.op);
31599
31807
  const span = paths.length > 1 ? `${paths[0]} \u2026 ${paths[paths.length - 1]}` : paths[0];
31600
- const kb = (Buffer.byteLength(JSON.stringify(env)) / 1024).toFixed(1).replace(".", ",");
31808
+ const kb2 = (Buffer.byteLength(JSON.stringify(env)) / 1024).toFixed(1).replace(".", ",");
31601
31809
  const o = outcomes.get(env.id);
31602
- 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`);
31603
- return `- envelope ${i + 1}/${envs.length}: ${paths.length} caminho(s) (${span}), ${kb} KB \u2192 ${result}`;
31810
+ const result = o && "seq" in o ? `seq ${o.seq}` : (failed++, `RECUSADO (${o && "rejected" in o ? rejectText(o) : "sem resposta do servidor"}): nada deste envelope entrou`);
31811
+ return `- envelope ${i + 1}/${envs.length}: ${paths.length} caminho(s) (${span}), ${kb2} KB \u2192 ${result}`;
31604
31812
  });
31605
31813
  if (failed) {
31606
31814
  if (!layoutOnly) seen.delete(id);
@@ -31731,7 +31939,7 @@ ${lines.join("\n")}${note}`;
31731
31939
  "canvas_read_board",
31732
31940
  {
31733
31941
  title: "Canvas: ler board",
31734
- description: 'L\xEA um board: n\xF3s (id, tipo, nome, posi\xE7\xE3o, tamanho, campos principais), liga\xE7\xF5es e v\xEDnculo com o IA Lab, sem m\xEDdia. Tamanho "medido" \xE9 o da tela; "gravado" \xE9 o piso (o cart\xE3o cresce com o conte\xFAdo). Obrigat\xF3rio antes de editar (vale para a sess\xE3o). node_ids devolve o data desses n\xF3s, com cada corte marcado (path=\u2026); o valor inteiro (ex.: data.sequence da Montagem) sai no canvas_read_node. Cada cart\xE3o diz a aba (aba=<id curto> ou aba=avulsos), o topo conta os cart\xF5es de cada aba e aba l\xEA uma aba s\xF3.',
31942
+ description: 'L\xEA um board: n\xF3s (id, tipo, nome, posi\xE7\xE3o, tamanho, campos principais), liga\xE7\xF5es e v\xEDnculo com o IA Lab, sem m\xEDdia. Tamanho "medido" \xE9 o da tela; "gravado" \xE9 o piso (o cart\xE3o cresce com o conte\xFAdo). Obrigat\xF3rio antes de editar (vale para a sess\xE3o). node_ids devolve s\xF3 o data desses n\xF3s, sem o resto do board, com cada corte marcado (path=\u2026); o valor inteiro (ex.: data.sequence da Montagem) sai no canvas_read_node. Cada cart\xE3o diz a aba (aba=<id curto> ou aba=avulsos), o topo conta os cart\xF5es de cada aba e aba l\xEA uma aba s\xF3.',
31735
31943
  inputSchema: {
31736
31944
  board_id: boardId3,
31737
31945
  node_ids: external_exports.array(nodeIdArg2).max(20).optional().describe("N\xF3s para ver o data (sem blobs, cortes marcados)."),
@@ -31739,11 +31947,26 @@ ${lines.join("\n")}${note}`;
31739
31947
  },
31740
31948
  annotations: { readOnlyHint: true, openWorldHint: false }
31741
31949
  },
31742
- async ({ board_id, node_ids, aba }) => run(async () => {
31743
- const snap = await api.snapshot(board_id);
31744
- const tab = aba ? resolveTab(snap.doc, aba, { allowAvulsos: true }) : void 0;
31745
- seen.set(board_id, snap.seq);
31950
+ async ({ board_id: board_id2, node_ids, aba: aba2 }) => run(async () => {
31951
+ if (node_ids?.length && !aba2) {
31952
+ const read = await api.readNodes(board_id2, node_ids);
31953
+ if (!seen.has(board_id2)) seen.set(board_id2, read.seq);
31954
+ const found = node_ids.flatMap((n) => read.nodes[n] ? [read.nodes[n]] : []);
31955
+ return [
31956
+ `Board "${read.title}" \xB7 id ${board_id2} \xB7 seq ${read.seq} \xB7 ${node_ids.length} n\xF3(s) pedido(s)`,
31957
+ "",
31958
+ ...found.flatMap((n) => nodeLines(n)),
31959
+ "",
31960
+ "Detalhe:",
31961
+ ...node_ids.map((n) => read.nodes[n] ? nodeDetail(read.nodes[n]) : `${n}: n\xE3o existe`)
31962
+ ].join("\n");
31963
+ }
31964
+ const snap = await api.snapshot(board_id2);
31965
+ const tab = aba2 ? resolveTab(snap.doc, aba2, { allowAvulsos: true }) : void 0;
31966
+ seen.set(board_id2, snap.seq);
31746
31967
  const parts = [boardSummary(snap, { tab })];
31968
+ const locks = await api.tabLocks(board_id2).catch(() => []);
31969
+ if (locks.length) parts.push("", "Travas de sess\xE3o:", ...locks.map((l) => `- ${describeLock(l)}`));
31747
31970
  if (node_ids?.length) {
31748
31971
  parts.push("", "Detalhe:");
31749
31972
  for (const n of node_ids) parts.push(snap.doc.nodes[n] ? nodeDetail(snap.doc.nodes[n]) : `${n}: n\xE3o existe`);
@@ -31765,9 +31988,9 @@ ${lines.join("\n")}${note}`;
31765
31988
  },
31766
31989
  annotations: { readOnlyHint: true, openWorldHint: false }
31767
31990
  },
31768
- async ({ board_id, node_id, path, offset, max_chars }) => run(async () => {
31769
- const snap = await api.snapshot(board_id);
31770
- const node = snap.doc.nodes[node_id];
31991
+ async ({ board_id: board_id2, node_id, path, offset, max_chars }) => run(async () => {
31992
+ const read = await api.readNodes(board_id2, [node_id]);
31993
+ const node = read.nodes[node_id];
31771
31994
  if (!node) throw new CanvasToolError(`N\xF3 ${node_id} n\xE3o existe no board. Releia com canvas_read_board.`);
31772
31995
  let value = visibleData(node.data);
31773
31996
  let segments = dataSegments(path);
@@ -31800,10 +32023,10 @@ ${lines.join("\n")}${note}`;
31800
32023
  const from = Math.min(offset ?? 0, total);
31801
32024
  const size = max_chars ?? 4e4;
31802
32025
  const to = Math.min(from + size, total);
31803
- const hash = createHash2("sha256").update(json).digest("hex").slice(0, 12);
32026
+ const hash = createHash3("sha256").update(json).digest("hex").slice(0, 12);
31804
32027
  const where = `data${segments.length ? `.${segments.join(".")}` : ""}`;
31805
32028
  const at = readMeasured(node)?.at;
31806
- const head = `${node.id} \xB7 ${nodeKind(node) ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" \xB7 board seq ${snap.seq} \xB7 tamanho ${sizeLabel(node)}${at ? ` \xB7 medido em ${at}` : ""} \xB7 ${where}${which}: ${total} caracteres (JSON compacto) \xB7 sha256 ${hash}`;
32029
+ const head = `${node.id} \xB7 ${nodeKind(node) ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" \xB7 board seq ${read.seq} \xB7 tamanho ${sizeLabel(node)}${at ? ` \xB7 medido em ${at}` : ""} \xB7 ${where}${which}: ${total} caracteres (JSON compacto) \xB7 sha256 ${hash}`;
31807
32030
  const part = from === 0 && to === total ? "Inteiro, abaixo." : `Parte: caracteres ${from} a ${to} de ${total}. ${to < total ? `Falta o resto: chame de novo com offset=${to}.` : "Esta \xE9 a \xFAltima parte."}`;
31808
32031
  return `${head}
31809
32032
  ${part}
@@ -31864,12 +32087,13 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31864
32087
  "canvas_add_node",
31865
32088
  {
31866
32089
  title: "Canvas: adicionar n\xF3",
31867
- description: `Adiciona um n\xF3 (n\xE3o executa). ${READ}kind: ${kindList()}. data completa o padr\xE3o do tipo; label d\xE1 o nome. Sem position, nasce ao lado do n\xF3 ligado ou \xE0 direita do board (com aba, no fim do conte\xFAdo da aba); aba grava data.abaId. Texto livre (label) sem size {w} nasce na largura do tamanho do texto: titulo 2000, subtitulo 1200, corpo 320. Prompt sem size nasce com 1024 \xD7 516; gerador de imagem ou v\xEDdeo, com altura 516 e a largura do aspect_ratio (16:9 917, 9:16 290, 1:1 516). inputs/outputs j\xE1 ligam o n\xF3 no mesmo passo. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
32090
+ description: `Adiciona um n\xF3 (n\xE3o executa). ${READ}kind: ${kindList()}. data completa o padr\xE3o do tipo; label d\xE1 o nome. Sem position, nasce ao lado do n\xF3 ligado ou \xE0 direita do board (com aba, no fim do conte\xFAdo da aba); aba grava data.abaId. Texto livre (label) sem size {w} nasce na largura do tamanho do texto: titulo 2000, subtitulo 1200, corpo 320. Prompt sem size nasce com 1024 \xD7 516; gerador de imagem ou v\xEDdeo, com altura 516 e a largura do aspect_ratio (16:9 917, 9:16 290, 1:1 516). inputs/outputs j\xE1 ligam o n\xF3 no mesmo passo. ${FILE_NOTE}data_files {"template": "/tmp/prompt.md"} grava o texto do arquivo nesse caminho do data, igual a ter vindo em data. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
31868
32091
  inputSchema: {
31869
32092
  board_id: boardId3,
31870
32093
  kind: external_exports.string().min(1).max(40),
31871
32094
  label: external_exports.string().trim().min(1).max(120).optional().describe("Nome do cart\xE3o (data.label)."),
31872
32095
  data: external_exports.record(external_exports.unknown()).optional().describe("Campos do data. Ex.: narration {blocks:[{id,text}]}, text {text}, prompt {template}."),
32096
+ data_files: external_exports.record(external_exports.string().min(1).max(4096)).optional().describe('Texto vindo de arquivo local: { "<caminho no data>": "<arquivo>" }. Ex.: { "template": "/tmp/prompt.md" }. Prefira a digitar texto grande em data.'),
31873
32097
  aba: abaArg(ABA_ADD_NODE),
31874
32098
  position: point.optional(),
31875
32099
  size: sizeArg.optional(),
@@ -31883,7 +32107,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31883
32107
  const spec = KINDS[args.kind];
31884
32108
  if (!spec) throw new CanvasToolError(`Tipo "${args.kind}" desconhecido. Tipos: ${kindList()}.`);
31885
32109
  const me = await api.me();
31886
- const data = { ...spec.data, ...parseData(args.data), [KIND_FIELD]: args.kind };
32110
+ const input = await withDataFiles(args.data, args.data_files);
32111
+ const data = { ...spec.data, ...parseData(input.data), [KIND_FIELD]: args.kind };
31887
32112
  if (args.label) data.label = args.label;
31888
32113
  if (typeof args.size === "string") data.size = textSizeFor(args.kind, args.size);
31889
32114
  const box = birthBox(args.kind, spec, data, args.size && typeof args.size !== "string" ? boxOf(args.size) : void 0);
@@ -31899,7 +32124,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31899
32124
  if (tab !== void 0) data[TAB_ID_FIELD] = tab;
31900
32125
  const near = args.inputs?.[0] ? doc.nodes[args.inputs[0].from] : args.outputs?.[0] ? doc.nodes[args.outputs[0].to] : void 0;
31901
32126
  const nearTab = near ? homeTabOf(doc, near.id) ?? void 0 : void 0;
31902
- const position = args.position ?? placeFor(doc, box, tab === void 0 ? near : void 0, args.inputs?.[0] ? "right" : "left", tab ?? nearTab);
32127
+ const side = args.inputs?.[0] ? "right" : "left";
32128
+ const position = args.position ?? placeFor(doc, box, tab === void 0 ? near : void 0, side, tab ?? nearTab);
31903
32129
  const zIndex = args.kind === "section" ? SECTION_Z : Object.values(doc.nodes).reduce((t, n) => Math.max(t, n.zIndex), 0) + 1;
31904
32130
  const node = makeNode({ type: WORKFLOW_NODE_TYPE, data, position, size: box, zIndex, createdBy: me });
31905
32131
  const links = [
@@ -31916,11 +32142,12 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31916
32142
  }
31917
32143
  const edges = edgeOps(doc, links, me, /* @__PURE__ */ new Set([node.id]));
31918
32144
  const drawn = edges.ops.flatMap((op) => op.type === "edge.add" ? [op.edge] : []);
31919
- const mention = await mentionOps(doc, [{ node, data: node.data, keys: Object.keys(args.data ?? {}) }], drawn);
32145
+ const mention = await mentionOps(doc, [{ node, data: node.data, keys: Object.keys(input.data) }], drawn);
31920
32146
  return {
31921
32147
  ops: [{ type: "node.add", nodeId: node.id, node }, ...edges.ops, ...mention.ops],
31922
32148
  targets: links.map((l) => l.source === node.id ? l.target : l.source),
31923
- done: `N\xF3 ${args.kind} "${nodeName(node)}" criado: ${node.id}${edges.ops.length ? ` com ${edges.ops.length} liga\xE7\xE3o(\xF5es)` : ""}.${placementNote(doc, node)}${edges.warn}${mention.note}`
32149
+ ...args.position ? {} : { place: { [node.id]: tab !== void 0 ? { tab } : near ? { near: near.id, side } : {} } },
32150
+ done: `N\xF3 ${args.kind} "${nodeName(node)}" criado: ${node.id}${edges.ops.length ? ` com ${edges.ops.length} liga\xE7\xE3o(\xF5es)` : ""}.${placementNote(doc, node)}${edges.warn}${mention.note}${input.note}`
31924
32151
  };
31925
32152
  })
31926
32153
  )
@@ -31929,7 +32156,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31929
32156
  "canvas_update_node",
31930
32157
  {
31931
32158
  title: "Canvas: editar n\xF3",
31932
- description: `Muda campos do data de um n\xF3, chave a chave (null apaga a chave), sem executar. ${READ}label renomeia; position move; size {w, h} muda a caixa (piso: o cart\xE3o cresce com o conte\xFAdo). N\xE3o troca o tipo. Cada chave \xE9 gravada inteira: leia antes com canvas_read_node e mande o valor completo j\xE1 revisado, para n\xE3o apagar o que outra pessoa escreveu. Para mudar partes de uma estrutura grande (clipes da timeline), use canvas_patch_node, por caminho; v\xE1rios n\xF3s de uma vez, canvas_update_nodes. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
32159
+ description: `Muda campos do data de um n\xF3, chave a chave (null apaga a chave), sem executar. ${READ}label renomeia; position move; size {w, h} muda a caixa (piso: o cart\xE3o cresce com o conte\xFAdo). N\xE3o troca o tipo. Cada chave \xE9 gravada inteira: leia antes com canvas_read_node e mande o valor completo j\xE1 revisado, para n\xE3o apagar o que outra pessoa escreveu. Para mudar partes de uma estrutura grande (clipes da timeline) ou gravar texto grande por arquivo, use canvas_patch_node, por caminho; v\xE1rios n\xF3s de uma vez, canvas_update_nodes. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
31933
32160
  inputSchema: {
31934
32161
  board_id: boardId3,
31935
32162
  node_id: nodeIdArg2,
@@ -32009,7 +32236,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32009
32236
  "canvas_patch_node",
32010
32237
  {
32011
32238
  title: "Canvas: gravar por caminho",
32012
- description: `Grava v\xE1rios caminhos dentro do data de um n\xF3, sem executar: {path, value} grava, {path, unset: true} apaga. ${READ}O caminho atravessa objetos (o n\xEDvel que falta \xE9 criado) e n\xE3o entra em lista: para mudar um item de lista, grave a lista inteira. Quebra sozinho em envelopes de at\xE9 64 KB, em ordem, e devolve o resultado de cada um; entre envelopes n\xE3o h\xE1 atomicidade (o que entrou fica). Serve para mexer em partes de uma estrutura grande, como clipes da timeline da Montagem, sem reenviar tudo. Leia antes com canvas_read_node. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
32239
+ description: `Grava v\xE1rios caminhos dentro do data de um n\xF3, sem executar: {path, value} grava, {path, file} grava o texto de um arquivo local, {path, unset: true} apaga. ${READ}${FILE_NOTE}O caminho atravessa objetos (o n\xEDvel que falta \xE9 criado) e n\xE3o entra em lista: para mudar um item de lista, grave a lista inteira. Quebra sozinho em envelopes de at\xE9 64 KB, em ordem, e devolve o resultado de cada um; entre envelopes n\xE3o h\xE1 atomicidade (o que entrou fica). Serve para mexer em partes de uma estrutura grande, como clipes da timeline da Montagem, sem reenviar tudo. Leia antes com canvas_read_node. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
32013
32240
  inputSchema: {
32014
32241
  board_id: boardId3,
32015
32242
  node_id: nodeIdArg2,
@@ -32017,7 +32244,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32017
32244
  external_exports.object({
32018
32245
  path: external_exports.string().trim().min(1).max(500).describe('Caminho dentro do data (ex.: "timeline.meta.fps"); aceita o prefixo "data.".'),
32019
32246
  value: external_exports.unknown().optional().describe("Valor JSON a gravar (null grava null)."),
32020
- unset: external_exports.literal(true).optional().describe("true apaga a chave.")
32247
+ unset: external_exports.literal(true).optional().describe("true apaga a chave."),
32248
+ file: external_exports.string().min(1).max(4096).optional().describe('Arquivo local cujo texto vira o valor, no lugar de value. Ex.: "/tmp/prompt.md". Prefira a digitar texto grande em value.')
32021
32249
  })
32022
32250
  ).min(1).max(5e3)
32023
32251
  },
@@ -32034,6 +32262,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32034
32262
  let absent = 0;
32035
32263
  const mentionKeys = /* @__PURE__ */ new Set();
32036
32264
  let mentionAt = -1;
32265
+ const read = [];
32037
32266
  for (const [i, item] of args.sets.entries()) {
32038
32267
  const at = `sets[${i}] (${item.path})`;
32039
32268
  const segs = dataSegments(item.path);
@@ -32046,7 +32275,10 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32046
32275
  if (MENTION_KEYS.includes(segs[0])) mentionKeys.add(segs[0]);
32047
32276
  const unset = item.unset === true;
32048
32277
  const hasValue = item.value !== void 0;
32049
- if (unset === hasValue) throw new CanvasToolError(`${at}: mande value OU unset: true.`);
32278
+ const hasFile = item.file !== void 0;
32279
+ if ([unset, hasValue, hasFile].filter(Boolean).length !== 1) {
32280
+ throw new CanvasToolError(`${at}: mande s\xF3 um de value, unset: true ou file.`);
32281
+ }
32050
32282
  if (hasValue && !isJson(item.value)) throw new CanvasToolError(`${at}: value n\xE3o \xE9 JSON v\xE1lido.`);
32051
32283
  let cur = work;
32052
32284
  for (const [j, seg] of segs.slice(0, -1).entries()) {
@@ -32081,7 +32313,9 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32081
32313
  if (MENTION_KEYS.includes(segs[0])) mentionAt = ops.length;
32082
32314
  continue;
32083
32315
  }
32084
- const value = item.value;
32316
+ const file = item.file === void 0 ? null : await readTextFile(item.file);
32317
+ if (file) read.push({ path: segs.join("."), ref: item.file, file });
32318
+ const value = file ? file.text : item.value;
32085
32319
  if (cur && Object.hasOwn(cur, leaf) && JSON.stringify(cur[leaf]) === JSON.stringify(value)) {
32086
32320
  same++;
32087
32321
  continue;
@@ -32097,7 +32331,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32097
32331
  return {
32098
32332
  ops,
32099
32333
  targets: [node.id],
32100
- done: `N\xF3 "${oneLine2(nodeName(node), 40)}" (${node.id}): ${written} caminho(s) gravado(s)` + (skipped ? ` (ignorados: ${skipped})` : "") + mention.note
32334
+ done: `N\xF3 "${oneLine2(nodeName(node), 40)}" (${node.id}): ${written} caminho(s) gravado(s)` + (skipped ? ` (ignorados: ${skipped})` : "") + mention.note + describeTextFiles(read)
32101
32335
  };
32102
32336
  },
32103
32337
  { split: true }
@@ -32184,8 +32418,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32184
32418
  inputSchema: { board_id: boardId3, title: external_exports.string().trim().min(1).max(200) },
32185
32419
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
32186
32420
  },
32187
- async ({ board_id, title }) => run(
32188
- () => edit(board_id, async (doc) => ({
32421
+ async ({ board_id: board_id2, title }) => run(
32422
+ () => edit(board_id2, async (doc) => ({
32189
32423
  ops: doc.title === title ? [] : [{ type: "board.set", field: "title", value: setValue(title) }],
32190
32424
  targets: [],
32191
32425
  done: `Board renomeado: "${doc.title}" \u2192 "${title}"`
@@ -32200,8 +32434,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32200
32434
  inputSchema: { board_id: boardId3 },
32201
32435
  annotations: { readOnlyHint: true, openWorldHint: false }
32202
32436
  },
32203
- async ({ board_id }) => run(async () => {
32204
- const members = await api.members(board_id);
32437
+ async ({ board_id: board_id2 }) => run(async () => {
32438
+ const members = await api.members(board_id2);
32205
32439
  return members.map((m) => {
32206
32440
  const name = [m.firstName, m.lastName].filter(Boolean).join(" ") || m.nickname || "(sem nome)";
32207
32441
  return `- ${m.userId} \xB7 ${name} \xB7 ${m.role}`;
@@ -32220,8 +32454,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32220
32454
  },
32221
32455
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
32222
32456
  },
32223
- async ({ board_id, user_id, role }) => run(async () => {
32224
- const r = await api.putMember(board_id, user_id, role);
32457
+ async ({ board_id: board_id2, user_id, role }) => run(async () => {
32458
+ const r = await api.putMember(board_id2, user_id, role);
32225
32459
  return `\u2705 ${r.userId} agora \xE9 ${r.role} no board.`;
32226
32460
  })
32227
32461
  );
@@ -32233,13 +32467,14 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32233
32467
  inputSchema: { board_id: boardId3, user_id: external_exports.string().uuid() },
32234
32468
  annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
32235
32469
  },
32236
- async ({ board_id, user_id }) => run(async () => {
32237
- await api.removeMember(board_id, user_id);
32470
+ async ({ board_id: board_id2, user_id }) => run(async () => {
32471
+ await api.removeMember(board_id2, user_id);
32238
32472
  return `\u2705 ${user_id} n\xE3o tem mais acesso ao board.`;
32239
32473
  })
32240
32474
  );
32241
32475
  registerCanvasCommentTools(server, api, run);
32242
32476
  registerCanvasMediaTools(server, { api, cfg, run, edit, seen, placeFor });
32477
+ registerCanvasLockTools(server, { api, run });
32243
32478
  registerCanvasLayoutTools(server, { api, run, edit });
32244
32479
  registerCanvasRunTools(server, api, run);
32245
32480
  registerCanvasFocusTools(server, api, run);
@@ -32249,7 +32484,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32249
32484
  import { createRequire } from "module";
32250
32485
  var require2 = createRequire(import.meta.url);
32251
32486
  function readVersion() {
32252
- if ("0.46.0") return "0.46.0";
32487
+ if ("0.49.0") return "0.49.0";
32253
32488
  try {
32254
32489
  const pkg = require2("../package.json");
32255
32490
  return pkg.version ?? "0.0.0-unknown";
@@ -32264,7 +32499,7 @@ var SERVER_INSTRUCTIONS = [
32264
32499
  "BePlus: tudo roda pela conta do usu\xE1rio (diamantes, limites e hist\xF3rico na plataforma).",
32265
32500
  'M\xEDdia: generate_* e elevenlabs_* gastam diamantes; confira com estimate_cost antes de lotes grandes. Sem project, a gera\xE7\xE3o cai no projeto ativo; billing:"personal" cobra do usu\xE1rio.',
32266
32501
  "Calls: search_calls acha, get_call traz a transcri\xE7\xE3o.",
32267
- "Canvas online (canvas_*): leia com canvas_read_board antes de editar e siga o estado lido. Cada edi\xE7\xE3o vai num passo s\xF3; se outra pessoa mexeu nos mesmos n\xF3s, a ferramenta recusa e pede releitura. As canvas_* n\xE3o geram m\xEDdia, exceto canvas_run: roda n\xF3s pela aba do Canvas aberta do usu\xE1rio e gasta diamantes; max_diamonds \xE9 o teto que o usu\xE1rio autorizou (dry_run s\xF3 estima). D\xEA nome (label) aos n\xF3s, n\xE3o invente tipos nem portas, e confirme antes de canvas_delete.",
32502
+ "Canvas online (canvas_*): leia com canvas_read_board antes de editar e siga o estado lido. Cada edi\xE7\xE3o vai num passo s\xF3; se outra pessoa mexeu nos mesmos n\xF3s, a ferramenta recusa e pede releitura. As canvas_* n\xE3o geram m\xEDdia, exceto canvas_run: roda n\xF3s no servidor e gasta diamantes; max_diamonds \xE9 o teto que o usu\xE1rio autorizou (dry_run s\xF3 estima). D\xEA nome (label) aos n\xF3s, n\xE3o invente tipos nem portas, e confirme antes de canvas_delete.",
32268
32503
  "Cada aba \xE9 um plano: ao criar, passe aba (id da se\xE7\xE3o) em canvas_add_node e canvas_upload_media, sen\xE3o o cart\xE3o pode cair em Avulsos. canvas_read_board com aba l\xEA uma aba s\xF3.",
32269
32504
  'Mostrar algo ao usu\xE1rio ("olha aqui"): canvas_focus leva a aba do Canvas que ele est\xE1 olhando at\xE9 os n\xF3s e os seleciona uma vez, sem prender a aba, sem gasto e sem escrita no board. follow: true prende a aba na \xE1rea at\xE9 o \xD7: s\xF3 se ele pedir.',
32270
32505
  'Arrumar o board: o size gravado \xE9 piso (o cart\xE3o cresce com o conte\xFAdo); use o tamanho "medido" do canvas_read_board. \xC1rea de revis\xE3o: canvas_arrange_rows (uma linha por vers\xE3o); posi\xE7\xE3o/tamanho em lote: canvas_update_nodes com layout_only. N\xE3o afirme que nada se sobrep\xF5e com n\xF3 sem medida.',