@deepseek-harness-tui/dsh-tui 0.7.1 → 0.7.2

package/lib/types/dsh-adapter/channel.js

@@ -8,8 +8,9 @@ import { renderContextSections, renderPrompt } from '@deepseek-ai/dsh-system-pro
 import { loadBaselineInstructions } from '@deepseek-ai/dsh-agent-instructions';
 import { extname, isAbsolute, join } from 'node:path';
 import { completeCommands, isLocalCommandName, LOCAL_COMMANDS, parseCommandName } from '../commands.js';
-import { clearResumeTarget, forgetSession, readLastUsed, readResumeTarget, touchSession, writeResumeTarget } from '../sessionHistory.js';
-import { appendSessionTitle, deleteSessionLog, ensureLegacySessionEventTypes, readSessionTitleFromLog, sessionsRoots } from './compat/index.js';
+import { clearResumeTarget, forgetSession, readResumeTarget, touchSession, writeResumeTarget } from '../sessionHistory.js';
+import { appendSessionTitle, deleteSessionLog, ensureLegacySessionEventTypes, sessionsRoots } from './compat/index.js';
+import { listSummaries, locateSession, noteBranch, previewSession, } from './sessions/index.js';
 import { writeActivityFrames } from '../activityPrefs.js';
 import { readEffortPref, writeEffortPref } from '../effortPrefs.js';
 import { readModelPref, writeModelPref } from '../modelPrefs.js';
@@ -256,18 +257,8 @@ function coalesceReplayEvents(events) {
 }
 /** Buffer below the context window at which CC warns (autoCompact.ts). */
 const CONTEXT_WARNING_BUFFER_TOKENS = 20_000;
-/** How many newest sessions resolve their title from the first user message
- *  (persistence.load reads the whole log — depth caps the picker latency). */
-const SESSION_TITLE_DEPTH = 20;
-/** Picker title cap, in characters. */
-const SESSION_TITLE_LIMIT = 40;
-/** One-line session title: whitespace folded, capped with an ellipsis. */
-function shortenTitle(text) {
-    const flat = text.replace(/\s+/g, ' ').trim();
-    return flat.length <= SESSION_TITLE_LIMIT
-        ? flat
-        : `${flat.slice(0, SESSION_TITLE_LIMIT - 1)}…`;
-}
+/** How many trailing exchanges the browser's preview pane asks for. */
+const PREVIEW_ENTRIES = 8;
 /** Resolve once a `turn/end` event newer than `fromSeq` lands in the session
  *  log (Agent.cancel closes the turn asynchronously), or when the timeout
  *  expires. Polling the session log is race-free here: fork reads the same
@@ -303,7 +294,11 @@ export function createChannel(ctx, initialAgent, options) {
     // command/run + command/done records). Absent the service, only the
     // built-in local commands exist.
     const commandService = ctx.get('commands');
-    const workspaceService = ctx.tuiWorkspaces ?? createLocalWorkspaceRuntime();
+    // Workspace registry runtime (optional service, issue #183): mounted by
+    // the bundle patch's dsh-tui-workspaces row; absent the row (stale patch
+    // or a bare embedder), degrade to the local-only runtime. plugin.ts owns
+    // the degraded-boot warning for profile launches.
+    const workspaceService = ctx.get('tuiWorkspaces') ?? createLocalWorkspaceRuntime();
     const commandTrees = ctx.get('tuiCommandTrees');
     // Shift+Tab session-mode cycle: cordis.yml `modes` wins; absent/empty/
     // atom-less → the built-in default/plan/full cycle (sessionModes.ts).
@@ -1670,61 +1665,21 @@ export function createChannel(ctx, initialAgent, options) {
             return listFilesDeep(fs, state.cwd);
         },
         async listSessions() {
-            // DSH's own session index: the persistence backend materializes one
-            // entry per durable session log (headers carry cwd + createdAt).
+            // Every stored session, classified and unfiltered. Which of them a
+            // surface shows — this project only, conversations only, sub-agent runs
+            // folded away — is a view decision, and keeping it out of here is what
+            // lets the browser toggle those views without re-reading a single log.
             const persistence = ctx.get('sessionPersistence');
             if (!persistence)
                 return [];
-            try {
-                const headers = await persistence.list();
-                // 按工作目录隔离（Claude Code 的项目维度）：/resume 只列出本会话
-                // 目录启动的会话，别的项目的会话不出现在选择器里。
-                const local = headers.filter(header => sessionCwdMatches(state.cwd, header.cwd ?? ''));
-                // MRU ordering: DSH headers carry only createdAt, so dsh-tui keeps its
-                // own last-used timestamps (touchSession on resume/submit/new) and
-                // falls back to createdAt for sessions never touched in this install.
-                const lastUsed = readLastUsed();
-                const records = local
-                    .map(header => ({
-                    id: header.id,
-                    // Titles load lazily below (first user message); until then the
-                    // cwd basename stands in (matching the status line), with a
-                    // short id when absent.
-                    title: basename(header.cwd ?? '') || `session ${String(header.id).slice(0, 8)}`,
-                    cwd: header.cwd ?? '',
-                    createdAt: header.createdAt,
-                    updatedAt: lastUsed[header.id] ?? header.createdAt,
-                }))
-                    .sort((a, b) => b.updatedAt - a.updatedAt);
-                // Title = the session's session/title event (auto: first prompt;
-                // manual: /rename), else its FIRST user message — the picker's most
-                // useful label. Read via the tolerant compat log reader instead of
-                // persistence.load: the backend validates every event against
-                // KNOWN_SESSION_EVENT_TYPES and throws the whole load on an unmarked
-                // an unregistered third-party type, which would otherwise leave the
-                // affected session titled with the cwd
-                // basename. An unreadable log keeps the basename fallback.
-                const empty = new Set();
-                for (const record of records.slice(0, SESSION_TITLE_DEPTH)) {
-                    const info = readSessionTitleFromLog(String(record.id));
-                    if (info === undefined)
-                        continue; // keep the basename fallback
-                    if (!info.hasUserMessage) {
-                        // Launch artifact — a session with no user message holds no
-                        // conversation to resume, so drop it from the picker (its
-                        // createdAt-only updatedAt would otherwise pin it near the
-                        // top forever, one per dsh-tui launch).
-                        empty.add(record.id);
-                        continue;
-                    }
-                    if (info.title !== undefined)
-                        record.title = shortenTitle(info.title);
-                }
-                return records.filter(record => !empty.has(record.id));
-            }
-            catch {
+            return listSummaries(persistence);
+        },
+        async previewSession(sessionId) {
+            const persistence = ctx.get('sessionPersistence');
+            if (!persistence)
                 return [];
-            }
+            const path = await locateSession(persistence, sessionId);
+            return path === undefined ? [] : previewSession(path, PREVIEW_ENTRIES);
         },
         setResumeTarget(sessionId) {
             writeResumeTarget(sessionId);
@@ -1764,12 +1719,10 @@ export function createChannel(ctx, initialAgent, options) {
             }
             if (appendSessionTitle(sessionId, title) !== 'appended')
                 return false;
-            // listSessions resolves persisted titles only for the MRU top
-            // SESSION_TITLE_DEPTH; a rename does not change MRU by itself, so a
-            // session beyond the window would keep showing the cwd-basename
-            // fallback (in the next picker AND after restart) even though the
-            // title event is durable. A rename IS user interaction with the
-            // session — touching it pulls it into the title window.
+            // The append changed the log, so the next listing sees a new revision,
+            // re-derives, and reads back the very title event just written — no
+            // second path to the same answer. Touching it is about ordering, not
+            // titles: a rename is user interaction, so the row belongs at the top.
             touchSession(sessionId);
             return true;
         },
@@ -3072,6 +3025,11 @@ ${output}
             const branch = result.stdout.text.trim();
             if (branch !== '') {
                 state.gitBranch = branch;
+                // Note it against the session too. A session log records no branch,
+                // and nothing can reconstruct one after the fact, so the browser can
+                // only show a branch for sessions this install actually used — which
+                // is exactly what the column claims.
+                noteBranch(agent.session.id, branch);
                 state.emit();
             }
         })
@@ -3084,7 +3042,7 @@ ${output}
     refreshGitBranch();
     return state;
 }
-/** Path basename for the resume-list title (`C:/a/b` → `b`). */
+/** Trailing path segment (`C:/a/b` → `b`). */
 function basename(path) {
     const parts = path.split(/[\\/]/);
     return parts[parts.length - 1] ?? path;

package/lib/types/dsh-adapter/compat/index.d.ts

@@ -18,5 +18,5 @@
  *    registration API (issue #153).
  * @module @deepseek-harness-tui/dsh-tui/compat
  */
-export { appendSessionTitle, deleteSessionLog, ensureLegacySessionEventTypes, LEGACY_SESSION_EVENT_TYPES, readSessionTitleFromLog, sessionsRoots, } from './sessionLog.js';
+export { appendSessionTitle, deleteSessionLog, ensureLegacySessionEventTypes, findSessionLogFile, LEGACY_SESSION_EVENT_TYPES, readSessionTitleFromLog, sessionsRoots, } from './sessionLog.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/dsh-adapter/compat/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/compat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,6BAA6B,EAC7B,0BAA0B,EAC1B,uBAAuB,EACvB,aAAa,GACd,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/compat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,6BAA6B,EAC7B,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,EACvB,aAAa,GACd,MAAM,iBAAiB,CAAA"}

package/lib/types/dsh-adapter/compat/index.js

@@ -18,4 +18,4 @@
  *    registration API (issue #153).
  * @module @deepseek-harness-tui/dsh-tui/compat
  */
-export { appendSessionTitle, deleteSessionLog, ensureLegacySessionEventTypes, LEGACY_SESSION_EVENT_TYPES, readSessionTitleFromLog, sessionsRoots, } from './sessionLog.js';
+export { appendSessionTitle, deleteSessionLog, ensureLegacySessionEventTypes, findSessionLogFile, LEGACY_SESSION_EVENT_TYPES, readSessionTitleFromLog, sessionsRoots, } from './sessionLog.js';

package/lib/types/dsh-adapter/compat/sessionLog.d.ts

@@ -14,6 +14,14 @@ export declare const LEGACY_SESSION_EVENT_TYPES: readonly string[];
  * explicit DSH_TUI_SESSION_ROOT always outranks the defaults.
  */
 export declare function sessionsRoots(): string[];
+/**
+ * Locate a session's log by scanning workspace directories for the session
+ * id — deliberately NOT replicating the persistence plugin's workspace-key
+ * sanitization, so the helpers survive upstream key-scheme changes.
+ * @param sessionId - Session id (directory name under each workspace dir).
+ * @returns Absolute path of session.jsonl.zstd, or undefined when absent.
+ */
+export declare function findSessionLogFile(sessionId: string): string | undefined;
 /**
  * Register every {@link LEGACY_SESSION_EVENT_TYPES} type as known in EVERY
  * reachable KNOWN_SESSION_EVENT_TYPES copy, ahead of the strict read path

package/lib/types/dsh-adapter/compat/sessionLog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessionLog.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/compat/sessionLog.ts"],"names":[],"mappings":"AAqDA;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAAwB,CAAA;AAKhF;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CASxC;AAkED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAkCpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAyBzD;AAyBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,aAAa,CAwB/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAwB7E"}
+{"version":3,"file":"sessionLog.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/compat/sessionLog.ts"],"names":[],"mappings":"AAqDA;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAAwB,CAAA;AAKhF;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CASxC;AAaD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAexE;AA+BD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAkCpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAyBzD;AAyBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,aAAa,CAwB/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAwB7E"}

package/lib/types/dsh-adapter/compat/sessionLog.js

@@ -88,7 +88,7 @@ function isSafeSessionId(sessionId) {
  * @param sessionId - Session id (directory name under each workspace dir).
  * @returns Absolute path of session.jsonl.zstd, or undefined when absent.
  */
-function findSessionLogFile(sessionId) {
+export function findSessionLogFile(sessionId) {
     if (!isSafeSessionId(sessionId))
         return undefined;
     for (const root of sessionsRoots()) {

package/lib/types/dsh-adapter/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,eAAO,MAAM,IAAI,YAAY,CAAA;AAC7B,eAAO,MAAM,MAAM,UAA8B,CAAA;AAEjD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;yEAKqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;gDAC4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;gFAE4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;oCACgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;sBAIkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;4BAGwB;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;wDAEoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;kFAC8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;gCAG4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;yDAGqD;IACrD,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;CAC1B;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,CA0BhC,CAAA;AAEF;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,eAAO,MAAM,IAAI,YAAY,CAAA;AAU7B,eAAO,MAAM,MAAM,UAAa,CAAA;AAEhC;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;yEAKqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;gDAC4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;gFAE4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;oCACgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;sBAIkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;4BAGwB;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;wDAEoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;kFAC8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;gCAG4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;yDAGqD;IACrD,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;CAC1B;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,CA0BhC,CAAA;AAEF;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvE"}

package/lib/types/dsh-adapter/index.js

@@ -1,6 +1,15 @@
 import Schema from '@deepseek-ai/schemastery';
 export const name = 'dsh-tui';
-export const inject = ['agents', 'tuiWorkspaces'];
+// `tuiWorkspaces` must stay OUT of this code-level inject (issue #183): the
+// dsh CLI resolves the bundle's cordis.patch.yml from the FIRST copy of this
+// package found from its own install anchor (typically the global launcher),
+// while the Loader imports the plugin module from the profile's copy. When
+// the two copies skew, the patch may predate the dsh-tui-workspaces row — a
+// hard inject here then deadlocks the whole tree at boot ("pending (waiting
+// for service: tuiWorkspaces)"). The bundle patch keeps tuiWorkspaces in the
+// row-level inject purely as an ordering guarantee when the row exists; when
+// it does not, plugin.ts/channel.ts fall back to a local workspace runtime.
+export const inject = ['agents'];
 export const Config = Schema.object({
     sessionId: Schema.string().required(false),
     // No schema defaults on the route: a `.default()` here would make an

package/lib/types/dsh-adapter/packaged-presets.d.ts

@@ -0,0 +1,22 @@
+export interface PackagedPresetResult {
+    id: string;
+    status: 'installed' | 'updated' | 'current' | 'conflict';
+}
+export interface PackagedPresetOptions {
+    dshHome?: string;
+    sourceRoot?: string;
+    moduleUrl?: string;
+}
+/** Resolve the package asset in both src/tsx and compiled npm layouts. */
+export declare function packagedPresetRoot(moduleUrl?: string): string;
+/**
+ * Materialize presets shipped by dsh-tui into the Harness user preset root.
+ *
+ * The official launcher replaces the roster's configured roots with its own
+ * shipped root at the end of profile composition, so a bundle patch cannot
+ * add a second system root. The user root is the roster's supported extension
+ * seam and is discovered on every list/resolve call. Existing unmarked
+ * directories are never overwritten.
+ */
+export declare function ensurePackagedPresets(options?: PackagedPresetOptions): PackagedPresetResult[];
+//# sourceMappingURL=packaged-presets.d.ts.map

package/lib/types/dsh-adapter/packaged-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packaged-presets.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/packaged-presets.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAA;CACzD;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAmBD,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,SAAS,GAAE,MAAwB,GAAG,MAAM,CAQ9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,qBAA0B,GAAG,oBAAoB,EAAE,CAkDjG"}

package/lib/types/dsh-adapter/packaged-presets.js

@@ -0,0 +1,90 @@
+import { randomUUID } from 'node:crypto';
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const OWNER = '@deepseek-harness-tui/dsh-tui';
+const MARKER = '.dsh-tui-managed.json';
+function readMarker(directory) {
+    try {
+        const value = JSON.parse(readFileSync(join(directory, MARKER), 'utf8'));
+        if (value.owner === OWNER
+            && typeof value.preset === 'string'
+            && typeof value.revision === 'string'
+            && value.revision.length > 0) {
+            return value;
+        }
+    }
+    catch {
+        // An absent or user-authored marker means this directory is not ours.
+    }
+    return undefined;
+}
+/** Resolve the package asset in both src/tsx and compiled npm layouts. */
+export function packagedPresetRoot(moduleUrl = import.meta.url) {
+    const directory = dirname(fileURLToPath(moduleUrl));
+    const candidates = [join(directory, '../../presets'), join(directory, '../../../presets')];
+    const found = candidates.find(candidate => existsSync(candidate));
+    if (found === undefined) {
+        throw new Error(`dsh-tui: packaged preset root is missing (checked ${candidates.join(', ')})`);
+    }
+    return found;
+}
+/**
+ * Materialize presets shipped by dsh-tui into the Harness user preset root.
+ *
+ * The official launcher replaces the roster's configured roots with its own
+ * shipped root at the end of profile composition, so a bundle patch cannot
+ * add a second system root. The user root is the roster's supported extension
+ * seam and is discovered on every list/resolve call. Existing unmarked
+ * directories are never overwritten.
+ */
+export function ensurePackagedPresets(options = {}) {
+    const sourceRoot = options.sourceRoot ?? packagedPresetRoot(options.moduleUrl);
+    const dshHome = options.dshHome ?? process.env.DSH_HOME ?? join(homedir(), '.dsh');
+    const targetRoot = join(dshHome, '.agent-presets');
+    const results = [];
+    for (const entry of readdirSync(sourceRoot, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const id = entry.name;
+        const source = join(sourceRoot, id);
+        const sourceMarker = readMarker(source);
+        if (sourceMarker === undefined || sourceMarker.preset !== id) {
+            throw new Error(`dsh-tui: packaged preset ${id} has no valid ${MARKER}`);
+        }
+        const target = join(targetRoot, id);
+        if (!existsSync(target)) {
+            mkdirSync(targetRoot, { recursive: true });
+            cpSync(source, target, { recursive: true, force: false, errorOnExist: true });
+            results.push({ id, status: 'installed' });
+            continue;
+        }
+        const targetMarker = readMarker(target);
+        if (targetMarker === undefined || targetMarker.preset !== id) {
+            results.push({ id, status: 'conflict' });
+            continue;
+        }
+        if (targetMarker.revision === sourceMarker.revision) {
+            results.push({ id, status: 'current' });
+            continue;
+        }
+        const suffix = `${process.pid}-${randomUUID()}`;
+        const staged = join(targetRoot, `.${id}.staged-${suffix}`);
+        const backup = join(targetRoot, `.${id}.backup-${suffix}`);
+        cpSync(source, staged, { recursive: true, force: false, errorOnExist: true });
+        try {
+            renameSync(target, backup);
+            renameSync(staged, target);
+            rmSync(backup, { recursive: true, force: true });
+        }
+        catch (error) {
+            if (!existsSync(target) && existsSync(backup))
+                renameSync(backup, target);
+            rmSync(staged, { recursive: true, force: true });
+            throw error;
+        }
+        results.push({ id, status: 'updated' });
+    }
+    return results;
+}

package/lib/types/dsh-adapter/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,wBAAwB,CAAA;AAGhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AA2BnC;;;;;;;;GAQG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+YvE;AA6GD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,GAAG;IACjF,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB,CAcA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,KAAK,GAAG,SAAS,CAAA;IAC5B,YAAY,EAAE,KAAK,CAAA;CACpB,GAAG,OAAO,CAQV"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,wBAAwB,CAAA;AAGhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AA6BnC;;;;;;;;GAQG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2bvE;AA6GD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,GAAG;IACjF,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB,CAcA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,KAAK,GAAG,SAAS,CAAA;IAC5B,YAAY,EAAE,KAAK,CAAA;CACpB,GAAG,OAAO,CAQV"}

package/lib/types/dsh-adapter/plugin.js

@@ -13,7 +13,8 @@ import { readActivityFrames } from '../activityPrefs.js';
 import { readModelPref } from '../modelPrefs.js';
 import { explicitModelRoute, recordedModelRoute, resolveModelRoute, validateModelRoute } from '../modelRoute.js';
 import { readPresetPref } from '../presetPrefs.js';
-import { composePreset, resolvePersistedPreset, runningPresetOf } from './presets.js';
+import { composePreset, filterMinimalPresetTools, resolvePersistedPreset, runningPresetOf } from './presets.js';
+import { ensurePackagedPresets } from './packaged-presets.js';
 import { ensureLegacySessionEventTypes } from './compat/index.js';
 import { clearResumeTarget, writeResumeTarget } from '../sessionHistory.js';
 import { resolveSessionCwd } from '../utils/workspaceRoot.js';
@@ -22,6 +23,7 @@ import { isLang, resolveStartupLang, setLang, t } from '../i18n.js';
 import { detectLegacyEnv, migrateLegacyDataDir, RENAMED_ENV } from '../utils/paths.js';
 import { Chat } from '../screens/Chat.js';
 import { attachSessionToWorkspace } from './workspace.js';
+import { createLocalWorkspaceRuntime } from './workspaces.js';
 import { render, ThemeProvider, AlternateScreen } from '../ui.js';
 import instances from '../ink/instances.js';
 import { cursorMove, DISABLE_KITTY_KEYBOARD, DISABLE_MODIFY_OTHER_KEYS, DISABLE_WIN32_INPUT_MODE } from '../ink/termio/csi.js';
@@ -40,6 +42,22 @@ export async function apply(ctx, config) {
     if (!process.stdout.isTTY) {
         throw new Error('dsh-tui requires an interactive terminal (stdout must be a TTY).');
     }
+    // The official profile launcher owns the system preset root and replaces
+    // any bundle-supplied roots at boot. Install dsh-tui's bundled presets via
+    // the roster's supported user-root seam before resolving the first agent.
+    // Never overwrite an existing directory unless it carries our marker.
+    try {
+        for (const result of ensurePackagedPresets()) {
+            if (result.status === 'conflict') {
+                ctx.logger.warn(`dsh-tui: packaged preset "${result.id}" was not installed because an unmanaged preset already uses that id`);
+            }
+        }
+    }
+    catch (error) {
+        // A read-only home must not make the whole terminal unusable; the other
+        // official and user presets remain available.
+        ctx.logger.warn(`dsh-tui: unable to install packaged presets (${error instanceof Error ? error.message : String(error)})`);
+    }
     // Data-directory rename (~/.dsh-cc → ~/.dsh-tui, issue #120): copy the
     // legacy directory before ANY preference read below (resolveStartupLang
     // already touches lang.json). Copy, not move — old launchers keep working
@@ -98,6 +116,16 @@ export async function apply(ctx, config) {
     // the inject proxy.
     const userQuestions = ctx.get('userQuestions') ?? new UserQuestionService(ctx);
     ctx.plugin(toolAskUser);
+    // The host-level tool mount above is intentional for the TUI and for user
+    // presets, but the official Minimal preset is a strict two-tool trajectory
+    // (persistent bash + str_replace_editor). Filter only that preset at the
+    // final assembly boundary. Reading the session on every assembly also makes
+    // blank-session /preset switches and resumed sessions behave correctly.
+    ctx.on('system-prompt/assemble', async (_assembly, context, next) => {
+        const assembled = await next();
+        const presetId = context.agent === undefined ? undefined : runningPresetOf(context.agent.session);
+        return filterMinimalPresetTools(assembled, presetId);
+    });
     const questionStore = new QuestionStore();
     // Packaged skills (/audit, /bug, …): contribute them through the host's
     // skill registry so they resolve with zero manual copying.
@@ -170,9 +198,22 @@ export async function apply(ctx, config) {
     // see the repository, not an arbitrary launch subdirectory. Resolved ONCE
     // here — the agent meta and the channel must agree.
     const requestedWorkspace = config.workspace ?? process.env.DSH_TUI_WORKSPACE_TARGET;
+    // Degraded boot (issue #183): a stale bundle patch without the
+    // dsh-tui-workspaces row leaves the service unmounted; resolve startup
+    // targets through the local-only runtime (provider URIs then fail loud
+    // below instead of crashing on an undefined service). A profile launch
+    // without the service means the patch came from an older dsh-tui copy
+    // than the running code — warn once so the skew is diagnosable. Bare
+    // embedders (no --profile) take the same fallback by design, silently.
+    const mountedWorkspaceService = ctx.get('tuiWorkspaces');
+    if (mountedWorkspaceService === undefined && resolveDshProfileName() !== undefined) {
+        ctx.logger.warn('dsh-tui: tuiWorkspaces service is not mounted; /workspace runs with the local-only fallback. ' +
+            'The bundle patch is older than the installed dsh-tui package — update the globally installed dsh-tui launcher to match the profile (issue #183).');
+    }
+    const workspaceService = mountedWorkspaceService ?? createLocalWorkspaceRuntime();
     const initialWorkspace = requestedWorkspace === undefined
         ? undefined
-        : await ctx.tuiWorkspaces.resolve(requestedWorkspace);
+        : await workspaceService.resolve(requestedWorkspace);
     if (requestedWorkspace !== undefined && initialWorkspace === undefined) {
         throw new Error(`dsh-tui: unsupported or unavailable workspace target: ${requestedWorkspace}`);
     }
@@ -327,8 +368,9 @@ export async function apply(ctx, config) {
         channel,
         questionStore,
         approvalStore,
-        // The trajectory scene enters the alt screen itself in inline mode; in
-        // fullscreen the tree is already wrapped below, so it must not nest.
+        // Full-screen surfaces inside Chat — the trajectory scene and the session
+        // browser — enter the alt screen themselves in inline mode; in fullscreen
+        // the tree is already wrapped below, so they must not nest.
         fullscreen: config.fullscreen === true,
         onExit: () => handleExit(),
         // Only a `dsh --profile <name>` launch has a profile installation for

package/lib/types/dsh-adapter/presets.d.ts

@@ -18,6 +18,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { AgentSetup } from '@deepseek-ai/dsh-agent';
 import type { SessionId } from '@deepseek-ai/dsh-session';
+import type { PromptAssembly } from '@deepseek-ai/dsh-system-prompt';
 /** One roster entry, as returned by `agentPresets.list()`/`resolve()`. */
 export interface AgentPresetInfo {
     readonly id: string;
@@ -93,6 +94,21 @@ export declare function runningPresetOf(session: {
         data: unknown;
     }[];
 }): string | undefined;
+/**
+ * Keep the official Minimal preset's model-facing contract at exactly two
+ * tools. The TUI mounts ask_user_question at the host layer so every other
+ * preset (including user presets) can use its questionnaire UI; host-layer
+ * tools otherwise merge into Minimal's scoped catalog as a third tool.
+ *
+ * This is a per-assembly filter rather than a startup-time decision because
+ * one TUI process can resume, create, or recompose sessions under different
+ * presets. The session log remains the source of truth for the active preset.
+ *
+ * @param assembly - Fully assembled prompt inputs for one model request.
+ * @param presetId - Preset recorded for the requesting session.
+ * @returns The original assembly, except ask_user_question is absent in Minimal.
+ */
+export declare function filterMinimalPresetTools(assembly: PromptAssembly, presetId: string | undefined): PromptAssembly;
 /**
  * Read a service the way a joined agent sees it: through the preset scope
  * chain when a roster is mounted (preset realms hide e.g. `compaction` from

package/lib/types/dsh-adapter/presets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAGzD,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAA;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,IAAI,IAAI,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAA;IAC3C,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC9C,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC/D,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAClE,yEAAyE;IACzE,UAAU,CAAC,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAEnE;AAED,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmBhG;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAqB5G;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,MAAM,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CACnD,GAAG,MAAM,GAAG,SAAS,CAErB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAKpG"}
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAKpE,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAA;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,IAAI,IAAI,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAA;IAC3C,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC9C,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC/D,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAClE,yEAAyE;IACzE,UAAU,CAAC,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAEnE;AAED,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmBhG;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAqB5G;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,MAAM,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CACnD,GAAG,MAAM,GAAG,SAAS,CAErB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAM/G;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAKpG"}

package/lib/types/dsh-adapter/presets.js

@@ -16,6 +16,7 @@
  * before presets existed.
  */
 import { resolveSessionPreset } from '@deepseek-ai/dsh-agent-presets';
+const ASK_USER_TOOL = 'ask_user_question';
 /**
  * The mounted preset roster, or undefined when the composition has no
  * `agent-presets` row (bare boots) — optional-service access via `ctx.get`.
@@ -94,6 +95,28 @@ export async function resolvePersistedPreset(ctx, sessionId) {
 export function runningPresetOf(session) {
     return resolveSessionPreset(session);
 }
+/**
+ * Keep the official Minimal preset's model-facing contract at exactly two
+ * tools. The TUI mounts ask_user_question at the host layer so every other
+ * preset (including user presets) can use its questionnaire UI; host-layer
+ * tools otherwise merge into Minimal's scoped catalog as a third tool.
+ *
+ * This is a per-assembly filter rather than a startup-time decision because
+ * one TUI process can resume, create, or recompose sessions under different
+ * presets. The session log remains the source of truth for the active preset.
+ *
+ * @param assembly - Fully assembled prompt inputs for one model request.
+ * @param presetId - Preset recorded for the requesting session.
+ * @returns The original assembly, except ask_user_question is absent in Minimal.
+ */
+export function filterMinimalPresetTools(assembly, presetId) {
+    if (presetId !== 'minimal' || !assembly.tools.some(tool => tool.name === ASK_USER_TOOL))
+        return assembly;
+    return {
+        ...assembly,
+        tools: assembly.tools.filter(tool => tool.name !== ASK_USER_TOOL),
+    };
+}
 /**
  * Read a service the way a joined agent sees it: through the preset scope
  * chain when a roster is mounted (preset realms hide e.g. `compaction` from

package/lib/types/dsh-adapter/sessions/digest.d.ts

@@ -0,0 +1,29 @@
+import type { PreviewEntry, SessionDigest } from './types.js';
+/** Head window budget. Eight times the measured worst-case prompt offset. */
+export declare const HEAD_WINDOW_BYTES: number;
+/** Head frame ceiling — a cost bound independent of how the bytes compress. */
+export declare const HEAD_MAX_FRAMES = 128;
+/** Tail window budget. Wider than the head: trailing frames carry payloads. */
+export declare const TAIL_WINDOW_BYTES: number;
+/**
+ * Read both windows of one session log.
+ *
+ * @param path - Absolute artifact path.
+ * @param cwd - Working directory, for the last-resort title.
+ * @returns The digest. An unreadable log still yields a usable record: the
+ *   title falls back to the directory basename and says so through its source.
+ */
+export declare function digestSession(path: string, cwd: string): SessionDigest;
+/**
+ * The last exchanges of a session, for the browser's preview pane.
+ *
+ * Bounded like everything else here: the preview shows the end of the
+ * conversation because that is what the tail window holds, and because the end
+ * is what tells you whether this is the session you meant.
+ *
+ * @param path - Absolute artifact path.
+ * @param limit - How many entries to keep, newest last.
+ * @returns Entries in log order.
+ */
+export declare function previewSession(path: string, limit: number): PreviewEntry[];
+//# sourceMappingURL=digest.d.ts.map

package/lib/types/dsh-adapter/sessions/digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/sessions/digest.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAA;AAE3E,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,QAAY,CAAA;AAC1C,+EAA+E;AAC/E,eAAO,MAAM,eAAe,MAAM,CAAA;AAClC,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,QAAa,CAAA;AA+F3C;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CA8CtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAyB1E"}