@jsonstudio/llms 0.4.2

package/dist/conversion/shared/tooling.js

@@ -0,0 +1,143 @@
+/**
+ * Shared helpers for standard tool normalization (shell packing rules).
+ * The goal is deterministic, minimal shaping so executors succeed consistently.
+ */
+// We intentionally do NOT evaluate shell control operators (&&, |, etc.).
+// Codex CLI executor runs argv directly (execvp-like), not through a shell.
+// So we avoid wrapping with "bash -lc" and leave such tokens as-is.
+function toStringArray(v) {
+    if (Array.isArray(v))
+        return v.map((x) => String(x));
+    if (typeof v === 'string')
+        return [v];
+    if (v == null)
+        return [];
+    return [String(v)];
+}
+export function splitCommandString(input) {
+    const s = input.trim();
+    if (!s)
+        return [];
+    const out = [];
+    let cur = '';
+    let inSingle = false;
+    let inDouble = false;
+    for (let i = 0; i < s.length; i++) {
+        const ch = s[i];
+        if (inSingle) {
+            if (ch === "'") {
+                inSingle = false;
+                continue;
+            }
+            cur += ch;
+            continue;
+        }
+        if (inDouble) {
+            if (ch === '"') {
+                inDouble = false;
+                continue;
+            }
+            if (ch === '\\' && i + 1 < s.length) { // simple escape in double quotes
+                i++;
+                cur += s[i];
+                continue;
+            }
+            cur += ch;
+            continue;
+        }
+        if (ch === "'") {
+            inSingle = true;
+            continue;
+        }
+        if (ch === '"') {
+            inDouble = true;
+            continue;
+        }
+        if (/\s/.test(ch)) {
+            if (cur) {
+                out.push(cur);
+                cur = '';
+            }
+            continue;
+        }
+        cur += ch;
+    }
+    if (cur)
+        out.push(cur);
+    return out;
+}
+/**
+ * Pack shell arguments per unified rules:
+ * - command: string -> ["bash","-lc","<string>"]
+ * - command: tokens[]
+ *   - if starts with ["cd", path, ...rest]:
+ *       - set workdir to path when absent
+ *       - if rest empty => command=["pwd"]
+ *       - else if rest has control tokens => command=["bash","-lc", join(rest)]
+ *       - else command=rest (argv)
+ *   - else if tokens contain control tokens => command=["bash","-lc", join(tokens)]
+ *   - else command=tokens (argv)
+ * - join(rest) uses single-space join without extra quoting
+ */
+export function packShellArgs(input) {
+    const out = { ...input };
+    const cmdRaw = out.command;
+    const workdir = out.workdir;
+    // string => split into argv tokens (no shell wrapping)
+    if (typeof cmdRaw === 'string') {
+        const tokens = splitCommandString(cmdRaw);
+        // handle leading cd as cwd switch
+        if (tokens[0] === 'cd' && typeof tokens[1] === 'string' && tokens[1]) {
+            const dir = tokens[1];
+            let rest = tokens.slice(2);
+            // tolerate common chain operator right after cd
+            if (rest[0] === '&&' || rest[0] === ';') {
+                rest = rest.slice(1);
+            }
+            if (!workdir)
+                out.workdir = dir;
+            out.command = rest.length ? rest : ['pwd'];
+            return out;
+        }
+        out.command = tokens.length ? tokens : ['pwd'];
+        if (typeof workdir === 'string' && workdir)
+            out.workdir = workdir;
+        return out;
+    }
+    // array tokens
+    const tokens = toStringArray(cmdRaw);
+    if (tokens.length === 0) {
+        out.command = ['pwd'];
+        if (typeof workdir === 'string' && workdir)
+            out.workdir = workdir;
+        return out;
+    }
+    // cd chain for argv input
+    if (tokens[0] === 'cd' && typeof tokens[1] === 'string' && tokens[1]) {
+        const dir = tokens[1];
+        const rest = tokens.slice(2);
+        if (!workdir)
+            out.workdir = dir;
+        out.command = rest.length ? rest : ['pwd'];
+        return out;
+    }
+    // argv straight
+    out.command = tokens;
+    if (typeof workdir === 'string' && workdir)
+        out.workdir = workdir;
+    return out;
+}
+export function flattenByComma(arr) {
+    return arr.flatMap((t) => String(t).split(',').map(s => s.trim()).filter(Boolean));
+}
+// Helper to chunk a long string into N parts (bounded)
+export function chunkString(s, minParts = 3, maxParts = 12, targetChunk = 12) {
+    if (typeof s !== 'string' || !s.length)
+        return [];
+    const parts = Math.max(minParts, Math.min(maxParts, Math.ceil(s.length / targetChunk)));
+    const step = Math.max(1, Math.ceil(s.length / parts));
+    const out = [];
+    for (let i = 0; i < s.length; i += step)
+        out.push(s.slice(i, i + step));
+    return out;
+}

package/dist/conversion/types.d.ts

@@ -0,0 +1,33 @@
+export interface ConversionProfile {
+    id: string;
+    incomingProtocol: string;
+    outgoingProtocol: string;
+    codec: string;
+    inputSchema?: string;
+    canonicalRequestSchema?: string;
+    canonicalResponseSchema?: string;
+    clientResponseSchema?: string;
+    trace?: boolean;
+}
+export interface ConversionConfigFile {
+    profiles: Record<string, Omit<ConversionProfile, 'id'>>;
+    endpointBindings?: Record<string, string>;
+}
+export interface ConversionContext {
+    requestId?: string;
+    endpoint?: string;
+    entryEndpoint?: string;
+    targetProtocol?: string;
+    stream?: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface ConversionResult {
+    profile: ConversionProfile;
+    payload: any;
+}
+export interface ConversionCodec {
+    readonly id: string;
+    initialize(): Promise<void>;
+    convertRequest(payload: any, profile: ConversionProfile, context: ConversionContext): Promise<any>;
+    convertResponse(payload: any, profile: ConversionProfile, context: ConversionContext): Promise<any>;
+}

package/dist/conversion/types.js

@@ -0,0 +1 @@
+export {};

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 核心模块导出
+ */
+export { LLMSwitchEngineV2 } from './llmswitch-engine-v2.js';
+export { LLMSwitchFactoryV2 } from './llmswitch-factory-v2.js';
+export { createLLMSwitchV2, createLLMSwitchV2Development, createLLMSwitchV2Production, createLLMSwitchV2Test, getDefaultLLMSwitchV2 } from './llmswitch-factory-v2.js';

package/dist/core/index.js

@@ -0,0 +1,9 @@
+/**
+ * 核心模块导出
+ */
+// 核心引擎
+export { LLMSwitchEngineV2 } from './llmswitch-engine-v2.js';
+// 工厂类
+export { LLMSwitchFactoryV2 } from './llmswitch-factory-v2.js';
+// 便捷函数
+export { createLLMSwitchV2, createLLMSwitchV2Development, createLLMSwitchV2Production, createLLMSwitchV2Test, getDefaultLLMSwitchV2 } from './llmswitch-factory-v2.js';

package/dist/core/llmswitch-engine-v2.d.ts

@@ -0,0 +1,132 @@
+/**
+ * LLMSwitch V2 引擎
+ *
+ * 基于现有Hooks系统的多端点转换引擎，支持Chat、Responses、Messages三个端点
+ * 每个转换节点前后都有Hooks支持，并提供基于入口端点的路径隔离快照系统
+ */
+import type { ILLMSwitchV2, LLMSwitchV2Config, EndpointType, ProtocolType, LLMSwitchHookContext, SSEEvent, LLMSwitchProcessingResult, LLMSwitchMetrics, LLMSwitchHealthCheck } from '../api/llmswitch-types.js';
+import { LLMSwitchHookStage } from '../api/llmswitch-types.js';
+/**
+ * LLMSwitch V2 引擎核心实现
+ */
+export declare class LLMSwitchEngineV2 implements ILLMSwitchV2 {
+    private config;
+    private state;
+    private hooksAdapter;
+    private endpointRouter;
+    private metrics;
+    private startTime;
+    private hookHandlers;
+    constructor(config: LLMSwitchV2Config);
+    /**
+     * 初始化引擎
+     */
+    initialize(): Promise<void>;
+    /**
+     * 启动引擎
+     */
+    start(): Promise<void>;
+    /**
+     * 停止引擎
+     */
+    stop(): Promise<void>;
+    /**
+     * 关闭引擎
+     */
+    shutdown(): Promise<void>;
+    /**
+     * 处理请求
+     */
+    processRequest(request: any, endpoint?: EndpointType, context?: Partial<LLMSwitchHookContext>): Promise<LLMSwitchProcessingResult>;
+    /**
+     * 处理响应
+     */
+    processResponse(response: any, originalEndpoint: EndpointType, context: LLMSwitchHookContext): Promise<LLMSwitchProcessingResult>;
+    /**
+     * 流式请求处理
+     */
+    processStreamingRequest(request: any, endpoint?: EndpointType, context?: Partial<LLMSwitchHookContext>): Promise<AsyncIterable<SSEEvent>>;
+    /**
+     * 配置管理
+     */
+    configure(config: LLMSwitchV2Config): Promise<void>;
+    updateConfig(updates: Partial<LLMSwitchV2Config>): Promise<void>;
+    /**
+     * 健康检查
+     */
+    healthCheck(): Promise<LLMSwitchHealthCheck>;
+    convertRequest(payload: any, profile: any, context: any): Promise<any>;
+    convertResponse(payload: any, profile: any, context: any): Promise<any>;
+    private executeRequestFlow;
+    private executeResponseFlow;
+    private createHooksAdapter;
+    private createEndpointRouter;
+    /**
+     * 注册默认的工具治理 Hooks：
+     * - request_4_tools_pre: 请求侧仅做 augment + 指引注入（不做文本→工具）
+     * - response_3_tools_pre: 响应侧做文本→工具；Responses 非流追加 required_action
+     *
+     * DISABLED: Tool governance is now handled exclusively in ChatProcessNode (conversion-v3)
+     * to avoid duplicate processing and interference with TOON decoding.
+     */
+    private registerDefaultToolHooks;
+    private validateConfig;
+    private detectProcessingMode;
+    private detectEndpointFromPayload;
+    private generateRequestId;
+    private generateExecutionId;
+    private generatePathIdentifier;
+    private getEndpointPath;
+    private initializeMetrics;
+    registerHookHandler(stage: LLMSwitchHookStage, handler: (context: LLMSwitchHookContext, data: any) => Promise<any>): void;
+    unregisterHookHandler(stage: LLMSwitchHookStage): void;
+    getHookStats(): any;
+    /**
+     * V2 核心功能：请求预处理（为workflow准备）
+     */
+    preprocessRequest(request: any, endpoint: EndpointType, context?: Partial<LLMSwitchHookContext>): Promise<LLMSwitchProcessingResult>;
+    /**
+     * V2 核心功能：响应后处理（从workflow接收）
+     */
+    postprocessResponse(response: any, originalEndpoint: EndpointType, context: LLMSwitchHookContext): Promise<LLMSwitchProcessingResult>;
+    /**
+     * 协议转换到统一格式（为workflow准备）
+     */
+    convertToUnifiedProtocol(request: any, sourceProtocol: ProtocolType): Promise<any>;
+    /**
+     * 统一工具处理（三端工具调用的唯一入口）
+     */
+    processToolCalls(request: any, endpoint: EndpointType): Promise<any>;
+    /**
+     * 系统工具指引注入
+     */
+    injectSystemToolGuidance(request: any, tools: any[]): Promise<any>;
+    /**
+     * 流式请求预处理
+     */
+    preprocessStreamingRequest(request: any, endpoint: EndpointType, context?: Partial<LLMSwitchHookContext>): Promise<AsyncIterable<SSEEvent>>;
+    /**
+     * 流式响应后处理
+     */
+    postprocessStreamingResponse(events: AsyncIterable<SSEEvent>, originalEndpoint: EndpointType, context: LLMSwitchHookContext): Promise<AsyncIterable<SSEEvent>>;
+    /**
+     * 获取配置
+     */
+    getConfig(): LLMSwitchV2Config;
+    /**
+     * 获取指标
+     */
+    getMetrics(): LLMSwitchMetrics;
+    /**
+     * 执行Hooks
+     */
+    executeHooks(stage: LLMSwitchHookStage, context: LLMSwitchHookContext, data: any): Promise<any>;
+    /**
+     * 捕获快照
+     */
+    captureSnapshot(stage: LLMSwitchHookStage, context: LLMSwitchHookContext, data: any): Promise<void>;
+    /**
+     * 获取快照路径
+     */
+    getSnapshotPath(stage: LLMSwitchHookStage, context: LLMSwitchHookContext): string;
+}