@broberg/ai-sdk 0.10.5 → 0.12.0

package/dist/chunk-HVZSYNZ5.js

@@ -0,0 +1,141 @@
+// src/availability/registry.ts
+var SUSPENDED_FABLE_MYTHOS = "suspended \u2014 US export-control directive (2026-06-12)";
+var DEFAULTS = [
+  // ── Anthropic ────────────────────────────────────────────────────────────
+  { id: "claude-haiku-4-5", aliases: ["haiku", "fast"], provider: "anthropic", available: true, status: "available", source: "default" },
+  { id: "claude-sonnet-4-6", aliases: ["sonnet", "smart"], provider: "anthropic", available: true, status: "available", source: "default" },
+  { id: "claude-opus-4-8", aliases: ["opus", "powerful"], provider: "anthropic", available: true, status: "available", source: "default" },
+  { id: "claude-fable-5", aliases: ["fable"], provider: "anthropic", available: false, status: "suspended", note: SUSPENDED_FABLE_MYTHOS, source: "default" },
+  { id: "claude-mythos-5", aliases: ["mythos"], provider: "anthropic", available: false, status: "suspended", note: SUSPENDED_FABLE_MYTHOS, source: "default" },
+  // ── Gemini ───────────────────────────────────────────────────────────────
+  { id: "gemini-2.5-flash", aliases: ["gemini-flash"], provider: "gemini", available: true, status: "available", source: "default" },
+  { id: "gemini-2.5-flash-lite", aliases: ["gemini-flash-lite", "video"], provider: "gemini", available: true, status: "available", source: "default" },
+  // ── OpenAI ───────────────────────────────────────────────────────────────
+  { id: "text-embedding-3-small", aliases: ["embedding"], provider: "openai", available: true, status: "available", source: "default" },
+  // ── Mistral (EU / GDPR) ──────────────────────────────────────────────────
+  { id: "mistral-large-latest", aliases: ["mistral-large"], provider: "mistral", available: true, status: "available", source: "default" },
+  { id: "mistral-small-latest", aliases: ["mistral-small"], provider: "mistral", available: true, status: "available", source: "default" }
+];
+var OVERLAY = /* @__PURE__ */ new Map();
+var ALIAS_INDEX = /* @__PURE__ */ new Map();
+function seed() {
+  OVERLAY = new Map(DEFAULTS.map((e) => [e.id, { ...e, aliases: [...e.aliases] }]));
+  ALIAS_INDEX = /* @__PURE__ */ new Map();
+  for (const e of DEFAULTS) for (const a of e.aliases) ALIAS_INDEX.set(a, e.id);
+}
+seed();
+function resetRegistry() {
+  seed();
+}
+function canonicalId(requested) {
+  if (OVERLAY.has(requested)) return requested;
+  return ALIAS_INDEX.get(requested) ?? null;
+}
+function getEntry(requested) {
+  const id = canonicalId(requested);
+  return id ? OVERLAY.get(id) : void 0;
+}
+function allEntries(provider) {
+  const rows = [];
+  for (const e of OVERLAY.values()) {
+    if (provider && e.provider !== provider) continue;
+    rows.push({
+      id: e.id,
+      alias: e.aliases[0],
+      provider: e.provider,
+      available: e.available,
+      status: e.status,
+      note: e.note,
+      source: e.source
+    });
+  }
+  return rows;
+}
+function providerIds(provider) {
+  return [...OVERLAY.values()].filter((e) => e.provider === provider).map((e) => e.id);
+}
+function setAvailability(id, available, note) {
+  const e = OVERLAY.get(id);
+  if (!e) return;
+  e.available = available;
+  e.status = available ? "available" : "suspended";
+  e.source = "refresh";
+  if (note !== void 0) e.note = note;
+  else if (available) e.note = void 0;
+}
+
+// src/availability/types.ts
+var ModelUnavailableError = class extends Error {
+  code = "model_unavailable";
+  requested;
+  provider;
+  note;
+  constructor(requested, note, provider) {
+    super(`model "${requested}" is unavailable${note ? ` (${note})` : ""}`);
+    this.name = "ModelUnavailableError";
+    this.requested = requested;
+    this.note = note;
+    this.provider = provider;
+  }
+};
+
+// src/availability/resolve.ts
+function listModels(opts = {}) {
+  return allEntries(opts.provider);
+}
+function isAvailable(requested) {
+  const e = getEntry(requested);
+  return e ? e.available : true;
+}
+function resolveModel(requested, opts = {}) {
+  const id = canonicalId(requested) ?? requested;
+  const entry = getEntry(requested);
+  const provider = opts.provider ?? entry?.provider;
+  if (isAvailable(requested)) {
+    return {
+      ok: true,
+      model: id,
+      requested: id,
+      provider,
+      fellBack: false,
+      status: entry?.status ?? "unknown"
+    };
+  }
+  const chain = opts.fallback === void 0 ? [] : Array.isArray(opts.fallback) ? opts.fallback : [opts.fallback];
+  for (const fb of chain) {
+    if (isAvailable(fb)) {
+      const fbId = canonicalId(fb) ?? fb;
+      return {
+        ok: false,
+        model: fbId,
+        requested: id,
+        provider,
+        fellBack: true,
+        status: entry?.status ?? "suspended",
+        reason: entry?.note ?? `${id} is unavailable`
+      };
+    }
+  }
+  if (opts.throwIfUnavailable) {
+    throw new ModelUnavailableError(id, entry?.note, provider);
+  }
+  return {
+    ok: false,
+    model: id,
+    requested: id,
+    provider,
+    fellBack: false,
+    status: entry?.status ?? "suspended",
+    reason: entry?.note ?? `${id} is unavailable`
+  };
+}
+
+export {
+  resetRegistry,
+  providerIds,
+  setAvailability,
+  ModelUnavailableError,
+  listModels,
+  resolveModel
+};
+//# sourceMappingURL=chunk-HVZSYNZ5.js.map

package/dist/chunk-HVZSYNZ5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/availability/registry.ts","../src/availability/types.ts","../src/availability/resolve.ts"],"sourcesContent":["// 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 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. Mirrors DEFAULT_TIER_MAP model ids (src/routing/tier-map.ts)\n *  + the models documented in CLAUDE.md, plus the two ids Anthropic suspended\n *  globally on 2026-06-12. Aliases are the tier / short names a caller or picker\n *  may pass instead of the canonical id. */\nconst DEFAULTS: RegistryEntry[] = [\n  // ── Anthropic ────────────────────────────────────────────────────────────\n  { id: \"claude-haiku-4-5\", aliases: [\"haiku\", \"fast\"], provider: \"anthropic\", available: true, status: \"available\", source: \"default\" },\n  { id: \"claude-sonnet-4-6\", aliases: [\"sonnet\", \"smart\"], provider: \"anthropic\", available: true, status: \"available\", source: \"default\" },\n  { id: \"claude-opus-4-8\", aliases: [\"opus\", \"powerful\"], provider: \"anthropic\", available: true, status: \"available\", source: \"default\" },\n  { id: \"claude-fable-5\", aliases: [\"fable\"], provider: \"anthropic\", available: false, status: \"suspended\", note: SUSPENDED_FABLE_MYTHOS, 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\", \"video\"], provider: \"gemini\", available: true, status: \"available\", source: \"default\" },\n  // ── OpenAI ───────────────────────────────────────────────────────────────\n  { id: \"text-embedding-3-small\", aliases: [\"embedding\"], provider: \"openai\", available: true, status: \"available\", 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-small-latest\", aliases: [\"mistral-small\"], provider: \"mistral\", available: true, status: \"available\", source: \"default\" },\n];\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}\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}\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). */\nfunction isAvailable(requested: string): boolean {\n  const e = getEntry(requested);\n  return e ? e.available : true; // fail-open on unknown\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)) {\n    return {\n      ok: true,\n      model: id,\n      requested: id,\n      provider,\n      fellBack: false,\n      status: entry?.status ?? \"unknown\",\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)) {\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  if (opts.throwIfUnavailable) {\n    throw new ModelUnavailableError(id, entry?.note, provider);\n  }\n  return {\n    ok: false,\n    model: id,\n    requested: id,\n    provider,\n    fellBack: false,\n    status: entry?.status ?? \"suspended\",\n    reason: entry?.note ?? `${id} is unavailable`,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+export { AvailabilitySource, AvailabilityStatus, ModelStatus, ModelUnavailableError, ResolveOptions, ResolveResult, listModels, resolveModel } from './registry.js';
 
 /** How a call reaches the model. `http` = provider REST API; `subprocess` = local
  *  `claude -p` CLI (Max plan, costUsd 0). */
@@ -1501,6 +1502,16 @@ declare const aiConfigSchema: z.ZodObject<{
         perCallUsd?: number | undefined;
         rollingUsd?: number | undefined;
     }>>;
+    availability: z.ZodOptional<z.ZodObject<{
+        autoResolve: z.ZodOptional<z.ZodBoolean>;
+        fallback: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    }, "strip", z.ZodTypeAny, {
+        fallback?: string | string[] | undefined;
+        autoResolve?: boolean | undefined;
+    }, {
+        fallback?: string | string[] | undefined;
+        autoResolve?: boolean | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     defaults?: Partial<Record<"fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding", {
         provider: string;
@@ -1513,6 +1524,10 @@ declare const aiConfigSchema: z.ZodObject<{
         perCallUsd?: number | undefined;
         rollingUsd?: number | undefined;
     } | undefined;
+    availability?: {
+        fallback?: string | string[] | undefined;
+        autoResolve?: boolean | undefined;
+    } | undefined;
 }, {
     defaults?: Partial<Record<"fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding", {
         provider: string;
@@ -1525,6 +1540,10 @@ declare const aiConfigSchema: z.ZodObject<{
         perCallUsd?: number | undefined;
         rollingUsd?: number | undefined;
     } | undefined;
+    availability?: {
+        fallback?: string | string[] | undefined;
+        autoResolve?: boolean | undefined;
+    } | undefined;
 }>;
 type ChatInput = z.infer<typeof chatInputSchema>;
 type VisionInput = z.infer<typeof visionInputSchema>;
@@ -1696,8 +1715,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.10.5";
-declare const SDK_TAG: "@broberg/ai-sdk@0.10.5";
+declare const VERSION: "0.12.0";
+declare const SDK_TAG: "@broberg/ai-sdk@0.12.0";
 
 /** Built-in defaults. Every entry is overridable via AiConfig.defaults or a
  *  per-call override. Model IDs are current at scaffold time; callers pin their
@@ -1713,6 +1732,36 @@ declare const DEFAULT_TIER_MAP: Record<Tier, TierSpec>;
  */
 declare function resolveTier(tier: Tier, override?: Partial<TierSpec>, configMap?: Partial<Record<Tier, TierSpec>>): TierSpec;
 
+interface RefreshOptions {
+    /** Only "anthropic" is wired in v1 (where the incident hit). */
+    provider?: "anthropic";
+    /** Injectable for tests. Defaults to global fetch. */
+    fetch?: typeof fetch;
+    /** Defaults to process.env.ANTHROPIC_API_KEY. */
+    apiKey?: string;
+    /** Min ms between live fetches for a provider (default 1h). */
+    ttlMs?: number;
+    /** Injectable clock for deterministic TTL tests. Defaults to Date.now(). */
+    now?: number;
+}
+interface RefreshResult {
+    refreshed: boolean;
+    checked: number;
+    markedUnavailable: string[];
+}
+/** Reset the TTL bookkeeping. For tests. */
+declare function resetRefreshState(): void;
+/**
+ * Reconcile tracked models against the provider's live list. For Anthropic:
+ * GET /v1/models — any tracked anthropic id NOT in the live set is marked
+ * unavailable; ids present are (re)marked available. TTL-cached; a fetch within
+ * the window is a no-op. Returns { refreshed:false } on any error or missing key.
+ */
+declare function refreshAvailability(opts?: RefreshOptions): Promise<RefreshResult>;
+
+/** Reset the overlay back to the curated defaults. For tests. */
+declare function resetRegistry(): void;
+
 /**
  * Cost in USD for a call. cache-read/creation tokens are priced separately when
  * the pricing entry defines rates for them; otherwise they fall back to the
@@ -1890,4 +1939,4 @@ interface StreamTransportRequest extends TransportRequest {
  */
 declare function streamTransport(req: StreamTransportRequest): AsyncIterable<string>;
 
-export { type AiClient, type AiConfig, type BatchJob, type BatchRequestItem, type BatchResultItem, type BudgetConfig, BudgetExceededError, BudgetGuard, type BudgetStore, type CallOptions, type Capability, type ChatInput, type ChatRequest, type ChatResult, type ChatStreamEvent, type ClassifyInput, type ClassifyResult, type ContentPart, type Contracts, type CostSink, type CostSummary, 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 HttpResponse, type ImageInput, type ImageRequest, type ImageResult, 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 RerankInput, type RerankResult, type Role, 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 UpmetricsSinkConfig, type Usage, VERSION, type VideoInput, type VisionInput, aiConfigSchema, anthropicAdapter, anthropicApiAdapter, anthropicSubprocessAdapter, chatInputSchema, computeCost, createAI, deepinfraAdapter, defaultProviders, discordSink, elevenlabsAdapter, embeddingInputSchema, falAdapter, falStubAdapter, freshUsage, fromProviderToolCall, geminiAdapter, getCostSummary, getPrice, httpTransport, imageInputSchema, makeContracts, makeOpenAICompatibleAdapter, messageSchema, mistralAdapter, multiSink, noopSink, openaiAdapter, openaiStubAdapter, openrouterAdapter, parseClaudeCliJson, parseJsonLoose, resolveTier, resolveVoice, sqliteBudgetStore, sqliteSink, streamTransport, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, upmetricsSink, visionInputSchema };
+export { type AiClient, type AiConfig, type BatchJob, type BatchRequestItem, type BatchResultItem, type BudgetConfig, BudgetExceededError, BudgetGuard, type BudgetStore, type CallOptions, type Capability, type ChatInput, type ChatRequest, type ChatResult, type ChatStreamEvent, type ClassifyInput, type ClassifyResult, type ContentPart, type Contracts, type CostSink, type CostSummary, 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 HttpResponse, type ImageInput, type ImageRequest, type ImageResult, 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 RerankInput, type RerankResult, type Role, 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 UpmetricsSinkConfig, type Usage, VERSION, type VideoInput, type VisionInput, aiConfigSchema, anthropicAdapter, anthropicApiAdapter, anthropicSubprocessAdapter, chatInputSchema, computeCost, createAI, deepinfraAdapter, defaultProviders, discordSink, elevenlabsAdapter, embeddingInputSchema, falAdapter, falStubAdapter, freshUsage, fromProviderToolCall, geminiAdapter, getCostSummary, getPrice, httpTransport, imageInputSchema, makeContracts, makeOpenAICompatibleAdapter, messageSchema, mistralAdapter, multiSink, noopSink, openaiAdapter, openaiStubAdapter, openrouterAdapter, parseClaudeCliJson, parseJsonLoose, refreshAvailability, resetRefreshState, resetRegistry, resolveTier, resolveVoice, sqliteBudgetStore, sqliteSink, streamTransport, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, upmetricsSink, visionInputSchema };

package/dist/index.js

@@ -1,3 +1,12 @@
+import {
+  ModelUnavailableError,
+  listModels,
+  providerIds,
+  resetRegistry,
+  resolveModel,
+  setAvailability
+} from "./chunk-HVZSYNZ5.js";
+
 // src/routing/tier-map.ts
 var DEFAULT_TIER_MAP = {
   fast: { provider: "anthropic", model: "claude-haiku-4-5", transport: "http" },
@@ -1930,13 +1939,18 @@ var budgetSchema = z.object({
   perCallUsd: z.number().positive().optional(),
   rollingUsd: z.number().positive().optional()
 });
+var availabilitySchema = z.object({
+  autoResolve: z.boolean().optional(),
+  fallback: z.union([z.string(), z.array(z.string())]).optional()
+});
 var aiConfigSchema = z.object({
   defaults: z.record(tierSchema, tierSpecSchema).optional(),
   // Functions can't be deeply validated — z.custom asserts the TS type and
   // passes the value through untouched.
   providers: z.record(z.string(), z.custom()).optional(),
   costSink: z.custom().optional(),
-  budget: budgetSchema.optional()
+  budget: budgetSchema.optional(),
+  availability: availabilitySchema.optional()
 });
 
 // src/client.ts
@@ -2009,9 +2023,14 @@ function createAI(config = {}) {
     msgs.push({ role: "user", content: input.prompt ?? "" });
     return msgs;
   }
+  function applyAvailability(spec) {
+    if (!cfg.availability?.autoResolve) return spec;
+    const r = resolveModel(spec.model, { fallback: cfg.availability.fallback, provider: spec.provider });
+    return r.fellBack ? { ...spec, model: r.model } : spec;
+  }
   async function runCapability(opts) {
     const routes = [
-      opts.primary,
+      applyAvailability(opts.primary),
       ...(opts.fallback ?? []).map(
         (f) => typeof f === "string" ? resolveTier(f, void 0, cfg.defaults) : f
       )
@@ -2470,8 +2489,53 @@ var stubProviders = {
 };
 
 // src/version.ts
-var VERSION = "0.10.5";
-var SDK_TAG = "@broberg/ai-sdk@0.10.5";
+var VERSION = "0.12.0";
+var SDK_TAG = "@broberg/ai-sdk@0.12.0";
+
+// src/availability/refresh.ts
+var NOT_REFRESHED = { refreshed: false, checked: 0, markedUnavailable: [] };
+var DEFAULT_TTL_MS = 60 * 60 * 1e3;
+var ANTHROPIC_MODELS_URL = "https://api.anthropic.com/v1/models";
+var lastRefreshAt = /* @__PURE__ */ new Map();
+function resetRefreshState() {
+  lastRefreshAt.clear();
+}
+async function refreshAvailability(opts = {}) {
+  const provider = opts.provider ?? "anthropic";
+  if (provider !== "anthropic") return NOT_REFRESHED;
+  const ttl = opts.ttlMs ?? DEFAULT_TTL_MS;
+  const now = opts.now ?? Date.now();
+  const last = lastRefreshAt.get(provider);
+  if (last !== void 0 && now - last < ttl) return NOT_REFRESHED;
+  const apiKey = opts.apiKey ?? process.env.ANTHROPIC_API_KEY;
+  if (!apiKey) return NOT_REFRESHED;
+  const f = opts.fetch ?? fetch;
+  let liveIds;
+  try {
+    const res = await f(ANTHROPIC_MODELS_URL, {
+      headers: { "x-api-key": apiKey, "anthropic-version": "2023-06-01", accept: "application/json" }
+    });
+    if (!res.ok) return NOT_REFRESHED;
+    const json = await res.json();
+    liveIds = new Set((json.data ?? []).map((m) => m.id).filter((id) => typeof id === "string"));
+  } catch {
+    return NOT_REFRESHED;
+  }
+  if (liveIds.size === 0) return NOT_REFRESHED;
+  const tracked = providerIds(provider);
+  const markedUnavailable = [];
+  for (const id of tracked) {
+    const live = liveIds.has(id);
+    if (live) {
+      setAvailability(id, true);
+    } else {
+      setAvailability(id, false, "not in provider model list (live refresh)");
+      markedUnavailable.push(id);
+    }
+  }
+  lastRefreshAt.set(provider, now);
+  return { refreshed: true, checked: tracked.length, markedUnavailable };
+}
 
 // src/cost/budget-store.ts
 function sqliteBudgetStore(config) {
@@ -2704,6 +2768,7 @@ export {
   BudgetGuard,
   DEFAULT_TIER_MAP,
   ELEVENLABS_DANISH_VOICES,
+  ModelUnavailableError,
   SDK_TAG,
   StreamHttpError,
   VERSION,
@@ -2728,6 +2793,7 @@ export {
   getPrice,
   httpTransport,
   imageInputSchema,
+  listModels,
   makeContracts,
   makeOpenAICompatibleAdapter,
   messageSchema,
@@ -2739,6 +2805,10 @@ export {
   openrouterAdapter,
   parseClaudeCliJson,
   parseJsonLoose,
+  refreshAvailability,
+  resetRefreshState,
+  resetRegistry,
+  resolveModel,
   resolveTier,
   resolveVoice,
   sqliteBudgetStore,