@sema-agent/sdk 15.4.0 → 16.0.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/README.md +57 -0
- package/dist/errors.d.ts +25 -0
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +33 -0
- package/dist/errors.js.map +1 -1
- package/dist/events.d.ts +14 -2
- package/dist/events.d.ts.map +1 -1
- package/dist/events.js.map +1 -1
- package/dist/index.d.ts +5 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -1
- package/dist/index.js.map +1 -1
- package/dist/resources/runs.d.ts +9 -1
- package/dist/resources/runs.d.ts.map +1 -1
- package/dist/resources/runs.js +9 -1
- package/dist/resources/runs.js.map +1 -1
- package/dist/resources/sessions.d.ts +15 -2
- package/dist/resources/sessions.d.ts.map +1 -1
- package/dist/resources/sessions.js +15 -2
- package/dist/resources/sessions.js.map +1 -1
- package/dist/types.d.ts +111 -9
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js.map +1 -1
- package/openapi.yaml +278 -23
- package/package.json +1 -1
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;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/resources/runs.d.ts
CHANGED
|
@@ -176,7 +176,10 @@ export declare class RunsResource {
|
|
|
176
176
|
* [868] 起直接就地取消 suspended/needs_review 跑,不再让调用方转去 deny). 404 = non-owner/unknown (no
|
|
177
177
|
* existence leak). Server-side idempotent; not a submit → no SDK retry.
|
|
178
178
|
* server ≥7.112.0 (S-947):取消动词铸出的取消终局还带 `result.abortCause: "cancel_verb"`(读 {@link RunRecord} 的 `result`,即 `get()` / `events()` 的 `done` 行;`errorCode:"cancelled"` 不变)——
|
|
179
|
-
* 词表与在场闸见 {@link import("../types.js").TaskResult.abortCause}。
|
|
179
|
+
* 词表与在场闸见 {@link import("../types.js").TaskResult.abortCause}。
|
|
180
|
+
* server ≥7.73.0 的**每一个 2xx 受理体**还带 `cancelRequested`(K-43;sdk 16.0.0 补型,{@link CancelAck.cancelRequested}):`cancelling` 那一支 `true`(耐久取消旗刚挂上),
|
|
181
|
+
* 幂等 no-op / park 臂终局支 `false`;它与 {@link RunRecord} 上的 `heldBy` / `cancelRequested` 是同一个谓词的两面 —— **`get()` 上看到 `cancelRequested` 翻回 `false` 不等于取消完成**
|
|
182
|
+
* (续跑认领也会清旗),等终态 `status` + `errorCode:"cancelled"`。同一取消终局的现场快照见 {@link import("../types.js").TaskResult.cancelContext}。 */
|
|
180
183
|
cancel(taskId: string, opts?: {
|
|
181
184
|
session?: string;
|
|
182
185
|
signal?: AbortSignal;
|
|
@@ -298,6 +301,11 @@ export declare class RunsResource {
|
|
|
298
301
|
* 200 retried with the same key injects TWICE with byte-identical receipts — on those versions treat a
|
|
299
302
|
* lost 200 as "outcome unknown" (re-read the run), never as "safe to retry".
|
|
300
303
|
*
|
|
304
|
+
* 🔴 **`messageId` ≡ `human_input.inputId`(server ≥7.113.0;wire 值变更、无新键)**:**live 腿**(`delivery:"applied"`)server **恒**把回执的 `messageId` 作 `inputId` 递给引擎 ——
|
|
305
|
+
* **不带 `Idempotency-Key` 也递**(≤7.112.0 只在带 key 时递,keyless live steer 的 `human_input` 帧上是引擎自铸的 uuid、与回执 / 用户输入受理账本对不上)。于是 live steer 的
|
|
306
|
+
* 回执、它的 `human_input{inputId}` 帧、受理账本行(`SessionRecord.userInputUndrained[].messageId`)**同值可 join**。park 腿:带 key ⇒ 同值(`idem-…`);
|
|
307
|
+
* 🚧 **不带 key 的 park 腿是契约 §19 成文的例外**(server 不随停放条目递 `inputId`,回执 `messageId` 与那条日后重放出的 `human_input.inputId` **对不上**)—— 别在 keyless park 上做 join。
|
|
308
|
+
*
|
|
301
309
|
* 🔴 ONE narrow caveat (and it is a FIELD-level caveat, not "steer is a draft"): the per-call `mode` arg is
|
|
302
310
|
* currently a NO-OP — core's steer is HARNESS-LEVEL (`setSteeringMode`), set globally on the runner, not
|
|
303
311
|
* switched per steer call; the `mode` mapping is pending D-A core (search [76]). Sending `mode` is harmless
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/resources/runs.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/resources/runs.ts"],"names":[],"mappings":"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"}
|
package/dist/resources/runs.js
CHANGED
|
@@ -61,7 +61,10 @@ export class RunsResource {
|
|
|
61
61
|
* [868] 起直接就地取消 suspended/needs_review 跑,不再让调用方转去 deny). 404 = non-owner/unknown (no
|
|
62
62
|
* existence leak). Server-side idempotent; not a submit → no SDK retry.
|
|
63
63
|
* server ≥7.112.0 (S-947):取消动词铸出的取消终局还带 `result.abortCause: "cancel_verb"`(读 {@link RunRecord} 的 `result`,即 `get()` / `events()` 的 `done` 行;`errorCode:"cancelled"` 不变)——
|
|
64
|
-
* 词表与在场闸见 {@link import("../types.js").TaskResult.abortCause}。
|
|
64
|
+
* 词表与在场闸见 {@link import("../types.js").TaskResult.abortCause}。
|
|
65
|
+
* server ≥7.73.0 的**每一个 2xx 受理体**还带 `cancelRequested`(K-43;sdk 16.0.0 补型,{@link CancelAck.cancelRequested}):`cancelling` 那一支 `true`(耐久取消旗刚挂上),
|
|
66
|
+
* 幂等 no-op / park 臂终局支 `false`;它与 {@link RunRecord} 上的 `heldBy` / `cancelRequested` 是同一个谓词的两面 —— **`get()` 上看到 `cancelRequested` 翻回 `false` 不等于取消完成**
|
|
67
|
+
* (续跑认领也会清旗),等终态 `status` + `errorCode:"cancelled"`。同一取消终局的现场快照见 {@link import("../types.js").TaskResult.cancelContext}。 */
|
|
65
68
|
async cancel(taskId, opts) {
|
|
66
69
|
return this.t.request({
|
|
67
70
|
method: "POST",
|
|
@@ -200,6 +203,11 @@ export class RunsResource {
|
|
|
200
203
|
* 200 retried with the same key injects TWICE with byte-identical receipts — on those versions treat a
|
|
201
204
|
* lost 200 as "outcome unknown" (re-read the run), never as "safe to retry".
|
|
202
205
|
*
|
|
206
|
+
* 🔴 **`messageId` ≡ `human_input.inputId`(server ≥7.113.0;wire 值变更、无新键)**:**live 腿**(`delivery:"applied"`)server **恒**把回执的 `messageId` 作 `inputId` 递给引擎 ——
|
|
207
|
+
* **不带 `Idempotency-Key` 也递**(≤7.112.0 只在带 key 时递,keyless live steer 的 `human_input` 帧上是引擎自铸的 uuid、与回执 / 用户输入受理账本对不上)。于是 live steer 的
|
|
208
|
+
* 回执、它的 `human_input{inputId}` 帧、受理账本行(`SessionRecord.userInputUndrained[].messageId`)**同值可 join**。park 腿:带 key ⇒ 同值(`idem-…`);
|
|
209
|
+
* 🚧 **不带 key 的 park 腿是契约 §19 成文的例外**(server 不随停放条目递 `inputId`,回执 `messageId` 与那条日后重放出的 `human_input.inputId` **对不上**)—— 别在 keyless park 上做 join。
|
|
210
|
+
*
|
|
203
211
|
* 🔴 ONE narrow caveat (and it is a FIELD-level caveat, not "steer is a draft"): the per-call `mode` arg is
|
|
204
212
|
* currently a NO-OP — core's steer is HARNESS-LEVEL (`setSteeringMode`), set globally on the runner, not
|
|
205
213
|
* switched per steer call; the `mode` mapping is pending D-A core (search [76]). Sending `mode` is harmless
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../src/resources/runs.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAUpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,8BAA8B,EAAE,gCAAgC,CAAU,CAAC;AAuHtH,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAE7C;;;;;uGAKmG;IAC3F,SAAS,CAAC,OAAgB;QAChC,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAgB,EAAE,IAA+D;QAC5F,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAa;YAChC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,IAAI;YACZ,cAAc,EAAE,IAAI,EAAE,cAAc;YACpC,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,IAAiD;QACzE,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAY;YAC/B,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,YAAY,kBAAkB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE;YAC9E,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED
|
|
1
|
+
{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../src/resources/runs.ts"],"names":[],"mappings":"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"}
|
|
@@ -132,13 +132,21 @@ export declare class SessionsResource {
|
|
|
132
132
|
* current model context and can be LARGE — lazy-expand in UIs, or pass window params
|
|
133
133
|
* (`tail`/`before`+`limit`/`blobCap`, server ≥1.162 — see SessionGetParams) to pull a slice:
|
|
134
134
|
* the windowed response adds `window {offset,total}` (absent on an old engine = honest
|
|
135
|
-
* degradation probe). No params ⇒ legacy full read, byte-identical to before.
|
|
135
|
+
* degradation probe). No params ⇒ legacy full read, byte-identical to before.
|
|
136
|
+
* 🔴 **非属主 404 的拼法(server ≥7.113.0 / S-989,wire 值变更、无新键)**:未知会话与他人会话**逐字节同串** —— 都是 404 `not_found.session` + `session not found`
|
|
137
|
+
* (SDK ⇒ `NotFoundError`,两臂同类同码同文)。≤7.112.0 的非属主臂答的是 **run 拼法**(`not_found.run` + run 长文)而不存在臂已是 `not_found.session` ——
|
|
138
|
+
* 单端点内两臂码与串不同本身就是存在性 oracle。⇒ 按类(`instanceof NotFoundError`)判「读不到」,**别按码把「没有这个会话」与「不是你的」分成两臂**
|
|
139
|
+
* (server 刻意不给这个区分);读 `not_found.run` 判「会话读被拒」的旧端改读 `not_found.session`。run 面 `/v1/runs/:id` 不变(仍 `not_found.run`)。 */
|
|
136
140
|
get(sessionId: string, opts?: SessionGetParams & {
|
|
137
141
|
signal?: AbortSignal;
|
|
138
142
|
}): Promise<SessionRecord>;
|
|
139
143
|
/** GET /v1/sessions/:id/head — 会话追随轻探针(server ≥1.225,[1075]②):`{ sessionId, leafId }` +
|
|
140
144
|
* ETag(=leafId)。leafId 每次 append 都变=版本号——空闲期轮询判增量;传 `etag`(上次值)命中即
|
|
141
|
-
* `changed:false` 零 body(HTTP 304)。501=无 durable session store。
|
|
145
|
+
* `changed:false` 零 body(HTTP 304)。501=无 durable session store。
|
|
146
|
+
* 🔴 **非属主 404 的拼法(server ≥7.113.0 / S-989,wire 值变更、无新键)**:未知会话与他人会话**逐字节同串** —— 都是 404 `not_found.session` + `session not found`
|
|
147
|
+
* (SDK ⇒ `NotFoundError`,两臂同类同码同文)。≤7.112.0 的非属主臂答的是 **run 拼法**(`not_found.run` + run 长文)而不存在臂已是 `not_found.session` ——
|
|
148
|
+
* 单端点内两臂码与串不同本身就是存在性 oracle。⇒ 按类(`instanceof NotFoundError`)判「读不到」,**别按码把「没有这个会话」与「不是你的」分成两臂**
|
|
149
|
+
* (server 刻意不给这个区分);读 `not_found.run` 判「会话读被拒」的旧端改读 `not_found.session`。run 面 `/v1/runs/:id` 不变(仍 `not_found.run`)。 */
|
|
142
150
|
head(sessionId: string, opts?: {
|
|
143
151
|
etag?: string;
|
|
144
152
|
signal?: AbortSignal;
|
|
@@ -162,6 +170,11 @@ export declare class SessionsResource {
|
|
|
162
170
|
* (304 同义);断线自动重连并以最近水位续(重复帧被服务端抑制)。
|
|
163
171
|
* 探测位 `capabilities.sessionEvents`(与本路由 501 同谓词)—— 别 trial-by-501。
|
|
164
172
|
* 会话被删/换主时 server 主动断流,重连将 404 → 迭代器抛出。
|
|
173
|
+
*
|
|
174
|
+
* 🔴 **非属主 404 的拼法(server ≥7.113.0 / S-989,wire 值变更、无新键)**:未知会话与他人会话**逐字节同串** —— 都是 404 `not_found.session` + `session not found`
|
|
175
|
+
* (SDK ⇒ `NotFoundError`,两臂同类同码同文)。≤7.112.0 的非属主臂答的是 **run 拼法**(`not_found.run` + run 长文)而不存在臂已是 `not_found.session` ——
|
|
176
|
+
* 单端点内两臂码与串不同本身就是存在性 oracle。⇒ 按类(`instanceof NotFoundError`)判「读不到」,**别按码把「没有这个会话」与「不是你的」分成两臂**
|
|
177
|
+
* (server 刻意不给这个区分);读 `not_found.run` 判「会话读被拒」的旧端改读 `not_found.session`。run 面 `/v1/runs/:id` 不变(仍 `not_found.run`)。
|
|
165
178
|
*
|
|
166
179
|
* 🔴 **503 有四个不同的机器码,回退方式不同**(server 在 `routes/sessions.ts:234-236` 专门解释了为什么
|
|
167
180
|
* 必须带码:它与 drain 的 503 走同一条流,没有码消费端只能靠自由文本区分)。别对 503 统一回退:
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/resources/sessions.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/resources/sessions.ts"],"names":[],"mappings":"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"}
|
|
@@ -27,7 +27,11 @@ export class SessionsResource {
|
|
|
27
27
|
* current model context and can be LARGE — lazy-expand in UIs, or pass window params
|
|
28
28
|
* (`tail`/`before`+`limit`/`blobCap`, server ≥1.162 — see SessionGetParams) to pull a slice:
|
|
29
29
|
* the windowed response adds `window {offset,total}` (absent on an old engine = honest
|
|
30
|
-
* degradation probe). No params ⇒ legacy full read, byte-identical to before.
|
|
30
|
+
* degradation probe). No params ⇒ legacy full read, byte-identical to before.
|
|
31
|
+
* 🔴 **非属主 404 的拼法(server ≥7.113.0 / S-989,wire 值变更、无新键)**:未知会话与他人会话**逐字节同串** —— 都是 404 `not_found.session` + `session not found`
|
|
32
|
+
* (SDK ⇒ `NotFoundError`,两臂同类同码同文)。≤7.112.0 的非属主臂答的是 **run 拼法**(`not_found.run` + run 长文)而不存在臂已是 `not_found.session` ——
|
|
33
|
+
* 单端点内两臂码与串不同本身就是存在性 oracle。⇒ 按类(`instanceof NotFoundError`)判「读不到」,**别按码把「没有这个会话」与「不是你的」分成两臂**
|
|
34
|
+
* (server 刻意不给这个区分);读 `not_found.run` 判「会话读被拒」的旧端改读 `not_found.session`。run 面 `/v1/runs/:id` 不变(仍 `not_found.run`)。 */
|
|
31
35
|
async get(sessionId, opts) {
|
|
32
36
|
return this.t.request({
|
|
33
37
|
method: "GET",
|
|
@@ -37,7 +41,11 @@ export class SessionsResource {
|
|
|
37
41
|
}
|
|
38
42
|
/** GET /v1/sessions/:id/head — 会话追随轻探针(server ≥1.225,[1075]②):`{ sessionId, leafId }` +
|
|
39
43
|
* ETag(=leafId)。leafId 每次 append 都变=版本号——空闲期轮询判增量;传 `etag`(上次值)命中即
|
|
40
|
-
* `changed:false` 零 body(HTTP 304)。501=无 durable session store。
|
|
44
|
+
* `changed:false` 零 body(HTTP 304)。501=无 durable session store。
|
|
45
|
+
* 🔴 **非属主 404 的拼法(server ≥7.113.0 / S-989,wire 值变更、无新键)**:未知会话与他人会话**逐字节同串** —— 都是 404 `not_found.session` + `session not found`
|
|
46
|
+
* (SDK ⇒ `NotFoundError`,两臂同类同码同文)。≤7.112.0 的非属主臂答的是 **run 拼法**(`not_found.run` + run 长文)而不存在臂已是 `not_found.session` ——
|
|
47
|
+
* 单端点内两臂码与串不同本身就是存在性 oracle。⇒ 按类(`instanceof NotFoundError`)判「读不到」,**别按码把「没有这个会话」与「不是你的」分成两臂**
|
|
48
|
+
* (server 刻意不给这个区分);读 `not_found.run` 判「会话读被拒」的旧端改读 `not_found.session`。run 面 `/v1/runs/:id` 不变(仍 `not_found.run`)。 */
|
|
41
49
|
async head(sessionId, opts) {
|
|
42
50
|
const res = await this.t.openRaw({
|
|
43
51
|
method: "GET",
|
|
@@ -71,6 +79,11 @@ export class SessionsResource {
|
|
|
71
79
|
* (304 同义);断线自动重连并以最近水位续(重复帧被服务端抑制)。
|
|
72
80
|
* 探测位 `capabilities.sessionEvents`(与本路由 501 同谓词)—— 别 trial-by-501。
|
|
73
81
|
* 会话被删/换主时 server 主动断流,重连将 404 → 迭代器抛出。
|
|
82
|
+
*
|
|
83
|
+
* 🔴 **非属主 404 的拼法(server ≥7.113.0 / S-989,wire 值变更、无新键)**:未知会话与他人会话**逐字节同串** —— 都是 404 `not_found.session` + `session not found`
|
|
84
|
+
* (SDK ⇒ `NotFoundError`,两臂同类同码同文)。≤7.112.0 的非属主臂答的是 **run 拼法**(`not_found.run` + run 长文)而不存在臂已是 `not_found.session` ——
|
|
85
|
+
* 单端点内两臂码与串不同本身就是存在性 oracle。⇒ 按类(`instanceof NotFoundError`)判「读不到」,**别按码把「没有这个会话」与「不是你的」分成两臂**
|
|
86
|
+
* (server 刻意不给这个区分);读 `not_found.run` 判「会话读被拒」的旧端改读 `not_found.session`。run 面 `/v1/runs/:id` 不变(仍 `not_found.run`)。
|
|
74
87
|
*
|
|
75
88
|
* 🔴 **503 有四个不同的机器码,回退方式不同**(server 在 `routes/sessions.ts:234-236` 专门解释了为什么
|
|
76
89
|
* 必须带码:它与 drain 的 503 走同一条流,没有码消费端只能靠自由文本区分)。别对 503 统一回退:
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/resources/sessions.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAgCxD,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAsG/E,SAAS,eAAe,CAAC,MAAyB;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,sBAAsB,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACpG,CAAC;IACD,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxB,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,OAAO,gBAAgB;IAME;IAL7B;;0EAEsE;IAC7D,IAAI,CAAsB;IAEnC,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IAED
|
|
1
|
+
{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/resources/sessions.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
CHANGED
|
@@ -817,16 +817,21 @@ export interface TaskRequest {
|
|
|
817
817
|
* at submit (sibling of {@link promptProfile}). */
|
|
818
818
|
toolMaterializeStrategy?: "static" | "swap";
|
|
819
819
|
/** server ≥1.254 — context attachments family (core design/133):literal-true opt-ins
|
|
820
|
-
* (todoReminder/
|
|
820
|
+
* (todoReminder/budgetUsd/backgroundTasks/toolsDelta/mcpInstructions;false=省键),
|
|
821
821
|
* `changedFiles` 可带 {maxFiles};`agentListing`/`skillsListing` 是 core DEFAULT-ON——**explicit false
|
|
822
|
-
* 才关**(1.254 起 false 真透传;更老 server 静默丢);`todoReminderMode` "baseline"|"off"。
|
|
822
|
+
* 才关**(1.254 起 false 真透传;更老 server 静默丢);`todoReminderMode` "baseline"|"off"。
|
|
823
|
+
*
|
|
824
|
+
* 🔴 **BREAKING(sdk 16.0.0 / K-44)—— `planModeReminder` 已退役,本型删它**(server ≥7.113.0 / core 7.39.0 #1254;零别名零双读):
|
|
825
|
+
* 引擎自此在 `permissionMode: "plan"` 的腿上**自己陈述** plan 姿态(首请求 / 周期提醒 / 退出帧),不再要这个开关。server ≥7.113.0 对提交体里带它的
|
|
826
|
+
* (**任何值,含 `false`** —— 门判 `!== undefined`,不判真假)一律 **400 `request.field_invalid`**(错误句点名退役与出路;此前是受理、引擎在 prepare 才拒);
|
|
827
|
+
* 存量停放体里带这个键的任务续跑时**丢键照跑**(resume 重放不拒)。**迁移 = 删键;要 plan 姿态发 `permissionMode: "plan"`**。
|
|
828
|
+
* 本型是内联对象型(无索引签名):对象字面量里写它直接 TS2353;经变量绕过去时本包原样透传、server 7.113.0 响亮 400。对 ≤7.112.x 的 server 它仍是真键,本包不再替人铺那条路。 */
|
|
823
829
|
attachments?: {
|
|
824
830
|
todoReminder?: true;
|
|
825
831
|
todoReminderMode?: "baseline" | "off";
|
|
826
832
|
changedFiles?: true | {
|
|
827
833
|
maxFiles?: number;
|
|
828
834
|
};
|
|
829
|
-
planModeReminder?: true;
|
|
830
835
|
budgetUsd?: true;
|
|
831
836
|
backgroundTasks?: true;
|
|
832
837
|
toolsDelta?: true;
|
|
@@ -1000,8 +1005,12 @@ export type TerminalCause = {
|
|
|
1000
1005
|
};
|
|
1001
1006
|
} | {
|
|
1002
1007
|
kind: "blocked";
|
|
1003
|
-
/**
|
|
1008
|
+
/** 这条 run 为什么没干活(治理判决不是失败)—— 两个来源,由 {@link detail} 分辨:无 `detail` = agent 自己 `ReportBlocked` 的话;
|
|
1009
|
+
* `detail.kind === "prompt_blocked_by_hook"` = 引擎对部署 `userPromptSubmit` hook 的那句陈述(按模型侧车道框成提醒,hook 自己的话在框里)。**别按这段散文分支**。 */
|
|
1004
1010
|
reason: string;
|
|
1011
|
+
/** server ≥7.113.0(core #1277;K-43 同类封闭对象补键):**谁**让这条 run 没干活 —— 提示**没有被提交**那一形的机读成因(见 {@link TerminalBlockedDetail})。
|
|
1012
|
+
* 在场 ⇔ 就是 hook 挡下提示;缺席 = agent 自己 `ReportBlocked`,或 server <7.113.0。 */
|
|
1013
|
+
detail?: TerminalBlockedDetail;
|
|
1005
1014
|
} | PausedCause;
|
|
1006
1015
|
/**
|
|
1007
1016
|
* 一次耐久暂停的因由(`TerminalCause` 的 paused 臂)—— 提交了 checkpoint,这条 run 可恢复。
|
|
@@ -1101,6 +1110,59 @@ export interface SyncSubmitResult extends TaskResult {
|
|
|
1101
1110
|
* 测试对已装 server 的真登记做四方相等(server 常量 / 登记 / spec enum / 本型的词)。读法与在场闸见 {@link TaskResult.abortCause}。
|
|
1102
1111
|
*/
|
|
1103
1112
|
export type AbortCause = "client_disconnected" | "ask_park_grace_exhausted" | "cancel_verb";
|
|
1113
|
+
/**
|
|
1114
|
+
* 取消现场快照里的**大脑相位**(server `RunBrainStatusSnapshot`,`turn-activity.ts` `pickRunBrainStatus` 投出的五键子集;K-43,sdk 16.0.0 具名)——
|
|
1115
|
+
* 「取消那一刻引擎正在重试第几次 / 在等什么 / 什么错类」。`phase` 是这只快照的存在理由(没有它就没有快照,不铸半只)。
|
|
1116
|
+
* 🔴 刻意**不含** `detail`(provider 自由文本)与 `retryInMs` / `retryInSec`(相对量,过期即失真);`retryAtMs` 是**发端进程钟域**的墙钟近似,别与本地单调计时器比。
|
|
1117
|
+
*/
|
|
1118
|
+
export interface CancelContextBrainStatus {
|
|
1119
|
+
phase: string;
|
|
1120
|
+
attempt?: number;
|
|
1121
|
+
maxRetries?: number;
|
|
1122
|
+
retryAtMs?: number;
|
|
1123
|
+
errClass?: string;
|
|
1124
|
+
}
|
|
1125
|
+
/**
|
|
1126
|
+
* **用户取消的现场快照**(`TaskResult.cancelContext`;server S-94 起〔7.57.0〕,契约 §5.3;K-43 —— sdk 16.0.0 具名,此前只能经 `TaskResult` 的开集索引读成 `unknown`)——
|
|
1127
|
+
* 回答「server 这一侧多久没收到这条 run 的动静了」。**分诊材料,不是状态机输入**。四键全可选,缺席都诚实:
|
|
1128
|
+
* · `lastEventKind` / `lastEventAgeMs` —— 数据源是**同副本进程内**的活性登记;跨副本取消 / 副本重启后读不到 ⇒ 缺席 = 「本副本证不出」,**绝不折成 `0`**
|
|
1129
|
+
* (那会把「挂死 8 分钟」渲成「刚还活着」,方向正好相反)。🔴 `lastEventKind` **比** `lastEventAgeMs` 更容易缺席(有几席打点方只推进时刻、带不出词),
|
|
1130
|
+
* 所以「有 age 无 kind」是合法读数 = 「知道那一刻,说不出那是条什么事件」;
|
|
1131
|
+
* · `lastBrainStatus` —— 这条 run 从没出过 `status` 帧 / 本副本读不到 ⇒ 缺席(恒不铸 `null`);sticky:之后的 text / tool 事件不清它;
|
|
1132
|
+
* · `elapsedMs` —— run 起跑到本次取消的墙钟毫秒;常态在场,行的 `createdAt` 坏到解析不出时缺席(同样不折 0)。
|
|
1133
|
+
* 🔴 **它不是模型调用相位**:server 结构上看不见「首字节等了多久 / 重试了几次」(那半场在引擎流层);`lastEventAgeMs` 也**不是**「模型挂了这么久」(一次长工具调用同样不产账本事件)。
|
|
1134
|
+
* 一键都证不出 ⇒ **整只缺席**(不铸空对象:「缺席」读作「没有取消现场可看」,**不是**「取消时没有异常」)。与 {@link AbortCause} 同住、同一只铸点、同一条在场闸:
|
|
1135
|
+
* `abortCause` 说**谁**让它停的,本对象说那一刻 server 看见了什么。
|
|
1136
|
+
*/
|
|
1137
|
+
export interface CancelContext {
|
|
1138
|
+
lastEventKind?: string;
|
|
1139
|
+
lastEventAgeMs?: number;
|
|
1140
|
+
lastBrainStatus?: CancelContextBrainStatus;
|
|
1141
|
+
elapsedMs?: number;
|
|
1142
|
+
}
|
|
1143
|
+
/**
|
|
1144
|
+
* `prompt_blocked_by_hook` 的成因闭集四词(core `PROMPT_BLOCK_CAUSES`;server ≥7.113.0 / core #1277)—— 部署的 `userPromptSubmit` hook 座把提示挡在提交之外的四种收场:
|
|
1145
|
+
* · `"block"` —— hook 答了、拒了(它自己的话在 {@link TerminalBlockedDetail.hookReason});
|
|
1146
|
+
* · `"crashed"` —— hook 抛了 / 拒了承诺;这一座 fail-closed,没筛成的屏不算放行;
|
|
1147
|
+
* · `"timeout"` —— hook 在自己的 `timeoutMs` 内没答;同样 fail-closed;
|
|
1148
|
+
* · `"cancelled"` —— 任务在 hook 还在筛的时候被取消了。
|
|
1149
|
+
* **闭集**,按 additive 规矩只会加词(加词 = core 新版本 + 本包下一版形变,spec 具名 schema `TerminalBlockedDetail` 的 enum 同批);认不得的词读作「hook 座挡下了提示,成因不认识」。
|
|
1150
|
+
* 属主是 core 包根 `PROMPT_BLOCK_CAUSES`;测试对已装 core 的真常量做四方相等(core / spec enum / 本型的词 / server 处置表)。
|
|
1151
|
+
*/
|
|
1152
|
+
export type PromptBlockCause = "block" | "crashed" | "timeout" | "cancelled";
|
|
1153
|
+
/**
|
|
1154
|
+
* `terminal.kind:"blocked"` 的机读成因(`TerminalCause` blocked 臂的 `detail`;server ≥7.113.0 / core #1277)。`kind` 闭集、今天一个成员。
|
|
1155
|
+
* 它回答的是**谁**让这条 run 没干活:提示**没有被提交**(目标没成消息、循环没起)—— 改了提示再发才有意义;`cause` 说是 hook 的哪种收场。
|
|
1156
|
+
* **在场 ⇔ 就是这一形**;缺席 = agent 自己 `ReportBlocked`(「我继续不了」),或 server <7.113.0 —— **按 `detail?.kind` 分支,别按 `reason` 的散文**。
|
|
1157
|
+
* 同一只对象四面同形(同步 200 体 / 流 `done.result` / `GET /v1/runs/:id` 的 `result` / 账本 `done` 行)。
|
|
1158
|
+
*/
|
|
1159
|
+
export interface TerminalBlockedDetail {
|
|
1160
|
+
kind: "prompt_blocked_by_hook";
|
|
1161
|
+
cause: PromptBlockCause;
|
|
1162
|
+
/** hook **自己**拒绝提示的话:折成一行、有界、引擎的信封标签已拆;**只在 `cause:"block"` 且 hook 给了话时在场**。仍是 hook 的文本 ⇒ 渲染时按**不可信**处理;
|
|
1163
|
+
* 与 `reason` 过同一只脱敏。从不带引擎的提醒框与会话标记(那一句是 `reason`)。 */
|
|
1164
|
+
hookReason?: string;
|
|
1165
|
+
}
|
|
1104
1166
|
/** Synchronous task result (`POST /v1/tasks`). */
|
|
1105
1167
|
export interface TaskResult {
|
|
1106
1168
|
taskId: string;
|
|
@@ -1170,6 +1232,11 @@ export interface TaskResult {
|
|
|
1170
1232
|
atTurn: number;
|
|
1171
1233
|
};
|
|
1172
1234
|
structuredOutput?: unknown;
|
|
1235
|
+
/** server ≥7.57.0(S-94;契约 §5.3;K-43 —— sdk 16.0.0 具名,此前只能经本型的开集索引读成 `unknown`)—— **用户取消的现场快照**,终局结果上的侧记键,与 `abortCause` 并列
|
|
1236
|
+
* (同一只铸点 `mintCancelledResult`、同一条「只补空座」在场闸;都**不**进 `terminal`)。**只在 server 铸的取消终局上在场**;模型自己失败 / 正常完成 ⇒ 缺席;
|
|
1237
|
+
* 四键一键都证不出 ⇒ 整只缺席(**不铸空对象**:缺席读作「没有取消现场可看」,不是「取消时没有异常」)。四键读法与缺席纪律见 {@link CancelContext}。
|
|
1238
|
+
* 落点同 {@link abortCause} 列的取消终局落点(`GET /v1/runs/:id` → `result.cancelContext` 是它最常被读的一处)。 */
|
|
1239
|
+
cancelContext?: CancelContext;
|
|
1173
1240
|
/** server ≥7.112.0(S-947;契约 §5.0d;cli L-212;**additive**)—— server 发起的中止的**机读成因**,终局结果上的侧记键,与 `cancelContext` 并列
|
|
1174
1241
|
* (**不**进 `terminal`:那是引擎的因由,同一个对象不该有两个铸者)。**在场 ⇔ 这条终局就是 server 那次中止铸出来的取消终局**
|
|
1175
1242
|
* (`terminal.kind:"failed"` + `terminal.code:"cancelled"`);本服务 ≥7.112.0 铸的取消终局恒带(铸点的成因是必填参数,引擎从不自铸 `cancelled`)。
|
|
@@ -2037,6 +2104,19 @@ export interface RunRecord {
|
|
|
2037
2104
|
* 字段 OMIT(不是伪造空对象)。此前误放进 `TaskStats`(嵌套,永远读不到)且误标量成 number(真实是
|
|
2038
2105
|
* `{llm,infra,totalMicroUsd}` 富对象)——两处都改。 */
|
|
2039
2106
|
supervisorCost?: SupervisorCostBreakdown;
|
|
2107
|
+
/** 🔴 K-43(sdk 16.0.0 补型;**server ≥7.73.0 / S-230 P-45 起就在真 `GET /v1/runs/:id` 上**,契约 §5.5 (c),封闭 spec 一直没声明 —— K-41 同病)——
|
|
2108
|
+
* **此刻持有**这条 run 的副本(行的 `instance_id`:`createRun` 写、跨副本续跑的 `markResuming` **接管**),答的是「活腿现在在哪」,不是「谁建的行」。
|
|
2109
|
+
* server ≥7.73.0 上**恒在场**,**显式 `null`**(不是键缺席)= 没有副本持有;< 7.73.0 缺席。
|
|
2110
|
+
* 🔴 契约:`heldBy` 变 `null` **或** run 进终态 = 这条 claim 已释放(两者任一);终态行上的 `heldBy` 读作「哪个副本跑完的」这一历史事实,不是「还占着」。
|
|
2111
|
+
* ⚠️ 唯一例外是 **stale 折叠**:`running` 且超过 stale 窗的行,读面把 `status` 折成 `failed`(伴 `error: "run stalled (instance lost?)"`)—— 那是读面的判断,
|
|
2112
|
+
* 盘上的行仍是 `running`、claim 要到 reaper 下一拍才释放,`heldBy` 照旧逐字给出那台**失联**副本的 id(排障时唯一有用的坐标)。
|
|
2113
|
+
* 部署内的副本标识,**不是**用户可读的位置。 */
|
|
2114
|
+
heldBy?: string | null;
|
|
2115
|
+
/** 🔴 K-43(同上,server ≥7.73.0 / S-230 P-45 起恒在场,契约 §5.5 (c))—— **耐久取消旗**(跨副本;持有副本的心跳拍 poll 它)。
|
|
2116
|
+
* ⚠️ 它是**待生效**的取消:已经取消掉的 run 由 `status` + `errorCode:"cancelled"` 说(park 臂的取消**根本不经这面旗**,直接把行终局化);
|
|
2117
|
+
* 续跑认领会把旗清零(撞上 suspend 的取消不许在恢复之后再杀一遍)。⇒ **别**把 `cancelRequested` 翻回 `false` 读成「取消完成」—— 等终态 `status` + `errorCode:"cancelled"`。
|
|
2118
|
+
* `POST /v1/runs/:id/cancel` 的受理体带同一个键({@link CancelAck.cancelRequested},同一个谓词)。< 7.73.0 缺席。 */
|
|
2119
|
+
cancelRequested?: boolean;
|
|
2040
2120
|
}
|
|
2041
2121
|
/** Run list item (`GET /v1/tasks` items) — the live cheap `runSummary` shape (service Drift 1).
|
|
2042
2122
|
* NOTE wire names: `id` (not taskId), `startedAt` (not createdAt), `costMicroUsd` (micro-USD); no sessionId. */
|
|
@@ -2280,7 +2360,7 @@ export type DeniedBy = "policy" | "hook" | "org" | "persisted_rule" | "classifie
|
|
|
2280
2360
|
*/
|
|
2281
2361
|
export type PermissionMode = "default" | "acceptEdits" | "plan" | "auto" | "bypassPermissions" | "dontAsk";
|
|
2282
2362
|
/**
|
|
2283
|
-
* 一只问**属于哪一类**(core 7.34.0 `
|
|
2363
|
+
* 一只问**属于哪一类**(core `ASK_CLASSES`:7.34.0 铸二十词,core 7.39.0 起 `shell_floor` 入册 ⇒ 二十一词;模式 × 类仲裁表的列)。K-32 扩项 / server ≥7.106.0 起出现在
|
|
2284
2364
|
* {@link ModeRelease.askClass} / `.classes` 与 deny 臂的 `askClass` / `classes` 上,以及通告 `permission.ask_released_by_mode` 的 detail 里;
|
|
2285
2365
|
* K-37 扩项 / server ≥7.109.0(S-934 ②)起也在审批面:活卡帧 / 卡面 / 运维队列行 / `/stream` `pending` 帧的 `askClass` / `classes`
|
|
2286
2366
|
* (同样经 core `isAskClass` 筛,读不出整对不投;见 {@link import("./resources/tool-approvals.js").ToolApprovalFrame.askClass})。
|
|
@@ -2289,7 +2369,10 @@ export type PermissionMode = "default" | "acceptEdits" | "plan" | "auto" | "bypa
|
|
|
2289
2369
|
* `artifact_shared_read` / `mode` / `ordinary`);其余(`operator_forced` 部署出身、`ask_rule` / `org_rule`、`hook`、`ancestor`、`content_question`、
|
|
2290
2370
|
* `unverifiable_delete`、`governance_unavailable`、`policy_rra` …)任何模式下都照问。
|
|
2291
2371
|
*/
|
|
2292
|
-
export type AskClass = "content_question" | "hook" | "ancestor" | "unverifiable_delete" | "transcript_write" | "org_rule" | "governance_unavailable" | "rule_unreadable" | "ask_rule" | "denial_limit_fallback" | "operator_forced"
|
|
2372
|
+
export type AskClass = "content_question" | "hook" | "ancestor" | "unverifiable_delete" | "transcript_write" | "org_rule" | "governance_unavailable" | "rule_unreadable" | "ask_rule" | "denial_limit_fallback" | "operator_forced"
|
|
2373
|
+
/** core 7.39.0(#1260;server ≥7.113.0 提货):运维旋钮 `shellGate: "always"` 在**跑 shell 的席位**上的地板 —— `operator_always` 授权词所披露的那一问,
|
|
2374
|
+
* 自己成一类,免得持有另一种强制问的类集把它藏掉。与 `operator_forced` 同样**免疫 bypass**(不在 `bypassPermissions` 可放的九类里)。 */
|
|
2375
|
+
| "shell_floor" | "write_protection_unresolved" | "probe" | "write_protection" | "tool_marks_mcp" | "tool_marks_a2a" | "policy_rra" | "artifact_shared_read" | "mode" | "ordinary";
|
|
2293
2376
|
/**
|
|
2294
2377
|
* 一个权限**模式放行**了一只本该问人的 ask 的记录(K-32 扩项;server ≥7.106.0 / core 7.34.0 `ModeRelease`,键集逐键同 core
|
|
2295
2378
|
* `dist/core/gate-outcome.d.ts`)—— 只挂在 `allowed` 臂上({@link GateDisposition}):这一次**没有问任何人**,是模式放的。
|
|
@@ -2403,6 +2486,19 @@ export type Settlement = {
|
|
|
2403
2486
|
when: number;
|
|
2404
2487
|
/** 拒批人附的那句话。**没有 note 的拒 = 一句干脆的「不」**,不是「没说理由的 bug」。 */
|
|
2405
2488
|
note?: string;
|
|
2489
|
+
} | {
|
|
2490
|
+
/** 🔴 **policy 一方**(core 7.39.0 / server ≥7.113.0;sdk 16.0.0 补型 —— 查漏轮逼出,不在 7.113.0 发车帖七件里):**这台部署自己的策略**做了决定 —— 审批通道报告「答这一问的是机器、不是人」。
|
|
2491
|
+
* 人与策略是两类**决策者**:各自可答可拒,只在记录点名谁的决定上不同(`human_*` 点名人,`policy_*` 点名策略)。
|
|
2492
|
+
* server 7.113.0 的**值变更**(MIGRATION「审计面」):无人值守腿(leader worker / 修复腿 / `sema` CLI 及其续跑)上**机器按类放行**的那一问,结算从 `human_allowed` + `who.party:"person"`
|
|
2493
|
+
* 改为 **`policy_allowed` + `who.party:"policy"` + `who.approver:"unattended_class_answer"`**;一切**策略拒**(`UNATTENDED_APPROVAL_POLICY=deny`、run-local 无 TTY 的拒、`settledBy:"policy"` 的决裁)
|
|
2494
|
+
* 是 `policy_refused` + **`who.party:"policy"`**(此前是 `"none"`;下面 fail-closed 臂里那一形仍是 server 7.93.3 – 7.112.x 的真形,支持区间内保留)。按 party 词分桶的审计读者改读新词;
|
|
2495
|
+
* 7.112.x 的读面不认 party `policy`,读到 7.113.0 写下的这两种记录会把整条 `gate` 扣下。策略拒的话由引擎当**策略的话**送给模型,**不在**本记录上(没有 `note` 席)。 */
|
|
2496
|
+
kind: "policy_allowed" | "policy_refused";
|
|
2497
|
+
who: {
|
|
2498
|
+
party: "policy";
|
|
2499
|
+
approver?: string;
|
|
2500
|
+
};
|
|
2501
|
+
when: number;
|
|
2406
2502
|
} | {
|
|
2407
2503
|
/** 审批窗走完了没人答:引擎自己的审批工厂窗,或同步宿主 approver 报「我的窗到了」。 */
|
|
2408
2504
|
kind: "approval_window_expired";
|
|
@@ -2441,7 +2537,8 @@ export type Settlement = {
|
|
|
2441
2537
|
* 用户的指示,一条策略的「不行」是这次 run 的一项能力。与 `no_approver` 分家是因为审批通道**在**且
|
|
2442
2538
|
* 答了 —— 引擎没有回落到它自己的 headless 姿态。🔴 **本臂没有 `note` 席**:那一席属于两个 human 词
|
|
2443
2539
|
* 〔它的**缺席**在那两个词上是一条控制流事实〕;策略自己的话由引擎当**策略的话**上围栏送给模型)/
|
|
2444
|
-
* `task_aborted`(等待的中止信号结束了它)。
|
|
2540
|
+
* `task_aborted`(等待的中止信号结束了它)。
|
|
2541
|
+
* 🔴 **server ≥7.113.0(core 7.39.0)起策略拒写成 `who.party:"policy"`**(见上面的 policy 臂);本臂里 `policy_refused` + `none` 是 server 7.93.3 – 7.112.x 的老形,支持区间内保留。 */
|
|
2445
2542
|
kind: "no_approver" | "approver_unavailable" | "approver_error" | "approver_contract" | "presentation_failed" | "blanket_allow_refused" | "policy_refused" | "task_aborted";
|
|
2446
2543
|
who: {
|
|
2447
2544
|
party: "none";
|
|
@@ -2463,7 +2560,7 @@ export type Settlement = {
|
|
|
2463
2560
|
* · **I2** `deniedBy === "ask_resolution"` ⇒ `settlement` 在场且是拒绝类词;
|
|
2464
2561
|
* · **I3** `human_allowed` 结算旁边出现 `denied` 处置 ⇒ 那是**人批了之后的复查**否决,`deniedBy` 必是可否决层
|
|
2465
2562
|
* (`policy` / `hook` / `org` / `write_protection`),而 approver 留在结算上(这不是 approver 的拒);
|
|
2466
|
-
* · **I4** `allowed` 处置 ⇒ `settlement`
|
|
2563
|
+
* · **I4** `allowed` 处置 ⇒ `settlement` 缺席或恰是一只**决策者的放行词**(`human_allowed`,server ≥7.113.0 起还有 `policy_allowed`)。
|
|
2467
2564
|
*
|
|
2468
2565
|
* 🔴 **没有任何一项从缺席读出来**:普通放行是 `{ disposition: { kind: "allowed" } }`,直接策略拒是
|
|
2469
2566
|
* `{ disposition: { kind: "denied", deniedBy: "policy" } }`,两者都不带结算 —— 因为两者都没结算过什么。
|
|
@@ -4410,7 +4507,8 @@ export interface SessionRecord {
|
|
|
4410
4507
|
* in `messages`. */
|
|
4411
4508
|
promptEpoch?: PromptEpoch;
|
|
4412
4509
|
/** server ≥7.110.0(S-928 用户输入受理账本):这个会话里**崩溃丢掉**的用户输入 —— server 回了 200 `applied`(interrupt{text}:202)、
|
|
4413
|
-
* 承载它的 server 进程却在那条 run 收场前死了(
|
|
4510
|
+
* 承载它的 server 进程却在那条 run 收场前死了(**引擎在进程死前没来得及确认消费**;server ≥7.113.0 / core 7.39.0 #1273 起引擎确认消费过的受理结清成 `consumed`、
|
|
4511
|
+
* **不再**列在这里 —— 7.112.x 及以前「消费与否未知」的口径随之收窄;它**仍不**说「从未消费」,见 `engine_notice` `task.user_steer_undrained{cause:"crashed"}`)。
|
|
4414
4512
|
* 只列收敛行、同 (taskId, messageId) 一行、至多最新 500 条;`announced` = 已在哪条新 run 首拍告知过。server ≥7.111.0(S-966)起行里**含同步子代的 steer**
|
|
4415
4513
|
* (记在回执上那条 run 名下,`messageId` = 那张子代 steer 回执的 `messageId`,行形与 run steer 同 —— `kind` 仍只有 `"steer"`)。**缺席 = 这一次读没有可报的条目**
|
|
4416
4514
|
* (零条,或这一次账本读不出 —— 权威告知是 run 流上的通告帧,不是本键);`?message=` 单条形不带。 */
|
|
@@ -4929,6 +5027,10 @@ export interface CancelAck {
|
|
|
4929
5027
|
* (可为显式 `null`),而不是伪造一个 `cancelled`。
|
|
4930
5028
|
* 纯 `cancelling` 受理形(`:537`)与 no-op 分支则整个 OMIT 这个键(不是恒在场)。 */
|
|
4931
5029
|
errorCode?: string | null;
|
|
5030
|
+
/** 🔴 K-43(sdk 16.0.0 补型;**server ≥7.73.0 / S-230 P-45 起每一个 2xx 受理体都带它**,契约 §5.5 (c),封闭 spec 一直没声明)—— 与
|
|
5031
|
+
* {@link RunRecord.cancelRequested} **同一个谓词**(耐久取消旗):`status:"cancelling"` 那一支为 `true`(CAS 刚赢,旗在行上,持有副本下一拍读到);
|
|
5032
|
+
* park 臂的终局支为 `false`(park 的 run 被直接终局化,不需要旗);幂等 no-op 与并发终局化两支如实回**行上的旗值**(契约 §5.5 (c) 的账是 `false`)。< 7.73.0 缺席。 */
|
|
5033
|
+
cancelRequested?: boolean;
|
|
4932
5034
|
}
|
|
4933
5035
|
/** Leader run (`POST /v1/leader`) — the **v2 leader pipeline** (E2B workers + git push), gated server-side
|
|
4934
5036
|
* (`LEADER_ENABLED` + `REMOTE_EXEC=e2b`, both default OFF). Mode is a SERVER deploy flag, NOT a client choice:
|