@jsonstudio/llms 0.4.2

package/dist/api/llmswitch-config.js

@@ -0,0 +1,415 @@
+/**
+ * LLMSwitch V2 配置类型和默认配置
+ *
+ * 定义LLMSwitch V2的配置结构、验证和默认值
+ */
+// 默认LLMSwitch V2配置
+export const DEFAULT_LLSWITCH_CONFIG = {
+    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: 1000,
+                maxEvents: 1000
+            },
+            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: false
+            }
+        },
+        responses: {
+            endpoint: 'responses',
+            protocol: 'openai-responses',
+            enabled: true,
+            sse: {
+                enabled: true,
+                accumulateMs: 1000,
+                maxEvents: 1000
+            },
+            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: false
+            }
+        },
+        messages: {
+            endpoint: 'messages',
+            protocol: 'anthropic-messages',
+            enabled: true,
+            sse: {
+                enabled: true,
+                accumulateMs: 1000,
+                maxEvents: 1000
+            },
+            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: false
+            }
+        }
+    },
+    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/llmswitch-core',
+            endpointIsolation: {
+                enabled: true,
+                pathStructure: 'endpoint/request'
+            },
+            pathGeneration: {
+                includeRequestId: true,
+                includeStage: true,
+                includeTimestamp: true
+            },
+            format: 'json',
+            compression: 'gzip',
+            retention: {
+                maxFiles: 1000,
+                maxAge: 604800000 // 7天
+            }
+        }
+    },
+    // 请求处理配置 - llmswitch-core的核心职责
+    requestProcessing: {
+        validation: {
+            enabled: true,
+            strictMode: false,
+            requiredFields: ['model', 'messages']
+        },
+        normalization: {
+            enabled: true,
+            toolCanonicalization: true,
+            messageStructureNormalization: true
+        },
+        routing: {
+            enabled: true,
+            routeByProtocol: true,
+            routeByEndpoint: true
+        }
+    },
+    // 响应处理配置 - llmswitch-core的核心职责
+    responseProcessing: {
+        validation: {
+            enabled: true,
+            strictMode: false,
+            validateFields: ['id', 'object', 'choices']
+        },
+        formatting: {
+            enabled: true,
+            standardizeResponse: true,
+            cleanupToolResults: true
+        },
+        qualityCheck: {
+            enabled: true,
+            checkCompleteness: true,
+            checkConsistency: true
+        }
+    },
+    // 工具处理配置 - llmswitch-core的统一工具处理
+    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: 30000,
+        responseTimeout: 60000,
+        processingTimeout: 45000,
+        retryAttempts: 3,
+        retryDelay: 1000
+    }
+};
+// 验证LLMSwitch V2配置
+export function validateLLMSwitchConfig(config) {
+    const errors = [];
+    const warnings = [];
+    // 验证基础配置
+    if (config.version && typeof config.version !== 'string') {
+        errors.push('Version must be a string');
+    }
+    if (config.enabled !== undefined && typeof config.enabled !== 'boolean') {
+        errors.push('Enabled must be a boolean');
+    }
+    if (config.defaultProtocol && !['openai-chat', 'openai-responses', 'anthropic-messages'].includes(config.defaultProtocol)) {
+        errors.push('Default protocol must be one of: openai-chat, openai-responses, anthropic-messages');
+    }
+    // 验证端点配置
+    if (config.endpoints) {
+        for (const [endpointName, endpointConfig] of Object.entries(config.endpoints)) {
+            if (!['chat', 'responses', 'messages'].includes(endpointName)) {
+                errors.push(`Invalid endpoint name: ${endpointName}`);
+                continue;
+            }
+            if (!endpointConfig.protocol || !['openai-chat', 'openai-responses', 'anthropic-messages'].includes(endpointConfig.protocol)) {
+                errors.push(`Invalid protocol for endpoint ${endpointName}: ${endpointConfig.protocol}`);
+            }
+            if (endpointConfig.sse?.enabled && (!endpointConfig.sse.accumulateMs || endpointConfig.sse.accumulateMs <= 0)) {
+                errors.push(`SSE accumulateMs must be positive for endpoint ${endpointName}`);
+            }
+        }
+    }
+    // 验证Hook配置
+    if (config.hooks?.enabled && (!config.hooks.stages || config.hooks.stages.length === 0)) {
+        warnings.push('Hooks are enabled but no stages are configured');
+    }
+    // 验证性能配置
+    if (config.performance) {
+        if (config.performance.maxConcurrentRequests <= 0) {
+            errors.push('Max concurrent requests must be positive');
+        }
+        if (config.performance.requestTimeout <= 0) {
+            errors.push('Request timeout must be positive');
+        }
+        if (config.performance.responseTimeout <= 0) {
+            errors.push('Response timeout must be positive');
+        }
+        if (config.performance.processingTimeout <= 0) {
+            errors.push('Processing timeout must be positive');
+        }
+        if (config.performance.retryAttempts < 0) {
+            errors.push('Retry attempts cannot be negative');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings
+    };
+}
+// 深度合并配置
+export function mergeConfig(base, override) {
+    const result = { ...base };
+    for (const [key, value] of Object.entries(override)) {
+        if (value === undefined)
+            continue;
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            // 深度合并对象
+            result[key] = {
+                ...result[key] || {},
+                ...value
+            };
+        }
+        else {
+            // 直接覆盖基本类型
+            result[key] = value;
+        }
+    }
+    return result;
+}
+// 从环境变量创建配置
+export function createConfigFromEnvironment() {
+    const config = {};
+    // 基础配置
+    if (process.env.LLSWITCH_ENABLED) {
+        config.enabled = process.env.LLSWITCH_ENABLED === 'true';
+    }
+    if (process.env.LLSWITCH_DEFAULT_PROTOCOL) {
+        config.defaultProtocol = process.env.LLSWITCH_DEFAULT_PROTOCOL;
+    }
+    // 性能配置
+    if (process.env.LLSWITCH_MAX_CONCURRENT) {
+        config.performance = {
+            maxConcurrentRequests: parseInt(process.env.LLSWITCH_MAX_CONCURRENT),
+            requestTimeout: parseInt(process.env.LLSWITCH_REQUEST_TIMEOUT || '30000'),
+            responseTimeout: parseInt(process.env.LLSWITCH_RESPONSE_TIMEOUT || '60000'),
+            processingTimeout: parseInt(process.env.LLSWITCH_PROCESSING_TIMEOUT || '45000'),
+            retryAttempts: parseInt(process.env.LLSWITCH_RETRY_ATTEMPTS || '3'),
+            retryDelay: parseInt(process.env.LLSWITCH_RETRY_DELAY || '1000')
+        };
+    }
+    // 快照配置
+    if (process.env.LLSWITCH_SNAPSHOT_PATH) {
+        config.hooks = {
+            enabled: true,
+            stages: [],
+            snapshot: {
+                enabled: true,
+                basePath: process.env.LLSWITCH_SNAPSHOT_PATH,
+                endpointIsolation: {
+                    enabled: true,
+                    pathStructure: 'endpoint/request'
+                },
+                pathGeneration: {
+                    includeRequestId: true,
+                    includeStage: true,
+                    includeTimestamp: true
+                },
+                format: 'json',
+                compression: 'gzip',
+                retention: {
+                    maxFiles: parseInt(process.env.LLSWITCH_SNAPSHOT_MAX_FILES || '1000'),
+                    maxAge: parseInt(process.env.LLSWITCH_SNAPSHOT_MAX_AGE || '604800000')
+                }
+            }
+        };
+    }
+    return config;
+}