dsh-code 0.9.0 → 1.0.0

package/src/store.ts

@@ -5,15 +5,17 @@
  *
  * 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.
+ * notification is frame-throttled (~16ms) and deduplicated. The zai/GLM
+ * adapter delivers tokens as a sustained stream of sub-millisecond,
+ * microtask-spaced bursts: per-burst notification renders at microtask
+ * cadence, which chained SyncLane `useSyncExternalStore` rerenders past
+ * React's nested-update limit ("Maximum update depth exceeded"), while a
+ * bare `setImmediate` merges a whole macrotask turn's bursts into one
+ * chunky repaint (streaming text visibly staggers). The frame budget gives
+ * both: an event ≥16ms after the last paint notifies via `setImmediate`
+ * (sub-millisecond latency for sparse/first tokens), and anything denser
+ * defers to the next 16ms boundary — a 60fps render cap that also breaks
+ * the nesting chain by construction.
  *
  * @module @deepseek-ai/dsh-tui/store
  */
@@ -21,6 +23,9 @@
 import type { SessionEvent } from '@deepseek-ai/dsh-session'
 import { createTranscriptView, projectEvent, projectEvents, type TranscriptView } from './render/projection.ts'
 
+/** Render frame budget: the notification cadence's upper bound. */
+const NOTIFY_FRAME_MS = 16
+
 /** The externally readable, event-fed transcript store for one session. */
 export interface TranscriptStore {
   /** The current view; the same object identity until an event changes it. */
@@ -47,15 +52,22 @@ export function createTranscriptStore(replay?: readonly SessionEvent[]): Transcr
   let view = replay === undefined ? createTranscriptView() : projectEvents(replay)
   const listeners = new Set<() => void>()
   let scheduled = false
+  let lastNotifyAt = 0
   const notify = (): void => {
     if (scheduled) return
     scheduled = true
-    queueMicrotask(() => {
+    const wait = NOTIFY_FRAME_MS - (Date.now() - lastNotifyAt)
+    const dispatch = (): void => {
       scheduled = false
+      lastNotifyAt = Date.now()
       for (const listener of listeners) {
         listener()
       }
-    })
+    }
+    // Sparse streams paint with setImmediate latency; a denser burst defers
+    // to the next frame boundary instead of repainting per microtask batch.
+    if (wait <= 0) setImmediate(dispatch)
+    else setTimeout(dispatch, wait)
   }
   return {
     getView: () => view,

package/src/subagents.ts

@@ -9,9 +9,9 @@
  * running state, bounded last-activity text), capped at
  * {@link MAX_SUBAGENT_ROWS}. Rows are advisory display state, rebuilt from
  * live events; nothing here persists or replays. Notification is coalesced
- * to one microtask per delivery burst, mirroring the transcript store's
- * contract (per-token synchronous notify once cascaded past React's nested
- * update limit on the GLM thinking path).
+ * 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
  */
@@ -21,6 +21,9 @@ import type { SessionEvent } from '@deepseek-ai/dsh-session'
 /** Hard row cap: a fan-out larger than this stays summarized by the head. */
 export const MAX_SUBAGENT_ROWS = 8
 
+/** Render frame budget: the notification cadence's upper bound. */
+const NOTIFY_FRAME_MS = 16
+
 /** Bounded last-activity text (plain characters, display-sliced later). */
 const MAX_ACTIVITY_CHARS = 80
 
@@ -129,13 +132,18 @@ export function createSubagentFeed(): SubagentFeedView & {
   let rows: readonly SubagentRow[] = Object.freeze([])
   const listeners = new Set<() => void>()
   let scheduled = false
+  let lastNotifyAt = 0
   const notify = (): void => {
     if (scheduled) return
     scheduled = true
-    queueMicrotask(() => {
+    const wait = NOTIFY_FRAME_MS - (Date.now() - lastNotifyAt)
+    const dispatch = (): void => {
       scheduled = false
+      lastNotifyAt = Date.now()
       for (const listener of listeners) listener()
-    })
+    }
+    if (wait <= 0) setImmediate(dispatch)
+    else setTimeout(dispatch, wait)
   }
   return {
     apply(sessionId: string, event: SessionEvent): void {

package/src/theme.ts

@@ -1,206 +1,214 @@
-/**
- * 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
- */
-
-import chalk from 'chalk'
-
-/** 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 const THEME_NAMES: readonly ThemeName[] = ['dark', 'light', 'auto']
-
-/**
- * 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 const DARK_PALETTE = {
-  /** Primary brand blue — `--dsw-static-deepseek-500`. */
-  brand: [65, 118, 230],
-  /** Brighter brand blue for live/streaming emphasis — `--dsw-static-deepseek-400`. */
-  brandBright: [103, 158, 254],
-  /** Intermediate brand blue between brand and brandBright — `--dsw-static-deepseek-450`. */
-  brandMid: [86, 134, 254],
-  /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-600`. */
-  brandDeep: [72, 104, 178],
-  /** Muted caption gray — `--dsw-static-neutral-bluish-600`. */
-  dim: [129, 133, 140],
-  /** Success green — `--dsw-static-green-500`. */
-  success: [34, 197, 94],
-  /** Error red — `--dsw-static-red-500`. */
-  error: [239, 68, 68],
-  /** Warning amber — `--dsw-static-amber-500`. */
-  warn: [245, 158, 11],
-  /** Default foreground text — `--dsw-static-neutral-50`. */
-  text: [236, 240, 246],
-  /** Inline/fenced code — soft sky blue, distinct from brand accents. */
-  code: [125, 211, 252],
-} as const satisfies ThemePalette
-
-/**
- * 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 const LIGHT_PALETTE = {
-  /** Primary brand blue — unchanged, ≈4.9:1 AA on white. */
-  brand: [65, 118, 230],
-  /** Brighter brand blue deepened for white backgrounds (was 2.7:1). */
-  brandBright: [72, 104, 178],
-  /** Intermediate brand blue — Tailwind blue-500. */
-  brandMid: [59, 130, 246],
-  /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-700`. */
-  brandDeep: [47, 76, 143],
-  /** Muted caption gray deepened for white backgrounds. */
-  dim: [101, 103, 107],
-  /** Success green — Tailwind green-700. */
-  success: [21, 128, 61],
-  /** Error red — Tailwind red-600. */
-  error: [236, 19, 19],
-  /** Warning amber — Tailwind amber-700. */
-  warn: [180, 83, 9],
-  /** Default foreground text — near-black. */
-  text: [21, 21, 23],
-  /** Inline/fenced code — Tailwind cyan-700, distinct from brand accents. */
-  code: [14, 116, 144],
-} as const satisfies ThemePalette
-
-/** Every palette by theme name; auto resolves through {@link resolveTheme}. */
-export const PALETTES = {
-  dark: DARK_PALETTE,
-  light: LIGHT_PALETTE,
-} as const satisfies Record<Exclude<ThemeName, 'auto'>, ThemePalette>
-
-/**
- * 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 const TUI_RGB = DARK_PALETTE
-
-/** The theme name in force (the requested name; 'auto' included). */
-let activeName: ThemeName = 'dark'
-
-/** The palette painters and {@link getPalette} read for the active theme. */
-let activePalette: ThemePalette = DARK_PALETTE
-
-/**
- * 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 function resolveTheme(name: ThemeName): 'dark' | 'light' {
-  return name === 'light' ? 'light' : 'dark'
-}
-
-/**
- * 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 function setTheme(name: ThemeName): void {
-  activeName = name
-  activePalette = PALETTES[resolveTheme(name)]
-}
-
-/**
- * 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 function getTheme(): ThemeName {
-  return activeName
-}
-
-/** The palette in force; theme-aware call sites read colors through it. */
-export function getPalette(): ThemePalette {
-  return activePalette
-}
-
-/**
- * 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 function parseThemeName(value: unknown): ThemeName {
-  return value === 'light' || value === 'auto' ? value : 'dark'
-}
-
-/** Ink `color` string for one RGB triple. */
-export function inkColor(triple: RgbTriple): string {
-  return `rgb(${triple[0]}, ${triple[1]}, ${triple[2]})`
-}
-
-/** Paint with the primary brand blue: whale, wordmark, tool names, accents. */
-export function brand(text: string): string {
-  return chalk.rgb(...activePalette.brand)(text)
-}
-
-/** Paint with the bright brand blue: streaming output and active spinners. */
-export function brandBright(text: string): string {
-  return chalk.rgb(...activePalette.brandBright)(text)
-}
-
-/** Paint with the deep brand blue: borders and secondary chrome. */
-export function brandDeep(text: string): string {
-  return chalk.rgb(...activePalette.brandDeep)(text)
-}
-
-/** Paint muted captions, hints, and meta lines. */
-export function dim(text: string): string {
-  return chalk.rgb(...activePalette.dim)(text)
-}
-
-/** Paint completed tool results and confirmations. */
-export function success(text: string): string {
-  return chalk.rgb(...activePalette.success)(text)
-}
-
-/** Paint failures and error entries. */
-export function error(text: string): string {
-  return chalk.rgb(...activePalette.error)(text)
-}
-
-/** Paint warnings. */
-export function warn(text: string): string {
-  return chalk.rgb(...activePalette.warn)(text)
-}
+/**
+ * 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
+ */
+
+import chalk from 'chalk'
+
+/** 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 const THEME_NAMES: readonly ThemeName[] = ['dark', 'light', 'auto']
+
+/**
+ * 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 const DARK_PALETTE = {
+  /** Primary brand blue — `--dsw-static-deepseek-500`. */
+  brand: [65, 118, 230],
+  /** Brighter brand blue for live/streaming emphasis — `--dsw-static-deepseek-400`. */
+  brandBright: [103, 158, 254],
+  /** Intermediate brand blue between brand and brandBright — `--dsw-static-deepseek-450`. */
+  brandMid: [86, 134, 254],
+  /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-600`. */
+  brandDeep: [72, 104, 178],
+  /** Muted caption gray — `--dsw-static-neutral-bluish-600`. */
+  dim: [129, 133, 140],
+  /** Success green — `--dsw-static-green-500`. */
+  success: [34, 197, 94],
+  /** Error red — `--dsw-static-red-500`. */
+  error: [239, 68, 68],
+  /** Warning amber — `--dsw-static-amber-500`. */
+  warn: [245, 158, 11],
+  /** Default foreground text — `--dsw-static-neutral-50`. */
+  text: [236, 240, 246],
+  /** Inline/fenced code — soft sky blue, distinct from brand accents. */
+  code: [125, 211, 252],
+  /** Composer three-row band base — neutral light gray, hue-free so wave tints read on it. */
+  composerBand: [46, 48, 52],
+} as const satisfies ThemePalette
+
+/**
+ * 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 const LIGHT_PALETTE = {
+  /** Primary brand blue — unchanged, ≈4.9:1 AA on white. */
+  brand: [65, 118, 230],
+  /** Brighter brand blue deepened for white backgrounds (was 2.7:1). */
+  brandBright: [72, 104, 178],
+  /** Intermediate brand blue — Tailwind blue-500. */
+  brandMid: [59, 130, 246],
+  /** Deep brand blue for secondary chrome — `--dsw-static-deepseek-700`. */
+  brandDeep: [47, 76, 143],
+  /** Muted caption gray deepened for white backgrounds. */
+  dim: [101, 103, 107],
+  /** Success green — Tailwind green-700. */
+  success: [21, 128, 61],
+  /** Error red — Tailwind red-600. */
+  error: [236, 19, 19],
+  /** Warning amber — Tailwind amber-700. */
+  warn: [180, 83, 9],
+  /** Default foreground text — near-black. */
+  text: [21, 21, 23],
+  /** Inline/fenced code — Tailwind cyan-700, distinct from brand accents. */
+  code: [14, 116, 144],
+  /** Composer three-row band base — neutral light gray, hue-free so wave tints read on it. */
+  composerBand: [229, 231, 235],
+} as const satisfies ThemePalette
+
+/** Every palette by theme name; auto resolves through {@link resolveTheme}. */
+export const PALETTES = {
+  dark: DARK_PALETTE,
+  light: LIGHT_PALETTE,
+} as const satisfies Record<Exclude<ThemeName, 'auto'>, ThemePalette>
+
+/**
+ * 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 const TUI_RGB = DARK_PALETTE
+
+/** The theme name in force (the requested name; 'auto' included). */
+let activeName: ThemeName = 'dark'
+
+/** The palette painters and {@link getPalette} read for the active theme. */
+let activePalette: ThemePalette = DARK_PALETTE
+
+/**
+ * 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 function resolveTheme(name: ThemeName): 'dark' | 'light' {
+  return name === 'light' ? 'light' : 'dark'
+}
+
+/**
+ * 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 function setTheme(name: ThemeName): void {
+  activeName = name
+  activePalette = PALETTES[resolveTheme(name)]
+}
+
+/**
+ * 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 function getTheme(): ThemeName {
+  return activeName
+}
+
+/** The palette in force; theme-aware call sites read colors through it. */
+export function getPalette(): ThemePalette {
+  return activePalette
+}
+
+/**
+ * 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 function parseThemeName(value: unknown): ThemeName {
+  return value === 'light' || value === 'auto' ? value : 'dark'
+}
+
+/** Ink `color` string for one RGB triple. */
+export function inkColor(triple: RgbTriple): string {
+  return `rgb(${triple[0]}, ${triple[1]}, ${triple[2]})`
+}
+
+/** Paint with the primary brand blue: whale, wordmark, tool names, accents. */
+export function brand(text: string): string {
+  return chalk.rgb(...activePalette.brand)(text)
+}
+
+/** Paint with the bright brand blue: streaming output and active spinners. */
+export function brandBright(text: string): string {
+  return chalk.rgb(...activePalette.brandBright)(text)
+}
+
+/** Paint with the deep brand blue: borders and secondary chrome. */
+export function brandDeep(text: string): string {
+  return chalk.rgb(...activePalette.brandDeep)(text)
+}
+
+/** Paint muted captions, hints, and meta lines. */
+export function dim(text: string): string {
+  return chalk.rgb(...activePalette.dim)(text)
+}
+
+/** Paint completed tool results and confirmations. */
+export function success(text: string): string {
+  return chalk.rgb(...activePalette.success)(text)
+}
+
+/** Paint failures and error entries. */
+export function error(text: string): string {
+  return chalk.rgb(...activePalette.error)(text)
+}
+
+/** Paint warnings. */
+export function warn(text: string): string {
+  return chalk.rgb(...activePalette.warn)(text)
+}

package/src/version.ts

@@ -1,9 +1,10 @@
 /** Installed dsh-code version exposed by the terminal header. */
 
 import { readFileSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
 
 /** Read one package manifest version without making terminal startup depend on it. */
-export function readPackageVersion(manifest = new URL('../package.json', import.meta.url)): string {
+function readPackageVersion(manifest = new URL('../package.json', import.meta.url)): string {
   try {
     const parsed = JSON.parse(readFileSync(manifest, 'utf8')) as { version?: unknown }
     return typeof parsed.version === 'string' && parsed.version.length > 0 ? parsed.version : '0.0.0'
@@ -14,3 +15,59 @@ export function readPackageVersion(manifest = new URL('../package.json', import.
 
 /** Version of the installed dsh-code package. */
 export const DSH_CODE_VERSION = readPackageVersion()
+
+/** The harness host package: the dsh CLI whose process runs the TUI plugin. */
+const DSH_HOST_PACKAGE_NAME = '@deepseek-ai/dsh'
+
+/** Parent levels above the host entry allowed to hold its package manifest. */
+const DSH_HOST_WALK_LIMIT = 4
+
+/**
+ * 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 function resolveDshHostVersion(entry: string | undefined = process.argv[1]): string | undefined {
+  if (entry === undefined || entry === '') return undefined
+  let directory = dirname(resolve(entry))
+  for (let depth = 0; depth < DSH_HOST_WALK_LIMIT; depth += 1) {
+    try {
+      const parsed = JSON.parse(readFileSync(join(directory, 'package.json'), 'utf8')) as {
+        name?: unknown
+        version?: unknown
+      }
+      if (parsed.name === DSH_HOST_PACKAGE_NAME && typeof parsed.version === 'string' && parsed.version.length > 0) {
+        return parsed.version
+      }
+    } catch {
+      // No readable manifest at this level: keep climbing.
+    }
+    const parent = dirname(directory)
+    if (parent === directory) return undefined
+    directory = parent
+  }
+  return undefined
+}
+
+let cachedDshKernelVersion: string | undefined
+let dshKernelVersionResolved = false
+
+/**
+ * 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 function dshKernelVersion(): string | undefined {
+  if (!dshKernelVersionResolved) {
+    cachedDshKernelVersion = resolveDshHostVersion()
+    dshKernelVersionResolved = true
+  }
+  return cachedDshKernelVersion
+}
+
+/** Test-only: forget the memoized kernel version so a new argv can be probed. */
+export function _resetDshKernelVersionForTests(): void {
+  cachedDshKernelVersion = undefined
+  dshKernelVersionResolved = false
+}