@mastra/browser-firecrawl 0.0.0 → 0.1.0-alpha.0

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# @mastra/browser-firecrawl
+
+## 0.1.0-alpha.0
+
+### Minor Changes
+
+- Initial release: Firecrawl Browser Sandbox integration for Mastra. ([#15724](https://github.com/mastra-ai/mastra/pull/15724))
+
+  `FirecrawlBrowser` extends `AgentBrowser` to run the same deterministic browser tools (snapshot+refs, 16 tools, Playwright over CDP) against Firecrawl's cloud-hosted Chrome instances instead of local or self-hosted browsers.
+
+  **Features:**
+  - Cloud-hosted Chrome via Firecrawl Browser Sandbox API
+  - Same tool surface as `@mastra/agent-browser` (~16 browser automation tools)
+  - Thread-scoped browser isolation (`scope: 'thread'`)
+  - Automatic session cleanup on close
+
+  **Usage:**
+
+  ```typescript
+  import { FirecrawlBrowser } from '@mastra/browser-firecrawl';
+
+  const browser = new FirecrawlBrowser({
+    firecrawlApiKey: process.env.FIRECRAWL_API_KEY,
+    scope: 'thread',
+  });
+
+  const agent = mastra.getAgent('my-agent', { browser });
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`8ace89d`](https://github.com/mastra-ai/mastra/commit/8ace89df77f762e622d3b9f7f65ad7524350d050), [`fa63872`](https://github.com/mastra-ai/mastra/commit/fa6387280954e6b667bec5714b55ba082bc627ff), [`f07b646`](https://github.com/mastra-ai/mastra/commit/f07b64604ab7d25391179790b7fd4823df9e2dff), [`d8838ae`](https://github.com/mastra-ai/mastra/commit/d8838ae80b69780361693d27098f7f6684af12fe), [`40f9297`](https://github.com/mastra-ai/mastra/commit/40f9297003b921c62373d3e8d3a4bda76c9f6de3), [`0f0d1ba`](https://github.com/mastra-ai/mastra/commit/0f0d1ba67bfcb2204e571401662f1eceefc03357), [`8c31bcd`](https://github.com/mastra-ai/mastra/commit/8c31bcdb00e597880d5939b1b7d7566fbe5dacae), [`95b14cd`](https://github.com/mastra-ai/mastra/commit/95b14cdd820e86d97ac05fe568424c513a252e31), [`aa36be2`](https://github.com/mastra-ai/mastra/commit/aa36be23aa513b7dc53cb8ca16b7fab8f20e43ad), [`212c635`](https://github.com/mastra-ai/mastra/commit/212c635203e61d036ab41db8ff86c3893dc795b3), [`d8838ae`](https://github.com/mastra-ai/mastra/commit/d8838ae80b69780361693d27098f7f6684af12fe), [`9aa5a73`](https://github.com/mastra-ai/mastra/commit/9aa5a73e7e110f6e9365eec69364a33d5f03bb56), [`f73c789`](https://github.com/mastra-ai/mastra/commit/f73c789e8ef21561580395d2c410119cab5848c8), [`8bd16da`](https://github.com/mastra-ai/mastra/commit/8bd16da73a4cb874d739373643dbd6a6e7f88684), [`c8630f8`](https://github.com/mastra-ai/mastra/commit/c8630f80d4f40cb5d22e60ab162b618b1907167a), [`47f71dc`](https://github.com/mastra-ai/mastra/commit/47f71dc6fbcbd12d71e21a979e676e20a02bd77d), [`e191065`](https://github.com/mastra-ai/mastra/commit/e191065af6039cf6388e05aa2b84f6f5d69af4c9), [`50ceae2`](https://github.com/mastra-ai/mastra/commit/50ceae270878e2f8fb2b2c6c2faab09df0007c8a), [`8cdde58`](https://github.com/mastra-ai/mastra/commit/8cdde5875bbba6702d9df226f2b20232b8d75d6c), [`847ff1e`](https://github.com/mastra-ai/mastra/commit/847ff1e0d94368d94b2e173e4e0908e115568ef3), [`259d409`](https://github.com/mastra-ai/mastra/commit/259d409a514174299dbde1ff5e1121209b3ba850), [`9e16c68`](https://github.com/mastra-ai/mastra/commit/9e16c6818b6485ccb43df28aba6f3a2219d28662), [`cefca33`](https://github.com/mastra-ai/mastra/commit/cefca33ae666e69810c935fedf95a929c173d1d7), [`d00e8c5`](https://github.com/mastra-ai/mastra/commit/d00e8c50daebe5bce5bf2f48bde39c86fc3d2fe4), [`36fa7e2`](https://github.com/mastra-ai/mastra/commit/36fa7e24d14e58a1eb46147097b32f583e5b8775), [`87e9774`](https://github.com/mastra-ai/mastra/commit/87e97741c1e493cd6d62f478eb810b49bda4d57c), [`65a72e7`](https://github.com/mastra-ai/mastra/commit/65a72e70c25eedea8ff985a6624b96be2850236b), [`0f77241`](https://github.com/mastra-ai/mastra/commit/0f7724108806703799a8ba80ad0f09414afd5066), [`92ff509`](https://github.com/mastra-ai/mastra/commit/92ff5098ef8a990438ca038077021a5f7541ec1d), [`3fce5e7`](https://github.com/mastra-ai/mastra/commit/3fce5e70d011d289043e75003ef3336ed4aa43c3), [`a763592`](https://github.com/mastra-ai/mastra/commit/a763592c3db46963ef1011cfe16fe372816e775e), [`80c7737`](https://github.com/mastra-ai/mastra/commit/80c7737e32d7917b5f356957d67c169d01744fd3), [`3f1cf47`](https://github.com/mastra-ai/mastra/commit/3f1cf476f74c1e4cc2df908837e05853a5347e31)]:
+  - @mastra/core@1.38.0-alpha.3
+  - @mastra/agent-browser@0.3.0-alpha.0

package/LICENSE.md

@@ -0,0 +1,30 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named "ee/" within this
+  repository, including but not limited to:
+  - `packages/core/src/auth/ee/`
+  - `packages/server/src/server/auth/ee/`
+    is licensed under the license defined in `ee/LICENSE`.
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/dist/index.cjs

@@ -0,0 +1,259 @@
+'use strict';
+
+var agentBrowser = require('@mastra/agent-browser');
+var agentBrowser$1 = require('agent-browser');
+var firecrawl = require('firecrawl');
+
+// src/firecrawl-browser.ts
+var FirecrawlAgentBrowserThreadManager = class extends agentBrowser.AgentBrowserThreadManager {
+  firecrawl;
+  resolveWebSocketUrl;
+  sessionOptions;
+  constructor(config) {
+    super(config);
+    this.firecrawl = config.firecrawl;
+    this.resolveWebSocketUrl = config.resolveWebSocketUrl;
+    this.sessionOptions = config.sessionOptions ?? {};
+  }
+  async createSession(threadId) {
+    const savedState = this.getSavedBrowserState(threadId);
+    const session = {
+      threadId,
+      createdAt: Date.now(),
+      browserState: savedState
+    };
+    if (this.scope === "thread") {
+      const createRes = await this.firecrawl.browser({
+        ttl: this.sessionOptions.ttl,
+        activityTtl: this.sessionOptions.activityTtl,
+        streamWebView: this.sessionOptions.streamWebView,
+        profile: this.sessionOptions.profile,
+        integration: this.sessionOptions.integration,
+        origin: this.sessionOptions.origin
+      });
+      if (!createRes.success || !createRes.id || !createRes.cdpUrl) {
+        const msg = createRes.error ?? "Firecrawl browser session creation failed";
+        const err = new Error(`Firecrawl browser(): ${msg}`);
+        if (createRes.id) {
+          try {
+            await this.firecrawl.deleteBrowser(createRes.id);
+          } catch (cleanupErr) {
+            this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);
+          }
+        }
+        throw err;
+      }
+      session.firecrawlSessionId = createRes.id;
+      const manager = new agentBrowser$1.BrowserManager();
+      const wsUrl = await this.resolveWebSocketUrl(createRes.cdpUrl);
+      const launchOptions = {
+        headless: this.browserConfig.headless ?? true,
+        viewport: this.browserConfig.viewport,
+        profile: this.browserConfig.profile,
+        executablePath: this.browserConfig.executablePath,
+        storageState: this.browserConfig.storageState,
+        cdpUrl: wsUrl
+      };
+      try {
+        await manager.launch(launchOptions);
+      } catch (error) {
+        try {
+          await manager.close();
+        } catch {
+        }
+        try {
+          await this.firecrawl.deleteBrowser(createRes.id);
+        } catch {
+        }
+        throw error;
+      }
+      session.manager = manager;
+      this.threadManagers.set(threadId, manager);
+      try {
+        if (savedState && savedState.tabs.length > 0) {
+          this.logger?.debug?.(`Restoring browser state for thread ${threadId}: ${savedState.tabs.length} tabs`);
+          await this.restoreBrowserState(manager, savedState);
+        }
+        this.onBrowserCreated?.(manager, threadId);
+      } catch (error) {
+        this.threadManagers.delete(threadId);
+        session.manager = void 0;
+        try {
+          await manager.close();
+        } catch {
+        }
+        if (session.firecrawlSessionId) {
+          try {
+            await this.firecrawl.deleteBrowser(session.firecrawlSessionId);
+          } catch {
+          }
+        }
+        throw error;
+      }
+    }
+    return session;
+  }
+  async doDestroySession(session) {
+    if (this.scope === "thread" && session.manager) {
+      try {
+        await session.manager.close();
+      } catch {
+      }
+      this.threadManagers.delete(session.threadId);
+    }
+    if (session.firecrawlSessionId) {
+      try {
+        await this.firecrawl.deleteBrowser(session.firecrawlSessionId);
+      } catch {
+      }
+    }
+  }
+};
+
+// src/resolve-cdp.ts
+async function resolveCdpWebSocketUrl(url, logger) {
+  if (url.startsWith("ws://") || url.startsWith("wss://")) {
+    return url;
+  }
+  if (url.startsWith("http://") || url.startsWith("https://")) {
+    const baseUrl = url.replace(/\/$/, "");
+    const versionUrl = `${baseUrl}/json/version`;
+    logger?.debug?.(`Resolving WebSocket URL from ${versionUrl}`);
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 1e4);
+    try {
+      const response = await fetch(versionUrl, { signal: controller.signal });
+      if (!response.ok) {
+        throw new Error(
+          `Failed to fetch CDP version info from ${versionUrl}: ${response.status} ${response.statusText}`
+        );
+      }
+      const data = await response.json();
+      if (!data.webSocketDebuggerUrl) {
+        throw new Error(`No webSocketDebuggerUrl found in CDP version response from ${versionUrl}`);
+      }
+      logger?.debug?.(`Resolved WebSocket URL: ${data.webSocketDebuggerUrl}`);
+      return data.webSocketDebuggerUrl;
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new Error(`Timeout resolving WebSocket URL from ${versionUrl} (10s)`);
+      }
+      throw error;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  return url;
+}
+
+// src/firecrawl-browser.ts
+function pickSessionOpts(c) {
+  return c.firecrawl ?? {};
+}
+function toBaseConfig(config) {
+  const { apiKey: _a, apiUrl: _u, firecrawl: _f, ...rest } = config;
+  return rest;
+}
+var FirecrawlBrowser = class extends agentBrowser.AgentBrowser {
+  name = "FirecrawlBrowser";
+  provider = "firecrawl/browser-sandbox";
+  firecrawl;
+  sessionOpts;
+  sharedFirecrawlSessionId;
+  constructor(config) {
+    const apiKey = config.apiKey ?? process.env.FIRECRAWL_API_KEY;
+    if (!apiKey) {
+      throw new Error("FirecrawlBrowser requires `apiKey` or FIRECRAWL_API_KEY");
+    }
+    const fc = new firecrawl.Firecrawl({ apiKey, apiUrl: config.apiUrl });
+    const sessionOpts = pickSessionOpts(config);
+    super({
+      ...toBaseConfig(config),
+      createThreadManager: (opts) => new FirecrawlAgentBrowserThreadManager({
+        ...opts,
+        firecrawl: fc,
+        resolveWebSocketUrl: (url) => resolveCdpWebSocketUrl(url, opts.logger),
+        sessionOptions: sessionOpts
+      })
+    });
+    this.firecrawl = fc;
+    this.sessionOpts = sessionOpts;
+  }
+  async doLaunch() {
+    const scope = this.threadManager.getScope();
+    if (scope === "thread") {
+      await super.doLaunch();
+      return;
+    }
+    const createRes = await this.firecrawl.browser({
+      ttl: this.sessionOpts.ttl,
+      activityTtl: this.sessionOpts.activityTtl,
+      streamWebView: this.sessionOpts.streamWebView,
+      profile: this.sessionOpts.profile,
+      integration: this.sessionOpts.integration,
+      origin: this.sessionOpts.origin
+    });
+    if (!createRes.success || !createRes.id || !createRes.cdpUrl) {
+      const msg = createRes.error ?? "Firecrawl browser session creation failed";
+      const err = new Error(`Firecrawl browser(): ${msg}`);
+      if (createRes.id) {
+        try {
+          await this.firecrawl.deleteBrowser(createRes.id);
+        } catch (cleanupErr) {
+          this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);
+        }
+      }
+      throw err;
+    }
+    const sessionId = createRes.id;
+    this.sharedManager = new agentBrowser$1.BrowserManager();
+    try {
+      const localConfig = this.config;
+      const wsUrl = await resolveCdpWebSocketUrl(createRes.cdpUrl, this.logger);
+      const launchOptions = {
+        headless: localConfig.headless ?? true,
+        viewport: localConfig.viewport,
+        profile: localConfig.profile,
+        executablePath: localConfig.executablePath,
+        storageState: localConfig.storageState,
+        cdpUrl: wsUrl
+      };
+      await this.sharedManager.launch(launchOptions);
+      this.threadManager.setSharedManager(this.sharedManager);
+      this.setupCloseListenerForSharedScope(this.sharedManager);
+      this.sharedFirecrawlSessionId = sessionId;
+    } catch (launchErr) {
+      try {
+        await this.sharedManager.close();
+      } catch (closeErr) {
+        this.logger?.warn?.(`BrowserManager.close() after failed shared launch: ${closeErr}`);
+      }
+      try {
+        await this.firecrawl.deleteBrowser(sessionId);
+      } catch (delErr) {
+        this.logger?.warn?.(`Firecrawl deleteBrowser(${sessionId}) after failed shared launch: ${delErr}`);
+      }
+      this.sharedManager = null;
+      this.sharedFirecrawlSessionId = void 0;
+      throw launchErr;
+    }
+  }
+  async doClose() {
+    const sid = this.sharedFirecrawlSessionId;
+    await super.doClose();
+    if (sid) {
+      try {
+        await this.firecrawl.deleteBrowser(sid);
+      } catch (err) {
+        this.logger?.warn?.(`Firecrawl deleteBrowser(${sid}) failed: ${err}`);
+      }
+      this.sharedFirecrawlSessionId = void 0;
+    }
+  }
+};
+
+exports.FirecrawlAgentBrowserThreadManager = FirecrawlAgentBrowserThreadManager;
+exports.FirecrawlBrowser = FirecrawlBrowser;
+exports.resolveCdpWebSocketUrl = resolveCdpWebSocketUrl;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/firecrawl-thread-manager.ts","../src/resolve-cdp.ts","../src/firecrawl-browser.ts"],"names":["AgentBrowserThreadManager","BrowserManager","AgentBrowser","Firecrawl"],"mappings":";;;;;;;AAyBO,IAAM,kCAAA,GAAN,cAAiDA,sCAAA,CAA0B;AAAA,EAC/D,SAAA;AAAA,EACA,mBAAA;AAAA,EACA,cAAA;AAAA,EAEjB,YAAY,MAAA,EAAkD;AAC5D,IAAA,KAAA,CAAM,MAAM,CAAA;AACZ,IAAA,IAAA,CAAK,YAAY,MAAA,CAAO,SAAA;AACxB,IAAA,IAAA,CAAK,sBAAsB,MAAA,CAAO,mBAAA;AAClC,IAAA,IAAA,CAAK,cAAA,GAAiB,MAAA,CAAO,cAAA,IAAkB,EAAC;AAAA,EAClD;AAAA,EAEA,MAAyB,cAAc,QAAA,EAAyD;AAC9F,IAAA,MAAM,UAAA,GAAa,IAAA,CAAK,oBAAA,CAAqB,QAAQ,CAAA;AAErD,IAAA,MAAM,OAAA,GAAwC;AAAA,MAC5C,QAAA;AAAA,MACA,SAAA,EAAW,KAAK,GAAA,EAAI;AAAA,MACpB,YAAA,EAAc;AAAA,KAChB;AAEA,IAAA,IAAI,IAAA,CAAK,UAAU,QAAA,EAAU;AAC3B,MAAA,MAAM,SAAA,GAAY,MAAM,IAAA,CAAK,SAAA,CAAU,OAAA,CAAQ;AAAA,QAC7C,GAAA,EAAK,KAAK,cAAA,CAAe,GAAA;AAAA,QACzB,WAAA,EAAa,KAAK,cAAA,CAAe,WAAA;AAAA,QACjC,aAAA,EAAe,KAAK,cAAA,CAAe,aAAA;AAAA,QACnC,OAAA,EAAS,KAAK,cAAA,CAAe,OAAA;AAAA,QAC7B,WAAA,EAAa,KAAK,cAAA,CAAe,WAAA;AAAA,QACjC,MAAA,EAAQ,KAAK,cAAA,CAAe;AAAA,OAC7B,CAAA;AAED,MAAA,IAAI,CAAC,UAAU,OAAA,IAAW,CAAC,UAAU,EAAA,IAAM,CAAC,UAAU,MAAA,EAAQ;AAC5D,QAAA,MAAM,GAAA,GAAM,UAAU,KAAA,IAAS,2CAAA;AAC/B,QAAA,MAAM,GAAA,GAAM,IAAI,KAAA,CAAM,CAAA,qBAAA,EAAwB,GAAG,CAAA,CAAE,CAAA;AACnD,QAAA,IAAI,UAAU,EAAA,EAAI;AAChB,UAAA,IAAI;AACF,YAAA,MAAM,IAAA,CAAK,SAAA,CAAU,aAAA,CAAc,SAAA,CAAU,EAAE,CAAA;AAAA,UACjD,SAAS,UAAA,EAAY;AACnB,YAAA,IAAA,CAAK,QAAQ,IAAA,GAAO,CAAA,wBAAA,EAA2B,UAAU,EAAE,CAAA,0BAAA,EAA6B,UAAU,CAAA,CAAE,CAAA;AAAA,UACtG;AAAA,QACF;AACA,QAAA,MAAM,GAAA;AAAA,MACR;AAEA,MAAA,OAAA,CAAQ,qBAAqB,SAAA,CAAU,EAAA;AAEvC,MAAA,MAAM,OAAA,GAAU,IAAIC,6BAAA,EAAe;AAEnC,MAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,mBAAA,CAAoB,UAAU,MAAM,CAAA;AAE7D,MAAA,MAAM,aAAA,GAAsC;AAAA,QAC1C,QAAA,EAAU,IAAA,CAAK,aAAA,CAAc,QAAA,IAAY,IAAA;AAAA,QACzC,QAAA,EAAU,KAAK,aAAA,CAAc,QAAA;AAAA,QAC7B,OAAA,EAAS,KAAK,aAAA,CAAc,OAAA;AAAA,QAC5B,cAAA,EAAgB,KAAK,aAAA,CAAc,cAAA;AAAA,QACnC,YAAA,EAAc,KAAK,aAAA,CAAc,YAAA;AAAA,QACjC,MAAA,EAAQ;AAAA,OACV;AAEA,MAAA,IAAI;AACF,QAAA,MAAM,OAAA,CAAQ,OAAO,aAAa,CAAA;AAAA,MACpC,SAAS,KAAA,EAAO;AACd,QAAA,IAAI;AACF,UAAA,MAAM,QAAQ,KAAA,EAAM;AAAA,QACtB,CAAA,CAAA,MAAQ;AAAA,QAER;AACA,QAAA,IAAI;AACF,UAAA,MAAM,IAAA,CAAK,SAAA,CAAU,aAAA,CAAc,SAAA,CAAU,EAAE,CAAA;AAAA,QACjD,CAAA,CAAA,MAAQ;AAAA,QAER;AACA,QAAA,MAAM,KAAA;AAAA,MACR;AAEA,MAAA,OAAA,CAAQ,OAAA,GAAU,OAAA;AAClB,MAAA,IAAA,CAAK,cAAA,CAAe,GAAA,CAAI,QAAA,EAAU,OAAO,CAAA;AAEzC,MAAA,IAAI;AACF,QAAA,IAAI,UAAA,IAAc,UAAA,CAAW,IAAA,CAAK,MAAA,GAAS,CAAA,EAAG;AAC5C,UAAA,IAAA,CAAK,MAAA,EAAQ,QAAQ,CAAA,mCAAA,EAAsC,QAAQ,KAAK,UAAA,CAAW,IAAA,CAAK,MAAM,CAAA,KAAA,CAAO,CAAA;AACrG,UAAA,MAAM,IAAA,CAAK,mBAAA,CAAoB,OAAA,EAAS,UAAU,CAAA;AAAA,QACpD;AACA,QAAA,IAAA,CAAK,gBAAA,GAAmB,SAAS,QAAQ,CAAA;AAAA,MAC3C,SAAS,KAAA,EAAO;AACd,QAAA,IAAA,CAAK,cAAA,CAAe,OAAO,QAAQ,CAAA;AACnC,QAAA,OAAA,CAAQ,OAAA,GAAU,MAAA;AAClB,QAAA,IAAI;AACF,UAAA,MAAM,QAAQ,KAAA,EAAM;AAAA,QACtB,CAAA,CAAA,MAAQ;AAAA,QAER;AACA,QAAA,IAAI,QAAQ,kBAAA,EAAoB;AAC9B,UAAA,IAAI;AACF,YAAA,MAAM,IAAA,CAAK,SAAA,CAAU,aAAA,CAAc,OAAA,CAAQ,kBAAkB,CAAA;AAAA,UAC/D,CAAA,CAAA,MAAQ;AAAA,UAER;AAAA,QACF;AACA,QAAA,MAAM,KAAA;AAAA,MACR;AAAA,IACF;AAEA,IAAA,OAAO,OAAA;AAAA,EACT;AAAA,EAEA,MAAyB,iBAAiB,OAAA,EAAsD;AAC9F,IAAA,IAAI,IAAA,CAAK,KAAA,KAAU,QAAA,IAAY,OAAA,CAAQ,OAAA,EAAS;AAC9C,MAAA,IAAI;AACF,QAAA,MAAM,OAAA,CAAQ,QAAQ,KAAA,EAAM;AAAA,MAC9B,CAAA,CAAA,MAAQ;AAAA,MAER;AACA,MAAA,IAAA,CAAK,cAAA,CAAe,MAAA,CAAO,OAAA,CAAQ,QAAQ,CAAA;AAAA,IAC7C;AAEA,IAAA,IAAI,QAAQ,kBAAA,EAAoB;AAC9B,MAAA,IAAI;AACF,QAAA,MAAM,IAAA,CAAK,SAAA,CAAU,aAAA,CAAc,OAAA,CAAQ,kBAAkB,CAAA;AAAA,MAC/D,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;;;AClJA,eAAsB,sBAAA,CACpB,KACA,MAAA,EACiB;AACjB,EAAA,IAAI,IAAI,UAAA,CAAW,OAAO,KAAK,GAAA,CAAI,UAAA,CAAW,QAAQ,CAAA,EAAG;AACvD,IAAA,OAAO,GAAA;AAAA,EACT;AAEA,EAAA,IAAI,IAAI,UAAA,CAAW,SAAS,KAAK,GAAA,CAAI,UAAA,CAAW,UAAU,CAAA,EAAG;AAC3D,IAAA,MAAM,OAAA,GAAU,GAAA,CAAI,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AACrC,IAAA,MAAM,UAAA,GAAa,GAAG,OAAO,CAAA,aAAA,CAAA;AAE7B,IAAA,MAAA,EAAQ,KAAA,GAAQ,CAAA,6BAAA,EAAgC,UAAU,CAAA,CAAE,CAAA;AAE5D,IAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,IAAA,MAAM,YAAY,UAAA,CAAW,MAAM,UAAA,CAAW,KAAA,IAAS,GAAK,CAAA;AAE5D,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,UAAA,EAAY,EAAE,MAAA,EAAQ,UAAA,CAAW,QAAQ,CAAA;AAEtE,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,yCAAyC,UAAU,CAAA,EAAA,EAAK,SAAS,MAAM,CAAA,CAAA,EAAI,SAAS,UAAU,CAAA;AAAA,SAChG;AAAA,MACF;AAEA,MAAA,MAAM,IAAA,GAAQ,MAAM,QAAA,CAAS,IAAA,EAAK;AAClC,MAAA,IAAI,CAAC,KAAK,oBAAA,EAAsB;AAC9B,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,2DAAA,EAA8D,UAAU,CAAA,CAAE,CAAA;AAAA,MAC5F;AAEA,MAAA,MAAA,EAAQ,KAAA,GAAQ,CAAA,wBAAA,EAA2B,IAAA,CAAK,oBAAoB,CAAA,CAAE,CAAA;AACtE,MAAA,OAAO,IAAA,CAAK,oBAAA;AAAA,IACd,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,KAAA,YAAiB,KAAA,IAAS,KAAA,CAAM,IAAA,KAAS,YAAA,EAAc;AACzD,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,qCAAA,EAAwC,UAAU,CAAA,MAAA,CAAQ,CAAA;AAAA,MAC5E;AACA,MAAA,MAAM,KAAA;AAAA,IACR,CAAA,SAAE;AACA,MAAA,YAAA,CAAa,SAAS,CAAA;AAAA,IACxB;AAAA,EACF;AAEA,EAAA,OAAO,GAAA;AACT;;;ACtCA,SAAS,gBAAgB,CAAA,EAA2D;AAClF,EAAA,OAAO,CAAA,CAAE,aAAa,EAAC;AACzB;AAEA,SAAS,aAAa,MAAA,EAAoD;AACxE,EAAA,MAAM,EAAE,QAAQ,EAAA,EAAI,MAAA,EAAQ,IAAI,SAAA,EAAW,EAAA,EAAI,GAAG,IAAA,EAAK,GAAI,MAAA;AAC3D,EAAA,OAAO,IAAA;AACT;AAMO,IAAM,gBAAA,GAAN,cAA+BC,yBAAA,CAAa;AAAA,EAC/B,IAAA,GAAO,kBAAA;AAAA,EACP,QAAA,GAAW,2BAAA;AAAA,EAKZ,SAAA;AAAA,EACA,WAAA;AAAA,EACT,wBAAA;AAAA,EAER,YAAY,MAAA,EAAgC;AAC1C,IAAA,MAAM,MAAA,GAAS,MAAA,CAAO,MAAA,IAAU,OAAA,CAAQ,GAAA,CAAI,iBAAA;AAC5C,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,IAAI,MAAM,yDAAyD,CAAA;AAAA,IAC3E;AACA,IAAA,MAAM,EAAA,GAAK,IAAIC,mBAAA,CAAU,EAAE,QAAQ,MAAA,EAAQ,MAAA,CAAO,QAAQ,CAAA;AAC1D,IAAA,MAAM,WAAA,GAAc,gBAAgB,MAAM,CAAA;AAE1C,IAAA,KAAA,CAAM;AAAA,MACJ,GAAG,aAAa,MAAM,CAAA;AAAA,MACtB,mBAAA,EAAqB,CAAA,IAAA,KACnB,IAAI,kCAAA,CAAmC;AAAA,QACrC,GAAG,IAAA;AAAA,QACH,SAAA,EAAW,EAAA;AAAA,QACX,mBAAA,EAAqB,CAAA,GAAA,KAAO,sBAAA,CAAuB,GAAA,EAAK,KAAK,MAAM,CAAA;AAAA,QACnE,cAAA,EAAgB;AAAA,OACjB;AAAA,KACJ,CAAA;AACD,IAAA,IAAA,CAAK,SAAA,GAAY,EAAA;AACjB,IAAA,IAAA,CAAK,WAAA,GAAc,WAAA;AAAA,EACrB;AAAA,EAEA,MAAyB,QAAA,GAA0B;AACjD,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,aAAA,CAAc,QAAA,EAAS;AAC1C,IAAA,IAAI,UAAU,QAAA,EAAU;AACtB,MAAA,MAAM,MAAM,QAAA,EAAS;AACrB,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,SAAA,GAAY,MAAM,IAAA,CAAK,SAAA,CAAU,OAAA,CAAQ;AAAA,MAC7C,GAAA,EAAK,KAAK,WAAA,CAAY,GAAA;AAAA,MACtB,WAAA,EAAa,KAAK,WAAA,CAAY,WAAA;AAAA,MAC9B,aAAA,EAAe,KAAK,WAAA,CAAY,aAAA;AAAA,MAChC,OAAA,EAAS,KAAK,WAAA,CAAY,OAAA;AAAA,MAC1B,WAAA,EAAa,KAAK,WAAA,CAAY,WAAA;AAAA,MAC9B,MAAA,EAAQ,KAAK,WAAA,CAAY;AAAA,KAC1B,CAAA;AAED,IAAA,IAAI,CAAC,UAAU,OAAA,IAAW,CAAC,UAAU,EAAA,IAAM,CAAC,UAAU,MAAA,EAAQ;AAC5D,MAAA,MAAM,GAAA,GAAM,UAAU,KAAA,IAAS,2CAAA;AAC/B,MAAA,MAAM,GAAA,GAAM,IAAI,KAAA,CAAM,CAAA,qBAAA,EAAwB,GAAG,CAAA,CAAE,CAAA;AACnD,MAAA,IAAI,UAAU,EAAA,EAAI;AAChB,QAAA,IAAI;AACF,UAAA,MAAM,IAAA,CAAK,SAAA,CAAU,aAAA,CAAc,SAAA,CAAU,EAAE,CAAA;AAAA,QACjD,SAAS,UAAA,EAAY;AACnB,UAAA,IAAA,CAAK,QAAQ,IAAA,GAAO,CAAA,wBAAA,EAA2B,UAAU,EAAE,CAAA,0BAAA,EAA6B,UAAU,CAAA,CAAE,CAAA;AAAA,QACtG;AAAA,MACF;AACA,MAAA,MAAM,GAAA;AAAA,IACR;AAEA,IAAA,MAAM,YAAY,SAAA,CAAU,EAAA;AAC5B,IAAA,IAAA,CAAK,aAAA,GAAgB,IAAIF,6BAAAA,EAAe;AAExC,IAAA,IAAI;AACF,MAAA,MAAM,cAAc,IAAA,CAAK,MAAA;AACzB,MAAA,MAAM,QAAQ,MAAM,sBAAA,CAAuB,SAAA,CAAU,MAAA,EAAQ,KAAK,MAAM,CAAA;AAExE,MAAA,MAAM,aAAA,GAAsC;AAAA,QAC1C,QAAA,EAAU,YAAY,QAAA,IAAY,IAAA;AAAA,QAClC,UAAU,WAAA,CAAY,QAAA;AAAA,QACtB,SAAS,WAAA,CAAY,OAAA;AAAA,QACrB,gBAAgB,WAAA,CAAY,cAAA;AAAA,QAC5B,cAAc,WAAA,CAAY,YAAA;AAAA,QAC1B,MAAA,EAAQ;AAAA,OACV;AAEA,MAAA,MAAM,IAAA,CAAK,aAAA,CAAc,MAAA,CAAO,aAAa,CAAA;AAC7C,MAAA,IAAA,CAAK,aAAA,CAAc,gBAAA,CAAiB,IAAA,CAAK,aAAa,CAAA;AACtD,MAAA,IAAA,CAAK,gCAAA,CAAiC,KAAK,aAAa,CAAA;AACxD,MAAA,IAAA,CAAK,wBAAA,GAA2B,SAAA;AAAA,IAClC,SAAS,SAAA,EAAW;AAClB,MAAA,IAAI;AACF,QAAA,MAAM,IAAA,CAAK,cAAc,KAAA,EAAM;AAAA,MACjC,SAAS,QAAA,EAAU;AACjB,QAAA,IAAA,CAAK,MAAA,EAAQ,IAAA,GAAO,CAAA,mDAAA,EAAsD,QAAQ,CAAA,CAAE,CAAA;AAAA,MACtF;AACA,MAAA,IAAI;AACF,QAAA,MAAM,IAAA,CAAK,SAAA,CAAU,aAAA,CAAc,SAAS,CAAA;AAAA,MAC9C,SAAS,MAAA,EAAQ;AACf,QAAA,IAAA,CAAK,QAAQ,IAAA,GAAO,CAAA,wBAAA,EAA2B,SAAS,CAAA,8BAAA,EAAiC,MAAM,CAAA,CAAE,CAAA;AAAA,MACnG;AACA,MAAA,IAAA,CAAK,aAAA,GAAgB,IAAA;AACrB,MAAA,IAAA,CAAK,wBAAA,GAA2B,MAAA;AAChC,MAAA,MAAM,SAAA;AAAA,IACR;AAAA,EACF;AAAA,EAEA,MAAyB,OAAA,GAAyB;AAChD,IAAA,MAAM,MAAM,IAAA,CAAK,wBAAA;AACjB,IAAA,MAAM,MAAM,OAAA,EAAQ;AACpB,IAAA,IAAI,GAAA,EAAK;AACP,MAAA,IAAI;AACF,QAAA,MAAM,IAAA,CAAK,SAAA,CAAU,aAAA,CAAc,GAAG,CAAA;AAAA,MACxC,SAAS,GAAA,EAAK;AACZ,QAAA,IAAA,CAAK,QAAQ,IAAA,GAAO,CAAA,wBAAA,EAA2B,GAAG,CAAA,UAAA,EAAa,GAAG,CAAA,CAAE,CAAA;AAAA,MACtE;AACA,MAAA,IAAA,CAAK,wBAAA,GAA2B,MAAA;AAAA,IAClC;AAAA,EACF;AACF","file":"index.cjs","sourcesContent":["import type { AgentBrowserSession, AgentBrowserThreadManagerConfig } from '@mastra/agent-browser';\nimport { AgentBrowserThreadManager } from '@mastra/agent-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: this.browserConfig.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 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        viewport: localConfig.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"]}

package/dist/index.d.cts

@@ -0,0 +1,94 @@
+import { AgentBrowserConfig, AgentBrowser, AgentBrowserSession, AgentBrowserThreadManager, AgentBrowserThreadManagerConfig } from '@mastra/agent-browser';
+import { BrowserManager } from 'agent-browser';
+import { Firecrawl } from 'firecrawl';
+
+/**
+ * Options passed to Firecrawl `POST /v2/browser` (see Firecrawl JS SDK `browser()`).
+ *
+ * **Note:** {@link AgentBrowserConfig.profile} is the Playwright / agent-browser user-data directory
+ * (filesystem path). The optional `profile` below is Firecrawl’s **named sandbox profile** for the
+ * hosted browser API only—different meaning, same nested key name as required by the SDK.
+ */
+interface FirecrawlBrowserSessionOptions {
+    /** Max session wall-clock lifetime (seconds, Firecrawl API). */
+    ttl?: number;
+    /** Idle timeout before the sandbox recycles the session (seconds, Firecrawl API). */
+    activityTtl?: number;
+    /** When true, Firecrawl may stream WebView frames for the remote session. */
+    streamWebView?: boolean;
+    /** Firecrawl named profile (not the same as top-level `AgentBrowserConfig.profile`). */
+    profile?: {
+        /** Saved profile name in Firecrawl. */
+        name: string;
+        /** Persist profile changes when the session ends. */
+        saveChanges?: boolean;
+    };
+    /** Optional integration label for Firecrawl analytics / routing. */
+    integration?: string;
+    /** Optional origin hint for the Firecrawl browser session. */
+    origin?: string;
+}
+/** Configuration for {@link FirecrawlBrowser}. */
+type FirecrawlBrowserConfig = AgentBrowserConfig & {
+    /** Firecrawl API key (or set `FIRECRAWL_API_KEY` in the environment and omit). */
+    apiKey?: string;
+    /** Base URL for a self-hosted Firecrawl API. */
+    apiUrl?: string;
+    /**
+     * Firecrawl-only session options (`browser()`). Distinct from {@link AgentBrowserConfig.profile}
+     * (local Playwright profile path): see {@link FirecrawlBrowserSessionOptions.profile}.
+     */
+    firecrawl?: FirecrawlBrowserSessionOptions;
+};
+
+/**
+ * Mastra browser provider backed by [Firecrawl Browser Sandbox](https://docs.firecrawl.dev/features/browser):
+ * provisions remote sessions via API and drives them with the same deterministic tools as {@link AgentBrowser}.
+ */
+declare class FirecrawlBrowser extends AgentBrowser {
+    readonly name = "FirecrawlBrowser";
+    readonly provider = "firecrawl/browser-sandbox";
+    /** Narrowed from base `MastraBrowser` (`unknown`) — same pattern as {@link AgentBrowser}. */
+    protected sharedManager: BrowserManager | null;
+    private readonly firecrawl;
+    private readonly sessionOpts;
+    private sharedFirecrawlSessionId?;
+    constructor(config: FirecrawlBrowserConfig);
+    protected doLaunch(): Promise<void>;
+    protected doClose(): Promise<void>;
+}
+
+/**
+ * Thread session with Firecrawl sandbox id for cleanup.
+ */
+interface FirecrawlAgentBrowserSession extends AgentBrowserSession {
+    firecrawlSessionId?: string;
+}
+interface FirecrawlAgentBrowserThreadManagerConfig extends AgentBrowserThreadManagerConfig {
+    firecrawl: Firecrawl;
+    /** Resolve HTTP CDP URL to WebSocket URL. */
+    resolveWebSocketUrl: (url: string) => Promise<string>;
+    /** Options for each `firecrawl.browser()` call (thread scope = one call per thread). */
+    sessionOptions?: FirecrawlBrowserSessionOptions;
+}
+/**
+ * Provisions a dedicated Firecrawl Browser Sandbox session per Mastra thread and connects Playwright over CDP.
+ */
+declare class FirecrawlAgentBrowserThreadManager extends AgentBrowserThreadManager {
+    private readonly firecrawl;
+    private readonly resolveWebSocketUrl;
+    private readonly sessionOptions;
+    constructor(config: FirecrawlAgentBrowserThreadManagerConfig);
+    protected createSession(threadId: string): Promise<FirecrawlAgentBrowserSession>;
+    protected doDestroySession(session: FirecrawlAgentBrowserSession): Promise<void>;
+}
+
+/**
+ * Resolve an HTTP CDP endpoint to a WebSocket URL (same behavior as MastraBrowser.resolveWebSocketUrl).
+ */
+declare function resolveCdpWebSocketUrl(url: string, logger?: {
+    debug?: (message: string) => void;
+    warn?: (message: string) => void;
+}): Promise<string>;
+
+export { type FirecrawlAgentBrowserSession, FirecrawlAgentBrowserThreadManager, type FirecrawlAgentBrowserThreadManagerConfig, FirecrawlBrowser, type FirecrawlBrowserConfig, type FirecrawlBrowserSessionOptions, resolveCdpWebSocketUrl };

package/dist/index.d.ts

@@ -0,0 +1,94 @@
+import { AgentBrowserConfig, AgentBrowser, AgentBrowserSession, AgentBrowserThreadManager, AgentBrowserThreadManagerConfig } from '@mastra/agent-browser';
+import { BrowserManager } from 'agent-browser';
+import { Firecrawl } from 'firecrawl';
+
+/**
+ * Options passed to Firecrawl `POST /v2/browser` (see Firecrawl JS SDK `browser()`).
+ *
+ * **Note:** {@link AgentBrowserConfig.profile} is the Playwright / agent-browser user-data directory
+ * (filesystem path). The optional `profile` below is Firecrawl’s **named sandbox profile** for the
+ * hosted browser API only—different meaning, same nested key name as required by the SDK.
+ */
+interface FirecrawlBrowserSessionOptions {
+    /** Max session wall-clock lifetime (seconds, Firecrawl API). */
+    ttl?: number;
+    /** Idle timeout before the sandbox recycles the session (seconds, Firecrawl API). */
+    activityTtl?: number;
+    /** When true, Firecrawl may stream WebView frames for the remote session. */
+    streamWebView?: boolean;
+    /** Firecrawl named profile (not the same as top-level `AgentBrowserConfig.profile`). */
+    profile?: {
+        /** Saved profile name in Firecrawl. */
+        name: string;
+        /** Persist profile changes when the session ends. */
+        saveChanges?: boolean;
+    };
+    /** Optional integration label for Firecrawl analytics / routing. */
+    integration?: string;
+    /** Optional origin hint for the Firecrawl browser session. */
+    origin?: string;
+}
+/** Configuration for {@link FirecrawlBrowser}. */
+type FirecrawlBrowserConfig = AgentBrowserConfig & {
+    /** Firecrawl API key (or set `FIRECRAWL_API_KEY` in the environment and omit). */
+    apiKey?: string;
+    /** Base URL for a self-hosted Firecrawl API. */
+    apiUrl?: string;
+    /**
+     * Firecrawl-only session options (`browser()`). Distinct from {@link AgentBrowserConfig.profile}
+     * (local Playwright profile path): see {@link FirecrawlBrowserSessionOptions.profile}.
+     */
+    firecrawl?: FirecrawlBrowserSessionOptions;
+};
+
+/**
+ * Mastra browser provider backed by [Firecrawl Browser Sandbox](https://docs.firecrawl.dev/features/browser):
+ * provisions remote sessions via API and drives them with the same deterministic tools as {@link AgentBrowser}.
+ */
+declare class FirecrawlBrowser extends AgentBrowser {
+    readonly name = "FirecrawlBrowser";
+    readonly provider = "firecrawl/browser-sandbox";
+    /** Narrowed from base `MastraBrowser` (`unknown`) — same pattern as {@link AgentBrowser}. */
+    protected sharedManager: BrowserManager | null;
+    private readonly firecrawl;
+    private readonly sessionOpts;
+    private sharedFirecrawlSessionId?;
+    constructor(config: FirecrawlBrowserConfig);
+    protected doLaunch(): Promise<void>;
+    protected doClose(): Promise<void>;
+}
+
+/**
+ * Thread session with Firecrawl sandbox id for cleanup.
+ */
+interface FirecrawlAgentBrowserSession extends AgentBrowserSession {
+    firecrawlSessionId?: string;
+}
+interface FirecrawlAgentBrowserThreadManagerConfig extends AgentBrowserThreadManagerConfig {
+    firecrawl: Firecrawl;
+    /** Resolve HTTP CDP URL to WebSocket URL. */
+    resolveWebSocketUrl: (url: string) => Promise<string>;
+    /** Options for each `firecrawl.browser()` call (thread scope = one call per thread). */
+    sessionOptions?: FirecrawlBrowserSessionOptions;
+}
+/**
+ * Provisions a dedicated Firecrawl Browser Sandbox session per Mastra thread and connects Playwright over CDP.
+ */
+declare class FirecrawlAgentBrowserThreadManager extends AgentBrowserThreadManager {
+    private readonly firecrawl;
+    private readonly resolveWebSocketUrl;
+    private readonly sessionOptions;
+    constructor(config: FirecrawlAgentBrowserThreadManagerConfig);
+    protected createSession(threadId: string): Promise<FirecrawlAgentBrowserSession>;
+    protected doDestroySession(session: FirecrawlAgentBrowserSession): Promise<void>;
+}
+
+/**
+ * Resolve an HTTP CDP endpoint to a WebSocket URL (same behavior as MastraBrowser.resolveWebSocketUrl).
+ */
+declare function resolveCdpWebSocketUrl(url: string, logger?: {
+    debug?: (message: string) => void;
+    warn?: (message: string) => void;
+}): Promise<string>;
+
+export { type FirecrawlAgentBrowserSession, FirecrawlAgentBrowserThreadManager, type FirecrawlAgentBrowserThreadManagerConfig, FirecrawlBrowser, type FirecrawlBrowserConfig, type FirecrawlBrowserSessionOptions, resolveCdpWebSocketUrl };

package/dist/index.js

@@ -0,0 +1,255 @@
+import { AgentBrowserThreadManager, AgentBrowser } from '@mastra/agent-browser';
+import { BrowserManager } from 'agent-browser';
+import { Firecrawl } from 'firecrawl';
+
+// src/firecrawl-browser.ts
+var FirecrawlAgentBrowserThreadManager = class extends AgentBrowserThreadManager {
+  firecrawl;
+  resolveWebSocketUrl;
+  sessionOptions;
+  constructor(config) {
+    super(config);
+    this.firecrawl = config.firecrawl;
+    this.resolveWebSocketUrl = config.resolveWebSocketUrl;
+    this.sessionOptions = config.sessionOptions ?? {};
+  }
+  async createSession(threadId) {
+    const savedState = this.getSavedBrowserState(threadId);
+    const session = {
+      threadId,
+      createdAt: Date.now(),
+      browserState: savedState
+    };
+    if (this.scope === "thread") {
+      const createRes = await this.firecrawl.browser({
+        ttl: this.sessionOptions.ttl,
+        activityTtl: this.sessionOptions.activityTtl,
+        streamWebView: this.sessionOptions.streamWebView,
+        profile: this.sessionOptions.profile,
+        integration: this.sessionOptions.integration,
+        origin: this.sessionOptions.origin
+      });
+      if (!createRes.success || !createRes.id || !createRes.cdpUrl) {
+        const msg = createRes.error ?? "Firecrawl browser session creation failed";
+        const err = new Error(`Firecrawl browser(): ${msg}`);
+        if (createRes.id) {
+          try {
+            await this.firecrawl.deleteBrowser(createRes.id);
+          } catch (cleanupErr) {
+            this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);
+          }
+        }
+        throw err;
+      }
+      session.firecrawlSessionId = createRes.id;
+      const manager = new BrowserManager();
+      const wsUrl = await this.resolveWebSocketUrl(createRes.cdpUrl);
+      const launchOptions = {
+        headless: this.browserConfig.headless ?? true,
+        viewport: this.browserConfig.viewport,
+        profile: this.browserConfig.profile,
+        executablePath: this.browserConfig.executablePath,
+        storageState: this.browserConfig.storageState,
+        cdpUrl: wsUrl
+      };
+      try {
+        await manager.launch(launchOptions);
+      } catch (error) {
+        try {
+          await manager.close();
+        } catch {
+        }
+        try {
+          await this.firecrawl.deleteBrowser(createRes.id);
+        } catch {
+        }
+        throw error;
+      }
+      session.manager = manager;
+      this.threadManagers.set(threadId, manager);
+      try {
+        if (savedState && savedState.tabs.length > 0) {
+          this.logger?.debug?.(`Restoring browser state for thread ${threadId}: ${savedState.tabs.length} tabs`);
+          await this.restoreBrowserState(manager, savedState);
+        }
+        this.onBrowserCreated?.(manager, threadId);
+      } catch (error) {
+        this.threadManagers.delete(threadId);
+        session.manager = void 0;
+        try {
+          await manager.close();
+        } catch {
+        }
+        if (session.firecrawlSessionId) {
+          try {
+            await this.firecrawl.deleteBrowser(session.firecrawlSessionId);
+          } catch {
+          }
+        }
+        throw error;
+      }
+    }
+    return session;
+  }
+  async doDestroySession(session) {
+    if (this.scope === "thread" && session.manager) {
+      try {
+        await session.manager.close();
+      } catch {
+      }
+      this.threadManagers.delete(session.threadId);
+    }
+    if (session.firecrawlSessionId) {
+      try {
+        await this.firecrawl.deleteBrowser(session.firecrawlSessionId);
+      } catch {
+      }
+    }
+  }
+};
+
+// src/resolve-cdp.ts
+async function resolveCdpWebSocketUrl(url, logger) {
+  if (url.startsWith("ws://") || url.startsWith("wss://")) {
+    return url;
+  }
+  if (url.startsWith("http://") || url.startsWith("https://")) {
+    const baseUrl = url.replace(/\/$/, "");
+    const versionUrl = `${baseUrl}/json/version`;
+    logger?.debug?.(`Resolving WebSocket URL from ${versionUrl}`);
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 1e4);
+    try {
+      const response = await fetch(versionUrl, { signal: controller.signal });
+      if (!response.ok) {
+        throw new Error(
+          `Failed to fetch CDP version info from ${versionUrl}: ${response.status} ${response.statusText}`
+        );
+      }
+      const data = await response.json();
+      if (!data.webSocketDebuggerUrl) {
+        throw new Error(`No webSocketDebuggerUrl found in CDP version response from ${versionUrl}`);
+      }
+      logger?.debug?.(`Resolved WebSocket URL: ${data.webSocketDebuggerUrl}`);
+      return data.webSocketDebuggerUrl;
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new Error(`Timeout resolving WebSocket URL from ${versionUrl} (10s)`);
+      }
+      throw error;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  return url;
+}
+
+// src/firecrawl-browser.ts
+function pickSessionOpts(c) {
+  return c.firecrawl ?? {};
+}
+function toBaseConfig(config) {
+  const { apiKey: _a, apiUrl: _u, firecrawl: _f, ...rest } = config;
+  return rest;
+}
+var FirecrawlBrowser = class extends AgentBrowser {
+  name = "FirecrawlBrowser";
+  provider = "firecrawl/browser-sandbox";
+  firecrawl;
+  sessionOpts;
+  sharedFirecrawlSessionId;
+  constructor(config) {
+    const apiKey = config.apiKey ?? process.env.FIRECRAWL_API_KEY;
+    if (!apiKey) {
+      throw new Error("FirecrawlBrowser requires `apiKey` or FIRECRAWL_API_KEY");
+    }
+    const fc = new Firecrawl({ apiKey, apiUrl: config.apiUrl });
+    const sessionOpts = pickSessionOpts(config);
+    super({
+      ...toBaseConfig(config),
+      createThreadManager: (opts) => new FirecrawlAgentBrowserThreadManager({
+        ...opts,
+        firecrawl: fc,
+        resolveWebSocketUrl: (url) => resolveCdpWebSocketUrl(url, opts.logger),
+        sessionOptions: sessionOpts
+      })
+    });
+    this.firecrawl = fc;
+    this.sessionOpts = sessionOpts;
+  }
+  async doLaunch() {
+    const scope = this.threadManager.getScope();
+    if (scope === "thread") {
+      await super.doLaunch();
+      return;
+    }
+    const createRes = await this.firecrawl.browser({
+      ttl: this.sessionOpts.ttl,
+      activityTtl: this.sessionOpts.activityTtl,
+      streamWebView: this.sessionOpts.streamWebView,
+      profile: this.sessionOpts.profile,
+      integration: this.sessionOpts.integration,
+      origin: this.sessionOpts.origin
+    });
+    if (!createRes.success || !createRes.id || !createRes.cdpUrl) {
+      const msg = createRes.error ?? "Firecrawl browser session creation failed";
+      const err = new Error(`Firecrawl browser(): ${msg}`);
+      if (createRes.id) {
+        try {
+          await this.firecrawl.deleteBrowser(createRes.id);
+        } catch (cleanupErr) {
+          this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);
+        }
+      }
+      throw err;
+    }
+    const sessionId = createRes.id;
+    this.sharedManager = new BrowserManager();
+    try {
+      const localConfig = this.config;
+      const wsUrl = await resolveCdpWebSocketUrl(createRes.cdpUrl, this.logger);
+      const launchOptions = {
+        headless: localConfig.headless ?? true,
+        viewport: localConfig.viewport,
+        profile: localConfig.profile,
+        executablePath: localConfig.executablePath,
+        storageState: localConfig.storageState,
+        cdpUrl: wsUrl
+      };
+      await this.sharedManager.launch(launchOptions);
+      this.threadManager.setSharedManager(this.sharedManager);
+      this.setupCloseListenerForSharedScope(this.sharedManager);
+      this.sharedFirecrawlSessionId = sessionId;
+    } catch (launchErr) {
+      try {
+        await this.sharedManager.close();
+      } catch (closeErr) {
+        this.logger?.warn?.(`BrowserManager.close() after failed shared launch: ${closeErr}`);
+      }
+      try {
+        await this.firecrawl.deleteBrowser(sessionId);
+      } catch (delErr) {
+        this.logger?.warn?.(`Firecrawl deleteBrowser(${sessionId}) after failed shared launch: ${delErr}`);
+      }
+      this.sharedManager = null;
+      this.sharedFirecrawlSessionId = void 0;
+      throw launchErr;
+    }
+  }
+  async doClose() {
+    const sid = this.sharedFirecrawlSessionId;
+    await super.doClose();
+    if (sid) {
+      try {
+        await this.firecrawl.deleteBrowser(sid);
+      } catch (err) {
+        this.logger?.warn?.(`Firecrawl deleteBrowser(${sid}) failed: ${err}`);
+      }
+      this.sharedFirecrawlSessionId = void 0;
+    }
+  }
+};
+
+export { FirecrawlAgentBrowserThreadManager, FirecrawlBrowser, resolveCdpWebSocketUrl };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/firecrawl-thread-manager.ts","../src/resolve-cdp.ts","../src/firecrawl-browser.ts"],"names":["BrowserManager"],"mappings":"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","file":"index.js","sourcesContent":["import type { AgentBrowserSession, AgentBrowserThreadManagerConfig } from '@mastra/agent-browser';\nimport { AgentBrowserThreadManager } from '@mastra/agent-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: this.browserConfig.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 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        viewport: localConfig.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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/browser-firecrawl",
-  "version": "0.0.0",
+  "version": "0.1.0-alpha.0",
   "description": "Mastra browser automation using Firecrawl Browser Sandbox (hosted CDP + agent-browser tools)",
   "type": "module",
   "files": [
@@ -22,30 +22,24 @@
     },
     "./package.json": "./package.json"
   },
-  "scripts": {
-    "build": "tsup --silent --config tsup.config.ts",
-    "build:watch": "tsup --watch --silent --config tsup.config.ts",
-    "test": "vitest run",
-    "lint": "eslint ."
-  },
   "license": "Apache-2.0",
   "dependencies": {
     "firecrawl": "^4.18.4"
   },
   "devDependencies": {
-    "@internal/lint": "workspace:*",
-    "@internal/types-builder": "workspace:*",
-    "@mastra/agent-browser": "workspace:*",
-    "@mastra/core": "workspace:*",
     "@types/node": "22.19.15",
-    "@vitest/coverage-v8": "catalog:",
-    "@vitest/ui": "catalog:",
+    "@vitest/coverage-v8": "4.1.5",
+    "@vitest/ui": "4.1.5",
     "agent-browser": "0.19.0",
     "eslint": "^10.2.1",
     "playwright-core": "^1.57.0",
     "tsup": "^8.5.1",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
+    "typescript": "^6.0.3",
+    "vitest": "4.1.5",
+    "@internal/types-builder": "0.0.74",
+    "@mastra/agent-browser": "0.3.0-alpha.0",
+    "@internal/lint": "0.0.99",
+    "@mastra/core": "1.38.0-alpha.3"
   },
   "peerDependencies": {
     "@mastra/agent-browser": ">=0.3.0 <1.0.0",
@@ -63,5 +57,11 @@
   },
   "engines": {
     "node": ">=22.13.0"
+  },
+  "scripts": {
+    "build": "tsup --silent --config tsup.config.ts",
+    "build:watch": "tsup --watch --silent --config tsup.config.ts",
+    "test": "vitest run",
+    "lint": "eslint ."
   }
-}
+}