@broberg/ai-sdk 0.10.5 → 0.11.0

package/dist/index.d.ts

@@ -1501,6 +1501,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 +1523,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 +1539,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 +1714,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.11.0";
+declare const SDK_TAG: "@broberg/ai-sdk@0.11.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 +1731,104 @@ declare const DEFAULT_TIER_MAP: Record<Tier, TierSpec>;
  */
 declare function resolveTier(tier: Tier, override?: Partial<TierSpec>, configMap?: Partial<Record<Tier, TierSpec>>): TierSpec;
 
+type AvailabilityStatus = "available" | "suspended" | "unknown";
+/** Where a model's current availability came from: the curated default seed,
+ *  or a live provider refresh (Anthropic GET /v1/models). */
+type AvailabilitySource = "default" | "refresh";
+/** One row of the shared status read — what a UI model-picker renders. */
+interface ModelStatus {
+    /** Canonical provider model id, e.g. "claude-fable-5". */
+    id: string;
+    /** Short/tier alias, e.g. "fable" (the first registered alias). */
+    alias?: string;
+    /** "anthropic" | "openai" | "gemini" | "mistral" | … */
+    provider: string;
+    available: boolean;
+    status: AvailabilityStatus;
+    /** Friendly reason, e.g. "suspended — US export-control directive (2026-06-12)". */
+    note?: string;
+    source: AvailabilitySource;
+}
+/** Result of resolveModel — the spawn / call path consumes this synchronously. */
+interface ResolveResult {
+    /** True when the requested model itself is available. */
+    ok: boolean;
+    /** The id to actually use: `requested` when ok, else the first available fallback. */
+    model: string;
+    /** What the caller asked for (id or alias, normalized to the canonical id). */
+    requested: string;
+    provider?: string;
+    /** True when `model` differs from `requested` because we fell back. */
+    fellBack: boolean;
+    status: AvailabilityStatus;
+    /** Why it degraded / why it is unavailable. */
+    reason?: string;
+}
+/** Thrown by resolveModel when the requested model is unavailable, no usable
+ *  fallback exists, and the caller passed `throwIfUnavailable`. Callers flag on
+ *  `.code === "model_unavailable"`. */
+declare class ModelUnavailableError extends Error {
+    readonly code = "model_unavailable";
+    readonly requested: string;
+    readonly provider?: string;
+    readonly note?: string;
+    constructor(requested: string, note?: string, provider?: string);
+}
+
+interface ResolveOptions {
+    /** One id/alias or an ordered chain to try when `requested` is unavailable. */
+    fallback?: string | string[];
+    /** Scope hint (passed through to the result); does not gate lookup. */
+    provider?: string;
+    /** Throw ModelUnavailableError instead of returning ok:false when there is no
+     *  usable fallback. For callers that want to flag rather than degrade. */
+    throwIfUnavailable?: boolean;
+}
+/** The shared status read — UI pickers grey out `available:false` rows. */
+declare function listModels(opts?: {
+    provider?: string;
+}): ModelStatus[];
+/**
+ * Resolve a requested model (id or alias) to one that is actually usable.
+ * Synchronous + offline by contract (cardmem #4842) — reads the registry only.
+ *
+ * - Available → pass through ({ ok:true, fellBack:false }).
+ * - Unavailable + a fallback that IS available → swap ({ ok:false, fellBack:true }).
+ * - Unavailable + no usable fallback → throw (throwIfUnavailable) or return ok:false.
+ * - Unknown id → treated available (never block a model we do not track).
+ */
+declare function resolveModel(requested: string, opts?: ResolveOptions): ResolveResult;
+
+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 +2006,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 AvailabilitySource, type AvailabilityStatus, 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 ModelStatus, ModelUnavailableError, 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 ResolveOptions, type ResolveResult, 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, listModels, makeContracts, makeOpenAICompatibleAdapter, messageSchema, mistralAdapter, multiSink, noopSink, openaiAdapter, openaiStubAdapter, openrouterAdapter, parseClaudeCliJson, parseJsonLoose, refreshAvailability, resetRefreshState, resetRegistry, resolveModel, resolveTier, resolveVoice, sqliteBudgetStore, sqliteSink, streamTransport, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, upmetricsSink, visionInputSchema };

package/dist/index.js

@@ -14,6 +14,138 @@ function resolveTier(tier, override, configMap) {
   return { ...base, ...override };
 }
 
+// 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`
+  };
+}
+
 // src/transport/http.ts
 async function httpTransport(req) {
   if (!req.http) {
@@ -1930,13 +2062,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 +2146,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 +2612,53 @@ var stubProviders = {
 };
 
 // src/version.ts
-var VERSION = "0.10.5";
-var SDK_TAG = "@broberg/ai-sdk@0.10.5";
+var VERSION = "0.11.0";
+var SDK_TAG = "@broberg/ai-sdk@0.11.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 +2891,7 @@ export {
   BudgetGuard,
   DEFAULT_TIER_MAP,
   ELEVENLABS_DANISH_VOICES,
+  ModelUnavailableError,
   SDK_TAG,
   StreamHttpError,
   VERSION,
@@ -2728,6 +2916,7 @@ export {
   getPrice,
   httpTransport,
   imageInputSchema,
+  listModels,
   makeContracts,
   makeOpenAICompatibleAdapter,
   messageSchema,
@@ -2739,6 +2928,10 @@ export {
   openrouterAdapter,
   parseClaudeCliJson,
   parseJsonLoose,
+  refreshAvailability,
+  resetRefreshState,
+  resetRegistry,
+  resolveModel,
   resolveTier,
   resolveVoice,
   sqliteBudgetStore,