@pixerate/editor 0.148.0 → 0.149.0

package/dist/agent/index.cjs

@@ -19,7 +19,7 @@ require('../chunk-4EFNS2HV.cjs');
 
 
 
-var _chunkAG2EXVCRcjs = require('../chunk-AG2EXVCR.cjs');
+var _chunkZCFHPORFcjs = require('../chunk-ZCFHPORF.cjs');
 
 
 
@@ -55,7 +55,9 @@ var _chunkY4BWZB6Jcjs = require('../chunk-Y4BWZB6J.cjs');
 
 
 
-var _chunkD2ENR3LBcjs = require('../chunk-D2ENR3LB.cjs');
+
+
+var _chunkFR7GHH2Kcjs = require('../chunk-FR7GHH2K.cjs');
 
 
 
@@ -588,7 +590,7 @@ function planCanvasPlaybackSteps(steps, nodes, rectOptions) {
           const node = placed.get(id);
           if (node) placed.set(id, { ...node, position });
         }
-        const rect = _chunkD2ENR3LBcjs.unionRects.call(void 0, moved.map(([id]) => rectOf(id)));
+        const rect = _chunkFR7GHH2Kcjs.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;
       }
@@ -2249,4 +2251,6 @@ function createCanvasComponentToolProvider(controller, options = { id: "canvas-c
 
 
 
-exports.AgentPlayback = _chunkD2ENR3LBcjs.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 = _chunkD2ENR3LBcjs.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.createPlaybackToolProvider = _chunkD2ENR3LBcjs.createPlaybackToolProvider; exports.createRichTextToolProvider = createRichTextToolProvider; exports.createSpreadsheetToolProvider = createSpreadsheetToolProvider; exports.createToolRegistry = _chunkY4BWZB6Jcjs.createToolRegistry; exports.derivePlaybackSteps = _chunkD2ENR3LBcjs.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 = _chunkD2ENR3LBcjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunkD2ENR3LBcjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkY4BWZB6Jcjs.readSkillFile; exports.readingTime = _chunkD2ENR3LBcjs.readingTime; exports.realPresenceClock = _chunkUJGAA6AKcjs.realPresenceClock; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.runToolScript = _chunkAG2EXVCRcjs.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 = _chunkAG2EXVCRcjs.toolResultError; exports.toolResultValue = _chunkAG2EXVCRcjs.toolResultValue; exports.toolsetInstructions = _chunkY4BWZB6Jcjs.toolsetInstructions; exports.toolsetName = _chunkY4BWZB6Jcjs.toolsetName; exports.tweenPresenceCursor = _chunkUJGAA6AKcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunkD2ENR3LBcjs.unionRects; exports.unknownToolMessage = _chunkY4BWZB6Jcjs.unknownToolMessage; exports.validateAgentCommand = validateAgentCommand; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;
+
+
+exports.AgentPlayback = _chunkFR7GHH2Kcjs.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 = _chunkFR7GHH2Kcjs.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.createPlaybackToolProvider = _chunkFR7GHH2Kcjs.createPlaybackToolProvider; exports.createRichTextToolProvider = createRichTextToolProvider; exports.createSpreadsheetToolProvider = createSpreadsheetToolProvider; exports.createToolRegistry = _chunkY4BWZB6Jcjs.createToolRegistry; exports.derivePlaybackSteps = _chunkFR7GHH2Kcjs.derivePlaybackSteps; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkY4BWZB6Jcjs.errorResult; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkills = _chunkY4BWZB6Jcjs.listSkills; exports.locatePlaybackChrome = _chunkFR7GHH2Kcjs.locatePlaybackChrome; exports.normalizeSide = normalizeSide; exports.parseSkillFrontmatter = _chunkY4BWZB6Jcjs.parseSkillFrontmatter; exports.planAgentCommand = planAgentCommand; exports.planCanvasPlaybackSteps = planCanvasPlaybackSteps; exports.planCanvasToolPlayback = planCanvasToolPlayback; exports.planToolCall = planToolCall; exports.playbackRectFromClient = _chunkFR7GHH2Kcjs.playbackRectFromClient; exports.playbackRefsFromArgs = _chunkFR7GHH2Kcjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunkFR7GHH2Kcjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkY4BWZB6Jcjs.readSkillFile; exports.readingTime = _chunkFR7GHH2Kcjs.readingTime; exports.realPresenceClock = _chunkUJGAA6AKcjs.realPresenceClock; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.runToolScript = _chunkZCFHPORFcjs.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 = _chunkZCFHPORFcjs.toolResultError; exports.toolResultValue = _chunkZCFHPORFcjs.toolResultValue; exports.toolsetInstructions = _chunkY4BWZB6Jcjs.toolsetInstructions; exports.toolsetName = _chunkY4BWZB6Jcjs.toolsetName; exports.tweenPresenceCursor = _chunkUJGAA6AKcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunkFR7GHH2Kcjs.unionRects; exports.unknownToolMessage = _chunkY4BWZB6Jcjs.unknownToolMessage; exports.validateAgentCommand = validateAgentCommand; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;

package/dist/agent/index.js

@@ -19,7 +19,7 @@ import {
   runToolScript,
   toolResultError,
   toolResultValue
-} from "../chunk-SA37RU2O.js";
+} from "../chunk-OOV64UEB.js";
 import {
   JSON_RPC_ERRORS,
   MCP_PROTOCOL_VERSIONS,
@@ -51,11 +51,13 @@ import {
   createAgentPlayback,
   createPlaybackToolProvider,
   derivePlaybackSteps,
+  locatePlaybackChrome,
+  playbackRectFromClient,
   playbackRefsFromArgs,
   playbackRefsFromResult,
   readingTime,
   unionRects
-} from "../chunk-HUHBJWTD.js";
+} from "../chunk-3EVMUYF4.js";
 import {
   CAPTURE_EXCLUDE_SELECTOR,
   CAPTURE_OVERLAY_SELECTORS,
@@ -2218,12 +2220,14 @@ export {
   errorResult,
   isUnsafeJsonKey,
   listSkills,
+  locatePlaybackChrome,
   normalizeSide,
   parseSkillFrontmatter,
   planAgentCommand,
   planCanvasPlaybackSteps,
   planCanvasToolPlayback,
   planToolCall,
+  playbackRectFromClient,
   playbackRefsFromArgs,
   playbackRefsFromResult,
   rasterizeElement,

package/dist/animation-editor/effect-tools.d.cts

@@ -12,6 +12,11 @@ export interface AnimationEffectsToolProviderOptions {
     namespace?: string;
     /** The scene cannot be edited: write tools are hidden. A string is the reason. */
     readOnly?: boolean | string | (() => boolean | string);
+    /**
+     * The agent playback surface its calls are acted out on (default `animation`, where `AnimationEditor` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /** The effect tools for an animation editor (see the module comment). */
 export declare function createAnimationEffectsToolProvider(controller: AnimationEditorController, options?: AnimationEffectsToolProviderOptions): AgentToolProvider;

package/dist/animation-editor/effect-tools.d.ts

@@ -12,6 +12,11 @@ export interface AnimationEffectsToolProviderOptions {
     namespace?: string;
     /** The scene cannot be edited: write tools are hidden. A string is the reason. */
     readOnly?: boolean | string | (() => boolean | string);
+    /**
+     * The agent playback surface its calls are acted out on (default `animation`, where `AnimationEditor` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /** The effect tools for an animation editor (see the module comment). */
 export declare function createAnimationEffectsToolProvider(controller: AnimationEditorController, options?: AnimationEffectsToolProviderOptions): AgentToolProvider;

package/dist/animation-editor/index.cjs

@@ -4397,12 +4397,12 @@ function planAnimationToolPlayback(tool, args) {
   for (const id of elementsOf(args)) steps.push({ type: "target", ref: { kind: "element", id } });
   return steps.length ? steps : null;
 }
-function withAnimationPlayback(provider, surface = "animation") {
+function withAnimationPlayback(provider, surface) {
   const plan = (tool) => tool.plan || tool.playback !== void 0 ? tool : { ...tool, plan: (args) => planAnimationToolPlayback(tool.name, args) };
   const tools = provider.tools;
   return {
     ...provider,
-    playbackSurface: _nullishCoalesce(provider.playbackSurface, () => ( surface)),
+    playbackSurface: _nullishCoalesce(_nullishCoalesce(surface, () => ( provider.playbackSurface)), () => ( "animation")),
     tools: typeof tools === "function" ? () => tools().map(plan) : tools.map(plan)
   };
 }
@@ -5505,7 +5505,7 @@ function createAnimationEditorToolProvider(controller, options = {}) {
         }
       });
     }
-  });
+  }, options.playbackSurface);
 }
 
 // src/animation-editor/instructions.ts
@@ -5928,7 +5928,7 @@ function createAnimationEffectsToolProvider(controller, options = {}) {
         }
       }
     ]
-  }));
+  }), options.playbackSurface);
 }
 
 

package/dist/animation-editor/index.js

@@ -4397,12 +4397,12 @@ function planAnimationToolPlayback(tool, args) {
   for (const id of elementsOf(args)) steps.push({ type: "target", ref: { kind: "element", id } });
   return steps.length ? steps : null;
 }
-function withAnimationPlayback(provider, surface = "animation") {
+function withAnimationPlayback(provider, surface) {
   const plan = (tool) => tool.plan || tool.playback !== void 0 ? tool : { ...tool, plan: (args) => planAnimationToolPlayback(tool.name, args) };
   const tools = provider.tools;
   return {
     ...provider,
-    playbackSurface: provider.playbackSurface ?? surface,
+    playbackSurface: surface ?? provider.playbackSurface ?? "animation",
     tools: typeof tools === "function" ? () => tools().map(plan) : tools.map(plan)
   };
 }
@@ -5505,7 +5505,7 @@ function createAnimationEditorToolProvider(controller, options = {}) {
         }
       });
     }
-  });
+  }, options.playbackSurface);
 }
 
 // src/animation-editor/instructions.ts
@@ -5928,7 +5928,7 @@ function createAnimationEffectsToolProvider(controller, options = {}) {
         }
       }
     ]
-  }));
+  }), options.playbackSurface);
 }
 export {
   ANIMATION_EDITOR_AGENT_INSTRUCTIONS,

package/dist/animation-editor/playback.d.cts

@@ -4,7 +4,8 @@ import type { PlaybackStep } from '../tools/playback.cjs';
 export declare function planAnimationToolPlayback(tool: string, args: Record<string, any>): PlaybackStep[] | null;
 /**
  * Gives an animation tool provider agent playback: each tool plans its steps with
- * `planAnimationToolPlayback` and every call plays on `surface` (default `animation`, where
- * `AnimationEditor` attaches itself).
+ * `planAnimationToolPlayback` and every call plays on `surface`. An explicit `surface` wins over
+ * the provider's own `playbackSurface`; with neither, it is `animation` (where `AnimationEditor`
+ * attaches itself).
  */
 export declare function withAnimationPlayback(provider: AgentToolProvider, surface?: string): AgentToolProvider;

package/dist/animation-editor/playback.d.ts

@@ -4,7 +4,8 @@ import type { PlaybackStep } from '../tools/playback.js';
 export declare function planAnimationToolPlayback(tool: string, args: Record<string, any>): PlaybackStep[] | null;
 /**
  * Gives an animation tool provider agent playback: each tool plans its steps with
- * `planAnimationToolPlayback` and every call plays on `surface` (default `animation`, where
- * `AnimationEditor` attaches itself).
+ * `planAnimationToolPlayback` and every call plays on `surface`. An explicit `surface` wins over
+ * the provider's own `playbackSurface`; with neither, it is `animation` (where `AnimationEditor`
+ * attaches itself).
  */
 export declare function withAnimationPlayback(provider: AgentToolProvider, surface?: string): AgentToolProvider;

package/dist/animation-editor/tools.d.cts

@@ -20,6 +20,11 @@ export interface AnimationEditorToolProviderOptions {
         data: string;
         mimeType: string;
     };
+    /**
+     * The agent playback surface its calls are acted out on (default `animation`, where `AnimationEditor` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /**
  * Full JSON Schema of each command type: every field with its range, default and meaning, self-contained.

package/dist/animation-editor/tools.d.ts

@@ -20,6 +20,11 @@ export interface AnimationEditorToolProviderOptions {
         data: string;
         mimeType: string;
     };
+    /**
+     * The agent playback surface its calls are acted out on (default `animation`, where `AnimationEditor` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /**
  * Full JSON Schema of each command type: every field with its range, default and meaning, self-contained.

package/dist/chart/index.cjs

@@ -1158,7 +1158,7 @@ function withChartPlayback(provider, options) {
   const tools = provider.tools;
   return {
     ...provider,
-    playbackSurface: _nullishCoalesce(_nullishCoalesce(provider.playbackSurface, () => ( options.surface)), () => ( "chart")),
+    playbackSurface: _nullishCoalesce(_nullishCoalesce(options.surface, () => ( provider.playbackSurface)), () => ( "chart")),
     tools: typeof tools === "function" ? () => tools().map(plan) : tools.map(plan)
   };
 }
@@ -1746,7 +1746,7 @@ function createChartToolProvider(controller, options = {}) {
         }
       });
     }
-  }, { director: !!options.director });
+  }, { director: !!options.director, surface: options.playbackSurface });
 }
 
 // src/chart/stream.ts

package/dist/chart/index.js

@@ -1158,7 +1158,7 @@ function withChartPlayback(provider, options) {
   const tools = provider.tools;
   return {
     ...provider,
-    playbackSurface: provider.playbackSurface ?? options.surface ?? "chart",
+    playbackSurface: options.surface ?? provider.playbackSurface ?? "chart",
     tools: typeof tools === "function" ? () => tools().map(plan) : tools.map(plan)
   };
 }
@@ -1746,7 +1746,7 @@ function createChartToolProvider(controller, options = {}) {
         }
       });
     }
-  }, { director: !!options.director });
+  }, { director: !!options.director, surface: options.playbackSurface });
 }
 
 // src/chart/stream.ts

package/dist/chart/playback.d.cts

@@ -13,8 +13,8 @@ export declare function locateChartPoint(spec: ChartSpec, scene: ChartScene, ref
 /** The cursor steps for one chart tool call (by bare name), or null to fall back to the ids it names. */
 export declare function planChartToolPlayback(tool: string, args: Record<string, any>): PlaybackStep[] | null;
 /**
- * Gives a chart tool provider agent playback on `surface` (default `chart`, where `ChartEditor`
- * attaches). With a director, value changes and selections play through it (`playback: 'self'`).
+ * Gives a chart tool provider agent playback on `surface`. An explicit `surface` wins over the
+ * provider's own `playbackSurface`; with neither, it is `chart` (where `ChartEditor` attaches). With a director, value changes and selections play through it (`playback: 'self'`).
  */
 export declare function withChartPlayback(provider: AgentToolProvider, options: {
     director: boolean;

package/dist/chart/playback.d.ts

@@ -13,8 +13,8 @@ export declare function locateChartPoint(spec: ChartSpec, scene: ChartScene, ref
 /** The cursor steps for one chart tool call (by bare name), or null to fall back to the ids it names. */
 export declare function planChartToolPlayback(tool: string, args: Record<string, any>): PlaybackStep[] | null;
 /**
- * Gives a chart tool provider agent playback on `surface` (default `chart`, where `ChartEditor`
- * attaches). With a director, value changes and selections play through it (`playback: 'self'`).
+ * Gives a chart tool provider agent playback on `surface`. An explicit `surface` wins over the
+ * provider's own `playbackSurface`; with neither, it is `chart` (where `ChartEditor` attaches). With a director, value changes and selections play through it (`playback: 'self'`).
  */
 export declare function withChartPlayback(provider: AgentToolProvider, options: {
     director: boolean;

package/dist/chart/tools.d.cts

@@ -39,6 +39,11 @@ export interface ChartToolProviderOptions {
         data: string;
         mimeType: string;
     };
+    /**
+     * The agent playback surface its calls are acted out on (default `chart`, where `ChartEditor` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /**
  * When to look at the chart, for `render_chart`'s description (after vectorcraft's

package/dist/chart/tools.d.ts

@@ -39,6 +39,11 @@ export interface ChartToolProviderOptions {
         data: string;
         mimeType: string;
     };
+    /**
+     * The agent playback surface its calls are acted out on (default `chart`, where `ChartEditor` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /**
  * When to look at the chart, for `render_chart`'s description (after vectorcraft's

package/dist/{chunk-HUHBJWTD.js → chunk-3EVMUYF4.js}

@@ -80,6 +80,20 @@ function unionRects(rects) {
   const y = Math.min(...list.map((r) => r.y));
   return { x, y, width: Math.max(...list.map((r) => r.x + r.width)) - x, height: Math.max(...list.map((r) => r.y + r.height)) - y };
 }
+function playbackRectFromClient(rect, fromViewport) {
+  if (!rect || !(rect.width > 0) || !(rect.height > 0)) return null;
+  const map = fromViewport ?? ((p) => p);
+  const a = map({ x: rect.left, y: rect.top });
+  const b = map({ x: rect.left + rect.width, y: rect.top + rect.height });
+  return { x: Math.min(a.x, b.x), y: Math.min(a.y, b.y), width: Math.abs(b.x - a.x), height: Math.abs(b.y - a.y) };
+}
+function locatePlaybackChrome(ref, chrome, fromViewport) {
+  if (!chrome) return null;
+  const own = chrome.locate?.(ref);
+  if (own) return own;
+  const el = chrome.locateElement?.(ref);
+  return el ? playbackRectFromClient(el.getBoundingClientRect(), fromViewport) : null;
+}
 function normalizePlan(plan) {
   if (!plan) return null;
   if (Array.isArray(plan)) return plan.length ? { steps: plan } : null;
@@ -441,6 +455,8 @@ export {
   derivePlaybackSteps,
   readingTime,
   unionRects,
+  playbackRectFromClient,
+  locatePlaybackChrome,
   AgentPlayback,
   createAgentPlayback,
   createPlaybackToolProvider

package/dist/{chunk-D2ENR3LB.cjs → chunk-FR7GHH2K.cjs}

@@ -80,10 +80,24 @@ function unionRects(rects) {
   const y = Math.min(...list.map((r) => r.y));
   return { x, y, width: Math.max(...list.map((r) => r.x + r.width)) - x, height: Math.max(...list.map((r) => r.y + r.height)) - y };
 }
+function playbackRectFromClient(rect, fromViewport) {
+  if (!rect || !(rect.width > 0) || !(rect.height > 0)) return null;
+  const map = _nullishCoalesce(fromViewport, () => ( ((p) => p)));
+  const a = map({ x: rect.left, y: rect.top });
+  const b = map({ x: rect.left + rect.width, y: rect.top + rect.height });
+  return { x: Math.min(a.x, b.x), y: Math.min(a.y, b.y), width: Math.abs(b.x - a.x), height: Math.abs(b.y - a.y) };
+}
+function locatePlaybackChrome(ref, chrome, fromViewport) {
+  if (!chrome) return null;
+  const own = _optionalChain([chrome, 'access', _3 => _3.locate, 'optionalCall', _4 => _4(ref)]);
+  if (own) return own;
+  const el = _optionalChain([chrome, 'access', _5 => _5.locateElement, 'optionalCall', _6 => _6(ref)]);
+  return el ? playbackRectFromClient(el.getBoundingClientRect(), fromViewport) : null;
+}
 function normalizePlan(plan) {
   if (!plan) return null;
   if (Array.isArray(plan)) return plan.length ? { steps: plan } : null;
-  return _optionalChain([plan, 'access', _3 => _3.steps, 'optionalAccess', _4 => _4.length]) || plan.surface || plan.readOnly !== void 0 ? plan : null;
+  return _optionalChain([plan, 'access', _7 => _7.steps, 'optionalAccess', _8 => _8.length]) || plan.surface || plan.readOnly !== void 0 ? plan : null;
 }
 var isErrorResult = (value) => !!value && typeof value === "object" && value.isError === true;
 var center = (r) => ({ x: r.x + r.width / 2, y: r.y + r.height / 2 });
@@ -150,7 +164,7 @@ var AgentPlayback = (_class = class {
   say(text, options = {}) {
     const actor = this.actorState(options.actor);
     const surface = actor.surface ? this.surfaces.get(actor.surface) : void 0;
-    if (!_optionalChain([surface, 'optionalAccess', _5 => _5.presence, 'access', _6 => _6.get, 'call', _7 => _7(actor.info.id)])) return null;
+    if (!_optionalChain([surface, 'optionalAccess', _9 => _9.presence, 'access', _10 => _10.get, 'call', _11 => _11(actor.info.id)])) return null;
     surface.presence.set({ id: actor.info.id, message: text });
     return actor.surface;
   }
@@ -170,7 +184,7 @@ var AgentPlayback = (_class = class {
     if (!actor) {
       actor = { info: { ...base, color: _nullishCoalesce(base.color, () => ( _chunkUJGAA6AKcjs.PRESENCE_COLORS[this.actors.size % _chunkUJGAA6AKcjs.PRESENCE_COLORS.length])) }, queue: Promise.resolve(), version: 0 };
       this.actors.set(base.id, actor);
-    } else if (_optionalChain([info, 'optionalAccess', _8 => _8.name]) && info.name !== actor.info.name) actor.info = { ...actor.info, name: info.name };
+    } else if (_optionalChain([info, 'optionalAccess', _12 => _12.name]) && info.name !== actor.info.name) actor.info = { ...actor.info, name: info.name };
     return actor;
   }
   enqueue(actor, run) {
@@ -195,26 +209,26 @@ var AgentPlayback = (_class = class {
     if (tool.plan) {
       try {
         const state = {
-          surfaceId: _nullishCoalesce(_optionalChain([fallback, 'optionalAccess', _9 => _9[0]]), () => ( null)),
-          locate: (ref) => _nullishCoalesce(_optionalChain([fallback, 'optionalAccess', _10 => _10[1], 'access', _11 => _11.locate, 'optionalCall', _12 => _12(ref)]), () => ( null))
+          surfaceId: _nullishCoalesce(_optionalChain([fallback, 'optionalAccess', _13 => _13[0]]), () => ( null)),
+          locate: (ref) => _nullishCoalesce(_optionalChain([fallback, 'optionalAccess', _14 => _14[1], 'access', _15 => _15.locate, 'optionalCall', _16 => _16(ref)]), () => ( null))
         };
         planned = normalizePlan(tool.plan(call.args, state));
       } catch (e2) {
         planned = null;
       }
     }
-    const readOnly = _nullishCoalesce(_optionalChain([planned, 'optionalAccess', _13 => _13.readOnly]), () => ( _optionalChain([tool, 'access', _14 => _14.annotations, 'optionalAccess', _15 => _15.readOnlyHint]) === true));
+    const readOnly = _nullishCoalesce(_optionalChain([planned, 'optionalAccess', _17 => _17.readOnly]), () => ( _optionalChain([tool, 'access', _18 => _18.annotations, 'optionalAccess', _19 => _19.readOnlyHint]) === true));
     if (readOnly && this.reads === "skip") return next();
-    const found = this.surfaceFor(call.provider, _optionalChain([planned, 'optionalAccess', _16 => _16.surface]));
+    const found = this.surfaceFor(call.provider, _optionalChain([planned, 'optionalAccess', _20 => _20.surface]));
     if (!found) return next();
     const [surfaceId, surface] = found;
-    const steps = _optionalChain([planned, 'optionalAccess', _17 => _17.steps, 'optionalAccess', _18 => _18.length]) ? planned.steps : derivePlaybackSteps(call.args, surface.defaultKind);
+    const steps = _optionalChain([planned, 'optionalAccess', _21 => _21.steps, 'optionalAccess', _22 => _22.length]) ? planned.steps : derivePlaybackSteps(call.args, surface.defaultKind);
     const glance = readOnly && this.reads === "glance";
     const played = glance ? steps.filter((s) => GLANCE_STEPS.has(s.type)) : steps;
     if (!played.some((s) => s.type !== "commit")) return next();
     return this.enqueue(actor, async () => {
       if (surface.visible && !surface.visible()) {
-        await _optionalChain([surface, 'access', _19 => _19.reveal, 'optionalCall', _20 => _20()]);
+        await _optionalChain([surface, 'access', _23 => _23.reveal, 'optionalCall', _24 => _24()]);
         if (surface.visible && !surface.visible()) return next();
       }
       return this.play({ call, next, actor, surfaceId, surface, steps: played, readOnly, glance });
@@ -228,22 +242,22 @@ var AgentPlayback = (_class = class {
     const pace = () => Math.max(0.1, this.speed) * (run.glance ? 1.6 : 1);
     const wait = (ms) => instant() || ms <= 0 ? Promise.resolve() : this.clock.wait(ms / pace());
     const presence = surface.presence;
-    const locate = (ref) => finiteRect(_nullishCoalesce(_optionalChain([surface, 'access', _21 => _21.locate, 'optionalCall', _22 => _22(ref.kind === "item" ? { kind: _nullishCoalesce(surface.defaultKind, () => ( "item")), id: ref.id } : ref)]), () => ( null)));
+    const locate = (ref) => finiteRect(_nullishCoalesce(_optionalChain([surface, 'access', _25 => _25.locate, 'optionalCall', _26 => _26(ref.kind === "item" ? { kind: _nullishCoalesce(surface.defaultKind, () => ( "item")), id: ref.id } : ref)]), () => ( null)));
     const record = (step) => {
       for (const list of this.recordings) list.push({ actor: id, surface: surfaceId, tool: call.name, step });
     };
     this.running++;
     if (this.running === 1) this.listeners.forEach((l) => l());
     try {
-      if (actor.surface && actor.surface !== surfaceId) _optionalChain([this, 'access', _23 => _23.surfaces, 'access', _24 => _24.get, 'call', _25 => _25(actor.surface), 'optionalAccess', _26 => _26.presence, 'access', _27 => _27.remove, 'call', _28 => _28(id)]);
+      if (actor.surface && actor.surface !== surfaceId) _optionalChain([this, 'access', _27 => _27.surfaces, 'access', _28 => _28.get, 'call', _29 => _29(actor.surface), 'optionalAccess', _30 => _30.presence, 'access', _31 => _31.remove, 'call', _32 => _32(id)]);
       if (!presence.get(id)) {
-        const bounds = _nullishCoalesce(_optionalChain([surface, 'access', _29 => _29.bounds, 'optionalCall', _30 => _30()]), () => ( null));
+        const bounds = _nullishCoalesce(_optionalChain([surface, 'access', _33 => _33.bounds, 'optionalCall', _34 => _34()]), () => ( null));
         let at = actor.viewport && surface.fromViewport ? surface.fromViewport(actor.viewport) : null;
         if (at && bounds) at = { x: Math.min(bounds.x + bounds.width, Math.max(bounds.x, at.x)), y: Math.min(bounds.y + bounds.height, Math.max(bounds.y, at.y)) };
         at ??= bounds ? { x: bounds.x + bounds.width - 48, y: bounds.y + 32 } : null;
         if (!at) {
           const first = run.steps.find((s) => s.type === "move" || s.type === "target" || s.type === "drag");
-          const rect = _optionalChain([first, 'optionalAccess', _31 => _31.type]) === "target" ? locate(first.ref) : null;
+          const rect = _optionalChain([first, 'optionalAccess', _35 => _35.type]) === "target" ? locate(first.ref) : null;
           at = first && first.type !== "target" ? first.to : rect ? center(rect) : { x: 0, y: 0 };
         }
         presence.set({ id, name: _nullishCoalesce(actor.info.name, () => ( id)), color: actor.info.color, x: at.x, y: at.y, pressed: false });
@@ -251,7 +265,7 @@ var AgentPlayback = (_class = class {
       actor.surface = surfaceId;
       actor.version++;
       const argRefs = playbackRefsFromArgs(call.args, surface.defaultKind);
-      if (!readOnly) _optionalChain([surface, 'access', _32 => _32.beginGesture, 'optionalCall', _33 => _33(`agent:${id}:${++this.calls}`)]);
+      if (!readOnly) _optionalChain([surface, 'access', _36 => _36.beginGesture, 'optionalCall', _37 => _37(`agent:${id}:${++this.calls}`)]);
       let result;
       let committed = false;
       try {
@@ -287,11 +301,11 @@ var AgentPlayback = (_class = class {
         await wait(900);
         throw error;
       } finally {
-        if (!readOnly) _optionalChain([surface, 'access', _34 => _34.endGesture, 'optionalCall', _35 => _35()]);
+        if (!readOnly) _optionalChain([surface, 'access', _38 => _38.endGesture, 'optionalCall', _39 => _39()]);
         presence.set({ id, pressed: false });
       }
       if (isErrorResult(result)) {
-        const text = _nullishCoalesce(_optionalChain([result, 'access', _36 => _36.content, 'optionalAccess', _37 => _37.find, 'call', _38 => _38((c) => c.type === "text"), 'optionalAccess', _39 => _39.text]), () => ( "The tool failed."));
+        const text = _nullishCoalesce(_optionalChain([result, 'access', _40 => _40.content, 'optionalAccess', _41 => _41.find, 'call', _42 => _42((c) => c.type === "text"), 'optionalAccess', _43 => _43.text]), () => ( "The tool failed."));
         presence.set({ id, message: `\u2717 ${text}`.slice(0, 140) });
         await wait(900);
       } else if (!readOnly) {
@@ -444,4 +458,6 @@ function createPlaybackToolProvider(playback, options = {}) {
 
 
 
-exports.playbackRefsFromArgs = playbackRefsFromArgs; exports.playbackRefsFromResult = playbackRefsFromResult; exports.derivePlaybackSteps = derivePlaybackSteps; exports.readingTime = readingTime; exports.unionRects = unionRects; exports.AgentPlayback = AgentPlayback; exports.createAgentPlayback = createAgentPlayback; exports.createPlaybackToolProvider = createPlaybackToolProvider;
+
+
+exports.playbackRefsFromArgs = playbackRefsFromArgs; exports.playbackRefsFromResult = playbackRefsFromResult; exports.derivePlaybackSteps = derivePlaybackSteps; exports.readingTime = readingTime; exports.unionRects = unionRects; exports.playbackRectFromClient = playbackRectFromClient; exports.locatePlaybackChrome = locatePlaybackChrome; exports.AgentPlayback = AgentPlayback; exports.createAgentPlayback = createAgentPlayback; exports.createPlaybackToolProvider = createPlaybackToolProvider;

package/dist/{chunk-SA37RU2O.js → chunk-OOV64UEB.js}

@@ -1,6 +1,6 @@
 import {
   readingTime
-} from "./chunk-HUHBJWTD.js";
+} from "./chunk-3EVMUYF4.js";
 
 // src/tools/script.ts
 function toolResultValue(result) {

package/dist/{chunk-AG2EXVCR.cjs → chunk-ZCFHPORF.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkD2ENR3LBcjs = require('./chunk-D2ENR3LB.cjs');
+var _chunkFR7GHH2Kcjs = require('./chunk-FR7GHH2K.cjs');
 
 // src/tools/script.ts
 function toolResultValue(result) {
@@ -36,7 +36,7 @@ async function runToolScript(source, script, options = {}) {
     if (step.say) {
       emit({ type: "say", step: i, text: step.say });
       _optionalChain([options, 'access', _6 => _6.playback, 'optionalAccess', _7 => _7.say, 'call', _8 => _8(step.say, options.actor ? { actor: options.actor } : {})]);
-      await pause(_chunkD2ENR3LBcjs.readingTime.call(void 0, step.say));
+      await pause(_chunkFR7GHH2Kcjs.readingTime.call(void 0, step.say));
     }
     if (!step.tool) continue;
     if (control.stopped) return finish(false);

package/dist/commands/index.cjs

@@ -29,7 +29,7 @@ var _chunkGLQQ2VILcjs = require('../chunk-GLQQ2VIL.cjs');
 var _chunk4EFNS2HVcjs = require('../chunk-4EFNS2HV.cjs');
 
 
-var _chunkD2ENR3LBcjs = require('../chunk-D2ENR3LB.cjs');
+var _chunkFR7GHH2Kcjs = require('../chunk-FR7GHH2K.cjs');
 require('../chunk-UJGAA6AK.cjs');
 
 
@@ -608,7 +608,7 @@ function createCommandToolProvider(registry, options = {}) {
     const surface = _nullishCoalesce(_nullishCoalesce(spec.playbackSurface, () => ( spec.scope)), () => ( (id.includes(".") ? id.slice(0, id.indexOf(".")) : void 0)));
     const planned = _optionalChain([spec, 'access', _24 => _24.plan, 'optionalCall', _25 => _25(context(), _nullishCoalesce(params, () => ( {})))]);
     const own = !planned ? [] : Array.isArray(planned) ? planned : planned.steps;
-    const steps = own.length ? own : _chunkD2ENR3LBcjs.derivePlaybackSteps.call(void 0, params);
+    const steps = own.length ? own : _chunkFR7GHH2Kcjs.derivePlaybackSteps.call(void 0, params);
     return {
       steps,
       ...surface ? { surface } : {},

package/dist/commands/index.js

@@ -29,7 +29,7 @@ import {
 } from "../chunk-7KZ2HKKC.js";
 import {
   derivePlaybackSteps
-} from "../chunk-HUHBJWTD.js";
+} from "../chunk-3EVMUYF4.js";
 import "../chunk-PEEP2YR7.js";
 import {
   validateJsonSchema

package/dist/image-editor/index.cjs

@@ -9300,12 +9300,12 @@ function planImageToolPlayback(tool, args) {
   }
   return steps.length ? steps : null;
 }
-function withImagePlayback(provider, surface = "image") {
+function withImagePlayback(provider, surface) {
   const plan = (tool) => tool.plan || tool.playback !== void 0 ? tool : { ...tool, plan: (args) => planImageToolPlayback(tool.name, args) };
   const tools = provider.tools;
   return {
     ...provider,
-    playbackSurface: _nullishCoalesce(provider.playbackSurface, () => ( surface)),
+    playbackSurface: _nullishCoalesce(_nullishCoalesce(surface, () => ( provider.playbackSurface)), () => ( "image")),
     tools: typeof tools === "function" ? () => tools().map(plan) : tools.map(plan)
   };
 }
@@ -13275,7 +13275,7 @@ function createImageEditorToolProvider(controller, options = {}) {
       ..._chunkGNK7SESQcjs.createPigmentTools.call(void 0, ),
       ...createImagePsdTools(controller)
     ]
-  });
+  }, options.playbackSurface);
 }
 
 // src/image-editor/curve-editing.ts
@@ -15172,7 +15172,7 @@ function createImageEffectsToolProvider(controller, options = {}) {
         }
       }
     ]
-  }));
+  }), options.playbackSurface);
 }
 
 

package/dist/image-editor/index.js

@@ -9300,12 +9300,12 @@ function planImageToolPlayback(tool, args) {
   }
   return steps.length ? steps : null;
 }
-function withImagePlayback(provider, surface = "image") {
+function withImagePlayback(provider, surface) {
   const plan = (tool) => tool.plan || tool.playback !== void 0 ? tool : { ...tool, plan: (args) => planImageToolPlayback(tool.name, args) };
   const tools = provider.tools;
   return {
     ...provider,
-    playbackSurface: provider.playbackSurface ?? surface,
+    playbackSurface: surface ?? provider.playbackSurface ?? "image",
     tools: typeof tools === "function" ? () => tools().map(plan) : tools.map(plan)
   };
 }
@@ -13275,7 +13275,7 @@ function createImageEditorToolProvider(controller, options = {}) {
       ...createPigmentTools(),
       ...createImagePsdTools(controller)
     ]
-  });
+  }, options.playbackSurface);
 }
 
 // src/image-editor/curve-editing.ts
@@ -15172,7 +15172,7 @@ function createImageEffectsToolProvider(controller, options = {}) {
         }
       }
     ]
-  }));
+  }), options.playbackSurface);
 }
 export {
   ADJUSTMENT_KEYS,

package/dist/image-editor/playback.d.cts

@@ -16,7 +16,7 @@ export declare function createImagePlaybackLocator(controller: Pick<ImageEditorC
 export declare function planImageToolPlayback(tool: string, args: Record<string, any>): PlaybackStep[] | null;
 /**
  * Gives an image tool provider agent playback: each write tool plans its steps with
- * `planImageToolPlayback` and every call plays on the `surface` (default `image`, where
- * `ImageEditor` attaches itself).
+ * `planImageToolPlayback` and every call plays on `surface`. An explicit `surface` wins over the
+ * provider's own `playbackSurface`; with neither, it is `image` (where `ImageEditor` attaches itself).
  */
 export declare function withImagePlayback(provider: AgentToolProvider, surface?: string): AgentToolProvider;

package/dist/image-editor/playback.d.ts

@@ -16,7 +16,7 @@ export declare function createImagePlaybackLocator(controller: Pick<ImageEditorC
 export declare function planImageToolPlayback(tool: string, args: Record<string, any>): PlaybackStep[] | null;
 /**
  * Gives an image tool provider agent playback: each write tool plans its steps with
- * `planImageToolPlayback` and every call plays on the `surface` (default `image`, where
- * `ImageEditor` attaches itself).
+ * `planImageToolPlayback` and every call plays on `surface`. An explicit `surface` wins over the
+ * provider's own `playbackSurface`; with neither, it is `image` (where `ImageEditor` attaches itself).
  */
 export declare function withImagePlayback(provider: AgentToolProvider, surface?: string): AgentToolProvider;

package/dist/image-editor/provider-effect-tools.d.cts

@@ -16,6 +16,11 @@ export interface ImageEffectsToolProviderOptions {
     namespace?: string;
     /** The document cannot be edited: write tools are hidden. A string is the reason. */
     readOnly?: boolean | string | (() => boolean | string);
+    /**
+     * The agent playback surface its calls are acted out on (default `image`, where `ImageEditor` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /** A layer's provider effects as the tools report them: an effect layer's own effect, then its effect smart filters. */
 export declare function imageLayerAppliedEffects(layer: ImageLayer): AppliedEffectInfo[];

package/dist/image-editor/provider-effect-tools.d.ts

@@ -16,6 +16,11 @@ export interface ImageEffectsToolProviderOptions {
     namespace?: string;
     /** The document cannot be edited: write tools are hidden. A string is the reason. */
     readOnly?: boolean | string | (() => boolean | string);
+    /**
+     * The agent playback surface its calls are acted out on (default `image`, where `ImageEditor` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /** A layer's provider effects as the tools report them: an effect layer's own effect, then its effect smart filters. */
 export declare function imageLayerAppliedEffects(layer: ImageLayer): AppliedEffectInfo[];

package/dist/image-editor/tools.d.cts

@@ -5,6 +5,11 @@ export interface ImageEditorToolProviderOptions {
     id?: string;
     /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
     namespace?: string;
+    /**
+     * The agent playback surface its calls are acted out on (default `image`, where `ImageEditor` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /**
  * Agent tools for an image editor, for a `ToolRegistry`:

package/dist/image-editor/tools.d.ts

@@ -5,6 +5,11 @@ export interface ImageEditorToolProviderOptions {
     id?: string;
     /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
     namespace?: string;
+    /**
+     * The agent playback surface its calls are acted out on (default `image`, where `ImageEditor` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /**
  * Agent tools for an image editor, for a `ToolRegistry`:

package/dist/paint-editor/effect-tools.d.cts

@@ -13,6 +13,11 @@ export interface PaintEffectsToolProviderOptions {
     namespace?: string;
     /** The painting cannot be edited: write tools are hidden. A string is the reason. */
     readOnly?: boolean | string | (() => boolean | string);
+    /**
+     * The agent playback surface its calls are acted out on (default `paint`, where `PaintEditor` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /** The target id of the effect paper. */
 export declare const PAPER_TARGET = "paper";

package/dist/paint-editor/effect-tools.d.ts

@@ -13,6 +13,11 @@ export interface PaintEffectsToolProviderOptions {
     namespace?: string;
     /** The painting cannot be edited: write tools are hidden. A string is the reason. */
     readOnly?: boolean | string | (() => boolean | string);
+    /**
+     * The agent playback surface its calls are acted out on (default `paint`, where `PaintEditor` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /** The target id of the effect paper. */
 export declare const PAPER_TARGET = "paper";

package/dist/paint-editor/index.cjs

@@ -6046,7 +6046,7 @@ function withPaintPlayback(provider, options) {
   const tools = provider.tools;
   return {
     ...provider,
-    playbackSurface: _nullishCoalesce(_nullishCoalesce(provider.playbackSurface, () => ( options.surface)), () => ( "paint")),
+    playbackSurface: _nullishCoalesce(_nullishCoalesce(options.surface, () => ( provider.playbackSurface)), () => ( "paint")),
     tools: typeof tools === "function" ? () => tools().map(plan) : tools.map(plan)
   };
 }
@@ -7836,7 +7836,7 @@ function createPaintEditorToolProvider(controller, options = {}) {
     description: "Natural-media painting: paper and grain, dry and wet brushes, the brush library, strokes as data, pigment mixing, stencils, guides, layers and export.",
     skill: "pixerate-paint-editor",
     tools
-  }, { director: !!options.director });
+  }, { director: !!options.director, surface: options.playbackSurface });
 }
 
 // src/paint-editor/ui.ts
@@ -8554,7 +8554,7 @@ function createPaintEffectsToolProvider(controller, options = {}) {
         }
       }
     ]
-  }), { director: false });
+  }), { director: false, surface: options.playbackSurface });
 }
 
 

package/dist/paint-editor/index.js

@@ -6046,7 +6046,7 @@ function withPaintPlayback(provider, options) {
   const tools = provider.tools;
   return {
     ...provider,
-    playbackSurface: provider.playbackSurface ?? options.surface ?? "paint",
+    playbackSurface: options.surface ?? provider.playbackSurface ?? "paint",
     tools: typeof tools === "function" ? () => tools().map(plan) : tools.map(plan)
   };
 }
@@ -7836,7 +7836,7 @@ function createPaintEditorToolProvider(controller, options = {}) {
     description: "Natural-media painting: paper and grain, dry and wet brushes, the brush library, strokes as data, pigment mixing, stencils, guides, layers and export.",
     skill: "pixerate-paint-editor",
     tools
-  }, { director: !!options.director });
+  }, { director: !!options.director, surface: options.playbackSurface });
 }
 
 // src/paint-editor/ui.ts
@@ -8554,7 +8554,7 @@ function createPaintEffectsToolProvider(controller, options = {}) {
         }
       }
     ]
-  }), { director: false });
+  }), { director: false, surface: options.playbackSurface });
 }
 export {
   BLEND_MENU_GROUPS,

package/dist/paint-editor/playback.d.cts

@@ -7,8 +7,8 @@ export declare function paintPlaybackPanel(tool: string): PaintPlaybackPanel | n
 /** The cursor steps for one paint tool call (by bare name), or null to fall back to the ids it names. */
 export declare function planPaintToolPlayback(tool: string, _args: Record<string, any>): PlaybackStep[] | null;
 /**
- * Gives a paint tool provider agent playback on `surface` (default `paint`, where `PaintEditor`
- * attaches). With a director, strokes, fills and replays play through it (`playback: 'self'`).
+ * Gives a paint tool provider agent playback on `surface`. An explicit `surface` wins over the
+ * provider's own `playbackSurface`; with neither, it is `paint` (where `PaintEditor` attaches). With a director, strokes, fills and replays play through it (`playback: 'self'`).
  */
 export declare function withPaintPlayback(provider: AgentToolProvider, options: {
     director: boolean;

package/dist/paint-editor/playback.d.ts

@@ -7,8 +7,8 @@ export declare function paintPlaybackPanel(tool: string): PaintPlaybackPanel | n
 /** The cursor steps for one paint tool call (by bare name), or null to fall back to the ids it names. */
 export declare function planPaintToolPlayback(tool: string, _args: Record<string, any>): PlaybackStep[] | null;
 /**
- * Gives a paint tool provider agent playback on `surface` (default `paint`, where `PaintEditor`
- * attaches). With a director, strokes, fills and replays play through it (`playback: 'self'`).
+ * Gives a paint tool provider agent playback on `surface`. An explicit `surface` wins over the
+ * provider's own `playbackSurface`; with neither, it is `paint` (where `PaintEditor` attaches). With a director, strokes, fills and replays play through it (`playback: 'self'`).
  */
 export declare function withPaintPlayback(provider: AgentToolProvider, options: {
     director: boolean;

package/dist/paint-editor/tools.d.cts

@@ -20,6 +20,11 @@ export interface PaintEditorToolProviderOptions {
     director?: PaintDirector;
     /** The agent's cursor (default `{ id: 'agent', name: 'Agent' }`). */
     actor?: PresenceActorInfo;
+    /**
+     * The agent playback surface its calls are acted out on (default `paint`, where `PaintEditor` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /** Agent tools for one paint editor. */
 export declare function createPaintEditorToolProvider(controller: PaintEditorController, options?: PaintEditorToolProviderOptions): AgentToolProvider;

package/dist/paint-editor/tools.d.ts

@@ -20,6 +20,11 @@ export interface PaintEditorToolProviderOptions {
     director?: PaintDirector;
     /** The agent's cursor (default `{ id: 'agent', name: 'Agent' }`). */
     actor?: PresenceActorInfo;
+    /**
+     * The agent playback surface its calls are acted out on (default `paint`, where `PaintEditor` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /** Agent tools for one paint editor. */
 export declare function createPaintEditorToolProvider(controller: PaintEditorController, options?: PaintEditorToolProviderOptions): AgentToolProvider;

package/dist/tools/index.cjs

@@ -2,7 +2,7 @@
 
 
 
-var _chunkAG2EXVCRcjs = require('../chunk-AG2EXVCR.cjs');
+var _chunkZCFHPORFcjs = require('../chunk-ZCFHPORF.cjs');
 
 
 
@@ -38,7 +38,9 @@ var _chunkY4BWZB6Jcjs = require('../chunk-Y4BWZB6J.cjs');
 
 
 
-var _chunkD2ENR3LBcjs = require('../chunk-D2ENR3LB.cjs');
+
+
+var _chunkFR7GHH2Kcjs = require('../chunk-FR7GHH2K.cjs');
 
 
 
@@ -171,4 +173,6 @@ var _chunkWOFXZ3XUcjs = require('../chunk-WOFXZ3XU.cjs');
 
 
 
-exports.AgentPlayback = _chunkD2ENR3LBcjs.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 = _chunkD2ENR3LBcjs.createAgentPlayback; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createInstantPresenceClock = _chunkUJGAA6AKcjs.createInstantPresenceClock; exports.createMcpServer = _chunkY4BWZB6Jcjs.createMcpServer; exports.createPlaybackToolProvider = _chunkD2ENR3LBcjs.createPlaybackToolProvider; exports.createToolRegistry = _chunkY4BWZB6Jcjs.createToolRegistry; exports.derivePlaybackSteps = _chunkD2ENR3LBcjs.derivePlaybackSteps; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkY4BWZB6Jcjs.errorResult; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkills = _chunkY4BWZB6Jcjs.listSkills; exports.parseSkillFrontmatter = _chunkY4BWZB6Jcjs.parseSkillFrontmatter; exports.playbackRefsFromArgs = _chunkD2ENR3LBcjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunkD2ENR3LBcjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkY4BWZB6Jcjs.readSkillFile; exports.readingTime = _chunkD2ENR3LBcjs.readingTime; exports.realPresenceClock = _chunkUJGAA6AKcjs.realPresenceClock; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.runToolScript = _chunkAG2EXVCRcjs.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.toolResultError = _chunkAG2EXVCRcjs.toolResultError; exports.toolResultValue = _chunkAG2EXVCRcjs.toolResultValue; exports.toolsetInstructions = _chunkY4BWZB6Jcjs.toolsetInstructions; exports.toolsetName = _chunkY4BWZB6Jcjs.toolsetName; exports.tweenPresenceCursor = _chunkUJGAA6AKcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunkD2ENR3LBcjs.unionRects; exports.unknownToolMessage = _chunkY4BWZB6Jcjs.unknownToolMessage; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;
+
+
+exports.AgentPlayback = _chunkFR7GHH2Kcjs.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 = _chunkFR7GHH2Kcjs.createAgentPlayback; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createInstantPresenceClock = _chunkUJGAA6AKcjs.createInstantPresenceClock; exports.createMcpServer = _chunkY4BWZB6Jcjs.createMcpServer; exports.createPlaybackToolProvider = _chunkFR7GHH2Kcjs.createPlaybackToolProvider; exports.createToolRegistry = _chunkY4BWZB6Jcjs.createToolRegistry; exports.derivePlaybackSteps = _chunkFR7GHH2Kcjs.derivePlaybackSteps; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkY4BWZB6Jcjs.errorResult; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkills = _chunkY4BWZB6Jcjs.listSkills; exports.locatePlaybackChrome = _chunkFR7GHH2Kcjs.locatePlaybackChrome; exports.parseSkillFrontmatter = _chunkY4BWZB6Jcjs.parseSkillFrontmatter; exports.playbackRectFromClient = _chunkFR7GHH2Kcjs.playbackRectFromClient; exports.playbackRefsFromArgs = _chunkFR7GHH2Kcjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunkFR7GHH2Kcjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkY4BWZB6Jcjs.readSkillFile; exports.readingTime = _chunkFR7GHH2Kcjs.readingTime; exports.realPresenceClock = _chunkUJGAA6AKcjs.realPresenceClock; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.runToolScript = _chunkZCFHPORFcjs.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.toolResultError = _chunkZCFHPORFcjs.toolResultError; exports.toolResultValue = _chunkZCFHPORFcjs.toolResultValue; exports.toolsetInstructions = _chunkY4BWZB6Jcjs.toolsetInstructions; exports.toolsetName = _chunkY4BWZB6Jcjs.toolsetName; exports.tweenPresenceCursor = _chunkUJGAA6AKcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunkFR7GHH2Kcjs.unionRects; exports.unknownToolMessage = _chunkY4BWZB6Jcjs.unknownToolMessage; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;

package/dist/tools/index.js

@@ -2,7 +2,7 @@ import {
   runToolScript,
   toolResultError,
   toolResultValue
-} from "../chunk-SA37RU2O.js";
+} from "../chunk-OOV64UEB.js";
 import {
   JSON_RPC_ERRORS,
   MCP_PROTOCOL_VERSIONS,
@@ -34,11 +34,13 @@ import {
   createAgentPlayback,
   createPlaybackToolProvider,
   derivePlaybackSteps,
+  locatePlaybackChrome,
+  playbackRectFromClient,
   playbackRefsFromArgs,
   playbackRefsFromResult,
   readingTime,
   unionRects
-} from "../chunk-HUHBJWTD.js";
+} from "../chunk-3EVMUYF4.js";
 import {
   CAPTURE_EXCLUDE_SELECTOR,
   CAPTURE_OVERLAY_SELECTORS,
@@ -147,7 +149,9 @@ export {
   errorResult,
   isUnsafeJsonKey,
   listSkills,
+  locatePlaybackChrome,
   parseSkillFrontmatter,
+  playbackRectFromClient,
   playbackRefsFromArgs,
   playbackRefsFromResult,
   rasterizeElement,

package/dist/tools/playback.d.cts

@@ -150,6 +150,34 @@ export declare function derivePlaybackSteps(args: unknown, defaultKind?: string)
 export declare function readingTime(text: string): number;
 /** Smallest rectangle around `rects`, or null. */
 export declare function unionRects(rects: readonly (PlaybackRect | null | undefined)[]): PlaybackRect | null;
+/** A box in client (viewport) pixels, as `Element.getBoundingClientRect()` returns it. */
+export interface PlaybackClientRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/**
+ * A client-pixel box (e.g. `element.getBoundingClientRect()`) in a surface's coordinates, through
+ * its `fromViewport` (identity without one). Null for an empty box (a hidden element).
+ */
+export declare function playbackRectFromClient(rect: PlaybackClientRect | null | undefined, fromViewport?: (point: PlaybackPoint) => PlaybackPoint): PlaybackRect | null;
+/**
+ * How a host's own chrome (a HUD, toolbar or panel over or beside an editor) answers a surface's
+ * refs. The canvas and element playback surfaces take these options; their own locator runs first.
+ */
+export interface PlaybackChromeOptions {
+    /** Where `ref` is, in the surface's coordinates (flow units on a canvas, element pixels on an element surface), or null. */
+    locate?(ref: PlaybackRef): PlaybackRect | null;
+    /** The element that shows `ref` anywhere on the page, or null; its client box is mapped to surface coordinates. */
+    locateElement?(ref: PlaybackRef): {
+        getBoundingClientRect(): PlaybackClientRect;
+    } | null;
+    /** Show `ref` for an `open` step (switch to a tab, expand a panel). Without it, `open` steps are skipped. */
+    open?(ref: PlaybackRef): void | Promise<void>;
+}
+/** Finds `ref` through `chrome.locate`, then `chrome.locateElement` (mapped with `fromViewport`), or null. */
+export declare function locatePlaybackChrome(ref: PlaybackRef, chrome: PlaybackChromeOptions | null | undefined, fromViewport?: (point: PlaybackPoint) => PlaybackPoint): PlaybackRect | null;
 /**
  * Acts out tool calls on attached surfaces. Install it on a registry (`registry.use(playback.middleware)`
  * or `playback.install(registry)`); editors attach their surfaces while mounted. Results never change:

package/dist/tools/playback.d.ts

@@ -150,6 +150,34 @@ export declare function derivePlaybackSteps(args: unknown, defaultKind?: string)
 export declare function readingTime(text: string): number;
 /** Smallest rectangle around `rects`, or null. */
 export declare function unionRects(rects: readonly (PlaybackRect | null | undefined)[]): PlaybackRect | null;
+/** A box in client (viewport) pixels, as `Element.getBoundingClientRect()` returns it. */
+export interface PlaybackClientRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/**
+ * A client-pixel box (e.g. `element.getBoundingClientRect()`) in a surface's coordinates, through
+ * its `fromViewport` (identity without one). Null for an empty box (a hidden element).
+ */
+export declare function playbackRectFromClient(rect: PlaybackClientRect | null | undefined, fromViewport?: (point: PlaybackPoint) => PlaybackPoint): PlaybackRect | null;
+/**
+ * How a host's own chrome (a HUD, toolbar or panel over or beside an editor) answers a surface's
+ * refs. The canvas and element playback surfaces take these options; their own locator runs first.
+ */
+export interface PlaybackChromeOptions {
+    /** Where `ref` is, in the surface's coordinates (flow units on a canvas, element pixels on an element surface), or null. */
+    locate?(ref: PlaybackRef): PlaybackRect | null;
+    /** The element that shows `ref` anywhere on the page, or null; its client box is mapped to surface coordinates. */
+    locateElement?(ref: PlaybackRef): {
+        getBoundingClientRect(): PlaybackClientRect;
+    } | null;
+    /** Show `ref` for an `open` step (switch to a tab, expand a panel). Without it, `open` steps are skipped. */
+    open?(ref: PlaybackRef): void | Promise<void>;
+}
+/** Finds `ref` through `chrome.locate`, then `chrome.locateElement` (mapped with `fromViewport`), or null. */
+export declare function locatePlaybackChrome(ref: PlaybackRef, chrome: PlaybackChromeOptions | null | undefined, fromViewport?: (point: PlaybackPoint) => PlaybackPoint): PlaybackRect | null;
 /**
  * Acts out tool calls on attached surfaces. Install it on a registry (`registry.use(playback.middleware)`
  * or `playback.install(registry)`); editors attach their surfaces while mounted. Results never change:

package/dist/video-editor/effect-tools.d.cts

@@ -15,6 +15,11 @@ export interface VideoEffectsToolProviderOptions {
     namespace?: string;
     /** The project cannot be edited: write tools are hidden. A string is the reason. */
     readOnly?: boolean | string | (() => boolean | string);
+    /**
+     * The agent playback surface its calls are acted out on (default `video`, where `VideoTimeline` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /** A clip's effects as the tools report them: its effect clip picture, its effect transition, then its stack. */
 export declare function videoClipAppliedEffects(clip: VideoClip): AppliedEffectInfo[];

package/dist/video-editor/effect-tools.d.ts

@@ -15,6 +15,11 @@ export interface VideoEffectsToolProviderOptions {
     namespace?: string;
     /** The project cannot be edited: write tools are hidden. A string is the reason. */
     readOnly?: boolean | string | (() => boolean | string);
+    /**
+     * The agent playback surface its calls are acted out on (default `video`, where `VideoTimeline` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /** A clip's effects as the tools report them: its effect clip picture, its effect transition, then its stack. */
 export declare function videoClipAppliedEffects(clip: VideoClip): AppliedEffectInfo[];

package/dist/video-editor/index.cjs

@@ -3267,12 +3267,12 @@ function planVideoToolPlayback(tool, args) {
   if (str2(args.marker)) return click({ kind: "marker", id: args.marker });
   return null;
 }
-function withVideoPlayback(provider, surface = "video") {
+function withVideoPlayback(provider, surface) {
   const plan = (tool) => tool.plan || tool.playback !== void 0 ? tool : { ...tool, plan: (args) => planVideoToolPlayback(tool.name, args) };
   const tools = provider.tools;
   return {
     ...provider,
-    playbackSurface: _nullishCoalesce(provider.playbackSurface, () => ( surface)),
+    playbackSurface: _nullishCoalesce(_nullishCoalesce(surface, () => ( provider.playbackSurface)), () => ( "video")),
     tools: typeof tools === "function" ? () => tools().map(plan) : tools.map(plan)
   };
 }
@@ -4686,7 +4686,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
         }
       });
     }
-  });
+  }, options.playbackSurface);
 }
 
 // src/video-editor/effect-tools.ts
@@ -4861,7 +4861,7 @@ function createVideoEffectsToolProvider(controller, options = {}) {
         }
       }
     ]
-  }));
+  }), options.playbackSurface);
 }
 
 

package/dist/video-editor/index.js

@@ -3267,12 +3267,12 @@ function planVideoToolPlayback(tool, args) {
   if (str2(args.marker)) return click({ kind: "marker", id: args.marker });
   return null;
 }
-function withVideoPlayback(provider, surface = "video") {
+function withVideoPlayback(provider, surface) {
   const plan = (tool) => tool.plan || tool.playback !== void 0 ? tool : { ...tool, plan: (args) => planVideoToolPlayback(tool.name, args) };
   const tools = provider.tools;
   return {
     ...provider,
-    playbackSurface: provider.playbackSurface ?? surface,
+    playbackSurface: surface ?? provider.playbackSurface ?? "video",
     tools: typeof tools === "function" ? () => tools().map(plan) : tools.map(plan)
   };
 }
@@ -4686,7 +4686,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
         }
       });
     }
-  });
+  }, options.playbackSurface);
 }
 
 // src/video-editor/effect-tools.ts
@@ -4861,7 +4861,7 @@ function createVideoEffectsToolProvider(controller, options = {}) {
         }
       }
     ]
-  }));
+  }), options.playbackSurface);
 }
 export {
   VIDEO_BLEND_MODES,

package/dist/video-editor/playback.d.cts

@@ -14,7 +14,8 @@ export declare function parseVideoTimeRef(ref: PlaybackRef): VideoPlaybackTime |
 export declare function planVideoToolPlayback(tool: string, args: Record<string, any>): PlaybackStep[] | null;
 /**
  * Gives a video tool provider agent playback: each write tool plans its steps with
- * `planVideoToolPlayback` and every call plays on `surface` (default `video`, where `VideoTimeline`
- * attaches itself). `seek_video` (a read in name only) and `edit_video` (a batch) play too.
+ * `planVideoToolPlayback` and every call plays on `surface`. An explicit `surface` wins over the
+ * provider's own `playbackSurface`; with neither, it is `video` (where `VideoTimeline` attaches
+ * itself). `seek_video` (a read in name only) and `edit_video` (a batch) play too.
  */
 export declare function withVideoPlayback(provider: AgentToolProvider, surface?: string): AgentToolProvider;

package/dist/video-editor/playback.d.ts

@@ -14,7 +14,8 @@ export declare function parseVideoTimeRef(ref: PlaybackRef): VideoPlaybackTime |
 export declare function planVideoToolPlayback(tool: string, args: Record<string, any>): PlaybackStep[] | null;
 /**
  * Gives a video tool provider agent playback: each write tool plans its steps with
- * `planVideoToolPlayback` and every call plays on `surface` (default `video`, where `VideoTimeline`
- * attaches itself). `seek_video` (a read in name only) and `edit_video` (a batch) play too.
+ * `planVideoToolPlayback` and every call plays on `surface`. An explicit `surface` wins over the
+ * provider's own `playbackSurface`; with neither, it is `video` (where `VideoTimeline` attaches
+ * itself). `seek_video` (a read in name only) and `edit_video` (a batch) play too.
  */
 export declare function withVideoPlayback(provider: AgentToolProvider, surface?: string): AgentToolProvider;

package/dist/video-editor/tools.d.cts

@@ -29,6 +29,11 @@ export interface VideoEditorToolProviderOptions {
     framePixels?: (time: number) => VideoPixels | null | Promise<VideoPixels | null>;
     /** How long `get_video_scopes` waits for the preview to finish drawing a frame (ms, default 5000). */
     framePixelsTimeout?: number;
+    /**
+     * The agent playback surface its calls are acted out on (default `video`, where `VideoTimeline` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /** A sequence as agents see it: its length, the sequences it nests, who plays it, and (with `tracks`) its tracks and clips. */
 export declare function describeVideoSequence(project: VideoProject, sequence: VideoSequence, tracks?: boolean): {

package/dist/video-editor/tools.d.ts

@@ -29,6 +29,11 @@ export interface VideoEditorToolProviderOptions {
     framePixels?: (time: number) => VideoPixels | null | Promise<VideoPixels | null>;
     /** How long `get_video_scopes` waits for the preview to finish drawing a frame (ms, default 5000). */
     framePixelsTimeout?: number;
+    /**
+     * The agent playback surface its calls are acted out on (default `video`, where `VideoTimeline` attaches).
+     * Set it when one registry holds several editors of this kind, each attached under its own surface id.
+     */
+    playbackSurface?: string;
 }
 /** A sequence as agents see it: its length, the sequences it nests, who plays it, and (with `tracks`) its tracks and clips. */
 export declare function describeVideoSequence(project: VideoProject, sequence: VideoSequence, tracks?: boolean): {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.148.0",
+  "version": "0.149.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",