@sema-agent/sdk 0.0.75 → 0.0.77

package/dist/resources/sessions.d.ts

@@ -1,6 +1,19 @@
+/** sessions — the "对话框" continuity is sessionId on TaskRequest; this resource is the AUDIT read + the
+ *  E16/E17/E21 lifecycle (list / fork / delete) + E6 per-session policy (permissionMode) + E9 MCP status panel.
+ *  All owner-scoped: a non-owner read/fork/delete/policy returns 404 (no existence oracle), parity with runs.
+ *  The durable surfaces (list/fork/delete/policy) 501 when no durable session store is wired (SESSION_BACKEND=tidb)
+ *  — gate UI off `capabilities()` instead of trial-by-501. */
 import type { Transport } from "../transport.js";
 import { SessionSyncResource } from "./session-sync.js";
 import type { SessionRecord, SessionListPage, SessionMessageEnvelope, StoredSessionRules, SessionPermissionRules, McpStatusPanel } from "../types.js";
+/** Window params of `GET /v1/sessions/:id` (server ≥1.162 four-face, board [611]).
+ *  `tail=N` → last N messages + `window {offset,total}`; `before=<off>&limit=N` → the page
+ *  `[max(0,before-N), before)` (offset stable within one floorEntryId generation); `blobCap=<bytes>`
+ *  → over-limit string bodies truncated to a preview + message-level `truncated:true`.
+ *  Values must be non-negative integers — anything else is dropped client-side (the server ignores
+ *  malformed values anyway; the SDK just never sends junk). No params → the legacy full read,
+ *  byte-identical to before. Old engine (<1.162) ignores the query and returns the full record
+ *  with NO `window` field — probe that for honest degradation. */
 export interface SessionGetParams {
     tail?: number;
     before?: number;
@@ -9,11 +22,22 @@ export interface SessionGetParams {
 }
 export declare class SessionsResource {
     private readonly t;
+    /** 2c session-sync (P1d) — `client.sessions.sync.*`: PULL a cloud session's whole state (manifest + NDJSON entry
+     *  stream + content-addressed blobs) or PUSH the local peer's into the cloud (PUT blobs → two-phase staged import).
+     *  Gate off `capabilities().sessionSync`. See SessionSyncResource. */
     readonly sync: SessionSyncResource;
     constructor(t: Transport);
+    /** GET /v1/sessions/:id — owner-checked (non-owner → 404). True shape; `messages` is the
+     *  current model context and can be LARGE — lazy-expand in UIs, or pass window params
+     *  (`tail`/`before`+`limit`/`blobCap`, server ≥1.162 — see SessionGetParams) to pull a slice:
+     *  the windowed response adds `window {offset,total}` (absent on an old engine = honest
+     *  degradation probe). No params ⇒ legacy full read, byte-identical to before. */
     get(sessionId: string, opts?: SessionGetParams & {
         signal?: AbortSignal;
     }): Promise<SessionRecord>;
+    /** GET /v1/sessions/:id/head — 会话追随轻探针(server ≥1.225,[1075]②):`{ sessionId, leafId }` +
+     *  ETag(=leafId)。leafId 每次 append 都变=版本号——空闲期轮询判增量;传 `etag`(上次值)命中即
+     *  `changed:false` 零 body(HTTP 304)。501=无 durable session store。 */
     head(sessionId: string, opts?: {
         etag?: string;
         signal?: AbortSignal;
@@ -22,6 +46,11 @@ export declare class SessionsResource {
         etag: string;
         leafId?: string | null;
     }>;
+    /** GET /v1/sessions/:id/events — session 级 SSE 真订阅(server ≥1.230,[1196] S1):`event: head`
+     *  帧流(latest-wins;server 侧 25s 心跳)。轮询→订阅的换轨面:每帧=`{ sessionId, leafId }` 新水位,
+     *  拿到即拉 tail 增量(内容职责仍在 tail/turns 面)。`lastLeafId` 传上次水位=命中现值时无首帧
+     *  (304 同义);断线自动重连并以最近水位续(重复帧被服务端抑制)。503=帽满(消费方回落 head 轮询,
+     *  `capabilities.sessionEvents` 预判);会话被删/换主时 server 主动断流,重连将 404 → 迭代器抛出。 */
     watch(sessionId: string, opts?: {
         lastLeafId?: string | null;
         signal?: AbortSignal;
@@ -30,6 +59,8 @@ export declare class SessionsResource {
         sessionId: string;
         leafId: string | null;
     }>;
+    /** GET /v1/sessions/:id/init — 壳启动一次性 banner bundle(E11;server.ts:4683 实拆):
+     *  `{ sessionId, model:{provider,modelId}, mode? }`。worker-global 配置面(REQUIRE_PRINCIPAL 下需主体)。 */
     init(sessionId: string, opts?: {
         signal?: AbortSignal;
     }): Promise<{
@@ -41,6 +72,9 @@ export declare class SessionsResource {
         mode?: string;
         [k: string]: unknown;
     }>;
+    /** GET /v1/sessions/:id/settings — 有效合并设置只读视图(E24 读半场;server.ts:4705 实拆):
+     *  `{ effective:{model,mode?,approvalRequire,commandPolicy,limits}, applied:{model} }`。写半场(PATCH)
+     *  需 core seam,当前诚实缺席——capabilities 不宣告 settings 写能力。 */
     settings(sessionId: string, opts?: {
         signal?: AbortSignal;
     }): Promise<{
@@ -62,6 +96,9 @@ export declare class SessionsResource {
         };
         [k: string]: unknown;
     }>;
+    /** POST /v1/sessions/:id/notify — 会话外事件注入(daemon 终态回报等;server.ts:5398 实拆)。
+     *  body: `{ task_id, status: completed|failed|killed|cancelled|event, summary, result?, seq?, source? }`;
+     *  坏形 400 typed;owner 门 fail-closed(未知/他人 session=404 无 oracle;env-only 无 ownerOf=501)。 */
     notify(sessionId: string, body: {
         task_id: string;
         status: "completed" | "failed" | "killed" | "cancelled" | "event";
@@ -74,6 +111,9 @@ export declare class SessionsResource {
     }): Promise<{
         [k: string]: unknown;
     }>;
+    /** POST /v1/sessions/:id/wake — 唤醒 task_done 纯 park 的会话续跑(design/144 §3,core 1.283 wake 臂;
+     *  server.ts:5472 实拆)。非门决策:绝不 allow/deny 任何 pending 动作——有未决门=core `wake.gate_pending`
+     *  拒;空 park 且无 message=`wake.nothing_to_deliver` 拒。`message` 作续跑首轮输入(可省=送 pendingSteer)。 */
     wake(sessionId: string, body?: {
         message?: string;
     }, opts?: {
@@ -81,9 +121,18 @@ export declare class SessionsResource {
     }): Promise<{
         [k: string]: unknown;
     }>;
+    /** GET /v1/sessions/:id?message=<index> — the single-message expand leg (server ≥1.162,
+     *  the companion of a `blobCap`-truncated windowed read): full body of ONE message by its
+     *  stable index within the current floorEntryId generation. Out-of-range → 404 (typed
+     *  NotFoundError; wire body carries `total`). Owner-checked like `get`. */
     getMessage(sessionId: string, index: number, opts?: {
         signal?: AbortSignal;
     }): Promise<SessionMessageEnvelope>;
+    /** E16 — GET /v1/sessions?limit&cursor&owner → `{ sessions, nextCursor? }` (service `6cbf61e`). Owner-scoped
+     *  keyset page of the caller's sessions (each row aggregates a session's run ledger). `cursor` is the opaque
+     *  `nextCursor` from the previous page (echo verbatim). `owner` is honored only for a fleet-wide credential;
+     *  a principal caller is force-scoped to itself server-side. 501 without a durable session store. Backs the
+     *  shell's session/conversation picker (MF-15/16/17). */
     list(params?: {
         limit?: number;
         cursor?: string;
@@ -92,21 +141,41 @@ export declare class SessionsResource {
     }, opts?: {
         signal?: AbortSignal;
     }): Promise<SessionListPage>;
+    /** E17 — POST /v1/sessions/:id/fork → `{ sessionId }` (the NEW branched session id). Branches a fresh session
+     *  off the source's WHOLE history (a "branch this conversation" / regenerate-from-here). Owner-scoped (non-owner
+     *  → 404; the fork is owned by the caller). 400 on a non-uuidv7 id; 501 without a durable session store.
+     *  Not a submit (creates a distinct resource, not retry-equivalent) → no SDK retry. */
     fork(sessionId: string, opts?: {
         signal?: AbortSignal;
     }): Promise<{
         sessionId: string;
     }>;
+    /** E21 — DELETE /v1/sessions/:id → `{ deleted }` (idempotent: `false` when nothing existed). Purges the
+     *  session's conversation history + the service-owned run-ledger/checkpoint/tool-result rows. Owner-scoped
+     *  (non-owner → 404). 🔴 409 (typed ConflictError, body `activeTaskId`) while a run is LIVE on the session —
+     *  cancel it first (don't orphan the session lock). 501 without a durable session store. Server-idempotent;
+     *  not a submit → no SDK retry. */
     delete(sessionId: string, opts?: {
         signal?: AbortSignal;
     }): Promise<{
         deleted: boolean;
     }>;
+    /** E6 — GET /v1/sessions/:id/policy → `{ rules }` (StoredSessionRules incl. the OCC `rev`). The operator-tightened
+     *  per-session tool-permission rules core reads at prepare-time (SUBTRACT-only). Owner-scoped (non-owner → 404);
+     *  ownerless session → 409; 501 without a session-policy store. Read-only snapshot — the renderer shows the
+     *  effective narrowing, never re-decides (enforcement is 100% core-side). Backs the shell's permissionMode panel
+     *  (MF-22). */
     getPolicy(sessionId: string, opts?: {
         signal?: AbortSignal;
     }): Promise<{
         rules: StoredSessionRules;
     }>;
+    /** E6 — PUT /v1/sessions/:id/policy → `{ rules }` (the stored rules with the new `rev`). Write the per-session
+     *  rules. 🔴 TIGHTEN-ONLY for a normal principal: removing a deny / widening an allowlist or allowDirs → 403
+     *  `loosen_forbidden` (only an operator may loosen). Pass `expectedRev` for optimistic-concurrency (CAS) — a
+     *  stale rev → 409 `conflict` (typed ConflictError). Validation: each of the 5 rule fields must be `string[]` →
+     *  malformed body 400. ownerless session → 409; non-owner → 404. Not a submit (CAS, not retry-equivalent) →
+     *  no SDK retry. */
     putPolicy(sessionId: string, body: {
         rules: SessionPermissionRules;
         expectedRev?: number;
@@ -115,6 +184,11 @@ export declare class SessionsResource {
     }): Promise<{
         rules: StoredSessionRules;
     }>;
+    /** E9 — GET /v1/sessions/:id/mcp → `{ asOf, servers, degraded? }` (core 1.124). Per-server MCP status for the
+     *  `/mcp` panel. 🔴 MATERIALIZATION-TIME, not live session health: core never persists MCP connections, so the
+     *  service fresh-connects→lists→disposes the worker's configured MCP servers on demand and projects their status
+     *  (`asOf` = that moment; render "as of <asOf>"). `degraded:true` (servers empty) ⇒ materialize timed out/failed
+     *  (NOT "no MCP" — a configured-but-no-servers worker returns `servers:[]` without `degraded`). Backs MF-27. */
     mcp(sessionId: string, opts?: {
         signal?: AbortSignal;
     }): Promise<McpStatusPanel>;

package/dist/resources/sessions.d.ts.map

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

package/dist/resources/sessions.js

@@ -15,11 +15,19 @@ function sessionGetQuery(params) {
 }
 export class SessionsResource {
     t;
+    /** 2c session-sync (P1d) — `client.sessions.sync.*`: PULL a cloud session's whole state (manifest + NDJSON entry
+     *  stream + content-addressed blobs) or PUSH the local peer's into the cloud (PUT blobs → two-phase staged import).
+     *  Gate off `capabilities().sessionSync`. See SessionSyncResource. */
     sync;
     constructor(t) {
         this.t = t;
         this.sync = new SessionSyncResource(t);
     }
+    /** GET /v1/sessions/:id — owner-checked (non-owner → 404). True shape; `messages` is the
+     *  current model context and can be LARGE — lazy-expand in UIs, or pass window params
+     *  (`tail`/`before`+`limit`/`blobCap`, server ≥1.162 — see SessionGetParams) to pull a slice:
+     *  the windowed response adds `window {offset,total}` (absent on an old engine = honest
+     *  degradation probe). No params ⇒ legacy full read, byte-identical to before. */
     async get(sessionId, opts) {
         return this.t.request({
             method: "GET",
@@ -27,6 +35,9 @@ export class SessionsResource {
             signal: opts?.signal,
         });
     }
+    /** GET /v1/sessions/:id/head — 会话追随轻探针(server ≥1.225,[1075]②):`{ sessionId, leafId }` +
+     *  ETag(=leafId)。leafId 每次 append 都变=版本号——空闲期轮询判增量;传 `etag`(上次值)命中即
+     *  `changed:false` 零 body(HTTP 304)。501=无 durable session store。 */
     async head(sessionId, opts) {
         const res = await this.t.openRaw({
             method: "GET",
@@ -41,6 +52,11 @@ export class SessionsResource {
         const body = (await res.json());
         return { changed: true, etag: res.headers.get("etag") ?? `"${body.leafId ?? "empty"}"`, leafId: body.leafId };
     }
+    /** GET /v1/sessions/:id/events — session 级 SSE 真订阅(server ≥1.230,[1196] S1):`event: head`
+     *  帧流(latest-wins;server 侧 25s 心跳)。轮询→订阅的换轨面:每帧=`{ sessionId, leafId }` 新水位,
+     *  拿到即拉 tail 增量(内容职责仍在 tail/turns 面)。`lastLeafId` 传上次水位=命中现值时无首帧
+     *  (304 同义);断线自动重连并以最近水位续(重复帧被服务端抑制)。503=帽满(消费方回落 head 轮询,
+     *  `capabilities.sessionEvents` 预判);会话被删/换主时 server 主动断流,重连将 404 → 迭代器抛出。 */
     async *watch(sessionId, opts) {
         let cursor = opts?.lastLeafId;
         const open = () => this.t.openRaw({
@@ -50,24 +66,39 @@ export class SessionsResource {
         });
         for await (const frame of parseFrameStream(open, () => false, { ...(opts?.signal ? { signal: opts.signal } : {}), heartbeatGraceMs: opts?.heartbeatGraceMs ?? 60_000 })) {
             if (frame.event !== "head" || frame.data === undefined)
-                continue;
+                continue; // 心跳注释帧滤除
             const head = JSON.parse(frame.data);
-            cursor = head.leafId;
+            cursor = head.leafId; // 重连游标
             yield head;
         }
     }
+    /** GET /v1/sessions/:id/init — 壳启动一次性 banner bundle(E11;server.ts:4683 实拆):
+     *  `{ sessionId, model:{provider,modelId}, mode? }`。worker-global 配置面(REQUIRE_PRINCIPAL 下需主体)。 */
     async init(sessionId, opts) {
         return this.t.request({ method: "GET", path: `/v1/sessions/${encodeURIComponent(sessionId)}/init`, signal: opts?.signal });
     }
+    /** GET /v1/sessions/:id/settings — 有效合并设置只读视图(E24 读半场;server.ts:4705 实拆):
+     *  `{ effective:{model,mode?,approvalRequire,commandPolicy,limits}, applied:{model} }`。写半场(PATCH)
+     *  需 core seam,当前诚实缺席——capabilities 不宣告 settings 写能力。 */
     async settings(sessionId, opts) {
         return this.t.request({ method: "GET", path: `/v1/sessions/${encodeURIComponent(sessionId)}/settings`, signal: opts?.signal });
     }
+    /** POST /v1/sessions/:id/notify — 会话外事件注入(daemon 终态回报等;server.ts:5398 实拆)。
+     *  body: `{ task_id, status: completed|failed|killed|cancelled|event, summary, result?, seq?, source? }`;
+     *  坏形 400 typed;owner 门 fail-closed(未知/他人 session=404 无 oracle;env-only 无 ownerOf=501)。 */
     async notify(sessionId, body, opts) {
         return this.t.request({ method: "POST", path: `/v1/sessions/${encodeURIComponent(sessionId)}/notify`, body, signal: opts?.signal });
     }
+    /** POST /v1/sessions/:id/wake — 唤醒 task_done 纯 park 的会话续跑(design/144 §3,core 1.283 wake 臂;
+     *  server.ts:5472 实拆)。非门决策:绝不 allow/deny 任何 pending 动作——有未决门=core `wake.gate_pending`
+     *  拒;空 park 且无 message=`wake.nothing_to_deliver` 拒。`message` 作续跑首轮输入(可省=送 pendingSteer)。 */
     async wake(sessionId, body, opts) {
         return this.t.request({ method: "POST", path: `/v1/sessions/${encodeURIComponent(sessionId)}/wake`, body: body ?? {}, signal: opts?.signal });
     }
+    /** GET /v1/sessions/:id?message=<index> — the single-message expand leg (server ≥1.162,
+     *  the companion of a `blobCap`-truncated windowed read): full body of ONE message by its
+     *  stable index within the current floorEntryId generation. Out-of-range → 404 (typed
+     *  NotFoundError; wire body carries `total`). Owner-checked like `get`. */
     async getMessage(sessionId, index, opts) {
         return this.t.request({
             method: "GET",
@@ -75,6 +106,11 @@ export class SessionsResource {
             signal: opts?.signal,
         });
     }
+    /** E16 — GET /v1/sessions?limit&cursor&owner → `{ sessions, nextCursor? }` (service `6cbf61e`). Owner-scoped
+     *  keyset page of the caller's sessions (each row aggregates a session's run ledger). `cursor` is the opaque
+     *  `nextCursor` from the previous page (echo verbatim). `owner` is honored only for a fleet-wide credential;
+     *  a principal caller is force-scoped to itself server-side. 501 without a durable session store. Backs the
+     *  shell's session/conversation picker (MF-15/16/17). */
     async list(params, opts) {
         const q = new URLSearchParams();
         if (params?.limit !== undefined)
@@ -83,6 +119,7 @@ export class SessionsResource {
             q.set("cursor", params.cursor);
         if (params?.owner)
             q.set("owner", params.owner);
+        // server 1.183.0 (?q= substring search over run objectives; capabilities.sessionSearch gates support).
         if (params?.q)
             q.set("q", params.q);
         const qs = q.toString();
@@ -92,6 +129,10 @@ export class SessionsResource {
             signal: opts?.signal,
         });
     }
+    /** E17 — POST /v1/sessions/:id/fork → `{ sessionId }` (the NEW branched session id). Branches a fresh session
+     *  off the source's WHOLE history (a "branch this conversation" / regenerate-from-here). Owner-scoped (non-owner
+     *  → 404; the fork is owned by the caller). 400 on a non-uuidv7 id; 501 without a durable session store.
+     *  Not a submit (creates a distinct resource, not retry-equivalent) → no SDK retry. */
     async fork(sessionId, opts) {
         return this.t.request({
             method: "POST",
@@ -99,6 +140,11 @@ export class SessionsResource {
             signal: opts?.signal,
         });
     }
+    /** E21 — DELETE /v1/sessions/:id → `{ deleted }` (idempotent: `false` when nothing existed). Purges the
+     *  session's conversation history + the service-owned run-ledger/checkpoint/tool-result rows. Owner-scoped
+     *  (non-owner → 404). 🔴 409 (typed ConflictError, body `activeTaskId`) while a run is LIVE on the session —
+     *  cancel it first (don't orphan the session lock). 501 without a durable session store. Server-idempotent;
+     *  not a submit → no SDK retry. */
     async delete(sessionId, opts) {
         return this.t.request({
             method: "DELETE",
@@ -106,6 +152,11 @@ export class SessionsResource {
             signal: opts?.signal,
         });
     }
+    /** E6 — GET /v1/sessions/:id/policy → `{ rules }` (StoredSessionRules incl. the OCC `rev`). The operator-tightened
+     *  per-session tool-permission rules core reads at prepare-time (SUBTRACT-only). Owner-scoped (non-owner → 404);
+     *  ownerless session → 409; 501 without a session-policy store. Read-only snapshot — the renderer shows the
+     *  effective narrowing, never re-decides (enforcement is 100% core-side). Backs the shell's permissionMode panel
+     *  (MF-22). */
     async getPolicy(sessionId, opts) {
         return this.t.request({
             method: "GET",
@@ -113,6 +164,12 @@ export class SessionsResource {
             signal: opts?.signal,
         });
     }
+    /** E6 — PUT /v1/sessions/:id/policy → `{ rules }` (the stored rules with the new `rev`). Write the per-session
+     *  rules. 🔴 TIGHTEN-ONLY for a normal principal: removing a deny / widening an allowlist or allowDirs → 403
+     *  `loosen_forbidden` (only an operator may loosen). Pass `expectedRev` for optimistic-concurrency (CAS) — a
+     *  stale rev → 409 `conflict` (typed ConflictError). Validation: each of the 5 rule fields must be `string[]` →
+     *  malformed body 400. ownerless session → 409; non-owner → 404. Not a submit (CAS, not retry-equivalent) →
+     *  no SDK retry. */
     async putPolicy(sessionId, body, opts) {
         return this.t.request({
             method: "PUT",
@@ -121,6 +178,11 @@ export class SessionsResource {
             signal: opts?.signal,
         });
     }
+    /** E9 — GET /v1/sessions/:id/mcp → `{ asOf, servers, degraded? }` (core 1.124). Per-server MCP status for the
+     *  `/mcp` panel. 🔴 MATERIALIZATION-TIME, not live session health: core never persists MCP connections, so the
+     *  service fresh-connects→lists→disposes the worker's configured MCP servers on demand and projects their status
+     *  (`asOf` = that moment; render "as of <asOf>"). `degraded:true` (servers empty) ⇒ materialize timed out/failed
+     *  (NOT "no MCP" — a configured-but-no-servers worker returns `servers:[]` without `degraded`). Backs MF-27. */
     async mcp(sessionId, opts) {
         return this.t.request({
             method: "GET",

package/dist/resources/sessions.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/resources/sessions.ts"],"names":[],"mappings":"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"}
+{"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;AAyBxD,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAE/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;;;;sFAIkF;IAClF,KAAK,CAAC,GAAG,CACP,SAAiB,EACjB,IAAkD;QAElD,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAgB;YACnC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE;YAC7E,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;wEAEoE;IACpE,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,IAA8C;QAC1E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YAC/B,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,OAAO;YAC1D,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAK,CAAC,IAAK,EAAE,CAAC;QACrE,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,CAAC,MAAM,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpG,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAiD,CAAC;QAChF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,OAAO,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAChH,CAAC;IAED;;;;iFAI6E;IAC7E,KAAK,CAAC,CAAC,KAAK,CACV,SAAiB,EACjB,IAAsF;QAEtF,IAAI,MAAM,GAA8B,IAAI,EAAE,UAAU,CAAC;QACzD,MAAM,IAAI,GAAG,GAAsB,EAAE,CACnC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YACb,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,UAAU,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,kBAAkB,CAAC,MAAM,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YAChJ,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC,CAAC;QACL,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,IAAI,MAAM,EAAE,CAAC,EAAE,CAAC;YACxK,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;gBAAE,SAAS,CAAC,UAAU;YAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAiD,CAAC;YACpF,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO;YAC7B,MAAM,IAAI,CAAC;QACb,CAAC;IACH,CAAC;IAED;sGACkG;IAClG,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,IAA+B;QAC3D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7H,CAAC;IAED;;6DAEyD;IACzD,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,IAA+B;QAK/D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjI,CAAC;IAED;;+FAE2F;IAC3F,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,IAA6J,EAC7J,IAA+B;QAE/B,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACtI,CAAC;IAED;;gGAE4F;IAC5F,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,IAA2B,EAAE,IAA+B;QACxF,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAChJ,CAAC;IAED;;;+EAG2E;IAC3E,KAAK,CAAC,UAAU,CACd,SAAiB,EACjB,KAAa,EACb,IAA+B;QAE/B,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAyB;YAC5C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,YAAY,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE;YAClG,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;6DAIyD;IACzD,KAAK,CAAC,IAAI,CACR,MAAwE,EACxE,IAA+B;QAE/B,MAAM,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC;QAChC,IAAI,MAAM,EAAE,KAAK,KAAK,SAAS;YAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,IAAI,MAAM,EAAE,MAAM;YAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,MAAM,EAAE,KAAK;YAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAChD,uGAAuG;QACvG,IAAI,MAAM,EAAE,CAAC;YAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAkB;YACrC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YACzC,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;2FAGuF;IACvF,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,IAA+B;QAC3D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAwB;YAC3C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,OAAO;YAC1D,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;uCAImC;IACnC,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,IAA+B;QAC7D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAuB;YAC1C,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE;YACrD,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;mBAIe;IACf,KAAK,CAAC,SAAS,CAAC,SAAiB,EAAE,IAA+B;QAChE,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAgC;YACnD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,SAAS;YAC5D,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;wBAKoB;IACpB,KAAK,CAAC,SAAS,CACb,SAAiB,EACjB,IAA6D,EAC7D,IAA+B;QAE/B,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAgC;YACnD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,SAAS;YAC5D,IAAI;YACJ,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;oHAIgH;IAChH,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,IAA+B;QAC1D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAiB;YACpC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,MAAM;YACzD,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/side-query.d.ts

@@ -1,10 +1,25 @@
+/**
+ * [1469] `POST /v1/side-query` — server 1.242 的一次性 brain 路由问答(core 1.361 `Runner.sideQuery` 包装)。
+ * **无 session 副作用/无工具执行/无引擎侧 policy gate/无流式(v1)**——壳侧 utility(标题/摘要/权限解释…)
+ * 的传输层正解([1463]①):engineSideChannel 只换传输层,15+ utility 零改动升级。
+ *
+ * 鉴权同任务面(service token / requirePrincipal 部署缺 principal=401);计费面同 billable-submit 姿势
+ * (no-token 503 fail-closed、draining/model-ready 503、rate/quota/lease 三闸);server 半场把 usage 记进
+ * principal 的配额桶+fleet lease(cache-family-aware 配额轴)。探测:`capabilities.sideQuery`(恒 true
+ * on ≥1.242;旧 server=缺席,走 tolerate-absent 判缺)。
+ */
 import type { Transport } from "../transport.js";
+/** 请求形(server 白名单透传 core SideQuerySpec;`signal` 为 server 属地——client 断连即弃,body 里
+ *  传了也会被丢)。messages 逐条形=core SideQueryMessage(user/assistant/toolResult 三臂;assistant
+ *  元数据全可选、string content 可折)。 */
 export interface SideQueryRequest {
+    /** 池名/role/@mention,同任务面解析;缺省走 default role。 */
     model?: string;
     modelRole?: string;
     thinking?: string;
     systemPrompt?: string;
     messages: Array<Record<string, unknown>>;
+    /** 工具**定义**(给模型出 toolCalls 数据用)——服务端绝不执行。 */
     tools?: Array<{
         name: string;
         description: string;
@@ -12,6 +27,8 @@ export interface SideQueryRequest {
     }>;
     maxOutputTokens?: number;
 }
+/** 响应形(core SideQueryResult 原样):`model`=路由身份,`servedModel`=实际服务者(degrading fallback
+ *  诚实归因),stream 后错误进 `errorMessage` 不作 HTTP 错(400 仅限校验/模型解析,5xx=服务端缺陷)。 */
 export interface SideQueryResult {
     text: string;
     toolCalls: Array<{
@@ -37,6 +54,7 @@ export interface SideQueryResult {
 export declare class SideQueryResource {
     private readonly t;
     constructor(t: Transport);
+    /** POST /v1/side-query — one-shot;不 idempotent(烧一次模型)→ NO SDK retry。 */
     query(body: SideQueryRequest, opts?: {
         signal?: AbortSignal;
     }): Promise<SideQueryResult>;

package/dist/resources/side-query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"side-query.d.ts","sourceRoot":"","sources":["../../src/resources/side-query.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKjD,MAAM,WAAW,gBAAgB;IAE/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAGnC,KAAK,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;CAG/F"}
+{"version":3,"file":"side-query.d.ts","sourceRoot":"","sources":["../../src/resources/side-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;iCAEiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;2EAC2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC,wEAAwE;IAClE,KAAK,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;CAG/F"}

package/dist/resources/side-query.js

@@ -3,6 +3,7 @@ export class SideQueryResource {
     constructor(t) {
         this.t = t;
     }
+    /** POST /v1/side-query — one-shot;不 idempotent(烧一次模型)→ NO SDK retry。 */
     async query(body, opts) {
         return this.t.request({ method: "POST", path: "/v1/side-query", body, signal: opts?.signal });
     }

package/dist/resources/side-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"side-query.js","sourceRoot":"","sources":["../../src/resources/side-query.ts"],"names":[],"mappings":"AA2CA,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAG7C,KAAK,CAAC,KAAK,CAAC,IAAsB,EAAE,IAA+B;QACjE,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjH,CAAC;CACF"}
+{"version":3,"file":"side-query.js","sourceRoot":"","sources":["../../src/resources/side-query.ts"],"names":[],"mappings":"AA2CA,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAE7C,wEAAwE;IACxE,KAAK,CAAC,KAAK,CAAC,IAAsB,EAAE,IAA+B;QACjE,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjH,CAAC;CACF"}

package/dist/resources/tasks.d.ts

@@ -1,18 +1,37 @@
+/** tasks — synchronous. `submit` (POST /v1/tasks, auto idempotency key) + `stream` (POST /v1/tasks/stream,
+ *  live token stream; verify/cascade NOT supported here). Signatures fixed; bodies TODO(M1/M2). */
 import type { Transport } from "../transport.js";
 import type { TaskRequest, TaskResult } from "../types.js";
 import type { AgentEvent } from "../events.js";
 export declare class TasksResource {
     private readonly t;
     constructor(t: Transport);
+    /** Run to completion, return the TaskResult. Auto Idempotency-Key (→ retry-safe). NOTE: a budget gate is
+     *  result-level — it comes back as HTTP 200 with `result.errorCode` (budget.precall/budget.exceeded), NOT a
+     *  thrown error (pinned wire contract). Branch on `result.errorCode`, not a catch. */
     submit(req: TaskRequest, opts?: {
         idempotencyKey?: string | null;
         signal?: AbortSignal;
     }): Promise<TaskResult>;
+    /** Raw SSE passthrough for THIN PROXIES (e.g. OA's /api/ai/chat relays the byte stream untouched so its
+     *  frontend parsing stays as-is). Returns the ok-checked Response — the caller owns the body; closing it
+     *  aborts the server run (anti token-burn). Non-OK → typed error. Same restriction: no verify/cascade.
+     *  `headers` = generic caller extras on the wire (e.g. a shell assembling `x-detach-on-disconnect` for the
+     *  server's opt-in disconnect grace — the SDK ships NO detach semantics or constants; it is a plain pipe).
+     *  Built-in headers (authorization / idempotency-key / …) always win the merge (transport.openStream). */
     streamRaw(req: TaskRequest, opts?: {
         signal?: AbortSignal;
         idempotencyKey?: string | null;
         headers?: Record<string, string>;
     }): Promise<Response>;
+    /** Live token stream (same instance), parsed into typed AgentEvents. No verify/cascade (rejected 400 —
+     *  multi-attempt, not a stream). TRANSIENT: a disconnect ABORTS the server run (anti token-burn); a drop is
+     *  NOT resumed — durable resume is runs.events. `heartbeatGraceMs` tunes the silence watchdog (default 45s;
+     *  engine heartbeats every 15s) — on silence a typed {@link SseIdleError} is thrown for the caller to
+     *  diagnose. `idempotencyKey` lets the caller PIN the submit key (default: auto-minted per call) so a future
+     *  reconnect can hit the server's in-flight replay lane with the SAME key (P0-2 S1; reconnect itself is S2,
+     *  gated on the engine-side disconnect grace). `headers` = generic caller extras (see {@link streamRaw});
+     *  built-ins always win the merge. */
     stream(req: TaskRequest, opts?: {
         signal?: AbortSignal;
         onResponse?: (res: Response) => void;

package/dist/resources/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/resources/tasks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI/C,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAKnC,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAiB9G,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAuBhJ,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,cAAc,CAAC,UAAU,CAAC;CAgBhO"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/resources/tasks.ts"],"names":[],"mappings":"AAAA;mGACmG;AACnG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI/C,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC;;0FAEsF;IAChF,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAWpH;;;;;8GAK0G;IACpG,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAevJ;;;;;;;0CAOsC;IAC/B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,cAAc,CAAC,UAAU,CAAC;CAgBhO"}

package/dist/resources/tasks.js

@@ -5,6 +5,9 @@ export class TasksResource {
     constructor(t) {
         this.t = t;
     }
+    /** Run to completion, return the TaskResult. Auto Idempotency-Key (→ retry-safe). NOTE: a budget gate is
+     *  result-level — it comes back as HTTP 200 with `result.errorCode` (budget.precall/budget.exceeded), NOT a
+     *  thrown error (pinned wire contract). Branch on `result.errorCode`, not a catch. */
     async submit(req, opts) {
         return this.t.request({
             method: "POST",
@@ -15,6 +18,12 @@ export class TasksResource {
             signal: opts?.signal,
         });
     }
+    /** Raw SSE passthrough for THIN PROXIES (e.g. OA's /api/ai/chat relays the byte stream untouched so its
+     *  frontend parsing stays as-is). Returns the ok-checked Response — the caller owns the body; closing it
+     *  aborts the server run (anti token-burn). Non-OK → typed error. Same restriction: no verify/cascade.
+     *  `headers` = generic caller extras on the wire (e.g. a shell assembling `x-detach-on-disconnect` for the
+     *  server's opt-in disconnect grace — the SDK ships NO detach semantics or constants; it is a plain pipe).
+     *  Built-in headers (authorization / idempotency-key / …) always win the merge (transport.openStream). */
     async streamRaw(req, opts) {
         const o = {
             method: "POST",
@@ -32,12 +41,22 @@ export class TasksResource {
             throw toApiError(res.status, await res.json().catch(() => ({})));
         return res;
     }
+    /** Live token stream (same instance), parsed into typed AgentEvents. No verify/cascade (rejected 400 —
+     *  multi-attempt, not a stream). TRANSIENT: a disconnect ABORTS the server run (anti token-burn); a drop is
+     *  NOT resumed — durable resume is runs.events. `heartbeatGraceMs` tunes the silence watchdog (default 45s;
+     *  engine heartbeats every 15s) — on silence a typed {@link SseIdleError} is thrown for the caller to
+     *  diagnose. `idempotencyKey` lets the caller PIN the submit key (default: auto-minted per call) so a future
+     *  reconnect can hit the server's in-flight replay lane with the SAME key (P0-2 S1; reconnect itself is S2,
+     *  gated on the engine-side disconnect grace). `headers` = generic caller extras (see {@link streamRaw});
+     *  built-ins always win the merge. */
     async *stream(req, opts) {
         const res = await this.streamRaw(req, opts);
+        // Additive header hook (server 1.47+ early-emits X-Task-Id on the sync leg): lets a shell bind the
+        // run id BEFORE any frame arrives (early journal / mid-flight control verbs like runs.detach).
         try {
             opts?.onResponse?.(res);
         }
-        catch { }
+        catch { /* a consumer hook must never break the stream */ }
         try {
             for await (const frame of readSseFrames(res, opts?.heartbeatGraceMs, opts?.signal)) {
                 if (!frame.data)
@@ -49,7 +68,7 @@ export class TasksResource {
             }
         }
         finally {
-            res.body?.cancel().catch(() => { });
+            res.body?.cancel().catch(() => { }); // disconnect = abort server-side (by design)
         }
     }
 }

package/dist/resources/tasks.js.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/resources/tasks.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAK7C,KAAK,CAAC,MAAM,CAAC,GAAgB,EAAE,IAA+D;QAC5F,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAa;YAChC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,IAAI;YACZ,cAAc,EAAE,IAAI,EAAE,cAAc;YACpC,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAQD,KAAK,CAAC,SAAS,CAAC,GAAgB,EAAE,IAAiG;QACjI,MAAM,CAAC,GAA2C;YAChD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,IAAI;YACZ,cAAc,EAAE,IAAI,EAAE,cAAc;SACrC,CAAC;QACF,IAAI,IAAI,EAAE,OAAO;YAAE,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5C,IAAI,IAAI,EAAE,MAAM;YAAE,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9E,OAAO,GAAG,CAAC;IACb,CAAC;IAUD,KAAK,CAAC,CAAC,MAAM,CAAC,GAAgB,EAAE,IAAkK;QAChM,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAG5C,IAAI,CAAC;YAAC,IAAI,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAmD,CAAC;QAC5F,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;gBACnF,IAAI,CAAC,KAAK,CAAC,IAAI;oBAAE,SAAS;gBAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC;gBAChD,MAAM,EAAE,CAAC;gBACT,IAAI,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,EAAE,CAAC,IAAI,KAAK,QAAQ;oBAAE,OAAO;YACzD,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/resources/tasks.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAE7C;;0FAEsF;IACtF,KAAK,CAAC,MAAM,CAAC,GAAgB,EAAE,IAA+D;QAC5F,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAa;YAChC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,WAAW;YACjB,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;;;;;8GAK0G;IAC1G,KAAK,CAAC,SAAS,CAAC,GAAgB,EAAE,IAAiG;QACjI,MAAM,CAAC,GAA2C;YAChD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,IAAI;YACZ,cAAc,EAAE,IAAI,EAAE,cAAc;SACrC,CAAC;QACF,IAAI,IAAI,EAAE,OAAO;YAAE,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5C,IAAI,IAAI,EAAE,MAAM;YAAE,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9E,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;;0CAOsC;IACtC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAgB,EAAE,IAAkK;QAChM,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5C,mGAAmG;QACnG,+FAA+F;QAC/F,IAAI,CAAC;YAAC,IAAI,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,iDAAiD,CAAC,CAAC;QAC5F,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;gBACnF,IAAI,CAAC,KAAK,CAAC,IAAI;oBAAE,SAAS;gBAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC;gBAChD,MAAM,EAAE,CAAC;gBACT,IAAI,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,EAAE,CAAC,IAAI,KAAK,QAAQ;oBAAE,OAAO;YACzD,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,6CAA6C;QACnF,CAAC;IACH,CAAC;CACF"}