@mastra/agent-browser 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @mastra/agent-browser
 
+## 0.3.1
+
+### Patch Changes
+
+- Fixed browser state reporting to identify when the agent or user closed the browser or changed the active URL. ([#17631](https://github.com/mastra-ai/mastra/pull/17631))
+
+- Updated dependencies [[`d468acb`](https://github.com/mastra-ai/mastra/commit/d468acb07aec1bb19a2cb0ada8042b05b46746b2), [`575f815`](https://github.com/mastra-ai/mastra/commit/575f815c5c3567b71c0b83cbb7fa98c8253a9d9c), [`34839c1`](https://github.com/mastra-ai/mastra/commit/34839c1910b6964bf59ed0cee58844efebbb684e), [`053735a`](https://github.com/mastra-ai/mastra/commit/053735a75c2c18e23ce34d9468007efa4a45f4c4), [`306909a`](https://github.com/mastra-ai/mastra/commit/306909a693de77d709b38706e2673c9547d24a28), [`5191af8`](https://github.com/mastra-ai/mastra/commit/5191af80c799eea25357c545fc05d91b3883531d), [`43bd3d4`](https://github.com/mastra-ai/mastra/commit/43bd3d421987463fdf35386a45199c49499ed069), [`e6fa79e`](https://github.com/mastra-ai/mastra/commit/e6fa79ec72a2ddffdd25e85270398951e9d552a4), [`904bcdf`](https://github.com/mastra-ai/mastra/commit/904bcdf7b8004aa7be823f9f70ca63580e47e470), [`7f5ee1d`](https://github.com/mastra-ai/mastra/commit/7f5ee1dca46daee8d2817f2ebe49e6335da81956), [`1e9aab5`](https://github.com/mastra-ai/mastra/commit/1e9aab50ff11e6e88fde4d7cbf512c44a9fe8d61), [`2bccba4`](https://github.com/mastra-ai/mastra/commit/2bccba4c03cadc815c2d54cbf4dd43a922140a8d), [`bf8eb6d`](https://github.com/mastra-ai/mastra/commit/bf8eb6d0ec213a403eb9265a594ad283c44ab3dc), [`e9be4e7`](https://github.com/mastra-ai/mastra/commit/e9be4e747ec3d8b65548bff92f9377db06105376), [`493a328`](https://github.com/mastra-ai/mastra/commit/493a328f4346a1deeb9f1e2e44c8f2a3a4d7591b), [`d53cfc2`](https://github.com/mastra-ai/mastra/commit/d53cfc2c7f8d78343a4aa84ec4e129ba25f3325e), [`65799d4`](https://github.com/mastra-ai/mastra/commit/65799d4d549e5ebb9c848fbe3f51ac090f64becf), [`c268c89`](https://github.com/mastra-ai/mastra/commit/c268c89f4c63a93ee474d3cffdf3ea60bf00d4f2), [`34839c1`](https://github.com/mastra-ai/mastra/commit/34839c1910b6964bf59ed0cee58844efebbb684e), [`014e00f`](https://github.com/mastra-ai/mastra/commit/014e00f2b3a597a016b72f9901c6ab27d491f822), [`029a414`](https://github.com/mastra-ai/mastra/commit/029a4141719793bd3e898a39eb5a0466a55f5f3a), [`d468acb`](https://github.com/mastra-ai/mastra/commit/d468acb07aec1bb19a2cb0ada8042b05b46746b2), [`b147b29`](https://github.com/mastra-ai/mastra/commit/b147b2907f0cd1aa812efe6d6e3f58d22e66fc88), [`d371ac1`](https://github.com/mastra-ai/mastra/commit/d371ac1d9820afaaf7cfdbc380a475946a994d8f), [`2bccba4`](https://github.com/mastra-ai/mastra/commit/2bccba4c03cadc815c2d54cbf4dd43a922140a8d), [`0c72f03`](https://github.com/mastra-ai/mastra/commit/0c72f032abb13254df5a7856d64be2f207b8006d), [`cf182b7`](https://github.com/mastra-ai/mastra/commit/cf182b7fb495767946d9840ef29f19cfa906f31f), [`3b45ea9`](https://github.com/mastra-ai/mastra/commit/3b45ea95015557a6cb9d70dc5252af54ab1b78ac), [`a049c2a`](https://github.com/mastra-ai/mastra/commit/a049c2a9dfb41d0ee2e7a28874a88cd64fd5669f), [`f084be1`](https://github.com/mastra-ai/mastra/commit/f084be1fcbe33ad7480913e44d6130c421c0976f), [`b147b29`](https://github.com/mastra-ai/mastra/commit/b147b2907f0cd1aa812efe6d6e3f58d22e66fc88), [`2a96528`](https://github.com/mastra-ai/mastra/commit/2a9652848dfa3c5a2426f952e9d93554c26fd90f), [`f2ab060`](https://github.com/mastra-ai/mastra/commit/f2ab060162bea81505fda553e2cee29c1979fd04), [`5d302c8`](https://github.com/mastra-ai/mastra/commit/5d302c8eda1a6ac74eab5e442c4f64db6cc97a06), [`34839c1`](https://github.com/mastra-ai/mastra/commit/34839c1910b6964bf59ed0cee58844efebbb684e), [`a952852`](https://github.com/mastra-ai/mastra/commit/a952852c971a21fb646cd907c75fcf4443cdc963), [`2656d9c`](https://github.com/mastra-ai/mastra/commit/2656d9c2976d4f3354253bfbbbf9b88a1b2bbf34), [`63e3fe1`](https://github.com/mastra-ai/mastra/commit/63e3fe13cc1ea96f91d7c68aea92f400faf9e4da), [`1d4ce8d`](https://github.com/mastra-ai/mastra/commit/1d4ce8daaa54511f325c1b609d31b8e54009d677), [`8c68372`](https://github.com/mastra-ai/mastra/commit/8c68372e85fe0b066ec12c58bd29ffb93e54c552)]:
+  - @mastra/core@1.42.0
+
+## 0.3.1-alpha.0
+
+### Patch Changes
+
+- Fixed browser state reporting to identify when the agent or user closed the browser or changed the active URL. ([#17631](https://github.com/mastra-ai/mastra/pull/17631))
+
+- Updated dependencies [[`2bccba4`](https://github.com/mastra-ai/mastra/commit/2bccba4c03cadc815c2d54cbf4dd43a922140a8d), [`2bccba4`](https://github.com/mastra-ai/mastra/commit/2bccba4c03cadc815c2d54cbf4dd43a922140a8d), [`f2ab060`](https://github.com/mastra-ai/mastra/commit/f2ab060162bea81505fda553e2cee29c1979fd04), [`5d302c8`](https://github.com/mastra-ai/mastra/commit/5d302c8eda1a6ac74eab5e442c4f64db6cc97a06)]:
+  - @mastra/core@1.42.0-alpha.1
+
 ## 0.3.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -316,13 +316,16 @@ function createCloseTool(browser) {
     inputSchema: closeInputSchema,
     execute: async (_input, { agent }) => {
       const threadId = agent?.threadId;
+      browser.setCurrentThread(threadId);
       if (browser.getScope() !== "shared") {
         if (!threadId) {
           throw new Error("browser_close requires agent.threadId when browser scope is not shared");
         }
+        browser.markBrowserCloseReason("agent", threadId);
         await browser.closeThreadSession(threadId);
         return { success: true, hint: "Thread's browser session closed. A new session will be created on next use." };
       }
+      browser.markBrowserCloseReason("agent");
       await browser.close();
       return { success: true, hint: "Browser closed. It will be re-launched automatically on next use." };
     }
@@ -573,6 +576,8 @@ var AgentBrowser = class extends browser.MastraBrowser {
   defaultTimeout = 3e4;
   /** Pending PID lookups — awaited in disconnect handlers to avoid racing. */
   pidLookups = /* @__PURE__ */ new Set();
+  pendingCloseReasons = /* @__PURE__ */ new Map();
+  activeUrlChangeSources = /* @__PURE__ */ new Map();
   browserConfig;
   constructor(config = {}) {
     super(config);
@@ -641,6 +646,8 @@ var AgentBrowser = class extends browser.MastraBrowser {
   // Lifecycle
   // ---------------------------------------------------------------------------
   async doLaunch() {
+    this.pendingCloseReasons.clear();
+    this.activeUrlChangeSources.clear();
     const scope = this.threadManager.getScope();
     if (scope === "thread") {
       this.sharedManager = new agentBrowser.BrowserManager();
@@ -677,6 +684,7 @@ var AgentBrowser = class extends browser.MastraBrowser {
       const handleDisconnect = () => {
         if (disconnectHandled) return;
         disconnectHandled = true;
+        this.rememberClosedBrowserState(manager, "user");
         void pidLookup.catch(() => void 0).then(() => this.handleBrowserDisconnected());
       };
       const context = manager.getContext();
@@ -706,6 +714,14 @@ var AgentBrowser = class extends browser.MastraBrowser {
     }
     this.sharedManager = null;
   }
+  async closeThreadSession(threadId) {
+    const manager = this.threadManager.getExistingManagerForThread(threadId);
+    if (manager) {
+      const state = this.getBrowserStateForManager(manager, threadId);
+      if (state) this.threadManager.updateBrowserState(threadId, state);
+    }
+    await super.closeThreadSession(threadId);
+  }
   /**
    * Check if the browser is still alive by verifying the page is connected.
    * Called by base class ensureReady() to detect externally closed browsers.
@@ -756,6 +772,32 @@ var AgentBrowser = class extends browser.MastraBrowser {
   // ---------------------------------------------------------------------------
   // Helpers
   // ---------------------------------------------------------------------------
+  browserStateKey(threadId) {
+    return threadId ?? this.getCurrentThread() ?? browser.DEFAULT_THREAD_ID;
+  }
+  markBrowserCloseReason(reason, threadId) {
+    this.pendingCloseReasons.set(this.browserStateKey(threadId), reason);
+  }
+  markActiveUrlChangeSource(source, url, threadId) {
+    this.activeUrlChangeSources.set(this.browserStateKey(threadId), { url, source });
+  }
+  getCloseReason(threadId) {
+    return this.pendingCloseReasons.get(this.browserStateKey(threadId)) ?? this.pendingCloseReasons.get(browser.DEFAULT_THREAD_ID);
+  }
+  getActiveUrlChangeSource(activeUrl, threadId) {
+    const entry = this.activeUrlChangeSources.get(this.browserStateKey(threadId));
+    return entry && entry.url === activeUrl ? entry.source : void 0;
+  }
+  rememberClosedBrowserState(manager, reason, threadId) {
+    const state = this.getBrowserStateForManager(manager, threadId);
+    if (!state || state.tabs.length === 0) return;
+    const closedState = { ...state, closeReason: this.getCloseReason(threadId) ?? reason };
+    if (threadId) {
+      this.threadManager.updateBrowserState(threadId, closedState);
+    } else {
+      this.lastBrowserState = closedState;
+    }
+  }
   /**
    * Get the page for the current thread.
    * Uses thread scope if enabled, otherwise returns the shared page.
@@ -798,6 +840,7 @@ var AgentBrowser = class extends browser.MastraBrowser {
       const handleDisconnect = () => {
         if (disconnectHandled) return;
         disconnectHandled = true;
+        this.rememberClosedBrowserState(manager, "user", threadId);
         void pidLookup.catch(() => void 0).then(() => this.handleThreadBrowserDisconnected(threadId));
       };
       const context = manager.getContext();
@@ -929,12 +972,12 @@ var AgentBrowser = class extends browser.MastraBrowser {
    * Get the current browser state (all tabs and active tab index).
    */
   async getBrowserState(threadId) {
-    if (!this.isBrowserRunning()) {
+    if (!this.isBrowserRunning(threadId)) {
       return null;
     }
     try {
       const manager = await this.getManagerForThread(threadId);
-      return this.getBrowserStateForManager(manager);
+      return this.getBrowserStateForManager(manager, threadId);
     } catch {
       return null;
     }
@@ -947,22 +990,32 @@ var AgentBrowser = class extends browser.MastraBrowser {
     const effectiveThreadId = threadId ?? this.getCurrentThread() ?? browser.DEFAULT_THREAD_ID;
     const manager = this.threadManager.getExistingManagerForThread(effectiveThreadId);
     if (!manager) return null;
-    return this.getBrowserStateForManager(manager);
+    return this.getBrowserStateForManager(manager, effectiveThreadId);
   }
   /**
    * Get browser state from a specific manager instance.
    */
-  getBrowserStateForManager(manager) {
+  getBrowserStateForManager(manager, threadId) {
     try {
+      const stateKey = this.browserStateKey(threadId);
       const pages = manager.getPages();
       const activeIndex = manager.getActiveIndex();
       const tabs = pages.map((page) => ({
         url: page.url()
       }));
-      return {
+      const activeUrl = tabs[activeIndex]?.url;
+      const previousState = this.threadManager.getSavedBrowserState(stateKey) ?? this.lastBrowserState;
+      const previousUrl = previousState?.tabs[previousState.activeTabIndex]?.url;
+      const activeUrlChangeSource = this.getActiveUrlChangeSource(activeUrl, stateKey) ?? (previousUrl && activeUrl !== previousUrl ? "user" : void 0);
+      const state = {
         tabs,
-        activeTabIndex: activeIndex
+        activeTabIndex: activeIndex,
+        ...this.getCloseReason(stateKey) ? { closeReason: this.getCloseReason(stateKey) } : {},
+        ...activeUrlChangeSource ? { activeUrlChangeSource } : {}
       };
+      this.threadManager.updateBrowserState(stateKey, state);
+      this.lastBrowserState = state;
+      return state;
     } catch {
       return null;
     }
@@ -1017,9 +1070,11 @@ var AgentBrowser = class extends browser.MastraBrowser {
         timeout: input.timeout ?? this.defaultTimeout,
         waitUntil: input.waitUntil ?? "domcontentloaded"
       });
+      const url = page.url();
+      this.markActiveUrlChangeSource("agent", url, threadId);
       return {
         success: true,
-        url: page.url(),
+        url,
         title: await page.title(),
         hint: "Take a snapshot to see interactive elements and get refs."
       };
@@ -1306,9 +1361,11 @@ var AgentBrowser = class extends browser.MastraBrowser {
     try {
       const page = await this.getPage(threadId);
       await page.goBack({ timeout: this.defaultTimeout });
+      const url = page.url();
+      this.markActiveUrlChangeSource("agent", url, threadId);
       return {
         success: true,
-        url: page.url(),
+        url,
         title: await page.title(),
         hint: "Take a new snapshot to see the previous page."
       };
@@ -1439,6 +1496,7 @@ var AgentBrowser = class extends browser.MastraBrowser {
           if (input.url) {
             const page = await this.getPage(threadId);
             await page.goto(input.url);
+            this.markActiveUrlChangeSource("agent", page.url(), threadId);
           }
           this.updateSessionBrowserState(threadId);
           return {
@@ -1459,6 +1517,7 @@ var AgentBrowser = class extends browser.MastraBrowser {
           await this.reconnectScreencastForThread(threadId, "tab switch");
           const page = browser.getPage();
           const pageUrl = page.url();
+          this.markActiveUrlChangeSource("agent", pageUrl, threadId);
           const streamKey = this.getStreamKey(threadId);
           const stream = this.activeScreencastStreams.get(streamKey);
           if (pageUrl && stream?.isActive()) {