paseo-dsh-direct 0.2.1 → 0.2.2

package/README.md

@@ -6,7 +6,7 @@ English | [中文](README.zh.md)
 
 ## Install
 
-You need `dsh` on the machine that runs the Paseo daemon, with the same `major.minor` as the plugin line you install.
+You need Paseo 0.11 or later and `dsh` on the machine that runs the Paseo daemon, with the same `major.minor` as the plugin line you install. On Paseo 0.8 to 0.10, install `npm:paseo-dsh-direct@0.2.1`.
 
 In Paseo, open **Settings → Plugins → Install Plugin** and paste either the npm or the Git source:
 
@@ -57,7 +57,7 @@ paseo provider models dsh-pi
 The same local source can be installed directly with `paseo plugin install /absolute/path/to/paseo-dsh-direct` after building. The CLI also accepts a Git ref that the Settings UI cannot:
 
 ```bash
-paseo plugin install https://github.com/Jecvay/paseo-dsh-direct --ref <tag-or-commit>
+paseo plugin install github:Jecvay/paseo-dsh-direct --ref <tag-or-commit>
 ```
 
 ## Development

package/README.zh.md

@@ -6,7 +6,7 @@
 
 ## 安装
 
-运行 Paseo daemon 的机器上要装好 `dsh`，它的 `major.minor` 要和你装的插件线一致。
+需要 Paseo 0.11 及以上，并在运行 Paseo daemon 的机器上装好 `dsh`，它的 `major.minor` 要和你装的插件线一致。Paseo 0.8 至 0.10 请安装 `npm:paseo-dsh-direct@0.2.1`。
 
 在 Paseo 里打开 **Settings → Plugins → Install Plugin**，npm 和 Git 两种来源任填一个：
 
@@ -57,7 +57,7 @@ paseo provider models dsh-pi
 构建后也可以直接安装本地源码：`paseo plugin install /absolute/path/to/paseo-dsh-direct`。命令行还能指定 Settings 界面给不了的 Git ref：
 
 ```bash
-paseo plugin install https://github.com/Jecvay/paseo-dsh-direct --ref <tag-or-commit>
+paseo plugin install github:Jecvay/paseo-dsh-direct --ref <tag-or-commit>
 ```
 
 ## 开发

package/index.server.ts

@@ -1,16 +1,18 @@
 import type { PluginServerContext } from "@getpaseo/plugin/server";
-import { launchDshBridge } from "./server/bridge-client.js";
+import { launchDshBridge, resolveDshExecutable } from "./server/bridge-client.js";
 import { DSH_BRIDGE_SOURCE } from "./server/generated-bridge.js";
 import { createDshProvider } from "./server/provider.js";
 
 export default function contribute(server: PluginServerContext) {
+  const executable = resolveDshExecutable(process.env.PASEO_DSH_EXECUTABLE);
   server.registerProvider(
     createDshProvider({
+      executable,
       createBridge: (launch) =>
         launchDshBridge({
           ...launch,
           bridgeSource: DSH_BRIDGE_SOURCE,
-          executable: process.env.PASEO_DSH_EXECUTABLE,
+          executable,
           profile: process.env.PASEO_DSH_PROFILE,
         }),
     }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paseo-dsh-direct",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "DeepSeek Harness Direct Provider Plugin for Paseo",
   "repository": {
     "type": "git",
@@ -24,13 +24,14 @@
     "scripts/install-lefthook.mjs",
     "paseo-plugin.json",
     "dsh.svg",
+    "dsh.png",
     "!server/**/*.test.ts",
     "!server/generated-bridge.ts",
     "!server/generated-version.ts"
   ],
   "peerDependencies": {
-    "@getpaseo/client": "0.9.2",
-    "@getpaseo/protocol": "0.9.2",
+    "@getpaseo/client": "0.11.2",
+    "@getpaseo/protocol": "0.11.2",
     "react": "~19.1.0",
     "react-native": ">=0.81.5"
   },
@@ -49,7 +50,7 @@
     }
   },
   "devDependencies": {
-    "@getpaseo/plugin": "0.9.2",
+    "@getpaseo/plugin": "0.11.2",
     "@types/mdast": "^4.0.4",
     "@types/node": "^24.0.0",
     "esbuild": "^0.25.0",
@@ -65,13 +66,13 @@
     "build": "node scripts/build.mjs",
     "smoke:bridge": "npm run build && tsx scripts/smoke-bridge.ts",
     "board": "tsx scripts/board.ts",
-    "board:poll": "tsx scripts/board-poll.ts",
+    "agent-loop": "tsx scripts/agent-loop/main.ts",
     "typecheck": "npm run typecheck:shared && npm run typecheck:server && npm run typecheck:client && npm run typecheck:scripts",
     "typecheck:shared": "tsc -p tsconfig.shared.json",
     "typecheck:server": "tsc -p tsconfig.server.json",
     "typecheck:client": "tsc -p tsconfig.client.json",
     "typecheck:scripts": "tsc -p tsconfig.scripts.json",
-    "test": "tsx --test \"server/**/*.test.ts\"",
+    "test": "tsx --test \"server/**/*.test.ts\" \"scripts/**/*.test.ts\"",
     "postinstall": "node scripts/install-lefthook.mjs",
     "verify:notes": "tsx scripts/verify-agent-note-classification.ts && tsx scripts/verify-agent-note-format.ts && tsx scripts/verify-archived-agent-notes.ts",
     "verify:docs": "tsx scripts/verify-md-links.ts && tsx scripts/verify-doc-refs.ts",

package/paseo-plugin.json

@@ -1,7 +1,9 @@
 {
   "id": "paseo-dsh-direct",
+  "name": "DeepSeek Harness",
+  "icon": "dsh.png",
   "requirements": {
-    "paseo": ">=0.8.0"
+    "paseo": ">=0.11.0"
   },
   "build": [
     ["npm", "install", "--include=dev"],

package/server/bridge-client.ts

@@ -199,9 +199,14 @@ function runProfileInit(
   });
 }
 
+/** The `dsh` executable for a configured `PASEO_DSH_EXECUTABLE` value: the trimmed value, or `dsh` from `PATH` when it is blank or unset. */
+export function resolveDshExecutable(configured: string | undefined): string {
+  return configured?.trim() || "dsh";
+}
+
 export async function launchDshBridge(options: LaunchBridgeOptions): Promise<DshBridge> {
   const profile = options.profile?.trim() || DEFAULT_PROFILE;
-  const executable = options.executable?.trim() || "dsh";
+  const executable = resolveDshExecutable(options.executable);
   const env = { ...process.env, ...options.env };
   await ensureDshProfile({ executable, profile, env });
   const directory = await mkdtemp(path.join(tmpdir(), "paseo-dsh-direct-"));

package/server/provider.ts

@@ -11,6 +11,7 @@ import {
   type ProviderPermissionResponse,
   type ProviderRegistration,
   type ProviderSessionConfig,
+  type ProviderStatus,
 } from "@getpaseo/plugin/server/provider";
 import type {
   BridgeCatalog,
@@ -48,6 +49,8 @@ const PLAN_MODE_SETTING = "planMode";
 
 interface DshProviderOptions {
   createBridge(launch?: SessionLaunch): Promise<DshBridge>;
+  /** The dsh executable `createBridge` launches; `status()` probes this same path. */
+  executable: string;
   /** Detects the local dsh version for the startup compatibility check; defaults to spawning `<exe> --version`. */
   detectDshVersion?: (executable: string) => Promise<string>;
 }
@@ -88,6 +91,9 @@ export function createDshProvider(options: DshProviderOptions): ProviderRegistra
     icon: "dsh.svg",
     getCatalogCacheKey: async (options) =>
       options.scope === "workspace" ? `dsh-pi:${options.cwd}` : "dsh-pi:global",
+    async status() {
+      return dshStatus(options.executable, options.detectDshVersion ?? detectDshVersion);
+    },
     async connect(request) {
       if (!request.versions.includes(1)) throw new Error("Provider protocol version 1 is required");
       const bridge = await options.createBridge();
@@ -107,6 +113,30 @@ export function createDshProvider(options: DshProviderOptions): ProviderRegistra
   };
 }
 
+/**
+ * Availability of the local dsh for Paseo 0.11+ provider listings. A dsh that
+ * does not answer `--version` is unavailable; a version outside the plugin's
+ * major.minor line stays available with the same warning the session timeline
+ * shows, since only DSH's own handshake can reject a session.
+ */
+async function dshStatus(
+  executable: string,
+  detectVersion: (executable: string) => Promise<string>,
+): Promise<ProviderStatus> {
+  const dshVersion = await detectVersion(executable).catch(() => "");
+  if (!dshVersion) {
+    return {
+      available: false,
+      diagnostic:
+        `Could not run "${executable} --version". Install dsh or set PASEO_DSH_EXECUTABLE to its path, ` +
+        `then restart the Paseo daemon.`,
+    };
+  }
+  const match = matchVersionLine(PLUGIN_VERSION, dshVersion);
+  if (match === "match") return { available: true };
+  return { available: true, diagnostic: versionWarningMessage(match, PLUGIN_VERSION, dshVersion) };
+}
+
 function createConnection(
   discoveryBridge: DshBridge,
   createBridge: DshProviderOptions["createBridge"],