@docyrus/docyrus 0.0.19 → 0.0.21

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.19",
+  version: "0.0.21",
   private: false,
   description: "Docyrus API CLI",
   main: "./main.js",
@@ -124686,17 +124686,27 @@ var package_default = {
     docyrus: "main.js"
   },
   dependencies: {
+    "@mozilla/readability": "^0.6.0",
     "@clack/prompts": "^0.11.0",
-    "@mariozechner/pi-ai": "0.60.0",
-    "@mariozechner/pi-coding-agent": "0.60.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",
     "@opentui/core": "^0.1.85",
     "@opentui/react": "^0.1.85",
+    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",
     picocolors: "^1.1.1",
+    "puppeteer-core": "^24.31.0",
     react: "^19.1.1",
-    undici: "^7.16.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 +125698,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 +126038,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");
     }
@@ -125956,6 +126201,20 @@ var BULK_OPERATION_LIMIT = 50;
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function normalizeOptionalString(value) {
+  const trimmed = value?.trim();
+  return trimmed && trimmed.length > 0 ? trimmed : void 0;
+}
+function normalizeJsonLikeQueryValue(value, flag) {
+  const trimmed = normalizeOptionalString(value);
+  if (!trimmed) {
+    return void 0;
+  }
+  if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+    return JSON.stringify(parseJsonData(trimmed, flag));
+  }
+  return trimmed;
+}
 function toBulkPayload(payload, mode) {
   if (!Array.isArray(payload)) {
     return null;
@@ -126004,7 +126263,10 @@ function createDsCli(dependencies) {
       const apiClient = dependencies.createApiClient(apiBaseUrl);
       const response = await apiClient.request({
         method: "GET",
-        path: `/apps/${context.args.appSlug}/data-sources/${context.args.dataSourceSlug}`
+        path: `/apps/${context.args.appSlug}/data-sources/${context.args.dataSourceSlug}`,
+        query: {
+          expand: "fields"
+        }
       });
       return await injectContext({
         apiBaseUrl,
@@ -126020,31 +126282,44 @@ function createDsCli(dependencies) {
       dataSourceSlug: external_exports.string().min(1)
     }),
     options: external_exports.object({
-      columns: external_exports.string().optional(),
-      filters: external_exports.string().optional(),
+      collapseRows: external_exports.boolean().optional().describe("Collapse rows into a single aggregated array"),
+      columns: external_exports.string().optional().describe("Columns to select; comma-separated or JSON array"),
+      distinctColumns: external_exports.string().optional().describe("Distinct columns; comma-separated or JSON array"),
+      formulas: external_exports.string().optional().describe("JSON formulas object"),
+      calculations: external_exports.string().optional().describe("JSON calculations array"),
+      filters: external_exports.string().optional().describe("JSON filter group"),
+      filterKeyword: external_exports.string().optional().describe("Keyword filter"),
       limit: external_exports.number().optional(),
       offset: external_exports.number().optional(),
-      orderBy: external_exports.string().optional(),
-      fullCount: external_exports.boolean().optional()
+      orderBy: external_exports.string().optional().describe("Sort order string or JSON object/array"),
+      groupSummaries: external_exports.boolean().optional().describe("Return per-group summaries when calculations are used"),
+      fullCount: external_exports.boolean().optional(),
+      expand: external_exports.string().optional().describe("Expand columns; comma-separated or JSON array"),
+      pivot: external_exports.string().optional().describe("JSON pivot configuration"),
+      childQueries: external_exports.string().optional().describe("JSON child query array")
     }),
     run: async (context) => {
       const apiBaseUrl = await dependencies.environmentConfigService.getActiveApiBaseUrl();
       const apiClient = dependencies.createApiClient(apiBaseUrl);
-      let serializedFilters;
-      if (context.options.filters) {
-        const parsedFilters = parseJsonData(context.options.filters, "--filters");
-        serializedFilters = JSON.stringify(parsedFilters);
-      }
       const response = await apiClient.request({
         method: "GET",
         path: `/apps/${context.args.appSlug}/data-sources/${context.args.dataSourceSlug}/items`,
         query: {
-          columns: context.options.columns,
-          filters: serializedFilters,
+          collapseRows: context.options.collapseRows,
+          columns: normalizeJsonLikeQueryValue(context.options.columns, "--columns"),
+          distinctColumns: normalizeJsonLikeQueryValue(context.options.distinctColumns, "--distinctColumns"),
+          formulas: normalizeJsonLikeQueryValue(context.options.formulas, "--formulas"),
+          calculations: normalizeJsonLikeQueryValue(context.options.calculations, "--calculations"),
+          filters: normalizeJsonLikeQueryValue(context.options.filters, "--filters"),
+          filterKeyword: normalizeOptionalString(context.options.filterKeyword),
           limit: context.options.limit,
           offset: context.options.offset,
-          orderBy: context.options.orderBy,
-          fullCount: context.options.fullCount
+          orderBy: normalizeJsonLikeQueryValue(context.options.orderBy, "--orderBy"),
+          groupSummaries: context.options.groupSummaries,
+          fullCount: context.options.fullCount,
+          expand: normalizeJsonLikeQueryValue(context.options.expand, "--expand"),
+          pivot: normalizeJsonLikeQueryValue(context.options.pivot, "--pivot"),
+          childQueries: normalizeJsonLikeQueryValue(context.options.childQueries, "--childQueries")
         }
       });
       return await injectContext({
@@ -126561,7 +126836,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 "";
@@ -126592,7 +126867,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.");
     }
@@ -126920,25 +127195,13 @@ function createStudioCli(dependencies) {
   studioCli.command("get-data-source", {
     description: "Get a single data source",
     options: external_exports.object({
-      appId: external_exports.string().optional().describe("App ID"),
-      appSlug: external_exports.string().optional().describe("App slug"),
-      dataSourceId: external_exports.string().optional().describe("Data source ID"),
-      dataSourceSlug: external_exports.string().optional().describe("Data source slug")
+      dataSourceId: external_exports.string().min(1).describe("Data source ID")
     }),
     run: async (context) => {
       const studio = await getStudioRunContext(dependencies);
-      const appId = await studio.resolver.resolveAppId({
-        appId: context.options.appId,
-        appSlug: context.options.appSlug
-      });
-      const dataSourceId = await studio.resolver.resolveDataSourceId({
-        appId,
-        dataSourceId: context.options.dataSourceId,
-        dataSourceSlug: context.options.dataSourceSlug
-      });
       const response = await studio.apiClient.request({
         method: "GET",
-        path: `/dev/apps/${appId}/data-sources/${dataSourceId}`
+        path: `/dev/data-sources/${context.options.dataSourceId}`
       });
       return await wrapStudioPayload(studio.apiBaseUrl, dependencies, response.data);
     }
@@ -127607,10 +127870,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;
@@ -127626,23 +127889,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) {
@@ -127653,7 +127916,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"
   });
@@ -127667,7 +127930,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",
@@ -127683,7 +127946,7 @@ function launchOpenTuiProcess(options2) {
   }
   if (result.status !== 0) {
     throw new UserInputError(
-      `OpenTUI process failed: ${summarizeFailure(result)}`
+      `OpenTUI process failed: ${summarizeFailure2(result)}`
     );
   }
 }
@@ -128428,7 +128691,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,
@@ -128503,7 +128766,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
@@ -128718,7 +128981,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"
@@ -128838,7 +129101,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
@@ -128914,11 +129177,28 @@ 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");
-function summarizeFailure2(result) {
+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 = [
+  "docyrus-app-dev",
+  "docyrus-api-dev",
+  "docyrus-cli-app"
+];
+var DOCYRUS_EXTERNAL_SKILL_AGENT_IDS = [
+  "pi",
+  "claude-code",
+  "codex",
+  "github-copilot",
+  "gemini-cli",
+  "antigravity",
+  "windsurf"
+];
+var DOCYRUS_EXTERNAL_SKILL_MARKER_FILE = ".docyrus-external-skills-installed.json";
+function summarizeFailure3(result) {
   const stderr = result.stderr?.toString().trim();
   if (stderr && stderr.length > 0) {
     return stderr;
@@ -128934,12 +129214,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) {
@@ -128950,7 +129230,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) => {
@@ -128960,23 +129240,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));
@@ -128988,7 +129268,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) => {
@@ -128998,27 +129278,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";
@@ -129065,8 +129345,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
@@ -129074,25 +129354,132 @@ async function syncPackagedSkills(params) {
   const entries = await (0, import_promises7.readdir)(sourceSkillsRoot, {
     withFileTypes: true
   });
+  await Promise.all(DOCYRUS_MIGRATED_SKILL_NAMES.map(async (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
+  });
+}
+function resolveNpxCommand() {
+  return process.platform === "win32" ? "npx.cmd" : "npx";
+}
+function createDocyrusSkillsInstallArgs(scope) {
+  const args = [
+    "skills",
+    "add",
+    DOCYRUS_EXTERNAL_SKILL_SOURCE
+  ];
+  if (scope === "global") {
+    args.push("--global");
+  }
+  args.push(
+    "--skill",
+    ...DOCYRUS_MIGRATED_SKILL_NAMES,
+    "--agent",
+    ...DOCYRUS_EXTERNAL_SKILL_AGENT_IDS,
+    "--yes"
+  );
+  return args;
+}
+function createPackagedDocyrusPlatformInstallArgs(params) {
+  const args = [
+    "skills",
+    "add",
+    params.skillSourcePath
+  ];
+  if (params.scope === "global") {
+    args.push("--global");
+  }
+  args.push(
+    "--agent",
+    ...DOCYRUS_EXTERNAL_SKILL_AGENT_IDS,
+    "--copy",
+    "--yes"
+  );
+  return args;
+}
+async function installExternalDocyrusSkillsOnce(params) {
+  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), {
+    stdio: ["ignore", "pipe", "pipe"],
+    encoding: "utf8",
+    cwd: params.cwd,
+    env: {
+      ...process.env
+    }
+  });
+  if (result.error || result.status !== 0) {
+    process.stderr.write(
+      `[docyrus] Automatic Docyrus skill install failed. Continuing without it: ${result.error?.message || summarizeFailure3(result)}
+`
+    );
+    return;
+  }
+  await (0, import_promises7.writeFile)(markerPath, `${JSON.stringify({
+    source: DOCYRUS_EXTERNAL_SKILL_SOURCE,
+    skills: DOCYRUS_MIGRATED_SKILL_NAMES,
+    agents: DOCYRUS_EXTERNAL_SKILL_AGENT_IDS,
+    scope: params.scope,
+    installedAt: (/* @__PURE__ */ new Date()).toISOString()
+  }, null, 2)}
 `, {
     encoding: "utf8",
     mode: 384
   });
 }
+function resolvePackagedDocyrusPlatformSkillPath(resourceRoot) {
+  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_fs5.existsSync)(skillSourcePath)) {
+    process.stderr.write("[docyrus] Packaged docyrus-platform skill is missing. Continuing without agent sync.\n");
+    return;
+  }
+  const result = params.spawnCommand(
+    resolveNpxCommand(),
+    createPackagedDocyrusPlatformInstallArgs({
+      scope: params.scope,
+      skillSourcePath
+    }),
+    {
+      stdio: ["ignore", "pipe", "pipe"],
+      encoding: "utf8",
+      cwd: params.cwd,
+      env: {
+        ...process.env
+      }
+    }
+  );
+  if (result.error || result.status !== 0) {
+    process.stderr.write(
+      `[docyrus] Automatic docyrus-platform skill sync failed. Continuing without it: ${result.error?.message || summarizeFailure3(result)}
+`
+    );
+  }
+}
 function validatePiAgentLaunchRequest(params) {
   if (params.request.mode && !params.request.print && params.stdinIsTTY) {
     throw new UserInputError("`--mode` requires `--print` when stdin is interactive.");
@@ -129104,7 +129491,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;
@@ -129133,6 +129520,18 @@ function createPiAgentLauncher(options2) {
         settingsRootPath
       })
     });
+    await installExternalDocyrusSkillsOnce({
+      agentRootPath,
+      cwd,
+      scope: options2.settingsPaths.scope,
+      spawnCommand
+    });
+    installPackagedDocyrusPlatformSkill({
+      resourceRoot,
+      cwd,
+      scope: options2.settingsPaths.scope,
+      spawnCommand
+    });
     const loaderEntryPath = resolveLoaderPath({ cwd });
     const piPackageRoot = resolvePiPackageRoot({ cwd });
     const result = spawnCommand(processExecPath, [loaderEntryPath], {
@@ -129153,14 +129552,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));
 }
@@ -129184,7 +129583,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
     });
@@ -129230,7 +129629,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();
@@ -129293,6 +129692,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" },
@@ -129383,6 +129785,9 @@ function createDocyrusCli(params) {
   cli2.command(createCoderCli({
     launchPiAgent: piAgentLauncher
   }));
+  cli2.command(createChromeCli({
+    cwd: params?.cwd
+  }));
   cli2.command(createDsCli({
     createApiClient,
     environmentConfigService,