@theokit/sdk 4.12.2 → 4.13.1

package/dist/internal/providers/catalog-loader.d.ts

@@ -6,6 +6,7 @@
  *
  * @internal
  */
+import { type CatalogModel } from "./catalog-schema.js";
 import type { ApiMode, AuthType } from "./types.js";
 export interface ProviderCapabilities {
     supportsToolUse: boolean;
@@ -29,6 +30,13 @@ export interface CatalogEntry {
     modelsUrl?: string;
     hostname?: string;
     extraHeaders?: Record<string, string>;
+    /**
+     * M44 — OPTIONAL per-model data (models.dev shape, snake_case — see `catalog-schema.ts`), keyed by the
+     * BARE model id. Additive: entries without it behave byte-identically to before. The loader indexes this
+     * into the model-info index (`getCatalogModelInfo`) rather than onto `ProviderProfile` (ADR D2 — the
+     * builtins-first registration skip means profile-attached data would never reach builtin providers).
+     */
+    models?: Record<string, CatalogModel>;
 }
 interface LoadOptions {
     _testInjectMalformed?: boolean;

package/dist/internal/providers/catalog-schema.d.ts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+export type Modality = (typeof MODALITIES)[number];
+declare const costSchema: z.ZodObject<{
+    input: z.ZodNumber;
+    output: z.ZodNumber;
+    cache_read: z.ZodOptional<z.ZodNumber>;
+    cache_write: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export declare const catalogModelSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    release_date: z.ZodOptional<z.ZodString>;
+    attachment: z.ZodOptional<z.ZodBoolean>;
+    reasoning: z.ZodOptional<z.ZodBoolean>;
+    temperature: z.ZodOptional<z.ZodBoolean>;
+    tool_call: z.ZodOptional<z.ZodBoolean>;
+    structured_output: z.ZodOptional<z.ZodBoolean>;
+    cache_control: z.ZodOptional<z.ZodBoolean>;
+    cost: z.ZodOptional<z.ZodObject<{
+        input: z.ZodNumber;
+        output: z.ZodNumber;
+        cache_read: z.ZodOptional<z.ZodNumber>;
+        cache_write: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    limit: z.ZodOptional<z.ZodObject<{
+        context: z.ZodNumber;
+        input: z.ZodOptional<z.ZodNumber>;
+        output: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    modalities: z.ZodOptional<z.ZodObject<{
+        input: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            text: "text";
+            image: "image";
+            audio: "audio";
+            video: "video";
+            pdf: "pdf";
+        }>>>;
+        output: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            text: "text";
+            image: "image";
+            audio: "audio";
+            video: "video";
+            pdf: "pdf";
+        }>>>;
+    }, z.core.$loose>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        alpha: "alpha";
+        beta: "beta";
+        deprecated: "deprecated";
+    }>>;
+}, z.core.$loose>;
+export type CatalogModel = z.infer<typeof catalogModelSchema>;
+export type CatalogModelCost = z.infer<typeof costSchema>;
+export {};

package/dist/internal/providers/catalog-source-models-dev.d.ts

@@ -0,0 +1,33 @@
+import { getCatalogModelInfo } from "./catalog-loader.js";
+export interface RefreshModelCatalogOptions {
+    /** Override the source URL (`THEOKIT_MODELS_URL` env also honored). */
+    url?: string;
+    /** Bypass the TTL freshness gate. */
+    force?: boolean;
+    /** Injected for tests. */
+    deps?: {
+        fetch?: typeof fetch;
+        now?: () => number;
+    };
+}
+export interface RefreshModelCatalogResult {
+    /** Where the data came from: a fresh network fetch, the still-fresh disk cache, or skipped entirely. */
+    source: "network" | "cache" | "skipped";
+    /** How many models were patched into the index. */
+    models: number;
+}
+/** The cache file for a source URL (custom URLs get a hash-suffixed name, mirroring OpenCode). */
+export declare function cachePathFor(url: string): string;
+/**
+ * Load an existing disk cache into the index (called by refresh when fresh, or opportunistically by a
+ * consumer at startup — NEVER fetches). Corrupt cache → delete + fall through to vendored data.
+ */
+export declare function loadCacheIntoIndex(url?: string): number;
+/**
+ * Explicitly refresh the model catalog from models.dev (the ONLY network trigger in the subsystem).
+ * Fail-closed: any failure keeps serving the current index (cache or vendored). Kill-switch:
+ * `THEOKIT_DISABLE_MODELS_FETCH`.
+ */
+export declare function refreshModelCatalog(opts?: RefreshModelCatalogOptions): Promise<RefreshModelCatalogResult>;
+/** The enriched per-model view (public via `@theokit/sdk/models`): index lookup by (possibly prefixed) id. */
+export declare function getModelInfo(modelId: string): ReturnType<typeof getCatalogModelInfo>;