@sema-agent/sdk 0.0.100 → 0.0.102

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/dist/client.d.ts CHANGED
@@ -101,8 +101,10 @@ export declare class AgentClient {
101
101
  /** GET /v1/capabilities/scenarios/:name — one scenario's detail card (server 1.214 server.js:567-576;
102
102
  * `capabilities().scenarios` lists the names, THIS resolves one to its {@link ScenarioDetail}: toolset/tools/
103
103
  * prompt digest/enabled). Same family as {@link capabilities} — a worker-config read, not a resource.
104
- * Unknown name → 404 with the OBJECT-shaped body `{error:{code:"scenario_not_found"}}` (surfaced as a typed
105
- * APIError with `code === "scenario_not_found"`). */
104
+ * Unknown name → 404 `{ error: "scenario not found", errorCode: "scenario_not_found" }`, surfaced as a typed
105
+ * APIError with `code === "scenario_not_found"`.
106
+ * ⚠️ 纠正(2026-07-25):原注说这条 404 是 OBJECT 形 body(`{error:{code:…}}`)——server [939] 已把它统一成
107
+ * 上面这个「字符串 error + 顶层 errorCode」邻位形(亲读 `http/server.ts:1517-1527`)。`code` 判据不变。 */
106
108
  scenarioCapabilities(name: string, opts?: {
107
109
  signal?: AbortSignal;
108
110
  }): Promise<ScenarioDetail>;
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
package/dist/client.js CHANGED
@@ -97,8 +97,10 @@ export class AgentClient {
97
97
  /** GET /v1/capabilities/scenarios/:name — one scenario's detail card (server 1.214 server.js:567-576;
98
98
  * `capabilities().scenarios` lists the names, THIS resolves one to its {@link ScenarioDetail}: toolset/tools/
99
99
  * prompt digest/enabled). Same family as {@link capabilities} — a worker-config read, not a resource.
100
- * Unknown name → 404 with the OBJECT-shaped body `{error:{code:"scenario_not_found"}}` (surfaced as a typed
101
- * APIError with `code === "scenario_not_found"`). */
100
+ * Unknown name → 404 `{ error: "scenario not found", errorCode: "scenario_not_found" }`, surfaced as a typed
101
+ * APIError with `code === "scenario_not_found"`.
102
+ * ⚠️ 纠正(2026-07-25):原注说这条 404 是 OBJECT 形 body(`{error:{code:…}}`)——server [939] 已把它统一成
103
+ * 上面这个「字符串 error + 顶层 errorCode」邻位形(亲读 `http/server.ts:1517-1527`)。`code` 判据不变。 */
102
104
  scenarioCapabilities(name, opts) {
103
105
  return this.transport.request({
104
106
  method: "GET",
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
package/dist/errors.d.ts CHANGED
@@ -6,6 +6,16 @@
6
6
  export declare class APIError extends Error {
7
7
  readonly status: number;
8
8
  readonly code: string | undefined;
9
+ /** `true` = the server said this failure is RETRIABLE: the durable park is still pending, so re-fetching and
10
+ * deciding/resuming again is meaningful (server sets `retriable: true` on the /decide + resume legs).
11
+ *
12
+ * 🔴 `undefined` means "the server did not say", NOT "not retriable" — it is a CONDITIONAL field server-side
13
+ * (absent ⇒ key omitted), so reading its absence as an explicit `false` over-reads the wire.
14
+ *
15
+ * ⚠️ 为什么它不是 `readonly` / 不是构造参数:`retriable` 可以伴随**任何**分支的错误一起回来,而这里已有 25 个
16
+ * 子类、其中好几个有自己的位置化构造签名(retryAfterMs / allowlist / relation …)。做成第 4 个构造参数就得逐个
17
+ * 子类穿线,漏一个就是静默丢信号;做成 mapper 末尾的**单点盖章**则天然覆盖全部返回路径。这是刻意取舍。 */
18
+ retriable?: boolean;
9
19
  constructor(status: number, code: string | undefined, message: string);
10
20
  }
11
21
  /** 401 / 503 — fail-closed auth (missing/bad SERVICE_AUTH_TOKEN). */
@@ -138,7 +148,53 @@ export declare class ApprovalMacRequiredError extends APIError {
138
148
  * decision] tuple). 401. Client action: re-sign with the active HMAC kid; persistent ⇒ key rotation skew. */
139
149
  export declare class ApprovalMacInvalidError extends APIError {
140
150
  }
141
- /** Map an HTTP status + parsed body to the right typed error. Used by transport.ts. */
151
+ /** `resume_outcome_invalid` — a plan_review / dry-run-review outcome was REJECTED BY CONTENT SANITIZE
152
+ * (`editedPlan`/`reason` carried a forbidden tag).
153
+ *
154
+ * 🔴 Deliberately NOT {@link ApprovalBindingMismatchError}: core raises one code (`checkpoint.invalid_outcome`)
155
+ * for two different things, and the server splits them by gate — on `policy_ask` it IS the D-1 action-binding
156
+ * mismatch, on plan_review/dry_run_review it is this content reject. The server mints this separate code
157
+ * precisely so a UI routes to the right recovery (fix the text and re-submit) instead of the action-binding
158
+ * flow. Collapsing the two back into one type in the SDK would undo that split. Usually `retriable`. */
159
+ export declare class ResumeOutcomeInvalidError extends APIError {
160
+ }
161
+ /** `resume_blocked_by_policy` — an admission policy CHANGED between suspend and resume, and the resume is no
162
+ * longer admissible. Not a race: retrying as-is stays blocked until the policy or the request changes. */
163
+ export declare class ResumeBlockedByPolicyError extends APIError {
164
+ readonly blockedBy?: string | undefined;
165
+ constructor(status: number, code: string | undefined, message: string, blockedBy?: string | undefined);
166
+ }
167
+ /** Base of the `decide.*` family — catch this to handle the whole decide door in one place.
168
+ * Every decide.* body carries `taskId`; the revive legs additionally carry a `rollback` disposition (whether the
169
+ * claim was rolled back). Codes that fall on THIS class rather than a subclass need a human: `row_unrevivable`
170
+ * (damaged row), `revive_failed`, `revive_rejected`. */
171
+ export declare class DecideError extends APIError {
172
+ readonly taskId?: string | undefined;
173
+ /** revive legs only — the claim-rollback disposition the server reported. */
174
+ readonly rollback?: string | undefined;
175
+ constructor(status: number, code: string | undefined, message: string, taskId?: string | undefined,
176
+ /** revive legs only — the claim-rollback disposition the server reported. */
177
+ rollback?: string | undefined);
178
+ }
179
+ /** `decide.not_parked` / `decide.gate_moved` / `decide.claim_lost` — the park moved under this decide (stopped,
180
+ * already decided, re-parked, or another operator's decide won). Caller action: RE-FETCH the pending list and
181
+ * decide again from the fresh state. (`claim_lost` may also be a stale claim awaiting automatic cleanup — the
182
+ * same re-fetch covers it, after the stale-claim window.) */
183
+ export declare class DecideParkMovedError extends DecideError {
184
+ }
185
+ /** `decide.parked_answer_unsupported` / `..._question_unsupported` / `..._remember_unsupported` — this park
186
+ * shape does not support the decide you sent (no question hookpoint on the revive path; no session anchor for a
187
+ * remember exemption; approve is not available for a parked AskUserQuestion). Caller action: send a DIFFERENT
188
+ * decide shape (deny / stop the agent / let the gate expire) — retrying the same body will never succeed. */
189
+ export declare class DecideUnsupportedError extends DecideError {
190
+ }
191
+ /** `decide.store_unreachable` — the durable agent store is unreachable. Transient: retry the same decide. */
192
+ export declare class DecideStoreUnreachableError extends DecideError {
193
+ }
194
+ /** Map an HTTP status + parsed body to the right typed error. Used by transport.ts.
195
+ *
196
+ * 🔴 `retriable` 的盖章在这里做**一次**(见 {@link APIError.retriable} 说明为什么不是构造参数),所以真正的
197
+ * 分类逻辑放在 {@link classifyApiError} 里 —— 那个函数有十几条 `return new X(...)`,若逐条穿线迟早漏一条。 */
142
198
  export declare function toApiError(status: number, body: unknown, retryAfterMs?: number): APIError;
143
199
  /** Base for every control-plane (registry) error. Distinct from APIError so a caller can branch on which plane
144
200
  * failed. `message` is secret-scrubbed (a registry/proxy may echo an Authorization header into an error body). */
@@ -1 +1 @@
1
- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
package/dist/errors.js CHANGED
@@ -6,6 +6,16 @@
6
6
  export class APIError extends Error {
7
7
  status;
8
8
  code;
9
+ /** `true` = the server said this failure is RETRIABLE: the durable park is still pending, so re-fetching and
10
+ * deciding/resuming again is meaningful (server sets `retriable: true` on the /decide + resume legs).
11
+ *
12
+ * 🔴 `undefined` means "the server did not say", NOT "not retriable" — it is a CONDITIONAL field server-side
13
+ * (absent ⇒ key omitted), so reading its absence as an explicit `false` over-reads the wire.
14
+ *
15
+ * ⚠️ 为什么它不是 `readonly` / 不是构造参数:`retriable` 可以伴随**任何**分支的错误一起回来,而这里已有 25 个
16
+ * 子类、其中好几个有自己的位置化构造签名(retryAfterMs / allowlist / relation …)。做成第 4 个构造参数就得逐个
17
+ * 子类穿线,漏一个就是静默丢信号;做成 mapper 末尾的**单点盖章**则天然覆盖全部返回路径。这是刻意取舍。 */
18
+ retriable;
9
19
  constructor(status, code, message) {
10
20
  super(message);
11
21
  this.status = status;
@@ -140,24 +150,106 @@ export class ApprovalMacRequiredError extends APIError {
140
150
  * decision] tuple). 401. Client action: re-sign with the active HMAC kid; persistent ⇒ key rotation skew. */
141
151
  export class ApprovalMacInvalidError extends APIError {
142
152
  }
143
- /** Map an HTTP status + parsed body to the right typed error. Used by transport.ts. */
153
+ /** `resume_outcome_invalid` — a plan_review / dry-run-review outcome was REJECTED BY CONTENT SANITIZE
154
+ * (`editedPlan`/`reason` carried a forbidden tag).
155
+ *
156
+ * 🔴 Deliberately NOT {@link ApprovalBindingMismatchError}: core raises one code (`checkpoint.invalid_outcome`)
157
+ * for two different things, and the server splits them by gate — on `policy_ask` it IS the D-1 action-binding
158
+ * mismatch, on plan_review/dry_run_review it is this content reject. The server mints this separate code
159
+ * precisely so a UI routes to the right recovery (fix the text and re-submit) instead of the action-binding
160
+ * flow. Collapsing the two back into one type in the SDK would undo that split. Usually `retriable`. */
161
+ export class ResumeOutcomeInvalidError extends APIError {
162
+ }
163
+ /** `resume_blocked_by_policy` — an admission policy CHANGED between suspend and resume, and the resume is no
164
+ * longer admissible. Not a race: retrying as-is stays blocked until the policy or the request changes. */
165
+ export class ResumeBlockedByPolicyError extends APIError {
166
+ blockedBy;
167
+ constructor(status, code, message, blockedBy) {
168
+ super(status, code, message);
169
+ this.blockedBy = blockedBy;
170
+ }
171
+ }
172
+ // ── decide.* family (the parked-agent decide door) ───────────────────────────────────────────────────────
173
+ // 10 codes, machine-enumerated from the server source (`src/parked-decide.ts`). Grouped by **what the caller
174
+ // should do**, NOT by HTTP status — those two disagree here: `decide.row_unrevivable` is also a 409, but it means
175
+ // "the row carries no agent name (damaged?)", where re-fetching/retrying will never help, i.e. the opposite
176
+ // action from the not_parked/gate_moved/claim_lost group. Grouping by status would have merged them.
177
+ //
178
+ // ⚠️ The server communicates the retry doctrine only inside the human-readable `error` string today ("— retry",
179
+ // "re-check the pending list"). These types are what makes it branchable without string-matching a message.
180
+ /** Base of the `decide.*` family — catch this to handle the whole decide door in one place.
181
+ * Every decide.* body carries `taskId`; the revive legs additionally carry a `rollback` disposition (whether the
182
+ * claim was rolled back). Codes that fall on THIS class rather than a subclass need a human: `row_unrevivable`
183
+ * (damaged row), `revive_failed`, `revive_rejected`. */
184
+ export class DecideError extends APIError {
185
+ taskId;
186
+ rollback;
187
+ constructor(status, code, message, taskId,
188
+ /** revive legs only — the claim-rollback disposition the server reported. */
189
+ rollback) {
190
+ super(status, code, message);
191
+ this.taskId = taskId;
192
+ this.rollback = rollback;
193
+ }
194
+ }
195
+ /** `decide.not_parked` / `decide.gate_moved` / `decide.claim_lost` — the park moved under this decide (stopped,
196
+ * already decided, re-parked, or another operator's decide won). Caller action: RE-FETCH the pending list and
197
+ * decide again from the fresh state. (`claim_lost` may also be a stale claim awaiting automatic cleanup — the
198
+ * same re-fetch covers it, after the stale-claim window.) */
199
+ export class DecideParkMovedError extends DecideError {
200
+ }
201
+ /** `decide.parked_answer_unsupported` / `..._question_unsupported` / `..._remember_unsupported` — this park
202
+ * shape does not support the decide you sent (no question hookpoint on the revive path; no session anchor for a
203
+ * remember exemption; approve is not available for a parked AskUserQuestion). Caller action: send a DIFFERENT
204
+ * decide shape (deny / stop the agent / let the gate expire) — retrying the same body will never succeed. */
205
+ export class DecideUnsupportedError extends DecideError {
206
+ }
207
+ /** `decide.store_unreachable` — the durable agent store is unreachable. Transient: retry the same decide. */
208
+ export class DecideStoreUnreachableError extends DecideError {
209
+ }
210
+ /** Map an HTTP status + parsed body to the right typed error. Used by transport.ts.
211
+ *
212
+ * 🔴 `retriable` 的盖章在这里做**一次**(见 {@link APIError.retriable} 说明为什么不是构造参数),所以真正的
213
+ * 分类逻辑放在 {@link classifyApiError} 里 —— 那个函数有十几条 `return new X(...)`,若逐条穿线迟早漏一条。 */
144
214
  export function toApiError(status, body, retryAfterMs) {
215
+ const err = classifyApiError(status, body, retryAfterMs);
216
+ // 只在服务端**明确**说 true 时盖章:server 侧是条件 spread(`...(retriable ? {retriable:true} : {})`),
217
+ // 缺席 ⇒ 保持 undefined(=「没说」),绝不写成 false —— 那会把"没说"读成"明确不可重试"。
218
+ if (body?.retriable === true)
219
+ err.retriable = true;
220
+ return err;
221
+ }
222
+ function classifyApiError(status, body, retryAfterMs) {
145
223
  const b = (body ?? {});
146
- // 🔴 `error` is not always a string: the scenario-detail 404 body is `{error:{code:"scenario_not_found"}}`
147
- // (server 1.214 server.js:570). Coerce non-strings to a fallback (and surface a nested `error.code` as the
148
- // typed code) instead of crashing scrub() inside the error path.
224
+ // 🔴 `error` is not always a string — coerce non-strings to a fallback (and surface a nested `error.code` as
225
+ // the typed code) instead of crashing scrub() INSIDE the error path (a throw here would mask the real HTTP
226
+ // failure with a TypeError).
227
+ // ⚠️ 纠正(2026-07-25):这段注释原先说「scenario-detail 的 404 body 就是 `{error:{code:…}}`」——已不成立,
228
+ // server [939] 把那一路统一成了「字符串 `error` + 顶层 `errorCode`」(亲读 `http/server.ts:1517-1527` 确认)。
229
+ // 本分支**保留**,但定位从「适配某条已知路由」改为「防御任何对象形 error body」:它不该是任何路由的期望形,
230
+ // 而是错误路径上不许崩的兜底。真形走下面 `b.errorCode` 那条(优先级更高)。
149
231
  const errField = body?.error;
150
232
  const nestedCode = typeof errField === "object" && errField !== null && typeof errField.code === "string"
151
233
  ? errField.code
152
234
  : undefined;
153
- const code = b.errorCode ?? nestedCode;
235
+ // 🔴 `?? b.code` 是 2026-07-25 补的兜底,补的是一个真缺陷:server 在 `/decide` 上把 CheckpointError 家族的码
236
+ // 发在 **`code`** 字段(`http/server.ts` 的 `body: { error: e.message, code: e.code, … }`),而这里此前只看
237
+ // `errorCode` ⇒ 那一族(`checkpoint.*`/`resume.*`/`wake.*`)的 `APIError.code` **恒为 undefined**,并且下面
238
+ // 两条既有映射(checkpoint.already_resolved / checkpoint.reopened_concurrently)在那条路上**不可达**。
239
+ // 优先级刻意是 errorCode > nested > code:server 在 `checkpoint.invalid_outcome` 上正是「`code` 留原码、
240
+ // `errorCode` 另铸一个 gate-appropriate 码」,重铸必须压过原码,否则那次刻意区分就被这条兜底抹平了。
241
+ // 机器枚举过所有用裸 `code:` 发的 HTTP 错误体(memory_sync_* / resume_blocked_by_policy / quota_exhausted /
242
+ // CheckpointError 族),无一与本兜底冲突;`event: error` 流帧那套(WORKER_DOWN 等)不经本函数。
243
+ const code = b.errorCode ?? nestedCode ?? b.code;
154
244
  const rawMsg = b.errorMessage ?? (typeof errField === "string" ? errField : undefined);
155
245
  const msg = scrub(rawMsg ?? nestedCode ?? `HTTP ${status}`);
156
246
  // scenario governance — the service 400 keys the typed code on `code` (same posture as the E4 quota
157
247
  // 429; the worker envelope's `errorCode` stays untouched for every other route). The allowlist passes
158
248
  // through with a per-entry type guard (a malformed entry is dropped, never crashes the error path); a bare
159
249
  // code with no/bad allowlist still maps to ScenarioNotAllowedError with an empty list (generic-fallback).
160
- if ((code ?? b.code) === "scenario_not_allowed") {
250
+ // (`code` 已由上面的通用兜底吸收了 `b.code`,所以这里不再需要 `code ?? b.code` 的特判形 —— 2026-07-25 收掉,
251
+ // 免得读者以为有两套取码机制在并行。)
252
+ if (code === "scenario_not_allowed") {
161
253
  const allowlist = Array.isArray(b.allowlist) ? b.allowlist.filter((x) => typeof x === "string" && x.length > 0) : [];
162
254
  return new ScenarioNotAllowedError(status, "scenario_not_allowed", msg, allowlist);
163
255
  }
@@ -188,13 +280,38 @@ export function toApiError(status, body, retryAfterMs) {
188
280
  return new ApprovalMacRequiredError(status, code, msg);
189
281
  if (code === "approval_mac_invalid")
190
282
  return new ApprovalMacInvalidError(status, code, msg);
283
+ // resume 侧两个 server 刻意铸出来的码(见各自类注释)。
284
+ if (code === "resume_outcome_invalid")
285
+ return new ResumeOutcomeInvalidError(status, code, msg);
286
+ if (code === "resume_blocked_by_policy") {
287
+ return new ResumeBlockedByPolicyError(status, code, msg, typeof b.blockedBy === "string" ? b.blockedBy : undefined);
288
+ }
289
+ // decide.* 家族 —— 前缀分派,按「调用方该做什么」分组(见 DecideError 上方那段注释)。
290
+ // 前缀式而非逐码穷举:server 新增一个 decide.* 码时,它至少会落到 DecideError 基类(带 taskId,可被
291
+ // `catch (e instanceof DecideError)` 接住),而不是塌成一个匿名 409 —— 未知码的降级仍然是有信息的。
292
+ if (code?.startsWith("decide.")) {
293
+ const taskId = typeof b.taskId === "string" ? b.taskId : undefined;
294
+ const rollback = typeof b.rollback === "string" ? b.rollback : undefined;
295
+ // 重查 pending 列表后再决定
296
+ if (code === "decide.not_parked" || code === "decide.gate_moved" || code === "decide.claim_lost") {
297
+ return new DecideParkMovedError(status, code, msg, taskId, rollback);
298
+ }
299
+ // 换 decide 形(原样重试无意义)
300
+ if (code === "decide.parked_answer_unsupported" || code === "decide.parked_question_unsupported" || code === "decide.parked_remember_unsupported") {
301
+ return new DecideUnsupportedError(status, code, msg, taskId, rollback);
302
+ }
303
+ // 原样重试
304
+ if (code === "decide.store_unreachable")
305
+ return new DecideStoreUnreachableError(status, code, msg, taskId, rollback);
306
+ // 其余(row_unrevivable / revive_failed / revive_rejected)= 交给人看
307
+ return new DecideError(status, code, msg, taskId, rollback);
308
+ }
191
309
  if (status === 429) {
192
310
  // E4 quota deny — the SERVICE 429 body keys the typed code on `code` (NOT `errorCode`; the
193
311
  // worker envelope's errorCode stays untouched for every other route). Structured fields pass through
194
312
  // VERBATIM with type guards (a malformed field is dropped, never crashes the error path); a bare code
195
313
  // with no fields still maps to QuotaExhaustedError with an empty detail (generic-fallback contract).
196
- const qCode = code ?? b.code;
197
- if (qCode === "quota_exhausted") {
314
+ if (code === "quota_exhausted") { // 同上:通用兜底已覆盖 `b.code` 这个键位
198
315
  const detail = {
199
316
  ...(b.windowType === "fiveHour" || b.windowType === "weekly" || b.windowType === "budget" ? { windowType: b.windowType } : {}),
200
317
  ...(typeof b.remaining === "number" && Number.isFinite(b.remaining) ? { remaining: b.remaining } : {}),
@@ -203,7 +320,7 @@ export function toApiError(status, body, retryAfterMs) {
203
320
  ...(typeof b.pool === "string" ? { pool: b.pool } : {}),
204
321
  ...(typeof b.retryAfterSec === "number" && Number.isFinite(b.retryAfterSec) ? { retryAfterSec: b.retryAfterSec } : {}),
205
322
  };
206
- return new QuotaExhaustedError(status, qCode, msg, retryAfterMs, detail);
323
+ return new QuotaExhaustedError(status, code, msg, retryAfterMs, detail);
207
324
  }
208
325
  return new RateLimitedError(status, code, msg, retryAfterMs);
209
326
  }
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAEtB;IACA;IAFX,YACW,MAAc,EACd,IAAwB,EACjC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAoB;QAIjC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,OAAO,SAAU,SAAQ,QAAQ;CAAG;AAE1C,sGAAsG;AACtG,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IACoC;IAAhF,YAAY,MAAc,EAAE,IAAwB,EAAE,OAAe,EAAW,YAAqB;QACnG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QADiD,iBAAY,GAAZ,YAAY,CAAS;IAErG,CAAC;CACF;AAmBD;;;iGAGiG;AACjG,MAAM,OAAO,mBAAoB,SAAQ,gBAAgB;IAM5C;IALX,YACE,MAAc,EACd,IAAwB,EACxB,OAAe,EACf,YAAgC,EACvB,MAA4B;QAErC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;QAFlC,WAAM,GAAN,MAAM,CAAsB;IAGvC,CAAC;CACF;AAED;;;;+EAI+E;AAC/E,MAAM,OAAO,uBAAwB,SAAQ,QAAQ;IAMxC;IALX,YACE,MAAc,EACd,IAAwB,EACxB,OAAe;IACf,kGAAkG;IACzF,SAAmB;QAE5B,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAFpB,cAAS,GAAT,SAAS,CAAU;IAG9B,CAAC;CACF;AAED,8GAA8G;AAC9G,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;CAAG;AAEpD,kGAAkG;AAClG,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACuC;IAAhF,YAAY,MAAc,EAAE,IAAwB,EAAE,OAAe,EAAW,YAAqB;QACnG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QADiD,iBAAY,GAAZ,YAAY,CAAS;IAErG,CAAC;CACF;AAED;;;;;;yGAMyG;AACzG,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAMvC;IALX,YACE,MAAc,EACd,IAAwB,EACxB,OAAe;IACf,mGAAmG;IAC1F,QAA8D;QAEvE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAFpB,aAAQ,GAAR,QAAQ,CAAsD;IAGzE,CAAC;CACF;AAED;;kHAEkH;AAClH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IACkC;IAAhF,YAAY,MAAc,EAAE,IAAwB,EAAE,OAAe,EAAW,QAAuD;QACrI,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QADiD,aAAQ,GAAR,QAAQ,CAA+C;IAEvI,CAAC;CACF;AAED;;kGAEkG;AAClG,MAAM,OAAO,4BAA6B,SAAQ,QAAQ;IACwB;IAAhF,YAAY,MAAc,EAAE,IAAwB,EAAE,OAAe,EAAW,KAAwC;QACtH,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QADiD,UAAK,GAAL,KAAK,CAAmC;IAExH,CAAC;CACF;AAED;;;yBAGyB;AACzB,MAAM,OAAO,iCAAkC,SAAQ,QAAQ;CAAG;AAElE;;mDAEmD;AACnD,MAAM,OAAO,uBAAwB,SAAQ,QAAQ;CAAG;AAExD;;mGAEmG;AACnG,MAAM,OAAO,2BAA4B,SAAQ,QAAQ;CAAG;AAE5D;;;mFAGmF;AACnF,MAAM,OAAO,wBAAyB,SAAQ,QAAQ;CAAG;AAEzD;;2EAE2E;AAC3E,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;CAAG;AAEtD;;uEAEuE;AACvE,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;CAAG;AAEtD;;sEAEsE;AACtE,MAAM,OAAO,sBAAuB,SAAQ,QAAQ;CAAG;AAEvD,+GAA+G;AAC/G,MAAM,OAAO,wBAAyB,SAAQ,QAAQ;CAAG;AAEzD;8GAC8G;AAC9G,MAAM,OAAO,uBAAwB,SAAQ,QAAQ;CAAG;AAExD,uFAAuF;AACvF,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,IAAa,EAAE,YAAqB;IAC7E,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA+X,CAAC;IACrZ,2GAA2G;IAC3G,2GAA2G;IAC3G,iEAAiE;IACjE,MAAM,QAAQ,GAAa,IAA+C,EAAE,KAAK,CAAC;IAClF,MAAM,UAAU,GACd,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAQ,QAA+B,CAAC,IAAI,KAAK,QAAQ;QAC5G,CAAC,CAAE,QAA6B,CAAC,IAAI;QACrC,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,UAAU,CAAC;IACvC,MAAM,MAAM,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACvF,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,IAAI,UAAU,IAAI,QAAQ,MAAM,EAAE,CAAC,CAAC;IAC5D,oGAAoG;IACpG,sGAAsG;IACtG,2GAA2G;IAC3G,0GAA0G;IAC1G,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,sBAAsB,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClI,OAAO,IAAI,uBAAuB,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,IAAI,KAAK,gBAAgB,IAAI,IAAI,KAAK,iBAAiB;QAAE,OAAO,IAAI,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/G,8GAA8G;IAC9G,IAAI,IAAI,KAAK,gBAAgB,IAAI,IAAI,KAAK,6BAA6B;QAAE,OAAO,IAAI,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IACtI,IAAI,IAAI,KAAK,kCAAkC;QAAE,OAAO,IAAI,iCAAiC,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,+BAA+B;IACjJ,IAAI,IAAI,KAAK,2BAA2B,IAAI,IAAI,KAAK,4BAA4B;QAAE,OAAO,IAAI,4BAA4B,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IACvJ,4GAA4G;IAC5G,IAAI,IAAI,KAAK,oBAAoB;QAAE,OAAO,IAAI,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,gCAAgC;IACxH,IAAI,IAAI,KAAK,sBAAsB;QAAE,OAAO,IAAI,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,iCAAiC;IAC5H,IAAI,IAAI,KAAK,sBAAsB;QAAE,OAAO,IAAI,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,gBAAgB;IAC5G,IAAI,IAAI,KAAK,0BAA0B;QAAE,OAAO,IAAI,2BAA2B,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,sBAAsB;IAC1H,oHAAoH;IACpH,IAAI,IAAI,KAAK,sBAAsB;QAAE,OAAO,IAAI,wBAAwB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAC5F,IAAI,IAAI,KAAK,mBAAmB;QAAE,OAAO,IAAI,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,uCAAuC;IAC9H,IAAI,IAAI,KAAK,uBAAuB;QAAE,OAAO,IAAI,wBAAwB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAC7F,IAAI,IAAI,KAAK,sBAAsB;QAAE,OAAO,IAAI,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3F,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,2FAA2F;QAC3F,qGAAqG;QACrG,sGAAsG;QACtG,qGAAqG;QACrG,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC;QAC7B,IAAI,KAAK,KAAK,iBAAiB,EAAE,CAAC;YAChC,MAAM,MAAM,GAAyB;gBACnC,GAAG,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,IAAI,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9H,GAAG,CAAC,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtG,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAwB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvG,GAAG,CAAC,OAAO,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1E,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvD,GAAG,CAAC,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvH,CAAC;YACF,OAAO,IAAI,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,IAAI,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9E,iHAAiH;IACjH,qHAAqH;IACrH,IAAI,MAAM,KAAK,GAAG,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,KAAK,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,EAAE,CAAC;QACnH,OAAO,IAAI,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,QAAgE,CAAC,CAAC;IACtH,CAAC;IACD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;IAChF,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,2GAA2G;AAC3G,0GAA0G;AAC1G,oHAAoH;AACpH,4GAA4G;AAC5G,yCAAyC;AAEzC;mHACmH;AACnH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAChB;IAArB,YAAqB,MAAc,EAAE,OAAe;QAClD,KAAK,CAAC,OAAO,CAAC,CAAC;QADI,WAAM,GAAN,MAAM,CAAQ;QAEjC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,OAAO,gBAAiB,SAAQ,YAAY;CAAG;AAErD;sFACsF;AACtF,MAAM,OAAO,qBAAsB,SAAQ,YAAY;CAAG;AAE1D,iEAAiE;AACjE,MAAM,OAAO,oBAAqB,SAAQ,YAAY;CAAG;AAEzD;gHACgH;AAChH,MAAM,OAAO,sBAAuB,SAAQ,YAAY;IACA;IAAtD,YAAY,MAAc,EAAE,OAAe,EAAW,MAAuE;QAC3H,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAD6B,WAAM,GAAN,MAAM,CAAiE;IAE7H,CAAC;CACF;AAED;;6EAE6E;AAC7E,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACE;IAAtD,YAAY,MAAc,EAAE,OAAe,EAAW,cAAuB;QAC3E,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAD6B,mBAAc,GAAd,cAAc,CAAS;IAE7E,CAAC;CACF;AAED;kGACkG;AAClG,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,IAAa;IAC1D,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAqF,CAAC;IAC3G,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,IAAI,QAAQ,MAAM,EAAE,CAAC,CAAC;IAC5D,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,MAA2C,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,OAAO,IAAI,sBAAsB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7D,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClE,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjE,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,OAAO,IAAI,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,KAAK,CAAC,CAAS;IAC7B,OAAO,CAAC;SACL,OAAO,CAAC,6BAA6B,EAAE,mBAAmB,CAAC;SAC3D,OAAO,CAAC,6BAA6B,EAAE,4BAA4B,CAAC,CAAC;AAC1E,CAAC"}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -15,7 +15,7 @@ export { assertNever } from "./events.js";
15
15
  export { MetricsResource, OutcomesResource, SendfileLinksResource, type OutcomeRow, type SendfileLinkRow } from "./resources/ops.js";
16
16
  export { BakesResource, type BakeClaim } from "./resources/images.js";
17
17
  export { type UsageAnalyticsParams, type UsageMetric, type UsageGranularity, type UsageTotals, type UsageSummary, type UsageSeries, type UsageBreakdown, type UsageDimension } from "./resources/usage.js";
18
- export { APIError, AuthError, RateLimitedError, QuotaExhaustedError, ScenarioNotAllowedError, BudgetExceededError, ConflictError, SyncConflictError, ApprovalStaleError, ApprovalBindingMismatchError, ApprovalConcurrentlyReopenedError, SteeringNotRunningError, SteeringInvalidContentError, PrincipalUnverifiedError, PrincipalUnboundError, ApprovalMacRequiredError, ApprovalMacInvalidError, GateNotResumableError, GateNotPlanReviewError } from "./errors.js";
18
+ export { APIError, AuthError, RateLimitedError, QuotaExhaustedError, ScenarioNotAllowedError, BudgetExceededError, ConflictError, SyncConflictError, ApprovalStaleError, ApprovalBindingMismatchError, ApprovalConcurrentlyReopenedError, SteeringNotRunningError, SteeringInvalidContentError, PrincipalUnverifiedError, PrincipalUnboundError, ApprovalMacRequiredError, ApprovalMacInvalidError, GateNotResumableError, GateNotPlanReviewError, ResumeOutcomeInvalidError, ResumeBlockedByPolicyError, DecideError, DecideParkMovedError, DecideUnsupportedError, DecideStoreUnreachableError } from "./errors.js";
19
19
  /** E4 quota deny (pinned wire shape) — structured detail on the 429 `quota_exhausted` typed error. */
20
20
  export type { QuotaExhaustedDetail } from "./errors.js";
21
21
  /** 2c session-sync — the NDJSON entry-stream truncation error + the PURE §7 relation classifier (the local peer
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -7,7 +7,9 @@ export { assertNever } from "./events.js";
7
7
  // SDK 全覆盖批(2026-07-17,clay 令:server API 保证=server AI 直责):运维观测/烧制/用量分析面。
8
8
  export { MetricsResource, OutcomesResource, SendfileLinksResource } from "./resources/ops.js";
9
9
  export { BakesResource } from "./resources/images.js";
10
- export { APIError, AuthError, RateLimitedError, QuotaExhaustedError, ScenarioNotAllowedError, BudgetExceededError, ConflictError, SyncConflictError, ApprovalStaleError, ApprovalBindingMismatchError, ApprovalConcurrentlyReopenedError, SteeringNotRunningError, SteeringInvalidContentError, PrincipalUnverifiedError, PrincipalUnboundError, ApprovalMacRequiredError, ApprovalMacInvalidError, GateNotResumableError, GateNotPlanReviewError } from "./errors.js";
10
+ export { APIError, AuthError, RateLimitedError, QuotaExhaustedError, ScenarioNotAllowedError, BudgetExceededError, ConflictError, SyncConflictError, ApprovalStaleError, ApprovalBindingMismatchError, ApprovalConcurrentlyReopenedError, SteeringNotRunningError, SteeringInvalidContentError, PrincipalUnverifiedError, PrincipalUnboundError, ApprovalMacRequiredError, ApprovalMacInvalidError, GateNotResumableError, GateNotPlanReviewError,
11
+ // resume/decide 面(2026-07-25):见 errors.ts 各类注释。`DecideError` 是家族基类 —— 一把 catch 住 decide 门。
12
+ ResumeOutcomeInvalidError, ResumeBlockedByPolicyError, DecideError, DecideParkMovedError, DecideUnsupportedError, DecideStoreUnreachableError } from "./errors.js";
11
13
  /** 2c session-sync — the NDJSON entry-stream truncation error + the PURE §7 relation classifier (the local peer
12
14
  * decides fast-forward/fork BEFORE pulling/pushing). */
13
15
  export { SyncTruncatedError } from "./sse.js";
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,WAAW,EAA+C,MAAM,aAAa,CAAC;AACvF;qEACqE;AACrE,OAAO,EAAE,aAAa,EAA4B,MAAM,qBAAqB,CAAC;AAwB9E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,wEAAwE;AACxE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,qBAAqB,EAAyC,MAAM,oBAAoB,CAAC;AACrI,OAAO,EAAE,aAAa,EAAkB,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,iCAAiC,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAGvc;yDACyD;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C;6GAC6G;AAC7G,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC;6GAC6G;AAC7G,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,6BAA6B,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGrH,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAA+C,MAAM,2BAA2B,CAAC;AAI3G,qGAAqG;AACrG,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAaxK,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD;6FAC6F;AAC7F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAMrD;iHACiH;AACjH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,WAAW,EAA+C,MAAM,aAAa,CAAC;AACvF;qEACqE;AACrE,OAAO,EAAE,aAAa,EAA4B,MAAM,qBAAqB,CAAC;AAwB9E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,wEAAwE;AACxE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,qBAAqB,EAAyC,MAAM,oBAAoB,CAAC;AACrI,OAAO,EAAE,aAAa,EAAkB,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,iCAAiC,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,sBAAsB;AAC/a,2FAA2F;AAC3F,yBAAyB,EAAE,0BAA0B,EACrD,WAAW,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAG9G;yDACyD;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C;6GAC6G;AAC7G,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC;6GAC6G;AAC7G,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,6BAA6B,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGrH,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAA+C,MAAM,2BAA2B,CAAC;AAI3G,qGAAqG;AACrG,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAaxK,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD;6FAC6F;AAC7F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAMrD;iHACiH;AACjH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
package/dist/types.d.ts CHANGED
@@ -6,6 +6,43 @@
6
6
  * 🔴 The SHARED WORK-VIEW MODEL (Task/Run/Artifact) is the anti-fragmentation substrate (DIRECTION.md §2):
7
7
  * ALL doors — CC/Codex via the MCP façade, and web-native — produce the SAME Task/Run/Artifact. A dev's
8
8
  * run and an ordinary user's run look identical in the workspace. Do NOT fork this per door.
9
+ *
10
+ * ─────────────────────────── CROSS-CUTTING WIRE CONVENTIONS (read before "fixing" an inconsistency) ─────
11
+ * These were UNDOCUMENTED until 2026-07-25, which made two of them read as sloppiness. An external audit
12
+ * (blackboard [1640]) flagged the checkpoint-family types as "three axes out of alignment"; verifying each
13
+ * against the real code showed the conventions are deliberate and the actual gap was that nobody had written
14
+ * them down (see [1690]). Written down now, so the next reader doesn't "normalize" away a real design.
15
+ *
16
+ * ① TIMESTAMP FORMAT FOLLOWS THE DATA'S ORIGIN — not one global rule:
17
+ * - **epoch-ms** when the value comes from a CORE PROJECTION: `CheckpointSummary` (core
18
+ * `summarizeCheckpoint`), `WorkflowRun`/`WorkflowRunSummary` (core `summarizeWorkflowRun`),
19
+ * `PendingCheckpoint` (mirrors core's `Checkpoint.createdAt`). core's internal convention is epoch-ms and
20
+ * these are byte-identical passthroughs — re-formatting them would be the service INVENTING a shape.
21
+ * - **ISO-8601 string** when the row is SERVICE-OWNED ledger data: `SessionRecord`, `SessionSummary`,
22
+ * `AssistantTask`, `TaskSummary`. These are the list/keyset surfaces — an ISO string sorts
23
+ * lexicographically, so it doubles as the pagination cursor (`listRuns`' cursor is literally
24
+ * `{createdAt: string}`, validated with `Date.parse`).
25
+ * ⇒ `AssistantTask.createdAt` (ISO) sitting next to its own `gate.deadline` (epoch-ms) is NOT drift: the
26
+ * task row is service-owned, the gate is a core projection. Both halves follow the rule.
27
+ *
28
+ * ② NESTED DISCRIMINANT vs FLATTENED PROJECTION — `kind` vs `gateKind`:
29
+ * core's `CheckpointGate` is a DISCRIMINATED UNION used as a nested field (`Checkpoint.gate`), where `kind`
30
+ * is the discriminant. `CheckpointSummary.gateKind` is its FLATTENED projection, and core types it BY
31
+ * REFERENCE (`CheckpointGate["kind"]`) so it structurally cannot drift. Convention: **`kind` when nested
32
+ * inside the gate object, `gateKind` when flattened onto a row.** Two names, one authority — by design.
33
+ *
34
+ * ③ COST FIELDS ARE DIFFERENT CONCEPTS, not one concept with four names:
35
+ * - `costMicroUsd` = what THIS thing cost (`TaskStats`, `TaskSummary`, `ModelUsageDelta`);
36
+ * - `spentMicroUsd` = cumulative ALREADY-SPENT on a suspend chain, i.e. progress against a budget
37
+ * (`CheckpointSummary`, `AssistantGate`);
38
+ * - `totalMicroUsd` = the total OF A BREAKDOWN object (`SupervisorCostBreakdown`).
39
+ * `TaskStats` additionally carries legacy float `costUsd` alongside integer `costMicroUsd` — prefer the
40
+ * integer for accounting (no FP drift); that pair IS a legacy dual-track, and the only genuine wart here.
41
+ *
42
+ * ④ WHERE NULL IS FOLDED: the wire may send explicit `null` for optional scalars, but resource-layer
43
+ * normalizers fold null → OMITTED KEY before the consumer sees the type (e.g. `resources/assistant.ts`'s
44
+ * `RawAssistantGate` + `normalizeGate`). So a consumer-facing `?: number` that looks like it "lies about
45
+ * null" may be correct — check for a normalizer at the boundary before widening it to `| null`.
9
46
  */
10
47
  import type { SemaSettings } from "./settings.js";
11
48
  /** Authenticated end-user identity. Opaque to the service (used as memory scope + session owner). The SDK
@@ -1328,8 +1365,13 @@ export interface Capabilities {
1328
1365
  * shape = capabilities/scenarios.d.ts `ScenarioDetail` verbatim; the LIST of names rides `capabilities.scenarios`).
1329
1366
  * `source`/`builtin` = builtin vs center-config overlay; `toolset` names the tool bundle, `tools` the resolved
1330
1367
  * tool names; `promptSummary` is a human-readable prompt digest (NOT the full prompt); `enabled` = a center
1331
- * scenario can be declared-but-disabled. UNKNOWN name → 404 `{error:{code:"scenario_not_found"}}` (note the
1332
- * OBJECT-shaped error body — unique to this route). */
1368
+ * scenario can be declared-but-disabled.
1369
+ *
1370
+ * UNKNOWN name → 404 `{ error: "scenario not found", errorCode: "scenario_not_found" }`.
1371
+ * ⚠️ 纠正(2026-07-25 亲读 server `http/server.ts:1517-1527`):这里原先写的是「404 `{error:{code:…}}`,
1372
+ * **对象形** error body —— 全站唯一」。那已经不成立:server 侧 [939] 把这一路统一成了与 cancel/decide 同款的
1373
+ * 「字符串 `error` + 顶层 `errorCode`」邻位形(server 源码旁注逐字记着这次统一),机器判据仍是 `errorCode`。
1374
+ * 旧注是这条路唯一还在宣称「特殊形」的地方,照它写特判分支会白写一个永不命中的分支。 */
1333
1375
  export interface ScenarioDetail {
1334
1376
  name: string;
1335
1377
  source: "builtin" | "center";
@@ -1728,15 +1770,35 @@ export interface InboxRow extends Omit<CheckpointSummary, "token"> {
1728
1770
  * 仅 `tool_approval` gate 带 args,`resource_limit`/`plan_review` 无 args → `null`(容缺渲染)。client 只展示、不重算。 */
1729
1771
  input?: unknown;
1730
1772
  }
1731
- /** §3 GET /v1/assistant/tasks 行内联的 gate。wire 上 severity/spentMicroUsd/deadline 形如 `4 | null` —
1732
- * SDK 侧规约为 `?:number`(缺/null 都容忍, OMIT 优先)。整个 gate 在 wire 上可为 null → AssistantTask.gate 是 `AssistantGate | null`。 */
1773
+ /** §3 `GET /v1/assistant/tasks` 行内联的 gate —— **归一化之后**的消费者面形。整个 gate 在 wire 上可为
1774
+ * null → `AssistantTask.gate` 是 `AssistantGate | null`。
1775
+ *
1776
+ * ⚠️ 为什么三个可选数值字段是 `?: number` 而**不是** `?: number | null`(这一条我自己踩过,记下来免得
1777
+ * 下一个人"顺手修正"它):wire 上它们确实是 `4 | null`(server `http/server.ts:4680` 逐字发
1778
+ * `severity: s.severity ?? null` 等,是**显式 null 不是省略键**),但 SDK 在**资源层边界**就把 null 折成了
1779
+ * 「省略键」——见 `resources/assistant.ts` 的 `RawAssistantGate`(wire 原始形,`?: number | null`)
1780
+ * + `normalizeGate()`(条件 spread 折 null → OMIT)。所以**消费者拿到 `AssistantGate` 时 null 已经不存在了**,
1781
+ * 写 `| null` 反而与实际投递形不符。我曾把这个「边界处归一」误读成「类型对 wire 撒谎」并改成 `| null`,
1782
+ * 被 `tsc` 当场按住(`normalizeGate` 的返回形不匹配)——**归一化点在资源层,不在类型层**。
1783
+ *
1784
+ * ⚠️ 顺带纠正一处外部审计的误读(黑板 [1640] → [1690]):`AssistantGate.kind` 与
1785
+ * `CheckpointSummary.gateKind` **不是「同概念两个名字」的不一致** —— core 的 `CheckpointGate` 是
1786
+ * **判别联合**、作嵌套字段 `Checkpoint.gate` 用,`kind` 是它的判别符;`CheckpointSummary.gateKind`
1787
+ * 是它的**扁平化投影**,且在 core 侧按引用取类型(`CheckpointGate["kind"]`)⇒ 结构上不可能漂。这里的
1788
+ * `kind` 承接的正是那个扁平投影的值,名字随「嵌套用 kind / 扁平用 gateKind」的投影约定,是刻意的。 */
1733
1789
  export interface AssistantGate {
1734
- /** 同 gateKind 开集。 */
1735
- kind: string;
1736
- /** wire 可能回 null, 容忍。 */
1790
+ /** 与 {@link CheckpointSummary.gateKind} 同值域。**开集**写法(不写死 6 臂):core 未来新增闸门种类时
1791
+ * 消费者不会因为闭合联合而编译失败,同时已知 6 臂仍有编辑器补全(同 {@link Scenario} 等既有开集先例)。
1792
+ * 收紧自裸 `string`(2026-07-25)——裸 string 既没补全、也没记下已知值域。 */
1793
+ kind: "human" | "irreversible_ask" | "resource_limit" | "needs_review" | "plan_review" | "task_done" | (string & {});
1794
+ /** 风险层级(1..5)。缺席 = 该闸门种类不携带 RiskDescriptor(resource_limit/needs_review/plan_review),
1795
+ * 或 wire 回了 null 而资源层已折成省略 —— 两种都表现为 `undefined`,消费者按"未知"处理即可。 */
1737
1796
  severity?: number;
1797
+ /** 挂起链上的累计花费(micro-USD)。⚠️ 语义是「**已花掉**多少」,与 `costMicroUsd`(「这个东西花了多少」)
1798
+ * 不是同一个概念 —— 别把两者当成同一字段的两种叫法(同上 [1690] 的审计纠正)。 */
1738
1799
  spentMicroUsd?: number;
1739
- /** epoch ms; wire 可能回 null, 容忍。 */
1800
+ /** 等待人工的 SLA 截止 —— **epoch ms**(checkpoint 族的时间约定;run-ledger 族用 ISO 串,见
1801
+ * {@link AssistantTask} 的接缝说明)。 */
1740
1802
  deadline?: number;
1741
1803
  }
1742
1804
  /** §3 N-task 调度总览行 = run-store listRuns(owner) join 核心 scheduler seam listByScope。