byterover-cli 1.8.0 → 2.0.0

package/dist/agent/infra/llm/openrouter-llm-service.d.ts

@@ -1,215 +0,0 @@
-import type { ToolSet } from '../../core/domain/tools/types.js';
-import type { ExecutionContext } from '../../core/interfaces/i-cipher-agent.js';
-import type { IHistoryStorage } from '../../core/interfaces/i-history-storage.js';
-import type { ILLMService } from '../../core/interfaces/i-llm-service.js';
-import type { ILogger } from '../../core/interfaces/i-logger.js';
-import type { MemoryManager } from '../memory/memory-manager.js';
-import type { SystemPromptManager } from '../system-prompt/system-prompt-manager.js';
-import type { ToolManager } from '../tools/tool-manager.js';
-import { SessionEventBus } from '../events/event-emitter.js';
-import { ContextManager, type FileData, type ImageData } from './context/context-manager.js';
-/**
- * Configuration for OpenRouter LLM service
- */
-export interface OpenRouterServiceConfig {
-    apiKey: string;
-    baseUrl?: string;
-    httpReferer?: string;
-    maxInputTokens?: number;
-    maxIterations?: number;
-    maxTokens?: number;
-    model?: string;
-    siteName?: string;
-    temperature?: number;
-    timeout?: number;
-    verbose?: boolean;
-}
-/**
- * LLM service configuration response
- */
-export interface LLMServiceConfig {
-    configuredMaxInputTokens: number;
-    model: string;
-    modelMaxInputTokens: number;
-    provider: string;
-    router: string;
-}
-/**
- * OpenRouter LLM Service.
- *
- * Orchestrates the agentic loop for tool calling with OpenRouter.
- * OpenRouter provides access to multiple LLM providers through an OpenAI-compatible API.
- *
- * Responsibilities:
- * - Manage conversation context via ContextManager
- * - Execute agentic loop (call LLM → execute tools → repeat)
- * - Delegate tool execution to ToolManager
- * - Format messages for OpenRouter API via formatter
- * - Handle errors and iteration limits
- *
- * Does NOT:
- * - Execute tools directly (uses ToolManager)
- * - Store persistent history (uses in-memory ContextManager)
- */
-export declare class OpenRouterLLMService implements ILLMService {
-    private readonly client;
-    private readonly config;
-    private readonly contentGenerator;
-    private readonly contextManager;
-    private readonly formatter;
-    private readonly logger;
-    private readonly memoryManager?;
-    private readonly sessionEventBus;
-    private readonly sessionId;
-    private readonly streamProcessor;
-    private readonly systemPromptManager;
-    private readonly tokenizer;
-    private readonly toolManager;
-    /**
-     * Creates a new OpenRouter LLM service
-     *
-     * @param sessionId - Unique session identifier
-     * @param config - Service configuration
-     * @param options - Service dependencies
-     * @param options.toolManager - Tool manager for tool execution
-     * @param options.systemPromptManager - Simple prompt factory for building system prompts
-     * @param options.sessionEventBus - Session event bus for emitting events
-     * @param options.memoryManager - Optional memory manager for agent memories
-     * @param options.historyStorage - Optional history storage for persistence
-     * @param options.logger - Optional logger for structured logging
-     */
-    constructor(sessionId: string, config: OpenRouterServiceConfig, options: {
-        historyStorage?: IHistoryStorage;
-        logger?: ILogger;
-        memoryManager?: MemoryManager;
-        sessionEventBus: SessionEventBus;
-        systemPromptManager: SystemPromptManager;
-        toolManager: ToolManager;
-    });
-    /**
-     * Complete a task with tool calling support.
-     *
-     * This is the main entry point for the agentic loop.
-     * It handles:
-     * 1. Adding user message to context
-     * 2. Looping: call LLM → check for tool calls → execute tools
-     * 3. Returning final response when no more tool calls
-     *
-     * @param textInput - User input text
-     * @param options - Execution options
-     * @param options.signal - Optional abort signal for cancellation
-     * @param options.imageData - Optional image data
-     * @param options.fileData - Optional file data
-     * @param options.stream - Whether to stream response (emits llmservice:chunk events)
-     * @param options.executionContext - Optional execution context (for JSON input mode, etc.)
-     * @param options.taskId - Task ID for billing tracking
-     * @returns Final assistant response
-     */
-    completeTask(textInput: string, options?: {
-        executionContext?: ExecutionContext;
-        fileData?: FileData;
-        imageData?: ImageData;
-        signal?: AbortSignal;
-        stream?: boolean;
-        taskId?: string;
-    }): Promise<string>;
-    /**
-     * Get all available tools from ToolManager.
-     */
-    getAllTools(): Promise<ToolSet>;
-    /**
-     * Get service configuration.
-     */
-    getConfig(): LLMServiceConfig;
-    /**
-     * Get the context manager instance.
-     */
-    getContextManager(): ContextManager<unknown>;
-    /**
-     * Initialize the LLM service by loading persisted history.
-     * Should be called after construction to restore previous conversation.
-     *
-     * @returns True if history was loaded, false otherwise
-     */
-    initialize(): Promise<boolean>;
-    /**
-     * Call LLM and parse the response.
-     *
-     * @param tools - Available tools for function calling
-     * @param formattedMessages - Formatted messages to send
-     * @returns Parsed message from LLM response
-     */
-    private callLLMAndParseResponse;
-    /**
-     * Complete a task using streaming mode.
-     *
-     * Emits real-time llmservice:chunk events as tokens arrive.
-     * Follows the OpenCode pattern of delta-based streaming.
-     *
-     * @param toolSet - Available tools for the task
-     * @param executionContext - Optional execution context
-     * @param signal - Optional abort signal for cancellation
-     * @param taskId - Optional task ID for concurrent task isolation
-     * @returns Final accumulated response
-     */
-    private completeTaskStreaming;
-    /**
-     * Execute a single iteration of the agentic loop.
-     *
-     * @param iterationCount - Current iteration number
-     * @param tools - Available tools for this iteration
-     * @param executionContext - Optional execution context
-     * @param taskId - Optional task ID for concurrent task isolation
-     * @returns Final response string if complete, null if more iterations needed
-     */
-    private executeAgenticIteration;
-    /**
-     * Execute a single iteration of the agentic loop with streaming.
-     *
-     * This method uses the ContentGenerator's streaming API to provide
-     * real-time token-by-token output via the SessionEventBus.
-     *
-     * @param iterationCount - Current iteration number
-     * @param toolSet - Available tools for this iteration
-     * @param executionContext - Optional execution context
-     * @param taskId - Optional task ID for concurrent task isolation
-     * @returns Object with response text and whether tool calls were made
-     */
-    private executeAgenticIterationStreaming;
-    /**
-     * Execute a single tool call.
-     *
-     * @param toolCall - Tool call to execute
-     * @param taskId - Optional task ID for concurrent task isolation
-     */
-    private executeToolCall;
-    /**
-     * Extract text content from an internal message.
-     *
-     * @param message - Internal message
-     * @returns Text content as string
-     */
-    private extractTextContent;
-    /**
-     * Handle final response when there are no tool calls.
-     *
-     * @param lastMessage - Last message from LLM
-     * @param taskId - Optional task ID for concurrent task isolation
-     * @returns Final response content
-     */
-    private handleFinalResponse;
-    /**
-     * Handle LLM errors and re-throw or wrap appropriately.
-     *
-     * @param error - Error to handle
-     * @param taskId - Optional task ID for concurrent task isolation
-     */
-    private handleLLMError;
-    /**
-     * Handle tool calls from LLM response.
-     *
-     * @param lastMessage - Last message containing tool calls
-     * @param taskId - Optional task ID for concurrent task isolation
-     */
-    private handleToolCalls;
-}