@jsonstudio/llms 0.4.3 → 0.4.5

package/dist/conversion/conversion-v3/sse/json-to-sse/event-generators/responses.js

@@ -1,599 +0,0 @@
-/**
- * Responses协议事件生成器
- * 提供纯函数，将Responses响应数据转换为SSE事件对象，不处理流写入
- */
-import { TimeUtils, StringUtils } from '../../shared/utils.js';
-const TEXT_CHUNK_BOUNDARY = /[\n\r\t，。、“”‘’！？,\.\-:\u3000\s]/;
-function cloneRegex(source) {
-    return new RegExp(source.source, source.flags);
-}
-function getChunkSize(config) {
-    return Math.max(1, config.chunkSize || DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG.chunkSize);
-}
-function chunkText(text, config) {
-    try {
-        return StringUtils.chunkString(text, getChunkSize(config), cloneRegex(TEXT_CHUNK_BOUNDARY));
-    }
-    catch {
-        return [text];
-    }
-}
-function createResponsePayload(response, overrides = {}) {
-    const raw = response;
-    const usage = normalizeUsage(response.usage);
-    const payload = {
-        id: response.id,
-        object: response.object ?? 'response',
-        created_at: response.created_at ?? Math.floor(Date.now() / 1000),
-        status: response.status ?? 'in_progress',
-        model: response.model,
-        output: response.output ?? [],
-        usage,
-        temperature: response.temperature,
-        top_p: response.top_p,
-        max_output_tokens: response.max_output_tokens,
-        metadata: response.metadata,
-        user: response.user,
-        store: response.store,
-        truncation: response.truncation,
-        include: response.include,
-        parallel_tool_calls: response.parallel_tool_calls,
-        previous_response_id: response.previous_response_id
-    };
-    payload.background = raw.background ?? false;
-    payload.error = Object.prototype.hasOwnProperty.call(raw, 'error') ? raw.error : null;
-    payload.incomplete_details = Object.prototype.hasOwnProperty.call(raw, 'incomplete_details') ? raw.incomplete_details : null;
-    if (Object.prototype.hasOwnProperty.call(raw, 'instructions')) {
-        payload.instructions = raw.instructions;
-    }
-    if (Object.prototype.hasOwnProperty.call(raw, 'include')) {
-        payload.include = raw.include;
-    }
-    Object.entries(overrides).forEach(([key, value]) => {
-        if (value === undefined) {
-            delete payload[key];
-        }
-        else {
-            payload[key] = value;
-        }
-    });
-    Object.keys(payload).forEach(key => {
-        if (payload[key] === undefined) {
-            delete payload[key];
-        }
-    });
-    return payload;
-}
-function normalizeUsage(usage) {
-    const fallback = { input_tokens: 0, output_tokens: 0, total_tokens: 0 };
-    if (!usage || typeof usage !== 'object') {
-        return fallback;
-    }
-    const asAny = usage;
-    const inputRaw = Number((asAny.input_tokens ?? asAny.prompt_tokens));
-    const outputRaw = Number((asAny.output_tokens ?? asAny.completion_tokens));
-    const input = Number.isFinite(inputRaw) ? inputRaw : 0;
-    const output = Number.isFinite(outputRaw) ? outputRaw : 0;
-    const totalRaw = Number(asAny.total_tokens);
-    const total = Number.isFinite(totalRaw) ? totalRaw : input + output;
-    return {
-        input_tokens: input,
-        output_tokens: output,
-        total_tokens: total
-    };
-}
-// 默认配置
-export const DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG = {
-    chunkSize: 12,
-    chunkDelayMs: 8,
-    enableIdGeneration: true,
-    enableTimestampGeneration: true,
-    enableSequenceNumbers: true,
-    enableDelay: false
-};
-/**
- * 创建默认上下文
- */
-export function createDefaultResponsesContext(requestId, model) {
-    return {
-        requestId,
-        model,
-        outputIndexCounter: 0,
-        contentIndexCounter: new Map(),
-        sequenceCounter: 0
-    };
-}
-/**
- * 生成下一个序列号
- */
-function getNextSequenceNumber(context, config) {
-    return config.enableSequenceNumbers ? context.sequenceCounter++ : 0;
-}
-/**
- * 创建基础事件数据
- */
-function createBaseEvent(context, config) {
-    return {
-        requestId: context.requestId,
-        timestamp: config.enableTimestampGeneration ? TimeUtils.now() : 0,
-        sequenceNumber: getNextSequenceNumber(context, config),
-        protocol: 'responses',
-        direction: 'json_to_sse'
-    };
-}
-/**
- * 构建response.created + response.in_progress事件
- * 映射：response.start → response.created + response.in_progress
- */
-export function* buildResponseStartEvents(response, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    // 第一个事件：response.created
-    const createdEvent = createBaseEvent(context, config);
-    yield {
-        type: 'response.created',
-        timestamp: createdEvent.timestamp,
-        protocol: createdEvent.protocol,
-        direction: createdEvent.direction,
-        data: {
-            response: createResponsePayload(response, { status: 'in_progress' })
-        },
-        sequenceNumber: createdEvent.sequenceNumber
-    };
-    // 第二个事件：response.in_progress
-    const inProgressEvent = createBaseEvent(context, config);
-    yield {
-        type: 'response.in_progress',
-        timestamp: inProgressEvent.timestamp,
-        protocol: inProgressEvent.protocol,
-        direction: inProgressEvent.direction,
-        data: {
-            response: createResponsePayload(response, { status: 'in_progress' })
-        },
-        sequenceNumber: inProgressEvent.sequenceNumber
-    };
-}
-/**
- * 构建response.output_item.added事件
- * 映射：output_item.start → response.output_item.added
- */
-export function buildOutputItemStartEvent(outputItem, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    const baseEvent = createBaseEvent(context, config);
-    const itemDescriptor = {
-        id: outputItem.id,
-        type: outputItem.type,
-        status: 'in_progress'
-    };
-    if (outputItem.type === 'message') {
-        const message = outputItem;
-        if (message.role) {
-            itemDescriptor.role = message.role;
-        }
-        itemDescriptor.content = [];
-    }
-    if (outputItem.type === 'function_call') {
-        const functionCall = outputItem;
-        if (functionCall.name) {
-            itemDescriptor.name = functionCall.name;
-        }
-        if (functionCall.call_id) {
-            itemDescriptor.call_id = functionCall.call_id;
-        }
-        itemDescriptor.arguments = '';
-    }
-    if (outputItem.type === 'function_call_output') {
-        const functionCallOutput = outputItem;
-        if (functionCallOutput.call_id) {
-            itemDescriptor.call_id = functionCallOutput.call_id;
-        }
-        if (functionCallOutput.tool_call_id) {
-            itemDescriptor.tool_call_id = functionCallOutput.tool_call_id;
-        }
-        itemDescriptor.output = functionCallOutput.output;
-    }
-    if (outputItem.type === 'reasoning') {
-        const reasoning = outputItem;
-        if (reasoning.summary) {
-            itemDescriptor.summary = reasoning.summary;
-        }
-    }
-    return {
-        type: 'response.output_item.added',
-        timestamp: baseEvent.timestamp,
-        protocol: baseEvent.protocol,
-        direction: baseEvent.direction,
-        data: {
-            output_index: context.outputIndexCounter,
-            item: itemDescriptor
-        },
-        sequenceNumber: baseEvent.sequenceNumber
-    };
-}
-/**
- * 构建response.content_part.added事件
- * 映射：content_part.start → response.content_part.added
- */
-export function buildContentPartStartEvent(outputItemId, contentIndex, content, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    const baseEvent = createBaseEvent(context, config);
-    const partDescriptor = { type: content.type };
-    if (content.type === 'input_text') {
-        partDescriptor.text = content.text ?? '';
-    }
-    else if (content.type === 'output_text') {
-        partDescriptor.text = '';
-        partDescriptor.annotations = content.annotations ?? [];
-        partDescriptor.logprobs = content.logprobs ?? [];
-    }
-    else if (content.type === 'input_image') {
-        partDescriptor.image_url = content.image_url;
-        if (content.detail) {
-            partDescriptor.detail = content.detail;
-        }
-    }
-    else if (content.type === 'file_search') {
-        partDescriptor.file_search = content.file_search;
-    }
-    else if (content.type === 'computer_use') {
-        partDescriptor.computer_use = content.computer_use;
-    }
-    else if (content.type === 'function_call') {
-        partDescriptor.name = content.name;
-        partDescriptor.arguments = content.arguments;
-    }
-    else if (content.type === 'function_result') {
-        partDescriptor.result = content.result;
-        partDescriptor.tool_call_id = content.tool_call_id;
-    }
-    else if (content.type === 'conversation') {
-        partDescriptor.conversation = content.conversation;
-    }
-    return {
-        type: 'response.content_part.added',
-        timestamp: baseEvent.timestamp,
-        protocol: baseEvent.protocol,
-        direction: baseEvent.direction,
-        data: {
-            output_index: context.outputIndexCounter,
-            item_id: outputItemId,
-            content_index: contentIndex,
-            part: partDescriptor
-        },
-        sequenceNumber: baseEvent.sequenceNumber
-    };
-}
-/**
- * 构建response.output_text.delta事件流
- * 映射：content_part.delta (input_text/output_text/…) → response.output_text.delta
- * 对于 reasoning 使用 response.reasoning_text.delta
- */
-export function* buildContentPartDeltas(outputItemId, contentIndex, text, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    if (!text)
-        return;
-    const chunks = chunkText(text, config);
-    for (const chunk of chunks) {
-        const baseEvent = createBaseEvent(context, config);
-        yield {
-            type: 'response.output_text.delta',
-            timestamp: baseEvent.timestamp,
-            protocol: baseEvent.protocol,
-            direction: baseEvent.direction,
-            data: {
-                output_index: context.outputIndexCounter,
-                item_id: outputItemId,
-                content_index: contentIndex,
-                delta: chunk,
-                logprobs: []
-            },
-            sequenceNumber: baseEvent.sequenceNumber
-        };
-    }
-}
-/**
- * 构建content_part.done事件
- */
-export function buildContentPartDoneEvent(outputItemId, contentIndex, content, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    const baseEvent = createBaseEvent(context, config);
-    const partDescriptor = {};
-    if (content) {
-        partDescriptor.type = content.type;
-        if (content.type === 'input_text' || content.type === 'output_text') {
-            partDescriptor.text = content.text ?? '';
-            if (content.type === 'output_text') {
-                partDescriptor.annotations = content.annotations ?? [];
-                partDescriptor.logprobs = content.logprobs ?? [];
-            }
-        }
-        else if (content.type === 'input_image') {
-            partDescriptor.image_url = content.image_url;
-            if (content.detail) {
-                partDescriptor.detail = content.detail;
-            }
-        }
-        else if (content.type === 'function_call') {
-            partDescriptor.name = content.name;
-            partDescriptor.arguments = content.arguments;
-        }
-        else if (content.type === 'function_result') {
-            partDescriptor.result = content.result;
-            partDescriptor.tool_call_id = content.tool_call_id;
-        }
-        else if (content.type === 'conversation') {
-            partDescriptor.conversation = content.conversation;
-        }
-    }
-    return {
-        type: 'response.content_part.done',
-        timestamp: baseEvent.timestamp,
-        protocol: baseEvent.protocol,
-        direction: baseEvent.direction,
-        data: {
-            output_index: context.outputIndexCounter,
-            item_id: outputItemId,
-            content_index: contentIndex,
-            ...(Object.keys(partDescriptor).length ? { part: partDescriptor } : {})
-        },
-        sequenceNumber: baseEvent.sequenceNumber
-    };
-}
-export function buildOutputTextDoneEvent(outputItemId, contentIndex, fullText, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    const baseEvent = createBaseEvent(context, config);
-    return {
-        type: 'response.output_text.done',
-        timestamp: baseEvent.timestamp,
-        protocol: baseEvent.protocol,
-        direction: baseEvent.direction,
-        data: {
-            output_index: context.outputIndexCounter,
-            item_id: outputItemId,
-            content_index: contentIndex,
-            text: fullText,
-            logprobs: []
-        },
-        sequenceNumber: baseEvent.sequenceNumber
-    };
-}
-/**
- * 构建response.function_call_arguments.delta/done的start部分
- * 映射：function_call.start → 隐含在第一个 delta 中
- */
-/**
- * 构建response.function_call_arguments.delta事件流
- * 映射：function_call.delta → response.function_call_arguments.delta
- */
-export function* buildFunctionCallArgsDeltas(functionCall, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    if (!functionCall.arguments)
-        return;
-    const chunks = chunkText(functionCall.arguments, config);
-    for (const chunk of chunks) {
-        const baseEvent = createBaseEvent(context, config);
-        yield {
-            type: 'response.function_call_arguments.delta',
-            timestamp: baseEvent.timestamp,
-            protocol: baseEvent.protocol,
-            direction: baseEvent.direction,
-            data: {
-                output_index: context.outputIndexCounter,
-                item_id: functionCall.id,
-                call_id: functionCall.call_id,
-                delta: chunk
-            },
-            sequenceNumber: baseEvent.sequenceNumber
-        };
-    }
-}
-/**
- * 构建response.function_call_arguments.done事件
- * 映射：function_call.done → response.function_call_arguments.done
- */
-export function buildFunctionCallDoneEvent(functionCall, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    const baseEvent = createBaseEvent(context, config);
-    return {
-        type: 'response.function_call_arguments.done',
-        timestamp: baseEvent.timestamp,
-        protocol: baseEvent.protocol,
-        direction: baseEvent.direction,
-        data: {
-            output_index: context.outputIndexCounter,
-            item_id: functionCall.id,
-            call_id: functionCall.call_id,
-            name: functionCall.name,
-            arguments: functionCall.arguments // done 时包含完整 arguments
-        },
-        sequenceNumber: baseEvent.sequenceNumber
-    };
-}
-/**
- * 构建reasoning.start事件
- */
-export function buildReasoningStartEvent(reasoning, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    const baseEvent = createBaseEvent(context, config);
-    return {
-        type: 'reasoning.start',
-        timestamp: baseEvent.timestamp,
-        protocol: baseEvent.protocol,
-        direction: baseEvent.direction,
-        data: {
-            item_id: reasoning.id,
-            summary: reasoning.summary
-        },
-        sequenceNumber: baseEvent.sequenceNumber
-    };
-}
-/**
- * 构建response.reasoning_text.delta事件流
- * 映射：reasoning.delta → response.reasoning_text.delta
- */
-export function* buildReasoningDeltas(reasoning, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    for (const content of reasoning.content) {
-        if (content.type === 'reasoning_text') {
-            if (!content.text)
-                continue;
-            const baseEvent = createBaseEvent(context, config);
-            yield {
-                type: 'response.reasoning_text.delta',
-                timestamp: baseEvent.timestamp,
-                protocol: baseEvent.protocol,
-                direction: baseEvent.direction,
-                data: {
-                    output_index: context.outputIndexCounter,
-                    item_id: reasoning.id,
-                    delta: content.text
-                },
-                sequenceNumber: baseEvent.sequenceNumber
-            };
-        }
-        else if (content.type === 'reasoning_signature') {
-            const baseEvent = createBaseEvent(context, config);
-            yield {
-                type: 'response.reasoning_signature.delta',
-                timestamp: baseEvent.timestamp,
-                protocol: baseEvent.protocol,
-                direction: baseEvent.direction,
-                data: {
-                    output_index: context.outputIndexCounter,
-                    item_id: reasoning.id,
-                    signature: content.signature
-                },
-                sequenceNumber: baseEvent.sequenceNumber
-            };
-        }
-        else if (content.type === 'reasoning_image') {
-            const baseEvent = createBaseEvent(context, config);
-            yield {
-                type: 'response.reasoning_image.delta',
-                timestamp: baseEvent.timestamp,
-                protocol: baseEvent.protocol,
-                direction: baseEvent.direction,
-                data: {
-                    output_index: context.outputIndexCounter,
-                    item_id: reasoning.id,
-                    image_url: content.image_url
-                },
-                sequenceNumber: baseEvent.sequenceNumber
-            };
-        }
-    }
-}
-/**
- * 构建reasoning.done事件
- */
-export function buildReasoningDoneEvent(reasoning, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    const baseEvent = createBaseEvent(context, config);
-    return {
-        type: 'reasoning.done',
-        timestamp: baseEvent.timestamp,
-        protocol: baseEvent.protocol,
-        direction: baseEvent.direction,
-        data: {
-            item_id: reasoning.id
-        },
-        sequenceNumber: baseEvent.sequenceNumber
-    };
-}
-/**
- * 构建output_item.done事件
- */
-export function buildOutputItemDoneEvent(outputItem, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    const baseEvent = createBaseEvent(context, config);
-    const itemDescriptor = {
-        id: outputItem.id,
-        type: outputItem.type,
-        status: 'completed'
-    };
-    if (outputItem.name) {
-        itemDescriptor.name = outputItem.name;
-    }
-    if (outputItem.arguments) {
-        itemDescriptor.arguments = outputItem.arguments;
-    }
-    if (outputItem.call_id) {
-        itemDescriptor.call_id = outputItem.call_id;
-    }
-    if (outputItem.type === 'function_call_output') {
-        const result = outputItem;
-        if (result.call_id) {
-            itemDescriptor.call_id = result.call_id;
-        }
-        if (result.tool_call_id) {
-            itemDescriptor.tool_call_id = result.tool_call_id;
-        }
-        itemDescriptor.output = result.output;
-    }
-    return {
-        type: 'response.output_item.done',
-        timestamp: baseEvent.timestamp,
-        protocol: baseEvent.protocol,
-        direction: baseEvent.direction,
-        data: {
-            output_index: context.outputIndexCounter,
-            item: itemDescriptor
-        },
-        sequenceNumber: baseEvent.sequenceNumber
-    };
-}
-/**
- * 构建required_action事件
- */
-export function buildRequiredActionEvent(response, requiredAction, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    const baseEvent = createBaseEvent(context, config);
-    return {
-        type: 'response.required_action',
-        timestamp: baseEvent.timestamp,
-        protocol: baseEvent.protocol,
-        direction: baseEvent.direction,
-        data: {
-            response: createResponsePayload(response, { status: response.status ?? 'requires_action' }),
-            required_action: requiredAction
-        },
-        sequenceNumber: baseEvent.sequenceNumber
-    };
-}
-/**
- * 构建response.completed事件
- * 新增：在 done 之前增加 response.completed
- */
-export function buildResponseCompletedEvent(response, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    const baseEvent = createBaseEvent(context, config);
-    return {
-        type: 'response.completed',
-        timestamp: baseEvent.timestamp,
-        protocol: baseEvent.protocol,
-        direction: baseEvent.direction,
-        data: {
-            response: createResponsePayload(response, { status: response.status ?? 'completed' })
-        },
-        sequenceNumber: baseEvent.sequenceNumber
-    };
-}
-/**
- * 构建response.done事件
- */
-export function buildResponseDoneEvent(response, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    const baseEvent = createBaseEvent(context, config);
-    return {
-        type: 'response.done',
-        timestamp: baseEvent.timestamp,
-        protocol: baseEvent.protocol,
-        direction: baseEvent.direction,
-        data: '[DONE]',
-        sequenceNumber: baseEvent.sequenceNumber
-    };
-}
-/**
- * 构建error事件
- */
-export function buildErrorEvent(error, context, config = DEFAULT_RESPONSES_EVENT_GENERATOR_CONFIG) {
-    const baseEvent = createBaseEvent(context, config);
-    return {
-        type: 'error',
-        timestamp: baseEvent.timestamp,
-        protocol: baseEvent.protocol,
-        direction: baseEvent.direction,
-        data: {
-            error: {
-                message: error.message,
-                type: 'internal_error',
-                code: 'generation_error'
-            }
-        },
-        sequenceNumber: baseEvent.sequenceNumber
-    };
-}

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

@@ -1,6 +0,0 @@
-/**
- * JSON→SSE转换模块导出
- */
-export { ChatJsonToSseConverter } from './chat-json-to-sse-converter.js';
-export { ResponsesJsonToSseConverter } from './responses-json-to-sse-converter.js';
-export type { ChatJsonToSseOptions, ChatJsonToSseContext, ChatEventStats, ResponsesJsonToSseOptions, ResponsesJsonToSseContext, ResponsesEventStats } from '../types/index.js';

package/dist/conversion/conversion-v3/sse/json-to-sse/index.js

@@ -1,7 +0,0 @@
-/**
- * JSON→SSE转换模块导出
- */
-// Chat协议转换器（重构版本）
-export { ChatJsonToSseConverter } from './chat-json-to-sse-converter.js';
-// Responses协议转换器（重构版本）
-export { ResponsesJsonToSseConverter } from './responses-json-to-sse-converter.js';

package/dist/conversion/conversion-v3/sse/json-to-sse/responses-json-to-sse-converter.d.ts

@@ -1,79 +0,0 @@
-/**
- * Responses JSON → SSE转换器（重构版本）
- * 使用函数化架构：事件生成 + 序列化 + 写入分离
- */
-import { ResponsesRequest, ResponsesResponse, ResponsesJsonToSseContext, ResponsesJsonToSseOptions, ResponsesSseEventStream, DEFAULT_RESPONSES_CONVERSION_CONFIG } from '../types/index.js';
-/**
- * 重构后的Responses JSON到SSE转换器
- * 采用函数化架构，专注于编排而非具体业务逻辑
- */
-export declare class ResponsesJsonToSseConverterRefactored {
-    private config;
-    private contexts;
-    constructor(config?: Partial<typeof DEFAULT_RESPONSES_CONVERSION_CONFIG>);
-    /**
-     * 将Responses请求转换为SSE流
-     */
-    convertRequestToJsonToSse(request: ResponsesRequest, options: ResponsesJsonToSseOptions): Promise<ResponsesSseEventStream>;
-    /**
-     * 将Responses响应转换为SSE流
-     */
-    convertResponseToJsonToSse(response: ResponsesResponse, options: ResponsesJsonToSseOptions): Promise<ResponsesSseEventStream>;
-    /**
-     * 使用函数化架构处理请求转换
-     */
-    private processRequestToSseWithFunctions;
-    /**
-     * 使用函数化架构处理响应转换
-     */
-    private processResponseToSseWithFunctions;
-    /**
-     * 验证请求格式
-     */
-    private validateRequest;
-    /**
-     * 验证响应格式
-     */
-    private validateResponse;
-    /**
-     * 更新统计信息
-     */
-    private updateStats;
-    /**
-     * 包装错误
-     */
-    private wrapError;
-    /**
-     * 处理流错误
-     */
-    private handleStreamError;
-    /**
-     * 完成流
-     */
-    private completeStream;
-    /**
-     * 中止流
-     */
-    private abortStream;
-    /**
-     * 创建请求上下文
-     */
-    private createRequestContext;
-    /**
-     * 创建响应上下文
-     */
-    private createResponseContext;
-    /**
-     * 获取上下文
-     */
-    getContext(requestId: string): ResponsesJsonToSseContext | undefined;
-    /**
-     * 清理上下文
-     */
-    clearContext(requestId: string): void;
-    /**
-     * 获取所有活跃的上下文
-     */
-    getActiveContexts(): Map<string, ResponsesJsonToSseContext>;
-}
-export declare const ResponsesJsonToSseConverter: typeof ResponsesJsonToSseConverterRefactored;