@compass-ai/nova 1.0.72 → 1.0.74

package/dist/services/workflow-manager.d.ts

@@ -0,0 +1,277 @@
+/**
+ * Workflow manager for state machine-based task execution.
+ *
+ * This service provides a workflow engine that coordinates multi-step tasks
+ * using a state machine pattern. It integrates with StepTracker, ActionLogger,
+ * ToolRegistry, and LogInterpreter to provide complete orchestration.
+ */
+import { Step, StepType, Task } from './step-tracker.js';
+/**
+ * Workflow execution state
+ */
+export declare enum WorkflowState {
+    IDLE = "idle",
+    PLANNING = "planning",
+    EXECUTING = "executing",
+    VERIFYING = "verifying",
+    PAUSED = "paused",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    CANCELLED = "cancelled"
+}
+/**
+ * Workflow execution strategy
+ */
+export declare enum ExecutionStrategy {
+    /** Execute steps sequentially in order */
+    SEQUENTIAL = "sequential",
+    /** Execute independent steps in parallel */
+    PARALLEL = "parallel",
+    /** Execute with conditional branching */
+    CONDITIONAL = "conditional"
+}
+/**
+ * Represents a workflow definition
+ */
+export interface Workflow {
+    /** Unique workflow ID */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Description of workflow goal */
+    description: string;
+    /** Current state */
+    state: WorkflowState;
+    /** Execution strategy */
+    strategy: ExecutionStrategy;
+    /** Associated task ID from StepTracker */
+    taskId?: string;
+    /** Action chain ID from ActionLogger */
+    actionChainId?: string;
+    /** Workflow configuration */
+    config: WorkflowConfig;
+    /** Timestamps */
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    /** Execution context */
+    context: WorkflowContext;
+}
+/**
+ * Workflow configuration
+ */
+export interface WorkflowConfig {
+    /** Maximum execution time in milliseconds */
+    timeout?: number;
+    /** Whether to continue on step failure */
+    continueOnError?: boolean;
+    /** Whether to require approval for each step */
+    requireApproval?: boolean;
+    /** Maximum retry attempts for failed steps */
+    maxRetries?: number;
+    /** Verification step after execution */
+    verificationStep?: WorkflowVerificationStep;
+}
+/**
+ * Verification step configuration
+ */
+export interface WorkflowVerificationStep {
+    /** Type of verification */
+    type: 'command' | 'test' | 'build' | 'custom';
+    /** Command to run or tool to execute */
+    command?: string;
+    /** Custom verification function */
+    verify?: (workflow: Workflow) => Promise<boolean>;
+}
+/**
+ * Workflow execution context
+ */
+export interface WorkflowContext {
+    /** Project root directory */
+    projectRoot: string;
+    /** User request that triggered the workflow */
+    userRequest?: string;
+    /** LLM reasoning for the workflow */
+    reasoning?: string;
+    /** Accumulated results from steps */
+    results: Record<string, any>;
+    /** Error information if failed */
+    error?: string;
+    /** Metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Workflow execution result
+ */
+export interface WorkflowResult {
+    /** Whether workflow succeeded */
+    success: boolean;
+    /** Final workflow state */
+    state: WorkflowState;
+    /** Results from all steps */
+    stepResults: Array<{
+        stepId: string;
+        stepName: string;
+        success: boolean;
+        result?: any;
+    }>;
+    /** Overall summary */
+    summary: string;
+    /** Duration in milliseconds */
+    duration?: number;
+}
+/**
+ * WorkflowManager class orchestrates complex multi-step tasks using a state machine.
+ *
+ * Features:
+ * - State machine-based workflow execution
+ * - Integration with StepTracker for step management
+ * - Integration with ActionLogger for action tracking
+ * - Tool execution via ToolRegistry
+ * - Log interpretation for error detection
+ * - Automatic verification after execution
+ * - Event emission for UI updates
+ */
+declare class WorkflowManager {
+    private workflows;
+    private currentWorkflowId;
+    private projectRoot;
+    /**
+     * Creates a new workflow.
+     *
+     * @param name - Workflow name
+     * @param description - Workflow description
+     * @param strategy - Execution strategy
+     * @param config - Workflow configuration
+     * @returns The created Workflow
+     *
+     * @example
+     * ```typescript
+     * const manager = getWorkflowManager();
+     * const workflow = manager.createWorkflow(
+     *   'Build and Test',
+     *   'Build the project and run tests',
+     *   ExecutionStrategy.SEQUENTIAL,
+     *   {
+     *     timeout: 300000,
+     *     requireApproval: false,
+     *     verificationStep: {
+     *       type: 'test',
+     *       command: 'npm test'
+     *     }
+     *   }
+     * );
+     * ```
+     */
+    createWorkflow(name: string, description: string, strategy?: ExecutionStrategy, config?: WorkflowConfig): Workflow;
+    /**
+     * Plans a workflow by creating steps.
+     *
+     * @param workflowId - Workflow ID
+     * @param userRequest - User's request
+     * @param reasoning - LLM's reasoning
+     * @returns The Task created for this workflow
+     */
+    planWorkflow(workflowId: string, userRequest: string, reasoning?: string): Promise<Task>;
+    /**
+     * Adds a step to the workflow.
+     *
+     * @param workflowId - Workflow ID
+     * @param name - Step name
+     * @param type - Step type
+     * @param handler - Step execution handler
+     * @param options - Additional step options
+     * @returns The created Step
+     */
+    addStep(workflowId: string, name: string, type: StepType, handler: (step: Step, workflow: Workflow) => Promise<any>, options?: {
+        description?: string;
+        dependencies?: string[];
+        metadata?: Record<string, any>;
+    }): Step;
+    /**
+     * Executes a workflow.
+     *
+     * @param workflowId - Workflow ID
+     * @returns Workflow execution result
+     */
+    executeWorkflow(workflowId: string): Promise<WorkflowResult>;
+    /**
+     * Executes steps sequentially.
+     */
+    private executeSequential;
+    /**
+     * Executes independent steps in parallel.
+     */
+    private executeParallel;
+    /**
+     * Runs the verification step.
+     */
+    private runVerification;
+    /**
+     * Pauses a workflow.
+     *
+     * @param workflowId - Workflow ID
+     */
+    pauseWorkflow(workflowId: string): void;
+    /**
+     * Cancels a workflow.
+     *
+     * @param workflowId - Workflow ID
+     */
+    cancelWorkflow(workflowId: string): void;
+    /**
+     * Gets a workflow by ID.
+     *
+     * @param workflowId - Workflow ID
+     * @returns The Workflow or undefined
+     */
+    getWorkflow(workflowId: string): Workflow | undefined;
+    /**
+     * Gets the current active workflow.
+     *
+     * @returns The current Workflow or null
+     */
+    getCurrentWorkflow(): Workflow | null;
+    /**
+     * Gets all workflows.
+     *
+     * @returns Array of all Workflow objects
+     */
+    getAllWorkflows(): Workflow[];
+    /**
+     * Sets the project root path.
+     *
+     * @param projectRoot - Project root directory
+     */
+    setProjectRoot(projectRoot: string): void;
+    /**
+     * Clears a workflow.
+     *
+     * @param workflowId - Workflow ID
+     */
+    clearWorkflow(workflowId: string): void;
+    /**
+     * Clears all completed workflows.
+     */
+    clearCompletedWorkflows(): void;
+}
+/**
+ * Gets the singleton WorkflowManager instance.
+ *
+ * @returns The WorkflowManager instance
+ *
+ * @example
+ * ```typescript
+ * const manager = getWorkflowManager();
+ * const workflow = manager.createWorkflow('My Workflow', 'Description');
+ * ```
+ */
+export declare function getWorkflowManager(): WorkflowManager;
+/**
+ * Creates a new WorkflowManager instance.
+ *
+ * @returns A new WorkflowManager instance
+ */
+export declare function createWorkflowManager(): WorkflowManager;
+export { WorkflowManager };
+//# sourceMappingURL=workflow-manager.d.ts.map

package/dist/services/workflow-manager.d.ts.map

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