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.
@@ -25936,6 +25936,8 @@ function outputUrls(status) {
25936
25936
  function mimeFromUrl(url) {
25937
25937
  const u = url.toLowerCase();
25938
25938
  if (u.includes(".webp")) return "image/webp";
25939
+ if (u.includes(".gif")) return "image/gif";
25940
+ if (u.includes(".svg")) return "image/svg+xml";
25939
25941
  if (u.includes(".jpg") || u.includes(".jpeg")) return "image/jpeg";
25940
25942
  return "image/png";
25941
25943
  }
@@ -25948,6 +25950,7 @@ async function buildImageBlocks(urls, cfg) {
25948
25950
  if (!res.ok) continue;
25949
25951
  const mimeType = res.headers.get("content-type") || mimeFromUrl(url);
25950
25952
  if (!mimeType.startsWith("image/")) continue;
25953
+ if (mimeType.startsWith("image/svg")) continue;
25951
25954
  const buf = Buffer.from(await res.arrayBuffer());
25952
25955
  if (buf.byteLength > cfg.inlineImageMaxBytes) continue;
25953
25956
  blocks.push({ type: "image", data: buf.toString("base64"), mimeType });
@@ -25963,13 +25966,25 @@ var IMAGE_MODELS = [
25963
25966
  "google/nano-banana-2.1",
25964
25967
  "google/nano-banana-2",
25965
25968
  "google/nano-banana-pro",
25969
+ "openai/gpt-image-2.6-flare",
25970
+ "openai/gpt-image-2.6-sunburst",
25966
25971
  "openai/gpt-image-2",
25967
- "openai/gpt-image-1",
25968
25972
  "bytedance/seedream-5.0-lite",
25969
25973
  "bytedance/seedream-5.0-pro",
25970
25974
  "bytedance/seedream-5.0-pro-layers",
25971
25975
  "midjourney"
25972
25976
  ];
25977
+ var GPT_IMAGE_26_MODELS = ["openai/gpt-image-2.6-flare", "openai/gpt-image-2.6-sunburst"];
25978
+ var GPT_IMAGE_FORMATS = ["png", "jpeg", "webp", "gif", "svg"];
25979
+ var GIF_FRAMES = { min: 2, max: 16, default: 9 };
25980
+ var GIF_FRAME_MS = { min: 20, max: 2e3, default: 200 };
25981
+ var GIF_MAX_FRAMES_BY_SIZE = {
25982
+ "512x512": 16,
25983
+ "512x768": 16,
25984
+ "768x512": 16,
25985
+ "768x768": 12
25986
+ };
25987
+ var GIF_DEFAULT_SIZE = "512x512";
25973
25988
  var SEEDREAM_LITE_SIZES = ["2K", "3K", "4K"];
25974
25989
  var SEEDREAM_PRO_SIZES = ["1K", "1.5K", "2K"];
25975
25990
  var SEEDREAM_PRO_PIXELS = { min: 921600, max: 4624220 };
@@ -26634,7 +26649,7 @@ ${voiceLine(voice)}`);
26634
26649
  "Cria um efeito sonoro a partir de uma descri\xE7\xE3o (porta batendo, chuva, whoosh). Para trilha musical use elevenlabs_music.",
26635
26650
  {
26636
26651
  text: external_exports.string().min(1).describe("Descri\xE7\xE3o do som."),
26637
- model: modelField("eleven_text_to_sound_v2"),
26652
+ model: modelField("eleven_text_to_sound_v3"),
26638
26653
  duration_sec: external_exports.number().positive().optional().describe("De 0,5 a 30 s. Omita para o modelo decidir."),
26639
26654
  loop: external_exports.boolean().optional().describe("true faz o som emendar sem corte."),
26640
26655
  prompt_influence: external_exports.number().min(0).max(1).optional().describe("Quanto seguir a descri\xE7\xE3o ao p\xE9 da letra.")
@@ -26758,6 +26773,63 @@ ${voiceLine(voice)}`);
26758
26773
  );
26759
26774
  }
26760
26775
 
26776
+ // src/tools/gpt-image.ts
26777
+ function isGptImage26(model) {
26778
+ return GPT_IMAGE_26_MODELS.includes(model);
26779
+ }
26780
+ var gifSizes = () => Object.keys(GIF_MAX_FRAMES_BY_SIZE).join(", ");
26781
+ function validateGptImage(args) {
26782
+ const is26 = isGptImage26(args.model);
26783
+ const format = args.output_format;
26784
+ const isGif = format === "gif";
26785
+ const isSvg = format === "svg";
26786
+ if ((isGif || isSvg) && !is26) {
26787
+ 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).`;
26788
+ }
26789
+ if (!isGif && (args.frame_count !== void 0 || args.frame_duration_ms !== void 0)) {
26790
+ return 'frame_count e frame_duration_ms s\xF3 valem com output_format: "gif".';
26791
+ }
26792
+ if (args.background === "transparent") {
26793
+ if (!is26) {
26794
+ 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.`;
26795
+ }
26796
+ if (isSvg) return "O SVG j\xE1 sai com fundo transparente. Tire o background do pedido.";
26797
+ if (format && format !== "png" && format !== "webp") {
26798
+ return `Fundo transparente exige output_format png ou webp (${format} n\xE3o tem canal alpha).`;
26799
+ }
26800
+ }
26801
+ if (isGif) {
26802
+ const size = args.size ?? GIF_DEFAULT_SIZE;
26803
+ const maxFrames = GIF_MAX_FRAMES_BY_SIZE[size];
26804
+ if (maxFrames === void 0) {
26805
+ return `GIF aceita size ${gifSizes()} (voc\xEA pediu ${size}). Em GIF n\xE3o existe 1024 nem auto.`;
26806
+ }
26807
+ const frames = args.frame_count ?? GIF_FRAMES.default;
26808
+ if (frames > maxFrames) {
26809
+ return `GIF em ${size} aceita at\xE9 ${maxFrames} quadros (voc\xEA pediu ${frames}). Diminua frame_count.`;
26810
+ }
26811
+ if (args.output_compression !== void 0) return "GIF n\xE3o aceita output_compression.";
26812
+ }
26813
+ if (isSvg && args.output_compression !== void 0) return "SVG n\xE3o aceita output_compression.";
26814
+ return null;
26815
+ }
26816
+ function gptImageInput(args) {
26817
+ if (args.output_format !== "gif") return {};
26818
+ return {
26819
+ size: args.size ?? GIF_DEFAULT_SIZE,
26820
+ frame_count: args.frame_count ?? GIF_FRAMES.default,
26821
+ frame_duration_ms: args.frame_duration_ms ?? GIF_FRAME_MS.default
26822
+ };
26823
+ }
26824
+ function outputLabel(format) {
26825
+ if (format === "gif") return "GIF animado gerado";
26826
+ if (format === "svg") return "SVG (vetor) gerado";
26827
+ return "Imagem gerada";
26828
+ }
26829
+ function outputNote(format) {
26830
+ return format === "svg" ? "Abra pelo link: \xE9 um arquivo vetorial, n\xE3o uma imagem em pixels.\n" : "";
26831
+ }
26832
+
26761
26833
  // src/tools/generation.ts
26762
26834
  var IMAGE_BUDGET_MS = 9e4;
26763
26835
  var VIDEO_BUDGET_MS = 12e4;
@@ -26785,7 +26857,7 @@ function registerGenerationTools(server, client, cfg) {
26785
26857
  "generate_image",
26786
26858
  {
26787
26859
  title: "Gerar imagem",
26788
- 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,
26860
+ 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,
26789
26861
  inputSchema: {
26790
26862
  // Sem teto local: quem conhece o limite de cada provedor é o backend, e
26791
26863
  // ele responde com quanto reduzir. Um `.max()` aqui rejeitava prompts
@@ -26794,22 +26866,22 @@ function registerGenerationTools(server, client, cfg) {
26794
26866
  '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.'
26795
26867
  ),
26796
26868
  model: external_exports.enum(IMAGE_MODELS).default(DEFAULTS.imageModel).describe(
26797
- "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."
26869
+ "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."
26798
26870
  ),
26799
26871
  aspect_ratio: external_exports.enum(ASPECT_RATIOS).optional().describe(
26800
26872
  "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."
26801
26873
  ),
26802
26874
  resolution: external_exports.enum(IMAGE_RESOLUTIONS).optional().describe("Resolu\xE7\xE3o (nano-banana): 1K/2K/4K. Padr\xE3o 1K."),
26803
26875
  reference_images: external_exports.array(external_exports.string().min(1)).max(16).optional().describe(
26804
- "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)."
26876
+ "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."
26805
26877
  ),
26806
26878
  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."),
26807
26879
  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."),
26808
26880
  size: external_exports.union([
26809
- external_exports.enum(["1024x1024", "1536x1024", "1024x1536", "auto", "1K", "1.5K", "2K", "3K", "4K"]),
26881
+ external_exports.enum(["1024x1024", "1536x1024", "1024x1536", "auto", "512x512", "512x768", "768x512", "768x768", "1K", "1.5K", "2K", "3K", "4K"]),
26810
26882
  external_exports.string().regex(/^\d{3,5}x\d{3,5}$/, "use LARGURAxALTURA, ex.: 2048x1152")
26811
26883
  ]).optional().describe(
26812
- "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."
26884
+ "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."
26813
26885
  ),
26814
26886
  num_images: external_exports.number().int().min(1).max(SEEDREAM_PRO_MAX_IMAGES).optional().describe(
26815
26887
  "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."
@@ -26817,13 +26889,21 @@ function registerGenerationTools(server, client, cfg) {
26817
26889
  batch_images: external_exports.number().int().min(2).max(15).optional().describe(
26818
26890
  "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."
26819
26891
  ),
26820
- quality: external_exports.enum(["low", "medium", "high", "auto"]).optional().describe("Qualidade (gpt-image-1/2)."),
26892
+ quality: external_exports.enum(["low", "medium", "high", "auto"]).optional().describe("Qualidade (gpt-image-2 e 2.6)."),
26821
26893
  background: external_exports.enum(["opaque", "transparent", "auto"]).optional().describe(
26822
- "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."
26894
+ "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."
26823
26895
  ),
26824
- moderation: external_exports.enum(["low", "auto"]).optional().describe("Modera\xE7\xE3o (gpt-image-1/2). Padr\xE3o low."),
26825
- output_format: external_exports.enum(["png", "jpeg", "webp"]).optional().describe("Formato de sa\xEDda (gpt-image-1/2). Padr\xE3o png."),
26826
- 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."),
26896
+ moderation: external_exports.enum(["low", "auto"]).optional().describe("Modera\xE7\xE3o (gpt-image-2 e 2.6). Padr\xE3o low."),
26897
+ output_format: external_exports.enum(GPT_IMAGE_FORMATS).optional().describe(
26898
+ "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."
26899
+ ),
26900
+ frame_count: external_exports.number().int().min(GIF_FRAMES.min).max(GIF_FRAMES.max).optional().describe(
26901
+ `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.`
26902
+ ),
26903
+ frame_duration_ms: external_exports.number().int().min(GIF_FRAME_MS.min).max(GIF_FRAME_MS.max).optional().describe(
26904
+ `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}).`
26905
+ ),
26906
+ 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."),
26827
26907
  seed: external_exports.number().int().optional(),
26828
26908
  // ── Midjourney (model="midjourney") — params completos ──
26829
26909
  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."),
@@ -26911,16 +26991,8 @@ function registerGenerationTools(server, client, cfg) {
26911
26991
  "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."
26912
26992
  );
26913
26993
  }
26914
- if (args.background === "transparent") {
26915
- if (args.model !== "openai/gpt-image-1") {
26916
- return errorResult(
26917
- `${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.`
26918
- );
26919
- }
26920
- if (args.output_format === "jpeg") {
26921
- return errorResult("Fundo transparente exige output_format png ou webp \u2014 JPEG n\xE3o tem canal alpha.");
26922
- }
26923
- }
26994
+ const gptRefusal = validateGptImage(args);
26995
+ if (gptRefusal) return errorResult(gptRefusal);
26924
26996
  const reference_images = await resolveRefs(cfg, args.reference_images);
26925
26997
  let style_reference;
26926
26998
  if (isMidjourney && args.style_reference) {
@@ -26946,6 +27018,7 @@ function registerGenerationTools(server, client, cfg) {
26946
27018
  moderation: args.moderation,
26947
27019
  output_format: args.output_format,
26948
27020
  output_compression: args.output_compression,
27021
+ ...isGptImage26(args.model) ? gptImageInput(args) : {},
26949
27022
  seed: args.seed,
26950
27023
  // Midjourney full-params
26951
27024
  version: args.version,
@@ -26990,9 +27063,12 @@ ${footer}`);
26990
27063
  const blocks = await buildImageBlocks(urls, cfg);
26991
27064
  const list = urls.map((u, i) => `${i + 1}. ${u}`).join("\n") || "(sem URLs)";
26992
27065
  return {
26993
- content: [{ type: "text", text: `\u2705 Imagem gerada (${args.model}).
27066
+ content: [
27067
+ { type: "text", text: `\u2705 ${outputLabel(args.output_format)} (${args.model}).
26994
27068
  ${list}
26995
- ${footer}` }, ...blocks]
27069
+ ${outputNote(args.output_format)}${footer}` },
27070
+ ...blocks
27071
+ ]
26996
27072
  };
26997
27073
  } catch (e) {
26998
27074
  const msg = e instanceof ApiError ? e.message : e instanceof Error ? e.message : "";
@@ -28363,13 +28439,15 @@ Limites simult\xE2neos por usu\xE1rio: imagem=${m.limits.perUserMaxImage}, v\xED
28363
28439
  title: "Estimar custo",
28364
28440
  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_*).",
28365
28441
  inputSchema: {
28366
- model: external_exports.string().min(1).describe("Id do modelo (ex.: google/nano-banana-pro, bytedance/seedance-2.0)."),
28442
+ 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)."),
28367
28443
  elevenlabs_params: external_exports.record(external_exports.unknown()).optional().describe('[ElevenLabs] Campos do pedido no formato da API, ex.: { "voice": "...", "text": "..." }.'),
28368
28444
  resolution: external_exports.string().optional(),
28369
28445
  duration: external_exports.number().int().optional(),
28370
28446
  mode: external_exports.string().optional(),
28371
28447
  size: external_exports.string().optional(),
28372
28448
  quality: external_exports.string().optional(),
28449
+ 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."),
28450
+ frame_count: external_exports.number().int().min(2).max(16).optional().describe("[GPT Image 2.6, gif] Quadros do GIF."),
28373
28451
  aspect_ratio: external_exports.string().optional().describe("Seedream Pro: a propor\xE7\xE3o muda os pixels e a faixa de pre\xE7o."),
28374
28452
  num_images: external_exports.number().int().min(1).optional().describe("Seedream Pro: imagens por pedido; cada uma \xE9 cobrada."),
28375
28453
  task_type: external_exports.string().optional().describe('[m\xFAsica] extend e upload_extend usam o pre\xE7o "suno/extend"; os demais, o do modelo.'),
@@ -28418,6 +28496,8 @@ Limites simult\xE2neos por usu\xE1rio: imagem=${m.limits.perUserMaxImage}, v\xED
28418
28496
  mode: args.mode,
28419
28497
  size: args.size,
28420
28498
  quality: args.quality,
28499
+ output_format: args.output_format,
28500
+ frame_count: args.frame_count,
28421
28501
  aspect_ratio: args.aspect_ratio,
28422
28502
  num_images: args.num_images,
28423
28503
  seedance_provider: args.provider === "fal" ? "fal" : void 0,
@@ -28759,11 +28839,21 @@ ${calls.map(callLine).join("\n\n")}`);
28759
28839
  }
28760
28840
 
28761
28841
  // src/tools/canvas.ts
28762
- import { createHash as createHash2 } from "crypto";
28842
+ import { createHash as createHash3 } from "crypto";
28763
28843
 
28764
28844
  // src/canvas/api.ts
28765
28845
  import { createHash } from "crypto";
28766
28846
  var import_canvas_core = __toESM(require_canvas_core(), 1);
28847
+
28848
+ // src/canvas/tab-locks.ts
28849
+ var MINUTE = 6e4;
28850
+ function describeLock(lock, now = Date.now()) {
28851
+ const minutes = Math.max(1, Math.ceil((Date.parse(lock.expiresAt) - now) / MINUTE));
28852
+ const doing = lock.label ? `, "${lock.label}"` : "";
28853
+ 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`;
28854
+ }
28855
+
28856
+ // src/canvas/api.ts
28767
28857
  var PINNED_CORE_VERSION = "ca7b3b406184c7f679f555c3a008013197182b23";
28768
28858
  var RUN_REQUEST_TIMEOUT_MS = 4e4;
28769
28859
  var FOCUS_REQUEST_TIMEOUT_MS = 12e3;
@@ -28874,6 +28964,27 @@ var CanvasApi = class {
28874
28964
  boardLoads.set(loadKey, load);
28875
28965
  return load;
28876
28966
  }
28967
+ /**
28968
+ * Só estes nós. Com o board em cache, o delta já resolve e custa menos que a rota; sem cache, a
28969
+ * rota evita baixar o board inteiro. 404 pode ser servidor antigo: a foto decide se o board existe.
28970
+ */
28971
+ async readNodes(boardId4, ids) {
28972
+ if (!boardStore.has(this.cacheKey(boardId4))) {
28973
+ try {
28974
+ return await this.req("GET", `/boards/${boardId4}/nodes`, { query: { ids: ids.join(",") } });
28975
+ } catch (e) {
28976
+ if (!(e instanceof ApiError) || e.httpStatus !== 404) throw e;
28977
+ }
28978
+ }
28979
+ const snap = await this.snapshot(boardId4);
28980
+ const known = ids.filter((id) => Object.hasOwn(snap.doc.nodes, id));
28981
+ return {
28982
+ title: snap.title,
28983
+ seq: snap.seq,
28984
+ nodes: Object.fromEntries(known.map((id) => [id, snap.doc.nodes[id]])),
28985
+ missing: ids.filter((id) => !known.includes(id))
28986
+ };
28987
+ }
28877
28988
  async load(boardId4, key, needRuns) {
28878
28989
  const entry = boardStore.get(key);
28879
28990
  if (entry && !needRuns && this.coreVersion === PINNED_CORE_VERSION) {
@@ -28971,8 +29082,26 @@ var CanvasApi = class {
28971
29082
  }
28972
29083
  throw again;
28973
29084
  }
29085
+ } finally {
29086
+ const entry = boardStore.get(this.cacheKey(boardId4));
29087
+ if (entry) entry.checkedAt = -Infinity;
29088
+ }
29089
+ }
29090
+ tabLocks(boardId4) {
29091
+ return this.req("GET", `/boards/${boardId4}/tab-locks`);
29092
+ }
29093
+ async lockTab(boardId4, tabId, session, label) {
29094
+ try {
29095
+ return await this.req("PUT", `/boards/${boardId4}/tabs/${encodeURIComponent(tabId)}/lock`, { body: { session, label } });
29096
+ } catch (e) {
29097
+ const raw = errorRaw(e);
29098
+ if (raw?.reason !== "tab-locked" || !raw.lockedBy) throw e;
29099
+ throw new CanvasToolError(`N\xE3o travou: ${describeLock(raw.lockedBy)}.`);
28974
29100
  }
28975
29101
  }
29102
+ unlockTab(boardId4, tabId, session) {
29103
+ return this.req("DELETE", `/boards/${boardId4}/tabs/${encodeURIComponent(tabId)}/lock`, { query: { session } });
29104
+ }
28976
29105
  members(boardId4) {
28977
29106
  return this.req("GET", `/boards/${boardId4}/members`);
28978
29107
  }
@@ -29974,15 +30103,15 @@ function rowsLines(rows) {
29974
30103
  if (rows.length > MAX_BLOCKS) out.push(` \xB7 \u2026 +${rows.length - MAX_BLOCKS} linhas`);
29975
30104
  return out;
29976
30105
  }
29977
- function nodeLines(node, run, aba) {
30106
+ function nodeLines(node, run, aba2) {
29978
30107
  const kind = nodeKind(node);
29979
30108
  const spec = kind ? KINDS[kind] : void 0;
29980
- const head = `- ${node.id} \xB7 ${kind ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" @(${Math.round(node.position.x)},${Math.round(node.position.y)}) ${sizeLabel(node)}` + (aba ? ` \xB7 aba=${aba}` : "");
30109
+ const head = `- ${node.id} \xB7 ${kind ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" @(${Math.round(node.position.x)},${Math.round(node.position.y)}) ${sizeLabel(node)}` + (aba2 ? ` \xB7 aba=${aba2}` : "");
29981
30110
  const facts = [];
29982
30111
  const extra = [];
29983
30112
  const d = node.data;
29984
30113
  if (d.archived) facts.push("ARQUIVADO");
29985
- if (aba && isTabSection(node)) facts.push("\xE9 aba");
30114
+ if (aba2 && isTabSection(node)) facts.push("\xE9 aba");
29986
30115
  const approval = d.approval?.state;
29987
30116
  if (typeof approval === "string") facts.push(`aprova\xE7\xE3o: ${approval}`);
29988
30117
  if (Array.isArray(d.history)) facts.push(`${d.history.length} gera\xE7\xE3o(\xF5es)`);
@@ -30007,7 +30136,7 @@ function nodeLines(node, run, aba) {
30007
30136
  for (const [key, value] of Object.entries(d)) {
30008
30137
  if (NAME_KEYS.has(key) || HEAVY_KEYS.has(key) || key === main) continue;
30009
30138
  if (["blocks", "rows", "items", "archived", "approval"].includes(key)) continue;
30010
- if (aba && (key === TAB_ID_FIELD || key === TAB_FIELD && isTabSection(node))) continue;
30139
+ if (aba2 && (key === TAB_ID_FIELD || key === TAB_FIELD && isTabSection(node))) continue;
30011
30140
  const s = scalar(value);
30012
30141
  if (s !== null) facts.push(`${key}=${s}`);
30013
30142
  else if (Array.isArray(value)) facts.push(`${key}=[${value.length}]`);
@@ -30337,9 +30466,9 @@ function registerCanvasCommentTools(server, api, run) {
30337
30466
  },
30338
30467
  annotations: { readOnlyHint: true, openWorldHint: false }
30339
30468
  },
30340
- async ({ board_id, status }) => run(async () => {
30469
+ async ({ board_id: board_id2, status }) => run(async () => {
30341
30470
  const st = status ?? "open";
30342
- const [snap, threads] = await Promise.all([api.snapshot(board_id), api.listComments(board_id, st)]);
30471
+ const [snap, threads] = await Promise.all([api.snapshot(board_id2), api.listComments(board_id2, st)]);
30343
30472
  const text = commentsSummary(threads, snap.doc, st);
30344
30473
  const open3 = threads.some((t) => !t.resolvedAt);
30345
30474
  return open3 ? `${text}
@@ -30355,9 +30484,9 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
30355
30484
  inputSchema: { board_id: boardId, comment_id: commentId, body, mentions },
30356
30485
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
30357
30486
  },
30358
- async ({ board_id, comment_id, body: text, mentions: m }) => run(async () => {
30487
+ async ({ board_id: board_id2, comment_id, body: text, mentions: m }) => run(async () => {
30359
30488
  const thread = await onComment(
30360
- () => api.createComment(board_id, { body: text, parentId: comment_id, ...m?.length ? { mentions: m } : {} })
30489
+ () => api.createComment(board_id2, { body: text, parentId: comment_id, ...m?.length ? { mentions: m } : {} })
30361
30490
  );
30362
30491
  const open3 = thread?.resolvedAt ? "A thread est\xE1 resolvida; reabra com canvas_reopen_comment se precisar." : "A thread segue aberta.";
30363
30492
  return `\u2705 Resposta ${newReplyId(thread)} em ${comment_id}: "${oneLine2(text, 120)}". ${open3}`;
@@ -30375,11 +30504,11 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
30375
30504
  },
30376
30505
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
30377
30506
  },
30378
- async ({ board_id, comment_id, done }) => run(async () => {
30379
- const thread = await onComment(() => api.createComment(board_id, { body: done, parentId: comment_id }));
30507
+ async ({ board_id: board_id2, comment_id, done }) => run(async () => {
30508
+ const thread = await onComment(() => api.createComment(board_id2, { body: done, parentId: comment_id }));
30380
30509
  const replyId = newReplyId(thread);
30381
30510
  try {
30382
- await onComment(() => api.resolveComment(board_id, comment_id));
30511
+ await onComment(() => api.resolveComment(board_id2, comment_id));
30383
30512
  } catch (e) {
30384
30513
  const why = e instanceof Error ? e.message : String(e);
30385
30514
  throw new CanvasToolError(
@@ -30397,9 +30526,9 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
30397
30526
  inputSchema: { board_id: boardId, comment_id: commentId, why: external_exports.string().trim().min(1).max(1e3).optional() },
30398
30527
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
30399
30528
  },
30400
- async ({ board_id, comment_id, why }) => run(async () => {
30401
- await onComment(() => api.reopenComment(board_id, comment_id));
30402
- if (why) await onComment(() => api.createComment(board_id, { body: why, parentId: comment_id }));
30529
+ async ({ board_id: board_id2, comment_id, why }) => run(async () => {
30530
+ await onComment(() => api.reopenComment(board_id2, comment_id));
30531
+ if (why) await onComment(() => api.createComment(board_id2, { body: why, parentId: comment_id }));
30403
30532
  return `\u2705 Reaberto ${comment_id}${why ? ` com a resposta "${oneLine2(why, 120)}"` : ""}.`;
30404
30533
  })
30405
30534
  );
@@ -30501,8 +30630,8 @@ function layoutOps(doc, a) {
30501
30630
  }
30502
30631
  return ops;
30503
30632
  }
30504
- function scopeFor(doc, rows, aba) {
30505
- const tab = aba ? resolveTab(doc, aba) : void 0;
30633
+ function scopeFor(doc, rows, aba2) {
30634
+ const tab = aba2 ? resolveTab(doc, aba2) : void 0;
30506
30635
  if (!hasTabs(doc)) return void 0;
30507
30636
  const arranged = rows.flatMap((r) => [...r.title ? [r.title] : [], ...r.left, ...r.right]);
30508
30637
  const homes = new Set(arranged.map((id) => homeTabOf(doc, id)));
@@ -30845,6 +30974,7 @@ URL: ${u.url}`;
30845
30974
  return {
30846
30975
  ops: [{ type: "node.add", nodeId: created.id, node: created }],
30847
30976
  targets: [],
30977
+ place: { [created.id]: tab === void 0 ? {} : { tab } },
30848
30978
  done: `N\xF3 M\xEDdia "${oneLine2(nodeName(created), 40)}" criado: ${created.id}.${placementNote(doc, created)}`
30849
30979
  };
30850
30980
  });
@@ -30871,6 +31001,7 @@ var statusPacing = {
30871
31001
  now: () => Date.now(),
30872
31002
  sleep: (ms) => new Promise((r) => setTimeout(r, Math.max(0, ms)))
30873
31003
  };
31004
+ var byServer = (a) => a.via === "server";
30874
31005
  var sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
30875
31006
  var seconds = (ms) => `${new Intl.NumberFormat("pt-BR", { maximumFractionDigits: 1 }).format(ms / 1e3)} s`;
30876
31007
  function timingsLine(t) {
@@ -30945,12 +31076,12 @@ function registerCanvasRunTools(server, api, run) {
30945
31076
  const unknownFate = requestId && (e.httpStatus === 0 || e.httpStatus === 408 || reason === "tab-timeout" || reason === "tab-bad-answer" || e.httpStatus >= 500 && e.httpStatus !== 501);
30946
31077
  if (unknownFate) {
30947
31078
  throw new CanvasToolError(
30948
- `N\xE3o d\xE1 para saber se a aba come\xE7ou a rodar (${e.message}). N\xC3O pe\xE7a um pedido novo: consulte canvas_run_status com request_id "${requestId}". Se precisar repetir, chame canvas_run com o mesmo request_id: \xE9 seguro, a aba n\xE3o roda duas vezes.`
31079
+ `N\xE3o d\xE1 para saber se o pedido come\xE7ou a rodar (${e.message}). N\xC3O pe\xE7a um pedido novo: consulte canvas_run_status com request_id "${requestId}". Se precisar repetir, chame canvas_run com o mesmo request_id: \xE9 seguro, nada roda duas vezes.`
30949
31080
  );
30950
31081
  }
30951
31082
  if (reason === "no-tab") {
30952
31083
  throw new CanvasToolError(
30953
- "Nenhuma aba do Canvas sua est\xE1 aberta neste board (ou a aba \xE9 de uma vers\xE3o sem esta fun\xE7\xE3o). Pe\xE7a para abrir o board no Canvas com a mesma conta deste MCP e tente de novo. Nada rodou."
31084
+ "Este pedido precisa de uma aba do Canvas, e nenhuma sua est\xE1 aberta neste board (ou a aba \xE9 de uma vers\xE3o sem esta fun\xE7\xE3o). Pe\xE7a para abrir o board no Canvas com a mesma conta deste MCP e tente de novo. Nada rodou."
30954
31085
  );
30955
31086
  }
30956
31087
  if (e.httpStatus === 404 && reason !== "unknown-request") {
@@ -30972,7 +31103,7 @@ function registerCanvasRunTools(server, api, run) {
30972
31103
  function answerText(a, requestId, max, titleOf) {
30973
31104
  const est = estimateLines(a.estimate, titleOf);
30974
31105
  const total = a.estimate ? `${dia(a.estimate.total)} (teto ${fmt2(max)})` : "";
30975
- const again = a.repeated ? " (a aba j\xE1 tinha recebido este request_id; esta \xE9 a mesma resposta)" : "";
31106
+ const again = a.repeated ? " (este request_id j\xE1 tinha chegado; esta \xE9 a mesma resposta)" : "";
30976
31107
  if (a.status === "estimate") {
30977
31108
  return [
30978
31109
  `Estimativa, nada rodou${again}. Modo ${modeText(a.mode)}. Total agora: ${total}.`,
@@ -30984,7 +31115,7 @@ function registerCanvasRunTools(server, api, run) {
30984
31115
  if (a.status === "nothing") return `Nada para rodar${again}: ${a.message ?? "o board j\xE1 est\xE1 em dia."}`;
30985
31116
  const willRun = (a.estimate?.nodes ?? []).filter((n) => n.willRun).map((n) => n.nodeId);
30986
31117
  return [
30987
- `Rodando pela sua aba do Canvas${again}. Modo ${modeText(a.mode)}. Estimativa: ${total}.`,
31118
+ `${byServer(a) ? "Rodando no servidor, sem depender de aba aberta" : "Rodando pela sua aba do Canvas"}${again}. Modo ${modeText(a.mode)}. Estimativa: ${total}.`,
30988
31119
  ...est,
30989
31120
  `request_id: ${requestId}. Andamento: canvas_run_status (board_id, request_id). Resultado: canvas_read_board com node_ids [${willRun.slice(0, 20).join(", ")}] quando terminar.`,
30990
31121
  timingsLine(a.timings)
@@ -30998,7 +31129,7 @@ function registerCanvasRunTools(server, api, run) {
30998
31129
  "canvas_run",
30999
31130
  {
31000
31131
  title: "Canvas: rodar n\xF3s",
31001
- description: "Roda n\xF3s do board pela aba do Canvas que o usu\xE1rio tem aberta nele (mesma conta; sem aba aberta, nada roda). GASTA DIAMANTES no modo Real. A aba estima como o bot\xE3o Rodar e s\xF3 roda se a estimativa couber em max_diamonds (obrigat\xF3rio: o teto que o usu\xE1rio autorizou; nunca invente um valor alto). dry_run: true s\xF3 estima. Alvo, um destes: node_ids (roda esses n\xF3s mesmo em cache, gerando e gastando de novo, como o Rodar do cart\xE3o), from_node_id (o n\xF3 e tudo depois dele, tamb\xE9m de novo) ou all: true (s\xF3 o que mudou, como o Rodar tudo). simulated: true s\xF3 vale com a aba no modo Simulado; sem ele, a aba precisa estar no Real. Prompt com PT editado e sem aplicar no EN: a aba recusa e diz qual (aplique no cart\xE3o). Devolve o que vai rodar, o custo e o request_id; acompanhe com canvas_run_status e leia o resultado com canvas_read_board. Se a resposta disser que n\xE3o d\xE1 para saber se come\xE7ou, consulte o andamento e, para repetir, use o MESMO request_id.",
31132
+ description: "Roda n\xF3s do board no servidor, sem precisar de aba aberta. GASTA DIAMANTES no modo Real. Estima como o bot\xE3o Rodar e s\xF3 roda se a estimativa couber em max_diamonds (obrigat\xF3rio: o teto que o usu\xE1rio autorizou; nunca invente um valor alto). O teto \xE9 conferido de novo antes de cada n\xF3 pago; texto reserva o pior caso. dry_run: true s\xF3 estima. Alvo, um destes: node_ids (roda esses n\xF3s mesmo em cache, gerando e gastando de novo, como o Rodar do cart\xE3o), from_node_id (o n\xF3 e tudo depois dele, tamb\xE9m de novo) ou all: true (s\xF3 o que mudou, como o Rodar tudo). Composi\xE7\xE3o, montagem, exporta\xE7\xE3o, Contexto, arquivo que s\xF3 existe no navegador e especialista pr\xF3prio dependem da aba do usu\xE1rio: com ela aberta, o pedido vai para ela; sem ela, recusa antes de gastar e diz qual n\xF3. simulated: true s\xF3 vale com a aba no modo Simulado. Prompt com PT editado e sem aplicar no EN: recusa e diz qual (aplique no cart\xE3o). Devolve o que vai rodar, o custo e o request_id; acompanhe com canvas_run_status e leia o resultado com canvas_read_board. Se a resposta disser que n\xE3o d\xE1 para saber se come\xE7ou, consulte o andamento e, para repetir, use o MESMO request_id.",
31002
31133
  inputSchema: {
31003
31134
  board_id: boardId2,
31004
31135
  node_ids: external_exports.array(nodeId).min(1).max(100).optional().describe("Os n\xF3s a rodar (como o Rodar do cart\xE3o/sele\xE7\xE3o)."),
@@ -31006,8 +31137,8 @@ function registerCanvasRunTools(server, api, run) {
31006
31137
  all: external_exports.boolean().optional().describe("true: Rodar tudo (s\xF3 o que mudou)."),
31007
31138
  max_diamonds: external_exports.number().finite().min(0).max(1e6).describe("Teto de diamantes desta execu\xE7\xE3o. Obrigat\xF3rio."),
31008
31139
  dry_run: external_exports.boolean().optional().describe("true: s\xF3 estima, nada roda."),
31009
- simulated: external_exports.boolean().optional().describe("true: o pedido \xE9 para o modo Simulado (a aba precisa estar nele)."),
31010
- label: external_exports.string().trim().min(1).max(80).optional().describe('Quem pede, como a aba mostra ("Rodando a pedido de \u2026").'),
31140
+ simulated: external_exports.boolean().optional().describe("true: o pedido \xE9 para o modo Simulado, que roda na aba (ela precisa estar nele)."),
31141
+ label: external_exports.string().trim().min(1).max(80).optional().describe('Quem pede, como o board mostra ("Rodando a pedido de \u2026").'),
31011
31142
  request_id: external_exports.string().uuid().optional().describe("S\xF3 para repetir um pedido cujo destino ficou incerto.")
31012
31143
  },
31013
31144
  annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
@@ -31025,7 +31156,8 @@ function registerCanvasRunTools(server, api, run) {
31025
31156
  dryRun: args.dry_run === true,
31026
31157
  simulated: args.simulated === true,
31027
31158
  label,
31028
- earlyAck: true
31159
+ earlyAck: true,
31160
+ clientId: CLIENT_ID
31029
31161
  });
31030
31162
  } catch (e) {
31031
31163
  explain2(e, requestId);
@@ -31039,13 +31171,13 @@ function registerCanvasRunTools(server, api, run) {
31039
31171
  }
31040
31172
  if (wasAccepted) answer = { ...answer, repeated: false };
31041
31173
  if (answer.ok === true && answer.status === "accepted") {
31042
- return `A aba recebeu o pedido e ainda est\xE1 estimando e conferindo (board grande). request_id: ${requestId}. Acompanhe com canvas_run_status; para a resposta completa, chame canvas_run de novo com o MESMO request_id (\xE9 seguro: a aba n\xE3o roda duas vezes). N\xC3O pe\xE7a com outro id.`;
31174
+ return `O pedido chegou e ainda est\xE1 sendo estimado e conferido (board grande). request_id: ${requestId}. Acompanhe com canvas_run_status; para a resposta completa, chame canvas_run de novo com o MESMO request_id (\xE9 seguro: nada roda duas vezes). N\xC3O pe\xE7a com outro id.`;
31043
31175
  }
31044
31176
  const titleOf = lacksTitles(answer.estimate?.nodes) ? await titles(args.board_id) : (id) => id;
31045
31177
  if (answer.ok !== true) {
31046
31178
  const est = estimateLines(answer.estimate, titleOf);
31047
31179
  throw new CanvasToolError(
31048
- [`A aba recusou, nada rodou (${answer.reason ?? "sem motivo"}): ${answer.message ?? ""}`.trim(), ...est].join("\n")
31180
+ [`${byServer(answer) ? "O servidor" : "A aba"} recusou, nada rodou (${answer.reason ?? "sem motivo"}): ${answer.message ?? ""}`.trim(), ...est].join("\n")
31049
31181
  );
31050
31182
  }
31051
31183
  const nodeIds = (answer.estimate?.nodes ?? []).filter((n) => n.willRun).map((n) => n.nodeId);
@@ -31063,7 +31195,7 @@ function registerCanvasRunTools(server, api, run) {
31063
31195
  "canvas_run_status",
31064
31196
  {
31065
31197
  title: "Canvas: andamento da execu\xE7\xE3o",
31066
- description: "Andamento de um pedido do canvas_run: estado de cada n\xF3, estimado e gasto. Pergunta \xE0 aba do Canvas que rodou; se ela fechou, l\xEA o estado de execu\xE7\xE3o do board para os n\xF3s do pedido (os que este MCP lembra, ou node_ids). S\xF3 leitura.",
31198
+ description: "Andamento de um pedido do canvas_run: estado de cada n\xF3, estimado e gasto. Vem do servidor ou da aba que rodou; se ela fechou, l\xEA o estado de execu\xE7\xE3o do board para os n\xF3s do pedido (os que este MCP lembra, ou node_ids). S\xF3 leitura.",
31067
31199
  inputSchema: {
31068
31200
  board_id: boardId2,
31069
31201
  request_id: external_exports.string().uuid().describe("O request_id que o canvas_run devolveu."),
@@ -31071,7 +31203,7 @@ function registerCanvasRunTools(server, api, run) {
31071
31203
  },
31072
31204
  annotations: { readOnlyHint: true, openWorldHint: true }
31073
31205
  },
31074
- async ({ board_id, request_id, node_ids }) => run(async () => {
31206
+ async ({ board_id: board_id2, request_id, node_ids }) => run(async () => {
31075
31207
  const requestId = request_id.toLowerCase();
31076
31208
  const since = statusPacing.now() - (lastStatusAt.get(requestId) ?? -Infinity);
31077
31209
  if (since < statusPacing.minIntervalMs) await statusPacing.sleep(statusPacing.minIntervalMs - since);
@@ -31080,8 +31212,8 @@ function registerCanvasRunTools(server, api, run) {
31080
31212
  while (lastStatusAt.size > MAX_REMEMBERED) lastStatusAt.delete(lastStatusAt.keys().next().value);
31081
31213
  let why = "";
31082
31214
  try {
31083
- const status = await api.runStatus(board_id, requestId);
31084
- return statusText(status, lacksTitles(status.nodes) ? await titles(board_id) : (id) => id);
31215
+ const status = await api.runStatus(board_id2, requestId);
31216
+ return statusText(status, lacksTitles(status.nodes) ? await titles(board_id2) : (id) => id);
31085
31217
  } catch (e) {
31086
31218
  const reason = errorRaw(e)?.reason;
31087
31219
  if (!(e instanceof ApiError) || reason !== "unknown-request" && reason !== "no-tab") explain2(e);
@@ -31094,12 +31226,12 @@ function registerCanvasRunTools(server, api, run) {
31094
31226
  }
31095
31227
  const partial2 = known?.omitted ? ` (parcial: s\xF3 os ${ids.length} n\xF3s que a aba listou; outros ${known.omitted} ficaram fora da resposta. Para eles, chame com node_ids)` : "";
31096
31228
  return `${why} Pelo estado de execu\xE7\xE3o do board${partial2}:
31097
- ${fromRuns(await api.snapshot(board_id, { runs: true }), ids)}`;
31229
+ ${fromRuns(await api.snapshot(board_id2, { runs: true }), ids)}`;
31098
31230
  })
31099
31231
  );
31100
31232
  }
31101
31233
  var STATE_TEXT = {
31102
- preparing: "a aba est\xE1 estimando e conferindo",
31234
+ preparing: "estimando e conferindo",
31103
31235
  running: "rodando",
31104
31236
  done: "terminou",
31105
31237
  failed: "terminou com erro",
@@ -31320,6 +31452,55 @@ function lockViolation(doc, ops) {
31320
31452
  return null;
31321
31453
  }
31322
31454
 
31455
+ // src/tools/canvas-locks.ts
31456
+ var board_id = external_exports.string().uuid();
31457
+ 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).");
31458
+ function registerCanvasLockTools(server, deps) {
31459
+ const { api, run } = deps;
31460
+ const needOwnSession = () => {
31461
+ 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.");
31462
+ };
31463
+ server.registerTool(
31464
+ "canvas_lock_tab",
31465
+ {
31466
+ title: "Canvas: travar aba",
31467
+ 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.",
31468
+ inputSchema: {
31469
+ board_id,
31470
+ aba,
31471
+ label: external_exports.string().trim().min(1).max(120).optional().describe("O que esta sess\xE3o est\xE1 fazendo: aparece para quem for recusado.")
31472
+ },
31473
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
31474
+ },
31475
+ async (args) => run(async () => {
31476
+ needOwnSession();
31477
+ const { doc } = await api.snapshot(args.board_id);
31478
+ const tab = resolveTab(doc, args.aba);
31479
+ const lock = await api.lockTab(args.board_id, tab, CLIENT_ID, args.label);
31480
+ return `\u2705 Aba "${tabTitle(doc.nodes[tab])}" travada para esta sess\xE3o (${lock.sessionId}) at\xE9 ${lock.expiresAt}; cada escrita renova.`;
31481
+ })
31482
+ );
31483
+ server.registerTool(
31484
+ "canvas_unlock_tab",
31485
+ {
31486
+ title: "Canvas: soltar aba",
31487
+ 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.",
31488
+ inputSchema: { board_id, aba },
31489
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
31490
+ },
31491
+ async (args) => run(async () => {
31492
+ needOwnSession();
31493
+ const { doc } = await api.snapshot(args.board_id);
31494
+ const tab = resolveTab(doc, args.aba);
31495
+ const { released } = await api.unlockTab(args.board_id, tab, CLIENT_ID);
31496
+ const name = `"${tabTitle(doc.nodes[tab])}"`;
31497
+ if (released) return `\u2705 Aba ${name} solta.`;
31498
+ const other = (await api.tabLocks(args.board_id)).find((l) => l.tabId === tab);
31499
+ return other ? `Nada mudou: ${describeLock(other)}.` : `A aba ${name} j\xE1 estava livre.`;
31500
+ })
31501
+ );
31502
+ }
31503
+
31323
31504
  // src/canvas/mentions.ts
31324
31505
  var VIA_MENTION = "viaMention";
31325
31506
  var PROMPT_REFS_INPUT = "refs";
@@ -31451,16 +31632,79 @@ function describeMentionSync(sync, name) {
31451
31632
  return parts.length ? ` ${parts.join(". ")}.` : "";
31452
31633
  }
31453
31634
 
31635
+ // src/canvas/text-file.ts
31636
+ import { createHash as createHash2 } from "crypto";
31637
+ import { readFile as readFile3, realpath, stat as stat4 } from "fs/promises";
31638
+ import { extname as extname4 } from "path";
31639
+ var TEXT_FILE_EXTENSIONS = ["txt", "md", "markdown", "csv", "tsv", "srt", "vtt"];
31640
+ var MAX_TEXT_FILE_BYTES = MAX_OP_BYTES - 4 * 1024;
31641
+ var kb = (bytes) => (bytes / 1024).toFixed(1).replace(".", ",");
31642
+ async function readTextFile(ref) {
31643
+ const refuse = (why) => new CanvasToolError(`Arquivo "${ref}": ${why} Nada foi gravado.`);
31644
+ let abs;
31645
+ try {
31646
+ abs = toLocalPath(ref);
31647
+ } catch (e) {
31648
+ if (e instanceof ApiError) {
31649
+ 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.");
31650
+ }
31651
+ throw refuse("o caminho n\xE3o \xE9 v\xE1lido.");
31652
+ }
31653
+ if (isRemoteRef(ref)) throw refuse("aqui vale s\xF3 caminho local, n\xE3o URL.");
31654
+ let real;
31655
+ let size;
31656
+ try {
31657
+ real = await realpath(abs);
31658
+ const info = await stat4(real);
31659
+ if (!info.isFile()) throw refuse("n\xE3o \xE9 um arquivo comum.");
31660
+ size = info.size;
31661
+ } catch (e) {
31662
+ if (e instanceof CanvasToolError) throw e;
31663
+ throw refuse("n\xE3o encontrei ou n\xE3o consegui abrir.");
31664
+ }
31665
+ const ext = extname4(real).slice(1).toLowerCase();
31666
+ if (!TEXT_FILE_EXTENSIONS.includes(ext)) {
31667
+ throw refuse(`${ext ? `a extens\xE3o .${ext}` : "arquivo sem extens\xE3o"} n\xE3o \xE9 aceita. Aceitas: ${TEXT_FILE_EXTENSIONS.join(", ")}.`);
31668
+ }
31669
+ 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.`);
31670
+ if (size > MAX_TEXT_FILE_BYTES) throw tooLarge2(size);
31671
+ let buf;
31672
+ try {
31673
+ buf = await readFile3(real);
31674
+ } catch {
31675
+ throw refuse("n\xE3o consegui ler.");
31676
+ }
31677
+ let text;
31678
+ try {
31679
+ if (buf.includes(0)) throw new Error("nul");
31680
+ text = new TextDecoder("utf-8", { fatal: true }).decode(buf);
31681
+ } catch {
31682
+ throw refuse("parece bin\xE1rio ou n\xE3o est\xE1 em UTF-8. Salve como texto UTF-8.");
31683
+ }
31684
+ if (!text.trim()) throw refuse("est\xE1 vazio.");
31685
+ const json = JSON.stringify(text);
31686
+ const wire = Buffer.byteLength(json);
31687
+ if (wire > MAX_TEXT_FILE_BYTES) throw tooLarge2(wire);
31688
+ return { text, bytes: buf.byteLength, hash: createHash2("sha256").update(json).digest("hex").slice(0, 12) };
31689
+ }
31690
+ function describeTextFiles(read) {
31691
+ if (!read.length) return "";
31692
+ return ` Lido de arquivo: ${read.map((r) => `${r.path} \u2190 "${r.ref}" (${r.file.bytes} bytes, sha256 ${r.file.hash})`).join("; ")}.`;
31693
+ }
31694
+
31454
31695
  // src/tools/canvas.ts
31455
31696
  var REJECT_TEXT = {
31456
31697
  "node-missing": "o n\xF3 n\xE3o existe mais (algu\xE9m apagou)",
31457
31698
  "edge-endpoint-missing": "uma ponta da liga\xE7\xE3o n\xE3o existe mais",
31458
31699
  "invalid-op": "opera\xE7\xE3o inv\xE1lida ou repetida",
31459
- "too-large": "opera\xE7\xE3o grande demais (64 KB) ou com m\xEDdia embutida"
31700
+ "too-large": "opera\xE7\xE3o grande demais (64 KB) ou com m\xEDdia embutida",
31701
+ "tab-locked": "a aba est\xE1 travada por outra sess\xE3o"
31460
31702
  };
31703
+ var rejectText = (o) => o.lockedBy ? describeLock(o.lockedBy) : REJECT_TEXT[o.rejected] ?? o.rejected;
31461
31704
  var READ = "Exige canvas_read_board nesta sess\xE3o (e de novo depois de uma recusa). ";
31462
31705
  var MENTION_NOTE = 'Prompt: {{var}} no template + data.mentions {var: {node, port}} (o !! de um Bloco \xE9 port "text") j\xE1 cria, no mesmo passo, a liga\xE7\xE3o fina de men\xE7\xE3o que o Canvas desenha; tirar a var ou a men\xE7\xE3o tira a liga\xE7\xE3o. ';
31463
31706
  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).";
31707
+ var FILE_NOTE = `Texto grande (prompt, roteiro): salve num arquivo local e passe o caminho, n\xE3o digite na chamada. S\xF3 ${TEXT_FILE_EXTENSIONS.join(", ")}, UTF-8, at\xE9 ${MAX_TEXT_FILE_BYTES / 1024} KB; n\xE3o vale no conector remoto. `;
31464
31708
  function dataSegments(path) {
31465
31709
  const p = path?.trim() ?? "";
31466
31710
  if (!p || p === "data") return [];
@@ -31468,6 +31712,32 @@ function dataSegments(path) {
31468
31712
  if (segs.some((seg) => !seg)) throw new CanvasToolError(`Caminho "${p}" tem segmento vazio (dois pontos seguidos ou ponto na ponta).`);
31469
31713
  return segs;
31470
31714
  }
31715
+ async function withDataFiles(raw, files) {
31716
+ const data = structuredClone(raw ?? {});
31717
+ const read = [];
31718
+ for (const [asked, ref] of Object.entries(files ?? {})) {
31719
+ const at = `data_files["${asked}"]`;
31720
+ const segs = dataSegments(asked);
31721
+ if (!segs.length) throw new CanvasToolError(`${at}: informe um caminho dentro do data, n\xE3o o data inteiro.`);
31722
+ const path = segs.join(".");
31723
+ const badPath = checkNodePath(`data.${path}`);
31724
+ if (badPath) throw new CanvasToolError(`${at}: ${badPath}.`);
31725
+ let cur = data;
31726
+ for (const [i, seg] of segs.slice(0, -1).entries()) {
31727
+ const next = Object.hasOwn(cur, seg) ? cur[seg] : cur[seg] = {};
31728
+ if (!next || typeof next !== "object" || Array.isArray(next)) {
31729
+ throw new CanvasToolError(`${at}: data.${segs.slice(0, i + 1).join(".")} n\xE3o \xE9 objeto, e o caminho n\xE3o entra nele.`);
31730
+ }
31731
+ cur = next;
31732
+ }
31733
+ const leaf = segs[segs.length - 1];
31734
+ if (Object.hasOwn(cur, leaf)) throw new CanvasToolError(`${at}: data.${path} j\xE1 veio neste pedido. Mande o valor por um lugar s\xF3.`);
31735
+ const file = await readTextFile(ref);
31736
+ cur[leaf] = file.text;
31737
+ read.push({ path, ref, file });
31738
+ }
31739
+ return { data, note: describeTextFiles(read) };
31740
+ }
31471
31741
  function legacySequenceGuard(node, key) {
31472
31742
  if (key === "sequence" && nodeKind(node) === "montage" && node.data.timeline !== void 0) {
31473
31743
  throw new CanvasToolError(
@@ -31542,7 +31812,7 @@ function registerCanvasTools(server, client, cfg) {
31542
31812
  const snap = await api.snapshot(id, { fresh: true });
31543
31813
  if (snap.role === "viewer") throw new CanvasToolError("Voc\xEA \xE9 s\xF3 leitor neste board: pe\xE7a ao dono para te dar papel de editor.");
31544
31814
  const doc = snap.doc;
31545
- const { ops, done, targets } = await build2(doc, snap);
31815
+ const { ops, done, targets, place } = await build2(doc, snap);
31546
31816
  if (!ops.length) return `Nada a mudar. ${done}`;
31547
31817
  if (opts.layoutOnly && !ops.every(isLayoutOp)) throw new Error("layout_only com opera\xE7\xE3o fora de posi\xE7\xE3o/tamanho");
31548
31818
  const locked = lockViolation(doc, ops);
@@ -31571,14 +31841,17 @@ function registerCanvasTools(server, client, cfg) {
31571
31841
  Aviso: ${changesSince(theirs, doc)}.`;
31572
31842
  }
31573
31843
  if (opts.split) return commitSplit(id, ops, done, note, !!opts.layoutOnly);
31574
- const env = envelope(id, batchOf(ops), await api.me());
31844
+ const env = { ...envelope(id, batchOf(ops), await api.me()), ...place && { place } };
31575
31845
  const bad = checkEnvelope(env);
31576
31846
  if (bad) throw new CanvasToolError(`Edi\xE7\xE3o recusada antes de enviar: ${bad}.`);
31577
31847
  const res = await commitOps(id, [env]);
31578
31848
  const outcome = res.outcomes.find((o) => o.opId === env.id);
31849
+ if (outcome && "rejected" in outcome && outcome.rejected === "tab-locked") {
31850
+ 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.`);
31851
+ }
31579
31852
  if (!outcome || "rejected" in outcome) {
31580
31853
  if (!opts.layoutOnly) seen.delete(id);
31581
- const why = outcome && "rejected" in outcome ? REJECT_TEXT[outcome.rejected] ?? outcome.rejected : "sem resposta do servidor";
31854
+ const why = outcome && "rejected" in outcome ? rejectText(outcome) : "sem resposta do servidor";
31582
31855
  throw new CanvasToolError(`O servidor recusou a edi\xE7\xE3o: ${why}. Nada foi aplicado. Releia com canvas_read_board.`);
31583
31856
  }
31584
31857
  if (!opts.layoutOnly) seen.set(id, res.seq);
@@ -31612,10 +31885,10 @@ Aviso: ${changesSince(theirs, doc)}.`;
31612
31885
  const lines = envs.map((env, i) => {
31613
31886
  const paths = pathsOf(env.op);
31614
31887
  const span = paths.length > 1 ? `${paths[0]} \u2026 ${paths[paths.length - 1]}` : paths[0];
31615
- const kb = (Buffer.byteLength(JSON.stringify(env)) / 1024).toFixed(1).replace(".", ",");
31888
+ const kb2 = (Buffer.byteLength(JSON.stringify(env)) / 1024).toFixed(1).replace(".", ",");
31616
31889
  const o = outcomes.get(env.id);
31617
- const result = o && "seq" in o ? `seq ${o.seq}` : (failed++, `RECUSADO (${o && "rejected" in o ? REJECT_TEXT[o.rejected] ?? o.rejected : "sem resposta do servidor"}): nada deste envelope entrou`);
31618
- return `- envelope ${i + 1}/${envs.length}: ${paths.length} caminho(s) (${span}), ${kb} KB \u2192 ${result}`;
31890
+ 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`);
31891
+ return `- envelope ${i + 1}/${envs.length}: ${paths.length} caminho(s) (${span}), ${kb2} KB \u2192 ${result}`;
31619
31892
  });
31620
31893
  if (failed) {
31621
31894
  if (!layoutOnly) seen.delete(id);
@@ -31746,7 +32019,7 @@ ${lines.join("\n")}${note}`;
31746
32019
  "canvas_read_board",
31747
32020
  {
31748
32021
  title: "Canvas: ler board",
31749
- description: 'L\xEA um board: n\xF3s (id, tipo, nome, posi\xE7\xE3o, tamanho, campos principais), liga\xE7\xF5es e v\xEDnculo com o IA Lab, sem m\xEDdia. Tamanho "medido" \xE9 o da tela; "gravado" \xE9 o piso (o cart\xE3o cresce com o conte\xFAdo). Obrigat\xF3rio antes de editar (vale para a sess\xE3o). node_ids devolve o data desses n\xF3s, com cada corte marcado (path=\u2026); o valor inteiro (ex.: data.sequence da Montagem) sai no canvas_read_node. Cada cart\xE3o diz a aba (aba=<id curto> ou aba=avulsos), o topo conta os cart\xF5es de cada aba e aba l\xEA uma aba s\xF3.',
32022
+ description: 'L\xEA um board: n\xF3s (id, tipo, nome, posi\xE7\xE3o, tamanho, campos principais), liga\xE7\xF5es e v\xEDnculo com o IA Lab, sem m\xEDdia. Tamanho "medido" \xE9 o da tela; "gravado" \xE9 o piso (o cart\xE3o cresce com o conte\xFAdo). Obrigat\xF3rio antes de editar (vale para a sess\xE3o). node_ids devolve s\xF3 o data desses n\xF3s, sem o resto do board, com cada corte marcado (path=\u2026); o valor inteiro (ex.: data.sequence da Montagem) sai no canvas_read_node. Cada cart\xE3o diz a aba (aba=<id curto> ou aba=avulsos), o topo conta os cart\xF5es de cada aba e aba l\xEA uma aba s\xF3.',
31750
32023
  inputSchema: {
31751
32024
  board_id: boardId3,
31752
32025
  node_ids: external_exports.array(nodeIdArg2).max(20).optional().describe("N\xF3s para ver o data (sem blobs, cortes marcados)."),
@@ -31754,11 +32027,26 @@ ${lines.join("\n")}${note}`;
31754
32027
  },
31755
32028
  annotations: { readOnlyHint: true, openWorldHint: false }
31756
32029
  },
31757
- async ({ board_id, node_ids, aba }) => run(async () => {
31758
- const snap = await api.snapshot(board_id);
31759
- const tab = aba ? resolveTab(snap.doc, aba, { allowAvulsos: true }) : void 0;
31760
- seen.set(board_id, snap.seq);
32030
+ async ({ board_id: board_id2, node_ids, aba: aba2 }) => run(async () => {
32031
+ if (node_ids?.length && !aba2) {
32032
+ const read = await api.readNodes(board_id2, node_ids);
32033
+ if (!seen.has(board_id2)) seen.set(board_id2, read.seq);
32034
+ const found = node_ids.flatMap((n) => read.nodes[n] ? [read.nodes[n]] : []);
32035
+ return [
32036
+ `Board "${read.title}" \xB7 id ${board_id2} \xB7 seq ${read.seq} \xB7 ${node_ids.length} n\xF3(s) pedido(s)`,
32037
+ "",
32038
+ ...found.flatMap((n) => nodeLines(n)),
32039
+ "",
32040
+ "Detalhe:",
32041
+ ...node_ids.map((n) => read.nodes[n] ? nodeDetail(read.nodes[n]) : `${n}: n\xE3o existe`)
32042
+ ].join("\n");
32043
+ }
32044
+ const snap = await api.snapshot(board_id2);
32045
+ const tab = aba2 ? resolveTab(snap.doc, aba2, { allowAvulsos: true }) : void 0;
32046
+ seen.set(board_id2, snap.seq);
31761
32047
  const parts = [boardSummary(snap, { tab })];
32048
+ const locks = await api.tabLocks(board_id2).catch(() => []);
32049
+ if (locks.length) parts.push("", "Travas de sess\xE3o:", ...locks.map((l) => `- ${describeLock(l)}`));
31762
32050
  if (node_ids?.length) {
31763
32051
  parts.push("", "Detalhe:");
31764
32052
  for (const n of node_ids) parts.push(snap.doc.nodes[n] ? nodeDetail(snap.doc.nodes[n]) : `${n}: n\xE3o existe`);
@@ -31780,9 +32068,9 @@ ${lines.join("\n")}${note}`;
31780
32068
  },
31781
32069
  annotations: { readOnlyHint: true, openWorldHint: false }
31782
32070
  },
31783
- async ({ board_id, node_id, path, offset, max_chars }) => run(async () => {
31784
- const snap = await api.snapshot(board_id);
31785
- const node = snap.doc.nodes[node_id];
32071
+ async ({ board_id: board_id2, node_id, path, offset, max_chars }) => run(async () => {
32072
+ const read = await api.readNodes(board_id2, [node_id]);
32073
+ const node = read.nodes[node_id];
31786
32074
  if (!node) throw new CanvasToolError(`N\xF3 ${node_id} n\xE3o existe no board. Releia com canvas_read_board.`);
31787
32075
  let value = visibleData(node.data);
31788
32076
  let segments = dataSegments(path);
@@ -31815,10 +32103,10 @@ ${lines.join("\n")}${note}`;
31815
32103
  const from = Math.min(offset ?? 0, total);
31816
32104
  const size = max_chars ?? 4e4;
31817
32105
  const to = Math.min(from + size, total);
31818
- const hash = createHash2("sha256").update(json).digest("hex").slice(0, 12);
32106
+ const hash = createHash3("sha256").update(json).digest("hex").slice(0, 12);
31819
32107
  const where = `data${segments.length ? `.${segments.join(".")}` : ""}`;
31820
32108
  const at = readMeasured(node)?.at;
31821
- const head = `${node.id} \xB7 ${nodeKind(node) ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" \xB7 board seq ${snap.seq} \xB7 tamanho ${sizeLabel(node)}${at ? ` \xB7 medido em ${at}` : ""} \xB7 ${where}${which}: ${total} caracteres (JSON compacto) \xB7 sha256 ${hash}`;
32109
+ const head = `${node.id} \xB7 ${nodeKind(node) ?? node.type} \xB7 "${oneLine2(nodeName(node), 60)}" \xB7 board seq ${read.seq} \xB7 tamanho ${sizeLabel(node)}${at ? ` \xB7 medido em ${at}` : ""} \xB7 ${where}${which}: ${total} caracteres (JSON compacto) \xB7 sha256 ${hash}`;
31822
32110
  const part = from === 0 && to === total ? "Inteiro, abaixo." : `Parte: caracteres ${from} a ${to} de ${total}. ${to < total ? `Falta o resto: chame de novo com offset=${to}.` : "Esta \xE9 a \xFAltima parte."}`;
31823
32111
  return `${head}
31824
32112
  ${part}
@@ -31879,12 +32167,13 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31879
32167
  "canvas_add_node",
31880
32168
  {
31881
32169
  title: "Canvas: adicionar n\xF3",
31882
- description: `Adiciona um n\xF3 (n\xE3o executa). ${READ}kind: ${kindList()}. data completa o padr\xE3o do tipo; label d\xE1 o nome. Sem position, nasce ao lado do n\xF3 ligado ou \xE0 direita do board (com aba, no fim do conte\xFAdo da aba); aba grava data.abaId. Texto livre (label) sem size {w} nasce na largura do tamanho do texto: titulo 2000, subtitulo 1200, corpo 320. Prompt sem size nasce com 1024 \xD7 516; gerador de imagem ou v\xEDdeo, com altura 516 e a largura do aspect_ratio (16:9 917, 9:16 290, 1:1 516). inputs/outputs j\xE1 ligam o n\xF3 no mesmo passo. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
32170
+ description: `Adiciona um n\xF3 (n\xE3o executa). ${READ}kind: ${kindList()}. data completa o padr\xE3o do tipo; label d\xE1 o nome. Sem position, nasce ao lado do n\xF3 ligado ou \xE0 direita do board (com aba, no fim do conte\xFAdo da aba); aba grava data.abaId. Texto livre (label) sem size {w} nasce na largura do tamanho do texto: titulo 2000, subtitulo 1200, corpo 320. Prompt sem size nasce com 1024 \xD7 516; gerador de imagem ou v\xEDdeo, com altura 516 e a largura do aspect_ratio (16:9 917, 9:16 290, 1:1 516). inputs/outputs j\xE1 ligam o n\xF3 no mesmo passo. ${FILE_NOTE}data_files {"template": "/tmp/prompt.md"} grava o texto do arquivo nesse caminho do data, igual a ter vindo em data. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
31883
32171
  inputSchema: {
31884
32172
  board_id: boardId3,
31885
32173
  kind: external_exports.string().min(1).max(40),
31886
32174
  label: external_exports.string().trim().min(1).max(120).optional().describe("Nome do cart\xE3o (data.label)."),
31887
32175
  data: external_exports.record(external_exports.unknown()).optional().describe("Campos do data. Ex.: narration {blocks:[{id,text}]}, text {text}, prompt {template}."),
32176
+ data_files: external_exports.record(external_exports.string().min(1).max(4096)).optional().describe('Texto vindo de arquivo local: { "<caminho no data>": "<arquivo>" }. Ex.: { "template": "/tmp/prompt.md" }. Prefira a digitar texto grande em data.'),
31888
32177
  aba: abaArg(ABA_ADD_NODE),
31889
32178
  position: point.optional(),
31890
32179
  size: sizeArg.optional(),
@@ -31898,7 +32187,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31898
32187
  const spec = KINDS[args.kind];
31899
32188
  if (!spec) throw new CanvasToolError(`Tipo "${args.kind}" desconhecido. Tipos: ${kindList()}.`);
31900
32189
  const me = await api.me();
31901
- const data = { ...spec.data, ...parseData(args.data), [KIND_FIELD]: args.kind };
32190
+ const input = await withDataFiles(args.data, args.data_files);
32191
+ const data = { ...spec.data, ...parseData(input.data), [KIND_FIELD]: args.kind };
31902
32192
  if (args.label) data.label = args.label;
31903
32193
  if (typeof args.size === "string") data.size = textSizeFor(args.kind, args.size);
31904
32194
  const box = birthBox(args.kind, spec, data, args.size && typeof args.size !== "string" ? boxOf(args.size) : void 0);
@@ -31914,7 +32204,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31914
32204
  if (tab !== void 0) data[TAB_ID_FIELD] = tab;
31915
32205
  const near = args.inputs?.[0] ? doc.nodes[args.inputs[0].from] : args.outputs?.[0] ? doc.nodes[args.outputs[0].to] : void 0;
31916
32206
  const nearTab = near ? homeTabOf(doc, near.id) ?? void 0 : void 0;
31917
- const position = args.position ?? placeFor(doc, box, tab === void 0 ? near : void 0, args.inputs?.[0] ? "right" : "left", tab ?? nearTab);
32207
+ const side = args.inputs?.[0] ? "right" : "left";
32208
+ const position = args.position ?? placeFor(doc, box, tab === void 0 ? near : void 0, side, tab ?? nearTab);
31918
32209
  const zIndex = args.kind === "section" ? SECTION_Z : Object.values(doc.nodes).reduce((t, n) => Math.max(t, n.zIndex), 0) + 1;
31919
32210
  const node = makeNode({ type: WORKFLOW_NODE_TYPE, data, position, size: box, zIndex, createdBy: me });
31920
32211
  const links = [
@@ -31931,11 +32222,12 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31931
32222
  }
31932
32223
  const edges = edgeOps(doc, links, me, /* @__PURE__ */ new Set([node.id]));
31933
32224
  const drawn = edges.ops.flatMap((op) => op.type === "edge.add" ? [op.edge] : []);
31934
- const mention = await mentionOps(doc, [{ node, data: node.data, keys: Object.keys(args.data ?? {}) }], drawn);
32225
+ const mention = await mentionOps(doc, [{ node, data: node.data, keys: Object.keys(input.data) }], drawn);
31935
32226
  return {
31936
32227
  ops: [{ type: "node.add", nodeId: node.id, node }, ...edges.ops, ...mention.ops],
31937
32228
  targets: links.map((l) => l.source === node.id ? l.target : l.source),
31938
- done: `N\xF3 ${args.kind} "${nodeName(node)}" criado: ${node.id}${edges.ops.length ? ` com ${edges.ops.length} liga\xE7\xE3o(\xF5es)` : ""}.${placementNote(doc, node)}${edges.warn}${mention.note}`
32229
+ ...args.position ? {} : { place: { [node.id]: tab !== void 0 ? { tab } : near ? { near: near.id, side } : {} } },
32230
+ done: `N\xF3 ${args.kind} "${nodeName(node)}" criado: ${node.id}${edges.ops.length ? ` com ${edges.ops.length} liga\xE7\xE3o(\xF5es)` : ""}.${placementNote(doc, node)}${edges.warn}${mention.note}${input.note}`
31939
32231
  };
31940
32232
  })
31941
32233
  )
@@ -31944,7 +32236,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
31944
32236
  "canvas_update_node",
31945
32237
  {
31946
32238
  title: "Canvas: editar n\xF3",
31947
- description: `Muda campos do data de um n\xF3, chave a chave (null apaga a chave), sem executar. ${READ}label renomeia; position move; size {w, h} muda a caixa (piso: o cart\xE3o cresce com o conte\xFAdo). N\xE3o troca o tipo. Cada chave \xE9 gravada inteira: leia antes com canvas_read_node e mande o valor completo j\xE1 revisado, para n\xE3o apagar o que outra pessoa escreveu. Para mudar partes de uma estrutura grande (clipes da timeline), use canvas_patch_node, por caminho; v\xE1rios n\xF3s de uma vez, canvas_update_nodes. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
32239
+ description: `Muda campos do data de um n\xF3, chave a chave (null apaga a chave), sem executar. ${READ}label renomeia; position move; size {w, h} muda a caixa (piso: o cart\xE3o cresce com o conte\xFAdo). N\xE3o troca o tipo. Cada chave \xE9 gravada inteira: leia antes com canvas_read_node e mande o valor completo j\xE1 revisado, para n\xE3o apagar o que outra pessoa escreveu. Para mudar partes de uma estrutura grande (clipes da timeline) ou gravar texto grande por arquivo, use canvas_patch_node, por caminho; v\xE1rios n\xF3s de uma vez, canvas_update_nodes. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
31948
32240
  inputSchema: {
31949
32241
  board_id: boardId3,
31950
32242
  node_id: nodeIdArg2,
@@ -32024,7 +32316,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32024
32316
  "canvas_patch_node",
32025
32317
  {
32026
32318
  title: "Canvas: gravar por caminho",
32027
- description: `Grava v\xE1rios caminhos dentro do data de um n\xF3, sem executar: {path, value} grava, {path, unset: true} apaga. ${READ}O caminho atravessa objetos (o n\xEDvel que falta \xE9 criado) e n\xE3o entra em lista: para mudar um item de lista, grave a lista inteira. Quebra sozinho em envelopes de at\xE9 64 KB, em ordem, e devolve o resultado de cada um; entre envelopes n\xE3o h\xE1 atomicidade (o que entrou fica). Serve para mexer em partes de uma estrutura grande, como clipes da timeline da Montagem, sem reenviar tudo. Leia antes com canvas_read_node. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
32319
+ description: `Grava v\xE1rios caminhos dentro do data de um n\xF3, sem executar: {path, value} grava, {path, file} grava o texto de um arquivo local, {path, unset: true} apaga. ${READ}${FILE_NOTE}O caminho atravessa objetos (o n\xEDvel que falta \xE9 criado) e n\xE3o entra em lista: para mudar um item de lista, grave a lista inteira. Quebra sozinho em envelopes de at\xE9 64 KB, em ordem, e devolve o resultado de cada um; entre envelopes n\xE3o h\xE1 atomicidade (o que entrou fica). Serve para mexer em partes de uma estrutura grande, como clipes da timeline da Montagem, sem reenviar tudo. Leia antes com canvas_read_node. ` + DUB_NOTE + MENTION_NOTE + MONTAGE_NOTE,
32028
32320
  inputSchema: {
32029
32321
  board_id: boardId3,
32030
32322
  node_id: nodeIdArg2,
@@ -32032,7 +32324,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32032
32324
  external_exports.object({
32033
32325
  path: external_exports.string().trim().min(1).max(500).describe('Caminho dentro do data (ex.: "timeline.meta.fps"); aceita o prefixo "data.".'),
32034
32326
  value: external_exports.unknown().optional().describe("Valor JSON a gravar (null grava null)."),
32035
- unset: external_exports.literal(true).optional().describe("true apaga a chave.")
32327
+ unset: external_exports.literal(true).optional().describe("true apaga a chave."),
32328
+ file: external_exports.string().min(1).max(4096).optional().describe('Arquivo local cujo texto vira o valor, no lugar de value. Ex.: "/tmp/prompt.md". Prefira a digitar texto grande em value.')
32036
32329
  })
32037
32330
  ).min(1).max(5e3)
32038
32331
  },
@@ -32049,6 +32342,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32049
32342
  let absent = 0;
32050
32343
  const mentionKeys = /* @__PURE__ */ new Set();
32051
32344
  let mentionAt = -1;
32345
+ const read = [];
32052
32346
  for (const [i, item] of args.sets.entries()) {
32053
32347
  const at = `sets[${i}] (${item.path})`;
32054
32348
  const segs = dataSegments(item.path);
@@ -32061,7 +32355,10 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32061
32355
  if (MENTION_KEYS.includes(segs[0])) mentionKeys.add(segs[0]);
32062
32356
  const unset = item.unset === true;
32063
32357
  const hasValue = item.value !== void 0;
32064
- if (unset === hasValue) throw new CanvasToolError(`${at}: mande value OU unset: true.`);
32358
+ const hasFile = item.file !== void 0;
32359
+ if ([unset, hasValue, hasFile].filter(Boolean).length !== 1) {
32360
+ throw new CanvasToolError(`${at}: mande s\xF3 um de value, unset: true ou file.`);
32361
+ }
32065
32362
  if (hasValue && !isJson(item.value)) throw new CanvasToolError(`${at}: value n\xE3o \xE9 JSON v\xE1lido.`);
32066
32363
  let cur = work;
32067
32364
  for (const [j, seg] of segs.slice(0, -1).entries()) {
@@ -32096,7 +32393,9 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32096
32393
  if (MENTION_KEYS.includes(segs[0])) mentionAt = ops.length;
32097
32394
  continue;
32098
32395
  }
32099
- const value = item.value;
32396
+ const file = item.file === void 0 ? null : await readTextFile(item.file);
32397
+ if (file) read.push({ path: segs.join("."), ref: item.file, file });
32398
+ const value = file ? file.text : item.value;
32100
32399
  if (cur && Object.hasOwn(cur, leaf) && JSON.stringify(cur[leaf]) === JSON.stringify(value)) {
32101
32400
  same++;
32102
32401
  continue;
@@ -32112,7 +32411,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32112
32411
  return {
32113
32412
  ops,
32114
32413
  targets: [node.id],
32115
- done: `N\xF3 "${oneLine2(nodeName(node), 40)}" (${node.id}): ${written} caminho(s) gravado(s)` + (skipped ? ` (ignorados: ${skipped})` : "") + mention.note
32414
+ done: `N\xF3 "${oneLine2(nodeName(node), 40)}" (${node.id}): ${written} caminho(s) gravado(s)` + (skipped ? ` (ignorados: ${skipped})` : "") + mention.note + describeTextFiles(read)
32116
32415
  };
32117
32416
  },
32118
32417
  { split: true }
@@ -32199,8 +32498,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32199
32498
  inputSchema: { board_id: boardId3, title: external_exports.string().trim().min(1).max(200) },
32200
32499
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
32201
32500
  },
32202
- async ({ board_id, title }) => run(
32203
- () => edit(board_id, async (doc) => ({
32501
+ async ({ board_id: board_id2, title }) => run(
32502
+ () => edit(board_id2, async (doc) => ({
32204
32503
  ops: doc.title === title ? [] : [{ type: "board.set", field: "title", value: setValue(title) }],
32205
32504
  targets: [],
32206
32505
  done: `Board renomeado: "${doc.title}" \u2192 "${title}"`
@@ -32215,8 +32514,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32215
32514
  inputSchema: { board_id: boardId3 },
32216
32515
  annotations: { readOnlyHint: true, openWorldHint: false }
32217
32516
  },
32218
- async ({ board_id }) => run(async () => {
32219
- const members = await api.members(board_id);
32517
+ async ({ board_id: board_id2 }) => run(async () => {
32518
+ const members = await api.members(board_id2);
32220
32519
  return members.map((m) => {
32221
32520
  const name = [m.firstName, m.lastName].filter(Boolean).join(" ") || m.nickname || "(sem nome)";
32222
32521
  return `- ${m.userId} \xB7 ${name} \xB7 ${m.role}`;
@@ -32235,8 +32534,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32235
32534
  },
32236
32535
  annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
32237
32536
  },
32238
- async ({ board_id, user_id, role }) => run(async () => {
32239
- const r = await api.putMember(board_id, user_id, role);
32537
+ async ({ board_id: board_id2, user_id, role }) => run(async () => {
32538
+ const r = await api.putMember(board_id2, user_id, role);
32240
32539
  return `\u2705 ${r.userId} agora \xE9 ${r.role} no board.`;
32241
32540
  })
32242
32541
  );
@@ -32248,13 +32547,14 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32248
32547
  inputSchema: { board_id: boardId3, user_id: external_exports.string().uuid() },
32249
32548
  annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
32250
32549
  },
32251
- async ({ board_id, user_id }) => run(async () => {
32252
- await api.removeMember(board_id, user_id);
32550
+ async ({ board_id: board_id2, user_id }) => run(async () => {
32551
+ await api.removeMember(board_id2, user_id);
32253
32552
  return `\u2705 ${user_id} n\xE3o tem mais acesso ao board.`;
32254
32553
  })
32255
32554
  );
32256
32555
  registerCanvasCommentTools(server, api, run);
32257
32556
  registerCanvasMediaTools(server, { api, cfg, run, edit, seen, placeFor });
32557
+ registerCanvasLockTools(server, { api, run });
32258
32558
  registerCanvasLayoutTools(server, { api, run, edit });
32259
32559
  registerCanvasRunTools(server, api, run);
32260
32560
  registerCanvasFocusTools(server, api, run);
@@ -32264,7 +32564,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
32264
32564
  import { createRequire } from "module";
32265
32565
  var require2 = createRequire(import.meta.url);
32266
32566
  function readVersion() {
32267
- if ("0.47.0") return "0.47.0";
32567
+ if ("0.50.0") return "0.50.0";
32268
32568
  try {
32269
32569
  const pkg = require2("../package.json");
32270
32570
  return pkg.version ?? "0.0.0-unknown";
@@ -32279,7 +32579,7 @@ var SERVER_INSTRUCTIONS = [
32279
32579
  "BePlus: tudo roda pela conta do usu\xE1rio (diamantes, limites e hist\xF3rico na plataforma).",
32280
32580
  'M\xEDdia: generate_* e elevenlabs_* gastam diamantes; confira com estimate_cost antes de lotes grandes. Sem project, a gera\xE7\xE3o cai no projeto ativo; billing:"personal" cobra do usu\xE1rio.',
32281
32581
  "Calls: search_calls acha, get_call traz a transcri\xE7\xE3o.",
32282
- "Canvas online (canvas_*): leia com canvas_read_board antes de editar e siga o estado lido. Cada edi\xE7\xE3o vai num passo s\xF3; se outra pessoa mexeu nos mesmos n\xF3s, a ferramenta recusa e pede releitura. As canvas_* n\xE3o geram m\xEDdia, exceto canvas_run: roda n\xF3s pela aba do Canvas aberta do usu\xE1rio e gasta diamantes; max_diamonds \xE9 o teto que o usu\xE1rio autorizou (dry_run s\xF3 estima). D\xEA nome (label) aos n\xF3s, n\xE3o invente tipos nem portas, e confirme antes de canvas_delete.",
32582
+ "Canvas online (canvas_*): leia com canvas_read_board antes de editar e siga o estado lido. Cada edi\xE7\xE3o vai num passo s\xF3; se outra pessoa mexeu nos mesmos n\xF3s, a ferramenta recusa e pede releitura. As canvas_* n\xE3o geram m\xEDdia, exceto canvas_run: roda n\xF3s no servidor e gasta diamantes; max_diamonds \xE9 o teto que o usu\xE1rio autorizou (dry_run s\xF3 estima). D\xEA nome (label) aos n\xF3s, n\xE3o invente tipos nem portas, e confirme antes de canvas_delete.",
32283
32583
  "Cada aba \xE9 um plano: ao criar, passe aba (id da se\xE7\xE3o) em canvas_add_node e canvas_upload_media, sen\xE3o o cart\xE3o pode cair em Avulsos. canvas_read_board com aba l\xEA uma aba s\xF3.",
32284
32584
  'Mostrar algo ao usu\xE1rio ("olha aqui"): canvas_focus leva a aba do Canvas que ele est\xE1 olhando at\xE9 os n\xF3s e os seleciona uma vez, sem prender a aba, sem gasto e sem escrita no board. follow: true prende a aba na \xE1rea at\xE9 o \xD7: s\xF3 se ele pedir.',
32285
32585
  '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.',