@pixerate/editor 0.227.1 → 0.228.1

package/dist/commands/index.cjs

@@ -9,7 +9,7 @@
 
 
 
-var _chunk53GOGBTMcjs = require('../chunk-53GOGBTM.cjs');
+var _chunkCHAWTXBEcjs = require('../chunk-CHAWTXBE.cjs');
 
 
 
@@ -27,7 +27,7 @@ var _chunk53GOGBTMcjs = require('../chunk-53GOGBTM.cjs');
 
 
 
-var _chunk4EFNS2HVcjs = require('../chunk-4EFNS2HV.cjs');
+var _chunkT7QSEKDYcjs = require('../chunk-T7QSEKDY.cjs');
 
 
 var _chunk3SLBXKAWcjs = require('../chunk-3SLBXKAW.cjs');
@@ -77,7 +77,7 @@ var CommandRegistry = (_class = class {
   __init4() {this.muted = false}
   constructor(options = {}) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);_class.prototype.__init3.call(this);_class.prototype.__init4.call(this);
     this.options = options;
-    this.shortcuts = new (0, _chunk4EFNS2HVcjs.ShortcutMap)([], options.shortcuts);
+    this.shortcuts = new (0, _chunkT7QSEKDYcjs.ShortcutMap)([], options.shortcuts);
     this.shortcuts.subscribe(() => {
       if (!this.muted) this.notify();
     });
@@ -110,7 +110,7 @@ var CommandRegistry = (_class = class {
       }
       seen.add(s.id);
     }
-    const bindings = specs.map((s) => _chunk4EFNS2HVcjs.toShortcutBindings.call(void 0, s.id, s.shortcut, s.scope));
+    const bindings = specs.map((s) => _chunkT7QSEKDYcjs.toShortcutBindings.call(void 0, s.id, s.shortcut, s.scope));
     const unbinds = [];
     this.muted = true;
     try {
@@ -437,7 +437,7 @@ function createCommandPaletteController(registry, options = {}) {
       id: ranked.entry.id,
       label: ranked.entry.label,
       ...ranked.entry.group !== void 0 ? { group: ranked.entry.group } : {},
-      ...ranked.entry.shortcuts[0] ? { shortcut: _chunk4EFNS2HVcjs.formatShortcut.call(void 0, ranked.entry.shortcuts[0], platform) } : {},
+      ...ranked.entry.shortcuts[0] ? { shortcut: _chunkT7QSEKDYcjs.formatShortcut.call(void 0, ranked.entry.shortcuts[0], platform) } : {},
       enabled: ranked.entry.enabled,
       ...ranked.entry.disabledReason ? { disabledReason: ranked.entry.disabledReason } : {}
     }));
@@ -556,7 +556,7 @@ function createCommandPaletteController(registry, options = {}) {
   return controller;
 }
 function matchPaletteHotkey(event, hotkey, platform) {
-  const map = new (0, _chunk4EFNS2HVcjs.ShortcutMap)([{ command: "palette", chord: hotkey, allowInEditable: true }], platform ? { platform } : {});
+  const map = new (0, _chunkT7QSEKDYcjs.ShortcutMap)([{ command: "palette", chord: hotkey, allowInEditable: true }], platform ? { platform } : {});
   return map.resolve(event) !== null;
 }
 
@@ -806,13 +806,27 @@ function createCommandToolProvider(registry, options = {}) {
       return failed > 0 ? { isError: true, content: [{ type: "text", text: JSON.stringify(summary) }], structuredContent: summary } : summary;
     }
   };
+  const picked = (id) => typeof options.tools === "function" ? options.tools(id) : !!_optionalChain([options, 'access', _26 => _26.tools, 'optionalAccess', _27 => _27.includes, 'call', _28 => _28(id)]);
+  const toolNameOf = (id) => _nullishCoalesce(_optionalChain([options, 'access', _29 => _29.toolName, 'optionalCall', _30 => _30(id)]), () => ( id.replace(/[^A-Za-z0-9_-]/g, "_")));
+  const commandTool = (entry) => ({
+    name: toolNameOf(entry.id),
+    title: entry.label,
+    description: `${_nullishCoalesce(entry.description, () => ( entry.label))}${entry.readOnly ? "" : ` (Runs the "${entry.id}" command; refused with the reason when it cannot run now.)`}`,
+    inputSchema: _nullishCoalesce(entry.params, () => ( { type: "object", properties: {}, additionalProperties: false })),
+    annotations: { title: entry.label, readOnlyHint: entry.readOnly, destructiveHint: !entry.readOnly, idempotentHint: entry.readOnly, openWorldHint: false },
+    plan: (args) => planOne(entry.id, args),
+    handler: async (args) => {
+      const result = await runOne(entry.id, args);
+      return result.ok ? toJson(result.result) : errorResult(result);
+    }
+  });
   return {
     id: _nullishCoalesce(options.id, () => ( "commands")),
     namespace: options.namespace,
     title: "Commands",
     description: "The app's commands (menu and keyboard actions) with their params schemas: list them, run one, or run several as one undo step.",
     skill: "pixerate-agent-tools",
-    tools: () => [listCommands, runCommandTool(), runCommands],
+    tools: () => [listCommands, runCommandTool(), runCommands, ...options.tools ? visible().filter((e) => picked(e.id)).map(commandTool) : []],
     subscribe: (notify) => registry.subscribe(notify)
   };
 }
@@ -895,7 +909,7 @@ function createCanvasAnimationCommands(controller, options = {}) {
           time: { type: "number", minimum: 0, description: "Time in ms (default: the playhead)." }
         }
       },
-      run: (_ctx, params) => controller.addKeyframe(_optionalChain([params, 'optionalAccess', _26 => _26.ids]), _optionalChain([params, 'optionalAccess', _27 => _27.properties]), _optionalChain([params, 'optionalAccess', _28 => _28.time]))
+      run: (_ctx, params) => controller.addKeyframe(_optionalChain([params, 'optionalAccess', _31 => _31.ids]), _optionalChain([params, 'optionalAccess', _32 => _32.properties]), _optionalChain([params, 'optionalAccess', _33 => _33.time]))
     },
     {
       ...base,
@@ -1029,4 +1043,4 @@ function createCanvasAnimationCommands(controller, options = {}) {
 
 
 
-exports.CommandRegistry = CommandRegistry; exports.CommandRegistryError = CommandRegistryError; exports.DEFAULT_HISTORY_SHORTCUTS = _chunk53GOGBTMcjs.DEFAULT_HISTORY_SHORTCUTS; exports.DEFAULT_RECENT_LIMIT = DEFAULT_RECENT_LIMIT; exports.PLATFORMS = _chunk4EFNS2HVcjs.PLATFORMS; exports.ShortcutMap = _chunk4EFNS2HVcjs.ShortcutMap; exports.chordToString = _chunk4EFNS2HVcjs.chordToString; exports.codeFromKey = _chunk4EFNS2HVcjs.codeFromKey; exports.codeToKeyText = _chunk4EFNS2HVcjs.codeToKeyText; exports.createArrangeCommands = _chunk53GOGBTMcjs.createArrangeCommands; exports.createCanvasAnimationCommands = createCanvasAnimationCommands; exports.createCommandPaletteController = createCommandPaletteController; exports.createCommandRegistry = createCommandRegistry; exports.createCommandToolProvider = createCommandToolProvider; exports.createComponentCommands = _chunk53GOGBTMcjs.createComponentCommands; exports.createDrawCommands = _chunk53GOGBTMcjs.createDrawCommands; exports.createFormatCommands = _chunkVCL7CB56cjs.createFormatCommands; exports.createHistoryCommands = _chunk53GOGBTMcjs.createHistoryCommands; exports.createShapeCommands = _chunk53GOGBTMcjs.createShapeCommands; exports.createSpreadsheetCommands = _chunk53GOGBTMcjs.createSpreadsheetCommands; exports.defineCommand = defineCommand; exports.detectPlatform = _chunk4EFNS2HVcjs.detectPlatform; exports.effectiveChord = _chunk4EFNS2HVcjs.effectiveChord; exports.effectiveChordKey = _chunk4EFNS2HVcjs.effectiveChordKey; exports.eventCode = _chunk4EFNS2HVcjs.eventCode; exports.exactBonus = exactBonus; exports.formatCommandsFor = _chunkVCL7CB56cjs.formatCommandsFor; exports.formatShortcut = _chunk4EFNS2HVcjs.formatShortcut; exports.fuzzyMatch = fuzzyMatch; exports.fuzzyScore = fuzzyScore; exports.hasVariantCommands = _chunk53GOGBTMcjs.hasVariantCommands; exports.isEditableEventTarget = _chunk4EFNS2HVcjs.isEditableEventTarget; exports.keyToCode = _chunk4EFNS2HVcjs.keyToCode; exports.matchHistoryShortcut = _chunk53GOGBTMcjs.matchHistoryShortcut; exports.matchPaletteHotkey = matchPaletteHotkey; exports.normalizeChord = _chunk4EFNS2HVcjs.normalizeChord; exports.parseChord = _chunk4EFNS2HVcjs.parseChord; exports.planFreehandPlayback = _chunk53GOGBTMcjs.planFreehandPlayback; exports.pushRecent = pushRecent; exports.rankCommands = rankCommands; exports.shortcutCode = _chunk4EFNS2HVcjs.shortcutCode; exports.toShortcutBindings = _chunk4EFNS2HVcjs.toShortcutBindings;
+exports.CommandRegistry = CommandRegistry; exports.CommandRegistryError = CommandRegistryError; exports.DEFAULT_HISTORY_SHORTCUTS = _chunkCHAWTXBEcjs.DEFAULT_HISTORY_SHORTCUTS; exports.DEFAULT_RECENT_LIMIT = DEFAULT_RECENT_LIMIT; exports.PLATFORMS = _chunkT7QSEKDYcjs.PLATFORMS; exports.ShortcutMap = _chunkT7QSEKDYcjs.ShortcutMap; exports.chordToString = _chunkT7QSEKDYcjs.chordToString; exports.codeFromKey = _chunkT7QSEKDYcjs.codeFromKey; exports.codeToKeyText = _chunkT7QSEKDYcjs.codeToKeyText; exports.createArrangeCommands = _chunkCHAWTXBEcjs.createArrangeCommands; exports.createCanvasAnimationCommands = createCanvasAnimationCommands; exports.createCommandPaletteController = createCommandPaletteController; exports.createCommandRegistry = createCommandRegistry; exports.createCommandToolProvider = createCommandToolProvider; exports.createComponentCommands = _chunkCHAWTXBEcjs.createComponentCommands; exports.createDrawCommands = _chunkCHAWTXBEcjs.createDrawCommands; exports.createFormatCommands = _chunkVCL7CB56cjs.createFormatCommands; exports.createHistoryCommands = _chunkCHAWTXBEcjs.createHistoryCommands; exports.createShapeCommands = _chunkCHAWTXBEcjs.createShapeCommands; exports.createSpreadsheetCommands = _chunkCHAWTXBEcjs.createSpreadsheetCommands; exports.defineCommand = defineCommand; exports.detectPlatform = _chunkT7QSEKDYcjs.detectPlatform; exports.effectiveChord = _chunkT7QSEKDYcjs.effectiveChord; exports.effectiveChordKey = _chunkT7QSEKDYcjs.effectiveChordKey; exports.eventCode = _chunkT7QSEKDYcjs.eventCode; exports.exactBonus = exactBonus; exports.formatCommandsFor = _chunkVCL7CB56cjs.formatCommandsFor; exports.formatShortcut = _chunkT7QSEKDYcjs.formatShortcut; exports.fuzzyMatch = fuzzyMatch; exports.fuzzyScore = fuzzyScore; exports.hasVariantCommands = _chunkCHAWTXBEcjs.hasVariantCommands; exports.isEditableEventTarget = _chunkT7QSEKDYcjs.isEditableEventTarget; exports.keyToCode = _chunkT7QSEKDYcjs.keyToCode; exports.matchHistoryShortcut = _chunkCHAWTXBEcjs.matchHistoryShortcut; exports.matchPaletteHotkey = matchPaletteHotkey; exports.normalizeChord = _chunkT7QSEKDYcjs.normalizeChord; exports.parseChord = _chunkT7QSEKDYcjs.parseChord; exports.planFreehandPlayback = _chunkCHAWTXBEcjs.planFreehandPlayback; exports.pushRecent = pushRecent; exports.rankCommands = rankCommands; exports.shortcutCode = _chunkT7QSEKDYcjs.shortcutCode; exports.toShortcutBindings = _chunkT7QSEKDYcjs.toShortcutBindings;

package/dist/commands/index.js

@@ -9,7 +9,7 @@ import {
   hasVariantCommands,
   matchHistoryShortcut,
   planFreehandPlayback
-} from "../chunk-ZPJEH456.js";
+} from "../chunk-XVIK73LS.js";
 import {
   PLATFORMS,
   ShortcutMap,
@@ -27,7 +27,7 @@ import {
   parseChord,
   shortcutCode,
   toShortcutBindings
-} from "../chunk-7KZ2HKKC.js";
+} from "../chunk-LPFQHVCO.js";
 import {
   derivePlaybackSteps
 } from "../chunk-EHTX34RE.js";
@@ -806,13 +806,27 @@ function createCommandToolProvider(registry, options = {}) {
       return failed > 0 ? { isError: true, content: [{ type: "text", text: JSON.stringify(summary) }], structuredContent: summary } : summary;
     }
   };
+  const picked = (id) => typeof options.tools === "function" ? options.tools(id) : !!options.tools?.includes(id);
+  const toolNameOf = (id) => options.toolName?.(id) ?? id.replace(/[^A-Za-z0-9_-]/g, "_");
+  const commandTool = (entry) => ({
+    name: toolNameOf(entry.id),
+    title: entry.label,
+    description: `${entry.description ?? entry.label}${entry.readOnly ? "" : ` (Runs the "${entry.id}" command; refused with the reason when it cannot run now.)`}`,
+    inputSchema: entry.params ?? { type: "object", properties: {}, additionalProperties: false },
+    annotations: { title: entry.label, readOnlyHint: entry.readOnly, destructiveHint: !entry.readOnly, idempotentHint: entry.readOnly, openWorldHint: false },
+    plan: (args) => planOne(entry.id, args),
+    handler: async (args) => {
+      const result = await runOne(entry.id, args);
+      return result.ok ? toJson(result.result) : errorResult(result);
+    }
+  });
   return {
     id: options.id ?? "commands",
     namespace: options.namespace,
     title: "Commands",
     description: "The app's commands (menu and keyboard actions) with their params schemas: list them, run one, or run several as one undo step.",
     skill: "pixerate-agent-tools",
-    tools: () => [listCommands, runCommandTool(), runCommands],
+    tools: () => [listCommands, runCommandTool(), runCommands, ...options.tools ? visible().filter((e) => picked(e.id)).map(commandTool) : []],
     subscribe: (notify) => registry.subscribe(notify)
   };
 }

package/dist/tools/index.cjs

@@ -13,7 +13,7 @@
 
 
 
-var _chunkVXLYEYP4cjs = require('../chunk-VXLYEYP4.cjs');
+var _chunk4I76OCVDcjs = require('../chunk-4I76OCVD.cjs');
 
 
 
@@ -39,7 +39,7 @@ var _chunkVXLYEYP4cjs = require('../chunk-VXLYEYP4.cjs');
 
 
 
-var _chunkZ7BVK32Ccjs = require('../chunk-Z7BVK32C.cjs');
+var _chunkRTPBM46Fcjs = require('../chunk-RTPBM46F.cjs');
 
 
 
@@ -199,4 +199,4 @@ var _chunk2BSBFBOAcjs = require('../chunk-2BSBFBOA.cjs');
 
 
 
-exports.AgentPlayback = _chunk3SLBXKAWcjs.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 = _chunkZ7BVK32Ccjs.JSON_RPC_ERRORS; exports.MCP_PROTOCOL_VERSIONS = _chunkZ7BVK32Ccjs.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 = _chunkK7ENM55Pcjs.PRESENCE_COLORS; exports.PerformanceQueue = _chunkK7ENM55Pcjs.PerformanceQueue; exports.PresenceStore = _chunkK7ENM55Pcjs.PresenceStore; exports.TOOL_BRIDGE_DEFAULT_PORT = _chunkZ7BVK32Ccjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkZ7BVK32Ccjs.TOOL_BRIDGE_PROTOCOL; exports.TOOL_DISCOVERY_TOOLS = _chunkZ7BVK32Ccjs.TOOL_DISCOVERY_TOOLS; exports.TOOL_NAMESPACE_SEPARATOR = _chunkZ7BVK32Ccjs.TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = _chunkZ7BVK32Ccjs.ToolRegistry; exports.ToolRegistryError = _chunkZ7BVK32Ccjs.ToolRegistryError; exports.ToolRegistryView = _chunkZ7BVK32Ccjs.ToolRegistryView; exports.UNSAFE_JSON_KEYS = _chunk2BSBFBOAcjs.UNSAFE_JSON_KEYS; exports.baseToolName = _chunkZ7BVK32Ccjs.baseToolName; exports.callEvalTool = _chunkVXLYEYP4cjs.callEvalTool; exports.captureInputSchema = _chunkN2FGYZ4Qcjs.captureInputSchema; exports.captureOutputSize = _chunkN2FGYZ4Qcjs.captureOutputSize; exports.cloneElementWithStyles = _chunkSVFEVKLFcjs.cloneElementWithStyles; exports.connectToolBridge = _chunkZ7BVK32Ccjs.connectToolBridge; exports.createAgentPlayback = _chunk3SLBXKAWcjs.createAgentPlayback; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createInstantPresenceClock = _chunkK7ENM55Pcjs.createInstantPresenceClock; exports.createMcpServer = _chunkZ7BVK32Ccjs.createMcpServer; exports.createPlaybackToolProvider = _chunk3SLBXKAWcjs.createPlaybackToolProvider; exports.createStyleResolver = _chunkVXLYEYP4cjs.createStyleResolver; exports.createStyleToolProvider = _chunkVXLYEYP4cjs.createStyleToolProvider; exports.createToolRegistry = _chunkZ7BVK32Ccjs.createToolRegistry; exports.derivePlaybackSteps = _chunk3SLBXKAWcjs.derivePlaybackSteps; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkZ7BVK32Ccjs.errorResult; exports.failedEvalChecks = _chunkVXLYEYP4cjs.failedEvalChecks; exports.imageEvalFixturePixels = _chunkVXLYEYP4cjs.imageEvalFixturePixels; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkillEvals = _chunkVXLYEYP4cjs.listSkillEvals; exports.listSkills = _chunkZ7BVK32Ccjs.listSkills; exports.locatePlaybackChrome = _chunk3SLBXKAWcjs.locatePlaybackChrome; exports.matchesEvalExpectation = _chunkVXLYEYP4cjs.matchesEvalExpectation; exports.memoryStyleStore = _chunkVXLYEYP4cjs.memoryStyleStore; exports.parseSkillFrontmatter = _chunkZ7BVK32Ccjs.parseSkillFrontmatter; exports.parseStyleDomains = _chunkVXLYEYP4cjs.parseStyleDomains; exports.playbackRectFromClient = _chunk3SLBXKAWcjs.playbackRectFromClient; exports.playbackRefsFromArgs = _chunk3SLBXKAWcjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunk3SLBXKAWcjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkZ7BVK32Ccjs.readSkillFile; exports.readingTime = _chunk3SLBXKAWcjs.readingTime; exports.realPresenceClock = _chunkK7ENM55Pcjs.realPresenceClock; exports.renderStyle = _chunkVXLYEYP4cjs.renderStyle; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.runStyleChecks = _chunkVXLYEYP4cjs.runStyleChecks; exports.runToolScript = _chunkVXLYEYP4cjs.runToolScript; exports.searchTokens = _chunkZ7BVK32Ccjs.searchTokens; exports.searchTools = _chunkZ7BVK32Ccjs.searchTools; exports.stripPrototypeKeys = _chunk2BSBFBOAcjs.stripPrototypeKeys; exports.summarize = _chunkZ7BVK32Ccjs.summarize; exports.toCapturedImageData = _chunkN2FGYZ4Qcjs.toCapturedImageData; exports.toToolResult = _chunkZ7BVK32Ccjs.toToolResult; exports.toolResultError = _chunkVXLYEYP4cjs.toolResultError; exports.toolResultValue = _chunkVXLYEYP4cjs.toolResultValue; exports.toolsetInstructions = _chunkZ7BVK32Ccjs.toolsetInstructions; exports.toolsetName = _chunkZ7BVK32Ccjs.toolsetName; exports.trackPresenceDrag = _chunkK7ENM55Pcjs.trackPresenceDrag; exports.tweenPresenceCursor = _chunkK7ENM55Pcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunk3SLBXKAWcjs.unionRects; exports.unknownToolMessage = _chunkZ7BVK32Ccjs.unknownToolMessage; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;
+exports.AgentPlayback = _chunk3SLBXKAWcjs.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 = _chunkRTPBM46Fcjs.JSON_RPC_ERRORS; exports.MCP_PROTOCOL_VERSIONS = _chunkRTPBM46Fcjs.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 = _chunkK7ENM55Pcjs.PRESENCE_COLORS; exports.PerformanceQueue = _chunkK7ENM55Pcjs.PerformanceQueue; exports.PresenceStore = _chunkK7ENM55Pcjs.PresenceStore; exports.TOOL_BRIDGE_DEFAULT_PORT = _chunkRTPBM46Fcjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkRTPBM46Fcjs.TOOL_BRIDGE_PROTOCOL; exports.TOOL_DISCOVERY_TOOLS = _chunkRTPBM46Fcjs.TOOL_DISCOVERY_TOOLS; exports.TOOL_NAMESPACE_SEPARATOR = _chunkRTPBM46Fcjs.TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = _chunkRTPBM46Fcjs.ToolRegistry; exports.ToolRegistryError = _chunkRTPBM46Fcjs.ToolRegistryError; exports.ToolRegistryView = _chunkRTPBM46Fcjs.ToolRegistryView; exports.UNSAFE_JSON_KEYS = _chunk2BSBFBOAcjs.UNSAFE_JSON_KEYS; exports.baseToolName = _chunkRTPBM46Fcjs.baseToolName; exports.callEvalTool = _chunk4I76OCVDcjs.callEvalTool; exports.captureInputSchema = _chunkN2FGYZ4Qcjs.captureInputSchema; exports.captureOutputSize = _chunkN2FGYZ4Qcjs.captureOutputSize; exports.cloneElementWithStyles = _chunkSVFEVKLFcjs.cloneElementWithStyles; exports.connectToolBridge = _chunkRTPBM46Fcjs.connectToolBridge; exports.createAgentPlayback = _chunk3SLBXKAWcjs.createAgentPlayback; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createInstantPresenceClock = _chunkK7ENM55Pcjs.createInstantPresenceClock; exports.createMcpServer = _chunkRTPBM46Fcjs.createMcpServer; exports.createPlaybackToolProvider = _chunk3SLBXKAWcjs.createPlaybackToolProvider; exports.createStyleResolver = _chunk4I76OCVDcjs.createStyleResolver; exports.createStyleToolProvider = _chunk4I76OCVDcjs.createStyleToolProvider; exports.createToolRegistry = _chunkRTPBM46Fcjs.createToolRegistry; exports.derivePlaybackSteps = _chunk3SLBXKAWcjs.derivePlaybackSteps; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkRTPBM46Fcjs.errorResult; exports.failedEvalChecks = _chunk4I76OCVDcjs.failedEvalChecks; exports.imageEvalFixturePixels = _chunk4I76OCVDcjs.imageEvalFixturePixels; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkillEvals = _chunk4I76OCVDcjs.listSkillEvals; exports.listSkills = _chunkRTPBM46Fcjs.listSkills; exports.locatePlaybackChrome = _chunk3SLBXKAWcjs.locatePlaybackChrome; exports.matchesEvalExpectation = _chunk4I76OCVDcjs.matchesEvalExpectation; exports.memoryStyleStore = _chunk4I76OCVDcjs.memoryStyleStore; exports.parseSkillFrontmatter = _chunkRTPBM46Fcjs.parseSkillFrontmatter; exports.parseStyleDomains = _chunk4I76OCVDcjs.parseStyleDomains; exports.playbackRectFromClient = _chunk3SLBXKAWcjs.playbackRectFromClient; exports.playbackRefsFromArgs = _chunk3SLBXKAWcjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunk3SLBXKAWcjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkRTPBM46Fcjs.readSkillFile; exports.readingTime = _chunk3SLBXKAWcjs.readingTime; exports.realPresenceClock = _chunkK7ENM55Pcjs.realPresenceClock; exports.renderStyle = _chunk4I76OCVDcjs.renderStyle; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.runStyleChecks = _chunk4I76OCVDcjs.runStyleChecks; exports.runToolScript = _chunk4I76OCVDcjs.runToolScript; exports.searchTokens = _chunkRTPBM46Fcjs.searchTokens; exports.searchTools = _chunkRTPBM46Fcjs.searchTools; exports.stripPrototypeKeys = _chunk2BSBFBOAcjs.stripPrototypeKeys; exports.summarize = _chunkRTPBM46Fcjs.summarize; exports.toCapturedImageData = _chunkN2FGYZ4Qcjs.toCapturedImageData; exports.toToolResult = _chunkRTPBM46Fcjs.toToolResult; exports.toolResultError = _chunk4I76OCVDcjs.toolResultError; exports.toolResultValue = _chunk4I76OCVDcjs.toolResultValue; exports.toolsetInstructions = _chunkRTPBM46Fcjs.toolsetInstructions; exports.toolsetName = _chunkRTPBM46Fcjs.toolsetName; exports.trackPresenceDrag = _chunkK7ENM55Pcjs.trackPresenceDrag; exports.tweenPresenceCursor = _chunkK7ENM55Pcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunk3SLBXKAWcjs.unionRects; exports.unknownToolMessage = _chunkRTPBM46Fcjs.unknownToolMessage; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;

package/dist/tools/index.js

@@ -13,7 +13,7 @@ import {
   runToolScript,
   toolResultError,
   toolResultValue
-} from "../chunk-H73MSHYZ.js";
+} from "../chunk-QTMQ5TGA.js";
 import {
   JSON_RPC_ERRORS,
   MCP_PROTOCOL_VERSIONS,
@@ -39,7 +39,7 @@ import {
   toolsetInstructions,
   toolsetName,
   unknownToolMessage
-} from "../chunk-SAN4SBBS.js";
+} from "../chunk-ABHOYBZD.js";
 import {
   AgentPlayback,
   createAgentPlayback,

package/package.json

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

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

@@ -165,6 +165,11 @@ Never repeat an identical failing call. Never work around a read-only refusal; t
 | `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. |
 
+Some hosts also list chosen commands as tools of their own (for example `commands__canvas_circle`
+for `canvas.circle`), with the command's params as the tool's arguments and its description. Call
+those directly: they run the same command, are refused with the same reasons, and save a
+`list_commands` round trip.
+
 ## Commands
 
 These history commands are registered wherever a host shares a history with its command

package/skills/pixerate-canvas/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pixerate-canvas
-description: How to build and edit a Pixerate design canvas or node graph through its agent tools - drawing freehand pen, highlighter and dry-brush strokes (canvas.drawFreehand), adding, connecting, updating and laying out nodes (canvas_add_node, canvas_layout), reading state with get_editor_state and looking at it with view_editor, reusable components with variants, instances and overrides (create_component, add_variant, set_instance_properties), align, distribute, lock and layer order, shape boolean operations (unite, subtract, offset path, outline stroke), auto layout frames, and keyframe animation with easing and CSS export. Use when working on a canvas, whiteboard, flow chart, node graph, frame, design system, component library, button variants, layout, alignment, z-order or a canvas animation in a Pixerate editor.
+description: How to build and edit a Pixerate design canvas or node graph through its agent tools - drawing freehand pen, highlighter and dry-brush strokes (canvas.drawFreehand), annotating with hand-drawn circles, underlines, arrows, brackets, strikes, crosses and ticks (canvas.circle, canvas.arrow), adding, connecting, updating and laying out nodes (canvas_add_node, canvas_layout), reading state with get_editor_state and looking at it with view_editor, reusable components with variants, instances and overrides (create_component, add_variant, set_instance_properties), align, distribute, lock and layer order, shape boolean operations (unite, subtract, offset path, outline stroke), auto layout frames, and keyframe animation with easing and CSS export. Use when working on a canvas, whiteboard, flow chart, node graph, frame, design system, component library, button variants, layout, alignment, z-order or a canvas animation in a Pixerate editor.
 ---
 
 # Pixerate canvas
@@ -90,6 +90,21 @@ the pitfalls, and uses the tools below.
   pen are clean, the airbrush is a soft spray. The grain and jitter are seeded per stroke, so a
   stroke always looks the same, and neighbouring strokes share one sheet of paper. Pick the brush
   for the look, then the colour; for a sketch, use one or two brushes rather than all of them.
+- **Annotate with gestures, not points.** To mark up work the way a designer marks up a print,
+  use the gesture commands (`canvas.circle`, `canvas.underline`, `canvas.arrow`,
+  `canvas.bracket`, `canvas.strike`, `canvas.cross`, `canvas.check`) with node ids
+  (`{ "nodeId": "..." }`) or boxes, rather than working out points for `canvas.drawFreehand`. One
+  call draws one hand-drawn mark. An annotation helps when you are pointing at something on the
+  canvas while you talk about it: circle the pick, underline the line that matters, draw an
+  arrow from a swatch to where it is used, bracket a group you are describing, strike or cross
+  out a rejected option, tick an approved one. Skip it when nothing on the canvas is being
+  referred to, and keep it to a few marks per point: a page covered in marks says nothing.
+- **Gesture style.** Use one colour for one review pass (a red or a strong blue pen reads as
+  markup over most designs), the highlighter only for circles and underlines, and the same
+  `brush` (`marker` or `ink-pen`) for every mark of a pass if you want them to look hand-drawn.
+  Marks are seeded by their request, so asking again draws the same mark; pass another `seed`
+  for a different take. Put a margin note (a text node) beside a bracket or at an arrow's tail
+  when the mark needs words.
 
 ## Tool reference
 
@@ -215,7 +230,25 @@ character: seeded jitter and the paper grain they catch) and, when a width was c
 | Command | Use it to |
 | --- | --- |
 | `canvas.drawFreehand` | Draw a pen or highlighter stroke through `points` (`[x, y]` pairs in canvas units, in drawing order; one undo step). `tool` picks the defaults (`pen`: blue, width 3; `highlighter`: yellow, width 24, opacity 0.35); `color`, `width`, `opacity` override them (with a `brush`, `width` is the brush diameter and defaults to the preset's own size). Pass `brush` (a preset id from `canvas.listBrushes`, or tip settings) to paint it with a dry brush, plus `pressure` / `tiltX` / `tiltY` profiles spread along its length (`[0.2, 1, 0.3]` swells in the middle). Add `paint` (only with `brush`) for gradient paint that changes colour along the stroke: `{ "type": "gradient", "stops": [...], "map": { "by": "distance", "length": 200 } }` (length in canvas units), or `by` `pressure`, `tilt`, `direction`, `across-tip`, `random`. Returns the node `id`, its `bounds` and the stored `brush` (with `paint` normalised: defaults filled in, colours lowercased). |
-| `canvas.listBrushes` | Read-only: the dry paint presets `canvas.drawFreehand` accepts as `brush` (`id`, `name`, `category`, the preset's own `size`, which a stroke uses unless you pass `width`). Call it before the first brushed stroke instead of guessing ids. |
+| `canvas.listBrushes` | Read-only: the dry paint presets `canvas.drawFreehand` and the gestures accept as `brush` (`id`, `name`, `category`, the preset's own `size`, which a stroke uses unless you pass `width`). Call it before the first brushed stroke instead of guessing ids. |
+
+Gestures draw one hand-drawn stroke node each (one undo step) through the same path as
+`canvas.drawFreehand`, and the agent's cursor traces them. Targets are boxes
+`{ x, y, width, height }` in canvas units, nodes `{ nodeId }` (where the host can look nodes up)
+or, where noted, points `[x, y]`. Every gesture also takes `tool`, `color`, `width`, `opacity`,
+`brush` (brushed marks get an uneven hand pressure) and `seed` (default: derived from the
+request). Each returns the node `id`, its `bounds`, the `brush` when brushed and the `seed` used;
+pass the `id` to `canvas_remove_nodes` (or undo) to take a mark away.
+
+| Command | Use it to |
+| --- | --- |
+| `canvas.circle` | Circle the pick or the subject: `around` is a list of boxes or nodes, ringed together by a loose, slightly open ellipse that never cuts into them; `padding` (default 8) widens it. |
+| `canvas.underline` | Stress a line of text or a value: a stroke just under `under`'s bottom edge (`offset`, default 4), a little longer or shorter than it; `wave: true` for a squiggle. |
+| `canvas.arrow` | Point from one thing to another (a swatch to where it is used, a note to its subject): `from` and `to` are boxes, nodes or points; boxes are reached at their nearest edge, `gap` (default 6) clear of it. `curve` −1..1 bends the shaft (0 straight). Ends that overlap are refused. |
+| `canvas.bracket` | Group items or a range of lines: a curly (default) or `shape: "square"` bracket on one `side` (`left`, `right`, `top`, `bottom`) of `around`, spanning them end to end, `padding` (default 8) away; `depth` sets how far it reaches out. Add a note beside it. |
+| `canvas.strike` | Strike a line through the middle of `over` (text or a value to drop). It only marks it; nothing is deleted. |
+| `canvas.cross` | Cross out a rejected option with an X over `over`. One stroke, so the pen runs back over part of the first diagonal. Nothing is deleted. |
+| `canvas.check` | Tick an approved option or a done item: `at` is a box or node (ticked in its middle) or a point; `size` is the tick's height (default from the box, 20 at a point). |
 
 ### Components (command form)
 
@@ -301,6 +334,12 @@ effects provider (for example Flair); without one the read tools say so and the
   length near the stroke's to go from one end to the other once.
 - A canvas gradient in `color` does not reach the brush: a brushed stroke with a gradient
   `color` and no `paint` uses its first stop. Pass `paint` instead.
+- **Gestures need a lookup for node ids.** Where the host's draw target has no `nodeBounds`, a
+  `{ nodeId }` target is refused with that reason: pass the node's box from `get_editor_state`.
+  A point is refused where a box is needed (`around`, `under`, `over`).
+- **Gestures are marks, not edits.** A strike or a cross does not delete or change the node under
+  it, and a mark does not move with the node; take it away (`canvas_remove_nodes` with its `id`)
+  and draw it again after moving things.
 - **Shape operations drop the brush.** Unite, subtract, offset path and outline stroke turn
   brushed strokes into plain filled or stroked paths.
 - `canvas_*` tools validate ids against the current state; an "Unknown node id" error means call