dsh-minimal-ptc 0.5.0 → 0.5.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 stardustlc
-
-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.
+MIT License
+
+Copyright (c) 2026 stardustlc
+
+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.en.md

@@ -1,65 +1,71 @@
-[中文](README.md)
-
-# dsh-minimal-ptc
-
-Adds **Minimal PTC** to DeepSeek Harness: a concise system prompt with files, terminals, search, skills and installed plugin tools, orchestrated through `run_code`. Windows includes Git Bash and persistent PowerShell.
-
-## Install and use
-
-Version 0.5.0 requires **Harness 0.1.7 or later**. Use `dsh-minimal-ptc@0.4.7` on Harness 0.1.5/0.1.6.
-
-```bash
-dsh plugin --profile web add dsh-minimal-ptc
-```
-
-Restart `dsh web`, start a new session and choose **极简 PTC 模式** (Minimal PTC) from the mode picker above the message box. Describe your task normally; no preset directory or YAML editing is required.
-
-For example: “Run this project’s tests, find the failures and fix them.” Existing email, calendar and other plugin tools remain available.
-
-## Changes in 0.5.0
-
-- Registers through the official Harness 0.1.7 declarative Agent preset service, fixing the missing mode after a host upgrade.
-- Installs and updates the preset with the plugin. Existing user content in `.agent-presets/ptc-minimal` is preserved.
-- Checks for conflicting runtime packages without flagging supported helpers such as `schemastery` and `cosmokit`.
-- Uses `workflow-ptc` and retains plugin tools, Git Bash, persistent PowerShell, search, plans, goals and subagents.
-
-## Compatibility and validation
-
-Tested on 2026-09-23 with official-source **Harness 0.1.7-alpha.2**, including a local `Symbol.for` tool-scheduler fix. All 18 plugins load together with passing tool contracts and skill registration. The real Web mode picker lists and selects the preset; a real agent mounts it with `run_code` as its model entry point while retaining plugin tools and the shell.
-
-A real `run_code` call to the RSS plugin passed in a sandboxed Windows workspace and again after restart. The fixture owner has full control of the disposable directory so the host can apply sandbox permissions. External mail, databases and other services still require their own valid configuration.
-
-Requires Node 22.19 or later within 22.x, or 24 or later.
-
-## Windows terminals
-
-A standard Git for Windows installation is detected automatically. For a custom location, set `GIT_BASH` to the full path of `bash.exe` before starting DSH. PowerShell sessions preserve their current directory, variables and functions.
-
-Developers creating their own preset can use the bundled `ptc-minimal.patch.yml` as a reference; the executor module is `dsh-minimal-ptc/gitbash-executor`.
-
-| Executor option | Default | Purpose |
-| :-- | :-- | :-- |
-| `shellPath` | auto-detected | Git Bash path |
-| `timeoutMs` | 120000 | Per-command timeout in ms |
-| `maxTimeoutMs` | 600000 | Maximum requested timeout |
-| `maxOutputBytes` | 64000 | Output cap per call |
-| `maxSpillBytes` | 67108864 | Output spill-to-disk cap |
-| `graceMs` | 3000 | Grace period after timeout |
-
-## Troubleshooting
-
-If the mode is missing, confirm Harness is 0.1.7 or later and restart after installation. Recreating a retired preset directory will not help: the new host does not discover presets there.
-
-If every tool fails with `Cannot read properties of undefined (reading 'prepare')`, check startup logs for duplicate runtime packages. Update the plugin bringing in extra `dsh-tools` / `cordis` copies and reinstall dependencies. Do not remove the entire `@deepseek-ai` directory: public helpers are supported dependencies. Another confirmed cause is the host loading two tool build outputs with a module-local scheduler `Symbol`; source builds can use `Symbol.for('@deepseek-ai/dsh-tools.scheduler')` and rebuild.
-
-## Uninstall
-
-```bash
-dsh plugin --profile web remove dsh-minimal-ptc
-```
-
-Restart the Web service afterward.
-
-## License
-
-MIT
+[中文](README.md)
+
+# dsh-minimal-ptc
+
+## 0.5.1 update (2026-09-27)
+
+Declares the tools service dependency so the startup health check can inspect the tool scheduler on the current Cordis host.
+
+Validation host: Harness `0.2.0-rc.1` built from official sources (commit `407e65c8`) with Node `24.16.0` on 2026-09-28. All 18 plugin tests pass in an isolated environment; all 18 plugins mount together in one host registering 0 tools, with tool schemas and health-check contracts passing. No live ports or external services were exercised in this round.
+
+Adds **Minimal PTC** to DeepSeek Harness: a concise system prompt with files, terminals, search, skills and installed plugin tools, orchestrated through `run_code`. Windows includes Git Bash and persistent PowerShell.
+
+## Install and use
+
+Version 0.5.0 requires **Harness 0.1.7 or later**. Use `dsh-minimal-ptc@0.4.7` on Harness 0.1.5/0.1.6.
+
+```bash
+dsh plugin --profile web add dsh-minimal-ptc
+```
+
+Restart `dsh web`, start a new session and choose **极简 PTC 模式** (Minimal PTC) from the mode picker above the message box. Describe your task normally; no preset directory or YAML editing is required.
+
+For example: “Run this project’s tests, find the failures and fix them.” Existing email, calendar and other plugin tools remain available.
+
+## Changes in 0.5.0
+
+- Registers through the official Harness 0.1.7 declarative Agent preset service, fixing the missing mode after a host upgrade.
+- Installs and updates the preset with the plugin. Existing user content in `.agent-presets/ptc-minimal` is preserved.
+- Checks for conflicting runtime packages without flagging supported helpers such as `schemastery` and `cosmokit`.
+- Uses `workflow-ptc` and retains plugin tools, Git Bash, persistent PowerShell, search, plans, goals and subagents.
+
+## Compatibility and validation
+
+Validation host: Harness `0.2.0-rc.1` built from official sources (commit `407e65c8`) with Node `24.16.0` on 2026-09-28. 18 plugin tests pass in an isolated environment (1 skipped); all 18 plugins load together in one host with passing tool contracts and skill registration. The real Web mode picker lists and selects the preset; a real agent mounts it with `run_code` as its model entry point while retaining plugin tools and the shell.
+
+A real `run_code` call to the RSS plugin passed in a sandboxed Windows workspace and again after restart. The fixture owner has full control of the disposable directory so the host can apply sandbox permissions. External mail, databases and other services still require their own valid configuration.
+
+Requires Node 22.19 or later within 22.x, or 24 or later.
+
+## Windows terminals
+
+A standard Git for Windows installation is detected automatically. For a custom location, set `GIT_BASH` to the full path of `bash.exe` before starting DSH. PowerShell sessions preserve their current directory, variables and functions.
+
+Developers creating their own preset can use the bundled `ptc-minimal.patch.yml` as a reference; the executor module is `dsh-minimal-ptc/gitbash-executor`.
+
+| Executor option | Default | Purpose |
+| :-- | :-- | :-- |
+| `shellPath` | auto-detected | Git Bash path |
+| `timeoutMs` | 120000 | Per-command timeout in ms |
+| `maxTimeoutMs` | 600000 | Maximum requested timeout |
+| `maxOutputBytes` | 64000 | Output cap per call |
+| `maxSpillBytes` | 67108864 | Output spill-to-disk cap |
+| `graceMs` | 3000 | Grace period after timeout |
+
+## Troubleshooting
+
+If the mode is missing, confirm Harness is 0.1.7 or later and restart after installation. Recreating a retired preset directory will not help: the new host does not discover presets there.
+
+If every tool fails with `Cannot read properties of undefined (reading 'prepare')`, check startup logs for duplicate runtime packages. Update the plugin bringing in extra `dsh-tools` / `cordis` copies and reinstall dependencies. Do not remove the entire `@deepseek-ai` directory: public helpers are supported dependencies. Another confirmed cause is the host loading two tool build outputs with a module-local scheduler `Symbol`; source builds can use `Symbol.for('@deepseek-ai/dsh-tools.scheduler')` and rebuild.
+
+## Uninstall
+
+```bash
+dsh plugin --profile web remove dsh-minimal-ptc
+```
+
+Restart the Web service afterward.
+
+## License
+
+MIT

package/README.md

@@ -1,65 +1,71 @@
-[English](README.en.md)
-
-# dsh-minimal-ptc
-
-给 DeepSeek Harness 添加「极简 PTC 模式」：使用简短的系统提示词，保留文件、终端、搜索、技能与已安装插件，通过 `run_code` 编排多步操作。Windows 支持 Git Bash 和持久 PowerShell。
-
-## 安装和使用
-
-0.5.0 需要 **Harness 0.1.7 及以上**。仍使用 Harness 0.1.5/0.1.6 时，请安装 `dsh-minimal-ptc@0.4.7`。
-
-```bash
-dsh plugin --profile web add dsh-minimal-ptc
-```
-
-重启 `dsh web`，新建会话，在输入框上方的模式列表中选择 **极简 PTC 模式**，然后像平时一样描述任务。无需创建预设目录或修改 YAML。
-
-例如：「检查这个项目的测试，找出失败原因并修复。」已有的邮件、日历等插件也可按原来的方式使用。
-
-## 0.5.0 的变化
-
-- 使用 Harness 0.1.7 官方的声明式 Agent 预设注册方式，修复升级后模式消失的问题。
-- 预设随插件安装和更新；保留用户旧的 `.agent-presets/ptc-minimal` 目录，不覆盖其中的自定义内容。
-- 启动检查只提示会影响工具运行的核心包副本，不再把 `schemastery`、`cosmokit` 等正常依赖误报为冲突。
-- 使用新版 `workflow-ptc`，保留插件工具、Git Bash、持久 PowerShell、搜索、计划、目标与子代理能力。
-
-## 兼容性与验证
-
-2026-09-23 在官方源码构建的 **Harness 0.1.7-alpha.2** 上验证（含本地工具调度器 `Symbol.for` 修复）：18 个插件同载，工具契约与技能注册通过；极简 PTC 出现在实际网页模式列表中并可选择，真实 Agent 挂载后以 `run_code` 为模型入口，保留插件工具与 Shell。
-
-已在沙箱开启的 Windows 隔离工作区通过 `run_code` 实际调用 RSS 插件，重启后再次通过。测试工作区由当前用户拥有完整管理权限，以便宿主设置沙箱权限；外部邮箱、数据库等业务仍需各插件的有效配置。
-
-Node 要求为 22.19 及以上的 22.x，或 24 及以上。
-
-## Windows 终端
-
-安装常规版 Git for Windows 后会自动找到 Git Bash。若安装在自定义位置，可设置 `GIT_BASH` 为 `bash.exe` 的完整路径，再启动 DSH。PowerShell 会话会保留当前目录、变量和函数。
-
-开发者如需自建预设，可参考包内的 `ptc-minimal.patch.yml`，执行器模块为 `dsh-minimal-ptc/gitbash-executor`。
-
-| 执行器选项 | 默认值 | 作用 |
-| :-- | :-- | :-- |
-| `shellPath` | 自动探测 | 指定 Git Bash 路径 |
-| `timeoutMs` | 120000 | 单次命令超时，毫秒 |
-| `maxTimeoutMs` | 600000 | 允许请求的最长超时 |
-| `maxOutputBytes` | 64000 | 单次输出上限 |
-| `maxSpillBytes` | 67108864 | 输出落盘上限 |
-| `graceMs` | 3000 | 超时后的退出宽限时间 |
-
-## 排错
-
-模式未出现时，先确认 DSH 为 0.1.7 及以上且安装后已重启。不要通过重建旧预设目录解决，新宿主不再从该目录发现预设。
-
-若每个工具都报 `Cannot read properties of undefined (reading 'prepare')`，查看启动日志中的核心包冲突提示。应升级带入额外 `dsh-tools` / `cordis` 副本的插件并重新安装依赖；不要删除整个 `@deepseek-ai` 目录，官方的公共辅助包属于正常依赖。另一个已确认原因是宿主同时加载两份工具构建产物且调度器键使用模块局部 `Symbol`；源码构建可将其改为 `Symbol.for('@deepseek-ai/dsh-tools.scheduler')` 后重新构建。
-
-## 卸载
-
-```bash
-dsh plugin --profile web remove dsh-minimal-ptc
-```
-
-重启 Web 服务后生效。
-
-## License
-
-MIT
+[English](README.en.md)
+
+# dsh-minimal-ptc
+
+## 0.5.1 更新（2026-09-27）
+
+补齐 tools 服务依赖声明，让启动健康检查可以在新版 Cordis 宿主中读取工具调度器。
+
+验证宿主：官方源码构建的 Harness `0.2.0-rc.1`（commit `407e65c8`）+ Node `24.16.0`（2026-09-28）。18 项插件测试在隔离环境全部通过；同一个宿主里 18 个插件共同加载，注册 0 个工具，工具 schema 与健康检查契约通过。本轮未启用真实端口与外部服务。
+
+给 DeepSeek Harness 添加「极简 PTC 模式」：使用简短的系统提示词，保留文件、终端、搜索、技能与已安装插件，通过 `run_code` 编排多步操作。Windows 支持 Git Bash 和持久 PowerShell。
+
+## 安装和使用
+
+0.5.0 需要 **Harness 0.1.7 及以上**。仍使用 Harness 0.1.5/0.1.6 时，请安装 `dsh-minimal-ptc@0.4.7`。
+
+```bash
+dsh plugin --profile web add dsh-minimal-ptc
+```
+
+重启 `dsh web`，新建会话，在输入框上方的模式列表中选择 **极简 PTC 模式**，然后像平时一样描述任务。无需创建预设目录或修改 YAML。
+
+例如：「检查这个项目的测试，找出失败原因并修复。」已有的邮件、日历等插件也可按原来的方式使用。
+
+## 0.5.0 的变化
+
+- 使用 Harness 0.1.7 官方的声明式 Agent 预设注册方式，修复升级后模式消失的问题。
+- 预设随插件安装和更新；保留用户旧的 `.agent-presets/ptc-minimal` 目录，不覆盖其中的自定义内容。
+- 启动检查只提示会影响工具运行的核心包副本，不再把 `schemastery`、`cosmokit` 等正常依赖误报为冲突。
+- 使用新版 `workflow-ptc`，保留插件工具、Git Bash、持久 PowerShell、搜索、计划、目标与子代理能力。
+
+## 兼容性与验证
+
+验证宿主：官方源码构建的 Harness `0.2.0-rc.1`（commit `407e65c8`）+ Node `24.16.0`（2026-09-28）。18 项插件测试在隔离环境通过（1 项按环境跳过）；同一个宿主里 18 个插件共同加载，工具契约与技能注册通过；极简 PTC 出现在实际网页模式列表中并可选择，真实 Agent 挂载后以 `run_code` 为模型入口，保留插件工具与 Shell。
+
+已在沙箱开启的 Windows 隔离工作区通过 `run_code` 实际调用 RSS 插件，重启后再次通过。测试工作区由当前用户拥有完整管理权限，以便宿主设置沙箱权限；外部邮箱、数据库等业务仍需各插件的有效配置。
+
+Node 要求为 22.19 及以上的 22.x，或 24 及以上。
+
+## Windows 终端
+
+安装常规版 Git for Windows 后会自动找到 Git Bash。若安装在自定义位置，可设置 `GIT_BASH` 为 `bash.exe` 的完整路径，再启动 DSH。PowerShell 会话会保留当前目录、变量和函数。
+
+开发者如需自建预设，可参考包内的 `ptc-minimal.patch.yml`，执行器模块为 `dsh-minimal-ptc/gitbash-executor`。
+
+| 执行器选项 | 默认值 | 作用 |
+| :-- | :-- | :-- |
+| `shellPath` | 自动探测 | 指定 Git Bash 路径 |
+| `timeoutMs` | 120000 | 单次命令超时，毫秒 |
+| `maxTimeoutMs` | 600000 | 允许请求的最长超时 |
+| `maxOutputBytes` | 64000 | 单次输出上限 |
+| `maxSpillBytes` | 67108864 | 输出落盘上限 |
+| `graceMs` | 3000 | 超时后的退出宽限时间 |
+
+## 排错
+
+模式未出现时，先确认 DSH 为 0.1.7 及以上且安装后已重启。不要通过重建旧预设目录解决，新宿主不再从该目录发现预设。
+
+若每个工具都报 `Cannot read properties of undefined (reading 'prepare')`，查看启动日志中的核心包冲突提示。应升级带入额外 `dsh-tools` / `cordis` 副本的插件并重新安装依赖；不要删除整个 `@deepseek-ai` 目录，官方的公共辅助包属于正常依赖。另一个已确认原因是宿主同时加载两份工具构建产物且调度器键使用模块局部 `Symbol`；源码构建可将其改为 `Symbol.for('@deepseek-ai/dsh-tools.scheduler')` 后重新构建。
+
+## 卸载
+
+```bash
+dsh plugin --profile web remove dsh-minimal-ptc
+```
+
+重启 Web 服务后生效。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -1,8 +1,8 @@
-# dsh-minimal-ptc 组合包补丁：向 profile 插入本插件的宿主行。
-#
-# 宿主行（name: dsh-minimal-ptc）在启动时把内置的 ptc-minimal 预设
-# 物化到用户预设根目录（$DSH_HOME/.agent-presets/ptc-minimal），
-# 安装即获得「极简 PTC 模式」Agent 模式。
-- insert:
-    - id: ptc-minimal-preset
-      name: 'dsh-minimal-ptc'
+# dsh-minimal-ptc 组合包补丁：向 profile 插入本插件的宿主行。
+#
+# 宿主行（name: dsh-minimal-ptc）在启动时把内置的 ptc-minimal 预设
+# 物化到用户预设根目录（$DSH_HOME/.agent-presets/ptc-minimal），
+# 安装即获得「极简 PTC 模式」Agent 模式。
+- insert:
+    - id: ptc-minimal-preset
+      name: 'dsh-minimal-ptc'

package/lib/index.js

@@ -16,7 +16,7 @@ import { fileURLToPath } from 'node:url'
 import pkg from '../package.json' with { type: 'json' }
 
 export const name = 'ptc-minimal-preset'
-export const inject = ['appReady']
+export const inject = ['appReady', 'tools']
 
 const VERSION = pkg.version
 const PRESET_ID = 'ptc-minimal'
@@ -75,11 +75,11 @@ function materialize(logger, modernRuntime) {
 export function apply(ctx) {
   ctx.effect(() => ctx.appReady.onReady(() => {
     try {
-      // 0.1.7 discovers the declarative row shipped by this bundle. Never
-      // rewrite a user's retired directory while running on that host.
-      if (typeof ctx.get('agentPresets')?.register !== 'function') {
-        materialize(ctx.logger, ctx.get('ptcRuntime') !== undefined)
-      }
+      // 0.1.7 discovers the declarative row shipped by this bundle. Never
+      // rewrite a user's retired directory while running on that host.
+      if (typeof ctx.get('agentPresets')?.register !== 'function') {
+        materialize(ctx.logger, ctx.get('ptcRuntime') !== undefined)
+      }
     } catch (error) {
       ctx.logger?.warn(`dsh-minimal-ptc: preset materialization failed: ${String(error)}`)
     }
@@ -107,8 +107,8 @@ function healthCheck(ctx) {
       `dsh-minimal-ptc: duplicate core package in profile: ${hit}\n`
       + '  A second @deepseek-ai copy breaks the tool scheduler key (module-local Symbol) '
       + 'and every tool call fails with "reading \'prepare\'".\n'
-      + '  Fix: update the plugin that brings in this runtime package, reinstall profile dependencies, '
-      + 'then restart. Shared helpers such as schemastery and cosmokit are supported dependencies.',
+      + '  Fix: update the plugin that brings in this runtime package, reinstall profile dependencies, '
+      + 'then restart. Shared helpers such as schemastery and cosmokit are supported dependencies.',
     )
   }
 
@@ -150,8 +150,8 @@ export function findProfileCoreCopies(home = dshHomePath('profiles')) {
       continue
     }
     for (const entry of entries) {
-      // Schema helpers are ordinary published dependencies, not another host.
-      if (entry.isDirectory() && (entry.name === 'dsh-tools' || entry.name === 'cordis')) hits.push(join(scopeDir, entry.name))
+      // Schema helpers are ordinary published dependencies, not another host.
+      if (entry.isDirectory() && (entry.name === 'dsh-tools' || entry.name === 'cordis')) hits.push(join(scopeDir, entry.name))
     }
   }
   return hits

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-minimal-ptc",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "DeepSeek Harness 极简 PTC 预设：简洁提示词、run_code 工具编排、完整插件工具，以及 Windows Git Bash 和持久 PowerShell。",
   "type": "module",
   "main": "lib/index.js",