@gobing-ai/ts-ai-runner 0.4.62 → 0.4.63

package/README.md

@@ -33,7 +33,7 @@ bun add @gobing-ai/ts-ai-runner
 | `AGENT_SHIMS` / `TIER1_PRIORITY` / `TIER2_AGENTS` / `DISPLAY_ORDER` | Agent registry constants |
 | `isAgentName()` | Type guard for supported agent identifiers |
 
-Supported agent identifiers: `claude`, `codex`, `gemini` (deprecated), `pi`, `omp`, `opencode`, `antigravity-cli`, `openclaw`, `hermes`, `grok`. The `antigravity` id is a deprecated alias of `antigravity-cli`. See [Deprecation & Aliases](#deprecation--aliases).
+Supported agent identifiers: `claude`, `codex`, `gemini` (deprecated), `pi`, `omp`, `opencode`, `antigravity-cli`, `openclaw`, `hermes`, `grok`, `deepseek`. The `antigravity` id is a deprecated alias of `antigravity-cli`. See [Deprecation & Aliases](#deprecation--aliases).
 
 ## Architecture
 
@@ -337,6 +337,7 @@ const { args } = getAgentShim('omp').getPromptCommand({
 | codex | ✗ | ✗ (ignored) | — | degrade → fresh `exec` | `exec resume --last` |
 | agy | ✓ | ✗ (ignored) | — | `--conversation <id>` | `--continue` |
 | grok | ✓ | ✗ (ignored) | — | `--resume <id>` | `-c` |
+| deepseek | ✗ | ✗ (ignored) | — | degrade → fresh headless one-shot | degrade → fresh headless one-shot |
 
 **Degrade rule:** when `sessionDir`/`sessionId` is set and the agent lacks resume-by-id or a
 session-store flag, the shim opens **fresh in isolation** (or plain fresh) — never bare global
@@ -488,6 +489,7 @@ Agent-specific behavior:
 | `openclaw` | `openclaw` | 2 | `openclaw health` | `agent --local -m` |
 | `hermes` | `hermes` | 1 | `hermes doctor` | `chat -q`, `--continue`, `-m` |
 | `grok` | `grok` | 1 | env/file (`XAI_API_KEY` or `~/.grok/auth.json`) | `-p`, `-c` (resume), `-m`, `--output-format plain\|json` (maps ai-runner `text` → `plain`) |
+| `deepseek` | `dsh` | 1 | env-only / `~/.dsh` (no status verb) | `--profile headless <task>`; session/model options degrade to a fresh one-shot (no flags at 0.1.5-rc.1) |
 
 This is the right layer for UI previews, audit logging, and custom launchers.
 
@@ -515,6 +517,7 @@ resolveAgentName('cursor');          // → undefined
 | `omp` | canonical | `omp` | First-class; NOT a pi alias. |
 | `hermes` | canonical | `hermes` | First-class; OpenClaw-compatible but distinct binary. |
 | `grok` | canonical | `grok` | Grok Build CLI; headless via `-p`; auth is env/file only (no status verb). |
+| `deepseek` | canonical | `deepseek` | DeepSeek `dsh` CLI; headless via `--profile headless`; auth is env/file only (no status verb). |
 
 `getAgentShim()` and `isAgentName()` are alias-aware: passing `'antigravity'` resolves to the `antigravity-cli` shim. `DoctorResult` and `DetectedAgent` surface `deprecated` + `replacedBy` when the resolved canonical id is marked deprecated.
 

package/dist/agents/shims.d.ts

@@ -1,5 +1,5 @@
 /** Identifier for one supported coding agent (canonical id). */
-export type AgentName = 'claude' | 'codex' | 'gemini' | 'pi' | 'opencode' | 'antigravity-cli' | 'openclaw' | 'hermes' | 'omp' | 'grok';
+export type AgentName = 'claude' | 'codex' | 'gemini' | 'pi' | 'opencode' | 'antigravity-cli' | 'openclaw' | 'hermes' | 'omp' | 'grok' | 'deepseek';
 /** Output mode for prompt invocations. */
 export type OutputMode = 'text' | 'json';
 /** Concrete executable and argv pair returned by an agent shim. */

package/dist/agents/shims.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shims.d.ts","sourceRoot":"","sources":["../../src/agents/shims.ts"],"names":[],"mappings":"AAEA,gEAAgE;AAChE,MAAM,MAAM,SAAS,GACf,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,IAAI,GACJ,UAAU,GACV,iBAAiB,GACjB,UAAU,GACV,QAAQ,GACR,KAAK,GACL,MAAM,CAAC;AAEb,0CAA0C;AAC1C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,mEAAmE;AACnE,MAAM,WAAW,WAAW;IACxB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC1B,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;CACnC;AAED,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACtB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IACrB,sFAAsF;IACtF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,wFAAwF;IACxF,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IACvC,oCAAoC;IACpC,cAAc,IAAI,WAAW,CAAC;IAC9B,yCAAyC;IACzC,iBAAiB,IAAI,WAAW,CAAC;IACjC,yCAAyC;IACzC,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,CAAC;IACtD,8DAA8D;IAC9D,cAAc,IAAI,WAAW,GAAG,IAAI,CAAC;CACxC;AA4OD,6DAA6D;AAC7D,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAW9D,CAAC;AAEF,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACnC,oFAAoF;IACpF,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,oEAAoE;IACpE,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACxC;AA2BD,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,GAAG,sBAAsB,CAElF;AAED,mEAAmE;AACnE,eAAO,MAAM,cAAc,EAAE,SAAS,SAAS,EAS9C,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,aAAa,EAAE,SAAS,SAAS,EAW7C,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,SAAS,CAAyB,CAAC;AAU1E;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAQrE;AAED;mEACmE;AACnE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAMxD"}
+{"version":3,"file":"shims.d.ts","sourceRoot":"","sources":["../../src/agents/shims.ts"],"names":[],"mappings":"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"}

package/dist/agents/shims.js

@@ -252,6 +252,29 @@ const grokShim = {
     },
     getAuthCommand: () => null,
 };
+/**
+ * DeepSeek coding agent (`dsh`, @deepseek-ai/dsh) — tier-1. Boot model is
+ * `dsh --profile <name>`; the headless one-shot surface is the `headless`
+ * profile: `dsh --profile headless "<task>"` streams reasoning to stderr and
+ * prints the final assistant message to stdout. At 0.1.5-rc.1 the headless
+ * app accepts only the positional task and `-h` — no resume/model/mode flags.
+ * No auth subcommand; credentials resolve via env references / `~/.dsh`.
+ */
+const dshShim = {
+    name: 'deepseek',
+    command: 'dsh',
+    tier: 1,
+    getHelpCommand: () => ({ command: 'dsh', args: ['--help'] }),
+    getVersionCommand: () => ({ command: 'dsh', args: ['--version'] }),
+    getPromptCommand: (options) => {
+        // Always a fresh one-shot headless dispatch: sessionId/sessionDir/
+        // continue/model degrade silently — the HEADLESS app takes only the
+        // task + `-h`; no resume/model flags exist at dsh 0.1.5-rc.1.
+        // mode/workspace/timeoutMs have no dsh flag — best-effort ignored.
+        return { command: 'dsh', args: ['--profile', 'headless', options.input ?? ''] };
+    },
+    getAuthCommand: () => null,
+};
 /** All bundled agent shims keyed by canonical agent name. */
 export const AGENT_SHIMS = {
     claude: claudeShim,
@@ -264,6 +287,7 @@ export const AGENT_SHIMS = {
     hermes: hermesShim,
     omp: ompShim,
     grok: grokShim,
+    deepseek: dshShim,
 };
 /**
  * Session-affinity capability metadata per agent. Callers must consult this
@@ -288,6 +312,8 @@ const AGENT_SESSION_CAPABILITY = {
     opencode: { supportsResumeById: false, supportsSessionDir: false },
     openclaw: { supportsResumeById: false, supportsSessionDir: false },
     hermes: { supportsResumeById: false, supportsSessionDir: false },
+    // dsh headless has no resume/session flags — fresh-dispatch degrade.
+    deepseek: { supportsResumeById: false, supportsSessionDir: false },
 };
 /** Query a bundled agent's session-affinity capability by canonical name. */
 export function getAgentSessionCapability(agent) {
@@ -303,6 +329,7 @@ export const TIER1_PRIORITY = [
     'hermes',
     'opencode',
     'grok',
+    'deepseek',
 ];
 /** Display order for doctor and list commands. */
 export const DISPLAY_ORDER = [
@@ -316,6 +343,7 @@ export const DISPLAY_ORDER = [
     'openclaw',
     'hermes',
     'grok',
+    'deepseek',
 ];
 /** Set of gateway/TUI-constrained agents. */
 export const TIER2_AGENTS = new Set(['openclaw']);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-ai-runner",
-    "version": "0.4.62",
+    "version": "0.4.63",
     "description": "@gobing-ai/ts-ai-runner — Coding-agent shims, detection, doctor checks, and prompt execution.",
     "keywords": [
         "typescript",
@@ -47,12 +47,12 @@
         "release": "echo 'Manual publish is disabled. Releases go through GitHub Actions via Trusted Publishing — push a tag: git tag @gobing-ai/ts-ai-runner-v<version> && git push --tags' && exit 1"
     },
     "dependencies": {
-        "@gobing-ai/ts-infra": "^0.4.62",
-        "@gobing-ai/ts-runtime": "^0.4.62"
+        "@gobing-ai/ts-infra": "^0.4.63",
+        "@gobing-ai/ts-runtime": "^0.4.63"
     },
     "devDependencies": {
         "@types/bun": "1.3.14",
-        "@gobing-ai/ts-db": "^0.4.62"
+        "@gobing-ai/ts-db": "^0.4.63"
     },
     "publishConfig": {
         "access": "public"

package/src/agents/shims.ts

@@ -11,7 +11,8 @@ export type AgentName =
     | 'openclaw'
     | 'hermes'
     | 'omp'
-    | 'grok';
+    | 'grok'
+    | 'deepseek';
 
 /** Output mode for prompt invocations. */
 export type OutputMode = 'text' | 'json';
@@ -331,6 +332,30 @@ const grokShim: AgentShim = {
     getAuthCommand: () => null,
 };
 
+/**
+ * DeepSeek coding agent (`dsh`, @deepseek-ai/dsh) — tier-1. Boot model is
+ * `dsh --profile <name>`; the headless one-shot surface is the `headless`
+ * profile: `dsh --profile headless "<task>"` streams reasoning to stderr and
+ * prints the final assistant message to stdout. At 0.1.5-rc.1 the headless
+ * app accepts only the positional task and `-h` — no resume/model/mode flags.
+ * No auth subcommand; credentials resolve via env references / `~/.dsh`.
+ */
+const dshShim: AgentShim = {
+    name: 'deepseek',
+    command: 'dsh',
+    tier: 1,
+    getHelpCommand: () => ({ command: 'dsh', args: ['--help'] }),
+    getVersionCommand: () => ({ command: 'dsh', args: ['--version'] }),
+    getPromptCommand: (options) => {
+        // Always a fresh one-shot headless dispatch: sessionId/sessionDir/
+        // continue/model degrade silently — the HEADLESS app takes only the
+        // task + `-h`; no resume/model flags exist at dsh 0.1.5-rc.1.
+        // mode/workspace/timeoutMs have no dsh flag — best-effort ignored.
+        return { command: 'dsh', args: ['--profile', 'headless', options.input ?? ''] };
+    },
+    getAuthCommand: () => null,
+};
+
 /** All bundled agent shims keyed by canonical agent name. */
 export const AGENT_SHIMS: Readonly<Record<AgentName, AgentShim>> = {
     claude: claudeShim,
@@ -343,6 +368,7 @@ export const AGENT_SHIMS: Readonly<Record<AgentName, AgentShim>> = {
     hermes: hermesShim,
     omp: ompShim,
     grok: grokShim,
+    deepseek: dshShim,
 };
 
 /** Session-affinity capability for one coding agent (ADR-047). */
@@ -376,6 +402,8 @@ const AGENT_SESSION_CAPABILITY: Readonly<Record<AgentName, AgentSessionCapabilit
     opencode: { supportsResumeById: false, supportsSessionDir: false },
     openclaw: { supportsResumeById: false, supportsSessionDir: false },
     hermes: { supportsResumeById: false, supportsSessionDir: false },
+    // dsh headless has no resume/session flags — fresh-dispatch degrade.
+    deepseek: { supportsResumeById: false, supportsSessionDir: false },
 };
 
 /** Query a bundled agent's session-affinity capability by canonical name. */
@@ -393,6 +421,7 @@ export const TIER1_PRIORITY: readonly AgentName[] = [
     'hermes',
     'opencode',
     'grok',
+    'deepseek',
 ];
 
 /** Display order for doctor and list commands. */
@@ -407,6 +436,7 @@ export const DISPLAY_ORDER: readonly AgentName[] = [
     'openclaw',
     'hermes',
     'grok',
+    'deepseek',
 ];
 
 /** Set of gateway/TUI-constrained agents. */