@broberg/ai-sdk 0.55.3 → 0.56.1

package/dist/registry.d.ts

@@ -1,91 +1 @@
-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;
-    /** The registry row's caveat, surfaced on the SUCCESS path too (F057.2).
-     *
-     *  `reason` only ever appears when a model is unavailable, so a caveat written
-     *  on an AVAILABLE row — "documented to deprecate 2026-07-24", "preview", a
-     *  known rate limit — was reachable through listModels() and invisible to the
-     *  one caller who most needs it: the gate. A consumer passing requireKnown got
-     *  a clean green with the warning sitting one call away, unread. Carrying it
-     *  here costs an optional field and makes `ok:true` able to say "yes, but". */
-    note?: 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;
-    /** Treat an id we do not track as UNUSABLE instead of fail-open.
-     *
-     *  Default is fail-open: we never block a model we simply do not track. That is
-     *  right for liveness, and wrong for a caller who is GATING — cms measured the
-     *  consequence: resolveModel("cheap") answered {ok:true, model:"cheap"}, so a
-     *  consumer following our own instruction to gate on `ok` passed the gate and
-     *  then sent the literal string "cheap" to a provider as a model id. A
-     *  success-shaped non-answer is worse than an error, because an error gets
-     *  handled and a shape does not.
-     *
-     *  Set this when you need "a model you actually know about". Off by default so
-     *  no existing caller changes behaviour. */
-    requireKnown?: 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;
-
-export { type AvailabilitySource, type AvailabilityStatus, type ModelStatus, ModelUnavailableError, type ResolveOptions, type ResolveResult, listModels, resolveModel };
+export { q as AvailabilitySource, r as AvailabilityStatus, Q as ModelStatus, S as ModelUnavailableError, Z as ResolveOptions, _ as ResolveResult, a0 as TierDescription, a7 as describeTier, a8 as listModels, ab as resolveModel } from './registry-U66vzTm0.js';

package/dist/registry.js

@@ -1,10 +1,13 @@
 import {
   ModelUnavailableError,
+  describeTier,
   listModels,
   resolveModel
-} from "./chunk-PDGFAD66.js";
+} from "./chunk-VMQSIO3J.js";
+import "./chunk-QVMGFHCF.js";
 export {
   ModelUnavailableError,
+  describeTier,
   listModels,
   resolveModel
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@broberg/ai-sdk",
-  "version": "0.55.3",
+  "version": "0.56.1",
   "description": "Unified AI/LLM SDK — one facade, all providers, all capabilities, first-class cost control on every call.",
   "type": "module",
   "license": "FSL-1.1-Apache-2.0",