@dsh-cc/tui 0.5.0

package/lib/provider-read.js

@@ -0,0 +1,115 @@
+/** Settings namespace carrying the provider profiles (doc D1/D2). */
+export const PROVIDER_SETTINGS_NAMESPACE = 'llm-pi-ai';
+/** Usage line for unknown/unsupported subcommands (§4.1 — never silent). */
+export const PROVIDER_USAGE = 'Usage: /provider [list | add <preset-id> | remove <route>]';
+/**
+ * Read the `llm-pi-ai` section's user-layer `providers` dict (§4.2). The
+ * service may be absent, the namespace unregistered, or the stored shape
+ * junk — every degradation returns `{}` so the overlay renders honestly.
+ */
+export function readConfiguredProviders(settings) {
+    if (settings === undefined || typeof settings.describe !== 'function')
+        return {};
+    let descriptors;
+    try {
+        descriptors = settings.describe() ?? [];
+    }
+    catch {
+        return {};
+    }
+    const descriptor = descriptors.find((entry) => entry !== null && typeof entry === 'object' && String(entry.ns) === PROVIDER_SETTINGS_NAMESPACE);
+    const user = descriptor?.user;
+    const providers = user !== null && typeof user === 'object' ? user.providers : undefined;
+    if (providers === null || typeof providers !== 'object' || Array.isArray(providers))
+        return {};
+    const out = {};
+    for (const [route, profile] of Object.entries(providers)) {
+        // Coerce junk entries away: only object profiles are provider shapes.
+        if (profile !== null && typeof profile === 'object')
+            out[route] = profile;
+    }
+    return out;
+}
+/**
+ * Credential-state snapshots for each ref (§4.2 badges). Tolerant of an
+ * absent service and a throwing `describe` — a failed describe is an unknown
+ * state, rendered as unconfigured, never an overlay crash.
+ */
+export async function credentialStates(credentials, refs) {
+    const out = {};
+    if (credentials === undefined)
+        return out;
+    for (const ref of refs) {
+        try {
+            if (typeof credentials.describe !== 'function')
+                return out;
+            const state = await credentials.describe(ref);
+            if (state !== undefined && state !== null && typeof state === 'object')
+                out[ref] = state;
+        }
+        catch {
+            // Unknown state: omit — badgeFor renders missing.
+        }
+    }
+    return out;
+}
+/**
+ * Configurable-provider directory (C8). Absent service or junk entries
+ * degrade to `[]`; throwing discovery degrades to `[]` too.
+ */
+export function loadDirectory(llm) {
+    try {
+        const entries = llm?.listConfigurableProviders?.();
+        if (!Array.isArray(entries))
+            return [];
+        return entries.filter((entry) => entry !== null && typeof entry === 'object' && typeof entry.provider === 'string');
+    }
+    catch {
+        return [];
+    }
+}
+/** Subcommand table per §4.1: bare, list, add/remove with a required id. */
+export function parseProviderArgs(rest) {
+    const trimmed = rest.trim();
+    if (trimmed === '')
+        return { kind: 'open' };
+    if (trimmed === 'list')
+        return { kind: 'list' };
+    for (const kind of ['add', 'remove']) {
+        if (trimmed === kind || trimmed.startsWith(`${kind} `)) {
+            const route = trimmed.slice(kind.length).trim();
+            if (route === '')
+                return { kind: 'invalid' };
+            return { kind, route };
+        }
+    }
+    return { kind: 'invalid' };
+}
+/** Badge text for one row (`✓ (managed)` / `✓ (env)` / `✗ missing`). */
+function credentialBadgeText(row) {
+    const credential = row.credential;
+    if (credential === undefined || credential.badge === 'missing')
+        return 'key ✗ missing';
+    return `key ✓ (${credential.badge})`;
+}
+/**
+ * §4.1 `/provider list` — plain-text rendering of the same two-section data
+ * the overlay shows (script-friendly chat output).
+ */
+export function renderProviderList(list) {
+    const lines = ['Providers', '  Configured'];
+    for (const row of list.configured) {
+        const marker = row.isCurrent ? '●' : '○';
+        const models = row.modelCount > 0 ? `   ${row.modelCount} models` : '';
+        lines.push(`  ${marker} ${row.route}   ${row.displayName}   ${credentialBadgeText(row)}${models}${row.credential?.warning === true ? '  ⚠' : ''}`);
+    }
+    lines.push('  Available');
+    for (const row of list.available) {
+        lines.push(`  ○ ${row.route}   ${row.displayName}`);
+    }
+    if (list.more.length > 0) {
+        lines.push(`  … More providers (${list.more.map(m => m.provider).join(', ')})`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=provider-read.js.map

package/lib/provider-read.js.map

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

package/lib/provider-settings.d.ts

@@ -0,0 +1,30 @@
+import { type SettingsDescribeLike } from './provider-read.ts';
+import type { ProviderCore } from './provider-command.ts';
+/** One path-op for the settings cascade facade (doc D8a: `{op:'set'|'unset', path}`). */
+export type ProviderSettingsOp = {
+    op: 'set' | 'unset';
+    path: readonly string[];
+    value?: unknown;
+};
+/**
+ * Duck-typed write-capable settings seam (doc D1/D8): `describe` supplies the
+ * revision guard, `mutate` writes path ops, `replace` writes a whole
+ * namespace (the agent-default-model seed, D8c).
+ */
+export type SettingsWriteLike = SettingsDescribeLike & {
+    mutate?(ns: string, ops: readonly ProviderSettingsOp[], revision?: unknown): Promise<unknown>;
+    replace?(ns: string, value: unknown, revision?: unknown): Promise<unknown>;
+};
+export declare const settingsWriteOf: (core: ProviderCore) => SettingsWriteLike | undefined;
+/**
+ * Revision-guarded path-op write with one conflict retry (D1/D8a, the
+ * writeAllowRule precedent). Returns the verbatim error message on failure
+ * (§7: rendered as-is, previous routes keep serving).
+ */
+export declare const writeRoute: (core: ProviderCore, op: ProviderSettingsOp) => Promise<string | undefined>;
+/**
+ * D8(c) agent-default-model seed: opportunistic — all failures degrade to a
+ * note and the running session is never touched.
+ */
+export declare const setAsDefault: (core: ProviderCore, route: string) => Promise<void>;
+//# sourceMappingURL=provider-settings.d.ts.map

package/lib/provider-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-settings.d.ts","sourceRoot":"","sources":["../src/provider-settings.ts"],"names":[],"mappings":"AAQA,OAAO,EAA+B,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAG3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEzD,yFAAyF;AACzF,MAAM,MAAM,kBAAkB,GAAG;IAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAElG;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,GAAG;IACrD,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,kBAAkB,EAAE,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7F,OAAO,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC3E,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,MAAM,YAAY,KAAG,iBAAiB,GAAG,SACX,CAAA;AAU9D;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAU,MAAM,YAAY,EAAE,IAAI,kBAAkB,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAevG,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAU,MAAM,YAAY,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAclF,CAAA"}

package/lib/provider-settings.js

@@ -0,0 +1,65 @@
+/**
+ * `/provider` settings-write seam (design doc docs/plans/2026-09-05-provider-
+ * management.md doc D1/D8a/D8c): the duck-typed write-capable settings seam,
+ * the revision-guarded path-op write, and the agent-default-model seed.
+ * Split out of provider-command.ts purely for line budget.
+ * @module @dsh-cc/tui/provider-command-settings
+ */
+import { isSettingsConflict } from "./harness/approval-preview.js";
+import { PROVIDER_SETTINGS_NAMESPACE } from "./provider-read.js";
+import { setMessage } from "./store/provider-panel.js";
+export const settingsWriteOf = (core) => core.rt.ctx.get('settings');
+const revisionOf = (settings, ns = PROVIDER_SETTINGS_NAMESPACE) => {
+    try {
+        return settings?.describe?.().find(entry => String(entry.ns) === ns)?.revision;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Revision-guarded path-op write with one conflict retry (D1/D8a, the
+ * writeAllowRule precedent). Returns the verbatim error message on failure
+ * (§7: rendered as-is, previous routes keep serving).
+ */
+export const writeRoute = async (core, op) => {
+    const settings = settingsWriteOf(core);
+    if (settings === undefined || typeof settings.mutate !== 'function') {
+        return 'No writable settings provider is mounted.';
+    }
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        try {
+            await settings.mutate(PROVIDER_SETTINGS_NAMESPACE, [op], revisionOf(settings));
+            return undefined;
+        }
+        catch (error) {
+            if (attempt === 0 && isSettingsConflict(error))
+                continue;
+            return error instanceof Error ? error.message : String(error);
+        }
+    }
+    return undefined;
+};
+/**
+ * D8(c) agent-default-model seed: opportunistic — all failures degrade to a
+ * note and the running session is never touched.
+ */
+export const setAsDefault = async (core, route) => {
+    const llm = core.rt.ctx.get('llm');
+    const settings = settingsWriteOf(core);
+    try {
+        const models = await llm?.listModels(route);
+        const model = Array.isArray(models) ? models[0]?.id : undefined;
+        if (model === undefined || model === '')
+            throw new Error('no models are registered for the route yet');
+        if (settings === undefined || typeof settings.replace !== 'function')
+            throw new Error('no writable settings provider is mounted');
+        await settings.replace('agent-default-model', { provider: route, model }, revisionOf(settings, 'agent-default-model'));
+        core.patch(p => setMessage(p, `Default model set to ${route}/${model} for new sessions — /model switches the running one.`));
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        core.patch(p => setMessage(p, `Could not set the default model: ${reason} — this step is optional; /model can pick any registered route.`));
+    }
+};
+//# sourceMappingURL=provider-settings.js.map

package/lib/provider-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-settings.js","sourceRoot":"","sources":["../src/provider-settings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,EAAE,2BAA2B,EAA6B,MAAM,oBAAoB,CAAA;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAiBtD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAkB,EAAiC,EAAE,CACnF,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAkC,CAAA;AAE9D,MAAM,UAAU,GAAG,CAAC,QAAuC,EAAE,KAAa,2BAA2B,EAAW,EAAE;IAChH,IAAI,CAAC;QACH,OAAO,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAA;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,IAAkB,EAAE,EAAsB,EAA+B,EAAE;IAC1G,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;IACtC,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACpE,OAAO,2CAA2C,CAAA;IACpD,CAAC;IACD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,MAAM,CAAC,2BAA2B,EAAE,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;YAC9E,OAAO,SAAS,CAAA;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,KAAK,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC;gBAAE,SAAQ;YACxD,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC/D,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,IAAkB,EAAE,KAAa,EAAiB,EAAE;IACrF,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAA8B,CAAA;IAC/D,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,CAAA;QAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;QAC/D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;QACtG,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;QACjI,MAAM,QAAQ,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,UAAU,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAA;QACtH,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,wBAAwB,KAAK,IAAI,KAAK,sDAAsD,CAAC,CAAC,CAAA;IAC9H,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACrE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,oCAAoC,MAAM,iEAAiE,CAAC,CAAC,CAAA;IAC7I,CAAC;AACH,CAAC,CAAA"}

package/lib/resume-target.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Cross-process resume marker. The TUI writes the live session id AND reads
+ * it back itself on boot (project-keyed auto-resume); the `dsh-cc` launcher
+ * no longer reads markers — it only translates CLI flags into env for the
+ * TUI. Session records themselves stay in harness persistence.
+ *
+ * Markers are keyed by the session's *project* (the main git root; worktrees
+ * collapse onto it), so a worktree and its main checkout share the "last
+ * session" anchor. The new marker lives at
+ * `$DSH_HOME/tui/projects/<projectKey>/resume.txt` (the same bucket as
+ * per-project history and the session sidecar index).
+ *
+ * A legacy marker (`resume-<sha256(resolve(cwd))[:16]>.txt`, cwd-bucketed)
+ * is dual-read on boot and dual-written/cleared alongside the new one, so
+ * pre-P3 launchers that read it keep working during the transition. The
+ * legacy dual-write is removed in 0.4.0.
+ *
+ * @module @dsh-cc/tui/resume-target
+ */
+export interface ResumeTargetOptions {
+    /** Data directory. Defaults to `$DSH_HOME/tui` or `~/.dsh/tui`. */
+    home?: string;
+    /** Session cwd whose PROJECT keys the new marker. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** cwd bucket for the legacy marker. Defaults to `cwd`. */
+    legacyCwd?: string;
+}
+/**
+ * On-disk path of the NEW project-keyed resume marker for `cwd`. Exported so
+ * tests can lock the scheme. (Multiple clients call this per boot, so the
+ * underlying `resolveProject` is memoised in project.ts — no per-call git.)
+ */
+export declare function resumeMarkerFile(options?: ResumeTargetOptions): string;
+/**
+ * On-disk path of the legacy cwd-bucketed marker (`resume-<hash>.txt`),
+ * used during the pre-P3 transition. Keyed by `legacyCwd ?? cwd`.
+ */
+export declare function legacyResumeMarkerFile(options?: ResumeTargetOptions): string;
+/**
+ * Persist the session id the next boot should attach. Idempotent on the NEW
+ * marker: if it already holds exactly `sessionId` this is a no-op (the
+ * legacy marker is not consulted). Otherwise the new (project-keyed) marker
+ * is written, plus a legacy dual-write for pre-P3 launchers.
+ */
+export declare function writeResumeTarget(sessionId: string, options?: ResumeTargetOptions): void;
+/**
+ * Forget the marker(s) — a fresh session. Blanks both the new and the legacy
+ * marker (best-effort); the legacy side is keyed by `legacyCwd ?? cwd`.
+ */
+export declare function clearResumeTarget(options?: ResumeTargetOptions): void;
+/**
+ * The stored session id, or undefined when absent/blank.
+ *
+ * Dual-read, order pinned: blank/absent files are discarded first, then the
+ * survivors are compared by `statSync().mtimeMs` — newer wins, ties go to the
+ * new (project-keyed) marker.
+ */
+export declare function readResumeTarget(options?: ResumeTargetOptions): string | undefined;
+//# sourceMappingURL=resume-target.d.ts.map

package/lib/resume-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-target.d.ts","sourceRoot":"","sources":["../src/resume-target.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAYD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAI1E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAGhF;AAWD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI,CAiB5F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,mBAAwB,GAAG,IAAI,CAQzE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,GAAG,SAAS,CA0BtF"}

package/lib/resume-target.js

@@ -0,0 +1,143 @@
+/**
+ * Cross-process resume marker. The TUI writes the live session id AND reads
+ * it back itself on boot (project-keyed auto-resume); the `dsh-cc` launcher
+ * no longer reads markers — it only translates CLI flags into env for the
+ * TUI. Session records themselves stay in harness persistence.
+ *
+ * Markers are keyed by the session's *project* (the main git root; worktrees
+ * collapse onto it), so a worktree and its main checkout share the "last
+ * session" anchor. The new marker lives at
+ * `$DSH_HOME/tui/projects/<projectKey>/resume.txt` (the same bucket as
+ * per-project history and the session sidecar index).
+ *
+ * A legacy marker (`resume-<sha256(resolve(cwd))[:16]>.txt`, cwd-bucketed)
+ * is dual-read on boot and dual-written/cleared alongside the new one, so
+ * pre-P3 launchers that read it keep working during the transition. The
+ * legacy dual-write is removed in 0.4.0.
+ *
+ * @module @dsh-cc/tui/resume-target
+ */
+import { createHash } from 'node:crypto';
+import { mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { resolveProject } from "./project.js";
+function dataDir(options = {}) {
+    if (options.home !== undefined)
+        return options.home;
+    const dshHome = process.env.DSH_HOME ?? join(homedir(), '.dsh');
+    return join(dshHome, 'tui');
+}
+function legacyKey(cwd) {
+    return createHash('sha256').update(resolve(cwd)).digest('hex').slice(0, 16);
+}
+/**
+ * On-disk path of the NEW project-keyed resume marker for `cwd`. Exported so
+ * tests can lock the scheme. (Multiple clients call this per boot, so the
+ * underlying `resolveProject` is memoised in project.ts — no per-call git.)
+ */
+export function resumeMarkerFile(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const key = resolveProject(cwd).projectKey;
+    return join(dataDir(options), 'projects', key, 'resume.txt');
+}
+/**
+ * On-disk path of the legacy cwd-bucketed marker (`resume-<hash>.txt`),
+ * used during the pre-P3 transition. Keyed by `legacyCwd ?? cwd`.
+ */
+export function legacyResumeMarkerFile(options = {}) {
+    const cwd = options.legacyCwd ?? options.cwd ?? process.cwd();
+    return join(dataDir(options), `resume-${legacyKey(cwd)}.txt`);
+}
+/** The trimmed contents of a file, or '' when absent. */
+function quietRead(file) {
+    try {
+        return readFileSync(file, 'utf8').trim();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Persist the session id the next boot should attach. Idempotent on the NEW
+ * marker: if it already holds exactly `sessionId` this is a no-op (the
+ * legacy marker is not consulted). Otherwise the new (project-keyed) marker
+ * is written, plus a legacy dual-write for pre-P3 launchers.
+ */
+export function writeResumeTarget(sessionId, options = {}) {
+    const id = sessionId.trim();
+    if (id.length === 0)
+        return;
+    const newFile = resumeMarkerFile(options);
+    if (quietRead(newFile) === id)
+        return; // F4: dedupe against the NEW marker only.
+    mkdirSync(dirname(newFile), { recursive: true });
+    writeFileSync(newFile, `${id}\n`);
+    // TODO(0.4.0): remove legacy dual-write (transition compat for pre-P3 launchers)
+    const legacyFile = legacyResumeMarkerFile(options);
+    try {
+        mkdirSync(dirname(legacyFile), { recursive: true });
+        writeFileSync(legacyFile, `${id}\n`);
+    }
+    catch {
+        // Best effort — a pre-P3 launcher just misses the anchor in this process.
+    }
+}
+/**
+ * Forget the marker(s) — a fresh session. Blanks both the new and the legacy
+ * marker (best-effort); the legacy side is keyed by `legacyCwd ?? cwd`.
+ */
+export function clearResumeTarget(options = {}) {
+    for (const file of [resumeMarkerFile(options), legacyResumeMarkerFile(options)]) {
+        try {
+            writeFileSync(file, '');
+        }
+        catch {
+            // Best effort — the marker is a launcher nicety.
+        }
+    }
+}
+/**
+ * The stored session id, or undefined when absent/blank.
+ *
+ * Dual-read, order pinned: blank/absent files are discarded first, then the
+ * survivors are compared by `statSync().mtimeMs` — newer wins, ties go to the
+ * new (project-keyed) marker.
+ */
+export function readResumeTarget(options = {}) {
+    const candidates = [
+        { path: resumeMarkerFile(options), content: '', isNew: true },
+        { path: legacyResumeMarkerFile(options), content: '', isNew: false },
+    ];
+    let survivors = 0;
+    let winner;
+    for (const candidate of candidates) {
+        const content = quietRead(candidate.path);
+        if (content.length === 0)
+            continue;
+        candidate.content = content;
+        survivors += 1;
+        winner = candidate;
+    }
+    if (survivors === 0)
+        return undefined;
+    if (survivors === 1)
+        return winner?.content;
+    // Two survivors: compare their mtimes; ties favour the new marker.
+    const older = candidates.find(c => !c.isNew) ?? candidates[0];
+    const newer = candidates.find(c => c.isNew) ?? candidates[1];
+    let mtimeOlder = -Infinity;
+    let mtimeNewer = -Infinity;
+    try {
+        mtimeOlder = statSync(older.path).mtimeMs;
+    }
+    catch { /* treat as oldest */ }
+    try {
+        mtimeNewer = statSync(newer.path).mtimeMs;
+    }
+    catch { /* treat as oldest */ }
+    if (mtimeOlder === mtimeNewer)
+        return newer.content;
+    return mtimeOlder > mtimeNewer ? older.content : newer.content;
+}
+//# sourceMappingURL=resume-target.js.map

package/lib/resume-target.js.map

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

package/lib/slash.d.ts

@@ -0,0 +1,44 @@
+/**
+ * TUI-local slash parsing. Harness commands still dispatch through
+ * `ctx.commands`; these names are owned by the terminal surface.
+ * @module @dsh-cc/tui/slash
+ */
+/** Slash names the TUI handles without calling `ctx.commands`. */
+export declare const LOCAL_SLASH: readonly ["quit", "exit", "clear", "new", "reset", "tui-help", "resume", "model", "effort", "agents", "cost", "usage", "export-md", "copy", "provider"];
+/** `/provider` subcommands (§4.1) — surfaced as the argument completer hints. */
+export declare const PROVIDER_SUBCOMMANDS: readonly ["list", "add", "remove"];
+export type LocalSlashName = (typeof LOCAL_SLASH)[number];
+export interface LocalCommand {
+    readonly name: string;
+    readonly description: string;
+    readonly argumentHint?: string;
+}
+/**
+ * Catalog of TUI-owned slash commands, surfaced via {@link Driver.listCommands}
+ * and the composer autocomplete. Descriptions mirror runLocal's behavior so
+ * the suggestion list matches what each command actually does.
+ */
+export declare const LOCAL_COMMANDS: readonly LocalCommand[];
+export type ParsedSlash = {
+    kind: 'local';
+    name: string;
+    rawInput: string;
+} | {
+    kind: 'harness';
+    line: string;
+} | {
+    kind: 'none';
+};
+/** Publish the current plugin-command name table (lowercased for matching). */
+export declare function setPluginSlashNames(names: readonly string[]): void;
+/**
+ * Classify one composer line. Leading slash required; unknown names go to
+ * the harness catalog so preset commands (`/permissions`, `/status`, …) work.
+ * At submit, a harness-kind line the command registry does not match falls
+ * through to a user prompt — user-invocable skills load through that
+ * host-side gesture boundary, so a hand-typed `/skill-name` reaches the model
+ * the same way a menu pick would.
+ * @param line - the raw composer contents.
+ */
+export declare function parseSlash(line: string): ParsedSlash;
+//# sourceMappingURL=slash.d.ts.map

package/lib/slash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash.d.ts","sourceRoot":"","sources":["../src/slash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kEAAkE;AAClE,eAAO,MAAM,WAAW,yJAEd,CAAA;AAEV,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,oCAAqC,CAAA;AAEtE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AAEzD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAoBxC,CAAA;AAEV,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAapB,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAElE;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAkBpD"}

package/lib/slash.js

@@ -0,0 +1,81 @@
+/**
+ * TUI-local slash parsing. Harness commands still dispatch through
+ * `ctx.commands`; these names are owned by the terminal surface.
+ * @module @dsh-cc/tui/slash
+ */
+/** Slash names the TUI handles without calling `ctx.commands`. */
+export const LOCAL_SLASH = [
+    'quit', 'exit', 'clear', 'new', 'reset', 'tui-help', 'resume', 'model', 'effort', 'agents', 'cost', 'usage', 'export-md', 'copy', 'provider',
+];
+/** `/provider` subcommands (§4.1) — surfaced as the argument completer hints. */
+export const PROVIDER_SUBCOMMANDS = ['list', 'add', 'remove'];
+/**
+ * Catalog of TUI-owned slash commands, surfaced via {@link Driver.listCommands}
+ * and the composer autocomplete. Descriptions mirror runLocal's behavior so
+ * the suggestion list matches what each command actually does.
+ */
+export const LOCAL_COMMANDS = [
+    { name: 'quit', description: 'Exit the TUI session' },
+    { name: 'exit', description: 'Exit the TUI session' },
+    { name: 'clear', description: 'Start a new conversation (empty context). Previous session stays resumable.' },
+    { name: 'new', description: 'Alias of /clear' },
+    { name: 'reset', description: 'Alias of /clear' },
+    { name: 'tui-help', description: 'Show TUI keyboard and command help' },
+    { name: 'resume', description: 'Switch to a resumed session (picker or /resume <id>)', argumentHint: '<sessionId>' },
+    { name: 'model', description: 'List or switch the active model', argumentHint: '<n|provider/id>' },
+    { name: 'effort', description: 'Set reasoning effort for the current model', argumentHint: '<level|default>' },
+    { name: 'agents', description: 'List, inspect, or stop background agents', argumentHint: '[<id>|stop <id>]' },
+    { name: 'cost', description: 'Show token usage' },
+    { name: 'usage', description: 'Open the live token and context usage panel' },
+    {
+        name: 'export-md',
+        description: 'Export the transcript to a Markdown file',
+        argumentHint: '<path>',
+    },
+    { name: 'copy', description: 'Copy the latest assistant reply to the clipboard' },
+    { name: 'provider', description: 'Manage LLM provider routes and API keys', argumentHint: '[list | add <preset-id> | remove <route>]' },
+];
+/**
+ * Plugin-command names exposed by the cc-shell `ccPlugins` service in the
+ * colon form `plugin:command` (e.g. `codex:review`). The TUI treats them as
+ * local commands, so classification must see the live table — but slash.ts is
+ * a pure leaf with no service access, so the catalog section (which owns the
+ * service lookup) publishes the names here. Duck-typed optional consumption:
+ * an empty registry (no ccPlugins service, or none published yet) keeps the
+ * pre-plugin behavior untouched.
+ */
+let pluginSlashNames = new Set();
+/** Publish the current plugin-command name table (lowercased for matching). */
+export function setPluginSlashNames(names) {
+    pluginSlashNames = new Set(names.map(name => name.toLowerCase()));
+}
+/**
+ * Classify one composer line. Leading slash required; unknown names go to
+ * the harness catalog so preset commands (`/permissions`, `/status`, …) work.
+ * At submit, a harness-kind line the command registry does not match falls
+ * through to a user prompt — user-invocable skills load through that
+ * host-side gesture boundary, so a hand-typed `/skill-name` reaches the model
+ * the same way a menu pick would.
+ * @param line - the raw composer contents.
+ */
+export function parseSlash(line) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith('/'))
+        return { kind: 'none' };
+    const body = trimmed.slice(1);
+    const space = body.search(/\s/);
+    const name = (space === -1 ? body : body.slice(0, space)).toLowerCase();
+    const rawInput = space === -1 ? '' : body.slice(space).trim();
+    if (LOCAL_SLASH.includes(name)) {
+        return { kind: 'local', name, rawInput };
+    }
+    // Plugin commands (colon form, `plugin:command`) dispatch through the
+    // ccPlugins service in runLocal. A name NOT in the table keeps the harness
+    // fall-through — the skill-injection gesture boundary depends on it, so a
+    // colon name must never be hard-classified local on a miss.
+    if (pluginSlashNames.has(name)) {
+        return { kind: 'local', name, rawInput };
+    }
+    return { kind: 'harness', line: trimmed };
+}
+//# sourceMappingURL=slash.js.map

package/lib/slash.js.map

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