@mastra/browser-firecrawl 0.2.5-alpha.0 → 0.2.5-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/dist/index.cjs +3 -6
  2. package/dist/index.cjs.map +1 -1
  3. package/dist/index.d.cts +0 -8
  4. package/dist/index.d.cts.map +1 -1
  5. package/dist/index.d.ts +0 -8
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/index.js +3 -6
  8. package/dist/index.js.map +1 -1
  9. package/package.json +9 -9
package/dist/index.cjs CHANGED
@@ -3,7 +3,7 @@ let _mastra_agent_browser = require("@mastra/agent-browser");
3
3
  let _mastra_core_browser = require("@mastra/core/browser");
4
4
  let agent_browser = require("agent-browser");
5
5
  let firecrawl = require("firecrawl");
6
- //#region src/firecrawl-thread-manager.ts
6
+ // src/firecrawl-thread-manager.ts
7
7
  /**
8
8
  * Provisions a dedicated Firecrawl Browser Sandbox session per Mastra thread and connects Playwright over CDP.
9
9
  */
@@ -99,8 +99,7 @@ var FirecrawlAgentBrowserThreadManager = class extends _mastra_agent_browser.Age
99
99
  } catch {}
100
100
  }
101
101
  };
102
- //#endregion
103
- //#region src/resolve-cdp.ts
102
+ // src/resolve-cdp.ts
104
103
  /**
105
104
  * Resolve an HTTP CDP endpoint to a WebSocket URL (same behavior as MastraBrowser.resolveWebSocketUrl).
106
105
  */
@@ -127,8 +126,7 @@ async function resolveCdpWebSocketUrl(url, logger) {
127
126
  }
128
127
  return url;
129
128
  }
130
- //#endregion
131
- //#region src/firecrawl-browser.ts
129
+ // src/firecrawl-browser.ts
132
130
  function pickSessionOpts(c) {
133
131
  return c.firecrawl ?? {};
134
132
  }
@@ -242,7 +240,6 @@ var FirecrawlBrowser = class extends _mastra_agent_browser.AgentBrowser {
242
240
  }
243
241
  }
244
242
  };
245
- //#endregion
246
243
  exports.FirecrawlAgentBrowserThreadManager = FirecrawlAgentBrowserThreadManager;
247
244
  exports.FirecrawlBrowser = FirecrawlBrowser;
248
245
  exports.resolveCdpWebSocketUrl = resolveCdpWebSocketUrl;
package/dist/index.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["AgentBrowserThreadManager","BrowserManager","resolveViewportSize","DEFAULT_BROWSER_VIEWPORT","AgentBrowser","Firecrawl","BrowserManager","resolveViewportSize","DEFAULT_BROWSER_VIEWPORT"],"sources":["../src/firecrawl-thread-manager.ts","../src/resolve-cdp.ts","../src/firecrawl-browser.ts"],"sourcesContent":["import type { AgentBrowserSession, AgentBrowserThreadManagerConfig } from '@mastra/agent-browser';\nimport { AgentBrowserThreadManager } from '@mastra/agent-browser';\nimport { resolveViewportSize, DEFAULT_BROWSER_VIEWPORT } from '@mastra/core/browser';\nimport type { BrowserLaunchOptions } from 'agent-browser';\nimport { BrowserManager } from 'agent-browser';\nimport type { Firecrawl } from 'firecrawl';\nimport type { FirecrawlBrowserSessionOptions } from './types';\n\n/**\n * Thread session with Firecrawl sandbox id for cleanup.\n */\nexport interface FirecrawlAgentBrowserSession extends AgentBrowserSession {\n firecrawlSessionId?: string;\n}\n\nexport interface FirecrawlAgentBrowserThreadManagerConfig extends AgentBrowserThreadManagerConfig {\n firecrawl: Firecrawl;\n /** Resolve HTTP CDP URL to WebSocket URL. */\n resolveWebSocketUrl: (url: string) => Promise<string>;\n /** Options for each `firecrawl.browser()` call (thread scope = one call per thread). */\n sessionOptions?: FirecrawlBrowserSessionOptions;\n}\n\n/**\n * Provisions a dedicated Firecrawl Browser Sandbox session per Mastra thread and connects Playwright over CDP.\n */\nexport class FirecrawlAgentBrowserThreadManager extends AgentBrowserThreadManager {\n private readonly firecrawl: Firecrawl;\n private readonly resolveWebSocketUrl: (url: string) => Promise<string>;\n private readonly sessionOptions: FirecrawlBrowserSessionOptions;\n\n constructor(config: FirecrawlAgentBrowserThreadManagerConfig) {\n super(config);\n this.firecrawl = config.firecrawl;\n this.resolveWebSocketUrl = config.resolveWebSocketUrl;\n this.sessionOptions = config.sessionOptions ?? {};\n }\n\n protected override async createSession(threadId: string): Promise<FirecrawlAgentBrowserSession> {\n const savedState = this.getSavedBrowserState(threadId);\n\n const session: FirecrawlAgentBrowserSession = {\n threadId,\n createdAt: Date.now(),\n browserState: savedState,\n };\n\n if (this.scope === 'thread') {\n const createRes = await this.firecrawl.browser({\n ttl: this.sessionOptions.ttl,\n activityTtl: this.sessionOptions.activityTtl,\n streamWebView: this.sessionOptions.streamWebView,\n profile: this.sessionOptions.profile,\n integration: this.sessionOptions.integration,\n origin: this.sessionOptions.origin,\n });\n\n if (!createRes.success || !createRes.id || !createRes.cdpUrl) {\n const msg = createRes.error ?? 'Firecrawl browser session creation failed';\n const err = new Error(`Firecrawl browser(): ${msg}`);\n if (createRes.id) {\n try {\n await this.firecrawl.deleteBrowser(createRes.id);\n } catch (cleanupErr) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);\n }\n }\n throw err;\n }\n\n session.firecrawlSessionId = createRes.id;\n\n const manager = new BrowserManager();\n\n const wsUrl = await this.resolveWebSocketUrl(createRes.cdpUrl);\n\n const launchOptions: BrowserLaunchOptions = {\n headless: this.browserConfig.headless ?? true,\n viewport: resolveViewportSize(this.browserConfig.viewport) ?? DEFAULT_BROWSER_VIEWPORT,\n profile: this.browserConfig.profile,\n executablePath: this.browserConfig.executablePath,\n storageState: this.browserConfig.storageState,\n cdpUrl: wsUrl,\n };\n\n try {\n await manager.launch(launchOptions);\n } catch (error) {\n try {\n await manager.close();\n } catch {\n // ignore\n }\n try {\n await this.firecrawl.deleteBrowser(createRes.id);\n } catch {\n // ignore\n }\n throw error;\n }\n\n session.manager = manager;\n this.threadManagers.set(threadId, manager);\n\n try {\n if (savedState && savedState.tabs.length > 0) {\n this.logger?.debug?.(`Restoring browser state for thread ${threadId}: ${savedState.tabs.length} tabs`);\n await this.restoreBrowserState(manager, savedState);\n }\n this.onBrowserCreated?.(manager, threadId);\n } catch (error) {\n this.threadManagers.delete(threadId);\n session.manager = undefined;\n try {\n await manager.close();\n } catch {\n // ignore\n }\n if (session.firecrawlSessionId) {\n try {\n await this.firecrawl.deleteBrowser(session.firecrawlSessionId);\n } catch {\n // ignore\n }\n }\n throw error;\n }\n }\n\n return session;\n }\n\n protected override async doDestroySession(session: FirecrawlAgentBrowserSession): Promise<void> {\n if (this.scope === 'thread' && session.manager) {\n try {\n await session.manager.close();\n } catch {\n // ignore\n }\n this.threadManagers.delete(session.threadId);\n }\n\n if (session.firecrawlSessionId) {\n try {\n await this.firecrawl.deleteBrowser(session.firecrawlSessionId);\n } catch {\n // ignore\n }\n }\n }\n}\n","/**\n * Resolve an HTTP CDP endpoint to a WebSocket URL (same behavior as MastraBrowser.resolveWebSocketUrl).\n */\nexport async function resolveCdpWebSocketUrl(\n url: string,\n logger?: { debug?: (message: string) => void; warn?: (message: string) => void },\n): Promise<string> {\n if (url.startsWith('ws://') || url.startsWith('wss://')) {\n return url;\n }\n\n if (url.startsWith('http://') || url.startsWith('https://')) {\n const baseUrl = url.replace(/\\/$/, '');\n const versionUrl = `${baseUrl}/json/version`;\n\n logger?.debug?.(`Resolving WebSocket URL from ${versionUrl}`);\n\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), 10000);\n\n try {\n const response = await fetch(versionUrl, { signal: controller.signal });\n\n if (!response.ok) {\n throw new Error(\n `Failed to fetch CDP version info from ${versionUrl}: ${response.status} ${response.statusText}`,\n );\n }\n\n const data = (await response.json()) as { webSocketDebuggerUrl?: string };\n if (!data.webSocketDebuggerUrl) {\n throw new Error(`No webSocketDebuggerUrl found in CDP version response from ${versionUrl}`);\n }\n\n logger?.debug?.(`Resolved WebSocket URL: ${data.webSocketDebuggerUrl}`);\n return data.webSocketDebuggerUrl;\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n throw new Error(`Timeout resolving WebSocket URL from ${versionUrl} (10s)`);\n }\n throw error;\n } finally {\n clearTimeout(timeoutId);\n }\n }\n\n return url;\n}\n","import type { AgentBrowserConfig } from '@mastra/agent-browser';\nimport { AgentBrowser } from '@mastra/agent-browser';\nimport { resolveViewportSize, DEFAULT_BROWSER_VIEWPORT } from '@mastra/core/browser';\nimport type { BrowserLaunchOptions } from 'agent-browser';\nimport { BrowserManager } from 'agent-browser';\nimport { Firecrawl } from 'firecrawl';\nimport { FirecrawlAgentBrowserThreadManager } from './firecrawl-thread-manager';\nimport { resolveCdpWebSocketUrl } from './resolve-cdp';\nimport type { FirecrawlBrowserConfig, FirecrawlBrowserSessionOptions } from './types';\n\nfunction pickSessionOpts(c: FirecrawlBrowserConfig): FirecrawlBrowserSessionOptions {\n return c.firecrawl ?? {};\n}\n\nfunction toBaseConfig(config: FirecrawlBrowserConfig): AgentBrowserConfig {\n const { apiKey: _a, apiUrl: _u, firecrawl: _f, ...rest } = config;\n return rest;\n}\n\n/**\n * Mastra browser provider backed by [Firecrawl Browser Sandbox](https://docs.firecrawl.dev/features/browser):\n * provisions remote sessions via API and drives them with the same deterministic tools as {@link AgentBrowser}.\n */\nexport class FirecrawlBrowser extends AgentBrowser {\n override readonly name = 'FirecrawlBrowser';\n override readonly provider = 'firecrawl/browser-sandbox';\n\n /** Narrowed from base `MastraBrowser` (`unknown`) — same pattern as {@link AgentBrowser}. */\n declare protected sharedManager: BrowserManager | null;\n\n private readonly firecrawl: Firecrawl;\n private readonly sessionOpts: FirecrawlBrowserSessionOptions;\n private sharedFirecrawlSessionId?: string;\n\n constructor(config: FirecrawlBrowserConfig) {\n const apiKey = config.apiKey ?? process.env.FIRECRAWL_API_KEY;\n if (!apiKey) {\n throw new Error('FirecrawlBrowser requires `apiKey` or FIRECRAWL_API_KEY');\n }\n const fc = new Firecrawl({ apiKey, apiUrl: config.apiUrl });\n const sessionOpts = pickSessionOpts(config);\n\n super({\n ...toBaseConfig(config),\n createThreadManager: opts =>\n new FirecrawlAgentBrowserThreadManager({\n ...opts,\n firecrawl: fc,\n resolveWebSocketUrl: url => resolveCdpWebSocketUrl(url, opts.logger),\n sessionOptions: sessionOpts,\n }),\n });\n this.firecrawl = fc;\n this.sessionOpts = sessionOpts;\n }\n\n /**\n * Firecrawl always drives a remote browser over CDP, including per-thread\n * sessions, so its PID must never be captured (issue #23588).\n */\n protected override isRemoteThreadBrowser(): boolean {\n return true;\n }\n\n protected override async doLaunch(): Promise<void> {\n const scope = this.threadManager.getScope();\n if (scope === 'thread') {\n await super.doLaunch();\n return;\n }\n\n const createRes = await this.firecrawl.browser({\n ttl: this.sessionOpts.ttl,\n activityTtl: this.sessionOpts.activityTtl,\n streamWebView: this.sessionOpts.streamWebView,\n profile: this.sessionOpts.profile,\n integration: this.sessionOpts.integration,\n origin: this.sessionOpts.origin,\n });\n\n if (!createRes.success || !createRes.id || !createRes.cdpUrl) {\n const msg = createRes.error ?? 'Firecrawl browser session creation failed';\n const err = new Error(`Firecrawl browser(): ${msg}`);\n if (createRes.id) {\n try {\n await this.firecrawl.deleteBrowser(createRes.id);\n } catch (cleanupErr) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);\n }\n }\n throw err;\n }\n\n const sessionId = createRes.id;\n this.sharedManager = new BrowserManager();\n\n try {\n const localConfig = this.config as AgentBrowserConfig;\n const wsUrl = await resolveCdpWebSocketUrl(createRes.cdpUrl, this.logger);\n\n const launchOptions: BrowserLaunchOptions = {\n headless: localConfig.headless ?? true,\n // Firecrawl drives a remote browser, so there is no local window to\n // match; `'window'` falls back to the default dimensions.\n viewport: resolveViewportSize(localConfig.viewport) ?? DEFAULT_BROWSER_VIEWPORT,\n profile: localConfig.profile,\n executablePath: localConfig.executablePath,\n storageState: localConfig.storageState,\n cdpUrl: wsUrl,\n };\n\n await this.sharedManager.launch(launchOptions);\n this.threadManager.setSharedManager(this.sharedManager);\n // Firecrawl always drives a remote browser over CDP — never capture its\n // PID (issue #23588); it belongs to Firecrawl's host, not ours.\n this.setupCloseListenerForSharedScope(this.sharedManager, true);\n this.sharedFirecrawlSessionId = sessionId;\n } catch (launchErr) {\n try {\n await this.sharedManager.close();\n } catch (closeErr) {\n this.logger?.warn?.(`BrowserManager.close() after failed shared launch: ${closeErr}`);\n }\n try {\n await this.firecrawl.deleteBrowser(sessionId);\n } catch (delErr) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${sessionId}) after failed shared launch: ${delErr}`);\n }\n this.sharedManager = null;\n this.sharedFirecrawlSessionId = undefined;\n throw launchErr;\n }\n }\n\n protected override async doClose(): Promise<void> {\n const sid = this.sharedFirecrawlSessionId;\n await super.doClose();\n if (sid) {\n try {\n await this.firecrawl.deleteBrowser(sid);\n } catch (err) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${sid}) failed: ${err}`);\n }\n this.sharedFirecrawlSessionId = undefined;\n }\n }\n}\n"],"mappings":";;;;;;;;;AA0BA,IAAa,qCAAb,cAAwDA,sBAAAA,0BAA0B;CAChF;CACA;CACA;CAEA,YAAY,QAAkD;EAC5D,MAAM,MAAM;EACZ,KAAK,YAAY,OAAO;EACxB,KAAK,sBAAsB,OAAO;EAClC,KAAK,iBAAiB,OAAO,kBAAkB,CAAC;CAClD;CAEA,MAAyB,cAAc,UAAyD;EAC9F,MAAM,aAAa,KAAK,qBAAqB,QAAQ;EAErD,MAAM,UAAwC;GAC5C;GACA,WAAW,KAAK,IAAI;GACpB,cAAc;EAChB;EAEA,IAAI,KAAK,UAAU,UAAU;GAC3B,MAAM,YAAY,MAAM,KAAK,UAAU,QAAQ;IAC7C,KAAK,KAAK,eAAe;IACzB,aAAa,KAAK,eAAe;IACjC,eAAe,KAAK,eAAe;IACnC,SAAS,KAAK,eAAe;IAC7B,aAAa,KAAK,eAAe;IACjC,QAAQ,KAAK,eAAe;GAC9B,CAAC;GAED,IAAI,CAAC,UAAU,WAAW,CAAC,UAAU,MAAM,CAAC,UAAU,QAAQ;IAC5D,MAAM,MAAM,UAAU,SAAS;IAC/B,MAAM,sBAAM,IAAI,MAAM,wBAAwB,KAAK;IACnD,IAAI,UAAU,IACZ,IAAI;KACF,MAAM,KAAK,UAAU,cAAc,UAAU,EAAE;IACjD,SAAS,YAAY;KACnB,KAAK,QAAQ,OAAO,2BAA2B,UAAU,GAAG,4BAA4B,YAAY;IACtG;IAEF,MAAM;GACR;GAEA,QAAQ,qBAAqB,UAAU;GAEvC,MAAM,UAAU,IAAIC,cAAAA,eAAe;GAEnC,MAAM,QAAQ,MAAM,KAAK,oBAAoB,UAAU,MAAM;GAE7D,MAAM,gBAAsC;IAC1C,UAAU,KAAK,cAAc,YAAY;IACzC,WAAA,GAAUC,qBAAAA,oBAAAA,CAAoB,KAAK,cAAc,QAAQ,KAAKC,qBAAAA;IAC9D,SAAS,KAAK,cAAc;IAC5B,gBAAgB,KAAK,cAAc;IACnC,cAAc,KAAK,cAAc;IACjC,QAAQ;GACV;GAEA,IAAI;IACF,MAAM,QAAQ,OAAO,aAAa;GACpC,SAAS,OAAO;IACd,IAAI;KACF,MAAM,QAAQ,MAAM;IACtB,QAAQ,CAER;IACA,IAAI;KACF,MAAM,KAAK,UAAU,cAAc,UAAU,EAAE;IACjD,QAAQ,CAER;IACA,MAAM;GACR;GAEA,QAAQ,UAAU;GAClB,KAAK,eAAe,IAAI,UAAU,OAAO;GAEzC,IAAI;IACF,IAAI,cAAc,WAAW,KAAK,SAAS,GAAG;KAC5C,KAAK,QAAQ,QAAQ,sCAAsC,SAAS,IAAI,WAAW,KAAK,OAAO,MAAM;KACrG,MAAM,KAAK,oBAAoB,SAAS,UAAU;IACpD;IACA,KAAK,mBAAmB,SAAS,QAAQ;GAC3C,SAAS,OAAO;IACd,KAAK,eAAe,OAAO,QAAQ;IACnC,QAAQ,UAAU,KAAA;IAClB,IAAI;KACF,MAAM,QAAQ,MAAM;IACtB,QAAQ,CAER;IACA,IAAI,QAAQ,oBACV,IAAI;KACF,MAAM,KAAK,UAAU,cAAc,QAAQ,kBAAkB;IAC/D,QAAQ,CAER;IAEF,MAAM;GACR;EACF;EAEA,OAAO;CACT;CAEA,MAAyB,iBAAiB,SAAsD;EAC9F,IAAI,KAAK,UAAU,YAAY,QAAQ,SAAS;GAC9C,IAAI;IACF,MAAM,QAAQ,QAAQ,MAAM;GAC9B,QAAQ,CAER;GACA,KAAK,eAAe,OAAO,QAAQ,QAAQ;EAC7C;EAEA,IAAI,QAAQ,oBACV,IAAI;GACF,MAAM,KAAK,UAAU,cAAc,QAAQ,kBAAkB;EAC/D,QAAQ,CAER;CAEJ;AACF;;;;;;ACnJA,eAAsB,uBACpB,KACA,QACiB;CACjB,IAAI,IAAI,WAAW,OAAO,KAAK,IAAI,WAAW,QAAQ,GACpD,OAAO;CAGT,IAAI,IAAI,WAAW,SAAS,KAAK,IAAI,WAAW,UAAU,GAAG;EAE3D,MAAM,aAAa,GADH,IAAI,QAAQ,OAAO,EACP,EAAE;EAE9B,QAAQ,QAAQ,gCAAgC,YAAY;EAE5D,MAAM,aAAa,IAAI,gBAAgB;EACvC,MAAM,YAAY,iBAAiB,WAAW,MAAM,GAAG,GAAK;EAE5D,IAAI;GACF,MAAM,WAAW,MAAM,MAAM,YAAY,EAAE,QAAQ,WAAW,OAAO,CAAC;GAEtE,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,MACR,yCAAyC,WAAW,IAAI,SAAS,OAAO,GAAG,SAAS,YACtF;GAGF,MAAM,OAAQ,MAAM,SAAS,KAAK;GAClC,IAAI,CAAC,KAAK,sBACR,MAAM,IAAI,MAAM,8DAA8D,YAAY;GAG5F,QAAQ,QAAQ,2BAA2B,KAAK,sBAAsB;GACtE,OAAO,KAAK;EACd,SAAS,OAAO;GACd,IAAI,iBAAiB,SAAS,MAAM,SAAS,cAC3C,MAAM,IAAI,MAAM,wCAAwC,WAAW,OAAO;GAE5E,MAAM;EACR,UAAU;GACR,aAAa,SAAS;EACxB;CACF;CAEA,OAAO;AACT;;;ACrCA,SAAS,gBAAgB,GAA2D;CAClF,OAAO,EAAE,aAAa,CAAC;AACzB;AAEA,SAAS,aAAa,QAAoD;CACxE,MAAM,EAAE,QAAQ,IAAI,QAAQ,IAAI,WAAW,IAAI,GAAG,SAAS;CAC3D,OAAO;AACT;;;;;AAMA,IAAa,mBAAb,cAAsCC,sBAAAA,aAAa;CACjD,OAAyB;CACzB,WAA6B;CAK7B;CACA;CACA;CAEA,YAAY,QAAgC;EAC1C,MAAM,SAAS,OAAO,UAAU,QAAQ,IAAI;EAC5C,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,yDAAyD;EAE3E,MAAM,KAAK,IAAIC,UAAAA,UAAU;GAAE;GAAQ,QAAQ,OAAO;EAAO,CAAC;EAC1D,MAAM,cAAc,gBAAgB,MAAM;EAE1C,MAAM;GACJ,GAAG,aAAa,MAAM;GACtB,sBAAqB,SACnB,IAAI,mCAAmC;IACrC,GAAG;IACH,WAAW;IACX,sBAAqB,QAAO,uBAAuB,KAAK,KAAK,MAAM;IACnE,gBAAgB;GAClB,CAAC;EACL,CAAC;EACD,KAAK,YAAY;EACjB,KAAK,cAAc;CACrB;;;;;CAMA,wBAAoD;EAClD,OAAO;CACT;CAEA,MAAyB,WAA0B;EAEjD,IADc,KAAK,cAAc,SACzB,MAAM,UAAU;GACtB,MAAM,MAAM,SAAS;GACrB;EACF;EAEA,MAAM,YAAY,MAAM,KAAK,UAAU,QAAQ;GAC7C,KAAK,KAAK,YAAY;GACtB,aAAa,KAAK,YAAY;GAC9B,eAAe,KAAK,YAAY;GAChC,SAAS,KAAK,YAAY;GAC1B,aAAa,KAAK,YAAY;GAC9B,QAAQ,KAAK,YAAY;EAC3B,CAAC;EAED,IAAI,CAAC,UAAU,WAAW,CAAC,UAAU,MAAM,CAAC,UAAU,QAAQ;GAC5D,MAAM,MAAM,UAAU,SAAS;GAC/B,MAAM,sBAAM,IAAI,MAAM,wBAAwB,KAAK;GACnD,IAAI,UAAU,IACZ,IAAI;IACF,MAAM,KAAK,UAAU,cAAc,UAAU,EAAE;GACjD,SAAS,YAAY;IACnB,KAAK,QAAQ,OAAO,2BAA2B,UAAU,GAAG,4BAA4B,YAAY;GACtG;GAEF,MAAM;EACR;EAEA,MAAM,YAAY,UAAU;EAC5B,KAAK,gBAAgB,IAAIC,cAAAA,eAAe;EAExC,IAAI;GACF,MAAM,cAAc,KAAK;GACzB,MAAM,QAAQ,MAAM,uBAAuB,UAAU,QAAQ,KAAK,MAAM;GAExE,MAAM,gBAAsC;IAC1C,UAAU,YAAY,YAAY;IAGlC,WAAA,GAAUC,qBAAAA,oBAAAA,CAAoB,YAAY,QAAQ,KAAKC,qBAAAA;IACvD,SAAS,YAAY;IACrB,gBAAgB,YAAY;IAC5B,cAAc,YAAY;IAC1B,QAAQ;GACV;GAEA,MAAM,KAAK,cAAc,OAAO,aAAa;GAC7C,KAAK,cAAc,iBAAiB,KAAK,aAAa;GAGtD,KAAK,iCAAiC,KAAK,eAAe,IAAI;GAC9D,KAAK,2BAA2B;EAClC,SAAS,WAAW;GAClB,IAAI;IACF,MAAM,KAAK,cAAc,MAAM;GACjC,SAAS,UAAU;IACjB,KAAK,QAAQ,OAAO,sDAAsD,UAAU;GACtF;GACA,IAAI;IACF,MAAM,KAAK,UAAU,cAAc,SAAS;GAC9C,SAAS,QAAQ;IACf,KAAK,QAAQ,OAAO,2BAA2B,UAAU,gCAAgC,QAAQ;GACnG;GACA,KAAK,gBAAgB;GACrB,KAAK,2BAA2B,KAAA;GAChC,MAAM;EACR;CACF;CAEA,MAAyB,UAAyB;EAChD,MAAM,MAAM,KAAK;EACjB,MAAM,MAAM,QAAQ;EACpB,IAAI,KAAK;GACP,IAAI;IACF,MAAM,KAAK,UAAU,cAAc,GAAG;GACxC,SAAS,KAAK;IACZ,KAAK,QAAQ,OAAO,2BAA2B,IAAI,YAAY,KAAK;GACtE;GACA,KAAK,2BAA2B,KAAA;EAClC;CACF;AACF"}
1
+ {"version":3,"file":"index.cjs","names":["AgentBrowserThreadManager","BrowserManager","resolveViewportSize","DEFAULT_BROWSER_VIEWPORT","AgentBrowser","Firecrawl","BrowserManager","resolveViewportSize","DEFAULT_BROWSER_VIEWPORT"],"sources":["../src/firecrawl-thread-manager.ts","../src/resolve-cdp.ts","../src/firecrawl-browser.ts"],"sourcesContent":["import type { AgentBrowserSession, AgentBrowserThreadManagerConfig } from '@mastra/agent-browser';\nimport { AgentBrowserThreadManager } from '@mastra/agent-browser';\nimport { resolveViewportSize, DEFAULT_BROWSER_VIEWPORT } from '@mastra/core/browser';\nimport type { BrowserLaunchOptions } from 'agent-browser';\nimport { BrowserManager } from 'agent-browser';\nimport type { Firecrawl } from 'firecrawl';\nimport type { FirecrawlBrowserSessionOptions } from './types';\n\n/**\n * Thread session with Firecrawl sandbox id for cleanup.\n */\nexport interface FirecrawlAgentBrowserSession extends AgentBrowserSession {\n firecrawlSessionId?: string;\n}\n\nexport interface FirecrawlAgentBrowserThreadManagerConfig extends AgentBrowserThreadManagerConfig {\n firecrawl: Firecrawl;\n /** Resolve HTTP CDP URL to WebSocket URL. */\n resolveWebSocketUrl: (url: string) => Promise<string>;\n /** Options for each `firecrawl.browser()` call (thread scope = one call per thread). */\n sessionOptions?: FirecrawlBrowserSessionOptions;\n}\n\n/**\n * Provisions a dedicated Firecrawl Browser Sandbox session per Mastra thread and connects Playwright over CDP.\n */\nexport class FirecrawlAgentBrowserThreadManager extends AgentBrowserThreadManager {\n private readonly firecrawl: Firecrawl;\n private readonly resolveWebSocketUrl: (url: string) => Promise<string>;\n private readonly sessionOptions: FirecrawlBrowserSessionOptions;\n\n constructor(config: FirecrawlAgentBrowserThreadManagerConfig) {\n super(config);\n this.firecrawl = config.firecrawl;\n this.resolveWebSocketUrl = config.resolveWebSocketUrl;\n this.sessionOptions = config.sessionOptions ?? {};\n }\n\n protected override async createSession(threadId: string): Promise<FirecrawlAgentBrowserSession> {\n const savedState = this.getSavedBrowserState(threadId);\n\n const session: FirecrawlAgentBrowserSession = {\n threadId,\n createdAt: Date.now(),\n browserState: savedState,\n };\n\n if (this.scope === 'thread') {\n const createRes = await this.firecrawl.browser({\n ttl: this.sessionOptions.ttl,\n activityTtl: this.sessionOptions.activityTtl,\n streamWebView: this.sessionOptions.streamWebView,\n profile: this.sessionOptions.profile,\n integration: this.sessionOptions.integration,\n origin: this.sessionOptions.origin,\n });\n\n if (!createRes.success || !createRes.id || !createRes.cdpUrl) {\n const msg = createRes.error ?? 'Firecrawl browser session creation failed';\n const err = new Error(`Firecrawl browser(): ${msg}`);\n if (createRes.id) {\n try {\n await this.firecrawl.deleteBrowser(createRes.id);\n } catch (cleanupErr) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);\n }\n }\n throw err;\n }\n\n session.firecrawlSessionId = createRes.id;\n\n const manager = new BrowserManager();\n\n const wsUrl = await this.resolveWebSocketUrl(createRes.cdpUrl);\n\n const launchOptions: BrowserLaunchOptions = {\n headless: this.browserConfig.headless ?? true,\n viewport: resolveViewportSize(this.browserConfig.viewport) ?? DEFAULT_BROWSER_VIEWPORT,\n profile: this.browserConfig.profile,\n executablePath: this.browserConfig.executablePath,\n storageState: this.browserConfig.storageState,\n cdpUrl: wsUrl,\n };\n\n try {\n await manager.launch(launchOptions);\n } catch (error) {\n try {\n await manager.close();\n } catch {\n // ignore\n }\n try {\n await this.firecrawl.deleteBrowser(createRes.id);\n } catch {\n // ignore\n }\n throw error;\n }\n\n session.manager = manager;\n this.threadManagers.set(threadId, manager);\n\n try {\n if (savedState && savedState.tabs.length > 0) {\n this.logger?.debug?.(`Restoring browser state for thread ${threadId}: ${savedState.tabs.length} tabs`);\n await this.restoreBrowserState(manager, savedState);\n }\n this.onBrowserCreated?.(manager, threadId);\n } catch (error) {\n this.threadManagers.delete(threadId);\n session.manager = undefined;\n try {\n await manager.close();\n } catch {\n // ignore\n }\n if (session.firecrawlSessionId) {\n try {\n await this.firecrawl.deleteBrowser(session.firecrawlSessionId);\n } catch {\n // ignore\n }\n }\n throw error;\n }\n }\n\n return session;\n }\n\n protected override async doDestroySession(session: FirecrawlAgentBrowserSession): Promise<void> {\n if (this.scope === 'thread' && session.manager) {\n try {\n await session.manager.close();\n } catch {\n // ignore\n }\n this.threadManagers.delete(session.threadId);\n }\n\n if (session.firecrawlSessionId) {\n try {\n await this.firecrawl.deleteBrowser(session.firecrawlSessionId);\n } catch {\n // ignore\n }\n }\n }\n}\n","/**\n * Resolve an HTTP CDP endpoint to a WebSocket URL (same behavior as MastraBrowser.resolveWebSocketUrl).\n */\nexport async function resolveCdpWebSocketUrl(\n url: string,\n logger?: { debug?: (message: string) => void; warn?: (message: string) => void },\n): Promise<string> {\n if (url.startsWith('ws://') || url.startsWith('wss://')) {\n return url;\n }\n\n if (url.startsWith('http://') || url.startsWith('https://')) {\n const baseUrl = url.replace(/\\/$/, '');\n const versionUrl = `${baseUrl}/json/version`;\n\n logger?.debug?.(`Resolving WebSocket URL from ${versionUrl}`);\n\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), 10000);\n\n try {\n const response = await fetch(versionUrl, { signal: controller.signal });\n\n if (!response.ok) {\n throw new Error(\n `Failed to fetch CDP version info from ${versionUrl}: ${response.status} ${response.statusText}`,\n );\n }\n\n const data = (await response.json()) as { webSocketDebuggerUrl?: string };\n if (!data.webSocketDebuggerUrl) {\n throw new Error(`No webSocketDebuggerUrl found in CDP version response from ${versionUrl}`);\n }\n\n logger?.debug?.(`Resolved WebSocket URL: ${data.webSocketDebuggerUrl}`);\n return data.webSocketDebuggerUrl;\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n throw new Error(`Timeout resolving WebSocket URL from ${versionUrl} (10s)`);\n }\n throw error;\n } finally {\n clearTimeout(timeoutId);\n }\n }\n\n return url;\n}\n","import type { AgentBrowserConfig } from '@mastra/agent-browser';\nimport { AgentBrowser } from '@mastra/agent-browser';\nimport { resolveViewportSize, DEFAULT_BROWSER_VIEWPORT } from '@mastra/core/browser';\nimport type { BrowserLaunchOptions } from 'agent-browser';\nimport { BrowserManager } from 'agent-browser';\nimport { Firecrawl } from 'firecrawl';\nimport { FirecrawlAgentBrowserThreadManager } from './firecrawl-thread-manager';\nimport { resolveCdpWebSocketUrl } from './resolve-cdp';\nimport type { FirecrawlBrowserConfig, FirecrawlBrowserSessionOptions } from './types';\n\nfunction pickSessionOpts(c: FirecrawlBrowserConfig): FirecrawlBrowserSessionOptions {\n return c.firecrawl ?? {};\n}\n\nfunction toBaseConfig(config: FirecrawlBrowserConfig): AgentBrowserConfig {\n const { apiKey: _a, apiUrl: _u, firecrawl: _f, ...rest } = config;\n return rest;\n}\n\n/**\n * Mastra browser provider backed by [Firecrawl Browser Sandbox](https://docs.firecrawl.dev/features/browser):\n * provisions remote sessions via API and drives them with the same deterministic tools as {@link AgentBrowser}.\n */\nexport class FirecrawlBrowser extends AgentBrowser {\n override readonly name = 'FirecrawlBrowser';\n override readonly provider = 'firecrawl/browser-sandbox';\n\n /** Narrowed from base `MastraBrowser` (`unknown`) — same pattern as {@link AgentBrowser}. */\n declare protected sharedManager: BrowserManager | null;\n\n private readonly firecrawl: Firecrawl;\n private readonly sessionOpts: FirecrawlBrowserSessionOptions;\n private sharedFirecrawlSessionId?: string;\n\n constructor(config: FirecrawlBrowserConfig) {\n const apiKey = config.apiKey ?? process.env.FIRECRAWL_API_KEY;\n if (!apiKey) {\n throw new Error('FirecrawlBrowser requires `apiKey` or FIRECRAWL_API_KEY');\n }\n const fc = new Firecrawl({ apiKey, apiUrl: config.apiUrl });\n const sessionOpts = pickSessionOpts(config);\n\n super({\n ...toBaseConfig(config),\n createThreadManager: opts =>\n new FirecrawlAgentBrowserThreadManager({\n ...opts,\n firecrawl: fc,\n resolveWebSocketUrl: url => resolveCdpWebSocketUrl(url, opts.logger),\n sessionOptions: sessionOpts,\n }),\n });\n this.firecrawl = fc;\n this.sessionOpts = sessionOpts;\n }\n\n /**\n * Firecrawl always drives a remote browser over CDP, including per-thread\n * sessions, so its PID must never be captured (issue #23588).\n */\n protected override isRemoteThreadBrowser(): boolean {\n return true;\n }\n\n protected override async doLaunch(): Promise<void> {\n const scope = this.threadManager.getScope();\n if (scope === 'thread') {\n await super.doLaunch();\n return;\n }\n\n const createRes = await this.firecrawl.browser({\n ttl: this.sessionOpts.ttl,\n activityTtl: this.sessionOpts.activityTtl,\n streamWebView: this.sessionOpts.streamWebView,\n profile: this.sessionOpts.profile,\n integration: this.sessionOpts.integration,\n origin: this.sessionOpts.origin,\n });\n\n if (!createRes.success || !createRes.id || !createRes.cdpUrl) {\n const msg = createRes.error ?? 'Firecrawl browser session creation failed';\n const err = new Error(`Firecrawl browser(): ${msg}`);\n if (createRes.id) {\n try {\n await this.firecrawl.deleteBrowser(createRes.id);\n } catch (cleanupErr) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);\n }\n }\n throw err;\n }\n\n const sessionId = createRes.id;\n this.sharedManager = new BrowserManager();\n\n try {\n const localConfig = this.config as AgentBrowserConfig;\n const wsUrl = await resolveCdpWebSocketUrl(createRes.cdpUrl, this.logger);\n\n const launchOptions: BrowserLaunchOptions = {\n headless: localConfig.headless ?? true,\n // Firecrawl drives a remote browser, so there is no local window to\n // match; `'window'` falls back to the default dimensions.\n viewport: resolveViewportSize(localConfig.viewport) ?? DEFAULT_BROWSER_VIEWPORT,\n profile: localConfig.profile,\n executablePath: localConfig.executablePath,\n storageState: localConfig.storageState,\n cdpUrl: wsUrl,\n };\n\n await this.sharedManager.launch(launchOptions);\n this.threadManager.setSharedManager(this.sharedManager);\n // Firecrawl always drives a remote browser over CDP — never capture its\n // PID (issue #23588); it belongs to Firecrawl's host, not ours.\n this.setupCloseListenerForSharedScope(this.sharedManager, true);\n this.sharedFirecrawlSessionId = sessionId;\n } catch (launchErr) {\n try {\n await this.sharedManager.close();\n } catch (closeErr) {\n this.logger?.warn?.(`BrowserManager.close() after failed shared launch: ${closeErr}`);\n }\n try {\n await this.firecrawl.deleteBrowser(sessionId);\n } catch (delErr) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${sessionId}) after failed shared launch: ${delErr}`);\n }\n this.sharedManager = null;\n this.sharedFirecrawlSessionId = undefined;\n throw launchErr;\n }\n }\n\n protected override async doClose(): Promise<void> {\n const sid = this.sharedFirecrawlSessionId;\n await super.doClose();\n if (sid) {\n try {\n await this.firecrawl.deleteBrowser(sid);\n } catch (err) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${sid}) failed: ${err}`);\n }\n this.sharedFirecrawlSessionId = undefined;\n }\n }\n}\n"],"mappings":"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"}
package/dist/index.d.cts CHANGED
@@ -1,7 +1,6 @@
1
1
  import { AgentBrowser, AgentBrowserConfig, AgentBrowserSession, AgentBrowserThreadManager, AgentBrowserThreadManagerConfig } from "@mastra/agent-browser";
2
2
  import { BrowserManager } from "agent-browser";
3
3
  import { Firecrawl } from "firecrawl";
4
- //#region src/types.d.ts
5
4
  /**
6
5
  * Options passed to Firecrawl `POST /v2/browser` (see Firecrawl JS SDK `browser()`).
7
6
  *
@@ -40,8 +39,6 @@ type FirecrawlBrowserConfig = AgentBrowserConfig & {
40
39
  */
41
40
  firecrawl?: FirecrawlBrowserSessionOptions;
42
41
  };
43
- //#endregion
44
- //#region src/firecrawl-browser.d.ts
45
42
  /**
46
43
  * Mastra browser provider backed by [Firecrawl Browser Sandbox](https://docs.firecrawl.dev/features/browser):
47
44
  * provisions remote sessions via API and drives them with the same deterministic tools as {@link AgentBrowser}.
@@ -63,8 +60,6 @@ export declare class FirecrawlBrowser extends AgentBrowser {
63
60
  protected doLaunch(): Promise<void>;
64
61
  protected doClose(): Promise<void>;
65
62
  }
66
- //#endregion
67
- //#region src/firecrawl-thread-manager.d.ts
68
63
  /**
69
64
  * Thread session with Firecrawl sandbox id for cleanup.
70
65
  */
@@ -89,8 +84,6 @@ export declare class FirecrawlAgentBrowserThreadManager extends AgentBrowserThre
89
84
  protected createSession(threadId: string): Promise<FirecrawlAgentBrowserSession>;
90
85
  protected doDestroySession(session: FirecrawlAgentBrowserSession): Promise<void>;
91
86
  }
92
- //#endregion
93
- //#region src/resolve-cdp.d.ts
94
87
  /**
95
88
  * Resolve an HTTP CDP endpoint to a WebSocket URL (same behavior as MastraBrowser.resolveWebSocketUrl).
96
89
  */
@@ -98,6 +91,5 @@ export declare function resolveCdpWebSocketUrl(url: string, logger?: {
98
91
  debug?: (message: string) => void;
99
92
  warn?: (message: string) => void;
100
93
  }): Promise<string>;
101
- //#endregion
102
94
  export type { FirecrawlAgentBrowserSession, FirecrawlAgentBrowserThreadManagerConfig, FirecrawlBrowserConfig, FirecrawlBrowserSessionOptions };
103
95
  //# sourceMappingURL=index.d.cts.map
package/dist/index.d.cts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/firecrawl-browser.ts","../src/firecrawl-thread-manager.ts","../src/resolve-cdp.ts"],"mappings":";;;;;;;;;;;UASiB;;EAEf;;EAEA;;EAEA;;EAEA;;IAEE;;IAEA;;;EAGF;;EAEA;;;KAIU,yBAAyB;;EAEnC;;EAEA;;;;;EAKA,YAAY;;;;;;;;qBChBD,yBAAyB;WAClB;WACA;;YAGA,eAAe;mBAEhB;mBACA;UACT;EAER,YAAY,QAAQ;;;;;YA0BD;YAIM,YAAY;YAsEZ,WAAW;;;;;;;UC3HrB,qCAAqC;EACpD;;UAGe,iDAAiD;EAChE,WAAW;;EAEX,sBAAsB,gBAAgB;;EAEtC,iBAAiB;;;;;qBAMN,2CAA2C;mBACrC;mBACA;mBACA;EAEjB,YAAY,QAAQ;YAOK,cAAc,mBAAmB,QAAQ;YA8FzC,iBAAiB,SAAS,+BAA+B;;;;;;;wBCjI9D,uBACpB,aACA;EAAW,SAAS;EAA0B,QAAQ;IACrD"}
1
+ {"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/firecrawl-browser.ts","../src/firecrawl-thread-manager.ts","../src/resolve-cdp.ts"],"mappings":";;;;;;;;;;UASiB;;EAEf;;EAEA;;EAEA;;EAEA;;IAEE;;IAEA;;;EAGF;;EAEA;;;KAIU,yBAAyB;;EAEnC;;EAEA;;;;;EAKA,YAAY;;;;;;qBChBD,yBAAyB;WAClB;WACA;;YAGA,eAAe;mBAEhB;mBACA;UACT;EAER,YAAY,QAAQ;;;;;YA0BD;YAIM,YAAY;YAsEZ,WAAW;;;;;UC3HrB,qCAAqC;EACpD;;UAGe,iDAAiD;EAChE,WAAW;;EAEX,sBAAsB,gBAAgB;;EAEtC,iBAAiB;;;;;qBAMN,2CAA2C;mBACrC;mBACA;mBACA;EAEjB,YAAY,QAAQ;YAOK,cAAc,mBAAmB,QAAQ;YA8FzC,iBAAiB,SAAS,+BAA+B;;;;;wBCjI9D,uBACpB,aACA;EAAW,SAAS;EAA0B,QAAQ;IACrD"}
package/dist/index.d.ts CHANGED
@@ -1,7 +1,6 @@
1
1
  import { AgentBrowser, AgentBrowserConfig, AgentBrowserSession, AgentBrowserThreadManager, AgentBrowserThreadManagerConfig } from "@mastra/agent-browser";
2
2
  import { BrowserManager } from "agent-browser";
3
3
  import { Firecrawl } from "firecrawl";
4
- //#region src/types.d.ts
5
4
  /**
6
5
  * Options passed to Firecrawl `POST /v2/browser` (see Firecrawl JS SDK `browser()`).
7
6
  *
@@ -40,8 +39,6 @@ type FirecrawlBrowserConfig = AgentBrowserConfig & {
40
39
  */
41
40
  firecrawl?: FirecrawlBrowserSessionOptions;
42
41
  };
43
- //#endregion
44
- //#region src/firecrawl-browser.d.ts
45
42
  /**
46
43
  * Mastra browser provider backed by [Firecrawl Browser Sandbox](https://docs.firecrawl.dev/features/browser):
47
44
  * provisions remote sessions via API and drives them with the same deterministic tools as {@link AgentBrowser}.
@@ -63,8 +60,6 @@ export declare class FirecrawlBrowser extends AgentBrowser {
63
60
  protected doLaunch(): Promise<void>;
64
61
  protected doClose(): Promise<void>;
65
62
  }
66
- //#endregion
67
- //#region src/firecrawl-thread-manager.d.ts
68
63
  /**
69
64
  * Thread session with Firecrawl sandbox id for cleanup.
70
65
  */
@@ -89,8 +84,6 @@ export declare class FirecrawlAgentBrowserThreadManager extends AgentBrowserThre
89
84
  protected createSession(threadId: string): Promise<FirecrawlAgentBrowserSession>;
90
85
  protected doDestroySession(session: FirecrawlAgentBrowserSession): Promise<void>;
91
86
  }
92
- //#endregion
93
- //#region src/resolve-cdp.d.ts
94
87
  /**
95
88
  * Resolve an HTTP CDP endpoint to a WebSocket URL (same behavior as MastraBrowser.resolveWebSocketUrl).
96
89
  */
@@ -98,6 +91,5 @@ export declare function resolveCdpWebSocketUrl(url: string, logger?: {
98
91
  debug?: (message: string) => void;
99
92
  warn?: (message: string) => void;
100
93
  }): Promise<string>;
101
- //#endregion
102
94
  export type { FirecrawlAgentBrowserSession, FirecrawlAgentBrowserThreadManagerConfig, FirecrawlBrowserConfig, FirecrawlBrowserSessionOptions };
103
95
  //# sourceMappingURL=index.d.ts.map
package/dist/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/firecrawl-browser.ts","../src/firecrawl-thread-manager.ts","../src/resolve-cdp.ts"],"mappings":";;;;;;;;;;;UASiB;;EAEf;;EAEA;;EAEA;;EAEA;;IAEE;;IAEA;;;EAGF;;EAEA;;;KAIU,yBAAyB;;EAEnC;;EAEA;;;;;EAKA,YAAY;;;;;;;;qBChBD,yBAAyB;WAClB;WACA;;YAGA,eAAe;mBAEhB;mBACA;UACT;EAER,YAAY,QAAQ;;;;;YA0BD;YAIM,YAAY;YAsEZ,WAAW;;;;;;;UC3HrB,qCAAqC;EACpD;;UAGe,iDAAiD;EAChE,WAAW;;EAEX,sBAAsB,gBAAgB;;EAEtC,iBAAiB;;;;;qBAMN,2CAA2C;mBACrC;mBACA;mBACA;EAEjB,YAAY,QAAQ;YAOK,cAAc,mBAAmB,QAAQ;YA8FzC,iBAAiB,SAAS,+BAA+B;;;;;;;wBCjI9D,uBACpB,aACA;EAAW,SAAS;EAA0B,QAAQ;IACrD"}
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/firecrawl-browser.ts","../src/firecrawl-thread-manager.ts","../src/resolve-cdp.ts"],"mappings":";;;;;;;;;;UASiB;;EAEf;;EAEA;;EAEA;;EAEA;;IAEE;;IAEA;;;EAGF;;EAEA;;;KAIU,yBAAyB;;EAEnC;;EAEA;;;;;EAKA,YAAY;;;;;;qBChBD,yBAAyB;WAClB;WACA;;YAGA,eAAe;mBAEhB;mBACA;UACT;EAER,YAAY,QAAQ;;;;;YA0BD;YAIM,YAAY;YAsEZ,WAAW;;;;;UC3HrB,qCAAqC;EACpD;;UAGe,iDAAiD;EAChE,WAAW;;EAEX,sBAAsB,gBAAgB;;EAEtC,iBAAiB;;;;;qBAMN,2CAA2C;mBACrC;mBACA;mBACA;EAEjB,YAAY,QAAQ;YAOK,cAAc,mBAAmB,QAAQ;YA8FzC,iBAAiB,SAAS,+BAA+B;;;;;wBCjI9D,uBACpB,aACA;EAAW,SAAS;EAA0B,QAAQ;IACrD"}
package/dist/index.js CHANGED
@@ -2,7 +2,7 @@ import { AgentBrowser, AgentBrowserThreadManager } from "@mastra/agent-browser";
2
2
  import { DEFAULT_BROWSER_VIEWPORT, resolveViewportSize } from "@mastra/core/browser";
3
3
  import { BrowserManager } from "agent-browser";
4
4
  import { Firecrawl } from "firecrawl";
5
- //#region src/firecrawl-thread-manager.ts
5
+ // src/firecrawl-thread-manager.ts
6
6
  /**
7
7
  * Provisions a dedicated Firecrawl Browser Sandbox session per Mastra thread and connects Playwright over CDP.
8
8
  */
@@ -98,8 +98,7 @@ var FirecrawlAgentBrowserThreadManager = class extends AgentBrowserThreadManager
98
98
  } catch {}
99
99
  }
100
100
  };
101
- //#endregion
102
- //#region src/resolve-cdp.ts
101
+ // src/resolve-cdp.ts
103
102
  /**
104
103
  * Resolve an HTTP CDP endpoint to a WebSocket URL (same behavior as MastraBrowser.resolveWebSocketUrl).
105
104
  */
@@ -126,8 +125,7 @@ async function resolveCdpWebSocketUrl(url, logger) {
126
125
  }
127
126
  return url;
128
127
  }
129
- //#endregion
130
- //#region src/firecrawl-browser.ts
128
+ // src/firecrawl-browser.ts
131
129
  function pickSessionOpts(c) {
132
130
  return c.firecrawl ?? {};
133
131
  }
@@ -241,7 +239,6 @@ var FirecrawlBrowser = class extends AgentBrowser {
241
239
  }
242
240
  }
243
241
  };
244
- //#endregion
245
242
  export { FirecrawlAgentBrowserThreadManager, FirecrawlBrowser, resolveCdpWebSocketUrl };
246
243
 
247
244
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":[],"sources":["../src/firecrawl-thread-manager.ts","../src/resolve-cdp.ts","../src/firecrawl-browser.ts"],"sourcesContent":["import type { AgentBrowserSession, AgentBrowserThreadManagerConfig } from '@mastra/agent-browser';\nimport { AgentBrowserThreadManager } from '@mastra/agent-browser';\nimport { resolveViewportSize, DEFAULT_BROWSER_VIEWPORT } from '@mastra/core/browser';\nimport type { BrowserLaunchOptions } from 'agent-browser';\nimport { BrowserManager } from 'agent-browser';\nimport type { Firecrawl } from 'firecrawl';\nimport type { FirecrawlBrowserSessionOptions } from './types';\n\n/**\n * Thread session with Firecrawl sandbox id for cleanup.\n */\nexport interface FirecrawlAgentBrowserSession extends AgentBrowserSession {\n firecrawlSessionId?: string;\n}\n\nexport interface FirecrawlAgentBrowserThreadManagerConfig extends AgentBrowserThreadManagerConfig {\n firecrawl: Firecrawl;\n /** Resolve HTTP CDP URL to WebSocket URL. */\n resolveWebSocketUrl: (url: string) => Promise<string>;\n /** Options for each `firecrawl.browser()` call (thread scope = one call per thread). */\n sessionOptions?: FirecrawlBrowserSessionOptions;\n}\n\n/**\n * Provisions a dedicated Firecrawl Browser Sandbox session per Mastra thread and connects Playwright over CDP.\n */\nexport class FirecrawlAgentBrowserThreadManager extends AgentBrowserThreadManager {\n private readonly firecrawl: Firecrawl;\n private readonly resolveWebSocketUrl: (url: string) => Promise<string>;\n private readonly sessionOptions: FirecrawlBrowserSessionOptions;\n\n constructor(config: FirecrawlAgentBrowserThreadManagerConfig) {\n super(config);\n this.firecrawl = config.firecrawl;\n this.resolveWebSocketUrl = config.resolveWebSocketUrl;\n this.sessionOptions = config.sessionOptions ?? {};\n }\n\n protected override async createSession(threadId: string): Promise<FirecrawlAgentBrowserSession> {\n const savedState = this.getSavedBrowserState(threadId);\n\n const session: FirecrawlAgentBrowserSession = {\n threadId,\n createdAt: Date.now(),\n browserState: savedState,\n };\n\n if (this.scope === 'thread') {\n const createRes = await this.firecrawl.browser({\n ttl: this.sessionOptions.ttl,\n activityTtl: this.sessionOptions.activityTtl,\n streamWebView: this.sessionOptions.streamWebView,\n profile: this.sessionOptions.profile,\n integration: this.sessionOptions.integration,\n origin: this.sessionOptions.origin,\n });\n\n if (!createRes.success || !createRes.id || !createRes.cdpUrl) {\n const msg = createRes.error ?? 'Firecrawl browser session creation failed';\n const err = new Error(`Firecrawl browser(): ${msg}`);\n if (createRes.id) {\n try {\n await this.firecrawl.deleteBrowser(createRes.id);\n } catch (cleanupErr) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);\n }\n }\n throw err;\n }\n\n session.firecrawlSessionId = createRes.id;\n\n const manager = new BrowserManager();\n\n const wsUrl = await this.resolveWebSocketUrl(createRes.cdpUrl);\n\n const launchOptions: BrowserLaunchOptions = {\n headless: this.browserConfig.headless ?? true,\n viewport: resolveViewportSize(this.browserConfig.viewport) ?? DEFAULT_BROWSER_VIEWPORT,\n profile: this.browserConfig.profile,\n executablePath: this.browserConfig.executablePath,\n storageState: this.browserConfig.storageState,\n cdpUrl: wsUrl,\n };\n\n try {\n await manager.launch(launchOptions);\n } catch (error) {\n try {\n await manager.close();\n } catch {\n // ignore\n }\n try {\n await this.firecrawl.deleteBrowser(createRes.id);\n } catch {\n // ignore\n }\n throw error;\n }\n\n session.manager = manager;\n this.threadManagers.set(threadId, manager);\n\n try {\n if (savedState && savedState.tabs.length > 0) {\n this.logger?.debug?.(`Restoring browser state for thread ${threadId}: ${savedState.tabs.length} tabs`);\n await this.restoreBrowserState(manager, savedState);\n }\n this.onBrowserCreated?.(manager, threadId);\n } catch (error) {\n this.threadManagers.delete(threadId);\n session.manager = undefined;\n try {\n await manager.close();\n } catch {\n // ignore\n }\n if (session.firecrawlSessionId) {\n try {\n await this.firecrawl.deleteBrowser(session.firecrawlSessionId);\n } catch {\n // ignore\n }\n }\n throw error;\n }\n }\n\n return session;\n }\n\n protected override async doDestroySession(session: FirecrawlAgentBrowserSession): Promise<void> {\n if (this.scope === 'thread' && session.manager) {\n try {\n await session.manager.close();\n } catch {\n // ignore\n }\n this.threadManagers.delete(session.threadId);\n }\n\n if (session.firecrawlSessionId) {\n try {\n await this.firecrawl.deleteBrowser(session.firecrawlSessionId);\n } catch {\n // ignore\n }\n }\n }\n}\n","/**\n * Resolve an HTTP CDP endpoint to a WebSocket URL (same behavior as MastraBrowser.resolveWebSocketUrl).\n */\nexport async function resolveCdpWebSocketUrl(\n url: string,\n logger?: { debug?: (message: string) => void; warn?: (message: string) => void },\n): Promise<string> {\n if (url.startsWith('ws://') || url.startsWith('wss://')) {\n return url;\n }\n\n if (url.startsWith('http://') || url.startsWith('https://')) {\n const baseUrl = url.replace(/\\/$/, '');\n const versionUrl = `${baseUrl}/json/version`;\n\n logger?.debug?.(`Resolving WebSocket URL from ${versionUrl}`);\n\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), 10000);\n\n try {\n const response = await fetch(versionUrl, { signal: controller.signal });\n\n if (!response.ok) {\n throw new Error(\n `Failed to fetch CDP version info from ${versionUrl}: ${response.status} ${response.statusText}`,\n );\n }\n\n const data = (await response.json()) as { webSocketDebuggerUrl?: string };\n if (!data.webSocketDebuggerUrl) {\n throw new Error(`No webSocketDebuggerUrl found in CDP version response from ${versionUrl}`);\n }\n\n logger?.debug?.(`Resolved WebSocket URL: ${data.webSocketDebuggerUrl}`);\n return data.webSocketDebuggerUrl;\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n throw new Error(`Timeout resolving WebSocket URL from ${versionUrl} (10s)`);\n }\n throw error;\n } finally {\n clearTimeout(timeoutId);\n }\n }\n\n return url;\n}\n","import type { AgentBrowserConfig } from '@mastra/agent-browser';\nimport { AgentBrowser } from '@mastra/agent-browser';\nimport { resolveViewportSize, DEFAULT_BROWSER_VIEWPORT } from '@mastra/core/browser';\nimport type { BrowserLaunchOptions } from 'agent-browser';\nimport { BrowserManager } from 'agent-browser';\nimport { Firecrawl } from 'firecrawl';\nimport { FirecrawlAgentBrowserThreadManager } from './firecrawl-thread-manager';\nimport { resolveCdpWebSocketUrl } from './resolve-cdp';\nimport type { FirecrawlBrowserConfig, FirecrawlBrowserSessionOptions } from './types';\n\nfunction pickSessionOpts(c: FirecrawlBrowserConfig): FirecrawlBrowserSessionOptions {\n return c.firecrawl ?? {};\n}\n\nfunction toBaseConfig(config: FirecrawlBrowserConfig): AgentBrowserConfig {\n const { apiKey: _a, apiUrl: _u, firecrawl: _f, ...rest } = config;\n return rest;\n}\n\n/**\n * Mastra browser provider backed by [Firecrawl Browser Sandbox](https://docs.firecrawl.dev/features/browser):\n * provisions remote sessions via API and drives them with the same deterministic tools as {@link AgentBrowser}.\n */\nexport class FirecrawlBrowser extends AgentBrowser {\n override readonly name = 'FirecrawlBrowser';\n override readonly provider = 'firecrawl/browser-sandbox';\n\n /** Narrowed from base `MastraBrowser` (`unknown`) — same pattern as {@link AgentBrowser}. */\n declare protected sharedManager: BrowserManager | null;\n\n private readonly firecrawl: Firecrawl;\n private readonly sessionOpts: FirecrawlBrowserSessionOptions;\n private sharedFirecrawlSessionId?: string;\n\n constructor(config: FirecrawlBrowserConfig) {\n const apiKey = config.apiKey ?? process.env.FIRECRAWL_API_KEY;\n if (!apiKey) {\n throw new Error('FirecrawlBrowser requires `apiKey` or FIRECRAWL_API_KEY');\n }\n const fc = new Firecrawl({ apiKey, apiUrl: config.apiUrl });\n const sessionOpts = pickSessionOpts(config);\n\n super({\n ...toBaseConfig(config),\n createThreadManager: opts =>\n new FirecrawlAgentBrowserThreadManager({\n ...opts,\n firecrawl: fc,\n resolveWebSocketUrl: url => resolveCdpWebSocketUrl(url, opts.logger),\n sessionOptions: sessionOpts,\n }),\n });\n this.firecrawl = fc;\n this.sessionOpts = sessionOpts;\n }\n\n /**\n * Firecrawl always drives a remote browser over CDP, including per-thread\n * sessions, so its PID must never be captured (issue #23588).\n */\n protected override isRemoteThreadBrowser(): boolean {\n return true;\n }\n\n protected override async doLaunch(): Promise<void> {\n const scope = this.threadManager.getScope();\n if (scope === 'thread') {\n await super.doLaunch();\n return;\n }\n\n const createRes = await this.firecrawl.browser({\n ttl: this.sessionOpts.ttl,\n activityTtl: this.sessionOpts.activityTtl,\n streamWebView: this.sessionOpts.streamWebView,\n profile: this.sessionOpts.profile,\n integration: this.sessionOpts.integration,\n origin: this.sessionOpts.origin,\n });\n\n if (!createRes.success || !createRes.id || !createRes.cdpUrl) {\n const msg = createRes.error ?? 'Firecrawl browser session creation failed';\n const err = new Error(`Firecrawl browser(): ${msg}`);\n if (createRes.id) {\n try {\n await this.firecrawl.deleteBrowser(createRes.id);\n } catch (cleanupErr) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);\n }\n }\n throw err;\n }\n\n const sessionId = createRes.id;\n this.sharedManager = new BrowserManager();\n\n try {\n const localConfig = this.config as AgentBrowserConfig;\n const wsUrl = await resolveCdpWebSocketUrl(createRes.cdpUrl, this.logger);\n\n const launchOptions: BrowserLaunchOptions = {\n headless: localConfig.headless ?? true,\n // Firecrawl drives a remote browser, so there is no local window to\n // match; `'window'` falls back to the default dimensions.\n viewport: resolveViewportSize(localConfig.viewport) ?? DEFAULT_BROWSER_VIEWPORT,\n profile: localConfig.profile,\n executablePath: localConfig.executablePath,\n storageState: localConfig.storageState,\n cdpUrl: wsUrl,\n };\n\n await this.sharedManager.launch(launchOptions);\n this.threadManager.setSharedManager(this.sharedManager);\n // Firecrawl always drives a remote browser over CDP — never capture its\n // PID (issue #23588); it belongs to Firecrawl's host, not ours.\n this.setupCloseListenerForSharedScope(this.sharedManager, true);\n this.sharedFirecrawlSessionId = sessionId;\n } catch (launchErr) {\n try {\n await this.sharedManager.close();\n } catch (closeErr) {\n this.logger?.warn?.(`BrowserManager.close() after failed shared launch: ${closeErr}`);\n }\n try {\n await this.firecrawl.deleteBrowser(sessionId);\n } catch (delErr) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${sessionId}) after failed shared launch: ${delErr}`);\n }\n this.sharedManager = null;\n this.sharedFirecrawlSessionId = undefined;\n throw launchErr;\n }\n }\n\n protected override async doClose(): Promise<void> {\n const sid = this.sharedFirecrawlSessionId;\n await super.doClose();\n if (sid) {\n try {\n await this.firecrawl.deleteBrowser(sid);\n } catch (err) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${sid}) failed: ${err}`);\n }\n this.sharedFirecrawlSessionId = undefined;\n }\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":[],"sources":["../src/firecrawl-thread-manager.ts","../src/resolve-cdp.ts","../src/firecrawl-browser.ts"],"sourcesContent":["import type { AgentBrowserSession, AgentBrowserThreadManagerConfig } from '@mastra/agent-browser';\nimport { AgentBrowserThreadManager } from '@mastra/agent-browser';\nimport { resolveViewportSize, DEFAULT_BROWSER_VIEWPORT } from '@mastra/core/browser';\nimport type { BrowserLaunchOptions } from 'agent-browser';\nimport { BrowserManager } from 'agent-browser';\nimport type { Firecrawl } from 'firecrawl';\nimport type { FirecrawlBrowserSessionOptions } from './types';\n\n/**\n * Thread session with Firecrawl sandbox id for cleanup.\n */\nexport interface FirecrawlAgentBrowserSession extends AgentBrowserSession {\n firecrawlSessionId?: string;\n}\n\nexport interface FirecrawlAgentBrowserThreadManagerConfig extends AgentBrowserThreadManagerConfig {\n firecrawl: Firecrawl;\n /** Resolve HTTP CDP URL to WebSocket URL. */\n resolveWebSocketUrl: (url: string) => Promise<string>;\n /** Options for each `firecrawl.browser()` call (thread scope = one call per thread). */\n sessionOptions?: FirecrawlBrowserSessionOptions;\n}\n\n/**\n * Provisions a dedicated Firecrawl Browser Sandbox session per Mastra thread and connects Playwright over CDP.\n */\nexport class FirecrawlAgentBrowserThreadManager extends AgentBrowserThreadManager {\n private readonly firecrawl: Firecrawl;\n private readonly resolveWebSocketUrl: (url: string) => Promise<string>;\n private readonly sessionOptions: FirecrawlBrowserSessionOptions;\n\n constructor(config: FirecrawlAgentBrowserThreadManagerConfig) {\n super(config);\n this.firecrawl = config.firecrawl;\n this.resolveWebSocketUrl = config.resolveWebSocketUrl;\n this.sessionOptions = config.sessionOptions ?? {};\n }\n\n protected override async createSession(threadId: string): Promise<FirecrawlAgentBrowserSession> {\n const savedState = this.getSavedBrowserState(threadId);\n\n const session: FirecrawlAgentBrowserSession = {\n threadId,\n createdAt: Date.now(),\n browserState: savedState,\n };\n\n if (this.scope === 'thread') {\n const createRes = await this.firecrawl.browser({\n ttl: this.sessionOptions.ttl,\n activityTtl: this.sessionOptions.activityTtl,\n streamWebView: this.sessionOptions.streamWebView,\n profile: this.sessionOptions.profile,\n integration: this.sessionOptions.integration,\n origin: this.sessionOptions.origin,\n });\n\n if (!createRes.success || !createRes.id || !createRes.cdpUrl) {\n const msg = createRes.error ?? 'Firecrawl browser session creation failed';\n const err = new Error(`Firecrawl browser(): ${msg}`);\n if (createRes.id) {\n try {\n await this.firecrawl.deleteBrowser(createRes.id);\n } catch (cleanupErr) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);\n }\n }\n throw err;\n }\n\n session.firecrawlSessionId = createRes.id;\n\n const manager = new BrowserManager();\n\n const wsUrl = await this.resolveWebSocketUrl(createRes.cdpUrl);\n\n const launchOptions: BrowserLaunchOptions = {\n headless: this.browserConfig.headless ?? true,\n viewport: resolveViewportSize(this.browserConfig.viewport) ?? DEFAULT_BROWSER_VIEWPORT,\n profile: this.browserConfig.profile,\n executablePath: this.browserConfig.executablePath,\n storageState: this.browserConfig.storageState,\n cdpUrl: wsUrl,\n };\n\n try {\n await manager.launch(launchOptions);\n } catch (error) {\n try {\n await manager.close();\n } catch {\n // ignore\n }\n try {\n await this.firecrawl.deleteBrowser(createRes.id);\n } catch {\n // ignore\n }\n throw error;\n }\n\n session.manager = manager;\n this.threadManagers.set(threadId, manager);\n\n try {\n if (savedState && savedState.tabs.length > 0) {\n this.logger?.debug?.(`Restoring browser state for thread ${threadId}: ${savedState.tabs.length} tabs`);\n await this.restoreBrowserState(manager, savedState);\n }\n this.onBrowserCreated?.(manager, threadId);\n } catch (error) {\n this.threadManagers.delete(threadId);\n session.manager = undefined;\n try {\n await manager.close();\n } catch {\n // ignore\n }\n if (session.firecrawlSessionId) {\n try {\n await this.firecrawl.deleteBrowser(session.firecrawlSessionId);\n } catch {\n // ignore\n }\n }\n throw error;\n }\n }\n\n return session;\n }\n\n protected override async doDestroySession(session: FirecrawlAgentBrowserSession): Promise<void> {\n if (this.scope === 'thread' && session.manager) {\n try {\n await session.manager.close();\n } catch {\n // ignore\n }\n this.threadManagers.delete(session.threadId);\n }\n\n if (session.firecrawlSessionId) {\n try {\n await this.firecrawl.deleteBrowser(session.firecrawlSessionId);\n } catch {\n // ignore\n }\n }\n }\n}\n","/**\n * Resolve an HTTP CDP endpoint to a WebSocket URL (same behavior as MastraBrowser.resolveWebSocketUrl).\n */\nexport async function resolveCdpWebSocketUrl(\n url: string,\n logger?: { debug?: (message: string) => void; warn?: (message: string) => void },\n): Promise<string> {\n if (url.startsWith('ws://') || url.startsWith('wss://')) {\n return url;\n }\n\n if (url.startsWith('http://') || url.startsWith('https://')) {\n const baseUrl = url.replace(/\\/$/, '');\n const versionUrl = `${baseUrl}/json/version`;\n\n logger?.debug?.(`Resolving WebSocket URL from ${versionUrl}`);\n\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), 10000);\n\n try {\n const response = await fetch(versionUrl, { signal: controller.signal });\n\n if (!response.ok) {\n throw new Error(\n `Failed to fetch CDP version info from ${versionUrl}: ${response.status} ${response.statusText}`,\n );\n }\n\n const data = (await response.json()) as { webSocketDebuggerUrl?: string };\n if (!data.webSocketDebuggerUrl) {\n throw new Error(`No webSocketDebuggerUrl found in CDP version response from ${versionUrl}`);\n }\n\n logger?.debug?.(`Resolved WebSocket URL: ${data.webSocketDebuggerUrl}`);\n return data.webSocketDebuggerUrl;\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n throw new Error(`Timeout resolving WebSocket URL from ${versionUrl} (10s)`);\n }\n throw error;\n } finally {\n clearTimeout(timeoutId);\n }\n }\n\n return url;\n}\n","import type { AgentBrowserConfig } from '@mastra/agent-browser';\nimport { AgentBrowser } from '@mastra/agent-browser';\nimport { resolveViewportSize, DEFAULT_BROWSER_VIEWPORT } from '@mastra/core/browser';\nimport type { BrowserLaunchOptions } from 'agent-browser';\nimport { BrowserManager } from 'agent-browser';\nimport { Firecrawl } from 'firecrawl';\nimport { FirecrawlAgentBrowserThreadManager } from './firecrawl-thread-manager';\nimport { resolveCdpWebSocketUrl } from './resolve-cdp';\nimport type { FirecrawlBrowserConfig, FirecrawlBrowserSessionOptions } from './types';\n\nfunction pickSessionOpts(c: FirecrawlBrowserConfig): FirecrawlBrowserSessionOptions {\n return c.firecrawl ?? {};\n}\n\nfunction toBaseConfig(config: FirecrawlBrowserConfig): AgentBrowserConfig {\n const { apiKey: _a, apiUrl: _u, firecrawl: _f, ...rest } = config;\n return rest;\n}\n\n/**\n * Mastra browser provider backed by [Firecrawl Browser Sandbox](https://docs.firecrawl.dev/features/browser):\n * provisions remote sessions via API and drives them with the same deterministic tools as {@link AgentBrowser}.\n */\nexport class FirecrawlBrowser extends AgentBrowser {\n override readonly name = 'FirecrawlBrowser';\n override readonly provider = 'firecrawl/browser-sandbox';\n\n /** Narrowed from base `MastraBrowser` (`unknown`) — same pattern as {@link AgentBrowser}. */\n declare protected sharedManager: BrowserManager | null;\n\n private readonly firecrawl: Firecrawl;\n private readonly sessionOpts: FirecrawlBrowserSessionOptions;\n private sharedFirecrawlSessionId?: string;\n\n constructor(config: FirecrawlBrowserConfig) {\n const apiKey = config.apiKey ?? process.env.FIRECRAWL_API_KEY;\n if (!apiKey) {\n throw new Error('FirecrawlBrowser requires `apiKey` or FIRECRAWL_API_KEY');\n }\n const fc = new Firecrawl({ apiKey, apiUrl: config.apiUrl });\n const sessionOpts = pickSessionOpts(config);\n\n super({\n ...toBaseConfig(config),\n createThreadManager: opts =>\n new FirecrawlAgentBrowserThreadManager({\n ...opts,\n firecrawl: fc,\n resolveWebSocketUrl: url => resolveCdpWebSocketUrl(url, opts.logger),\n sessionOptions: sessionOpts,\n }),\n });\n this.firecrawl = fc;\n this.sessionOpts = sessionOpts;\n }\n\n /**\n * Firecrawl always drives a remote browser over CDP, including per-thread\n * sessions, so its PID must never be captured (issue #23588).\n */\n protected override isRemoteThreadBrowser(): boolean {\n return true;\n }\n\n protected override async doLaunch(): Promise<void> {\n const scope = this.threadManager.getScope();\n if (scope === 'thread') {\n await super.doLaunch();\n return;\n }\n\n const createRes = await this.firecrawl.browser({\n ttl: this.sessionOpts.ttl,\n activityTtl: this.sessionOpts.activityTtl,\n streamWebView: this.sessionOpts.streamWebView,\n profile: this.sessionOpts.profile,\n integration: this.sessionOpts.integration,\n origin: this.sessionOpts.origin,\n });\n\n if (!createRes.success || !createRes.id || !createRes.cdpUrl) {\n const msg = createRes.error ?? 'Firecrawl browser session creation failed';\n const err = new Error(`Firecrawl browser(): ${msg}`);\n if (createRes.id) {\n try {\n await this.firecrawl.deleteBrowser(createRes.id);\n } catch (cleanupErr) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);\n }\n }\n throw err;\n }\n\n const sessionId = createRes.id;\n this.sharedManager = new BrowserManager();\n\n try {\n const localConfig = this.config as AgentBrowserConfig;\n const wsUrl = await resolveCdpWebSocketUrl(createRes.cdpUrl, this.logger);\n\n const launchOptions: BrowserLaunchOptions = {\n headless: localConfig.headless ?? true,\n // Firecrawl drives a remote browser, so there is no local window to\n // match; `'window'` falls back to the default dimensions.\n viewport: resolveViewportSize(localConfig.viewport) ?? DEFAULT_BROWSER_VIEWPORT,\n profile: localConfig.profile,\n executablePath: localConfig.executablePath,\n storageState: localConfig.storageState,\n cdpUrl: wsUrl,\n };\n\n await this.sharedManager.launch(launchOptions);\n this.threadManager.setSharedManager(this.sharedManager);\n // Firecrawl always drives a remote browser over CDP — never capture its\n // PID (issue #23588); it belongs to Firecrawl's host, not ours.\n this.setupCloseListenerForSharedScope(this.sharedManager, true);\n this.sharedFirecrawlSessionId = sessionId;\n } catch (launchErr) {\n try {\n await this.sharedManager.close();\n } catch (closeErr) {\n this.logger?.warn?.(`BrowserManager.close() after failed shared launch: ${closeErr}`);\n }\n try {\n await this.firecrawl.deleteBrowser(sessionId);\n } catch (delErr) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${sessionId}) after failed shared launch: ${delErr}`);\n }\n this.sharedManager = null;\n this.sharedFirecrawlSessionId = undefined;\n throw launchErr;\n }\n }\n\n protected override async doClose(): Promise<void> {\n const sid = this.sharedFirecrawlSessionId;\n await super.doClose();\n if (sid) {\n try {\n await this.firecrawl.deleteBrowser(sid);\n } catch (err) {\n this.logger?.warn?.(`Firecrawl deleteBrowser(${sid}) failed: ${err}`);\n }\n this.sharedFirecrawlSessionId = undefined;\n }\n }\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/browser-firecrawl",
3
- "version": "0.2.5-alpha.0",
3
+ "version": "0.2.5-alpha.1",
4
4
  "description": "Mastra browser automation using Firecrawl Browser Sandbox (hosted CDP + agent-browser tools)",
5
5
  "type": "module",
6
6
  "files": [
@@ -23,20 +23,20 @@
23
23
  },
24
24
  "license": "Apache-2.0",
25
25
  "dependencies": {
26
- "firecrawl": "^4.46.0"
26
+ "firecrawl": "^4.51.0"
27
27
  },
28
28
  "devDependencies": {
29
- "@types/node": "22.20.5",
30
- "@vitest/coverage-v8": "4.1.11",
31
- "@vitest/ui": "4.1.11",
29
+ "@types/node": "22.19.15",
30
+ "@vitest/coverage-v8": "4.1.12",
31
+ "@vitest/ui": "4.1.12",
32
32
  "agent-browser": "0.19.0",
33
- "playwright-core": "^1.61.1",
33
+ "playwright-core": "^1.64.1",
34
34
  "tsdown": "0.23.1",
35
35
  "typescript": "^7.0.2",
36
- "vitest": "4.1.11",
36
+ "vitest": "4.1.12",
37
37
  "@internal/lint": "0.0.145",
38
- "@mastra/agent-browser": "0.5.4",
39
- "@mastra/core": "1.80.0-alpha.0",
38
+ "@mastra/agent-browser": "0.5.5-alpha.0",
39
+ "@mastra/core": "1.80.0-alpha.4",
40
40
  "@internal/types-builder": "0.0.120"
41
41
  },
42
42
  "peerDependencies": {