@kanyun-ai-infra/agenthub 1.22.0 → 1.23.0

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 本文件从 1.12.0 开始记录；更早的版本见 git 历史中的 `chore(agenthub-sdk): release X.Y.Z` 提交。
 
+## 1.23.0
+
+本版带上 1.22.0 之后合入的两组公开面改动：`sessions.create` 按会话选择项目模型服务（`modelServiceId`，#5809），以及选择流水线克隆绑定仓库所用凭据的 `bindings.setRepoCredentialMode` / `getRepoCredentialStatus`（#5770 PR 2a，#5802）。两组都是新增，没有破坏性变化。
+
+### 新增（主入口）
+
+- `sessions.create` 的可选 `modelServiceId`（#5809）：形如 `"llmp_…"`，让该会话跑在**本会话所属项目自己的**某个模型服务上，而不是 revision 声明的那个。不传则行为不变。服务在建会话时校验并冻结，之后的回合、复活和 `PATCH /sessions/:id/model` 都不会改它，要换就开新会话。只收 `llmp_*` 公开 id；别的项目的、已归档的、不存在的服务一律失败为 `SESSION_LLM_PROVIDER_NOT_FOUND`（三种情况同一个答案）。不同时设 `metadata.model` 时，会话用所选服务的默认模型，而不是 revision 的默认模型。公开项目的非成员访客得 403 `public_viewer_cannot_declare_model_service`。它属于请求身份：同一 `idempotencyKey` 换了或漏了 `modelServiceId` 回 `IDEMPOTENCY_REPLAY_MISMATCH`。带它的请求不走预热池。需要服务端部署 #5809。
+- `bindings.setRepoCredentialMode(projectId, "managed" | "manual")`、`bindings.getRepoCredentialStatus(projectId)`（#5770）：选择流水线克隆项目绑定 GitLab 仓库时用的凭据。`managed` 由平台从组的签发凭据为该仓库签发只读项目令牌放进项目 vault，流水线用它克隆；签发完成前运行等待重试，令牌不可用时运行失败，不回退到共享令牌。`manual` 回到项目共享 GitLab 令牌。先绑仓库再设模式。需要 `project:repo-bind`，且调用方对组内项目有 owner 级角色（组主体对自己创建的项目满足）。读状态同样要求这个权限。返回 `{ mode, state, repoPath, expiresAt }`，`state` 在 manual 下为 `null`，managed 下取 `ready` / `pending` / `expired` / `unavailable` / `ambiguous` / `mismatch`；改绑仓库后为 `mismatch`，需要再设一次 `managed`。组没有启用的签发凭据时 400 `ISSUER_UNAVAILABLE`。不含令牌值。新导出 `RepoCredentialMode`、`RepoCredentialStatus`、`SetRepoCredentialModeRequest` 及对应 schema。需要服务端部署 #5770 PR 2a。
+
+### 随包文档
+
+- `SKILL.md`：新增「Choosing the model service per session: `modelServiceId`」一节，预热池跳过条件里补上 `modelServiceId`（#5809）；仓库凭据的用法随 #5802 进入。随包 skill 版本由 0.31.1 升至 0.32.0（npm 上 1.22.0 随包的是 0.31.1，0.31.2 从未随包发布）。
+
+### 导出面核对
+
+`npm pack @kanyun-ai-infra/agenthub@1.22.0` 解包后的 `dist/index.d.ts` 与本分支构建产物逐块对比：非注释差异只有 `bindings.setRepoCredentialMode`、`bindings.getRepoCredentialStatus`、`sessions.create` 请求 schema 的 `modelServiceId`，以及新导出 `RepoCredentialMode`、`RepoCredentialModeSchema`、`RepoCredentialStatus`、`RepoCredentialStatusSchema`、`SetRepoCredentialModeRequest`、`SetRepoCredentialModeRequestSchema`；另有两处联合类型成员顺序变化（`state: "legacy" | "unavailable" | …` 变为 `"unavailable" | "legacy" | …`），类型等价。`dist/realtime.d.ts` 逐字节相同。
+
+### 迁移说明
+
+无破坏性变化，不需要迁移。1.22.0 的 `sessions.create` 请求 schema 是 strict，传 `modelServiceId` 会在发请求前被拒；要用它先升级到 1.23.0。
+
 ## 1.22.0
 
 本版的主线是 vault MCP 按目标限制工具（#5719）：`sessions.create` 可以对调用方 vault 里每个 remote MCP 目标声明允许的工具。同时，服务端以后新增的取值不再让调用失败：托管 MCP 与项目秘密的 `status` / `credentialState` 改为开放集合，`vaults.credentials.update` 会按原样返回 SDK 尚未建模的凭据类型。本版还包含 1.21.0 之后合入的托管 MCP 会话身份校验、定时任务的 webhook 目标与 `sessions:terminate` 签发规则调整。