codeseeker 1.4.0

package/dist/cli/services/llm/interfaces/index.d.ts

@@ -0,0 +1,211 @@
+/**
+ * LLM Executor Interfaces
+ *
+ * SOLID Principles:
+ * - Interface Segregation: Focused interfaces for LLM execution
+ * - Dependency Inversion: Business logic depends on abstractions, not concrete LLM implementations
+ *
+ * This allows:
+ * 1. Swapping LLM providers (Claude, OpenAI, Ollama, etc.) without changing business logic
+ * 2. Mock implementations for fast CI testing
+ * 3. Clean separation between workflow logic and LLM execution
+ */
+/**
+ * Options for LLM execution
+ */
+export interface LLMExecutionOptions {
+    /** Working directory for file operations */
+    projectPath?: string;
+    /** Maximum tokens to generate */
+    maxTokens?: number;
+    /** Output format preference */
+    outputFormat?: 'text' | 'json';
+    /** Model to use (provider-specific) */
+    model?: string;
+    /** System prompt to prepend */
+    systemPrompt?: string;
+    /** Execution timeout in milliseconds */
+    timeout?: number;
+    /** Temperature for response randomness (0-1) */
+    temperature?: number;
+    /** Additional provider-specific options */
+    providerOptions?: Record<string, unknown>;
+}
+/**
+ * Result from LLM execution
+ */
+export interface LLMExecutionResult {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Response data (text or parsed JSON) */
+    data?: string | Record<string, unknown>;
+    /** Error message if failed */
+    error?: string;
+    /** Estimated tokens used */
+    tokensUsed?: number;
+    /** Execution time in milliseconds */
+    executionTimeMs?: number;
+    /** Provider-specific metadata */
+    metadata?: {
+        provider: string;
+        model?: string;
+        finishReason?: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Information about an LLM provider
+ */
+export interface LLMProviderInfo {
+    /** Provider identifier (e.g., 'claude', 'openai', 'ollama') */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Provider version */
+    version?: string;
+    /** Available models */
+    availableModels?: string[];
+    /** Maximum context window */
+    maxContextTokens?: number;
+    /** Whether provider is currently available */
+    isAvailable: boolean;
+}
+/**
+ * Core interface for LLM execution
+ *
+ * All LLM providers (Claude, OpenAI, Mock, etc.) must implement this interface.
+ * This enables:
+ * - Provider-agnostic workflow logic
+ * - Easy testing with mock implementations
+ * - Runtime provider switching
+ */
+export interface ILLMExecutor {
+    /**
+     * Execute a prompt and get a response
+     * @param prompt The user's prompt
+     * @param context Additional context to include
+     * @param options Execution options
+     */
+    execute(prompt: string, context?: string, options?: LLMExecutionOptions): Promise<LLMExecutionResult>;
+    /**
+     * Get information about this LLM provider
+     */
+    getProviderInfo(): LLMProviderInfo;
+    /**
+     * Test connection to the LLM provider
+     */
+    testConnection(): Promise<{
+        connected: boolean;
+        error?: string;
+    }>;
+    /**
+     * Estimate tokens for a given text
+     * @param text Text to estimate tokens for
+     */
+    estimateTokens(text: string): number;
+    /**
+     * Check if a prompt is within size limits
+     * @param prompt Prompt to validate
+     */
+    validatePromptSize(prompt: string): {
+        valid: boolean;
+        size: number;
+        maxSize: number;
+        warning?: string;
+    };
+}
+/**
+ * Interface for LLM executors that support streaming
+ */
+export interface IStreamingLLMExecutor extends ILLMExecutor {
+    /**
+     * Execute with streaming response
+     */
+    executeStream(prompt: string, context?: string, options?: LLMExecutionOptions): AsyncIterable<string>;
+}
+/**
+ * Interface for LLM executors that support conversation history
+ */
+export interface IConversationalLLMExecutor extends ILLMExecutor {
+    /**
+     * Execute with conversation history
+     */
+    executeWithHistory(prompt: string, history: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>, context?: string, options?: LLMExecutionOptions): Promise<LLMExecutionResult>;
+    /**
+     * Clear conversation history for a session
+     */
+    clearHistory(sessionId: string): void;
+}
+/**
+ * Interface for LLM executors that support tool/function calling
+ */
+export interface IToolCallingLLMExecutor extends ILLMExecutor {
+    /**
+     * Execute with tool definitions
+     */
+    executeWithTools(prompt: string, tools: Array<{
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }>, context?: string, options?: LLMExecutionOptions): Promise<LLMExecutionResult & {
+        toolCalls?: Array<{
+            name: string;
+            arguments: Record<string, unknown>;
+        }>;
+    }>;
+}
+/**
+ * Factory for creating LLM executors
+ */
+export interface ILLMExecutorFactory {
+    /**
+     * Create an LLM executor for the specified provider
+     * @param providerId Provider identifier
+     * @param config Provider-specific configuration
+     */
+    create(providerId: string, config?: Record<string, unknown>): ILLMExecutor;
+    /**
+     * Get available provider IDs
+     */
+    getAvailableProviders(): string[];
+    /**
+     * Check if a provider is available
+     */
+    isProviderAvailable(providerId: string): Promise<boolean>;
+}
+/**
+ * Configuration for mock LLM responses
+ */
+export interface MockLLMResponse {
+    /** Pattern to match in prompt (string or regex) */
+    pattern: string | RegExp;
+    /** Response to return when pattern matches */
+    response: string | Record<string, unknown>;
+    /** Optional delay to simulate network latency */
+    delayMs?: number;
+    /** Optional token count to report */
+    tokensUsed?: number;
+    /** Whether this response should simulate an error */
+    simulateError?: boolean;
+    /** Error message if simulateError is true */
+    errorMessage?: string;
+}
+/**
+ * Options for mock LLM executor
+ */
+export interface MockLLMOptions {
+    /** Predefined responses */
+    responses?: MockLLMResponse[];
+    /** Default response when no pattern matches */
+    defaultResponse?: string;
+    /** Default delay for all responses */
+    defaultDelayMs?: number;
+    /** Whether to log mock operations */
+    verbose?: boolean;
+    /** Simulate intermittent failures */
+    failureRate?: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/services/llm/interfaces/index.d.ts.map

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

package/dist/cli/services/llm/interfaces/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * LLM Executor Interfaces
+ *
+ * SOLID Principles:
+ * - Interface Segregation: Focused interfaces for LLM execution
+ * - Dependency Inversion: Business logic depends on abstractions, not concrete LLM implementations
+ *
+ * This allows:
+ * 1. Swapping LLM providers (Claude, OpenAI, Ollama, etc.) without changing business logic
+ * 2. Mock implementations for fast CI testing
+ * 3. Clean separation between workflow logic and LLM execution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/cli/services/llm/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/cli/services/llm/interfaces/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}

package/dist/cli/services/llm/llm-executor-registry.d.ts

@@ -0,0 +1,118 @@
+/**
+ * LLM Executor Registry
+ *
+ * Central registry for LLM executors following the Service Locator pattern.
+ * Provides:
+ * - Runtime provider switching
+ * - Global mock injection for testing
+ * - Factory methods for common use cases
+ *
+ * SOLID Principles:
+ * - Single Responsibility: Manages LLM executor lifecycle only
+ * - Open/Closed: New providers can be added without modifying existing code
+ * - Dependency Inversion: Clients depend on ILLMExecutor, not concrete implementations
+ */
+import { ILLMExecutor, ILLMExecutorFactory, LLMProviderInfo } from './interfaces';
+import { MockLLMExecutor } from './mock-llm-executor';
+/**
+ * Global LLM Executor Registry
+ * Singleton pattern for application-wide LLM executor management
+ */
+export declare class LLMExecutorRegistry implements ILLMExecutorFactory {
+    private static instance;
+    private executors;
+    private defaultProviderId;
+    private overrideExecutor;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): LLMExecutorRegistry;
+    /**
+     * Reset the singleton (useful for testing)
+     */
+    static reset(): void;
+    /**
+     * Create/get an LLM executor for the specified provider
+     */
+    create(providerId: string, _config?: Record<string, unknown>): ILLMExecutor;
+    /**
+     * Get available provider IDs
+     */
+    getAvailableProviders(): string[];
+    /**
+     * Check if a provider is available
+     */
+    isProviderAvailable(providerId: string): Promise<boolean>;
+    /**
+     * Register a new LLM executor
+     */
+    registerExecutor(providerId: string, executor: ILLMExecutor): void;
+    /**
+     * Unregister an LLM executor
+     */
+    unregisterExecutor(providerId: string): boolean;
+    /**
+     * Set the default provider
+     */
+    setDefaultProvider(providerId: string): void;
+    /**
+     * Get the default provider ID
+     */
+    getDefaultProviderId(): string;
+    /**
+     * Get the current LLM executor
+     * Returns override executor if set, otherwise the default
+     */
+    getExecutor(providerId?: string): ILLMExecutor;
+    /**
+     * Get provider information for all registered executors
+     */
+    getAllProviderInfo(): LLMProviderInfo[];
+    /**
+     * Override the executor globally (for testing)
+     * All calls to getExecutor() will return this executor
+     */
+    setOverride(executor: ILLMExecutor | null): void;
+    /**
+     * Clear the global override
+     */
+    clearOverride(): void;
+    /**
+     * Check if an override is currently set
+     */
+    hasOverride(): boolean;
+    /**
+     * Enable mock mode for testing
+     * This sets a mock executor as the global override
+     */
+    enableMockMode(mockExecutor?: MockLLMExecutor): MockLLMExecutor;
+    /**
+     * Disable mock mode
+     */
+    disableMockMode(): void;
+    /**
+     * Run a function with mock mode enabled, then restore
+     */
+    withMock<T>(fn: (mock: MockLLMExecutor) => Promise<T>, mockExecutor?: MockLLMExecutor): Promise<T>;
+}
+/**
+ * Get the global LLM executor (convenience function)
+ */
+export declare function getLLMExecutor(providerId?: string): ILLMExecutor;
+/**
+ * Enable mock mode globally (convenience function for tests)
+ */
+export declare function enableMockLLM(mockExecutor?: MockLLMExecutor): MockLLMExecutor;
+/**
+ * Disable mock mode globally (convenience function for tests)
+ */
+export declare function disableMockLLM(): void;
+/**
+ * Run code with mock LLM (convenience function for tests)
+ */
+export declare function withMockLLM<T>(fn: (mock: MockLLMExecutor) => Promise<T>, mockExecutor?: MockLLMExecutor): Promise<T>;
+export { ILLMExecutor, LLMExecutionOptions, LLMExecutionResult, LLMProviderInfo } from './interfaces';
+export { ClaudeLLMExecutor } from './claude-llm-executor';
+export { MockLLMExecutor, MockLLMExecutorFactory } from './mock-llm-executor';
+//# sourceMappingURL=llm-executor-registry.d.ts.map

package/dist/cli/services/llm/llm-executor-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-executor-registry.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/llm/llm-executor-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAElF,OAAO,EAAE,eAAe,EAA0B,MAAM,qBAAqB,CAAC;AAE9E;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,mBAAmB;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAE7C,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,gBAAgB,CAA6B;IAErD,OAAO;IAMP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,mBAAmB;IAOzC;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;IAQpB;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;IAQ3E;;OAEG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAIjC;;OAEG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB/D;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAIlE;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI/C;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAO5C;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAQ9B;;;OAGG;IACH,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY;IAiB9C;;OAEG;IACH,kBAAkB,IAAI,eAAe,EAAE;IAQvC;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI;IAIhD;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACH,cAAc,CAAC,YAAY,CAAC,EAAE,eAAe,GAAG,eAAe;IAM/D;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACG,QAAQ,CAAC,CAAC,EACd,EAAE,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,EACzC,YAAY,CAAC,EAAE,eAAe,GAC7B,OAAO,CAAC,CAAC,CAAC;CAQd;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,CAEhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,YAAY,CAAC,EAAE,eAAe,GAAG,eAAe,CAE7E;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,EACzC,YAAY,CAAC,EAAE,eAAe,GAC7B,OAAO,CAAC,CAAC,CAAC,CAEZ;AAOD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACtG,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/cli/services/llm/llm-executor-registry.js

@@ -0,0 +1,226 @@
+"use strict";
+/**
+ * LLM Executor Registry
+ *
+ * Central registry for LLM executors following the Service Locator pattern.
+ * Provides:
+ * - Runtime provider switching
+ * - Global mock injection for testing
+ * - Factory methods for common use cases
+ *
+ * SOLID Principles:
+ * - Single Responsibility: Manages LLM executor lifecycle only
+ * - Open/Closed: New providers can be added without modifying existing code
+ * - Dependency Inversion: Clients depend on ILLMExecutor, not concrete implementations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockLLMExecutorFactory = exports.MockLLMExecutor = exports.ClaudeLLMExecutor = exports.LLMExecutorRegistry = void 0;
+exports.getLLMExecutor = getLLMExecutor;
+exports.enableMockLLM = enableMockLLM;
+exports.disableMockLLM = disableMockLLM;
+exports.withMockLLM = withMockLLM;
+const claude_llm_executor_1 = require("./claude-llm-executor");
+const mock_llm_executor_1 = require("./mock-llm-executor");
+/**
+ * Global LLM Executor Registry
+ * Singleton pattern for application-wide LLM executor management
+ */
+class LLMExecutorRegistry {
+    static instance;
+    executors = new Map();
+    defaultProviderId = 'claude';
+    overrideExecutor = null;
+    constructor() {
+        // Register default executors
+        this.registerExecutor('claude', new claude_llm_executor_1.ClaudeLLMExecutor());
+        this.registerExecutor('mock', mock_llm_executor_1.MockLLMExecutorFactory.createDefault());
+    }
+    /**
+     * Get the singleton instance
+     */
+    static getInstance() {
+        if (!LLMExecutorRegistry.instance) {
+            LLMExecutorRegistry.instance = new LLMExecutorRegistry();
+        }
+        return LLMExecutorRegistry.instance;
+    }
+    /**
+     * Reset the singleton (useful for testing)
+     */
+    static reset() {
+        LLMExecutorRegistry.instance = new LLMExecutorRegistry();
+    }
+    // ============================================================================
+    // ILLMExecutorFactory Implementation
+    // ============================================================================
+    /**
+     * Create/get an LLM executor for the specified provider
+     */
+    create(providerId, _config) {
+        const executor = this.executors.get(providerId);
+        if (!executor) {
+            throw new Error(`Unknown LLM provider: ${providerId}. Available: ${this.getAvailableProviders().join(', ')}`);
+        }
+        return executor;
+    }
+    /**
+     * Get available provider IDs
+     */
+    getAvailableProviders() {
+        return Array.from(this.executors.keys());
+    }
+    /**
+     * Check if a provider is available
+     */
+    async isProviderAvailable(providerId) {
+        const executor = this.executors.get(providerId);
+        if (!executor)
+            return false;
+        try {
+            const result = await executor.testConnection();
+            return result.connected;
+        }
+        catch {
+            return false;
+        }
+    }
+    // ============================================================================
+    // Registry Management
+    // ============================================================================
+    /**
+     * Register a new LLM executor
+     */
+    registerExecutor(providerId, executor) {
+        this.executors.set(providerId, executor);
+    }
+    /**
+     * Unregister an LLM executor
+     */
+    unregisterExecutor(providerId) {
+        return this.executors.delete(providerId);
+    }
+    /**
+     * Set the default provider
+     */
+    setDefaultProvider(providerId) {
+        if (!this.executors.has(providerId)) {
+            throw new Error(`Cannot set default to unknown provider: ${providerId}`);
+        }
+        this.defaultProviderId = providerId;
+    }
+    /**
+     * Get the default provider ID
+     */
+    getDefaultProviderId() {
+        return this.defaultProviderId;
+    }
+    // ============================================================================
+    // Executor Access
+    // ============================================================================
+    /**
+     * Get the current LLM executor
+     * Returns override executor if set, otherwise the default
+     */
+    getExecutor(providerId) {
+        // If there's an override, always use it
+        if (this.overrideExecutor) {
+            return this.overrideExecutor;
+        }
+        // Otherwise use specified provider or default
+        const id = providerId || this.defaultProviderId;
+        const executor = this.executors.get(id);
+        if (!executor) {
+            throw new Error(`LLM executor not found: ${id}`);
+        }
+        return executor;
+    }
+    /**
+     * Get provider information for all registered executors
+     */
+    getAllProviderInfo() {
+        return Array.from(this.executors.values()).map(e => e.getProviderInfo());
+    }
+    // ============================================================================
+    // Testing Support
+    // ============================================================================
+    /**
+     * Override the executor globally (for testing)
+     * All calls to getExecutor() will return this executor
+     */
+    setOverride(executor) {
+        this.overrideExecutor = executor;
+    }
+    /**
+     * Clear the global override
+     */
+    clearOverride() {
+        this.overrideExecutor = null;
+    }
+    /**
+     * Check if an override is currently set
+     */
+    hasOverride() {
+        return this.overrideExecutor !== null;
+    }
+    /**
+     * Enable mock mode for testing
+     * This sets a mock executor as the global override
+     */
+    enableMockMode(mockExecutor) {
+        const mock = mockExecutor || mock_llm_executor_1.MockLLMExecutorFactory.createForCI();
+        this.setOverride(mock);
+        return mock;
+    }
+    /**
+     * Disable mock mode
+     */
+    disableMockMode() {
+        this.clearOverride();
+    }
+    /**
+     * Run a function with mock mode enabled, then restore
+     */
+    async withMock(fn, mockExecutor) {
+        const mock = this.enableMockMode(mockExecutor);
+        try {
+            return await fn(mock);
+        }
+        finally {
+            this.disableMockMode();
+        }
+    }
+}
+exports.LLMExecutorRegistry = LLMExecutorRegistry;
+// ============================================================================
+// Convenience Functions
+// ============================================================================
+/**
+ * Get the global LLM executor (convenience function)
+ */
+function getLLMExecutor(providerId) {
+    return LLMExecutorRegistry.getInstance().getExecutor(providerId);
+}
+/**
+ * Enable mock mode globally (convenience function for tests)
+ */
+function enableMockLLM(mockExecutor) {
+    return LLMExecutorRegistry.getInstance().enableMockMode(mockExecutor);
+}
+/**
+ * Disable mock mode globally (convenience function for tests)
+ */
+function disableMockLLM() {
+    LLMExecutorRegistry.getInstance().disableMockMode();
+}
+/**
+ * Run code with mock LLM (convenience function for tests)
+ */
+async function withMockLLM(fn, mockExecutor) {
+    return LLMExecutorRegistry.getInstance().withMock(fn, mockExecutor);
+}
+var claude_llm_executor_2 = require("./claude-llm-executor");
+Object.defineProperty(exports, "ClaudeLLMExecutor", { enumerable: true, get: function () { return claude_llm_executor_2.ClaudeLLMExecutor; } });
+var mock_llm_executor_2 = require("./mock-llm-executor");
+Object.defineProperty(exports, "MockLLMExecutor", { enumerable: true, get: function () { return mock_llm_executor_2.MockLLMExecutor; } });
+Object.defineProperty(exports, "MockLLMExecutorFactory", { enumerable: true, get: function () { return mock_llm_executor_2.MockLLMExecutorFactory; } });
+//# sourceMappingURL=llm-executor-registry.js.map

package/dist/cli/services/llm/llm-executor-registry.js.map

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