@dsh-cc/tui 0.5.0

package/lib/harness/statusline-command.js

@@ -0,0 +1,161 @@
+/**
+ * Status-line command runner: 300 ms-debounced execution of the configured
+ * command with the CC-shaped JSON payload on stdin. Kill-in-flight on every
+ * new trigger, generation-guarded settles (a superseded run's late result is
+ * discarded), update({ immediate: true }) bypass for settings-driven command
+ * changes, blank-on-failure (non-zero exit, killed, timeout, overrun, spawn
+ * throw, empty stdout), COLUMNS/LINES from the terminal-size getter at spawn
+ * time, a 60 s hard cap with a 64 KiB stdout cap, and a dispose that aborts,
+ * clears, and quiets.
+ * @module @dsh-cc/tui/harness/statusline-command
+ */
+/** Debounce delay per the CC contract (C5). */
+const DEFAULT_DEBOUNCE_MS = 300;
+/** dsh-cc's undocumented-by-CC guard against hung scripts. */
+const DEFAULT_TIMEOUT_MS = 60_000;
+/** dsh-cc's stdout hard cap. */
+const DEFAULT_STDOUT_MAX_BYTES = 64 * 1024;
+/** Max rows of the command's stdout kept (multi-row CC status line, capped). */
+const MAX_STATUSLINE_ROWS = 3;
+/**
+ * Create the status-line command runner. Pure with respect to the injected
+ * executor; owns exactly one debounce timer and one hard-cap timer at a time.
+ */
+export function createStatusLineCommand(deps) {
+    const debounceMs = deps.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+    const timeoutMs = deps.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const stdoutMaxBytes = deps.stdoutMaxBytes ?? DEFAULT_STDOUT_MAX_BYTES;
+    let disposed = false;
+    let generation = 0;
+    let latestLine = '';
+    let debounceTimer;
+    let inFlight;
+    /** Abort the in-flight child and forget it (trigger-time kill, C5). */
+    function killInFlight() {
+        if (inFlight === undefined)
+            return;
+        clearTimeout(inFlight.capTimer);
+        inFlight.controller.abort();
+        inFlight = undefined;
+    }
+    /** Record a blank for the current generation and notify. */
+    function blank() {
+        latestLine = '';
+        deps.onSettled('');
+    }
+    /** Whether a settled generation may still write state and notify. */
+    function isCurrent(gen) {
+        return !disposed && gen === generation;
+    }
+    function spawn(command, payload, workdir, gen) {
+        if (disposed || gen !== generation)
+            return;
+        const controller = new AbortController();
+        const { columns, rows } = deps.terminalSize();
+        const env = {};
+        for (const [key, value] of Object.entries(process.env)) {
+            if (typeof value === 'string')
+                env[key] = value;
+        }
+        env.COLUMNS = String(columns);
+        env.LINES = String(rows);
+        const request = {
+            command,
+            stdin: `${JSON.stringify(payload)}\n`,
+            signal: controller.signal,
+            env,
+            timeoutMs,
+            stdoutMaxBytes,
+            ...(workdir === undefined ? {} : { workdir }),
+        };
+        let spec;
+        try {
+            spec = deps.executor.resolve(request);
+        }
+        catch {
+            killInFlight();
+            if (isCurrent(gen))
+                blank();
+            return;
+        }
+        const capTimer = setTimeout(() => {
+            // Hung run: cut it and blank immediately — the executor's own settle
+            // (if it ever arrives) is discarded by the generation guard.
+            controller.abort();
+            if (inFlight?.controller === controller) {
+                inFlight = undefined;
+                if (isCurrent(gen))
+                    blank();
+            }
+        }, timeoutMs);
+        inFlight = { controller, capTimer };
+        deps.executor.run(spec).then((result) => {
+            if (inFlight?.controller === controller) {
+                clearTimeout(inFlight.capTimer);
+                inFlight = undefined;
+            }
+            if (!isCurrent(gen))
+                return;
+            const success = result.exitCode === 0 && !result.timedOut && result.stdout.text.length > 0;
+            if (success) {
+                const rows = result.stdout.text.split('\n').map((row) => row.trimEnd());
+                while (rows.length > 0 && rows[rows.length - 1] === '')
+                    rows.pop();
+                if (rows.length > 0 && rows.some((row) => row !== '')) {
+                    latestLine = rows.slice(0, MAX_STATUSLINE_ROWS).join('\n');
+                }
+                else {
+                    blank();
+                    return;
+                }
+            }
+            else {
+                latestLine = '';
+            }
+            if (latestLine.length === 0) {
+                blank();
+                return;
+            }
+            deps.onSettled(latestLine);
+        }, () => {
+            if (inFlight?.controller === controller) {
+                clearTimeout(inFlight.capTimer);
+                inFlight = undefined;
+            }
+            if (isCurrent(gen))
+                blank();
+        });
+    }
+    return {
+        update(config, payload, options) {
+            if (disposed)
+                return;
+            generation += 1;
+            const gen = generation;
+            // A new trigger cancels the in-flight child first (C5), then a
+            // replacement is scheduled — debounced, or immediate for command swaps.
+            killInFlight();
+            clearTimeout(debounceTimer);
+            if (options?.immediate === true) {
+                spawn(config.command, payload, options?.workdir, gen);
+                return;
+            }
+            debounceTimer = setTimeout(() => {
+                spawn(config.command, payload, options?.workdir, gen);
+            }, debounceMs);
+        },
+        latest() {
+            return latestLine;
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            generation += 1;
+            clearTimeout(debounceTimer);
+            killInFlight();
+            latestLine = '';
+        },
+    };
+}
+//# sourceMappingURL=statusline-command.js.map

package/lib/harness/statusline-command.js.map

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

package/lib/harness/statusline-payload.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Pure payload builder for the custom status line: assembles the CC-shaped
+ * JSON session object (§3.4 of the statusline plan) from a structural view of
+ * live driver state. Only truthfully-sourced fields are emitted — absent
+ * sources drop their field, and a sub-object with no known member is dropped
+ * wholesale. `context_window.current_usage` carries the last API step's token
+ * buckets (the projection's `tokenUsage.last.buckets`) mapped onto the CC
+ * field names; one accepted staleness: those buckets may carry partial usage
+ * from a cancelled/failed step. The percentage and exceeds_200k decisions use
+ * the currentUsage-derived context length (input + cache write + cache read)
+ * when present, falling back to the projected pressure sample — and are
+ * omitted when neither source exists. Pure and total: no I/O, no clock, no
+ * driver imports.
+ * @module @dsh-cc/tui/harness/statusline-payload
+ */
+/** Structural view of the driver state the payload is built from. */
+export type StatusLinePayloadView = {
+    /**
+     * Bundle version of dsh-cc (not a CC version). Optional as a pinned v1
+     * omission: the TUI has no truthful runtime source for a bundle version, so
+     * the wiring layer never supplies it (recorded as a manifest deviation).
+     */
+    version?: string;
+    /** Driver cwd at payload-fire time; the workspace/cwd fallback. */
+    driverCwd?: string;
+    /** Session cwd (session.header.cwd). */
+    sessionCwd?: string;
+    /** Driver project root. */
+    projectDir?: string;
+    /** Session id. */
+    sessionId?: string;
+    /** Transcript file path; absent when unlocatable. */
+    transcriptPath?: string;
+    /** Selected model id (duplicated as display_name — no registry exists). */
+    model?: string;
+    /** Selected reasoning effort. */
+    effort?: string;
+    /** Active output style name, when readable. */
+    outputStyleName?: string;
+    /** Worktree descriptor carried by the session, when present. */
+    worktree?: {
+        name?: string;
+        path?: string;
+        branch?: string;
+    };
+    /** Git worktree name (mirrors the worktree descriptor's name). */
+    gitWorktree?: string;
+    /** Uncached input-token total (context-window total). */
+    inputTokens?: number;
+    /** Output-token total (context-window total). */
+    outputTokens?: number;
+    /**
+     * Most recent API step's token buckets (CC `current_usage` semantics);
+     * absent when the projection exposes no last step.
+     */
+    currentUsage?: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens?: number;
+        cacheWriteTokens?: number;
+    };
+    /** Context window size in tokens. */
+    contextWindowTokens?: number;
+    /** Projected context occupancy in tokens. */
+    pressureTokens?: number;
+    /** Session creation timestamp (ms epoch); falls back to {@link bindTimeMs}. */
+    sessionCreatedAtMs?: number;
+    /** Bind time of the runner (ms epoch) — the duration fallback clock base. */
+    bindTimeMs: number;
+    /** Now (ms epoch) at payload-fire time. */
+    nowMs: number;
+};
+/**
+ * Build the CC-shaped status-line payload from the view. Absent sources drop
+ * their field; empty sub-objects are dropped wholesale; unknown extra keys are
+ * never fabricated. Serialized structurally — the payload type stays open.
+ */
+export declare function buildStatusLinePayload(view: StatusLinePayloadView): Record<string, unknown>;
+//# sourceMappingURL=statusline-payload.d.ts.map

package/lib/harness/statusline-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusline-payload.d.ts","sourceRoot":"","sources":["../../src/harness/statusline-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,qEAAqE;AACrE,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gEAAgE;IAChE,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5D,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE;QACb,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,CAAA;QACpB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAC1B,CAAA;IACD,qCAAqC;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAA;IAClB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AA8BD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6C3F"}

package/lib/harness/statusline-payload.js

@@ -0,0 +1,93 @@
+/**
+ * Pure payload builder for the custom status line: assembles the CC-shaped
+ * JSON session object (§3.4 of the statusline plan) from a structural view of
+ * live driver state. Only truthfully-sourced fields are emitted — absent
+ * sources drop their field, and a sub-object with no known member is dropped
+ * wholesale. `context_window.current_usage` carries the last API step's token
+ * buckets (the projection's `tokenUsage.last.buckets`) mapped onto the CC
+ * field names; one accepted staleness: those buckets may carry partial usage
+ * from a cancelled/failed step. The percentage and exceeds_200k decisions use
+ * the currentUsage-derived context length (input + cache write + cache read)
+ * when present, falling back to the projected pressure sample — and are
+ * omitted when neither source exists. Pure and total: no I/O, no clock, no
+ * driver imports.
+ * @module @dsh-cc/tui/harness/statusline-payload
+ */
+/** Whether a value is a finite number. */
+function isFiniteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+/** Drop keys whose value is `undefined`, then drop the object when empty. */
+function compact(object) {
+    const out = {};
+    for (const [key, value] of Object.entries(object)) {
+        if (value !== undefined)
+            out[key] = value;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+/**
+ * The occupancy decision input: the currentUsage-derived context length
+ * (input + cache write + cache read) when a currentUsage exists, else the
+ * projected pressure sample. Undefined when neither source exists.
+ */
+function contextLengthOf(view) {
+    if (view.currentUsage !== undefined) {
+        return view.currentUsage.inputTokens
+            + (view.currentUsage.cacheWriteTokens ?? 0)
+            + (view.currentUsage.cacheReadTokens ?? 0);
+    }
+    return isFiniteNumber(view.pressureTokens) ? view.pressureTokens : undefined;
+}
+/**
+ * Build the CC-shaped status-line payload from the view. Absent sources drop
+ * their field; empty sub-objects are dropped wholesale; unknown extra keys are
+ * never fabricated. Serialized structurally — the payload type stays open.
+ */
+export function buildStatusLinePayload(view) {
+    const length = contextLengthOf(view);
+    const percentages = isFiniteNumber(length) && isFiniteNumber(view.contextWindowTokens) && view.contextWindowTokens > 0
+        ? (length / view.contextWindowTokens) * 100
+        : undefined;
+    const payload = {
+        cwd: view.sessionCwd ?? view.driverCwd,
+        session_id: view.sessionId,
+        transcript_path: view.transcriptPath,
+        model: compact({
+            id: view.model,
+            display_name: view.model,
+        }),
+        workspace: compact({
+            current_dir: view.sessionCwd ?? view.driverCwd,
+            project_dir: view.projectDir,
+            added_dirs: [],
+            git_worktree: view.gitWorktree ?? view.worktree?.name,
+        }),
+        version: view.version,
+        output_style: compact({ name: view.outputStyleName }),
+        cost: compact({
+            total_duration_ms: view.nowMs - (view.sessionCreatedAtMs ?? view.bindTimeMs),
+        }),
+        context_window: compact({
+            total_input_tokens: view.inputTokens,
+            total_output_tokens: view.outputTokens,
+            context_window_size: view.contextWindowTokens,
+            current_usage: view.currentUsage === undefined
+                ? undefined
+                : compact({
+                    input_tokens: view.currentUsage.inputTokens,
+                    output_tokens: view.currentUsage.outputTokens,
+                    cache_creation_input_tokens: view.currentUsage.cacheWriteTokens,
+                    cache_read_input_tokens: view.currentUsage.cacheReadTokens,
+                }),
+            used_percentage: percentages,
+            remaining_percentage: percentages === undefined ? undefined : 100 - percentages,
+        }),
+        // No occupancy source → the field is omitted (not a literal false).
+        exceeds_200k_tokens: isFiniteNumber(length) ? length > 200_000 : undefined,
+        effort: compact({ level: view.effort }),
+        worktree: view.worktree === undefined ? undefined : compact(view.worktree),
+    };
+    return compact(payload) ?? {};
+}
+//# sourceMappingURL=statusline-payload.js.map

package/lib/harness/statusline-payload.js.map

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

package/lib/harness/statusline-settings.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Pure settings module for the custom status line: the `statusline` settings
+ * namespace (the cascade aliases CC's camelCase `statusLine` key onto it), a
+ * tolerant schema, and the activation/normalization predicate. No driver or
+ * shell imports — this file is the seam-free half of the feature.
+ * @module @dsh-cc/tui/harness/statusline-settings
+ */
+import z from '@deepseek-ai/schemastery';
+/** Settings namespace carrying the status-line section (kebab-case). */
+export declare const STATUSLINE_SETTINGS_NAMESPACE: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+/** Raw (unresolved) settings section for the status line, CC-shaped and open. */
+export type StatusLineSection = {
+    type?: unknown;
+    command?: unknown;
+    padding?: unknown;
+    refreshInterval?: unknown;
+    hideVimModeIndicator?: unknown;
+    [key: string]: unknown;
+};
+/**
+ * Tolerant schema for the `statusline` section: every known key is optional,
+ * unknown sibling keys pass through (schemastery objects are non-strict by
+ * default), and a missing section resolves to `{}` — a shared CC settings
+ * file never hard-fails the cascade over extra keys.
+ */
+export declare const STATUSLINE_SECTION_SCHEMA: z<StatusLineSection>;
+/** Tolerant resolution of a raw section into the known shape (unknown keys kept). */
+export declare function statusLineSectionSchema(raw: StatusLineSection | undefined): StatusLineSection;
+/** Normalized, activated status-line configuration. */
+export type StatusLineDescription = {
+    active: true;
+    command: string;
+    padding: number;
+    refreshIntervalSec?: number;
+    hideVimModeIndicator?: boolean;
+} | {
+    active: false;
+};
+/**
+ * Apply the §3.1 activation predicate + clamps to a resolved section:
+ * activates iff `type === 'command'` and `command` is a non-empty string;
+ * `padding` defaults to 0 with negatives clamped to 0; `refreshInterval` is
+ * SECONDS with values < 1 clamped to 1; `hideVimModeIndicator` is parsed but
+ * behaviorally inert (no Vim mode in dsh-cc).
+ */
+export declare function describeStatusLine(section: StatusLineSection | undefined): StatusLineDescription;
+//# sourceMappingURL=statusline-settings.d.ts.map

package/lib/harness/statusline-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusline-settings.d.ts","sourceRoot":"","sources":["../../src/harness/statusline-settings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAGxC,wEAAwE;AACxE,eAAO,MAAM,6BAA6B,uDAAkC,CAAA;AAE5E,iFAAiF;AACjF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,CAAC,CAAC,iBAAiB,CAMzD,CAAA;AAEF,qFAAqF;AACrF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,GAAG,SAAS,GAAG,iBAAiB,CAG7F;AAED,uDAAuD;AACvD,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/G;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,CAAA;AAErB;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,qBAAqB,CAgBhG"}

package/lib/harness/statusline-settings.js

@@ -0,0 +1,57 @@
+/**
+ * Pure settings module for the custom status line: the `statusline` settings
+ * namespace (the cascade aliases CC's camelCase `statusLine` key onto it), a
+ * tolerant schema, and the activation/normalization predicate. No driver or
+ * shell imports — this file is the seam-free half of the feature.
+ * @module @dsh-cc/tui/harness/statusline-settings
+ */
+import z from '@deepseek-ai/schemastery';
+import { settingsNamespace } from '@deepseek-ai/dsh-settings';
+/** Settings namespace carrying the status-line section (kebab-case). */
+export const STATUSLINE_SETTINGS_NAMESPACE = settingsNamespace('statusline');
+/**
+ * Tolerant schema for the `statusline` section: every known key is optional,
+ * unknown sibling keys pass through (schemastery objects are non-strict by
+ * default), and a missing section resolves to `{}` — a shared CC settings
+ * file never hard-fails the cascade over extra keys.
+ */
+export const STATUSLINE_SECTION_SCHEMA = z.object({
+    type: z.any(),
+    command: z.any(),
+    padding: z.any(),
+    refreshInterval: z.any(),
+    hideVimModeIndicator: z.any(),
+});
+/** Tolerant resolution of a raw section into the known shape (unknown keys kept). */
+export function statusLineSectionSchema(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return {};
+    return STATUSLINE_SECTION_SCHEMA(raw);
+}
+/**
+ * Apply the §3.1 activation predicate + clamps to a resolved section:
+ * activates iff `type === 'command'` and `command` is a non-empty string;
+ * `padding` defaults to 0 with negatives clamped to 0; `refreshInterval` is
+ * SECONDS with values < 1 clamped to 1; `hideVimModeIndicator` is parsed but
+ * behaviorally inert (no Vim mode in dsh-cc).
+ */
+export function describeStatusLine(section) {
+    if (typeof section !== 'object' || section === null)
+        return { active: false };
+    const { type, command, padding, refreshInterval, hideVimModeIndicator } = section;
+    if (type !== 'command' || typeof command !== 'string' || command.trim().length === 0) {
+        return { active: false };
+    }
+    const description = {
+        active: true,
+        command,
+        padding: typeof padding === 'number' && Number.isFinite(padding) && padding > 0 ? padding : 0,
+    };
+    if (typeof refreshInterval === 'number' && Number.isFinite(refreshInterval)) {
+        description.refreshIntervalSec = refreshInterval < 1 ? 1 : refreshInterval;
+    }
+    if (hideVimModeIndicator === true)
+        description.hideVimModeIndicator = true;
+    return description;
+}
+//# sourceMappingURL=statusline-settings.js.map

package/lib/harness/statusline-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusline-settings.js","sourceRoot":"","sources":["../../src/harness/statusline-settings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAE7D,wEAAwE;AACxE,MAAM,CAAC,MAAM,6BAA6B,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAA;AAY5E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAyB,CAAC,CAAC,MAAM,CAAC;IACtE,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE;IACb,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE;IAChB,eAAe,EAAE,CAAC,CAAC,GAAG,EAAE;IACxB,oBAAoB,EAAE,CAAC,CAAC,GAAG,EAAE;CAC9B,CAAC,CAAA;AAEF,qFAAqF;AACrF,MAAM,UAAU,uBAAuB,CAAC,GAAkC;IACxE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,CAAA;IACtD,OAAO,yBAAyB,CAAC,GAAG,CAAC,CAAA;AACvC,CAAC;AAOD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAsC;IACvE,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAC7E,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAA;IACjF,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrF,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAC1B,CAAC;IACD,MAAM,WAAW,GAA0B;QACzC,MAAM,EAAE,IAAI;QACZ,OAAO;QACP,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;KAC9F,CAAA;IACD,IAAI,OAAO,eAAe,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5E,WAAW,CAAC,kBAAkB,GAAG,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAA;IAC5E,CAAC;IACD,IAAI,oBAAoB,KAAK,IAAI;QAAE,WAAW,CAAC,oBAAoB,GAAG,IAAI,CAAA;IAC1E,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/lib/harness/statusline-wiring.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Driver wiring for the custom status line (plan §4/Slice 4): settings
+ * registration (`statusline` namespace via installSettingsSection, tolerant
+ * when no settings provider is mounted), the lazily-created command runner,
+ * the refreshInterval timer (owned here — a documented deviation from the
+ * plan's "inside the runner" phrasing; same observable behavior, and the
+ * runner stays timer-free beyond its own debounce/cap), payload assembly at
+ * fire time from live state, and the trigger seams: projections onChanged +
+ * boot/rebind (hooked by driver-hud.ts), and the emit-diff wrapper (S1) over
+ * the driver's listener fan-out diffing permissionMode and the model/effort
+ * selection. Feature stays inert when the shell service is absent (D6/N3 —
+ * never the execFileAsync fallback).
+ * @module @dsh-cc/tui/harness/statusline-wiring
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent, ModelSelectionRef } from '@deepseek-ai/dsh-agent';
+import type { TuiState } from '../store.ts';
+/** Handle driver-hud.ts uses to consult/trigger the custom status line. */
+export type StatusLineSectionHandle = {
+    /** The custom line when active (`' '.repeat(padding) + latest()`); else undefined. */
+    override(): string | undefined;
+    /** A projection unit changed for the live session (debounced trigger). */
+    onProjection(key: string): void;
+    /** The session was (re)bound — run once for the new session (C4). */
+    onRebind(): void;
+};
+/** The slice of createDriver's closed-over state the wiring needs. */
+export type StatusLineWiringCtx = {
+    emit(next: TuiState): void;
+    state(): TuiState;
+    ctx: Context;
+    cwd: string;
+    current: {
+        agent: Agent;
+    };
+    selection: ModelSelectionRef;
+    /** The driver's emit listener set — the wiring rides it as the S1 diff seam. */
+    listeners: Set<(state: TuiState) => void>;
+};
+export declare function createStatusLineWiring(rt: StatusLineWiringCtx, options?: {
+    transcriptDir?: string;
+}): StatusLineSectionHandle & {
+    dispose(): void;
+};
+//# sourceMappingURL=statusline-wiring.d.ts.map

package/lib/harness/statusline-wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusline-wiring.d.ts","sourceRoot":"","sources":["../../src/harness/statusline-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAEtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAmB3C,2EAA2E;AAC3E,MAAM,MAAM,uBAAuB,GAAG;IACpC,sFAAsF;IACtF,QAAQ,IAAI,MAAM,GAAG,SAAS,CAAA;IAC9B,0EAA0E;IAC1E,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,qEAAqE;IACrE,QAAQ,IAAI,IAAI,CAAA;CACjB,CAAA;AAED,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,KAAK,IAAI,QAAQ,CAAA;IACjB,GAAG,EAAE,OAAO,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,CAAA;IACzB,SAAS,EAAE,iBAAiB,CAAA;IAC5B,gFAAgF;IAChF,SAAS,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAA;CAC1C,CAAA;AAMD,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,mBAAmB,EACvB,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,uBAAuB,GAAG;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,CA8N/C"}