@shop-os/modelkit 0.1.11 → 0.2.2

package/dist/catalog.d.cts

@@ -1,4 +1,5 @@
 import { ImageModel, experimental_generateVideo } from 'ai';
+import { z } from 'zod';
 
 /**
  * Canonical vocabulary shared by every adapter. Adapters translate these
@@ -417,11 +418,59 @@ declare class Catalog {
     }): CatalogModel[];
     /** Merge rows by id. Used for catalogOverride. */
     withOverrides(rows: CatalogModel[]): Catalog;
+    /** Atomically swap every row. Builds the maps first so a bad batch throws before anything changes. */
+    replace(rows: CatalogModel[]): void;
 }
 
 /** Seeded from Cowork, Space Builder and trigger-workflows. See catalog/*.ts. */
 declare const MODELS: CatalogModel[];
 
+declare const ADAPTER_IDS: readonly ["ai-sdk-text", "google-image", "openai-image", "google-genai", "ark", "fal", "replicate", "prodia", "higgsfield", "xai-video"];
+declare const CatalogModelSchema: z.ZodType<CatalogModel>;
+declare const CatalogSchema: z.ZodType<CatalogModel[]>;
+
+type CatalogOrigin = "remote" | "last-good" | "snapshot";
+interface LiveCatalogState {
+    catalog: Catalog;
+    memo: Promise<unknown> | undefined;
+    timer: ReturnType<typeof setInterval> | undefined;
+    revision: string | undefined;
+    origin: CatalogOrigin;
+}
+declare const liveState: LiveCatalogState;
+declare const liveCatalog: Catalog;
+
+interface CatalogCache {
+    get(): Promise<string | null>;
+    set(json: string): Promise<void>;
+}
+type CatalogAuth = {
+    bearer: string;
+} | {
+    apiKey: string;
+};
+interface CatalogSource {
+    baseUrl: string;
+    auth: CatalogAuth;
+    ttlMs?: number;
+    /** Abort a fetch after this many ms. Default 10 s. */
+    timeoutMs?: number;
+    cache?: CatalogCache;
+    fetch?: typeof fetch;
+    logger?: Pick<Console, "debug" | "info" | "warn" | "error">;
+}
+
+interface PrimeCatalogResult {
+    origin: CatalogOrigin;
+    rowCount: number;
+    revision?: string;
+    error?: string;
+}
+/** Fetch, validate, swap into liveCatalog. Never throws. Second call returns the same promise. */
+declare function primeCatalog(source: CatalogSource): Promise<PrimeCatalogResult>;
+/** Test seam: stop the refresh timer, reset liveCatalog to MODELS and clear the memo. */
+declare function resetLiveCatalog(): void;
+
 declare const IMAGE_MODELS: CatalogModel[];
 
 declare const VIDEO_MODELS: CatalogModel[];
@@ -476,4 +525,4 @@ declare function isModelKitError(err: unknown): err is ModelKitError;
 /** Resolve caller options against a catalog row, dispatching on `model.type`. */
 declare function resolveOptions(model: CatalogModel, request: ImageRequest | VideoRequest | AudioRequest, onUnsupported?: OnUnsupported): ResolveResult<ImageRequest | VideoRequest | AudioRequest>;
 
-export { type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogCapabilities, type CatalogDisplay, type CatalogModel, type GeneratedImage, IMAGE_MODELS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, type JsonPrimitive, type JsonValue, type Lifecycle, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, OTHER_MODELS, type OnUnsupported, type OutputFormat, type PricingKind, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type ReferenceLimits, type RequiredInput, type ResolveResult, type Routing, type SupportedOption, TEXT_MODELS, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_MODELS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type Warning, isModelKitError, nearestAspectRatio, resolveAudioOptions, resolveImageOptions, resolveOptions, resolveVideoOptions };
+export { ADAPTER_IDS, type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogModel, CatalogModelSchema, type CatalogOrigin, CatalogSchema, type CatalogSource, type GeneratedImage, IMAGE_MODELS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, type JsonPrimitive, type JsonValue, type Lifecycle, type LiveCatalogState, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, OTHER_MODELS, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type ReferenceLimits, type RequiredInput, type ResolveResult, type Routing, type SupportedOption, TEXT_MODELS, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_MODELS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type Warning, isModelKitError, liveCatalog, liveState, nearestAspectRatio, primeCatalog, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveOptions, resolveVideoOptions };

package/dist/catalog.d.ts

@@ -1,4 +1,5 @@
 import { ImageModel, experimental_generateVideo } from 'ai';
+import { z } from 'zod';
 
 /**
  * Canonical vocabulary shared by every adapter. Adapters translate these
@@ -417,11 +418,59 @@ declare class Catalog {
     }): CatalogModel[];
     /** Merge rows by id. Used for catalogOverride. */
     withOverrides(rows: CatalogModel[]): Catalog;
+    /** Atomically swap every row. Builds the maps first so a bad batch throws before anything changes. */
+    replace(rows: CatalogModel[]): void;
 }
 
 /** Seeded from Cowork, Space Builder and trigger-workflows. See catalog/*.ts. */
 declare const MODELS: CatalogModel[];
 
+declare const ADAPTER_IDS: readonly ["ai-sdk-text", "google-image", "openai-image", "google-genai", "ark", "fal", "replicate", "prodia", "higgsfield", "xai-video"];
+declare const CatalogModelSchema: z.ZodType<CatalogModel>;
+declare const CatalogSchema: z.ZodType<CatalogModel[]>;
+
+type CatalogOrigin = "remote" | "last-good" | "snapshot";
+interface LiveCatalogState {
+    catalog: Catalog;
+    memo: Promise<unknown> | undefined;
+    timer: ReturnType<typeof setInterval> | undefined;
+    revision: string | undefined;
+    origin: CatalogOrigin;
+}
+declare const liveState: LiveCatalogState;
+declare const liveCatalog: Catalog;
+
+interface CatalogCache {
+    get(): Promise<string | null>;
+    set(json: string): Promise<void>;
+}
+type CatalogAuth = {
+    bearer: string;
+} | {
+    apiKey: string;
+};
+interface CatalogSource {
+    baseUrl: string;
+    auth: CatalogAuth;
+    ttlMs?: number;
+    /** Abort a fetch after this many ms. Default 10 s. */
+    timeoutMs?: number;
+    cache?: CatalogCache;
+    fetch?: typeof fetch;
+    logger?: Pick<Console, "debug" | "info" | "warn" | "error">;
+}
+
+interface PrimeCatalogResult {
+    origin: CatalogOrigin;
+    rowCount: number;
+    revision?: string;
+    error?: string;
+}
+/** Fetch, validate, swap into liveCatalog. Never throws. Second call returns the same promise. */
+declare function primeCatalog(source: CatalogSource): Promise<PrimeCatalogResult>;
+/** Test seam: stop the refresh timer, reset liveCatalog to MODELS and clear the memo. */
+declare function resetLiveCatalog(): void;
+
 declare const IMAGE_MODELS: CatalogModel[];
 
 declare const VIDEO_MODELS: CatalogModel[];
@@ -476,4 +525,4 @@ declare function isModelKitError(err: unknown): err is ModelKitError;
 /** Resolve caller options against a catalog row, dispatching on `model.type`. */
 declare function resolveOptions(model: CatalogModel, request: ImageRequest | VideoRequest | AudioRequest, onUnsupported?: OnUnsupported): ResolveResult<ImageRequest | VideoRequest | AudioRequest>;
 
-export { type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogCapabilities, type CatalogDisplay, type CatalogModel, type GeneratedImage, IMAGE_MODELS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, type JsonPrimitive, type JsonValue, type Lifecycle, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, OTHER_MODELS, type OnUnsupported, type OutputFormat, type PricingKind, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type ReferenceLimits, type RequiredInput, type ResolveResult, type Routing, type SupportedOption, TEXT_MODELS, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_MODELS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type Warning, isModelKitError, nearestAspectRatio, resolveAudioOptions, resolveImageOptions, resolveOptions, resolveVideoOptions };
+export { ADAPTER_IDS, type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogModel, CatalogModelSchema, type CatalogOrigin, CatalogSchema, type CatalogSource, type GeneratedImage, IMAGE_MODELS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, type JsonPrimitive, type JsonValue, type Lifecycle, type LiveCatalogState, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, OTHER_MODELS, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type ReferenceLimits, type RequiredInput, type ResolveResult, type Routing, type SupportedOption, TEXT_MODELS, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_MODELS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type Warning, isModelKitError, liveCatalog, liveState, nearestAspectRatio, primeCatalog, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveOptions, resolveVideoOptions };