@jsonstudio/llms 0.4.2

package/dist/utils/profile-mapper.js

@@ -0,0 +1,269 @@
+/**
+ * 兼容配置映射器（可选）
+ *
+ * 将既有转换配置映射到V2端点配置（不依赖旧版本命名）。
+ */
+/**
+ * 旧版转换配置映射到 V2 端点配置（Legacy → V2）
+ */
+export class LegacyConfigMapper {
+    /**
+     * 将旧版 ConversionProfile 转换为 V2 的 EndpointConfig
+     */
+    static mapProfileToV2Endpoint(profile) {
+        return {
+            endpoint: this.mapCodecToEndpoint(profile.codec),
+            protocol: this.mapCodecToProtocol(profile.codec),
+            enabled: true,
+            sse: {
+                enabled: profile.supportsStreaming || false,
+                accumulateMs: 500,
+                maxEvents: 100
+            },
+            hooks: {
+                enabled: true,
+                stages: this.mapHooksToV2Stages(profile.codec)
+            },
+            conversion: {
+                autoDetect: profile.autoDetect !== false,
+                fallbackToOriginal: true
+            }
+        };
+    }
+    /**
+     * 将旧版 codec 映射到端点类型
+     */
+    static mapCodecToEndpoint(codec) {
+        if (codec.includes('responses'))
+            return 'responses';
+        if (codec.includes('anthropic'))
+            return 'messages';
+        return 'chat'; // 默认
+    }
+    /**
+     * 将旧版 codec 映射到协议类型
+     */
+    static mapCodecToProtocol(codec) {
+        if (codec.includes('responses'))
+            return 'openai-responses';
+        if (codec.includes('anthropic'))
+            return 'anthropic-messages';
+        return 'openai-chat'; // 默认
+    }
+    /**
+     * 将旧版 hooks 映射到 V2 的 hook 阶段
+     */
+    static mapHooksToV2Stages(codec) {
+        // 根据codec类型返回对应的hook阶段
+        const baseStages = [
+            'request_1_validation_pre',
+            'request_1_validation_post',
+            'request_2_routing_pre',
+            'request_2_routing_post',
+            'request_3_conversion_pre',
+            'request_3_conversion_post',
+            'request_4_tools_pre',
+            'request_4_tools_post',
+            'response_1_receive_pre',
+            'response_1_receive_post',
+            'response_2_conversion_pre',
+            'response_2_conversion_post',
+            'response_5_formatting_pre',
+            'response_5_formatting_post'
+        ];
+        // 根据协议类型添加特定hooks
+        if (codec.includes('anthropic')) {
+            baseStages.push('request_5_sse_pre', 'request_5_sse_post', 'response_4_sse_pre', 'response_4_sse_post');
+        }
+        return baseStages;
+    }
+    /**
+     * 从旧版配置文件生成 V2 配置（占位实现）
+     */
+    static async generateV2ConfigFromLegacy(profilesPath) {
+        // TODO: 读取并解析既有 profiles 配置（当前返回默认配置）
+        const defaultV2Config = {
+            version: '2.0.0',
+            enabled: true,
+            defaultProtocol: 'openai-chat',
+            unifiedProtocol: 'openai-chat',
+            endpoints: {
+                chat: {
+                    endpoint: 'chat',
+                    protocol: 'openai-chat',
+                    enabled: true,
+                    sse: {
+                        enabled: true,
+                        accumulateMs: 500,
+                        maxEvents: 100
+                    },
+                    hooks: {
+                        enabled: true,
+                        stages: [
+                            'request_1_validation_pre', 'request_1_validation_post',
+                            'request_2_routing_pre', 'request_2_routing_post',
+                            'request_3_conversion_pre', 'request_3_conversion_post',
+                            'request_4_tools_pre', 'request_4_tools_post',
+                            'request_5_sse_pre', 'request_5_sse_post',
+                            'request_6_snapshot_pre', 'request_6_snapshot_post',
+                            'request_7_monitoring_pre', 'request_7_monitoring_post',
+                            'request_8_validation_pre', 'request_8_validation_post',
+                            'response_1_receive_pre', 'response_1_receive_post',
+                            'response_2_conversion_pre', 'response_2_conversion_post',
+                            'response_3_tools_pre', 'response_3_tools_post',
+                            'response_4_sse_pre', 'response_4_sse_post',
+                            'response_5_formatting_pre', 'response_5_formatting_post',
+                            'response_6_snapshot_pre', 'response_6_snapshot_post',
+                            'response_7_quality_pre', 'response_7_quality_post',
+                            'response_8_monitoring_pre', 'response_8_monitoring_post'
+                        ]
+                    },
+                    conversion: {
+                        autoDetect: true,
+                        fallbackToOriginal: true
+                    }
+                },
+                responses: {
+                    endpoint: 'responses',
+                    protocol: 'openai-responses',
+                    enabled: true,
+                    sse: {
+                        enabled: true,
+                        accumulateMs: 500,
+                        maxEvents: 100
+                    },
+                    hooks: {
+                        enabled: true,
+                        stages: [
+                            'request_1_validation_pre', 'request_1_validation_post',
+                            'request_2_routing_pre', 'request_2_routing_post',
+                            'request_3_conversion_pre', 'request_3_conversion_post',
+                            'request_4_tools_pre', 'request_4_tools_post',
+                            'request_5_sse_pre', 'request_5_sse_post',
+                            'request_6_snapshot_pre', 'request_6_snapshot_post',
+                            'request_7_monitoring_pre', 'request_7_monitoring_post',
+                            'request_8_validation_pre', 'request_8_validation_post',
+                            'response_1_receive_pre', 'response_1_receive_post',
+                            'response_2_conversion_pre', 'response_2_conversion_post',
+                            'response_3_tools_pre', 'response_3_tools_post',
+                            'response_4_sse_pre', 'response_4_sse_post',
+                            'response_5_formatting_pre', 'response_5_formatting_post',
+                            'response_6_snapshot_pre', 'response_6_snapshot_post',
+                            'response_7_quality_pre', 'response_7_quality_post',
+                            'response_8_monitoring_pre', 'response_8_monitoring_post'
+                        ]
+                    },
+                    conversion: {
+                        autoDetect: true,
+                        fallbackToOriginal: true
+                    }
+                },
+                messages: {
+                    endpoint: 'messages',
+                    protocol: 'anthropic-messages',
+                    enabled: true,
+                    sse: {
+                        enabled: true,
+                        accumulateMs: 500,
+                        maxEvents: 100
+                    },
+                    hooks: {
+                        enabled: true,
+                        stages: [
+                            'request_1_validation_pre', 'request_1_validation_post',
+                            'request_2_routing_pre', 'request_2_routing_post',
+                            'request_3_conversion_pre', 'request_3_conversion_post',
+                            'request_4_tools_pre', 'request_4_tools_post',
+                            'request_5_sse_pre', 'request_5_sse_post',
+                            'request_6_snapshot_pre', 'request_6_snapshot_post',
+                            'request_7_monitoring_pre', 'request_7_monitoring_post',
+                            'request_8_validation_pre', 'request_8_validation_post',
+                            'response_1_receive_pre', 'response_1_receive_post',
+                            'response_2_conversion_pre', 'response_2_conversion_post',
+                            'response_3_tools_pre', 'response_3_tools_post',
+                            'response_4_sse_pre', 'response_4_sse_post',
+                            'response_5_formatting_pre', 'response_5_formatting_post',
+                            'response_6_snapshot_pre', 'response_6_snapshot_post',
+                            'response_7_quality_pre', 'response_7_quality_post',
+                            'response_8_monitoring_pre', 'response_8_monitoring_post'
+                        ]
+                    },
+                    conversion: {
+                        autoDetect: true,
+                        fallbackToOriginal: true
+                    }
+                }
+            },
+            hooks: {
+                enabled: true,
+                stages: [
+                    'request_1_validation_pre', 'request_1_validation_post',
+                    'request_2_routing_pre', 'request_2_routing_post',
+                    'request_3_conversion_pre', 'request_3_conversion_post',
+                    'request_4_tools_pre', 'request_4_tools_post',
+                    'request_5_sse_pre', 'request_5_sse_post',
+                    'request_6_snapshot_pre', 'request_6_snapshot_post',
+                    'request_7_monitoring_pre', 'request_7_monitoring_post',
+                    'request_8_validation_pre', 'request_8_validation_post',
+                    'response_1_receive_pre', 'response_1_receive_post',
+                    'response_2_conversion_pre', 'response_2_conversion_post',
+                    'response_3_tools_pre', 'response_3_tools_post',
+                    'response_4_sse_pre', 'response_4_sse_post',
+                    'response_5_formatting_pre', 'response_5_formatting_post',
+                    'response_6_snapshot_pre', 'response_6_snapshot_post',
+                    'response_7_quality_pre', 'response_7_quality_post',
+                    'response_8_monitoring_pre', 'response_8_monitoring_post'
+                ],
+                snapshot: {
+                    enabled: true,
+                    basePath: '~/.routecodex/snapshots',
+                    endpointIsolation: {
+                        enabled: true,
+                        pathStructure: 'endpoint/request'
+                    },
+                    pathGeneration: {
+                        includeRequestId: true,
+                        includeStage: true,
+                        includeTimestamp: true
+                    },
+                    format: 'json',
+                    compression: 'none',
+                    retention: {
+                        maxFiles: 1000,
+                        maxAge: 7 * 24 * 60 * 60 * 1000 // 7天
+                    }
+                }
+            },
+            requestProcessing: {
+                validation: { enabled: true, strictMode: false, requiredFields: ['model', 'messages'] },
+                normalization: { enabled: true, toolCanonicalization: true, messageStructureNormalization: true },
+                routing: { enabled: true, routeByProtocol: true, routeByEndpoint: true }
+            },
+            responseProcessing: {
+                validation: { enabled: true, strictMode: false, validateFields: ['id', 'object', 'choices'] },
+                formatting: { enabled: true, standardizeResponse: true, cleanupToolResults: true },
+                qualityCheck: { enabled: true, checkCompleteness: true, checkConsistency: true }
+            },
+            toolProcessing: {
+                enabled: true,
+                canonicalization: { enabled: true, harvestTextBlocks: true, normalizeToolCalls: true, removeDuplicateCalls: true },
+                systemToolGuidance: { enabled: true, autoInject: true, enhanceSchemas: true }
+            },
+            protocolConversion: {
+                enabled: true,
+                targetProtocol: 'openai-chat',
+                autoDetect: true,
+                strictValidation: true
+            },
+            performance: {
+                maxConcurrentRequests: 100,
+                requestTimeout: 60000,
+                responseTimeout: 60000,
+                processingTimeout: 45000,
+                retryAttempts: 3,
+                retryDelay: 1000
+            }
+        };
+        return defaultV2Config;
+    }
+}

package/dist/utils/request-processor.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 请求逻辑处理器
+ *
+ * 直接抽取现有的核心逻辑并适配到V2架构中
+ */
+/**
+ * 请求逻辑处理器
+ */
+export declare class RequestLogicProcessor {
+    /**
+     * 使用现有逻辑规范化Chat请求
+     */
+    static normalizeChatRequest(request: any): any;
+    /**
+     * 处理Messages请求
+     */
+    static processMessagesRequest(request: any): any;
+    /**
+     * 处理Responses请求（V2核心桥接）
+     */
+    static processResponsesRequest(request: any): any;
+    /**
+     * 简化处理（暂时返回原始文本）
+     */
+    static harvestToolText(text: string): {
+        cleanedText: string;
+        extractedBlocks: string[];
+    };
+    /**
+     * 简化工具处理（暂时返回原始请求）
+     */
+    static canonicalizeToolsInRequest(request: any): any;
+    /**
+     * 将Messages格式转换为Chat格式
+     */
+    private static convertMessagesToChatFormat;
+    /**
+     * 将Chat格式转换为Messages格式
+     */
+    private static convertChatToMessagesFormat;
+    /**
+     * 验证请求格式（V2校验）
+     */
+    static validateRequest(request: any, endpoint: 'chat' | 'messages' | 'responses'): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * 处理响应转换（V2桥接）
+     */
+    static processResponse(response: any, endpoint: 'chat' | 'messages' | 'responses', originalRequest: any): any;
+}

package/dist/utils/request-processor.js

@@ -0,0 +1,210 @@
+/**
+ * 请求逻辑处理器
+ *
+ * 直接抽取现有的核心逻辑并适配到V2架构中
+ */
+import { normalizeChatRequest } from '../conversion/shared/openai-message-normalize.js';
+import { buildResponsesPayloadFromChat } from '../conversion/responses/responses-openai-bridge.js';
+import { buildChatRequestFromResponses } from '../conversion/shared/responses-request-adapter.js';
+/**
+ * 请求逻辑处理器
+ */
+export class RequestLogicProcessor {
+    /**
+     * 使用现有逻辑规范化Chat请求
+     */
+    static normalizeChatRequest(request) {
+        try {
+            // 使用现有的normalizeChatRequest
+            const normalized = normalizeChatRequest(request);
+            return normalized;
+        }
+        catch (error) {
+            console.warn('Chat请求规范化失败:', error);
+            return request;
+        }
+    }
+    /**
+     * 处理Messages请求
+     */
+    static processMessagesRequest(request) {
+        try {
+            // 1. 将Anthropic Messages格式转换为OpenAI Chat格式
+            const chatRequest = this.convertMessagesToChatFormat(request);
+            // 2. 使用Chat规范化逻辑
+            const normalizedChat = this.normalizeChatRequest(chatRequest);
+            // 3. 转换回Messages格式
+            return this.convertChatToMessagesFormat(normalizedChat);
+        }
+        catch (error) {
+            console.warn('Messages请求处理失败:', error);
+            return request;
+        }
+    }
+    /**
+     * 处理Responses请求（V2核心桥接）
+     */
+    static processResponsesRequest(request) {
+        try {
+            // 1. 使用Responses到Chat转换（V2 bridge）
+            const { request: chatRequest } = buildChatRequestFromResponses(request, {
+                requestId: `resp_${Date.now()}`,
+                metadata: {}
+            });
+            // 2. Chat规范化（V2）
+            const normalizedChat = this.normalizeChatRequest(chatRequest);
+            // 3. 转换回Responses格式（简化版本）
+            return {
+                ...request,
+                model: normalizedChat.model,
+                tools: normalizedChat.tools,
+                temperature: normalizedChat.temperature,
+                max_tokens: normalizedChat.max_tokens,
+                stream: normalizedChat.stream
+            };
+        }
+        catch (error) {
+            console.warn('Responses请求处理失败:', error);
+            return request;
+        }
+    }
+    /**
+     * 简化处理（暂时返回原始文本）
+     */
+    static harvestToolText(text) {
+        // 暂时返回原始文本，待后续实现
+        return {
+            cleanedText: text,
+            extractedBlocks: []
+        };
+    }
+    /**
+     * 简化工具处理（暂时返回原始请求）
+     */
+    static canonicalizeToolsInRequest(request) {
+        // 暂时返回原始请求，待后续实现
+        return request;
+    }
+    /**
+     * 将Messages格式转换为Chat格式
+     */
+    static convertMessagesToChatFormat(messagesRequest) {
+        const messages = [];
+        // 添加系统消息
+        if (messagesRequest.system) {
+            messages.push({
+                role: 'system',
+                content: messagesRequest.system
+            });
+        }
+        // 添加用户和助手消息
+        if (messagesRequest.messages && Array.isArray(messagesRequest.messages)) {
+            for (const msg of messagesRequest.messages) {
+                if (msg.role === 'user' || msg.role === 'assistant') {
+                    messages.push({
+                        role: msg.role,
+                        content: Array.isArray(msg.content)
+                            ? msg.content.find((c) => c.type === 'text')?.text || ''
+                            : msg.content
+                    });
+                }
+            }
+        }
+        return {
+            model: messagesRequest.model,
+            messages,
+            tools: messagesRequest.tools,
+            temperature: messagesRequest.temperature,
+            max_tokens: messagesRequest.max_tokens,
+            stream: messagesRequest.stream
+        };
+    }
+    /**
+     * 将Chat格式转换为Messages格式
+     */
+    static convertChatToMessagesFormat(chatRequest) {
+        const messages = [];
+        let systemContent = undefined;
+        // 分离系统消息和对话消息
+        if (chatRequest.messages && Array.isArray(chatRequest.messages)) {
+            for (const msg of chatRequest.messages) {
+                if (msg.role === 'system') {
+                    systemContent = msg.content;
+                }
+                else if (msg.role === 'user' || msg.role === 'assistant') {
+                    messages.push({
+                        role: msg.role,
+                        content: msg.content
+                    });
+                }
+            }
+        }
+        return {
+            model: chatRequest.model,
+            messages,
+            system: systemContent,
+            tools: chatRequest.tools,
+            temperature: chatRequest.temperature,
+            max_tokens: chatRequest.max_tokens,
+            stream: chatRequest.stream
+        };
+    }
+    /**
+     * 验证请求格式（V2校验）
+     */
+    static validateRequest(request, endpoint) {
+        const errors = [];
+        // 通用验证
+        if (!request.model) {
+            errors.push('model is required');
+        }
+        // 端点特定验证
+        switch (endpoint) {
+            case 'chat':
+                if (!request.messages || !Array.isArray(request.messages)) {
+                    errors.push('messages array is required for chat endpoint');
+                }
+                break;
+            case 'messages':
+                if (!request.messages || !Array.isArray(request.messages)) {
+                    errors.push('messages array is required for messages endpoint');
+                }
+                if (!request.max_tokens) {
+                    errors.push('max_tokens is required for messages endpoint');
+                }
+                break;
+            case 'responses':
+                if (!request.input) {
+                    errors.push('input is required for responses endpoint');
+                }
+                break;
+        }
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+    /**
+     * 处理响应转换（V2桥接）
+     */
+    static processResponse(response, endpoint, originalRequest) {
+        try {
+            // 对于Responses端点，使用V2的响应桥接
+            if (endpoint === 'responses' && originalRequest) {
+                const context = {
+                    requestId: response.id || `resp_${Date.now()}`,
+                    endpoint: '/v1/responses',
+                    metadata: {}
+                };
+                const responsesPayload = buildResponsesPayloadFromChat(response, context);
+                return responsesPayload;
+            }
+            // 其他端点暂时返回原始响应
+            return response;
+        }
+        catch (error) {
+            console.warn('响应处理失败:', error);
+            return response;
+        }
+    }
+}

package/dist/utils/request-utils.d.ts

@@ -0,0 +1,117 @@
+/**
+ * 请求工具函数
+ */
+import type { LLMSwitchHookContext } from '../api/llmswitch-types.js';
+/**
+ * 请求ID生成器
+ */
+export declare class RequestIdGenerator {
+    private static counter;
+    static generate(): string;
+    static reset(): void;
+}
+/**
+ * 请求验证工具
+ */
+export declare class RequestValidator {
+    /**
+     * 验证基础请求结构
+     */
+    static validateBasicRequest(request: any): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * 验证Chat请求
+     */
+    static validateChatRequest(request: any): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * 验证Responses请求
+     */
+    static validateResponsesRequest(request: any): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * 验证Messages请求
+     */
+    static validateMessagesRequest(request: any): {
+        valid: boolean;
+        errors: string[];
+    };
+}
+/**
+ * 请求转换工具
+ */
+export declare class RequestTransformer {
+    /**
+     * 标准化请求格式
+     */
+    static normalizeRequest(request: any, targetProtocol: string): any;
+    /**
+     * 转换为OpenAI Chat格式
+     */
+    private static normalizeToOpenAIChat;
+    /**
+     * 转换为OpenAI Responses格式
+     */
+    private static normalizeToOpenAIResponses;
+    /**
+     * 转换为Anthropic Messages格式
+     */
+    private static normalizeToAnthropicMessages;
+}
+/**
+ * 请求上下文工具
+ */
+export declare class RequestContextBuilder {
+    /**
+     * 构建Hook上下文
+     */
+    static buildHookContext(requestId: string, endpoint: string, stage: string, additionalData?: Partial<LLMSwitchHookContext>): LLMSwitchHookContext;
+    /**
+     * 更新上下文元数据
+     */
+    static updateMetadata(context: LLMSwitchHookContext, updates: Record<string, any>): LLMSwitchHookContext;
+    /**
+     * 添加性能指标
+     */
+    static addPerformanceMetrics(context: LLMSwitchHookContext, metrics: {
+        duration?: number;
+        memoryUsage?: number;
+        tokensProcessed?: number;
+    }): LLMSwitchHookContext;
+}
+/**
+ * 请求追踪工具
+ */
+export declare class RequestTracker {
+    private static activeRequests;
+    /**
+     * 开始追踪请求
+     */
+    static startTracking(requestId: string, endpoint: string, metadata?: any): void;
+    /**
+     * 结束追踪请求
+     */
+    static endTracking(requestId: string): {
+        duration: number;
+        endpoint: string;
+        metadata: any;
+    } | null;
+    /**
+     * 获取活跃请求统计
+     */
+    static getActiveRequestsStats(): {
+        count: number;
+        byEndpoint: Record<string, number>;
+        oldestRequest: number;
+    };
+    /**
+     * 清理过期请求
+     */
+    static cleanupExpiredRequests(maxAge?: number): void;
+}