dsh-code 1.0.1 → 1.0.2

package/lib/types/app.d.ts

@@ -26,7 +26,7 @@ import type { ModelDirectory, ModelRow } from './models.ts';
 import type { ProviderConfiguration, ProviderSettingsDirectory, ProviderTargetView } from './provider-settings.ts';
 import type { QuestionStore } from './questions.ts';
 import type { SkillsView, SkillRow } from './skills.ts';
-import type { MentionCandidate } from './mentions.ts';
+import { type MentionCandidate } from './mentions.ts';
 import type { SubagentFeedView } from './subagents.ts';
 import { type JobRow } from './kernel-panels.ts';
 import type { PresetRow } from './presets.ts';
@@ -85,7 +85,7 @@ export interface AppProps {
     /** Validate draft image paths without committing attachment objects. */
     inspectImages(paths: readonly string[]): Promise<readonly ImagePathInspection[]>;
     /** Validate, normalize and persist images immediately before submission. */
-    prepareImages(paths: readonly string[]): Promise<readonly ImageBlock[]>;
+    prepareImages(paths: readonly string[], signal?: AbortSignal): Promise<readonly ImageBlock[]>;
     /** Apply one /model selection (with an advertised reasoning effort, when picked); returns the display label. */
     selectModel(row: ModelRow, effortId?: string): string;
     /** The /subagent override label, '' when delegated agents follow the current model. */
@@ -164,17 +164,6 @@ export interface AppProps {
     /** Cancel one queued inbox message by identity (Delete on the empty composer). */
     cancelQueued(messageId: string): void;
 }
-/**
- * One-row editor window keeping the logical cursor visible in long drafts.
- * The caret and its surroundings slice at grapheme boundaries: splitting a
- * star-plane surrogate pair would render an isolated half under the block
- * caret with a width the terminal never draws.
- */
-export declare function editorWindow(value: string, cursor: number, columns: number): {
-    before: string;
-    caret: string;
-    after: string;
-};
 /** One completion candidate row. */
 interface CompletionCandidate {
     /** Insertion text for the command name (with leading slash). */

package/lib/types/attachments.d.ts

@@ -17,4 +17,4 @@ export declare function parsePastedImagePaths(input: string): readonly string[];
 /** Validate path, byte size and encoded signature without writing an attachment object. */
 export declare function inspectImagePaths(paths: readonly string[], attachments: AttachmentStore | undefined, cwd?: string): Promise<readonly ImagePathInspection[]>;
 /** Read, validate, and persist an ordered image path list as model content blocks. */
-export declare function saveImagePaths(paths: readonly string[], attachments: AttachmentStore | undefined): Promise<readonly ImageBlock[]>;
+export declare function saveImagePaths(paths: readonly string[], attachments: AttachmentStore | undefined, signal?: AbortSignal): Promise<readonly ImageBlock[]>;

package/lib/types/keyboard.d.ts

@@ -19,10 +19,26 @@
 export declare const KEYBOARD_ENHANCE_ENABLE = "\u001B[>4;0m\u001B[>5u";
 /** Pop the enhancement stack and reset modifyOtherKeys (exit path). */
 export declare const KEYBOARD_ENHANCE_DISABLE = "\u001B[<u\u001B[>4;0m";
+/** Explicit environment overrides for terminal keyboard enhancement. */
+export declare const DSH_DISABLE_KEYBOARD_ENHANCEMENT = "DSH_DISABLE_KEYBOARD_ENHANCEMENT";
+export declare const DSH_ENABLE_KEYBOARD_ENHANCEMENT = "DSH_ENABLE_KEYBOARD_ENHANCEMENT";
+/** True when the process is running inside the VS Code integrated terminal. */
+export declare function isVsCodeTerminalEnv(env?: NodeJS.ProcessEnv): boolean;
+/** Whether to push Kitty keyboard enhancement for the current terminal. */
+export declare function shouldEnableKeyboardEnhancement(env?: NodeJS.ProcessEnv): boolean;
 /** Enable bracketed paste reporting. */
 export declare const BRACKETED_PASTE_ENABLE = "\u001B[?2004h";
 /** Disable bracketed paste reporting. */
 export declare const BRACKETED_PASTE_DISABLE = "\u001B[?2004l";
+/** Enable terminal focus-in/focus-out reporting (xterm focus protocol). */
+export declare const TERMINAL_FOCUS_REPORT_ENABLE = "\u001B[?1004h";
+/** Disable terminal focus-in/focus-out reporting. */
+export declare const TERMINAL_FOCUS_REPORT_DISABLE = "\u001B[?1004l";
+/**
+ * Remove xterm focus reports from one input chunk and update the caller's
+ * focus state. Focus reports are terminal protocol, not composer text.
+ */
+export declare function stripTerminalFocusEvents(chunk: string, onFocus: (focused: boolean) => void): string;
 /** Bracketed paste markers as Ink delivers them (it strips the leading ESC). */
 export declare const PASTE_START_MARKER = "[200~";
 export declare const PASTE_END_MARKER = "[201~";
@@ -39,3 +55,18 @@ export declare function stripPasteMarkers(text: string): string;
  * unaffected.
  */
 export declare function normalizeKeyboardChunk(chunk: string): string;
+/** Editor actions Ink cannot distinguish reliably when terminal bytes batch. */
+export type RawEditorToken = {
+    readonly kind: 'text';
+    readonly text: string;
+} | {
+    readonly kind: 'home' | 'end' | 'delete-backward' | 'delete-word-backward' | 'delete-forward' | 'delete-word-forward';
+};
+/**
+ * Tokenize a stdin chunk containing at least one editor-only key. Ink calls
+ * `useInput` once for a pasted/batched chunk, so preserving each action here
+ * prevents repeated Backspace/Home/End/Delete presses from collapsing into
+ * one blurred key event. Unknown escape sequences return undefined and stay
+ * under Ink's ownership.
+ */
+export declare function tokenizeRawEditorChunk(chunk: string): readonly RawEditorToken[] | undefined;

package/lib/types/mentions.d.ts

@@ -44,6 +44,8 @@ export interface PreparedMention {
     /** Aggregated snapshot for `agent.inject()`, undefined without references. */
     additionalContext?: import('@deepseek-ai/dsh-session').UserMessage;
 }
+/** Whether a mention token is already navigating a filesystem path. */
+export declare function isPathLikeMentionQuery(query: string): boolean;
 /** The mention API the input editor and the runner share. */
 export interface MentionsApi {
     /** Ranked menu candidates for the typed `@` query. */

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

@@ -1,9 +1,8 @@
 /**
- * Terminal animation frame tables derived from the web design language:
- * the StateDot "ongoing" pixel chase (3×3 ring, 125ms flat-hold brightness
- * steps, 1s cycle) becomes the full-ring clockwise braille chase in
- * {@link BUSY_CHASE_FRAMES}, and the streaming caret blink is the
- * Claude-Code convention.
+ * Terminal animation helpers derived from the web design language:
+ * thinking uses Codex's slow shimmer sweep, the busy composer marker uses the
+ * original braille chase, and the streaming caret blink is the Claude-Code
+ * convention.
  *
  * The DeepSeek model-switch easter egg ports Codex's effort-ignition "Wave"
  * style (`codex-rs/tui/src/bottom_pane/effort_ignition_styles.rs`): switching
@@ -17,14 +16,31 @@
  * @module @deepseek-ai/dsh-code/render/animations
  */
 import type { RgbTriple } from '../theme.ts';
-/**
- * The web StateDot "ongoing" chase in terminal form: three cells of the 3×3
- * ring trail clockwise around the eight outer positions, one braille glyph
- * per step — 8 frames × 125ms = the web's 1s cycle.
- */
+/** Cadence for the original busy braille chase (8 frames × 125ms = 1s). */
+export declare const BUSY_CHASE_TICK_MS = 125;
+/** Original terminal StateDot chase frames. */
 export declare const BUSY_CHASE_FRAMES: readonly ["⣾", "⣽", "⣻", "⢿", "⡿", "⣟", "⣯", "⣷"];
-/** Chase frame for a monotonic tick (the busy composer/Deep-diving marker). */
+/** Chase frame for a monotonic tick. */
 export declare function busyChaseFrame(tick: number): string;
+/** Clock cadence for the Codex-style Deep diving shimmer. */
+export declare const DEEP_DIVING_SHIMMER_TICK_MS = 33;
+/** Codex shimmer timing and geometry. */
+export declare const DEEP_DIVING_SHIMMER_DURATION_MS = 2000;
+export declare const DEEP_DIVING_SHIMMER_PADDING = 10;
+export declare const DEEP_DIVING_SHIMMER_HALF_WIDTH = 5;
+export declare const DEEP_DIVING_SPARK_BREATH_DURATION_MS = 2000;
+/**
+ * Codex's 2-second shimmer sweep, expressed in terminal ticks. The sweep has
+ * ten virtual columns of padding on either side and a five-column cosine
+ * highlight band, so the text changes gently rather than cycling rapidly.
+ */
+export declare function deepDivingShimmerIntensity(index: number, tick: number, graphemeCount: number): number;
+/** Blue RGB color for one grapheme in the Codex-style shimmer. */
+export declare function deepDivingGradientColor(index: number, tick: number, graphemeCount: number, base: RgbTriple, highlight: RgbTriple): RgbTriple;
+/** Smooth breathing intensity for the always-visible Deep diving sparkle. */
+export declare function deepDivingSparkIntensity(tick: number): number;
+/** Blue RGB color for the breathing Deep diving sparkle. */
+export declare function deepDivingSparkColor(tick: number, base: RgbTriple, highlight: RgbTriple): RgbTriple;
 /** Caret visibility: half the ticks on, half off (530ms blink). */
 export declare function caretVisible(tick: number): boolean;
 /**

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

@@ -8,9 +8,8 @@
  * grapheme boundaries) so the React state stays two primitives
  * (value, cursor) and every operation here stays pure and testable.
  *
- * Word motion deviates from Codex's UAX#29 segmentation in one deliberate
- * way: a run of same-class characters is ONE piece, so a CJK run moves as a
- * single word (two hanzi are one Alt+B step, not two).
+ * Word motion follows Codex's piece semantics: whitespace separates runs,
+ * punctuation runs stay atomic, and each Han grapheme is its own boundary.
  *
  * @module @deepseek-ai/dsh-code/render/editor
  */
@@ -79,6 +78,15 @@ export interface CaretSite {
     row: number;
     column: number;
 }
+/** Text slices for rendering one physical row with at most one caret. */
+export interface EditorRowParts {
+    readonly before: string;
+    readonly caret: string;
+    readonly after: string;
+    readonly hasCaret: boolean;
+}
+/** Split one row around the authoritative caret; every other row stays whole. */
+export declare function editorRowParts(row: EditorRowModel, rowIndex: number, caretRow: number, cursor: number, caretEnabled?: boolean): EditorRowParts;
 /** Map a cursor offset to its caret site on the wrapped rows. */
 export declare function caretSite(model: EditorModel, offset: number): CaretSite;
 /**
@@ -123,6 +131,23 @@ export declare function killToLineStart(value: string, cursor: number): EditResu
 export declare function killToLineEnd(value: string, cursor: number): EditResult;
 /** Insert sanitized text at the cursor. */
 export declare function insertText(value: string, cursor: number, text: string): EditResult;
+/** Ctrl+A: current logical line start, then the previous line start on repeat. */
+export declare function moveToLineStart(value: string, cursor: number, crossOnRepeat: boolean): number;
+/** Ctrl+E: current logical line end, then the next line end on repeat. */
+export declare function moveToLineEnd(value: string, cursor: number, crossOnRepeat: boolean): number;
+/** One stable text range captured before an asynchronous draft operation. */
+export interface DraftRange {
+    readonly start: number;
+    readonly end: number;
+}
+/**
+ * Remap a captured range when all intervening edits are wholly before or
+ * wholly after it. An edit overlapping either boundary invalidates the
+ * anchor instead of guessing and inserting content at a surprising place.
+ */
+export declare function remapStableRange(original: string, current: string, range: DraftRange): DraftRange | undefined;
+/** Replace a current range while preserving a cursor moved after capture. */
+export declare function replaceRangePreservingCursor(value: string, cursor: number, range: DraftRange, replacement: string): EditResult;
 /**
  * Composer editor row budget: the editor itself never grows past this many
  * physical rows; deeper drafts scroll internally to keep the caret visible.
@@ -130,8 +155,8 @@ export declare function insertText(value: string, cursor: number, text: string):
  */
 export declare function composerMaxRows(terminalRows: number): number;
 /**
- * Codex `should_handle_navigation`: Up/Down walk history only from an empty
- * draft, or from a boundary of a draft that still exactly matches the last
- * recalled entry. Any interior cursor position keeps vertical caret movement.
+ * History navigation starts with Up on an empty draft, or after visual
+ * movement has reached the directional text edge of an unchanged recalled
+ * entry. Every other position remains under textarea movement.
  */
-export declare function shouldRecallNavigate(value: string, cursor: number, lastRecalled: string | null): boolean;
+export declare function shouldRecallNavigate(value: string, cursor: number, lastRecalled: string | null, direction: -1 | 1): boolean;

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

@@ -36,6 +36,6 @@ export declare function reasoningLines(text: string, columns: number): readonly
  * Wrapped continuations keep a hanging indent aligned under each row's
  * content (Codex history-cell alignment) instead of resetting to column 0.
  */
-export declare function transcriptEntryLines(entry: TranscriptEntry, columns: number, showReasoning?: boolean, reasoningToggleHint?: boolean): readonly StyledLine[];
+export declare function transcriptEntryLines(entry: TranscriptEntry, columns: number, showReasoning?: boolean, reasoningToggleHint?: boolean, showToolDetails?: boolean): readonly StyledLine[];
 /** Settled-history variant carrying the Ctrl+R reasoning fold. */
 export declare function settledEntryLines(entry: TranscriptEntry, columns: number, showReasoning: boolean): readonly StyledLine[];

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.0.1",
+  "version": "1.0.2",
   "type": "module",
   "bin": {
     "deepseek": "./bin/deepseek.mjs",