beplus-mcp 0.28.0 → 0.30.0

package/dist/index.js

@@ -22141,7 +22141,9 @@ var IMAGE_MODELS = [
   "midjourney"
 ];
 var SEEDREAM_LITE_SIZES = ["2K", "3K", "4K"];
-var SEEDREAM_PRO_SIZES = ["1K", "2K"];
+var SEEDREAM_PRO_SIZES = ["1K", "1.5K", "2K"];
+var SEEDREAM_PRO_PIXELS = { min: 921600, max: 4624220 };
+var SEEDREAM_PRO_MAX_IMAGES = 4;
 var VIDEO_MODELS = [
   "bytedance/seedance-2.5",
   "bytedance/seedance-2.0",
@@ -22263,17 +22265,25 @@ function registerGenerationTools(server, client, cfg) {
         // que o modelo aceita (Seedream/nano-banana não têm limite publicado).
         prompt: external_exports.string().min(1).describe("Descri\xE7\xE3o da imagem desejada."),
         model: external_exports.enum(IMAGE_MODELS).default(DEFAULTS.imageModel).describe(
-          "nano-banana-2 = barato/r\xE1pido; 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 \u2014 preserva o personagem da refer\xEAncia mas costuma reinterpretar o estilo (um vetor flat volta em 3D)."
+          "nano-banana-2 = barato/r\xE1pido; 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)."
+        ),
+        aspect_ratio: external_exports.enum(ASPECT_RATIOS).optional().describe(
+          "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."
         ),
-        aspect_ratio: external_exports.enum(ASPECT_RATIOS).optional().describe("Propor\xE7\xE3o (nano-banana). Padr\xE3o 1:1."),
         resolution: external_exports.enum(IMAGE_RESOLUTIONS).optional().describe("Resolu\xE7\xE3o (nano-banana): 1K/2K/4K. Padr\xE3o 1K."),
         reference_images: external_exports.array(external_exports.string().min(1)).max(16).optional().describe(
           "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)."
         ),
         google_search: external_exports.boolean().optional().describe("nano-banana-2: aterra a imagem em busca web do Google (fatos atuais). Padr\xE3o false."),
         image_search: external_exports.boolean().optional().describe("nano-banana-2: usa busca de imagens do Google como refer\xEAncia visual. Padr\xE3o false."),
-        size: external_exports.enum(["1024x1024", "1536x1024", "1024x1536", "auto", "1K", "2K", "3K", "4K"]).optional().describe(
-          "Tamanho. gpt-image-1/2: 1024x1024/1536x1024/1024x1536/auto. Seedream Lite: 2K/3K/4K (padr\xE3o 2K). Seedream Pro: 1K/2K apenas \u2014 o Pro N\xC3O faz 3K/4K."
+        size: external_exports.union([
+          external_exports.enum(["1024x1024", "1536x1024", "1024x1536", "auto", "1K", "1.5K", "2K", "3K", "4K"]),
+          external_exports.string().regex(/^\d{3,5}x\d{3,5}$/, "use LARGURAxALTURA, ex.: 2048x1152")
+        ]).optional().describe(
+          "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."
+        ),
+        num_images: external_exports.number().int().min(1).max(SEEDREAM_PRO_MAX_IMAGES).optional().describe(
+          "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."
         ),
         batch_images: external_exports.number().int().min(2).max(15).optional().describe(
           "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."
@@ -22314,7 +22324,19 @@ function registerGenerationTools(server, client, cfg) {
         const isSeedream = isSeedreamLite || isSeedreamPro;
         if (isSeedream) {
           const allowed = isSeedreamPro ? SEEDREAM_PRO_SIZES : SEEDREAM_LITE_SIZES;
-          if (args.size && !allowed.includes(args.size)) {
+          const free = args.size?.match(/^(\d+)x(\d+)$/);
+          if (isSeedreamPro && free) {
+            const w = Number(free[1]);
+            const h = Number(free[2]);
+            if (w * h < SEEDREAM_PRO_PIXELS.min || w * h > SEEDREAM_PRO_PIXELS.max) {
+              return errorResult(
+                `size ${args.size} d\xE1 ${w * h} pixels; o Pro aceita entre ${SEEDREAM_PRO_PIXELS.min} e ${SEEDREAM_PRO_PIXELS.max} (ex.: 1280x720 a 2048x2048).`
+              );
+            }
+            if (w / h > 16 || h / w > 16) {
+              return errorResult(`size ${args.size}: a propor\xE7\xE3o precisa ficar entre 1:16 e 16:1.`);
+            }
+          } else if (args.size && !allowed.includes(args.size)) {
             return errorResult(
               `${args.model} aceita size ${allowed.join("/")} (voc\xEA pediu ${args.size}). ` + (isSeedreamPro ? "O Pro n\xE3o faz 3K/4K \u2014 use o seedream-5.0-lite para resolu\xE7\xF5es maiores." : "O Lite n\xE3o faz 1K \u2014 use o seedream-5.0-pro se quiser a resolu\xE7\xE3o menor.")
             );
@@ -22336,6 +22358,11 @@ function registerGenerationTools(server, client, cfg) {
         } else if (args.batch_images) {
           return errorResult("batch_images s\xF3 existe no bytedance/seedream-5.0-lite.");
         }
+        if (args.num_images && args.num_images > 1 && !isSeedreamPro) {
+          return errorResult(
+            "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."
+          );
+        }
         if (args.background === "transparent") {
           if (args.model !== "openai/gpt-image-1") {
             return errorResult(
@@ -22365,6 +22392,7 @@ function registerGenerationTools(server, client, cfg) {
           // amigável exposto aqui.
           sequential_image_generation: isSeedreamLite && args.batch_images ? "auto" : void 0,
           max_images: isSeedreamLite && args.batch_images ? args.batch_images : void 0,
+          num_images: isSeedreamPro && args.num_images && args.num_images > 1 ? args.num_images : void 0,
           quality: isMidjourney ? args.mj_quality : args.quality,
           background: args.background,
           moderation: args.moderation,
@@ -23004,7 +23032,7 @@ function probeWebp(b) {
 }
 function mp4Info(b) {
   let duration3;
-  let width = 0;
+  let width2 = 0;
   let height = 0;
   let frames = 0;
   let mediaDuration;
@@ -23046,8 +23074,8 @@ function mp4Info(b) {
           const rotated = Math.abs(a) < 0.01 && Math.abs(d) < 0.01;
           const tw = Math.round(rotated ? h : w);
           const th = Math.round(rotated ? w : h);
-          if (tw * th > width * height) {
-            width = tw;
+          if (tw * th > width2 * height) {
+            width2 = tw;
             height = th;
           }
         }
@@ -23071,8 +23099,8 @@ function mp4Info(b) {
   };
   walk(0, b.length, 0);
   const dur = duration3 ?? mediaDuration;
-  const fps = width && height && dur && frames ? Math.round(frames / dur * 100) / 100 : void 0;
-  return { width, height, duration: dur, fps };
+  const fps = width2 && height && dur && frames ? Math.round(frames / dur * 100) / 100 : void 0;
+  return { width: width2, height, duration: dur, fps };
 }
 function probeMp4(b) {
   const info = mp4Info(b);
@@ -23100,9 +23128,9 @@ async function probeMedia(ref) {
   }
   if (!head.length) throw new ProbeError("Arquivo vazio.");
   if (kind === "image") {
-    const dim = probePng(head) ?? probeJpeg(head) ?? probeWebp(head);
-    if (!dim) throw new ProbeError("N\xE3o consegui ler as dimens\xF5es da imagem pelo cabe\xE7alho.");
-    return { kind, width: dim.width, height: dim.height };
+    const dim2 = probePng(head) ?? probeJpeg(head) ?? probeWebp(head);
+    if (!dim2) throw new ProbeError("N\xE3o consegui ler as dimens\xF5es da imagem pelo cabe\xE7alho.");
+    return { kind, width: dim2.width, height: dim2.height };
   }
   let info = probeMp4(head);
   if (!info) {
@@ -23186,8 +23214,8 @@ function probeMp3(b) {
 function probeBuffer(b, mime) {
   const round = (n) => Math.round(n * 1e3) / 1e3;
   if (mime.startsWith("image/")) {
-    const dim = probePng(b) ?? probeJpeg(b) ?? probeWebp(b) ?? probeGif(b);
-    return dim ? { width: dim.width, height: dim.height } : null;
+    const dim2 = probePng(b) ?? probeJpeg(b) ?? probeWebp(b) ?? probeGif(b);
+    return dim2 ? { width: dim2.width, height: dim2.height } : null;
   }
   if (/^(video|audio)\/(mp4|quicktime|x-m4v|x-m4a|aac)$/.test(mime) || probeMp4Head(b)) {
     const info = mp4Info(b);
@@ -23316,14 +23344,14 @@ function registerUpscaleTools(server, client, cfg) {
             `"${variant}" n\xE3o \xE9 um modelo de ${isVideo ? "v\xEDdeo" : "imagem"}. Use um destes: ${allowed.join(", ")}.`
           );
         }
-        let width = args.source_width;
+        let width2 = args.source_width;
         let height = args.source_height;
         let duration3 = args.source_duration;
         let fps = args.source_fps;
-        if (!width || !height || isVideo && !duration3) {
+        if (!width2 || !height || isVideo && !duration3) {
           try {
             const probed = await probeMedia(args.file);
-            width = width ?? probed.width;
+            width2 = width2 ?? probed.width;
             height = height ?? probed.height;
             duration3 = duration3 ?? probed.duration;
             fps = fps ?? probed.fps;
@@ -23358,7 +23386,7 @@ function registerUpscaleTools(server, client, cfg) {
           model: variant,
           upscale_factor: factor,
           prompt: args.prompt || label,
-          source_width: width,
+          source_width: width2,
           source_height: height,
           source_duration: duration3,
           source_fps: fps,
@@ -23414,7 +23442,7 @@ ${footer}`);
         }
         const urls = outputUrls(status);
         const list = urls.map((u, i) => `${i + 1}. ${u}`).join("\n") || "(sem URLs)";
-        const saida = width && height ? ` \u2014 sa\xEDda ${width * factor} \xD7 ${height * factor}` : "";
+        const saida = width2 && height ? ` \u2014 sa\xEDda ${width2 * factor} \xD7 ${height * factor}` : "";
         const semAudio = isVideo ? "\nO \xE1udio n\xE3o foi mantido (o Topaz descarta a faixa)." : "";
         return textResult(
           `\u2705 ${isVideo ? "V\xEDdeo" : "Imagem"} melhorado em ${factor}x com ${variant}${saida}.
@@ -23671,6 +23699,8 @@ Limites simult\xE2neos por usu\xE1rio: imagem=${m.limits.perUserMaxImage}, v\xED
         mode: external_exports.string().optional(),
         size: external_exports.string().optional(),
         quality: external_exports.string().optional(),
+        aspect_ratio: external_exports.string().optional().describe("Seedream Pro: a propor\xE7\xE3o muda os pixels e a faixa de pre\xE7o."),
+        num_images: external_exports.number().int().min(1).optional().describe("Seedream Pro: imagens por pedido; cada uma \xE9 cobrada."),
         // Upscale: o preço não sai de uma chave fixa — vem das medidas do
         // arquivo (megapixel de saída na imagem, bloco de 10s no vídeo). Sem
         // elas o backend responde pelo padrão de 1024²/10s, que não é o preço
@@ -23688,14 +23718,14 @@ Limites simult\xE2neos por usu\xE1rio: imagem=${m.limits.perUserMaxImage}, v\xED
     },
     async (args) => {
       try {
-        let width = args.source_width;
+        let width2 = args.source_width;
         let height = args.source_height;
         let duration3 = args.source_duration;
         let fps = args.source_fps;
-        if (args.file && (!width || !height)) {
+        if (args.file && (!width2 || !height)) {
           try {
             const probed = await probeMedia(args.file);
-            width = width ?? probed.width;
+            width2 = width2 ?? probed.width;
             height = height ?? probed.height;
             duration3 = duration3 ?? probed.duration;
             fps = fps ?? probed.fps;
@@ -23712,9 +23742,11 @@ Limites simult\xE2neos por usu\xE1rio: imagem=${m.limits.perUserMaxImage}, v\xED
             mode: args.mode,
             size: args.size,
             quality: args.quality,
+            aspect_ratio: args.aspect_ratio,
+            num_images: args.num_images,
             upscale_factor: args.upscale_factor,
             model_variant: args.model_variant,
-            source_width: width,
+            source_width: width2,
             source_height: height,
             source_duration: duration3,
             source_fps: fps
@@ -24397,11 +24429,14 @@ function isValidNode(key, v) {
 function isValidEdge(key, v) {
   return isRecord(v) && hasOnlyKeys(v, EDGE_KEYS) && v.id === key && typeof v.source === "string" && typeof v.sourcePort === "string" && typeof v.target === "string" && typeof v.targetPort === "string" && isJsonBag(v.data) && isStringOrNull(v.createdBy) && isFiniteNumber(v.createdAt);
 }
+var MEASURED_KEY = "__measured";
 function checkNodePath(path) {
   const segments = path.split(".");
   if (segments.some((s) => s.length === 0)) return `caminho inv\xE1lido "${path}"`;
   if (segments.some((s) => FORBIDDEN_SEGMENTS.includes(s))) return `segmento proibido em "${path}"`;
   const [root, ...rest] = segments;
+  if (root === "data" && rest[0] === MEASURED_KEY)
+    return `data.${MEASURED_KEY} \xE9 o tamanho medido pela tela do Canvas: s\xF3 o Canvas grava`;
   if (root === "data" && rest.length >= 1) return null;
   if (root === "position" && rest.length === 1 && ["x", "y"].includes(rest[0]) || root === "size" && rest.length === 1 && ["w", "h"].includes(rest[0])) return null;
   return `s\xF3 d\xE1 para editar data.*, position.x/y e size.w/h (recebido "${path}")`;
@@ -24549,6 +24584,120 @@ function packEnvelopes(boardId3, ops, actorId, limit = MAX_OP_BYTES - 1024) {
   return out;
 }
 
+// src/canvas/layout.ts
+function readMeasured(node) {
+  const m = node.data[MEASURED_KEY];
+  if (!m || typeof m !== "object" || Array.isArray(m)) return null;
+  const { w, h, at } = m;
+  if (typeof w !== "number" || typeof h !== "number" || !Number.isFinite(w) || !Number.isFinite(h) || w <= 0 || h <= 0) return null;
+  return { w, h, at: typeof at === "string" ? at : null };
+}
+var SAME_WIDTH = 2;
+var WRAP_KINDS = /* @__PURE__ */ new Set(["prompt", "text", "block", "note", "label", "llm", "narration", "copy", "review", "shotlist"]);
+var SCALE_KINDS = /* @__PURE__ */ new Set(["image", "video", "media"]);
+var kindOf = (node) => typeof node.data[KIND_FIELD] === "string" ? node.data[KIND_FIELD] : "";
+function heightAt(kind, baseW, baseH, newW) {
+  if (Math.abs(newW - baseW) <= SAME_WIDTH) return baseH;
+  if (SCALE_KINDS.has(kind) && newW > baseW) return Math.ceil(baseH * newW / baseW);
+  if (WRAP_KINDS.has(kind) && newW < baseW) return Math.ceil(baseH * baseW / newW);
+  return baseH;
+}
+function usedSize(node, floorW = node.size.w) {
+  const kind = kindOf(node);
+  const m = readMeasured(node);
+  if (!m) {
+    const h = Math.max(node.size.h, heightAt(kind, node.size.w, node.size.h, floorW));
+    return { w: floorW, h, source: "gravado", at: null, estimated: h !== node.size.h };
+  }
+  const keepsWidth = Math.abs(floorW - node.size.w) <= SAME_WIDTH;
+  return {
+    w: keepsWidth ? Math.max(floorW, m.w) : floorW,
+    h: Math.max(node.size.h, heightAt(kind, m.w, m.h, floorW)),
+    source: "medido",
+    at: m.at,
+    estimated: Math.abs(floorW - m.w) > SAME_WIDTH
+  };
+}
+function sizeLabel(node) {
+  const u = usedSize(node);
+  const base = `${Math.round(u.w)}\xD7${Math.round(u.h)} ${u.source}`;
+  if (u.source === "medido" && u.estimated) return `${base} (medido em ${Math.round(readMeasured(node).w)} de largura: altura estimada)`;
+  return base;
+}
+var DEFAULT_WIDTHS = { prompt: 1024, image: 560, video: 560, reference: 320, frame: 320, title: 1024 };
+var DEFAULT_GAP = 80;
+var FRAME_PORTS = /* @__PURE__ */ new Set(["frame"]);
+var FEEDS = /* @__PURE__ */ new Set(["prompt", "image", "video"]);
+var outOf = (doc, id) => Object.values(doc.edges).filter((e) => e.source === id);
+function roleOf(doc, node, asTitle) {
+  if (asTitle) return "title";
+  const kind = kindOf(node);
+  if (kind === "prompt" || kind === "video") return kind;
+  if (kind !== "media" && kind !== "image") return "other";
+  const feedsFrame = outOf(doc, node.id).some((e) => FRAME_PORTS.has(e.targetPort) && doc.nodes[e.target] && kindOf(doc.nodes[e.target]) === "video");
+  if (feedsFrame) return "frame";
+  return kind === "media" ? "reference" : "image";
+}
+function hangsRight(doc, node) {
+  const kind = kindOf(node);
+  if (kind !== "media" && kind !== "image") return false;
+  const out = outOf(doc, node.id);
+  if (!out.length) return kind === "media";
+  return out.some((e) => doc.nodes[e.target] && FEEDS.has(kindOf(doc.nodes[e.target])));
+}
+var overlap = (a, b) => a.x < b.x + b.w && b.x < a.x + a.w && a.y < b.y + b.h && b.y < a.y + a.h;
+function arrangeRows(doc, rows, origin, gap = DEFAULT_GAP, widths = DEFAULT_WIDTHS) {
+  const placed = [];
+  const floorOf = (node, role) => role === "other" ? node.size.w : widths[role];
+  const place = (id, row, asTitle, x, y2, alignRight) => {
+    const node = doc.nodes[id];
+    const role = roleOf(doc, node, asTitle);
+    const floorW = floorOf(node, role);
+    const u = usedSize(node, floorW);
+    const w = Math.ceil(u.w);
+    const h = Math.ceil(u.h);
+    const px = alignRight !== void 0 ? alignRight - w : x;
+    const p = { id, row, role, x: Math.round(px), y: Math.round(y2), w, h, source: u.source, estimated: u.estimated, floorW };
+    placed.push(p);
+    return p;
+  };
+  let y = origin.y;
+  rows.forEach((row, r) => {
+    if (row.title) {
+      const t = place(row.title, r, true, origin.x, y);
+      y = t.y + t.h + Math.round(gap / 2);
+    }
+    const top = y;
+    const leftW = Math.max(0, ...row.left.map((id) => Math.ceil(usedSize(doc.nodes[id], floorOf(doc.nodes[id], roleOf(doc, doc.nodes[id], false))).w)));
+    let leftEnd = top;
+    row.left.forEach((id, i) => {
+      const right2 = hangsRight(doc, doc.nodes[id]);
+      const p = place(id, r, false, origin.x, i === 0 ? top : leftEnd + gap, right2 ? origin.x + leftW : void 0);
+      leftEnd = p.y + p.h;
+    });
+    const rightX = origin.x + (row.left.length ? leftW + gap : 0);
+    let rightEnd = top;
+    row.right.forEach((id, i) => {
+      const p = place(id, r, false, rightX, i === 0 ? top : rightEnd + gap);
+      rightEnd = p.y + p.h;
+    });
+    y = Math.max(leftEnd, rightEnd, top) + gap * 2;
+  });
+  const inner = [];
+  for (let i = 0; i < placed.length; i++) {
+    for (let j = i + 1; j < placed.length; j++) if (overlap(placed[i], placed[j])) inner.push([placed[i].id, placed[j].id]);
+  }
+  const ids = new Set(placed.map((p) => p.id));
+  const others = Object.values(doc.nodes).filter((n) => !ids.has(n.id) && kindOf(n) !== "section").map((n) => ({ id: n.id, x: n.position.x, y: n.position.y, ...usedSize(n) }));
+  const outer = [];
+  for (const p of placed) for (const o of others) if (overlap(p, o)) outer.push([p.id, o.id]);
+  const left = Math.min(origin.x, ...placed.map((p) => p.x));
+  const right = Math.max(origin.x, ...placed.map((p) => p.x + p.w));
+  const below = others.filter((o) => o.x < right && left < o.x + o.w).map((o) => o.y + o.h);
+  const freeOrigin = { x: origin.x, y: below.length ? Math.max(origin.y, Math.ceil(Math.max(...below) + gap * 2)) : origin.y };
+  return { placed, inner, outer, freeOrigin };
+}
+
 // src/canvas/summary.ts
 var MAX_TEXT = 160;
 var MAX_BLOCKS = 40;
@@ -24571,8 +24720,14 @@ var HEAVY_KEYS = /* @__PURE__ */ new Set([
   "settings",
   "enabledKeys",
   "checks",
-  "versions"
+  "versions",
+  MEASURED_KEY
 ]);
+function visibleData(data) {
+  if (!Object.hasOwn(data, MEASURED_KEY)) return data;
+  const { [MEASURED_KEY]: _measured, ...rest } = data;
+  return rest;
+}
 var NAME_KEYS = /* @__PURE__ */ new Set([KIND_FIELD, "label", "nodeTitle"]);
 function oneLine(text, max = MAX_TEXT) {
   const flat = text.replace(/\s+/g, " ").trim();
@@ -24625,7 +24780,7 @@ function rowsLines(rows) {
 function nodeLines(node, run) {
   const kind = nodeKind(node);
   const spec = kind ? KINDS[kind] : void 0;
-  const head = `- ${node.id} \xB7 ${kind ?? node.type} \xB7 "${oneLine(nodeName(node), 60)}" @(${Math.round(node.position.x)},${Math.round(node.position.y)})`;
+  const head = `- ${node.id} \xB7 ${kind ?? node.type} \xB7 "${oneLine(nodeName(node), 60)}" @(${Math.round(node.position.x)},${Math.round(node.position.y)}) ${sizeLabel(node)}`;
   const facts = [];
   const extra = [];
   const d = node.data;
@@ -24690,7 +24845,7 @@ function boardSummary(snap) {
     lines.push(`IA Lab: vinculado${label ? ` a ${String(label)}` : ""}.`);
   }
   if (doc.meta?.guide) lines.push(`Guia: ${oneLine(doc.meta.guide)}`);
-  lines.push("", "N\xF3s:");
+  lines.push("", "N\xF3s (tamanho: medido = como est\xE1 na tela; gravado = piso, o cart\xE3o pode ser maior):");
   if (!nodes.length) lines.push("(vazio)");
   for (const n of nodes) lines.push(...nodeLines(n, runs.get(n.id)));
   lines.push("", "Liga\xE7\xF5es:");
@@ -24734,12 +24889,28 @@ function nodeDetail(node) {
     }
     return v;
   };
-  const json2 = JSON.stringify(strip(node.data, 0, ""));
+  const json2 = JSON.stringify(strip(visibleData(node.data), 0, ""));
   const note = cuts ? `
 (${cuts} corte(s) marcado(s) com path=\u2026: leia inteiro com canvas_read_node e esse path)` : "";
-  return `${node.id} \xB7 ${nodeKind(node) ?? node.type} \xB7 "${nodeName(node)}"
+  return `${node.id} \xB7 ${nodeKind(node) ?? node.type} \xB7 "${nodeName(node)}" \xB7 ${sizeLabel(node)}
 ${json2}${note}`;
 }
+var isMeasureNoise = (op) => op.type === "node.set" && typeof op.path === "string" && (op.path === `data.${MEASURED_KEY}` || op.path.startsWith(`data.${MEASURED_KEY}.`));
+function withoutMeasureNoise(envelopes) {
+  const clean = (op) => {
+    if (op.type === "batch" && Array.isArray(op.ops)) {
+      const ops = op.ops.map((o) => clean(o)).filter((o) => o !== null);
+      return ops.length ? { ...op, ops } : null;
+    }
+    return isMeasureNoise(op) ? null : op;
+  };
+  const out = [];
+  for (const e of envelopes) {
+    const op = clean(e.op);
+    if (op) out.push({ ...e, op });
+  }
+  return out;
+}
 function changesSince(envelopes, doc) {
   const count = /* @__PURE__ */ new Map();
   for (const e of envelopes) {
@@ -25049,6 +25220,158 @@ Para aplicar: leia o n\xF3 com canvas_read_board (node_ids), edite pelas canvas_
   );
 }
 
+// src/tools/canvas-layout.ts
+var nodeIdArg = external_exports.string().min(1).max(128);
+var width = external_exports.number().finite().min(40).max(2e4);
+var ROLE_TEXT = {
+  title: "t\xEDtulo",
+  prompt: "prompt",
+  image: "imagem",
+  video: "v\xEDdeo",
+  reference: "ref",
+  frame: "frame",
+  other: "outro"
+};
+function checkRows(doc, rows) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const [i, row] of rows.entries()) {
+    const ids = [...row.title ? [row.title] : [], ...row.left, ...row.right];
+    if (!ids.length) throw new CanvasToolError(`rows[${i}] est\xE1 vazia: informe title, left ou right.`);
+    for (const id of ids) {
+      const node = doc.nodes[id];
+      if (!node) throw new CanvasToolError(`rows[${i}]: o n\xF3 ${id} n\xE3o existe no board. Releia com canvas_read_board.`);
+      if (node.data[KIND_FIELD] === "section") throw new CanvasToolError(`rows[${i}]: ${id} \xE9 uma Se\xE7\xE3o (fundo), n\xE3o entra no arranjo.`);
+      if (seen.has(id)) throw new CanvasToolError(`O n\xF3 ${id} aparece duas vezes nas linhas: cada n\xF3 entra uma vez s\xF3.`);
+      seen.add(id);
+    }
+  }
+}
+function layoutOps(doc, a) {
+  const ops = [];
+  for (const p of a.placed) {
+    const node = doc.nodes[p.id];
+    const set = (path, now, next) => {
+      if (now !== next) ops.push({ type: "node.set", nodeId: p.id, path, value: setValue(next) });
+    };
+    set("position.x", node.position.x, p.x);
+    set("position.y", node.position.y, p.y);
+    set("size.w", node.size.w, p.floorW);
+  }
+  return ops;
+}
+function report(doc, a) {
+  const name = (id) => `"${oneLine(nodeName(doc.nodes[id]), 36)}"`;
+  const lines = [];
+  const unmeasured = a.placed.filter((p) => p.source === "gravado");
+  const estimated = a.placed.filter((p) => p.source === "medido" && p.estimated);
+  if (unmeasured.length || estimated.length) {
+    lines.push("A conferir (a altura usada pode n\xE3o ser a da tela):");
+    if (unmeasured.length) {
+      lines.push(
+        `- sem medida da tela (usei o gravado): o cart\xE3o est\xE1 no piso, e a\xED o gravado \xE9 o da tela, ou o board n\xE3o abriu desde a \xFAltima mudan\xE7a, e a\xED pode ser maior: ${unmeasured.map((p) => name(p.id)).join(", ")}`
+      );
+    }
+    if (estimated.length) {
+      const how = estimated.map((p) => `${name(p.id)} (medido com ${Math.round(readMeasured(doc.nodes[p.id]).w)} de largura)`);
+      lines.push(`- altura estimada com folga porque a largura mudou: ${how.join(", ")}`);
+    }
+    lines.push(
+      "Se o board n\xE3o abriu desde a \xFAltima mudan\xE7a, abra (o Canvas mede o cart\xE3o que passa do piso) e rode o mesmo canvas_arrange_rows de novo para fechar sobra ou encosto."
+    );
+  } else {
+    lines.push("Todos os n\xF3s arrumados t\xEAm medida da tela.");
+  }
+  const pairs = (list) => list.map(([x, y]) => `${name(x)} \xD7 ${name(y)}`).join("; ");
+  lines.push(
+    a.inner.length || a.outer.length ? `Sobreposi\xE7\xF5es com os tamanhos usados: ${pairs([...a.inner, ...a.outer])}.` : "Sobreposi\xE7\xF5es com os tamanhos usados: nenhuma."
+  );
+  lines.push('Caixas ([papel] id "nome" @(x,y) largura\xD7altura usada, origem da altura):');
+  const rows = /* @__PURE__ */ new Map();
+  for (const p of a.placed) {
+    const item = `[${ROLE_TEXT[p.role]}] ${p.id} ${name(p.id)} @(${p.x},${p.y}) ${p.w}\xD7${p.h} ${p.source}${p.estimated ? " estimado" : ""}`;
+    rows.set(p.row, [...rows.get(p.row) ?? [], item]);
+  }
+  for (const [r, items] of rows) lines.push(`- linha ${r + 1}: ${items.join(" \xB7 ")}`);
+  const resized = a.placed.filter((p) => p.floorW !== doc.nodes[p.id].size.w);
+  if (resized.length) lines.push(`Largura (size.w): ${resized.map((p) => `${name(p.id)} ${doc.nodes[p.id].size.w}\u2192${p.floorW}`).join(", ")}.`);
+  const titles = a.placed.filter((p) => p.role === "title" && doc.nodes[p.id].data[KIND_FIELD] === "label" && doc.nodes[p.id].data.size !== "titulo");
+  if (titles.length) {
+    lines.push(
+      `T\xEDtulo sem o texto de t\xEDtulo: ${titles.map((p) => name(p.id)).join(", ")}. Troque com canvas_update_node size:"titulo" (o arranjo s\xF3 grava posi\xE7\xE3o e tamanho).`
+    );
+  }
+  return lines.join("\n");
+}
+function registerCanvasLayoutTools(server, deps) {
+  const { api, run, edit } = deps;
+  server.registerTool(
+    "canvas_arrange_rows",
+    {
+      title: "Canvas: arrumar em linhas",
+      description: "Arruma n\xF3s em linhas, uma por vers\xE3o (revis\xE3o de imagem) ou por take (anima\xE7\xE3o), de cima para baixo a partir de origin: title em cima; \xE0 esquerda a coluna left (prompt; m\xEDdia/imagem que alimenta o prompt ou o gerador, como a refer\xEAncia e o frame de entrada, fica alinhada \xE0 direita embaixo dele); \xE0 direita a coluna right (gerador) com o topo no do prompt. Qualquer tipo entra em qualquer coluna. Usa o tamanho medido da tela (ou o gravado, avisando) e p\xF5e a largura pelo tipo real do n\xF3: prompt 1024, gerador de imagem 560, de v\xEDdeo 560, refer\xEAncia (m\xEDdia) 320, frame (m\xEDdia/imagem ligada na porta frame do v\xEDdeo) 320, t\xEDtulo 1024. Grava s\xF3 posi\xE7\xE3o e tamanho num passo, sem pedir releitura. Devolve as caixas, as sobreposi\xE7\xF5es com os tamanhos usados e os n\xF3s sem medida (a altura deles pode crescer quando o board abrir: rode de novo depois). Se a \xE1rea encostar em outro n\xF3 do board, n\xE3o grava nada e sugere uma origem livre. dry_run: true s\xF3 calcula.",
+      inputSchema: {
+        board_id: external_exports.string().uuid(),
+        origin: external_exports.object({ x: external_exports.number().finite(), y: external_exports.number().finite() }).describe("Canto de cima \xE0 esquerda da \xE1rea."),
+        rows: external_exports.array(
+          external_exports.object({
+            title: nodeIdArg.optional().describe("N\xF3 do t\xEDtulo da linha (Texto livre)."),
+            left: external_exports.array(nodeIdArg).max(20).optional().describe("Coluna da esquerda, de cima para baixo: prompt, depois a refer\xEAncia."),
+            right: external_exports.array(nodeIdArg).max(20).optional().describe("Coluna da direita: gerador(es).")
+          }).strict()
+        ).min(1).max(50),
+        gap: external_exports.number().finite().min(0).max(1e3).optional().describe(`Espa\xE7o entre cart\xF5es (padr\xE3o ${DEFAULT_GAP}); o dobro entre linhas.`),
+        widths: external_exports.object({
+          prompt: width.optional(),
+          image: width.optional(),
+          video: width.optional(),
+          generator: width.optional().describe("Atalho: image e video juntos."),
+          reference: width.optional(),
+          frame: width.optional(),
+          title: width.optional()
+        }).strict().optional().describe("Troca larguras da conven\xE7\xE3o (prompt 1024, image 560, video 560, reference 320, frame 320, title 1024)."),
+        dry_run: external_exports.boolean().optional().describe("true: s\xF3 calcula e mostra, sem gravar.")
+      },
+      annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
+    },
+    async (args) => run(async () => {
+      const rows = args.rows.map((r) => ({ title: r.title, left: r.left ?? [], right: r.right ?? [] }));
+      const { generator, ...own } = args.widths ?? {};
+      const widths = { ...DEFAULT_WIDTHS, ...generator ? { image: generator, video: generator } : {}, ...own };
+      const gap = args.gap ?? DEFAULT_GAP;
+      const plan = (doc) => {
+        checkRows(doc, rows);
+        const a = arrangeRows(doc, rows, args.origin, gap, widths);
+        return { a, ops: layoutOps(doc, a), text: report(doc, a) };
+      };
+      const count = (ops) => new Set(ops.map((o) => o.type === "node.set" ? o.nodeId : "")).size;
+      const blocked = (a) => `A \xE1rea encosta em n\xF3s que n\xE3o est\xE3o no arranjo. Nada foi gravado. Origem livre sugerida: {"x":${a.freeOrigin.x},"y":${a.freeOrigin.y}} (abaixo de tudo nessa faixa), ou tire esses n\xF3s do caminho.`;
+      if (args.dry_run) {
+        const { a, ops, text: text2 } = plan((await api.snapshot(args.board_id)).doc);
+        const head = `Pr\xE9via, nada gravado: ${ops.length ? `${count(ops)} n\xF3(s) mudariam de lugar ou largura` : "tudo j\xE1 est\xE1 assim"}.`;
+        return [head, ...a.outer.length ? [blocked(a)] : [], text2].join("\n");
+      }
+      let text = "";
+      const done = await edit(
+        args.board_id,
+        async (doc) => {
+          const p = plan(doc);
+          text = p.text;
+          if (p.a.outer.length) throw new CanvasToolError(`${blocked(p.a)}
+${p.text}`);
+          return {
+            ops: p.ops,
+            targets: [],
+            done: `Arranjo: ${rows.length} linha(s), ${p.a.placed.length} n\xF3(s), ${count(p.ops)} mudaram de lugar ou largura`
+          };
+        },
+        { split: true, layoutOnly: true }
+      );
+      return `${done}
+${text}`;
+    })
+  );
+}
+
 // src/canvas/upload.ts
 import { randomUUID as randomUUID2 } from "crypto";
 import { basename as basename2, extname as extname3 } from "path";
@@ -25257,6 +25580,137 @@ ${payload(u)}`
   );
 }
 
+// src/canvas/mentions.ts
+var VIA_MENTION = "viaMention";
+var PROMPT_REFS_INPUT = "refs";
+var PROMPT_MENTION_REFS_INPUT = "mentionRefs";
+var MENTION_KEYS = ["template", "fields", "mentions"];
+var VARIABLE_SOURCE = String.raw`\{\{[ \t]*([\p{L}\p{N}_-]+)[ \t]*\}\}`;
+function extractVariables(text) {
+  const names = /* @__PURE__ */ new Set();
+  for (const m of text.matchAll(new RegExp(VARIABLE_SOURCE, "gu"))) if (m[1]) names.add(m[1]);
+  return [...names];
+}
+function allVariableNames(data) {
+  const names = new Set(extractVariables(typeof data.template === "string" ? data.template : ""));
+  const fields = data.fields;
+  if (fields && typeof fields === "object" && !Array.isArray(fields)) {
+    for (const [id, text] of Object.entries(fields)) {
+      if (id !== "" && typeof text === "string" && text !== "") for (const n of extractVariables(text)) names.add(n);
+    }
+  }
+  return [...names];
+}
+function normalizeMentions(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+  const out = {};
+  for (const [name, entry] of Object.entries(value)) {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
+    const { node, port } = entry;
+    if (name.trim() !== "" && typeof node === "string" && node !== "" && typeof port === "string" && port !== "") {
+      out[name] = { node, port };
+    }
+  }
+  return out;
+}
+function mentionEdgeId(e) {
+  return `mention:${e.source}:${e.sourcePort}>${e.target}:${e.targetPort}`;
+}
+var edgeKey = (e) => `${e.source}\0${e.sourcePort}\0${e.target}\0${e.targetPort}`;
+var isViaMention = (e) => e.data[VIA_MENTION] === true;
+function reachability(doc) {
+  const adj = /* @__PURE__ */ new Map();
+  const link = (s, t) => adj.set(s, (adj.get(s) ?? /* @__PURE__ */ new Set()).add(t));
+  for (const e of Object.values(doc.edges)) link(e.source, e.target);
+  const reaches = (from, to) => {
+    const seen = /* @__PURE__ */ new Set();
+    const stack = [from];
+    while (stack.length) {
+      for (const next of adj.get(stack.pop()) ?? []) {
+        if (next === to) return true;
+        if (!seen.has(next)) {
+          seen.add(next);
+          stack.push(next);
+        }
+      }
+    }
+    return false;
+  };
+  return { wouldCycle: (s, t) => s === t || reaches(t, s), accept: link };
+}
+function originHasPort(doc, origin) {
+  const node = doc.nodes[origin.node];
+  if (!node) return false;
+  const kind = typeof node.data[KIND_FIELD] === "string" ? node.data[KIND_FIELD] : null;
+  if (!kind || !KINDS[kind]) return false;
+  return knownPort(kind, "out", origin.port) !== false;
+}
+function mentionEdgeOps(doc, promptIds, actorId, now = Date.now()) {
+  const out = { ops: [], added: [], removed: [], skipped: [] };
+  const reach = reachability(doc);
+  const edges = Object.values(doc.edges);
+  const desired = /* @__PURE__ */ new Map();
+  const managed = [];
+  for (const id of [...new Set(promptIds)]) {
+    const prompt = doc.nodes[id];
+    if (!prompt || prompt.data[KIND_FIELD] !== "prompt") continue;
+    const into = edges.filter((e) => e.target === id);
+    const vars = new Set(allVariableNames(prompt.data));
+    const mentions2 = normalizeMentions(prompt.data.mentions);
+    const mentionPorts = new Set(into.filter(isViaMention).map((e) => e.targetPort));
+    managed.push(...into.filter((e) => isViaMention(e) && e.targetPort !== PROMPT_REFS_INPUT && e.targetPort !== PROMPT_MENTION_REFS_INPUT));
+    for (const port of /* @__PURE__ */ new Set([...vars, ...mentionPorts])) {
+      if (port === PROMPT_REFS_INPUT || port === PROMPT_MENTION_REFS_INPUT) continue;
+      const origin = vars.has(port) ? mentions2[port] : void 0;
+      if (!origin) continue;
+      if (into.some((e) => e.targetPort === port && !isViaMention(e))) {
+        out.skipped.push(`{{${port}}}: a porta j\xE1 recebe uma liga\xE7\xE3o feita \xE0 m\xE3o`);
+        continue;
+      }
+      if (!doc.nodes[origin.node]) {
+        out.skipped.push(`{{${port}}}: o n\xF3 de origem ${origin.node} n\xE3o existe`);
+        continue;
+      }
+      if (!originHasPort(doc, origin)) {
+        out.skipped.push(`{{${port}}}: a porta "${origin.port}" n\xE3o existe em ${origin.node}`);
+        continue;
+      }
+      if (reach.wouldCycle(origin.node, id)) {
+        out.skipped.push(`{{${port}}}: a liga\xE7\xE3o fecharia um ciclo`);
+        continue;
+      }
+      const link = { source: origin.node, sourcePort: origin.port, target: id, targetPort: port };
+      desired.set(edgeKey(link), link);
+      reach.accept(origin.node, id);
+    }
+  }
+  for (const e of managed) {
+    if (desired.has(edgeKey(e))) continue;
+    out.ops.push({ type: "edge.remove", edgeId: e.id });
+    out.removed.push(e);
+  }
+  for (const [key, link] of desired) {
+    if (edges.some((e) => edgeKey(e) === key)) continue;
+    const edgeId = mentionEdgeId(link);
+    out.ops.push({
+      type: "edge.add",
+      edgeId,
+      edge: { id: edgeId, ...link, data: { [VIA_MENTION]: true }, createdBy: actorId, createdAt: now }
+    });
+    out.added.push(link);
+  }
+  return out;
+}
+function describeMentionSync(sync, name) {
+  const parts = [];
+  if (sync.added.length) {
+    parts.push(`liga\xE7\xE3o de men\xE7\xE3o criada: ${sync.added.map((l) => `${name(l.source)}.${l.sourcePort} \u2192 {{${l.targetPort}}}`).join(", ")}`);
+  }
+  if (sync.removed.length) parts.push(`liga\xE7\xE3o de men\xE7\xE3o removida: ${sync.removed.map((e) => `{{${e.targetPort}}}`).join(", ")}`);
+  if (sync.skipped.length) parts.push(`men\xE7\xE3o sem liga\xE7\xE3o: ${sync.skipped.join("; ")}`);
+  return parts.length ? ` ${parts.join(". ")}.` : "";
+}
+
 // src/tools/canvas.ts
 var REJECT_TEXT = {
   "node-missing": "o n\xF3 n\xE3o existe mais (algu\xE9m apagou)",
@@ -25265,6 +25719,7 @@ var REJECT_TEXT = {
   "too-large": "opera\xE7\xE3o grande demais (64 KB) ou com m\xEDdia embutida"
 };
 var READ = "Exige canvas_read_board nesta sess\xE3o (e de novo depois de uma recusa). ";
+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. ';
 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).";
 function dataSegments(path) {
   const p = path?.trim() ?? "";
@@ -25283,8 +25738,26 @@ function legacySequenceGuard(node, key) {
 var SECTION_Z = -1e3;
 var GAP = 80;
 var boardId2 = external_exports.string().uuid().describe("Id (uuid) do board, como sai em canvas_list_boards.");
-var nodeIdArg = external_exports.string().min(1).max(128);
+var nodeIdArg2 = external_exports.string().min(1).max(128);
 var point = external_exports.object({ x: external_exports.number().finite(), y: external_exports.number().finite() });
+var LABEL_TEXT_SIZES = ["titulo", "subtitulo", "corpo"];
+var dim = external_exports.number().finite().min(16).max(2e4);
+var sizeArg = external_exports.union([external_exports.object({ w: dim.optional(), h: dim.optional() }).strict(), external_exports.enum(LABEL_TEXT_SIZES)]).describe(
+  '{w, h}: caixa do n\xF3 (piso: o cart\xE3o cresce com o conte\xFAdo; um lado s\xF3 vale). "titulo" | "subtitulo" | "corpo": tamanho do texto do Texto livre (label), gravado em data.size.'
+);
+var isLayoutOp = (op) => op.type === "batch" ? op.ops.every(isLayoutOp) : op.type === "node.set" && /^(position\.[xy]|size\.[wh])$/.test(op.path);
+function textSizeFor(kind, size) {
+  if (kind !== "label") {
+    throw new CanvasToolError(
+      `size "${size}" \xE9 o tamanho do texto do Texto livre (label); para ${kind ?? "este n\xF3"} use size {w, h}.`
+    );
+  }
+  return size;
+}
+function boxOf(size) {
+  if (size.w === void 0 && size.h === void 0) throw new CanvasToolError("size {w, h}: informe w, h ou os dois.");
+  return size;
+}
 function registerCanvasTools(server, client, cfg) {
   const api = new CanvasApi(client, cfg);
   const seen = /* @__PURE__ */ new Map();
@@ -25308,7 +25781,7 @@ function registerCanvasTools(server, client, cfg) {
   }
   async function edit(id, build, opts = {}) {
     const last = seen.get(id);
-    if (last === void 0) {
+    if (last === void 0 && !opts.layoutOnly) {
       throw new CanvasToolError("Leia o board com canvas_read_board antes de editar (a leitura vale para a sess\xE3o).");
     }
     const snap = await api.snapshot(id);
@@ -25316,10 +25789,11 @@ function registerCanvasTools(server, client, cfg) {
     const doc = snap.doc;
     const { ops, done, targets } = await build(doc, snap);
     if (!ops.length) return `Nada a mudar. ${done}`;
+    if (opts.layoutOnly && !ops.every(isLayoutOp)) throw new Error("layout_only com opera\xE7\xE3o fora de posi\xE7\xE3o/tamanho");
     let note = "";
-    if (snap.seq > last) {
+    if (!opts.layoutOnly && last !== void 0 && snap.seq > last) {
       const since = await api.opsAfter(id, last);
-      const theirs = since?.filter((e) => e.clientId !== CLIENT_ID) ?? null;
+      const theirs = since === null ? null : withoutMeasureNoise(since.filter((e) => e.clientId !== CLIENT_ID));
       if (theirs === null) {
         seen.delete(id);
         throw new CanvasToolError(
@@ -25337,21 +25811,21 @@ function registerCanvasTools(server, client, cfg) {
       if (theirs.length) note = `
 Aviso: ${changesSince(theirs, doc)}.`;
     }
-    if (opts.split) return commitSplit(id, ops, done, note);
+    if (opts.split) return commitSplit(id, ops, done, note, !!opts.layoutOnly);
     const env = envelope(id, batchOf(ops), await api.me());
     const bad = checkEnvelope(env);
     if (bad) throw new CanvasToolError(`Edi\xE7\xE3o recusada antes de enviar: ${bad}.`);
     const res = await api.commit(id, [env]);
     const outcome = res.outcomes.find((o) => o.opId === env.id);
     if (!outcome || "rejected" in outcome) {
-      seen.delete(id);
+      if (!opts.layoutOnly) seen.delete(id);
       const why = outcome && "rejected" in outcome ? REJECT_TEXT[outcome.rejected] ?? outcome.rejected : "sem resposta do servidor";
       throw new CanvasToolError(`O servidor recusou a edi\xE7\xE3o: ${why}. Nada foi aplicado. Releia com canvas_read_board.`);
     }
-    seen.set(id, res.seq);
+    if (!opts.layoutOnly) seen.set(id, res.seq);
     return `\u2705 ${done} (seq ${res.seq}).${note}`;
   }
-  async function commitSplit(id, ops, done, note) {
+  async function commitSplit(id, ops, done, note, layoutOnly = false) {
     let envs;
     try {
       envs = packEnvelopes(id, ops, await api.me());
@@ -25373,7 +25847,8 @@ Aviso: ${changesSince(theirs, doc)}.`;
       for (const o of res.outcomes) outcomes.set(o.opId, o);
       last = res.seq;
     }
-    const pathsOf = (op) => op.type === "batch" ? op.ops.flatMap(pathsOf) : op.type === "node.set" ? [op.path.replace(/^data\./, "")] : [op.type];
+    const setNodes = new Set(ops.flatMap((op) => op.type === "batch" ? op.ops : [op]).flatMap((op) => op.type === "node.set" ? [op.nodeId] : []));
+    const pathsOf = (op) => op.type === "batch" ? op.ops.flatMap(pathsOf) : op.type === "node.set" ? [`${setNodes.size > 1 ? `${op.nodeId}:` : ""}${op.path.replace(/^data\./, "")}`] : [op.type];
     let failed = 0;
     const lines = envs.map((env, i) => {
       const paths = pathsOf(env.op);
@@ -25384,14 +25859,14 @@ Aviso: ${changesSince(theirs, doc)}.`;
       return `- envelope ${i + 1}/${envs.length}: ${paths.length} caminho(s) (${span}), ${kb} KB \u2192 ${result}`;
     });
     if (failed) {
-      seen.delete(id);
+      if (!layoutOnly) seen.delete(id);
       throw new CanvasToolError(
         `${done}: ${envs.length - failed} de ${envs.length} envelope(s) entraram, ${failed} recusado(s).
 ${lines.join("\n")}
-Os aceitos ficam. Releia com canvas_read_board e canvas_read_node e reenvie s\xF3 os caminhos dos envelopes recusados.` + note
+` + (layoutOnly ? "Os aceitos ficam. Rode de novo: posi\xE7\xE3o e tamanho n\xE3o pedem releitura." : "Os aceitos ficam. Releia com canvas_read_board e canvas_read_node e reenvie s\xF3 os caminhos dos envelopes recusados.") + note
       );
     }
-    if (last !== null) seen.set(id, last);
+    if (last !== null && !layoutOnly) seen.set(id, last);
     return `\u2705 ${done} em ${envs.length} envelope(s) (seq at\xE9 ${last}).
 ${lines.join("\n")}${note}`;
   }
@@ -25445,11 +25920,53 @@ ${lines.join("\n")}${note}`;
     const out = {};
     for (const [k, v] of Object.entries(raw ?? {})) {
       if (k === KIND_FIELD) throw new CanvasToolError("data.kind n\xE3o muda: apague o n\xF3 e crie outro do tipo certo.");
+      if (k === MEASURED_KEY) {
+        throw new CanvasToolError(`data.${MEASURED_KEY} \xE9 o tamanho medido pela tela do Canvas: s\xF3 o Canvas grava. Para mudar a caixa, use size {w, h}.`);
+      }
       if (!isJson(v)) throw new CanvasToolError(`data.${k} n\xE3o \xE9 JSON v\xE1lido.`);
       out[k] = v;
     }
     return out;
   }
+  function changeOps(node, change) {
+    const ops = [];
+    const patch = parseData(change.data);
+    for (const key of Object.keys(patch)) legacySequenceGuard(node, key);
+    if (change.label) patch.label = change.label;
+    let box;
+    if (typeof change.size === "string") patch.size = textSizeFor(nodeKind(node), change.size);
+    else if (change.size) box = boxOf(change.size);
+    const data = { ...node.data };
+    for (const [k, v] of Object.entries(patch)) {
+      const path = `data.${k}`;
+      if (v === null) {
+        if (Object.hasOwn(node.data, k)) ops.push({ type: "node.set", nodeId: node.id, path, value: unsetValue() });
+        delete data[k];
+      } else if (JSON.stringify(node.data[k]) !== JSON.stringify(v)) {
+        ops.push({ type: "node.set", nodeId: node.id, path, value: setValue(v) });
+        data[k] = v;
+      }
+    }
+    const set = (path, now, next) => {
+      if (next !== void 0 && next !== now) ops.push({ type: "node.set", nodeId: node.id, path, value: setValue(next) });
+    };
+    set("position.x", node.position.x, change.position?.x);
+    set("position.y", node.position.y, change.position?.y);
+    set("size.w", node.size.w, box?.w);
+    set("size.h", node.size.h, box?.h);
+    const keys = ops.map((o) => o.type === "node.set" ? o.path.replace(/^data\./, "") : "");
+    return { ops, keys, data, dataKeys: Object.keys(patch) };
+  }
+  async function mentionOps(doc, changed, newEdges = []) {
+    const prompts = changed.filter((c) => nodeKind(c.node) === "prompt" && c.keys.some((k) => MENTION_KEYS.includes(k)));
+    if (!prompts.length) return { ops: [], note: "" };
+    const after = { ...doc, nodes: { ...doc.nodes }, edges: { ...doc.edges } };
+    for (const c of changed) after.nodes[c.node.id] = { ...c.node, data: c.data };
+    for (const e of newEdges) after.edges[e.id] = e;
+    const sync = mentionEdgeOps(after, prompts.map((c) => c.node.id), await api.me());
+    const name = (id) => after.nodes[id] ? `"${oneLine(nodeName(after.nodes[id]), 40)}"` : id;
+    return { ops: sync.ops, note: describeMentionSync(sync, name) };
+  }
   server.registerTool(
     "canvas_list_boards",
     {
@@ -25468,10 +25985,10 @@ ${lines.join("\n")}${note}`;
     "canvas_read_board",
     {
       title: "Canvas: ler board",
-      description: "L\xEA um board: n\xF3s (id, tipo, nome, campos principais), liga\xE7\xF5es e v\xEDnculo com o IA Lab, sem m\xEDdia. 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.",
+      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.',
       inputSchema: {
         board_id: boardId2,
-        node_ids: external_exports.array(nodeIdArg).max(20).optional().describe("N\xF3s para ver o data (sem blobs, cortes marcados).")
+        node_ids: external_exports.array(nodeIdArg2).max(20).optional().describe("N\xF3s para ver o data (sem blobs, cortes marcados).")
       },
       annotations: { readOnlyHint: true, openWorldHint: false }
     },
@@ -25493,7 +26010,7 @@ ${lines.join("\n")}${note}`;
       description: 'Devolve o data de UM n\xF3 sem corte nenhum, em JSON compacto, para conferir e fazer diff. Na Montagem, sem path, vem a timeline do editor: data.timeline, ou data.sequence (legado) quando o n\xF3 ainda n\xE3o tem timeline, e o cabe\xE7alho diz qual veio. path escolhe um peda\xE7o ("items" da M\xEDdia, "timeline.meta"); "data" traz o data todo. Diz o tamanho total e o sha256; acima de max_chars vem em partes expl\xEDcitas (offset). N\xE3o substitui o canvas_read_board, que continua obrigat\xF3rio antes de editar. ' + MONTAGE_NOTE,
       inputSchema: {
         board_id: boardId2,
-        node_id: nodeIdArg,
+        node_id: nodeIdArg2,
         path: external_exports.string().trim().max(200).optional().describe('Caminho dentro do data, com pontos (ex.: "timeline.meta", "items.0"). "data" = o data todo.'),
         offset: external_exports.number().int().min(0).optional().describe("In\xEDcio da parte, em caracteres (padr\xE3o 0)."),
         max_chars: external_exports.number().int().min(1e3).max(6e4).optional().describe("Tamanho da parte (padr\xE3o 40000).")
@@ -25504,8 +26021,11 @@ ${lines.join("\n")}${note}`;
       const snap = await api.snapshot(board_id);
       const node = snap.doc.nodes[node_id];
       if (!node) throw new CanvasToolError(`N\xF3 ${node_id} n\xE3o existe no board. Releia com canvas_read_board.`);
-      let value = node.data;
+      let value = visibleData(node.data);
       let segments = dataSegments(path);
+      if (segments[0] === MEASURED_KEY) {
+        throw new CanvasToolError(`data.${MEASURED_KEY} \xE9 interno do Canvas (tamanho medido da tela): ele sai no cabe\xE7alho desta leitura.`);
+      }
       let which = "";
       if (!path?.trim() && nodeKind(node) === "montage") {
         if (node.data.timeline !== void 0) {
@@ -25522,9 +26042,9 @@ ${lines.join("\n")}${note}`;
         const here = value;
         value = Array.isArray(here) ? here[Number(seg)] : here && typeof here === "object" ? here[seg] : void 0;
         if (value === void 0) {
-          const at = segments.slice(0, i).join(".");
+          const at2 = segments.slice(0, i).join(".");
           const keys = Array.isArray(here) ? `\xEDndices 0 a ${here.length - 1}` : here && typeof here === "object" ? Object.keys(here).join(", ") : "\u2014";
-          throw new CanvasToolError(`"${seg}" n\xE3o existe em data${at ? `.${at}` : ""}. Existe: ${keys || "\u2014"}.`);
+          throw new CanvasToolError(`"${seg}" n\xE3o existe em data${at2 ? `.${at2}` : ""}. Existe: ${keys || "\u2014"}.`);
         }
       }
       const json2 = JSON.stringify(value);
@@ -25534,7 +26054,8 @@ ${lines.join("\n")}${note}`;
       const to = Math.min(from + size, total);
       const hash = createHash("sha256").update(json2).digest("hex").slice(0, 12);
       const where = `data${segments.length ? `.${segments.join(".")}` : ""}`;
-      const head = `${node.id} \xB7 ${nodeKind(node) ?? node.type} \xB7 "${oneLine(nodeName(node), 60)}" \xB7 board seq ${snap.seq} \xB7 ${where}${which}: ${total} caracteres (JSON compacto) \xB7 sha256 ${hash}`;
+      const at = readMeasured(node)?.at;
+      const head = `${node.id} \xB7 ${nodeKind(node) ?? node.type} \xB7 "${oneLine(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}`;
       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."}`;
       return `${head}
 ${part}
@@ -25595,15 +26116,16 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
     "canvas_add_node",
     {
       title: "Canvas: adicionar n\xF3",
-      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. inputs/outputs j\xE1 ligam o n\xF3 no mesmo passo. ` + MONTAGE_NOTE,
+      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. inputs/outputs j\xE1 ligam o n\xF3 no mesmo passo. ` + MENTION_NOTE + MONTAGE_NOTE,
       inputSchema: {
         board_id: boardId2,
         kind: external_exports.string().min(1).max(40),
         label: external_exports.string().trim().min(1).max(120).optional().describe("Nome do cart\xE3o (data.label)."),
         data: external_exports.record(external_exports.unknown()).optional().describe("Campos do data. Ex.: narration {blocks:[{id,text}]}, text {text}, prompt {template}."),
         position: point.optional(),
-        inputs: external_exports.array(external_exports.object({ from: nodeIdArg, from_port: external_exports.string().min(1), to_port: external_exports.string().min(1) })).max(20).optional().describe("Liga\xE7\xF5es que CHEGAM no n\xF3 novo: from.from_port \u2192 novo.to_port."),
-        outputs: external_exports.array(external_exports.object({ from_port: external_exports.string().min(1), to: nodeIdArg, to_port: external_exports.string().min(1) })).max(20).optional().describe("Liga\xE7\xF5es que SAEM do n\xF3 novo: novo.from_port \u2192 to.to_port.")
+        size: sizeArg.optional(),
+        inputs: external_exports.array(external_exports.object({ from: nodeIdArg2, from_port: external_exports.string().min(1), to_port: external_exports.string().min(1) })).max(20).optional().describe("Liga\xE7\xF5es que CHEGAM no n\xF3 novo: from.from_port \u2192 novo.to_port."),
+        outputs: external_exports.array(external_exports.object({ from_port: external_exports.string().min(1), to: nodeIdArg2, to_port: external_exports.string().min(1) })).max(20).optional().describe("Liga\xE7\xF5es que SAEM do n\xF3 novo: novo.from_port \u2192 to.to_port.")
       },
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
@@ -25614,10 +26136,16 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
         const me = await api.me();
         const data = { ...spec.data, ...parseData(args.data), [KIND_FIELD]: args.kind };
         if (args.label) data.label = args.label;
+        let box = spec.size;
+        if (typeof args.size === "string") data.size = textSizeFor(args.kind, args.size);
+        else if (args.size) {
+          const b = boxOf(args.size);
+          box = { w: b.w ?? spec.size.w, h: b.h ?? spec.size.h };
+        }
         const near = args.inputs?.[0] ? doc.nodes[args.inputs[0].from] : args.outputs?.[0] ? doc.nodes[args.outputs[0].to] : void 0;
-        const position = args.position ?? placeFor(doc, spec.size, near, args.inputs?.[0] ? "right" : "left");
+        const position = args.position ?? placeFor(doc, box, near, args.inputs?.[0] ? "right" : "left");
         const zIndex = args.kind === "section" ? SECTION_Z : Object.values(doc.nodes).reduce((t, n) => Math.max(t, n.zIndex), 0) + 1;
-        const node = makeNode({ type: WORKFLOW_NODE_TYPE, data, position, size: spec.size, zIndex, createdBy: me });
+        const node = makeNode({ type: WORKFLOW_NODE_TYPE, data, position, size: box, zIndex, createdBy: me });
         const links = [
           ...(args.inputs ?? []).map((l) => ({ source: l.from, sourcePort: l.from_port, target: node.id, targetPort: l.to_port })),
           ...(args.outputs ?? []).map((l) => ({ source: node.id, sourcePort: l.from_port, target: l.to, targetPort: l.to_port }))
@@ -25631,10 +26159,12 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
           }
         }
         const edges = edgeOps(doc, links, me, /* @__PURE__ */ new Set([node.id]));
+        const drawn = edges.ops.flatMap((op) => op.type === "edge.add" ? [op.edge] : []);
+        const mention = await mentionOps(doc, [{ node, data: node.data, keys: Object.keys(args.data ?? {}) }], drawn);
         return {
-          ops: [{ type: "node.add", nodeId: node.id, node }, ...edges.ops],
+          ops: [{ type: "node.add", nodeId: node.id, node }, ...edges.ops, ...mention.ops],
           targets: links.map((l) => l.source === node.id ? l.target : l.source),
-          done: `N\xF3 ${args.kind} "${nodeName(node)}" criado: ${node.id}${edges.ops.length ? ` com ${edges.ops.length} liga\xE7\xE3o(\xF5es)` : ""}.${edges.warn}`
+          done: `N\xF3 ${args.kind} "${nodeName(node)}" criado: ${node.id}${edges.ops.length ? ` com ${edges.ops.length} liga\xE7\xE3o(\xF5es)` : ""}.${edges.warn}${mention.note}`
         };
       })
     )
@@ -25643,48 +26173,90 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
     "canvas_update_node",
     {
       title: "Canvas: editar n\xF3",
-      description: `Muda campos do data de um n\xF3, chave a chave (null apaga a chave), sem executar. ${READ}label renomeia. 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. ` + MONTAGE_NOTE,
+      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. ` + MENTION_NOTE + MONTAGE_NOTE,
       inputSchema: {
         board_id: boardId2,
-        node_id: nodeIdArg,
+        node_id: nodeIdArg2,
         data: external_exports.record(external_exports.unknown()).optional().describe("Chaves de data a gravar. Valor null apaga a chave."),
         label: external_exports.string().trim().min(1).max(120).optional(),
-        position: point.optional()
+        position: point.optional(),
+        size: sizeArg.optional()
       },
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
     async (args) => run(
       () => edit(args.board_id, async (doc) => {
         const node = needNode(doc, args.node_id);
-        const ops = [];
-        const patch = parseData(args.data);
-        for (const key of Object.keys(patch)) legacySequenceGuard(node, key);
-        if (args.label) patch.label = args.label;
-        for (const [k, v] of Object.entries(patch)) {
-          const path = `data.${k}`;
-          if (v === null) {
-            if (Object.hasOwn(node.data, k)) ops.push({ type: "node.set", nodeId: node.id, path, value: unsetValue() });
-          } else if (JSON.stringify(node.data[k]) !== JSON.stringify(v)) {
-            ops.push({ type: "node.set", nodeId: node.id, path, value: setValue(v) });
-          }
-        }
-        if (args.position) {
-          ops.push({ type: "node.set", nodeId: node.id, path: "position.x", value: setValue(args.position.x) });
-          ops.push({ type: "node.set", nodeId: node.id, path: "position.y", value: setValue(args.position.y) });
-        }
-        const keys = ops.map((o) => o.type === "node.set" ? o.path.replace(/^data\./, "") : "").join(", ");
-        return { ops, targets: [node.id], done: `N\xF3 "${nodeName(node)}" atualizado: ${keys || "nada mudou"}` };
+        const c = changeOps(node, args);
+        const mention = await mentionOps(doc, [{ node, data: c.data, keys: c.dataKeys }]);
+        return {
+          ops: [...c.ops, ...mention.ops],
+          targets: [node.id],
+          done: `N\xF3 "${nodeName(node)}" atualizado: ${c.keys.join(", ") || "nada mudou"}${mention.note}`
+        };
       })
     )
   );
+  server.registerTool(
+    "canvas_update_nodes",
+    {
+      title: "Canvas: editar v\xE1rios n\xF3s",
+      description: 'Muda v\xE1rios n\xF3s num passo s\xF3, cada um como no canvas_update_node (position, size, label, data com null apagando). layout_only: true aceita s\xF3 position e size {w, h}, n\xE3o exige leitura e n\xE3o recusa por "outra pessoa mexeu" (nesses dois campos vale quem grava por \xFAltimo). Sem layout_only, exige canvas_read_board nesta sess\xE3o e recusa se outra pessoa mexeu em algum desses n\xF3s. Quebra em envelopes de at\xE9 64 KB e relata cada um. Para arrumar linhas inteiras (t\xEDtulo, prompt, refer\xEAncia, gerador), use canvas_arrange_rows.',
+      inputSchema: {
+        board_id: boardId2,
+        nodes: external_exports.array(
+          external_exports.object({
+            node_id: nodeIdArg2,
+            position: point.optional(),
+            size: sizeArg.optional(),
+            label: external_exports.string().trim().min(1).max(120).optional(),
+            data: external_exports.record(external_exports.unknown()).optional().describe("Chaves de data a gravar. Valor null apaga a chave.")
+          }).strict()
+        ).min(1).max(200),
+        layout_only: external_exports.boolean().optional().describe("true: s\xF3 position e size, sem releitura nem recusa por conflito.")
+      },
+      annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
+    },
+    async (args) => run(
+      () => edit(
+        args.board_id,
+        async (doc) => {
+          const ids = args.nodes.map((n) => n.node_id);
+          const dup = ids.find((id, i) => ids.indexOf(id) !== i);
+          if (dup) throw new CanvasToolError(`O n\xF3 ${dup} aparece duas vezes: junte as mudan\xE7as dele num item s\xF3.`);
+          if (args.layout_only) {
+            const bad = args.nodes.find((n) => n.data !== void 0 || n.label !== void 0 || typeof n.size === "string");
+            if (bad) {
+              throw new CanvasToolError(
+                `layout_only aceita s\xF3 position e size {w, h} (o n\xF3 ${bad.node_id} traz ${bad.data !== void 0 ? "data" : bad.label !== void 0 ? "label" : `size "${String(bad.size)}"`}). Tire layout_only para gravar data e label com a checagem de conflito.`
+              );
+            }
+          }
+          const changes = args.nodes.map((n) => {
+            const node = needNode(doc, n.node_id);
+            return { node, ...changeOps(node, n) };
+          });
+          const mention = args.layout_only ? { ops: [], note: "" } : await mentionOps(doc, changes.map((c) => ({ node: c.node, data: c.data, keys: c.dataKeys })));
+          const touched = changes.filter((c) => c.ops.length);
+          const list = touched.slice(0, 12).map((c) => `"${oneLine(nodeName(c.node), 30)}" (${c.keys.join(", ")})`).join("; ");
+          return {
+            ops: [...changes.flatMap((c) => c.ops), ...mention.ops],
+            targets: ids,
+            done: `${touched.length} de ${ids.length} n\xF3(s) atualizado(s)${args.layout_only ? " (layout_only)" : ""}` + (list ? `: ${list}${touched.length > 12 ? `; \u2026 +${touched.length - 12}` : ""}` : "") + mention.note
+          };
+        },
+        { split: true, layoutOnly: !!args.layout_only }
+      )
+    )
+  );
   server.registerTool(
     "canvas_patch_node",
     {
       title: "Canvas: gravar por caminho",
-      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. ` + MONTAGE_NOTE,
+      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. ` + MENTION_NOTE + MONTAGE_NOTE,
       inputSchema: {
         board_id: boardId2,
-        node_id: nodeIdArg,
+        node_id: nodeIdArg2,
         sets: external_exports.array(
           external_exports.object({
             path: external_exports.string().trim().min(1).max(500).describe('Caminho dentro do data (ex.: "timeline.meta.fps"); aceita o prefixo "data.".'),
@@ -25704,6 +26276,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
           const ops = [];
           let same = 0;
           let absent = 0;
+          const mentionKeys = /* @__PURE__ */ new Set();
+          let mentionAt = -1;
           for (const [i, item] of args.sets.entries()) {
             const at = `sets[${i}] (${item.path})`;
             const segs = dataSegments(item.path);
@@ -25713,6 +26287,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
             const path = `data.${segs.join(".")}`;
             const badPath = checkNodePath(path);
             if (badPath) throw new CanvasToolError(`${at}: ${badPath}.`);
+            if (MENTION_KEYS.includes(segs[0])) mentionKeys.add(segs[0]);
             const unset = item.unset === true;
             const hasValue = item.value !== void 0;
             if (unset === hasValue) throw new CanvasToolError(`${at}: mande value OU unset: true.`);
@@ -25747,6 +26322,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
               }
               delete cur[leaf];
               ops.push({ type: "node.set", nodeId: node.id, path, value: unsetValue() });
+              if (MENTION_KEYS.includes(segs[0])) mentionAt = ops.length;
               continue;
             }
             const value = item.value;
@@ -25756,12 +26332,16 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
             }
             if (cur) cur[leaf] = value;
             ops.push({ type: "node.set", nodeId: node.id, path, value: setValue(value) });
+            if (MENTION_KEYS.includes(segs[0])) mentionAt = ops.length;
           }
           const skipped = [same ? `${same} igual(is) ao que j\xE1 estava` : "", absent ? `${absent} unset de caminho que n\xE3o existe` : ""].filter(Boolean).join(", ");
+          const written = ops.length;
+          const mention = await mentionOps(doc, [{ node, data: work, keys: [...mentionKeys] }]);
+          ops.splice(mentionAt < 0 ? ops.length : mentionAt, 0, ...mention.ops);
           return {
             ops,
             targets: [node.id],
-            done: `N\xF3 "${oneLine(nodeName(node), 40)}" (${node.id}): ${ops.length} caminho(s) gravado(s)` + (skipped ? ` (ignorados: ${skipped})` : "")
+            done: `N\xF3 "${oneLine(nodeName(node), 40)}" (${node.id}): ${written} caminho(s) gravado(s)` + (skipped ? ` (ignorados: ${skipped})` : "") + mention.note
           };
         },
         { split: true }
@@ -25775,9 +26355,9 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
       description: `Liga a sa\xEDda de um n\xF3 \xE0 entrada de outro (ids e portas de canvas_read_board). ${READ}Liga\xE7\xE3o repetida \xE9 ignorada.`,
       inputSchema: {
         board_id: boardId2,
-        source: nodeIdArg,
+        source: nodeIdArg2,
         source_port: external_exports.string().min(1).max(80),
-        target: nodeIdArg,
+        target: nodeIdArg2,
         target_port: external_exports.string().min(1).max(80)
       },
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
@@ -25802,8 +26382,8 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
       description: `Apaga n\xF3s (com as liga\xE7\xF5es e varia\xE7\xF5es deles) e/ou liga\xE7\xF5es, num passo s\xF3. Irrevers\xEDvel pelo MCP: confirme com o usu\xE1rio antes. ${READ}N\xE3o apaga o board.`,
       inputSchema: {
         board_id: boardId2,
-        node_ids: external_exports.array(nodeIdArg).max(200).optional(),
-        edge_ids: external_exports.array(nodeIdArg).max(200).optional()
+        node_ids: external_exports.array(nodeIdArg2).max(200).optional(),
+        edge_ids: external_exports.array(nodeIdArg2).max(200).optional()
       },
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
@@ -25904,13 +26484,14 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
   );
   registerCanvasCommentTools(server, api, run);
   registerCanvasMediaTools(server, { api, cfg, run, edit, seen, placeFor });
+  registerCanvasLayoutTools(server, { api, run, edit });
 }
 
 // src/version.ts
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
 function readVersion() {
-  if ("0.28.0") return "0.28.0";
+  if ("0.30.0") return "0.30.0";
   try {
     const pkg = require2("../package.json");
     return pkg.version ?? "0.0.0-unknown";
@@ -25926,6 +26507,7 @@ var SERVER_INSTRUCTIONS = [
   'M\xEDdia: generate_* gasta 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.',
   "Calls: search_calls acha, get_call traz a transcri\xE7\xE3o.",
   "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 ferramentas canvas_* n\xE3o geram m\xEDdia nem gastam diamantes: quem roda os n\xF3s \xE9 o usu\xE1rio no Canvas. D\xEA nome (label) aos n\xF3s, n\xE3o invente tipos nem portas, e confirme antes de canvas_delete.",
+  '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.',
   '"Aplica os coment\xE1rios" do board: canvas_list_comments (abertos) \u2192 para cada um, leia o n\xF3 ancorado com canvas_read_board (node_ids), aplique a edi\xE7\xE3o pelas canvas_* e feche com canvas_resolve_comment dizendo em uma frase o que fez. Coment\xE1rio amb\xEDguo ou com alvo sumido: responda com pergunta (canvas_reply_comment) e n\xE3o resolva. D\xFAvida sua sobre um n\xF3: canvas_comment ancorado nele. As escritas j\xE1 saem espa\xE7adas (60/min); se ainda vier limite, pare e diga de onde seguir.'
 ].join("\n");
 function buildServer(cfg) {
@@ -26020,7 +26602,7 @@ function serversNaming(entry) {
   if (!servers || typeof servers !== "object") return [];
   return Object.entries(servers).filter(([name, value]) => name === "beplus" || JSON.stringify(value ?? null).includes("beplus-mcp")).map(([name]) => name);
 }
-function checkConfigs(report) {
+function checkConfigs(report2) {
   let found = 0;
   for (const { path, client } of configCandidates()) {
     let raw;
@@ -26033,7 +26615,7 @@ function checkConfigs(report) {
     try {
       parsed = JSON.parse(raw);
     } catch {
-      report.line("aviso", `Config ilegivel: ${path}`, "O arquivo existe mas nao e JSON valido.");
+      report2.line("aviso", `Config ilegivel: ${path}`, "O arquivo existe mas nao e JSON valido.");
       continue;
     }
     const names = new Set(serversNaming(parsed));
@@ -26043,25 +26625,25 @@ function checkConfigs(report) {
     }
     if (names.size === 0) continue;
     found += 1;
-    report.line("ok", `Config detectado: ${path}`, `${client}, servidor ${[...names].join(", ")}`);
+    report2.line("ok", `Config detectado: ${path}`, `${client}, servidor ${[...names].join(", ")}`);
   }
   if (found === 0) {
-    report.line(
+    report2.line(
       "aviso",
       "Nenhum config de cliente MCP com o beplus foi encontrado.",
       "Isso e normal se voce ainda nao instalou o servidor, ou se o cliente guarda o config em outro lugar."
     );
   }
 }
-async function checkApiReachable(report, baseUrl) {
+async function checkApiReachable(report2, baseUrl) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), 1e4);
   try {
     const res = await fetch(`${baseUrl}/api/v1/mcp/me`, { signal: controller.signal });
-    report.line("ok", `API responde: ${baseUrl}`, `GET /api/v1/mcp/me sem token devolveu HTTP ${res.status}.`);
+    report2.line("ok", `API responde: ${baseUrl}`, `GET /api/v1/mcp/me sem token devolveu HTTP ${res.status}.`);
   } catch (e) {
     const aborted2 = e?.name === "AbortError";
-    report.line(
+    report2.line(
       "erro",
       `API nao respondeu: ${baseUrl}`,
       aborted2 ? "Tempo esgotado em 10s. Confira a rede, o proxy ou a VPN." : `Falha de rede: ${e?.message ?? "desconhecida"}. Confira a rede e o valor de BEPLUS_API_URL.`
@@ -26070,10 +26652,10 @@ async function checkApiReachable(report, baseUrl) {
     clearTimeout(timer);
   }
 }
-async function checkToken(report) {
+async function checkToken(report2) {
   const token = process.env.BEPLUS_API_TOKEN?.trim();
   if (!token) {
-    report.line(
+    report2.line(
       "aviso",
       "BEPLUS_API_TOKEN nao esta definido.",
       "Gere um Personal Access Token em Tokens de acesso, no painel BePlus, e coloque no config do MCP."
@@ -26082,46 +26664,46 @@ async function checkToken(report) {
   }
   try {
     const me = await new BeplusClient(loadConfig()).me();
-    report.line(
+    report2.line(
       "ok",
       `Token valido (${maskToken(token)})`,
       `Conta: ${me.name ?? me.email ?? me.userId}, ${me.diamonds} diamantes.`
     );
   } catch (e) {
     if (e instanceof ApiError && e.httpStatus === 401) {
-      report.line(
+      report2.line(
         "erro",
         `Token invalido ou revogado (${maskToken(token)})`,
         "Gere um novo Personal Access Token no painel BePlus e atualize BEPLUS_API_TOKEN no config do MCP."
       );
       return;
     }
-    report.line("aviso", "Nao deu para validar o token agora.", e?.message ?? "erro desconhecido");
+    report2.line("aviso", "Nao deu para validar o token agora.", e?.message ?? "erro desconhecido");
   }
 }
 async function runDoctor() {
-  const report = new Report();
+  const report2 = new Report();
   process.stdout.write(`beplus-mcp doctor, versao ${VERSION}
 
 `);
   if (isSupportedNode()) {
-    report.line("ok", `Node ${process.versions.node}`, `Minimo exigido: Node ${MIN_NODE_MAJOR}.`);
+    report2.line("ok", `Node ${process.versions.node}`, `Minimo exigido: Node ${MIN_NODE_MAJOR}.`);
   } else {
-    report.line("erro", `Node ${process.versions.node}`, unsupportedNodeMessage());
+    report2.line("erro", `Node ${process.versions.node}`, unsupportedNodeMessage());
   }
   let baseUrl = null;
   try {
     baseUrl = resolveBaseUrl();
-    report.line("ok", `BEPLUS_API_URL: ${baseUrl}`);
+    report2.line("ok", `BEPLUS_API_URL: ${baseUrl}`);
   } catch (e) {
-    report.line("erro", "BEPLUS_API_URL invalida", e.message);
+    report2.line("erro", "BEPLUS_API_URL invalida", e.message);
   }
   if (baseUrl) {
-    await checkApiReachable(report, baseUrl);
-    await checkToken(report);
+    await checkApiReachable(report2, baseUrl);
+    await checkToken(report2);
   }
-  checkConfigs(report);
-  const code = report.exitCode;
+  checkConfigs(report2);
+  const code = report2.exitCode;
   process.stdout.write(code === 0 ? "\nTudo certo.\n" : "\nTem item com [erro] acima. Resolva antes de usar o MCP.\n");
   return code;
 }