@jsonstudio/llms 0.4.2 → 0.4.4

package/dist/filters/special/request-tool-choice-policy.d.ts

@@ -1,11 +0,0 @@
-import type { Filter, FilterContext, FilterResult, JsonObject } from '../types.js';
-/**
- * Tool choice policy:
- * - If tools exist and no tool_choice, set tool_choice='auto'
- * - If no tools, remove tool_choice
- */
-export declare class RequestToolChoicePolicyFilter implements Filter<JsonObject> {
-    readonly name = "request_tool_choice_policy";
-    readonly stage: FilterContext['stage'];
-    apply(input: JsonObject): FilterResult<JsonObject>;
-}

package/dist/filters/special/request-tool-list-filter.d.ts

@@ -1,11 +0,0 @@
-import type { Filter, FilterContext, FilterResult, JsonObject } from '../types.js';
-/**
- * RequestToolListFilter (request_pre)
- * - Generic tool-list filter/augment hook
- * - Currently only handles MCP tools with phase-based exposure
- */
-export declare class RequestToolListFilter implements Filter<JsonObject> {
-    readonly name = "request_tool_list_filter";
-    readonly stage: FilterContext['stage'];
-    apply(input: JsonObject): FilterResult<JsonObject>;
-}

package/dist/filters/special/request-toolcalls-stringify.d.ts

@@ -1,10 +0,0 @@
-import type { Filter, FilterContext, FilterResult, JsonObject } from '../types.js';
-/**
- * Ensure assistant.tool_calls[].function.arguments is a JSON string.
- * Also set assistant.content=null when tool_calls exist (request-side invariant).
- */
-export declare class RequestToolCallsStringifyFilter implements Filter<JsonObject> {
-    readonly name = "request_toolcalls_stringify";
-    readonly stage: FilterContext['stage'];
-    apply(input: JsonObject): FilterResult<JsonObject>;
-}

package/dist/filters/special/request-tools-normalize.d.ts

@@ -1,12 +0,0 @@
-import type { Filter, FilterContext, FilterResult, JsonObject } from '../types.js';
-/**
- * Normalize OpenAI tools definitions at the final request stage.
- * - Switches shell parameters schema to TOON ({ toon: string }) when enabled and not heredoc.
- * - Otherwise enforces { command: string | string[], workdir?: string } shape.
- * - Best-effort; never throws.
- */
-export declare class RequestOpenAIToolsNormalizeFilter implements Filter<JsonObject> {
-    readonly name = "request_openai_tools_normalize";
-    readonly stage: FilterContext['stage'];
-    apply(input: JsonObject): Promise<FilterResult<JsonObject>>;
-}

package/dist/filters/special/response-finish-invariants.d.ts

@@ -1,11 +0,0 @@
-import type { Filter, FilterContext, FilterResult, JsonObject } from '../types.js';
-/**
- * Ensure finish_reason and content invariants on response side:
- * - If tool_calls present, finish_reason defaults to 'tool_calls'
- * - If tool_calls present, message.content=null (Chat path)
- */
-export declare class ResponseFinishInvariantsFilter implements Filter<JsonObject> {
-    readonly name = "response_finish_invariants";
-    readonly stage: FilterContext['stage'];
-    apply(input: JsonObject): FilterResult<JsonObject>;
-}

package/dist/filters/special/response-openai-to-responses-bridge.d.ts

@@ -1,13 +0,0 @@
-import type { Filter, FilterContext, JsonObject, FilterResult } from '../types.js';
-/**
- * ResponseOpenAIToResponsesBridgeFilter
- * - 将 OpenAI Chat 形状的响应桥接为 OpenAI Responses 形状
- * - 与 Anthropic 并行：使用 filter 进行形状/协议转换（而非 endpoint 分支）
- * - 阶段：response_post（在基础规范化之后执行）
- */
-export declare class ResponseOpenAIToResponsesBridgeFilter implements Filter<JsonObject> {
-    readonly name = "response_openai_to_responses_bridge";
-    readonly stage: FilterContext['stage'];
-    apply(input: JsonObject, ctx: FilterContext): Promise<FilterResult<JsonObject>>;
-}
-export default ResponseOpenAIToResponsesBridgeFilter;

package/dist/filters/special/response-tool-arguments-blacklist.d.ts

@@ -1,12 +0,0 @@
-import type { Filter, FilterContext, FilterResult, JsonObject } from '../types.js';
-/**
- * ResponseToolArgumentsBlacklistFilter
- * - Remove keys listed in ROUTECODEX_TOOLARGS_BLACKLIST from tool_calls[].function.arguments (after decode).
- * - Default: empty blacklist (no-op). Enables incremental hardening without risking valid params.
- * Stage: response_pre
- */
-export declare class ResponseToolArgumentsBlacklistFilter implements Filter<JsonObject> {
-    readonly name = "response_tool_arguments_blacklist";
-    readonly stage: FilterContext['stage'];
-    apply(input: JsonObject): FilterResult<JsonObject>;
-}

package/dist/filters/special/response-tool-arguments-schema-converge.d.ts

@@ -1,13 +0,0 @@
-import type { Filter, FilterContext, FilterResult, JsonObject } from '../types.js';
-/**
- * ResponseToolArgumentsSchemaConvergeFilter
- * - If tool schemas are available on context (context.toolSchemas[name] = JSONSchema),
- *   keep only keys defined in schema.properties for each tool call arguments.
- * - Does not validate or coerce types; only converges keys to schema surface.
- * - Stage: response_pre
- */
-export declare class ResponseToolArgumentsSchemaConvergeFilter implements Filter<JsonObject> {
-    readonly name = "response_tool_arguments_schema_converge";
-    readonly stage: FilterContext['stage'];
-    apply(input: JsonObject, context?: FilterContext): FilterResult<JsonObject>;
-}

package/dist/filters/special/response-tool-arguments-stringify.d.ts

@@ -1,9 +0,0 @@
-import type { Filter, FilterContext, FilterResult, JsonObject } from '../types.js';
-/**
- * Ensure choices[*].message.tool_calls[].function.arguments is a JSON string.
- */
-export declare class ResponseToolArgumentsStringifyFilter implements Filter<JsonObject> {
-    readonly name = "response_tool_arguments_stringify";
-    readonly stage: FilterContext['stage'];
-    apply(input: JsonObject): FilterResult<JsonObject>;
-}

package/dist/filters/special/response-tool-arguments-toon-decode.d.ts

@@ -1,10 +0,0 @@
-import type { Filter, FilterContext, FilterResult, JsonObject } from '../types.js';
-/**
- * Decode arguments.toon to standard JSON ({command, workdir?}) and map tool name 'shell_toon' → 'shell'.
- * Stage: response_pre (before arguments stringify and invariants).
- */
-export declare class ResponseToolArgumentsToonDecodeFilter implements Filter<JsonObject> {
-    readonly name = "response_tool_arguments_toon_decode";
-    readonly stage: FilterContext['stage'];
-    apply(input: JsonObject): FilterResult<JsonObject>;
-}

package/dist/filters/special/response-tool-arguments-whitelist.d.ts

@@ -1,11 +0,0 @@
-import type { Filter, FilterContext, FilterResult, JsonObject } from '../types.js';
-/**
- * Whitelist tool function arguments keys after decode to match schema (e.g., keep only 'command'/'workdir').
- * Stage: response_pre. Runs after TOON decode and before stringify.
- */
-export declare class ResponseToolArgumentsWhitelistFilter implements Filter<JsonObject> {
-    readonly name = "response_tool_arguments_whitelist";
-    readonly stage: FilterContext['stage'];
-    private getWhitelist;
-    apply(input: JsonObject, context?: FilterContext): FilterResult<JsonObject>;
-}

package/dist/filters/special/response-tool-text-canonicalize.d.ts

@@ -1,10 +0,0 @@
-import type { Filter, FilterContext, FilterResult, JsonObject } from '../types.js';
-/**
- * Canonicalize assistant textual tool markup into tool_calls (Chat path).
- * Wrapper around existing canonicalizer to fit the Filter pipeline.
- */
-export declare class ResponseToolTextCanonicalizeFilter implements Filter<JsonObject> {
-    readonly name = "response_tool_text_canonicalize";
-    readonly stage: FilterContext['stage'];
-    apply(input: JsonObject): FilterResult<JsonObject>;
-}

package/dist/filters/special/tool-filter-hooks.d.ts

@@ -1,19 +0,0 @@
-import type { Filter, FilterContext, FilterResult, JsonObject } from '../types.js';
-interface ToolFilterConfigCategoryPolicy {
-    mode?: 'allow' | 'block' | 'require_content';
-    requireContentTypes?: string[];
-}
-interface ToolFilterConfig {
-    categories?: {
-        vision?: ToolFilterConfigCategoryPolicy;
-        mcp?: ToolFilterConfigCategoryPolicy;
-    };
-}
-export declare function setGlobalToolFilterConfig(cfg: ToolFilterConfig | undefined): void;
-export declare function getGlobalToolFilterConfig(): ToolFilterConfig;
-export declare class ToolFilterHookFilter implements Filter<JsonObject> {
-    readonly name = "tool_filter_hook";
-    readonly stage: FilterContext['stage'];
-    apply(input: JsonObject, ctx: FilterContext): FilterResult<JsonObject>;
-}
-export {};

package/dist/filters/special/tool-post-constraints.d.ts

@@ -1,31 +0,0 @@
-import type { Filter, FilterContext, FilterResult, JsonObject } from '../types.js';
-type ConstraintMatchCondition = 'missing' | 'empty' | 'missingOrEmpty';
-interface ToolConstraintRule {
-    id: string;
-    direction: 'request' | 'response' | 'both';
-    providerProtocol?: string;
-    providerId?: string;
-    modelId?: string;
-    toolNamePattern?: string;
-    path: string;
-    when: ConstraintMatchCondition;
-    action: 'warn' | 'patch' | 'drop';
-    patchText?: string;
-}
-interface ToolGovernanceConstraintsConfig {
-    rules: ToolConstraintRule[];
-}
-/**
- * Tool post-constraints filter（请求/响应阶段的最后一小步约束）：
- * - 默认只记录（warn），不修改 payload；
- * - 修剪/修复行为完全由配置驱动（ToolGovernanceConstraintsConfig）；
- * - 当前仅实现缺失/空 description 的简单场景，后续可按配置扩展。
- */
-export declare class ToolPostConstraintsFilter implements Filter<JsonObject> {
-    readonly name = "tool_post_constraints";
-    readonly stage: FilterContext['stage'];
-    private readonly config;
-    constructor(stage: FilterContext['stage'], config?: ToolGovernanceConstraintsConfig);
-    apply(input: JsonObject, ctx: FilterContext): FilterResult<JsonObject>;
-}
-export {};

package/dist/filters/types.d.ts

@@ -1,68 +0,0 @@
-export type JsonObject = Record<string, unknown>;
-export type FilterStage = 'request_pre' | 'request_map' | 'request_post' | 'request_finalize' | 'response_pre' | 'response_map' | 'response_post' | 'response_finalize';
-export interface FilterContext {
-    requestId?: string;
-    model?: string;
-    endpoint?: string;
-    provider?: string;
-    profile?: string;
-    stage: FilterStage;
-    stream?: boolean;
-    toolFilterHints?: ToolFilterHints;
-    debug?: {
-        emit?: (event: string, data: unknown) => void;
-    };
-}
-export interface FilterResult<T = JsonObject> {
-    ok: boolean;
-    data: T;
-    warnings?: string[];
-    metrics?: Record<string, unknown>;
-}
-export interface Filter<T = JsonObject> {
-    readonly name: string;
-    readonly stage: FilterStage;
-    apply(input: T, ctx: FilterContext): Promise<FilterResult<T>> | FilterResult<T>;
-}
-export type ToolFilterAction = 'allow' | 'block' | 'rewrite';
-export interface ToolFilterDecision {
-    name: string;
-    action: ToolFilterAction;
-    reason?: string;
-    category?: string;
-}
-export interface ToolFilterHints {
-    requestedDecisions?: ToolFilterDecision[];
-    categories?: {
-        vision?: boolean;
-        mcp?: boolean;
-        webSearch?: boolean;
-        codeExecution?: boolean;
-        fileSearch?: boolean;
-        dataAnalysis?: boolean;
-    };
-    categoryOverrides?: {
-        vision?: 'allow' | 'block' | 'require_content';
-        mcp?: 'allow' | 'block';
-    };
-    decided?: ToolFilterDecision[];
-}
-export interface FieldMapRule {
-    sourcePath: string;
-    targetPath: string;
-    type?: 'string' | 'number' | 'boolean' | 'object' | 'array';
-    transform?: string;
-}
-export interface FieldMapConfig {
-    request?: FieldMapRule[];
-    response?: FieldMapRule[];
-}
-export interface WhitelistConfig {
-    allow: string[];
-}
-export interface BlacklistConfig {
-    deny: string[];
-}
-export interface AddFieldsConfig {
-    fields: Record<string, unknown>;
-}

package/dist/filters/utils/fieldmap-loader.d.ts

@@ -1,2 +0,0 @@
-import type { FieldMapConfig } from '../types.js';
-export declare function loadFieldMapConfig(relativeJsonPath: string): Promise<FieldMapConfig | null>;

package/dist/filters/utils/snapshot-writer.d.ts

@@ -1,10 +0,0 @@
-import type { FilterStage } from '../types.js';
-export declare function writeFilterSnapshot(options: {
-    requestId?: string;
-    endpoint?: string;
-    profile?: string;
-    stage: FilterStage;
-    name?: string;
-    tag?: string;
-    data: unknown;
-}): Promise<void>;

package/dist/guidance/index.d.ts

@@ -1,3 +0,0 @@
-export declare function augmentOpenAITools(tools: unknown[]): unknown[];
-export declare function augmentAnthropicTools(tools: unknown[]): unknown[];
-export declare function buildSystemToolGuidance(): string;

package/dist/hooks/hooks-integration.d.ts

@@ -1,161 +0,0 @@
-/**
- * LLMSwitch V2 Hooks 集成器（业务命名）
- *
- * 集成现有2hooks系统到LLMSwitch V2架构
- */
-import type { LLMSwitchHookContext, LLMSwitchProcessingResult, EndpointType, ProtocolType, ProcessingMode } from '../api/llmswitch-types.js';
-import { LLMSwitchHookStage } from '../api/llmswitch-types.js';
-/**
- * Hook执行结果
- */
-export interface HookExecutionResult {
-    success: boolean;
-    data?: any;
-    results?: any[];
-    error?: Error;
-}
-/**
- * Hook适配器配置
- */
-export interface HooksIntegrationConfig {
-    enabled: boolean;
-    timeout: number;
-    retryAttempts: number;
-    parallel: boolean;
-    snapshot: {
-        enabled: boolean;
-        level?: 'verbose' | 'normal' | 'silent';
-        basePath: string;
-        endpointIsolation: {
-            enabled: boolean;
-            pathStructure: 'endpoint/date' | 'endpoint/request' | 'endpoint/timestamp';
-        };
-    };
-    modulePolicies?: Record<string, {
-        enabled?: boolean;
-        snapshotEnabled?: boolean;
-        level?: 'verbose' | 'normal' | 'silent';
-    }>;
-}
-/**
- * Hook执行上下文构建器
- */
-export declare class HookContextBuilder {
-    /**
-     * 构建Hook执行上下文
-     */
-    static buildContext(stage: LLMSwitchHookStage, endpoint: EndpointType, originalProtocol: ProtocolType, targetProtocol: ProtocolType, pathIdentifier: string, processingMode: ProcessingMode, hookSequence: number, totalHooks: number, additionalData?: Record<string, any>): LLMSwitchHookContext;
-    /**
-     * 生成执行ID
-     */
-    private static generateExecutionId;
-}
-/**
- * 快照服务配置
- */
-export interface SnapshotServiceConfig {
-    enabled: boolean;
-    level?: 'verbose' | 'normal' | 'silent';
-    basePath: string;
-    endpointIsolation: {
-        enabled: boolean;
-        pathStructure: 'endpoint/date' | 'endpoint/request' | 'endpoint/timestamp';
-    };
-}
-/**
- * 简化的快照服务
- */
-export declare class SnapshotService {
-    private config;
-    constructor(config: SnapshotServiceConfig);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    saveSnapshot(path: string, data: any): Promise<void>;
-    getStats(): any;
-}
-/**
- * Hook管理器（简化实现）
- */
-export declare class HookManager {
-    private handlers;
-    registerHandler(stage: string, handler: Function): void;
-    executeHook(stage: string, params: any): Promise<HookExecutionResult>;
-    getStats(): any;
-    clear(): void;
-}
-/**
- * LLMSwitch V2 Hooks适配器
- */
-export declare class HooksIntegration {
-    private hookManager;
-    private snapshotService;
-    private config;
-    private modulePolicies;
-    constructor(config: HooksIntegrationConfig);
-    /**
-     * 初始化Hook适配器
-     */
-    initialize(): Promise<void>;
-    /**
-     * 执行Hook
-     */
-    executeHook(stage: LLMSwitchHookStage, context: LLMSwitchHookContext, data?: any): Promise<LLMSwitchProcessingResult>;
-    /**
-     * 批量执行Hooks
-     */
-    executeHooks(stages: LLMSwitchHookStage[], context: LLMSwitchHookContext, data?: any): Promise<LLMSwitchProcessingResult[]>;
-    /**
-     * 注册Hook处理器
-     */
-    registerHookHandler(stage: LLMSwitchHookStage, handler: Function): void;
-    /**
-     * 获取Hook统计信息
-     */
-    getHookStats(): Record<string, any>;
-    /**
-     * 获取快照统计信息
-     */
-    getSnapshotStats(): Record<string, any>;
-    /**
-     * 执行Hook的核心逻辑
-     */
-    private performHookExecution;
-    /**
-     * 处理快照
-     */
-    private handleSnapshot;
-    /**
-     * 构建快照路径
-     */
-    private buildSnapshotPath;
-    private static loadModulePoliciesFromEnv;
-    /**
-     * 启动适配器
-     */
-    start(): Promise<void>;
-    /**
-     * 停止适配器
-     */
-    stop(): Promise<void>;
-    /**
-     * 销毁适配器
-     */
-    destroy(): Promise<void>;
-}
-/**
- * 创建Hook适配器的工厂函数
- */
-export declare function createHooksIntegration(config?: Partial<HooksIntegrationConfig>): HooksIntegration;
-/**
- * Lightweight helper: write a snapshot using the same SnapshotService and
- * path conventions as HooksIntegration, without requiring a live hooks
- * pipeline. Intended for external callers (server/provider/compat) that
- * want to unify snapshot emission through the core hooks system.
- */
-export declare function writeSnapshotViaHooks(options: {
-    endpoint: string;
-    stage: string;
-    requestId: string;
-    data: any;
-    verbosity?: 'verbose' | 'normal' | 'silent';
-}): Promise<void>;