@docyrus/docyrus 0.0.56 → 0.0.58

package/resources/pi-agent/skills/docyrus-chrome-devtools-cli/SKILL.md

@@ -1,67 +1,82 @@
 ---
-name: docyrus-chrome-devtools-cli
-description: Use Docyrus CLI chrome commands for visible browser automation through Chrome DevTools. Use when you need to launch Chrome with remote debugging, navigate pages, inspect DOM state, evaluate JavaScript, capture screenshots, pick elements interactively, inspect cookies, extract readable page content, or scrape Hacker News.
+name: docyrus-browser-cli
+description: Use Docyrus CLI browser commands for browser automation (local Chrome or remote Cloudflare Browser Rendering). Use when you need to start a browser session, navigate pages, inspect DOM state, evaluate JavaScript, capture screenshots, pick elements interactively, inspect cookies, extract readable page content, or run CDP scripts.
 ---
 
-# Docyrus Chrome DevTools CLI
+# Docyrus Browser CLI
 
-Chrome DevTools Protocol workflows exposed through the local `docyrus` CLI.
+Browser automation commands exposed through the `docyrus` CLI. Works in both local mode (Chrome on `:9222`) and remote sandbox mode (Cloudflare Browser Rendering via WSS).
+
+All commands return JSON with a `mode` field (`"local"` or `"remote"`). In remote mode, responses include `devtoolsFrontendUrl` for live DevTools access.
 
 ## Commands
 
-Start Chrome with remote debugging on `:9222`:
+Start a browser session:
 
 ```bash
-docyrus chrome start
-docyrus chrome start --profile
+docyrus browser start
+docyrus browser start --profile
 ```
 
-- `--profile` copies the user's default Chrome profile so cookies and existing logins are available.
+- Local mode: launches Chrome with remote debugging on `:9222`. `--profile` copies the user's default Chrome profile.
+- Sandbox mode: creates a Cloudflare Browser Rendering session and opens the app preview URL.
 
 Navigate tabs:
 
 ```bash
-docyrus chrome nav https://example.com
-docyrus chrome nav https://example.com --new
-docyrus chrome nav https://example.com --reload
+docyrus browser nav https://example.com
+docyrus browser nav https://example.com --new
+docyrus browser nav https://example.com --reload
 ```
 
 Run JavaScript in the active tab:
 
 ```bash
-docyrus chrome eval 'document.title'
-docyrus chrome eval 'document.querySelectorAll("a").length'
+docyrus browser eval 'document.title'
+docyrus browser eval 'document.querySelectorAll("a").length'
 ```
 
 Capture a screenshot of the active tab:
 
 ```bash
-docyrus chrome screenshot
+docyrus browser screenshot
 ```
 
 Interactively pick DOM elements in the visible browser:
 
 ```bash
-docyrus chrome pick "Click the submit button"
+docyrus browser pick "Click the submit button"
 ```
 
 Inspect cookies for the active tab:
 
 ```bash
-docyrus chrome cookies
+docyrus browser cookies
 ```
 
 Extract readable content as markdown:
 
 ```bash
-docyrus chrome content https://example.com
+docyrus browser content https://example.com
 ```
 
-Scrape Hacker News:
+Run a CDP script on the active browser session:
 
 ```bash
-docyrus chrome hn-scraper
-docyrus chrome hn-scraper --limit 10
+docyrus browser run-script my-script.js
+docyrus browser run-script my-script.js --appId <appId>
+docyrus browser run-script my-script.js --appSlug my-app
+```
+
+- The script receives `browser` (Puppeteer Browser) and `page` (a new Page) as function arguments.
+- Whatever the script returns is printed as JSON to stdout.
+
+Example script (`scrape-title.js`):
+
+```js
+await page.goto("https://example.com");
+const title = await page.title();
+return { title };
 ```
 
 ## When To Use
@@ -71,10 +86,12 @@ docyrus chrome hn-scraper --limit 10
 - You need to inspect DOM state without guessing selectors.
 - You want the user to click elements directly through an interactive picker.
 - You need quick page extraction or screenshot capture from a real browser session.
+- You need to run CDP scripts against a remote headless browser from within a sandbox.
 
 ## Working Style
 
-- Start Chrome first with `docyrus chrome start` if the debugger is not already available.
-- Prefer `docyrus chrome eval` for DOM inspection and structured page state.
-- Use `docyrus chrome pick` when element targeting is ambiguous or user choice matters.
-- Use `docyrus chrome content` for readable markdown extraction from article-like pages.
+- Start a session first with `docyrus browser start` if the browser is not already available.
+- Prefer `docyrus browser eval` for DOM inspection and structured page state.
+- Use `docyrus browser pick` when element targeting is ambiguous or user choice matters.
+- Use `docyrus browser content` for readable markdown extraction from article-like pages.
+- Use `docyrus browser run-script` to run full Puppeteer scripts on the active browser session.

package/resources/pi-agent/skills/docyrus-platform/references/docyrus-cli-usage.md

@@ -108,19 +108,19 @@ Send a prompt to a Docyrus AI agent.
 
 ---
 
-## chrome — Chrome DevTools Browser Automation
+## browser — Browser Automation
 
-Docyrus ships Chrome DevTools helper commands for visible browser automation against Chrome running with remote debugging on `:9222`.
+Browser automation commands (local Chrome or remote Cloudflare Browser Rendering). All commands return JSON with a `mode` field (`"local"` or `"remote"`).
 
-### `docyrus chrome start`
+### `docyrus browser start`
 
-Launch Chrome with remote debugging enabled.
+Start a browser session. Local mode launches Chrome on `:9222`. Sandbox mode creates a Cloudflare session.
 
 | Option | Type | Description |
 |---|---|---|
-| `--profile` | boolean | Copy the default Chrome profile so existing cookies and logins are available |
+| `--profile` | boolean | Copy the default Chrome profile (local mode only) |
 
-### `docyrus chrome nav <url>`
+### `docyrus browser nav <url>`
 
 Navigate the active tab or open the URL in a new tab.
 
@@ -129,33 +129,35 @@ Navigate the active tab or open the URL in a new tab.
 | `--new` | boolean | Open the URL in a new tab |
 | `--reload` | boolean | Force a reload after navigation |
 
-### `docyrus chrome eval <code>`
+### `docyrus browser eval <code>`
 
 Execute JavaScript in the active tab and print the result.
 
-### `docyrus chrome screenshot`
+### `docyrus browser screenshot`
 
 Capture the current viewport and return the temporary screenshot file path.
 
-### `docyrus chrome pick <message>`
+### `docyrus browser pick <message>`
 
 Open an interactive element picker in the active tab and return information about the selected element or elements.
 
-### `docyrus chrome cookies`
+### `docyrus browser cookies`
 
 Print cookies for the active tab, including domain, path, `httpOnly`, and `secure` flags.
 
-### `docyrus chrome content <url>`
+### `docyrus browser content <url>`
 
 Navigate to a URL and extract readable content as markdown.
 
-### `docyrus chrome hn-scraper`
+### `docyrus browser run-script <script>`
 
-Scrape Hacker News front page submissions as JSON.
+Run a CDP script file on the active browser session.
 
 | Option | Type | Description |
 |---|---|---|
-| `--limit` | number | Maximum number of submissions to return |
+| `--appId` | string | App ID for browser session resolution |
+| `--appSlug` | string | App slug for browser session resolution |
+| `--keepAlive` | number | Session keep-alive in milliseconds |
 
 ---
 

package/server-loader.js

@@ -17984,7 +17984,7 @@ var require_websocket_server = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/@hono+node-server@1.19.13_hono@4.12.12/node_modules/@hono/node-server/dist/index.mjs
+// ../../node_modules/.pnpm/@hono+node-server@1.19.13_hono@4.12.14/node_modules/@hono/node-server/dist/index.mjs
 var dist_exports = {};
 __export(dist_exports, {
   RequestError: () => RequestError,
@@ -18039,7 +18039,7 @@ function writeFromReadableStream(stream, writable) {
 }
 var import_http, import_http2, import_http22, import_stream2, import_crypto, RequestError, toRequestError, GlobalRequest, Request2, newHeadersFromIncoming, wrapBodyStream, newRequestFromIncoming, getRequestCache, requestCache, incomingKey, urlKey, headersKey, abortControllerKey, getAbortController, requestPrototype, newRequest, responseCache, getResponseCache, cacheKey, GlobalResponse, Response2, buildOutgoingHttpHeaders, X_ALREADY_SENT, outgoingEnded, incomingDraining, DRAIN_TIMEOUT_MS, MAX_DRAIN_BYTES, drainIncoming, handleRequestError, handleFetchError, handleResponseError, flushHeaders, responseViaCache, isPromise, responseViaResponseObject, getRequestListener, createAdaptorServer, serve;
 var init_dist = __esm({
-  "../../node_modules/.pnpm/@hono+node-server@1.19.13_hono@4.12.12/node_modules/@hono/node-server/dist/index.mjs"() {
+  "../../node_modules/.pnpm/@hono+node-server@1.19.13_hono@4.12.14/node_modules/@hono/node-server/dist/index.mjs"() {
     "use strict";
     import_http = require("http");
     import_http2 = require("http2");
@@ -33177,7 +33177,7 @@ var EnvironmentConfigService = class {
   }
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/compose.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/compose.js
 var compose = (middleware, onError, onNotFound) => {
   return (context, next) => {
     let index2 = -1;
@@ -33221,10 +33221,10 @@ var compose = (middleware, onError, onNotFound) => {
   };
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/request/constants.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/request/constants.js
 var GET_MATCH_RESULT = /* @__PURE__ */ Symbol();
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/utils/body.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/utils/body.js
 var parseBody = async (request, options = /* @__PURE__ */ Object.create(null)) => {
   const { all: all2 = false, dot = false } = options;
   const headers = request instanceof HonoRequest ? request.raw.headers : request.headers;
@@ -33296,7 +33296,7 @@ var handleParsingNestedValues = (form, key, value2) => {
   });
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/utils/url.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/utils/url.js
 var splitPath = (path6) => {
   const paths = path6.split("/");
   if (paths[0] === "") {
@@ -33500,7 +33500,7 @@ var getQueryParams = (url2, key) => {
 };
 var decodeURIComponent_ = decodeURIComponent;
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/request.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/request.js
 var tryDecodeURIComponent = (str) => tryDecode(str, decodeURIComponent_);
 var HonoRequest = class {
   /**
@@ -33768,7 +33768,7 @@ var HonoRequest = class {
   }
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/utils/html.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/utils/html.js
 var HtmlEscapedCallbackPhase = {
   Stringify: 1,
   BeforeStream: 2,
@@ -33810,7 +33810,7 @@ var resolveCallback = async (str, phase, preserveCallbacks, context, buffer) =>
   }
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/context.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/context.js
 var TEXT_PLAIN = "text/plain; charset=UTF-8";
 var setDefaultContentType = (contentType, headers) => {
   return {
@@ -34217,7 +34217,7 @@ var Context = class {
   };
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/router.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/router.js
 var METHOD_NAME_ALL = "ALL";
 var METHOD_NAME_ALL_LOWERCASE = "all";
 var METHODS = ["get", "post", "put", "delete", "options", "patch"];
@@ -34225,10 +34225,10 @@ var MESSAGE_MATCHER_IS_ALREADY_BUILT = "Can not add a route since the matcher is
 var UnsupportedPathError = class extends Error {
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/utils/constants.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/utils/constants.js
 var COMPOSED_HANDLER = "__COMPOSED_HANDLER";
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/hono-base.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/hono-base.js
 var notFoundHandler = (c) => {
   return c.text("404 Not Found", 404);
 };
@@ -34599,7 +34599,7 @@ var Hono = class _Hono {
   };
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/router/reg-exp-router/matcher.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/router/reg-exp-router/matcher.js
 var emptyParam = [];
 function match(method, path6) {
   const matchers = this.buildAllMatchers();
@@ -34620,7 +34620,7 @@ function match(method, path6) {
   return match2(method, path6);
 }
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/router/reg-exp-router/node.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/router/reg-exp-router/node.js
 var LABEL_REG_EXP_STR = "[^/]+";
 var ONLY_WILDCARD_REG_EXP_STR = ".*";
 var TAIL_WILDCARD_REG_EXP_STR = "(?:|/.*)";
@@ -34728,7 +34728,7 @@ var Node = class _Node {
   }
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/router/reg-exp-router/trie.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/router/reg-exp-router/trie.js
 var Trie = class {
   #context = { varIndex: 0 };
   #root = new Node();
@@ -34784,7 +34784,7 @@ var Trie = class {
   }
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/router/reg-exp-router/router.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/router/reg-exp-router/router.js
 var nullMatcher = [/^$/, [], /* @__PURE__ */ Object.create(null)];
 var wildcardRegExpCache = /* @__PURE__ */ Object.create(null);
 function buildWildcardRegExp(path6) {
@@ -34963,7 +34963,7 @@ var RegExpRouter = class {
   }
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/router/smart-router/router.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/router/smart-router/router.js
 var SmartRouter = class {
   name = "SmartRouter";
   #routers = [];
@@ -35018,7 +35018,7 @@ var SmartRouter = class {
   }
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/router/trie-router/node.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/router/trie-router/node.js
 var emptyParams = /* @__PURE__ */ Object.create(null);
 var hasChildren = (children) => {
   for (const _ in children) {
@@ -35193,7 +35193,7 @@ var Node2 = class _Node2 {
   }
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/router/trie-router/router.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/router/trie-router/router.js
 var TrieRouter = class {
   name = "TrieRouter";
   #node;
@@ -35215,7 +35215,7 @@ var TrieRouter = class {
   }
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/hono.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/hono.js
 var Hono2 = class extends Hono {
   /**
    * Creates an instance of the Hono class.
@@ -35230,7 +35230,7 @@ var Hono2 = class extends Hono {
   }
 };
 
-// ../../node_modules/.pnpm/hono@4.12.12/node_modules/hono/dist/middleware/cors/index.js
+// ../../node_modules/.pnpm/hono@4.12.14/node_modules/hono/dist/middleware/cors/index.js
 var cors = (options) => {
   const defaults = {
     origin: "*",
@@ -43378,23 +43378,39 @@ function attachPtyBridge(server, authToken) {
         return;
       }
     }
+    const origin = request.headers.origin ?? "unknown";
+    const remoteAddr = request.socket?.remoteAddress ?? "unknown";
+    process.stderr.write(`  PTY WebSocket upgrade from ${remoteAddr} (origin: ${origin})
+`);
     wss.handleUpgrade(request, socket, head, (ws) => {
       wss.emit("connection", ws, request);
     });
   });
   wss.on("connection", (ws) => {
     const shell = getDefaultShell();
-    const ptyProcess = pty.spawn(shell, [], {
-      name: "xterm-256color",
-      cols: DEFAULT_COLS,
-      rows: DEFAULT_ROWS,
-      cwd: process.cwd(),
-      env: {
-        ...process.env,
-        TERM: "xterm-256color",
-        COLORTERM: "truecolor"
+    let ptyProcess;
+    try {
+      ptyProcess = pty.spawn(shell, [], {
+        name: "xterm-256color",
+        cols: DEFAULT_COLS,
+        rows: DEFAULT_ROWS,
+        cwd: process.cwd(),
+        env: {
+          ...process.env,
+          TERM: "xterm-256color",
+          COLORTERM: "truecolor"
+        }
+      });
+    } catch (err2) {
+      const message = err2 instanceof Error ? err2.message : String(err2);
+      process.stderr.write(`  PTY spawn failed (${shell}): ${message}
+`);
+      if (ws.readyState === import_websocket.default.OPEN) {
+        ws.send(JSON.stringify({ type: "error", message: `Failed to spawn shell: ${message}` }));
+        ws.close();
       }
-    });
+      return;
+    }
     const onData = ptyProcess.onData((data) => {
       if (ws.readyState === import_websocket.default.OPEN) {
         ws.send(data);
@@ -45657,14 +45673,11 @@ async function createAgentServer(params) {
       return c.json({ error: message }, status);
     }
   });
-  const CLI_EXEC = process.env.DOCYRUS_CLI_EXECUTABLE || process.execPath;
-  const CLI_ENTRY = process.env.DOCYRUS_CLI_ENTRY || (0, import_node_path22.resolve)(process.argv[1] ? (0, import_node_path22.join)(process.argv[1], "..") : __dirname, "main.js");
-  const CLI_SCOPE = process.env.DOCYRUS_CLI_SCOPE;
+  const CLI_GLOBAL = process.env.DOCYRUS_CLI_SCOPE === "global";
   const CLI_TIMEOUT_MS = 3e4;
   function runCliCommand(args2) {
     return new Promise((resolveResult) => {
-      const scopeArgs = CLI_SCOPE ? ["--scope", CLI_SCOPE] : [];
-      const proc = (0, import_node_child_process3.spawn)(CLI_EXEC, [CLI_ENTRY, ...scopeArgs, ...args2, "--json"], {
+      const proc = (0, import_node_child_process3.spawn)("docyrus", [...CLI_GLOBAL ? ["-g"] : [], ...args2, "--json"], {
         cwd: context.cwd,
         stdio: ["ignore", "pipe", "pipe"],
         timeout: CLI_TIMEOUT_MS
@@ -46313,8 +46326,7 @@ async function createAgentServer(params) {
     }
     const cliArgs = buildCliArgs(pathSegments, query, body2);
     return new Promise((resolveResponse) => {
-      const scopeArgs = CLI_SCOPE ? ["--scope", CLI_SCOPE] : [];
-      const proc = (0, import_node_child_process3.spawn)(CLI_EXEC, [CLI_ENTRY, ...scopeArgs, ...cliArgs], {
+      const proc = (0, import_node_child_process3.spawn)("docyrus", [...CLI_GLOBAL ? ["-g"] : [], ...cliArgs], {
         cwd: context.cwd,
         stdio: ["ignore", "pipe", "pipe"],
         timeout: CLI_TIMEOUT_MS
@@ -46329,10 +46341,16 @@ async function createAgentServer(params) {
       });
       proc.on("close", (code) => {
         if (code !== 0) {
+          let parsedStdout;
+          try {
+            parsedStdout = JSON.parse(stdout);
+          } catch {
+          }
           resolveResponse(c.json({
             error: stderr.trim() || `Command exited with code ${code}`,
             command: `docyrus ${cliArgs.join(" ")}`,
-            exitCode: code
+            exitCode: code,
+            ...parsedStdout !== void 0 ? { detail: parsedStdout } : stdout.trim() ? { output: stdout.trim() } : {}
           }, 500));
           return;
         }