@docyrus/docyrus 0.0.58 → 0.0.60

package/README.md

@@ -65,12 +65,58 @@ docyrus ds --help
 docyrus apps --help
 docyrus studio --help
 docyrus connect --help
+docyrus browser --help
 docyrus agent --help
 docyrus coder --help
 docyrus server --help
 docyrus tui --help
 ```
 
+## Browser Automation
+
+Browser automation via a persistent daemon that holds a raw CDP (Chrome DevTools Protocol) WebSocket connection. Works in both local mode (Chrome on `:9222`) and remote sandbox mode (Cloudflare Browser Rendering).
+
+The daemon starts automatically on the first command and stays alive for 5 minutes of idle time. All commands share the same browser connection.
+
+```bash
+# Session
+docyrus browser start                     # Start Chrome + daemon
+docyrus browser start --profile           # Start with user's Chrome profile
+docyrus browser close                     # Stop daemon
+
+# Navigation
+docyrus browser nav <url>                 # Navigate active tab
+docyrus browser nav <url> --new           # Open in new tab
+
+# Waiting
+docyrus browser wait --idle               # Wait for network idle
+docyrus browser wait --selector "h1"      # Wait for element to appear
+docyrus browser wait --url "**/dashboard" # Wait for URL pattern
+docyrus browser wait 2000                 # Fixed delay
+
+# Page snapshot and interaction
+docyrus browser snapshot                  # Interactive elements with refs (@e1, @e2, ...)
+docyrus browser snapshot --all            # Include non-interactive elements
+docyrus browser click @e3                 # Click by ref
+docyrus browser click 350 200             # Coordinate click (compositor-level)
+docyrus browser fill @e1 "value"          # Clear + type into input
+docyrus browser select @e4 "Option"       # Select dropdown option
+
+# Inspection
+docyrus browser eval 'document.title'     # Evaluate JavaScript
+docyrus browser screenshot                # Viewport screenshot
+docyrus browser screenshot --full --base64 # Full page as base64
+docyrus browser info                      # URL, title, viewport, scroll
+docyrus browser console --level error     # Console messages
+docyrus browser network --method POST     # Network requests
+docyrus browser cookies --name "session"  # Cookies
+docyrus browser content <url>             # Extract readable markdown
+docyrus browser tabs                      # List/switch tabs
+
+# CDP scripts
+docyrus browser run-script script.js      # Run custom CDP script
+```
+
 ## Knowledge Graph
 
 Initialize and use the repo knowledge graph:

package/agent-loader.js

@@ -1239,7 +1239,7 @@ var AgentEnvStore = class {
 // src/agent/packagedExtensions.ts
 var import_node_fs = require("node:fs");
 var import_node_path2 = require("node:path");
-var SERVER_ONLY_PACKAGED_EXTENSION_NAMES = /* @__PURE__ */ new Set(["docyrus-web-browser", "server-auto-commit"]);
+var SERVER_ONLY_PACKAGED_EXTENSION_NAMES = /* @__PURE__ */ new Set(["server-auto-commit"]);
 function isPackagedExtensionEntry(entryName, isDirectory) {
   return isDirectory || entryName.endsWith(".ts") || entryName.endsWith(".js");
 }