dsh-code 0.7.0 → 0.8.0

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

@@ -9,7 +9,7 @@
  *
  * @module @deepseek-ai/dsh-tui/render/status
  */
-import type { ContextSegments, TranscriptStats } from './projection.ts';
+import type { TranscriptStats } from './projection.ts';
 /**
  * Compact token count: 517 / 12.2K / 517K / 1.2M (one decimal under three
  * digits), mirroring the web composer's StatsLine format.
@@ -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' | 'ctxSystem' | 'ctxPrompt' | 'ctxAssistant' | 'ctxThinking' | 'ctxTools';
+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;
@@ -89,33 +87,21 @@ export declare const STATUS_CYCLE_HINT = " (shift+tab to cycle)";
 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;
-/** One content-type segment of the context bar (pure data; colors live in app.ts). */
-export interface ContextSegmentSpec {
-    key: keyof ContextSegments;
-    /** Tone the footer maps to a DeepSeek blue shade. */
-    tone: StatusTone;
-    /** Labels longest → shortest; the first one fitting the segment width wins. */
-    labels: readonly string[];
-}
-/** The five content types in conversation order, dark → light blue. */
-export declare const CONTEXT_SEGMENTS: readonly ContextSegmentSpec[];
-/**
- * Render context occupancy as a segmented bar: one DeepSeek-blue run per
- * content type (system/prompt/assistant/thinking/tools), column widths
- * proportional to their estimated token share, each with a centered label
- * that shortens to fit (system→sys→s). The remaining free tail is a dim
- * track whose right edge carries the usage readout (`12.3K/1.0M 25%`,
- * shrinking to the bare percent as the tail narrows). The readout flips to
- * amber once occupancy reaches the warning threshold; the segment blues stay
- * untouched so the composition remains readable at full context. The used
- * total comes from the reported `lastPromptTokens`, never from the estimates.
- * @param segments - estimated used tokens per content type.
+/**
+ * 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(segments: ContextSegments, usedTokens: number, contextWindow: number, width: 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;
@@ -149,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. */
@@ -173,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;
 }
 /**
@@ -185,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/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/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.7.0",
+  "version": "0.8.0",
   "type": "module",
   "bin": {
     "deepseek": "./bin/deepseek.mjs",