@docyrus/docyrus 0.0.56 → 0.0.58

package/main.js

@@ -139349,7 +139349,7 @@ function buildInputSchema(args2, env2, options2) {
 // package.json
 var package_default = {
   name: "@docyrus/docyrus",
-  version: "0.0.56",
+  version: "0.0.58",
   private: false,
   description: "Docyrus API CLI",
   main: "./main.js",
@@ -139372,8 +139372,8 @@ var package_default = {
     "@repomix/tree-sitter-wasms": "^0.1.16",
     "@sinclair/typebox": "^0.34.48",
     "@xterm/headless": "^5.5.0",
-    diff: "^8.0.4",
-    hono: "^4.12.12",
+    diff: "^9.0.0",
+    hono: "^4.12.14",
     "ignore-walk": "^8.0.0",
     incur: "^0.1.6",
     jsdom: "^29.0.1",
@@ -139866,7 +139866,8 @@ function createServerCli(dependencies) {
       sessionDir: external_exports.string().optional().describe("Override session storage directory"),
       apiKey: external_exports.string().optional().describe("Temporary provider API key override for this run"),
       auth: external_exports.string().optional().describe("Require this bearer token for all HTTP requests"),
-      verbose: external_exports.boolean().optional().describe("Enable verbose pi startup output")
+      verbose: external_exports.boolean().optional().describe("Enable verbose pi startup output"),
+      sandbox: external_exports.boolean().optional().describe("Enable sandbox browser mode (remote Cloudflare Browser Rendering)")
     }),
     run: async (context) => {
       await dependencies.launchPiAgentServer({
@@ -139878,7 +139879,8 @@ function createServerCli(dependencies) {
         sessionDir: context.options.sessionDir,
         apiKey: context.options.apiKey,
         auth: context.options.auth,
-        verbose: context.options.verbose || hasRawVerboseFlag2() ? true : void 0
+        verbose: context.options.verbose || hasRawVerboseFlag2() ? true : void 0,
+        sandbox: context.options.sandbox
       });
     }
   });
@@ -140668,6 +140670,38 @@ function createAuthCli(dependencies) {
       });
     }
   });
+  authCli.command("sso-session", {
+    description: "Create a short-lived SSO session token for headless browser authentication",
+    options: external_exports.object({
+      clientId: external_exports.string().min(1).describe("Target app's OAuth2 client ID"),
+      scope: external_exports.string().default(DEFAULT_LOGIN_SCOPES).describe("OAuth2 scopes for the SSO session"),
+      targetOrigin: external_exports.string().optional().describe("Restrict token exchange to this origin")
+    }),
+    run: async (context) => {
+      const apiBaseUrl = await dependencies.environmentConfigService.getActiveApiBaseUrl();
+      const apiClient = dependencies.createApiClient(apiBaseUrl);
+      const response = await apiClient.request({
+        method: "POST",
+        path: "/oauth2/sso/session",
+        body: {
+          client_id: context.options.clientId,
+          scope: context.options.scope,
+          target_origin: context.options.targetOrigin
+        }
+      });
+      const ssoToken = response.data.sso_token;
+      const targetOrigin = context.options.targetOrigin;
+      return await injectContext({
+        apiBaseUrl,
+        authStore: dependencies.authStore,
+        payload: {
+          sso_token: ssoToken,
+          expires_in: response.data.expires_in,
+          url: targetOrigin ? `${targetOrigin}?sso_token=${ssoToken}` : void 0
+        }
+      });
+    }
+  });
   authCli.command("github", {
     description: "Regenerate the GitHub token and inject it into the active sandbox",
     options: external_exports.object({
@@ -140702,7 +140736,7 @@ function createAuthCli(dependencies) {
   return authCli;
 }
 
-// src/commands/chromeCommands.ts
+// src/commands/browserCommands.ts
 var import_node_child_process3 = require("node:child_process");
 var import_node_fs3 = require("node:fs");
 var import_node_path4 = require("node:path");
@@ -140712,33 +140746,33 @@ function summarizeFailure(result) {
     return stderr;
   }
   if (typeof result.status === "number") {
-    return `Chrome tool exited with code ${result.status}.`;
+    return `Browser tool exited with code ${result.status}.`;
   }
   if (result.signal) {
-    return `Chrome tool exited due to signal ${result.signal}.`;
+    return `Browser tool exited due to signal ${result.signal}.`;
   }
-  return "Chrome tool terminated unexpectedly.";
+  return "Browser tool terminated unexpectedly.";
 }
-function resolveChromeToolsResourceRoot(options2 = {}) {
+function resolveBrowserToolsResourceRoot(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
   const dirname13 = 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)(dirname13, "../resources/chrome-tools"),
-    (0, import_node_path4.resolve)(dirname13, "resources/chrome-tools"),
-    (0, import_node_path4.resolve)(cwd, "dist/apps/api-cli/resources/chrome-tools")
+    (0, import_node_path4.resolve)(cwd, "apps/api-cli/resources/browser-tools"),
+    (0, import_node_path4.resolve)(dirname13, "../resources/browser-tools"),
+    (0, import_node_path4.resolve)(dirname13, "resources/browser-tools"),
+    (0, import_node_path4.resolve)(cwd, "dist/apps/api-cli/resources/browser-tools")
   ];
   const resolved = candidates.find((candidate) => fileExists(candidate));
   if (!resolved) {
-    throw new UserInputError(`Unable to locate chrome tool resources. Checked: ${candidates.join(", ")}`);
+    throw new UserInputError(`Unable to locate browser tool resources. Checked: ${candidates.join(", ")}`);
   }
   return resolved;
 }
-function resolveChromeToolScriptPath(params) {
+function resolveBrowserToolScriptPath(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}`);
+    throw new UserInputError(`Missing browser tool script: ${scriptPath}`);
   }
   return scriptPath;
 }
@@ -140753,18 +140787,18 @@ function parseJsonOutput(rawOutput) {
   try {
     return JSON.parse(trimmedOutput);
   } catch (error48) {
-    throw new UserInputError("Chrome tool returned invalid JSON output.", {
+    throw new UserInputError("Browser tool returned invalid JSON output.", {
       cause: error48,
       rawOutput: trimmedOutput
     });
   }
 }
-function executeChromeTool(params) {
-  const resolveResourceRoot = params.resolveChromeToolsResourceRootFn ?? resolveChromeToolsResourceRoot;
+function executeBrowserTool(params) {
+  const resolveResourceRoot = params.resolveBrowserToolsResourceRootFn ?? resolveBrowserToolsResourceRoot;
   const resourceRoot = resolveResourceRoot({
     cwd: params.cwd
   });
-  const scriptPath = resolveChromeToolScriptPath({
+  const scriptPath = resolveBrowserToolScriptPath({
     resourceRoot,
     scriptName: params.scriptName
   });
@@ -140778,12 +140812,12 @@ function executeChromeTool(params) {
     }
   });
   if (result.error) {
-    throw new UserInputError(`Unable to start chrome tool '${params.scriptName}': ${result.error.message}`, {
+    throw new UserInputError(`Unable to start browser tool '${params.scriptName}': ${result.error.message}`, {
       cause: result.error
     });
   }
   if (result.status !== 0) {
-    throw new UserInputError(`Chrome tool '${params.scriptName}' failed: ${summarizeFailure(result)}`);
+    throw new UserInputError(`Browser tool '${params.scriptName}' failed: ${summarizeFailure(result)}`);
   }
   const stdout = result.stdout?.toString() || "";
   if (params.outputMode === "json") {
@@ -140791,29 +140825,30 @@ function executeChromeTool(params) {
   }
   return parseTextOutput(stdout);
 }
-function createChromeCli(options2 = {}) {
-  const chromeCli = Cli_exports.create("chrome", {
-    description: "Chrome DevTools browser automation commands",
+function createBrowserCli(options2 = {}) {
+  const browserCli = Cli_exports.create("browser", {
+    description: "Browser automation commands (local Chrome or remote Cloudflare)",
     env: EnvSchema
   });
-  chromeCli.command("start", {
-    description: "Launch Chrome with remote debugging on :9222",
+  browserCli.command("start", {
+    description: "Start a browser session (local Chrome or remote Cloudflare)",
     options: external_exports.object({
-      profile: external_exports.boolean().optional().describe("Copy your default Chrome profile (cookies, logins)")
+      profile: external_exports.boolean().optional().describe("Copy your default Chrome profile (cookies, logins) \u2014 local mode only")
     }),
     run: async (context) => {
-      return executeChromeTool({
+      return executeBrowserTool({
         scriptName: "browser-start.js",
         args: context.options.profile ? ["--profile"] : [],
+        outputMode: "json",
         cwd: options2.cwd,
         processExecPath: options2.processExecPath,
         spawnSyncFn: options2.spawnSyncFn,
-        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
       });
     }
   });
-  chromeCli.command("nav", {
-    description: "Navigate the current Chrome tab or open a URL in a new tab",
+  browserCli.command("nav", {
+    description: "Navigate the active tab or open a URL in a new tab",
     args: external_exports.object({
       url: external_exports.string().min(1)
     }),
@@ -140829,112 +140864,128 @@ function createChromeCli(options2 = {}) {
       if (context.options.reload) {
         args2.push("--reload");
       }
-      return executeChromeTool({
+      return executeBrowserTool({
         scriptName: "browser-nav.js",
         args: args2,
+        outputMode: "json",
         cwd: options2.cwd,
         processExecPath: options2.processExecPath,
         spawnSyncFn: options2.spawnSyncFn,
-        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
       });
     }
   });
-  chromeCli.command("eval", {
-    description: "Evaluate JavaScript in the active Chrome tab",
+  browserCli.command("eval", {
+    description: "Evaluate JavaScript in the active browser tab",
     args: external_exports.object({
       code: external_exports.string().min(1)
     }),
     run: async (context) => {
-      return executeChromeTool({
+      return executeBrowserTool({
         scriptName: "browser-eval.js",
         args: [context.args.code],
+        outputMode: "json",
         cwd: options2.cwd,
         processExecPath: options2.processExecPath,
         spawnSyncFn: options2.spawnSyncFn,
-        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
       });
     }
   });
-  chromeCli.command("screenshot", {
-    description: "Capture a screenshot of the active Chrome tab",
+  browserCli.command("screenshot", {
+    description: "Capture a screenshot of the active browser tab",
     run: async () => {
-      return executeChromeTool({
+      return executeBrowserTool({
         scriptName: "browser-screenshot.js",
         args: [],
+        outputMode: "json",
         cwd: options2.cwd,
         processExecPath: options2.processExecPath,
         spawnSyncFn: options2.spawnSyncFn,
-        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
       });
     }
   });
-  chromeCli.command("pick", {
-    description: "Interactively pick DOM elements in the active Chrome tab",
+  browserCli.command("pick", {
+    description: "Interactively pick DOM elements in the active browser tab",
     args: external_exports.object({
       message: external_exports.string().min(1)
     }),
     run: async (context) => {
-      return executeChromeTool({
+      return executeBrowserTool({
         scriptName: "browser-pick.js",
         args: [context.args.message],
+        outputMode: "json",
         cwd: options2.cwd,
         processExecPath: options2.processExecPath,
         spawnSyncFn: options2.spawnSyncFn,
-        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
       });
     }
   });
-  chromeCli.command("cookies", {
-    description: "Show cookies for the active Chrome tab",
+  browserCli.command("cookies", {
+    description: "Show cookies for the active browser tab",
     run: async () => {
-      return executeChromeTool({
+      return executeBrowserTool({
         scriptName: "browser-cookies.js",
         args: [],
+        outputMode: "json",
         cwd: options2.cwd,
         processExecPath: options2.processExecPath,
         spawnSyncFn: options2.spawnSyncFn,
-        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
       });
     }
   });
-  chromeCli.command("content", {
-    description: "Extract readable markdown content from a URL in Chrome",
+  browserCli.command("content", {
+    description: "Extract readable markdown content from a URL",
     args: external_exports.object({
       url: external_exports.string().min(1)
     }),
     run: async (context) => {
-      return executeChromeTool({
+      return executeBrowserTool({
         scriptName: "browser-content.js",
         args: [context.args.url],
         cwd: options2.cwd,
         processExecPath: options2.processExecPath,
         spawnSyncFn: options2.spawnSyncFn,
-        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
       });
     }
   });
-  chromeCli.command("hn-scraper", {
-    description: "Scrape Hacker News submissions as JSON",
+  browserCli.command("run-script", {
+    description: "Run a CDP script on the active browser session",
+    args: external_exports.object({
+      script: external_exports.string().min(1).describe("Path to a JS/TS file containing the CDP script to execute")
+    }),
     options: external_exports.object({
-      limit: external_exports.number().int().positive().optional().describe("Maximum number of submissions to return")
+      appSlug: external_exports.string().optional().describe("App slug to resolve the browser session from"),
+      appId: external_exports.string().optional().describe("App ID to resolve the browser session from"),
+      keepAlive: external_exports.number().int().positive().optional().describe("Session keep-alive in milliseconds (default: 600000)")
     }),
     run: async (context) => {
-      const args2 = [];
-      if (context.options.limit !== void 0) {
-        args2.push("--limit", String(context.options.limit));
+      const args2 = [context.args.script];
+      if (context.options.appSlug) {
+        args2.push("--appSlug", context.options.appSlug);
+      }
+      if (context.options.appId) {
+        args2.push("--appId", context.options.appId);
+      }
+      if (context.options.keepAlive !== void 0) {
+        args2.push("--keepAlive", String(context.options.keepAlive));
       }
-      return executeChromeTool({
-        scriptName: "browser-hn-scraper.js",
+      return executeBrowserTool({
+        scriptName: "browser-run-script.js",
         args: args2,
         outputMode: "json",
         cwd: options2.cwd,
         processExecPath: options2.processExecPath,
         spawnSyncFn: options2.spawnSyncFn,
-        resolveChromeToolsResourceRootFn: options2.resolveChromeToolsResourceRootFn
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
       });
     }
   });
-  return chromeCli;
+  return browserCli;
 }
 
 // src/services/inputReader.ts
@@ -154272,6 +154323,16 @@ function createPiAgentServerLauncher(options2) {
       cwd,
       spawnCommand: import_node_child_process9.spawnSync
     });
+    if (request.sandbox) {
+      const browserConfigDir = settingsRootPath;
+      (0, import_node_fs18.mkdirSync)(browserConfigDir, { recursive: true, mode: 448 });
+      const browserConfigPath = (0, import_node_path29.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",
+        mode: 384
+      });
+    }
     spinner.stop();
     const loaderEntryPath = resolveServerLoaderEntryPath(cwd, __dirname);
     const piPackageRoot = resolveInstalledPiPackageRootPath({ cwd });
@@ -154290,7 +154351,8 @@ function createPiAgentServerLauncher(options2) {
         DOCYRUS_CLI_EXECUTABLE: process.execPath,
         DOCYRUS_CLI_ENTRY: cliEntryPath,
         DOCYRUS_CLI_SCOPE: options2.settingsPaths.scope,
-        OFFICECLI_SKIP_UPDATE: "1"
+        OFFICECLI_SKIP_UPDATE: "1",
+        ...request.sandbox ? { DOCYRUS_BROWSER_SANDBOX: "1" } : {}
       }
     });
     await new Promise((resolve2, reject) => {
@@ -154475,9 +154537,9 @@ var ROOT_HELP_COMMANDS = [
   { command: "agent [prompt]", description: "Launch the Docyrus Cowork Agent" },
   { command: "coder [prompt]", description: "Launch the Docyrus Coding Agent" },
   { command: "server", description: "Start HTTP server bridging pi agent to AI SDK useChat" },
-  { 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: "browser start", description: "Start a browser session (local Chrome or remote Cloudflare)" },
+  { command: "browser nav <url>", description: "Navigate the active browser tab" },
+  { command: "browser 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" },
@@ -154589,7 +154651,7 @@ function createDocyrusCli(params) {
   cli2.command(createServerCli({
     launchPiAgentServer: piAgentServerLauncher
   }));
-  cli2.command(createChromeCli({
+  cli2.command(createBrowserCli({
     cwd: params?.cwd
   }));
   cli2.command(createDsCli({