@broberg/ai-sdk 0.11.0 → 0.13.0

package/dist/registry.d.ts

@@ -0,0 +1,69 @@
+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;
+
+export { type AvailabilitySource, type AvailabilityStatus, type ModelStatus, ModelUnavailableError, type ResolveOptions, type ResolveResult, listModels, resolveModel };

package/dist/registry.js

@@ -0,0 +1,11 @@
+import {
+  ModelUnavailableError,
+  listModels,
+  resolveModel
+} from "./chunk-HVZSYNZ5.js";
+export {
+  ModelUnavailableError,
+  listModels,
+  resolveModel
+};
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@broberg/ai-sdk",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "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",
@@ -20,6 +20,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./registry": {
+      "types": "./dist/registry.d.ts",
+      "import": "./dist/registry.js"
     }
   },
   "scripts": {