@ai-matrx/chat 0.3.33 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @ai-matrx/chat
 
+## 0.4.0
+
+Agent core B3 + the B2 tail — every piece of agent and model state has one holder:
+
+- **The model registry slice is retired.** `modelRegistry` is gone from `chatReducers`; model records
+  (options, full records with controls, pinned-class configs, class labels, identities) live in the core
+  model catalog (`@ai-matrx/agents/models` 0.52+, `catalog.records`), bound once per page by
+  `agents/identity/model-catalog` (`getModelCatalog`, `getModelRecords`, `readModelRecords`,
+  `useModelRecords`, `useModelRecord`, `useModelLabel`, `useModelLabelWithClass`, `useModelClassLabels`,
+  `useModelClassControls`). `agents/redux/model-registry` re-exports the core selectors, which take the
+  records state. `agents/model-registry/modelRegistrySlice` and the `host/model-class` port are deleted;
+  `selectNormalizedControls` / `selectEffectiveModelName` became `useNormalizedControls(agentId)`
+  (`agents/redux/agent-settings/useNormalizedControls`).
+- **The run tier is never copied onto the agent record**: selectors complete the record from the core run
+  tier store at read time (`agents/redux/agent-definition/run-tier-record`); a field the record read itself wins.
+- G3 `check:one-holder`: the model part and the run-tier projection are hard bans (self-tested).
+- Intelligence places name the package's real paths (`apps/shared/chat/src/...`).
+- **Consumer action:** host — make `getModelCatalog()` return chat's instance, hydrate shell model rows with
+  `getModelRecords().hydrate(...)`, drop `registerChatModelClassHooks`, repoint `modelRegistrySlice` imports.
+
 ## 0.3.33
 
 - **Opening a chat never asks for an organization.** `launchAgentExecution` asks before opening only

package/dist/agents/components/ambient-assistant/intelligence-places.js

@@ -3,14 +3,14 @@ const K = MANDATE_KEYS;
 const AMBIENT_PLACES = {
   feature: "ambient",
   label: "Ambient assistant",
-  roots: ["packages/chat/src/agents/components/ambient-assistant"],
+  roots: ["apps/shared/chat/src/agents/components/ambient-assistant"],
   places: [
     {
       id: "page-guidance",
       label: "Any page",
       trigger: "The page assistant (where a module has none of its own)",
       mandateKeys: [K.ambient__page_guidance],
-      sources: ["packages/chat/src/agents/components/ambient-assistant/ambientAssistantMandates.ts"]
+      sources: ["apps/shared/chat/src/agents/components/ambient-assistant/ambientAssistantMandates.ts"]
     },
     {
       id: "listen",

package/dist/agents/components/chat/intelligence-places.js

@@ -15,7 +15,7 @@ const CHAT_PLACES = {
   feature: "chat",
   label: "Chat",
   aliases: { DEFAULT_NEW_CHAT_MANDATE_KEY },
-  roots: ["packages/chat/src/agents/components/chat", "app/(core)/chat"],
+  roots: ["apps/shared/chat/src/agents/components/chat", "app/(core)/chat"],
   places: [
     {
       id: "new",
@@ -25,9 +25,9 @@ const CHAT_PLACES = {
       mandateKeys: [K.chat__default_new_chat],
       sources: [
         "app/(core)/chat/new/page.tsx",
-        "packages/chat/src/agents/components/chat/ChatNewClient.tsx",
-        "packages/chat/src/agents/components/chat/ChatNewHeader.tsx",
-        "packages/chat/src/agents/components/chat/NewChatGreeting.tsx"
+        "apps/shared/chat/src/agents/components/chat/ChatNewClient.tsx",
+        "apps/shared/chat/src/agents/components/chat/ChatNewHeader.tsx",
+        "apps/shared/chat/src/agents/components/chat/NewChatGreeting.tsx"
       ]
     },
     {
@@ -46,8 +46,8 @@ const CHAT_PLACES = {
       mandateKeys: [K.chat__default_new_chat],
       sources: [
         "app/(core)/chat/[conversationId]/page.tsx",
-        "packages/chat/src/agents/components/chat/ChatConversationRoom.tsx",
-        "packages/chat/src/agents/components/chat/ChatRoomClient.tsx"
+        "apps/shared/chat/src/agents/components/chat/ChatConversationRoom.tsx",
+        "apps/shared/chat/src/agents/components/chat/ChatRoomClient.tsx"
       ]
     },
     {
@@ -69,7 +69,7 @@ const CHAT_PLACES = {
         K.chat__response_mode_data,
         K.chat__response_mode_brainstorm
       ],
-      sources: ["packages/chat/src/cx-chat/components/agent/local-agents.ts"]
+      sources: ["apps/shared/chat/src/cx-chat/components/agent/local-agents.ts"]
     }
   ]
 };

package/dist/agents/components/inputs/smart-input/RunToolPicker.js

@@ -30,18 +30,14 @@ import {
 } from "../../../redux/agent-definition/selectors.js";
 import { fetchAgentRunControls } from "../../../redux/agent-definition/thunks.js";
 import { selectAgentIdFromInstance } from "../../../redux/execution-system/conversations/conversations.selectors.js";
-import {
-  selectAllModels,
-  selectModelFullyLoaded,
-  fetchModelById
-} from "../../../model-registry/modelRegistrySlice.js";
+import { selectAllModels, selectModelFullyLoaded } from "@ai-matrx/agents/models";
 import {
   useModelControls,
   supportsTools
 } from "../../../hooks/useModelControls.js";
 import { selectInstanceOverrideState } from "../../../redux/execution-system/instance-model-overrides/instance-model-overrides.selectors.js";
 import { effectiveOfferingPin } from "../../../redux/execution-system/instance-model-overrides/offering-pin.js";
-import { useModelClassControls } from "../../../../host/model-class.js";
+import { getModelRecords, useModelClassControls, useModelRecords } from "../../../identity/model-catalog.js";
 import { selectBuilderAdvancedSettings } from "../../../redux/execution-system/instance-ui-state/instance-ui-state.selectors.js";
 import { setBuilderAdvancedSettings } from "../../../redux/execution-system/instance-ui-state/instance-ui-state.slice.js";
 import { DEFAULT_BUILDER_ADVANCED_SETTINGS } from "../../../types/instance.types.js";
@@ -73,16 +69,14 @@ function RunToolPicker({ conversationId }) {
     selectInstanceOverrideState(conversationId)
   );
   const effectiveModelId = overrideState?.overrides?.model ?? overrideState?.baseSettings?.model ?? "";
-  const models = useAppSelector(selectAllModels);
-  const modelIsFull = useAppSelector(
-    (s) => selectModelFullyLoaded(s, effectiveModelId)
-  );
-  const modelRegistryLoading = useAppSelector((s) => s.modelRegistry.isLoading);
+  const models = useModelRecords(selectAllModels);
+  const modelIsFull = useModelRecords((s) => selectModelFullyLoaded(s, effectiveModelId));
+  const modelRegistryLoading = useModelRecords((s) => s.isLoading);
   useEffect(() => {
     if (effectiveModelId && !modelIsFull && !modelRegistryLoading) {
-      void dispatch(fetchModelById(effectiveModelId));
+      void getModelRecords().loadModel(effectiveModelId);
     }
-  }, [effectiveModelId, modelIsFull, modelRegistryLoading, dispatch]);
+  }, [effectiveModelId, modelIsFull, modelRegistryLoading]);
   const classControls = useModelClassControls(
     effectiveModelId,
     effectiveOfferingPin(overrideState)

package/dist/agents/components/inputs/smart-input/composer/ComposerAgentPill.js

@@ -21,7 +21,8 @@ import {
 import { useSessionKnob } from "../../../../../host/prefs-react.js";
 import { knobRefusalSentence, setKnobOverride } from "../../../../../host/prefs.js";
 import { CHAT_DEFAULT_MODEL_KNOB } from "../../../../../ui/chat-default-model-knob.js";
-import { selectModelLabelWithClass } from "../../../../model-registry/modelRegistrySlice.js";
+import { selectModelLabelWithClass } from "@ai-matrx/agents/models";
+import { useModelRecords } from "../../../../identity/model-catalog.js";
 import {
   ComposerMenuDivider,
   ComposerMenuHelp,
@@ -173,7 +174,7 @@ function ChatPresetsPanel({
   const personalModelId = typeof personalModel === "string" && personalModel.trim() ? personalModel : null;
   const overrideState = useAppSelector(selectInstanceOverrideState(conversationId));
   const pinnedOfferingId = effectiveOfferingPin(overrideState);
-  const personalModelLabel = useAppSelector((s) => selectModelLabelWithClass(s, personalModelId, pinnedOfferingId)) ?? null;
+  const personalModelLabel = useModelRecords((s) => selectModelLabelWithClass(s, personalModelId, pinnedOfferingId)) ?? null;
   const onSelectAgent = agentControl?.onSelectAgent;
   const agentFilter = useComposerAgentFilter(conversationId);
   if (!onSelectAgent) {

package/dist/agents/components/inputs/smart-input/composer/useComposerAgent.js

@@ -12,9 +12,9 @@ import { selectInstanceOverrideState } from "../../../../redux/execution-system/
 import {
   selectModelLabelById,
   selectModelLabelWithClass
-} from "../../../../model-registry/modelRegistrySlice.js";
+} from "@ai-matrx/agents/models";
 import { useModelOptions } from "../../../../../host/ui-slots.js";
-import { useModelClassLabels } from "../../../../../host/model-class.js";
+import { useModelClassLabels, useModelRecords } from "../../../../identity/model-catalog.js";
 import { useEffectiveClassPin } from "../../../../redux/execution-system/instance-model-overrides/useEffectiveClassPin.js";
 import { ensureAgentCatalog, useAgentName } from "../../../../identity/agent-identity.js";
 const CHAT_AGENT_TAG = "chat-agent";
@@ -49,14 +49,14 @@ function useComposerAgent(conversationId) {
   const classPins = useEffectiveClassPin(conversationId);
   const effectivePin = classPins.effectivePin ?? null;
   const agentOwnPin = classPins.basePin ?? null;
-  const effectiveModelLabel = useAppSelector((state) => selectModelLabelWithClass(state, effectiveModelId, effectivePin)) ?? null;
+  const effectiveModelLabel = useModelRecords((state) => selectModelLabelWithClass(state, effectiveModelId, effectivePin)) ?? null;
   const agentOwnModelId = useAgentOwnModelId(conversationId);
-  const agentModelLabel = useAppSelector((state) => selectModelLabelWithClass(state, agentOwnModelId, agentOwnPin)) ?? null;
+  const agentModelLabel = useModelRecords((state) => selectModelLabelWithClass(state, agentOwnModelId, agentOwnPin)) ?? null;
   const { mandate: customMandate } = useMandate(MANDATE_KEYS.chat__default_new_chat, { optional: true });
   const customAgentId = customMandate?.agentId ?? null;
   const rows = useAgentCatalogRows();
   const presetRows = rows.filter(isPresetRow);
-  const modelLabels = useAppSelector(
+  const modelLabels = useModelRecords(
     (state) => presetRows.map((row) => selectModelLabelById(state, row.modelId) ?? null).join("\0")
   ).split("\0");
   const presets = presetRows.map((row, index) => ({

package/dist/agents/components/inputs/smart-input/composer/useComposerAgentFilter.js

@@ -1,12 +1,13 @@
 "use client";
 import { useAppSelector } from "../../../../../store/hooks.js";
 import { selectBuilderAdvancedSettings } from "../../../../redux/execution-system/instance-ui-state/instance-ui-state.selectors.js";
-import { selectAllModels } from "../../../../model-registry/modelRegistrySlice.js";
+import { selectAllModels } from "@ai-matrx/agents/models";
+import { useModelRecords } from "../../../../identity/model-catalog.js";
 import { readOutputTypes } from "./output-selection.js";
 import { agentOutputFilterSpec, modelMakesAny, modelOutputModalities } from "./agent-output-filter.js";
 function useComposerAgentFilter(conversationId) {
   const settings = useAppSelector(selectBuilderAdvancedSettings(conversationId));
-  const models = useAppSelector(selectAllModels);
+  const models = useModelRecords(selectAllModels);
   const spec = agentOutputFilterSpec(readOutputTypes(settings?.outputTypes));
   if (!spec) return void 0;
   const outputsById = new Map(models.map((model) => [model.id, modelOutputModalities(model.capabilities)]));

package/dist/agents/components/run-controls/RunConfigOverrides.js

@@ -8,12 +8,10 @@ import { useAppDispatch, useAppSelector, useAppStore } from "../../../store/hook
 import {
   selectAllModels,
   selectModelFullyLoaded,
-  fetchModelById,
-  retryModelDetail,
   selectModelDetailError
-} from "../../model-registry/modelRegistrySlice.js";
+} from "@ai-matrx/agents/models";
 import { useModelControls } from "../../hooks/useModelControls.js";
-import { useModelClassControls } from "../../../host/model-class.js";
+import { getModelRecords, useModelClassControls, useModelRecords } from "../../identity/model-catalog.js";
 import {
   selectInstanceOverrideState,
   selectSettingsOverridesForApi
@@ -88,7 +86,7 @@ function RunConfigOverrides({
   const overrideState = useAppSelector(
     selectInstanceOverrideState(conversationId)
   );
-  const models = useAppSelector(selectAllModels);
+  const models = useModelRecords(selectAllModels);
   const overrideJson = useAppSelector(
     (state) => JSON.stringify(
       selectSettingsOverridesForApi(conversationId)(state) ?? {},
@@ -133,18 +131,14 @@ function RunConfigOverrides({
   const effectiveOffering = removals.includes("offering_id") ? nullDefaults?.offering_id : overrides.offering_id ?? base.offering_id;
   const pinnedOfferingId = typeof effectiveOffering === "string" && effectiveOffering ? effectiveOffering : void 0;
   const modelChoiceOverridden = "model" in overrides || "offering_id" in overrides || removals.includes("offering_id");
-  const isFull = useAppSelector(
-    (s) => selectModelFullyLoaded(s, effectiveModelId)
-  );
-  const modelDetailError = useAppSelector(
-    (s) => selectModelDetailError(s, effectiveModelId)
-  );
-  const registryLoading = useAppSelector((s) => s.modelRegistry.isLoading);
+  const isFull = useModelRecords((s) => selectModelFullyLoaded(s, effectiveModelId));
+  const modelDetailError = useModelRecords((s) => selectModelDetailError(s, effectiveModelId));
+  const registryLoading = useModelRecords((s) => s.isLoading);
   useEffect(() => {
     if (effectiveModelId && !isFull && !registryLoading) {
-      dispatch(fetchModelById(effectiveModelId));
+      void getModelRecords().loadModel(effectiveModelId);
     }
-  }, [dispatch, effectiveModelId, isFull, registryLoading]);
+  }, [effectiveModelId, isFull, registryLoading]);
   const classControls = useModelClassControls(effectiveModelId, pinnedOfferingId);
   const { normalizedControls } = useModelControls(
     models,
@@ -194,8 +188,8 @@ function RunConfigOverrides({
             {
               variant: "outline",
               onClick: () => {
-                dispatch(retryModelDetail(effectiveModelId));
-                void dispatch(fetchModelById(effectiveModelId));
+                getModelRecords().retryModel(effectiveModelId);
+                void getModelRecords().loadModel(effectiveModelId);
               },
               children: "Retry"
             }

package/dist/agents/components/run-controls/panels/shared.d.ts

@@ -64,7 +64,6 @@ export declare function makeSelectConversationRequests(conversationId: string):
     proposedDirectives: import("../../../redux/proposed-directives/proposedDirectivesSlice.js").ProposedDirectivesState;
     agentSettings: import("../../../redux/agent-settings/types.js").AgentSettingsState;
     conversationAttachments: import("../../../connectors/attachments.slice.js").AttachmentsSliceState;
-    modelRegistry: import("../../../model-registry/modelRegistrySlice.js").ModelRegistryState;
     chatHost: import("../../../../store/chat-host.slice.js").ChatHostState;
 } & import("../../../../store/root-state.js").ChatHostReadSlices) => ActiveRequest[]) & {
     clearCache: () => void;

package/dist/agents/hooks/useAgentModelLabel.js

@@ -7,8 +7,8 @@ import {
 import {
   selectModelLabelById,
   selectModelLabelWithClass
-} from "../model-registry/modelRegistrySlice.js";
-import { useModelClassLabels } from "../../host/model-class.js";
+} from "@ai-matrx/agents/models";
+import { useModelClassLabels, useModelLabel, useModelRecords } from "../identity/model-catalog.js";
 import { useAgentSummaryRow } from "../identity/agent-identity.js";
 function useAgentModelLabel(agentId) {
   useModelClassLabels();
@@ -21,7 +21,8 @@ function useAgentModelLabel(agentId) {
   );
   const modelId = ownModelId ?? summary?.modelId ?? null;
   const offeringId = ownOfferingId !== void 0 ? ownOfferingId : summary?.offeringId;
-  const label = useAppSelector(
+  useModelLabel(modelId);
+  const label = useModelRecords(
     (state) => offeringId === void 0 ? selectModelLabelById(state, modelId) : selectModelLabelWithClass(state, modelId, offeringId)
   );
   return { modelId, offeringId, label };

package/dist/agents/hooks/useDiffEnrichment.js

@@ -6,15 +6,13 @@ import {
   selectToolIdentityMap
 } from "../redux/tools/tools.selectors.js";
 import { selectMcpCatalog } from "../redux/mcp/mcp.slice.js";
-import { selectModelIdentityMap } from "../model-registry/modelRegistrySlice.js";
+import { useModelRecords } from "../identity/model-catalog.js";
 function useDiffEnrichment() {
   const allTools = useAppSelector(selectAllTools);
   const toolIdentities = useAppSelector(selectToolIdentityMap);
   const mcpCatalog = useAppSelector(selectMcpCatalog);
-  const modelEntities = useAppSelector(
-    (state) => state.modelRegistry.entities
-  );
-  const modelIdentities = useAppSelector(selectModelIdentityMap);
+  const modelEntities = useModelRecords((s) => s.entities);
+  const modelIdentities = useModelRecords((s) => s.identityById);
   return useMemo(
     () => ({
       resolveModelId: (id) => {

package/dist/agents/hooks/useModelControls.d.ts

@@ -2,7 +2,7 @@
  * Hook to parse and normalize model controls from dynamic API data
  * Keeps snake_case naming for compatibility with Python backend
  */
-import type { ModelClassControls } from "../../host/model-class.js";
+import type { ModelClassControls } from "../identity/model-catalog.js";
 import type { AIModelRecord } from "../redux/model-registry.js";
 export interface ControlDefinition {
     type: "number" | "integer" | "boolean" | "string" | "enum" | "array" | "string_array" | "object_array";
@@ -160,89 +160,11 @@ export declare function useModelControls(models: AIModelRecord[], selectedModelI
     error: string;
 } | {
     normalizedControls: NormalizedControls;
-    selectedModel: {
-        capabilities: import("../../host/db-types.js").Json | null;
-        common_name: string | null;
-        context_window: number | null;
-        cost_rating: number | null;
-        created_at: string;
-        created_by: string | null;
-        deleted_at: string | null;
-        description: string | null;
-        guest_fallback_id: string | null;
-        id: string;
-        is_deprecated: boolean | null;
-        is_premium: boolean | null;
-        is_primary: boolean | null;
-        is_system: boolean;
-        max_tokens: number | null;
-        metadata: import("../../host/db-types.js").Json;
-        mid_fallback_id: string | null;
-        name: string;
-        organization_id: string;
-        provider_id: string | null;
-        published_to_web: boolean;
-        published_to_web_at: string | null;
-        published_to_web_by: string | null;
-        release_date: string | null;
-        retired_at: string | null;
-        retry_fallback_id: string | null;
-        retry_max_attempts: number;
-        shown_to: import("../../host/db-types.js").Database["platform"]["Enums"]["shown_to"] | null;
-        speed_rating: number | null;
-        successor_id: string | null;
-        updated_at: string;
-        updated_by: string | null;
-        version: number;
-        visibility: import("../../host/db-types.js").Database["platform"]["Enums"]["visibility"];
-        _fetchType: import("../model-registry/modelRegistrySlice.js").ModelRecordFetchType;
-        maker: string | null;
-        controls: unknown;
-        constraints: unknown;
-    };
+    selectedModel: AIModelRecord;
     error: null;
 } | {
     normalizedControls: NormalizedControls;
-    selectedModel: {
-        capabilities: import("../../host/db-types.js").Json | null;
-        common_name: string | null;
-        context_window: number | null;
-        cost_rating: number | null;
-        created_at: string;
-        created_by: string | null;
-        deleted_at: string | null;
-        description: string | null;
-        guest_fallback_id: string | null;
-        id: string;
-        is_deprecated: boolean | null;
-        is_premium: boolean | null;
-        is_primary: boolean | null;
-        is_system: boolean;
-        max_tokens: number | null;
-        metadata: import("../../host/db-types.js").Json;
-        mid_fallback_id: string | null;
-        name: string;
-        organization_id: string;
-        provider_id: string | null;
-        published_to_web: boolean;
-        published_to_web_at: string | null;
-        published_to_web_by: string | null;
-        release_date: string | null;
-        retired_at: string | null;
-        retry_fallback_id: string | null;
-        retry_max_attempts: number;
-        shown_to: import("../../host/db-types.js").Database["platform"]["Enums"]["shown_to"] | null;
-        speed_rating: number | null;
-        successor_id: string | null;
-        updated_at: string;
-        updated_by: string | null;
-        version: number;
-        visibility: import("../../host/db-types.js").Database["platform"]["Enums"]["visibility"];
-        _fetchType: import("../model-registry/modelRegistrySlice.js").ModelRecordFetchType;
-        maker: string | null;
-        controls: unknown;
-        constraints: unknown;
-    };
+    selectedModel: AIModelRecord;
     error: string;
 };
 /**
@@ -265,89 +187,11 @@ export declare function resolveModelControls(models: AIModelRecord[], selectedMo
     error: string;
 } | {
     normalizedControls: NormalizedControls;
-    selectedModel: {
-        capabilities: import("../../host/db-types.js").Json | null;
-        common_name: string | null;
-        context_window: number | null;
-        cost_rating: number | null;
-        created_at: string;
-        created_by: string | null;
-        deleted_at: string | null;
-        description: string | null;
-        guest_fallback_id: string | null;
-        id: string;
-        is_deprecated: boolean | null;
-        is_premium: boolean | null;
-        is_primary: boolean | null;
-        is_system: boolean;
-        max_tokens: number | null;
-        metadata: import("../../host/db-types.js").Json;
-        mid_fallback_id: string | null;
-        name: string;
-        organization_id: string;
-        provider_id: string | null;
-        published_to_web: boolean;
-        published_to_web_at: string | null;
-        published_to_web_by: string | null;
-        release_date: string | null;
-        retired_at: string | null;
-        retry_fallback_id: string | null;
-        retry_max_attempts: number;
-        shown_to: import("../../host/db-types.js").Database["platform"]["Enums"]["shown_to"] | null;
-        speed_rating: number | null;
-        successor_id: string | null;
-        updated_at: string;
-        updated_by: string | null;
-        version: number;
-        visibility: import("../../host/db-types.js").Database["platform"]["Enums"]["visibility"];
-        _fetchType: import("../model-registry/modelRegistrySlice.js").ModelRecordFetchType;
-        maker: string | null;
-        controls: unknown;
-        constraints: unknown;
-    };
+    selectedModel: AIModelRecord;
     error: null;
 } | {
     normalizedControls: NormalizedControls;
-    selectedModel: {
-        capabilities: import("../../host/db-types.js").Json | null;
-        common_name: string | null;
-        context_window: number | null;
-        cost_rating: number | null;
-        created_at: string;
-        created_by: string | null;
-        deleted_at: string | null;
-        description: string | null;
-        guest_fallback_id: string | null;
-        id: string;
-        is_deprecated: boolean | null;
-        is_premium: boolean | null;
-        is_primary: boolean | null;
-        is_system: boolean;
-        max_tokens: number | null;
-        metadata: import("../../host/db-types.js").Json;
-        mid_fallback_id: string | null;
-        name: string;
-        organization_id: string;
-        provider_id: string | null;
-        published_to_web: boolean;
-        published_to_web_at: string | null;
-        published_to_web_by: string | null;
-        release_date: string | null;
-        retired_at: string | null;
-        retry_fallback_id: string | null;
-        retry_max_attempts: number;
-        shown_to: import("../../host/db-types.js").Database["platform"]["Enums"]["shown_to"] | null;
-        speed_rating: number | null;
-        successor_id: string | null;
-        updated_at: string;
-        updated_by: string | null;
-        version: number;
-        visibility: import("../../host/db-types.js").Database["platform"]["Enums"]["visibility"];
-        _fetchType: import("../model-registry/modelRegistrySlice.js").ModelRecordFetchType;
-        maker: string | null;
-        controls: unknown;
-        constraints: unknown;
-    };
+    selectedModel: AIModelRecord;
     error: string;
 };
 /**

package/dist/agents/identity/model-catalog.d.ts

@@ -0,0 +1,37 @@
+import { type ModelCatalog, type ModelClassConfig, type ModelRecord, type ModelRecords, type ModelRecordsState } from "@ai-matrx/agents/models";
+export declare function getModelCatalog(): ModelCatalog;
+export declare const getModelRecords: () => ModelRecords;
+/** The records state now. A host with no database bound yet (a unit test) reads empty. */
+export declare function readModelRecords(): ModelRecordsState;
+/** Subscribe to a slice of the records. `select` must return a stable value for unchanged state. */
+export declare function useModelRecords<T>(select: (state: ModelRecordsState) => T): T;
+/** One model's record (options or full); reads the full record when `full` and it is missing. */
+export declare function useModelRecord(modelId: string | null | undefined, options?: {
+    full?: boolean;
+}): ModelRecord | undefined;
+/** A model's display label; loads the options list (then the identity) when it is unknown. */
+export declare function useModelLabel(modelId: string | null | undefined): string | undefined;
+/** "Qwen3.8 27B · Matrx Lightning" when the model has several classes; loads the class index once. */
+export declare function useModelLabelWithClass(modelId: string | null | undefined, offeringId: string | null | undefined): string | undefined;
+/** Loads every model's classes once (no-op after the first success). */
+export declare function useModelClassLabels(): void;
+/**
+ * The resolved controls for the CLASS a model runs on. With a pin it loads that class's controls;
+ * without one it answers `undefined` and callers keep the model's own (preferred-class) controls.
+ * `{ pending: true }` while it loads, `{ failed: true }` when the pin is refused — never another
+ * class's controls.
+ */
+export type ModelClassControls = undefined | {
+    pending: true;
+    failed?: false;
+    config?: undefined;
+} | {
+    pending?: false;
+    failed: true;
+    config?: undefined;
+} | {
+    pending?: false;
+    failed?: false;
+    config: ModelClassConfig;
+};
+export declare function useModelClassControls(modelId: string | null | undefined, offeringId: string | null | undefined): ModelClassControls;

package/dist/agents/identity/model-catalog.js

@@ -0,0 +1,103 @@
+"use client";
+import { useEffect } from "react";
+import {
+  classConfigKey,
+  createModelCatalog,
+  EMPTY_MODEL_RECORDS,
+  selectModelById,
+  selectModelLabelById,
+  selectModelLabelWithClass
+} from "@ai-matrx/agents/models";
+import { useModelRecordsSelector } from "@ai-matrx/agents/models/react";
+import { supabase } from "../../host/db.js";
+import { captureError } from "../../host/diagnostics.js";
+import { isSignedOutVisitor } from "../../host/identity.js";
+const KEY = /* @__PURE__ */ Symbol.for("ai-matrx.chat.model-catalog");
+function getModelCatalog() {
+  const g = globalThis;
+  if (g[KEY]) return g[KEY];
+  const catalog = createModelCatalog({
+    // supabase-js satisfies the catalog's structural client as-is.
+    client: supabase,
+    isSignedIn: async () => !await isSignedOutVisitor(),
+    errorSink: (event) => {
+      captureError({
+        source: "supabase-postgrest",
+        schema: "ai",
+        code: event.code,
+        message: event.message,
+        ...event.context ? { details: JSON.stringify(event.context) } : {}
+      });
+    }
+  });
+  g[KEY] = catalog;
+  return catalog;
+}
+const getModelRecords = () => getModelCatalog().records;
+function readModelRecords() {
+  try {
+    return getModelRecords().getState();
+  } catch {
+    return EMPTY_MODEL_RECORDS;
+  }
+}
+function useModelRecords(select) {
+  return useModelRecordsSelector(getModelRecords(), select);
+}
+function useModelRecord(modelId, options) {
+  const record = useModelRecords((s) => selectModelById(s, modelId));
+  const full = options?.full === true;
+  const fetchType = record?._fetchType;
+  useEffect(() => {
+    if (!modelId) return;
+    if (full && fetchType !== "full") void getModelRecords().loadModel(modelId);
+    else if (!fetchType) void getModelRecords().loadOptions();
+  }, [modelId, full, fetchType]);
+  return record;
+}
+function useModelLabel(modelId) {
+  const label = useModelRecords((s) => selectModelLabelById(s, modelId));
+  useEffect(() => {
+    if (!modelId || label) return;
+    const records = getModelRecords();
+    void records.loadOptions().then(() => {
+      if (!selectModelLabelById(records.getState(), modelId)) void records.loadIdentity(modelId);
+    });
+  }, [modelId, label]);
+  return label;
+}
+function useModelLabelWithClass(modelId, offeringId) {
+  useModelLabel(modelId);
+  useEffect(() => {
+    void getModelRecords().loadClasses();
+  }, []);
+  return useModelRecords((s) => selectModelLabelWithClass(s, modelId, offeringId));
+}
+function useModelClassLabels() {
+  useEffect(() => {
+    void getModelRecords().loadClasses();
+  }, []);
+}
+function useModelClassControls(modelId, offeringId) {
+  const key = modelId && offeringId ? classConfigKey(modelId, offeringId) : null;
+  const config = useModelRecords((s) => key ? s.classConfigByOffering[key] : void 0);
+  const status = useModelRecords((s) => key ? s.classConfigStatusByOffering[key] : void 0);
+  useEffect(() => {
+    if (modelId && offeringId) void getModelRecords().loadClassConfig(modelId, offeringId);
+  }, [modelId, offeringId]);
+  if (!modelId || !offeringId) return void 0;
+  if (config) return { config };
+  if (status === "failed") return { failed: true };
+  return { pending: true };
+}
+export {
+  getModelCatalog,
+  getModelRecords,
+  readModelRecords,
+  useModelClassControls,
+  useModelClassLabels,
+  useModelLabel,
+  useModelLabelWithClass,
+  useModelRecord,
+  useModelRecords
+};