@pixerate/editor 0.44.0 → 0.45.0

package/dist/tools/index.d.cts

@@ -1,5 +1,6 @@
-export { J as JsonSchema, a as JsonSchemaType, S as SchemaValidationError, v as validateJsonSchema } from '../schema-DYDGdYL9.cjs';
-export { a as AgentTool, b as AgentToolHandler, A as AgentToolProvider, 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';
+export { J as JsonSchema, a as JsonSchemaType, S as SchemaValidationError, v as validateJsonSchema } from '../schema-Di0CS6Pe.cjs';
+import { i as ToolRegistry } from '../registry-B4l-lYts.cjs';
+export { a as AgentTool, b as AgentToolHandler, A as AgentToolProvider, 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, j as ToolRegistryError, k as ToolRegistryOptions, l as createToolRegistry, t as toToolResult } from '../registry-B4l-lYts.cjs';
 
 /**
  * Standard MCP Tool Definitions for @pixerate/editor.
@@ -40,7 +41,7 @@ declare const MCP_TOOL_EDIT_CANVAS: {
         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 description: string;
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -69,6 +70,23 @@ declare const MCP_TOOL_EDIT_CANVAS: {
                 };
                 readonly description: "Array of node IDs for remove_nodes, select, or highlight.";
             };
+            readonly id: {
+                readonly type: "string";
+                readonly description: "Node ID for update_node (or pass `node: { id, data }`).";
+            };
+            readonly data: {
+                readonly type: "object";
+                readonly description: "Data fields to merge into the node for update_node.";
+            };
+            readonly color: {
+                readonly type: "string";
+                readonly description: "CSS color for highlight (default #3b82f6).";
+            };
+            readonly durationMs: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly description: "How long the highlight lasts in ms (default 2000).";
+            };
             readonly source: {
                 readonly type: "string";
                 readonly description: "Source node ID for connect operation.";
@@ -118,15 +136,18 @@ declare const MCP_TOOL_EDIT_PROMPT: {
                 readonly description: "Text to insert or replace.";
             };
             readonly at: {
-                readonly type: "number";
+                readonly type: "integer";
+                readonly minimum: 0;
                 readonly description: "Position to insert text at.";
             };
             readonly from: {
-                readonly type: "number";
+                readonly type: "integer";
+                readonly minimum: 0;
                 readonly description: "Start offset for replace_range or select.";
             };
             readonly to: {
-                readonly type: "number";
+                readonly type: "integer";
+                readonly minimum: 0;
                 readonly description: "End offset for replace_range or select.";
             };
             readonly name: {
@@ -171,6 +192,754 @@ declare const MCP_TOOL_VIEW_EDITOR: {
         };
     };
 };
+declare const MCP_TOOL_CANVAS_ADD_NODE: {
+    readonly name: "canvas_add_node";
+    readonly title: "Add a canvas node";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+        readonly title: "Add a canvas node";
+    };
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly node: {
+                readonly type: "object";
+                readonly description: "The node. Extra host-specific fields are kept.";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "Node id (default: generated). Must be unused.";
+                    };
+                    readonly type: {
+                        readonly type: "string";
+                        readonly description: "Node type registered by the host.";
+                    };
+                    readonly data: {
+                        readonly type: "object";
+                        readonly description: "Node data (e.g. { \"label\": \"...\" }).";
+                    };
+                    readonly position: {
+                        readonly description: "Canvas coordinates (default: auto-placed).";
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                            };
+                        };
+                        readonly required: readonly ["x", "y"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly width: {
+                        readonly type: "number";
+                        readonly exclusiveMinimum: 0;
+                    };
+                    readonly height: {
+                        readonly type: "number";
+                        readonly exclusiveMinimum: 0;
+                    };
+                    readonly parentId: {
+                        readonly type: "string";
+                        readonly description: "Parent (group/frame) node id.";
+                    };
+                };
+            };
+            readonly nearNodeId: {
+                readonly type: "string";
+                readonly description: "Existing node to place the new node beside and connect from.";
+            };
+            readonly side: {
+                readonly type: "string";
+                readonly enum: readonly ["top", "right", "bottom", "left"];
+                readonly description: "Side of `nearNodeId` to place the node on (default right).";
+            };
+        };
+        readonly required: readonly ["node"];
+        readonly additionalProperties: false;
+    };
+};
+declare const MCP_TOOL_CANVAS_REMOVE_NODES: {
+    readonly name: "canvas_remove_nodes";
+    readonly title: "Remove canvas nodes";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+        readonly title: "Remove canvas nodes";
+    };
+    readonly description: "Removes nodes (and their edges) from the canvas. Every id must exist.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly nodeIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly minItems: 1;
+                readonly uniqueItems: true;
+                readonly description: "Node ids (from get_editor_state).";
+            };
+        };
+        readonly required: readonly ["nodeIds"];
+        readonly additionalProperties: false;
+    };
+};
+declare const MCP_TOOL_CANVAS_CONNECT: {
+    readonly name: "canvas_connect";
+    readonly title: "Connect canvas nodes";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+        readonly title: "Connect canvas nodes";
+    };
+    readonly description: "Adds an edge from one existing node to another. Returns the new edge id.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly source: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "Source node id.";
+            };
+            readonly target: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "Target node id.";
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly description: "Edge label.";
+            };
+        };
+        readonly required: readonly ["source", "target"];
+        readonly additionalProperties: false;
+    };
+};
+declare const MCP_TOOL_CANVAS_UPDATE_NODE: {
+    readonly name: "canvas_update_node";
+    readonly title: "Update a canvas node";
+    readonly annotations: {
+        readonly idempotentHint: true;
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly openWorldHint: false;
+        readonly title: "Update a canvas node";
+    };
+    readonly description: "Merges fields into an existing node's data.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "Node id.";
+            };
+            readonly data: {
+                readonly type: "object";
+                readonly description: "Data fields to merge (e.g. { \"label\": \"New\" }).";
+            };
+        };
+        readonly required: readonly ["id", "data"];
+        readonly additionalProperties: false;
+    };
+};
+declare const MCP_TOOL_CANVAS_LAYOUT: {
+    readonly name: "canvas_layout";
+    readonly title: "Lay out the canvas";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+        readonly title: "Lay out the canvas";
+    };
+    readonly description: "Arranges the canvas graph automatically.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly direction: {
+                readonly type: "string";
+                readonly enum: readonly ["LR", "TB", "RL", "BT"];
+                readonly description: "Layout direction (default LR).";
+            };
+            readonly incremental: {
+                readonly type: "boolean";
+                readonly description: "Keep nodes that already have a position where they are (default true).";
+            };
+        };
+        readonly additionalProperties: false;
+    };
+};
+declare const MCP_TOOL_CANVAS_SELECT: {
+    readonly name: "canvas_select";
+    readonly title: "Select canvas nodes";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+        readonly title: "Select canvas nodes";
+    };
+    readonly description: "Replaces the canvas selection with these nodes (an empty list clears it).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly nodeIds: {
+                readonly minItems: 0;
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly uniqueItems: true;
+                readonly description: "Node ids (from get_editor_state).";
+            };
+        };
+        readonly required: readonly ["nodeIds"];
+        readonly additionalProperties: false;
+    };
+};
+declare const MCP_TOOL_CANVAS_HIGHLIGHT: {
+    readonly name: "canvas_highlight";
+    readonly title: "Highlight canvas nodes";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+        readonly title: "Highlight canvas nodes";
+    };
+    readonly description: "Briefly highlights nodes to draw the user's attention to them.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly nodeIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly minItems: 1;
+                readonly uniqueItems: true;
+                readonly description: "Node ids (from get_editor_state).";
+            };
+            readonly color: {
+                readonly type: "string";
+                readonly description: "CSS color (default #3b82f6).";
+            };
+            readonly durationMs: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly maximum: 60000;
+                readonly description: "Duration in ms (default 2000).";
+            };
+        };
+        readonly required: readonly ["nodeIds"];
+        readonly additionalProperties: false;
+    };
+};
+declare const MCP_TOOL_PROMPT_INSERT_TEXT: {
+    readonly name: "prompt_insert_text";
+    readonly title: "Insert prompt text";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+        readonly title: "Insert prompt text";
+    };
+    readonly description: "Inserts text into the prompt at a position, or at the cursor when `at` is omitted.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly text: {
+                readonly type: "string";
+                readonly description: "Text to insert.";
+            };
+            readonly at: {
+                readonly description: "Position (as in get_editor_state `document.selection`).";
+                readonly type: "integer";
+                readonly minimum: 0;
+            };
+        };
+        readonly required: readonly ["text"];
+        readonly additionalProperties: false;
+    };
+};
+declare const MCP_TOOL_PROMPT_REPLACE_RANGE: {
+    readonly name: "prompt_replace_range";
+    readonly title: "Replace prompt text";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+        readonly title: "Replace prompt text";
+    };
+    readonly description: "Replaces the prompt text between two positions (an empty text deletes it).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly from: {
+                readonly description: "Start position.";
+                readonly type: "integer";
+                readonly minimum: 0;
+            };
+            readonly to: {
+                readonly description: "End position (>= from).";
+                readonly type: "integer";
+                readonly minimum: 0;
+            };
+            readonly text: {
+                readonly type: "string";
+                readonly description: "Replacement text.";
+            };
+        };
+        readonly required: readonly ["from", "to", "text"];
+        readonly additionalProperties: false;
+    };
+};
+declare const MCP_TOOL_PROMPT_SET_VARIABLE: {
+    readonly name: "prompt_set_variable";
+    readonly title: "Set a prompt variable";
+    readonly annotations: {
+        readonly idempotentHint: true;
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly openWorldHint: false;
+        readonly title: "Set a prompt variable";
+    };
+    readonly description: "Sets the value of a template variable used by the prompt.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "Variable name.";
+            };
+            readonly value: {
+                readonly description: "Variable value (any JSON value).";
+            };
+        };
+        readonly required: readonly ["name", "value"];
+        readonly additionalProperties: false;
+    };
+};
+declare const MCP_TOOL_PROMPT_SELECT: {
+    readonly name: "prompt_select";
+    readonly title: "Select prompt text";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+        readonly title: "Select prompt text";
+    };
+    readonly description: "Selects the prompt text between two positions (from === to places the cursor).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly from: {
+                readonly description: "Start position.";
+                readonly type: "integer";
+                readonly minimum: 0;
+            };
+            readonly to: {
+                readonly description: "End position (>= from).";
+                readonly type: "integer";
+                readonly minimum: 0;
+            };
+        };
+        readonly required: readonly ["from", "to"];
+        readonly additionalProperties: false;
+    };
+};
+/** Per-operation canvas tools, the strict alternative to `edit_canvas`. */
+declare const EDITOR_CANVAS_TOOLS: readonly [{
+    readonly name: "canvas_add_node";
+    readonly title: "Add a canvas node";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+        readonly title: "Add a canvas node";
+    };
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly node: {
+                readonly type: "object";
+                readonly description: "The node. Extra host-specific fields are kept.";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "Node id (default: generated). Must be unused.";
+                    };
+                    readonly type: {
+                        readonly type: "string";
+                        readonly description: "Node type registered by the host.";
+                    };
+                    readonly data: {
+                        readonly type: "object";
+                        readonly description: "Node data (e.g. { \"label\": \"...\" }).";
+                    };
+                    readonly position: {
+                        readonly description: "Canvas coordinates (default: auto-placed).";
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                            };
+                        };
+                        readonly required: readonly ["x", "y"];
+                        readonly additionalProperties: false;
+                    };
+                    readonly width: {
+                        readonly type: "number";
+                        readonly exclusiveMinimum: 0;
+                    };
+                    readonly height: {
+                        readonly type: "number";
+                        readonly exclusiveMinimum: 0;
+                    };
+                    readonly parentId: {
+                        readonly type: "string";
+                        readonly description: "Parent (group/frame) node id.";
+                    };
+                };
+            };
+            readonly nearNodeId: {
+                readonly type: "string";
+                readonly description: "Existing node to place the new node beside and connect from.";
+            };
+            readonly side: {
+                readonly type: "string";
+                readonly enum: readonly ["top", "right", "bottom", "left"];
+                readonly description: "Side of `nearNodeId` to place the node on (default right).";
+            };
+        };
+        readonly required: readonly ["node"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "canvas_remove_nodes";
+    readonly title: "Remove canvas nodes";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+        readonly title: "Remove canvas nodes";
+    };
+    readonly description: "Removes nodes (and their edges) from the canvas. Every id must exist.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly nodeIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly minItems: 1;
+                readonly uniqueItems: true;
+                readonly description: "Node ids (from get_editor_state).";
+            };
+        };
+        readonly required: readonly ["nodeIds"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "canvas_connect";
+    readonly title: "Connect canvas nodes";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+        readonly title: "Connect canvas nodes";
+    };
+    readonly description: "Adds an edge from one existing node to another. Returns the new edge id.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly source: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "Source node id.";
+            };
+            readonly target: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "Target node id.";
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly description: "Edge label.";
+            };
+        };
+        readonly required: readonly ["source", "target"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "canvas_update_node";
+    readonly title: "Update a canvas node";
+    readonly annotations: {
+        readonly idempotentHint: true;
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly openWorldHint: false;
+        readonly title: "Update a canvas node";
+    };
+    readonly description: "Merges fields into an existing node's data.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "Node id.";
+            };
+            readonly data: {
+                readonly type: "object";
+                readonly description: "Data fields to merge (e.g. { \"label\": \"New\" }).";
+            };
+        };
+        readonly required: readonly ["id", "data"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "canvas_layout";
+    readonly title: "Lay out the canvas";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+        readonly title: "Lay out the canvas";
+    };
+    readonly description: "Arranges the canvas graph automatically.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly direction: {
+                readonly type: "string";
+                readonly enum: readonly ["LR", "TB", "RL", "BT"];
+                readonly description: "Layout direction (default LR).";
+            };
+            readonly incremental: {
+                readonly type: "boolean";
+                readonly description: "Keep nodes that already have a position where they are (default true).";
+            };
+        };
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "canvas_select";
+    readonly title: "Select canvas nodes";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+        readonly title: "Select canvas nodes";
+    };
+    readonly description: "Replaces the canvas selection with these nodes (an empty list clears it).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly nodeIds: {
+                readonly minItems: 0;
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly uniqueItems: true;
+                readonly description: "Node ids (from get_editor_state).";
+            };
+        };
+        readonly required: readonly ["nodeIds"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "canvas_highlight";
+    readonly title: "Highlight canvas nodes";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+        readonly title: "Highlight canvas nodes";
+    };
+    readonly description: "Briefly highlights nodes to draw the user's attention to them.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly nodeIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly minItems: 1;
+                readonly uniqueItems: true;
+                readonly description: "Node ids (from get_editor_state).";
+            };
+            readonly color: {
+                readonly type: "string";
+                readonly description: "CSS color (default #3b82f6).";
+            };
+            readonly durationMs: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly maximum: 60000;
+                readonly description: "Duration in ms (default 2000).";
+            };
+        };
+        readonly required: readonly ["nodeIds"];
+        readonly additionalProperties: false;
+    };
+}];
+/** Per-operation prompt tools, the strict alternative to `edit_prompt`. */
+declare const EDITOR_PROMPT_TOOLS: readonly [{
+    readonly name: "prompt_insert_text";
+    readonly title: "Insert prompt text";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+        readonly title: "Insert prompt text";
+    };
+    readonly description: "Inserts text into the prompt at a position, or at the cursor when `at` is omitted.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly text: {
+                readonly type: "string";
+                readonly description: "Text to insert.";
+            };
+            readonly at: {
+                readonly description: "Position (as in get_editor_state `document.selection`).";
+                readonly type: "integer";
+                readonly minimum: 0;
+            };
+        };
+        readonly required: readonly ["text"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "prompt_replace_range";
+    readonly title: "Replace prompt text";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+        readonly title: "Replace prompt text";
+    };
+    readonly description: "Replaces the prompt text between two positions (an empty text deletes it).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly from: {
+                readonly description: "Start position.";
+                readonly type: "integer";
+                readonly minimum: 0;
+            };
+            readonly to: {
+                readonly description: "End position (>= from).";
+                readonly type: "integer";
+                readonly minimum: 0;
+            };
+            readonly text: {
+                readonly type: "string";
+                readonly description: "Replacement text.";
+            };
+        };
+        readonly required: readonly ["from", "to", "text"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "prompt_set_variable";
+    readonly title: "Set a prompt variable";
+    readonly annotations: {
+        readonly idempotentHint: true;
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly openWorldHint: false;
+        readonly title: "Set a prompt variable";
+    };
+    readonly description: "Sets the value of a template variable used by the prompt.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "Variable name.";
+            };
+            readonly value: {
+                readonly description: "Variable value (any JSON value).";
+            };
+        };
+        readonly required: readonly ["name", "value"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "prompt_select";
+    readonly title: "Select prompt text";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+        readonly title: "Select prompt text";
+    };
+    readonly description: "Selects the prompt text between two positions (from === to places the cursor).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly from: {
+                readonly description: "Start position.";
+                readonly type: "integer";
+                readonly minimum: 0;
+            };
+            readonly to: {
+                readonly description: "End position (>= from).";
+                readonly type: "integer";
+                readonly minimum: 0;
+            };
+        };
+        readonly required: readonly ["from", "to"];
+        readonly additionalProperties: false;
+    };
+}];
+/**
+ * Arguments each `edit_canvas` / `edit_prompt` operation needs, used to tell
+ * an agent exactly what is missing (the combined schemas cannot express it).
+ */
+declare const EDIT_OPERATION_REQUIRED_ARGUMENTS: Readonly<Record<'edit_canvas' | 'edit_prompt', Readonly<Record<string, readonly string[]>>>>;
 /**
  * CSS selectors for ephemeral UI overlays (such as agent cursors, presence tags, and transient bubbles)
  * that should be excluded during canvas image export and visual snapshot generation.
@@ -210,7 +979,7 @@ declare const EDITOR_MCP_TOOLS: readonly [{
         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 description: string;
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -239,6 +1008,23 @@ declare const EDITOR_MCP_TOOLS: readonly [{
                 };
                 readonly description: "Array of node IDs for remove_nodes, select, or highlight.";
             };
+            readonly id: {
+                readonly type: "string";
+                readonly description: "Node ID for update_node (or pass `node: { id, data }`).";
+            };
+            readonly data: {
+                readonly type: "object";
+                readonly description: "Data fields to merge into the node for update_node.";
+            };
+            readonly color: {
+                readonly type: "string";
+                readonly description: "CSS color for highlight (default #3b82f6).";
+            };
+            readonly durationMs: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly description: "How long the highlight lasts in ms (default 2000).";
+            };
             readonly source: {
                 readonly type: "string";
                 readonly description: "Source node ID for connect operation.";
@@ -287,15 +1073,18 @@ declare const EDITOR_MCP_TOOLS: readonly [{
                 readonly description: "Text to insert or replace.";
             };
             readonly at: {
-                readonly type: "number";
+                readonly type: "integer";
+                readonly minimum: 0;
                 readonly description: "Position to insert text at.";
             };
             readonly from: {
-                readonly type: "number";
+                readonly type: "integer";
+                readonly minimum: 0;
                 readonly description: "Start offset for replace_range or select.";
             };
             readonly to: {
-                readonly type: "number";
+                readonly type: "integer";
+                readonly minimum: 0;
                 readonly description: "End offset for replace_range or select.";
             };
             readonly name: {
@@ -340,4 +1129,75 @@ declare const EDITOR_MCP_TOOLS: readonly [{
     };
 }];
 
-export { EDITOR_MCP_TOOLS, EXPORT_EXCLUDED_SELECTORS, MCP_TOOL_EDIT_CANVAS, MCP_TOOL_EDIT_PROMPT, MCP_TOOL_GET_EDITOR_STATE, MCP_TOOL_VIEW_EDITOR };
+/** MCP protocol revisions this server speaks, newest first. */
+declare const MCP_PROTOCOL_VERSIONS: readonly ["2025-06-18", "2025-03-26", "2024-11-05"];
+type JsonRpcId = string | number;
+interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id?: JsonRpcId | null;
+    method: string;
+    params?: Record<string, any>;
+}
+interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: JsonRpcId | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+interface JsonRpcNotification {
+    jsonrpc: '2.0';
+    method: string;
+    params?: Record<string, unknown>;
+}
+/** Standard JSON-RPC error codes used by the server. */
+declare const JSON_RPC_ERRORS: {
+    readonly parseError: -32700;
+    readonly invalidRequest: -32600;
+    readonly methodNotFound: -32601;
+    readonly invalidParams: -32602;
+    readonly internalError: -32603;
+};
+interface McpServerOptions {
+    /** `serverInfo` sent in the `initialize` result. */
+    name: string;
+    version: string;
+    title?: string;
+    /** Usage hints for the client's model, sent in the `initialize` result. */
+    instructions?: string;
+    /**
+     * Sends server → client messages (`notifications/tools/list_changed`).
+     * Without it the server still answers requests but announces nothing.
+     */
+    send?: (message: JsonRpcNotification) => void;
+}
+interface McpServer {
+    /**
+     * Handles one client message (a JSON string or a parsed object) and
+     * resolves to the response to send back, or `null` for notifications.
+     * Never rejects.
+     */
+    handle(message: string | JsonRpcRequest): Promise<JsonRpcResponse | null>;
+    /** Whether the client has completed the `initialize` handshake. */
+    readonly initialized: boolean;
+    /** Stops list-changed notifications and aborts running tool calls. */
+    close(): void;
+}
+/**
+ * A transport-agnostic MCP server for a {@link ToolRegistry}: 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
+ * 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.
+ */
+declare function createMcpServer(registry: ToolRegistry, options: McpServerOptions): McpServer;
+
+export { EDITOR_CANVAS_TOOLS, EDITOR_MCP_TOOLS, EDITOR_PROMPT_TOOLS, EDIT_OPERATION_REQUIRED_ARGUMENTS, EXPORT_EXCLUDED_SELECTORS, JSON_RPC_ERRORS, type JsonRpcId, type JsonRpcNotification, type JsonRpcRequest, type JsonRpcResponse, MCP_PROTOCOL_VERSIONS, MCP_TOOL_CANVAS_ADD_NODE, MCP_TOOL_CANVAS_CONNECT, MCP_TOOL_CANVAS_HIGHLIGHT, MCP_TOOL_CANVAS_LAYOUT, MCP_TOOL_CANVAS_REMOVE_NODES, MCP_TOOL_CANVAS_SELECT, MCP_TOOL_CANVAS_UPDATE_NODE, MCP_TOOL_EDIT_CANVAS, MCP_TOOL_EDIT_PROMPT, MCP_TOOL_GET_EDITOR_STATE, MCP_TOOL_PROMPT_INSERT_TEXT, MCP_TOOL_PROMPT_REPLACE_RANGE, MCP_TOOL_PROMPT_SELECT, MCP_TOOL_PROMPT_SET_VARIABLE, MCP_TOOL_VIEW_EDITOR, type McpServer, type McpServerOptions, ToolRegistry, createMcpServer };