@ai-sdk/gateway 3.0.219 → 3.0.221

package/dist/index.mjs

@@ -2200,6 +2200,14 @@ import {
   zodSchema as zodSchema17
 } from "@ai-sdk/provider-utils";
 import { z as z18 } from "zod";
+var parallelSearchModes = [
+  "turbo",
+  "fast",
+  "basic",
+  "advanced",
+  "one-shot",
+  "agentic"
+];
 var parallelSearchInputSchema = lazySchema17(
   () => zodSchema17(
     z18.object({
@@ -2207,64 +2215,85 @@ var parallelSearchInputSchema = lazySchema17(
         "Natural-language description of the web research goal, including source or freshness guidance and broader context from the task. Maximum 5000 characters."
       ),
       search_queries: z18.array(z18.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: z18.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: z18.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: z18.number().optional().describe(
         "Maximum number of results to return (1-20). Defaults to 10 if not specified."
       ),
       source_policy: z18.object({
         include_domains: z18.array(z18.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: z18.array(z18.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: z18.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: z18.object({
         max_chars_per_result: z18.number().optional().describe("Maximum characters per result."),
-        max_chars_total: z18.number().optional().describe("Maximum total characters across all results.")
+        max_chars_total: z18.number().optional().describe("Deprecated: use the top-level max_chars_total.")
       }).optional().describe("Excerpt configuration for controlling result length."),
+      max_chars_total: z18.number().optional().describe("Maximum total characters across all result excerpts."),
       fetch_policy: z18.object({
         max_age_seconds: z18.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: z18.number().optional().describe(
+          "Timeout in seconds for a live fetch when content is not cached. Capped by the gateway tool timeout."
+        ),
+        disable_cache_fallback: z18.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: z18.string().optional().describe(
+        'ISO 3166-1 alpha-2 country code to localize results, e.g. "us".'
+      )
     })
   )
 );
 var parallelSearchOutputSchema = lazySchema17(
   () => zodSchema17(
     z18.union([
-      // Success response
+      // Success response (Parallel's response, passed through by the gateway)
       z18.object({
-        searchId: z18.string(),
+        search_id: z18.string(),
         results: z18.array(
           z18.object({
             url: z18.string(),
-            title: z18.string(),
-            excerpt: z18.string(),
-            publishDate: z18.string().nullable().optional(),
-            relevanceScore: z18.number().optional()
+            title: z18.string().nullable().optional(),
+            publish_date: z18.string().nullable().optional(),
+            excerpts: z18.array(z18.string())
           })
-        )
+        ),
+        warnings: z18.array(
+          z18.object({
+            type: z18.string(),
+            message: z18.string(),
+            detail: z18.record(z18.string(), z18.unknown()).nullable().optional()
+          })
+        ).nullable().optional(),
+        usage: z18.array(z18.object({ name: z18.string(), count: z18.number().optional() })).nullable().optional(),
+        session_id: z18.string().optional()
       }),
       // Error response
       z18.object({
         error: z18.enum([
           "api_error",
+          "configuration_error",
+          "execution_error",
+          "gateway_rate_limit",
+          "invalid_input",
           "rate_limit",
           "timeout",
-          "invalid_input",
-          "configuration_error",
-          "unknown"
+          "unknown",
+          "unknown_tool"
         ]),
         statusCode: z18.number().optional(),
         message: z18.string()
@@ -2641,7 +2670,7 @@ async function getVercelRequestId() {
 }
 
 // src/version.ts
-var VERSION = true ? "3.0.219" : "0.0.0-test";
+var VERSION = true ? "3.0.221" : "0.0.0-test";
 
 // src/gateway-provider.ts
 var AI_GATEWAY_PROTOCOL_VERSION = "0.0.1";