@broberg/ai-sdk 0.57.0 → 0.58.0

package/dist/index.d.ts

@@ -1,8 +1,74 @@
+import { C as CostSink, T as Tier, U as Usage, a as ChatResult, b as ChatStreamEvent, c as TranslateResult, I as ImageResult, A as AnimateResult, d as TrainStyleResult, E as EmbeddingResult, e as TranscribeResult, O as OcrResult, M as ModerationResult, J as JudgeResult, P as PodcastResult, B as BatchRequestItem, f as TierSpec, g as BatchJob, h as BatchResultItem, i as ProviderAdapter, j as ToolCall, k as Tool, l as Transport, m as Capability, R as Region, n as BudgetConfig, o as BudgetStore } from './registry-VqJrONWk.js';
+export { p as AlignedWordTimings, q as AvailabilitySource, r as AvailabilityStatus, s as AzureWordBoundary, t as CallOptions, u as ChatRequest, v as ContentPart, D as DialogueRequest, w as DialogueTurn, x as EmbeddingRequest, y as ImageRequest, z as JudgeAnswer, F as JudgeChoiceAnswer, G as JudgeNoulAnswer, H as JudgeQuestion, K as JudgeScoreAnswer, L as LoraWeight, N as Message, Q as ModelStatus, S as ModelUnavailableError, V as ModerationItem, W as ModerationRequest, X as OcrPage, Y as OcrRequest, Z as ResolveOptions, _ as ResolveResult, $ as Role, a0 as TierDescription, a1 as TrainStyleRequest, a2 as TranscribeRequest, a3 as TtsRequest, a4 as WordTiming, a5 as alignWordTimings, a6 as classifyRegionName, a7 as describeTier, a8 as listModels, a9 as regionOfHost, aa as regionOfProvider, ab as resolveModel } from './registry-VqJrONWk.js';
 import { z } from 'zod';
-import { T as Tier, U as Usage, C as ChatResult, a as ChatStreamEvent, b as TranslateResult, I as ImageResult, A as AnimateResult, c as TrainStyleResult, E as EmbeddingResult, d as TranscribeResult, O as OcrResult, M as ModerationResult, J as JudgeResult, P as PodcastResult, B as BatchRequestItem, e as TierSpec, f as BatchJob, g as BatchResultItem, h as ProviderAdapter, i as CostSink, j as ToolCall, k as Tool, l as Transport, m as Capability, R as Region, n as BudgetConfig, o as BudgetStore } from './registry-U66vzTm0.js';
-export { p as AlignedWordTimings, q as AvailabilitySource, r as AvailabilityStatus, s as AzureWordBoundary, t as CallOptions, u as ChatRequest, v as ContentPart, D as DialogueRequest, w as DialogueTurn, x as EmbeddingRequest, y as ImageRequest, z as JudgeAnswer, F as JudgeChoiceAnswer, G as JudgeNoulAnswer, H as JudgeQuestion, K as JudgeScoreAnswer, L as LoraWeight, N as Message, Q as ModelStatus, S as ModelUnavailableError, V as ModerationItem, W as ModerationRequest, X as OcrPage, Y as OcrRequest, Z as ResolveOptions, _ as ResolveResult, $ as Role, a0 as TierDescription, a1 as TrainStyleRequest, a2 as TranscribeRequest, a3 as TtsRequest, a4 as WordTiming, a5 as alignWordTimings, a6 as classifyRegionName, a7 as describeTier, a8 as listModels, a9 as regionOfHost, aa as regionOfProvider, ab as resolveModel } from './registry-U66vzTm0.js';
 export { DEFAULT_CLIP_SEC, MEDIA_PRICING_CHECKED_AT, MediaPrice, MediaUnit, PRICING_STALE_AFTER_DAYS, PricingFreshness, UnitFreshness, getMediaPrice, listMediaPrices, pricingFreshness, pricingGeneratedAt } from './pricing.js';
 
+type SearchProviderId = "brave" | "cloudflare:ceramic" | "cloudflare:linkup" | "cloudflare:exa";
+/** Why the search runs — picks the route and the cache lifetime (F078.2). */
+type SearchPurpose = "agent" | "grounding" | "discovery" | "monitor";
+interface SearchRequest {
+    query: string;
+    /** BCP-47-ish language of the query ("da", "en"). Routing input (F078.2); Brave also filters on it. */
+    lang?: string;
+    /** Country hint for providers that filter on it (Brave: "DK"). */
+    country?: string;
+    /** Max results. Cloudflare caps at 10. */
+    limit?: number;
+    /** Omit to let the router choose (F078.2). Set to force one provider — the only way to reach Exa. */
+    provider?: SearchProviderId;
+    purpose?: SearchPurpose;
+    /** Results must be recent / news-like — routes to Brave, the only provider with freshness filters. */
+    fresh?: boolean;
+    /** Only Zero-Data-Retention providers (customer data in the query). Excludes Exa and Brave. */
+    zdr?: boolean;
+    /** Attribution on the cost-sink row, e.g. { tenantId }. */
+    labels?: Record<string, string>;
+}
+interface SearchItem {
+    title: string;
+    url: string;
+    description: string;
+    provider: SearchProviderId;
+    lang?: string;
+    /** ISO timestamp when the provider reports one (Brave does; Cloudflare's providers do not). */
+    publishedAt?: string;
+}
+interface SearchResult {
+    items: SearchItem[];
+    meta: {
+        provider: SearchProviderId;
+        latencyMs: number;
+        cached: boolean;
+        costUsd: number;
+        requestId?: string;
+    };
+}
+interface SearchCredentials {
+    braveApiKey?: string;
+    cloudflareAccountId?: string;
+    cloudflareApiToken?: string;
+}
+interface SearchCache {
+    get(key: string): SearchResult | undefined;
+    set(key: string, value: SearchResult, ttlMs: number): void;
+}
+interface SearchOptions {
+    /** false = no cache. Default: one in-process memory cache shared by all calls. */
+    cache?: SearchCache | false;
+    /** Where each call (and each failed attempt) is recorded. ai.search() passes the client's sink. */
+    costSink?: CostSink;
+    /** Explicit keys (BYOK); missing fields fall back to env. */
+    credentials?: SearchCredentials;
+    /** Injectable fetch (tests, proxies) — same contract as the model adapters (F073). */
+    fetch?: typeof fetch;
+}
+/** Thrown before any request when the provider's key is absent — names the env var to set. */
+declare class SearchKeyMissingError extends Error {
+    readonly provider: SearchProviderId;
+    readonly envVar: string;
+    constructor(provider: SearchProviderId, envVar: string);
+}
+
 interface MockupInput {
     description: string;
     constraints?: string;
@@ -422,6 +488,8 @@ declare const chatInputSchema: z.ZodObject<{
     responseFormat: z.ZodOptional<z.ZodEnum<["json", "text"]>>;
 }, "strip", z.ZodTypeAny, {
     system?: string | undefined;
+    purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
     tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     prompt?: string | undefined;
     messages?: {
@@ -449,7 +517,6 @@ declare const chatInputSchema: z.ZodObject<{
         description: string;
     }[] | undefined;
     temperature?: number | undefined;
-    purpose?: string | undefined;
     promptCacheKey?: string | undefined;
     promptCache?: boolean | undefined;
     maxTokens?: number | undefined;
@@ -466,9 +533,10 @@ declare const chatInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
 }, {
     system?: string | undefined;
+    purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
     tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     prompt?: string | undefined;
     messages?: {
@@ -496,7 +564,6 @@ declare const chatInputSchema: z.ZodObject<{
         description: string;
     }[] | undefined;
     temperature?: number | undefined;
-    purpose?: string | undefined;
     promptCacheKey?: string | undefined;
     promptCache?: boolean | undefined;
     maxTokens?: number | undefined;
@@ -513,7 +580,6 @@ declare const chatInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
 }>;
 declare const visionInputSchema: z.ZodObject<{
     tier: z.ZodOptional<z.ZodEnum<["fast", "smart", "powerful", "cheap", "vision", "video", "embedding"]>>;
@@ -556,9 +622,10 @@ declare const visionInputSchema: z.ZodObject<{
     image: string | Uint8Array<ArrayBuffer>;
     prompt: string;
     system?: string | undefined;
+    purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
     tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     mimeType?: string | undefined;
-    purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -570,14 +637,14 @@ declare const visionInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
 }, {
     image: string | Uint8Array<ArrayBuffer>;
     prompt: string;
     system?: string | undefined;
+    purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
     tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     mimeType?: string | undefined;
-    purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -589,7 +656,6 @@ declare const visionInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
 }>;
 declare const videoInputSchema: z.ZodObject<{
     tier: z.ZodOptional<z.ZodEnum<["fast", "smart", "powerful", "cheap", "vision", "video", "embedding"]>>;
@@ -631,9 +697,10 @@ declare const videoInputSchema: z.ZodObject<{
     video: string | Uint8Array<ArrayBuffer>;
     prompt: string;
     system?: string | undefined;
+    purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
     tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     mimeType?: string | undefined;
-    purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -645,14 +712,14 @@ declare const videoInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
 }, {
     video: string | Uint8Array<ArrayBuffer>;
     prompt: string;
     system?: string | undefined;
+    purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
     tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     mimeType?: string | undefined;
-    purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -664,7 +731,6 @@ declare const videoInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
 }>;
 declare const translateInputSchema: z.ZodObject<{
     tier: z.ZodOptional<z.ZodEnum<["fast", "smart", "powerful", "cheap", "vision", "video", "embedding"]>>;
@@ -703,8 +769,9 @@ declare const translateInputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     text: string;
     to: string;
-    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -716,13 +783,13 @@ declare const translateInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
     from?: string | undefined;
 }, {
     text: string;
     to: string;
-    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -734,7 +801,6 @@ declare const translateInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
     from?: string | undefined;
 }>;
 declare const imageInputSchema: z.ZodObject<{
@@ -802,9 +868,10 @@ declare const imageInputSchema: z.ZodObject<{
     retryOnBlack: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     prompt: string;
+    purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
     tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     seed?: number | undefined;
-    purpose?: string | undefined;
     outputFormat?: "jpeg" | "png" | "webp" | undefined;
     loras?: {
         path: string;
@@ -824,7 +891,6 @@ declare const imageInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
     finetune?: string | undefined;
     finetuneStrength?: number | undefined;
     referenceImages?: (string | Uint8Array<ArrayBuffer>)[] | undefined;
@@ -832,9 +898,10 @@ declare const imageInputSchema: z.ZodObject<{
     retryOnBlack?: boolean | undefined;
 }, {
     prompt: string;
+    purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
     tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     seed?: number | undefined;
-    purpose?: string | undefined;
     outputFormat?: "jpeg" | "png" | "webp" | undefined;
     loras?: {
         path: string;
@@ -854,7 +921,6 @@ declare const imageInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
     finetune?: string | undefined;
     finetuneStrength?: number | undefined;
     referenceImages?: (string | Uint8Array<ArrayBuffer>)[] | undefined;
@@ -903,10 +969,11 @@ declare const animateInputSchema: z.ZodObject<{
     resolution: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     image: string | Uint8Array<ArrayBuffer>;
+    purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
     tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     prompt?: string | undefined;
     resolution?: string | undefined;
-    purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -918,14 +985,14 @@ declare const animateInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
     durationSec?: number | undefined;
 }, {
     image: string | Uint8Array<ArrayBuffer>;
+    purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
     tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     prompt?: string | undefined;
     resolution?: string | undefined;
-    purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -937,7 +1004,6 @@ declare const animateInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
     durationSec?: number | undefined;
 }>;
 declare const trainStyleInputSchema: z.ZodObject<{
@@ -980,8 +1046,9 @@ declare const trainStyleInputSchema: z.ZodObject<{
     createMasks: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     images: string | string[];
-    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     steps?: number | undefined;
     override?: {
         provider?: string | undefined;
@@ -994,14 +1061,14 @@ declare const trainStyleInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
     isStyle?: boolean | undefined;
     triggerWord?: string | undefined;
     createMasks?: boolean | undefined;
 }, {
     images: string | string[];
-    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     steps?: number | undefined;
     override?: {
         provider?: string | undefined;
@@ -1014,7 +1081,6 @@ declare const trainStyleInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
     isStyle?: boolean | undefined;
     triggerWord?: string | undefined;
     createMasks?: boolean | undefined;
@@ -1053,8 +1119,9 @@ declare const embeddingInputSchema: z.ZodObject<{
     text: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
 }, "strip", z.ZodTypeAny, {
     text: string | string[];
-    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -1066,11 +1133,11 @@ declare const embeddingInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
 }, {
     text: string | string[];
-    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -1082,7 +1149,6 @@ declare const embeddingInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
 }>;
 declare const transcribeInputSchema: z.ZodObject<{
     tier: z.ZodOptional<z.ZodEnum<["fast", "smart", "powerful", "cheap", "vision", "video", "embedding"]>>;
@@ -1129,9 +1195,10 @@ declare const transcribeInputSchema: z.ZodObject<{
     timestamps: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["word", "segment"]>, z.ZodArray<z.ZodEnum<["word", "segment"]>, "many">]>>;
 }, "strip", z.ZodTypeAny, {
     audio: string | Uint8Array<ArrayBuffer>;
+    purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
     tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     language?: string | undefined;
-    purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -1143,15 +1210,15 @@ declare const transcribeInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
     durationSec?: number | undefined;
     phrases?: string[] | undefined;
     timestamps?: "word" | "segment" | ("word" | "segment")[] | undefined;
 }, {
     audio: string | Uint8Array<ArrayBuffer>;
+    purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
     tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     language?: string | undefined;
-    purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -1163,7 +1230,6 @@ declare const transcribeInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
     durationSec?: number | undefined;
     phrases?: string[] | undefined;
     timestamps?: "word" | "segment" | ("word" | "segment")[] | undefined;
@@ -1205,9 +1271,10 @@ declare const ocrInputSchema: z.ZodObject<{
     mimeType: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     document: string | Uint8Array<ArrayBuffer>;
+    purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
     tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     mimeType?: string | undefined;
-    purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -1219,12 +1286,12 @@ declare const ocrInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
 }, {
     document: string | Uint8Array<ArrayBuffer>;
+    purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
     tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     mimeType?: string | undefined;
-    purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -1236,7 +1303,6 @@ declare const ocrInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
 }>;
 declare const moderationInputSchema: z.ZodObject<{
     tier: z.ZodOptional<z.ZodEnum<["fast", "smart", "powerful", "cheap", "vision", "video", "embedding"]>>;
@@ -1272,8 +1338,9 @@ declare const moderationInputSchema: z.ZodObject<{
     input: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
 }, "strip", z.ZodTypeAny, {
     input: string | string[];
-    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -1285,11 +1352,11 @@ declare const moderationInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
 }, {
     input: string | string[];
-    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -1301,7 +1368,6 @@ declare const moderationInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
 }>;
 declare const judgeInputSchema: z.ZodObject<{
     tier: z.ZodOptional<z.ZodEnum<["fast", "smart", "powerful", "cheap", "vision", "video", "embedding"]>>;
@@ -1435,8 +1501,9 @@ declare const judgeInputSchema: z.ZodObject<{
         instructions: string | unknown[] | Record<string, unknown> | null;
         criteria: (string | unknown[] | Record<string, unknown> | null)[];
     }>;
-    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -1448,7 +1515,6 @@ declare const judgeInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
 }, {
     state: string | string[] | Record<string, unknown>;
     questions: Record<string, {
@@ -1467,8 +1533,9 @@ declare const judgeInputSchema: z.ZodObject<{
         instructions: string | unknown[] | Record<string, unknown> | null;
         criteria: (string | unknown[] | Record<string, unknown> | null)[];
     }>;
-    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -1480,7 +1547,6 @@ declare const judgeInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
 }>;
 declare const podcastInputSchema: z.ZodObject<{
     tier: z.ZodOptional<z.ZodEnum<["fast", "smart", "powerful", "cheap", "vision", "video", "embedding"]>>;
@@ -1538,15 +1604,15 @@ declare const podcastInputSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         word: string;
         matchInCompounds?: boolean | undefined;
+        lang?: string | undefined;
         alias?: string | undefined;
         ipa?: string | undefined;
-        lang?: string | undefined;
     }, {
         word: string;
         matchInCompounds?: boolean | undefined;
+        lang?: string | undefined;
         alias?: string | undefined;
         ipa?: string | undefined;
-        lang?: string | undefined;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     script: {
@@ -1554,14 +1620,15 @@ declare const podcastInputSchema: z.ZodObject<{
         speaker: string;
     }[];
     voices: Record<string, string>;
-    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     pronunciations?: {
         word: string;
         matchInCompounds?: boolean | undefined;
+        lang?: string | undefined;
         alias?: string | undefined;
         ipa?: string | undefined;
-        lang?: string | undefined;
     }[] | undefined;
     override?: {
         provider?: string | undefined;
@@ -1574,7 +1641,6 @@ declare const podcastInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
     format?: string | undefined;
 }, {
     script: {
@@ -1582,14 +1648,15 @@ declare const podcastInputSchema: z.ZodObject<{
         speaker: string;
     }[];
     voices: Record<string, string>;
-    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     pronunciations?: {
         word: string;
         matchInCompounds?: boolean | undefined;
+        lang?: string | undefined;
         alias?: string | undefined;
         ipa?: string | undefined;
-        lang?: string | undefined;
     }[] | undefined;
     override?: {
         provider?: string | undefined;
@@ -1602,7 +1669,6 @@ declare const podcastInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
     format?: string | undefined;
 }>;
 declare const ttsInputSchema: z.ZodObject<{
@@ -1650,15 +1716,15 @@ declare const ttsInputSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         word: string;
         matchInCompounds?: boolean | undefined;
+        lang?: string | undefined;
         alias?: string | undefined;
         ipa?: string | undefined;
-        lang?: string | undefined;
     }, {
         word: string;
         matchInCompounds?: boolean | undefined;
+        lang?: string | undefined;
         alias?: string | undefined;
         ipa?: string | undefined;
-        lang?: string | undefined;
     }>, "many">>;
     /** F055 — per-word timings (Azure only). Changes the route to batch synthesis. */
     wordTimings: z.ZodOptional<z.ZodBoolean>;
@@ -1679,15 +1745,17 @@ declare const ttsInputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     text: string;
     voice: string;
-    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
+    lang?: string | undefined;
     purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     wordTimings?: boolean | undefined;
     pronunciations?: {
         word: string;
         matchInCompounds?: boolean | undefined;
+        lang?: string | undefined;
         alias?: string | undefined;
         ipa?: string | undefined;
-        lang?: string | undefined;
     }[] | undefined;
     override?: {
         provider?: string | undefined;
@@ -1700,23 +1768,23 @@ declare const ttsInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
-    lang?: string | undefined;
     format?: string | undefined;
     voiceFallback?: string | undefined;
     rate?: number | undefined;
 }, {
     text: string;
     voice: string;
-    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
+    lang?: string | undefined;
     purpose?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     wordTimings?: boolean | undefined;
     pronunciations?: {
         word: string;
         matchInCompounds?: boolean | undefined;
+        lang?: string | undefined;
         alias?: string | undefined;
         ipa?: string | undefined;
-        lang?: string | undefined;
     }[] | undefined;
     override?: {
         provider?: string | undefined;
@@ -1729,8 +1797,6 @@ declare const ttsInputSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     })[] | undefined;
     allowFloating?: boolean | undefined;
-    labels?: Record<string, string> | undefined;
-    lang?: string | undefined;
     format?: string | undefined;
     voiceFallback?: string | undefined;
     rate?: number | undefined;
@@ -1786,8 +1852,8 @@ declare const aiConfigSchema: z.ZodObject<{
         autoResolve?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    promptCache?: boolean | undefined;
     labels?: Record<string, string> | undefined;
+    promptCache?: boolean | undefined;
     byok?: boolean | undefined;
     strictPinning?: boolean | undefined;
     defaults?: Partial<Record<"vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap", {
@@ -1806,8 +1872,8 @@ declare const aiConfigSchema: z.ZodObject<{
         autoResolve?: boolean | undefined;
     } | undefined;
 }, {
-    promptCache?: boolean | undefined;
     labels?: Record<string, string> | undefined;
+    promptCache?: boolean | undefined;
     byok?: boolean | undefined;
     strictPinning?: boolean | undefined;
     defaults?: Partial<Record<"vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap", {
@@ -1871,6 +1937,9 @@ interface AiClient {
     /** Judge (F066) — typed yes/no, choice and score decisions with calibrated
      *  probabilities. TypeSafe Jev. US-hosted: NOT for personal data. */
     judge(input: JudgeInput): Promise<JudgeResult>;
+    /** F078 — web search through ai-sdk; reports every call to this client's cost sink
+     *  with the client's labels. Same request/result as the standalone `search()`. */
+    search(req: SearchRequest, opts?: Omit<SearchOptions, "costSink">): Promise<SearchResult>;
     /** Podcast (F020) — a finished manuscript → one multi-voice audio episode. ElevenLabs. */
     podcast(input: PodcastInput): Promise<PodcastResult>;
     /** Single-voice TTS (F020.4) — text → audio. `voice` = curated name or voiceId. ElevenLabs. */
@@ -2232,8 +2301,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.57.0";
-declare const SDK_TAG: "@broberg/ai-sdk@0.57.0";
+declare const VERSION: "0.58.0";
+declare const SDK_TAG: "@broberg/ai-sdk@0.58.0";
 
 /** Built-in defaults. Every entry is overridable via AiConfig.defaults or a
  *  per-call override.
@@ -2758,57 +2827,26 @@ interface StreamTransportRequest extends TransportRequest {
  */
 declare function streamTransport(req: StreamTransportRequest): AsyncIterable<string>;
 
-type SearchProviderId = "brave" | "cloudflare:ceramic" | "cloudflare:linkup" | "cloudflare:exa";
-interface SearchRequest {
-    query: string;
-    /** BCP-47-ish language of the query ("da", "en"). Routing input (F078.2); Brave also filters on it. */
-    lang?: string;
-    /** Country hint for providers that filter on it (Brave: "DK"). */
-    country?: string;
-    /** Max results. Cloudflare caps at 10. */
-    limit?: number;
-    /** F078.1: required until the router (F078.2) can choose. */
-    provider: SearchProviderId;
-}
-interface SearchItem {
-    title: string;
-    url: string;
-    description: string;
-    provider: SearchProviderId;
-    lang?: string;
-    /** ISO timestamp when the provider reports one (Brave does; Cloudflare's providers do not). */
-    publishedAt?: string;
-}
-interface SearchResult {
-    items: SearchItem[];
-    meta: {
-        provider: SearchProviderId;
-        latencyMs: number;
-        cached: boolean;
-        costUsd: number;
-        requestId?: string;
+declare const SEARCH_PRICE_USD: Record<SearchProviderId, number>;
+
+interface SearchRoute {
+    /** Readable name — shows up in tests and in the reason a provider was picked. */
+    name: string;
+    when: {
+        fresh?: boolean;
+        english?: boolean;
+        purpose?: SearchRequest["purpose"][];
     };
+    chain: SearchProviderId[];
 }
-interface SearchCredentials {
-    braveApiKey?: string;
-    cloudflareAccountId?: string;
-    cloudflareApiToken?: string;
-}
-interface SearchOptions {
-    /** Explicit keys (BYOK); missing fields fall back to env. */
-    credentials?: SearchCredentials;
-    /** Injectable fetch (tests, proxies) — same contract as the model adapters (F073). */
-    fetch?: typeof fetch;
-}
-/** Thrown before any request when the provider's key is absent — names the env var to set. */
-declare class SearchKeyMissingError extends Error {
-    readonly provider: SearchProviderId;
-    readonly envVar: string;
-    constructor(provider: SearchProviderId, envVar: string);
-}
+declare const DEFAULT_SEARCH_ROUTES: SearchRoute[];
+/** Providers that keep no data (Cloudflare docs, 2026-10-09). Brave's standard plan logs 90 days. */
+declare const ZDR_PROVIDERS: Set<SearchProviderId>;
+declare function routeSearch(req: SearchRequest, routes?: SearchRoute[]): SearchProviderId[];
 
-declare const SEARCH_PRICE_USD: Record<SearchProviderId, number>;
+declare const SEARCH_CACHE_TTL_MS: Record<NonNullable<SearchRequest["purpose"]>, number>;
+declare function memorySearchCache(max?: number): SearchCache;
 
 declare function search(req: SearchRequest, opts?: SearchOptions): Promise<SearchResult>;
 
-export { AZURE_DANISH_VOICES, AZURE_DANISH_VOICE_LIST, type AiClient, type AiConfig, type AzureVoiceInfo, BatchJob, BatchRequestItem, BatchResultItem, type BflAdapterConfig, type BflCredits, BudgetConfig, BudgetExceededError, BudgetGuard, BudgetStore, CONFIG_DERIVED_HOSTS, Capability, type ChatInput, ChatResult, ChatStreamEvent, type CheckVoiceOptions, type ClassifyInput, type ClassifyResult, type Contracts, type CostQuery, CostSink, type CostSummary, type CostSummaryQuery, type CostTimeseriesQuery, DEFAULT_BASE_URLS, DEFAULT_TIER_MAP, type DesignInput, type DesignResult, type DiscordSinkConfig, ELEVENLABS_DANISH_VOICES, type EmbeddingInput, EmbeddingResult, type ExtractInput, type ExtractResult, type FalAdapterConfig, type FixedHostProvider, type HttpResponse, type ImageInput, ImageResult, type JudgeInput, JudgeResult, LOCALLY_PINNED_HOSTS, type MockupInput, type MockupResult, type ModerationInput, ModerationResult, type OcrInput, OcrResult, type OpenAICompatibleConfig, type PodcastInput, PodcastResult, type PriceDriftResult, type PriceDriftRow, type PricingEntry, ProviderAdapter, type RefreshOptions, type RefreshResult, Region, type RerankInput, type RerankResult, type RouteForecast, SDK_TAG, SEARCH_PRICE_USD, type SearchCredentials, type SearchItem, SearchKeyMissingError, type SearchOptions, type SearchProviderId, type SearchRequest, type SearchResult, type SqliteBudgetStoreConfig, type SqliteSinkConfig, StreamHttpError, type SubprocessResponse, Tier, TierSpec, Tool, ToolCall, type TrainStyleInput, TrainStyleResult, type TranscribeInput, TranscribeResult, type TranslateInput, TranslateResult, Transport, type TransportRequest, type TransportResponse, type TtsInput, type UpmetricsCostClientConfig, UpmetricsCostError, type UpmetricsCostRow, type UpmetricsCostSummary, type UpmetricsCostTimeseries, type UpmetricsSink, type UpmetricsSinkConfig, type UpmetricsSinkStats, Usage, VERSION, type VideoInput, type VisionInput, type VoiceInfo, type VoiceProvider, type VoiceResolveResult, type VoiceStatus, VoiceUnavailableError, aiConfigSchema, anthropicAdapter, anthropicApiAdapter, anthropicSubprocessAdapter, azureAdapter, bflAdapter, bflCredits, byokAdapter, chatInputSchema, checkPriceDrift, checkVoice, computeCost, createAI, deepinfraAdapter, deeplAdapter, deepseekAdapter, defaultBaseUrl, defaultProviders, discordSink, elevenlabsAdapter, embeddingInputSchema, falAdapter, falStubAdapter, freshUsage, fromProviderToolCall, geminiAdapter, getCostSummary, getPrice, httpTransport, imageInputSchema, isByokKeyed, listAzureDanishVoices, listVoices, makeContracts, makeOpenAICompatibleAdapter, matchLabel, messageSchema, mistralAdapter, mistralStubAdapter, multiSink, noopSink, openaiAdapter, openaiStubAdapter, openrouterAdapter, parseClaudeCliJson, parseJsonLoose, refreshAvailability, requestyAdapter, resetRefreshState, resetRegistry, resolveAzureVoice, resolveTier, resolveVoice, search, sqliteBudgetStore, sqliteSink, streamTransport, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, typesafeAdapter, upmetricsCostClient, upmetricsSink, usdFromMicro, vertexAdapter, visionInputSchema, wouldProviderRouteTo, wouldRouteTo };
+export { AZURE_DANISH_VOICES, AZURE_DANISH_VOICE_LIST, type AiClient, type AiConfig, type AzureVoiceInfo, BatchJob, BatchRequestItem, BatchResultItem, type BflAdapterConfig, type BflCredits, BudgetConfig, BudgetExceededError, BudgetGuard, BudgetStore, CONFIG_DERIVED_HOSTS, Capability, type ChatInput, ChatResult, ChatStreamEvent, type CheckVoiceOptions, type ClassifyInput, type ClassifyResult, type Contracts, type CostQuery, CostSink, type CostSummary, type CostSummaryQuery, type CostTimeseriesQuery, DEFAULT_BASE_URLS, DEFAULT_SEARCH_ROUTES, DEFAULT_TIER_MAP, type DesignInput, type DesignResult, type DiscordSinkConfig, ELEVENLABS_DANISH_VOICES, type EmbeddingInput, EmbeddingResult, type ExtractInput, type ExtractResult, type FalAdapterConfig, type FixedHostProvider, type HttpResponse, type ImageInput, ImageResult, type JudgeInput, JudgeResult, LOCALLY_PINNED_HOSTS, type MockupInput, type MockupResult, type ModerationInput, ModerationResult, type OcrInput, OcrResult, type OpenAICompatibleConfig, type PodcastInput, PodcastResult, type PriceDriftResult, type PriceDriftRow, type PricingEntry, ProviderAdapter, type RefreshOptions, type RefreshResult, Region, type RerankInput, type RerankResult, type RouteForecast, SDK_TAG, SEARCH_CACHE_TTL_MS, SEARCH_PRICE_USD, type SearchCache, type SearchCredentials, type SearchItem, SearchKeyMissingError, type SearchOptions, type SearchProviderId, type SearchPurpose, type SearchRequest, type SearchResult, type SearchRoute, type SqliteBudgetStoreConfig, type SqliteSinkConfig, StreamHttpError, type SubprocessResponse, Tier, TierSpec, Tool, ToolCall, type TrainStyleInput, TrainStyleResult, type TranscribeInput, TranscribeResult, type TranslateInput, TranslateResult, Transport, type TransportRequest, type TransportResponse, type TtsInput, type UpmetricsCostClientConfig, UpmetricsCostError, type UpmetricsCostRow, type UpmetricsCostSummary, type UpmetricsCostTimeseries, type UpmetricsSink, type UpmetricsSinkConfig, type UpmetricsSinkStats, Usage, VERSION, type VideoInput, type VisionInput, type VoiceInfo, type VoiceProvider, type VoiceResolveResult, type VoiceStatus, VoiceUnavailableError, ZDR_PROVIDERS, aiConfigSchema, anthropicAdapter, anthropicApiAdapter, anthropicSubprocessAdapter, azureAdapter, bflAdapter, bflCredits, byokAdapter, chatInputSchema, checkPriceDrift, checkVoice, computeCost, createAI, deepinfraAdapter, deeplAdapter, deepseekAdapter, defaultBaseUrl, defaultProviders, discordSink, elevenlabsAdapter, embeddingInputSchema, falAdapter, falStubAdapter, freshUsage, fromProviderToolCall, geminiAdapter, getCostSummary, getPrice, httpTransport, imageInputSchema, isByokKeyed, listAzureDanishVoices, listVoices, makeContracts, makeOpenAICompatibleAdapter, matchLabel, memorySearchCache, messageSchema, mistralAdapter, mistralStubAdapter, multiSink, noopSink, openaiAdapter, openaiStubAdapter, openrouterAdapter, parseClaudeCliJson, parseJsonLoose, refreshAvailability, requestyAdapter, resetRefreshState, resetRegistry, resolveAzureVoice, resolveTier, resolveVoice, routeSearch, search, sqliteBudgetStore, sqliteSink, streamTransport, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, typesafeAdapter, upmetricsCostClient, upmetricsSink, usdFromMicro, vertexAdapter, visionInputSchema, wouldProviderRouteTo, wouldRouteTo };