@jsonstudio/llms 0.4.3 → 0.4.5

package/dist/conversion/shared/chat-request-filters.d.ts

@@ -1,9 +0,0 @@
-import type { ConversionContext, ConversionProfile } from '../types.js';
-/**
- * 统一的 Chat 请求侧过滤链路。
- *
- * 目标：
- * - 所有进入 Provider 的 Chat 形状请求（无论入口为 /v1/chat、/v1/responses 还是 /v1/messages），
- *   都在这里走同一套工具治理与参数标准化逻辑。
- */
-export declare function runStandardChatRequestFilters(chatRequest: any, profile: ConversionProfile, context: ConversionContext): Promise<any>;

package/dist/conversion/shared/jsonish.d.ts

@@ -1,3 +0,0 @@
-export declare function tryParseJson<T = unknown>(s: unknown): T | unknown;
-export declare function parseLenient(value: unknown): unknown;
-export declare function repairArgumentsToString(value: unknown): string;

package/dist/conversion/shared/mcp-injection.d.ts

@@ -1,2 +0,0 @@
-export declare function injectMcpToolsForChat(tools: any[] | undefined, discoveredServers: string[]): any[];
-export declare function injectMcpToolsForResponses(tools: any[] | undefined, discoveredServers: string[]): any[];

package/dist/conversion/shared/media.d.ts

@@ -1 +0,0 @@
-export declare function isImagePath(p: unknown): boolean;

package/dist/conversion/shared/openai-finalizer.d.ts

@@ -1,9 +0,0 @@
-type ProcessingMode = 'streaming' | 'non-streaming' | 'auto';
-export interface FinalizeOptions {
-    requestId?: string;
-    endpoint?: string;
-    processingMode?: ProcessingMode;
-    stream?: boolean;
-}
-export declare function finalizeOpenAIChatResponse(chatLike: unknown, opts?: FinalizeOptions): Promise<unknown>;
-export {};

package/dist/conversion/shared/openai-message-normalize.d.ts

@@ -1 +0,0 @@
-export declare function normalizeChatRequest(request: any): any;

package/dist/conversion/shared/payload-budget.d.ts

@@ -1,13 +0,0 @@
-export declare function resolveBudgetForModelSync(modelId: string): {
-    maxBytes: number;
-    safetyRatio: number;
-    allowedBytes: number;
-    source: string;
-};
-export declare const resolveBudgetForModel: (modelId: string) => Promise<{
-    maxBytes: number;
-    safetyRatio: number;
-    allowedBytes: number;
-    source: string;
-}>;
-export declare function enforceChatBudget(chat: any, modelId: string): any;

package/dist/conversion/shared/reasoning-mapping.d.ts

@@ -1,5 +0,0 @@
-export interface ReasoningItem {
-    type: 'reasoning';
-    content: string;
-}
-export declare function mapReasoningContentToResponsesOutput(reasoningContent: any): ReasoningItem[];

package/dist/conversion/shared/responses-instructions.d.ts

@@ -1 +0,0 @@
-export declare function ensureResponsesInstructions(payload: Record<string, unknown>): string | undefined;

package/dist/conversion/shared/responses-metadata.d.ts

@@ -1 +0,0 @@
-export declare const RESPONSES_RAW_SYSTEM_METADATA_KEY = "__rcc_raw_system";

package/dist/conversion/shared/snapshot-hooks.d.ts

@@ -1,12 +0,0 @@
-export interface SnapshotHookOptions {
-    endpoint: string;
-    stage: string;
-    requestId: string;
-    data: unknown;
-    verbosity?: 'minimal' | 'verbose';
-}
-/**
- * Hub pipeline no longer exposes the legacy hooks runtime.
- * Keep a tiny shim so existing callers can continue awaiting the same API surface.
- */
-export declare function writeSnapshotViaHooks(_options: SnapshotHookOptions): Promise<void>;

package/dist/conversion/shared/streaming-text-extractor.d.ts

@@ -1,26 +0,0 @@
-export interface StreamingToolCall {
-    id?: string;
-    type: 'function';
-    function: {
-        name?: string;
-        arguments?: string;
-    };
-}
-export interface StreamingToolExtractorOptions {
-    idPrefix?: string;
-}
-export declare class StreamingTextToolExtractor {
-    private opts;
-    private buffer;
-    private idCounter;
-    private pendingPatch;
-    constructor(opts?: StreamingToolExtractorOptions);
-    reset(): void;
-    feedText(text: string): StreamingToolCall[];
-    private genId;
-    private toToolCall;
-    private tryExtractUnifiedDiffBlocks;
-    private tryExtractFunctionExecuteBlocks;
-    private splitCommand;
-}
-export declare function createStreamingToolExtractor(opts?: StreamingToolExtractorOptions): StreamingTextToolExtractor;

package/dist/conversion/shared/text-markup-normalizer.d.ts

@@ -1,9 +0,0 @@
-export type ToolCallLite = {
-    id?: string;
-    name: string;
-    args: string;
-};
-export declare function extractApplyPatchCallsFromText(text: string): ToolCallLite[] | null;
-export declare function extractExecuteBlocksFromText(text: string): ToolCallLite[] | null;
-export declare function extractXMLToolCallsFromText(text: string): ToolCallLite[] | null;
-export declare function normalizeAssistantTextToToolCalls(message: Record<string, any>): Record<string, any>;

package/dist/conversion/shared/tool-canonicalizer.d.ts

@@ -1,2 +0,0 @@
-export declare function canonicalizeChatResponseTools(payload: unknown): unknown;
-export default canonicalizeChatResponseTools;

package/dist/conversion/shared/tool-filter-pipeline.d.ts

@@ -1,17 +0,0 @@
-import { ToolFilterHints } from '../../filters/index.js';
-interface RequestFilterOptions {
-    entryEndpoint?: string;
-    requestId?: string;
-    model?: string;
-    profile?: string;
-    stream?: boolean;
-    toolFilterHints?: ToolFilterHints;
-}
-interface ResponseFilterOptions {
-    entryEndpoint?: string;
-    requestId?: string;
-    profile?: string;
-}
-export declare function runChatRequestToolFilters(chatRequest: any, options?: RequestFilterOptions): Promise<any>;
-export declare function runChatResponseToolFilters(chatJson: any, options?: ResponseFilterOptions): Promise<any>;
-export {};

package/dist/conversion/shared/tool-governor.d.ts

@@ -1,27 +0,0 @@
-type Unknown = Record<string, unknown>;
-export interface ToolGovernanceOptions {
-    injectGuidance?: boolean;
-    snapshot?: {
-        enabled?: boolean;
-        endpoint?: string;
-        requestId?: string;
-        baseDir?: string;
-    };
-}
-/**
- * Process OpenAI Chat request (messages/tools) with unified 标准 governance.
- * - Augment tools (strict schemas)
- * - Inject/Refine system tool guidance (idempotent)
- * - Canonicalize textual tool markup to tool_calls; set content=null when applicable
- */
-export declare function processChatRequestTools(request: Unknown, opts?: ToolGovernanceOptions): Unknown;
-export declare function processChatResponseTools(resp: Unknown): Unknown;
-export interface GovernContext extends ToolGovernanceOptions {
-    phase: 'request' | 'response';
-    endpoint?: 'chat' | 'responses' | 'messages';
-    stream?: boolean;
-    produceRequiredAction?: boolean;
-    requestId?: string;
-}
-export declare function governTools(payload: Unknown, ctx: GovernContext): Unknown;
-export {};

package/dist/conversion/shared/tool-harvester.d.ts

@@ -1,31 +0,0 @@
-type Unknown = Record<string, unknown>;
-export interface HarvestContext {
-    requestId?: string;
-    idPrefix?: string;
-    chunkSize?: number;
-    source?: 'chat' | 'responses' | 'messages';
-}
-export interface HarvestSignal {
-    type: 'delta' | 'final' | 'compat';
-    payload: Unknown;
-}
-export interface DeltaEvent {
-    tool_calls?: Array<{
-        index: number;
-        id: string;
-        type: 'function';
-        function: {
-            name?: string;
-            arguments?: string;
-        };
-    }>;
-    content?: string;
-    role?: string;
-}
-export interface HarvestResult {
-    deltaEvents: DeltaEvent[];
-    normalized?: Unknown;
-    stats?: Unknown;
-}
-export declare function harvestTools(signal: HarvestSignal, ctx?: HarvestContext): HarvestResult;
-export {};

package/dist/conversion/shared/tooling.d.ts

@@ -1,26 +0,0 @@
-/**
- * Shared helpers for standard tool normalization (shell packing rules).
- * The goal is deterministic, minimal shaping so executors succeed consistently.
- */
-export interface ShellArgs {
-    command: string | string[];
-    workdir?: string;
-    timeout_ms?: number;
-}
-export declare function splitCommandString(input: string): string[];
-/**
- * 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 declare function packShellArgs(input: Record<string, unknown>): Record<string, unknown>;
-export declare function flattenByComma(arr: string[]): string[];
-export declare function chunkString(s: string, minParts?: number, maxParts?: number, targetChunk?: number): string[];

package/dist/conversion/types.d.ts

@@ -1,33 +0,0 @@
-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/core/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * 核心模块导出
- */
-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

@@ -1,9 +0,0 @@
-/**
- * 核心模块导出
- */
-// 核心引擎
-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

@@ -1,132 +0,0 @@
-/**
- * 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;
-}