paseo-dsh-direct 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jecvay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# paseo-dsh-direct
+
+English | [中文](README.zh.md)
+
+`paseo-dsh-direct` connects a local [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh`) to [Paseo](https://github.com/getpaseo/paseo) through a Direct Provider.
+
+Version `0.1.3` registers the provider `dsh-pi`, shown in Paseo as **DeepSeek Harness**. The plugin id is `paseo-dsh-direct`.
+
+## Install locally
+
+The validated alpha combination is Paseo `0.9.2`, DSH `0.1.7-rc.2`, and a supported Node.js runtime. DSH must already be installed on the Paseo Daemon host; no other DSH add-on is needed.
+
+```bash
+git clone https://github.com/Jecvay/paseo-dsh-direct.git
+cd paseo-dsh-direct
+npm ci
+npm run build
+paseo plugin install "$PWD"
+paseo plugin ls
+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. Git installation is available for an existing remote ref:
+
+```bash
+paseo plugin add Jecvay/paseo-dsh-direct --ref <tag-or-commit>
+```
+
+## Versioning
+
+The plugin's `major.minor` tracks the dsh line it supports (`0.1.x` works with dsh `0.1.*`); the patch number is the plugin's own release count and does not follow dsh. Install the tag that matches your local dsh version.
+
+| Plugin line | dsh line |
+|---|---|
+| `0.1.x` | `0.1.*` |
+
+See the [compatibility notes](docs/compatibility.md) for the full rule and the dsh versions actually tested.
+
+## Use
+
+Create a conversation with the **DeepSeek Harness** provider. Models and presets come from the configured DSH profile. Existing native DSH sessions are available through Paseo's **Import session** flow and retain their native session identity.
+
+The provider supports streamed assistant and reasoning output, tool execution and approval, user questions, model/preset configuration, interruption, and session recovery. It starts DSH with its own `paseo` profile and does not modify Paseo or DSH core.
+
+The plugin uses the DSH profile `paseo`. On first start it creates that profile from DSH's official `web` template (`~/.dsh/profiles/paseo`, or under `$DSH_HOME` when set). Model routes, the default model, and permission presets go in `~/.dsh/profiles/paseo/cordis.patch.yml`. Set `PASEO_DSH_EXECUTABLE` to use a different `dsh` executable, or `PASEO_DSH_PROFILE` to use another existing profile; a profile named there is not created automatically. If the Paseo Daemon has plugin loading disabled, enable `pluginsEnabled` in its configuration before installing the plugin.
+
+If a native session is still held by another DSH client (such as a terminal UI), release it there before importing or resuming it from Paseo.
+
+## Development
+
+```bash
+npm ci
+npm run build
+npm run typecheck
+npm test
+npm run verify:notes
+npm run verify:docs
+```
+
+Read the [documentation index](docs/README.md), [English installation guide](docs/en/installation.md), [English compatibility notes](docs/en/compatibility.md), or the [Chinese documentation](README.zh.md).
+
+## License
+
+[MIT](LICENSE)

package/README.zh.md

@@ -0,0 +1,64 @@
+# paseo-dsh-direct
+
+[English](README.md) | 中文
+
+`paseo-dsh-direct` 通过 Direct Provider，把本机的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（`dsh`）接入 [Paseo](https://github.com/getpaseo/paseo)。
+
+当前版本为 `0.1.3`。插件注册 Provider `dsh-pi`，在 Paseo 中显示为 **DeepSeek Harness**；插件标识为 `paseo-dsh-direct`。
+
+## 本地安装
+
+当前 alpha 验证组合为 Paseo `0.9.2`、DSH `0.1.7-rc.2`，以及受支持的 Node.js 运行时。运行 Paseo Daemon 的主机需要预先装好 DSH，不需要额外的 DSH 扩展包。
+
+```bash
+git clone https://github.com/Jecvay/paseo-dsh-direct.git
+cd paseo-dsh-direct
+npm ci
+npm run build
+paseo plugin install "$PWD"
+paseo plugin ls
+paseo provider models dsh-pi
+```
+
+构建后也可以直接安装本地源码：`paseo plugin install /absolute/path/to/paseo-dsh-direct`。从 Git 安装已有远端 ref：
+
+```bash
+paseo plugin add Jecvay/paseo-dsh-direct --ref <tag-or-commit>
+```
+
+## 版本号
+
+插件版本号的 `major.minor` 跟随它支持的 dsh 线（`0.1.x` 对应 dsh `0.1.*`）；最后一位是插件自己的发布计数，不跟 dsh 走。按本机的 dsh 版本选装对应 tag。
+
+| 插件版本线 | dsh 版本线 |
+|---|---|
+| `0.1.x` | `0.1.*` |
+
+完整规则和已实测的 dsh 版本见[兼容性说明](docs/compatibility.md)。
+
+## 使用
+
+新建对话时选择 **DeepSeek Harness**。模型和 preset 来自已配置的 DSH profile。已有原生 DSH 会话可通过 Paseo 的 **Import session** 导入，并保留原生会话标识。
+
+Provider 支持连续正文和思考输出、工具执行与审批、用户问答、模型和 preset 配置、中断及会话恢复。它用插件专用的 `paseo` profile 启动 DSH，不修改 Paseo 或 DSH 核心。
+
+插件使用名为 `paseo` 的 DSH profile。首次启动时，插件用 DSH 官方的 `web` 模板自动创建它（位置是 `~/.dsh/profiles/paseo`；设置了 `$DSH_HOME` 时在其下）。模型路由、默认模型和权限预设写在 `~/.dsh/profiles/paseo/cordis.patch.yml`。可通过 `PASEO_DSH_EXECUTABLE` 指定其他 `dsh` 可执行文件，通过 `PASEO_DSH_PROFILE` 改用另一个已存在的 profile；这样指定的 profile 不会被自动创建。如果 Paseo Daemon 默认关闭插件加载，请先在配置中启用 `pluginsEnabled`。
+
+如果原生会话仍被另一个 DSH 客户端（如终端界面）占用，请先在那里释放，再从 Paseo 导入或恢复。
+
+## 开发
+
+```bash
+npm ci
+npm run build
+npm run typecheck
+npm test
+npm run verify:notes
+npm run verify:docs
+```
+
+参阅[文档索引](docs/README.md)、[兼容性说明](docs/compatibility.md)、[插件开发与验证](docs/plugin-guide.md)和 [Alpha 验收规范](docs/alpha-acceptance.md)。
+
+## 许可
+
+[MIT](LICENSE)

package/dsh.svg

@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="DeepSeek Harness">
+  <defs>
+    <linearGradient id="wave" x1="8" y1="10" x2="56" y2="54" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#6A8DFF"/>
+      <stop offset="1" stop-color="#3158E6"/>
+    </linearGradient>
+  </defs>
+  <path fill="url(#wave)" d="M8 34c7-13 18-20 33-20 6 0 11 1 15 4-2 13-8 23-18 29-8 5-17 6-27 3 7-2 12-6 15-11-7 2-13 0-18-5Z"/>
+  <circle cx="43" cy="25" r="3" fill="#fff"/>
+  <path d="M13 42c8 4 17 3 25-2" fill="none" stroke="#fff" stroke-width="3" stroke-linecap="round" opacity=".9"/>
+</svg>

package/index.client.tsx

@@ -0,0 +1,6 @@
+import type { PluginClientContext } from "@getpaseo/plugin/client";
+
+/** Provider presentation is supplied by the server registration and its SVG asset. */
+export default function contribute(_client: PluginClientContext) {
+  return () => {};
+}

package/index.server.ts

@@ -0,0 +1,19 @@
+import type { PluginServerContext } from "@getpaseo/plugin/server";
+import { launchDshBridge } 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) {
+  server.registerProvider(
+    createDshProvider({
+      createBridge: (launch) =>
+        launchDshBridge({
+          ...launch,
+          bridgeSource: DSH_BRIDGE_SOURCE,
+          executable: process.env.PASEO_DSH_EXECUTABLE,
+          profile: process.env.PASEO_DSH_PROFILE,
+        }),
+    }),
+  );
+  return () => {};
+}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "paseo-dsh-direct",
+  "version": "0.1.4",
+  "description": "DeepSeek Harness Direct Provider Plugin for Paseo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Jecvay/paseo-dsh-direct.git"
+  },
+  "license": "MIT",
+  "keywords": [
+    "paseo-plugin",
+    "paseo",
+    "dsh",
+    "deepseek-harness",
+    "provider"
+  ],
+  "type": "module",
+  "files": [
+    "index.server.ts",
+    "index.client.tsx",
+    "server",
+    "shared",
+    "scripts/build.mjs",
+    "scripts/install-lefthook.mjs",
+    "paseo-plugin.json",
+    "dsh.svg",
+    "!server/**/*.test.ts",
+    "!server/generated-bridge.ts",
+    "!server/generated-version.ts"
+  ],
+  "peerDependencies": {
+    "@getpaseo/client": "0.9.2",
+    "@getpaseo/protocol": "0.9.2",
+    "react": "~19.1.0",
+    "react-native": ">=0.81.5"
+  },
+  "peerDependenciesMeta": {
+    "@getpaseo/client": {
+      "optional": true
+    },
+    "@getpaseo/protocol": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@getpaseo/plugin": "0.9.2",
+    "@types/mdast": "^4.0.4",
+    "@types/node": "^24.0.0",
+    "esbuild": "^0.25.0",
+    "lefthook": "^2.1.9",
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-gfm": "^3.1.0",
+    "micromark-extension-gfm": "^3.0.0",
+    "tsx": "^4.22.4",
+    "typescript": "^5.9.3",
+    "zod": "^4.4.3"
+  },
+  "scripts": {
+    "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",
+    "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\"",
+    "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",
+    "verify-archived-agent-notes": "tsx scripts/verify-archived-agent-notes.ts"
+  }
+}

package/paseo-plugin.json

@@ -0,0 +1,10 @@
+{
+  "id": "paseo-dsh-direct",
+  "requirements": {
+    "paseo": ">=0.8.0"
+  },
+  "build": [
+    ["npm", "install", "--include=dev"],
+    ["npm", "run", "build"]
+  ]
+}

package/scripts/build.mjs

@@ -0,0 +1,31 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises'
+import { build } from 'esbuild'
+
+const result = await build({
+  entryPoints: ['server/dsh/bridge.ts'],
+  outfile: 'dist/dsh-bridge.mjs',
+  bundle: true,
+  format: 'esm',
+  platform: 'node',
+  target: 'node22',
+  sourcemap: false,
+  legalComments: 'none',
+  write: false,
+})
+
+const bridge = result.outputFiles.find(file => file.path.endsWith('/dsh-bridge.mjs'))
+if (!bridge) throw new Error('esbuild did not produce dist/dsh-bridge.mjs')
+await mkdir('dist', { recursive: true })
+await writeFile('dist/dsh-bridge.mjs', bridge.contents)
+await writeFile(
+  'server/generated-bridge.ts',
+  `// Generated by npm run build; do not edit.\nexport const DSH_BRIDGE_SOURCE = ${JSON.stringify(bridge.text)};\n`,
+)
+
+// Paseo only loads plugin modules from client/, server/ and shared/, so the
+// plugin version is baked in here instead of importing package.json at runtime.
+const { version } = JSON.parse(await readFile('package.json', 'utf8'))
+await writeFile(
+  'server/generated-version.ts',
+  `// Generated by npm run build; do not edit.\nexport const PLUGIN_VERSION = ${JSON.stringify(version)};\n`,
+)