@broberg/ai-sdk 0.51.0 → 0.53.0

package/dist/index.d.ts

@@ -2,6 +2,23 @@ import { z } from 'zod';
 export { AvailabilitySource, AvailabilityStatus, ModelStatus, ModelUnavailableError, ResolveOptions, ResolveResult, listModels, resolveModel } from './registry.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 FailureKind = "auth" | "not_found" | "rate_limit" | "server" | "timeout" | "network" | "other";
+interface CallFailure {
+    provider: string;
+    /** The model we ASKED for (the route that failed). */
+    model: string;
+    transport: string;
+    capability: Capability;
+    tier?: Tier;
+    purpose?: string;
+    labels?: Record<string, string>;
+    latencyMs: number;
+    ts: string;
+    /** HTTP status as a string ("401", "503"), or "timeout" | "network" | "unknown". */
+    errorCode: string;
+    errorKind: FailureKind;
+}
+
 /** Coarse data-residency of the endpoint a call went to.
  *
  *  - `"eu"`  — EU/EEA. **The only positive residency claim.** Nothing else is folded
@@ -234,7 +251,12 @@ type ToolCallLike = {
  *  subprocess (Max plan); `subprocess:true` lets dashboards split free vs paid. */
 interface Usage {
     provider: string;
+    /** The model we ASKED for — the pricing key and the stable grouping. */
     model: string;
+    /** F071.2 — the model that ANSWERED, as the provider reported it. Differs from `model`
+     *  when an alias like "mistral-large-latest" resolves to a dated model; that is how a
+     *  silent overnight move becomes visible. Unset when the provider does not say. */
+    servedModel?: string;
     tier?: Tier;
     /** Data-residency of the endpoint that ACTUALLY answered (F042). Derived from the
      *  host/region the request used, not from the provider's name — vertex, azure and
@@ -286,6 +308,9 @@ interface Usage {
  *  Implementations must never throw into the caller (F3.3). */
 interface CostSink {
     record(usage: Usage): void | Promise<void>;
+    /** F071.1 — optional: a FAILED call attempt (no cost). Sinks that sum spend (sqlite,
+     *  budget, your own) may ignore it; leaving it out means they never see failures. */
+    recordFailure?(failure: CallFailure): void | Promise<void>;
 }
 /** Backing store for a BudgetGuard's rolling total. Default is in-memory
  *  (per createAI instance). A persistent store (e.g. sqliteBudgetStore) makes
@@ -1154,7 +1179,7 @@ declare const chatInputSchema: z.ZodObject<{
     responseFormat: z.ZodOptional<z.ZodEnum<["json", "text"]>>;
 }, "strip", z.ZodTypeAny, {
     system?: string | undefined;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     prompt?: string | undefined;
     messages?: {
         content: string | ({
@@ -1191,7 +1216,7 @@ declare const chatInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1199,7 +1224,7 @@ declare const chatInputSchema: z.ZodObject<{
     labels?: Record<string, string> | undefined;
 }, {
     system?: string | undefined;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     prompt?: string | undefined;
     messages?: {
         content: string | ({
@@ -1236,7 +1261,7 @@ declare const chatInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1283,7 +1308,7 @@ declare const visionInputSchema: z.ZodObject<{
     image: string | Uint8Array<ArrayBuffer>;
     prompt: string;
     system?: string | undefined;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     mimeType?: string | undefined;
     purpose?: string | undefined;
     override?: {
@@ -1291,7 +1316,7 @@ declare const visionInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1301,7 +1326,7 @@ declare const visionInputSchema: z.ZodObject<{
     image: string | Uint8Array<ArrayBuffer>;
     prompt: string;
     system?: string | undefined;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     mimeType?: string | undefined;
     purpose?: string | undefined;
     override?: {
@@ -1309,7 +1334,7 @@ declare const visionInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1355,7 +1380,7 @@ declare const videoInputSchema: z.ZodObject<{
     video: string | Uint8Array<ArrayBuffer>;
     prompt: string;
     system?: string | undefined;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     mimeType?: string | undefined;
     purpose?: string | undefined;
     override?: {
@@ -1363,7 +1388,7 @@ declare const videoInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1373,7 +1398,7 @@ declare const videoInputSchema: z.ZodObject<{
     video: string | Uint8Array<ArrayBuffer>;
     prompt: string;
     system?: string | undefined;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     mimeType?: string | undefined;
     purpose?: string | undefined;
     override?: {
@@ -1381,7 +1406,7 @@ declare const videoInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1424,14 +1449,14 @@ declare const translateInputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     text: string;
     to: string;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1441,14 +1466,14 @@ declare const translateInputSchema: z.ZodObject<{
 }, {
     text: string;
     to: string;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1520,7 +1545,7 @@ declare const imageInputSchema: z.ZodObject<{
     retryOnBlack: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     prompt: string;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     seed?: number | undefined;
     purpose?: string | undefined;
     outputFormat?: "jpeg" | "png" | "webp" | undefined;
@@ -1536,7 +1561,7 @@ declare const imageInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1549,7 +1574,7 @@ declare const imageInputSchema: z.ZodObject<{
     retryOnBlack?: boolean | undefined;
 }, {
     prompt: string;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     seed?: number | undefined;
     purpose?: string | undefined;
     outputFormat?: "jpeg" | "png" | "webp" | undefined;
@@ -1565,7 +1590,7 @@ declare const imageInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1618,7 +1643,7 @@ declare const animateInputSchema: z.ZodObject<{
     resolution: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     image: string | Uint8Array<ArrayBuffer>;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     prompt?: string | undefined;
     resolution?: string | undefined;
     purpose?: string | undefined;
@@ -1627,7 +1652,7 @@ declare const animateInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1636,7 +1661,7 @@ declare const animateInputSchema: z.ZodObject<{
     durationSec?: number | undefined;
 }, {
     image: string | Uint8Array<ArrayBuffer>;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     prompt?: string | undefined;
     resolution?: string | undefined;
     purpose?: string | undefined;
@@ -1645,7 +1670,7 @@ declare const animateInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1692,7 +1717,7 @@ declare const trainStyleInputSchema: z.ZodObject<{
     createMasks: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     images: string | string[];
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
     steps?: number | undefined;
     override?: {
@@ -1700,7 +1725,7 @@ declare const trainStyleInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1711,7 +1736,7 @@ declare const trainStyleInputSchema: z.ZodObject<{
     createMasks?: boolean | undefined;
 }, {
     images: string | string[];
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
     steps?: number | undefined;
     override?: {
@@ -1719,7 +1744,7 @@ declare const trainStyleInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1762,14 +1787,14 @@ declare const embeddingInputSchema: z.ZodObject<{
     text: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
 }, "strip", z.ZodTypeAny, {
     text: string | string[];
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1777,14 +1802,14 @@ declare const embeddingInputSchema: z.ZodObject<{
     labels?: Record<string, string> | undefined;
 }, {
     text: string | string[];
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1835,7 +1860,7 @@ 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>;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     language?: string | undefined;
     purpose?: string | undefined;
     override?: {
@@ -1843,7 +1868,7 @@ declare const transcribeInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1854,7 +1879,7 @@ declare const transcribeInputSchema: z.ZodObject<{
     timestamps?: "word" | "segment" | ("word" | "segment")[] | undefined;
 }, {
     audio: string | Uint8Array<ArrayBuffer>;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     language?: string | undefined;
     purpose?: string | undefined;
     override?: {
@@ -1862,7 +1887,7 @@ declare const transcribeInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1908,7 +1933,7 @@ declare const ocrInputSchema: z.ZodObject<{
     mimeType: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     document: string | Uint8Array<ArrayBuffer>;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     mimeType?: string | undefined;
     purpose?: string | undefined;
     override?: {
@@ -1916,7 +1941,7 @@ declare const ocrInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1924,7 +1949,7 @@ declare const ocrInputSchema: z.ZodObject<{
     labels?: Record<string, string> | undefined;
 }, {
     document: string | Uint8Array<ArrayBuffer>;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     mimeType?: string | undefined;
     purpose?: string | undefined;
     override?: {
@@ -1932,7 +1957,7 @@ declare const ocrInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1972,14 +1997,14 @@ declare const moderationInputSchema: z.ZodObject<{
     input: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
 }, "strip", z.ZodTypeAny, {
     input: string | string[];
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -1987,14 +2012,14 @@ declare const moderationInputSchema: z.ZodObject<{
     labels?: Record<string, string> | undefined;
 }, {
     input: string | string[];
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -2132,14 +2157,14 @@ declare const judgeInputSchema: z.ZodObject<{
         instructions: string | unknown[] | Record<string, unknown> | null;
         criteria: (string | unknown[] | Record<string, unknown> | null)[];
     }>;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -2163,14 +2188,14 @@ declare const judgeInputSchema: z.ZodObject<{
         instructions: string | unknown[] | Record<string, unknown> | null;
         criteria: (string | unknown[] | Record<string, unknown> | null)[];
     }>;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -2248,7 +2273,7 @@ declare const podcastInputSchema: z.ZodObject<{
         speaker: string;
     }[];
     voices: Record<string, string>;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
     pronunciations?: {
         word: string;
@@ -2262,7 +2287,7 @@ declare const podcastInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -2275,7 +2300,7 @@ declare const podcastInputSchema: z.ZodObject<{
         speaker: string;
     }[];
     voices: Record<string, string>;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
     pronunciations?: {
         word: string;
@@ -2289,7 +2314,7 @@ declare const podcastInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -2370,7 +2395,7 @@ declare const ttsInputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     text: string;
     voice: string;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
     wordTimings?: boolean | undefined;
     pronunciations?: {
@@ -2385,7 +2410,7 @@ declare const ttsInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -2398,7 +2423,7 @@ declare const ttsInputSchema: z.ZodObject<{
 }, {
     text: string;
     voice: string;
-    tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
+    tier?: "vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | undefined;
     purpose?: string | undefined;
     wordTimings?: boolean | undefined;
     pronunciations?: {
@@ -2413,7 +2438,7 @@ declare const ttsInputSchema: z.ZodObject<{
         model?: string | undefined;
         transport?: "http" | "subprocess" | undefined;
     } | undefined;
-    fallback?: ("fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | {
+    fallback?: ("vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap" | {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -2428,6 +2453,9 @@ declare const aiConfigSchema: z.ZodObject<{
     /** F069.1 — customer-key mode. Every provider must be built with byokAdapter(), so no
      *  call can fall back to the fleet's env keys; createAI throws at setup otherwise. */
     byok: z.ZodOptional<z.ZodBoolean>;
+    /** F069.2 — attribution labels stamped on EVERY call's usage (and so on every cost-sink
+     *  row), e.g. { byok: "true", tenantId }. A call's own `labels` win on the same key. */
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     /** F039.2 — client-wide opt-out from prompt caching (default: on where the
      *  provider supports it). A per-call `promptCache` wins over this. */
     promptCache: z.ZodOptional<z.ZodBoolean>;
@@ -2471,8 +2499,9 @@ declare const aiConfigSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     promptCache?: boolean | undefined;
+    labels?: Record<string, string> | undefined;
     byok?: boolean | undefined;
-    defaults?: Partial<Record<"fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding", {
+    defaults?: Partial<Record<"vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap", {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -2489,8 +2518,9 @@ declare const aiConfigSchema: z.ZodObject<{
     } | undefined;
 }, {
     promptCache?: boolean | undefined;
+    labels?: Record<string, string> | undefined;
     byok?: boolean | undefined;
-    defaults?: Partial<Record<"fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding", {
+    defaults?: Partial<Record<"vision" | "video" | "embedding" | "fast" | "smart" | "powerful" | "cheap", {
         provider: string;
         model: string;
         transport: "http" | "subprocess";
@@ -2872,8 +2902,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.51.0";
-declare const SDK_TAG: "@broberg/ai-sdk@0.51.0";
+declare const VERSION: "0.53.0";
+declare const SDK_TAG: "@broberg/ai-sdk@0.53.0";
 
 /** Built-in defaults. Every entry is overridable via AiConfig.defaults or a
  *  per-call override.