@pixerate/editor 0.142.1 → 0.143.0

package/dist/agent/index.cjs

@@ -12,7 +12,8 @@ var _chunkGLQQ2VILcjs = require('../chunk-GLQQ2VIL.cjs');
 
 
 
-var _chunkUBRYHNRUcjs = require('../chunk-UBRYHNRU.cjs');
+
+var _chunkEL4PSKFTcjs = require('../chunk-EL4PSKFT.cjs');
 require('../chunk-4EFNS2HV.cjs');
 
 
@@ -184,20 +185,33 @@ function planAgentCommand(command, snapshot, options = {}) {
       let pos = command.node.position;
       const anchorId = command.nearNodeId && nodes.some((n) => n.id === command.nearNodeId) ? command.nearNodeId : void 0;
       if (!pos) {
+        const draft = command.node;
+        const nodeSize = {
+          width: _nullishCoalesce(_nullishCoalesce(_optionalChain([draft, 'access', _6 => _6.measured, 'optionalAccess', _7 => _7.width]), () => ( draft.width)), () => ( defaultNodeSize.width)),
+          height: _nullishCoalesce(_nullishCoalesce(_optionalChain([draft, 'access', _8 => _8.measured, 'optionalAccess', _9 => _9.height]), () => ( draft.height)), () => ( defaultNodeSize.height))
+        };
+        const view = typeof options.visibleRect === "function" ? options.visibleRect() : options.visibleRect;
         const rects = {};
         for (const n of nodes) {
           rects[n.id] = {
             x: n.position.x,
             y: n.position.y,
-            width: _nullishCoalesce(_nullishCoalesce(_optionalChain([n, 'access', _6 => _6.measured, 'optionalAccess', _7 => _7.width]), () => ( n.width)), () => ( defaultNodeSize.width)),
-            height: _nullishCoalesce(_nullishCoalesce(_optionalChain([n, 'access', _8 => _8.measured, 'optionalAccess', _9 => _9.height]), () => ( n.height)), () => ( defaultNodeSize.height))
+            width: _nullishCoalesce(_nullishCoalesce(_optionalChain([n, 'access', _10 => _10.measured, 'optionalAccess', _11 => _11.width]), () => ( n.width)), () => ( defaultNodeSize.width)),
+            height: _nullishCoalesce(_nullishCoalesce(_optionalChain([n, 'access', _12 => _12.measured, 'optionalAccess', _13 => _13.height]), () => ( n.height)), () => ( defaultNodeSize.height))
           };
         }
         if (anchorId) {
-          pos = _chunkUBRYHNRUcjs.placeBeside.call(void 0, rects, defaultNodeSize, normalizeSide(command.side), anchorId);
+          pos = _chunkEL4PSKFTcjs.placeBeside.call(void 0, 
+            rects,
+            nodeSize,
+            normalizeSide(command.side),
+            anchorId
+          );
+        } else if (view) {
+          pos = _chunkEL4PSKFTcjs.placeInView.call(void 0, rects, nodeSize, view);
         } else if (nodes.length > 0) {
           const lastNode = nodes[nodes.length - 1];
-          pos = _chunkUBRYHNRUcjs.placeBeside.call(void 0, rects, defaultNodeSize, "right", lastNode.id);
+          pos = _chunkEL4PSKFTcjs.placeBeside.call(void 0, rects, nodeSize, "right", lastNode.id);
         } else {
           pos = { x: 100, y: 100 };
         }
@@ -265,12 +279,14 @@ function planAgentCommand(command, snapshot, options = {}) {
             stored[n.id] = { ...n.position };
           }
         }
-        layouted = _chunkUBRYHNRUcjs.ensureLayout.call(void 0, nodes, edges, {
+        layouted = _chunkEL4PSKFTcjs.ensureLayout.call(void 0, nodes, edges, {
           direction: dir,
           storedPositions: stored
         });
       } else {
-        layouted = _chunkUBRYHNRUcjs.getLayoutedNodes.call(void 0, nodes, edges, void 0, { direction: dir });
+        layouted = _chunkEL4PSKFTcjs.getLayoutedNodes.call(void 0, nodes, edges, void 0, {
+          direction: dir
+        });
       }
       const positions = {};
       for (const node of layouted) {
@@ -401,13 +417,26 @@ function toolCallToAgentCommand(name, args = {}) {
       case "remove_nodes":
         return ids(args.nodeIds) ? { type: "canvas:remove_nodes", nodeIds: args.nodeIds } : null;
       case "connect":
-        return typeof args.source === "string" && typeof args.target === "string" ? { type: "canvas:connect", source: args.source, target: args.target, label: args.label } : null;
+        return typeof args.source === "string" && typeof args.target === "string" ? {
+          type: "canvas:connect",
+          source: args.source,
+          target: args.target,
+          label: args.label
+        } : null;
       case "update_node": {
-        const id = _nullishCoalesce(_optionalChain([args, 'access', _10 => _10.node, 'optionalAccess', _11 => _11.id]), () => ( args.id));
-        return typeof id === "string" ? { type: "canvas:update_node", id, data: _nullishCoalesce(_nullishCoalesce(_optionalChain([args, 'access', _12 => _12.node, 'optionalAccess', _13 => _13.data]), () => ( args.data)), () => ( {})) } : null;
+        const id = _nullishCoalesce(_optionalChain([args, 'access', _14 => _14.node, 'optionalAccess', _15 => _15.id]), () => ( args.id));
+        return typeof id === "string" ? {
+          type: "canvas:update_node",
+          id,
+          data: _nullishCoalesce(_nullishCoalesce(_optionalChain([args, 'access', _16 => _16.node, 'optionalAccess', _17 => _17.data]), () => ( args.data)), () => ( {}))
+        } : null;
       }
       case "layout":
-        return { type: "canvas:layout", direction: args.direction, incremental: args.incremental };
+        return {
+          type: "canvas:layout",
+          direction: args.direction,
+          incremental: args.incremental
+        };
       case "select":
         return ids(args.nodeIds) ? { type: "canvas:select", nodeIds: args.nodeIds } : null;
       case "highlight":
@@ -425,9 +454,18 @@ function toolCallToAgentCommand(name, args = {}) {
   if (promptOperation !== void 0) {
     switch (promptOperation) {
       case "insert_text":
-        return typeof args.text === "string" ? { type: "prompt:insert_text", text: args.text, at: num(args.at) ? args.at : void 0 } : null;
+        return typeof args.text === "string" ? {
+          type: "prompt:insert_text",
+          text: args.text,
+          at: num(args.at) ? args.at : void 0
+        } : null;
       case "replace_range":
-        return typeof args.text === "string" && num(args.from) && num(args.to) ? { type: "prompt:replace_range", from: args.from, to: args.to, text: args.text } : null;
+        return typeof args.text === "string" && num(args.from) && num(args.to) ? {
+          type: "prompt:replace_range",
+          from: args.from,
+          to: args.to,
+          text: args.text
+        } : null;
       case "set_variable":
         return typeof args.name === "string" ? { type: "prompt:set_variable", name: args.name, value: args.value } : null;
       case "select":
@@ -439,7 +477,7 @@ function toolCallToAgentCommand(name, args = {}) {
   return { type: "tool:call", name, arguments: args };
 }
 function validateAgentCommand(command, snapshot) {
-  const known = new Set((_nullishCoalesce(_optionalChain([snapshot, 'access', _14 => _14.canvas, 'optionalAccess', _15 => _15.nodes]), () => ( []))).map((n) => n.id));
+  const known = new Set((_nullishCoalesce(_optionalChain([snapshot, 'access', _18 => _18.canvas, 'optionalAccess', _19 => _19.nodes]), () => ( []))).map((n) => n.id));
   const missing = (nodeIds) => {
     const unknown = nodeIds.filter((id) => !known.has(id));
     return unknown.length ? `Unknown node id${unknown.length > 1 ? "s" : ""}: ${unknown.map((id) => JSON.stringify(id)).join(", ")}. Call get_editor_state for the current ids.` : null;
@@ -451,7 +489,8 @@ function validateAgentCommand(command, snapshot) {
   };
   switch (command.type) {
     case "canvas:add_node":
-      if (command.node.id && known.has(command.node.id)) return `A node with id "${command.node.id}" already exists.`;
+      if (command.node.id && known.has(command.node.id))
+        return `A node with id "${command.node.id}" already exists.`;
       return command.nearNodeId ? missing([command.nearNodeId]) : null;
     case "canvas:remove_nodes":
     case "canvas:highlight":
@@ -459,7 +498,8 @@ function validateAgentCommand(command, snapshot) {
     case "canvas:select":
       return missing(command.nodeIds);
     case "canvas:connect":
-      if (command.source === command.target) return "An edge needs two different nodes.";
+      if (command.source === command.target)
+        return "An edge needs two different nodes.";
       return missing([command.source, command.target]);
     case "canvas:update_node":
       return missing([command.id]);
@@ -486,14 +526,14 @@ var _history = require('@tiptap/pm/history');
 // src/agent/canvasPlayback.ts
 var centre = (r) => ({ x: r.x + r.width / 2, y: r.y + r.height / 2 });
 var labelOf = (data) => {
-  const label = _nullishCoalesce(_nullishCoalesce(_optionalChain([data, 'optionalAccess', _16 => _16.label]), () => ( _optionalChain([data, 'optionalAccess', _17 => _17.title]))), () => ( _optionalChain([data, 'optionalAccess', _18 => _18.text])));
+  const label = _nullishCoalesce(_nullishCoalesce(_optionalChain([data, 'optionalAccess', _20 => _20.label]), () => ( _optionalChain([data, 'optionalAccess', _21 => _21.title]))), () => ( _optionalChain([data, 'optionalAccess', _22 => _22.text])));
   return typeof label === "string" && label.trim() ? label : null;
 };
 function planCanvasPlaybackSteps(steps, nodes, rectOptions) {
-  const placed = new Map(_chunkUBRYHNRUcjs.createNodeLookup.call(void 0, nodes));
+  const placed = new Map(_chunkEL4PSKFTcjs.createNodeLookup.call(void 0, nodes));
   const rectOf = (id) => {
     const node = placed.get(id);
-    return node ? _chunkUBRYHNRUcjs.getNodeRect.call(void 0, node, placed, rectOptions) : null;
+    return node ? _chunkEL4PSKFTcjs.getNodeRect.call(void 0, node, placed, rectOptions) : null;
   };
   const before = [];
   const after = [];
@@ -560,7 +600,7 @@ function planCanvasToolPlayback(name, args, snapshot, plannerOptions, rectOption
   const command = toolCallToAgentCommand(name, args);
   if (!command || !command.type.startsWith("canvas:") || validateAgentCommand(command, snapshot)) return null;
   const steps = planAgentCommand(command, snapshot, plannerOptions);
-  const planned = planCanvasPlaybackSteps(steps, _nullishCoalesce(_optionalChain([snapshot, 'access', _19 => _19.canvas, 'optionalAccess', _20 => _20.nodes]), () => ( [])), rectOptions);
+  const planned = planCanvasPlaybackSteps(steps, _nullishCoalesce(_optionalChain([snapshot, 'access', _23 => _23.canvas, 'optionalAccess', _24 => _24.nodes]), () => ( [])), rectOptions);
   return planned.length ? planned : null;
 }
 
@@ -678,7 +718,7 @@ function createDocumentChartTools(editor) {
       const ed = editor();
       checkPosition(ed, at);
       const spec = checkedSpec(input);
-      const id = _nullishCoalesce(_optionalChain([ed, 'access', _21 => _21.extensionManager, 'access', _22 => _22.extensions, 'access', _23 => _23.find, 'call', _24 => _24((e) => e.name === "chart"), 'optionalAccess', _25 => _25.options, 'access', _26 => _26.generateId, 'optionalCall', _27 => _27()]), () => ( `chart-${Date.now().toString(36)}`));
+      const id = _nullishCoalesce(_optionalChain([ed, 'access', _25 => _25.extensionManager, 'access', _26 => _26.extensions, 'access', _27 => _27.find, 'call', _28 => _28((e) => e.name === "chart"), 'optionalAccess', _29 => _29.options, 'access', _30 => _30.generateId, 'optionalCall', _31 => _31()]), () => ( `chart-${Date.now().toString(36)}`));
       const node = { type: "chart", attrs: { id, spec, width, ...height !== void 0 ? { height } : {} } };
       const chain = ed.chain().command(({ tr }) => (_history.closeHistory.call(void 0, tr), true));
       const ok = (at !== void 0 ? chain.insertContentAt(at, node) : chain.insertContent(node)).run();
@@ -893,7 +933,7 @@ function createDocumentFormatTools(editor, changed) {
   const formatText = (ed) => {
     const { schema } = ed;
     const has = (name) => !!schema.marks[name];
-    const hasAttr = (mark, attr) => !!_optionalChain([schema, 'access', _28 => _28.marks, 'access', _29 => _29[mark], 'optionalAccess', _30 => _30.spec, 'access', _31 => _31.attrs, 'optionalAccess', _32 => _32[attr]]);
+    const hasAttr = (mark, attr) => !!_optionalChain([schema, 'access', _32 => _32.marks, 'access', _33 => _33[mark], 'optionalAccess', _34 => _34.spec, 'access', _35 => _35.attrs, 'optionalAccess', _36 => _36[attr]]);
     const properties = { ...RANGE_PROPERTIES };
     for (const [arg, mark, what] of TOGGLE_MARKS) {
       if (has(mark)) properties[arg] = { type: "boolean", description: `${what} true sets it, false clears it; omit to leave it.` };
@@ -968,7 +1008,7 @@ function createDocumentFormatTools(editor, changed) {
   const blockTypes = (ed) => BLOCK_TYPES.filter(([, node]) => !!ed.schema.nodes[node] && (!LIST_ITEMS[node] || !!ed.schema.nodes[LIST_ITEMS[node]]));
   const headingLevels = (ed) => {
     const ext = ed.extensionManager.extensions.find((e) => e.name === "heading");
-    return _nullishCoalesce(_optionalChain([ext, 'optionalAccess', _33 => _33.options, 'optionalAccess', _34 => _34.levels]), () => ( [1, 2, 3, 4, 5, 6]));
+    return _nullishCoalesce(_optionalChain([ext, 'optionalAccess', _37 => _37.options, 'optionalAccess', _38 => _38.levels]), () => ( [1, 2, 3, 4, 5, 6]));
   };
   const setBlockType = (ed) => {
     const types = blockTypes(ed);
@@ -1018,8 +1058,8 @@ function createDocumentFormatTools(editor, changed) {
   const setTextAlign = (ed) => {
     const ext = ed.extensionManager.extensions.find((e) => e.name === "textAlign");
     if (!ext) return null;
-    const alignments = (_nullishCoalesce(_optionalChain([ext, 'access', _35 => _35.options, 'optionalAccess', _36 => _36.alignments]), () => ( ["left", "center", "right", "justify"]))).slice();
-    const types = _nullishCoalesce(_optionalChain([ext, 'access', _37 => _37.options, 'optionalAccess', _38 => _38.types]), () => ( ["heading", "paragraph"]));
+    const alignments = (_nullishCoalesce(_optionalChain([ext, 'access', _39 => _39.options, 'optionalAccess', _40 => _40.alignments]), () => ( ["left", "center", "right", "justify"]))).slice();
+    const types = _nullishCoalesce(_optionalChain([ext, 'access', _41 => _41.options, 'optionalAccess', _42 => _42.types]), () => ( ["heading", "paragraph"]));
     return {
       name: "set_text_align",
       title: "Align text",
@@ -1086,13 +1126,13 @@ function textBlocks(editor) {
 function createTextPresence(editor, providerId, option) {
   const config = option === false ? null : option === true || option === void 0 ? {} : option;
   const caret = {
-    id: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _39 => _39.id]), () => ( providerId)),
-    name: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _40 => _40.name]), () => ( _chunkL434J57Vcjs.DEFAULT_AGENT_CARET_NAME)),
-    color: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _41 => _41.color]), () => ( _chunkL434J57Vcjs.DEFAULT_AGENT_CARET_COLOR))
+    id: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _43 => _43.id]), () => ( providerId)),
+    name: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _44 => _44.name]), () => ( _chunkL434J57Vcjs.DEFAULT_AGENT_CARET_NAME)),
+    color: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _45 => _45.color]), () => ( _chunkL434J57Vcjs.DEFAULT_AGENT_CARET_COLOR))
   };
-  const typing = !_optionalChain([config, 'optionalAccess', _42 => _42.typing]) ? null : config.typing === true ? {} : config.typing;
-  const idleMs = _nullishCoalesce(_optionalChain([config, 'optionalAccess', _43 => _43.idleMs]), () => ( 12e3));
-  const changedMs = _nullishCoalesce(_optionalChain([config, 'optionalAccess', _44 => _44.changedMs]), () => ( 1500));
+  const typing = !_optionalChain([config, 'optionalAccess', _46 => _46.typing]) ? null : config.typing === true ? {} : config.typing;
+  const idleMs = _nullishCoalesce(_optionalChain([config, 'optionalAccess', _47 => _47.idleMs]), () => ( 12e3));
+  const changedMs = _nullishCoalesce(_optionalChain([config, 'optionalAccess', _48 => _48.changedMs]), () => ( 1500));
   let idleTimer;
   let tintTimer;
   const live = () => {
@@ -1839,7 +1879,7 @@ function missingArgumentsMessage(name, args) {
   const required = _chunkSVFEVKLFcjs.EDIT_OPERATION_REQUIRED_ARGUMENTS[name][args.operation];
   if (!required) return `Unknown operation "${args.operation}".`;
   const missing = required.filter(
-    (key) => key === "id" ? args.id === void 0 && _optionalChain([args, 'access', _45 => _45.node, 'optionalAccess', _46 => _46.id]) === void 0 : args[key] === void 0
+    (key) => key === "id" ? args.id === void 0 && _optionalChain([args, 'access', _49 => _49.node, 'optionalAccess', _50 => _50.id]) === void 0 : args[key] === void 0
   );
   return missing.length ? `Operation "${args.operation}" requires ${required.join(", ")}; missing: ${missing.join(", ")}.` : `Operation "${args.operation}" has invalid arguments (expected ${required.join(", ")} with the types in the schema).`;
 }
@@ -1871,8 +1911,8 @@ function createEditorMcpToolProvider(options) {
     await options.applySteps(steps);
     return describeSteps(steps);
   };
-  const canvas = _nullishCoalesce(_optionalChain([options, 'access', _47 => _47.surfaces, 'optionalAccess', _48 => _48.canvas]), () => ( true));
-  const prompt = _nullishCoalesce(_optionalChain([options, 'access', _49 => _49.surfaces, 'optionalAccess', _50 => _50.prompt]), () => ( true));
+  const canvas = _nullishCoalesce(_optionalChain([options, 'access', _51 => _51.surfaces, 'optionalAccess', _52 => _52.canvas]), () => ( true));
+  const prompt = _nullishCoalesce(_optionalChain([options, 'access', _53 => _53.surfaces, 'optionalAccess', _54 => _54.prompt]), () => ( true));
   const editTools = options.toolStyle === "combined" ? [...canvas ? [_chunkSVFEVKLFcjs.MCP_TOOL_EDIT_CANVAS] : [], ...prompt ? [_chunkSVFEVKLFcjs.MCP_TOOL_EDIT_PROMPT] : []] : [...canvas ? _chunkSVFEVKLFcjs.EDITOR_CANVAS_TOOLS : [], ...prompt ? _chunkSVFEVKLFcjs.EDITOR_PROMPT_TOOLS : []];
   const tools = [
     {

package/dist/agent/index.js

@@ -11,8 +11,9 @@ import {
   ensureLayout,
   getLayoutedNodes,
   getNodeRect,
-  placeBeside
-} from "../chunk-DW4CV5H4.js";
+  placeBeside,
+  placeInView
+} from "../chunk-U4VE4UI2.js";
 import "../chunk-7KZ2HKKC.js";
 import {
   runToolScript,
@@ -184,6 +185,12 @@ function planAgentCommand(command, snapshot, options = {}) {
       let pos = command.node.position;
       const anchorId = command.nearNodeId && nodes.some((n) => n.id === command.nearNodeId) ? command.nearNodeId : void 0;
       if (!pos) {
+        const draft = command.node;
+        const nodeSize = {
+          width: draft.measured?.width ?? draft.width ?? defaultNodeSize.width,
+          height: draft.measured?.height ?? draft.height ?? defaultNodeSize.height
+        };
+        const view = typeof options.visibleRect === "function" ? options.visibleRect() : options.visibleRect;
         const rects = {};
         for (const n of nodes) {
           rects[n.id] = {
@@ -194,10 +201,17 @@ function planAgentCommand(command, snapshot, options = {}) {
           };
         }
         if (anchorId) {
-          pos = placeBeside(rects, defaultNodeSize, normalizeSide(command.side), anchorId);
+          pos = placeBeside(
+            rects,
+            nodeSize,
+            normalizeSide(command.side),
+            anchorId
+          );
+        } else if (view) {
+          pos = placeInView(rects, nodeSize, view);
         } else if (nodes.length > 0) {
           const lastNode = nodes[nodes.length - 1];
-          pos = placeBeside(rects, defaultNodeSize, "right", lastNode.id);
+          pos = placeBeside(rects, nodeSize, "right", lastNode.id);
         } else {
           pos = { x: 100, y: 100 };
         }
@@ -270,7 +284,9 @@ function planAgentCommand(command, snapshot, options = {}) {
           storedPositions: stored
         });
       } else {
-        layouted = getLayoutedNodes(nodes, edges, void 0, { direction: dir });
+        layouted = getLayoutedNodes(nodes, edges, void 0, {
+          direction: dir
+        });
       }
       const positions = {};
       for (const node of layouted) {
@@ -401,13 +417,26 @@ function toolCallToAgentCommand(name, args = {}) {
       case "remove_nodes":
         return ids(args.nodeIds) ? { type: "canvas:remove_nodes", nodeIds: args.nodeIds } : null;
       case "connect":
-        return typeof args.source === "string" && typeof args.target === "string" ? { type: "canvas:connect", source: args.source, target: args.target, label: args.label } : null;
+        return typeof args.source === "string" && typeof args.target === "string" ? {
+          type: "canvas:connect",
+          source: args.source,
+          target: args.target,
+          label: args.label
+        } : null;
       case "update_node": {
         const id = args.node?.id ?? args.id;
-        return typeof id === "string" ? { type: "canvas:update_node", id, data: args.node?.data ?? args.data ?? {} } : null;
+        return typeof id === "string" ? {
+          type: "canvas:update_node",
+          id,
+          data: args.node?.data ?? args.data ?? {}
+        } : null;
       }
       case "layout":
-        return { type: "canvas:layout", direction: args.direction, incremental: args.incremental };
+        return {
+          type: "canvas:layout",
+          direction: args.direction,
+          incremental: args.incremental
+        };
       case "select":
         return ids(args.nodeIds) ? { type: "canvas:select", nodeIds: args.nodeIds } : null;
       case "highlight":
@@ -425,9 +454,18 @@ function toolCallToAgentCommand(name, args = {}) {
   if (promptOperation !== void 0) {
     switch (promptOperation) {
       case "insert_text":
-        return typeof args.text === "string" ? { type: "prompt:insert_text", text: args.text, at: num(args.at) ? args.at : void 0 } : null;
+        return typeof args.text === "string" ? {
+          type: "prompt:insert_text",
+          text: args.text,
+          at: num(args.at) ? args.at : void 0
+        } : null;
       case "replace_range":
-        return typeof args.text === "string" && num(args.from) && num(args.to) ? { type: "prompt:replace_range", from: args.from, to: args.to, text: args.text } : null;
+        return typeof args.text === "string" && num(args.from) && num(args.to) ? {
+          type: "prompt:replace_range",
+          from: args.from,
+          to: args.to,
+          text: args.text
+        } : null;
       case "set_variable":
         return typeof args.name === "string" ? { type: "prompt:set_variable", name: args.name, value: args.value } : null;
       case "select":
@@ -451,7 +489,8 @@ function validateAgentCommand(command, snapshot) {
   };
   switch (command.type) {
     case "canvas:add_node":
-      if (command.node.id && known.has(command.node.id)) return `A node with id "${command.node.id}" already exists.`;
+      if (command.node.id && known.has(command.node.id))
+        return `A node with id "${command.node.id}" already exists.`;
       return command.nearNodeId ? missing([command.nearNodeId]) : null;
     case "canvas:remove_nodes":
     case "canvas:highlight":
@@ -459,7 +498,8 @@ function validateAgentCommand(command, snapshot) {
     case "canvas:select":
       return missing(command.nodeIds);
     case "canvas:connect":
-      if (command.source === command.target) return "An edge needs two different nodes.";
+      if (command.source === command.target)
+        return "An edge needs two different nodes.";
       return missing([command.source, command.target]);
     case "canvas:update_node":
       return missing([command.id]);

package/dist/agent/planner.d.cts

@@ -1,5 +1,5 @@
-import type { CanvasEdge, CanvasNode, Side } from '../canvas/types.cjs';
-import type { AgentCommand, AgentStep, EditorSnapshot } from './types.cjs';
+import type { CanvasEdge, CanvasNode, Rect, Side } from "../canvas/types.cjs";
+import type { AgentCommand, AgentStep, EditorSnapshot } from "./types.cjs";
 /**
  * Normalizes a placement side from either the planner vocabulary (`right | below | left | above`)
  * or the MCP tool schema vocabulary (`top | right | bottom | left`). Unknown values fall back to `right`.
@@ -14,6 +14,11 @@ export declare function planAgentCommand<TNode extends CanvasNode = CanvasNode,
         height: number;
     };
     idGenerator?: () => string;
+    /**
+     * The visible part of the canvas (flow coordinates), or a getter for it. Unanchored new
+     * nodes go in free space at its centre instead of beside the last node.
+     */
+    visibleRect?: Rect | null | (() => Rect | null | undefined);
 }): AgentStep<TNode, TEdge>[];
 /**
  * Converts an MCP tool call into a planner command. `edit_canvas` /

package/dist/agent/planner.d.ts

@@ -1,5 +1,5 @@
-import type { CanvasEdge, CanvasNode, Side } from '../canvas/types.js';
-import type { AgentCommand, AgentStep, EditorSnapshot } from './types.js';
+import type { CanvasEdge, CanvasNode, Rect, Side } from "../canvas/types.js";
+import type { AgentCommand, AgentStep, EditorSnapshot } from "./types.js";
 /**
  * Normalizes a placement side from either the planner vocabulary (`right | below | left | above`)
  * or the MCP tool schema vocabulary (`top | right | bottom | left`). Unknown values fall back to `right`.
@@ -14,6 +14,11 @@ export declare function planAgentCommand<TNode extends CanvasNode = CanvasNode,
         height: number;
     };
     idGenerator?: () => string;
+    /**
+     * The visible part of the canvas (flow coordinates), or a getter for it. Unanchored new
+     * nodes go in free space at its centre instead of beside the last node.
+     */
+    visibleRect?: Rect | null | (() => Rect | null | undefined);
 }): AgentStep<TNode, TEdge>[];
 /**
  * Converts an MCP tool call into a planner command. `edit_canvas` /