@dsh-cc/tui 0.5.0

package/lib/mode-cycle.js

@@ -0,0 +1,32 @@
+/**
+ * Pure Shift+Tab cycle over CC permission-rule modes. Browser-safe and
+ * harness-free so the cycle cannot drift from the `/permissions` list.
+ * @module @dsh-cc/tui/mode-cycle
+ */
+import { PERMISSION_COMMAND_MODES, } from '@dsh-cc/command-permissions';
+export { PERMISSION_COMMAND_MODES };
+/** Cycle order matches `/permissions` advertisement. */
+export const PERMISSION_CYCLE = PERMISSION_COMMAND_MODES;
+/**
+ * Advance one step in the CC permission-mode cycle.
+ * @param current - the mode currently in force.
+ * @param bypassDisabled - when true, `bypassPermissions` is skipped.
+ * @returns the next mode (wraps to the first).
+ */
+export function nextPermissionMode(current, bypassDisabled = false) {
+    const list = bypassDisabled
+        ? PERMISSION_CYCLE.filter(mode => mode !== 'bypassPermissions')
+        : PERMISSION_CYCLE;
+    const index = list.indexOf(current);
+    if (index === -1)
+        return list[0] ?? 'default';
+    return list[(index + 1) % list.length] ?? 'default';
+}
+/**
+ * Whether `mode` is one of the advertised CC permission modes.
+ * @param mode - untrusted user input.
+ */
+export function isPermissionMode(mode) {
+    return PERMISSION_CYCLE.includes(mode);
+}
+//# sourceMappingURL=mode-cycle.js.map

package/lib/mode-cycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-cycle.js","sourceRoot":"","sources":["../src/mode-cycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,wBAAwB,GAEzB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EAAE,wBAAwB,EAA8B,CAAA;AAE/D,wDAAwD;AACxD,MAAM,CAAC,MAAM,gBAAgB,GAAqC,wBAAwB,CAAA;AAE1F;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,cAAc,GAAG,KAAK;IAEtB,MAAM,IAAI,GAAG,cAAc;QACzB,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,mBAAmB,CAAC;QAC/D,CAAC,CAAC,gBAAgB,CAAA;IACpB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAgC,CAAC,CAAA;IAC5D,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS,CAAA;IAC7C,OAAO,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,SAAS,CAAA;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAQ,gBAAsC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AAC/D,CAAC"}

package/lib/model-catalog.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Pure LLM catalog formatting and choice parsing for `/model`.
+ * @module @dsh-cc/tui/model-catalog
+ */
+export interface CatalogEntry {
+    provider: string;
+    id: string;
+    name: string;
+}
+export interface ModelRoute {
+    provider: string;
+    model: string;
+}
+/**
+ * Render advertised models, starring the live route.
+ */
+export declare function formatModelCatalog(catalog: readonly CatalogEntry[], current: ModelRoute | undefined): string;
+/**
+ * Resolve a `/model` argument: 1-based index, `provider/id`, or a unique id.
+ */
+export declare function parseModelChoice(raw: string, catalog: readonly CatalogEntry[]): ModelRoute | undefined;
+//# sourceMappingURL=model-catalog.d.ts.map

package/lib/model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../src/model-catalog.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,OAAO,EAAE,UAAU,GAAG,SAAS,GAC9B,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,UAAU,GAAG,SAAS,CAmBxB"}

package/lib/model-catalog.js

@@ -0,0 +1,45 @@
+/**
+ * Pure LLM catalog formatting and choice parsing for `/model`.
+ * @module @dsh-cc/tui/model-catalog
+ */
+/**
+ * Render advertised models, starring the live route.
+ */
+export function formatModelCatalog(catalog, current) {
+    if (catalog.length === 0)
+        return 'No models are advertised by the mounted LLM adapters.';
+    return catalog.map((entry, index) => {
+        const key = `${entry.provider}/${entry.id}`;
+        const star = current !== undefined
+            && current.provider === entry.provider
+            && current.model === entry.id;
+        const mark = star ? '*' : ' ';
+        return `${mark} ${index + 1}. ${key} — ${entry.name}`;
+    }).join('\n');
+}
+/**
+ * Resolve a `/model` argument: 1-based index, `provider/id`, or a unique id.
+ */
+export function parseModelChoice(raw, catalog) {
+    const token = raw.trim();
+    if (token.length === 0)
+        return undefined;
+    if (/^\d+$/.test(token)) {
+        const index = Number.parseInt(token, 10) - 1;
+        const entry = catalog[index];
+        return entry === undefined ? undefined : { provider: entry.provider, model: entry.id };
+    }
+    const slash = token.indexOf('/');
+    if (slash > 0) {
+        const provider = token.slice(0, slash);
+        const model = token.slice(slash + 1);
+        const entry = catalog.find(item => item.provider === provider && item.id === model);
+        return entry === undefined ? undefined : { provider: entry.provider, model: entry.id };
+    }
+    const matches = catalog.filter(item => item.id === token);
+    if (matches.length !== 1)
+        return undefined;
+    const only = matches[0];
+    return { provider: only.provider, model: only.id };
+}
+//# sourceMappingURL=model-catalog.js.map

package/lib/model-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.js","sourceRoot":"","sources":["../src/model-catalog.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAgC,EAChC,OAA+B;IAE/B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,uDAAuD,CAAA;IACxF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAClC,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,EAAE,CAAA;QAC3C,MAAM,IAAI,GAAG,OAAO,KAAK,SAAS;eAC7B,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;eACnC,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,CAAA;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;QAC7B,OAAO,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAA;IACvD,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAW,EACX,OAAgC;IAEhC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IACxB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACxC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAA;QAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;QAC5B,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAA;IACxF,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAChC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,CAAA;QACnF,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAA;IACxF,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,CAAA;IACzD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAE,CAAA;IACxB,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAA;AACpD,CAAC"}

package/lib/packaged-preset.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Materialize the CC preset into `$DSH_HOME/.agent-presets/cc`. The official
+ * launcher replaces system preset roots, so the user root is the supported
+ * extension seam (same pattern as dsh-TUI's packaged presets).
+ * @module @dsh-cc/tui/packaged-preset
+ */
+export declare const CC_PRESET_ID = "cc";
+export interface ManagedMarker {
+    owner: string;
+    preset: string;
+    revision: string;
+}
+export type PackagedPresetStatus = 'installed' | 'updated' | 'current' | 'conflict' | 'missing-source';
+export interface PackagedPresetResult {
+    id: string;
+    status: PackagedPresetStatus;
+}
+export interface PackagedPresetOptions {
+    dshHome?: string;
+    sourceRoot?: string;
+    revision?: string;
+}
+/**
+ * Resolve the packaged preset directory (src layout or compiled `presets/cc`).
+ */
+export declare function packagedPresetRoot(moduleUrl?: string): string | undefined;
+/**
+ * Copy the CC preset into the user root when missing or stale. Never overwrites
+ * an unmarked directory (a person authored that id).
+ */
+export declare function ensurePackagedPreset(options?: PackagedPresetOptions): PackagedPresetResult;
+//# sourceMappingURL=packaged-preset.d.ts.map

package/lib/packaged-preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packaged-preset.d.ts","sourceRoot":"","sources":["../src/packaged-preset.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,eAAO,MAAM,YAAY,OAAO,CAAA;AAEhC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,gBAAgB,CAAA;AAEtG,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,oBAAoB,CAAA;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAmBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,GAAE,MAAwB,GAAG,MAAM,GAAG,SAAS,CAS1F;AAOD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,oBAAoB,CA2C9F"}

package/lib/packaged-preset.js

@@ -0,0 +1,94 @@
+/**
+ * Materialize the CC preset into `$DSH_HOME/.agent-presets/cc`. The official
+ * launcher replaces system preset roots, so the user root is the supported
+ * extension seam (same pattern as dsh-TUI's packaged presets).
+ * @module @dsh-cc/tui/packaged-preset
+ */
+import { cpSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { randomUUID } from 'node:crypto';
+const OWNER = '@dsh-cc/tui';
+const MARKER = '.dsh-cc-managed.json';
+export const CC_PRESET_ID = 'cc';
+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 {
+        // Absent or user-authored marker: not ours.
+    }
+    return undefined;
+}
+/**
+ * Resolve the packaged preset directory (src layout or compiled `presets/cc`).
+ */
+export function packagedPresetRoot(moduleUrl = import.meta.url) {
+    const directory = dirname(fileURLToPath(moduleUrl));
+    const candidates = [
+        join(directory, '../presets', CC_PRESET_ID),
+        join(directory, '../../presets', CC_PRESET_ID),
+        join(directory, '../../../preset/cc'),
+        join(directory, '../../../../preset/cc'),
+    ];
+    return candidates.find(candidate => existsSync(join(candidate, 'agent.cordis.yml')));
+}
+function writeMarker(directory, revision) {
+    const marker = { owner: OWNER, preset: CC_PRESET_ID, revision };
+    writeFileSync(join(directory, MARKER), `${JSON.stringify(marker, null, 2)}\n`);
+}
+/**
+ * Copy the CC preset into the user root when missing or stale. Never overwrites
+ * an unmarked directory (a person authored that id).
+ */
+export function ensurePackagedPreset(options = {}) {
+    const source = options.sourceRoot ?? packagedPresetRoot();
+    if (source === undefined || !existsSync(join(source, 'agent.cordis.yml'))) {
+        return { id: CC_PRESET_ID, status: 'missing-source' };
+    }
+    const revision = options.revision
+        ?? (existsSync(join(source, MARKER)) ? readMarker(source)?.revision : undefined)
+        ?? '0.1.0';
+    const dshHome = options.dshHome ?? process.env.DSH_HOME ?? join(homedir(), '.dsh');
+    const targetRoot = join(dshHome, '.agent-presets');
+    const target = join(targetRoot, CC_PRESET_ID);
+    if (!existsSync(target)) {
+        mkdirSync(targetRoot, { recursive: true });
+        cpSync(source, target, { recursive: true, force: false, errorOnExist: true, filter: () => true });
+        writeMarker(target, revision);
+        return { id: CC_PRESET_ID, status: 'installed' };
+    }
+    const targetMarker = readMarker(target);
+    if (targetMarker === undefined || targetMarker.preset !== CC_PRESET_ID) {
+        return { id: CC_PRESET_ID, status: 'conflict' };
+    }
+    if (targetMarker.revision === revision) {
+        return { id: CC_PRESET_ID, status: 'current' };
+    }
+    const suffix = `${process.pid}-${randomUUID()}`;
+    const staged = join(targetRoot, `.${CC_PRESET_ID}.staged-${suffix}`);
+    const backup = join(targetRoot, `.${CC_PRESET_ID}.backup-${suffix}`);
+    mkdirSync(staged, { recursive: true });
+    cpSync(source, staged, { recursive: true, force: true, filter: () => true });
+    writeMarker(staged, revision);
+    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;
+    }
+    return { id: CC_PRESET_ID, status: 'updated' };
+}
+//# sourceMappingURL=packaged-preset.js.map

package/lib/packaged-preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packaged-preset.js","sourceRoot":"","sources":["../src/packaged-preset.ts"],"names":[],"mappings":"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"}

package/lib/plugin.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Boot wiring: packaged CC preset, TTY lease, driver, pi-tui mount.
+ * @module @dsh-cc/tui/plugin
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Config } from './index.ts';
+/**
+ * Start the TUI inside a dsh process.
+ */
+export declare function mountTui(ctx: Context, config: Config): Promise<void>;
+//# sourceMappingURL=plugin.d.ts.map

package/lib/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAMxC;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoF1E"}

package/lib/plugin.js

@@ -0,0 +1,88 @@
+/**
+ * Boot wiring: packaged CC preset, TTY lease, driver, pi-tui mount.
+ * @module @dsh-cc/tui/plugin
+ */
+import { createDriver } from "./harness/driver.js";
+import { ensurePackagedPreset } from "./packaged-preset.js";
+import { acquireTerminal } from "./terminal/lease.js";
+import { buildRoot } from "./components/root.js";
+/**
+ * Start the TUI inside a dsh process.
+ */
+export async function mountTui(ctx, config) {
+    const packaged = ensurePackagedPreset();
+    if (packaged.status === 'conflict') {
+        ctx.logger.warn('dsh-cc-tui: ~/.dsh/.agent-presets/cc exists and is not managed by this package; leaving it in place');
+    }
+    else if (packaged.status === 'missing-source') {
+        ctx.logger.warn('dsh-cc-tui: packaged CC preset files were not found next to the plugin; '
+            + 'ensure ~/.dsh/.agent-presets/cc exists (dsh-cc or scripts/sync-cc-preset.sh)');
+    }
+    const driver = await createDriver(ctx, {
+        ...config.cwd === undefined ? {} : { cwd: config.cwd },
+        ...config.agentPreset === undefined ? {} : { agentPreset: config.agentPreset },
+        ...config.sessionId === undefined
+            ? {}
+            : { sessionId: config.sessionId },
+        ...config.autoResume === undefined ? {} : { autoResume: config.autoResume },
+        ...config.continueRequested === undefined ? {} : { continueRequested: config.continueRequested },
+        ...config.provider === undefined || config.provider.length === 0
+            ? {}
+            : { provider: config.provider },
+        ...config.model === undefined || config.model.length === 0
+            ? {}
+            : { model: config.model },
+        // /copy hands the OSC 52 sequence to the live terminal (`root` is assigned
+        // below, before any command can run — same late-binding pattern as the
+        // shutdown closure).
+        copyWrite: (sequence) => {
+            root.tui.terminal.write(sequence);
+        },
+        // The driver owns the /quit finalizer (worktree-exit decisions included),
+        // so process shutdown hooks here as a late-bound closure — `shutdown` is
+        // defined just below and not yet assigned, which is safe because this
+        // only runs once a quit decision actually settles.
+        onQuit: () => {
+            shutdown();
+        },
+    });
+    if (process.stdin.isTTY) {
+        process.stdin.setEncoding('utf8');
+        process.stdin.resume();
+    }
+    let shuttingDown = false;
+    const shutdown = () => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        try {
+            root.destroy();
+            root.stopForExit();
+        }
+        catch {
+            // best-effort
+        }
+        void driver.dispose().finally(() => {
+            lease.release();
+            process.exit(0);
+        });
+    };
+    const lease = acquireTerminal({
+        onSignal: () => {
+            shutdown();
+        },
+    });
+    const root = buildRoot(driver, {
+        onQuit: shutdown,
+        ...(config.uiMode === undefined ? {} : { uiMode: config.uiMode }),
+        ...(config.mouse === undefined ? {} : { mouse: config.mouse }),
+        ...(config.theme === undefined ? {} : { theme: config.theme }),
+    });
+    root.tui.start();
+    ctx.effect(() => () => {
+        lease.release();
+        root.destroy();
+        void driver.dispose();
+    });
+}
+//# sourceMappingURL=plugin.js.map

package/lib/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAEhD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAY,EAAE,MAAc;IACzD,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAA;IACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACnC,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,qGAAqG,CACtG,CAAA;IACH,CAAC;SAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;QAChD,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,0EAA0E;cACxE,8EAA8E,CACjF,CAAA;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE;QACrC,GAAG,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;QACtD,GAAG,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE;QAC9E,GAAG,MAAM,CAAC,SAAS,KAAK,SAAS;YAC/B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE;QACnC,GAAG,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;QAC3E,GAAG,MAAM,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE;QAChG,GAAG,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAC9D,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;QACjC,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YACxD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;QAC3B,2EAA2E;QAC3E,uEAAuE;QACvE,qBAAqB;QACrB,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YACtB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QACnC,CAAC;QACD,0EAA0E;QAC1E,yEAAyE;QACzE,sEAAsE;QACtE,mDAAmD;QACnD,MAAM,EAAE,GAAG,EAAE;YACX,QAAQ,EAAE,CAAA;QACZ,CAAC;KACF,CAAC,CAAA;IAEF,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;QACjC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAA;IACxB,CAAC;IAED,IAAI,YAAY,GAAG,KAAK,CAAA;IAExB,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,IAAI,YAAY;YAAE,OAAM;QACxB,YAAY,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,EAAE,CAAA;YACd,IAAI,CAAC,WAAW,EAAE,CAAA;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;QACD,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YACjC,KAAK,CAAC,OAAO,EAAE,CAAA;YACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,MAAM,KAAK,GAAG,eAAe,CAAC;QAC5B,QAAQ,EAAE,GAAG,EAAE;YACb,QAAQ,EAAE,CAAA;QACZ,CAAC;KACF,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE;QAC7B,MAAM,EAAE,QAAQ;QAChB,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QACjE,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC9D,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;KAC/D,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAA;IAEhB,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE;QACpB,KAAK,CAAC,OAAO,EAAE,CAAA;QACf,IAAI,CAAC,OAAO,EAAE,CAAA;QACd,KAAK,MAAM,CAAC,OAAO,EAAE,CAAA;IACvB,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/lib/profile.d.ts

@@ -0,0 +1,4 @@
+export declare const DSH_PROFILE_ENV = "DSH_CC_PROFILE";
+export declare const DEFAULT_DSH_PROFILE = "tui";
+export declare function resolveDshProfile(env?: NodeJS.Dict<string | undefined>): string;
+//# sourceMappingURL=profile.d.ts.map

package/lib/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,mBAAmB,CAAA;AAC/C,eAAO,MAAM,mBAAmB,QAAQ,CAAA;AAExC,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAe,GAAG,MAAM,CAG5F"}

package/lib/profile.js

@@ -0,0 +1,7 @@
+export const DSH_PROFILE_ENV = 'DSH_CC_PROFILE';
+export const DEFAULT_DSH_PROFILE = 'tui';
+export function resolveDshProfile(env = process.env) {
+    const value = env[DSH_PROFILE_ENV];
+    return typeof value === 'string' && value.length > 0 ? value : DEFAULT_DSH_PROFILE;
+}
+//# sourceMappingURL=profile.js.map

package/lib/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAA;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAA;AAExC,MAAM,UAAU,iBAAiB,CAAC,MAAuC,OAAO,CAAC,GAAG;IAClF,MAAM,KAAK,GAAG,GAAG,CAAC,eAAe,CAAC,CAAA;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAA;AACpF,CAAC"}

package/lib/project-sessions.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Per-project session index (sidecar). Session records live in harness
+ * persistence and carry only a raw `cwd`; this sidecar pins the sessions a
+ * project OWNS without depending on the host for new header fields. One
+ * file per project bucket: `$DSH_HOME/tui/projects/<key>/sessions.txt`,
+ * one session id per line.
+ *
+ * Membership in the /resume picker is `id ∈ index ∨ cwd-prefix heuristic`
+ * (see session-list): the index is exact for sessions written after it
+ * existed, the heuristic covers legacy sessions and worktree cwds. fs
+ * access is best-effort throughout — a missing or unwritable file degrades
+ * to an empty index and never breaks a session.
+ *
+ * @module @dsh-cc/tui/project-sessions
+ */
+/** Absolute path of the index file inside a project bucket directory. */
+export declare function projectSessionsFile(bucketDir: string): string;
+/**
+ * Read the indexed session ids. Missing or unreadable file → empty set;
+ * blank lines are ignored.
+ */
+export declare function readProjectSessionIds(bucketDir: string): Set<string>;
+/**
+ * Append a session id to the index unless already present. Best-effort: fs
+ * failures are swallowed (the cwd-prefix heuristic still covers the
+ * session in the common case).
+ */
+export declare function recordProjectSessionId(bucketDir: string, sessionId: string): void;
+//# sourceMappingURL=project-sessions.d.ts.map

package/lib/project-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-sessions.d.ts","sourceRoot":"","sources":["../src/project-sessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAYpE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAUjF"}

package/lib/project-sessions.js

@@ -0,0 +1,60 @@
+/**
+ * Per-project session index (sidecar). Session records live in harness
+ * persistence and carry only a raw `cwd`; this sidecar pins the sessions a
+ * project OWNS without depending on the host for new header fields. One
+ * file per project bucket: `$DSH_HOME/tui/projects/<key>/sessions.txt`,
+ * one session id per line.
+ *
+ * Membership in the /resume picker is `id ∈ index ∨ cwd-prefix heuristic`
+ * (see session-list): the index is exact for sessions written after it
+ * existed, the heuristic covers legacy sessions and worktree cwds. fs
+ * access is best-effort throughout — a missing or unwritable file degrades
+ * to an empty index and never breaks a session.
+ *
+ * @module @dsh-cc/tui/project-sessions
+ */
+import { appendFileSync, mkdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Absolute path of the index file inside a project bucket directory. */
+export function projectSessionsFile(bucketDir) {
+    return join(bucketDir, 'sessions.txt');
+}
+/**
+ * Read the indexed session ids. Missing or unreadable file → empty set;
+ * blank lines are ignored.
+ */
+export function readProjectSessionIds(bucketDir) {
+    try {
+        const content = readFileSync(projectSessionsFile(bucketDir), 'utf8');
+        const ids = new Set();
+        for (const line of content.split('\n')) {
+            const id = line.trim();
+            if (id.length > 0)
+                ids.add(id);
+        }
+        return ids;
+    }
+    catch {
+        return new Set();
+    }
+}
+/**
+ * Append a session id to the index unless already present. Best-effort: fs
+ * failures are swallowed (the cwd-prefix heuristic still covers the
+ * session in the common case).
+ */
+export function recordProjectSessionId(bucketDir, sessionId) {
+    const id = sessionId.trim();
+    if (id.length === 0)
+        return;
+    try {
+        if (readProjectSessionIds(bucketDir).has(id))
+            return;
+        mkdirSync(bucketDir, { recursive: true });
+        appendFileSync(projectSessionsFile(bucketDir), `${id}\n`);
+    }
+    catch {
+        // Best-effort — the index is a picker nicety, never session-critical.
+    }
+}
+//# sourceMappingURL=project-sessions.js.map

package/lib/project-sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-sessions.js","sourceRoot":"","sources":["../src/project-sessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,OAAO,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAA;QACpE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAA;QAC7B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;YACtB,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;gBAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAChC,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,GAAG,EAAE,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,SAAiB;IACzE,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAC3B,IAAI,CAAC;QACH,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAM;QACpD,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACzC,cAAc,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;IACxE,CAAC;AACH,CAAC"}

package/lib/project.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Project (working-directory identity) resolution for session management.
+ *
+ * A "project" is the namespace sessions, resume markers, and input history
+ * share. For a cwd inside a git repository the project is pinned to the
+ * *main repo root*, so an isolation worktree (`--worktree`,
+ * `.claude/worktrees/<slug>`) keeps the same project as its main checkout;
+ * for a cwd outside git the project is the directory itself. Every member
+ * path is `resolve()`d to a canonical absolute form and keyed by a short
+ * sha256 of the project root (deliberately not a lossy string encoding like
+ * Claude Code's `-` separator scheme — see design).
+ *
+ * All git probing runs through an injectable synchronous exec so tests never
+ * spawn git; any failure or timeout degrades to the directory identity.
+ *
+ * @module @dsh-cc/tui/project
+ */
+/**
+ * Git invocation timeout. A hung git (network FS, broken env) must not block
+ * session boot; expiry degrades to the directory identity. Generous for
+ * slow repos while still bounding the worst case.
+ */
+export declare const GIT_PROBE_TIMEOUT_MS = 2000;
+/** A successful synchronous git invocation. */
+export interface ProjectExecResult {
+    stdout: string;
+}
+/**
+ * Run one git argv in `cwd`, synchronously. Returns undefined on spawn
+ * failure, non-zero exit, or timeout — the caller treats that as "not a git
+ * repository". Injectable so tests script the git conversation.
+ */
+export type ProjectExec = (argv: readonly string[], cwd: string) => ProjectExecResult | undefined;
+/** The default exec: real `git` via spawnSync with a bounded timeout. */
+export declare const gitExecSync: ProjectExec;
+/** Resolved project identity for a cwd. */
+export interface ProjectInfo {
+    /**
+     * Canonical project root: the main git repo root for a cwd inside a git
+     * repository (link worktrees collapse onto their main checkout), else
+     * `resolve(cwd)`.
+     */
+    readonly projectRoot: string;
+    /** `sha256(projectRoot)` first 16 hex chars — the per-project bucket key. */
+    readonly projectKey: string;
+    /**
+     * Every linked worktree of the project's repository, `resolve()`d to an
+     * absolute path. `[]` when the repo cannot be enumerated (or is not git).
+     */
+    readonly worktrees: string[];
+}
+/**
+ * Resolve the project identity for `cwd`. Git is probed via the injectable
+ * exec (defaults to real `git`); any failure or timeout degrades to a
+ * directory identity (`projectRoot = resolve(cwd)`, no worktrees).
+ *
+ * Results are memoised per resolved `cwd` so every process probes git at
+ * most once per working directory (driver clients call this in hot spots —
+ * boot, picker open, history rebind — and reuse the same identity). Only
+ * default-exec calls participate: an injected `exec` bypasses the cache
+ * entirely, so scripted-exec tests and external probing stay deterministic.
+ * {@link __clearProjectCache} resets the memo (used by tests).
+ */
+export declare function resolveProject(cwd: string, exec?: ProjectExec): ProjectInfo;
+/** Test hook: drop the module-level memo (also safe as a no-op cleanup). */
+export declare function __clearProjectCache(): void;
+/**
+ * Whether `entryCwd` belongs to the project: it equals the project root or
+ * any worktree path, or sits beneath one at a path-separator boundary
+ * (`/repo` matches `/repo` and `/repo/x`, never `/repo2`). Both `/` and `\`
+ * count as boundary separators so Windows-style recorded cwds are handled
+ * regardless of the host separator.
+ */
+export declare function isProjectMember(entryCwd: string, project: Pick<ProjectInfo, 'projectRoot' | 'worktrees'>): boolean;
+//# sourceMappingURL=project.d.ts.map

package/lib/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,OAAO,CAAA;AAExC,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAA;AAEjG,yEAAyE;AACzE,eAAO,MAAM,WAAW,EAAE,WAQzB,CAAA;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAC7B;AAwCD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAyB,GAAG,WAAW,CASxF;AAKD,4EAA4E;AAC5E,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAwDD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,WAAW,CAAC,GACtD,OAAO,CAOT"}