@mastra/browser-firecrawl 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/dist/index.cjs +231 -247
  3. package/dist/index.cjs.map +1 -1
  4. package/dist/index.d.cts +62 -58
  5. package/dist/index.d.cts.map +1 -0
  6. package/dist/index.d.ts +62 -58
  7. package/dist/index.d.ts.map +1 -0
  8. package/dist/index.js +228 -243
  9. package/dist/index.js.map +1 -1
  10. package/package.json +16 -15
package/CHANGELOG.md CHANGED
@@ -1,5 +1,25 @@
1
1
  # @mastra/browser-firecrawl
2
2
 
3
+ ## 0.2.1
4
+
5
+ ### Patch Changes
6
+
7
+ - Honor a `'window'` viewport where the provider can support it. Agent Browser and the browser viewer disable viewport emulation so the page tracks the real window; Stagehand does the same when connecting over CDP and falls back to the default size for a locally launched browser, which always applies its own viewport. ([#21010](https://github.com/mastra-ai/mastra/pull/21010))
8
+
9
+ - Updated dependencies [[`e7109ee`](https://github.com/mastra-ai/mastra/commit/e7109ee6f731bacc79c885906f3c7dca8d8f013a), [`b8ce7ec`](https://github.com/mastra-ai/mastra/commit/b8ce7ec96e39343c6c2f36d12d68a9ad816c09f7), [`2e4624e`](https://github.com/mastra-ai/mastra/commit/2e4624edb6917e61249cb60ee377735e7af7e4a9), [`45a9147`](https://github.com/mastra-ai/mastra/commit/45a914741f578754d79d8b7de7b4e4f304d8e14a), [`a3a3624`](https://github.com/mastra-ai/mastra/commit/a3a3624f646b98e409424d8defccbd334da9e8b8), [`6246914`](https://github.com/mastra-ai/mastra/commit/62469146636911f3cbbe0880bd011c6a897a59a7), [`6445eba`](https://github.com/mastra-ai/mastra/commit/6445eba6020abac681aba1cc9289f446cb400cbe), [`86b7b77`](https://github.com/mastra-ai/mastra/commit/86b7b777980d30f66e1fd134a37d2af4c22e54cc), [`1c75e32`](https://github.com/mastra-ai/mastra/commit/1c75e32f7fc0b9fb6f548b4407feaec8a1440212), [`296dc9a`](https://github.com/mastra-ai/mastra/commit/296dc9af29f3616e786c7825ec32e0df92d754c5), [`f59032a`](https://github.com/mastra-ai/mastra/commit/f59032a73699443555a08a479e7ac578975784f2), [`f59032a`](https://github.com/mastra-ai/mastra/commit/f59032a73699443555a08a479e7ac578975784f2), [`cdd5c33`](https://github.com/mastra-ai/mastra/commit/cdd5c33ac6c7118a9f139e6dc0e14e6a8ae31658), [`3f73c07`](https://github.com/mastra-ai/mastra/commit/3f73c076727e8c36b4fff7a1b40290fb68957fa8), [`772c0c8`](https://github.com/mastra-ai/mastra/commit/772c0c897cec383258de2e6178147f8014767c7b), [`d7cf7fa`](https://github.com/mastra-ai/mastra/commit/d7cf7fafc1ae1b50bd8462dd0e6c671a8606db93), [`7c1ebb1`](https://github.com/mastra-ai/mastra/commit/7c1ebb15690c4b3f0eabb19077cf8af573311e57), [`0f9a448`](https://github.com/mastra-ai/mastra/commit/0f9a448502157e59f7b76f24360ad497168f5ef8), [`578bf2e`](https://github.com/mastra-ai/mastra/commit/578bf2e6a88e9d5b8bf502204e15a95dfbb679ae), [`c47165c`](https://github.com/mastra-ai/mastra/commit/c47165c983c87594c6952f1fd2fa51a90205034c), [`289f4ce`](https://github.com/mastra-ai/mastra/commit/289f4ce16e3293370440172132c52ee787cbc09f), [`df31eb0`](https://github.com/mastra-ai/mastra/commit/df31eb0c7087d782a0d9346e467f9a4af4b0eef6), [`9571e3a`](https://github.com/mastra-ai/mastra/commit/9571e3a06ed2c5220196460bf82a2129255c3a8b), [`4f16ff8`](https://github.com/mastra-ai/mastra/commit/4f16ff824bf2f9b0ddc93f210477c10c8a4fb1ab), [`b4c89b4`](https://github.com/mastra-ai/mastra/commit/b4c89b4371b0c86da57403ad1a3b3ef0681f3128), [`e6534fa`](https://github.com/mastra-ai/mastra/commit/e6534fab031216f6cb48c4c9907cbfdce9d60bc6), [`210cb7a`](https://github.com/mastra-ai/mastra/commit/210cb7a167998c7bbf72cb3b93e6eb0563330239), [`06b2d87`](https://github.com/mastra-ai/mastra/commit/06b2d87e63bcdd0ed59215c6789692b9b12de376), [`1c67d85`](https://github.com/mastra-ai/mastra/commit/1c67d85e9da8285662f4dbbf47e0378c3fee0747), [`ac01d63`](https://github.com/mastra-ai/mastra/commit/ac01d6355974aec73fdb8781449ed12bac582094), [`80a3324`](https://github.com/mastra-ai/mastra/commit/80a33245d3110204de6f56d61211523ffe338692), [`e44e8f3`](https://github.com/mastra-ai/mastra/commit/e44e8f370b66c339ddcaba946d33da6d3c3f06cd), [`d9d2881`](https://github.com/mastra-ai/mastra/commit/d9d2881ede6dd6c023d144215fc812062aed0890), [`a810a05`](https://github.com/mastra-ai/mastra/commit/a810a058f62ad407cfc1701e0be36ae91145d7cf), [`ba24be6`](https://github.com/mastra-ai/mastra/commit/ba24be662439c331ab23a600041f93803c89eca8), [`842b5fe`](https://github.com/mastra-ai/mastra/commit/842b5fe22b6a7fa811bd14e48eb9af523ac989f2), [`990611b`](https://github.com/mastra-ai/mastra/commit/990611ba76eb876d86c9c594371ae5f02f94b432), [`80bdf3a`](https://github.com/mastra-ai/mastra/commit/80bdf3ae16ade6ff63bde0cb16fa2df8ab7dd4dd), [`c967a5e`](https://github.com/mastra-ai/mastra/commit/c967a5eec150c5dc5418c4a4388982d1fb7ad27c), [`dc4a25d`](https://github.com/mastra-ai/mastra/commit/dc4a25d41af4e2fe97a816070eaec6aa963ab53b), [`9ba1247`](https://github.com/mastra-ai/mastra/commit/9ba12470c77f1c03642d720ce67e517e878f666e), [`fd96298`](https://github.com/mastra-ai/mastra/commit/fd96298a8367622f4ebfcaa97b5b6c1fbbd14564), [`66bbfb5`](https://github.com/mastra-ai/mastra/commit/66bbfb5f05b473d39f88c0e4a481ccac41634f3a), [`dc4a25d`](https://github.com/mastra-ai/mastra/commit/dc4a25d41af4e2fe97a816070eaec6aa963ab53b), [`f8da216`](https://github.com/mastra-ai/mastra/commit/f8da21633e7eb0e31c9ce0fc30567870d19416d3), [`4a09a9c`](https://github.com/mastra-ai/mastra/commit/4a09a9c0474ef643558fcb5f0edc542b82f1cab0), [`5f798b3`](https://github.com/mastra-ai/mastra/commit/5f798b3362e9bdf4d690f85245606e146eef60b9), [`6a84954`](https://github.com/mastra-ai/mastra/commit/6a84954a2667f85b6d59da652dab1bbff007ccb0), [`1e83a47`](https://github.com/mastra-ai/mastra/commit/1e83a4734ab61ba5926af6793e3569a78b72ed37), [`52d8ef0`](https://github.com/mastra-ai/mastra/commit/52d8ef03801f1deb7ee48532fc4190dd4a33916c), [`cdd5c33`](https://github.com/mastra-ai/mastra/commit/cdd5c33ac6c7118a9f139e6dc0e14e6a8ae31658), [`7fdcaa6`](https://github.com/mastra-ai/mastra/commit/7fdcaa66105d64290f9b14432a12ec99f39c4d3a), [`d6c56f9`](https://github.com/mastra-ai/mastra/commit/d6c56f951db3213330b98b0abafa9778c8770e58), [`e08e789`](https://github.com/mastra-ai/mastra/commit/e08e789c1bf4cd2fe46363f7a4728536ceccc9bd), [`bf936e2`](https://github.com/mastra-ai/mastra/commit/bf936e2c89b2ff0dad5695b873ddc009ba96d41e), [`7fb580a`](https://github.com/mastra-ai/mastra/commit/7fb580ac73fbcacf2ff00872a3395f73ae1b9fa5), [`ed5d606`](https://github.com/mastra-ai/mastra/commit/ed5d606739c5e3fbdfa9f272df7809aa5ab43b1d), [`f53d5bd`](https://github.com/mastra-ai/mastra/commit/f53d5bd4885b29e4ac29a428a6044088ea8d6aa3), [`32980a3`](https://github.com/mastra-ai/mastra/commit/32980a3e2413d0274ac244d32c37d910edc13f00), [`01a2943`](https://github.com/mastra-ai/mastra/commit/01a2943a7d886edefdff072bfa51f055bab54437), [`82e3365`](https://github.com/mastra-ai/mastra/commit/82e3365ef7c9bf7bee2e7a7029035ea262d68895), [`6104347`](https://github.com/mastra-ai/mastra/commit/61043473ba6bfd0a25156824e853e13165562e6c), [`35cc901`](https://github.com/mastra-ai/mastra/commit/35cc90102cf834a84827acaf9eee0b6d6d1e2a3b), [`a8b4cf0`](https://github.com/mastra-ai/mastra/commit/a8b4cf02823cffebc4751a53337dfacf097c1ae1), [`9571e3a`](https://github.com/mastra-ai/mastra/commit/9571e3a06ed2c5220196460bf82a2129255c3a8b), [`333785c`](https://github.com/mastra-ai/mastra/commit/333785c93cbb01e42c60167e995457c28897ddbf), [`bda2235`](https://github.com/mastra-ai/mastra/commit/bda22353ee28f2df0eaea555f7cae1549f979c0b), [`efd5c81`](https://github.com/mastra-ai/mastra/commit/efd5c81cc25fde3c2ddd86fc1178deb4ec176e19), [`1b482c2`](https://github.com/mastra-ai/mastra/commit/1b482c2d89244dd758c41e5f927a2b44041388d2), [`45bfb88`](https://github.com/mastra-ai/mastra/commit/45bfb88fd52f1dd3be20e2a38905777c96499c90), [`ff28284`](https://github.com/mastra-ai/mastra/commit/ff2828416f14daff9d956e6a352fdaa23c950979), [`4bcdfaf`](https://github.com/mastra-ai/mastra/commit/4bcdfaf0eac3199d7cb171b0a19a92c9c341eea4), [`e3b9307`](https://github.com/mastra-ai/mastra/commit/e3b9307098daefbfae2a52ae2ef51bc9fc701190), [`d6834c5`](https://github.com/mastra-ai/mastra/commit/d6834c5a7866b16734d23900163c2414ed70d791), [`f33264f`](https://github.com/mastra-ai/mastra/commit/f33264f517ae603279afd5c4251e2b40f6dd3618), [`689f2c4`](https://github.com/mastra-ai/mastra/commit/689f2c4b6c0835fe455702b01d21daa8abcd9331), [`fcd0667`](https://github.com/mastra-ai/mastra/commit/fcd0667a4e378be35c9a1b1eb19cce78fbfd7282), [`cfd0d9e`](https://github.com/mastra-ai/mastra/commit/cfd0d9ec77ec3c69dd96f79cdb579e03d79f22ce), [`acc3513`](https://github.com/mastra-ai/mastra/commit/acc3513b19f79bf0a7ec2998694580edca54086c), [`1670533`](https://github.com/mastra-ai/mastra/commit/1670533986f6bacf567746245348125e3a106448), [`a7eb4a1`](https://github.com/mastra-ai/mastra/commit/a7eb4a11450f6170274ed5141bffe821d4fdd5a6), [`0976933`](https://github.com/mastra-ai/mastra/commit/0976933142333ec78451feef265b68bcb45aa5e7), [`242b945`](https://github.com/mastra-ai/mastra/commit/242b94558777bfbdeb42cbfea84afff0b6ad0633), [`c52d346`](https://github.com/mastra-ai/mastra/commit/c52d3462ec831a5d95926ecd3d3373f5928ad2e5), [`af4636a`](https://github.com/mastra-ai/mastra/commit/af4636a74463275d71c1d13a38f7d2b738f128bf), [`01a2943`](https://github.com/mastra-ai/mastra/commit/01a2943a7d886edefdff072bfa51f055bab54437), [`2eabc09`](https://github.com/mastra-ai/mastra/commit/2eabc097d86d52fbd0123da36a7c874154cc384f), [`0023e79`](https://github.com/mastra-ai/mastra/commit/0023e7919431078280abd11c89d1edeae35fcc69), [`c2ad51e`](https://github.com/mastra-ai/mastra/commit/c2ad51e2467f901eecba8c9f4a45e22a50bd7c18), [`25ca73d`](https://github.com/mastra-ai/mastra/commit/25ca73d25dee7ce9f0ca72939e3a505c4db7257e), [`2f9ef3f`](https://github.com/mastra-ai/mastra/commit/2f9ef3f4ca06fc2dcdd5088c26b7f4da6a016791), [`e7eefcb`](https://github.com/mastra-ai/mastra/commit/e7eefcb162cda7c493e8c3bf43050ead0efbcb2c), [`fea5cae`](https://github.com/mastra-ai/mastra/commit/fea5caedc7e2cfea51784a15e015952692027abf), [`4d7aca2`](https://github.com/mastra-ai/mastra/commit/4d7aca2fe75f225c83d1502d63079568e6ec163f), [`e1cead1`](https://github.com/mastra-ai/mastra/commit/e1cead17b5f3653cf00d2f90cc19b113119c02ba), [`01a2943`](https://github.com/mastra-ai/mastra/commit/01a2943a7d886edefdff072bfa51f055bab54437), [`d9d93b2`](https://github.com/mastra-ai/mastra/commit/d9d93b25e4a65ad5fa153fa35be7ed149c8d587f), [`c4ec889`](https://github.com/mastra-ai/mastra/commit/c4ec889561c0264c43f66d04d587bee4ce35e792), [`4b59f78`](https://github.com/mastra-ai/mastra/commit/4b59f786cbc9a7d1ef07a07517dbd4b96865e99d), [`eeae63e`](https://github.com/mastra-ai/mastra/commit/eeae63e7fbe8e1f237adc69bca6e2ac13c5ca907), [`3dc97ea`](https://github.com/mastra-ai/mastra/commit/3dc97ea415fad353b48a13095fad1835933cc12a), [`94e7ae9`](https://github.com/mastra-ai/mastra/commit/94e7ae970b37c888cd1244ef013292639a2fe6d1), [`e6a2860`](https://github.com/mastra-ai/mastra/commit/e6a2860649cc51f87d32d78b766ae2126446ba07), [`7010c5d`](https://github.com/mastra-ai/mastra/commit/7010c5d15728bf9c5dfe4fb6b1bf80ce23bf143a), [`bab06b1`](https://github.com/mastra-ai/mastra/commit/bab06b18923873a584bdfc71a6b4ec7fb4727fb7), [`3d01cd3`](https://github.com/mastra-ai/mastra/commit/3d01cd387321b6f9c5cac31d487c84bf51b19c78), [`7bf3086`](https://github.com/mastra-ai/mastra/commit/7bf308663f0115ca74ad20554ade740f06640859), [`4c186a0`](https://github.com/mastra-ai/mastra/commit/4c186a017275f45e6ed4c09de0f89550e2d09e8c), [`b0fa077`](https://github.com/mastra-ai/mastra/commit/b0fa077bcbc9b08551846fe372a0d3d15b71ed72), [`0282e16`](https://github.com/mastra-ai/mastra/commit/0282e16115538c8e9b248b90f0748eb01cb5dc98), [`a8dd139`](https://github.com/mastra-ai/mastra/commit/a8dd1391a9fe9a6632c25809ef236980afa9a020), [`6a667b4`](https://github.com/mastra-ai/mastra/commit/6a667b4b7cd6a93fe41fcdd357b08c5a8c09b9ab), [`9be8878`](https://github.com/mastra-ai/mastra/commit/9be8878dcf0388e84fc4873e0eec27bd49b881a4), [`e5786be`](https://github.com/mastra-ai/mastra/commit/e5786be02bb903073082bd9d6da880ebaacc343f), [`2440e09`](https://github.com/mastra-ai/mastra/commit/2440e096ea6c2def1ccc1eb2d0f3f5b88c4af940), [`2093fbd`](https://github.com/mastra-ai/mastra/commit/2093fbd53bb744bae19ec89f6d73db9a66fbe8a7), [`a59049b`](https://github.com/mastra-ai/mastra/commit/a59049b1652a13efff66ac826326b5ed9a550342), [`7bd85ea`](https://github.com/mastra-ai/mastra/commit/7bd85ea7588b71c25ce9f4019c88f8539be5dcbc), [`83fa004`](https://github.com/mastra-ai/mastra/commit/83fa0044bfda8b703a83883dbd8bef204844d13f), [`a463cdf`](https://github.com/mastra-ai/mastra/commit/a463cdf1c95c3059e70f0bff27959e8558bb899d), [`e7a5da4`](https://github.com/mastra-ai/mastra/commit/e7a5da4ef8e4dd452d2f232961b4e682a85ffe43), [`7b4393d`](https://github.com/mastra-ai/mastra/commit/7b4393d557411fdcf07b0e30e5acaf7cc85154ae), [`0ea6b80`](https://github.com/mastra-ai/mastra/commit/0ea6b8001408ce02b56e8be0536b0fd8cbaf8ad2)]:
10
+ - @mastra/core@1.58.0
11
+ - @mastra/agent-browser@0.5.1
12
+
13
+ ## 0.2.1-alpha.0
14
+
15
+ ### Patch Changes
16
+
17
+ - Honor a `'window'` viewport where the provider can support it. Agent Browser and the browser viewer disable viewport emulation so the page tracks the real window; Stagehand does the same when connecting over CDP and falls back to the default size for a locally launched browser, which always applies its own viewport. ([#21010](https://github.com/mastra-ai/mastra/pull/21010))
18
+
19
+ - Updated dependencies [[`f59032a`](https://github.com/mastra-ai/mastra/commit/f59032a73699443555a08a479e7ac578975784f2), [`f59032a`](https://github.com/mastra-ai/mastra/commit/f59032a73699443555a08a479e7ac578975784f2), [`bf936e2`](https://github.com/mastra-ai/mastra/commit/bf936e2c89b2ff0dad5695b873ddc009ba96d41e)]:
20
+ - @mastra/core@1.58.0-alpha.6
21
+ - @mastra/agent-browser@0.5.1-alpha.0
22
+
3
23
  ## 0.2.0
4
24
 
5
25
  ### Minor Changes
package/dist/index.cjs CHANGED
@@ -1,259 +1,243 @@
1
- 'use strict';
2
-
3
- var agentBrowser = require('@mastra/agent-browser');
4
- var agentBrowser$1 = require('agent-browser');
5
- var firecrawl = require('firecrawl');
6
-
7
- // src/firecrawl-browser.ts
8
- var FirecrawlAgentBrowserThreadManager = class extends agentBrowser.AgentBrowserThreadManager {
9
- firecrawl;
10
- resolveWebSocketUrl;
11
- sessionOptions;
12
- constructor(config) {
13
- super(config);
14
- this.firecrawl = config.firecrawl;
15
- this.resolveWebSocketUrl = config.resolveWebSocketUrl;
16
- this.sessionOptions = config.sessionOptions ?? {};
17
- }
18
- async createSession(threadId) {
19
- const savedState = this.getSavedBrowserState(threadId);
20
- const session = {
21
- threadId,
22
- createdAt: Date.now(),
23
- browserState: savedState
24
- };
25
- if (this.scope === "thread") {
26
- const createRes = await this.firecrawl.browser({
27
- ttl: this.sessionOptions.ttl,
28
- activityTtl: this.sessionOptions.activityTtl,
29
- streamWebView: this.sessionOptions.streamWebView,
30
- profile: this.sessionOptions.profile,
31
- integration: this.sessionOptions.integration,
32
- origin: this.sessionOptions.origin
33
- });
34
- if (!createRes.success || !createRes.id || !createRes.cdpUrl) {
35
- const msg = createRes.error ?? "Firecrawl browser session creation failed";
36
- const err = new Error(`Firecrawl browser(): ${msg}`);
37
- if (createRes.id) {
38
- try {
39
- await this.firecrawl.deleteBrowser(createRes.id);
40
- } catch (cleanupErr) {
41
- this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);
42
- }
43
- }
44
- throw err;
45
- }
46
- session.firecrawlSessionId = createRes.id;
47
- const manager = new agentBrowser$1.BrowserManager();
48
- const wsUrl = await this.resolveWebSocketUrl(createRes.cdpUrl);
49
- const launchOptions = {
50
- headless: this.browserConfig.headless ?? true,
51
- viewport: this.browserConfig.viewport,
52
- profile: this.browserConfig.profile,
53
- executablePath: this.browserConfig.executablePath,
54
- storageState: this.browserConfig.storageState,
55
- cdpUrl: wsUrl
56
- };
57
- try {
58
- await manager.launch(launchOptions);
59
- } catch (error) {
60
- try {
61
- await manager.close();
62
- } catch {
63
- }
64
- try {
65
- await this.firecrawl.deleteBrowser(createRes.id);
66
- } catch {
67
- }
68
- throw error;
69
- }
70
- session.manager = manager;
71
- this.threadManagers.set(threadId, manager);
72
- try {
73
- if (savedState && savedState.tabs.length > 0) {
74
- this.logger?.debug?.(`Restoring browser state for thread ${threadId}: ${savedState.tabs.length} tabs`);
75
- await this.restoreBrowserState(manager, savedState);
76
- }
77
- this.onBrowserCreated?.(manager, threadId);
78
- } catch (error) {
79
- this.threadManagers.delete(threadId);
80
- session.manager = void 0;
81
- try {
82
- await manager.close();
83
- } catch {
84
- }
85
- if (session.firecrawlSessionId) {
86
- try {
87
- await this.firecrawl.deleteBrowser(session.firecrawlSessionId);
88
- } catch {
89
- }
90
- }
91
- throw error;
92
- }
93
- }
94
- return session;
95
- }
96
- async doDestroySession(session) {
97
- if (this.scope === "thread" && session.manager) {
98
- try {
99
- await session.manager.close();
100
- } catch {
101
- }
102
- this.threadManagers.delete(session.threadId);
103
- }
104
- if (session.firecrawlSessionId) {
105
- try {
106
- await this.firecrawl.deleteBrowser(session.firecrawlSessionId);
107
- } catch {
108
- }
109
- }
110
- }
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ let _mastra_agent_browser = require("@mastra/agent-browser");
3
+ let _mastra_core_browser = require("@mastra/core/browser");
4
+ let agent_browser = require("agent-browser");
5
+ let firecrawl = require("firecrawl");
6
+ //#region src/firecrawl-thread-manager.ts
7
+ /**
8
+ * Provisions a dedicated Firecrawl Browser Sandbox session per Mastra thread and connects Playwright over CDP.
9
+ */
10
+ var FirecrawlAgentBrowserThreadManager = class extends _mastra_agent_browser.AgentBrowserThreadManager {
11
+ firecrawl;
12
+ resolveWebSocketUrl;
13
+ sessionOptions;
14
+ constructor(config) {
15
+ super(config);
16
+ this.firecrawl = config.firecrawl;
17
+ this.resolveWebSocketUrl = config.resolveWebSocketUrl;
18
+ this.sessionOptions = config.sessionOptions ?? {};
19
+ }
20
+ async createSession(threadId) {
21
+ const savedState = this.getSavedBrowserState(threadId);
22
+ const session = {
23
+ threadId,
24
+ createdAt: Date.now(),
25
+ browserState: savedState
26
+ };
27
+ if (this.scope === "thread") {
28
+ const createRes = await this.firecrawl.browser({
29
+ ttl: this.sessionOptions.ttl,
30
+ activityTtl: this.sessionOptions.activityTtl,
31
+ streamWebView: this.sessionOptions.streamWebView,
32
+ profile: this.sessionOptions.profile,
33
+ integration: this.sessionOptions.integration,
34
+ origin: this.sessionOptions.origin
35
+ });
36
+ if (!createRes.success || !createRes.id || !createRes.cdpUrl) {
37
+ const msg = createRes.error ?? "Firecrawl browser session creation failed";
38
+ const err = /* @__PURE__ */ new Error(`Firecrawl browser(): ${msg}`);
39
+ if (createRes.id) try {
40
+ await this.firecrawl.deleteBrowser(createRes.id);
41
+ } catch (cleanupErr) {
42
+ this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);
43
+ }
44
+ throw err;
45
+ }
46
+ session.firecrawlSessionId = createRes.id;
47
+ const manager = new agent_browser.BrowserManager();
48
+ const wsUrl = await this.resolveWebSocketUrl(createRes.cdpUrl);
49
+ const launchOptions = {
50
+ headless: this.browserConfig.headless ?? true,
51
+ viewport: (0, _mastra_core_browser.resolveViewportSize)(this.browserConfig.viewport) ?? _mastra_core_browser.DEFAULT_BROWSER_VIEWPORT,
52
+ profile: this.browserConfig.profile,
53
+ executablePath: this.browserConfig.executablePath,
54
+ storageState: this.browserConfig.storageState,
55
+ cdpUrl: wsUrl
56
+ };
57
+ try {
58
+ await manager.launch(launchOptions);
59
+ } catch (error) {
60
+ try {
61
+ await manager.close();
62
+ } catch {}
63
+ try {
64
+ await this.firecrawl.deleteBrowser(createRes.id);
65
+ } catch {}
66
+ throw error;
67
+ }
68
+ session.manager = manager;
69
+ this.threadManagers.set(threadId, manager);
70
+ try {
71
+ if (savedState && savedState.tabs.length > 0) {
72
+ this.logger?.debug?.(`Restoring browser state for thread ${threadId}: ${savedState.tabs.length} tabs`);
73
+ await this.restoreBrowserState(manager, savedState);
74
+ }
75
+ this.onBrowserCreated?.(manager, threadId);
76
+ } catch (error) {
77
+ this.threadManagers.delete(threadId);
78
+ session.manager = void 0;
79
+ try {
80
+ await manager.close();
81
+ } catch {}
82
+ if (session.firecrawlSessionId) try {
83
+ await this.firecrawl.deleteBrowser(session.firecrawlSessionId);
84
+ } catch {}
85
+ throw error;
86
+ }
87
+ }
88
+ return session;
89
+ }
90
+ async doDestroySession(session) {
91
+ if (this.scope === "thread" && session.manager) {
92
+ try {
93
+ await session.manager.close();
94
+ } catch {}
95
+ this.threadManagers.delete(session.threadId);
96
+ }
97
+ if (session.firecrawlSessionId) try {
98
+ await this.firecrawl.deleteBrowser(session.firecrawlSessionId);
99
+ } catch {}
100
+ }
111
101
  };
112
-
113
- // src/resolve-cdp.ts
102
+ //#endregion
103
+ //#region src/resolve-cdp.ts
104
+ /**
105
+ * Resolve an HTTP CDP endpoint to a WebSocket URL (same behavior as MastraBrowser.resolveWebSocketUrl).
106
+ */
114
107
  async function resolveCdpWebSocketUrl(url, logger) {
115
- if (url.startsWith("ws://") || url.startsWith("wss://")) {
116
- return url;
117
- }
118
- if (url.startsWith("http://") || url.startsWith("https://")) {
119
- const baseUrl = url.replace(/\/$/, "");
120
- const versionUrl = `${baseUrl}/json/version`;
121
- logger?.debug?.(`Resolving WebSocket URL from ${versionUrl}`);
122
- const controller = new AbortController();
123
- const timeoutId = setTimeout(() => controller.abort(), 1e4);
124
- try {
125
- const response = await fetch(versionUrl, { signal: controller.signal });
126
- if (!response.ok) {
127
- throw new Error(
128
- `Failed to fetch CDP version info from ${versionUrl}: ${response.status} ${response.statusText}`
129
- );
130
- }
131
- const data = await response.json();
132
- if (!data.webSocketDebuggerUrl) {
133
- throw new Error(`No webSocketDebuggerUrl found in CDP version response from ${versionUrl}`);
134
- }
135
- logger?.debug?.(`Resolved WebSocket URL: ${data.webSocketDebuggerUrl}`);
136
- return data.webSocketDebuggerUrl;
137
- } catch (error) {
138
- if (error instanceof Error && error.name === "AbortError") {
139
- throw new Error(`Timeout resolving WebSocket URL from ${versionUrl} (10s)`);
140
- }
141
- throw error;
142
- } finally {
143
- clearTimeout(timeoutId);
144
- }
145
- }
146
- return url;
108
+ if (url.startsWith("ws://") || url.startsWith("wss://")) return url;
109
+ if (url.startsWith("http://") || url.startsWith("https://")) {
110
+ const versionUrl = `${url.replace(/\/$/, "")}/json/version`;
111
+ logger?.debug?.(`Resolving WebSocket URL from ${versionUrl}`);
112
+ const controller = new AbortController();
113
+ const timeoutId = setTimeout(() => controller.abort(), 1e4);
114
+ try {
115
+ const response = await fetch(versionUrl, { signal: controller.signal });
116
+ if (!response.ok) throw new Error(`Failed to fetch CDP version info from ${versionUrl}: ${response.status} ${response.statusText}`);
117
+ const data = await response.json();
118
+ if (!data.webSocketDebuggerUrl) throw new Error(`No webSocketDebuggerUrl found in CDP version response from ${versionUrl}`);
119
+ logger?.debug?.(`Resolved WebSocket URL: ${data.webSocketDebuggerUrl}`);
120
+ return data.webSocketDebuggerUrl;
121
+ } catch (error) {
122
+ if (error instanceof Error && error.name === "AbortError") throw new Error(`Timeout resolving WebSocket URL from ${versionUrl} (10s)`);
123
+ throw error;
124
+ } finally {
125
+ clearTimeout(timeoutId);
126
+ }
127
+ }
128
+ return url;
147
129
  }
148
-
149
- // src/firecrawl-browser.ts
130
+ //#endregion
131
+ //#region src/firecrawl-browser.ts
150
132
  function pickSessionOpts(c) {
151
- return c.firecrawl ?? {};
133
+ return c.firecrawl ?? {};
152
134
  }
153
135
  function toBaseConfig(config) {
154
- const { apiKey: _a, apiUrl: _u, firecrawl: _f, ...rest } = config;
155
- return rest;
136
+ const { apiKey: _a, apiUrl: _u, firecrawl: _f, ...rest } = config;
137
+ return rest;
156
138
  }
157
- var FirecrawlBrowser = class extends agentBrowser.AgentBrowser {
158
- name = "FirecrawlBrowser";
159
- provider = "firecrawl/browser-sandbox";
160
- firecrawl;
161
- sessionOpts;
162
- sharedFirecrawlSessionId;
163
- constructor(config) {
164
- const apiKey = config.apiKey ?? process.env.FIRECRAWL_API_KEY;
165
- if (!apiKey) {
166
- throw new Error("FirecrawlBrowser requires `apiKey` or FIRECRAWL_API_KEY");
167
- }
168
- const fc = new firecrawl.Firecrawl({ apiKey, apiUrl: config.apiUrl });
169
- const sessionOpts = pickSessionOpts(config);
170
- super({
171
- ...toBaseConfig(config),
172
- createThreadManager: (opts) => new FirecrawlAgentBrowserThreadManager({
173
- ...opts,
174
- firecrawl: fc,
175
- resolveWebSocketUrl: (url) => resolveCdpWebSocketUrl(url, opts.logger),
176
- sessionOptions: sessionOpts
177
- })
178
- });
179
- this.firecrawl = fc;
180
- this.sessionOpts = sessionOpts;
181
- }
182
- async doLaunch() {
183
- const scope = this.threadManager.getScope();
184
- if (scope === "thread") {
185
- await super.doLaunch();
186
- return;
187
- }
188
- const createRes = await this.firecrawl.browser({
189
- ttl: this.sessionOpts.ttl,
190
- activityTtl: this.sessionOpts.activityTtl,
191
- streamWebView: this.sessionOpts.streamWebView,
192
- profile: this.sessionOpts.profile,
193
- integration: this.sessionOpts.integration,
194
- origin: this.sessionOpts.origin
195
- });
196
- if (!createRes.success || !createRes.id || !createRes.cdpUrl) {
197
- const msg = createRes.error ?? "Firecrawl browser session creation failed";
198
- const err = new Error(`Firecrawl browser(): ${msg}`);
199
- if (createRes.id) {
200
- try {
201
- await this.firecrawl.deleteBrowser(createRes.id);
202
- } catch (cleanupErr) {
203
- this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);
204
- }
205
- }
206
- throw err;
207
- }
208
- const sessionId = createRes.id;
209
- this.sharedManager = new agentBrowser$1.BrowserManager();
210
- try {
211
- const localConfig = this.config;
212
- const wsUrl = await resolveCdpWebSocketUrl(createRes.cdpUrl, this.logger);
213
- const launchOptions = {
214
- headless: localConfig.headless ?? true,
215
- viewport: localConfig.viewport,
216
- profile: localConfig.profile,
217
- executablePath: localConfig.executablePath,
218
- storageState: localConfig.storageState,
219
- cdpUrl: wsUrl
220
- };
221
- await this.sharedManager.launch(launchOptions);
222
- this.threadManager.setSharedManager(this.sharedManager);
223
- this.setupCloseListenerForSharedScope(this.sharedManager);
224
- this.sharedFirecrawlSessionId = sessionId;
225
- } catch (launchErr) {
226
- try {
227
- await this.sharedManager.close();
228
- } catch (closeErr) {
229
- this.logger?.warn?.(`BrowserManager.close() after failed shared launch: ${closeErr}`);
230
- }
231
- try {
232
- await this.firecrawl.deleteBrowser(sessionId);
233
- } catch (delErr) {
234
- this.logger?.warn?.(`Firecrawl deleteBrowser(${sessionId}) after failed shared launch: ${delErr}`);
235
- }
236
- this.sharedManager = null;
237
- this.sharedFirecrawlSessionId = void 0;
238
- throw launchErr;
239
- }
240
- }
241
- async doClose() {
242
- const sid = this.sharedFirecrawlSessionId;
243
- await super.doClose();
244
- if (sid) {
245
- try {
246
- await this.firecrawl.deleteBrowser(sid);
247
- } catch (err) {
248
- this.logger?.warn?.(`Firecrawl deleteBrowser(${sid}) failed: ${err}`);
249
- }
250
- this.sharedFirecrawlSessionId = void 0;
251
- }
252
- }
139
+ /**
140
+ * Mastra browser provider backed by [Firecrawl Browser Sandbox](https://docs.firecrawl.dev/features/browser):
141
+ * provisions remote sessions via API and drives them with the same deterministic tools as {@link AgentBrowser}.
142
+ */
143
+ var FirecrawlBrowser = class extends _mastra_agent_browser.AgentBrowser {
144
+ name = "FirecrawlBrowser";
145
+ provider = "firecrawl/browser-sandbox";
146
+ firecrawl;
147
+ sessionOpts;
148
+ sharedFirecrawlSessionId;
149
+ constructor(config) {
150
+ const apiKey = config.apiKey ?? process.env.FIRECRAWL_API_KEY;
151
+ if (!apiKey) throw new Error("FirecrawlBrowser requires `apiKey` or FIRECRAWL_API_KEY");
152
+ const fc = new firecrawl.Firecrawl({
153
+ apiKey,
154
+ apiUrl: config.apiUrl
155
+ });
156
+ const sessionOpts = pickSessionOpts(config);
157
+ super({
158
+ ...toBaseConfig(config),
159
+ createThreadManager: (opts) => new FirecrawlAgentBrowserThreadManager({
160
+ ...opts,
161
+ firecrawl: fc,
162
+ resolveWebSocketUrl: (url) => resolveCdpWebSocketUrl(url, opts.logger),
163
+ sessionOptions: sessionOpts
164
+ })
165
+ });
166
+ this.firecrawl = fc;
167
+ this.sessionOpts = sessionOpts;
168
+ }
169
+ async doLaunch() {
170
+ if (this.threadManager.getScope() === "thread") {
171
+ await super.doLaunch();
172
+ return;
173
+ }
174
+ const createRes = await this.firecrawl.browser({
175
+ ttl: this.sessionOpts.ttl,
176
+ activityTtl: this.sessionOpts.activityTtl,
177
+ streamWebView: this.sessionOpts.streamWebView,
178
+ profile: this.sessionOpts.profile,
179
+ integration: this.sessionOpts.integration,
180
+ origin: this.sessionOpts.origin
181
+ });
182
+ if (!createRes.success || !createRes.id || !createRes.cdpUrl) {
183
+ const msg = createRes.error ?? "Firecrawl browser session creation failed";
184
+ const err = /* @__PURE__ */ new Error(`Firecrawl browser(): ${msg}`);
185
+ if (createRes.id) try {
186
+ await this.firecrawl.deleteBrowser(createRes.id);
187
+ } catch (cleanupErr) {
188
+ this.logger?.warn?.(`Firecrawl deleteBrowser(${createRes.id}) after failed browser(): ${cleanupErr}`);
189
+ }
190
+ throw err;
191
+ }
192
+ const sessionId = createRes.id;
193
+ this.sharedManager = new agent_browser.BrowserManager();
194
+ try {
195
+ const localConfig = this.config;
196
+ const wsUrl = await resolveCdpWebSocketUrl(createRes.cdpUrl, this.logger);
197
+ const launchOptions = {
198
+ headless: localConfig.headless ?? true,
199
+ viewport: (0, _mastra_core_browser.resolveViewportSize)(localConfig.viewport) ?? _mastra_core_browser.DEFAULT_BROWSER_VIEWPORT,
200
+ profile: localConfig.profile,
201
+ executablePath: localConfig.executablePath,
202
+ storageState: localConfig.storageState,
203
+ cdpUrl: wsUrl
204
+ };
205
+ await this.sharedManager.launch(launchOptions);
206
+ this.threadManager.setSharedManager(this.sharedManager);
207
+ this.setupCloseListenerForSharedScope(this.sharedManager);
208
+ this.sharedFirecrawlSessionId = sessionId;
209
+ } catch (launchErr) {
210
+ try {
211
+ await this.sharedManager.close();
212
+ } catch (closeErr) {
213
+ this.logger?.warn?.(`BrowserManager.close() after failed shared launch: ${closeErr}`);
214
+ }
215
+ try {
216
+ await this.firecrawl.deleteBrowser(sessionId);
217
+ } catch (delErr) {
218
+ this.logger?.warn?.(`Firecrawl deleteBrowser(${sessionId}) after failed shared launch: ${delErr}`);
219
+ }
220
+ this.sharedManager = null;
221
+ this.sharedFirecrawlSessionId = void 0;
222
+ throw launchErr;
223
+ }
224
+ }
225
+ async doClose() {
226
+ const sid = this.sharedFirecrawlSessionId;
227
+ await super.doClose();
228
+ if (sid) {
229
+ try {
230
+ await this.firecrawl.deleteBrowser(sid);
231
+ } catch (err) {
232
+ this.logger?.warn?.(`Firecrawl deleteBrowser(${sid}) failed: ${err}`);
233
+ }
234
+ this.sharedFirecrawlSessionId = void 0;
235
+ }
236
+ }
253
237
  };
254
-
238
+ //#endregion
255
239
  exports.FirecrawlAgentBrowserThreadManager = FirecrawlAgentBrowserThreadManager;
256
240
  exports.FirecrawlBrowser = FirecrawlBrowser;
257
241
  exports.resolveCdpWebSocketUrl = resolveCdpWebSocketUrl;
258
- //# sourceMappingURL=index.cjs.map
242
+
259
243
  //# sourceMappingURL=index.cjs.map