@pixerate/editor 0.139.1 → 0.140.0

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-R6DFK5OX.cjs');
 
 
 
@@ -11,7 +11,6 @@
 
 
 
-var _chunkSPVIXXIBcjs = require('../chunk-SPVIXXIB.cjs');
 
 
 
@@ -25,6 +24,7 @@ var _chunkSPVIXXIBcjs = require('../chunk-SPVIXXIB.cjs');
 
 
 
+var _chunkZAOOIJ6Icjs = require('../chunk-ZAOOIJ6I.cjs');
 
 
 
@@ -39,7 +39,6 @@ var _chunkSPVIXXIBcjs = require('../chunk-SPVIXXIB.cjs');
 
 
 
-var _chunkHGHXGCKGcjs = require('../chunk-HGHXGCKG.cjs');
 
 
 
@@ -48,7 +47,21 @@ 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 _chunkWOFXZ3XUcjs = require('../chunk-WOFXZ3XU.cjs');
@@ -98,4 +111,17 @@ 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 = _chunkZAOOIJ6Icjs.JSON_RPC_ERRORS; exports.MCP_PROTOCOL_VERSIONS = _chunkZAOOIJ6Icjs.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 = _chunkZAOOIJ6Icjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkZAOOIJ6Icjs.TOOL_BRIDGE_PROTOCOL; exports.TOOL_DISCOVERY_TOOLS = _chunkZAOOIJ6Icjs.TOOL_DISCOVERY_TOOLS; exports.TOOL_NAMESPACE_SEPARATOR = _chunkZAOOIJ6Icjs.TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = _chunkZAOOIJ6Icjs.ToolRegistry; exports.ToolRegistryError = _chunkZAOOIJ6Icjs.ToolRegistryError; exports.ToolRegistryView = _chunkZAOOIJ6Icjs.ToolRegistryView; exports.baseToolName = _chunkZAOOIJ6Icjs.baseToolName; exports.captureInputSchema = _chunkN2FGYZ4Qcjs.captureInputSchema; exports.captureOutputSize = _chunkN2FGYZ4Qcjs.captureOutputSize; exports.cloneElementWithStyles = _chunkSVFEVKLFcjs.cloneElementWithStyles; exports.connectToolBridge = _chunkZAOOIJ6Icjs.connectToolBridge; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createMcpServer = _chunkZAOOIJ6Icjs.createMcpServer; exports.createToolRegistry = _chunkZAOOIJ6Icjs.createToolRegistry; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkZAOOIJ6Icjs.errorResult; exports.listSkills = _chunkZAOOIJ6Icjs.listSkills; exports.parseSkillFrontmatter = _chunkZAOOIJ6Icjs.parseSkillFrontmatter; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkZAOOIJ6Icjs.readSkillFile; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.searchTokens = _chunkZAOOIJ6Icjs.searchTokens; exports.searchTools = _chunkZAOOIJ6Icjs.searchTools; exports.summarize = _chunkZAOOIJ6Icjs.summarize; exports.toCapturedImageData = _chunkN2FGYZ4Qcjs.toCapturedImageData; exports.toToolResult = _chunkZAOOIJ6Icjs.toToolResult; exports.toolsetInstructions = _chunkZAOOIJ6Icjs.toolsetInstructions; exports.toolsetName = _chunkZAOOIJ6Icjs.toolsetName; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unknownToolMessage = _chunkZAOOIJ6Icjs.unknownToolMessage; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;

package/dist/tools/index.d.cts

@@ -14,3 +14,6 @@ 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';

package/dist/tools/index.d.ts

@@ -14,3 +14,6 @@ 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';

package/dist/tools/index.js

@@ -1,17 +1,30 @@
-import "../chunk-SMJK5HBJ.js";
+import "../chunk-MCTQXUXR.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-WBKLYLZE.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,7 @@ import {
   resolveCaptureRequest,
   toCapturedImageData,
   unionCaptureRects
-} from "../chunk-BKMU3V6K.js";
+} from "../chunk-5ED73EC6.js";
 import {
   validateJsonSchema
 } from "../chunk-V2ZCJRDM.js";
@@ -79,9 +92,12 @@ export {
   MCP_TOOL_VIEW_EDITOR,
   TOOL_BRIDGE_DEFAULT_PORT,
   TOOL_BRIDGE_PROTOCOL,
+  TOOL_DISCOVERY_TOOLS,
   TOOL_NAMESPACE_SEPARATOR,
   ToolRegistry,
   ToolRegistryError,
+  ToolRegistryView,
+  baseToolName,
   captureInputSchema,
   captureOutputSize,
   cloneElementWithStyles,
@@ -92,10 +108,20 @@ export {
   createMcpServer,
   createToolRegistry,
   elementToSvg,
+  errorResult,
+  listSkills,
+  parseSkillFrontmatter,
   rasterizeElement,
+  readSkillFile,
   resolveCaptureRequest,
+  searchTokens,
+  searchTools,
+  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;

package/dist/tools/registry.d.cts

@@ -1,4 +1,5 @@
 import { type JsonSchema, type SchemaValidationError } from './schema.cjs';
+import { ToolRegistryView, type ToolViewOptions } from './view.cjs';
 /**
  * MCP-shaped tool definition, as returned by `tools/list`.
  */
@@ -59,12 +60,25 @@ export interface AgentTool extends McpToolDefinition {
 }
 /**
  * A source of tools, typically one per mounted editor, spreadsheet or canvas.
+ * Each provider is a toolset: its tools are exposed as `<namespace>__<name>`
+ * (see {@link ToolRegistryOptions.namespaces}) and grouped under that name by
+ * `toolsets()`, `registry.view()` and the discovery tools.
  */
 export interface AgentToolProvider {
-    /** Unique id within a registry, e.g. `doc-1`. Used as the namespace on collisions. */
+    /** Unique id within a registry, e.g. `doc-1`. The default namespace. */
     id: string;
-    /** Always prefix this provider's tools with `<namespace>__`. */
+    /**
+     * Prefix for this provider's tools (`<namespace>__<name>`). Defaults to the
+     * `id`. Pass `''` to expose bare names (prefixed by `id` only on a collision).
+     * Providers may share a namespace when their tool names differ.
+     */
     namespace?: string;
+    /** Short name of the toolset for agents and UIs, e.g. "Chart editor". */
+    title?: string;
+    /** What the toolset covers and when to use it, in a sentence or two. */
+    description?: string;
+    /** Name of the agent skill that documents these tools, e.g. `pixerate-chart`. */
+    skill?: string;
     /** Tools, or a function returning the current tools (re-read on every `listTools`). */
     tools: readonly AgentTool[] | (() => readonly AgentTool[]);
     /** Lets the provider signal that its tool list changed; returns an unsubscribe function. */
@@ -84,7 +98,18 @@ export declare class ToolRegistryError extends Error {
 }
 export interface ToolRegistryOptions {
     /**
-     * What to do when two providers contribute the same tool name:
+     * `always` (default): every tool is exposed as `<namespace>__<name>`, where the
+     * namespace is the provider's `namespace` or else its `id`, so names don't
+     * change when another editor mounts. `on-collision`: only providers with an
+     * explicit `namespace` are prefixed; other tools keep their bare name unless
+     * two providers share it (see `onCollision`).
+     *
+     * Either way, `callTool`, `hasTool` and `getTool` also accept a bare name
+     * when exactly one exposed tool has it.
+     */
+    namespaces?: 'always' | 'on-collision';
+    /**
+     * What to do when two unprefixed tools share a name:
      * `namespace` (default) exposes every colliding tool as `<providerId>__<name>`;
      * `error` makes `register` throw.
      */
@@ -96,6 +121,48 @@ export interface ToolRegistryOptions {
 }
 /** Separator between namespace and tool name; valid in MCP and LLM tool-name charsets. */
 export declare const TOOL_NAMESPACE_SEPARATOR = "__";
+/** The toolset a provider belongs to: its namespace, or else its id. */
+export declare function toolsetName(provider: Pick<AgentToolProvider, 'id' | 'namespace'>): string;
+/** The name a tool was registered under, without its namespace (`chart__get_chart` → `get_chart`). */
+export declare function baseToolName(name: string): string;
+/** A group of tools from one or more providers that share a namespace. */
+export interface ToolsetInfo {
+    /** Toolset name: the providers' namespace, or the provider id. */
+    name: string;
+    title?: string;
+    description?: string;
+    /** Agent skill that documents these tools. */
+    skill?: string;
+    /** Ids of the providers in this toolset. */
+    providers: string[];
+    /** Exposed names of its tools, in listing order. */
+    tools: string[];
+}
+/**
+ * Anything that serves tools the way a {@link ToolRegistry} does: a registry,
+ * a {@link ToolRegistryView} of one, or the MCP bridge's registry.
+ * `createMcpServer` and `connectToolBridge` accept any of them.
+ */
+export interface ToolSource {
+    readonly capabilities: {
+        tools: {
+            listChanged: boolean;
+        };
+    };
+    listTools(): McpListToolsResult;
+    hasTool(name: string): boolean;
+    getTool(name: string): McpToolDefinition | undefined;
+    callTool(name: string, args?: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+    }): Promise<McpToolResult>;
+    onListChanged(listener: (tools: McpToolDefinition[]) => void): () => void;
+    /** The toolsets behind `listTools()`, in listing order. */
+    toolsets(): ToolsetInfo[];
+}
+/** `unknown_tool` message, naming the tools a bare name could mean. */
+export declare function unknownToolMessage(name: string, candidates?: readonly string[]): string;
+/** An `isError` tool result carrying a {@link ToolCallError}. */
+export declare function errorResult(error: ToolCallError): McpToolResult;
 /** Normalizes a handler's return value into an MCP `tools/call` result. */
 export declare function toToolResult(value: unknown): McpToolResult;
 /**
@@ -106,7 +173,7 @@ export declare function toToolResult(value: unknown): McpToolResult;
  * tool list changes, mirroring MCP's `notifications/tools/list_changed`, so an
  * MCP server can be a thin wrapper around it.
  */
-export declare class ToolRegistry {
+export declare class ToolRegistry implements ToolSource {
     /** MCP server capabilities this registry supports. */
     readonly capabilities: {
         readonly tools: {
@@ -136,10 +203,18 @@ export declare class ToolRegistry {
     private resolve;
     /** MCP `tools/list` result for the current providers. */
     listTools(): McpListToolsResult;
-    /** Whether a tool with this exposed name exists. */
+    /** Whether a tool with this exposed name (or unique bare name) exists. */
     hasTool(name: string): boolean;
-    /** Looks up a tool definition by exposed name. */
+    /** Looks up a tool definition by exposed name (or unique bare name). */
     getTool(name: string): McpToolDefinition | undefined;
+    /** The registered providers grouped by namespace, in listing order. */
+    toolsets(): ToolsetInfo[];
+    /**
+     * A filtered, optionally self-discovering view of this registry: serve it
+     * with `createMcpServer` or `connectToolBridge` instead of the registry to
+     * show an agent only some toolsets. See {@link ToolRegistryView}.
+     */
+    view(options?: ToolViewOptions): ToolRegistryView;
     /**
      * Calls a tool by exposed name and returns an MCP `tools/call` result.
      * Never rejects: unknown tools, invalid arguments and handler errors come

package/dist/tools/registry.d.ts

@@ -1,4 +1,5 @@
 import { type JsonSchema, type SchemaValidationError } from './schema.js';
+import { ToolRegistryView, type ToolViewOptions } from './view.js';
 /**
  * MCP-shaped tool definition, as returned by `tools/list`.
  */
@@ -59,12 +60,25 @@ export interface AgentTool extends McpToolDefinition {
 }
 /**
  * A source of tools, typically one per mounted editor, spreadsheet or canvas.
+ * Each provider is a toolset: its tools are exposed as `<namespace>__<name>`
+ * (see {@link ToolRegistryOptions.namespaces}) and grouped under that name by
+ * `toolsets()`, `registry.view()` and the discovery tools.
  */
 export interface AgentToolProvider {
-    /** Unique id within a registry, e.g. `doc-1`. Used as the namespace on collisions. */
+    /** Unique id within a registry, e.g. `doc-1`. The default namespace. */
     id: string;
-    /** Always prefix this provider's tools with `<namespace>__`. */
+    /**
+     * Prefix for this provider's tools (`<namespace>__<name>`). Defaults to the
+     * `id`. Pass `''` to expose bare names (prefixed by `id` only on a collision).
+     * Providers may share a namespace when their tool names differ.
+     */
     namespace?: string;
+    /** Short name of the toolset for agents and UIs, e.g. "Chart editor". */
+    title?: string;
+    /** What the toolset covers and when to use it, in a sentence or two. */
+    description?: string;
+    /** Name of the agent skill that documents these tools, e.g. `pixerate-chart`. */
+    skill?: string;
     /** Tools, or a function returning the current tools (re-read on every `listTools`). */
     tools: readonly AgentTool[] | (() => readonly AgentTool[]);
     /** Lets the provider signal that its tool list changed; returns an unsubscribe function. */
@@ -84,7 +98,18 @@ export declare class ToolRegistryError extends Error {
 }
 export interface ToolRegistryOptions {
     /**
-     * What to do when two providers contribute the same tool name:
+     * `always` (default): every tool is exposed as `<namespace>__<name>`, where the
+     * namespace is the provider's `namespace` or else its `id`, so names don't
+     * change when another editor mounts. `on-collision`: only providers with an
+     * explicit `namespace` are prefixed; other tools keep their bare name unless
+     * two providers share it (see `onCollision`).
+     *
+     * Either way, `callTool`, `hasTool` and `getTool` also accept a bare name
+     * when exactly one exposed tool has it.
+     */
+    namespaces?: 'always' | 'on-collision';
+    /**
+     * What to do when two unprefixed tools share a name:
      * `namespace` (default) exposes every colliding tool as `<providerId>__<name>`;
      * `error` makes `register` throw.
      */
@@ -96,6 +121,48 @@ export interface ToolRegistryOptions {
 }
 /** Separator between namespace and tool name; valid in MCP and LLM tool-name charsets. */
 export declare const TOOL_NAMESPACE_SEPARATOR = "__";
+/** The toolset a provider belongs to: its namespace, or else its id. */
+export declare function toolsetName(provider: Pick<AgentToolProvider, 'id' | 'namespace'>): string;
+/** The name a tool was registered under, without its namespace (`chart__get_chart` → `get_chart`). */
+export declare function baseToolName(name: string): string;
+/** A group of tools from one or more providers that share a namespace. */
+export interface ToolsetInfo {
+    /** Toolset name: the providers' namespace, or the provider id. */
+    name: string;
+    title?: string;
+    description?: string;
+    /** Agent skill that documents these tools. */
+    skill?: string;
+    /** Ids of the providers in this toolset. */
+    providers: string[];
+    /** Exposed names of its tools, in listing order. */
+    tools: string[];
+}
+/**
+ * Anything that serves tools the way a {@link ToolRegistry} does: a registry,
+ * a {@link ToolRegistryView} of one, or the MCP bridge's registry.
+ * `createMcpServer` and `connectToolBridge` accept any of them.
+ */
+export interface ToolSource {
+    readonly capabilities: {
+        tools: {
+            listChanged: boolean;
+        };
+    };
+    listTools(): McpListToolsResult;
+    hasTool(name: string): boolean;
+    getTool(name: string): McpToolDefinition | undefined;
+    callTool(name: string, args?: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+    }): Promise<McpToolResult>;
+    onListChanged(listener: (tools: McpToolDefinition[]) => void): () => void;
+    /** The toolsets behind `listTools()`, in listing order. */
+    toolsets(): ToolsetInfo[];
+}
+/** `unknown_tool` message, naming the tools a bare name could mean. */
+export declare function unknownToolMessage(name: string, candidates?: readonly string[]): string;
+/** An `isError` tool result carrying a {@link ToolCallError}. */
+export declare function errorResult(error: ToolCallError): McpToolResult;
 /** Normalizes a handler's return value into an MCP `tools/call` result. */
 export declare function toToolResult(value: unknown): McpToolResult;
 /**
@@ -106,7 +173,7 @@ export declare function toToolResult(value: unknown): McpToolResult;
  * tool list changes, mirroring MCP's `notifications/tools/list_changed`, so an
  * MCP server can be a thin wrapper around it.
  */
-export declare class ToolRegistry {
+export declare class ToolRegistry implements ToolSource {
     /** MCP server capabilities this registry supports. */
     readonly capabilities: {
         readonly tools: {
@@ -136,10 +203,18 @@ export declare class ToolRegistry {
     private resolve;
     /** MCP `tools/list` result for the current providers. */
     listTools(): McpListToolsResult;
-    /** Whether a tool with this exposed name exists. */
+    /** Whether a tool with this exposed name (or unique bare name) exists. */
     hasTool(name: string): boolean;
-    /** Looks up a tool definition by exposed name. */
+    /** Looks up a tool definition by exposed name (or unique bare name). */
     getTool(name: string): McpToolDefinition | undefined;
+    /** The registered providers grouped by namespace, in listing order. */
+    toolsets(): ToolsetInfo[];
+    /**
+     * A filtered, optionally self-discovering view of this registry: serve it
+     * with `createMcpServer` or `connectToolBridge` instead of the registry to
+     * show an agent only some toolsets. See {@link ToolRegistryView}.
+     */
+    view(options?: ToolViewOptions): ToolRegistryView;
     /**
      * Calls a tool by exposed name and returns an MCP `tools/call` result.
      * Never rejects: unknown tools, invalid arguments and handler errors come

package/dist/tools/search.d.cts

@@ -0,0 +1,30 @@
+import type { McpToolDefinition, ToolsetInfo } from './registry.cjs';
+/** A tool as `search_tools` ranks it. */
+export interface ToolSearchResult {
+    /** Exposed tool name, to call or to pass to `enable_tools`. */
+    name: string;
+    toolset: string;
+    title?: string;
+    /** The first sentence of the tool's description. */
+    summary: string;
+    readOnly: boolean;
+    score: number;
+}
+export interface ToolSearchOptions {
+    /** Only search this toolset. */
+    toolset?: string;
+    /** Maximum results (default 10). */
+    limit?: number;
+}
+/** Lower-cased, stemmed word tokens of `text`, splitting snake_case and camelCase. */
+export declare function searchTokens(text: string): string[];
+/** The first sentence of a description, for compact listings. */
+export declare function summarize(description: string | undefined, max?: number): string;
+/**
+ * Ranks tools against a free-text query: every query word scores by the
+ * fields it appears in (name, title, toolset, description, arguments), weighted by how
+ * rare the word is across all tools, so "trendline" outranks "chart". A word
+ * that prefixes a longer one ("trend" → "trendline") counts at half weight.
+ * Pure and dependency-free; `search_tools` uses it.
+ */
+export declare function searchTools(tools: readonly McpToolDefinition[], toolsets: readonly ToolsetInfo[], query: string, options?: ToolSearchOptions): ToolSearchResult[];

package/dist/tools/search.d.ts

@@ -0,0 +1,30 @@
+import type { McpToolDefinition, ToolsetInfo } from './registry.js';
+/** A tool as `search_tools` ranks it. */
+export interface ToolSearchResult {
+    /** Exposed tool name, to call or to pass to `enable_tools`. */
+    name: string;
+    toolset: string;
+    title?: string;
+    /** The first sentence of the tool's description. */
+    summary: string;
+    readOnly: boolean;
+    score: number;
+}
+export interface ToolSearchOptions {
+    /** Only search this toolset. */
+    toolset?: string;
+    /** Maximum results (default 10). */
+    limit?: number;
+}
+/** Lower-cased, stemmed word tokens of `text`, splitting snake_case and camelCase. */
+export declare function searchTokens(text: string): string[];
+/** The first sentence of a description, for compact listings. */
+export declare function summarize(description: string | undefined, max?: number): string;
+/**
+ * Ranks tools against a free-text query: every query word scores by the
+ * fields it appears in (name, title, toolset, description, arguments), weighted by how
+ * rare the word is across all tools, so "trendline" outranks "chart". A word
+ * that prefixes a longer one ("trend" → "trendline") counts at half weight.
+ * Pure and dependency-free; `search_tools` uses it.
+ */
+export declare function searchTools(tools: readonly McpToolDefinition[], toolsets: readonly ToolsetInfo[], query: string, options?: ToolSearchOptions): ToolSearchResult[];

package/dist/tools/skills.d.cts

@@ -0,0 +1,26 @@
+/**
+ * Agent skill files (`skills/<name>/SKILL.md` plus its `references/*.md`), keyed by
+ * path relative to the skills directory: `pixerate-chart/SKILL.md`,
+ * `pixerate-vector/references/commands.md`. In Node, `loadSkillFiles()` from
+ * `@pixerate/editor/bridge` reads the ones shipped with the package; in a browser,
+ * import them as text (with Vite, `import.meta.glob('…/skills/**\/*.md', { query: '?raw', import: 'default', eager: true })`).
+ */
+export type SkillFiles = Readonly<Record<string, string>>;
+export interface SkillInfo {
+    /** Skill name (its directory), e.g. `pixerate-chart`. */
+    name: string;
+    /** The frontmatter `description`: what the skill covers and when to use it. */
+    description: string;
+    /** Other files of the skill relative to its directory, e.g. `references/commands.md`. */
+    references: string[];
+}
+/** Reads `name` and `description` from a SKILL.md's YAML frontmatter. */
+export declare function parseSkillFrontmatter(markdown: string): {
+    name?: string;
+    description?: string;
+    body: string;
+};
+/** The skills in a set of skill files, sorted by name. */
+export declare function listSkills(files: SkillFiles): SkillInfo[];
+/** One file of a skill (`SKILL.md` by default), or `undefined` if there is none. */
+export declare function readSkillFile(files: SkillFiles, skill: string, file?: string): string | undefined;