@pixerate/editor 0.143.0 → 0.145.0

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

@@ -107,7 +107,7 @@ var AgentPlayback = (_class = class {
   constructor(options = {}) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);_class.prototype.__init3.call(this);_class.prototype.__init4.call(this);_class.prototype.__init5.call(this);_class.prototype.__init6.call(this);_class.prototype.__init7.call(this);_class.prototype.__init8.call(this);_class.prototype.__init9.call(this);
     this.clock = _nullishCoalesce(options.clock, () => ( _chunkUJGAA6AKcjs.realPresenceClock));
     this.speed = _nullishCoalesce(options.speed, () => ( 1));
-    this.reads = _nullishCoalesce(options.reads, () => ( "glance"));
+    this.reads = _nullishCoalesce(options.reads, () => ( "skip"));
     this.linger = _nullishCoalesce(options.linger, () => ( 1500));
     this.defaultActor = _nullishCoalesce(options.actor, () => ( { id: "agent", name: "Agent" }));
   }
@@ -143,11 +143,16 @@ var AgentPlayback = (_class = class {
   surface(id) {
     return this.surfaces.get(id);
   }
-  /** Shows `text` in the actor's bubble on the surface it last worked on (until its next step). */
+  /**
+   * Shows `text` in the actor's bubble on the surface it last worked on (until its next step).
+   * Returns that surface's id, or null when the actor has no cursor on screen (nothing shown).
+   */
   say(text, options = {}) {
     const actor = this.actorState(options.actor);
     const surface = actor.surface ? this.surfaces.get(actor.surface) : void 0;
-    if (_optionalChain([surface, 'optionalAccess', _5 => _5.presence, 'access', _6 => _6.get, 'call', _7 => _7(actor.info.id)])) surface.presence.set({ id: actor.info.id, message: text });
+    if (!_optionalChain([surface, 'optionalAccess', _5 => _5.presence, 'access', _6 => _6.get, 'call', _7 => _7(actor.info.id)])) return null;
+    surface.presence.set({ id: actor.info.id, message: text });
+    return actor.surface;
   }
   /** Finishes every running performance at once (the calls still run and keep their results). */
   stop() {
@@ -396,6 +401,40 @@ var AgentPlayback = (_class = class {
 function createAgentPlayback(options = {}) {
   return new AgentPlayback(options);
 }
+function createPlaybackToolProvider(playback, options = {}) {
+  const title = "Say a note by your cursor";
+  return {
+    id: _nullishCoalesce(options.id, () => ( "playback")),
+    namespace: options.namespace,
+    title: "Agent playback",
+    description: "Notes shown beside your cursor while the host plays your calls on screen.",
+    skill: "pixerate-agent-tools",
+    tools: [
+      {
+        name: "say",
+        title,
+        description: "Shows a short note in the bubble beside your cursor on the editor you last worked on, so the user can follow what you are doing; it stays until your next call. Changes no document. Returns shown (whether a cursor was on screen to show it) and surface (that editor, or null).",
+        inputSchema: {
+          type: "object",
+          properties: {
+            text: { type: "string", minLength: 1, maxLength: 200, description: "The note: one short sentence, at most 200 characters." }
+          },
+          required: ["text"],
+          additionalProperties: false
+        },
+        annotations: { title, readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        playback: false,
+        handler: ({ text }, context) => {
+          const note = String(text).trim();
+          if (!note) throw new Error('text is empty; pass the note to show, e.g. "Aligning the cards."');
+          const surface = playback.say(note, { actor: context.actor });
+          return { shown: surface !== null, surface };
+        }
+      }
+    ]
+  };
+}
+
 
 
 
@@ -405,4 +444,4 @@ function createAgentPlayback(options = {}) {
 
 
 
-exports.playbackRefsFromArgs = playbackRefsFromArgs; exports.playbackRefsFromResult = playbackRefsFromResult; exports.derivePlaybackSteps = derivePlaybackSteps; exports.readingTime = readingTime; exports.unionRects = unionRects; exports.AgentPlayback = AgentPlayback; exports.createAgentPlayback = createAgentPlayback;
+exports.playbackRefsFromArgs = playbackRefsFromArgs; exports.playbackRefsFromResult = playbackRefsFromResult; exports.derivePlaybackSteps = derivePlaybackSteps; exports.readingTime = readingTime; exports.unionRects = unionRects; exports.AgentPlayback = AgentPlayback; exports.createAgentPlayback = createAgentPlayback; exports.createPlaybackToolProvider = createPlaybackToolProvider;

package/dist/{chunk-54GVEVXS.js → chunk-HUHBJWTD.js}

@@ -107,7 +107,7 @@ var AgentPlayback = class {
   constructor(options = {}) {
     this.clock = options.clock ?? realPresenceClock;
     this.speed = options.speed ?? 1;
-    this.reads = options.reads ?? "glance";
+    this.reads = options.reads ?? "skip";
     this.linger = options.linger ?? 1500;
     this.defaultActor = options.actor ?? { id: "agent", name: "Agent" };
   }
@@ -143,11 +143,16 @@ var AgentPlayback = class {
   surface(id) {
     return this.surfaces.get(id);
   }
-  /** Shows `text` in the actor's bubble on the surface it last worked on (until its next step). */
+  /**
+   * Shows `text` in the actor's bubble on the surface it last worked on (until its next step).
+   * Returns that surface's id, or null when the actor has no cursor on screen (nothing shown).
+   */
   say(text, options = {}) {
     const actor = this.actorState(options.actor);
     const surface = actor.surface ? this.surfaces.get(actor.surface) : void 0;
-    if (surface?.presence.get(actor.info.id)) surface.presence.set({ id: actor.info.id, message: text });
+    if (!surface?.presence.get(actor.info.id)) return null;
+    surface.presence.set({ id: actor.info.id, message: text });
+    return actor.surface;
   }
   /** Finishes every running performance at once (the calls still run and keep their results). */
   stop() {
@@ -396,6 +401,39 @@ var AgentPlayback = class {
 function createAgentPlayback(options = {}) {
   return new AgentPlayback(options);
 }
+function createPlaybackToolProvider(playback, options = {}) {
+  const title = "Say a note by your cursor";
+  return {
+    id: options.id ?? "playback",
+    namespace: options.namespace,
+    title: "Agent playback",
+    description: "Notes shown beside your cursor while the host plays your calls on screen.",
+    skill: "pixerate-agent-tools",
+    tools: [
+      {
+        name: "say",
+        title,
+        description: "Shows a short note in the bubble beside your cursor on the editor you last worked on, so the user can follow what you are doing; it stays until your next call. Changes no document. Returns shown (whether a cursor was on screen to show it) and surface (that editor, or null).",
+        inputSchema: {
+          type: "object",
+          properties: {
+            text: { type: "string", minLength: 1, maxLength: 200, description: "The note: one short sentence, at most 200 characters." }
+          },
+          required: ["text"],
+          additionalProperties: false
+        },
+        annotations: { title, readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        playback: false,
+        handler: ({ text }, context) => {
+          const note = String(text).trim();
+          if (!note) throw new Error('text is empty; pass the note to show, e.g. "Aligning the cards."');
+          const surface = playback.say(note, { actor: context.actor });
+          return { shown: surface !== null, surface };
+        }
+      }
+    ]
+  };
+}
 
 export {
   playbackRefsFromArgs,
@@ -404,5 +442,6 @@ export {
   readingTime,
   unionRects,
   AgentPlayback,
-  createAgentPlayback
+  createAgentPlayback,
+  createPlaybackToolProvider
 };

package/dist/{chunk-I4T4J27S.js → chunk-QX25HWFL.js}

@@ -201,6 +201,15 @@ var AnimationPlayer = class {
   get currentTime() {
     return this.time;
   }
+  /**
+   * The playhead at this moment of the clock, between frames too (`currentTime` is the last
+   * frame's): what input arriving between frames, like a recorded pointer move, happened at.
+   */
+  get liveTime() {
+    if (!this.playing) return this.time;
+    const d = this.duration;
+    return this.loop === "none" || d <= 0 ? this.clamp(this.rawNow()) : wrapAnimationTime(this.rawNow(), d, this.loop);
+  }
   get isPlaying() {
     return this.playing;
   }

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

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

package/dist/{chunk-SVR5FR7B.cjs → chunk-UUTTJK77.cjs}

@@ -201,6 +201,15 @@ var AnimationPlayer = (_class2 = class {
   get currentTime() {
     return this.time;
   }
+  /**
+   * The playhead at this moment of the clock, between frames too (`currentTime` is the last
+   * frame's): what input arriving between frames, like a recorded pointer move, happened at.
+   */
+  get liveTime() {
+    if (!this.playing) return this.time;
+    const d = this.duration;
+    return this.loop === "none" || d <= 0 ? this.clamp(this.rawNow()) : wrapAnimationTime(this.rawNow(), d, this.loop);
+  }
   get isPlaying() {
     return this.playing;
   }

package/dist/commands/index.cjs

@@ -29,7 +29,7 @@ var _chunkGLQQ2VILcjs = require('../chunk-GLQQ2VIL.cjs');
 var _chunk4EFNS2HVcjs = require('../chunk-4EFNS2HV.cjs');
 
 
-var _chunkX2HQP7DFcjs = require('../chunk-X2HQP7DF.cjs');
+var _chunkD2ENR3LBcjs = require('../chunk-D2ENR3LB.cjs');
 require('../chunk-UJGAA6AK.cjs');
 
 
@@ -608,7 +608,7 @@ function createCommandToolProvider(registry, options = {}) {
     const surface = _nullishCoalesce(_nullishCoalesce(spec.playbackSurface, () => ( spec.scope)), () => ( (id.includes(".") ? id.slice(0, id.indexOf(".")) : void 0)));
     const planned = _optionalChain([spec, 'access', _24 => _24.plan, 'optionalCall', _25 => _25(context(), _nullishCoalesce(params, () => ( {})))]);
     const own = !planned ? [] : Array.isArray(planned) ? planned : planned.steps;
-    const steps = own.length ? own : _chunkX2HQP7DFcjs.derivePlaybackSteps.call(void 0, params);
+    const steps = own.length ? own : _chunkD2ENR3LBcjs.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-54GVEVXS.js";
+} from "../chunk-HUHBJWTD.js";
 import "../chunk-PEEP2YR7.js";
 import {
   validateJsonSchema

package/dist/tools/index.cjs

@@ -2,7 +2,7 @@
 
 
 
-var _chunkXH32BATEcjs = require('../chunk-XH32BATE.cjs');
+var _chunkAG2EXVCRcjs = require('../chunk-AG2EXVCR.cjs');
 
 
 
@@ -37,7 +37,8 @@ var _chunkY4BWZB6Jcjs = require('../chunk-Y4BWZB6J.cjs');
 
 
 
-var _chunkX2HQP7DFcjs = require('../chunk-X2HQP7DF.cjs');
+
+var _chunkD2ENR3LBcjs = require('../chunk-D2ENR3LB.cjs');
 
 
 
@@ -169,4 +170,5 @@ var _chunkWOFXZ3XUcjs = require('../chunk-WOFXZ3XU.cjs');
 
 
 
-exports.AgentPlayback = _chunkX2HQP7DFcjs.AgentPlayback; exports.CAPTURE_EXCLUDE_SELECTOR = _chunkSVFEVKLFcjs.CAPTURE_EXCLUDE_SELECTOR; exports.CAPTURE_OVERLAY_SELECTORS = _chunkSVFEVKLFcjs.CAPTURE_OVERLAY_SELECTORS; exports.EDITOR_CANVAS_TOOLS = _chunkSVFEVKLFcjs.EDITOR_CANVAS_TOOLS; exports.EDITOR_MCP_TOOLS = _chunkSVFEVKLFcjs.EDITOR_MCP_TOOLS; exports.EDITOR_PROMPT_TOOLS = _chunkSVFEVKLFcjs.EDITOR_PROMPT_TOOLS; exports.EDIT_OPERATION_REQUIRED_ARGUMENTS = _chunkSVFEVKLFcjs.EDIT_OPERATION_REQUIRED_ARGUMENTS; exports.EXPORT_EXCLUDED_SELECTORS = _chunkSVFEVKLFcjs.EXPORT_EXCLUDED_SELECTORS; exports.JSON_RPC_ERRORS = _chunkY4BWZB6Jcjs.JSON_RPC_ERRORS; exports.MCP_PROTOCOL_VERSIONS = _chunkY4BWZB6Jcjs.MCP_PROTOCOL_VERSIONS; exports.MCP_TOOL_CANVAS_ADD_NODE = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_ADD_NODE; exports.MCP_TOOL_CANVAS_CONNECT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_CONNECT; exports.MCP_TOOL_CANVAS_HIGHLIGHT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_HIGHLIGHT; exports.MCP_TOOL_CANVAS_LAYOUT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_LAYOUT; exports.MCP_TOOL_CANVAS_REMOVE_NODES = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_REMOVE_NODES; exports.MCP_TOOL_CANVAS_SELECT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_SELECT; exports.MCP_TOOL_CANVAS_UPDATE_NODE = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_UPDATE_NODE; exports.MCP_TOOL_EDIT_CANVAS = _chunkSVFEVKLFcjs.MCP_TOOL_EDIT_CANVAS; exports.MCP_TOOL_EDIT_PROMPT = _chunkSVFEVKLFcjs.MCP_TOOL_EDIT_PROMPT; exports.MCP_TOOL_GET_EDITOR_STATE = _chunkSVFEVKLFcjs.MCP_TOOL_GET_EDITOR_STATE; exports.MCP_TOOL_PROMPT_INSERT_TEXT = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_INSERT_TEXT; exports.MCP_TOOL_PROMPT_REPLACE_RANGE = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_REPLACE_RANGE; exports.MCP_TOOL_PROMPT_SELECT = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_SELECT; exports.MCP_TOOL_PROMPT_SET_VARIABLE = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_SET_VARIABLE; exports.MCP_TOOL_VIEW_EDITOR = _chunkSVFEVKLFcjs.MCP_TOOL_VIEW_EDITOR; exports.PRESENCE_COLORS = _chunkUJGAA6AKcjs.PRESENCE_COLORS; exports.PerformanceQueue = _chunkUJGAA6AKcjs.PerformanceQueue; exports.PresenceStore = _chunkUJGAA6AKcjs.PresenceStore; exports.TOOL_BRIDGE_DEFAULT_PORT = _chunkY4BWZB6Jcjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkY4BWZB6Jcjs.TOOL_BRIDGE_PROTOCOL; exports.TOOL_DISCOVERY_TOOLS = _chunkY4BWZB6Jcjs.TOOL_DISCOVERY_TOOLS; exports.TOOL_NAMESPACE_SEPARATOR = _chunkY4BWZB6Jcjs.TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = _chunkY4BWZB6Jcjs.ToolRegistry; exports.ToolRegistryError = _chunkY4BWZB6Jcjs.ToolRegistryError; exports.ToolRegistryView = _chunkY4BWZB6Jcjs.ToolRegistryView; exports.UNSAFE_JSON_KEYS = _chunk2BSBFBOAcjs.UNSAFE_JSON_KEYS; exports.baseToolName = _chunkY4BWZB6Jcjs.baseToolName; exports.captureInputSchema = _chunkN2FGYZ4Qcjs.captureInputSchema; exports.captureOutputSize = _chunkN2FGYZ4Qcjs.captureOutputSize; exports.cloneElementWithStyles = _chunkSVFEVKLFcjs.cloneElementWithStyles; exports.connectToolBridge = _chunkY4BWZB6Jcjs.connectToolBridge; exports.createAgentPlayback = _chunkX2HQP7DFcjs.createAgentPlayback; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createInstantPresenceClock = _chunkUJGAA6AKcjs.createInstantPresenceClock; exports.createMcpServer = _chunkY4BWZB6Jcjs.createMcpServer; exports.createToolRegistry = _chunkY4BWZB6Jcjs.createToolRegistry; exports.derivePlaybackSteps = _chunkX2HQP7DFcjs.derivePlaybackSteps; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkY4BWZB6Jcjs.errorResult; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkills = _chunkY4BWZB6Jcjs.listSkills; exports.parseSkillFrontmatter = _chunkY4BWZB6Jcjs.parseSkillFrontmatter; exports.playbackRefsFromArgs = _chunkX2HQP7DFcjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunkX2HQP7DFcjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkY4BWZB6Jcjs.readSkillFile; exports.readingTime = _chunkX2HQP7DFcjs.readingTime; exports.realPresenceClock = _chunkUJGAA6AKcjs.realPresenceClock; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.runToolScript = _chunkXH32BATEcjs.runToolScript; exports.searchTokens = _chunkY4BWZB6Jcjs.searchTokens; exports.searchTools = _chunkY4BWZB6Jcjs.searchTools; exports.stripPrototypeKeys = _chunk2BSBFBOAcjs.stripPrototypeKeys; exports.summarize = _chunkY4BWZB6Jcjs.summarize; exports.toCapturedImageData = _chunkN2FGYZ4Qcjs.toCapturedImageData; exports.toToolResult = _chunkY4BWZB6Jcjs.toToolResult; exports.toolResultError = _chunkXH32BATEcjs.toolResultError; exports.toolResultValue = _chunkXH32BATEcjs.toolResultValue; exports.toolsetInstructions = _chunkY4BWZB6Jcjs.toolsetInstructions; exports.toolsetName = _chunkY4BWZB6Jcjs.toolsetName; exports.tweenPresenceCursor = _chunkUJGAA6AKcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunkX2HQP7DFcjs.unionRects; exports.unknownToolMessage = _chunkY4BWZB6Jcjs.unknownToolMessage; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;
+
+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;

package/dist/tools/index.js

@@ -2,7 +2,7 @@ import {
   runToolScript,
   toolResultError,
   toolResultValue
-} from "../chunk-Y6SGC6KO.js";
+} from "../chunk-SA37RU2O.js";
 import {
   JSON_RPC_ERRORS,
   MCP_PROTOCOL_VERSIONS,
@@ -32,12 +32,13 @@ import {
 import {
   AgentPlayback,
   createAgentPlayback,
+  createPlaybackToolProvider,
   derivePlaybackSteps,
   playbackRefsFromArgs,
   playbackRefsFromResult,
   readingTime,
   unionRects
-} from "../chunk-54GVEVXS.js";
+} from "../chunk-HUHBJWTD.js";
 import {
   CAPTURE_EXCLUDE_SELECTOR,
   CAPTURE_OVERLAY_SELECTORS,
@@ -139,6 +140,7 @@ export {
   createElementCaptureSurface,
   createInstantPresenceClock,
   createMcpServer,
+  createPlaybackToolProvider,
   createToolRegistry,
   derivePlaybackSteps,
   elementToSvg,

package/dist/tools/playback.d.cts

@@ -1,4 +1,4 @@
-import type { ToolMiddleware, ToolRegistry } from './registry.cjs';
+import type { AgentToolProvider, ToolMiddleware, ToolRegistry } from './registry.cjs';
 import { type PresenceActorInfo, type PresenceClock, type PresenceStore } from './presence.cjs';
 export interface PlaybackPoint {
     x: number;
@@ -116,7 +116,7 @@ export interface AgentPlaybackOptions {
     clock?: PresenceClock;
     /** 1 = natural pace, 2 = twice as fast, `Infinity` = no animation (default 1). */
     speed?: number;
-    /** Read-only tools: `glance` moves to their target only (default), `skip` doesn't, `play` plays them like writes. */
+    /** Read-only tools: `skip` shows only changes (default), `glance` moves to their target only, `play` plays them like writes. */
     reads?: PlaybackReads;
     /** Hide a cursor this long after its actor's last call (ms, default 1500; 0 keeps it). */
     linger?: number;
@@ -183,10 +183,13 @@ export declare class AgentPlayback {
     attach(id: string, surface: PlaybackSurface): () => void;
     /** The surface attached under `id`. */
     surface(id: string): PlaybackSurface | undefined;
-    /** Shows `text` in the actor's bubble on the surface it last worked on (until its next step). */
+    /**
+     * Shows `text` in the actor's bubble on the surface it last worked on (until its next step).
+     * Returns that surface's id, or null when the actor has no cursor on screen (nothing shown).
+     */
     say(text: string, options?: {
         actor?: PresenceActorInfo;
-    }): void;
+    }): string | null;
     /** Finishes every running performance at once (the calls still run and keep their results). */
     stop(): void;
     /** Collects every step played from now on (for tests). */
@@ -203,3 +206,14 @@ export declare class AgentPlayback {
 }
 /** An {@link AgentPlayback}: install it on a registry and attach editor surfaces to see calls played. */
 export declare function createAgentPlayback(options?: AgentPlaybackOptions): AgentPlayback;
+export interface PlaybackToolProviderOptions {
+    /** Provider id and default namespace (default `playback`, so the tool is `playback__say`). */
+    id?: string;
+    namespace?: string;
+}
+/**
+ * The optional `say` tool: lets an agent put a short note in its cursor's bubble, through
+ * {@link AgentPlayback.say}. Register it only where a UI shows the cursors; it changes no document
+ * and is never played itself. Without a cursor on screen it shows nothing and says so.
+ */
+export declare function createPlaybackToolProvider(playback: AgentPlayback, options?: PlaybackToolProviderOptions): AgentToolProvider;

package/dist/tools/playback.d.ts

@@ -1,4 +1,4 @@
-import type { ToolMiddleware, ToolRegistry } from './registry.js';
+import type { AgentToolProvider, ToolMiddleware, ToolRegistry } from './registry.js';
 import { type PresenceActorInfo, type PresenceClock, type PresenceStore } from './presence.js';
 export interface PlaybackPoint {
     x: number;
@@ -116,7 +116,7 @@ export interface AgentPlaybackOptions {
     clock?: PresenceClock;
     /** 1 = natural pace, 2 = twice as fast, `Infinity` = no animation (default 1). */
     speed?: number;
-    /** Read-only tools: `glance` moves to their target only (default), `skip` doesn't, `play` plays them like writes. */
+    /** Read-only tools: `skip` shows only changes (default), `glance` moves to their target only, `play` plays them like writes. */
     reads?: PlaybackReads;
     /** Hide a cursor this long after its actor's last call (ms, default 1500; 0 keeps it). */
     linger?: number;
@@ -183,10 +183,13 @@ export declare class AgentPlayback {
     attach(id: string, surface: PlaybackSurface): () => void;
     /** The surface attached under `id`. */
     surface(id: string): PlaybackSurface | undefined;
-    /** Shows `text` in the actor's bubble on the surface it last worked on (until its next step). */
+    /**
+     * Shows `text` in the actor's bubble on the surface it last worked on (until its next step).
+     * Returns that surface's id, or null when the actor has no cursor on screen (nothing shown).
+     */
     say(text: string, options?: {
         actor?: PresenceActorInfo;
-    }): void;
+    }): string | null;
     /** Finishes every running performance at once (the calls still run and keep their results). */
     stop(): void;
     /** Collects every step played from now on (for tests). */
@@ -203,3 +206,14 @@ export declare class AgentPlayback {
 }
 /** An {@link AgentPlayback}: install it on a registry and attach editor surfaces to see calls played. */
 export declare function createAgentPlayback(options?: AgentPlaybackOptions): AgentPlayback;
+export interface PlaybackToolProviderOptions {
+    /** Provider id and default namespace (default `playback`, so the tool is `playback__say`). */
+    id?: string;
+    namespace?: string;
+}
+/**
+ * The optional `say` tool: lets an agent put a short note in its cursor's bubble, through
+ * {@link AgentPlayback.say}. Register it only where a UI shows the cursors; it changes no document
+ * and is never played itself. Without a cursor on screen it shows nothing and says so.
+ */
+export declare function createPlaybackToolProvider(playback: AgentPlayback, options?: PlaybackToolProviderOptions): AgentToolProvider;

package/dist/video-editor/index.cjs

@@ -150,7 +150,7 @@ require('../chunk-WOFXZ3XU.cjs');
 var _chunkFJ2MSI43cjs = require('../chunk-FJ2MSI43.cjs');
 
 
-var _chunkSVR5FR7Bcjs = require('../chunk-SVR5FR7B.cjs');
+var _chunkUUTTJK77cjs = require('../chunk-UUTTJK77.cjs');
 require('../chunk-DWJJI6RT.cjs');
 require('../chunk-5FXOR7F2.cjs');
 require('../chunk-A6QWKBJP.cjs');
@@ -2807,7 +2807,7 @@ var VideoEditorController = (_class6 = class {
     this.readOnly = _nullishCoalesce(options.readOnly, () => ( false));
     this.previewScale = checkPreviewScale(_nullishCoalesce(options.previewScale, () => ( "auto")));
     this.onChange = options.onChange;
-    this.player = new (0, _chunkSVR5FR7Bcjs.AnimationPlayer)({ clock: options.clock, duration: () => _chunkVKF3PWKRcjs.videoProjectDuration.call(void 0, this.project), loop: "none" });
+    this.player = new (0, _chunkUUTTJK77cjs.AnimationPlayer)({ clock: options.clock, duration: () => _chunkVKF3PWKRcjs.videoProjectDuration.call(void 0, this.project), loop: "none" });
     this.state = this.computeState();
     this.connect();
   }

package/dist/video-editor/index.js

@@ -150,7 +150,7 @@ import {
 } from "../chunk-RNSANXPT.js";
 import {
   AnimationPlayer
-} from "../chunk-I4T4J27S.js";
+} from "../chunk-QX25HWFL.js";
 import "../chunk-5UJHB3BW.js";
 import "../chunk-45VRG4RB.js";
 import "../chunk-2WPNAGHI.js";

package/package.json

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

package/skills/pixerate-agent-tools/SKILL.md

@@ -65,7 +65,8 @@ editor's, or (in discovery mode) only `list_toolsets`, `search_tools`, `enable_t
 
 The host may act your calls out on screen (agent playback): your cursor glides to what a call
 names, presses, drags or types, and the change lands as one undo step. Results are the same with
-or without it, and calls simply take a little longer while it plays.
+or without it, and calls simply take a little longer while it plays. Only changes play by
+default: reads return at once and do not move your cursor.
 
 - Do not add waits or poll for the animation; each call returns once its change is applied.
 - Name your targets with the ids read tools return (`ids`, `nodeId`, `layerId`, a range). They are
@@ -73,6 +74,10 @@ or without it, and calls simply take a little longer while it plays.
 - A batch (`run_commands`) plays its steps' moves first, then applies once as one undo step.
 - If you connect over MCP, your client's name labels your cursor; several agents get separate
   cursors.
+- If the host registers `say`, use it sparingly to tell the user why, before a change that
+  is not obvious from the cursor alone (one short sentence). It shows beside your cursor on the
+  editor you last changed, so call it after your first write there; `shown: false` means no
+  cursor was on screen, which is fine: carry on. Never call it instead of doing the work.
 
 ## Errors
 
@@ -102,6 +107,7 @@ Never repeat an identical failing call. Never work around a read-only refusal; t
 | `list_commands` | Discover the commands an editor registers: id, label, group, params JSON Schema, shortcuts, and whether each is enabled now (with the reason when it is not). Filter with `query`; pass `enabledOnly: true` to see only what you can run now. |
 | `run_command` | Run one command by `id` with `params` matching its schema. Disabled commands and unknown params fail with a reason; read it before retrying. |
 | `run_commands` | Run several commands in order as `steps`. A param string `"$0.id"` or `"$last.id"` is replaced by that path of an earlier step's result, so a step can use an id an earlier step created. Pass `atomic: true` and a `label` to make the batch one undo step that rolls back entirely on failure; without it, steps before a failure stay applied. |
+| `say` | Optional; only where the host shows your cursor. Put one short sentence (`text`, at most 200 characters) in the bubble beside your cursor so the user can follow why you are about to change something. Returns `shown` and the `surface` it appeared on (`shown: false`, `surface: null` when no cursor is on screen, which is not an error). Call it after a write on that editor, before the next one. Changes nothing. |
 
 ## Commands
 

package/skills/pixerate-animation-editor/SKILL.md

@@ -36,6 +36,9 @@ The full command vocabulary (every type, option and default) is in
    `move_command`, `delete_commands`. Use `write_animation` only to replace every shot.
    For a command type you have not written before, `describe_animation_command` returns its
    exact fields first.
+   For motion that should feel performed rather than keyed (a hand-drawn swoop, a jittery
+   drag, a colour picked mid-move), `record_animation_take` with timed samples records it as
+   one shot, the way a person records live on the stage.
 4. **Fit and cue.** `fit_animation` to hit a length (keep shots whose pace matters). For music
    or voiceover, `set_animation_settings` with `beat` or `narration`, read cues with
    `get_timing_grid`, and give shots `"at": { "beat": n }` or `{ "word": i }`.
@@ -68,6 +71,12 @@ The full command vocabulary (every type, option and default) is in
   `"with": "previous"` plus a small `delay` so it trails the lead.
 - **Arcs.** Natural movement curves: use `move` with `via` waypoints (one smooth path) instead
   of chained moves that stop at each point, or `follow` a path node.
+- **Recorded takes.** Sample a performance at 30-60 per second; the recorder keeps only the
+  points that matter (raise `tolerance` for fewer, cleaner commands). Begin each moving
+  element with a sample at its current pose (`get_motion_path`'s last point, or its bounds'
+  centre at rest) or it jumps there at its first sample. A take is a new shot after the others
+  (or at `at`); it cannot be layered over an existing shot. Refine it like any shot: it is
+  ordinary `move` (with `via` and `times`), `scale`, `rotate`, `fade` and `style` commands.
 - **Hold long enough to read.** Leave each result on screen (shot `hold`, default 600 ms);
   roughly 250 ms per word for text that must be read, longer for the final frame or logo.
 - **Exaggeration with restraint.** Emphasis (`pulse`, `shake`, `teeter`, `color-pulse`) is for
@@ -111,6 +120,7 @@ The full command vocabulary (every type, option and default) is in
 | `set_animation_drivers` | Replace all drivers (empty list clears): a target's `x`, `y`, `rotation`, `scaleX`, `scaleY` or `opacity` follows a source node's property as change · `factor` + `offset`, optionally `clamp`ed. For parallax, wheels that turn as they roll, shadows that fade as something rises. |
 | `set_animation_clip` | Define, replace or (with `clip: null`) delete a named reusable clip whose `run` targets `"$"`; play it with a `play` command on any nodes. Prefer a clip over repeated identical commands. |
 | `copy_animation` | Give the nodes in `to` every command that animates `from` (all shots or `shots`), each copy starting with its original, optionally `stagger`ed (ms). Quick for one-off duplication; use a clip for motion you will reuse. |
+| `record_animation_take` | Record performed motion as a new shot (one undo step): `samples` of `{ node, t (ms into the take), x, y (centre), scaleX, scaleY, rotation, opacity, fill, stroke, strokeWidth }` become a `move` through waypoints at the recorded `times` and a few eased `scale` / `rotate` / `fade` / `style` commands, each starting when it happened. Optional `length`, `id`, `label`, `at`, `tolerance`; `dry_run: true` returns the run first. Returns the shot id, its start and each command's index, type, start and end; `check_animation` and `render_animation_frame` after. |
 | `fit_animation` | Make the scene last `seconds` by setting shot `speed`, keeping proportions; shots in `keep` play as written. `dry_run: true` reports the new length and speeds first. |
 | `import_flair_effect` | Replace the whole scene with a Flair vector `effect` or SvgMotion `motion` (give exactly one; optional `name`). Placeholders become colour controls; each Flair step becomes a shot. Use `dry_run: true` first. |
 | `insert_shots` | Add one or more complete shots (`id`, `run`, optional `label`, `camera`, `hold`, `speed`, `at`) at position `at` (default the end). Returns every shot's timing and issues. |

package/skills/pixerate-animation-editor/references/commands.md

@@ -56,7 +56,9 @@ camera move 1000.
 
 - `move`: `by` { x, y } offset or `to` { x, y } for the centre. `via`: up to 64 waypoints the
   centre passes through smoothly without overshoot; `pacing` `even` (default, steady speed)
-  or `equal` (same time per stretch). `blend` default replace.
+  or `equal` (same time per stretch). `times`: one rising fraction of the duration (0-1) per
+  waypoint, when the centre passes it; overrides `pacing` (recorded takes set it).
+  `blend` default replace.
 - `rotate`: `by` degrees or `to` degrees from rest. `blend` default replace.
 - `scale`: `to` a factor or { x, y } (required); `geometric: true` for an even-rate zoom.
 - `fade`: `to` opacity 0-1 (required).