dsh-code 0.3.0 → 0.5.0

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

@@ -0,0 +1,92 @@
+/**
+ * Expansion payloads for tool cards (the Ctrl+O verbose transcript): the
+ * TUI-side consumption of the harness presentation contract. Mutation and
+ * read tools persist a structured `tool/result.meta` (`diffs`, read
+ * windows, web sources) exactly so a capable UI can replay richer cards than
+ * the model-facing text; this module narrows that opaque JSON defensively —
+ * mirroring the upstream validators — and pre-formats bounded, render-ready
+ * rows. Malformed or absent metadata always degrades to the bounded raw
+ * result text, never throws during replay.
+ *
+ * @module @deepseek-ai/dsh-code/render/tool-detail
+ */
+/** One rendered diff row: removed, added, or shared context. */
+export interface DiffLine {
+    /** '-' removed, '+' added, ' ' context. */
+    mark: '-' | '+' | ' ';
+    /** The line text, truncated to the column budget. */
+    text: string;
+}
+/** One file's bounded inline diff. */
+export interface ToolDiff {
+    /** File path the change belongs to. */
+    path: string;
+    /** Rendered rows in order; '-' block before the '+' block. */
+    lines: readonly DiffLine[];
+    /** True when the line budget cut the hunk. */
+    truncated: boolean;
+}
+/** One numbered line of a read window. */
+export interface ToolReadLine {
+    /** 1-based file line number. */
+    number: number;
+    /** The line text, truncated to the column budget. */
+    text: string;
+}
+/** One web-search source row. */
+export interface ToolWebSource {
+    /** Source URL. */
+    url: string;
+    /** Source title, when the provider returned one. */
+    title: string | undefined;
+    /** Short excerpt, truncated to the column budget. */
+    snippet: string;
+}
+/** The expansion payload a verbose tool card renders; a discriminated union. */
+export type ToolDetail = {
+    kind: 'diff';
+    diffs: readonly ToolDiff[];
+} | {
+    kind: 'read';
+    path: string;
+    offset: number;
+    lines: readonly ToolReadLine[];
+    totalLines: number;
+    truncated: boolean;
+} | {
+    kind: 'web-search';
+    sources: readonly ToolWebSource[];
+    truncated: boolean;
+} | {
+    kind: 'web-fetch';
+    url: string;
+    statusCode: number;
+} | {
+    kind: 'raw';
+    text: string;
+    truncated: boolean;
+};
+/**
+ * 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.
+ * @param oldText - prior content, or null for a create.
+ * @param newText - content after the change.
+ * @param budget - maximum rows to emit.
+ * @returns the bounded rows and whether they were cut.
+ */
+export declare function diffRows(oldText: string | null, newText: string, budget: number): {
+    lines: readonly DiffLine[];
+    truncated: boolean;
+};
+/**
+ * Narrow the opaque `tool/result.meta` into one bounded expansion payload,
+ * mirroring the upstream presenters' degradation ladder: diffs (write/edit),
+ * read windows (read), sources (web_search), fetch summaries (web_fetch), and
+ * the bounded raw result text as the universal fallback.
+ * @param meta - the persisted presentation metadata, when the tool attached one.
+ * @param rawText - the joined text blocks of the result message.
+ * @returns the expansion payload, or undefined when nothing renderable exists.
+ */
+export declare function toolResultDetail(meta: unknown, rawText: string): ToolDetail | undefined;

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

@@ -0,0 +1,54 @@
+/** Lightweight session-directory projection for the /resume picker. */
+import type { SessionEvent, SessionHeader } from '@deepseek-ai/dsh-session';
+export interface SessionRecord {
+    readonly header: SessionHeader;
+    readonly live: boolean;
+    readonly persisted: boolean;
+}
+export interface TitleObservationResult {
+    readonly sessionId: string;
+    readonly status: 'fulfilled' | 'rejected';
+    readonly value?: {
+        readonly title?: {
+            readonly title?: string;
+            readonly text?: string;
+        };
+    };
+}
+export interface SessionLogSnapshot {
+    readonly session: SessionHeader;
+    readonly events: SessionEvent[];
+}
+/** Structural upstream SessionQuery surface used by the TUI. */
+export interface SessionQueryService {
+    listSessions(signal?: AbortSignal): Promise<SessionRecord[]>;
+    readTitleSnapshots(ids: readonly string[], signal?: AbortSignal): Promise<TitleObservationResult[]>;
+    readSession(id: string, signal?: AbortSignal): Promise<SessionLogSnapshot>;
+}
+export type SessionScope = 'roots' | 'all';
+export type CwdScope = 'all' | 'current';
+export type SessionSort = 'newest' | 'oldest';
+export interface SessionDirectoryOptions {
+    readonly sessions: SessionScope;
+    readonly cwd: CwdScope;
+    readonly sort: SessionSort;
+    readonly currentCwd: string;
+    readonly query: string;
+}
+export interface SessionRow {
+    readonly id: string;
+    readonly createdAt: number;
+    readonly cwd: string;
+    readonly workspace: string;
+    readonly parent?: string;
+    readonly subagent: boolean;
+    readonly resumable: boolean;
+    readonly live: boolean;
+    readonly persisted: boolean;
+    readonly preset: string;
+    readonly title?: string;
+}
+/** 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. */
+export declare function mergeSessionTitles(rows: readonly SessionRow[], observations: readonly TitleObservationResult[]): SessionRow[];

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

@@ -0,0 +1,17 @@
+/** Latest-wins, idle-bound queue for safe Agent session changes. */
+export interface IdleActivity {
+    readonly status: 'idle' | 'running';
+    whenIdle(): Promise<void>;
+}
+export declare class SessionSwitchQueue<T> {
+    private readonly execute;
+    private readonly failed;
+    private pending;
+    private pumping;
+    constructor(execute: (value: T) => Promise<void>, failed: (error: unknown) => void);
+    /** Queue a request; a later request replaces any request still waiting. */
+    request(activity: IdleActivity, value: T): 'queued' | 'started';
+    /** Cancel only work that has not begun activation. */
+    cancel(): boolean;
+    private pump;
+}

package/lib/types/skills.d.ts

@@ -23,6 +23,8 @@ export interface SkillRow {
 export interface SkillsView {
     /** Name-sorted user-invocable rows; empty until the first load lands. */
     readonly rows: readonly SkillRow[];
+    /** Latest catalog-read failure; the help panel exposes it in place. */
+    readonly error?: string;
     /** Subscribe to catalog changes; returns the unsubscribe function. */
     subscribe(listener: () => void): () => void;
     /** Retarget the agent whose workspace the catalog is read for. */

package/lib/types/startup.d.ts

@@ -1,6 +1,6 @@
 /**
  * The interactive terminal app's command-line provider: parses `--resume`,
- * `--continue`, `--session`, and `--help`, then publishes
+ * `--continue`, `--session`, `--mode`, and `--help`, then publishes
  * {@link TUI_STARTUP_SERVICE} for the runner to consume lazily. Follows the
  * headless bundle's startup shape (a commander action publishing a service
  * through {@link parseCmdline}).
@@ -27,15 +27,25 @@ export declare const TUI_STARTUP_SERVICE = "tuiStartup";
 /** How the runner obtains its session identity. */
 export type TuiStartup = {
     readonly kind: 'fresh';
+    readonly mode?: string;
 } | {
     readonly kind: 'named';
     readonly sessionId: string;
+    readonly mode?: string;
 } | {
     readonly kind: 'resume';
     readonly sessionId: string;
 } | {
     readonly kind: 'latest';
 };
+export interface TuiStartupOptions {
+    readonly resume?: string;
+    readonly continue?: boolean;
+    readonly session?: string;
+    readonly mode?: string;
+}
+/** Pure option policy shared by Commander and tests. */
+export declare function resolveTuiStartup(options: TuiStartupOptions): TuiStartup;
 /**
  * Parse the invocation and publish the startup service. Mutual exclusions are
  * usage errors rejected from the action before anything is provided.

package/lib/types/store.d.ts

@@ -16,6 +16,8 @@ export interface TranscriptStore {
     subscribe(listener: () => void): () => void;
     /** Fold one session event; ignored events change nothing and notify nobody. */
     apply(event: SessionEvent): void;
+    /** Drop the folded view entirely (/clear): the next event starts a fresh one. */
+    reset(): void;
 }
 /**
  * Create one transcript store, optionally seeded with replayed history. The

package/package.json

@@ -1,8 +1,12 @@
 {
   "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.3.0",
+  "version": "0.5.0",
   "type": "module",
+  "bin": {
+    "deepseek": "./bin/deepseek.mjs",
+    "dsh-code": "./bin/deepseek.mjs"
+  },
   "main": "lib/index.mjs",
   "types": "lib/types/index.d.ts",
   "exports": {
@@ -52,6 +56,7 @@
     "test": "vitest run",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "gen:whale": "tsx scripts/gen-whale-glyph.ts",
+    "prepare": "pnpm build",
     "prepublishOnly": "pnpm typecheck && pnpm test && pnpm build"
   },
   "engines": {
@@ -72,23 +77,33 @@
     "@deepseek-ai/dsh-cmdline": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-code-runtime-worker-thread": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-commands": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-compaction": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-goal": "^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-llm-retry": "^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-sandbox-policy": "^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-session-title": "^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"
   },
   "devDependencies": {
+    "@deepseek-ai/dsh-compaction": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-commands": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-goal": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm-retry": "^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-sandbox-policy": "^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-session-title": "^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",