dsh-code 0.2.0 → 0.3.0

package/lib/types/app.d.ts

@@ -18,13 +18,17 @@ import type { TranscriptStore } from './store.ts';
 import type { ApprovalStore } from './approval.ts';
 import type { CommandsView } from './commands.ts';
 import type { ModelDirectory, ModelRow } from './models.ts';
+import type { QuestionStore } from './questions.ts';
 import type { SkillsView } from './skills.ts';
+import type { MentionCandidate } from './mentions.ts';
 /** Props the runner hands the app; callbacks stay owned by the runner. */
 export interface AppProps {
     /** Event-fed transcript store for the live session. */
     store: TranscriptStore;
     /** Approval-question store fed by the answerer listener. */
     approval: ApprovalStore;
+    /** ask_user_question store fed by the single UI provider. */
+    questions: QuestionStore;
     /** Live slash-command descriptor list (completion candidates). */
     commands: CommandsView;
     /** Live user-invocable skill catalog (completion candidates). */
@@ -49,12 +53,37 @@ export interface AppProps {
     quit(): void;
     /** Load the selectable model directory (called when /model opens). */
     loadModels(): Promise<ModelDirectory>;
+    /** Load @mention candidates for the typed query (files + sessions). */
+    loadMentions(query: string, signal?: AbortSignal): Promise<readonly MentionCandidate[]>;
     /** Apply one /model selection; returns the display label. */
     selectModel(row: ModelRow): string;
+    /** Cycle to the next permission preset (Shift+Tab); returns the new label. */
+    cyclePermission(): string;
     /** Registers the app's notice channel with the runner (called once on mount). */
     onBridgeReady(bridge: {
         notify(text: string): void;
     }): void;
 }
+/** One completion candidate row. */
+interface CompletionCandidate {
+    /** Insertion text for the command name (with leading slash). */
+    label: string;
+    /** Human-readable description shown beside the label. */
+    description: string;
+    /** Candidate origin; skills land the same literal text but route through the prompt. */
+    origin: 'command' | 'skill' | 'mention';
+}
+/** The completion menu snapshot the input editor publishes to the app. */
+export interface MenuState {
+    /** Whether the menu is on screen (slash or @mention). */
+    active: boolean;
+    /** Whether the menu is driven by an @mention token. */
+    mention: boolean;
+    /** Highlighted candidate index (wraps by row count). */
+    index: number;
+    /** Rendered rows in display order. */
+    rows: readonly CompletionCandidate[];
+}
 /** The whole terminal app; state arrives via the store, output via Ink. */
 export declare function App(props: AppProps): ReactElement;
+export {};

package/lib/types/mentions.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Workspace @mention support: file candidates from a bounded async scan of
+ * the session cwd, session candidates from the opt-in `sessionReferenceResolver`
+ * service, and submission preparation through its `prepare()` API. Picked
+ * session mentions land as canonical `@[label](dsh-session:…)` tokens; on
+ * submit the text is parsed back into readable `@label` text plus structured
+ * references, snapshots are injected via `agent.inject()` before the readable
+ * message wakes the driver (`followup` idle, `steer` running) — exactly the
+ * upstream README's wiring.
+ *
+ * @module @deepseek-ai/dsh-code/mentions
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import { parseSessionReferenceText, type SessionReferenceCandidate, type SessionReferenceInput } from '@deepseek-ai/dsh-session-reference';
+/** Parsed submission text: readable text plus structured references. */
+type ParsedSessionReferenceText = ReturnType<typeof parseSessionReferenceText>;
+/** One filesystem entry the @ menu can complete. */
+export interface FileCandidate {
+    /** Workspace-relative path with forward slashes. */
+    path: string;
+    /** Entry kind; directories insert with a trailing slash. */
+    kind: 'file' | 'directory';
+}
+/** One merged menu candidate (files and sessions, already ranked). */
+export interface MentionCandidate {
+    /** Text inserted after the `@` (directories carry a trailing slash). */
+    label: string;
+    /** Human-readable origin shown beside the label. */
+    description: string;
+    /** Origin kind for icon/coloring decisions. */
+    kind: 'file' | 'directory' | 'session';
+}
+/** Prepared submission: readable content plus optional injected context. */
+export interface PreparedMention {
+    /** Readable text with mention tokens normalized to `@label`. */
+    text: string;
+    /** Structured source sessions in appearance order (empty when none). */
+    references: SessionReferenceInput[];
+    /** Aggregated snapshot for `agent.inject()`, undefined without references. */
+    additionalContext?: import('@deepseek-ai/dsh-session').UserMessage;
+}
+/** Bounded async BFS scan of a workspace; unreadable entries are skipped. */
+export declare function scanWorkspaceFiles(root: string, signal?: AbortSignal): Promise<readonly FileCandidate[]>;
+/** The mention API the input editor and the runner share. */
+export interface MentionsApi {
+    /** Scanned workspace files, cached across one session. */
+    files(): Promise<readonly FileCandidate[]>;
+    /** Ranked menu candidates for the typed `@` query. */
+    candidates(query: string, signal?: AbortSignal): Promise<readonly MentionCandidate[]>;
+    /** Parse submission text into readable text plus structured references. */
+    parse(text: string): ParsedSessionReferenceText;
+    /**
+     * Snapshot references and build the injected context. Throws the service's
+     * typed error on failure — the caller restores the draft and notifies.
+     */
+    prepare(parsed: ParsedSessionReferenceText, signal?: AbortSignal): Promise<PreparedMention>;
+    /** Canonical mention token for a picked session candidate. */
+    sessionMention(candidate: SessionReferenceCandidate): string;
+}
+/**
+ * Create the mention API for one agent's workspace. A missing
+ * session-reference service degrades to file mentions only (the scan still
+ * works); `prepare` then passes text through untouched.
+ * @param ctx - context carrying the optional `sessionReferenceResolver`.
+ * @param agent - the session owner; excluded from its own candidates.
+ * @param cwd - workspace root to scan.
+ */
+export declare function createMentions(ctx: Context, agent: Agent, cwd: string): MentionsApi;
+export {};

package/lib/types/questions.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The terminal ask_user_question provider: registers the single UI provider
+ * on `ctx.userQuestions` and drives it with a FIFO queue — one question
+ * request on screen at a time, everything else waiting — then resolves the
+ * collected answers back into the tool's promise. The community TUI proved
+ * this exact pipeline shape; here the dialog is an Ink bar instead of a
+ * pi-tui inline modal.
+ *
+ * Plan reviews (`exit_plan_mode`) arrive through the same service with an
+ * `intent: { kind: 'plan-review' }` — the renderer highlights the approve
+ * option; the answer encoding is identical either way.
+ *
+ * @module @deepseek-ai/dsh-code/questions
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type AskUserQuestionAnswer, type AskUserQuestionRequest } from '@deepseek-ai/dsh-user-questions';
+/** One question request waiting on the human, with its settle channels. */
+export interface PendingQuestion {
+    /** The request the renderer walks through question by question. */
+    request: AskUserQuestionRequest;
+    /** Resolve the provider promise with the collected answers. */
+    resolve(answers: AskUserQuestionAnswer): void;
+    /** Reject the provider promise as aborted (also used for Esc cancel). */
+    reject(error: Error): void;
+}
+/** The pending-question snapshot the renderer subscribes to. */
+export interface QuestionSnapshot {
+    /** The active request, or undefined when nothing is being asked. */
+    pending: PendingQuestion | undefined;
+}
+/** Store the pending question lands in; the renderer reads, the provider writes. */
+export interface QuestionStore {
+    /** Subscribe to pending-state changes; returns the unsubscribe function. */
+    subscribe(listener: () => void): () => void;
+    /** Read the current snapshot (identity-stable between changes). */
+    getSnapshot(): QuestionSnapshot;
+    /** Submit the collected answers for the active request and advance the queue. */
+    submit(pending: PendingQuestion, answers: AskUserQuestionAnswer): void;
+    /** Cancel the active request (Esc) — rejects ASK_ABORTED and advances the queue. */
+    cancel(pending: PendingQuestion): void;
+}
+/**
+ * Mount the single `ctx.userQuestions` UI provider over a FIFO queue.
+ * @param ctx - context carrying the `userQuestions` service (dsh-base).
+ * @returns the store the renderer subscribes to; a context without the
+ * service yields a permanently empty store.
+ */
+export declare function mountQuestionProvider(ctx: Context): QuestionStore;

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

@@ -0,0 +1,15 @@
+/**
+ * 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 single-cell stepped pulse below, and the
+ * streaming caret blink is the Claude-Code convention. Pure functions only —
+ * the Ink layer owns timers and colors.
+ *
+ * @module @deepseek-ai/dsh-code/render/animations
+ */
+/** Single-cell stepped pulse: flat holds mirroring the web's 125ms keyframes. */
+export declare const PULSE_FRAMES: readonly ["█", "█", "▆", "▃", "▁", "▃", "▆", "█"];
+/** Pulse frame for a monotonic tick. */
+export declare function pulseFrame(tick: number): string;
+/** Caret visibility: half the ticks on, half off (530ms blink). */
+export declare function caretVisible(tick: number): boolean;

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

@@ -0,0 +1,27 @@
+/**
+ * Terminal markdown renderer for assistant replies: a pure GFM-subset
+ * block/inline parser producing styled line segments the Ink renderer maps
+ * to colored text. No ANSI here — the app owns color mapping, tests own the
+ * structure. The subset mirrors what agent replies actually emit: headings,
+ * emphasis, inline/fenced code, flat lists, blockquotes, links, rules, and
+ * wrapped paragraphs. Unknown syntax degrades to plain text (never throws).
+ *
+ * @module @deepseek-ai/dsh-code/render/markdown
+ */
+/** Style classes the renderer emits; the app maps them to colors/props. */
+export type MdStyle = 'plain' | 'bold' | 'italic' | 'boldItalic' | 'code' | 'accent' | 'dim' | 'strike';
+/** One styled run of text. */
+export interface MdSegment {
+    /** Visible text (no ANSI). */
+    text: string;
+    /** Presentation class for the app's color map. */
+    style: MdStyle;
+}
+/** One rendered line: a sequence of styled runs. */
+export interface MdLine {
+    segments: readonly MdSegment[];
+}
+/** Visible width of a run in columns (CJK counts double). */
+export declare function visibleColumns(text: string): number;
+/** Render markdown text into styled lines of at most `width` columns. */
+export declare function renderMarkdown(text: string, width: number): readonly MdLine[];

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

@@ -12,12 +12,17 @@ export interface UserEntry {
     kind: 'user';
     /** Joined text blocks of the user message. */
     text: string;
+    /** True for collapsed injected context (plugin/continuation notices), which
+     * the renderer marks with a dim ↳ instead of the user ❯ prompt. */
+    notice: boolean;
 }
 /** One assembled assistant reply. */
 export interface AssistantEntry {
     kind: 'assistant';
     /** Joined text blocks of the assistant message. */
     text: string;
+    /** Joined reasoning blocks of the same message, empty when the model thought out loud. */
+    reasoning: string;
 }
 /** One model-requested tool invocation and its settled state. */
 export interface ToolEntry {
@@ -28,6 +33,8 @@ export interface ToolEntry {
     name: string;
     /** Raw arguments JSON string exactly as the model produced it. */
     arguments: string;
+    /** Bounded human-meaningful arguments preview for the tool card. */
+    preview: string;
     /** Execution state; `running` until the paired result lands. */
     state: 'running' | 'done' | 'error';
     /** Bounded first text block of the result, empty until it lands. */
@@ -83,6 +90,8 @@ export interface TranscriptView {
     entries: readonly TranscriptEntry[];
     /** Text accumulated from `assistant/chunk` deltas since the last flush. */
     streaming: string;
+    /** Thinking accumulated from `assistant/chunk` reasoning deltas since the last flush. */
+    streamingReasoning: string;
     /** Latest whole-list todo snapshot from `todo/write`, empty when none. */
     todos: readonly TodoItem[];
     /** True while a durable turn is open (`turn/start` … `turn/end`). */
@@ -96,6 +105,10 @@ export interface TranscriptView {
      * Empty before the session's first request.
      */
     model: string;
+    /** Plan mode state folded from the last `plan/mode` event. */
+    plan: boolean;
+    /** Active permission preset folded from the last `permission/preset` event, empty before one. */
+    permission: string;
     /**
      * Fold-internal timing anchors, never rendered: open step and tool-call
      * start timestamps the next `assistant/message` / `tool/result` resolves

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

@@ -37,6 +37,10 @@ export interface StatusFacts {
     branch: string;
     /** Short session identifier (last dash-separated segment or tail). */
     sessionId: string;
+    /** Whether plan mode is active (folded from `plan/mode`). */
+    plan: boolean;
+    /** Active permission preset (folded from `permission/preset`), empty when unknown. */
+    permission: string;
 }
 /**
  * Build the footer's display groups; a group with no data drops out whole.

package/lib/types/render/tool-preview.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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.
+ *
+ * @module @deepseek-ai/dsh-code/render/tool-preview
+ */
+/**
+ * Resolve one bounded preview for raw tool arguments.
+ * @param args - raw JSON arguments string as the model produced it.
+ * @param toolName - the tool the arguments belong to (fallback label).
+ * @returns the preview line; empty when nothing useful resolves.
+ */
+export declare function toolArgumentsPreview(args: string, toolName: string): string;

package/lib/types/theme.d.ts

@@ -25,6 +25,10 @@ export declare const TUI_RGB: {
     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];
 };
 /** Paint with the primary brand blue: whale, wordmark, tool names, accents. */
 export declare function brand(text: string): 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.2.0",
+  "version": "0.3.0",
   "type": "module",
   "main": "lib/index.mjs",
   "types": "lib/types/index.d.ts",
@@ -74,16 +74,24 @@
     "@deepseek-ai/dsh-commands": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-permission-presets": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-plan-mode": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-session-persistence": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-reference": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-skill": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-user-approval": "^0.1.0-rc.6"
+    "@deepseek-ai/dsh-user-approval": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-user-questions": "^0.1.0-rc.6"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-commands": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-permission-presets": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-plan-mode": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-session-persistence": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-reference": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-skill": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-user-approval": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-user-questions": "^0.1.0-rc.6",
     "@types/node": "^24.0.0",
     "@types/react": "~18.3.1",
     "tsdown": "^0.22.2",