@ai-matrx/chat 0.3.32 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @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
+  when the run starts now or a window/gate opens (`launchAsksForOrganizationBeforeOpen`); an inline
+  composer (`/chat/new`) asks at the first send through the same hold-and-set gate.
+- **Reading your own agent-less chat never waits on the active workspace.** `ChatConversationRoom`
+  takes `organizationId` (the row's own) and resolves its mandate there.
+  Consumer action: pass the conversation row's `organization_id` to `ChatConversationRoom`.
+
 ## 0.3.32
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

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/ChatConversationRoom.d.ts

@@ -19,8 +19,14 @@ import type { ComposerMode } from "../inputs/smart-input/composer/composer-types
  *    `mandateKey` rides along so the next turn is answered by whoever the
  *    org/user binding says, not by a frozen display identity.
  */
-export declare function ChatConversationRoom({ conversationId, agentId, ownedByMandate, sandboxBinding, composer, }: {
+export declare function ChatConversationRoom({ conversationId, agentId, ownedByMandate, sandboxBinding, composer, organizationId, }: {
     conversationId: string;
+    /**
+     * The conversation ROW's own organization. An agent-less room resolves its
+     * mandate in THAT organization, so reading your own chat never waits on, or
+     * asks for, the active workspace (Arman, 2026-10-07).
+     */
+    organizationId?: string | null;
     /** The conversation's own agent, or the SSR-resolved mandate agent, or null. */
     agentId: string | null;
     /** True when `agentId` is the mandate's display identity, not the row's. */

package/dist/agents/components/chat/ChatConversationRoom.js

@@ -10,7 +10,8 @@ function ChatConversationRoom({
   agentId,
   ownedByMandate,
   sandboxBinding = null,
-  composer
+  composer,
+  organizationId = null
 }) {
   if (agentId && !ownedByMandate) {
     return /* @__PURE__ */ jsx(
@@ -39,6 +40,7 @@ function ChatConversationRoom({
     ChatConversationRoomResolved,
     {
       conversationId,
+      organizationId,
       sandboxBinding,
       composer
     }
@@ -46,10 +48,14 @@ function ChatConversationRoom({
 }
 function ChatConversationRoomResolved({
   conversationId,
+  organizationId,
   sandboxBinding,
   composer
 }) {
-  const { mandate, loading, error, organizationPending } = useMandate(DEFAULT_NEW_CHAT_MANDATE_KEY);
+  const { mandate, loading, error, organizationPending } = useMandate(
+    DEFAULT_NEW_CHAT_MANDATE_KEY,
+    organizationId ? { organizationId } : {}
+  );
   if (loading) return /* @__PURE__ */ jsx(ChatNewLandingSkeleton, {});
   if (organizationPending) {
     return /* @__PURE__ */ jsx(WorkspaceGate, { blocked: true, sentence: "This chat needs a workspace to open.", children: /* @__PURE__ */ jsx(ChatNewLandingSkeleton, {}) });

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;