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

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { BrowserConfig as BrowserConfig$1, ThreadManager, ThreadManagerConfig, ThreadSession, MastraBrowser, BrowserToolError, BrowserState, BrowserTabState, ScreencastOptions, ScreencastStream, MouseEventParams, KeyboardEventParams } from '@mastra/core/browser';
+import { BrowserConfig as BrowserConfig$1, ThreadManager, ThreadManagerConfig, ThreadSession, BrowserState, MastraBrowser, BrowserToolError, BrowserTabState, ScreencastOptions, ScreencastStream, MouseEventParams, KeyboardEventParams } from '@mastra/core/browser';
 import { Tool } from '@mastra/core/tools';
 import { BrowserManager } from 'agent-browser';
 import { Page } from 'playwright-core';
@@ -376,6 +376,11 @@ interface AgentBrowserThreadManagerConfig extends ThreadManagerConfig {
     /** Callback when a new browser manager is created for a thread */
     onBrowserCreated?: (manager: BrowserManager, threadId: string) => void;
 }
+/**
+ * Factory for custom thread managers (e.g. Firecrawl-hosted CDP per session).
+ * Defaults to {@link AgentBrowserThreadManager} when omitted.
+ */
+type CreateAgentBrowserThreadManager = (config: AgentBrowserThreadManagerConfig) => AgentBrowserThreadManager;
 /**
  * Thread manager implementation for AgentBrowser.
  *
@@ -384,9 +389,9 @@ interface AgentBrowserThreadManagerConfig extends ThreadManagerConfig {
  * - 'thread': Each thread gets a dedicated browser manager instance
  */
 declare class AgentBrowserThreadManager extends ThreadManager<BrowserManager> {
-    private readonly browserConfig;
+    protected readonly browserConfig: BrowserConfig;
     private readonly resolveCdpUrl?;
-    private readonly onBrowserCreated?;
+    protected readonly onBrowserCreated?: (manager: BrowserManager, threadId: string) => void;
     constructor(config: AgentBrowserThreadManagerConfig);
     /**
      * Get the page for a specific thread, creating session if needed.
@@ -399,7 +404,7 @@ declare class AgentBrowserThreadManager extends ThreadManager<BrowserManager> {
     /**
      * Restore browser state (multiple tabs) to a browser manager.
      */
-    private restoreBrowserState;
+    protected restoreBrowserState(manager: BrowserManager, state: BrowserState): Promise<void>;
     /**
      * Get the browser manager for a specific session.
      */
@@ -415,6 +420,10 @@ declare class AgentBrowserThreadManager extends ThreadManager<BrowserManager> {
     destroyAllSessions(): Promise<void>;
 }
 
+/** AgentBrowser accepts an optional thread-manager factory (see {@link CreateAgentBrowserThreadManager}). */
+type AgentBrowserConfig = BrowserConfig & {
+    createThreadManager?: CreateAgentBrowserThreadManager;
+};
 /**
  * AgentBrowser - Browser automation using agent-browser (vercel-labs/agent-browser)
  *
@@ -422,8 +431,8 @@ declare class AgentBrowserThreadManager extends ThreadManager<BrowserManager> {
  */
 declare class AgentBrowser extends MastraBrowser {
     readonly id: string;
-    readonly name = "AgentBrowser";
-    readonly provider = "vercel-labs/agent-browser";
+    readonly name: string;
+    readonly provider: string;
     /** Shared browser manager instance (for 'shared' scope) - narrowed type from base class */
     protected sharedManager: BrowserManager | null;
     private defaultTimeout;
@@ -432,7 +441,7 @@ declare class AgentBrowser extends MastraBrowser {
     /** Thread manager - narrowed type from base class */
     protected threadManager: AgentBrowserThreadManager;
     private browserConfig;
-    constructor(config?: BrowserConfig);
+    constructor(config?: AgentBrowserConfig);
     /**
      * Ensure browser is ready and thread session exists.
      * Creates a new page/context for the current thread if needed.
@@ -452,7 +461,7 @@ declare class AgentBrowser extends MastraBrowser {
      * Set up close event listeners for 'shared' scope browser.
      * This handles the case where the shared browser is closed externally.
      */
-    private setupCloseListenerForSharedScope;
+    protected setupCloseListenerForSharedScope(manager: BrowserManager): void;
     protected doClose(): Promise<void>;
     /**
      * Check if the browser is still alive by verifying the page is connected.
@@ -652,4 +661,4 @@ declare function getBrowserPid(manager: BrowserManager): Promise<number | undefi
  */
 declare function createAgentBrowserTools(browser: AgentBrowser): Record<string, Tool<any, any>>;
 
-export { AgentBrowser, BROWSER_TOOLS, type BackInput, type BrowserConfig, type BrowserToolName, type ClickInput, type CloseInput, type DialogInput, type DragInput, type EvaluateInput, type GotoInput, type HoverInput, type PressInput, type ScrollInput, type SelectInput, type SnapshotInput, type TabsInput, type TypeInput, type WaitInput, backInputSchema, browserSchemas, clickInputSchema, closeInputSchema, createAgentBrowserTools, dialogInputSchema, dragInputSchema, evaluateInputSchema, getBrowserPid, gotoInputSchema, hoverInputSchema, pressInputSchema, scrollInputSchema, selectInputSchema, snapshotInputSchema, tabsInputSchema, typeInputSchema, waitInputSchema };
+export { AgentBrowser, type AgentBrowserConfig, type AgentBrowserSession, AgentBrowserThreadManager, type AgentBrowserThreadManagerConfig, BROWSER_TOOLS, type BackInput, type BrowserConfig, type BrowserToolName, type ClickInput, type CloseInput, type CreateAgentBrowserThreadManager, type DialogInput, type DragInput, type EvaluateInput, type GotoInput, type HoverInput, type PressInput, type ScrollInput, type SelectInput, type SnapshotInput, type TabsInput, type TypeInput, type WaitInput, backInputSchema, browserSchemas, clickInputSchema, closeInputSchema, createAgentBrowserTools, dialogInputSchema, dragInputSchema, evaluateInputSchema, getBrowserPid, gotoInputSchema, hoverInputSchema, pressInputSchema, scrollInputSchema, selectInputSchema, snapshotInputSchema, tabsInputSchema, typeInputSchema, waitInputSchema };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BrowserConfig as BrowserConfig$1, ThreadManager, ThreadManagerConfig, ThreadSession, MastraBrowser, BrowserToolError, BrowserState, BrowserTabState, ScreencastOptions, ScreencastStream, MouseEventParams, KeyboardEventParams } from '@mastra/core/browser';
+import { BrowserConfig as BrowserConfig$1, ThreadManager, ThreadManagerConfig, ThreadSession, BrowserState, MastraBrowser, BrowserToolError, BrowserTabState, ScreencastOptions, ScreencastStream, MouseEventParams, KeyboardEventParams } from '@mastra/core/browser';
 import { Tool } from '@mastra/core/tools';
 import { BrowserManager } from 'agent-browser';
 import { Page } from 'playwright-core';
@@ -376,6 +376,11 @@ interface AgentBrowserThreadManagerConfig extends ThreadManagerConfig {
     /** Callback when a new browser manager is created for a thread */
     onBrowserCreated?: (manager: BrowserManager, threadId: string) => void;
 }
+/**
+ * Factory for custom thread managers (e.g. Firecrawl-hosted CDP per session).
+ * Defaults to {@link AgentBrowserThreadManager} when omitted.
+ */
+type CreateAgentBrowserThreadManager = (config: AgentBrowserThreadManagerConfig) => AgentBrowserThreadManager;
 /**
  * Thread manager implementation for AgentBrowser.
  *
@@ -384,9 +389,9 @@ interface AgentBrowserThreadManagerConfig extends ThreadManagerConfig {
  * - 'thread': Each thread gets a dedicated browser manager instance
  */
 declare class AgentBrowserThreadManager extends ThreadManager<BrowserManager> {
-    private readonly browserConfig;
+    protected readonly browserConfig: BrowserConfig;
     private readonly resolveCdpUrl?;
-    private readonly onBrowserCreated?;
+    protected readonly onBrowserCreated?: (manager: BrowserManager, threadId: string) => void;
     constructor(config: AgentBrowserThreadManagerConfig);
     /**
      * Get the page for a specific thread, creating session if needed.
@@ -399,7 +404,7 @@ declare class AgentBrowserThreadManager extends ThreadManager<BrowserManager> {
     /**
      * Restore browser state (multiple tabs) to a browser manager.
      */
-    private restoreBrowserState;
+    protected restoreBrowserState(manager: BrowserManager, state: BrowserState): Promise<void>;
     /**
      * Get the browser manager for a specific session.
      */
@@ -415,6 +420,10 @@ declare class AgentBrowserThreadManager extends ThreadManager<BrowserManager> {
     destroyAllSessions(): Promise<void>;
 }
 
+/** AgentBrowser accepts an optional thread-manager factory (see {@link CreateAgentBrowserThreadManager}). */
+type AgentBrowserConfig = BrowserConfig & {
+    createThreadManager?: CreateAgentBrowserThreadManager;
+};
 /**
  * AgentBrowser - Browser automation using agent-browser (vercel-labs/agent-browser)
  *
@@ -422,8 +431,8 @@ declare class AgentBrowserThreadManager extends ThreadManager<BrowserManager> {
  */
 declare class AgentBrowser extends MastraBrowser {
     readonly id: string;
-    readonly name = "AgentBrowser";
-    readonly provider = "vercel-labs/agent-browser";
+    readonly name: string;
+    readonly provider: string;
     /** Shared browser manager instance (for 'shared' scope) - narrowed type from base class */
     protected sharedManager: BrowserManager | null;
     private defaultTimeout;
@@ -432,7 +441,7 @@ declare class AgentBrowser extends MastraBrowser {
     /** Thread manager - narrowed type from base class */
     protected threadManager: AgentBrowserThreadManager;
     private browserConfig;
-    constructor(config?: BrowserConfig);
+    constructor(config?: AgentBrowserConfig);
     /**
      * Ensure browser is ready and thread session exists.
      * Creates a new page/context for the current thread if needed.
@@ -452,7 +461,7 @@ declare class AgentBrowser extends MastraBrowser {
      * Set up close event listeners for 'shared' scope browser.
      * This handles the case where the shared browser is closed externally.
      */
-    private setupCloseListenerForSharedScope;
+    protected setupCloseListenerForSharedScope(manager: BrowserManager): void;
     protected doClose(): Promise<void>;
     /**
      * Check if the browser is still alive by verifying the page is connected.
@@ -652,4 +661,4 @@ declare function getBrowserPid(manager: BrowserManager): Promise<number | undefi
  */
 declare function createAgentBrowserTools(browser: AgentBrowser): Record<string, Tool<any, any>>;
 
-export { AgentBrowser, BROWSER_TOOLS, type BackInput, type BrowserConfig, type BrowserToolName, type ClickInput, type CloseInput, type DialogInput, type DragInput, type EvaluateInput, type GotoInput, type HoverInput, type PressInput, type ScrollInput, type SelectInput, type SnapshotInput, type TabsInput, type TypeInput, type WaitInput, backInputSchema, browserSchemas, clickInputSchema, closeInputSchema, createAgentBrowserTools, dialogInputSchema, dragInputSchema, evaluateInputSchema, getBrowserPid, gotoInputSchema, hoverInputSchema, pressInputSchema, scrollInputSchema, selectInputSchema, snapshotInputSchema, tabsInputSchema, typeInputSchema, waitInputSchema };
+export { AgentBrowser, type AgentBrowserConfig, type AgentBrowserSession, AgentBrowserThreadManager, type AgentBrowserThreadManagerConfig, BROWSER_TOOLS, type BackInput, type BrowserConfig, type BrowserToolName, type ClickInput, type CloseInput, type CreateAgentBrowserThreadManager, type DialogInput, type DragInput, type EvaluateInput, type GotoInput, type HoverInput, type PressInput, type ScrollInput, type SelectInput, type SnapshotInput, type TabsInput, type TypeInput, type WaitInput, backInputSchema, browserSchemas, clickInputSchema, closeInputSchema, createAgentBrowserTools, dialogInputSchema, dragInputSchema, evaluateInputSchema, getBrowserPid, gotoInputSchema, hoverInputSchema, pressInputSchema, scrollInputSchema, selectInputSchema, snapshotInputSchema, tabsInputSchema, typeInputSchema, waitInputSchema };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { MastraBrowser, DEFAULT_THREAD_ID, ScreencastStreamImpl, ThreadManager } from '@mastra/core/browser';
+import { ThreadManager, MastraBrowser, DEFAULT_THREAD_ID, ScreencastStreamImpl } from '@mastra/core/browser';
 import { BrowserManager } from 'agent-browser';
 import { createTool } from '@mastra/core/tools';
 import { z } from 'zod';
@@ -574,7 +574,7 @@ var AgentBrowser = class extends MastraBrowser {
       this.defaultTimeout = config.timeout;
     }
     const effectiveScope = config.cdpUrl ? config.scope ?? "shared" : config.scope ?? "thread";
-    this.threadManager = new AgentBrowserThreadManager({
+    const threadManagerConfig = {
       scope: effectiveScope,
       browserConfig: { ...config, headless: this.headless },
       resolveCdpUrl: this.resolveCdpUrl.bind(this),
@@ -587,7 +587,9 @@ var AgentBrowser = class extends MastraBrowser {
       onBrowserCreated: (manager, threadId) => {
         this.setupCloseListenerForThread(manager, threadId);
       }
-    });
+    };
+    const createTm = config.createThreadManager ?? ((opts) => new AgentBrowserThreadManager(opts));
+    this.threadManager = createTm(threadManagerConfig);
   }
   // ---------------------------------------------------------------------------
   // Thread Scope (delegated to ThreadManager)
@@ -1684,6 +1686,6 @@ var AgentBrowser = class extends MastraBrowser {
   }
 };
 
-export { AgentBrowser, BROWSER_TOOLS, backInputSchema, browserSchemas, clickInputSchema, closeInputSchema, createAgentBrowserTools, dialogInputSchema, dragInputSchema, evaluateInputSchema, getBrowserPid, gotoInputSchema, hoverInputSchema, pressInputSchema, scrollInputSchema, selectInputSchema, snapshotInputSchema, tabsInputSchema, typeInputSchema, waitInputSchema };
+export { AgentBrowser, AgentBrowserThreadManager, BROWSER_TOOLS, backInputSchema, browserSchemas, clickInputSchema, closeInputSchema, createAgentBrowserTools, dialogInputSchema, dragInputSchema, evaluateInputSchema, getBrowserPid, gotoInputSchema, hoverInputSchema, pressInputSchema, scrollInputSchema, selectInputSchema, snapshotInputSchema, tabsInputSchema, typeInputSchema, waitInputSchema };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map