@deepseek-harness-tui/dsh-tui 0.10.0 → 0.10.2

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

@@ -0,0 +1,147 @@
+import { join } from 'node:path';
+import { rankFileCandidates } from '../../utils/fileSuggestions.js';
+import { homeDir } from '../../utils/paths.js';
+/** Trailing path segment (`C:/a/b` → `b`). */
+export function basename(path) {
+    const parts = path.split(/[\\/]/);
+    return parts[parts.length - 1] ?? path;
+}
+/** Normalize a cwd for comparison: forward slashes, no trailing slash; case
+ *  folded when the platform's filesystem semantics are case-insensitive. */
+export function normalizeCwd(path, caseInsensitive) {
+    const normalized = path.replace(/\\/g, '/').replace(/\/+$/, '');
+    return caseInsensitive ? normalized.toLowerCase() : normalized;
+}
+/**
+ * `/resume` project filter (issue #96): exact cwd match, PLUS sessions
+ * recorded in a subdirectory — pre-upgrade launches recorded the launch
+ * subdirectory as the header cwd, and with the cwd default now resolving to
+ * the git worktree root an exact match would hide those sessions forever.
+ * They belong to the same workspace, so they stay listed. Comparison follows
+ * the platform's filesystem semantics (case-insensitive on Windows — a
+ * pre-upgrade header may record `C:\Repo` where the current launch resolves
+ * `c:\repo`). `caseInsensitive` is a parameter (not a platform read) so the
+ * verifier can exercise both modes on any host. Exported for
+ * scripts/verify-session-cwd.mjs.
+ *
+ * Boundary rule (issue #153): container directories are nobody's workspace.
+ * $HOME and the Windows root forms — plain drive roots (`C:`), UNC share
+ * roots (`//server/share`), and extended-length roots (`//?/C:`,
+ * `//?/UNC/server/share`) — are ancestors of unrelated projects, so the
+ * descendant rules below would list every session on the machine from `~`
+ * (and every session on the drive/share from those roots). At these
+ * boundaries, in either direction, only an exact match passes.
+ */
+export function sessionCwdMatches(stateCwd, headerCwd, caseInsensitive = process.platform === 'win32') {
+    const cwd = normalizeCwd(stateCwd, caseInsensitive);
+    const recorded = normalizeCwd(headerCwd, caseInsensitive);
+    if (recorded === '' || cwd === '')
+        return false;
+    const home = normalizeCwd(homeDir(), caseInsensitive);
+    // Paths below arrive backslash-normalized (`\\server\share` →
+    // `//server/share`, `\\?\C:\` → `//?/C:`), trailing slashes stripped.
+    const isContainer = (path) => (home !== '' && path === home) ||
+        /^[a-z]:$/i.test(path) || // drive root: C:
+        /^\/\/[^/]+\/[^/]+$/.test(path) || // UNC share root: //server/share
+        /^\/\/\?\/[a-z]:$/i.test(path) || // extended drive root: //?/C:
+        /^\/\/\?\/unc\/[^/]+\/[^/]+$/i.test(path); // extended UNC root: //?/UNC/server/share
+    if (isContainer(cwd) || isContainer(recorded))
+        return recorded === cwd;
+    return (recorded === cwd ||
+        // Pre-upgrade subdirectory session of this workspace.
+        recorded.startsWith(`${cwd}/`) ||
+        // Resumed INTO a pre-upgrade subdirectory session (state.cwd adopted its
+        // recorded subdirectory): the workspace-root sessions it belongs with
+        // must stay visible, or /resume looks like it lost them for the rest of
+        // the process lifetime (review leftover).
+        cwd.startsWith(`${recorded}/`));
+}
+export async function listPathCandidates(fs, cwd, query, signal, topK) {
+    const normalized = query.replaceAll('\\', '/');
+    const slash = normalized.lastIndexOf('/');
+    // `.` / `..` without a trailing separator are whole-directory queries too.
+    const bareDir = slash < 0 && (normalized === '.' || normalized === '..' || normalized === '~');
+    const directoryPart = slash < 0 ? (bareDir ? `${normalized}/` : '') : normalized.slice(0, slash + 1);
+    const nameQuery = slash < 0 || bareDir ? '' : normalized.slice(slash + 1);
+    // `~/` expands against the host home (matches the cwd resolution rules);
+    // drive-letter and POSIX-absolute prefixes pass through untouched.
+    const expanded = directoryPart === '~/'
+        ? `${homeDir()}/`
+        : directoryPart.startsWith('/') || /^[A-Za-z]:\//.test(directoryPart)
+            ? directoryPart
+            : join(cwd, directoryPart || '.');
+    try {
+        if (signal?.aborted)
+            return [];
+        const target = await fs.resolve(expanded);
+        const entries = (await fs.listDir(target)).slice().sort((a, b) => a.name.localeCompare(b.name));
+        return rankFileCandidates(entries.filter(entry => entry.type === 'file' || entry.type === 'directory').map(entry => {
+            const path = `${directoryPart}${entry.name}${entry.type === 'directory' ? '/' : ''}`;
+            return { id: path, path, displayPath: path, name: entry.name, kind: entry.type, score: 0 };
+        }), nameQuery, topK);
+    }
+    catch {
+        return [];
+    }
+}
+export async function listFilesDeepCandidates(fs, root, signal) {
+    if (!fs)
+        return [];
+    const out = [];
+    const SKIP = new Set(['node_modules', '.git', '.hg', '.svn', '.DS_Store', 'dist']);
+    const BUILD_DIR = /^(?:build(?:[-_].*)?|cmake-build(?:[-_].*)?)$/i;
+    const queue = [{ dir: root, prefix: '', index: 0 }];
+    const visited = new Set();
+    const maxFiles = 100;
+    const maxDirectories = 100;
+    let fileCount = 0;
+    let dirCount = 0;
+    // Round-robin: each directory yields ONE non-skipped entry per visit before
+    // it re-queues, so a large early sibling (e.g. `generated/` with 120 files)
+    // cannot starve `src/` out of the per-kind budgets. This is the regression
+    // contract pinned by scripts/verify-file-completion.mjs.
+    while (queue.length && fileCount < maxFiles && dirCount < maxDirectories) {
+        if (signal?.aborted)
+            return [];
+        const current = queue.shift();
+        if (!current.entries) {
+            try {
+                const target = await fs.resolve(current.dir);
+                if (visited.has(target.displayPath))
+                    continue;
+                visited.add(target.displayPath);
+                current.entries = (await fs.listDir(target)).slice().sort((a, b) => a.name.localeCompare(b.name));
+            }
+            catch {
+                continue;
+            }
+        }
+        let entry;
+        while (current.index < current.entries.length) {
+            const candidate = current.entries[current.index++];
+            if (SKIP.has(candidate.name) || BUILD_DIR.test(candidate.name))
+                continue;
+            entry = candidate;
+            break;
+        }
+        if (!entry)
+            continue;
+        if (current.index < current.entries.length)
+            queue.push(current);
+        const path = current.prefix ? `${current.prefix}/${entry.name}` : entry.name;
+        if (entry.type === 'directory') {
+            if (dirCount >= maxDirectories)
+                continue;
+            out.push({ id: `${path}/`, path: `${path}/`, displayPath: `${path}/`, name: entry.name, kind: 'directory', score: 0 });
+            dirCount += 1;
+            queue.push({ dir: entry.target?.displayPath ?? join(current.dir, entry.name), prefix: path, index: 0 });
+        }
+        else if (entry.type === 'file') {
+            if (fileCount >= maxFiles)
+                continue;
+            out.push({ id: path, path, displayPath: path, name: entry.name, kind: 'file', score: 0 });
+            fileCount += 1;
+        }
+    }
+    return out.sort((a, b) => a.path.localeCompare(b.path));
+}

package/lib/types/dsh-adapter/channel/permissions.d.ts

@@ -0,0 +1,40 @@
+import { type SessionModeSpec } from '../../sessionModes.js';
+import type { PermissionPresetOption, PermissionPresetService, PermissionPresetSnapshot } from './types.js';
+export declare const PERMISSION_PRESET_CUSTOM = "custom";
+export declare const PERMISSION_PRESET_NAME_CELLS = 120;
+export declare const PERMISSION_PRESET_DESCRIPTION_CELLS = 400;
+/** The mounted registry may expose seams this package's declared contract
+ *  does not name yet: `resolve` (atom bundles) and `set` (the write path the
+ *  official `/permission` command drives). Read structurally, never assumed. */
+export interface PermissionPresetRuntime extends PermissionPresetService {
+    resolve?: (name: string) => unknown;
+    set?: (subject: unknown, name: string) => unknown;
+}
+/** One runtime preset's resolved atom bundle. */
+export interface PermissionPresetBundle {
+    readonly value: string;
+    readonly sandbox?: SessionModeSpec['sandbox'];
+    readonly approval?: SessionModeSpec['approval'];
+}
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** Narrow a raw service read to the structural registry surface. */
+export declare function permissionPresetRuntime(service: unknown): PermissionPresetRuntime | undefined;
+/** Keep a permission roster read-only after it crosses the adapter boundary.
+ *  The registry may reuse and mutate its option objects between reads; callers
+ *  must observe one stable snapshot instead of a live view into that service. */
+export declare function freezePermissionPresetSnapshot(snapshot: PermissionPresetSnapshot): PermissionPresetSnapshot;
+export declare function legacyPermissionPresetOptions(): readonly PermissionPresetOption[];
+export declare function legacyPermissionPresetSnapshot(sandbox: SessionModeSpec['sandbox']): PermissionPresetSnapshot;
+export declare function unavailablePermissionPresetSnapshot(): PermissionPresetSnapshot;
+export declare function normalizePermissionPresetOption(value: unknown): PermissionPresetOption | undefined;
+/** Atom bundles the deployment's preset table resolves (value →
+ *  sandbox/approval). Empty when the service is absent or exposes no
+ *  `resolve` seam — canonical resolution then falls back to the stock
+ *  bundles (see `canonicalPresetFor`). */
+export declare function permissionBundlesFromService(service: unknown): readonly PermissionPresetBundle[];
+/** The registry's current readback for one subject. Real harness registries
+ *  resolve `current(session)` through their session-projections seam; earlier
+ *  contract versions folded a raw event log. Try the subject as given, then
+ *  the event-log shape it may carry. */
+export declare function permissionPresetSnapshotFromService(service: unknown, subject: unknown): PermissionPresetSnapshot;
+//# sourceMappingURL=permissions.d.ts.map

package/lib/types/dsh-adapter/channel/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/permissions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAE3G,eAAO,MAAM,wBAAwB,WAAW,CAAA;AAEhD,eAAO,MAAM,4BAA4B,MAAM,CAAA;AAE/C,eAAO,MAAM,mCAAmC,MAAM,CAAA;AAEtD;;gFAEgF;AAChF,MAAM,WAAW,uBAAwB,SAAQ,uBAAuB;IACtE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IACnC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CAClD;AAED,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAA;CAChD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,oEAAoE;AACpE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,uBAAuB,GAAG,SAAS,CAE7F;AAED;;iFAEiF;AACjF,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,wBAAwB,GAAG,wBAAwB,CAQ3G;AAED,wBAAgB,6BAA6B,IAAI,SAAS,sBAAsB,EAAE,CAkBjF;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,GAAG,wBAAwB,CAU5G;AAED,wBAAgB,mCAAmC,IAAI,wBAAwB,CAE9E;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,GAAG,SAAS,CAclG;AAED;;;0CAG0C;AAC1C,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,sBAAsB,EAAE,CAwBhG;AAED;;;wCAGwC;AACxC,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GACf,wBAAwB,CAyE1B"}

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

@@ -0,0 +1,187 @@
+import { t } from '../../i18n.js';
+import { cleanRenderText } from '../sanitize.js';
+export const PERMISSION_PRESET_CUSTOM = 'custom';
+export const PERMISSION_PRESET_NAME_CELLS = 120;
+export const PERMISSION_PRESET_DESCRIPTION_CELLS = 400;
+export function isRecord(value) {
+    return value !== null && typeof value === 'object';
+}
+/** Narrow a raw service read to the structural registry surface. */
+export function permissionPresetRuntime(service) {
+    return isRecord(service) ? service : undefined;
+}
+/** Keep a permission roster read-only after it crosses the adapter boundary.
+ *  The registry may reuse and mutate its option objects between reads; callers
+ *  must observe one stable snapshot instead of a live view into that service. */
+export function freezePermissionPresetSnapshot(snapshot) {
+    const options = Object.freeze(snapshot.options.map(option => Object.freeze({ ...option })));
+    const current = snapshot.current === undefined ? undefined : Object.freeze({ ...snapshot.current });
+    return Object.freeze({
+        availability: snapshot.availability,
+        options,
+        ...(current === undefined ? {} : { current }),
+    });
+}
+export function legacyPermissionPresetOptions() {
+    return [
+        {
+            value: 'read-only',
+            name: t('permission-preset-readonly'),
+            description: t('permission-preset-readonly-desc'),
+        },
+        {
+            value: 'workspace-write',
+            name: t('permission-preset-workspace-write'),
+            description: t('permission-preset-workspace-write-desc'),
+        },
+        {
+            value: 'danger-full-access',
+            name: t('permission-preset-full-access'),
+            description: t('permission-preset-full-access-desc'),
+        },
+    ];
+}
+export function legacyPermissionPresetSnapshot(sandbox) {
+    const options = legacyPermissionPresetOptions();
+    const currentOption = sandbox === undefined ? undefined : options.find(option => option.value === sandbox);
+    return freezePermissionPresetSnapshot({
+        availability: 'legacy',
+        options,
+        ...(currentOption === undefined
+            ? {}
+            : { current: { ...currentOption, kind: 'preset' } }),
+    });
+}
+export function unavailablePermissionPresetSnapshot() {
+    return freezePermissionPresetSnapshot({ availability: 'unavailable', options: [] });
+}
+export function normalizePermissionPresetOption(value) {
+    if (!isRecord(value) || typeof value.value !== 'string' || typeof value.name !== 'string')
+        return undefined;
+    const name = cleanRenderText(value.name, PERMISSION_PRESET_NAME_CELLS);
+    if (name === '')
+        return undefined;
+    if (value.description !== undefined && typeof value.description !== 'string')
+        return undefined;
+    const description = value.description === undefined
+        ? undefined
+        : cleanRenderText(value.description, PERMISSION_PRESET_DESCRIPTION_CELLS);
+    if (value.description !== undefined && description === '')
+        return undefined;
+    return {
+        value: value.value,
+        name,
+        ...(description === undefined || description === '' ? {} : { description }),
+    };
+}
+/** Atom bundles the deployment's preset table resolves (value →
+ *  sandbox/approval). Empty when the service is absent or exposes no
+ *  `resolve` seam — canonical resolution then falls back to the stock
+ *  bundles (see `canonicalPresetFor`). */
+export function permissionBundlesFromService(service) {
+    const runtime = permissionPresetRuntime(service);
+    if (runtime === undefined || typeof runtime.resolve !== 'function')
+        return [];
+    const names = Array.isArray(runtime.names) ? runtime.names : [];
+    const bundles = [];
+    for (const name of names) {
+        if (typeof name !== 'string')
+            continue;
+        try {
+            // The registry resolves atoms on instance state; never detach `resolve`.
+            const spec = runtime.resolve(name);
+            if (!isRecord(spec))
+                continue;
+            const sandbox = spec.sandbox;
+            const approval = spec.approval;
+            if ((sandbox === 'read-only' || sandbox === 'workspace-write' || sandbox === 'danger-full-access')
+                && (approval === 'ask' || approval === 'never')) {
+                bundles.push({ value: name, sandbox, approval });
+            }
+        }
+        catch {
+            // Optional resolution; a broken entry just does not extend the table.
+        }
+    }
+    return bundles;
+}
+/** The registry's current readback for one subject. Real harness registries
+ *  resolve `current(session)` through their session-projections seam; earlier
+ *  contract versions folded a raw event log. Try the subject as given, then
+ *  the event-log shape it may carry. */
+export function permissionPresetSnapshotFromService(service, subject) {
+    const runtime = permissionPresetRuntime(service);
+    if (runtime === undefined)
+        return unavailablePermissionPresetSnapshot();
+    try {
+        const capturedNames = Array.isArray(runtime.names) ? runtime.names : [];
+        if (capturedNames.length === 0)
+            return unavailablePermissionPresetSnapshot();
+        if (typeof runtime.current !== 'function' || typeof runtime.optionOf !== 'function') {
+            return unavailablePermissionPresetSnapshot();
+        }
+        // Readback lives on the registry instance; bind so the calls below keep
+        // reaching it through the same object instead of a detached reference.
+        const current = runtime.current.bind(runtime);
+        const optionOf = runtime.optionOf.bind(runtime);
+        const names = [];
+        for (const name of capturedNames) {
+            if (typeof name !== 'string' || name.trim() === '' || name === PERMISSION_PRESET_CUSTOM || names.includes(name)) {
+                return unavailablePermissionPresetSnapshot();
+            }
+            names.push(name);
+        }
+        const seen = new Set(names);
+        const options = [];
+        for (const name of names) {
+            const option = normalizePermissionPresetOption(optionOf(name));
+            if (option === undefined || option.value !== name)
+                return unavailablePermissionPresetSnapshot();
+            options.push({ ...option });
+        }
+        let currentValue;
+        try {
+            currentValue = current(subject);
+        }
+        catch {
+            currentValue = undefined;
+        }
+        if (typeof currentValue !== 'string') {
+            // Second chance for the other contract shape: a subject that carries an
+            // event log, or a raw log handed in directly.
+            const fallback = subject?.events ?? subject;
+            try {
+                currentValue = current(fallback);
+            }
+            catch {
+                if (typeof currentValue !== 'string')
+                    return unavailablePermissionPresetSnapshot();
+            }
+        }
+        if (typeof currentValue !== 'string' || (currentValue !== PERMISSION_PRESET_CUSTOM && !seen.has(currentValue))) {
+            return unavailablePermissionPresetSnapshot();
+        }
+        const currentOption = normalizePermissionPresetOption(optionOf(currentValue));
+        if (currentOption === undefined || currentOption.value !== currentValue)
+            return unavailablePermissionPresetSnapshot();
+        if (currentValue !== PERMISSION_PRESET_CUSTOM) {
+            const rosterOption = options.find(option => option.value === currentValue);
+            if (rosterOption === undefined
+                || rosterOption.name !== currentOption.name
+                || rosterOption.description !== currentOption.description) {
+                return unavailablePermissionPresetSnapshot();
+            }
+        }
+        return freezePermissionPresetSnapshot({
+            availability: 'runtime',
+            options,
+            current: {
+                ...currentOption,
+                kind: currentValue === PERMISSION_PRESET_CUSTOM ? 'custom' : 'preset',
+            },
+        });
+    }
+    catch {
+        return unavailablePermissionPresetSnapshot();
+    }
+}

package/lib/types/dsh-adapter/channel/preferences.d.ts

@@ -0,0 +1,3 @@
+import type { ChannelState } from '../channel/types.js';
+export declare function createPreferences(getState: () => Pick<ChannelState, 'diffLayout' | 'thinkingFold' | 'toolBackground' | 'scrollGutter' | 'pageMargin' | 'foldTerminalCommand' | 'promptSessionLabel' | 'expandEditor' | 'smoothStreaming' | 'statusBar' | 'whale' | 'whaleIdle' | 'minimal' | 'emit'>): Pick<ChannelState, 'setDiffLayout' | 'setThinkingFold' | 'setToolBackground' | 'setScrollGutter' | 'setPageMargin' | 'setFoldTerminalCommand' | 'setPromptSessionLabel' | 'setExpandEditor' | 'setSmoothStreaming' | 'setStatusBar' | 'setWhale' | 'setWhaleIdle' | 'setMinimal'>;
+//# sourceMappingURL=preferences.d.ts.map

package/lib/types/dsh-adapter/channel/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/preferences.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,cAAc,GAAG,gBAAgB,GAAG,cAAc,GAAG,YAAY,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,cAAc,GAAG,iBAAiB,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,eAAe,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,eAAe,GAAG,wBAAwB,GAAG,uBAAuB,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,cAAc,GAAG,UAAU,GAAG,cAAc,GAAG,YAAY,CAAC,CAsGxjB"}

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

@@ -0,0 +1,103 @@
+import { setMinimalMode } from '../../minimalMode.js';
+import { normalizePageMargin, normalizeScrollGutter, normalizeStatusBar, normalizeToolBackground } from '../../tuiDisplayPrefs.js';
+export function createPreferences(getState) {
+    return {
+        setDiffLayout(layout) {
+            const state = getState();
+            if (layout === state.diffLayout)
+                return;
+            state.diffLayout = layout;
+            state.emit();
+        },
+        setThinkingFold(mode) {
+            const state = getState();
+            if (mode === state.thinkingFold)
+                return;
+            state.thinkingFold = mode;
+            state.emit();
+        },
+        setToolBackground(background) {
+            const state = getState();
+            const normalized = normalizeToolBackground(background);
+            if (normalized === state.toolBackground)
+                return;
+            state.toolBackground = normalized;
+            state.emit();
+        },
+        setScrollGutter(mode) {
+            const state = getState();
+            const normalized = normalizeScrollGutter(mode);
+            if (normalized === state.scrollGutter)
+                return;
+            state.scrollGutter = normalized;
+            state.emit();
+        },
+        setPageMargin(setting) {
+            const state = getState();
+            const normalized = normalizePageMargin(setting);
+            if (normalized === state.pageMargin)
+                return;
+            state.pageMargin = normalized;
+            state.emit();
+        },
+        setFoldTerminalCommand(enabled) {
+            const state = getState();
+            if (enabled === state.foldTerminalCommand)
+                return;
+            state.foldTerminalCommand = enabled;
+            state.emit();
+        },
+        setPromptSessionLabel(enabled) {
+            const state = getState();
+            if (enabled === state.promptSessionLabel)
+                return;
+            state.promptSessionLabel = enabled;
+            state.emit();
+        },
+        setExpandEditor(enabled) {
+            const state = getState();
+            if (enabled === state.expandEditor)
+                return;
+            state.expandEditor = enabled;
+            state.emit();
+        },
+        setSmoothStreaming(enabled) {
+            const state = getState();
+            if (enabled === state.smoothStreaming)
+                return;
+            state.smoothStreaming = enabled;
+            state.emit();
+        },
+        setStatusBar(config) {
+            const state = getState();
+            const next = normalizeStatusBar({ ...state.statusBar, ...config });
+            const changed = Object.keys(next).some(key => next[key] !== state.statusBar[key]);
+            if (!changed)
+                return;
+            state.statusBar = next;
+            state.emit();
+        },
+        setWhale(visible) {
+            const state = getState();
+            if (visible === state.whale)
+                return;
+            state.whale = visible;
+            state.emit();
+        },
+        setWhaleIdle(enabled) {
+            const state = getState();
+            if (enabled === state.whaleIdle)
+                return;
+            state.whaleIdle = enabled;
+            state.emit();
+        },
+        setMinimal(enabled) {
+            const state = getState();
+            setMinimalMode(enabled);
+            if (enabled === state.minimal)
+                return;
+            state.minimal = enabled;
+            state.emit();
+        }
+    };
+}

package/lib/types/dsh-adapter/channel/projection-helpers.d.ts

@@ -0,0 +1,13 @@
+import type { TodoPanelItem } from './types.js';
+export declare function isSubagentToolName(name: string): boolean;
+/** Extract `job_id` from a job_output call's raw args (JSON), or undefined. */
+export declare function parseJobOutputId(argsFull: string | undefined): string | undefined;
+/** Extract the command that launched a background job from its tool args
+ *  (`command` for the shell tools, `text` for terminal_send). The registry
+ *  label is the friendly description; the command is the actual invocation. */
+export declare function toolCommandOf(argsFull: string | undefined): string | undefined;
+/** The ack a shell tool returns for `run_in_background: true`. */
+export declare const BACKGROUND_START_ACK: RegExp;
+/** Narrow an optional plugin event without importing its module augmentation. */
+export declare function todoPanelItems(data: unknown): TodoPanelItem[] | undefined;
+//# sourceMappingURL=projection-helpers.d.ts.map

package/lib/types/dsh-adapter/channel/projection-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-helpers.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/projection-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAY/C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAQjF;AAED;;+EAE+E;AAC/E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAa9E;AAED,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,QAAkC,CAAA;AAEnE,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,EAAE,GAAG,SAAS,CAWzE"}

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

@@ -0,0 +1,63 @@
+/** Names the subagent delegation tools ship under (preset `toolName` values
+ *  plus the CLI default); each renders as a live subagent card, never a plain
+ *  tool card. */
+const SUBAGENT_TOOL_NAMES = new Set([
+    'task',
+    'subagent',
+    'subagent_fork',
+    'subagent_claude_code',
+    'subagent_codex',
+    'spawn_task',
+]);
+export function isSubagentToolName(name) {
+    return SUBAGENT_TOOL_NAMES.has(name.toLowerCase());
+}
+/** Extract `job_id` from a job_output call's raw args (JSON), or undefined. */
+export function parseJobOutputId(argsFull) {
+    if (argsFull === undefined || argsFull === '')
+        return undefined;
+    try {
+        const args = JSON.parse(argsFull);
+        return typeof args.job_id === 'string' && args.job_id !== '' ? args.job_id : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Extract the command that launched a background job from its tool args
+ *  (`command` for the shell tools, `text` for terminal_send). The registry
+ *  label is the friendly description; the command is the actual invocation. */
+export function toolCommandOf(argsFull) {
+    if (argsFull === undefined || argsFull === '')
+        return undefined;
+    try {
+        const args = JSON.parse(argsFull);
+        const candidate = typeof args.command === 'string' && args.command !== ''
+            ? args.command
+            : typeof args.text === 'string' && args.text !== ''
+                ? args.text
+                : undefined;
+        return candidate;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The ack a shell tool returns for `run_in_background: true`. */
+export const BACKGROUND_START_ACK = /^started background job (\S+)/;
+/** Narrow an optional plugin event without importing its module augmentation. */
+export function todoPanelItems(data) {
+    if (typeof data !== 'object' || data === null)
+        return undefined;
+    const todos = data.todos;
+    if (!Array.isArray(todos))
+        return undefined;
+    const valid = todos.every(item => {
+        if (typeof item !== 'object' || item === null)
+            return false;
+        const candidate = item;
+        return typeof candidate.content === 'string' &&
+            (candidate.status === 'pending' || candidate.status === 'in_progress' || candidate.status === 'completed');
+    });
+    return valid ? todos : undefined;
+}

package/lib/types/dsh-adapter/channel/projection.d.ts

@@ -0,0 +1,40 @@
+import type { Agent, AssistantStreamFrame } from '@deepseek-ai/dsh-agent';
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+import type { ContentBlock } from '@deepseek-ai/dsh-llm';
+import type { ChannelState, ToolCallView, ToolResultView, ToolsRegistryLike } from './types.js';
+import type { InputConvergence } from './input-actions.js';
+import type { BackgroundJobStore } from '../jobs.js';
+import type { TuiRendererHost } from '../renderers.js';
+type ProjectionState = Pick<ChannelState, 'rows' | 'thinkingFold' | 'activeToolCount' | 'spinnerMode' | 'goal' | 'contextSegments' | 'tokens' | 'lastUsage' | 'lastUserText' | 'responseChars' | 'tps' | 'cancelPending' | 'working' | 'turnStart' | 'tpsSamples' | 'contextWindow' | 'reasoningEffort' | 'sessionTitle' | 'todos' | 'agentPreset' | 'sessionColor' | 'status' | 'emit'>;
+interface ProjectionDependencies {
+    agent(): Agent;
+    rowIds: {
+        value: number;
+    };
+    resetContextWarning(): void;
+    pendingTaskDescriptions: string[];
+    jobs: Pick<BackgroundJobStore, 'onOutputSeen' | 'onStarted'>;
+    inputConvergence: Pick<InputConvergence, 'cancelInFlight'>;
+    checkContextWarning(): void;
+    notify: ChannelState['notify'];
+    tools?: ToolsRegistryLike;
+    renderer?: TuiRendererHost;
+    /** DSH attachment service, resolved at call time (a late-mounted provider
+     *  must still serve images for rows projected earlier). */
+    attachments(): unknown;
+}
+/** One authoritative reducer for both durable replay and live session events. */
+export declare function createChannelProjection(state: ProjectionState, deps: ProjectionDependencies): {
+    reset: () => void;
+    replayEvents: (events: readonly SessionEvent[]) => void;
+    renderEvent: (event: SessionEvent) => void;
+    renderStreamFrame: (frame: AssistantStreamFrame) => void;
+    settleStreaming: () => void;
+    updateSpinnerMode: () => void;
+    presentCallView: (name: string, rawArgs: string) => ToolCallView | undefined;
+    presentResultView: (name: string, rawArgs: string, data: SessionEvent<"tool/result">["data"]) => ToolResultView | undefined;
+    textOf: (content: readonly ContentBlock[] | undefined) => string;
+    firstTextOf: (content: readonly ContentBlock[] | undefined) => string;
+};
+export {};
+//# sourceMappingURL=projection.d.ts.map

package/lib/types/dsh-adapter/channel/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,sBAAsB,CAAA;AACrE,OAAO,KAAK,EAAE,YAAY,EAAwB,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACrH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAYtD,KAAK,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,iBAAiB,GAAG,aAAa,GAAG,MAAM,GAAG,iBAAiB,GAAG,QAAQ,GAAG,WAAW,GAAG,cAAc,GAAG,eAAe,GAAG,KAAK,GAAG,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,eAAe,GAAG,iBAAiB,GAAG,cAAc,GAAG,OAAO,GAAG,aAAa,GAAG,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAA;AACxX,UAAU,sBAAsB;IAC/B,KAAK,IAAI,KAAK,CAAA;IACd,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB,mBAAmB,IAAI,IAAI,CAAA;IAC3B,uBAAuB,EAAE,MAAM,EAAE,CAAA;IACjC,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,cAAc,GAAG,WAAW,CAAC,CAAA;IAC5D,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAA;IAC1D,mBAAmB,IAAI,IAAI,CAAA;IAC3B,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC9B,KAAK,CAAC,EAAE,iBAAiB,CAAA;IACzB,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B;+DAC2D;IAC3D,WAAW,IAAI,OAAO,CAAA;CACtB;AACD,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,sBAAsB;iBA6+BxE,IAAI;2BAxpBQ,SAAS,YAAY,EAAE,KAAG,IAAI;yBAiGhC,YAAY,KAAG,IAAI;+BAxBb,oBAAoB,KAAG,IAAI;2BAtKjC,IAAI;6BAgBF,IAAI;4BA/IH,MAAM,WAAW,MAAM,KAAG,YAAY,GAAG,SAAS;8BAYhD,MAAM,WAAW,MAAM,QAAQ,YAAY,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,KAAG,cAAc,GAAG,SAAS;sBAwBvG,SAAS,YAAY,EAAE,GAAG,SAAS,KAAG,MAAM;2BASvC,SAAS,YAAY,EAAE,GAAG,SAAS,KAAG,MAAM;EA21B3E"}