browser-pilot 0.0.12 → 0.0.13

package/README.md

@@ -167,10 +167,10 @@ console.log(snapshot.interactiveElements);
 
 // Text representation for LLMs
 console.log(snapshot.text);
-// - main [ref=e1]
-//   - heading "Welcome" [ref=e2]
-//   - button "Get Started" [ref=e3]
-//   - textbox [ref=e4] placeholder="Email"
+// - main ref:e1
+//   - heading "Welcome" ref:e2
+//   - button "Get Started" ref:e3
+//   - textbox ref:e4 placeholder="Email"
 ```
 
 ### Ref-Based Selectors
@@ -179,7 +179,7 @@ After taking a snapshot, use element refs directly as selectors:
 
 ```typescript
 const snapshot = await page.snapshot();
-// Output shows: button "Submit" [ref=e4]
+// Output shows: button "Submit" ref:e4
 
 // Click using the ref - no fragile CSS needed
 await page.click('ref:e4');
@@ -383,13 +383,19 @@ bp exec -s my-session '[
 
 # Get page state (note the refs in output)
 bp snapshot -s my-session --format text
-# Output: button "Submit" [ref=e4], textbox "Email" [ref=e5], ...
+# Output: button "Submit" ref:e4, textbox "Email" ref:e5, ...
 
 # Use refs from snapshot for reliable targeting
 # Refs are cached per session+URL after snapshot
 bp exec -s my-session '{"action":"click","selector":"ref:e4"}'
 bp exec -s my-session '{"action":"fill","selector":"ref:e5","value":"test@example.com"}'
 
+# Quick discovery commands
+bp page -s my-session          # URL, title, headings, forms, interactive controls
+bp forms -s my-session         # Structured form metadata only
+bp targets -s my-session       # Browser tabs with targetIds
+bp connect --new-tab --url https://example.com --name fresh
+
 # Handle native dialogs (alert/confirm/prompt)
 bp exec --dialog accept '{"action":"click","selector":"#delete-btn"}'
 
@@ -423,7 +429,7 @@ The CLI is designed for AI agent tool calls. The recommended workflow:
 ```bash
 # Step 1: Get page state with refs
 bp snapshot --format text
-# Output shows: button "Add to Cart" [ref=e12], textbox "Search" [ref=e5]
+# Output shows: button "Add to Cart" ref:e12, textbox "Search" ref:e5
 
 # Step 2: Use refs to interact (stable, no CSS guessing)
 bp exec '[

package/dist/actions.cjs

@@ -638,6 +638,9 @@ var BatchExecutor = class {
         const snapshot = await this.page.snapshot();
         return { value: snapshot };
       }
+      case "forms": {
+        return { value: await this.page.forms() };
+      }
       case "screenshot": {
         const data = await this.page.screenshot({
           format: step.format,
@@ -657,6 +660,21 @@ var BatchExecutor = class {
         const text = await this.page.text(selector);
         return { text, selectorUsed: selector };
       }
+      case "newTab": {
+        const { targetId } = await this.page.cdpClient.send(
+          "Target.createTarget",
+          {
+            url: step.url ?? "about:blank"
+          },
+          null
+        );
+        return { value: { targetId } };
+      }
+      case "closeTab": {
+        const targetId = step.targetId ?? this.page.targetId;
+        await this.page.cdpClient.send("Target.closeTarget", { targetId }, null);
+        return { value: { targetId, closedCurrent: targetId === this.page.targetId } };
+      }
       case "switchFrame": {
         if (!step.selector) throw new Error("switchFrame requires selector");
         await this.page.switchToFrame(step.selector, { timeout, optional });
@@ -771,10 +789,15 @@ var BatchExecutor = class {
           snap: "snapshot",
           accessibility: "snapshot",
           a11y: "snapshot",
+          formslist: "forms",
           image: "screenshot",
           pic: "screenshot",
           frame: "switchFrame",
           iframe: "switchFrame",
+          newtab: "newTab",
+          opentab: "newTab",
+          createtab: "newTab",
+          closetab: "closeTab",
           assert_visible: "assertVisible",
           assert_exists: "assertExists",
           assert_text: "assertText",
@@ -788,7 +811,7 @@ var BatchExecutor = class {
         };
         const suggestion = aliases[action.toLowerCase()];
         const hint = suggestion ? ` Did you mean "${suggestion}"?` : "";
-        const valid = "goto, click, fill, type, select, check, uncheck, submit, press, shortcut, focus, hover, scroll, wait, snapshot, screenshot, evaluate, text, switchFrame, switchToMain, assertVisible, assertExists, assertText, assertUrl, assertValue";
+        const valid = "goto, click, fill, type, select, check, uncheck, submit, press, shortcut, focus, hover, scroll, wait, snapshot, forms, screenshot, evaluate, text, newTab, closeTab, switchFrame, switchToMain, assertVisible, assertExists, assertText, assertUrl, assertValue";
         throw new Error(`Unknown action "${action}".${hint}
 
 Valid actions: ${valid}`);
@@ -859,6 +882,11 @@ var ACTION_ALIASES = {
   pic: "screenshot",
   frame: "switchFrame",
   iframe: "switchFrame",
+  formslist: "forms",
+  newtab: "newTab",
+  opentab: "newTab",
+  createtab: "newTab",
+  closetab: "closeTab",
   assert_visible: "assertVisible",
   assert_exists: "assertExists",
   assert_text: "assertText",
@@ -895,7 +923,8 @@ var PROPERTY_ALIASES = {
   button: "key",
   address: "url",
   page: "url",
-  path: "url"
+  path: "url",
+  tabId: "targetId"
 };
 var ACTION_RULES = {
   goto: {
@@ -996,6 +1025,10 @@ var ACTION_RULES = {
       fullPage: { type: "boolean" }
     }
   },
+  forms: {
+    required: {},
+    optional: {}
+  },
   evaluate: {
     required: { value: { type: "string" } },
     optional: {}
@@ -1010,6 +1043,18 @@ var ACTION_RULES = {
     required: { selector: { type: "string|string[]" } },
     optional: {}
   },
+  newTab: {
+    required: {},
+    optional: {
+      url: { type: "string" }
+    }
+  },
+  closeTab: {
+    required: {},
+    optional: {
+      targetId: { type: "string" }
+    }
+  },
   switchToMain: {
     required: {},
     optional: {}
@@ -1052,6 +1097,7 @@ var KNOWN_STEP_FIELDS = /* @__PURE__ */ new Set([
   "selector",
   "url",
   "value",
+  "targetId",
   "key",
   "combo",
   "modifiers",
@@ -1206,15 +1252,22 @@ function validateSteps(steps) {
     const rule = ACTION_RULES[action];
     for (const key of Object.keys(obj)) {
       if (key === "action") continue;
-      if (!KNOWN_STEP_FIELDS.has(key)) {
-        const suggestion = suggestProperty(key);
-        errors.push({
-          stepIndex: i,
-          field: key,
-          message: suggestion ? `unknown property "${key}". Did you mean "${suggestion}"?` : `unknown property "${key}".`,
-          suggestion: suggestion ? `Did you mean "${suggestion}"?` : void 0
-        });
+      if (KNOWN_STEP_FIELDS.has(key)) continue;
+      const canonical = PROPERTY_ALIASES[key];
+      if (canonical) {
+        if (!(canonical in obj)) {
+          obj[canonical] = obj[key];
+        }
+        delete obj[key];
+        continue;
       }
+      const suggestion = suggestProperty(key);
+      errors.push({
+        stepIndex: i,
+        field: key,
+        message: suggestion ? `unknown property "${key}". Did you mean "${suggestion}"?` : `unknown property "${key}".`,
+        suggestion: suggestion ? `Did you mean "${suggestion}"?` : void 0
+      });
     }
     for (const [field, fieldRule] of Object.entries(rule.required)) {
       if (!(field in obj) || obj[field] === void 0) {

package/dist/actions.d.cts

@@ -1,6 +1,6 @@
-import { y as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-BOPu0OQZ.cjs';
-export { A as ActionType, af as FailureReason, c as StepResult } from './types-BOPu0OQZ.cjs';
-import './client-7Nqka5MV.cjs';
+import { H as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-BXMGFtnB.cjs';
+export { A as ActionType, ai as FailureReason, c as StepResult } from './types-BXMGFtnB.cjs';
+import './client-DRqxBdHv.cjs';
 
 /**
  * Batch action executor

package/dist/actions.d.ts

@@ -1,6 +1,6 @@
-import { y as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-j23Iqo2L.js';
-export { A as ActionType, af as FailureReason, c as StepResult } from './types-j23Iqo2L.js';
-import './client-7Nqka5MV.js';
+import { H as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-CzgQjai9.js';
+export { A as ActionType, ai as FailureReason, c as StepResult } from './types-CzgQjai9.js';
+import './client-DRqxBdHv.js';
 
 /**
  * Batch action executor

package/dist/actions.mjs

@@ -2,7 +2,7 @@ import {
   BatchExecutor,
   addBatchToPage,
   validateSteps
-} from "./chunk-NLIARNEE.mjs";
+} from "./chunk-A2ZRAEO3.mjs";
 import "./chunk-JXAUPHZM.mjs";
 export {
   BatchExecutor,