snow-ai 0.4.16 → 0.4.18

package/dist/api/chat.js

@@ -1,386 +0,0 @@
-import { getOpenAiConfig, getCustomSystemPrompt, getCustomHeaders, } from '../utils/apiConfig.js';
-import { getSystemPrompt } from './systemPrompt.js';
-import { withRetryGenerator, parseJsonWithFix } from '../utils/retryUtils.js';
-import { addProxyToFetchOptions } from '../utils/proxyUtils.js';
-import { saveUsageToFile } from '../utils/usageLogger.js';
-/**
- * Convert our ChatMessage format to OpenAI's ChatCompletionMessageParam format
- * Automatically prepends system prompt if not present
- * Logic:
- * 1. If custom system prompt exists: use custom as system, prepend default as first user message
- * 2. If no custom system prompt: use default as system
- * @param messages - The messages to convert
- * @param includeBuiltinSystemPrompt - Whether to include builtin system prompt (default true)
- */
-function convertToOpenAIMessages(messages, includeBuiltinSystemPrompt = true) {
-    const customSystemPrompt = getCustomSystemPrompt();
-    let result = messages.map(msg => {
-        // 如果消息包含图片，使用 content 数组格式
-        if (msg.role === 'user' && msg.images && msg.images.length > 0) {
-            const contentParts = [];
-            // 添加文本内容
-            if (msg.content) {
-                contentParts.push({
-                    type: 'text',
-                    text: msg.content,
-                });
-            }
-            // 添加图片内容
-            for (const image of msg.images) {
-                contentParts.push({
-                    type: 'image_url',
-                    image_url: {
-                        url: image.data, // Base64 data URL
-                    },
-                });
-            }
-            return {
-                role: 'user',
-                content: contentParts,
-            };
-        }
-        const baseMessage = {
-            role: msg.role,
-            content: msg.content,
-        };
-        if (msg.role === 'assistant' && msg.tool_calls) {
-            return {
-                ...baseMessage,
-                tool_calls: msg.tool_calls,
-            };
-        }
-        if (msg.role === 'tool' && msg.tool_call_id) {
-            // Handle multimodal tool results with images
-            if (msg.images && msg.images.length > 0) {
-                const content = [];
-                // Add text content
-                if (msg.content) {
-                    content.push({
-                        type: 'text',
-                        text: msg.content,
-                    });
-                }
-                // Add images as base64 data URLs
-                for (const image of msg.images) {
-                    content.push({
-                        type: 'image_url',
-                        image_url: {
-                            url: `data:${image.mimeType};base64,${image.data}`,
-                        },
-                    });
-                }
-                return {
-                    role: 'tool',
-                    content,
-                    tool_call_id: msg.tool_call_id,
-                };
-            }
-            return {
-                role: 'tool',
-                content: msg.content,
-                tool_call_id: msg.tool_call_id,
-            };
-        }
-        return baseMessage;
-    });
-    // 如果第一条消息已经是 system 消息，跳过
-    if (result.length > 0 && result[0]?.role === 'system') {
-        return result;
-    }
-    // 如果配置了自定义系统提示词（最高优先级，始终添加）
-    if (customSystemPrompt) {
-        if (includeBuiltinSystemPrompt) {
-            // 自定义系统提示词作为 system 消息，默认系统提示词作为第一条 user 消息
-            result = [
-                {
-                    role: 'system',
-                    content: customSystemPrompt,
-                },
-                {
-                    role: 'user',
-                    content: getSystemPrompt(),
-                },
-                ...result,
-            ];
-        }
-        else {
-            // 只添加自定义系统提示词
-            result = [
-                {
-                    role: 'system',
-                    content: customSystemPrompt,
-                },
-                ...result,
-            ];
-        }
-    }
-    else if (includeBuiltinSystemPrompt) {
-        // 没有自定义系统提示词，但需要添加默认系统提示词
-        result = [
-            {
-                role: 'system',
-                content: getSystemPrompt(),
-            },
-            ...result,
-        ];
-    }
-    return result;
-}
-let openaiConfig = null;
-function getOpenAIConfig() {
-    if (!openaiConfig) {
-        const config = getOpenAiConfig();
-        if (!config.apiKey || !config.baseUrl) {
-            throw new Error('OpenAI API configuration is incomplete. Please configure API settings first.');
-        }
-        const customHeaders = getCustomHeaders();
-        openaiConfig = {
-            apiKey: config.apiKey,
-            baseUrl: config.baseUrl,
-            customHeaders,
-        };
-    }
-    return openaiConfig;
-}
-export function resetOpenAIClient() {
-    openaiConfig = null;
-}
-/**
- * Parse Server-Sent Events (SSE) stream
- */
-async function* parseSSEStream(reader) {
-    const decoder = new TextDecoder();
-    let buffer = '';
-    try {
-        while (true) {
-            const { done, value } = await reader.read();
-            if (done) {
-                // ✅ 关键修复：检查buffer是否有残留数据
-                if (buffer.trim()) {
-                    // 连接异常中断，抛出明确错误
-                    throw new Error(`Stream terminated unexpectedly with incomplete data: ${buffer.substring(0, 100)}...`);
-                }
-                break; // 正常结束
-            }
-            buffer += decoder.decode(value, { stream: true });
-            const lines = buffer.split('\n');
-            buffer = lines.pop() || '';
-            for (const line of lines) {
-                const trimmed = line.trim();
-                if (!trimmed || trimmed.startsWith(':'))
-                    continue;
-                if (trimmed === 'data: [DONE]' || trimmed === 'data:[DONE]') {
-                    return;
-                }
-                // Handle both "event: " and "event:" formats
-                if (trimmed.startsWith('event:')) {
-                    // Event type, will be followed by data
-                    continue;
-                }
-                // Handle both "data: " and "data:" formats
-                if (trimmed.startsWith('data:')) {
-                    const data = trimmed.startsWith('data: ')
-                        ? trimmed.slice(6)
-                        : trimmed.slice(5);
-                    const parseResult = parseJsonWithFix(data, {
-                        toolName: 'SSE stream',
-                        logWarning: false,
-                        logError: true,
-                    });
-                    if (parseResult.success) {
-                        yield parseResult.data;
-                    }
-                }
-            }
-        }
-    }
-    catch (error) {
-        const { logger } = await import('../utils/logger.js');
-        logger.error('SSE stream parsing error:', {
-            error: error instanceof Error ? error.message : 'Unknown error',
-            remainingBuffer: buffer.substring(0, 200),
-        });
-        throw error;
-    }
-}
-/**
- * Simple streaming chat completion - only handles OpenAI interaction
- * Tool execution should be handled by the caller
- */
-export async function* createStreamingChatCompletion(options, abortSignal, onRetry) {
-    const config = getOpenAIConfig();
-    // 使用重试包装生成器
-    yield* withRetryGenerator(async function* () {
-        const requestBody = {
-            model: options.model,
-            messages: convertToOpenAIMessages(options.messages, options.includeBuiltinSystemPrompt !== false),
-            stream: true,
-            stream_options: { include_usage: true },
-            temperature: options.temperature || 0.7,
-            max_tokens: options.max_tokens,
-            tools: options.tools,
-            tool_choice: options.tool_choice,
-        };
-        const url = `${config.baseUrl}/chat/completions`;
-        const fetchOptions = addProxyToFetchOptions(url, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                Authorization: `Bearer ${config.apiKey}`,
-                'x-snow': 'true',
-                ...config.customHeaders,
-            },
-            body: JSON.stringify(requestBody),
-            signal: abortSignal,
-        });
-        const response = await fetch(url, fetchOptions);
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`OpenAI API error: ${response.status} ${response.statusText} - ${errorText}`);
-        }
-        if (!response.body) {
-            throw new Error('No response body from OpenAI API');
-        }
-        let contentBuffer = '';
-        let toolCallsBuffer = {};
-        let hasToolCalls = false;
-        let usageData;
-        let reasoningStarted = false; // Track if reasoning has started
-        for await (const chunk of parseSSEStream(response.body.getReader())) {
-            if (abortSignal?.aborted) {
-                return;
-            }
-            // Capture usage information if available (usually in the last chunk)
-            const usageValue = chunk.usage;
-            if (usageValue !== null && usageValue !== undefined) {
-                usageData = {
-                    prompt_tokens: usageValue.prompt_tokens || 0,
-                    completion_tokens: usageValue.completion_tokens || 0,
-                    total_tokens: usageValue.total_tokens || 0,
-                    // OpenAI Chat API: cached_tokens in prompt_tokens_details
-                    cached_tokens: usageValue.prompt_tokens_details?.cached_tokens,
-                };
-            }
-            // Skip content processing if no choices (but usage is already captured above)
-            const choice = chunk.choices[0];
-            if (!choice) {
-                continue;
-            }
-            // Stream content chunks
-            const content = choice.delta?.content;
-            if (content) {
-                contentBuffer += content;
-                yield {
-                    type: 'content',
-                    content,
-                };
-            }
-            // Stream reasoning content (for o1 models, etc.)
-            // Note: reasoning_content is NOT included in the response, only counted for tokens
-            const reasoningContent = choice.delta?.reasoning_content;
-            if (reasoningContent) {
-                // Emit reasoning_started event on first reasoning content
-                if (!reasoningStarted) {
-                    reasoningStarted = true;
-                    yield {
-                        type: 'reasoning_started',
-                    };
-                }
-                yield {
-                    type: 'reasoning_delta',
-                    delta: reasoningContent,
-                };
-            }
-            // Accumulate tool calls and stream deltas
-            const deltaToolCalls = choice.delta?.tool_calls;
-            if (deltaToolCalls) {
-                hasToolCalls = true;
-                for (const deltaCall of deltaToolCalls) {
-                    const index = deltaCall.index ?? 0;
-                    if (!toolCallsBuffer[index]) {
-                        toolCallsBuffer[index] = {
-                            id: '',
-                            type: 'function',
-                            function: {
-                                name: '',
-                                arguments: '',
-                            },
-                        };
-                    }
-                    if (deltaCall.id) {
-                        toolCallsBuffer[index].id = deltaCall.id;
-                    }
-                    // Yield tool call deltas for token counting
-                    let deltaText = '';
-                    if (deltaCall.function?.name) {
-                        toolCallsBuffer[index].function.name += deltaCall.function.name;
-                        deltaText += deltaCall.function.name;
-                    }
-                    if (deltaCall.function?.arguments) {
-                        toolCallsBuffer[index].function.arguments +=
-                            deltaCall.function.arguments;
-                        deltaText += deltaCall.function.arguments;
-                    }
-                    // Stream the delta to frontend for real-time token counting
-                    if (deltaText) {
-                        yield {
-                            type: 'tool_call_delta',
-                            delta: deltaText,
-                        };
-                    }
-                }
-            }
-            if (choice.finish_reason) {
-                break;
-            }
-        }
-        // If there are tool calls, yield them
-        if (hasToolCalls) {
-            yield {
-                type: 'tool_calls',
-                tool_calls: Object.values(toolCallsBuffer),
-            };
-        }
-        // Yield usage information if available
-        if (usageData) {
-            // Save usage to file system at API layer
-            saveUsageToFile(options.model, usageData);
-            yield {
-                type: 'usage',
-                usage: usageData,
-            };
-        }
-        // Signal completion
-        yield {
-            type: 'done',
-        };
-    }, {
-        abortSignal,
-        onRetry,
-    });
-}
-export function validateChatOptions(options) {
-    const errors = [];
-    if (!options.model || options.model.trim().length === 0) {
-        errors.push('Model is required');
-    }
-    if (!options.messages || options.messages.length === 0) {
-        errors.push('At least one message is required');
-    }
-    for (const message of options.messages || []) {
-        if (!message.role ||
-            !['system', 'user', 'assistant', 'tool'].includes(message.role)) {
-            errors.push('Invalid message role');
-        }
-        // Tool messages must have tool_call_id
-        if (message.role === 'tool' && !message.tool_call_id) {
-            errors.push('Tool messages must have tool_call_id');
-        }
-        // Content can be empty for tool calls
-        if (message.role !== 'tool' &&
-            (!message.content || message.content.trim().length === 0)) {
-            errors.push('Message content cannot be empty (except for tool messages)');
-        }
-    }
-    return errors;
-}

package/dist/api/embedding.d.ts

@@ -1,34 +0,0 @@
-export interface EmbeddingOptions {
-    model?: string;
-    input: string[];
-    baseUrl?: string;
-    apiKey?: string;
-    dimensions?: number;
-    task?: string;
-}
-export interface EmbeddingResponse {
-    model: string;
-    object: string;
-    usage: {
-        total_tokens: number;
-        prompt_tokens: number;
-    };
-    data: Array<{
-        object: string;
-        index: number;
-        embedding: number[];
-    }>;
-}
-/**
- * Create embeddings for text array (single API call)
- * @param options Embedding options
- * @returns Embedding response with vectors
- */
-export declare function createEmbeddings(options: EmbeddingOptions): Promise<EmbeddingResponse>;
-/**
- * Create embedding for single text
- * @param text Single text to embed
- * @param options Optional embedding options
- * @returns Embedding vector
- */
-export declare function createEmbedding(text: string, options?: Partial<EmbeddingOptions>): Promise<number[]>;

package/dist/api/embedding.js

@@ -1,80 +0,0 @@
-import { loadCodebaseConfig } from '../utils/codebaseConfig.js';
-import { addProxyToFetchOptions } from '../utils/proxyUtils.js';
-/**
- * Create embeddings for text array (single API call)
- * @param options Embedding options
- * @returns Embedding response with vectors
- */
-export async function createEmbeddings(options) {
-    const config = loadCodebaseConfig();
-    // Use config defaults if not provided
-    const model = options.model || config.embedding.modelName;
-    const baseUrl = options.baseUrl || config.embedding.baseUrl;
-    const apiKey = options.apiKey || config.embedding.apiKey;
-    const dimensions = options.dimensions ?? config.embedding.dimensions;
-    const { input, task } = options;
-    if (!model) {
-        throw new Error('Embedding model name is required');
-    }
-    if (!baseUrl) {
-        throw new Error('Embedding base URL is required');
-    }
-    // API key is optional for local deployments (e.g., Ollama)
-    // if (!apiKey) {
-    // 	throw new Error('Embedding API key is required');
-    // }
-    if (!input || input.length === 0) {
-        throw new Error('Input texts are required');
-    }
-    // Build request body
-    const requestBody = {
-        model,
-        input,
-    };
-    if (task) {
-        requestBody.task = task;
-    }
-    if (dimensions) {
-        requestBody.dimensions = dimensions;
-    }
-    // Use baseUrl directly, append /embeddings if needed
-    const url = baseUrl.endsWith('/embeddings')
-        ? baseUrl
-        : `${baseUrl.replace(/\/$/, '')}/embeddings`;
-    // Build headers - only include Authorization if API key is provided
-    const headers = {
-        'Content-Type': 'application/json',
-        'x-snow': 'true',
-    };
-    if (apiKey) {
-        headers['Authorization'] = `Bearer ${apiKey}`;
-    }
-    const fetchOptions = addProxyToFetchOptions(url, {
-        method: 'POST',
-        headers,
-        body: JSON.stringify(requestBody),
-    });
-    const response = await fetch(url, fetchOptions);
-    if (!response.ok) {
-        const errorText = await response.text();
-        throw new Error(`Embedding API error (${response.status}): ${errorText}`);
-    }
-    const data = await response.json();
-    return data;
-}
-/**
- * Create embedding for single text
- * @param text Single text to embed
- * @param options Optional embedding options
- * @returns Embedding vector
- */
-export async function createEmbedding(text, options) {
-    const response = await createEmbeddings({
-        input: [text],
-        ...options,
-    });
-    if (response.data.length === 0) {
-        throw new Error('No embedding returned from API');
-    }
-    return response.data[0].embedding;
-}

package/dist/api/gemini.d.ts

@@ -1,31 +0,0 @@
-import type { ChatMessage, ChatCompletionTool, UsageInfo } from './types.js';
-export interface GeminiOptions {
-    model: string;
-    messages: ChatMessage[];
-    temperature?: number;
-    tools?: ChatCompletionTool[];
-    includeBuiltinSystemPrompt?: boolean;
-}
-export interface GeminiStreamChunk {
-    type: 'content' | 'tool_calls' | 'tool_call_delta' | 'done' | 'usage' | 'reasoning_started' | 'reasoning_delta';
-    content?: string;
-    tool_calls?: Array<{
-        id: string;
-        type: 'function';
-        function: {
-            name: string;
-            arguments: string;
-        };
-    }>;
-    delta?: string;
-    usage?: UsageInfo;
-    thinking?: {
-        type: 'thinking';
-        thinking: string;
-    };
-}
-export declare function resetGeminiClient(): void;
-/**
- * Create streaming chat completion using Gemini API
- */
-export declare function createStreamingGeminiCompletion(options: GeminiOptions, abortSignal?: AbortSignal, onRetry?: (error: Error, attempt: number, nextDelay: number) => void): AsyncGenerator<GeminiStreamChunk, void, unknown>;