@sema-agent/sdk 24.0.0 → 26.0.0

package/dist/resources/ops.d.ts

@@ -140,4 +140,117 @@ export declare class WiringDiagnosticsResource {
         signal?: AbortSignal;
     }): Promise<WiringDiagnostics>;
 }
+/**
+ * 配置目录里一根旋钮的**中心座**(`GET /v1/config/catalog` 行的 `center`;server `ConfigCatalogRowCenter`):这个键能不能由配置中心发布、谁压谁、何时生效。
+ * 只在**有中心座位**的行上在场(没有 ⇒ 键缺席,不是 `null`)。
+ */
+export interface ConfigCatalogRowCenter {
+    /** 中心配置域名。 */
+    domain: string;
+    /** 域内路径(`a.b` 逐段进对象;`xs[].c` = 进数组元素)。 */
+    path: string;
+    /** 谁压谁:`center-wins` = 中心发布的压 env;`env-wins` = 本机 env 占位压中心。 */
+    precedence: "center-wins" | "env-wins" | (string & {});
+    /** 中心写入何时生效(不含 `deploy`:那是 env 腿的统一时机)。 */
+    timing: "hot" | "restart" | "inert" | (string & {});
+    /** `timing: "restart"` 时落在哪个重启切片(开集)。 */
+    restartSlice?: string;
+    /** 为什么要重启(人读)。 */
+    restartReason?: string;
+    /** 中心最近一份 effective **当前在管**本键(没有配置管道 ⇒ 恒 `false`)。 */
+    managedNow: boolean;
+    /** 中心写**现在真的在生效**(在管 ∧ 未被 env 占位压住)。 */
+    effectiveNow: boolean;
+}
+/**
+ * 配置目录的**一行**(`GET /v1/config/catalog` 的 `rows[]`;server `ConfigCatalogRow`):一根部署旋钮(env 名)的静态声明 + 本进程的实算读数。
+ * 🔴 **`effectiveValue` 是本进程的展示值,不是原始 env**:`secret` / `opaque` 行只给 `{ present, length? }`;`url` 行经展示铸点(userinfo 落地、query 每个值成记号);
+ * 两个**判词位**(`effectiveValueInvalid` / `effectiveValueWithheld`)是同一族的只取真值的可选键 —— 在场 ⇔ 为真,**缺席 = 这一格没有这件事**(不是「不知道」),恒不铸 `false`。
+ */
+export interface ConfigCatalogRow {
+    /** 旋钮名(env 名;目录按名排序)。 */
+    name: string;
+    /** 配置九组之一(`store` / `modelPlane` / `approval` / `memory` / `auth` / `orchestration` / `limitsHttp` / `observability` / `integrations`;**开集读**)。 */
+    domain: string;
+    /** 值类型:`boolean` / `number` / `string` / `enum` / `csv` / `json` / `path` / `url` / `secret` / `opaque`(**开集读**)。 */
+    type: string;
+    /** 语义句(以读取点实现为准;人读)。 */
+    semantics: string;
+    /** 这根键能从哪些腿写:`env` / `center`。 */
+    writeLanes: Array<"env" | "center">;
+    /** 当前**实际生效**的是哪条腿。 */
+    effectiveLane: "env" | "center" | "default" | (string & {});
+    /** 本机 env 是否占位(显式设了)。 */
+    envHeld: boolean;
+    /** env 腿的生效时机:`deploy`(改 env = 改部署面)/ `inert`(退役或零消费键)。 */
+    envTiming: "deploy" | "inert" | (string & {});
+    /** 静态缺省(人读文本)。 */
+    staticDefault?: string;
+    /** 缺省按装配结果派生时的说明。 */
+    derivedDefaultNote?: string;
+    /** 本进程实算的**展示值**:标量 / 词表 / `null`(未设)/ `{ present, length? }`(`secret` / `opaque` 行:只报在场与长度)。 */
+    effectiveValue: string | number | boolean | string[] | null | {
+        present: boolean;
+        length?: number;
+    };
+    /** `plain` = 可回显;`secret` / `opaque` = 值不上 wire。 */
+    valueClass: "plain" | "secret" | "opaque" | (string & {});
+    /** 改错的危险轴:`security` / `billing` / `data`(开集读)。 */
+    danger: string[];
+    /** 中心座(有座位的行才有)。 */
+    center?: ConfigCatalogRowCenter;
+    centerDomain?: string;
+    centerPath?: string;
+    /** `bootstrap-only` = 只在起服那一刻读。 */
+    scope?: "bootstrap-only" | (string & {});
+    /** `enum` 行的可写词集。 */
+    enumValues?: string[];
+    /** 判词位:本行实算值落在它自己宣告的回显闭集之外 ⇒ `true`(此时 `effectiveValue` 恒 `null`:回显集外值等于教消费方写一个写回去就非法的词)。**只记真,缺席 = 没有这件事**。只服务 `enum` 行。 */
+    effectiveValueInvalid?: true;
+    /**
+     * 判词位(server ≥7.133.0):`type: "url"` 行的展示铸点对这一格(单值)或列表中的任一项判了**扣下** —— 位置律本会显示的那一段(整段 query / 一个路径段)里有一条**凭据形**,所以不出门。
+     * 判决的属主是展示铸点,目录不另判。**只记真,缺席 = 没扣**(老 server 同缺席);标准位置律(userinfo 落地、query 每个值成记号)对每一行同样成立,**不是**扣下;值整只成占位 =
+     * 这一行的展示律显示不了这个值(不是层级式 URL / 代理行的展示律更窄),也不是本位。目录页 / `sema config show` 据它标出「这一行的值有一部分被扣下」,别把扣下读成「值就是那样」。
+     */
+    effectiveValueWithheld?: true;
+}
+/** 墓碑 env(`GET /v1/config/catalog` 的 `retired[]`):本进程起服**会拒**的旧名(契约包 `RETIRED_ENVS` 的 wire 投影;一个名字不会同时在 `rows` 与这里)。 */
+export interface ConfigCatalogRetiredEnv {
+    name: string;
+    /** `renamed`(只带 `replacement`)/ `replaced`(`replacement` + `reason`:值语义怎么变了)/ `removed`(只带 `reason`:能力为什么没了)。 */
+    kind: "renamed" | "replaced" | "removed" | (string & {});
+    replacement?: string;
+    reason?: string;
+}
+/**
+ * `GET /v1/config/catalog` 的 200 体(operator lane;server `ConfigCatalogWire`):部署配置目录 —— 每根 env 旋钮的声明与本进程实算。
+ * 🔴 **operator-only**:名单外 403 `auth.operator_only`;空名单 ∧ 多租户形 501 `capability.operator_principals_required`;`CONFIG_CATALOG_ENABLED=false` 501 `feature.config_catalog_disabled`
+ * (先探 `capabilities.configCatalog`)。`Cache-Control: no-store`。
+ */
+export interface ConfigCatalog {
+    catalogVersion: 1;
+    /** env 腿的统一时机(env 运行期不可变 ⇒ 改 env = 改部署面)。 */
+    envLaneTiming: "deploy" | (string & {});
+    /** 中心写入可落的重启切片名册(开集读)。 */
+    restartSlices: string[];
+    /** 契约包的中心配置域名单。 */
+    centerDomains: string[];
+    summary: {
+        total: number;
+        envHeld: number;
+        secret: number;
+        centerManaged: number;
+    };
+    rows: ConfigCatalogRow[];
+    /** 起服会拒的退役 env 名单(恒在场,可为空)。 */
+    retired: ConfigCatalogRetiredEnv[];
+}
+/** `GET /v1/config/catalog` —— 部署配置目录读口(operator lane;门与拒码见 {@link ConfigCatalog})。老 server(<7.53)整条路由不存在 ⇒ 404 `not_found.route`,按「面不在」处置。 */
+export declare class ConfigCatalogResource {
+    private readonly t;
+    constructor(t: Transport);
+    get(opts?: {
+        signal?: AbortSignal;
+    }): Promise<ConfigCatalog>;
+}
 //# sourceMappingURL=ops.d.ts.map

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

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

package/dist/resources/ops.js

@@ -96,4 +96,14 @@ export class WiringDiagnosticsResource {
         return this.t.request({ method: "GET", path: "/v1/diagnostics/wiring", signal: opts?.signal });
     }
 }
+/** `GET /v1/config/catalog` —— 部署配置目录读口(operator lane;门与拒码见 {@link ConfigCatalog})。老 server(<7.53)整条路由不存在 ⇒ 404 `not_found.route`,按「面不在」处置。 */
+export class ConfigCatalogResource {
+    t;
+    constructor(t) {
+        this.t = t;
+    }
+    async get(opts) {
+        return this.t.request({ method: "GET", path: "/v1/config/catalog", signal: opts?.signal });
+    }
+}
 //# sourceMappingURL=ops.js.map

package/dist/resources/ops.js.map

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

package/dist/resources/principal-inbox.d.ts

@@ -0,0 +1,62 @@
+/** principal-inbox — 跨主体投递(server ≥7.133.0;`POST /v1/principal-inbox/messages`):同一组织里的一位主体给另一位主体的**收件箱**投一封信。
+ *
+ *  🔴 **本面只有「投递」半场**(server 7.133.0 如实):信被追加进收件人的 `principal.inbox`,**本版没有被读走的 verb** —— 箱里至多留 {@link PRINCIPAL_INBOX_BOUND} 封未确认的信封,无人读走(读半场另案)。
+ *  🔴 **默认关**:没设 env `PRINCIPAL_INBOX_ASSISTANT` 的部署,这一口答 **501 `capability.unavailable`**(没有挂组织投递门);先探 `capabilities.principalInboxDelivery`(为真 ⟺ 这一口可用),别 trial-by-501。
+ *  老 server(≤7.132.x)没有这一口:路由级 404 `not_found.route`。
+ *
+ *  ── 门是什么、不是什么 ───────────────────────────────────────────────────────────────────────
+ *  一封跨主体的信**只因这只门把它追加进收件人的箱而存在**:成员判 → 铸信 → 箱上界 → 配额 → 追加,全在服务端一只门里一体完成,它只有两种答案 —— 一张回执,或四个拒码之一
+ *  ({@link ORG_DELIVERY_REFUSAL_CODES})。**发件人永远是你的已验身份**(`from` 不在请求体里:带 `from` 或任何未知键 ⇒ 400 `request.body_shape` + `unknownKeys`)。
+ *  判序(server 头注):发件人的**尝试界**(成没成都记一笔,先于成员判)→ **成员判**(含收件箱键判官)→ 铸信(发件人拼不进信封发件人位 ⇒ 同一句 `not_member`)→ 收件箱上界 → 配额扣额 → 追加。
+ *  被拒的投递不追加任何东西。
+ *
+ *  🔴 **SDK 不自动重试这一口**:每次尝试(含拼错收件人的)都吃发件人的尝试额度,重试只会更快撞 `rate_limited`;`rate_limited` 的重新尝试归调用方(固定整点窗,下面「配额」)。 */
+import type { Transport } from "../transport.js";
+/** `content` 的字符上限(server 常量;超了 400 `request.field_invalid`)。 */
+export declare const PRINCIPAL_INBOX_CONTENT_MAX_CHARS = 32000;
+/** 收件箱上界:在箱、未被消费方确认的信封数(满了 ⇒ 409 `org_delivery.inbox_full`)。与引擎同主体车道的 `maxQueuedPeerMessages` 缺省同值。 */
+export declare const PRINCIPAL_INBOX_BOUND = 50;
+/** 请求体(**闭集三键**;`from` 由服务端从已验身份铸,不能自带)。 */
+export interface PrincipalInboxMessage {
+    /** 收件人**主体串**(非空)。收件人必须与你同属一个组织(成员判读组织目录);判不过 ⇒ 404 `org_delivery.not_member`(与「查无此人」逐字节同体)。 */
+    to: string;
+    /** 信的正文(非空,至多 {@link PRINCIPAL_INBOX_CONTENT_MAX_CHARS} 字符)。 */
+    content: string;
+    /** 加急标(信封上的 `urgent` 位;缺席 = 普通)。 */
+    urgent?: boolean;
+}
+/** 200 回执:这封信被追加了。`receiptId` = 门铸的投递回执 id(uuidv7;信封上的 `gateReceiptId` 同值)。 */
+export interface PrincipalInboxReceipt {
+    receiptId: string;
+}
+/**
+ * 跨主体投递的**四个拒码**(server ≥7.133.0;闭集 = 引擎 `ORG_DELIVERY_REFUSAL_CODES`,每码一句定句 —— 句子给人看,**机器读码**,别匹配句子):
+ *  · `org_delivery.not_member`(**404**)—— 同一句、逐字节同体,覆盖六种成因:不同组织 / 查无此人 / 组织目录答不上来 / `to` 过不了主体形判 / **收件人当不了收件箱的键**(非良构 Unicode / 含控制字符 / 超宽)/
+ *    **发件人的 scope 拼不进信封的发件人位**。门**永远不是存在性探针**:你分辨不出是哪一种(新增的两臂:收件箱键判官与发件人位 —— 码不变);
+ *  · `org_delivery.rate_limited`(**429**)—— 三道界之一满了,**同一句**(不让你分辨出「收件人这一小时收了多少」):发件人每小时 **60 次尝试**(成没成都算,**拼错收件人也吃一次尝试**)·
+ *    同一对(你→收件人)每小时 **10 封** · 一位收件人每小时合计 **30 封**。窗是**固定整点**(一小时最多可到两倍:窗两侧各满额);额度写死、无旋钮;
+ *  · `org_delivery.inbox_full`(**409**)—— 收件人的箱已有 {@link PRINCIPAL_INBOX_BOUND} 封未确认信封(在吃配额**之前**判:满箱不烧你的额度);
+ *  · `org_delivery.recipient_tombstoned`(**410**)—— 收件人的箱处于预删除态(店的预删除码原样转出)。
+ * 其余 `request.field_invalid` / `request.body_shape` / 401 / 501 同别的口。
+ */
+export declare const ORG_DELIVERY_REFUSAL_CODES: readonly ["org_delivery.not_member", "org_delivery.rate_limited", "org_delivery.inbox_full", "org_delivery.recipient_tombstoned"];
+/** {@link ORG_DELIVERY_REFUSAL_CODES} 的成员型。 */
+export type OrgDeliveryRefusalCode = (typeof ORG_DELIVERY_REFUSAL_CODES)[number];
+/** 四码各自的 HTTP 状态(server 铸点;`not_member` 404 · `rate_limited` 429 · `inbox_full` 409 · `recipient_tombstoned` 410)。判据是码,**状态只是旁证**。 */
+export declare const ORG_DELIVERY_REFUSAL_STATUS: Readonly<Record<OrgDeliveryRefusalCode, number>>;
+/** `err` 是跨主体投递的拒(四码之一)—— 只按 `errorCode` 判(本包按码分派,从不按状态),结构化:带同名 `errorCode` 的对象一样读得出。
+ *  窄化只承诺判过的那一键(`{ errorCode }`),不承诺它是 `APIError`(要 `message` / `status` 先 `instanceof APIError`;与 `isToolApprovalNotPending` 同形)。 */
+export declare function isOrgDeliveryRefusal(err: unknown): err is {
+    errorCode: OrgDeliveryRefusalCode;
+};
+export declare class PrincipalInboxResource {
+    private readonly t;
+    constructor(t: Transport);
+    /** POST /v1/principal-inbox/messages — 给同组织的另一位主体的收件箱投一封信。门与拒码见模块头注与 {@link ORG_DELIVERY_REFUSAL_CODES};**不自动重试**。
+     *  401(无已验身份)· 400 `request.field_invalid`(非对象体 / `to` 空 / `content` 空或超 {@link PRINCIPAL_INBOX_CONTENT_MAX_CHARS} / `urgent` 非布尔)· 400 `request.body_shape`(带 `from` 或任何未知键,体带 `unknownKeys`)·
+     *  501 `capability.unavailable`(没挂投递门,探 `capabilities.principalInboxDelivery`)。 */
+    send(message: PrincipalInboxMessage, opts?: {
+        signal?: AbortSignal;
+    }): Promise<PrincipalInboxReceipt>;
+}
+//# sourceMappingURL=principal-inbox.d.ts.map

package/dist/resources/principal-inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"principal-inbox.d.ts","sourceRoot":"","sources":["../../src/resources/principal-inbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;iHAYiH;AACjH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,iEAAiE;AACjE,eAAO,MAAM,iCAAiC,QAAS,CAAC;AACxD,uGAAuG;AACvG,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,gGAAgG;IAChG,EAAE,EAAE,MAAM,CAAC;IACX,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,mIAK5B,CAAC;AACZ,+CAA+C;AAC/C,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF,sIAAsI;AACtI,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAKvF,CAAC;AAEH;qIACqI;AACrI,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI;IAAE,SAAS,EAAE,sBAAsB,CAAA;CAAE,CAG/F;AAED,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC;;uFAEmF;IAC7E,IAAI,CAAC,OAAO,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAQ5G"}

package/dist/resources/principal-inbox.js

@@ -0,0 +1,51 @@
+/** `content` 的字符上限(server 常量;超了 400 `request.field_invalid`)。 */
+export const PRINCIPAL_INBOX_CONTENT_MAX_CHARS = 32_000;
+/** 收件箱上界:在箱、未被消费方确认的信封数(满了 ⇒ 409 `org_delivery.inbox_full`)。与引擎同主体车道的 `maxQueuedPeerMessages` 缺省同值。 */
+export const PRINCIPAL_INBOX_BOUND = 50;
+/**
+ * 跨主体投递的**四个拒码**(server ≥7.133.0;闭集 = 引擎 `ORG_DELIVERY_REFUSAL_CODES`,每码一句定句 —— 句子给人看,**机器读码**,别匹配句子):
+ *  · `org_delivery.not_member`(**404**)—— 同一句、逐字节同体,覆盖六种成因:不同组织 / 查无此人 / 组织目录答不上来 / `to` 过不了主体形判 / **收件人当不了收件箱的键**(非良构 Unicode / 含控制字符 / 超宽)/
+ *    **发件人的 scope 拼不进信封的发件人位**。门**永远不是存在性探针**:你分辨不出是哪一种(新增的两臂:收件箱键判官与发件人位 —— 码不变);
+ *  · `org_delivery.rate_limited`(**429**)—— 三道界之一满了,**同一句**(不让你分辨出「收件人这一小时收了多少」):发件人每小时 **60 次尝试**(成没成都算,**拼错收件人也吃一次尝试**)·
+ *    同一对(你→收件人)每小时 **10 封** · 一位收件人每小时合计 **30 封**。窗是**固定整点**(一小时最多可到两倍:窗两侧各满额);额度写死、无旋钮;
+ *  · `org_delivery.inbox_full`(**409**)—— 收件人的箱已有 {@link PRINCIPAL_INBOX_BOUND} 封未确认信封(在吃配额**之前**判:满箱不烧你的额度);
+ *  · `org_delivery.recipient_tombstoned`(**410**)—— 收件人的箱处于预删除态(店的预删除码原样转出)。
+ * 其余 `request.field_invalid` / `request.body_shape` / 401 / 501 同别的口。
+ */
+export const ORG_DELIVERY_REFUSAL_CODES = Object.freeze([
+    "org_delivery.not_member",
+    "org_delivery.rate_limited",
+    "org_delivery.inbox_full",
+    "org_delivery.recipient_tombstoned",
+]);
+/** 四码各自的 HTTP 状态(server 铸点;`not_member` 404 · `rate_limited` 429 · `inbox_full` 409 · `recipient_tombstoned` 410)。判据是码,**状态只是旁证**。 */
+export const ORG_DELIVERY_REFUSAL_STATUS = Object.freeze({
+    "org_delivery.not_member": 404,
+    "org_delivery.rate_limited": 429,
+    "org_delivery.inbox_full": 409,
+    "org_delivery.recipient_tombstoned": 410,
+});
+/** `err` 是跨主体投递的拒(四码之一)—— 只按 `errorCode` 判(本包按码分派,从不按状态),结构化:带同名 `errorCode` 的对象一样读得出。
+ *  窄化只承诺判过的那一键(`{ errorCode }`),不承诺它是 `APIError`(要 `message` / `status` 先 `instanceof APIError`;与 `isToolApprovalNotPending` 同形)。 */
+export function isOrgDeliveryRefusal(err) {
+    const code = typeof err === "object" && err !== null ? err.errorCode : undefined;
+    return typeof code === "string" && ORG_DELIVERY_REFUSAL_CODES.includes(code);
+}
+export class PrincipalInboxResource {
+    t;
+    constructor(t) {
+        this.t = t;
+    }
+    /** POST /v1/principal-inbox/messages — 给同组织的另一位主体的收件箱投一封信。门与拒码见模块头注与 {@link ORG_DELIVERY_REFUSAL_CODES};**不自动重试**。
+     *  401(无已验身份)· 400 `request.field_invalid`(非对象体 / `to` 空 / `content` 空或超 {@link PRINCIPAL_INBOX_CONTENT_MAX_CHARS} / `urgent` 非布尔)· 400 `request.body_shape`(带 `from` 或任何未知键,体带 `unknownKeys`)·
+     *  501 `capability.unavailable`(没挂投递门,探 `capabilities.principalInboxDelivery`)。 */
+    async send(message, opts) {
+        return this.t.request({
+            method: "POST",
+            path: "/v1/principal-inbox/messages",
+            body: message,
+            signal: opts?.signal,
+        });
+    }
+}
+//# sourceMappingURL=principal-inbox.js.map

package/dist/resources/principal-inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"principal-inbox.js","sourceRoot":"","sources":["../../src/resources/principal-inbox.ts"],"names":[],"mappings":"AAeA,iEAAiE;AACjE,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAC;AACxD,uGAAuG;AACvG,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAiBxC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC;IACtD,yBAAyB;IACzB,2BAA2B;IAC3B,yBAAyB;IACzB,mCAAmC;CAC3B,CAAC,CAAC;AAIZ,sIAAsI;AACtI,MAAM,CAAC,MAAM,2BAA2B,GAAqD,MAAM,CAAC,MAAM,CAAC;IACzG,yBAAyB,EAAE,GAAG;IAC9B,2BAA2B,EAAE,GAAG;IAChC,yBAAyB,EAAE,GAAG;IAC9B,mCAAmC,EAAE,GAAG;CACzC,CAAC,CAAC;AAEH;qIACqI;AACrI,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,MAAM,IAAI,GAAG,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,CAAE,GAA+B,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9G,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAK,0BAAgD,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACtG,CAAC;AAED,MAAM,OAAO,sBAAsB;IACJ;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAE7C;;uFAEmF;IACnF,KAAK,CAAC,IAAI,CAAC,OAA8B,EAAE,IAA+B;QACxE,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAwB;YAC3C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,8BAA8B;YACpC,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/rules.d.ts

@@ -56,7 +56,7 @@
  * 是**相反**的结局 —— 显式写 `false` 才是关。⚠️ 连带后果(server boot 期为此专门加了休眠行审计):
  * 一台旧部署里因为旋钮关着而**躺着没生效**的持久规则,升到 7.12.0 之后会随默认 ON **一起激活**。
  * 车道还需真装配规则店 —— 旋钮与店缺一 ⇒ **四口全部** 501 `capability.rule_store_required`(→
- * {@link import("../errors.js").CapabilityUnavailableError}),同一条谓词也让审批帧上不带 `ruleSuggestions`。
+ * {@link import("../errors.js").CapabilityUnavailableError}),同一条谓词也让审批帧上不带 `ruleOffers`。
  * 🔴 **更正(6.14.0):旧文写「`/v1/capabilities` 上今天没有这一族的能力位」,已作废** ——
  * `capabilities.permissionRules` 就是这一位,且它与这台 server **所有**规则口的 501 是**同一条**谓词
  * (说 yes ⟺ 它有的那些口全都活,不是「有一口活」)。**按它 gate,别 trial-by-501**,更别按版本号猜。
@@ -233,10 +233,7 @@ export interface CcImportRedeemedMember {
  * `{persisted[], deduped[], skippedAtRedeem[], rev}` 自 server 7.46.0 起已不在 wire(本源=core 5.58.0
  * `redeemRuleBatch` members 表透传)——旧形读 `result.persisted.length` 恒 `undefined`(cli [4214] G1 案
  * 真根因)。本类型 2026-09-01 起按真 wire 描述;这是**类型面 staleness 修正**,不是行为变更。
- * ⚠️ **版本偏斜如实说**(codex R1-F3):本 verb 是 typed 透传,SDK 不归一两代 wire —— 打到 **<7.46.0**
- * 的 server 时,真回体仍是三桶形,按本类型读 `members` 得 `undefined`(与修前「新 server 上读
- * `persisted` 得 undefined」正好对偶,类型只能如实描述一代)。要跨两代请自行按
- * `"members" in result` 判别;server 支持底线的收束候发车裁定。
+ * (旧三桶形只在 **<7.46.0** 的 server 上,支持底线 7.52.0 之下 —— sdk 26.0.0 起支持面内只有这一代形,不必再按 `"members" in result` 判别。)
  */
 export interface CcImportResult {
     /** 逐候选的兑付结果(判别位 `status`;refused 不上 200 体 —— 见 {@link CcImportRedeemedMember} 顶注)。 */

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

@@ -1 +1 @@
-{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/resources/rules.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/resources/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,4DAA4D;AAC5D,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAEzF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;AAEpD,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B;iEAC6D;IAC7D,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,qBAAqB,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,kEAAkE;IAClE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B;;;;;;;OAOG;IACH,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAClE,cAAc;IACd,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,mCAAmC;IACnC,SAAS,EAAE;QAAE,YAAY,EAAE,iBAAiB,CAAC;QAAC,cAAc,EAAE,iBAAiB,CAAA;KAAE,CAAC;CACnF;AAED;oCACoC;AACpC,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,eAAe,CAAC;IACzB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAC;IACvB;uDACmD;IACnD,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,KAAK,EAAE,SAAS,CAAC;IACjB,2DAA2D;IAC3D,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,qDAAqD;IACrD,eAAe,EAAE,OAAO,CAAC;IACzB,iEAAiE;IACjE,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,sFAAsF;IACtF,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAwB;AACxB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,cAAc,CAAC;CACxB;AAID;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B;0CACsC;IACtC,QAAQ,EAAE,YAAY,CAAC;IACvB,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;IACb;iDAC6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,EAAE,cAAc,CAAC;IACtB;0CACsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACvD;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;CACpD;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB;qCACiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;0CAEsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;iBACa;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,QAAQ,EAAE,YAAY,CAAC;IACvB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb;iCAC6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED;;6DAE6D;AAC7D,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;AAIvD;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAE/D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,QAAQ,EAAE,iBAAiB,CAAC;IAC5B;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;8EAC0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd;6EACyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,eAAe;AACzB,gCAAgC;AAC9B;IACE;;;;mCAI+B;IAC/B,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAC9B,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IAC3C;;;;;;;;;;;;;;OAcG;IACH,IAAI,EAAE,aAAa,CAAC;CACrB;AACH;;;;;;;;;;;;;;;;;;sDAkBsD;GACpD;IACE;kDAC8C;IAC9C,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAC9B,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ;8DAC0D;IAC1D,SAAS,EAAE,OAAO,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;CAC5C,CAAC;AAEN,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC;;;;;;;;yDAQqD;IAC/C,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAS/G;;;;;;;yDAOqD;IAC/C,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IASpG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAc7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6DG;IACG,KAAK,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAc/F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAcnG"}

package/dist/resources/rules.js.map

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

package/dist/resources/session-sync.d.ts

@@ -6,7 +6,7 @@
  *  🔴 server ≥7.116.0: the two file-history BLOB faces (`getHistoryBlob` / `putBlob`) have their own bit,
  *  `capabilities().sessionSyncFileHistory` — read it on BOTH ends; false on either ⇒ move the conversation only (no `fileHistory`, no blob PUT).
  *
- *  PULL  (read the cloud): manifest() → entries() (NDJSON) → getBlob() for the hashes the local peer lacks.
+ *  PULL  (read the cloud): manifest() → entries() (NDJSON) → getHistoryBlob() for the file-history blob hashes the local peer lacks.
  *  PUSH  (write the cloud): putBlob() the blobs the cloud lacks → import() Phase A → importEntries() Phase B.
  *  PLAN  (dry run): plan() classifies what a PUSH WOULD do, no write.
  *
@@ -34,13 +34,14 @@
  *  uuidv7 只留在有时间序语义的位上(`GET /v1/sendfile-links` 的 `before` 游标、提交体 `taskId` 幂等键)。server ≤7.124.x 的那三口只收 uuidv7(预设 v4 id 的会话建得出、同步得了、却 fork 不了),
  *  只有 sync 这一族是宽的。**消费端按码分支,别锚句子**(两代 server 的句子不同)。 */
 import type { Transport } from "../transport.js";
-import type { SessionManifest, SyncEntry, SyncSnapshot, FileHistoryExport, SessionRulesRecord, SyncAnchor, SyncRelation, ImportStaged, ImportCommitted } from "../types.js";
+import type { SessionManifest, SyncEntry, FileHistoryExport, SessionRulesRecord, SyncAnchor, SyncRelation, ImportStaged, ImportCommitted } from "../types.js";
 export declare class SessionSyncResource {
     private readonly t;
     constructor(t: Transport);
-    /** PULL — `GET …/sync/manifest` → the THIN cross-backend snapshot (entry IDS + per-snapshot relPath→blobHash +
-     *  policy + anchors + leaf), NO entry payloads and NO blob bytes (those stream / are content-addressed). The
-     *  server wraps it as `{ manifest }`; this unwraps to the bare {@link SessionManifest}. Feed `manifest.entryIds`
+    /** PULL — `GET …/sync/manifest` → the THIN cross-backend snapshot (entry IDS + the file-history envelope + policy + anchors + leaf),
+     *  NO entry payloads and NO blob bytes (those stream / are content-addressed). The
+     *  server wraps it as `{ manifest }` and this returns that envelope as-is — destructure it:
+     *  `const { manifest } = await client.sessions.sync.manifest(sessionId)`. Feed `manifest.entryIds`
      *  to `classifySyncRelationshipByIds` to decide fast-forward/fork BEFORE pulling the entry stream + only the
      *  blob hashes the local peer lacks. Owner-scoped (non-owner → 404, no oracle); 400 on an id that is not
      *  uuid-SHAPED (any uuid version passes — see the module header; a v4 legacy session is deliberately
@@ -66,25 +67,12 @@ export declare class SessionSyncResource {
      *  作用域判据 = 本会话的 per-edited-file **history 图**:cloud 只在「本会话 exportHistory 信封里某个版本的
      *  `blobHash` 引用这个 hash」时才发字节(外来/未引用 hash → 404 `not_found.blob`,绝不盲读 —— blob 跨会话
      *  共享,这道界是安全界)。SDK 本地先验 hash 形(非 64-hex ⇒ 400,零请求)。返回 `Uint8Array`。
-     *  server <7.52(区间地板 3.0.0 起)无此路由 ⇒ 404 `not_found.route`,请用 {@link getBlob} 的旧 PULL 臂。 */
+     *  ⚰️ ≤7.51 的旧 PULL 臂 `getBlob`(`…/sync/snapshots/:key/blobs/:hash`,per-snapshot 作用域)随整树快照纪元退出支持面,sdk 26.0.0 删。 */
     getHistoryBlob(sessionId: string, hash: string, opts?: {
         signal?: AbortSignal;
     }): Promise<Uint8Array>;
-    /** PULL one content-addressed blob's RAW bytes — `GET …/sync/snapshots/:key/blobs/:hash` (NOTE the PULL path is
-     *  scoped under the snapshot `:key`, NOT the bare `blobs/:hash` of the PUSH). The scope check is the security
-     *  boundary: a content-addressed blob is shared across sessions, so the cloud only serves a hash THIS session's
-     *  `:key` manifest references (a foreign/unreferenced hash → 404 `blob not found`). The SDK validates the hash
-     *  shape locally (400 `blob hash must be 64 lowercase-hex chars`). Returns the bytes as a `Uint8Array`.
-     *
-     *  @deprecated server ≥7.52(S-15/design/381):E19 整树快照纪元退役,这条 PULL 路由已摘
-     *  (404 `not_found.route`,spec 标 retired)——per-snapshot manifest key 作用域随纪元消失。
-     *  ≥7.52 用 {@link getHistoryBlob}(history 图作用域);本动词保留是因为支持区间地板 3.0.0 起
-     *  的老 server 仍活着这条路(删导出符号=major,且会封死对老 server 的合法读)。 */
-    getBlob(sessionId: string, key: string, hash: string, opts?: {
-        signal?: AbortSignal;
-    }): Promise<Uint8Array>;
-    /** PUSH one content-addressed blob INTO the cloud's snapshot store — `PUT …/sync/blobs/:hash` (the bare path; the
-     *  PULL is scoped under `snapshots/:key`). RAW bytes body, octet-stream. The cloud verifies sha256(body)===:hash
+    /** PUSH one content-addressed blob INTO the cloud's file-history store — `PUT …/sync/blobs/:hash` (the bare path; the
+     *  PULL is `…/sync/history/blobs/:hash`, scoped by the session's history graph). RAW bytes body, octet-stream. The cloud verifies sha256(body)===:hash
      *  (the content-address integrity guard) — a mismatch → 400 `blob hash mismatch`; the SDK validates the hash
      *  shape locally first. own-or-FRESH gate.
      *
@@ -98,10 +86,9 @@ export declare class SessionSyncResource {
      *
      *  A backend write failure (e.g. a MinIO non-2xx) → 502 `blob store write failed`. `openRaw` does **NOT** retry;
      *  the caller re-PUTs (the blob is content-addressed ⇒ idempotent). 204 on success (no body).
-     *  Call this for every blob hash the manifest references that the cloud lacks BEFORE import Phase A.
-     *  🔴 server ≥7.52(S-15 换店):501 `capability.snapshot_store_required` 的谓词变为「file-history 店无
-     *  blob 面」(`syncBlobFaces`/`putBlob` 缺席 —— local file 店即此形,message 点名 durable file-history
-     *  store);≤7.51 同码谓词是快照店缺席。码不变,部署处置同向(换有 blob 面的后端)。 */
+     *  Call this for every blob hash the manifest's `fileHistory` envelope references that the cloud lacks BEFORE import Phase A.
+     *  501 `capability.snapshot_store_required` = 这台部署的 file-history 店没有 blob 面(`syncBlobFaces` / `putBlob` 缺席 —— local file 店即此形,
+     *  message 点名 durable file-history store;能力位 `sessionSyncFileHistory === false`):换有 blob 面的后端,或只同步对话。 */
     putBlob(sessionId: string, hash: string, bytes: Uint8Array, opts?: {
         signal?: AbortSignal;
     }): Promise<void>;
@@ -116,13 +103,13 @@ export declare class SessionSyncResource {
     }, opts?: {
         signal?: AbortSignal;
     }): Promise<SyncRelation>;
-    /** ⚠️ S-15 纪元(server ≥7.52):Phase A 的真形收 `{entryIds, fileHistory?, policy, anchors, resolution?, logDigest?}` —— 本 verb 的 `snapshots` 键在 ≥7.52 上被**静默忽略**
-     *  (entries/policy/anchors/会话本体照常入店,**文件历史只经 `fileHistory` 入店**);≤7.51 老 server 照旧消费 `snapshots` 形。
+    /** Phase A 的体 = `{ entryIds, fileHistory?, policy, anchors, resolution?, logDigest?, title?, pinned? }`(文件历史只经 `fileHistory` 入店;
+     *  ⚰️ ≤7.51 那一代的 `snapshots` 键随整树快照纪元退出支持面,sdk 26.0.0 从本体型删 —— ≥7.52 本来就静默忽略它)。
      *  16.2.0 起 `body` 收 `fileHistory`({@link FileHistoryExport},取自 {@link SessionSyncResource.manifest} 的 `manifest.fileHistory`),编排 verb
      *  (`pushSessionBundle` / `importSessionBundle`)按两端的 `sessionSyncFileHistory` 位决定带不带它(见 {@link import("../sync.js").PushSessionResult.fileHistory})。
      *  **直接调本 verb 的调用方自己负责**:把 `fileHistory` 推给没有 blob 面的对端 ⇒ commit 之后因缺 blob 422 `missing_blob`;先 `putBlob` 完它引用的每个 hash。
      *
-     *  PUSH Phase A — `POST …/sync/import` body `{ entryIds, snapshots, policy, anchors, resolution?, logDigest?, title?, pinned? }`
+     *  PUSH Phase A — `POST …/sync/import` body `{ entryIds, fileHistory?, policy, anchors, resolution?, logDigest?, title?, pinned? }`
      *  (the SMALL metadata; entries stream in Phase B). `title` / `pinned` (server ≥7.125.0) carry the session row's two writable bits from {@link SessionManifest.title} /
      *  {@link SessionManifest.pinned}; omit them and the destination's two bits stay as they are. The cloud classifies (§7), pre-checks blob presence (every
      *  referenced hash must have been PUT — a missing one → 422 `missing_blob`), guards the import lease + any active
@@ -132,7 +119,7 @@ export declare class SessionSyncResource {
      *  🔴 a `fork`/`stale` WITHOUT `resolution:"overwrite-dst"` → a typed SyncConflictError (409, carrying the relation).
      *  An active run on the session → ConflictError (409, `session_active`, `activeTaskId`).
      *
-     *  ⚠️ `identical` is **not** a bare short-circuit: the cloud idempotently REPLAYS snapshots/policy/anchors on this
+     *  ⚠️ `identical` is **not** a bare short-circuit: the cloud idempotently REPLAYS fileHistory/policy/anchors on this
      *  arm (server `routes/session-sync.ts:367-384`) — that is the self-heal for "the conversation synced but the file
      *  tree did not" (a previous run's post-commit replay 422'd). So it can still answer 422 `missing_blob` /
      *  `restore_failed`; re-PUT the blob and retry. Do NOT read `identical` as "zero side effects".
@@ -144,8 +131,7 @@ export declare class SessionSyncResource {
      *  Not a submit (it mints a distinct staging token) → no SDK retry. */
     import(sessionId: string, body: {
         entryIds: string[];
-        snapshots: SyncSnapshot[];
-        /** server ≥7.52:文件历史信封(与 `manifest.fileHistory` 同形;`null` / 缺席 = 不带)。≤7.51 老 server 不认。 */
+        /** 文件历史信封(与 `manifest.fileHistory` 同形;`null` / 缺席 = 不带)。 */
         fileHistory?: FileHistoryExport | null;
         policy: SessionRulesRecord[];
         anchors: SyncAnchor[];
@@ -180,7 +166,7 @@ export declare class SessionSyncResource {
     }): Promise<ImportStaged>;
     /** PUSH Phase B — `POST …/sync/import/:stagingId/entries`: stream the entry log as an NDJSON REQUEST body into the
      *  staged shadow id, then the cloud `finish()`-validates (exactly-one-root + leaf-resolvable) → commits (the atomic
-     *  swap) → replays snapshots/policy/anchors. Returns {@link ImportCommitted} (`{ relation }`, the AUTHORITATIVE
+     *  swap) → replays fileHistory/policy/anchors. Returns {@link ImportCommitted} (`{ relation }`, the AUTHORITATIVE
      *  in-txn re-classify). The SDK serializes the entries to NDJSON (one JSON per line) and sends them as the raw body
      *  (NOT JSON.stringify of an array — the cloud line-buffers). Re-POSTing the same stagingId is idempotent
      *  (appendBatch dedups; the commit re-runs). Typed errors: a per-entry/structural violation → 422 `invalid_entries`;
@@ -191,6 +177,15 @@ export declare class SessionSyncResource {
      *  the commit re-runs), but any PrecheckError / SessionError path server-side `abort()`s and cleans up the staging
      *  (server `:561,:565,:573-574`) ⇒ after a typed 4xx the SAME stagingId is DEAD — reopen Phase A.
      *
+     *  🔴 **server ≥7.134.0 — Phase B passes the SAME owner gate as Phase A**, judged again on the session as it stands after the stream is read
+     *  and before the commit: a caller that no longer passes ⇒ `404 not_found.session` (read it as "you cannot reach this session now");
+     *  a caller that still passes while the session's owner cell changed since Phase A opened the staging ⇒ **`409 conflict` WITHOUT a
+     *  `relation`** (fixed sentence "session owner changed while the import streamed; nothing was imported — start the sync again"; the
+     *  transaction rolled back, the target untouched) — it maps to a plain {@link import("../errors.js").ConflictError}, NOT a {@link import("../errors.js").SyncConflictError} (that one
+     *  always carries a fork/stale `relation`); branch on the code + the absent `relation` and restart from Phase A, never on the sentence.
+     *  A staging opened by a fleet caller is pushed only by a fleet caller; a non-fleet caller pushes only its own ⇒ otherwise
+     *  `404 not_found.staging`. Older servers checked only who opened the staging.
+     *
      *  🔴 **Memory** (`stream`, 4.3.0): by DEFAULT the SDK serializes the whole iterator into one NDJSON string before
      *  sending — peak memory is O(entire log). Until 4.3.0 three JSDocs here and in `sync.ts` claimed the opposite
      *  ("pipe a PULL stream straight into a PUSH without materializing the whole log"); that was false, and it is what

package/dist/resources/session-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-sync.d.ts","sourceRoot":"","sources":["../../src/resources/session-sync.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-sync.d.ts","sourceRoot":"","sources":["../../src/resources/session-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wDAkCwD;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EAChB,MAAM,aAAa,CAAC;AAMrB,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC;;;;;;;0DAOsD;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,eAAe,CAAA;KAAE,CAAC;IAW1G;;;;;;mGAM+F;IACxF,OAAO,CACZ,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAC9B,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,cAAc,CAAC,SAAS,CAAC;IAQ5B;;;;uHAImH;IAC7G,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC,UAAU,CAAC;IAYtB;;;;;;;;;;;;;;;;;6GAiByG;IACnG,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,EACjB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC,IAAI,CAAC;IAahB;;;;;2GAKuG;IACjG,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,EAC5B,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC,YAAY,CAAC;IASxB;;;;;;;;;;;;;;;;;;;;;;;;;2EAyBuE;IACjE,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,4DAA4D;QAC5D,WAAW,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;QACvC,MAAM,EAAE,kBAAkB,EAAE,CAAC;QAC7B,OAAO,EAAE,UAAU,EAAE,CAAC;QACtB,UAAU,CAAC,EAAE,eAAe,CAAC;QAC7B;;;;;;;;;;;;;;;;;sBAiBc;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB;;sHAE8G;QAC9G,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,gIAAgI;QAChI,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,EACD,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC,YAAY,CAAC;IASxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iGA6B6F;IACvF,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,aAAa,CAAC,SAAS,CAAC,EACvD,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAChD,OAAO,CAAC,eAAe,CAAC;CAY5B"}