@ai-sdk/gateway 4.0.92 → 4.0.94

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @ai-sdk/gateway
 
+## 4.0.94
+
+### Patch Changes
+
+- Updated dependencies [af9597b]
+- Updated dependencies [bc49f78]
+  - @ai-sdk/provider-utils@5.0.49
+
+## 4.0.93
+
+### Patch Changes
+
+- 80b9100: feat (provider/gateway): add Browserbase Search and Fetch tool support
+- d3cc6ae: feat(provider/gateway): accept structured-output in the has provider option
+- Updated dependencies [be877ff]
+  - @ai-sdk/provider-utils@5.0.48
+
 ## 4.0.92
 
 ### Patch Changes

package/dist/index.d.ts

@@ -868,10 +868,130 @@ interface ExaSearchInput {
 type ExaSearchOutput = ExaSearchResponse | ExaSearchError;
 declare const exaSearchToolFactory: _ai_sdk_provider_utils.ProviderExecutedToolFactory<ExaSearchInput, ExaSearchOutput, ExaSearchConfig, {}>;
 
+interface BrowserbaseSearchConfig {
+    /**
+     * Default maximum number of results to return (1-25, default: 10).
+     */
+    numResults?: number;
+}
+interface BrowserbaseSearchInput {
+    /**
+     * Web search query (1-200 characters).
+     */
+    query: string;
+    /**
+     * Maximum number of results to return (1-25, default: 10).
+     */
+    num_results?: number;
+}
+interface BrowserbaseSearchResult {
+    /** Unique identifier for the result. */
+    id: string;
+    /** Title of the search result. */
+    title: string;
+    /** URL of the search result. */
+    url: string;
+    /** Author of the content, when available. */
+    author?: string;
+    /** Favicon URL, when available. */
+    favicon?: string;
+    /** Image URL, when available. */
+    image?: string;
+    /** Publication date in ISO 8601 format, when available. */
+    publishedDate?: string;
+}
+interface BrowserbaseSearchResponse {
+    /** The search query that was executed. */
+    query: string;
+    /** Unique identifier for the request. */
+    requestId: string;
+    /** Search results. */
+    results: BrowserbaseSearchResult[];
+}
+interface BrowserbaseSearchError {
+    error: 'api_error' | 'configuration_error' | 'execution_error' | 'invalid_input' | 'rate_limit' | 'timeout' | 'unknown';
+    statusCode?: number;
+    message: string;
+}
+type BrowserbaseSearchOutput = BrowserbaseSearchError | BrowserbaseSearchResponse;
+declare const browserbaseSearchToolFactory: _ai_sdk_provider_utils.ProviderExecutedToolFactory<BrowserbaseSearchInput, BrowserbaseSearchOutput, BrowserbaseSearchConfig, {}>;
+
+type BrowserbaseFetchFormat = 'raw' | 'json' | 'markdown';
+interface BrowserbaseFetchConfig {
+    /** Whether to follow HTTP redirects (default: false). */
+    allowRedirects?: boolean;
+    /** Whether to bypass TLS certificate verification (default: false). */
+    allowInsecureSsl?: boolean;
+    /** Whether to route the request through Browserbase proxies (default: false). */
+    proxies?: boolean;
+    /** Output format for the response content (default: raw). */
+    format?: BrowserbaseFetchFormat;
+    /**
+     * JSON Schema describing the desired response content. Only used when format
+     * is json.
+     */
+    schema?: Record<string, unknown>;
+}
+interface BrowserbaseFetchInput {
+    /** URL of the page to fetch. */
+    url: string;
+    /** Whether to follow HTTP redirects. */
+    allow_redirects?: boolean;
+    /** Whether to bypass TLS certificate verification. */
+    allow_insecure_ssl?: boolean;
+    /** Whether to route the request through Browserbase proxies. */
+    proxies?: boolean;
+    /** Output format for the response content. */
+    format?: BrowserbaseFetchFormat;
+    /**
+     * JSON Schema describing the desired response content. Only used when format
+     * is json.
+     */
+    schema?: Record<string, unknown>;
+}
+interface BrowserbaseFetchResponse {
+    /** Unique identifier for the fetch request. */
+    id: string;
+    /**
+     * Response body. Raw and markdown responses return strings; JSON extraction
+     * returns an object matching the requested schema.
+     */
+    content: string | Record<string, unknown>;
+    /** MIME type of the response. */
+    contentType: string;
+    /** Character encoding of the response. */
+    encoding: string;
+    /** Response headers from the fetched page. */
+    headers: Record<string, string>;
+    /** HTTP status code returned by the fetched page. */
+    statusCode: number;
+}
+interface BrowserbaseFetchError {
+    error: 'api_error' | 'configuration_error' | 'execution_error' | 'invalid_input' | 'rate_limit' | 'timeout' | 'unknown';
+    statusCode?: number;
+    message: string;
+}
+type BrowserbaseFetchOutput = BrowserbaseFetchError | BrowserbaseFetchResponse;
+declare const browserbaseFetchToolFactory: _ai_sdk_provider_utils.ProviderExecutedToolFactory<BrowserbaseFetchInput, BrowserbaseFetchOutput, BrowserbaseFetchConfig, {}>;
+
 /**
  * Gateway-specific provider-defined tools.
  */
 declare const gatewayTools: {
+    /**
+     * Fetch page content using Browserbase's lightweight Fetch API.
+     *
+     * Supports raw, Markdown, and schema-driven JSON output as well as redirects,
+     * proxy routing, and TLS controls.
+     */
+    browserbaseFetch: (config?: BrowserbaseFetchConfig) => ReturnType<typeof browserbaseFetchToolFactory>;
+    /**
+     * Search the web using Browserbase's Search API for fast, structured results.
+     *
+     * Returns titles, URLs, and available publication metadata without requiring
+     * a browser session.
+     */
+    browserbaseSearch: (config?: BrowserbaseSearchConfig) => ReturnType<typeof browserbaseSearchToolFactory>;
     /**
      * Search the web using Exa for current information and token-efficient
      * excerpts optimized for agent workflows.
@@ -1123,14 +1243,15 @@ type GatewayProviderOptions = {
      * Restrict routing to provider models that satisfy every given entry.
      *
      * Entries are capability tags (`'implicit-caching'`, `'reasoning'`,
-     * `'tool-use'`, `'vision'`) or weight-format conditions: `'quantization:fp8'`
-     * requires the serving provider to report that weight format,
-     * `'!quantization:fp8'` excludes it (providers with no recorded format still
-     * pass an exclusion). Format values are an open space but must match
-     * `[a-zA-Z0-9._-]{1,32}` and compare case-insensitively; unknown capability
-     * names are rejected by the Gateway with a 400.
-     */
-    has?: Array<'implicit-caching' | 'reasoning' | 'tool-use' | 'vision' | `quantization:${string}` | `!quantization:${string}`>;
+     * `'tool-use'`, `'vision'` (image input), `'structured-output'`
+     * (schema-constrained output)) or weight-format conditions:
+     * `'quantization:fp8'` requires the serving provider to report that weight
+     * format, `'!quantization:fp8'` excludes it (providers with no recorded
+     * format still pass an exclusion). Format values are an open space but must
+     * match `[a-zA-Z0-9._-]{1,32}` and compare case-insensitively. Unknown
+     * capability names are rejected by the Gateway with a 400.
+     */
+    has?: Array<'implicit-caching' | 'reasoning' | 'structured-output' | 'tool-use' | 'vision' | `quantization:${string}` | `!quantization:${string}`>;
     /**
      * Idempotency key for `experimental_startBatch`: retries with the same
      * key replay the original batch instead of creating a duplicate.