dsh-loop-engine-allinone 0.7.2 → 0.7.3

package/CHANGELOG.md

@@ -8,6 +8,29 @@ 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

package/README.md

@@ -130,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:
@@ -149,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

@@ -124,6 +124,7 @@ dsh plugin --profile web add ./dsh-loop-engine-allinone
       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

@@ -92,7 +92,7 @@ var __callDispose = (stack, error, hasError) => {
 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",
@@ -11478,7 +11499,7 @@ function readPatchFileSync(path) {
 }
 function warnIfProfileLooksWrong(ctx, config, patchPath) {
   const profileDir = dirname7(patchPath);
-  if (existsSync8(join21(profileDir, "package.json"))) return;
+  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.`

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.2",
+  "version": "0.7.3",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },