@kanyun-ai-infra/agenthub 1.26.0 → 1.27.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +48 -0
- package/dist/index.cjs +1604 -1523
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +53 -2
- package/dist/index.d.ts +53 -2
- package/dist/index.js +1604 -1523
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/skills/agenthub-sdk/SKILL.md +27 -3
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,54 @@
|
|
|
2
2
|
|
|
3
3
|
本文件从 1.12.0 开始记录；更早的版本见 git 历史中的 `chore(agenthub-sdk): release X.Y.Z` 提交。
|
|
4
4
|
|
|
5
|
+
## 1.27.0
|
|
6
|
+
|
|
7
|
+
本版带上 1.26.0（83d138380，#5880，11-06）之后合入 main 的公开面变化：凭据创建可带幂等键、凭据新增只读的 list / get（#5894），以及 `listArtifacts` 透出超限文件 `oversizedFiles`（#5893）。均为新增，不用新入参时行为与 1.26.0 相同。
|
|
8
|
+
|
|
9
|
+
### 新增（主入口）
|
|
10
|
+
|
|
11
|
+
- `vaults.credentials.create(vaultId, request, { idempotencyKey })`（#5894）：幂等键放在 `Idempotency-Key` 请求头里发出。
|
|
12
|
+
- 同一个键加逐字节相同的请求体重试，返回第一次的响应：`vcrd_*` id 相同，库里只有一行。
|
|
13
|
+
- 同一个键换了请求体，返回 409 `IDEMPOTENCY_KEY_CONFLICT`。
|
|
14
|
+
- 并发请求在时限内拿不到回放锁，返回 409 `IDEMPOTENCY_LOCK_TIMEOUT`，用同一个键、同一个请求体重试即可。
|
|
15
|
+
- 回放按租户、调用主体和 vault 隔离，记录保留 24 小时。失败的创建不记录，修好原因后可以用原来的键重试。
|
|
16
|
+
- SDK 自己不缓存，每次调用都会发请求。
|
|
17
|
+
- `vaults.credentials.list(vaultId, { workspaceId, includeArchived? })` 和 `get(vaultId, credentialId, { workspaceId })`（#5894）：需要 `vaults:read`。
|
|
18
|
+
- 只返回元数据：不含凭据值、token 尾号、refresh token 和自定义头的值。
|
|
19
|
+
- `list` 按创建时间升序，默认不含已归档的凭据。
|
|
20
|
+
- vault 或凭据不存在、已归档、或调用方无权访问，一律返回 404，彼此区分不出来。
|
|
21
|
+
- 遇到本版没有建模的凭据类型，返回 `UnknownVaultCredentialRecord`，用 `isKnownVaultCredential` 判断后再按 `authType` 收窄。
|
|
22
|
+
- 从这一版起，`vcrd_*` id 不用只靠 `create` 的返回值保存了。
|
|
23
|
+
- `sessions.listArtifacts(sessionId, { turnId })` 的返回新增可选字段 `oversizedFiles: Array<{ path, sizeBytes, limitBytes }>`（#5893）：
|
|
24
|
+
- 列出该回合里因为超过单文件 8 MB 上限而被跳过的文件，最多 50 条。
|
|
25
|
+
- 只有请求带了 `turnId` 才会返回。该回合没有跳过文件时不返回；worker 版本早于这个字段时也不返回，所以没有这个字段不代表没有文件被跳过。
|
|
26
|
+
- `path` 是工作区里的相对路径，不是 URL，这些文件在 artifact 存储里没有内容。要交付这么大的文件，改用 `sessions.exportWorkspace` 或仓库交付。
|
|
27
|
+
- 服务端读的是 worker 上报的事件，worker 侧随沙箱基础镜像发布，新镜像 promote 之后的会话才会上报。
|
|
28
|
+
- 新导出类型 `CreateCredentialOptions`、`ListCredentialsOptions`。
|
|
29
|
+
|
|
30
|
+
### 其他类型面变化
|
|
31
|
+
|
|
32
|
+
- `TurnAudioFailureReasonSchema` 的枚举新增 `"interrupted"`（#5867，语音级联打断）。对这个枚举做穷尽 `switch` 的调用方，需要补一个分支。
|
|
33
|
+
|
|
34
|
+
### 随包文档
|
|
35
|
+
|
|
36
|
+
- `SKILL.md`：补上凭据 list / get 和幂等键的用法，删掉「凭据没有 list / get」那句；补上 `oversizedFiles` 的取法和处理建议。随包 skill 版本从 0.35.0 升到 0.36.0。
|
|
37
|
+
|
|
38
|
+
### 导出面核对
|
|
39
|
+
|
|
40
|
+
把 `npm pack @kanyun-ai-infra/agenthub@1.26.0` 解包后的 `dist/index.d.ts` 和本分支的构建产物对比，去掉注释后的差异如下：
|
|
41
|
+
- 新增 `CreateCredentialOptions`、`ListCredentialsOptions`、`SessionArtifactOversizedFile` 三个接口；
|
|
42
|
+
- `SessionArtifactsList` 新增 `oversizedFiles?`；
|
|
43
|
+
- `VaultCredentialsResource` 新增 `list`、`get`；
|
|
44
|
+
- `create` 的 `options` 参数类型从 `VaultRequestOptions` 换成它的子接口 `CreateCredentialOptions`，旧写法照样能通过类型检查；
|
|
45
|
+
- `TurnAudioFailureReasonSchema` 新增 `"interrupted"`（两处）。
|
|
46
|
+
|
|
47
|
+
没有删除。`dist/realtime.d.ts` 无非注释差异。
|
|
48
|
+
|
|
49
|
+
### 迁移说明
|
|
50
|
+
|
|
51
|
+
没有破坏性变化，不需要迁移。
|
|
52
|
+
|
|
5
53
|
## 1.26.0
|
|
6
54
|
|
|
7
55
|
本版带上 1.25.0（87ef69055，#5878，11-06）之后合入 main 的公开面变化：`vaults.credentials` 的 create / update 建模 `net_secret` 凭据（#5879，#5805 SDK 臂）。新增凭据类型属 minor，无破坏性变化，不建 `net_secret` 凭据时行为逐字不变。会话侧的冻结与下发（#5874）、gateway 转发（#5876）不进 SDK 导出面（d.ts diff 为准），只在 JS 运行时以内联常量出现。
|