@pixerate/editor 0.139.1 → 0.140.0

package/dist/animation-editor/tools.d.cts

@@ -1,11 +1,11 @@
 import type { AgentToolProvider } from '../tools/registry.cjs';
 import type { JsonSchema } from '../tools/schema.cjs';
 import type { AnimationEditorController } from './controller.cjs';
-import { type MotionScene } from './types.cjs';
+import { type MotionCommandType, type MotionScene } from './types.cjs';
 export interface AnimationEditorToolProviderOptions {
     /** Provider id (unique per registry). Default `animation`. */
     id?: string;
-    /** Always prefix tool names with `<namespace>__`. */
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
     namespace?: string;
     /** The animation cannot be edited: write tools are hidden and `get_animation` says why. A string is the reason. */
     readOnly?: boolean | string | (() => boolean | string);
@@ -21,7 +21,12 @@ export interface AnimationEditorToolProviderOptions {
         mimeType: string;
     };
 }
-/** JSON Schema of one command (each type its own strict branch). */
+/**
+ * Full JSON Schema of each command type: every field with its range, default and meaning, self-contained.
+ * `describe_animation_command` returns these; the write tools carry the compact {@link MOTION_COMMAND_SCHEMA}.
+ */
+export declare const MOTION_COMMAND_TYPE_SCHEMAS: Readonly<Record<MotionCommandType, JsonSchema>>;
+/** JSON Schema of one command, each type its own strict branch (self-contained, for validating outside the tools). */
 export declare const MOTION_COMMAND_SCHEMA: JsonSchema;
 /** The elements of a scene's artwork, as agents see them. */
 export declare function describeMotionElements(scene: MotionScene): {

package/dist/animation-editor/tools.d.ts

@@ -1,11 +1,11 @@
 import type { AgentToolProvider } from '../tools/registry.js';
 import type { JsonSchema } from '../tools/schema.js';
 import type { AnimationEditorController } from './controller.js';
-import { type MotionScene } from './types.js';
+import { type MotionCommandType, type MotionScene } from './types.js';
 export interface AnimationEditorToolProviderOptions {
     /** Provider id (unique per registry). Default `animation`. */
     id?: string;
-    /** Always prefix tool names with `<namespace>__`. */
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
     namespace?: string;
     /** The animation cannot be edited: write tools are hidden and `get_animation` says why. A string is the reason. */
     readOnly?: boolean | string | (() => boolean | string);
@@ -21,7 +21,12 @@ export interface AnimationEditorToolProviderOptions {
         mimeType: string;
     };
 }
-/** JSON Schema of one command (each type its own strict branch). */
+/**
+ * Full JSON Schema of each command type: every field with its range, default and meaning, self-contained.
+ * `describe_animation_command` returns these; the write tools carry the compact {@link MOTION_COMMAND_SCHEMA}.
+ */
+export declare const MOTION_COMMAND_TYPE_SCHEMAS: Readonly<Record<MotionCommandType, JsonSchema>>;
+/** JSON Schema of one command, each type its own strict branch (self-contained, for validating outside the tools). */
 export declare const MOTION_COMMAND_SCHEMA: JsonSchema;
 /** The elements of a scene's artwork, as agents see them. */
 export declare function describeMotionElements(scene: MotionScene): {

package/dist/bridge/cli.cjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 "use strict"; function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
 
-var _chunkR47NQICBcjs = require('../chunk-R47NQICB.cjs');
-require('../chunk-SPVIXXIB.cjs');
+var _chunkHDCH35UMcjs = require('../chunk-HDCH35UM.cjs');
+require('../chunk-ZAOOIJ6I.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 
 // src/bridge/cli.ts
@@ -22,7 +22,7 @@ args.forEach((arg, i) => {
   if (arg === "--origin" && args[i + 1]) origins.push(args[i + 1]);
 });
 var port = value("--port");
-void _chunkR47NQICBcjs.createToolBridge.call(void 0, {
+void _chunkHDCH35UMcjs.createToolBridge.call(void 0, {
   name: _nullishCoalesce(value("--name"), () => ( "pixerate")),
   port: port !== void 0 ? Number(port) : void 0,
   token: _nullishCoalesce(value("--token"), () => ( process.env.PIXERATE_BRIDGE_TOKEN)),

package/dist/bridge/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   createToolBridge
-} from "../chunk-PCNCT4ZY.js";
-import "../chunk-5RRYDFU2.js";
+} from "../chunk-KIBEEN5K.js";
+import "../chunk-WBKLYLZE.js";
 import "../chunk-V2ZCJRDM.js";
 
 // src/bridge/cli.ts

package/dist/bridge/index.cjs

@@ -1,15 +1,19 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkR47NQICBcjs = require('../chunk-R47NQICB.cjs');
 
 
+var _chunkHDCH35UMcjs = require('../chunk-HDCH35UM.cjs');
 
-var _chunkSPVIXXIBcjs = require('../chunk-SPVIXXIB.cjs');
+
+
+var _chunkZAOOIJ6Icjs = require('../chunk-ZAOOIJ6I.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 
 
 
 
 
-exports.TOOL_BRIDGE_DEFAULT_PORT = _chunkSPVIXXIBcjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkSPVIXXIBcjs.TOOL_BRIDGE_PROTOCOL; exports.createToolBridge = _chunkR47NQICBcjs.createToolBridge; exports.isLocalOrigin = _chunkR47NQICBcjs.isLocalOrigin;
+
+
+exports.TOOL_BRIDGE_DEFAULT_PORT = _chunkZAOOIJ6Icjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkZAOOIJ6Icjs.TOOL_BRIDGE_PROTOCOL; exports.createToolBridge = _chunkHDCH35UMcjs.createToolBridge; exports.defaultSkillsDir = _chunkHDCH35UMcjs.defaultSkillsDir; exports.isLocalOrigin = _chunkHDCH35UMcjs.isLocalOrigin; exports.loadSkillFiles = _chunkHDCH35UMcjs.loadSkillFiles;

package/dist/bridge/index.d.cts

@@ -1,5 +1,7 @@
 import { type McpServer } from '../tools/mcp-server.cjs';
 import { ToolRegistry } from '../tools/registry.cjs';
+import type { SkillFiles } from '../tools/skills.cjs';
+export { loadSkillFiles, defaultSkillsDir } from './skills.cjs';
 export { TOOL_BRIDGE_DEFAULT_PORT, TOOL_BRIDGE_PROTOCOL } from '../tools/bridge-client.cjs';
 export interface ToolBridgeOptions {
     /** The MCP server's name. */
@@ -30,6 +32,11 @@ export interface ToolBridgeOptions {
     } | false;
     /** Diagnostics (default: stderr, since stdout carries MCP). */
     log?: (message: string) => void;
+    /**
+     * Agent skills served as MCP resources and prompts (default: the skills shipped with the
+     * package, from `loadSkillFiles()`); `false` serves none.
+     */
+    skills?: SkillFiles | false;
 }
 /** An editor as `list_editors` reports it. */
 export interface ToolBridgeEditorInfo {

package/dist/bridge/index.d.ts

@@ -1,5 +1,7 @@
 import { type McpServer } from '../tools/mcp-server.js';
 import { ToolRegistry } from '../tools/registry.js';
+import type { SkillFiles } from '../tools/skills.js';
+export { loadSkillFiles, defaultSkillsDir } from './skills.js';
 export { TOOL_BRIDGE_DEFAULT_PORT, TOOL_BRIDGE_PROTOCOL } from '../tools/bridge-client.js';
 export interface ToolBridgeOptions {
     /** The MCP server's name. */
@@ -30,6 +32,11 @@ export interface ToolBridgeOptions {
     } | false;
     /** Diagnostics (default: stderr, since stdout carries MCP). */
     log?: (message: string) => void;
+    /**
+     * Agent skills served as MCP resources and prompts (default: the skills shipped with the
+     * package, from `loadSkillFiles()`); `false` serves none.
+     */
+    skills?: SkillFiles | false;
 }
 /** An editor as `list_editors` reports it. */
 export interface ToolBridgeEditorInfo {

package/dist/bridge/index.js

@@ -1,15 +1,19 @@
 import {
   createToolBridge,
-  isLocalOrigin
-} from "../chunk-PCNCT4ZY.js";
+  defaultSkillsDir,
+  isLocalOrigin,
+  loadSkillFiles
+} from "../chunk-KIBEEN5K.js";
 import {
   TOOL_BRIDGE_DEFAULT_PORT,
   TOOL_BRIDGE_PROTOCOL
-} from "../chunk-5RRYDFU2.js";
+} from "../chunk-WBKLYLZE.js";
 import "../chunk-V2ZCJRDM.js";
 export {
   TOOL_BRIDGE_DEFAULT_PORT,
   TOOL_BRIDGE_PROTOCOL,
   createToolBridge,
-  isLocalOrigin
+  defaultSkillsDir,
+  isLocalOrigin,
+  loadSkillFiles
 };

package/dist/bridge/skills.d.cts

@@ -0,0 +1,9 @@
+import type { SkillFiles } from '../tools/skills.cjs';
+/** The `skills` directory shipped with `@pixerate/editor`, found by walking up from this module. */
+export declare function defaultSkillsDir(): string | null;
+/**
+ * Reads agent skill files (every `<skill>/**\/*.md`) into the {@link SkillFiles} shape that
+ * `createMcpServer({ skills })` and `registry.view({ discovery: { skills } })` take. Defaults
+ * to the skills shipped with the package; returns `{}` when there are none.
+ */
+export declare function loadSkillFiles(dir?: string | null): SkillFiles;

package/dist/bridge/skills.d.ts

@@ -0,0 +1,9 @@
+import type { SkillFiles } from '../tools/skills.js';
+/** The `skills` directory shipped with `@pixerate/editor`, found by walking up from this module. */
+export declare function defaultSkillsDir(): string | null;
+/**
+ * Reads agent skill files (every `<skill>/**\/*.md`) into the {@link SkillFiles} shape that
+ * `createMcpServer({ skills })` and `registry.view({ discovery: { skills } })` take. Defaults
+ * to the skills shipped with the package; returns `{}` when there are none.
+ */
+export declare function loadSkillFiles(dir?: string | null): SkillFiles;

package/dist/canvas/effect-tools.d.cts

@@ -8,7 +8,7 @@ import type { CanvasEffectsController } from './effects.cjs';
 export interface CanvasEffectsToolProviderOptions {
     /** Provider id (unique per registry). Default `canvas-effects`. */
     id?: string;
-    /** Always prefix tool names with `<namespace>__`. */
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
     namespace?: string;
     /** The canvas cannot be edited: write tools are hidden. A string is the reason. */
     readOnly?: boolean | string | (() => boolean | string);

package/dist/canvas/effect-tools.d.ts

@@ -8,7 +8,7 @@ import type { CanvasEffectsController } from './effects.js';
 export interface CanvasEffectsToolProviderOptions {
     /** Provider id (unique per registry). Default `canvas-effects`. */
     id?: string;
-    /** Always prefix tool names with `<namespace>__`. */
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
     namespace?: string;
     /** The canvas cannot be edited: write tools are hidden. A string is the reason. */
     readOnly?: boolean | string | (() => boolean | string);

package/dist/canvas/index.cjs

@@ -84,14 +84,14 @@ var _chunk4EFNS2HVcjs = require('../chunk-4EFNS2HV.cjs');
 
 
 
-var _chunkHGHXGCKGcjs = require('../chunk-HGHXGCKG.cjs');
+var _chunkSVFEVKLFcjs = require('../chunk-SVFEVKLF.cjs');
 
 
 var _chunkPY4GWSE2cjs = require('../chunk-PY4GWSE2.cjs');
 
 
 
-var _chunkCZRWP6IWcjs = require('../chunk-CZRWP6IW.cjs');
+var _chunkN2FGYZ4Qcjs = require('../chunk-N2FGYZ4Q.cjs');
 
 
 var _chunk6HMEHNWWcjs = require('../chunk-6HMEHNWW.cjs');
@@ -189,7 +189,7 @@ var _chunkNM3G4VQTcjs = require('../chunk-NM3G4VQT.cjs');
 
 
 
-var _chunk3V746PF4cjs = require('../chunk-3V746PF4.cjs');
+var _chunkRUZQMYXHcjs = require('../chunk-RUZQMYXH.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 
 
@@ -11516,7 +11516,7 @@ function isAgentCursor(cursor) {
 // src/canvas/capture.ts
 var CANVAS_CAPTURE_VIEWPORT_SELECTOR = ".xyflow__viewport, .react-flow__viewport, .svelte-flow__viewport";
 var CANVAS_CAPTURE_CHROME_SELECTORS = [
-  _chunkHGHXGCKGcjs.CAPTURE_EXCLUDE_SELECTOR,
+  _chunkSVFEVKLFcjs.CAPTURE_EXCLUDE_SELECTOR,
   ".react-flow__panel",
   ".svelte-flow__panel",
   ".react-flow__minimap",
@@ -11527,7 +11527,7 @@ var CANVAS_CAPTURE_CHROME_SELECTORS = [
   ".svelte-flow__attribution"
 ];
 var CANVAS_CAPTURE_OVERLAY_SELECTORS = [
-  ..._chunkHGHXGCKGcjs.CAPTURE_OVERLAY_SELECTORS,
+  ..._chunkSVFEVKLFcjs.CAPTURE_OVERLAY_SELECTORS,
   ".react-flow__nodesselection",
   ".svelte-flow__nodesselection",
   ".react-flow__selection",
@@ -11570,11 +11570,11 @@ function createCanvasCaptureSurface(options) {
   return {
     units: "canvas units",
     viewport,
-    content: () => _chunkCZRWP6IWcjs.unionCaptureRects.call(void 0, rectsOf(options.getNodes(), () => true)),
+    content: () => _chunkN2FGYZ4Qcjs.unionCaptureRects.call(void 0, rectsOf(options.getNodes(), () => true)),
     selection: () => {
       const nodes = options.getNodes();
       const selected = (n3) => !!n3.selected && !n3.hidden;
-      return { rect: _chunkCZRWP6IWcjs.unionCaptureRects.call(void 0, rectsOf(nodes, selected)), ids: nodes.filter(selected).map((n3) => n3.id) };
+      return { rect: _chunkN2FGYZ4Qcjs.unionCaptureRects.call(void 0, rectsOf(nodes, selected)), ids: nodes.filter(selected).map((n3) => n3.id) };
     },
     items: {
       region: "nodes",
@@ -11583,7 +11583,7 @@ function createCanvasCaptureSurface(options) {
       bounds: (ids) => {
         const nodes = options.getNodes();
         const missing = ids.filter((id) => !nodes.some((n3) => n3.id === id));
-        return { rect: _chunkCZRWP6IWcjs.unionCaptureRects.call(void 0, rectsOf(nodes, (n3) => ids.includes(n3.id))), missing };
+        return { rect: _chunkN2FGYZ4Qcjs.unionCaptureRects.call(void 0, rectsOf(nodes, (n3) => ids.includes(n3.id))), missing };
       }
     },
     overlays: "selection boxes, resize handles and agent cursors",
@@ -11591,7 +11591,7 @@ function createCanvasCaptureSurface(options) {
     render: (request) => {
       const el = getElement();
       if (!el || !el.isConnected) throw new Error("The canvas is not mounted, so there is nothing to capture.");
-      const rasterize = _nullishCoalesce(options.rasterize, () => ( _chunkHGHXGCKGcjs.rasterizeElement));
+      const rasterize = _nullishCoalesce(options.rasterize, () => ( _chunkSVFEVKLFcjs.rasterizeElement));
       const exclude = [
         ..._nullishCoalesce(options.chromeSelectors, () => ( CANVAS_CAPTURE_CHROME_SELECTORS)),
         ...request.includeOverlays ? [] : _nullishCoalesce(options.overlaySelectors, () => ( CANVAS_CAPTURE_OVERLAY_SELECTORS))
@@ -11622,8 +11622,10 @@ function createCanvasCaptureSurface(options) {
   };
 }
 function createCanvasCaptureToolProvider(options) {
-  return _chunkCZRWP6IWcjs.createCaptureToolProvider.call(void 0, createCanvasCaptureSurface(options), {
+  return _chunkN2FGYZ4Qcjs.createCaptureToolProvider.call(void 0, createCanvasCaptureSurface(options), {
     subject: "the canvas",
+    title: "Canvas capture",
+    skill: "pixerate-canvas",
     ...options,
     id: _nullishCoalesce(options.id, () => ( "canvas-capture"))
   });
@@ -11642,14 +11644,14 @@ function canvasNodeEffect(node) {
   return _chunkNM3G4VQTcjs.isShapeDescription.call(void 0, shape) ? shape.effect : void 0;
 }
 function createCanvasEffectsController(options) {
-  const slot = new (0, _chunk3V746PF4cjs.EffectsSlot)();
+  const slot = new (0, _chunkRUZQMYXHcjs.EffectsSlot)();
   if (options.effects) slot.set(options.effects);
   const describe = async (effect, place2) => {
     const d = await slot.require().describe(effect);
     const allowed = CANVAS_EFFECT_PLACES[place2];
     if (d.kind === "motion" || !d.uses.some((u) => allowed.includes(u))) {
       const where = place2 === "transition" ? "a scene transition" : place2 === "fill" ? "a fill" : "an overlay";
-      throw new (0, _chunk3V746PF4cjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.uses.join(" / ")} effect and cannot be ${where}, which takes ${allowed.join(" or ")} effects; search_effects with use "${allowed[0]}" lists ones that fit.`, d.id);
+      throw new (0, _chunkRUZQMYXHcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.uses.join(" / ")} effect and cannot be ${where}, which takes ${allowed.join(" or ")} effects; search_effects with use "${allowed[0]}" lists ones that fit.`, d.id);
     }
     return d;
   };
@@ -11680,7 +11682,7 @@ function createCanvasEffectsController(options) {
       else if (k in d.controls.properties) base[k] = d.defaults[k];
       else throw new Error(`"${k}" is not a control of "${d.id}"; its controls are ${Object.keys(d.controls.properties).join(", ")}.`);
     }
-    return { ...base, ..._chunk3V746PF4cjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
+    return { ...base, ..._chunkRUZQMYXHcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
   };
   return {
     /** The provider slot. */
@@ -11710,7 +11712,7 @@ function createCanvasEffectsController(options) {
       const mode = _nullishCoalesce(opts.mode, () => ( "fill"));
       const d = await describe(effect, mode);
       if (opts.opacity !== void 0 && !(opts.opacity >= 0 && opts.opacity <= 1)) throw new Error("opacity must be from 0 to 1.");
-      const next = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunk3V746PF4cjs.resolveEffectValues.call(void 0, d, opts.values), mode, ...opts.opacity !== void 0 && opts.opacity !== 1 ? { opacity: opts.opacity } : {} };
+      const next = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkRUZQMYXHcjs.resolveEffectValues.call(void 0, d, opts.values), mode, ...opts.opacity !== void 0 && opts.opacity !== 1 ? { opacity: opts.opacity } : {} };
       commit(`Add effect ${d.name}`, withEffect(nodeId, next));
       return next;
     },
@@ -11767,7 +11769,7 @@ function createCanvasEffectsController(options) {
       const d = await describe(effect, "transition");
       const duration = _nullishCoalesce(_nullishCoalesce(opts.duration, () => ( d.duration)), () => ( 600));
       if (!(duration > 0)) throw new Error("duration must be a number of ms above 0.");
-      const transition = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunk3V746PF4cjs.resolveEffectValues.call(void 0, d, opts.values), duration };
+      const transition = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkRUZQMYXHcjs.resolveEffectValues.call(void 0, d, opts.values), duration };
       scenes2.update(sceneId, { transition });
       return transition;
     }
@@ -11839,7 +11841,7 @@ async function playCanvasSceneTransition(options) {
   }
 }
 async function captureCanvasView(element, size2) {
-  const url = await _chunkHGHXGCKGcjs.rasterizeElement.call(void 0, element, { pixelWidth: size2.width, pixelHeight: size2.height, exclude: _chunkHGHXGCKGcjs.CAPTURE_OVERLAY_SELECTORS });
+  const url = await _chunkSVFEVKLFcjs.rasterizeElement.call(void 0, element, { pixelWidth: size2.width, pixelHeight: size2.height, exclude: _chunkSVFEVKLFcjs.CAPTURE_OVERLAY_SELECTORS });
   const doc = element.ownerDocument;
   const image = new doc.defaultView.Image();
   await new Promise((resolve, reject) => {
@@ -11911,9 +11913,12 @@ function createCanvasEffectsToolProvider(controller, options = {}) {
   const once = (instance) => {
     if (instance !== "effect") throw new Error('A shape node has one effect, "effect".');
   };
-  return _chunk3V746PF4cjs.createEffectToolProvider.call(void 0, {
+  return _chunkRUZQMYXHcjs.createEffectToolProvider.call(void 0, {
     id: _nullishCoalesce(options.id, () => ( "canvas-effects")),
     namespace: options.namespace,
+    title: "Canvas effects",
+    description: "Provider effects on canvas shape nodes, and transitions between scenes.",
+    skill: "pixerate-canvas",
     target: { noun: "node", id: "A shape node id on the canvas (a node with data.shape)." },
     applyUses: ["generator", "overlay", "title", "interactive"],
     applyDetails: "Generators fill the shape (clipped to its outline); overlays, titles and interactive effects draw over the node's box (set_canvas_effect_mode switches). A node has one effect: this replaces it. enabled false holds the first frame; opacity mixes it. index does not apply.",

package/dist/canvas/index.js

@@ -84,14 +84,14 @@ import {
   CAPTURE_EXCLUDE_SELECTOR,
   CAPTURE_OVERLAY_SELECTORS,
   rasterizeElement
-} from "../chunk-TBSPPVTT.js";
+} from "../chunk-XCK7QK5D.js";
 import {
   EffectRendererPool
 } from "../chunk-EHLOCVWB.js";
 import {
   createCaptureToolProvider,
   unionCaptureRects
-} from "../chunk-BKMU3V6K.js";
+} from "../chunk-5ED73EC6.js";
 import {
   layoutChart
 } from "../chunk-YM75DN54.js";
@@ -189,7 +189,7 @@ import {
   EffectsSlot,
   createEffectToolProvider,
   resolveEffectValues
-} from "../chunk-KHMVB3SJ.js";
+} from "../chunk-7KWJEYIK.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   brushstrokeScaleBucket
@@ -11624,6 +11624,8 @@ function createCanvasCaptureSurface(options) {
 function createCanvasCaptureToolProvider(options) {
   return createCaptureToolProvider(createCanvasCaptureSurface(options), {
     subject: "the canvas",
+    title: "Canvas capture",
+    skill: "pixerate-canvas",
     ...options,
     id: options.id ?? "canvas-capture"
   });
@@ -11914,6 +11916,9 @@ function createCanvasEffectsToolProvider(controller, options = {}) {
   return createEffectToolProvider({
     id: options.id ?? "canvas-effects",
     namespace: options.namespace,
+    title: "Canvas effects",
+    description: "Provider effects on canvas shape nodes, and transitions between scenes.",
+    skill: "pixerate-canvas",
     target: { noun: "node", id: "A shape node id on the canvas (a node with data.shape)." },
     applyUses: ["generator", "overlay", "title", "interactive"],
     applyDetails: "Generators fill the shape (clipped to its outline); overlays, titles and interactive effects draw over the node's box (set_canvas_effect_mode switches). A node has one effect: this replaces it. enabled false holds the first frame; opacity mixes it. index does not apply.",

package/dist/chart/file-tools.d.cts

@@ -11,7 +11,7 @@ export interface OfficeChartFile {
 export interface OfficeChartToolProviderOptions {
     /** Provider id (unique per registry). Default `office-charts`. */
     id?: string;
-    /** Always prefix tool names with `<namespace>__`. */
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
     namespace?: string;
     /**
      * Files the user opened. With it, the tools take a `file` name (and `list_open_files` lists

package/dist/chart/file-tools.d.ts

@@ -11,7 +11,7 @@ export interface OfficeChartFile {
 export interface OfficeChartToolProviderOptions {
     /** Provider id (unique per registry). Default `office-charts`. */
     id?: string;
-    /** Always prefix tool names with `<namespace>__`. */
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
     namespace?: string;
     /**
      * Files the user opened. With it, the tools take a `file` name (and `list_open_files` lists

package/dist/chart/index.cjs

@@ -1491,6 +1491,9 @@ function createChartToolProvider(controller, options = {}) {
   return {
     id: _nullishCoalesce(options.id, () => ( "chart")),
     namespace: options.namespace,
+    title: "Chart editor",
+    description: "One chart: its spec, data and values, series and categories, trendlines and presets, CSV, Mermaid and OOXML import, rendering and colour checks.",
+    skill: "pixerate-chart",
     tools: () => {
       if (readOnlyReason()) return reads;
       return [...reads, ...writes.slice(0, 10), ...Parser() ? [importOoxml] : [], ...writes.slice(10)];
@@ -2091,7 +2094,10 @@ function createOfficeChartToolProvider(options = {}) {
   };
   return {
     id: _nullishCoalesce(options.id, () => ( "office-charts")),
-    ...options.namespace ? { namespace: options.namespace } : {},
+    ...options.namespace !== void 0 ? { namespace: options.namespace } : {},
+    title: "Office charts",
+    description: "Charts inside Word, Excel and PowerPoint files: list and read them, and load one into the chart editor.",
+    skill: "pixerate-chart",
     tools: () => [...options.files ? [listOpenFiles] : [], listCharts, getChart, ...options.controller && !readOnlyReason() ? [loadChart] : []]
   };
 }

package/dist/chart/index.js

@@ -1491,6 +1491,9 @@ function createChartToolProvider(controller, options = {}) {
   return {
     id: options.id ?? "chart",
     namespace: options.namespace,
+    title: "Chart editor",
+    description: "One chart: its spec, data and values, series and categories, trendlines and presets, CSV, Mermaid and OOXML import, rendering and colour checks.",
+    skill: "pixerate-chart",
     tools: () => {
       if (readOnlyReason()) return reads;
       return [...reads, ...writes.slice(0, 10), ...Parser() ? [importOoxml] : [], ...writes.slice(10)];
@@ -2091,7 +2094,10 @@ function createOfficeChartToolProvider(options = {}) {
   };
   return {
     id: options.id ?? "office-charts",
-    ...options.namespace ? { namespace: options.namespace } : {},
+    ...options.namespace !== void 0 ? { namespace: options.namespace } : {},
+    title: "Office charts",
+    description: "Charts inside Word, Excel and PowerPoint files: list and read them, and load one into the chart editor.",
+    skill: "pixerate-chart",
     tools: () => [...options.files ? [listOpenFiles] : [], listCharts, getChart, ...options.controller && !readOnlyReason() ? [loadChart] : []]
   };
 }

package/dist/chart/tools.d.cts

@@ -7,7 +7,7 @@ type ParserCtor = {
 export interface ChartToolProviderOptions {
     /** Provider id (unique per registry). Default `chart`. */
     id?: string;
-    /** Always prefix tool names with `<namespace>__`. */
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
     namespace?: string;
     /**
      * The chart cannot be edited: write tools are hidden and `get_chart` says why. A string

package/dist/chart/tools.d.ts

@@ -7,7 +7,7 @@ type ParserCtor = {
 export interface ChartToolProviderOptions {
     /** Provider id (unique per registry). Default `chart`. */
     id?: string;
-    /** Always prefix tool names with `<namespace>__`. */
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
     namespace?: string;
     /**
      * The chart cannot be edited: write tools are hidden and `get_chart` says why. A string

package/dist/{chunk-BKMU3V6K.js → chunk-5ED73EC6.js}

@@ -186,7 +186,14 @@ function createCaptureTool(surface, options = {}) {
   };
 }
 function createCaptureToolProvider(surface, options = {}) {
-  return { id: options.id ?? "capture", namespace: options.namespace, tools: [createCaptureTool(surface, options)] };
+  return {
+    id: options.id ?? "capture",
+    namespace: options.namespace,
+    title: options.title ?? "Screen capture",
+    description: options.description ?? `A screenshot of ${options.subject ?? "the editor"}, to check what text cannot tell you: overlap, legibility, balance.`,
+    ...options.skill ? { skill: options.skill } : {},
+    tools: [createCaptureTool(surface, options)]
+  };
 }
 
 export {

package/dist/{chunk-VRIR53SW.js → chunk-5G3KYRER.js}

@@ -2005,6 +2005,7 @@ function createTableStore(editor) {
 
 // src/extensions/agent-caret.ts
 import { Extension } from "@tiptap/core";
+import { closeHistory } from "@tiptap/pm/history";
 import { Plugin as Plugin3, PluginKey as PluginKey3 } from "@tiptap/pm/state";
 import { Decoration, DecorationSet } from "@tiptap/pm/view";
 var DEFAULT_AGENT_CARET_COLOR = "#8b5cf6";
@@ -2164,7 +2165,7 @@ async function typeAgentText(editor, options) {
   ensureAgentCaret(editor);
   const show = (tr, anchor, head = anchor) => tr.setMeta(agentCaretPluginKey, { set: { ...caret, from: anchor, to: head } });
   const commit = (start, end) => {
-    const tr = replaceWithTextTransaction(editor.state, start, end, text);
+    const tr = closeHistory(replaceWithTextTransaction(editor.state, start, end, text));
     const insertedTo = tr.mapping.map(end, 1);
     const insertedFrom = Math.min(tr.mapping.map(start, -1), insertedTo);
     editor.view.dispatch(show(tr, insertedTo).scrollIntoView());

package/dist/{chunk-KHMVB3SJ.js → chunk-7KWJEYIK.js}

@@ -343,7 +343,10 @@ function createEffectToolProvider(host) {
   ];
   return {
     id: host.id,
-    ...host.namespace ? { namespace: host.namespace } : {},
+    ...host.namespace !== void 0 ? { namespace: host.namespace } : {},
+    ...host.title ? { title: host.title } : {},
+    ...host.description ? { description: host.description } : {},
+    ...host.skill ? { skill: host.skill } : {},
     tools: () => {
       const extra = host.extraTools?.(context) ?? [];
       if (host.readOnlyReason()) return [...readTools(), ...extra.filter((t) => t.annotations?.readOnlyHint)];