@jsonstudio/llms 0.4.2 → 0.4.4

package/dist/sse/sse-to-json/chat-sse-to-json-converter.js

@@ -201,7 +201,8 @@ export class ChatSseToJsonConverter {
      */
     async processChatChunk(event, context) {
         try {
-            const chunk = JSON.parse(event.data);
+            const payload = typeof event.data === 'string' ? event.data : JSON.stringify(event.data ?? {});
+            const chunk = JSON.parse(payload);
             // 验证chunk格式
             if (context.options.validateChunks) {
                 this.validateChatChunk(chunk);
@@ -237,8 +238,11 @@ export class ChatSseToJsonConverter {
             context.choiceIndexMap.set(choiceIndex, choiceBuilder);
             context.currentResponse.choices?.push({
                 index: choiceIndex,
-                message: {},
-                finish_reason: null,
+                message: {
+                    role: 'assistant',
+                    content: ''
+                },
+                finish_reason: 'stop',
                 logprobs: choice.logprobs
             });
         }
@@ -261,8 +265,8 @@ export class ChatSseToJsonConverter {
         return {
             index,
             delta: {},
-            finishReason: null,
-            logprobs: null,
+            finishReason: undefined,
+            logprobs: undefined,
             messageBuilder: {
                 role: undefined,
                 content: '',
@@ -280,7 +284,7 @@ export class ChatSseToJsonConverter {
     /**
      * 处理delta
      */
-    async processDelta(delta, choiceBuilder, context) {
+    async processDelta(delta, choiceBuilder, _context) {
         const messageBuilder = choiceBuilder.messageBuilder;
         // 处理role
         if (delta.role) {
@@ -314,7 +318,7 @@ export class ChatSseToJsonConverter {
         // 处理tool_calls
         if (delta.tool_calls && Array.isArray(delta.tool_calls)) {
             for (const toolCallDelta of delta.tool_calls) {
-                await this.processToolCallDelta(toolCallDelta, choiceBuilder, context);
+                await this.processToolCallDelta(toolCallDelta, choiceBuilder);
             }
         }
         // 合并delta到choiceBuilder
@@ -323,7 +327,7 @@ export class ChatSseToJsonConverter {
     /**
      * 处理tool_call delta
      */
-    async processToolCallDelta(toolCallDelta, choiceBuilder, context) {
+    async processToolCallDelta(toolCallDelta, choiceBuilder) {
         const toolCallIndex = toolCallDelta.index;
         // 获取或创建tool_call构建器
         let toolCallBuilder = choiceBuilder.toolCallBuilders.get(toolCallIndex);
@@ -367,8 +371,9 @@ export class ChatSseToJsonConverter {
      */
     updateResponseChoice(choiceIndex, choiceBuilder, context) {
         const responseChoice = context.currentResponse.choices?.[choiceIndex];
-        if (!responseChoice)
+        if (!responseChoice) {
             return;
+        }
         const messageBuilder = choiceBuilder.messageBuilder;
         // 构建message
         const message = {
@@ -382,12 +387,15 @@ export class ChatSseToJsonConverter {
         }
         // 构建tool_calls
         const toolCalls = [];
-        for (const [_, toolCallBuilder] of choiceBuilder.toolCallBuilders) {
-            if (toolCallBuilder.id) {
+        for (const toolCallBuilder of choiceBuilder.toolCallBuilders.values()) {
+            if (toolCallBuilder.id && toolCallBuilder.function) {
                 toolCalls.push({
                     id: toolCallBuilder.id,
                     type: toolCallBuilder.type || 'function',
-                    function: toolCallBuilder.function
+                    function: {
+                        name: toolCallBuilder.function.name ?? '',
+                        arguments: toolCallBuilder.function.arguments ?? ''
+                    }
                 });
             }
         }
@@ -395,7 +403,7 @@ export class ChatSseToJsonConverter {
             message.tool_calls = toolCalls;
         }
         responseChoice.message = message;
-        responseChoice.finish_reason = choiceBuilder.finishReason;
+        responseChoice.finish_reason = choiceBuilder.finishReason ?? responseChoice.finish_reason;
         context.eventStats.totalToolCalls += toolCalls.length;
     }
     /**
@@ -405,9 +413,11 @@ export class ChatSseToJsonConverter {
         context.isCompleted = true;
         // 解析done事件数据（如果有的话）
         try {
-            const doneData = JSON.parse(event.data);
-            if (doneData.totalTokens) {
-                context.eventStats.totalTokens = doneData.totalTokens;
+            if (typeof event.data === 'string') {
+                const doneData = JSON.parse(event.data);
+                if (typeof doneData.totalTokens === 'number') {
+                    context.eventStats.totalTokens = doneData.totalTokens;
+                }
             }
         }
         catch (e) {
@@ -417,12 +427,15 @@ export class ChatSseToJsonConverter {
     /**
      * 处理error事件
      */
-    async processErrorEvent(event, context) {
+    async processErrorEvent(event, _context) {
         try {
-            const errorData = JSON.parse(event.data);
-            const error = new Error(errorData.error || 'Unknown SSE error');
-            error.code = errorData.code || 'SSE_ERROR';
-            throw ErrorUtils.createError(error.message, CHAT_CONVERSION_ERROR_CODES.STREAM_ERROR, { errorData, event });
+            const rawPayload = typeof event.data === 'string' ? event.data : JSON.stringify(event.data ?? {});
+            const errorData = JSON.parse(rawPayload);
+            const errorMessage = typeof errorData.error === 'string' ? errorData.error : 'Unknown SSE error';
+            const code = typeof errorData.code === 'string' ? errorData.code : 'SSE_ERROR';
+            const typedError = new Error(errorMessage);
+            typedError.code = code;
+            throw ErrorUtils.createError(typedError.message, CHAT_CONVERSION_ERROR_CODES.STREAM_ERROR, { errorData, event });
         }
         catch (parseError) {
             throw ErrorUtils.createError(`SSE error event: ${event.data}`, CHAT_CONVERSION_ERROR_CODES.STREAM_ERROR, { event });
@@ -433,8 +446,9 @@ export class ChatSseToJsonConverter {
      */
     buildPartialResponse(context) {
         const choices = context.currentResponse.choices || [];
-        if (choices.length === 0)
+        if (choices.length === 0) {
             return null;
+        }
         return {
             id: context.currentResponse.id || '',
             object: 'chat.completion',
@@ -475,7 +489,7 @@ export class ChatSseToJsonConverter {
     /**
      * 构建使用量信息
      */
-    buildUsageInfo(context) {
+    buildUsageInfo(_context) {
         // 这里可以基于token计数来计算usage
         // 暂时返回null，后续可以实现更精确的token计数
         return null;

package/dist/sse/sse-to-json/parsers/sse-parser.js

@@ -76,16 +76,18 @@ function parseSseLine(line) {
  * 将原始SSE行组装为事件
  */
 export function assembleSseEvent(lines) {
-    if (lines.length === 0)
+    if (lines.length === 0) {
         return null;
+    }
     const event = {
         event: 'message', // 默认事件类型
         data: ''
     };
     for (const line of lines) {
         const { field, value } = parseSseLine(line);
-        if (!field)
+        if (!field) {
             continue;
+        }
         switch (field) {
             case 'id':
                 event.id = value;
@@ -94,7 +96,7 @@ export function assembleSseEvent(lines) {
                 event.event = value;
                 break;
             case 'data':
-                event.data = event.data ? event.data + '\n' + value : value;
+                event.data = event.data ? `${event.data}\n${value}` : value;
                 break;
             case 'retry':
                 event.retry = value;
@@ -119,7 +121,8 @@ function safeJsonParse(data) {
         return JSON.parse(data);
     }
     catch (error) {
-        throw new Error(`Invalid JSON data: ${error.message}`);
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid JSON data: ${message}`);
     }
 }
 /**
@@ -134,19 +137,23 @@ function validateEventType(eventType, config) {
 /**
  * 创建基础事件对象
  */
-function createBaseEvent(rawEvent, config, rawData) {
+function createBaseEvent(rawEvent, config, _rawData) {
     const baseEvent = {
         type: rawEvent.event,
-        timestamp: rawEvent.timestamp || Date.now(),
+        timestamp: rawEvent.timestamp ?? Date.now(),
         data: null,
         sequenceNumber: typeof rawEvent.id === 'string' ? Number(rawEvent.id) : 0
     };
     // 解析数据字段
     try {
         if (rawEvent.data) {
-            baseEvent.data = safeJsonParse(rawEvent.data);
-            if (baseEvent.data && typeof baseEvent.data.sequence_number === 'number') {
-                baseEvent.sequenceNumber = baseEvent.data.sequence_number;
+            const parsedData = safeJsonParse(rawEvent.data);
+            baseEvent.data = parsedData;
+            if (parsedData &&
+                typeof parsedData === 'object' &&
+                'sequence_number' in parsedData &&
+                typeof parsedData.sequence_number === 'number') {
+                baseEvent.sequenceNumber = parsedData.sequence_number;
             }
         }
     }
@@ -156,7 +163,7 @@ function createBaseEvent(rawEvent, config, rawData) {
             baseEvent.type = 'error';
         }
         else {
-            throw error;
+            throw error instanceof Error ? error : new Error(String(error));
         }
     }
     return baseEvent;
@@ -249,7 +256,7 @@ export function parseSseEvent(sseText, config = DEFAULT_SSE_PARSER_CONFIG) {
         result.success = true;
     }
     catch (error) {
-        result.error = error.message;
+        result.error = error instanceof Error ? error.message : String(error);
     }
     return result;
 }
@@ -276,8 +283,9 @@ export async function* parseSseStreamAsync(asyncSseData, config = DEFAULT_SSE_PA
         // 查找完整的事件边界
         while (true) {
             const eventEnd = buffer.indexOf('\n\n');
-            if (eventEnd === -1)
+            if (eventEnd === -1) {
                 break;
+            }
             const eventData = buffer.substring(0, eventEnd);
             buffer = buffer.substring(eventEnd + 2);
             const result = parseSseEvent(eventData, config);

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

@@ -27,6 +27,7 @@ export declare class ResponsesSseToJsonConverterRefactored {
      * 将事件对象序列化为SSE格式（简单实现）
      */
     private serializeEventToSSE;
+    private chunkStrings;
     /**
      * 验证序列号
      */

package/dist/sse/sse-to-json/responses-sse-to-json-converter.js

@@ -48,14 +48,10 @@ export class ResponsesSseToJsonConverterRefactored {
             const readableStream = this.createReadableStream(sseStream);
             // 5. 流式处理SSE数据（按增量缓冲解析，避免跨 chunk 的事件被截断）
             // 注意：不要对每个 chunk 独立 parse；必须使用一个持续的 async 解析器维持缓冲区。
-            async function* chunkStrings(stream) {
-                for await (const chunk of stream) {
-                    yield typeof chunk === 'string' ? chunk : chunk.toString();
-                }
-            }
-            for await (const parseResult of parser.parseStreamAsync(chunkStrings(readableStream))) {
-                if (context.isCompleted)
+            for await (const parseResult of parser.parseStreamAsync(this.chunkStrings(readableStream))) {
+                if (context.isCompleted) {
                     break;
+                }
                 if (parseResult.success && parseResult.event) {
                     const event = parseResult.event;
                     // 验证序列号
@@ -150,8 +146,14 @@ export class ResponsesSseToJsonConverterRefactored {
      * 将事件对象序列化为SSE格式（简单实现）
      */
     serializeEventToSSE(event) {
+        const type = typeof event.type === 'string' ? event.type : 'data';
         const data = event.data ? JSON.stringify(event.data) : '';
-        return `event: ${event.type}\ndata: ${data}\n\n`;
+        return `event: ${type}\ndata: ${data}\n\n`;
+    }
+    async *chunkStrings(stream) {
+        for await (const chunk of stream) {
+            yield typeof chunk === 'string' ? chunk : chunk.toString();
+        }
     }
     /**
      * 验证序列号

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

@@ -3,6 +3,7 @@
  * 支持OpenAI Chat Completions的JSON↔SSE双向转换
  */
 import { BaseSseEvent, StreamDirection } from './core-interfaces.js';
+type JsonObject = Record<string, unknown>;
 export type ChatSseEventType = 'chat_chunk' | 'chat.done' | 'error' | 'ping';
 export interface ChatSseEvent extends BaseSseEvent {
     /** 事件类型（SSE标准wire格式） */
@@ -46,6 +47,7 @@ export interface ChatChoiceChunk {
 export interface ChatDelta {
     role?: 'system' | 'user' | 'assistant' | 'tool';
     content?: string | null;
+    reasoning?: string;
     function_call?: ChatFunctionCall;
     tool_calls?: ChatToolCallChunk[];
 }
@@ -121,7 +123,7 @@ export interface ChatMessage {
 export interface ChatFunction {
     name: string;
     description?: string;
-    parameters?: Record<string, any>;
+    parameters?: Record<string, unknown>;
 }
 export interface ChatTool {
     type: 'function';
@@ -160,8 +162,8 @@ export interface ChatJsonToSseContext {
     currentChunk: Partial<ChatCompletionChunk>;
     eventStats: ChatEventStats;
     contentIndexCounter?: Map<string, number>;
-    currentRequest?: any;
-    currentResponse?: any;
+    currentRequest?: ChatCompletionRequest;
+    currentResponse?: ChatCompletionResponse;
     chatResponse?: ChatCompletionResponse;
 }
 export interface SseToChatJsonContext {
@@ -257,7 +259,7 @@ export interface ChatConversionError extends Error {
     chunkId?: string;
     choiceIndex?: number;
     toolCallIndex?: number;
-    context?: any;
+    context?: JsonObject;
 }
 export declare const CHAT_CONVERSION_ERROR_CODES: {
     readonly TIMEOUT: "CHAT_TIMEOUT";
@@ -273,8 +275,8 @@ export interface ChatEventValidationRule {
     requiredFields: string[];
     optionalFields: string[];
     dataValidation?: {
-        schema?: any;
-        customValidator?: (data: any) => boolean;
+        schema?: JsonObject;
+        customValidator?: (data: JsonObject) => boolean;
     };
 }
 export interface ChatConversionConfig {
@@ -306,3 +308,4 @@ export interface ChatSseEventStream extends AsyncIterable<ChatSseEvent> {
     on(event: 'chunk', handler: (chunk: ChatCompletionChunk) => void): this;
     on(event: 'stats', handler: (stats: ChatEventStats) => void): this;
 }
+export {};

package/dist/sse/types/conversion-context.d.ts

@@ -2,6 +2,7 @@
  * 转换上下文类型定义
  * 定义JSON<>SSE双向转换过程中的上下文信息
  */
+import type { JsonObject, JsonValue } from './core-interfaces.js';
 import type { SseEvent, SseEventStats, SseEventType } from './sse-events.js';
 export interface BaseConversionContext {
     requestId: string;
@@ -36,6 +37,7 @@ export interface SseToJsonContext extends BaseConversionContext {
     isResponseCreated: boolean;
     isInProgress: boolean;
 }
+type ConversionContextUnion = JsonToSseContext | SseToJsonContext;
 export interface JsonToSseOptions {
     requestId: string;
     model: string;
@@ -104,12 +106,13 @@ export interface OutputItemBuilder {
     hasContentPartAdded: boolean;
     isTextInProgress: boolean;
 }
+type LoggerMetadata = Record<string, unknown>;
 export interface ConversionLogger {
-    debug(message: string, meta?: any): void;
-    info(message: string, meta?: any): void;
-    warn(message: string, meta?: any): void;
-    error(message: string, error?: Error, meta?: any): void;
-    event(eventType: string, data?: any): void;
+    debug(message: string, meta?: LoggerMetadata): void;
+    info(message: string, meta?: LoggerMetadata): void;
+    warn(message: string, meta?: LoggerMetadata): void;
+    error(message: string, error?: Error, meta?: LoggerMetadata): void;
+    event(eventType: string, data?: LoggerMetadata): void;
     metric(name: string, value: number, tags?: Record<string, string>): void;
 }
 export interface ConversionError extends Error {
@@ -117,7 +120,7 @@ export interface ConversionError extends Error {
     requestId: string;
     eventType?: string;
     sequenceNumber?: number;
-    context?: any;
+    context?: JsonObject;
 }
 export interface StreamState {
     isStarted: boolean;
@@ -156,20 +159,20 @@ export interface ConversionConfig {
 export declare const DEFAULT_CONVERSION_CONFIG: ConversionConfig;
 export interface EventHandler {
     canHandle(eventType: SseEventType): boolean;
-    handle(event: SseEvent, context: any): Promise<void>;
+    handle(event: SseEvent, context: ConversionContextUnion): Promise<void>;
 }
 export interface ConversionMiddleware {
     name: string;
-    beforeConversion?: (context: any) => Promise<void>;
-    afterConversion?: (context: any, result: any) => Promise<void>;
-    onError?: (context: any, error: Error) => Promise<void>;
+    beforeConversion?: (context: ConversionContextUnion) => Promise<void>;
+    afterConversion?: (context: ConversionContextUnion, result: unknown) => Promise<void>;
+    onError?: (context: ConversionContextUnion, error: Error) => Promise<void>;
 }
 interface OutputItem {
     id: string;
     type: 'reasoning' | 'message' | 'function_call' | 'system_message';
     status?: 'in_progress' | 'completed';
     content?: ContentPart[];
-    summary?: any[];
+    summary?: JsonValue[];
     role?: string;
     arguments?: string;
     call_id?: string;

package/dist/sse/types/core-interfaces.d.ts

@@ -2,13 +2,17 @@
  * 核心接口定义
  * 统一的SSE事件最小接口，供writer.ts等共享模块使用
  */
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export type JsonValue = string | number | boolean | null | JsonObject | JsonValue[];
 export interface BaseSseEvent {
     /** 事件类型 */
     type: string;
     /** 事件时间戳 */
     timestamp: number;
     /** 事件数据 */
-    data: any;
+    data: unknown;
     /** 序列号（可选） */
     sequenceNumber?: number;
     /** 协议标识 */
@@ -56,7 +60,7 @@ export interface BaseConversionContext {
     /** 模型名称 */
     model: string;
     /** 转换选项 */
-    options: any;
+    options: JsonObject;
     /** 开始时间 */
     startTime: number;
 }

package/dist/sse/types/index.d.ts

@@ -3,7 +3,7 @@
  * 支持Responses和Chat协议的JSON↔SSE双向转换
  */
 export type { BaseSseEvent, BaseSseEventStream, StreamProtocol, StreamDirection, SseProtocol, SseDirection } from './core-interfaces.js';
-export type { ChatSseEvent, ChatSseEventType, ChatSseEventStream, ChatEventStats, ChatJsonToSseContext, SseToChatJsonContext, ChatCompletionRequest, ChatCompletionResponse, ChatCompletionChunk, ChatJsonToSseOptions, SseToChatJsonOptions, ChatConversionError, ChatToolCall, ChatChoiceBuilder, ChatMessageBuilder, ChatToolCallBuilder } from './chat-types.js';
+export type { ChatSseEvent, ChatSseEventType, ChatSseEventStream, ChatEventStats, ChatJsonToSseContext, SseToChatJsonContext, ChatCompletionRequest, ChatCompletionResponse, ChatCompletionChunk, ChatMessage, ChatJsonToSseOptions, SseToChatJsonOptions, ChatConversionError, ChatToolCall, ChatToolCallChunk, ChatChoiceBuilder, ChatMessageBuilder, ChatToolCallBuilder } from './chat-types.js';
 export type { ChatJsonToSseConverter } from '../json-to-sse/chat-json-to-sse-converter.js';
 export type { ResponsesJsonToSseConverter } from '../json-to-sse/responses-json-to-sse-converter.js';
 export type { ResponsesSseEvent, ResponsesSseEventType, ResponsesSseEventStream, ResponsesEventStats, ResponsesJsonToSseContext, SseToResponsesJsonContext, ResponsesJsonToSseOptions, SseToResponsesJsonOptions, ResponsesResponse, ResponsesRequest, ResponsesOutputItem, ResponsesMessageItem, ResponsesFunctionCallItem, ResponsesFunctionCallOutputItem, ResponsesReasoningItem, ResponsesContent, ResponsesTool, ResponsesToolCall, ResponsesUsage, OutputItemBuilder, OutputItemProcessingState } from './responses-types.js';

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

@@ -2,7 +2,7 @@
  * Responses协议相关类型定义
  * 支持OpenAI Responses API的JSON↔SSE双向转换
  */
-import { BaseSseEvent, StreamDirection } from './core-interfaces.js';
+import { BaseSseEvent, StreamDirection, type JsonObject, type JsonValue } from './core-interfaces.js';
 export * from './sse-events.js';
 export type ResponsesSseEventType = 'response.created' | 'response.in_progress' | 'response.completed' | 'response.required_action' | 'response.done' | 'response.output_item.added' | 'response.output_item.done' | 'response.content_part.added' | 'response.content_part.done' | 'response.output_text.delta' | 'response.output_text.done' | 'response.reasoning_text.delta' | 'response.reasoning_text.done' | 'response.reasoning_signature.delta' | 'response.reasoning_image.delta' | 'response.reasoning_summary_part.added' | 'response.reasoning_summary_part.done' | 'response.reasoning_summary_text.delta' | 'response.reasoning_summary_text.done' | 'response.function_call_arguments.delta' | 'response.function_call_arguments.done' | 'response.error' | 'response.cancelled' | 'response.start' | 'content_part.delta' | 'reasoning.delta' | 'function_call.start' | 'function_call.delta' | 'function_call.done' | 'output_item.start' | 'content_part.start' | 'content_part.done' | 'output_item.done' | 'reasoning.start' | 'reasoning.done' | 'required_action' | 'error';
 export interface ResponsesSseEvent extends BaseSseEvent {
@@ -37,7 +37,7 @@ export interface SseToResponsesJsonContext {
     startTime: number;
     endTime?: number;
     duration?: number;
-    aggregatedEvents: any[];
+    aggregatedEvents: ResponsesSseEvent[];
     currentResponse: Partial<ResponsesResponse>;
     outputItemBuilders: Map<string, OutputItemBuilder>;
     eventStats: ResponsesEventStats;
@@ -53,7 +53,7 @@ export interface ResponsesRequest {
     temperature?: number;
     top_p?: number;
     max_output_tokens?: number;
-    metadata?: Record<string, any>;
+    metadata?: JsonObject;
     store?: boolean;
     truncation?: 'auto' | 'disabled';
     user?: string;
@@ -80,27 +80,27 @@ export type ResponsesContent = {
     detail?: 'auto' | 'low' | 'high';
 } | {
     type: 'file_search';
-    file_search: any;
+    file_search: JsonObject;
 } | {
     type: 'computer_use';
-    computer_use: any;
+    computer_use: JsonObject;
 } | {
     type: 'function_call';
     name: string;
     arguments: string;
 } | {
     type: 'function_result';
-    result: any;
+    result: JsonValue;
     tool_call_id: string;
 } | {
     type: 'conversation';
-    conversation: any[];
+    conversation: JsonValue[];
 };
 export interface ResponsesTool {
     type: 'function';
     name: string;
     description?: string;
-    parameters?: any;
+    parameters?: JsonObject;
     strict?: boolean;
 }
 export interface ResponsesReasoningConfig {
@@ -113,7 +113,7 @@ export interface ResponsesResponse {
     object: 'response';
     created_at: number;
     status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'incomplete';
-    error?: any;
+    error?: JsonValue;
     model: string;
     output: ResponsesOutputItem[];
     previous_response_id?: string;
@@ -121,7 +121,7 @@ export interface ResponsesResponse {
     temperature?: number;
     top_p?: number;
     max_output_tokens?: number;
-    metadata?: Record<string, any>;
+    metadata?: JsonObject;
     user?: string;
     store?: boolean;
     truncation?: 'auto' | 'disabled';
@@ -147,7 +147,7 @@ export type ResponsesReasoningContent = {
     text: string;
 } | {
     type: 'reasoning_signature';
-    signature: any;
+    signature: JsonObject;
 } | {
     type: 'reasoning_image';
     image_url: string;
@@ -164,14 +164,14 @@ export interface ResponsesFunctionCallOutputItem {
     id: string;
     type: 'function_call_output';
     call_id: string;
-    output: any;
+    output: JsonValue;
     tool_call_id?: string;
 }
 export interface ResponsesSystemItem {
     id: string;
     type: 'system';
     name: string;
-    data: any;
+    data: JsonValue;
 }
 export interface ResponsesUsage {
     input_tokens: number;
@@ -217,7 +217,7 @@ export interface ResponsesJsonToSseOptions {
     includeSequenceNumbers?: boolean;
     includeMetadata?: boolean;
     validationMode?: 'none' | 'basic' | 'strict';
-    onEvent?: (event: any) => void;
+    onEvent?: (event: ResponsesSseEvent) => void;
     onError?: (error: Error) => void;
     onComplete?: () => void;
     resumeToolOutputs?: ResponsesFunctionCallOutputItem[];
@@ -230,7 +230,7 @@ export interface SseToResponsesJsonOptions {
     enableSequenceValidation?: boolean;
     accumulateOutputItems?: boolean;
     onPartialResult?: (partial: Partial<ResponsesResponse>) => void;
-    onEvent?: (event: any) => void;
+    onEvent?: (event: ResponsesSseEvent) => void;
     onCompletion?: (final: ResponsesResponse) => void;
     onError?: (error: Error) => void;
     onTimeout?: () => void;
@@ -256,7 +256,7 @@ export interface OutputItemProcessingState {
     status: 'in_progress' | 'completed';
     contentIndex: number;
     isContentPartAdded: boolean;
-    accumulatedContent: any[];
+    accumulatedContent: ResponsesContent[];
     deltaBuffer: string;
     isTextStarted: boolean;
     isTextCompleted: boolean;
@@ -265,9 +265,9 @@ export interface OutputItemBuilder {
     id: string;
     type: string;
     status: 'in_progress' | 'completed';
-    contentParts: any[];
+    contentParts: ResponsesContent[];
     currentContentIndex: number;
-    accumulatedContent: any[];
+    accumulatedContent: ResponsesContent[];
     hasContentPartAdded: boolean;
     isTextInProgress: boolean;
     callId?: string;
@@ -281,7 +281,7 @@ export interface ResponsesConversionError extends Error {
     eventId?: string;
     outputItemId?: string;
     sequenceNumber?: number;
-    context?: any;
+    context?: JsonObject;
 }
 export declare const RESPONSES_CONVERSION_ERROR_CODES: {
     readonly TIMEOUT: "RESPONSES_TIMEOUT";
@@ -323,6 +323,6 @@ export interface ResponsesSseEventStream extends AsyncIterable<ResponsesSseEvent
     on(event: 'complete', handler: () => void): this;
     on(event: 'timeout', handler: () => void): this;
     on(event: 'output_item', handler: (item: ResponsesOutputItem) => void): this;
-    on(event: 'content_part', handler: (part: any) => void): this;
+    on(event: 'content_part', handler: (part: ResponsesContent) => void): this;
     on(event: 'stats', handler: (stats: ResponsesEventStats) => void): this;
 }

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

@@ -2,6 +2,7 @@
  * SSE事件类型定义
  * 基于OpenAI Responses协议的事件规范
  */
+import type { JsonValue } from './core-interfaces.js';
 export type SseEventType = 'response.created' | 'response.in_progress' | 'response.completed' | 'response.required_action' | 'response.done' | 'response.output_item.added' | 'response.output_item.done' | 'response.content_part.added' | 'response.content_part.done' | 'response.output_text.delta' | 'response.output_text.done' | 'response.reasoning_text.delta' | 'response.reasoning_text.done' | 'response.function_call_arguments.delta' | 'response.function_call_arguments.done';
 export interface BaseSseEvent {
     type: SseEventType;
@@ -66,7 +67,7 @@ export interface OutputTextDeltaEvent extends BaseSseEvent {
     output_index: number;
     content_index: number;
     delta: string;
-    logprobs?: any[];
+    logprobs?: JsonValue[];
 }
 export interface OutputTextDoneEvent extends BaseSseEvent {
     type: 'response.output_text.done';
@@ -118,7 +119,7 @@ export interface OutputItem {
     type: 'reasoning' | 'message' | 'function_call' | 'system_message';
     status?: 'in_progress' | 'completed';
     content?: ContentPart[];
-    summary?: any[];
+    summary?: JsonValue[];
     role?: string;
     arguments?: string;
     call_id?: string;
@@ -173,7 +174,7 @@ export interface EventValidationRule {
     optionalFields: string[];
     dependencies: Array<{
         field: string;
-        condition: (event: any) => boolean;
+        condition: (event: Record<string, unknown>) => boolean;
         requiredFields: string[];
     }>;
 }