@ai-matrx/agents 0.59.186 → 0.59.188

package/dist/models/index.d.cts

@@ -972,6 +972,10 @@ interface LocalVariant {
     artifacts: LocalArtifact[];
     /** Set only on a variant that came from a pasted link or a search (`fromDiscovery`); catalog rows never carry it. */
     discovery?: VariantDiscovery;
+    /** ai.model_variant.review_state (set by `readModelCatalog`; "offered" = listed in apps). */
+    review_state?: string;
+    /** The public.catalog_entries rows this variant carries (metadata.catalog_entry_ids; set by `readModelCatalog`). */
+    catalog_entry_ids?: string[];
 }
 /** What discovery said about a variant: the server's own words, carried so the one judge can show them. */
 interface VariantDiscovery {
@@ -1002,6 +1006,12 @@ interface LocalPresentation {
         url: string;
     }>;
     thumbnail_file_id: string | null;
+    /** The admin's curated position (ai.model_presentation.display_order); `orderCatalogModels` sorts by it. */
+    display_order?: number | null;
+    hero_file_id?: string | null;
+    gallery_file_ids?: string[];
+    /** Admin display facts (ai.model_presentation.facts): ratings, speed, cutoff, tier, notes. Always set by `readModelCatalog`. */
+    facts?: Record<string, unknown>;
 }
 interface LocalModel {
     id: string;
@@ -1019,6 +1029,15 @@ interface LocalModel {
     };
     presentation: LocalPresentation | null;
     variants: LocalVariant[];
+    /** Matrx 2's 1.48 id for a model seeded from its old list (metadata.desktop_id). */
+    desktop_id?: string | null;
+    maker_logo_file_id?: string | null;
+    /** The admin Catalogs kind (`catalogKindOf`): llm_model, whisper_model, tts_model_file, image_gen_model, video_gen_model, ner_model, wake_word_model, lora. */
+    kind?: string;
+    /** At least one variant is offered (Matrx 2 lists it). */
+    offered?: boolean;
+    /** The later of the model's and its presentation's updated_at: what an admin edit sends as expected_updated_at. */
+    updated_at?: string | null;
 }
 interface LocalCompatRow {
     hardware_class: HardwareClass;
@@ -1055,6 +1074,14 @@ interface LocalModelCatalog {
     catalog_updated_at: string;
     models: LocalModel[];
     runtimes: LocalRuntime[];
+    /**
+     * sha256 of the whole shaped catalog (canonical JSON, this field left out), set by `readModelCatalog`:
+     * changes on ANY change (unoffer, retire, delete, maker rename), where catalog_updated_at only moves
+     * when a stamped row's updated_at does.
+     */
+    catalog_fingerprint?: string;
+    /** Reads that failed but did not stop the catalog (each one line, said so a screen can show it). */
+    warnings?: string[];
 }
 /** Whether a value is a v1 catalog with the fields every reader relies on (a cache or a fetch must pass this before it replaces anything). */
 declare function isLocalModelCatalog(value: unknown): value is LocalModelCatalog;
@@ -1469,13 +1496,13 @@ declare function orderCatalogGroups<T extends OrderedLike>(models: readonly T[],
  * one order (`orderCatalogModels` over ai.model_presentation.display_order). `curatedList` is the
  * only way a surface turns rows into its list, so two surfaces cannot drift apart.
  */
-type Row = Record<string, unknown>;
+type Row$1 = Record<string, unknown>;
 /** A structural subset of `SupabaseClient` (only `schema().from().select()` is used). */
 interface CuratedCatalogClient {
     schema(name: string): {
         from(table: string): {
             select(columns: string): PromiseLike<{
-                data: Row[] | null;
+                data: Row$1[] | null;
                 error: {
                     message: string;
                 } | null;
@@ -1522,14 +1549,31 @@ interface CuratedModel {
     /** The later of the model's and its presentation's updated_at: what an edit sends as expected_updated_at. */
     updated_at: string | null;
 }
-/** Shape raw ai.* rows into the curated models (pure; the query below feeds it). Dismissed variants are left out. */
+/**
+ * The review states that take a variant OFF every list (ai.model_review_state: discovered, files_checked,
+ * tested, offered, rejected, withdrawn). A rejected or withdrawn variant is never shown; a model left with
+ * none is not listed.
+ */
+declare const EXCLUDED_REVIEW_STATES: ReadonlySet<string>;
+/** Whether a variant row stays on the curated list (live, and not rejected or withdrawn). */
+declare const isListedVariant: (v: Row$1) => boolean;
+/** The four raw ai.* reads the curated list is shaped from (live rows only; RLS applies). */
+interface CuratedRows {
+    models: Row$1[];
+    variants: Row$1[];
+    presentations: Row$1[];
+    providers: Row$1[];
+}
+/** Shape raw ai.* rows into the curated models (pure; the query below feeds it). Rejected and withdrawn variants are left out. */
 declare function shapeCuratedModels(input: {
-    models: Row[];
-    variants: Row[];
-    presentations: Row[];
-    providers: Row[];
+    models: Row$1[];
+    variants: Row$1[];
+    presentations: Row$1[];
+    providers: Row$1[];
 }): CuratedModel[];
-/** THE query: every live, unretired model with a non-dismissed variant, from ai.* (RLS applies). */
+/** The four reads behind the curated list (live rows of ai.model_definition, model_variant, model_presentation, provider). */
+declare function readCuratedRows(client: CuratedCatalogClient): Promise<CuratedRows>;
+/** THE query: every live, unretired model with a variant that is not rejected or withdrawn, from ai.* (RLS applies). */
 declare function fetchCuratedModels(client: CuratedCatalogClient): Promise<CuratedModel[]>;
 /**
  * THE list a surface shows, in the curated order. `offeredOnly` is Matrx 2's list; the admin page
@@ -1540,4 +1584,79 @@ declare function curatedList<T extends CuratedModel>(models: readonly T[], { off
     offeredOnly: boolean;
 }): T[];
 
-export { type AdminOffering, type AdminPricingBand, type ArtifactUse, type AuditCapabilitiesRecord, CHAT_DEFAULT_MODEL_KNOB, CONTENT_TYPES, type CapabilitiesParseContext, type CatalogModel, type CatalogTier, type CompatStatus, type ContentType, type CuratedCatalogClient, type CuratedModel, type CuratedPresentation, type CuratedVariant, DEFAULT_CAPABILITIES, type DecidedBy, type DeviceGraphics, type DeviceHardware, type DiscoveryAmbiguity, type DiscoveryArtifact, type DiscoveryMedia, type DiscoveryResult, type DiscoveryRuntime, type DiscoverySource, type DiscoveryVariant, EMPTY_MODEL_RECORDS, FEATURE_BUCKETS, FEATURE_BUCKET_ORDER, FEATURE_KEYS, FILE_TYPE_QUANT, type FeatureBucket, type FeatureBucketMeta, type FeatureKey, GgufError, type GgufHeader, type GgufRead, type GgufTensor, type GroupedFeatures, type HardwareClass, type HardwareClasses, type HeaderFlag, type HeaderJudgement, type HeaderRefusal, INPUT_MODALITIES, INTERACTION_MODES, type Interaction, type InteractionMode, type LocalArtifact, type LocalCompatRow, type LocalModel, type LocalModelCatalog, type LocalPresentation, type LocalRuntime, type LocalRuntimeBuild, type LocalVariant, MAX_SUCCESSION_HOPS, MODEL_FAVORITE_ENTITY_TYPE, type Modality, type ModelCapabilities, type ModelCatalog, type ModelCatalogClient, type ModelCatalogConfig, type ModelCatalogErrorSink, type ModelCatalogPgError, type ModelCatalogPgResult, type ModelCatalogQuery, type ModelCatalogState, type ModelCatalogVariant, type ModelCatalogVariantState, type ModelClassConfig, type ModelClassEntry, type ModelClassIndex, type ModelDiagnosticEntry, type ModelDiagnosticsSink, type ModelFavorites, type ModelFavoritesCache, type ModelFavoritesClient, type ModelFavoritesConfig, type ModelFavoritesErrorSink, type ModelFavoritesState, type ModelFetchScope, type ModelFileHandle, type ModelFit, type ModelIdentityRow, type ModelJson, type ModelOfferingRow, type ModelOption, type ModelOptionWithLifecycle, type ModelRecord, type ModelRecordFetchType, type ModelRecords, type ModelRecordsClient, type ModelRecordsConfig, type ModelRecordsState, type ModelSelectionPurpose, type ModelSetEnv, type ModelSetFacts, type ModelSetValidation, type NoSelection, OUTPUT_MODALITIES, type OrderedLike, type PreferredModelChoice, type PreferredModelChoicePorts, type PriceTier, type RankedVariant, SERVICE_LABEL, SERVICE_LABEL_PLURAL, type SelectDevice, type Selection, type ShardName, type SuccessionClient, type SuccessionIndex, type SuccessionNode, TOP_TIER_COST_RATING, TOP_TIER_LOCKED_TITLE, type VariantDiscovery, type Want, acceptsTextInstructions, buildModelClassIndex, buildSuccessionIndex, catalogForApp, classConfigKey, collapseTiersByClass, costRatingTier, costRatingWord, createModelCatalog, createModelFavorites, createModelRecords, curatedList, displayOrderOf, favoriteIdsEqual, fetchCuratedModels, findNonCanonicalCapabilityValues, fitsMemory, fitsThisComputer, formatMemoryBytes, fromDiscovery, ggufEngine, ggufFacts, groupFeatures, hardwareClassesOf, hasCompatibleDecisionInteraction, isContentType, isConversationalModelCapability, isDecisionModelCapability, isFeatureKey, isHelperGguf, isInteractionMode, isLocalModelCatalog, isManagedAgentModelCapability, isProjectorName, isSupersedable, isTopTierRating, judgeHeaderFacts, mergeAuditRecordIntoCapabilities, missingShards, modelClassKnobFor, modelClassName, modelClassPinOf, modelsForSelectionPurpose, normalizeArch, normalizeModel, normalizeModels, normalizeOs, normalizePromptSettings, orderCatalogGroups, orderCatalogModels, outputFormatControlKey, parseCapabilities, pickProjector, priceTierRating, quantFromName, rankVariants, readGgufHeader, reconcileModelFavoriteIds, reportModelDiagnostic, requireCanonicalCapabilities, requiredArtifacts, resetSuccessionLogForTests, resolveLiveModelId, resolvePreferredModelChoice, resolveSuccessor, selectActiveModels, selectActiveModelsReady, selectAllModelOptions, selectAllModels, selectAllModelsReady, selectDeprecatedModels, selectDeprecatedModelsReady, selectModelById, selectModelClassConfig, selectModelClassName, selectModelControls, selectModelDetailError, selectModelFetchType, selectModelFullyLoaded, selectModelIdentityById, selectModelIdentityLookupStatus, selectModelLabelById, selectModelLabelWithClass, selectModelNameById, selectModelOptions, selectVariant, serviceCountLabel, setModelDiagnosticsSink, shapeCuratedModels, shardFileName, shardName, speedRatingLabel, speedRatingWord, splitSetProblems, toAuditRecord, validateModelSet, withModelClass };
+/**
+ * `@ai-matrx/agents/models` — THE model-catalog reader. Every surface that shows the downloadable-model
+ * catalog (AI Matrx admin › Applications › Catalogs, Matrx 2 › Models, any later client) reads it here,
+ * so no two surfaces can drift apart:
+ *
+ *   - members: the curated query (`readCuratedRows` + `shapeCuratedModels` + `curatedList`) — a live,
+ *     unretired model with a variant that is not rejected or withdrawn; `offeredOnly` (the default, for
+ *     apps) keeps only models and variants whose review_state is `offered`; the admin page passes false.
+ *   - order: the admin's order (`orderCatalogModels` over model name by code point), applied HERE, so a
+ *     consumer never re-sorts.
+ *   - shape: `LocalModelCatalog` (`matrx.model-catalog.snapshot/v1`, the snapshot exporter's shape), plus
+ *     every field the admin Catalogs editor writes, the admin kind (`catalogKindOf`) and a content
+ *     fingerprint (`catalog_fingerprint`) that changes on ANY change, not only a moved max(updated_at).
+ *
+ * The columns the Catalogs editor writes are pinned by `scripts/check-catalog-reader-columns.mjs`: drop a
+ * mapping below and the guard goes red.
+ */
+
+type Row = Record<string, unknown>;
+type Result = {
+    data: Row[] | null;
+    error: {
+        message: string;
+    } | null;
+};
+/** A filterable PostgREST query (the subset of supabase-js's builder this reader uses). */
+interface LocalCatalogQuery extends PromiseLike<Result> {
+    is(column: string, value: null): LocalCatalogQuery;
+    eq(column: string, value: string): LocalCatalogQuery;
+    in(column: string, values: readonly string[]): LocalCatalogQuery;
+}
+/** A structural subset of `SupabaseClient`: `schema(name).from(table).select(columns)` plus `is` / `eq` / `in`. */
+interface LocalCatalogClient {
+    schema(name: string): {
+        from(table: string): {
+            select(columns: string): LocalCatalogQuery;
+        };
+    };
+}
+interface ReadModelCatalogOptions {
+    /** Apps (default true): only offered models and their offered variants. The admin page passes false. */
+    offeredOnly?: boolean;
+}
+/** The catalog kinds whose rows live in the unified catalog (ai.*): the admin Catalogs page's model kinds. */
+declare const MODEL_CATALOG_KINDS: ReadonlySet<string>;
+/** What `catalogKindOf` reads from a model (a CuratedModel or a LocalModel from `readModelCatalog` both fit). */
+interface CatalogKindInput {
+    readonly variants: ReadonlyArray<{
+        readonly catalog_entry_ids?: readonly string[];
+    }>;
+    readonly capabilities: {
+        readonly input?: readonly string[];
+        readonly output?: readonly string[];
+        readonly interaction?: string;
+    };
+    readonly presentation?: {
+        readonly shelf?: string | null;
+    } | null;
+}
+/**
+ * THE admin Catalogs kind of a unified model: the kind of the old public.catalog_entries rows its variants
+ * carry (the list migration stamps them), when that is a model kind; else placed by what it does.
+ * `kindOfEntry` maps catalog_entries.id → kind.
+ */
+declare function catalogKindOf(m: CatalogKindInput, kindOfEntry: ReadonlyMap<string, string>): string;
+/** sha256 (hex) of the catalog's canonical JSON, its own `catalog_fingerprint` left out. Isomorphic (pure JS). */
+declare function catalogFingerprint(catalog: LocalModelCatalog): string;
+/**
+ * THE catalog read: `LocalModelCatalog` in the admin's order, every admin-edited field carried, each model's
+ * admin kind, and `catalog_fingerprint`. Reads ai.* (and public.catalog_entries id/kind for the kind) as the
+ * signed-in caller (RLS applies). A failed ai.* read throws; a failed catalog_entries read only places models
+ * by what they do and is said in `warnings`.
+ */
+declare function readModelCatalog(client: CuratedCatalogClient, opts?: ReadModelCatalogOptions): Promise<LocalModelCatalog>;
+
+export { type AdminOffering, type AdminPricingBand, type ArtifactUse, type AuditCapabilitiesRecord, CHAT_DEFAULT_MODEL_KNOB, CONTENT_TYPES, type CapabilitiesParseContext, type CatalogKindInput, type CatalogModel, type CatalogTier, type CompatStatus, type ContentType, type CuratedCatalogClient, type CuratedModel, type CuratedPresentation, type CuratedRows, type CuratedVariant, DEFAULT_CAPABILITIES, type DecidedBy, type DeviceGraphics, type DeviceHardware, type DiscoveryAmbiguity, type DiscoveryArtifact, type DiscoveryMedia, type DiscoveryResult, type DiscoveryRuntime, type DiscoverySource, type DiscoveryVariant, EMPTY_MODEL_RECORDS, EXCLUDED_REVIEW_STATES, FEATURE_BUCKETS, FEATURE_BUCKET_ORDER, FEATURE_KEYS, FILE_TYPE_QUANT, type FeatureBucket, type FeatureBucketMeta, type FeatureKey, GgufError, type GgufHeader, type GgufRead, type GgufTensor, type GroupedFeatures, type HardwareClass, type HardwareClasses, type HeaderFlag, type HeaderJudgement, type HeaderRefusal, INPUT_MODALITIES, INTERACTION_MODES, type Interaction, type InteractionMode, type LocalArtifact, type LocalCatalogClient, type LocalCatalogQuery, type LocalCompatRow, type LocalModel, type LocalModelCatalog, type LocalPresentation, type LocalRuntime, type LocalRuntimeBuild, type LocalVariant, MAX_SUCCESSION_HOPS, MODEL_CATALOG_KINDS, MODEL_FAVORITE_ENTITY_TYPE, type Modality, type ModelCapabilities, type ModelCatalog, type ModelCatalogClient, type ModelCatalogConfig, type ModelCatalogErrorSink, type ModelCatalogPgError, type ModelCatalogPgResult, type ModelCatalogQuery, type ModelCatalogState, type ModelCatalogVariant, type ModelCatalogVariantState, type ModelClassConfig, type ModelClassEntry, type ModelClassIndex, type ModelDiagnosticEntry, type ModelDiagnosticsSink, type ModelFavorites, type ModelFavoritesCache, type ModelFavoritesClient, type ModelFavoritesConfig, type ModelFavoritesErrorSink, type ModelFavoritesState, type ModelFetchScope, type ModelFileHandle, type ModelFit, type ModelIdentityRow, type ModelJson, type ModelOfferingRow, type ModelOption, type ModelOptionWithLifecycle, type ModelRecord, type ModelRecordFetchType, type ModelRecords, type ModelRecordsClient, type ModelRecordsConfig, type ModelRecordsState, type ModelSelectionPurpose, type ModelSetEnv, type ModelSetFacts, type ModelSetValidation, type NoSelection, OUTPUT_MODALITIES, type OrderedLike, type PreferredModelChoice, type PreferredModelChoicePorts, type PriceTier, type RankedVariant, type ReadModelCatalogOptions, SERVICE_LABEL, SERVICE_LABEL_PLURAL, type SelectDevice, type Selection, type ShardName, type SuccessionClient, type SuccessionIndex, type SuccessionNode, TOP_TIER_COST_RATING, TOP_TIER_LOCKED_TITLE, type VariantDiscovery, type Want, acceptsTextInstructions, buildModelClassIndex, buildSuccessionIndex, catalogFingerprint, catalogForApp, catalogKindOf, classConfigKey, collapseTiersByClass, costRatingTier, costRatingWord, createModelCatalog, createModelFavorites, createModelRecords, curatedList, displayOrderOf, favoriteIdsEqual, fetchCuratedModels, findNonCanonicalCapabilityValues, fitsMemory, fitsThisComputer, formatMemoryBytes, fromDiscovery, ggufEngine, ggufFacts, groupFeatures, hardwareClassesOf, hasCompatibleDecisionInteraction, isContentType, isConversationalModelCapability, isDecisionModelCapability, isFeatureKey, isHelperGguf, isInteractionMode, isListedVariant, isLocalModelCatalog, isManagedAgentModelCapability, isProjectorName, isSupersedable, isTopTierRating, judgeHeaderFacts, mergeAuditRecordIntoCapabilities, missingShards, modelClassKnobFor, modelClassName, modelClassPinOf, modelsForSelectionPurpose, normalizeArch, normalizeModel, normalizeModels, normalizeOs, normalizePromptSettings, orderCatalogGroups, orderCatalogModels, outputFormatControlKey, parseCapabilities, pickProjector, priceTierRating, quantFromName, rankVariants, readCuratedRows, readGgufHeader, readModelCatalog, reconcileModelFavoriteIds, reportModelDiagnostic, requireCanonicalCapabilities, requiredArtifacts, resetSuccessionLogForTests, resolveLiveModelId, resolvePreferredModelChoice, resolveSuccessor, selectActiveModels, selectActiveModelsReady, selectAllModelOptions, selectAllModels, selectAllModelsReady, selectDeprecatedModels, selectDeprecatedModelsReady, selectModelById, selectModelClassConfig, selectModelClassName, selectModelControls, selectModelDetailError, selectModelFetchType, selectModelFullyLoaded, selectModelIdentityById, selectModelIdentityLookupStatus, selectModelLabelById, selectModelLabelWithClass, selectModelNameById, selectModelOptions, selectVariant, serviceCountLabel, setModelDiagnosticsSink, shapeCuratedModels, shardFileName, shardName, speedRatingLabel, speedRatingWord, splitSetProblems, toAuditRecord, validateModelSet, withModelClass };

package/dist/models/index.d.ts

@@ -972,6 +972,10 @@ interface LocalVariant {
     artifacts: LocalArtifact[];
     /** Set only on a variant that came from a pasted link or a search (`fromDiscovery`); catalog rows never carry it. */
     discovery?: VariantDiscovery;
+    /** ai.model_variant.review_state (set by `readModelCatalog`; "offered" = listed in apps). */
+    review_state?: string;
+    /** The public.catalog_entries rows this variant carries (metadata.catalog_entry_ids; set by `readModelCatalog`). */
+    catalog_entry_ids?: string[];
 }
 /** What discovery said about a variant: the server's own words, carried so the one judge can show them. */
 interface VariantDiscovery {
@@ -1002,6 +1006,12 @@ interface LocalPresentation {
         url: string;
     }>;
     thumbnail_file_id: string | null;
+    /** The admin's curated position (ai.model_presentation.display_order); `orderCatalogModels` sorts by it. */
+    display_order?: number | null;
+    hero_file_id?: string | null;
+    gallery_file_ids?: string[];
+    /** Admin display facts (ai.model_presentation.facts): ratings, speed, cutoff, tier, notes. Always set by `readModelCatalog`. */
+    facts?: Record<string, unknown>;
 }
 interface LocalModel {
     id: string;
@@ -1019,6 +1029,15 @@ interface LocalModel {
     };
     presentation: LocalPresentation | null;
     variants: LocalVariant[];
+    /** Matrx 2's 1.48 id for a model seeded from its old list (metadata.desktop_id). */
+    desktop_id?: string | null;
+    maker_logo_file_id?: string | null;
+    /** The admin Catalogs kind (`catalogKindOf`): llm_model, whisper_model, tts_model_file, image_gen_model, video_gen_model, ner_model, wake_word_model, lora. */
+    kind?: string;
+    /** At least one variant is offered (Matrx 2 lists it). */
+    offered?: boolean;
+    /** The later of the model's and its presentation's updated_at: what an admin edit sends as expected_updated_at. */
+    updated_at?: string | null;
 }
 interface LocalCompatRow {
     hardware_class: HardwareClass;
@@ -1055,6 +1074,14 @@ interface LocalModelCatalog {
     catalog_updated_at: string;
     models: LocalModel[];
     runtimes: LocalRuntime[];
+    /**
+     * sha256 of the whole shaped catalog (canonical JSON, this field left out), set by `readModelCatalog`:
+     * changes on ANY change (unoffer, retire, delete, maker rename), where catalog_updated_at only moves
+     * when a stamped row's updated_at does.
+     */
+    catalog_fingerprint?: string;
+    /** Reads that failed but did not stop the catalog (each one line, said so a screen can show it). */
+    warnings?: string[];
 }
 /** Whether a value is a v1 catalog with the fields every reader relies on (a cache or a fetch must pass this before it replaces anything). */
 declare function isLocalModelCatalog(value: unknown): value is LocalModelCatalog;
@@ -1469,13 +1496,13 @@ declare function orderCatalogGroups<T extends OrderedLike>(models: readonly T[],
  * one order (`orderCatalogModels` over ai.model_presentation.display_order). `curatedList` is the
  * only way a surface turns rows into its list, so two surfaces cannot drift apart.
  */
-type Row = Record<string, unknown>;
+type Row$1 = Record<string, unknown>;
 /** A structural subset of `SupabaseClient` (only `schema().from().select()` is used). */
 interface CuratedCatalogClient {
     schema(name: string): {
         from(table: string): {
             select(columns: string): PromiseLike<{
-                data: Row[] | null;
+                data: Row$1[] | null;
                 error: {
                     message: string;
                 } | null;
@@ -1522,14 +1549,31 @@ interface CuratedModel {
     /** The later of the model's and its presentation's updated_at: what an edit sends as expected_updated_at. */
     updated_at: string | null;
 }
-/** Shape raw ai.* rows into the curated models (pure; the query below feeds it). Dismissed variants are left out. */
+/**
+ * The review states that take a variant OFF every list (ai.model_review_state: discovered, files_checked,
+ * tested, offered, rejected, withdrawn). A rejected or withdrawn variant is never shown; a model left with
+ * none is not listed.
+ */
+declare const EXCLUDED_REVIEW_STATES: ReadonlySet<string>;
+/** Whether a variant row stays on the curated list (live, and not rejected or withdrawn). */
+declare const isListedVariant: (v: Row$1) => boolean;
+/** The four raw ai.* reads the curated list is shaped from (live rows only; RLS applies). */
+interface CuratedRows {
+    models: Row$1[];
+    variants: Row$1[];
+    presentations: Row$1[];
+    providers: Row$1[];
+}
+/** Shape raw ai.* rows into the curated models (pure; the query below feeds it). Rejected and withdrawn variants are left out. */
 declare function shapeCuratedModels(input: {
-    models: Row[];
-    variants: Row[];
-    presentations: Row[];
-    providers: Row[];
+    models: Row$1[];
+    variants: Row$1[];
+    presentations: Row$1[];
+    providers: Row$1[];
 }): CuratedModel[];
-/** THE query: every live, unretired model with a non-dismissed variant, from ai.* (RLS applies). */
+/** The four reads behind the curated list (live rows of ai.model_definition, model_variant, model_presentation, provider). */
+declare function readCuratedRows(client: CuratedCatalogClient): Promise<CuratedRows>;
+/** THE query: every live, unretired model with a variant that is not rejected or withdrawn, from ai.* (RLS applies). */
 declare function fetchCuratedModels(client: CuratedCatalogClient): Promise<CuratedModel[]>;
 /**
  * THE list a surface shows, in the curated order. `offeredOnly` is Matrx 2's list; the admin page
@@ -1540,4 +1584,79 @@ declare function curatedList<T extends CuratedModel>(models: readonly T[], { off
     offeredOnly: boolean;
 }): T[];
 
-export { type AdminOffering, type AdminPricingBand, type ArtifactUse, type AuditCapabilitiesRecord, CHAT_DEFAULT_MODEL_KNOB, CONTENT_TYPES, type CapabilitiesParseContext, type CatalogModel, type CatalogTier, type CompatStatus, type ContentType, type CuratedCatalogClient, type CuratedModel, type CuratedPresentation, type CuratedVariant, DEFAULT_CAPABILITIES, type DecidedBy, type DeviceGraphics, type DeviceHardware, type DiscoveryAmbiguity, type DiscoveryArtifact, type DiscoveryMedia, type DiscoveryResult, type DiscoveryRuntime, type DiscoverySource, type DiscoveryVariant, EMPTY_MODEL_RECORDS, FEATURE_BUCKETS, FEATURE_BUCKET_ORDER, FEATURE_KEYS, FILE_TYPE_QUANT, type FeatureBucket, type FeatureBucketMeta, type FeatureKey, GgufError, type GgufHeader, type GgufRead, type GgufTensor, type GroupedFeatures, type HardwareClass, type HardwareClasses, type HeaderFlag, type HeaderJudgement, type HeaderRefusal, INPUT_MODALITIES, INTERACTION_MODES, type Interaction, type InteractionMode, type LocalArtifact, type LocalCompatRow, type LocalModel, type LocalModelCatalog, type LocalPresentation, type LocalRuntime, type LocalRuntimeBuild, type LocalVariant, MAX_SUCCESSION_HOPS, MODEL_FAVORITE_ENTITY_TYPE, type Modality, type ModelCapabilities, type ModelCatalog, type ModelCatalogClient, type ModelCatalogConfig, type ModelCatalogErrorSink, type ModelCatalogPgError, type ModelCatalogPgResult, type ModelCatalogQuery, type ModelCatalogState, type ModelCatalogVariant, type ModelCatalogVariantState, type ModelClassConfig, type ModelClassEntry, type ModelClassIndex, type ModelDiagnosticEntry, type ModelDiagnosticsSink, type ModelFavorites, type ModelFavoritesCache, type ModelFavoritesClient, type ModelFavoritesConfig, type ModelFavoritesErrorSink, type ModelFavoritesState, type ModelFetchScope, type ModelFileHandle, type ModelFit, type ModelIdentityRow, type ModelJson, type ModelOfferingRow, type ModelOption, type ModelOptionWithLifecycle, type ModelRecord, type ModelRecordFetchType, type ModelRecords, type ModelRecordsClient, type ModelRecordsConfig, type ModelRecordsState, type ModelSelectionPurpose, type ModelSetEnv, type ModelSetFacts, type ModelSetValidation, type NoSelection, OUTPUT_MODALITIES, type OrderedLike, type PreferredModelChoice, type PreferredModelChoicePorts, type PriceTier, type RankedVariant, SERVICE_LABEL, SERVICE_LABEL_PLURAL, type SelectDevice, type Selection, type ShardName, type SuccessionClient, type SuccessionIndex, type SuccessionNode, TOP_TIER_COST_RATING, TOP_TIER_LOCKED_TITLE, type VariantDiscovery, type Want, acceptsTextInstructions, buildModelClassIndex, buildSuccessionIndex, catalogForApp, classConfigKey, collapseTiersByClass, costRatingTier, costRatingWord, createModelCatalog, createModelFavorites, createModelRecords, curatedList, displayOrderOf, favoriteIdsEqual, fetchCuratedModels, findNonCanonicalCapabilityValues, fitsMemory, fitsThisComputer, formatMemoryBytes, fromDiscovery, ggufEngine, ggufFacts, groupFeatures, hardwareClassesOf, hasCompatibleDecisionInteraction, isContentType, isConversationalModelCapability, isDecisionModelCapability, isFeatureKey, isHelperGguf, isInteractionMode, isLocalModelCatalog, isManagedAgentModelCapability, isProjectorName, isSupersedable, isTopTierRating, judgeHeaderFacts, mergeAuditRecordIntoCapabilities, missingShards, modelClassKnobFor, modelClassName, modelClassPinOf, modelsForSelectionPurpose, normalizeArch, normalizeModel, normalizeModels, normalizeOs, normalizePromptSettings, orderCatalogGroups, orderCatalogModels, outputFormatControlKey, parseCapabilities, pickProjector, priceTierRating, quantFromName, rankVariants, readGgufHeader, reconcileModelFavoriteIds, reportModelDiagnostic, requireCanonicalCapabilities, requiredArtifacts, resetSuccessionLogForTests, resolveLiveModelId, resolvePreferredModelChoice, resolveSuccessor, selectActiveModels, selectActiveModelsReady, selectAllModelOptions, selectAllModels, selectAllModelsReady, selectDeprecatedModels, selectDeprecatedModelsReady, selectModelById, selectModelClassConfig, selectModelClassName, selectModelControls, selectModelDetailError, selectModelFetchType, selectModelFullyLoaded, selectModelIdentityById, selectModelIdentityLookupStatus, selectModelLabelById, selectModelLabelWithClass, selectModelNameById, selectModelOptions, selectVariant, serviceCountLabel, setModelDiagnosticsSink, shapeCuratedModels, shardFileName, shardName, speedRatingLabel, speedRatingWord, splitSetProblems, toAuditRecord, validateModelSet, withModelClass };
+/**
+ * `@ai-matrx/agents/models` — THE model-catalog reader. Every surface that shows the downloadable-model
+ * catalog (AI Matrx admin › Applications › Catalogs, Matrx 2 › Models, any later client) reads it here,
+ * so no two surfaces can drift apart:
+ *
+ *   - members: the curated query (`readCuratedRows` + `shapeCuratedModels` + `curatedList`) — a live,
+ *     unretired model with a variant that is not rejected or withdrawn; `offeredOnly` (the default, for
+ *     apps) keeps only models and variants whose review_state is `offered`; the admin page passes false.
+ *   - order: the admin's order (`orderCatalogModels` over model name by code point), applied HERE, so a
+ *     consumer never re-sorts.
+ *   - shape: `LocalModelCatalog` (`matrx.model-catalog.snapshot/v1`, the snapshot exporter's shape), plus
+ *     every field the admin Catalogs editor writes, the admin kind (`catalogKindOf`) and a content
+ *     fingerprint (`catalog_fingerprint`) that changes on ANY change, not only a moved max(updated_at).
+ *
+ * The columns the Catalogs editor writes are pinned by `scripts/check-catalog-reader-columns.mjs`: drop a
+ * mapping below and the guard goes red.
+ */
+
+type Row = Record<string, unknown>;
+type Result = {
+    data: Row[] | null;
+    error: {
+        message: string;
+    } | null;
+};
+/** A filterable PostgREST query (the subset of supabase-js's builder this reader uses). */
+interface LocalCatalogQuery extends PromiseLike<Result> {
+    is(column: string, value: null): LocalCatalogQuery;
+    eq(column: string, value: string): LocalCatalogQuery;
+    in(column: string, values: readonly string[]): LocalCatalogQuery;
+}
+/** A structural subset of `SupabaseClient`: `schema(name).from(table).select(columns)` plus `is` / `eq` / `in`. */
+interface LocalCatalogClient {
+    schema(name: string): {
+        from(table: string): {
+            select(columns: string): LocalCatalogQuery;
+        };
+    };
+}
+interface ReadModelCatalogOptions {
+    /** Apps (default true): only offered models and their offered variants. The admin page passes false. */
+    offeredOnly?: boolean;
+}
+/** The catalog kinds whose rows live in the unified catalog (ai.*): the admin Catalogs page's model kinds. */
+declare const MODEL_CATALOG_KINDS: ReadonlySet<string>;
+/** What `catalogKindOf` reads from a model (a CuratedModel or a LocalModel from `readModelCatalog` both fit). */
+interface CatalogKindInput {
+    readonly variants: ReadonlyArray<{
+        readonly catalog_entry_ids?: readonly string[];
+    }>;
+    readonly capabilities: {
+        readonly input?: readonly string[];
+        readonly output?: readonly string[];
+        readonly interaction?: string;
+    };
+    readonly presentation?: {
+        readonly shelf?: string | null;
+    } | null;
+}
+/**
+ * THE admin Catalogs kind of a unified model: the kind of the old public.catalog_entries rows its variants
+ * carry (the list migration stamps them), when that is a model kind; else placed by what it does.
+ * `kindOfEntry` maps catalog_entries.id → kind.
+ */
+declare function catalogKindOf(m: CatalogKindInput, kindOfEntry: ReadonlyMap<string, string>): string;
+/** sha256 (hex) of the catalog's canonical JSON, its own `catalog_fingerprint` left out. Isomorphic (pure JS). */
+declare function catalogFingerprint(catalog: LocalModelCatalog): string;
+/**
+ * THE catalog read: `LocalModelCatalog` in the admin's order, every admin-edited field carried, each model's
+ * admin kind, and `catalog_fingerprint`. Reads ai.* (and public.catalog_entries id/kind for the kind) as the
+ * signed-in caller (RLS applies). A failed ai.* read throws; a failed catalog_entries read only places models
+ * by what they do and is said in `warnings`.
+ */
+declare function readModelCatalog(client: CuratedCatalogClient, opts?: ReadModelCatalogOptions): Promise<LocalModelCatalog>;
+
+export { type AdminOffering, type AdminPricingBand, type ArtifactUse, type AuditCapabilitiesRecord, CHAT_DEFAULT_MODEL_KNOB, CONTENT_TYPES, type CapabilitiesParseContext, type CatalogKindInput, type CatalogModel, type CatalogTier, type CompatStatus, type ContentType, type CuratedCatalogClient, type CuratedModel, type CuratedPresentation, type CuratedRows, type CuratedVariant, DEFAULT_CAPABILITIES, type DecidedBy, type DeviceGraphics, type DeviceHardware, type DiscoveryAmbiguity, type DiscoveryArtifact, type DiscoveryMedia, type DiscoveryResult, type DiscoveryRuntime, type DiscoverySource, type DiscoveryVariant, EMPTY_MODEL_RECORDS, EXCLUDED_REVIEW_STATES, FEATURE_BUCKETS, FEATURE_BUCKET_ORDER, FEATURE_KEYS, FILE_TYPE_QUANT, type FeatureBucket, type FeatureBucketMeta, type FeatureKey, GgufError, type GgufHeader, type GgufRead, type GgufTensor, type GroupedFeatures, type HardwareClass, type HardwareClasses, type HeaderFlag, type HeaderJudgement, type HeaderRefusal, INPUT_MODALITIES, INTERACTION_MODES, type Interaction, type InteractionMode, type LocalArtifact, type LocalCatalogClient, type LocalCatalogQuery, type LocalCompatRow, type LocalModel, type LocalModelCatalog, type LocalPresentation, type LocalRuntime, type LocalRuntimeBuild, type LocalVariant, MAX_SUCCESSION_HOPS, MODEL_CATALOG_KINDS, MODEL_FAVORITE_ENTITY_TYPE, type Modality, type ModelCapabilities, type ModelCatalog, type ModelCatalogClient, type ModelCatalogConfig, type ModelCatalogErrorSink, type ModelCatalogPgError, type ModelCatalogPgResult, type ModelCatalogQuery, type ModelCatalogState, type ModelCatalogVariant, type ModelCatalogVariantState, type ModelClassConfig, type ModelClassEntry, type ModelClassIndex, type ModelDiagnosticEntry, type ModelDiagnosticsSink, type ModelFavorites, type ModelFavoritesCache, type ModelFavoritesClient, type ModelFavoritesConfig, type ModelFavoritesErrorSink, type ModelFavoritesState, type ModelFetchScope, type ModelFileHandle, type ModelFit, type ModelIdentityRow, type ModelJson, type ModelOfferingRow, type ModelOption, type ModelOptionWithLifecycle, type ModelRecord, type ModelRecordFetchType, type ModelRecords, type ModelRecordsClient, type ModelRecordsConfig, type ModelRecordsState, type ModelSelectionPurpose, type ModelSetEnv, type ModelSetFacts, type ModelSetValidation, type NoSelection, OUTPUT_MODALITIES, type OrderedLike, type PreferredModelChoice, type PreferredModelChoicePorts, type PriceTier, type RankedVariant, type ReadModelCatalogOptions, SERVICE_LABEL, SERVICE_LABEL_PLURAL, type SelectDevice, type Selection, type ShardName, type SuccessionClient, type SuccessionIndex, type SuccessionNode, TOP_TIER_COST_RATING, TOP_TIER_LOCKED_TITLE, type VariantDiscovery, type Want, acceptsTextInstructions, buildModelClassIndex, buildSuccessionIndex, catalogFingerprint, catalogForApp, catalogKindOf, classConfigKey, collapseTiersByClass, costRatingTier, costRatingWord, createModelCatalog, createModelFavorites, createModelRecords, curatedList, displayOrderOf, favoriteIdsEqual, fetchCuratedModels, findNonCanonicalCapabilityValues, fitsMemory, fitsThisComputer, formatMemoryBytes, fromDiscovery, ggufEngine, ggufFacts, groupFeatures, hardwareClassesOf, hasCompatibleDecisionInteraction, isContentType, isConversationalModelCapability, isDecisionModelCapability, isFeatureKey, isHelperGguf, isInteractionMode, isListedVariant, isLocalModelCatalog, isManagedAgentModelCapability, isProjectorName, isSupersedable, isTopTierRating, judgeHeaderFacts, mergeAuditRecordIntoCapabilities, missingShards, modelClassKnobFor, modelClassName, modelClassPinOf, modelsForSelectionPurpose, normalizeArch, normalizeModel, normalizeModels, normalizeOs, normalizePromptSettings, orderCatalogGroups, orderCatalogModels, outputFormatControlKey, parseCapabilities, pickProjector, priceTierRating, quantFromName, rankVariants, readCuratedRows, readGgufHeader, readModelCatalog, reconcileModelFavoriteIds, reportModelDiagnostic, requireCanonicalCapabilities, requiredArtifacts, resetSuccessionLogForTests, resolveLiveModelId, resolvePreferredModelChoice, resolveSuccessor, selectActiveModels, selectActiveModelsReady, selectAllModelOptions, selectAllModels, selectAllModelsReady, selectDeprecatedModels, selectDeprecatedModelsReady, selectModelById, selectModelClassConfig, selectModelClassName, selectModelControls, selectModelDetailError, selectModelFetchType, selectModelFullyLoaded, selectModelIdentityById, selectModelIdentityLookupStatus, selectModelLabelById, selectModelLabelWithClass, selectModelNameById, selectModelOptions, selectVariant, serviceCountLabel, setModelDiagnosticsSink, shapeCuratedModels, shardFileName, shardName, speedRatingLabel, speedRatingWord, splitSetProblems, toAuditRecord, validateModelSet, withModelClass };