@khorsheed/dsh-file-preview 0.4.1 → 0.4.2

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

@@ -2,7 +2,7 @@
 /** Dictionary namespace owned by this plugin. */
 export declare const NS = "filePreview";
 /** The file-preview dictionary key set (the source of truth for both locales). */
-export type FilePreviewKey = 'open' | 'view.search.placeholder' | 'view.search.noMatch' | 'preview.search.placeholder' | 'preview.search.noMatch' | 'preview.search.prev' | 'preview.search.next' | 'preview.htmlToggle' | 'preview.htmlSource' | 'preview.htmlRender' | 'preview.htmlScript' | 'preview.htmlScriptStop' | 'preview.scriptConfirm' | 'preview.scriptRun' | 'preview.scriptCancel' | 'preview.slowHint' | 'preview.fullscreen' | 'preview.exitFullscreen' | 'preview.staticHint' | 'turn.count' | 'json.copyValue' | 'json.copyJson' | 'json.copyPath' | 'json.copyPrettyJson' | 'json.copyCompactJson' | 'json.copied' | 'json.copyFailed' | 'json.collapseNode' | 'json.expandNode' | 'json.copyButtonTitle' | 'json.treeLabel' | 'markdown.copy' | 'markdown.copied' | 'markdown.footnotes' | 'diff.copy' | 'diff.copied' | 'diff.collapse' | 'diff.collapseAria' | 'diff.expand' | 'diff.expandAria' | 'diff.files' | 'diff.code' | 'diff.wrap' | 'diff.unwrap' | 'guide.title' | 'guide.description' | 'list.empty' | 'list.error' | 'list.loading' | 'list.outsideWorkspace' | 'list.refresh' | 'history.empty' | 'history.step' | 'history.step.count' | 'history.step.latest' | 'history.step.older' | 'history.step.newer' | 'detail.back' | 'mention.open' | 'action.chooseIDE' | 'action.copy' | 'action.copied' | 'action.copyPath' | 'action.openFolder' | 'action.openIDE' | 'action.reload' | 'detail.content' | 'detail.deleted' | 'detail.diff' | 'detail.noSelection' | 'detail.preview' | 'detail.source' | 'local.binary' | 'local.noSelection' | 'local.tooLarge' | 'local.unreadable' | 'search.hit' | 'search.next' | 'search.noMatch' | 'search.placeholder' | 'search.prev' | 'state.error' | 'state.loading';
+export type FilePreviewKey = 'open' | 'view.search.placeholder' | 'view.search.noMatch' | 'preview.search.placeholder' | 'preview.search.noMatch' | 'preview.search.prev' | 'preview.search.next' | 'preview.htmlToggle' | 'preview.htmlSource' | 'preview.htmlRender' | 'preview.htmlScript' | 'preview.htmlScriptStop' | 'preview.scriptConfirm' | 'preview.scriptRun' | 'preview.scriptCancel' | 'preview.slowHint' | 'preview.fullscreen' | 'preview.exitFullscreen' | 'preview.staticHint' | 'turn.count' | 'json.copyValue' | 'json.copyJson' | 'json.copyPath' | 'json.copyPrettyJson' | 'json.copyCompactJson' | 'json.copied' | 'json.copyFailed' | 'json.collapseNode' | 'json.expandNode' | 'json.copyButtonTitle' | 'json.treeLabel' | 'markdown.copy' | 'markdown.copied' | 'markdown.footnotes' | 'diff.copy' | 'diff.copied' | 'diff.collapse' | 'diff.collapseAria' | 'diff.expand' | 'diff.expandAria' | 'diff.files' | 'diff.code' | 'diff.wrap' | 'diff.unwrap' | 'guide.title' | 'guide.description' | 'list.empty' | 'list.error' | 'list.loading' | 'list.outsideWorkspace' | 'list.refresh' | 'history.empty' | 'history.step' | 'history.step.count' | 'history.step.latest' | 'history.step.older' | 'history.step.newer' | 'detail.back' | 'mention.open' | 'action.chooseIDE' | 'action.copy' | 'action.copied' | 'action.copyPath' | 'action.showInFolder' | 'action.openIDE' | 'action.reload' | 'action.more' | 'detail.content' | 'detail.deleted' | 'detail.diff' | 'detail.noSelection' | 'detail.preview' | 'detail.source' | 'detail.views' | 'local.binary' | 'local.noSelection' | 'local.tooLarge' | 'local.unreadable' | 'search.hit' | 'search.next' | 'search.noMatch' | 'search.placeholder' | 'search.prev' | 'state.error' | 'state.loading';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {
         /** The file-preview tab, document renderer, and turn card copy. */

package/lib/types/client/locales.js

@@ -67,15 +67,17 @@ export const zh = {
     'action.copy': '复制',
     'action.copied': '已复制',
     'action.copyPath': '复制路径',
-    'action.openFolder': '打开目录',
+    'action.showInFolder': '打开所在文件夹',
     'action.openIDE': '在 IDE 中打开',
     'action.reload': '重新加载',
+    'action.more': '更多',
     'detail.content': '内容',
     'detail.deleted': '文件已删除',
     'detail.diff': '改动',
     'detail.noSelection': '选择一个文件查看详情',
     'detail.preview': '预览',
     'detail.source': '源码',
+    'detail.views': '视图',
     'local.binary': '二进制文件，无法预览文本',
     'local.noSelection': '选择一个文件预览内容',
     'local.tooLarge': '文件过大，未载入预览',
@@ -154,15 +156,17 @@ export const en = {
     'action.copy': 'Copy',
     'action.copied': 'Copied',
     'action.copyPath': 'Copy path',
-    'action.openFolder': 'Open folder',
+    'action.showInFolder': 'Show in folder',
     'action.openIDE': 'Open in IDE',
     'action.reload': 'Reload',
+    'action.more': 'More',
     'detail.content': 'Content',
     'detail.deleted': 'File deleted',
     'detail.diff': 'Changes',
     'detail.noSelection': 'Select a file to view',
     'detail.preview': 'Preview',
     'detail.source': 'Source',
+    'detail.views': 'Views',
     'local.binary': 'Binary file — text preview unavailable',
     'local.noSelection': 'Select a file to preview',
     'local.tooLarge': 'File too large — not loaded into preview',

package/lib/types/client/open-in-app.js

@@ -14,6 +14,7 @@
  * @module @khorsheed/dsh-file-preview
  */
 import { createSnapshotStore } from '@deepseek-ai/dsh-client-store';
+import { browserOnHost } from '@khorsheed/dsh-client-ui-panel-kit/src/client/host.ts';
 /** GET route serving the probed application ids (official shared.ts). */
 export const OPEN_IN_APP_APPS_ROUTE = '/open-in-app/apps';
 /** POST route launching one application on one directory (official shared.ts). */
@@ -127,6 +128,12 @@ export class OpenInAppProbe {
     }
     async run() {
         let apps = [];
+        // Off-host the gestures would launch on a machine the viewer is not at
+        // (see browserOnHost): publish "no apps", the existing hidden degrade.
+        if (!browserOnHost()) {
+            this.apps.set(apps);
+            return;
+        }
         try {
             const response = await this.fetcher(new URL(OPEN_IN_APP_APPS_ROUTE, hostBase()), {
                 headers: { accept: 'application/json' },

package/lib/types/index.d.ts

@@ -6,6 +6,8 @@ import type { Agent } from '@deepseek-ai/dsh-agent';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import z from '@deepseek-ai/schemastery';
 import type { FilePreviewConfig, FilePreviewList, FilePreviewOpenExternal, FilePreviewRead, FilePreviewReveal, FilePreviewTurnMap } from './types.ts';
+export { createFilePreviewReadSurface } from './read-surface.ts';
+export type { FilePreviewImageBytes, FilePreviewReadFs, FilePreviewReadSource, FilePreviewReadSurface } from './read-surface.ts';
 declare module '@deepseek-ai/cordis' {
     interface Context {
         filePreview: FilePreviewService;
@@ -26,11 +28,10 @@ export declare class FilePreviewService extends TypertRemoteService {
     /** URL prefix the image route answers under. */
     static readonly IMAGE_ROUTE = "/file-preview-image";
     private readonly resolved;
-    /** Whether a web server is present to host the image route; image reads
-     * answer `binary` without it (the headless face has no browser to serve). */
-    private readonly imageRoute;
-    /** The agents service when present (image route only; null headless). */
-    private readonly agents;
+    /** The agents service while the image route is registered; undefined
+     * otherwise (headless faces, or before `webServer`/`agents` arrive), and
+     * image reads then answer `binary` (no browser to serve). */
+    private agents;
     /** Native reveal runner; a constructor seam for deterministic tests. */
     private readonly revealNative;
     /** Native open-in-app runner; a constructor seam for deterministic tests. */
@@ -41,7 +42,8 @@ export declare class FilePreviewService extends TypertRemoteService {
     private readonly turnCache;
     /**
      * @param ctx - owning Cordis Context carrying `fs`; `webServer` and `agents`
-     *   are optional (the image route needs them, headless faces lack both).
+     *   are optional (the image route registers whenever both are up, headless
+     *   faces lack both).
      * @param config - optional deployment tuning; defaults cap reads and lists,
      *   and enable the bash-write collector.
      * @param deps - test seam for the native reveal dispatch.
@@ -63,18 +65,6 @@ export declare class FilePreviewService extends TypertRemoteService {
      * @param res - the response to fill with bytes or an error status.
      */
     private serveImage;
-    /** Resolve the session's recorded display paths against its cwd and keep only
-     *  those that currently exist as a regular file. The products surfaces fold
-     *  the session log (which is history, not disk state): a path the log wrote
-     *  may have been cleaned up since (a temp script the turn deleted), and such
-     *  a path is not a product to list. Existence is checked fresh on every call
-     *  (never cached), so a deletion that lands after a fold is visible on the
-     *  next fetch. Unresolvable/unstat-able paths are treated as absent.
-     * @param agent - owning live agent; its session cwd anchors relative paths.
-     * @param paths - the display paths to probe.
-     * @returns the subset that resolves to an existing regular file.
-     */
-    private retainExisting;
     /**
      * 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

package/lib/types/index.js

@@ -38,73 +38,11 @@ var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn,
 import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import z from '@deepseek-ai/schemastery';
 import { BashWriteCollector } from './bash-writes.js';
-import { foldFilePreview, foldFilePreviewByTurn } from './fold.js';
+import { foldFilePreviewByTurn } from './fold.js';
 import { openExternalNative, macAppName } from './open-external.js';
+import { IMAGE_MIME, eventsWatermark, isImagePath, listFilePreview, readErrorMessage, readFilePreview, turnFilesFilePreview, } from './read-surface.js';
 import { revealNativePath } from './reveal.js';
-/** Extensions treated as binary without reading (their text decode is meaningless). */
-const BINARY_EXTENSIONS = new Set([
-    '.pdf', '.zip', '.gz', '.tar', '.7z', '.zstd', '.br',
-    '.woff', '.woff2', '.ttf', '.otf', '.eot',
-    '.wasm', '.node', '.dylib', '.so', '.dll', '.exe', '.kext',
-    '.class', '.jar', '.pyc', '.sqlite', '.db',
-    '.DS_Store', '.a', '.o',
-]);
-/** Image extensions served to the browser through the image route. */
-const IMAGE_EXTENSIONS = new Set([
-    '.png', '.jpg', '.jpeg', '.gif', '.webp', '.avif', '.bmp', '.ico', '.svg',
-]);
-/** MIME type per image extension for the image route's Content-Type header. */
-const IMAGE_MIME = {
-    '.png': 'image/png',
-    '.jpg': 'image/jpeg',
-    '.jpeg': 'image/jpeg',
-    '.gif': 'image/gif',
-    '.webp': 'image/webp',
-    '.avif': 'image/avif',
-    '.bmp': 'image/bmp',
-    '.ico': 'image/x-icon',
-    '.svg': 'image/svg+xml',
-};
-/** NUL bytes in decoded text mark a file as binary despite a successful decode. */
-function hasNulByte(content) {
-    return content.slice(0, 4096).includes('\u0000');
-}
-/** Shared non-fatal UTF-8 decoder for the bounded byte-window read: invalid
- * sequences become U+FFFD (a cut multi-byte character at the window edge
- * included) instead of failing the read. */
-const utf8Decoder = new TextDecoder();
-/** Detect a binary file from its display path extension. */
-function isBinaryPath(path) {
-    const dot = path.lastIndexOf('.');
-    return dot >= 0 && BINARY_EXTENSIONS.has(path.slice(dot).toLowerCase());
-}
-/** Detect an image from its display path extension. */
-function isImagePath(path) {
-    const dot = path.lastIndexOf('.');
-    return dot >= 0 && IMAGE_EXTENSIONS.has(path.slice(dot).toLowerCase());
-}
-/** HTML extensions served through the sandboxed render channel. */
-const HTML_EXTENSIONS = new Set(['.html', '.htm']);
-/** Detect an HTML document from its display path extension. */
-function isHtmlPath(path) {
-    const dot = path.lastIndexOf('.');
-    return dot >= 0 && HTML_EXTENSIONS.has(path.slice(dot).toLowerCase());
-}
-/** Best-effort scripted-HTML detection: any `<script>` tag, inline event
- *  handler (`on*="…"`), or `javascript:` URL marks the document as scripted.
- *  Only a hint for default-mode selection and warning — never a trust
- *  decision; the sandbox and the Tier1 CSP are the real boundary. The scan
- *  runs on the read content as delivered (a truncated read may miss markers
- *  in the tail; acceptable for a hint). */
-function isScriptedHtml(content) {
-    return /<\s*script[\s>]/i.test(content)
-        || /\son[a-z]+\s*=/i.test(content)
-        || /javascript:/i.test(content);
-}
-/** Stable error text for a failed read, without leaking backend internals. */
-function readErrorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
+export { createFilePreviewReadSurface } from './read-surface.js';
 /**
  * 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
@@ -150,10 +88,9 @@ let FilePreviewService = (() => {
         /** URL prefix the image route answers under. */
         static IMAGE_ROUTE = '/file-preview-image';
         resolved = __runInitializers(this, _instanceExtraInitializers);
-        /** Whether a web server is present to host the image route; image reads
-         * answer `binary` without it (the headless face has no browser to serve). */
-        imageRoute;
-        /** The agents service when present (image route only; null headless). */
+        /** The agents service while the image route is registered; undefined
+         * otherwise (headless faces, or before `webServer`/`agents` arrive), and
+         * image reads then answer `binary` (no browser to serve). */
         agents;
         /** Native reveal runner; a constructor seam for deterministic tests. */
         revealNative;
@@ -165,7 +102,8 @@ let FilePreviewService = (() => {
         turnCache = new Map();
         /**
          * @param ctx - owning Cordis Context carrying `fs`; `webServer` and `agents`
-         *   are optional (the image route needs them, headless faces lack both).
+         *   are optional (the image route registers whenever both are up, headless
+         *   faces lack both).
          * @param config - optional deployment tuning; defaults cap reads and lists,
          *   and enable the bash-write collector.
          * @param deps - test seam for the native reveal dispatch.
@@ -187,19 +125,30 @@ let FilePreviewService = (() => {
             else {
                 this.collector = undefined;
             }
-            const webServer = ctx.get('webServer');
-            this.agents = ctx.get('agents');
-            this.imageRoute = webServer !== undefined && this.agents !== undefined;
-            if (this.imageRoute && webServer !== undefined) {
-                ctx.effect(() => webServer.register({
-                    kind: 'prefix',
-                    path: FilePreviewService.IMAGE_ROUTE,
-                    /* v8 ignore next 2 -- the handler body is the request path; the
-                       unit tests drive serveImage directly, the real server reaches it
-                       through this registration */
-                    handler: (req, res) => { void this.serveImage(req, res); },
-                }), 'file-preview: image route');
-            }
+            // Optional services through a sub-fiber, never an apply-time `ctx.get`:
+            // a one-shot probe loses the route for good whenever this service applies
+            // before `webServer`/`agents` (load order is not guaranteed), and every
+            // image then reads as `binary`. The sub-fiber registers the route once
+            // both are up and withdraws it when either leaves.
+            ctx.inject(['webServer', 'agents'], (routeCtx) => {
+                const webServer = routeCtx.get('webServer');
+                const agents = routeCtx.get('agents');
+                routeCtx.effect(() => {
+                    const unregister = webServer.register({
+                        kind: 'prefix',
+                        path: FilePreviewService.IMAGE_ROUTE,
+                        /* v8 ignore next 2 -- the handler body is the request path; the
+                           unit tests drive serveImage directly, the real server reaches it
+                           through this registration */
+                        handler: (req, res) => { void this.serveImage(req, res); },
+                    });
+                    this.agents = agents;
+                    return () => {
+                        this.agents = undefined;
+                        unregister();
+                    };
+                }, 'file-preview: image route');
+            });
         }
         /** Zero-session availability handshake for browser companions. */
         capabilities() {
@@ -285,37 +234,6 @@ let FilePreviewService = (() => {
             });
             res.end(Buffer.from(bytes));
         }
-        /** Resolve the session's recorded display paths against its cwd and keep only
-         *  those that currently exist as a regular file. The products surfaces fold
-         *  the session log (which is history, not disk state): a path the log wrote
-         *  may have been cleaned up since (a temp script the turn deleted), and such
-         *  a path is not a product to list. Existence is checked fresh on every call
-         *  (never cached), so a deletion that lands after a fold is visible on the
-         *  next fetch. Unresolvable/unstat-able paths are treated as absent.
-         * @param agent - owning live agent; its session cwd anchors relative paths.
-         * @param paths - the display paths to probe.
-         * @returns the subset that resolves to an existing regular file.
-         */
-        async retainExisting(agent, paths) {
-            if (paths.length === 0)
-                return new Set();
-            const cwd = agent.session.header.cwd;
-            const existing = new Set();
-            for (const path of paths) {
-                if (existing.has(path))
-                    continue;
-                try {
-                    const target = await this.fs.resolve(path, cwd === undefined ? {} : { cwd });
-                    const info = await this.fs.stat(target);
-                    if (info?.type === 'file')
-                        existing.add(path);
-                }
-                catch {
-                    // Unresolvable or stat failed: the path is not present to list.
-                }
-            }
-            return existing;
-        }
         /**
          * 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
@@ -326,25 +244,10 @@ let FilePreviewService = (() => {
          * @returns existing first-seen files capped by `maxFiles`, with the log watermark.
          */
         async list(agent) {
-            const folded = foldFilePreview(agent.session.snapshotEvents(), this.resolved.maxFiles);
-            const captured = this.collector?.captured(agent.session.id);
-            let entries = folded.entries;
-            if (captured !== undefined && captured.size > 0) {
-                const seen = new Set(entries.map(entry => entry.path));
-                const extra = [];
-                for (const [path, write] of captured) {
-                    if (seen.has(path) || entries.length + extra.length >= this.resolved.maxFiles)
-                        continue;
-                    extra.push({ path, op: 'write', seq: write.seq, turn: write.turn, step: write.step, diffs: [] });
-                }
-                entries = [...entries, ...extra];
-            }
-            const existing = await this.retainExisting(agent, entries.map(entry => entry.path));
-            return {
-                entries: entries.filter(entry => existing.has(entry.path)),
-                asOfSeq: folded.asOfSeq,
-                truncated: folded.truncated || entries.length >= this.resolved.maxFiles,
-            };
+            return listFilePreview(
+            // The header read stays lazy-tolerant: the pre-core code only touched
+            // the cwd inside the existence probe, which an empty fold never reached.
+            { fs: this.fs, cwd: agent.session.header?.cwd, maxFiles: this.resolved.maxFiles }, agent.session.snapshotEvents(), this.collector?.captured(agent.session.id));
         }
         /**
          * Every turn's file mutations for the turn-tail card — the single source of
@@ -364,7 +267,7 @@ let FilePreviewService = (() => {
         async turnFiles(agent) {
             const session = agent.session;
             const events = session.snapshotEvents();
-            const asOfSeq = events.length === 0 ? -1 : events[events.length - 1].seq;
+            const asOfSeq = eventsWatermark(events);
             const cached = this.turnCache.get(session.id);
             let byTurn;
             if (cached === undefined || cached.asOfSeq !== asOfSeq) {
@@ -374,39 +277,7 @@ let FilePreviewService = (() => {
             else {
                 byTurn = cached.byTurn;
             }
-            const captured = this.collector?.captured(session.id);
-            const turns = [];
-            // One pass over the turn keys in ascending order (turn numbers are small).
-            const turnNumbers = new Set(byTurn.keys());
-            if (captured !== undefined) {
-                for (const write of captured.values())
-                    turnNumbers.add(write.turn);
-            }
-            for (const turn of [...turnNumbers].sort((a, b) => a - b)) {
-                const files = [];
-                const map = byTurn.get(turn);
-                if (map !== undefined)
-                    files.push(...map.values());
-                if (captured !== undefined) {
-                    for (const [path, write] of captured) {
-                        if (write.turn !== turn || files.some(file => file.path === path))
-                            continue;
-                        files.push({ path, seq: write.seq, step: write.step });
-                    }
-                }
-                if (files.length === 0)
-                    continue;
-                turns.push({ turn, files: files.sort((a, b) => a.seq - b.seq) });
-            }
-            // Filter the assembled groups to paths that still exist on disk (fresh per
-            // call — the fold cache is by log watermark, existence moves independently).
-            const existing = await this.retainExisting(agent, turns.flatMap(group => group.files.map(file => file.path)));
-            return {
-                turns: turns
-                    .map(group => ({ turn: group.turn, files: group.files.filter(file => existing.has(file.path)) }))
-                    .filter(group => group.files.length > 0),
-                asOfSeq,
-            };
+            return turnFilesFilePreview({ fs: this.fs, cwd: session.header?.cwd, maxFiles: this.resolved.maxFiles }, asOfSeq, byTurn, this.collector?.captured(session.id));
         }
         /**
          * Read the current content of one recorded file, resolved against the
@@ -421,72 +292,18 @@ let FilePreviewService = (() => {
          *   browser URL, other kinds carry the size or a human-readable reason.
          */
         async read(agent, path, signal) {
-            if (typeof path !== 'string' || path.length === 0) {
-                return { path, kind: 'error', message: 'file preview requires a non-empty path' };
-            }
-            const cwd = agent.session.header.cwd;
-            let target;
-            try {
-                target = await this.fs.resolve(path, cwd === undefined ? { signal } : { cwd, signal });
-            }
-            catch (error) {
-                return { path, kind: 'error', message: readErrorMessage(error) };
-            }
-            let info;
-            try {
-                info = await this.fs.stat(target, signal);
-            }
-            catch (error) {
-                return { path, kind: 'error', message: readErrorMessage(error) };
-            }
-            if (info === undefined || info.type !== 'file') {
-                return { path, kind: 'missing' };
-            }
-            // HTML gets its own, wider render-channel cap; every other text read
-            // keeps `maxReadBytes`. Images keep the base cap (their route serves
-            // bytes, not the render channel).
-            const html = isHtmlPath(path);
-            const cap = html ? this.resolved.htmlMaxReadBytes : this.resolved.maxReadBytes;
-            if (info.size !== undefined && info.size > cap) {
-                return { path, kind: 'too-large', size: info.size };
-            }
-            if (isImagePath(path)) {
-                if (this.imageRoute) {
-                    const encoded = encodeURIComponent(path);
-                    return {
-                        path,
-                        kind: 'image',
-                        url: `${FilePreviewService.IMAGE_ROUTE}/${agent.session.id}/${encoded}`,
-                        ...(info.size === undefined ? {} : { size: info.size }),
-                    };
-                }
-                // No web face to serve bytes: an image is binary, never decoded as text.
-                return { path, kind: 'binary', ...(info.size === undefined ? {} : { size: info.size }) };
-            }
-            if (isBinaryPath(path)) {
-                return { path, kind: 'binary', ...(info.size === undefined ? {} : { size: info.size }) };
-            }
-            try {
-                // Bounded by the window, not the file: at most cap + 1 bytes are
-                // transferred (the extra byte decides `truncated`), never the whole file.
-                const bytes = await this.fs.readByteRange(target, { offset: 0, length: cap + 1 }, signal);
-                const truncated = bytes.length > cap;
-                const content = utf8Decoder.decode(truncated ? bytes.subarray(0, cap) : bytes);
-                if (hasNulByte(content)) {
-                    return { path, kind: 'binary', ...(info.size === undefined ? {} : { size: info.size }) };
-                }
-                return {
-                    path,
-                    kind: 'text',
-                    content,
-                    truncated,
-                    ...(html && isScriptedHtml(content) ? { htmlScripted: true } : {}),
-                    ...(info.size === undefined ? {} : { size: info.size }),
-                };
-            }
-            catch (error) {
-                return { path, kind: 'error', message: readErrorMessage(error) };
-            }
+            const session = agent.session;
+            return readFilePreview({
+                fs: this.fs,
+                cwd: session.header.cwd,
+                maxReadBytes: this.resolved.maxReadBytes,
+                htmlMaxReadBytes: this.resolved.htmlMaxReadBytes,
+                // The web face's image route is the local deployment's issuer; a
+                // headless composition has none and image reads answer `binary`.
+                imageUrl: this.agents !== undefined
+                    ? (display) => `${FilePreviewService.IMAGE_ROUTE}/${session.id}/${encodeURIComponent(display)}`
+                    : undefined,
+            }, path, signal);
         }
         /**
          * Reveal one recorded file in the host file manager — open its folder and