@broberg/ai-sdk 0.47.0 → 0.48.0

package/README.md

@@ -189,13 +189,23 @@ const ai = createAI({
   budget: { perCallUsd: 0.05, rollingUsd: 5 }, // pre-flight guard (throws BudgetExceededError)
   costSink: multiSink([
     upmetricsSink({ baseUrl: "https://upmetrics.org", apiKey: process.env.UPMETRICS_API_KEY!, agentName: "my-app" }),
-    sqliteSink({ dbPath: "./ai-cost.db" }),
+    sqliteSink({ dbPath: "./ai-cost.db" }), // Bun only — throws on Node, see below
   ]),
 });
 ```
 
 Sinks: `upmetricsSink` (canonical), `discordSink`, `sqliteSink`, `multiSink`,
-`noopSink`. A failing sink never crashes a call.
+`noopSink`. A sink that fails *during* a call never crashes that call.
+
+> **`sqliteSink` and `getCostSummary` are Bun-only** (changed in v0.48.0, released
+> 22 September 2026). They are backed by
+> `bun:sqlite`, which Node cannot import at all. On Node they now **throw where you
+> construct them** — deliberately, and this is a behaviour change: up to v0.47 you
+> got a sink object that threw on every `record()`, and the client swallows per-call
+> sink errors by design, so cost tracking went silently dead. An empty cost dataset
+> and a working one look identical in a report. **On Node use `upmetricsSink`.**
+> `sqliteBudgetStore` is Bun-only for the same reason; it has always failed loudly
+> there, because a budget error is not swallowed.
 
 ### Cost-tracking is on by default (v0.24+)
 

package/dist/{chunk-ZFWSLSE7.js → chunk-SWV5YIEE.js}

@@ -50,6 +50,27 @@ var DEFAULTS = [
   { id: "gemini-2.5-flash-lite", aliases: ["gemini-flash-lite"], provider: "gemini", available: true, status: "available", source: "default" },
   // ── OpenAI ───────────────────────────────────────────────────────────────
   { id: "text-embedding-3-small", aliases: [], provider: "openai", available: true, status: "available", source: "default" },
+  // ── DeepSeek (CN-hosted — NOT GDPR-safe; non-PII workloads only) ─────────
+  //
+  // F057.2. These were missing while pricing.ts carried OFFICIAL rates for them
+  // and providers/deepseek.ts shipped an adapter (F030.2) — so our own CLAUDE.md
+  // instruction ("if you are GATING, pass requireKnown:true") refused a route we
+  // built, priced and wrote an F-number for. Two tables disagreed, and the gate
+  // is the one that decides. Reported by pitch (ref 28546) via components.
+  //
+  // The note carries the sunset because the registry is what a picker renders, and
+  // a row that says only "available" would hide it. Both ids were documented to
+  // deprecate 2026-07-24 in favour of `deepseek-v4-flash` — we have NOT verified
+  // against a live key (no DEEPSEEK_API_KEY here), so this is the curated seed's
+  // usual standing: a default, not a measurement. A live refresh may overrule it.
+  //
+  // `deepseek-v4-flash` on the DIRECT api is deliberately NOT here: it has no
+  // price in pricing.ts (measured — getPrice("deepseek","deepseek-v4-flash") is
+  // undefined), so a row would pass the gate for a route that silently bills
+  // nothing. That is the same green-direction failure this card exists to remove,
+  // and it needs a rate from a real source, not a guess. See the plan-doc.
+  { id: "deepseek-chat", aliases: [], provider: "deepseek", available: true, status: "available", note: "direct api.deepseek.com; documented to deprecate 2026-07-24 in favour of deepseek-v4-flash \u2014 not live-verified", source: "default" },
+  { id: "deepseek-reasoner", aliases: [], provider: "deepseek", available: true, status: "available", note: "direct api.deepseek.com (thinking); documented to deprecate 2026-07-24 in favour of deepseek-v4-flash \u2014 not live-verified", source: "default" },
   // ── Mistral (EU / GDPR) ──────────────────────────────────────────────────
   { id: "mistral-large-latest", aliases: ["mistral-large"], provider: "mistral", available: true, status: "available", source: "default" },
   { id: "mistral-medium-latest", aliases: ["mistral-medium"], provider: "mistral", available: true, status: "available", source: "default" },
@@ -153,7 +174,11 @@ function resolveModel(requested, opts = {}) {
       requested: id,
       provider,
       fellBack: false,
-      status: entry?.status ?? "unknown"
+      status: entry?.status ?? "unknown",
+      // A green gate that hides a known caveat is the failure this whole card is
+      // about, one level up: the answer is shaped like "fine" and the warning is
+      // somewhere else. If the row has a note, the caller gets it with the yes.
+      ...entry?.note ? { note: entry.note } : {}
     };
   }
   const chain = opts.fallback === void 0 ? [] : Array.isArray(opts.fallback) ? opts.fallback : [opts.fallback];
@@ -198,4 +223,4 @@ export {
   listModels,
   resolveModel
 };
-//# sourceMappingURL=chunk-ZFWSLSE7.js.map
+//# sourceMappingURL=chunk-SWV5YIEE.js.map

package/dist/chunk-SWV5YIEE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/routing/tier-map.ts","../src/availability/registry.ts","../src/availability/types.ts","../src/availability/resolve.ts"],"sourcesContent":["// Tier routing: a named Tier resolves to a concrete (provider, model, transport).\n// Precedence is per-call override > client config map > built-in defaults.\nimport type { Tier, TierSpec } from \"../types.js\";\n\n/** Built-in defaults. Every entry is overridable via AiConfig.defaults or a\n *  per-call override.\n *\n *  F030 — Anthropic API phase-out: `ANTHROPIC_API_KEY` was globally removed, so the\n *  default cloud route may NOT hit Anthropic Console. `fast`/`smart`/`powerful`/\n *  `vision` now default to **Mistral EU** (Paris-hosted, Schrems II-safe — so every\n *  default text/vision call is GDPR-safe by default). Claude stays reachable as a\n *  NON-default quality fallback for non-PII via `override:{provider:\"openrouter\",\n *  model:\"anthropic/claude-…\"}`. DeepSeek (CN) is the opt-in non-PII secondary\n *  (`provider:\"deepseek\"`), never a default. Magistral (reasoning) / mistral-large\n *  for vision are per-call overrides, not defaults (don't pay the premium on all). */\nexport const DEFAULT_TIER_MAP: Record<Tier, TierSpec> = {\n  fast: { provider: \"mistral\", model: \"mistral-small-latest\", transport: \"http\" },\n  smart: { provider: \"mistral\", model: \"mistral-large-latest\", transport: \"http\" },\n  powerful: { provider: \"mistral\", model: \"mistral-large-latest\", transport: \"http\" },\n  cheap: { provider: \"mistral\", model: \"mistral-small-latest\", transport: \"http\" },\n  // Vision: small-latest (vision-capable, cheap EU) is the default; override to\n  // mistral-large-latest for demanding image/spatial/composition work.\n  // F041 — bumped from mistral-small on Christian's ask, and the choice is MEASURED,\n  // not assumed from price. On a fine-discrimination test (an 8x10 grid where one cell\n  // differs only in its blue channel, 190->150) across 9 cases:\n  //   mistral-medium-latest  4/9      <- best\n  //   mistral-small-latest   1/6 + 0/3 = 1/9\n  //   mistral-large-latest   0/9      <- WORSE than small, despite costing 5x more\n  // Large ties small on easy colour blocks (4/4 each) and collapses on subtle ones,\n  // so \"bigger is better at vision\" does not hold in Mistral's lineup. Nobody is good\n  // at this task; medium is simply the only one that sees anything.\n  vision: { provider: \"mistral\", model: \"mistral-medium-latest\", transport: \"http\" },\n  // Native video understanding — Gemini leads; flash-lite is the cheap default (F019).\n  // NOT Anthropic → out of the F030 phase-out (its own EU epic if/when needed).\n  video: { provider: \"gemini\", model: \"gemini-2.5-flash-lite\", transport: \"http\" },\n  // NOT Anthropic → out of F030 (EU-embedding migration is its own future epic).\n  embedding: { provider: \"openai\", model: \"text-embedding-3-small\", transport: \"http\" },\n};\n\n/**\n * Resolve a Tier to a concrete TierSpec.\n *\n * Merge order (later wins): DEFAULT_TIER_MAP < configMap < override.\n * - `configMap` is the client-level AiConfig.defaults (per-tier full specs).\n * - `override` is a per-call Partial<TierSpec> — only the fields it sets win.\n */\n/** Refuse an override that names a different provider without naming a model (F043.2).\n *\n *  Exported and called at EVERY spec merge, not only inside resolveTier. The first\n *  version guarded only the six capabilities that route via a tier; image, animate,\n *  trainStyle, ocr, moderate, podcast, tts, transcribe and batch merge the override\n *  themselves and skipped it entirely — so `ai.image({override:{provider:\"fal\"}})`\n *  still posted BFL's flux-2-pro to fal, the exact misleading upstream error this was\n *  written to kill. A guard at six of fifteen call sites is a guard you cannot rely on.\n *\n *  We REFUSE rather than re-resolve: choosing a model for the new provider would be\n *  the SDK making a price decision on the caller's behalf, visible only on the bill.\n *\n *  `knownProviders` (when given) lets an UNREGISTERED provider through — that is a\n *  typo, and \"no provider adapter registered\" is the useful thing to say about it. */\nexport function assertOverrideProvider(\n  base: { provider: string; model: string },\n  override: Partial<TierSpec> | undefined,\n  label: string,\n  knownProviders?: readonly string[],\n): void {\n  if (!override?.provider || override.model !== undefined) return;\n  if (override.provider === base.provider) return;\n  if (knownProviders !== undefined && !knownProviders.includes(override.provider)) return;\n  throw new Error(\n    `createAI: override sets provider \"${override.provider}\", but \"${label}\" resolves to model ` +\n      `\"${base.model}\", which belongs to \"${base.provider}\". Set a model too, e.g. ` +\n      `override: { provider: \"${override.provider}\", model: \"<a ${override.provider} model>\" }.`,\n  );\n}\n\nexport function resolveTier(\n  tier: Tier,\n  override?: Partial<TierSpec>,\n  configMap?: Partial<Record<Tier, TierSpec>>,\n  knownProviders?: readonly string[],\n): TierSpec {\n  const base = configMap?.[tier] ?? DEFAULT_TIER_MAP[tier];\n  assertOverrideProvider(base, override, tier, knownProviders);\n  return { ...base, ...override };\n}\n","// F022 — the model-availability registry: the ONE source both resolveModel()\n// (spawn / call path) and listModels() (UI picker) read. A curated default seed\n// (works offline — the durable floor) plus a mutable overlay that\n// refreshAvailability() updates from the live provider list.\n//\n// Scope note: this is a LIVENESS view (is this id alive right now?), not the\n// rich capability/price inventory (that is F017 src/catalogue). We only track\n// ids we want to assert status on; anything not here is fail-open (treated\n// available) so we never block a model we simply do not track.\nimport { DEFAULT_TIER_MAP } from \"../routing/tier-map.js\";\nimport type { AvailabilityStatus, AvailabilitySource, ModelStatus } from \"./types.js\";\n\n/** Internal registry row. `aliases[0]` surfaces as ModelStatus.alias. */\nexport interface RegistryEntry {\n  id: string;\n  aliases: string[];\n  provider: string;\n  available: boolean;\n  status: AvailabilityStatus;\n  note?: string;\n  source: AvailabilitySource;\n}\n\nconst SUSPENDED_FABLE_MYTHOS = \"suspended — US export-control directive (2026-06-12)\";\n\n/** Curated defaults. Aliases here are MODEL-IDENTITY names only (short names for\n *  the model itself). TIER aliases — fast/smart/powerful/cheap/vision/video/\n *  embedding — are NOT written here: they are derived from DEFAULT_TIER_MAP below,\n *  because hand-maintaining them in two places is exactly how they drifted.\n *\n *  They HAD drifted, and it crossed the EU border: this list said `smart` was\n *  claude-sonnet-4-6 (Anthropic, US) for the ~3 months after F030 pointed the\n *  default tiers at Mistral EU, so resolveModel('smart') named a US model while\n *  ai.chat({tier:'smart'}) called an EU one. Anyone using resolveModel to SHOW or\n *  DECIDE where data goes — the obvious use — got the wrong answer. Measured by\n *  fd-sundhed in 0.21.1, still true in 0.28.0, fixed here by deleting the second\n *  list rather than correcting it. */\nconst DEFAULTS: RegistryEntry[] = [\n  // ── Anthropic ────────────────────────────────────────────────────────────\n  { id: \"claude-haiku-4-5\", aliases: [\"haiku\"], provider: \"anthropic\", available: true, status: \"available\", source: \"default\" },\n  { id: \"claude-sonnet-4-6\", aliases: [\"sonnet\"], provider: \"anthropic\", available: true, status: \"available\", source: \"default\" },\n  { id: \"claude-opus-4-8\", aliases: [\"opus\"], provider: \"anthropic\", available: true, status: \"available\", source: \"default\" },\n  { id: \"claude-fable-5\", aliases: [\"fable\"], provider: \"anthropic\", available: true, status: \"available\", source: \"default\" },\n  { id: \"claude-mythos-5\", aliases: [\"mythos\"], provider: \"anthropic\", available: false, status: \"suspended\", note: SUSPENDED_FABLE_MYTHOS, source: \"default\" },\n  // ── Gemini ───────────────────────────────────────────────────────────────\n  { id: \"gemini-2.5-flash\", aliases: [\"gemini-flash\"], provider: \"gemini\", available: true, status: \"available\", source: \"default\" },\n  { id: \"gemini-2.5-flash-lite\", aliases: [\"gemini-flash-lite\"], provider: \"gemini\", available: true, status: \"available\", source: \"default\" },\n  // ── OpenAI ───────────────────────────────────────────────────────────────\n  { id: \"text-embedding-3-small\", aliases: [], provider: \"openai\", available: true, status: \"available\", source: \"default\" },\n  // ── DeepSeek (CN-hosted — NOT GDPR-safe; non-PII workloads only) ─────────\n  //\n  // F057.2. These were missing while pricing.ts carried OFFICIAL rates for them\n  // and providers/deepseek.ts shipped an adapter (F030.2) — so our own CLAUDE.md\n  // instruction (\"if you are GATING, pass requireKnown:true\") refused a route we\n  // built, priced and wrote an F-number for. Two tables disagreed, and the gate\n  // is the one that decides. Reported by pitch (ref 28546) via components.\n  //\n  // The note carries the sunset because the registry is what a picker renders, and\n  // a row that says only \"available\" would hide it. Both ids were documented to\n  // deprecate 2026-07-24 in favour of `deepseek-v4-flash` — we have NOT verified\n  // against a live key (no DEEPSEEK_API_KEY here), so this is the curated seed's\n  // usual standing: a default, not a measurement. A live refresh may overrule it.\n  //\n  // `deepseek-v4-flash` on the DIRECT api is deliberately NOT here: it has no\n  // price in pricing.ts (measured — getPrice(\"deepseek\",\"deepseek-v4-flash\") is\n  // undefined), so a row would pass the gate for a route that silently bills\n  // nothing. That is the same green-direction failure this card exists to remove,\n  // and it needs a rate from a real source, not a guess. See the plan-doc.\n  { id: \"deepseek-chat\", aliases: [], provider: \"deepseek\", available: true, status: \"available\", note: \"direct api.deepseek.com; documented to deprecate 2026-07-24 in favour of deepseek-v4-flash — not live-verified\", source: \"default\" },\n  { id: \"deepseek-reasoner\", aliases: [], provider: \"deepseek\", available: true, status: \"available\", note: \"direct api.deepseek.com (thinking); documented to deprecate 2026-07-24 in favour of deepseek-v4-flash — not live-verified\", source: \"default\" },\n  // ── Mistral (EU / GDPR) ──────────────────────────────────────────────────\n  { id: \"mistral-large-latest\", aliases: [\"mistral-large\"], provider: \"mistral\", available: true, status: \"available\", source: \"default\" },\n  { id: \"mistral-medium-latest\", aliases: [\"mistral-medium\"], provider: \"mistral\", available: true, status: \"available\", source: \"default\" },\n  { id: \"mistral-small-latest\", aliases: [\"mistral-small\"], provider: \"mistral\", available: true, status: \"available\", source: \"default\" },\n];\n\n/** Attach every tier name as an alias of the model that tier ACTUALLY calls.\n *  One source: DEFAULT_TIER_MAP decides, the registry follows. A tier whose model\n *  is not in the registry is left unaliased on purpose — resolveModel then reports\n *  status \"unknown\" (fail-open) instead of inventing a row, and the drift test\n *  catches it. */\nexport const TIER_ALIAS_CONFLICTS: string[] = [];\n\nfunction applyTierAliases(entries: RegistryEntry[]): RegistryEntry[] {\n  for (const [tier, spec] of Object.entries(DEFAULT_TIER_MAP)) {\n    const owner = entries.find((e) => e.id === spec.model && e.provider === spec.provider);\n    // A tier name hand-written on any OTHER row is the drift bug returning. It\n    // would resolve correctly TODAY only because seed() lets the last write win\n    // and the rows happen to be ordered favourably — reorder the array and the\n    // tier silently points at the wrong provider again. Record it so a test can\n    // fail on it, then strip it so runtime is right regardless.\n    for (const e of entries) {\n      if (e !== owner && e.aliases.includes(tier)) {\n        TIER_ALIAS_CONFLICTS.push(`${tier} is hand-declared on ${e.id} (${e.provider}) but tier ${tier} calls ${spec.model} (${spec.provider})`);\n        e.aliases = e.aliases.filter((a) => a !== tier);\n      }\n    }\n    if (owner && !owner.aliases.includes(tier)) owner.aliases.push(tier);\n  }\n  return entries;\n}\napplyTierAliases(DEFAULTS);\n\n/** The live overlay, keyed by canonical id. Seeded from DEFAULTS (deep-copied so\n *  resetting is clean). refreshAvailability() mutates this; resolve/listModels\n *  read it synchronously. */\nlet OVERLAY = new Map<string, RegistryEntry>();\n/** alias → canonical id, rebuilt whenever the overlay is seeded. */\nlet ALIAS_INDEX = new Map<string, string>();\n\nfunction seed(): void {\n  OVERLAY = new Map(DEFAULTS.map((e) => [e.id, { ...e, aliases: [...e.aliases] }]));\n  ALIAS_INDEX = new Map();\n  for (const e of DEFAULTS) for (const a of e.aliases) ALIAS_INDEX.set(a, e.id);\n}\nseed();\n\n/** Reset the overlay back to the curated defaults. For tests. */\nexport function resetRegistry(): void {\n  seed();\n}\n\n/** Canonical id for a model id OR alias; null when we track neither. */\nexport function canonicalId(requested: string): string | null {\n  if (OVERLAY.has(requested)) return requested;\n  return ALIAS_INDEX.get(requested) ?? null;\n}\n\n/** The current entry for an id/alias, or undefined when untracked (fail-open). */\nexport function getEntry(requested: string): RegistryEntry | undefined {\n  const id = canonicalId(requested);\n  return id ? OVERLAY.get(id) : undefined;\n}\n\n/** All tracked entries (optionally provider-scoped), as a public ModelStatus[]. */\nexport function allEntries(provider?: string): ModelStatus[] {\n  const rows: ModelStatus[] = [];\n  for (const e of OVERLAY.values()) {\n    if (provider && e.provider !== provider) continue;\n    rows.push({\n      id: e.id,\n      alias: e.aliases[0],\n      provider: e.provider,\n      available: e.available,\n      status: e.status,\n      note: e.note,\n      source: e.source,\n    });\n  }\n  return rows;\n}\n\n/** Provider-scoped canonical ids (for refresh reconciliation). */\nexport function providerIds(provider: string): string[] {\n  return [...OVERLAY.values()].filter((e) => e.provider === provider).map((e) => e.id);\n}\n\n/** Mark a tracked id available/suspended from a live refresh. No-op if untracked. */\nexport function setAvailability(id: string, available: boolean, note?: string): void {\n  const e = OVERLAY.get(id);\n  if (!e) return;\n  e.available = available;\n  e.status = available ? \"available\" : \"suspended\";\n  e.source = \"refresh\";\n  if (note !== undefined) e.note = note;\n  else if (available) e.note = undefined;\n}\n","// F022 — Model Availability Harness. Public types for the availability layer:\n// the shared status read (ModelStatus), the resolve result, and the structured\n// error a caller can flag on. The registry is the one source both the spawn /\n// call path (resolveModel) and UI pickers (listModels) read.\n\nexport type AvailabilityStatus = \"available\" | \"suspended\" | \"unknown\";\n\n/** Where a model's current availability came from: the curated default seed,\n *  or a live provider refresh (Anthropic GET /v1/models). */\nexport type AvailabilitySource = \"default\" | \"refresh\";\n\n/** One row of the shared status read — what a UI model-picker renders. */\nexport interface ModelStatus {\n  /** Canonical provider model id, e.g. \"claude-fable-5\". */\n  id: string;\n  /** Short/tier alias, e.g. \"fable\" (the first registered alias). */\n  alias?: string;\n  /** \"anthropic\" | \"openai\" | \"gemini\" | \"mistral\" | … */\n  provider: string;\n  available: boolean;\n  status: AvailabilityStatus;\n  /** Friendly reason, e.g. \"suspended — US export-control directive (2026-06-12)\". */\n  note?: string;\n  source: AvailabilitySource;\n}\n\n/** Result of resolveModel — the spawn / call path consumes this synchronously. */\nexport interface ResolveResult {\n  /** True when the requested model itself is available. */\n  ok: boolean;\n  /** The id to actually use: `requested` when ok, else the first available fallback. */\n  model: string;\n  /** What the caller asked for (id or alias, normalized to the canonical id). */\n  requested: string;\n  provider?: string;\n  /** True when `model` differs from `requested` because we fell back. */\n  fellBack: boolean;\n  status: AvailabilityStatus;\n  /** Why it degraded / why it is unavailable. */\n  reason?: string;\n  /** The registry row's caveat, surfaced on the SUCCESS path too (F057.2).\n   *\n   *  `reason` only ever appears when a model is unavailable, so a caveat written\n   *  on an AVAILABLE row — \"documented to deprecate 2026-07-24\", \"preview\", a\n   *  known rate limit — was reachable through listModels() and invisible to the\n   *  one caller who most needs it: the gate. A consumer passing requireKnown got\n   *  a clean green with the warning sitting one call away, unread. Carrying it\n   *  here costs an optional field and makes `ok:true` able to say \"yes, but\". */\n  note?: string;\n}\n\n/** Thrown by resolveModel when the requested model is unavailable, no usable\n *  fallback exists, and the caller passed `throwIfUnavailable`. Callers flag on\n *  `.code === \"model_unavailable\"`. */\nexport class ModelUnavailableError extends Error {\n  readonly code = \"model_unavailable\";\n  readonly requested: string;\n  readonly provider?: string;\n  readonly note?: string;\n  constructor(requested: string, note?: string, provider?: string) {\n    super(`model \"${requested}\" is unavailable${note ? ` (${note})` : \"\"}`);\n    this.name = \"ModelUnavailableError\";\n    this.requested = requested;\n    this.note = note;\n    this.provider = provider;\n  }\n}\n","// F022 — the synchronous, zero-I/O resolve + status read. This is the spawn /\n// call hot path (buddy's launcher calls resolveModel per spawn, cardmem #4842):\n// it MUST never await and never touch the network. Freshness comes only from a\n// prior async refreshAvailability(); resolve just reads the in-memory registry.\nimport { allEntries, canonicalId, getEntry } from \"./registry.js\";\nimport { ModelUnavailableError } from \"./types.js\";\nimport type { ModelStatus, ResolveResult } from \"./types.js\";\n\nexport interface ResolveOptions {\n  /** One id/alias or an ordered chain to try when `requested` is unavailable. */\n  fallback?: string | string[];\n  /** Scope hint (passed through to the result); does not gate lookup. */\n  provider?: string;\n  /** Throw ModelUnavailableError instead of returning ok:false when there is no\n   *  usable fallback. For callers that want to flag rather than degrade. */\n  throwIfUnavailable?: boolean;\n  /** Treat an id we do not track as UNUSABLE instead of fail-open.\n   *\n   *  Default is fail-open: we never block a model we simply do not track. That is\n   *  right for liveness, and wrong for a caller who is GATING — cms measured the\n   *  consequence: resolveModel(\"cheap\") answered {ok:true, model:\"cheap\"}, so a\n   *  consumer following our own instruction to gate on `ok` passed the gate and\n   *  then sent the literal string \"cheap\" to a provider as a model id. A\n   *  success-shaped non-answer is worse than an error, because an error gets\n   *  handled and a shape does not.\n   *\n   *  Set this when you need \"a model you actually know about\". Off by default so\n   *  no existing caller changes behaviour. */\n  requireKnown?: boolean;\n}\n\n/** The shared status read — UI pickers grey out `available:false` rows. */\nexport function listModels(opts: { provider?: string } = {}): ModelStatus[] {\n  return allEntries(opts.provider);\n}\n\n/** Is this id/alias currently usable? Untracked ids are fail-open (true) unless\n *  the caller asked for requireKnown. */\nfunction isAvailable(requested: string, requireKnown = false): boolean {\n  const e = getEntry(requested);\n  if (!e) return !requireKnown; // fail-open on unknown, unless gating\n  return e.available;\n}\n\n/**\n * Resolve a requested model (id or alias) to one that is actually usable.\n * Synchronous + offline by contract (cardmem #4842) — reads the registry only.\n *\n * - Available → pass through ({ ok:true, fellBack:false }).\n * - Unavailable + a fallback that IS available → swap ({ ok:false, fellBack:true }).\n * - Unavailable + no usable fallback → throw (throwIfUnavailable) or return ok:false.\n * - Unknown id → treated available (never block a model we do not track).\n */\nexport function resolveModel(requested: string, opts: ResolveOptions = {}): ResolveResult {\n  const id = canonicalId(requested) ?? requested;\n  const entry = getEntry(requested);\n  const provider = opts.provider ?? entry?.provider;\n\n  if (isAvailable(requested, opts.requireKnown)) {\n    return {\n      ok: true,\n      model: id,\n      requested: id,\n      provider,\n      fellBack: false,\n      status: entry?.status ?? \"unknown\",\n      // A green gate that hides a known caveat is the failure this whole card is\n      // about, one level up: the answer is shaped like \"fine\" and the warning is\n      // somewhere else. If the row has a note, the caller gets it with the yes.\n      ...(entry?.note ? { note: entry.note } : {}),\n    };\n  }\n\n  // Requested is suspended — walk the fallback chain for the first available one.\n  const chain = opts.fallback === undefined ? [] : Array.isArray(opts.fallback) ? opts.fallback : [opts.fallback];\n  for (const fb of chain) {\n    if (isAvailable(fb, opts.requireKnown)) {\n      const fbId = canonicalId(fb) ?? fb;\n      return {\n        ok: false,\n        model: fbId,\n        requested: id,\n        provider,\n        fellBack: true,\n        status: entry?.status ?? \"suspended\",\n        reason: entry?.note ?? `${id} is unavailable`,\n      };\n    }\n  }\n\n  // No usable fallback.\n  const unknownAndGating = !entry && opts.requireKnown;\n  const reason = unknownAndGating\n    ? `${id} is not a model this registry knows — requireKnown was set, so it is not assumed usable`\n    : (entry?.note ?? `${id} is unavailable`);\n  if (opts.throwIfUnavailable) {\n    throw new ModelUnavailableError(id, reason, provider);\n  }\n  return {\n    ok: false,\n    model: id,\n    requested: id,\n    provider,\n    fellBack: false,\n    status: entry?.status ?? \"unknown\",\n    reason,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -2271,6 +2271,24 @@ declare function createAI(config?: AiConfig): AiClient;
 /** Pull the first JSON value out of a model reply (tolerates ```json fences + prose). */
 declare function parseJsonLoose(text: string): unknown;
 type ChatVision = Pick<AiClient, "chat" | "vision">;
+/** F052.2 — resolve the model's answer to one of the CALLER's labels, or to null.
+ *
+ *  Reported by helpdesk from a live customer ticket (BR-2WYHD, 15 September 2026). They
+ *  pass labels carrying their own description — `"virker-ikke — noget er i stykker…"` —
+ *  and the model answered `"virker-ikke"`, the canonical short form. That IS in their
+ *  taxonomy. Exact equality threw a correct answer away, and it failed in the green
+ *  direction: `label: null` reads as "the model could not decide", a legitimate outcome
+ *  nobody investigates. The gradient runs TOWARD the bug — the better a consumer fills in
+ *  the description, the longer the label, the likelier the model answers with the head.
+ *
+ *  NO SEPARATOR PARAMETER, deliberately. helpdesk proposed splitting on a separator and
+ *  flagged themselves that hardcoding an em-dash just moves the cliff. A PREFIX needs no
+ *  separator at all: "virker-ikke" is a prefix of the decorated label, whatever joins them.
+ *
+ *  AND AMBIGUITY MUST STAY null. If the answer prefixes TWO labels ("betaling" against
+ *  "betaling — kort" and "betaling — faktura"), picking one would turn a discarded correct
+ *  answer into a confident wrong one — a downgrade wearing a fix's clothes. */
+declare function matchLabel(answer: unknown, labels: string[]): string | null;
 declare function makeContracts(client: ChatVision): Contracts;
 
 /** Convert SDK tools to a provider's request format. */
@@ -2534,8 +2552,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.47.0";
-declare const SDK_TAG: "@broberg/ai-sdk@0.47.0";
+declare const VERSION: "0.48.0";
+declare const SDK_TAG: "@broberg/ai-sdk@0.48.0";
 
 /** Built-in defaults. Every entry is overridable via AiConfig.defaults or a
  *  per-call override.
@@ -3009,4 +3027,4 @@ interface StreamTransportRequest extends TransportRequest {
  */
 declare function streamTransport(req: StreamTransportRequest): AsyncIterable<string>;
 
-export { AZURE_DANISH_VOICES, AZURE_DANISH_VOICE_LIST, type AiClient, type AiConfig, type AlignedWordTimings, type AzureVoiceInfo, type AzureWordBoundary, type BatchJob, type BatchRequestItem, type BatchResultItem, type BflAdapterConfig, type BflCredits, type BudgetConfig, BudgetExceededError, BudgetGuard, type BudgetStore, CONFIG_DERIVED_HOSTS, type CallOptions, type Capability, type ChatInput, type ChatRequest, type ChatResult, type ChatStreamEvent, type CheckVoiceOptions, type ClassifyInput, type ClassifyResult, type ContentPart, type Contracts, type CostQuery, type CostSink, type CostSummary, type CostSummaryQuery, type CostTimeseriesQuery, DEFAULT_BASE_URLS, DEFAULT_TIER_MAP, type DesignInput, type DesignResult, type DialogueRequest, type DialogueTurn, type DiscordSinkConfig, ELEVENLABS_DANISH_VOICES, type EmbeddingInput, type EmbeddingRequest, type EmbeddingResult, type ExtractInput, type ExtractResult, type FalAdapterConfig, type FixedHostProvider, type HttpResponse, type ImageInput, type ImageRequest, type ImageResult, LOCALLY_PINNED_HOSTS, type LoraWeight, type Message, type MockupInput, type MockupResult, type ModerationInput, type ModerationItem, type ModerationRequest, type ModerationResult, type OcrInput, type OcrPage, type OcrRequest, type OcrResult, type OpenAICompatibleConfig, type PodcastInput, type PodcastResult, type PricingEntry, type ProviderAdapter, type RefreshOptions, type RefreshResult, type Region, type RerankInput, type RerankResult, type Role, type RouteForecast, SDK_TAG, type SqliteBudgetStoreConfig, type SqliteSinkConfig, StreamHttpError, type SubprocessResponse, type Tier, type TierSpec, type Tool, type ToolCall, type TrainStyleInput, type TrainStyleRequest, type TrainStyleResult, type TranscribeInput, type TranscribeRequest, type TranscribeResult, type TranslateInput, type TranslateResult, type Transport, type TransportRequest, type TransportResponse, type TtsInput, type TtsRequest, type UpmetricsCostClientConfig, UpmetricsCostError, type UpmetricsCostRow, type UpmetricsCostSummary, type UpmetricsCostTimeseries, type UpmetricsSinkConfig, type Usage, VERSION, type VideoInput, type VisionInput, type VoiceInfo, type VoiceProvider, type VoiceResolveResult, type VoiceStatus, VoiceUnavailableError, type WordTiming, aiConfigSchema, alignWordTimings, anthropicAdapter, anthropicApiAdapter, anthropicSubprocessAdapter, azureAdapter, bflAdapter, bflCredits, chatInputSchema, checkVoice, classifyRegionName, computeCost, createAI, deepinfraAdapter, deeplAdapter, deepseekAdapter, defaultBaseUrl, defaultProviders, discordSink, elevenlabsAdapter, embeddingInputSchema, falAdapter, falStubAdapter, freshUsage, fromProviderToolCall, geminiAdapter, getCostSummary, getPrice, httpTransport, imageInputSchema, listAzureDanishVoices, listVoices, makeContracts, makeOpenAICompatibleAdapter, messageSchema, mistralAdapter, mistralStubAdapter, multiSink, noopSink, openaiAdapter, openaiStubAdapter, openrouterAdapter, parseClaudeCliJson, parseJsonLoose, refreshAvailability, regionOfHost, regionOfProvider, requestyAdapter, resetRefreshState, resetRegistry, resolveAzureVoice, resolveTier, resolveVoice, sqliteBudgetStore, sqliteSink, streamTransport, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, upmetricsCostClient, upmetricsSink, usdFromMicro, vertexAdapter, visionInputSchema, wouldProviderRouteTo, wouldRouteTo };
+export { AZURE_DANISH_VOICES, AZURE_DANISH_VOICE_LIST, type AiClient, type AiConfig, type AlignedWordTimings, type AzureVoiceInfo, type AzureWordBoundary, type BatchJob, type BatchRequestItem, type BatchResultItem, type BflAdapterConfig, type BflCredits, type BudgetConfig, BudgetExceededError, BudgetGuard, type BudgetStore, CONFIG_DERIVED_HOSTS, type CallOptions, type Capability, type ChatInput, type ChatRequest, type ChatResult, type ChatStreamEvent, type CheckVoiceOptions, type ClassifyInput, type ClassifyResult, type ContentPart, type Contracts, type CostQuery, type CostSink, type CostSummary, type CostSummaryQuery, type CostTimeseriesQuery, DEFAULT_BASE_URLS, DEFAULT_TIER_MAP, type DesignInput, type DesignResult, type DialogueRequest, type DialogueTurn, type DiscordSinkConfig, ELEVENLABS_DANISH_VOICES, type EmbeddingInput, type EmbeddingRequest, type EmbeddingResult, type ExtractInput, type ExtractResult, type FalAdapterConfig, type FixedHostProvider, type HttpResponse, type ImageInput, type ImageRequest, type ImageResult, LOCALLY_PINNED_HOSTS, type LoraWeight, type Message, type MockupInput, type MockupResult, type ModerationInput, type ModerationItem, type ModerationRequest, type ModerationResult, type OcrInput, type OcrPage, type OcrRequest, type OcrResult, type OpenAICompatibleConfig, type PodcastInput, type PodcastResult, type PricingEntry, type ProviderAdapter, type RefreshOptions, type RefreshResult, type Region, type RerankInput, type RerankResult, type Role, type RouteForecast, SDK_TAG, type SqliteBudgetStoreConfig, type SqliteSinkConfig, StreamHttpError, type SubprocessResponse, type Tier, type TierSpec, type Tool, type ToolCall, type TrainStyleInput, type TrainStyleRequest, type TrainStyleResult, type TranscribeInput, type TranscribeRequest, type TranscribeResult, type TranslateInput, type TranslateResult, type Transport, type TransportRequest, type TransportResponse, type TtsInput, type TtsRequest, type UpmetricsCostClientConfig, UpmetricsCostError, type UpmetricsCostRow, type UpmetricsCostSummary, type UpmetricsCostTimeseries, type UpmetricsSinkConfig, type Usage, VERSION, type VideoInput, type VisionInput, type VoiceInfo, type VoiceProvider, type VoiceResolveResult, type VoiceStatus, VoiceUnavailableError, type WordTiming, aiConfigSchema, alignWordTimings, anthropicAdapter, anthropicApiAdapter, anthropicSubprocessAdapter, azureAdapter, bflAdapter, bflCredits, chatInputSchema, checkVoice, classifyRegionName, computeCost, createAI, deepinfraAdapter, deeplAdapter, deepseekAdapter, defaultBaseUrl, defaultProviders, discordSink, elevenlabsAdapter, embeddingInputSchema, falAdapter, falStubAdapter, freshUsage, fromProviderToolCall, geminiAdapter, getCostSummary, getPrice, httpTransport, imageInputSchema, listAzureDanishVoices, listVoices, makeContracts, makeOpenAICompatibleAdapter, matchLabel, messageSchema, mistralAdapter, mistralStubAdapter, multiSink, noopSink, openaiAdapter, openaiStubAdapter, openrouterAdapter, parseClaudeCliJson, parseJsonLoose, refreshAvailability, regionOfHost, regionOfProvider, requestyAdapter, resetRefreshState, resetRegistry, resolveAzureVoice, resolveTier, resolveVoice, sqliteBudgetStore, sqliteSink, streamTransport, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, upmetricsCostClient, upmetricsSink, usdFromMicro, vertexAdapter, visionInputSchema, wouldProviderRouteTo, wouldRouteTo };

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   resolveModel,
   resolveTier,
   setAvailability
-} from "./chunk-ZFWSLSE7.js";
+} from "./chunk-SWV5YIEE.js";
 import {
   DEFAULT_CLIP_SEC,
   MEDIA_PRICING_CHECKED_AT,
@@ -2876,6 +2876,23 @@ function parseJsonLoose(text) {
   const end = Math.max(lastObj, lastArr);
   return JSON.parse(slice.slice(0, end + 1));
 }
+function matchLabel(answer, labels) {
+  if (typeof answer !== "string") return null;
+  if (labels.includes(answer)) return answer;
+  const norm = (s) => s.trim().replace(/^["'`]|["'`]$/g, "").trim().toLowerCase();
+  const a = norm(answer);
+  if (a.length === 0) return null;
+  const exactish = labels.filter((l) => norm(l) === a);
+  if (exactish.length === 1) return exactish[0];
+  if (exactish.length > 1) return null;
+  const prefixed = labels.filter((l) => {
+    const n = norm(l);
+    if (!n.startsWith(a)) return false;
+    const next = n.charAt(a.length);
+    return next === "" || /\s/.test(next);
+  });
+  return prefixed.length === 1 ? prefixed[0] : null;
+}
 function makeContracts(client) {
   return {
     async mockup(input) {
@@ -2938,10 +2955,10 @@ ${input.text}`,
         purpose: input.purpose ?? "contract:classify"
       });
       const parsed = parseJsonLoose(res.text);
-      const matched = typeof parsed.label === "string" && input.labels.includes(parsed.label);
+      const matched = matchLabel(parsed.label, input.labels);
       return {
-        label: matched ? parsed.label : null,
-        ...matched ? {} : { rawLabel: typeof parsed.label === "string" ? parsed.label : res.text.slice(0, 200) },
+        label: matched,
+        ...matched !== null ? {} : { rawLabel: typeof parsed.label === "string" ? parsed.label : res.text.slice(0, 200) },
         // 0 is a real confidence; "no confidence reported" is not 0.
         confidence: typeof parsed.confidence === "number" ? parsed.confidence : null,
         usage: res.usage
@@ -3362,8 +3379,8 @@ var aiConfigSchema = z.object({
 });
 
 // src/version.ts
-var VERSION = "0.47.0";
-var SDK_TAG = "@broberg/ai-sdk@0.47.0";
+var VERSION = "0.48.0";
+var SDK_TAG = "@broberg/ai-sdk@0.48.0";
 
 // src/cost/sinks/upmetrics.ts
 function upmetricsSink(config) {
@@ -4239,11 +4256,18 @@ CREATE TABLE IF NOT EXISTS ai_usage (
   latency_ms INTEGER NOT NULL,
   subprocess INTEGER NOT NULL DEFAULT 0
 )`;
+function requireBun(what) {
+  if (typeof globalThis.Bun !== "undefined") return;
+  throw new Error(
+    `${what} requires the Bun runtime: it is backed by bun:sqlite, which Node cannot import (ERR_UNSUPPORTED_ESM_URL_SCHEME). Use upmetricsSink() on Node \u2014 it is the canonical sink. This throws at setup on purpose: the client swallows per-call sink errors, so a sink that can never write would otherwise look exactly like one recording zero spend.`
+  );
+}
 async function openDb(dbPath, readonly = false) {
   const { Database } = await import("bun:sqlite");
   return new Database(dbPath, readonly ? { readonly: true } : void 0);
 }
 function sqliteSink(config) {
+  requireBun("sqliteSink");
   let ready = null;
   const init = async () => {
     const db = await openDb(config.dbPath);
@@ -4290,6 +4314,7 @@ function sqliteSink(config) {
   };
 }
 async function getCostSummary(dbPath) {
+  requireBun("getCostSummary");
   const db = await openDb(dbPath);
   db.run(CREATE_TABLE);
   const total = db.query(`SELECT SUM(cost_usd) AS total FROM ai_usage`).get();
@@ -4448,6 +4473,7 @@ export {
   listVoices,
   makeContracts,
   makeOpenAICompatibleAdapter,
+  matchLabel,
   messageSchema,
   mistralAdapter,
   mistralStubAdapter,