@sema-agent/sdk 4.1.0 → 4.3.0

package/dist/resources/runs.js

@@ -83,14 +83,26 @@ export class RunsResource {
     /** design/80 D-A — STEER a RUNNING durable run: inject mid-flight direction (the core of *supervision* vs mere
      *  approve/deny). AT-MOST-ONCE — steer is NOT idempotent, so NO submit/retry. `trusted` is NOT a body field:
      *  the server derives it from the authenticated operator (the BFF's operator role), never a client-set flag.
-     *  🔴 STEER ITSELF IS LIVE/SHIPPED (service §K-6, runStore-gated): 200 = injected into the live run;
-     *  202 = PARKED on a checkpoint (delivered when the run next runs); a durable-`suspended` run → typed
-     *  `SteeringNotRunningError` (`steering.not_running`, 409); a trusted text carrying a control-plane escape →
-     *  `SteeringInvalidContentError` (`steering.invalid_content`, 422). 🔴 ONE narrow caveat (NOT "steer is a draft"):
-     *  the per-call `mode` arg is currently a NO-OP — core's steer is HARNESS-LEVEL (`setSteeringMode`), set globally
-     *  on the runner, not switched per steer call; the `mode` mapping is pending D-A core (search [76]). Sending `mode`
-     *  is harmless (ignored); steer delivery itself works today. `mode` semantics (when wired): "all" = drain ALL
-     *  queued steers at the next turn boundary; "one-at-a-time" (default) = one per turn, FIFO. */
+     *
+     *  🔴 STEER ITSELF IS LIVE/SHIPPED (service §K-6, runStore-gated). Branch on {@link SteerReceipt.delivery},
+     *  NOT on the status code — the three legs are (`routes/runs.ts:641`/`:648`/`:734`):
+     *   · 200 `applied`         — injected into the live run on this replica.
+     *   · 202 `queued`          — the run is durably **suspended**: the steer is PARKED on its pending checkpoint
+     *                             and injected on resume. ⚠️ [2400] TR-3 correction: the previous note here said a
+     *                             `suspended` run yields `steering.not_running` (409). It does not — the server
+     *                             parks it. A 409 only comes from a run that is TERMINAL-with-no-park-path, or
+     *                             running on ANOTHER replica (cross-replica live-steer is not wired yet).
+     *   · 202 `parked_for_wake` — the run already ENDED; the message sits on a freshly-minted `task_done`
+     *                             checkpoint and is delivered ONLY by `POST /v1/sessions/:id/wake`.
+     *  Typed errors: `SteeringNotRunningError` (`steering.not_running`, 409) / `SteeringInvalidContentError`
+     *  (`steering.invalid_content`, 422) / `CapabilityUnavailableError` (`capability.checkpoint_store_required`,
+     *  501 — steering a suspended run needs the checkpoint store).
+     *
+     *  🔴 ONE narrow caveat (NOT "steer is a draft"): the per-call `mode` arg is currently a NO-OP — core's steer is
+     *  HARNESS-LEVEL (`setSteeringMode`), set globally on the runner, not switched per steer call; the `mode`
+     *  mapping is pending D-A core (search [76]). Sending `mode` is harmless (ignored); steer delivery itself works
+     *  today. `mode` semantics (when wired): "all" = drain ALL queued steers at the next turn boundary;
+     *  "one-at-a-time" (default) = one per turn, FIFO. `priority` is likewise advisory — see {@link SteerPriority}. */
     async steer(taskId, steer, opts) {
         return this.t.request({
             method: "POST",
@@ -146,7 +158,18 @@ export class RunsResource {
      *  (status/retrieval_status/partial flags verbatim). Non-blocking (no long-poll). server 1.250: no longer
      *  replica-local — a full in-process miss falls back to the durable agent record (cross-instance /
      *  post-restart): terminal = final snapshot served, still-running-elsewhere = honest "outcome unknown
-     *  here". 404 = unknown run / non-owner / unknown handle / no durable row (one indistinguishable arm, no oracle).
+     *  here".
+     *  🔴 [2400] TR-15 — the 404 is NOT one indistinguishable arm: it carries TWO codes and they mean different
+     *  things (server `src/http/routes/runs.ts`, all `sendError(…, 404, …)` sites on this verb):
+     *   · `not_found.run`      (:869/:873) — the RUN is unknown, or you are not its owner. The owner-gate and the
+     *     unknown-run arm deliberately share this code+text (no existence oracle across tenants) — that pair, and
+     *     only that pair, is indistinguishable by design.
+     *   · `not_found.subagent` (:937/:982) — the run is yours and visible, but THIS HANDLE is not one of its
+     *     background children: unknown handle, not this run's child, already reaped (bg children live in the
+     *     replica-local registry for the parent's lifetime), or a `wa…` workflow-agent row (read those via the
+     *     workflow journal instead).
+     *  Consumer value: the first says "check the taskId / your identity", the second says "the parent is fine,
+     *  the child handle is wrong or gone" — a UI that collapsed them sent users to re-check the wrong thing.
      *
      *  🔴 server 1.245 [1493]: this is a CONVERSATION-CONTENT read, so it is SESSION-scoped, not just
      *  principal-scoped — pass `session` (your own conversation's sessionId, the one POST /v1/runs returned). A
@@ -166,7 +189,9 @@ export class RunsResource {
      *  spooled handles re-read in full, cursor-only handles return only new bytes; trust the projection's own
      *  flags), monitor (batches), and background_agent (final report). A workflow handle 404s (its read face is
      *  the workflow journal). 🔴 `target` is the CANONICAL task handle only (b…/m…/a… task_id from the spawn) —
-     *  the in-engine tools' agent-name / legacy-id resolution is NOT on the wire (404). 🔴 NO server-side
+     *  the in-engine tools' agent-name / legacy-id resolution is NOT on the wire (404 `not_found.task_handle`,
+     *  `:1076` — DISTINCT from `not_found.run`, [2400] TR-15: the run is visible, the HANDLE is not one of its
+     *  tasks / was reaped / is a workflow handle). 🔴 NO server-side
      *  filter: `?filter=` is REFUSED with 400 on both verbs (wire-supplied regexes don't run on the server) —
      *  fetch the output and apply your regex locally, knowing the wire serves the CLIPPED projection (matches
      *  inside a clipped middle are not recoverable, and a cursor-only bash leg consumes what it serves; the
@@ -187,12 +212,21 @@ export class RunsResource {
     }
     /** server 1.246 ([1499]) — stop a background task handle (CC TaskStop 对位): bash kill / monitor stop /
      *  agent abort, attributed "user" (`output.stoppedBy`). Idempotent on a terminal handle — the 200
-     *  `output.status` tells you what actually happened. 🔴 A kill that does NOT land is a 409
-     *  `stop.not_landed` (body carries the honest projection: `output.status` stays "running") — never a 200;
-     *  treat only 200 as stopped. server 1.250 durable arm: an `a*` handle NOT attached to this replica
-     *  (cross-instance / post-restart) answers from the durable record — terminal row = 200 already-terminal
-     *  (idempotent-honest), still-running-elsewhere = 409 `stop.not_local` (no kill was attempted; distinct
-     *  from not_landed). Same session scoping + kind set + canonical-handle
+     *  `output.status` tells you what actually happened. 🔴 Treat ONLY 200 as stopped — every other outcome is a
+     *  409, and [2400] TR-14 lists the family in full (server `src/http/routes/runs.ts:1111-1118`, one ternary
+     *  chain; all five are {@link import("../errors.js").TaskStopConflictError}, discriminate on `.errorCode`):
+     *   · `stop.not_local`               — the handle lives on ANOTHER replica (cross-instance / post-restart):
+     *                                      **no kill was attempted**. Distinct from not_landed. Retry via the
+     *                                      owning replica, or read the durable record.
+     *   · `stop.not_landed`              — a kill WAS attempted and did not land; the body carries the honest
+     *                                      projection (`output.status` stays "running"). Retry.
+     *   · `stop.parked`                  — the row is PARKED (no live process to kill). Resolve its gate instead.
+     *   · `stop.park_resume_won`         — stop RACED the "approval landed → resume" path and the resume won;
+     *                                      the task is running again. Re-read, then stop again if still wanted.
+     *   · `stop.park_arbiter_unreachable`— the arbiter store is unreachable, so the truth is UNKNOWN (core 1.397's
+     *                                      three-way split). Neither "stopped" nor "still running" — retry later.
+     *  Open set: a future `stop.*` code still lands on TaskStopConflictError, so keep a `default` in your switch.
+     *  Same session scoping + kind set + canonical-handle
      *  addressing as {@link taskOutput} (a workflow handle 404s — stop workflows via their cancel face). Gate
      *  on `capabilities.taskHandles`. */
     async taskStop(taskId, target, opts) {
@@ -244,7 +278,9 @@ export class RunsResource {
         }
     }
     /** Resumable event stream. Internally: SSE + Last-Event-ID auto-reconnect; on a 416 (evicted past retention,
-     *  body `{error,retainedFrom}` — match status, no RESUME_EVICTED code) → full-sync via trace.turns then resume
+     *  body `{error, errorCode:"limit.retention_evicted", retainedFrom}` — [2400] CB-7: the machine code IS on the
+     *  wire (server `src/http/sse-log.ts:41`); this loop keys on the STATUS only because what it needs is
+     *  `retainedFrom`) → full-sync via trace.turns then resume
      *  from `retainedFrom` (sse.ts). Established-stream drops do NOT count as retries. */
     async *events(taskId, opts) {
         let first = opts?.lastEventId;

package/dist/resources/runs.js.map

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

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

@@ -9,9 +9,17 @@
  *  PLAN  (dry run): plan() classifies what a PUSH WOULD do, no write.
  *
  *  Owner-gated exactly like fork/delete (§9): a PULL 404s a non-owner (no existence oracle); a PUSH is own-or-FRESH
- *  (a session that does not exist yet, the caller is about to import it, is allowed). A non-uuidv7 id → 400. A
+ *  (a session that does not exist yet, the caller is about to import it, is allowed). A
  *  PUSH/PLAN that would lose dst history (fork/stale) without `resolution:"overwrite-dst"` → a typed
- *  {@link import("../errors.js").SyncConflictError} (409). */
+ *  {@link import("../errors.js").SyncConflictError} (409).
+ *
+ *  🔴 ID 形状(2026-08-02 更正,server `routes/session-sync.ts:135-138` 亲读):这一族的 id 门是
+ *  `isUuidShape` = **任意 uuid 版本**,NOT `isUuidV7`. server 的旁注逐字说明了为什么这是**故意**的:
+ *  「a v4-keyed legacy shell session must be pushable (it was creatable via the lenient submit face)」——
+ *  crafted-id 类(LIKE 元字符、超长)仍被挡在门外。此前 SDK 与 spec 三处都写「400 on a non-uuidv7 id」,
+ *  会让持 uuidv4 legacy 会话的消费方在客户端先自判「本会话不支持 sync」而根本不发请求,把 server 明确
+ *  为迁移开的通道自己封死。对照组:`sessions.fork`/`delete`/`policy` 用的**确实是** `isUuidV7`(那三处
+ *  的同款说法是对的)—— 差别只出在 sync 这一族。 */
 import type { Transport } from "../transport.js";
 import type { SessionManifest, SyncEntry, SyncSnapshot, SessionRulesRecord, SyncAnchor, SyncRelation, ImportStaged, ImportCommitted } from "../types.js";
 export declare class SessionSyncResource {
@@ -21,8 +29,9 @@ export declare class SessionSyncResource {
      *  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`
      *  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 a non-uuidv7 id; 501
-     *  without a durable session store. */
+     *  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
+     *  pushable); 501 without a durable session store. */
     manifest(sessionId: string, opts?: {
         signal?: AbortSignal;
     }): Promise<{
@@ -51,16 +60,24 @@ export declare class SessionSyncResource {
     /** 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
      *  (the content-address integrity guard) — a mismatch → 400 `blob hash mismatch`; the SDK validates the hash
-     *  shape locally first. own-or-FRESH gate. Per-blob cap = 64 MiB (the cloud 413s mid-stream beyond it). A backend
-     *  write failure (e.g. a MinIO non-2xx) → 502 `blob store write failed` (RETRYABLE — the transport retries 502 on
-     *  a... no: 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. */
+     *  shape locally first. own-or-FRESH gate.
+     *
+     *  🔴 **两种 413,语义相反**(server `routes/session-sync.ts:250` vs `:253-263`,2026-08-02 亲读):
+     *   - 通用超 cap(`readRawBody` 的 64 MiB per-blob 帽)—— 换小 blob / 分片是唯一出路;
+     *   - `blob_too_large_for_sql`(SQL 店的行宽帽,body 带 `sizeBytes`/`limit`)—— 这块字节在**这个后端上
+     *     永远落不了地**,重试是纯浪费;运维要么换对象存储轨,要么这条 blob 不同步。
+     *  两者都是 413,只有机器码能区分 —— 别对 413 统一写「重试」。
+     *
+     *  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. */
     putBlob(sessionId: string, hash: string, bytes: Uint8Array, opts?: {
         signal?: AbortSignal;
     }): Promise<void>;
     /** PLAN (dry-run) — `POST …/sync/plan` body `{ entryIds }` (the LOCAL peer's entry-id list, oldest-first) →
      *  classify what a PUSH WOULD do against the cloud's current log, WITHOUT writing. Returns the §7 {@link SyncRelation}
-     *  (`fresh` for a fresh cloud session). own-or-FRESH gate; 400 on a non-string-array body / a non-uuidv7 id.
+     *  (`fresh` for a fresh cloud session). own-or-FRESH gate; 400 on a non-string-array body / a non-uuid-SHAPED id
+     *  (any uuid version passes — see the module header).
      *  NB: unlike import, plan never 409s — it is a pure read-side classify (a fork/stale is REPORTED in the relation,
      *  not raised). Use it to surface the keep-local/keep-cloud divergence before committing to a PUSH. */
     plan(sessionId: string, body: {
@@ -68,21 +85,50 @@ export declare class SessionSyncResource {
     }, opts?: {
         signal?: AbortSignal;
     }): Promise<SyncRelation>;
-    /** PUSH Phase A — `POST …/sync/import` body `{ entryIds, snapshots, policy, anchors, resolution? }` (the SMALL
-     *  metadata; entries stream in Phase B). 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 run (409),
-     *  then mints a stagingId. Returns {@link ImportStaged}:
-     *    - `identical` → `{ relation:"identical" }` with NO `stagingId` (the dst already holds the log; skip Phase B).
+    /** PUSH Phase A — `POST …/sync/import` body `{ entryIds, snapshots, policy, anchors, resolution?, logDigest? }`
+     *  (the SMALL metadata; entries stream in Phase B). 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
+     *  run (409), then mints a stagingId. Returns {@link ImportStaged}:
+     *    - `identical` → `{ relation:"identical", basis, payloadVerified }` with NO `stagingId` (skip Phase B).
      *    - `fresh`/`fast_forward` → `{ stagingId, relation }` — drive Phase B with the `stagingId`.
      *  🔴 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`); an in-flight import →
-     *  ConflictError (409, `import_in_flight`). Not a submit (it mints a distinct staging token) → no SDK retry. */
+     *  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
+     *  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".
+     *
+     *  ⚠️ `import_in_flight` (409) is **not** a permanent state: the cloud carries `retryAfterSec` on the error body
+     *  and TAKES OVER a stale lease itself (default 600 s without activity — server `:405-434`). Wait the advertised
+     *  seconds and retry; never surface it to the user as "this session is locked".
+     *
+     *  Not a submit (it mints a distinct staging token) → no SDK retry. */
     import(sessionId: string, body: {
         entryIds: string[];
         snapshots: SyncSnapshot[];
         policy: SessionRulesRecord[];
         anchors: SyncAnchor[];
         resolution?: "overwrite-dst";
+        /** 🔴 OPTIONAL content digest of the SOURCE's whole entry log — the ONE key that makes
+         *  {@link ImportStaged.payloadVerified `payloadVerified:true`} reachable (方案 B,黑板 [1701]→[1707] 三端对齐;
+         *  server `routes/session-sync.ts:295,310,357-366`).
+         *
+         *  Why it matters: `identical` is classified from the **entry-id SETS** alone, and an entry id is a uuidv7 —
+         *  NOT content-addressed. "Same ids, different payloads" is structurally possible, and without a digest the
+         *  cloud answers `{relation:"identical", basis:"entry-ids", payloadVerified:false}` and Phase B is skipped —
+         *  a genuinely diverged session reads as "already synced" while the destination keeps its own content.
+         *  Supply this and the cloud recomputes the digest over ITS log: equal ⇒ `basis:"entry-ids+digest"` +
+         *  `payloadVerified:true` (a real short-circuit); different or not comparable ⇒ it does **not** short-circuit
+         *  and opens staging for a full sync (the safe direction).
+         *
+         *  🔴 The SDK does NOT compute this — it has **zero runtime dependencies** by constitution, and the digest
+         *  algorithm belongs to core (`sessionLogDigest`, scheme `sema-log-v3`; core ≥ 1.416.0 is the server's own
+         *  floor for this leg). Callers that already hold core pass its value through; callers that don't simply omit
+         *  the key and get byte-identical pre-4.3.0 behavior. A malformed value is NOT rejected — the cloud treats it
+         *  as absent (a digest mismatch must never become an error / a 409 / a refusal to sync; it only means "do the
+         *  work"). */
+        logDigest?: string;
     }, opts?: {
         signal?: AbortSignal;
     }): Promise<ImportStaged>;
@@ -93,9 +139,23 @@ export declare class SessionSyncResource {
      *  (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`;
      *  a line too large → 413; a commit-time TOCTOU flip to fork/stale → a typed SyncConflictError (409); a refused
-     *  policy loosen → 403 `loosen_forbidden`; a wrong/foreign stagingId → 404. */
+     *  policy loosen → 403 `loosen_forbidden`; a wrong/foreign stagingId → 404.
+     *
+     *  ⚠️ Idempotency is HALF true: re-POSTing the same stagingId after a *transport* drop is fine (appendBatch dedups,
+     *  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.
+     *
+     *  🔴 **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
+     *  {@link PushSessionOptions} sized its own trade-off note against. Pass `stream: true` to send a real
+     *  `ReadableStream` request body (constant memory, one entry at a time — the server side has always been truly
+     *  streaming: it reads chunk-wise with an 8 MiB per-line cap and a 500-entry append batch). It is OPT-IN because a
+     *  streaming request body needs `duplex: "half"` support: Node ≥18 undici and Deno have it, but a polyfilled /
+     *  proxied `fetch` may not, and silently switching the default would break those callers. */
     importEntries(sessionId: string, stagingId: string, entries: Iterable<SyncEntry> | AsyncIterable<SyncEntry>, opts?: {
         signal?: AbortSignal;
+        stream?: boolean;
     }): Promise<ImportCommitted>;
 }
 //# sourceMappingURL=session-sync.d.ts.map

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":"AAAA;;;;;;;;;;;;;8DAa8D;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,YAAY,EACZ,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;;;;;2CAKuC;IACjC,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;IAS1G;;;;;;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;;;;+GAI2G;IACrG,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC,UAAU,CAAC;IAYtB;;;;;;uHAMmH;IAC7G,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;;;;2GAIuG;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;;;;;;;;oHAQgH;IAC1G,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,EAAE,YAAY,EAAE,CAAC;QAC1B,MAAM,EAAE,kBAAkB,EAAE,CAAC;QAC7B,OAAO,EAAE,UAAU,EAAE,CAAC;QACtB,UAAU,CAAC,EAAE,eAAe,CAAC;KAC9B,EACD,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC,YAAY,CAAC;IASxB;;;;;;;mFAO+E;IACzE,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,CAAA;KAAE,GAC9B,OAAO,CAAC,eAAe,CAAC;CAY5B"}
+{"version":3,"file":"session-sync.d.ts","sourceRoot":"","sources":["../../src/resources/session-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;kCAqBkC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,YAAY,EACZ,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;;;;;;0DAMsD;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;IAS1G;;;;;;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;;;;+GAI2G;IACrG,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC,UAAU,CAAC;IAYtB;;;;;;;;;;;;;4GAawG;IAClG,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;;;;;;;;;;;;;;;;;;2EAkBuE;IACjE,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,EAAE,YAAY,EAAE,CAAC;QAC1B,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;KACpB,EACD,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC,YAAY,CAAC;IASxB;;;;;;;;;;;;;;;;;;;;iGAoB6F;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"}

package/dist/resources/session-sync.js

@@ -12,8 +12,9 @@ export class SessionSyncResource {
      *  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`
      *  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 a non-uuidv7 id; 501
-     *  without a durable session store. */
+     *  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
+     *  pushable); 501 without a durable session store. */
     async manifest(sessionId, opts) {
         // 🔴 BREAKING(clay 拍 2026-07-28,信封归一):wire 原样 `{manifest}`,不再拆封。迁移:`(...).manifest`。
         return this.t.request({
@@ -59,10 +60,17 @@ export class SessionSyncResource {
     /** 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
      *  (the content-address integrity guard) — a mismatch → 400 `blob hash mismatch`; the SDK validates the hash
-     *  shape locally first. own-or-FRESH gate. Per-blob cap = 64 MiB (the cloud 413s mid-stream beyond it). A backend
-     *  write failure (e.g. a MinIO non-2xx) → 502 `blob store write failed` (RETRYABLE — the transport retries 502 on
-     *  a... no: 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. */
+     *  shape locally first. own-or-FRESH gate.
+     *
+     *  🔴 **两种 413,语义相反**(server `routes/session-sync.ts:250` vs `:253-263`,2026-08-02 亲读):
+     *   - 通用超 cap(`readRawBody` 的 64 MiB per-blob 帽)—— 换小 blob / 分片是唯一出路;
+     *   - `blob_too_large_for_sql`(SQL 店的行宽帽,body 带 `sizeBytes`/`limit`)—— 这块字节在**这个后端上
+     *     永远落不了地**,重试是纯浪费;运维要么换对象存储轨,要么这条 blob 不同步。
+     *  两者都是 413,只有机器码能区分 —— 别对 413 统一写「重试」。
+     *
+     *  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. */
     async putBlob(sessionId, hash, bytes, opts) {
         if (!SHA256_HEX_RE.test(hash))
             throw toApiError(400, { error: "blob hash must be 64 lowercase-hex chars" });
@@ -79,7 +87,8 @@ export class SessionSyncResource {
     }
     /** PLAN (dry-run) — `POST …/sync/plan` body `{ entryIds }` (the LOCAL peer's entry-id list, oldest-first) →
      *  classify what a PUSH WOULD do against the cloud's current log, WITHOUT writing. Returns the §7 {@link SyncRelation}
-     *  (`fresh` for a fresh cloud session). own-or-FRESH gate; 400 on a non-string-array body / a non-uuidv7 id.
+     *  (`fresh` for a fresh cloud session). own-or-FRESH gate; 400 on a non-string-array body / a non-uuid-SHAPED id
+     *  (any uuid version passes — see the module header).
      *  NB: unlike import, plan never 409s — it is a pure read-side classify (a fork/stale is REPORTED in the relation,
      *  not raised). Use it to surface the keep-local/keep-cloud divergence before committing to a PUSH. */
     async plan(sessionId, body, opts) {
@@ -90,15 +99,25 @@ export class SessionSyncResource {
             signal: opts?.signal,
         });
     }
-    /** PUSH Phase A — `POST …/sync/import` body `{ entryIds, snapshots, policy, anchors, resolution? }` (the SMALL
-     *  metadata; entries stream in Phase B). 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 run (409),
-     *  then mints a stagingId. Returns {@link ImportStaged}:
-     *    - `identical` → `{ relation:"identical" }` with NO `stagingId` (the dst already holds the log; skip Phase B).
+    /** PUSH Phase A — `POST …/sync/import` body `{ entryIds, snapshots, policy, anchors, resolution?, logDigest? }`
+     *  (the SMALL metadata; entries stream in Phase B). 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
+     *  run (409), then mints a stagingId. Returns {@link ImportStaged}:
+     *    - `identical` → `{ relation:"identical", basis, payloadVerified }` with NO `stagingId` (skip Phase B).
      *    - `fresh`/`fast_forward` → `{ stagingId, relation }` — drive Phase B with the `stagingId`.
      *  🔴 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`); an in-flight import →
-     *  ConflictError (409, `import_in_flight`). Not a submit (it mints a distinct staging token) → no SDK retry. */
+     *  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
+     *  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".
+     *
+     *  ⚠️ `import_in_flight` (409) is **not** a permanent state: the cloud carries `retryAfterSec` on the error body
+     *  and TAKES OVER a stale lease itself (default 600 s without activity — server `:405-434`). Wait the advertised
+     *  seconds and retry; never surface it to the user as "this session is locked".
+     *
+     *  Not a submit (it mints a distinct staging token) → no SDK retry. */
     async import(sessionId, body, opts) {
         return this.t.request({
             method: "POST",
@@ -114,13 +133,26 @@ export class SessionSyncResource {
      *  (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`;
      *  a line too large → 413; a commit-time TOCTOU flip to fork/stale → a typed SyncConflictError (409); a refused
-     *  policy loosen → 403 `loosen_forbidden`; a wrong/foreign stagingId → 404. */
+     *  policy loosen → 403 `loosen_forbidden`; a wrong/foreign stagingId → 404.
+     *
+     *  ⚠️ Idempotency is HALF true: re-POSTing the same stagingId after a *transport* drop is fine (appendBatch dedups,
+     *  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.
+     *
+     *  🔴 **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
+     *  {@link PushSessionOptions} sized its own trade-off note against. Pass `stream: true` to send a real
+     *  `ReadableStream` request body (constant memory, one entry at a time — the server side has always been truly
+     *  streaming: it reads chunk-wise with an 8 MiB per-line cap and a 500-entry append batch). It is OPT-IN because a
+     *  streaming request body needs `duplex: "half"` support: Node ≥18 undici and Deno have it, but a polyfilled /
+     *  proxied `fetch` may not, and silently switching the default would break those callers. */
     async importEntries(sessionId, stagingId, entries, opts) {
-        const ndjson = await toNdjson(entries);
+        const rawBody = opts?.stream === true ? toNdjsonStream(entries) : await toNdjson(entries);
         const res = await this.t.openRaw({
             method: "POST",
             path: `/v1/sessions/${encodeURIComponent(sessionId)}/sync/import/${encodeURIComponent(stagingId)}/entries`,
-            rawBody: ndjson,
+            rawBody,
             contentType: "application/x-ndjson",
             signal: opts?.signal,
         });
@@ -129,13 +161,42 @@ export class SessionSyncResource {
         return (await res.json());
     }
 }
-/** Serialize entries to an NDJSON body (one JSON value per `\n`-terminated line) for the Phase-B stream. Accepts a
- *  sync or async iterable so the caller can pipe a `PULL …/sync/entries` stream straight into a PUSH without
- *  materializing the whole log. */
+/** Serialize entries to ONE NDJSON string (one JSON value per `\n`-terminated line) — the whole-block Phase-B body.
+ *  🔴 This MATERIALIZES the whole log in memory. It is kept as the default because it works on every `fetch`
+ *  implementation; {@link toNdjsonStream} is the constant-memory form. */
 async function toNdjson(entries) {
     let body = "";
     for await (const e of entries)
         body += `${JSON.stringify(e)}\n`;
     return body;
 }
+/** Serialize entries to a `ReadableStream<Uint8Array>` NDJSON body — one line enqueued per `pull()`, so a
+ *  `PULL …/sync/entries` async iterator really can be piped straight into a PUSH at CONSTANT memory. Requires the
+ *  runtime `fetch` to accept a stream body (`duplex: "half"`, set by {@link import("../transport.js").Transport.openRaw}).
+ *  A throw from the source iterator `error()`s the stream, which aborts the request — the caller sees the source's
+ *  error (e.g. `SyncTruncatedError`), never a silently short body. */
+function toNdjsonStream(entries) {
+    const it = entries[Symbol.asyncIterator]
+        ? entries[Symbol.asyncIterator]()
+        : entries[Symbol.iterator]();
+    const enc = new TextEncoder();
+    return new ReadableStream({
+        async pull(controller) {
+            try {
+                const next = await it.next();
+                if (next.done === true) {
+                    controller.close();
+                    return;
+                }
+                controller.enqueue(enc.encode(`${JSON.stringify(next.value)}\n`));
+            }
+            catch (e) {
+                controller.error(e);
+            }
+        },
+        async cancel(reason) {
+            await it.return?.(reason);
+        },
+    });
+}
 //# sourceMappingURL=session-sync.js.map

package/dist/resources/session-sync.js.map

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