@broberg/ai-sdk 0.59.1 → 0.61.0

package/dist/index.d.ts

@@ -3,7 +3,8 @@ export { p as AlignedWordTimings, q as AvailabilitySource, r as AvailabilityStat
 import { z } from 'zod';
 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";
+/** `tavily` is CMS-legacy only (F078.5): reachable by explicit provider, never routed to. */
+type SearchProviderId = "brave" | "cloudflare:ceramic" | "cloudflare:linkup" | "cloudflare:exa" | "tavily";
 /** Why the search runs — picks the route and the cache lifetime (F078.2). */
 type SearchPurpose = "agent" | "grounding" | "discovery" | "monitor";
 interface SearchRequest {
@@ -47,6 +48,7 @@ interface SearchCredentials {
     braveApiKey?: string;
     cloudflareAccountId?: string;
     cloudflareApiToken?: string;
+    tavilyApiKey?: string;
 }
 interface SearchCache {
     get(key: string): SearchResult | undefined;
@@ -1882,8 +1884,9 @@ declare const aiConfigSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     labels?: Record<string, string> | undefined;
-    promptCache?: boolean | undefined;
+    costSink?: CostSink | null | undefined;
     byok?: boolean | undefined;
+    promptCache?: boolean | undefined;
     strictPinning?: boolean | undefined;
     defaults?: Partial<Record<"vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap", {
         provider: string;
@@ -1891,7 +1894,6 @@ declare const aiConfigSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     }>> | undefined;
     providers?: Record<string, ProviderAdapter> | undefined;
-    costSink?: CostSink | null | undefined;
     budget?: {
         perCallUsd?: number | undefined;
         rollingUsd?: number | undefined;
@@ -1902,8 +1904,9 @@ declare const aiConfigSchema: z.ZodObject<{
     } | undefined;
 }, {
     labels?: Record<string, string> | undefined;
-    promptCache?: boolean | undefined;
+    costSink?: CostSink | null | undefined;
     byok?: boolean | undefined;
+    promptCache?: boolean | undefined;
     strictPinning?: boolean | undefined;
     defaults?: Partial<Record<"vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap", {
         provider: string;
@@ -1911,7 +1914,6 @@ declare const aiConfigSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     }>> | undefined;
     providers?: Record<string, ProviderAdapter> | undefined;
-    costSink?: CostSink | null | undefined;
     budget?: {
         perCallUsd?: number | undefined;
         rollingUsd?: number | undefined;
@@ -2330,8 +2332,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.59.1";
-declare const SDK_TAG: "@broberg/ai-sdk@0.59.1";
+declare const VERSION: "0.61.0";
+declare const SDK_TAG: "@broberg/ai-sdk@0.61.0";
 
 /** Built-in defaults. Every entry is overridable via AiConfig.defaults or a
  *  per-call override.
@@ -2858,6 +2860,25 @@ declare function streamTransport(req: StreamTransportRequest): AsyncIterable<str
 
 declare const SEARCH_PRICE_USD: Record<SearchProviderId, number>;
 
+declare const webSearchTool: Tool;
+/** What the app decides — never the model. */
+interface WebSearchContext extends SearchOptions {
+    /** Customer data may be in the query: only Zero-Data-Retention providers. */
+    zdr?: boolean;
+    /** Attribution, e.g. { tenantId } — also selects the tenant's daily cap. */
+    labels?: Record<string, string>;
+}
+interface WebSearchToolResult {
+    provider: string;
+    results: {
+        title: string;
+        url: string;
+        snippet: string;
+    }[];
+}
+/** Run a `web_search` tool call. Throws on invalid arguments before any request. */
+declare function runWebSearch(args: Record<string, unknown>, ctx?: WebSearchContext): Promise<WebSearchToolResult>;
+
 interface SearchRoute {
     /** Readable name — shows up in tests and in the reason a provider was picked. */
     name: string;
@@ -2878,4 +2899,4 @@ 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_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, SearchBudgetExceededError, type SearchCache, type SearchCapStore, 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 };
+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, SearchBudgetExceededError, type SearchCache, type SearchCapStore, 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, type WebSearchContext, type WebSearchToolResult, 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, runWebSearch, search, sqliteBudgetStore, sqliteSink, streamTransport, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, typesafeAdapter, upmetricsCostClient, upmetricsSink, usdFromMicro, vertexAdapter, visionInputSchema, webSearchTool, wouldProviderRouteTo, wouldRouteTo };

package/dist/index.js

@@ -72,12 +72,37 @@ async function cloudflareSearch(req, creds, f) {
   return { items, requestId: inner.metadata?.requestId };
 }
 
+// src/search/tavily.ts
+async function tavilySearch(req, apiKey, f) {
+  const res = await f("https://api.tavily.com/search", {
+    method: "POST",
+    headers: { authorization: `Bearer ${apiKey}`, "content-type": "application/json" },
+    body: JSON.stringify({ query: req.query, max_results: Math.min(req.limit ?? 10, 20), search_depth: "basic" })
+  });
+  if (!res.ok) throw Object.assign(new Error(`tavily search: HTTP ${res.status} ${(await res.text()).slice(0, 200)}`), { status: res.status });
+  const body = await res.json();
+  const items = (body.results ?? []).map((r) => {
+    const published = r.published_date ? new Date(r.published_date) : void 0;
+    return {
+      title: r.title ?? "",
+      url: r.url ?? "",
+      description: r.content ?? "",
+      provider: "tavily",
+      ...published && !Number.isNaN(published.getTime()) ? { publishedAt: published.toISOString() } : {}
+    };
+  });
+  return { items, ...body.request_id ? { requestId: body.request_id } : {} };
+}
+
 // src/search/prices.ts
 var SEARCH_PRICE_USD = {
   "cloudflare:ceramic": 25e-5,
   "cloudflare:linkup": 5e-3,
   "cloudflare:exa": 7e-3,
-  brave: 5e-3
+  brave: 5e-3,
+  // 1 credit per basic search; $0.0075/credit on the entry plan, less on bigger plans
+  // (docs.tavily.com/documentation/api-credits, 2026-10-09).
+  tavily: 75e-4
 };
 
 // src/search/router.ts
@@ -102,7 +127,7 @@ function routeSearch(req, routes = DEFAULT_SEARCH_ROUTES) {
     (r) => (r.when.fresh === void 0 || r.when.fresh === fresh) && (r.when.english === void 0 || r.when.english === english) && (r.when.purpose === void 0 || r.when.purpose.includes(req.purpose ?? "agent"))
   ) ?? routes[routes.length - 1];
   let chain = route.chain.filter((p) => english || p !== "cloudflare:ceramic");
-  chain = chain.filter((p) => p !== "cloudflare:exa");
+  chain = chain.filter((p) => p !== "cloudflare:exa" && p !== "tavily");
   if (req.zdr) chain = chain.filter((p) => ZDR_PROVIDERS.has(p));
   return chain;
 }
@@ -188,6 +213,45 @@ var SearchBudgetExceededError = class extends Error {
   requestedUsd;
 };
 
+// src/search/tool.ts
+var PURPOSES = ["agent", "grounding", "discovery", "monitor"];
+var webSearchTool = {
+  name: "web_search",
+  description: "Search the open web. Returns up to 10 results with title, url and snippet. Set lang to the query's language (e.g. 'da', 'en'). Set fresh when the answer must be recent (news, prices, events).",
+  parameters: {
+    type: "object",
+    properties: {
+      query: { type: "string", minLength: 1, maxLength: 1024, description: "What to search for." },
+      lang: { type: "string", description: "Language of the query, e.g. 'da' or 'en'." },
+      limit: { type: "integer", minimum: 1, maximum: 10, description: "Number of results (default 10)." },
+      purpose: { type: "string", enum: PURPOSES, description: "agent (default), grounding, discovery or monitor." },
+      fresh: { type: "boolean", description: "Results must be recent." }
+    },
+    required: ["query"],
+    additionalProperties: false
+  }
+};
+async function runWebSearch(args, ctx = {}) {
+  const { query, lang, limit, purpose, fresh } = args;
+  if (typeof query !== "string" || query.trim() === "") throw new Error("web_search: `query` must be a non-empty string");
+  if (lang !== void 0 && typeof lang !== "string") throw new Error("web_search: `lang` must be a string");
+  if (limit !== void 0 && (!Number.isInteger(limit) || limit < 1 || limit > 10)) throw new Error("web_search: `limit` must be an integer 1\u201310");
+  if (purpose !== void 0 && !PURPOSES.includes(purpose)) throw new Error(`web_search: \`purpose\` must be one of ${PURPOSES.join(", ")}`);
+  if (fresh !== void 0 && typeof fresh !== "boolean") throw new Error("web_search: `fresh` must be a boolean");
+  const { zdr, labels, ...opts } = ctx;
+  const req = {
+    query,
+    ...lang !== void 0 ? { lang } : {},
+    ...limit !== void 0 ? { limit } : {},
+    ...purpose !== void 0 ? { purpose } : {},
+    ...fresh !== void 0 ? { fresh } : {},
+    ...zdr ? { zdr } : {},
+    ...labels ? { labels } : {}
+  };
+  const r = await search(req, opts);
+  return { provider: r.meta.provider, results: r.items.map((i) => ({ title: i.title, url: i.url, snippet: i.description })) };
+}
+
 // src/search/index.ts
 var sharedCache = memorySearchCache();
 var sharedCapStore = /* @__PURE__ */ (() => {
@@ -216,6 +280,11 @@ async function callProvider(provider, req, opts) {
     if (!key) throw new SearchKeyMissingError(provider, "BRAVE_API_KEY");
     return braveSearch({ ...req, provider }, key, f);
   }
+  if (provider === "tavily") {
+    const key = c.tavilyApiKey ?? env.TAVILY_API_KEY;
+    if (!key) throw new SearchKeyMissingError(provider, "TAVILY_API_KEY");
+    return tavilySearch({ ...req, provider }, key, f);
+  }
   if (provider.startsWith("cloudflare:")) {
     const accountId = c.cloudflareAccountId ?? env.CLOUDFLARE_ACCOUNT_ID;
     const apiToken = c.cloudflareApiToken ?? env.CLOUDFLARE_API_TOKEN;
@@ -3829,8 +3898,8 @@ var aiConfigSchema = z.object({
 import { randomUUID } from "crypto";
 
 // src/version.ts
-var VERSION = "0.59.1";
-var SDK_TAG = "@broberg/ai-sdk@0.59.1";
+var VERSION = "0.61.0";
+var SDK_TAG = "@broberg/ai-sdk@0.61.0";
 
 // src/cost/sinks/upmetrics.ts
 function isRetryableStatus(status) {
@@ -5447,6 +5516,7 @@ export {
   resolveTier,
   resolveVoice,
   routeSearch,
+  runWebSearch,
   search,
   sqliteBudgetStore,
   sqliteSink,
@@ -5463,6 +5533,7 @@ export {
   usdFromMicro,
   vertexAdapter,
   visionInputSchema,
+  webSearchTool,
   wouldProviderRouteTo,
   wouldRouteTo
 };