@docyrus/docyrus 0.0.20 → 0.0.22

package/main.js

@@ -18851,7 +18851,7 @@ var require_core3 = __commonJS({
       return match && match.index === 0;
     }
     var BACKREF_RE = /\[(?:[^\\\]]|\\.)*\]|\(\??|\\([1-9][0-9]*)|\\./;
-    function join6(regexps, separator = "|") {
+    function join7(regexps, separator = "|") {
       let numCaptures = 0;
       return regexps.map((regex) => {
         numCaptures += 1;
@@ -19155,7 +19155,7 @@ var require_core3 = __commonJS({
             this.exec = () => null;
           }
           const terminators = this.regexes.map((el) => el[1]);
-          this.matcherRe = langRe(join6(terminators), true);
+          this.matcherRe = langRe(join7(terminators), true);
           this.lastIndex = 0;
         }
         /** @param {string} s */
@@ -124678,7 +124678,7 @@ function buildInputSchema(args, env2, options2) {
 // package.json
 var package_default = {
   name: "@docyrus/docyrus",
-  version: "0.0.20",
+  version: "0.0.22",
   private: false,
   description: "Docyrus API CLI",
   main: "./main.js",
@@ -124686,17 +124686,30 @@ var package_default = {
     docyrus: "main.js"
   },
   dependencies: {
+    "@mozilla/readability": "^0.6.0",
     "@clack/prompts": "^0.11.0",
+    "@modelcontextprotocol/ext-apps": "^1.2.2",
+    "@modelcontextprotocol/sdk": "^1.25.1",
     "@mariozechner/pi-ai": "0.61.0",
-    "@mariozechner/pi-coding-agent": "0.61.0",
+    "@mariozechner/pi-coding-agent": "0.61.1",
     "@opentui/core": "^0.1.85",
     "@opentui/react": "^0.1.85",
+    "@xterm/headless": "^5.5.0",
+    cheerio: "^1.1.2",
+    diff: "^8.0.2",
     incur: "^0.1.6",
+    jsdom: "^27.0.1",
     marked: "^15.0.12",
     "marked-terminal": "^7.3.0",
+    "node-pty": "^1.0.0",
     picocolors: "^1.1.1",
+    "puppeteer-core": "^24.31.0",
     react: "^19.1.1",
-    undici: "^7.16.0"
+    "strip-ansi": "^7.1.0",
+    turndown: "^7.2.2",
+    "turndown-plugin-gfm": "^1.0.2",
+    undici: "^7.16.0",
+    zod: "^4.3.6"
   },
   devDependencies: {
     "@types/react": "^19.1.13"
@@ -125688,9 +125701,244 @@ function createAuthCli(dependencies) {
   return authCli;
 }
 
+// src/commands/chromeCommands.ts
+var import_node_child_process2 = require("node:child_process");
+var import_node_fs3 = require("node:fs");
+var import_node_path4 = require("node:path");
+function summarizeFailure(result) {
+  const stderr = result.stderr?.toString().trim();
+  if (stderr && stderr.length > 0) {
+    return stderr;
+  }
+  if (typeof result.status === "number") {
+    return `Chrome tool exited with code ${result.status}.`;
+  }
+  if (result.signal) {
+    return `Chrome tool exited due to signal ${result.signal}.`;
+  }
+  return "Chrome tool terminated unexpectedly.";
+}
+function resolveChromeToolsResourceRoot(options2 = {}) {
+  const cwd = options2.cwd ?? process.cwd();
+  const dirname6 = options2.dirname ?? __dirname;
+  const fileExists = options2.existsSyncFn ?? import_node_fs3.existsSync;
+  const candidates = options2.candidatePaths ?? [
+    (0, import_node_path4.resolve)(cwd, "apps/api-cli/resources/chrome-tools"),
+    (0, import_node_path4.resolve)(dirname6, "../resources/chrome-tools"),
+    (0, import_node_path4.resolve)(dirname6, "resources/chrome-tools"),
+    (0, import_node_path4.resolve)(cwd, "dist/apps/api-cli/resources/chrome-tools")
+  ];
+  const resolved = candidates.find((candidate) => fileExists(candidate));
+  if (!resolved) {
+    throw new UserInputError(`Unable to locate chrome tool resources. Checked: ${candidates.join(", ")}`);
+  }
+  return resolved;
+}
+function resolveChromeToolScriptPath(params) {
+  const scriptPath = (0, import_node_path4.join)(params.resourceRoot, params.scriptName);
+  if (!(0, import_node_fs3.existsSync)(scriptPath)) {
+    throw new UserInputError(`Missing chrome tool script: ${scriptPath}`);
+  }
+  return scriptPath;
+}
+function parseTextOutput(rawOutput) {
+  return rawOutput.trimEnd();
+}
+function parseJsonOutput(rawOutput) {
+  const trimmedOutput = rawOutput.trim();
+  if (!trimmedOutput) {
+    return [];
+  }
+  try {
+    return JSON.parse(trimmedOutput);
+  } catch (error48) {
+    throw new UserInputError("Chrome tool returned invalid JSON output.", {
+      cause: error48,
+      rawOutput: trimmedOutput
+    });
+  }
+}
+function executeChromeTool(params) {
+  const resolveResourceRoot = params.resolveChromeToolsResourceRootFn ?? resolveChromeToolsResourceRoot;
+  const resourceRoot = resolveResourceRoot({
+    cwd: params.cwd
+  });
+  const scriptPath = resolveChromeToolScriptPath({
+    resourceRoot,
+    scriptName: params.scriptName
+  });
+  const spawnCommand = params.spawnSyncFn ?? import_node_child_process2.spawnSync;
+  const processExecPath = params.processExecPath ?? process.execPath;
+  const result = spawnCommand(processExecPath, [scriptPath, ...params.args], {
+    encoding: "utf8",
+    cwd: params.cwd ?? process.cwd(),
+    env: {
+      ...process.env
+    }
+  });
+  if (result.error) {
+    throw new UserInputError(`Unable to start chrome tool '${params.scriptName}': ${result.error.message}`, {
+      cause: result.error
+    });
+  }
+  if (result.status !== 0) {
+    throw new UserInputError(`Chrome tool '${params.scriptName}' failed: ${summarizeFailure(result)}`);
+  }
+  const stdout = result.stdout?.toString() || "";
+  if (params.outputMode === "json") {
+    return parseJsonOutput(stdout);
+  }
+  return parseTextOutput(stdout);
+}
+function createChromeCli(options2 = {}) {
+  const chromeCli = Cli_exports.create("chrome", {
+    description: "Chrome DevTools browser automation commands",
+    env: EnvSchema
+  });
+  chromeCli.command("start", {
+    description: "Launch Chrome with remote debugging on :9222",
+    options: external_exports.object({
+      profile: external_exports.boolean().optional().describe("Copy your default Chrome profile (cookies, logins)")
+    }),
+    run: async (context) => {
+      return executeChromeTool({
+        scriptName: "browser-start.js",
+        args: context.options.profile ? ["--profile"] : [],
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+      });
+    }
+  });
+  chromeCli.command("nav", {
+    description: "Navigate the current Chrome tab or open a URL in a new tab",
+    args: external_exports.object({
+      url: external_exports.string().min(1)
+    }),
+    options: external_exports.object({
+      new: external_exports.boolean().optional().describe("Open the URL in a new tab"),
+      reload: external_exports.boolean().optional().describe("Force a reload after navigation")
+    }),
+    run: async (context) => {
+      const args = [context.args.url];
+      if (context.options.new) {
+        args.push("--new");
+      }
+      if (context.options.reload) {
+        args.push("--reload");
+      }
+      return executeChromeTool({
+        scriptName: "browser-nav.js",
+        args,
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+      });
+    }
+  });
+  chromeCli.command("eval", {
+    description: "Evaluate JavaScript in the active Chrome tab",
+    args: external_exports.object({
+      code: external_exports.string().min(1)
+    }),
+    run: async (context) => {
+      return executeChromeTool({
+        scriptName: "browser-eval.js",
+        args: [context.args.code],
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+      });
+    }
+  });
+  chromeCli.command("screenshot", {
+    description: "Capture a screenshot of the active Chrome tab",
+    run: async () => {
+      return executeChromeTool({
+        scriptName: "browser-screenshot.js",
+        args: [],
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+      });
+    }
+  });
+  chromeCli.command("pick", {
+    description: "Interactively pick DOM elements in the active Chrome tab",
+    args: external_exports.object({
+      message: external_exports.string().min(1)
+    }),
+    run: async (context) => {
+      return executeChromeTool({
+        scriptName: "browser-pick.js",
+        args: [context.args.message],
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+      });
+    }
+  });
+  chromeCli.command("cookies", {
+    description: "Show cookies for the active Chrome tab",
+    run: async () => {
+      return executeChromeTool({
+        scriptName: "browser-cookies.js",
+        args: [],
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+      });
+    }
+  });
+  chromeCli.command("content", {
+    description: "Extract readable markdown content from a URL in Chrome",
+    args: external_exports.object({
+      url: external_exports.string().min(1)
+    }),
+    run: async (context) => {
+      return executeChromeTool({
+        scriptName: "browser-content.js",
+        args: [context.args.url],
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+      });
+    }
+  });
+  chromeCli.command("hn-scraper", {
+    description: "Scrape Hacker News submissions as JSON",
+    options: external_exports.object({
+      limit: external_exports.number().int().positive().optional().describe("Maximum number of submissions to return")
+    }),
+    run: async (context) => {
+      const args = [];
+      if (context.options.limit !== void 0) {
+        args.push("--limit", String(context.options.limit));
+      }
+      return executeChromeTool({
+        scriptName: "browser-hn-scraper.js",
+        args,
+        outputMode: "json",
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+      });
+    }
+  });
+  return chromeCli;
+}
+
 // src/services/inputReader.ts
 var import_promises2 = require("node:fs/promises");
-var import_node_path4 = require("node:path");
+var import_node_path5 = require("node:path");
 async function readStdinText() {
   if (process.stdin.isTTY) {
     return "";
@@ -125793,7 +126041,7 @@ async function readDataInput(params) {
         cause: error48
       });
     }
-    const extension = (0, import_node_path4.extname)(trimmedFromFile).toLowerCase();
+    const extension = (0, import_node_path5.extname)(trimmedFromFile).toLowerCase();
     if (extension === ".csv") {
       return parseCsvData(content, "--from-file");
     }
@@ -126591,7 +126839,7 @@ function createEnvCli(dependencies) {
 
 // src/services/studioPayload.ts
 var import_promises4 = require("node:fs/promises");
-var import_node_path5 = require("node:path");
+var import_node_path6 = require("node:path");
 async function readStdinText2() {
   if (process.stdin.isTTY) {
     return "";
@@ -126622,7 +126870,7 @@ async function readStudioWriteInput(params) {
     throw new UserInputError("Provide either --data or --from-file, not both.");
   }
   if (trimmedFromFile) {
-    const extension = (0, import_node_path5.extname)(trimmedFromFile).toLowerCase();
+    const extension = (0, import_node_path6.extname)(trimmedFromFile).toLowerCase();
     if (extension && extension !== ".json") {
       throw new UserInputError("Studio commands support only JSON files in --from-file.");
     }
@@ -127625,10 +127873,10 @@ function createStudioCli(dependencies) {
 }
 
 // src/commands/tuiCommand.ts
-var import_node_child_process2 = require("node:child_process");
-var import_node_fs3 = require("node:fs");
-var import_node_path6 = require("node:path");
-function summarizeFailure(result) {
+var import_node_child_process3 = require("node:child_process");
+var import_node_fs4 = require("node:fs");
+var import_node_path7 = require("node:path");
+function summarizeFailure2(result) {
   const stderr = result.stderr?.toString().trim();
   if (stderr && stderr.length > 0) {
     return stderr;
@@ -127644,23 +127892,23 @@ function summarizeFailure(result) {
 function resolveCliScriptPath() {
   const argvScript = process.argv[1];
   if (argvScript && argvScript.trim().length > 0) {
-    return (0, import_node_path6.isAbsolute)(argvScript) ? argvScript : (0, import_node_path6.resolve)(process.cwd(), argvScript);
+    return (0, import_node_path7.isAbsolute)(argvScript) ? argvScript : (0, import_node_path7.resolve)(process.cwd(), argvScript);
   }
   return __filename;
 }
 function resolveOpenTuiEntryPath(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
   const dirname6 = options2.dirname ?? __dirname;
-  const fileExists = options2.existsSyncFn ?? import_node_fs3.existsSync;
+  const fileExists = options2.existsSyncFn ?? import_node_fs4.existsSync;
   const candidates = [
     // Source/dev mode in monorepo. Prefer this first so Bun resolves deps via
     // apps/api-cli/node_modules in workspace runs (e.g. `pnpm docyrus tui`).
-    (0, import_node_path6.resolve)(cwd, "apps/api-cli/src/tui/opentuiMain.tsx"),
-    (0, import_node_path6.resolve)(dirname6, "../tui/opentuiMain.tsx"),
+    (0, import_node_path7.resolve)(cwd, "apps/api-cli/src/tui/opentuiMain.tsx"),
+    (0, import_node_path7.resolve)(dirname6, "../tui/opentuiMain.tsx"),
     // Dist mode (bundled command runtime)
-    (0, import_node_path6.resolve)(dirname6, "tui.mjs"),
-    (0, import_node_path6.resolve)(dirname6, "../tui.mjs"),
-    (0, import_node_path6.resolve)(cwd, "dist/apps/api-cli/tui.mjs")
+    (0, import_node_path7.resolve)(dirname6, "tui.mjs"),
+    (0, import_node_path7.resolve)(dirname6, "../tui.mjs"),
+    (0, import_node_path7.resolve)(cwd, "dist/apps/api-cli/tui.mjs")
   ];
   const resolved = candidates.find((candidate) => fileExists(candidate));
   if (!resolved) {
@@ -127671,7 +127919,7 @@ function resolveOpenTuiEntryPath(options2 = {}) {
   return resolved;
 }
 function ensureBunAvailable(options2 = {}) {
-  const spawnCommand = options2.spawnSyncFn ?? import_node_child_process2.spawnSync;
+  const spawnCommand = options2.spawnSyncFn ?? import_node_child_process3.spawnSync;
   const result = spawnCommand("bun", ["--version"], {
     encoding: "utf8"
   });
@@ -127685,7 +127933,7 @@ function ensureBunAvailable(options2 = {}) {
   }
 }
 function launchOpenTuiProcess(options2) {
-  const spawnCommand = options2.spawnSyncFn ?? import_node_child_process2.spawnSync;
+  const spawnCommand = options2.spawnSyncFn ?? import_node_child_process3.spawnSync;
   const result = spawnCommand("bun", [options2.entryPath], {
     stdio: ["inherit", "inherit", "pipe"],
     encoding: "utf8",
@@ -127701,7 +127949,7 @@ function launchOpenTuiProcess(options2) {
   }
   if (result.status !== 0) {
     throw new UserInputError(
-      `OpenTUI process failed: ${summarizeFailure(result)}`
+      `OpenTUI process failed: ${summarizeFailure2(result)}`
     );
   }
 }
@@ -128446,7 +128694,7 @@ var AuthSessionService = class {
 
 // src/services/authStore.ts
 var import_promises5 = require("node:fs/promises");
-var import_node_path7 = require("node:path");
+var import_node_path8 = require("node:path");
 function createEmptyState() {
   return {
     version: 2,
@@ -128521,7 +128769,7 @@ var AuthStore = class {
       });
     }
     const normalized = normalizeState(validated.data);
-    const directory = (0, import_node_path7.dirname)(this.authFilePath);
+    const directory = (0, import_node_path8.dirname)(this.authFilePath);
     await (0, import_promises5.mkdir)(directory, {
       recursive: true,
       mode: 448
@@ -128736,7 +128984,7 @@ var AuthStore = class {
 
 // src/services/environmentConfig.ts
 var import_promises6 = require("node:fs/promises");
-var import_node_path8 = require("node:path");
+var import_node_path9 = require("node:path");
 var ENVIRONMENT_ID_ALIASES = {
   "local-development": "dev",
   prod: "live"
@@ -128856,7 +129104,7 @@ var EnvironmentConfigService = class {
       });
     }
     const normalized = normalizeState2(validated.data);
-    const directory = (0, import_node_path8.dirname)(this.configFilePath);
+    const directory = (0, import_node_path9.dirname)(this.configFilePath);
     await (0, import_promises6.mkdir)(directory, {
       recursive: true,
       mode: 448
@@ -128932,10 +129180,10 @@ var EnvironmentConfigService = class {
 };
 
 // src/services/piAgentLauncher.ts
-var import_node_child_process3 = require("node:child_process");
-var import_node_fs4 = require("node:fs");
+var import_node_child_process4 = require("node:child_process");
+var import_node_fs5 = require("node:fs");
 var import_promises7 = require("node:fs/promises");
-var import_node_path9 = require("node:path");
+var import_node_path10 = require("node:path");
 var DOCYRUS_EXTERNAL_SKILL_SOURCE = "docyrus/agent-skills";
 var DOCYRUS_PACKAGED_PLATFORM_SKILL_NAME = "docyrus-platform";
 var DOCYRUS_MIGRATED_SKILL_NAMES = [
@@ -128953,7 +129201,7 @@ var DOCYRUS_EXTERNAL_SKILL_AGENT_IDS = [
   "windsurf"
 ];
 var DOCYRUS_EXTERNAL_SKILL_MARKER_FILE = ".docyrus-external-skills-installed.json";
-function summarizeFailure2(result) {
+function summarizeFailure3(result) {
   const stderr = result.stderr?.toString().trim();
   if (stderr && stderr.length > 0) {
     return stderr;
@@ -128969,12 +129217,12 @@ function summarizeFailure2(result) {
 function resolvePackagedPiResourceRoot(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
   const dirname6 = options2.dirname ?? __dirname;
-  const fileExists = options2.existsSyncFn ?? import_node_fs4.existsSync;
+  const fileExists = options2.existsSyncFn ?? import_node_fs5.existsSync;
   const candidates = [
-    (0, import_node_path9.resolve)(cwd, "apps/api-cli/resources/pi-agent"),
-    (0, import_node_path9.resolve)(dirname6, "../resources/pi-agent"),
-    (0, import_node_path9.resolve)(dirname6, "resources/pi-agent"),
-    (0, import_node_path9.resolve)(cwd, "dist/apps/api-cli/resources/pi-agent")
+    (0, import_node_path10.resolve)(cwd, "apps/api-cli/resources/pi-agent"),
+    (0, import_node_path10.resolve)(dirname6, "../resources/pi-agent"),
+    (0, import_node_path10.resolve)(dirname6, "resources/pi-agent"),
+    (0, import_node_path10.resolve)(cwd, "dist/apps/api-cli/resources/pi-agent")
   ];
   const resolved = candidates.find((candidate) => fileExists(candidate));
   if (!resolved) {
@@ -128985,7 +129233,7 @@ function resolvePackagedPiResourceRoot(options2 = {}) {
 function resolveDocyrusPiLoaderEntryPath(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
   const dirname6 = options2.dirname ?? __dirname;
-  const fileExists = options2.existsSyncFn ?? import_node_fs4.existsSync;
+  const fileExists = options2.existsSyncFn ?? import_node_fs5.existsSync;
   const seen = /* @__PURE__ */ new Set();
   const candidates = options2.candidatePaths ?? [];
   const addCandidate = (candidate) => {
@@ -128995,23 +129243,23 @@ function resolveDocyrusPiLoaderEntryPath(options2 = {}) {
     }
   };
   const collectAncestorCandidates = (startDir) => {
-    let currentDir = (0, import_node_path9.resolve)(startDir);
+    let currentDir = (0, import_node_path10.resolve)(startDir);
     while (true) {
-      addCandidate((0, import_node_path9.join)(currentDir, "dist", "apps", "api-cli", "agent-loader.js"));
-      addCandidate((0, import_node_path9.join)(currentDir, "agent-loader.js"));
-      if ((0, import_node_path9.basename)(currentDir) === "dist") {
-        addCandidate((0, import_node_path9.join)(currentDir, "apps", "api-cli", "agent-loader.js"));
+      addCandidate((0, import_node_path10.join)(currentDir, "dist", "apps", "api-cli", "agent-loader.js"));
+      addCandidate((0, import_node_path10.join)(currentDir, "agent-loader.js"));
+      if ((0, import_node_path10.basename)(currentDir) === "dist") {
+        addCandidate((0, import_node_path10.join)(currentDir, "apps", "api-cli", "agent-loader.js"));
       }
-      const parentDir = (0, import_node_path9.resolve)(currentDir, "..");
+      const parentDir = (0, import_node_path10.resolve)(currentDir, "..");
       if (parentDir === currentDir) {
         break;
       }
       currentDir = parentDir;
     }
   };
-  addCandidate((0, import_node_path9.resolve)(cwd, "dist/apps/api-cli/agent-loader.js"));
-  addCandidate((0, import_node_path9.resolve)(dirname6, "../agent-loader.js"));
-  addCandidate((0, import_node_path9.resolve)(dirname6, "agent-loader.js"));
+  addCandidate((0, import_node_path10.resolve)(cwd, "dist/apps/api-cli/agent-loader.js"));
+  addCandidate((0, import_node_path10.resolve)(dirname6, "../agent-loader.js"));
+  addCandidate((0, import_node_path10.resolve)(dirname6, "agent-loader.js"));
   collectAncestorCandidates(cwd);
   collectAncestorCandidates(dirname6);
   const resolved = candidates.find((candidate) => fileExists(candidate));
@@ -129023,7 +129271,7 @@ function resolveDocyrusPiLoaderEntryPath(options2 = {}) {
 function resolveInstalledPiPackageRootPath(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
   const dirname6 = options2.dirname ?? __dirname;
-  const fileExists = options2.existsSyncFn ?? import_node_fs4.existsSync;
+  const fileExists = options2.existsSyncFn ?? import_node_fs5.existsSync;
   const seen = /* @__PURE__ */ new Set();
   const candidates = options2.candidatePaths ?? [];
   const addCandidate = (candidate) => {
@@ -129033,27 +129281,27 @@ function resolveInstalledPiPackageRootPath(options2 = {}) {
     }
   };
   const collectAncestorCandidates = (startDir) => {
-    let currentDir = (0, import_node_path9.resolve)(startDir);
+    let currentDir = (0, import_node_path10.resolve)(startDir);
     while (true) {
-      addCandidate((0, import_node_path9.join)(currentDir, "node_modules", "@mariozechner", "pi-coding-agent", "package.json"));
-      if ((0, import_node_path9.basename)(currentDir) === "node_modules") {
-        addCandidate((0, import_node_path9.join)(currentDir, "@mariozechner", "pi-coding-agent", "package.json"));
+      addCandidate((0, import_node_path10.join)(currentDir, "node_modules", "@mariozechner", "pi-coding-agent", "package.json"));
+      if ((0, import_node_path10.basename)(currentDir) === "node_modules") {
+        addCandidate((0, import_node_path10.join)(currentDir, "@mariozechner", "pi-coding-agent", "package.json"));
       }
-      const parentDir = (0, import_node_path9.resolve)(currentDir, "..");
+      const parentDir = (0, import_node_path10.resolve)(currentDir, "..");
       if (parentDir === currentDir) {
         break;
       }
       currentDir = parentDir;
     }
   };
-  addCandidate((0, import_node_path9.resolve)(cwd, "apps/api-cli/node_modules/@mariozechner/pi-coding-agent/package.json"));
+  addCandidate((0, import_node_path10.resolve)(cwd, "apps/api-cli/node_modules/@mariozechner/pi-coding-agent/package.json"));
   collectAncestorCandidates(cwd);
   collectAncestorCandidates(dirname6);
   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_path9.resolve)(resolvedPackageJson, "..");
+  return (0, import_node_path10.resolve)(resolvedPackageJson, "..");
 }
 function createPiAgentRuntimeSkill(params) {
   const commandPrefix = params.scope === "global" ? "docyrus -g" : "docyrus";
@@ -129100,8 +129348,8 @@ function createPiAgentRuntimeSkill(params) {
   ].join("\n");
 }
 async function syncPackagedSkills(params) {
-  const sourceSkillsRoot = (0, import_node_path9.join)(params.resourceRoot, "skills");
-  const targetSkillsRoot = (0, import_node_path9.join)(params.agentRootPath, "skills");
+  const sourceSkillsRoot = (0, import_node_path10.join)(params.resourceRoot, "skills");
+  const targetSkillsRoot = (0, import_node_path10.join)(params.agentRootPath, "skills");
   await (0, import_promises7.mkdir)(targetSkillsRoot, {
     recursive: true,
     mode: 448
@@ -129110,25 +129358,25 @@ async function syncPackagedSkills(params) {
     withFileTypes: true
   });
   await Promise.all(DOCYRUS_MIGRATED_SKILL_NAMES.map(async (skillName) => {
-    await (0, import_promises7.rm)((0, import_node_path9.join)(targetSkillsRoot, skillName), {
+    await (0, import_promises7.rm)((0, import_node_path10.join)(targetSkillsRoot, skillName), {
       recursive: true,
       force: true
     });
   }));
   await Promise.all(entries.map(async (entry) => {
-    await (0, import_promises7.cp)((0, import_node_path9.join)(sourceSkillsRoot, entry.name), (0, import_node_path9.join)(targetSkillsRoot, entry.name), {
+    await (0, import_promises7.cp)((0, import_node_path10.join)(sourceSkillsRoot, entry.name), (0, import_node_path10.join)(targetSkillsRoot, entry.name), {
       recursive: true,
       force: true
     });
   }));
 }
 async function writeRuntimeSkill(params) {
-  const runtimeSkillDir = (0, import_node_path9.join)(params.agentRootPath, "skills", "docyrus-runtime-context");
+  const runtimeSkillDir = (0, import_node_path10.join)(params.agentRootPath, "skills", "docyrus-runtime-context");
   await (0, import_promises7.mkdir)(runtimeSkillDir, {
     recursive: true,
     mode: 448
   });
-  await (0, import_promises7.writeFile)((0, import_node_path9.join)(runtimeSkillDir, "SKILL.md"), `${params.content}
+  await (0, import_promises7.writeFile)((0, import_node_path10.join)(runtimeSkillDir, "SKILL.md"), `${params.content}
 `, {
     encoding: "utf8",
     mode: 384
@@ -129173,8 +129421,8 @@ function createPackagedDocyrusPlatformInstallArgs(params) {
   return args;
 }
 async function installExternalDocyrusSkillsOnce(params) {
-  const markerPath = (0, import_node_path9.join)(params.agentRootPath, DOCYRUS_EXTERNAL_SKILL_MARKER_FILE);
-  if ((0, import_node_fs4.existsSync)(markerPath)) {
+  const markerPath = (0, import_node_path10.join)(params.agentRootPath, DOCYRUS_EXTERNAL_SKILL_MARKER_FILE);
+  if ((0, import_node_fs5.existsSync)(markerPath)) {
     return;
   }
   const result = params.spawnCommand(resolveNpxCommand(), createDocyrusSkillsInstallArgs(params.scope), {
@@ -129187,7 +129435,7 @@ async function installExternalDocyrusSkillsOnce(params) {
   });
   if (result.error || result.status !== 0) {
     process.stderr.write(
-      `[docyrus] Automatic Docyrus skill install failed. Continuing without it: ${result.error?.message || summarizeFailure2(result)}
+      `[docyrus] Automatic Docyrus skill install failed. Continuing without it: ${result.error?.message || summarizeFailure3(result)}
 `
     );
     return;
@@ -129205,11 +129453,11 @@ async function installExternalDocyrusSkillsOnce(params) {
   });
 }
 function resolvePackagedDocyrusPlatformSkillPath(resourceRoot) {
-  return (0, import_node_path9.join)(resourceRoot, "skills", DOCYRUS_PACKAGED_PLATFORM_SKILL_NAME);
+  return (0, import_node_path10.join)(resourceRoot, "skills", DOCYRUS_PACKAGED_PLATFORM_SKILL_NAME);
 }
 function installPackagedDocyrusPlatformSkill(params) {
   const skillSourcePath = resolvePackagedDocyrusPlatformSkillPath(params.resourceRoot);
-  if (!(0, import_node_fs4.existsSync)(skillSourcePath)) {
+  if (!(0, import_node_fs5.existsSync)(skillSourcePath)) {
     process.stderr.write("[docyrus] Packaged docyrus-platform skill is missing. Continuing without agent sync.\n");
     return;
   }
@@ -129230,7 +129478,7 @@ function installPackagedDocyrusPlatformSkill(params) {
   );
   if (result.error || result.status !== 0) {
     process.stderr.write(
-      `[docyrus] Automatic docyrus-platform skill sync failed. Continuing without it: ${result.error?.message || summarizeFailure2(result)}
+      `[docyrus] Automatic docyrus-platform skill sync failed. Continuing without it: ${result.error?.message || summarizeFailure3(result)}
 `
     );
   }
@@ -129246,7 +129494,7 @@ function validatePiAgentLaunchRequest(params) {
 function createPiAgentLauncher(options2) {
   const cwd = options2.cwd ?? process.cwd();
   const stdinIsTTY = options2.stdinIsTTY ?? process.stdin.isTTY ?? false;
-  const spawnCommand = options2.spawnSyncFn ?? import_node_child_process3.spawnSync;
+  const spawnCommand = options2.spawnSyncFn ?? import_node_child_process4.spawnSync;
   const processExecPath = options2.processExecPath ?? process.execPath;
   const resolveResourceRoot = options2.resolvePackagedPiResourceRootFn ?? resolvePackagedPiResourceRoot;
   const resolveLoaderPath = options2.resolveDocyrusPiLoaderEntryPathFn ?? resolveDocyrusPiLoaderEntryPath;
@@ -129307,14 +129555,14 @@ function createPiAgentLauncher(options2) {
       });
     }
     if (result.status !== 0) {
-      throw new UserInputError(`Docyrus pi loader failed: ${summarizeFailure2(result)}`);
+      throw new UserInputError(`Docyrus pi loader failed: ${summarizeFailure3(result)}`);
     }
   };
 }
 
 // src/services/tenantOpenApi.ts
 var import_promises8 = require("node:fs/promises");
-var import_node_path10 = require("node:path");
+var import_node_path11 = require("node:path");
 function resolveSourceUrl(tenantId, template) {
   return template.replace("{tenantId}", encodeURIComponent(tenantId));
 }
@@ -129338,7 +129586,7 @@ var TenantOpenApiService = class {
   }
   async #writeOpenApiFile(tenantId, parsedContent) {
     const filePath = this.getTenantOpenApiFilePath(tenantId);
-    await (0, import_promises8.mkdir)((0, import_node_path10.dirname)(filePath), {
+    await (0, import_promises8.mkdir)((0, import_node_path11.dirname)(filePath), {
       recursive: true,
       mode: 448
     });
@@ -129384,7 +129632,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_path10.join)(rootPath, normalizedTenantId, "openapi.json");
+    return (0, import_node_path11.join)(rootPath, normalizedTenantId, "openapi.json");
   }
   async downloadTenantOpenApi(tenantId, options2 = {}) {
     const normalizedTenantId = tenantId.trim();
@@ -129447,6 +129695,9 @@ var ROOT_HELP_COMMANDS = [
   { command: 'ai "<prompt>"', description: "Send a prompt to the default Docyrus CLI agent" },
   { command: "agent [prompt]", description: "Launch the scoped Docyrus pi assistant" },
   { command: "coder [prompt]", description: "Launch the scoped Docyrus pi coding agent" },
+  { command: "chrome start", description: "Launch Chrome with remote debugging on :9222" },
+  { command: "chrome nav <url>", description: "Navigate the active Chrome tab" },
+  { command: "chrome content <url>", description: "Extract readable page content as markdown" },
   { command: "discover api", description: "Download active tenant OpenAPI spec" },
   { command: "discover namespaces", description: "List namespaces from tenant OpenAPI spec" },
   { command: "discover path <prefix>", description: "List endpoint paths by prefix" },
@@ -129537,6 +129788,9 @@ function createDocyrusCli(params) {
   cli2.command(createCoderCli({
     launchPiAgent: piAgentLauncher
   }));
+  cli2.command(createChromeCli({
+    cwd: params?.cwd
+  }));
   cli2.command(createDsCli({
     createApiClient,
     environmentConfigService,