@acosmi/sdk-ts 2.19.3 → 2.19.5

package/dist/node/{openai-mkTSir6E.d.ts → openai-Cuu_DPxM.d.cts}

@@ -1,4 +1,4 @@
-import { P as ProviderAdapter, p as ProviderFormat, n as ModelCapabilities, e as ChatRequest, f as ChatResponse, y as StreamEvent } from './index-CqxPqbsl.js';
+import { P as ProviderAdapter, p as ProviderFormat, n as ModelCapabilities, e as ChatRequest, f as ChatResponse, z as StreamEvent } from './format-DWA12pVT.cjs';
 
 /**
  * Anthropic 内容块
@@ -121,8 +121,18 @@ declare class OpenAIStreamConverter {
     private toolArgsAccum;
     /** 上一次解析出的 tool 键，供缺 index 且缺 id 的后续增量沿用。 */
     private lastToolKey;
-    /** 已发出 message_delta/message_stop，避免 finish_reason 与 `[DONE]` 各收一次。 */
+    /** 已发出 message_delta/message_stop，避免 finish_reason、usage 尾帧、`[DONE]` 与
+     *  {@link flush} 重复收口 —— 整条流恰好一个 message_stop。 */
     private messageClosed;
+    /** 已为仍打开的块发出 content_block_stop。与 {@link messageClosed} 分开记：块在
+     *  finish_reason 帧上就关，message_delta/message_stop 却可能推迟到之后的帧。 */
+    private blocksClosed;
+    /** [W-QUAD-CHAIN-20260914] finish_reason 已到、但 message_delta/message_stop 因等待
+     *  usage 尾帧而推迟时记下的 stop_reason；没有推迟中的收尾时为 null。 */
+    private pendingStopReason;
+    /** [W-QUAD-CHAIN-20260914] 最近一次带 usage 对象的帧搬出的 usage（后到覆盖先到）；
+     *  整条流从未出现 usage 对象时为 null，收尾 message_delta 据此不写 usage 键。 */
+    private usage;
     /**
      * 解析一条 tool_call delta 归属的块键。
      *
@@ -134,13 +144,24 @@ declare class OpenAIStreamConverter {
      */
     private resolveToolKey;
     /**
-     * 关闭仍打开的 text / thinking / tool 块，并收口 message。
+     * 关闭仍打开的 text / thinking / tool 块（整条流只关一次）。
      *
      * 由 `finish_reason` 分支与 `[DONE]` 分支共用：上游断流或只发 `[DONE]` 而不发
      * `finish_reason` 时，此前一个 `content_block_stop` 都不会发，下游拿到的是一个
      * 永不闭合的 tool_use 块。
+     *
+     * [W-QUAD-CHAIN-20260914] 此前关块与 message_delta/message_stop 是同一个方法里同一时刻
+     * 的事；usage 尾帧要求收尾推迟，于是拆成本方法与 {@link emitMessageEnd} 两段，各自防重。
+     */
+    private closeContentBlocks;
+    /**
+     * 发出 message_delta + message_stop，整条流只发一次；同时清掉推迟中的收尾。
+     *
+     * 见过 usage 对象就把它放进 message_delta：usage 必须出现在唯一的 message_stop 之前，
+     * message_stop 之后下游已无处安放用量。整条流从未出现 usage 对象时不写 usage 键 ——
+     * 缺席表示「上游没给」，不是 0。
      */
-    private closeOpenBlocks;
+    private emitMessageEnd;
     /**
      * 将一行 OpenAI SSE data 转换为零或多个 Anthropic 格式 StreamEvent
      * 返回 { events, done }
@@ -149,6 +170,15 @@ declare class OpenAIStreamConverter {
         events: StreamEvent[];
         done: boolean;
     };
+    /**
+     * 流在**没有** `[DONE]` 的情况下结束 (EOF) 时, 由驱动方在读循环结束后调用一次。
+     *
+     * 只补发「finish_reason 已到、仅因等待 usage 尾帧而推迟」的 message_delta + message_stop。
+     * 从未收到 finish_reason 的流是被截断的流, 这里刻意**不**替它伪造正常结束 —— 一个
+     * `end_turn` 的 message_stop 会把被截断的回答当成完整回答交给下游。
+     * 已经收口 (usage 帧 / `[DONE]` / 上一次 flush) 后再调用返回空数组, 不会发出第二个 message_stop。
+     */
+    flush(): StreamEvent[];
 }
 declare function newOpenAIStreamConverter(): OpenAIStreamConverter;
 

package/dist/node/{openai-Ce85qh14.d.cts → openai-DsbJUOOW.d.ts}

@@ -1,4 +1,4 @@
-import { P as ProviderAdapter, p as ProviderFormat, n as ModelCapabilities, e as ChatRequest, f as ChatResponse, y as StreamEvent } from './index-CqxPqbsl.cjs';
+import { P as ProviderAdapter, p as ProviderFormat, n as ModelCapabilities, e as ChatRequest, f as ChatResponse, z as StreamEvent } from './format-DWA12pVT.js';
 
 /**
  * Anthropic 内容块
@@ -121,8 +121,18 @@ declare class OpenAIStreamConverter {
     private toolArgsAccum;
     /** 上一次解析出的 tool 键，供缺 index 且缺 id 的后续增量沿用。 */
     private lastToolKey;
-    /** 已发出 message_delta/message_stop，避免 finish_reason 与 `[DONE]` 各收一次。 */
+    /** 已发出 message_delta/message_stop，避免 finish_reason、usage 尾帧、`[DONE]` 与
+     *  {@link flush} 重复收口 —— 整条流恰好一个 message_stop。 */
     private messageClosed;
+    /** 已为仍打开的块发出 content_block_stop。与 {@link messageClosed} 分开记：块在
+     *  finish_reason 帧上就关，message_delta/message_stop 却可能推迟到之后的帧。 */
+    private blocksClosed;
+    /** [W-QUAD-CHAIN-20260914] finish_reason 已到、但 message_delta/message_stop 因等待
+     *  usage 尾帧而推迟时记下的 stop_reason；没有推迟中的收尾时为 null。 */
+    private pendingStopReason;
+    /** [W-QUAD-CHAIN-20260914] 最近一次带 usage 对象的帧搬出的 usage（后到覆盖先到）；
+     *  整条流从未出现 usage 对象时为 null，收尾 message_delta 据此不写 usage 键。 */
+    private usage;
     /**
      * 解析一条 tool_call delta 归属的块键。
      *
@@ -134,13 +144,24 @@ declare class OpenAIStreamConverter {
      */
     private resolveToolKey;
     /**
-     * 关闭仍打开的 text / thinking / tool 块，并收口 message。
+     * 关闭仍打开的 text / thinking / tool 块（整条流只关一次）。
      *
      * 由 `finish_reason` 分支与 `[DONE]` 分支共用：上游断流或只发 `[DONE]` 而不发
      * `finish_reason` 时，此前一个 `content_block_stop` 都不会发，下游拿到的是一个
      * 永不闭合的 tool_use 块。
+     *
+     * [W-QUAD-CHAIN-20260914] 此前关块与 message_delta/message_stop 是同一个方法里同一时刻
+     * 的事；usage 尾帧要求收尾推迟，于是拆成本方法与 {@link emitMessageEnd} 两段，各自防重。
+     */
+    private closeContentBlocks;
+    /**
+     * 发出 message_delta + message_stop，整条流只发一次；同时清掉推迟中的收尾。
+     *
+     * 见过 usage 对象就把它放进 message_delta：usage 必须出现在唯一的 message_stop 之前，
+     * message_stop 之后下游已无处安放用量。整条流从未出现 usage 对象时不写 usage 键 ——
+     * 缺席表示「上游没给」，不是 0。
      */
-    private closeOpenBlocks;
+    private emitMessageEnd;
     /**
      * 将一行 OpenAI SSE data 转换为零或多个 Anthropic 格式 StreamEvent
      * 返回 { events, done }
@@ -149,6 +170,15 @@ declare class OpenAIStreamConverter {
         events: StreamEvent[];
         done: boolean;
     };
+    /**
+     * 流在**没有** `[DONE]` 的情况下结束 (EOF) 时, 由驱动方在读循环结束后调用一次。
+     *
+     * 只补发「finish_reason 已到、仅因等待 usage 尾帧而推迟」的 message_delta + message_stop。
+     * 从未收到 finish_reason 的流是被截断的流, 这里刻意**不**替它伪造正常结束 —— 一个
+     * `end_turn` 的 message_stop 会把被截断的回答当成完整回答交给下游。
+     * 已经收口 (usage 帧 / `[DONE]` / 上一次 flush) 后再调用返回空数组, 不会发出第二个 message_stop。
+     */
+    flush(): StreamEvent[];
 }
 declare function newOpenAIStreamConverter(): OpenAIStreamConverter;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acosmi/sdk-ts",
-  "version": "2.19.3",
+  "version": "2.19.5",
   "description": "Acosmi TypeScript SDK：模型网关、Agent Run Gateway 与 Compliance（电子证据、时间章、报告、签署 envelope）统一客户端，支持浏览器 / Node ≥18 / Deno / Bun。",
   "type": "module",
   "main": "./dist/node/index.cjs",