@khorsheed/dsh-file-preview 0.2.0 → 0.3.0

package/lib/typert.host.js

@@ -1,6 +1,9 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
 import { z } from 'zod'
 
+const _khorsheed_dsh_file_preview_filePreview_capabilities_result$schema = z.object({
+  'protocolVersion': z.literal(1),
+})
 const _khorsheed_dsh_file_preview_filePreview_list_parameter_0$schema = z.intersection(z.string(), z.unknown())
 const _khorsheed_dsh_file_preview_filePreview_list_result$schema = z.object({
   'entries': z.array(z.object({
@@ -24,11 +27,20 @@ const _khorsheed_dsh_file_preview_filePreview_list_result$schema = z.object({
   'asOfSeq': z.number().readonly(),
   'truncated': z.boolean().readonly(),
 })
+const _khorsheed_dsh_file_preview_filePreview_openExternal_parameter_0$schema = z.intersection(z.string(), z.unknown())
+const _khorsheed_dsh_file_preview_filePreview_openExternal_parameter_1$schema = z.string()
+const _khorsheed_dsh_file_preview_filePreview_openExternal_parameter_2$schema = z.string()
+const _khorsheed_dsh_file_preview_filePreview_openExternal_result$schema = z.union([z.object({
+  'opened': z.literal(true).readonly(),
+}), z.object({
+  'opened': z.literal(false).readonly(),
+  'reason': z.union([z.literal("missing"), z.literal("unknown-app"), z.literal("unsupported-platform"), z.literal("launch-failed")]).readonly(),
+})])
 const _khorsheed_dsh_file_preview_filePreview_read_parameter_0$schema = z.intersection(z.string(), z.unknown())
 const _khorsheed_dsh_file_preview_filePreview_read_parameter_1$schema = z.string()
 const _khorsheed_dsh_file_preview_filePreview_read_result$schema = z.object({
   'path': z.string().readonly(),
-  'kind': z.union([z.literal("text"), z.literal("image"), z.literal("binary"), z.literal("missing"), z.literal("too-large"), z.literal("error")]).readonly(),
+  'kind': z.union([z.literal("missing"), z.literal("error"), z.literal("text"), z.literal("image"), z.literal("binary"), z.literal("too-large")]).readonly(),
   'content': z.string().readonly().optional(),
   'url': z.string().readonly().optional(),
   'truncated': z.boolean().readonly().optional(),
@@ -65,6 +77,21 @@ export const TYPERT = {
   schemas: [
   ],
   invocations: [
+    {
+      id: '@khorsheed/dsh-file-preview#filePreview/capabilities',
+      service: 'filePreview',
+      namespace: 'filePreview',
+      method: 'capabilities',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-file-preview#filePreview/capabilities:result',
+        schema: _khorsheed_dsh_file_preview_filePreview_capabilities_result$schema,
+      },
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":191,"column":3},
+    },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/list',
       service: 'filePreview',
@@ -93,7 +120,58 @@ 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":368,"column":9},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":311,"column":9},
+    },
+    {
+      id: '@khorsheed/dsh-file-preview#filePreview/openExternal',
+      service: 'filePreview',
+      namespace: 'filePreview',
+      method: 'openExternal',
+      invocation: { kind: 'direct' },
+      scope: {
+        context: 'agent',
+        wire: 'agentId',
+      },
+      parameters: [
+        {
+          name: 'agent',
+          wire: 'agentId',
+          source: 'lookup',
+          lookup: 'agent',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
+            schema: _khorsheed_dsh_file_preview_filePreview_openExternal_parameter_0$schema,
+          },
+        },
+        {
+          name: 'path',
+          wire: 'path',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-file-preview#filePreview/openExternal:path',
+            schema: _khorsheed_dsh_file_preview_filePreview_openExternal_parameter_1$schema,
+          },
+        },
+        {
+          name: 'app',
+          wire: 'app',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-file-preview#filePreview/openExternal:app',
+            schema: _khorsheed_dsh_file_preview_filePreview_openExternal_parameter_2$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-file-preview/types#FilePreviewOpenExternal',
+        schema: _khorsheed_dsh_file_preview_filePreview_openExternal_result$schema,
+      },
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":528,"column":9},
     },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/read',
@@ -134,7 +212,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":458,"column":9},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":401,"column":9},
     },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/reveal',
@@ -175,7 +253,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":535,"column":9},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":478,"column":9},
     },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/turnFiles',
@@ -205,7 +283,7 @@ 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":405,"column":9},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":348,"column":9},
     },
   ],
   model: {
@@ -218,6 +296,13 @@ export const TYPERT = {
         "key": "filePreview",
         "exportName": "FilePreviewService",
         "members": [
+          {
+            "kind": "method",
+            "name": "capabilities",
+            "signature": "@Remote('capabilities') capabilities(): { protocolVersion: 1 }",
+            "summary": "Zero-session availability handshake for browser companions.",
+            "jsDoc": "/** Zero-session availability handshake for browser companions. */"
+          },
           {
             "kind": "method",
             "name": "list",
@@ -230,7 +315,7 @@ export const TYPERT = {
             "name": "turnFiles",
             "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. 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 */"
+            "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, PTC\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",
@@ -245,6 +330,13 @@ export const TYPERT = {
             "signature": "@Remote('reveal') async reveal(agent: Agent, path: string, signal: AbortSignal): Promise<FilePreviewReveal>",
             "summary": "Reveal one recorded file in the host file manager — open its folder and select the file (macOS Finder, Windows Explorer, or a select-capable desktop file manager).",
             "jsDoc": "/**\n * Reveal one recorded file in the host file manager — open its folder and\n * select the file (macOS Finder, Windows Explorer, or a select-capable\n * desktop file manager). The display path resolves against the session cwd;\n * the native reveal runs on the host. A path that does not resolve to an\n * existing target, or a platform that cannot select, answers `revealed:\n * false` and the caller opens the parent folder instead (the pre-reveal\n * \"show in folder\" behavior), so the gesture always lands somewhere visible.\n * @param agent - owning live agent; its session cwd anchors relative paths.\n * @param path - the display path recorded by the read/write/edit tool call.\n * @param signal - cooperative cancellation from the calling UI request.\n * @returns whether the file manager selected the file, or why not.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "openExternal",
+            "signature": "@Remote('openExternal') async openExternal(agent: Agent, path: string, app: string, signal: AbortSignal): Promise<FilePreviewOpenExternal>",
+            "summary": "Open one recorded file in a specific host application (the \"open in IDE\" gesture).",
+            "jsDoc": "/**\n * Open one recorded file in a specific host application (the \"open in IDE\"\n * gesture). The official open-in-app route only accepts directories — a\n * file path 404s — so file-exact opens go through this method: macOS\n * `open -a <App> <path>` via the same native-command runner reveal uses.\n * The browser names the application by official open-in-app catalog id\n * (probed from `/open-in-app/apps`); the id → app-name map lives in\n * open-external.ts. Non-macOS hosts and unknown ids answer without\n * launching, and the client hides the gesture.\n * @param agent - owning live agent; its session cwd anchors relative paths.\n * @param path - the display path recorded by the read/write/edit tool call.\n * @param app - official open-in-app catalog id (e.g. `cursor`).\n * @param signal - cooperative cancellation from the calling UI request.\n * @returns whether the application launched, or why not.\n */"
           }
         ],
         "types": [
@@ -288,6 +380,10 @@ export const TYPERT = {
             "name": "AssistantProvenance",
             "declaration": "export interface AssistantProvenance {\n    provider: string;\n    model: string;\n    replayState?: unknown;\n}"
           },
+          {
+            "name": "AssistantStreamRecord",
+            "declaration": "export type AssistantStreamRecord = { readonly type: 'text-chunks'; readonly time0: number; readonly index: number; readonly dt: readonly number[]; readonly texts: readonly string[]; } | { readonly type: 'reasoning-chunks'; readonly time0: number; readonly index: number; readonly dt: readonly number[]; readonly texts: readonly string[]; } | { readonly type: 'tool-call-chunks'; readonly time0: number; readonly index: number; readonly dt: readonly number[]; readonly id: ToolCallId; readonly name?: string; readonly args: readonly string[]; } | { readonly type: 'chunk'; readonly time: number; readonly chunk: StreamChunk; };"
+          },
           {
             "name": "AttachmentId",
             "declaration": "export type AttachmentId = Branded<'AttachmentId'>;"
@@ -322,7 +418,7 @@ export const TYPERT = {
           },
           {
             "name": "ContentBlockMap",
-            "declaration": "export interface ContentBlockMap {\n    text: TextBlock;\n    reasoning: ReasoningBlock;\n    image: ImageBlock;\n    'tool-call': ToolCallBlock;\n    'tool-result': ToolResultBlock;\n}"
+            "declaration": "export interface ContentBlockMap {\n    text: TextBlock;\n    reasoning: ReasoningBlock;\n    image: ImageBlock;\n    file: FileBlock;\n    'tool-call': ToolCallBlock;\n    'tool-result': ToolResultBlock;\n}"
           },
           {
             "name": "ContentBlockType",
@@ -342,7 +438,15 @@ export const TYPERT = {
           },
           {
             "name": "EpochHeader",
-            "declaration": "export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    system?: string;\n    tools?: ToolSchema[];\n}"
+            "declaration": "export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    tools?: ToolSchema[];\n}"
+          },
+          {
+            "name": "FileAttachmentRef",
+            "declaration": "export interface FileAttachmentRef {\n    attachmentId: AttachmentId;\n    name: string;\n    bytes: number;\n}"
+          },
+          {
+            "name": "FileBlock",
+            "declaration": "export interface FileBlock {\n    type: 'file';\n    attachment: FileAttachmentRef;\n}"
           },
           {
             "name": "FilePreviewDiff",
@@ -360,6 +464,10 @@ export const TYPERT = {
             "name": "FilePreviewOp",
             "declaration": "export type FilePreviewOp = 'read' | 'write' | 'edit';"
           },
+          {
+            "name": "FilePreviewOpenExternal",
+            "declaration": "export type FilePreviewOpenExternal = { readonly opened: true; } | { readonly opened: false; readonly reason: 'missing' | 'unknown-app' | 'unsupported-platform' | 'launch-failed'; };"
+          },
           {
             "name": "FilePreviewRead",
             "declaration": "export interface FilePreviewRead {\n    readonly path: string;\n    readonly kind: FilePreviewReadKind;\n    readonly content?: string;\n    readonly url?: string;\n    readonly truncated?: boolean;\n    readonly htmlScripted?: boolean;\n    readonly size?: number;\n    readonly message?: string;\n}"
@@ -406,7 +514,7 @@ export const TYPERT = {
           },
           {
             "name": "Inbox",
-            "declaration": "export class Inbox {\n    get nextTurn(): readonly UserMessage[];\n    get nextStep(): readonly UserMessage[];\n    get hasPending(): boolean;\n    clear(): void;\n    claim(target: InboxTarget, turn: number): UserMessage[];\n    append(target: InboxTarget, message: UserMessage): void;\n    prepend(target: InboxTarget, message: UserMessage): void;\n    replace(messageId: MessageId, newMessage: UserMessage): boolean;\n    remove(messageId: MessageId): boolean;\n    splice(target: InboxTarget, start: number, deleteCount: number, inserted: UserMessage[]): UserMessage[];\n}"
+            "declaration": "export interface Inbox {\n    readonly nextTurn: readonly UserMessage[];\n    readonly nextStep: readonly UserMessage[];\n    clear(): void;\n    append(target: InboxTarget, message: UserMessage): void;\n    prepend(target: InboxTarget, message: UserMessage): void;\n    replace(messageId: MessageId, newMessage: UserMessage): boolean;\n    remove(messageId: MessageId): boolean;\n    splice(target: InboxTarget, start: number, deleteCount: number, inserted: UserMessage[]): UserMessage[];\n}"
           },
           {
             "name": "InboxTarget",
@@ -478,7 +586,7 @@ export const TYPERT = {
           },
           {
             "name": "RequestContext",
-            "declaration": "export interface RequestContext {\n    provider: string;\n    model: string;\n    contextWindow?: number;\n}"
+            "declaration": "export interface RequestContext {\n    provider: string;\n    model: string;\n    contextWindow?: number;\n    systemPromptUpdate?: SystemPromptUpdate;\n}"
           },
           {
             "name": "RequestHeaderReason",
@@ -502,7 +610,7 @@ export const TYPERT = {
           },
           {
             "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}"
+            "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 model?: string;\n    readonly childSessionId?: SessionId;\n}"
           },
           {
             "name": "RoomMemberRemovedEvent",
@@ -510,7 +618,7 @@ export const TYPERT = {
           },
           {
             "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}"
+            "declaration": "export interface RoomMemberUpdatedEvent {\n    readonly name: string;\n    readonly rename?: string;\n    readonly instructions?: string | null;\n    readonly cwd?: string | null;\n    readonly model?: string | null;\n    readonly childSessionId?: SessionId;\n}"
           },
           {
             "name": "RoomRelayEvent",
@@ -546,15 +654,15 @@ export const TYPERT = {
           },
           {
             "name": "Session",
-            "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}"
+            "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<T>] : []): 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: SessionSeq; time: number; data: SessionEventMap[K]; ignorable?: true; } & (K extends SurfaceEventType ? { sourceEventSeqs?: SessionSeq[]; 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 ? SurfaceIntent<K> : { surfaceOp?: never; sourceEventSeqs?: never; }) }[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: 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}"
+            "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    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\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': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\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/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-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    'agent-preset/selected': { agentPreset: string; };\n    'subagent/catalog': SubagentCatalogEvent;\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",
@@ -562,7 +670,7 @@ 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 isSeeded: boolean;\n    readonly origin?: 'subagent';\n    readonly delegationDepth?: number;\n    readonly agentPreset?: string;\n}"
+            "declaration": "export interface SessionHeader {\n    readonly version: typeof SESSION_FORMAT_VERSION;\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",
@@ -600,6 +708,10 @@ export const TYPERT = {
             "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: ToolCallId; name?: string; argumentsDelta: string; } | { type: 'block-end'; index: number; block: ContentBlock; } | { type: 'usage'; usage: TokenUsage; } | { type: 'finish'; reason: FinishReason; replayState?: ReplayEnvelope; };"
           },
+          {
+            "name": "SubagentCatalogEvent",
+            "declaration": "export type SubagentCatalogEvent = { readonly version: 0; readonly childId: SessionId; readonly childCreatedAt: number; } & ({ readonly mode: 'one-shot'; readonly label?: string; } | { readonly mode: 'continuable'; readonly label: string; });"
+          },
           {
             "name": "SubagentDescriptorBase",
             "declaration": "export interface SubagentDescriptorBase {\n    readonly version: number;\n    readonly mode: 'one-shot' | 'continuable';\n    readonly provider: string;\n}"
@@ -614,15 +726,23 @@ export const TYPERT = {
           },
           {
             "name": "SurfaceEventType",
-            "declaration": "export type SurfaceEventType = 'user/message' | 'assistant/message' | 'tool/result';"
+            "declaration": "export type SurfaceEventType = 'system/message' | 'user/message' | 'assistant/message' | 'tool/result';"
           },
           {
             "name": "SurfaceIntent",
-            "declaration": "export interface SurfaceIntent {\n    surfaceOp: SurfaceOp;\n    sourceEventSeqs?: SessionSeq[];\n}"
+            "declaration": "export type SurfaceIntent<T extends SurfaceEventType = SurfaceEventType> = { surfaceOp: SurfaceOp; } & (T extends 'assistant/message' ? { sourceEventSeqs?: never; } : { sourceEventSeqs?: SessionSeq[]; });"
           },
           {
             "name": "SurfaceOp",
-            "declaration": "export type SurfaceOp = 'append' | { op: 'replace'; start: SessionSeq; end: SessionSeq; };"
+            "declaration": "export type SurfaceOp = 'append' | { op: 'replace'; startSeq: SessionSeq; endSeq: SessionSeq; };"
+          },
+          {
+            "name": "SystemMessage",
+            "declaration": "export interface SystemMessage extends Message {\n    readonly role: 'system';\n    readonly source: MessageSourceMap['plugin'];\n}"
+          },
+          {
+            "name": "SystemPromptUpdate",
+            "declaration": "export type SystemPromptUpdate = 'in-history';"
           },
           {
             "name": "TextBlock",

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

@@ -4,17 +4,21 @@ import type {
   TypertRemoteContribution,
 } from '@deepseek-ai/dsh-typert-protocol'
 import type { SessionId } from '@deepseek-ai/dsh-session/types'
-import type { FilePreviewList, FilePreviewRead, FilePreviewReveal, FilePreviewTurnMap } from '@khorsheed/dsh-file-preview/types'
+import type { FilePreviewList, FilePreviewOpenExternal, FilePreviewRead, FilePreviewReveal, FilePreviewTurnMap } from '@khorsheed/dsh-file-preview/types'
 
 declare module '@deepseek-ai/dsh-typert-protocol' {
   interface TypertRemoteNamespace$66696c6550726576696577 {
+    capabilities: () => Promise<RemoteResult<{ protocolVersion: 1; }>>
     list: (agentId: SessionId) => Promise<RemoteResult<FilePreviewList>>
+    openExternal: (agentId: SessionId, path: string, app: string, signal?: AbortSignal) => Promise<RemoteResult<FilePreviewOpenExternal>>
     read: (agentId: SessionId, path: string, signal?: AbortSignal) => Promise<RemoteResult<FilePreviewRead>>
     reveal: (agentId: SessionId, path: string, signal?: AbortSignal) => Promise<RemoteResult<FilePreviewReveal>>
     turnFiles: (agentId: SessionId) => Promise<RemoteResult<FilePreviewTurnMap>>
   }
   interface TypertRemoteMap {
+    'filePreview/capabilities': () => Promise<RemoteResult<{ protocolVersion: 1; }>>
     'filePreview/list': (agentId: SessionId) => Promise<RemoteResult<FilePreviewList>>
+    'filePreview/openExternal': (agentId: SessionId, path: string, app: string, signal?: AbortSignal) => Promise<RemoteResult<FilePreviewOpenExternal>>
     'filePreview/read': (agentId: SessionId, path: string, signal?: AbortSignal) => Promise<RemoteResult<FilePreviewRead>>
     'filePreview/reveal': (agentId: SessionId, path: string, signal?: AbortSignal) => Promise<RemoteResult<FilePreviewReveal>>
     'filePreview/turnFiles': (agentId: SessionId) => Promise<RemoteResult<FilePreviewTurnMap>>
@@ -24,6 +28,7 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
   }
   interface TypertRemoteScopeMap {
     'agent:filePreview/list': () => Promise<RemoteResult<FilePreviewList>>
+    'agent:filePreview/openExternal': (path: string, app: string, signal?: AbortSignal) => Promise<RemoteResult<FilePreviewOpenExternal>>
     'agent:filePreview/read': (path: string, signal?: AbortSignal) => Promise<RemoteResult<FilePreviewRead>>
     'agent:filePreview/reveal': (path: string, signal?: AbortSignal) => Promise<RemoteResult<FilePreviewReveal>>
     'agent:filePreview/turnFiles': () => Promise<RemoteResult<FilePreviewTurnMap>>

package/lib/typert.remote-client.js

@@ -1,6 +1,9 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
 import { z } from 'zod'
 
+const _khorsheed_dsh_file_preview_filePreview_capabilities_result$schema = z.object({
+  'protocolVersion': z.literal(1),
+})
 const _khorsheed_dsh_file_preview_filePreview_list_parameter_0$schema = z.intersection(z.string(), z.unknown())
 const _khorsheed_dsh_file_preview_filePreview_list_result$schema = z.object({
   'entries': z.array(z.object({
@@ -24,11 +27,20 @@ const _khorsheed_dsh_file_preview_filePreview_list_result$schema = z.object({
   'asOfSeq': z.number().readonly(),
   'truncated': z.boolean().readonly(),
 })
+const _khorsheed_dsh_file_preview_filePreview_openExternal_parameter_0$schema = z.intersection(z.string(), z.unknown())
+const _khorsheed_dsh_file_preview_filePreview_openExternal_parameter_1$schema = z.string()
+const _khorsheed_dsh_file_preview_filePreview_openExternal_parameter_2$schema = z.string()
+const _khorsheed_dsh_file_preview_filePreview_openExternal_result$schema = z.union([z.object({
+  'opened': z.literal(true).readonly(),
+}), z.object({
+  'opened': z.literal(false).readonly(),
+  'reason': z.union([z.literal("missing"), z.literal("unknown-app"), z.literal("unsupported-platform"), z.literal("launch-failed")]).readonly(),
+})])
 const _khorsheed_dsh_file_preview_filePreview_read_parameter_0$schema = z.intersection(z.string(), z.unknown())
 const _khorsheed_dsh_file_preview_filePreview_read_parameter_1$schema = z.string()
 const _khorsheed_dsh_file_preview_filePreview_read_result$schema = z.object({
   'path': z.string().readonly(),
-  'kind': z.union([z.literal("text"), z.literal("image"), z.literal("binary"), z.literal("missing"), z.literal("too-large"), z.literal("error")]).readonly(),
+  'kind': z.union([z.literal("missing"), z.literal("error"), z.literal("text"), z.literal("image"), z.literal("binary"), z.literal("too-large")]).readonly(),
   'content': z.string().readonly().optional(),
   'url': z.string().readonly().optional(),
   'truncated': z.boolean().readonly().optional(),
@@ -62,6 +74,21 @@ const _khorsheed_dsh_file_preview_filePreview_turnFiles_result$schema = z.object
 export const TYPERT_REMOTE = {
   package: '@khorsheed/dsh-file-preview',
   descriptors: [
+    {
+      id: '@khorsheed/dsh-file-preview#filePreview/capabilities',
+      service: 'filePreview',
+      namespace: 'filePreview',
+      method: 'capabilities',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-file-preview#filePreview/capabilities:result',
+        schema: _khorsheed_dsh_file_preview_filePreview_capabilities_result$schema,
+      },
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":191,"column":3},
+    },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/list',
       service: 'filePreview',
@@ -90,7 +117,58 @@ 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":368,"column":9},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":311,"column":9},
+    },
+    {
+      id: '@khorsheed/dsh-file-preview#filePreview/openExternal',
+      service: 'filePreview',
+      namespace: 'filePreview',
+      method: 'openExternal',
+      invocation: { kind: 'direct' },
+      scope: {
+        context: 'agent',
+        wire: 'agentId',
+      },
+      parameters: [
+        {
+          name: 'agent',
+          wire: 'agentId',
+          source: 'lookup',
+          lookup: 'agent',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
+            schema: _khorsheed_dsh_file_preview_filePreview_openExternal_parameter_0$schema,
+          },
+        },
+        {
+          name: 'path',
+          wire: 'path',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-file-preview#filePreview/openExternal:path',
+            schema: _khorsheed_dsh_file_preview_filePreview_openExternal_parameter_1$schema,
+          },
+        },
+        {
+          name: 'app',
+          wire: 'app',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-file-preview#filePreview/openExternal:app',
+            schema: _khorsheed_dsh_file_preview_filePreview_openExternal_parameter_2$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-file-preview/types#FilePreviewOpenExternal',
+        schema: _khorsheed_dsh_file_preview_filePreview_openExternal_result$schema,
+      },
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":528,"column":9},
     },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/read',
@@ -131,7 +209,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":458,"column":9},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":401,"column":9},
     },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/reveal',
@@ -172,7 +250,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":535,"column":9},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":478,"column":9},
     },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/turnFiles',
@@ -202,7 +280,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":405,"column":9},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":348,"column":9},
     },
   ],
 }

package/lib/types/fold.d.ts

@@ -26,10 +26,11 @@ 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, 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.
+ * Nested PTC file dispatches (`tool/ptc-dispatch` events — the host's Code
+ * Mode name through 0.1.2, renamed with the 0.1.5 format; the v2→v3 log
+ * migration renames persisted rows, so only the ptc name is matched) 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.
  * @param maxFiles - cap on returned entries; excess files are dropped in
  *   first-seen order after the cap is reached.
@@ -58,7 +59,7 @@ export type TurnFilesByTurn = ReadonlyMap<number, ReadonlyMap<string, TurnFileFa
  * turn maps, so each turn's card lists exactly what that turn mutated.
  * 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
+ * their own turn; nested PTC 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
@@ -69,7 +70,7 @@ export type TurnFilesByTurn = ReadonlyMap<number, ReadonlyMap<string, TurnFileFa
  * Count discipline: a write/edit tool/call only registers the path's location
  * and never touches counts (its counted result follows); the first count
  * contribution for a turn+path is adopted verbatim, later ones accumulate per
- * field with unknown-wins — an uncounted mutation (a Code Mode dispatch, or a
+ * field with unknown-wins — an uncounted mutation (a PTC dispatch, or a
  * diff whose side reports no prior content) poisons that field to undefined
  * rather than reporting a misleading partial.
  * @param events - the session's events in ascending seq order.