@jsonstudio/llms 0.6.0 → 0.6.6

package/dist/sse/sse-to-json/builders/response-builder.js

@@ -395,6 +395,36 @@ export class ResponsesResponseBuilder {
         outputItemState.arguments = '';
         outputItemState.lastEventTime = event.timestamp;
     }
+    coerceArgumentsChunk(raw) {
+        if (typeof raw === 'string') {
+            return raw;
+        }
+        if (raw && typeof raw === 'object') {
+            try {
+                return JSON.stringify(raw);
+            }
+            catch {
+                return String(raw);
+            }
+        }
+        return undefined;
+    }
+    shouldOverrideArguments(current, incoming) {
+        if (!incoming) {
+            return false;
+        }
+        const trimmed = incoming.trim();
+        if (!current || !current.length) {
+            return trimmed.length > 0;
+        }
+        if (!trimmed.length) {
+            return false;
+        }
+        if (trimmed === '{}' || trimmed.toLowerCase() === 'null') {
+            return false;
+        }
+        return true;
+    }
     /**
      * 处理function_call.delta事件
      */
@@ -404,10 +434,10 @@ export class ResponsesResponseBuilder {
         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') {
+        const chunk = this.coerceArgumentsChunk(data?.delta?.arguments) ??
+            this.coerceArgumentsChunk(data?.delta) ??
+            this.coerceArgumentsChunk(data?.arguments);
+        if (chunk) {
             outputItemState.arguments = (outputItemState.arguments || '') + chunk;
         }
         outputItemState.lastEventTime = event.timestamp;
@@ -445,8 +475,16 @@ export class ResponsesResponseBuilder {
                 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;
+            const finalChunk = this.coerceArgumentsChunk(data?.arguments) ??
+                this.coerceArgumentsChunk(data?.delta?.arguments) ??
+                this.coerceArgumentsChunk(data?.delta);
+            if (this.shouldOverrideArguments(outputItemState.arguments, finalChunk)) {
+                outputItemState.arguments = finalChunk;
+            }
+            else if (!outputItemState.arguments && finalChunk) {
+                // 没有任何累计增量时，保底写入 done 事件里的值
+                outputItemState.arguments = finalChunk;
+            }
         }
         catch { /* ignore */ }
         outputItemState.status = 'completed';
@@ -574,7 +612,30 @@ export class ResponsesResponseBuilder {
      * 处理required_action事件
      */
     handleRequiredAction(event) {
-        // TODO: 实现required_action处理
+        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事件
@@ -607,14 +668,17 @@ export class ResponsesResponseBuilder {
         this.state = 'error';
     }
     handleResponseCompleted(event) {
-        const data = event.data;
-        if (data?.usage) {
-            this.response.usage = data.usage;
+        const payload = event.data?.response ?? event.data;
+        const usage = (payload && payload.usage)
+            ? payload.usage
+            : event.data?.usage;
+        if (usage) {
+            this.response.usage = usage;
         }
         // 标准化完成态：部分上游的 response.completed 不包含 status 字段
         // 若未提供明确的完成状态，统一标记为 'completed'，而不是沿用之前的 in_progress。
-        this.response.status = (data && data.status != null)
-            ? data.status
+        this.response.status = (payload && payload.status != null)
+            ? payload.status
             : 'completed';
         // 将已聚合的输出写回并标记完成（若为空数组也重建）
         try {

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

@@ -3,6 +3,7 @@
  * 支持OpenAI Responses API的JSON↔SSE双向转换
  */
 import { BaseSseEvent, StreamDirection, type JsonObject, type JsonValue } from './core-interfaces.js';
+import type { RequiredAction } from './sse-events.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 {
@@ -118,6 +119,7 @@ export interface ResponsesResponse {
     output: ResponsesOutputItem[];
     previous_response_id?: string;
     usage?: ResponsesUsage;
+    required_action?: RequiredAction;
     temperature?: number;
     top_p?: number;
     max_output_tokens?: number;

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@jsonstudio/llms",
-  "version": "0.6.0",
+  "version": "0.6.006",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "build:dev": "tsc -p tsconfig.json",
+    "build": "node scripts/bump-version.mjs && tsc -p tsconfig.json",
+    "build:dev": "node scripts/bump-version.mjs && tsc -p tsconfig.json",
     "lint": "eslint --no-eslintrc -c .eslintrc.json src --ext .ts --no-cache",
     "lint:fix": "eslint --no-eslintrc -c .eslintrc.json src --ext .ts --no-cache --fix",
     "postbuild": "node scripts/tests/run-matrix-ci.mjs",