@pixerate/editor 0.22.0 → 0.24.0

package/dist/agent/index.d.cts

@@ -1,6 +1,9 @@
-import { C as CanvasNode, a as CanvasEdge, X as XYPosition, S as Side } from '../types-CJ4U-HHI.cjs';
+import { C as CanvasNode, b as CanvasEdge, X as XYPosition, S as Side } from '../types-DX4Mh4SL.cjs';
+export { J as JsonSchema, a as JsonSchemaType, S as SchemaValidationError, v as validateJsonSchema } from '../schema-DYDGdYL9.cjs';
+import { A as AgentToolProvider } from '../registry-DnzpgY27.cjs';
+export { a as AgentTool, b as AgentToolHandler, M as McpListToolsResult, c as McpToolContent, d as McpToolDefinition, e as McpToolResult, T as TOOL_NAMESPACE_SEPARATOR, f as ToolCallContext, g as ToolCallError, h as ToolErrorCode, i as ToolRegistry, j as ToolRegistryError, k as ToolRegistryOptions, l as createToolRegistry, t as toToolResult } from '../registry-DnzpgY27.cjs';
 import { Editor } from '@tiptap/core';
-import { S as SpreadsheetController } from '../controller-B7GIybc4.cjs';
+import { S as SpreadsheetController } from '../controller-BhLLAoi8.cjs';
 
 /**
  * Agent presence state for visual multiplayer/agent choreography.
@@ -196,6 +199,14 @@ declare function planToolCall<TNode extends CanvasNode = CanvasNode, TEdge exten
  */
 declare const MCP_TOOL_GET_EDITOR_STATE: {
     readonly name: "get_editor_state";
+    readonly title: "Get editor state";
+    readonly annotations: {
+        readonly title: "Get editor state";
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+    };
     readonly description: "Retrieves the current state of the document, variables, selection, and canvas graph (nodes and edges).";
     readonly inputSchema: {
         readonly type: "object";
@@ -213,6 +224,14 @@ declare const MCP_TOOL_GET_EDITOR_STATE: {
 };
 declare const MCP_TOOL_EDIT_CANVAS: {
     readonly name: "edit_canvas";
+    readonly title: "Edit the canvas";
+    readonly annotations: {
+        readonly title: "Edit the canvas";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+    };
     readonly description: "Applies high-level structural operations to the visual canvas (adding nodes, connecting edges, organizing layout, or moving elements).";
     readonly inputSchema: {
         readonly type: "object";
@@ -269,6 +288,14 @@ declare const MCP_TOOL_EDIT_CANVAS: {
 };
 declare const MCP_TOOL_EDIT_PROMPT: {
     readonly name: "edit_prompt";
+    readonly title: "Edit the prompt";
+    readonly annotations: {
+        readonly title: "Edit the prompt";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+    };
     readonly description: "Applies edits to the prompt template document, including inserting text, replacing ranges, and setting variables.";
     readonly inputSchema: {
         readonly type: "object";
@@ -307,6 +334,14 @@ declare const MCP_TOOL_EDIT_PROMPT: {
 };
 declare const MCP_TOOL_VIEW_EDITOR: {
     readonly name: "view_editor";
+    readonly title: "View the editor";
+    readonly annotations: {
+        readonly title: "View the editor";
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+    };
     readonly description: "Captures a visual image snapshot (JPEG or PNG) of the editor canvas or viewport for multimodal evaluation. Active agent cursor indicators are automatically excluded from the snapshot.";
     readonly inputSchema: {
         readonly type: "object";
@@ -335,6 +370,14 @@ declare const MCP_TOOL_VIEW_EDITOR: {
 declare const EXPORT_EXCLUDED_SELECTORS: readonly [".pixerate-presence", ".agent-presence", ".ursula-presence"];
 declare const EDITOR_MCP_TOOLS: readonly [{
     readonly name: "get_editor_state";
+    readonly title: "Get editor state";
+    readonly annotations: {
+        readonly title: "Get editor state";
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+    };
     readonly description: "Retrieves the current state of the document, variables, selection, and canvas graph (nodes and edges).";
     readonly inputSchema: {
         readonly type: "object";
@@ -351,6 +394,14 @@ declare const EDITOR_MCP_TOOLS: readonly [{
     };
 }, {
     readonly name: "edit_canvas";
+    readonly title: "Edit the canvas";
+    readonly annotations: {
+        readonly title: "Edit the canvas";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+    };
     readonly description: "Applies high-level structural operations to the visual canvas (adding nodes, connecting edges, organizing layout, or moving elements).";
     readonly inputSchema: {
         readonly type: "object";
@@ -406,6 +457,14 @@ declare const EDITOR_MCP_TOOLS: readonly [{
     };
 }, {
     readonly name: "edit_prompt";
+    readonly title: "Edit the prompt";
+    readonly annotations: {
+        readonly title: "Edit the prompt";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+    };
     readonly description: "Applies edits to the prompt template document, including inserting text, replacing ranges, and setting variables.";
     readonly inputSchema: {
         readonly type: "object";
@@ -443,6 +502,14 @@ declare const EDITOR_MCP_TOOLS: readonly [{
     };
 }, {
     readonly name: "view_editor";
+    readonly title: "View the editor";
+    readonly annotations: {
+        readonly title: "View the editor";
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+    };
     readonly description: "Captures a visual image snapshot (JPEG or PNG) of the editor canvas or viewport for multimodal evaluation. Active agent cursor indicators are automatically excluded from the snapshot.";
     readonly inputSchema: {
         readonly type: "object";
@@ -465,214 +532,6 @@ declare const EDITOR_MCP_TOOLS: readonly [{
     };
 }];
 
-/**
- * JSON-Schema-lite: the subset of JSON Schema used by MCP tool `inputSchema`s,
- * plus a small validator for tool-call arguments. Unknown keywords are ignored.
- */
-type JsonSchemaType = 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array' | 'null';
-interface JsonSchema {
-    type?: JsonSchemaType | readonly JsonSchemaType[];
-    description?: string;
-    title?: string;
-    enum?: readonly unknown[];
-    const?: unknown;
-    default?: unknown;
-    properties?: {
-        readonly [key: string]: JsonSchema;
-    };
-    required?: readonly string[];
-    additionalProperties?: boolean | JsonSchema;
-    items?: JsonSchema;
-    minItems?: number;
-    maxItems?: number;
-    minimum?: number;
-    maximum?: number;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    [keyword: string]: unknown;
-}
-interface SchemaValidationError {
-    /** JSON-pointer-like path to the offending value, e.g. `/node/id` (`""` is the root). */
-    path: string;
-    message: string;
-}
-/**
- * Validates `value` against `schema` and returns every error found (an empty
- * array means valid). Supports `type` (incl. arrays of types), `enum`, `const`,
- * `properties`, `required`, `additionalProperties`, `items`, `minItems`,
- * `maxItems`, `minimum`, `maximum`, `minLength`, `maxLength` and `pattern`.
- */
-declare function validateJsonSchema(value: unknown, schema: JsonSchema | undefined, path?: string): SchemaValidationError[];
-
-/**
- * MCP-shaped tool definition, as returned by `tools/list`.
- */
-interface McpToolDefinition {
-    name: string;
-    title?: string;
-    description?: string;
-    inputSchema: JsonSchema & {
-        type: 'object';
-    };
-    outputSchema?: JsonSchema;
-    annotations?: {
-        title?: string;
-        readOnlyHint?: boolean;
-        destructiveHint?: boolean;
-        idempotentHint?: boolean;
-        openWorldHint?: boolean;
-        [key: string]: unknown;
-    };
-}
-type McpToolContent = {
-    type: 'text';
-    text: string;
-} | {
-    type: 'image';
-    data: string;
-    mimeType: string;
-} | {
-    type: string;
-    [key: string]: unknown;
-};
-/** MCP `tools/call` result. */
-interface McpToolResult {
-    content: McpToolContent[];
-    structuredContent?: Record<string, unknown>;
-    isError?: boolean;
-}
-/** MCP `tools/list` result. */
-interface McpListToolsResult {
-    tools: McpToolDefinition[];
-}
-interface ToolCallContext {
-    /** Name the tool was called by (possibly namespaced). */
-    name: string;
-    /** Id of the provider that owns the tool. */
-    providerId: string;
-    signal?: AbortSignal;
-}
-/**
- * Handler return values are normalized into an {@link McpToolResult}: a full
- * result (`{ content: [...] }`) is passed through, a string becomes a text
- * block, `undefined` becomes an empty result, and anything else is returned
- * as `structuredContent` (plain objects) plus a JSON text block.
- */
-type AgentToolHandler = (args: Record<string, any>, context: ToolCallContext) => unknown | Promise<unknown>;
-interface AgentTool extends McpToolDefinition {
-    handler: AgentToolHandler;
-}
-/**
- * A source of tools, typically one per mounted editor, spreadsheet or canvas.
- */
-interface AgentToolProvider {
-    /** Unique id within a registry, e.g. `doc-1`. Used as the namespace on collisions. */
-    id: string;
-    /** Always prefix this provider's tools with `<namespace>__`. */
-    namespace?: 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. */
-    subscribe?: (notify: () => void) => () => void;
-}
-type ToolErrorCode = 'unknown_tool' | 'invalid_arguments' | 'tool_failed';
-/** Structured error carried in `structuredContent.error` of a failed call. */
-interface ToolCallError {
-    code: ToolErrorCode;
-    message: string;
-    tool: string;
-    details?: SchemaValidationError[];
-}
-declare class ToolRegistryError extends Error {
-    readonly code: 'duplicate_provider' | 'name_collision' | 'invalid_tool';
-    constructor(code: ToolRegistryError['code'], message: string);
-}
-interface ToolRegistryOptions {
-    /**
-     * What to do when two providers contribute the same tool name:
-     * `namespace` (default) exposes every colliding tool as `<providerId>__<name>`;
-     * `error` makes `register` throw.
-     */
-    onCollision?: 'namespace' | 'error';
-    /** Coalescing window for `listChanged` notifications in ms (default 0: same tick). */
-    listChangedDelayMs?: number;
-    /** Validate arguments against `inputSchema` before calling handlers (default `true`). */
-    validateArguments?: boolean;
-}
-/** Separator between namespace and tool name; valid in MCP and LLM tool-name charsets. */
-declare const TOOL_NAMESPACE_SEPARATOR = "__";
-/** Normalizes a handler's return value into an MCP `tools/call` result. */
-declare function toToolResult(value: unknown): McpToolResult;
-/**
- * Transport-agnostic registry of agent tools contributed by live providers.
- *
- * `listTools()` and `callTool()` return MCP `tools/list` / `tools/call`
- * result shapes, and `onListChanged` fires (coalesced) whenever the exposed
- * tool list changes, mirroring MCP's `notifications/tools/list_changed`, so an
- * MCP server can be a thin wrapper around it.
- */
-declare class ToolRegistry {
-    /** MCP server capabilities this registry supports. */
-    readonly capabilities: {
-        readonly tools: {
-            readonly listChanged: true;
-        };
-    };
-    private readonly entries;
-    private readonly listeners;
-    private readonly options;
-    private timer;
-    private lastSignature;
-    constructor(options?: ToolRegistryOptions);
-    /**
-     * Registers a provider and returns a function that unregisters it.
-     * Throws a {@link ToolRegistryError} for a duplicate provider id, an invalid
-     * tool name, or (with `onCollision: 'error'`) a tool name collision.
-     */
-    register(provider: AgentToolProvider): () => void;
-    /** Removes a provider by id or instance. Returns whether it was registered. */
-    unregister(providerOrId: string | AgentToolProvider): boolean;
-    /** Registered provider ids in registration order. */
-    providerIds(): string[];
-    /**
-     * Resolves exposed names. Tools are ordered by provider registration, then
-     * by their order within the provider.
-     */
-    private resolve;
-    /** MCP `tools/list` result for the current providers. */
-    listTools(): McpListToolsResult;
-    /** Whether a tool with this exposed name exists. */
-    hasTool(name: string): boolean;
-    /** Looks up a tool definition by exposed name. */
-    getTool(name: string): McpToolDefinition | undefined;
-    /**
-     * Calls a tool by exposed name and returns an MCP `tools/call` result.
-     * Never rejects: unknown tools, invalid arguments and handler errors come
-     * back as `isError: true` results with a {@link ToolCallError} in
-     * `structuredContent.error` (MCP transports may map `unknown_tool` to a
-     * JSON-RPC `-32602` error instead).
-     */
-    callTool(name: string, args?: Record<string, unknown>, options?: {
-        signal?: AbortSignal;
-    }): Promise<McpToolResult>;
-    /**
-     * Subscribes to tool-list changes. Notifications are coalesced: many
-     * registrations or provider signals within the delay window produce one
-     * call, and none if the exposed list ends up unchanged (e.g. a provider
-     * unmounted and remounted). Returns an unsubscribe function.
-     */
-    onListChanged(listener: (tools: McpToolDefinition[]) => void): () => void;
-    /** Schedules a coalesced `listChanged` check; providers may call it directly. */
-    notifyListChanged(): void;
-    /** Runs a pending `listChanged` check immediately. */
-    flush(): void;
-    private signature;
-    /** Unregisters every provider and listener and cancels pending notifications. */
-    dispose(): void;
-}
-declare function createToolRegistry(options?: ToolRegistryOptions): ToolRegistry;
-
 interface ToolProviderOptions {
     /** Provider id (unique per registry). */
     id: string;
@@ -723,4 +582,4 @@ interface EditorMcpToolProviderOptions<TNode extends CanvasNode = CanvasNode, TE
  */
 declare function createEditorMcpToolProvider<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge>(options: EditorMcpToolProviderOptions<TNode, TEdge>): AgentToolProvider;
 
-export { type AgentCommand, type AgentPresence, type AgentStep, type AgentTool, type AgentToolHandler, type AgentToolProvider, EDITOR_MCP_TOOLS, EXPORT_EXCLUDED_SELECTORS, type EditorMcpToolProviderOptions, type EditorSnapshot, type JsonSchema, type JsonSchemaType, MCP_TOOL_EDIT_CANVAS, MCP_TOOL_EDIT_PROMPT, MCP_TOOL_GET_EDITOR_STATE, MCP_TOOL_VIEW_EDITOR, type McpListToolsResult, type McpToolContent, type McpToolDefinition, type McpToolResult, type RichTextToolTarget, type SchemaValidationError, TOOL_NAMESPACE_SEPARATOR, type ToolCallContext, type ToolCallError, type ToolErrorCode, type ToolProviderOptions, ToolRegistry, ToolRegistryError, type ToolRegistryOptions, createEditorMcpToolProvider, createRichTextToolProvider, createSpreadsheetToolProvider, createToolRegistry, normalizeSide, planAgentCommand, planToolCall, toToolResult, toolCallToAgentCommand, validateJsonSchema };
+export { type AgentCommand, type AgentPresence, type AgentStep, AgentToolProvider, EDITOR_MCP_TOOLS, EXPORT_EXCLUDED_SELECTORS, type EditorMcpToolProviderOptions, type EditorSnapshot, MCP_TOOL_EDIT_CANVAS, MCP_TOOL_EDIT_PROMPT, MCP_TOOL_GET_EDITOR_STATE, MCP_TOOL_VIEW_EDITOR, type RichTextToolTarget, type ToolProviderOptions, createEditorMcpToolProvider, createRichTextToolProvider, createSpreadsheetToolProvider, normalizeSide, planAgentCommand, planToolCall, toolCallToAgentCommand };