crawlio-browser 1.5.0 → 1.5.2

package/dist/mcp-server/{chunk-GJH6PLST.js → chunk-BKBNDFXW.js}

@@ -1,7 +1,7 @@
 // src/shared/constants.ts
 import { homedir } from "os";
 import { join } from "path";
-var PKG_VERSION = "1.5.0";
+var PKG_VERSION = "1.5.2";
 var WS_PORT = 9333;
 var WS_PORT_MAX = 9342;
 var WS_HOST = "127.0.0.1";

package/dist/mcp-server/index.js

@@ -9,7 +9,7 @@ import {
   WS_PORT_MAX,
   WS_RECONNECT_GRACE,
   WS_STALE_THRESHOLD
-} from "./chunk-GJH6PLST.js";
+} from "./chunk-BKBNDFXW.js";
 
 // src/mcp-server/index.ts
 import { randomBytes as randomBytes2 } from "crypto";
@@ -4112,7 +4112,7 @@ function createCodeModeTools(bridge2, crawlio2) {
 process.title = "Crawlio Agent";
 var initMode = process.argv.includes("init") || process.argv.includes("--setup") || process.argv.includes("setup");
 if (initMode) {
-  const { runInit } = await import("./init-CG5XREFD.js");
+  const { runInit } = await import("./init-5MP7GP7G.js");
   await runInit(process.argv.slice(2));
   process.exit(0);
 }

package/dist/mcp-server/{init-CG5XREFD.js → init-5MP7GP7G.js}

@@ -1,6 +1,6 @@
 import {
   PKG_VERSION
-} from "./chunk-GJH6PLST.js";
+} from "./chunk-BKBNDFXW.js";
 
 // src/mcp-server/init.ts
 import { execFileSync, spawn } from "child_process";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crawlio-browser",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "description": "MCP server with 96 CDP-backed tools for browser automation — screenshots, DOM, network capture, framework detection, cookies, storage, session recording, performance metrics via Chrome",
   "type": "module",
   "main": "dist/mcp-server/index.js",

package/skills/browser-automation/SKILL.md

@@ -36,6 +36,13 @@ Check connection status anytime:
 return await bridge.send({ type: "get_connection_status" })
 ```
 
+## Critical Rules
+
+1. **ALWAYS `search` before `execute`** when you're unsure of a command name or its parameters. Never guess command names — they will fail.
+2. **Return values are objects**, not primitives. Always destructure or access properties (see Return Value Shapes below).
+3. **`close_tab` requires `tabId`** — it will error without one. Get tabId from `list_tabs` or `connect_tab`.
+4. **`connect_tab` before any interaction** — most commands require an active tab connection.
+
 ## Core Patterns via `execute`
 
 All browser commands run inside the `execute` tool. The code has access to:
@@ -54,10 +61,10 @@ return await smart.navigate("https://example.com")
 ### Screenshots
 
 ```js
-return await smart.screenshot()
+return await bridge.send({ type: 'take_screenshot' })
 ```
 
-Returns base64 PNG. Use `{ fullPage: true }` for full-page capture.
+Returns `{ screenshot: string }` (base64 PNG). For full-page: `bridge.send({ type: 'take_screenshot', fullPage: true })`.
 
 ### OCR Text Extraction (macOS only)
 
@@ -105,7 +112,7 @@ return await smart.snapshot()
 return await smart.snapshot()
 ```
 
-Returns the a11y tree — use this to discover available elements when selectors fail.
+Returns `{ snapshot: string }` — the a11y tree text. Use this to discover available elements when selectors fail.
 
 ### Evaluate JavaScript
 
@@ -284,6 +291,65 @@ return await crawlio.api("GET", "/settings")
 return await crawlio.api("POST", "/export", { format: "zip", destinationPath: "/tmp/site.zip" })
 ```
 
+## Return Value Shapes
+
+Commands return **objects**, not primitives. Always access the correct property.
+
+### smart methods
+
+```js
+// smart.snapshot() → { snapshot: string }
+const snap = await smart.snapshot();
+const tree = snap.snapshot;  // the a11y tree text
+// WRONG: snap.split('\n')  — snap is an object, not a string
+
+// smart.evaluate(expr) → { result: any, type: string }
+const res = await smart.evaluate("document.title");
+const title = res.result;  // the actual value
+const type = res.type;     // "string", "number", "object", etc.
+// WRONG: res.substring()  — res is an object, not the raw value
+```
+
+### bridge.send commands
+
+```js
+// list_tabs → { tabs: Tab[], connectedTabId: number|null }
+const result = await bridge.send({ type: 'list_tabs' });
+const tabs = result.tabs;           // array of tab objects
+const connected = result.connectedTabId;
+
+// connect_tab → { action, tabId, url, title, windowId, capturing, domainState }
+const tab = await bridge.send({ type: 'connect_tab', tabId: 123 });
+
+// capture_page → { url, title, framework, network, console, cookies, dom, capturedAt }
+const page = await bridge.send({ type: 'capture_page' });
+
+// take_screenshot → { screenshot: string }  (base64 PNG)
+const ss = await bridge.send({ type: 'take_screenshot' });
+
+// get_cookies → { cookies: Cookie[] }
+const result = await bridge.send({ type: 'get_cookies' });
+const cookies = result.cookies;
+
+// get_console_logs → { logs: LogEntry[] }
+const result = await bridge.send({ type: 'get_console_logs' });
+const logs = result.logs;
+
+// close_tab → requires tabId!
+await bridge.send({ type: 'close_tab', tabId: 123 });  // REQUIRED
+// WRONG: bridge.send({ type: 'close_tab' })  — will error
+```
+
+### Network capture (start/stop pattern — no `get_network_entries`)
+
+```js
+await bridge.send({ type: 'start_network_capture' });
+// ... interactions ...
+const result = await bridge.send({ type: 'stop_network_capture' });
+const entries = result.entries;  // array of network entries
+// WRONG: bridge.send({ type: 'get_network_entries' })  — does NOT exist
+```
+
 ## Error Handling
 
 | Error | Solution |
@@ -309,8 +375,8 @@ await smart.click("button[type='submit']")
 await sleep(2000)
 
 // 4. Verify navigation
-const title = await smart.evaluate("document.title")
-return { title, url: await smart.evaluate("location.href") }
+const title = (await smart.evaluate("document.title")).result
+return { title, url: (await smart.evaluate("location.href")).result }
 ```
 
 ## Reference