@vidge/dsh-agent-hub 0.1.0-rc1 → 0.1.0-rc2

package/README.md

@@ -64,19 +64,36 @@ runtime state — switching never requires a restart again.
 > can take the factory slot and re-mount that loop itself. Everything else in
 > that file is preserved byte for byte.
 
-### Requirements
+### Engine dependencies
 
-Only for the engines you actually use:
+Each engine's SDK is an **optional peer** — installing this plugin pulls in the
+router only. Add the engines you actually want:
 
-- **Claude Code** — the Claude Code CLI installed on the host. Credentials are
-  derived from dsh's own LLM provider configuration (see below); a CLI login is
-  a fallback, not a requirement.
+```sh
+# Claude Code
+pnpm add @anthropic-ai/claude-agent-sdk
+# Codex
+pnpm add @openai/codex
+# Pi
+pnpm add @earendil-works/pi-coding-agent
+```
+
+The `in-process` engine needs nothing beyond dsh itself, so a profile that
+installs no SDK at all still works.
+
+Selecting an engine whose SDK is missing fails that turn with a message naming
+the package to install; it never affects other sessions or engines.
+
+### Authentication
+
+Only for the engines you use:
+
+- **Claude Code** — credentials are derived from dsh's own LLM provider
+  configuration (see below); a CLI login is a fallback, not a requirement.
 - **Codex** — authenticated via `codex login`, or a `CODEX_API_KEY` entry.
 - **Pi** — authenticated the way `pi` expects: its own `~/.pi/agent/auth.json`,
   or the provider's API-key environment variable.
 
-The in-process engine needs nothing beyond dsh itself.
-
 ## Usage
 
 Choose an engine in the composer when starting a session. To change engines,

package/README.zh.md

@@ -55,18 +55,36 @@ dsh plugin --profile web add @vidge/dsh-agent-hub
 > `agent-loop` 行，以便路由器接管 factory 槽位并由它自己重新挂载该 loop。文件中
 > 其余内容逐字节保留。
 
-### 依赖要求
+### 引擎依赖
+
+各引擎的 SDK 都是**可选 peer 依赖**——安装本插件只会装入路由器本身。按需添加你
+真正要用的引擎：
+
+```sh
+# Claude Code
+pnpm add @anthropic-ai/claude-agent-sdk
+# Codex
+pnpm add @openai/codex
+# Pi
+pnpm add @earendil-works/pi-coding-agent
+```
+
+`in-process` 引擎除 dsh 本身外无任何额外要求，因此一个 SDK 都不装的 profile 仍可
+正常工作。
+
+选择了 SDK 未安装的引擎时，只有该次对话失败，并给出需要安装哪个包的提示；不会影响
+其他会话或其他引擎。
+
+### 认证
 
 仅针对你实际使用的引擎：
 
-- **Claude Code** —— 宿主机安装 Claude Code CLI。凭证由 dsh 自身的 LLM provider
-  配置派生（见下文）；CLI 登录只是兜底，不是必需。
+- **Claude Code** —— 凭证由 dsh 自身的 LLM provider 配置派生（见下文）；CLI 登录
+  只是兜底，不是必需。
 - **Codex** —— 通过 `codex login` 认证，或提供 `CODEX_API_KEY`。
 - **Pi** —— 按 pi 自己的方式认证：`~/.pi/agent/auth.json`，或对应 provider 的
   API-key 环境变量。
 
-in-process 引擎除 dsh 本身外无任何额外要求。
-
 ## 使用
 
 在 composer 中开始会话时选择引擎。要换引擎，开一个新会话——当前会话保持它的引擎，

package/lib/index.js

@@ -65,7 +65,6 @@ import { Inbox, agentEvents } from "@deepseek-ai/dsh-agent";
 import { LlmError, createAssistantMessage, createUserMessage, errorChain } from "@deepseek-ai/dsh-llm";
 import { createScope } from "@deepseek-ai/dsh-scope";
 import { canonicalHeader } from "@deepseek-ai/dsh-session";
-import { query as officialQuery } from "@anthropic-ai/claude-agent-sdk";
 
 // src/engine-claude/mapping.ts
 import {
@@ -693,6 +692,19 @@ function invokedSkillNames(messages) {
 
 // src/engine-claude/agent.ts
 var PROVIDER = "claude-code";
+var claudeQueryPromise;
+async function loadClaudeQuery() {
+  claudeQueryPromise ??= import("@anthropic-ai/claude-agent-sdk").then(
+    (mod) => mod.query,
+    (error) => {
+      claudeQueryPromise = void 0;
+      throw new Error(
+        `the Claude Code engine requires "@anthropic-ai/claude-agent-sdk", which is not installed. Add it to this profile, or pick another engine for this session. (${String(error)})`
+      );
+    }
+  );
+  return claudeQueryPromise;
+}
 var NATIVE_MODEL_LABEL = "claude-code-native";
 function failureCode(subtype) {
   switch (subtype) {
@@ -1116,6 +1128,7 @@ var ClaudeCodeAgent = class {
           diagnostics.push(line);
         }
       }, controller);
+      const officialQuery = await loadClaudeQuery();
       const query = officialQuery({ prompt, options });
       let finished = false;
       const chunkSeqs = [];
@@ -1606,7 +1619,13 @@ import { dirname, join } from "node:path";
 import { createInterface } from "node:readline";
 var require2 = createRequire(import.meta.url);
 function codexCliEntrypoint() {
-  return join(dirname(require2.resolve("@openai/codex/package.json")), "bin", "codex.js");
+  try {
+    return join(dirname(require2.resolve("@openai/codex/package.json")), "bin", "codex.js");
+  } catch (error) {
+    throw new Error(
+      `the Codex engine requires "@openai/codex", which is not installed. Add it to this profile, or pick another engine for this session. (${String(error)})`
+    );
+  }
 }
 var AppServerClient = class _AppServerClient {
   process;
@@ -3609,7 +3628,14 @@ function resolveConfig3(config) {
   };
 }
 function piCliEntrypoint() {
-  const mainUrl = import.meta.resolve("@earendil-works/pi-coding-agent");
+  let mainUrl;
+  try {
+    mainUrl = import.meta.resolve("@earendil-works/pi-coding-agent");
+  } catch (error) {
+    throw new Error(
+      `the Pi engine requires "@earendil-works/pi-coding-agent", which is not installed. Add it to this profile, or pick another engine for this session. (${String(error)})`
+    );
+  }
   const root = dirname2(dirname2(fileURLToPath(mainUrl)));
   const pkg = JSON.parse(readFileSync(join2(root, "package.json"), "utf8"));
   const bin = pkg.bin;

package/package.json

@@ -4,7 +4,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.0-rc1",
+  "version": "0.1.0-rc2",
   "repository": "github:vidgewong/dsh-agent-hub",
   "type": "module",
   "main": "lib/index.js",
@@ -61,12 +61,8 @@
     "@anthropic-ai/sdk": "0.93.0",
     "@deepseek-ai/schemastery": "3.18.1"
   },
-  "optionalDependencies": {
-    "@anthropic-ai/claude-agent-sdk": "0.3.220",
-    "@earendil-works/pi-coding-agent": "0.84.3",
-    "@openai/codex": "0.149.1"
-  },
   "peerDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "0.3.220",
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-agent": "0.1.1-rc.2",
     "@deepseek-ai/dsh-agent-loop": "0.1.1-rc.2",
@@ -77,11 +73,14 @@
     "@deepseek-ai/dsh-session-persistence": "0.1.1-rc.2",
     "@deepseek-ai/dsh-settings": "0.1.1-rc.2",
     "@deepseek-ai/dsh-subprocess": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-timeout": "0.1.1-rc.2"
+    "@deepseek-ai/dsh-timeout": "0.1.1-rc.2",
+    "@earendil-works/pi-coding-agent": "0.84.3",
+    "@openai/codex": "0.149.1"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-attachment": "0.1.1-rc.2",
+    "@anthropic-ai/claude-agent-sdk": "0.3.220",
     "@deepseek-ai/dsh-agent-loop": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-attachment": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-locale": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-runtime": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-store": "0.1.2-alpha.2",
@@ -93,6 +92,8 @@
     "@deepseek-ai/dsh-session-persistence-jsonl": "0.1.1-rc.2",
     "@deepseek-ai/dsh-subprocess-local": "0.1.1-rc.2",
     "@deepseek-ai/dsh-system-prompt": "0.1.1-rc.2",
+    "@earendil-works/pi-coding-agent": "0.84.3",
+    "@openai/codex": "0.149.1",
     "@types/node": "^22.20.0",
     "@types/react": "^19.0.0",
     "@vitest/coverage-v8": "^4.1.8",
@@ -103,5 +104,16 @@
     "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^4.1.8",
     "yaml": "^2.9.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/claude-agent-sdk": {
+      "optional": true
+    },
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@openai/codex": {
+      "optional": true
+    }
   }
 }