@ai-sdk/gateway 4.0.0-canary.99 → 4.0.1

package/dist/index.js

@@ -1,9 +1,67 @@
+// src/gateway-realtime-auth.ts
+var GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realtime.v1";
+var GATEWAY_AUTH_SUBPROTOCOL_PREFIX = "ai-gateway-auth.";
+var GATEWAY_TEAM_SUBPROTOCOL_PREFIX = "ai-gateway-team.";
+function getGatewayRealtimeProtocols(token, options) {
+  const protocols = [
+    GATEWAY_REALTIME_SUBPROTOCOL,
+    `${GATEWAY_AUTH_SUBPROTOCOL_PREFIX}${token}`
+  ];
+  if (options == null ? void 0 : options.teamIdOrSlug) {
+    protocols.push(
+      `${GATEWAY_TEAM_SUBPROTOCOL_PREFIX}${encodeSubprotocolValue(options.teamIdOrSlug)}`
+    );
+  }
+  return protocols;
+}
+function getGatewayRealtimeAuthToken(secWebSocketProtocol) {
+  var _a11;
+  return ((_a11 = findProtocol(secWebSocketProtocol, GATEWAY_AUTH_SUBPROTOCOL_PREFIX)) == null ? void 0 : _a11.slice(
+    GATEWAY_AUTH_SUBPROTOCOL_PREFIX.length
+  )) || void 0;
+}
+function getGatewayRealtimeTeamIdOrSlug(secWebSocketProtocol) {
+  var _a11;
+  const encoded = (_a11 = findProtocol(
+    secWebSocketProtocol,
+    GATEWAY_TEAM_SUBPROTOCOL_PREFIX
+  )) == null ? void 0 : _a11.slice(GATEWAY_TEAM_SUBPROTOCOL_PREFIX.length);
+  if (!encoded) return void 0;
+  try {
+    return decodeSubprotocolValue(encoded) || void 0;
+  } catch (e) {
+    return void 0;
+  }
+}
+function findProtocol(secWebSocketProtocol, prefix) {
+  return secWebSocketProtocol == null ? void 0 : secWebSocketProtocol.split(",").map((protocol) => protocol.trim()).find((protocol) => protocol.startsWith(prefix));
+}
+function encodeSubprotocolValue(value) {
+  const bytes = new TextEncoder().encode(value);
+  let binary = "";
+  for (const byte of bytes) {
+    binary += String.fromCharCode(byte);
+  }
+  return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/u, "");
+}
+function decodeSubprotocolValue(value) {
+  const base64 = value.replace(/-/g, "+").replace(/_/g, "/");
+  const padding = "=".repeat((4 - base64.length % 4) % 4);
+  const binary = atob(`${base64}${padding}`);
+  const bytes = Uint8Array.from(binary, (char) => char.charCodeAt(0));
+  return new TextDecoder().decode(bytes);
+}
+
 // src/gateway-provider.ts
 import {
+  createJsonErrorResponseHandler as createJsonErrorResponseHandler11,
+  createJsonResponseHandler as createJsonResponseHandler10,
   loadOptionalSetting,
+  postJsonToApi as postJsonToApi8,
   withoutTrailingSlash,
   withUserAgentSuffix
 } from "@ai-sdk/provider-utils";
+import { z as z17 } from "zod/v4";
 
 // src/errors/as-gateway-error.ts
 import { APICallError } from "@ai-sdk/provider";
@@ -217,12 +275,58 @@ var GatewayInternalServerError = class extends (_b6 = GatewayError, _a6 = symbol
   }
 };
 
-// src/errors/gateway-response-error.ts
-var name6 = "GatewayResponseError";
+// src/errors/gateway-failed-dependency-error.ts
+var name6 = "GatewayFailedDependencyError";
 var marker7 = `vercel.ai.gateway.error.${name6}`;
 var symbol7 = Symbol.for(marker7);
 var _a7, _b7;
-var GatewayResponseError = class extends (_b7 = GatewayError, _a7 = symbol7, _b7) {
+var GatewayFailedDependencyError = class extends (_b7 = GatewayError, _a7 = symbol7, _b7) {
+  constructor({
+    message = "Failed dependency",
+    statusCode = 424,
+    cause,
+    generationId
+  } = {}) {
+    super({ message, statusCode, cause, generationId });
+    this[_a7] = true;
+    // used in isInstance
+    this.name = name6;
+    this.type = "failed_dependency";
+  }
+  static isInstance(error) {
+    return GatewayError.hasMarker(error) && symbol7 in error;
+  }
+};
+
+// src/errors/gateway-forbidden-error.ts
+var name7 = "GatewayForbiddenError";
+var marker8 = `vercel.ai.gateway.error.${name7}`;
+var symbol8 = Symbol.for(marker8);
+var _a8, _b8;
+var GatewayForbiddenError = class extends (_b8 = GatewayError, _a8 = symbol8, _b8) {
+  constructor({
+    message = "Forbidden",
+    statusCode = 403,
+    cause,
+    generationId
+  } = {}) {
+    super({ message, statusCode, cause, generationId });
+    this[_a8] = true;
+    // used in isInstance
+    this.name = name7;
+    this.type = "forbidden";
+  }
+  static isInstance(error) {
+    return GatewayError.hasMarker(error) && symbol8 in error;
+  }
+};
+
+// src/errors/gateway-response-error.ts
+var name8 = "GatewayResponseError";
+var marker9 = `vercel.ai.gateway.error.${name8}`;
+var symbol9 = Symbol.for(marker9);
+var _a9, _b9;
+var GatewayResponseError = class extends (_b9 = GatewayError, _a9 = symbol9, _b9) {
   constructor({
     message = "Invalid response from Gateway",
     statusCode = 502,
@@ -232,15 +336,15 @@ var GatewayResponseError = class extends (_b7 = GatewayError, _a7 = symbol7, _b7
     generationId
   } = {}) {
     super({ message, statusCode, cause, generationId });
-    this[_a7] = true;
+    this[_a9] = true;
     // used in isInstance
-    this.name = name6;
+    this.name = name8;
     this.type = "response_error";
     this.response = response;
     this.validationError = validationError;
   }
   static isInstance(error) {
-    return GatewayError.hasMarker(error) && symbol7 in error;
+    return GatewayError.hasMarker(error) && symbol9 in error;
   }
 };
 
@@ -257,7 +361,7 @@ async function createGatewayErrorFromResponse({
   cause,
   authMethod
 }) {
-  var _a9;
+  var _a11;
   const parseResult = await safeValidateTypes({
     value: response,
     schema: gatewayErrorResponseSchema
@@ -276,7 +380,7 @@ async function createGatewayErrorFromResponse({
   const validatedResponse = parseResult.value;
   const errorType = validatedResponse.error.type;
   const message = validatedResponse.error.message;
-  const generationId = (_a9 = validatedResponse.generationId) != null ? _a9 : void 0;
+  const generationId = (_a11 = validatedResponse.generationId) != null ? _a11 : void 0;
   switch (errorType) {
     case "authentication_error":
       return GatewayAuthenticationError.createContextualError({
@@ -320,6 +424,20 @@ async function createGatewayErrorFromResponse({
         cause,
         generationId
       });
+    case "failed_dependency":
+      return new GatewayFailedDependencyError({
+        message,
+        statusCode,
+        cause,
+        generationId
+      });
+    case "forbidden":
+      return new GatewayForbiddenError({
+        message,
+        statusCode,
+        cause,
+        generationId
+      });
     default:
       return new GatewayInternalServerError({
         message,
@@ -359,11 +477,11 @@ function extractApiCallResponse(error) {
 }
 
 // src/errors/gateway-timeout-error.ts
-var name7 = "GatewayTimeoutError";
-var marker8 = `vercel.ai.gateway.error.${name7}`;
-var symbol8 = Symbol.for(marker8);
-var _a8, _b8;
-var GatewayTimeoutError = class _GatewayTimeoutError extends (_b8 = GatewayError, _a8 = symbol8, _b8) {
+var name9 = "GatewayTimeoutError";
+var marker10 = `vercel.ai.gateway.error.${name9}`;
+var symbol10 = Symbol.for(marker10);
+var _a10, _b10;
+var GatewayTimeoutError = class _GatewayTimeoutError extends (_b10 = GatewayError, _a10 = symbol10, _b10) {
   constructor({
     message = "Request timed out",
     statusCode = 408,
@@ -371,13 +489,13 @@ var GatewayTimeoutError = class _GatewayTimeoutError extends (_b8 = GatewayError
     generationId
   } = {}) {
     super({ message, statusCode, cause, generationId });
-    this[_a8] = true;
+    this[_a10] = true;
     // used in isInstance
-    this.name = name7;
+    this.name = name9;
     this.type = "timeout_error";
   }
   static isInstance(error) {
-    return GatewayError.hasMarker(error) && symbol8 in error;
+    return GatewayError.hasMarker(error) && symbol10 in error;
   }
   /**
    * Creates a helpful timeout error message with troubleshooting guidance
@@ -417,7 +535,7 @@ function isTimeoutError(error) {
   return false;
 }
 async function asGatewayError(error, authMethod) {
-  var _a9;
+  var _a11;
   if (GatewayError.isInstance(error)) {
     return error;
   }
@@ -436,7 +554,7 @@ async function asGatewayError(error, authMethod) {
     }
     return await createGatewayErrorFromResponse({
       response: extractApiCallResponse(error),
-      statusCode: (_a9 = error.statusCode) != null ? _a9 : 500,
+      statusCode: (_a11 = error.statusCode) != null ? _a11 : 500,
       defaultMessage: "Gateway request failed",
       cause: error,
       authMethod
@@ -927,24 +1045,24 @@ var GatewayLanguageModel = class _GatewayLanguageModel {
       );
     }
   }
-  isFilePart(part) {
-    return part && typeof part === "object" && "type" in part && part.type === "file";
-  }
   /**
-   * Encodes inline `Uint8Array` file part data to a base64 string in place.
+   * Encodes inline `Uint8Array` file data to a base64 string in place.
    * @param options - The options to encode.
-   * @returns The options with the file parts encoded.
+   * @returns The options with the file data encoded.
    */
   maybeEncodeFileParts(options) {
     for (const message of options.prompt) {
+      if (!Array.isArray(message.content)) {
+        continue;
+      }
       for (const part of message.content) {
-        if (this.isFilePart(part)) {
-          const filePart = part;
-          if (filePart.data.type === "data" && filePart.data.data instanceof Uint8Array) {
-            filePart.data = {
-              type: "data",
-              data: Buffer.from(filePart.data.data).toString("base64")
-            };
+        if (part.type === "file" || part.type === "reasoning-file") {
+          part.data = maybeBase64EncodeFileData(part.data);
+        } else if (part.type === "tool-result" && part.output.type === "content") {
+          for (const contentPart of part.output.value) {
+            if (contentPart.type === "file") {
+              contentPart.data = maybeBase64EncodeFileData(contentPart.data);
+            }
           }
         }
       }
@@ -962,6 +1080,15 @@ var GatewayLanguageModel = class _GatewayLanguageModel {
     };
   }
 };
+function maybeBase64EncodeFileData(data) {
+  if (data.type === "data") {
+    const bytes = data.data;
+    if (bytes instanceof Uint8Array) {
+      return { ...data, data: Buffer.from(bytes).toString("base64") };
+    }
+  }
+  return data;
+}
 
 // src/gateway-embedding-model.ts
 import {
@@ -1003,7 +1130,7 @@ var GatewayEmbeddingModel = class _GatewayEmbeddingModel {
     abortSignal,
     providerOptions
   }) {
-    var _a9;
+    var _a11, _b11;
     const resolvedHeaders = this.config.headers ? await resolve5(this.config.headers) : void 0;
     try {
       const {
@@ -1034,10 +1161,10 @@ var GatewayEmbeddingModel = class _GatewayEmbeddingModel {
       });
       return {
         embeddings: responseBody.embeddings,
-        usage: (_a9 = responseBody.usage) != null ? _a9 : void 0,
+        usage: (_a11 = responseBody.usage) != null ? _a11 : void 0,
         providerMetadata: responseBody.providerMetadata,
         response: { headers: responseHeaders, body: rawValue },
-        warnings: []
+        warnings: (_b11 = responseBody.warnings) != null ? _b11 : []
       };
     } catch (error) {
       throw await asGatewayError(
@@ -1056,11 +1183,33 @@ var GatewayEmbeddingModel = class _GatewayEmbeddingModel {
     };
   }
 };
+var gatewayEmbeddingWarningSchema = z8.discriminatedUnion("type", [
+  z8.object({
+    type: z8.literal("unsupported"),
+    feature: z8.string(),
+    details: z8.string().optional()
+  }),
+  z8.object({
+    type: z8.literal("compatibility"),
+    feature: z8.string(),
+    details: z8.string().optional()
+  }),
+  z8.object({
+    type: z8.literal("deprecated"),
+    setting: z8.string(),
+    message: z8.string()
+  }),
+  z8.object({
+    type: z8.literal("other"),
+    message: z8.string()
+  })
+]);
 var gatewayEmbeddingResponseSchema = lazySchema7(
   () => zodSchema7(
     z8.object({
       embeddings: z8.array(z8.array(z8.number())),
       usage: z8.object({ tokens: z8.number() }).nullish(),
+      warnings: z8.array(gatewayEmbeddingWarningSchema).optional(),
       providerMetadata: z8.record(z8.string(), z8.record(z8.string(), z8.unknown())).optional()
     })
   )
@@ -1111,7 +1260,7 @@ var GatewayImageModel = class _GatewayImageModel {
     headers,
     abortSignal
   }) {
-    var _a9, _b9, _c, _d;
+    var _a11, _b11, _c, _d;
     const resolvedHeaders = this.config.headers ? await resolve6(this.config.headers) : void 0;
     try {
       const { responseHeaders, value: responseBody } = await postJsonToApi3({
@@ -1147,7 +1296,7 @@ var GatewayImageModel = class _GatewayImageModel {
       return {
         images: responseBody.images,
         // Always base64 strings from server
-        warnings: (_a9 = responseBody.warnings) != null ? _a9 : [],
+        warnings: (_a11 = responseBody.warnings) != null ? _a11 : [],
         providerMetadata: responseBody.providerMetadata,
         response: {
           timestamp: /* @__PURE__ */ new Date(),
@@ -1156,7 +1305,7 @@ var GatewayImageModel = class _GatewayImageModel {
         },
         ...responseBody.usage != null && {
           usage: {
-            inputTokens: (_b9 = responseBody.usage.inputTokens) != null ? _b9 : void 0,
+            inputTokens: (_b11 = responseBody.usage.inputTokens) != null ? _b11 : void 0,
             outputTokens: (_c = responseBody.usage.outputTokens) != null ? _c : void 0,
             totalTokens: (_d = responseBody.usage.totalTokens) != null ? _d : void 0
           }
@@ -1202,6 +1351,11 @@ var gatewayImageWarningSchema = z9.discriminatedUnion("type", [
     feature: z9.string(),
     details: z9.string().optional()
   }),
+  z9.object({
+    type: z9.literal("deprecated"),
+    setting: z9.string(),
+    message: z9.string()
+  }),
   z9.object({
     type: z9.literal("other"),
     message: z9.string()
@@ -1252,12 +1406,13 @@ var GatewayVideoModel = class {
     duration,
     fps,
     seed,
+    generateAudio,
     image,
     providerOptions,
     headers,
     abortSignal
   }) {
-    var _a9;
+    var _a11;
     const resolvedHeaders = this.config.headers ? await resolve7(this.config.headers) : void 0;
     try {
       const { responseHeaders, value: responseBody } = await postJsonToApi4({
@@ -1277,6 +1432,7 @@ var GatewayVideoModel = class {
           ...duration && { duration },
           ...fps && { fps },
           ...seed && { seed },
+          ...generateAudio !== void 0 && { generateAudio },
           ...providerOptions && { providerOptions },
           ...image && { image: maybeEncodeVideoFile(image) }
         },
@@ -1353,7 +1509,7 @@ var GatewayVideoModel = class {
       });
       return {
         videos: responseBody.videos,
-        warnings: (_a9 = responseBody.warnings) != null ? _a9 : [],
+        warnings: (_a11 = responseBody.warnings) != null ? _a11 : [],
         providerMetadata: responseBody.providerMetadata,
         response: {
           timestamp: /* @__PURE__ */ new Date(),
@@ -1413,6 +1569,11 @@ var gatewayVideoWarningSchema = z10.discriminatedUnion("type", [
     feature: z10.string(),
     details: z10.string().optional()
   }),
+  z10.object({
+    type: z10.literal("deprecated"),
+    setting: z10.string(),
+    message: z10.string()
+  }),
   z10.object({
     type: z10.literal("other"),
     message: z10.string()
@@ -1462,6 +1623,7 @@ var GatewayRerankingModel = class {
     abortSignal,
     providerOptions
   }) {
+    var _a11;
     const resolvedHeaders = this.config.headers ? await resolve8(this.config.headers) : void 0;
     try {
       const {
@@ -1496,7 +1658,7 @@ var GatewayRerankingModel = class {
         ranking: responseBody.ranking,
         providerMetadata: responseBody.providerMetadata,
         response: { headers: responseHeaders, body: rawValue },
-        warnings: []
+        warnings: (_a11 = responseBody.warnings) != null ? _a11 : []
       };
     } catch (error) {
       throw await asGatewayError(
@@ -1515,6 +1677,27 @@ var GatewayRerankingModel = class {
     };
   }
 };
+var gatewayRerankingWarningSchema = z11.discriminatedUnion("type", [
+  z11.object({
+    type: z11.literal("unsupported"),
+    feature: z11.string(),
+    details: z11.string().optional()
+  }),
+  z11.object({
+    type: z11.literal("compatibility"),
+    feature: z11.string(),
+    details: z11.string().optional()
+  }),
+  z11.object({
+    type: z11.literal("deprecated"),
+    setting: z11.string(),
+    message: z11.string()
+  }),
+  z11.object({
+    type: z11.literal("other"),
+    message: z11.string()
+  })
+]);
 var gatewayRerankingResponseSchema = lazySchema8(
   () => zodSchema8(
     z11.object({
@@ -1524,6 +1707,7 @@ var gatewayRerankingResponseSchema = lazySchema8(
           relevanceScore: z11.number()
         })
       ),
+      warnings: z11.array(gatewayRerankingWarningSchema).optional(),
       providerMetadata: z11.record(z11.string(), z11.record(z11.string(), z11.unknown())).optional()
     })
   )
@@ -1558,7 +1742,7 @@ var GatewaySpeechModel = class {
     headers,
     abortSignal
   }) {
-    var _a9;
+    var _a11;
     const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : void 0;
     try {
       const {
@@ -1594,7 +1778,7 @@ var GatewaySpeechModel = class {
       });
       return {
         audio: responseBody.audio,
-        warnings: (_a9 = responseBody.warnings) != null ? _a9 : [],
+        warnings: (_a11 = responseBody.warnings) != null ? _a11 : [],
         providerMetadata: responseBody.providerMetadata,
         response: {
           timestamp: /* @__PURE__ */ new Date(),
@@ -1632,6 +1816,11 @@ var gatewaySpeechWarningSchema = z12.discriminatedUnion("type", [
     feature: z12.string(),
     details: z12.string().optional()
   }),
+  z12.object({
+    type: z12.literal("deprecated"),
+    setting: z12.string(),
+    message: z12.string()
+  }),
   z12.object({
     type: z12.literal("other"),
     message: z12.string()
@@ -1669,7 +1858,7 @@ var GatewayTranscriptionModel = class {
     headers,
     abortSignal
   }) {
-    var _a9, _b9, _c, _d;
+    var _a11, _b11, _c, _d;
     const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : void 0;
     try {
       const {
@@ -1701,8 +1890,8 @@ var GatewayTranscriptionModel = class {
       });
       return {
         text: responseBody.text,
-        segments: (_a9 = responseBody.segments) != null ? _a9 : [],
-        language: (_b9 = responseBody.language) != null ? _b9 : void 0,
+        segments: (_a11 = responseBody.segments) != null ? _a11 : [],
+        language: (_b11 = responseBody.language) != null ? _b11 : void 0,
         durationInSeconds: (_c = responseBody.durationInSeconds) != null ? _c : void 0,
         warnings: (_d = responseBody.warnings) != null ? _d : [],
         providerMetadata: responseBody.providerMetadata,
@@ -1742,6 +1931,11 @@ var gatewayTranscriptionWarningSchema = z13.discriminatedUnion("type", [
     feature: z13.string(),
     details: z13.string().optional()
   }),
+  z13.object({
+    type: z13.literal("deprecated"),
+    setting: z13.string(),
+    message: z13.string()
+  }),
   z13.object({
     type: z13.literal("other"),
     message: z13.string()
@@ -1762,68 +1956,260 @@ var gatewayTranscriptionResponseSchema = z13.object({
   providerMetadata: z13.record(z13.string(), providerMetadataEntrySchema4).optional()
 });
 
-// src/tool/parallel-search.ts
+// src/gateway-realtime-model.ts
+var GatewayRealtimeModel = class {
+  constructor(modelId, config) {
+    this.specificationVersion = "v4";
+    this.modelId = modelId;
+    this.provider = config.provider;
+    this.config = config;
+  }
+  /**
+   * Mints a single-use, short-lived client secret (`vcst_`) the browser uses to
+   * open the realtime WebSocket without ever holding the long-lived Gateway
+   * credential. The customer's server calls this (via
+   * `gateway.experimental_realtime.getToken`) and hands the returned token to
+   * the browser, which connects with it through the `ai-gateway-auth.<token>`
+   * subprotocol. `expiresAfterSeconds` is forwarded to the mint endpoint;
+   * `sessionConfig` is intentionally unused here — it is applied later via the
+   * normalized `session-update` event.
+   */
+  async doCreateClientSecret(options) {
+    const secret = await this.config.createClientSecret({
+      modelId: this.modelId,
+      ...(options == null ? void 0 : options.expiresAfterSeconds) != null && {
+        expiresAfterSeconds: options.expiresAfterSeconds
+      }
+    });
+    return {
+      token: secret.token,
+      url: toGatewayRealtimeUrl(this.config.baseURL, this.modelId),
+      ...secret.expiresAt != null && { expiresAt: secret.expiresAt }
+    };
+  }
+  getWebSocketConfig(options) {
+    return {
+      url: options.url,
+      protocols: getGatewayRealtimeProtocols(options.token, {
+        teamIdOrSlug: this.config.teamIdOrSlug
+      })
+    };
+  }
+  parseServerEvent(raw) {
+    return raw;
+  }
+  serializeClientEvent(event) {
+    return event;
+  }
+  buildSessionConfig(config) {
+    return config;
+  }
+};
+function toGatewayRealtimeUrl(baseURL, modelId) {
+  const url = new URL(`${baseURL.replace(/^http/, "ws")}/realtime-model`);
+  url.searchParams.set("ai-model-id", modelId);
+  return url.toString();
+}
+
+// src/tool/exa-search.ts
 import {
   createProviderExecutedToolFactory,
   lazySchema as lazySchema9,
   zodSchema as zodSchema9
 } from "@ai-sdk/provider-utils";
 import { z as z14 } from "zod";
-var parallelSearchInputSchema = lazySchema9(
+var exaSearchInputSchema = lazySchema9(
   () => zodSchema9(
     z14.object({
-      objective: z14.string().describe(
+      query: z14.string().describe("Natural-language web search query. This is required."),
+      type: z14.enum(["auto", "fast", "instant"]).optional().describe(
+        "Search method. Use auto for the default balance of speed and quality."
+      ),
+      num_results: z14.number().optional().describe("Maximum number of results to return (1-100, default: 10)."),
+      category: z14.enum([
+        "company",
+        "people",
+        "research paper",
+        "news",
+        "personal site",
+        "financial report"
+      ]).optional().describe("Optional content category to focus results."),
+      user_location: z14.string().optional().describe("Two-letter ISO country code such as 'US'."),
+      include_domains: z14.array(z14.string()).optional().describe("Only return results from these domains."),
+      exclude_domains: z14.array(z14.string()).optional().describe("Exclude results from these domains."),
+      start_published_date: z14.string().optional().describe("Only return links published after this ISO 8601 date."),
+      end_published_date: z14.string().optional().describe("Only return links published before this ISO 8601 date."),
+      contents: z14.object({
+        text: z14.union([
+          z14.boolean(),
+          z14.object({
+            max_characters: z14.number().optional(),
+            include_html_tags: z14.boolean().optional(),
+            verbosity: z14.enum(["compact", "standard", "full"]).optional(),
+            include_sections: z14.array(
+              z14.enum([
+                "header",
+                "navigation",
+                "banner",
+                "body",
+                "sidebar",
+                "footer",
+                "metadata"
+              ])
+            ).optional(),
+            exclude_sections: z14.array(
+              z14.enum([
+                "header",
+                "navigation",
+                "banner",
+                "body",
+                "sidebar",
+                "footer",
+                "metadata"
+              ])
+            ).optional()
+          })
+        ]).optional(),
+        highlights: z14.union([
+          z14.boolean(),
+          z14.object({
+            query: z14.string().optional(),
+            max_characters: z14.number().optional()
+          })
+        ]).optional(),
+        max_age_hours: z14.number().optional(),
+        livecrawl_timeout: z14.number().optional(),
+        subpages: z14.number().optional(),
+        subpage_target: z14.union([z14.string(), z14.array(z14.string())]).optional(),
+        extras: z14.object({
+          links: z14.number().optional(),
+          image_links: z14.number().optional()
+        }).optional()
+      }).optional().describe("Controls extracted page content and freshness.")
+    })
+  )
+);
+var exaSearchOutputSchema = lazySchema9(
+  () => zodSchema9(
+    z14.union([
+      z14.object({
+        requestId: z14.string(),
+        searchType: z14.string().optional(),
+        resolvedSearchType: z14.string().optional(),
+        results: z14.array(
+          z14.object({
+            title: z14.string(),
+            url: z14.string(),
+            id: z14.string(),
+            publishedDate: z14.string().nullable().optional(),
+            author: z14.string().nullable().optional(),
+            image: z14.string().nullable().optional(),
+            favicon: z14.string().nullable().optional(),
+            text: z14.string().optional(),
+            highlights: z14.array(z14.string()).optional(),
+            highlightScores: z14.array(z14.number()).optional(),
+            summary: z14.string().optional(),
+            subpages: z14.array(z14.any()).optional(),
+            extras: z14.object({
+              links: z14.array(z14.string()).optional(),
+              imageLinks: z14.array(z14.string()).optional()
+            }).optional()
+          })
+        ),
+        costDollars: z14.object({
+          total: z14.number().optional(),
+          search: z14.record(z14.number()).optional()
+        }).optional()
+      }),
+      z14.object({
+        error: z14.enum([
+          "api_error",
+          "rate_limit",
+          "timeout",
+          "invalid_input",
+          "configuration_error",
+          "execution_error",
+          "unknown"
+        ]),
+        statusCode: z14.number().optional(),
+        message: z14.string()
+      })
+    ])
+  )
+);
+var exaSearchToolFactory = createProviderExecutedToolFactory({
+  id: "gateway.exa_search",
+  inputSchema: exaSearchInputSchema,
+  outputSchema: exaSearchOutputSchema
+});
+var exaSearch = (config = {}) => exaSearchToolFactory(config);
+
+// src/tool/parallel-search.ts
+import {
+  createProviderExecutedToolFactory as createProviderExecutedToolFactory2,
+  lazySchema as lazySchema10,
+  zodSchema as zodSchema10
+} from "@ai-sdk/provider-utils";
+import { z as z15 } from "zod";
+var parallelSearchInputSchema = lazySchema10(
+  () => zodSchema10(
+    z15.object({
+      objective: z15.string().describe(
         "Natural-language description of the web research goal, including source or freshness guidance and broader context from the task. Maximum 5000 characters."
       ),
-      search_queries: z14.array(z14.string()).optional().describe(
+      search_queries: z15.array(z15.string()).optional().describe(
         "Optional search queries to supplement the objective. Maximum 200 characters per query."
       ),
-      mode: z14.enum(["one-shot", "agentic"]).optional().describe(
+      mode: z15.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.'
       ),
-      max_results: z14.number().optional().describe(
+      max_results: z15.number().optional().describe(
         "Maximum number of results to return (1-20). Defaults to 10 if not specified."
       ),
-      source_policy: z14.object({
-        include_domains: z14.array(z14.string()).optional().describe("List of domains to include in search results."),
-        exclude_domains: z14.array(z14.string()).optional().describe("List of domains to exclude from search results."),
-        after_date: z14.string().optional().describe(
-          "Only include results published after this date (ISO 8601 format)."
+      source_policy: z15.object({
+        include_domains: z15.array(z15.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)."
+        ),
+        exclude_domains: z15.array(z15.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)."
+        ),
+        after_date: z15.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."
         )
       }).optional().describe(
         "Source policy for controlling which domains to include/exclude and freshness."
       ),
-      excerpts: z14.object({
-        max_chars_per_result: z14.number().optional().describe("Maximum characters per result."),
-        max_chars_total: z14.number().optional().describe("Maximum total characters across all results.")
+      excerpts: z15.object({
+        max_chars_per_result: z15.number().optional().describe("Maximum characters per result."),
+        max_chars_total: z15.number().optional().describe("Maximum total characters across all results.")
       }).optional().describe("Excerpt configuration for controlling result length."),
-      fetch_policy: z14.object({
-        max_age_seconds: z14.number().optional().describe(
+      fetch_policy: z15.object({
+        max_age_seconds: z15.number().optional().describe(
           "Maximum age in seconds for cached content. Set to 0 to always fetch fresh content."
         )
       }).optional().describe("Fetch policy for controlling content freshness.")
     })
   )
 );
-var parallelSearchOutputSchema = lazySchema9(
-  () => zodSchema9(
-    z14.union([
+var parallelSearchOutputSchema = lazySchema10(
+  () => zodSchema10(
+    z15.union([
       // Success response
-      z14.object({
-        searchId: z14.string(),
-        results: z14.array(
-          z14.object({
-            url: z14.string(),
-            title: z14.string(),
-            excerpt: z14.string(),
-            publishDate: z14.string().nullable().optional(),
-            relevanceScore: z14.number().optional()
+      z15.object({
+        searchId: z15.string(),
+        results: z15.array(
+          z15.object({
+            url: z15.string(),
+            title: z15.string(),
+            excerpt: z15.string(),
+            publishDate: z15.string().nullable().optional(),
+            relevanceScore: z15.number().optional()
           })
         )
       }),
       // Error response
-      z14.object({
-        error: z14.enum([
+      z15.object({
+        error: z15.enum([
           "api_error",
           "rate_limit",
           "timeout",
@@ -1831,13 +2217,13 @@ var parallelSearchOutputSchema = lazySchema9(
           "configuration_error",
           "unknown"
         ]),
-        statusCode: z14.number().optional(),
-        message: z14.string()
+        statusCode: z15.number().optional(),
+        message: z15.string()
       })
     ])
   )
 );
-var parallelSearchToolFactory = createProviderExecutedToolFactory({
+var parallelSearchToolFactory = createProviderExecutedToolFactory2({
   id: "gateway.parallel_search",
   inputSchema: parallelSearchInputSchema,
   outputSchema: parallelSearchOutputSchema
@@ -1846,85 +2232,85 @@ var parallelSearch = (config = {}) => parallelSearchToolFactory(config);
 
 // src/tool/perplexity-search.ts
 import {
-  createProviderExecutedToolFactory as createProviderExecutedToolFactory2,
-  lazySchema as lazySchema10,
-  zodSchema as zodSchema10
+  createProviderExecutedToolFactory as createProviderExecutedToolFactory3,
+  lazySchema as lazySchema11,
+  zodSchema as zodSchema11
 } from "@ai-sdk/provider-utils";
-import { z as z15 } from "zod";
-var perplexitySearchInputSchema = lazySchema10(
-  () => zodSchema10(
-    z15.object({
-      query: z15.union([z15.string(), z15.array(z15.string())]).describe(
+import { z as z16 } from "zod";
+var perplexitySearchInputSchema = lazySchema11(
+  () => zodSchema11(
+    z16.object({
+      query: z16.union([z16.string(), z16.array(z16.string())]).describe(
         "Search query (string) or multiple queries (array of up to 5 strings). Multi-query searches return combined results from all queries."
       ),
-      max_results: z15.number().optional().describe(
+      max_results: z16.number().optional().describe(
         "Maximum number of search results to return (1-20, default: 10)"
       ),
-      max_tokens_per_page: z15.number().optional().describe(
+      max_tokens_per_page: z16.number().optional().describe(
         "Maximum number of tokens to extract per search result page (256-2048, default: 2048)"
       ),
-      max_tokens: z15.number().optional().describe(
+      max_tokens: z16.number().optional().describe(
         "Maximum total tokens across all search results (default: 25000, max: 1000000)"
       ),
-      country: z15.string().optional().describe(
+      country: z16.string().optional().describe(
         "Two-letter ISO 3166-1 alpha-2 country code for regional search results (e.g., 'US', 'GB', 'FR')"
       ),
-      search_domain_filter: z15.array(z15.string()).optional().describe(
+      search_domain_filter: z16.array(z16.string()).optional().describe(
         "List of domains to include or exclude from search results (max 20). To include: ['nature.com', 'science.org']. To exclude: ['-example.com', '-spam.net']"
       ),
-      search_language_filter: z15.array(z15.string()).optional().describe(
+      search_language_filter: z16.array(z16.string()).optional().describe(
         "List of ISO 639-1 language codes to filter results (max 10, lowercase). Examples: ['en', 'fr', 'de']"
       ),
-      search_after_date: z15.string().optional().describe(
+      search_after_date: z16.string().optional().describe(
         "Include only results published after this date. Format: 'MM/DD/YYYY' (e.g., '3/1/2025'). Cannot be used with search_recency_filter."
       ),
-      search_before_date: z15.string().optional().describe(
+      search_before_date: z16.string().optional().describe(
         "Include only results published before this date. Format: 'MM/DD/YYYY' (e.g., '3/15/2025'). Cannot be used with search_recency_filter."
       ),
-      last_updated_after_filter: z15.string().optional().describe(
+      last_updated_after_filter: z16.string().optional().describe(
         "Include only results last updated after this date. Format: 'MM/DD/YYYY' (e.g., '3/1/2025'). Cannot be used with search_recency_filter."
       ),
-      last_updated_before_filter: z15.string().optional().describe(
+      last_updated_before_filter: z16.string().optional().describe(
         "Include only results last updated before this date. Format: 'MM/DD/YYYY' (e.g., '3/15/2025'). Cannot be used with search_recency_filter."
       ),
-      search_recency_filter: z15.enum(["day", "week", "month", "year"]).optional().describe(
+      search_recency_filter: z16.enum(["day", "week", "month", "year"]).optional().describe(
         "Filter results by relative time period. Cannot be used with search_after_date or search_before_date."
       )
     })
   )
 );
-var perplexitySearchOutputSchema = lazySchema10(
-  () => zodSchema10(
-    z15.union([
+var perplexitySearchOutputSchema = lazySchema11(
+  () => zodSchema11(
+    z16.union([
       // Success response
-      z15.object({
-        results: z15.array(
-          z15.object({
-            title: z15.string(),
-            url: z15.string(),
-            snippet: z15.string(),
-            date: z15.string().optional(),
-            lastUpdated: z15.string().optional()
+      z16.object({
+        results: z16.array(
+          z16.object({
+            title: z16.string(),
+            url: z16.string(),
+            snippet: z16.string(),
+            date: z16.string().optional(),
+            lastUpdated: z16.string().optional()
           })
         ),
-        id: z15.string()
+        id: z16.string()
       }),
       // Error response
-      z15.object({
-        error: z15.enum([
+      z16.object({
+        error: z16.enum([
           "api_error",
           "rate_limit",
           "timeout",
           "invalid_input",
           "unknown"
         ]),
-        statusCode: z15.number().optional(),
-        message: z15.string()
+        statusCode: z16.number().optional(),
+        message: z16.string()
       })
     ])
   )
 );
-var perplexitySearchToolFactory = createProviderExecutedToolFactory2({
+var perplexitySearchToolFactory = createProviderExecutedToolFactory3({
   id: "gateway.perplexity_search",
   inputSchema: perplexitySearchInputSchema,
   outputSchema: perplexitySearchOutputSchema
@@ -1933,6 +2319,14 @@ var perplexitySearch = (config = {}) => perplexitySearchToolFactory(config);
 
 // src/gateway-tools.ts
 var gatewayTools = {
+  /**
+   * Search the web using Exa for current information and token-efficient
+   * excerpts optimized for agent workflows.
+   *
+   * Supports search type, category, domain, date, location, and content
+   * extraction controls.
+   */
+  exaSearch,
   /**
    * Search the web using Parallel AI's Search API for LLM-optimized excerpts.
    *
@@ -1956,22 +2350,26 @@ var gatewayTools = {
 import { getContext } from "@vercel/oidc";
 import { getVercelOidcToken } from "@vercel/oidc";
 async function getVercelRequestId() {
-  var _a9;
-  return (_a9 = getContext().headers) == null ? void 0 : _a9["x-vercel-id"];
+  var _a11;
+  return (_a11 = getContext().headers) == null ? void 0 : _a11["x-vercel-id"];
 }
 
 // src/version.ts
-var VERSION = true ? "4.0.0-canary.99" : "0.0.0-test";
+var VERSION = true ? "4.0.1" : "0.0.0-test";
 
 // src/gateway-provider.ts
 var AI_GATEWAY_PROTOCOL_VERSION = "0.0.1";
+var gatewayClientSecretResponseSchema = z17.object({
+  token: z17.string(),
+  expiresAt: z17.number().nullish()
+});
 function createGateway(options = {}) {
-  var _a9, _b9;
+  var _a11, _b11;
   let pendingMetadata = null;
   let metadataCache = null;
-  const cacheRefreshMillis = (_a9 = options.metadataCacheRefreshMillis) != null ? _a9 : 1e3 * 60 * 5;
+  const cacheRefreshMillis = (_a11 = options.metadataCacheRefreshMillis) != null ? _a11 : 1e3 * 60 * 5;
   let lastFetchTime = 0;
-  const baseURL = (_b9 = withoutTrailingSlash(options.baseURL)) != null ? _b9 : "https://ai-gateway.vercel.sh/v4/ai";
+  const baseURL = (_b11 = withoutTrailingSlash(options.baseURL)) != null ? _b11 : "https://ai-gateway.vercel.sh/v4/ai";
   const createAuthHeaders = (auth) => withUserAgentSuffix(
     {
       Authorization: `Bearer ${auth.token}`,
@@ -1994,6 +2392,50 @@ function createGateway(options = {}) {
       });
     }
   };
+  const getRealtimeAuthToken = async () => {
+    try {
+      return await getGatewayAuthToken(options);
+    } catch (error) {
+      throw GatewayAuthenticationError.createContextualError({
+        apiKeyProvided: false,
+        oidcTokenProvided: false,
+        statusCode: 401,
+        cause: error
+      });
+    }
+  };
+  const mintRealtimeClientSecret = async (params) => {
+    assertGatewayRealtimeServerEnvironment();
+    const auth = await getRealtimeAuthToken();
+    const headers = createAuthHeaders(auth);
+    const url = new URL("/v1/realtime/client-secrets", baseURL).toString();
+    try {
+      const { value } = await postJsonToApi8({
+        url,
+        headers,
+        body: {
+          model: params.modelId,
+          ...params.expiresAfterSeconds != null && {
+            expiresIn: params.expiresAfterSeconds
+          }
+        },
+        successfulResponseHandler: createJsonResponseHandler10(
+          gatewayClientSecretResponseSchema
+        ),
+        failedResponseHandler: createJsonErrorResponseHandler11({
+          errorSchema: z17.any(),
+          errorToMessage: (data) => data
+        }),
+        fetch: options.fetch
+      });
+      return {
+        token: value.token,
+        ...value.expiresAt != null && { expiresAt: value.expiresAt }
+      };
+    } catch (error) {
+      throw await asGatewayError(error, await parseAuthMethod(headers));
+    }
+  };
   const createO11yHeaders = () => {
     const deploymentId = loadOptionalSetting({
       settingValue: void 0,
@@ -2032,8 +2474,8 @@ function createGateway(options = {}) {
     });
   };
   const getAvailableModels = async () => {
-    var _a10, _b10, _c;
-    const now = (_c = (_b10 = (_a10 = options._internal) == null ? void 0 : _a10.currentDate) == null ? void 0 : _b10.call(_a10).getTime()) != null ? _c : Date.now();
+    var _a12, _b12, _c;
+    const now = (_c = (_b12 = (_a12 = options._internal) == null ? void 0 : _a12.currentDate) == null ? void 0 : _b12.call(_a12).getTime()) != null ? _c : Date.now();
     if (!pendingMetadata || now - lastFetchTime > cacheRefreshMillis) {
       lastFetchTime = now;
       pendingMetadata = new GatewayFetchMetadata({
@@ -2164,6 +2606,27 @@ function createGateway(options = {}) {
   };
   provider.transcriptionModel = createTranscriptionModel;
   provider.transcription = createTranscriptionModel;
+  const createRealtimeModel = (modelId) => new GatewayRealtimeModel(modelId, {
+    provider: "gateway.realtime",
+    baseURL,
+    teamIdOrSlug: options.teamIdOrSlug,
+    createClientSecret: mintRealtimeClientSecret
+  });
+  provider.experimental_realtime = Object.assign(
+    (modelId) => createRealtimeModel(modelId),
+    {
+      getToken: async (tokenOptions) => {
+        const { model: modelId, ...secretOptions } = tokenOptions;
+        const model = createRealtimeModel(modelId);
+        const secret = await model.doCreateClientSecret(secretOptions);
+        return {
+          token: secret.token,
+          url: secret.url,
+          ...secret.expiresAt != null && { expiresAt: secret.expiresAt }
+        };
+      }
+    }
+  );
   provider.chat = provider.languageModel;
   provider.embedding = provider.embeddingModel;
   provider.image = provider.imageModel;
@@ -2189,9 +2652,21 @@ async function getGatewayAuthToken(options) {
     authMethod: "oidc"
   };
 }
+function assertGatewayRealtimeServerEnvironment() {
+  if (typeof globalThis.window !== "undefined") {
+    throw new Error(
+      "AI Gateway realtime client secrets must be minted server-side: minting needs your Gateway credential, which must never reach the browser. Call gateway.experimental_realtime.getToken() from your server and pass the returned token to the client."
+    );
+  }
+}
 export {
+  GATEWAY_AUTH_SUBPROTOCOL_PREFIX,
+  GATEWAY_REALTIME_SUBPROTOCOL,
+  GATEWAY_TEAM_SUBPROTOCOL_PREFIX,
   GatewayAuthenticationError,
   GatewayError,
+  GatewayFailedDependencyError,
+  GatewayForbiddenError,
   GatewayInternalServerError,
   GatewayInvalidRequestError,
   GatewayModelNotFoundError,
@@ -2200,6 +2675,9 @@ export {
   VERSION,
   createGateway,
   createGateway as createGatewayProvider,
-  gateway
+  gateway,
+  getGatewayRealtimeAuthToken,
+  getGatewayRealtimeProtocols,
+  getGatewayRealtimeTeamIdOrSlug
 };
 //# sourceMappingURL=index.js.map