@compass-ai/nova 1.0.74 → 1.0.75

package/dist/services/step-tracker.d.ts

@@ -1,356 +0,0 @@
-/**
- * Step tracking service for orchestrating multi-step tasks.
- *
- * This service provides comprehensive step management functionality for tracking
- * the progress of complex multi-step operations, including planning, execution,
- * and verification phases.
- */
-/**
- * Status of a step in the execution pipeline
- */
-export declare enum StepStatus {
-    PENDING = "pending",
-    IN_PROGRESS = "in_progress",
-    COMPLETED = "completed",
-    FAILED = "failed",
-    SKIPPED = "skipped",
-    BLOCKED = "blocked"
-}
-/**
- * Type of step being executed
- */
-export declare enum StepType {
-    ANALYSIS = "analysis",
-    FILE_READ = "file_read",
-    FILE_WRITE = "file_write",
-    FILE_DELETE = "file_delete",
-    COMMAND_EXEC = "command_exec",
-    VERIFICATION = "verification",
-    PLANNING = "planning",
-    APPROVAL = "approval",
-    CUSTOM = "custom"
-}
-/**
- * Represents a single step in a multi-step task
- */
-export interface Step {
-    /** Unique identifier for the step */
-    id: string;
-    /** Parent task ID this step belongs to */
-    taskId: string;
-    /** Human-readable name of the step */
-    name: string;
-    /** Detailed description of what this step does */
-    description: string;
-    /** Type of step */
-    type: StepType;
-    /** Current status of the step */
-    status: StepStatus;
-    /** Order of execution (0-indexed) */
-    order: number;
-    /** Step dependencies (IDs of steps that must complete first) */
-    dependencies: string[];
-    /** Timestamp when step was created */
-    createdAt: string;
-    /** Timestamp when step execution started */
-    startedAt?: string;
-    /** Timestamp when step completed/failed */
-    completedAt?: string;
-    /** Duration in milliseconds */
-    duration?: number;
-    /** Result data from step execution */
-    result?: any;
-    /** Error information if step failed */
-    error?: StepError;
-    /** Metadata for step-specific data */
-    metadata?: Record<string, any>;
-}
-/**
- * Error information for failed steps
- */
-export interface StepError {
-    /** Error message */
-    message: string;
-    /** Error code or type */
-    code?: string;
-    /** Stack trace if available */
-    stack?: string;
-    /** Whether the step is retryable */
-    retryable: boolean;
-    /** Number of retry attempts made */
-    retryCount: number;
-}
-/**
- * Represents a multi-step task
- */
-export interface Task {
-    /** Unique identifier for the task */
-    id: string;
-    /** Human-readable name of the task */
-    name: string;
-    /** Detailed description of the task goal */
-    description: string;
-    /** Current status based on step statuses */
-    status: TaskStatus;
-    /** Steps in this task */
-    steps: Step[];
-    /** Timestamp when task was created */
-    createdAt: string;
-    /** Timestamp when task started */
-    startedAt?: string;
-    /** Timestamp when task completed */
-    completedAt?: string;
-    /** Total duration in milliseconds */
-    duration?: number;
-    /** Overall task result */
-    result?: TaskResult;
-    /** Task metadata */
-    metadata?: Record<string, any>;
-}
-/**
- * Overall status of a task
- */
-export declare enum TaskStatus {
-    PLANNED = "planned",
-    IN_PROGRESS = "in_progress",
-    COMPLETED = "completed",
-    FAILED = "failed",
-    PARTIALLY_COMPLETED = "partially_completed",
-    CANCELLED = "cancelled"
-}
-/**
- * Result of task execution
- */
-export interface TaskResult {
-    /** Whether the task succeeded */
-    success: boolean;
-    /** Number of completed steps */
-    completedSteps: number;
-    /** Number of failed steps */
-    failedSteps: number;
-    /** Number of skipped steps */
-    skippedSteps: number;
-    /** Summary message */
-    summary: string;
-    /** Detailed results per step */
-    stepResults?: Record<string, any>;
-}
-/**
- * Options for creating a step
- */
-export interface CreateStepOptions {
-    name: string;
-    description: string;
-    type: StepType;
-    order?: number;
-    dependencies?: string[];
-    metadata?: Record<string, any>;
-}
-/**
- * StepTracker class provides comprehensive step tracking for multi-step tasks.
- *
- * Features:
- * - Task creation with multiple steps
- * - Dependency management between steps
- * - Progress tracking and status updates
- * - Error handling and retry logic
- * - Event emission for UI updates
- * - Integration with session management
- */
-declare class StepTracker {
-    private tasks;
-    private currentTaskId;
-    /**
-     * Creates a new task with initial planning state.
-     *
-     * @param name - Human-readable task name
-     * @param description - Detailed task description
-     * @param metadata - Optional metadata for the task
-     * @returns The newly created Task object
-     *
-     * @example
-     * ```typescript
-     * const tracker = getStepTracker();
-     * const task = tracker.createTask(
-     *   'Implement Login Feature',
-     *   'Add user authentication with JWT tokens'
-     * );
-     * ```
-     */
-    createTask(name: string, description: string, metadata?: Record<string, any>): Task;
-    /**
-     * Adds a step to the specified task.
-     *
-     * @param taskId - ID of the task to add the step to
-     * @param options - Step creation options
-     * @returns The newly created Step object
-     *
-     * @example
-     * ```typescript
-     * const step = tracker.addStep(taskId, {
-     *   name: 'Read user model',
-     *   description: 'Load src/models/User.ts for analysis',
-     *   type: StepType.FILE_READ,
-     *   metadata: { filePath: 'src/models/User.ts' }
-     * });
-     * ```
-     */
-    addStep(taskId: string, options: CreateStepOptions): Step;
-    /**
-     * Adds multiple steps to a task in batch.
-     *
-     * @param taskId - ID of the task
-     * @param stepsOptions - Array of step creation options
-     * @returns Array of created Step objects
-     */
-    addSteps(taskId: string, stepsOptions: CreateStepOptions[]): Step[];
-    /**
-     * Marks a step as started and updates its status.
-     *
-     * @param taskId - ID of the task
-     * @param stepId - ID of the step to start
-     * @returns The updated Step object
-     */
-    startStep(taskId: string, stepId: string): Step;
-    /**
-     * Marks a step as completed with optional result data.
-     *
-     * @param taskId - ID of the task
-     * @param stepId - ID of the step to complete
-     * @param result - Optional result data from step execution
-     * @returns The updated Step object
-     */
-    completeStep(taskId: string, stepId: string, result?: any): Step;
-    /**
-     * Marks a step as failed with error information.
-     *
-     * @param taskId - ID of the task
-     * @param stepId - ID of the step that failed
-     * @param error - Error information
-     * @param retryable - Whether the step can be retried
-     * @returns The updated Step object
-     */
-    failStep(taskId: string, stepId: string, error: string | Error, retryable?: boolean): Step;
-    /**
-     * Skips a step, marking it as not executed.
-     *
-     * @param taskId - ID of the task
-     * @param stepId - ID of the step to skip
-     * @param reason - Reason for skipping
-     * @returns The updated Step object
-     */
-    skipStep(taskId: string, stepId: string, reason?: string): Step;
-    /**
-     * Retries a failed step.
-     *
-     * @param taskId - ID of the task
-     * @param stepId - ID of the step to retry
-     * @returns The updated Step object
-     */
-    retryStep(taskId: string, stepId: string): Step;
-    /**
-     * Updates the overall task status based on step statuses.
-     *
-     * @param taskId - ID of the task to update
-     */
-    private updateTaskStatus;
-    /**
-     * Generates a task result summary.
-     *
-     * @param task - The task to generate result for
-     * @returns TaskResult object
-     */
-    private generateTaskResult;
-    /**
-     * Gets a task by ID.
-     *
-     * @param taskId - ID of the task to retrieve
-     * @returns The Task object or undefined if not found
-     */
-    getTask(taskId: string): Task | undefined;
-    /**
-     * Gets the current active task.
-     *
-     * @returns The current Task object or null if none is active
-     */
-    getCurrentTask(): Task | null;
-    /**
-     * Gets all tasks.
-     *
-     * @returns Array of all Task objects
-     */
-    getAllTasks(): Task[];
-    /**
-     * Gets a specific step from a task.
-     *
-     * @param taskId - ID of the task
-     * @param stepId - ID of the step
-     * @returns The Step object or undefined if not found
-     */
-    getStep(taskId: string, stepId: string): Step | undefined;
-    /**
-     * Gets all pending steps for a task (steps that can be executed).
-     *
-     * @param taskId - ID of the task
-     * @returns Array of Step objects that are pending and have no unmet dependencies
-     */
-    getPendingSteps(taskId: string): Step[];
-    /**
-     * Gets the next step to execute based on order and dependencies.
-     *
-     * @param taskId - ID of the task
-     * @returns The next Step to execute or undefined if none available
-     */
-    getNextStep(taskId: string): Step | undefined;
-    /**
-     * Gets task progress as a percentage.
-     *
-     * @param taskId - ID of the task
-     * @returns Progress percentage (0-100)
-     */
-    getTaskProgress(taskId: string): number;
-    /**
-     * Cancels a task and all its pending steps.
-     *
-     * @param taskId - ID of the task to cancel
-     */
-    cancelTask(taskId: string): void;
-    /**
-     * Clears a task from the tracker.
-     *
-     * @param taskId - ID of the task to clear
-     */
-    clearTask(taskId: string): void;
-    /**
-     * Clears all completed tasks.
-     */
-    clearCompletedTasks(): void;
-    /**
-     * Exports task data for persistence or analysis.
-     *
-     * @param taskId - ID of the task to export
-     * @returns The task data or undefined if not found
-     */
-    exportTask(taskId: string): Task | undefined;
-}
-/**
- * Gets the singleton StepTracker instance.
- *
- * @returns The StepTracker instance
- *
- * @example
- * ```typescript
- * const tracker = getStepTracker();
- * const task = tracker.createTask('Build Project', 'Compile and test the project');
- * ```
- */
-export declare function getStepTracker(): StepTracker;
-/**
- * Creates a new StepTracker instance.
- * Use this when you need a separate instance from the singleton.
- *
- * @returns A new StepTracker instance
- */
-export declare function createStepTracker(): StepTracker;
-export { StepTracker };
-//# sourceMappingURL=step-tracker.d.ts.map

package/dist/services/step-tracker.d.ts.map

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