@toddzheng024/dscode-bundle 0.1.0

package/vendor/tui/types/subagents.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Live subagent activity feed: a bounded, display-only projection of CHILD
+ * session events. The transcript store folds only the root session (the
+ * durable truth this TUI renders); subagent conversations are their own
+ * sessions, and before this module their events were dropped entirely —
+ * a running subagent was invisible until its parent tool call settled.
+ *
+ * This is NOT a second transcript: each child folds to ONE row (label,
+ * running state, bounded last-activity text), capped at
+ * {@link MAX_SUBAGENT_ROWS}. The cap is a display budget, not a fan-out
+ * limit: a new running child evicts the OLDEST settled row when one
+ * exists, and while every row is busy the newcomer waits off-screen — but
+ * the observed-session total (getTotalSeen) keeps counting, so status
+ * totals never under-report the fan-out. Rows are advisory display
+ * state, rebuilt from live events; nothing here persists or replays.
+ * Notification is coalesced
+ * by the same ~16ms frame throttle as the transcript store (per-burst
+ * microtask notify chained SyncLane rerenders past React's nested update
+ * limit; a bare macrotask merge repaints a whole turn's bursts at once).
+ *
+ * @module @deepseek-ai/dsh-code/subagents
+ */
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+/** Hard row cap: overflow evicts the oldest settled row; a fully busy feed waits. */
+export declare const MAX_SUBAGENT_ROWS = 8;
+/** One live subagent row in the feed. */
+export interface SubagentRow {
+    /** Child session id. */
+    readonly id: string;
+    /** Display label (session title when observed, else a short id form). */
+    readonly label: string;
+    /** Coarse lifecycle state folded from the child's events. */
+    readonly state: 'running' | 'idle' | 'done';
+    /** Bounded last-activity text for the status line. */
+    readonly activity: string;
+    /** Last fold time (ms, event clock) — newest-first ordering key. */
+    readonly updatedAt: number;
+}
+/** The read-only snapshot surface the renderer subscribes to. */
+export interface SubagentFeedView {
+    /** Subscribe to feed changes; returns the unsubscribe function. */
+    subscribe(listener: () => void): () => void;
+    /** Read the current rows (identity-stable between changes). */
+    getSnapshot(): readonly SubagentRow[];
+    /**
+     * Distinct child sessions observed since the last reset. The row cap is
+     * a display budget, not a count of the fan-out; totals surface this.
+     */
+    getTotalSeen(): number;
+}
+/**
+ * Fold one child-session event into its feed row (pure).
+ * Unknown event kinds leave the row untouched.
+ * @param previous - the row's current state, when any.
+ * @param sessionId - the child session id.
+ * @param event - the child session event.
+ * @returns the next row state.
+ */
+export declare function foldSubagentRow(previous: SubagentRow | undefined, sessionId: string, event: SessionEvent): SubagentRow;
+/**
+ * Create one subagent feed. `apply` folds a child event (the caller gates
+ * which sessions are children); `reset` clears on a session switch. Row
+ * order is first-seen; the snapshot array is frozen and only replaced when
+ * a row actually changed.
+ * @returns the mutable feed handle plus its `SubagentFeedView`.
+ */
+export declare function createSubagentFeed(): SubagentFeedView & {
+    apply(sessionId: string, event: SessionEvent): void;
+    reset(): void;
+};

package/vendor/tui/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/vendor/tui/types/theme.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Terminal color tokens for the dsh TUI, mapped from the product design
+ * platform's DeepSeek palette
+ * (`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' | 'composerBand';
+/** 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[];
+/**
+ * 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];
+    /** Composer three-row band base — neutral light gray, hue-free so wave tints read on it. */
+    readonly composerBand: readonly [46, 48, 52];
+};
+/**
+ * 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];
+    /** Composer three-row band base — neutral light gray, hue-free so wave tints read on it. */
+    readonly composerBand: readonly [229, 231, 235];
+};
+/** 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];
+        /** Composer three-row band base — neutral light gray, hue-free so wave tints read on it. */
+        readonly composerBand: readonly [46, 48, 52];
+    };
+    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];
+        /** Composer three-row band base — neutral light gray, hue-free so wave tints read on it. */
+        readonly composerBand: readonly [229, 231, 235];
+    };
+};
+/**
+ * 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.
+ *
+ * @deprecated Read the active palette through {@link getPalette}; this
+ * compatibility alias is removed in the next minor release.
+ */
+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`. */
+    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];
+    /** Composer three-row band base — neutral light gray, hue-free so wave tints read on it. */
+    readonly composerBand: readonly [46, 48, 52];
+};
+/**
+ * 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. */
+export declare function brandBright(text: string): string;
+/** Paint with the deep brand blue: borders and secondary chrome. */
+export declare function brandDeep(text: string): string;
+/** Paint muted captions, hints, and meta lines. */
+export declare function dim(text: string): string;
+/** Paint completed tool results and confirmations. */
+export declare function success(text: string): string;
+/** Paint failures and error entries. */
+export declare function error(text: string): string;
+/** Paint warnings. */
+export declare function warn(text: string): string;

package/vendor/tui/types/version.d.ts

@@ -0,0 +1,18 @@
+/** Installed dsh-code version exposed by the terminal header. */
+/** Version of the installed dsh-code package. */
+export declare const DSH_CODE_VERSION: string;
+/**
+ * Resolve the running dsh CLI host's version from its entry file
+ * (`process.argv[1]`, e.g. `.../@deepseek-ai/dsh/lib/bin.js`). Only a manifest
+ * literally named `@deepseek-ai/dsh` counts, so an unrelated entry (vitest, a
+ * plain node script) resolves to undefined instead of faking a kernel version.
+ */
+export declare function resolveDshHostVersion(entry?: string | undefined): string | undefined;
+/**
+ * The dsh kernel version the TUI runs on, memoized after the first probe: the
+ * host process never changes within a run, and the header reads this on every
+ * Static replay.
+ */
+export declare function dshKernelVersion(): string | undefined;
+/** Test-only: forget the memoized kernel version so a new argv can be probed. */
+export declare function _resetDshKernelVersionForTests(): void;

package/vendor/tui/types/whale-glyph.d.ts

@@ -0,0 +1,6 @@
+/** Half-block whale glyph rows; render with the brand color. */
+export declare const WHALE_GLYPH: readonly string[];
+/** Fixed glyph width in terminal columns. */
+export declare const WHALE_GLYPH_COLUMNS = 26;
+/** Fixed glyph height in half-block rows. */
+export declare const WHALE_GLYPH_ROWS = 8;