@windagency/valora 2.0.1

package/dist/cli/command-error-handler.js

@@ -0,0 +1,239 @@
+/**
+ * Command Error Handler - Handles error processing and recovery for command execution
+ */
+import { getColorAdapter } from '../output/color-adapter.interface.js';
+import { getConsoleOutput } from '../output/console-output.js';
+import { getHeaderFormatter } from '../output/header-formatter.js';
+import { getLogger } from '../output/logger.js';
+import { getProgress } from '../output/progress.js';
+import { getEnvironmentSummary, isSandboxedEnvironment } from '../utils/environment.js';
+import { BaseError, createErrorContext, ExecutionError, safeAsync } from '../utils/error-handler.js';
+import { getErrorMessage, hasErrorMessage } from '../utils/error-messages.js';
+export class CommandErrorHandler {
+    color = getColorAdapter();
+    console = getConsoleOutput();
+    logger = getLogger();
+    progress = getProgress();
+    /**
+     * Handle command execution error with comprehensive error handling
+     */
+    async handleExecutionError(error, context) {
+        const errorContext = createErrorContext('command-executor', 'execute', {
+            command: context.commandName,
+            duration: context.duration,
+            sandboxed: isSandboxedEnvironment(),
+            sessionId: context.sessionId,
+            ...getEnvironmentSummary()
+        });
+        this.logger.error('Command execution failed', error, errorContext);
+        this.progress.fail(`Command failed: ${context.commandName}`);
+        // Display appropriate error message
+        this.displayError(error, context);
+        // Handle session cleanup
+        await this.handleSessionCleanup(error, context);
+        // Re-throw with enhanced context if needed
+        if (!(error instanceof ExecutionError)) {
+            throw new ExecutionError(`Command execution failed: ${context.commandName}`, {
+                commandName: context.commandName,
+                originalError: error.message
+            }, errorContext);
+        }
+        throw error;
+    }
+    /**
+     * Display appropriate error message based on environment
+     */
+    displayError(error, _context) {
+        // Check if this is a BaseError with user-friendly information
+        if (this.shouldDisplayFriendlyError(error)) {
+            this.displayFriendlyError(error);
+            return;
+        }
+        // Check for error template by code
+        if (this.shouldDisplayTemplatedError(error)) {
+            this.displayTemplatedError(error);
+            return;
+        }
+        // Fallback to legacy error display
+        this.displayLegacyError(error.message);
+    }
+    /**
+     * Check if error should use friendly display
+     */
+    shouldDisplayFriendlyError(error) {
+        return (error instanceof BaseError &&
+            (Boolean(error.userMessage) || (error.fixSuggestions?.length ?? 0) > 0 || hasErrorMessage(error.code)));
+    }
+    /**
+     * Check if error should use templated display
+     */
+    shouldDisplayTemplatedError(error) {
+        return error instanceof BaseError && hasErrorMessage(error.code);
+    }
+    /**
+     * Display legacy error format based on environment
+     */
+    displayLegacyError(errorMessage) {
+        if (isSandboxedEnvironment() && this.isSandboxRelatedError(errorMessage)) {
+            this.displaySandboxedError(errorMessage);
+        }
+        else {
+            this.displayGeneralError(errorMessage);
+        }
+    }
+    /**
+     * Check if error is sandbox-related
+     */
+    isSandboxRelatedError(errorMessage) {
+        return (errorMessage.includes('network') || errorMessage.includes('API key') || errorMessage.includes('LLM operations'));
+    }
+    /**
+     * Display friendly error with user message and fix suggestions
+     */
+    displayFriendlyError(error) {
+        const isVerbose = process.env['AI_VERBOSE'] === 'true';
+        const title = error.userMessage ?? error.message;
+        const message = error.message;
+        // Display error box
+        this.displayErrorBox(title);
+        // Display explanation
+        if (error.userMessage && error.userMessage !== message) {
+            this.console.print(this.color.gray(`  ${message}`));
+            this.console.blank();
+        }
+        // Display fix suggestions
+        if (error.fixSuggestions && error.fixSuggestions.length > 0) {
+            this.console.print(this.color.getRawFn('cyan.bold')('  🔧 HOW TO FIX'));
+            this.console.blank();
+            error.fixSuggestions.forEach((fix, index) => {
+                this.console.print(this.color.gray(`  ${index + 1}. ${fix}`));
+            });
+            this.console.blank();
+        }
+        // Display docs link
+        if (error.docsLink) {
+            this.console.print(this.color.gray(`  📚 Learn more: ${error.docsLink}`));
+            this.console.blank();
+        }
+        // Display technical details in verbose mode
+        if (isVerbose) {
+            this.displayTechnicalDetails(error);
+        }
+        else {
+            this.console.print(this.color.gray('  💡 TIP: Run with --verbose for technical details'));
+            this.console.blank();
+        }
+    }
+    /**
+     * Display error using template
+     */
+    displayTemplatedError(error) {
+        const template = getErrorMessage(error.code);
+        if (!template) {
+            this.displayGeneralError(error.message);
+            return;
+        }
+        const isVerbose = process.env['AI_VERBOSE'] === 'true';
+        // Display error box
+        this.displayErrorBox(template.title);
+        // Display message
+        this.console.print(this.color.gray(`  ${template.message}`));
+        this.console.blank();
+        // Display fix suggestions
+        if (template.fixes.length > 0) {
+            this.console.print(this.color.getRawFn('cyan.bold')('  🔧 HOW TO FIX'));
+            this.console.blank();
+            template.fixes.forEach((fix, index) => {
+                this.console.print(this.color.gray(`  ${index + 1}. ${fix}`));
+            });
+            this.console.blank();
+        }
+        // Display docs link
+        if (template.docsLink) {
+            this.console.print(this.color.gray(`  📚 Learn more: ${template.docsLink}`));
+            this.console.blank();
+        }
+        // Display technical details in verbose mode
+        if (isVerbose) {
+            this.displayTechnicalDetails(error);
+        }
+        else {
+            this.console.print(this.color.gray('  💡 TIP: Run with --verbose for technical details'));
+            this.console.blank();
+        }
+        // Issue reporting link
+        this.console.print(this.color.gray('  🐛 Report issue: https://github.com/valora/issues/new'));
+        this.console.blank();
+    }
+    /**
+     * Display error box with title
+     */
+    displayErrorBox(title) {
+        const headerFormatter = getHeaderFormatter();
+        const errorHeader = headerFormatter.formatHeader(`❌ ${title}`, { color: 'red', minWidth: 58 });
+        this.console.print(errorHeader);
+    }
+    /**
+     * Display technical details for debugging
+     */
+    displayTechnicalDetails(error) {
+        this.console.print(this.color.yellow('  ───────────────────────────────────────────────────────'));
+        this.console.blank();
+        this.console.print(this.color.yellow('  Technical details (for debugging):'));
+        this.console.blank();
+        this.console.print(this.color.gray(`  Error: ${error.name}: ${error.message}`));
+        this.console.print(this.color.gray(`  Code: ${error.code}`));
+        if (error.context) {
+            this.console.print(this.color.gray(`  Component: ${error.context.component}`));
+            this.console.print(this.color.gray(`  Operation: ${error.context.operation}`));
+        }
+        if (error.stack) {
+            this.console.blank();
+            this.console.print(this.color.gray('  Stack trace:'));
+            const stackLines = error.stack.split('\n').slice(1, 6); // Show first 5 lines
+            stackLines.forEach((line) => {
+                this.console.print(this.color.gray(`  ${line.trim()}`));
+            });
+        }
+        this.console.blank();
+    }
+    /**
+     * Display sandboxed environment specific error
+     */
+    displaySandboxedError(errorMessage) {
+        this.console.blank();
+        this.console.error('Command failed in sandboxed environment');
+        this.console.print(`Error: ${errorMessage}`);
+        this.console.blank();
+        this.console.print('💡 Sandboxed Environment Notes:');
+        this.console.list([
+            'File system access is restricted (logs/sessions may not persist)',
+            'Network access may be blocked (API calls may fail)',
+            'Configure API keys for full LLM functionality',
+            'Some commands may work with local processing only'
+        ]);
+        this.console.blank();
+    }
+    /**
+     * Display general error message
+     */
+    displayGeneralError(errorMessage) {
+        this.console.blank();
+        this.console.error(errorMessage);
+        this.console.blank();
+    }
+    /**
+     * Handle session cleanup on error
+     */
+    async handleSessionCleanup(error, context) {
+        await safeAsync(async () => {
+            if (context.sessionLifecycle.hasActiveSession()) {
+                await context.sessionLifecycle.fail(error.message);
+            }
+        }, undefined, createErrorContext('command-error-handler', 'session-cleanup', {
+            commandName: context.commandName,
+            sessionId: context.sessionId
+        }));
+    }
+}
+//# sourceMappingURL=command-error-handler.js.map

package/dist/cli/command-error-handler.js.map

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

package/dist/cli/command-executor.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Command executor - orchestrates command execution
+ * Refactored to use smaller, focused classes for better maintainability
+ */
+import type { Logger } from '../output/logger.js';
+import type { CommandResult, IsolatedExecutionOptions } from '../types/command.types.js';
+import type { DocumentOutputOptions } from '../types/document.types.js';
+import type { MCPSamplingService } from '../types/mcp.types.js';
+import { AgentLoader } from '../executor/agent-loader.js';
+import { CommandIsolationExecutor } from '../executor/command-isolation.executor.js';
+import { CommandLoader } from '../executor/command-loader.js';
+import { PipelineExecutor } from '../executor/pipeline.js';
+import { PromptLoader } from '../executor/prompt-loader.js';
+import { AgentSelectionAnalyticsService, type DynamicAgentResolverService } from '../services/index.js';
+import { SessionLifecycle } from '../session/lifecycle.js';
+import { DocumentOutputProcessor } from './document-output-processor.js';
+import { CLIProviderResolver } from './provider-resolver.js';
+import { CLISessionManager } from './session-manager.js';
+export interface CommandExecutionOptions {
+    args: string[];
+    documentOutput?: DocumentOutputOptions;
+    flags: Record<string, boolean | string | undefined>;
+    interactive?: boolean;
+    isolation?: IsolatedExecutionOptions;
+    sessionId?: string;
+}
+/**
+ * Dependencies required by CommandExecutor
+ */
+export interface CommandExecutorDependencies {
+    agentLoader: AgentLoader;
+    analyticsService?: AgentSelectionAnalyticsService;
+    commandLoader: CommandLoader;
+    documentOutputProcessor?: DocumentOutputProcessor;
+    dynamicAgentResolver?: DynamicAgentResolverService;
+    isolationExecutor: CommandIsolationExecutor;
+    logger: Logger;
+    mcpSampling?: MCPSamplingService;
+    pipelineExecutor: PipelineExecutor;
+    promptLoader: PromptLoader;
+    providerResolver: CLIProviderResolver;
+    sessionLifecycle: SessionLifecycle;
+    sessionManager: CLISessionManager;
+}
+export declare class CommandExecutor {
+    private agentLoader;
+    private commandLoader;
+    private promptLoader;
+    private analyticsService?;
+    private dynamicAgentResolver?;
+    private pipelineExecutor;
+    private isolationExecutor;
+    private logger;
+    private mcpSampling?;
+    private providerResolver;
+    private sessionLifecycle;
+    private sessionManager;
+    private commandResolver;
+    private commandValidator;
+    private documentOutputProcessor;
+    private errorHandler;
+    private executionCoordinator;
+    private resultPresenter;
+    /**
+     * Creates a CommandExecutor instance
+     *
+     * @param dependencies - Injected dependencies or optional MCP sampling service for backwards compatibility
+     */
+    constructor(dependencies: CommandExecutorDependencies | MCPSamplingService);
+    /**
+     * Initialize dependencies with default implementations (backwards compatibility)
+     */
+    private initializeDependencies;
+    /**
+     * Initialize focused service classes (synchronous, analytics deferred)
+     */
+    private initializeServices;
+    /**
+     * Ensure analytics service is initialized (called on first execution)
+     */
+    private ensureAnalyticsInitialized;
+    /**
+     * Check if MCP sampling is available
+     */
+    hasMCPSampling(): boolean;
+    /**
+     * Execute a command using focused service classes
+     */
+    execute(commandName: string, options: CommandExecutionOptions): Promise<CommandResult>;
+    /**
+     * Setup stash protection if enabled for this command
+     */
+    private setupStashProtection;
+    /**
+     * Restore stashed changes after successful execution
+     */
+    private restoreStashProtection;
+    /**
+     * Restore stashed changes on error (with error handling)
+     */
+    private restoreStashOnError;
+    /**
+     * Calculate detailed token usage breakdown from command result
+     */
+    private calculateTokenUsage;
+    /**
+     * List available commands
+     */
+    listCommands(): Promise<string[]>;
+    /**
+     * Validate command prerequisites (command existence and file arguments)
+     */
+    private validatePrerequisites;
+    /**
+     * Handle successful command result (display and document processing)
+     */
+    private handleSuccessfulResult;
+    /**
+     * Process document output and update session lifecycle
+     */
+    private processDocumentOutput;
+    /**
+     * Handle failed command result (display and lifecycle)
+     */
+    private handleFailedResult;
+    /**
+     * Update session state after execution (history, context, caches)
+     */
+    private updateSessionState;
+    /**
+     * Save loaded prompts and agents to session context for faster resume
+     * Called after successful command execution
+     */
+    private saveLoaderCachesToSession;
+    /**
+     * Restore cached prompts and agents from session context
+     * Called when resuming a session with --session-id
+     */
+    private restoreLoaderCachesFromSession;
+    /**
+     * Save stage outputs to session context for reuse in subsequent commands
+     * Allows commands in the same session to reference previous stage outputs
+     */
+    private saveStageOutputsToSession;
+}
+//# sourceMappingURL=command-executor.d.ts.map

package/dist/cli/command-executor.d.ts.map

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