@pixerate/editor 0.147.0 → 0.149.0

package/dist/effects/types.d.cts

@@ -8,6 +8,7 @@
  */
 import type { JsonSchema } from '../tools/schema.cjs';
 import type { FlairSvgAnimation } from '../animation-editor/flair.cjs';
+import type { EffectAuthoringSession, EffectAuthoringSource } from './authoring.cjs';
 /** How an effect is drawn: a pixel shader, an animated vector picture, or motion applied to someone else's vector art. */
 export type EffectKind = 'shader' | 'vector' | 'motion';
 /**
@@ -166,8 +167,10 @@ export interface EffectProviderCapabilities {
     supportsVector: boolean;
     /** Largest width or height a renderer accepts (px). */
     maxSize?: number;
+    /** Implements `openAuthoring`: effects can be edited, not only used. */
+    supportsAuthoring?: boolean;
 }
-type MaybePromise<T> = T | Promise<T>;
+export type MaybePromise<T> = T | Promise<T>;
 /**
  * A source of effects. Implementations live outside this library (for example Flair's
  * `flairEffects()`); `createFakeEffectProvider` is a small reference implementation.
@@ -194,5 +197,9 @@ export interface EffectProvider {
      * effect cannot use with `EffectUnsupportedError`.
      */
     applyVectorEffect?(id: string, target: EffectVectorTarget, values?: EffectValues): MaybePromise<EffectVectorMotion>;
+    /**
+     * Opens an effect for editing. Present when `capabilities.supportsAuthoring`. Unknown ids throw
+     * `UnknownEffectError`; an effect the provider cannot edit throws `EffectUnsupportedError`.
+     */
+    openAuthoring?(from: EffectAuthoringSource): MaybePromise<EffectAuthoringSession>;
 }
-export {};

package/dist/effects/types.d.ts

@@ -8,6 +8,7 @@
  */
 import type { JsonSchema } from '../tools/schema.js';
 import type { FlairSvgAnimation } from '../animation-editor/flair.js';
+import type { EffectAuthoringSession, EffectAuthoringSource } from './authoring.js';
 /** How an effect is drawn: a pixel shader, an animated vector picture, or motion applied to someone else's vector art. */
 export type EffectKind = 'shader' | 'vector' | 'motion';
 /**
@@ -166,8 +167,10 @@ export interface EffectProviderCapabilities {
     supportsVector: boolean;
     /** Largest width or height a renderer accepts (px). */
     maxSize?: number;
+    /** Implements `openAuthoring`: effects can be edited, not only used. */
+    supportsAuthoring?: boolean;
 }
-type MaybePromise<T> = T | Promise<T>;
+export type MaybePromise<T> = T | Promise<T>;
 /**
  * A source of effects. Implementations live outside this library (for example Flair's
  * `flairEffects()`); `createFakeEffectProvider` is a small reference implementation.
@@ -194,5 +197,9 @@ export interface EffectProvider {
      * effect cannot use with `EffectUnsupportedError`.
      */
     applyVectorEffect?(id: string, target: EffectVectorTarget, values?: EffectValues): MaybePromise<EffectVectorMotion>;
+    /**
+     * Opens an effect for editing. Present when `capabilities.supportsAuthoring`. Unknown ids throw
+     * `UnknownEffectError`; an effect the provider cannot edit throws `EffectUnsupportedError`.
+     */
+    openAuthoring?(from: EffectAuthoringSource): MaybePromise<EffectAuthoringSession>;
 }
-export {};

package/dist/effects/ui.d.cts

@@ -23,6 +23,14 @@ export declare const effectFieldValue: (field: ParameterField, value: unknown) =
  * differ, for a transition's two sides).
  */
 export declare function effectSamplePicture(width: number, height: number, variant?: number): EffectPixels;
+/**
+ * Sample pictures for an effect's image inputs (`effectSamplePicture`; a transition's `to` gets
+ * the second variant), so previews of filters and transitions have something to change.
+ */
+export declare function effectSampleInputs(description: Pick<EffectDescription, 'inputs'>, size: {
+    width: number;
+    height: number;
+}): Record<string, EffectPixels>;
 /**
  * A small preview of an effect from the provider's own renderer: filters run on a sample picture,
  * transitions go half way between two, generators and overlays draw at `time` (default half

package/dist/effects/ui.d.ts

@@ -23,6 +23,14 @@ export declare const effectFieldValue: (field: ParameterField, value: unknown) =
  * differ, for a transition's two sides).
  */
 export declare function effectSamplePicture(width: number, height: number, variant?: number): EffectPixels;
+/**
+ * Sample pictures for an effect's image inputs (`effectSamplePicture`; a transition's `to` gets
+ * the second variant), so previews of filters and transitions have something to change.
+ */
+export declare function effectSampleInputs(description: Pick<EffectDescription, 'inputs'>, size: {
+    width: number;
+    height: number;
+}): Record<string, EffectPixels>;
 /**
  * A small preview of an effect from the provider's own renderer: filters run on a sample picture,
  * transitions go half way between two, generators and overlays draw at `time` (default half

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;