@ai-sdk/gateway 3.0.219 → 3.0.220

package/dist/index.js

@@ -2118,6 +2118,14 @@ var exaSearch = (config = {}) => exaSearchToolFactory(config);
 // src/tool/parallel-search.ts
 var import_provider_utils19 = require("@ai-sdk/provider-utils");
 var import_zod4 = require("zod");
+var parallelSearchModes = [
+  "turbo",
+  "fast",
+  "basic",
+  "advanced",
+  "one-shot",
+  "agentic"
+];
 var parallelSearchInputSchema = (0, import_provider_utils19.lazySchema)(
   () => (0, import_provider_utils19.zodSchema)(
     import_zod4.z.object({
@@ -2125,64 +2133,85 @@ var parallelSearchInputSchema = (0, import_provider_utils19.lazySchema)(
         "Natural-language description of the web research goal, including source or freshness guidance and broader context from the task. Maximum 5000 characters."
       ),
       search_queries: import_zod4.z.array(import_zod4.z.string()).optional().describe(
-        "Optional search queries to supplement the objective. Maximum 200 characters per query."
+        "Provide 2-3 concise keyword queries, 3-6 words each (max 5, 200 chars each). Strongly recommended; the search runs on these queries."
       ),
-      mode: import_zod4.z.enum(["one-shot", "agentic"]).optional().describe(
-        'Mode preset: "one-shot" for comprehensive results with longer excerpts (default), "agentic" for concise, token-efficient results for multi-step workflows.'
+      mode: import_zod4.z.enum(parallelSearchModes).optional().describe(
+        'Search mode: "turbo" and "fast" return quickly with shorter excerpts, "basic" is balanced (default), "advanced" is the most thorough. "turbo" supports English and Japanese only. "one-shot" and "agentic" are deprecated aliases of "basic" and "advanced".'
       ),
       max_results: import_zod4.z.number().optional().describe(
         "Maximum number of results to return (1-20). Defaults to 10 if not specified."
       ),
       source_policy: import_zod4.z.object({
         include_domains: import_zod4.z.array(import_zod4.z.string()).optional().describe(
-          "Limit results to these domains. Use plain domain names only \u2014 e.g. example.com or sub.example.gov, or a bare extension like .edu. Do not include a scheme, path, or port (e.g. not https://example.com/page)."
+          "Domains or domain/path prefixes to restrict results to, without scheme or port. Example: ['wikipedia.org', 'docs.python.org/3']."
         ),
         exclude_domains: import_zod4.z.array(import_zod4.z.string()).optional().describe(
-          "Exclude results from these domains. Use plain domain names only \u2014 e.g. example.com or sub.example.gov, or a bare extension like .edu. Do not include a scheme, path, or port (e.g. not https://example.com/page)."
+          "Domains or domain/path prefixes to exclude, without scheme or port. Example: ['reddit.com']."
         ),
         after_date: import_zod4.z.string().optional().describe(
-          "Only include results published after this date. Use an ISO 8601 calendar date formatted YYYY-MM-DD (e.g. 2025-01-01); do not include a time."
+          "Only include results published on or after this date. Use an ISO 8601 calendar date formatted YYYY-MM-DD (e.g. 2025-01-01); do not include a time."
         )
       }).optional().describe(
         "Source policy for controlling which domains to include/exclude and freshness."
       ),
       excerpts: import_zod4.z.object({
         max_chars_per_result: import_zod4.z.number().optional().describe("Maximum characters per result."),
-        max_chars_total: import_zod4.z.number().optional().describe("Maximum total characters across all results.")
+        max_chars_total: import_zod4.z.number().optional().describe("Deprecated: use the top-level max_chars_total.")
       }).optional().describe("Excerpt configuration for controlling result length."),
+      max_chars_total: import_zod4.z.number().optional().describe("Maximum total characters across all result excerpts."),
       fetch_policy: import_zod4.z.object({
         max_age_seconds: import_zod4.z.number().optional().describe(
-          "Maximum age in seconds for cached content. Set to 0 to always fetch fresh content."
+          "Maximum age of cached content in seconds before a live fetch, minimum 600."
+        ),
+        timeout_seconds: import_zod4.z.number().optional().describe(
+          "Timeout in seconds for a live fetch when content is not cached. Capped by the gateway tool timeout."
+        ),
+        disable_cache_fallback: import_zod4.z.boolean().optional().describe(
+          "Return an error instead of older cached content when a live fetch fails."
         )
-      }).optional().describe("Fetch policy for controlling content freshness.")
+      }).optional().describe("Fetch policy for controlling content freshness."),
+      location: import_zod4.z.string().optional().describe(
+        'ISO 3166-1 alpha-2 country code to localize results, e.g. "us".'
+      )
     })
   )
 );
 var parallelSearchOutputSchema = (0, import_provider_utils19.lazySchema)(
   () => (0, import_provider_utils19.zodSchema)(
     import_zod4.z.union([
-      // Success response
+      // Success response (Parallel's response, passed through by the gateway)
       import_zod4.z.object({
-        searchId: import_zod4.z.string(),
+        search_id: import_zod4.z.string(),
         results: import_zod4.z.array(
           import_zod4.z.object({
             url: import_zod4.z.string(),
-            title: import_zod4.z.string(),
-            excerpt: import_zod4.z.string(),
-            publishDate: import_zod4.z.string().nullable().optional(),
-            relevanceScore: import_zod4.z.number().optional()
+            title: import_zod4.z.string().nullable().optional(),
+            publish_date: import_zod4.z.string().nullable().optional(),
+            excerpts: import_zod4.z.array(import_zod4.z.string())
           })
-        )
+        ),
+        warnings: import_zod4.z.array(
+          import_zod4.z.object({
+            type: import_zod4.z.string(),
+            message: import_zod4.z.string(),
+            detail: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()).nullable().optional()
+          })
+        ).nullable().optional(),
+        usage: import_zod4.z.array(import_zod4.z.object({ name: import_zod4.z.string(), count: import_zod4.z.number().optional() })).nullable().optional(),
+        session_id: import_zod4.z.string().optional()
       }),
       // Error response
       import_zod4.z.object({
         error: import_zod4.z.enum([
           "api_error",
+          "configuration_error",
+          "execution_error",
+          "gateway_rate_limit",
+          "invalid_input",
           "rate_limit",
           "timeout",
-          "invalid_input",
-          "configuration_error",
-          "unknown"
+          "unknown",
+          "unknown_tool"
         ]),
         statusCode: import_zod4.z.number().optional(),
         message: import_zod4.z.string()
@@ -2551,7 +2580,7 @@ async function getVercelRequestId() {
 }
 
 // src/version.ts
-var VERSION = true ? "3.0.219" : "0.0.0-test";
+var VERSION = true ? "3.0.220" : "0.0.0-test";
 
 // src/gateway-provider.ts
 var AI_GATEWAY_PROTOCOL_VERSION = "0.0.1";