beplus-mcp 0.47.0 → 0.50.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
@@ -25039,6 +25039,8 @@ function outputUrls(status) {
25039
25039
  function mimeFromUrl(url) {
25040
25040
  const u = url.toLowerCase();
25041
25041
  if (u.includes(".webp")) return "image/webp";
25042
+ if (u.includes(".gif")) return "image/gif";
25043
+ if (u.includes(".svg")) return "image/svg+xml";
25042
25044
  if (u.includes(".jpg") || u.includes(".jpeg")) return "image/jpeg";
25043
25045
  return "image/png";
25044
25046
  }
@@ -25051,6 +25053,7 @@ async function buildImageBlocks(urls, cfg) {
25051
25053
  if (!res.ok) continue;
25052
25054
  const mimeType = res.headers.get("content-type") || mimeFromUrl(url);
25053
25055
  if (!mimeType.startsWith("image/")) continue;
25056
+ if (mimeType.startsWith("image/svg")) continue;
25054
25057
  const buf = Buffer.from(await res.arrayBuffer());
25055
25058
  if (buf.byteLength > cfg.inlineImageMaxBytes) continue;
25056
25059
  blocks.push({ type: "image", data: buf.toString("base64"), mimeType });
@@ -25066,13 +25069,25 @@ var IMAGE_MODELS = [
25066
25069
  "google/nano-banana-2.1",
25067
25070
  "google/nano-banana-2",
25068
25071
  "google/nano-banana-pro",
25072
+ "openai/gpt-image-2.6-flare",
25073
+ "openai/gpt-image-2.6-sunburst",
25069
25074
  "openai/gpt-image-2",
25070
- "openai/gpt-image-1",
25071
25075
  "bytedance/seedream-5.0-lite",
25072
25076
  "bytedance/seedream-5.0-pro",
25073
25077
  "bytedance/seedream-5.0-pro-layers",
25074
25078
  "midjourney"
25075
25079
  ];
25080
+ var GPT_IMAGE_26_MODELS = ["openai/gpt-image-2.6-flare", "openai/gpt-image-2.6-sunburst"];
25081
+ var GPT_IMAGE_FORMATS = ["png", "jpeg", "webp", "gif", "svg"];
25082
+ var GIF_FRAMES = { min: 2, max: 16, default: 9 };
25083
+ var GIF_FRAME_MS = { min: 20, max: 2e3, default: 200 };
25084
+ var GIF_MAX_FRAMES_BY_SIZE = {
25085
+ "512x512": 16,
25086
+ "512x768": 16,
25087
+ "768x512": 16,
25088
+ "768x768": 12
25089
+ };
25090
+ var GIF_DEFAULT_SIZE = "512x512";
25076
25091
  var SEEDREAM_LITE_SIZES = ["2K", "3K", "4K"];
25077
25092
  var SEEDREAM_PRO_SIZES = ["1K", "1.5K", "2K"];
25078
25093
  var SEEDREAM_PRO_PIXELS = { min: 921600, max: 4624220 };
@@ -25737,7 +25752,7 @@ ${voiceLine(voice)}`);
25737
25752
  "Cria um efeito sonoro a partir de uma descri\xE7\xE3o (porta batendo, chuva, whoosh). Para trilha musical use elevenlabs_music.",
25738
25753
  {
25739
25754
  text: external_exports.string().min(1).describe("Descri\xE7\xE3o do som."),
25740
- model: modelField("eleven_text_to_sound_v2"),
25755
+ model: modelField("eleven_text_to_sound_v3"),
25741
25756
  duration_sec: external_exports.number().positive().optional().describe("De 0,5 a 30 s. Omita para o modelo decidir."),
25742
25757
  loop: external_exports.boolean().optional().describe("true faz o som emendar sem corte."),
25743
25758
  prompt_influence: external_exports.number().min(0).max(1).optional().describe("Quanto seguir a descri\xE7\xE3o ao p\xE9 da letra.")
@@ -25861,6 +25876,63 @@ ${voiceLine(voice)}`);
25861
25876
  );
25862
25877
  }
25863
25878
 
25879
+ // src/tools/gpt-image.ts
25880
+ function isGptImage26(model) {
25881
+ return GPT_IMAGE_26_MODELS.includes(model);
25882
+ }
25883
+ var gifSizes = () => Object.keys(GIF_MAX_FRAMES_BY_SIZE).join(", ");
25884
+ function validateGptImage(args) {
25885
+ const is26 = isGptImage26(args.model);
25886
+ const format = args.output_format;
25887
+ const isGif = format === "gif";
25888
+ const isSvg = format === "svg";
25889
+ if ((isGif || isSvg) && !is26) {
25890
+ return `${args.model} n\xE3o gera ${isGif ? "GIF" : "SVG"}. Use openai/gpt-image-2.6-flare (R\xE1pido) ou openai/gpt-image-2.6-sunburst (Detalhado).`;
25891
+ }
25892
+ if (!isGif && (args.frame_count !== void 0 || args.frame_duration_ms !== void 0)) {
25893
+ return 'frame_count e frame_duration_ms s\xF3 valem com output_format: "gif".';
25894
+ }
25895
+ if (args.background === "transparent") {
25896
+ if (!is26) {
25897
+ return `${args.model} n\xE3o faz fundo transparente. Use openai/gpt-image-2.6-flare (R\xE1pido) ou openai/gpt-image-2.6-sunburst (Detalhado) com output_format png ou webp.`;
25898
+ }
25899
+ if (isSvg) return "O SVG j\xE1 sai com fundo transparente. Tire o background do pedido.";
25900
+ if (format && format !== "png" && format !== "webp") {
25901
+ return `Fundo transparente exige output_format png ou webp (${format} n\xE3o tem canal alpha).`;
25902
+ }
25903
+ }
25904
+ if (isGif) {
25905
+ const size = args.size ?? GIF_DEFAULT_SIZE;
25906
+ const maxFrames = GIF_MAX_FRAMES_BY_SIZE[size];
25907
+ if (maxFrames === void 0) {
25908
+ return `GIF aceita size ${gifSizes()} (voc\xEA pediu ${size}). Em GIF n\xE3o existe 1024 nem auto.`;
25909
+ }
25910
+ const frames = args.frame_count ?? GIF_FRAMES.default;
25911
+ if (frames > maxFrames) {
25912
+ return `GIF em ${size} aceita at\xE9 ${maxFrames} quadros (voc\xEA pediu ${frames}). Diminua frame_count.`;
25913
+ }
25914
+ if (args.output_compression !== void 0) return "GIF n\xE3o aceita output_compression.";
25915
+ }
25916
+ if (isSvg && args.output_compression !== void 0) return "SVG n\xE3o aceita output_compression.";
25917
+ return null;
25918
+ }
25919
+ function gptImageInput(args) {
25920
+ if (args.output_format !== "gif") return {};
25921
+ return {
25922
+ size: args.size ?? GIF_DEFAULT_SIZE,
25923
+ frame_count: args.frame_count ?? GIF_FRAMES.default,
25924
+ frame_duration_ms: args.frame_duration_ms ?? GIF_FRAME_MS.default
25925
+ };
25926
+ }
25927
+ function outputLabel(format) {
25928
+ if (format === "gif") return "GIF animado gerado";
25929
+ if (format === "svg") return "SVG (vetor) gerado";
25930
+ return "Imagem gerada";
25931
+ }
25932
+ function outputNote(format) {
25933
+ return format === "svg" ? "Abra pelo link: \xE9 um arquivo vetorial, n\xE3o uma imagem em pixels.\n" : "";
25934
+ }
25935
+
25864
25936
  // src/tools/generation.ts
25865
25937
  var IMAGE_BUDGET_MS = 9e4;
25866
25938
  var VIDEO_BUDGET_MS = 12e4;
@@ -25888,7 +25960,7 @@ function registerGenerationTools(server, client, cfg) {
25888
25960
  "generate_image",
25889
25961
  {
25890
25962
  title: "Gerar imagem",
25891
- description: "Gera uma imagem a partir de um prompt usando o IA Lab da BePlus. R\xE1pido (~10-30s). Consome diamantes da conta vinculada. Apenas `prompt` \xE9 obrigat\xF3rio; passe `reference_images` (URLs p\xFAblicas OU caminhos de arquivo local \u2014 o MCP sobe pro R2 automaticamente) para image-to-image. Veja custos com estimate_cost / list_models." + TEAM_GATING_NOTE,
25963
+ description: 'Gera uma imagem a partir de um prompt usando o IA Lab da BePlus. R\xE1pido (~10-30s). Consome diamantes da conta vinculada. Apenas `prompt` \xE9 obrigat\xF3rio; passe `reference_images` (URLs p\xFAblicas OU caminhos de arquivo local \u2014 o MCP sobe pro R2 automaticamente) para image-to-image. Veja custos com estimate_cost / list_models. GPT Image 2.6: use o R\xE1pido (openai/gpt-image-2.6-flare) para iterar e o Detalhado (openai/gpt-image-2.6-sunburst) para a vers\xE3o final ou edi\xE7\xE3o fiel de uma refer\xEAncia. Os dois fazem fundo transparente (background "transparent" com png ou webp), GIF animado (output_format "gif", de 2 a 16 quadros, quadro de 512 ou 768: 512x512, 512x768, 768x512 ou 768x768; em GIF n\xE3o existe 1024) e SVG vetorial (output_format "svg"). GIF e SVG aceitam refer\xEAncia.' + TEAM_GATING_NOTE,
25892
25964
  inputSchema: {
25893
25965
  // Sem teto local: quem conhece o limite de cada provedor é o backend, e
25894
25966
  // ele responde com quanto reduzir. Um `.max()` aqui rejeitava prompts
@@ -25897,22 +25969,22 @@ function registerGenerationTools(server, client, cfg) {
25897
25969
  'Descri\xE7\xE3o da imagem desejada. No seedream-5.0-pro-layers \xE9 opcional: diga o que separar (ex.: "o produto, o texto e o fundo") ou deixe vazio para o modelo escolher.'
25898
25970
  ),
25899
25971
  model: external_exports.enum(IMAGE_MODELS).default(DEFAULTS.imageModel).describe(
25900
- "nano-banana-2.1 = padr\xE3o, o mais novo e o mais barato do Google (metade do 2, texto mais n\xEDtido); nano-banana-2 = vers\xE3o anterior, mesmo comportamento; nano-banana-pro = melhor qualidade; gpt-image-2 = OpenAI; gpt-image-1 = OpenAI, \xDANICO que faz fundo transparente de verdade (PNG/WebP com alpha) \u2014 o gpt-image-2 N\xC3O faz, use este pra recorte/sticker; seedream-5.0-lite = mais barato do cat\xE1logo, \xFAnico que chega a 4K, gera s\xE9ries e mant\xE9m o ESTILO da imagem de refer\xEAncia; seedream-5.0-pro = acabamento fotorrealista, s\xF3 at\xE9 2K (1K/1.5K/2K, propor\xE7\xE3o, tamanho livre e at\xE9 4 imagens por pedido) \u2014 preserva o personagem da refer\xEAncia mas costuma reinterpretar o estilo (um vetor flat volta em 3D); seedream-5.0-pro-layers = N\xC3O gera do zero: separa UMA imagem (reference_images com 1 item) em base + at\xE9 16 camadas PNG transparentes do mesmo tamanho, prontas para empilhar ou virar PSD. Cobra o teto de 17 imagens e estorna as que n\xE3o vierem."
25972
+ "nano-banana-2.1 = padr\xE3o, o mais novo e o mais barato do Google (metade do 2, texto mais n\xEDtido); nano-banana-2 = vers\xE3o anterior, mesmo comportamento; nano-banana-pro = melhor qualidade; gpt-image-2.6-flare = GPT Image 2.6 R\xE1pido, bom para iterar; gpt-image-2.6-sunburst = GPT Image 2.6 Detalhado, mais detalhe e edi\xE7\xE3o fiel da refer\xEAncia; os dois 2.6 fazem fundo transparente de verdade (recorte, sticker), GIF animado e SVG; gpt-image-2 = OpenAI anterior, sem transpar\xEAncia, GIF nem SVG; seedream-5.0-lite = mais barato do cat\xE1logo, \xFAnico que chega a 4K, gera s\xE9ries e mant\xE9m o ESTILO da imagem de refer\xEAncia; seedream-5.0-pro = acabamento fotorrealista, s\xF3 at\xE9 2K (1K/1.5K/2K, propor\xE7\xE3o, tamanho livre e at\xE9 4 imagens por pedido) \u2014 preserva o personagem da refer\xEAncia mas costuma reinterpretar o estilo (um vetor flat volta em 3D); seedream-5.0-pro-layers = N\xC3O gera do zero: separa UMA imagem (reference_images com 1 item) em base + at\xE9 16 camadas PNG transparentes do mesmo tamanho, prontas para empilhar ou virar PSD. Cobra o teto de 17 imagens e estorna as que n\xE3o vierem."
25901
25973
  ),
25902
25974
  aspect_ratio: external_exports.enum(ASPECT_RATIOS).optional().describe(
25903
25975
  "Propor\xE7\xE3o. nano-banana: padr\xE3o 1:1. Seedream Pro: combina com size (1K/1.5K/2K) e vira LARGURAxALTURA no backend; sem ela o modelo escolhe o formato pelo prompt."
25904
25976
  ),
25905
25977
  resolution: external_exports.enum(IMAGE_RESOLUTIONS).optional().describe("Resolu\xE7\xE3o (nano-banana): 1K/2K/4K. Padr\xE3o 1K."),
25906
25978
  reference_images: external_exports.array(external_exports.string().min(1)).max(16).optional().describe(
25907
- "Imagens de refer\xEAncia (image-to-image): URL p\xFAblica OU caminho de arquivo local (o MCP faz upload pro R2 automaticamente). At\xE9 14 (nano-banana) / 16 (gpt-image-1/2)."
25979
+ "Imagens de refer\xEAncia (image-to-image): URL p\xFAblica OU caminho de arquivo local (o MCP faz upload pro R2 automaticamente). At\xE9 14 (nano-banana) / 16 (gpt-image-2 e 2.6). No 2.6 vale para todos os formatos, inclusive gif e svg."
25908
25980
  ),
25909
25981
  google_search: external_exports.boolean().optional().describe("nano-banana-2.1 e 2: aterra a imagem em busca web do Google (fatos atuais). Padr\xE3o false."),
25910
25982
  image_search: external_exports.boolean().optional().describe("nano-banana-2.1 e 2: usa busca de imagens do Google como refer\xEAncia visual. Padr\xE3o false."),
25911
25983
  size: external_exports.union([
25912
- external_exports.enum(["1024x1024", "1536x1024", "1024x1536", "auto", "1K", "1.5K", "2K", "3K", "4K"]),
25984
+ external_exports.enum(["1024x1024", "1536x1024", "1024x1536", "auto", "512x512", "512x768", "768x512", "768x768", "1K", "1.5K", "2K", "3K", "4K"]),
25913
25985
  external_exports.string().regex(/^\d{3,5}x\d{3,5}$/, "use LARGURAxALTURA, ex.: 2048x1152")
25914
25986
  ]).optional().describe(
25915
- "Tamanho. gpt-image-1/2: 1024x1024/1536x1024/1024x1536/auto. Seedream Lite: 2K/3K/4K (padr\xE3o 2K). Seedream Pro: 1K/1.5K/2K ou LARGURAxALTURA livre (\xE1rea entre 921.600 e 4.624.220 pixels, propor\xE7\xE3o de 1:16 a 16:1). O Pro N\xC3O faz 3K/4K."
25987
+ "Tamanho. gpt-image-2 e 2.6: 1024x1024/1536x1024/1024x1536/auto. GIF do 2.6: 512x512 (padr\xE3o), 512x768, 768x512 ou 768x768; 1024 e auto n\xE3o existem em GIF. Seedream Lite: 2K/3K/4K (padr\xE3o 2K). Seedream Pro: 1K/1.5K/2K ou LARGURAxALTURA livre (\xE1rea entre 921.600 e 4.624.220 pixels, propor\xE7\xE3o de 1:16 a 16:1). O Pro N\xC3O faz 3K/4K."
25916
25988
  ),
25917
25989
  num_images: external_exports.number().int().min(1).max(SEEDREAM_PRO_MAX_IMAGES).optional().describe(
25918
25990
  "Seedream 5.0 PRO apenas: quantas imagens gerar no mesmo pedido (1-4), em chamadas paralelas. Cada imagem \xE9 cobrada; as que falharem s\xE3o estornadas."
@@ -25920,13 +25992,21 @@ function registerGenerationTools(server, client, cfg) {
25920
25992
  batch_images: external_exports.number().int().min(2).max(15).optional().describe(
25921
25993
  "Seedream 5.0 LITE apenas: gera uma s\xE9rie de imagens relacionadas numa chamada (2-15). Cada imagem \xE9 cobrada. O Seedream Pro N\xC3O suporta \u2014 passar aqui devolve erro."
25922
25994
  ),
25923
- quality: external_exports.enum(["low", "medium", "high", "auto"]).optional().describe("Qualidade (gpt-image-1/2)."),
25995
+ quality: external_exports.enum(["low", "medium", "high", "auto"]).optional().describe("Qualidade (gpt-image-2 e 2.6)."),
25924
25996
  background: external_exports.enum(["opaque", "transparent", "auto"]).optional().describe(
25925
- "Fundo (gpt-image-1/2). `transparent` S\xD3 funciona no gpt-image-1 e s\xF3 com output_format png/webp \u2014 o gpt-image-2 rejeita (limita\xE7\xE3o do modelo na OpenAI, n\xE3o d\xE1 pra contornar por prompt). Padr\xE3o opaque."
25997
+ "Fundo (gpt-image-2 e 2.6). `transparent` s\xF3 nos modelos 2.6 e s\xF3 com output_format png ou webp. O gpt-image-2 recusa, e pedir transpar\xEAncia pelo prompt faz o modelo desenhar o xadrez. O SVG j\xE1 sai transparente."
25926
25998
  ),
25927
- moderation: external_exports.enum(["low", "auto"]).optional().describe("Modera\xE7\xE3o (gpt-image-1/2). Padr\xE3o low."),
25928
- output_format: external_exports.enum(["png", "jpeg", "webp"]).optional().describe("Formato de sa\xEDda (gpt-image-1/2). Padr\xE3o png."),
25929
- output_compression: external_exports.number().int().min(0).max(100).optional().describe("Compress\xE3o 0-100 (gpt-image-1/2, s\xF3 jpeg/webp). Padr\xE3o 90."),
25999
+ moderation: external_exports.enum(["low", "auto"]).optional().describe("Modera\xE7\xE3o (gpt-image-2 e 2.6). Padr\xE3o low."),
26000
+ output_format: external_exports.enum(GPT_IMAGE_FORMATS).optional().describe(
26001
+ "Formato de sa\xEDda. png (padr\xE3o), jpeg e webp em gpt-image-2 e 2.6. gif = GIF animado e svg = vetor, s\xF3 nos modelos 2.6."
26002
+ ),
26003
+ frame_count: external_exports.number().int().min(GIF_FRAMES.min).max(GIF_FRAMES.max).optional().describe(
26004
+ `GIF do 2.6: quantos quadros (${GIF_FRAMES.min} a ${GIF_FRAMES.max}, padr\xE3o ${GIF_FRAMES.default}). Em 768x768 v\xE3o at\xE9 12; nos outros tamanhos de GIF, at\xE9 16.`
26005
+ ),
26006
+ frame_duration_ms: external_exports.number().int().min(GIF_FRAME_MS.min).max(GIF_FRAME_MS.max).optional().describe(
26007
+ `GIF do 2.6: dura\xE7\xE3o de cada quadro em ms (${GIF_FRAME_MS.min} a ${GIF_FRAME_MS.max}, padr\xE3o ${GIF_FRAME_MS.default}).`
26008
+ ),
26009
+ output_compression: external_exports.number().int().min(0).max(100).optional().describe("Compress\xE3o 0-100 (gpt-image-2 e 2.6, s\xF3 jpeg/webp). Padr\xE3o 90."),
25930
26010
  seed: external_exports.number().int().optional(),
25931
26011
  // ── Midjourney (model="midjourney") — params completos ──
25932
26012
  version: external_exports.enum(["8.1", "7", "6.1", "6", "niji-7", "niji-6"]).optional().describe("Midjourney: vers\xE3o (padr\xE3o 8.1). --oref (character_reference) for\xE7a V7; --cref for\xE7a V6; anime = niji-7."),
@@ -26014,16 +26094,8 @@ function registerGenerationTools(server, client, cfg) {
26014
26094
  "num_images s\xF3 existe no bytedance/seedream-5.0-pro. No seedream-5.0-lite use batch_images; nos outros modelos, chame generate_image mais vezes."
26015
26095
  );
26016
26096
  }
26017
- if (args.background === "transparent") {
26018
- if (args.model !== "openai/gpt-image-1") {
26019
- return errorResult(
26020
- `${args.model} n\xE3o suporta fundo transparente. S\xF3 o openai/gpt-image-1 devolve PNG/WebP com canal alpha de verdade \u2014 troque o model.`
26021
- );
26022
- }
26023
- if (args.output_format === "jpeg") {
26024
- return errorResult("Fundo transparente exige output_format png ou webp \u2014 JPEG n\xE3o tem canal alpha.");
26025
- }
26026
- }
26097
+ const gptRefusal = validateGptImage(args);
26098
+ if (gptRefusal) return errorResult(gptRefusal);
26027
26099
  const reference_images = await resolveRefs(cfg, args.reference_images);
26028
26100
  let style_reference;
26029
26101
  if (isMidjourney && args.style_reference) {
@@ -26049,6 +26121,7 @@ function registerGenerationTools(server, client, cfg) {
26049
26121
  moderation: args.moderation,
26050
26122
  output_format: args.output_format,
26051
26123
  output_compression: args.output_compression,
26124
+ ...isGptImage26(args.model) ? gptImageInput(args) : {},
26052
26125
  seed: args.seed,
26053
26126
  // Midjourney full-params
26054
26127
  version: args.version,
@@ -26093,9 +26166,12 @@ ${footer}`);
26093
26166
  const blocks = await buildImageBlocks(urls, cfg);
26094
26167
  const list = urls.map((u, i) => `${i + 1}. ${u}`).join("\n") || "(sem URLs)";
26095
26168
  return {
26096
- content: [{ type: "text", text: `\u2705 Imagem gerada (${args.model}).
26169
+ content: [
26170
+ { type: "text", text: `\u2705 ${outputLabel(args.output_format)} (${args.model}).
26097
26171
  ${list}
26098
- ${footer}` }, ...blocks]
26172
+ ${outputNote(args.output_format)}${footer}` },
26173
+ ...blocks
26174
+ ]
26099
26175
  };
26100
26176
  } catch (e) {
26101
26177
  const msg = e instanceof ApiError ? e.message : e instanceof Error ? e.message : "";
@@ -27466,13 +27542,15 @@ Limites simult\xE2neos por usu\xE1rio: imagem=${m.limits.perUserMaxImage}, v\xED
27466
27542
  title: "Estimar custo",
27467
27543
  description: "Retorna o custo autoritativo em diamantes ANTES de gerar. Para \xE1udio (TTS) o custo \xE9 por segundo e s\xF3 \xE9 conhecido ap\xF3s a s\xEDntese. ElevenLabs: model = elevenlabs/<ferramenta>[/<modelo>], os campos da gera\xE7\xE3o em elevenlabs_params e o arquivo em file (ou dry_run: true na pr\xF3pria ferramenta elevenlabs_*).",
27468
27544
  inputSchema: {
27469
- model: external_exports.string().min(1).describe("Id do modelo (ex.: google/nano-banana-pro, bytedance/seedance-2.0)."),
27545
+ model: external_exports.string().min(1).describe("Id do modelo (ex.: google/nano-banana-pro, openai/gpt-image-2.6-flare, bytedance/seedance-2.0)."),
27470
27546
  elevenlabs_params: external_exports.record(external_exports.unknown()).optional().describe('[ElevenLabs] Campos do pedido no formato da API, ex.: { "voice": "...", "text": "..." }.'),
27471
27547
  resolution: external_exports.string().optional(),
27472
27548
  duration: external_exports.number().int().optional(),
27473
27549
  mode: external_exports.string().optional(),
27474
27550
  size: external_exports.string().optional(),
27475
27551
  quality: external_exports.string().optional(),
27552
+ output_format: external_exports.enum(["png", "jpeg", "webp", "gif", "svg"]).optional().describe("[GPT Image 2.6] gif e svg t\xEAm pre\xE7o pr\xF3prio. Use com o mesmo size do pedido."),
27553
+ frame_count: external_exports.number().int().min(2).max(16).optional().describe("[GPT Image 2.6, gif] Quadros do GIF."),
27476
27554
  aspect_ratio: external_exports.string().optional().describe("Seedream Pro: a propor\xE7\xE3o muda os pixels e a faixa de pre\xE7o."),
27477
27555
  num_images: external_exports.number().int().min(1).optional().describe("Seedream Pro: imagens por pedido; cada uma \xE9 cobrada."),
27478
27556
  task_type: external_exports.string().optional().describe('[m\xFAsica] extend e upload_extend usam o pre\xE7o "suno/extend"; os demais, o do modelo.'),
@@ -27521,6 +27599,8 @@ Limites simult\xE2neos por usu\xE1rio: imagem=${m.limits.perUserMaxImage}, v\xED
27521
27599
  mode: args.mode,
27522
27600
  size: args.size,
27523
27601
  quality: args.quality,
27602
+ output_format: args.output_format,
27603
+ frame_count: args.frame_count,
27524
27604
  aspect_ratio: args.aspect_ratio,
27525
27605
  num_images: args.num_images,
27526
27606
  seedance_provider: args.provider === "fal" ? "fal" : void 0,
@@ -27862,11 +27942,21 @@ ${calls.map(callLine).join("\n\n")}`);
27862
27942
  }
27863
27943
 
27864
27944
  // src/tools/canvas.ts
27865
- import { createHash as createHash2 } from "crypto";
27945
+ import { createHash as createHash3 } from "crypto";
27866
27946
 
27867
27947
  // src/canvas/api.ts
27868
27948
  import { createHash } from "crypto";
27869
27949
  var import_canvas_core = __toESM(require_canvas_core(), 1);
27950
+
27951
+ // src/canvas/tab-locks.ts
27952
+ var MINUTE = 6e4;
27953
+ function describeLock(lock, now = Date.now()) {
27954
+ const minutes = Math.max(1, Math.ceil((Date.parse(lock.expiresAt) - now) / MINUTE));
27955
+ const doing = lock.label ? `, "${lock.label}"` : "";
27956
+ 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`;
27957
+ }
27958
+
27959
+ // src/canvas/api.ts
27870
27960
  var PINNED_CORE_VERSION = "ca7b3b406184c7f679f555c3a008013197182b23";
27871
27961
  var RUN_REQUEST_TIMEOUT_MS = 4e4;
27872
27962
  var FOCUS_REQUEST_TIMEOUT_MS = 12e3;
@@ -27977,6 +28067,27 @@ var CanvasApi = class {
27977
28067
  boardLoads.set(loadKey, load);
27978
28068
  return load;
27979
28069
  }
28070
+ /**
28071
+ * Só estes nós. Com o board em cache, o delta já resolve e custa menos que a rota; sem cache, a
28072
+ * rota evita baixar o board inteiro. 404 pode ser servidor antigo: a foto decide se o board existe.
28073
+ */
28074
+ async readNodes(boardId4, ids) {
28075
+ if (!boardStore.has(this.cacheKey(boardId4))) {
28076
+ try {
28077
+ return await this.req("GET", `/boards/${boardId4}/nodes`, { query: { ids: ids.join(",") } });
28078
+ } catch (e) {
28079
+ if (!(e instanceof ApiError) || e.httpStatus !== 404) throw e;
28080
+ }
28081
+ }
28082
+ const snap = await this.snapshot(boardId4);
28083
+ const known = ids.filter((id) => Object.hasOwn(snap.doc.nodes, id));
28084
+ return {
28085
+ title: snap.title,
28086
+ seq: snap.seq,
28087
+ nodes: Object.fromEntries(known.map((id) => [id, snap.doc.nodes[id]])),
28088
+ missing: ids.filter((id) => !known.includes(id))
28089
+ };
28090
+ }
27980
28091
  async load(boardId4, key, needRuns) {
27981
28092
  const entry = boardStore.get(key);
27982
28093
  if (entry && !needRuns && this.coreVersion === PINNED_CORE_VERSION) {
@@ -28074,8 +28185,26 @@ var CanvasApi = class {
28074
28185
  }
28075
28186
  throw again;
28076
28187
  }
28188
+ } finally {
28189
+ const entry = boardStore.get(this.cacheKey(boardId4));
28190
+ if (entry) entry.checkedAt = -Infinity;
28191
+ }
28192
+ }
28193
+ tabLocks(boardId4) {
28194
+ return this.req("GET", `/boards/${boardId4}/tab-locks`);
28195
+ }
28196
+ async lockTab(boardId4, tabId, session, label) {
28197
+ try {
28198
+ return await this.req("PUT", `/boards/${boardId4}/tabs/${encodeURIComponent(tabId)}/lock`, { body: { session, label } });
28199
+ } catch (e) {
28200
+ const raw = errorRaw(e);
28201
+ if (raw?.reason !== "tab-locked" || !raw.lockedBy) throw e;
28202
+ throw new CanvasToolError(`N\xE3o travou: ${describeLock(raw.lockedBy)}.`);
28077
28203
  }
28078
28204
  }
28205
+ unlockTab(boardId4, tabId, session) {
28206
+ return this.req("DELETE", `/boards/${boardId4}/tabs/${encodeURIComponent(tabId)}/lock`, { query: { session } });
28207
+ }
28079
28208
  members(boardId4) {
28080
28209
  return this.req("GET", `/boards/${boardId4}/members`);
28081
28210
  }
@@ -29077,15 +29206,15 @@ function rowsLines(rows) {
29077
29206
  if (rows.length > MAX_BLOCKS) out.push(` \xB7 \u2026 +${rows.length - MAX_BLOCKS} linhas`);
29078
29207
  return out;
29079
29208
  }
29080
- function nodeLines(node, run, aba) {
29209
+ function nodeLines(node, run, aba2) {
29081
29210
  const kind = nodeKind(node);
29082
29211
  const spec = kind ? KINDS[kind] : void 0;
29083
- const head = `- ${node.id} \xB7 ${kind ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" @(${Math.round(node.position.x)},${Math.round(node.position.y)}) ${sizeLabel(node)}` + (aba ? ` \xB7 aba=${aba}` : "");
29212
+ const head = `- ${node.id} \xB7 ${kind ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" @(${Math.round(node.position.x)},${Math.round(node.position.y)}) ${sizeLabel(node)}` + (aba2 ? ` \xB7 aba=${aba2}` : "");
29084
29213
  const facts = [];
29085
29214
  const extra = [];
29086
29215
  const d = node.data;
29087
29216
  if (d.archived) facts.push("ARQUIVADO");
29088
- if (aba && isTabSection(node)) facts.push("\xE9 aba");
29217
+ if (aba2 && isTabSection(node)) facts.push("\xE9 aba");
29089
29218
  const approval = d.approval?.state;
29090
29219
  if (typeof approval === "string") facts.push(`aprova\xE7\xE3o: ${approval}`);
29091
29220
  if (Array.isArray(d.history)) facts.push(`${d.history.length} gera\xE7\xE3o(\xF5es)`);
@@ -29110,7 +29239,7 @@ function nodeLines(node, run, aba) {
29110
29239
  for (const [key, value] of Object.entries(d)) {
29111
29240
  if (NAME_KEYS.has(key) || HEAVY_KEYS.has(key) || key === main2) continue;
29112
29241
  if (["blocks", "rows", "items", "archived", "approval"].includes(key)) continue;
29113
- if (aba && (key === TAB_ID_FIELD || key === TAB_FIELD && isTabSection(node))) continue;
29242
+ if (aba2 && (key === TAB_ID_FIELD || key === TAB_FIELD && isTabSection(node))) continue;
29114
29243
  const s = scalar(value);
29115
29244
  if (s !== null) facts.push(`${key}=${s}`);
29116
29245
  else if (Array.isArray(value)) facts.push(`${key}=[${value.length}]`);
@@ -29440,9 +29569,9 @@ function registerCanvasCommentTools(server, api, run) {
29440
29569
  },
29441
29570
  annotations: { readOnlyHint: true, openWorldHint: false }
29442
29571
  },
29443
- async ({ board_id, status }) => run(async () => {
29572
+ async ({ board_id: board_id2, status }) => run(async () => {
29444
29573
  const st = status ?? "open";
29445
- const [snap, threads] = await Promise.all([api.snapshot(board_id), api.listComments(board_id, st)]);
29574
+ const [snap, threads] = await Promise.all([api.snapshot(board_id2), api.listComments(board_id2, st)]);
29446
29575
  const text = commentsSummary(threads, snap.doc, st);
29447
29576
  const open3 = threads.some((t) => !t.resolvedAt);
29448
29577
  return open3 ? `${text}
@@ -29458,9 +29587,9 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
29458
29587
  inputSchema: { board_id: boardId, comment_id: commentId, body, mentions },
29459
29588
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
29460
29589
  },
29461
- async ({ board_id, comment_id, body: text, mentions: m }) => run(async () => {
29590
+ async ({ board_id: board_id2, comment_id, body: text, mentions: m }) => run(async () => {
29462
29591
  const thread = await onComment(
29463
- () => api.createComment(board_id, { body: text, parentId: comment_id, ...m?.length ? { mentions: m } : {} })
29592
+ () => api.createComment(board_id2, { body: text, parentId: comment_id, ...m?.length ? { mentions: m } : {} })
29464
29593
  );
29465
29594
  const open3 = thread?.resolvedAt ? "A thread est\xE1 resolvida; reabra com canvas_reopen_comment se precisar." : "A thread segue aberta.";
29466
29595
  return `\u2705 Resposta ${newReplyId(thread)} em ${comment_id}: "${oneLine2(text, 120)}". ${open3}`;
@@ -29478,11 +29607,11 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
29478
29607
  },
29479
29608
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
29480
29609
  },
29481
- async ({ board_id, comment_id, done }) => run(async () => {
29482
- const thread = await onComment(() => api.createComment(board_id, { body: done, parentId: comment_id }));
29610
+ async ({ board_id: board_id2, comment_id, done }) => run(async () => {
29611
+ const thread = await onComment(() => api.createComment(board_id2, { body: done, parentId: comment_id }));
29483
29612
  const replyId = newReplyId(thread);
29484
29613
  try {
29485
- await onComment(() => api.resolveComment(board_id, comment_id));
29614
+ await onComment(() => api.resolveComment(board_id2, comment_id));
29486
29615
  } catch (e) {
29487
29616
  const why = e instanceof Error ? e.message : String(e);
29488
29617
  throw new CanvasToolError(
@@ -29500,9 +29629,9 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
29500
29629
  inputSchema: { board_id: boardId, comment_id: commentId, why: external_exports.string().trim().min(1).max(1e3).optional() },
29501
29630
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
29502
29631
  },
29503
- async ({ board_id, comment_id, why }) => run(async () => {
29504
- await onComment(() => api.reopenComment(board_id, comment_id));
29505
- if (why) await onComment(() => api.createComment(board_id, { body: why, parentId: comment_id }));
29632
+ async ({ board_id: board_id2, comment_id, why }) => run(async () => {
29633
+ await onComment(() => api.reopenComment(board_id2, comment_id));
29634
+ if (why) await onComment(() => api.createComment(board_id2, { body: why, parentId: comment_id }));
29506
29635
  return `\u2705 Reaberto ${comment_id}${why ? ` com a resposta "${oneLine2(why, 120)}"` : ""}.`;
29507
29636
  })
29508
29637
  );
@@ -29604,8 +29733,8 @@ function layoutOps(doc, a) {
29604
29733
  }
29605
29734
  return ops;
29606
29735
  }
29607
- function scopeFor(doc, rows, aba) {
29608
- const tab = aba ? resolveTab(doc, aba) : void 0;
29736
+ function scopeFor(doc, rows, aba2) {
29737
+ const tab = aba2 ? resolveTab(doc, aba2) : void 0;
29609
29738
  if (!hasTabs(doc)) return void 0;
29610
29739
  const arranged = rows.flatMap((r) => [...r.title ? [r.title] : [], ...r.left, ...r.right]);
29611
29740
  const homes = new Set(arranged.map((id) => homeTabOf(doc, id)));
@@ -29948,6 +30077,7 @@ URL: ${u.url}`;
29948
30077
  return {
29949
30078
  ops: [{ type: "node.add", nodeId: created.id, node: created }],
29950
30079
  targets: [],
30080
+ place: { [created.id]: tab === void 0 ? {} : { tab } },
29951
30081
  done: `N\xF3 M\xEDdia "${oneLine2(nodeName(created), 40)}" criado: ${created.id}.${placementNote(doc, created)}`
29952
30082
  };
29953
30083
  });
@@ -29974,6 +30104,7 @@ var statusPacing = {
29974
30104
  now: () => Date.now(),
29975
30105
  sleep: (ms) => new Promise((r) => setTimeout(r, Math.max(0, ms)))
29976
30106
  };
30107
+ var byServer = (a) => a.via === "server";
29977
30108
  var sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
29978
30109
  var seconds = (ms) => `${new Intl.NumberFormat("pt-BR", { maximumFractionDigits: 1 }).format(ms / 1e3)} s`;
29979
30110
  function timingsLine(t) {
@@ -30048,12 +30179,12 @@ function registerCanvasRunTools(server, api, run) {
30048
30179
  const unknownFate = requestId && (e.httpStatus === 0 || e.httpStatus === 408 || reason === "tab-timeout" || reason === "tab-bad-answer" || e.httpStatus >= 500 && e.httpStatus !== 501);
30049
30180
  if (unknownFate) {
30050
30181
  throw new CanvasToolError(
30051
- `N\xE3o d\xE1 para saber se a aba come\xE7ou a rodar (${e.message}). N\xC3O pe\xE7a um pedido novo: consulte canvas_run_status com request_id "${requestId}". Se precisar repetir, chame canvas_run com o mesmo request_id: \xE9 seguro, a aba n\xE3o roda duas vezes.`
30182
+ `N\xE3o d\xE1 para saber se o pedido come\xE7ou a rodar (${e.message}). N\xC3O pe\xE7a um pedido novo: consulte canvas_run_status com request_id "${requestId}". Se precisar repetir, chame canvas_run com o mesmo request_id: \xE9 seguro, nada roda duas vezes.`
30052
30183
  );
30053
30184
  }
30054
30185
  if (reason === "no-tab") {
30055
30186
  throw new CanvasToolError(
30056
- "Nenhuma aba do Canvas sua est\xE1 aberta neste board (ou a aba \xE9 de uma vers\xE3o sem esta fun\xE7\xE3o). Pe\xE7a para abrir o board no Canvas com a mesma conta deste MCP e tente de novo. Nada rodou."
30187
+ "Este pedido precisa de uma aba do Canvas, e nenhuma sua est\xE1 aberta neste board (ou a aba \xE9 de uma vers\xE3o sem esta fun\xE7\xE3o). Pe\xE7a para abrir o board no Canvas com a mesma conta deste MCP e tente de novo. Nada rodou."
30057
30188
  );
30058
30189
  }
30059
30190
  if (e.httpStatus === 404 && reason !== "unknown-request") {
@@ -30075,7 +30206,7 @@ function registerCanvasRunTools(server, api, run) {
30075
30206
  function answerText(a, requestId, max, titleOf) {
30076
30207
  const est = estimateLines(a.estimate, titleOf);
30077
30208
  const total = a.estimate ? `${dia(a.estimate.total)} (teto ${fmt2(max)})` : "";
30078
- const again = a.repeated ? " (a aba j\xE1 tinha recebido este request_id; esta \xE9 a mesma resposta)" : "";
30209
+ const again = a.repeated ? " (este request_id j\xE1 tinha chegado; esta \xE9 a mesma resposta)" : "";
30079
30210
  if (a.status === "estimate") {
30080
30211
  return [
30081
30212
  `Estimativa, nada rodou${again}. Modo ${modeText(a.mode)}. Total agora: ${total}.`,
@@ -30087,7 +30218,7 @@ function registerCanvasRunTools(server, api, run) {
30087
30218
  if (a.status === "nothing") return `Nada para rodar${again}: ${a.message ?? "o board j\xE1 est\xE1 em dia."}`;
30088
30219
  const willRun = (a.estimate?.nodes ?? []).filter((n) => n.willRun).map((n) => n.nodeId);
30089
30220
  return [
30090
- `Rodando pela sua aba do Canvas${again}. Modo ${modeText(a.mode)}. Estimativa: ${total}.`,
30221
+ `${byServer(a) ? "Rodando no servidor, sem depender de aba aberta" : "Rodando pela sua aba do Canvas"}${again}. Modo ${modeText(a.mode)}. Estimativa: ${total}.`,
30091
30222
  ...est,
30092
30223
  `request_id: ${requestId}. Andamento: canvas_run_status (board_id, request_id). Resultado: canvas_read_board com node_ids [${willRun.slice(0, 20).join(", ")}] quando terminar.`,
30093
30224
  timingsLine(a.timings)
@@ -30101,7 +30232,7 @@ function registerCanvasRunTools(server, api, run) {
30101
30232
  "canvas_run",
30102
30233
  {
30103
30234
  title: "Canvas: rodar n\xF3s",
30104
- description: "Roda n\xF3s do board pela aba do Canvas que o usu\xE1rio tem aberta nele (mesma conta; sem aba aberta, nada roda). GASTA DIAMANTES no modo Real. A aba estima como o bot\xE3o Rodar e s\xF3 roda se a estimativa couber em max_diamonds (obrigat\xF3rio: o teto que o usu\xE1rio autorizou; nunca invente um valor alto). dry_run: true s\xF3 estima. Alvo, um destes: node_ids (roda esses n\xF3s mesmo em cache, gerando e gastando de novo, como o Rodar do cart\xE3o), from_node_id (o n\xF3 e tudo depois dele, tamb\xE9m de novo) ou all: true (s\xF3 o que mudou, como o Rodar tudo). simulated: true s\xF3 vale com a aba no modo Simulado; sem ele, a aba precisa estar no Real. Prompt com PT editado e sem aplicar no EN: a aba recusa e diz qual (aplique no cart\xE3o). Devolve o que vai rodar, o custo e o request_id; acompanhe com canvas_run_status e leia o resultado com canvas_read_board. Se a resposta disser que n\xE3o d\xE1 para saber se come\xE7ou, consulte o andamento e, para repetir, use o MESMO request_id.",
30235
+ description: "Roda n\xF3s do board no servidor, sem precisar de aba aberta. GASTA DIAMANTES no modo Real. Estima como o bot\xE3o Rodar e s\xF3 roda se a estimativa couber em max_diamonds (obrigat\xF3rio: o teto que o usu\xE1rio autorizou; nunca invente um valor alto). O teto \xE9 conferido de novo antes de cada n\xF3 pago; texto reserva o pior caso. dry_run: true s\xF3 estima. Alvo, um destes: node_ids (roda esses n\xF3s mesmo em cache, gerando e gastando de novo, como o Rodar do cart\xE3o), from_node_id (o n\xF3 e tudo depois dele, tamb\xE9m de novo) ou all: true (s\xF3 o que mudou, como o Rodar tudo). Composi\xE7\xE3o, montagem, exporta\xE7\xE3o, Contexto, arquivo que s\xF3 existe no navegador e especialista pr\xF3prio dependem da aba do usu\xE1rio: com ela aberta, o pedido vai para ela; sem ela, recusa antes de gastar e diz qual n\xF3. simulated: true s\xF3 vale com a aba no modo Simulado. Prompt com PT editado e sem aplicar no EN: recusa e diz qual (aplique no cart\xE3o). Devolve o que vai rodar, o custo e o request_id; acompanhe com canvas_run_status e leia o resultado com canvas_read_board. Se a resposta disser que n\xE3o d\xE1 para saber se come\xE7ou, consulte o andamento e, para repetir, use o MESMO request_id.",
30105
30236
  inputSchema: {
30106
30237
  board_id: boardId2,
30107
30238
  node_ids: external_exports.array(nodeId).min(1).max(100).optional().describe("Os n\xF3s a rodar (como o Rodar do cart\xE3o/sele\xE7\xE3o)."),
@@ -30109,8 +30240,8 @@ function registerCanvasRunTools(server, api, run) {
30109
30240
  all: external_exports.boolean().optional().describe("true: Rodar tudo (s\xF3 o que mudou)."),
30110
30241
  max_diamonds: external_exports.number().finite().min(0).max(1e6).describe("Teto de diamantes desta execu\xE7\xE3o. Obrigat\xF3rio."),
30111
30242
  dry_run: external_exports.boolean().optional().describe("true: s\xF3 estima, nada roda."),
30112
- simulated: external_exports.boolean().optional().describe("true: o pedido \xE9 para o modo Simulado (a aba precisa estar nele)."),
30113
- label: external_exports.string().trim().min(1).max(80).optional().describe('Quem pede, como a aba mostra ("Rodando a pedido de \u2026").'),
30243
+ simulated: external_exports.boolean().optional().describe("true: o pedido \xE9 para o modo Simulado, que roda na aba (ela precisa estar nele)."),
30244
+ label: external_exports.string().trim().min(1).max(80).optional().describe('Quem pede, como o board mostra ("Rodando a pedido de \u2026").'),
30114
30245
  request_id: external_exports.string().uuid().optional().describe("S\xF3 para repetir um pedido cujo destino ficou incerto.")
30115
30246
  },
30116
30247
  annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
@@ -30128,7 +30259,8 @@ function registerCanvasRunTools(server, api, run) {
30128
30259
  dryRun: args.dry_run === true,
30129
30260
  simulated: args.simulated === true,
30130
30261
  label,
30131
- earlyAck: true
30262
+ earlyAck: true,
30263
+ clientId: CLIENT_ID
30132
30264
  });
30133
30265
  } catch (e) {
30134
30266
  explain2(e, requestId);
@@ -30142,13 +30274,13 @@ function registerCanvasRunTools(server, api, run) {
30142
30274
  }
30143
30275
  if (wasAccepted) answer = { ...answer, repeated: false };
30144
30276
  if (answer.ok === true && answer.status === "accepted") {
30145
- return `A aba recebeu o pedido e ainda est\xE1 estimando e conferindo (board grande). request_id: ${requestId}. Acompanhe com canvas_run_status; para a resposta completa, chame canvas_run de novo com o MESMO request_id (\xE9 seguro: a aba n\xE3o roda duas vezes). N\xC3O pe\xE7a com outro id.`;
30277
+ return `O pedido chegou e ainda est\xE1 sendo estimado e conferido (board grande). request_id: ${requestId}. Acompanhe com canvas_run_status; para a resposta completa, chame canvas_run de novo com o MESMO request_id (\xE9 seguro: nada roda duas vezes). N\xC3O pe\xE7a com outro id.`;
30146
30278
  }
30147
30279
  const titleOf = lacksTitles(answer.estimate?.nodes) ? await titles(args.board_id) : (id) => id;
30148
30280
  if (answer.ok !== true) {
30149
30281
  const est = estimateLines(answer.estimate, titleOf);
30150
30282
  throw new CanvasToolError(
30151
- [`A aba recusou, nada rodou (${answer.reason ?? "sem motivo"}): ${answer.message ?? ""}`.trim(), ...est].join("\n")
30283
+ [`${byServer(answer) ? "O servidor" : "A aba"} recusou, nada rodou (${answer.reason ?? "sem motivo"}): ${answer.message ?? ""}`.trim(), ...est].join("\n")
30152
30284
  );
30153
30285
  }
30154
30286
  const nodeIds = (answer.estimate?.nodes ?? []).filter((n) => n.willRun).map((n) => n.nodeId);
@@ -30166,7 +30298,7 @@ function registerCanvasRunTools(server, api, run) {
30166
30298
  "canvas_run_status",
30167
30299
  {
30168
30300
  title: "Canvas: andamento da execu\xE7\xE3o",
30169
- description: "Andamento de um pedido do canvas_run: estado de cada n\xF3, estimado e gasto. Pergunta \xE0 aba do Canvas que rodou; se ela fechou, l\xEA o estado de execu\xE7\xE3o do board para os n\xF3s do pedido (os que este MCP lembra, ou node_ids). S\xF3 leitura.",
30301
+ description: "Andamento de um pedido do canvas_run: estado de cada n\xF3, estimado e gasto. Vem do servidor ou da aba que rodou; se ela fechou, l\xEA o estado de execu\xE7\xE3o do board para os n\xF3s do pedido (os que este MCP lembra, ou node_ids). S\xF3 leitura.",
30170
30302
  inputSchema: {
30171
30303
  board_id: boardId2,
30172
30304
  request_id: external_exports.string().uuid().describe("O request_id que o canvas_run devolveu."),
@@ -30174,7 +30306,7 @@ function registerCanvasRunTools(server, api, run) {
30174
30306
  },
30175
30307
  annotations: { readOnlyHint: true, openWorldHint: true }
30176
30308
  },
30177
- async ({ board_id, request_id, node_ids }) => run(async () => {
30309
+ async ({ board_id: board_id2, request_id, node_ids }) => run(async () => {
30178
30310
  const requestId = request_id.toLowerCase();
30179
30311
  const since = statusPacing.now() - (lastStatusAt.get(requestId) ?? -Infinity);
30180
30312
  if (since < statusPacing.minIntervalMs) await statusPacing.sleep(statusPacing.minIntervalMs - since);
@@ -30183,8 +30315,8 @@ function registerCanvasRunTools(server, api, run) {
30183
30315
  while (lastStatusAt.size > MAX_REMEMBERED) lastStatusAt.delete(lastStatusAt.keys().next().value);
30184
30316
  let why = "";
30185
30317
  try {
30186
- const status = await api.runStatus(board_id, requestId);
30187
- return statusText(status, lacksTitles(status.nodes) ? await titles(board_id) : (id) => id);
30318
+ const status = await api.runStatus(board_id2, requestId);
30319
+ return statusText(status, lacksTitles(status.nodes) ? await titles(board_id2) : (id) => id);
30188
30320
  } catch (e) {
30189
30321
  const reason = errorRaw(e)?.reason;
30190
30322
  if (!(e instanceof ApiError) || reason !== "unknown-request" && reason !== "no-tab") explain2(e);
@@ -30197,12 +30329,12 @@ function registerCanvasRunTools(server, api, run) {
30197
30329
  }
30198
30330
  const partial2 = known?.omitted ? ` (parcial: s\xF3 os ${ids.length} n\xF3s que a aba listou; outros ${known.omitted} ficaram fora da resposta. Para eles, chame com node_ids)` : "";
30199
30331
  return `${why} Pelo estado de execu\xE7\xE3o do board${partial2}:
30200
- ${fromRuns(await api.snapshot(board_id, { runs: true }), ids)}`;
30332
+ ${fromRuns(await api.snapshot(board_id2, { runs: true }), ids)}`;
30201
30333
  })
30202
30334
  );
30203
30335
  }
30204
30336
  var STATE_TEXT = {
30205
- preparing: "a aba est\xE1 estimando e conferindo",
30337
+ preparing: "estimando e conferindo",
30206
30338
  running: "rodando",
30207
30339
  done: "terminou",
30208
30340
  failed: "terminou com erro",
@@ -30423,6 +30555,55 @@ function lockViolation(doc, ops) {
30423
30555
  return null;
30424
30556
  }
30425
30557
 
30558
+ // src/tools/canvas-locks.ts
30559
+ var board_id = external_exports.string().uuid();
30560
+ 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).");
30561
+ function registerCanvasLockTools(server, deps) {
30562
+ const { api, run } = deps;
30563
+ const needOwnSession = () => {
30564
+ 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.");
30565
+ };
30566
+ server.registerTool(
30567
+ "canvas_lock_tab",
30568
+ {
30569
+ title: "Canvas: travar aba",
30570
+ 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.",
30571
+ inputSchema: {
30572
+ board_id,
30573
+ aba,
30574
+ label: external_exports.string().trim().min(1).max(120).optional().describe("O que esta sess\xE3o est\xE1 fazendo: aparece para quem for recusado.")
30575
+ },
30576
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
30577
+ },
30578
+ async (args) => run(async () => {
30579
+ needOwnSession();
30580
+ const { doc } = await api.snapshot(args.board_id);
30581
+ const tab = resolveTab(doc, args.aba);
30582
+ const lock = await api.lockTab(args.board_id, tab, CLIENT_ID, args.label);
30583
+ return `\u2705 Aba "${tabTitle(doc.nodes[tab])}" travada para esta sess\xE3o (${lock.sessionId}) at\xE9 ${lock.expiresAt}; cada escrita renova.`;
30584
+ })
30585
+ );
30586
+ server.registerTool(
30587
+ "canvas_unlock_tab",
30588
+ {
30589
+ title: "Canvas: soltar aba",
30590
+ 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.",
30591
+ inputSchema: { board_id, aba },
30592
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
30593
+ },
30594
+ async (args) => run(async () => {
30595
+ needOwnSession();
30596
+ const { doc } = await api.snapshot(args.board_id);
30597
+ const tab = resolveTab(doc, args.aba);
30598
+ const { released } = await api.unlockTab(args.board_id, tab, CLIENT_ID);
30599
+ const name = `"${tabTitle(doc.nodes[tab])}"`;
30600
+ if (released) return `\u2705 Aba ${name} solta.`;
30601
+ const other = (await api.tabLocks(args.board_id)).find((l) => l.tabId === tab);
30602
+ return other ? `Nada mudou: ${describeLock(other)}.` : `A aba ${name} j\xE1 estava livre.`;
30603
+ })
30604
+ );
30605
+ }
30606
+
30426
30607
  // src/canvas/mentions.ts
30427
30608
  var VIA_MENTION = "viaMention";
30428
30609
  var PROMPT_REFS_INPUT = "refs";
@@ -30554,16 +30735,79 @@ function describeMentionSync(sync, name) {
30554
30735
  return parts.length ? ` ${parts.join(". ")}.` : "";
30555
30736
  }
30556
30737
 
30738
+ // src/canvas/text-file.ts
30739
+ import { createHash as createHash2 } from "crypto";
30740
+ import { readFile as readFile3, realpath, stat as stat4 } from "fs/promises";
30741
+ import { extname as extname4 } from "path";
30742
+ var TEXT_FILE_EXTENSIONS = ["txt", "md", "markdown", "csv", "tsv", "srt", "vtt"];
30743
+ var MAX_TEXT_FILE_BYTES = MAX_OP_BYTES - 4 * 1024;
30744
+ var kb = (bytes) => (bytes / 1024).toFixed(1).replace(".", ",");
30745
+ async function readTextFile(ref) {
30746
+ const refuse = (why) => new CanvasToolError(`Arquivo "${ref}": ${why} Nada foi gravado.`);
30747
+ let abs;
30748
+ try {
30749
+ abs = toLocalPath(ref);
30750
+ } catch (e) {
30751
+ if (e instanceof ApiError) {
30752
+ 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.");
30753
+ }
30754
+ throw refuse("o caminho n\xE3o \xE9 v\xE1lido.");
30755
+ }
30756
+ if (isRemoteRef(ref)) throw refuse("aqui vale s\xF3 caminho local, n\xE3o URL.");
30757
+ let real;
30758
+ let size;
30759
+ try {
30760
+ real = await realpath(abs);
30761
+ const info = await stat4(real);
30762
+ if (!info.isFile()) throw refuse("n\xE3o \xE9 um arquivo comum.");
30763
+ size = info.size;
30764
+ } catch (e) {
30765
+ if (e instanceof CanvasToolError) throw e;
30766
+ throw refuse("n\xE3o encontrei ou n\xE3o consegui abrir.");
30767
+ }
30768
+ const ext = extname4(real).slice(1).toLowerCase();
30769
+ if (!TEXT_FILE_EXTENSIONS.includes(ext)) {
30770
+ throw refuse(`${ext ? `a extens\xE3o .${ext}` : "arquivo sem extens\xE3o"} n\xE3o \xE9 aceita. Aceitas: ${TEXT_FILE_EXTENSIONS.join(", ")}.`);
30771
+ }
30772
+ 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.`);
30773
+ if (size > MAX_TEXT_FILE_BYTES) throw tooLarge2(size);
30774
+ let buf;
30775
+ try {
30776
+ buf = await readFile3(real);
30777
+ } catch {
30778
+ throw refuse("n\xE3o consegui ler.");
30779
+ }
30780
+ let text;
30781
+ try {
30782
+ if (buf.includes(0)) throw new Error("nul");
30783
+ text = new TextDecoder("utf-8", { fatal: true }).decode(buf);
30784
+ } catch {
30785
+ throw refuse("parece bin\xE1rio ou n\xE3o est\xE1 em UTF-8. Salve como texto UTF-8.");
30786
+ }
30787
+ if (!text.trim()) throw refuse("est\xE1 vazio.");
30788
+ const json2 = JSON.stringify(text);
30789
+ const wire = Buffer.byteLength(json2);
30790
+ if (wire > MAX_TEXT_FILE_BYTES) throw tooLarge2(wire);
30791
+ return { text, bytes: buf.byteLength, hash: createHash2("sha256").update(json2).digest("hex").slice(0, 12) };
30792
+ }
30793
+ function describeTextFiles(read) {
30794
+ if (!read.length) return "";
30795
+ return ` Lido de arquivo: ${read.map((r) => `${r.path} \u2190 "${r.ref}" (${r.file.bytes} bytes, sha256 ${r.file.hash})`).join("; ")}.`;
30796
+ }
30797
+
30557
30798
  // src/tools/canvas.ts
30558
30799
  var REJECT_TEXT = {
30559
30800
  "node-missing": "o n\xF3 n\xE3o existe mais (algu\xE9m apagou)",
30560
30801
  "edge-endpoint-missing": "uma ponta da liga\xE7\xE3o n\xE3o existe mais",
30561
30802
  "invalid-op": "opera\xE7\xE3o inv\xE1lida ou repetida",
30562
- "too-large": "opera\xE7\xE3o grande demais (64 KB) ou com m\xEDdia embutida"
30803
+ "too-large": "opera\xE7\xE3o grande demais (64 KB) ou com m\xEDdia embutida",
30804
+ "tab-locked": "a aba est\xE1 travada por outra sess\xE3o"
30563
30805
  };
30806
+ var rejectText = (o) => o.lockedBy ? describeLock(o.lockedBy) : REJECT_TEXT[o.rejected] ?? o.rejected;
30564
30807
  var READ = "Exige canvas_read_board nesta sess\xE3o (e de novo depois de uma recusa). ";
30565
30808
  var MENTION_NOTE = 'Prompt: {{var}} no template + data.mentions {var: {node, port}} (o !! de um Bloco \xE9 port "text") j\xE1 cria, no mesmo passo, a liga\xE7\xE3o fina de men\xE7\xE3o que o Canvas desenha; tirar a var ou a men\xE7\xE3o tira a liga\xE7\xE3o. ';
30566
30809
  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).";
30810
+ var FILE_NOTE = `Texto grande (prompt, roteiro): salve num arquivo local e passe o caminho, n\xE3o digite na chamada. S\xF3 ${TEXT_FILE_EXTENSIONS.join(", ")}, UTF-8, at\xE9 ${MAX_TEXT_FILE_BYTES / 1024} KB; n\xE3o vale no conector remoto. `;
30567
30811
  function dataSegments(path) {
30568
30812
  const p = path?.trim() ?? "";
30569
30813
  if (!p || p === "data") return [];
@@ -30571,6 +30815,32 @@ function dataSegments(path) {
30571
30815
  if (segs.some((seg) => !seg)) throw new CanvasToolError(`Caminho "${p}" tem segmento vazio (dois pontos seguidos ou ponto na ponta).`);
30572
30816
  return segs;
30573
30817
  }
30818
+ async function withDataFiles(raw, files) {
30819
+ const data = structuredClone(raw ?? {});
30820
+ const read = [];
30821
+ for (const [asked, ref] of Object.entries(files ?? {})) {
30822
+ const at = `data_files["${asked}"]`;
30823
+ const segs = dataSegments(asked);
30824
+ if (!segs.length) throw new CanvasToolError(`${at}: informe um caminho dentro do data, n\xE3o o data inteiro.`);
30825
+ const path = segs.join(".");
30826
+ const badPath = checkNodePath(`data.${path}`);
30827
+ if (badPath) throw new CanvasToolError(`${at}: ${badPath}.`);
30828
+ let cur = data;
30829
+ for (const [i, seg] of segs.slice(0, -1).entries()) {
30830
+ const next = Object.hasOwn(cur, seg) ? cur[seg] : cur[seg] = {};
30831
+ if (!next || typeof next !== "object" || Array.isArray(next)) {
30832
+ throw new CanvasToolError(`${at}: data.${segs.slice(0, i + 1).join(".")} n\xE3o \xE9 objeto, e o caminho n\xE3o entra nele.`);
30833
+ }
30834
+ cur = next;
30835
+ }
30836
+ const leaf = segs[segs.length - 1];
30837
+ if (Object.hasOwn(cur, leaf)) throw new CanvasToolError(`${at}: data.${path} j\xE1 veio neste pedido. Mande o valor por um lugar s\xF3.`);
30838
+ const file = await readTextFile(ref);
30839
+ cur[leaf] = file.text;
30840
+ read.push({ path, ref, file });
30841
+ }
30842
+ return { data, note: describeTextFiles(read) };
30843
+ }
30574
30844
  function legacySequenceGuard(node, key) {
30575
30845
  if (key === "sequence" && nodeKind(node) === "montage" && node.data.timeline !== void 0) {
30576
30846
  throw new CanvasToolError(
@@ -30645,7 +30915,7 @@ function registerCanvasTools(server, client, cfg) {
30645
30915
  const snap = await api.snapshot(id, { fresh: true });
30646
30916
  if (snap.role === "viewer") throw new CanvasToolError("Voc\xEA \xE9 s\xF3 leitor neste board: pe\xE7a ao dono para te dar papel de editor.");
30647
30917
  const doc = snap.doc;
30648
- const { ops, done, targets } = await build2(doc, snap);
30918
+ const { ops, done, targets, place } = await build2(doc, snap);
30649
30919
  if (!ops.length) return `Nada a mudar. ${done}`;
30650
30920
  if (opts.layoutOnly && !ops.every(isLayoutOp)) throw new Error("layout_only com opera\xE7\xE3o fora de posi\xE7\xE3o/tamanho");
30651
30921
  const locked = lockViolation(doc, ops);
@@ -30674,14 +30944,17 @@ function registerCanvasTools(server, client, cfg) {
30674
30944
  Aviso: ${changesSince(theirs, doc)}.`;
30675
30945
  }
30676
30946
  if (opts.split) return commitSplit(id, ops, done, note, !!opts.layoutOnly);
30677
- const env = envelope(id, batchOf(ops), await api.me());
30947
+ const env = { ...envelope(id, batchOf(ops), await api.me()), ...place && { place } };
30678
30948
  const bad = checkEnvelope(env);
30679
30949
  if (bad) throw new CanvasToolError(`Edi\xE7\xE3o recusada antes de enviar: ${bad}.`);
30680
30950
  const res = await commitOps(id, [env]);
30681
30951
  const outcome = res.outcomes.find((o) => o.opId === env.id);
30952
+ if (outcome && "rejected" in outcome && outcome.rejected === "tab-locked") {
30953
+ 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.`);
30954
+ }
30682
30955
  if (!outcome || "rejected" in outcome) {
30683
30956
  if (!opts.layoutOnly) seen.delete(id);
30684
- const why = outcome && "rejected" in outcome ? REJECT_TEXT[outcome.rejected] ?? outcome.rejected : "sem resposta do servidor";
30957
+ const why = outcome && "rejected" in outcome ? rejectText(outcome) : "sem resposta do servidor";
30685
30958
  throw new CanvasToolError(`O servidor recusou a edi\xE7\xE3o: ${why}. Nada foi aplicado. Releia com canvas_read_board.`);
30686
30959
  }
30687
30960
  if (!opts.layoutOnly) seen.set(id, res.seq);
@@ -30715,10 +30988,10 @@ Aviso: ${changesSince(theirs, doc)}.`;
30715
30988
  const lines = envs.map((env, i) => {
30716
30989
  const paths = pathsOf(env.op);
30717
30990
  const span = paths.length > 1 ? `${paths[0]} \u2026 ${paths[paths.length - 1]}` : paths[0];
30718
- const kb = (Buffer.byteLength(JSON.stringify(env)) / 1024).toFixed(1).replace(".", ",");
30991
+ const kb2 = (Buffer.byteLength(JSON.stringify(env)) / 1024).toFixed(1).replace(".", ",");
30719
30992
  const o = outcomes.get(env.id);
30720
- const result = o && "seq" in o ? `seq ${o.seq}` : (failed++, `RECUSADO (${o && "rejected" in o ? REJECT_TEXT[o.rejected] ?? o.rejected : "sem resposta do servidor"}): nada deste envelope entrou`);
30721
- return `- envelope ${i + 1}/${envs.length}: ${paths.length} caminho(s) (${span}), ${kb} KB \u2192 ${result}`;
30993
+ 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`);
30994
+ return `- envelope ${i + 1}/${envs.length}: ${paths.length} caminho(s) (${span}), ${kb2} KB \u2192 ${result}`;
30722
30995
  });
30723
30996
  if (failed) {
30724
30997
  if (!layoutOnly) seen.delete(id);
@@ -30849,7 +31122,7 @@ ${lines.join("\n")}${note}`;
30849
31122
  "canvas_read_board",
30850
31123
  {
30851
31124
  title: "Canvas: ler board",
30852
- description: 'L\xEA um board: n\xF3s (id, tipo, nome, posi\xE7\xE3o, tamanho, campos principais), liga\xE7\xF5es e v\xEDnculo com o IA Lab, sem m\xEDdia. Tamanho "medido" \xE9 o da tela; "gravado" \xE9 o piso (o cart\xE3o cresce com o conte\xFAdo). Obrigat\xF3rio antes de editar (vale para a sess\xE3o). node_ids devolve o data desses n\xF3s, com cada corte marcado (path=\u2026); o valor inteiro (ex.: data.sequence da Montagem) sai no canvas_read_node. Cada cart\xE3o diz a aba (aba=<id curto> ou aba=avulsos), o topo conta os cart\xF5es de cada aba e aba l\xEA uma aba s\xF3.',
31125
+ description: 'L\xEA um board: n\xF3s (id, tipo, nome, posi\xE7\xE3o, tamanho, campos principais), liga\xE7\xF5es e v\xEDnculo com o IA Lab, sem m\xEDdia. Tamanho "medido" \xE9 o da tela; "gravado" \xE9 o piso (o cart\xE3o cresce com o conte\xFAdo). Obrigat\xF3rio antes de editar (vale para a sess\xE3o). node_ids devolve s\xF3 o data desses n\xF3s, sem o resto do board, com cada corte marcado (path=\u2026); o valor inteiro (ex.: data.sequence da Montagem) sai no canvas_read_node. Cada cart\xE3o diz a aba (aba=<id curto> ou aba=avulsos), o topo conta os cart\xF5es de cada aba e aba l\xEA uma aba s\xF3.',
30853
31126
  inputSchema: {
30854
31127
  board_id: boardId3,
30855
31128
  node_ids: external_exports.array(nodeIdArg2).max(20).optional().describe("N\xF3s para ver o data (sem blobs, cortes marcados)."),
@@ -30857,11 +31130,26 @@ ${lines.join("\n")}${note}`;
30857
31130
  },
30858
31131
  annotations: { readOnlyHint: true, openWorldHint: false }
30859
31132
  },
30860
- async ({ board_id, node_ids, aba }) => run(async () => {
30861
- const snap = await api.snapshot(board_id);
30862
- const tab = aba ? resolveTab(snap.doc, aba, { allowAvulsos: true }) : void 0;
30863
- seen.set(board_id, snap.seq);
31133
+ async ({ board_id: board_id2, node_ids, aba: aba2 }) => run(async () => {
31134
+ if (node_ids?.length && !aba2) {
31135
+ const read = await api.readNodes(board_id2, node_ids);
31136
+ if (!seen.has(board_id2)) seen.set(board_id2, read.seq);
31137
+ const found = node_ids.flatMap((n) => read.nodes[n] ? [read.nodes[n]] : []);
31138
+ return [
31139
+ `Board "${read.title}" \xB7 id ${board_id2} \xB7 seq ${read.seq} \xB7 ${node_ids.length} n\xF3(s) pedido(s)`,
31140
+ "",
31141
+ ...found.flatMap((n) => nodeLines(n)),
31142
+ "",
31143
+ "Detalhe:",
31144
+ ...node_ids.map((n) => read.nodes[n] ? nodeDetail(read.nodes[n]) : `${n}: n\xE3o existe`)
31145
+ ].join("\n");
31146
+ }
31147
+ const snap = await api.snapshot(board_id2);
31148
+ const tab = aba2 ? resolveTab(snap.doc, aba2, { allowAvulsos: true }) : void 0;
31149
+ seen.set(board_id2, snap.seq);
30864
31150
  const parts = [boardSummary(snap, { tab })];
31151
+ const locks = await api.tabLocks(board_id2).catch(() => []);
31152
+ if (locks.length) parts.push("", "Travas de sess\xE3o:", ...locks.map((l) => `- ${describeLock(l)}`));
30865
31153
  if (node_ids?.length) {
30866
31154
  parts.push("", "Detalhe:");
30867
31155
  for (const n of node_ids) parts.push(snap.doc.nodes[n] ? nodeDetail(snap.doc.nodes[n]) : `${n}: n\xE3o existe`);
@@ -30883,9 +31171,9 @@ ${lines.join("\n")}${note}`;
30883
31171
  },
30884
31172
  annotations: { readOnlyHint: true, openWorldHint: false }
30885
31173
  },
30886
- async ({ board_id, node_id, path, offset, max_chars }) => run(async () => {
30887
- const snap = await api.snapshot(board_id);
30888
- const node = snap.doc.nodes[node_id];
31174
+ async ({ board_id: board_id2, node_id, path, offset, max_chars }) => run(async () => {
31175
+ const read = await api.readNodes(board_id2, [node_id]);
31176
+ const node = read.nodes[node_id];
30889
31177
  if (!node) throw new CanvasToolError(`N\xF3 ${node_id} n\xE3o existe no board. Releia com canvas_read_board.`);
30890
31178
  let value = visibleData(node.data);
30891
31179
  let segments = dataSegments(path);
@@ -30918,10 +31206,10 @@ ${lines.join("\n")}${note}`;
30918
31206
  const from = Math.min(offset ?? 0, total);
30919
31207
  const size = max_chars ?? 4e4;
30920
31208
  const to = Math.min(from + size, total);
30921
- const hash = createHash2("sha256").update(json2).digest("hex").slice(0, 12);
31209
+ const hash = createHash3("sha256").update(json2).digest("hex").slice(0, 12);
30922
31210
  const where = `data${segments.length ? `.${segments.join(".")}` : ""}`;
30923
31211
  const at = readMeasured(node)?.at;
30924
- const head = `${node.id} \xB7 ${nodeKind(node) ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" \xB7 board seq ${snap.seq} \xB7 tamanho ${sizeLabel(node)}${at ? ` \xB7 medido em ${at}` : ""} \xB7 ${where}${which}: ${total} caracteres (JSON compacto) \xB7 sha256 ${hash}`;
31212
+ const head = `${node.id} \xB7 ${nodeKind(node) ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" \xB7 board seq ${read.seq} \xB7 tamanho ${sizeLabel(node)}${at ? ` \xB7 medido em ${at}` : ""} \xB7 ${where}${which}: ${total} caracteres (JSON compacto) \xB7 sha256 ${hash}`;
30925
31213
  const part = from === 0 && to === total ? "Inteiro, abaixo." : `Parte: caracteres ${from} a ${to} de ${total}. ${to < total ? `Falta o resto: chame de novo com offset=${to}.` : "Esta \xE9 a \xFAltima parte."}`;
30926
31214
  return `${head}
30927
31215
  ${part}
@@ -30982,12 +31270,13 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
30982
31270
  "canvas_add_node",
30983
31271
  {
30984
31272
  title: "Canvas: adicionar n\xF3",
30985
- description: `Adiciona um n\xF3 (n\xE3o executa). ${READ}kind: ${kindList()}. data completa o padr\xE3o do tipo; label d\xE1 o nome. Sem position, nasce ao lado do n\xF3 ligado ou \xE0 direita do board (com aba, no fim do conte\xFAdo da aba); aba grava data.abaId. Texto livre (label) sem size {w} nasce na largura do tamanho do texto: titulo 2000, subtitulo 1200, corpo 320. Prompt sem size nasce com 1024 \xD7 516; gerador de imagem ou v\xEDdeo, com altura 516 e a largura do aspect_ratio (16:9 917, 9:16 290, 1:1 516). inputs/outputs j\xE1 ligam o n\xF3 no mesmo passo. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
31273
+ description: `Adiciona um n\xF3 (n\xE3o executa). ${READ}kind: ${kindList()}. data completa o padr\xE3o do tipo; label d\xE1 o nome. Sem position, nasce ao lado do n\xF3 ligado ou \xE0 direita do board (com aba, no fim do conte\xFAdo da aba); aba grava data.abaId. Texto livre (label) sem size {w} nasce na largura do tamanho do texto: titulo 2000, subtitulo 1200, corpo 320. Prompt sem size nasce com 1024 \xD7 516; gerador de imagem ou v\xEDdeo, com altura 516 e a largura do aspect_ratio (16:9 917, 9:16 290, 1:1 516). inputs/outputs j\xE1 ligam o n\xF3 no mesmo passo. ${FILE_NOTE}data_files {"template": "/tmp/prompt.md"} grava o texto do arquivo nesse caminho do data, igual a ter vindo em data. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
30986
31274
  inputSchema: {
30987
31275
  board_id: boardId3,
30988
31276
  kind: external_exports.string().min(1).max(40),
30989
31277
  label: external_exports.string().trim().min(1).max(120).optional().describe("Nome do cart\xE3o (data.label)."),
30990
31278
  data: external_exports.record(external_exports.unknown()).optional().describe("Campos do data. Ex.: narration {blocks:[{id,text}]}, text {text}, prompt {template}."),
31279
+ data_files: external_exports.record(external_exports.string().min(1).max(4096)).optional().describe('Texto vindo de arquivo local: { "<caminho no data>": "<arquivo>" }. Ex.: { "template": "/tmp/prompt.md" }. Prefira a digitar texto grande em data.'),
30991
31280
  aba: abaArg(ABA_ADD_NODE),
30992
31281
  position: point.optional(),
30993
31282
  size: sizeArg.optional(),
@@ -31001,7 +31290,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31001
31290
  const spec = KINDS[args.kind];
31002
31291
  if (!spec) throw new CanvasToolError(`Tipo "${args.kind}" desconhecido. Tipos: ${kindList()}.`);
31003
31292
  const me = await api.me();
31004
- const data = { ...spec.data, ...parseData(args.data), [KIND_FIELD]: args.kind };
31293
+ const input = await withDataFiles(args.data, args.data_files);
31294
+ const data = { ...spec.data, ...parseData(input.data), [KIND_FIELD]: args.kind };
31005
31295
  if (args.label) data.label = args.label;
31006
31296
  if (typeof args.size === "string") data.size = textSizeFor(args.kind, args.size);
31007
31297
  const box = birthBox(args.kind, spec, data, args.size && typeof args.size !== "string" ? boxOf(args.size) : void 0);
@@ -31017,7 +31307,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31017
31307
  if (tab !== void 0) data[TAB_ID_FIELD] = tab;
31018
31308
  const near = args.inputs?.[0] ? doc.nodes[args.inputs[0].from] : args.outputs?.[0] ? doc.nodes[args.outputs[0].to] : void 0;
31019
31309
  const nearTab = near ? homeTabOf(doc, near.id) ?? void 0 : void 0;
31020
- const position = args.position ?? placeFor(doc, box, tab === void 0 ? near : void 0, args.inputs?.[0] ? "right" : "left", tab ?? nearTab);
31310
+ const side = args.inputs?.[0] ? "right" : "left";
31311
+ const position = args.position ?? placeFor(doc, box, tab === void 0 ? near : void 0, side, tab ?? nearTab);
31021
31312
  const zIndex = args.kind === "section" ? SECTION_Z : Object.values(doc.nodes).reduce((t, n) => Math.max(t, n.zIndex), 0) + 1;
31022
31313
  const node = makeNode({ type: WORKFLOW_NODE_TYPE, data, position, size: box, zIndex, createdBy: me });
31023
31314
  const links = [
@@ -31034,11 +31325,12 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31034
31325
  }
31035
31326
  const edges = edgeOps(doc, links, me, /* @__PURE__ */ new Set([node.id]));
31036
31327
  const drawn = edges.ops.flatMap((op) => op.type === "edge.add" ? [op.edge] : []);
31037
- const mention = await mentionOps(doc, [{ node, data: node.data, keys: Object.keys(args.data ?? {}) }], drawn);
31328
+ const mention = await mentionOps(doc, [{ node, data: node.data, keys: Object.keys(input.data) }], drawn);
31038
31329
  return {
31039
31330
  ops: [{ type: "node.add", nodeId: node.id, node }, ...edges.ops, ...mention.ops],
31040
31331
  targets: links.map((l) => l.source === node.id ? l.target : l.source),
31041
- done: `N\xF3 ${args.kind} "${nodeName(node)}" criado: ${node.id}${edges.ops.length ? ` com ${edges.ops.length} liga\xE7\xE3o(\xF5es)` : ""}.${placementNote(doc, node)}${edges.warn}${mention.note}`
31332
+ ...args.position ? {} : { place: { [node.id]: tab !== void 0 ? { tab } : near ? { near: near.id, side } : {} } },
31333
+ done: `N\xF3 ${args.kind} "${nodeName(node)}" criado: ${node.id}${edges.ops.length ? ` com ${edges.ops.length} liga\xE7\xE3o(\xF5es)` : ""}.${placementNote(doc, node)}${edges.warn}${mention.note}${input.note}`
31042
31334
  };
31043
31335
  })
31044
31336
  )
@@ -31047,7 +31339,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31047
31339
  "canvas_update_node",
31048
31340
  {
31049
31341
  title: "Canvas: editar n\xF3",
31050
- description: `Muda campos do data de um n\xF3, chave a chave (null apaga a chave), sem executar. ${READ}label renomeia; position move; size {w, h} muda a caixa (piso: o cart\xE3o cresce com o conte\xFAdo). N\xE3o troca o tipo. Cada chave \xE9 gravada inteira: leia antes com canvas_read_node e mande o valor completo j\xE1 revisado, para n\xE3o apagar o que outra pessoa escreveu. Para mudar partes de uma estrutura grande (clipes da timeline), use canvas_patch_node, por caminho; v\xE1rios n\xF3s de uma vez, canvas_update_nodes. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
31342
+ description: `Muda campos do data de um n\xF3, chave a chave (null apaga a chave), sem executar. ${READ}label renomeia; position move; size {w, h} muda a caixa (piso: o cart\xE3o cresce com o conte\xFAdo). N\xE3o troca o tipo. Cada chave \xE9 gravada inteira: leia antes com canvas_read_node e mande o valor completo j\xE1 revisado, para n\xE3o apagar o que outra pessoa escreveu. Para mudar partes de uma estrutura grande (clipes da timeline) ou gravar texto grande por arquivo, use canvas_patch_node, por caminho; v\xE1rios n\xF3s de uma vez, canvas_update_nodes. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
31051
31343
  inputSchema: {
31052
31344
  board_id: boardId3,
31053
31345
  node_id: nodeIdArg2,
@@ -31127,7 +31419,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31127
31419
  "canvas_patch_node",
31128
31420
  {
31129
31421
  title: "Canvas: gravar por caminho",
31130
- description: `Grava v\xE1rios caminhos dentro do data de um n\xF3, sem executar: {path, value} grava, {path, unset: true} apaga. ${READ}O caminho atravessa objetos (o n\xEDvel que falta \xE9 criado) e n\xE3o entra em lista: para mudar um item de lista, grave a lista inteira. Quebra sozinho em envelopes de at\xE9 64 KB, em ordem, e devolve o resultado de cada um; entre envelopes n\xE3o h\xE1 atomicidade (o que entrou fica). Serve para mexer em partes de uma estrutura grande, como clipes da timeline da Montagem, sem reenviar tudo. Leia antes com canvas_read_node. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
31422
+ description: `Grava v\xE1rios caminhos dentro do data de um n\xF3, sem executar: {path, value} grava, {path, file} grava o texto de um arquivo local, {path, unset: true} apaga. ${READ}${FILE_NOTE}O caminho atravessa objetos (o n\xEDvel que falta \xE9 criado) e n\xE3o entra em lista: para mudar um item de lista, grave a lista inteira. Quebra sozinho em envelopes de at\xE9 64 KB, em ordem, e devolve o resultado de cada um; entre envelopes n\xE3o h\xE1 atomicidade (o que entrou fica). Serve para mexer em partes de uma estrutura grande, como clipes da timeline da Montagem, sem reenviar tudo. Leia antes com canvas_read_node. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
31131
31423
  inputSchema: {
31132
31424
  board_id: boardId3,
31133
31425
  node_id: nodeIdArg2,
@@ -31135,7 +31427,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31135
31427
  external_exports.object({
31136
31428
  path: external_exports.string().trim().min(1).max(500).describe('Caminho dentro do data (ex.: "timeline.meta.fps"); aceita o prefixo "data.".'),
31137
31429
  value: external_exports.unknown().optional().describe("Valor JSON a gravar (null grava null)."),
31138
- unset: external_exports.literal(true).optional().describe("true apaga a chave.")
31430
+ unset: external_exports.literal(true).optional().describe("true apaga a chave."),
31431
+ file: external_exports.string().min(1).max(4096).optional().describe('Arquivo local cujo texto vira o valor, no lugar de value. Ex.: "/tmp/prompt.md". Prefira a digitar texto grande em value.')
31139
31432
  })
31140
31433
  ).min(1).max(5e3)
31141
31434
  },
@@ -31152,6 +31445,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31152
31445
  let absent = 0;
31153
31446
  const mentionKeys = /* @__PURE__ */ new Set();
31154
31447
  let mentionAt = -1;
31448
+ const read = [];
31155
31449
  for (const [i, item] of args.sets.entries()) {
31156
31450
  const at = `sets[${i}] (${item.path})`;
31157
31451
  const segs = dataSegments(item.path);
@@ -31164,7 +31458,10 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31164
31458
  if (MENTION_KEYS.includes(segs[0])) mentionKeys.add(segs[0]);
31165
31459
  const unset = item.unset === true;
31166
31460
  const hasValue = item.value !== void 0;
31167
- if (unset === hasValue) throw new CanvasToolError(`${at}: mande value OU unset: true.`);
31461
+ const hasFile = item.file !== void 0;
31462
+ if ([unset, hasValue, hasFile].filter(Boolean).length !== 1) {
31463
+ throw new CanvasToolError(`${at}: mande s\xF3 um de value, unset: true ou file.`);
31464
+ }
31168
31465
  if (hasValue && !isJson(item.value)) throw new CanvasToolError(`${at}: value n\xE3o \xE9 JSON v\xE1lido.`);
31169
31466
  let cur = work;
31170
31467
  for (const [j, seg] of segs.slice(0, -1).entries()) {
@@ -31199,7 +31496,9 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31199
31496
  if (MENTION_KEYS.includes(segs[0])) mentionAt = ops.length;
31200
31497
  continue;
31201
31498
  }
31202
- const value = item.value;
31499
+ const file = item.file === void 0 ? null : await readTextFile(item.file);
31500
+ if (file) read.push({ path: segs.join("."), ref: item.file, file });
31501
+ const value = file ? file.text : item.value;
31203
31502
  if (cur && Object.hasOwn(cur, leaf) && JSON.stringify(cur[leaf]) === JSON.stringify(value)) {
31204
31503
  same++;
31205
31504
  continue;
@@ -31215,7 +31514,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31215
31514
  return {
31216
31515
  ops,
31217
31516
  targets: [node.id],
31218
- done: `N\xF3 "${oneLine2(nodeName(node), 40)}" (${node.id}): ${written} caminho(s) gravado(s)` + (skipped ? ` (ignorados: ${skipped})` : "") + mention.note
31517
+ done: `N\xF3 "${oneLine2(nodeName(node), 40)}" (${node.id}): ${written} caminho(s) gravado(s)` + (skipped ? ` (ignorados: ${skipped})` : "") + mention.note + describeTextFiles(read)
31219
31518
  };
31220
31519
  },
31221
31520
  { split: true }
@@ -31302,8 +31601,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31302
31601
  inputSchema: { board_id: boardId3, title: external_exports.string().trim().min(1).max(200) },
31303
31602
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
31304
31603
  },
31305
- async ({ board_id, title }) => run(
31306
- () => edit(board_id, async (doc) => ({
31604
+ async ({ board_id: board_id2, title }) => run(
31605
+ () => edit(board_id2, async (doc) => ({
31307
31606
  ops: doc.title === title ? [] : [{ type: "board.set", field: "title", value: setValue(title) }],
31308
31607
  targets: [],
31309
31608
  done: `Board renomeado: "${doc.title}" \u2192 "${title}"`
@@ -31318,8 +31617,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31318
31617
  inputSchema: { board_id: boardId3 },
31319
31618
  annotations: { readOnlyHint: true, openWorldHint: false }
31320
31619
  },
31321
- async ({ board_id }) => run(async () => {
31322
- const members = await api.members(board_id);
31620
+ async ({ board_id: board_id2 }) => run(async () => {
31621
+ const members = await api.members(board_id2);
31323
31622
  return members.map((m) => {
31324
31623
  const name = [m.firstName, m.lastName].filter(Boolean).join(" ") || m.nickname || "(sem nome)";
31325
31624
  return `- ${m.userId} \xB7 ${name} \xB7 ${m.role}`;
@@ -31338,8 +31637,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31338
31637
  },
31339
31638
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
31340
31639
  },
31341
- async ({ board_id, user_id, role }) => run(async () => {
31342
- const r = await api.putMember(board_id, user_id, role);
31640
+ async ({ board_id: board_id2, user_id, role }) => run(async () => {
31641
+ const r = await api.putMember(board_id2, user_id, role);
31343
31642
  return `\u2705 ${r.userId} agora \xE9 ${r.role} no board.`;
31344
31643
  })
31345
31644
  );
@@ -31351,13 +31650,14 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31351
31650
  inputSchema: { board_id: boardId3, user_id: external_exports.string().uuid() },
31352
31651
  annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
31353
31652
  },
31354
- async ({ board_id, user_id }) => run(async () => {
31355
- await api.removeMember(board_id, user_id);
31653
+ async ({ board_id: board_id2, user_id }) => run(async () => {
31654
+ await api.removeMember(board_id2, user_id);
31356
31655
  return `\u2705 ${user_id} n\xE3o tem mais acesso ao board.`;
31357
31656
  })
31358
31657
  );
31359
31658
  registerCanvasCommentTools(server, api, run);
31360
31659
  registerCanvasMediaTools(server, { api, cfg, run, edit, seen, placeFor });
31660
+ registerCanvasLockTools(server, { api, run });
31361
31661
  registerCanvasLayoutTools(server, { api, run, edit });
31362
31662
  registerCanvasRunTools(server, api, run);
31363
31663
  registerCanvasFocusTools(server, api, run);
@@ -31367,7 +31667,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31367
31667
  import { createRequire } from "module";
31368
31668
  var require2 = createRequire(import.meta.url);
31369
31669
  function readVersion() {
31370
- if ("0.47.0") return "0.47.0";
31670
+ if ("0.50.0") return "0.50.0";
31371
31671
  try {
31372
31672
  const pkg = require2("../package.json");
31373
31673
  return pkg.version ?? "0.0.0-unknown";
@@ -31382,7 +31682,7 @@ var SERVER_INSTRUCTIONS = [
31382
31682
  "BePlus: tudo roda pela conta do usu\xE1rio (diamantes, limites e hist\xF3rico na plataforma).",
31383
31683
  'M\xEDdia: generate_* e elevenlabs_* gastam diamantes; confira com estimate_cost antes de lotes grandes. Sem project, a gera\xE7\xE3o cai no projeto ativo; billing:"personal" cobra do usu\xE1rio.',
31384
31684
  "Calls: search_calls acha, get_call traz a transcri\xE7\xE3o.",
31385
- "Canvas online (canvas_*): leia com canvas_read_board antes de editar e siga o estado lido. Cada edi\xE7\xE3o vai num passo s\xF3; se outra pessoa mexeu nos mesmos n\xF3s, a ferramenta recusa e pede releitura. As canvas_* n\xE3o geram m\xEDdia, exceto canvas_run: roda n\xF3s pela aba do Canvas aberta do usu\xE1rio e gasta diamantes; max_diamonds \xE9 o teto que o usu\xE1rio autorizou (dry_run s\xF3 estima). D\xEA nome (label) aos n\xF3s, n\xE3o invente tipos nem portas, e confirme antes de canvas_delete.",
31685
+ "Canvas online (canvas_*): leia com canvas_read_board antes de editar e siga o estado lido. Cada edi\xE7\xE3o vai num passo s\xF3; se outra pessoa mexeu nos mesmos n\xF3s, a ferramenta recusa e pede releitura. As canvas_* n\xE3o geram m\xEDdia, exceto canvas_run: roda n\xF3s no servidor e gasta diamantes; max_diamonds \xE9 o teto que o usu\xE1rio autorizou (dry_run s\xF3 estima). D\xEA nome (label) aos n\xF3s, n\xE3o invente tipos nem portas, e confirme antes de canvas_delete.",
31386
31686
  "Cada aba \xE9 um plano: ao criar, passe aba (id da se\xE7\xE3o) em canvas_add_node e canvas_upload_media, sen\xE3o o cart\xE3o pode cair em Avulsos. canvas_read_board com aba l\xEA uma aba s\xF3.",
31387
31687
  'Mostrar algo ao usu\xE1rio ("olha aqui"): canvas_focus leva a aba do Canvas que ele est\xE1 olhando at\xE9 os n\xF3s e os seleciona uma vez, sem prender a aba, sem gasto e sem escrita no board. follow: true prende a aba na \xE1rea at\xE9 o \xD7: s\xF3 se ele pedir.',
31388
31688
  '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.',