@dsh-cc/tui 0.5.0

package/lib/state/driver-types.d.ts

@@ -0,0 +1,505 @@
+/**
+ * Structural Driver interface for UI components. Components import from here
+ * (not from harness/driver.ts) so the boundary gate keeps harness imports
+ * out of the view layer.
+ * @module @dsh-cc/tui/state/driver-types
+ */
+import type { CatalogEntry } from '../model-catalog.ts';
+import type { TuiState } from '../store.ts';
+import type { ToolCallView, ToolResultView } from '../tool-card.ts';
+import type { WorktreeExitHooks } from '../harness/worktree-exit.ts';
+/**
+ * The approval answers: grant once, grant persistently, grant for this
+ * session, reject.
+ */
+export type ApprovalAnswerKind = 'once' | 'always' | 'session' | 'reject';
+export interface Driver {
+    readonly state: TuiState;
+    readonly statusLine: string;
+    /**
+     * Width-aware status line: same content as {@link Driver.statusLine}, but
+     * the parenthetical context detail is omitted when the line would not fit
+     * `width` columns. Without a width the full line is returned.
+     */
+    statusLineIn(width?: number): string;
+    /** Session working directory, used for `@`-path completion. */
+    readonly cwd: string;
+    /**
+     * Persisted composer history (oldest→newest) loaded at boot from
+     * `~/.dsh/tui/history.txt`. Seeds the editor's ↑/↓ recall; new prompts are
+     * appended on submit (see {@link Driver.submit}). Read once at mount.
+     */
+    readonly promptHistory: readonly string[];
+    /**
+     * Bash-mode command history (newest-first, live reference). Every command
+     * executed through a leading `!` is prepended here and persisted to
+     * `~/.dsh/tui/bash-history.txt`; the root component browses this stack
+     * with ↑/↓ while in shell mode — deliberately separate from the composer
+     * prompt history.
+     */
+    readonly bashHistory: readonly string[];
+    subscribe(listener: (state: TuiState) => void): () => void;
+    setDraft(draft: string): void;
+    submit(text?: string): Promise<void>;
+    interrupt(): void;
+    /**
+     * Queue-jump (Ctrl+S): inject every queued outbox entry into the running
+     * turn immediately — FIFO `agent.steer` per entry, with the queue cleared
+     * in the same synchronous stroke as the dispatch. A no-op when the queue
+     * is empty.
+     */
+    steerQueued(): void;
+    /**
+     * Pop the LAST queued entry (LIFO — the most recent submit) back out of
+     * the outbox for editing (empty-composer ↑). Returns the text, or
+     * `undefined` when the queue is empty (same-reference no-op).
+     */
+    recallQueued(): string | undefined;
+    /**
+     * Ctrl+B promotion of a foreground subagent wait (UX plan §3.4): promote
+     * EVERY armed foreground collect of the CURRENT session to background via
+     * the root-realm `ccCollectorRegistry`. Gated by the
+     * `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` kill switch and by the registry
+     * being resolvable — with nothing promotable (no registry, no armed
+     * collect, or env kill switch armed) this is a `0` no-op. Returns the
+     * number of promoted collects (the TUI echoes one status line when > 0).
+     * Optional: drivers without the seam degrade to no promotion.
+     */
+    promoteForegroundCollects?(): number;
+    /**
+     * Advance the Shift+Tab permission-mode cycle. Mode writes are serialized
+     * per driver; the returned promise settles when this step's write chain
+     * (command-channel dispatch + engine setMode) has finished, so tests and
+     * callers that care about ordering can await it.
+     */
+    cyclePermissionMode(): Promise<void>;
+    /**
+     * Flip the global collapse state (Ctrl+O): thinking rows and tool output
+     * collapse together, or both expand back. Supersedes {@link Driver.toggleThinking},
+     * which is retained for compatibility.
+     */
+    toggleGlobalCollapse(): void;
+    /** Legacy thinking-only flip; kept for compatibility with Ctrl+O's old behavior. */
+    toggleThinking(): void;
+    /**
+     * Answer the open approval prompt: `'once'` grants this call only;
+     * `'always'` additionally derives a permission rule from the prompt's
+     * preview and persists it into the settings `permissions.allow` list;
+     * `'session'` derives the same rule and grants it for the current session
+     * only (session-scoped allowlist — never persisted to global settings);
+     * `'reject'` refuses the call.
+     */
+    answerApproval(kind: ApprovalAnswerKind): void;
+    /**
+     * While a question overlay is open: move the focus one row across the
+     * options and the trailing free-text ("Other") row.
+     */
+    questionMove(delta: -1 | 1): void;
+    /**
+     * Activate the focused row: a multi-select question toggles the option in
+     * `selected`; a single-select question resolves immediately with that
+     * option's label; on the "Other" row a space is typed into the buffer.
+     */
+    questionToggle(): void;
+    /**
+     * Jump to option `index` (0-based) and activate it — single-select
+     * resolves, multi-select toggles. Out-of-range indexes are ignored. This is
+     * the digit quick-pick path (keys 1-9).
+     */
+    questionPick(index: number): void;
+    /** Append free text to the "Other" buffer and focus that row. */
+    questionType(text: string): void;
+    /** Edit the "Other" buffer (drops the last character). */
+    questionBackspace(): void;
+    /**
+     * Resolve the open question: the toggled labels for multi-select, or the
+     * focused option when nothing is chosen and the buffer is empty; a
+     * non-empty "Other" buffer is sent as `custom` (with an empty `selected`
+     * when no option was picked).
+     */
+    questionSubmit(): void;
+    /** Dismiss the overlay resolving the first option (legacy escape behavior). */
+    questionCancel(): void;
+    /**
+     * Open the `/model` picker overlay: loads the catalog, parks `modelPicker`
+     * state focused on the current route, or falls back to the status-row
+     * notice when the catalog is empty. The arg path (`/model <n|provider/id>`)
+     * bypasses the overlay and stays scriptable.
+     */
+    openModelPicker(): Promise<void>;
+    /** Move the model-picker focus by one row (clamped; no wrap). */
+    modelPickerMove(delta: -1 | 1): void;
+    /**
+     * Select the focused entry and close the overlay synchronously; the model
+     * write (with its effort-preserve validation) settles asynchronously, so
+     * awaiting the returned promise waits for the selection to be updated.
+     */
+    modelPickerSubmit(): Promise<void>;
+    /** Close the overlay without changing the selection. */
+    modelPickerCancel(): void;
+    /**
+     * Open the `/effort` picker overlay: resolves the current model's advertised
+     * effort levels and parks `effortPicker` state focused on the live effort
+     * (the trailing `default` entry when none is set). Fail closed — an
+     * unresolved model or unresolvable levels emit a status notice instead of
+     * opening a fabricated list. The arg path (`/effort <level|default>`)
+     * bypasses the overlay and stays scriptable.
+     */
+    openEffortPicker(): Promise<void>;
+    /** Move the effort-picker focus by one row (clamped; no wrap). */
+    effortPickerMove(delta: -1 | 1): void;
+    /**
+     * Select the focused entry and close the overlay synchronously; validation
+     * and the selection write settle asynchronously behind a stale-pair guard
+     * (a concurrent `/model` or session switch refuses the parked write).
+     * Awaiting the returned promise waits for that write to settle.
+     */
+    effortPickerSubmit(): Promise<void>;
+    /** Close the overlay without changing the selection. */
+    effortPickerCancel(): void;
+    /**
+     * Open the `/permissions` picker overlay: parks `permissionPicker` state
+     * focused on the live mode. The argued path (`/permissions <mode>`)
+     * bypasses the overlay and stays scriptable through the host command.
+     */
+    openPermissionPicker(): Promise<void>;
+    /** Move the permission-picker focus by one row (clamped; no wrap). */
+    permissionPickerMove(delta: -1 | 1): void;
+    /**
+     * Select the focused entry. `bypassPermissions` first parks an in-overlay
+     * confirmation; a second submit (or any other mode) closes the overlay
+     * synchronously and writes `/permissions ${id}` through the host command.
+     * Awaiting the returned promise waits for that write to settle.
+     */
+    permissionPickerSubmit(): Promise<void>;
+    /**
+     * Close the overlay without changing the mode. While the bypass
+     * confirmation is showing, cancel returns to the list instead.
+     */
+    permissionPickerCancel(): void;
+    /**
+     * Open the `/resume` session-switcher overlay: loads the session list,
+     * sorts it by last activity, filters it to the current project's cwd (Tab
+     * toggles to all projects), parks `sessionSwitcher` state focused on the
+     * current session, and decorates titles asynchronously — or falls back to
+     * a status-row notice when no sessions exist at all. The arg path
+     * (`/resume <id>`) bypasses the overlay and switches directly.
+     */
+    openSessionSwitcher(): Promise<void>;
+    /** Move the session-switcher focus by one row (clamped; no wrap). */
+    sessionSwitcherMove(delta: -1 | 1): void;
+    /** Append text to the picker's query filter and re-filter (focus resets). */
+    sessionSwitcherType(text: string): void;
+    /** Drop the picker query's last character (no-op when empty) and re-filter. */
+    sessionSwitcherBackspace(): void;
+    /** Flip the picker scope between this project's cwd and all projects. */
+    sessionSwitcherToggleScope(): void;
+    /** Switch to the focused session (await {@link Driver.switchSession}) and close the overlay. */
+    sessionSwitcherSubmit(): Promise<void>;
+    /**
+     * Two-stage escape: a non-empty query is cleared first (overlay stays
+     * open); an empty query closes the overlay without switching.
+     */
+    sessionSwitcherCancel(): void;
+    /**
+     * Toggle the Ctrl+T todo panel: open it focused on the first row when
+     * closed (rendering a placeholder when the session has no todos), or close
+     * it when open. Pure store evolution — no harness calls.
+     */
+    toggleTodoPanel(): void;
+    /** Move the todo-panel focus by one row (clamped; no wrap). */
+    todoPanelMove(delta: -1 | 1): void;
+    /** Close the todo panel. */
+    todoPanelClose(): void;
+    /**
+     * Close the `/usage` panel (Esc). The panel is pure display — opening is
+     * owned by the `/usage` command — so closing is its only interaction.
+     */
+    usagePanelClose(): void;
+    /**
+     * Move the `/quit` worktree-exit confirmation focus by one row (clamped;
+     * no wrap). Overlay options: 0 keep, 1 remove, 2 cancel.
+     */
+    worktreeExitMove(delta: -1 | 1): void;
+    /**
+     * Confirm the focused worktree-exit option. Keep exits normally; Remove
+     * runs the cleanup and only exits on success (failure keeps the session
+     * alive); Cancel dismisses the overlay. No-op while `busy`.
+     */
+    worktreeExitSubmit(): Promise<void>;
+    /**
+     * Dismiss the worktree-exit overlay without quitting. No-op while `busy`.
+     */
+    worktreeExitCancel(): void;
+    /**
+     * Show a one-line transient notice above the composer. The notice clears
+     * itself after `ttlMs` (default 3000); a newer notice replaces the pending
+     * clear timer of the previous one.
+     */
+    showNotice(text: string, ttlMs?: number): void;
+    /**
+     * Record the moment of an idle Ctrl+C press — the anchor for the
+     * double-press-to-exit window. Pure state evolution; callers pass the
+     * timestamp they compared against so anchor and comparison share one clock
+     * read. Defaults to `Date.now()`.
+     */
+    markExitAttempt(now?: number): void;
+    /**
+     * Switch the live agent to a different persisted session in-process: dispose
+     * the current handle, resume the target, replay its history through the same
+     * fold the boot path uses, and reset the transcript. No-op when `id` matches
+     * the current session. On failure the old session stays bound and a notice
+     * is emitted.
+     */
+    switchSession(id: string): Promise<void>;
+    /** List persisted sessions (newest-first absent — the caller sorts). */
+    listSessions(): Promise<readonly {
+        id: string;
+        cwd?: string;
+        createdAt: number;
+    }[]>;
+    /**
+     * Live LLM model catalog (`provider`/`id`/`name` per advertised model), the
+     * same list `/model` resolves its argument against. Used by slash argument
+     * completion; fetched per call so it never goes stale.
+     */
+    loadModelCatalog(): Promise<readonly CatalogEntry[]>;
+    /**
+     * Reasoning-effort levels of the currently resolved model plus the trailing
+     * `default` entry; `[]` when no model is resolved or its levels cannot be
+     * resolved (no dead-end completions). Used by slash argument completion;
+     * fetched per call so it never goes stale.
+     */
+    loadModelEfforts(): Promise<readonly string[]>;
+    /**
+     * Merged slash-command catalog: TUI-local commands first, then harness
+     * commands (deduped by name, local wins), then user-invocable skills from
+     * the skills registry (a name claimed by a command resolves to the
+     * command). The array identity is stable across calls until the catalog
+     * changes (so callers can detect a refresh by reference equality).
+     */
+    listCommands(): readonly {
+        name: string;
+        description?: string;
+        argumentHint?: string;
+    }[];
+    dispose(): Promise<void>;
+}
+/**
+ * Configuration for the TUI harness driver. `branchProbe` defaults to
+ * `gitBranchOf` (harness/shell-output); `exportDir` defaults to
+ * `$DSH_HOME/tui/exports` (same resolution as `resume-target`).
+ */
+export interface DriverConfig {
+    cwd?: string;
+    agentPreset?: string;
+    sessionId?: string;
+    /** Boot-time resume from the project resume marker (`sessionId` unset). */
+    autoResume?: boolean;
+    /** `-c`/`--continue` requested — only affects the no-previous-session notice. */
+    continueRequested?: boolean;
+    provider?: string;
+    model?: string;
+    /** Directory for the persisted history file (defaults to `$DSH_HOME/tui`). */
+    historyDir?: string;
+    /** Git-branch probe for the statusline (best-effort); injectable for tests. */
+    branchProbe?: (cwd: string) => Promise<string | undefined>;
+    /** Output directory for `/export-md` (default `$DSH_HOME/tui/exports`). */
+    exportDir?: string;
+    /** Sink for the OSC 52 clipboard sequence `/copy` emits; injectable. */
+    copyWrite?: (sequence: string) => void;
+    /** `/quit` worktree-exit seam (probe/evidence/cleanup); injectable for tests. */
+    worktreeExit?: WorktreeExitHooks;
+    /** Quit finalizer invoked after a `/quit` decision settles. */
+    onQuit?: () => void;
+}
+export type ToolsLike = {
+    get(name: string, scope?: unknown): {
+        presentCall?(args: unknown): ToolCallView | undefined;
+        presentResult?(args: unknown, result: {
+            content: unknown;
+            isError: boolean;
+            meta?: unknown;
+        }): ToolResultView | undefined;
+    } | undefined;
+};
+/**
+ * Structural stand-in for the deployment's `agentDefaultModel` service
+ * (settings.yaml's `agent-default-model`), which the headless bundle seeds
+ * agents from. `currentSelection()` returns the resolved default or undefined
+ * when no default is configured. A carried `reasoningEffort` is seeded into
+ * the selection too — but only after the llm service confirms the model
+ * advertises it ({@link resolveEfforts}); an invalid or unresolvable effort is
+ * silently dropped to the bare pair, which is always legal.
+ */
+export type AgentDefaultModelLike = {
+    currentSelection(): {
+        provider: string;
+        model: string;
+        reasoningEffort?: string;
+    } | undefined;
+};
+export type LlmLike = {
+    listProviders(): {
+        id: string;
+    }[];
+    listModels(provider: string): Promise<{
+        provider: string;
+        id: string;
+        name: string;
+    }[]>;
+    /**
+     * Optional model-metadata lookup used to validate reasoning-effort writes.
+     * Optional so existing llm stubs without it keep working: every effort
+     * consumer treats absence as "unresolvable" and fails closed (or writes the
+     * bare pair for /model, which never needs validation).
+     */
+    resolveModelInfo?(provider: string, model: string, signal?: AbortSignal): Promise<{
+        reasoning?: {
+            efforts: readonly {
+                id: string;
+                name: string;
+                description?: string;
+            }[];
+            defaultEffort?: string;
+        };
+    }>;
+};
+export type PersistenceLike = {
+    list(signal?: AbortSignal): Promise<{
+        id: string;
+        cwd?: string;
+        createdAt: number;
+        updatedAtMs?: number;
+        parentSession?: string;
+    }[]>;
+};
+/**
+ * Structural stand-in for the deployment's `sessionQuery` service: batch
+ * title reads for the /resume picker. One result per requested id —
+ * operational failures are isolated per id (`status: 'rejected'`), and the
+ * fulfilled value carries the session header plus its latest title snapshot.
+ */
+export type SessionTitleResultLike = {
+    status: 'fulfilled';
+    /** Requested session id — the join key. Do not use `value.session.id`. */
+    sessionId: string;
+    value: {
+        session: {
+            id: string;
+        };
+        title?: {
+            title: string;
+        };
+    };
+} | {
+    status: 'rejected';
+    sessionId?: string;
+};
+export type SessionQueryLike = {
+    readTitleSnapshots(ids: readonly string[], signal?: AbortSignal): Promise<readonly SessionTitleResultLike[]>;
+};
+/**
+ * `subagent/start` snapshot. The real `SubagentRunInfo` is declared in
+ * the subagent package (via cordis module augmentation), which the tui
+ * package doesn't import — so a structural local type stands in. Fields are
+ * `unknown` because the driver stringifies them into the view layer.
+ */
+export type SubagentRunInfoLike = {
+    runId: unknown;
+    provider: unknown;
+    id: unknown;
+    local: boolean;
+};
+/**
+ * `subagent/end` snapshot. `stopReason` and `lastAssistantMessage` are
+ * optional on the payload; only `stopReason` is surfaced to the view.
+ */
+export type SubagentRunEndInfoLike = {
+    runId: unknown;
+    provider: unknown;
+    id: unknown;
+    local: boolean;
+    stopReason?: unknown;
+    lastAssistantMessage?: unknown;
+};
+/**
+ * Structural stand-in for the deployment's `shell` service (ShellExecutor's
+ * resolve→run seam), which the tui package doesn't import. `resolve` fills
+ * the request's defaults/caps; `run` executes the resolved spec and reports
+ * the first-cause outcome. Absent service → the driver degrades to a direct
+ * child process (see `runShellCommand`).
+ */
+export type ShellExecSpecLike = {
+    command: string;
+    workdir: string;
+    timeoutMs: number;
+    stdoutMaxBytes: number;
+    /** Stdin bytes handed to the child (resolve bakes the request's in). */
+    stdin?: string;
+    /** Abort signal wiring the caller's cancellation into the child. */
+    signal?: AbortSignal;
+    /** Extra/overriding environment entries (resolve bakes the request's in). */
+    env?: Record<string, string>;
+};
+export type ShellRunResultLike = {
+    /** Exit code; null when the process died from a signal. */
+    exitCode: number | null;
+    /** True when the executor's timeout was the first cause to cut the command. */
+    timedOut: boolean;
+    stdout: {
+        text: string;
+    };
+    stderr: {
+        text: string;
+    };
+};
+export type ShellExecRequestLike = {
+    command: string;
+    timeoutMs?: number;
+    stdoutMaxBytes?: number;
+    /** Stdin bytes handed to the child (e.g. the status-line JSON payload). */
+    stdin?: string;
+    /** Abort signal wiring the caller's cancellation into the child. */
+    signal?: AbortSignal;
+    /** Environment entries merged over the inherited process env. */
+    env?: Record<string, string>;
+    /** Working directory for the child (the harness executor's field name). */
+    workdir?: string;
+};
+export type ShellExecutorLike = {
+    resolve(request: ShellExecRequestLike): ShellExecSpecLike;
+    run(spec: ShellExecSpecLike): Promise<ShellRunResultLike>;
+};
+/**
+ * Structural stand-in for the sessionProjections registry
+ * (dsh-session-projection package, via token-meter's augmentation),
+ * which the tui package doesn't import — same pattern as the other `*Like`
+ * seams. `onChanged` fires once per client-visible unit whose state changed;
+ * `stateOf` is the live read (undefined when the key is not registered).
+ */
+export type SessionProjectionsLike = {
+    onChanged(listener: (session: {
+        id: unknown;
+    }, key: string, value: unknown, seq: number) => void): () => void;
+    stateOf(session: unknown, key: string): unknown;
+};
+export type { ContextBreakdownStateLike, ContextPressureStateLike, TokenUsageStateLike, TokenUsageTotals, } from './driver-usage-types.ts';
+/**
+ * Structural seam for the deployment settings provider: the pieces the
+ * always-allow write path needs (namespace descriptors and whole-section
+ * replace). Declared locally — the tui package does not import the settings
+ * package, mirroring the other `*Like` seams.
+ */
+export type SettingsProviderLike = {
+    readonly writable?: boolean;
+    describe(options?: {
+        redactSecrets?: boolean;
+    }): readonly {
+        ns: unknown;
+        revision: number;
+        user?: unknown;
+    }[];
+    replace(ns: unknown, section: object, expectedRevision?: number): Promise<void>;
+};
+//# sourceMappingURL=driver-types.d.ts.map

package/lib/state/driver-types.d.ts.map

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

package/lib/state/driver-types.js

@@ -0,0 +1,8 @@
+/**
+ * Structural Driver interface for UI components. Components import from here
+ * (not from harness/driver.ts) so the boundary gate keeps harness imports
+ * out of the view layer.
+ * @module @dsh-cc/tui/state/driver-types
+ */
+export {};
+//# sourceMappingURL=driver-types.js.map

package/lib/state/driver-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-types.js","sourceRoot":"","sources":["../../src/state/driver-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/lib/state/driver-usage-types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Usage/projection state types shared by the HUD, the `/usage` panel and
+ * `/cost`. Extracted from driver-types.ts to keep that file focused on the
+ * Driver interface and its structural service seams.
+ * @module @dsh-cc/tui/state/driver-usage-types
+ */
+/**
+ * `tokenUsage` projection state. `uncachedInputTokens` is the harness's
+ * field name; `inputTokens` is accepted defensively so a shape drift
+ * degrades to "no tokens" instead of NaN. Cache fields are optional —
+ * compositions without prompt caching simply omit those lines. `last`
+ * (when present) carries the most recent API step's per-response token
+ * buckets — the CC `current_usage` semantics; it is read defensively too,
+ * since state may arrive as a foreign/partial shape.
+ */
+export type TokenUsageStateLike = {
+    totals?: {
+        uncachedInputTokens?: number;
+        inputTokens?: number;
+        outputTokens?: number;
+        cacheReadTokens?: number;
+        cacheWriteTokens?: number;
+    };
+    last?: {
+        turn?: number;
+        step?: number;
+        buckets?: {
+            uncachedInputTokens?: number;
+            inputTokens?: number;
+            outputTokens?: number;
+            cacheReadTokens?: number;
+            cacheWriteTokens?: number;
+        };
+    };
+};
+/** Normalized token totals shared by the HUD and `/cost`. */
+export interface TokenUsageTotals {
+    input: number;
+    output: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+}
+/** `contextPressure` projection state (subset the HUD reads). */
+export type ContextPressureStateLike = {
+    contextWindow?: number;
+    pressureTokens?: number;
+    surfaceTokens?: number;
+    sampledSurfaceTokens?: number;
+};
+/**
+ * `contextBreakdown` projection state (subset the usage panel reads): the
+ * projected context token count per content role.
+ */
+export type ContextBreakdownStateLike = {
+    system?: number;
+    tools?: number;
+    messages?: number;
+};
+//# sourceMappingURL=driver-usage-types.d.ts.map

package/lib/state/driver-usage-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-usage-types.d.ts","sourceRoot":"","sources":["../../src/state/driver-usage-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE;QACP,mBAAmB,CAAC,EAAE,MAAM,CAAA;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAC1B,CAAA;IACD,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE;YACR,mBAAmB,CAAC,EAAE,MAAM,CAAA;YAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;YACpB,YAAY,CAAC,EAAE,MAAM,CAAA;YACrB,eAAe,CAAC,EAAE,MAAM,CAAA;YACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;SAC1B,CAAA;KACF,CAAA;CACF,CAAA;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,iEAAiE;AACjE,MAAM,MAAM,wBAAwB,GAAG;IACrC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA"}

package/lib/state/driver-usage-types.js

@@ -0,0 +1,8 @@
+/**
+ * Usage/projection state types shared by the HUD, the `/usage` panel and
+ * `/cost`. Extracted from driver-types.ts to keep that file focused on the
+ * Driver interface and its structural service seams.
+ * @module @dsh-cc/tui/state/driver-usage-types
+ */
+export {};
+//# sourceMappingURL=driver-usage-types.js.map

package/lib/state/driver-usage-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-usage-types.js","sourceRoot":"","sources":["../../src/state/driver-usage-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/lib/statusline.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Footer status line for the CC-mode TUI.
+ * @module @dsh-cc/tui/statusline
+ */
+export interface StatusLineInput {
+    cwd: string;
+    sessionId: string;
+    permissionMode: string;
+    model?: string;
+    /** Selected reasoning effort for the active model (omitted = provider default). */
+    effort?: string;
+    /** Git branch of the session cwd (best-effort boot probe; omitted when unknown). */
+    branch?: string;
+    /** Context occupancy percent, 0-100 (rounded here when fractional). */
+    contextPercent?: number;
+    /**
+     * Raw occupancy backing `contextPercent`, rendered as the exact
+     * `ctx NN% (used/window)` detail when the window is known. The numerator is
+     * the projected token count — never back-derived from the rounded percent.
+     */
+    contextTokens?: {
+        readonly used: number;
+        readonly window?: number;
+    };
+    /** Cumulative token totals for the session. */
+    tokens?: {
+        input: number;
+        output: number;
+    };
+    busy: boolean;
+}
+/**
+ * Compact a session id to its `prefix-first8hex` form (e.g.
+ * `tui-abcdef01-…` → `tui-abcdef01`). Falls back to the full id when the
+ * shape doesn't match. Shared by the footer and `/agents`.
+ */
+export declare function shortenSession(sessionId: string): string;
+/**
+ * Compact a token count for the footer: exact below 1k, one decimal below
+ * 100k (`12.3k`), integer above (`123k`), and `m` past a million. Negative
+ * and non-finite inputs clamp to `0` — the line stays total on bad data.
+ */
+export declare function formatTokens(tokens: number): string;
+/**
+ * The client-drawn permission-mode row appended under a custom statusline
+ * (`<mode> · shift+tab · /quit`); shares the hint constants with the
+ * built-in line so the formats cannot drift.
+ */
+export declare function formatModeLine(permissionMode: string): string;
+/**
+ * Compact footer: `cwd [branch] · session · mode · model · ctx NN% ·
+ * ↑in ↓out tok` plus the busy marker and key hints. Absent optional fields
+ * drop their segments; the function is pure and total on undefined inputs.
+ *
+ * When the context window is known the ctx segment grows an exact
+ * `(used/window)` detail. `opts.width` is a terminal-width hint: when the
+ * assembled line would overflow it, only that parenthetical detail is dropped
+ * and the bare `ctx NN%` survives (other segments are never elided).
+ */
+export declare function formatStatusLine(input: StatusLineInput, opts?: {
+    width?: number;
+}): string;
+//# sourceMappingURL=statusline.d.ts.map