@broberg/ai-sdk 0.56.1 → 0.57.0

package/dist/index.d.ts

@@ -2232,8 +2232,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.56.1";
-declare const SDK_TAG: "@broberg/ai-sdk@0.56.1";
+declare const VERSION: "0.57.0";
+declare const SDK_TAG: "@broberg/ai-sdk@0.57.0";
 
 /** Built-in defaults. Every entry is overridable via AiConfig.defaults or a
  *  per-call override.
@@ -2758,4 +2758,57 @@ interface StreamTransportRequest extends TransportRequest {
  */
 declare function streamTransport(req: StreamTransportRequest): AsyncIterable<string>;
 
-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, 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, sqliteBudgetStore, sqliteSink, streamTransport, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, typesafeAdapter, upmetricsCostClient, upmetricsSink, usdFromMicro, vertexAdapter, visionInputSchema, wouldProviderRouteTo, wouldRouteTo };
+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;
+    };
+}
+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 SEARCH_PRICE_USD: Record<SearchProviderId, number>;
+
+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 };

package/dist/index.js

@@ -3548,8 +3548,8 @@ var aiConfigSchema = z.object({
 import { randomUUID } from "crypto";
 
 // src/version.ts
-var VERSION = "0.56.1";
-var SDK_TAG = "@broberg/ai-sdk@0.56.1";
+var VERSION = "0.57.0";
+var SDK_TAG = "@broberg/ai-sdk@0.57.0";
 
 // src/cost/sinks/upmetrics.ts
 function isRetryableStatus(status) {
@@ -5094,6 +5094,103 @@ function wouldRouteTo(tier) {
   if (!spec) return { kind: "unknown-provider", provider: String(tier), onlyIf: [...ASSUMPTIONS] };
   return wouldProviderRouteTo(spec.provider);
 }
+
+// src/search/brave.ts
+async function braveSearch(req, apiKey, f) {
+  const params = new URLSearchParams({ q: req.query, count: String(Math.min(req.limit ?? 10, 20)) });
+  if (req.lang) params.set("search_lang", req.lang);
+  if (req.country) params.set("country", req.country);
+  const res = await f(`https://api.search.brave.com/res/v1/web/search?${params}`, {
+    headers: { accept: "application/json", "X-Subscription-Token": apiKey }
+  });
+  if (!res.ok) throw Object.assign(new Error(`brave search: HTTP ${res.status} ${(await res.text()).slice(0, 200)}`), { status: res.status });
+  const body = await res.json();
+  const items = (body.web?.results ?? []).map((r) => ({
+    title: r.title ?? "",
+    url: r.url ?? "",
+    description: r.description ?? "",
+    provider: "brave",
+    ...r.language ? { lang: r.language } : {},
+    ...r.page_age ? { publishedAt: new Date(r.page_age).toISOString() } : {}
+  }));
+  return { items, requestId: res.headers.get("x-request-id") ?? void 0 };
+}
+
+// src/search/cloudflare.ts
+var CLOUDFLARE_MAX_QUERY = 1024;
+var CLOUDFLARE_MAX_LIMIT = 10;
+async function cloudflareSearch(req, creds, f) {
+  if (req.query.length < 1 || req.query.length > CLOUDFLARE_MAX_QUERY) {
+    throw new Error(`search: Cloudflare takes a query of 1\u2013${CLOUDFLARE_MAX_QUERY} characters, got ${req.query.length}`);
+  }
+  const provider = req.provider.split(":")[1];
+  const res = await f(`https://api.cloudflare.com/client/v4/accounts/${encodeURIComponent(creds.accountId)}/ai/websearch/`, {
+    method: "POST",
+    headers: { authorization: `Bearer ${creds.apiToken}`, "content-type": "application/json" },
+    body: JSON.stringify({ query: req.query, provider, limit: Math.min(req.limit ?? CLOUDFLARE_MAX_LIMIT, CLOUDFLARE_MAX_LIMIT) })
+  });
+  if (!res.ok) throw Object.assign(new Error(`cloudflare search (${provider}): HTTP ${res.status} ${(await res.text()).slice(0, 200)}`), { status: res.status });
+  const body = await res.json();
+  const inner = body.result ?? body;
+  const items = (inner.items ?? []).map((r) => ({
+    title: r.title ?? "",
+    url: r.url ?? "",
+    description: r.description ?? "",
+    provider: req.provider
+  }));
+  return { items, requestId: inner.metadata?.requestId };
+}
+
+// src/search/prices.ts
+var SEARCH_PRICE_USD = {
+  "cloudflare:ceramic": 25e-5,
+  "cloudflare:linkup": 5e-3,
+  "cloudflare:exa": 7e-3,
+  brave: 5e-3
+};
+
+// src/search/types.ts
+var SearchKeyMissingError = class extends Error {
+  constructor(provider, envVar) {
+    super(`search: ${provider} needs ${envVar} (env or options.credentials)`);
+    this.provider = provider;
+    this.envVar = envVar;
+    this.name = "SearchKeyMissingError";
+  }
+  provider;
+  envVar;
+};
+
+// src/search/index.ts
+async function search(req, opts = {}) {
+  const f = opts.fetch ?? fetch;
+  const c = opts.credentials ?? {};
+  const t0 = performance.now();
+  let out;
+  if (req.provider === "brave") {
+    const key = c.braveApiKey ?? process.env.BRAVE_API_KEY;
+    if (!key) throw new SearchKeyMissingError(req.provider, "BRAVE_API_KEY");
+    out = await braveSearch(req, key, f);
+  } else if (req.provider.startsWith("cloudflare:")) {
+    const accountId = c.cloudflareAccountId ?? process.env.CLOUDFLARE_ACCOUNT_ID;
+    const apiToken = c.cloudflareApiToken ?? process.env.CLOUDFLARE_API_TOKEN;
+    if (!accountId) throw new SearchKeyMissingError(req.provider, "CLOUDFLARE_ACCOUNT_ID");
+    if (!apiToken) throw new SearchKeyMissingError(req.provider, "CLOUDFLARE_API_TOKEN");
+    out = await cloudflareSearch(req, { accountId, apiToken }, f);
+  } else {
+    throw new Error(`search: unknown provider "${String(req.provider)}"`);
+  }
+  return {
+    items: out.items,
+    meta: {
+      provider: req.provider,
+      latencyMs: Math.round(performance.now() - t0),
+      cached: false,
+      costUsd: SEARCH_PRICE_USD[req.provider],
+      ...out.requestId ? { requestId: out.requestId } : {}
+    }
+  };
+}
 export {
   AZURE_DANISH_VOICES,
   AZURE_DANISH_VOICE_LIST,
@@ -5109,6 +5206,8 @@ export {
   ModelUnavailableError,
   PRICING_STALE_AFTER_DAYS,
   SDK_TAG,
+  SEARCH_PRICE_USD,
+  SearchKeyMissingError,
   StreamHttpError,
   UpmetricsCostError,
   VERSION,
@@ -5177,6 +5276,7 @@ export {
   resolveModel,
   resolveTier,
   resolveVoice,
+  search,
   sqliteBudgetStore,
   sqliteSink,
   streamTransport,