dsh-code 1.4.0 → 1.5.0

package/lib/session-query.mjs

@@ -139,6 +139,23 @@ async function observeStableWithSkip(engine, indexed, signal, readCold = readCol
 	}
 	throw new SessionQueryError("session-search persistence observation did not stabilize after one retry", "SESSION_QUERY_PERSISTENCE_FAILED");
 }
+/**
+* Assert the private override seam this compatibility engine relies on.
+* Harness keeps `_observeStable` private, so TypeScript cannot protect this
+* subclass when upstream renames the method or changes its call signature.
+* The exact-version launcher gate prevents unsupported hosts; this import-time
+* check additionally prevents a newly built bundle from silently mounting an
+* override the installed base will never call.
+*
+* @internal Exported for the compatibility regression.
+*/
+function assertSessionQueryOverrideContract(candidate) {
+	if (typeof candidate !== "function") throw new TypeError("session-query sqlite engine must be a constructor");
+	const prototype = candidate.prototype;
+	const method = (prototype === void 0 ? void 0 : Object.getOwnPropertyDescriptor(prototype, "_observeStable"))?.value;
+	if (typeof method !== "function" || method.length !== 2) throw new Error("incompatible @deepseek-ai/dsh-session-query-sqlite: expected _observeStable(indexed, signal)");
+}
+assertSessionQueryOverrideContract(SqliteSessionQueryEngine);
 const EngineBase = SqliteSessionQueryEngine;
 /** The engine this bundle mounts in place of the base `session-query-sqlite` row. */
 var SkipTolerantSessionQueryEngine = class extends EngineBase {
@@ -147,4 +164,4 @@ var SkipTolerantSessionQueryEngine = class extends EngineBase {
 	}
 };
 //#endregion
-export { SkipTolerantSessionQueryEngine, SkipTolerantSessionQueryEngine as default, observeStableWithSkip };
+export { SkipTolerantSessionQueryEngine, SkipTolerantSessionQueryEngine as default, assertSessionQueryOverrideContract, observeStableWithSkip };

package/lib/types/app.d.ts

@@ -42,6 +42,7 @@ import type { FilePathInspection, ImagePathInspection } from './attachments.ts';
 export { completionCandidates, stepCompletionIndex } from './completion.ts';
 import type { NoticeTone, QueueMutation } from './ui/ui-contract.ts';
 export type { NoticeTone, QueueMutation } from './ui/ui-contract.ts';
+import { type StyledLine } from './render/lines.ts';
 /** Props the runner hands the app; callbacks stay owned by the runner. */
 export interface AppProps {
     /** Event-fed transcript store for the live session. */
@@ -216,8 +217,8 @@ export interface AppProps {
     saveLanguage: (name: LanguageName) => void;
     /** Apply and persist one /theme selection; the runner owns the theme.json file. */
     saveTheme?: (name: ThemeName) => void;
-    /** Whether timed animations run at startup (animations.json; on by default
-     * — like parseAnimationsPref, only an explicit false disables them). */
+    /** Whether decorative animations run at startup (animations.json; on by
+     * default). Functional activity indicators remain live when disabled. */
     animations?: boolean;
     /** Apply and persist one /animation toggle; the runner owns the file. */
     saveAnimations?: (enabled: boolean) => void;
@@ -248,16 +249,17 @@ export declare function streamTailBodyColumns(rowColumns: number, prefix: string
 export declare function queuedInboxRows(entries: readonly TranscriptEntry[], ids: readonly string[]): readonly Extract<TranscriptEntry, {
     kind: 'pending';
 }>[];
+interface SettledPhysicalRow {
+    /** Stable one-row Static element. */
+    readonly element: ReactElement;
+    /** The same row model reused by the mutable viewport tail. */
+    readonly line: StyledLine;
+}
 interface SettledRowRecord {
-    /** The row Box element (keyed by the entry's settled index). */
-    box: ReactElement;
-    /** The roomy-prompt spacer BEFORE the row, or undefined. */
-    before: ReactElement | undefined;
-    /** The roomy-prompt spacer AFTER the row, or undefined. */
-    after: ReactElement | undefined;
-    /** Physical rows this record contributes (row body plus spacers) — the
-     * unit of the rendered-history cap. */
-    rows: number;
+    /** Physical rows for one settled entry, including roomy-prompt spacers. */
+    readonly physical: readonly SettledPhysicalRow[];
+    /** Physical rows this record contributes — the rendered-history-cap unit. */
+    readonly rows: number;
 }
 /** The incremental settled-history cache (see `computeSettledRows`). */
 interface SettledRowsCache {
@@ -277,10 +279,13 @@ interface SettledRowsCache {
     epoch: number;
     /** The terminal width the rows were wrapped for; a change forces a rebuild. */
     columns: number;
-    /** The flat row list (header + optional hint + per-entry before/box/after). */
+    /** Header/hint followed by one element per physical transcript row. */
     flat: ReactElement[];
+    /** Physical transcript rows only (header/hint excluded). */
+    physical: SettledPhysicalRow[];
     /** Settled entries dropped from the window's head (rendering only — the
-     * event log keeps everything; Ctrl+O and /export read it directly). */
+     * event log keeps everything; /export reads all of it and Ctrl+O reads its
+     * inspectable entries). */
     droppedEntries: number;
     /** Physical rows the window's entries contribute (excludes header/hint). */
     totalRows: number;
@@ -310,8 +315,9 @@ interface SettledRowsResult {
  *
  * RENDERED-HISTORY CAP: the window holds at most `rowCap` physical rows of
  * settled transcript (header and hint reserved on top). The cap exists only
- * here — the event log, the store projection, /export, Ctrl+O, and /resume
- * keep the full history. Ink 5's <Static> is a consumption counter
+ * here — the event log, the store projection, /export, and /resume keep the
+ * full history; Ctrl+O keeps its inspectable subset. Ink 5's <Static> is a
+ * consumption counter
  * (items.slice(index) keyed on length): deleting head items mid-stream while
  * appending tail items can permanently swallow new rows, so the append branch
  * NEVER drops the head — it only accounts rows and flags `needsTrim` once the

package/lib/types/composer.d.ts

@@ -116,7 +116,7 @@ export declare function Composer({ active, frozen, frozenHint, busy, descriptors
     } | undefined;
     /** Marks the accepted entry consumed (called after the fill is applied). */
     historyConsumed: () => void;
-    /** Whether timed animations run (shimmer, chase, blink, wave). */
+    /** Whether decorative animations run; caret and busy activity stay live. */
     animations: boolean;
     /** Apply and report one /animation toggle (App persists through the runner). */
     applyAnimations: (enabled: boolean) => void;

package/lib/types/locales/en.d.ts

@@ -139,7 +139,7 @@ export declare const en: {
     readonly 'cmd.theme': "switch the color theme";
     readonly 'cmd.language': "switch the interface language (/language [en|zh])";
     readonly 'cmd.rainbow': "reroll or pin the rainbow palette (/rainbow [seed])";
-    readonly 'cmd.animation': "toggle timed animations (/animation [on|off])";
+    readonly 'cmd.animation': "toggle decorative animations; shimmer and activity stay live (/animation [on|off])";
     readonly 'cmd.history': "search and recall past prompts";
     readonly 'cmd.queue': "manage messages queued for the next turn";
     readonly 'cmd.usage': "show this session token usage";
@@ -275,12 +275,12 @@ export declare const en: {
     readonly 'notice.imageCancelled': "image submission cancelled";
     readonly 'notice.themeConfigUnreadable': "theme config unreadable, using dark: {message}";
     readonly 'notice.languageConfigUnreadable': "language config unreadable, using english: {message}";
-    readonly 'notice.animationsConfigUnreadable': "animations config unreadable, animations stay on: {message}";
+    readonly 'notice.animationsConfigUnreadable': "decorative animation config unreadable, effects stay on: {message}";
     readonly 'notice.statuslineConfigUnreadable': "statusline config unreadable, using defaults: {message}";
     readonly 'notice.sessionSearchUnavailable': "session search is unavailable in this deployment";
     readonly 'notice.subagentsReadOnly': "subagent conversations are read-only";
     readonly 'notice.statuslineSaveFailed': "statusline save failed: {message}";
-    readonly 'notice.animationsSaveFailed': "animations save failed: {message}";
+    readonly 'notice.animationsSaveFailed': "decorative animation save failed: {message}";
     readonly 'notice.commandRegistryMissing': "no command registry is mounted in this composition";
     readonly 'notice.commandFallbackFailed': "command fallback failed: {message}";
     readonly 'notice.commandFailed': "command failed: {message}";
@@ -331,7 +331,7 @@ export declare const en: {
     readonly 'notice.commandAttachments': "commands cannot carry attachments; the line will be sent to the model as a prompt";
     readonly 'notice.copyFailed': "copy failed: {message}";
     readonly 'notice.vscodeKeysFailed': "vscode-keys failed: {message}";
-    readonly 'notice.animationState': "animations {state}";
+    readonly 'notice.animationState': "decorative animations {state}; activity indicators stay live";
     readonly 'notice.deleteFailed': "delete failed: {message}";
     readonly 'notice.modelChangedPlaceholder': "model → {model} · image history will be sent as text placeholders";
     readonly 'notice.modelNextStep': "model → next step uses {model}";

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

@@ -1,4 +1,12 @@
 /** Pure viewport, selection, and scrolling rules for exclusive TUI panels. */
+import type { TranscriptEntry } from './projection.ts';
+/**
+ * Remove assistant settlements that contain reasoning but no final response.
+ * They remain in the durable transcript and in the Ctrl/Alt+R fold; excluding
+ * them only from Ctrl+O navigation prevents short progress thoughts from
+ * appearing as a long run of misleading `reply` entries.
+ */
+export declare function inspectableTranscriptEntries(entries: readonly TranscriptEntry[]): readonly TranscriptEntry[];
 /** Terminal-space allocation for the inspector's one dynamic screen. */
 export interface InspectorViewport {
     /** Maximum dynamic rows, kept strictly below the terminal height. */

package/lib/types/render/projection-events.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Explicit compatibility policy for durable session events entering the TUI.
+ *
+ * The Harness event map is merge-extensible, so a reducer default branch is
+ * unavoidable: deployments may mount plugins this bundle does not know. The
+ * default must not, however, let a NEW first-party event silently bypass
+ * review. Tests compare this policy with `KNOWN_SESSION_EVENT_TYPES`; every
+ * kernel event must be deliberately classified before a Harness-line bump.
+ *
+ * @module @deepseek-ai/dsh-tui/render/projection-events
+ */
+/** How one durable event relates to the terminal transcript projection. */
+export type SessionEventDisposition = 'transcript' | 'other-surface' | 'ignored' | 'unknown';
+/** Events folded directly into `TranscriptView`. */
+export declare const TRANSCRIPT_SESSION_EVENT_TYPES: readonly ["agent/inbox/spliced", "assistant/attempt", "assistant/message", "command/done", "command/run", "compaction/end", "compaction/prune", "compaction/summary", "goal/change", "llm/retry", "llm/retry-started", "permission/preset", "plan/mode", "request/context", "request/header", "sandbox/mode", "schedule/change", "session/title", "step/start", "system/message", "todo/write", "tool-workflow/agent-end", "tool-workflow/agent-start", "tool-workflow/run-end", "tool-workflow/run-start", "tool/call", "tool/ptc-dispatch", "tool/ptc-dispatch-start", "tool/result", "turn/end", "turn/start", "user/message"];
+/**
+ * Events consumed by another TUI adapter rather than the transcript fold.
+ * Keeping these separate documents that they are visible behavior, not
+ * accidental no-ops.
+ */
+export declare const OTHER_SURFACE_SESSION_EVENT_TYPES: readonly ["agent-preset/selected", "model/selection", "subagent/catalog"];
+/**
+ * Kernel events deliberately omitted from terminal presentation. Their
+ * model-visible consequences arrive through projected message/tool/session
+ * events, while audit-only facts do not need a second transcript row.
+ */
+export declare const IGNORED_SESSION_EVENT_TYPES: readonly ["approval/asked", "approval/decided", "approval/policy", "compaction/start", "deliverables/presented", "feedback/message-delete", "feedback/message-put", "feedback/record", "hook/invoked", "hook/result", "session-log-deepseek/delivery-accepted", "session/end-seed", "session/title-llm-request", "step/end", "subagent/descriptor", "subagent/model-selection-policy", "team/member", "team/message/delivered", "team/message/queued", "team/task", "web/deepseek-search-llm-request"];
+/**
+ * Classify a durable event without rejecting merge-extensible plugin events.
+ * `unknown` remains a runtime no-op for forward/plugin compatibility; the
+ * known-event coverage test is what makes a first-party addition fail CI.
+ */
+export declare function sessionEventDisposition(type: string): SessionEventDisposition;

package/lib/types/render/transcript-viewport.d.ts

@@ -0,0 +1,32 @@
+/** Physical-row viewport state for native scrollback plus a bottom-anchored tail. */
+export interface TranscriptViewportCursor {
+    readonly sessionKey: string;
+    readonly epoch: number;
+    readonly flushedRows: number;
+}
+export interface TranscriptViewportInput {
+    readonly sessionKey: string;
+    readonly epoch: number;
+    /** Physical durable transcript rows in the current rendered-history window. */
+    readonly totalRows: number;
+    /** Maximum durable rows retained outside Static for the live viewport. */
+    readonly retainedRows: number;
+}
+export interface TranscriptViewportStep {
+    readonly cursor: TranscriptViewportCursor;
+    /** Durable physical rows emitted through Static. */
+    readonly staticRows: number;
+    /** Durable physical rows still available to the live viewport. */
+    readonly liveRows: number;
+}
+/**
+ * Advance the monotonic physical-row flush cursor.
+ *
+ * Ordinary renders never pull a row back out of native scrollback. A source-
+ * backed replay (epoch change) flushes the complete durable window exactly
+ * once after the caller clears/remounts Static; subsequent durable rows start
+ * a fresh retained tail. Session/reset shrink starts from the new source.
+ */
+export declare function advanceTranscriptViewport(previous: TranscriptViewportCursor, input: TranscriptViewportInput): TranscriptViewportStep;
+/** Real history rows that fit beside the currently painted stream/tool rows. */
+export declare function visibleTranscriptRows(historyRows: number, occupiedRows: number, capacity: number): number;

package/lib/types/runner/session-io.d.ts

@@ -38,6 +38,17 @@ export interface SessionIo {
     /** Render one session's whole transcript as export Markdown. */
     readonly loadSessionTranscript: (id: string, signal?: AbortSignal) => Promise<string>;
 }
+/** Maximum session artifact directories inspected at once by the picker. */
+export declare const SESSION_ARTIFACT_READ_CONCURRENCY = 16;
+/**
+ * Map a collection with a fixed worker count while preserving input order.
+ * The picker may own thousands of persisted sessions; an unbounded
+ * `Promise.all` turns those into one filesystem burst and can exhaust handles
+ * on Windows or remote filesystems.
+ *
+ * @internal Exported for the deterministic concurrency regression.
+ */
+export declare function mapConcurrent<T, R>(items: readonly T[], concurrency: number, mapper: (item: T, index: number) => Promise<R>): Promise<R[]>;
 /**
  * Bind the session IO to one runner's services.
  * @param services - the query engine, persistence, and the live-session probe.

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

@@ -81,6 +81,17 @@ export declare function observeStableWithSkip(engine: EngineSurface, indexed: Re
     persisted: Map<SessionId, ObservedPersistedSession>;
     live: Map<SessionId, ObservedSession>;
 }>;
+/**
+ * Assert the private override seam this compatibility engine relies on.
+ * Harness keeps `_observeStable` private, so TypeScript cannot protect this
+ * subclass when upstream renames the method or changes its call signature.
+ * The exact-version launcher gate prevents unsupported hosts; this import-time
+ * check additionally prevents a newly built bundle from silently mounting an
+ * override the installed base will never call.
+ *
+ * @internal Exported for the compatibility regression.
+ */
+export declare function assertSessionQueryOverrideContract(candidate: unknown): void;
 declare const EngineBase: abstract new (ctx: never, config: Config) => EngineSurface & object;
 /** The engine this bundle mounts in place of the base `session-query-sqlite` row. */
 export declare class SkipTolerantSessionQueryEngine extends EngineBase {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-code",
   "description": "DeepSeek Harness CLI core bundle: interactive coding terminal, durable sessions, and model management for dsh --profile cli",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "packageManager": "pnpm@12.4.1",
   "type": "module",
   "bin": {
@@ -65,7 +65,8 @@
     "typecheck:tests": "tsc -p tsconfig.test.json --noEmit",
     "lint": "eslint . --max-warnings 0",
     "lint:fix": "eslint . --fix --max-warnings 0",
-    "verify": "pnpm lint && pnpm typecheck && pnpm typecheck:tests && pnpm test",
+    "perf:check": "tsx scripts/check-performance.ts",
+    "verify": "pnpm lint && pnpm typecheck && pnpm typecheck:tests && pnpm test && pnpm perf:check",
     "gen:whale": "tsx scripts/gen-whale-glyph.ts",
     "prepare": "pnpm build",
     "prepublishOnly": "pnpm audit:prod && pnpm exec tsx scripts/check-release.ts --package-version && pnpm verify && pnpm build"