@kanyun-ai-infra/agenthub 1.15.0 → 1.16.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 本文件从 1.12.0 开始记录；更早的版本见 git 历史中的 `chore(agenthub-sdk): release X.Y.Z` 提交。
 
+## 1.16.0
+
+Revision 读面改为宽容读者：服务端给 `workloads.get` / `getRevision` / `getVersion` 的响应新增字段时，已发布的客户端不再报错。这一版同时接受可选的 `sequence`，服务端读面带出后即可读取，无需再次升级 SDK。
+
+### 新增与变化
+
+- `PlatformRevision` 新增可选字段 `sequence`（正整数）：每个 Agent（workload）内从 1 递增的人类可读版本序号，号可以不连续。当前服务端读面尚未返回该字段；在它上线前该字段恒为 `undefined`。
+- `workloads.get` / `getRevision` / `getVersion` 的响应解析改为宽容读者：schema 未声明的字段被忽略（不报错，也不出现在结果里）。此前 revision 响应是 strict，服务端多一个字段就会让所有已发布客户端抛 `MALFORMED_PLATFORM_RESPONSE`。
+- 请求 schema 不变：`publishRevision` / `applyRevisionManifest` 仍拒绝未知字段，行为与 1.15.0 相同。
+
+### 迁移说明
+
+- 无需迁移。升级是可选的，用于获得对服务端后续新增响应字段的兼容性；`sequence` 在服务端读面上线前读不到。
+
 ## 1.15.0
 
 浏览器实时语音入口新增播放对齐、页面工具执行与播放输出节点；其余为随共享契约内联的变化。

package/README.md

@@ -151,6 +151,11 @@ Agents 和 runtime templates 都是 **project-scoped**。Version 必须在同一
 
 > 本文一律用主词汇 **agent / version**；它们是底层 wire 名 `workload` / `revision`
 > 的别名，SDK 两套都接受，规范名与别名同传会抛 `ALIAS_CONFLICT`，细节见下方「完整参考」。
+>
+> 读面响应是**宽容读者**：`agents.get` / `getVersion` / `getRevision` 的响应出现 SDK
+> 未声明的字段时会被忽略，不会报错；服务端新增字段不需要客户端升级。1.16.0 起
+> `PlatformRevision` 接受可选的 `sequence`（每个 Agent 内从 1 递增的版本序号，号可
+> 不连续）；服务端读面返回它之前，该字段为 `undefined`。
 
 ## 记忆（agenthub.memories）
 

package/dist/index.cjs

@@ -498,7 +498,8 @@ var EXECUTOR_FORMAT_REGISTRY = {
     // `declaredMcpTools` allowlist. approvals: none (`bypassPermissions`).
     capabilities: { resume: true, structuredOutput: false, toolFiltering: true, approvals: false },
     // Today's behaviour: Claude Code runs every model the platform offers.
-    allowedModels: { kind: "any" }
+    allowedModels: { kind: "any" },
+    mcpMode: "native"
   },
   pi: {
     descriptor: { kind: "harness", adapterId: "pi", protocolVersion: "1" },
@@ -519,7 +520,10 @@ var EXECUTOR_FORMAT_REGISTRY = {
     },
     // Provisional until #3843 / #3670: no model family decided yet, so none
     // is offered (fails closed; pi is not publishable before then anyway).
-    allowedModels: { kind: "idPrefixes", idPrefixes: [] }
+    allowedModels: { kind: "idPrefixes", idPrefixes: [] },
+    // Pi's MCP goes through managed MCP only (owner 2026-09-28): no rush
+    // direct references, no self-loaded MCP client extension.
+    mcpMode: "bridge"
   }
 };
 var ReservedExecutorValueSchema = import_zod5.z.never();
@@ -580,6 +584,10 @@ var RecordImageCapabilityDeclarationRequestSchema = import_zod5.z.object({
   declaration: ImageCapabilityDeclarationSchema,
   source: import_zod5.z.enum(IMAGE_CAPABILITY_DECLARATION_SOURCES)
 }).strict();
+var FrozenSessionExecutorSchema = import_zod5.z.object({
+  format: import_zod5.z.string().min(1),
+  protocolVersion: import_zod5.z.string()
+});
 var SESSION_ENVIRONMENT_OUTDATED = "SESSION_ENVIRONMENT_OUTDATED";
 var SessionEnvironmentOutdatedPayloadSchema = import_zod5.z.object({
   code: import_zod5.z.literal(SESSION_ENVIRONMENT_OUTDATED),
@@ -4158,6 +4166,24 @@ var WorkloadManifestErrorCodeSchema = import_zod4.z.enum([
   // the `statusForManifestError` default) and additive-widening note as the
   // four codes above.
   "EXECUTOR_NOT_APPLICABLE_TO_LIVE",
+  // HX-T7 (spec `pilot-v2-executor-host-contract.md` §6): a bridge-mode
+  // executor's Revision whose frozen snapshot carries a non-platform MCP
+  // source (rush `enabledMcpServers`). The bridge never connects those
+  // entries, so publishing would silently drop them; the remediation is
+  // managed MCP. Thrown by `applyRevisionManifest` (400, the
+  // `statusForManifestError` default) and by the stage-binding gate (422,
+  // control-plane `WorkloadStageServiceErrorCode`). Additive widening = patch.
+  "EXECUTOR_NON_PLATFORM_MCP_UNSUPPORTED",
+  // EXP-1c (spec `pilot-v2-executor-identity.md` §3, #3668 D6a): the merged,
+  // normalised executor format's registry entry declares a worker contract
+  // kind the Revision does not match (today every entry declares
+  // `managed_agent`, so this fires on a `self_managed` Revision that
+  // inherits a non-default executor — the revision-level snapshot key is
+  // schema-blocked for self_managed, so the reachable channel is workload
+  // `spec.defaults.executor` inheritance). Thrown by `applyRevisionManifest`
+  // (400, the `statusForManifestError` default), judged in
+  // `assertExecutorPublishGate` after EXP-1. Additive widening = patch.
+  "EXECUTOR_NOT_APPLICABLE_TO_SELF_MANAGED",
   // `format: live` publish admission (#4625 PR-1, spec
   // pilot-v2-managed-agent-profile.md §11 MAP-VL3), both thrown by
   // `applyRevisionManifest` and mapped to 400 by the default branch of
@@ -10022,12 +10048,13 @@ var PlatformRevisionSchema = import_zod66.z.object({
   workloadSlug: WorkloadManifestNameSchema.optional(),
   version: WorkloadManifestNameSchema,
   runtimeSnapshotHash: import_zod66.z.string().nullable().optional(),
-  createdAt: import_zod66.z.string().optional()
-}).strict();
+  createdAt: import_zod66.z.string().optional(),
+  sequence: import_zod66.z.number().int().positive().optional()
+}).strip();
 var GetPlatformWorkloadResponseSchema = PlatformWorkloadSchema.extend({
   kind: WorkloadKindSchema,
   defaultRevision: PlatformRevisionSchema.nullable()
-});
+}).strip();
 var GetPlatformRevisionResponseSchema = PlatformRevisionSchema;
 var GetPlatformSessionResponseSchema = import_zod66.z.object({
   id: import_zod66.z.string().uuid(),
@@ -13146,15 +13173,13 @@ var OnlineSessionPreconditionSchema = import_zod83.z.union([
   fileExistsPrecondition,
   toolCalledPrecondition
 ]);
-var forbiddenThreshold = import_zod83.z.never({
-  error: "threshold is only valid on llm graders \u2014 boolean graders (transcript/reply/file/script) pass or fail, there is no score to threshold"
-}).optional();
+var optionalBooleanThreshold = import_zod83.z.number().min(0).max(1).optional();
 var OnlineTranscriptGraderSchema = EvalTranscriptGraderSchema.pick({
   type: true,
   label: true
 }).extend({
   precondition: OnlineTurnPreconditionSchema.optional(),
-  threshold: forbiddenThreshold,
+  threshold: optionalBooleanThreshold,
   expect: EvalTranscriptExpectSchema.pick({
     completed: true,
     forbiddenTools: true,
@@ -13166,7 +13191,7 @@ var OnlineTranscriptGraderSchema = EvalTranscriptGraderSchema.pick({
 }).strict();
 var OnlineReplyGraderSchema = EvalReplyGraderSchema.pick({ type: true, label: true }).extend({
   precondition: OnlineTurnPreconditionSchema.optional(),
-  threshold: forbiddenThreshold,
+  threshold: optionalBooleanThreshold,
   expect: EvalReplyExpectSchema.pick({ excludes: true, matches: true })
 }).strict();
 var OnlineLlmToolsSchema = EvalLlmToolsSchema;
@@ -13190,7 +13215,7 @@ var OnlineFileGraderSchema = import_zod83.z.object({
   type: import_zod83.z.literal("file"),
   label: EvalGraderLabelSchema,
   precondition: OnlineSessionPreconditionSchema,
-  threshold: forbiddenThreshold,
+  threshold: optionalBooleanThreshold,
   path: EvalRelativePathSchema,
   expect: EvalReplyExpectSchema.pick({ excludes: true }).required()
 }).strict();
@@ -13201,7 +13226,7 @@ var OnlineScriptGraderSchema = EvalScriptGraderSchema.pick({
   timeout: true
 }).extend({
   precondition: OnlineSessionPreconditionSchema,
-  threshold: forbiddenThreshold,
+  threshold: optionalBooleanThreshold,
   expect: EvalScriptExpectSchema.optional()
 }).strict();
 var OnlineTurnGraderSpecSchema = import_zod83.z.discriminatedUnion("type", [