@sema-agent/sdk 0.0.74 → 0.0.76

package/dist/resources/runs.js

@@ -5,6 +5,12 @@ export class RunsResource {
     constructor(t) {
         this.t = t;
     }
+    /** server 1.246 ([1499] accept-phase, [1498]⑥ two-拍 rollout) — `?session=` on the legacy run faces.
+     *  principal answers "whose data"; session answers "which conversation" ([1493]). Pass your conversation's
+     *  sessionId (the one POST /v1/runs bound) on get/events/cancel/steer/compact/detach and the subagent
+     *  verbs: today a MISMATCH on a session-bound run 404s (a match/absence passes; absence logs a server-side
+     *  migration warning), and the enforcement train will 404 absence too — so new code should always send it.
+     *  NB send a real sessionId or nothing: an EMPTY string counts as present-and-mismatched (404). */
     sessionQs(session) {
         return session !== undefined ? `?session=${encodeURIComponent(session)}` : "";
     }
@@ -25,6 +31,9 @@ export class RunsResource {
             signal: opts?.signal,
         });
     }
+    /** Cancel a durable async run (LIVE). 202 ack (`cancelling` or terminal no-op); the run settles
+     *  to failed+errorCode:"cancelled". 409 = suspended (cancel by DENYING its approval instead); 404 = non-owner/
+     *  unknown (no existence leak). Server-side idempotent; not a submit → no SDK retry. */
     async cancel(taskId, opts) {
         return this.t.request({
             method: "POST",
@@ -32,6 +41,13 @@ export class RunsResource {
             signal: opts?.signal,
         });
     }
+    /** core 1.207 / server 1.78 — DETACH an in-flight tool call (the CC ctrl+b tool-level semantic): the engine
+     *  adopts the RUNNING process into a background task (spool pre-filled with captured output), the tool call
+     *  returns early with `Command moved to background; task_id=b*…` (+ `tool_end.structured
+     *  {type:"bash", detached:true, task_id}`), and the run's turn continues. Fire-and-forget create-then-abort
+     *  semantics: early/late requests are safe (after completion = no-op). 202 = accepted; 409
+     *  `detach.not_running` = no such in-flight call; 404 = non-owner/unknown (no existence leak).
+     *  Works on the sync interactive leg too (server 1.78 registers the live handle). `toolCallId` <= 256 chars. */
     async detach(taskId, toolCallId, opts) {
         return this.t.request({
             method: "POST",
@@ -40,14 +56,37 @@ export class RunsResource {
             signal: opts?.signal,
         });
     }
+    /** K-1c (core 1.156 `TaskStream.compact()` / server 1.214 server.js:1596) — MANUAL COMPACT a RUNNING durable
+     *  run (the CC `/compact` semantic): the engine summarizes the context at the next turn boundary; if anything
+     *  was summarized a `compacted{trigger:"manual"}` event rides the run's event stream. `instructions` (≤2048
+     *  code points, non-empty when present — else 400) focuses the summary ("keep the file list", CC parity).
+     *
+     *  Fire-and-forget acceptance: 202 {@link CompactAck} means QUEUED, not compacted — the outcome arrives (or
+     *  doesn't: mooted/failed compactions emit NO event) on the stream. 🔴 REPLICA-LOCAL like steer/detach:
+     *  409 `compact.not_running` = the run settled OR lives on another replica; 501 = no run store (gate on
+     *  `capabilities.manualCompact`, don't trial-by-501); 404 = non-owner/unknown (no existence leak).
+     *  Not a submit / server treats repeat calls as fresh asks → NO SDK retry. */
     async compact(taskId, opts) {
         return this.t.request({
             method: "POST",
+            // 🔴 body is ALWAYS an object: the server readJson + "body must be a JSON object when present" 400s a
+            // bodyless POST on some proxies — `{}` is the no-instructions form (server reads only `instructions`).
             path: `/v1/runs/${encodeURIComponent(taskId)}/compact${this.sessionQs(opts?.session)}`,
             body: opts?.instructions !== undefined ? { instructions: opts.instructions } : {},
             signal: opts?.signal,
         });
     }
+    /** 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. */
     async steer(taskId, steer, opts) {
         return this.t.request({
             method: "POST",
@@ -56,6 +95,14 @@ export class RunsResource {
             signal: opts?.signal,
         });
     }
+    /** core 1.219 C2 / server 1.89 — STEER a RUNNING SUBAGENT of this run (the CC "enter the agent's view and
+     *  type to it" semantic, `AGe` pendingMessages: the message drains at the subagent's NEXT TOOL ROUND).
+     *  `target` = the delegating tool call's id (`parentToolCallId`, stamped on every forwarded subagent
+     *  content event) or the agentName (ambiguous name → 409). 🔴 BODY SHAPE differs from the main-run steer:
+     *  `{ content }` (server SubagentSteerRegistry contract), NOT `{ text }`. Receipt: 200 with
+     *  `{ taskId, target, status, delivery, note }` — `note` carries the CC-verbatim
+     *  "Message queued for delivery to <name> at its next tool round."; a settled/unknown subagent →
+     *  `steering.not_running` 409 (same typed error family as the main-run verb). AT-MOST-ONCE (no retry). */
     async steerSubagent(taskId, target, steer, opts) {
         return this.t.request({
             method: "POST",
@@ -64,6 +111,19 @@ export class RunsResource {
             signal: opts?.signal,
         });
     }
+    /** server 1.214 (server.js:1774 subagent-verb region, `verb === "resume"` arm) — RESUME/REVIVE a SETTLED
+     *  subagent of this run with a follow-up message (the CC "keep talking to the finished agent" semantic):
+     *  the engine re-opens the subagent's retained session in the background and delivers `content` as its next
+     *  user turn. Same addressing as {@link steerSubagent} (`target` = parentToolCallId or agentName; ambiguous
+     *  name → 409 `steering.ambiguous_target`), same `{ content }` body (non-empty, else 400), same
+     *  {@link SubagentSteerReceipt} 200 (note = "Message queued for delivery to <name>; it will continue in the
+     *  background.", + `marker`).
+     *
+     *  🔴 Requires the PARENT run to have retained subagent sessions — the typed-409 family tells you why not:
+     *  `resume.retain_off` (run didn't set retainSubagentSessions) / `resume.evicted` / `resume.cap` /
+     *  `resume.session_not_found` (retention lapsed) / `steering.still_running` (it's in flight — STEER instead)
+     *  / `steering.not_running` (no match on this replica / run settled). Gate on `capabilities.subagentResume`.
+     *  404 = non-owner/unknown run (no existence leak). AT-MOST-ONCE (no retry). */
     async resumeSubagent(taskId, target, message, opts) {
         return this.t.request({
             method: "POST",
@@ -72,6 +132,23 @@ export class RunsResource {
             signal: opts?.signal,
         });
     }
+    /** server 1.244 ([1488]③b) — read a BACKGROUND child's final report / current status. `target` = the
+     *  agent handle (a… domain, `background_agent` ONLY — wa… workflow-agent observation rows read via the
+     *  workflow journal face, and other task kinds 404 here) from the parent's spawn (bg children are NEVER
+     *  in the run store — GET /v1/runs/:handle 404s
+     *  with guidance; THIS verb is the read face: the engine TaskRegistry's TaskOutput-tool projection over HTTP).
+     *  200 `{ taskId, target, content, output }`: `content` = the TaskOutput text (the child's final assistant
+     *  body once terminal; honest status text while running), `output` = the registry's UnifiedTaskOutput
+     *  (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).
+     *
+     *  🔴 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
+     *  session-bound run served to a caller that omits or mismatches the session → 404 (fail-closed): a sibling
+     *  session sharing your principal must not read another conversation's child. (Operators/trace bypass.)
+     *  Gate on `capabilities.subagentOutput`. */
     async subagentOutput(taskId, target, opts) {
         const qs = opts?.session !== undefined ? `?session=${encodeURIComponent(opts.session)}` : "";
         return this.t.request({
@@ -80,6 +157,23 @@ export class RunsResource {
             signal: opts?.signal,
         });
     }
+    /** server 1.246 ([1499]) — the GENERIC background task-handle read (CC TaskOutput 对位): serves
+     *  background_bash (stdout — whether a read consumes the output cursor depends on the handle's shape:
+     *  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
+     *  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
+     *  in-engine tool filters before clipping and keeps full fidelity). SESSION-
+     *  scoped like {@link subagentOutput} — pass your conversation's `session`; a session-bound run without/with
+     *  a mismatched one → 404 fail-closed (operators bypass). Non-blocking. server 1.250: an `a*` handle is
+     *  no longer replica-local — a full in-process miss falls back to the durable record (cross-instance /
+     *  post-restart): terminal rows serve the final snapshot, a row still running on another replica answers
+     *  an honest "outcome unknown here" (never fabricated liveness). `b*`/`m*` handles stay replica-local
+     *  (no durable face). Gate on
+     *  `capabilities.taskHandles`. */
     async taskOutput(taskId, target, opts) {
         return this.t.request({
             method: "GET",
@@ -87,6 +181,16 @@ export class RunsResource {
             signal: opts?.signal,
         });
     }
+    /** 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
+     *  addressing as {@link taskOutput} (a workflow handle 404s — stop workflows via their cancel face). Gate
+     *  on `capabilities.taskHandles`. */
     async taskStop(taskId, target, opts) {
         return this.t.request({
             method: "POST",
@@ -94,6 +198,26 @@ export class RunsResource {
             signal: opts?.signal,
         });
     }
+    /** server 1.251(S2,core 1.370 `bgAgentId`)— a background child's per-agent **live tail** (SSE):
+     *  `GET /v1/runs/:id/subagents/:handle/stream`. The "tail" half of replay+tail — {@link subagentOutput}
+     *  (+AgentTranscript in-engine) is the replay half. Frames: `meta` (once — carries `status` and
+     *  `live:"replica-local"`; on a TERMINAL child the stream ends right after it, go read the replay face),
+     *  `forward` (content: text_delta / reasoning_delta / tool_start / tool_end / task_progress — same
+     *  projection discipline as the main run stream's forward branch, plus a bus-level
+     *  `{type:"lagged",dropped}` marker when a slow consumer dropped frames — honest, never silent), and
+     *  `heartbeat` (ignore), and `{type:"task_settled",status,seq?}` — the child settled MID-stream (the server
+     *  writes it and ends the stream; the full story continues on the replay face). Live frames are REPLICA-LOCAL (produced only where the host run executes) — a
+     *  child running on another replica yields heartbeats only. Same addressing/gates/404-shape as
+     *  {@link subagentOutput} (session-enforced). Stop-cycle `seq` (server 1.255 + core 1.373): the
+     *  `task_settled` frame carries the settle-minted generation number (1 = first settle; ≥2 = a revived
+     *  child settling again) — the real-time revive discriminator. The `meta` frame's optional `seq` appears
+     *  ONLY when the probe served a terminal durable row cross-instance/post-restart (in-process polls do not
+     *  project it — its absence does NOT mean "never settled"). Consumption notes (server 1.253): after a `task_settled`
+     *  close, a REVIVED child (stop-cycle seq≥2) = open a NEW stream; after a `lagged` marker the dropped
+     *  frames are NOT recoverable on this lane — rebuild from the replay face, then re-tail. NESTED bg
+     *  children's frames merge into the OUTERMOST handle's stream (core overwrites bgAgentId per bg boundary;
+     *  discriminate nested frames by parentToolCallId) — a nested handle's own stream carries meta+heartbeat
+     *  only. Gate on `capabilities.subagentStream`. */
     async *subagentStream(taskId, target, opts) {
         const o = {
             method: "GET",
@@ -107,14 +231,17 @@ export class RunsResource {
         try {
             for await (const frame of readSseFrames(res, undefined, opts?.signal)) {
                 if (!frame.data)
-                    continue;
+                    continue; // comment-only frames (heartbeat carries data:{} and IS yielded)
                 yield { event: frame.event ?? "message", data: JSON.parse(frame.data) };
             }
         }
         finally {
-            res.body?.cancel().catch(() => { });
+            res.body?.cancel().catch(() => { }); // disconnect = server clears the in-process tail subscription
         }
     }
+    /** 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
+     *  from `retainedFrom` (sse.ts). Established-stream drops do NOT count as retries. */
     async *events(taskId, opts) {
         let first = opts?.lastEventId;
         yield* parseSse((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

@@ -1,27 +1,80 @@
+/** 2c session-sync (P1d) — the SDK as the LOCAL peer's client of the cloud's `/v1/sessions/:id/sync/*` routes
+ *  (service src/http/server.ts:2825-3172). The real topology is TWO PROCESSES (the local shell's local
+ *  backend + this cloud service); these methods let the local peer PULL a session's whole state out of the cloud
+ *  or PUSH its own in. The whole surface is gated off `capabilities().sessionSync` (= durable backend + entry
+ *  export + a file-snapshot store wired) — DON'T trial-by-501.
+ *
+ *  PULL  (read the cloud): manifest() → entries() (NDJSON) → getBlob() for the 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.
+ *
+ *  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
+ *  PUSH/PLAN that would lose dst history (fork/stale) without `resolution:"overwrite-dst"` → a typed
+ *  {@link import("../errors.js").SyncConflictError} (409). */
 import type { Transport } from "../transport.js";
 import type { SessionManifest, SyncEntry, SyncSnapshot, 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`
+     *  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. */
     manifest(sessionId: string, opts?: {
         signal?: AbortSignal;
     }): Promise<SessionManifest>;
+    /** PULL — `GET …/sync/entries[?afterSeq=N]` → the entry PAYLOADS as an NDJSON stream (one JSON entry per line,
+     *  begin/end-sentinel framed). Yields each entry verbatim (opaque to the SDK — the cloud re-validates the tree).
+     *  🔴 The stream's status is committed at 200 BEFORE the first line, so a mid-stream failure ends the body
+     *  WITHOUT the `{"__sync":"end",count}` trailer — `parseNdjsonEntries` throws `SyncTruncatedError` on a missing
+     *  trailer or a count mismatch (the SOLE truncation signal; there is no 5xx mid-stream). `afterSeq` is a resume
+     *  cursor = the backend-native durable `seq` (yield seq>afterSeq); resume is SAME-BACKEND only. A non-200
+     *  (404 raced delete / 501 / 400) surfaces as a typed APIError BEFORE any entry is yielded. */
     entries(sessionId: string, params?: {
         afterSeq?: number;
     }, opts?: {
         signal?: AbortSignal;
     }): AsyncGenerator<SyncEntry>;
+    /** 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`. */
     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
+     *  (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. */
     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.
+     *  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: {
         entryIds: string[];
     }, 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).
+     *    - `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. */
     import(sessionId: string, body: {
         entryIds: string[];
         snapshots: SyncSnapshot[];
@@ -31,6 +84,14 @@ export declare class SessionSyncResource {
     }, opts?: {
         signal?: AbortSignal;
     }): 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
+     *  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`;
+     *  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. */
     importEntries(sessionId: string, stagingId: string, entries: Iterable<SyncEntry> | AsyncIterable<SyncEntry>, opts?: {
         signal?: AbortSignal;
     }): Promise<ImportCommitted>;

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":"AAcA,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;IAQnC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBrF,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;IAatB,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;IAmBhB,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;IAkBV,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;IAkBlB,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;IAiBlB,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;;;;;;;;;;;;;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,eAAe,CAAC;IAS5F;;;;;;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"}

package/dist/resources/session-sync.js

@@ -1,11 +1,19 @@
 import { toApiError } from "../errors.js";
 import { parseNdjsonEntries } from "../sse.js";
+/** A 64-lowercase-hex SHA-256 — the content-address the cloud asserts on a blob GET/PUT (server.ts SHA256_HEX_RE).
+ *  The SDK validates the shape locally so a malformed hash fails fast (the cloud also 400s it). */
 const SHA256_HEX_RE = /^[0-9a-f]{64}$/;
 export class SessionSyncResource {
     t;
     constructor(t) {
         this.t = t;
     }
+    /** 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`
+     *  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. */
     async manifest(sessionId, opts) {
         const out = await this.t.request({
             method: "GET",
@@ -14,6 +22,13 @@ export class SessionSyncResource {
         });
         return out.manifest;
     }
+    /** PULL — `GET …/sync/entries[?afterSeq=N]` → the entry PAYLOADS as an NDJSON stream (one JSON entry per line,
+     *  begin/end-sentinel framed). Yields each entry verbatim (opaque to the SDK — the cloud re-validates the tree).
+     *  🔴 The stream's status is committed at 200 BEFORE the first line, so a mid-stream failure ends the body
+     *  WITHOUT the `{"__sync":"end",count}` trailer — `parseNdjsonEntries` throws `SyncTruncatedError` on a missing
+     *  trailer or a count mismatch (the SOLE truncation signal; there is no 5xx mid-stream). `afterSeq` is a resume
+     *  cursor = the backend-native durable `seq` (yield seq>afterSeq); resume is SAME-BACKEND only. A non-200
+     *  (404 raced delete / 501 / 400) surfaces as a typed APIError BEFORE any entry is yielded. */
     async *entries(sessionId, params, opts) {
         let path = `/v1/sessions/${encodeURIComponent(sessionId)}/sync/entries`;
         if (params?.afterSeq !== undefined)
@@ -23,6 +38,11 @@ export class SessionSyncResource {
             throw toApiError(res.status, await safeJson(res));
         yield* parseNdjsonEntries(res, opts?.signal);
     }
+    /** 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`. */
     async getBlob(sessionId, key, hash, opts) {
         if (!SHA256_HEX_RE.test(hash))
             throw toApiError(400, { error: "blob hash must be 64 lowercase-hex chars" });
@@ -36,6 +56,13 @@ export class SessionSyncResource {
             throw toApiError(res.status, await safeJson(res));
         return new Uint8Array(await res.arrayBuffer());
     }
+    /** 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. */
     async putBlob(sessionId, hash, bytes, opts) {
         if (!SHA256_HEX_RE.test(hash))
             throw toApiError(400, { error: "blob hash must be 64 lowercase-hex chars" });
@@ -47,8 +74,14 @@ export class SessionSyncResource {
             signal: opts?.signal,
         });
         if (!res.ok)
-            throw toApiError(res.status, await safeJson(res));
+            throw toApiError(res.status, await safeJson(res)); // 400 mismatch / 413 too large / 501 / 502 write-failed
+        // 204 No Content — nothing to read.
     }
+    /** 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.
+     *  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) {
         return this.t.request({
             method: "POST",
@@ -57,6 +90,15 @@ 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).
+     *    - `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. */
     async import(sessionId, body, opts) {
         return this.t.request({
             method: "POST",
@@ -65,6 +107,14 @@ export class SessionSyncResource {
             signal: opts?.signal,
         });
     }
+    /** 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
+     *  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`;
+     *  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. */
     async importEntries(sessionId, stagingId, entries, opts) {
         const ndjson = await toNdjson(entries);
         const res = await this.t.openRaw({
@@ -79,6 +129,9 @@ 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. */
 async function toNdjson(entries) {
     let body = "";
     for await (const e of entries)

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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"}