@ai-sdk/gateway 3.0.137 → 3.0.138

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @ai-sdk/gateway
 
+## 3.0.138
+
+### Patch Changes
+
+- fb601aa: feat (provider/gateway): add Exa search tool support
+- f19334d: feat (video): add first-class `generateAudio` call option
+- Updated dependencies [f19334d]
+  - @ai-sdk/provider@3.0.12
+  - @ai-sdk/provider-utils@4.0.32
+
 ## 3.0.137
 
 ### Patch Changes

package/dist/index.d.mts

@@ -436,10 +436,145 @@ interface ParallelSearchInput {
 type ParallelSearchOutput = ParallelSearchResponse | ParallelSearchError;
 declare const parallelSearchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<ParallelSearchInput, ParallelSearchOutput, ParallelSearchConfig>;
 
+type ExaSearchType = 'auto' | 'fast' | 'instant';
+type ExaSearchCategory = 'company' | 'people' | 'research paper' | 'news' | 'personal site' | 'financial report';
+type ExaTextSection = 'header' | 'navigation' | 'banner' | 'body' | 'sidebar' | 'footer' | 'metadata';
+interface ExaSearchTextConfig {
+    maxCharacters?: number;
+    includeHtmlTags?: boolean;
+    verbosity?: 'compact' | 'standard' | 'full';
+    includeSections?: ExaTextSection[];
+    excludeSections?: ExaTextSection[];
+}
+interface ExaSearchHighlightsConfig {
+    query?: string;
+    maxCharacters?: number;
+}
+interface ExaSearchExtrasConfig {
+    links?: number;
+    imageLinks?: number;
+}
+interface ExaSearchContentsConfig {
+    text?: boolean | ExaSearchTextConfig;
+    highlights?: boolean | ExaSearchHighlightsConfig;
+    maxAgeHours?: number;
+    livecrawlTimeout?: number;
+    subpages?: number;
+    subpageTarget?: string | string[];
+    extras?: ExaSearchExtrasConfig;
+}
+interface ExaSearchConfig {
+    /**
+     * Default search method. Exa defaults to auto when omitted.
+     */
+    type?: ExaSearchType;
+    /**
+     * Default maximum number of results to return (1-100, default: 10).
+     */
+    numResults?: number;
+    /**
+     * Default category filter for result types.
+     */
+    category?: ExaSearchCategory;
+    /**
+     * Default two-letter ISO country code for location-aware search.
+     */
+    userLocation?: string;
+    /**
+     * Default domains to include or exclude.
+     */
+    includeDomains?: string[];
+    excludeDomains?: string[];
+    /**
+     * Default published date filters in ISO 8601 format.
+     */
+    startPublishedDate?: string;
+    endPublishedDate?: string;
+    /**
+     * Default content extraction controls.
+     */
+    contents?: ExaSearchContentsConfig;
+}
+interface ExaSearchResult {
+    title: string;
+    url: string;
+    id: string;
+    publishedDate?: string | null;
+    author?: string | null;
+    image?: string | null;
+    favicon?: string | null;
+    text?: string;
+    highlights?: string[];
+    highlightScores?: number[];
+    summary?: string;
+    subpages?: ExaSearchResult[];
+    extras?: {
+        links?: string[];
+        imageLinks?: string[];
+    };
+}
+interface ExaSearchResponse {
+    requestId: string;
+    searchType?: string;
+    resolvedSearchType?: string;
+    results: ExaSearchResult[];
+    costDollars?: {
+        total?: number;
+        search?: Record<string, number>;
+    };
+}
+interface ExaSearchError {
+    error: 'api_error' | 'rate_limit' | 'timeout' | 'invalid_input' | 'configuration_error' | 'execution_error' | 'unknown';
+    statusCode?: number;
+    message: string;
+}
+interface ExaSearchInput {
+    query: string;
+    type?: ExaSearchType;
+    num_results?: number;
+    category?: ExaSearchCategory;
+    user_location?: string;
+    include_domains?: string[];
+    exclude_domains?: string[];
+    start_published_date?: string;
+    end_published_date?: string;
+    contents?: {
+        text?: boolean | {
+            max_characters?: number;
+            include_html_tags?: boolean;
+            verbosity?: 'compact' | 'standard' | 'full';
+            include_sections?: ExaTextSection[];
+            exclude_sections?: ExaTextSection[];
+        };
+        highlights?: boolean | {
+            query?: string;
+            max_characters?: number;
+        };
+        max_age_hours?: number;
+        livecrawl_timeout?: number;
+        subpages?: number;
+        subpage_target?: string | string[];
+        extras?: {
+            links?: number;
+            image_links?: number;
+        };
+    };
+}
+type ExaSearchOutput = ExaSearchResponse | ExaSearchError;
+declare const exaSearchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<ExaSearchInput, ExaSearchOutput, ExaSearchConfig>;
+
 /**
  * Gateway-specific provider-defined tools.
  */
 declare const 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: (config?: ExaSearchConfig) => ReturnType<typeof exaSearchToolFactory>;
     /**
      * Search the web using Parallel AI's Search API for LLM-optimized excerpts.
      *

package/dist/index.d.ts

@@ -436,10 +436,145 @@ interface ParallelSearchInput {
 type ParallelSearchOutput = ParallelSearchResponse | ParallelSearchError;
 declare const parallelSearchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<ParallelSearchInput, ParallelSearchOutput, ParallelSearchConfig>;
 
+type ExaSearchType = 'auto' | 'fast' | 'instant';
+type ExaSearchCategory = 'company' | 'people' | 'research paper' | 'news' | 'personal site' | 'financial report';
+type ExaTextSection = 'header' | 'navigation' | 'banner' | 'body' | 'sidebar' | 'footer' | 'metadata';
+interface ExaSearchTextConfig {
+    maxCharacters?: number;
+    includeHtmlTags?: boolean;
+    verbosity?: 'compact' | 'standard' | 'full';
+    includeSections?: ExaTextSection[];
+    excludeSections?: ExaTextSection[];
+}
+interface ExaSearchHighlightsConfig {
+    query?: string;
+    maxCharacters?: number;
+}
+interface ExaSearchExtrasConfig {
+    links?: number;
+    imageLinks?: number;
+}
+interface ExaSearchContentsConfig {
+    text?: boolean | ExaSearchTextConfig;
+    highlights?: boolean | ExaSearchHighlightsConfig;
+    maxAgeHours?: number;
+    livecrawlTimeout?: number;
+    subpages?: number;
+    subpageTarget?: string | string[];
+    extras?: ExaSearchExtrasConfig;
+}
+interface ExaSearchConfig {
+    /**
+     * Default search method. Exa defaults to auto when omitted.
+     */
+    type?: ExaSearchType;
+    /**
+     * Default maximum number of results to return (1-100, default: 10).
+     */
+    numResults?: number;
+    /**
+     * Default category filter for result types.
+     */
+    category?: ExaSearchCategory;
+    /**
+     * Default two-letter ISO country code for location-aware search.
+     */
+    userLocation?: string;
+    /**
+     * Default domains to include or exclude.
+     */
+    includeDomains?: string[];
+    excludeDomains?: string[];
+    /**
+     * Default published date filters in ISO 8601 format.
+     */
+    startPublishedDate?: string;
+    endPublishedDate?: string;
+    /**
+     * Default content extraction controls.
+     */
+    contents?: ExaSearchContentsConfig;
+}
+interface ExaSearchResult {
+    title: string;
+    url: string;
+    id: string;
+    publishedDate?: string | null;
+    author?: string | null;
+    image?: string | null;
+    favicon?: string | null;
+    text?: string;
+    highlights?: string[];
+    highlightScores?: number[];
+    summary?: string;
+    subpages?: ExaSearchResult[];
+    extras?: {
+        links?: string[];
+        imageLinks?: string[];
+    };
+}
+interface ExaSearchResponse {
+    requestId: string;
+    searchType?: string;
+    resolvedSearchType?: string;
+    results: ExaSearchResult[];
+    costDollars?: {
+        total?: number;
+        search?: Record<string, number>;
+    };
+}
+interface ExaSearchError {
+    error: 'api_error' | 'rate_limit' | 'timeout' | 'invalid_input' | 'configuration_error' | 'execution_error' | 'unknown';
+    statusCode?: number;
+    message: string;
+}
+interface ExaSearchInput {
+    query: string;
+    type?: ExaSearchType;
+    num_results?: number;
+    category?: ExaSearchCategory;
+    user_location?: string;
+    include_domains?: string[];
+    exclude_domains?: string[];
+    start_published_date?: string;
+    end_published_date?: string;
+    contents?: {
+        text?: boolean | {
+            max_characters?: number;
+            include_html_tags?: boolean;
+            verbosity?: 'compact' | 'standard' | 'full';
+            include_sections?: ExaTextSection[];
+            exclude_sections?: ExaTextSection[];
+        };
+        highlights?: boolean | {
+            query?: string;
+            max_characters?: number;
+        };
+        max_age_hours?: number;
+        livecrawl_timeout?: number;
+        subpages?: number;
+        subpage_target?: string | string[];
+        extras?: {
+            links?: number;
+            image_links?: number;
+        };
+    };
+}
+type ExaSearchOutput = ExaSearchResponse | ExaSearchError;
+declare const exaSearchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<ExaSearchInput, ExaSearchOutput, ExaSearchConfig>;
+
 /**
  * Gateway-specific provider-defined tools.
  */
 declare const 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: (config?: ExaSearchConfig) => ReturnType<typeof exaSearchToolFactory>;
     /**
      * Search the web using Parallel AI's Search API for LLM-optimized excerpts.
      *