dsh-code 0.6.1 → 0.8.0

package/lib/types/render/status.d.ts

@@ -40,7 +40,7 @@ export declare function cacheHitPercent(usage: TranscriptStats['usage']): number
  * Presentation tones for status spans; the footer maps each to a theme color
  * (Codex status-line accents: model/path/branch/state/usage categories).
  */
-export type StatusTone = 'model' | 'live' | 'path' | 'branch' | 'value' | 'label' | 'meta' | 'accent' | 'success' | 'warn' | 'error';
+export type StatusTone = 'model' | 'live' | 'path' | 'branch' | 'value' | 'label' | 'meta' | 'accent' | 'success' | 'warn' | 'error' | 'ctxFill';
 /** One colored run inside the status bar. */
 export interface StatusSpan {
     text: string;
@@ -64,11 +64,9 @@ export interface StatusRow {
     hint: boolean;
 }
 /**
- * The footer layout: two stacked physical rows. Row 1 is the identity/state
- * row (busy dot, model, cwd, branch, plan, turns, tokens, title; goal,
- * sandbox, and permission badges). Row 2 is the run-meters row (mode, the
- * context progress bar, cache, and duration figures) and degrades to empty
- * before any row-1 content is touched.
+ * The footer layout: two stacked physical rows. Row 1 keeps the primary
+ * controls in model, cwd, mode, branch, context, permission order. Row 2
+ * carries every secondary session/run figure and degrades independently.
  */
 export interface StatusLayout {
     row1: StatusRow;
@@ -80,21 +78,30 @@ export declare const STATUS_GROUP_SEPARATOR = " | ";
 export declare const STATUS_ITEM_SEPARATOR = " \u00B7 ";
 /** The Codex-style mode cycle hint appended to the permission badge. */
 export declare const STATUS_CYCLE_HINT = " (shift+tab to cycle)";
-/** Cells in the context-occupancy progress bar (block glyphs count two columns in the budget). */
-export declare const CONTEXT_BAR_CELLS = 10;
-/** Occupancy at which the bar switches from brand blue to a single amber warning. */
+/**
+ * Interior columns of the segmented context bar (content-type segments plus
+ * the free tail whose right edge carries the usage readout). Fixed so the
+ * row-2 drop ladder can pre-measure the group; the bar shrinks its labels and
+ * readout inside this budget rather than asking the layout for more room.
+ */
+export declare const CONTEXT_BAR_WIDTH = 24;
+/** Occupancy at which the usage readout flips from brand blue to amber. */
 export declare const CONTEXT_WARN_PERCENT = 90;
 /**
- * Render a context-occupancy percent as a bracketed fixed-width progress bar
- * plus the percentage: `[▰▰▰▱▱▱▱▱▱▱] 25%`. Filled cells and the percent read
- * in brand blue (accent), empty cells and the brackets read dim (label), and
- * the whole meter flips to one amber warning once occupancy reaches the
- * warning threshold. The bar fill clamps to 100 while the printed percent
- * keeps the raw value so an over-budget session reads as such.
- * @param percent - occupancy percent (may exceed 100).
+ * Render context occupancy as ONE stepless bar: a solid DeepSeek-blue fill
+ * run, a dim dotted free track, and the usage readout riding the track's
+ * right edge (`12.3K/1.0M 25%`, shrinking to the bare percent as the track
+ * narrows). No per-content-type segmentation. Column split is deterministic:
+ * the free share is `Math.round(free/window*width)` clamped to at least
+ * CONTEXT_MIN_FREE columns and at most the full width; the fill takes every
+ * remaining column, so a given occupancy always renders the identical bar.
+ * The readout flips to amber once occupancy reaches the warning threshold.
+ * @param usedTokens - reported used tokens (drives the readout and percent).
+ * @param contextWindow - route capacity.
+ * @param width - total bar interior columns.
  * @returns tone-split spans for the footer to paint.
  */
-export declare function contextBar(percent: number): readonly StatusSpan[];
+export declare function contextBar(usedTokens: number, contextWindow: number, width: number): readonly StatusSpan[];
 /**
  * One customizable status item (the Codex /statusline picker contract).
  * 'left' items render as pipe-separated clusters after the identity dot;
@@ -128,6 +135,12 @@ export declare const DEFAULT_STATUSLINE_ITEMS: readonly StatusItemId[];
  * @returns the normalized ordered item list.
  */
 export declare function parseStatuslineItems(value: unknown): readonly StatusItemId[];
+/**
+ * Extra left padding on the secondary row so its content aligns with the
+ * model name's left edge on the primary row (padding 2 + busy dot 2). The
+ * layout subtracts it from row 2's budget so the indent can never wrap it.
+ */
+export declare const STATUS_ROW2_INDENT = 2;
 /** Identity facts the runner resolves once at mount; empty strings drop out. */
 export interface StatusFacts {
     /** 'provider/model' selection serving this session. */
@@ -152,7 +165,7 @@ export interface StatusFacts {
     } | undefined;
     /** Whether plan mode is active (folded from 'plan/mode'). */
     plan: boolean;
-    /** Active permission preset (folded from 'permission/preset'), empty when unknown. */
+    /** Active or pending permission preset; empty only when the service is unavailable. */
     permission: string;
 }
 /**
@@ -164,12 +177,10 @@ export interface StatusFacts {
  */
 export declare function permissionTone(permission: string): StatusTone;
 /**
- * Compose the two-row footer layout under a column budget. Row 1 (identity
- * and state badges) degrades in a fixed order — cycle hint, then title, token
- * figures, turn/step counts, goal, divergent sandbox, permission badge — and
- * only then ellipsizes the identity cluster, so the row never wraps. Row 2
- * (mode, context bar, cache, duration figures) fits its own budget and
- * degrades to empty before any row-1 content is touched.
+ * Compose the two-row footer layout under a column budget. Row 1 keeps model,
+ * cwd, mode, branch, context, then the right-pinned permission badge and cycle
+ * hint. It drops hint, context, and permission before ellipsizing identity.
+ * Row 2 fits all secondary figures and state within its own budget.
  * @param facts - identity facts resolved by the runner.
  * @param stats - session figures folded from the durable log.
  * @param columns - usable columns for each row (before their left padding).

package/lib/types/render/text.d.ts

@@ -3,17 +3,21 @@
  * tool payloads, skill descriptions). Control characters — including ANSI
  * CSI/OSC escape sequences — would otherwise pass through Ink into the
  * terminal, letting output rewrite the screen or inject prompts. Newlines
- * and tabs survive; everything else in C0/C1 plus DEL becomes a visible
- * `\xNN` escape.
+ * survive; everything else in C0/C1 plus DEL becomes a visible `\xNN`
+ * escape, and bidi overrides / invisible format controls / Unicode line and
+ * paragraph separators become a visible `\uXXXX` escape (terminal emulators
+ * that render bidirectional text would otherwise reorder the displayed
+ * glyphs and let a command read as something it is not).
  *
  * @module @deepseek-ai/dsh-code/render/text
  */
 /**
- * Escape control characters so externally sourced text cannot drive the
- * terminal.
+ * Escape control and deceptive characters so externally sourced text cannot
+ * drive the terminal. C0/C1/DEL render as a literal `\xNN` escape; bidi,
+ * invisible-format, and separator controls render as a literal `\uXXXX`
+ * escape. Newlines and tabs survive (budgeted callers normalize tabs).
  * @param text - raw text from a session event, tool payload, or catalog.
- * @returns text with every control character (except `\n`, `\t`) rendered
- * as a literal `\xNN` escape.
+ * @returns display-safe text with every injectable character made visible.
  */
 export declare function displayText(text: string): string;
 /** Collapse external text to one terminal-safe logical row. */
@@ -36,7 +40,10 @@ export interface DisplayTail {
  * Keep only the newest display-safe text that fits a terminal rectangle.
  * The scan walks backward and stops as soon as the suffix is full, so a long
  * reasoning stream does not rescan its entire accumulated prefix per chunk.
- * Explicit newlines and terminal wrapping both consume rows.
+ * Explicit newlines and terminal wrapping both consume rows; tabs expand to
+ * two spaces so terminal tab stops (which render at contextual column 8
+ * boundaries, not at the budgeted cell count) cannot inflate the physical
+ * row count of the live region.
  * @param text - raw externally sourced text.
  * @param columns - available terminal columns.
  * @param rows - available terminal rows.

package/lib/types/render/tool-detail.d.ts

@@ -70,7 +70,9 @@ export type ToolDetail = {
  * Render one change as removed-then-added rows, hunked by common prefix and
  * suffix. A null before-image (file create) renders as pure additions. The
  * budget caps emitted rows and reports the cut, so a whole-file overwrite
- * never floods the transcript.
+ * never floods the transcript. Inputs are hard-capped before line splitting
+ * and the row list is built incrementally up to the budget — a crafted or
+ * replayed giant diff cannot force a full intermediate rows array.
  * @param oldText - prior content, or null for a create.
  * @param newText - content after the change.
  * @param budget - maximum rows to emit.

package/lib/types/render/tool-preview.d.ts

@@ -2,7 +2,10 @@
  * Bounded preview line for a tool invocation's raw JSON arguments: the first
  * human-meaningful string among the well-known keys (command, path, query, …)
  * with a fallback to the bounded raw JSON. Shared by the tool card in the
- * transcript and the approval bar's command preview.
+ * transcript and the approval bar's command preview. Arguments longer than
+ * {@link MAX_PARSE_CHARS} are never parsed: the preview is a display concern,
+ * and a synchronous `JSON.parse` plus string copies of an unbounded model
+ * payload must not run on the approval or projection paths.
  *
  * @module @deepseek-ai/dsh-code/render/tool-preview
  */

package/lib/types/session-directory.d.ts

@@ -48,6 +48,21 @@ export interface SessionRow {
     readonly preset: string;
     readonly title?: string;
 }
+/** True when the header describes a subagent conversation (durable lineage). */
+export declare function isSubagentSession(header: SessionHeader): boolean;
+/** Platform-consistent path equality for session cwd comparisons. */
+export declare function samePath(left: string | undefined, right: string): boolean;
+/**
+ * Unique header match by exact id or unique id prefix (root and subagent
+ * headers alike); the caller applies any lineage gate.
+ * @param headers - the persisted headers.
+ * @param wanted - the id or id prefix.
+ * @returns the uniquely matched header.
+ * @throws when nothing matches or the prefix is ambiguous.
+ */
+export declare function matchSessionId(headers: readonly SessionHeader[], wanted: string): SessionHeader;
+/** The newest persisted ROOT session pinned to this cwd, or undefined. */
+export declare function newestRootForCwd(headers: readonly SessionHeader[], cwd: string): SessionHeader | undefined;
 /** Filter/sort header-only records. No session log is loaded here. */
 export declare function projectSessionRows(records: readonly SessionRecord[], options: SessionDirectoryOptions): SessionRow[];
 /** Merge page-local title observations without disturbing directory order. */

package/lib/types/startup.d.ts

@@ -1,9 +1,9 @@
 /**
  * The interactive terminal app's command-line provider: parses `--resume`,
- * `--continue`, `--session`, `--mode`, and `--help`, then publishes
- * {@link TUI_STARTUP_SERVICE} for the runner to consume lazily. Follows the
- * headless bundle's startup shape (a commander action publishing a service
- * through {@link parseCmdline}).
+ * `--continue`, `--session`, `--mode`, `--theme`, and `--help`, then
+ * publishes {@link TUI_STARTUP_SERVICE} for the runner to consume lazily.
+ * Follows the headless bundle's startup shape (a commander action publishing
+ * a service through {@link parseCmdline}).
  *
  * Semantics:
  * - `--resume <id|prefix>` — continue the persisted session whose id or unique
@@ -13,11 +13,14 @@
  *   whose project directory matches the current working directory.
  * - `--session <id>` — create a new session under an explicit identity (the
  *   id must not exist yet).
+ * - `--theme <dark|light|auto>` — the color palette; auto follows the
+ *   terminal (dark fallback until OSC-11 detection lands).
  * - no flags — a fresh session with a minted id.
  *
  * @module @deepseek-ai/dsh-tui/startup
  */
 import type { Context } from '@deepseek-ai/cordis';
+import { type ThemeName } from './theme.ts';
 /** Stable Cordis plugin name. */
 export declare const name = "tui-startup";
 /** Services required before the invocation can be resolved. */
@@ -28,21 +31,26 @@ export declare const TUI_STARTUP_SERVICE = "tuiStartup";
 export type TuiStartup = {
     readonly kind: 'fresh';
     readonly mode?: string;
+    readonly theme?: ThemeName;
 } | {
     readonly kind: 'named';
     readonly sessionId: string;
     readonly mode?: string;
+    readonly theme?: ThemeName;
 } | {
     readonly kind: 'resume';
     readonly sessionId: string;
+    readonly theme?: ThemeName;
 } | {
     readonly kind: 'latest';
+    readonly theme?: ThemeName;
 };
 export interface TuiStartupOptions {
     readonly resume?: string;
     readonly continue?: boolean;
     readonly session?: string;
     readonly mode?: string;
+    readonly theme?: ThemeName;
 }
 /** Pure option policy shared by Commander and tests. */
 export declare function resolveTuiStartup(options: TuiStartupOptions): TuiStartup;

package/lib/types/store.d.ts

@@ -1,8 +1,19 @@
 /**
  * Observable transcript store: folds session events into the projection view
  * and notifies subscribers. The renderer subscribes through
- * `useSyncExternalStore`; the runner owns event feeding. The store owns no
- * timing — listeners fire synchronously after each applied event.
+ * `useSyncExternalStore`; the runner owns event feeding.
+ *
+ * Notification coalescing: the fold stays synchronous — `getView()` always
+ * returns the latest state the moment `apply` returns — but listener
+ * notification is scheduled on a microtask and deduplicated, so N events
+ * delivered inside one synchronous drain (the zai/GLM adapter drains its
+ * token buffer in sub-millisecond bursts) produce ONE React re-render.
+ * Synchronous per-event notification instead cascades one
+ * `useSyncExternalStore` force-update per token inside a single flush; the
+ * reconciler counts those as nested passive updates and floods React's
+ * "Maximum update depth exceeded" warning past 50 events, besides rendering
+ * the whole live tree once per token. A microtask keeps latency within the
+ * same macrotask, before Ink's throttled paint.
  *
  * @module @deepseek-ai/dsh-tui/store
  */

package/lib/types/theme-panel.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The `/theme` picker (the Codex `/theme` contract): one bounded list over
+ * the three color themes — dark, light, and auto (terminal-sensed; auto
+ * falls back to dark until OSC-11 detection lands). Enter applies the row
+ * and the runner persists it; Esc closes without changing the theme.
+ *
+ * @module @deepseek-ai/dsh-tui/theme-panel
+ */
+import { type ReactElement } from 'react';
+import { type ThemeName } from './theme.ts';
+/**
+ * The /theme list: one row per theme, the current one marked with ●, the
+ * focused one with ›. Enter applies the focused theme (the runner persists
+ * it), Esc/q closes without changing anything. Colors read the ACTIVE
+ * palette, so the panel itself adapts to a light theme once applied.
+ */
+export declare function ThemePanel({ current, select, close }: {
+    /** Theme name in force (the requested name; 'auto' included). */
+    current: ThemeName;
+    /** Accept one theme name: applied immediately and persisted by the runner. */
+    select(name: ThemeName): void;
+    /** Close without changing the theme. */
+    close(): void;
+}): ReactElement;

package/lib/types/theme.d.ts

@@ -4,17 +4,141 @@
  * (`packages/client/ui-theme/src/styles/design-platform.css`). Truecolor RGB
  * rides chalk, which degrades automatically on terminals without truecolor.
  *
+ * Two palettes — `dark` (the default) and `light` — share the same token keys
+ * with different values. Painters and the palette accessor read the ACTIVE
+ * palette selected through {@link setTheme}, so a theme switch recolors every
+ * painted surface on the next render without touching call sites. Raw token
+ * consumers keep reading {@link TUI_RGB} (the dark values) until the
+ * theme-aware integration replaces those call sites with
+ * `inkColor(getPalette().token)`.
+ *
  * @module @deepseek-ai/dsh-tui/theme
  */
+/** One RGB triple for a palette token. */
+export type RgbTriple = readonly [number, number, number];
+/** Palette token keys shared by every theme. */
+export type ThemeToken = 'brand' | 'brandBright' | 'brandMid' | 'brandDeep' | 'dim' | 'success' | 'error' | 'warn' | 'text' | 'code';
+/** One full color palette: every token key mapped to an RGB triple. */
+export type ThemePalette = Readonly<Record<ThemeToken, RgbTriple>>;
+/** Selectable theme names: dark, light, or auto (terminal-sensed). */
+export type ThemeName = 'dark' | 'light' | 'auto';
+/** Valid theme names in canonical picker order. */
+export declare const THEME_NAMES: readonly ThemeName[];
 /**
- * RGB triples for the TUI, one entry per design-platform token in use.
- * Keep names and values in sync with the CSS custom properties cited inline.
+ * DeepSeek dark palette: the original TUI colors, one entry per
+ * design-platform token in use. Keep names and values in sync with the CSS
+ * custom properties cited inline.
+ */
+export declare const DARK_PALETTE: {
+    /** Primary brand blue — `--dsw-static-deepseek-500`. */
+    readonly brand: readonly [65, 118, 230];
+    /** Brighter brand blue for live/streaming emphasis — `--dsw-static-deepseek-400`. */
+    readonly brandBright: readonly [103, 158, 254];
+    /** Intermediate brand blue between brand and brandBright — `--dsw-static-deepseek-450`. */
+    readonly brandMid: readonly [86, 134, 254];
+    /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-600`. */
+    readonly brandDeep: readonly [72, 104, 178];
+    /** Muted caption gray — `--dsw-static-neutral-bluish-600`. */
+    readonly dim: readonly [129, 133, 140];
+    /** Success green — `--dsw-static-green-500`. */
+    readonly success: readonly [34, 197, 94];
+    /** Error red — `--dsw-static-red-500`. */
+    readonly error: readonly [239, 68, 68];
+    /** Warning amber — `--dsw-static-amber-500`. */
+    readonly warn: readonly [245, 158, 11];
+    /** Default foreground text — `--dsw-static-neutral-50`. */
+    readonly text: readonly [236, 240, 246];
+    /** Inline/fenced code — soft sky blue, distinct from brand accents. */
+    readonly code: readonly [125, 211, 252];
+};
+/**
+ * Light palette tuned for white terminals: the same token keys as dark with
+ * contrast-driven values (AA on a white background). Brand keeps its dark
+ * value (≈4.9:1); the bright/mid/deep blues, muted grays, and status colors
+ * deepen so they stay legible on bright backgrounds.
+ */
+export declare const LIGHT_PALETTE: {
+    /** Primary brand blue — unchanged, ≈4.9:1 AA on white. */
+    readonly brand: readonly [65, 118, 230];
+    /** Brighter brand blue deepened for white backgrounds (was 2.7:1). */
+    readonly brandBright: readonly [72, 104, 178];
+    /** Intermediate brand blue — Tailwind blue-500. */
+    readonly brandMid: readonly [59, 130, 246];
+    /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-700`. */
+    readonly brandDeep: readonly [47, 76, 143];
+    /** Muted caption gray deepened for white backgrounds. */
+    readonly dim: readonly [101, 103, 107];
+    /** Success green — Tailwind green-700. */
+    readonly success: readonly [21, 128, 61];
+    /** Error red — Tailwind red-600. */
+    readonly error: readonly [236, 19, 19];
+    /** Warning amber — Tailwind amber-700. */
+    readonly warn: readonly [180, 83, 9];
+    /** Default foreground text — near-black. */
+    readonly text: readonly [21, 21, 23];
+    /** Inline/fenced code — Tailwind cyan-700, distinct from brand accents. */
+    readonly code: readonly [14, 116, 144];
+};
+/** Every palette by theme name; auto resolves through {@link resolveTheme}. */
+export declare const PALETTES: {
+    readonly dark: {
+        /** Primary brand blue — `--dsw-static-deepseek-500`. */
+        readonly brand: readonly [65, 118, 230];
+        /** Brighter brand blue for live/streaming emphasis — `--dsw-static-deepseek-400`. */
+        readonly brandBright: readonly [103, 158, 254];
+        /** Intermediate brand blue between brand and brandBright — `--dsw-static-deepseek-450`. */
+        readonly brandMid: readonly [86, 134, 254];
+        /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-600`. */
+        readonly brandDeep: readonly [72, 104, 178];
+        /** Muted caption gray — `--dsw-static-neutral-bluish-600`. */
+        readonly dim: readonly [129, 133, 140];
+        /** Success green — `--dsw-static-green-500`. */
+        readonly success: readonly [34, 197, 94];
+        /** Error red — `--dsw-static-red-500`. */
+        readonly error: readonly [239, 68, 68];
+        /** Warning amber — `--dsw-static-amber-500`. */
+        readonly warn: readonly [245, 158, 11];
+        /** Default foreground text — `--dsw-static-neutral-50`. */
+        readonly text: readonly [236, 240, 246];
+        /** Inline/fenced code — soft sky blue, distinct from brand accents. */
+        readonly code: readonly [125, 211, 252];
+    };
+    readonly light: {
+        /** Primary brand blue — unchanged, ≈4.9:1 AA on white. */
+        readonly brand: readonly [65, 118, 230];
+        /** Brighter brand blue deepened for white backgrounds (was 2.7:1). */
+        readonly brandBright: readonly [72, 104, 178];
+        /** Intermediate brand blue — Tailwind blue-500. */
+        readonly brandMid: readonly [59, 130, 246];
+        /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-700`. */
+        readonly brandDeep: readonly [47, 76, 143];
+        /** Muted caption gray deepened for white backgrounds. */
+        readonly dim: readonly [101, 103, 107];
+        /** Success green — Tailwind green-700. */
+        readonly success: readonly [21, 128, 61];
+        /** Error red — Tailwind red-600. */
+        readonly error: readonly [236, 19, 19];
+        /** Warning amber — Tailwind amber-700. */
+        readonly warn: readonly [180, 83, 9];
+        /** Default foreground text — near-black. */
+        readonly text: readonly [21, 21, 23];
+        /** Inline/fenced code — Tailwind cyan-700, distinct from brand accents. */
+        readonly code: readonly [14, 116, 144];
+    };
+};
+/**
+ * The dark palette under its original name: call sites that predate the
+ * two-palette switch keep compiling and painting identically (the default
+ * theme IS dark). New code should read the active palette through
+ * {@link getPalette} so a theme switch reaches it.
  */
 export declare const TUI_RGB: {
     /** Primary brand blue — `--dsw-static-deepseek-500`. */
     readonly brand: readonly [65, 118, 230];
     /** Brighter brand blue for live/streaming emphasis — `--dsw-static-deepseek-400`. */
     readonly brandBright: readonly [103, 158, 254];
+    /** Intermediate brand blue between brand and brandBright — `--dsw-static-deepseek-450`. */
+    readonly brandMid: readonly [86, 134, 254];
     /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-600`. */
     readonly brandDeep: readonly [72, 104, 178];
     /** Muted caption gray — `--dsw-static-neutral-bluish-600`. */
@@ -30,6 +154,38 @@ export declare const TUI_RGB: {
     /** Inline/fenced code — soft sky blue, distinct from brand accents. */
     readonly code: readonly [125, 211, 252];
 };
+/**
+ * Resolve a theme name to the palette actually in use. `auto` detection
+ * (OSC 11 terminal background query) is a later enhancement; until it lands,
+ * auto falls back to the dark palette.
+ * @param name - the requested theme name.
+ * @returns 'dark' or 'light' — the palette key to paint with.
+ */
+export declare function resolveTheme(name: ThemeName): 'dark' | 'light';
+/**
+ * Switch the active theme: painters and {@link getPalette} reflect the new
+ * palette from the next render onward. The default is dark, so a process
+ * that never calls this paints exactly as before.
+ * @param name - the theme to activate ('auto' resolves to dark for now).
+ */
+export declare function setTheme(name: ThemeName): void;
+/**
+ * The theme name in force. Returns the requested name ('auto' included) so
+ * the /theme picker and persistence can round-trip the user's choice; the
+ * palette actually used is {@link getPalette}.
+ */
+export declare function getTheme(): ThemeName;
+/** The palette in force; theme-aware call sites read colors through it. */
+export declare function getPalette(): ThemePalette;
+/**
+ * Parse a persisted theme name: only 'light' and 'auto' survive; anything
+ * else (missing, corrupt, or unknown) falls back to the dark default.
+ * @param value - the raw parsed JSON value (expected string).
+ * @returns a valid theme name.
+ */
+export declare function parseThemeName(value: unknown): ThemeName;
+/** Ink `color` string for one RGB triple. */
+export declare function inkColor(triple: RgbTriple): string;
 /** Paint with the primary brand blue: whale, wordmark, tool names, accents. */
 export declare function brand(text: string): string;
 /** Paint with the bright brand blue: streaming output and active spinners. */

package/lib/types/version.d.ts

@@ -0,0 +1,5 @@
+/** Installed dsh-code version exposed by the terminal header. */
+/** Read one package manifest version without making terminal startup depend on it. */
+export declare function readPackageVersion(manifest?: import("url").URL): string;
+/** Version of the installed dsh-code package. */
+export declare const DSH_CODE_VERSION: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-code",
   "description": "Claude-Code-style interactive TUI bundle for DeepSeek Harness (dsh): DeepSeek-blue whale banner, live session transcript, and a blended status line",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "type": "module",
   "bin": {
     "deepseek": "./bin/deepseek.mjs",