@mastra/agent-browser 0.5.1 → 0.5.2-alpha.1

package/LICENSE.md

@@ -1,10 +1,12 @@
 Portions of this software are licensed as follows:
 
-- All content that resides under any directory named "ee/" within this
+- All content that resides under any directory named `ee/` within this
   repository, including but not limited to:
-  - `packages/core/src/auth/ee/`
-  - `packages/server/src/server/auth/ee/`
-    is licensed under the license defined in `ee/LICENSE`.
+  - `@mastra/core/auth/ee`
+  - `@mastra/core/agent-builder/ee`
+  - `@mastra/editor/ee`
+
+  is licensed under the license defined in [`ee/LICENSE`](https://github.com/mastra-ai/mastra/blob/main/ee/LICENSE).
 
 - All third-party components incorporated into the Mastra Software are
   licensed under the original license provided by the owner of the

package/README.md

@@ -33,106 +33,15 @@ then interact with elements using their refs (e.g., @e5).`,
 const result = await agent.generate('Go to example.com and click the first link');
 ```
 
-## Configuration
-
-```typescript
-const browser = new AgentBrowser({
-  // Run headless (default: true)
-  headless: true,
-
-  // Viewport dimensions
-  viewport: { width: 1280, height: 720 },
-
-  // Default timeout for operations in ms (default: 30000)
-  timeout: 30000,
-
-  // CDP URL for connecting to existing browser
-  cdpUrl: 'ws://localhost:9222',
-
-  // Browser instance scope
-  // Default: 'thread' for local launch, 'shared' when cdpUrl is provided
-  // 'thread': Each thread gets its own browser
-  // 'shared': All threads share one browser
-  scope: 'thread',
-
-  // Screencast settings for Studio
-  screencast: {
-    enabled: true,
-    format: 'jpeg',
-    quality: 80,
-  },
-});
-```
-
-## Tools
-
-AgentBrowser exposes 15 deterministic tools using accessibility tree refs:
-
-### Core Tools
-
-- **browser_goto** - Navigate to a URL
-- **browser_snapshot** - Get accessibility tree with element refs (@e1, @e2, etc.)
-- **browser_click** - Click an element by ref
-- **browser_type** - Type text into an element
-- **browser_press** - Press keyboard keys
-- **browser_select** - Select option from dropdown
-- **browser_scroll** - Scroll the page or element
-- **browser_close** - Close the browser
-
-### Extended Tools
-
-- **browser_hover** - Hover over an element
-- **browser_back** - Go back in browser history
-- **browser_dialog** - Handle browser dialogs (alert, confirm, prompt)
-- **browser_wait** - Wait for element state changes
-- **browser_tabs** - Manage browser tabs (list, new, switch, close)
-- **browser_drag** - Drag and drop elements
-
-### Escape Hatch
-
-- **browser_evaluate** - Execute JavaScript in the page context
-
-## How Refs Work
-
-AgentBrowser uses accessibility tree refs for precise element targeting:
-
-1. Call `browser_snapshot` to get the page structure with refs
-2. Find the element you want to interact with
-3. Use its ref with other tools
-
-```text
-[document] Example Page
-  [banner]
-    [link @e1] Home
-    [link @e2] About
-  [main]
-    [textbox @e3] Search...
-    [button @e4] Submit
-```
-
-```typescript
-// Type in the search box
-{ tool: "browser_type", input: { ref: "@e3", text: "mastra" } }
-
-// Click submit
-{ tool: "browser_click", input: { ref: "@e4" } }
-```
-
-## Comparison with StagehandBrowser
+## Documentation
 
-| Feature     | AgentBrowser             | StagehandBrowser             |
-| ----------- | ------------------------ | ---------------------------- |
-| Approach    | Deterministic refs (@e1) | Natural language             |
-| Token cost  | Low                      | Higher (LLM calls)           |
-| Speed       | Fast                     | Slower                       |
-| Reliability | High (exact refs)        | Variable (AI interpretation) |
-| Best for    | Structured workflows     | Unknown/dynamic pages        |
+- [Agent Browser integration guide](https://mastra.ai/integrations/browsers/agent-browser)
+- [Agent Browser reference](https://mastra.ai/reference/browser/agent-browser)
 
-## Documentation
+## Changelog
 
-- [agent-browser guide](https://mastra.ai/docs/browser/agent-browser) - Usage guide
-- [AgentBrowser reference](https://mastra.ai/reference/browser/agent-browser) - API reference
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/browser/agent-browser/CHANGELOG.md) for version history and release notes.
 
-## License
+## Support
 
-Apache-2.0
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/dist/index.d.cts

@@ -44170,8 +44170,8 @@ interface PageScreenshotOptions {
 declare const gotoInputSchema: z.ZodObject<{
   url: z.ZodString;
   waitUntil: z.ZodOptional<z.ZodEnum<{
-    load: "load";
     domcontentloaded: "domcontentloaded";
+    load: "load";
     networkidle: "networkidle";
   }>>;
   timeout: z.ZodOptional<z.ZodNumber>;
@@ -44192,8 +44192,8 @@ declare const clickInputSchema: z.ZodObject<{
   ref: z.ZodString;
   button: z.ZodOptional<z.ZodEnum<{
     left: "left";
-    right: "right";
     middle: "middle";
+    right: "right";
   }>>;
   clickCount: z.ZodOptional<z.ZodNumber>;
   modifiers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
@@ -44203,8 +44203,8 @@ declare const clickInputSchema: z.ZodObject<{
     Shift: "Shift";
   }>>>;
   waitUntil: z.ZodOptional<z.ZodEnum<{
-    load: "load";
     domcontentloaded: "domcontentloaded";
+    load: "load";
     networkidle: "networkidle";
   }>>;
   timeout: z.ZodOptional<z.ZodNumber>;
@@ -44232,8 +44232,8 @@ declare const pressInputSchema: z.ZodObject<{
     Shift: "Shift";
   }>>>;
   waitUntil: z.ZodOptional<z.ZodEnum<{
-    load: "load";
     domcontentloaded: "domcontentloaded";
+    load: "load";
     networkidle: "networkidle";
   }>>;
   timeout: z.ZodOptional<z.ZodNumber>;
@@ -44248,8 +44248,8 @@ declare const selectInputSchema: z.ZodObject<{
   label: z.ZodOptional<z.ZodString>;
   index: z.ZodOptional<z.ZodNumber>;
   waitUntil: z.ZodOptional<z.ZodEnum<{
-    load: "load";
     domcontentloaded: "domcontentloaded";
+    load: "load";
     networkidle: "networkidle";
   }>>;
   timeout: z.ZodOptional<z.ZodNumber>;
@@ -44260,10 +44260,10 @@ type SelectInput = z.output<typeof selectInputSchema>;
  */
 declare const scrollInputSchema: z.ZodObject<{
   direction: z.ZodEnum<{
+    down: "down";
     left: "left";
     right: "right";
     up: "up";
-    down: "down";
   }>;
   amount: z.ZodOptional<z.ZodNumber>;
   ref: z.ZodOptional<z.ZodString>;
@@ -44304,10 +44304,10 @@ type DialogInput = z.output<typeof dialogInputSchema>;
 declare const waitInputSchema: z.ZodObject<{
   ref: z.ZodOptional<z.ZodString>;
   state: z.ZodOptional<z.ZodEnum<{
-    visible: "visible";
-    hidden: "hidden";
     attached: "attached";
     detached: "detached";
+    hidden: "hidden";
+    visible: "visible";
   }>>;
   timeout: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -44317,10 +44317,10 @@ type WaitInput = z.output<typeof waitInputSchema>;
  */
 declare const tabsInputSchema: z.ZodObject<{
   action: z.ZodEnum<{
+    close: "close";
     list: "list";
     new: "new";
     switch: "switch";
-    close: "close";
   }>;
   index: z.ZodOptional<z.ZodNumber>;
   url: z.ZodOptional<z.ZodString>;
@@ -44355,8 +44355,8 @@ declare const browserSchemas: {
   readonly goto: z.ZodObject<{
     url: z.ZodString;
     waitUntil: z.ZodOptional<z.ZodEnum<{
-      load: "load";
       domcontentloaded: "domcontentloaded";
+      load: "load";
       networkidle: "networkidle";
     }>>;
     timeout: z.ZodOptional<z.ZodNumber>;
@@ -44369,8 +44369,8 @@ declare const browserSchemas: {
     ref: z.ZodString;
     button: z.ZodOptional<z.ZodEnum<{
       left: "left";
-      right: "right";
       middle: "middle";
+      right: "right";
     }>>;
     clickCount: z.ZodOptional<z.ZodNumber>;
     modifiers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
@@ -44380,8 +44380,8 @@ declare const browserSchemas: {
       Shift: "Shift";
     }>>>;
     waitUntil: z.ZodOptional<z.ZodEnum<{
-      load: "load";
       domcontentloaded: "domcontentloaded";
+      load: "load";
       networkidle: "networkidle";
     }>>;
     timeout: z.ZodOptional<z.ZodNumber>;
@@ -44401,8 +44401,8 @@ declare const browserSchemas: {
       Shift: "Shift";
     }>>>;
     waitUntil: z.ZodOptional<z.ZodEnum<{
-      load: "load";
       domcontentloaded: "domcontentloaded";
+      load: "load";
       networkidle: "networkidle";
     }>>;
     timeout: z.ZodOptional<z.ZodNumber>;
@@ -44413,18 +44413,18 @@ declare const browserSchemas: {
     label: z.ZodOptional<z.ZodString>;
     index: z.ZodOptional<z.ZodNumber>;
     waitUntil: z.ZodOptional<z.ZodEnum<{
-      load: "load";
       domcontentloaded: "domcontentloaded";
+      load: "load";
       networkidle: "networkidle";
     }>>;
     timeout: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>;
   readonly scroll: z.ZodObject<{
     direction: z.ZodEnum<{
+      down: "down";
       left: "left";
       right: "right";
       up: "up";
-      down: "down";
     }>;
     amount: z.ZodOptional<z.ZodNumber>;
     ref: z.ZodOptional<z.ZodString>;
@@ -44445,19 +44445,19 @@ declare const browserSchemas: {
   readonly wait: z.ZodObject<{
     ref: z.ZodOptional<z.ZodString>;
     state: z.ZodOptional<z.ZodEnum<{
-      visible: "visible";
-      hidden: "hidden";
       attached: "attached";
       detached: "detached";
+      hidden: "hidden";
+      visible: "visible";
     }>>;
     timeout: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>;
   readonly tabs: z.ZodObject<{
     action: z.ZodEnum<{
+      close: "close";
       list: "list";
       new: "new";
       switch: "switch";
-      close: "close";
     }>;
     index: z.ZodOptional<z.ZodNumber>;
     url: z.ZodOptional<z.ZodString>;
@@ -44482,22 +44482,22 @@ declare const browserSchemas: {
  * Browser Tool Constants
  */
 declare const BROWSER_TOOLS: {
-  readonly GOTO: "browser_goto";
-  readonly SNAPSHOT: "browser_snapshot";
-  readonly CLICK: "browser_click";
-  readonly TYPE: "browser_type";
-  readonly PRESS: "browser_press";
-  readonly SELECT: "browser_select";
-  readonly SCROLL: "browser_scroll";
-  readonly CLOSE: "browser_close";
-  readonly HOVER: "browser_hover";
-  readonly BACK: "browser_back";
-  readonly DIALOG: "browser_dialog";
-  readonly WAIT: "browser_wait";
-  readonly TABS: "browser_tabs";
-  readonly DRAG: "browser_drag";
-  readonly SCREENSHOT: "browser_screenshot";
-  readonly EVALUATE: "browser_evaluate";
+  readonly GOTO: 'browser_goto';
+  readonly SNAPSHOT: 'browser_snapshot';
+  readonly CLICK: 'browser_click';
+  readonly TYPE: 'browser_type';
+  readonly PRESS: 'browser_press';
+  readonly SELECT: 'browser_select';
+  readonly SCROLL: 'browser_scroll';
+  readonly CLOSE: 'browser_close';
+  readonly HOVER: 'browser_hover';
+  readonly BACK: 'browser_back';
+  readonly DIALOG: 'browser_dialog';
+  readonly WAIT: 'browser_wait';
+  readonly TABS: 'browser_tabs';
+  readonly DRAG: 'browser_drag';
+  readonly SCREENSHOT: 'browser_screenshot';
+  readonly EVALUATE: 'browser_evaluate';
 };
 type BrowserToolName = (typeof BROWSER_TOOLS)[keyof typeof BROWSER_TOOLS];
 //#endregion