@sema-agent/sdk 4.1.0 → 4.2.0

package/README.md

@@ -40,6 +40,27 @@ for await (const ev of client.runs.events(task.taskId)) {
 
 Typed errors (`APIError` hierarchy: `AuthError`, `RateLimitedError`, `ConflictError`, `ApprovalStaleError`, …) let callers branch on semantics instead of strings.
 
+## 4.2.0 — spec-audit fixes, additive (no breaking change)
+
+[2400] 说明书审计 ch1–ch3 的修复车。全部 additive:没有类型收窄、没有删面。三处**行为**变化写在表里的前三行
+(错误分类的 503 走向、`toSseResponse` 的帧形、`parseSse` 的空转熔断类型),其余是补面与补文档。
+
+| Change | Why |
+| --- | --- |
+| An un-coded **503** now maps to `ServiceStateError`, not `AuthError` | A worker's own 503 always carries a machine code (`state.*` / `draining` / `capability.*`), so the un-coded arm is only reachable via an intermediary (ingress / mesh) — i.e. "the upstream is briefly unavailable, retry". Reading that as "you lack permission" points the operator at the wrong fix. Un-coded **401** is unchanged (fail-closed auth) |
+| `toSseResponse` now writes an `event: <type>` line, and strips `id` from the JSON payload | The server writes named frames everywhere (`id:` → `event:` → `data:`); this relay helper wrote only `data:`, so a downstream dispatching on the SSE event name (a browser `addEventListener("tool_end", …)`, a name-routing relay) saw nothing named after passing through a BFF. And `id` is the SDK's transport cursor stamped by `parseSse` — writing it to the `id:` line *and* leaving it in the body handed consumers a key the wire never had |
+| A durable stream that keeps re-opening EMPTY now throws typed `StreamEndedWithoutTerminalError` (carries `lastEventId`) after 2 such legs, instead of a bare `Error` after 5 | That signature is a **parked run**: on `suspended`/`needs_review` the server closes a non-`running` tail immediately, forever. The consumer's move is `runs.get(taskId)` → branch on the row. The SDK does not call it for you (the parser holds no client — layering), the typed error is the seam |
+| Two new error families + one new class: `checkpoint.*` and `wake.*` prefix dispatch, and `GateNotToolApprovalError` | The `checkpoint.*` family is 10 core codes the server mirrors verbatim; only 3 were named, the rest collapsed into anonymous 409s. `checkpoint.not_found` is the one 404 in the family (→ `NotFoundError`). `gate_not_tool_approval` is the THIRD wrong-door guard next to `gate_not_resumable` / `gate_not_plan_review` — a `/decide` aimed at a plan_review gate |
+| `RateLimitedError` carries `usedMicroUsd` / `limitMicroUsd` on `limit.cost_quota_exceeded` | The server sends the cost material; it was dropped on the floor, so a UI could only say "quota exceeded" and not "used $X of $Y". Guarded extraction — a malformed field is omitted, never thrown |
+| `AgentEvent` gained **6 arms**: `error`, `question`, `question_complete`, `elicitation`, `elicitation_complete`, `workflow_complete` (spec `Event_*` schemas + `oneOf` + discriminator mapping in the same batch) | All six are on the wire today. `error` is the 15-minute stream cap (`errorCode: "STREAM_MAX_DURATION"`) — **it means the run is still alive, reconnect with `Last-Event-ID`**, it is not a terminal. The other five are the DURABLE half of the HITL/workflow frames: the live leg dispatches them by SSE event name, and the durable leg persists them via `append(type, …)`, so they replay off `runs.events` too. The spec/SDK arm gate compares those two sides, so arms missing from BOTH were structurally invisible to it |
+| `runs.steer` returns a typed `SteerReceipt` (was `unknown`) and accepts `priority?: "now" \| "next" \| "later"` | Three server mint points mean three different things and only `delivery` tells them apart: `applied` (live), `queued` (the run is **suspended** — the steer parks on its checkpoint), `parked_for_wake` (the run ENDED — nothing happens until `POST /v1/sessions/:id/wake`). ⚠️ Doc correction in the same batch: a suspended run is **not** a 409; the old JSDoc said it was. `priority` is enum-validated fail-loud server-side but advisory today (core's steer is single-slot) |
+| `TaskRequest.taskId?` (caller-minted uuidv7) | The DURABLE second tier of idempotency on `POST /v1/runs`: `Idempotency-Key` is an in-memory per-pod cache, so a dispatch gateway re-routing a retry to another instance would start a second run. This replay reads the run store — it is the prerequisite for gateway failover. Non-uuidv7 ⇒ 400; another principal's taskId ⇒ 409, never a cross-tenant oracle |
+| `AgentClientConfig.principalHeader?` | The principal header's NAME is deployment config server-side. On a renamed deployment the only way out used to be hand-written `fetch` — exactly what the SDK constitution forbids. Renaming REPLACES the default (never sends both), and the reserved-header guard follows the configured name so caller extras still cannot forge it |
+| `CheckpointGate.kind` known set gained `plan_review`; `PendingCheckpoint.riskDescriptor` accepts `null` | `plan_review` was the one member of the server's six-kind wire set missing here — a real gate kind that read as "unknown". Both checkpoint stores send an explicit `null` risk descriptor (the spec already said so) |
+| `approvals`: `list`/`stream` accept `opts.owner` (operator scope), `decide`'s `answer` is `QuestionAnswer` (was `unknown`), `ApprovalStreamEvent` gained the `meta` and `error` arms, a malformed `data:` line now throws instead of being swallowed into a silent reconnect | The stream's shape was labelled FORWARD-DRAFT and never re-checked; re-checking found two real frame types missing. ⚠️ The two answer legs differ in strictness: the durable leg REJECTS an empty `answers` array, the live `questions.respond` leg accepts it |
+| New export: `SettingsWebSearch` (was declared but unreachable from the package entry) | `SemaSettings.webSearch` is typed by it, and the package `exports` map has no deep path — so it could not be named from outside |
+| Doc-only corrections | The 416 eviction body DOES carry `errorCode: "limit.retention_evicted"` (three places said it does not, and a test fixture pinned the false shape); heartbeat cadence is **15s** on the task/run/trace/workflow/fleet writers (not 30s) with `GET /v1/sessions/:id/events` the lone exception (bare `: hb` comments at a tunable ~25s); a concurrent request under the same `Idempotency-Key` replays the SAME promise (there is no 409); dead `server.js:NNN` coordinates repointed at real files; the five `taskStop` 409 codes and the two distinct subagent 404 codes listed in full; the `/v1/assistant/*` verbs documented as gated on `capabilities.approvals` (the checkpoint store mounts that whole lane) |
+
 ## 4.1.0 — wire truth, additive (no breaking change)
 
 Contract-reconciliation batch: three shapes the server has been putting on the wire that this SDK did not
@@ -80,7 +101,7 @@ their negative pins (`test/breaking-4.0.0-removals.test.ts` + a compile-time pin
 
 | Removed / renamed | Replacement |
 | --- | --- |
-| Draining detection via the legacy `status 503 && error === "draining"` *text* arm | `errorCode` is the only discriminator (the literal `draining`). A 503 carrying only the legacy text falls through to the 503 status tariff and yields `AuthError` — not `DrainingError`, and not a bare `APIError`. Only a below-floor server can still emit that shape |
+| Draining detection via the legacy `status 503 && error === "draining"` *text* arm | `errorCode` is the only discriminator (the literal `draining`). A 503 carrying only the legacy text falls through to the 503 status tariff and yields `ServiceStateError` — not `DrainingError`, and not a bare `APIError`. (4.2.0 / [2400] CB-3 re-pointed that tariff: an un-coded 503 is "retry shortly", so it stopped landing on `AuthError`.) Only a below-floor server can still emit that shape |
 | Registry health probe fallback to the legacy `/healthz` path, and the `legacy` hint field on its result | `/api/healthz` is the only probe path; a server answering only the old path reads as `ok: false`, and the result object no longer carries a `legacy` key |
 | `session-core` transitional alias `SessionSummary` | The real name `PersistedSessionSummary` (the persistence-face type; `@sema-agent/sdk`'s own `SessionSummary` is the unrelated `GET /v1/sessions` wire row) — the one-version transition promised at rename time is over |
 | `CONFIG_CENTER_*` env names in control-client error text and docs | `SEMA_REGISTRY_*` only (the server rejects the old names at boot since 5.0.0) |

package/dist/client.d.ts

@@ -48,6 +48,15 @@ interface AgentClientConfigBase {
     /** Escape hatch for tests / a deliberate browser BFF that injects the token itself. Default false. */
     allowBrowser?: boolean;
     fetch?: typeof fetch;
+    /** [2400] CB-4 —— principal 头的**名字**。缺省 `x-agent-principal`。
+     *
+     *  为什么需要它:头名在 server 侧是部署配置(`deps.config.principalHeader`,worker 用它认身份、
+     *  `auth.principal_required` 的报错也逐字引用它),不是常量。改过名的部署上,SDK 恒发 `x-agent-principal`
+     *  ⇒ 认不出身份;此前唯一出路是绕开 SDK 手抄 fetch —— 恰是 SDK 宪法①禁止的那件事。
+     *  🔴 改名是**替换**不是新增:配了之后不再发缺省名(同时自报两个身份头是更糟的形)。
+     *  🔴 RESERVED 守卫跟着改:配置的头名同样进保留集,caller extras 覆盖不了它(内建恒胜)—— 否则
+     *  改个名就等于把身份头的注入权交还给调用方。 */
+    principalHeader?: string;
 }
 /** 判别联合(G22):relay 态 principal 可省略;其余两态 principal 类型级必填不弱化。 */
 export type AgentClientConfig = (AgentClientConfigBase & {
@@ -128,7 +137,7 @@ export declare class AgentClient {
     capabilities(opts?: {
         signal?: AbortSignal;
     }): Promise<Capabilities>;
-    /** GET /v1/capabilities/scenarios/:name — one scenario's detail card (server 1.214 server.js:567-576;
+    /** GET /v1/capabilities/scenarios/:name — one scenario's detail card (server `src/http/routes/capabilities.ts:29-40`;
      *  `capabilities().scenarios` lists the names, THIS resolves one to its {@link ScenarioDetail}: toolset/tools/
      *  prompt digest/enabled). Same family as {@link capabilities} — a worker-config read, not a resource.
      *  Unknown name → 404 `{ error: "scenario not found", errorCode: "scenario_not_found" }`, surfaced as a typed

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE1E;;;;;;;;;;;;+EAY+E;AAC/E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAcpG,UAAU,qBAAqB;IAC7B;0DACsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sGAAsG;IACtG,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;;;;;;gCAO4B;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAKD,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GACzB,CAAC,qBAAqB,GAAG;IACvB;uGACmG;IACnG,SAAS,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,mBAAmB,CAAA;KAAE,CAAC;IAClD,6GAA6G;IAC7G,SAAS,EAAE,SAAS,CAAC;CACtB,CAAC,GACF,CAAC,qBAAqB,GAAG;IACvB,+CAA+C;IAC/C,SAAS,EAAE;QAAE,IAAI,EAAE,mBAAmB,CAAA;KAAE,CAAC;IACzC;kCAC8B;IAC9B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC,CAAC;AAEP,qBAAa,WAAW;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC;2HACuH;IACvH,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C;;;4CAGwC;IACxC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC;;;;sFAIkF;IAClF,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C;oEACgE;IAChE,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,sHAAsH;IACtH,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,8GAA8G;IAC9G,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,yFAAyF;IACzF,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,4GAA4G;IAC5G,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC;;2FAEuF;IACvF,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B;sEACkE;IAClE,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,8FAA8F;IAC9F,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,oDAAoD;IACpD,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAEtC;qGACiG;IACjG,YAAY,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAIpE;;;;;;+FAM2F;IAC3F,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAQ5F;;6GAEyG;IACzG,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW;gBAKpC,MAAM,EAAE,iBAAiB;CAyFtC"}

package/dist/client.js

@@ -41,6 +41,8 @@ function isLoopbackBaseUrl(baseUrl) {
     const h = hostname.toLowerCase();
     return h === "localhost" || h === "[::1]" || h === "::1" || /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(h);
 }
+/** 缺省 principal 头名(server `deps.config.principalHeader` 的出厂值)。 */
+const DEFAULT_PRINCIPAL_HEADER = "x-agent-principal";
 export class AgentClient {
     tasks;
     runs;
@@ -102,7 +104,7 @@ export class AgentClient {
     capabilities(opts) {
         return this.transport.request({ method: "GET", path: "/v1/capabilities", signal: opts?.signal });
     }
-    /** GET /v1/capabilities/scenarios/:name — one scenario's detail card (server 1.214 server.js:567-576;
+    /** GET /v1/capabilities/scenarios/:name — one scenario's detail card (server `src/http/routes/capabilities.ts:29-40`;
      *  `capabilities().scenarios` lists the names, THIS resolves one to its {@link ScenarioDetail}: toolset/tools/
      *  prompt digest/enabled). Same family as {@link capabilities} — a worker-config read, not a resource.
      *  Unknown name → 404 `{ error: "scenario not found", errorCode: "scenario_not_found" }`, surfaced as a typed
@@ -158,11 +160,14 @@ export class AgentClient {
         // loopback-unauthed sends NO Authorization header at all (no fake token on the wire).
         const authToken = typeof config.authToken === "string" ? config.authToken : undefined;
         const principal = config.principal;
+        // [2400] CB-4:头名可配(缺省 x-agent-principal)。小写归一 —— transport 的 RESERVED 守卫按小写比。
+        const principalHeader = (config.principalHeader ?? DEFAULT_PRINCIPAL_HEADER).toLowerCase();
         const opts = {
             baseUrl: config.baseUrl,
             timeoutMs: config.timeoutMs ?? 60_000,
             maxRetries: config.maxRetries ?? 2,
             fetchImpl: config.fetch ?? fetch,
+            principalHeader,
             buildHeaders: (idempotencyKey) => {
                 const h = {};
                 if (authToken !== undefined)
@@ -170,7 +175,7 @@ export class AgentClient {
                 // relay 态 principal 可缺席 ⇒ 头也缺席(不铸 anon 假值;BFF 注入是它的职责面)。
                 // 其余两态 principal 构造期已验必填,此处恒发——字节不变。
                 if (principal !== undefined && principal !== "")
-                    h["x-agent-principal"] = principal;
+                    h[principalHeader] = principal;
                 h["content-type"] = "application/json";
                 if (idempotencyKey)
                     h["idempotency-key"] = idempotencyKey;

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -18,13 +18,16 @@ export declare class APIError extends Error {
     retriable?: boolean;
     constructor(status: number, errorCode: string | undefined, message: string);
 }
-/** `auth.*` 前缀族 + 401/503 状态兜底 —— fail-closed auth(缺/错 SERVICE_AUTH_TOKEN、非属主、
+/** `auth.*` 前缀族 + 401 状态兜底 —— fail-closed auth(缺/错 SERVICE_AUTH_TOKEN、非属主、
  *  operator-only、bake-runner-only、principal 头缺席…)。
  *
  *  🔴 键位优先于状态(SDK 1.1.0):此前这个类**只**按 `status === 401 || status === 503` 分,于是
  *  `auth.forbidden` / `auth.operator_only` / `auth.bake_runner_only` / `auth.ingest_secret_invalid`
  *  四个 403 全塌成裸 APIError,而同一条 503 分支还错吞了 `state.*`(见 {@link ServiceStateError})。
- *  现在先按 `auth.` 前缀分,状态兜底留作**没有机器码时**的退路。 */
+ *  现在先按 `auth.` 前缀分,状态兜底留作**没有机器码时**的退路。
+ *
+ *  🔴 [2400] CB-3(SDK 4.2.0):状态兜底**只剩 401**。无码 503 已改归 {@link ServiceStateError} —— 那条臂
+ *  上真正可达的是中间层的无码 503(「上游暂时不可用」),把它铸成本类等于把「稍后重试」说成「你没权限」。 */
 export declare class AuthError extends APIError {
 }
 /** `request.*` 前缀族 —— **请求本身有问题,改请求即可**(400 为主,另有 413 / 422 / 4xx 兜底粗码)。
@@ -60,7 +63,13 @@ export declare class InternalServerError extends APIError {
 /** `state.*` 前缀族 —— 服务端**当前状态**不接受这个请求(503):roster 还没拉到、没有可用的
  *  sandbox-base。**稍后重试**是主处置。
  *  🔴 修的是一条真缝:这一族此前撞进 `status === 503` 那条分支,被铸成了 {@link AuthError} —— 一个
- *  「稍后重试」的信号被读成了「你没有权限」。 */
+ *  「稍后重试」的信号被读成了「你没有权限」。
+ *
+ *  🔴 [2400] CB-3(SDK 4.2.0)——**无机器码的 503 也归这里**。上一版只把带 `state.` 码的那部分捞了出来,
+ *  裸 503 仍落在 `status === 401 || status === 503` 那条 auth 兜底上。方向反转在这一臂上更刺眼:worker
+ *  自发的 503 恒带码(`state.*` / `draining` / `capability.*`),所以**这条臂真正可达的只有中间层**
+ *  (ingress / service-mesh / 反代)吐的无码 503 —— 那恰恰是「上游暂时不可用,稍后重试」,却被读成
+ *  「你没有权限」。401 不受影响:无码 401 仍是 {@link AuthError}(fail-closed auth 的方向是对的)。 */
 export declare class ServiceStateError extends APIError {
 }
 /** 413 `workspace_file_too_large`(#3 workspace file 面,[1894]①)——结构化超限信封的 typed 形:
@@ -94,8 +103,24 @@ export declare class DrainingError extends APIError {
 /** 429 —— per-principal 限流。`retryAfterMs` 来自 `Retry-After`(SDK 重试时遵守它)。
  *  自 SDK 1.1.0 起继承 {@link LimitExceededError}(`limit.*` 族的成员码 `limit.rate_exceeded` /
  *  `limit.cost_quota_exceeded` 就是从这里下来的)——**additive**:既有 `instanceof RateLimitedError`
- *  一字不改,同时 `catch (e instanceof LimitExceededError)` 也能一把接住整族。 */
+ *  一字不改,同时 `catch (e instanceof LimitExceededError)` 也能一把接住整族。
+ *
+ *  🔴 [2400] CB-5(SDK 4.2.0):`limit.cost_quota_exceeded` 的 body 带**成本材料**
+ *  (server `src/http/server.ts:2491` — `{ usedMicroUsd, limitMicroUsd, retryAfterSec }`),此前整包丢在
+ *  wire 上、消费端只能拿到一句「cost quota exceeded」。两键在此结构化上来,渲染层才写得出「已用
+ *  $X / 上限 $Y」(人话归壳,wire 保持结构化)。守卫式提取(照 {@link QuotaExhaustedDetail} 的姿势):
+ *  非有限数一律丢弃 ⇒ 字段缺席,**绝不在错误路径上崩**;裸码(无字段)照样铸本类。
+ *  ⚠️ 单位是 **micro-USD**(1e-6 USD),不是分、不是美元。 */
 export declare class RateLimitedError extends LimitExceededError {
+    /** `limit.cost_quota_exceeded` only —— 本窗口已花费(micro-USD)。缺席 = 服务端没给/给了坏值。 */
+    readonly usedMicroUsd?: number | undefined;
+    /** `limit.cost_quota_exceeded` only —— 本窗口的上限(micro-USD)。缺席同上。 */
+    readonly limitMicroUsd?: number | undefined;
+    constructor(status: number, errorCode: string | undefined, message: string, retryAfterMs?: number, 
+    /** `limit.cost_quota_exceeded` only —— 本窗口已花费(micro-USD)。缺席 = 服务端没给/给了坏值。 */
+    usedMicroUsd?: number | undefined, 
+    /** `limit.cost_quota_exceeded` only —— 本窗口的上限(micro-USD)。缺席同上。 */
+    limitMicroUsd?: number | undefined);
 }
 /** E4 quota deny detail (定稿形状) — the center's structured 409 fields, passed VERBATIM through the
  *  service's 429 body (`{errorCode:"quota_exhausted", windowType, remaining, resetAt, isEstimate, pool?}`). Every
@@ -269,6 +294,16 @@ export declare class GateNotResumableError extends APIError {
  *  Client action: 按 gateKind 选对的决策端点（/decide 或 /resume）, 重取 inbox。 */
 export declare class GateNotPlanReviewError extends APIError {
 }
+/** [2400] CB-2(SDK 4.2.0)—— 语义错门守卫的**第三个**成员(与上面两兄弟同形):你对一个**不是工具审批门**
+ *  的挂起调了 `/v1/approvals/:sessionId/decide`。409 errorCode `gate_not_tool_approval`
+ *  (server `src/http/server.ts:1581` 的 pre-CAS 纯拒绝:门类不是 `human` / `irreversible_ask` 就在这里拦掉,
+ *  不动 checkpoint、不动 run 行、不烧模型腿)。
+ *  Client action:按 `gateKind` 改走对的那道门 —— `plan_review` → `POST /v1/assistant/tasks/:id/plan_review`,
+ *  `resource_limit` → `POST /v1/assistant/tasks/:id/resume`;原样重试永远同一个结果。
+ *  🔴 与 session-CAS `ConflictError` 刻意不同类:两者都是 409,但这一条说的是「你敲错门了」,处置是**换端点**,
+ *  不是「重读再试」。 */
+export declare class GateNotToolApprovalError extends APIError {
+}
 /** design/80 D-G — the direct-connect door requires the HMAC envelope (`X-Approval-Mac`) and it was absent. */
 export declare class ApprovalMacRequiredError extends APIError {
 }
@@ -299,7 +334,9 @@ export declare class ResumeBlockedByPolicyError extends APIError {
 export declare class SubagentResumeConflictError extends ConflictError {
 }
 /** 409 `wake.gate_pending`(design/144 §3)—— wake 是消息投递不是门决策:该 session 挂着未决 gate,
- *  去那个 gate 自己的 decide 入口解决(审批永不被 wake 绕过)。 */
+ *  去那个 gate 自己的 decide 入口解决(审批永不被 wake 绕过)。
+ *  ⚠️ [2400] CB-2 起 `wake.` 是**前缀开集**:未来的 `wake.*` 新码至少落到 {@link ConflictError}
+ *  (`.errorCode` 原样携带),不再塌成匿名 409。 */
 export declare class WakeGatePendingError extends ConflictError {
 }
 /** 409 `compact.not_running` / `detach.not_running` —— replica-local live-verb 族:run 已终态,或活在

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/errors.js

@@ -23,19 +23,25 @@ export class APIError extends Error {
         this.name = new.target.name;
     }
 }
-/** `auth.*` 前缀族 + 401/503 状态兜底 —— fail-closed auth(缺/错 SERVICE_AUTH_TOKEN、非属主、
+/** `auth.*` 前缀族 + 401 状态兜底 —— fail-closed auth(缺/错 SERVICE_AUTH_TOKEN、非属主、
  *  operator-only、bake-runner-only、principal 头缺席…)。
  *
  *  🔴 键位优先于状态(SDK 1.1.0):此前这个类**只**按 `status === 401 || status === 503` 分,于是
  *  `auth.forbidden` / `auth.operator_only` / `auth.bake_runner_only` / `auth.ingest_secret_invalid`
  *  四个 403 全塌成裸 APIError,而同一条 503 分支还错吞了 `state.*`(见 {@link ServiceStateError})。
- *  现在先按 `auth.` 前缀分,状态兜底留作**没有机器码时**的退路。 */
+ *  现在先按 `auth.` 前缀分,状态兜底留作**没有机器码时**的退路。
+ *
+ *  🔴 [2400] CB-3(SDK 4.2.0):状态兜底**只剩 401**。无码 503 已改归 {@link ServiceStateError} —— 那条臂
+ *  上真正可达的是中间层的无码 503(「上游暂时不可用」),把它铸成本类等于把「稍后重试」说成「你没权限」。 */
 export class AuthError extends APIError {
 }
 // ── 附录 A 判据三:9 个稳定前缀族的兜底 typed 面(SDK 1.1.0 × server 3.0.0)────────────────────────
 // 服务端契约原文(ASSISTANT-WIRE-CONTRACT 附录 A 判据三):「前缀族(`auth.` / `request.` /
 // `not_found.` / `conflict.` / `limit.` / `capability.` / `feature.` / `internal.` / `state.`)是稳定的
 // **粗分支面** —— 按前缀兜底(未知码 → 看前缀 → 再不行看状态码)永远安全。」
+// [2400] CB-2(SDK 4.2.0)在这张表上再加两族:`checkpoint.` 与 `wake.`(见表内注)。它们不在附录 A 的
+// 九族里,因为那九族是 server **自己**铸的码;这两族是 core 码经 server 原样镜像上 wire 的(server
+// `src/http/server.ts:2199-2206`)—— 同样是开集,同样需要前缀兜底。
 //
 // 🔴 为什么这不是「把码抄进 SDK」这么轻:补齐之前,`capability.run_store_required`(**换部署形态**才可能有)
 // 与 `feature.elicitation_disabled`(**开个开关**就行)都是 501、都塌成裸 `APIError` —— 消费端拿不到任何
@@ -83,7 +89,13 @@ export class InternalServerError extends APIError {
 /** `state.*` 前缀族 —— 服务端**当前状态**不接受这个请求(503):roster 还没拉到、没有可用的
  *  sandbox-base。**稍后重试**是主处置。
  *  🔴 修的是一条真缝:这一族此前撞进 `status === 503` 那条分支,被铸成了 {@link AuthError} —— 一个
- *  「稍后重试」的信号被读成了「你没有权限」。 */
+ *  「稍后重试」的信号被读成了「你没有权限」。
+ *
+ *  🔴 [2400] CB-3(SDK 4.2.0)——**无机器码的 503 也归这里**。上一版只把带 `state.` 码的那部分捞了出来,
+ *  裸 503 仍落在 `status === 401 || status === 503` 那条 auth 兜底上。方向反转在这一臂上更刺眼:worker
+ *  自发的 503 恒带码(`state.*` / `draining` / `capability.*`),所以**这条臂真正可达的只有中间层**
+ *  (ingress / service-mesh / 反代)吐的无码 503 —— 那恰恰是「上游暂时不可用,稍后重试」,却被读成
+ *  「你没有权限」。401 不受影响:无码 401 仍是 {@link AuthError}(fail-closed auth 的方向是对的)。 */
 export class ServiceStateError extends APIError {
 }
 /** 413 `workspace_file_too_large`(#3 workspace file 面,[1894]①)——结构化超限信封的 typed 形:
@@ -124,8 +136,26 @@ export class DrainingError extends APIError {
 /** 429 —— per-principal 限流。`retryAfterMs` 来自 `Retry-After`(SDK 重试时遵守它)。
  *  自 SDK 1.1.0 起继承 {@link LimitExceededError}(`limit.*` 族的成员码 `limit.rate_exceeded` /
  *  `limit.cost_quota_exceeded` 就是从这里下来的)——**additive**:既有 `instanceof RateLimitedError`
- *  一字不改,同时 `catch (e instanceof LimitExceededError)` 也能一把接住整族。 */
+ *  一字不改,同时 `catch (e instanceof LimitExceededError)` 也能一把接住整族。
+ *
+ *  🔴 [2400] CB-5(SDK 4.2.0):`limit.cost_quota_exceeded` 的 body 带**成本材料**
+ *  (server `src/http/server.ts:2491` — `{ usedMicroUsd, limitMicroUsd, retryAfterSec }`),此前整包丢在
+ *  wire 上、消费端只能拿到一句「cost quota exceeded」。两键在此结构化上来,渲染层才写得出「已用
+ *  $X / 上限 $Y」(人话归壳,wire 保持结构化)。守卫式提取(照 {@link QuotaExhaustedDetail} 的姿势):
+ *  非有限数一律丢弃 ⇒ 字段缺席,**绝不在错误路径上崩**;裸码(无字段)照样铸本类。
+ *  ⚠️ 单位是 **micro-USD**(1e-6 USD),不是分、不是美元。 */
 export class RateLimitedError extends LimitExceededError {
+    usedMicroUsd;
+    limitMicroUsd;
+    constructor(status, errorCode, message, retryAfterMs, 
+    /** `limit.cost_quota_exceeded` only —— 本窗口已花费(micro-USD)。缺席 = 服务端没给/给了坏值。 */
+    usedMicroUsd, 
+    /** `limit.cost_quota_exceeded` only —— 本窗口的上限(micro-USD)。缺席同上。 */
+    limitMicroUsd) {
+        super(status, errorCode, message, retryAfterMs);
+        this.usedMicroUsd = usedMicroUsd;
+        this.limitMicroUsd = limitMicroUsd;
+    }
 }
 /** 429 `errorCode:"quota_exhausted"` — the principal's usage quota (token windows / budget) is exhausted
  *  (E4 double-rail, service ≥1.150.0). Extends RateLimitedError so existing 429 handling still matches;
@@ -286,6 +316,16 @@ export class GateNotResumableError extends APIError {
  *  Client action: 按 gateKind 选对的决策端点（/decide 或 /resume）, 重取 inbox。 */
 export class GateNotPlanReviewError extends APIError {
 }
+/** [2400] CB-2(SDK 4.2.0)—— 语义错门守卫的**第三个**成员(与上面两兄弟同形):你对一个**不是工具审批门**
+ *  的挂起调了 `/v1/approvals/:sessionId/decide`。409 errorCode `gate_not_tool_approval`
+ *  (server `src/http/server.ts:1581` 的 pre-CAS 纯拒绝:门类不是 `human` / `irreversible_ask` 就在这里拦掉,
+ *  不动 checkpoint、不动 run 行、不烧模型腿)。
+ *  Client action:按 `gateKind` 改走对的那道门 —— `plan_review` → `POST /v1/assistant/tasks/:id/plan_review`,
+ *  `resource_limit` → `POST /v1/assistant/tasks/:id/resume`;原样重试永远同一个结果。
+ *  🔴 与 session-CAS `ConflictError` 刻意不同类:两者都是 409,但这一条说的是「你敲错门了」,处置是**换端点**,
+ *  不是「重读再试」。 */
+export class GateNotToolApprovalError extends APIError {
+}
 /** design/80 D-G — the direct-connect door requires the HMAC envelope (`X-Approval-Mac`) and it was absent. */
 export class ApprovalMacRequiredError extends APIError {
 }
@@ -327,7 +367,9 @@ export class ResumeBlockedByPolicyError extends APIError {
 export class SubagentResumeConflictError extends ConflictError {
 }
 /** 409 `wake.gate_pending`(design/144 §3)—— wake 是消息投递不是门决策:该 session 挂着未决 gate,
- *  去那个 gate 自己的 decide 入口解决(审批永不被 wake 绕过)。 */
+ *  去那个 gate 自己的 decide 入口解决(审批永不被 wake 绕过)。
+ *  ⚠️ [2400] CB-2 起 `wake.` 是**前缀开集**:未来的 `wake.*` 新码至少落到 {@link ConflictError}
+ *  (`.errorCode` 原样携带),不再塌成匿名 409。 */
 export class WakeGatePendingError extends ConflictError {
 }
 /** 409 `compact.not_running` / `detach.not_running` —— replica-local live-verb 族:run 已终态,或活在
@@ -396,7 +438,11 @@ function classifyApiError(status, body, retryAfterMs) {
     //    `sendError(res,status,errorCode,message,extra)` + `/decide` 归一臂),兜底随之删除 —— 留着它只会让
     //    「对端还在发老键」这件事被静默吸收、下游测不出来。`event: error` 流帧那套不经本函数(见 sse.ts)。
     const errorCode = b.errorCode ?? nestedCode;
-    const rawMsg = b.errorMessage ?? (typeof errField === "string" ? errField : undefined);
+    // 🔴 [2400] CB-6(SDK 4.2.0):回落链**末位**补 `b.message`。server 的
+    // `sendError(res, status, code, msg, { message: "<人话>" })` 家族(`src/http/server.ts:888/897` 等)把给人看
+    // 的那句放在 extra.message 里;`error` 缺席或是对象形时,此前这一形整句丢失、只剩 `HTTP 5xx`。
+    // ⚠️ 是**补末位**不是抢位:`errorMessage` / 字符串 `error` 仍然优先(那两键是主渠道)。
+    const rawMsg = b.errorMessage ?? (typeof errField === "string" ? errField : undefined) ?? (typeof b.message === "string" ? b.message : undefined);
     const msg = scrub(rawMsg ?? nestedCode ?? `HTTP ${status}`);
     // scenario governance — server 侧 `HttpError(400, msg, { code: "scenario_not_allowed", extra:{allowlist} })`
     // 经 `sendError` 落到 wire 的 `errorCode` 单键。The allowlist passes through with a per-entry type guard
@@ -427,6 +473,9 @@ function classifyApiError(status, body, retryAfterMs) {
         return new GateNotResumableError(status, errorCode, msg); // §4b resume 撞 human/policy_ask
     if (errorCode === "gate_not_plan_review")
         return new GateNotPlanReviewError(status, errorCode, msg); // §4c plan_review 撞非 plan_review
+    // [2400] CB-2:第三个错门守卫 —— /decide 撞非 tool-approval 门(server src/http/server.ts:1581 pre-CAS 拒绝)。
+    if (errorCode === "gate_not_tool_approval")
+        return new GateNotToolApprovalError(status, errorCode, msg);
     // `steering.*` —— 前缀分派(SDK 1.1.0,与 `stop.*` / `decide.*` 同形;见 SteeringError 顶注)。
     // 未来 server 新铸的 steering 码至少落到 SteeringError 基类,不再塌成匿名 409。
     if (errorCode?.startsWith("steering.")) {
@@ -510,6 +559,12 @@ function classifyApiError(status, body, retryAfterMs) {
             };
             return new QuotaExhaustedError(status, errorCode, msg, retryAfterMs, detail);
         }
+        // [2400] CB-5:`limit.cost_quota_exceeded` 的成本材料(server src/http/server.ts:2491)结构化上来。
+        // 守卫式(同 quota detail):非有限数丢弃 ⇒ 字段缺席,裸码照样铸 RateLimitedError。
+        const used = typeof b.usedMicroUsd === "number" && Number.isFinite(b.usedMicroUsd) ? b.usedMicroUsd : undefined;
+        const cap = typeof b.limitMicroUsd === "number" && Number.isFinite(b.limitMicroUsd) ? b.limitMicroUsd : undefined;
+        if (used !== undefined || cap !== undefined)
+            return new RateLimitedError(status, errorCode, msg, retryAfterMs, used, cap);
         // `limit.rate_exceeded` / `limit.cost_quota_exceeded` 也从这里出去 —— RateLimitedError 是
         // LimitExceededError 的子类,所以走这条更具体的腿**不会**让 `limit.*` 族的兜底落空,反而多带了
         // `retryAfterMs`。⚠️ 正因如此,下面的 `limit.` 前缀分派必须排在 429 之后(排前面会把这条腿吃掉)。
@@ -545,9 +600,28 @@ function classifyApiError(status, body, retryAfterMs) {
             return new InternalServerError(status, errorCode, msg);
         if (errorCode.startsWith("state."))
             return new ServiceStateError(status, errorCode, msg);
+        // ── [2400] CB-2:两条**新前缀族**(照 `steering.` 的前缀分派先例)────────────────────────────────
+        // `checkpoint.*`(core 5.1.0 实扫 10 个成员码,server `src/http/server.ts:2199-2206` 原样镜像上 wire):
+        // 此前只有 3 个被具名(already_resolved / reopened_concurrently / invalid_outcome,都排在上面),其余
+        // 全塌成匿名 409 / 裸 APIError —— 一个开集被当闭集写。状态分派与铸造点同源:`not_found` 是这一族里
+        // **唯一**的 404(`e.code === "checkpoint.not_found" ? 404 : 409`)⇒ NotFound 语义(那条 checkpoint 已经
+        // 不在了,重查 inbox);其余是 409 ⇒ 复用 {@link ConflictError}(它本就携带冲突材料)。
+        if (errorCode.startsWith("checkpoint.")) {
+            if (errorCode === "checkpoint.not_found")
+                return new NotFoundError(status, errorCode, msg);
+            return new ConflictError(status, errorCode, msg, b.activeTaskId, b.activeTaskStatus, b.pendingGate);
+        }
+        // `wake.*`(design/144 §3):`wake.gate_pending` 走上面更具体的腿;族兜底让未来的新码也带着码落到
+        // ConflictError,不塌匿名 409。
+        if (errorCode.startsWith("wake."))
+            return new ConflictError(status, errorCode, msg, b.activeTaskId, b.activeTaskStatus, b.pendingGate);
     }
-    if (status === 401 || status === 503)
+    if (status === 401)
         return new AuthError(status, errorCode, msg);
+    // 🔴 [2400] CB-3:无机器码的 503 = **稍后重试**,不是「你没权限」。见 {@link ServiceStateError} 顶注:
+    // worker 自发的 503 恒带码,所以这条臂真正可达的只有中间层(ingress/mesh)吐的无码 503。
+    if (status === 503)
+        return new ServiceStateError(status, errorCode, msg);
     // 2c session-sync: a 409 `conflict` that CARRIES a fork/stale `relation` is the SyncConflictError (distinct from
     // the session-CAS ConflictError, which has no `relation`). Keyed on the relation's presence + tag, not status alone.
     if (status === 409 && errorCode === "conflict" && (b.relation?.relation === "fork" || b.relation?.relation === "stale")) {

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/events.d.ts

@@ -19,6 +19,8 @@
  *  - §E13: a `workspace_changed` arm (a `cd` moved the tracked cwd — LIVE-only, for the shell's path display).
  */
 import type { TaskResult, ActiveRunConflictDoneResult, CheckpointGate, ModelUsageDelta } from "./types.js";
+/** TR-7:`question` 臂的载荷与 `client.questions` 面**同一个**类型(单源)—— 类型-only 导入,运行时零边。 */
+import type { AskQuestion } from "./resources/questions.js";
 /**
  * design/99 §E2 (core `TaskEventIdentity` types.ts:986-989; service `identityFields` project.ts:78-83) — the
  * lightweight per-event identity carried by every CONTENT event (live + durable). ADDITIVE / tolerate-absent:
@@ -447,7 +449,67 @@ export type AgentEvent =
     source: string;
     preview: string;
     [k: string]: unknown;
-} & EventIdentity);
+} & EventIdentity)
+/** 🔴 CB-1(=TR-6)—— 流的 **15 分钟帽帧**,不是 run 的失败(server `src/http/sse-log.ts:86`;
+ *  trace 腿同形,`routes/trace-usage.ts:294`)。server 写的是命名帧 `event: error` + 载荷里回声 `type`。
+ *
+ *  🔴 **到达 ≠ run 死了**:它明说「run 仍然活着」。正确处置 = 按 `Last-Event-ID` **重连续读**
+ *  (durable 腿本就带 `id:`,SDK 的 `runs.events` 自动做这件事);把它当终态渲染会把一条还在跑的任务
+ *  在 UI 上判死。`done`/`failed` 才是终态臂 —— 本臂**不终止**生成器。
+ *  已知 `errorCode`:`STREAM_MAX_DURATION`(开集:按码分支,未知码按「可重连的流控信号」通用降级)。 */
+ | {
+    type: "error";
+    errorCode: string;
+    message?: string;
+}
+/** TR-7 —— AskUserQuestion 的**开问**帧。live 腿走 `event: question` 名分派(`routes/tasks.ts:677`,
+ *  与 `elicitation` / `tool_approval` 同一条 out-of-band 通道);durable 腿由 `runs.ts:498` 的
+ *  `append(type, rest)` 落库,于是同名帧也出现在 `GET /v1/runs/:id/events` 的重放上 —— 这一半此前
+ *  SDK/spec 两侧同缺。键形抄 server `src/question.ts:38` 的 `QuestionFrame` 真铸点。
+ *  🔴 UNTRUSTED-for-display:`questions` 已脱敏,渲染即可,**永不回喂模型**。
+ *  `questions` 缺席 = 载荷超 16 KiB 帽被丢(那一问 headless-default,人看不到也答不了)。 */
+ | {
+    type: "question";
+    questionId: string;
+    questions?: AskQuestion[];
+}
+/** TR-7 —— AskUserQuestion 的**收尾**帧(对话框消失信号)。`outcome`:`answered` = 人答了;
+ *  `unanswered` = ttl/abort/限流放行(模型拿到 headless 默认值)。纯装饰,不影响 run 状态。 */
+ | {
+    type: "question_complete";
+    questionId: string;
+    outcome?: "answered" | "unanswered";
+}
+/** TR-7 —— 入站 MCP elicitation 的**开问**帧(server `src/elicitation.ts:42` 的 `ElicitationFrame`)。
+ *  两腿同上:live 走 `event:` 名分派,durable 腿经 `append` 落库后在重放里以本臂出现。
+ *  🔴 UNTRUSTED:`message` 已 fence + 脱敏,`requestedSchema` 是**不解释**的透传(仍需壳侧 fence)。
+ *  v1 恒 `mode:"form"`(url-mode 在上游被拒——钓鱼面)。 */
+ | {
+    type: "elicitation";
+    elicitationId: string;
+    mcpServerName: string;
+    message?: string;
+    requestedSchema?: unknown;
+    mode?: "form";
+}
+/** TR-7 —— elicitation 的**收尾**帧;`action` = 它怎么了结的(对话框消失原因)。 */
+ | {
+    type: "elicitation_complete";
+    elicitationId: string;
+    mcpServerName: string;
+    action?: "accept" | "decline" | "cancel";
+}
+/** TR-7 —— 异步 workflow 完成的**带外投递**帧(server `src/orchestration/workflow-completion-inbox.ts:522`
+ *  的 `emit({type:"workflow_complete", runId, status, summary})`)。投递时机 = 该 session **下一条腿开流**
+ *  时排空 inbox:sync 腿直接写 live 帧,bg / resume 腿把它 `append` 成 durable 事件供 tailing 客户端重放。
+ *  🔴 **至少一次**语义(两阶段:emit 成功才 ack)—— 两条腿同时开可能双发,消费方按 `runId` 去重。
+ *  `summary` 是脱敏过的自由文本(UNTRUSTED-for-display)。 */
+ | {
+    type: "workflow_complete";
+    runId: string;
+    status: string;
+    summary: string;
+};
 /** Exhaustiveness helper for consumers' switch statements.
  *  ⚠️ COMPILE-TIME aid only ([1543] SDK-H): the wire is an OPEN set — a newer server may emit frame types
  *  this union does not yet name, and a `default: assertNever(ev)` switch would then THROW AT RUNTIME on a