@deepseek-ai/dsh-tool-cordis 0.1.2-alpha.2 → 0.1.2-alpha.4

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/extensions/tool-cordis/README.md
-README.md: 9f564044979e17f1db8b6329ecb95cc9b10fb51d
-README.zh.md: dd4945391d9e215c6db9eeac6b17184a1e5e7b8a
+README.md: 574a98ed7fe75e8af108906d80b2cd0c2e043fe8
+README.zh.md: d48d7539f8724834a2272eb7bed7e9b353f27edc

package/README.md

@@ -192,3 +192,5 @@ These limits define when the toolset is a poor fit or needs special care. They a
 None.
 
 </details>
+
+**Runtime invariant:** No companion is published. This model-facing adapter has no independent lifecycle stream; execution relations are owned by the capability seam it calls.

package/README.zh.md

@@ -192,3 +192,5 @@ Dynamic Cordis plugins temporarily extend the current DSH process. A Plugin uses
 无。
 
 </details>
+
+**运行时不变式：** 不发布伴生入口。这个模型侧 adapter 没有独立 lifecycle stream；执行关系由它调用的 capability seam 负责。

package/lib/index.js

@@ -821,7 +821,7 @@ const SERVICE_API = [
 		methods: [
 			{
 				signature: "abstract readonly language: string",
-				description: "The source language run expects `program` to be written in, as a lowercase identifier. Informational, not gating — a consumer that generates language-specific presentation (typed SDK stubs, usage instructions) switches on it and fails loud on a language it cannot present. Well-known values: `'typescript'` and `'python'`, those `dsh-tools` presents; only `'typescript'` has a published backend.",
+				description: "The source language run expects `program` to be written in, as a lowercase identifier. Informational, not gating — a consumer that generates language-specific presentation (typed SDK stubs, usage instructions) switches on it and fails loud on a language it cannot present. Well-known values: `'typescript'` and `'python'`, those `dsh-tools` presents; the TypeScript backend is released, the Python backend is experimental and private (not published).",
 				parameters: []
 			},
 			{
@@ -945,7 +945,7 @@ const SERVICE_API = [
 				throws: ["{@link ManualCompactionError} for expected busy, agent-cancellation, changed-span, summarization/shrink, commit-stage, or persistence failures; an aborted request preserves its exact abort reason. Failed attempts remain visible in the log."]
 			},
 			{
-				signature: "abstract compactRegion( start: number, end: number, agent: CompactionAgentContext, signal?: AbortSignal, ): Promise<CompactionResult>",
+				signature: "abstract compactRegion( start: SessionSeq, end: SessionSeq, agent: CompactionAgentContext, signal?: AbortSignal, ): Promise<CompactionResult>",
 				description: "Forcibly compact a range of surface nodes into a single summary node. `start` and `end` name an inclusive span by surface position, not numeric seq order; replacements can make visible seqs non-monotonic. Both edges must be balanced so assistant tool calls remain paired with their results. A model- backed implementation forwards cancellation and rejects active, missing, reversed, or unbalanced ranges. The target session is `agent.session`. Its replacement user message must use compactCheckpointSource with the transaction's `CompactionId`. Use toolPairingBalancedBefore and toolPairingBalancedAfter for the edge checks.",
 				parameters: [
 					{
@@ -2096,7 +2096,7 @@ const SERVICE_API = [
 				returns: "the live Agent or the stable Session-domain failure."
 			},
 			{
-				signature: "inspect( sessionId: SessionId, signal?: AbortSignal, ): Promise<{ meta: SessionHeader; events: SessionEvent[] }>",
+				signature: "inspect( sessionId: SessionId, signal?: AbortSignal, ): Promise<SessionInspection>",
 				description: "Inspect one attached or persisted Session without activating its Agent.",
 				parameters: [{
 					name: "sessionId",
@@ -2297,7 +2297,7 @@ const SERVICE_API = [
 		methods: [
 			{
 				signature: "abstract locate(meta: SessionHeader): SessionLocation | undefined",
-				description: "Resolve this backend's independent local artifact for a session without reading, creating, flushing, or otherwise materializing it. Backends such as SQLite that do not own one artifact per session return `undefined`.",
+				description: "Resolve this backend's independent local artifact for a session without reading, creating, flushing, or otherwise materializing it. A backend that does not own one artifact per Session returns `undefined`.",
 				parameters: [{
 					name: "meta",
 					description: "the immutable session header whose artifact is requested."
@@ -2323,11 +2323,14 @@ const SERVICE_API = [
 				throws: ["when this backend does not expose per-session raw artifacts."]
 			},
 			{
-				signature: "abstract create(meta: SessionHeader): Promise<void>",
+				signature: "abstract create(meta: SessionHeader, inheritedEventCount?: SessionLogOffset): Promise<void>",
 				description: "Register a new session's metadata. A backend MAY defer the physical write until the first append (lazy materialization), in which case a created-but-never-appended session is absent from list — abandoned sessions leave nothing behind.",
 				parameters: [{
 					name: "meta",
 					description: "the immutable header (id, version, cwd, lineage) to record."
+				}, {
+					name: "inheritedEventCount",
+					description: "exact fork-inherited prefix length. Required for a seeded header and omitted only for an unseeded header."
 				}]
 			},
 			{
@@ -2340,7 +2343,7 @@ const SERVICE_API = [
 			},
 			{
 				signature: "abstract append(id: SessionId, events: readonly SessionEvent[]): Promise<void>",
-				description: "Durably persist a batch of events. Honors the append-only and contiguous- seq contracts: the first event's `seq` MUST equal the stored next-seq (after `load` has durably closed any interrupted turn). Rejects non-JSON- serializable `event.data` with an error naming the offending event type.",
+				description: "Durably persist a batch of events. Honors the append-only and contiguous- seq contracts: the first event's `seq` MUST equal the stored next-seq (after `load` has durably closed any interrupted turn). Rejects non-JSON- serializable `event.data` with an error naming the offending event type. A seeded session's first materializing batch must reach its complete inherited prefix.",
 				parameters: [{
 					name: "id",
 					description: "the session the batch belongs to."
@@ -2395,8 +2398,8 @@ const SERVICE_API = [
 				returns: "a disposable immutable observation."
 			},
 			{
-				signature: "abstract readFrom(id: SessionId, fromSeq: number, signal?: AbortSignal): Promise<{ meta: SessionHeader; events: SessionEvent[] }>",
-				description: "Read the stored events from `fromSeq` onward — the read-from-seq primitive for read models that resume from a watermark (e.g. a persisted projection cache folding only the tail past its checkpoint). Unlike inspect, it is a detached physical suffix read: no preparation cache, torn-tail truncation, synthetic closers, or coordinator-state publication. Only events from the valid contiguous stored prefix are returned, so a torn fragment never reaches the caller. `fromSeq` at or beyond the stored prefix returns an empty event list (never an error). Backends whose medium can seek by seq (SQLite) read only the suffix; sequential media (JSONL, both encodings) still parse the whole artifact and skip forward — the primitive bounds what is RETURNED and refolded, not every backend's physical read.",
+				signature: "abstract readFrom(id: SessionId, fromSeq: SessionLogOffset, signal?: AbortSignal): Promise<SessionEventSuffix>",
+				description: "Read the stored events from `fromSeq` onward — the read-from-seq primitive for read models that resume from a watermark (e.g. a persisted projection cache folding only the tail past its checkpoint). Unlike inspect, it is a detached physical suffix read: no preparation cache, torn-tail truncation, synthetic closers, or coordinator-state publication. Only events from the valid contiguous stored prefix are returned, so a torn fragment never reaches the caller. `fromSeq` at or beyond the stored prefix returns an empty event list (never an error). A backend whose medium can seek by seq may read only the suffix; sequential media such as JSONL still parse the whole artifact and skip forward. The primitive bounds what is returned and refolded, not every backend's physical read.",
 				parameters: [
 					{
 						name: "id",
@@ -2404,14 +2407,14 @@ const SERVICE_API = [
 					},
 					{
 						name: "fromSeq",
-						description: "first event seq to include; a non-negative safe integer."
+						description: "first event offset to include."
 					},
 					{
 						name: "signal",
 						description: "optional cancellation for queued and backend read work."
 					}
 				],
-				returns: "the header and the stored events with `seq >= fromSeq`."
+				returns: "storage metadata, the requested offset, and stored events with `seq >= fromSeq`."
 			},
 			{
 				signature: "abstract list(signal?: AbortSignal): Promise<SessionHeader[]>",
@@ -2439,34 +2442,34 @@ const SERVICE_API = [
 		description: "The persisted projection cache service. Opens the `session_projcache` domain at init, checkpoints live sessions on a throttled write-behind (count/interval triggers from Config) plus three mandatory points — session creation, `turn/end`, and session disposal (the live-to-cold moment) — and serves the cached rows for a session header. Every durable write is fail-soft: failures log a warning and the cache self-heals on the next write.",
 		methods: [
 			{
-				signature: "cachedSnapshot( meta: SessionHeader, keys?: readonly Extract<keyof SessionProjectionMap, string>[], ): ProjectionSnapshot | undefined",
+				signature: "cachedSnapshot( meta: SessionHeader, inheritedEventCount: SessionLogOffset, keys?: readonly Extract<keyof SessionProjectionMap, string>[], ): ProjectionSnapshot | undefined",
 				description: "The zero-I/O listing read: whole values viewed straight from the stored rows (version-matching keys only), each cut carried with its watermark so a client value store can seed under its higher-seq-wins rule — as stale as the last durable checkpoint but never wrong, and never from an unrelated log (the caller's header is the identity witness). Fresher paths (the history tail baseline) supersede these values whenever a session is actually opened.",
-				parameters: [{
-					name: "meta",
-					description: "the listed session's header (identity witness; no log read)."
-				}, {
-					name: "keys",
-					description: "optional projection keys required by the caller's audience."
-				}],
-				returns: "the cut (`asOfSeq` = lowest served-row watermark), or `undefined` when no usable row exists for this lifecycle."
-			},
-			{
-				signature: "hydratePrepared( session: Session, meta: SessionHeader, events: readonly SessionEvent[], ): ProjectionSnapshot",
-				description: "Hydrate projection cells for an already-prepared Session without another persistence read. The cache seeds matching rows; the supplied exact log advances every unit to the observation cut. No checkpoint is written because the logical observation may contain recovery events not yet durable.",
 				parameters: [
 					{
-						name: "session",
-						description: "exact unpublished Session retained by persistence."
+						name: "meta",
+						description: "the listed session's header (identity witness; no log read)."
 					},
 					{
-						name: "meta",
-						description: "observed lifecycle header."
+						name: "inheritedEventCount",
+						description: "exact inherited prefix length that completes the checkpoint identity."
 					},
 					{
-						name: "events",
-						description: "exact logical event prefix represented by the observation."
+						name: "keys",
+						description: "optional projection keys required by the caller's audience."
 					}
 				],
+				returns: "the cut (`asOfSeq` = lowest served-row watermark), or `undefined` when no usable row exists for this lifecycle."
+			},
+			{
+				signature: "hydratePrepared( session: Session, events: readonly SessionEvent[], ): ProjectionSnapshot",
+				description: "Hydrate projection cells for an already-prepared Session without another persistence read. The cache seeds matching rows; the supplied exact log advances every unit to the observation cut. No checkpoint is written because the logical observation may contain recovery events not yet durable.",
+				parameters: [{
+					name: "session",
+					description: "exact unpublished Session retained by persistence."
+				}, {
+					name: "events",
+					description: "exact logical event prefix represented by the observation."
+				}],
 				returns: "all projection values at the event cut."
 			},
 			{
@@ -2479,15 +2482,22 @@ const SERVICE_API = [
 				returns: "resolution after durability and event emission."
 			},
 			{
-				signature: "coldSnapshot(meta: SessionHeader, events: readonly SessionEvent[]): ProjectionSnapshot",
+				signature: "coldSnapshot( meta: SessionHeader, inheritedEventCount: SessionLogOffset, events: readonly SessionEvent[], ): ProjectionSnapshot",
 				description: "Cold-read one session's projections from its complete log. Each unit is seeded from the identity-checked cached rows — the registry skips `apply` for the already-folded prefix (events at or below the row's `seq`) — and the refreshed checkpoint is written back (fail-soft, fire-and-forget), so the first cold read creates the cache row and later ones seed from it. The caller supplies the complete log in seq order: this service never consults the persistence layer.",
-				parameters: [{
-					name: "meta",
-					description: "the stored session header (identity witness)."
-				}, {
-					name: "events",
-					description: "the session's complete log, in seq order."
-				}],
+				parameters: [
+					{
+						name: "meta",
+						description: "the stored session header (identity witness)."
+					},
+					{
+						name: "inheritedEventCount",
+						description: "exact inherited prefix length for projection initialization and identity."
+					},
+					{
+						name: "events",
+						description: "the session's complete log, in seq order."
+					}
+				],
 				returns: "the projection cut at the log end."
 			}
 		]
@@ -2495,7 +2505,7 @@ const SERVICE_API = [
 	{
 		key: "sessionProjections",
 		summary: "`ctx.sessionProjections`: the projection unit table and its drive.",
-		description: "`ctx.sessionProjections`: the projection unit table and its drive. The service subscribes to `session/event` once; every committed event passes every registered unit's `apply` (eager drive), and a changed state reference in a client-visible unit notifies the change feed with the schema-validated view. Cells build lazily — a unit registered after events flowed, or a session older than the registry, folds `init` over the in-memory log on first touch (event or read). Registration is an effect (disposer rides the calling fiber): an unloaded domain plugin's key disappears from snapshots and clients read it as capability absence. A host reader either declares `sessionProjections` in its plugin `inject` or fails explicitly when the registry or required key is absent. Contributors may preserve optional registration through `ctx.inject(['sessionProjections'], ...)`. Registrants sharing a key share one unit and are counted: the same tool package mounted in N agent presets registers N times, and the key survives until the last one unloads.",
+		description: "`ctx.sessionProjections`: the projection unit table and its drive. The service subscribes to `session/event` once; every committed event passes every registered unit's `apply` (eager drive). A changed state reference computes the next client view; the change feed is notified only when its raw result changes by `Object.is`. Cells build lazily — a unit registered after events flowed, or a session older than the registry, folds `init` over the in-memory log on first touch (event or read). Registration is an effect (disposer rides the calling fiber): an unloaded domain plugin's key disappears from snapshots and clients read it as capability absence. A host reader either declares `sessionProjections` in its plugin `inject` or fails explicitly when the registry or required key is absent. Contributors may preserve optional registration through `ctx.inject(['sessionProjections'], ...)`. Registrants sharing a key share one unit and are counted: the same tool package mounted in N agent presets registers N times, and the key survives until the last one unloads.",
 		methods: [
 			{
 				signature: "register< K extends keyof SessionProjectionMap, S extends SessionProjectionStateMap[K], >( definition: Omit<ProjectionDefinition<K, S>, 'wire'> & { wire: NonNullable<ProjectionDefinition<K, S>['wire']> }, ): () => void",
@@ -2520,7 +2530,7 @@ const SERVICE_API = [
 				description: "Subscribe to the change feed. The registration is an effect on the calling context's fiber.",
 				parameters: [{
 					name: "listener",
-					description: "called once per client-visible unit whose state reference changed, per committed event."
+					description: "called once per client-visible unit whose raw view changed by `Object.is`, per committed event."
 				}],
 				returns: "the exact disposer that unsubscribes."
 			},
@@ -2570,7 +2580,7 @@ const SERVICE_API = [
 				returns: "one row per registered key."
 			},
 			{
-				signature: "restoreFloor(checkpoint: ProjectionCheckpoint): number | undefined",
+				signature: "restoreFloor(checkpoint: ProjectionCheckpoint): SessionLogOffset | undefined",
 				description: "The stored seq a restore tail read over `checkpoint` must start at: one event BELOW the lowest usable watermark (a row is usable when its `ver` matches the live unit's `stateVersion`; an absent or mismatched row pulls the floor to `0` — that key must refold the full log). The one-below anchor is load-bearing: the tail then proves how far the stored log still extends, so restore can detect a log that shrank below a row's watermark (crash-repair truncation) instead of serving the stale row as current — an empty tail read from the anchor yields an end below every watermark and the restore rejects for a full re-read.",
 				parameters: [{
 					name: "checkpoint",
@@ -2591,7 +2601,7 @@ const SERVICE_API = [
 				returns: "whole values per key with a usable row; empty when none."
 			},
 			{
-				signature: "restore( checkpoint: ProjectionCheckpoint, events: readonly SessionEvent[], baseSeq: number, header: SessionHeader, ): { snapshot: ProjectionSnapshot; checkpoint: ProjectionCheckpoint }",
+				signature: "restore( checkpoint: ProjectionCheckpoint, events: readonly SessionEvent[], baseSeq: SessionLogOffset, header: SessionHeader, inheritedEventCount: SessionLogOffset, ): { snapshot: ProjectionSnapshot; checkpoint: ProjectionCheckpoint }",
 				description: "Cold read: fold every persisted unit over a stored log suffix, seeding each from its checkpoint row when usable — the one read recipe (cached state + forward tail replay + `view`) applied without a live `Session`. Call with the events returned by a persistence `readFrom(id, restoreFloor(checkpoint))` and that same floor as `baseSeq`; the floor's one-below anchor makes the supplied end honest, so a shrunk log is detected here. A row is usable iff its `ver` matches the live unit's `stateVersion`, it does not predate `baseSeq` (`seq >= baseSeq - 1`), and it does not claim events past the supplied end (`seq <= endSeq`); an unusable row is discarded and its key refolds from `init` — which is only sound over the full log, so a discarded row with `baseSeq > 0` throws (the caller re-reads from seq 0, e.g. after a crash-repair truncation shrank the log below a row's watermark).",
 				parameters: [
 					{
@@ -2609,12 +2619,16 @@ const SERVICE_API = [
 					{
 						name: "header",
 						description: "immutable metadata for the Session being restored."
+					},
+					{
+						name: "inheritedEventCount",
+						description: "exact fork-inherited prefix length supplied to unit initialization."
 					}
 				],
 				returns: "the snapshot cut at the supplied log end (`asOfSeq` is the last supplied event's seq, `baseSeq - 1` for an empty tail) plus the refreshed checkpoint rows at that cut, ready for a durable write-back."
 			},
 			{
-				signature: "hydrate( session: Session, checkpoint: ProjectionCheckpoint, events: readonly SessionEvent[], baseSeq: number, ): ProjectionSnapshot",
+				signature: "hydrate( session: Session, checkpoint: ProjectionCheckpoint, events: readonly SessionEvent[], baseSeq: SessionLogOffset, ): ProjectionSnapshot",
 				description: "Restore an exact cut and install its states on the supplied prepared Session. A later publication reuses these cells; ordinary live reads and event drive advance any constructor-owned suffix exactly once.",
 				parameters: [
 					{
@@ -2965,7 +2979,7 @@ const SERVICE_API = [
 				returns: "a fresh array; mutating it does not affect the store."
 			},
 			{
-				signature: "fork(source: SessionForkSource, boundary?: number, childSessionId?: SessionId): Session",
+				signature: "fork(source: SessionForkSource, boundary?: SessionSeq, childSessionId?: SessionId): Session",
 				description: "Create a live child session from a stable prefix of a live source. `boundary` is an inclusive source event seq; omitted means the source's current last event. The selected slice may end with a between-turn event but must not end inside an open turn.",
 				parameters: [
 					{
@@ -3553,28 +3567,28 @@ const SERVICE_API = [
 				throws: ["when continuation services are unavailable or materialization fails."]
 			},
 			{
-				signature: "async followup( parent: Agent, childId: SessionId, content: ContentBlock[], options: SubagentFollowupOptions, ): Promise<MessageId>",
-				description: "Deliver one later message to a continuable child as its next FIFO turn. A resident child's Agent inbox accepts it directly (waking a `waiting` Activation), while an absent one is cold-resumed from its persisted Session. The Agent inbox is the only queue, so every accepted message has one observable order.",
+				signature: "async sendMessage( sender: Agent, targetId: SessionId, content: ContentBlock[], options: SubagentSendMessageOptions, ): Promise<MessageId>",
+				description: "Steer one model-authored message to the sender's direct parent or direct continuable child. A running target admits it at the nearest step boundary; an idle target starts a turn, and an absent direct child cold-resumes from persistence. The service derives durable sender attribution from the exact live sender. Caller cancellation stops only pre-acceptance work.",
 				parameters: [
 					{
-						name: "parent",
-						description: "the exact live direct parent authorizing this delivery."
+						name: "sender",
+						description: "exact live Agent authorizing and originating the message."
 					},
 					{
-						name: "childId",
-						description: "durable child session id."
+						name: "targetId",
+						description: "durable direct-parent or direct-child session id."
 					},
 					{
 						name: "content",
-						description: "user-role content to deliver."
+						description: "model-authored content to deliver."
 					},
 					{
 						name: "options",
-						description: "the message source fields and caller cancellation, which stops the operation only before inbox acceptance."
+						description: "caller cancellation before inbox acceptance."
 					}
 				],
 				returns: "the accepted message's inbox id.",
-				throws: ["when continuation services are unavailable, parent authority is rejected, or the message was not admitted."]
+				throws: ["when continuation services are unavailable, adjacency is rejected, or the message was not admitted."]
 			},
 			{
 				signature: "interrupt(targetSessionId: SessionId, authority: SubagentInterruptAuthority): void",
@@ -3588,35 +3602,6 @@ const SERVICE_API = [
 				}],
 				throws: ["{SubagentError} `UNAUTHORIZED` when the authority does not own the live target."]
 			},
-			{
-				signature: "async reportFrom( child: Agent, content: ContentBlock[], options: SubagentReportOptions, ): Promise<MessageId>",
-				description: "Deliver selected content from one live continuable child to its durable direct parent. The child is the authority credential; callers cannot name a recipient. Reporting does not conclude the child's turn or Activation.",
-				parameters: [
-					{
-						name: "child",
-						description: "exact live reporting child."
-					},
-					{
-						name: "content",
-						description: "selected model-facing content."
-					},
-					{
-						name: "options",
-						description: "parent scheduling and pre-acceptance cancellation."
-					}
-				],
-				returns: "the stable identity of the parent-accepted message.",
-				throws: ["when continuation services are unavailable, sender authorization fails, or the direct parent is not live."]
-			},
-			{
-				signature: "registerContinuableSetup(contribution: ContinuableSetupContribution): () => void",
-				description: "Compose one deployment capability into every continuable child's unpublished creation context on fresh creation and cold resume. Grants wait for the next Activation; removing the contribution revokes every resident installation immediately.",
-				parameters: [{
-					name: "contribution",
-					description: "synchronous child-scope installer."
-				}],
-				returns: "the exact Cordis effect disposer."
-			},
 			{
 				signature: "async drainContinuableDescendants(parents: readonly Agent[]): Promise<void>",
 				description: "Close continuable admission below exact live parent Agents, stop only their visible descendant Activations synchronously, then await admitted scoped materializations and release those forests child-first. The scoped cutoff lasts until each exact parent leaves the registry; unrelated parent trees remain live.",
@@ -3681,7 +3666,7 @@ const SERVICE_API = [
 			},
 			{
 				signature: "@Remote('prompt') async prompt(request: SubagentPromptRequest, signal: AbortSignal): Promise<SubagentPromptReceipt>",
-				description: "Deliver one browser-authored message to a continuable child through the exact live direct parent, retaining the caller-minted request identity and validated browser zone on the accepted message. Success identifies the message the child's FIFO inbox accepted; later execution is independent of this call.",
+				description: "Deliver one browser-authored message to a continuable child through the exact live direct parent, retaining the caller-minted request identity and validated browser zone on the accepted message. Success identifies the message the child's FIFO inbox accepted; later execution is independent of this call. Image parts are admitted and persisted through the attachment store before delivery, and the child's model must accept image input.",
 				parameters: [{
 					name: "request",
 					description: "durable address, minted identity, content, and optional browser zone."
@@ -3690,7 +3675,7 @@ const SERVICE_API = [
 					description: "carrier cancellation, owning the call until inbox acceptance."
 				}],
 				returns: "the accepted message's inbox identity.",
-				throws: ["{RemoteError} `gateway/bad-request`, `subagent/attachment-unsupported`, `subagent/invalid-time-zone`, `subagent/parent-unavailable`, `subagent/not-resumable`, `subagent/unauthorized`, `subagent/delivery-unavailable`, `gateway/cancelled`, or `gateway/internal`."]
+				throws: ["{RemoteError} `gateway/bad-request`, `subagent/attachment-invalid`, `subagent/invalid-time-zone`, `subagent/parent-unavailable`, `subagent/not-resumable`, `subagent/unauthorized`, `subagent/delivery-unavailable`, `gateway/cancelled`, or `gateway/internal`."]
 			},
 			{
 				signature: "@Remote('interruptByParent') interruptByParent( childSessionId: SessionId, parentSessionId: SessionId, mode: 'continuable', ): SubagentInterruptReceipt",
@@ -5619,6 +5604,14 @@ const TYPE_API = [
 		name: "Branded",
 		declaration: "export type Branded<B extends string> = string & {\n    readonly [BRAND]: B;\n};"
 	},
+	{
+		name: "BrandedNumber",
+		declaration: "export type BrandedNumber<B extends string> = number & {\n    readonly [BRAND]: B;\n};"
+	},
+	{
+		name: "ChunkRow",
+		declaration: "export type ChunkRow = {\n    type: 'text-chunks';\n    seq0: SessionSeqType;\n    time0: number;\n    data: TextRunData;\n} | {\n    type: 'reasoning-chunks';\n    seq0: SessionSeqType;\n    time0: number;\n    data: TextRunData;\n} | {\n    type: 'tool-call-chunks';\n    seq0: SessionSeqType;\n    time0: number;\n    data: ToolCallRunData;\n};"
+	},
 	{
 		name: "ChunkRowEvent",
 		declaration: "export type ChunkRowEvent = {\n    [Kind in ChunkRow['type']]: {\n        readonly type: `chunkrow/${Kind}`;\n        readonly seq: number;\n        readonly time: number;\n        readonly data: Extract<ChunkRow, {\n            readonly type: Kind;\n        }>['data'];\n    };\n}[ChunkRow['type']];"
@@ -5685,7 +5678,7 @@ const TYPE_API = [
 	},
 	{
 		name: "CommandResult",
-		declaration: "export type CommandResult = {\n    readonly kind: 'success';\n    readonly text?: string;\n    readonly sourceEventSeq?: number;\n} | {\n    readonly kind: 'error';\n    readonly text: string;\n};"
+		declaration: "export type CommandResult = {\n    readonly kind: 'success';\n    readonly text?: string;\n    readonly sourceEventSeq?: SessionSeq;\n} | {\n    readonly kind: 'error';\n    readonly text: string;\n};"
 	},
 	{
 		name: "CompactionAgentContext",
@@ -5697,7 +5690,7 @@ const TYPE_API = [
 	},
 	{
 		name: "CompactionResult",
-		declaration: "export interface CompactionResult {\n    compactionId: CompactionId;\n    sourceCommandId?: CommandId;\n    startSeq: number;\n    summarySeq: number;\n    endSeq: number;\n    summary: ContentBlock[];\n    shadowedRange: {\n        start: number;\n        end: number;\n    };\n    shadowedSeqs: number[];\n    shadowedTokenCount: number;\n}"
+		declaration: "export interface CompactionResult {\n    compactionId: CompactionId;\n    sourceCommandId?: CommandId;\n    startSeq: SessionSeq;\n    summarySeq: SessionSeq;\n    endSeq: SessionSeq;\n    summary: ContentBlock[];\n    shadowedRange: {\n        start: SessionSeq;\n        end: SessionSeq;\n    };\n    shadowedSeqs: SessionSeq[];\n    shadowedTokenCount: number;\n}"
 	},
 	{
 		name: "CompactionTrigger",
@@ -5739,10 +5732,6 @@ const TYPE_API = [
 		name: "ContinuableCreateSpec",
 		declaration: "export interface ContinuableCreateSpec {\n    readonly seed?: readonly SessionEvent[];\n}"
 	},
-	{
-		name: "ContinuableSetupContribution",
-		declaration: "export type ContinuableSetupContribution = (childCtx: Context) => () => void;"
-	},
 	{
 		name: "ContinuableStart",
 		declaration: "export interface ContinuableStart {\n    readonly childId: SessionId;\n    readonly messageId: MessageId;\n}"
@@ -5825,7 +5814,7 @@ const TYPE_API = [
 	},
 	{
 		name: "CreateAgentOptions",
-		declaration: "export interface CreateAgentOptions {\n    readonly sessionId: SessionId;\n    readonly meta?: {\n        readonly cwd?: string;\n        readonly parentSession?: SessionId;\n        readonly seedLength?: number;\n        readonly origin?: 'subagent';\n        readonly delegationDepth?: number;\n        readonly agentPreset?: string;\n    };\n    readonly seed?: readonly SessionEvent[];\n    readonly agentOptions?: AgentOptions;\n    readonly signal?: AbortSignal;\n    readonly setup?: AgentSetup;\n}"
+		declaration: "export interface CreateAgentOptions {\n    readonly sessionId: SessionId;\n    readonly meta?: {\n        readonly cwd?: string;\n        readonly parentSession?: SessionId;\n        readonly isSeeded?: boolean;\n        readonly origin?: 'subagent';\n        readonly delegationDepth?: number;\n        readonly agentPreset?: string;\n    };\n    readonly inheritedEventCount?: SessionLogOffset;\n    readonly seed?: readonly SessionEvent[];\n    readonly agentOptions?: AgentOptions;\n    readonly signal?: AbortSignal;\n    readonly setup?: AgentSetup;\n}"
 	},
 	{
 		name: "CreateGoalRequest",
@@ -5837,7 +5826,7 @@ const TYPE_API = [
 	},
 	{
 		name: "CreateSessionOptions",
-		declaration: "export interface CreateSessionOptions {\n    readonly seed?: readonly SessionEvent[];\n    readonly meta?: {\n        readonly cwd?: string;\n        readonly parentSession?: SessionId;\n        readonly createdAt?: number;\n        readonly seedLength?: number;\n        readonly origin?: 'subagent';\n        readonly delegationDepth?: number;\n        readonly agentPreset?: string;\n    };\n}"
+		declaration: "export interface CreateSessionOptions {\n    readonly seed?: readonly SessionEvent[];\n    readonly inheritedEventCount?: SessionLogOffset;\n    readonly meta?: {\n        readonly cwd?: string;\n        readonly parentSession?: SessionId;\n        readonly createdAt?: number;\n        readonly isSeeded?: boolean;\n        readonly origin?: 'subagent';\n        readonly delegationDepth?: number;\n        readonly agentPreset?: string;\n    };\n}"
 	},
 	{
 		name: "CreateTeamTaskRequest",
@@ -5995,10 +5984,6 @@ const TYPE_API = [
 		name: "EncodedImageAttachment",
 		declaration: "export interface EncodedImageAttachment {\n    mediaType: ImageMediaType;\n    data: string;\n    name?: string;\n}"
 	},
-	{
-		name: "EncodedImagePromptBlock",
-		declaration: "export interface EncodedImagePromptBlock extends EncodedImageAttachment {\n    readonly type: 'image';\n}"
-	},
 	{
 		name: "EpochHeader",
 		declaration: "export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    system?: string;\n    tools?: ToolSchema[];\n}"
@@ -6519,6 +6504,10 @@ const TYPE_API = [
 		name: "OneShotSubagentDescriptorData",
 		declaration: "export interface OneShotSubagentDescriptorData extends SubagentDescriptorBase {\n    readonly mode: 'one-shot';\n    readonly label?: string;\n}"
 	},
+	{
+		name: "OptionalSessionSeq",
+		declaration: "export type OptionalSessionSeq = SessionSeq | null;"
+	},
 	{
 		name: "PermissionSelect",
 		declaration: "export interface PermissionSelect {\n    options: PresetOption[];\n    currentValue: string;\n}"
@@ -6573,7 +6562,7 @@ const TYPE_API = [
 	},
 	{
 		name: "ProjectionChangeListener",
-		declaration: "export type ProjectionChangeListener = (session: Session, key: Extract<keyof SessionProjectionMap, string>, value: unknown, seq: number) => void;"
+		declaration: "export type ProjectionChangeListener = (session: Session, key: Extract<keyof SessionProjectionMap, string>, value: unknown, seq: SessionSeq) => void;"
 	},
 	{
 		name: "ProjectionCheckpoint",
@@ -6581,24 +6570,20 @@ const TYPE_API = [
 	},
 	{
 		name: "ProjectionCheckpointRow",
-		declaration: "export interface ProjectionCheckpointRow {\n    ver: number;\n    seq: number;\n    val: unknown;\n}"
+		declaration: "export interface ProjectionCheckpointRow {\n    ver: number;\n    seq: SessionSeqCursor;\n    val: unknown;\n}"
 	},
 	{
 		name: "ProjectionDefinition",
-		declaration: "export interface ProjectionDefinition<K extends keyof SessionProjectionStateMap, S extends SessionProjectionStateMap[K] = SessionProjectionStateMap[K]> {\n    key: K;\n    stateSchema: ZodType<S>;\n    init(header: SessionHeader): NoInfer<S>;\n    apply(state: NoInfer<S>, event: SessionEvent): NoInfer<S>;\n    wire?: K extends keyof SessionProjectionMap ? {\n        viewSchema: ZodType<SessionProjectionMap[K]>;\n        view(state: NoInfer<S>): SessionProjectionMap[K];\n    } : never;\n    stateVersion: number;\n}"
+		declaration: "export interface ProjectionDefinition<K extends keyof SessionProjectionStateMap, S extends SessionProjectionStateMap[K] = SessionProjectionStateMap[K]> {\n    key: K;\n    stateSchema: ZodType<S>;\n    init(header: SessionHeader, inheritedEventCount: SessionLogOffset): NoInfer<S>;\n    apply(state: NoInfer<S>, event: SessionEvent): NoInfer<S>;\n    wire?: K extends keyof SessionProjectionMap ? {\n        viewSchema: ZodType<SessionProjectionMap[K]>;\n        view(state: NoInfer<S>): SessionProjectionMap[K];\n    } : never;\n    stateVersion: number;\n}"
 	},
 	{
 		name: "ProjectionSnapshot",
-		declaration: "export interface ProjectionSnapshot {\n    asOfSeq: number;\n    values: Partial<SessionProjectionMap>;\n}"
+		declaration: "export interface ProjectionSnapshot {\n    asOfSeq: SessionSeqCursor;\n    values: Partial<SessionProjectionMap>;\n}"
 	},
 	{
 		name: "PromptAssembly",
 		declaration: "export interface PromptAssembly {\n    sections: AssembledSection[];\n    contexts: AssembledContext[];\n    tools: ToolSchema[];\n    variables: Record<string, string | undefined>;\n}"
 	},
-	{
-		name: "PromptContentPart",
-		declaration: "export type PromptContentPart = {\n    readonly type: 'text';\n    readonly text: string;\n} | {\n    readonly type: 'image';\n    readonly mediaType: ImageMediaType;\n    readonly data: string;\n    readonly name?: string;\n};"
-	},
 	{
 		name: "PromptContext",
 		declaration: "export interface PromptContext {\n    readonly name: string;\n    readonly order: number;\n    readonly text: string | ((context: AssembleContext) => string);\n}"
@@ -6621,7 +6606,7 @@ const TYPE_API = [
 	},
 	{
 		name: "PrunedEntry",
-		declaration: "export interface PrunedEntry {\n    readonly originalSeq: number;\n    readonly replacementSeq: number;\n    readonly callId: ToolCallId;\n    readonly charsBefore: number;\n    readonly charsAfter: number;\n}"
+		declaration: "export interface PrunedEntry {\n    readonly originalSeq: SessionSeq;\n    readonly replacementSeq: SessionSeq;\n    readonly callId: ToolCallId;\n    readonly charsBefore: number;\n    readonly charsAfter: number;\n}"
 	},
 	{
 		name: "PruneResult",
@@ -6717,7 +6702,7 @@ const TYPE_API = [
 	},
 	{
 		name: "RestoredSessionOptions",
-		declaration: "export interface RestoredSessionOptions {\n    readonly seed: SessionEvent[];\n    readonly meta: SessionHeader;\n    readonly seedSource: 'persistence';\n}"
+		declaration: "export interface RestoredSessionOptions {\n    readonly seed: SessionEvent[];\n    readonly meta: SessionHeader;\n    readonly inheritedEventCount: SessionLogOffset;\n    readonly seedSource: 'persistence';\n}"
 	},
 	{
 		name: "ResumeAgentOptions",
@@ -6801,7 +6786,7 @@ const TYPE_API = [
 	},
 	{
 		name: "Session",
-		declaration: "export class Session {\n    get surface(): SessionSurface;\n    readonly header: SessionHeader;\n    get id(): SessionId;\n    readonly firstLiveSeq: number;\n    static create(id: SessionId, seed?: readonly SessionEvent[], header?: SessionHeader): Session;\n    static fromRestore(id: SessionId, seed: readonly SessionEvent[], header: SessionHeader): Session;\n    get events(): readonly SessionEvent[];\n    get seq(): number;\n    append<T extends SessionEventType>(type: T, data: SessionEventMap[T], ...opts: T extends SurfaceEventType ? [\n        opts: SurfaceIntent\n    ] : [\n    ]): SessionEvent<T>;\n    requestHeader(): EpochHeader | undefined;\n    requestContext(): RequestContext | undefined;\n    deriveMessages(): Message[];\n    deriveEventMessage(event: SessionEvent): Message | null;\n}"
+		declaration: "export class Session {\n    get surface(): SessionSurface;\n    readonly header: SessionHeader;\n    readonly inheritedEventCount: SessionLogOffset;\n    get id(): SessionId;\n    readonly firstLiveSeq: SessionLogOffset;\n    static create(id: SessionId, seed?: readonly SessionEvent[], header?: SessionHeader, inheritedEventCount?: SessionLogOffset): Session;\n    static fromRestore(id: SessionId, seed: readonly SessionEvent[], header: SessionHeader, inheritedEventCount: SessionLogOffset): Session;\n    eventAt(seq: SessionSeq): SessionEvent | undefined;\n    snapshotEvents(fromSeq: SessionLogOffset = SessionLogOffset(0), toSeqExclusive: SessionLogOffset = this.seq): readonly SessionEvent[];\n    ownEvents(): readonly SessionEvent[];\n    isOwnSeq(seq: SessionSeq): boolean;\n    get seq(): SessionLogOffset;\n    append<T extends SessionEventType>(type: T, data: SessionEventMap[T], ...opts: T extends SurfaceEventType ? [\n        opts: SurfaceIntent\n    ] : [\n    ]): SessionEvent<T>;\n    requestHeader(): EpochHeader | undefined;\n    requestContext(): RequestContext | undefined;\n    deriveMessages(): Message[];\n    deriveEventMessage(event: SessionEvent): Message | null;\n}"
 	},
 	{
 		name: "SessionAddress",
@@ -6849,7 +6834,7 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionEvent",
-		declaration: "export type SessionEvent<T extends SessionEventType = SessionEventType> = {\n    [K in SessionEventType]: {\n        type: K;\n        seq: number;\n        time: number;\n        data: SessionEventMap[K];\n        ignorable?: true;\n    } & (K extends SurfaceEventType ? {\n        sourceEventSeqs?: number[];\n        surfaceOp?: SurfaceOp;\n    } : object);\n}[T];"
+		declaration: "export type SessionEvent<T extends SessionEventType = SessionEventType> = {\n    [K in SessionEventType]: {\n        type: K;\n        seq: SessionSeq;\n        time: number;\n        data: SessionEventMap[K];\n        ignorable?: true;\n    } & (K extends SurfaceEventType ? {\n        sourceEventSeqs?: SessionSeq[];\n        surfaceOp?: SurfaceOp;\n    } : object);\n}[T];"
 	},
 	{
 		name: "SessionEventEntry",
@@ -6865,11 +6850,11 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionEventReadRequest",
-		declaration: "export interface SessionEventReadRequest {\n    sessionId: SessionId;\n    seq: number;\n    before?: number;\n    after?: number;\n}"
+		declaration: "export interface SessionEventReadRequest {\n    sessionId: SessionId;\n    seq: SessionSeq;\n    before?: number;\n    after?: number;\n}"
 	},
 	{
 		name: "SessionEventRecord",
-		declaration: "export interface SessionEventRecord {\n    sessionId: SessionId;\n    seq: number;\n    type: SessionEventType;\n    time: number;\n    surface: SessionEventSurface;\n}"
+		declaration: "export interface SessionEventRecord {\n    sessionId: SessionId;\n    seq: SessionSeq;\n    type: SessionEventType;\n    time: number;\n    surface: SessionEventSurface;\n}"
 	},
 	{
 		name: "SessionEventResultFilter",
@@ -6891,13 +6876,17 @@ const TYPE_API = [
 		name: "SessionEventSearchRequest",
 		declaration: "export interface SessionEventSearchRequest {\n    sessionId: SessionId;\n    query: string;\n    filters?: readonly SessionEventMetadataFilter[];\n    limit?: number;\n    cursor?: SessionSearchCursor;\n}"
 	},
+	{
+		name: "SessionEventSuffix",
+		declaration: "export interface SessionEventSuffix extends SessionStorageMetadata {\n    readonly fromSeq: SessionLogOffset;\n    readonly events: readonly SessionEvent[];\n}"
+	},
 	{
 		name: "SessionEventSurface",
 		declaration: "export type SessionEventSurface = 'current' | 'shadowed' | 'log-only';"
 	},
 	{
 		name: "SessionEventTrace",
-		declaration: "export interface SessionEventTrace {\n    target: SessionEventRecord;\n    replacedBy?: number;\n    replacementChain: number[];\n    replacedEventSeqs: number[];\n    sourceEventSeqs: number[];\n    derivedEventSeqs: number[];\n}"
+		declaration: "export interface SessionEventTrace {\n    target: SessionEventRecord;\n    replacedBy?: SessionSeq;\n    replacementChain: SessionSeq[];\n    replacedEventSeqs: SessionSeq[];\n    sourceEventSeqs: SessionSeq[];\n    derivedEventSeqs: SessionSeq[];\n}"
 	},
 	{
 		name: "SessionEventTraceObservation",
@@ -6905,7 +6894,7 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionEventTraceRequest",
-		declaration: "export interface SessionEventTraceRequest {\n    sessionId: SessionId;\n    seq: number;\n}"
+		declaration: "export interface SessionEventTraceRequest {\n    sessionId: SessionId;\n    seq: SessionSeq;\n}"
 	},
 	{
 		name: "SessionEventType",
@@ -6913,11 +6902,11 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionEventWindow",
-		declaration: "export interface SessionEventWindow {\n    session: SessionHeader;\n    target: SessionEvent;\n    events: SessionEvent[];\n    startSeq: number;\n    endSeq: number;\n}"
+		declaration: "export interface SessionEventWindow {\n    session: SessionHeader;\n    inheritedEventCount: SessionLogOffset;\n    target: SessionEvent;\n    events: SessionEvent[];\n    startSeq: SessionSeq;\n    endSeq: SessionSeq;\n}"
 	},
 	{
 		name: "SessionFollowFrame",
-		declaration: "export type SessionFollowFrame = {\n    readonly type: 'snapshot';\n    readonly header: SessionHeader;\n    readonly cursor: number;\n    readonly records: readonly SessionHistoryRecord[];\n    readonly hasMore: boolean;\n    readonly projections: SessionProjectionBaseline;\n} | SessionEventEntry;"
+		declaration: "export type SessionFollowFrame = {\n    readonly type: 'snapshot';\n    readonly header: SessionWireHeader;\n    readonly cursor: number;\n    readonly records: readonly SessionHistoryRecord[];\n    readonly hasMore: boolean;\n    readonly projections: SessionProjectionBaseline;\n} | SessionEventEntry;"
 	},
 	{
 		name: "SessionFollowRequest",
@@ -6937,7 +6926,7 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionHeader",
-		declaration: "export interface SessionHeader {\n    readonly version: number;\n    readonly id: SessionId;\n    readonly createdAt: number;\n    readonly cwd?: string;\n    readonly parentSession?: SessionId;\n    readonly seedLength?: number;\n    readonly origin?: 'subagent';\n    readonly delegationDepth?: number;\n    readonly agentPreset?: string;\n}"
+		declaration: "export interface SessionHeader {\n    readonly version: number;\n    readonly id: SessionId;\n    readonly createdAt: number;\n    readonly cwd?: string;\n    readonly parentSession?: SessionId;\n    readonly isSeeded: boolean;\n    readonly origin?: 'subagent';\n    readonly delegationDepth?: number;\n    readonly agentPreset?: string;\n}"
 	},
 	{
 		name: "SessionHistoryRecord",
@@ -6949,7 +6938,7 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionInspection",
-		declaration: "export interface SessionInspection {\n    readonly meta: SessionHeader;\n    readonly events: readonly SessionEvent[];\n}"
+		declaration: "export interface SessionInspection extends SessionStorageMetadata {\n    readonly events: readonly SessionEvent[];\n}"
 	},
 	{
 		name: "SessionJob",
@@ -6975,13 +6964,17 @@ const TYPE_API = [
 		name: "SessionLocation",
 		declaration: "export interface SessionLocation {\n    readonly kind: string;\n    readonly path: string;\n}"
 	},
+	{
+		name: "SessionLogOffset",
+		declaration: "export type SessionLogOffset = BrandedNumber<'SessionLogOffset'>;"
+	},
 	{
 		name: "SessionLogSnapshot",
-		declaration: "export interface SessionLogSnapshot {\n    session: SessionHeader;\n    events: SessionEvent[];\n}"
+		declaration: "export interface SessionLogSnapshot {\n    session: SessionHeader;\n    inheritedEventCount: SessionLogOffset;\n    events: SessionEvent[];\n}"
 	},
 	{
 		name: "SessionObservation",
-		declaration: "export interface SessionObservation extends Disposable {\n    readonly source: 'live' | 'prepared';\n    readonly header: SessionHeader;\n    readonly events: readonly SessionEvent[];\n    readonly cursor: number;\n    readonly revision?: SessionPersistenceRevision;\n    readonly projections?: ProjectionSnapshot;\n    retain(): SessionObservation;\n}"
+		declaration: "export interface SessionObservation extends Disposable {\n    readonly source: 'live' | 'prepared';\n    readonly header: SessionHeader;\n    readonly events: readonly SessionEvent[];\n    readonly inheritedEventCount: SessionLogOffsetType;\n    readonly cursor: SessionSeqCursor;\n    readonly revision?: SessionPersistenceRevision;\n    readonly projections?: ProjectionSnapshot;\n    retain(): SessionObservation;\n}"
 	},
 	{
 		name: "SessionObservationOptions",
@@ -7061,7 +7054,7 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionRawArtifact",
-		declaration: "export interface SessionRawArtifact {\n    readonly meta: SessionHeader;\n    readonly filename: string;\n    readonly content: string;\n}"
+		declaration: "export interface SessionRawArtifact extends SessionStorageMetadata {\n    readonly filename: string;\n    readonly content: string;\n}"
 	},
 	{
 		name: "SessionRecord",
@@ -7131,21 +7124,33 @@ const TYPE_API = [
 		name: "SessionSelectModelValue",
 		declaration: "export interface SessionSelectModelValue {\n    readonly selected: ModelSelection;\n}"
 	},
+	{
+		name: "SessionSeq",
+		declaration: "export type SessionSeq = BrandedNumber<'SessionSeq'>;"
+	},
+	{
+		name: "SessionSeqCursor",
+		declaration: "export type SessionSeqCursor = SessionSeq | -1;"
+	},
 	{
 		name: "SessionStartSource",
 		declaration: "export type SessionStartSource = 'startup' | 'resume' | 'clear' | 'compact';"
 	},
+	{
+		name: "SessionStorageMetadata",
+		declaration: "export interface SessionStorageMetadata {\n    readonly meta: SessionHeader;\n    readonly inheritedEventCount: SessionLogOffset;\n}"
+	},
 	{
 		name: "SessionSummary",
 		declaration: "export interface SessionSummary {\n    readonly sessionId: SessionId;\n    readonly updatedAt: number;\n    readonly running: boolean;\n    readonly blank: boolean;\n    readonly parentSessionId?: SessionId;\n    readonly origin?: 'subagent';\n    readonly cwd?: string;\n    readonly projections?: SessionProjectionHints;\n}"
 	},
 	{
 		name: "SessionSurface",
-		declaration: "export interface SessionSurface {\n    readonly nodes: readonly number[];\n    readonly replaceGeneration: number;\n}"
+		declaration: "export interface SessionSurface {\n    readonly nodes: readonly SessionSeq[];\n    readonly replaceGeneration: number;\n}"
 	},
 	{
 		name: "SessionSurfaceSnapshot",
-		declaration: "export interface SessionSurfaceSnapshot {\n    session: SessionHeader;\n    capturedThroughSeq: number | null;\n    events: SurfaceEvent[];\n}"
+		declaration: "export interface SessionSurfaceSnapshot {\n    session: SessionHeader;\n    inheritedEventCount: SessionLogOffset;\n    capturedThroughSeq: OptionalSessionSeq;\n    events: SurfaceEvent[];\n}"
 	},
 	{
 		name: "SessionTelemetryRecord",
@@ -7165,7 +7170,7 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionTitleEventData",
-		declaration: "export interface SessionTitleEventData {\n    readonly title: string;\n    readonly messageSeqs: number[];\n    readonly source: SessionTitleSource;\n}"
+		declaration: "export interface SessionTitleEventData {\n    readonly title: string;\n    readonly messageSeqs: SessionSeq[];\n    readonly source: SessionTitleSource;\n}"
 	},
 	{
 		name: "SessionTitleModelProvenance",
@@ -7189,11 +7194,11 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionTitleProviderResult",
-		declaration: "export interface SessionTitleProviderResult {\n    readonly title: string;\n    readonly messageSeqs: readonly number[];\n    readonly model?: SessionTitleModelProvenance;\n}"
+		declaration: "export interface SessionTitleProviderResult {\n    readonly title: string;\n    readonly messageSeqs: readonly SessionSeq[];\n    readonly model?: SessionTitleModelProvenance;\n}"
 	},
 	{
 		name: "SessionTitleSnapshot",
-		declaration: "export interface SessionTitleSnapshot extends SessionTitleEventData {\n    readonly eventSeq: number;\n    readonly updatedAt: number;\n}"
+		declaration: "export interface SessionTitleSnapshot extends SessionTitleEventData {\n    readonly eventSeq: SessionSeq;\n    readonly updatedAt: number;\n}"
 	},
 	{
 		name: "SessionTitleSource",
@@ -7201,7 +7206,7 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionTitleUserMessage",
-		declaration: "export interface SessionTitleUserMessage {\n    readonly seq: number;\n    readonly text: string;\n}"
+		declaration: "export interface SessionTitleUserMessage {\n    readonly seq: SessionSeq;\n    readonly text: string;\n}"
 	},
 	{
 		name: "SessionUpdateQueueRequest",
@@ -7213,7 +7218,15 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionWireEvent",
-		declaration: "export interface SessionWireEvent {\n    readonly type: string;\n    readonly seq: number;\n    readonly time: number;\n    readonly data: JsonValue;\n    readonly ignorable?: true;\n    readonly sourceEventSeqs?: number[];\n    readonly surfaceOp?: SurfaceOp;\n}"
+		declaration: "export interface SessionWireEvent {\n    readonly type: string;\n    readonly seq: number;\n    readonly time: number;\n    readonly data: JsonValue;\n    readonly ignorable?: true;\n    readonly sourceEventSeqs?: number[];\n    readonly surfaceOp?: SessionWireSurfaceOp;\n}"
+	},
+	{
+		name: "SessionWireHeader",
+		declaration: "export interface SessionWireHeader {\n    readonly version: number;\n    readonly id: SessionId;\n    readonly createdAt: number;\n    readonly cwd?: string;\n    readonly parentSession?: SessionId;\n    readonly seedLength?: number;\n    readonly origin?: 'subagent';\n    readonly delegationDepth?: number;\n    readonly agentPreset?: string;\n}"
+	},
+	{
+		name: "SessionWireSurfaceOp",
+		declaration: "export type SessionWireSurfaceOp = 'append' | {\n    readonly op: 'replace';\n    readonly start: number;\n    readonly end: number;\n};"
 	},
 	{
 		name: "SettingsApplies",
@@ -7415,10 +7428,6 @@ const TYPE_API = [
 		name: "SubagentDescriptorData",
 		declaration: "export type SubagentDescriptorData = OneShotSubagentDescriptorData | ContinuableSubagentDescriptorData;"
 	},
-	{
-		name: "SubagentFollowupOptions",
-		declaration: "export interface SubagentFollowupOptions {\n    readonly source: MessageSource;\n    readonly signal: AbortSignal;\n}"
-	},
 	{
 		name: "SubagentInterruptAuthority",
 		declaration: "export type SubagentInterruptAuthority = {\n    readonly kind: 'user';\n    readonly parentSessionId: SessionId;\n} | {\n    readonly kind: 'ancestor';\n    readonly agent: Agent;\n};"
@@ -7431,17 +7440,13 @@ const TYPE_API = [
 		name: "SubagentListEntry",
 		declaration: "export type SubagentListEntry = {\n    readonly kind: 'child';\n    readonly id: SessionId;\n    readonly activity: 'running' | 'inactive';\n    readonly hasChildren: boolean;\n} & ({\n    readonly mode: 'one-shot';\n    readonly label?: string;\n} | {\n    readonly mode: 'continuable';\n    readonly label: string;\n}) | {\n    readonly kind: 'diagnostic';\n    readonly id: SessionId;\n    readonly reason: 'corrupt' | 'unsupported' | 'unavailable';\n};"
 	},
-	{
-		name: "SubagentPromptContentPart",
-		declaration: "export type SubagentPromptContentPart = ContentBlock | EncodedImagePromptBlock;"
-	},
 	{
 		name: "SubagentPromptReceipt",
 		declaration: "export interface SubagentPromptReceipt {\n    readonly messageId: MessageId;\n}"
 	},
 	{
 		name: "SubagentPromptRequest",
-		declaration: "export interface SubagentPromptRequest {\n    readonly requestId: SubagentPromptRequestId;\n    readonly parentSessionId: SessionId;\n    readonly childSessionId: SessionId;\n    readonly mode: 'continuable';\n    readonly content: readonly SubagentPromptContentPart[];\n    readonly clientTimeZone?: string;\n}"
+		declaration: "export interface SubagentPromptRequest {\n    readonly requestId: SubagentPromptRequestId;\n    readonly parentSessionId: SessionId;\n    readonly childSessionId: SessionId;\n    readonly mode: 'continuable';\n    readonly content: readonly PromptContentPart[];\n    readonly clientTimeZone?: string;\n}"
 	},
 	{
 		name: "SubagentPromptRequestId",
@@ -7451,14 +7456,6 @@ const TYPE_API = [
 		name: "SubagentProvider",
 		declaration: "export interface SubagentProvider {\n    readonly name: string;\n    readonly capabilities: SubagentCapabilities;\n    readonly inheritsParentContext: boolean;\n    readonly agentRouteDefaults?: Readonly<{\n        provider: string;\n        model: string;\n    }>;\n    start(request: ResolvedSubagentStartRequest): Promise<SubagentRun>;\n    prepareContinuable?(request: ContinuableCreateRequest): Promise<ContinuableCreateSpec>;\n}"
 	},
-	{
-		name: "SubagentReportDelivery",
-		declaration: "export type SubagentReportDelivery = 'quiet' | 'next-step';"
-	},
-	{
-		name: "SubagentReportOptions",
-		declaration: "export interface SubagentReportOptions {\n    readonly delivery: SubagentReportDelivery;\n    readonly signal: AbortSignal;\n}"
-	},
 	{
 		name: "SubagentResult",
 		declaration: "export interface SubagentResult {\n    readonly output: ContentBlock[];\n    readonly structured?: unknown;\n    readonly diagnostic?: string;\n    readonly stopReason: SubagentStopReason;\n}"
@@ -7481,7 +7478,11 @@ const TYPE_API = [
 	},
 	{
 		name: "SubagentRuntime",
-		declaration: "export class SubagentRuntime extends TypertRemoteService {\n    constructor(ctx: Context);\n    async startContinuable(spec: ContinuableStartSpec): Promise<ContinuableStart>;\n    async followup(parent: Agent, childId: SessionId, content: ContentBlock[], options: SubagentFollowupOptions): Promise<MessageId>;\n    interrupt(targetSessionId: SessionId, authority: SubagentInterruptAuthority): void;\n    async reportFrom(child: Agent, content: ContentBlock[], options: SubagentReportOptions): Promise<MessageId>;\n    registerContinuableSetup(contribution: ContinuableSetupContribution): () => void;\n    async drainContinuableDescendants(parents: readonly Agent[]): Promise<void>;\n    async drainContinuableChildren(parent: Agent, childIds: readonly SessionId[]): Promise<void>;\n    listChildren(parentSessionId: SessionId, signal?: AbortSignal): Promise<SubagentListEntry[]>;\n    listDescendants(rootSessionId: SessionId, signal?: AbortSignal): Promise<SubagentDescendantListEntry[]>;\n    @Remote('list')\n    async remoteExportList(parentSessionId: SessionId, signal: AbortSignal): Promise<SubagentCatalog>;\n    @Remote('prompt')\n    async prompt(request: SubagentPromptRequest, signal: AbortSignal): Promise<SubagentPromptReceipt>;\n    @Remote('interruptByParent')\n    interruptByParent(childSessionId: SessionId, parentSessionId: SessionId, mode: 'continuable'): SubagentInterruptReceipt;\n    registerProvider(provider: SubagentProvider): () => void;\n    getProvider(name: string): SubagentProvider | un /* …truncated — full shape in source */"
+		declaration: "export class SubagentRuntime extends TypertRemoteService {\n    constructor(ctx: Context);\n    async startContinuable(spec: ContinuableStartSpec): Promise<ContinuableStart>;\n    async sendMessage(sender: Agent, targetId: SessionId, content: ContentBlock[], options: SubagentSendMessageOptions): Promise<MessageId>;\n    interrupt(targetSessionId: SessionId, authority: SubagentInterruptAuthority): void;\n    async drainContinuableDescendants(parents: readonly Agent[]): Promise<void>;\n    async drainContinuableChildren(parent: Agent, childIds: readonly SessionId[]): Promise<void>;\n    listChildren(parentSessionId: SessionId, signal?: AbortSignal): Promise<SubagentListEntry[]>;\n    listDescendants(rootSessionId: SessionId, signal?: AbortSignal): Promise<SubagentDescendantListEntry[]>;\n    @Remote('list')\n    async remoteExportList(parentSessionId: SessionId, signal: AbortSignal): Promise<SubagentCatalog>;\n    @Remote('prompt')\n    async prompt(request: SubagentPromptRequest, signal: AbortSignal): Promise<SubagentPromptReceipt>;\n    @Remote('interruptByParent')\n    interruptByParent(childSessionId: SessionId, parentSessionId: SessionId, mode: 'continuable'): SubagentInterruptReceipt;\n    registerProvider(provider: SubagentProvider): () => void;\n    getProvider(name: string): SubagentProvider | undefined;\n    list(): string[];\n    async start(name: string, request: SubagentStartRequest): Promise<SubagentRun>;\n}"
+	},
+	{
+		name: "SubagentSendMessageOptions",
+		declaration: "export interface SubagentSendMessageOptions {\n    readonly signal: AbortSignal;\n}"
 	},
 	{
 		name: "SubagentStartRequest",
@@ -7561,11 +7562,11 @@ const TYPE_API = [
 	},
 	{
 		name: "SurfaceIntent",
-		declaration: "export interface SurfaceIntent {\n    surfaceOp: SurfaceOp;\n    sourceEventSeqs?: number[];\n}"
+		declaration: "export interface SurfaceIntent {\n    surfaceOp: SurfaceOp;\n    sourceEventSeqs?: SessionSeq[];\n}"
 	},
 	{
 		name: "SurfaceOp",
-		declaration: "export type SurfaceOp = 'append' | {\n    op: 'replace';\n    start: number;\n    end: number;\n};"
+		declaration: "export type SurfaceOp = 'append' | {\n    op: 'replace';\n    start: SessionSeq;\n    end: SessionSeq;\n};"
 	},
 	{
 		name: "SystemPrompt",
@@ -7705,7 +7706,7 @@ const TYPE_API = [
 	},
 	{
 		name: "TokenMeasurement",
-		declaration: "export interface TokenMeasurement {\n    readonly logRevision: number;\n    readonly baseline: TokenMeasurementBaseline;\n    readonly surfaceDeltaTokens: number;\n    readonly totalTokens: number;\n    readonly surfaceTokens: number;\n    readonly nodes: readonly TokenSurfaceNode[];\n}"
+		declaration: "export interface TokenMeasurement {\n    readonly logRevision: SessionLogOffset;\n    readonly baseline: TokenMeasurementBaseline;\n    readonly surfaceDeltaTokens: number;\n    readonly totalTokens: number;\n    readonly surfaceTokens: number;\n    readonly nodes: readonly TokenSurfaceNode[];\n}"
 	},
 	{
 		name: "TokenMeasurementBaseline",
@@ -7713,7 +7714,7 @@ const TYPE_API = [
 	},
 	{
 		name: "TokenSurfaceNode",
-		declaration: "export interface TokenSurfaceNode {\n    readonly seq: number;\n    readonly tokens: number;\n    readonly heuristicTokens: number;\n}"
+		declaration: "export interface TokenSurfaceNode {\n    readonly seq: SessionSeq;\n    readonly tokens: number;\n    readonly heuristicTokens: number;\n}"
 	},
 	{
 		name: "TokenUsage",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-tool-cordis",
   "description": "Self-referential cordis toolset: inspect the live runtime, mount and dispose model-written plugins",
-  "version": "0.1.2-alpha.2",
+  "version": "0.1.2-alpha.4",
   "publishConfig": {
     "access": "public"
   },
@@ -18,40 +18,33 @@
       "types": "./lib/types/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
-    },
     "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
   "files": [
     "lib/index.js",
-    "lib/invariant.js",
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-cordis-host-runner": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-scope": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-agent": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-agent": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-cordis-host-runner": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-scope": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.4",
     "@deepseek-ai/cordis": "^4.0.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@deepseek-ai/dsh-agent": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-cordis-host-runner": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-scope": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-agent": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-cordis-host-runner": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-scope": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.4",
     "@deepseek-ai/cordis": "^4.0.2"
   }
 }

package/lib/invariant.js

@@ -1,23 +0,0 @@
-//#region lib/types/invariant.js
-/**
-* Package-owned invariant companion for `@deepseek-ai/dsh-tool-cordis`.
-* @module @deepseek-ai/dsh-tool-cordis/invariant
-*/
-const PACKAGE_NAME = "@deepseek-ai/dsh-tool-cordis";
-/** Cordis companion plugin name. */
-const name = "tool-cordis-invariant";
-/** Service required before the companion can reserve package ownership. */
-const inject = ["invariants"];
-/**
-* No runtime invariant: this model-facing adapter has no independent lifecycle stream; execution
-* relations are owned by the capability seam it calls.
-*/
-const install = () => {};
-/**
-* Register this package's invariant companion.
-* @param ctx - Cordis context carrying the invariant service.
-* @returns the installed registration's disposer after setup succeeds.
-*/
-const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-//#endregion
-export { apply, inject, name };

package/lib/types/invariant.d.ts

@@ -1,16 +0,0 @@
-/**
- * Package-owned invariant companion for `@deepseek-ai/dsh-tool-cordis`.
- * @module @deepseek-ai/dsh-tool-cordis/invariant
- */
-import type { Context } from '@deepseek-ai/cordis';
-/** Cordis companion plugin name. */
-export declare const name = "tool-cordis-invariant";
-/** Service required before the companion can reserve package ownership. */
-export declare const inject: string[];
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;
-//# sourceMappingURL=invariant.d.ts.map