@mastra/agent-browser 0.3.0-alpha.0 → 0.3.0-alpha.1

package/dist/index.d.cts

@@ -54,6 +54,12 @@ declare const clickInputSchema: z.ZodObject<{
         Meta: "Meta";
         Shift: "Shift";
     }>>>;
+    waitUntil: z.ZodOptional<z.ZodEnum<{
+        load: "load";
+        domcontentloaded: "domcontentloaded";
+        networkidle: "networkidle";
+    }>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type ClickInput = z.output<typeof clickInputSchema>;
 /**
@@ -77,6 +83,12 @@ declare const pressInputSchema: z.ZodObject<{
         Meta: "Meta";
         Shift: "Shift";
     }>>>;
+    waitUntil: z.ZodOptional<z.ZodEnum<{
+        load: "load";
+        domcontentloaded: "domcontentloaded";
+        networkidle: "networkidle";
+    }>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type PressInput = z.output<typeof pressInputSchema>;
 /**
@@ -87,6 +99,12 @@ declare const selectInputSchema: z.ZodObject<{
     value: z.ZodOptional<z.ZodString>;
     label: z.ZodOptional<z.ZodString>;
     index: z.ZodOptional<z.ZodNumber>;
+    waitUntil: z.ZodOptional<z.ZodEnum<{
+        load: "load";
+        domcontentloaded: "domcontentloaded";
+        networkidle: "networkidle";
+    }>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type SelectInput = z.output<typeof selectInputSchema>;
 /**
@@ -213,6 +231,12 @@ declare const browserSchemas: {
             Meta: "Meta";
             Shift: "Shift";
         }>>>;
+        waitUntil: z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     readonly type: z.ZodObject<{
         ref: z.ZodString;
@@ -228,12 +252,24 @@ declare const browserSchemas: {
             Meta: "Meta";
             Shift: "Shift";
         }>>>;
+        waitUntil: z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     readonly select: z.ZodObject<{
         ref: z.ZodString;
         value: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
         index: z.ZodOptional<z.ZodNumber>;
+        waitUntil: z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     readonly scroll: z.ZodObject<{
         direction: z.ZodEnum<{

package/dist/index.d.ts

@@ -54,6 +54,12 @@ declare const clickInputSchema: z.ZodObject<{
         Meta: "Meta";
         Shift: "Shift";
     }>>>;
+    waitUntil: z.ZodOptional<z.ZodEnum<{
+        load: "load";
+        domcontentloaded: "domcontentloaded";
+        networkidle: "networkidle";
+    }>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type ClickInput = z.output<typeof clickInputSchema>;
 /**
@@ -77,6 +83,12 @@ declare const pressInputSchema: z.ZodObject<{
         Meta: "Meta";
         Shift: "Shift";
     }>>>;
+    waitUntil: z.ZodOptional<z.ZodEnum<{
+        load: "load";
+        domcontentloaded: "domcontentloaded";
+        networkidle: "networkidle";
+    }>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type PressInput = z.output<typeof pressInputSchema>;
 /**
@@ -87,6 +99,12 @@ declare const selectInputSchema: z.ZodObject<{
     value: z.ZodOptional<z.ZodString>;
     label: z.ZodOptional<z.ZodString>;
     index: z.ZodOptional<z.ZodNumber>;
+    waitUntil: z.ZodOptional<z.ZodEnum<{
+        load: "load";
+        domcontentloaded: "domcontentloaded";
+        networkidle: "networkidle";
+    }>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type SelectInput = z.output<typeof selectInputSchema>;
 /**
@@ -213,6 +231,12 @@ declare const browserSchemas: {
             Meta: "Meta";
             Shift: "Shift";
         }>>>;
+        waitUntil: z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     readonly type: z.ZodObject<{
         ref: z.ZodString;
@@ -228,12 +252,24 @@ declare const browserSchemas: {
             Meta: "Meta";
             Shift: "Shift";
         }>>>;
+        waitUntil: z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     readonly select: z.ZodObject<{
         ref: z.ZodString;
         value: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
         index: z.ZodOptional<z.ZodNumber>;
+        waitUntil: z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     readonly scroll: z.ZodObject<{
         direction: z.ZodEnum<{

package/dist/index.js

@@ -139,7 +139,9 @@ var clickInputSchema = z.object({
   ref: z.string().describe("Element ref from snapshot (e.g., @e5)"),
   button: z.enum(["left", "right", "middle"]).optional().describe("Mouse button (default: left)"),
   clickCount: z.number().optional().describe("Number of clicks (default: 1, use 2 for double-click)"),
-  modifiers: z.array(z.enum(["Alt", "Control", "Meta", "Shift"])).optional().describe("Modifier keys to hold")
+  modifiers: z.array(z.enum(["Alt", "Control", "Meta", "Shift"])).optional().describe("Modifier keys to hold"),
+  waitUntil: z.enum(["load", "domcontentloaded", "networkidle"]).optional().describe("If the click triggers a navigation, wait for this page load state before returning"),
+  timeout: z.number().nonnegative().optional().describe("Timeout in milliseconds for the click and optional waitUntil")
 });
 var typeInputSchema = z.object({
   ref: z.string().describe("Element ref from snapshot"),
@@ -149,13 +151,17 @@ var typeInputSchema = z.object({
 });
 var pressInputSchema = z.object({
   key: z.string().describe("Key to press (e.g., Enter, Tab, Escape, Control+a)"),
-  modifiers: z.array(z.enum(["Alt", "Control", "Meta", "Shift"])).optional().describe("Modifier keys to hold")
+  modifiers: z.array(z.enum(["Alt", "Control", "Meta", "Shift"])).optional().describe("Modifier keys to hold"),
+  waitUntil: z.enum(["load", "domcontentloaded", "networkidle"]).optional().describe("If the key press triggers a navigation, wait for this page load state before returning"),
+  timeout: z.number().nonnegative().optional().describe("Timeout in milliseconds for the optional waitUntil")
 });
 var selectInputSchema = z.object({
   ref: z.string().describe("Select element ref from snapshot"),
   value: z.string().optional().describe("Option value to select"),
   label: z.string().optional().describe("Option label to select"),
-  index: z.number().int().min(0).optional().describe("Option index to select (0-based)")
+  index: z.number().int().min(0).optional().describe("Option index to select (0-based)"),
+  waitUntil: z.enum(["load", "domcontentloaded", "networkidle"]).optional().describe("If the selection triggers a navigation, wait for this page load state before returning"),
+  timeout: z.number().nonnegative().optional().describe("Timeout in milliseconds for the selection and optional waitUntil")
 }).superRefine((data, ctx) => {
   if (data.value === void 0 && data.label === void 0 && data.index === void 0) {
     ctx.addIssue({
@@ -291,7 +297,7 @@ function createBackTool(browser) {
 function createClickTool(browser) {
   return createTool({
     id: BROWSER_TOOLS.CLICK,
-    description: "Click an element using its ref from a snapshot. Use clickCount: 2 for double-click.",
+    description: "Click an element using its ref from a snapshot. Use clickCount: 2 for double-click. Pass waitUntil when the click triggers navigation so the page settles before the next snapshot.",
     inputSchema: clickInputSchema,
     execute: async (input, { agent }) => {
       const threadId = agent?.threadId;
@@ -388,7 +394,7 @@ function createHoverTool(browser) {
 function createPressTool(browser) {
   return createTool({
     id: BROWSER_TOOLS.PRESS,
-    description: "Press a keyboard key (e.g., Enter, Tab, Escape, Control+a).",
+    description: "Press a keyboard key (e.g., Enter, Tab, Escape, Control+a). Pass waitUntil when the keypress triggers navigation (e.g., Enter to submit a form) so the page settles before the next snapshot.",
     inputSchema: pressInputSchema,
     execute: async (input, { agent }) => {
       const threadId = agent?.threadId;
@@ -446,7 +452,7 @@ function createScrollTool(browser) {
 function createSelectTool(browser) {
   return createTool({
     id: BROWSER_TOOLS.SELECT,
-    description: "Select an option from a dropdown by value, label, or index.",
+    description: "Select an option from a dropdown by value, label, or index. Pass waitUntil when the selection triggers navigation so the page settles before the next snapshot.",
     inputSchema: selectInputSchema,
     execute: async (input, { agent }) => {
       const threadId = agent?.threadId;
@@ -1089,12 +1095,15 @@ var AgentBrowser = class extends MastraBrowser {
           "Take a new snapshot to see the current page state and get fresh refs."
         );
       }
+      const timeout = input.timeout ?? this.defaultTimeout;
+      const navigation = input.waitUntil ? page.waitForNavigation({ waitUntil: input.waitUntil, timeout }) : void 0;
       await locator.click({
         button: input.button ?? "left",
         clickCount: input.clickCount ?? 1,
         modifiers: input.modifiers,
-        timeout: this.defaultTimeout
+        timeout
       });
+      await navigation;
       return {
         success: true,
         url: page.url(),
@@ -1163,7 +1172,10 @@ var AgentBrowser = class extends MastraBrowser {
   async press(input, threadId) {
     try {
       const page = await this.getPage(threadId);
+      const timeout = input.timeout ?? this.defaultTimeout;
+      const navigation = input.waitUntil ? page.waitForNavigation({ waitUntil: input.waitUntil, timeout }) : void 0;
       await page.keyboard.press(input.key);
+      await navigation;
       return {
         success: true,
         url: page.url(),
@@ -1191,9 +1203,10 @@ var AgentBrowser = class extends MastraBrowser {
       if (input.value) selectValue.value = input.value;
       if (input.label) selectValue.label = input.label;
       if (input.index !== void 0) selectValue.index = input.index;
-      const selected = await locator.selectOption(selectValue, {
-        timeout: this.defaultTimeout
-      });
+      const timeout = input.timeout ?? this.defaultTimeout;
+      const navigation = input.waitUntil ? page.waitForNavigation({ waitUntil: input.waitUntil, timeout }) : void 0;
+      const selected = await locator.selectOption(selectValue, { timeout });
+      await navigation;
       return {
         success: true,
         selected,