@khorsheed/dsh-file-preview 0.3.1 → 0.4.0

package/lib/typert.host.js

@@ -686,6 +686,10 @@ export const TYPERT = {
             "name": "RoomDispatchEvent",
             "declaration": "export interface RoomDispatchEvent {\n    readonly plan?: { readonly goalId: string; readonly taskId?: string; readonly attemptId?: string; };\n    readonly requestSignature?: string;\n    readonly id?: string;\n    readonly targetIds?: readonly string[];\n    readonly origin?: 'human' | 'coordinator' | 'report' | 'relay';\n    readonly replyTo?: string;\n    readonly reportFor?: string;\n    readonly targets: readonly string[];\n    readonly text: string;\n}"
           },
+          {
+            "name": "RoomExecutionMetadataEvent",
+            "declaration": "export interface RoomExecutionMetadataEvent {\n    readonly runId: string;\n    readonly model?: string;\n    readonly effort?: string;\n    readonly tokens?: number;\n}"
+          },
           {
             "name": "RoomGoalEvent",
             "declaration": "export interface RoomGoalEvent {\n    readonly text: string;\n}"
@@ -720,7 +724,7 @@ export const TYPERT = {
           },
           {
             "name": "RoomRunStateEvent",
-            "declaration": "export interface RoomRunStateEvent {\n    readonly runId?: string;\n    readonly member: string;\n    readonly state: 'running' | 'done' | 'cancelled' | 'failed';\n    readonly startedAt: number;\n    readonly elapsedMs?: number;\n    readonly error?: string;\n}"
+            "declaration": "export interface RoomRunStateEvent {\n    readonly childSessionId?: SessionId;\n    readonly model?: string;\n    readonly effort?: string;\n    readonly tokens?: number;\n    readonly runId?: string;\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",
@@ -744,7 +748,7 @@ 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    readonly firstLifecycleSeq: 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}"
+            "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    readonly firstLifecycleSeq: 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    toolHistory(): ToolHistory;\n    deriveMessages(): Message[];\n    deriveEventMessage(event: SessionEvent): Message | null;\n}"
           },
           {
             "name": "SessionEvent",
@@ -752,7 +756,7 @@ export const TYPERT = {
           },
           {
             "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    'developer/message': { turn: number; step: number; message: DeveloperMessage; headerSeq?: SessionSeq; };\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; reason?: 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    'agent-preset/selected': { agentPreset: string; };\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    'image/offload': { targets: ImageOffloadTarget[]; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'permission/preset': { preset: string; };\n    'subagent/catalog': SubagentCatalogEvent;\n    'local-agent/stream': LocalAgentStreamCheckpoint;\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    'room/plan-state': RoomPlan;\n    'room/coordinator': RoomCoordinatorEvent;\n    'room/delivery-state': RoomDeliveryStateEvent;\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    'developer/message': { turn: number; step: number; message: DeveloperMessage; headerSeq?: SessionSeq; };\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; reason?: 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    'agent-preset/selected': { agentPreset: string; };\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    'image/offload': { targets: ImageOffloadTarget[]; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'permission/preset': { preset: string; };\n    'subagent/catalog': SubagentCatalogEvent;\n    'local-agent/stream': LocalAgentStreamCheckpoint;\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/execution-metadata': RoomExecutionMetadataEvent;\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    'room/plan-state': RoomPlan;\n    'room/coordinator': RoomCoordinatorEvent;\n    'room/delivery-state': RoomDeliveryStateEvent;\n}"
           },
           {
             "name": "SessionEventType",
@@ -866,6 +870,10 @@ export const TYPERT = {
             "name": "ToolCallId",
             "declaration": "export type ToolCallId = Branded<'ToolCallId'>;"
           },
+          {
+            "name": "ToolHistory",
+            "declaration": "export interface ToolHistory {\n    readonly tools: readonly ToolSchema[];\n    readonly updates: readonly { readonly messageId: MessageId; readonly additions: readonly ToolSchema[]; }[];\n}"
+          },
           {
             "name": "ToolMessageSource",
             "declaration": "export interface ToolMessageSource {\n    kind: 'tool';\n    callId: ToolCallId;\n}"

package/lib/types/client/DiffHistory.d.ts

@@ -0,0 +1,20 @@
+/** Change-history view: steps through every recorded write/edit diff of one
+ * file — the surface the official document tab has no counterpart for, and the
+ * reason this package keeps a self-drawn body at all. */
+import { type ReactNode } from 'react';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { FilePreviewEntry } from '../types.ts';
+/**
+ * One file's change history: the recorded write/edit diffs with a stepper. The
+ * step index counts from the LATEST change (0 = most recent, the default
+ * position), matching "修改记录 2/2 · 最新" reading where ‹ walks older and ›
+ * walks newer. Keyed by the selection at the render site, so the position
+ * resets per file. The pane's diff face owns the inset and the scrollport
+ * (the kernel's .diffScroll), so this view draws no surface of its own.
+ * @param props - the list entry carrying the diffs, and the locale seat.
+ */
+export declare function DiffHistory(props: {
+    entry: FilePreviewEntry;
+    t: TranslateNS<'filePreview'>;
+}): ReactNode;
+//# sourceMappingURL=DiffHistory.d.ts.map

package/lib/types/client/DiffHistory.js

@@ -0,0 +1,56 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** Change-history view: steps through every recorded write/edit diff of one
+ * file — the surface the official document tab has no counterpart for, and the
+ * reason this package keeps a self-drawn body at all. */
+import { useState } from 'react';
+import { DiffBlock } from '@deepseek-ai/dsh-client-ui-primitives';
+import css from './FilePreviewTab.module.css';
+/** Localized DiffBlock chrome from the filePreview dictionary. */
+function diffBlockChrome(t) {
+    const labels = {
+        copy: t('diff.copy'),
+        copied: t('diff.copied'),
+        collapse: t('diff.collapse'),
+        collapseAria: t('diff.collapseAria'),
+        expand: (count) => t('diff.expand', { count }),
+        expandAria: (count) => t('diff.expandAria', { count }),
+        codeLabel: t('diff.code'),
+        wrapLabel: t('diff.wrap'),
+        unwrapLabel: t('diff.unwrap'),
+    };
+    labels.files = (count) => t('diff.files', { count });
+    return { labels };
+}
+/**
+ * One file's change history: the recorded write/edit diffs with a stepper. The
+ * step index counts from the LATEST change (0 = most recent, the default
+ * position), matching "修改记录 2/2 · 最新" reading where ‹ walks older and ›
+ * walks newer. Keyed by the selection at the render site, so the position
+ * resets per file. The pane's diff face owns the inset and the scrollport
+ * (the kernel's .diffScroll), so this view draws no surface of its own.
+ * @param props - the list entry carrying the diffs, and the locale seat.
+ */
+export function DiffHistory(props) {
+    const { entry, t } = props;
+    const diffs = entry.diffs;
+    // Index over `entry.diffs` (event order); 0 = the latest change, the default.
+    const [diffIndex, setDiffIndex] = useState(0);
+    const current = diffs[diffs.length - 1 - diffIndex];
+    if (current === undefined)
+        return null;
+    const stepDiff = (delta) => {
+        setDiffIndex((index) => {
+            const next = index + delta;
+            // The stepper buttons are disabled at both bounds, so a delta can never
+            // leave the range; the clamps keep the index honest for direct callers.
+            /* v8 ignore next -- bounds are disabled at the UI; direct callers stay in range */
+            if (next < 0)
+                return 0;
+            /* v8 ignore next -- bounds are disabled at the UI; direct callers stay in range */
+            if (next >= diffs.length)
+                return diffs.length - 1;
+            return next;
+        });
+    };
+    return (_jsxs("div", { children: [_jsxs("div", { className: css.stepper, children: [_jsx("button", { type: "button", className: css.stepButton, onClick: () => { stepDiff(1); }, disabled: diffIndex >= diffs.length - 1, "aria-label": t('history.step.older'), children: "\u2039" }), _jsxs("span", { className: css.stepLabel, children: [t('history.step.count', { current: diffs.length - diffIndex, total: diffs.length }), diffIndex === 0 ? ` · ${t('history.step.latest')}` : '', ' · ', t('history.step', { turn: current.turn, step: current.step })] }), _jsx("button", { type: "button", className: css.stepButton, onClick: () => { stepDiff(-1); }, disabled: diffIndex <= 0, "aria-label": t('history.step.newer'), children: "\u203A" })] }), _jsx(DiffBlock, { className: css.diffWrap, diffs: [{ path: entry.path, oldText: current.oldText, newText: current.newText }], ...diffBlockChrome(t) })] }));
+}

package/lib/types/client/FilePreviewTab.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The file-preview right-Sidebar tab body — **both host lines** (the plan-B
+ * embedding into the official document tab landed and was vetoed the same
+ * day, 2026-09-24): the session's touched files as a
+ * full-height list, navigating IN-TAB to a detail view on row click. The
+ * tab type claims `dsh-resource://file/**` at the extension band, which the
+ * rc.1 tab registry kept outranking the official document tab's fallback
+ * band — so file clicks (file tree, mentions, deliverables row, turn card)
+ * land here with this package's full chrome, and only the declined suffixes
+ * (pdf, archives, binaries) fall through to the official tab.
+ *
+ * The detail view is the SHARED content pane (@khorsheed/dsh-client-ui-content-preview)
+ * with this plugin's adapter (preview.ts): the pane owns the title/path rows,
+ * the copy-path / show-in-folder / open-in-IDE (split, app-listed) gestures,
+ * the content⇄change-history switch, the sandboxed HTML tiers, content search
+ * and the markdown/JSON/CSV renderings; this file supplies the read, the IDE
+ * choices and the 改动记录 body (the shared DiffHistory). Being our own view it
+ * works for outside-workspace files too (reveal/openExternal take absolute
+ * paths, and the host `read` resolves them) — they are no longer list-only
+ * rows. The mention wrap routes prose opens through the same claim, so a
+ * mentioned file lands in this page too.
+ *
+ * Navigation params (`openTab('file-preview', { params: { path } })`, the
+ * turn card's outside-workspace gesture) select the path on arrival — which
+ * lands directly on the detail view.
+ */
+import { type ReactNode } from 'react';
+import type { FilePreviewTabProps } from './contract.ts';
+/**
+ * The file-preview tab body.
+ * @param props - composed props (runtime + store + injected + locale shares).
+ */
+export declare function FilePreviewTab(props: FilePreviewTabProps): ReactNode;
+//# sourceMappingURL=FilePreviewTab.d.ts.map

package/lib/types/client/FilePreviewTab.js

@@ -0,0 +1,193 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The file-preview right-Sidebar tab body — **both host lines** (the plan-B
+ * embedding into the official document tab landed and was vetoed the same
+ * day, 2026-09-24): the session's touched files as a
+ * full-height list, navigating IN-TAB to a detail view on row click. The
+ * tab type claims `dsh-resource://file/**` at the extension band, which the
+ * rc.1 tab registry kept outranking the official document tab's fallback
+ * band — so file clicks (file tree, mentions, deliverables row, turn card)
+ * land here with this package's full chrome, and only the declined suffixes
+ * (pdf, archives, binaries) fall through to the official tab.
+ *
+ * The detail view is the SHARED content pane (@khorsheed/dsh-client-ui-content-preview)
+ * with this plugin's adapter (preview.ts): the pane owns the title/path rows,
+ * the copy-path / show-in-folder / open-in-IDE (split, app-listed) gestures,
+ * the content⇄change-history switch, the sandboxed HTML tiers, content search
+ * and the markdown/JSON/CSV renderings; this file supplies the read, the IDE
+ * choices and the 改动记录 body (the shared DiffHistory). Being our own view it
+ * works for outside-workspace files too (reveal/openExternal take absolute
+ * paths, and the host `read` resolves them) — they are no longer list-only
+ * rows. The mention wrap routes prose opens through the same claim, so a
+ * mentioned file lands in this page too.
+ *
+ * Navigation params (`openTab('file-preview', { params: { path } })`, the
+ * turn card's outside-workspace gesture) select the path on arrival — which
+ * lands directly on the detail view.
+ */
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { parseFileAddress, resolveWorkspacePath } from '@deepseek-ai/dsh-util-workspace-path';
+import { FileTypeIcon } from '@deepseek-ai/dsh-client-ui-primitives';
+import { IconGlobeOutlineMedium, IconRefreshOutlineMedium } from './icons.js';
+import { ContentPane, } from '@khorsheed/dsh-client-ui-content-preview/src/client/index.ts';
+import { DiffHistory } from './DiffHistory.js';
+import { listIdes, pickFileManager } from './open-in-app.js';
+import { previewTranslator, structuredLabels, toPreviewRead } from './preview.js';
+import { basename, highlightMatch, isWithinWorkspace, matchesQuery, parentPath, relativeToCwd, sortByLatest } from './path-utils.js';
+import css from './FilePreviewTab.module.css';
+/** One detail view: header (back + breadcrumb + actions) over the preview pane. */
+function DetailView(props) {
+    const { sessionId, path, entry, cwd, apps, readFile, copyPath, revealFolder, openInIde, onBack, t } = props;
+    const [read, setRead] = useState(null);
+    const [error, setError] = useState(null);
+    // The content⇄change-history view is the caller's state (the kernel only
+    // renders the switch); a new selection starts on the content.
+    const [view, setView] = useState('content');
+    const fileManager = apps === null ? undefined : pickFileManager(apps);
+    const ides = apps === null ? [] : listIdes(apps);
+    const [ideChoice, setIdeChoice] = useState(ides[0]?.id);
+    const currentIde = ides.find(entry => entry.id === ideChoice) ?? ides[0];
+    useEffect(() => { setView('content'); }, [path]);
+    // The header shows the host-resolved absolute spelling (the same one the
+    // copy/open gestures act on) as a segmented breadcrumb: directory segments
+    // dimmed with ' / ' between them (the official files header's reading), the
+    // file name solid. Long segments ellipsize individually; the name never
+    // truncates.
+    const displayPath = resolveWorkspacePath(cwd, path);
+    const showTabs = entry !== undefined && entry.diffs.length > 0;
+    // Fetch the current content for the content tab; a stale answer (selection
+    // moved) is dropped by the effect cleanup.
+    useEffect(() => {
+        let cancelled = false;
+        setRead(null);
+        setError(null);
+        void readFile(sessionId, path).then((result) => {
+            if (cancelled)
+                return;
+            if (result.ok)
+                setRead(result.value);
+            else
+                setError(result.error.message);
+        });
+        return () => { cancelled = true; };
+    }, [sessionId, path, readFile]);
+    // The pane's reload gesture re-reads the same file. Unlike a fresh selection
+    // the old read is NOT cleared first — the panel keeps showing it in flight,
+    // and a failure keeps it in state, reported through the same error slot. An
+    // answer landing after the selection moved is dropped.
+    const pathRef = useRef(path);
+    pathRef.current = path;
+    const reload = () => {
+        const target = path;
+        return readFile(sessionId, target).then((result) => {
+            if (pathRef.current !== target)
+                return;
+            if (result.ok) {
+                setRead(result.value);
+                setError(null);
+            }
+            else
+                setError(result.error.message);
+        });
+    };
+    return (_jsx("div", { className: css.detail, children: _jsx(ContentPane, { path: path, sessionId: sessionId, read: read === null ? null : toPreviewRead(read), loading: read === null && error === null, error: error, displayPath: displayPath, onBack: onBack, onCopyPath: () => copyPath(path), onReload: reload, chrome: {
+                ...(fileManager === undefined ? {} : { openFolder: () => { revealFolder(path); } }),
+                ...(currentIde === undefined
+                    ? {}
+                    : {
+                        openIDE: () => { openInIde(path, currentIde.id); },
+                        ideChoices: ides.map(ide => ({ id: ide.id, label: ide.label })),
+                        onIdeChoice: (id) => { setIdeChoice(id); openInIde(path, id); },
+                    }),
+            }, ...(showTabs ? { diffView: _jsx(DiffHistory, { entry: entry, t: t }), view, onViewChange: setView } : {}), labels: structuredLabels(t), t: previewTranslator(t) }, path) }));
+}
+/**
+ * The file-preview tab body.
+ * @param props - composed props (runtime + store + injected + locale shares).
+ */
+export function FilePreviewTab(props) {
+    const { useTabInfo, sessionId, useSessions, useStore, actions, listFiles, readFile, copyPath, revealFolder, openInIde, loadOpenInApps, t, } = props;
+    const { useOpenInApps } = props;
+    const { tab } = useTabInfo();
+    const { signal, navigation } = tab;
+    const cwd = useSessions(s => s.byId[sessionId]?.cwd);
+    const apps = useOpenInApps(value => value);
+    const list = useStore(s => s.list);
+    const listLoading = useStore(s => s.listLoading);
+    const listError = useStore(s => s.listError);
+    const listRequestRev = useStore(s => s.listRequestRev);
+    const selectedPath = useStore(s => s.selected[tab.id] ?? null);
+    // Component-private view state: the name-filter search term.
+    const [search, setSearch] = useState('');
+    // Fetch the list on mount and on refresh; the whole value replaces the
+    // previous list. A stale answer (tab closed mid-flight) is dropped on the
+    // occurrence's abort signal.
+    useEffect(() => {
+        let cancelled = false;
+        actions.setListLoading(true);
+        actions.setListError(null);
+        void listFiles(sessionId).then((result) => {
+            if (cancelled || signal.aborted)
+                return;
+            actions.setListLoading(false);
+            if (result.ok)
+                actions.setList(result.value);
+            else
+                actions.setListError(result.error.message);
+        });
+        return () => { cancelled = true; };
+    }, [sessionId, listRequestRev, actions, listFiles, signal]);
+    // The gestures' availability rides the once-per-page probe; start it with
+    // the first mounted body.
+    useEffect(() => { loadOpenInApps(); }, [loadOpenInApps]);
+    // A navigation selects its path: `params.path` (the turn card's
+    // outside-workspace gesture), or the claimed address's path (every
+    // openResource route — the official card, the file tree, mentions). The
+    // revision bumps on every navigation, so a repeat open re-applies it.
+    const revision = navigation.revision;
+    // The params union also carries the official file resource params ({ line }),
+    // so narrow on the key the way the official TextPreview does.
+    const navPath = navigation.params !== undefined && 'path' in navigation.params ? navigation.params.path : undefined;
+    const navAddress = navigation.address;
+    // Applied once per navigation revision: the list arriving later must NOT
+    // re-apply (a refresh would yank the user out of the list they backed into).
+    const appliedRevision = useRef(0);
+    useEffect(() => {
+        if (revision === 0 || appliedRevision.current === revision)
+            return;
+        const path = navPath ?? (() => {
+            const parsed = navAddress === undefined ? undefined : parseFileAddress(navAddress);
+            return parsed?.scope === 'session' ? parsed.path : undefined;
+        })();
+        if (path === undefined)
+            return;
+        appliedRevision.current = revision;
+        // Select the fold's own spelling when the list knows the file (the store
+        // keys entries by their recorded display path), else the address's.
+        const known = list?.find(entry => resolveWorkspacePath(cwd, entry.path) === resolveWorkspacePath(cwd, path));
+        actions.select(tab.id, known?.path ?? path);
+    }, [revision, navPath, navAddress, list, cwd, tab.id, actions]);
+    // Latest activity first: the fold keeps first-seen order. The list shows
+    // the session's products only — written/edited files, matching the chat
+    // area's 产物 vocabulary; reads never appear. A non-empty search narrows
+    // to paths containing the term.
+    const ordered = useMemo(() => {
+        if (list === null)
+            return null;
+        const products = sortByLatest(list).filter((entry) => entry.op !== 'read');
+        const query = search.trim();
+        return query.length === 0 ? products : products.filter(entry => matchesQuery(entry.path, query));
+    }, [list, search]);
+    const searching = search.trim().length > 0;
+    if (selectedPath !== null) {
+        return (_jsx("div", { className: css.root, children: _jsx(DetailView, { sessionId: sessionId, path: selectedPath, entry: list?.find(entry => entry.path === selectedPath), cwd: cwd, apps: apps, readFile: readFile, copyPath: copyPath, revealFolder: revealFolder, openInIde: openInIde, onBack: () => { actions.deselect(tab.id); }, t: t }) }));
+    }
+    return (_jsxs("div", { className: css.root, children: [_jsxs("div", { className: css.filterRow, children: [_jsx("input", { type: "search", className: css.search, placeholder: t('view.search.placeholder'), value: search, onChange: (event) => { setSearch(event.target.value); }, "aria-label": t('view.search.placeholder') }), _jsx("button", { type: "button", className: css.tool, "aria-label": t('list.refresh'), title: t('list.refresh'), onClick: () => { actions.refreshList(); }, children: _jsx(IconRefreshOutlineMedium, {}) })] }), _jsxs("nav", { className: css.list, "aria-label": t('open'), children: [listLoading && list === null && _jsx("div", { className: css.empty, children: t('list.loading') }), !listLoading && listError !== null && list === null && (_jsx("div", { className: css.empty, children: t('list.error') })), !listLoading && listError === null && list !== null && ordered !== null && ordered.length === 0 && (_jsx("div", { className: css.empty, children: searching ? t('view.search.noMatch') : t('list.empty') })), ordered?.map((entry) => {
+                        const name = basename(entry.path);
+                        const parts = searching ? highlightMatch(name, search.trim()) : null;
+                        const within = isWithinWorkspace(cwd, entry.path);
+                        return (_jsxs("button", { type: "button", className: css.row, title: within ? entry.path : `${entry.path} — ${t('list.outsideWorkspace')}`, onClick: () => { actions.select(tab.id, entry.path); }, children: [_jsxs("span", { className: css.rowName, children: [_jsx(FileTypeIcon, { path: entry.path, size: 14 }), parts === null
+                                            ? name
+                                            : (_jsxs(_Fragment, { children: [parts[0], _jsx("mark", { className: css.match, children: parts[1] }), parts[2]] })), !within && _jsx(IconGlobeOutlineMedium, { className: css.rowOutside, size: 12 })] }), _jsx("span", { className: css.rowDir, children: relativeToCwd(parentPath(entry.path), cwd) }), _jsx("span", { className: css.rowStep, children: t('history.step', { turn: entry.turn, step: entry.step }) })] }, entry.path));
+                    })] })] }));
+}

package/lib/types/client/TurnFileRow.d.ts

@@ -0,0 +1,30 @@
+/** TurnFileRow: the turn's product table — every file the turn created or
+ * edited, as a compact table in the `conversation.chat.turnTail` slot.
+ *
+ * The paths come from the host `filePreview.turnFiles` RPC — the single
+ * source of truth (write/edit calls, Code Mode dispatches, render-intent
+ * paths, and bash captures all land here), fetched once per session through
+ * the turn-files cache. 0.1.6-alpha.2 re-kinded the slot chain → list; the
+ * 2026-09-24 convergence decision keeps ONLY this row in the slot: the
+ * official deliverables entry (present card + memory-resident changes card)
+ * is shadowed by an empty lower-priority registration under its cell id (see
+ * index.ts), superseding the 2026-09-18 coexistence. On a 0.1.5 host the
+ * registration keeps the old chain preemption instead. Either way the row
+ * itself decides visibility from its data.
+ *
+ * Density: up to three products render as plain rows; beyond that the card
+ * collapses to a "N 个产物" summary row that expands in place. Every file
+ * click goes through the owner's `openFile` — the official openResource
+ * route, where this package's tab type claims the renderable addresses on
+ * both host lines (extension band over the official document tab's
+ * fallback) — so one file is one tab for every origin.
+ * Until the fetch settles — or when the turn has no files, or the fetch fails
+ * — the card renders nothing. */
+import type { FilePreviewTurnRowProps } from './contract.ts';
+/**
+ * Render one turn's products as a compact table, fetched from the host.
+ * @param props - session standard kit (sessionId), the turn-tail owner (turn,
+ *   openFile), the injected turn-files loader, and the locale seat.
+ */
+export declare function TurnFileRow(props: FilePreviewTurnRowProps): import("react").JSX.Element | null;
+//# sourceMappingURL=TurnFileRow.d.ts.map

package/lib/types/client/TurnFileRow.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** TurnFileRow: the turn's product table — every file the turn created or
+ * edited, as a compact table in the `conversation.chat.turnTail` slot.
+ *
+ * The paths come from the host `filePreview.turnFiles` RPC — the single
+ * source of truth (write/edit calls, Code Mode dispatches, render-intent
+ * paths, and bash captures all land here), fetched once per session through
+ * the turn-files cache. 0.1.6-alpha.2 re-kinded the slot chain → list; the
+ * 2026-09-24 convergence decision keeps ONLY this row in the slot: the
+ * official deliverables entry (present card + memory-resident changes card)
+ * is shadowed by an empty lower-priority registration under its cell id (see
+ * index.ts), superseding the 2026-09-18 coexistence. On a 0.1.5 host the
+ * registration keeps the old chain preemption instead. Either way the row
+ * itself decides visibility from its data.
+ *
+ * Density: up to three products render as plain rows; beyond that the card
+ * collapses to a "N 个产物" summary row that expands in place. Every file
+ * click goes through the owner's `openFile` — the official openResource
+ * route, where this package's tab type claims the renderable addresses on
+ * both host lines (extension band over the official document tab's
+ * fallback) — so one file is one tab for every origin.
+ * Until the fetch settles — or when the turn has no files, or the fetch fails
+ * — the card renders nothing. */
+import { useEffect, useState } from 'react';
+import { FileTypeIcon } from '@deepseek-ai/dsh-client-ui-primitives';
+import { IconChevronDownOutlineMedium, IconChevronUpOutlineMedium } from './icons.js';
+import { basename } from './turn-files.js';
+import { parentPath } from './path-utils.js';
+import css from './TurnFileRow.module.css';
+/** Above this many products the card collapses to the summary row. */
+const COLLAPSE_OVER = 3;
+/**
+ * Render one turn's products as a compact table, fetched from the host.
+ * @param props - session standard kit (sessionId), the turn-tail owner (turn,
+ *   openFile), the injected turn-files loader, and the locale seat.
+ */
+export function TurnFileRow(props) {
+    const { sessionId, openFile, turnFiles, t } = props;
+    const turn = props.turn.turn;
+    const [files, setFiles] = useState(null);
+    // Expanded means: the table is showing. Default: showing at ≤3 products,
+    // collapsed to the summary row above that.
+    const [expanded, setExpanded] = useState(false);
+    useEffect(() => {
+        let cancelled = false;
+        setFiles(null);
+        setExpanded(false);
+        void turnFiles(sessionId, turn).then((loaded) => {
+            if (cancelled)
+                return;
+            setFiles(loaded);
+        });
+        return () => { cancelled = true; };
+    }, [sessionId, turn, turnFiles]);
+    // Data not arrived, or nothing to show: the card stays invisible (on the
+    // list-kind slot every entry renders; visibility is decided here).
+    if (files === null || files.length === 0)
+        return null;
+    const collapsible = files.length > COLLAPSE_OVER;
+    const showing = !collapsible || expanded;
+    return (_jsxs("div", { className: css.card, "data-turn-file-row": true, children: [collapsible && (_jsxs("button", { type: "button", className: css.summary, "aria-expanded": expanded, onClick: () => { setExpanded(value => !value); }, children: [_jsx("span", { className: css.summaryText, children: t('turn.count', { count: files.length }) }), _jsx("span", { className: css.chevron, "aria-hidden": true, children: expanded ? _jsx(IconChevronUpOutlineMedium, {}) : _jsx(IconChevronDownOutlineMedium, {}) })] })), showing && (_jsx("div", { className: css.list, role: "table", "aria-label": t('turn.count', { count: files.length }), children: files.map((file) => {
+                    const dir = parentPath(file.path);
+                    return (_jsxs("button", { type: "button", role: "row", className: css.file, title: file.path, 
+                        // Every path goes through the owner's openFile — the official
+                        // openResource route, where our tab type claims the renderable
+                        // addresses on both host lines (fileAddressFor keeps
+                        // outside-workspace absolutes inside the session address, and
+                        // our detail view renders them via the Remote read), so one
+                        // file is one tab for every origin.
+                        onClick: () => { void openFile(file.path); }, children: [_jsx(FileTypeIcon, { path: file.path, size: 14, className: css.fileIcon }), _jsx("span", { className: css.name, children: basename(file.path) }), dir !== '' && _jsx("span", { className: css.dir, children: dir }), _jsxs("span", { className: css.stats, children: [file.added !== undefined && file.added > 0 && (_jsxs("span", { className: css.added, children: ["+", file.added] })), file.removed !== undefined && file.removed > 0 && (_jsxs("span", { className: css.removed, children: ["\u2212", file.removed] }))] })] }, file.path));
+                }) }))] }));
+}

package/lib/types/client/contract.d.ts

@@ -0,0 +1,39 @@
+/** Composed props contracts for the file-preview right-Sidebar tab and the turn card. */
+import type { FilePreviewList, FilePreviewRead, FilePreviewTurnFile } from '../types.ts';
+import type { SessionId } from '@deepseek-ai/dsh-api-remotes/client';
+import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
+import type { InjectFace, PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
+import type { TypertRemoteNamespaceMap } from '@deepseek-ai/dsh-typert-protocol';
+import type { createFilePreviewStore } from './file-preview-store.ts';
+/** The filePreview Remote namespace (list + read + turnFiles), as mounted by this plugin. */
+export type FilePreviewRemote = TypertRemoteNamespaceMap['filePreview'];
+/** Business face injected into the right-Sidebar tab body. */
+export interface FilePreviewTabInjected {
+    /** Fetch one session's touched-file list (one RPC; supplies the diff history). */
+    listFiles: (sessionId: SessionId) => Promise<RemoteResult<FilePreviewList>>;
+    /** Fetch one file's current content (one RPC, host-capped) — the detail view's content tab. */
+    readFile: (sessionId: SessionId, path: string) => Promise<RemoteResult<FilePreviewRead>>;
+    /** Copy one path's host-resolved absolute spelling to the clipboard; resolves true only when the host accepted the write. */
+    copyPath: (path: string) => Promise<boolean>;
+    /** Reveal one path in the host file manager (file selected; falls back to the official open-in-app route on its parent folder). */
+    revealFolder: (path: string) => void;
+    /** Open one path in an IDE application (file-exact, through the host Remote's openExternal); defaults to the probed preference. */
+    openInIde: (path: string, app?: string) => void;
+    /** Start the once-per-page open-in-app probe (the gestures hide until it answers). */
+    loadOpenInApps: () => void;
+    hooks: {
+        /** Probed open-in-app catalog ids (null until answered), bound by the slot renderer. */
+        openInApps: ObservableSnapshot<readonly string[] | null>;
+    };
+}
+/** Full props of the tab body entry (runtime + store + injected + locale shares). */
+export type FilePreviewTabProps = PropsRuntime<'sidebar.right.pane.tab'> & PropsStore<ReturnType<typeof createFilePreviewStore>> & InjectFace<FilePreviewTabInjected> & PropsLocale<'filePreview'>;
+/** Business face injected into the conversation.chat.turnTail mutation card. */
+export interface FilePreviewTurnRowInjected {
+    /** Resolve one session's files for one turn through the session-level cache. */
+    turnFiles: (sessionId: SessionId, turn: number) => Promise<readonly FilePreviewTurnFile[]>;
+}
+/** Full props of the turn mutation card (owner + injected + locale shares). */
+export type FilePreviewTurnRowProps = PropsRuntime<'conversation.chat.turnTail'> & InjectFace<FilePreviewTurnRowInjected> & PropsLocale<'filePreview'>;
+//# sourceMappingURL=contract.d.ts.map

package/lib/types/client/contract.js

@@ -0,0 +1,2 @@
+/** Composed props contracts for the file-preview right-Sidebar tab and the turn card. */
+export {};

package/lib/types/client/definition.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Stage one of this package's right-Sidebar registration: what the
+ * `file-preview` tab type IS — on both host lines (the plan-B embedding into
+ * the official document tab landed and was vetoed the same day, 2026-09-24;
+ * this self-drawn page is the content face again).
+ *
+ * Both a page and a claimant: the guide page offers it as an entry box, and
+ * it claims `dsh-resource://file/**` addresses whose suffix the detail view's
+ * preview stack renders (text/code/markup/data/images — pdf, archives, and
+ * binaries stay with the official document tab). At the default `extension`
+ * band it outranks the official `text` type (fallback band) — the rc.1 tab
+ * registry kept the band mechanism — so every openResource route (the
+ * deliverables card, the file tree, wrapped mentions' fallback, the turn
+ * card) lands files in our detail view. The claim is deterministic by
+ * construction: an earlier cut also required fold membership, but the cache
+ * warms only after our surfaces fetch, and turns the official card claims
+ * never mount our card (its loader) — exactly those files kept falling back
+ * to the official tab (the "sometimes ours, sometimes official" race). The
+ * turn card opens the page by kind with `params: { path }` for
+ * outside-workspace paths (no addressable resource).
+ */
+import type { SidebarRightTabDefinition } from '@deepseek-ai/dsh-client-ui-sidebar-right/client';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-locale/client';
+/** The tab kind this package owns. */
+export declare const FILE_PREVIEW_KIND = "file-preview";
+/** This implementation's identity in the tab system, and the key its body registers under. */
+export declare const FILE_PREVIEW_ID = "@khorsheed/dsh-file-preview";
+/**
+ * Suffixes the detail view's preview stack renders: the change-history text
+ * set plus the image formats the pane's image arm serves. Everything else
+ * (pdf, archives, binaries) stays with the official document tab — the type's
+ * `canOpen` filters on this set before claiming an address.
+ */
+export declare const RENDERABLE_EXTENSIONS: readonly string[];
+/**
+ * Whether the detail view can render this path's content (suffix match,
+ * case-insensitive, compound suffixes intentionally not special-cased).
+ * @param path - any file path spelling.
+ */
+export declare function renderablePath(path: string): boolean;
+declare module '@deepseek-ai/dsh-client-ui-sidebar-right/client' {
+    interface SidebarRightTabParamsMap {
+        /** The file-preview page takes the path to select (the turn card's outside-workspace gesture). */
+        'file-preview': {
+            readonly path?: string;
+        };
+    }
+}
+/**
+ * The file-preview type's registry definition.
+ * @param t - namespace-bound translate, read fresh on every label call.
+ * @returns the definition to register.
+ */
+export declare function filePreviewDefinition(t: TranslateNS<'filePreview'>): SidebarRightTabDefinition;
+//# sourceMappingURL=definition.d.ts.map