@compass-ai/nova 1.0.74 → 1.0.76

package/dist/services/action-logger.d.ts

@@ -1,383 +0,0 @@
-/**
- * Action logging service for recording LLM decisions and execution status.
- *
- * This service provides comprehensive logging of all actions decided and executed
- * by the LLM, including the reasoning behind decisions, execution results, and
- * tracking of action chains.
- */
-/**
- * Type of action the LLM can perform
- */
-export declare enum ActionType {
-    FILE_READ = "file_read",
-    FILE_WRITE = "file_write",
-    FILE_DELETE = "file_delete",
-    FILE_RENAME = "file_rename",
-    COMMAND_EXEC = "command_exec",
-    CODE_ANALYSIS = "code_analysis",
-    CODE_GENERATION = "code_generation",
-    REFACTORING = "refactoring",
-    TESTING = "testing",
-    DEBUGGING = "debugging",
-    DOCUMENTATION = "documentation",
-    SEARCH = "search",
-    PLANNING = "planning",
-    APPROVAL_REQUEST = "approval_request",
-    CUSTOM = "custom"
-}
-/**
- * Status of an action
- */
-export declare enum ActionStatus {
-    PLANNED = "planned",
-    PENDING_APPROVAL = "pending_approval",
-    APPROVED = "approved",
-    REJECTED = "rejected",
-    IN_PROGRESS = "in_progress",
-    COMPLETED = "completed",
-    FAILED = "failed",
-    CANCELLED = "cancelled"
-}
-/**
- * Represents a single action decided by the LLM
- */
-export interface Action {
-    /** Unique identifier for the action */
-    id: string;
-    /** Type of action */
-    type: ActionType;
-    /** Current status */
-    status: ActionStatus;
-    /** Human-readable description */
-    description: string;
-    /** LLM's reasoning for this action */
-    reasoning?: string;
-    /** Parameters for the action */
-    parameters: Record<string, any>;
-    /** Expected outcome */
-    expectedOutcome?: string;
-    /** Actual result after execution */
-    result?: ActionResult;
-    /** Parent action ID if this is a sub-action */
-    parentActionId?: string;
-    /** Related actions (dependencies, follow-ups, etc.) */
-    relatedActions: string[];
-    /** Timestamp when action was created */
-    createdAt: string;
-    /** Timestamp when action started */
-    startedAt?: string;
-    /** Timestamp when action completed */
-    completedAt?: string;
-    /** Duration in milliseconds */
-    duration?: number;
-    /** Approval information if required */
-    approval?: ApprovalInfo;
-    /** Metadata for action-specific data */
-    metadata?: Record<string, any>;
-}
-/**
- * Result of action execution
- */
-export interface ActionResult {
-    /** Whether the action succeeded */
-    success: boolean;
-    /** Result data */
-    data?: any;
-    /** Error information if failed */
-    error?: ActionError;
-    /** Output/logs from execution */
-    output?: string;
-    /** Changes made (for file operations) */
-    changes?: ActionChanges;
-}
-/**
- * Error information for failed actions
- */
-export interface ActionError {
-    /** Error message */
-    message: string;
-    /** Error code or type */
-    code?: string;
-    /** Stack trace if available */
-    stack?: string;
-    /** Whether the action can be retried */
-    retryable: boolean;
-}
-/**
- * Changes made by an action
- */
-export interface ActionChanges {
-    /** Files created */
-    filesCreated?: string[];
-    /** Files modified */
-    filesModified?: string[];
-    /** Files deleted */
-    filesDeleted?: string[];
-    /** Commands executed */
-    commandsExecuted?: string[];
-    /** Diff output */
-    diff?: string;
-}
-/**
- * Approval information for actions requiring user consent
- */
-export interface ApprovalInfo {
-    /** Whether approval is required */
-    required: boolean;
-    /** Whether approval was granted */
-    granted?: boolean;
-    /** Timestamp of approval decision */
-    decidedAt?: string;
-    /** User who approved/rejected */
-    decidedBy?: string;
-    /** Reason for rejection if applicable */
-    rejectionReason?: string;
-}
-/**
- * Represents a chain of related actions
- */
-export interface ActionChain {
-    /** Unique identifier for the chain */
-    id: string;
-    /** Human-readable name */
-    name: string;
-    /** Description of the overall goal */
-    description: string;
-    /** Actions in this chain */
-    actions: Action[];
-    /** Timestamp when chain was created */
-    createdAt: string;
-    /** Overall status */
-    status: 'active' | 'completed' | 'failed' | 'cancelled';
-    /** Metadata */
-    metadata?: Record<string, any>;
-}
-/**
- * Summary statistics for action logging
- */
-export interface ActionStatistics {
-    /** Total actions logged */
-    totalActions: number;
-    /** Actions by status */
-    byStatus: Record<ActionStatus, number>;
-    /** Actions by type */
-    byType: Record<ActionType, number>;
-    /** Success rate percentage */
-    successRate: number;
-    /** Average action duration in ms */
-    averageDuration: number;
-    /** Most common action type */
-    mostCommonType: ActionType | null;
-}
-/**
- * ActionLogger class provides comprehensive logging of LLM actions.
- *
- * Features:
- * - Action recording with reasoning and parameters
- * - Status tracking through action lifecycle
- * - Action chain management for related operations
- * - Approval workflow integration
- * - Persistent logging to disk
- * - Statistics and analysis
- */
-declare class ActionLogger {
-    private actions;
-    private chains;
-    private currentChainId;
-    private projectRoot;
-    /**
-     * Records a new action from the LLM.
-     *
-     * @param type - Type of action
-     * @param description - Human-readable description
-     * @param parameters - Action parameters
-     * @param options - Additional action options
-     * @returns The created Action object
-     *
-     * @example
-     * ```typescript
-     * const logger = getActionLogger();
-     * const action = logger.recordAction(
-     *   ActionType.FILE_WRITE,
-     *   'Update user authentication logic',
-     *   { filePath: 'src/auth.ts', content: '...' },
-     *   { reasoning: 'Need to add JWT token validation' }
-     * );
-     * ```
-     */
-    recordAction(type: ActionType, description: string, parameters: Record<string, any>, options?: {
-        reasoning?: string;
-        expectedOutcome?: string;
-        requiresApproval?: boolean;
-        parentActionId?: string;
-        metadata?: Record<string, any>;
-    }): Action;
-    /**
-     * Starts an action chain for grouping related actions.
-     *
-     * @param name - Chain name
-     * @param description - Chain description
-     * @param metadata - Optional metadata
-     * @returns The created ActionChain object
-     *
-     * @example
-     * ```typescript
-     * const chain = logger.startActionChain(
-     *   'Implement Login Feature',
-     *   'All actions related to adding user authentication'
-     * );
-     * ```
-     */
-    startActionChain(name: string, description: string, metadata?: Record<string, any>): ActionChain;
-    /**
-     * Ends the current action chain.
-     *
-     * @param chainId - ID of the chain to end
-     * @param status - Final status of the chain
-     */
-    endActionChain(chainId: string, status?: 'completed' | 'failed' | 'cancelled'): void;
-    /**
-     * Updates the status of an action.
-     *
-     * @param actionId - ID of the action to update
-     * @param status - New status
-     */
-    updateActionStatus(actionId: string, status: ActionStatus): void;
-    /**
-     * Records approval decision for an action.
-     *
-     * @param actionId - ID of the action
-     * @param granted - Whether approval was granted
-     * @param decidedBy - User who made the decision
-     * @param rejectionReason - Reason if rejected
-     */
-    recordApproval(actionId: string, granted: boolean, decidedBy?: string, rejectionReason?: string): void;
-    /**
-     * Records the result of action execution.
-     *
-     * @param actionId - ID of the action
-     * @param result - Action result
-     */
-    recordResult(actionId: string, result: ActionResult): void;
-    /**
-     * Links two actions as related.
-     *
-     * @param actionId - ID of the first action
-     * @param relatedActionId - ID of the related action
-     */
-    linkActions(actionId: string, relatedActionId: string): void;
-    /**
-     * Gets an action by ID.
-     *
-     * @param actionId - ID of the action
-     * @returns The Action object or undefined
-     */
-    getAction(actionId: string): Action | undefined;
-    /**
-     * Gets an action chain by ID.
-     *
-     * @param chainId - ID of the chain
-     * @returns The ActionChain object or undefined
-     */
-    getActionChain(chainId: string): ActionChain | undefined;
-    /**
-     * Gets all actions.
-     *
-     * @returns Array of all Action objects
-     */
-    getAllActions(): Action[];
-    /**
-     * Gets all action chains.
-     *
-     * @returns Array of all ActionChain objects
-     */
-    getAllChains(): ActionChain[];
-    /**
-     * Gets actions by status.
-     *
-     * @param status - Status to filter by
-     * @returns Array of matching Action objects
-     */
-    getActionsByStatus(status: ActionStatus): Action[];
-    /**
-     * Gets actions by type.
-     *
-     * @param type - Type to filter by
-     * @returns Array of matching Action objects
-     */
-    getActionsByType(type: ActionType): Action[];
-    /**
-     * Gets actions pending approval.
-     *
-     * @returns Array of Action objects awaiting approval
-     */
-    getPendingApprovals(): Action[];
-    /**
-     * Gets the current active action chain.
-     *
-     * @returns The current ActionChain or null
-     */
-    getCurrentChain(): ActionChain | null;
-    /**
-     * Generates statistics about logged actions.
-     *
-     * @returns ActionStatistics object
-     */
-    getStatistics(): ActionStatistics;
-    /**
-     * Persists action log to disk.
-     *
-     * @param projectRoot - Optional project root path
-     */
-    persist(projectRoot?: string): Promise<void>;
-    /**
-     * Loads action log from disk.
-     *
-     * @param projectRoot - Optional project root path
-     * @returns True if log was loaded successfully
-     */
-    load(projectRoot?: string): Promise<boolean>;
-    /**
-     * Clears all actions and chains.
-     */
-    clear(): void;
-    /**
-     * Exports action log data.
-     *
-     * @returns Object containing all actions and chains
-     */
-    export(): {
-        actions: Action[];
-        chains: ActionChain[];
-    };
-    /**
-     * Sets the project root path.
-     *
-     * @param projectRoot - New project root path
-     */
-    setProjectRoot(projectRoot: string): void;
-}
-/**
- * Gets the singleton ActionLogger instance.
- *
- * @returns The ActionLogger instance
- *
- * @example
- * ```typescript
- * const logger = getActionLogger();
- * const action = logger.recordAction(
- *   ActionType.FILE_WRITE,
- *   'Create new component',
- *   { filePath: 'src/components/Button.tsx' }
- * );
- * ```
- */
-export declare function getActionLogger(): ActionLogger;
-/**
- * Creates a new ActionLogger instance.
- *
- * @returns A new ActionLogger instance
- */
-export declare function createActionLogger(): ActionLogger;
-export { ActionLogger };
-//# sourceMappingURL=action-logger.d.ts.map

package/dist/services/action-logger.d.ts.map

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