@pixerate/editor 0.8.1 → 0.10.0

package/dist/agent/index.d.ts

@@ -0,0 +1,369 @@
+import { d as CanvasNode, b as CanvasEdge, X as XYPosition, S as Side } from '../types-lGtRobRV.js';
+
+/**
+ * Agent presence state for visual multiplayer/agent choreography.
+ */
+interface AgentPresence {
+    agentId: string;
+    name: string;
+    color: string;
+    cursorPosition?: XYPosition;
+    selectedNodeIds?: string[];
+    activeNodeId?: string;
+    statusMessage?: string;
+    lastActive: number;
+}
+/**
+ * Snapshot of current editor and canvas state provided to agent planners and MCP clients.
+ */
+interface EditorSnapshot<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge> {
+    document?: {
+        text: string;
+        variables?: Record<string, any>;
+        selection?: {
+            from: number;
+            to: number;
+        };
+        isDirty?: boolean;
+    };
+    canvas?: {
+        nodes: TNode[];
+        edges: TEdge[];
+        selectedNodeIds?: string[];
+    };
+}
+/**
+ * High-level intent commands that an AI agent or remote controller can issue.
+ */
+type AgentCommand<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge> = {
+    type: 'canvas:add_node';
+    node: Omit<TNode, 'position'> & {
+        position?: XYPosition;
+    };
+    nearNodeId?: string;
+    side?: Side;
+} | {
+    type: 'canvas:remove_nodes';
+    nodeIds: string[];
+} | {
+    type: 'canvas:connect';
+    source: string;
+    target: string;
+    label?: string;
+} | {
+    type: 'canvas:update_node';
+    id: string;
+    data: Partial<TNode['data']>;
+} | {
+    type: 'canvas:layout';
+    direction?: 'LR' | 'TB' | 'RL' | 'BT';
+    incremental?: boolean;
+} | {
+    type: 'canvas:select';
+    nodeIds: string[];
+} | {
+    type: 'canvas:highlight';
+    nodeIds: string[];
+    color?: string;
+    durationMs?: number;
+} | {
+    type: 'prompt:insert_text';
+    text: string;
+    at?: number;
+} | {
+    type: 'prompt:replace_range';
+    from: number;
+    to: number;
+    text: string;
+} | {
+    type: 'prompt:set_variable';
+    name: string;
+    value: any;
+} | {
+    type: 'prompt:select';
+    from: number;
+    to: number;
+};
+/**
+ * Atomic execution steps returned by the planner.
+ */
+type AgentStep<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge> = {
+    type: 'step:canvas_add_node';
+    node: TNode;
+} | {
+    type: 'step:canvas_remove_nodes';
+    nodeIds: string[];
+} | {
+    type: 'step:canvas_add_edge';
+    edge: TEdge;
+} | {
+    type: 'step:canvas_update_node';
+    id: string;
+    data: Partial<TNode['data']>;
+} | {
+    type: 'step:canvas_move_nodes';
+    positions: Record<string, XYPosition>;
+} | {
+    type: 'step:canvas_select';
+    nodeIds: string[];
+} | {
+    type: 'step:canvas_highlight';
+    nodeIds: string[];
+    color: string;
+    durationMs: number;
+} | {
+    type: 'step:prompt_insert';
+    text: string;
+    at?: number;
+} | {
+    type: 'step:prompt_replace';
+    from: number;
+    to: number;
+    text: string;
+} | {
+    type: 'step:prompt_set_variable';
+    name: string;
+    value: any;
+} | {
+    type: 'step:prompt_select';
+    from: number;
+    to: number;
+};
+
+/**
+ * Plans a sequence of atomic execution steps from a high-level agent command.
+ */
+declare function planAgentCommand<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge>(command: AgentCommand<TNode, TEdge>, snapshot: EditorSnapshot<TNode, TEdge>, options?: {
+    defaultNodeSize?: {
+        width: number;
+        height: number;
+    };
+    idGenerator?: () => string;
+}): AgentStep<TNode, TEdge>[];
+
+/**
+ * Standard MCP Tool Definitions for @pixerate/editor.
+ * Compatible with the Model Context Protocol (MCP) tool specification schema.
+ */
+declare const MCP_TOOL_GET_EDITOR_STATE: {
+    readonly name: "get_editor_state";
+    readonly description: "Retrieves the current state of the document, variables, selection, and canvas graph (nodes and edges).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly includeDocument: {
+                readonly type: "boolean";
+                readonly description: "Whether to include the prompt document text and variables (default: true).";
+            };
+            readonly includeCanvas: {
+                readonly type: "boolean";
+                readonly description: "Whether to include the canvas nodes and edges (default: true).";
+            };
+        };
+    };
+};
+declare const MCP_TOOL_EDIT_CANVAS: {
+    readonly name: "edit_canvas";
+    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";
+        readonly properties: {
+            readonly operation: {
+                readonly type: "string";
+                readonly enum: readonly ["add_node", "remove_nodes", "connect", "update_node", "layout", "select", "highlight"];
+                readonly description: "The canvas operation to execute.";
+            };
+            readonly node: {
+                readonly type: "object";
+                readonly description: "Node definition when operation is add_node. Can omit position to auto-place.";
+            };
+            readonly nearNodeId: {
+                readonly type: "string";
+                readonly description: "Anchor node ID to position beside using collision-aware placement.";
+            };
+            readonly side: {
+                readonly type: "string";
+                readonly enum: readonly ["top", "right", "bottom", "left"];
+                readonly description: "Side of the anchor node to place the new node beside.";
+            };
+            readonly nodeIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Array of node IDs for remove_nodes, select, or highlight.";
+            };
+            readonly source: {
+                readonly type: "string";
+                readonly description: "Source node ID for connect operation.";
+            };
+            readonly target: {
+                readonly type: "string";
+                readonly description: "Target node ID for connect operation.";
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly description: "Optional edge label for connect operation.";
+            };
+            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: "Preserve existing node coordinates and blend layout (default true).";
+            };
+        };
+        readonly required: readonly ["operation"];
+    };
+};
+declare const MCP_TOOL_EDIT_PROMPT: {
+    readonly name: "edit_prompt";
+    readonly description: "Applies edits to the prompt template document, including inserting text, replacing ranges, and setting variables.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly operation: {
+                readonly type: "string";
+                readonly enum: readonly ["insert_text", "replace_range", "set_variable", "select"];
+                readonly description: "The prompt operation to execute.";
+            };
+            readonly text: {
+                readonly type: "string";
+                readonly description: "Text to insert or replace.";
+            };
+            readonly at: {
+                readonly type: "number";
+                readonly description: "Position to insert text at.";
+            };
+            readonly from: {
+                readonly type: "number";
+                readonly description: "Start offset for replace_range or select.";
+            };
+            readonly to: {
+                readonly type: "number";
+                readonly description: "End offset for replace_range or select.";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly description: "Variable name for set_variable.";
+            };
+            readonly value: {
+                readonly description: "Variable value for set_variable.";
+            };
+        };
+        readonly required: readonly ["operation"];
+    };
+};
+declare const EDITOR_MCP_TOOLS: readonly [{
+    readonly name: "get_editor_state";
+    readonly description: "Retrieves the current state of the document, variables, selection, and canvas graph (nodes and edges).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly includeDocument: {
+                readonly type: "boolean";
+                readonly description: "Whether to include the prompt document text and variables (default: true).";
+            };
+            readonly includeCanvas: {
+                readonly type: "boolean";
+                readonly description: "Whether to include the canvas nodes and edges (default: true).";
+            };
+        };
+    };
+}, {
+    readonly name: "edit_canvas";
+    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";
+        readonly properties: {
+            readonly operation: {
+                readonly type: "string";
+                readonly enum: readonly ["add_node", "remove_nodes", "connect", "update_node", "layout", "select", "highlight"];
+                readonly description: "The canvas operation to execute.";
+            };
+            readonly node: {
+                readonly type: "object";
+                readonly description: "Node definition when operation is add_node. Can omit position to auto-place.";
+            };
+            readonly nearNodeId: {
+                readonly type: "string";
+                readonly description: "Anchor node ID to position beside using collision-aware placement.";
+            };
+            readonly side: {
+                readonly type: "string";
+                readonly enum: readonly ["top", "right", "bottom", "left"];
+                readonly description: "Side of the anchor node to place the new node beside.";
+            };
+            readonly nodeIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Array of node IDs for remove_nodes, select, or highlight.";
+            };
+            readonly source: {
+                readonly type: "string";
+                readonly description: "Source node ID for connect operation.";
+            };
+            readonly target: {
+                readonly type: "string";
+                readonly description: "Target node ID for connect operation.";
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly description: "Optional edge label for connect operation.";
+            };
+            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: "Preserve existing node coordinates and blend layout (default true).";
+            };
+        };
+        readonly required: readonly ["operation"];
+    };
+}, {
+    readonly name: "edit_prompt";
+    readonly description: "Applies edits to the prompt template document, including inserting text, replacing ranges, and setting variables.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly operation: {
+                readonly type: "string";
+                readonly enum: readonly ["insert_text", "replace_range", "set_variable", "select"];
+                readonly description: "The prompt operation to execute.";
+            };
+            readonly text: {
+                readonly type: "string";
+                readonly description: "Text to insert or replace.";
+            };
+            readonly at: {
+                readonly type: "number";
+                readonly description: "Position to insert text at.";
+            };
+            readonly from: {
+                readonly type: "number";
+                readonly description: "Start offset for replace_range or select.";
+            };
+            readonly to: {
+                readonly type: "number";
+                readonly description: "End offset for replace_range or select.";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly description: "Variable name for set_variable.";
+            };
+            readonly value: {
+                readonly description: "Variable value for set_variable.";
+            };
+        };
+        readonly required: readonly ["operation"];
+    };
+}];
+
+export { type AgentCommand, type AgentPresence, type AgentStep, EDITOR_MCP_TOOLS, type EditorSnapshot, MCP_TOOL_EDIT_CANVAS, MCP_TOOL_EDIT_PROMPT, MCP_TOOL_GET_EDITOR_STATE, planAgentCommand };