@acosmi/sdk-ts 2.19.6 → 2.20.0

package/dist/node/{openai-CH0wnJXv.d.ts → openai-BNJe_o8L.d.ts}

@@ -1,4 +1,4 @@
-import { P as ProviderAdapter, p as ProviderFormat, n as ModelCapabilities, e as ChatRequest, f as ChatResponse, z as StreamEvent } from './format-CKpXSSqY.js';
+import { P as ProviderAdapter, p as ProviderFormat, n as ModelCapabilities, e as ChatRequest, f as ChatResponse, D as StreamEvent } from './format-BBXu82tQ.js';
 
 /**
  * Anthropic 内容块

package/dist/node/{openai-ByUO-cSR.d.cts → openai-DauG8pfK.d.cts}

@@ -1,4 +1,4 @@
-import { P as ProviderAdapter, p as ProviderFormat, n as ModelCapabilities, e as ChatRequest, f as ChatResponse, z as StreamEvent } from './format-CKpXSSqY.cjs';
+import { P as ProviderAdapter, p as ProviderFormat, n as ModelCapabilities, e as ChatRequest, f as ChatResponse, D as StreamEvent } from './format-BBXu82tQ.cjs';
 
 /**
  * Anthropic 内容块

package/docs//345/274/200/345/217/221/344/270/216/345/217/221/345/270/203/346/211/213/345/206/214.md

@@ -255,7 +255,7 @@ git commit -m "fix: ..."
 - `client.subscription.getMembership(signal?)` — 当前会员视图（**取代** `listUserSubscriptions`，后者已废弃）。
 - `client.subscription.getSubscriptionTier(signal?)` — 订阅档位。
 - `client.subscription.subscriptionPrecheck(req, signal?)` — 升级前置校验。
-- 同版本 `ManagedModel` 新增档位门控字段 `locked` / `freeTier` / `minPlanTier` / `chatRuntimeSupported` / `defaultToolIds`，供 C 端聊天模型选择器按会员档位加锁 / 分区。废弃 `ModelCoefficient` / `listCoefficients`（系数退役恒空）与 `ManagedModel.pricePerMTok` / `isDefault`（公开端点不返回）。
+- 同版本 `ManagedModel` 新增档位门控字段 `locked` / `freeTier` / `minPlanTier` / `chatRuntimeSupported` / `defaultToolIds`，供 C 端聊天模型选择器按会员档位加锁 / 分区。废弃 `ModelCoefficient` / `listCoefficients`（系数退役恒空）与 `ManagedModel.pricePerMTok` / `isDefault`（公开端点不返回）。（**v2.20.0 起 `freeTier` 不再是展示分区依据**，见下文「订阅双池展示契约」。）
 
 红线：
 - 下游产品禁止直连 Nexus 内部 `/api/v4/chat/completions` 或 `/api/v4/managed-models/:id/...` 来实现智能体循环。
@@ -270,6 +270,20 @@ git commit -m "fix: ..."
 - `create`、`submitLocalToolResult` 等可能产生副作用的 POST 遇到 401 不自动 refresh 后重放，避免重复创建或重复计费；GET/stream/download 这类安全查询允许单次 refresh 重试。
 - SDK 不内置 CrabDesign/CrabCode/CrabClaw 专属本地文件读取逻辑；`local_tool_request` 只定义协议，handler 必须由下游显式传入；`allowedTools` 使用 ASCII function name。
 
+### 订阅双池展示契约（v2.20.0，方案 D-14）
+
+`GET /api/v4/entitlements/quota-summary` 与 `GET /api/v4/managed-models` 追加三个**全可选**字段，SDK 只做类型面追加，响应体原样透传：
+
+| 位置 | 字段 | 含义 | 缺席时 |
+|---|---|---|---|
+| `QuotaSummary` | `freePool?: QuotaSummaryFreePool` | 付费合同自带的精选免费池 F：`quota` / `used` / `remaining`（微 Credits）、可选 `expiresAt`、`unit: 'MICRO_CREDIT'`、`eligibleModels: string[]`（可为空数组） | 老合同没有 F，或老网关不认识 F；**不可当 0 读** |
+| `QuotaSummary` | `creditUnit?: 'OFFICIAL_CNY' \| 'COST_CNY'` | 本响应 Credit 数值的计量口径（新合同官方价 / 老合同成本口径） | 老网关；不可默认成任一取值 |
+| `ManagedModel` | `freePoolEligible?: boolean` | 该模型此刻是否先扣 F（FREE ∪ 限免中的 PROMO_FREE） | 老网关；只在 `=== true` 时画「精选」角标 |
+
+- `subscriptionPool` 语义不变，恒为付费池 P；`freeTotalEtu` / `freeBuckets` 是 GENERIC 赠送桶，**不是** `freePool`，两者不可相加。
+- `freeTier` 保留原语义（PLAN:FREE 档 allowedModels 内的静态分类），但**不再用于展示分区**；新代码用 `freePoolEligible`。
+- 契约 fixture：`test/fixtures/quota-summary.{two-pool,legacy}.json`、`test/fixtures/managed-models.{two-pool,legacy}.json`，由 `test/quota-summary.two-pool.test.ts` 钉死。Go / Rust SDK 各持有**同字节**副本（`acosmi-sdk-go/testdata/`、`acosmi-sdk-rust/tests/fixtures/`），改一处必须三处同改（`shasum` 比对一致）。
+
 ### InputModality + 桌面视觉理解 sidecar 契约（v1.2.0）
 
 从 v1.2.0 起，SDK 暴露上游 `ManagedModel` 的输入模态字段 + 桌面视觉理解 sidecar capability，供 CrabCode desktop automation / computer-use 通过 catalog（而非模型名 substring）选模型：

package/package.json

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