@bodhiapp/reference-api-types 0.0.6 → 0.0.8

package/dist/index.d.ts

@@ -228,6 +228,8 @@ export interface ModelFacets {
     status: FacetBucket;
     /** provider slug → model count. */
     provider: FacetBucket;
+    /** family name → model count. Null/absent family is omitted (no key). */
+    family: FacetBucket;
     /** keys: open|closed. */
     open_weights: FacetBucket;
 }
@@ -278,12 +280,20 @@ export interface ProviderDetailResponse {
     provider_shape: ProviderShape;
     bridge: ConfigureBridge;
 }
+/** Sort direction; applied on top of each sort key's natural default. */
+export type SortOrder = 'asc' | 'desc';
 export interface ListProvidersQuery {
     q?: string;
+    /** Repeatable; AND. */
     capability?: Capability | Capability[];
     api_format?: ApiFormatHint | ApiFormatHint[];
+    /** Min input price ($/1M) across the provider's models. */
     pricing_max?: number;
-    sort?: 'rank' | 'name' | 'model_count';
+    /** "free" = cheapest model is $0; "paid" = has a positive price. */
+    pricing?: 'free' | 'paid';
+    /** Defaults: rank/model_count desc, name/api_format asc, pricing asc (free first). */
+    sort?: 'rank' | 'name' | 'model_count' | 'api_format' | 'pricing';
+    order?: SortOrder;
     page?: number;
     page_size?: number;
 }
@@ -303,7 +313,9 @@ export interface ProviderModelsResponse {
     total: number;
 }
 export interface ListProviderModelsQuery {
+    /** Defaults: context desc, name asc, price asc. */
     sort?: 'name' | 'context' | 'price';
+    order?: SortOrder;
 }
 /** One logical model (serving rows grouped by canonical_id). `slug`/`model_id`/`pricing` are the
  * primary (cheapest input_per_m) provider in the group. */
@@ -331,15 +343,25 @@ export interface ListCatalogModelsQuery {
     capability?: Capability | Capability[];
     /** Repeatable; OR. Matches modalities_in ∪ modalities_out. */
     modality?: Modality | Modality[];
+    /** Max input price ($/1M). `pricing_max=0` selects free (zero input price) models. */
     pricing_max?: number;
-    pricing_band?: 'free' | 'low' | 'mid' | 'high';
+    /** Min input price ($/1M). */
+    pricing_min?: number;
+    /** Max output price ($/1M). */
+    pricing_out_max?: number;
     context_min?: number;
     /** Repeatable. "stable" selects rows whose status is ABSENT. */
     status?: ('alpha' | 'beta' | 'deprecated' | 'stable') | ('alpha' | 'beta' | 'deprecated' | 'stable')[];
     /** Repeatable; OR. */
     provider?: string | string[];
+    /** Repeatable; OR. Case-insensitive match on the model family. */
+    family?: string | string[];
     open_weights?: 'open' | 'closed';
-    sort?: 'updated' | 'context' | 'price' | 'name' | 'providers';
+    /** "relevance" ranks by full-text match (bm25); only meaningful with `q`. Default "updated".
+     * "price"/"price_out" sort by input/output price. */
+    sort?: 'relevance' | 'updated' | 'context' | 'price' | 'price_out' | 'name' | 'family' | 'providers';
+    /** Defaults: name/family asc, price/price_out asc, context/providers/updated/relevance desc. */
+    order?: SortOrder;
     page?: number;
     page_size?: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bodhiapp/reference-api-types",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "TypeScript request/response types for the Bodhi Models Reference API (types only — no runtime).",
   "type": "module",
   "types": "dist/index.d.ts",