@jsonstudio/llms 0.4.2 → 0.4.4

package/dist/sse/sse-to-json/builders/response-builder.d.ts

@@ -1,165 +0,0 @@
-/**
- * Responses响应构建器
- * 负责状态机和事件聚合，从SSE事件构建完整的Responses响应对象
- */
-import { ResponsesSseEvent, ResponsesResponse } from '../../types/index.js';
-export type ResponseBuilderState = 'initial' | 'building' | 'completed' | 'error';
-export interface ResponseBuilderConfig {
-    enableStrictValidation: boolean;
-    enableEventRecovery: boolean;
-    maxOutputItems: number;
-    maxContentParts: number;
-    maxSequenceGaps: number;
-}
-export interface OutputItemState {
-    id: string;
-    type: string;
-    status: 'in_progress' | 'completed';
-    contentParts: any[];
-    currentContentIndex: number;
-    accumulatedContent: any[];
-    hasContentPartAdded: boolean;
-    isTextInProgress: boolean;
-    callId?: string;
-    name?: string;
-    arguments?: string;
-    role?: string;
-    startTime: number;
-    lastEventTime: number;
-}
-export declare const DEFAULT_RESPONSE_BUILDER_CONFIG: ResponseBuilderConfig;
-/**
- * Responses响应构建器
- */
-export declare class ResponsesResponseBuilder {
-    private state;
-    private response;
-    private outputItemBuilders;
-    private lastSequenceNumber;
-    private config;
-    private error?;
-    constructor(config?: Partial<ResponseBuilderConfig>);
-    /**
-     * 处理SSE事件
-     */
-    processEvent(event: ResponsesSseEvent): boolean;
-    /**
-     * 验证序列号
-     */
-    private validateSequenceNumber;
-    /**
-     * 处理response.start事件
-     */
-    private handleResponseStart;
-    private handleResponseCreated;
-    private handleResponseInProgress;
-    /**
-     * 处理output_item.start事件
-     */
-    private handleOutputItemStart;
-    private mapOutputItemAdded;
-    /**
-     * 处理content_part.start事件
-     */
-    private handleContentPartStart;
-    private mapContentPartAdded;
-    /**
-     * 处理content_part.delta事件
-     */
-    private handleContentPartDelta;
-    private mapOutputTextDelta;
-    /**
-     * 处理content_part.done事件
-     */
-    private handleContentPartDone;
-    private mapContentPartDone;
-    /**
-     * 处理function_call.start事件
-     */
-    private handleFunctionCallStart;
-    /**
-     * 处理function_call.delta事件
-     */
-    private handleFunctionCallDelta;
-    private mapFunctionCallDelta;
-    /**
-     * 处理function_call.done事件
-     */
-    private handleFunctionCallDone;
-    private mapFunctionCallDone;
-    /**
-     * 处理reasoning.start事件
-     */
-    private handleReasoningStart;
-    /**
-     * 处理reasoning.delta事件
-     */
-    private handleReasoningDelta;
-    private mapReasoningDelta;
-    private mapReasoningDone;
-    /**
-     * 处理reasoning.done事件
-     */
-    private handleReasoningDone;
-    /**
-     * 处理output_item.done事件
-     */
-    private handleOutputItemDone;
-    /**
-     * 处理required_action事件
-     */
-    private handleRequiredAction;
-    /**
-     * 处理response.done事件
-     */
-    private handleResponseDone;
-    /**
-     * 处理错误事件
-     */
-    private handleError;
-    private handleResponseCompleted;
-    /**
-     * 构建输出项列表
-     */
-    private buildOutputItems;
-    /**
-     * 构建消息项
-     */
-    private buildMessageItem;
-    /**
-     * 构建函数调用项
-     */
-    private buildFunctionCallItem;
-    /**
-     * 构建推理项
-     */
-    private buildReasoningItem;
-    /**
-     * 获取构建结果
-     */
-    getResult(): {
-        success: boolean;
-        response?: ResponsesResponse;
-        error?: Error;
-    };
-    /**
-     * 获取当前状态
-     */
-    getState(): ResponseBuilderState;
-    /**
-     * 重置构建器
-     */
-    reset(): void;
-    /**
-     * 获取输出项构建器
-     */
-    getOutputItemBuilders(): Map<string, OutputItemState>;
-    /**
-     * 获取最后序列号
-     */
-    getLastSequenceNumber(): number;
-}
-/**
- * 创建响应构建器工厂
- */
-export declare function createResponseBuilder(config?: Partial<ResponseBuilderConfig>): ResponsesResponseBuilder;

package/dist/sse/sse-to-json/chat-sse-to-json-converter.d.ts

@@ -1,106 +0,0 @@
-/**
- * Chat SSE → JSON转换器
- * 将SSE事件流聚合为ChatCompletion响应
- */
-import { ChatCompletionResponse, ChatSseEvent, SseToChatJsonOptions, ChatEventStats, DEFAULT_CHAT_CONVERSION_CONFIG } from '../types/index.js';
-/**
- * Chat SSE到JSON转换器
- */
-export declare class ChatSseToJsonConverter {
-    private config;
-    private contexts;
-    constructor(config?: Partial<typeof DEFAULT_CHAT_CONVERSION_CONFIG>);
-    /**
-     * 将SSE流转换为Chat Completion响应
-     */
-    convertSseToJson(sseStream: AsyncIterable<ChatSseEvent> | AsyncIterable<string | Buffer>, options: SseToChatJsonOptions): Promise<ChatCompletionResponse>;
-    /**
-     * 将SSE流转换为流式响应
-     */
-    aggregateSseStream(sseStream: AsyncIterable<ChatSseEvent> | AsyncIterable<string | Buffer>, options: SseToChatJsonOptions): AsyncGenerator<ChatCompletionResponse>;
-    /**
-     * 确保输入流转换为 ChatSseEvent 流
-     */
-    private ensureEventStream;
-    /**
-     * 将SSE文本块解析为Chat事件
-     */
-    private parseSseChunk;
-    /**
-     * 创建转换上下文
-     */
-    private createContext;
-    /**
-     * 处理SSE事件
-     */
-    private processSseEvent;
-    /**
-     * 处理chat_chunk事件
-     */
-    private processChatChunk;
-    /**
-     * 处理choice
-     */
-    private processChoice;
-    /**
-     * 创建choice构建器
-     */
-    private createChoiceBuilder;
-    /**
-     * 处理delta
-     */
-    private processDelta;
-    /**
-     * 处理tool_call delta
-     */
-    private processToolCallDelta;
-    /**
-     * 更新响应中的choice
-     */
-    private updateResponseChoice;
-    /**
-     * 处理done事件
-     */
-    private processDoneEvent;
-    /**
-     * 处理error事件
-     */
-    private processErrorEvent;
-    /**
-     * 构建部分响应
-     */
-    private buildPartialResponse;
-    /**
-     * 完成响应构建
-     */
-    private finalizeResponse;
-    /**
-     * 构建使用量信息
-     */
-    private buildUsageInfo;
-    /**
-     * 验证SSE事件
-     */
-    private validateSseEvent;
-    /**
-     * 验证Chat chunk
-     */
-    private validateChatChunk;
-    /**
-     * 更新统计信息
-     */
-    private updateStats;
-    /**
-     * 获取转换统计
-     */
-    getStats(requestId: string): ChatEventStats | undefined;
-    /**
-     * 清理上下文
-     */
-    cleanup(requestId: string): void;
-    /**
-     * 清理所有上下文
-     */
-    cleanupAll(): void;
-}
-export declare const defaultChatSseToJsonConverter: ChatSseToJsonConverter;

package/dist/sse/sse-to-json/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * SSE→JSON转换模块导出
- */
-export { ChatSseToJsonConverter, defaultChatSseToJsonConverter } from './chat-sse-to-json-converter.js';
-export { ResponsesSseToJsonConverterRefactored as ResponsesSseToJsonConverter } from './responses-sse-to-json-converter.js';
-export type { SseToChatJsonOptions, SseToChatJsonContext, ChatEventStats, SseToResponsesJsonOptions, SseToResponsesJsonContext, ResponsesEventStats } from '../types/index.js';

package/dist/sse/sse-to-json/parsers/sse-parser.d.ts

@@ -1,73 +0,0 @@
-/**
- * SSE事件解析器
- * 负责将SSE文本帧解析为标准化的SSE事件对象
- */
-import { BaseSseEvent } from '../../types/index.js';
-export interface SseParserConfig {
-    enableStrictValidation: boolean;
-    enableEventRecovery: boolean;
-    maxEventSize: number;
-    allowedEventTypes: Set<string>;
-}
-export interface SseParseResult {
-    success: boolean;
-    event?: BaseSseEvent;
-    error?: string;
-    rawData: string;
-}
-export declare const DEFAULT_SSE_PARSER_CONFIG: SseParserConfig;
-/**
- * SSE原始事件数据
- */
-export interface RawSseEvent {
-    id?: string;
-    event: string;
-    data: string;
-    retry?: string;
-    timestamp?: number;
-}
-/**
- * 将原始SSE行组装为事件
- */
-export declare function assembleSseEvent(lines: string[]): RawSseEvent | null;
-/**
- * 解析SSE事件文本为标准化事件对象
- */
-export declare function parseSseEvent(sseText: string, config?: SseParserConfig): SseParseResult;
-/**
- * 解析SSE流（处理多事件数据）
- */
-export declare function parseSseStream(sseData: string, config?: SseParserConfig): Generator<SseParseResult>;
-/**
- * 流式解析SSE数据
- */
-export declare function parseSseStreamAsync(asyncSseData: AsyncIterable<string>, config?: SseParserConfig): AsyncGenerator<SseParseResult>;
-/**
- * 创建SSE解析器工厂
- */
-export declare function createSseParser(config?: Partial<SseParserConfig>): {
-    /**
-     * 解析单个事件
-     */
-    parseEvent(sseText: string): SseParseResult;
-    /**
-     * 解析多事件流
-     */
-    parseStream(sseData: string): Generator<SseParseResult>;
-    /**
-     * 异步解析流
-     */
-    parseStreamAsync(asyncSseData: AsyncIterable<string>): AsyncGenerator<SseParseResult>;
-    /**
-     * 获取当前配置
-     */
-    getConfig(): SseParserConfig;
-    /**
-     * 添加允许的事件类型
-     */
-    addEventType(eventType: string): void;
-    /**
-     * 移除允许的事件类型
-     */
-    removeEventType(eventType: string): void;
-};

package/dist/sse/types/anthropic-types.d.ts

@@ -1,87 +0,0 @@
-/**
- * Minimal Anthropic SSE/JSON types for v3 SSE converters
- * Only covers text and basic tool_use blocks needed for roundtrip.
- */
-export interface AnthropicContentTextBlock {
-    type: 'text';
-    text: string;
-}
-export interface AnthropicContentToolUseBlock {
-    type: 'tool_use';
-    id: string;
-    name: string;
-    input: Record<string, unknown>;
-}
-export interface AnthropicContentToolResultBlock {
-    type: 'tool_result';
-    tool_use_id: string;
-    content: unknown;
-    is_error?: boolean;
-}
-export type AnthropicContentBlock = AnthropicContentTextBlock | AnthropicContentToolUseBlock | AnthropicContentToolResultBlock;
-export interface AnthropicMessageResponse {
-    id: string;
-    type: 'message';
-    role: 'assistant' | 'user';
-    model: string;
-    content: AnthropicContentBlock[];
-    usage?: {
-        input_tokens?: number;
-        output_tokens?: number;
-    };
-    stop_reason?: 'end_turn' | 'max_tokens' | 'stop_sequence' | 'tool_use';
-}
-export type AnthropicSseEventType = 'message_start' | 'content_block_start' | 'content_block_delta' | 'content_block_stop' | 'message_delta' | 'message_stop';
-export interface AnthropicSseEventBase<T extends AnthropicSseEventType = AnthropicSseEventType> {
-    type: T;
-}
-export interface AnthropicSseEventMessageStart extends AnthropicSseEventBase<'message_start'> {
-    message: {
-        id: string;
-        type: 'message';
-        role: 'assistant';
-        model: string;
-    };
-}
-export interface AnthropicSseEventContentBlockStart extends AnthropicSseEventBase<'content_block_start'> {
-    index: number;
-    content_block: {
-        type: 'text';
-        text?: string;
-    } | {
-        type: 'tool_use';
-        id: string;
-        name: string;
-        input?: Record<string, unknown>;
-    };
-}
-export interface AnthropicSseEventContentBlockDelta extends AnthropicSseEventBase<'content_block_delta'> {
-    index: number;
-    delta: {
-        type: 'text_delta';
-        text: string;
-    } | {
-        type: 'input_json_delta';
-        partial_json: string;
-    };
-}
-export interface AnthropicSseEventContentBlockStop extends AnthropicSseEventBase<'content_block_stop'> {
-    index: number;
-}
-export interface AnthropicSseEventMessageDelta extends AnthropicSseEventBase<'message_delta'> {
-    delta?: {
-        stop_reason?: AnthropicMessageResponse['stop_reason'];
-    };
-}
-export interface AnthropicSseEventMessageStop extends AnthropicSseEventBase<'message_stop'> {
-}
-export type AnthropicSseEvent = AnthropicSseEventMessageStart | AnthropicSseEventContentBlockStart | AnthropicSseEventContentBlockDelta | AnthropicSseEventContentBlockStop | AnthropicSseEventMessageDelta | AnthropicSseEventMessageStop;
-export type AnthropicSseEventStream = AsyncIterable<string> | AsyncIterable<Buffer>;
-export interface AnthropicJsonToSseOptions {
-    requestId: string;
-    model: string;
-    chunkSize?: number;
-}
-export interface SseToAnthropicJsonOptions {
-    requestId: string;
-}

package/dist/tools/proxy/anthropic-tool-proxy.d.ts

@@ -1,19 +0,0 @@
-import type { ProxyPlan } from './types.js';
-export declare class AnthropicToolProxy {
-    constructor();
-    /**
-     * Inspect an Anthropic message (round-1) content blocks, execute supported
-     * tool_use blocks server-side, and return a plan of tool_result blocks.
-     */
-    buildProxyPlan(firstRoundAnthropicMessage: any): Promise<ProxyPlan>;
-    /**
-     * Build a second Anthropic Messages request payload by appending:
-     *  - assistant (original tool_use blocks)
-     *  - user (tool_result[] built from proxy plan)
-     */
-    buildSecondRoundPayload(originalAnthropicRequest: any, plan: ProxyPlan): any;
-}
-declare const _default: {
-    AnthropicToolProxy: typeof AnthropicToolProxy;
-};
-export default _default;

package/dist/tools/proxy/anthropic-tool-proxy.js

@@ -1,57 +0,0 @@
-import { GlobalToolRegistry } from './registry.js';
-import { WebFetchExecutor } from './executors/web-fetch.js';
-function registerDefaults() {
-    try {
-        GlobalToolRegistry.register(new WebFetchExecutor());
-    }
-    catch { }
-}
-export class AnthropicToolProxy {
-    constructor() { registerDefaults(); }
-    /**
-     * Inspect an Anthropic message (round-1) content blocks, execute supported
-     * tool_use blocks server-side, and return a plan of tool_result blocks.
-     */
-    async buildProxyPlan(firstRoundAnthropicMessage) {
-        const assistantBlocks = (firstRoundAnthropicMessage && typeof firstRoundAnthropicMessage === 'object' && Array.isArray(firstRoundAnthropicMessage.content))
-            ? firstRoundAnthropicMessage.content : [];
-        const out = [];
-        for (const b of assistantBlocks) {
-            try {
-                const t = String(b?.type || '').toLowerCase();
-                if (t !== 'tool_use')
-                    continue;
-                const name = String(b?.name || '');
-                const ex = GlobalToolRegistry.resolve(name);
-                if (!ex)
-                    continue;
-                const input = (b && typeof b === 'object') ? (b.input ?? {}) : {};
-                const result = await ex.execute(input);
-                const id = String(b?.id || '');
-                if (id)
-                    out.push({ tool_use_id: id, content: result.content });
-            }
-            catch { }
-        }
-        return { assistantBlocks, results: out };
-    }
-    /**
-     * Build a second Anthropic Messages request payload by appending:
-     *  - assistant (original tool_use blocks)
-     *  - user (tool_result[] built from proxy plan)
-     */
-    buildSecondRoundPayload(originalAnthropicRequest, plan) {
-        const messagesOrig = Array.isArray(originalAnthropicRequest?.messages) ? originalAnthropicRequest.messages : [];
-        const assistantMsg = { role: 'assistant', content: plan.assistantBlocks };
-        const userMsg = { role: 'user', content: plan.results.map(r => ({ type: 'tool_result', tool_use_id: r.tool_use_id, content: r.content })) };
-        return {
-            model: String(originalAnthropicRequest?.model || 'unknown'),
-            system: originalAnthropicRequest?.system,
-            tools: Array.isArray(originalAnthropicRequest?.tools) ? originalAnthropicRequest.tools : undefined,
-            messages: [...messagesOrig, assistantMsg, userMsg],
-            stream: true,
-            metadata: { ...(originalAnthropicRequest?.metadata || {}), entryEndpoint: '/v1/messages', stream: true }
-        };
-    }
-}
-export default { AnthropicToolProxy };

package/dist/tools/proxy/executors/web-fetch.d.ts

@@ -1,6 +0,0 @@
-import type { ToolExecutor, ToolExecutionResult } from '../types.js';
-export declare class WebFetchExecutor implements ToolExecutor {
-    readonly id = "web-fetch-executor";
-    readonly names: string[];
-    execute(input: unknown): Promise<ToolExecutionResult>;
-}

package/dist/tools/proxy/executors/web-fetch.js

@@ -1,39 +0,0 @@
-import { fetchRawHtml } from '../../web-fetch-html.js';
-import { htmlToMarkdown } from '../../../html-to-markdown.js';
-export class WebFetchExecutor {
-    id = 'web-fetch-executor';
-    // 仅接受唯一名称
-    names = ['web_fetch'];
-    async execute(input) {
-        try {
-            const obj = (input && typeof input === 'object') ? input : {};
-            const url = String(obj.url || obj.href || '');
-            // 输出格式：默认 html；当 format==='markdown' 或 clean===true 时输出 markdown
-            const fmt = String(obj.format || '').toLowerCase();
-            const wantsMarkdown = fmt === 'markdown' || obj.clean === true;
-            if (!url) {
-                return { ok: false, content: 'invalid_url', error: 'invalid_url' };
-            }
-            const r = await fetchRawHtml(url, {});
-            const ok = !!r && r.ok === true;
-            const html = ok ? (r.html || '') : (r.error || 'fetch_failed');
-            let content;
-            if (wantsMarkdown && ok) {
-                try {
-                    content = htmlToMarkdown(String(html));
-                }
-                catch {
-                    content = String(html);
-                }
-            }
-            else {
-                content = String(html);
-            }
-            const limited = content.slice(0, 200000);
-            return { ok, content: limited };
-        }
-        catch (e) {
-            return { ok: false, content: String(e?.message || 'error'), error: String(e?.message || 'error') };
-        }
-    }
-}

package/dist/tools/proxy/registry.d.ts

@@ -1,8 +0,0 @@
-import type { ToolExecutor } from './types.js';
-export declare class ToolRegistry {
-    private executors;
-    register(executor: ToolExecutor): void;
-    resolve(name: string): ToolExecutor | null;
-    has(name: string): boolean;
-}
-export declare const GlobalToolRegistry: ToolRegistry;

package/dist/tools/proxy/registry.js

@@ -1,14 +0,0 @@
-export class ToolRegistry {
-    executors = new Map();
-    register(executor) {
-        for (const n of executor.names) {
-            this.executors.set(n, executor);
-        }
-    }
-    resolve(name) {
-        const ex = this.executors.get(name);
-        return ex || null;
-    }
-    has(name) { return this.executors.has(name); }
-}
-export const GlobalToolRegistry = new ToolRegistry();

package/dist/tools/proxy/types.d.ts

@@ -1,29 +0,0 @@
-export type ToolUseBlock = {
-    type: string;
-    id?: string;
-    name?: string;
-    input?: unknown;
-};
-export type ToolResultBlock = {
-    type: 'tool_result';
-    tool_use_id: string;
-    content: string;
-};
-export interface ToolExecutionResult {
-    ok: boolean;
-    content: string;
-    error?: string;
-    meta?: Record<string, unknown>;
-}
-export interface ToolExecutor {
-    readonly id: string;
-    readonly names: string[];
-    execute(input: unknown): Promise<ToolExecutionResult>;
-}
-export interface ProxyPlan {
-    assistantBlocks: any[];
-    results: Array<{
-        tool_use_id: string;
-        content: string;
-    }>;
-}

package/dist/tools/tool-registry.d.ts

@@ -1,8 +0,0 @@
-export interface ToolValidationResult {
-    ok: boolean;
-    reason?: string;
-    warnings?: Array<Record<string, unknown>>;
-    normalizedArgs?: string;
-}
-export declare function getAllowedToolNames(): string[];
-export declare function validateToolCall(name: string, argsString: string): ToolValidationResult;

package/dist/tools/web-fetch-html.d.ts

@@ -1,15 +0,0 @@
-export interface WebFetchHtmlOptions {
-    timeoutMs?: number;
-    followRedirects?: boolean;
-    maxBytes?: number;
-    headers?: Record<string, string>;
-}
-export interface WebFetchHtmlResult {
-    ok: boolean;
-    html?: string;
-    error?: string;
-    status?: number;
-    contentType?: string | null;
-    url?: string;
-}
-export declare function fetchRawHtml(url: string, opts?: WebFetchHtmlOptions): Promise<WebFetchHtmlResult>;