@mastra/agent-browser 0.0.0 → 0.1.0

package/dist/index.d.cts

@@ -290,7 +290,7 @@ declare const browserSchemas: {
 type BrowserConfig = BrowserConfig$1;
 
 /**
- * AgentBrowserThreadManager - Thread isolation for AgentBrowser
+ * AgentBrowserThreadManager - Thread scope management for AgentBrowser
  *
  * Manages thread-scoped browser sessions using agent-browser's
  * BrowserManager capabilities (newWindow, switchTo, closeTab).
@@ -322,25 +322,14 @@ interface AgentBrowserThreadManagerConfig extends ThreadManagerConfig {
  * - 'thread': Each thread gets a dedicated browser manager instance
  */
 declare class AgentBrowserThreadManager extends ThreadManager<BrowserManager> {
-    private sharedManager;
     private readonly browserConfig;
     private readonly resolveCdpUrl?;
     private readonly onBrowserCreated?;
-    /** Map of thread ID to dedicated browser manager (for 'thread' scope) */
-    private readonly threadBrowsers;
     constructor(config: AgentBrowserThreadManagerConfig);
     /**
-     * Set the shared browser manager (called after browser launch).
+     * Get the page for a specific thread, creating session if needed.
      */
-    setSharedManager(manager: BrowserManager): void;
-    /**
-     * Clear the shared browser manager (called when browser disconnects).
-     */
-    clearSharedManager(): void;
-    /**
-     * Get the shared browser manager.
-     */
-    protected getSharedManager(): BrowserManager;
+    getPageForThread(threadId?: string): Promise<Page>;
     /**
      * Create a new session for a thread.
      */
@@ -349,12 +338,6 @@ declare class AgentBrowserThreadManager extends ThreadManager<BrowserManager> {
      * Restore browser state (multiple tabs) to a browser manager.
      */
     private restoreBrowserState;
-    /**
-     * Switch to an existing session.
-     * For 'thread' scope, no switching needed - each thread has its own manager.
-     * For 'shared' scope, nothing to switch.
-     */
-    protected switchToSession(_session: AgentBrowserSession): Promise<void>;
     /**
      * Get the browser manager for a specific session.
      */
@@ -365,29 +348,9 @@ declare class AgentBrowserThreadManager extends ThreadManager<BrowserManager> {
     protected doDestroySession(session: AgentBrowserSession): Promise<void>;
     /**
      * Destroy all sessions (called during browser close).
+     * doDestroySession handles closing individual browser managers.
      */
     destroyAllSessions(): Promise<void>;
-    /**
-     * Check if any thread browsers are still running.
-     */
-    hasActiveThreadBrowsers(): boolean;
-    /**
-     * Get the browser manager for an existing thread session without creating a new one.
-     * Returns null if no session exists for the thread.
-     */
-    getExistingManagerForThread(threadId: string): BrowserManager | null;
-    /**
-     * Clear all session tracking without closing browsers.
-     * Used when browsers have been externally closed and we just need to reset state.
-     */
-    clearAllSessions(): void;
-    /**
-     * Clear a specific thread's session without closing the browser.
-     * Used when a thread's browser has been externally closed.
-     * Preserves the browser state for potential restoration.
-     * @param threadId - The thread ID to clear
-     */
-    clearSession(threadId: string): void;
 }
 
 /**
@@ -399,13 +362,9 @@ declare class AgentBrowser extends MastraBrowser {
     readonly id: string;
     readonly name = "AgentBrowser";
     readonly provider = "vercel-labs/agent-browser";
-    /** Primary browser manager (for 'none' mode, also used as fallback) */
-    private browserManager;
+    /** Shared browser manager instance (for 'shared' scope) - narrowed type from base class */
+    protected sharedManager: BrowserManager | null;
     private defaultTimeout;
-    /** Active screencast streams per thread (for triggering reconnects on tab changes) */
-    private activeScreencastStreams;
-    /** Default key for shared scope */
-    private static readonly SHARED_STREAM_KEY;
     /** Thread manager - narrowed type from base class */
     protected threadManager: AgentBrowserThreadManager;
     constructor(config?: BrowserConfig);
@@ -413,32 +372,22 @@ declare class AgentBrowser extends MastraBrowser {
      * Ensure browser is ready and thread session exists.
      * Creates a new page/context for the current thread if needed.
      *
-     * For 'browser' isolation, we need to create the thread session BEFORE
+     * For 'thread' scope, we need to create the thread session BEFORE
      * calling super.ensureReady() because the base class's ensureReady() will
      * call checkBrowserAlive(), which needs at least one thread browser to exist.
      */
     ensureReady(): Promise<void>;
     /**
      * Get the browser manager for the current thread.
-     * Delegates to ThreadManager for isolation handling.
+     * Delegates to ThreadManager for scope handling.
      */
     getManagerForThread(threadId?: string): Promise<BrowserManager>;
-    /**
-     * Get the page for a specific thread.
-     * For thread-isolated modes, ensures we're on the correct context/page.
-     */
-    getPageForThread(threadId?: string): Promise<Page>;
-    /**
-     * Close a specific thread's browser session.
-     * Delegates to ThreadManager and notifies registered callbacks.
-     */
-    closeThreadSession(threadId: string): Promise<void>;
     protected doLaunch(): Promise<void>;
     /**
-     * Set up close event listeners for 'none' isolation shared browser.
+     * Set up close event listeners for 'shared' scope browser.
      * This handles the case where the shared browser is closed externally.
      */
-    private setupCloseListenerForNoneIsolation;
+    private setupCloseListenerForSharedScope;
     protected doClose(): Promise<void>;
     /**
      * Check if the browser is still alive by verifying the page is connected.
@@ -458,21 +407,15 @@ declare class AgentBrowser extends MastraBrowser {
      */
     private getPage;
     /**
-     * Handle browser disconnection by clearing internal state.
-     * For 'thread' scope, only notifies the specific thread's callbacks.
-     * For 'shared' scope, notifies all callbacks.
+     * Get the active page for a thread (implements abstract method from base class).
+     * Returns null if no page is available, unlike getPage which throws.
      */
-    handleBrowserDisconnected(): void;
+    protected getActivePage(threadId?: string): Promise<Page | null>;
     /**
      * Set up close event listener for a thread's browser manager.
      * This handles the case where a thread's browser is closed externally.
      */
     private setupCloseListenerForThread;
-    /**
-     * Handle browser disconnection for a specific thread.
-     * Called when a thread's browser is closed externally.
-     */
-    private handleThreadBrowserDisconnected;
     /**
      * Create an error response from an exception.
      * Extends base class to add agent-browser specific error handling.
@@ -494,6 +437,11 @@ declare class AgentBrowser extends MastraBrowser {
      * Get the current browser state (all tabs and active tab index).
      */
     getBrowserState(threadId?: string): Promise<BrowserState | null>;
+    /**
+     * Get browser state for a thread (implements abstract method from base class).
+     * Sync version that uses existing manager lookup without creating sessions.
+     */
+    protected getBrowserStateForThread(threadId?: string): BrowserState | null;
     /**
      * Get browser state from a specific manager instance.
      */
@@ -506,11 +454,6 @@ declare class AgentBrowser extends MastraBrowser {
      * Get the active tab index.
      */
     getActiveTabIndex(threadId?: string): Promise<number>;
-    /**
-     * Update the browser state in the thread session.
-     * Called on navigation, tab open/close to keep state fresh.
-     */
-    private updateSessionBrowserState;
     goto(input: GotoInput, threadId?: string): Promise<{
         success: true;
         url: string;
@@ -602,15 +545,6 @@ declare class AgentBrowser extends MastraBrowser {
         success: true;
         hint: string;
     } | BrowserToolError>;
-    /**
-     * Get the stream key for a thread (or shared key for shared scope).
-     */
-    private getStreamKey;
-    /**
-     * Trigger a screencast reconnect after tab changes.
-     * Called internally when tabs are switched or closed.
-     */
-    private reconnectScreencast;
     startScreencast(_options?: ScreencastOptions): Promise<ScreencastStream>;
     injectMouseEvent(event: MouseEventParams, threadId?: string): Promise<void>;
     injectKeyboardEvent(event: KeyboardEventParams, threadId?: string): Promise<void>;

package/dist/index.d.ts

@@ -290,7 +290,7 @@ declare const browserSchemas: {
 type BrowserConfig = BrowserConfig$1;
 
 /**
- * AgentBrowserThreadManager - Thread isolation for AgentBrowser
+ * AgentBrowserThreadManager - Thread scope management for AgentBrowser
  *
  * Manages thread-scoped browser sessions using agent-browser's
  * BrowserManager capabilities (newWindow, switchTo, closeTab).
@@ -322,25 +322,14 @@ interface AgentBrowserThreadManagerConfig extends ThreadManagerConfig {
  * - 'thread': Each thread gets a dedicated browser manager instance
  */
 declare class AgentBrowserThreadManager extends ThreadManager<BrowserManager> {
-    private sharedManager;
     private readonly browserConfig;
     private readonly resolveCdpUrl?;
     private readonly onBrowserCreated?;
-    /** Map of thread ID to dedicated browser manager (for 'thread' scope) */
-    private readonly threadBrowsers;
     constructor(config: AgentBrowserThreadManagerConfig);
     /**
-     * Set the shared browser manager (called after browser launch).
+     * Get the page for a specific thread, creating session if needed.
      */
-    setSharedManager(manager: BrowserManager): void;
-    /**
-     * Clear the shared browser manager (called when browser disconnects).
-     */
-    clearSharedManager(): void;
-    /**
-     * Get the shared browser manager.
-     */
-    protected getSharedManager(): BrowserManager;
+    getPageForThread(threadId?: string): Promise<Page>;
     /**
      * Create a new session for a thread.
      */
@@ -349,12 +338,6 @@ declare class AgentBrowserThreadManager extends ThreadManager<BrowserManager> {
      * Restore browser state (multiple tabs) to a browser manager.
      */
     private restoreBrowserState;
-    /**
-     * Switch to an existing session.
-     * For 'thread' scope, no switching needed - each thread has its own manager.
-     * For 'shared' scope, nothing to switch.
-     */
-    protected switchToSession(_session: AgentBrowserSession): Promise<void>;
     /**
      * Get the browser manager for a specific session.
      */
@@ -365,29 +348,9 @@ declare class AgentBrowserThreadManager extends ThreadManager<BrowserManager> {
     protected doDestroySession(session: AgentBrowserSession): Promise<void>;
     /**
      * Destroy all sessions (called during browser close).
+     * doDestroySession handles closing individual browser managers.
      */
     destroyAllSessions(): Promise<void>;
-    /**
-     * Check if any thread browsers are still running.
-     */
-    hasActiveThreadBrowsers(): boolean;
-    /**
-     * Get the browser manager for an existing thread session without creating a new one.
-     * Returns null if no session exists for the thread.
-     */
-    getExistingManagerForThread(threadId: string): BrowserManager | null;
-    /**
-     * Clear all session tracking without closing browsers.
-     * Used when browsers have been externally closed and we just need to reset state.
-     */
-    clearAllSessions(): void;
-    /**
-     * Clear a specific thread's session without closing the browser.
-     * Used when a thread's browser has been externally closed.
-     * Preserves the browser state for potential restoration.
-     * @param threadId - The thread ID to clear
-     */
-    clearSession(threadId: string): void;
 }
 
 /**
@@ -399,13 +362,9 @@ declare class AgentBrowser extends MastraBrowser {
     readonly id: string;
     readonly name = "AgentBrowser";
     readonly provider = "vercel-labs/agent-browser";
-    /** Primary browser manager (for 'none' mode, also used as fallback) */
-    private browserManager;
+    /** Shared browser manager instance (for 'shared' scope) - narrowed type from base class */
+    protected sharedManager: BrowserManager | null;
     private defaultTimeout;
-    /** Active screencast streams per thread (for triggering reconnects on tab changes) */
-    private activeScreencastStreams;
-    /** Default key for shared scope */
-    private static readonly SHARED_STREAM_KEY;
     /** Thread manager - narrowed type from base class */
     protected threadManager: AgentBrowserThreadManager;
     constructor(config?: BrowserConfig);
@@ -413,32 +372,22 @@ declare class AgentBrowser extends MastraBrowser {
      * Ensure browser is ready and thread session exists.
      * Creates a new page/context for the current thread if needed.
      *
-     * For 'browser' isolation, we need to create the thread session BEFORE
+     * For 'thread' scope, we need to create the thread session BEFORE
      * calling super.ensureReady() because the base class's ensureReady() will
      * call checkBrowserAlive(), which needs at least one thread browser to exist.
      */
     ensureReady(): Promise<void>;
     /**
      * Get the browser manager for the current thread.
-     * Delegates to ThreadManager for isolation handling.
+     * Delegates to ThreadManager for scope handling.
      */
     getManagerForThread(threadId?: string): Promise<BrowserManager>;
-    /**
-     * Get the page for a specific thread.
-     * For thread-isolated modes, ensures we're on the correct context/page.
-     */
-    getPageForThread(threadId?: string): Promise<Page>;
-    /**
-     * Close a specific thread's browser session.
-     * Delegates to ThreadManager and notifies registered callbacks.
-     */
-    closeThreadSession(threadId: string): Promise<void>;
     protected doLaunch(): Promise<void>;
     /**
-     * Set up close event listeners for 'none' isolation shared browser.
+     * Set up close event listeners for 'shared' scope browser.
      * This handles the case where the shared browser is closed externally.
      */
-    private setupCloseListenerForNoneIsolation;
+    private setupCloseListenerForSharedScope;
     protected doClose(): Promise<void>;
     /**
      * Check if the browser is still alive by verifying the page is connected.
@@ -458,21 +407,15 @@ declare class AgentBrowser extends MastraBrowser {
      */
     private getPage;
     /**
-     * Handle browser disconnection by clearing internal state.
-     * For 'thread' scope, only notifies the specific thread's callbacks.
-     * For 'shared' scope, notifies all callbacks.
+     * Get the active page for a thread (implements abstract method from base class).
+     * Returns null if no page is available, unlike getPage which throws.
      */
-    handleBrowserDisconnected(): void;
+    protected getActivePage(threadId?: string): Promise<Page | null>;
     /**
      * Set up close event listener for a thread's browser manager.
      * This handles the case where a thread's browser is closed externally.
      */
     private setupCloseListenerForThread;
-    /**
-     * Handle browser disconnection for a specific thread.
-     * Called when a thread's browser is closed externally.
-     */
-    private handleThreadBrowserDisconnected;
     /**
      * Create an error response from an exception.
      * Extends base class to add agent-browser specific error handling.
@@ -494,6 +437,11 @@ declare class AgentBrowser extends MastraBrowser {
      * Get the current browser state (all tabs and active tab index).
      */
     getBrowserState(threadId?: string): Promise<BrowserState | null>;
+    /**
+     * Get browser state for a thread (implements abstract method from base class).
+     * Sync version that uses existing manager lookup without creating sessions.
+     */
+    protected getBrowserStateForThread(threadId?: string): BrowserState | null;
     /**
      * Get browser state from a specific manager instance.
      */
@@ -506,11 +454,6 @@ declare class AgentBrowser extends MastraBrowser {
      * Get the active tab index.
      */
     getActiveTabIndex(threadId?: string): Promise<number>;
-    /**
-     * Update the browser state in the thread session.
-     * Called on navigation, tab open/close to keep state fresh.
-     */
-    private updateSessionBrowserState;
     goto(input: GotoInput, threadId?: string): Promise<{
         success: true;
         url: string;
@@ -602,15 +545,6 @@ declare class AgentBrowser extends MastraBrowser {
         success: true;
         hint: string;
     } | BrowserToolError>;
-    /**
-     * Get the stream key for a thread (or shared key for shared scope).
-     */
-    private getStreamKey;
-    /**
-     * Trigger a screencast reconnect after tab changes.
-     * Called internally when tabs are switched or closed.
-     */
-    private reconnectScreencast;
     startScreencast(_options?: ScreencastOptions): Promise<ScreencastStream>;
     injectMouseEvent(event: MouseEventParams, threadId?: string): Promise<void>;
     injectKeyboardEvent(event: KeyboardEventParams, threadId?: string): Promise<void>;