@jsonstudio/rcc 0.85.9 → 0.89.3

package/node_modules/@jsonstudio/llms/dist/sse/sse-to-json/builders/response-builder.js

@@ -0,0 +1,821 @@
+/**
+ * Responses响应构建器
+ * 负责状态机和事件聚合，从SSE事件构建完整的Responses响应对象
+ */
+import { normalizeResponsesMessageItem } from '../../shared/responses-output-normalizer.js';
+// 默认配置
+export const DEFAULT_RESPONSE_BUILDER_CONFIG = {
+    enableStrictValidation: true,
+    enableEventRecovery: true,
+    maxOutputItems: 50,
+    maxContentParts: 100,
+    maxSequenceGaps: 10
+};
+/**
+ * Responses响应构建器
+ */
+export class ResponsesResponseBuilder {
+    state = 'initial';
+    response = {};
+    outputItemBuilders = new Map();
+    lastSequenceNumber = -1;
+    config;
+    error;
+    constructor(config) {
+        this.config = { ...DEFAULT_RESPONSE_BUILDER_CONFIG, ...config };
+    }
+    /**
+     * 处理SSE事件
+     */
+    processEvent(event) {
+        try {
+            // 验证序列号
+            if (!this.validateSequenceNumber(event)) {
+                if (this.config.enableStrictValidation) {
+                    throw new Error(`Invalid sequence number: ${event.sequenceNumber}`);
+                }
+            }
+            // 更新状态
+            this.state = 'building';
+            this.lastSequenceNumber = event.sequenceNumber;
+            // 根据事件类型处理
+            switch (event.type) {
+                case 'response.created':
+                    this.handleResponseCreated(event);
+                    break;
+                case 'response.in_progress':
+                    this.handleResponseInProgress(event);
+                    break;
+                case 'response.output_item.added':
+                    this.handleOutputItemStart(this.mapOutputItemAdded(event));
+                    break;
+                case 'response.content_part.added':
+                    this.handleContentPartStart(this.mapContentPartAdded(event));
+                    break;
+                case 'response.output_text.delta':
+                    this.handleContentPartDelta(this.mapOutputTextDelta(event));
+                    break;
+                case 'response.output_text.done':
+                    this.handleContentPartDone(this.mapContentPartDone(event));
+                    break;
+                case 'response.function_call_arguments.delta':
+                    this.handleFunctionCallDelta(this.mapFunctionCallDelta(event));
+                    break;
+                case 'response.function_call_arguments.done':
+                    this.handleFunctionCallDone(this.mapFunctionCallDone(event));
+                    break;
+                case 'response.reasoning_text.delta':
+                case 'response.reasoning_signature.delta':
+                case 'response.reasoning_image.delta':
+                    this.handleReasoningDelta(this.mapReasoningDelta(event));
+                    break;
+                case 'response.reasoning_text.done':
+                    this.handleReasoningDone(this.mapReasoningDone(event));
+                    break;
+                case 'response.completed':
+                    this.handleResponseCompleted(event);
+                    break;
+                case 'response.start':
+                    this.handleResponseStart(event);
+                    break;
+                case 'output_item.start':
+                    this.handleOutputItemStart(event);
+                    break;
+                case 'content_part.start':
+                    this.handleContentPartStart(event);
+                    break;
+                case 'content_part.delta':
+                    this.handleContentPartDelta(event);
+                    break;
+                case 'content_part.done':
+                    this.handleContentPartDone(event);
+                    break;
+                case 'function_call.start':
+                    this.handleFunctionCallStart(event);
+                    break;
+                case 'function_call.delta':
+                    this.handleFunctionCallDelta(event);
+                    break;
+                case 'function_call.done':
+                    this.handleFunctionCallDone(event);
+                    break;
+                case 'reasoning.start':
+                    this.handleReasoningStart(event);
+                    break;
+                case 'reasoning.delta':
+                    this.handleReasoningDelta(event);
+                    break;
+                case 'reasoning.done':
+                    this.handleReasoningDone(event);
+                    break;
+                case 'output_item.done':
+                    this.handleOutputItemDone(event);
+                    break;
+                case 'required_action':
+                    this.handleRequiredAction(event);
+                    break;
+                case 'response.done':
+                    this.handleResponseDone(event);
+                    break;
+                case 'response.content_part.done':
+                    this.handleContentPartDone(event);
+                    break;
+                case 'error':
+                    this.handleError(event);
+                    break;
+                default:
+                    if (this.config.enableStrictValidation) {
+                        throw new Error(`Unknown event type: ${event.type}`);
+                    }
+            }
+            return true;
+        }
+        catch (error) {
+            this.error = error;
+            this.state = 'error';
+            return false;
+        }
+    }
+    /**
+     * 验证序列号
+     */
+    validateSequenceNumber(event) {
+        if (event.sequenceNumber <= this.lastSequenceNumber) {
+            return false;
+        }
+        const gap = event.sequenceNumber - this.lastSequenceNumber;
+        if (gap > 1 && gap > this.config.maxSequenceGaps) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * 处理response.start事件
+     */
+    handleResponseStart(event) {
+        const data = event.data;
+        this.response = {
+            id: data.id ?? this.response.id,
+            object: 'response',
+            created_at: data.created_at ?? this.response.created_at,
+            status: data.status ?? 'in_progress',
+            model: data.model ?? this.response.model,
+            user: data.user ?? this.response.user,
+            temperature: data.temperature ?? this.response.temperature,
+            top_p: data.top_p ?? this.response.top_p,
+            max_output_tokens: data.max_output_tokens ?? this.response.max_output_tokens,
+            metadata: data.metadata ?? this.response.metadata,
+            output: this.response.output ?? []
+        };
+    }
+    handleResponseCreated(event) {
+        const data = event.data?.response ?? event.data;
+        this.handleResponseStart({
+            ...event,
+            type: 'response.start',
+            data
+        });
+    }
+    handleResponseInProgress(event) {
+        const data = event.data;
+        if (!this.response)
+            return;
+        this.response.status = data.status ?? this.response.status ?? 'in_progress';
+    }
+    /**
+     * 处理output_item.start事件
+     */
+    handleOutputItemStart(event) {
+        const data = event.data;
+        if (this.outputItemBuilders.size >= this.config.maxOutputItems) {
+            throw new Error('Maximum output items exceeded');
+        }
+        const outputItemState = {
+            id: data.item_id,
+            type: data.type,
+            status: 'in_progress',
+            contentParts: data.content_index !== undefined ? [] : [],
+            currentContentIndex: 0,
+            accumulatedContent: [],
+            hasContentPartAdded: false,
+            isTextInProgress: false,
+            role: data.role,
+            callId: data.call_id,
+            name: data.name,
+            startTime: event.timestamp,
+            lastEventTime: event.timestamp
+        };
+        this.outputItemBuilders.set(data.item_id, outputItemState);
+    }
+    mapOutputItemAdded(event) {
+        const data = event.data;
+        const item = data.item || {};
+        const rawType = item.type ?? data.item_type ?? data.type;
+        let normalizedType = typeof rawType === 'string'
+            ? rawType.replace(/^response\./, '')
+            : 'message';
+        // 将自定义工具调用规整为标准 function_call，便于后续统一转换为 Chat 工具调用
+        if (normalizedType === 'custom_tool_call')
+            normalizedType = 'function_call';
+        return {
+            ...event,
+            type: 'output_item.start',
+            data: {
+                item_id: data.item_id ?? item.id,
+                type: normalizedType,
+                status: data.status ?? item.status ?? 'in_progress',
+                role: data.role ?? item.role,
+                call_id: data.call_id ?? item.call_id,
+                name: data.name ?? item.name
+            }
+        };
+    }
+    /**
+     * 处理content_part.start事件
+     */
+    handleContentPartStart(event) {
+        const data = event.data;
+        const outputItemState = this.outputItemBuilders.get(data.item_id);
+        if (!outputItemState) {
+            throw new Error(`Output item not found: ${data.item_id}`);
+        }
+        if (outputItemState.contentParts.length >= this.config.maxContentParts &&
+            data.content_index === undefined) {
+            throw new Error('Maximum content parts exceeded');
+        }
+        const contentIndex = data.content_index ?? outputItemState.contentParts.length;
+        const lookupKey = data[data.type] ? data.type :
+            data.text ? 'text' :
+                data.output_text ? 'output_text' :
+                    undefined;
+        let contentPart = data[data.type];
+        if (!contentPart && lookupKey === 'text') {
+            const textValue = typeof data.text === 'string' ? data.text : data.text?.text;
+            contentPart = { type: data.type ?? 'output_text', text: textValue ?? '' };
+        }
+        else if (!contentPart && lookupKey === 'output_text') {
+            const textValue = typeof data.output_text === 'string' ? data.output_text : data.output_text?.text;
+            contentPart = { type: 'output_text', text: textValue ?? '' };
+        }
+        else if (!contentPart && typeof data.text === 'string') {
+            contentPart = { type: data.type ?? 'output_text', text: data.text };
+        }
+        if (!contentPart) {
+            contentPart = data[data.type === 'input_text' ? 'text' : data.type] || {
+                type: data.type ?? 'output_text',
+                text: ''
+            };
+        }
+        if (data.content_index !== undefined && contentPart.text !== undefined) {
+            contentPart._initialText = contentPart.text || '';
+            contentPart._hasDelta = false;
+            contentPart.text = '';
+        }
+        outputItemState.contentParts[contentIndex] = contentPart;
+        outputItemState.hasContentPartAdded = true;
+        outputItemState.lastEventTime = event.timestamp;
+        outputItemState.currentContentIndex = contentIndex;
+    }
+    mapContentPartAdded(event) {
+        const data = event.data;
+        const part = data.part || {};
+        const normalizedType = part.type ?? data.type ?? 'output_text';
+        const textValue = typeof part.text === 'string'
+            ? part.text
+            : (typeof data.text === 'string' ? data.text : '');
+        return {
+            ...event,
+            type: 'content_part.start',
+            data: {
+                item_id: data.item_id ?? part.item_id,
+                type: normalizedType,
+                content_index: data.content_index,
+                text: textValue,
+                output_text: normalizedType === 'output_text' ? { type: 'output_text', text: textValue ?? '' } : undefined
+            }
+        };
+    }
+    /**
+     * 处理content_part.delta事件
+     */
+    handleContentPartDelta(event) {
+        const data = event.data;
+        const outputItemState = this.outputItemBuilders.get(data.item_id);
+        if (!outputItemState) {
+            throw new Error(`Output item not found: ${data.item_id}`);
+        }
+        const contentIndex = data.part_index ?? data.content_index ?? outputItemState.currentContentIndex;
+        const contentPart = outputItemState.contentParts[contentIndex];
+        if (!contentPart) {
+            throw new Error(`Content part not found: ${contentIndex}`);
+        }
+        if ((contentPart.type === 'input_text' || contentPart.type === 'output_text')) {
+            const deltaChunk = typeof data.delta === 'string'
+                ? data.delta
+                : data.delta?.text;
+            if (deltaChunk) {
+                contentPart.text = (contentPart.text || '') + deltaChunk;
+                contentPart._hasDelta = true;
+            }
+        }
+        else if (contentPart.type === 'function_call') {
+            const argDelta = typeof data.delta === 'string'
+                ? data.delta
+                : data.delta?.arguments;
+            if (argDelta) {
+                contentPart.arguments = (contentPart.arguments || '') + argDelta;
+            }
+        }
+        outputItemState.isTextInProgress = true;
+        outputItemState.lastEventTime = event.timestamp;
+    }
+    mapOutputTextDelta(event) {
+        const data = event.data;
+        return {
+            ...event,
+            type: 'content_part.delta',
+            data: {
+                item_id: data.item_id,
+                part_index: data.content_index,
+                delta: {
+                    type: 'output_text',
+                    text: data.delta
+                }
+            }
+        };
+    }
+    /**
+     * 处理content_part.done事件
+     */
+    handleContentPartDone(event) {
+        const data = event.data;
+        const outputItemState = this.outputItemBuilders.get(data.item_id);
+        if (!outputItemState) {
+            throw new Error(`Output item not found: ${data.item_id}`);
+        }
+        const contentIndex = data.content_index ?? data.part_index ?? outputItemState.currentContentIndex;
+        if (contentIndex !== undefined) {
+            const contentPart = outputItemState.contentParts[contentIndex];
+            if (contentPart &&
+                contentPart._hasDelta !== true &&
+                contentPart._initialText &&
+                !contentPart.text) {
+                contentPart.text = contentPart._initialText;
+            }
+            outputItemState.currentContentIndex = contentIndex + 1;
+        }
+        else {
+            outputItemState.currentContentIndex++;
+        }
+        outputItemState.isTextInProgress = false;
+        outputItemState.lastEventTime = event.timestamp;
+    }
+    mapContentPartDone(event) {
+        const data = event.data;
+        return {
+            ...event,
+            type: 'content_part.done',
+            data: {
+                item_id: data.item_id,
+                part_index: data.content_index ?? data.part_index
+            }
+        };
+    }
+    /**
+     * 处理function_call.start事件
+     */
+    handleFunctionCallStart(event) {
+        const data = event.data;
+        const outputItemState = this.outputItemBuilders.get(data.item_id);
+        if (!outputItemState) {
+            throw new Error(`Output item not found: ${data.item_id}`);
+        }
+        outputItemState.callId = data.call_id;
+        outputItemState.name = data.name;
+        outputItemState.arguments = '';
+        outputItemState.lastEventTime = event.timestamp;
+    }
+    /**
+     * 处理function_call.delta事件
+     */
+    handleFunctionCallDelta(event) {
+        const data = event.data;
+        const outputItemState = this.outputItemBuilders.get(data.item_id);
+        if (!outputItemState) {
+            throw new Error(`Output item not found: ${data.item_id}`);
+        }
+        const chunk = (data && data.delta && typeof data.delta === 'object' && typeof data.delta.arguments === 'string')
+            ? String(data.delta.arguments)
+            : (typeof (data?.delta) === 'string' ? String(data.delta) : (typeof data?.arguments === 'string' ? String(data.arguments) : undefined));
+        if (typeof chunk === 'string') {
+            outputItemState.arguments = (outputItemState.arguments || '') + chunk;
+        }
+        outputItemState.lastEventTime = event.timestamp;
+    }
+    mapFunctionCallDelta(event) {
+        const data = event.data;
+        const deltaObj = (data.delta && typeof data.delta === 'object') ? data.delta : undefined;
+        const argChunk = typeof data.delta === 'string'
+            ? data.delta
+            : (deltaObj && typeof deltaObj.arguments === 'string' ? deltaObj.arguments : (typeof data.arguments === 'string' ? data.arguments : undefined));
+        return {
+            ...event,
+            type: 'function_call.delta',
+            data: {
+                item_id: data.item_id,
+                delta: {
+                    arguments: argChunk,
+                    name: deltaObj?.name ?? data.name
+                }
+            }
+        };
+    }
+    /**
+     * 处理function_call.done事件
+     */
+    handleFunctionCallDone(event) {
+        const data = event.data;
+        const outputItemState = this.outputItemBuilders.get(data.item_id);
+        if (!outputItemState) {
+            throw new Error(`Output item not found: ${data.item_id}`);
+        }
+        // 写入最终的 name/arguments（Responses: response.function_call_arguments.done）
+        try {
+            if (typeof data.name === 'string' && data.name)
+                outputItemState.name = data.name;
+            if (typeof data.call_id === 'string' && data.call_id)
+                outputItemState.callId = data.call_id;
+            if (typeof data.arguments === 'string' && data.arguments)
+                outputItemState.arguments = data.arguments;
+        }
+        catch { /* ignore */ }
+        outputItemState.status = 'completed';
+        outputItemState.lastEventTime = event.timestamp;
+    }
+    mapFunctionCallDone(event) {
+        const data = event.data;
+        const delta = (data.delta && typeof data.delta === 'object') ? data.delta : {};
+        return {
+            ...event,
+            type: 'function_call.done',
+            data: {
+                item_id: data.item_id,
+                call_id: data.call_id,
+                name: data.name ?? delta.name,
+                arguments: data.arguments ?? delta.arguments
+            }
+        };
+    }
+    /**
+     * 处理reasoning.start事件
+     */
+    handleReasoningStart(event) {
+        const data = event.data;
+        const outputItemState = this.outputItemBuilders.get(data.item_id);
+        if (!outputItemState) {
+            throw new Error(`Output item not found: ${data.item_id}`);
+        }
+        outputItemState.accumulatedContent = data.summary || [];
+        outputItemState.lastEventTime = event.timestamp;
+    }
+    /**
+     * 处理reasoning.delta事件
+     */
+    handleReasoningDelta(event) {
+        const data = event.data;
+        const outputItemState = this.outputItemBuilders.get(data.item_id);
+        if (!outputItemState) {
+            throw new Error(`Output item not found: ${data.item_id}`);
+        }
+        outputItemState.accumulatedContent.push(data.delta);
+        outputItemState.lastEventTime = event.timestamp;
+    }
+    mapReasoningDelta(event) {
+        const data = event.data;
+        return {
+            ...event,
+            type: 'reasoning.delta',
+            data: {
+                item_id: data.item_id,
+                delta: {
+                    type: event.type === 'response.reasoning_signature.delta'
+                        ? 'reasoning_signature'
+                        : event.type === 'response.reasoning_image.delta'
+                            ? 'reasoning_image'
+                            : 'reasoning_text',
+                    text: data.delta,
+                    signature: data.signature,
+                    image_url: data.image_url
+                }
+            }
+        };
+    }
+    mapReasoningDone(event) {
+        return {
+            ...event,
+            type: 'reasoning.done'
+        };
+    }
+    /**
+     * 处理reasoning.done事件
+     */
+    handleReasoningDone(event) {
+        const data = event.data;
+        const outputItemState = this.outputItemBuilders.get(data.item_id);
+        if (!outputItemState) {
+            throw new Error(`Output item not found: ${data.item_id}`);
+        }
+        outputItemState.status = 'completed';
+        outputItemState.lastEventTime = event.timestamp;
+    }
+    /**
+     * 处理output_item.done事件
+     */
+    handleOutputItemDone(event) {
+        const data = event.data;
+        const outputItemState = this.outputItemBuilders.get(data.item_id);
+        if (!outputItemState) {
+            throw new Error(`Output item not found: ${data.item_id}`);
+        }
+        // 若为 custom_tool_call 变体（已在 start 阶段重命名为 function_call），尝试提取 name/arguments
+        try {
+            const item = data.item || {};
+            if (outputItemState.type === 'function_call') {
+                if (!outputItemState.name && typeof item.name === 'string')
+                    outputItemState.name = item.name;
+                if (!outputItemState.callId && typeof item.call_id === 'string')
+                    outputItemState.callId = item.call_id;
+                if (!outputItemState.arguments) {
+                    const input = item.input;
+                    if (typeof input === 'string') {
+                        try {
+                            outputItemState.arguments = JSON.stringify({ input });
+                        }
+                        catch {
+                            outputItemState.arguments = JSON.stringify({ input: String(input) });
+                        }
+                    }
+                    else if (input && typeof input === 'object') {
+                        try {
+                            outputItemState.arguments = JSON.stringify(input);
+                        }
+                        catch {
+                            outputItemState.arguments = '{}';
+                        }
+                    }
+                }
+            }
+        }
+        catch { /* ignore */ }
+        outputItemState.status = 'completed';
+        outputItemState.lastEventTime = event.timestamp;
+    }
+    /**
+     * 处理required_action事件
+     */
+    handleRequiredAction(event) {
+        const payload = event.data ?? {};
+        const responsePayload = payload.response ?? payload;
+        const requiredAction = responsePayload.required_action ??
+            payload.required_action ??
+            undefined;
+        const usage = responsePayload.usage ??
+            payload.usage ??
+            this.response.usage;
+        const nextResponse = {
+            ...this.response,
+            object: 'response',
+            id: responsePayload.id ?? this.response.id,
+            status: responsePayload.status ?? 'requires_action',
+            output: Array.isArray(responsePayload.output) && responsePayload.output.length
+                ? responsePayload.output
+                : this.buildOutputItems(),
+            required_action: requiredAction ?? this.response.required_action,
+            usage
+        };
+        if (responsePayload.metadata) {
+            nextResponse.metadata = responsePayload.metadata;
+        }
+        this.response = nextResponse;
+        this.state = 'completed';
+    }
+    /**
+     * 处理response.done事件
+     */
+    handleResponseDone(event) {
+        const data = event.data?.response ?? event.data;
+        const usage = data?.usage ?? event.data?.usage;
+        this.response = {
+            ...this.response,
+            id: data?.id ?? this.response.id,
+            status: data?.status ?? 'completed',
+            output: this.buildOutputItems(),
+            usage: usage ?? this.response.usage
+        };
+        this.state = 'completed';
+    }
+    /**
+     * 处理错误事件
+     */
+    handleError(event) {
+        const payload = event.data;
+        const msg = typeof payload?.error?.message === 'string' ? payload.error.message : undefined;
+        // 容错：若无有效错误消息或当前响应已标记 completed，则将错误降级为非致命告警
+        const status = this.response?.status;
+        if (!msg || status === 'completed' || this.config.enableEventRecovery) {
+            // keep building; do not flip to error state
+            return;
+        }
+        this.error = new Error(msg || 'Unknown error');
+        this.state = 'error';
+    }
+    handleResponseCompleted(event) {
+        const data = event.data;
+        if (data?.usage) {
+            this.response.usage = data.usage;
+        }
+        // 标准化完成态：部分上游的 response.completed 不包含 status 字段
+        // 若未提供明确的完成状态，统一标记为 'completed'，而不是沿用之前的 in_progress。
+        this.response.status = (data && data.status != null)
+            ? data.status
+            : 'completed';
+        // 将已聚合的输出写回并标记完成（若为空数组也重建）
+        try {
+            const cur = this.response.output;
+            if (!Array.isArray(cur) || cur.length === 0) {
+                this.response.output = this.buildOutputItems();
+            }
+        }
+        catch {
+            this.response.output = this.buildOutputItems();
+        }
+        this.state = 'completed';
+    }
+    /**
+     * 构建输出项列表
+     */
+    buildOutputItems() {
+        const outputItems = [];
+        for (const [itemId, state] of this.outputItemBuilders) {
+            let outputItem;
+            switch (state.type) {
+                case 'message':
+                    {
+                        const { message, reasoning } = this.buildMessageItem(state);
+                        if (reasoning) {
+                            outputItems.push(reasoning);
+                        }
+                        outputItem = message;
+                        break;
+                    }
+                case 'function_call':
+                    outputItem = this.buildFunctionCallItem(state);
+                    break;
+                case 'reasoning':
+                    outputItem = this.buildReasoningItem(state);
+                    break;
+                default:
+                    throw new Error(`Unknown output item type: ${state.type}`);
+            }
+            outputItems.push(outputItem);
+        }
+        const hasMessage = outputItems.some(item => item.type === 'message');
+        const hasReasoning = outputItems.some(item => item.type === 'reasoning');
+        if (!hasMessage && hasReasoning) {
+            outputItems.push({
+                id: `message_placeholder_${outputItems.length + 1}`,
+                type: 'message',
+                status: 'completed',
+                role: 'assistant',
+                content: [{ type: 'output_text', text: '' }]
+            });
+        }
+        return outputItems;
+    }
+    /**
+     * 构建消息项并根据需要拆分reasoning
+     */
+    buildMessageItem(state) {
+        return normalizeResponsesMessageItem({
+            id: state.id,
+            type: 'message',
+            status: 'completed',
+            role: state.role || 'assistant',
+            content: state.contentParts
+        }, {
+            requestId: state.id || 'message',
+            outputIndex: 0
+        });
+    }
+    /**
+     * 构建函数调用项
+     */
+    buildFunctionCallItem(state) {
+        return {
+            id: state.id,
+            type: 'function_call',
+            status: 'completed',
+            call_id: state.callId || '',
+            name: state.name || '',
+            arguments: state.arguments || ''
+        };
+    }
+    /**
+     * 构建推理项
+     */
+    buildReasoningItem(state) {
+        return {
+            id: state.id,
+            type: 'reasoning',
+            summary: Array.isArray(state.accumulatedContent) ? state.accumulatedContent.filter(item => typeof item === 'string') : [],
+            content: state.accumulatedContent.filter(item => typeof item === 'object')
+        };
+    }
+    /**
+     * 获取构建结果
+     */
+    getResult() {
+        if (this.state === 'error') {
+            return { success: false, error: this.error };
+        }
+        if (this.state === 'completed') {
+            return { success: true, response: this.response };
+        }
+        // 容错：部分上游以 response.completed 作为终结事件，不再发送 response.done。
+        // 若状态仍为 building 但已收到 response.completed 且 response.status=completed，视为成功聚合。
+        try {
+            const status = this.response?.status;
+            if (status === 'completed') {
+                // 确保输出结构完整
+                try {
+                    const cur = this.response.output;
+                    if (!Array.isArray(cur) || cur.length === 0) {
+                        this.response.output = this.buildOutputItems();
+                    }
+                }
+                catch {
+                    this.response.output = this.buildOutputItems();
+                }
+                return { success: true, response: this.response };
+            }
+            // 进一步容错：有些上游不发送 response.completed/response.done，仅发送 output_item.done 后直接结束流。
+            // 若至少存在一个已完成的输出项，则按 completed 视为成功。
+            let anyCompleted = false;
+            for (const [, st] of this.outputItemBuilders) {
+                if (st.status === 'completed') {
+                    anyCompleted = true;
+                    break;
+                }
+            }
+            if (anyCompleted) {
+                this.response.status = 'completed';
+                try {
+                    const cur = this.response.output;
+                    if (!Array.isArray(cur) || cur.length === 0) {
+                        this.response.output = this.buildOutputItems();
+                    }
+                }
+                catch {
+                    this.response.output = this.buildOutputItems();
+                }
+                return { success: true, response: this.response };
+            }
+        }
+        catch { /* ignore */ }
+        return { success: false, error: new Error('Building not completed') };
+    }
+    /**
+     * 获取当前状态
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * 重置构建器
+     */
+    reset() {
+        this.state = 'initial';
+        this.response = {};
+        this.outputItemBuilders.clear();
+        this.lastSequenceNumber = -1;
+        this.error = undefined;
+    }
+    /**
+     * 获取输出项构建器
+     */
+    getOutputItemBuilders() {
+        return new Map(this.outputItemBuilders);
+    }
+    /**
+     * 获取最后序列号
+     */
+    getLastSequenceNumber() {
+        return this.lastSequenceNumber;
+    }
+}
+/**
+ * 创建响应构建器工厂
+ */
+export function createResponseBuilder(config) {
+    return new ResponsesResponseBuilder(config);
+}