dsh-loop-engine-allinone 0.7.0 → 0.7.3

package/CHANGELOG.md

@@ -8,6 +8,68 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 Nothing yet.
 
+## [0.7.3]
+
+### Fixed
+
+- **ZCode's path probe only worked on the author's machine.** The resolver and the
+  probe script both hardcoded `D:\Programs\ZCode\...` (and the probe also
+  `D:\Programs
+pm-global`), so on any other host the "well-known location" check
+  silently never matched and a user with ZCode installed somewhere normal was told it
+  was not installed. Both now derive candidates from the environment:
+  `%ZCODE_HOME%` → `%LOCALAPPDATA%\Programs\ZCode` → `%ProgramFiles%\ZCode`, and
+  the probe's npm prefixes from the running npm configuration and the standard
+  per-machine layouts.
+- A test run's probe output directory (`probe-out/`) was picked up by `git add -A`.
+  Removed, and ignored from now on.
+
+### Added
+
+- **`ZCODE_HOME` is documented**, with a `zcodeBin` key in the configuration example.
+  ZCode ships as a desktop bundle rather than a plain executable, so a manual install
+  outside an installer-written root needs one of the two to be found — and the README
+  previously mentioned neither, which is why the gap went unnoticed.
+
+## [0.7.2]
+
+### Changed
+
+- **Installation leads with `--profile web` again.** 0.7.1 made `<your-profile>` the
+  primary spelling, on the reasoning that `web` is one of several shipped templates.
+  That is true but the wrong shape for an install section: `dsh web` is the harness
+  CLI's own documented example (`dsh web` = `dsh --profile web`), and every published
+  plugin says `dsh plugin --profile web add ...` — dsh-market included. Forcing a
+  placeholder substitution before the first command is friction with no payoff for the
+  majority.
+
+  The non-`web` case is now a caveat section instead: `desktop`, `headless`, and
+  self-named profiles get both steps, plus the silent failure that follows from doing
+  only the first one. npm / GitHub / local-clone remain the three sources.
+
+## [0.7.1]
+
+### Fixed
+
+- **Installation no longer assumes a `web` profile.** `web` is one of several shipped
+  templates; the Desktop app boots `desktop`, a CI deployment boots `headless`, and
+  many people run a profile they named themselves. The instructions now say
+  `<your-profile>` and give the three real sources: npm, GitHub, and a local clone for
+  plugin development.
+- **A wrong `profile:` is now diagnosable.** The field defaults to `web`, so forgetting
+  it writes the managed block into another profile's patch file while the profile that
+  actually boots never reads it — the plugin mounts, the base `agent-loop` row is never
+  disabled, and no hosted engine is reachable, with **nothing logged**. The harness
+  gives a plugin no way to ask which profile is running, so `apply` now checks whether
+  the target directory holds a profile's `package.json` and warns with the field to set.
+  It is a warning, not a failure: a first boot may legitimately precede the profile's
+  own files.
+
+### Documented
+
+- The engine picker appears in whichever profile renders a web UI, not specifically in
+  `web`.
+
 ## [0.7.0]
 
 ### Added

package/README.md

@@ -7,7 +7,7 @@
 
 **dsh-loop-engine-allinone** is an all-in-one agent loop engine switcher for **[DeepSeek Harness](https://github.com/deepseek-ai)** (`dsh`). It enables per-session engine switching across **10 hosted engines** (Claude Code, Codex, Pi, Kimi Code, Antigravity, ZCode, Qoder CN, Hermes Agent, Grok Build, MiniMax Code) alongside the built-in `in-process` loop.
 
-> `dsh` is the harness CLI. `dsh web` boots its **web profile**, which is the UI this plugin's engine picker and settings page live in.
+> `dsh` is the harness CLI. `dsh --profile <name>` boots one of its **profiles**, and the engine picker plus this plugin's settings page appear in whichever profile renders a web UI (the shipped `web` template is one; the Desktop app uses `desktop`).
 
 Sessions are fully independent: run Codex in one chat while another runs Kimi Code or Antigravity simultaneously. Handover between two hosted engines happens seamlessly in place; switching to or from the native `in-process` engine performs an in-browser reload without restarting the backend process. All without modifying the DeepSeek Harness core codebase.
 
@@ -33,40 +33,64 @@ Sessions are fully independent: run Codex in one chat while another runs Kimi Co
 ## Installation
 
 ```sh
-# From npm (recommended)
 dsh plugin --profile web add dsh-loop-engine-allinone
 ```
 
-Then boot the web profile once and open **Settings → Loop engine**:
+Restart `dsh web`, then open **Settings → Loop engine**.
+
+### From GitHub instead of npm
 
 ```sh
-dsh web
+dsh plugin --profile web add yaliklinty/dsh-loop-engine-allinone
 ```
 
-Installing into a profile other than `web` (the Desktop app's `desktop`, a
-`headless` deployment, a renamed profile) means naming that profile instead:
-`dsh plugin --profile desktop add dsh-loop-engine-allinone`, **and** setting
-`profile: desktop` in the composition entry — see the notes below, because
-forgetting the second half is the one mistake that leaves the plugin mounted but
-unable to run any engine.
-
-### Installation Notes
-
-- **Profile Configuration**: The installer automatically injects a managed configuration block into your profile's `cordis.patch.yml`. All other custom configuration in that file is preserved.
-- **Non-web Profiles**: When installing into non-web profiles (such as `desktop` or headless), explicitly specify `profile: <name>` in the composition entry:
-  ```yaml
-  - id: loop-engine
-    config:
-      profile: desktop
-  ```
-  *(Without this, configuration defaults to `web` and the plugin will not attach to custom profiles.)*
-- **Uninstallation**: Run `dsh plugin --profile web remove dsh-loop-engine-allinone`, then remove the managed `loop-engine` block from `cordis.patch.yml`.
-- **pnpm 10+**: If dependency build scripts are blocked (`ERR_PNPM_IGNORED_BUILDS` mentioning `esbuild`, `@google/genai`, etc.), run `pnpm approve-builds`.
-- **Harness from Source**: If launching the harness directly from a source checkout, bridge peer dependencies using `file:` shims as described in [docs/source-checkout.md](docs/source-checkout.md).
+### From a local clone
 
----
+Only when you are working on the plugin itself:
 
----
+```sh
+git clone https://github.com/yaliklinty/dsh-loop-engine-allinone.git
+dsh plugin --profile web add ./dsh-loop-engine-allinone
+```
+
+### Not on the `web` profile?
+
+`web` is the profile the harness's own CLI documents (`dsh web` is short for
+`dsh --profile web`), so it is the right default. But the Desktop app boots
+`desktop`, a CI deployment may boot `headless`, and you may have made your own. In
+that case:
+
+1. install with that profile's name — `dsh plugin --profile desktop add
+   dsh-loop-engine-allinone`;
+2. **and** set the same name in the composition entry:
+
+   ```yaml
+   - id: loop-engine
+     config:
+       profile: desktop
+   ```
+
+Step 2 is the one that bites. The field defaults to `web`, so omitting it makes the
+plugin write its managed block into `profiles/web/cordis.patch.yml` while the profile
+you actually boot never reads it: the plugin mounts, but the base `agent-loop` row is
+never disabled, the router cannot take the agent-factory slot, and **no hosted engine
+is reachable** — with nothing logged. This release also warns when it detects that
+shape, naming the field to set.
+
+### Installation notes
+
+- The installer rewrites one managed block in the profile's `cordis.patch.yml`; every
+  other byte you wrote there is preserved, so upgrading needs no hand edit.
+- **Uninstall**: `dsh plugin --profile web remove dsh-loop-engine-allinone`, **then
+  delete the managed `loop-engine` block** from that profile's `cordis.patch.yml`. The
+  block outlives the plugin, and while it is present the profile has no agent factory,
+  so no session can be created.
+- **pnpm 10+** may block dependency build scripts (`ERR_PNPM_IGNORED_BUILDS` naming
+  `esbuild`, `@google/genai`, `protobufjs`). Run `pnpm approve-builds`, or add an
+  `allowBuilds` entry, and retry — only the installing project can grant this.
+- **Harness from source**: bridge the profile's harness peers with `file:` shims, or
+  session resume fails with `agent-presets: refusing to compose an unscoped context`.
+  Steps in [docs/source-checkout.md](docs/source-checkout.md).
 
 ## Supported Engines
 
@@ -106,6 +130,7 @@ Custom settings can be configured under your profile's composition entry:
       qoderclicnBin: 'D:/tools/qoderclicn.exe'
       grokBin: 'C:/Users/user/.grok/bin/grok.exe'
       minimaxcodeBin: 'D:/npm-global/node_modules/@minimax-ai/code/cli.js'
+      zcodeBin: 'D:/Programs/ZCode/resources/glm/zcode.cjs'
 
     # 2. Region override (optional - MiniMax Code supports 'cn' or 'en')
     regions:
@@ -125,6 +150,12 @@ Custom settings can be configured under your profile's composition entry:
     summarizerModel: 'deepseek-flash'
 ```
 
+**ZCode's install location.** ZCode ships as a desktop bundle rather than a plain
+executable, so it is found by probing an install root: `%ZCODE_HOME%` first, then
+`%LOCALAPPDATA%\Programs\ZCode` and `%ProgramFiles%\ZCode`. A manual install
+anywhere else (`D:\Programs\ZCode`, say) is named either with the `ZCODE_HOME`
+environment variable or with `bins.zcodeBin` — nothing hardcodes a drive letter.
+
 ---
 
 ## Usage Guide

package/README.zh.md

@@ -7,6 +7,8 @@
 
 **dsh-loop-engine-allinone** 是专为 [DeepSeek Harness](https://github.com/deepseek-ai)（`dsh`）打造的 Agent 循环引擎全功能切换插件。支持**按会话独立切换** 10 家主流外部引擎与 Harness 原生 `in-process` 循环。
 
+> `dsh` 是 harness 的命令行程序；`dsh --profile <名字>` 启动它的某个 **profile**。引擎选择器与本插件的设置页出现在**任何渲染 web UI 的 profile** 里（随附的 `web` 模板是其中之一，桌面版用的是 `desktop`）。
+
 各会话完全隔离互不干扰：一个窗口运行 Codex，另一个窗口可同时运行 Kimi Code 或 Antigravity。托管引擎之间支持**无缝原地热换**；切换至原生 `in-process` 时会自动刷新页面重新挂载（无需重启 `dsh web` 后端进程）。**全程无需修改 DeepSeek Harness 主仓库源码**。
 
 > **Fork 说明**：本项目基于 [`kuun993/dsh-loop-engine`](https://github.com/kuun993/dsh-loop-engine) 进行深度重构与扩展。  
@@ -30,42 +32,59 @@
 
 ## 安装说明
 
-通过 `dsh plugin` 命令行直接安装：
-
 ```sh
-# 从 npm 安装（推荐）
 dsh plugin --profile web add dsh-loop-engine-allinone
 ```
 
-然后启动一次 web profile，打开 **Settings → Loop engine**：
+重启 `dsh web`，打开 **Settings → Loop engine**。
+
+### 想从 GitHub 装而不是 npm
 
 ```sh
-dsh web
+dsh plugin --profile web add yaliklinty/dsh-loop-engine-allinone
 ```
 
-> `dsh` 是 harness 的命令行程序；`dsh web` 启动它的 **web profile**——本插件的引擎选择器与设置页就在那个界面里。
+### 从本地克隆安装
 
-装到 `web` 以外的 profile（桌面版的 `desktop`、`headless` 部署、改过名的 profile）时，
-要把 `--profile web` 换成对应名字，**并且**在组合条目里写 `profile: <名字>`。
-只做前一半是本插件最容易犯的错：插件挂上了，却一个引擎都跑不起来。详见下方安装须知。
+只在开发插件本身时才需要：
 
-### 安装注意事项
+```sh
+git clone https://github.com/yaliklinty/dsh-loop-engine-allinone.git
+dsh plugin --profile web add ./dsh-loop-engine-allinone
+```
 
-- **Profile 自动配置**：安装时会自动在对应 Profile 的 `cordis.patch.yml` 中写入一段受管配置块，原有配置内容均逐字节安全保留。
-- **非 Web Profile 部署**：若安装至桌面版 `desktop` 或 headless 等自定义 profile，需在配置中显式指定 `profile: <name>`：
-  ```yaml
-  - id: loop-engine
-    config:
-      profile: desktop
-  ```
-  *(若未指定，插件默认挂载到 `web` profile，导致自定义 profile 无法生效。)*
-- **卸载插件**：执行 `dsh plugin --profile web remove dsh-loop-engine-allinone`，并手动清理 `cordis.patch.yml` 中残留的 `loop-engine` 受管块。
-- **pnpm 10+ 构建拦截**：若遇到 `ERR_PNPM_IGNORED_BUILDS`（提示 `esbuild`、`@google/genai` 等构建被忽略），执行 `pnpm approve-builds` 允许即可。
-- **源码模式运行 Harness**：若通过源码启动 Harness，需按照 [docs/source-checkout.md](docs/source-checkout.md) 说明配置 `file:` shim 桥接依赖包。
+### 不是 `web` profile？
 
----
+`web` 是 harness 自己的 CLI 文档里用的那个 profile（`dsh web` 就是 `dsh --profile web`
+的简写），所以它是正确的默认值。但桌面版启动的是 `desktop`，CI 部署可能用 `headless`，
+你也可能自己建过一个。这种情况下：
 
----
+1. 用那个 profile 的名字安装 —— `dsh plugin --profile desktop add dsh-loop-engine-allinone`；
+2. **并且**在组合条目里写上同一个名字：
+
+   ```yaml
+   - id: loop-engine
+     config:
+       profile: desktop
+   ```
+
+**第 2 步才是会咬人的地方。** 该字段默认是 `web`，漏写会让插件把受管块写进
+`profiles/web/cordis.patch.yml`，而你实际启动的 profile 永远读不到它：插件挂上了，
+但基础 `agent-loop` 行没被禁，路由器拿不到 agent factory 槽位，**任何托管引擎都不可达**
+——而且不报错。本版本会在检测到这种情形时告警，并指出该设哪个字段。
+
+### 安装注意事项
+
+- 安装会重写该 profile `cordis.patch.yml` 里的一段受管块；你写的其它内容逐字节保留，升级不需要手工改。
+- **卸载**：`dsh plugin --profile web remove dsh-loop-engine-allinone`，**然后手动删掉**
+  该 profile `cordis.patch.yml` 里的 `loop-engine` 受管块。块会比插件活得久，而它还在时
+  profile 里没有任何 agent factory，会话一条也建不出来。
+- **pnpm 10+** 可能拦下依赖的 build script（`ERR_PNPM_IGNORED_BUILDS`，列出 `esbuild`、
+  `@google/genai`、`protobufjs`）。执行 `pnpm approve-builds`，或加一条 `allowBuilds`，然后重试
+  ——只有安装方能授予这个权限。
+- **用源码启动 harness** 时，要用 `file:` shim 把 profile 的 harness peer 包桥接到 checkout 源码，
+  否则恢复会话会报 `agent-presets: refusing to compose an unscoped context`。
+  步骤见 [docs/source-checkout.md](docs/source-checkout.md)。
 
 ## 支持引擎一览
 
@@ -105,6 +124,7 @@ dsh web
       qoderclicnBin: 'D:/tools/qoderclicn.exe'
       grokBin: 'C:/Users/username/.grok/bin/grok.exe'
       minimaxcodeBin: 'D:/npm-global/node_modules/@minimax-ai/code/cli.js'
+      zcodeBin: 'D:/Programs/ZCode/resources/glm/zcode.cjs'
 
     # 2. 账号区域设置（可选，MiniMax Code 支持 'cn' 或 'en'）
     regions:

package/lib/index.js

@@ -89,10 +89,10 @@ var __callDispose = (stack, error, hasError) => {
 };
 
 // src/index.ts
-import { readFileSync as readFileSync5 } from "node:fs";
+import { existsSync as existsSync8, readFileSync as readFileSync5 } from "node:fs";
 import { mkdir as mkdir2, readFile as readFile6, rename as rename2, writeFile as writeFile2 } from "node:fs/promises";
 import { randomUUID as randomUUID3 } from "node:crypto";
-import { dirname as dirname7, join as join21 } from "node:path";
+import { dirname as dirname7, join as join22 } from "node:path";
 import z12 from "@deepseek-ai/schemastery";
 import { resolveDshHome as resolveDshHome2 } from "@deepseek-ai/dsh-home-paths";
 
@@ -8669,11 +8669,27 @@ function textRunOutcome(result) {
 
 // src/engine-zcode/process.ts
 import { existsSync as existsSync3 } from "node:fs";
+import { join as join7 } from "node:path";
 var ZCODE_DISPOSE_GRACE_MS = 3e3;
-function wellKnownZcode() {
-  if (process.platform !== "win32") return void 0;
-  const candidate = "D:ProgramsZCode\resourcesglmzcode.cjs";
-  return existsSync3(candidate) ? candidate : void 0;
+function zcodeInstallRoots(env = process.env) {
+  const roots = [];
+  if (env.ZCODE_HOME !== void 0 && env.ZCODE_HOME !== "") roots.push(env.ZCODE_HOME);
+  if (env.LOCALAPPDATA !== void 0 && env.LOCALAPPDATA !== "") {
+    roots.push(join7(env.LOCALAPPDATA, "Programs", "ZCode"));
+  }
+  if (process.platform === "win32" && env.ProgramFiles !== void 0 && env.ProgramFiles !== "") {
+    roots.push(join7(env.ProgramFiles, "ZCode"));
+  }
+  return roots;
+}
+function zcodeCliCandidates(env = process.env) {
+  return zcodeInstallRoots(env).map((root) => join7(root, "resources", "glm", "zcode.cjs"));
+}
+function wellKnownZcode(env = process.env) {
+  for (const candidate of zcodeCliCandidates(env)) {
+    if (existsSync3(candidate)) return candidate;
+  }
+  return void 0;
 }
 function zcodeArgvPrefix(configBin) {
   const pinned = configBin === void 0 || configBin === "" ? wellKnownZcode() : configBin;
@@ -8681,9 +8697,14 @@ function zcodeArgvPrefix(configBin) {
   return /\.(?:c|m)?js$/i.test(pinned) ? [process.execPath, pinned] : [pinned];
 }
 var ZCODE_PROVIDER_CONFIG_ENV = "ZCODE_BUILTIN_PROVIDER_CONFIG_FILE";
-function zcodeBuiltinProviderConfig() {
-  const candidate = "D:ProgramsZCode\resourcesconfigproviderzcode-builtin.json";
-  return existsSync3(candidate) ? candidate : void 0;
+function zcodeProviderConfigCandidates(env = process.env) {
+  return zcodeInstallRoots(env).map((root) => join7(root, "resources", "config", "provider", "zcode-builtin.json"));
+}
+function zcodeBuiltinProviderConfig(env = process.env) {
+  for (const candidate of zcodeProviderConfigCandidates(env)) {
+    if (existsSync3(candidate)) return candidate;
+  }
+  return void 0;
 }
 function zcodeMode(dangerFullAccess) {
   return dangerFullAccess ? "yolo" : "build";
@@ -8883,16 +8904,16 @@ function mapStreamJsonDocument(document, accept, run) {
 // src/engine-qoderclicn/process.ts
 import { existsSync as existsSync4 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
-import { join as join7 } from "node:path";
+import { join as join8 } from "node:path";
 var QODERCLICN_DISPOSE_GRACE_MS = 3e3;
 function qoderclicnHomeDir() {
   const envHome = process.env.QODER_HOME;
-  return envHome !== void 0 && envHome !== "" ? envHome : join7(homedir2(), ".qoder-cn");
+  return envHome !== void 0 && envHome !== "" ? envHome : join8(homedir2(), ".qoder-cn");
 }
 function qoderclicnBinResolver(configBin) {
   if (configBin !== void 0 && configBin !== "") return configBin;
   const executable = process.platform === "win32" ? "qoderclicn.exe" : "qoderclicn";
-  const candidate = join7(qoderclicnHomeDir(), "bin", "qoderclicn", executable);
+  const candidate = join8(qoderclicnHomeDir(), "bin", "qoderclicn", executable);
   return existsSync4(candidate) ? candidate : "qoderclicn";
 }
 function qoderclicnPermissionMode(sandbox, approval) {
@@ -9021,14 +9042,14 @@ import z8 from "@deepseek-ai/schemastery";
 
 // src/engine-hermes/process.ts
 import { existsSync as existsSync5 } from "node:fs";
-import { delimiter, join as join8 } from "node:path";
+import { delimiter, join as join9 } from "node:path";
 var HERMES_DISPOSE_GRACE_MS = 3e3;
 var HERMES_PROMPT_FLAG = "-z";
 function wellKnownHermes() {
   if (process.platform !== "win32") return void 0;
   const local = process.env.LOCALAPPDATA;
   if (local === void 0 || local === "") return void 0;
-  const candidate = join8(local, "hermes", "hermes-agent", "venv", "Scripts", "hermes.exe");
+  const candidate = join9(local, "hermes", "hermes-agent", "venv", "Scripts", "hermes.exe");
   return existsSync5(candidate) ? candidate : void 0;
 }
 function hermesBinResolver(configBin) {
@@ -9126,11 +9147,11 @@ import z9 from "@deepseek-ai/schemastery";
 // src/engine-grok/process.ts
 import { existsSync as existsSync7 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 
 // src/driver-acp/executable.ts
 import { existsSync as existsSync6 } from "node:fs";
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 function execArgvPrefix(bin) {
   if (/\.(?:c|m)?js$/i.test(bin)) return [process.execPath, bin];
   if (/\.(?:cmd|bat)$/i.test(bin)) return [process.env.ComSpec ?? "cmd.exe", "/c", bin];
@@ -9144,7 +9165,7 @@ function resolveOnPath(name2, env = process.env) {
   for (const directory of path.split(separator)) {
     if (directory === "") continue;
     for (const extension of extensions) {
-      const candidate = join9(directory, `${name2}${extension}`);
+      const candidate = join10(directory, `${name2}${extension}`);
       if (existsSync6(candidate)) return candidate;
     }
   }
@@ -9155,8 +9176,8 @@ function npmPackageEntry(prefix, pkg, entry) {
   const scope = scoped ? pkg.slice(0, pkg.indexOf("/")) : "";
   const name2 = scoped ? pkg.slice(pkg.indexOf("/") + 1) : pkg;
   if (name2 === "" || scoped && scope === "") return void 0;
-  const relative = scoped ? join9("node_modules", scope, name2, entry) : join9("node_modules", name2, entry);
-  for (const candidate of [join9(prefix, relative), join9(prefix, "lib", relative)]) {
+  const relative = scoped ? join10("node_modules", scope, name2, entry) : join10("node_modules", name2, entry);
+  for (const candidate of [join10(prefix, relative), join10(prefix, "lib", relative)]) {
     if (existsSync6(candidate)) return candidate;
   }
   return void 0;
@@ -9166,12 +9187,12 @@ function npmPackageEntry(prefix, pkg, entry) {
 var GROK_DISPOSE_GRACE_MS = 3e3;
 function grokHomeDir() {
   const envHome = process.env.GROK_HOME;
-  return envHome !== void 0 && envHome !== "" ? envHome : join10(homedir3(), ".grok");
+  return envHome !== void 0 && envHome !== "" ? envHome : join11(homedir3(), ".grok");
 }
 function grokBinResolver(configBin) {
   if (configBin !== void 0 && configBin !== "") return configBin;
   const executable = process.platform === "win32" ? "grok.exe" : "grok";
-  const candidate = join10(grokHomeDir(), "bin", executable);
+  const candidate = join11(grokHomeDir(), "bin", executable);
   if (existsSync7(candidate)) return candidate;
   return resolveOnPath("grok") ?? "grok";
 }
@@ -9276,7 +9297,7 @@ import z10 from "@deepseek-ai/schemastery";
 
 // src/engine-minimaxcode/process.ts
 import { homedir as homedir4 } from "node:os";
-import { dirname as dirname3, join as join11 } from "node:path";
+import { dirname as dirname3, join as join12 } from "node:path";
 var MINIMAXCODE_DISPOSE_GRACE_MS = 3e3;
 var MINIMAXCODE_NPM_PACKAGE = "@minimax-ai/code";
 var MINIMAXCODE_ENTRYPOINT = "cli.js";
@@ -9284,7 +9305,7 @@ function mcodeBinResolver(configBin, env = process.env) {
   if (configBin !== void 0 && configBin !== "") return configBin;
   const prefixes = [
     env.MCODE_INSTALL_ROOT,
-    env.APPDATA === void 0 ? void 0 : join11(env.APPDATA, "npm"),
+    env.APPDATA === void 0 ? void 0 : join12(env.APPDATA, "npm"),
     // A standard Windows node install puts the global prefix beside node.exe.
     dirname3(process.execPath),
     dirname3(dirname3(process.execPath)),
@@ -9293,7 +9314,7 @@ function mcodeBinResolver(configBin, env = process.env) {
     // `HOME`, and the whole point of this resolver is to find an install the
     // inherited environment may not describe.
     "/usr/local",
-    join11(homedir4(), ".npm-global")
+    join12(homedir4(), ".npm-global")
   ];
   for (const prefix of prefixes) {
     if (prefix === void 0 || prefix === "") continue;
@@ -9593,7 +9614,7 @@ ${block}`);
 // src/preset.ts
 import { mkdir, readFile as readFile2, rename, writeFile } from "node:fs/promises";
 import { randomUUID } from "node:crypto";
-import { dirname as dirname4, join as join12 } from "node:path";
+import { dirname as dirname4, join as join13 } from "node:path";
 var USER_PRESET_DIR = ".agent-presets";
 var COMPOSITION_FILE = "agent.cordis.yml";
 var METADATA_FILE = "preset.yml";
@@ -9793,9 +9814,9 @@ async function ensureEnginePresets(dshHome, source, target) {
 ${applySummarizerTarget(stripPresetRows(composition), target)}`;
   let changed = false;
   for (const engine of HOSTED_ENGINE_IDS) {
-    const dir = join12(dshHome, USER_PRESET_DIR, enginePresetId(engine));
-    const compositionChanged = await writeIfDifferent(join12(dir, COMPOSITION_FILE), stripped);
-    const metadataChanged = await writeIfDifferent(join12(dir, METADATA_FILE), managedMetadata(engine));
+    const dir = join13(dshHome, USER_PRESET_DIR, enginePresetId(engine));
+    const compositionChanged = await writeIfDifferent(join13(dir, COMPOSITION_FILE), stripped);
+    const metadataChanged = await writeIfDifferent(join13(dir, METADATA_FILE), managedMetadata(engine));
     changed = changed || compositionChanged || metadataChanged;
   }
   return changed;
@@ -10051,7 +10072,7 @@ function usableSelection(answered) {
 // src/commands.ts
 import { readdirSync, readFileSync as readFileSync3 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
-import { join as join13 } from "node:path";
+import { join as join14 } from "node:path";
 import { createUserMessage as createUserMessage6 } from "@deepseek-ai/dsh-llm";
 var COMMAND_NAME = /^[a-z][a-z0-9_-]*$/;
 function forwardClaudeCodeCommand(name2) {
@@ -10085,7 +10106,7 @@ function discoverUserSlashCommands() {
     if (!entry.endsWith(".md")) continue;
     const name2 = entry.slice(0, -".md".length);
     if (!COMMAND_NAME.test(name2) || seen.has(name2)) continue;
-    const path = join13(userCommandsDir(), entry);
+    const path = join14(userCommandsDir(), entry);
     let raw;
     try {
       raw = readFileSync3(path, "utf8");
@@ -10100,7 +10121,7 @@ function discoverUserSlashCommands() {
   return definitions;
 }
 function userCommandsDir() {
-  return join13(homedir5(), ".claude", "commands");
+  return join14(homedir5(), ".claude", "commands");
 }
 function commandDescription(raw) {
   const trimmed = raw.trim();
@@ -10151,7 +10172,7 @@ var KIMI_COMMANDS = [
 // src/skills.ts
 import { readFile as readFile3, readdir, stat } from "node:fs/promises";
 import { homedir as homedir6 } from "node:os";
-import { join as join14, resolve } from "node:path";
+import { join as join15, resolve } from "node:path";
 var SKILL_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 var PROVIDER_NAME = "claude-code";
 var CLAUDE_CODE_RANK = 150;
@@ -10261,10 +10282,10 @@ var ClaudeCodeSkillProvider = class {
     const cwd = options.cwd;
     if (cwd !== void 0) {
       const projectRoot = await findProjectRoot(resolve(cwd));
-      await collectSkillsDir(join14(projectRoot, ".claude", "skills"), CLAUDE_CODE_RANK, candidates);
+      await collectSkillsDir(join15(projectRoot, ".claude", "skills"), CLAUDE_CODE_RANK, candidates);
       await collectClaudeMd(projectRoot, candidates);
     }
-    await collectSkillsDir(join14(homedir6(), ".claude", "skills"), CLAUDE_CODE_USER_RANK, candidates);
+    await collectSkillsDir(join15(homedir6(), ".claude", "skills"), CLAUDE_CODE_USER_RANK, candidates);
     if (this.control.signal.aborted) return [];
     return candidates;
   }
@@ -10298,11 +10319,11 @@ async function collectSkillsDir(skillsDir, rank, candidates) {
     return;
   }
   for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
-    const entryPath = join14(skillsDir, entry.name);
+    const entryPath = join15(skillsDir, entry.name);
     const info = await stat(entryPath).catch(() => void 0);
     if (info === void 0) continue;
     if (info.isDirectory()) {
-      const path = join14(entryPath, "SKILL.md");
+      const path = join15(entryPath, "SKILL.md");
       const skill2 = await tryParseSkill(path);
       if (skill2 === void 0) continue;
       candidates.push(toCandidate(skill2, path, rank, entryPath));
@@ -10315,7 +10336,7 @@ async function collectSkillsDir(skillsDir, rank, candidates) {
   }
 }
 async function collectClaudeMd(projectRoot, candidates) {
-  const claudeMd = join14(projectRoot, "CLAUDE.md");
+  const claudeMd = join15(projectRoot, "CLAUDE.md");
   try {
     const info = await stat(claudeMd);
     if (!info.isFile()) return;
@@ -10352,7 +10373,7 @@ async function findProjectRoot(cwd) {
   let current = cwd;
   while (true) {
     try {
-      await stat(join14(current, ".git"));
+      await stat(join15(current, ".git"));
       return current;
     } catch {
     }
@@ -10364,15 +10385,15 @@ async function findProjectRoot(cwd) {
 
 // src/engine-codex/skills.ts
 import { homedir as homedir7 } from "node:os";
-import { join as join17 } from "node:path";
+import { join as join18 } from "node:path";
 
 // src/driver-core/agents-md-skill-provider.ts
 import { readdir as readdir2, readFile as readFile5, stat as stat3 } from "node:fs/promises";
-import { dirname as dirname5, join as join16 } from "node:path";
+import { dirname as dirname5, join as join17 } from "node:path";
 
 // src/driver-core/context-files.ts
 import { readFile as readFile4, stat as stat2 } from "node:fs/promises";
-import { join as join15, resolve as resolve2 } from "node:path";
+import { join as join16, resolve as resolve2 } from "node:path";
 async function projectAncestors(cwd) {
   const root = await findProjectRoot(resolve2(cwd));
   const dirs = [];
@@ -10393,11 +10414,11 @@ async function collectProjectContextFiles(cwd, policy) {
 }
 async function dirContextFile(dir, policy) {
   if (policy.override !== void 0) {
-    const override = join15(dir, policy.override);
+    const override = join16(dir, policy.override);
     if (await pathExists(override)) return override;
   }
   for (const name2 of policy.primary) {
-    const candidate = join15(dir, name2);
+    const candidate = join16(dir, name2);
     if (await pathExists(candidate)) return candidate;
   }
   return void 0;
@@ -10457,18 +10478,18 @@ var AgentsMdSkillProvider = class {
       if (this.spec.skills !== void 0) {
         const catalog = this.spec.skills;
         for (const dir of await projectAncestors(cwd)) {
-          await this.collectSkillsDir(join16(dir, ...catalog.project), catalog.projectRank, candidates);
+          await this.collectSkillsDir(join17(dir, ...catalog.project), catalog.projectRank, candidates);
         }
       }
     }
     const userDir = this.spec.userDir();
     const userContext = this.spec.userContext;
     if (userContext !== void 0) {
-      const userFile = join16(userDir, userContext.file);
+      const userFile = join17(userDir, userContext.file);
       if (await fileNonEmpty(userFile)) candidates.push(this.agentsCandidate([userFile], userContext.rank));
     }
     if (this.spec.skills !== void 0) {
-      await this.collectSkillsDir(join16(userDir, this.spec.skills.userDir), this.spec.skills.userRank, candidates);
+      await this.collectSkillsDir(join17(userDir, this.spec.skills.userDir), this.spec.skills.userRank, candidates);
     }
     if (this.control.signal.aborted) return [];
     return candidates;
@@ -10528,11 +10549,11 @@ var AgentsMdSkillProvider = class {
       return;
     }
     for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
-      const entryPath = join16(skillsDir, entry.name);
+      const entryPath = join17(skillsDir, entry.name);
       const info = await stat3(entryPath).catch(() => void 0);
       if (info === void 0) continue;
       if (info.isDirectory()) {
-        const path = join16(entryPath, "SKILL.md");
+        const path = join17(entryPath, "SKILL.md");
         const parsed2 = await this.tryParse(path);
         if (parsed2 === void 0) continue;
         candidates.push(this.skillCandidate(parsed2, path, rank, entryPath));
@@ -10578,7 +10599,7 @@ var CODEX_SPEC = {
   name: "codex",
   agentsMdDescription: "Codex project/user instructions (AGENTS.md)",
   contextPolicy: CODEX_CONTEXT_POLICY,
-  userDir: () => join17(homedir7(), ".codex"),
+  userDir: () => join18(homedir7(), ".codex"),
   projectRank: CODEX_PROJECT_RANK,
   userContext: { file: "AGENTS.md", rank: CODEX_USER_RANK }
 };
@@ -10590,7 +10611,7 @@ var CodexSkillProvider = class extends AgentsMdSkillProvider {
 
 // src/engine-pi/skills.ts
 import { homedir as homedir8 } from "node:os";
-import { join as join18, resolve as resolve3 } from "node:path";
+import { join as join19, resolve as resolve3 } from "node:path";
 var PI_AGENTS_PROJECT_RANK = 140;
 var PI_SKILL_PROJECT_RANK = 150;
 var PI_AGENTS_USER_RANK = 160;
@@ -10602,7 +10623,7 @@ var PI_CONTEXT_POLICY = {
 function piAgentDir2() {
   const override = process.env.PI_CODING_AGENT_DIR;
   if (override !== void 0 && override.length > 0) return resolve3(override);
-  return join18(homedir8(), ".pi", "agent");
+  return join19(homedir8(), ".pi", "agent");
 }
 var PI_SPEC = {
   name: "pi",
@@ -10626,7 +10647,7 @@ var PiSkillProvider = class extends AgentsMdSkillProvider {
 
 // src/engine-kimi/skills.ts
 import { homedir as homedir9 } from "node:os";
-import { join as join19, resolve as resolve4 } from "node:path";
+import { join as join20, resolve as resolve4 } from "node:path";
 var KIMI_AGENTS_PROJECT_RANK = 140;
 var KIMI_SKILL_PROJECT_RANK = 150;
 var KIMI_SKILL_USER_RANK = 160;
@@ -10636,7 +10657,7 @@ var KIMI_CONTEXT_POLICY = {
 function kimiAgentDir() {
   const override = process.env.KIMI_CODE_HOME;
   if (override !== void 0 && override.length > 0) return resolve4(override);
-  return join19(homedir9(), ".kimi-code");
+  return join20(homedir9(), ".kimi-code");
 }
 var KIMI_SPEC = {
   name: "kimi",
@@ -11257,13 +11278,13 @@ function handoverOf(handle) {
 // src/session-engine-store.ts
 import { mkdirSync as mkdirSync2, readFileSync as readFileSync4, renameSync, writeFileSync as writeFileSync2 } from "node:fs";
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { dirname as dirname6, join as join20 } from "node:path";
+import { dirname as dirname6, join as join21 } from "node:path";
 import { resolveDshHome } from "@deepseek-ai/dsh-home-paths";
 var ENGINE_RECORD_DIR = ".loop-engine";
 var ENGINE_RECORD_FILE = "engines.json";
 var ENGINE_RECORD_VERSION = 1;
 function resolveEngineRecordPath() {
-  return join20(resolveDshHome(), ENGINE_RECORD_DIR, ENGINE_RECORD_FILE);
+  return join21(resolveDshHome(), ENGINE_RECORD_DIR, ENGINE_RECORD_FILE);
 }
 function isMissing(error) {
   return error?.code === "ENOENT";
@@ -11418,7 +11439,7 @@ var Config11 = z12.object({
 });
 function resolvePatchPath(config) {
   if (config.patchPath !== void 0 && config.patchPath !== "") return config.patchPath;
-  return join21(
+  return join22(
     resolveDshHome2(),
     "profiles",
     config.profile ?? "web",
@@ -11476,9 +11497,18 @@ function readPatchFileSync(path) {
     throw error;
   }
 }
+function warnIfProfileLooksWrong(ctx, config, patchPath) {
+  const profileDir = dirname7(patchPath);
+  if (existsSync8(join22(profileDir, "package.json"))) return;
+  const named = config.profile ?? "web";
+  ctx.logger.warn(
+    `loop-engine: profile "${named}" has no package.json beside "${patchPath}". If you boot a different profile, set \`profile: <that-name>\` in this plugin's composition entry - otherwise its managed block is written here, the profile you actually boot never reads it, and no hosted engine will be reachable.`
+  );
+}
 function apply(ctx, config) {
   const summarizer = resolveSummarizerTarget(config);
   const patchPath = resolvePatchPath(config);
+  warnIfProfileLooksWrong(ctx, config, patchPath);
   const patchText = readPatchFileSync(patchPath);
   const legacyEngine = legacyBlockEngineOf(patchText);
   const needsWrite = hasLegacyManagedBlock(patchText) || !hasManagedBlock(patchText);

package/lib/types/engine-zcode/process.d.ts

@@ -42,6 +42,29 @@ export declare const ZCODE_DISPOSE_GRACE_MS = 3000;
 export declare const ZCODE_MODES: readonly ["build", "edit", "plan", "yolo"];
 /** One ZCode permission mode. */
 export type ZcodeMode = (typeof ZCODE_MODES)[number];
+/**
+ * The install roots a ZCode desktop build may sit under, most specific first.
+ *
+ * One list, used by both the CLI lookup and the provider-catalog lookup, so the two
+ * can never disagree about where an install is. No drive letter is assumed: the fork
+ * was written against one machine's `D:\Programs\ZCode`, and `%ZCODE_HOME%` is how an
+ * operator names a manual install like that one.
+ * @param env - the environment to read the roots from.
+ * @returns candidate roots.
+ */
+export declare function zcodeInstallRoots(env?: NodeJS.ProcessEnv): readonly string[];
+/**
+ * Every place a ZCode desktop install may keep its bundled CLI, in probe order.
+ *
+ * Derived from the environment rather than hardcoded: the fork was written against
+ * one machine's `D:\Programs\ZCode`, and shipping that literal meant the probe
+ * never matched anywhere else. `%LOCALAPPDATA%\Programs` is where the installer puts
+ * a per-user app, `%ProgramFiles%` where an all-users install goes, and
+ * `%ZCODE_HOME%` is the app's own override.
+ * @param env - the environment to read install roots from.
+ * @returns candidate paths for the bundled CLI, most specific first.
+ */
+export declare function zcodeCliCandidates(env?: NodeJS.ProcessEnv): readonly string[];
 /**
  * Resolve the argv prefix that launches ZCode.
  *
@@ -63,8 +86,18 @@ export declare function zcodeArgvPrefix(configBin?: string): string[];
  * only when the deployment has not — an explicit deployment value always wins.
  */
 export declare const ZCODE_PROVIDER_CONFIG_ENV = "ZCODE_BUILTIN_PROVIDER_CONFIG_FILE";
-/** The bundled provider catalog inside the desktop app, when it exists. */
-export declare function zcodeBuiltinProviderConfig(): string | undefined;
+/**
+ * Every place a ZCode install may keep the provider catalog its bundle needs.
+ * @param env - the environment to read install roots from.
+ * @returns candidate paths, most specific first.
+ */
+export declare function zcodeProviderConfigCandidates(env?: NodeJS.ProcessEnv): readonly string[];
+/**
+ * The bundled provider catalog inside the desktop app, when it exists.
+ * @param env - the environment to probe.
+ * @returns the catalog path, or undefined when no install was found.
+ */
+export declare function zcodeBuiltinProviderConfig(env?: NodeJS.ProcessEnv): string | undefined;
 /**
  * Map the session's dsh knobs onto ZCode's `--mode`.
  *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-loop-engine-allinone",
   "description": "Web-switchable agent loop engine selection for the DeepSeek Harness - out-of-tree plugin with a data-driven engine registry and a pluggable driver layer. Ten engines: Claude Code / Codex / Pi / Kimi Code / Antigravity / ZCode / Qoder CN / Hermes / Grok Build / MiniMax Code. All-in-one fork of kuun993/dsh-loop-engine.",
-  "version": "0.7.0",
+  "version": "0.7.3",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },