@khorsheed/dsh-file-preview 0.1.0 → 0.2.0

package/lib/typert.host.js

@@ -93,7 +93,7 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-file-preview/types#FilePreviewList',
         schema: _khorsheed_dsh_file_preview_filePreview_list_result$schema,
       },
-      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":316,"column":3},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":368,"column":9},
     },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/read',
@@ -134,7 +134,7 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-file-preview/types#FilePreviewRead',
         schema: _khorsheed_dsh_file_preview_filePreview_read_result$schema,
       },
-      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":392,"column":9},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":458,"column":9},
     },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/reveal',
@@ -175,7 +175,7 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-file-preview/types#FilePreviewReveal',
         schema: _khorsheed_dsh_file_preview_filePreview_reveal_result$schema,
       },
-      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":469,"column":9},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":535,"column":9},
     },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/turnFiles',
@@ -205,32 +205,32 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-file-preview/types#FilePreviewTurnMap',
         schema: _khorsheed_dsh_file_preview_filePreview_turnFiles_result$schema,
       },
-      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":347,"column":3},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":405,"column":9},
     },
   ],
   model: {
     "services": [
       {
-        "description": "The `filePreview` Remote service: session-scoped read-only file inspection for web surfaces. `list` is a pure fold over the session log (no filesystem access); `read` resolves the path against the session cwd and serves current text content through `ctx.fs` (or a browser URL for images), capped by config. Image bytes ride a dedicated host route so the browser loads them natively without bloating the RPC channel.",
+        "description": "The `filePreview` Remote service: session-scoped read-only file inspection for web surfaces. `list` is a fold over the session log, then filtered to the paths that still exist on disk (resolved against the session cwd and stat-ed per call); `read` resolves the path against the session cwd and serves current text content through `ctx.fs` (or a browser URL for images), capped by config. Image bytes ride a dedicated host route so the browser loads them natively without bloating the RPC channel.",
         "summary": "The `filePreview` Remote service: session-scoped read-only file inspection for web surfaces.",
         "tags": [],
-        "jsDoc": "/**\n * The `filePreview` Remote service: session-scoped read-only file inspection\n * for web surfaces. `list` is a pure fold over the session log (no filesystem\n * access); `read` resolves the path against the session cwd and serves current\n * text content through `ctx.fs` (or a browser URL for images), capped by\n * config. Image bytes ride a dedicated host route so the browser loads them\n * natively without bloating the RPC channel.\n */",
+        "jsDoc": "/**\n * The `filePreview` Remote service: session-scoped read-only file inspection\n * for web surfaces. `list` is a fold over the session log, then filtered to the\n * paths that still exist on disk (resolved against the session cwd and stat-ed\n * per call); `read` resolves the path against the session cwd and serves current\n * text content through `ctx.fs` (or a browser URL for images), capped by\n * config. Image bytes ride a dedicated host route so the browser loads them\n * natively without bloating the RPC channel.\n */",
         "key": "filePreview",
         "exportName": "FilePreviewService",
         "members": [
           {
             "kind": "method",
             "name": "list",
-            "signature": "@Remote('list') list(agent: Agent): FilePreviewList",
+            "signature": "@Remote('list') async list(agent: Agent): Promise<FilePreviewList>",
             "summary": "List the files one session wrote or edited: the log fold plus any bash-written files the collector verified (the S2 seam), merged so a captured path the fold already knows keeps its log-derived entry.",
-            "jsDoc": "/**\n * List the files one session wrote or edited: the log fold plus any\n * bash-written files the collector verified (the S2 seam), merged so a\n * captured path the fold already knows keeps its log-derived entry.\n * @param agent - owning live agent; its session log is the data source.\n * @returns first-seen files capped by `maxFiles`, with the log watermark.\n */"
+            "jsDoc": "/**\n * List the files one session wrote or edited: the log fold plus any\n * bash-written files the collector verified (the S2 seam), merged so a\n * captured path the fold already knows keeps its log-derived entry. Only\n * paths that currently exist on disk are returned — a file the session\n * wrote and later deleted is history, not a product.\n * @param agent - owning live agent; its session log is the data source.\n * @returns existing first-seen files capped by `maxFiles`, with the log watermark.\n */"
           },
           {
             "kind": "method",
             "name": "turnFiles",
-            "signature": "@Remote('turnFiles') turnFiles(agent: Agent): FilePreviewTurnMap",
+            "signature": "@Remote('turnFiles') async turnFiles(agent: Agent): Promise<FilePreviewTurnMap>",
             "summary": "Every turn's file mutations for the turn-tail card — the single source of truth the card renders (the client's old write/edit-only fold retired).",
-            "jsDoc": "/**\n * Every turn's file mutations for the turn-tail card — the single source of\n * truth the card renders (the client's old write/edit-only fold retired).\n * Built by folding the session log per turn (write/edit calls, Code Mode\n * dispatches borrowing the root call's turn, and render-intent paths from\n * result diff meta) and merging the collector's bash-written captures by\n * their own turn. The fold is cached per session and invalidated by the log\n * watermark, so repeated card fetches do not refold. A path touched in two\n * turns appears in BOTH turn groups — per-turn attribution is exact.\n * @param agent - owning live agent; its session log is the data source.\n * @returns per-turn file groups plus the scanned watermark.\n */"
+            "jsDoc": "/**\n * Every turn's file mutations for the turn-tail card — the single source of\n * truth the card renders (the client's old write/edit-only fold retired).\n * Built by folding the session log per turn (write/edit calls, Code Mode\n * dispatches borrowing the root call's turn, and render-intent paths from\n * result diff meta) and merging the collector's bash-written captures by\n * their own turn. The fold is cached per session and invalidated by the log\n * watermark, so repeated card fetches do not refold. A path touched in two\n * turns appears in BOTH turn groups — per-turn attribution is exact. Only\n * paths that currently exist on disk are returned (a deleted temp script is\n * history, not a product); existence is probed fresh on every call, so the\n * cached fold is filtered per request rather than cached.\n * @param agent - owning live agent; its session log is the data source.\n * @returns existing per-turn file groups plus the scanned watermark.\n */"
           },
           {
             "kind": "method",
@@ -256,14 +256,30 @@ export const TYPERT = {
             "name": "AgentCancelCause",
             "declaration": "export type AgentCancelCause = { readonly kind: 'user'; } | { readonly kind: 'parent'; } | { readonly kind: 'hook'; readonly reason: string; } | { readonly kind: 'disposed'; };"
           },
+          {
+            "name": "AgentMessageSource",
+            "declaration": "export interface AgentMessageSource {\n    readonly kind: 'agent-message';\n    readonly form: 'relay';\n    readonly senderSessionId: SessionId;\n}"
+          },
           {
             "name": "AgentOptions",
-            "declaration": "export interface AgentOptions {\n    provider?: string;\n    model?: string;\n    maxTokens?: number;\n}"
+            "declaration": "export interface AgentOptions {\n    provider?: string;\n    model?: string;\n    reasoningEffort?: ReasoningEffortId;\n    maxTokens?: number;\n    subagentDepth?: number;\n}"
           },
           {
             "name": "AgentStatus",
             "declaration": "export type AgentStatus = 'idle' | 'running';"
           },
+          {
+            "name": "ApprovalOutcome",
+            "declaration": "export type ApprovalOutcome = 'allowed-once' | 'rejected' | 'cancelled' | 'unavailable';"
+          },
+          {
+            "name": "ApprovalPolicy",
+            "declaration": "export type ApprovalPolicy = 'ask' | 'never';"
+          },
+          {
+            "name": "ApprovalRequestId",
+            "declaration": "export type ApprovalRequestId = Branded<'ApprovalRequestId'>;"
+          },
           {
             "name": "AssistantMessage",
             "declaration": "export interface AssistantMessage extends Message {\n    readonly role: 'assistant';\n    readonly source: ModelMessageSource;\n}"
@@ -281,20 +297,24 @@ export const TYPERT = {
             "declaration": "export type Branded<B extends string> = string & { readonly [BRAND]: B; };"
           },
           {
-            "name": "CallId",
-            "declaration": "export type CallId = Branded<'CallId'>;"
+            "name": "BrandedNumber",
+            "declaration": "export type BrandedNumber<B extends string> = number & { readonly [BRAND]: B; };"
           },
           {
             "name": "CancelOptions",
             "declaration": "export interface CancelOptions {\n    keepInbox?: boolean | undefined;\n}"
           },
           {
-            "name": "CodeDispatchEventData",
-            "declaration": "export interface CodeDispatchEventData extends CodeDispatchStartEventData {\n    isError: boolean;\n    content: ContentBlock[];\n}"
+            "name": "CommandId",
+            "declaration": "export type CommandId = Branded<'CommandId'>;"
+          },
+          {
+            "name": "CommandSource",
+            "declaration": "export type CommandSource = CommandSourceMap[keyof CommandSourceMap];"
           },
           {
-            "name": "CodeDispatchStartEventData",
-            "declaration": "export interface CodeDispatchStartEventData {\n    rootCallId: CallId;\n    parentCallId: CallId;\n    subCallId: CallId;\n    name: string;\n    arguments: unknown;\n}"
+            "name": "CommandSourceMap",
+            "declaration": "export interface CommandSourceMap {\n    user: { kind: 'user'; };\n}"
           },
           {
             "name": "ContentBlock",
@@ -316,6 +336,10 @@ export const TYPERT = {
             "name": "ContextSnapshotSection",
             "declaration": "export interface ContextSnapshotSection {\n    readonly name: string;\n    readonly text: string;\n}"
           },
+          {
+            "name": "ContinuableSubagentDescriptorData",
+            "declaration": "export interface ContinuableSubagentDescriptorData extends SubagentDescriptorBase {\n    readonly mode: 'continuable';\n    readonly label: string;\n    readonly agentProvider?: string;\n    readonly agentModel?: string;\n    readonly agentReasoningEffort?: ReasoningEffortId;\n    readonly persona?: string;\n    readonly toolFilter?: ToolRestriction;\n}"
+          },
           {
             "name": "EpochHeader",
             "declaration": "export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    system?: string;\n    tools?: ToolSchema[];\n}"
@@ -418,16 +442,28 @@ export const TYPERT = {
           },
           {
             "name": "MessageSourceMap",
-            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    plugin: { kind: 'plugin'; plugin: string; } & ContextFormed;\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n}"
+            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    plugin: { kind: 'plugin'; plugin: string; } & ContextFormed;\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n}"
           },
           {
             "name": "ModelMessageSource",
             "declaration": "export interface ModelMessageSource extends AssistantProvenance {\n    kind: 'model';\n}"
           },
+          {
+            "name": "OneShotSubagentDescriptorData",
+            "declaration": "export interface OneShotSubagentDescriptorData extends SubagentDescriptorBase {\n    readonly mode: 'one-shot';\n    readonly label?: string;\n}"
+          },
           {
             "name": "ProviderRequestId",
             "declaration": "export type ProviderRequestId = Branded<'ProviderRequestId'>;"
           },
+          {
+            "name": "PtcDispatchEventData",
+            "declaration": "export interface PtcDispatchEventData extends PtcDispatchStartEventData {\n    isError: boolean;\n    content: ContentBlock[];\n}"
+          },
+          {
+            "name": "PtcDispatchStartEventData",
+            "declaration": "export interface PtcDispatchStartEventData {\n    rootCallId: ToolCallId;\n    parentCallId: ToolCallId;\n    subCallId: ToolCallId;\n    name: string;\n    arguments: unknown;\n}"
+          },
           {
             "name": "ReasoningBlock",
             "declaration": "export interface ReasoningBlock {\n    type: 'reasoning';\n    text: string;\n}"
@@ -446,19 +482,79 @@ export const TYPERT = {
           },
           {
             "name": "RequestHeaderReason",
-            "declaration": "export type RequestHeaderReason = 'initial' | 'resume' | 'change';"
+            "declaration": "export type RequestHeaderReason = 'initial' | 'resume' | 'change' | 'series';"
+          },
+          {
+            "name": "RoomCreatedEvent",
+            "declaration": "export interface RoomCreatedEvent {\n    readonly version: 1;\n}"
+          },
+          {
+            "name": "RoomDispatchEvent",
+            "declaration": "export interface RoomDispatchEvent {\n    readonly targets: readonly string[];\n    readonly text: string;\n}"
+          },
+          {
+            "name": "RoomGoalEvent",
+            "declaration": "export interface RoomGoalEvent {\n    readonly text: string;\n}"
+          },
+          {
+            "name": "RoomJsonValue",
+            "declaration": "export type RoomJsonValue = null | boolean | number | string | RoomJsonValue[] | { [key: string]: RoomJsonValue; };"
+          },
+          {
+            "name": "RoomMemberAddedEvent",
+            "declaration": "export interface RoomMemberAddedEvent {\n    readonly name: string;\n    readonly kind: 'main-agent' | 'cli';\n    readonly provider?: string;\n    readonly instructions?: string;\n    readonly invitedBy: 'human' | 'agent';\n    readonly cwd?: string;\n    readonly childSessionId?: SessionId;\n}"
+          },
+          {
+            "name": "RoomMemberRemovedEvent",
+            "declaration": "export interface RoomMemberRemovedEvent {\n    readonly name: string;\n}"
+          },
+          {
+            "name": "RoomMemberUpdatedEvent",
+            "declaration": "export interface RoomMemberUpdatedEvent {\n    readonly name: string;\n    readonly rename?: string;\n    readonly instructions?: string | null;\n    readonly cwd?: string | null;\n    readonly childSessionId?: SessionId;\n}"
+          },
+          {
+            "name": "RoomRelayEvent",
+            "declaration": "export interface RoomRelayEvent {\n    readonly id: string;\n    readonly from: string;\n    readonly to: string;\n    readonly content: string;\n    readonly provenance?: Record<string, RoomJsonValue>;\n}"
+          },
+          {
+            "name": "RoomRelayResolvedEvent",
+            "declaration": "export interface RoomRelayResolvedEvent {\n    readonly id: string;\n    readonly state: 'confirmed' | 'dismissed' | 'sent';\n}"
+          },
+          {
+            "name": "RoomRunStateEvent",
+            "declaration": "export interface RoomRunStateEvent {\n    readonly member: string;\n    readonly state: 'running' | 'done' | 'cancelled' | 'failed';\n    readonly startedAt: number;\n    readonly elapsedMs?: number;\n    readonly error?: string;\n}"
+          },
+          {
+            "name": "RoomSpeechEvent",
+            "declaration": "export interface RoomSpeechEvent {\n    readonly member: string;\n    readonly text: string;\n    readonly childSessionId?: SessionId;\n    readonly durationMs?: number;\n}"
+          },
+          {
+            "name": "RoomTaskAddedEvent",
+            "declaration": "export interface RoomTaskAddedEvent {\n    readonly id: string;\n    readonly member: string;\n    readonly title: string;\n    readonly status: 'pending' | 'in_progress';\n    readonly blockedBy?: string;\n}"
+          },
+          {
+            "name": "RoomTaskEditedEvent",
+            "declaration": "export interface RoomTaskEditedEvent {\n    readonly id: string;\n    readonly title?: string;\n    readonly blockedBy?: string | null;\n}"
+          },
+          {
+            "name": "RoomTaskUpdatedEvent",
+            "declaration": "export interface RoomTaskUpdatedEvent {\n    readonly id: string;\n    readonly status: 'in_progress' | 'done' | 'cancelled' | 'failed';\n}"
+          },
+          {
+            "name": "SandboxMode",
+            "declaration": "export type SandboxMode = 'read-only' | 'workspace-write' | 'danger-full-access';"
           },
           {
             "name": "Session",
-            "declaration": "export class Session {\n    get surface(): SessionSurface;\n    readonly header: SessionHeader;\n    get id(): SessionId;\n    readonly firstLiveSeq: number;\n    get events(): readonly SessionEvent[];\n    get seq(): number;\n    append<T extends SessionEventType>(type: T, data: SessionEventMap[T], ...opts: T extends SurfaceEventType ? [opts: SurfaceIntent] : []): 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    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 ? [opts: SurfaceIntent] : []): SessionEvent<T>;\n    requestHeader(): EpochHeader | undefined;\n    requestContext(): RequestContext | undefined;\n    deriveMessages(): Message[];\n    deriveEventMessage(event: SessionEvent): Message | null;\n}"
           },
           {
             "name": "SessionEvent",
-            "declaration": "export type SessionEvent<T extends SessionEventType = SessionEventType> = { [K in SessionEventType]: { type: K; seq: number; time: number; data: SessionEventMap[K]; ignorable?: true; } & (K extends SurfaceEventType ? { sourceEventSeqs?: number[]; surfaceOp?: SurfaceOp; } : object) }[T];"
+            "declaration": "export type SessionEvent<T extends SessionEventType = SessionEventType> = { [K in SessionEventType]: { type: K; seq: SessionSeq; time: number; data: SessionEventMap[K]; ignorable?: true; } & (K extends SurfaceEventType ? { sourceEventSeqs?: SessionSeq[]; surfaceOp?: SurfaceOp; } : object) }[T];"
           },
           {
             "name": "SessionEventMap",
-            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'assistant/chunk': { turn: number; step: number; chunk: StreamChunk; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; usage?: TokenUsage; interrupted?: true; };\n    'tool/call': { turn: number; step: number; callId: CallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; }; meta?: JsonValue; };\n    'todo/write': { todos: TodoItem[]; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; };\n    'request/context': RequestContext;\n    'session/end-seed': Record<string, never>;\n    'tool/code-dispatch-start': CodeDispatchStartEventData;\n    'tool/code-dispatch': CodeDispatchEventData;\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n}"
+            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'assistant/chunk': { turn: number; step: number; chunk: StreamChunk; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; usage?: TokenUsage; interrupted?: true; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': Record<string, never>;\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/code-dispatch-start': PtcDispatchStartEventData;\n    'tool/code-dispatch': PtcDispatchEventData;\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'subagent/descriptor': SubagentDescriptorData;\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'agent-preset/selected': { agentPreset: string; };\n    'room/created': RoomCreatedEvent;\n    'room/member-added': RoomMemberAddedEvent;\n    'room/member-updated': RoomMemberUpdatedEvent;\n    'room/member-removed': RoomMemberRemovedEvent;\n    'room/dispatch': RoomDispatchEvent;\n    'room/speech': RoomSpeechEvent;\n    'room/run-state': RoomRunStateEvent;\n    'room/relay': RoomRelayEvent;\n    'room/relay-resolved': RoomRelayResolvedEvent;\n    'room/task-added': RoomTaskAddedEvent;\n    'room/task-updated': RoomTaskUpdatedEvent;\n    'room/task-edited': RoomTaskEditedEvent;\n    'room/goal': RoomGoalEvent;\n}"
           },
           {
             "name": "SessionEventType",
@@ -466,19 +562,55 @@ export const TYPERT = {
           },
           {
             "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": "SessionId",
             "declaration": "export type SessionId = Branded<'SessionId'>;"
           },
+          {
+            "name": "SessionLogOffset",
+            "declaration": "export type SessionLogOffset = BrandedNumber<'SessionLogOffset'>;"
+          },
+          {
+            "name": "SessionSeq",
+            "declaration": "export type SessionSeq = BrandedNumber<'SessionSeq'>;"
+          },
           {
             "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": "SessionTitleEventData",
+            "declaration": "export interface SessionTitleEventData {\n    readonly title: string;\n    readonly messageSeqs: SessionSeq[];\n    readonly source: SessionTitleSource;\n}"
+          },
+          {
+            "name": "SessionTitleModelProvenance",
+            "declaration": "export interface SessionTitleModelProvenance {\n    readonly provider: string;\n    readonly model: string;\n}"
+          },
+          {
+            "name": "SessionTitleProviderId",
+            "declaration": "export type SessionTitleProviderId = Branded<'SessionTitleProviderId'>;"
+          },
+          {
+            "name": "SessionTitleSource",
+            "declaration": "export type SessionTitleSource = { readonly kind: 'fallback'; } | { readonly kind: 'provider'; readonly provider: SessionTitleProviderId; readonly model?: SessionTitleModelProvenance; } | { readonly kind: 'user'; };"
           },
           {
             "name": "StreamChunk",
-            "declaration": "export type StreamChunk = { type: 'block-start'; index: number; blockType: ContentBlockType; } | { type: 'text-delta'; index: number; text: string; } | { type: 'reasoning-delta'; index: number; text: string; } | { type: 'tool-call-delta'; index: number; id: CallId; name?: string; argumentsDelta: string; } | { type: 'block-end'; index: number; block: ContentBlock; } | { type: 'usage'; usage: TokenUsage; } | { type: 'finish'; reason: FinishReason; replayState?: ReplayEnvelope; };"
+            "declaration": "export type StreamChunk = { type: 'block-start'; index: number; blockType: ContentBlockType; } | { type: 'text-delta'; index: number; text: string; } | { type: 'reasoning-delta'; index: number; text: string; } | { type: 'tool-call-delta'; index: number; id: ToolCallId; name?: string; argumentsDelta: string; } | { type: 'block-end'; index: number; block: ContentBlock; } | { type: 'usage'; usage: TokenUsage; } | { type: 'finish'; reason: FinishReason; replayState?: ReplayEnvelope; };"
+          },
+          {
+            "name": "SubagentDescriptorBase",
+            "declaration": "export interface SubagentDescriptorBase {\n    readonly version: number;\n    readonly mode: 'one-shot' | 'continuable';\n    readonly provider: string;\n}"
+          },
+          {
+            "name": "SubagentDescriptorData",
+            "declaration": "export type SubagentDescriptorData = OneShotSubagentDescriptorData | ContinuableSubagentDescriptorData;"
+          },
+          {
+            "name": "SubagentSettledMessageSource",
+            "declaration": "export interface SubagentSettledMessageSource {\n    readonly kind: 'subagent-settled';\n    readonly form: 'notice';\n    readonly summary: string;\n    readonly senderSessionId: SessionId;\n}"
           },
           {
             "name": "SurfaceEventType",
@@ -486,11 +618,11 @@ export const TYPERT = {
           },
           {
             "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' | { op: 'replace'; start: number; end: number; };"
+            "declaration": "export type SurfaceOp = 'append' | { op: 'replace'; start: SessionSeq; end: SessionSeq; };"
           },
           {
             "name": "TextBlock",
@@ -502,19 +634,27 @@ export const TYPERT = {
           },
           {
             "name": "TokenUsage",
-            "declaration": "export interface TokenUsage {\n    inputTokens: number;\n    outputTokens: number;\n    cacheReadTokens?: number;\n    cacheWriteTokens?: number;\n    reasoningTokens?: number;\n}"
+            "declaration": "export interface TokenUsage {\n    inputTokens: number;\n    outputTokens: number;\n    totalTokens?: number;\n    cacheReadTokens?: number;\n    cacheWriteTokens?: number;\n    reasoningTokens?: number;\n}"
           },
           {
             "name": "ToolCallBlock",
-            "declaration": "export interface ToolCallBlock {\n    type: 'tool-call';\n    id: CallId;\n    name: string;\n    arguments: string;\n}"
+            "declaration": "export interface ToolCallBlock {\n    type: 'tool-call';\n    id: ToolCallId;\n    name: string;\n    arguments: string;\n}"
+          },
+          {
+            "name": "ToolCallId",
+            "declaration": "export type ToolCallId = Branded<'ToolCallId'>;"
           },
           {
             "name": "ToolMessageSource",
-            "declaration": "export interface ToolMessageSource {\n    kind: 'tool';\n    callId: CallId;\n}"
+            "declaration": "export interface ToolMessageSource {\n    kind: 'tool';\n    callId: ToolCallId;\n}"
+          },
+          {
+            "name": "ToolRestriction",
+            "declaration": "export interface ToolRestriction {\n    readonly allow?: readonly string[];\n    readonly deny?: readonly string[];\n}"
           },
           {
             "name": "ToolResultBlock",
-            "declaration": "export interface ToolResultBlock {\n    type: 'tool-result';\n    toolCallId: CallId;\n    content: ContentBlock[];\n    isError?: boolean;\n}"
+            "declaration": "export interface ToolResultBlock {\n    type: 'tool-result';\n    toolCallId: ToolCallId;\n    content: ContentBlock[];\n    isError?: boolean;\n}"
           },
           {
             "name": "ToolResultMessage",

package/lib/typert.remote-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typert.remote-client.d.ts","names":["list","read","reveal","turnFiles"],"sources":["../src/index.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;IA2TEA,I;IA4EMC,I;IA6EAC,M;IA1HNC,S;;;IA/BAH,kB;IA4EMC,kB;IA6EAC,oB;IA1HNC,uB;;;;;;IA/BAH,wB;IA4EMC,wB;IA6EAC,0B;IA1HNC,6B","ignoreList":[]}
+{"version":3,"file":"typert.remote-client.d.ts","names":["list","read","reveal","turnFiles"],"sources":["../src/index.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;IA+WQA,I;IA0FAC,I;IA6EAC,M;IAlIAC,S;;;IArCAH,kB;IA0FAC,kB;IA6EAC,oB;IAlIAC,uB;;;;;;IArCAH,wB;IA0FAC,wB;IA6EAC,0B;IAlIAC,6B","ignoreList":[]}

package/lib/typert.remote-client.js

@@ -90,7 +90,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@khorsheed/dsh-file-preview/types#FilePreviewList',
         schema: _khorsheed_dsh_file_preview_filePreview_list_result$schema,
       },
-      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":316,"column":3},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":368,"column":9},
     },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/read',
@@ -131,7 +131,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@khorsheed/dsh-file-preview/types#FilePreviewRead',
         schema: _khorsheed_dsh_file_preview_filePreview_read_result$schema,
       },
-      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":392,"column":9},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":458,"column":9},
     },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/reveal',
@@ -172,7 +172,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@khorsheed/dsh-file-preview/types#FilePreviewReveal',
         schema: _khorsheed_dsh_file_preview_filePreview_reveal_result$schema,
       },
-      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":469,"column":9},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":535,"column":9},
     },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/turnFiles',
@@ -202,7 +202,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@khorsheed/dsh-file-preview/types#FilePreviewTurnMap',
         schema: _khorsheed_dsh_file_preview_filePreview_turnFiles_result$schema,
       },
-      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":347,"column":3},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":405,"column":9},
     },
   ],
 }

package/lib/types/bash-writes.js

@@ -305,7 +305,7 @@ export class BashWriteCollector {
     #replay(session) {
         this.#pending.set(session.id, new Map());
         this.#captured.set(session.id, new Map());
-        for (const event of session.events)
+        for (const event of session.snapshotEvents())
             this.#onEvent(session, event);
     }
     #onEvent(session, event) {

package/lib/types/fold.d.ts

@@ -26,7 +26,8 @@ export declare function diffsFromResultMeta(meta: unknown): readonly FilePreview
  * first-seen order and deduplicated by display path; a later occurrence
  * refreshes the entry's op and location without moving it, and each write/edit
  * tool result appends its change's diff to the entry's `diffs` in event order.
- * Nested Code Mode file dispatches (`tool/code-dispatch` events) count too —
+ * Nested Code Mode file dispatches (`tool/code-dispatch` events, or
+ * `tool/ptc-dispatch` on seats running the PTC rename) count too —
  * they carry no turn/step of their own, so the entry borrows the enclosing
  * root call's location.
  * @param events - the session's events in ascending seq order.
@@ -55,11 +56,12 @@ export type TurnFilesByTurn = ReadonlyMap<number, ReadonlyMap<string, TurnFileFa
  * single source of truth. Unlike {@link foldFilePreview}, this does NOT dedupe
  * a path to its last occurrence: a file touched in two turns appears in BOTH
  * turn maps, so each turn's card lists exactly what that turn mutated.
- * write/edit calls register with their own turn; nested Code Mode dispatches
- * borrow the enclosing root call's turn (dispatch events carry none); a
- * `tool/result` whose presentation meta carries diffs registers its paths (the
- * render-intent vocabulary) with the result's turn, and per-turn line deltas
- * are summed from the diffs. A `write` whose result carries no diffs is a
+ * Reads leave no card entry (the card is the mutation vocabulary — write/edit
+ * only), so a pure-read call never registers; write/edit calls register with
+ * their own turn; nested Code Mode dispatches borrow the enclosing root call's
+ * turn (dispatch events carry none); a `tool/result` whose presentation meta
+ * carries diffs registers its paths (the render-intent vocabulary) with the
+ * result's turn, and per-turn line deltas are summed from the diffs. A `write` whose result carries no diffs is a
  * create (the write tool records no diffs when the file had no prior content):
  * its full written content — read from the call arguments, which the log keeps
  * — is the added-line count, once per file per turn.

package/lib/types/fold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fold.d.ts","sourceRoot":"","sources":["../../src/fold.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAE9G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG5D,OAAO,KAAK,EAAqC,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAQnG,uEAAuE;AACvE,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAA;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,2EAA2E;AAC3E,MAAM,MAAM,qBAAqB,GAAG;IAClC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,gCAAgC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAA;AAmBD,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAOvG;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,qBAAqB,EAAE,GAAG,SAAS,CAc/F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CA8DlG;AAED,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uFAAuF;IACvF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,4FAA4F;AAC5F,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;AAuCpF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,eAAe,CAyHtF"}
+{"version":3,"file":"fold.d.ts","sourceRoot":"","sources":["../../src/fold.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAE9G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG5D,OAAO,KAAK,EAAqC,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAiBnG,uEAAuE;AACvE,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAA;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,2EAA2E;AAC3E,MAAM,MAAM,qBAAqB,GAAG;IAClC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,gCAAgC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAA;AAmBD,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAOvG;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,qBAAqB,EAAE,GAAG,SAAS,CAc/F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAiElG;AAED,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uFAAuF;IACvF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,4FAA4F;AAC5F,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;AAuCpF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,eAAe,CAiItF"}

package/lib/types/fold.js

@@ -1,6 +1,14 @@
 /** Pure log fold over the files a session read, wrote, or edited. @module @khorsheed/dsh-file-preview/fold */
 /** Tool names whose calls record a touched file path. */
 const FILE_TOOL_NAMES = new Set(['read', 'write', 'edit']);
+/**
+ * Settled nested-dispatch event names, matched by name (feature detection,
+ * never a version check): `tool/code-dispatch` is the Code Mode name every
+ * host through 0.1.2-rc.1 emits; `tool/ptc-dispatch` is the PTC rename later
+ * 0.1.2 seats move to. Both carry the same settled-dispatch payload, so one
+ * branch serves either.
+ */
+const DISPATCH_EVENT_NAMES = new Set(['tool/code-dispatch', 'tool/ptc-dispatch']);
 /** The argument key carrying the touched path (shared by all three file tools). */
 const FILE_PATH_ARGUMENT = 'file_path';
 /**
@@ -57,7 +65,8 @@ export function diffsFromResultMeta(meta) {
  * first-seen order and deduplicated by display path; a later occurrence
  * refreshes the entry's op and location without moving it, and each write/edit
  * tool result appends its change's diff to the entry's `diffs` in event order.
- * Nested Code Mode file dispatches (`tool/code-dispatch` events) count too —
+ * Nested Code Mode file dispatches (`tool/code-dispatch` events, or
+ * `tool/ptc-dispatch` on seats running the PTC rename) count too —
  * they carry no turn/step of their own, so the entry borrows the enclosing
  * root call's location.
  * @param events - the session's events in ascending seq order.
@@ -88,16 +97,19 @@ export function foldFilePreview(events, maxFiles) {
             record(target, event.seq, event.data.turn, event.data.step);
             continue;
         }
-        if (event.type === 'tool/code-dispatch') {
+        if (DISPATCH_EVENT_NAMES.has(event.type)) {
             // The dispatch event IS the settled outcome: a failed sub-call changed
-            // nothing, so only successful file touches record.
-            if (event.data.isError)
+            // nothing, so only successful file touches record. The PTC rename keeps
+            // the code-dispatch payload shape (the ptc name has no SessionEventMap
+            // row yet), so the data reads through the declared constituent.
+            const dispatch = event;
+            if (dispatch.data.isError)
                 continue;
-            const target = targetFromArguments(event.data.name, event.data.arguments);
+            const target = targetFromArguments(dispatch.data.name, dispatch.data.arguments);
             if (target === undefined)
                 continue;
-            const site = callSites.get(String(event.data.rootCallId)) ?? { turn: 0, step: 0 };
-            record(target, event.seq, site.turn, site.step);
+            const site = callSites.get(String(dispatch.data.rootCallId)) ?? { turn: 0, step: 0 };
+            record(target, dispatch.seq, site.turn, site.step);
             continue;
         }
         if (event.type === 'tool/result') {
@@ -172,11 +184,12 @@ function resultCallFacts(message) {
  * single source of truth. Unlike {@link foldFilePreview}, this does NOT dedupe
  * a path to its last occurrence: a file touched in two turns appears in BOTH
  * turn maps, so each turn's card lists exactly what that turn mutated.
- * write/edit calls register with their own turn; nested Code Mode dispatches
- * borrow the enclosing root call's turn (dispatch events carry none); a
- * `tool/result` whose presentation meta carries diffs registers its paths (the
- * render-intent vocabulary) with the result's turn, and per-turn line deltas
- * are summed from the diffs. A `write` whose result carries no diffs is a
+ * Reads leave no card entry (the card is the mutation vocabulary — write/edit
+ * only), so a pure-read call never registers; write/edit calls register with
+ * their own turn; nested Code Mode dispatches borrow the enclosing root call's
+ * turn (dispatch events carry none); a `tool/result` whose presentation meta
+ * carries diffs registers its paths (the render-intent vocabulary) with the
+ * result's turn, and per-turn line deltas are summed from the diffs. A `write` whose result carries no diffs is a
  * create (the write tool records no diffs when the file had no prior content):
  * its full written content — read from the call arguments, which the log keeps
  * — is the added-line count, once per file per turn.
@@ -257,6 +270,11 @@ export function foldFilePreviewByTurn(events) {
             const target = pathFromToolCall(event.data.name, event.data.arguments);
             if (target === undefined)
                 continue;
+            // The card's vocabulary is mutations only: a read call registers
+            // nothing (it may still anchor a nested code dispatch's location via
+            // callSites above).
+            if (target.op === 'read')
+                continue;
             if (target.op === 'write') {
                 const content = contentFromWriteCall(event.data.arguments);
                 if (content !== undefined) {
@@ -268,19 +286,24 @@ export function foldFilePreviewByTurn(events) {
             recordLocation(target.path, event.data.turn, event.seq, event.data.step);
             continue;
         }
-        if (event.type === 'tool/code-dispatch') {
+        if (DISPATCH_EVENT_NAMES.has(event.type)) {
             // The dispatch event IS the settled outcome: a failed sub-call changed
             // nothing, so only successful file touches record. Code Mode writes are
             // uncountable (no result diffs reach the session), so they register the
-            // path and poison the line-count totals (unknown wins).
-            if (event.data.isError)
+            // path and poison the line-count totals (unknown wins). Same payload
+            // shape caveat as foldFilePreview above.
+            const dispatch = event;
+            if (dispatch.data.isError)
                 continue;
-            const target = targetFromArguments(event.data.name, event.data.arguments);
+            const target = targetFromArguments(dispatch.data.name, dispatch.data.arguments);
             if (target === undefined)
                 continue;
-            const site = callSites.get(String(event.data.rootCallId)) ?? { turn: 0, step: 0 };
+            // Reads leave no card entry here too — only mutations register.
+            if (target.op === 'read')
+                continue;
+            const site = callSites.get(String(dispatch.data.rootCallId)) ?? { turn: 0, step: 0 };
             sessionSeen.add(target.path);
-            recordContribution(target.path, site.turn, event.seq, site.step, undefined, undefined, true);
+            recordContribution(target.path, site.turn, dispatch.seq, site.step, undefined, undefined, true);
             continue;
         }
         if (event.type === 'tool/result') {