mcp-agent-foundry 1.0.0

package/dist/mcp/tools/tasks/execute-pipeline.d.ts

@@ -0,0 +1,22 @@
+/**
+ * execute_pipeline MCP Tool
+ *
+ * Creates multi-provider task pipelines with dependency resolution.
+ * Validates DAG structure and generates TaskCreate instructions for Claude.
+ * Automatically allocates isolated git worktrees for coding roles and
+ * handles merging in dependency order when the pipeline completes.
+ */
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Logger } from "../../../observability/logger.js";
+import { PipelineManager } from "../../../tasks/pipeline-manager.js";
+import type { WorktreeManager } from "../../../worktrees/manager.js";
+/**
+ * Registers the execute_pipeline tool with the MCP server.
+ *
+ * @param server - MCP server instance
+ * @param pipelineManager - PipelineManager for validation and execution tracking
+ * @param logger - Logger instance for structured logging
+ * @param worktreeManager - Optional WorktreeManager for git worktree allocation
+ */
+export declare function registerExecutePipelineTool(server: McpServer, pipelineManager: PipelineManager, logger: Logger, worktreeManager?: WorktreeManager): void;
+//# sourceMappingURL=execute-pipeline.d.ts.map

package/dist/mcp/tools/tasks/execute-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-pipeline.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/tasks/execute-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAOrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AA+SrE;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,eAAe,GAChC,IAAI,CAmNN"}

package/dist/mcp/tools/tasks/execute-pipeline.js

@@ -0,0 +1,401 @@
+/**
+ * execute_pipeline MCP Tool
+ *
+ * Creates multi-provider task pipelines with dependency resolution.
+ * Validates DAG structure and generates TaskCreate instructions for Claude.
+ * Automatically allocates isolated git worktrees for coding roles and
+ * handles merging in dependency order when the pipeline completes.
+ */
+import { z } from "zod";
+import { roleNeedsWorktree } from "../../../config/worktree-defaults.js";
+import { injectWorktreeContext } from "../../../worktrees/instructions.js";
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Available agent roles for pipeline steps
+ */
+const AGENT_ROLES = ["coder", "critic", "designer", "researcher", "reviewer"];
+/**
+ * Tool description for execute_pipeline
+ */
+const TOOL_DESCRIPTION = "Create a multi-provider task pipeline with dependency resolution. " +
+    "Validates the DAG structure (no cycles, valid dependencies) and generates " +
+    "TaskCreate instructions for Claude to execute. Steps can run in parallel " +
+    "when their dependencies are satisfied. " +
+    "For coder/developer roles, isolated git worktrees are automatically allocated. " +
+    "When all steps complete, worktrees are merged in dependency order.";
+// ============================================================================
+// Input Schema
+// ============================================================================
+/**
+ * Zod schema shape for execute_pipeline input validation.
+ * Uses raw shape format as expected by MCP SDK's registerTool.
+ */
+const executePipelineInputSchemaShape = {
+    name: z.string().min(1).describe("Pipeline name for identification"),
+    steps: z
+        .array(z.object({
+        name: z.string().min(1).describe("Unique step identifier within the pipeline"),
+        subject: z.string().min(1).describe("Task subject line (imperative form)"),
+        description: z.string().optional().describe("Detailed task description"),
+        role: z.enum(AGENT_ROLES).describe("Agent role for this step"),
+        dependsOn: z
+            .array(z.string())
+            .optional()
+            .describe("Names of steps this step depends on"),
+    }))
+        .min(1)
+        .describe("Pipeline steps with dependencies"),
+    context: z
+        .string()
+        .optional()
+        .describe("Global context passed to all steps in the pipeline"),
+    parallel: z
+        .boolean()
+        .default(true)
+        .describe("Execute independent steps in parallel (default: true)"),
+    worktreeOptions: z
+        .object({
+        enabled: z
+            .boolean()
+            .default(true)
+            .describe("Enable worktree allocation for coding roles (default: true)"),
+        autoMerge: z
+            .boolean()
+            .default(true)
+            .describe("Automatically merge worktrees when pipeline completes (default: true)"),
+        targetBranch: z
+            .string()
+            .optional()
+            .describe("Target branch for merging (defaults to main)"),
+    })
+        .optional()
+        .describe("Worktree configuration for the pipeline"),
+};
+// ============================================================================
+// Response Formatter
+// ============================================================================
+/**
+ * Computes execution phases for the pipeline based on dependencies.
+ * Steps in the same phase can run in parallel.
+ *
+ * @param steps - Pipeline steps with dependencies
+ * @returns Array of phases, each containing step names that can run in parallel
+ */
+function computeExecutionPhases(steps) {
+    const phases = [];
+    const completed = new Set();
+    const remaining = new Set(steps.map((s) => s.name));
+    while (remaining.size > 0) {
+        const phase = [];
+        for (const step of steps) {
+            if (!remaining.has(step.name))
+                continue;
+            const depsComplete = step.dependsOn?.every((dep) => completed.has(dep)) ?? true;
+            if (depsComplete) {
+                phase.push(step.name);
+            }
+        }
+        if (phase.length === 0) {
+            // This shouldn't happen if validation passed, but handle gracefully
+            break;
+        }
+        for (const stepName of phase) {
+            remaining.delete(stepName);
+            completed.add(stepName);
+        }
+        phases.push(phase);
+    }
+    return phases;
+}
+/**
+ * Formats the execution plan showing phases and parallelism.
+ *
+ * @param definition - The pipeline definition
+ * @param phases - Computed execution phases
+ * @param parallel - Whether parallel execution is enabled
+ * @returns Formatted execution plan string
+ */
+function formatExecutionPlan(definition, phases, parallel) {
+    const lines = [];
+    lines.push(`## Execution Plan: ${definition.name}`);
+    lines.push("");
+    lines.push(`**Mode**: ${parallel ? "Parallel" : "Sequential"}`);
+    lines.push(`**Total Steps**: ${definition.steps.length}`);
+    lines.push(`**Total Phases**: ${phases.length}`);
+    lines.push("");
+    for (let i = 0; i < phases.length; i++) {
+        const phase = phases[i] ?? [];
+        const parallelNote = parallel && phase.length > 1 ? ` (${phase.length} steps in parallel)` : "";
+        lines.push(`### Phase ${i + 1}${parallelNote}`);
+        for (const stepName of phase) {
+            const step = definition.steps.find((s) => s.name === stepName);
+            if (step) {
+                const deps = step.dependsOn?.length ? ` [depends on: ${step.dependsOn.join(", ")}]` : "";
+                lines.push(`- **${stepName}** (${step.role}): ${step.subject}${deps}`);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Formats the complete pipeline response including plan, instructions, and guidance.
+ *
+ * @param definition - The pipeline definition
+ * @param pipelineId - The pipeline ID
+ * @param taskInstructions - Generated TaskCreate instructions
+ * @param phases - Computed execution phases
+ * @param parallel - Whether parallel execution is enabled
+ * @param worktreeAllocations - Optional worktree allocations for coding steps
+ * @param autoMerge - Whether auto-merge is enabled
+ * @returns Complete formatted response
+ */
+function formatPipelineResponse(definition, pipelineId, taskInstructions, phases, parallel, worktreeAllocations, autoMerge) {
+    const lines = [];
+    // Execution plan
+    lines.push(formatExecutionPlan(definition, phases, parallel));
+    // Worktree allocations if any
+    if (worktreeAllocations && worktreeAllocations.length > 0) {
+        lines.push("---");
+        lines.push("");
+        lines.push("## Worktree Allocations");
+        lines.push("");
+        lines.push("The following coding steps have isolated git worktrees allocated:");
+        lines.push("");
+        for (const alloc of worktreeAllocations) {
+            lines.push(`### ${alloc.stepName}`);
+            lines.push(`- **Worktree ID**: \`${alloc.worktreeId}\``);
+            lines.push(`- **Path**: \`${alloc.path}\``);
+            lines.push(`- **Branch**: \`${alloc.branch}\``);
+            lines.push("");
+        }
+        if (autoMerge) {
+            lines.push("*Worktrees will be automatically merged in dependency order when all steps complete.*");
+        }
+        else {
+            lines.push("*Auto-merge disabled. Use `merge_pipeline_worktrees` to merge manually.*");
+        }
+        lines.push("");
+    }
+    // TaskCreate instructions
+    lines.push("---");
+    lines.push("");
+    lines.push("## TaskCreate Instructions");
+    lines.push("");
+    lines.push("Execute the following to create all pipeline tasks:");
+    lines.push("");
+    lines.push("```");
+    lines.push(taskInstructions);
+    lines.push("```");
+    lines.push("");
+    // Next steps guidance
+    lines.push("---");
+    lines.push("");
+    lines.push("## Next Steps");
+    lines.push("");
+    const readySteps = phases[0] ?? [];
+    if (parallel && readySteps.length > 1) {
+        lines.push(`1. Execute TaskCreate for all steps above to create the task items`);
+        lines.push(`2. Start Phase 1 steps in parallel: ${readySteps.join(", ")}`);
+        lines.push(`3. As each phase completes, its dependent steps become ready`);
+    }
+    else if (readySteps.length > 0) {
+        lines.push(`1. Execute TaskCreate for all steps above to create the task items`);
+        lines.push(`2. Start with the first step: **${readySteps[0]}**`);
+        lines.push(`3. Proceed through steps as dependencies are satisfied`);
+    }
+    else {
+        lines.push(`1. Execute TaskCreate for all steps above to create the task items`);
+        lines.push(`2. Proceed through steps as dependencies are satisfied`);
+    }
+    if (worktreeAllocations && worktreeAllocations.length > 0) {
+        lines.push(`4. When all steps complete, worktrees will be merged in dependency order`);
+    }
+    lines.push("");
+    lines.push(`**Pipeline ID**: \`${pipelineId}\``);
+    lines.push(`*Use this ID to track execution status and complete step results*`);
+    return lines.join("\n");
+}
+// ============================================================================
+// Tool Registration
+// ============================================================================
+/**
+ * Registers the execute_pipeline tool with the MCP server.
+ *
+ * @param server - MCP server instance
+ * @param pipelineManager - PipelineManager for validation and execution tracking
+ * @param logger - Logger instance for structured logging
+ * @param worktreeManager - Optional WorktreeManager for git worktree allocation
+ */
+export function registerExecutePipelineTool(server, pipelineManager, logger, worktreeManager) {
+    // Use type assertion to work around Zod version compatibility issues
+    // between zod 3.25+ and the MCP SDK's ZodRawShapeCompat type
+    /* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment */
+    const inputSchema = executePipelineInputSchemaShape;
+    server.registerTool("execute_pipeline", {
+        title: "Execute Pipeline",
+        description: TOOL_DESCRIPTION,
+        inputSchema,
+    }, 
+    /* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment */
+    async (args) => {
+        // Type-safe access with explicit casting after validation
+        const { name, steps, context, parallel = true, worktreeOptions, } = args;
+        const worktreesEnabled = worktreeOptions?.enabled ?? true;
+        const autoMerge = worktreeOptions?.autoMerge ?? true;
+        // targetBranch will be used by PipelineMergeOrchestrator when triggered
+        const _targetBranch = worktreeOptions?.targetBranch ?? "main";
+        logger.info("execute_pipeline called", {
+            name,
+            stepCount: steps.length,
+            hasContext: context !== undefined,
+            parallel,
+            worktreesEnabled,
+            autoMerge,
+            targetBranch: _targetBranch,
+        });
+        try {
+            // Build the pipeline definition
+            // Use explicit property assignment to handle exactOptionalPropertyTypes
+            const pipelineSteps = steps.map((step) => {
+                const pipelineStep = {
+                    name: step.name,
+                    subject: step.subject,
+                    role: step.role,
+                };
+                if (step.description !== undefined) {
+                    pipelineStep.description = step.description;
+                }
+                if (step.dependsOn !== undefined) {
+                    pipelineStep.dependsOn = step.dependsOn;
+                }
+                return pipelineStep;
+            });
+            const definition = {
+                name,
+                steps: pipelineSteps,
+            };
+            if (context !== undefined) {
+                definition.globalContext = context;
+            }
+            // Validate the definition (throws on error)
+            pipelineManager.validateDefinition(definition);
+            // Create the execution tracker
+            const execution = pipelineManager.createExecution(definition);
+            // Allocate worktrees for coding roles if enabled and manager available
+            const worktreeAllocations = [];
+            if (worktreesEnabled && worktreeManager) {
+                logger.info("Allocating worktrees for coding steps", {
+                    pipelineId: execution.pipelineId,
+                });
+                for (const step of definition.steps) {
+                    if (roleNeedsWorktree(step.role)) {
+                        try {
+                            // Create a unique step ID for the pipeline
+                            const stepId = `${execution.pipelineId}-${step.name}`;
+                            // Allocate worktree for this step
+                            const allocationResult = await worktreeManager.allocate(stepId, `pipeline-${execution.pipelineId}`);
+                            if (allocationResult.success && allocationResult.worktree) {
+                                const worktree = allocationResult.worktree;
+                                // Track allocation in PipelineManager
+                                const stepAllocation = {
+                                    stepId: step.name,
+                                    worktreeId: worktree.id,
+                                    worktreePath: worktree.path,
+                                    branch: worktree.branch,
+                                    status: "allocated",
+                                    allocatedAt: Date.now(),
+                                };
+                                pipelineManager.allocateWorktreeForStep(step.name, stepAllocation);
+                                // Inject worktree context into step description
+                                if (allocationResult.instructions) {
+                                    const originalDesc = step.description ?? step.subject;
+                                    step.description = injectWorktreeContext(originalDesc, worktree, "compact");
+                                }
+                                worktreeAllocations.push({
+                                    stepName: step.name,
+                                    worktreeId: worktree.id,
+                                    path: worktree.path,
+                                    branch: worktree.branch,
+                                });
+                                logger.info("Worktree allocated for step", {
+                                    stepName: step.name,
+                                    worktreeId: worktree.id,
+                                    branch: worktree.branch,
+                                });
+                            }
+                            else {
+                                logger.warn("Failed to allocate worktree for step", {
+                                    stepName: step.name,
+                                    error: allocationResult.error,
+                                });
+                            }
+                        }
+                        catch (err) {
+                            const errMsg = err instanceof Error ? err.message : String(err);
+                            logger.warn("Error allocating worktree for step", {
+                                stepName: step.name,
+                                error: errMsg,
+                            });
+                        }
+                    }
+                }
+            }
+            else if (worktreesEnabled && !worktreeManager) {
+                logger.debug("Worktrees enabled but WorktreeManager not available");
+            }
+            // Generate TaskCreate instructions (after worktree context injection)
+            const taskInstructions = pipelineManager.generatePipelineCreation(definition);
+            // Compute execution phases for the plan
+            const phases = computeExecutionPhases(definition.steps);
+            logger.info("execute_pipeline completed", {
+                name,
+                pipelineId: execution.pipelineId,
+                stepCount: steps.length,
+                phaseCount: phases.length,
+                worktreeCount: worktreeAllocations.length,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatPipelineResponse(definition, execution.pipelineId, taskInstructions, phases, parallel, worktreeAllocations.length > 0 ? worktreeAllocations : undefined, autoMerge),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (error instanceof Error) {
+                logger.error("execute_pipeline failed", {
+                    name,
+                    error,
+                    errorMessage,
+                });
+            }
+            else {
+                logger.error("execute_pipeline failed", {
+                    name,
+                    errorMessage,
+                });
+            }
+            // Return error as text content for MCP compatibility
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `## Error Creating Pipeline\n\n**Pipeline**: ${name}\n**Error**: ${errorMessage}\n\n` +
+                            `Common issues:\n` +
+                            `- Duplicate step names\n` +
+                            `- Missing dependency (step depends on non-existent step)\n` +
+                            `- Circular dependencies`,
+                    },
+                ],
+            };
+        }
+    });
+    logger.debug("Registered execute_pipeline tool", { roles: AGENT_ROLES });
+}
+//# sourceMappingURL=execute-pipeline.js.map

package/dist/mcp/tools/tasks/execute-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-pipeline.js","sourceRoot":"","sources":["../../../../src/mcp/tools/tasks/execute-pipeline.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/tasks/execute-task.d.ts

@@ -0,0 +1,32 @@
+/**
+ * execute_task MCP Tool
+ *
+ * Executes a Claude Code task using AgentRouter.
+ * Coordinates with TaskCoordinator for lifecycle management.
+ * Automatically allocates isolated git worktrees for coder/developer roles.
+ */
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Logger } from "../../../observability/logger.js";
+import type { RouterEngine } from "../../../router/engine.js";
+import type { TaskCoordinator } from "../../../tasks/coordinator.js";
+import type { WorktreeManager } from "../../../worktrees/manager.js";
+/**
+ * Registers the execute_task tool with the MCP server
+ *
+ * @param server - MCP server instance
+ * @param router - RouterEngine for agent invocation
+ * @param coordinator - TaskCoordinator for task lifecycle management
+ * @param logger - Logger instance for structured logging
+ * @param worktreeManager - Optional WorktreeManager for git worktree allocation
+ *
+ * @example
+ * ```typescript
+ * const server = new McpServer({ name: 'agent-router', version: '3.0.0' });
+ * const router = new RouterEngine(config, providers, logger);
+ * const coordinator = new TaskCoordinator(logger);
+ * const worktreeManager = new WorktreeManager(repoPath, worktreeConfig);
+ * registerExecuteTaskTool(server, router, coordinator, logger, worktreeManager);
+ * ```
+ */
+export declare function registerExecuteTaskTool(server: McpServer, router: RouterEngine, coordinator: TaskCoordinator, logger: Logger, worktreeManager?: WorktreeManager): void;
+//# sourceMappingURL=execute-task.d.ts.map

package/dist/mcp/tools/tasks/execute-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-task.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/tasks/execute-task.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAiKrE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,eAAe,EAC5B,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,eAAe,GAChC,IAAI,CAgMN"}