@sema-agent/sdk 0.0.75 → 0.0.76

package/dist/resources/fleet.js

@@ -5,21 +5,37 @@ export class FleetResource {
     constructor(t) {
         this.t = t;
     }
+    /**
+     * GET /v1/fleet/stream — the LIVE fleet (active task + workflow rows). SSE; the SDK PRODUCES frames, the
+     * consumer maintains the active-set state (update-in-place / remove by `id`).
+     *
+     * Emit order: `meta` (`{version, scoped}`) → `snapshot` (full visible set) → then a `task`/`workflow` upsert
+     * per transition + `task_remove`/`workflow_remove` per departure. Each `task`/`workflow` frame is the POST-MERGE
+     * FULL row (NOT a sparse patch) → replace by `row.id`. Heartbeat comment frames are swallowed.
+     *
+     * 🔴 NOT RESUMABLE: a drop just ends the generator (re-call for a fresh snapshot). Owner-scoped by the
+     * credential principal unless fleet-wide; `scope` is wire-stripped (never appears on a row). 501 (typed) before
+     * any frame when fleet wiring is absent.
+     */
     async *stream(opts) {
         const o = { method: "GET", path: "/v1/fleet/stream" };
         if (opts?.signal)
             o.signal = opts.signal;
         const res = await this.t.openStream(o);
         if (!res.ok)
-            throw toApiError(res.status, await res.json().catch(() => ({})));
+            throw toApiError(res.status, await res.json().catch(() => ({}))); // 501 (no fleet wiring) / 401 — before any frame
         try {
             for await (const frame of readSseFrames(res, undefined, opts?.signal)) {
                 if (!frame.data)
-                    continue;
-                const data = JSON.parse(frame.data);
+                    continue; // heartbeat / comment (`: hb`)
+                const data = JSON.parse(frame.data); // SyntaxError = contract breach → rethrown
                 const event = frame.event ?? "message";
                 switch (event) {
                     case "meta": {
+                        // server 契约方复审 F1(行为错·最高):这里原是白名单重构——server 1.247+ 的
+                        // `sessionScoped`/`bgNotifyFailClosed`(cli 代际让位判别的两个键)被中继剥掉,cli 的
+                        // [1510] 让位臂全程死代码(0.0.69 只加了类型没改运行时)。改为 rest 透传:规范字段
+                        // 归一在前,其余(含未来新键)原样随帧——meta 是声明帧,透传即前向兼容。
                         const { version: _v, scoped: _s, ts: _t, ...metaRest } = data;
                         yield { type: "meta", version: Number(data.version ?? 1), scoped: Boolean(data.scoped), ...(typeof data.ts === "number" ? { ts: data.ts } : {}), ...metaRest };
                         break;
@@ -45,18 +61,25 @@ export class FleetResource {
                         yield { type: "workflow_remove", id: String(data.id), ts: Number(data.ts ?? 0) };
                         break;
                     case "bg_notification": {
+                        // Wire: `{ type:'bg_notification', ...notification, ts }` (the service inlines the payload —
+                        // its frame bridge contract dispatches on data.type). Re-nest for the typed consumer.
                         const { type: _t, ts, ...notification } = data;
                         yield { type: "bg_notification", notification: notification, ts: Number(ts ?? 0) };
                         break;
                     }
                     default:
+                        // [1338]⑥ OPEN-SET PASSTHROUGH — a `default: break` here silently ATE every frame vocabulary
+                        // addition (bg_notification rode the wire for weeks while consumers saw nothing, and every
+                        // consumer had to tee the raw response body to get at it). Unknown frames now yield verbatim;
+                        // consumers ignore what they don't render, and a future service vocabulary lands without an
+                        // SDK release in between.
                         yield { type: "unknown", event, data };
                         break;
                 }
             }
         }
         finally {
-            res.body?.cancel().catch(() => { });
+            res.body?.cancel().catch(() => { }); // disconnect = stop the in-process subscription
         }
     }
 }

package/dist/resources/fleet.js.map

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

package/dist/resources/images.d.ts

@@ -1,8 +1,18 @@
+/** images — §sandbox-image catalog（service IMAGE-API §7）。门B「选沙箱模板」的**只读**数据源。
+ *
+ *  `list` = `GET /v1/images` 目录（visibility 按 principal scoped；分页 cursor/limit）。
+ *  `select` = `POST /v1/images/select` 纯 resolution **预览**（仅供 UI 显"这 profile 解析到哪个 digest/能力"）。
+ *
+ *  🔴 **绑定不靠 select**（方案 b）：用户选 profile → 提交时 `TaskRequest.sandboxImageProfile` 送 **profile**,
+ *     service 内部按 trusted principal `latestPublished(profile, viewer)` fail-closed 解析 digest + 再准入。
+ *     caller **永远只送 profile,绝不送/缓存/重算 digest**（信 caller digest = fail-OPEN）。select 仅 UI 预览,非绑定凭证。 */
 import type { Transport } from "../transport.js";
 import type { ImageIndexEntry, ImageSelectResult } from "../types.js";
 export declare class ImagesResource {
     private readonly t;
     constructor(t: Transport);
+    /** GET /v1/images — 分页镜像目录（visibility 按 principal scoped）。filter: profile/capability/status/latest。
+     *  信封 `{images, nextCursor?}`（cursor-agnostic：UI 用 nextCursor 翻页，不假设 cursor 内部形态）。 */
     list(opts?: {
         profile?: string;
         capability?: string;
@@ -15,30 +25,41 @@ export declare class ImagesResource {
         images: ImageIndexEntry[];
         nextCursor?: string;
     }>;
+    /** POST /v1/images/select {profile, capabilitiesNeeded?} → resolution **预览**（digest/podContract/capabilities）。
+     *  🔴 仅 UI 预览,**绝非绑定凭证**；绑定走 `TaskRequest.sandboxImageProfile`（service 内部 re-admit）。
+     *  不可见/未发布/能力不满足 → 4xx（caller 透传提示，不向用户 surface digest 解析细节超出预览）。 */
     select(body: {
         profile: string;
         capabilitiesNeeded?: string[];
         signal?: AbortSignal;
     }): Promise<ImageSelectResult>;
+    /** POST /v1/images/register — 登记一条镜像索引条目(server.ts:3780 实拆)→ `{ id }`。operator 面。 */
     register(body: Record<string, unknown>, opts?: {
         signal?: AbortSignal;
     }): Promise<{
         id: string;
     }>;
+    /** GET /v1/images/:profile — 取 profile 最新已发布条目(server.ts:3835 实拆)→ `{ image: entry }`。 */
     byProfile(profile: string, opts?: {
         signal?: AbortSignal;
     }): Promise<{
         image: Record<string, unknown>;
     }>;
+    /** GET /v1/images/digests/:digest — 按不可变 digest 取条目(server.ts:3823 实拆)→ `{ image: entry }`。 */
     byDigest(digest: string, opts?: {
         signal?: AbortSignal;
     }): Promise<{
         image: Record<string, unknown>;
     }>;
 }
+/** bakes — sandbox 镜像烧制控制面(IMAGE-API-DESIGN.md §P2;server.ts:3488 区实拆)。两种主体:
+ *  operator(create/get/cancel/events)与 bake-runner 凭证(claim/ingest——runner 机对机面,ingest 需
+ *  claim 响应里的 per-bake `ingestSecret` 回带)。挂 `client.images.bakes`。 */
 export declare class BakesResource {
     private readonly t;
     constructor(t: Transport);
+    /** POST /v1/images/bakes → 202 `{ bakeId, eventsUrl, status, state }`(白名单验参 400/501;同 argv 在飞
+     *  幂等复用 202;繁忙 409 `{activeBakeId?, eventsUrl?}`;429 提交限速带 retryAfterSec)。operator-only。 */
     create(body: Record<string, unknown>, opts?: {
         signal?: AbortSignal;
     }): Promise<{
@@ -48,11 +69,15 @@ export declare class BakesResource {
         state?: string;
         [k: string]: unknown;
     }>;
+    /** GET /v1/images/bakes/:id → `{ bake: bakeView }`(bakeId/status/state/profile/bands/baseRef/push/dryRun/
+     *  logs/digest/repo…,开集)。operator-only。 */
     get(bakeId: string, opts?: {
         signal?: AbortSignal;
     }): Promise<{
         bake: Record<string, unknown>;
     }>;
+    /** POST /v1/images/bakes/:id/cancel → 202 `{ bakeId, cancelRequested: true, note }`(只 flag 非终态行;
+     *  runner 在下个 heartbeat 杀构建;已终态=no-op 诚实注记)。operator-only。 */
     cancel(bakeId: string, opts?: {
         signal?: AbortSignal;
     }): Promise<{
@@ -60,16 +85,22 @@ export declare class BakesResource {
         cancelRequested: boolean;
         note?: string;
     }>;
+    /** POST /v1/images/bakes/claim — runner 领取最老 queued bake(发现+单飞 CAS 一步;204=队空 → null)。
+     *  响应=`{ bakeId, argv, push, dryRun, logs, profile, bands, ingestSecret, leaseUntil }`。runner 凭证面。 */
     claimNext(body?: {
         runnerId?: string;
     }, opts?: {
         signal?: AbortSignal;
     }): Promise<BakeClaim | null>;
+    /** POST /v1/images/bakes/:id/claim — 领取指定 queued bake(输单飞=409)。runner 凭证面。 */
     claim(bakeId: string, body?: {
         runnerId?: string;
     }, opts?: {
         signal?: AbortSignal;
     }): Promise<BakeClaim>;
+    /** POST /v1/images/bakes/:id/ingest — runner 回传一行 build.sh 事件 + lease 心跳(`x-bake-ingest-secret`
+     *  头带 claim 时铸的 secret;line=`{event,...}`,event=heartbeat 只续约)。响应恒带
+     *  `{ accepted, leaseValid, cancelRequested }`(409=lease 失效/被抢;cancelRequested=true → runner 应杀构建)。 */
     ingest(bakeId: string, ingestSecret: string, line: Record<string, unknown>, opts?: {
         signal?: AbortSignal;
     }): Promise<{
@@ -78,6 +109,8 @@ export declare class BakesResource {
         cancelRequested: boolean;
         [k: string]: unknown;
     }>;
+    /** GET /v1/images/bakes/:id/events — 烧制实况 SSE(§P2.2,run-trace-SSE 同形;resumable,`id:` 行=事件 seq,
+     *  Last-Event-ID 续传)。开集帧——按 event 分派,未知帧泛渲不崩;终态帧 = `done`/`error`。operator-only。 */
     events(bakeId: string, opts?: {
         signal?: AbortSignal;
         lastEventId?: string;
@@ -87,6 +120,7 @@ export declare class BakesResource {
         data: Record<string, unknown>;
     }>;
 }
+/** claim 响应(server claimResponse 实拆)。argv=服务端整装白名单 argv(runner 逐字执行,绝不自拼)。 */
 export interface BakeClaim {
     bakeId: string;
     argv: string[];

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

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

package/dist/resources/images.js

@@ -4,6 +4,8 @@ export class ImagesResource {
     constructor(t) {
         this.t = t;
     }
+    /** GET /v1/images — 分页镜像目录（visibility 按 principal scoped）。filter: profile/capability/status/latest。
+     *  信封 `{images, nextCursor?}`（cursor-agnostic：UI 用 nextCursor 翻页，不假设 cursor 内部形态）。 */
     async list(opts) {
         const q = new URLSearchParams();
         if (opts?.profile)
@@ -21,45 +23,66 @@ export class ImagesResource {
         const qs = q.toString();
         return this.t.request({ method: "GET", path: `/v1/images${qs ? `?${qs}` : ""}`, signal: opts?.signal });
     }
+    /** POST /v1/images/select {profile, capabilitiesNeeded?} → resolution **预览**（digest/podContract/capabilities）。
+     *  🔴 仅 UI 预览,**绝非绑定凭证**；绑定走 `TaskRequest.sandboxImageProfile`（service 内部 re-admit）。
+     *  不可见/未发布/能力不满足 → 4xx（caller 透传提示，不向用户 surface digest 解析细节超出预览）。 */
     async select(body) {
         const { signal, ...payload } = body;
         return this.t.request({ method: "POST", path: "/v1/images/select", body: payload, signal });
     }
+    /** POST /v1/images/register — 登记一条镜像索引条目(server.ts:3780 实拆)→ `{ id }`。operator 面。 */
     async register(body, opts) {
         return this.t.request({ method: "POST", path: "/v1/images/register", body, signal: opts?.signal });
     }
+    /** GET /v1/images/:profile — 取 profile 最新已发布条目(server.ts:3835 实拆)→ `{ image: entry }`。 */
     async byProfile(profile, opts) {
         return this.t.request({ method: "GET", path: `/v1/images/${encodeURIComponent(profile)}`, signal: opts?.signal });
     }
+    /** GET /v1/images/digests/:digest — 按不可变 digest 取条目(server.ts:3823 实拆)→ `{ image: entry }`。 */
     async byDigest(digest, opts) {
         return this.t.request({ method: "GET", path: `/v1/images/digests/${encodeURIComponent(digest)}`, signal: opts?.signal });
     }
 }
+/** bakes — sandbox 镜像烧制控制面(IMAGE-API-DESIGN.md §P2;server.ts:3488 区实拆)。两种主体:
+ *  operator(create/get/cancel/events)与 bake-runner 凭证(claim/ingest——runner 机对机面,ingest 需
+ *  claim 响应里的 per-bake `ingestSecret` 回带)。挂 `client.images.bakes`。 */
 export class BakesResource {
     t;
     constructor(t) {
         this.t = t;
     }
+    /** POST /v1/images/bakes → 202 `{ bakeId, eventsUrl, status, state }`(白名单验参 400/501;同 argv 在飞
+     *  幂等复用 202;繁忙 409 `{activeBakeId?, eventsUrl?}`;429 提交限速带 retryAfterSec)。operator-only。 */
     async create(body, opts) {
         return this.t.request({ method: "POST", path: "/v1/images/bakes", body, signal: opts?.signal });
     }
+    /** GET /v1/images/bakes/:id → `{ bake: bakeView }`(bakeId/status/state/profile/bands/baseRef/push/dryRun/
+     *  logs/digest/repo…,开集)。operator-only。 */
     async get(bakeId, opts) {
         return this.t.request({ method: "GET", path: `/v1/images/bakes/${encodeURIComponent(bakeId)}`, signal: opts?.signal });
     }
+    /** POST /v1/images/bakes/:id/cancel → 202 `{ bakeId, cancelRequested: true, note }`(只 flag 非终态行;
+     *  runner 在下个 heartbeat 杀构建;已终态=no-op 诚实注记)。operator-only。 */
     async cancel(bakeId, opts) {
         return this.t.request({ method: "POST", path: `/v1/images/bakes/${encodeURIComponent(bakeId)}/cancel`, body: {}, signal: opts?.signal });
     }
+    /** POST /v1/images/bakes/claim — runner 领取最老 queued bake(发现+单飞 CAS 一步;204=队空 → null)。
+     *  响应=`{ bakeId, argv, push, dryRun, logs, profile, bands, ingestSecret, leaseUntil }`。runner 凭证面。 */
     async claimNext(body, opts) {
         const res = await this.t.openRaw({ method: "POST", path: "/v1/images/bakes/claim", rawBody: JSON.stringify(body ?? {}), contentType: "application/json", ...(opts?.signal ? { signal: opts.signal } : {}) });
         if (res.status === 204)
-            return null;
+            return null; // queue empty — the runner idle-polls
         if (!res.ok)
             throw new Error(`POST /v1/images/bakes/claim → HTTP ${res.status}: ${await res.text()}`);
         return (await res.json());
     }
+    /** POST /v1/images/bakes/:id/claim — 领取指定 queued bake(输单飞=409)。runner 凭证面。 */
     async claim(bakeId, body, opts) {
         return this.t.request({ method: "POST", path: `/v1/images/bakes/${encodeURIComponent(bakeId)}/claim`, body: body ?? {}, signal: opts?.signal });
     }
+    /** POST /v1/images/bakes/:id/ingest — runner 回传一行 build.sh 事件 + lease 心跳(`x-bake-ingest-secret`
+     *  头带 claim 时铸的 secret;line=`{event,...}`,event=heartbeat 只续约)。响应恒带
+     *  `{ accepted, leaseValid, cancelRequested }`(409=lease 失效/被抢;cancelRequested=true → runner 应杀构建)。 */
     async ingest(bakeId, ingestSecret, line, opts) {
         const res = await this.t.openRaw({
             method: "POST",
@@ -70,10 +93,13 @@ export class BakesResource {
             ...(opts?.signal ? { signal: opts.signal } : {}),
         });
         const body = (await res.json());
+        // 409 = lease 失效/被抢——契约上仍带三态体(runner 用 cancelRequested/leaseValid 决策),不抛;其余非 2xx 抛。
         if (!res.ok && res.status !== 409)
             throw new Error(`POST /v1/images/bakes/:id/ingest → HTTP ${res.status}: ${JSON.stringify(body)}`);
         return body;
     }
+    /** GET /v1/images/bakes/:id/events — 烧制实况 SSE(§P2.2,run-trace-SSE 同形;resumable,`id:` 行=事件 seq,
+     *  Last-Event-ID 续传)。开集帧——按 event 分派,未知帧泛渲不崩;终态帧 = `done`/`error`。operator-only。 */
     async *events(bakeId, opts) {
         let first = opts?.lastEventId;
         const frames = parseFrameStream((lastEventId) => {
@@ -88,8 +114,8 @@ export class BakesResource {
         }, (f) => f.event === "done" || f.event === "error", opts?.signal ? { signal: opts.signal } : undefined);
         for await (const f of frames) {
             if (f.event === "heartbeat" || !f.data)
-                continue;
-            const data = JSON.parse(f.data);
+                continue; // keep-alive/comment beats swallowed (trace.stream 同款)
+            const data = JSON.parse(f.data); // SyntaxError = contract breach → rethrown by reader
             const ev = { event: f.event ?? "message", data };
             if (f.id)
                 ev.id = f.id;

package/dist/resources/images.js.map

@@ -1 +1 @@
-{"version":3,"file":"images.js","sourceRoot":"","sources":["../../src/resources/images.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../../src/resources/images.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG7C,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAE7C;0FACsF;IACtF,KAAK,CAAC,IAAI,CAAC,IAQV;QACC,MAAM,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC;QAChC,IAAI,IAAI,EAAE,OAAO;YAAE,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,IAAI,EAAE,UAAU;YAAE,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3D,IAAI,IAAI,EAAE,MAAM;YAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,IAAI,EAAE,MAAM;YAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,IAAI,EAAE,KAAK,KAAK,SAAS;YAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAClE,IAAI,IAAI,EAAE,MAAM;YAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1G,CAAC;IAED;;yEAEqE;IACrE,KAAK,CAAC,MAAM,CAAC,IAA8E;QACzF,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC;QACpC,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,QAAQ,CAAC,IAA6B,EAAE,IAA+B;QAC3E,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACrG,CAAC;IAED,0FAA0F;IAC1F,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,IAA+B;QAC9D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACpH,CAAC;IAED,+FAA+F;IAC/F,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,IAA+B;QAC5D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,sBAAsB,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3H,CAAC;CACF;AAED;;sEAEsE;AACtE,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAE7C;gGAC4F;IAC5F,KAAK,CAAC,MAAM,CAAC,IAA6B,EAAE,IAA+B;QACzE,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAClG,CAAC;IAED;+CAC2C;IAC3C,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,IAA+B;QACvD,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,oBAAoB,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACzH,CAAC;IAED;kEAC8D;IAC9D,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,IAA+B;QAC1D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3I,CAAC;IAED;0GACsG;IACtG,KAAK,CAAC,SAAS,CAAC,IAA4B,EAAE,IAA+B;QAC3E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,kBAAkB,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7M,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,CAAC,sCAAsC;QAC3E,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,CAAC,MAAM,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtG,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAc,CAAC;IACzC,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,IAA4B,EAAE,IAA+B;QACvF,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAClJ,CAAC;IAED;;2GAEuG;IACvG,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,YAAoB,EAAE,IAA6B,EAAE,IAA+B;QAC/G,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YAC/B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,oBAAoB,kBAAkB,CAAC,MAAM,CAAC,SAAS;YAC7D,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC7B,WAAW,EAAE,kBAAkB;YAC/B,OAAO,EAAE,EAAE,sBAAsB,EAAE,YAAY,EAAE;YACjD,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA+F,CAAC;QAC9H,oFAAoF;QACpF,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrI,OAAO,IAAI,CAAC;IACd,CAAC;IAED;wFACoF;IACpF,KAAK,CAAC,CAAC,MAAM,CAAC,MAAc,EAAE,IAAqD;QACjF,IAAI,KAAK,GAAG,IAAI,EAAE,WAAW,CAAC;QAC9B,MAAM,MAAM,GAAG,gBAAgB,CAC7B,CAAC,WAAW,EAAE,EAAE;YACd,MAAM,EAAE,GAAG,WAAW,IAAI,KAAK,CAAC;YAChC,KAAK,GAAG,SAAS,CAAC;YAClB,MAAM,CAAC,GAA2C,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,oBAAoB,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACnI,IAAI,EAAE;gBAAE,CAAC,CAAC,WAAW,GAAG,EAAE,CAAC;YAC3B,IAAI,IAAI,EAAE,MAAM;gBAAE,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YACzC,OAAO,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC,EACD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO,EAChD,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CACnD,CAAC;QACF,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YAC7B,IAAI,CAAC,CAAC,KAAK,KAAK,WAAW,IAAI,CAAC,CAAC,CAAC,IAAI;gBAAE,SAAS,CAAC,uDAAuD;YACzG,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAA4B,CAAC,CAAC,qDAAqD;YACjH,MAAM,EAAE,GAAkE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,SAAS,EAAE,IAAI,EAAE,CAAC;YAChH,IAAI,CAAC,CAAC,EAAE;gBAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;YACvB,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC;CACF"}

package/dist/resources/leader.d.ts

@@ -1,8 +1,17 @@
+/** leader — the **v2 leader pipeline** (E2B workers + git push). POST /v1/leader → 202 / GET /v1/leader/:id.
+ *  🔴 NOT door B's brain. Gated server-side (`LEADER_ENABLED` + `REMOTE_EXEC=e2b`, both default OFF). Its mode is a
+ *  SERVER deploy flag, not a client choice: `LEADER_FANOUT_ENABLED=true` (default) = router can fan out to N workers
+ *  (= the value-HOLD correctness path); `=false` pins a deterministic single worker. **Door B's brain is the strong
+ *  single agent via `/v1/tasks`+`/v1/runs`+`scenario`** (live today); planner-light currently lives only inside this
+ *  leader router (and its decompose = N-worker fan-out). See DIRECTION §1. Keep this v2/optional. */
 import type { Transport } from "../transport.js";
 import type { LeaderReceipt, LeaderRecord } from "../types.js";
 export declare class LeaderResource {
     private readonly t;
     constructor(t: Transport);
+    /** POST /v1/leader → 202 receipt(server.ts:3429 区实拆:同 /v1/runs 的身份门——REQUIRE_PRINCIPAL 下
+     *  验证主体 401 先行,记录为 run owner;限速/配额/lease 门同任务提交)。LEADER_ENABLED 关闭时 404/501
+     *  由 server leaderEndpoint 决定。(SDK 全覆盖批 2026-07-17:原 TODO(M3+) 桩接线。) */
     create(req: {
         objective: string;
         sessionId?: string;
@@ -12,6 +21,7 @@ export declare class LeaderResource {
         idempotencyKey?: string | null;
         signal?: AbortSignal;
     }): Promise<LeaderReceipt>;
+    /** GET /v1/leader/:id — leader run 记录(非 owner=404 无 oracle)。 */
     get(leaderRunId: string, opts?: {
         signal?: AbortSignal;
     }): Promise<LeaderRecord>;

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

@@ -1 +1 @@
-{"version":3,"file":"leader.d.ts","sourceRoot":"","sources":["../../src/resources/leader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAKnC,MAAM,CAAC,GAAG,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EAAE,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAKrL,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CAGvF"}
+{"version":3,"file":"leader.d.ts","sourceRoot":"","sources":["../../src/resources/leader.ts"],"names":[],"mappings":"AAAA;;;;;qGAKqG;AACrG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC;;4EAEwE;IAClE,MAAM,CAAC,GAAG,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EAAE,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAI3L,gEAAgE;IAC1D,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CAGvF"}

package/dist/resources/leader.js

@@ -3,9 +3,13 @@ export class LeaderResource {
     constructor(t) {
         this.t = t;
     }
+    /** POST /v1/leader → 202 receipt(server.ts:3429 区实拆:同 /v1/runs 的身份门——REQUIRE_PRINCIPAL 下
+     *  验证主体 401 先行,记录为 run owner;限速/配额/lease 门同任务提交)。LEADER_ENABLED 关闭时 404/501
+     *  由 server leaderEndpoint 决定。(SDK 全覆盖批 2026-07-17:原 TODO(M3+) 桩接线。) */
     async create(req, opts) {
         return this.t.request({ method: "POST", path: "/v1/leader", body: req, idempotencyKey: opts?.idempotencyKey, signal: opts?.signal });
     }
+    /** GET /v1/leader/:id — leader run 记录(非 owner=404 无 oracle)。 */
     async get(leaderRunId, opts) {
         return this.t.request({ method: "GET", path: `/v1/leader/${encodeURIComponent(leaderRunId)}`, signal: opts?.signal });
     }

package/dist/resources/leader.js.map

@@ -1 +1 @@
-{"version":3,"file":"leader.js","sourceRoot":"","sources":["../../src/resources/leader.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAK7C,KAAK,CAAC,MAAM,CAAC,GAAoF,EAAE,IAA+D;QAChK,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACvI,CAAC;IAGD,KAAK,CAAC,GAAG,CAAC,WAAmB,EAAE,IAA+B;QAC5D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,kBAAkB,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACxH,CAAC;CACF"}
+{"version":3,"file":"leader.js","sourceRoot":"","sources":["../../src/resources/leader.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAE7C;;4EAEwE;IACxE,KAAK,CAAC,MAAM,CAAC,GAAoF,EAAE,IAA+D;QAChK,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACvI,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,GAAG,CAAC,WAAmB,EAAE,IAA+B;QAC5D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,kBAAkB,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACxH,CAAC;CACF"}

package/dist/resources/memory.d.ts

@@ -1,30 +1,62 @@
+/** memory — the user's `<user_memory>` transparency surface (LIVE, service 170c384).
+ *  Owner-scoped BY CONSTRUCTION: the scope derives from the request principal (same rule as task execution),
+ *  so a caller cannot address anyone else's memory. No principal header → 401. Check capabilities().memory.
+ *
+ *  ⚠️ 2026-07 server 现状(SDK 全覆盖批盘点):legacy MemoryStore 面已随 store 下线——server capabilities
+ *  硬编码 `memory:false`/`memoryWrite:false`(server.ts:1333),下方五个 legacy 动词(get/clear/append/
+ *  update/remove)对现行 server 恒 404/501,仅为旧部署兼容保留,均已 @deprecated。现行记忆面 =
+ *  memory-engine(DB twins):{@link exportScope}(GET /v1/memory/export)+ {@link sync}
+ *  (POST /v1/memory/sync/:scope)。 */
 import type { Transport } from "../transport.js";
 import type { MemoryRecord, MemoryWriteAck } from "../types.js";
 export declare class MemoryResource {
     private readonly t;
     constructor(t: Transport);
+    /** GET /v1/memory — read your own memory (content null = empty).
+     *  @deprecated legacy MemoryStore 面已在 server 下线(capabilities memory:false)——现行 server 恒不可用。 */
     get(opts?: {
         signal?: AbortSignal;
     }): Promise<MemoryRecord>;
+    /** DELETE /v1/memory — clear the WHOLE scope (per-entry deletion is a future additive).
+     *  Not a submit → no SDK retry.
+     *  @deprecated legacy MemoryStore 面已在 server 下线(capabilities memory:false)——现行 server 恒不可用。 */
     clear(opts?: {
         signal?: AbortSignal;
     }): Promise<{
         ok: boolean;
         scope: string;
     }>;
+    /** MF-30 append a note — POST /v1/sessions/:id/memory {content} → `{ok,id,scope}` (unified shape; service:
+     *  the old src:2880 summary comment dropped `ok` by mistake, the handler always returned it — code-authoritative).
+     *  🔴 per-PRINCIPAL not per-session: the `:id` is only the shell's addressing context; the note is visible from
+     *  ALL the caller's sessions. `content` stored VERBATIM (≤8 KiB, user-authored → NOT redacted); empty/oversized → 400.
+     *  Always available when `capabilities().memoryWrite`. Not idempotent → no SDK retry.
+     *  @deprecated legacy MemoryStore 面已在 server 下线(capabilities `memoryWrite:false`)——现行 server 恒不可用。
+     */
     append(sessionId: string, body: {
         content: string;
     }, opts?: {
         signal?: AbortSignal;
     }): Promise<MemoryWriteAck>;
+    /** MF-30 edit one note by id — PATCH /v1/sessions/:id/memory/:noteId {content} → `{ok,id,scope}` (id unchanged).
+     *  🔴 **501** when the backend lacks id-addressable update (honest degrade, never a fake 200). per-PRINCIPAL (see append).
+     *  @deprecated legacy MemoryStore 面已在 server 下线(capabilities `memoryWrite:false`)——现行 server 恒不可用。
+     */
     edit(sessionId: string, noteId: string, body: {
         content: string;
     }, opts?: {
         signal?: AbortSignal;
     }): Promise<MemoryWriteAck>;
+    /** MF-30 forget one note by id — DELETE /v1/sessions/:id/memory/:noteId → `{ok,id,scope}`.
+     *  🔴 **501** when the backend lacks id-addressable delete. per-PRINCIPAL (see append). Not a submit → no SDK retry.
+     *  @deprecated legacy MemoryStore 面已在 server 下线(capabilities `memoryWrite:false`)——现行 server 恒不可用。
+     */
     remove(sessionId: string, noteId: string, opts?: {
         signal?: AbortSignal;
     }): Promise<MemoryWriteAck>;
+    /** GET /v1/memory/export?scope= — 按 scope 导出记忆引擎条目(server.ts:4480 实拆;memory-engine DB twins 面)。
+     *  `{ scope, exportedAt, entries }`。owner 门:scope 必须=本人 user 盘或 explicit operator(否则 404 无
+     *  oracle);file 形态/未接 memoryExport = 501 诚实。 */
     exportScope(scope: string, opts?: {
         signal?: AbortSignal;
     }): Promise<{
@@ -33,6 +65,11 @@ export declare class MemoryResource {
         entries: unknown[];
         [k: string]: unknown;
     }>;
+    /** POST /v1/memory/sync/:scope — 中枢侧记忆 sync 入站半场(142-S2.5;server.ts:4517 实拆)。:scope 走
+     *  percent-encoding(scope 键含 `:`/`@`/`/`);门序=auth 401 → 后端形态 501(file=TOC 自身,无中心半场)
+     *  → owner 门 404 无 oracle → 验型 422 typed。500=applyPatches 可能已落库而 cursor 未推进——**按同一
+     *  baseRevs 重放即幂等自愈**(identical revs 全程 no-op),绝不静默吞。body/响应形=core memory-sync 契约
+     *  (开集透传;真源在 core reconcile/nextSyncBaseline 纯函数)。 */
     sync(scope: string, body: Record<string, unknown>, opts?: {
         signal?: AbortSignal;
     }): Promise<Record<string, unknown>>;

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

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/resources/memory.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAInC,GAAG,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAO3D,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAW/E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAa9G,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAa5H,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAWnG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,EAAE,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IASrJ,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAG5H"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/resources/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;qCAQqC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC;mGAC+F;IACzF,GAAG,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAIjE;;mGAE+F;IACzF,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAIrF;;;;;;OAMG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IASpH;;;OAGG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IASlI;;;OAGG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAQzG;;oDAEgD;IAC1C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,EAAE,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAI3J;;;;0DAIsD;IAChD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAG5H"}

package/dist/resources/memory.js

@@ -3,12 +3,24 @@ export class MemoryResource {
     constructor(t) {
         this.t = t;
     }
+    /** GET /v1/memory — read your own memory (content null = empty).
+     *  @deprecated legacy MemoryStore 面已在 server 下线(capabilities memory:false)——现行 server 恒不可用。 */
     async get(opts) {
         return this.t.request({ method: "GET", path: "/v1/memory", signal: opts?.signal });
     }
+    /** DELETE /v1/memory — clear the WHOLE scope (per-entry deletion is a future additive).
+     *  Not a submit → no SDK retry.
+     *  @deprecated legacy MemoryStore 面已在 server 下线(capabilities memory:false)——现行 server 恒不可用。 */
     async clear(opts) {
         return this.t.request({ method: "DELETE", path: "/v1/memory", signal: opts?.signal });
     }
+    /** MF-30 append a note — POST /v1/sessions/:id/memory {content} → `{ok,id,scope}` (unified shape; service:
+     *  the old src:2880 summary comment dropped `ok` by mistake, the handler always returned it — code-authoritative).
+     *  🔴 per-PRINCIPAL not per-session: the `:id` is only the shell's addressing context; the note is visible from
+     *  ALL the caller's sessions. `content` stored VERBATIM (≤8 KiB, user-authored → NOT redacted); empty/oversized → 400.
+     *  Always available when `capabilities().memoryWrite`. Not idempotent → no SDK retry.
+     *  @deprecated legacy MemoryStore 面已在 server 下线(capabilities `memoryWrite:false`)——现行 server 恒不可用。
+     */
     async append(sessionId, body, opts) {
         return this.t.request({
             method: "POST",
@@ -17,6 +29,10 @@ export class MemoryResource {
             signal: opts?.signal,
         });
     }
+    /** MF-30 edit one note by id — PATCH /v1/sessions/:id/memory/:noteId {content} → `{ok,id,scope}` (id unchanged).
+     *  🔴 **501** when the backend lacks id-addressable update (honest degrade, never a fake 200). per-PRINCIPAL (see append).
+     *  @deprecated legacy MemoryStore 面已在 server 下线(capabilities `memoryWrite:false`)——现行 server 恒不可用。
+     */
     async edit(sessionId, noteId, body, opts) {
         return this.t.request({
             method: "PATCH",
@@ -25,6 +41,10 @@ export class MemoryResource {
             signal: opts?.signal,
         });
     }
+    /** MF-30 forget one note by id — DELETE /v1/sessions/:id/memory/:noteId → `{ok,id,scope}`.
+     *  🔴 **501** when the backend lacks id-addressable delete. per-PRINCIPAL (see append). Not a submit → no SDK retry.
+     *  @deprecated legacy MemoryStore 面已在 server 下线(capabilities `memoryWrite:false`)——现行 server 恒不可用。
+     */
     async remove(sessionId, noteId, opts) {
         return this.t.request({
             method: "DELETE",
@@ -32,9 +52,17 @@ export class MemoryResource {
             signal: opts?.signal,
         });
     }
+    /** GET /v1/memory/export?scope= — 按 scope 导出记忆引擎条目(server.ts:4480 实拆;memory-engine DB twins 面)。
+     *  `{ scope, exportedAt, entries }`。owner 门:scope 必须=本人 user 盘或 explicit operator(否则 404 无
+     *  oracle);file 形态/未接 memoryExport = 501 诚实。 */
     async exportScope(scope, opts) {
         return this.t.request({ method: "GET", path: `/v1/memory/export?scope=${encodeURIComponent(scope)}`, signal: opts?.signal });
     }
+    /** POST /v1/memory/sync/:scope — 中枢侧记忆 sync 入站半场(142-S2.5;server.ts:4517 实拆)。:scope 走
+     *  percent-encoding(scope 键含 `:`/`@`/`/`);门序=auth 401 → 后端形态 501(file=TOC 自身,无中心半场)
+     *  → owner 门 404 无 oracle → 验型 422 typed。500=applyPatches 可能已落库而 cursor 未推进——**按同一
+     *  baseRevs 重放即幂等自愈**(identical revs 全程 no-op),绝不静默吞。body/响应形=core memory-sync 契约
+     *  (开集透传;真源在 core reconcile/nextSyncBaseline 纯函数)。 */
     async sync(scope, body, opts) {
         return this.t.request({ method: "POST", path: `/v1/memory/sync/${encodeURIComponent(scope)}`, body, signal: opts?.signal });
     }

package/dist/resources/memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/resources/memory.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAI7C,KAAK,CAAC,GAAG,CAAC,IAA+B;QACvC,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAe,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACnG,CAAC;IAKD,KAAK,CAAC,KAAK,CAAC,IAA+B;QACzC,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAiC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACxH,CAAC;IASD,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,IAAyB,EAAE,IAA+B;QACxF,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAiB;YACpC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,SAAS;YAC5D,IAAI;YACJ,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAMD,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,MAAc,EAAE,IAAyB,EAAE,IAA+B;QACtG,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAiB;YACpC,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,WAAW,kBAAkB,CAAC,MAAM,CAAC,EAAE;YAC1F,IAAI;YACJ,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAMD,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,MAAc,EAAE,IAA+B;QAC7E,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAiB;YACpC,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,WAAW,kBAAkB,CAAC,MAAM,CAAC,EAAE;YAC1F,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAKD,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,IAA+B;QAC9D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,2BAA2B,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/H,CAAC;IAOD,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,IAA6B,EAAE,IAA+B;QACtF,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9H,CAAC;CACF"}
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/resources/memory.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAE7C;mGAC+F;IAC/F,KAAK,CAAC,GAAG,CAAC,IAA+B;QACvC,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAe,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACnG,CAAC;IAED;;mGAE+F;IAC/F,KAAK,CAAC,KAAK,CAAC,IAA+B;QACzC,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAiC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACxH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,IAAyB,EAAE,IAA+B;QACxF,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAiB;YACpC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,SAAS;YAC5D,IAAI;YACJ,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,MAAc,EAAE,IAAyB,EAAE,IAA+B;QACtG,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAiB;YACpC,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,WAAW,kBAAkB,CAAC,MAAM,CAAC,EAAE;YAC1F,IAAI;YACJ,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,MAAc,EAAE,IAA+B;QAC7E,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAiB;YACpC,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,WAAW,kBAAkB,CAAC,MAAM,CAAC,EAAE;YAC1F,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;oDAEgD;IAChD,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,IAA+B;QAC9D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,2BAA2B,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/H,CAAC;IAED;;;;0DAIsD;IACtD,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,IAA6B,EAAE,IAA+B;QACtF,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9H,CAAC;CACF"}

package/dist/resources/models.d.ts

@@ -1,8 +1,20 @@
+/** models — `@model` 切换的**只读**模型目录（service `GET /v1/models`,server.ts:535;core 1.116 `@model` mention 线）。
+ *
+ *  用户用 **`@<name>`** 在消息正文里 per-task 选已配置模型（service `parseModelMention` 解析,main.ts:718;
+ *  无 mention → `default` 角色）。本资源给 client 列**可选模型名**（autocomplete/picker 用),让用户知道能 @ 谁。
+ *
+ *  🔴 **非密钥**:只返 name/id/provider/reasoning/vision,**绝不** baseUrl/apiKey/headers（service 侧已剥,server.ts:531-534）。
+ *  🔴 **只读 + 不是绑定凭证**:切换靠用户在正文打 `@name`（service 内部 allowlist 解析,client 不重算/不注入 Model 对象）。
+ *     `default` 内部别名 service 已隐藏（fallback ref,非用户可选）。 */
 import type { Transport } from "../transport.js";
 import type { ModelInfo } from "../types.js";
 export declare class ModelsResource {
     private readonly t;
     constructor(t: Transport);
+    /** GET /v1/models — 非密钥模型目录。信封 `{models, default}`（`default`=部署默认模型 id,仅展示用）。
+     *  filter 无（目录小、全列）;失败由 caller fail-safe（空目录 → picker 不显,同 images 范式）。
+     *  每条 `ModelInfo` 现带 E4 `contextWindow`/`maxOutputTokens`（%-上下文仪表分母）+ E7 `supportedEffortLevels`
+     *  （`/effort` picker 选项,仅 reasoning 模型）—— 均 SHIPPED 自 service,soft-degrade（未知则缺）。 */
     list(opts?: {
         signal?: AbortSignal;
     }): Promise<{

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

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/resources/models.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAMnC,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAG/F"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/resources/models.ts"],"names":[],"mappings":"AAAA;;;;;;;yDAOyD;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC;;;yFAGqF;IAC/E,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAG/F"}

package/dist/resources/models.js

@@ -3,6 +3,10 @@ export class ModelsResource {
     constructor(t) {
         this.t = t;
     }
+    /** GET /v1/models — 非密钥模型目录。信封 `{models, default}`（`default`=部署默认模型 id,仅展示用）。
+     *  filter 无（目录小、全列）;失败由 caller fail-safe（空目录 → picker 不显,同 images 范式）。
+     *  每条 `ModelInfo` 现带 E4 `contextWindow`/`maxOutputTokens`（%-上下文仪表分母）+ E7 `supportedEffortLevels`
+     *  （`/effort` picker 选项,仅 reasoning 模型）—— 均 SHIPPED 自 service,soft-degrade（未知则缺）。 */
     async list(opts) {
         return this.t.request({ method: "GET", path: "/v1/models", signal: opts?.signal });
     }

package/dist/resources/models.js.map

@@ -1 +1 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/resources/models.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAM7C,KAAK,CAAC,IAAI,CAAC,IAA+B;QACxC,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACrF,CAAC;CACF"}
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/resources/models.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAE7C;;;yFAGqF;IACrF,KAAK,CAAC,IAAI,CAAC,IAA+B;QACxC,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACrF,CAAC;CACF"}