@mastra/parallel 0.0.0 → 0.1.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @mastra/parallel
 
+## 0.1.0
+
+### Minor Changes
+
+- Added Parallel Search and Extract tools for Mastra agents through the new `@mastra/parallel` package. ([#22070](https://github.com/mastra-ai/mastra/pull/22070))
+
+  ```typescript
+  import { createParallelTools } from '@mastra/parallel';
+
+  const tools = createParallelTools();
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`79f04a7`](https://github.com/mastra-ai/mastra/commit/79f04a7f6c6829da541139f638f2f1d267916e08), [`65edab1`](https://github.com/mastra-ai/mastra/commit/65edab1c233d17b8f163bad12fca410d0e6f16b1), [`1e47b75`](https://github.com/mastra-ai/mastra/commit/1e47b7520cab4cfaa8daed52f17e2e6d14ff7539), [`ab20a38`](https://github.com/mastra-ai/mastra/commit/ab20a38d0275f8d85e0f3833bd87ef487bcc609f), [`fd4d5fe`](https://github.com/mastra-ai/mastra/commit/fd4d5fe4f943699b85db5e74404f190d5a6b8c2a), [`ae8790c`](https://github.com/mastra-ai/mastra/commit/ae8790c4bfaa088d2ab279d1dcc06f326b9fd109), [`2c85f42`](https://github.com/mastra-ai/mastra/commit/2c85f428e04ccd63ea31a7ec80b5b327afdad555), [`11bbeb9`](https://github.com/mastra-ai/mastra/commit/11bbeb9b108ef2264e05acefc6dafb9cbb342921), [`48ef1f1`](https://github.com/mastra-ai/mastra/commit/48ef1f1d24eedafbb07f64e659a81b52b67b8bf6), [`aa3a85d`](https://github.com/mastra-ai/mastra/commit/aa3a85daf094c683bb97efdf4b6a696d2e474af5), [`d29d06f`](https://github.com/mastra-ai/mastra/commit/d29d06fe00bbd35b4571150ea04c59d2ed783c71), [`e6516df`](https://github.com/mastra-ai/mastra/commit/e6516dfcdae4f4ac0e7971d84359a81385ee602f), [`1a485f3`](https://github.com/mastra-ai/mastra/commit/1a485f3538f5ec64d58bd8b5e1e99de0c695c87b), [`0d37487`](https://github.com/mastra-ai/mastra/commit/0d37487d9f349388a3f1cef6a536cf9dcc4b6273), [`8661d7d`](https://github.com/mastra-ai/mastra/commit/8661d7d7179f0a024456aabdd8679bcecd09ac28), [`dbbfeb8`](https://github.com/mastra-ai/mastra/commit/dbbfeb85ec949dc9ebc0755e1ad262e4f5eba8db), [`575e343`](https://github.com/mastra-ai/mastra/commit/575e343900451021d96110916497d334af7bc252), [`0b2a3d1`](https://github.com/mastra-ai/mastra/commit/0b2a3d1783875c5b97b7b36ab3d03d7360e0dde7), [`6bb5d71`](https://github.com/mastra-ai/mastra/commit/6bb5d7193fe9166b219f0fccae17db7a5ae86e65), [`3cc9d00`](https://github.com/mastra-ai/mastra/commit/3cc9d00b2b4333e0377a5e9df5eff92c17ce7630), [`cacb839`](https://github.com/mastra-ai/mastra/commit/cacb8392d9e74189b56d857290b0615f98a2683d), [`57de7d6`](https://github.com/mastra-ai/mastra/commit/57de7d644ba7146edb4e9e6111ec4fa98c3a59e9), [`c8e4cea`](https://github.com/mastra-ai/mastra/commit/c8e4ceac9a390d78c8327dff3cdb2861dd71957f), [`ed01e9a`](https://github.com/mastra-ai/mastra/commit/ed01e9a807514a904374bf687a7b8f18750f6f78), [`b47b26e`](https://github.com/mastra-ai/mastra/commit/b47b26e6fe95cb8a3482be2c5e52de157fe59d0b), [`0d37487`](https://github.com/mastra-ai/mastra/commit/0d37487d9f349388a3f1cef6a536cf9dcc4b6273), [`733a537`](https://github.com/mastra-ai/mastra/commit/733a537489a858b5880b2e98809334fba895a221), [`e8e299c`](https://github.com/mastra-ai/mastra/commit/e8e299cc6abdfc39947e2fec25803493015d3882), [`edfc548`](https://github.com/mastra-ai/mastra/commit/edfc548886bc7bae17b681f8b6b41a47eb32bcd2), [`b05f486`](https://github.com/mastra-ai/mastra/commit/b05f48612984d5fe2447ea2d6cdd5c604d285b97), [`a8a4871`](https://github.com/mastra-ai/mastra/commit/a8a4871215f51da95c47129602157ce5372f634a), [`eb9ecaa`](https://github.com/mastra-ai/mastra/commit/eb9ecaa89c36e889749e3b825cfc507ce7f7980b), [`4ff3ee2`](https://github.com/mastra-ai/mastra/commit/4ff3ee2bff7ed07528b4817f8f49639031c72a4d), [`9207dfa`](https://github.com/mastra-ai/mastra/commit/9207dfab8062e5fc68b751684797ff86fe0b4e70), [`5165cdc`](https://github.com/mastra-ai/mastra/commit/5165cdcdcf50e144bb8113278535196cc9b07065), [`e737014`](https://github.com/mastra-ai/mastra/commit/e737014e0fc7035759762bb5b48baef1d6c0f6a7), [`6bb5d71`](https://github.com/mastra-ai/mastra/commit/6bb5d7193fe9166b219f0fccae17db7a5ae86e65), [`f591643`](https://github.com/mastra-ai/mastra/commit/f591643becdf0be9bddce6ba1748e64bc30d77f1), [`63796ba`](https://github.com/mastra-ai/mastra/commit/63796ba0fda60253be17535e68f6bbbf1e6ffa09), [`b1ad324`](https://github.com/mastra-ai/mastra/commit/b1ad324d657f3544b0701332aef7eb10e9a36258), [`61c566d`](https://github.com/mastra-ai/mastra/commit/61c566dd2f2cde2b23ed8f139924e530d4202214), [`c24754c`](https://github.com/mastra-ai/mastra/commit/c24754c1fb6fe144e5051e536e98c8a18b0214ac), [`12c61d2`](https://github.com/mastra-ai/mastra/commit/12c61d280c8cb208bc3c8dbcbe5dcc60cf9d1cd0), [`c46eb09`](https://github.com/mastra-ai/mastra/commit/c46eb09ce4987509af57a0ac582c61241a6dd2f1), [`9ee8120`](https://github.com/mastra-ai/mastra/commit/9ee8120ce17f76b9f617489e05a283353742690a), [`d975e92`](https://github.com/mastra-ai/mastra/commit/d975e924d4936f46c386bd3dee39c671720289f6), [`45dd6ee`](https://github.com/mastra-ai/mastra/commit/45dd6ee089bd7df0d0c98a10098e483fd388e04a), [`4e9a228`](https://github.com/mastra-ai/mastra/commit/4e9a2283d5fd6ed1b70a2751eb3dc2cbf82ada20), [`d6ce34a`](https://github.com/mastra-ai/mastra/commit/d6ce34aeceb06ddf3d595a1eed5cc74f481a46a1), [`f95f468`](https://github.com/mastra-ai/mastra/commit/f95f468cf1e7c2b924a13826494f98b8f2ccd581), [`30ed33e`](https://github.com/mastra-ai/mastra/commit/30ed33ee14084a26019aba15fceadda6d6ddefaf), [`04a815f`](https://github.com/mastra-ai/mastra/commit/04a815fc8971d29e97fcdcc5008a1eb472fc00ff), [`1cfa878`](https://github.com/mastra-ai/mastra/commit/1cfa8784d8da0dfaa0317e5048bc48b6084a5ea5), [`9a12ef3`](https://github.com/mastra-ai/mastra/commit/9a12ef3fccf3f4186db0f294f4ee1f02cf4d8db2), [`32d3583`](https://github.com/mastra-ai/mastra/commit/32d358332cb8ac2306b83b73cf3536e74dbd435e), [`7960688`](https://github.com/mastra-ai/mastra/commit/7960688828e04eaf3106e34f7758fa580257eef6), [`91ad69d`](https://github.com/mastra-ai/mastra/commit/91ad69d64994c89199b0c55399e64ed91c61df2f), [`8dc408d`](https://github.com/mastra-ai/mastra/commit/8dc408d34438f9e13297f792c11a5cfd6cf952e1), [`c92def1`](https://github.com/mastra-ai/mastra/commit/c92def10a13c822972c96f0a4ca6ffc1f4258aed), [`63041eb`](https://github.com/mastra-ai/mastra/commit/63041eb4c50b520a0a80e03d4cd6ea99f67715a0), [`c118318`](https://github.com/mastra-ai/mastra/commit/c1183181c9804303db4b511c2e2648f8b714712b), [`c5eaec5`](https://github.com/mastra-ai/mastra/commit/c5eaec5a860d80d0e3805e67db0414b87ac8cbed), [`fc07c64`](https://github.com/mastra-ai/mastra/commit/fc07c6465043e08e99193a6751a01c56ffc2e7a1), [`cced745`](https://github.com/mastra-ai/mastra/commit/cced745a056ec2225c5bc702e32d848847aa8b65), [`542dee2`](https://github.com/mastra-ai/mastra/commit/542dee254167f974ff8cbbbfc0ce10f9a2616a7b), [`3c19dce`](https://github.com/mastra-ai/mastra/commit/3c19dcef8e73062a80627a4927eae3ec11145afd), [`aca2869`](https://github.com/mastra-ai/mastra/commit/aca2869b2031982f3c4a2f52525c9be7cf123ef8), [`a58483c`](https://github.com/mastra-ai/mastra/commit/a58483cff1a9d41fce7c931843f48cb0ac450f64), [`a58483c`](https://github.com/mastra-ai/mastra/commit/a58483cff1a9d41fce7c931843f48cb0ac450f64), [`e6f8450`](https://github.com/mastra-ai/mastra/commit/e6f845074d478527026b18d85031b23353e1d0a4), [`895e9df`](https://github.com/mastra-ai/mastra/commit/895e9dfc17d6f34299eca64e317ded9e5f5e5ef8), [`e66b2ba`](https://github.com/mastra-ai/mastra/commit/e66b2ba100db63eaeab6e21e1ea34b113f2ec781), [`3e8727e`](https://github.com/mastra-ai/mastra/commit/3e8727e11ec1a5d733acedb5c872896394be18c1)]:
+  - @mastra/core@1.62.0
+
 ## 0.1.0-alpha.0
 
 ### Minor Changes

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/client.d.ts

@@ -0,0 +1,7 @@
+import Parallel from 'parallel-web';
+import type { ClientOptions } from 'parallel-web';
+export type ParallelClientOptions = ClientOptions;
+export type ParallelClient = Parallel;
+export declare function getParallelClient(config?: ParallelClientOptions): ParallelClient;
+export declare function createLazyParallelClient(config?: ParallelClientOptions): () => ParallelClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAClD,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEtC,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAOhF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,MAAM,cAAc,CAO7F"}

package/dist/extract.d.ts

@@ -0,0 +1,42 @@
+import type { ParallelClientOptions } from './client.js';
+export declare function createParallelExtractTool(config?: ParallelClientOptions): import("@mastra/core/tools").Tool<{
+    urls: string[];
+    objective?: string | undefined;
+    searchQueries?: string[] | undefined;
+    excerptMaxCharsPerResult?: number | undefined;
+    clientModel?: string | undefined;
+    fullContent?: number | boolean | undefined;
+    maxCharsTotal?: number | undefined;
+    fetchPolicy?: {
+        maxAgeSeconds?: number | undefined;
+        timeoutSeconds?: number | undefined;
+        disableCacheFallback?: boolean | undefined;
+    } | undefined;
+    sessionId?: string | undefined;
+}, {
+    extractId: string;
+    sessionId: string;
+    results: {
+        url: string;
+        excerpts: string[];
+        title?: string | undefined;
+        publishDate?: string | undefined;
+        fullContent?: string | undefined;
+    }[];
+    errors: {
+        url: string;
+        errorType: string;
+        httpStatusCode?: number | undefined;
+        content?: string | undefined;
+    }[];
+    usage?: {
+        name: string;
+        count: number;
+    }[] | undefined;
+    warnings?: {
+        type: string;
+        message: string;
+        detail?: Record<string, unknown> | undefined;
+    }[] | undefined;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "parallel-extract", unknown>;
+//# sourceMappingURL=extract.d.ts.map

package/dist/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAuGzD,wBAAgB,yBAAyB,CAAC,MAAM,CAAC,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gIAqCvE"}

package/dist/index.cjs

@@ -0,0 +1,290 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let parallel_web = require("parallel-web");
+parallel_web = __toESM(parallel_web, 1);
+let _mastra_core_tools = require("@mastra/core/tools");
+let zod = require("zod");
+//#region src/client.ts
+function getParallelClient(config) {
+	const apiKey = config?.apiKey ?? process.env.PARALLEL_API_KEY;
+	if (!apiKey) throw new Error("Parallel API key is required. Pass { apiKey } or set the PARALLEL_API_KEY environment variable.");
+	return new parallel_web.default({
+		...config,
+		apiKey
+	});
+}
+function createLazyParallelClient(config) {
+	let client;
+	return () => {
+		client ??= getParallelClient(config);
+		return client;
+	};
+}
+//#endregion
+//#region src/schemas.ts
+const usageItemSchema = zod.z.object({
+	name: zod.z.string(),
+	count: zod.z.number()
+});
+const warningSchema = zod.z.object({
+	type: zod.z.string(),
+	message: zod.z.string(),
+	detail: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
+});
+const searchResultSchema = zod.z.object({
+	url: zod.z.string(),
+	title: zod.z.string().optional(),
+	publishDate: zod.z.string().optional(),
+	excerpts: zod.z.array(zod.z.string())
+});
+const fetchPolicySchema = zod.z.object({
+	maxAgeSeconds: zod.z.number().int().min(600).optional().describe("Maximum cached-content age in seconds before Parallel attempts a live fetch (minimum 600)."),
+	timeoutSeconds: zod.z.number().int().positive().optional().describe("Timeout in seconds for a live fetch."),
+	disableCacheFallback: zod.z.boolean().optional().describe("Return an error instead of older cached content when a live fetch fails or times out.")
+});
+//#endregion
+//#region src/search.ts
+const ISO_3166_ALPHA_2_CODES = new Set(`AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ
+BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ
+CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ
+DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR
+GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY
+HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP
+KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY
+MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ
+NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY
+QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ
+TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ
+VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW`.split(/\s+/));
+function isValidCalendarDate(value) {
+	const [yearText, monthText, dayText] = value.split("-");
+	if (yearText === void 0 || monthText === void 0 || dayText === void 0) return false;
+	const year = Number(yearText);
+	const month = Number(monthText);
+	const day = Number(dayText);
+	const daysInMonth = [
+		31,
+		year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0) ? 29 : 28,
+		31,
+		30,
+		31,
+		30,
+		31,
+		31,
+		30,
+		31,
+		30,
+		31
+	];
+	return month >= 1 && month <= 12 && day >= 1 && day <= daysInMonth[month - 1];
+}
+const inputSchema$1 = zod.z.object({
+	searchQueries: zod.z.array(zod.z.string().min(1)).min(1).describe("Concise keyword search queries, ideally 3-6 words each. Provide 2-3 queries for best results."),
+	objective: zod.z.string().optional().describe("A self-contained natural-language description of the goal driving the search."),
+	mode: zod.z.enum([
+		"turbo",
+		"fast",
+		"basic",
+		"advanced"
+	]).optional().describe("Search mode. Defaults to advanced when omitted."),
+	clientModel: zod.z.string().optional().describe("Model that will consume the results, used by Parallel to tailor response defaults."),
+	maxResults: zod.z.number().int().positive().optional().describe("Maximum number of results to return."),
+	excerptMaxCharsPerResult: zod.z.number().int().positive().optional().describe("Maximum excerpt characters to return for each result."),
+	maxCharsTotal: zod.z.number().int().positive().optional().describe("Maximum total excerpt characters across all results."),
+	location: zod.z.string().refine((value) => ISO_3166_ALPHA_2_CODES.has(value.toUpperCase()), { message: "location must be a valid ISO 3166-1 alpha-2 country code." }).optional().describe("ISO 3166-1 alpha-2 country code for geo-targeted results."),
+	includeDomains: zod.z.array(zod.z.string()).max(200).optional().describe("Only return results from these domains."),
+	excludeDomains: zod.z.array(zod.z.string()).max(200).optional().describe("Exclude results from these domains."),
+	afterDate: zod.z.string().regex(/^\d{4}-\d{2}-\d{2}$/).refine(isValidCalendarDate, { message: "afterDate must be a valid calendar date in YYYY-MM-DD format." }).optional().describe("Only return content published on or after this YYYY-MM-DD date."),
+	fetchPolicy: fetchPolicySchema.optional().describe("Live-fetch and cached-content policy for search results."),
+	sessionId: zod.z.string().optional().describe("Session identifier shared across related Search and Extract calls.")
+}).refine((input) => (input.includeDomains?.length ?? 0) + (input.excludeDomains?.length ?? 0) <= 200, {
+	message: "includeDomains and excludeDomains can contain at most 200 domains combined.",
+	path: ["includeDomains"]
+});
+const outputSchema$1 = zod.z.object({
+	searchId: zod.z.string(),
+	sessionId: zod.z.string(),
+	results: zod.z.array(searchResultSchema),
+	usage: zod.z.array(usageItemSchema).optional(),
+	warnings: zod.z.array(warningSchema).optional()
+});
+function toFetchPolicy$1(input) {
+	return {
+		max_age_seconds: input.maxAgeSeconds,
+		timeout_seconds: input.timeoutSeconds,
+		disable_cache_fallback: input.disableCacheFallback
+	};
+}
+function toSearchParams(input) {
+	const params = { search_queries: input.searchQueries };
+	if (input.objective !== void 0) params.objective = input.objective;
+	if (input.mode !== void 0) params.mode = input.mode;
+	if (input.clientModel !== void 0) params.client_model = input.clientModel;
+	if (input.maxCharsTotal !== void 0) params.max_chars_total = input.maxCharsTotal;
+	if (input.sessionId !== void 0) params.session_id = input.sessionId;
+	const sourcePolicy = input.includeDomains !== void 0 || input.excludeDomains !== void 0 || input.afterDate !== void 0 ? {
+		include_domains: input.includeDomains,
+		exclude_domains: input.excludeDomains,
+		after_date: input.afterDate
+	} : void 0;
+	if (input.maxResults !== void 0 || input.excerptMaxCharsPerResult !== void 0 || input.location !== void 0 || sourcePolicy !== void 0 || input.fetchPolicy !== void 0) params.advanced_settings = {
+		max_results: input.maxResults,
+		excerpt_settings: input.excerptMaxCharsPerResult === void 0 ? void 0 : { max_chars_per_result: input.excerptMaxCharsPerResult },
+		location: input.location,
+		source_policy: sourcePolicy,
+		fetch_policy: input.fetchPolicy === void 0 ? void 0 : toFetchPolicy$1(input.fetchPolicy)
+	};
+	return params;
+}
+function createParallelSearchTool(config) {
+	const getClient = createLazyParallelClient(config);
+	return (0, _mastra_core_tools.createTool)({
+		id: "parallel-search",
+		description: "Search the web with Parallel. Returns ranked URLs and token-efficient excerpts focused on the search objective.",
+		inputSchema: inputSchema$1,
+		outputSchema: outputSchema$1,
+		execute: async (input) => {
+			const response = await getClient().search(toSearchParams(input));
+			return {
+				searchId: response.search_id,
+				sessionId: response.session_id,
+				results: response.results.map((result) => ({
+					url: result.url,
+					title: result.title ?? void 0,
+					publishDate: result.publish_date ?? void 0,
+					excerpts: result.excerpts
+				})),
+				usage: response.usage ?? void 0,
+				warnings: response.warnings?.map((warning) => ({
+					type: warning.type,
+					message: warning.message,
+					detail: warning.detail ?? void 0
+				}))
+			};
+		}
+	});
+}
+//#endregion
+//#region src/extract.ts
+const inputSchema = zod.z.object({
+	urls: zod.z.array(zod.z.string().url()).min(1).max(20).describe("URLs to extract content from (1-20)."),
+	objective: zod.z.string().optional().describe("A natural-language description of the information to focus on while extracting."),
+	searchQueries: zod.z.array(zod.z.string().min(1)).min(1).optional().describe("Optional keyword queries used with the objective to focus excerpts."),
+	excerptMaxCharsPerResult: zod.z.number().int().positive().optional().describe("Maximum excerpt characters to return for each URL."),
+	clientModel: zod.z.string().optional().describe("Model that will consume the results, used by Parallel to tailor response defaults."),
+	fullContent: zod.z.union([zod.z.boolean(), zod.z.number().int().positive()]).optional().describe("Return full page content. Pass a character limit instead of true to cap content per URL."),
+	maxCharsTotal: zod.z.number().int().positive().optional().describe("Maximum total characters across all extracted results."),
+	fetchPolicy: fetchPolicySchema.optional().describe("Live-fetch and cached-content policy for extracted URLs."),
+	sessionId: zod.z.string().optional().describe("Session identifier shared across related Search and Extract calls.")
+});
+const outputSchema = zod.z.object({
+	extractId: zod.z.string(),
+	sessionId: zod.z.string(),
+	results: zod.z.array(zod.z.object({
+		url: zod.z.string(),
+		title: zod.z.string().optional(),
+		publishDate: zod.z.string().optional(),
+		excerpts: zod.z.array(zod.z.string()),
+		fullContent: zod.z.string().optional()
+	})),
+	errors: zod.z.array(zod.z.object({
+		url: zod.z.string(),
+		errorType: zod.z.string(),
+		httpStatusCode: zod.z.number().optional(),
+		content: zod.z.string().optional()
+	})),
+	usage: zod.z.array(usageItemSchema).optional(),
+	warnings: zod.z.array(warningSchema).optional()
+});
+function toFetchPolicy(input) {
+	return {
+		max_age_seconds: input.maxAgeSeconds,
+		timeout_seconds: input.timeoutSeconds,
+		disable_cache_fallback: input.disableCacheFallback
+	};
+}
+function toExtractParams(input) {
+	const params = { urls: input.urls };
+	if (input.objective !== void 0) params.objective = input.objective;
+	if (input.searchQueries !== void 0) params.search_queries = input.searchQueries;
+	if (input.clientModel !== void 0) params.client_model = input.clientModel;
+	if (input.maxCharsTotal !== void 0) params.max_chars_total = input.maxCharsTotal;
+	if (input.sessionId !== void 0) params.session_id = input.sessionId;
+	if (input.excerptMaxCharsPerResult !== void 0 || input.fullContent !== void 0 || input.fetchPolicy !== void 0) params.advanced_settings = {
+		excerpt_settings: input.excerptMaxCharsPerResult === void 0 ? void 0 : { max_chars_per_result: input.excerptMaxCharsPerResult },
+		full_content: typeof input.fullContent === "number" ? { max_chars_per_result: input.fullContent } : input.fullContent,
+		fetch_policy: input.fetchPolicy === void 0 ? void 0 : toFetchPolicy(input.fetchPolicy)
+	};
+	return params;
+}
+function createParallelExtractTool(config) {
+	const getClient = createLazyParallelClient(config);
+	return (0, _mastra_core_tools.createTool)({
+		id: "parallel-extract",
+		description: "Extract relevant excerpts or full page content from URLs with Parallel. Returns successful results and per-URL errors.",
+		inputSchema,
+		outputSchema,
+		execute: async (input) => {
+			const response = await getClient().extract(toExtractParams(input));
+			return {
+				extractId: response.extract_id,
+				sessionId: response.session_id,
+				results: response.results.map((result) => ({
+					url: result.url,
+					title: result.title ?? void 0,
+					publishDate: result.publish_date ?? void 0,
+					excerpts: result.excerpts,
+					fullContent: result.full_content ?? void 0
+				})),
+				errors: response.errors.map((error) => ({
+					url: error.url,
+					errorType: error.error_type,
+					httpStatusCode: error.http_status_code ?? void 0,
+					content: error.content ?? void 0
+				})),
+				usage: response.usage ?? void 0,
+				warnings: response.warnings?.map((warning) => ({
+					type: warning.type,
+					message: warning.message,
+					detail: warning.detail ?? void 0
+				}))
+			};
+		}
+	});
+}
+//#endregion
+//#region src/tools.ts
+function createParallelTools(config) {
+	return {
+		parallelSearch: createParallelSearchTool(config),
+		parallelExtract: createParallelExtractTool(config)
+	};
+}
+//#endregion
+exports.createParallelExtractTool = createParallelExtractTool;
+exports.createParallelSearchTool = createParallelSearchTool;
+exports.createParallelTools = createParallelTools;
+exports.getParallelClient = getParallelClient;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["Parallel","z","inputSchema","z","outputSchema","toFetchPolicy","z"],"sources":["../src/client.ts","../src/schemas.ts","../src/search.ts","../src/extract.ts","../src/tools.ts"],"sourcesContent":["import Parallel from 'parallel-web';\nimport type { ClientOptions } from 'parallel-web';\n\nexport type ParallelClientOptions = ClientOptions;\nexport type ParallelClient = Parallel;\n\nexport function getParallelClient(config?: ParallelClientOptions): ParallelClient {\n  const apiKey = config?.apiKey ?? process.env.PARALLEL_API_KEY;\n  if (!apiKey) {\n    throw new Error('Parallel API key is required. Pass { apiKey } or set the PARALLEL_API_KEY environment variable.');\n  }\n\n  return new Parallel({ ...config, apiKey });\n}\n\nexport function createLazyParallelClient(config?: ParallelClientOptions): () => ParallelClient {\n  let client: ParallelClient | undefined;\n\n  return () => {\n    client ??= getParallelClient(config);\n    return client;\n  };\n}\n","import { z } from 'zod';\n\nexport const usageItemSchema = z.object({\n  name: z.string(),\n  count: z.number(),\n});\n\nexport const warningSchema = z.object({\n  type: z.string(),\n  message: z.string(),\n  detail: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport const searchResultSchema = z.object({\n  url: z.string(),\n  title: z.string().optional(),\n  publishDate: z.string().optional(),\n  excerpts: z.array(z.string()),\n});\n\nexport const fetchPolicySchema = z.object({\n  maxAgeSeconds: z\n    .number()\n    .int()\n    .min(600)\n    .optional()\n    .describe('Maximum cached-content age in seconds before Parallel attempts a live fetch (minimum 600).'),\n  timeoutSeconds: z.number().int().positive().optional().describe('Timeout in seconds for a live fetch.'),\n  disableCacheFallback: z\n    .boolean()\n    .optional()\n    .describe('Return an error instead of older cached content when a live fetch fails or times out.'),\n});\n\nexport type FetchPolicyInput = z.infer<typeof fetchPolicySchema>;\n","import { createTool } from '@mastra/core/tools';\nimport type Parallel from 'parallel-web';\nimport { z } from 'zod';\n\nimport { createLazyParallelClient } from './client.js';\nimport type { ParallelClientOptions } from './client.js';\nimport { fetchPolicySchema, searchResultSchema, usageItemSchema, warningSchema } from './schemas.js';\nimport type { FetchPolicyInput } from './schemas.js';\n\nconst ISO_3166_ALPHA_2_CODES = new Set(\n  `AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ\nBA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ\nCA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ\nDE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR\nGA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY\nHK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP\nKE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY\nMA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ\nNA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY\nQA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ\nTC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ\nVA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW`\n    .split(/\\s+/),\n);\n\nfunction isValidCalendarDate(value: string): boolean {\n  const [yearText, monthText, dayText] = value.split('-');\n  if (yearText === undefined || monthText === undefined || dayText === undefined) return false;\n\n  const year = Number(yearText);\n  const month = Number(monthText);\n  const day = Number(dayText);\n  const daysInMonth = [\n    31,\n    year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0) ? 29 : 28,\n    31,\n    30,\n    31,\n    30,\n    31,\n    31,\n    30,\n    31,\n    30,\n    31,\n  ];\n\n  return month >= 1 && month <= 12 && day >= 1 && day <= daysInMonth[month - 1]!;\n}\n\nconst inputSchema = z\n  .object({\n    searchQueries: z\n      .array(z.string().min(1))\n      .min(1)\n      .describe('Concise keyword search queries, ideally 3-6 words each. Provide 2-3 queries for best results.'),\n    objective: z\n      .string()\n      .optional()\n      .describe('A self-contained natural-language description of the goal driving the search.'),\n    mode: z\n      .enum(['turbo', 'fast', 'basic', 'advanced'])\n      .optional()\n      .describe('Search mode. Defaults to advanced when omitted.'),\n    clientModel: z\n      .string()\n      .optional()\n      .describe('Model that will consume the results, used by Parallel to tailor response defaults.'),\n    maxResults: z.number().int().positive().optional().describe('Maximum number of results to return.'),\n    excerptMaxCharsPerResult: z\n      .number()\n      .int()\n      .positive()\n      .optional()\n      .describe('Maximum excerpt characters to return for each result.'),\n    maxCharsTotal: z\n      .number()\n      .int()\n      .positive()\n      .optional()\n      .describe('Maximum total excerpt characters across all results.'),\n    location: z\n      .string()\n      .refine(value => ISO_3166_ALPHA_2_CODES.has(value.toUpperCase()), {\n        message: 'location must be a valid ISO 3166-1 alpha-2 country code.',\n      })\n      .optional()\n      .describe('ISO 3166-1 alpha-2 country code for geo-targeted results.'),\n    includeDomains: z.array(z.string()).max(200).optional().describe('Only return results from these domains.'),\n    excludeDomains: z.array(z.string()).max(200).optional().describe('Exclude results from these domains.'),\n    afterDate: z\n      .string()\n      .regex(/^\\d{4}-\\d{2}-\\d{2}$/)\n      .refine(isValidCalendarDate, { message: 'afterDate must be a valid calendar date in YYYY-MM-DD format.' })\n      .optional()\n      .describe('Only return content published on or after this YYYY-MM-DD date.'),\n    fetchPolicy: fetchPolicySchema.optional().describe('Live-fetch and cached-content policy for search results.'),\n    sessionId: z.string().optional().describe('Session identifier shared across related Search and Extract calls.'),\n  })\n  .refine(input => (input.includeDomains?.length ?? 0) + (input.excludeDomains?.length ?? 0) <= 200, {\n    message: 'includeDomains and excludeDomains can contain at most 200 domains combined.',\n    path: ['includeDomains'],\n  });\n\nconst outputSchema = z.object({\n  searchId: z.string(),\n  sessionId: z.string(),\n  results: z.array(searchResultSchema),\n  usage: z.array(usageItemSchema).optional(),\n  warnings: z.array(warningSchema).optional(),\n});\n\ntype SearchInput = z.infer<typeof inputSchema>;\n\nfunction toFetchPolicy(input: FetchPolicyInput): Parallel.FetchPolicy {\n  return {\n    max_age_seconds: input.maxAgeSeconds,\n    timeout_seconds: input.timeoutSeconds,\n    disable_cache_fallback: input.disableCacheFallback,\n  };\n}\n\nfunction toSearchParams(input: SearchInput): Parallel.SearchParams {\n  const params: Parallel.SearchParams = {\n    search_queries: input.searchQueries,\n  };\n\n  if (input.objective !== undefined) params.objective = input.objective;\n  if (input.mode !== undefined) params.mode = input.mode;\n  if (input.clientModel !== undefined) params.client_model = input.clientModel;\n  if (input.maxCharsTotal !== undefined) params.max_chars_total = input.maxCharsTotal;\n  if (input.sessionId !== undefined) params.session_id = input.sessionId;\n\n  const sourcePolicy =\n    input.includeDomains !== undefined || input.excludeDomains !== undefined || input.afterDate !== undefined\n      ? {\n          include_domains: input.includeDomains,\n          exclude_domains: input.excludeDomains,\n          after_date: input.afterDate,\n        }\n      : undefined;\n\n  if (\n    input.maxResults !== undefined ||\n    input.excerptMaxCharsPerResult !== undefined ||\n    input.location !== undefined ||\n    sourcePolicy !== undefined ||\n    input.fetchPolicy !== undefined\n  ) {\n    params.advanced_settings = {\n      max_results: input.maxResults,\n      excerpt_settings:\n        input.excerptMaxCharsPerResult === undefined\n          ? undefined\n          : { max_chars_per_result: input.excerptMaxCharsPerResult },\n      location: input.location,\n      source_policy: sourcePolicy,\n      fetch_policy: input.fetchPolicy === undefined ? undefined : toFetchPolicy(input.fetchPolicy),\n    };\n  }\n\n  return params;\n}\n\nexport function createParallelSearchTool(config?: ParallelClientOptions) {\n  const getClient = createLazyParallelClient(config);\n\n  return createTool({\n    id: 'parallel-search',\n    description:\n      'Search the web with Parallel. Returns ranked URLs and token-efficient excerpts focused on the search objective.',\n    inputSchema,\n    outputSchema,\n    execute: async input => {\n      const response = await getClient().search(toSearchParams(input));\n\n      return {\n        searchId: response.search_id,\n        sessionId: response.session_id,\n        results: response.results.map(result => ({\n          url: result.url,\n          title: result.title ?? undefined,\n          publishDate: result.publish_date ?? undefined,\n          excerpts: result.excerpts,\n        })),\n        usage: response.usage ?? undefined,\n        warnings: response.warnings?.map(warning => ({\n          type: warning.type,\n          message: warning.message,\n          detail: warning.detail ?? undefined,\n        })),\n      };\n    },\n  });\n}\n","import { createTool } from '@mastra/core/tools';\nimport type Parallel from 'parallel-web';\nimport { z } from 'zod';\n\nimport { createLazyParallelClient } from './client.js';\nimport type { ParallelClientOptions } from './client.js';\nimport { fetchPolicySchema, usageItemSchema, warningSchema } from './schemas.js';\nimport type { FetchPolicyInput } from './schemas.js';\n\nconst inputSchema = z.object({\n  urls: z.array(z.string().url()).min(1).max(20).describe('URLs to extract content from (1-20).'),\n  objective: z\n    .string()\n    .optional()\n    .describe('A natural-language description of the information to focus on while extracting.'),\n  searchQueries: z\n    .array(z.string().min(1))\n    .min(1)\n    .optional()\n    .describe('Optional keyword queries used with the objective to focus excerpts.'),\n  excerptMaxCharsPerResult: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Maximum excerpt characters to return for each URL.'),\n  clientModel: z\n    .string()\n    .optional()\n    .describe('Model that will consume the results, used by Parallel to tailor response defaults.'),\n  fullContent: z\n    .union([z.boolean(), z.number().int().positive()])\n    .optional()\n    .describe('Return full page content. Pass a character limit instead of true to cap content per URL.'),\n  maxCharsTotal: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Maximum total characters across all extracted results.'),\n  fetchPolicy: fetchPolicySchema.optional().describe('Live-fetch and cached-content policy for extracted URLs.'),\n  sessionId: z.string().optional().describe('Session identifier shared across related Search and Extract calls.'),\n});\n\nconst outputSchema = z.object({\n  extractId: z.string(),\n  sessionId: z.string(),\n  results: z.array(\n    z.object({\n      url: z.string(),\n      title: z.string().optional(),\n      publishDate: z.string().optional(),\n      excerpts: z.array(z.string()),\n      fullContent: z.string().optional(),\n    }),\n  ),\n  errors: z.array(\n    z.object({\n      url: z.string(),\n      errorType: z.string(),\n      httpStatusCode: z.number().optional(),\n      content: z.string().optional(),\n    }),\n  ),\n  usage: z.array(usageItemSchema).optional(),\n  warnings: z.array(warningSchema).optional(),\n});\n\ntype ExtractInput = z.infer<typeof inputSchema>;\n\nfunction toFetchPolicy(input: FetchPolicyInput): Parallel.FetchPolicy {\n  return {\n    max_age_seconds: input.maxAgeSeconds,\n    timeout_seconds: input.timeoutSeconds,\n    disable_cache_fallback: input.disableCacheFallback,\n  };\n}\n\nfunction toExtractParams(input: ExtractInput): Parallel.ExtractParams {\n  const params: Parallel.ExtractParams = {\n    urls: input.urls,\n  };\n\n  if (input.objective !== undefined) params.objective = input.objective;\n  if (input.searchQueries !== undefined) params.search_queries = input.searchQueries;\n  if (input.clientModel !== undefined) params.client_model = input.clientModel;\n  if (input.maxCharsTotal !== undefined) params.max_chars_total = input.maxCharsTotal;\n  if (input.sessionId !== undefined) params.session_id = input.sessionId;\n\n  if (\n    input.excerptMaxCharsPerResult !== undefined ||\n    input.fullContent !== undefined ||\n    input.fetchPolicy !== undefined\n  ) {\n    params.advanced_settings = {\n      excerpt_settings:\n        input.excerptMaxCharsPerResult === undefined\n          ? undefined\n          : { max_chars_per_result: input.excerptMaxCharsPerResult },\n      full_content:\n        typeof input.fullContent === 'number' ? { max_chars_per_result: input.fullContent } : input.fullContent,\n      fetch_policy: input.fetchPolicy === undefined ? undefined : toFetchPolicy(input.fetchPolicy),\n    };\n  }\n\n  return params;\n}\n\nexport function createParallelExtractTool(config?: ParallelClientOptions) {\n  const getClient = createLazyParallelClient(config);\n\n  return createTool({\n    id: 'parallel-extract',\n    description:\n      'Extract relevant excerpts or full page content from URLs with Parallel. Returns successful results and per-URL errors.',\n    inputSchema,\n    outputSchema,\n    execute: async input => {\n      const response = await getClient().extract(toExtractParams(input));\n\n      return {\n        extractId: response.extract_id,\n        sessionId: response.session_id,\n        results: response.results.map(result => ({\n          url: result.url,\n          title: result.title ?? undefined,\n          publishDate: result.publish_date ?? undefined,\n          excerpts: result.excerpts,\n          fullContent: result.full_content ?? undefined,\n        })),\n        errors: response.errors.map(error => ({\n          url: error.url,\n          errorType: error.error_type,\n          httpStatusCode: error.http_status_code ?? undefined,\n          content: error.content ?? undefined,\n        })),\n        usage: response.usage ?? undefined,\n        warnings: response.warnings?.map(warning => ({\n          type: warning.type,\n          message: warning.message,\n          detail: warning.detail ?? undefined,\n        })),\n      };\n    },\n  });\n}\n","import type { ParallelClientOptions } from './client.js';\nimport { createParallelExtractTool } from './extract.js';\nimport { createParallelSearchTool } from './search.js';\n\nexport function createParallelTools(config?: ParallelClientOptions) {\n  return {\n    parallelSearch: createParallelSearchTool(config),\n    parallelExtract: createParallelExtractTool(config),\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { getParallelClient, type ParallelClientOptions, type ParallelClient } from './client.js';
+export { createParallelSearchTool } from './search.js';
+export { createParallelExtractTool } from './extract.js';
+export { createParallelTools } from './tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,263 @@
+import Parallel from "parallel-web";
+import { createTool } from "@mastra/core/tools";
+import { z } from "zod";
+//#region src/client.ts
+function getParallelClient(config) {
+	const apiKey = config?.apiKey ?? process.env.PARALLEL_API_KEY;
+	if (!apiKey) throw new Error("Parallel API key is required. Pass { apiKey } or set the PARALLEL_API_KEY environment variable.");
+	return new Parallel({
+		...config,
+		apiKey
+	});
+}
+function createLazyParallelClient(config) {
+	let client;
+	return () => {
+		client ??= getParallelClient(config);
+		return client;
+	};
+}
+//#endregion
+//#region src/schemas.ts
+const usageItemSchema = z.object({
+	name: z.string(),
+	count: z.number()
+});
+const warningSchema = z.object({
+	type: z.string(),
+	message: z.string(),
+	detail: z.record(z.string(), z.unknown()).optional()
+});
+const searchResultSchema = z.object({
+	url: z.string(),
+	title: z.string().optional(),
+	publishDate: z.string().optional(),
+	excerpts: z.array(z.string())
+});
+const fetchPolicySchema = z.object({
+	maxAgeSeconds: z.number().int().min(600).optional().describe("Maximum cached-content age in seconds before Parallel attempts a live fetch (minimum 600)."),
+	timeoutSeconds: z.number().int().positive().optional().describe("Timeout in seconds for a live fetch."),
+	disableCacheFallback: z.boolean().optional().describe("Return an error instead of older cached content when a live fetch fails or times out.")
+});
+//#endregion
+//#region src/search.ts
+const ISO_3166_ALPHA_2_CODES = new Set(`AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ
+BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ
+CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ
+DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR
+GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY
+HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP
+KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY
+MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ
+NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY
+QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ
+TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ
+VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW`.split(/\s+/));
+function isValidCalendarDate(value) {
+	const [yearText, monthText, dayText] = value.split("-");
+	if (yearText === void 0 || monthText === void 0 || dayText === void 0) return false;
+	const year = Number(yearText);
+	const month = Number(monthText);
+	const day = Number(dayText);
+	const daysInMonth = [
+		31,
+		year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0) ? 29 : 28,
+		31,
+		30,
+		31,
+		30,
+		31,
+		31,
+		30,
+		31,
+		30,
+		31
+	];
+	return month >= 1 && month <= 12 && day >= 1 && day <= daysInMonth[month - 1];
+}
+const inputSchema$1 = z.object({
+	searchQueries: z.array(z.string().min(1)).min(1).describe("Concise keyword search queries, ideally 3-6 words each. Provide 2-3 queries for best results."),
+	objective: z.string().optional().describe("A self-contained natural-language description of the goal driving the search."),
+	mode: z.enum([
+		"turbo",
+		"fast",
+		"basic",
+		"advanced"
+	]).optional().describe("Search mode. Defaults to advanced when omitted."),
+	clientModel: z.string().optional().describe("Model that will consume the results, used by Parallel to tailor response defaults."),
+	maxResults: z.number().int().positive().optional().describe("Maximum number of results to return."),
+	excerptMaxCharsPerResult: z.number().int().positive().optional().describe("Maximum excerpt characters to return for each result."),
+	maxCharsTotal: z.number().int().positive().optional().describe("Maximum total excerpt characters across all results."),
+	location: z.string().refine((value) => ISO_3166_ALPHA_2_CODES.has(value.toUpperCase()), { message: "location must be a valid ISO 3166-1 alpha-2 country code." }).optional().describe("ISO 3166-1 alpha-2 country code for geo-targeted results."),
+	includeDomains: z.array(z.string()).max(200).optional().describe("Only return results from these domains."),
+	excludeDomains: z.array(z.string()).max(200).optional().describe("Exclude results from these domains."),
+	afterDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).refine(isValidCalendarDate, { message: "afterDate must be a valid calendar date in YYYY-MM-DD format." }).optional().describe("Only return content published on or after this YYYY-MM-DD date."),
+	fetchPolicy: fetchPolicySchema.optional().describe("Live-fetch and cached-content policy for search results."),
+	sessionId: z.string().optional().describe("Session identifier shared across related Search and Extract calls.")
+}).refine((input) => (input.includeDomains?.length ?? 0) + (input.excludeDomains?.length ?? 0) <= 200, {
+	message: "includeDomains and excludeDomains can contain at most 200 domains combined.",
+	path: ["includeDomains"]
+});
+const outputSchema$1 = z.object({
+	searchId: z.string(),
+	sessionId: z.string(),
+	results: z.array(searchResultSchema),
+	usage: z.array(usageItemSchema).optional(),
+	warnings: z.array(warningSchema).optional()
+});
+function toFetchPolicy$1(input) {
+	return {
+		max_age_seconds: input.maxAgeSeconds,
+		timeout_seconds: input.timeoutSeconds,
+		disable_cache_fallback: input.disableCacheFallback
+	};
+}
+function toSearchParams(input) {
+	const params = { search_queries: input.searchQueries };
+	if (input.objective !== void 0) params.objective = input.objective;
+	if (input.mode !== void 0) params.mode = input.mode;
+	if (input.clientModel !== void 0) params.client_model = input.clientModel;
+	if (input.maxCharsTotal !== void 0) params.max_chars_total = input.maxCharsTotal;
+	if (input.sessionId !== void 0) params.session_id = input.sessionId;
+	const sourcePolicy = input.includeDomains !== void 0 || input.excludeDomains !== void 0 || input.afterDate !== void 0 ? {
+		include_domains: input.includeDomains,
+		exclude_domains: input.excludeDomains,
+		after_date: input.afterDate
+	} : void 0;
+	if (input.maxResults !== void 0 || input.excerptMaxCharsPerResult !== void 0 || input.location !== void 0 || sourcePolicy !== void 0 || input.fetchPolicy !== void 0) params.advanced_settings = {
+		max_results: input.maxResults,
+		excerpt_settings: input.excerptMaxCharsPerResult === void 0 ? void 0 : { max_chars_per_result: input.excerptMaxCharsPerResult },
+		location: input.location,
+		source_policy: sourcePolicy,
+		fetch_policy: input.fetchPolicy === void 0 ? void 0 : toFetchPolicy$1(input.fetchPolicy)
+	};
+	return params;
+}
+function createParallelSearchTool(config) {
+	const getClient = createLazyParallelClient(config);
+	return createTool({
+		id: "parallel-search",
+		description: "Search the web with Parallel. Returns ranked URLs and token-efficient excerpts focused on the search objective.",
+		inputSchema: inputSchema$1,
+		outputSchema: outputSchema$1,
+		execute: async (input) => {
+			const response = await getClient().search(toSearchParams(input));
+			return {
+				searchId: response.search_id,
+				sessionId: response.session_id,
+				results: response.results.map((result) => ({
+					url: result.url,
+					title: result.title ?? void 0,
+					publishDate: result.publish_date ?? void 0,
+					excerpts: result.excerpts
+				})),
+				usage: response.usage ?? void 0,
+				warnings: response.warnings?.map((warning) => ({
+					type: warning.type,
+					message: warning.message,
+					detail: warning.detail ?? void 0
+				}))
+			};
+		}
+	});
+}
+//#endregion
+//#region src/extract.ts
+const inputSchema = z.object({
+	urls: z.array(z.string().url()).min(1).max(20).describe("URLs to extract content from (1-20)."),
+	objective: z.string().optional().describe("A natural-language description of the information to focus on while extracting."),
+	searchQueries: z.array(z.string().min(1)).min(1).optional().describe("Optional keyword queries used with the objective to focus excerpts."),
+	excerptMaxCharsPerResult: z.number().int().positive().optional().describe("Maximum excerpt characters to return for each URL."),
+	clientModel: z.string().optional().describe("Model that will consume the results, used by Parallel to tailor response defaults."),
+	fullContent: z.union([z.boolean(), z.number().int().positive()]).optional().describe("Return full page content. Pass a character limit instead of true to cap content per URL."),
+	maxCharsTotal: z.number().int().positive().optional().describe("Maximum total characters across all extracted results."),
+	fetchPolicy: fetchPolicySchema.optional().describe("Live-fetch and cached-content policy for extracted URLs."),
+	sessionId: z.string().optional().describe("Session identifier shared across related Search and Extract calls.")
+});
+const outputSchema = z.object({
+	extractId: z.string(),
+	sessionId: z.string(),
+	results: z.array(z.object({
+		url: z.string(),
+		title: z.string().optional(),
+		publishDate: z.string().optional(),
+		excerpts: z.array(z.string()),
+		fullContent: z.string().optional()
+	})),
+	errors: z.array(z.object({
+		url: z.string(),
+		errorType: z.string(),
+		httpStatusCode: z.number().optional(),
+		content: z.string().optional()
+	})),
+	usage: z.array(usageItemSchema).optional(),
+	warnings: z.array(warningSchema).optional()
+});
+function toFetchPolicy(input) {
+	return {
+		max_age_seconds: input.maxAgeSeconds,
+		timeout_seconds: input.timeoutSeconds,
+		disable_cache_fallback: input.disableCacheFallback
+	};
+}
+function toExtractParams(input) {
+	const params = { urls: input.urls };
+	if (input.objective !== void 0) params.objective = input.objective;
+	if (input.searchQueries !== void 0) params.search_queries = input.searchQueries;
+	if (input.clientModel !== void 0) params.client_model = input.clientModel;
+	if (input.maxCharsTotal !== void 0) params.max_chars_total = input.maxCharsTotal;
+	if (input.sessionId !== void 0) params.session_id = input.sessionId;
+	if (input.excerptMaxCharsPerResult !== void 0 || input.fullContent !== void 0 || input.fetchPolicy !== void 0) params.advanced_settings = {
+		excerpt_settings: input.excerptMaxCharsPerResult === void 0 ? void 0 : { max_chars_per_result: input.excerptMaxCharsPerResult },
+		full_content: typeof input.fullContent === "number" ? { max_chars_per_result: input.fullContent } : input.fullContent,
+		fetch_policy: input.fetchPolicy === void 0 ? void 0 : toFetchPolicy(input.fetchPolicy)
+	};
+	return params;
+}
+function createParallelExtractTool(config) {
+	const getClient = createLazyParallelClient(config);
+	return createTool({
+		id: "parallel-extract",
+		description: "Extract relevant excerpts or full page content from URLs with Parallel. Returns successful results and per-URL errors.",
+		inputSchema,
+		outputSchema,
+		execute: async (input) => {
+			const response = await getClient().extract(toExtractParams(input));
+			return {
+				extractId: response.extract_id,
+				sessionId: response.session_id,
+				results: response.results.map((result) => ({
+					url: result.url,
+					title: result.title ?? void 0,
+					publishDate: result.publish_date ?? void 0,
+					excerpts: result.excerpts,
+					fullContent: result.full_content ?? void 0
+				})),
+				errors: response.errors.map((error) => ({
+					url: error.url,
+					errorType: error.error_type,
+					httpStatusCode: error.http_status_code ?? void 0,
+					content: error.content ?? void 0
+				})),
+				usage: response.usage ?? void 0,
+				warnings: response.warnings?.map((warning) => ({
+					type: warning.type,
+					message: warning.message,
+					detail: warning.detail ?? void 0
+				}))
+			};
+		}
+	});
+}
+//#endregion
+//#region src/tools.ts
+function createParallelTools(config) {
+	return {
+		parallelSearch: createParallelSearchTool(config),
+		parallelExtract: createParallelExtractTool(config)
+	};
+}
+//#endregion
+export { createParallelExtractTool, createParallelSearchTool, createParallelTools, getParallelClient };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["inputSchema","outputSchema","toFetchPolicy"],"sources":["../src/client.ts","../src/schemas.ts","../src/search.ts","../src/extract.ts","../src/tools.ts"],"sourcesContent":["import Parallel from 'parallel-web';\nimport type { ClientOptions } from 'parallel-web';\n\nexport type ParallelClientOptions = ClientOptions;\nexport type ParallelClient = Parallel;\n\nexport function getParallelClient(config?: ParallelClientOptions): ParallelClient {\n  const apiKey = config?.apiKey ?? process.env.PARALLEL_API_KEY;\n  if (!apiKey) {\n    throw new Error('Parallel API key is required. Pass { apiKey } or set the PARALLEL_API_KEY environment variable.');\n  }\n\n  return new Parallel({ ...config, apiKey });\n}\n\nexport function createLazyParallelClient(config?: ParallelClientOptions): () => ParallelClient {\n  let client: ParallelClient | undefined;\n\n  return () => {\n    client ??= getParallelClient(config);\n    return client;\n  };\n}\n","import { z } from 'zod';\n\nexport const usageItemSchema = z.object({\n  name: z.string(),\n  count: z.number(),\n});\n\nexport const warningSchema = z.object({\n  type: z.string(),\n  message: z.string(),\n  detail: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport const searchResultSchema = z.object({\n  url: z.string(),\n  title: z.string().optional(),\n  publishDate: z.string().optional(),\n  excerpts: z.array(z.string()),\n});\n\nexport const fetchPolicySchema = z.object({\n  maxAgeSeconds: z\n    .number()\n    .int()\n    .min(600)\n    .optional()\n    .describe('Maximum cached-content age in seconds before Parallel attempts a live fetch (minimum 600).'),\n  timeoutSeconds: z.number().int().positive().optional().describe('Timeout in seconds for a live fetch.'),\n  disableCacheFallback: z\n    .boolean()\n    .optional()\n    .describe('Return an error instead of older cached content when a live fetch fails or times out.'),\n});\n\nexport type FetchPolicyInput = z.infer<typeof fetchPolicySchema>;\n","import { createTool } from '@mastra/core/tools';\nimport type Parallel from 'parallel-web';\nimport { z } from 'zod';\n\nimport { createLazyParallelClient } from './client.js';\nimport type { ParallelClientOptions } from './client.js';\nimport { fetchPolicySchema, searchResultSchema, usageItemSchema, warningSchema } from './schemas.js';\nimport type { FetchPolicyInput } from './schemas.js';\n\nconst ISO_3166_ALPHA_2_CODES = new Set(\n  `AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ\nBA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ\nCA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ\nDE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR\nGA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY\nHK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP\nKE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY\nMA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ\nNA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY\nQA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ\nTC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ\nVA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW`\n    .split(/\\s+/),\n);\n\nfunction isValidCalendarDate(value: string): boolean {\n  const [yearText, monthText, dayText] = value.split('-');\n  if (yearText === undefined || monthText === undefined || dayText === undefined) return false;\n\n  const year = Number(yearText);\n  const month = Number(monthText);\n  const day = Number(dayText);\n  const daysInMonth = [\n    31,\n    year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0) ? 29 : 28,\n    31,\n    30,\n    31,\n    30,\n    31,\n    31,\n    30,\n    31,\n    30,\n    31,\n  ];\n\n  return month >= 1 && month <= 12 && day >= 1 && day <= daysInMonth[month - 1]!;\n}\n\nconst inputSchema = z\n  .object({\n    searchQueries: z\n      .array(z.string().min(1))\n      .min(1)\n      .describe('Concise keyword search queries, ideally 3-6 words each. Provide 2-3 queries for best results.'),\n    objective: z\n      .string()\n      .optional()\n      .describe('A self-contained natural-language description of the goal driving the search.'),\n    mode: z\n      .enum(['turbo', 'fast', 'basic', 'advanced'])\n      .optional()\n      .describe('Search mode. Defaults to advanced when omitted.'),\n    clientModel: z\n      .string()\n      .optional()\n      .describe('Model that will consume the results, used by Parallel to tailor response defaults.'),\n    maxResults: z.number().int().positive().optional().describe('Maximum number of results to return.'),\n    excerptMaxCharsPerResult: z\n      .number()\n      .int()\n      .positive()\n      .optional()\n      .describe('Maximum excerpt characters to return for each result.'),\n    maxCharsTotal: z\n      .number()\n      .int()\n      .positive()\n      .optional()\n      .describe('Maximum total excerpt characters across all results.'),\n    location: z\n      .string()\n      .refine(value => ISO_3166_ALPHA_2_CODES.has(value.toUpperCase()), {\n        message: 'location must be a valid ISO 3166-1 alpha-2 country code.',\n      })\n      .optional()\n      .describe('ISO 3166-1 alpha-2 country code for geo-targeted results.'),\n    includeDomains: z.array(z.string()).max(200).optional().describe('Only return results from these domains.'),\n    excludeDomains: z.array(z.string()).max(200).optional().describe('Exclude results from these domains.'),\n    afterDate: z\n      .string()\n      .regex(/^\\d{4}-\\d{2}-\\d{2}$/)\n      .refine(isValidCalendarDate, { message: 'afterDate must be a valid calendar date in YYYY-MM-DD format.' })\n      .optional()\n      .describe('Only return content published on or after this YYYY-MM-DD date.'),\n    fetchPolicy: fetchPolicySchema.optional().describe('Live-fetch and cached-content policy for search results.'),\n    sessionId: z.string().optional().describe('Session identifier shared across related Search and Extract calls.'),\n  })\n  .refine(input => (input.includeDomains?.length ?? 0) + (input.excludeDomains?.length ?? 0) <= 200, {\n    message: 'includeDomains and excludeDomains can contain at most 200 domains combined.',\n    path: ['includeDomains'],\n  });\n\nconst outputSchema = z.object({\n  searchId: z.string(),\n  sessionId: z.string(),\n  results: z.array(searchResultSchema),\n  usage: z.array(usageItemSchema).optional(),\n  warnings: z.array(warningSchema).optional(),\n});\n\ntype SearchInput = z.infer<typeof inputSchema>;\n\nfunction toFetchPolicy(input: FetchPolicyInput): Parallel.FetchPolicy {\n  return {\n    max_age_seconds: input.maxAgeSeconds,\n    timeout_seconds: input.timeoutSeconds,\n    disable_cache_fallback: input.disableCacheFallback,\n  };\n}\n\nfunction toSearchParams(input: SearchInput): Parallel.SearchParams {\n  const params: Parallel.SearchParams = {\n    search_queries: input.searchQueries,\n  };\n\n  if (input.objective !== undefined) params.objective = input.objective;\n  if (input.mode !== undefined) params.mode = input.mode;\n  if (input.clientModel !== undefined) params.client_model = input.clientModel;\n  if (input.maxCharsTotal !== undefined) params.max_chars_total = input.maxCharsTotal;\n  if (input.sessionId !== undefined) params.session_id = input.sessionId;\n\n  const sourcePolicy =\n    input.includeDomains !== undefined || input.excludeDomains !== undefined || input.afterDate !== undefined\n      ? {\n          include_domains: input.includeDomains,\n          exclude_domains: input.excludeDomains,\n          after_date: input.afterDate,\n        }\n      : undefined;\n\n  if (\n    input.maxResults !== undefined ||\n    input.excerptMaxCharsPerResult !== undefined ||\n    input.location !== undefined ||\n    sourcePolicy !== undefined ||\n    input.fetchPolicy !== undefined\n  ) {\n    params.advanced_settings = {\n      max_results: input.maxResults,\n      excerpt_settings:\n        input.excerptMaxCharsPerResult === undefined\n          ? undefined\n          : { max_chars_per_result: input.excerptMaxCharsPerResult },\n      location: input.location,\n      source_policy: sourcePolicy,\n      fetch_policy: input.fetchPolicy === undefined ? undefined : toFetchPolicy(input.fetchPolicy),\n    };\n  }\n\n  return params;\n}\n\nexport function createParallelSearchTool(config?: ParallelClientOptions) {\n  const getClient = createLazyParallelClient(config);\n\n  return createTool({\n    id: 'parallel-search',\n    description:\n      'Search the web with Parallel. Returns ranked URLs and token-efficient excerpts focused on the search objective.',\n    inputSchema,\n    outputSchema,\n    execute: async input => {\n      const response = await getClient().search(toSearchParams(input));\n\n      return {\n        searchId: response.search_id,\n        sessionId: response.session_id,\n        results: response.results.map(result => ({\n          url: result.url,\n          title: result.title ?? undefined,\n          publishDate: result.publish_date ?? undefined,\n          excerpts: result.excerpts,\n        })),\n        usage: response.usage ?? undefined,\n        warnings: response.warnings?.map(warning => ({\n          type: warning.type,\n          message: warning.message,\n          detail: warning.detail ?? undefined,\n        })),\n      };\n    },\n  });\n}\n","import { createTool } from '@mastra/core/tools';\nimport type Parallel from 'parallel-web';\nimport { z } from 'zod';\n\nimport { createLazyParallelClient } from './client.js';\nimport type { ParallelClientOptions } from './client.js';\nimport { fetchPolicySchema, usageItemSchema, warningSchema } from './schemas.js';\nimport type { FetchPolicyInput } from './schemas.js';\n\nconst inputSchema = z.object({\n  urls: z.array(z.string().url()).min(1).max(20).describe('URLs to extract content from (1-20).'),\n  objective: z\n    .string()\n    .optional()\n    .describe('A natural-language description of the information to focus on while extracting.'),\n  searchQueries: z\n    .array(z.string().min(1))\n    .min(1)\n    .optional()\n    .describe('Optional keyword queries used with the objective to focus excerpts.'),\n  excerptMaxCharsPerResult: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Maximum excerpt characters to return for each URL.'),\n  clientModel: z\n    .string()\n    .optional()\n    .describe('Model that will consume the results, used by Parallel to tailor response defaults.'),\n  fullContent: z\n    .union([z.boolean(), z.number().int().positive()])\n    .optional()\n    .describe('Return full page content. Pass a character limit instead of true to cap content per URL.'),\n  maxCharsTotal: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Maximum total characters across all extracted results.'),\n  fetchPolicy: fetchPolicySchema.optional().describe('Live-fetch and cached-content policy for extracted URLs.'),\n  sessionId: z.string().optional().describe('Session identifier shared across related Search and Extract calls.'),\n});\n\nconst outputSchema = z.object({\n  extractId: z.string(),\n  sessionId: z.string(),\n  results: z.array(\n    z.object({\n      url: z.string(),\n      title: z.string().optional(),\n      publishDate: z.string().optional(),\n      excerpts: z.array(z.string()),\n      fullContent: z.string().optional(),\n    }),\n  ),\n  errors: z.array(\n    z.object({\n      url: z.string(),\n      errorType: z.string(),\n      httpStatusCode: z.number().optional(),\n      content: z.string().optional(),\n    }),\n  ),\n  usage: z.array(usageItemSchema).optional(),\n  warnings: z.array(warningSchema).optional(),\n});\n\ntype ExtractInput = z.infer<typeof inputSchema>;\n\nfunction toFetchPolicy(input: FetchPolicyInput): Parallel.FetchPolicy {\n  return {\n    max_age_seconds: input.maxAgeSeconds,\n    timeout_seconds: input.timeoutSeconds,\n    disable_cache_fallback: input.disableCacheFallback,\n  };\n}\n\nfunction toExtractParams(input: ExtractInput): Parallel.ExtractParams {\n  const params: Parallel.ExtractParams = {\n    urls: input.urls,\n  };\n\n  if (input.objective !== undefined) params.objective = input.objective;\n  if (input.searchQueries !== undefined) params.search_queries = input.searchQueries;\n  if (input.clientModel !== undefined) params.client_model = input.clientModel;\n  if (input.maxCharsTotal !== undefined) params.max_chars_total = input.maxCharsTotal;\n  if (input.sessionId !== undefined) params.session_id = input.sessionId;\n\n  if (\n    input.excerptMaxCharsPerResult !== undefined ||\n    input.fullContent !== undefined ||\n    input.fetchPolicy !== undefined\n  ) {\n    params.advanced_settings = {\n      excerpt_settings:\n        input.excerptMaxCharsPerResult === undefined\n          ? undefined\n          : { max_chars_per_result: input.excerptMaxCharsPerResult },\n      full_content:\n        typeof input.fullContent === 'number' ? { max_chars_per_result: input.fullContent } : input.fullContent,\n      fetch_policy: input.fetchPolicy === undefined ? undefined : toFetchPolicy(input.fetchPolicy),\n    };\n  }\n\n  return params;\n}\n\nexport function createParallelExtractTool(config?: ParallelClientOptions) {\n  const getClient = createLazyParallelClient(config);\n\n  return createTool({\n    id: 'parallel-extract',\n    description:\n      'Extract relevant excerpts or full page content from URLs with Parallel. Returns successful results and per-URL errors.',\n    inputSchema,\n    outputSchema,\n    execute: async input => {\n      const response = await getClient().extract(toExtractParams(input));\n\n      return {\n        extractId: response.extract_id,\n        sessionId: response.session_id,\n        results: response.results.map(result => ({\n          url: result.url,\n          title: result.title ?? undefined,\n          publishDate: result.publish_date ?? undefined,\n          excerpts: result.excerpts,\n          fullContent: result.full_content ?? undefined,\n        })),\n        errors: response.errors.map(error => ({\n          url: error.url,\n          errorType: error.error_type,\n          httpStatusCode: error.http_status_code ?? undefined,\n          content: error.content ?? undefined,\n        })),\n        usage: response.usage ?? undefined,\n        warnings: response.warnings?.map(warning => ({\n          type: warning.type,\n          message: warning.message,\n          detail: warning.detail ?? undefined,\n        })),\n      };\n    },\n  });\n}\n","import type { ParallelClientOptions } from './client.js';\nimport { createParallelExtractTool } from './extract.js';\nimport { createParallelSearchTool } from './search.js';\n\nexport function createParallelTools(config?: ParallelClientOptions) {\n  return {\n    parallelSearch: createParallelSearchTool(config),\n    parallelExtract: createParallelExtractTool(config),\n  };\n}\n"],"mappings":"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"}

package/dist/schemas.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export declare const usageItemSchema: z.ZodObject<{
+    name: z.ZodString;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+export declare const warningSchema: z.ZodObject<{
+    type: z.ZodString;
+    message: z.ZodString;
+    detail: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const searchResultSchema: z.ZodObject<{
+    url: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    publishDate: z.ZodOptional<z.ZodString>;
+    excerpts: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const fetchPolicySchema: z.ZodObject<{
+    maxAgeSeconds: z.ZodOptional<z.ZodNumber>;
+    timeoutSeconds: z.ZodOptional<z.ZodNumber>;
+    disableCacheFallback: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type FetchPolicyInput = z.infer<typeof fetchPolicySchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;iBAIxB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;iBAY5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/search.d.ts

@@ -0,0 +1,39 @@
+import type { ParallelClientOptions } from './client.js';
+export declare function createParallelSearchTool(config?: ParallelClientOptions): import("@mastra/core/tools").Tool<{
+    searchQueries: string[];
+    objective?: string | undefined;
+    mode?: "turbo" | "fast" | "basic" | "advanced" | undefined;
+    clientModel?: string | undefined;
+    maxResults?: number | undefined;
+    excerptMaxCharsPerResult?: number | undefined;
+    maxCharsTotal?: number | undefined;
+    location?: string | undefined;
+    includeDomains?: string[] | undefined;
+    excludeDomains?: string[] | undefined;
+    afterDate?: string | undefined;
+    fetchPolicy?: {
+        maxAgeSeconds?: number | undefined;
+        timeoutSeconds?: number | undefined;
+        disableCacheFallback?: boolean | undefined;
+    } | undefined;
+    sessionId?: string | undefined;
+}, {
+    searchId: string;
+    sessionId: string;
+    results: {
+        url: string;
+        excerpts: string[];
+        title?: string | undefined;
+        publishDate?: string | undefined;
+    }[];
+    usage?: {
+        name: string;
+        count: number;
+    }[] | undefined;
+    warnings?: {
+        type: string;
+        message: string;
+        detail?: Record<string, unknown> | undefined;
+    }[] | undefined;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "parallel-search", unknown>;
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AA+JzD,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+HA8BtE"}

package/dist/tools.d.ts

@@ -0,0 +1,81 @@
+import type { ParallelClientOptions } from './client.js';
+export declare function createParallelTools(config?: ParallelClientOptions): {
+    parallelSearch: import("@mastra/core/tools").Tool<{
+        searchQueries: string[];
+        objective?: string | undefined;
+        mode?: "turbo" | "fast" | "basic" | "advanced" | undefined;
+        clientModel?: string | undefined;
+        maxResults?: number | undefined;
+        excerptMaxCharsPerResult?: number | undefined;
+        maxCharsTotal?: number | undefined;
+        location?: string | undefined;
+        includeDomains?: string[] | undefined;
+        excludeDomains?: string[] | undefined;
+        afterDate?: string | undefined;
+        fetchPolicy?: {
+            maxAgeSeconds?: number | undefined;
+            timeoutSeconds?: number | undefined;
+            disableCacheFallback?: boolean | undefined;
+        } | undefined;
+        sessionId?: string | undefined;
+    }, {
+        searchId: string;
+        sessionId: string;
+        results: {
+            url: string;
+            excerpts: string[];
+            title?: string | undefined;
+            publishDate?: string | undefined;
+        }[];
+        usage?: {
+            name: string;
+            count: number;
+        }[] | undefined;
+        warnings?: {
+            type: string;
+            message: string;
+            detail?: Record<string, unknown> | undefined;
+        }[] | undefined;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "parallel-search", unknown>;
+    parallelExtract: import("@mastra/core/tools").Tool<{
+        urls: string[];
+        objective?: string | undefined;
+        searchQueries?: string[] | undefined;
+        excerptMaxCharsPerResult?: number | undefined;
+        clientModel?: string | undefined;
+        fullContent?: number | boolean | undefined;
+        maxCharsTotal?: number | undefined;
+        fetchPolicy?: {
+            maxAgeSeconds?: number | undefined;
+            timeoutSeconds?: number | undefined;
+            disableCacheFallback?: boolean | undefined;
+        } | undefined;
+        sessionId?: string | undefined;
+    }, {
+        extractId: string;
+        sessionId: string;
+        results: {
+            url: string;
+            excerpts: string[];
+            title?: string | undefined;
+            publishDate?: string | undefined;
+            fullContent?: string | undefined;
+        }[];
+        errors: {
+            url: string;
+            errorType: string;
+            httpStatusCode?: number | undefined;
+            content?: string | undefined;
+        }[];
+        usage?: {
+            name: string;
+            count: number;
+        }[] | undefined;
+        warnings?: {
+            type: string;
+            message: string;
+            detail?: Record<string, unknown> | undefined;
+        }[] | undefined;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "parallel-extract", unknown>;
+};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIzD,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKjE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/parallel",
-  "version": "0.0.0",
+  "version": "0.1.0",
   "description": "Parallel web search and extract tools for Mastra agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,13 +22,6 @@
     },
     "./package.json": "./package.json"
   },
-  "scripts": {
-    "build:lib": "tsdown --silent --config tsdown.config.ts",
-    "build:watch": "pnpm build:lib --watch",
-    "lint": "oxlint . && eslint .",
-    "lint:fix": "oxlint --fix . && eslint --fix .",
-    "test": "vitest run"
-  },
   "keywords": [
     "mastra",
     "parallel",
@@ -58,12 +51,19 @@
     "zod": ">=3.0.0 || >=4.0.0"
   },
   "devDependencies": {
-    "@internal/lint": "workspace:*",
-    "@internal/types-builder": "workspace:*",
-    "@mastra/core": "workspace:*",
     "tsdown": "0.22.9",
-    "typescript": "catalog:",
-    "vitest": "catalog:",
-    "zod": "catalog:"
+    "typescript": "^6.0.3",
+    "vitest": "4.1.10",
+    "zod": "^4.4.3",
+    "@internal/lint": "0.0.126",
+    "@internal/types-builder": "0.0.101",
+    "@mastra/core": "1.62.0"
+  },
+  "scripts": {
+    "build:lib": "tsdown --silent --config tsdown.config.ts",
+    "build:watch": "pnpm build:lib --watch",
+    "lint": "oxlint . && eslint .",
+    "lint:fix": "oxlint --fix . && eslint --fix .",
+    "test": "vitest run"
   }
-}
+}