@jsonstudio/llms 0.4.2 → 0.4.4

package/dist/conversion/responses/responses-openai-bridge.d.ts

@@ -1,95 +0,0 @@
-export type ResponsesContentPart = {
-    type: string;
-    text?: string;
-    content?: unknown;
-};
-export type ResponsesInputItem = {
-    type: string;
-    role?: string;
-    content?: Array<ResponsesContentPart> | null;
-    name?: string;
-    arguments?: unknown;
-    call_id?: string;
-    output?: unknown;
-    function?: {
-        name?: string;
-        arguments?: unknown;
-    };
-    message?: {
-        role?: string;
-        content?: Array<ResponsesContentPart>;
-    };
-    id?: string;
-    tool_call_id?: string;
-    tool_use_id?: string;
-    text?: string;
-};
-export type ResponsesToolDefinition = {
-    type: string;
-    name?: string;
-    description?: string;
-    strict?: boolean;
-    parameters?: unknown;
-};
-export interface ResponsesRequestContext {
-    requestId?: string;
-    instructions?: string;
-    originalSystemMessages?: string[];
-    input?: ResponsesInputItem[];
-    include?: unknown;
-    store?: unknown;
-    toolChoice?: unknown;
-    parallelToolCalls?: boolean;
-    metadata?: Record<string, unknown> | undefined;
-    responseFormat?: unknown;
-    stream?: boolean;
-    instructionsIsRaw?: boolean;
-    isChatPayload?: boolean;
-    isResponsesPayload?: boolean;
-    historyMessages?: Array<{
-        role: string;
-        content: string;
-    }>;
-    currentMessage?: {
-        role: string;
-        content: string;
-    } | null;
-    toolsRaw?: ResponsesToolDefinition[];
-    toolsNormalized?: Array<Record<string, unknown>>;
-}
-export interface BuildChatRequestResult {
-    request: Record<string, unknown>;
-    toolsNormalized?: Array<Record<string, unknown>>;
-}
-export interface BuildResponsesRequestResult {
-    request: Record<string, unknown>;
-    originalSystemMessages?: string[];
-}
-export declare function captureResponsesContext(payload: Record<string, unknown>, dto?: {
-    route?: {
-        requestId?: string;
-    };
-}): ResponsesRequestContext;
-export declare function buildChatRequestFromResponses(payload: Record<string, unknown>, context: ResponsesRequestContext): BuildChatRequestResult;
-/**
- * Chat 请求 → Responses 请求（非流），用于 V3 process=chat 且 providerWire=responses 的请求编码。
- *
- * 设计目标：
- *  - 保留 model / tools / tool_choice / parallel_tool_calls 等字段；
- *  - 将 system 消息折叠到 instructions；
- *  - 将 user/assistant/tool 消息编码为 input[] 中的 message 块，使得 mapResponsesInputToChat 能够还原为等价 Chat 请求。
- */
-export declare function buildResponsesRequestFromChat(payload: Record<string, unknown>, ctx?: ResponsesRequestContext): BuildResponsesRequestResult;
-export declare function buildResponsesPayloadFromChat(payload: unknown, context?: ResponsesRequestContext): Record<string, unknown> | unknown;
-export declare function extractRequestIdFromResponse(response: any): string | undefined;
-/**
- * 将非流式 ResponsesResponse 形状还原为等价的 ChatResponse 形状（用于闭环测试）。
- *
- *  - id / model / created(_at) / usage → 直接透传
- *  - output_text / output[] → choices[0].message.content
- *  - required_action.submit_tool_outputs.tool_calls → choices[0].message.tool_calls
- *  - finish_reason：metadata.finish_reason 优先，其次 status/tool_calls 推断
- *
- * 若 payload 已是 ChatCompletion 形状，则直接返回。
- */
-export declare function buildChatResponseFromResponses(payload: unknown): Record<string, unknown> | unknown;

package/dist/conversion/schema-validator.d.ts

@@ -1,7 +0,0 @@
-export declare class SchemaValidator {
-    private readonly baseDir;
-    private readonly cache;
-    constructor(baseDir?: string);
-    validate(schemaPath: string | undefined, payload: unknown, context: string): Promise<void>;
-    private getValidator;
-}

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

@@ -1,18 +0,0 @@
-export type Unknown = Record<string, unknown>;
-export interface NormalizeResult<T = Record<string, unknown>> {
-    ok: boolean;
-    value?: T;
-    errors?: string[];
-}
-type JsonSchema = {
-    type?: string | string[];
-    properties?: Record<string, JsonSchema & {
-        ['x-aliases']?: string[];
-    }>;
-    required?: string[];
-    items?: JsonSchema;
-    additionalProperties?: boolean;
-};
-export declare function normalizeArgsBySchema(input: any, schema?: JsonSchema): NormalizeResult;
-export declare function normalizeTools(tools: any[]): Unknown[];
-export {};

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-conversation-store.d.ts

@@ -1,41 +0,0 @@
-import type { ResponsesRequestContext } from './responses-request-adapter.js';
-declare class ResponsesConversationStore {
-    private requestMap;
-    private responseIndex;
-    captureRequestContext(args: {
-        requestId: string;
-        payload: Record<string, unknown>;
-        context: ResponsesRequestContext;
-    }): void;
-    recordResponse(args: {
-        requestId: string;
-        response: Record<string, unknown>;
-    }): void;
-    resumeConversation(responseId: string, submitPayload: Record<string, unknown>, options?: {
-        requestId?: string;
-    }): {
-        payload: Record<string, unknown>;
-        meta: Record<string, unknown>;
-    };
-    clearRequest(requestId: string): void;
-    private cleanupEntry;
-    private prune;
-}
-export declare const responsesConversationStore: ResponsesConversationStore;
-export declare function captureResponsesRequestContext(args: {
-    requestId: string;
-    payload: Record<string, unknown>;
-    context: ResponsesRequestContext;
-}): void;
-export declare function recordResponsesResponse(args: {
-    requestId: string;
-    response: Record<string, unknown>;
-}): void;
-export declare function resumeResponsesConversation(responseId: string, submitPayload: Record<string, unknown>, options?: {
-    requestId?: string;
-}): {
-    payload: Record<string, unknown>;
-    meta: Record<string, unknown>;
-};
-export declare function clearResponsesConversationByRequestId(requestId: string): void;
-export {};

package/dist/conversion/shared/responses-id-utils.d.ts

@@ -1,7 +0,0 @@
-type NormalizeOptions = {
-    callId?: string;
-    fallback?: string;
-};
-export declare function normalizeFunctionCallId(options: NormalizeOptions): string;
-export declare function normalizeFunctionCallOutputId(options: NormalizeOptions): string;
-export {};

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/responses-request-adapter.d.ts

@@ -1,66 +0,0 @@
-export type ResponsesContentPart = {
-    type: string;
-    text?: string;
-    content?: unknown;
-};
-export type ResponsesInputItem = {
-    type: string;
-    role?: string;
-    content?: Array<ResponsesContentPart> | null;
-    name?: string;
-    arguments?: unknown;
-    call_id?: string;
-    output?: unknown;
-    function?: {
-        name?: string;
-        arguments?: unknown;
-    };
-    message?: {
-        role?: string;
-        content?: Array<ResponsesContentPart>;
-    };
-    id?: string;
-    tool_call_id?: string;
-    tool_use_id?: string;
-    text?: string;
-};
-export type ResponsesToolDefinition = {
-    type: string;
-    name?: string;
-    description?: string;
-    strict?: boolean;
-    parameters?: unknown;
-    function?: {
-        name?: string;
-        description?: string;
-        strict?: boolean;
-        parameters?: unknown;
-    };
-};
-export interface ResponsesRequestContext {
-    requestId?: string;
-    instructions?: string;
-    originalSystemMessages?: string[];
-    input?: ResponsesInputItem[];
-    include?: unknown;
-    store?: unknown;
-    toolChoice?: unknown;
-    parallelToolCalls?: boolean;
-    metadata?: Record<string, unknown>;
-    responseFormat?: unknown;
-    toolsRaw?: ResponsesToolDefinition[];
-    stream?: boolean;
-    instructionsIsRaw?: boolean;
-    isChatPayload?: boolean;
-    isResponsesPayload?: boolean;
-}
-export interface BuildChatRequestResult {
-    request: Record<string, unknown>;
-    toolsNormalized?: Array<Record<string, unknown>>;
-}
-export declare function captureResponsesContext(payload: Record<string, unknown>, dto?: {
-    route?: {
-        requestId?: string;
-    };
-}): ResponsesRequestContext;
-export declare function buildChatRequestFromResponses(payload: Record<string, unknown>, context: ResponsesRequestContext): BuildChatRequestResult;

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/tool-mapping.d.ts

@@ -1,10 +0,0 @@
-export interface ToolCallFunction {
-    name: string;
-    arguments: string;
-}
-export interface ToolCallItem {
-    id?: string;
-    type: 'function';
-    function: ToolCallFunction;
-}
-export declare function stringifyArgs(args: unknown): string;

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;
-}