@jsonstudio/llms 0.4.3 → 0.4.5

package/README.md

@@ -1,4 +1,6 @@
-# rcc-llmswitch-core（RouteCodex LLM Switch 核心）
+# @jsonstudio/llms（RouteCodex LLM Switch 核心）
+
+> 自 0.4.3 起，原 `rcc-llmswitch-core` npm 包已迁移并更名为 `@jsonstudio/llms`。开发 / 发布流程保持不变，仅需更新 package 依赖与文档引用。
 
 本包是 RouteCodex V2 的“工具治理唯一入口 + 协议转换核心”，实现严格的“前半段/后半段”双向流水线，并通过 `defaultSseCodecRegistry` 统一治理所有 SSE ↔ JSON 转换。核心事实：
 

package/dist/bridge/routecodex-adapter.js

@@ -19,12 +19,15 @@ function normalizeEndpoint(candidate) {
 }
 function inferProviderType(protocol) {
     const value = (protocol ?? '').toLowerCase();
-    if (value.includes('anthropic'))
+    if (value.includes('anthropic')) {
         return 'anthropic';
-    if (value.includes('responses'))
+    }
+    if (value.includes('responses')) {
         return 'responses';
-    if (value.includes('gemini'))
+    }
+    if (value.includes('gemini')) {
         return 'gemini';
+    }
     return 'openai';
 }
 function buildContext(input) {

package/dist/config-unified/enhanced-path-resolver.js

@@ -10,28 +10,36 @@ export function resolveHostPaths() {
     try {
         const cwd = process.cwd();
         const cfg = path.join(cwd, 'config');
-        if (fs.existsSync(cfg))
+        if (fs.existsSync(cfg)) {
             return { hostRoot: cwd, configDir: cfg };
+        }
+    }
+    catch {
+        /* ignore */
     }
-    catch { /* ignore */ }
     // Attempt 2: scan upward from this file
     try {
         let cur = path.dirname(new URL(import.meta.url).pathname);
         const visited = new Set();
         for (let i = 0; i < 10; i++) {
-            if (visited.has(cur))
+            if (visited.has(cur)) {
                 break;
+            }
             visited.add(cur);
             const cfg = path.join(cur, 'config');
-            if (fs.existsSync(cfg))
+            if (fs.existsSync(cfg)) {
                 return { hostRoot: cur, configDir: cfg };
+            }
             const parent = path.dirname(cur);
-            if (parent === cur)
+            if (parent === cur) {
                 break;
+            }
             cur = parent;
         }
     }
-    catch { /* ignore */ }
+    catch {
+        /* ignore */
+    }
     // Fallback to relative 'config'
     const fallbackRoot = process.cwd();
     return { hostRoot: fallbackRoot, configDir: path.join(fallbackRoot, 'config') };

package/dist/config-unified/unified-config.js

@@ -2,20 +2,22 @@
 import fs from 'fs';
 import path from 'path';
 import { resolveHostPaths } from './enhanced-path-resolver.js';
-const isObj = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
-function readJsonSync(file) {
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const hasProviders = (value) => isRecord(value) && typeof value.providers === 'object' && value.providers !== null;
+const readJsonSync = (file) => {
     try {
         return JSON.parse(fs.readFileSync(file, 'utf-8'));
     }
     catch {
         return null;
     }
-}
-function listMergedConfigs(configDir) {
+};
+const listMergedConfigs = (configDir) => {
     try {
-        const files = fs.readdirSync(configDir)
-            .filter(n => /merged-config.*\.json$/i.test(n))
-            .map(n => path.join(configDir, n));
+        const files = fs
+            .readdirSync(configDir)
+            .filter((name) => /merged-config.*\.json$/i.test(name))
+            .map((name) => path.join(configDir, name));
         files.sort((a, b) => {
             try {
                 const sa = fs.statSync(a);
@@ -31,39 +33,70 @@ function listMergedConfigs(configDir) {
     catch {
         return [];
     }
-}
+};
+const toNumber = (value) => {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+};
+const extractProviders = (cfg) => {
+    if (!isRecord(cfg.virtualrouter) || !hasProviders(cfg.virtualrouter)) {
+        return null;
+    }
+    return cfg.virtualrouter.providers ?? null;
+};
+const extractModulesConfig = (modulesRoot) => {
+    if (!isRecord(modulesRoot.modules)) {
+        return null;
+    }
+    const virtualRouterModule = modulesRoot.modules.virtualrouter;
+    if (!isRecord(virtualRouterModule)) {
+        return null;
+    }
+    const config = virtualRouterModule.config;
+    return isRecord(config) ? config : null;
+};
+const readContextBudgetNode = (configNode) => {
+    if (!configNode) {
+        return { defaultBytes: null, safetyRatio: null };
+    }
+    const contextBudgetNode = configNode.contextBudget;
+    if (!isRecord(contextBudgetNode)) {
+        return { defaultBytes: null, safetyRatio: null };
+    }
+    const defaultBytes = toNumber(contextBudgetNode.defaultMaxContextBytes ?? contextBudgetNode.defaultMaxContext);
+    const safetyRatio = toNumber(contextBudgetNode.safetyRatio);
+    return { defaultBytes, safetyRatio };
+};
 function findMaxContextInConfig(cfg, modelId) {
-    try {
-        const vr = cfg.virtualrouter;
-        if (!isObj(vr))
-            return null;
-        const providers = vr.providers;
-        if (!isObj(providers))
-            return null;
-        for (const p of Object.keys(providers)) {
-            const prov = providers[p];
-            if (!isObj(prov))
-                continue;
-            const models = prov.models;
-            if (!isObj(models))
-                continue;
-            if (Object.prototype.hasOwnProperty.call(models, modelId)) {
-                const item = models[modelId];
-                const v = isObj(item) ? item.maxContext : undefined;
-                const n = Number(v);
-                if (Number.isFinite(n) && n > 0)
-                    return n;
-            }
+    const providers = extractProviders(cfg);
+    if (!providers) {
+        return null;
+    }
+    for (const provider of Object.values(providers)) {
+        if (!isRecord(provider.models)) {
+            continue;
+        }
+        const models = provider.models;
+        if (!Object.prototype.hasOwnProperty.call(models, modelId)) {
+            continue;
+        }
+        const target = models[modelId];
+        if (!target) {
+            continue;
+        }
+        const maxContext = toNumber(target.maxContext);
+        if (maxContext && maxContext > 0) {
+            return maxContext;
         }
     }
-    catch { /* ignore */ }
     return null;
 }
 export class UnifiedConfigFacade {
     static _instance = null;
     static getInstance() {
-        if (!this._instance)
+        if (!this._instance) {
             this._instance = new UnifiedConfigFacade();
+        }
         return this._instance;
     }
     watchers = [];
@@ -83,16 +116,14 @@ export class UnifiedConfigFacade {
         let modulesSafety = null;
         try {
             const modules = readJsonSync(path.join(configDir, 'modules.json'));
-            if (modules && isObj(modules.modules) && isObj(modules.modules.virtualrouter) && isObj(modules.modules.virtualrouter.config)) {
-                const vr = modules.modules.virtualrouter.config;
-                if (isObj(vr.contextBudget)) {
-                    const ctx = vr.contextBudget;
-                    const d = Number(ctx.defaultMaxContextBytes);
-                    if (Number.isFinite(d) && d > 0)
-                        modulesDefault = d;
-                    const s = Number(ctx.safetyRatio);
-                    if (Number.isFinite(s) && s >= 0 && s < 1)
-                        modulesSafety = s;
+            if (modules) {
+                const modulesConfig = extractModulesConfig(modules);
+                const { defaultBytes, safetyRatio } = readContextBudgetNode(modulesConfig);
+                if (defaultBytes && defaultBytes > 0) {
+                    modulesDefault = defaultBytes;
+                }
+                if (typeof safetyRatio === 'number' && safetyRatio >= 0 && safetyRatio < 1) {
+                    modulesSafety = safetyRatio;
                 }
             }
         }
@@ -102,8 +133,9 @@ export class UnifiedConfigFacade {
             const merged = listMergedConfigs(configDir);
             for (const f of merged) {
                 const cfg = readJsonSync(f);
-                if (!cfg)
+                if (!cfg) {
                     continue;
+                }
                 const v = findMaxContextInConfig(cfg, modelId);
                 if (v && v > 0) {
                     const safety = Number.isFinite(safetyFromEnv) ? safetyFromEnv : (modulesSafety ?? 0.1);
@@ -111,7 +143,9 @@ export class UnifiedConfigFacade {
                 }
             }
         }
-        catch { /* ignore */ }
+        catch {
+            /* ignore */
+        }
         // config.json
         try {
             const cfg = readJsonSync(path.join(configDir, 'config.json'));
@@ -135,51 +169,61 @@ export class UnifiedConfigFacade {
         try {
             const { configDir } = resolveHostPaths();
             const modules = readJsonSync(path.join(configDir, 'modules.json'));
-            if (modules && isObj(modules.modules) && isObj(modules.modules.virtualrouter) && isObj(modules.modules.virtualrouter.config)) {
-                const vr = modules.modules.virtualrouter.config;
-                if (isObj(vr.contextBudget)) {
-                    const ctx = vr.contextBudget;
-                    const d = Number(ctx.defaultMaxContextBytes);
-                    const s = Number(ctx.safetyRatio);
-                    if (!(Number.isFinite(d) && d > 0))
+            if (modules) {
+                const modulesConfig = extractModulesConfig(modules);
+                if (modulesConfig && isRecord(modulesConfig.contextBudget)) {
+                    const contextBudget = modulesConfig.contextBudget;
+                    const defaultBytes = toNumber(contextBudget.defaultMaxContextBytes ?? contextBudget.defaultMaxContext);
+                    const safetyRatio = toNumber(contextBudget.safetyRatio);
+                    if (!(defaultBytes && defaultBytes > 0)) {
                         issues.push('contextBudget.defaultMaxContextBytes must be positive number');
-                    if (!(Number.isFinite(s) && s >= 0 && s < 1))
+                    }
+                    if (!(typeof safetyRatio === 'number' && safetyRatio >= 0 && safetyRatio < 1)) {
                         issues.push('contextBudget.safetyRatio must be in [0,1)');
+                    }
                 }
             }
         }
-        catch (e) {
-            issues.push(`validateConfig error: ${e?.message || String(e)}`);
+        catch (error) {
+            const err = error;
+            issues.push(`validateConfig error: ${err?.message ?? String(error)}`);
         }
         return { ok: issues.length === 0, issues };
     }
     watchConfig(cb) {
         this.watchers.push(cb);
-        if (this.fsWatcher)
+        if (this.fsWatcher) {
             return;
+        }
         try {
             const { configDir } = resolveHostPaths();
             this.fsWatcher = fs.watch(configDir, { persistent: false }, (event, file) => {
                 try {
-                    this.watchers.forEach(fn => fn({ file: file || '', event }));
+                    this.watchers.forEach((fn) => fn({ file: file || '', event }));
+                }
+                catch {
+                    /* ignore */
                 }
-                catch { /* ignore */ }
             });
         }
-        catch { /* ignore */ }
+        catch {
+            /* ignore */
+        }
     }
     unwatchConfig(cb) {
         if (!cb) {
             this.watchers = [];
         }
         else {
-            this.watchers = this.watchers.filter(fn => fn !== cb);
+            this.watchers = this.watchers.filter((fn) => fn !== cb);
         }
         if (this.watchers.length === 0 && this.fsWatcher) {
             try {
                 this.fsWatcher.close();
             }
-            catch { /* ignore */ }
+            catch {
+                /* ignore */
+            }
             this.fsWatcher = null;
         }
     }

package/dist/conversion/codec-registry.js

@@ -1,3 +1,6 @@
+import { OpenAIOpenAIPipelineCodec } from './pipeline/codecs/v2/openai-openai-pipeline.js';
+import { AnthropicOpenAIPipelineCodec } from './pipeline/codecs/v2/anthropic-openai-pipeline.js';
+import { ResponsesOpenAIPipelineCodec } from './pipeline/codecs/v2/responses-openai-pipeline.js';
 export class CodecRegistry {
     factories = new Map();
     instances = new Map();
@@ -6,11 +9,13 @@ export class CodecRegistry {
         this.factories.set(id, factory);
     }
     async resolve(id) {
-        if (this.instances.has(id))
+        if (this.instances.has(id)) {
             return this.instances.get(id);
+        }
         const factory = this.factories.get(id);
-        if (!factory)
+        if (!factory) {
             throw new Error(`Unknown conversion codec: ${id}`);
+        }
         const instance = await factory();
         await instance.initialize();
         this.instances.set(id, instance);
@@ -21,5 +26,12 @@ export class CodecRegistry {
 // reimplement codecs here; the router will not be switched yet. This file is
 // prepared so later phases can register actual codecs.
 export function getDefaultCodecFactories() {
-    return {};
+    return {
+        'openai-openai': () => new OpenAIOpenAIPipelineCodec(),
+        'openai-openai-v2': () => new OpenAIOpenAIPipelineCodec(),
+        'anthropic-openai': () => new AnthropicOpenAIPipelineCodec(),
+        'anthropic-openai-v2': () => new AnthropicOpenAIPipelineCodec(),
+        'responses-openai': () => new ResponsesOpenAIPipelineCodec(),
+        'responses-openai-v2': () => new ResponsesOpenAIPipelineCodec()
+    };
 }

package/dist/conversion/codecs/anthropic-openai-codec.d.ts

@@ -1,17 +1,7 @@
 import type { ConversionCodec, ConversionContext, ConversionProfile } from '../types.js';
-export declare function mapAnthropicToolsToOpenAI(tools: any[]): any[];
-export declare function buildOpenAIChatFromAnthropic(payload: any): {
-    messages: any[];
-};
-/**
- * ChatRequest → AnthropicRequest 编码器（请求侧）
- *
- * 用于在 v3 管线中，将 canonical Chat 请求编码为 Anthropic /v1/messages wire 形状：
- *  - messages: Chat messages → Anthropic content blocks（仅 text，工具调用由 tools 列表承载）
- *  - tools: Chat tools[].function → Anthropic { name, description, input_schema }
- *  - 参数：max_tokens/temperature/top_p/stop → Anthropic 对应字段
- */
-export declare function buildAnthropicRequestFromOpenAIChat(chatReq: any): any;
+import { buildAnthropicFromOpenAIChat, buildOpenAIChatFromAnthropic } from '../shared/anthropic-message-utils.js';
+export { buildAnthropicFromOpenAIChat, buildOpenAIChatFromAnthropic };
+export { buildAnthropicRequestFromOpenAIChat } from '../shared/anthropic-message-utils.js';
 export declare class AnthropicOpenAIConversionCodec implements ConversionCodec {
     private readonly _dependencies;
     readonly id = "anthropic-openai";