agent-hitch 0.1.0 → 0.1.1

package/README.md

@@ -1,21 +1,30 @@
 # Hitch
 
-**One local runtime. Any coding agent.**
+[![npm version](https://img.shields.io/npm/v/agent-hitch.svg)](https://www.npmjs.com/package/agent-hitch)
+[![GitHub release](https://img.shields.io/github/v/release/rsi-gear/agent-hitch)](https://github.com/rsi-gear/agent-hitch/releases)
+[![Discord](https://img.shields.io/badge/Discord-Join_chat-5865F2?logo=discord&logoColor=white)](https://discord.gg/cZ4NBbHDk)
 
-Hitch is an agent-first CLI and daemon for discovering and running native coding
-agents through one stable, machine-oriented interface.
+**Let agents choose their harness with one runtime.**
 
-It lets an agent choose which harness and revision to use for each run. Hitch is
-designed as infrastructure for Recursive Self-Improvement (RSI), including harness evolution and model
-evolution.
+Hitch lets an agent choose which harness and revision to use for each run. It is
+an agent-first CLI and daemon for discovering and running native coding agents
+through one stable, machine-oriented interface.
+
+Hitch is designed as infrastructure for Recursive Self-Improvement (RSI),
+including harness evolution and model evolution.
 
 > Status: pre-alpha. Installed-harness discovery, immutable revision resolution,
 > prepared artifact caching, direct runs, the local daemon, and Harbor-backed
 > agent evals are implemented.
 
+## News
+
+- **2026-08-13:** Hitch now supports DeepSeek Harness.
+
 ## Available now
 
-Hitch currently supports Codex CLI, Claude Code, Pi, and OpenCode adapters. It provides:
+Hitch currently supports Codex CLI, Claude Code, Pi, OpenCode, and DeepSeek
+Harness adapters. It provides:
 
 - executable discovery, version probing, and executable fingerprints;
 - exact package-version and Git-commit resolution;
@@ -98,8 +107,8 @@ hitch daemon cancel run_<id>
 
 State is stored below `~/.hitch` by default. Use `--root <path>` or
 `HITCH_ROOT` to relocate it. Native executable overrides use
-`HITCH_CODEX_PATH`, `HITCH_CLAUDE_PATH`, `HITCH_PI_PATH`, and
-`HITCH_OPENCODE_PATH`.
+`HITCH_CODEX_PATH`, `HITCH_CLAUDE_PATH`, `HITCH_PI_PATH`,
+`HITCH_OPENCODE_PATH`, and `HITCH_DEEPSEEK_PATH`.
 
 ## Harbor-backed evals
 
@@ -168,8 +177,9 @@ hitch run \
 
 Version selectors require exact semantic versions; ranges and `latest` are not
 accepted. Short commit IDs are expanded and must be unambiguous. Local Git
-repositories must be clean. Codex and Pi support source-commit preparation;
-Claude Code and OpenCode currently support installed and exact-version sources.
+repositories must be clean. Codex, Pi, and DeepSeek Harness support
+source-commit preparation; Claude Code and OpenCode currently support installed
+and exact-version sources.
 
 The legacy `--agent <name>` option remains available as an alias for
 `--harness <name>@installed`. It cannot select revisions or be combined with
@@ -191,6 +201,7 @@ caller -> Hitch CLI / daemon -> shared run engine -> Codex CLI
                                              \----> Claude Code
                                              \----> Pi
                                              \----> OpenCode
+                                             \----> DeepSeek Harness
 ```
 
 The direct CLI and daemon use the same engine, so persistence, timeout,
@@ -219,6 +230,12 @@ cancellation, and event behavior do not drift.
 - [Agent daemon analysis and port](docs/daemon.md)
 - [Workspace isolation](docs/workspaces.md)
 - [Harbor-backed evals](docs/evals.md)
+- [Release process](docs/releasing.md)
+
+## Community
+
+Join the [Hitch community on Discord](https://discord.gg/cZ4NBbHDk) to ask
+questions, share feedback, and discuss coding-agent infrastructure.
 
 ## Acknowledgements
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-hitch",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A local runtime and daemon for coding agents",
   "keywords": [
     "ai-agents",

package/src/adapters.js

@@ -1,3 +1,4 @@
+import { mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { HitchError } from "./errors.js";
 
@@ -274,6 +275,54 @@ const definitions = {
       return translated;
     },
   },
+  deepseek: {
+    id: "deepseek",
+    display_name: "DeepSeek Harness",
+    command: "dsh",
+    path_env: "HITCH_DEEPSEEK_PATH",
+    version_args: ["--version"],
+    revision_sources: {
+      version: { type: "npm", package: "@deepseek-ai/dsh", bin: "dsh" },
+      commit: {
+        type: "git",
+        url: "https://github.com/deepseek-ai/deepseek-harness.git",
+        commands: [
+          { executable: "pnpm", args: ["install", "--frozen-lockfile"] },
+          { executable: "pnpm", args: ["run", "build"] },
+        ],
+        entrypoint: "apps/cli/lib/bin.js",
+      },
+    },
+    capabilities: {
+      non_interactive: true,
+      streaming: false,
+      structured_messages: false,
+      structured_tool_events: false,
+      sessions: false,
+      resume: false,
+      model_selection: true,
+      graceful_cancel: true,
+    },
+    async process(request, executable, runtime = {}) {
+      const args = ["--profile", "headless", ...request.agent_args];
+      if (request.model) {
+        const patchFile = await writeDeepseekModelPatch(request.model, runtime.run_directory);
+        args.push("--patch", patchFile);
+      }
+      args.push(request.prompt);
+      return {
+        executable,
+        args,
+        input: "",
+        env: runtime.runtime_home ? { DSH_HOME: runtime.runtime_home } : {},
+      };
+    },
+    translateLine(line, state = {}) {
+      const text = state.has_stdout_line ? `\n${line}` : line;
+      state.has_stdout_line = true;
+      return [{ type: "message.delta", text }];
+    },
+  },
 };
 
 function codexSupportsEphemeral(observedVersion) {
@@ -313,6 +362,31 @@ function openCodeErrorMessage(error) {
   return error == null ? "OpenCode error" : JSON.stringify(error);
 }
 
+async function writeDeepseekModelPatch(value, runDirectory) {
+  if (!runDirectory) {
+    throw new HitchError("DeepSeek model selection requires an isolated run directory", {
+      code: "adapter_setup_failed",
+      exitCode: 6,
+    });
+  }
+  const separator = value.indexOf("/");
+  const provider = separator < 0 ? "deepseek-official" : value.slice(0, separator);
+  const model = separator < 0 ? value : value.slice(separator + 1);
+  if (!provider || !model) {
+    throw new HitchError(`invalid DeepSeek model selector: ${value}`, {
+      code: "invalid_input",
+      exitCode: 2,
+    });
+  }
+  const file = path.join(runDirectory, "config", "deepseek-model.json");
+  await mkdir(path.dirname(file), { recursive: true });
+  await writeFile(file, `${JSON.stringify([{
+    id: "agent-default-model",
+    config: { provider, model },
+  }], null, 2)}\n`, { mode: 0o600 });
+  return file;
+}
+
 export function getAdapter(id) {
   const adapter = definitions[id];
   if (!adapter) {

package/src/artifacts.js

@@ -703,6 +703,7 @@ function commandExecutable(command, env) {
     git: "HITCH_GIT_PATH",
     cargo: "HITCH_CARGO_PATH",
     bun: "HITCH_BUN_PATH",
+    pnpm: "HITCH_PNPM_PATH",
   }[command];
   return override && env[override]?.trim() ? env[override].trim() : command;
 }
@@ -849,7 +850,7 @@ async function assertNpmResolution(directory, resolved) {
 }
 
 async function sourceLockIdentity(directory) {
-  const candidates = ["package-lock.json", "npm-shrinkwrap.json", "bun.lock", path.join("codex-rs", "Cargo.lock")];
+  const candidates = ["package-lock.json", "npm-shrinkwrap.json", "pnpm-lock.yaml", "bun.lock", path.join("codex-rs", "Cargo.lock")];
   const locks = {};
   for (const candidate of candidates) {
     const identity = await optionalFileDigest(path.join(directory, candidate));

package/src/engine.js

@@ -190,9 +190,11 @@ export async function executeRun({ runId, request, runsRoot, root = path.dirname
     const adapter = getAdapter(reference.harness_id);
     const adapterState = {};
     const executionRequest = { ...normalized, cwd: workspaceLease.execution_workspace };
-    const specification = adapter.process(executionRequest, artifact.executable, {
+    const specification = await adapter.process(executionRequest, artifact.executable, {
       observed_version: artifact.observed_version,
       resolution,
+      run_directory: runDirectory,
+      runtime_home: path.join(runDirectory, "runtime-home"),
     });
     if (artifact.entrypoint_args?.length) specification.args.unshift(...artifact.entrypoint_args);
     if (signal?.aborted) {
@@ -201,7 +203,11 @@ export async function executeRun({ runId, request, runsRoot, root = path.dirname
     } else {
       stage = "launch";
       workspaceLease = await markWorkspaceRunning(workspaceLease, { recordPath: workspacePath });
-      const childEnvironment = { ...process.env, PWD: workspaceLease.execution_workspace };
+      const childEnvironment = {
+        ...process.env,
+        ...specification.env,
+        PWD: workspaceLease.execution_workspace,
+      };
       delete childEnvironment.OLDPWD;
       child = spawn(specification.executable, specification.args, {
         cwd: workspaceLease.execution_workspace,
@@ -220,6 +226,14 @@ export async function executeRun({ runId, request, runsRoot, root = path.dirname
 
       consumeLines(child.stdout, (line) => {
         sink.writeStdout(line);
+        if (adapter.translateLine) {
+          for (const event of adapter.translateLine(line, adapterState)) {
+            if (event.type === "message.delta" && event.text) messageParts.push(event.text);
+            if (event.type === "message.completed" && typeof event.text === "string") finalMessage = event.text;
+            sink.emit(event);
+          }
+          return;
+        }
         let native;
         try {
           native = JSON.parse(line);

package/src/eval-tools.js

@@ -10,6 +10,8 @@ import { detectVersion, resolveExecutable } from "./registry.js";
 
 export const DEFAULT_HARBOR_VERSION = "0.21.0";
 export const HARBOR_CREDENTIAL_ENV = [
+  "DEEPSEEK_API_KEY",
+  "DEEPSEEK_BASE_URL",
   "OPENAI_API_KEY",
   "OPENAI_BASE_URL",
   "OPENAI_ORG_ID",
@@ -32,6 +34,7 @@ export const HARBOR_CREDENTIAL_ENV = [
   "GH_TOKEN",
 ];
 const PROVIDER_CREDENTIAL_ENV = [
+  "DEEPSEEK_API_KEY",
   "OPENAI_API_KEY",
   "ANTHROPIC_API_KEY",
   "ANTHROPIC_AUTH_TOKEN",