@pixerate/editor 0.167.0 → 0.169.0

package/dist/agent/index.cjs

@@ -25,7 +25,7 @@ require('../chunk-4EFNS2HV.cjs');
 
 
 
-var _chunkZ2UQYMPScjs = require('../chunk-Z2UQYMPS.cjs');
+var _chunkNJGFSOPPcjs = require('../chunk-NJGFSOPP.cjs');
 
 
 
@@ -63,7 +63,7 @@ var _chunkAMX23CSNcjs = require('../chunk-AMX23CSN.cjs');
 
 
 
-var _chunkGMWNBSBScjs = require('../chunk-GMWNBSBS.cjs');
+var _chunk5EMS4BZGcjs = require('../chunk-5EMS4BZG.cjs');
 
 
 
@@ -601,7 +601,7 @@ function planCanvasPlaybackSteps(steps, nodes, rectOptions) {
           const node = placed.get(id);
           if (node) placed.set(id, { ...node, position });
         }
-        const rect = _chunkGMWNBSBScjs.unionRects.call(void 0, moved.map(([id]) => rectOf(id)));
+        const rect = _chunk5EMS4BZGcjs.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;
       }
@@ -2271,4 +2271,4 @@ function createCanvasComponentToolProvider(controller, options = { id: "canvas-c
 
 
 
-exports.AgentPlayback = _chunkGMWNBSBScjs.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 = _chunkAMX23CSNcjs.JSON_RPC_ERRORS; exports.MCP_PROTOCOL_VERSIONS = _chunkAMX23CSNcjs.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 = _chunkSWTUM32Hcjs.PRESENCE_COLORS; exports.PerformanceQueue = _chunkSWTUM32Hcjs.PerformanceQueue; exports.PresenceStore = _chunkSWTUM32Hcjs.PresenceStore; exports.TOOL_BRIDGE_DEFAULT_PORT = _chunkAMX23CSNcjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkAMX23CSNcjs.TOOL_BRIDGE_PROTOCOL; exports.TOOL_DISCOVERY_TOOLS = _chunkAMX23CSNcjs.TOOL_DISCOVERY_TOOLS; exports.TOOL_NAMESPACE_SEPARATOR = _chunkAMX23CSNcjs.TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = _chunkAMX23CSNcjs.ToolRegistry; exports.ToolRegistryError = _chunkAMX23CSNcjs.ToolRegistryError; exports.ToolRegistryView = _chunkAMX23CSNcjs.ToolRegistryView; exports.UNSAFE_JSON_KEYS = _chunk2BSBFBOAcjs.UNSAFE_JSON_KEYS; exports.baseToolName = _chunkAMX23CSNcjs.baseToolName; exports.captureInputSchema = _chunkN2FGYZ4Qcjs.captureInputSchema; exports.captureOutputSize = _chunkN2FGYZ4Qcjs.captureOutputSize; exports.cloneElementWithStyles = _chunkSVFEVKLFcjs.cloneElementWithStyles; exports.connectToolBridge = _chunkAMX23CSNcjs.connectToolBridge; exports.createAgentPlayback = _chunkGMWNBSBScjs.createAgentPlayback; exports.createCanvasComponentToolProvider = createCanvasComponentToolProvider; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createDocumentChartTools = createDocumentChartTools; exports.createEditorMcpToolProvider = createEditorMcpToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createInstantPresenceClock = _chunkSWTUM32Hcjs.createInstantPresenceClock; exports.createMcpServer = _chunkAMX23CSNcjs.createMcpServer; exports.createPlaybackToolProvider = _chunkGMWNBSBScjs.createPlaybackToolProvider; exports.createRichTextToolProvider = createRichTextToolProvider; exports.createSpreadsheetToolProvider = createSpreadsheetToolProvider; exports.createStyleResolver = _chunkZ2UQYMPScjs.createStyleResolver; exports.createStyleToolProvider = _chunkZ2UQYMPScjs.createStyleToolProvider; exports.createToolRegistry = _chunkAMX23CSNcjs.createToolRegistry; exports.derivePlaybackSteps = _chunkGMWNBSBScjs.derivePlaybackSteps; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkAMX23CSNcjs.errorResult; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkills = _chunkAMX23CSNcjs.listSkills; exports.locatePlaybackChrome = _chunkGMWNBSBScjs.locatePlaybackChrome; exports.memoryStyleStore = _chunkZ2UQYMPScjs.memoryStyleStore; exports.normalizeSide = normalizeSide; exports.parseSkillFrontmatter = _chunkAMX23CSNcjs.parseSkillFrontmatter; exports.parseStyleDomains = _chunkZ2UQYMPScjs.parseStyleDomains; exports.planAgentCommand = planAgentCommand; exports.planCanvasPlaybackSteps = planCanvasPlaybackSteps; exports.planCanvasToolPlayback = planCanvasToolPlayback; exports.planToolCall = planToolCall; exports.playbackRectFromClient = _chunkGMWNBSBScjs.playbackRectFromClient; exports.playbackRefsFromArgs = _chunkGMWNBSBScjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunkGMWNBSBScjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkAMX23CSNcjs.readSkillFile; exports.readingTime = _chunkGMWNBSBScjs.readingTime; exports.realPresenceClock = _chunkSWTUM32Hcjs.realPresenceClock; exports.renderStyle = _chunkZ2UQYMPScjs.renderStyle; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.runStyleChecks = _chunkZ2UQYMPScjs.runStyleChecks; exports.runToolScript = _chunkZ2UQYMPScjs.runToolScript; exports.searchTokens = _chunkAMX23CSNcjs.searchTokens; exports.searchTools = _chunkAMX23CSNcjs.searchTools; exports.stripPrototypeKeys = _chunk2BSBFBOAcjs.stripPrototypeKeys; exports.summarize = _chunkAMX23CSNcjs.summarize; exports.toCapturedImageData = _chunkN2FGYZ4Qcjs.toCapturedImageData; exports.toToolResult = _chunkAMX23CSNcjs.toToolResult; exports.toolCallToAgentCommand = toolCallToAgentCommand; exports.toolResultError = _chunkZ2UQYMPScjs.toolResultError; exports.toolResultValue = _chunkZ2UQYMPScjs.toolResultValue; exports.toolsetInstructions = _chunkAMX23CSNcjs.toolsetInstructions; exports.toolsetName = _chunkAMX23CSNcjs.toolsetName; exports.trackPresenceDrag = _chunkSWTUM32Hcjs.trackPresenceDrag; exports.tweenPresenceCursor = _chunkSWTUM32Hcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunkGMWNBSBScjs.unionRects; exports.unknownToolMessage = _chunkAMX23CSNcjs.unknownToolMessage; exports.validateAgentCommand = validateAgentCommand; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;
+exports.AgentPlayback = _chunk5EMS4BZGcjs.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 = _chunkAMX23CSNcjs.JSON_RPC_ERRORS; exports.MCP_PROTOCOL_VERSIONS = _chunkAMX23CSNcjs.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 = _chunkSWTUM32Hcjs.PRESENCE_COLORS; exports.PerformanceQueue = _chunkSWTUM32Hcjs.PerformanceQueue; exports.PresenceStore = _chunkSWTUM32Hcjs.PresenceStore; exports.TOOL_BRIDGE_DEFAULT_PORT = _chunkAMX23CSNcjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkAMX23CSNcjs.TOOL_BRIDGE_PROTOCOL; exports.TOOL_DISCOVERY_TOOLS = _chunkAMX23CSNcjs.TOOL_DISCOVERY_TOOLS; exports.TOOL_NAMESPACE_SEPARATOR = _chunkAMX23CSNcjs.TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = _chunkAMX23CSNcjs.ToolRegistry; exports.ToolRegistryError = _chunkAMX23CSNcjs.ToolRegistryError; exports.ToolRegistryView = _chunkAMX23CSNcjs.ToolRegistryView; exports.UNSAFE_JSON_KEYS = _chunk2BSBFBOAcjs.UNSAFE_JSON_KEYS; exports.baseToolName = _chunkAMX23CSNcjs.baseToolName; exports.captureInputSchema = _chunkN2FGYZ4Qcjs.captureInputSchema; exports.captureOutputSize = _chunkN2FGYZ4Qcjs.captureOutputSize; exports.cloneElementWithStyles = _chunkSVFEVKLFcjs.cloneElementWithStyles; exports.connectToolBridge = _chunkAMX23CSNcjs.connectToolBridge; exports.createAgentPlayback = _chunk5EMS4BZGcjs.createAgentPlayback; exports.createCanvasComponentToolProvider = createCanvasComponentToolProvider; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createDocumentChartTools = createDocumentChartTools; exports.createEditorMcpToolProvider = createEditorMcpToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createInstantPresenceClock = _chunkSWTUM32Hcjs.createInstantPresenceClock; exports.createMcpServer = _chunkAMX23CSNcjs.createMcpServer; exports.createPlaybackToolProvider = _chunk5EMS4BZGcjs.createPlaybackToolProvider; exports.createRichTextToolProvider = createRichTextToolProvider; exports.createSpreadsheetToolProvider = createSpreadsheetToolProvider; exports.createStyleResolver = _chunkNJGFSOPPcjs.createStyleResolver; exports.createStyleToolProvider = _chunkNJGFSOPPcjs.createStyleToolProvider; exports.createToolRegistry = _chunkAMX23CSNcjs.createToolRegistry; exports.derivePlaybackSteps = _chunk5EMS4BZGcjs.derivePlaybackSteps; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkAMX23CSNcjs.errorResult; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkills = _chunkAMX23CSNcjs.listSkills; exports.locatePlaybackChrome = _chunk5EMS4BZGcjs.locatePlaybackChrome; exports.memoryStyleStore = _chunkNJGFSOPPcjs.memoryStyleStore; exports.normalizeSide = normalizeSide; exports.parseSkillFrontmatter = _chunkAMX23CSNcjs.parseSkillFrontmatter; exports.parseStyleDomains = _chunkNJGFSOPPcjs.parseStyleDomains; exports.planAgentCommand = planAgentCommand; exports.planCanvasPlaybackSteps = planCanvasPlaybackSteps; exports.planCanvasToolPlayback = planCanvasToolPlayback; exports.planToolCall = planToolCall; exports.playbackRectFromClient = _chunk5EMS4BZGcjs.playbackRectFromClient; exports.playbackRefsFromArgs = _chunk5EMS4BZGcjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunk5EMS4BZGcjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkAMX23CSNcjs.readSkillFile; exports.readingTime = _chunk5EMS4BZGcjs.readingTime; exports.realPresenceClock = _chunkSWTUM32Hcjs.realPresenceClock; exports.renderStyle = _chunkNJGFSOPPcjs.renderStyle; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.runStyleChecks = _chunkNJGFSOPPcjs.runStyleChecks; exports.runToolScript = _chunkNJGFSOPPcjs.runToolScript; exports.searchTokens = _chunkAMX23CSNcjs.searchTokens; exports.searchTools = _chunkAMX23CSNcjs.searchTools; exports.stripPrototypeKeys = _chunk2BSBFBOAcjs.stripPrototypeKeys; exports.summarize = _chunkAMX23CSNcjs.summarize; exports.toCapturedImageData = _chunkN2FGYZ4Qcjs.toCapturedImageData; exports.toToolResult = _chunkAMX23CSNcjs.toToolResult; exports.toolCallToAgentCommand = toolCallToAgentCommand; exports.toolResultError = _chunkNJGFSOPPcjs.toolResultError; exports.toolResultValue = _chunkNJGFSOPPcjs.toolResultValue; exports.toolsetInstructions = _chunkAMX23CSNcjs.toolsetInstructions; exports.toolsetName = _chunkAMX23CSNcjs.toolsetName; exports.trackPresenceDrag = _chunkSWTUM32Hcjs.trackPresenceDrag; exports.tweenPresenceCursor = _chunkSWTUM32Hcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunk5EMS4BZGcjs.unionRects; exports.unknownToolMessage = _chunkAMX23CSNcjs.unknownToolMessage; exports.validateAgentCommand = validateAgentCommand; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;

package/dist/agent/index.js

@@ -25,7 +25,7 @@ import {
   runToolScript,
   toolResultError,
   toolResultValue
-} from "../chunk-HIDFL5LQ.js";
+} from "../chunk-ZXTO6U7T.js";
 import {
   JSON_RPC_ERRORS,
   MCP_PROTOCOL_VERSIONS,
@@ -63,7 +63,7 @@ import {
   playbackRefsFromResult,
   readingTime,
   unionRects
-} from "../chunk-6DXDUVSL.js";
+} from "../chunk-WL4IN36A.js";
 import {
   CAPTURE_EXCLUDE_SELECTOR,
   CAPTURE_OVERLAY_SELECTORS,

package/dist/{chunk-GMWNBSBS.cjs → chunk-5EMS4BZG.cjs}

@@ -102,7 +102,31 @@ function normalizePlan(plan) {
 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 });
 var finiteRect = (r) => r && [r.x, r.y, r.width, r.height].every(Number.isFinite) ? r : null;
-var GLANCE_STEPS = /* @__PURE__ */ new Set(["move", "target", "focus", "say", "wait", "commit"]);
+var GLANCE_STEPS = /* @__PURE__ */ new Set(["move", "target", "focus", "say", "wait", "commit", "stage"]);
+function createStageGate() {
+  let credits = 0;
+  let opened = false;
+  const waiting = [];
+  return {
+    wait: () => {
+      if (opened) return Promise.resolve();
+      if (credits > 0) {
+        credits--;
+        return Promise.resolve();
+      }
+      return new Promise((resolve) => waiting.push(resolve));
+    },
+    release() {
+      const next = waiting.shift();
+      if (next) next();
+      else credits++;
+    },
+    open() {
+      opened = true;
+      waiting.splice(0).forEach((resolve) => resolve());
+    }
+  };
+}
 var AgentPlayback = (_class = class {
   /** 1 = natural pace; `Infinity` plays nothing (calls run instantly). Takes effect on the next step. */
   
@@ -268,13 +292,25 @@ var AgentPlayback = (_class = class {
       if (!readOnly) _optionalChain([surface, 'access', _36 => _36.beginGesture, 'optionalCall', _37 => _37(`agent:${id}:${++this.calls}`)]);
       let result;
       let committed = false;
+      const gate = run.steps.some((s) => s.type === "stage") ? createStageGate() : null;
+      if (gate) call.context.stage = gate.wait;
+      let pending = null;
       try {
         for (const step of run.steps) {
           record(step);
           if (step.type === "commit") {
             if (committed) continue;
             committed = true;
-            result = await next();
+            if (gate) {
+              pending = next();
+              pending.catch(() => {
+              });
+            } else result = await next();
+            continue;
+          }
+          if (step.type === "stage") {
+            _optionalChain([gate, 'optionalAccess', _38 => _38.release, 'call', _39 => _39()]);
+            await wait(120);
             continue;
           }
           if (step.type === "open") {
@@ -294,18 +330,23 @@ var AgentPlayback = (_class = class {
         }
         if (!committed) {
           record({ type: "commit" });
-          result = await next();
+          pending = next();
+        }
+        if (pending) {
+          _optionalChain([gate, 'optionalAccess', _40 => _40.open, 'call', _41 => _41()]);
+          result = await pending;
         }
       } catch (error) {
+        _optionalChain([gate, 'optionalAccess', _42 => _42.open, 'call', _43 => _43()]);
         presence.set({ id, pressed: false, message: `\u2717 ${error instanceof Error ? error.message : String(error)}`.slice(0, 140) });
         await wait(900);
         throw error;
       } finally {
-        if (!readOnly) _optionalChain([surface, 'access', _38 => _38.endGesture, 'optionalCall', _39 => _39()]);
+        if (!readOnly) _optionalChain([surface, 'access', _44 => _44.endGesture, 'optionalCall', _45 => _45()]);
         presence.set({ id, pressed: false });
       }
       if (isErrorResult(result)) {
-        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."));
+        const text = _nullishCoalesce(_optionalChain([result, 'access', _46 => _46.content, 'optionalAccess', _47 => _47.find, 'call', _48 => _48((c) => c.type === "text"), 'optionalAccess', _49 => _49.text]), () => ( "The tool failed."));
         presence.set({ id, message: `\u2717 ${text}`.slice(0, 140) });
         await wait(900);
       } else if (!readOnly) {

package/dist/{chunk-6DM3PUQD.cjs → chunk-CYKWYP6D.cjs}

@@ -192,9 +192,11 @@ async function createEffectAuthoringSession(source, options) {
   let playing = false;
   let cancelSchedule = null;
   let lastScheduleTime = null;
-  let playheadTime = 0;
   let duration = _nullishCoalesce(_nullishCoalesce(_optionalChain([initialDoc, 'optionalAccess', _ => _.duration]), () => ( description.duration)), () => ( 1e3));
   if (!(duration > 0)) duration = 1e3;
+  const start = options.startTime;
+  let playheadTime = typeof start === "number" && Number.isFinite(start) ? Math.max(0, Math.min(duration, start)) : duration / 2;
+  let previewError = null;
   let loop = _nullishCoalesce(_nullishCoalesce(_optionalChain([initialDoc, 'optionalAccess', _2 => _2.loop]), () => ( description.loop)), () => ( false));
   let compiled = null;
   let savedPresets = initialDoc ? [..._nullishCoalesce(initialDoc.presets, () => ( []))] : [];
@@ -258,6 +260,7 @@ async function createEffectAuthoringSession(source, options) {
       tracks: { ...tracks },
       issues: [],
       compiled,
+      previewError,
       time: playheadTime,
       duration,
       loop,
@@ -704,8 +707,23 @@ async function createEffectAuthoringSession(source, options) {
       if (disposed) {
         throw new (0, _chunkRUZQMYXHcjs.EffectDisposedError)(effectId);
       }
-      const renderer = await provider.createRenderer(effectId, opts);
+      let renderer;
+      try {
+        renderer = await provider.createRenderer(effectId, opts);
+      } catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        const reason = description.kind === "vector" ? `No pixel preview for this vector effect: ${message}` : `No pixel preview: ${message}`;
+        if (previewError !== reason) {
+          previewError = reason;
+          invalidateState();
+        }
+        throw e;
+      }
       livePreviews.add(renderer);
+      if (previewError !== null) {
+        previewError = null;
+        invalidateState();
+      }
       const preview = {
         effectId: renderer.effectId,
         width: renderer.width,

package/dist/{chunk-ZGOHKS3X.js → chunk-HCC2LBCW.js}

@@ -192,9 +192,11 @@ async function createEffectAuthoringSession(source, options) {
   let playing = false;
   let cancelSchedule = null;
   let lastScheduleTime = null;
-  let playheadTime = 0;
   let duration = initialDoc?.duration ?? description.duration ?? 1e3;
   if (!(duration > 0)) duration = 1e3;
+  const start = options.startTime;
+  let playheadTime = typeof start === "number" && Number.isFinite(start) ? Math.max(0, Math.min(duration, start)) : duration / 2;
+  let previewError = null;
   let loop = initialDoc?.loop ?? description.loop ?? false;
   let compiled = null;
   let savedPresets = initialDoc ? [...initialDoc.presets ?? []] : [];
@@ -258,6 +260,7 @@ async function createEffectAuthoringSession(source, options) {
       tracks: { ...tracks },
       issues: [],
       compiled,
+      previewError,
       time: playheadTime,
       duration,
       loop,
@@ -704,8 +707,23 @@ async function createEffectAuthoringSession(source, options) {
       if (disposed) {
         throw new EffectDisposedError(effectId);
       }
-      const renderer = await provider.createRenderer(effectId, opts);
+      let renderer;
+      try {
+        renderer = await provider.createRenderer(effectId, opts);
+      } catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        const reason = description.kind === "vector" ? `No pixel preview for this vector effect: ${message}` : `No pixel preview: ${message}`;
+        if (previewError !== reason) {
+          previewError = reason;
+          invalidateState();
+        }
+        throw e;
+      }
       livePreviews.add(renderer);
+      if (previewError !== null) {
+        previewError = null;
+        invalidateState();
+      }
       const preview = {
         effectId: renderer.effectId,
         width: renderer.width,

package/dist/{chunk-Z2UQYMPS.cjs → chunk-NJGFSOPP.cjs}

@@ -3,7 +3,7 @@
 var _chunkAMX23CSNcjs = require('./chunk-AMX23CSN.cjs');
 
 
-var _chunkGMWNBSBScjs = require('./chunk-GMWNBSBS.cjs');
+var _chunk5EMS4BZGcjs = require('./chunk-5EMS4BZG.cjs');
 
 
 var _chunkWOFXZ3XUcjs = require('./chunk-WOFXZ3XU.cjs');
@@ -46,7 +46,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(_chunkGMWNBSBScjs.readingTime.call(void 0, step.say));
+      await pause(_chunk5EMS4BZGcjs.readingTime.call(void 0, step.say));
     }
     if (!step.tool) continue;
     if (control.stopped) return finish(false);

package/dist/{chunk-6DXDUVSL.js → chunk-WL4IN36A.js}

@@ -102,7 +102,31 @@ function normalizePlan(plan) {
 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 });
 var finiteRect = (r) => r && [r.x, r.y, r.width, r.height].every(Number.isFinite) ? r : null;
-var GLANCE_STEPS = /* @__PURE__ */ new Set(["move", "target", "focus", "say", "wait", "commit"]);
+var GLANCE_STEPS = /* @__PURE__ */ new Set(["move", "target", "focus", "say", "wait", "commit", "stage"]);
+function createStageGate() {
+  let credits = 0;
+  let opened = false;
+  const waiting = [];
+  return {
+    wait: () => {
+      if (opened) return Promise.resolve();
+      if (credits > 0) {
+        credits--;
+        return Promise.resolve();
+      }
+      return new Promise((resolve) => waiting.push(resolve));
+    },
+    release() {
+      const next = waiting.shift();
+      if (next) next();
+      else credits++;
+    },
+    open() {
+      opened = true;
+      waiting.splice(0).forEach((resolve) => resolve());
+    }
+  };
+}
 var AgentPlayback = class {
   /** 1 = natural pace; `Infinity` plays nothing (calls run instantly). Takes effect on the next step. */
   speed;
@@ -268,13 +292,25 @@ var AgentPlayback = class {
       if (!readOnly) surface.beginGesture?.(`agent:${id}:${++this.calls}`);
       let result;
       let committed = false;
+      const gate = run.steps.some((s) => s.type === "stage") ? createStageGate() : null;
+      if (gate) call.context.stage = gate.wait;
+      let pending = null;
       try {
         for (const step of run.steps) {
           record(step);
           if (step.type === "commit") {
             if (committed) continue;
             committed = true;
-            result = await next();
+            if (gate) {
+              pending = next();
+              pending.catch(() => {
+              });
+            } else result = await next();
+            continue;
+          }
+          if (step.type === "stage") {
+            gate?.release();
+            await wait(120);
             continue;
           }
           if (step.type === "open") {
@@ -294,9 +330,14 @@ var AgentPlayback = class {
         }
         if (!committed) {
           record({ type: "commit" });
-          result = await next();
+          pending = next();
+        }
+        if (pending) {
+          gate?.open();
+          result = await pending;
         }
       } catch (error) {
+        gate?.open();
         presence.set({ id, pressed: false, message: `\u2717 ${error instanceof Error ? error.message : String(error)}`.slice(0, 140) });
         await wait(900);
         throw error;

package/dist/{chunk-HIDFL5LQ.js → chunk-ZXTO6U7T.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-XZB3TJ6K.js";
 import {
   readingTime
-} from "./chunk-6DXDUVSL.js";
+} from "./chunk-WL4IN36A.js";
 import {
   validateJsonSchema
 } from "./chunk-V2ZCJRDM.js";

package/dist/commands/index.cjs

@@ -29,7 +29,7 @@ var _chunkGLQQ2VILcjs = require('../chunk-GLQQ2VIL.cjs');
 var _chunk4EFNS2HVcjs = require('../chunk-4EFNS2HV.cjs');
 
 
-var _chunkGMWNBSBScjs = require('../chunk-GMWNBSBS.cjs');
+var _chunk5EMS4BZGcjs = require('../chunk-5EMS4BZG.cjs');
 require('../chunk-SWTUM32H.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 : _chunkGMWNBSBScjs.derivePlaybackSteps.call(void 0, params);
+    const steps = own.length ? own : _chunk5EMS4BZGcjs.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-6DXDUVSL.js";
+} from "../chunk-WL4IN36A.js";
 import "../chunk-O2ANJFUF.js";
 import {
   validateJsonSchema

package/dist/effects/authoring-session.d.cts

@@ -17,6 +17,11 @@ export interface GenericAuthoringOptions {
     schedule?: (frame: (now: number) => void) => () => void;
     /** Ms within which `setValue` calls on one control with no gesture merge (default 400). */
     mergeWindowMs?: number;
+    /**
+     * Where the playhead starts (ms, clamped to 0..duration). Default: half the duration, as
+     * catalog thumbnails do, so entrance-style effects and transitions open on a frame that shows them.
+     */
+    startTime?: number;
 }
 /**
  * Creates an effect authoring session with values, presets, keyframes, timing and undo

package/dist/effects/authoring-session.d.ts

@@ -17,6 +17,11 @@ export interface GenericAuthoringOptions {
     schedule?: (frame: (now: number) => void) => () => void;
     /** Ms within which `setValue` calls on one control with no gesture merge (default 400). */
     mergeWindowMs?: number;
+    /**
+     * Where the playhead starts (ms, clamped to 0..duration). Default: half the duration, as
+     * catalog thumbnails do, so entrance-style effects and transitions open on a frame that shows them.
+     */
+    startTime?: number;
 }
 /**
  * Creates an effect authoring session with values, presets, keyframes, timing and undo

package/dist/effects/authoring.d.cts

@@ -65,6 +65,12 @@ export interface EffectAuthoringState {
     issues: readonly EffectAuthoringIssue[];
     /** Whether the source compiled: true, false, or null when that is not known yet (no preview has compiled it). */
     compiled: boolean | null;
+    /**
+     * Why `createPreview` could not make a pixel preview (for example a vector effect whose provider
+     * only draws it as SVG), or null when it could or has not been asked yet. Optional for sessions
+     * that never fail to preview.
+     */
+    previewError?: string | null;
     /** Current playhead position (ms). */
     time: number;
     /** Length of one play (ms). */

package/dist/effects/authoring.d.ts

@@ -65,6 +65,12 @@ export interface EffectAuthoringState {
     issues: readonly EffectAuthoringIssue[];
     /** Whether the source compiled: true, false, or null when that is not known yet (no preview has compiled it). */
     compiled: boolean | null;
+    /**
+     * Why `createPreview` could not make a pixel preview (for example a vector effect whose provider
+     * only draws it as SVG), or null when it could or has not been asked yet. Optional for sessions
+     * that never fail to preview.
+     */
+    previewError?: string | null;
     /** Current playhead position (ms). */
     time: number;
     /** Length of one play (ms). */

package/dist/effects/index.cjs

@@ -3,7 +3,7 @@
 var _chunkFKUKJ3XAcjs = require('../chunk-FKUKJ3XA.cjs');
 
 
-var _chunk6DM3PUQDcjs = require('../chunk-6DM3PUQD.cjs');
+var _chunkCYKWYP6Dcjs = require('../chunk-CYKWYP6D.cjs');
 
 
 var _chunkPY4GWSE2cjs = require('../chunk-PY4GWSE2.cjs');
@@ -568,7 +568,7 @@ function createFakeEffectProvider(options = {}) {
       };
     },
     ...supportsAuthoring ? {
-      openAuthoring: (from) => _chunk6DM3PUQDcjs.createEffectAuthoringSession.call(void 0, from, { provider })
+      openAuthoring: (from) => _chunkCYKWYP6Dcjs.createEffectAuthoringSession.call(void 0, from, { provider })
     } : {}
   };
   return provider;
@@ -738,7 +738,7 @@ function createEffectAuthoringToolProvider(host, options) {
   const describeTool = {
     name: "effect_authoring_describe",
     title: "Describe open effect",
-    description: "Describes the effect currently open for authoring: name, kind, source language, controls schema and current values, presets, animated tracks with keyframe counts, duration, loop, and compile issues.",
+    description: "Describes the effect currently open for authoring: name, kind, source language, controls schema and current values, presets, animated tracks with keyframe counts, playhead time, duration, loop, compile issues, and previewError: why there is no pixel preview (e.g. a vector effect the provider only draws as SVG), or null.",
     inputSchema: object({}),
     annotations: { title: "Describe open effect", ...ANNOTATIONS.read },
     handler: () => {
@@ -755,9 +755,11 @@ function createEffectAuthoringToolProvider(host, options) {
           control,
           keyframes: track.length
         })),
+        time: state.time,
         duration: state.duration,
         loop: state.loop,
-        issues: state.issues
+        issues: state.issues,
+        previewError: _nullishCoalesce(state.previewError, () => ( null))
       };
     }
   };
@@ -1013,7 +1015,7 @@ function createEffectAuthoringToolProvider(host, options) {
   const viewTool = {
     name: "effect_authoring_view",
     title: "View effect preview image",
-    description: "Captures an image of the effect preview at the current playhead time or at a specified time in milliseconds.",
+    description: "Captures an image of the effect preview at the current playhead time or at a specified time in milliseconds. Refused, with the reason, when the effect has no pixel preview (see previewError in effect_authoring_describe).",
     inputSchema: object({
       time: { type: "number", minimum: 0, description: "Optional time in milliseconds to view the preview at. Moves playhead to this time before capturing." }
     }),
@@ -1021,6 +1023,10 @@ function createEffectAuthoringToolProvider(host, options) {
     handler: async (args) => {
       const session = requireSession();
       if (!host.capture) throw new Error("Capturing a preview image is not supported by this host.");
+      const previewError = session.getState().previewError;
+      if (previewError) {
+        throw new Error(`${previewError} The other effect authoring tools still work; check values with effect_authoring_describe.`);
+      }
       if (args.time !== void 0) {
         if (typeof args.time !== "number" || !Number.isFinite(args.time) || args.time < 0) {
           throw new Error("time must be a finite non-negative number.");
@@ -1107,4 +1113,4 @@ function createEffectAuthoringToolProvider(host, options) {
 
 
 
-exports.EFFECT_ERROR_CODES = _chunkRUZQMYXHcjs.EFFECT_ERROR_CODES; exports.EFFECT_KINDS = _chunkRUZQMYXHcjs.EFFECT_KINDS; exports.EFFECT_USES = _chunkRUZQMYXHcjs.EFFECT_USES; exports.EFFECT_USE_LABELS = EFFECT_USE_LABELS; exports.EffectControlError = _chunkRUZQMYXHcjs.EffectControlError; exports.EffectDisposedError = _chunkRUZQMYXHcjs.EffectDisposedError; exports.EffectError = _chunkRUZQMYXHcjs.EffectError; exports.EffectRendererPool = _chunkPY4GWSE2cjs.EffectRendererPool; exports.EffectUnsupportedError = _chunkRUZQMYXHcjs.EffectUnsupportedError; exports.EffectsSlot = _chunkRUZQMYXHcjs.EffectsSlot; exports.NoEffectsProviderError = _chunkRUZQMYXHcjs.NoEffectsProviderError; exports.UnknownEffectError = _chunkRUZQMYXHcjs.UnknownEffectError; exports.applyEffectMask = _chunkRUZQMYXHcjs.applyEffectMask; exports.checkEffectProvider = checkEffectProvider; exports.createEffectAuthoringSession = _chunk6DM3PUQDcjs.createEffectAuthoringSession; exports.createEffectAuthoringToolProvider = createEffectAuthoringToolProvider; exports.createEffectPixels = _chunkRUZQMYXHcjs.createEffectPixels; exports.createEffectToolProvider = _chunkRUZQMYXHcjs.createEffectToolProvider; exports.createFakeEffectProvider = createFakeEffectProvider; exports.effectControlField = effectControlField; exports.effectFieldValue = effectFieldValue; exports.effectFontFamilies = effectFontFamilies; exports.effectParameterFields = effectParameterFields; exports.effectSampleInputs = effectSampleInputs; exports.effectSamplePicture = effectSamplePicture; exports.effectValueErrors = _chunkRUZQMYXHcjs.effectValueErrors; exports.encodeEffectFloat = _chunkRUZQMYXHcjs.encodeEffectFloat; exports.groupEffectsByCategory = groupEffectsByCategory; exports.isEffectError = _chunkRUZQMYXHcjs.isEffectError; exports.isEffectFontControl = isEffectFontControl; exports.isEffectPixels = _chunkRUZQMYXHcjs.isEffectPixels; exports.linearToSrgb = _chunkRUZQMYXHcjs.linearToSrgb; exports.renderEffectThumbnail = renderEffectThumbnail; exports.resolveEffectValues = _chunkRUZQMYXHcjs.resolveEffectValues; exports.searchEffectSummaries = _chunkRUZQMYXHcjs.searchEffectSummaries; exports.srgbToLinear = _chunkRUZQMYXHcjs.srgbToLinear;
+exports.EFFECT_ERROR_CODES = _chunkRUZQMYXHcjs.EFFECT_ERROR_CODES; exports.EFFECT_KINDS = _chunkRUZQMYXHcjs.EFFECT_KINDS; exports.EFFECT_USES = _chunkRUZQMYXHcjs.EFFECT_USES; exports.EFFECT_USE_LABELS = EFFECT_USE_LABELS; exports.EffectControlError = _chunkRUZQMYXHcjs.EffectControlError; exports.EffectDisposedError = _chunkRUZQMYXHcjs.EffectDisposedError; exports.EffectError = _chunkRUZQMYXHcjs.EffectError; exports.EffectRendererPool = _chunkPY4GWSE2cjs.EffectRendererPool; exports.EffectUnsupportedError = _chunkRUZQMYXHcjs.EffectUnsupportedError; exports.EffectsSlot = _chunkRUZQMYXHcjs.EffectsSlot; exports.NoEffectsProviderError = _chunkRUZQMYXHcjs.NoEffectsProviderError; exports.UnknownEffectError = _chunkRUZQMYXHcjs.UnknownEffectError; exports.applyEffectMask = _chunkRUZQMYXHcjs.applyEffectMask; exports.checkEffectProvider = checkEffectProvider; exports.createEffectAuthoringSession = _chunkCYKWYP6Dcjs.createEffectAuthoringSession; exports.createEffectAuthoringToolProvider = createEffectAuthoringToolProvider; exports.createEffectPixels = _chunkRUZQMYXHcjs.createEffectPixels; exports.createEffectToolProvider = _chunkRUZQMYXHcjs.createEffectToolProvider; exports.createFakeEffectProvider = createFakeEffectProvider; exports.effectControlField = effectControlField; exports.effectFieldValue = effectFieldValue; exports.effectFontFamilies = effectFontFamilies; exports.effectParameterFields = effectParameterFields; exports.effectSampleInputs = effectSampleInputs; exports.effectSamplePicture = effectSamplePicture; exports.effectValueErrors = _chunkRUZQMYXHcjs.effectValueErrors; exports.encodeEffectFloat = _chunkRUZQMYXHcjs.encodeEffectFloat; exports.groupEffectsByCategory = groupEffectsByCategory; exports.isEffectError = _chunkRUZQMYXHcjs.isEffectError; exports.isEffectFontControl = isEffectFontControl; exports.isEffectPixels = _chunkRUZQMYXHcjs.isEffectPixels; exports.linearToSrgb = _chunkRUZQMYXHcjs.linearToSrgb; exports.renderEffectThumbnail = renderEffectThumbnail; exports.resolveEffectValues = _chunkRUZQMYXHcjs.resolveEffectValues; exports.searchEffectSummaries = _chunkRUZQMYXHcjs.searchEffectSummaries; exports.srgbToLinear = _chunkRUZQMYXHcjs.srgbToLinear;

package/dist/effects/index.js

@@ -3,7 +3,7 @@ import {
 } from "../chunk-CJE5MOIS.js";
 import {
   createEffectAuthoringSession
-} from "../chunk-ZGOHKS3X.js";
+} from "../chunk-HCC2LBCW.js";
 import {
   EffectRendererPool
 } from "../chunk-EHLOCVWB.js";
@@ -738,7 +738,7 @@ function createEffectAuthoringToolProvider(host, options) {
   const describeTool = {
     name: "effect_authoring_describe",
     title: "Describe open effect",
-    description: "Describes the effect currently open for authoring: name, kind, source language, controls schema and current values, presets, animated tracks with keyframe counts, duration, loop, and compile issues.",
+    description: "Describes the effect currently open for authoring: name, kind, source language, controls schema and current values, presets, animated tracks with keyframe counts, playhead time, duration, loop, compile issues, and previewError: why there is no pixel preview (e.g. a vector effect the provider only draws as SVG), or null.",
     inputSchema: object({}),
     annotations: { title: "Describe open effect", ...ANNOTATIONS.read },
     handler: () => {
@@ -755,9 +755,11 @@ function createEffectAuthoringToolProvider(host, options) {
           control,
           keyframes: track.length
         })),
+        time: state.time,
         duration: state.duration,
         loop: state.loop,
-        issues: state.issues
+        issues: state.issues,
+        previewError: state.previewError ?? null
       };
     }
   };
@@ -1013,7 +1015,7 @@ function createEffectAuthoringToolProvider(host, options) {
   const viewTool = {
     name: "effect_authoring_view",
     title: "View effect preview image",
-    description: "Captures an image of the effect preview at the current playhead time or at a specified time in milliseconds.",
+    description: "Captures an image of the effect preview at the current playhead time or at a specified time in milliseconds. Refused, with the reason, when the effect has no pixel preview (see previewError in effect_authoring_describe).",
     inputSchema: object({
       time: { type: "number", minimum: 0, description: "Optional time in milliseconds to view the preview at. Moves playhead to this time before capturing." }
     }),
@@ -1021,6 +1023,10 @@ function createEffectAuthoringToolProvider(host, options) {
     handler: async (args) => {
       const session = requireSession();
       if (!host.capture) throw new Error("Capturing a preview image is not supported by this host.");
+      const previewError = session.getState().previewError;
+      if (previewError) {
+        throw new Error(`${previewError} The other effect authoring tools still work; check values with effect_authoring_describe.`);
+      }
       if (args.time !== void 0) {
         if (typeof args.time !== "number" || !Number.isFinite(args.time) || args.time < 0) {
           throw new Error("time must be a finite non-negative number.");

package/dist/image-editor/index.cjs

@@ -1168,6 +1168,17 @@ var ImageCache = (_class = class {constructor() { _class.prototype.__init.call(t
   }
 }, _class);
 var globalImageCache = new ImageCache();
+var OVERLAY_HANDLE_EDGE = "#0284c7";
+function drawOverlayHandles(ctx, points) {
+  const size = 10;
+  ctx.fillStyle = "#ffffff";
+  ctx.strokeStyle = OVERLAY_HANDLE_EDGE;
+  ctx.lineWidth = 1.5;
+  for (const h of points) {
+    ctx.fillRect(h.x - size / 2, h.y - size / 2, size, size);
+    ctx.strokeRect(h.x - size / 2, h.y - size / 2, size, size);
+  }
+}
 var ImageEditorRenderer = (_class2 = class {constructor() { _class2.prototype.__init2.call(this);_class2.prototype.__init3.call(this);_class2.prototype.__init4.call(this);_class2.prototype.__init5.call(this);_class2.prototype.__init6.call(this);_class2.prototype.__init7.call(this);_class2.prototype.__init8.call(this);_class2.prototype.__init9.call(this);_class2.prototype.__init10.call(this);_class2.prototype.__init11.call(this);_class2.prototype.__init12.call(this);_class2.prototype.__init13.call(this);_class2.prototype.__init14.call(this);_class2.prototype.__init15.call(this);_class2.prototype.__init16.call(this);_class2.prototype.__init17.call(this);_class2.prototype.__init18.call(this);_class2.prototype.__init19.call(this);_class2.prototype.__init20.call(this);_class2.prototype.__init21.call(this);_class2.prototype.__init22.call(this); }
   __init2() {this.imageCache = globalImageCache}
   __init3() {this.cachedBaseCanvas = null}
@@ -1447,38 +1458,29 @@ var ImageEditorRenderer = (_class2 = class {constructor() { _class2.prototype.__
           outline.forEach((p, i) => i ? ctx.lineTo(p.x, p.y) : ctx.moveTo(p.x, p.y));
           ctx.closePath();
         }
-        ctx.lineWidth = 3;
-        ctx.strokeStyle = "rgba(0,0,0,0.5)";
+        ctx.lineWidth = 4;
+        ctx.strokeStyle = "rgba(0,0,0,0.25)";
         ctx.stroke();
-        ctx.lineWidth = 1;
+        ctx.lineWidth = 2;
         ctx.strokeStyle = "#ffffff";
         ctx.stroke();
-        for (const h of [...t.handles, ..._nullishCoalesce(_optionalChain([t, 'access', _25 => _25.warp, 'optionalAccess', _26 => _26.anchors]), () => ( []))].map(scr)) {
-          ctx.fillStyle = "#ffffff";
-          ctx.strokeStyle = "#1e293b";
-          ctx.fillRect(h.x - 4, h.y - 4, 8, 8);
-          ctx.strokeRect(h.x - 4, h.y - 4, 8, 8);
-        }
+        drawOverlayHandles(ctx, [...t.handles, ..._nullishCoalesce(_optionalChain([t, 'access', _25 => _25.warp, 'optionalAccess', _26 => _26.anchors]), () => ( []))].map(scr));
         for (const h of (_nullishCoalesce(_optionalChain([t, 'access', _27 => _27.warp, 'optionalAccess', _28 => _28.handles]), () => ( []))).map((w) => scr(w.point))) {
           ctx.beginPath();
-          ctx.arc(h.x, h.y, 3, 0, Math.PI * 2);
+          ctx.arc(h.x, h.y, 3.5, 0, Math.PI * 2);
           ctx.fillStyle = "#ffffff";
           ctx.fill();
-          ctx.strokeStyle = "#1e293b";
+          ctx.lineWidth = 1.5;
+          ctx.strokeStyle = OVERLAY_HANDLE_EDGE;
           ctx.stroke();
         }
         const r = scr(t.reference);
         ctx.beginPath();
-        ctx.arc(r.x, r.y, 5, 0, Math.PI * 2);
-        ctx.moveTo(r.x - 8, r.y);
-        ctx.lineTo(r.x + 8, r.y);
-        ctx.moveTo(r.x, r.y - 8);
-        ctx.lineTo(r.x, r.y + 8);
-        ctx.lineWidth = 3;
-        ctx.strokeStyle = "rgba(0,0,0,0.5)";
-        ctx.stroke();
-        ctx.lineWidth = 1;
-        ctx.strokeStyle = "#ffffff";
+        ctx.arc(r.x, r.y, 3.5, 0, Math.PI * 2);
+        ctx.fillStyle = "rgba(255,255,255,0.9)";
+        ctx.fill();
+        ctx.lineWidth = 1.5;
+        ctx.strokeStyle = OVERLAY_HANDLE_EDGE;
         ctx.stroke();
       } catch (e7) {
       }
@@ -2040,11 +2042,7 @@ var ImageEditorRenderer = (_class2 = class {constructor() { _class2.prototype.__
     ctx.moveTo(startX, startY + cropBoxH * 2 / 3);
     ctx.lineTo(startX + cropBoxW, startY + cropBoxH * 2 / 3);
     ctx.stroke();
-    ctx.fillStyle = "#ffffff";
-    ctx.strokeStyle = "#0284c7";
-    ctx.lineWidth = 1.5;
-    const handleSize = 10;
-    const handles = [
+    drawOverlayHandles(ctx, [
       // Corners
       { x: startX, y: startY },
       { x: startX + cropBoxW, y: startY },
@@ -2055,11 +2053,7 @@ var ImageEditorRenderer = (_class2 = class {constructor() { _class2.prototype.__
       { x: startX + cropBoxW / 2, y: startY + cropBoxH },
       { x: startX, y: startY + cropBoxH / 2 },
       { x: startX + cropBoxW, y: startY + cropBoxH / 2 }
-    ];
-    for (const h of handles) {
-      ctx.fillRect(h.x - handleSize / 2, h.y - handleSize / 2, handleSize, handleSize);
-      ctx.strokeRect(h.x - handleSize / 2, h.y - handleSize / 2, handleSize, handleSize);
-    }
+    ]);
     ctx.restore();
   }
   drawFittedImage(ctx, img, imgW, imgH, vpW, vpH, zoom, pan, fit = "margin") {

package/dist/image-editor/index.js

@@ -1168,6 +1168,17 @@ var ImageCache = class {
   }
 };
 var globalImageCache = new ImageCache();
+var OVERLAY_HANDLE_EDGE = "#0284c7";
+function drawOverlayHandles(ctx, points) {
+  const size = 10;
+  ctx.fillStyle = "#ffffff";
+  ctx.strokeStyle = OVERLAY_HANDLE_EDGE;
+  ctx.lineWidth = 1.5;
+  for (const h of points) {
+    ctx.fillRect(h.x - size / 2, h.y - size / 2, size, size);
+    ctx.strokeRect(h.x - size / 2, h.y - size / 2, size, size);
+  }
+}
 var ImageEditorRenderer = class {
   imageCache = globalImageCache;
   cachedBaseCanvas = null;
@@ -1447,38 +1458,29 @@ var ImageEditorRenderer = class {
           outline.forEach((p, i) => i ? ctx.lineTo(p.x, p.y) : ctx.moveTo(p.x, p.y));
           ctx.closePath();
         }
-        ctx.lineWidth = 3;
-        ctx.strokeStyle = "rgba(0,0,0,0.5)";
+        ctx.lineWidth = 4;
+        ctx.strokeStyle = "rgba(0,0,0,0.25)";
         ctx.stroke();
-        ctx.lineWidth = 1;
+        ctx.lineWidth = 2;
         ctx.strokeStyle = "#ffffff";
         ctx.stroke();
-        for (const h of [...t.handles, ...t.warp?.anchors ?? []].map(scr)) {
-          ctx.fillStyle = "#ffffff";
-          ctx.strokeStyle = "#1e293b";
-          ctx.fillRect(h.x - 4, h.y - 4, 8, 8);
-          ctx.strokeRect(h.x - 4, h.y - 4, 8, 8);
-        }
+        drawOverlayHandles(ctx, [...t.handles, ...t.warp?.anchors ?? []].map(scr));
         for (const h of (t.warp?.handles ?? []).map((w) => scr(w.point))) {
           ctx.beginPath();
-          ctx.arc(h.x, h.y, 3, 0, Math.PI * 2);
+          ctx.arc(h.x, h.y, 3.5, 0, Math.PI * 2);
           ctx.fillStyle = "#ffffff";
           ctx.fill();
-          ctx.strokeStyle = "#1e293b";
+          ctx.lineWidth = 1.5;
+          ctx.strokeStyle = OVERLAY_HANDLE_EDGE;
           ctx.stroke();
         }
         const r = scr(t.reference);
         ctx.beginPath();
-        ctx.arc(r.x, r.y, 5, 0, Math.PI * 2);
-        ctx.moveTo(r.x - 8, r.y);
-        ctx.lineTo(r.x + 8, r.y);
-        ctx.moveTo(r.x, r.y - 8);
-        ctx.lineTo(r.x, r.y + 8);
-        ctx.lineWidth = 3;
-        ctx.strokeStyle = "rgba(0,0,0,0.5)";
-        ctx.stroke();
-        ctx.lineWidth = 1;
-        ctx.strokeStyle = "#ffffff";
+        ctx.arc(r.x, r.y, 3.5, 0, Math.PI * 2);
+        ctx.fillStyle = "rgba(255,255,255,0.9)";
+        ctx.fill();
+        ctx.lineWidth = 1.5;
+        ctx.strokeStyle = OVERLAY_HANDLE_EDGE;
         ctx.stroke();
       } catch {
       }
@@ -2040,11 +2042,7 @@ var ImageEditorRenderer = class {
     ctx.moveTo(startX, startY + cropBoxH * 2 / 3);
     ctx.lineTo(startX + cropBoxW, startY + cropBoxH * 2 / 3);
     ctx.stroke();
-    ctx.fillStyle = "#ffffff";
-    ctx.strokeStyle = "#0284c7";
-    ctx.lineWidth = 1.5;
-    const handleSize = 10;
-    const handles = [
+    drawOverlayHandles(ctx, [
       // Corners
       { x: startX, y: startY },
       { x: startX + cropBoxW, y: startY },
@@ -2055,11 +2053,7 @@ var ImageEditorRenderer = class {
       { x: startX + cropBoxW / 2, y: startY + cropBoxH },
       { x: startX, y: startY + cropBoxH / 2 },
       { x: startX + cropBoxW, y: startY + cropBoxH / 2 }
-    ];
-    for (const h of handles) {
-      ctx.fillRect(h.x - handleSize / 2, h.y - handleSize / 2, handleSize, handleSize);
-      ctx.strokeRect(h.x - handleSize / 2, h.y - handleSize / 2, handleSize, handleSize);
-    }
+    ]);
     ctx.restore();
   }
   drawFittedImage(ctx, img, imgW, imgH, vpW, vpH, zoom, pan, fit = "margin") {

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

@@ -84,10 +84,6 @@ declare class ImageCache {
     clear(): void;
 }
 export declare const globalImageCache: ImageCache;
-/**
- * Renders an image with all its transformations, filters, depth masks, and annotations
- * to a target HTMLCanvasElement.
- */
 export declare class ImageEditorRenderer {
     imageCache: ImageCache;
     private cachedBaseCanvas;

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

@@ -84,10 +84,6 @@ declare class ImageCache {
     clear(): void;
 }
 export declare const globalImageCache: ImageCache;
-/**
- * Renders an image with all its transformations, filters, depth masks, and annotations
- * to a target HTMLCanvasElement.
- */
 export declare class ImageEditorRenderer {
     imageCache: ImageCache;
     private cachedBaseCanvas;

package/dist/tools/index.cjs

@@ -8,7 +8,7 @@
 
 
 
-var _chunkZ2UQYMPScjs = require('../chunk-Z2UQYMPS.cjs');
+var _chunkNJGFSOPPcjs = require('../chunk-NJGFSOPP.cjs');
 
 
 
@@ -46,7 +46,7 @@ var _chunkAMX23CSNcjs = require('../chunk-AMX23CSN.cjs');
 
 
 
-var _chunkGMWNBSBScjs = require('../chunk-GMWNBSBS.cjs');
+var _chunk5EMS4BZGcjs = require('../chunk-5EMS4BZG.cjs');
 
 
 
@@ -189,4 +189,4 @@ var _chunk2BSBFBOAcjs = require('../chunk-2BSBFBOA.cjs');
 
 
 
-exports.AgentPlayback = _chunkGMWNBSBScjs.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 = _chunkAMX23CSNcjs.JSON_RPC_ERRORS; exports.MCP_PROTOCOL_VERSIONS = _chunkAMX23CSNcjs.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 = _chunkSWTUM32Hcjs.PRESENCE_COLORS; exports.PerformanceQueue = _chunkSWTUM32Hcjs.PerformanceQueue; exports.PresenceStore = _chunkSWTUM32Hcjs.PresenceStore; exports.TOOL_BRIDGE_DEFAULT_PORT = _chunkAMX23CSNcjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkAMX23CSNcjs.TOOL_BRIDGE_PROTOCOL; exports.TOOL_DISCOVERY_TOOLS = _chunkAMX23CSNcjs.TOOL_DISCOVERY_TOOLS; exports.TOOL_NAMESPACE_SEPARATOR = _chunkAMX23CSNcjs.TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = _chunkAMX23CSNcjs.ToolRegistry; exports.ToolRegistryError = _chunkAMX23CSNcjs.ToolRegistryError; exports.ToolRegistryView = _chunkAMX23CSNcjs.ToolRegistryView; exports.UNSAFE_JSON_KEYS = _chunk2BSBFBOAcjs.UNSAFE_JSON_KEYS; exports.baseToolName = _chunkAMX23CSNcjs.baseToolName; exports.captureInputSchema = _chunkN2FGYZ4Qcjs.captureInputSchema; exports.captureOutputSize = _chunkN2FGYZ4Qcjs.captureOutputSize; exports.cloneElementWithStyles = _chunkSVFEVKLFcjs.cloneElementWithStyles; exports.connectToolBridge = _chunkAMX23CSNcjs.connectToolBridge; exports.createAgentPlayback = _chunkGMWNBSBScjs.createAgentPlayback; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createInstantPresenceClock = _chunkSWTUM32Hcjs.createInstantPresenceClock; exports.createMcpServer = _chunkAMX23CSNcjs.createMcpServer; exports.createPlaybackToolProvider = _chunkGMWNBSBScjs.createPlaybackToolProvider; exports.createStyleResolver = _chunkZ2UQYMPScjs.createStyleResolver; exports.createStyleToolProvider = _chunkZ2UQYMPScjs.createStyleToolProvider; exports.createToolRegistry = _chunkAMX23CSNcjs.createToolRegistry; exports.derivePlaybackSteps = _chunkGMWNBSBScjs.derivePlaybackSteps; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkAMX23CSNcjs.errorResult; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkills = _chunkAMX23CSNcjs.listSkills; exports.locatePlaybackChrome = _chunkGMWNBSBScjs.locatePlaybackChrome; exports.memoryStyleStore = _chunkZ2UQYMPScjs.memoryStyleStore; exports.parseSkillFrontmatter = _chunkAMX23CSNcjs.parseSkillFrontmatter; exports.parseStyleDomains = _chunkZ2UQYMPScjs.parseStyleDomains; exports.playbackRectFromClient = _chunkGMWNBSBScjs.playbackRectFromClient; exports.playbackRefsFromArgs = _chunkGMWNBSBScjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunkGMWNBSBScjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkAMX23CSNcjs.readSkillFile; exports.readingTime = _chunkGMWNBSBScjs.readingTime; exports.realPresenceClock = _chunkSWTUM32Hcjs.realPresenceClock; exports.renderStyle = _chunkZ2UQYMPScjs.renderStyle; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.runStyleChecks = _chunkZ2UQYMPScjs.runStyleChecks; exports.runToolScript = _chunkZ2UQYMPScjs.runToolScript; exports.searchTokens = _chunkAMX23CSNcjs.searchTokens; exports.searchTools = _chunkAMX23CSNcjs.searchTools; exports.stripPrototypeKeys = _chunk2BSBFBOAcjs.stripPrototypeKeys; exports.summarize = _chunkAMX23CSNcjs.summarize; exports.toCapturedImageData = _chunkN2FGYZ4Qcjs.toCapturedImageData; exports.toToolResult = _chunkAMX23CSNcjs.toToolResult; exports.toolResultError = _chunkZ2UQYMPScjs.toolResultError; exports.toolResultValue = _chunkZ2UQYMPScjs.toolResultValue; exports.toolsetInstructions = _chunkAMX23CSNcjs.toolsetInstructions; exports.toolsetName = _chunkAMX23CSNcjs.toolsetName; exports.trackPresenceDrag = _chunkSWTUM32Hcjs.trackPresenceDrag; exports.tweenPresenceCursor = _chunkSWTUM32Hcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunkGMWNBSBScjs.unionRects; exports.unknownToolMessage = _chunkAMX23CSNcjs.unknownToolMessage; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;
+exports.AgentPlayback = _chunk5EMS4BZGcjs.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 = _chunkAMX23CSNcjs.JSON_RPC_ERRORS; exports.MCP_PROTOCOL_VERSIONS = _chunkAMX23CSNcjs.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 = _chunkSWTUM32Hcjs.PRESENCE_COLORS; exports.PerformanceQueue = _chunkSWTUM32Hcjs.PerformanceQueue; exports.PresenceStore = _chunkSWTUM32Hcjs.PresenceStore; exports.TOOL_BRIDGE_DEFAULT_PORT = _chunkAMX23CSNcjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkAMX23CSNcjs.TOOL_BRIDGE_PROTOCOL; exports.TOOL_DISCOVERY_TOOLS = _chunkAMX23CSNcjs.TOOL_DISCOVERY_TOOLS; exports.TOOL_NAMESPACE_SEPARATOR = _chunkAMX23CSNcjs.TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = _chunkAMX23CSNcjs.ToolRegistry; exports.ToolRegistryError = _chunkAMX23CSNcjs.ToolRegistryError; exports.ToolRegistryView = _chunkAMX23CSNcjs.ToolRegistryView; exports.UNSAFE_JSON_KEYS = _chunk2BSBFBOAcjs.UNSAFE_JSON_KEYS; exports.baseToolName = _chunkAMX23CSNcjs.baseToolName; exports.captureInputSchema = _chunkN2FGYZ4Qcjs.captureInputSchema; exports.captureOutputSize = _chunkN2FGYZ4Qcjs.captureOutputSize; exports.cloneElementWithStyles = _chunkSVFEVKLFcjs.cloneElementWithStyles; exports.connectToolBridge = _chunkAMX23CSNcjs.connectToolBridge; exports.createAgentPlayback = _chunk5EMS4BZGcjs.createAgentPlayback; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createInstantPresenceClock = _chunkSWTUM32Hcjs.createInstantPresenceClock; exports.createMcpServer = _chunkAMX23CSNcjs.createMcpServer; exports.createPlaybackToolProvider = _chunk5EMS4BZGcjs.createPlaybackToolProvider; exports.createStyleResolver = _chunkNJGFSOPPcjs.createStyleResolver; exports.createStyleToolProvider = _chunkNJGFSOPPcjs.createStyleToolProvider; exports.createToolRegistry = _chunkAMX23CSNcjs.createToolRegistry; exports.derivePlaybackSteps = _chunk5EMS4BZGcjs.derivePlaybackSteps; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkAMX23CSNcjs.errorResult; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkills = _chunkAMX23CSNcjs.listSkills; exports.locatePlaybackChrome = _chunk5EMS4BZGcjs.locatePlaybackChrome; exports.memoryStyleStore = _chunkNJGFSOPPcjs.memoryStyleStore; exports.parseSkillFrontmatter = _chunkAMX23CSNcjs.parseSkillFrontmatter; exports.parseStyleDomains = _chunkNJGFSOPPcjs.parseStyleDomains; exports.playbackRectFromClient = _chunk5EMS4BZGcjs.playbackRectFromClient; exports.playbackRefsFromArgs = _chunk5EMS4BZGcjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunk5EMS4BZGcjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkAMX23CSNcjs.readSkillFile; exports.readingTime = _chunk5EMS4BZGcjs.readingTime; exports.realPresenceClock = _chunkSWTUM32Hcjs.realPresenceClock; exports.renderStyle = _chunkNJGFSOPPcjs.renderStyle; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.runStyleChecks = _chunkNJGFSOPPcjs.runStyleChecks; exports.runToolScript = _chunkNJGFSOPPcjs.runToolScript; exports.searchTokens = _chunkAMX23CSNcjs.searchTokens; exports.searchTools = _chunkAMX23CSNcjs.searchTools; exports.stripPrototypeKeys = _chunk2BSBFBOAcjs.stripPrototypeKeys; exports.summarize = _chunkAMX23CSNcjs.summarize; exports.toCapturedImageData = _chunkN2FGYZ4Qcjs.toCapturedImageData; exports.toToolResult = _chunkAMX23CSNcjs.toToolResult; exports.toolResultError = _chunkNJGFSOPPcjs.toolResultError; exports.toolResultValue = _chunkNJGFSOPPcjs.toolResultValue; exports.toolsetInstructions = _chunkAMX23CSNcjs.toolsetInstructions; exports.toolsetName = _chunkAMX23CSNcjs.toolsetName; exports.trackPresenceDrag = _chunkSWTUM32Hcjs.trackPresenceDrag; exports.tweenPresenceCursor = _chunkSWTUM32Hcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunk5EMS4BZGcjs.unionRects; exports.unknownToolMessage = _chunkAMX23CSNcjs.unknownToolMessage; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;

package/dist/tools/index.js

@@ -8,7 +8,7 @@ import {
   runToolScript,
   toolResultError,
   toolResultValue
-} from "../chunk-HIDFL5LQ.js";
+} from "../chunk-ZXTO6U7T.js";
 import {
   JSON_RPC_ERRORS,
   MCP_PROTOCOL_VERSIONS,
@@ -46,7 +46,7 @@ import {
   playbackRefsFromResult,
   readingTime,
   unionRects
-} from "../chunk-6DXDUVSL.js";
+} from "../chunk-WL4IN36A.js";
 import {
   CAPTURE_EXCLUDE_SELECTOR,
   CAPTURE_OVERLAY_SELECTORS,

package/dist/tools/playback.d.cts

@@ -66,6 +66,14 @@ export type PlaybackStep = {
 /** The handler runs here, exactly once (appended when a plan leaves it out). */
  | {
     type: 'commit';
+}
+/**
+ * One part of a staged change lands here. A plan with `stage` steps starts the handler at
+ * `commit` and keeps playing; each `stage` lets one `await context.stage()` in the handler
+ * through, so a call that adds several things adds them one by one under the cursor.
+ */
+ | {
+    type: 'stage';
 };
 export interface PlaybackPlanResult {
     steps: PlaybackStep[];

package/dist/tools/playback.d.ts

@@ -66,6 +66,14 @@ export type PlaybackStep = {
 /** The handler runs here, exactly once (appended when a plan leaves it out). */
  | {
     type: 'commit';
+}
+/**
+ * One part of a staged change lands here. A plan with `stage` steps starts the handler at
+ * `commit` and keeps playing; each `stage` lets one `await context.stage()` in the handler
+ * through, so a call that adds several things adds them one by one under the cursor.
+ */
+ | {
+    type: 'stage';
 };
 export interface PlaybackPlanResult {
     steps: PlaybackStep[];

package/dist/tools/registry.d.cts

@@ -51,6 +51,12 @@ export interface ToolCallContext {
     signal?: AbortSignal;
     /** Who is calling (an MCP client, a scripted agent), for agent playback's cursors and queues. */
     actor?: PresenceActorInfo;
+    /**
+     * Set by agent playback when the tool's plan has `stage` steps: resolves when the cursor
+     * reaches the next one. A handler that adds several things awaits it before each
+     * (`await context.stage?.()`), so they appear one by one; without playback it is absent.
+     */
+    stage?: () => Promise<void>;
 }
 /** Options for `callTool`. */
 export interface ToolCallOptions {

package/dist/tools/registry.d.ts

@@ -51,6 +51,12 @@ export interface ToolCallContext {
     signal?: AbortSignal;
     /** Who is calling (an MCP client, a scripted agent), for agent playback's cursors and queues. */
     actor?: PresenceActorInfo;
+    /**
+     * Set by agent playback when the tool's plan has `stage` steps: resolves when the cursor
+     * reaches the next one. A handler that adds several things awaits it before each
+     * (`await context.stage?.()`), so they appear one by one; without playback it is absent.
+     */
+    stage?: () => Promise<void>;
 }
 /** Options for `callTool`. */
 export interface ToolCallOptions {

package/dist/video-editor/index.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 _class; var _class2; var _class3; var _class4; var _class5; var _class6; var _class7;
 
-var _chunk6DM3PUQDcjs = require('../chunk-6DM3PUQD.cjs');
+var _chunkCYKWYP6Dcjs = require('../chunk-CYKWYP6D.cjs');
 
 
 
@@ -6136,7 +6136,7 @@ async function openVideoClipEffectAuthoring(controller, clip, instance, options
   const at = _chunk3OSXHLITcjs.findVideoClip.call(void 0, controller.getProject(), clip);
   if (!at) throw new Error(`There is no clip "${clip}".`);
   const doc = videoClipEffectDocument(at.clip, instance, provider.id);
-  const session = await _chunk6DM3PUQDcjs.createEffectAuthoringSession.call(void 0, { document: doc }, { ...options, provider });
+  const session = await _chunkCYKWYP6Dcjs.createEffectAuthoringSession.call(void 0, { document: doc }, { ...options, provider });
   return {
     clip,
     instance,

package/dist/video-editor/index.js

@@ -1,6 +1,6 @@
 import {
   createEffectAuthoringSession
-} from "../chunk-ZGOHKS3X.js";
+} from "../chunk-HCC2LBCW.js";
 import {
   VIDEO_ADJUSTMENT_SCOPES,
   VIDEO_BLEND_MODES,

package/package.json

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

package/skills/pixerate-effect-authoring/SKILL.md

@@ -21,7 +21,9 @@ For general error reporting and undo conventions, see `pixerate-agent-tools`.
 
 1. **Inspect first.** Run `effect_authoring_describe` to inspect the effect name, kind, source
    language (`glsl`, `svg`, or null when the effect has no source to edit), control parameter schemas, current
-   values, existing tracks, and compile issues.
+   values, existing tracks, playhead `time`, compile issues and `previewError`.
+   A session opens with its playhead at half the effect's length (where entrance-style effects and
+   transitions show), so values set on an animated control key that time unless you seek first.
 2. **Read or update source code.** If `sourceLanguage` is non-null, use `effect_authoring_get_source`
    to read the shader or script code. Use `effect_authoring_set_source` to recompile with new code
    and immediately inspect any reported syntax or compilation issues with line numbers.
@@ -38,7 +40,10 @@ For general error reporting and undo conventions, see `pixerate-agent-tools`.
 6. **Save presets.** When an interesting look is achieved, save it with `effect_authoring_save_preset`
    or restore known presets with `effect_authoring_apply_preset`.
 7. **Verify visually.** When `effect_authoring_view` is available, capture rendered preview frames
-   at specific times to visually confirm effect appearance.
+   at specific times to visually confirm effect appearance. When `effect_authoring_describe` reports a
+   `previewError` (typically a `vector` effect whose provider only draws it as SVG), there is no pixel
+   preview: `effect_authoring_view` is refused with that reason, but values, presets, keyframes and
+   timing still work. Judge the result from the values instead of retrying the view.
 
 ## Best practices
 
@@ -56,7 +61,7 @@ For general error reporting and undo conventions, see `pixerate-agent-tools`.
 
 | Tool | Description and usage |
 | --- | --- |
-| `effect_authoring_describe` | Reads the currently open effect session: name, kind, source language, controls schema and current values, presets, animated tracks with keyframe counts, duration, loop, and compile issues. |
+| `effect_authoring_describe` | Reads the currently open effect session: name, kind, source language, controls schema and current values, presets, animated tracks with keyframe counts, playhead `time`, duration, loop, compile issues, and `previewError` (why there is no pixel preview, or null). Call it first. |
 | `effect_authoring_get_source` | Retrieves shader or script source code and language for code-backed effects. Refused if `sourceLanguage` is null. |
 | `effect_authoring_set_source` | Recompiles the effect with new shader or script source code. Returns compiler issues with line numbers and messages. Available only when supported by the session. |
 | `effect_authoring_set_values` | Sets one or more control values at the current playhead time as a single undo step. Rejects all changes if any control name or value is invalid. |
@@ -70,11 +75,13 @@ For general error reporting and undo conventions, see `pixerate-agent-tools`.
 | `effect_authoring_seek` | Moves the preview playhead to a specific timeline position in milliseconds (clamped to 0..duration) and returns values at that time. |
 | `effect_authoring_undo` | Undoes the most recent edit in the authoring session. |
 | `effect_authoring_redo` | Redoes the most recently undone edit in the authoring session. |
-| `effect_authoring_view` | Captures a preview image of the effect at the current playhead or a specified timestamp. Available when preview capture is supported. |
+| `effect_authoring_view` | Captures a preview image of the effect at the current playhead or a specified timestamp. Available when preview capture is supported. Refused, with the reason, when `effect_authoring_describe` shows a `previewError`. |
 
 ## Pitfalls
 
 - Calling authoring tools when no authoring session is open returns an error explaining that a session must be opened first.
 - Animated controls calculate their values dynamically from keyframes; clearing a track reverts the parameter to static behavior.
 - Compiling invalid shader code produces issues in `effect_authoring_set_source`; inspect the line numbers and messages to correct syntax.
+- A `vector` effect may have no pixel preview (the provider refuses a pixel renderer); check `previewError` rather than reading a blank capture as a broken effect.
+- The playhead does not start at 0. Pass explicit `time`s to `effect_authoring_set_keyframe`, or `effect_authoring_seek` before setting values on an animated control.
 - Control values must match their schema types and bounds; colours must be `#rrggbb` (or `#rrggbbaa`), and numbers must fall within `[min, max]`.