@mastra/parallel 0.1.0 → 0.1.1-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/LICENSE.md +6 -4
  2. package/README.md +14 -39
  3. package/dist/extract.d.ts +1 -1
  4. package/dist/search.d.ts +2 -2
  5. package/dist/tools.d.ts +3 -3
  6. package/dist/tools.d.ts.map +1 -1
  7. package/package.json +6 -7
  8. package/CHANGELOG.md +0 -35
package/LICENSE.md CHANGED
@@ -1,10 +1,12 @@
1
1
  Portions of this software are licensed as follows:
2
2
 
3
- - All content that resides under any directory named "ee/" within this
3
+ - All content that resides under any directory named `ee/` within this
4
4
  repository, including but not limited to:
5
- - `packages/core/src/auth/ee/`
6
- - `packages/server/src/server/auth/ee/`
7
- is licensed under the license defined in `ee/LICENSE`.
5
+ - `@mastra/core/auth/ee`
6
+ - `@mastra/core/agent-builder/ee`
7
+ - `@mastra/editor/ee`
8
+
9
+ is licensed under the license defined in [`ee/LICENSE`](https://github.com/mastra-ai/mastra/blob/main/ee/LICENSE).
8
10
 
9
11
  - All third-party components incorporated into the Mastra Software are
10
12
  licensed under the original license provided by the owner of the
package/README.md CHANGED
@@ -1,63 +1,38 @@
1
1
  # @mastra/parallel
2
2
 
3
- Parallel web search and content extraction tools for [Mastra](https://mastra.ai) agents.
4
-
3
+ Add Parallel Search and Extract tools to Mastra agents with typed Zod inputs and outputs, configurable processors, and structured web research results.
5
4
  ## Installation
6
5
 
7
6
  ```bash
8
- npm install @mastra/parallel parallel-web zod
7
+ npm install @mastra/parallel
9
8
  ```
10
9
 
11
- ## Quick start
10
+ ## Usage
11
+
12
12
 
13
- Use `createParallelTools()` to create Search and Extract tools with shared client configuration:
13
+ Set `PARALLEL_API_KEY` before creating the tools.
14
14
 
15
15
  ```typescript
16
16
  import { Agent } from '@mastra/core/agent';
17
17
  import { createParallelTools } from '@mastra/parallel';
18
18
 
19
- const agent = new Agent({
19
+ export const researchAgent = new Agent({
20
20
  id: 'research-agent',
21
21
  name: 'Research Agent',
22
- model: 'anthropic/claude-sonnet-4-6',
23
- instructions: 'Search the web for current sources, then extract relevant content from the best pages.',
22
+ model: 'openai/gpt-5.6-sol',
23
+ instructions: 'Search the web, then extract relevant content from the best sources.',
24
24
  tools: createParallelTools(),
25
25
  });
26
26
  ```
27
27
 
28
- The tools read `PARALLEL_API_KEY` from the environment when you don't pass a key explicitly.
29
-
30
- ## Individual tools
31
-
32
- Create either tool independently when an agent doesn't need both:
33
-
34
- ```typescript
35
- import { createParallelExtractTool, createParallelSearchTool } from '@mastra/parallel';
36
-
37
- const search = createParallelSearchTool({ apiKey: 'parallel-api-key' });
38
- const extract = createParallelExtractTool();
39
- ```
40
-
41
- ### Search
42
-
43
- `createParallelSearchTool()` creates the `parallel-search` tool. It accepts one or more keyword queries and optional objective, mode, model, result, domain, location, freshness, character, and session controls. Results include ranked URLs and focused excerpts.
44
-
45
- ### Extract
46
-
47
- `createParallelExtractTool()` creates the `parallel-extract` tool. It accepts 1-20 URLs and optional objective, query, model, excerpt, full-content, freshness, character, and session controls. The result separates successful pages from per-URL errors.
28
+ ## Documentation
48
29
 
49
- ## Configuration
30
+ - [Parallel](https://mastra.ai/integrations/tools/parallel)
50
31
 
51
- All factories accept `ParallelClientOptions`, an alias of the official `ClientOptions` type from `parallel-web`. This includes `apiKey`, `baseURL`, `timeout`, `fetch`, `maxRetries`, request headers, and logging options. The API key defaults to `PARALLEL_API_KEY`.
32
+ ## Changelog
52
33
 
53
- The package also exports `getParallelClient()` when an application needs the configured official client directly:
54
-
55
- ```typescript
56
- import { getParallelClient } from '@mastra/parallel';
57
-
58
- const client = getParallelClient({ apiKey: 'parallel-api-key' });
59
- ```
34
+ See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/integrations/parallel/CHANGELOG.md) for version history and release notes.
60
35
 
61
- ## License
36
+ ## Support
62
37
 
63
- Apache-2.0
38
+ We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.
package/dist/extract.d.ts CHANGED
@@ -18,9 +18,9 @@ export declare function createParallelExtractTool(config?: ParallelClientOptions
18
18
  sessionId: string;
19
19
  results: {
20
20
  url: string;
21
- excerpts: string[];
22
21
  title?: string | undefined;
23
22
  publishDate?: string | undefined;
23
+ excerpts: string[];
24
24
  fullContent?: string | undefined;
25
25
  }[];
26
26
  errors: {
package/dist/search.d.ts CHANGED
@@ -2,7 +2,7 @@ import type { ParallelClientOptions } from './client.js';
2
2
  export declare function createParallelSearchTool(config?: ParallelClientOptions): import("@mastra/core/tools").Tool<{
3
3
  searchQueries: string[];
4
4
  objective?: string | undefined;
5
- mode?: "turbo" | "fast" | "basic" | "advanced" | undefined;
5
+ mode?: "advanced" | "basic" | "fast" | "turbo" | undefined;
6
6
  clientModel?: string | undefined;
7
7
  maxResults?: number | undefined;
8
8
  excerptMaxCharsPerResult?: number | undefined;
@@ -22,9 +22,9 @@ export declare function createParallelSearchTool(config?: ParallelClientOptions)
22
22
  sessionId: string;
23
23
  results: {
24
24
  url: string;
25
- excerpts: string[];
26
25
  title?: string | undefined;
27
26
  publishDate?: string | undefined;
27
+ excerpts: string[];
28
28
  }[];
29
29
  usage?: {
30
30
  name: string;
package/dist/tools.d.ts CHANGED
@@ -3,7 +3,7 @@ export declare function createParallelTools(config?: ParallelClientOptions): {
3
3
  parallelSearch: import("@mastra/core/tools").Tool<{
4
4
  searchQueries: string[];
5
5
  objective?: string | undefined;
6
- mode?: "turbo" | "fast" | "basic" | "advanced" | undefined;
6
+ mode?: "advanced" | "basic" | "fast" | "turbo" | undefined;
7
7
  clientModel?: string | undefined;
8
8
  maxResults?: number | undefined;
9
9
  excerptMaxCharsPerResult?: number | undefined;
@@ -23,9 +23,9 @@ export declare function createParallelTools(config?: ParallelClientOptions): {
23
23
  sessionId: string;
24
24
  results: {
25
25
  url: string;
26
- excerpts: string[];
27
26
  title?: string | undefined;
28
27
  publishDate?: string | undefined;
28
+ excerpts: string[];
29
29
  }[];
30
30
  usage?: {
31
31
  name: string;
@@ -56,9 +56,9 @@ export declare function createParallelTools(config?: ParallelClientOptions): {
56
56
  sessionId: string;
57
57
  results: {
58
58
  url: string;
59
- excerpts: string[];
60
59
  title?: string | undefined;
61
60
  publishDate?: string | undefined;
61
+ excerpts: string[];
62
62
  fullContent?: string | undefined;
63
63
  }[];
64
64
  errors: {
package/dist/tools.d.ts.map CHANGED
@@ -1 +1 @@
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"}
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;IAE9D,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACd,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAElB"}
package/package.json CHANGED
@@ -1,13 +1,12 @@
1
1
  {
2
2
  "name": "@mastra/parallel",
3
- "version": "0.1.0",
3
+ "version": "0.1.1-alpha.1",
4
4
  "description": "Parallel web search and extract tools for Mastra agents",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
7
7
  "types": "./dist/index.d.ts",
8
8
  "files": [
9
- "dist",
10
- "CHANGELOG.md"
9
+ "dist"
11
10
  ],
12
11
  "exports": {
13
12
  ".": {
@@ -52,12 +51,12 @@
52
51
  },
53
52
  "devDependencies": {
54
53
  "tsdown": "0.22.9",
55
- "typescript": "^6.0.3",
54
+ "typescript": "^7.0.2",
56
55
  "vitest": "4.1.10",
57
56
  "zod": "^4.4.3",
58
- "@internal/lint": "0.0.126",
59
- "@internal/types-builder": "0.0.101",
60
- "@mastra/core": "1.62.0"
57
+ "@internal/lint": "0.0.129",
58
+ "@internal/types-builder": "0.0.104",
59
+ "@mastra/core": "1.64.0-alpha.7"
61
60
  },
62
61
  "scripts": {
63
62
  "build:lib": "tsdown --silent --config tsdown.config.ts",
package/CHANGELOG.md DELETED
@@ -1,35 +0,0 @@
1
- # @mastra/parallel
2
-
3
- ## 0.1.0
4
-
5
- ### Minor Changes
6
-
7
- - Added Parallel Search and Extract tools for Mastra agents through the new `@mastra/parallel` package. ([#22070](https://github.com/mastra-ai/mastra/pull/22070))
8
-
9
- ```typescript
10
- import { createParallelTools } from '@mastra/parallel';
11
-
12
- const tools = createParallelTools();
13
- ```
14
-
15
- ### Patch Changes
16
-
17
- - 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)]:
18
- - @mastra/core@1.62.0
19
-
20
- ## 0.1.0-alpha.0
21
-
22
- ### Minor Changes
23
-
24
- - Added Parallel Search and Extract tools for Mastra agents through the new `@mastra/parallel` package. ([#22070](https://github.com/mastra-ai/mastra/pull/22070))
25
-
26
- ```typescript
27
- import { createParallelTools } from '@mastra/parallel';
28
-
29
- const tools = createParallelTools();
30
- ```
31
-
32
- ### Patch Changes
33
-
34
- - Updated dependencies [[`2c85f42`](https://github.com/mastra-ai/mastra/commit/2c85f428e04ccd63ea31a7ec80b5b327afdad555), [`11bbeb9`](https://github.com/mastra-ai/mastra/commit/11bbeb9b108ef2264e05acefc6dafb9cbb342921), [`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), [`575e343`](https://github.com/mastra-ai/mastra/commit/575e343900451021d96110916497d334af7bc252), [`cacb839`](https://github.com/mastra-ai/mastra/commit/cacb8392d9e74189b56d857290b0615f98a2683d), [`b47b26e`](https://github.com/mastra-ai/mastra/commit/b47b26e6fe95cb8a3482be2c5e52de157fe59d0b), [`0d37487`](https://github.com/mastra-ai/mastra/commit/0d37487d9f349388a3f1cef6a536cf9dcc4b6273), [`c46eb09`](https://github.com/mastra-ai/mastra/commit/c46eb09ce4987509af57a0ac582c61241a6dd2f1), [`30ed33e`](https://github.com/mastra-ai/mastra/commit/30ed33ee14084a26019aba15fceadda6d6ddefaf), [`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), [`c5eaec5`](https://github.com/mastra-ai/mastra/commit/c5eaec5a860d80d0e3805e67db0414b87ac8cbed), [`e66b2ba`](https://github.com/mastra-ai/mastra/commit/e66b2ba100db63eaeab6e21e1ea34b113f2ec781)]:
35
- - @mastra/core@1.62.0-alpha.3