@sudocode-ai/local-server 0.1.10 → 0.1.12

package/dist/workflow/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/workflow/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EACV,kBAAkB,EAYnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAyBpD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAiSD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAqC;gBAE1C,OAAO,EAAE,wBAAwB;IAqC7C;;OAEG;IACH,OAAO,CAAC,aAAa;IAiDrB;;OAEG;YACW,cAAc;YAiDd,oBAAoB;YAIpB,sBAAsB;YAUtB,kBAAkB;YAiBlB,qBAAqB;YASrB,qBAAqB;YAUrB,yBAAyB;YAUzB,sBAAsB;YAUtB,oBAAoB;YAWpB,gBAAgB;YAUhB,iBAAiB;YAYjB,iBAAiB;IAoB/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;OAEG;IACH,UAAU,IAAI,kBAAkB;CAGjC"}

package/dist/workflow/mcp/server.js

@@ -0,0 +1,520 @@
+/**
+ * Workflow MCP Server
+ *
+ * MCP server that provides workflow control tools to the orchestrator agent.
+ * Spawned as a subprocess with workflow-id, server-url, project-id, and repo-path arguments.
+ * All communication with the main server goes through the HTTP API client.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { WorkflowAPIClient } from "./api-client.js";
+// Tool implementations
+import { handleWorkflowStatus, handleWorkflowComplete, } from "./tools/workflow.js";
+import { handleExecuteIssue, handleExecutionStatus, handleExecutionCancel, } from "./tools/execution.js";
+import { handleExecutionTrajectory, handleExecutionChanges, } from "./tools/inspection.js";
+import { handleEscalateToUser, handleNotifyUser, } from "./tools/escalation.js";
+// =============================================================================
+// Tool Definitions
+// =============================================================================
+/**
+ * All available workflow MCP tools.
+ * Tool handlers are implemented in ./tools/*.ts
+ */
+const TOOL_DEFINITIONS = [
+    // Workflow control tools
+    {
+        name: "workflow_status",
+        description: "Get current workflow state including steps, active executions, and ready issues. " +
+            "Use this to understand what work is pending, in progress, or completed.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "workflow_complete",
+        description: "Mark workflow as complete or failed with a summary. " +
+            "Call this when all work is done or if the workflow cannot continue.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                summary: {
+                    type: "string",
+                    description: "Summary of work completed or reason for failure",
+                },
+                status: {
+                    type: "string",
+                    enum: ["completed", "failed"],
+                    description: "Final status (default: completed)",
+                },
+            },
+            required: ["summary"],
+        },
+    },
+    // Execution tools
+    {
+        name: "execute_issue",
+        description: "Start an execution for an issue. Returns immediately with execution ID. " +
+            "Use execution_status to check progress.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                issue_id: {
+                    type: "string",
+                    description: "Issue ID to execute (e.g., i-abc123)",
+                },
+                agent_type: {
+                    type: "string",
+                    enum: ["claude-code", "codex", "copilot", "cursor"],
+                    description: "Agent type to use (default: from workflow config)",
+                },
+                model: {
+                    type: "string",
+                    description: "Model override for the agent",
+                },
+                worktree_mode: {
+                    type: "string",
+                    enum: ["create_root", "use_root", "create_branch", "use_branch"],
+                    description: "Worktree strategy: create_root (new workflow worktree), " +
+                        "use_root (reuse workflow worktree), create_branch (parallel branch), " +
+                        "use_branch (continue on existing branch)",
+                },
+                worktree_id: {
+                    type: "string",
+                    description: "Execution ID to reuse worktree from (required for use_root/use_branch)",
+                },
+            },
+            required: ["issue_id", "worktree_mode"],
+        },
+    },
+    {
+        name: "execution_status",
+        description: "Get status of an execution including exit code, summary, and files changed.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                execution_id: {
+                    type: "string",
+                    description: "Execution ID to check",
+                },
+            },
+            required: ["execution_id"],
+        },
+    },
+    {
+        name: "execution_cancel",
+        description: "Cancel a running execution.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                execution_id: {
+                    type: "string",
+                    description: "Execution ID to cancel",
+                },
+                reason: {
+                    type: "string",
+                    description: "Reason for cancellation",
+                },
+            },
+            required: ["execution_id"],
+        },
+    },
+    // Inspection tools
+    {
+        name: "execution_trajectory",
+        description: "Get agent actions and tool calls from an execution. " +
+            "Useful for understanding what the agent did and debugging issues.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                execution_id: {
+                    type: "string",
+                    description: "Execution ID to inspect",
+                },
+                max_entries: {
+                    type: "number",
+                    description: "Maximum entries to return (default: 50)",
+                },
+            },
+            required: ["execution_id"],
+        },
+    },
+    {
+        name: "execution_changes",
+        description: "Get code changes made by an execution including files modified and commits.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                execution_id: {
+                    type: "string",
+                    description: "Execution ID to get changes for",
+                },
+                include_diff: {
+                    type: "boolean",
+                    description: "Include full diff content (default: false)",
+                },
+            },
+            required: ["execution_id"],
+        },
+    },
+    // Escalation tools (Human-in-the-Loop)
+    {
+        name: "escalate_to_user",
+        description: "Request user input for a decision. Returns immediately with 'pending' status. " +
+            "Your session ends here - when the user responds, you'll receive a follow-up message. " +
+            "In full_auto mode, returns 'auto_approved' immediately without user interaction.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                message: {
+                    type: "string",
+                    description: "Message explaining what input is needed from the user",
+                },
+                options: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional predefined options for user to choose from",
+                },
+                context: {
+                    type: "object",
+                    description: "Additional context to include in the escalation (passed back in response)",
+                },
+            },
+            required: ["message"],
+        },
+    },
+    {
+        name: "notify_user",
+        description: "Send a non-blocking notification to the user. Does not wait for response. " +
+            "Use for progress updates and informational messages.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                message: {
+                    type: "string",
+                    description: "Notification message",
+                },
+                level: {
+                    type: "string",
+                    enum: ["info", "warning", "error"],
+                    description: "Notification level (default: info)",
+                },
+            },
+            required: ["message"],
+        },
+    },
+    // Git operations
+    {
+        name: "merge_branch",
+        description: "Merge a branch into the workflow's worktree. Use this to merge parallel execution branches " +
+            "back into the main workflow branch. Returns merge result with commit SHA or conflict info.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                source_branch: {
+                    type: "string",
+                    description: "Branch name to merge from",
+                },
+                target_branch: {
+                    type: "string",
+                    description: "Branch to merge into (default: current workflow branch)",
+                },
+                strategy: {
+                    type: "string",
+                    enum: ["auto", "squash"],
+                    description: "Merge strategy: auto (fast-forward if possible, else merge) or squash",
+                },
+                message: {
+                    type: "string",
+                    description: "Custom commit message for the merge",
+                },
+            },
+            required: ["source_branch"],
+        },
+    },
+    // Pause and await tools
+    {
+        name: "await_events",
+        description: "Pause execution and wait for specific events. Your session will end here. " +
+            "When any of the specified events occur, you'll receive a follow-up with the event data. " +
+            "Use this instead of polling execution_status in a loop.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                event_types: {
+                    type: "array",
+                    items: {
+                        type: "string",
+                        enum: [
+                            "step_completed",
+                            "step_failed",
+                            "user_response",
+                            "escalation_resolved",
+                            "timeout",
+                        ],
+                    },
+                    description: "Event types to wait for. Wakeup triggers when ANY event occurs.",
+                },
+                execution_ids: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional: Only wake for events from these execution IDs",
+                },
+                timeout_seconds: {
+                    type: "number",
+                    description: "Optional: Maximum seconds to wait before auto-wakeup with timeout event",
+                },
+                message: {
+                    type: "string",
+                    description: "Optional: Message to show in UI while waiting",
+                },
+            },
+            required: ["event_types"],
+        },
+    },
+];
+// =============================================================================
+// WorkflowMCPServer
+// =============================================================================
+/**
+ * MCP server for workflow orchestration.
+ *
+ * Provides tools for the orchestrator agent to:
+ * - Check workflow status
+ * - Execute issues
+ * - Monitor execution progress
+ * - Inspect execution results
+ * - Complete the workflow
+ *
+ * All communication with the main server goes through the HTTP API client.
+ *
+ * @example
+ * ```typescript
+ * const server = new WorkflowMCPServer({
+ *   workflowId: "wf-abc123",
+ *   serverUrl: "http://localhost:3000",
+ *   projectId: "proj-123",
+ *   repoPath: "/path/to/repo",
+ * });
+ * await server.start();
+ * ```
+ */
+export class WorkflowMCPServer {
+    server;
+    context;
+    transport = null;
+    constructor(options) {
+        // Create API client (use provided one for testing, otherwise create new)
+        const apiClient = options.apiClient ||
+            new WorkflowAPIClient({
+                serverUrl: options.serverUrl,
+                projectId: options.projectId,
+                workflowId: options.workflowId,
+            });
+        console.error(`[WorkflowMCPServer] Using API client: ${options.serverUrl}`);
+        // Build context for tool handlers
+        this.context = {
+            workflowId: options.workflowId,
+            apiClient,
+            repoPath: options.repoPath,
+        };
+        // Create MCP server
+        this.server = new Server({
+            name: "sudocode-workflow",
+            version: "0.1.0",
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.setupHandlers();
+    }
+    /**
+     * Set up MCP request handlers.
+     */
+    setupHandlers() {
+        // List available tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return {
+                tools: TOOL_DEFINITIONS,
+            };
+        });
+        // Handle tool calls
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                const result = await this.handleToolCall(name, args || {});
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: message,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    /**
+     * Handle a tool call by dispatching to the appropriate handler.
+     */
+    async handleToolCall(name, args) {
+        // Tool handlers will be implemented in subsequent issues
+        // For now, return a placeholder response
+        switch (name) {
+            case "workflow_status":
+                return this.handleWorkflowStatus();
+            case "workflow_complete":
+                return this.handleWorkflowComplete(args);
+            case "execute_issue":
+                return this.handleExecuteIssue(args);
+            case "execution_status":
+                return this.handleExecutionStatus(args);
+            case "execution_cancel":
+                return this.handleExecutionCancel(args);
+            case "execution_trajectory":
+                return this.handleExecutionTrajectory(args);
+            case "execution_changes":
+                return this.handleExecutionChanges(args);
+            case "escalate_to_user":
+                return this.handleEscalateToUser(args);
+            case "notify_user":
+                return this.handleNotifyUser(args);
+            case "merge_branch":
+                return this.handleMergeBranch(args);
+            case "await_events":
+                return this.handleAwaitEvents(args);
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    // ===========================================================================
+    // Tool Handler Stubs (to be implemented in tools/*.ts)
+    // ===========================================================================
+    async handleWorkflowStatus() {
+        return handleWorkflowStatus(this.context);
+    }
+    async handleWorkflowComplete(args) {
+        const params = {
+            summary: args.summary,
+            status: args.status,
+        };
+        return handleWorkflowComplete(this.context, params);
+    }
+    async handleExecuteIssue(args) {
+        const params = {
+            issue_id: args.issue_id,
+            agent_type: args.agent_type,
+            model: args.model,
+            worktree_mode: args.worktree_mode,
+            worktree_id: args.worktree_id,
+        };
+        return handleExecuteIssue(this.context, params);
+    }
+    async handleExecutionStatus(args) {
+        const params = {
+            execution_id: args.execution_id,
+        };
+        return handleExecutionStatus(this.context, params);
+    }
+    async handleExecutionCancel(args) {
+        const params = {
+            execution_id: args.execution_id,
+            reason: args.reason,
+        };
+        return handleExecutionCancel(this.context, params);
+    }
+    async handleExecutionTrajectory(args) {
+        const params = {
+            execution_id: args.execution_id,
+            max_entries: args.max_entries,
+        };
+        return handleExecutionTrajectory(this.context, params);
+    }
+    async handleExecutionChanges(args) {
+        const params = {
+            execution_id: args.execution_id,
+            include_diff: args.include_diff,
+        };
+        return handleExecutionChanges(this.context, params);
+    }
+    async handleEscalateToUser(args) {
+        const params = {
+            message: args.message,
+            options: args.options,
+            context: args.context,
+        };
+        return handleEscalateToUser(this.context, params);
+    }
+    async handleNotifyUser(args) {
+        const params = {
+            message: args.message,
+            level: args.level,
+        };
+        return handleNotifyUser(this.context, params);
+    }
+    async handleMergeBranch(args) {
+        const params = {
+            source_branch: args.source_branch,
+            target_branch: args.target_branch,
+            strategy: args.strategy,
+            message: args.message,
+        };
+        return this.context.apiClient.mergeBranch(params);
+    }
+    async handleAwaitEvents(args) {
+        const params = {
+            event_types: args.event_types,
+            execution_ids: args.execution_ids,
+            timeout_seconds: args.timeout_seconds,
+            message: args.message,
+        };
+        console.error(`[await_events] Orchestrator pausing for workflow ${this.context.workflowId}`, { eventTypes: params.event_types, timeout: params.timeout_seconds });
+        return this.context.apiClient.awaitEvents(params);
+    }
+    // ===========================================================================
+    // Lifecycle
+    // ===========================================================================
+    /**
+     * Start the MCP server with stdio transport.
+     */
+    async start() {
+        this.transport = new StdioServerTransport();
+        await this.server.connect(this.transport);
+        // Log startup (to stderr so it doesn't interfere with MCP protocol)
+        console.error(`[WorkflowMCPServer] Started for workflow ${this.context.workflowId}`);
+    }
+    /**
+     * Stop the MCP server and clean up resources.
+     */
+    async stop() {
+        if (this.transport) {
+            await this.server.close();
+            this.transport = null;
+        }
+        console.error(`[WorkflowMCPServer] Stopped`);
+    }
+    /**
+     * Get the context (for testing).
+     */
+    getContext() {
+        return this.context;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/workflow/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/workflow/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAgB5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,uBAAuB;AACvB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAsB/B,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,gBAAgB,GAAqB;IACzC,yBAAyB;IACzB;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,mFAAmF;YACnF,yEAAyE;QAC3E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,sDAAsD;YACtD,qEAAqE;QACvE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iDAAiD;iBAC/D;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;oBAC7B,WAAW,EAAE,mCAAmC;iBACjD;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IAED,kBAAkB;IAClB;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,0EAA0E;YAC1E,yCAAyC;QAC3C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;iBACpD;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC;oBACnD,WAAW,EAAE,mDAAmD;iBACjE;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8BAA8B;iBAC5C;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,CAAC;oBAChE,WAAW,EACT,0DAA0D;wBAC1D,uEAAuE;wBACvE,0CAA0C;iBAC7C;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,wEAAwE;iBAC3E;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,eAAe,CAAC;SACxC;KACF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,6EAA6E;QAC/E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uBAAuB;iBACrC;aACF;YACD,QAAQ,EAAE,CAAC,cAAc,CAAC;SAC3B;KACF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,6BAA6B;QAC1C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wBAAwB;iBACtC;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yBAAyB;iBACvC;aACF;YACD,QAAQ,EAAE,CAAC,cAAc,CAAC;SAC3B;KACF;IAED,mBAAmB;IACnB;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,sDAAsD;YACtD,mEAAmE;QACrE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yBAAyB;iBACvC;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yCAAyC;iBACvD;aACF;YACD,QAAQ,EAAE,CAAC,cAAc,CAAC;SAC3B;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,6EAA6E;QAC/E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iCAAiC;iBAC/C;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,4CAA4C;iBAC1D;aACF;YACD,QAAQ,EAAE,CAAC,cAAc,CAAC;SAC3B;KACF;IAED,uCAAuC;IACvC;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,gFAAgF;YAChF,uFAAuF;YACvF,kFAAkF;QACpF,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uDAAuD;iBACrE;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,qDAAqD;iBACnE;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2EAA2E;iBACzF;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,4EAA4E;YAC5E,sDAAsD;QACxD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sBAAsB;iBACpC;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;oBAClC,WAAW,EAAE,oCAAoC;iBAClD;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IAED,iBAAiB;IACjB;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,6FAA6F;YAC7F,4FAA4F;QAC9F,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,aAAa,EAAE;oBACb,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2BAA2B;iBACzC;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,yDAAyD;iBAC5D;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;oBACxB,WAAW,EACT,uEAAuE;iBAC1E;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qCAAqC;iBACnD;aACF;YACD,QAAQ,EAAE,CAAC,eAAe,CAAC;SAC5B;KACF;IAED,wBAAwB;IACxB;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,4EAA4E;YAC5E,0FAA0F;YAC1F,yDAAyD;QAC3D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE;4BACJ,gBAAgB;4BAChB,aAAa;4BACb,eAAe;4BACf,qBAAqB;4BACrB,SAAS;yBACV;qBACF;oBACD,WAAW,EACT,iEAAiE;iBACpE;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,yDAAyD;iBACvE;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,yEAAyE;iBAC5E;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+CAA+C;iBAC7D;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,CAAC;SAC1B;KACF;CACF,CAAC;AAEF,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAS;IACf,OAAO,CAAqB;IAC5B,SAAS,GAAgC,IAAI,CAAC;IAEtD,YAAY,OAAiC;QAC3C,yEAAyE;QACzE,MAAM,SAAS,GACb,OAAO,CAAC,SAAS;YACjB,IAAI,iBAAiB,CAAC;gBACpB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B,CAAC,CAAC;QAEL,OAAO,CAAC,KAAK,CACX,yCAAyC,OAAO,CAAC,SAAS,EAAE,CAC7D,CAAC;QAEF,kCAAkC;QAClC,IAAI,CAAC,OAAO,GAAG;YACb,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,SAAS;YACT,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC;QAEF,oBAAoB;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CACtB;YACE,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,OAAO;SACjB,EACD;YACE,YAAY,EAAE;gBACZ,KAAK,EAAE,EAAE;aACV;SACF,CACF,CAAC;QAEF,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,aAAa;QACnB,uBAAuB;QACvB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;YAC/D,OAAO;gBACL,KAAK,EAAE,gBAAgB;aACxB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,oBAAoB;QACpB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACrE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YAEjD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CACtC,IAAI,EACH,IAAgC,IAAI,EAAE,CACxC,CAAC;gBAEF,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACzD,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;gCACE,OAAO,EAAE,KAAK;gCACd,KAAK,EAAE,OAAO;6BACf,EACD,IAAI,EACJ,CAAC,CACF;yBACF;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAC1B,IAAY,EACZ,IAA6B;QAE7B,yDAAyD;QACzD,yCAAyC;QACzC,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,iBAAiB;gBACpB,OAAO,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAErC,KAAK,mBAAmB;gBACtB,OAAO,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;YAE3C,KAAK,eAAe;gBAClB,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAEvC,KAAK,kBAAkB;gBACrB,OAAO,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;YAE1C,KAAK,kBAAkB;gBACrB,OAAO,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;YAE1C,KAAK,sBAAsB;gBACzB,OAAO,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;YAE9C,KAAK,mBAAmB;gBACtB,OAAO,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;YAE3C,KAAK,kBAAkB;gBACrB,OAAO,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;YAEzC,KAAK,aAAa;gBAChB,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;YAErC,KAAK,cAAc;gBACjB,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAEtC,KAAK,cAAc;gBACjB,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAEtC;gBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,uDAAuD;IACvD,8EAA8E;IAEtE,KAAK,CAAC,oBAAoB;QAChC,OAAO,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAClC,IAA6B;QAE7B,MAAM,MAAM,GAA2B;YACrC,OAAO,EAAE,IAAI,CAAC,OAAiB;YAC/B,MAAM,EAAE,IAAI,CAAC,MAA4C;SAC1D,CAAC;QACF,OAAO,sBAAsB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAC9B,IAA6B;QAE7B,MAAM,MAAM,GAAuB;YACjC,QAAQ,EAAE,IAAI,CAAC,QAAkB;YACjC,UAAU,EAAE,IAAI,CAAC,UAA8C;YAC/D,KAAK,EAAE,IAAI,CAAC,KAA2B;YACvC,aAAa,EAAE,IAAI,CAAC,aAIJ;YAChB,WAAW,EAAE,IAAI,CAAC,WAAiC;SACpD,CAAC;QACF,OAAO,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAEO,KAAK,CAAC,qBAAqB,CACjC,IAA6B;QAE7B,MAAM,MAAM,GAA0B;YACpC,YAAY,EAAE,IAAI,CAAC,YAAsB;SAC1C,CAAC;QACF,OAAO,qBAAqB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IAEO,KAAK,CAAC,qBAAqB,CACjC,IAA6B;QAE7B,MAAM,MAAM,GAA0B;YACpC,YAAY,EAAE,IAAI,CAAC,YAAsB;YACzC,MAAM,EAAE,IAAI,CAAC,MAA4B;SAC1C,CAAC;QACF,OAAO,qBAAqB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IAEO,KAAK,CAAC,yBAAyB,CACrC,IAA6B;QAE7B,MAAM,MAAM,GAA8B;YACxC,YAAY,EAAE,IAAI,CAAC,YAAsB;YACzC,WAAW,EAAE,IAAI,CAAC,WAAiC;SACpD,CAAC;QACF,OAAO,yBAAyB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAClC,IAA6B;QAE7B,MAAM,MAAM,GAA2B;YACrC,YAAY,EAAE,IAAI,CAAC,YAAsB;YACzC,YAAY,EAAE,IAAI,CAAC,YAAmC;SACvD,CAAC;QACF,OAAO,sBAAsB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAChC,IAA6B;QAE7B,MAAM,MAAM,GAAyB;YACnC,OAAO,EAAE,IAAI,CAAC,OAAiB;YAC/B,OAAO,EAAE,IAAI,CAAC,OAA+B;YAC7C,OAAO,EAAE,IAAI,CAAC,OAA8C;SAC7D,CAAC;QACF,OAAO,oBAAoB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,IAA6B;QAE7B,MAAM,MAAM,GAAqB;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAiB;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAiD;SAC9D,CAAC;QACF,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,IAA6B;QAE7B,MAAM,MAAM,GAAsB;YAChC,aAAa,EAAE,IAAI,CAAC,aAAuB;YAC3C,aAAa,EAAE,IAAI,CAAC,aAAmC;YACvD,QAAQ,EAAE,IAAI,CAAC,QAAyC;YACxD,OAAO,EAAE,IAAI,CAAC,OAA6B;SAC5C,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,IAA6B;QAE7B,MAAM,MAAM,GAAsB;YAChC,WAAW,EAAE,IAAI,CAAC,WAA+C;YACjE,aAAa,EAAE,IAAI,CAAC,aAAqC;YACzD,eAAe,EAAE,IAAI,CAAC,eAAqC;YAC3D,OAAO,EAAE,IAAI,CAAC,OAA6B;SAC5C,CAAC;QACF,OAAO,CAAC,KAAK,CACX,oDAAoD,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAC7E,EAAE,UAAU,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,eAAe,EAAE,CACpE,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,8EAA8E;IAC9E,YAAY;IACZ,8EAA8E;IAE9E;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC5C,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE1C,oEAAoE;QACpE,OAAO,CAAC,KAAK,CACX,4CAA4C,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CACtE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/workflow/mcp/tools/escalation.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Escalation MCP Tools
+ *
+ * Implements escalate_to_user and notify_user tools for
+ * human-in-the-loop workflow orchestration.
+ *
+ * All operations go through the HTTP API client.
+ */
+import type { WorkflowMCPContext, EscalateToUserParams, EscalateToUserResult, NotifyUserParams, NotifyUserResult } from "../types.js";
+/**
+ * Handle escalate_to_user tool call.
+ *
+ * Creates an escalation request for user input. The orchestrator's session
+ * ends naturally after this call - no blocking wait.
+ *
+ * If autonomyLevel is "full_auto", immediately returns auto_approved
+ * without creating an actual escalation.
+ *
+ * @param context - Workflow MCP context
+ * @param params - Escalation parameters (message, options, context)
+ * @returns Escalation result with status and optional escalation_id
+ */
+export declare function handleEscalateToUser(context: WorkflowMCPContext, params: EscalateToUserParams): Promise<EscalateToUserResult>;
+/**
+ * Handle notify_user tool call.
+ *
+ * Sends a non-blocking notification to the user. Does not wait for
+ * acknowledgment or response. Useful for progress updates and informational
+ * messages.
+ *
+ * @param context - Workflow MCP context
+ * @param params - Notification parameters (message, level)
+ * @returns Notification result with success and delivered status
+ */
+export declare function handleNotifyUser(context: WorkflowMCPContext, params: NotifyUserParams): Promise<NotifyUserResult>;
+//# sourceMappingURL=escalation.d.ts.map

package/dist/workflow/mcp/tools/escalation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation.d.ts","sourceRoot":"","sources":["../../../../src/workflow/mcp/tools/escalation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAMrB;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAQ/B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAU3B"}

package/dist/workflow/mcp/tools/escalation.js

@@ -0,0 +1,47 @@
+/**
+ * Escalation MCP Tools
+ *
+ * Implements escalate_to_user and notify_user tools for
+ * human-in-the-loop workflow orchestration.
+ *
+ * All operations go through the HTTP API client.
+ */
+// =============================================================================
+// Tool Handlers
+// =============================================================================
+/**
+ * Handle escalate_to_user tool call.
+ *
+ * Creates an escalation request for user input. The orchestrator's session
+ * ends naturally after this call - no blocking wait.
+ *
+ * If autonomyLevel is "full_auto", immediately returns auto_approved
+ * without creating an actual escalation.
+ *
+ * @param context - Workflow MCP context
+ * @param params - Escalation parameters (message, options, context)
+ * @returns Escalation result with status and optional escalation_id
+ */
+export async function handleEscalateToUser(context, params) {
+    const result = await context.apiClient.escalateToUser(params);
+    console.error(`[escalate_to_user] Escalation result for workflow ${context.workflowId}: ${result.status}`);
+    return result;
+}
+/**
+ * Handle notify_user tool call.
+ *
+ * Sends a non-blocking notification to the user. Does not wait for
+ * acknowledgment or response. Useful for progress updates and informational
+ * messages.
+ *
+ * @param context - Workflow MCP context
+ * @param params - Notification parameters (message, level)
+ * @returns Notification result with success and delivered status
+ */
+export async function handleNotifyUser(context, params) {
+    const { message, level = "info" } = params;
+    const result = await context.apiClient.notifyUser(params);
+    console.error(`[notify_user] [${level.toUpperCase()}] Workflow ${context.workflowId}: ${message}`);
+    return result;
+}
+//# sourceMappingURL=escalation.js.map

package/dist/workflow/mcp/tools/escalation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation.js","sourceRoot":"","sources":["../../../../src/workflow/mcp/tools/escalation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAA2B,EAC3B,MAA4B;IAE5B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAE9D,OAAO,CAAC,KAAK,CACX,qDAAqD,OAAO,CAAC,UAAU,KAAK,MAAM,CAAC,MAAM,EAAE,CAC5F,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAA2B,EAC3B,MAAwB;IAExB,MAAM,EAAE,OAAO,EAAE,KAAK,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;IAE3C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAE1D,OAAO,CAAC,KAAK,CACX,kBAAkB,KAAK,CAAC,WAAW,EAAE,cAAc,OAAO,CAAC,UAAU,KAAK,OAAO,EAAE,CACpF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}