@compass-ai/nova 1.0.73 → 1.0.74

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

@@ -0,0 +1,383 @@
+/**
+ * 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

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