@khorsheed/dsh-file-preview 0.1.0

package/lib/typert.host.js

@@ -0,0 +1,549 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
+import { z } from 'zod'
+
+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({
+  'path': z.string().readonly(),
+  'op': z.union([z.literal("read"), z.literal("write"), z.literal("edit")]).readonly(),
+  'seq': z.number().readonly(),
+  'turn': z.number().readonly(),
+  'step': z.number().readonly(),
+  'diffs': z.array(z.object({
+  'seq': z.number().readonly(),
+  'turn': z.number().readonly(),
+  'step': z.number().readonly(),
+  'oldText': z.union([z.literal(null), z.string()]).readonly(),
+  'newText': z.string().readonly(),
+})).readonly(),
+  'lastDiff': z.union([z.undefined(), z.object({
+  'oldText': z.union([z.literal(null), z.string()]).readonly(),
+  'newText': z.string().readonly(),
+})]).readonly().optional(),
+})).readonly(),
+  'asOfSeq': z.number().readonly(),
+  'truncated': z.boolean().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(),
+  'content': z.string().readonly().optional(),
+  'url': z.string().readonly().optional(),
+  'truncated': z.boolean().readonly().optional(),
+  'htmlScripted': z.boolean().readonly().optional(),
+  'size': z.number().readonly().optional(),
+  'message': z.string().readonly().optional(),
+})
+const _khorsheed_dsh_file_preview_filePreview_reveal_parameter_0$schema = z.intersection(z.string(), z.unknown())
+const _khorsheed_dsh_file_preview_filePreview_reveal_parameter_1$schema = z.string()
+const _khorsheed_dsh_file_preview_filePreview_reveal_result$schema = z.union([z.object({
+  'revealed': z.literal(true).readonly(),
+}), z.object({
+  'revealed': z.literal(false).readonly(),
+  'reason': z.union([z.literal("missing"), z.literal("select-failed")]).readonly(),
+})])
+const _khorsheed_dsh_file_preview_filePreview_turnFiles_parameter_0$schema = z.intersection(z.string(), z.unknown())
+const _khorsheed_dsh_file_preview_filePreview_turnFiles_result$schema = z.object({
+  'turns': z.array(z.object({
+  'turn': z.number().readonly(),
+  'files': z.array(z.object({
+  'path': z.string().readonly(),
+  'seq': z.number().readonly(),
+  'step': z.number().readonly(),
+  'added': z.number().readonly().optional(),
+  'removed': z.number().readonly().optional(),
+})).readonly(),
+})).readonly(),
+  'asOfSeq': z.number().readonly(),
+})
+
+export const TYPERT = {
+  package: '@khorsheed/dsh-file-preview',
+  face: 'host',
+  schemas: [
+  ],
+  invocations: [
+    {
+      id: '@khorsheed/dsh-file-preview#filePreview/list',
+      service: 'filePreview',
+      namespace: 'filePreview',
+      method: 'list',
+      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_list_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        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},
+    },
+    {
+      id: '@khorsheed/dsh-file-preview#filePreview/read',
+      service: 'filePreview',
+      namespace: 'filePreview',
+      method: 'read',
+      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_read_parameter_0$schema,
+          },
+        },
+        {
+          name: 'path',
+          wire: 'path',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-file-preview#filePreview/read:path',
+            schema: _khorsheed_dsh_file_preview_filePreview_read_parameter_1$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        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},
+    },
+    {
+      id: '@khorsheed/dsh-file-preview#filePreview/reveal',
+      service: 'filePreview',
+      namespace: 'filePreview',
+      method: 'reveal',
+      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_reveal_parameter_0$schema,
+          },
+        },
+        {
+          name: 'path',
+          wire: 'path',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-file-preview#filePreview/reveal:path',
+            schema: _khorsheed_dsh_file_preview_filePreview_reveal_parameter_1$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        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},
+    },
+    {
+      id: '@khorsheed/dsh-file-preview#filePreview/turnFiles',
+      service: 'filePreview',
+      namespace: 'filePreview',
+      method: 'turnFiles',
+      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_turnFiles_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        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},
+    },
+  ],
+  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.",
+        "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 */",
+        "key": "filePreview",
+        "exportName": "FilePreviewService",
+        "members": [
+          {
+            "kind": "method",
+            "name": "list",
+            "signature": "@Remote('list') list(agent: Agent): 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 */"
+          },
+          {
+            "kind": "method",
+            "name": "turnFiles",
+            "signature": "@Remote('turnFiles') turnFiles(agent: Agent): 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 */"
+          },
+          {
+            "kind": "method",
+            "name": "read",
+            "signature": "@Remote('read') async read(agent: Agent, path: string, signal: AbortSignal): Promise<FilePreviewRead>",
+            "summary": "Read the current content of one recorded file, resolved against the session cwd and capped by `maxReadBytes`.",
+            "jsDoc": "/**\n * Read the current content of one recorded file, resolved against the\n * session cwd and capped by `maxReadBytes`.\n * @param agent - owning live agent; its session cwd anchors relative paths.\n * @param path - the display path recorded by the write/edit tool call.\n * @param signal - cooperative cancellation from the calling UI request.\n * @returns the classified read; `text` carries content, `image` carries a\n *   browser URL, other kinds carry the size or a human-readable reason.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "reveal",
+            "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 */"
+          }
+        ],
+        "types": [
+          {
+            "name": "Agent",
+            "declaration": "export interface Agent {\n    readonly id: SessionId;\n    readonly options: AgentOptions;\n    readonly session: Session;\n    readonly inbox: Inbox;\n    readonly status: AgentStatus;\n    readonly ctx: Context;\n    cancel(cause: AgentCancelCause, options?: CancelOptions): void;\n    whenIdle(): Promise<void>;\n    runMaintenance<T>(task: (signal: AbortSignal) => Promise<T>): Promise<T>;\n    send(message: UserMessage, target: InboxTarget, wakeup: boolean): void;\n    followup(message: UserMessage): void;\n    steer(message: UserMessage): void;\n    inject(message: UserMessage): void;\n}"
+          },
+          {
+            "name": "AgentCancelCause",
+            "declaration": "export type AgentCancelCause = { readonly kind: 'user'; } | { readonly kind: 'parent'; } | { readonly kind: 'hook'; readonly reason: string; } | { readonly kind: 'disposed'; };"
+          },
+          {
+            "name": "AgentOptions",
+            "declaration": "export interface AgentOptions {\n    provider?: string;\n    model?: string;\n    maxTokens?: number;\n}"
+          },
+          {
+            "name": "AgentStatus",
+            "declaration": "export type AgentStatus = 'idle' | 'running';"
+          },
+          {
+            "name": "AssistantMessage",
+            "declaration": "export interface AssistantMessage extends Message {\n    readonly role: 'assistant';\n    readonly source: ModelMessageSource;\n}"
+          },
+          {
+            "name": "AssistantProvenance",
+            "declaration": "export interface AssistantProvenance {\n    provider: string;\n    model: string;\n    replayState?: unknown;\n}"
+          },
+          {
+            "name": "AttachmentId",
+            "declaration": "export type AttachmentId = Branded<'AttachmentId'>;"
+          },
+          {
+            "name": "Branded",
+            "declaration": "export type Branded<B extends string> = string & { readonly [BRAND]: B; };"
+          },
+          {
+            "name": "CallId",
+            "declaration": "export type CallId = Branded<'CallId'>;"
+          },
+          {
+            "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": "ContentBlock",
+            "declaration": "export type ContentBlock = ContentBlockMap[ContentBlockType];"
+          },
+          {
+            "name": "ContentBlockMap",
+            "declaration": "export interface ContentBlockMap {\n    text: TextBlock;\n    reasoning: ReasoningBlock;\n    image: ImageBlock;\n    'tool-call': ToolCallBlock;\n    'tool-result': ToolResultBlock;\n}"
+          },
+          {
+            "name": "ContentBlockType",
+            "declaration": "export type ContentBlockType = keyof ContentBlockMap;"
+          },
+          {
+            "name": "ContextFormed",
+            "declaration": "export type ContextFormed = { readonly form?: never; } | { readonly form: 'instructions'; } | { readonly form: 'catalog'; } | { readonly form: 'snapshot'; readonly sections: readonly ContextSnapshotSection[]; } | { readonly form: 'notice'; readonly summary: string; } | { readonly form: 'relay'; } | { readonly form: 'recall'; };"
+          },
+          {
+            "name": "ContextSnapshotSection",
+            "declaration": "export interface ContextSnapshotSection {\n    readonly name: string;\n    readonly text: string;\n}"
+          },
+          {
+            "name": "EpochHeader",
+            "declaration": "export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    system?: string;\n    tools?: ToolSchema[];\n}"
+          },
+          {
+            "name": "FilePreviewDiff",
+            "declaration": "export interface FilePreviewDiff {\n    readonly seq: number;\n    readonly turn: number;\n    readonly step: number;\n    readonly oldText: string | null;\n    readonly newText: string;\n}"
+          },
+          {
+            "name": "FilePreviewEntry",
+            "declaration": "export interface FilePreviewEntry {\n    readonly path: string;\n    readonly op: FilePreviewOp;\n    readonly seq: number;\n    readonly turn: number;\n    readonly step: number;\n    readonly diffs: readonly FilePreviewDiff[];\n    readonly lastDiff?: { readonly oldText: string | null; readonly newText: string; } | undefined;\n}"
+          },
+          {
+            "name": "FilePreviewList",
+            "declaration": "export interface FilePreviewList {\n    readonly entries: readonly FilePreviewEntry[];\n    readonly asOfSeq: number;\n    readonly truncated: boolean;\n}"
+          },
+          {
+            "name": "FilePreviewOp",
+            "declaration": "export type FilePreviewOp = 'read' | 'write' | 'edit';"
+          },
+          {
+            "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}"
+          },
+          {
+            "name": "FilePreviewReadKind",
+            "declaration": "export type FilePreviewReadKind = 'text' | 'image' | 'binary' | 'missing' | 'too-large' | 'error';"
+          },
+          {
+            "name": "FilePreviewReveal",
+            "declaration": "export type FilePreviewReveal = { readonly revealed: true; } | { readonly revealed: false; readonly reason: 'missing' | 'select-failed'; };"
+          },
+          {
+            "name": "FilePreviewTurnFile",
+            "declaration": "export interface FilePreviewTurnFile {\n    readonly path: string;\n    readonly seq: number;\n    readonly step: number;\n    readonly added?: number;\n    readonly removed?: number;\n}"
+          },
+          {
+            "name": "FilePreviewTurnGroup",
+            "declaration": "export interface FilePreviewTurnGroup {\n    readonly turn: number;\n    readonly files: readonly FilePreviewTurnFile[];\n}"
+          },
+          {
+            "name": "FilePreviewTurnMap",
+            "declaration": "export interface FilePreviewTurnMap {\n    readonly turns: readonly FilePreviewTurnGroup[];\n    readonly asOfSeq: number;\n}"
+          },
+          {
+            "name": "FinishReason",
+            "declaration": "export type FinishReason = FinishReasonMap[keyof FinishReasonMap];"
+          },
+          {
+            "name": "FinishReasonMap",
+            "declaration": "export interface FinishReasonMap {\n    stop: { kind: 'stop'; };\n    'tool-calls': { kind: 'tool-calls'; };\n    'max-tokens': { kind: 'max-tokens'; };\n    aborted: { kind: 'aborted'; failure: LlmFailure; };\n    error: { kind: 'error'; failure: LlmFailure; };\n}"
+          },
+          {
+            "name": "ImageAttachmentRef",
+            "declaration": "export interface ImageAttachmentRef {\n    attachmentId: AttachmentId;\n    mediaType: ImageMediaType;\n    bytes: number;\n    width: number;\n    height: number;\n    name?: string;\n    originalDimensions?: { width: number; height: number; };\n}"
+          },
+          {
+            "name": "ImageBlock",
+            "declaration": "export interface ImageBlock {\n    type: 'image';\n    attachment: ImageAttachmentRef;\n}"
+          },
+          {
+            "name": "ImageMediaType",
+            "declaration": "export type ImageMediaType = 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';"
+          },
+          {
+            "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}"
+          },
+          {
+            "name": "InboxTarget",
+            "declaration": "export type InboxTarget = 'next-turn' | 'next-step';"
+          },
+          {
+            "name": "JsonValue",
+            "declaration": "export type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue; };"
+          },
+          {
+            "name": "LlmCallConfig",
+            "declaration": "export interface LlmCallConfig {\n    provider: string;\n    model: string;\n    reasoningEffort?: ReasoningEffortId;\n    temperature?: number;\n    maxTokens?: number;\n    stop?: string[];\n}"
+          },
+          {
+            "name": "LlmCallConfigAdapterDefaults",
+            "declaration": "export interface LlmCallConfigAdapterDefaults {\n    reasoningEffort?: true;\n    maxTokens?: true;\n}"
+          },
+          {
+            "name": "LlmFailure",
+            "declaration": "export interface LlmFailure {\n    readonly message: string;\n    readonly code: string;\n    readonly status?: number;\n    readonly providerRetryAfterMs?: number;\n    readonly requestId?: ProviderRequestId;\n}"
+          },
+          {
+            "name": "Message",
+            "declaration": "export interface Message {\n    readonly id: MessageId;\n    readonly role: 'system' | 'user' | 'assistant';\n    readonly content: ContentBlock[];\n    readonly source: MessageSource;\n}"
+          },
+          {
+            "name": "MessageId",
+            "declaration": "export type MessageId = Branded<'MessageId'>;"
+          },
+          {
+            "name": "MessageSource",
+            "declaration": "export type MessageSource = MessageSourceMap[keyof MessageSourceMap];"
+          },
+          {
+            "name": "MessageSourceMap",
+            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    plugin: { kind: 'plugin'; plugin: string; } & ContextFormed;\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n}"
+          },
+          {
+            "name": "ModelMessageSource",
+            "declaration": "export interface ModelMessageSource extends AssistantProvenance {\n    kind: 'model';\n}"
+          },
+          {
+            "name": "ProviderRequestId",
+            "declaration": "export type ProviderRequestId = Branded<'ProviderRequestId'>;"
+          },
+          {
+            "name": "ReasoningBlock",
+            "declaration": "export interface ReasoningBlock {\n    type: 'reasoning';\n    text: string;\n}"
+          },
+          {
+            "name": "ReasoningEffortId",
+            "declaration": "export type ReasoningEffortId = Branded<'ReasoningEffortId'>;"
+          },
+          {
+            "name": "ReplayEnvelope",
+            "declaration": "export interface ReplayEnvelope {\n    response: unknown;\n    blocks?: readonly unknown[];\n}"
+          },
+          {
+            "name": "RequestContext",
+            "declaration": "export interface RequestContext {\n    provider: string;\n    model: string;\n    contextWindow?: number;\n}"
+          },
+          {
+            "name": "RequestHeaderReason",
+            "declaration": "export type RequestHeaderReason = 'initial' | 'resume' | 'change';"
+          },
+          {
+            "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}"
+          },
+          {
+            "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];"
+          },
+          {
+            "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}"
+          },
+          {
+            "name": "SessionEventType",
+            "declaration": "export type SessionEventType = keyof SessionEventMap;"
+          },
+          {
+            "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}"
+          },
+          {
+            "name": "SessionId",
+            "declaration": "export type SessionId = Branded<'SessionId'>;"
+          },
+          {
+            "name": "SessionSurface",
+            "declaration": "export interface SessionSurface {\n    readonly nodes: readonly number[];\n    readonly replaceGeneration: number;\n}"
+          },
+          {
+            "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; };"
+          },
+          {
+            "name": "SurfaceEventType",
+            "declaration": "export type SurfaceEventType = 'user/message' | 'assistant/message' | 'tool/result';"
+          },
+          {
+            "name": "SurfaceIntent",
+            "declaration": "export interface SurfaceIntent {\n    surfaceOp: SurfaceOp;\n    sourceEventSeqs?: number[];\n}"
+          },
+          {
+            "name": "SurfaceOp",
+            "declaration": "export type SurfaceOp = 'append' | { op: 'replace'; start: number; end: number; };"
+          },
+          {
+            "name": "TextBlock",
+            "declaration": "export interface TextBlock {\n    type: 'text';\n    text: string;\n}"
+          },
+          {
+            "name": "TodoItem",
+            "declaration": "export interface TodoItem {\n    content: string;\n    status: 'pending' | 'in_progress' | 'completed';\n}"
+          },
+          {
+            "name": "TokenUsage",
+            "declaration": "export interface TokenUsage {\n    inputTokens: number;\n    outputTokens: 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}"
+          },
+          {
+            "name": "ToolMessageSource",
+            "declaration": "export interface ToolMessageSource {\n    kind: 'tool';\n    callId: CallId;\n}"
+          },
+          {
+            "name": "ToolResultBlock",
+            "declaration": "export interface ToolResultBlock {\n    type: 'tool-result';\n    toolCallId: CallId;\n    content: ContentBlock[];\n    isError?: boolean;\n}"
+          },
+          {
+            "name": "ToolResultMessage",
+            "declaration": "export interface ToolResultMessage extends Message {\n    readonly role: 'user';\n    readonly content: [ToolResultBlock];\n    readonly source: ToolMessageSource;\n}"
+          },
+          {
+            "name": "ToolSchema",
+            "declaration": "export interface ToolSchema {\n    name: string;\n    description: string;\n    parameters: Record<string, unknown>;\n}"
+          },
+          {
+            "name": "TurnEndCancelCause",
+            "declaration": "export type TurnEndCancelCause = AgentCancelCause | { readonly kind: 'legacy'; };"
+          },
+          {
+            "name": "TurnEndReason",
+            "declaration": "export type TurnEndReason = TurnEndReasonMap[keyof TurnEndReasonMap];"
+          },
+          {
+            "name": "TurnEndReasonMap",
+            "declaration": "export interface TurnEndReasonMap {\n    completed: { kind: 'completed'; };\n    aborted: { kind: 'aborted'; reason: TurnEndCancelCause; };\n    blocked: { kind: 'blocked'; };\n    error: { kind: 'error'; error: LlmFailure; };\n    'max-tokens': { kind: 'max-tokens'; };\n    interrupted: { kind: 'interrupted'; };\n}"
+          },
+          {
+            "name": "UserMessage",
+            "declaration": "export interface UserMessage extends Message {\n    readonly role: 'user';\n}"
+          }
+        ]
+      }
+    ],
+    "events": [],
+    "objects": []
+  },
+}

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

@@ -0,0 +1,35 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
+import type {
+  RemoteResult,
+  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'
+
+declare module '@deepseek-ai/dsh-typert-protocol' {
+  interface TypertRemoteNamespace$66696c6550726576696577 {
+    list: (agentId: SessionId) => Promise<RemoteResult<FilePreviewList>>
+    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/list': (agentId: SessionId) => Promise<RemoteResult<FilePreviewList>>
+    '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>>
+  }
+  interface TypertRemoteNamespaceMap {
+    'filePreview': TypertRemoteNamespace$66696c6550726576696577
+  }
+  interface TypertRemoteScopeMap {
+    'agent:filePreview/list': () => Promise<RemoteResult<FilePreviewList>>
+    '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>>
+  }
+}
+
+export declare const TYPERT_REMOTE: TypertRemoteContribution
+export default TYPERT_REMOTE
+//# sourceMappingURL=typert.remote-client.d.ts.map

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

@@ -0,0 +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":[]}