@acosmi/sdk-ts 1.5.0 → 1.5.1

package/docs/compliance.md

@@ -90,15 +90,15 @@ Report scopes are split by action:
   again) so the new scope is granted.
 - `ScopeComplianceReportsPublish` — `publishReport` (also requires step-up).
 
-Contract-template scopes (added in v1.10.0) are split by direction and do not
-require step-up:
+Contract-template scopes (added in v1.5.0; originally planned as v1.10.0 — see
+CHANGELOG §"S5：合同模板") are split by direction and do not require step-up:
 
 - `ScopeComplianceContractTemplateRead` — `getContractTemplate`,
   `listContractTemplates`, `listContractTemplateVersions`.
 - `ScopeComplianceContractTemplateWrite` — `createContractTemplate`,
   `updateContractTemplate`, `deleteContractTemplate`,
   `uploadContractTemplatePdf`, `publishContractTemplate`,
-  `archiveContractTemplate`. Tokens issued before v1.10.0 do **not** carry these
+  `archiveContractTemplate`. Tokens issued before v1.5.0 do **not** carry these
   scopes; existing users must re-authorize so the new scopes are granted.
 
 ## Base URL
@@ -244,7 +244,8 @@ if (view.status === 'SUCCESS') {
 
 ## Paginated Lists
 
-Since v1.6.0 the SDK exposes paginated list reads against the backend
+Since v1.5.0 (originally planned as v1.6.0 — see CHANGELOG §"S1：6 个分页列表")
+the SDK exposes paginated list reads against the backend
 compliance gateway (`GET .../page`). Each returns a yudao `PageResult<T>`
 (`{ total, list }` — the single SDK-wide pagination result shape, an alias of
 `YudaoPageResult<T>`):
@@ -330,7 +331,8 @@ release.
 
 ## Capabilities And Operation Projection
 
-Since v1.7.0 the SDK exposes the compliance gateway S2 reads: a capability gate
+Since v1.5.0 (originally planned as v1.7.0 — see CHANGELOG §"S2：capabilities +
+operations 投影") the SDK exposes the compliance gateway S2 reads: a capability gate
 query and an operation-projection view.
 
 ```ts
@@ -421,7 +423,8 @@ by the backend as `yyyy-MM-dd HH:mm:ss`; the SDK passes them through verbatim.
 
 ## TSA Readonly Views
 
-Since v1.8.0 the SDK exposes the compliance gateway S3 reads: two timestamp
+Since v1.5.0 (originally planned as v1.8.0 — see CHANGELOG §"S3：TSA readonly
+视图") the SDK exposes the compliance gateway S3 reads: two timestamp
 authority (TSA) readonly views.
 
 ```ts
@@ -463,7 +466,8 @@ when no timestamps exist.
 
 ## Envelope Completion
 
-Since v1.9.0 the SDK exposes the compliance gateway S4 envelope-completion
+Since v1.5.0 (originally planned as v1.9.0 — see CHANGELOG §"S4：envelope 收尾
++ void") the SDK exposes the compliance gateway S4 envelope-completion
 surface: two readonly views and one write.
 
 ```ts
@@ -526,7 +530,8 @@ methods in this release.
 
 ## Contract Templates
 
-Since v1.10.0 the SDK exposes the compliance gateway S5 contract-template
+Since v1.5.0 (originally planned as v1.10.0 — see CHANGELOG §"S5：合同模板")
+the SDK exposes the compliance gateway S5 contract-template
 surface: a `DRAFT` → `PUBLISHED` → `ARCHIVED` lifecycle with PDF upload, field
 overlay, and immutable version snapshots.
 

package/examples/auth-oauth-flow.ts

@@ -11,8 +11,12 @@
 // 说明：
 //   - 大多数场景直接用 `client.login(appName, scopes)` 即可（内部封装了下面全部步骤）。
 //     本示例演示底层 helper，适用于需要自定义授权流程 / 自管 token 的 CLI。
-//   - authorize 仅在 Node 环境可用（需要本地 HTTP 回调 server）；浏览器侧应自行实现
-//     popup window + redirect handler。
+//   - authorize 仅在 Node 环境可用（需要本地 HTTP 回调 server）。
+//   - 浏览器侧（无 loopback server）请改用 v1.4.0+ Web OAuth 原语：
+//     discoverWebOAuthMetadata + registerWebOAuthClient +
+//     createWebAuthorizationRequest + completeWebAuthorizationRequest，
+//     由调用方实现 popup / 同窗口 redirect handler，SDK 负责 PKCE / state 校验 / token 兑换。
+//     浏览器 token 刷新可配 Config.browserRefreshMode / refreshProxyURL (v1.4.1+) 规避 issuer CORS 403。
 
 import {
   discover,

package/examples/compliance-evidence-timestamp.ts

@@ -22,6 +22,7 @@ import {
   ScopeComplianceTimestampIssue,
   ScopeComplianceTimestampVerify,
   ScopeComplianceReportsRead,
+  ScopeComplianceReportsWrite,
 } from '@acosmi/sdk-ts';
 
 // 模拟持久化的 Idempotency-Key 存储；生产环境应落 DB / 本地文件 / 业务订单表。
@@ -51,7 +52,8 @@ async function main() {
     ScopeComplianceEvidenceWrite,
     ScopeComplianceTimestampIssue,
     ScopeComplianceTimestampVerify,
-    ScopeComplianceReportsRead,
+    ScopeComplianceReportsRead,   // getReport / downloadReport
+    ScopeComplianceReportsWrite,  // createReport（v1.3.2 起从 read 切到独立 write scope）
   ]);
 
   // 1) 本地 sha256 (用户业务内容)

package/examples/core-chat.ts

@@ -8,9 +8,12 @@
 //   5. 流式 chatStreamWithUsage 并聚合 usage / 结算事件
 //
 // 说明：
-//   - SDK 自动按 ManagedModel 的 preferredFormat / supportedFormats 选 Anthropic
-//     或 OpenAI adapter，调用方无需关心。
+//   - SDK 自动按 ManagedModel 的 preferred_format / supported_formats（snake_case
+//     wire 字段）选 Anthropic 或 OpenAI adapter，调用方无需关心。详见
+//     src/models/adapters/index.ts:getAdapterForModel。
 //   - 金额 / 余额字段是 string（避免 JS number 精度损失），不要做浮点运算。
+//   - ChatRequest 走 snake_case wire 字段（max_tokens 等），与上游 Go json tag 对齐；
+//     ManagedModel 顶层多为 camelCase（modelId / isEnabled / inputModalities）。
 
 import { Client, allScopes, FileTokenStore } from '@acosmi/sdk-ts';
 

package/package.json

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