@pixerate/editor 0.141.0 → 0.143.0

package/dist/agent/index.cjs

@@ -12,9 +12,14 @@ var _chunkGLQQ2VILcjs = require('../chunk-GLQQ2VIL.cjs');
 
 
 
-var _chunkUBRYHNRUcjs = require('../chunk-UBRYHNRU.cjs');
+
+var _chunkEL4PSKFTcjs = require('../chunk-EL4PSKFT.cjs');
 require('../chunk-4EFNS2HV.cjs');
-require('../chunk-TNCWKC5M.cjs');
+
+
+
+
+var _chunkXH32BATEcjs = require('../chunk-XH32BATE.cjs');
 
 
 
@@ -49,7 +54,7 @@ var _chunkY4BWZB6Jcjs = require('../chunk-Y4BWZB6J.cjs');
 
 
 
-var _chunk6SFREX6Hcjs = require('../chunk-6SFREX6H.cjs');
+var _chunkX2HQP7DFcjs = require('../chunk-X2HQP7DF.cjs');
 
 
 
@@ -132,7 +137,8 @@ var _chunk2BSBFBOAcjs = require('../chunk-2BSBFBOA.cjs');
 
 
 
-var _chunk2RUNJYOXcjs = require('../chunk-2RUNJYOX.cjs');
+
+var _chunkQZFEX2N4cjs = require('../chunk-QZFEX2N4.cjs');
 
 
 
@@ -179,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 };
         }
@@ -260,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) {
@@ -396,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":
@@ -420,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":
@@ -434,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;
@@ -446,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":
@@ -454,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]);
@@ -481,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 = [];
@@ -540,7 +585,7 @@ function planCanvasPlaybackSteps(steps, nodes, rectOptions) {
           const node = placed.get(id);
           if (node) placed.set(id, { ...node, position });
         }
-        const rect = _chunk6SFREX6Hcjs.unionRects.call(void 0, moved.map(([id]) => rectOf(id)));
+        const rect = _chunkX2HQP7DFcjs.unionRects.call(void 0, moved.map(([id]) => rectOf(id)));
         if (rect) after.push({ type: "move", to: centre(rect) }, { type: "focus", rect }, { type: "wait", ms: 450 });
         break;
       }
@@ -555,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;
 }
 
@@ -673,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();
@@ -888,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.` };
@@ -963,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);
@@ -1013,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",
@@ -1081,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 = () => {
@@ -1165,6 +1210,13 @@ function findMatches(editor, query, args, replacement) {
 function createRichTextToolProvider(target, options) {
   const editor = () => toEditor(target);
   const charts = createDocumentChartTools(editor);
+  const withCaret = (tool) => tool.name !== "insert_chart" ? tool : {
+    ...tool,
+    handler: (args, context) => {
+      if (typeof args.at === "number") presence.show(args.at);
+      return tool.handler(args, context);
+    }
+  };
   const presence = createTextPresence(editor, options.id, options.presence);
   const formatting = createDocumentFormatTools(editor, (ranges) => presence.changed(ranges.filter((r) => r.from < r.to)));
   const getText = {
@@ -1466,7 +1518,7 @@ function createRichTextToolProvider(target, options) {
       if (!ed || ed.isDestroyed) return [];
       if (!ed.isEditable) return [getText, findText, ...charts.read()];
       const tools = [getText, findText, insertText, replaceText, replaceRange, replaceSelection, setSelection, ...formatting.tools(ed)];
-      return [...tools, ..._chunkL434J57Vcjs.isTableEnabled.call(void 0, ed) ? [editTable] : [], ...charts.read(), ...charts.write()];
+      return [...tools, ..._chunkL434J57Vcjs.isTableEnabled.call(void 0, ed) ? [editTable] : [], ...charts.read(), ...charts.write().map(withCaret)];
     },
     subscribe: (notify) => {
       const ed = editor();
@@ -1496,7 +1548,7 @@ function parseRange(ref) {
   if (extra !== void 0) throw new Error(`Invalid range "${ref}". Use A1 notation, e.g. "A1:C5".`);
   const start = parseCell(startRef);
   const end = parseCell(endRef);
-  return _chunk2RUNJYOXcjs.normalizeRange.call(void 0, { startRow: start.row, startCol: start.col, endRow: end.row, endCol: end.col });
+  return _chunkQZFEX2N4cjs.normalizeRange.call(void 0, { startRow: start.row, startCol: start.col, endRow: end.row, endCol: end.col });
 }
 var formatRange = (r) => `${_chunk55AKPTLMcjs.indexToColName.call(void 0, r.startCol)}${r.startRow + 1}:${_chunk55AKPTLMcjs.indexToColName.call(void 0, r.endCol)}${r.endRow + 1}`;
 var CELL_INPUT = { type: ["string", "number", "boolean", "null"] };
@@ -1558,7 +1610,7 @@ function createSpreadsheetToolProvider(controller, options) {
         values,
         raw,
         errors,
-        merges: controller.getMerges().filter((m) => _chunk2RUNJYOXcjs.rangesIntersect.call(void 0, m, read)).map(formatRange),
+        merges: controller.getMerges().filter((m) => _chunkQZFEX2N4cjs.rangesIntersect.call(void 0, m, read)).map(formatRange),
         sheet: { rows: rowCount, columns: colCount }
       };
     }
@@ -1753,8 +1805,8 @@ function createSpreadsheetToolProvider(controller, options) {
     ({ range }) => {
       const r = parseRange(range);
       inSheet(r, range);
-      if (_chunk2RUNJYOXcjs.isSingleCellRange.call(void 0, r)) throw new Error(`${range} is a single cell; give a range of at least two cells.`);
-      const partial = controller.getMerges().find((m) => _chunk2RUNJYOXcjs.rangesIntersect.call(void 0, m, r) && !_chunk2RUNJYOXcjs.rangeContainsRange.call(void 0, r, m));
+      if (_chunkQZFEX2N4cjs.isSingleCellRange.call(void 0, r)) throw new Error(`${range} is a single cell; give a range of at least two cells.`);
+      const partial = controller.getMerges().find((m) => _chunkQZFEX2N4cjs.rangesIntersect.call(void 0, m, r) && !_chunkQZFEX2N4cjs.rangeContainsRange.call(void 0, r, m));
       if (partial) throw new Error(`${range} partly overlaps the merged range ${formatRange(partial)}; include all of it or unmerge it first.`);
       const readOnly = readOnlyIn(r);
       if (readOnly.length) throw new Error(`Read-only cells: ${readOnly.slice(0, 20).join(", ")}. Nothing was merged.`);
@@ -1779,7 +1831,7 @@ function createSpreadsheetToolProvider(controller, options) {
     false,
     ({ range }) => {
       const r = parseRange(range);
-      const touched = controller.getMerges().filter((m) => _chunk2RUNJYOXcjs.rangesIntersect.call(void 0, m, r));
+      const touched = controller.getMerges().filter((m) => _chunkQZFEX2N4cjs.rangesIntersect.call(void 0, m, r));
       if (!touched.length) throw new Error(`No merged cells in ${range}. get_range lists the merges in a range.`);
       controller.unmergeCells(r);
       return { unmerged: touched.map(formatRange) };
@@ -1795,14 +1847,14 @@ function createSpreadsheetToolProvider(controller, options) {
     ({ range }) => {
       const s = parseRange(range);
       inSheet(s, range);
-      if (_chunk2RUNJYOXcjs.isSingleCellRange.call(void 0, s)) throw new Error(`${range} is a single cell; give a range of at least two cells.`);
+      if (_chunkQZFEX2N4cjs.isSingleCellRange.call(void 0, s)) throw new Error(`${range} is a single cell; give a range of at least two cells.`);
       const t = {
         startRow: s.startRow,
         startCol: s.startCol,
         endRow: s.startRow + (s.endCol - s.startCol),
         endCol: s.startCol + (s.endRow - s.startRow)
       };
-      const merge = controller.getMerges().find((m) => _chunk2RUNJYOXcjs.rangesIntersect.call(void 0, m, s) || _chunk2RUNJYOXcjs.rangesIntersect.call(void 0, m, t));
+      const merge = controller.getMerges().find((m) => _chunkQZFEX2N4cjs.rangesIntersect.call(void 0, m, s) || _chunkQZFEX2N4cjs.rangesIntersect.call(void 0, m, t));
       if (merge) throw new Error(`Cannot transpose ${range}: the merged range ${formatRange(merge)} is in the way; unmerge it first.`);
       const readOnly = [.../* @__PURE__ */ new Set([...readOnlyIn(s), ...readOnlyIn(t)])];
       if (readOnly.length) throw new Error(`Read-only cells: ${readOnly.slice(0, 20).join(", ")}. Nothing was transposed.`);
@@ -1816,14 +1868,18 @@ function createSpreadsheetToolProvider(controller, options) {
     title: "Spreadsheet",
     description: "A spreadsheet: read and set cells and ranges, insert and delete rows and columns, merge and transpose.",
     skill: "pixerate-spreadsheet",
-    tools: [getRange, setCell, setRange, insertRows, deleteRows, insertColumns, deleteColumns, mergeCells, unmergeCells, transposeRange]
+    // Agent playback: `<SpreadsheetEditor playback>` attaches as `spreadsheet` and finds the cells.
+    playbackSurface: _nullishCoalesce(options.playbackSurface, () => ( "spreadsheet")),
+    tools: [getRange, setCell, setRange, insertRows, deleteRows, insertColumns, deleteColumns, mergeCells, unmergeCells, transposeRange].map(
+      (tool) => ({ ...tool, plan: (args) => _chunkQZFEX2N4cjs.planSpreadsheetToolPlayback.call(void 0, tool.name, args) })
+    )
   };
 }
 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).`;
 }
@@ -1855,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 = [
     {
@@ -2186,4 +2242,7 @@ function createCanvasComponentToolProvider(controller, options = { id: "canvas-c
 
 
 
-exports.AgentPlayback = _chunk6SFREX6Hcjs.AgentPlayback; exports.CAPTURE_EXCLUDE_SELECTOR = _chunkSVFEVKLFcjs.CAPTURE_EXCLUDE_SELECTOR; exports.CAPTURE_OVERLAY_SELECTORS = _chunkSVFEVKLFcjs.CAPTURE_OVERLAY_SELECTORS; exports.EDITOR_CANVAS_TOOLS = _chunkSVFEVKLFcjs.EDITOR_CANVAS_TOOLS; exports.EDITOR_MCP_TOOLS = _chunkSVFEVKLFcjs.EDITOR_MCP_TOOLS; exports.EDITOR_PROMPT_TOOLS = _chunkSVFEVKLFcjs.EDITOR_PROMPT_TOOLS; exports.EDIT_OPERATION_REQUIRED_ARGUMENTS = _chunkSVFEVKLFcjs.EDIT_OPERATION_REQUIRED_ARGUMENTS; exports.EXPORT_EXCLUDED_SELECTORS = _chunkSVFEVKLFcjs.EXPORT_EXCLUDED_SELECTORS; exports.JSON_RPC_ERRORS = _chunkY4BWZB6Jcjs.JSON_RPC_ERRORS; exports.MCP_PROTOCOL_VERSIONS = _chunkY4BWZB6Jcjs.MCP_PROTOCOL_VERSIONS; exports.MCP_TOOL_CANVAS_ADD_NODE = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_ADD_NODE; exports.MCP_TOOL_CANVAS_CONNECT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_CONNECT; exports.MCP_TOOL_CANVAS_HIGHLIGHT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_HIGHLIGHT; exports.MCP_TOOL_CANVAS_LAYOUT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_LAYOUT; exports.MCP_TOOL_CANVAS_REMOVE_NODES = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_REMOVE_NODES; exports.MCP_TOOL_CANVAS_SELECT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_SELECT; exports.MCP_TOOL_CANVAS_UPDATE_NODE = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_UPDATE_NODE; exports.MCP_TOOL_EDIT_CANVAS = _chunkSVFEVKLFcjs.MCP_TOOL_EDIT_CANVAS; exports.MCP_TOOL_EDIT_PROMPT = _chunkSVFEVKLFcjs.MCP_TOOL_EDIT_PROMPT; exports.MCP_TOOL_GET_EDITOR_STATE = _chunkSVFEVKLFcjs.MCP_TOOL_GET_EDITOR_STATE; exports.MCP_TOOL_PROMPT_INSERT_TEXT = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_INSERT_TEXT; exports.MCP_TOOL_PROMPT_REPLACE_RANGE = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_REPLACE_RANGE; exports.MCP_TOOL_PROMPT_SELECT = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_SELECT; exports.MCP_TOOL_PROMPT_SET_VARIABLE = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_SET_VARIABLE; exports.MCP_TOOL_VIEW_EDITOR = _chunkSVFEVKLFcjs.MCP_TOOL_VIEW_EDITOR; exports.PRESENCE_COLORS = _chunkUJGAA6AKcjs.PRESENCE_COLORS; exports.PerformanceQueue = _chunkUJGAA6AKcjs.PerformanceQueue; exports.PresenceStore = _chunkUJGAA6AKcjs.PresenceStore; exports.TOOL_BRIDGE_DEFAULT_PORT = _chunkY4BWZB6Jcjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkY4BWZB6Jcjs.TOOL_BRIDGE_PROTOCOL; exports.TOOL_DISCOVERY_TOOLS = _chunkY4BWZB6Jcjs.TOOL_DISCOVERY_TOOLS; exports.TOOL_NAMESPACE_SEPARATOR = _chunkY4BWZB6Jcjs.TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = _chunkY4BWZB6Jcjs.ToolRegistry; exports.ToolRegistryError = _chunkY4BWZB6Jcjs.ToolRegistryError; exports.ToolRegistryView = _chunkY4BWZB6Jcjs.ToolRegistryView; exports.UNSAFE_JSON_KEYS = _chunk2BSBFBOAcjs.UNSAFE_JSON_KEYS; exports.baseToolName = _chunkY4BWZB6Jcjs.baseToolName; exports.captureInputSchema = _chunkN2FGYZ4Qcjs.captureInputSchema; exports.captureOutputSize = _chunkN2FGYZ4Qcjs.captureOutputSize; exports.cloneElementWithStyles = _chunkSVFEVKLFcjs.cloneElementWithStyles; exports.connectToolBridge = _chunkY4BWZB6Jcjs.connectToolBridge; exports.createAgentPlayback = _chunk6SFREX6Hcjs.createAgentPlayback; exports.createCanvasComponentToolProvider = createCanvasComponentToolProvider; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createDocumentChartTools = createDocumentChartTools; exports.createEditorMcpToolProvider = createEditorMcpToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createInstantPresenceClock = _chunkUJGAA6AKcjs.createInstantPresenceClock; exports.createMcpServer = _chunkY4BWZB6Jcjs.createMcpServer; exports.createRichTextToolProvider = createRichTextToolProvider; exports.createSpreadsheetToolProvider = createSpreadsheetToolProvider; exports.createToolRegistry = _chunkY4BWZB6Jcjs.createToolRegistry; exports.derivePlaybackSteps = _chunk6SFREX6Hcjs.derivePlaybackSteps; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkY4BWZB6Jcjs.errorResult; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkills = _chunkY4BWZB6Jcjs.listSkills; exports.normalizeSide = normalizeSide; exports.parseSkillFrontmatter = _chunkY4BWZB6Jcjs.parseSkillFrontmatter; exports.planAgentCommand = planAgentCommand; exports.planCanvasPlaybackSteps = planCanvasPlaybackSteps; exports.planCanvasToolPlayback = planCanvasToolPlayback; exports.planToolCall = planToolCall; exports.playbackRefsFromArgs = _chunk6SFREX6Hcjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunk6SFREX6Hcjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkY4BWZB6Jcjs.readSkillFile; exports.readingTime = _chunk6SFREX6Hcjs.readingTime; exports.realPresenceClock = _chunkUJGAA6AKcjs.realPresenceClock; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.searchTokens = _chunkY4BWZB6Jcjs.searchTokens; exports.searchTools = _chunkY4BWZB6Jcjs.searchTools; exports.stripPrototypeKeys = _chunk2BSBFBOAcjs.stripPrototypeKeys; exports.summarize = _chunkY4BWZB6Jcjs.summarize; exports.toCapturedImageData = _chunkN2FGYZ4Qcjs.toCapturedImageData; exports.toToolResult = _chunkY4BWZB6Jcjs.toToolResult; exports.toolCallToAgentCommand = toolCallToAgentCommand; exports.toolsetInstructions = _chunkY4BWZB6Jcjs.toolsetInstructions; exports.toolsetName = _chunkY4BWZB6Jcjs.toolsetName; exports.tweenPresenceCursor = _chunkUJGAA6AKcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunk6SFREX6Hcjs.unionRects; exports.unknownToolMessage = _chunkY4BWZB6Jcjs.unknownToolMessage; exports.validateAgentCommand = validateAgentCommand; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;
+
+
+
+exports.AgentPlayback = _chunkX2HQP7DFcjs.AgentPlayback; exports.CAPTURE_EXCLUDE_SELECTOR = _chunkSVFEVKLFcjs.CAPTURE_EXCLUDE_SELECTOR; exports.CAPTURE_OVERLAY_SELECTORS = _chunkSVFEVKLFcjs.CAPTURE_OVERLAY_SELECTORS; exports.EDITOR_CANVAS_TOOLS = _chunkSVFEVKLFcjs.EDITOR_CANVAS_TOOLS; exports.EDITOR_MCP_TOOLS = _chunkSVFEVKLFcjs.EDITOR_MCP_TOOLS; exports.EDITOR_PROMPT_TOOLS = _chunkSVFEVKLFcjs.EDITOR_PROMPT_TOOLS; exports.EDIT_OPERATION_REQUIRED_ARGUMENTS = _chunkSVFEVKLFcjs.EDIT_OPERATION_REQUIRED_ARGUMENTS; exports.EXPORT_EXCLUDED_SELECTORS = _chunkSVFEVKLFcjs.EXPORT_EXCLUDED_SELECTORS; exports.JSON_RPC_ERRORS = _chunkY4BWZB6Jcjs.JSON_RPC_ERRORS; exports.MCP_PROTOCOL_VERSIONS = _chunkY4BWZB6Jcjs.MCP_PROTOCOL_VERSIONS; exports.MCP_TOOL_CANVAS_ADD_NODE = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_ADD_NODE; exports.MCP_TOOL_CANVAS_CONNECT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_CONNECT; exports.MCP_TOOL_CANVAS_HIGHLIGHT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_HIGHLIGHT; exports.MCP_TOOL_CANVAS_LAYOUT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_LAYOUT; exports.MCP_TOOL_CANVAS_REMOVE_NODES = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_REMOVE_NODES; exports.MCP_TOOL_CANVAS_SELECT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_SELECT; exports.MCP_TOOL_CANVAS_UPDATE_NODE = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_UPDATE_NODE; exports.MCP_TOOL_EDIT_CANVAS = _chunkSVFEVKLFcjs.MCP_TOOL_EDIT_CANVAS; exports.MCP_TOOL_EDIT_PROMPT = _chunkSVFEVKLFcjs.MCP_TOOL_EDIT_PROMPT; exports.MCP_TOOL_GET_EDITOR_STATE = _chunkSVFEVKLFcjs.MCP_TOOL_GET_EDITOR_STATE; exports.MCP_TOOL_PROMPT_INSERT_TEXT = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_INSERT_TEXT; exports.MCP_TOOL_PROMPT_REPLACE_RANGE = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_REPLACE_RANGE; exports.MCP_TOOL_PROMPT_SELECT = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_SELECT; exports.MCP_TOOL_PROMPT_SET_VARIABLE = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_SET_VARIABLE; exports.MCP_TOOL_VIEW_EDITOR = _chunkSVFEVKLFcjs.MCP_TOOL_VIEW_EDITOR; exports.PRESENCE_COLORS = _chunkUJGAA6AKcjs.PRESENCE_COLORS; exports.PerformanceQueue = _chunkUJGAA6AKcjs.PerformanceQueue; exports.PresenceStore = _chunkUJGAA6AKcjs.PresenceStore; exports.TOOL_BRIDGE_DEFAULT_PORT = _chunkY4BWZB6Jcjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkY4BWZB6Jcjs.TOOL_BRIDGE_PROTOCOL; exports.TOOL_DISCOVERY_TOOLS = _chunkY4BWZB6Jcjs.TOOL_DISCOVERY_TOOLS; exports.TOOL_NAMESPACE_SEPARATOR = _chunkY4BWZB6Jcjs.TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = _chunkY4BWZB6Jcjs.ToolRegistry; exports.ToolRegistryError = _chunkY4BWZB6Jcjs.ToolRegistryError; exports.ToolRegistryView = _chunkY4BWZB6Jcjs.ToolRegistryView; exports.UNSAFE_JSON_KEYS = _chunk2BSBFBOAcjs.UNSAFE_JSON_KEYS; exports.baseToolName = _chunkY4BWZB6Jcjs.baseToolName; exports.captureInputSchema = _chunkN2FGYZ4Qcjs.captureInputSchema; exports.captureOutputSize = _chunkN2FGYZ4Qcjs.captureOutputSize; exports.cloneElementWithStyles = _chunkSVFEVKLFcjs.cloneElementWithStyles; exports.connectToolBridge = _chunkY4BWZB6Jcjs.connectToolBridge; exports.createAgentPlayback = _chunkX2HQP7DFcjs.createAgentPlayback; exports.createCanvasComponentToolProvider = createCanvasComponentToolProvider; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createDocumentChartTools = createDocumentChartTools; exports.createEditorMcpToolProvider = createEditorMcpToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createInstantPresenceClock = _chunkUJGAA6AKcjs.createInstantPresenceClock; exports.createMcpServer = _chunkY4BWZB6Jcjs.createMcpServer; exports.createRichTextToolProvider = createRichTextToolProvider; exports.createSpreadsheetToolProvider = createSpreadsheetToolProvider; exports.createToolRegistry = _chunkY4BWZB6Jcjs.createToolRegistry; exports.derivePlaybackSteps = _chunkX2HQP7DFcjs.derivePlaybackSteps; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkY4BWZB6Jcjs.errorResult; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkills = _chunkY4BWZB6Jcjs.listSkills; exports.normalizeSide = normalizeSide; exports.parseSkillFrontmatter = _chunkY4BWZB6Jcjs.parseSkillFrontmatter; exports.planAgentCommand = planAgentCommand; exports.planCanvasPlaybackSteps = planCanvasPlaybackSteps; exports.planCanvasToolPlayback = planCanvasToolPlayback; exports.planToolCall = planToolCall; exports.playbackRefsFromArgs = _chunkX2HQP7DFcjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunkX2HQP7DFcjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkY4BWZB6Jcjs.readSkillFile; exports.readingTime = _chunkX2HQP7DFcjs.readingTime; exports.realPresenceClock = _chunkUJGAA6AKcjs.realPresenceClock; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.runToolScript = _chunkXH32BATEcjs.runToolScript; exports.searchTokens = _chunkY4BWZB6Jcjs.searchTokens; exports.searchTools = _chunkY4BWZB6Jcjs.searchTools; exports.stripPrototypeKeys = _chunk2BSBFBOAcjs.stripPrototypeKeys; exports.summarize = _chunkY4BWZB6Jcjs.summarize; exports.toCapturedImageData = _chunkN2FGYZ4Qcjs.toCapturedImageData; exports.toToolResult = _chunkY4BWZB6Jcjs.toToolResult; exports.toolCallToAgentCommand = toolCallToAgentCommand; exports.toolResultError = _chunkXH32BATEcjs.toolResultError; exports.toolResultValue = _chunkXH32BATEcjs.toolResultValue; exports.toolsetInstructions = _chunkY4BWZB6Jcjs.toolsetInstructions; exports.toolsetName = _chunkY4BWZB6Jcjs.toolsetName; exports.tweenPresenceCursor = _chunkUJGAA6AKcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunkX2HQP7DFcjs.unionRects; exports.unknownToolMessage = _chunkY4BWZB6Jcjs.unknownToolMessage; exports.validateAgentCommand = validateAgentCommand; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;

package/dist/agent/index.js

@@ -11,10 +11,15 @@ import {
   ensureLayout,
   getLayoutedNodes,
   getNodeRect,
-  placeBeside
-} from "../chunk-DW4CV5H4.js";
+  placeBeside,
+  placeInView
+} from "../chunk-U4VE4UI2.js";
 import "../chunk-7KZ2HKKC.js";
-import "../chunk-PLKIYNJZ.js";
+import {
+  runToolScript,
+  toolResultError,
+  toolResultValue
+} from "../chunk-Y6SGC6KO.js";
 import {
   JSON_RPC_ERRORS,
   MCP_PROTOCOL_VERSIONS,
@@ -49,7 +54,7 @@ import {
   playbackRefsFromResult,
   readingTime,
   unionRects
-} from "../chunk-MFFE55CS.js";
+} from "../chunk-54GVEVXS.js";
 import {
   CAPTURE_EXCLUDE_SELECTOR,
   CAPTURE_OVERLAY_SELECTORS,
@@ -130,9 +135,10 @@ import {
 import {
   isSingleCellRange,
   normalizeRange,
+  planSpreadsheetToolPlayback,
   rangeContainsRange,
   rangesIntersect
-} from "../chunk-E747F3D5.js";
+} from "../chunk-CC6WKVIH.js";
 import {
   colNameToIndex,
   indexToColName,
@@ -179,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] = {
@@ -189,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 };
         }
@@ -265,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) {
@@ -396,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":
@@ -420,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":
@@ -446,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":
@@ -454,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]);
@@ -1165,6 +1210,13 @@ function findMatches(editor, query, args, replacement) {
 function createRichTextToolProvider(target, options) {
   const editor = () => toEditor(target);
   const charts = createDocumentChartTools(editor);
+  const withCaret = (tool) => tool.name !== "insert_chart" ? tool : {
+    ...tool,
+    handler: (args, context) => {
+      if (typeof args.at === "number") presence.show(args.at);
+      return tool.handler(args, context);
+    }
+  };
   const presence = createTextPresence(editor, options.id, options.presence);
   const formatting = createDocumentFormatTools(editor, (ranges) => presence.changed(ranges.filter((r) => r.from < r.to)));
   const getText = {
@@ -1466,7 +1518,7 @@ function createRichTextToolProvider(target, options) {
       if (!ed || ed.isDestroyed) return [];
       if (!ed.isEditable) return [getText, findText, ...charts.read()];
       const tools = [getText, findText, insertText, replaceText, replaceRange, replaceSelection, setSelection, ...formatting.tools(ed)];
-      return [...tools, ...isTableEnabled(ed) ? [editTable] : [], ...charts.read(), ...charts.write()];
+      return [...tools, ...isTableEnabled(ed) ? [editTable] : [], ...charts.read(), ...charts.write().map(withCaret)];
     },
     subscribe: (notify) => {
       const ed = editor();
@@ -1816,7 +1868,11 @@ function createSpreadsheetToolProvider(controller, options) {
     title: "Spreadsheet",
     description: "A spreadsheet: read and set cells and ranges, insert and delete rows and columns, merge and transpose.",
     skill: "pixerate-spreadsheet",
-    tools: [getRange, setCell, setRange, insertRows, deleteRows, insertColumns, deleteColumns, mergeCells, unmergeCells, transposeRange]
+    // Agent playback: `<SpreadsheetEditor playback>` attaches as `spreadsheet` and finds the cells.
+    playbackSurface: options.playbackSurface ?? "spreadsheet",
+    tools: [getRange, setCell, setRange, insertRows, deleteRows, insertColumns, deleteColumns, mergeCells, unmergeCells, transposeRange].map(
+      (tool) => ({ ...tool, plan: (args) => planSpreadsheetToolPlayback(tool.name, args) })
+    )
   };
 }
 function missingArgumentsMessage(name, args) {
@@ -2171,6 +2227,7 @@ export {
   readingTime,
   realPresenceClock,
   resolveCaptureRequest,
+  runToolScript,
   searchTokens,
   searchTools,
   stripPrototypeKeys,
@@ -2178,6 +2235,8 @@ export {
   toCapturedImageData,
   toToolResult,
   toolCallToAgentCommand,
+  toolResultError,
+  toolResultValue,
   toolsetInstructions,
   toolsetName,
   tweenPresenceCursor,

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` /