@khorsheed/dsh-file-preview 0.1.1 → 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":316,"column":3},
+      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":392,"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":469,"column":9},
+      sourceLocation: {"file":"packages/file-preview/src/index.ts","line":478,"column":9},
     },
     {
       id: '@khorsheed/dsh-file-preview#filePreview/turnFiles',
@@ -205,32 +283,39 @@ 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":348,"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": "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",
-            "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, 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": [
@@ -256,9 +348,13 @@ 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    subagentDepth?: number;\n}"
+            "declaration": "export interface AgentOptions {\n    provider?: string;\n    model?: string;\n    reasoningEffort?: ReasoningEffortId;\n    maxTokens?: number;\n    subagentDepth?: number;\n}"
           },
           {
             "name": "AgentStatus",
@@ -284,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'>;"
@@ -293,21 +393,13 @@ 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": "CodeDispatchStartEventData",
-            "declaration": "export interface CodeDispatchStartEventData {\n    rootCallId: CallId;\n    parentCallId: CallId;\n    subCallId: CallId;\n    name: string;\n    arguments: unknown;\n}"
-          },
           {
             "name": "CommandId",
             "declaration": "export type CommandId = Branded<'CommandId'>;"
@@ -326,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,15 +434,19 @@ export const TYPERT = {
           },
           {
             "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 persona?: string;\n    readonly toolFilter?: ToolRestriction;\n}"
+            "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    tools?: ToolSchema[];\n}"
           },
           {
-            "name": "CoordinatorMessageSource",
-            "declaration": "export interface CoordinatorMessageSource {\n    readonly kind: 'coordinator';\n    readonly form: 'relay';\n    readonly senderSessionId: SessionId;\n}"
+            "name": "FileAttachmentRef",
+            "declaration": "export interface FileAttachmentRef {\n    attachmentId: AttachmentId;\n    name: string;\n    bytes: number;\n}"
           },
           {
-            "name": "EpochHeader",
-            "declaration": "export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    system?: string;\n    tools?: ToolSchema[];\n}"
+            "name": "FileBlock",
+            "declaration": "export interface FileBlock {\n    type: 'file';\n    attachment: FileAttachmentRef;\n}"
           },
           {
             "name": "FilePreviewDiff",
@@ -368,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}"
@@ -414,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",
@@ -450,7 +550,7 @@ 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    coordinator: CoordinatorMessageSource;\n    'subagent-report': SubagentReportMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\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",
@@ -464,6 +564,14 @@ export const TYPERT = {
             "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}"
@@ -478,11 +586,67 @@ 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",
-            "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 model?: 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 model?: 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",
@@ -490,15 +654,15 @@ export const TYPERT = {
           },
           {
             "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<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: 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 ? 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: 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    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: number; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: CallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/code-dispatch-start': CodeDispatchStartEventData;\n    'tool/code-dispatch': CodeDispatchEventData;\n    'subagent/descriptor': SubagentDescriptorData;\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'agent-preset/selected': { agentPreset: string; };\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",
@@ -506,19 +670,47 @@ 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: 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",
             "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": "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",
@@ -528,25 +720,29 @@ export const TYPERT = {
             "name": "SubagentDescriptorData",
             "declaration": "export type SubagentDescriptorData = OneShotSubagentDescriptorData | ContinuableSubagentDescriptorData;"
           },
-          {
-            "name": "SubagentReportMessageSource",
-            "declaration": "export interface SubagentReportMessageSource {\n    readonly kind: 'subagent-report';\n    readonly form: 'relay';\n    readonly senderSessionId: SessionId;\n}"
-          },
           {
             "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",
-            "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?: number[];\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: number; end: number; };"
+            "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",
@@ -558,15 +754,19 @@ 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",
@@ -574,7 +774,7 @@ export const TYPERT = {
           },
           {
             "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

@@ -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>>