@mastra/browser-firecrawl 0.2.2 → 0.2.3

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 +8 -1
  2. package/dist/index.cjs.map +1 -1
  3. package/dist/index.d.cts +5 -0
  4. package/dist/index.d.cts.map +1 -1
  5. package/dist/index.d.ts +5 -0
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/index.js +8 -1
  8. package/dist/index.js.map +1 -1
  9. package/package.json +5 -5
package/dist/index.cjs CHANGED
@@ -166,6 +166,13 @@ var FirecrawlBrowser = class extends _mastra_agent_browser.AgentBrowser {
166
166
  this.firecrawl = fc;
167
167
  this.sessionOpts = sessionOpts;
168
168
  }
169
+ /**
170
+ * Firecrawl always drives a remote browser over CDP, including per-thread
171
+ * sessions, so its PID must never be captured (issue #23588).
172
+ */
173
+ isRemoteThreadBrowser() {
174
+ return true;
175
+ }
169
176
  async doLaunch() {
170
177
  if (this.threadManager.getScope() === "thread") {
171
178
  await super.doLaunch();
@@ -204,7 +211,7 @@ var FirecrawlBrowser = class extends _mastra_agent_browser.AgentBrowser {
204
211
  };
205
212
  await this.sharedManager.launch(launchOptions);
206
213
  this.threadManager.setSharedManager(this.sharedManager);
207
- this.setupCloseListenerForSharedScope(this.sharedManager);
214
+ this.setupCloseListenerForSharedScope(this.sharedManager, true);
208
215
  this.sharedFirecrawlSessionId = sessionId;
209
216
  } catch (launchErr) {
210
217
  try {
package/dist/index.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["AgentBrowserThreadManager","BrowserManager","DEFAULT_BROWSER_VIEWPORT","AgentBrowser","Firecrawl","BrowserManager","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 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 this.setupCloseListenerForSharedScope(this.sharedManager);\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.cjs","names":["AgentBrowserThreadManager","BrowserManager","DEFAULT_BROWSER_VIEWPORT","AgentBrowser","Firecrawl","BrowserManager","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,GAAA,qBAAA,oBAAA,CAA8B,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,GAAA,qBAAA,oBAAA,CAA8B,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"}
package/dist/index.d.cts CHANGED
@@ -55,6 +55,11 @@ declare class FirecrawlBrowser extends AgentBrowser {
55
55
  private readonly sessionOpts;
56
56
  private sharedFirecrawlSessionId?;
57
57
  constructor(config: FirecrawlBrowserConfig);
58
+ /**
59
+ * Firecrawl always drives a remote browser over CDP, including per-thread
60
+ * sessions, so its PID must never be captured (issue #23588).
61
+ */
62
+ protected isRemoteThreadBrowser(): boolean;
58
63
  protected doLaunch(): Promise<void>;
59
64
  protected doClose(): Promise<void>;
60
65
  }
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;;;;;;;;cChBD,yBAAyB;WAClB;WACA;;YAGA,eAAe;mBAEhB;mBACA;UACT;EAER,YAAY,QAAQ;YAsBK,YAAY;YAoEZ,WAAW;;;;;;;UCjHrB,qCAAqC;EACpD;;UAGe,iDAAiD;EAChE,WAAW;;EAEX,sBAAsB,gBAAgB;;EAEtC,iBAAiB;;;;;cAMN,2CAA2C;mBACrC;mBACA;mBACA;EAEjB,YAAY,QAAQ;YAOK,cAAc,mBAAmB,QAAQ;YA8FzC,iBAAiB,SAAS,+BAA+B;;;;;;;iBCjI9D,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;;;;;;;;cChBD,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;;;;;cAMN,2CAA2C;mBACrC;mBACA;mBACA;EAEjB,YAAY,QAAQ;YAOK,cAAc,mBAAmB,QAAQ;YA8FzC,iBAAiB,SAAS,+BAA+B;;;;;;;iBCjI9D,uBACpB,aACA;EAAW,SAAS;EAA0B,QAAQ;IACrD"}
package/dist/index.d.ts CHANGED
@@ -55,6 +55,11 @@ declare class FirecrawlBrowser extends AgentBrowser {
55
55
  private readonly sessionOpts;
56
56
  private sharedFirecrawlSessionId?;
57
57
  constructor(config: FirecrawlBrowserConfig);
58
+ /**
59
+ * Firecrawl always drives a remote browser over CDP, including per-thread
60
+ * sessions, so its PID must never be captured (issue #23588).
61
+ */
62
+ protected isRemoteThreadBrowser(): boolean;
58
63
  protected doLaunch(): Promise<void>;
59
64
  protected doClose(): Promise<void>;
60
65
  }
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;;;;;;;;cChBD,yBAAyB;WAClB;WACA;;YAGA,eAAe;mBAEhB;mBACA;UACT;EAER,YAAY,QAAQ;YAsBK,YAAY;YAoEZ,WAAW;;;;;;;UCjHrB,qCAAqC;EACpD;;UAGe,iDAAiD;EAChE,WAAW;;EAEX,sBAAsB,gBAAgB;;EAEtC,iBAAiB;;;;;cAMN,2CAA2C;mBACrC;mBACA;mBACA;EAEjB,YAAY,QAAQ;YAOK,cAAc,mBAAmB,QAAQ;YA8FzC,iBAAiB,SAAS,+BAA+B;;;;;;;iBCjI9D,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;;;;;;;;cChBD,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;;;;;cAMN,2CAA2C;mBACrC;mBACA;mBACA;EAEjB,YAAY,QAAQ;YAOK,cAAc,mBAAmB,QAAQ;YA8FzC,iBAAiB,SAAS,+BAA+B;;;;;;;iBCjI9D,uBACpB,aACA;EAAW,SAAS;EAA0B,QAAQ;IACrD"}
package/dist/index.js CHANGED
@@ -165,6 +165,13 @@ var FirecrawlBrowser = class extends AgentBrowser {
165
165
  this.firecrawl = fc;
166
166
  this.sessionOpts = sessionOpts;
167
167
  }
168
+ /**
169
+ * Firecrawl always drives a remote browser over CDP, including per-thread
170
+ * sessions, so its PID must never be captured (issue #23588).
171
+ */
172
+ isRemoteThreadBrowser() {
173
+ return true;
174
+ }
168
175
  async doLaunch() {
169
176
  if (this.threadManager.getScope() === "thread") {
170
177
  await super.doLaunch();
@@ -203,7 +210,7 @@ var FirecrawlBrowser = class extends AgentBrowser {
203
210
  };
204
211
  await this.sharedManager.launch(launchOptions);
205
212
  this.threadManager.setSharedManager(this.sharedManager);
206
- this.setupCloseListenerForSharedScope(this.sharedManager);
213
+ this.setupCloseListenerForSharedScope(this.sharedManager, true);
207
214
  this.sharedFirecrawlSessionId = sessionId;
208
215
  } catch (launchErr) {
209
216
  try {
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 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 this.setupCloseListenerForSharedScope(this.sharedManager);\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.2",
3
+ "version": "0.2.3",
4
4
  "description": "Mastra browser automation using Firecrawl Browser Sandbox (hosted CDP + agent-browser tools)",
5
5
  "type": "module",
6
6
  "files": [
@@ -35,10 +35,10 @@
35
35
  "tsdown": "0.22.9",
36
36
  "typescript": "^7.0.2",
37
37
  "vitest": "4.1.10",
38
- "@mastra/agent-browser": "0.5.2",
39
- "@internal/types-builder": "0.0.105",
40
- "@internal/lint": "0.0.130",
41
- "@mastra/core": "1.64.0"
38
+ "@internal/types-builder": "0.0.108",
39
+ "@internal/lint": "0.0.133",
40
+ "@mastra/agent-browser": "0.5.3",
41
+ "@mastra/core": "1.67.0"
42
42
  },
43
43
  "peerDependencies": {
44
44
  "@mastra/agent-browser": ">=0.3.0 <1.0.0",