@pixerate/editor 0.139.1 → 0.140.1

package/dist/paint-editor/index.js

@@ -1,6 +1,6 @@
 import {
   toVideoFfmpeg
-} from "../chunk-6NCBFBXA.js";
+} from "../chunk-IQ6KKXOU.js";
 import {
   deserializeLayers,
   exportPsd,
@@ -128,7 +128,7 @@ import {
   EffectsSlot,
   createEffectToolProvider,
   resolveEffectValues
-} from "../chunk-KHMVB3SJ.js";
+} from "../chunk-7KWJEYIK.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   CoverageMap,
@@ -7829,7 +7829,14 @@ function createPaintEditorToolProvider(controller, options = {}) {
   tools.push(...createPaintReplayTools(c));
   tools.push(...createPaintStickerTools(c));
   tools.push(...createPigmentTools());
-  return { id: options.id ?? "paint-editor", namespace: options.namespace, tools };
+  return {
+    id: options.id ?? "paint-editor",
+    namespace: options.namespace,
+    title: "Paint editor",
+    description: "Natural-media painting: paper and grain, dry and wet brushes, the brush library, strokes as data, pigment mixing, stencils, guides, layers and export.",
+    skill: "pixerate-paint-editor",
+    tools
+  };
 }
 
 // src/paint-editor/ui.ts
@@ -8420,6 +8427,9 @@ function createPaintEffectsToolProvider(controller, options = {}) {
   return createEffectToolProvider({
     id: options.id ?? "paint-effects",
     namespace: options.namespace,
+    title: "Paint effects",
+    description: "Provider effects on paint layers and on the effect paper.",
+    skill: "pixerate-paint-editor",
     target: { noun: "layer", id: `A pixel layer id from list_layers ("${PAPER_TARGET}" is the effect paper, for list, update and remove).` },
     applyUses: ["filter"],
     applyDetails: "Light on dried paint: the filter (search_effects with use filter, e.g. a light, glow or grade) runs on the layer's paint at the canvas size and is baked into its pixels; transparent areas stay transparent, and thick paint keeps its relief (an effect with a height input gets it). opacity is the strength (default 1). Wet paint is refused: dry it first (dry_paint). It is one undo step and is not listed afterwards (it is part of the pixels). Generators go on the paper (set_paper_effect), on their own layer (add_effect_layer) or into a layer (fill_layer_with_effect).",

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

@@ -11,7 +11,7 @@ import type { PresenceActorInfo } from '../animation/presence.cjs';
 export interface PaintEditorToolProviderOptions {
     /** Provider id (unique per registry). Default `paint-editor`. */
     id?: string;
-    /** Always prefix tool names with `<namespace>__`. */
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
     namespace?: string;
     /**
      * Acts out strokes, fills and replays with an agent cursor on the canvas (see `PaintDirector`):

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

@@ -11,7 +11,7 @@ import type { PresenceActorInfo } from '../animation/presence.js';
 export interface PaintEditorToolProviderOptions {
     /** Provider id (unique per registry). Default `paint-editor`. */
     id?: string;
-    /** Always prefix tool names with `<namespace>__`. */
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
     namespace?: string;
     /**
      * Acts out strokes, fills and replays with an agent cursor on the canvas (see `PaintDirector`):

package/dist/persistence/index.cjs

@@ -4,7 +4,8 @@
 
 
 
-var _chunkUCRL6JEVcjs = require('../chunk-UCRL6JEV.cjs');
+var _chunkL5OWG2NAcjs = require('../chunk-L5OWG2NA.cjs');
+require('../chunk-2BSBFBOA.cjs');
 
 // src/persistence/recoveryPolicy.ts
 function exponentialBackoff(failures, base = 1e3, max = 3e4) {
@@ -672,4 +673,4 @@ function createRevisionTracker(options = {}) {
 
 
 
-exports.InjectedStorageError = InjectedStorageError; exports.StorageUnavailableError = StorageUnavailableError; exports.createAutosaveController = createAutosaveController; exports.createIndexedDbAdapter = createIndexedDbAdapter; exports.createLoadReport = _chunkUCRL6JEVcjs.createLoadReport; exports.createLocalStorageAdapter = createLocalStorageAdapter; exports.createMemoryStorage = createMemoryStorage; exports.createOpfsAdapter = createOpfsAdapter; exports.createRecoveryPolicy = createRecoveryPolicy; exports.createRevisionTracker = createRevisionTracker; exports.exponentialBackoff = exponentialBackoff; exports.formatRecoveryMessage = formatRecoveryMessage; exports.hasLoadProblems = _chunkUCRL6JEVcjs.hasLoadProblems; exports.isIndexedDbAvailable = isIndexedDbAvailable; exports.isLocalStorageAvailable = isLocalStorageAvailable; exports.isOpfsAvailable = isOpfsAvailable; exports.loadDocument = _chunkUCRL6JEVcjs.loadDocument; exports.loadSections = _chunkUCRL6JEVcjs.loadSections; exports.migrateDocument = _chunkUCRL6JEVcjs.migrateDocument; exports.recoveryMetaKey = recoveryMetaKey; exports.withStorageFailures = withStorageFailures;
+exports.InjectedStorageError = InjectedStorageError; exports.StorageUnavailableError = StorageUnavailableError; exports.createAutosaveController = createAutosaveController; exports.createIndexedDbAdapter = createIndexedDbAdapter; exports.createLoadReport = _chunkL5OWG2NAcjs.createLoadReport; exports.createLocalStorageAdapter = createLocalStorageAdapter; exports.createMemoryStorage = createMemoryStorage; exports.createOpfsAdapter = createOpfsAdapter; exports.createRecoveryPolicy = createRecoveryPolicy; exports.createRevisionTracker = createRevisionTracker; exports.exponentialBackoff = exponentialBackoff; exports.formatRecoveryMessage = formatRecoveryMessage; exports.hasLoadProblems = _chunkL5OWG2NAcjs.hasLoadProblems; exports.isIndexedDbAvailable = isIndexedDbAvailable; exports.isLocalStorageAvailable = isLocalStorageAvailable; exports.isOpfsAvailable = isOpfsAvailable; exports.loadDocument = _chunkL5OWG2NAcjs.loadDocument; exports.loadSections = _chunkL5OWG2NAcjs.loadSections; exports.migrateDocument = _chunkL5OWG2NAcjs.migrateDocument; exports.recoveryMetaKey = recoveryMetaKey; exports.withStorageFailures = withStorageFailures;

package/dist/persistence/index.js

@@ -4,7 +4,8 @@ import {
   loadDocument,
   loadSections,
   migrateDocument
-} from "../chunk-WIYAOZZU.js";
+} from "../chunk-WHKNYFM2.js";
+import "../chunk-HF5QZS7Z.js";
 
 // src/persistence/recoveryPolicy.ts
 function exponentialBackoff(failures, base = 1e3, max = 3e4) {

package/dist/serializers/index.cjs

@@ -9,7 +9,7 @@
 
 
 
-var _chunkHXCBQ7A6cjs = require('../chunk-HXCBQ7A6.cjs');
+var _chunk3AJMR7EGcjs = require('../chunk-3AJMR7EG.cjs');
 
 
 
@@ -27,14 +27,15 @@ var _chunkHXCBQ7A6cjs = require('../chunk-HXCBQ7A6.cjs');
 
 
 
-var _chunk6NXVDJDRcjs = require('../chunk-6NXVDJDR.cjs');
+var _chunkG43MNQ4Ccjs = require('../chunk-G43MNQ4C.cjs');
 
 
 
 
 
 var _chunkJG5VGCKPcjs = require('../chunk-JG5VGCKP.cjs');
-require('../chunk-CCKP4XAN.cjs');
+require('../chunk-34RQAGWI.cjs');
+require('../chunk-2BSBFBOA.cjs');
 
 
 
@@ -65,4 +66,4 @@ require('../chunk-CCKP4XAN.cjs');
 
 
 
-exports.MARKDOWN_MENTION_SPLIT_REGEX = _chunk6NXVDJDRcjs.MARKDOWN_MENTION_SPLIT_REGEX; exports.MENTION_REGEX = _chunkJG5VGCKPcjs.MENTION_REGEX; exports.PIXERATE_DOCUMENT_MIME = _chunkHXCBQ7A6cjs.PIXERATE_DOCUMENT_MIME; exports.escapeHtml = _chunk6NXVDJDRcjs.escapeHtml; exports.extractMentions = _chunk6NXVDJDRcjs.extractMentions; exports.extractMentionsFromDoc = _chunk6NXVDJDRcjs.extractMentionsFromDoc; exports.findTextMentions = _chunkJG5VGCKPcjs.findTextMentions; exports.formatMentionText = _chunkJG5VGCKPcjs.formatMentionText; exports.getClipboardData = _chunkHXCBQ7A6cjs.getClipboardData; exports.getEditorMarkdown = _chunk6NXVDJDRcjs.getEditorMarkdown; exports.getEditorText = _chunk6NXVDJDRcjs.getEditorText; exports.getSchemaSignature = _chunkHXCBQ7A6cjs.getSchemaSignature; exports.htmlToPlainText = _chunk6NXVDJDRcjs.htmlToPlainText; exports.markdownToTipTapHtml = _chunk6NXVDJDRcjs.markdownToTipTapHtml; exports.parseMentionSegments = _chunk6NXVDJDRcjs.parseMentionSegments; exports.parseRichClipboardPayload = _chunkHXCBQ7A6cjs.parseRichClipboardPayload; exports.plainTextToParagraphHtml = _chunkHXCBQ7A6cjs.plainTextToParagraphHtml; exports.plainTextToSlice = _chunk6NXVDJDRcjs.plainTextToSlice; exports.plainTextToTipTapHtml = _chunk6NXVDJDRcjs.plainTextToTipTapHtml; exports.preprocessMarkdownFileLinks = _chunk6NXVDJDRcjs.preprocessMarkdownFileLinks; exports.preprocessMarkdownMentions = _chunk6NXVDJDRcjs.preprocessMarkdownMentions; exports.readRichClipboard = _chunkHXCBQ7A6cjs.readRichClipboard; exports.rtfToPlainText = _chunkHXCBQ7A6cjs.rtfToPlainText; exports.sanitizeHtml = _chunk6NXVDJDRcjs.sanitizeHtml; exports.sanitizeImportedHtml = _chunkHXCBQ7A6cjs.sanitizeImportedHtml; exports.serializeRichClipboardPayload = _chunkHXCBQ7A6cjs.serializeRichClipboardPayload; exports.setMentionRoleInText = _chunkJG5VGCKPcjs.setMentionRoleInText; exports.splitMarkdownMentionParts = _chunk6NXVDJDRcjs.splitMarkdownMentionParts; exports.stripMarkdownCode = _chunk6NXVDJDRcjs.stripMarkdownCode;
+exports.MARKDOWN_MENTION_SPLIT_REGEX = _chunkG43MNQ4Ccjs.MARKDOWN_MENTION_SPLIT_REGEX; exports.MENTION_REGEX = _chunkJG5VGCKPcjs.MENTION_REGEX; exports.PIXERATE_DOCUMENT_MIME = _chunk3AJMR7EGcjs.PIXERATE_DOCUMENT_MIME; exports.escapeHtml = _chunkG43MNQ4Ccjs.escapeHtml; exports.extractMentions = _chunkG43MNQ4Ccjs.extractMentions; exports.extractMentionsFromDoc = _chunkG43MNQ4Ccjs.extractMentionsFromDoc; exports.findTextMentions = _chunkJG5VGCKPcjs.findTextMentions; exports.formatMentionText = _chunkJG5VGCKPcjs.formatMentionText; exports.getClipboardData = _chunk3AJMR7EGcjs.getClipboardData; exports.getEditorMarkdown = _chunkG43MNQ4Ccjs.getEditorMarkdown; exports.getEditorText = _chunkG43MNQ4Ccjs.getEditorText; exports.getSchemaSignature = _chunk3AJMR7EGcjs.getSchemaSignature; exports.htmlToPlainText = _chunkG43MNQ4Ccjs.htmlToPlainText; exports.markdownToTipTapHtml = _chunkG43MNQ4Ccjs.markdownToTipTapHtml; exports.parseMentionSegments = _chunkG43MNQ4Ccjs.parseMentionSegments; exports.parseRichClipboardPayload = _chunk3AJMR7EGcjs.parseRichClipboardPayload; exports.plainTextToParagraphHtml = _chunk3AJMR7EGcjs.plainTextToParagraphHtml; exports.plainTextToSlice = _chunkG43MNQ4Ccjs.plainTextToSlice; exports.plainTextToTipTapHtml = _chunkG43MNQ4Ccjs.plainTextToTipTapHtml; exports.preprocessMarkdownFileLinks = _chunkG43MNQ4Ccjs.preprocessMarkdownFileLinks; exports.preprocessMarkdownMentions = _chunkG43MNQ4Ccjs.preprocessMarkdownMentions; exports.readRichClipboard = _chunk3AJMR7EGcjs.readRichClipboard; exports.rtfToPlainText = _chunk3AJMR7EGcjs.rtfToPlainText; exports.sanitizeHtml = _chunkG43MNQ4Ccjs.sanitizeHtml; exports.sanitizeImportedHtml = _chunk3AJMR7EGcjs.sanitizeImportedHtml; exports.serializeRichClipboardPayload = _chunk3AJMR7EGcjs.serializeRichClipboardPayload; exports.setMentionRoleInText = _chunkJG5VGCKPcjs.setMentionRoleInText; exports.splitMarkdownMentionParts = _chunkG43MNQ4Ccjs.splitMarkdownMentionParts; exports.stripMarkdownCode = _chunkG43MNQ4Ccjs.stripMarkdownCode;

package/dist/serializers/index.js

@@ -9,7 +9,7 @@ import {
   rtfToPlainText,
   sanitizeImportedHtml,
   serializeRichClipboardPayload
-} from "../chunk-YTGF4TJR.js";
+} from "../chunk-ZLZKGHSZ.js";
 import {
   MARKDOWN_MENTION_SPLIT_REGEX,
   escapeHtml,
@@ -27,14 +27,15 @@ import {
   sanitizeHtml,
   splitMarkdownMentionParts,
   stripMarkdownCode
-} from "../chunk-SWZTQWY7.js";
+} from "../chunk-2INPJDNY.js";
 import {
   MENTION_REGEX,
   findTextMentions,
   formatMentionText,
   setMentionRoleInText
 } from "../chunk-RTRQ7XFI.js";
-import "../chunk-HZZXBTLB.js";
+import "../chunk-6IN474P4.js";
+import "../chunk-HF5QZS7Z.js";
 export {
   MARKDOWN_MENTION_SPLIT_REGEX,
   MENTION_REGEX,

package/dist/tools/bridge-client.d.cts

@@ -1,4 +1,4 @@
-import type { McpToolDefinition, McpToolResult, ToolRegistry } from './registry.cjs';
+import type { McpToolDefinition, McpToolResult, ToolSource } from './registry.cjs';
 /** Protocol version spoken between `connectToolBridge` and `createToolBridge`. */
 export declare const TOOL_BRIDGE_PROTOCOL = 1;
 /** Default port the bridge listens on (127.0.0.1 only). */
@@ -65,10 +65,10 @@ export interface ToolBridgeConnection {
     close(): void;
 }
 /**
- * Connects a `ToolRegistry` to a local MCP bridge (`createToolBridge` /
+ * Connects a `ToolRegistry` (or a `registry.view()` of it) to a local MCP bridge (`createToolBridge` /
  * `pixerate-mcp-bridge`), so an MCP client (Claude Desktop, Claude Code, an IDE) can call
  * the page's tools: the registry's tool list is sent on connect and whenever it changes,
  * calls run through `registry.callTool` with an `AbortSignal` the bridge cancels, and the
  * connection comes back after the bridge restarts.
  */
-export declare function connectToolBridge(registry: ToolRegistry, options: ConnectToolBridgeOptions): ToolBridgeConnection;
+export declare function connectToolBridge(registry: ToolSource, options: ConnectToolBridgeOptions): ToolBridgeConnection;

package/dist/tools/bridge-client.d.ts

@@ -1,4 +1,4 @@
-import type { McpToolDefinition, McpToolResult, ToolRegistry } from './registry.js';
+import type { McpToolDefinition, McpToolResult, ToolSource } from './registry.js';
 /** Protocol version spoken between `connectToolBridge` and `createToolBridge`. */
 export declare const TOOL_BRIDGE_PROTOCOL = 1;
 /** Default port the bridge listens on (127.0.0.1 only). */
@@ -65,10 +65,10 @@ export interface ToolBridgeConnection {
     close(): void;
 }
 /**
- * Connects a `ToolRegistry` to a local MCP bridge (`createToolBridge` /
+ * Connects a `ToolRegistry` (or a `registry.view()` of it) to a local MCP bridge (`createToolBridge` /
  * `pixerate-mcp-bridge`), so an MCP client (Claude Desktop, Claude Code, an IDE) can call
  * the page's tools: the registry's tool list is sent on connect and whenever it changes,
  * calls run through `registry.callTool` with an `AbortSignal` the bridge cancels, and the
  * connection comes back after the bridge restarts.
  */
-export declare function connectToolBridge(registry: ToolRegistry, options: ConnectToolBridgeOptions): ToolBridgeConnection;
+export declare function connectToolBridge(registry: ToolSource, options: ConnectToolBridgeOptions): ToolBridgeConnection;

package/dist/tools/capture.d.cts

@@ -88,8 +88,12 @@ export interface CaptureToolOptions {
 export interface CaptureToolProviderOptions extends CaptureToolOptions {
     /** Provider id (unique per registry, default `capture`). */
     id?: string;
-    /** Always prefix tool names with `<namespace>__`. */
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
     namespace?: string;
+    /** Toolset title (default "Screen capture"), description and skill (see `AgentToolProvider`). */
+    title?: string;
+    description?: string;
+    skill?: string;
 }
 /** Bounds of the capture: union of rects, `null` for none. */
 export declare function unionCaptureRects(rects: readonly (CaptureRect | null | undefined)[]): CaptureRect | null;

package/dist/tools/capture.d.ts

@@ -88,8 +88,12 @@ export interface CaptureToolOptions {
 export interface CaptureToolProviderOptions extends CaptureToolOptions {
     /** Provider id (unique per registry, default `capture`). */
     id?: string;
-    /** Always prefix tool names with `<namespace>__`. */
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
     namespace?: string;
+    /** Toolset title (default "Screen capture"), description and skill (see `AgentToolProvider`). */
+    title?: string;
+    description?: string;
+    skill?: string;
 }
 /** Bounds of the capture: union of rects, `null` for none. */
 export declare function unionCaptureRects(rects: readonly (CaptureRect | null | undefined)[]): CaptureRect | null;

package/dist/tools/definitions.d.cts

@@ -361,7 +361,7 @@ export declare const MCP_TOOL_CANVAS_LAYOUT: {
         readonly openWorldHint: false;
         readonly title: "Lay out the canvas";
     };
-    readonly description: "Arranges the canvas graph automatically.";
+    readonly description: "Arranges the canvas nodes automatically in a layered graph layout that follows the edges, so nodes line up and do not overlap. Nodes that already have a position stay put unless incremental is false.";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -733,7 +733,7 @@ export declare const EDITOR_CANVAS_TOOLS: readonly [{
         readonly openWorldHint: false;
         readonly title: "Lay out the canvas";
     };
-    readonly description: "Arranges the canvas graph automatically.";
+    readonly description: "Arranges the canvas nodes automatically in a layered graph layout that follows the edges, so nodes line up and do not overlap. Nodes that already have a position stay put unless incremental is false.";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {

package/dist/tools/definitions.d.ts

@@ -361,7 +361,7 @@ export declare const MCP_TOOL_CANVAS_LAYOUT: {
         readonly openWorldHint: false;
         readonly title: "Lay out the canvas";
     };
-    readonly description: "Arranges the canvas graph automatically.";
+    readonly description: "Arranges the canvas nodes automatically in a layered graph layout that follows the edges, so nodes line up and do not overlap. Nodes that already have a position stay put unless incremental is false.";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -733,7 +733,7 @@ export declare const EDITOR_CANVAS_TOOLS: readonly [{
         readonly openWorldHint: false;
         readonly title: "Lay out the canvas";
     };
-    readonly description: "Arranges the canvas graph automatically.";
+    readonly description: "Arranges the canvas nodes automatically in a layered graph layout that follows the edges, so nodes line up and do not overlap. Nodes that already have a position stay put unless incremental is false.";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {

package/dist/tools/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../chunk-DDF6WQ62.cjs');
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../chunk-LACYURUW.cjs');
 
 
 
@@ -11,7 +11,6 @@
 
 
 
-var _chunkSPVIXXIBcjs = require('../chunk-SPVIXXIB.cjs');
 
 
 
@@ -25,6 +24,7 @@ var _chunkSPVIXXIBcjs = require('../chunk-SPVIXXIB.cjs');
 
 
 
+var _chunkHDK3T2QScjs = require('../chunk-HDK3T2QS.cjs');
 
 
 
@@ -39,7 +39,6 @@ var _chunkSPVIXXIBcjs = require('../chunk-SPVIXXIB.cjs');
 
 
 
-var _chunkHGHXGCKGcjs = require('../chunk-HGHXGCKG.cjs');
 
 
 
@@ -48,7 +47,26 @@ var _chunkHGHXGCKGcjs = require('../chunk-HGHXGCKG.cjs');
 
 
 
-var _chunkCZRWP6IWcjs = require('../chunk-CZRWP6IW.cjs');
+
+
+
+
+
+var _chunkSVFEVKLFcjs = require('../chunk-SVFEVKLF.cjs');
+
+
+
+
+
+
+
+
+var _chunkN2FGYZ4Qcjs = require('../chunk-N2FGYZ4Q.cjs');
+
+
+
+
+var _chunk2BSBFBOAcjs = require('../chunk-2BSBFBOA.cjs');
 
 
 var _chunkWOFXZ3XUcjs = require('../chunk-WOFXZ3XU.cjs');
@@ -98,4 +116,20 @@ var _chunkWOFXZ3XUcjs = require('../chunk-WOFXZ3XU.cjs');
 
 
 
-exports.CAPTURE_EXCLUDE_SELECTOR = _chunkHGHXGCKGcjs.CAPTURE_EXCLUDE_SELECTOR; exports.CAPTURE_OVERLAY_SELECTORS = _chunkHGHXGCKGcjs.CAPTURE_OVERLAY_SELECTORS; exports.EDITOR_CANVAS_TOOLS = _chunkHGHXGCKGcjs.EDITOR_CANVAS_TOOLS; exports.EDITOR_MCP_TOOLS = _chunkHGHXGCKGcjs.EDITOR_MCP_TOOLS; exports.EDITOR_PROMPT_TOOLS = _chunkHGHXGCKGcjs.EDITOR_PROMPT_TOOLS; exports.EDIT_OPERATION_REQUIRED_ARGUMENTS = _chunkHGHXGCKGcjs.EDIT_OPERATION_REQUIRED_ARGUMENTS; exports.EXPORT_EXCLUDED_SELECTORS = _chunkHGHXGCKGcjs.EXPORT_EXCLUDED_SELECTORS; exports.JSON_RPC_ERRORS = _chunkSPVIXXIBcjs.JSON_RPC_ERRORS; exports.MCP_PROTOCOL_VERSIONS = _chunkSPVIXXIBcjs.MCP_PROTOCOL_VERSIONS; exports.MCP_TOOL_CANVAS_ADD_NODE = _chunkHGHXGCKGcjs.MCP_TOOL_CANVAS_ADD_NODE; exports.MCP_TOOL_CANVAS_CONNECT = _chunkHGHXGCKGcjs.MCP_TOOL_CANVAS_CONNECT; exports.MCP_TOOL_CANVAS_HIGHLIGHT = _chunkHGHXGCKGcjs.MCP_TOOL_CANVAS_HIGHLIGHT; exports.MCP_TOOL_CANVAS_LAYOUT = _chunkHGHXGCKGcjs.MCP_TOOL_CANVAS_LAYOUT; exports.MCP_TOOL_CANVAS_REMOVE_NODES = _chunkHGHXGCKGcjs.MCP_TOOL_CANVAS_REMOVE_NODES; exports.MCP_TOOL_CANVAS_SELECT = _chunkHGHXGCKGcjs.MCP_TOOL_CANVAS_SELECT; exports.MCP_TOOL_CANVAS_UPDATE_NODE = _chunkHGHXGCKGcjs.MCP_TOOL_CANVAS_UPDATE_NODE; exports.MCP_TOOL_EDIT_CANVAS = _chunkHGHXGCKGcjs.MCP_TOOL_EDIT_CANVAS; exports.MCP_TOOL_EDIT_PROMPT = _chunkHGHXGCKGcjs.MCP_TOOL_EDIT_PROMPT; exports.MCP_TOOL_GET_EDITOR_STATE = _chunkHGHXGCKGcjs.MCP_TOOL_GET_EDITOR_STATE; exports.MCP_TOOL_PROMPT_INSERT_TEXT = _chunkHGHXGCKGcjs.MCP_TOOL_PROMPT_INSERT_TEXT; exports.MCP_TOOL_PROMPT_REPLACE_RANGE = _chunkHGHXGCKGcjs.MCP_TOOL_PROMPT_REPLACE_RANGE; exports.MCP_TOOL_PROMPT_SELECT = _chunkHGHXGCKGcjs.MCP_TOOL_PROMPT_SELECT; exports.MCP_TOOL_PROMPT_SET_VARIABLE = _chunkHGHXGCKGcjs.MCP_TOOL_PROMPT_SET_VARIABLE; exports.MCP_TOOL_VIEW_EDITOR = _chunkHGHXGCKGcjs.MCP_TOOL_VIEW_EDITOR; exports.TOOL_BRIDGE_DEFAULT_PORT = _chunkSPVIXXIBcjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkSPVIXXIBcjs.TOOL_BRIDGE_PROTOCOL; exports.TOOL_NAMESPACE_SEPARATOR = _chunkSPVIXXIBcjs.TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = _chunkSPVIXXIBcjs.ToolRegistry; exports.ToolRegistryError = _chunkSPVIXXIBcjs.ToolRegistryError; exports.captureInputSchema = _chunkCZRWP6IWcjs.captureInputSchema; exports.captureOutputSize = _chunkCZRWP6IWcjs.captureOutputSize; exports.cloneElementWithStyles = _chunkHGHXGCKGcjs.cloneElementWithStyles; exports.connectToolBridge = _chunkSPVIXXIBcjs.connectToolBridge; exports.createCaptureTool = _chunkCZRWP6IWcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkCZRWP6IWcjs.createCaptureToolProvider; exports.createElementCaptureSurface = _chunkHGHXGCKGcjs.createElementCaptureSurface; exports.createMcpServer = _chunkSPVIXXIBcjs.createMcpServer; exports.createToolRegistry = _chunkSPVIXXIBcjs.createToolRegistry; exports.elementToSvg = _chunkHGHXGCKGcjs.elementToSvg; exports.rasterizeElement = _chunkHGHXGCKGcjs.rasterizeElement; exports.resolveCaptureRequest = _chunkCZRWP6IWcjs.resolveCaptureRequest; exports.toCapturedImageData = _chunkCZRWP6IWcjs.toCapturedImageData; exports.toToolResult = _chunkSPVIXXIBcjs.toToolResult; exports.unionCaptureRects = _chunkCZRWP6IWcjs.unionCaptureRects; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+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 = _chunkHDK3T2QScjs.JSON_RPC_ERRORS; exports.MCP_PROTOCOL_VERSIONS = _chunkHDK3T2QScjs.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.TOOL_BRIDGE_DEFAULT_PORT = _chunkHDK3T2QScjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkHDK3T2QScjs.TOOL_BRIDGE_PROTOCOL; exports.TOOL_DISCOVERY_TOOLS = _chunkHDK3T2QScjs.TOOL_DISCOVERY_TOOLS; exports.TOOL_NAMESPACE_SEPARATOR = _chunkHDK3T2QScjs.TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = _chunkHDK3T2QScjs.ToolRegistry; exports.ToolRegistryError = _chunkHDK3T2QScjs.ToolRegistryError; exports.ToolRegistryView = _chunkHDK3T2QScjs.ToolRegistryView; exports.UNSAFE_JSON_KEYS = _chunk2BSBFBOAcjs.UNSAFE_JSON_KEYS; exports.baseToolName = _chunkHDK3T2QScjs.baseToolName; exports.captureInputSchema = _chunkN2FGYZ4Qcjs.captureInputSchema; exports.captureOutputSize = _chunkN2FGYZ4Qcjs.captureOutputSize; exports.cloneElementWithStyles = _chunkSVFEVKLFcjs.cloneElementWithStyles; exports.connectToolBridge = _chunkHDK3T2QScjs.connectToolBridge; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createMcpServer = _chunkHDK3T2QScjs.createMcpServer; exports.createToolRegistry = _chunkHDK3T2QScjs.createToolRegistry; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkHDK3T2QScjs.errorResult; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkills = _chunkHDK3T2QScjs.listSkills; exports.parseSkillFrontmatter = _chunkHDK3T2QScjs.parseSkillFrontmatter; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkHDK3T2QScjs.readSkillFile; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.searchTokens = _chunkHDK3T2QScjs.searchTokens; exports.searchTools = _chunkHDK3T2QScjs.searchTools; exports.stripPrototypeKeys = _chunk2BSBFBOAcjs.stripPrototypeKeys; exports.summarize = _chunkHDK3T2QScjs.summarize; exports.toCapturedImageData = _chunkN2FGYZ4Qcjs.toCapturedImageData; exports.toToolResult = _chunkHDK3T2QScjs.toToolResult; exports.toolsetInstructions = _chunkHDK3T2QScjs.toolsetInstructions; exports.toolsetName = _chunkHDK3T2QScjs.toolsetName; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unknownToolMessage = _chunkHDK3T2QScjs.unknownToolMessage; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;

package/dist/tools/index.d.cts

@@ -14,3 +14,7 @@ export * from './mcp-server.cjs';
 export * from './bridge-client.cjs';
 export * from './capture.cjs';
 export * from './dom-capture.cjs';
+export * from './view.cjs';
+export * from './search.cjs';
+export * from './skills.cjs';
+export * from './safe-json.cjs';

package/dist/tools/index.d.ts

@@ -14,3 +14,7 @@ export * from './mcp-server.js';
 export * from './bridge-client.js';
 export * from './capture.js';
 export * from './dom-capture.js';
+export * from './view.js';
+export * from './search.js';
+export * from './skills.js';
+export * from './safe-json.js';

package/dist/tools/index.js

@@ -1,17 +1,30 @@
-import "../chunk-SMJK5HBJ.js";
+import "../chunk-K73HMKQP.js";
 import {
   JSON_RPC_ERRORS,
   MCP_PROTOCOL_VERSIONS,
   TOOL_BRIDGE_DEFAULT_PORT,
   TOOL_BRIDGE_PROTOCOL,
+  TOOL_DISCOVERY_TOOLS,
   TOOL_NAMESPACE_SEPARATOR,
   ToolRegistry,
   ToolRegistryError,
+  ToolRegistryView,
+  baseToolName,
   connectToolBridge,
   createMcpServer,
   createToolRegistry,
-  toToolResult
-} from "../chunk-5RRYDFU2.js";
+  errorResult,
+  listSkills,
+  parseSkillFrontmatter,
+  readSkillFile,
+  searchTokens,
+  searchTools,
+  summarize,
+  toToolResult,
+  toolsetInstructions,
+  toolsetName,
+  unknownToolMessage
+} from "../chunk-RB62U6MS.js";
 import {
   CAPTURE_EXCLUDE_SELECTOR,
   CAPTURE_OVERLAY_SELECTORS,
@@ -39,7 +52,7 @@ import {
   createElementCaptureSurface,
   elementToSvg,
   rasterizeElement
-} from "../chunk-TBSPPVTT.js";
+} from "../chunk-XCK7QK5D.js";
 import {
   captureInputSchema,
   captureOutputSize,
@@ -48,7 +61,12 @@ import {
   resolveCaptureRequest,
   toCapturedImageData,
   unionCaptureRects
-} from "../chunk-BKMU3V6K.js";
+} from "../chunk-5ED73EC6.js";
+import {
+  UNSAFE_JSON_KEYS,
+  isUnsafeJsonKey,
+  stripPrototypeKeys
+} from "../chunk-HF5QZS7Z.js";
 import {
   validateJsonSchema
 } from "../chunk-V2ZCJRDM.js";
@@ -79,9 +97,13 @@ export {
   MCP_TOOL_VIEW_EDITOR,
   TOOL_BRIDGE_DEFAULT_PORT,
   TOOL_BRIDGE_PROTOCOL,
+  TOOL_DISCOVERY_TOOLS,
   TOOL_NAMESPACE_SEPARATOR,
   ToolRegistry,
   ToolRegistryError,
+  ToolRegistryView,
+  UNSAFE_JSON_KEYS,
+  baseToolName,
   captureInputSchema,
   captureOutputSize,
   cloneElementWithStyles,
@@ -92,10 +114,22 @@ export {
   createMcpServer,
   createToolRegistry,
   elementToSvg,
+  errorResult,
+  isUnsafeJsonKey,
+  listSkills,
+  parseSkillFrontmatter,
   rasterizeElement,
+  readSkillFile,
   resolveCaptureRequest,
+  searchTokens,
+  searchTools,
+  stripPrototypeKeys,
+  summarize,
   toCapturedImageData,
   toToolResult,
+  toolsetInstructions,
+  toolsetName,
   unionCaptureRects,
+  unknownToolMessage,
   validateJsonSchema
 };

package/dist/tools/mcp-server.d.cts

@@ -1,4 +1,5 @@
-import type { ToolRegistry } from './registry.cjs';
+import type { ToolSource } from './registry.cjs';
+import { type SkillFiles } from './skills.cjs';
 /** MCP protocol revisions this server speaks, newest first. */
 export declare const MCP_PROTOCOL_VERSIONS: readonly ["2025-06-18", "2025-03-26", "2024-11-05"];
 export type JsonRpcId = string | number;
@@ -36,8 +37,18 @@ export interface McpServerOptions {
     name: string;
     version: string;
     title?: string;
-    /** Usage hints for the client's model, sent in the `initialize` result. */
-    instructions?: string;
+    /**
+     * Usage hints for the client's model, sent in the `initialize` result. Pass
+     * `toolsetInstructions` (or your own function) to describe the toolsets
+     * registered when the client connects.
+     */
+    instructions?: string | ((source: ToolSource) => string);
+    /**
+     * Agent skill files to serve as MCP resources (`skill://<name>/SKILL.md` and
+     * its reference files) and prompts (one per skill), so a client can load the
+     * guide for the tools it uses. See {@link SkillFiles}.
+     */
+    skills?: SkillFiles;
     /**
      * Sends server → client messages (`notifications/tools/list_changed`).
      * Without it the server still answers requests but announces nothing.
@@ -57,15 +68,22 @@ export interface McpServer {
     close(): void;
 }
 /**
- * A transport-agnostic MCP server for a {@link ToolRegistry}: wire `handle`
+ * Instructions describing the toolsets of a tool source: what each covers, how
+ * tools are named, and which skill documents it. Pass it as
+ * `createMcpServer(source, { instructions: toolsetInstructions })`.
+ */
+export declare function toolsetInstructions(source: ToolSource): string;
+/**
+ * A transport-agnostic MCP server for a {@link ToolRegistry} (or any {@link ToolSource}): wire `handle`
  * to any transport (stdio lines, a WebSocket, `postMessage`, an HTTP POST
  * handler) and pass `send` for server → client notifications.
  *
  * Supports `initialize` (with protocol version negotiation), `ping`,
- * `tools/list`, `tools/call` and `notifications/cancelled` (aborts the
+ * `tools/list`, `tools/call`, with `skills` `resources/list`, `resources/read`,
+ * `prompts/list` and `prompts/get`, and `notifications/cancelled` (aborts the
  * call's `signal`), and announces `notifications/tools/list_changed` after
  * the client sends `notifications/initialized`. An unknown tool is a
  * JSON-RPC `-32602` error, as the MCP spec asks; invalid arguments and
  * handler failures are `isError` tool results the model can read and fix.
  */
-export declare function createMcpServer(registry: ToolRegistry, options: McpServerOptions): McpServer;
+export declare function createMcpServer(registry: ToolSource, options: McpServerOptions): McpServer;

package/dist/tools/mcp-server.d.ts

@@ -1,4 +1,5 @@
-import type { ToolRegistry } from './registry.js';
+import type { ToolSource } from './registry.js';
+import { type SkillFiles } from './skills.js';
 /** MCP protocol revisions this server speaks, newest first. */
 export declare const MCP_PROTOCOL_VERSIONS: readonly ["2025-06-18", "2025-03-26", "2024-11-05"];
 export type JsonRpcId = string | number;
@@ -36,8 +37,18 @@ export interface McpServerOptions {
     name: string;
     version: string;
     title?: string;
-    /** Usage hints for the client's model, sent in the `initialize` result. */
-    instructions?: string;
+    /**
+     * Usage hints for the client's model, sent in the `initialize` result. Pass
+     * `toolsetInstructions` (or your own function) to describe the toolsets
+     * registered when the client connects.
+     */
+    instructions?: string | ((source: ToolSource) => string);
+    /**
+     * Agent skill files to serve as MCP resources (`skill://<name>/SKILL.md` and
+     * its reference files) and prompts (one per skill), so a client can load the
+     * guide for the tools it uses. See {@link SkillFiles}.
+     */
+    skills?: SkillFiles;
     /**
      * Sends server → client messages (`notifications/tools/list_changed`).
      * Without it the server still answers requests but announces nothing.
@@ -57,15 +68,22 @@ export interface McpServer {
     close(): void;
 }
 /**
- * A transport-agnostic MCP server for a {@link ToolRegistry}: wire `handle`
+ * Instructions describing the toolsets of a tool source: what each covers, how
+ * tools are named, and which skill documents it. Pass it as
+ * `createMcpServer(source, { instructions: toolsetInstructions })`.
+ */
+export declare function toolsetInstructions(source: ToolSource): string;
+/**
+ * A transport-agnostic MCP server for a {@link ToolRegistry} (or any {@link ToolSource}): wire `handle`
  * to any transport (stdio lines, a WebSocket, `postMessage`, an HTTP POST
  * handler) and pass `send` for server → client notifications.
  *
  * Supports `initialize` (with protocol version negotiation), `ping`,
- * `tools/list`, `tools/call` and `notifications/cancelled` (aborts the
+ * `tools/list`, `tools/call`, with `skills` `resources/list`, `resources/read`,
+ * `prompts/list` and `prompts/get`, and `notifications/cancelled` (aborts the
  * call's `signal`), and announces `notifications/tools/list_changed` after
  * the client sends `notifications/initialized`. An unknown tool is a
  * JSON-RPC `-32602` error, as the MCP spec asks; invalid arguments and
  * handler failures are `isError` tool results the model can read and fix.
  */
-export declare function createMcpServer(registry: ToolRegistry, options: McpServerOptions): McpServer;
+export declare function createMcpServer(registry: ToolSource, options: McpServerOptions): McpServer;