dsh-wsl-workspace 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-wsl-workspace contributors
+
+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/NOTICE

@@ -0,0 +1,68 @@
+# Third-party notices
+
+This plugin is published under the MIT License (see [LICENSE](LICENSE)). It
+adapts source code and references the design of the following projects. All
+are permissive licenses (MIT / BSD-3-Clause) that permit modification and
+redistribution with attribution. Where source code was adapted or inherited,
+the original copyright and license notices are preserved in the adapted
+sources.
+
+## Adapted / inherited source code
+
+### DeepSeek Harness (MIT) — https://github.com/deepseek-ai/deepseek-harness
+
+Copyright (c) DeepSeek (Beijing) Intelligent Technology Co., Ltd.
+
+This plugin is part of the DeepSeek Harness ecosystem and directly adapts or
+inherits source code from the upstream repository:
+
+- `@deepseek-ai/dsh-bash-local` (packages/shell/bash-local) — the executor
+  mechanics of `WslShellExecutor` (`src/shell.ts`) are adapted from this
+  package: the fused timeout/abort deadline, bounded collect output with
+  spill files, the background-process adaptation, and the `ENV_OVERRIDES`
+  model-friendly environment set. The WSL argv, WSLENV translation, and
+  workdir planning are original to this plugin.
+- `@deepseek-ai/dsh-fs-local` (packages/fs/fs-local) — `WslFileSystem`
+  (`src/fs.ts`) subclasses `LocalFileSystem` unchanged for realpath target
+  identity, per-target write locks, atomic staging, and version guards, and
+  overrides the atomic-publication primitives (rename-based, since the WSL
+  9P share has no hard links) plus the path-world translation.
+- `apps/cli/config/agent-presets/{standard,minimal,code,cordis}/agent.cordis.yml`
+  — the preset-variant generator (`src/host/variants.ts`) reads and
+  transforms these shipped compositions; the variant persona text is
+  rewritten from the `standard` persona.
+
+The upstream license text is included in the repository at `LICENSE` (root)
+and applies to the adapted portions above.
+
+## Design references (no source code copied)
+
+### dsh-bash-terminal (MIT) — https://github.com/MAXeaglet/dsh-bash-terminal
+
+Copyright (c) MAXeaglet. The `wsl.exe` argument construction
+(`wsl -d <distro> --cd <dir> -e bash -lc`), the WSLENV environment-passing
+approach, and the documented ConPTY/wsl.exe interactive-terminal caveats
+(0x8007072c) informed `src/shell.ts` and the design. No source files were
+copied.
+
+### dsh-side-panel (BSD-3-Clause) — https://github.com/ccq1/dsh-side-panel
+
+Copyright (c) ccq1. The pattern of a third-party plugin serving its own data
+route to the browser informed the `/wsl-workspace/api` route
+(`src/index.ts`) and the dialog's stylesheet-injection approach
+(`src/client/styles.ts`). The implementation is original to this plugin; no
+source files were copied.
+
+### vpshub (MIT) — https://github.com/Sdongmaker/vpshub
+
+Copyright (c) Sdongmaker. The SSH-ledger model (connections as first-class
+entries, credentials as path references) is the reference for the planned SSH
+remote-workspace extension (roadmap M4). No source files were copied.
+
+## Dependency licenses (runtime, resolved from the hosting harness)
+
+At runtime this plugin imports `@deepseek-ai/cordis`, `@deepseek-ai/dsh-fs`,
+`@deepseek-ai/dsh-fs-local`, `@deepseek-ai/dsh-shell`,
+`@deepseek-ai/dsh-subprocess`, and `@deepseek-ai/dsh-timeout` as peer
+dependencies provided by the DeepSeek Harness installation (MIT). No
+third-party runtime dependency is bundled inside this package.

package/README.md

@@ -0,0 +1,30 @@
+# dsh-wsl-workspace
+
+[中文](README.zh.md)
+
+Add a WSL workspace from the DeepSeek Harness web GUI and run the whole agent session — bash commands and file reads/writes — inside a local WSL distribution with Linux paths. Nothing needs to be installed inside WSL.
+
+## Install
+
+Pick one of the three ways below, then restart `dsh web`:
+
+```powershell
+# 1) npm package
+dsh plugin --profile web add dsh-wsl-workspace
+
+# 2) GitHub repository (ships the prebuilt lib/, no local build required)
+dsh plugin --profile web add https://github.com/6Mikao9/dsh-wsl-workspace
+
+# 3) Local directory (development / self-hosted)
+dsh plugin --profile web add D:\path\to\dsh-wsl-workspace
+```
+
+After restarting `dsh web`, a W button appears beside Settings at the sidebar foot.
+
+## Usage
+
+Click the W button beside Settings at the sidebar foot to open the "Add WSL workspace" dialog. Pick a distribution from the list, then browse the directory tree or type an absolute Linux path (for example `/home/me/proj`) — use the Check button to verify the path exists before creating the workspace. The username field is optional: leave it empty to run commands as the distribution's default user, or name a Linux user of that distribution to run the session as that user instead (equivalent to `wsl.exe -u <username>`). The username only changes the bash tool's run identity — the file tools go through the Windows-side WSL share and are unaffected. Each workspace's username is kept in `<dshHome>/wsl-workspaces.json`; delete the entry (or recreate the workspace from the dialog) to return to the default user.
+
+Click "Create & open" to start a new session in the workspace. In the new session the bash tool executes commands inside the chosen distribution and `read`/`write`/`edit` operate on WSL files, so every path the model sees is a Linux path. The mode picker keeps working as usual: Standard, PTC, Minimal and Creative each land on their WSL variant automatically, and Windows files stay reachable from inside the session under `/mnt/<drive>` (for example `/mnt/c/Users/...`).
+
+License: MIT.

package/README.zh.md

@@ -0,0 +1,30 @@
+# dsh-wsl-workspace
+
+[English](README.md)
+
+在 DeepSeek Harness Web GUI 中「添加 WSL 工作区」：让 agent 会话的 bash 命令与文件读写都运行在本机 WSL 发行版里，路径均为 Linux 形式，WSL 内无需安装任何工具链。
+
+## 安装
+
+三种方式任选其一，然后重启 `dsh web`：
+
+```powershell
+# 1) npm 包
+dsh plugin --profile web add dsh-wsl-workspace
+
+# 2) GitHub 仓库（仓库内已含预构建 lib/，无需本地构建）
+dsh plugin --profile web add https://github.com/6Mikao9/dsh-wsl-workspace
+
+# 3) 本地目录（开发/自用）
+dsh plugin --profile web add D:\path\to\dsh-wsl-workspace
+```
+
+重启 `dsh web` 后，侧栏底部 Settings 旁出现 W 按钮。
+
+## 使用
+
+点侧栏底部 Settings 旁的 W 按钮，打开「添加 WSL 工作区」对话框。先从下拉框选择一个发行版，再浏览目录树或直接输入 Linux 绝对路径（如 `/home/me/proj`），可以点「检查」确认路径存在。用户名是可选项：留空则以该发行版的默认用户运行，填写该发行版里的某个 Linux 用户名则以该用户运行（等价于 `wsl.exe -u <用户名>`）。用户名只影响 bash 命令的运行身份，文件工具通过 Windows 侧的 WSL 共享访问、不受其影响；每个工作区填写的用户名保存在 `<dshHome>/wsl-workspaces.json`，删除对应条目（或重开对话框重建工作区）即可恢复默认用户。
+
+点「创建并打开」后，新会话随即运行在 WSL：`bash` 工具在所选发行版内执行命令，`read`/`write`/`edit` 读写 WSL 文件，模型看到的所有路径都是 Linux 形式。模式选择器照常可用——标准、PTC、极简、创造都会自动落到对应的 WSL 变体；会话内仍可通过 `/mnt/<drive>`（如 `/mnt/c/Users/...`）访问 Windows 文件。
+
+许可：MIT。

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+# dsh-wsl-workspace bundle patch: inserts the host row into the profile's plugin
+# roster. The browser half rides the package's `dsh.client` manifest (the client
+# registry serves lib/client.js), and the host row materializes the `wsl` agent
+# preset on boot. Install with `dsh plugin --profile <name> add <path-or-git-url>`.
+- insert:
+    - id: wsl-workspace
+      name: 'dsh-wsl-workspace'