mcp-agent-foundry 1.0.0

package/dist/tasks/coordinator.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Task Coordinator
+ *
+ * Bridges AgentRouter execution with Claude Code Tasks.
+ * Since MCP tools cannot directly invoke Claude Code tools,
+ * the coordinator returns INSTRUCTIONS for Claude to execute.
+ *
+ * Enhanced with worktree allocation support for coding agents
+ * that need isolated git workspaces for file modifications.
+ */
+import type { Logger } from "../observability/logger.js";
+import type { ConfigManager } from "../config/manager.js";
+import type { StateCoordinator } from "./state-coordinator.js";
+import type { WorktreeManager } from "../worktrees/manager.js";
+import type { AgentResponse, ClaimInstructions, CompletionResult, FailureResult, TaskExecution, WorktreeConfig, Worktree, WorktreeInstructions } from "../types.js";
+/**
+ * Options for TaskCoordinator construction
+ */
+export interface TaskCoordinatorOptions {
+    /** Logger instance */
+    logger: Logger;
+    /** Optional StateCoordinator for unified state management */
+    stateCoordinator?: StateCoordinator;
+    /** Optional WorktreeManager for worktree allocation */
+    worktreeManager?: WorktreeManager;
+    /** Optional ConfigManager to check role configurations */
+    configManager?: ConfigManager;
+    /** Optional worktree config to check if worktrees are enabled */
+    worktreeConfig?: WorktreeConfig;
+}
+/**
+ * Result of starting an execution with optional worktree allocation
+ */
+export interface ExecutionStartResult {
+    /** The task execution record */
+    execution: TaskExecution;
+    /** Worktree allocated for this task (if applicable) */
+    worktree?: Worktree;
+    /** Worktree instructions to inject (if applicable) */
+    worktreeInstructions?: WorktreeInstructions;
+    /** Modified task prompt with worktree context injected */
+    modifiedPrompt?: string;
+}
+export declare class TaskCoordinator {
+    private activeExecutions;
+    private logger;
+    private stateCoordinator?;
+    private worktreeManager?;
+    private configManager?;
+    private worktreeConfig?;
+    constructor(options: TaskCoordinatorOptions);
+    /** @deprecated Use options object instead */
+    constructor(logger: Logger);
+    /**
+     * Generate instructions for Claude to claim a task before execution.
+     */
+    generateClaimInstructions(taskId: string, workerName: string): ClaimInstructions;
+    /**
+     * Check if a role needs an isolated worktree for execution.
+     * Checks role config override first, then falls back to default role list.
+     */
+    private taskNeedsWorktree;
+    /**
+     * Start tracking a task execution.
+     */
+    startExecution(taskId: string, role: string, traceId?: string): TaskExecution;
+    /**
+     * Start a task execution with optional worktree allocation.
+     *
+     * This enhanced method:
+     * 1. Creates task state via StateCoordinator (if available)
+     * 2. Checks if the role needs a worktree
+     * 3. Allocates worktree and generates instructions (if needed)
+     * 4. Links task to worktree in state coordinator
+     * 5. Returns modified prompt with worktree context injected
+     *
+     * @param taskId - Claude Code task ID
+     * @param role - Agent role to execute
+     * @param originalPrompt - Original task prompt/description
+     * @param agentId - Optional agent ID for worktree allocation
+     * @param traceId - Optional trace ID for correlation
+     */
+    startExecutionWithWorktree(taskId: string, role: string, originalPrompt: string, agentId?: string, traceId?: string): Promise<ExecutionStartResult>;
+    /**
+     * Get an active execution by task ID.
+     */
+    getExecution(taskId: string): TaskExecution | undefined;
+    /**
+     * Mark execution complete and generate completion instructions.
+     */
+    completeExecution(taskId: string, result: AgentResponse): CompletionResult;
+    /**
+     * Mark execution complete with worktree cleanup.
+     * This is an async version that handles worktree release.
+     */
+    completeExecutionWithWorktree(taskId: string, result: AgentResponse): Promise<CompletionResult>;
+    /**
+     * Mark execution failed and generate failure instructions.
+     */
+    failExecution(taskId: string, error: Error): FailureResult;
+    /**
+     * Mark execution failed with worktree cleanup.
+     * This is an async version that handles worktree release.
+     */
+    failExecutionWithWorktree(taskId: string, error: Error): Promise<FailureResult>;
+    /**
+     * Cleanup worktree associated with a task.
+     * Releases the worktree and unlinks from state coordinator.
+     */
+    cleanupWorktree(taskId: string): Promise<void>;
+    /**
+     * Clear a completed/failed execution from tracking.
+     */
+    clearExecution(taskId: string): void;
+    /**
+     * Get all active executions.
+     */
+    getActiveExecutions(): TaskExecution[];
+    /**
+     * Check if there are any active executions.
+     */
+    hasActiveExecutions(): boolean;
+    /**
+     * Get worktree information for a task.
+     * Returns undefined if no worktree is allocated.
+     */
+    getWorktreeForTask(taskId: string): Worktree | undefined;
+    /**
+     * Check if worktree support is available and enabled.
+     */
+    isWorktreeSupportEnabled(): boolean;
+    /**
+     * Get the state coordinator instance (if configured).
+     */
+    getStateCoordinator(): StateCoordinator | undefined;
+    /**
+     * Get the worktree manager instance (if configured).
+     */
+    getWorktreeManager(): WorktreeManager | undefined;
+}
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/tasks/coordinator.d.ts.map

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

package/dist/tasks/coordinator.js

@@ -0,0 +1,331 @@
+/**
+ * Task Coordinator
+ *
+ * Bridges AgentRouter execution with Claude Code Tasks.
+ * Since MCP tools cannot directly invoke Claude Code tools,
+ * the coordinator returns INSTRUCTIONS for Claude to execute.
+ *
+ * Enhanced with worktree allocation support for coding agents
+ * that need isolated git workspaces for file modifications.
+ */
+import { randomUUID } from "node:crypto";
+import { roleNeedsWorktree } from "../config/worktree-defaults.js";
+import { injectWorktreeContext } from "../worktrees/instructions.js";
+export class TaskCoordinator {
+    activeExecutions = new Map();
+    logger;
+    stateCoordinator;
+    worktreeManager;
+    configManager;
+    worktreeConfig;
+    constructor(optionsOrLogger) {
+        if ('logger' in optionsOrLogger && typeof optionsOrLogger.logger === 'object') {
+            // New options-based constructor
+            const options = optionsOrLogger;
+            this.logger = options.logger;
+            this.stateCoordinator = options.stateCoordinator;
+            this.worktreeManager = options.worktreeManager;
+            this.configManager = options.configManager;
+            this.worktreeConfig = options.worktreeConfig;
+        }
+        else {
+            // Legacy constructor for backward compatibility
+            this.logger = optionsOrLogger;
+        }
+    }
+    /**
+     * Generate instructions for Claude to claim a task before execution.
+     */
+    generateClaimInstructions(taskId, workerName) {
+        return {
+            preExecution: `TaskUpdate({ taskId: "${taskId}", status: "in_progress", owner: "${workerName}" })`,
+            onSuccess: `TaskUpdate({ taskId: "${taskId}", status: "completed" })`,
+            onFailure: `TaskUpdate({ taskId: "${taskId}", status: "pending", owner: null })`,
+        };
+    }
+    /**
+     * Check if a role needs an isolated worktree for execution.
+     * Checks role config override first, then falls back to default role list.
+     */
+    taskNeedsWorktree(role) {
+        // Check if worktrees are enabled globally
+        if (this.worktreeConfig && !this.worktreeConfig.enabled) {
+            return false;
+        }
+        // Check if worktree manager is available
+        if (!this.worktreeManager) {
+            return false;
+        }
+        // Check role-specific config override
+        if (this.configManager) {
+            const roleConfig = this.configManager.getRole(role);
+            if (roleConfig?.needs_worktree !== undefined) {
+                return roleConfig.needs_worktree;
+            }
+        }
+        // Fall back to default role list
+        return roleNeedsWorktree(role);
+    }
+    /**
+     * Start tracking a task execution.
+     */
+    startExecution(taskId, role, traceId) {
+        const execution = {
+            taskId,
+            role,
+            traceId: traceId ?? randomUUID(),
+            startTime: Date.now(),
+            status: "running",
+        };
+        this.activeExecutions.set(taskId, execution);
+        this.logger.debug("Task execution started", { taskId, role, traceId: execution.traceId });
+        return execution;
+    }
+    /**
+     * Start a task execution with optional worktree allocation.
+     *
+     * This enhanced method:
+     * 1. Creates task state via StateCoordinator (if available)
+     * 2. Checks if the role needs a worktree
+     * 3. Allocates worktree and generates instructions (if needed)
+     * 4. Links task to worktree in state coordinator
+     * 5. Returns modified prompt with worktree context injected
+     *
+     * @param taskId - Claude Code task ID
+     * @param role - Agent role to execute
+     * @param originalPrompt - Original task prompt/description
+     * @param agentId - Optional agent ID for worktree allocation
+     * @param traceId - Optional trace ID for correlation
+     */
+    async startExecutionWithWorktree(taskId, role, originalPrompt, agentId, traceId) {
+        const executionTraceId = traceId ?? randomUUID();
+        // Create task in state coordinator if available
+        if (this.stateCoordinator) {
+            this.stateCoordinator.createTask(taskId, role);
+        }
+        // Start the basic execution tracking
+        const execution = this.startExecution(taskId, role, executionTraceId);
+        // Mark task as started in state coordinator
+        if (this.stateCoordinator) {
+            this.stateCoordinator.startTask(taskId);
+        }
+        // Check if this role needs a worktree
+        if (!this.taskNeedsWorktree(role)) {
+            this.logger.debug("Role does not need worktree", { taskId, role });
+            return { execution };
+        }
+        // Allocate worktree
+        const effectiveAgentId = agentId ?? `agent-${executionTraceId.slice(0, 8)}`;
+        try {
+            const allocationResult = await this.worktreeManager.allocate(taskId, effectiveAgentId);
+            if (!allocationResult.success || !allocationResult.worktree) {
+                this.logger.warn("Failed to allocate worktree, proceeding without isolation", {
+                    taskId,
+                    role,
+                    error: allocationResult.error,
+                });
+                return { execution };
+            }
+            const worktree = allocationResult.worktree;
+            const worktreeInstructions = allocationResult.instructions;
+            // Link task to worktree in state coordinator
+            if (this.stateCoordinator) {
+                this.stateCoordinator.linkTaskToWorktree(taskId, worktree.id);
+            }
+            // Inject worktree instructions into prompt
+            const modifiedPrompt = injectWorktreeContext(originalPrompt, worktree, "full");
+            this.logger.info("Task execution started with worktree", {
+                taskId,
+                role,
+                worktreeId: worktree.id,
+                worktreePath: worktree.path,
+                branch: worktree.branch,
+            });
+            return {
+                execution,
+                worktree,
+                worktreeInstructions,
+                modifiedPrompt,
+            };
+        }
+        catch (error) {
+            this.logger.error("Error allocating worktree", {
+                taskId,
+                role,
+                errorMessage: error instanceof Error ? error.message : String(error),
+            });
+            // Proceed without worktree on allocation failure
+            return { execution };
+        }
+    }
+    /**
+     * Get an active execution by task ID.
+     */
+    getExecution(taskId) {
+        return this.activeExecutions.get(taskId);
+    }
+    /**
+     * Mark execution complete and generate completion instructions.
+     */
+    completeExecution(taskId, result) {
+        const execution = this.activeExecutions.get(taskId);
+        if (!execution) {
+            throw new Error(`No active execution for task ${taskId}`);
+        }
+        execution.status = "completed";
+        execution.endTime = Date.now();
+        execution.result = result;
+        const durationMs = execution.endTime - execution.startTime;
+        this.logger.info("Task execution completed", {
+            taskId,
+            role: execution.role,
+            durationMs,
+            provider: result.provider,
+            model: result.model,
+        });
+        // Update state coordinator
+        if (this.stateCoordinator) {
+            this.stateCoordinator.completeTask(taskId);
+        }
+        // Cleanup worktree is done asynchronously via cleanupWorktree method
+        // to avoid blocking the completion response
+        return {
+            execution,
+            instructions: `TaskUpdate({ taskId: "${taskId}", status: "completed" })`,
+            result,
+        };
+    }
+    /**
+     * Mark execution complete with worktree cleanup.
+     * This is an async version that handles worktree release.
+     */
+    async completeExecutionWithWorktree(taskId, result) {
+        const completionResult = this.completeExecution(taskId, result);
+        // Cleanup worktree
+        await this.cleanupWorktree(taskId);
+        return completionResult;
+    }
+    /**
+     * Mark execution failed and generate failure instructions.
+     */
+    failExecution(taskId, error) {
+        const execution = this.activeExecutions.get(taskId);
+        if (!execution) {
+            throw new Error(`No active execution for task ${taskId}`);
+        }
+        execution.status = "failed";
+        execution.endTime = Date.now();
+        execution.error = error;
+        const durationMs = execution.endTime - execution.startTime;
+        this.logger.error("Task execution failed", {
+            taskId,
+            role: execution.role,
+            durationMs,
+            error,
+        });
+        // Update state coordinator
+        if (this.stateCoordinator) {
+            this.stateCoordinator.failTask(taskId, error.message);
+        }
+        // Cleanup worktree is done asynchronously via cleanupWorktree method
+        // Release the task so it can be retried
+        return {
+            execution,
+            instructions: `TaskUpdate({ taskId: "${taskId}", status: "pending", owner: null })`,
+            error,
+        };
+    }
+    /**
+     * Mark execution failed with worktree cleanup.
+     * This is an async version that handles worktree release.
+     */
+    async failExecutionWithWorktree(taskId, error) {
+        const failureResult = this.failExecution(taskId, error);
+        // Cleanup worktree
+        await this.cleanupWorktree(taskId);
+        return failureResult;
+    }
+    /**
+     * Cleanup worktree associated with a task.
+     * Releases the worktree and unlinks from state coordinator.
+     */
+    async cleanupWorktree(taskId) {
+        // Check if task has a worktree
+        let worktreeId;
+        if (this.stateCoordinator) {
+            worktreeId = this.stateCoordinator.getWorktreeForTask(taskId);
+        }
+        if (!worktreeId && this.worktreeManager) {
+            // Try to find worktree by task ID directly
+            const worktree = this.worktreeManager.getByTaskId(taskId);
+            worktreeId = worktree?.id;
+        }
+        if (!worktreeId || !this.worktreeManager) {
+            return; // No worktree to cleanup
+        }
+        try {
+            // Release the worktree
+            await this.worktreeManager.release(worktreeId);
+            // Unlink from state coordinator
+            if (this.stateCoordinator) {
+                this.stateCoordinator.unlinkTaskFromWorktree(taskId);
+            }
+            this.logger.info("Worktree cleaned up for task", { taskId, worktreeId });
+        }
+        catch (error) {
+            this.logger.warn("Failed to cleanup worktree", {
+                taskId,
+                worktreeId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /**
+     * Clear a completed/failed execution from tracking.
+     */
+    clearExecution(taskId) {
+        this.activeExecutions.delete(taskId);
+    }
+    /**
+     * Get all active executions.
+     */
+    getActiveExecutions() {
+        return Array.from(this.activeExecutions.values());
+    }
+    /**
+     * Check if there are any active executions.
+     */
+    hasActiveExecutions() {
+        return this.activeExecutions.size > 0;
+    }
+    /**
+     * Get worktree information for a task.
+     * Returns undefined if no worktree is allocated.
+     */
+    getWorktreeForTask(taskId) {
+        if (this.worktreeManager) {
+            return this.worktreeManager.getByTaskId(taskId);
+        }
+        return undefined;
+    }
+    /**
+     * Check if worktree support is available and enabled.
+     */
+    isWorktreeSupportEnabled() {
+        return !!(this.worktreeManager &&
+            (!this.worktreeConfig || this.worktreeConfig.enabled));
+    }
+    /**
+     * Get the state coordinator instance (if configured).
+     */
+    getStateCoordinator() {
+        return this.stateCoordinator;
+    }
+    /**
+     * Get the worktree manager instance (if configured).
+     */
+    getWorktreeManager() {
+        return this.worktreeManager;
+    }
+}
+//# sourceMappingURL=coordinator.js.map

package/dist/tasks/coordinator.js.map

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

package/dist/tasks/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tasks Module
+ *
+ * Provides integration with Claude Code's Tasks system.
+ * Exports the core classes for task coordination, pipeline management,
+ * worker mode execution, and unified state management.
+ */
+export { TaskCoordinator } from "./coordinator.js";
+export { PipelineManager } from "./pipeline-manager.js";
+export { WorkerMode } from "./worker-mode.js";
+export { StateCoordinator, type TaskState, type StateEvents } from "./state-coordinator.js";
+export { PersistentStateCoordinator } from "./persistent-state-coordinator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tasks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tasks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/tasks/index.js

@@ -0,0 +1,13 @@
+/**
+ * Tasks Module
+ *
+ * Provides integration with Claude Code's Tasks system.
+ * Exports the core classes for task coordination, pipeline management,
+ * worker mode execution, and unified state management.
+ */
+export { TaskCoordinator } from "./coordinator.js";
+export { PipelineManager } from "./pipeline-manager.js";
+export { WorkerMode } from "./worker-mode.js";
+export { StateCoordinator } from "./state-coordinator.js";
+export { PersistentStateCoordinator } from "./persistent-state-coordinator.js";
+//# sourceMappingURL=index.js.map

package/dist/tasks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tasks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAoC,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/tasks/persistent-state-coordinator.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Persistent State Coordinator
+ *
+ * Extends StateCoordinator to automatically persist all state changes
+ * to disk using StateStore. Supports state restoration on initialization.
+ */
+import { StateCoordinator } from './state-coordinator.js';
+import { StateStore } from '../persistence/state-store.js';
+/**
+ * PersistentStateCoordinator extends StateCoordinator with automatic
+ * state persistence. All state changes are automatically saved to disk
+ * via the StateStore, and state is restored on initialization.
+ *
+ * @example
+ * ```typescript
+ * const stateStore = new StateStore({ stateDir: '.agent-foundry' });
+ * const coordinator = new PersistentStateCoordinator(stateStore, '/path/to/repo');
+ *
+ * await coordinator.initialize();
+ *
+ * // All state changes are automatically persisted
+ * coordinator.createTask('task-1', 'coder');
+ * coordinator.startTask('task-1');
+ *
+ * // Clean shutdown ensures all pending writes complete
+ * await coordinator.shutdown();
+ * ```
+ */
+export declare class PersistentStateCoordinator extends StateCoordinator {
+    private readonly stateStore;
+    private readonly repoPath;
+    private initialized;
+    constructor(stateStore: StateStore, repoPath: string);
+    /**
+     * Initialize the coordinator - load persisted state and restore it.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if the coordinator has been initialized.
+     */
+    isInitialized(): boolean;
+    /**
+     * Setup event listeners to persist state changes.
+     * Called in constructor before initialize.
+     */
+    private setupPersistenceHooks;
+    /**
+     * Restore in-memory state from persisted state.
+     * Handles stale/orphaned entries gracefully.
+     */
+    private restoreFromPersistedState;
+    /**
+     * Persist a newly created task.
+     */
+    private persistTaskCreated;
+    /**
+     * Persist a task status update.
+     */
+    private persistTaskUpdated;
+    /**
+     * Persist a worktree link.
+     */
+    private persistWorktreeLink;
+    /**
+     * Persist a worktree unlink.
+     */
+    private persistWorktreeUnlink;
+    /**
+     * Persist a conflict detection.
+     */
+    private persistConflictDetected;
+    /**
+     * Persist a conflict resolution.
+     */
+    private persistConflictResolved;
+    /**
+     * Convert TaskState to PersistedTaskState.
+     */
+    private toPersistedTask;
+    /**
+     * Shutdown the coordinator and ensure all state is persisted.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Force an immediate save of all pending state changes.
+     */
+    saveNow(): Promise<void>;
+}
+//# sourceMappingURL=persistent-state-coordinator.d.ts.map

package/dist/tasks/persistent-state-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-state-coordinator.d.ts","sourceRoot":"","sources":["../../src/tasks/persistent-state-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAkB,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAY3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,WAAW,CAAkB;gBAEzB,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;IAOpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAqC7B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAoGjC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}