dsh-code 0.1.0 → 0.3.0

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/skills.d.ts

@@ -0,0 +1,45 @@
+/**
+ * User-invocable skill watch for the `/` completion menu: the in-process
+ * equivalent of the web ui-skill trigger source. Skills are NOT commands —
+ * picking one lands the literal `/name ` text in the input, and submitting
+ * it as a normal prompt lets the host's tool-skill pre-step inject the body
+ * (the only entry point for model-disabled skills). Command descriptors win
+ * on a name collision; see the runner's dispatch.
+ *
+ * @module @deepseek-ai/dsh-code/skills
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+/** One completion-menu row derived from a user-invocable skill. */
+export interface SkillRow {
+    /** Skill name; the literal `/name` text is what a pick lands. */
+    name: string;
+    /** Human-readable description (suffixed when model-invocation is off). */
+    description: string;
+    /** Whether the model may also invoke this skill by name. */
+    modelInvocable: boolean;
+}
+/** The skill-catalog snapshot the completion menu subscribes to. */
+export interface SkillsView {
+    /** Name-sorted user-invocable rows; empty until the first load lands. */
+    readonly rows: readonly SkillRow[];
+    /** Subscribe to catalog changes; returns the unsubscribe function. */
+    subscribe(listener: () => void): () => void;
+    /** Retarget the agent whose workspace the catalog is read for. */
+    setAgent(agent: Agent): void;
+}
+/** Internal shape shared by {@link watchSkills} and its test doubles. */
+interface SkillsWatch extends SkillsView {
+    setAgent(agent: Agent): void;
+}
+/**
+ * Watch the user-invocable skill catalog for one agent's workspace. The first
+ * load starts when the owning agent is known (`setAgent`); `skills/change`
+ * and agent retargets re-read. Read failures keep the last good rows (the
+ * next change notification is the retry surface) — a missing `skills`
+ * service leaves the view permanently empty.
+ * @param ctx - context carrying the `skills` service (optional).
+ * @returns the view the completion menu subscribes to.
+ */
+export declare function watchSkills(ctx: Context): SkillsWatch;
+export {};

package/lib/types/startup.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The interactive terminal app's command-line provider: parses `--resume`,
+ * `--continue`, `--session`, 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}).
+ *
+ * Semantics:
+ * - `--resume <id|prefix>` — continue the persisted session whose id or unique
+ *   id-prefix matches; the TUI replays its transcript and appends to the same
+ *   durable log.
+ * - `--continue` / `-c` — resume the most recently modified persisted session
+ *   whose project directory matches the current working directory.
+ * - `--session <id>` — create a new session under an explicit identity (the
+ *   id must not exist yet).
+ * - no flags — a fresh session with a minted id.
+ *
+ * @module @deepseek-ai/dsh-tui/startup
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Stable Cordis plugin name. */
+export declare const name = "tui-startup";
+/** Services required before the invocation can be resolved. */
+export declare const inject: string[];
+/** Service provided by this plugin and injected by the terminal runner. */
+export declare const TUI_STARTUP_SERVICE = "tuiStartup";
+/** How the runner obtains its session identity. */
+export type TuiStartup = {
+    readonly kind: 'fresh';
+} | {
+    readonly kind: 'named';
+    readonly sessionId: string;
+} | {
+    readonly kind: 'resume';
+    readonly sessionId: string;
+} | {
+    readonly kind: 'latest';
+};
+/**
+ * Parse the invocation and publish the startup service. Mutual exclusions are
+ * usage errors rejected from the action before anything is provided.
+ * @param ctx - plugin context carrying the command line and exit request.
+ */
+export declare function apply(ctx: Context): void;

package/lib/types/store.d.ts

@@ -18,7 +18,13 @@ export interface TranscriptStore {
     apply(event: SessionEvent): void;
 }
 /**
- * Create one transcript store.
+ * Create one transcript store, optionally seeded with replayed history. The
+ * seed folds synchronously BEFORE the first render, so a resumed session
+ * paints its full transcript on mount (no live `session/event` fires for
+ * constructor seeds — the store's `session/event` feed only carries new
+ * appends).
+ * @param replay - persisted events in `seq` order (e.g. a resumed session's
+ * constructor seed); folded once and never re-notified.
  * @returns the store the runner feeds and the renderer subscribes to.
  */
-export declare function createTranscriptStore(): TranscriptStore;
+export declare function createTranscriptStore(replay?: readonly SessionEvent[]): TranscriptStore;

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.1.0",
+  "version": "0.3.0",
   "type": "module",
   "main": "lib/index.mjs",
   "types": "lib/types/index.d.ts",
@@ -10,6 +10,10 @@
       "types": "./lib/types/index.d.ts",
       "default": "./lib/index.mjs"
     },
+    "./startup": {
+      "types": "./lib/types/startup.d.ts",
+      "default": "./lib/startup.mjs"
+    },
     "./invariant": {
       "types": "./lib/types/invariant.d.ts",
       "default": "./lib/invariant.mjs"
@@ -24,6 +28,16 @@
     "src"
   ],
   "license": "MIT",
+  "keywords": [
+    "deepseek",
+    "dsh",
+    "deepseek-harness",
+    "tui",
+    "terminal",
+    "claude-code",
+    "agent",
+    "ink"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/unlinearity/dsh-code.git"
@@ -37,13 +51,16 @@
     "build": "tsdown && tsc -p tsconfig.json",
     "test": "vitest run",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "gen:whale": "tsx scripts/gen-whale-glyph.ts"
+    "gen:whale": "tsx scripts/gen-whale-glyph.ts",
+    "prepublishOnly": "pnpm typecheck && pnpm test && pnpm build"
   },
   "engines": {
     "node": "^22.19 || >=24"
   },
   "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1",
     "chalk": "^5.6.2",
+    "commander": "^14.0.2",
     "ink": "^5.2.1",
     "react": "^18.3.1"
   },
@@ -54,11 +71,27 @@
     "@deepseek-ai/dsh-agent-default-model": "^0.1.0-rc.6",
     "@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-invariants": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-session": "^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-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",