@hanzo/ui 8.27.59 → 8.27.61

package/dist/models/catalog.d.ts

@@ -1,27 +1,49 @@
 /**
- * @hanzo/ui/models — Model catalog data layer
+ * @hanzo/ui/models — the model catalog, as `GET /v1/models` answers it.
  *
- * Pure, SSR-safe helpers shared by the unified ModelSelector. No React,
- * no browser globals — usable on the server, in edge runtimes, or the client.
+ * Pure and SSR-safe: no React, no browser globals. The picker and every host's
+ * explorer read the same rows through the same helpers, so a model is in the
+ * same group, with the same label and the same price, on every surface.
  *
- * ModelCatalogEntry is the gateway/OpenAI-shaped record ({ id, owned_by, ... })
- * returned by `${baseUrl}/models`. It is intentionally distinct from the
- * registry-shaped ZenModelLike in ./types (which drives the marketing cards).
+ * Every fact here is a field the gateway publishes — `class`, `family`,
+ * `inputs`, `outputs`, `supports_*`, `pricing`. Nothing is read from an id's
+ * spelling. A field the gateway leaves out is absent here too: a model with no
+ * price has no price, never a price of zero.
  */
+import type { PausedModel } from '../product/limits.js';
+/** The class a model is sold in, as the usage policy reads it. */
+export type ModelClass = 'premium' | 'ours' | 'free';
+/** Hanzo's own families. Every other model is grouped by who made it. */
+export type ModelFamily = 'enso' | 'zen' | 'kai' | 'jev' | 'zoo';
+/** What a model can be asked to do, from the modalities and capabilities it publishes. */
+export type Capability = 'chat' | 'vision' | 'embeddings' | 'rerank' | 'image' | 'video' | 'audio' | 'decision' | 'tools' | 'reasoning';
+/** List price, USD per 1M tokens, each side absent when the gateway lists none. */
+export interface ModelPricing {
+    input_per_million?: number;
+    output_per_million?: number;
+}
+/** One row of `GET /v1/models`. */
 export interface ModelCatalogEntry {
-    /** Gateway id, e.g. "claude-opus-4.8" */
     id: string;
-    /** e.g. "anthropic" | "openai" | "hanzo" | "deepseek" */
+    /** Who made it: "anthropic", "openai", "zenlm", "hanzo", … */
     owned_by?: string;
-    /** Optional explicit family label override */
-    family?: string;
-    /** Display label; defaults to id */
-    label?: string;
+    name?: string;
+    description?: string;
+    class?: ModelClass;
+    family?: ModelFamily;
     premium?: boolean;
-    /** "chat" (default) | "embedding" | "image" | ... */
-    modality?: string;
+    /** Release time, Unix seconds. */
+    created?: number;
     context_window?: number;
-    description?: string;
+    max_output_tokens?: number;
+    /** Input modalities: "text", "image", "audio", "file", "video". */
+    inputs?: string[];
+    /** What it answers with: "text", "image", "audio", "transcript", "embeddings", "rerank", "decision". */
+    outputs?: string[];
+    supports_vision?: boolean;
+    supports_tools?: boolean;
+    supports_reasoning?: boolean;
+    pricing?: ModelPricing;
     /** Absent, anyone may call it. `research`: it exists and nobody can call it yet. */
     access?: 'research';
     /** Where a person asks for access to a model they cannot call. */
@@ -30,38 +52,79 @@ export interface ModelCatalogEntry {
 /**
  * The models that exist and cannot be called, said once for every list of
  * models: a picker draws each one disabled, a catalogue page draws it muted.
- *
- * No gateway serves them, and that is the point: `/v1/models` never answers for
- * one, so nothing can route to it. A host that lists them appends these to what
- * the gateway said.
+ * `/v1/models` never answers for one, so nothing can route to it.
  */
 export declare const RESEARCH: ModelCatalogEntry[];
+/** The catalog with the research models it does not already list, appended. */
+export declare function withResearch(models: readonly ModelCatalogEntry[]): ModelCatalogEntry[];
+/** One row, checked field by field: it is a network response. Null without an id. */
+export declare function modelOf(v: unknown): ModelCatalogEntry | null;
 /**
- * Resolve the display family of a model.
- * Precedence: explicit `family` → enso id (house split, beats owned_by) →
- * owned_by map → llama id under any owner → capitalized owned_by → id prefix → "Other".
+ * The catalog from a `/v1/models` body (`{data: [...]}`) or its `data` array.
+ * Rows without an id are dropped; a repeated id keeps its first row.
  */
-export declare function familyOf(m: ModelCatalogEntry): string;
+export declare function parseModels(body: unknown): ModelCatalogEntry[];
 /**
- * Group models by family, ordered house-then-marquee-then-alphabetical.
- * Model order within each family is the input order (stable).
+ * Fetch the catalog from an OpenAI-shaped `/models` endpoint. No caching, no
+ * state: the host owns both. Throws on a non-2xx answer.
  */
-export declare function groupModelsByFamily(models: ModelCatalogEntry[]): {
-    family: string;
-    models: ModelCatalogEntry[];
+export declare function fetchModelCatalog(baseUrl?: string, token?: string): Promise<ModelCatalogEntry[]>;
+/** The families, in the order every surface leads with them. */
+export declare const FAMILIES: readonly {
+    id: ModelFamily;
+    label: string;
 }[];
+export declare const CLASS_NAMES: Record<ModelClass, string>;
+/** Who made a model, as the catalog keys it: `owned_by`, lowercased, without OpenRouter's `~` alias mark. */
+export declare function makerOf(m: Pick<ModelCatalogEntry, 'owned_by'>): string;
+/** A maker's display name. */
+export declare function makerName(maker: string): string;
+/** The name a model is shown by: the catalog's name, else its id. */
+export declare function modelName(m: Pick<ModelCatalogEntry, 'id' | 'name'>): string;
+/** The group a model is listed in: its Hanzo family, else its maker. */
+export interface ModelGroup {
+    /** `family:zen`, `maker:anthropic`. */
+    key: string;
+    label: string;
+    family?: ModelFamily;
+    models: ModelCatalogEntry[];
+}
+export declare function groupKey(m: ModelCatalogEntry): string;
+export declare function groupLabel(m: ModelCatalogEntry): string;
 /**
- * True when a model can be used for chat. Excludes embedding/image/video/
- * music/voice/tts/rerank/guard/foley/moderation/router by explicit modality
- * or by an id-segment heuristic.
+ * Models in groups: Hanzo's families first, in FAMILIES order, then every maker
+ * by name. Models keep the order they came in, so the caller sorts first.
  */
-export declare function isChatModel(m: ModelCatalogEntry): boolean;
-/** Keep only chat-capable models. */
-export declare function filterChatModels(models: ModelCatalogEntry[]): ModelCatalogEntry[];
+export declare function groupModels(models: readonly ModelCatalogEntry[]): ModelGroup[];
 /**
- * Fetch a model catalog from an OpenAI-shaped `/models` endpoint.
- * SSR-safe: uses global fetch, no browser globals, no caching/state —
- * consumers own caching. Throws on a non-2xx response.
+ * What a model can do, read from what it publishes. A model that names no
+ * outputs is read as a text model, the way the gateway serves it.
  */
-export declare function fetchModelCatalog(baseUrl?: string, token?: string): Promise<ModelCatalogEntry[]>;
+export declare function capabilitiesOf(m: ModelCatalogEntry): Capability[];
+export declare function can(m: ModelCatalogEntry, c: Capability): boolean;
+export declare const CAPABILITY_NAMES: Record<Capability, string>;
+/** What `isPaused` reads of the payer's plan usage (`Limits` from `@hanzo/ui/product/limits`). */
+export interface PauseSource {
+    classes: Partial<Record<ModelClass, {
+        state: string;
+    }>>;
+    paused?: readonly Pick<PausedModel, 'model'>[];
+}
+/** Whether `id` matches a paused entry: the same id, or a glob whose `*` stands for any run of characters. */
+export declare function matchesPaused(id: string, pattern: string): boolean;
+/**
+ * Whether the payer's plan has paused this model: its whole class is limited,
+ * or an entry in `paused` names it. It is still listed and still picked; the
+ * gateway refuses it or answers from Enso.
+ */
+export declare function isPaused(m: Pick<ModelCatalogEntry, 'id' | 'class'>, limits: PauseSource | null | undefined): boolean;
+/** Case-insensitive search: every word of the query appears in the model's id, name, maker, group or description. */
+export declare function matchesModel(m: ModelCatalogEntry, query: string): boolean;
+export type ModelSort = 'name' | 'newest' | 'context' | 'price';
+/** A sorted copy. Context and price put models without the figure last. */
+export declare function sortModels(models: readonly ModelCatalogEntry[], by?: ModelSort): ModelCatalogEntry[];
+/** "200K", "1M", "1.5M"; "" when the catalog states no window. */
+export declare function formatContext(n: number | undefined): string;
+/** "$3.00" per 1M tokens, "Free" at zero, "" when the catalog lists no price. */
+export declare function formatPrice(n: number | undefined): string;
 //# sourceMappingURL=catalog.d.ts.map

package/dist/models/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/models/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAA;IACV,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oFAAoF;IACpF,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,iBAAiB,EASvC,CAAA;AAsDD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAmBrD;AAaD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,EAAE,GAC1B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAAE,EAAE,CAWnD;AAkBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAMzD;AAED,qCAAqC;AACrC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAEjF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA6B9B"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/models/catalog.ts"],"names":[],"mappings":"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"}