subconscious-cli 4.0.4 → 4.0.5

package/README.md

@@ -21,8 +21,8 @@ never block the requested command. Set `SUBC_DISABLE_UPDATE_CHECK=1` to suppress
 the check in offline automation.
 
 Login creates both the saved credential and a ready-to-use `default` profile,
-so Claude Code, Codex, and OpenCode can launch immediately. Persistent editor
-and Pi integrations are installed per agent:
+so Claude Code, Codex, OpenCode, and DeepSeek Harness can launch immediately.
+Persistent editor and Pi integrations are installed per agent:
 
 ```bash
 subc cursor install
@@ -57,6 +57,7 @@ subc claude --continue
 subc codex exec "write a test"
 subc opencode
 subc pi
+subc dsh
 ```
 
 ## Supported agents
@@ -71,8 +72,9 @@ The packaged integrations live in `cli/bin/runbook`.
 | `subc cursor install` | Install/update Cursor conversation and compaction hooks |
 | `subc copilot install` | Install/update the VS Code custom endpoint and Copilot hooks |
 | `subc pi` | Refresh the Pi provider from the live catalog, then launch |
+| `subc dsh` | Launch the DeepSeek Harness Web UI with a temporary provider populated from the live catalog |
 
-If Claude Code, Codex, or OpenCode is missing, an interactive terminal offers
+If Claude Code, Codex, OpenCode, or DeepSeek Harness is missing, an interactive terminal offers
 to install it before launching. Pi refreshes its Subconscious provider on every
 `subc pi` launch while preserving all other providers in `models.json`; its
 executable must already be installed.
@@ -112,6 +114,13 @@ Manage Language Models UI. The install scripts print the relevant next steps.
 The runbook scripts require Bash. Cursor, Copilot, Pi, and Codex hook merge
 also require `jq`; Cursor and Copilot also require `curl`.
 
+`subc dsh` defaults to the DeepSeek Harness Web UI. It injects an ephemeral
+Cordis overlay containing the active gateway URL, selected model, token limits,
+client header, and every model returned by `/v1/models`; the API key remains in
+the process environment and is never written into the overlay. The temporary
+file is removed when Harness exits, and existing `$DSH_HOME` settings are not
+rewritten. Run a one-shot task with `subc dsh headless "PROMPT"`.
+
 ## Runbook profiles
 
 `subc login` automatically creates:
@@ -121,8 +130,8 @@ also require `jq`; Cursor and Copilot also require `curl`.
 ```
 
 The file is mode `600` and contains the shared gateway URL, API key, model,
-optional per-agent key overrides, and all Claude/Codex/OpenCode/Pi/Copilot
-context and output settings used by the packaged runbook scripts.
+optional per-agent key overrides, and all Claude/Codex/OpenCode/Pi/Copilot/
+DeepSeek Harness context and output settings used by the packaged runbook scripts.
 
 ```bash
 subc config                         # list every profile and its file path
@@ -186,8 +195,9 @@ export SUBCONSCIOUS_MODEL=subconscious/glm-5.2
 ```
 
 Every launch and install fetches the same live catalog without caching. Codex,
-OpenCode, Pi, Copilot, and Cursor receive the complete model list. The selected
-profile model is listed first only while the gateway still advertises it.
+OpenCode, Pi, Copilot, Cursor, and DeepSeek Harness receive the complete model
+list. The selected profile model is listed first only while the gateway still
+advertises it.
 OpenCode rebuilds its isolated runtime provider on every `subc opencode` launch,
 so models left in older OpenCode configuration files do not leak into the list.
 If a saved profile default has been removed, launches use the first live model;

package/bin/agents.js

@@ -232,6 +232,18 @@ const AGENT_HELP = {
       ['ARGS...', 'Pass arguments directly to Pi'],
     ],
   },
+  'deepseek-harness': {
+    usage: 'subc [-p NAME] dsh [web|headless] [--model MODEL] [Harness arguments...]',
+    behavior:
+      'Launches DeepSeek Harness with a temporary Subconscious provider containing every live gateway model. Web mode is the default.',
+    options: [
+      ['help', 'Show this help'],
+      ['web', 'Launch the DeepSeek Harness Web UI (default)'],
+      ['headless PROMPT', 'Run one headless task and exit'],
+      ['--model MODEL', 'Set the initial model for new Harness sessions'],
+      ['ARGS...', 'Pass remaining arguments to the selected Harness mode'],
+    ],
+  },
 };
 
 export function isAgentHelpRequest(argv = []) {

package/bin/profiles.js

@@ -44,6 +44,7 @@ export const RUNBOOK_DEFAULTS = {
   CURSOR_API_KEY: '',
   COPILOT_API_KEY: '',
   PI_API_KEY: '',
+  DEEPSEEK_HARNESS_API_KEY: '',
   CLAUDE_CODE_AUTO_COMPACT_WINDOW: '1000000',
   CLAUDE_CODE_MAX_CONTEXT_TOKENS: '3000000',
   MAX_CONCURRENT_SUBAGENTS: '4',
@@ -57,6 +58,8 @@ export const RUNBOOK_DEFAULTS = {
   OPENCODE_OUTPUT_LIMIT: '65536',
   PI_CONTEXT_WINDOW: '5000000',
   PI_MAX_TOKENS: '65536',
+  DEEPSEEK_HARNESS_CONTEXT_WINDOW: '5000000',
+  DEEPSEEK_HARNESS_MAX_TOKENS: '65536',
   COPILOT_MAX_INPUT_TOKENS: '5000000',
   COPILOT_MAX_OUTPUT_TOKENS: '65536',
   VSCODE_APP: '',
@@ -238,6 +241,26 @@ const SETTINGS = {
     type: 'integer',
     min: 1,
   },
+  DEEPSEEK_HARNESS_API_KEY: {
+    key: 'DEEPSEEK_HARNESS_API_KEY',
+    label: 'DeepSeek Harness API key',
+    description: 'DeepSeek Harness credential override; blank uses API_KEY.',
+    type: 'secret',
+  },
+  DEEPSEEK_HARNESS_CONTEXT_WINDOW: {
+    key: 'DEEPSEEK_HARNESS_CONTEXT_WINDOW',
+    label: 'Context window',
+    description: 'Context capacity advertised to DeepSeek Harness.',
+    type: 'integer',
+    min: 1,
+  },
+  DEEPSEEK_HARNESS_MAX_TOKENS: {
+    key: 'DEEPSEEK_HARNESS_MAX_TOKENS',
+    label: 'Maximum output tokens',
+    description: 'Output capacity advertised to DeepSeek Harness.',
+    type: 'integer',
+    min: 1,
+  },
 };
 
 const AGENT_SETTING_KEYS = {
@@ -267,6 +290,11 @@ const AGENT_SETTING_KEYS = {
     'VSCODE_APP',
   ],
   pi: ['PI_API_KEY', 'PI_CONTEXT_WINDOW', 'PI_MAX_TOKENS'],
+  'deepseek-harness': [
+    'DEEPSEEK_HARNESS_API_KEY',
+    'DEEPSEEK_HARNESS_CONTEXT_WINDOW',
+    'DEEPSEEK_HARNESS_MAX_TOKENS',
+  ],
 };
 
 const GROUP_KEYS = [
@@ -313,6 +341,7 @@ OPENCODE_API_KEY={OPENCODE_API_KEY}
 CURSOR_API_KEY={CURSOR_API_KEY}
 COPILOT_API_KEY={COPILOT_API_KEY}
 PI_API_KEY={PI_API_KEY}
+DEEPSEEK_HARNESS_API_KEY={DEEPSEEK_HARNESS_API_KEY}
 
 # Claude Code
 # Leave CLAUDE_GATEWAY_URL blank to use GATEWAY_URL above.
@@ -337,6 +366,10 @@ OPENCODE_OUTPUT_LIMIT={OPENCODE_OUTPUT_LIMIT}
 PI_CONTEXT_WINDOW={PI_CONTEXT_WINDOW}
 PI_MAX_TOKENS={PI_MAX_TOKENS}
 
+# DeepSeek Harness
+DEEPSEEK_HARNESS_CONTEXT_WINDOW={DEEPSEEK_HARNESS_CONTEXT_WINDOW}
+DEEPSEEK_HARNESS_MAX_TOKENS={DEEPSEEK_HARNESS_MAX_TOKENS}
+
 # GitHub Copilot
 COPILOT_MAX_INPUT_TOKENS={COPILOT_MAX_INPUT_TOKENS}
 COPILOT_MAX_OUTPUT_TOKENS={COPILOT_MAX_OUTPUT_TOKENS}

package/bin/registry.generated.json

@@ -291,6 +291,36 @@
           "uninstall"
         ]
       }
+    },
+    {
+      "id": "deepseek-harness",
+      "command": "dsh",
+      "name": "DeepSeek Harness",
+      "aliases": [
+        "deepseek-harness",
+        "deepseek"
+      ],
+      "description": "Launch DeepSeek Harness with an ephemeral Subconscious provider populated from the live model catalog.",
+      "framework": "DeepSeek Harness",
+      "language": "shell",
+      "category": "coding-agent",
+      "tags": [
+        "local",
+        "web",
+        "agents"
+      ],
+      "protocol": "openai",
+      "homepage": "https://www.deepseek.com/harness/en/",
+      "bin": "dsh",
+      "install": {
+        "darwin": "npm i -g @deepseek-ai/dsh",
+        "linux": "npm i -g @deepseek-ai/dsh",
+        "win32": "npm i -g @deepseek-ai/dsh"
+      },
+      "runbook": {
+        "mode": "launch",
+        "script": "deepseek-harness/run.sh"
+      }
     }
   ]
 }

package/bin/runbook/README.md

@@ -1,7 +1,8 @@
 # Coding-agent integrations
 
 These scripts are part of `subc`. They launch or surgically install Claude Code,
-Codex, OpenCode, Cursor, Copilot, and Pi against the Subconscious gateway.
+Codex, OpenCode, DeepSeek Harness, Cursor, Copilot, and Pi against the
+Subconscious gateway.
 
 `subc` reads `~/.subconscious/profiles/<name>.env` and injects those values into
 the scripts, so users do not need a sibling `.env` file. When a script is run
@@ -15,6 +16,7 @@ Included integrations:
 - `cursor/install.sh`, `hook.sh`, and `hooks.json`
 - `copilot/install.sh`, `hook.sh`, and `hooks.json`
 - `pi/install.sh`, `run.sh`, and `subconscious-compaction.ts`
+- `deepseek-harness/run.sh`
 
 Each CLI-enabled entry in `agents/registry.json` points here with a `runbook`
 block. Persistent writes are merge/unmerge only: they never replace a user's

package/bin/runbook/deepseek-harness/run.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+# Launch DeepSeek Harness with a temporary Cordis overlay that adds the live
+# Subconscious catalog. The user's DSH settings and profiles are not rewritten.
+
+set -euo pipefail
+
+GATEWAY_URL="${GATEWAY_URL:-}"
+API_KEY="${DEEPSEEK_HARNESS_API_KEY:-${API_KEY:-}}"
+MODEL="${MODEL:-subconscious/glm-5.2}"
+CONTEXT_WINDOW="${DEEPSEEK_HARNESS_CONTEXT_WINDOW:-5000000}"
+MAX_TOKENS="${DEEPSEEK_HARNESS_MAX_TOKENS:-65536}"
+
+DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.2
+subconscious/tim-qwen3.6-27b
+subconscious/deepseek-v4-flash-marathon"
+
+if [[ -z "$GATEWAY_URL" || -z "$API_KEY" ]]; then
+  echo "error: GATEWAY_URL and API_KEY are required to launch DeepSeek Harness" >&2
+  exit 1
+fi
+if [[ ! "$CONTEXT_WINDOW" =~ ^[1-9][0-9]*$ ]]; then
+  echo "error: DEEPSEEK_HARNESS_CONTEXT_WINDOW must be a positive integer" >&2
+  exit 1
+fi
+if [[ ! "$MAX_TOKENS" =~ ^[1-9][0-9]*$ ]]; then
+  echo "error: DEEPSEEK_HARNESS_MAX_TOKENS must be a positive integer" >&2
+  exit 1
+fi
+
+SUPPORTED_MODELS=()
+add_supported_model() {
+  local model_id="$1" existing
+  [[ -n "$model_id" ]] || return 0
+  if [[ ! "$model_id" =~ ^[-A-Za-z0-9._:/+]+$ ]]; then
+    echo "error: invalid model id: $model_id" >&2
+    exit 1
+  fi
+  if [[ "${#SUPPORTED_MODELS[@]}" -gt 0 ]]; then
+    for existing in "${SUPPORTED_MODELS[@]}"; do
+      [[ "$existing" == "$model_id" ]] && return 0
+    done
+  fi
+  SUPPORTED_MODELS+=("$model_id")
+}
+
+add_supported_model "$MODEL"
+while IFS= read -r model_id; do
+  add_supported_model "$model_id"
+done <<< "${SUBCONSCIOUS_MODELS:-$DEFAULT_SUBCONSCIOUS_MODELS}"
+
+OVERLAY_DIR="$(mktemp -d "${TMPDIR:-/tmp}/subc-dsh.XXXXXX")"
+OVERLAY_FILE="${OVERLAY_DIR}/subconscious.cordis.yml"
+cleanup() {
+  rm -f "$OVERLAY_FILE"
+  rmdir "$OVERLAY_DIR" 2>/dev/null || true
+}
+trap cleanup EXIT HUP INT TERM
+
+{
+  printf '%s\n' \
+    '# Generated temporarily by subc. Contains no API key.' \
+    '- id: llm-pi-ai' \
+    '  config:' \
+    '    providers:' \
+    '      subconscious:' \
+    '        apiKeyEnv: SUBCONSCIOUS_API_KEY' \
+    '        displayName: Subconscious Gateway' \
+    '        api: openai-completions' \
+    '        baseURL: !!js process.env.SUBCONSCIOUS_DSH_BASE_URL' \
+    '        headers:' \
+    '          x-subconscious-client: deepseek-harness' \
+    '        compat:' \
+    '          supportsDeveloperRole: false' \
+    '          maxTokensField: max_tokens' \
+    "        defaultContextWindow: ${CONTEXT_WINDOW}" \
+    "        defaultMaxTokens: ${MAX_TOKENS}" \
+    '        models:'
+  for model_id in "${SUPPORTED_MODELS[@]}"; do
+    printf "          - id: '%s'\n" "$model_id"
+    printf "            name: '%s'\n" "$model_id"
+    printf "            contextWindow: %s\n" "$CONTEXT_WINDOW"
+    printf "            maxTokens: %s\n" "$MAX_TOKENS"
+  done
+  printf '%s\n' \
+    '- id: agent-default-model' \
+    '  config:' \
+    '    provider: subconscious' \
+    "    model: '${MODEL}'"
+} >"$OVERLAY_FILE"
+chmod 600 "$OVERLAY_FILE"
+
+export SUBCONSCIOUS_API_KEY="$API_KEY"
+export SUBCONSCIOUS_DSH_BASE_URL="${GATEWAY_URL%/}/v1"
+
+mode="web"
+if [[ "${1:-}" == "web" || "${1:-}" == "headless" ]]; then
+  mode="$1"
+  shift
+fi
+
+set +e
+if [[ "$mode" == "headless" ]]; then
+  dsh --profile headless --patch "$OVERLAY_FILE" "$@"
+else
+  dsh web --patch "$OVERLAY_FILE" "$@"
+fi
+status=$?
+set -e
+exit "$status"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "subconscious-cli",
-  "version": "4.0.4",
-  "description": "CLI for Subconscious — run Claude Code, Codex, OpenCode, Cursor, Copilot, and Pi",
+  "version": "4.0.5",
+  "description": "CLI for Subconscious — run Claude Code, Codex, OpenCode, DeepSeek Harness, Cursor, Copilot, and Pi",
   "bin": {
     "subc": "bin/cli.js"
   },
@@ -34,6 +34,7 @@
     "cursor",
     "copilot",
     "pi",
+    "deepseek-harness",
     "launcher"
   ],
   "author": "Subconscious Systems",