@docyrus/docyrus 0.0.64 → 0.0.66

package/main.js

@@ -18864,7 +18864,7 @@ var require_core3 = __commonJS({
       return match && match.index === 0;
     }
     var BACKREF_RE = /\[(?:[^\\\]]|\\.)*\]|\(\??|\\([1-9][0-9]*)|\\./;
-    function join19(regexps, separator = "|") {
+    function join20(regexps, separator = "|") {
       let numCaptures = 0;
       return regexps.map((regex) => {
         numCaptures += 1;
@@ -19168,7 +19168,7 @@ var require_core3 = __commonJS({
             this.exec = () => null;
           }
           const terminators = this.regexes.map((el) => el[1]);
-          this.matcherRe = langRe(join19(terminators), true);
+          this.matcherRe = langRe(join20(terminators), true);
           this.lastIndex = 0;
         }
         /** @param {string} s */
@@ -102181,7 +102181,7 @@ var require_snapshot_utils = __commonJS({
 var require_snapshot_recorder = __commonJS({
   "../../node_modules/.pnpm/undici@7.24.7/node_modules/undici/lib/mock/snapshot-recorder.js"(exports2, module2) {
     "use strict";
-    var { writeFile: writeFile10, readFile: readFile18, mkdir: mkdir11 } = require("node:fs/promises");
+    var { writeFile: writeFile10, readFile: readFile18, mkdir: mkdir12 } = require("node:fs/promises");
     var { dirname: dirname14, resolve: resolve2 } = require("node:path");
     var { setTimeout: setTimeout2, clearTimeout: clearTimeout2 } = require("node:timers");
     var { InvalidArgumentError, UndiciError } = require_errors3();
@@ -102413,7 +102413,7 @@ var require_snapshot_recorder = __commonJS({
           throw new InvalidArgumentError("Snapshot path is required");
         }
         const resolvedPath = resolve2(path8);
-        await mkdir11(dirname14(resolvedPath), { recursive: true });
+        await mkdir12(dirname14(resolvedPath), { recursive: true });
         const data = Array.from(this.#snapshots.entries()).map(([hash3, snapshot]) => ({
           hash: hash3,
           snapshot
@@ -138338,8 +138338,8 @@ function sanitizeName(name2) {
 }
 function rmForce(target) {
   try {
-    const stat = fs2.lstatSync(target);
-    if (stat.isSymbolicLink())
+    const stat2 = fs2.lstatSync(target);
+    if (stat2.isSymbolicLink())
       fs2.unlinkSync(target);
     else
       fs2.rmSync(target, { recursive: true, force: true });
@@ -139349,7 +139349,7 @@ function buildInputSchema(args2, env2, options2) {
 // package.json
 var package_default = {
   name: "@docyrus/docyrus",
-  version: "0.0.64",
+  version: "0.0.66",
   private: false,
   description: "Docyrus API CLI",
   main: "./main.js",
@@ -139361,16 +139361,16 @@ var package_default = {
   },
   dependencies: {
     "@clack/prompts": "^0.11.0",
+    "@ff-labs/fff-node": "0.6.4",
     "@hono/node-server": "^1.19.13",
-    "@mariozechner/pi-ai": "0.65.0",
-    "@mariozechner/pi-coding-agent": "0.65.0",
+    "@mariozechner/pi-ai": "0.70.2",
+    "@mariozechner/pi-coding-agent": "0.70.2",
     "@modelcontextprotocol/ext-apps": "^1.2.2",
     "@modelcontextprotocol/sdk": "^1.25.1",
     "@mozilla/readability": "^0.6.0",
     "@opentui/core": "0.1.96",
     "@opentui/react": "0.1.96",
     "@repomix/tree-sitter-wasms": "^0.1.16",
-    "@sinclair/typebox": "^0.34.48",
     "@xterm/headless": "^5.5.0",
     diff: "^9.0.0",
     hono: "^4.12.14",
@@ -139389,6 +139389,7 @@ var package_default = {
     "strip-ansi": "^7.1.0",
     turndown: "^7.2.2",
     "turndown-plugin-gfm": "^1.0.2",
+    typebox: "^1.1.24",
     undici: "^7.24.0",
     unified: "^11.0.5",
     "unist-util-visit": "^5.1.0",
@@ -140220,6 +140221,14 @@ var AUTH_DIR_PATH = (0, import_node_path3.join)((0, import_node_os5.homedir)(),
 var AUTH_FILE_PATH = (0, import_node_path3.join)(AUTH_DIR_PATH, "auth.json");
 var CONFIG_FILE_PATH = (0, import_node_path3.join)(AUTH_DIR_PATH, "config.json");
 var TENANT_OPENAPI_ROOT_PATH = (0, import_node_path3.join)(AUTH_DIR_PATH, "tenans");
+var DOCYRUS_PI_AGENT_GLOBAL_ROOT_PATH = (0, import_node_path3.join)(
+  AUTH_DIR_PATH,
+  DOCYRUS_PI_DIR_NAME,
+  DOCYRUS_PI_AGENT_DIR_NAME
+);
+function getDocyrusPiAgentGlobalRootPath() {
+  return DOCYRUS_PI_AGENT_GLOBAL_ROOT_PATH;
+}
 var TENANT_OPENAPI_PUBLIC_URL_TEMPLATE = "https://api.docyrus.app/storage/v1/object/public/tenant-public/{tenantId}/openapi.json";
 var DEFAULT_ENVIRONMENT_ID = "live";
 var DEFAULT_ENVIRONMENTS = [
@@ -147902,7 +147911,7 @@ async function resolveKnowledgeProviderFromAgentRuntime(params) {
       }
     };
   }
-  const agentRootPath = resolveDocyrusPiAgentRootPath(params.settingsRootPath);
+  const agentRootPath = params.piAgentRootPath ?? getDocyrusPiAgentGlobalRootPath();
   const authState = readJsonFile((0, import_node_path14.join)(agentRootPath, "auth.json")) || {};
   const envStore = new AgentEnvStore((0, import_node_path14.join)(agentRootPath, "env.json"));
   const envState = await envStore.readState();
@@ -153941,15 +153950,75 @@ var EnvironmentConfigService = class {
 // src/services/piAgentLauncher.ts
 var import_node_child_process8 = require("node:child_process");
 var import_node_fs17 = require("node:fs");
-var import_promises23 = require("node:fs/promises");
-var import_node_path29 = require("node:path");
+var import_promises24 = require("node:fs/promises");
+var import_node_path30 = require("node:path");
 
-// src/services/soulRegistry.ts
+// src/agent/piAgentMigration.ts
 var import_promises22 = require("node:fs/promises");
 var import_node_path28 = require("node:path");
+var LEGACY_PI_AGENT_FILES = [
+  "auth.json",
+  "env.json",
+  "models.json",
+  "settings.json"
+];
+async function pathExists(filePath) {
+  try {
+    await (0, import_promises22.access)(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function safeResolveRealPath(filePath) {
+  try {
+    const stats = await (0, import_promises22.stat)(filePath);
+    return stats.isDirectory() ? filePath : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function migrateLegacyPiAgentDir(params) {
+  if (params.legacyRootPath === params.globalRootPath) {
+    return { migrated: false, copiedFiles: [] };
+  }
+  const globalAuthPath = (0, import_node_path28.join)(params.globalRootPath, "auth.json");
+  if (await pathExists(globalAuthPath)) {
+    return { migrated: false, copiedFiles: [] };
+  }
+  const legacyAuthPath = (0, import_node_path28.join)(params.legacyRootPath, "auth.json");
+  if (!await pathExists(legacyAuthPath)) {
+    return { migrated: false, copiedFiles: [] };
+  }
+  const legacyRoot = await safeResolveRealPath(params.legacyRootPath);
+  if (!legacyRoot) {
+    return { migrated: false, copiedFiles: [] };
+  }
+  await (0, import_promises22.mkdir)(params.globalRootPath, {
+    recursive: true,
+    mode: 448
+  });
+  const copiedFiles = [];
+  for (const fileName of LEGACY_PI_AGENT_FILES) {
+    const source = (0, import_node_path28.join)(params.legacyRootPath, fileName);
+    if (!await pathExists(source)) {
+      continue;
+    }
+    const destination = (0, import_node_path28.join)(params.globalRootPath, fileName);
+    await (0, import_promises22.copyFile)(source, destination);
+    await (0, import_promises22.chmod)(destination, 384).catch(() => {
+    });
+    copiedFiles.push(fileName);
+  }
+  return { migrated: true, copiedFiles };
+}
+
+// src/services/soulRegistry.ts
+var import_promises23 = require("node:fs/promises");
+var import_node_path29 = require("node:path");
 function resolveBasePromptPath(params) {
   const filename = params.profile === "agent" ? "agent-system.md" : "coder-system.md";
-  return (0, import_node_path28.join)(params.resourceRoot, "prompts", filename);
+  return (0, import_node_path29.join)(params.resourceRoot, "prompts", filename);
 }
 async function composeSystemPrompt(params) {
   const soul = findSoul(params.soulId) ?? findSoul(DEFAULT_SOUL_ID);
@@ -153963,27 +154032,27 @@ async function composeSystemPrompt(params) {
   if (!soul.promptFile) {
     return basePromptPath;
   }
-  const overlayPath = (0, import_node_path28.join)(params.resourceRoot, "souls", soul.promptFile);
+  const overlayPath = (0, import_node_path29.join)(params.resourceRoot, "souls", soul.promptFile);
   const [basePrompt, overlayPrompt] = await Promise.all([
-    (0, import_promises22.readFile)(basePromptPath, "utf8"),
-    (0, import_promises22.readFile)(overlayPath, "utf8")
+    (0, import_promises23.readFile)(basePromptPath, "utf8"),
+    (0, import_promises23.readFile)(overlayPath, "utf8")
   ]);
-  const composedPath = (0, import_node_path28.join)(params.agentRootPath, `system-prompt-${params.profile}.md`);
+  const composedPath = (0, import_node_path29.join)(params.agentRootPath, `system-prompt-${params.profile}.md`);
   const composed = `${basePrompt.trimEnd()}
 
 ---
 
 ${overlayPrompt.trimEnd()}
 `;
-  await (0, import_promises22.mkdir)((0, import_node_path28.dirname)(composedPath), {
+  await (0, import_promises23.mkdir)((0, import_node_path29.dirname)(composedPath), {
     recursive: true,
     mode: 448
   });
-  await (0, import_promises22.writeFile)(composedPath, composed, {
+  await (0, import_promises23.writeFile)(composedPath, composed, {
     encoding: "utf8",
     mode: 384
   });
-  await (0, import_promises22.chmod)(composedPath, 384);
+  await (0, import_promises23.chmod)(composedPath, 384);
   return composedPath;
 }
 
@@ -154050,10 +154119,10 @@ function resolvePackagedPiResourceRoot(options2 = {}) {
   const dirname14 = options2.dirname ?? __dirname;
   const fileExists = options2.existsSyncFn ?? import_node_fs17.existsSync;
   const candidates = [
-    (0, import_node_path29.resolve)(cwd, "apps/api-cli/resources/pi-agent"),
-    (0, import_node_path29.resolve)(dirname14, "../resources/pi-agent"),
-    (0, import_node_path29.resolve)(dirname14, "resources/pi-agent"),
-    (0, import_node_path29.resolve)(cwd, "dist/apps/api-cli/resources/pi-agent")
+    (0, import_node_path30.resolve)(cwd, "apps/api-cli/resources/pi-agent"),
+    (0, import_node_path30.resolve)(dirname14, "../resources/pi-agent"),
+    (0, import_node_path30.resolve)(dirname14, "resources/pi-agent"),
+    (0, import_node_path30.resolve)(cwd, "dist/apps/api-cli/resources/pi-agent")
   ];
   const resolved = candidates.find((candidate) => fileExists(candidate));
   if (!resolved) {
@@ -154074,23 +154143,23 @@ function resolveDocyrusPiLoaderEntryPath(options2 = {}) {
     }
   };
   const collectAncestorCandidates = (startDir) => {
-    let currentDir = (0, import_node_path29.resolve)(startDir);
+    let currentDir = (0, import_node_path30.resolve)(startDir);
     while (true) {
-      addCandidate((0, import_node_path29.join)(currentDir, "dist", "apps", "api-cli", "agent-loader.js"));
-      addCandidate((0, import_node_path29.join)(currentDir, "agent-loader.js"));
-      if ((0, import_node_path29.basename)(currentDir) === "dist") {
-        addCandidate((0, import_node_path29.join)(currentDir, "apps", "api-cli", "agent-loader.js"));
+      addCandidate((0, import_node_path30.join)(currentDir, "dist", "apps", "api-cli", "agent-loader.js"));
+      addCandidate((0, import_node_path30.join)(currentDir, "agent-loader.js"));
+      if ((0, import_node_path30.basename)(currentDir) === "dist") {
+        addCandidate((0, import_node_path30.join)(currentDir, "apps", "api-cli", "agent-loader.js"));
       }
-      const parentDir = (0, import_node_path29.resolve)(currentDir, "..");
+      const parentDir = (0, import_node_path30.resolve)(currentDir, "..");
       if (parentDir === currentDir) {
         break;
       }
       currentDir = parentDir;
     }
   };
-  addCandidate((0, import_node_path29.resolve)(cwd, "dist/apps/api-cli/agent-loader.js"));
-  addCandidate((0, import_node_path29.resolve)(dirname14, "../agent-loader.js"));
-  addCandidate((0, import_node_path29.resolve)(dirname14, "agent-loader.js"));
+  addCandidate((0, import_node_path30.resolve)(cwd, "dist/apps/api-cli/agent-loader.js"));
+  addCandidate((0, import_node_path30.resolve)(dirname14, "../agent-loader.js"));
+  addCandidate((0, import_node_path30.resolve)(dirname14, "agent-loader.js"));
   collectAncestorCandidates(cwd);
   collectAncestorCandidates(dirname14);
   const resolved = candidates.find((candidate) => fileExists(candidate));
@@ -154110,20 +154179,20 @@ function resolveDocyrusCliEntryPath(options2 = {}) {
     if (!candidate) {
       return;
     }
-    const resolvedCandidate = (0, import_node_path29.resolve)(candidate);
+    const resolvedCandidate = (0, import_node_path30.resolve)(candidate);
     if (!seen.has(resolvedCandidate)) {
       seen.add(resolvedCandidate);
       candidates.push(resolvedCandidate);
     }
   };
   const argvScript = argv[1]?.trim();
-  const normalizedArgvScript = argvScript ? argvScript.startsWith("/") ? argvScript : (0, import_node_path29.resolve)(cwd, argvScript) : void 0;
+  const normalizedArgvScript = argvScript ? argvScript.startsWith("/") ? argvScript : (0, import_node_path30.resolve)(cwd, argvScript) : void 0;
   if (normalizedArgvScript && normalizedArgvScript.endsWith(".js")) {
     addCandidate(normalizedArgvScript);
   }
-  addCandidate((0, import_node_path29.resolve)(cwd, "dist/apps/api-cli/main.js"));
-  addCandidate((0, import_node_path29.resolve)(dirname14, "../main.js"));
-  addCandidate((0, import_node_path29.resolve)(dirname14, "main.js"));
+  addCandidate((0, import_node_path30.resolve)(cwd, "dist/apps/api-cli/main.js"));
+  addCandidate((0, import_node_path30.resolve)(dirname14, "../main.js"));
+  addCandidate((0, import_node_path30.resolve)(dirname14, "main.js"));
   if (normalizedArgvScript) {
     addCandidate(normalizedArgvScript);
   }
@@ -154146,32 +154215,32 @@ function resolveInstalledPiPackageRootPath(options2 = {}) {
     }
   };
   const collectAncestorCandidates = (startDir) => {
-    let currentDir = (0, import_node_path29.resolve)(startDir);
+    let currentDir = (0, import_node_path30.resolve)(startDir);
     while (true) {
-      addCandidate((0, import_node_path29.join)(currentDir, "node_modules", "@mariozechner", "pi-coding-agent", "package.json"));
-      if ((0, import_node_path29.basename)(currentDir) === "node_modules") {
-        addCandidate((0, import_node_path29.join)(currentDir, "@mariozechner", "pi-coding-agent", "package.json"));
+      addCandidate((0, import_node_path30.join)(currentDir, "node_modules", "@mariozechner", "pi-coding-agent", "package.json"));
+      if ((0, import_node_path30.basename)(currentDir) === "node_modules") {
+        addCandidate((0, import_node_path30.join)(currentDir, "@mariozechner", "pi-coding-agent", "package.json"));
       }
-      const parentDir = (0, import_node_path29.resolve)(currentDir, "..");
+      const parentDir = (0, import_node_path30.resolve)(currentDir, "..");
       if (parentDir === currentDir) {
         break;
       }
       currentDir = parentDir;
     }
   };
-  addCandidate((0, import_node_path29.resolve)(cwd, "apps/api-cli/node_modules/@mariozechner/pi-coding-agent/package.json"));
-  addCandidate((0, import_node_path29.resolve)(dirname14, "../../../apps/api-cli/node_modules/@mariozechner/pi-coding-agent/package.json"));
+  addCandidate((0, import_node_path30.resolve)(cwd, "apps/api-cli/node_modules/@mariozechner/pi-coding-agent/package.json"));
+  addCandidate((0, import_node_path30.resolve)(dirname14, "../../../apps/api-cli/node_modules/@mariozechner/pi-coding-agent/package.json"));
   collectAncestorCandidates(cwd);
   collectAncestorCandidates(dirname14);
   const resolvedPackageJson = candidates.find((candidate) => fileExists(candidate));
   if (!resolvedPackageJson) {
     throw new UserInputError(`Unable to locate the installed pi package root. Checked: ${candidates.join(", ")}`);
   }
-  return (0, import_node_path29.resolve)(resolvedPackageJson, "..");
+  return (0, import_node_path30.resolve)(resolvedPackageJson, "..");
 }
 function createPiAgentRuntimeSkill(params) {
   const commandPrefix = params.scope === "global" ? "docyrus -g" : "docyrus";
-  const knowledgeDir = (0, import_node_path29.join)(params.cwd, "docyrus", "knowledge");
+  const knowledgeDir = (0, import_node_path30.join)(params.cwd, "docyrus", "knowledge");
   const hasKnowledgeGraph = (0, import_node_fs17.existsSync)(knowledgeDir);
   const authLines = params.activeProfile ? [
     `- email: \`${params.activeProfile.email}\``,
@@ -154225,35 +154294,35 @@ function createPiAgentRuntimeSkill(params) {
   ].join("\n");
 }
 async function syncPackagedSkills(params) {
-  const sourceSkillsRoot = (0, import_node_path29.join)(params.resourceRoot, "skills");
-  const targetSkillsRoot = (0, import_node_path29.join)(params.agentRootPath, "skills");
-  await (0, import_promises23.mkdir)(targetSkillsRoot, {
+  const sourceSkillsRoot = (0, import_node_path30.join)(params.resourceRoot, "skills");
+  const targetSkillsRoot = (0, import_node_path30.join)(params.agentRootPath, "skills");
+  await (0, import_promises24.mkdir)(targetSkillsRoot, {
     recursive: true,
     mode: 448
   });
-  const entries = await (0, import_promises23.readdir)(sourceSkillsRoot, {
+  const entries = await (0, import_promises24.readdir)(sourceSkillsRoot, {
     withFileTypes: true
   });
   await Promise.all(DOCYRUS_MIGRATED_SKILL_NAMES.map(async (skillName) => {
-    await (0, import_promises23.rm)((0, import_node_path29.join)(targetSkillsRoot, skillName), {
+    await (0, import_promises24.rm)((0, import_node_path30.join)(targetSkillsRoot, skillName), {
       recursive: true,
       force: true
     });
   }));
   await Promise.all(entries.map(async (entry) => {
-    await (0, import_promises23.cp)((0, import_node_path29.join)(sourceSkillsRoot, entry.name), (0, import_node_path29.join)(targetSkillsRoot, entry.name), {
+    await (0, import_promises24.cp)((0, import_node_path30.join)(sourceSkillsRoot, entry.name), (0, import_node_path30.join)(targetSkillsRoot, entry.name), {
       recursive: true,
       force: true
     });
   }));
 }
 async function writeRuntimeSkill(params) {
-  const runtimeSkillDir = (0, import_node_path29.join)(params.agentRootPath, "skills", "docyrus-runtime-context");
-  await (0, import_promises23.mkdir)(runtimeSkillDir, {
+  const runtimeSkillDir = (0, import_node_path30.join)(params.agentRootPath, "skills", "docyrus-runtime-context");
+  await (0, import_promises24.mkdir)(runtimeSkillDir, {
     recursive: true,
     mode: 448
   });
-  await (0, import_promises23.writeFile)((0, import_node_path29.join)(runtimeSkillDir, "SKILL.md"), `${params.content}
+  await (0, import_promises24.writeFile)((0, import_node_path30.join)(runtimeSkillDir, "SKILL.md"), `${params.content}
 `, {
     encoding: "utf8",
     mode: 384
@@ -154266,10 +154335,10 @@ function resolveNpmCommand() {
   return process.platform === "win32" ? "npm.cmd" : "npm";
 }
 function resolveManagedDiffityInstallRoot(agentRootPath) {
-  return (0, import_node_path29.join)(agentRootPath, "tools", "diffity");
+  return (0, import_node_path30.join)(agentRootPath, "tools", "diffity");
 }
 function resolveManagedDiffityExecutablePath(agentRootPath) {
-  return (0, import_node_path29.join)(
+  return (0, import_node_path30.join)(
     resolveManagedDiffityInstallRoot(agentRootPath),
     "node_modules",
     ".bin",
@@ -154277,10 +154346,10 @@ function resolveManagedDiffityExecutablePath(agentRootPath) {
   );
 }
 function prependPathEntry(entry, existingPath) {
-  const values = existingPath ? existingPath.split(import_node_path29.delimiter).filter((value2) => value2.trim().length > 0) : [];
+  const values = existingPath ? existingPath.split(import_node_path30.delimiter).filter((value2) => value2.trim().length > 0) : [];
   const normalizedEntry = entry.trim();
   const remaining = values.filter((value2) => value2 !== normalizedEntry);
-  return [normalizedEntry, ...remaining].join(import_node_path29.delimiter);
+  return [normalizedEntry, ...remaining].join(import_node_path30.delimiter);
 }
 function createDocyrusSkillsInstallArgs(scope) {
   const args2 = [
@@ -154318,7 +154387,7 @@ function createPackagedDocyrusPlatformInstallArgs(params) {
   return args2;
 }
 async function installExternalDocyrusSkillsOnce(params) {
-  const markerPath = (0, import_node_path29.join)(params.agentRootPath, DOCYRUS_EXTERNAL_SKILL_MARKER_FILE);
+  const markerPath = (0, import_node_path30.join)(params.agentRootPath, DOCYRUS_EXTERNAL_SKILL_MARKER_FILE);
   if ((0, import_node_fs17.existsSync)(markerPath)) {
     return;
   }
@@ -154337,7 +154406,7 @@ async function installExternalDocyrusSkillsOnce(params) {
     );
     return;
   }
-  await (0, import_promises23.writeFile)(markerPath, `${JSON.stringify({
+  await (0, import_promises24.writeFile)(markerPath, `${JSON.stringify({
     source: DOCYRUS_EXTERNAL_SKILL_SOURCE,
     skills: DOCYRUS_MIGRATED_SKILL_NAMES,
     agents: DOCYRUS_EXTERNAL_SKILL_AGENT_IDS,
@@ -154351,7 +154420,7 @@ async function installExternalDocyrusSkillsOnce(params) {
 }
 async function ensureManagedDiffityInstalled(params) {
   const executablePath = resolveManagedDiffityExecutablePath(params.agentRootPath);
-  const binDir = (0, import_node_path29.dirname)(executablePath);
+  const binDir = (0, import_node_path30.dirname)(executablePath);
   if ((0, import_node_fs17.existsSync)(executablePath)) {
     return {
       available: true,
@@ -154390,19 +154459,19 @@ async function ensureManagedDiffityInstalled(params) {
   };
 }
 function resolvePackagedDocyrusPlatformSkillPath(resourceRoot) {
-  return (0, import_node_path29.join)(resourceRoot, "skills", DOCYRUS_PACKAGED_PLATFORM_SKILL_NAME);
+  return (0, import_node_path30.join)(resourceRoot, "skills", DOCYRUS_PACKAGED_PLATFORM_SKILL_NAME);
 }
 function resolvePackagedOfficeCliRootPath(resourceRoot) {
-  return (0, import_node_path29.join)((0, import_node_path29.resolve)(resourceRoot, ".."), "officecli");
+  return (0, import_node_path30.join)((0, import_node_path30.resolve)(resourceRoot, ".."), "officecli");
 }
 function resolvePackagedOfficeCliManifestPath(resourceRoot) {
-  return (0, import_node_path29.join)(resolvePackagedOfficeCliRootPath(resourceRoot), DOCYRUS_OFFICECLI_MANIFEST_FILE_NAME);
+  return (0, import_node_path30.join)(resolvePackagedOfficeCliRootPath(resourceRoot), DOCYRUS_OFFICECLI_MANIFEST_FILE_NAME);
 }
 function resolveManagedOfficeCliInstallRoot(agentRootPath) {
-  return (0, import_node_path29.join)(agentRootPath, "tools", "officecli");
+  return (0, import_node_path30.join)(agentRootPath, "tools", "officecli");
 }
 function resolveManagedOfficeCliExecutablePath(agentRootPath) {
-  return (0, import_node_path29.join)(
+  return (0, import_node_path30.join)(
     resolveManagedOfficeCliInstallRoot(agentRootPath),
     process.platform === "win32" ? "officecli.exe" : "officecli"
   );
@@ -154444,14 +154513,14 @@ function resolveOfficeCliReleaseAssetName(options2 = {}) {
   throw new UserInputError(`OfficeCLI is not supported on ${platform2}/${arch}.`);
 }
 function resolvePackagedOfficeCliExecutablePath(resourceRoot, options2) {
-  return (0, import_node_path29.join)(
+  return (0, import_node_path30.join)(
     resolvePackagedOfficeCliRootPath(resourceRoot),
     "bundled",
     resolveOfficeCliReleaseAssetName(options2)
   );
 }
 async function readPackagedOfficeCliVersion(resourceRoot) {
-  const manifestRaw = await (0, import_promises23.readFile)(resolvePackagedOfficeCliManifestPath(resourceRoot), "utf8");
+  const manifestRaw = await (0, import_promises24.readFile)(resolvePackagedOfficeCliManifestPath(resourceRoot), "utf8");
   const manifest = JSON.parse(manifestRaw);
   const version2 = typeof manifest.version === "string" ? manifest.version.trim() : "";
   if (version2.length === 0) {
@@ -154467,12 +154536,12 @@ async function downloadOfficeCliBinary(params) {
     throw new UserInputError(`OfficeCLI download failed with status ${response.status}.`);
   }
   const binary2 = Buffer.from(await response.arrayBuffer());
-  await (0, import_promises23.writeFile)(params.destinationPath, binary2, {
+  await (0, import_promises24.writeFile)(params.destinationPath, binary2, {
     mode: process.platform === "win32" ? 384 : 448
   });
 }
 function resolveManagedOfficeCliConfigMarkerPath(agentRootPath) {
-  return (0, import_node_path29.join)(resolveManagedOfficeCliInstallRoot(agentRootPath), ".docyrus-officecli-configured.json");
+  return (0, import_node_path30.join)(resolveManagedOfficeCliInstallRoot(agentRootPath), ".docyrus-officecli-configured.json");
 }
 async function disableManagedOfficeCliAutoUpdate(params) {
   const markerPath = resolveManagedOfficeCliConfigMarkerPath(params.agentRootPath);
@@ -154495,7 +154564,7 @@ async function disableManagedOfficeCliAutoUpdate(params) {
     );
     return;
   }
-  await (0, import_promises23.writeFile)(markerPath, `${JSON.stringify({
+  await (0, import_promises24.writeFile)(markerPath, `${JSON.stringify({
     configuredAt: (/* @__PURE__ */ new Date()).toISOString()
   }, null, 2)}
 `, {
@@ -154505,7 +154574,7 @@ async function disableManagedOfficeCliAutoUpdate(params) {
 }
 async function ensureManagedOfficeCliInstalled(params) {
   const executablePath = resolveManagedOfficeCliExecutablePath(params.agentRootPath);
-  const binDir = (0, import_node_path29.dirname)(executablePath);
+  const binDir = (0, import_node_path30.dirname)(executablePath);
   if ((0, import_node_fs17.existsSync)(executablePath)) {
     await disableManagedOfficeCliAutoUpdate({
       agentRootPath: params.agentRootPath,
@@ -154521,13 +154590,13 @@ async function ensureManagedOfficeCliInstalled(params) {
   }
   const tempPath = `${executablePath}.download${process.platform === "win32" ? ".exe" : ""}`;
   try {
-    await (0, import_promises23.mkdir)(binDir, {
+    await (0, import_promises24.mkdir)(binDir, {
       recursive: true,
       mode: 448
     });
     const bundledExecutablePath = resolvePackagedOfficeCliExecutablePath(params.resourceRoot);
     if ((0, import_node_fs17.existsSync)(bundledExecutablePath)) {
-      await (0, import_promises23.cp)(bundledExecutablePath, tempPath, {
+      await (0, import_promises24.cp)(bundledExecutablePath, tempPath, {
         force: true
       });
     } else {
@@ -154537,7 +154606,7 @@ async function ensureManagedOfficeCliInstalled(params) {
       });
     }
     if (process.platform !== "win32") {
-      await (0, import_promises23.chmod)(tempPath, 448);
+      await (0, import_promises24.chmod)(tempPath, 448);
     }
     const verificationResult = params.spawnCommand(tempPath, ["--version"], {
       stdio: ["ignore", "pipe", "pipe"],
@@ -154553,9 +154622,9 @@ async function ensureManagedOfficeCliInstalled(params) {
         verificationResult.error?.message || summarizeFailure3(verificationResult, "officecli --version")
       );
     }
-    await (0, import_promises23.rename)(tempPath, executablePath);
+    await (0, import_promises24.rename)(tempPath, executablePath);
     if (process.platform !== "win32") {
-      await (0, import_promises23.chmod)(executablePath, 448);
+      await (0, import_promises24.chmod)(executablePath, 448);
     }
     await disableManagedOfficeCliAutoUpdate({
       agentRootPath: params.agentRootPath,
@@ -154569,7 +154638,7 @@ async function ensureManagedOfficeCliInstalled(params) {
       binDir
     };
   } catch (error48) {
-    await (0, import_promises23.rm)(tempPath, {
+    await (0, import_promises24.rm)(tempPath, {
       force: true
     });
     process.stderr.write(
@@ -154628,6 +154697,7 @@ function createPiAgentLauncher(options2) {
   const resolveLoaderPath = options2.resolveDocyrusPiLoaderEntryPathFn ?? resolveDocyrusPiLoaderEntryPath;
   const resolveCliEntryPath = options2.resolveDocyrusCliEntryPathFn ?? resolveDocyrusCliEntryPath;
   const resolvePiPackageRoot = options2.resolveInstalledPiPackageRootPathFn ?? resolveInstalledPiPackageRootPath;
+  const resolveAgentRootPath = options2.resolveAgentRootPathFn ?? getDocyrusPiAgentGlobalRootPath;
   return async (request) => {
     validatePiAgentLaunchRequest({
       request,
@@ -154637,7 +154707,12 @@ function createPiAgentLauncher(options2) {
     const activeEnvironment = await options2.environmentConfigService.getActiveEnvironment();
     const activeProfile = await options2.authStore.getActiveProfile(activeEnvironment.apiBaseUrl);
     const settingsRootPath = options2.settingsPaths.rootPath;
-    const agentRootPath = resolveDocyrusPiAgentRootPath(settingsRootPath);
+    const agentRootPath = resolveAgentRootPath();
+    await migrateLegacyPiAgentDir({
+      legacyRootPath: resolveDocyrusPiAgentRootPath(settingsRootPath),
+      globalRootPath: agentRootPath
+    }).catch(() => {
+    });
     const resourceRoot = resolveResourceRoot({ cwd });
     spinner.update("Syncing skills...");
     await syncPackagedSkills({
@@ -154708,6 +154783,9 @@ function createPiAgentLauncher(options2) {
         ...process.env,
         PI_CODING_AGENT_DIR: agentRootPath,
         PI_PACKAGE_DIR: piPackageRoot,
+        // Disable pi-mono's install-telemetry ping (added in pi-mono v0.67.0).
+        // Only users explicitly opting in via DOCYRUS_PI_ENABLE_TELEMETRY=1 will let it fire.
+        PI_TELEMETRY: process.env.DOCYRUS_PI_ENABLE_TELEMETRY === "1" ? process.env.PI_TELEMETRY ?? "" : "0",
         DOCYRUS_PI_REQUEST: JSON.stringify(request),
         DOCYRUS_PI_VERSION: options2.version || "dev",
         DOCYRUS_PI_SYSTEM_PROMPT_PATH: systemPromptPath,
@@ -154733,7 +154811,7 @@ function createPiAgentLauncher(options2) {
 // src/services/piAgentServerLauncher.ts
 var import_node_child_process9 = require("node:child_process");
 var import_node_fs18 = require("node:fs");
-var import_node_path30 = require("node:path");
+var import_node_path31 = require("node:path");
 function serializePiAgentServerRequest(request) {
   return JSON.stringify(request);
 }
@@ -154747,23 +154825,23 @@ function resolveServerLoaderEntryPath(cwd, dirname14) {
     }
   };
   const collectAncestorCandidates = (startDir) => {
-    let currentDir = (0, import_node_path30.resolve)(startDir);
+    let currentDir = (0, import_node_path31.resolve)(startDir);
     while (true) {
-      addCandidate((0, import_node_path30.join)(currentDir, "dist", "apps", "api-cli", "server-loader.js"));
-      addCandidate((0, import_node_path30.join)(currentDir, "server-loader.js"));
-      if ((0, import_node_path30.basename)(currentDir) === "dist") {
-        addCandidate((0, import_node_path30.join)(currentDir, "apps", "api-cli", "server-loader.js"));
+      addCandidate((0, import_node_path31.join)(currentDir, "dist", "apps", "api-cli", "server-loader.js"));
+      addCandidate((0, import_node_path31.join)(currentDir, "server-loader.js"));
+      if ((0, import_node_path31.basename)(currentDir) === "dist") {
+        addCandidate((0, import_node_path31.join)(currentDir, "apps", "api-cli", "server-loader.js"));
       }
-      const parentDir = (0, import_node_path30.resolve)(currentDir, "..");
+      const parentDir = (0, import_node_path31.resolve)(currentDir, "..");
       if (parentDir === currentDir) {
         break;
       }
       currentDir = parentDir;
     }
   };
-  addCandidate((0, import_node_path30.resolve)(cwd, "dist/apps/api-cli/server-loader.js"));
-  addCandidate((0, import_node_path30.resolve)(dirname14, "../server-loader.js"));
-  addCandidate((0, import_node_path30.resolve)(dirname14, "server-loader.js"));
+  addCandidate((0, import_node_path31.resolve)(cwd, "dist/apps/api-cli/server-loader.js"));
+  addCandidate((0, import_node_path31.resolve)(dirname14, "../server-loader.js"));
+  addCandidate((0, import_node_path31.resolve)(dirname14, "server-loader.js"));
   collectAncestorCandidates(cwd);
   collectAncestorCandidates(dirname14);
   const resolved = candidates.find((candidate) => (0, import_node_fs18.existsSync)(candidate));
@@ -154774,12 +154852,18 @@ function resolveServerLoaderEntryPath(cwd, dirname14) {
 }
 function createPiAgentServerLauncher(options2) {
   const cwd = options2.cwd ?? process.cwd();
+  const resolveAgentRootPath = options2.resolveAgentRootPathFn ?? getDocyrusPiAgentGlobalRootPath;
   return async (request) => {
     const spinner = createSpinner("Initializing...");
     const activeEnvironment = await options2.environmentConfigService.getActiveEnvironment();
     const activeProfile = await options2.authStore.getActiveProfile(activeEnvironment.apiBaseUrl);
     const settingsRootPath = options2.settingsPaths.rootPath;
-    const agentRootPath = resolveDocyrusPiAgentRootPath(settingsRootPath);
+    const agentRootPath = resolveAgentRootPath();
+    await migrateLegacyPiAgentDir({
+      legacyRootPath: resolveDocyrusPiAgentRootPath(settingsRootPath),
+      globalRootPath: agentRootPath
+    }).catch(() => {
+    });
     const resourceRoot = resolvePackagedPiResourceRoot({ cwd });
     spinner.update("Syncing skills...");
     await syncPackagedSkills({
@@ -154819,7 +154903,7 @@ function createPiAgentServerLauncher(options2) {
     if (request.sandbox) {
       const browserConfigDir = settingsRootPath;
       (0, import_node_fs18.mkdirSync)(browserConfigDir, { recursive: true, mode: 448 });
-      const browserConfigPath = (0, import_node_path30.join)(browserConfigDir, "browser.json");
+      const browserConfigPath = (0, import_node_path31.join)(browserConfigDir, "browser.json");
       const appId = process.env.DOCYRUS_SANDBOX_APP_ID || "";
       (0, import_node_fs18.writeFileSync)(browserConfigPath, JSON.stringify({ mode: "sandbox", appId }, null, 2) + "\n", {
         encoding: "utf8",
@@ -154846,6 +154930,9 @@ function createPiAgentServerLauncher(options2) {
         PATH: runtimePath,
         PI_CODING_AGENT_DIR: agentRootPath,
         PI_PACKAGE_DIR: piPackageRoot,
+        // Disable pi-mono's install-telemetry ping (added in pi-mono v0.67.0).
+        // Only users explicitly opting in via DOCYRUS_PI_ENABLE_TELEMETRY=1 will let it fire.
+        PI_TELEMETRY: process.env.DOCYRUS_PI_ENABLE_TELEMETRY === "1" ? process.env.PI_TELEMETRY ?? "" : "0",
         DOCYRUS_PI_REQUEST: serializePiAgentServerRequest(request),
         DOCYRUS_PI_VERSION: options2.version || "dev",
         DOCYRUS_PI_SYSTEM_PROMPT_PATH: systemPromptPath,
@@ -154904,8 +154991,8 @@ async function runWithIncurSkillsOutOfDateWarningSuppressed(params) {
 }
 
 // src/services/tenantOpenApi.ts
-var import_promises24 = require("node:fs/promises");
-var import_node_path31 = require("node:path");
+var import_promises25 = require("node:fs/promises");
+var import_node_path32 = require("node:path");
 function resolveSourceUrl(tenantId, template) {
   return template.replace("{tenantId}", encodeURIComponent(tenantId));
 }
@@ -154930,16 +155017,16 @@ var TenantOpenApiService = class {
   params;
   async #writeOpenApiFile(tenantId, parsedContent) {
     const filePath = this.getTenantOpenApiFilePath(tenantId);
-    await (0, import_promises24.mkdir)((0, import_node_path31.dirname)(filePath), {
+    await (0, import_promises25.mkdir)((0, import_node_path32.dirname)(filePath), {
       recursive: true,
       mode: 448
     });
-    await (0, import_promises24.writeFile)(filePath, `${JSON.stringify(parsedContent, null, 2)}
+    await (0, import_promises25.writeFile)(filePath, `${JSON.stringify(parsedContent, null, 2)}
 `, {
       encoding: "utf8",
       mode: 384
     });
-    await (0, import_promises24.chmod)(filePath, 384);
+    await (0, import_promises25.chmod)(filePath, 384);
     return filePath;
   }
   async #generateTenantOpenApiViaAuthenticatedEndpoint(tenantId, options2) {
@@ -154976,7 +155063,7 @@ var TenantOpenApiService = class {
       throw new AuthSessionError("Tenant ID is required to resolve OpenAPI spec path.");
     }
     const rootPath = this.params?.rootPath || TENANT_OPENAPI_ROOT_PATH;
-    return (0, import_node_path31.join)(rootPath, normalizedTenantId, "openapi.json");
+    return (0, import_node_path32.join)(rootPath, normalizedTenantId, "openapi.json");
   }
   async downloadTenantOpenApi(tenantId, options2 = {}) {
     const normalizedTenantId = tenantId.trim();