@parallel-web/ai-sdk-tools 0.1.0

package/README.md

@@ -0,0 +1,167 @@
+# @parallel-web/ai-sdk-tools
+
+AI-SDK tools for Parallel Web with support for Vercel's AI-SDK v4 and v5.
+
+## Installation
+
+```bash
+npm install ai @parallel-web/ai-sdk-tools
+# or
+pnpm add ai @parallel-web/ai-sdk-tools
+# or
+yarn add ai @parallel-web/ai-sdk-tools
+```
+
+## Usage
+
+Add `PARALLEL_API_KEY` obtained from [Parallel Platform](https://platform.parallel.ai/settings?tab=api-keys) to your environment variables.
+
+### Search Tool
+
+`searchTool` uses [Parallel's web search API](https://docs.parallel.ai/api-reference/search-api/search) to get fresh relevant search results.
+
+### Extract Tool
+
+`extractTool` uses [Parallel's extract API](https://docs.parallel.ai/api-reference/search-and-extract-api-beta/extract) to extract a web-page's content, for a given objective.
+
+
+### With AI SDK v5 (Default exports)
+
+```typescript
+import { openai } from '@ai-sdk/openai';
+import { streamText, type Tool } from 'ai';
+import { searchTool, extractTool } from '@parallel-web/ai-sdk-tools';
+
+const result = streamText({
+  model: openai('gpt-4o'),
+  messages: [
+    { role: 'user', content: 'What are the latest developments in AI?' }
+  ],
+  tools: {
+    'web-search': searchTool as Tool,
+    'web-extract': extractTool as Tool,
+  },
+  toolChoice: 'auto',
+});
+
+// Stream the response
+return result.toDataStreamResponse();
+```
+
+### With AI SDK v4
+
+```typescript
+import { openai } from '@ai-sdk/openai';
+import { streamText, type Tool } from 'ai';
+import { searchTool, extractTool } from '@parallel-web/ai-sdk-tools/v4';
+
+const result = streamText({
+  model: openai('gpt-4o'),
+  messages: [
+    { role: 'user', content: 'What are the latest developments in AI?' }
+  ],
+  tools: {
+    'web-search': searchTool as Tool,
+    'web-extract': extractTool as Tool,
+  },
+  toolChoice: 'auto',
+});
+
+// Stream the response
+return result.toDataStreamResponse();
+```
+
+
+### Custom Tools
+
+You can create custom tools that wrap the Parallel Web API:
+
+**For AI SDK v5:**
+```typescript
+import { tool, generateText } from 'ai';
+import { openai } from '@ai-sdk/openai';
+import { z } from 'zod';
+import { Parallel } from 'parallel-web';
+
+const parallel = new Parallel({
+  apiKey: process.env.PARALLEL_API_KEY,
+});
+
+const webSearch = tool({
+  description: 'Use this tool to search the web.',
+  inputSchema: z.object({  // v5 uses inputSchema
+    searchQueries: z.array(z.string()).describe("Search queries"),
+    usersQuestion: z.string().describe("The user's question"),
+  }),
+  execute: async ({ searchQueries, usersQuestion }) => {
+    const search = await parallel.beta.search({
+      objective: usersQuestion,
+      search_queries: searchQueries,
+      max_results: 3,
+      max_chars_per_result: 1000,
+    });
+    return search.results;
+  },
+});
+```
+
+**For AI SDK v4:**
+```typescript
+import { tool } from 'ai';
+import { z } from 'zod';
+import { Parallel } from 'parallel-web';
+
+const parallel = new Parallel({
+  apiKey: process.env.PARALLEL_API_KEY,
+});
+
+const webSearch = tool({
+  description: 'Use this tool to search the web.',
+  parameters: z.object({  // v4 uses parameters
+    searchQueries: z.array(z.string()).describe("Search queries"),
+    usersQuestion: z.string().describe("The user's question"),
+  }),
+  execute: async ({ searchQueries, usersQuestion }) => {
+    const search = await parallel.beta.search({
+      objective: usersQuestion,
+      search_queries: searchQueries,
+      max_results: 3,
+      max_chars_per_result: 1000,
+    });
+    return search.results;
+  },
+});
+```
+
+
+**Note:** This package includes both AI SDK v4 and v5 support via package aliases.
+
+## Version Compatibility
+
+**This package supports both AI SDK v4 and v5.** 
+
+Using npm package aliases, we bundle both `ai@4.x` and `ai@5.x` within the same package, providing compatibility for both versions.
+
+### Choose Your Version
+
+- **AI SDK v5 (Default/Recommended)**
+  ```typescript
+  import { searchTool, extractTool } from '@parallel-web/ai-sdk-tools';
+  // or explicitly
+  import { searchTool, extractTool } from '@parallel-web/ai-sdk-tools/v5';
+  ```
+
+- **AI SDK v4**
+  ```typescript
+  import { searchTool, extractTool } from '@parallel-web/ai-sdk-tools/v4';
+  ```
+
+### How It Works
+
+The package uses npm package aliases to install both versions:
+- `ai-v4`: Maps to `ai@^4.0.0` (uses `parameters` API)
+- `ai-v5`: Maps to `ai@^5.0.0` (uses `inputSchema` API)
+
+Each version has its own implementation that imports from the appropriate aliased package, ensuring compatibility with both SDK versions.
+
+

package/dist/index.cjs

@@ -0,0 +1,145 @@
+'use strict';
+
+var aiV5 = require('ai-v5');
+var zod = require('zod');
+var parallelWeb = require('parallel-web');
+
+// src/v5/tools/search.ts
+var _parallelClient = null;
+var parallelClient = new Proxy({}, {
+  get(_target, prop) {
+    if (!_parallelClient) {
+      _parallelClient = new parallelWeb.Parallel({
+        apiKey: process.env["PARALLEL_API_KEY"]
+      });
+    }
+    return _parallelClient[prop];
+  }
+});
+
+// src/v5/tools/search.ts
+function getSearchParams(search_type) {
+  switch (search_type) {
+    case "targeted":
+      return { max_results: 5, max_chars_per_result: 16e3 };
+    case "general":
+      return { max_results: 10, max_chars_per_result: 9e3 };
+    case "single_page":
+      return { max_results: 2, max_chars_per_result: 3e4 };
+    case "list":
+    default:
+      return { max_results: 20, max_chars_per_result: 1500 };
+  }
+}
+var search = async (searchArgs, { abortSignal }) => {
+  return await parallelClient.beta.search(
+    {
+      ...searchArgs
+    },
+    {
+      signal: abortSignal
+      // headers: { 'parallel-beta': 'search-extract-2025-10-10' },
+    }
+  );
+};
+var searchTool = aiV5.tool({
+  description: `Use the web_search_parallel tool to access information from the web. The
+web_search_parallel tool returns ranked, extended web excerpts optimized for LLMs.
+Intelligently scale the number of web_search_parallel tool calls to get more information
+when needed, from a single call for simple factual questions to five or more calls for
+complex research questions.
+
+* Keep queries concise - 1-6 words for best results. Start broad with very short
+  queries and medium context, then add words to narrow results or use high context
+  if needed.
+* Include broader context about what the search is trying to accomplish in the
+  \`objective\` field. This helps the search engine understand the user's intent and
+  provide relevant results and excerpts.
+* Never repeat similar search queries - make every query unique. If initial results are
+  insufficient, reformulate queries to obtain new and better results.
+
+How to use:
+- For simple queries, a one-shot call to depth is usually sufficient.
+- For complex multi-hop queries, first try to use breadth to narrow down sources. Then
+use other search types with include_domains to get more detailed results.`,
+  inputSchema: zod.z.object({
+    objective: zod.z.string().describe(
+      `Natural-language description of what the web research goal
+ is. Specify the broad intent of the search query here. Also include any source or
+ freshness guidance here. Limit to 200 characters. This should reflect the end goal so
+ that the tool can better understand the intent and return the best results. Do not
+ dump long texts.`
+    ),
+    search_type: zod.z.enum(["list", "general", "single_page", "targeted"]).describe(
+      `Can be "list", "general", "single_page" or "targeted".
+ "list" should be used for searching for data broadly, like aggregating data or
+ considering multiple sources or doing broad initial research. "targeted" should be
+ used for searching for data from a specific source set. "general" is a catch all case
+ if there is no specific use case from list or targeted. "single_page" extracts data
+ from a single page - extremely targeted. If there is a specific webpage you want the
+ data from, use "single_page" and mention the URL in the objective.
+ Use search_type appropriately.`
+    ).optional().default("list"),
+    search_queries: zod.z.array(zod.z.string()).optional().describe(
+      `(optional) List of keyword search queries of 1-6
+ words, which may include search operators. The search queries should be related to the
+ objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are
+ ideal.`
+    ),
+    include_domains: zod.z.array(zod.z.string()).optional().describe(`(optional) List of valid URL domains to explicitly
+ focus on for the search. This will restrict all search results to only include results
+ from the provided list. This is useful when you want to only use a specific set of
+ sources. example: ["google.com", "wikipedia.org"]. Maximum 10 entries.`)
+  }),
+  execute: async function({ ...args }, { abortSignal }) {
+    const results = await search(
+      { ...args, ...getSearchParams(args.search_type) },
+      { abortSignal }
+    );
+    return {
+      searchParams: args,
+      answer: results
+    };
+  }
+});
+var extractTool = aiV5.tool({
+  description: `Purpose: Fetch and extract relevant content from specific web URLs.
+
+Ideal Use Cases:
+- Extracting content from specific URLs you've already identified
+- Exploring URLs returned by a web search in greater depth`,
+  inputSchema: zod.z.object({
+    objective: zod.z.string().describe(
+      `Natural-language description of what information you're looking for from the URLs. 
+ Limit to 200 characters.`
+    ),
+    urls: zod.z.array(zod.z.string()).describe(
+      `List of URLs to extract content from. Must be valid
+HTTP/HTTPS URLs. Maximum 10 URLs per request.`
+    ),
+    search_queries: zod.z.array(zod.z.string()).optional().describe(
+      `(optional) List of keyword search queries of 1-6
+ words, which may include search operators. The search queries should be related to the
+ objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are
+ ideal.`
+    )
+  }),
+  execute: async function({ ...args }, { abortSignal }) {
+    const results = await parallelClient.beta.extract(
+      { ...args },
+      {
+        signal: abortSignal,
+        headers: { "parallel-beta": "search-extract-2025-10-10" }
+      }
+    );
+    return {
+      searchParams: args,
+      answer: results
+    };
+  }
+});
+
+exports.extractTool = extractTool;
+exports.searchTool = searchTool;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/v5/tools/search.ts","../src/v5/tools/extract.ts"],"names":["Parallel","tool","z"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Shared Parallel Web client instance\n */\n\nimport { Parallel } from 'parallel-web';\n\nlet _parallelClient: Parallel | null = null;\n\nexport const parallelClient = new Proxy({} as Parallel, {\n  get(_target, prop) {\n    if (!_parallelClient) {\n      _parallelClient = new Parallel({\n        apiKey: process.env['PARALLEL_API_KEY'],\n      });\n    }\n    return (_parallelClient as any)[prop];\n  },\n});\n","/**\n * Search tool for Parallel Web (AI SDK v5)\n */\n\nimport { tool, type Tool as ToolV5 } from 'ai-v5';\nimport { z } from 'zod';\nimport { BetaSearchParams } from 'parallel-web/resources/beta/beta.mjs';\nimport { parallelClient } from '../../client.js';\n\nfunction getSearchParams(\n  search_type: 'list' | 'targeted' | 'general' | 'single_page'\n): Pick<BetaSearchParams, 'max_results' | 'max_chars_per_result'> {\n  switch (search_type) {\n    case 'targeted':\n      return { max_results: 5, max_chars_per_result: 16000 };\n    case 'general':\n      return { max_results: 10, max_chars_per_result: 9000 };\n    case 'single_page':\n      return { max_results: 2, max_chars_per_result: 30000 };\n    case 'list':\n    default:\n      return { max_results: 20, max_chars_per_result: 1500 };\n  }\n}\n\nconst search = async (\n  searchArgs: BetaSearchParams,\n  { abortSignal }: { abortSignal: AbortSignal | undefined }\n) => {\n  return await parallelClient.beta.search(\n    {\n      ...searchArgs,\n    },\n    {\n      signal: abortSignal,\n      // headers: { 'parallel-beta': 'search-extract-2025-10-10' },\n    }\n  );\n};\n\nexport const searchTool: ToolV5 = tool({\n  description: `Use the web_search_parallel tool to access information from the web. The\nweb_search_parallel tool returns ranked, extended web excerpts optimized for LLMs.\nIntelligently scale the number of web_search_parallel tool calls to get more information\nwhen needed, from a single call for simple factual questions to five or more calls for\ncomplex research questions.\n\n* Keep queries concise - 1-6 words for best results. Start broad with very short\n  queries and medium context, then add words to narrow results or use high context\n  if needed.\n* Include broader context about what the search is trying to accomplish in the\n  \\`objective\\` field. This helps the search engine understand the user's intent and\n  provide relevant results and excerpts.\n* Never repeat similar search queries - make every query unique. If initial results are\n  insufficient, reformulate queries to obtain new and better results.\n\nHow to use:\n- For simple queries, a one-shot call to depth is usually sufficient.\n- For complex multi-hop queries, first try to use breadth to narrow down sources. Then\nuse other search types with include_domains to get more detailed results.`,\n  inputSchema: z.object({\n    objective: z.string().describe(\n      `Natural-language description of what the web research goal\n is. Specify the broad intent of the search query here. Also include any source or\n freshness guidance here. Limit to 200 characters. This should reflect the end goal so\n that the tool can better understand the intent and return the best results. Do not\n dump long texts.`\n    ),\n    search_type: z\n      .enum(['list', 'general', 'single_page', 'targeted'])\n      .describe(\n        `Can be \"list\", \"general\", \"single_page\" or \"targeted\".\n \"list\" should be used for searching for data broadly, like aggregating data or\n considering multiple sources or doing broad initial research. \"targeted\" should be\n used for searching for data from a specific source set. \"general\" is a catch all case\n if there is no specific use case from list or targeted. \"single_page\" extracts data\n from a single page - extremely targeted. If there is a specific webpage you want the\n data from, use \"single_page\" and mention the URL in the objective.\n Use search_type appropriately.`\n      )\n      .optional()\n      .default('list'),\n    search_queries: z\n      .array(z.string())\n      .optional()\n      .describe(\n        `(optional) List of keyword search queries of 1-6\n words, which may include search operators. The search queries should be related to the\n objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are\n ideal.`\n      ),\n    include_domains: z.array(z.string()).optional()\n      .describe(`(optional) List of valid URL domains to explicitly\n focus on for the search. This will restrict all search results to only include results\n from the provided list. This is useful when you want to only use a specific set of\n sources. example: [\"google.com\", \"wikipedia.org\"]. Maximum 10 entries.`),\n  }),\n\n  execute: async function ({ ...args }, { abortSignal }) {\n    const results = await search(\n      { ...args, ...getSearchParams(args.search_type) },\n      { abortSignal }\n    );\n\n    return {\n      searchParams: args,\n      answer: results,\n    };\n  },\n});\n","/**\n * Extract tool for Parallel Web (AI SDK v5)\n */\n\nimport { tool, type Tool as ToolV5 } from 'ai-v5';\nimport { z } from 'zod';\nimport { parallelClient } from '../../client.js';\n\nexport const extractTool: ToolV5 = tool({\n  description: `Purpose: Fetch and extract relevant content from specific web URLs.\n\nIdeal Use Cases:\n- Extracting content from specific URLs you've already identified\n- Exploring URLs returned by a web search in greater depth`,\n  inputSchema: z.object({\n    objective: z.string().describe(\n      `Natural-language description of what information you're looking for from the URLs. \n Limit to 200 characters.`\n    ),\n\n    urls: z.array(z.string()).describe(\n      `List of URLs to extract content from. Must be valid\nHTTP/HTTPS URLs. Maximum 10 URLs per request.`\n    ),\n    search_queries: z\n      .array(z.string())\n      .optional()\n      .describe(\n        `(optional) List of keyword search queries of 1-6\n words, which may include search operators. The search queries should be related to the\n objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are\n ideal.`\n      ),\n  }),\n\n  execute: async function ({ ...args }, { abortSignal }) {\n    const results = await parallelClient.beta.extract(\n      { ...args },\n      {\n        signal: abortSignal,\n        headers: { 'parallel-beta': 'search-extract-2025-10-10' },\n      }\n    );\n\n    return {\n      searchParams: args,\n      answer: results,\n    };\n  },\n});\n"]}

package/dist/index.d.cts

@@ -0,0 +1,15 @@
+import { Tool } from 'ai-v5';
+
+/**
+ * Search tool for Parallel Web (AI SDK v5)
+ */
+
+declare const searchTool: Tool;
+
+/**
+ * Extract tool for Parallel Web (AI SDK v5)
+ */
+
+declare const extractTool: Tool;
+
+export { extractTool, searchTool };

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { Tool } from 'ai-v5';
+
+/**
+ * Search tool for Parallel Web (AI SDK v5)
+ */
+
+declare const searchTool: Tool;
+
+/**
+ * Extract tool for Parallel Web (AI SDK v5)
+ */
+
+declare const extractTool: Tool;
+
+export { extractTool, searchTool };

package/dist/index.js

@@ -0,0 +1,142 @@
+import { tool } from 'ai-v5';
+import { z } from 'zod';
+import { Parallel } from 'parallel-web';
+
+// src/v5/tools/search.ts
+var _parallelClient = null;
+var parallelClient = new Proxy({}, {
+  get(_target, prop) {
+    if (!_parallelClient) {
+      _parallelClient = new Parallel({
+        apiKey: process.env["PARALLEL_API_KEY"]
+      });
+    }
+    return _parallelClient[prop];
+  }
+});
+
+// src/v5/tools/search.ts
+function getSearchParams(search_type) {
+  switch (search_type) {
+    case "targeted":
+      return { max_results: 5, max_chars_per_result: 16e3 };
+    case "general":
+      return { max_results: 10, max_chars_per_result: 9e3 };
+    case "single_page":
+      return { max_results: 2, max_chars_per_result: 3e4 };
+    case "list":
+    default:
+      return { max_results: 20, max_chars_per_result: 1500 };
+  }
+}
+var search = async (searchArgs, { abortSignal }) => {
+  return await parallelClient.beta.search(
+    {
+      ...searchArgs
+    },
+    {
+      signal: abortSignal
+      // headers: { 'parallel-beta': 'search-extract-2025-10-10' },
+    }
+  );
+};
+var searchTool = tool({
+  description: `Use the web_search_parallel tool to access information from the web. The
+web_search_parallel tool returns ranked, extended web excerpts optimized for LLMs.
+Intelligently scale the number of web_search_parallel tool calls to get more information
+when needed, from a single call for simple factual questions to five or more calls for
+complex research questions.
+
+* Keep queries concise - 1-6 words for best results. Start broad with very short
+  queries and medium context, then add words to narrow results or use high context
+  if needed.
+* Include broader context about what the search is trying to accomplish in the
+  \`objective\` field. This helps the search engine understand the user's intent and
+  provide relevant results and excerpts.
+* Never repeat similar search queries - make every query unique. If initial results are
+  insufficient, reformulate queries to obtain new and better results.
+
+How to use:
+- For simple queries, a one-shot call to depth is usually sufficient.
+- For complex multi-hop queries, first try to use breadth to narrow down sources. Then
+use other search types with include_domains to get more detailed results.`,
+  inputSchema: z.object({
+    objective: z.string().describe(
+      `Natural-language description of what the web research goal
+ is. Specify the broad intent of the search query here. Also include any source or
+ freshness guidance here. Limit to 200 characters. This should reflect the end goal so
+ that the tool can better understand the intent and return the best results. Do not
+ dump long texts.`
+    ),
+    search_type: z.enum(["list", "general", "single_page", "targeted"]).describe(
+      `Can be "list", "general", "single_page" or "targeted".
+ "list" should be used for searching for data broadly, like aggregating data or
+ considering multiple sources or doing broad initial research. "targeted" should be
+ used for searching for data from a specific source set. "general" is a catch all case
+ if there is no specific use case from list or targeted. "single_page" extracts data
+ from a single page - extremely targeted. If there is a specific webpage you want the
+ data from, use "single_page" and mention the URL in the objective.
+ Use search_type appropriately.`
+    ).optional().default("list"),
+    search_queries: z.array(z.string()).optional().describe(
+      `(optional) List of keyword search queries of 1-6
+ words, which may include search operators. The search queries should be related to the
+ objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are
+ ideal.`
+    ),
+    include_domains: z.array(z.string()).optional().describe(`(optional) List of valid URL domains to explicitly
+ focus on for the search. This will restrict all search results to only include results
+ from the provided list. This is useful when you want to only use a specific set of
+ sources. example: ["google.com", "wikipedia.org"]. Maximum 10 entries.`)
+  }),
+  execute: async function({ ...args }, { abortSignal }) {
+    const results = await search(
+      { ...args, ...getSearchParams(args.search_type) },
+      { abortSignal }
+    );
+    return {
+      searchParams: args,
+      answer: results
+    };
+  }
+});
+var extractTool = tool({
+  description: `Purpose: Fetch and extract relevant content from specific web URLs.
+
+Ideal Use Cases:
+- Extracting content from specific URLs you've already identified
+- Exploring URLs returned by a web search in greater depth`,
+  inputSchema: z.object({
+    objective: z.string().describe(
+      `Natural-language description of what information you're looking for from the URLs. 
+ Limit to 200 characters.`
+    ),
+    urls: z.array(z.string()).describe(
+      `List of URLs to extract content from. Must be valid
+HTTP/HTTPS URLs. Maximum 10 URLs per request.`
+    ),
+    search_queries: z.array(z.string()).optional().describe(
+      `(optional) List of keyword search queries of 1-6
+ words, which may include search operators. The search queries should be related to the
+ objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are
+ ideal.`
+    )
+  }),
+  execute: async function({ ...args }, { abortSignal }) {
+    const results = await parallelClient.beta.extract(
+      { ...args },
+      {
+        signal: abortSignal,
+        headers: { "parallel-beta": "search-extract-2025-10-10" }
+      }
+    );
+    return {
+      searchParams: args,
+      answer: results
+    };
+  }
+});
+
+export { extractTool, searchTool };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/v5/tools/search.ts","../src/v5/tools/extract.ts"],"names":["tool","z"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Shared Parallel Web client instance\n */\n\nimport { Parallel } from 'parallel-web';\n\nlet _parallelClient: Parallel | null = null;\n\nexport const parallelClient = new Proxy({} as Parallel, {\n  get(_target, prop) {\n    if (!_parallelClient) {\n      _parallelClient = new Parallel({\n        apiKey: process.env['PARALLEL_API_KEY'],\n      });\n    }\n    return (_parallelClient as any)[prop];\n  },\n});\n","/**\n * Search tool for Parallel Web (AI SDK v5)\n */\n\nimport { tool, type Tool as ToolV5 } from 'ai-v5';\nimport { z } from 'zod';\nimport { BetaSearchParams } from 'parallel-web/resources/beta/beta.mjs';\nimport { parallelClient } from '../../client.js';\n\nfunction getSearchParams(\n  search_type: 'list' | 'targeted' | 'general' | 'single_page'\n): Pick<BetaSearchParams, 'max_results' | 'max_chars_per_result'> {\n  switch (search_type) {\n    case 'targeted':\n      return { max_results: 5, max_chars_per_result: 16000 };\n    case 'general':\n      return { max_results: 10, max_chars_per_result: 9000 };\n    case 'single_page':\n      return { max_results: 2, max_chars_per_result: 30000 };\n    case 'list':\n    default:\n      return { max_results: 20, max_chars_per_result: 1500 };\n  }\n}\n\nconst search = async (\n  searchArgs: BetaSearchParams,\n  { abortSignal }: { abortSignal: AbortSignal | undefined }\n) => {\n  return await parallelClient.beta.search(\n    {\n      ...searchArgs,\n    },\n    {\n      signal: abortSignal,\n      // headers: { 'parallel-beta': 'search-extract-2025-10-10' },\n    }\n  );\n};\n\nexport const searchTool: ToolV5 = tool({\n  description: `Use the web_search_parallel tool to access information from the web. The\nweb_search_parallel tool returns ranked, extended web excerpts optimized for LLMs.\nIntelligently scale the number of web_search_parallel tool calls to get more information\nwhen needed, from a single call for simple factual questions to five or more calls for\ncomplex research questions.\n\n* Keep queries concise - 1-6 words for best results. Start broad with very short\n  queries and medium context, then add words to narrow results or use high context\n  if needed.\n* Include broader context about what the search is trying to accomplish in the\n  \\`objective\\` field. This helps the search engine understand the user's intent and\n  provide relevant results and excerpts.\n* Never repeat similar search queries - make every query unique. If initial results are\n  insufficient, reformulate queries to obtain new and better results.\n\nHow to use:\n- For simple queries, a one-shot call to depth is usually sufficient.\n- For complex multi-hop queries, first try to use breadth to narrow down sources. Then\nuse other search types with include_domains to get more detailed results.`,\n  inputSchema: z.object({\n    objective: z.string().describe(\n      `Natural-language description of what the web research goal\n is. Specify the broad intent of the search query here. Also include any source or\n freshness guidance here. Limit to 200 characters. This should reflect the end goal so\n that the tool can better understand the intent and return the best results. Do not\n dump long texts.`\n    ),\n    search_type: z\n      .enum(['list', 'general', 'single_page', 'targeted'])\n      .describe(\n        `Can be \"list\", \"general\", \"single_page\" or \"targeted\".\n \"list\" should be used for searching for data broadly, like aggregating data or\n considering multiple sources or doing broad initial research. \"targeted\" should be\n used for searching for data from a specific source set. \"general\" is a catch all case\n if there is no specific use case from list or targeted. \"single_page\" extracts data\n from a single page - extremely targeted. If there is a specific webpage you want the\n data from, use \"single_page\" and mention the URL in the objective.\n Use search_type appropriately.`\n      )\n      .optional()\n      .default('list'),\n    search_queries: z\n      .array(z.string())\n      .optional()\n      .describe(\n        `(optional) List of keyword search queries of 1-6\n words, which may include search operators. The search queries should be related to the\n objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are\n ideal.`\n      ),\n    include_domains: z.array(z.string()).optional()\n      .describe(`(optional) List of valid URL domains to explicitly\n focus on for the search. This will restrict all search results to only include results\n from the provided list. This is useful when you want to only use a specific set of\n sources. example: [\"google.com\", \"wikipedia.org\"]. Maximum 10 entries.`),\n  }),\n\n  execute: async function ({ ...args }, { abortSignal }) {\n    const results = await search(\n      { ...args, ...getSearchParams(args.search_type) },\n      { abortSignal }\n    );\n\n    return {\n      searchParams: args,\n      answer: results,\n    };\n  },\n});\n","/**\n * Extract tool for Parallel Web (AI SDK v5)\n */\n\nimport { tool, type Tool as ToolV5 } from 'ai-v5';\nimport { z } from 'zod';\nimport { parallelClient } from '../../client.js';\n\nexport const extractTool: ToolV5 = tool({\n  description: `Purpose: Fetch and extract relevant content from specific web URLs.\n\nIdeal Use Cases:\n- Extracting content from specific URLs you've already identified\n- Exploring URLs returned by a web search in greater depth`,\n  inputSchema: z.object({\n    objective: z.string().describe(\n      `Natural-language description of what information you're looking for from the URLs. \n Limit to 200 characters.`\n    ),\n\n    urls: z.array(z.string()).describe(\n      `List of URLs to extract content from. Must be valid\nHTTP/HTTPS URLs. Maximum 10 URLs per request.`\n    ),\n    search_queries: z\n      .array(z.string())\n      .optional()\n      .describe(\n        `(optional) List of keyword search queries of 1-6\n words, which may include search operators. The search queries should be related to the\n objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are\n ideal.`\n      ),\n  }),\n\n  execute: async function ({ ...args }, { abortSignal }) {\n    const results = await parallelClient.beta.extract(\n      { ...args },\n      {\n        signal: abortSignal,\n        headers: { 'parallel-beta': 'search-extract-2025-10-10' },\n      }\n    );\n\n    return {\n      searchParams: args,\n      answer: results,\n    };\n  },\n});\n"]}

package/dist/v4.cjs

@@ -0,0 +1,145 @@
+'use strict';
+
+var aiV4 = require('ai-v4');
+var zod = require('zod');
+var parallelWeb = require('parallel-web');
+
+// src/v4/tools/search.ts
+var _parallelClient = null;
+var parallelClient = new Proxy({}, {
+  get(_target, prop) {
+    if (!_parallelClient) {
+      _parallelClient = new parallelWeb.Parallel({
+        apiKey: process.env["PARALLEL_API_KEY"]
+      });
+    }
+    return _parallelClient[prop];
+  }
+});
+
+// src/v4/tools/search.ts
+function getSearchParams(search_type) {
+  switch (search_type) {
+    case "targeted":
+      return { max_results: 5, max_chars_per_result: 16e3 };
+    case "general":
+      return { max_results: 10, max_chars_per_result: 9e3 };
+    case "single_page":
+      return { max_results: 2, max_chars_per_result: 3e4 };
+    case "list":
+    default:
+      return { max_results: 20, max_chars_per_result: 1500 };
+  }
+}
+var search = async (searchArgs, { abortSignal }) => {
+  return await parallelClient.beta.search(
+    {
+      ...searchArgs
+    },
+    {
+      signal: abortSignal
+      // headers: { 'parallel-beta': 'search-extract-2025-10-10' },
+    }
+  );
+};
+var searchTool = aiV4.tool({
+  description: `Use the web_search_parallel tool to access information from the web. The
+web_search_parallel tool returns ranked, extended web excerpts optimized for LLMs.
+Intelligently scale the number of web_search_parallel tool calls to get more information
+when needed, from a single call for simple factual questions to five or more calls for
+complex research questions.
+
+* Keep queries concise - 1-6 words for best results. Start broad with very short
+  queries and medium context, then add words to narrow results or use high context
+  if needed.
+* Include broader context about what the search is trying to accomplish in the
+  \`objective\` field. This helps the search engine understand the user's intent and
+  provide relevant results and excerpts.
+* Never repeat similar search queries - make every query unique. If initial results are
+  insufficient, reformulate queries to obtain new and better results.
+
+How to use:
+- For simple queries, a one-shot call to depth is usually sufficient.
+- For complex multi-hop queries, first try to use breadth to narrow down sources. Then
+use other search types with include_domains to get more detailed results.`,
+  parameters: zod.z.object({
+    objective: zod.z.string().describe(
+      `Natural-language description of what the web research goal
+ is. Specify the broad intent of the search query here. Also include any source or
+ freshness guidance here. Limit to 200 characters. This should reflect the end goal so
+ that the tool can better understand the intent and return the best results. Do not
+ dump long texts.`
+    ),
+    search_type: zod.z.enum(["list", "general", "single_page", "targeted"]).describe(
+      `Can be "list", "general", "single_page" or "targeted".
+ "list" should be used for searching for data broadly, like aggregating data or
+ considering multiple sources or doing broad initial research. "targeted" should be
+ used for searching for data from a specific source set. "general" is a catch all case
+ if there is no specific use case from list or targeted. "single_page" extracts data
+ from a single page - extremely targeted. If there is a specific webpage you want the
+ data from, use "single_page" and mention the URL in the objective.
+ Use search_type appropriately.`
+    ).optional().default("list"),
+    search_queries: zod.z.array(zod.z.string()).optional().describe(
+      `(optional) List of keyword search queries of 1-6
+ words, which may include search operators. The search queries should be related to the
+ objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are
+ ideal.`
+    ),
+    include_domains: zod.z.array(zod.z.string()).optional().describe(`(optional) List of valid URL domains to explicitly
+ focus on for the search. This will restrict all search results to only include results
+ from the provided list. This is useful when you want to only use a specific set of
+ sources. example: ["google.com", "wikipedia.org"]. Maximum 10 entries.`)
+  }),
+  execute: async function({ ...args }, { abortSignal }) {
+    const results = await search(
+      { ...args, ...getSearchParams(args.search_type) },
+      { abortSignal }
+    );
+    return {
+      searchParams: args,
+      answer: results
+    };
+  }
+});
+var extractTool = aiV4.tool({
+  description: `Purpose: Fetch and extract relevant content from specific web URLs.
+
+Ideal Use Cases:
+- Extracting content from specific URLs you've already identified
+- Exploring URLs returned by a web search in greater depth`,
+  parameters: zod.z.object({
+    objective: zod.z.string().describe(
+      `Natural-language description of what information you're looking for from the URLs. 
+ Limit to 200 characters.`
+    ),
+    urls: zod.z.array(zod.z.string()).describe(
+      `List of URLs to extract content from. Must be valid
+HTTP/HTTPS URLs. Maximum 10 URLs per request.`
+    ),
+    search_queries: zod.z.array(zod.z.string()).optional().describe(
+      `(optional) List of keyword search queries of 1-6
+ words, which may include search operators. The search queries should be related to the
+ objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are
+ ideal.`
+    )
+  }),
+  execute: async function({ ...args }, { abortSignal }) {
+    const results = await parallelClient.beta.extract(
+      { ...args },
+      {
+        signal: abortSignal,
+        headers: { "parallel-beta": "search-extract-2025-10-10" }
+      }
+    );
+    return {
+      searchParams: args,
+      answer: results
+    };
+  }
+});
+
+exports.extractTool = extractTool;
+exports.searchTool = searchTool;
+//# sourceMappingURL=v4.cjs.map
+//# sourceMappingURL=v4.cjs.map

package/dist/v4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/v4/tools/search.ts","../src/v4/tools/extract.ts"],"names":["Parallel","tool","z"],"mappings":"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","file":"v4.cjs","sourcesContent":["/**\n * Shared Parallel Web client instance\n */\n\nimport { Parallel } from 'parallel-web';\n\nlet _parallelClient: Parallel | null = null;\n\nexport const parallelClient = new Proxy({} as Parallel, {\n  get(_target, prop) {\n    if (!_parallelClient) {\n      _parallelClient = new Parallel({\n        apiKey: process.env['PARALLEL_API_KEY'],\n      });\n    }\n    return (_parallelClient as any)[prop];\n  },\n});\n","/**\n * Search tool for Parallel Web (AI SDK v4)\n */\n\nimport { tool, type Tool as ToolV4 } from 'ai-v4';\nimport { z } from 'zod';\nimport { BetaSearchParams } from 'parallel-web/resources/beta/beta.mjs';\nimport { parallelClient } from '../../client.js';\n\nfunction getSearchParams(\n  search_type: 'list' | 'targeted' | 'general' | 'single_page'\n): Pick<BetaSearchParams, 'max_results' | 'max_chars_per_result'> {\n  switch (search_type) {\n    case 'targeted':\n      return { max_results: 5, max_chars_per_result: 16000 };\n    case 'general':\n      return { max_results: 10, max_chars_per_result: 9000 };\n    case 'single_page':\n      return { max_results: 2, max_chars_per_result: 30000 };\n    case 'list':\n    default:\n      return { max_results: 20, max_chars_per_result: 1500 };\n  }\n}\n\nconst search = async (\n  searchArgs: BetaSearchParams,\n  { abortSignal }: { abortSignal: AbortSignal | undefined }\n) => {\n  return await parallelClient.beta.search(\n    {\n      ...searchArgs,\n    },\n    {\n      signal: abortSignal,\n      // headers: { 'parallel-beta': 'search-extract-2025-10-10' },\n    }\n  );\n};\n\nexport const searchTool: ToolV4 = tool({\n  description: `Use the web_search_parallel tool to access information from the web. The\nweb_search_parallel tool returns ranked, extended web excerpts optimized for LLMs.\nIntelligently scale the number of web_search_parallel tool calls to get more information\nwhen needed, from a single call for simple factual questions to five or more calls for\ncomplex research questions.\n\n* Keep queries concise - 1-6 words for best results. Start broad with very short\n  queries and medium context, then add words to narrow results or use high context\n  if needed.\n* Include broader context about what the search is trying to accomplish in the\n  \\`objective\\` field. This helps the search engine understand the user's intent and\n  provide relevant results and excerpts.\n* Never repeat similar search queries - make every query unique. If initial results are\n  insufficient, reformulate queries to obtain new and better results.\n\nHow to use:\n- For simple queries, a one-shot call to depth is usually sufficient.\n- For complex multi-hop queries, first try to use breadth to narrow down sources. Then\nuse other search types with include_domains to get more detailed results.`,\n  parameters: z.object({\n    objective: z.string().describe(\n      `Natural-language description of what the web research goal\n is. Specify the broad intent of the search query here. Also include any source or\n freshness guidance here. Limit to 200 characters. This should reflect the end goal so\n that the tool can better understand the intent and return the best results. Do not\n dump long texts.`\n    ),\n    search_type: z\n      .enum(['list', 'general', 'single_page', 'targeted'])\n      .describe(\n        `Can be \"list\", \"general\", \"single_page\" or \"targeted\".\n \"list\" should be used for searching for data broadly, like aggregating data or\n considering multiple sources or doing broad initial research. \"targeted\" should be\n used for searching for data from a specific source set. \"general\" is a catch all case\n if there is no specific use case from list or targeted. \"single_page\" extracts data\n from a single page - extremely targeted. If there is a specific webpage you want the\n data from, use \"single_page\" and mention the URL in the objective.\n Use search_type appropriately.`\n      )\n      .optional()\n      .default('list'),\n    search_queries: z\n      .array(z.string())\n      .optional()\n      .describe(\n        `(optional) List of keyword search queries of 1-6\n words, which may include search operators. The search queries should be related to the\n objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are\n ideal.`\n      ),\n    include_domains: z.array(z.string()).optional()\n      .describe(`(optional) List of valid URL domains to explicitly\n focus on for the search. This will restrict all search results to only include results\n from the provided list. This is useful when you want to only use a specific set of\n sources. example: [\"google.com\", \"wikipedia.org\"]. Maximum 10 entries.`),\n  }),\n\n  execute: async function (\n    { ...args },\n    { abortSignal }: { abortSignal?: AbortSignal }\n  ) {\n    const results = await search(\n      { ...args, ...getSearchParams(args.search_type) },\n      { abortSignal }\n    );\n\n    return {\n      searchParams: args,\n      answer: results,\n    };\n  },\n});\n","/**\n * Extract tool for Parallel Web (AI SDK v4)\n */\n\nimport { tool, type Tool as ToolV4 } from 'ai-v4';\nimport { z } from 'zod';\nimport { parallelClient } from '../../client.js';\n\nexport const extractTool: ToolV4 = tool({\n  description: `Purpose: Fetch and extract relevant content from specific web URLs.\n\nIdeal Use Cases:\n- Extracting content from specific URLs you've already identified\n- Exploring URLs returned by a web search in greater depth`,\n  parameters: z.object({\n    objective: z.string().describe(\n      `Natural-language description of what information you're looking for from the URLs. \n Limit to 200 characters.`\n    ),\n\n    urls: z.array(z.string()).describe(\n      `List of URLs to extract content from. Must be valid\nHTTP/HTTPS URLs. Maximum 10 URLs per request.`\n    ),\n    search_queries: z\n      .array(z.string())\n      .optional()\n      .describe(\n        `(optional) List of keyword search queries of 1-6\n words, which may include search operators. The search queries should be related to the\n objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are\n ideal.`\n      ),\n  }),\n\n  execute: async function (\n    { ...args },\n    { abortSignal }: { abortSignal?: AbortSignal }\n  ) {\n    const results = await parallelClient.beta.extract(\n      { ...args },\n      {\n        signal: abortSignal,\n        headers: { 'parallel-beta': 'search-extract-2025-10-10' },\n      }\n    );\n\n    return {\n      searchParams: args,\n      answer: results,\n    };\n  },\n});\n"]}

package/dist/v4.d.cts

@@ -0,0 +1,15 @@
+import { Tool } from 'ai-v4';
+
+/**
+ * Search tool for Parallel Web (AI SDK v4)
+ */
+
+declare const searchTool: Tool;
+
+/**
+ * Extract tool for Parallel Web (AI SDK v4)
+ */
+
+declare const extractTool: Tool;
+
+export { extractTool, searchTool };

package/dist/v4.d.ts

@@ -0,0 +1,15 @@
+import { Tool } from 'ai-v4';
+
+/**
+ * Search tool for Parallel Web (AI SDK v4)
+ */
+
+declare const searchTool: Tool;
+
+/**
+ * Extract tool for Parallel Web (AI SDK v4)
+ */
+
+declare const extractTool: Tool;
+
+export { extractTool, searchTool };

package/dist/v4.js

@@ -0,0 +1,142 @@
+import { tool } from 'ai-v4';
+import { z } from 'zod';
+import { Parallel } from 'parallel-web';
+
+// src/v4/tools/search.ts
+var _parallelClient = null;
+var parallelClient = new Proxy({}, {
+  get(_target, prop) {
+    if (!_parallelClient) {
+      _parallelClient = new Parallel({
+        apiKey: process.env["PARALLEL_API_KEY"]
+      });
+    }
+    return _parallelClient[prop];
+  }
+});
+
+// src/v4/tools/search.ts
+function getSearchParams(search_type) {
+  switch (search_type) {
+    case "targeted":
+      return { max_results: 5, max_chars_per_result: 16e3 };
+    case "general":
+      return { max_results: 10, max_chars_per_result: 9e3 };
+    case "single_page":
+      return { max_results: 2, max_chars_per_result: 3e4 };
+    case "list":
+    default:
+      return { max_results: 20, max_chars_per_result: 1500 };
+  }
+}
+var search = async (searchArgs, { abortSignal }) => {
+  return await parallelClient.beta.search(
+    {
+      ...searchArgs
+    },
+    {
+      signal: abortSignal
+      // headers: { 'parallel-beta': 'search-extract-2025-10-10' },
+    }
+  );
+};
+var searchTool = tool({
+  description: `Use the web_search_parallel tool to access information from the web. The
+web_search_parallel tool returns ranked, extended web excerpts optimized for LLMs.
+Intelligently scale the number of web_search_parallel tool calls to get more information
+when needed, from a single call for simple factual questions to five or more calls for
+complex research questions.
+
+* Keep queries concise - 1-6 words for best results. Start broad with very short
+  queries and medium context, then add words to narrow results or use high context
+  if needed.
+* Include broader context about what the search is trying to accomplish in the
+  \`objective\` field. This helps the search engine understand the user's intent and
+  provide relevant results and excerpts.
+* Never repeat similar search queries - make every query unique. If initial results are
+  insufficient, reformulate queries to obtain new and better results.
+
+How to use:
+- For simple queries, a one-shot call to depth is usually sufficient.
+- For complex multi-hop queries, first try to use breadth to narrow down sources. Then
+use other search types with include_domains to get more detailed results.`,
+  parameters: z.object({
+    objective: z.string().describe(
+      `Natural-language description of what the web research goal
+ is. Specify the broad intent of the search query here. Also include any source or
+ freshness guidance here. Limit to 200 characters. This should reflect the end goal so
+ that the tool can better understand the intent and return the best results. Do not
+ dump long texts.`
+    ),
+    search_type: z.enum(["list", "general", "single_page", "targeted"]).describe(
+      `Can be "list", "general", "single_page" or "targeted".
+ "list" should be used for searching for data broadly, like aggregating data or
+ considering multiple sources or doing broad initial research. "targeted" should be
+ used for searching for data from a specific source set. "general" is a catch all case
+ if there is no specific use case from list or targeted. "single_page" extracts data
+ from a single page - extremely targeted. If there is a specific webpage you want the
+ data from, use "single_page" and mention the URL in the objective.
+ Use search_type appropriately.`
+    ).optional().default("list"),
+    search_queries: z.array(z.string()).optional().describe(
+      `(optional) List of keyword search queries of 1-6
+ words, which may include search operators. The search queries should be related to the
+ objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are
+ ideal.`
+    ),
+    include_domains: z.array(z.string()).optional().describe(`(optional) List of valid URL domains to explicitly
+ focus on for the search. This will restrict all search results to only include results
+ from the provided list. This is useful when you want to only use a specific set of
+ sources. example: ["google.com", "wikipedia.org"]. Maximum 10 entries.`)
+  }),
+  execute: async function({ ...args }, { abortSignal }) {
+    const results = await search(
+      { ...args, ...getSearchParams(args.search_type) },
+      { abortSignal }
+    );
+    return {
+      searchParams: args,
+      answer: results
+    };
+  }
+});
+var extractTool = tool({
+  description: `Purpose: Fetch and extract relevant content from specific web URLs.
+
+Ideal Use Cases:
+- Extracting content from specific URLs you've already identified
+- Exploring URLs returned by a web search in greater depth`,
+  parameters: z.object({
+    objective: z.string().describe(
+      `Natural-language description of what information you're looking for from the URLs. 
+ Limit to 200 characters.`
+    ),
+    urls: z.array(z.string()).describe(
+      `List of URLs to extract content from. Must be valid
+HTTP/HTTPS URLs. Maximum 10 URLs per request.`
+    ),
+    search_queries: z.array(z.string()).optional().describe(
+      `(optional) List of keyword search queries of 1-6
+ words, which may include search operators. The search queries should be related to the
+ objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are
+ ideal.`
+    )
+  }),
+  execute: async function({ ...args }, { abortSignal }) {
+    const results = await parallelClient.beta.extract(
+      { ...args },
+      {
+        signal: abortSignal,
+        headers: { "parallel-beta": "search-extract-2025-10-10" }
+      }
+    );
+    return {
+      searchParams: args,
+      answer: results
+    };
+  }
+});
+
+export { extractTool, searchTool };
+//# sourceMappingURL=v4.js.map
+//# sourceMappingURL=v4.js.map

package/dist/v4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/v4/tools/search.ts","../src/v4/tools/extract.ts"],"names":["tool","z"],"mappings":"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","file":"v4.js","sourcesContent":["/**\n * Shared Parallel Web client instance\n */\n\nimport { Parallel } from 'parallel-web';\n\nlet _parallelClient: Parallel | null = null;\n\nexport const parallelClient = new Proxy({} as Parallel, {\n  get(_target, prop) {\n    if (!_parallelClient) {\n      _parallelClient = new Parallel({\n        apiKey: process.env['PARALLEL_API_KEY'],\n      });\n    }\n    return (_parallelClient as any)[prop];\n  },\n});\n","/**\n * Search tool for Parallel Web (AI SDK v4)\n */\n\nimport { tool, type Tool as ToolV4 } from 'ai-v4';\nimport { z } from 'zod';\nimport { BetaSearchParams } from 'parallel-web/resources/beta/beta.mjs';\nimport { parallelClient } from '../../client.js';\n\nfunction getSearchParams(\n  search_type: 'list' | 'targeted' | 'general' | 'single_page'\n): Pick<BetaSearchParams, 'max_results' | 'max_chars_per_result'> {\n  switch (search_type) {\n    case 'targeted':\n      return { max_results: 5, max_chars_per_result: 16000 };\n    case 'general':\n      return { max_results: 10, max_chars_per_result: 9000 };\n    case 'single_page':\n      return { max_results: 2, max_chars_per_result: 30000 };\n    case 'list':\n    default:\n      return { max_results: 20, max_chars_per_result: 1500 };\n  }\n}\n\nconst search = async (\n  searchArgs: BetaSearchParams,\n  { abortSignal }: { abortSignal: AbortSignal | undefined }\n) => {\n  return await parallelClient.beta.search(\n    {\n      ...searchArgs,\n    },\n    {\n      signal: abortSignal,\n      // headers: { 'parallel-beta': 'search-extract-2025-10-10' },\n    }\n  );\n};\n\nexport const searchTool: ToolV4 = tool({\n  description: `Use the web_search_parallel tool to access information from the web. The\nweb_search_parallel tool returns ranked, extended web excerpts optimized for LLMs.\nIntelligently scale the number of web_search_parallel tool calls to get more information\nwhen needed, from a single call for simple factual questions to five or more calls for\ncomplex research questions.\n\n* Keep queries concise - 1-6 words for best results. Start broad with very short\n  queries and medium context, then add words to narrow results or use high context\n  if needed.\n* Include broader context about what the search is trying to accomplish in the\n  \\`objective\\` field. This helps the search engine understand the user's intent and\n  provide relevant results and excerpts.\n* Never repeat similar search queries - make every query unique. If initial results are\n  insufficient, reformulate queries to obtain new and better results.\n\nHow to use:\n- For simple queries, a one-shot call to depth is usually sufficient.\n- For complex multi-hop queries, first try to use breadth to narrow down sources. Then\nuse other search types with include_domains to get more detailed results.`,\n  parameters: z.object({\n    objective: z.string().describe(\n      `Natural-language description of what the web research goal\n is. Specify the broad intent of the search query here. Also include any source or\n freshness guidance here. Limit to 200 characters. This should reflect the end goal so\n that the tool can better understand the intent and return the best results. Do not\n dump long texts.`\n    ),\n    search_type: z\n      .enum(['list', 'general', 'single_page', 'targeted'])\n      .describe(\n        `Can be \"list\", \"general\", \"single_page\" or \"targeted\".\n \"list\" should be used for searching for data broadly, like aggregating data or\n considering multiple sources or doing broad initial research. \"targeted\" should be\n used for searching for data from a specific source set. \"general\" is a catch all case\n if there is no specific use case from list or targeted. \"single_page\" extracts data\n from a single page - extremely targeted. If there is a specific webpage you want the\n data from, use \"single_page\" and mention the URL in the objective.\n Use search_type appropriately.`\n      )\n      .optional()\n      .default('list'),\n    search_queries: z\n      .array(z.string())\n      .optional()\n      .describe(\n        `(optional) List of keyword search queries of 1-6\n words, which may include search operators. The search queries should be related to the\n objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are\n ideal.`\n      ),\n    include_domains: z.array(z.string()).optional()\n      .describe(`(optional) List of valid URL domains to explicitly\n focus on for the search. This will restrict all search results to only include results\n from the provided list. This is useful when you want to only use a specific set of\n sources. example: [\"google.com\", \"wikipedia.org\"]. Maximum 10 entries.`),\n  }),\n\n  execute: async function (\n    { ...args },\n    { abortSignal }: { abortSignal?: AbortSignal }\n  ) {\n    const results = await search(\n      { ...args, ...getSearchParams(args.search_type) },\n      { abortSignal }\n    );\n\n    return {\n      searchParams: args,\n      answer: results,\n    };\n  },\n});\n","/**\n * Extract tool for Parallel Web (AI SDK v4)\n */\n\nimport { tool, type Tool as ToolV4 } from 'ai-v4';\nimport { z } from 'zod';\nimport { parallelClient } from '../../client.js';\n\nexport const extractTool: ToolV4 = tool({\n  description: `Purpose: Fetch and extract relevant content from specific web URLs.\n\nIdeal Use Cases:\n- Extracting content from specific URLs you've already identified\n- Exploring URLs returned by a web search in greater depth`,\n  parameters: z.object({\n    objective: z.string().describe(\n      `Natural-language description of what information you're looking for from the URLs. \n Limit to 200 characters.`\n    ),\n\n    urls: z.array(z.string()).describe(\n      `List of URLs to extract content from. Must be valid\nHTTP/HTTPS URLs. Maximum 10 URLs per request.`\n    ),\n    search_queries: z\n      .array(z.string())\n      .optional()\n      .describe(\n        `(optional) List of keyword search queries of 1-6\n words, which may include search operators. The search queries should be related to the\n objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are\n ideal.`\n      ),\n  }),\n\n  execute: async function (\n    { ...args },\n    { abortSignal }: { abortSignal?: AbortSignal }\n  ) {\n    const results = await parallelClient.beta.extract(\n      { ...args },\n      {\n        signal: abortSignal,\n        headers: { 'parallel-beta': 'search-extract-2025-10-10' },\n      }\n    );\n\n    return {\n      searchParams: args,\n      answer: results,\n    };\n  },\n});\n"]}

package/dist/v5.cjs

@@ -0,0 +1,145 @@
+'use strict';
+
+var aiV5 = require('ai-v5');
+var zod = require('zod');
+var parallelWeb = require('parallel-web');
+
+// src/v5/tools/search.ts
+var _parallelClient = null;
+var parallelClient = new Proxy({}, {
+  get(_target, prop) {
+    if (!_parallelClient) {
+      _parallelClient = new parallelWeb.Parallel({
+        apiKey: process.env["PARALLEL_API_KEY"]
+      });
+    }
+    return _parallelClient[prop];
+  }
+});
+
+// src/v5/tools/search.ts
+function getSearchParams(search_type) {
+  switch (search_type) {
+    case "targeted":
+      return { max_results: 5, max_chars_per_result: 16e3 };
+    case "general":
+      return { max_results: 10, max_chars_per_result: 9e3 };
+    case "single_page":
+      return { max_results: 2, max_chars_per_result: 3e4 };
+    case "list":
+    default:
+      return { max_results: 20, max_chars_per_result: 1500 };
+  }
+}
+var search = async (searchArgs, { abortSignal }) => {
+  return await parallelClient.beta.search(
+    {
+      ...searchArgs
+    },
+    {
+      signal: abortSignal
+      // headers: { 'parallel-beta': 'search-extract-2025-10-10' },
+    }
+  );
+};
+var searchTool = aiV5.tool({
+  description: `Use the web_search_parallel tool to access information from the web. The
+web_search_parallel tool returns ranked, extended web excerpts optimized for LLMs.
+Intelligently scale the number of web_search_parallel tool calls to get more information
+when needed, from a single call for simple factual questions to five or more calls for
+complex research questions.
+
+* Keep queries concise - 1-6 words for best results. Start broad with very short
+  queries and medium context, then add words to narrow results or use high context
+  if needed.
+* Include broader context about what the search is trying to accomplish in the
+  \`objective\` field. This helps the search engine understand the user's intent and
+  provide relevant results and excerpts.
+* Never repeat similar search queries - make every query unique. If initial results are
+  insufficient, reformulate queries to obtain new and better results.
+
+How to use:
+- For simple queries, a one-shot call to depth is usually sufficient.
+- For complex multi-hop queries, first try to use breadth to narrow down sources. Then
+use other search types with include_domains to get more detailed results.`,
+  inputSchema: zod.z.object({
+    objective: zod.z.string().describe(
+      `Natural-language description of what the web research goal
+ is. Specify the broad intent of the search query here. Also include any source or
+ freshness guidance here. Limit to 200 characters. This should reflect the end goal so
+ that the tool can better understand the intent and return the best results. Do not
+ dump long texts.`
+    ),
+    search_type: zod.z.enum(["list", "general", "single_page", "targeted"]).describe(
+      `Can be "list", "general", "single_page" or "targeted".
+ "list" should be used for searching for data broadly, like aggregating data or
+ considering multiple sources or doing broad initial research. "targeted" should be
+ used for searching for data from a specific source set. "general" is a catch all case
+ if there is no specific use case from list or targeted. "single_page" extracts data
+ from a single page - extremely targeted. If there is a specific webpage you want the
+ data from, use "single_page" and mention the URL in the objective.
+ Use search_type appropriately.`
+    ).optional().default("list"),
+    search_queries: zod.z.array(zod.z.string()).optional().describe(
+      `(optional) List of keyword search queries of 1-6
+ words, which may include search operators. The search queries should be related to the
+ objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are
+ ideal.`
+    ),
+    include_domains: zod.z.array(zod.z.string()).optional().describe(`(optional) List of valid URL domains to explicitly
+ focus on for the search. This will restrict all search results to only include results
+ from the provided list. This is useful when you want to only use a specific set of
+ sources. example: ["google.com", "wikipedia.org"]. Maximum 10 entries.`)
+  }),
+  execute: async function({ ...args }, { abortSignal }) {
+    const results = await search(
+      { ...args, ...getSearchParams(args.search_type) },
+      { abortSignal }
+    );
+    return {
+      searchParams: args,
+      answer: results
+    };
+  }
+});
+var extractTool = aiV5.tool({
+  description: `Purpose: Fetch and extract relevant content from specific web URLs.
+
+Ideal Use Cases:
+- Extracting content from specific URLs you've already identified
+- Exploring URLs returned by a web search in greater depth`,
+  inputSchema: zod.z.object({
+    objective: zod.z.string().describe(
+      `Natural-language description of what information you're looking for from the URLs. 
+ Limit to 200 characters.`
+    ),
+    urls: zod.z.array(zod.z.string()).describe(
+      `List of URLs to extract content from. Must be valid
+HTTP/HTTPS URLs. Maximum 10 URLs per request.`
+    ),
+    search_queries: zod.z.array(zod.z.string()).optional().describe(
+      `(optional) List of keyword search queries of 1-6
+ words, which may include search operators. The search queries should be related to the
+ objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are
+ ideal.`
+    )
+  }),
+  execute: async function({ ...args }, { abortSignal }) {
+    const results = await parallelClient.beta.extract(
+      { ...args },
+      {
+        signal: abortSignal,
+        headers: { "parallel-beta": "search-extract-2025-10-10" }
+      }
+    );
+    return {
+      searchParams: args,
+      answer: results
+    };
+  }
+});
+
+exports.extractTool = extractTool;
+exports.searchTool = searchTool;
+//# sourceMappingURL=v5.cjs.map
+//# sourceMappingURL=v5.cjs.map

package/dist/v5.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/v5/tools/search.ts","../src/v5/tools/extract.ts"],"names":["Parallel","tool","z"],"mappings":"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","file":"v5.cjs","sourcesContent":["/**\n * Shared Parallel Web client instance\n */\n\nimport { Parallel } from 'parallel-web';\n\nlet _parallelClient: Parallel | null = null;\n\nexport const parallelClient = new Proxy({} as Parallel, {\n  get(_target, prop) {\n    if (!_parallelClient) {\n      _parallelClient = new Parallel({\n        apiKey: process.env['PARALLEL_API_KEY'],\n      });\n    }\n    return (_parallelClient as any)[prop];\n  },\n});\n","/**\n * Search tool for Parallel Web (AI SDK v5)\n */\n\nimport { tool, type Tool as ToolV5 } from 'ai-v5';\nimport { z } from 'zod';\nimport { BetaSearchParams } from 'parallel-web/resources/beta/beta.mjs';\nimport { parallelClient } from '../../client.js';\n\nfunction getSearchParams(\n  search_type: 'list' | 'targeted' | 'general' | 'single_page'\n): Pick<BetaSearchParams, 'max_results' | 'max_chars_per_result'> {\n  switch (search_type) {\n    case 'targeted':\n      return { max_results: 5, max_chars_per_result: 16000 };\n    case 'general':\n      return { max_results: 10, max_chars_per_result: 9000 };\n    case 'single_page':\n      return { max_results: 2, max_chars_per_result: 30000 };\n    case 'list':\n    default:\n      return { max_results: 20, max_chars_per_result: 1500 };\n  }\n}\n\nconst search = async (\n  searchArgs: BetaSearchParams,\n  { abortSignal }: { abortSignal: AbortSignal | undefined }\n) => {\n  return await parallelClient.beta.search(\n    {\n      ...searchArgs,\n    },\n    {\n      signal: abortSignal,\n      // headers: { 'parallel-beta': 'search-extract-2025-10-10' },\n    }\n  );\n};\n\nexport const searchTool: ToolV5 = tool({\n  description: `Use the web_search_parallel tool to access information from the web. The\nweb_search_parallel tool returns ranked, extended web excerpts optimized for LLMs.\nIntelligently scale the number of web_search_parallel tool calls to get more information\nwhen needed, from a single call for simple factual questions to five or more calls for\ncomplex research questions.\n\n* Keep queries concise - 1-6 words for best results. Start broad with very short\n  queries and medium context, then add words to narrow results or use high context\n  if needed.\n* Include broader context about what the search is trying to accomplish in the\n  \\`objective\\` field. This helps the search engine understand the user's intent and\n  provide relevant results and excerpts.\n* Never repeat similar search queries - make every query unique. If initial results are\n  insufficient, reformulate queries to obtain new and better results.\n\nHow to use:\n- For simple queries, a one-shot call to depth is usually sufficient.\n- For complex multi-hop queries, first try to use breadth to narrow down sources. Then\nuse other search types with include_domains to get more detailed results.`,\n  inputSchema: z.object({\n    objective: z.string().describe(\n      `Natural-language description of what the web research goal\n is. Specify the broad intent of the search query here. Also include any source or\n freshness guidance here. Limit to 200 characters. This should reflect the end goal so\n that the tool can better understand the intent and return the best results. Do not\n dump long texts.`\n    ),\n    search_type: z\n      .enum(['list', 'general', 'single_page', 'targeted'])\n      .describe(\n        `Can be \"list\", \"general\", \"single_page\" or \"targeted\".\n \"list\" should be used for searching for data broadly, like aggregating data or\n considering multiple sources or doing broad initial research. \"targeted\" should be\n used for searching for data from a specific source set. \"general\" is a catch all case\n if there is no specific use case from list or targeted. \"single_page\" extracts data\n from a single page - extremely targeted. If there is a specific webpage you want the\n data from, use \"single_page\" and mention the URL in the objective.\n Use search_type appropriately.`\n      )\n      .optional()\n      .default('list'),\n    search_queries: z\n      .array(z.string())\n      .optional()\n      .describe(\n        `(optional) List of keyword search queries of 1-6\n words, which may include search operators. The search queries should be related to the\n objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are\n ideal.`\n      ),\n    include_domains: z.array(z.string()).optional()\n      .describe(`(optional) List of valid URL domains to explicitly\n focus on for the search. This will restrict all search results to only include results\n from the provided list. This is useful when you want to only use a specific set of\n sources. example: [\"google.com\", \"wikipedia.org\"]. Maximum 10 entries.`),\n  }),\n\n  execute: async function ({ ...args }, { abortSignal }) {\n    const results = await search(\n      { ...args, ...getSearchParams(args.search_type) },\n      { abortSignal }\n    );\n\n    return {\n      searchParams: args,\n      answer: results,\n    };\n  },\n});\n","/**\n * Extract tool for Parallel Web (AI SDK v5)\n */\n\nimport { tool, type Tool as ToolV5 } from 'ai-v5';\nimport { z } from 'zod';\nimport { parallelClient } from '../../client.js';\n\nexport const extractTool: ToolV5 = tool({\n  description: `Purpose: Fetch and extract relevant content from specific web URLs.\n\nIdeal Use Cases:\n- Extracting content from specific URLs you've already identified\n- Exploring URLs returned by a web search in greater depth`,\n  inputSchema: z.object({\n    objective: z.string().describe(\n      `Natural-language description of what information you're looking for from the URLs. \n Limit to 200 characters.`\n    ),\n\n    urls: z.array(z.string()).describe(\n      `List of URLs to extract content from. Must be valid\nHTTP/HTTPS URLs. Maximum 10 URLs per request.`\n    ),\n    search_queries: z\n      .array(z.string())\n      .optional()\n      .describe(\n        `(optional) List of keyword search queries of 1-6\n words, which may include search operators. The search queries should be related to the\n objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are\n ideal.`\n      ),\n  }),\n\n  execute: async function ({ ...args }, { abortSignal }) {\n    const results = await parallelClient.beta.extract(\n      { ...args },\n      {\n        signal: abortSignal,\n        headers: { 'parallel-beta': 'search-extract-2025-10-10' },\n      }\n    );\n\n    return {\n      searchParams: args,\n      answer: results,\n    };\n  },\n});\n"]}

package/dist/v5.d.cts

@@ -0,0 +1,2 @@
+export { extractTool, searchTool } from './index.cjs';
+import 'ai-v5';

package/dist/v5.d.ts

@@ -0,0 +1,2 @@
+export { extractTool, searchTool } from './index.js';
+import 'ai-v5';

package/dist/v5.js

@@ -0,0 +1,142 @@
+import { tool } from 'ai-v5';
+import { z } from 'zod';
+import { Parallel } from 'parallel-web';
+
+// src/v5/tools/search.ts
+var _parallelClient = null;
+var parallelClient = new Proxy({}, {
+  get(_target, prop) {
+    if (!_parallelClient) {
+      _parallelClient = new Parallel({
+        apiKey: process.env["PARALLEL_API_KEY"]
+      });
+    }
+    return _parallelClient[prop];
+  }
+});
+
+// src/v5/tools/search.ts
+function getSearchParams(search_type) {
+  switch (search_type) {
+    case "targeted":
+      return { max_results: 5, max_chars_per_result: 16e3 };
+    case "general":
+      return { max_results: 10, max_chars_per_result: 9e3 };
+    case "single_page":
+      return { max_results: 2, max_chars_per_result: 3e4 };
+    case "list":
+    default:
+      return { max_results: 20, max_chars_per_result: 1500 };
+  }
+}
+var search = async (searchArgs, { abortSignal }) => {
+  return await parallelClient.beta.search(
+    {
+      ...searchArgs
+    },
+    {
+      signal: abortSignal
+      // headers: { 'parallel-beta': 'search-extract-2025-10-10' },
+    }
+  );
+};
+var searchTool = tool({
+  description: `Use the web_search_parallel tool to access information from the web. The
+web_search_parallel tool returns ranked, extended web excerpts optimized for LLMs.
+Intelligently scale the number of web_search_parallel tool calls to get more information
+when needed, from a single call for simple factual questions to five or more calls for
+complex research questions.
+
+* Keep queries concise - 1-6 words for best results. Start broad with very short
+  queries and medium context, then add words to narrow results or use high context
+  if needed.
+* Include broader context about what the search is trying to accomplish in the
+  \`objective\` field. This helps the search engine understand the user's intent and
+  provide relevant results and excerpts.
+* Never repeat similar search queries - make every query unique. If initial results are
+  insufficient, reformulate queries to obtain new and better results.
+
+How to use:
+- For simple queries, a one-shot call to depth is usually sufficient.
+- For complex multi-hop queries, first try to use breadth to narrow down sources. Then
+use other search types with include_domains to get more detailed results.`,
+  inputSchema: z.object({
+    objective: z.string().describe(
+      `Natural-language description of what the web research goal
+ is. Specify the broad intent of the search query here. Also include any source or
+ freshness guidance here. Limit to 200 characters. This should reflect the end goal so
+ that the tool can better understand the intent and return the best results. Do not
+ dump long texts.`
+    ),
+    search_type: z.enum(["list", "general", "single_page", "targeted"]).describe(
+      `Can be "list", "general", "single_page" or "targeted".
+ "list" should be used for searching for data broadly, like aggregating data or
+ considering multiple sources or doing broad initial research. "targeted" should be
+ used for searching for data from a specific source set. "general" is a catch all case
+ if there is no specific use case from list or targeted. "single_page" extracts data
+ from a single page - extremely targeted. If there is a specific webpage you want the
+ data from, use "single_page" and mention the URL in the objective.
+ Use search_type appropriately.`
+    ).optional().default("list"),
+    search_queries: z.array(z.string()).optional().describe(
+      `(optional) List of keyword search queries of 1-6
+ words, which may include search operators. The search queries should be related to the
+ objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are
+ ideal.`
+    ),
+    include_domains: z.array(z.string()).optional().describe(`(optional) List of valid URL domains to explicitly
+ focus on for the search. This will restrict all search results to only include results
+ from the provided list. This is useful when you want to only use a specific set of
+ sources. example: ["google.com", "wikipedia.org"]. Maximum 10 entries.`)
+  }),
+  execute: async function({ ...args }, { abortSignal }) {
+    const results = await search(
+      { ...args, ...getSearchParams(args.search_type) },
+      { abortSignal }
+    );
+    return {
+      searchParams: args,
+      answer: results
+    };
+  }
+});
+var extractTool = tool({
+  description: `Purpose: Fetch and extract relevant content from specific web URLs.
+
+Ideal Use Cases:
+- Extracting content from specific URLs you've already identified
+- Exploring URLs returned by a web search in greater depth`,
+  inputSchema: z.object({
+    objective: z.string().describe(
+      `Natural-language description of what information you're looking for from the URLs. 
+ Limit to 200 characters.`
+    ),
+    urls: z.array(z.string()).describe(
+      `List of URLs to extract content from. Must be valid
+HTTP/HTTPS URLs. Maximum 10 URLs per request.`
+    ),
+    search_queries: z.array(z.string()).optional().describe(
+      `(optional) List of keyword search queries of 1-6
+ words, which may include search operators. The search queries should be related to the
+ objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are
+ ideal.`
+    )
+  }),
+  execute: async function({ ...args }, { abortSignal }) {
+    const results = await parallelClient.beta.extract(
+      { ...args },
+      {
+        signal: abortSignal,
+        headers: { "parallel-beta": "search-extract-2025-10-10" }
+      }
+    );
+    return {
+      searchParams: args,
+      answer: results
+    };
+  }
+});
+
+export { extractTool, searchTool };
+//# sourceMappingURL=v5.js.map
+//# sourceMappingURL=v5.js.map

package/dist/v5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/v5/tools/search.ts","../src/v5/tools/extract.ts"],"names":["tool","z"],"mappings":"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","file":"v5.js","sourcesContent":["/**\n * Shared Parallel Web client instance\n */\n\nimport { Parallel } from 'parallel-web';\n\nlet _parallelClient: Parallel | null = null;\n\nexport const parallelClient = new Proxy({} as Parallel, {\n  get(_target, prop) {\n    if (!_parallelClient) {\n      _parallelClient = new Parallel({\n        apiKey: process.env['PARALLEL_API_KEY'],\n      });\n    }\n    return (_parallelClient as any)[prop];\n  },\n});\n","/**\n * Search tool for Parallel Web (AI SDK v5)\n */\n\nimport { tool, type Tool as ToolV5 } from 'ai-v5';\nimport { z } from 'zod';\nimport { BetaSearchParams } from 'parallel-web/resources/beta/beta.mjs';\nimport { parallelClient } from '../../client.js';\n\nfunction getSearchParams(\n  search_type: 'list' | 'targeted' | 'general' | 'single_page'\n): Pick<BetaSearchParams, 'max_results' | 'max_chars_per_result'> {\n  switch (search_type) {\n    case 'targeted':\n      return { max_results: 5, max_chars_per_result: 16000 };\n    case 'general':\n      return { max_results: 10, max_chars_per_result: 9000 };\n    case 'single_page':\n      return { max_results: 2, max_chars_per_result: 30000 };\n    case 'list':\n    default:\n      return { max_results: 20, max_chars_per_result: 1500 };\n  }\n}\n\nconst search = async (\n  searchArgs: BetaSearchParams,\n  { abortSignal }: { abortSignal: AbortSignal | undefined }\n) => {\n  return await parallelClient.beta.search(\n    {\n      ...searchArgs,\n    },\n    {\n      signal: abortSignal,\n      // headers: { 'parallel-beta': 'search-extract-2025-10-10' },\n    }\n  );\n};\n\nexport const searchTool: ToolV5 = tool({\n  description: `Use the web_search_parallel tool to access information from the web. The\nweb_search_parallel tool returns ranked, extended web excerpts optimized for LLMs.\nIntelligently scale the number of web_search_parallel tool calls to get more information\nwhen needed, from a single call for simple factual questions to five or more calls for\ncomplex research questions.\n\n* Keep queries concise - 1-6 words for best results. Start broad with very short\n  queries and medium context, then add words to narrow results or use high context\n  if needed.\n* Include broader context about what the search is trying to accomplish in the\n  \\`objective\\` field. This helps the search engine understand the user's intent and\n  provide relevant results and excerpts.\n* Never repeat similar search queries - make every query unique. If initial results are\n  insufficient, reformulate queries to obtain new and better results.\n\nHow to use:\n- For simple queries, a one-shot call to depth is usually sufficient.\n- For complex multi-hop queries, first try to use breadth to narrow down sources. Then\nuse other search types with include_domains to get more detailed results.`,\n  inputSchema: z.object({\n    objective: z.string().describe(\n      `Natural-language description of what the web research goal\n is. Specify the broad intent of the search query here. Also include any source or\n freshness guidance here. Limit to 200 characters. This should reflect the end goal so\n that the tool can better understand the intent and return the best results. Do not\n dump long texts.`\n    ),\n    search_type: z\n      .enum(['list', 'general', 'single_page', 'targeted'])\n      .describe(\n        `Can be \"list\", \"general\", \"single_page\" or \"targeted\".\n \"list\" should be used for searching for data broadly, like aggregating data or\n considering multiple sources or doing broad initial research. \"targeted\" should be\n used for searching for data from a specific source set. \"general\" is a catch all case\n if there is no specific use case from list or targeted. \"single_page\" extracts data\n from a single page - extremely targeted. If there is a specific webpage you want the\n data from, use \"single_page\" and mention the URL in the objective.\n Use search_type appropriately.`\n      )\n      .optional()\n      .default('list'),\n    search_queries: z\n      .array(z.string())\n      .optional()\n      .describe(\n        `(optional) List of keyword search queries of 1-6\n words, which may include search operators. The search queries should be related to the\n objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are\n ideal.`\n      ),\n    include_domains: z.array(z.string()).optional()\n      .describe(`(optional) List of valid URL domains to explicitly\n focus on for the search. This will restrict all search results to only include results\n from the provided list. This is useful when you want to only use a specific set of\n sources. example: [\"google.com\", \"wikipedia.org\"]. Maximum 10 entries.`),\n  }),\n\n  execute: async function ({ ...args }, { abortSignal }) {\n    const results = await search(\n      { ...args, ...getSearchParams(args.search_type) },\n      { abortSignal }\n    );\n\n    return {\n      searchParams: args,\n      answer: results,\n    };\n  },\n});\n","/**\n * Extract tool for Parallel Web (AI SDK v5)\n */\n\nimport { tool, type Tool as ToolV5 } from 'ai-v5';\nimport { z } from 'zod';\nimport { parallelClient } from '../../client.js';\n\nexport const extractTool: ToolV5 = tool({\n  description: `Purpose: Fetch and extract relevant content from specific web URLs.\n\nIdeal Use Cases:\n- Extracting content from specific URLs you've already identified\n- Exploring URLs returned by a web search in greater depth`,\n  inputSchema: z.object({\n    objective: z.string().describe(\n      `Natural-language description of what information you're looking for from the URLs. \n Limit to 200 characters.`\n    ),\n\n    urls: z.array(z.string()).describe(\n      `List of URLs to extract content from. Must be valid\nHTTP/HTTPS URLs. Maximum 10 URLs per request.`\n    ),\n    search_queries: z\n      .array(z.string())\n      .optional()\n      .describe(\n        `(optional) List of keyword search queries of 1-6\n words, which may include search operators. The search queries should be related to the\n objective. Limited to 5 entries of 200 characters each. Usually 1-3 queries are\n ideal.`\n      ),\n  }),\n\n  execute: async function ({ ...args }, { abortSignal }) {\n    const results = await parallelClient.beta.extract(\n      { ...args },\n      {\n        signal: abortSignal,\n        headers: { 'parallel-beta': 'search-extract-2025-10-10' },\n      }\n    );\n\n    return {\n      searchParams: args,\n      answer: results,\n    };\n  },\n});\n"]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@parallel-web/ai-sdk-tools",
+  "version": "0.1.0",
+  "description": "AI SDK tools for Parallel Web",
+  "author": "Parallel Web",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./v4": {
+      "types": "./dist/v4.d.ts",
+      "import": "./dist/v4.js",
+      "require": "./dist/v4.cjs"
+    },
+    "./v5": {
+      "types": "./dist/v5.d.ts",
+      "import": "./dist/v5.js",
+      "require": "./dist/v5.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "ai",
+    "sdk",
+    "tools",
+    "parallel"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/parallel-web/npm-packages",
+    "directory": "packages/ai-sdk-tools"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ai-v4": "npm:ai@^4.0.0",
+    "ai-v5": "npm:ai@^5.0.0",
+    "parallel-web": "^0.2.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0"
+  }
+}