@acosmi/sdk-ts 2.19.0 → 2.19.2

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 2.19.2
+
+- Preserve catalog-supported low, medium, xhigh, and max thinking levels through both chat adapters.
+- Deliver explicit thinking-off requests to compatible OpenAI gateways.
+- Keep the credential and request-ID behavior shipped in 2.19.1.
+
 # Changelog
 
 All notable changes to `@acosmi/sdk-ts` will be documented in this file.
@@ -5,6 +11,16 @@ All notable changes to `@acosmi/sdk-ts` will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.19.1] - 2026-09-08 — 认证生命周期与上游错误归属修复
+
+- 新增显式 `credentialMode: 'versioned'`，通过调用方提供的 `VersionedCredentialStore` 原子读写凭据。SDK 统一负责登录、身份确认、刷新和本地退出；多个进程同时刷新时使用同一份持久状态，刷新结果不确定时要求重新登录。
+- 新增 `credentialRequestOwner`，将请求绑定到构造时的存储实例、登录会话和已验证身份。同一身份正常刷新继续可用，已退出或被替换的客户端不能借用另一个账号的凭据。WebSocket 票据、连接与晚到事件遵守同一归属。
+- 新增 `logoutCredential(signal?, expected?)` 本地提交结果与独立远端吊销结果。过期的退出操作不能清除新登录；调用方可订阅不含凭据的状态通知。
+- 新增显式 `credentialMode: 'external'` 与 `accessTokenProvider`，外部凭据不进入 SDK 刷新存储。非 legacy 模式将凭据限制在配置的同一源。
+- HTTP 401 只有完整错误合同明确归属用户访问凭据、且请求未被接收时，才触发一次刷新和重试。提供商拒绝、已接收请求及缺失合同的错误不再被误当成登录过期。OpenAI 流式错误作为终态保留。
+
+默认仍为 `legacy` 模式，现有存储接口继续可用。上述 401 判据适用于所有模式；旧网关未提供完整错误合同时，调用方会收到原错误而不会自动重放。启用 versioned 模式前，上游 OAuth metadata 必须声明 `crabcode_auth_contract_version=2` 与 `gateway_error_contract_version=1`；不支持时明确拒绝登录，不能静默降级。
+
 ## [2.19.0] - 2026-09-01 — 网关消费请求 ID 透出（跨系统关联）
 
 **客户端的失败与上游的成功之间此前没有任何共同标识符。** 2026-08-31 事故里，GUI 上每次托管 WebSearch 都失败，而同一时刻上游 6 次搜索全部成功、6 条计费行已落库；定位花掉整场审计，因为只能靠时间戳与模型名人工对齐。网关现在把 `consumeRequestID`（即 `managed_model_usage_logs.request_id`，能 join 到计费行的那个键）放进 `X-Acosmi-Request-Id` 响应头，本版把它透出给消费方。全部改动 additive，旧调用点零改动。

package/README.md

@@ -7,7 +7,8 @@
 ## 状态
 
 - **主实现 / 事实标准**：本 TS SDK 现为 Acosmi SDK 的主力实现。Go SDK [acosmi-sdk-go](https://github.com/acosmi/acosmi-sdk-go) 已暂停维护，待 TS 稳定后再从 TS 反向翻译补齐。
-- **当前版本：`2.18.0`**（`ManagedModel.thinking_levels` 类型面对齐，2026-08-29）。
+- **当前版本：`2.19.1`**（认证生命周期与上游错误归属修复，2026-09-08）。
+- **`v2.19.1`**：可选 versioned 凭据存储、原子刷新与本地退出，支持将 HTTP / WebSocket 绑定到固定登录身份；外部凭据使用独立的 external 模式。所有模式仅在完整网关错误合同证明用户访问凭据失效且请求未接收时自动刷新重试，普通 401 原样返回。versioned 模式要求上游 metadata 的认证合同为 2、网关错误合同为 1；默认 legacy 存储接口继续可用。详见 [CHANGELOG](./CHANGELOG.md)。
 - **`v2.18.0`（加性类型发布）**：`ManagedModel` 新增可选字段 `thinking_levels?: string[]` —— 网关下发的**升序思考档位 id 列表**（`ThinkingOff`/`ThinkingHigh`/`ThinkingMax` 的子集）。`listModels` 对它原样透传，公开签名向后兼容、零行为变化；`[]` = 该模型无思考档，`undefined` = 旧网关未播报（按"未知"处理，严禁自行推档）。详见〈思考档位 `thinking_levels`〉。
 - **`v2.17.0`（安全修复发布）**：桌面 loopback `authorize()` 对 `/callback` 的**一切形态**（成功 / OAuth error / 畸形）先行校验 CSRF `state`，且必须"恰好一个"并严格等值 —— 缺失、重复（含重复的正确值）、错值一律以稳定错误码 `state_mismatch` 拒绝本次登录；此前携带 OAuth error 的回调绕过 state 直接结算 `auth_denied`，本机任意进程零知识即可打断/塑形等待中的登录，且 `?code=…&state=<正确值>&state=x` 这类重复参数可蒙混通过。`finally` 补 `closeIdleConnections()`，每条终止路径以端口完全关闭收尾。公开 API 签名零变化；回归闸门 `test/auth/desktop-loopback-state.test.ts` 十路终止矩阵。
 - **`v2.15.0`（加性兼容发布）**：新增 `classifySourcesEvent()`、`SourcesEventParseResult` 与稳定 issue code，把 `not_sources`、合法 `empty_sources`、非空 `sources`、`malformed_sources` 明确分开。既有 `parseSourcesEvent()` 的代码路径、宽松判定、`null` 条件和返回对象形状保持原样；现有 consumer 无需改动，新 consumer 才选择严格 API。