@docyrus/docyrus 0.0.58 → 0.0.60

package/main.js

@@ -139349,7 +139349,7 @@ function buildInputSchema(args2, env2, options2) {
 // package.json
 var package_default = {
   name: "@docyrus/docyrus",
-  version: "0.0.58",
+  version: "0.0.60",
   private: false,
   description: "Docyrus API CLI",
   main: "./main.js",
@@ -140733,6 +140733,31 @@ function createAuthCli(dependencies) {
       });
     }
   });
+  authCli.command("sandbox", {
+    description: "Refresh and inject fresh authentication tokens into the active sandbox",
+    options: external_exports.object({
+      appId: external_exports.string().optional().describe("App ID; defaults to DOCYRUS_SANDBOX_APP_ID env var")
+    }),
+    run: async (context) => {
+      const appId = context.options.appId?.trim() || getOptionalEnvValue(context.env, "DOCYRUS_SANDBOX_APP_ID");
+      if (!appId) {
+        throw new UserInputError(
+          "App ID is required. Pass --appId or set the DOCYRUS_SANDBOX_APP_ID environment variable."
+        );
+      }
+      const apiBaseUrl = await dependencies.environmentConfigService.getActiveApiBaseUrl();
+      const apiClient = dependencies.createApiClient(apiBaseUrl);
+      const response = await apiClient.request({
+        method: "POST",
+        path: `/ai/sandbox/app/${appId}/refreshAuth`
+      });
+      return await injectContext({
+        apiBaseUrl,
+        authStore: dependencies.authStore,
+        payload: response.data
+      });
+    }
+  });
   return authCli;
 }
 
@@ -140880,10 +140905,17 @@ function createBrowserCli(options2 = {}) {
     args: external_exports.object({
       code: external_exports.string().min(1)
     }),
+    options: external_exports.object({
+      timeout: external_exports.number().int().positive().optional().describe("Timeout in milliseconds (default: 30000)")
+    }),
     run: async (context) => {
+      const args2 = [context.args.code];
+      if (context.options.timeout !== void 0) {
+        args2.push("--timeout", String(context.options.timeout));
+      }
       return executeBrowserTool({
         scriptName: "browser-eval.js",
-        args: [context.args.code],
+        args: args2,
         outputMode: "json",
         cwd: options2.cwd,
         processExecPath: options2.processExecPath,
@@ -140894,27 +140926,21 @@ function createBrowserCli(options2 = {}) {
   });
   browserCli.command("screenshot", {
     description: "Capture a screenshot of the active browser tab",
-    run: async () => {
-      return executeBrowserTool({
-        scriptName: "browser-screenshot.js",
-        args: [],
-        outputMode: "json",
-        cwd: options2.cwd,
-        processExecPath: options2.processExecPath,
-        spawnSyncFn: options2.spawnSyncFn,
-        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
-      });
-    }
-  });
-  browserCli.command("pick", {
-    description: "Interactively pick DOM elements in the active browser tab",
-    args: external_exports.object({
-      message: external_exports.string().min(1)
+    options: external_exports.object({
+      full: external_exports.boolean().optional().describe("Capture full page instead of just the viewport"),
+      base64: external_exports.boolean().optional().describe("Return base64-encoded image data instead of a file path")
     }),
     run: async (context) => {
+      const args2 = [];
+      if (context.options.full) {
+        args2.push("--full");
+      }
+      if (context.options.base64) {
+        args2.push("--base64");
+      }
       return executeBrowserTool({
-        scriptName: "browser-pick.js",
-        args: [context.args.message],
+        scriptName: "browser-screenshot.js",
+        args: args2,
         outputMode: "json",
         cwd: options2.cwd,
         processExecPath: options2.processExecPath,
@@ -140925,10 +140951,21 @@ function createBrowserCli(options2 = {}) {
   });
   browserCli.command("cookies", {
     description: "Show cookies for the active browser tab",
-    run: async () => {
+    options: external_exports.object({
+      name: external_exports.string().optional().describe("Filter cookies by exact name"),
+      domain: external_exports.string().optional().describe("Filter cookies by domain (substring match)")
+    }),
+    run: async (context) => {
+      const args2 = [];
+      if (context.options.name) {
+        args2.push("--name", context.options.name);
+      }
+      if (context.options.domain) {
+        args2.push("--domain", context.options.domain);
+      }
       return executeBrowserTool({
         scriptName: "browser-cookies.js",
-        args: [],
+        args: args2,
         outputMode: "json",
         cwd: options2.cwd,
         processExecPath: options2.processExecPath,
@@ -140946,6 +140983,7 @@ function createBrowserCli(options2 = {}) {
       return executeBrowserTool({
         scriptName: "browser-content.js",
         args: [context.args.url],
+        outputMode: "json",
         cwd: options2.cwd,
         processExecPath: options2.processExecPath,
         spawnSyncFn: options2.spawnSyncFn,
@@ -140985,6 +141023,286 @@ function createBrowserCli(options2 = {}) {
       });
     }
   });
+  browserCli.command("wait", {
+    description: "Wait for a condition before proceeding",
+    options: external_exports.object({
+      idle: external_exports.boolean().optional().describe("Wait for network idle"),
+      selector: external_exports.string().optional().describe("Wait for CSS selector to appear"),
+      url: external_exports.string().optional().describe("Wait for URL to match glob pattern"),
+      timeout: external_exports.number().int().positive().optional().describe("Maximum wait time in ms (default: 15000)")
+    }),
+    args: external_exports.object({
+      ms: external_exports.string().optional().describe("Fixed delay in milliseconds")
+    }),
+    run: async (context) => {
+      const args2 = [];
+      if (context.options.idle) {
+        args2.push("--idle");
+      }
+      if (context.options.selector) {
+        args2.push("--selector", context.options.selector);
+      }
+      if (context.options.url) {
+        args2.push("--url", context.options.url);
+      }
+      if (context.options.timeout !== void 0) {
+        args2.push("--timeout", String(context.options.timeout));
+      }
+      if (context.args.ms) {
+        args2.push(context.args.ms);
+      }
+      return executeBrowserTool({
+        scriptName: "browser-wait.js",
+        args: args2,
+        outputMode: "json",
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
+      });
+    }
+  });
+  browserCli.command("snapshot", {
+    description: "Get a compact snapshot of page elements with refs for interaction",
+    options: external_exports.object({
+      all: external_exports.boolean().optional().describe("Include all elements, not just interactive ones"),
+      selector: external_exports.string().optional().describe("Scope snapshot to a CSS selector subtree")
+    }),
+    run: async (context) => {
+      const args2 = [];
+      if (context.options.all) {
+        args2.push("--all");
+      }
+      if (context.options.selector) {
+        args2.push("--selector", context.options.selector);
+      }
+      return executeBrowserTool({
+        scriptName: "browser-snapshot.js",
+        args: args2,
+        outputMode: "json",
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
+      });
+    }
+  });
+  browserCli.command("click", {
+    description: "Click an element by snapshot ref, CSS selector, or x,y coordinates",
+    args: external_exports.object({
+      target: external_exports.string().min(1).describe("Snapshot ref (@e1), CSS selector, or x coordinate"),
+      y: external_exports.string().optional().describe("y coordinate (when using coordinate mode)")
+    }),
+    options: external_exports.object({
+      timeout: external_exports.number().int().positive().optional().describe("Timeout in milliseconds (default: 5000)")
+    }),
+    run: async (context) => {
+      const args2 = [context.args.target];
+      if (context.args.y) {
+        args2.push(context.args.y);
+      }
+      if (context.options.timeout !== void 0) {
+        args2.push("--timeout", String(context.options.timeout));
+      }
+      return executeBrowserTool({
+        scriptName: "browser-click.js",
+        args: args2,
+        outputMode: "json",
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
+      });
+    }
+  });
+  browserCli.command("fill", {
+    description: "Fill a value into an input/textarea by snapshot ref or CSS selector",
+    args: external_exports.object({
+      target: external_exports.string().min(1).describe("Snapshot ref (@e1) or CSS selector"),
+      value: external_exports.string().describe("Value to type into the element")
+    }),
+    options: external_exports.object({
+      timeout: external_exports.number().int().positive().optional().describe("Timeout in milliseconds (default: 5000)")
+    }),
+    run: async (context) => {
+      const args2 = [context.args.target, context.args.value];
+      if (context.options.timeout !== void 0) {
+        args2.push("--timeout", String(context.options.timeout));
+      }
+      return executeBrowserTool({
+        scriptName: "browser-fill.js",
+        args: args2,
+        outputMode: "json",
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
+      });
+    }
+  });
+  browserCli.command("select", {
+    description: "Select a dropdown option by snapshot ref or CSS selector",
+    args: external_exports.object({
+      target: external_exports.string().min(1).describe("Snapshot ref (@e1) or CSS selector"),
+      value: external_exports.string().min(1).describe("Option text or value to select")
+    }),
+    options: external_exports.object({
+      timeout: external_exports.number().int().positive().optional().describe("Timeout in milliseconds (default: 5000)")
+    }),
+    run: async (context) => {
+      const args2 = [context.args.target, context.args.value];
+      if (context.options.timeout !== void 0) {
+        args2.push("--timeout", String(context.options.timeout));
+      }
+      return executeBrowserTool({
+        scriptName: "browser-select.js",
+        args: args2,
+        outputMode: "json",
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
+      });
+    }
+  });
+  browserCli.command("console", {
+    description: "Capture console messages from the active page",
+    options: external_exports.object({
+      level: external_exports.string().optional().describe("Filter by level: log, warn, error, info, debug"),
+      listen: external_exports.number().int().positive().optional().describe("Listen for new messages for N milliseconds")
+    }),
+    run: async (context) => {
+      const args2 = [];
+      if (context.options.level) {
+        args2.push("--level", context.options.level);
+      }
+      if (context.options.listen !== void 0) {
+        args2.push("--listen", String(context.options.listen));
+      }
+      return executeBrowserTool({
+        scriptName: "browser-console.js",
+        args: args2,
+        outputMode: "json",
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
+      });
+    }
+  });
+  browserCli.command("network", {
+    description: "Inspect captured network requests",
+    options: external_exports.object({
+      method: external_exports.string().optional().describe("Filter by HTTP method (GET, POST, etc.)"),
+      status: external_exports.string().optional().describe("Filter by status code or pattern (200, 4xx, 5xx)"),
+      url: external_exports.string().optional().describe("Filter by URL substring"),
+      listen: external_exports.number().int().positive().optional().describe("Listen for new requests for N milliseconds")
+    }),
+    run: async (context) => {
+      const args2 = [];
+      if (context.options.method) {
+        args2.push("--method", context.options.method);
+      }
+      if (context.options.status) {
+        args2.push("--status", context.options.status);
+      }
+      if (context.options.url) {
+        args2.push("--url", context.options.url);
+      }
+      if (context.options.listen !== void 0) {
+        args2.push("--listen", String(context.options.listen));
+      }
+      return executeBrowserTool({
+        scriptName: "browser-network.js",
+        args: args2,
+        outputMode: "json",
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
+      });
+    }
+  });
+  browserCli.command("devtools", {
+    description: "Read @docyrus/devtools state, errors, issues, or console entries from the active page",
+    args: external_exports.object({
+      subcommand: external_exports.enum(["state", "errors", "issues", "console"]).describe("What to read: state, errors, issues, or console")
+    }),
+    options: external_exports.object({
+      level: external_exports.string().optional().describe("Filter console entries by level (for console subcommand)")
+    }),
+    run: async (context) => {
+      const args2 = [context.args.subcommand];
+      if (context.options.level) {
+        args2.push("--level", context.options.level);
+      }
+      return executeBrowserTool({
+        scriptName: "browser-devtools.js",
+        args: args2,
+        outputMode: "json",
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
+      });
+    }
+  });
+  browserCli.command("info", {
+    description: "Get current page info: URL, title, viewport size, scroll position",
+    run: async () => {
+      return executeBrowserTool({
+        scriptName: "browser-info.js",
+        args: [],
+        outputMode: "json",
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
+      });
+    }
+  });
+  browserCli.command("tabs", {
+    description: "List open tabs or switch to a specific tab",
+    options: external_exports.object({
+      switch: external_exports.number().int().optional().describe("Switch to tab by index (0-based)")
+    }),
+    run: async (context) => {
+      const args2 = [];
+      if (context.options.switch !== void 0) {
+        args2.push("--switch", String(context.options.switch));
+      }
+      return executeBrowserTool({
+        scriptName: "browser-tabs.js",
+        args: args2,
+        outputMode: "json",
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
+      });
+    }
+  });
+  browserCli.command("close", {
+    description: "Close the browser session",
+    options: external_exports.object({
+      kill: external_exports.boolean().optional().describe("Kill the local Chrome process (local mode only)")
+    }),
+    run: async (context) => {
+      const args2 = [];
+      if (context.options.kill) {
+        args2.push("--kill");
+      }
+      return executeBrowserTool({
+        scriptName: "browser-close.js",
+        args: args2,
+        outputMode: "json",
+        cwd: options2.cwd,
+        processExecPath: options2.processExecPath,
+        spawnSyncFn: options2.spawnSyncFn,
+        resolveBrowserToolsResourceRootFn: options2.resolveBrowserToolsResourceRootFn
+      });
+    }
+  });
   return browserCli;
 }
 
@@ -151085,10 +151403,12 @@ function createReleaseCli(dependencies) {
     options: external_exports.object({
       bump: external_exports.enum(BUMP_TYPES).optional().describe("SemVer bump type (auto-detect if omitted)"),
       version: external_exports.string().optional().describe("Explicit target version (e.g., 1.0.0)"),
+      appId: external_exports.string().optional().describe("App ID for creating a release record; defaults to DOCYRUS_SANDBOX_APP_ID env var"),
       dryRun: external_exports.boolean().optional().describe("Preview changes without committing"),
       skipChangelog: external_exports.boolean().optional().describe("Skip changelog generation"),
       skipTag: external_exports.boolean().optional().describe("Skip git tag creation"),
-      skipGithubRelease: external_exports.boolean().optional().describe("Skip GitHub release creation")
+      skipGithubRelease: external_exports.boolean().optional().describe("Skip GitHub release creation"),
+      skipDbRelease: external_exports.boolean().optional().describe("Skip creating a release record in the database")
     }),
     run: async (context) => {
       const result = await executeRelease({
@@ -151114,6 +151434,23 @@ function createReleaseCli(dependencies) {
           `  Previous: ${result.previousVersion}`,
           `  Commits: ${result.commitCount}`
         ].join("\n"));
+        if (!context.options.skipDbRelease) {
+          const appId = context.options.appId?.trim() || getOptionalEnvValue(context.env, "DOCYRUS_SANDBOX_APP_ID");
+          if (appId) {
+            const apiBaseUrl = await dependencies.environmentConfigService.getActiveApiBaseUrl();
+            const apiClient = dependencies.createApiClient(apiBaseUrl);
+            const releaseRecord = await apiClient.request({
+              method: "POST",
+              path: `/dev/apps/${appId}/releases`,
+              body: {
+                version: result.nextVersion,
+                tagName: `v${result.nextVersion}`,
+                changelog: result.changelogEntry || null
+              }
+            });
+            maybePrintHuman3(context, `  Release record created: ${releaseRecord.data.id}`);
+          }
+        }
       }
       return await wrapPayload2(dependencies, result);
     }
@@ -154676,6 +155013,7 @@ function createDocyrusCli(params) {
     settingsPaths
   }));
   cli2.command(createReleaseCli({
+    createApiClient,
     environmentConfigService,
     authStore,
     settingsPaths