@shop-os/modelkit 0.1.7 → 0.1.9

package/dist/index.d.cts

@@ -171,6 +171,15 @@ interface ModelConstraints {
         min: number;
         max: number;
     } | number[];
+    /** Curated UI choices when `durations` is a range; `resolveOptions` ignores it. */
+    durationPresets?: number[];
+    /** Curated quality choices for rows whose `supports` includes "quality". */
+    qualityOptions?: string[];
+    /**
+     * Exact pixel size per aspect ratio for rows an app must size verbatim
+     * (gpt-image-2 keeps its historic WxH contract); callers pass it as `exactSize`.
+     */
+    exactSizes?: Record<string, string>;
     references?: ReferenceLimits;
     requires?: RequiredInput[];
     supports?: SupportedOption[];
@@ -208,6 +217,15 @@ interface CatalogDisplay {
     description: string;
     /** CDN URL of the vendor or model logo. */
     logo?: string;
+    /** Chat picker cost bucket: 1 = cheapest tier (Haiku/Flash/mini), 2 = Sonnet class, 3 = Opus/Pro/frontier. */
+    costTier?: 1 | 2 | 3;
+    /** Chat picker highlight flag. */
+    recommended?: boolean;
+    /**
+     * Picker position: lower comes first; rows without one keep catalog order
+     * after the ordered ones. Set it to surface a new model at the top.
+     */
+    sortOrder?: number;
 }
 /** Capability flags a UI keys off. Absent means false / unknown. */
 interface CatalogCapabilities {
@@ -219,7 +237,8 @@ interface CatalogCapabilities {
     acceptsSourceVideo?: boolean;
     /** Video rows: first/last frames and reference images are mutually exclusive inputs. */
     framesExcludeReferences?: boolean;
-    /** Text rows. */
+    /** Text rows. `reasoning`: the model streams reasoning the UI should surface. */
+    reasoning?: boolean;
     vision?: boolean;
     tools?: boolean;
     structuredOutput?: boolean;
@@ -236,12 +255,27 @@ interface CatalogModel {
     providerModelId: string;
     lifecycle: Lifecycle;
     replacedBy?: string;
+    /**
+     * "catalog" = offered in product pickers (Creative Studio, chat, Space Builder);
+     * "internal" = callable by id only.
+     */
+    exposure: "catalog" | "internal";
     constraints: ModelConstraints;
-    defaults: Partial<Omit<ImageRequest, "model" | "prompt"> & Omit<VideoRequest, "model" | "prompt"> & Omit<AudioRequest, "model" | "prompt">>;
+    defaults: Partial<Omit<ImageRequest, "model" | "prompt"> & Omit<VideoRequest, "model" | "prompt"> & Omit<AudioRequest, "model" | "prompt"> & {
+        temperature?: number;
+    }>;
+    /** Provider options merged under the caller's; text rows carry their reasoning / thinking tuning here. */
     providerOptions?: ProviderOptions;
+    /**
+     * `slug` and `providerLabel` keep an app's historic usage-event names for a
+     * row (e.g. cowork emits `image_gen_<slug>` from provider `<providerLabel>`);
+     * absent means the app derives them from the id and display.provider.
+     */
     usage: {
         unit: UsageUnit;
         modality: UsageModality;
+        slug?: string;
+        providerLabel?: string;
     };
     pricingKind: PricingKind;
     /** Required on every `active` row so a picker can render it without a hand-written catalog. */

package/dist/index.d.ts

@@ -171,6 +171,15 @@ interface ModelConstraints {
         min: number;
         max: number;
     } | number[];
+    /** Curated UI choices when `durations` is a range; `resolveOptions` ignores it. */
+    durationPresets?: number[];
+    /** Curated quality choices for rows whose `supports` includes "quality". */
+    qualityOptions?: string[];
+    /**
+     * Exact pixel size per aspect ratio for rows an app must size verbatim
+     * (gpt-image-2 keeps its historic WxH contract); callers pass it as `exactSize`.
+     */
+    exactSizes?: Record<string, string>;
     references?: ReferenceLimits;
     requires?: RequiredInput[];
     supports?: SupportedOption[];
@@ -208,6 +217,15 @@ interface CatalogDisplay {
     description: string;
     /** CDN URL of the vendor or model logo. */
     logo?: string;
+    /** Chat picker cost bucket: 1 = cheapest tier (Haiku/Flash/mini), 2 = Sonnet class, 3 = Opus/Pro/frontier. */
+    costTier?: 1 | 2 | 3;
+    /** Chat picker highlight flag. */
+    recommended?: boolean;
+    /**
+     * Picker position: lower comes first; rows without one keep catalog order
+     * after the ordered ones. Set it to surface a new model at the top.
+     */
+    sortOrder?: number;
 }
 /** Capability flags a UI keys off. Absent means false / unknown. */
 interface CatalogCapabilities {
@@ -219,7 +237,8 @@ interface CatalogCapabilities {
     acceptsSourceVideo?: boolean;
     /** Video rows: first/last frames and reference images are mutually exclusive inputs. */
     framesExcludeReferences?: boolean;
-    /** Text rows. */
+    /** Text rows. `reasoning`: the model streams reasoning the UI should surface. */
+    reasoning?: boolean;
     vision?: boolean;
     tools?: boolean;
     structuredOutput?: boolean;
@@ -236,12 +255,27 @@ interface CatalogModel {
     providerModelId: string;
     lifecycle: Lifecycle;
     replacedBy?: string;
+    /**
+     * "catalog" = offered in product pickers (Creative Studio, chat, Space Builder);
+     * "internal" = callable by id only.
+     */
+    exposure: "catalog" | "internal";
     constraints: ModelConstraints;
-    defaults: Partial<Omit<ImageRequest, "model" | "prompt"> & Omit<VideoRequest, "model" | "prompt"> & Omit<AudioRequest, "model" | "prompt">>;
+    defaults: Partial<Omit<ImageRequest, "model" | "prompt"> & Omit<VideoRequest, "model" | "prompt"> & Omit<AudioRequest, "model" | "prompt"> & {
+        temperature?: number;
+    }>;
+    /** Provider options merged under the caller's; text rows carry their reasoning / thinking tuning here. */
     providerOptions?: ProviderOptions;
+    /**
+     * `slug` and `providerLabel` keep an app's historic usage-event names for a
+     * row (e.g. cowork emits `image_gen_<slug>` from provider `<providerLabel>`);
+     * absent means the app derives them from the id and display.provider.
+     */
     usage: {
         unit: UsageUnit;
         modality: UsageModality;
+        slug?: string;
+        providerLabel?: string;
     };
     pricingKind: PricingKind;
     /** Required on every `active` row so a picker can render it without a hand-written catalog. */