@pixerate/editor 0.227.0 → 0.228.0

package/dist/{chunk-ZPJEH456.js → chunk-XVIK73LS.js}

@@ -1,7 +1,16 @@
 import {
   DEFAULT_ARRANGE_SHORTCUTS,
-  ShortcutMap
-} from "./chunk-7KZ2HKKC.js";
+  ShortcutMap,
+  arrowGesture,
+  bracketGesture,
+  checkGesture,
+  circleGesture,
+  crossGesture,
+  gestureSeed,
+  gestureUnion,
+  strikeGesture,
+  underlineGesture
+} from "./chunk-LPFQHVCO.js";
 
 // src/commands/builtins.ts
 var DEFAULT_HISTORY_SHORTCUTS = [
@@ -370,7 +379,202 @@ function createDrawCommands(target, options = {}) {
       params: { type: "object", additionalProperties: false, properties: {} },
       readOnly: true,
       run: async () => ({ brushes: await target.listBrushes() })
+    },
+    ...createGestureCommands(target, base, prefix, options)
+  ];
+}
+var GESTURE_RECT_PARAM = {
+  type: "object",
+  additionalProperties: false,
+  required: ["x", "y", "width", "height"],
+  description: "A box in canvas units (top left x, y and its size), e.g. a node's bounds from get_editor_state or a stroke's `bounds`.",
+  properties: {
+    x: { type: "number", description: "Left edge, canvas units." },
+    y: { type: "number", description: "Top edge, canvas units." },
+    width: { type: "number", minimum: 0, description: "Width, canvas units." },
+    height: { type: "number", minimum: 0, description: "Height, canvas units." }
+  }
+};
+var GESTURE_NODE_PARAM = {
+  type: "object",
+  additionalProperties: false,
+  required: ["nodeId"],
+  description: "A node on the canvas by id; its current box is used, so you need not read its position first.",
+  properties: { nodeId: { type: "string", minLength: 1, description: "The node id (from get_editor_state or a result)." } }
+};
+var GESTURE_POINT_PARAM = {
+  type: "array",
+  minItems: 2,
+  maxItems: 2,
+  items: { type: "number" },
+  description: "A point as [x, y] in canvas units."
+};
+var gestureBox = (what) => ({ description: what, oneOf: [GESTURE_RECT_PARAM, GESTURE_NODE_PARAM] });
+var gestureEnd = (what) => ({ description: what, oneOf: [GESTURE_RECT_PARAM, GESTURE_NODE_PARAM, GESTURE_POINT_PARAM] });
+var gestureBoxes = (what) => ({
+  type: "array",
+  minItems: 1,
+  maxItems: 100,
+  items: { oneOf: [GESTURE_RECT_PARAM, GESTURE_NODE_PARAM] },
+  description: `${what} Each is a box { x, y, width, height } or a node { nodeId }; the gesture spans the box around all of them.`
+});
+var GESTURE_STYLE_PARAMS = {
+  tool: { type: "string", enum: ["pen", "highlighter"], description: "Pen (default: blue, width 3) or highlighter (yellow, width 24, opacity 0.35); sets the defaults below." },
+  color: { type: "string", description: "Stroke colour, any CSS colour (default from the tool)." },
+  width: { type: "number", exclusiveMinimum: 0, maximum: 2500, description: "Stroke width in canvas units (default from the tool; with a brush, the preset's own size)." },
+  opacity: { type: "number", minimum: 0, maximum: 1, description: "Stroke opacity 0..1 (default from the tool)." },
+  brush: {
+    description: 'Paint the mark with a dry paint brush: a preset id such as "ink-pen", "marker", "pencil-hb" or "brush-pen" (all ids: canvas.listBrushes), or tip settings. Brushed marks get an uneven hand pressure. Omit for a plain vector stroke.',
+    oneOf: [{ type: "string", minLength: 1 }, BRUSH_SETTINGS_PARAM]
+  },
+  seed: { type: "integer", minimum: 0, maximum: 4294967295, description: "Seed for the hand-drawn wobble (default: derived from the other params, so the same request draws the same mark). Change it for a different take." }
+};
+function createGestureCommands(target, base, prefix, options) {
+  const box = (value, name) => {
+    if (Array.isArray(value)) throw new Error(`${name} must be a box { x, y, width, height } or a node { nodeId }, not a point.`);
+    if ("nodeId" in value) {
+      if (!target.nodeBounds) throw new Error(`This canvas cannot look up nodes: pass ${name} as a box { x, y, width, height } (a node's bounds from get_editor_state).`);
+      const rect = target.nodeBounds(value.nodeId);
+      if (!rect) throw new Error(`Unknown node "${value.nodeId}" in ${name}: use an id from get_editor_state.`);
+      return rect;
     }
+    return value;
+  };
+  const end = (value, name) => Array.isArray(value) ? [value[0], value[1]] : box(value, name);
+  const boxes = (values, name) => gestureUnion(values.map((v, i) => box(v, `${name}[${i}]`)));
+  const gesture = (spec) => {
+    const seedOf = (params) => params.seed ?? gestureSeed({ gesture: spec.name, ...params });
+    const generate = (params) => {
+      const seed = seedOf(params);
+      return { seed, stroke: spec.make(params, seed) };
+    };
+    return {
+      ...base,
+      id: `${prefix}${spec.name}`,
+      label: spec.label,
+      keywords: ["annotate", "mark up", "hand-drawn", ...spec.keywords],
+      description: `${spec.description} Drawn as one hand-drawn pen or highlighter stroke node (one undo step), with a seeded wobble. Returns the new node \`id\`, its \`bounds\`, the stored \`brush\` (when brushed) and the \`seed\` used.`,
+      params: {
+        type: "object",
+        additionalProperties: false,
+        required: spec.required,
+        properties: { ...spec.properties, ...GESTURE_STYLE_PARAMS }
+      },
+      enabled: () => options.readOnlyReason?.() || true,
+      plan: (_ctx, params) => {
+        try {
+          return planFreehandPlayback(generate(params).stroke.points);
+        } catch {
+          return null;
+        }
+      },
+      run: async (_ctx, params) => {
+        const { seed, stroke } = generate(params);
+        const result = await target.drawStroke({
+          points: stroke.points,
+          ...params.tool ? { tool: params.tool } : {},
+          style: {
+            ...params.color !== void 0 ? { color: params.color } : {},
+            ...params.width !== void 0 ? { width: params.width } : {},
+            ...params.width !== void 0 && params.brush !== void 0 ? { brushSize: params.width } : {},
+            ...params.opacity !== void 0 ? { opacity: params.opacity } : {},
+            ...params.brush !== void 0 ? { brush: params.brush } : {}
+          },
+          ...params.brush !== void 0 ? { pressure: stroke.pressure } : {}
+        });
+        return { ...result, seed };
+      }
+    };
+  };
+  return [
+    gesture({
+      name: "circle",
+      label: "Circle Around",
+      keywords: ["circle", "ring", "loop", "highlight", "pick", "ellipse"],
+      description: "Circles boxes or nodes with a loose, slightly open ellipse that never cuts into them: the way to point out a pick or the thing you are talking about.",
+      required: ["around"],
+      properties: {
+        around: gestureBoxes("What to circle."),
+        padding: { type: "number", minimum: 0, maximum: 500, description: "Space between them and the loop, canvas units (default 8)." }
+      },
+      make: (p, seed) => circleGesture(boxes(p.around, "around"), seed, { ...p.padding !== void 0 ? { padding: p.padding } : {} })
+    }),
+    gesture({
+      name: "underline",
+      label: "Underline",
+      keywords: ["underline", "emphasis", "line under", "squiggle"],
+      description: "Underlines a box or node with a stroke just below its bottom edge, a little longer or shorter than it: for stressing a line of text or a value.",
+      required: ["under"],
+      properties: {
+        under: gestureBox("What to underline: a box { x, y, width, height } or a node { nodeId }."),
+        offset: { type: "number", minimum: 0, maximum: 200, description: "Gap below the bottom edge, canvas units (default 4)." },
+        wave: { type: "boolean", description: "A wavy (squiggly) underline instead of a straight one (default false)." }
+      },
+      make: (p, seed) => underlineGesture(box(p.under, "under"), seed, { ...p.offset !== void 0 ? { offset: p.offset } : {}, ...p.wave ? { wave: true } : {} })
+    }),
+    gesture({
+      name: "arrow",
+      label: "Arrow",
+      keywords: ["arrow", "point", "connect", "from", "to", "pointer"],
+      description: "Draws a curved arrow with a hand-drawn head from one thing to another: a box or node is reached at its nearest edge, a point exactly. For linking a swatch to where it is used, or pointing from a note to its subject.",
+      required: ["from", "to"],
+      properties: {
+        from: gestureEnd("Where the arrow starts: a box, a node { nodeId } or a point [x, y]."),
+        to: gestureEnd("Where the arrow points: a box, a node { nodeId } or a point [x, y]."),
+        curve: { type: "number", minimum: -1, maximum: 1, description: "Bend of the shaft \u22121..1: how far its middle bulges, as a fraction of half its length; positive bends to the left of travel, 0 is straight (default: a gentle seeded bend, about 0.1)." },
+        gap: { type: "number", minimum: 0, maximum: 200, description: "Space between a box end and the arrow, canvas units (default 6)." }
+      },
+      make: (p, seed) => arrowGesture(end(p.from, "from"), end(p.to, "to"), seed, { ...p.curve !== void 0 ? { curve: p.curve } : {}, ...p.gap !== void 0 ? { gap: p.gap } : {} })
+    }),
+    gesture({
+      name: "bracket",
+      label: "Bracket",
+      keywords: ["bracket", "brace", "group", "curly", "span"],
+      description: "Brackets boxes or nodes on one side with a curly or square bracket spanning them end to end: for grouping a set of items or a range of lines, usually with a note beside it.",
+      required: ["around", "side"],
+      properties: {
+        around: gestureBoxes("What to bracket."),
+        side: { type: "string", enum: ["left", "right", "top", "bottom"], description: "Which side the bracket goes on." },
+        shape: { type: "string", enum: ["curly", "square"], description: "Curly brace (default) or square bracket." },
+        padding: { type: "number", minimum: 0, maximum: 500, description: "Gap between them and the bracket, canvas units (default 8)." },
+        depth: { type: "number", exclusiveMinimum: 0, maximum: 500, description: "How far the bracket reaches out, canvas units (default: from the span, 6..20)." }
+      },
+      make: (p, seed) => bracketGesture(boxes(p.around, "around"), p.side, seed, {
+        ...p.shape ? { shape: p.shape } : {},
+        ...p.padding !== void 0 ? { padding: p.padding } : {},
+        ...p.depth !== void 0 ? { depth: p.depth } : {}
+      })
+    }),
+    gesture({
+      name: "strike",
+      label: "Strike Through",
+      keywords: ["strike", "strikethrough", "cross out", "line through", "delete"],
+      description: "Strikes a line through the middle of a box or node, a little past both ends: for text or a value to drop. It only marks it; nothing is deleted.",
+      required: ["over"],
+      properties: { over: gestureBox("What to strike through: a box { x, y, width, height } or a node { nodeId }.") },
+      make: (p, seed) => strikeGesture(box(p.over, "over"), seed)
+    }),
+    gesture({
+      name: "cross",
+      label: "Cross Out",
+      keywords: ["cross", "x", "reject", "no", "wrong", "cross out"],
+      description: "Crosses out a box or node with an X from corner to corner: for a rejected option. It only marks it; nothing is deleted. One stroke, so the pen runs back over part of the first diagonal before drawing the second.",
+      required: ["over"],
+      properties: { over: gestureBox("What to cross out: a box { x, y, width, height } or a node { nodeId }.") },
+      make: (p, seed) => crossGesture(box(p.over, "over"), seed)
+    }),
+    gesture({
+      name: "check",
+      label: "Check Mark",
+      keywords: ["check", "tick", "approve", "yes", "done", "ok"],
+      description: "Draws a tick mark in the middle of a box or node, or centred on a point: for an approved option or a done item.",
+      required: ["at"],
+      properties: {
+        at: gestureEnd("Where the tick goes: a box, a node { nodeId } (its centre) or a point [x, y]."),
+        size: { type: "number", exclusiveMinimum: 0, maximum: 2e3, description: "Height of the tick, canvas units (default: 60% of the box's smaller side, 12..48; 20 at a point)." }
+      },
+      make: (p, seed) => checkGesture(end(p.at, "at"), seed, { ...p.size !== void 0 ? { size: p.size } : {} })
+    })
   ];
 }
 function hasVariantCommands(controller) {

package/dist/commands/agentTools.d.cts

@@ -11,6 +11,17 @@ export interface CommandToolProviderOptions<TContext = any> {
     scope?: string | readonly string[];
     /** Commands agents may not see or run (e.g. ones that open dialogs). */
     exclude?: (id: string) => boolean;
+    /**
+     * Commands also listed as tools of their own, beside `run_command` (ids, or a filter): the
+     * params schema is the tool's input schema, and the label, description, read-only flag and
+     * playback plan carry over. Agents then see them without calling `list_commands` first.
+     */
+    tools?: readonly string[] | ((id: string) => boolean);
+    /**
+     * Name of a command's own tool (default: the id with every character other than letters,
+     * digits, `_` and `-` replaced by `_`, so `canvas.circle` is `canvas_circle`).
+     */
+    toolName?: (id: string) => string;
 }
 /**
  * Exposes a `CommandRegistry` to agents through a `ToolRegistry`:
@@ -26,6 +37,9 @@ export interface CommandToolProviderOptions<TContext = any> {
  *   registry with `history`) runs them as one undo step named `label` and takes everything
  *   back when one fails.
  *
+ * With `tools`, chosen commands are also tools of their own (`canvas.circle` →
+ * `canvas_circle`, or `toolName`), taking the command's params as arguments.
+ *
  * The id enum in `run_command`'s schema follows the registered commands, so the
  * `ToolRegistry` announces `listChanged` when commands are added or removed.
  */

package/dist/commands/agentTools.d.ts

@@ -11,6 +11,17 @@ export interface CommandToolProviderOptions<TContext = any> {
     scope?: string | readonly string[];
     /** Commands agents may not see or run (e.g. ones that open dialogs). */
     exclude?: (id: string) => boolean;
+    /**
+     * Commands also listed as tools of their own, beside `run_command` (ids, or a filter): the
+     * params schema is the tool's input schema, and the label, description, read-only flag and
+     * playback plan carry over. Agents then see them without calling `list_commands` first.
+     */
+    tools?: readonly string[] | ((id: string) => boolean);
+    /**
+     * Name of a command's own tool (default: the id with every character other than letters,
+     * digits, `_` and `-` replaced by `_`, so `canvas.circle` is `canvas_circle`).
+     */
+    toolName?: (id: string) => string;
 }
 /**
  * Exposes a `CommandRegistry` to agents through a `ToolRegistry`:
@@ -26,6 +37,9 @@ export interface CommandToolProviderOptions<TContext = any> {
  *   registry with `history`) runs them as one undo step named `label` and takes everything
  *   back when one fails.
  *
+ * With `tools`, chosen commands are also tools of their own (`canvas.circle` →
+ * `canvas_circle`, or `toolName`), taking the command's params as arguments.
+ *
  * The id enum in `run_command`'s schema follows the registered commands, so the
  * `ToolRegistry` announces `listChanged` when commands are added or removed.
  */

package/dist/commands/builtins.d.cts

@@ -126,6 +126,13 @@ export interface DrawCommandTarget {
     }>;
     /** The dry paint presets a stroke can be brushed with (loads the paint engine). */
     listBrushes(): Promise<CanvasBrushPreset[]>;
+    /** A node's box in canvas coordinates, so gestures can take `{ nodeId }` targets (without it they take boxes and points only). */
+    nodeBounds?(id: string): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | undefined;
 }
 export interface DrawCommandOptions {
     /** Id prefix (default `canvas.`). */
@@ -144,7 +151,10 @@ export declare function planFreehandPlayback(points: unknown, max?: number): Pla
 /**
  * Agent / palette commands for freehand drawing: `canvas.drawFreehand` (a pen or highlighter
  * stroke through given points, optionally brushed with a dry paint preset and a pressure / tilt
- * profile; one undo step) and the read-only `canvas.listBrushes` (the dry presets it accepts).
+ * profile; one undo step), the read-only `canvas.listBrushes` (the dry presets it accepts) and
+ * the annotation gestures `canvas.circle`, `canvas.underline`, `canvas.arrow`, `canvas.bracket`,
+ * `canvas.strike`, `canvas.cross` and `canvas.check` (hand-drawn marks around boxes, points or,
+ * when the target has `nodeBounds`, nodes).
  */
 export declare function createDrawCommands(target: DrawCommandTarget, options?: DrawCommandOptions): CommandSpec[];
 type ComponentActionResult = {

package/dist/commands/builtins.d.ts

@@ -126,6 +126,13 @@ export interface DrawCommandTarget {
     }>;
     /** The dry paint presets a stroke can be brushed with (loads the paint engine). */
     listBrushes(): Promise<CanvasBrushPreset[]>;
+    /** A node's box in canvas coordinates, so gestures can take `{ nodeId }` targets (without it they take boxes and points only). */
+    nodeBounds?(id: string): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | undefined;
 }
 export interface DrawCommandOptions {
     /** Id prefix (default `canvas.`). */
@@ -144,7 +151,10 @@ export declare function planFreehandPlayback(points: unknown, max?: number): Pla
 /**
  * Agent / palette commands for freehand drawing: `canvas.drawFreehand` (a pen or highlighter
  * stroke through given points, optionally brushed with a dry paint preset and a pressure / tilt
- * profile; one undo step) and the read-only `canvas.listBrushes` (the dry presets it accepts).
+ * profile; one undo step), the read-only `canvas.listBrushes` (the dry presets it accepts) and
+ * the annotation gestures `canvas.circle`, `canvas.underline`, `canvas.arrow`, `canvas.bracket`,
+ * `canvas.strike`, `canvas.cross` and `canvas.check` (hand-drawn marks around boxes, points or,
+ * when the target has `nodeBounds`, nodes).
  */
 export declare function createDrawCommands(target: DrawCommandTarget, options?: DrawCommandOptions): CommandSpec[];
 type ComponentActionResult = {

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)
   };
 }