@ai-matrx/chat 0.5.17 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ai-matrx/chat
 
+## 0.6.0
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.5.18..npm/chat/v0.6.0 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
+## 0.5.18
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.5.17..npm/chat/v0.5.18 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
 ## 0.5.17
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/agents/components/identity-refs/AiIdentityRef.d.ts

@@ -0,0 +1,33 @@
+/** The admin model console deep link. */
+export declare function aiModelHref(modelId: string): string;
+/** The admin tool console deep link. */
+export declare function toolHref(toolId: string): string;
+interface AiIdentityRefCommonProps {
+    /** Explicit joined label wins and avoids even a cached lookup. */
+    name?: string | null;
+    /** Audit/history mode: render the complete raw FK directly below the name. */
+    showId?: boolean;
+    showIcon?: boolean;
+    alwaysShowActions?: boolean;
+    openInNewTab?: boolean;
+    /** For identity text nested inside another interactive control. */
+    disableNavigation?: boolean;
+    className?: string;
+    labelClassName?: string;
+}
+export interface AiModelRefProps extends AiIdentityRefCommonProps {
+    modelId: string;
+    /**
+     * Naming the model an agent or run USES: a model with several classes is
+     * shown with its class ("Qwen3.8 27B · Matrx Lightning"). `offeringId` is the
+     * pin; none = the preferred class the server runs.
+     */
+    showClass?: boolean;
+    offeringId?: string | null;
+}
+export declare function AiModelRef({ modelId, showClass, offeringId, name, showId, showIcon, alwaysShowActions, openInNewTab, disableNavigation, className, labelClassName, }: AiModelRefProps): import("react").JSX.Element;
+export interface AiToolRefProps extends AiIdentityRefCommonProps {
+    toolId: string;
+}
+export declare function AiToolRef({ toolId, name, showId, showIcon, alwaysShowActions, openInNewTab, disableNavigation, className, labelClassName, }: AiToolRefProps): import("react").JSX.Element;
+export {};

package/dist/agents/components/identity-refs/AiIdentityRef.js

@@ -0,0 +1,138 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useEffect } from "react";
+import { withModelClass, selectModelById, selectModelClassName, selectModelIdentityById, selectModelIdentityLookupStatus } from "@ai-matrx/agents/models";
+import { humanizeIdentifier } from "@ai-matrx/kit/text-case";
+import { getModelRecords, useModelRecords } from "../../identity/model-catalog.js";
+import { loadToolById, selectToolById, selectToolLookupStatus, useToolCatalog } from "../../identity/tool-catalog.js";
+import { EntityRef } from "../../../host/ui-slots.js";
+import { selectIsSuperAdmin } from "../../../host/identity.js";
+import { useAppSelector } from "../../../store/hooks.js";
+const cn = (...parts) => parts.filter(Boolean).join(" ");
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const isUuidValue = (value) => typeof value === "string" && UUID.test(value.trim());
+function aiModelHref(modelId) {
+  return `/administration/ai/ai-models?model=${encodeURIComponent(modelId)}`;
+}
+function toolHref(toolId) {
+  return `/administration/agents/mcp-tools/${encodeURIComponent(toolId)}`;
+}
+function IdentityLabel({ id, name, showId }) {
+  return /* @__PURE__ */ jsxs(
+    "span",
+    {
+      className: cn(
+        "inline-flex min-w-0",
+        showId ? "flex-col" : "items-baseline gap-1"
+      ),
+      children: [
+        /* @__PURE__ */ jsx("span", { className: "min-w-0 truncate font-medium", children: name }),
+        showId ? /* @__PURE__ */ jsx("span", { className: "select-all break-all font-mono type-meta font-normal text-muted-foreground", children: id }) : null
+      ]
+    }
+  );
+}
+function fallbackName(kind, id) {
+  return isUuidValue(id) ? `Unknown ${kind}` : humanizeIdentifier(id);
+}
+function AiModelRef({
+  modelId,
+  showClass = false,
+  offeringId,
+  name,
+  showId = false,
+  showIcon = true,
+  alwaysShowActions,
+  openInNewTab = true,
+  disableNavigation = false,
+  className,
+  labelClassName
+}) {
+  const model = useModelRecords((state) => selectModelById(state, modelId));
+  const historicalIdentity = useModelRecords(
+    (state) => selectModelIdentityById(state, modelId)
+  );
+  const lookupStatus = useModelRecords(
+    (state) => selectModelIdentityLookupStatus(state, modelId)
+  );
+  const isSuperAdmin = useAppSelector(selectIsSuperAdmin);
+  const classStatus = useModelRecords((s) => s.modelClassStatus);
+  const modelClass = useModelRecords(
+    (s) => showClass ? selectModelClassName(s, modelId, offeringId) : void 0
+  );
+  useEffect(() => {
+    if (showClass && !classStatus) getModelRecords().loadClasses();
+  }, [showClass, classStatus]);
+  useEffect(() => {
+    if (!name && !model && !historicalIdentity && isUuidValue(modelId) && lookupStatus === "idle") {
+      getModelRecords().loadIdentity(modelId);
+    }
+  }, [historicalIdentity, lookupStatus, model, modelId, name]);
+  const baseName = name?.trim() || model?.common_name || model?.name || historicalIdentity?.common_name || historicalIdentity?.name || fallbackName("AI model", modelId);
+  const resolvedName = withModelClass(baseName, modelClass);
+  const mustShowId = showId || !name && !model && !historicalIdentity && isUuidValue(modelId);
+  return /* @__PURE__ */ jsx(
+    EntityRef,
+    {
+      token: "ai_model",
+      id: modelId,
+      name: resolvedName,
+      href: isSuperAdmin && !disableNavigation ? aiModelHref(modelId) : void 0,
+      showIcon,
+      disablePeek: disableNavigation,
+      disableNewTab: disableNavigation,
+      openInNewTab,
+      alwaysShowActions,
+      wrap: mustShowId,
+      className,
+      labelClassName,
+      children: /* @__PURE__ */ jsx(IdentityLabel, { id: modelId, name: resolvedName, showId: mustShowId })
+    }
+  );
+}
+function AiToolRef({
+  toolId,
+  name,
+  showId = false,
+  showIcon = true,
+  alwaysShowActions,
+  openInNewTab = true,
+  disableNavigation = false,
+  className,
+  labelClassName
+}) {
+  const tool = useToolCatalog((state) => selectToolById(state, toolId));
+  const lookupStatus = useToolCatalog((state) => selectToolLookupStatus(state, toolId));
+  const isSuperAdmin = useAppSelector(selectIsSuperAdmin);
+  useEffect(() => {
+    if (!name && !tool && isUuidValue(toolId) && lookupStatus === "idle") {
+      void loadToolById(toolId);
+    }
+  }, [lookupStatus, name, tool, toolId]);
+  const resolvedName = name?.trim() || tool?.name || fallbackName("tool", toolId);
+  const mustShowId = showId || !name && !tool && isUuidValue(toolId);
+  return /* @__PURE__ */ jsx(
+    EntityRef,
+    {
+      token: "tool",
+      id: toolId,
+      name: resolvedName,
+      href: isSuperAdmin && !disableNavigation ? toolHref(toolId) : void 0,
+      showIcon,
+      disablePeek: disableNavigation,
+      disableNewTab: disableNavigation,
+      openInNewTab,
+      alwaysShowActions,
+      wrap: mustShowId,
+      className,
+      labelClassName,
+      children: /* @__PURE__ */ jsx(IdentityLabel, { id: toolId, name: resolvedName, showId: mustShowId })
+    }
+  );
+}
+export {
+  AiModelRef,
+  AiToolRef,
+  aiModelHref,
+  toolHref
+};

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

@@ -42,15 +42,11 @@ import {
   selectAgentTools,
   selectAgentRunControlsReady
 } from "../../../redux/agent-definition/selectors.js";
-import {
-  selectAllTools,
-  selectToolsStatus
-} from "../../../redux/tools/tools.selectors.js";
-import { fetchAvailableTools } from "../../../redux/tools/tools.thunks.js";
 import { fetchAgentRunControls } from "../../../redux/agent-definition/thunks.js";
-import { AiToolRef } from "../../../../host/ui-slots.js";
+import { AiToolRef } from "../../identity-refs/AiIdentityRef.js";
 import { useTouchOnlyDevice } from "../../../../ui/composer/useTouchOnlyDevice.js";
 import { selectSandboxBySurface } from "../../../../host/prefs.js";
+import { loadAvailableTools, selectAllTools, selectToolsStatus, useToolCatalog } from "../../../identity/tool-catalog.js";
 const EMPTY_LIST = [];
 function Row({ label, children }) {
   return /* @__PURE__ */ jsxs("div", { className: "grid min-h-8 grid-cols-[9rem_minmax(0,1fr)] items-center gap-2", children: [
@@ -140,8 +136,8 @@ function QuicksetPanel({
   const mcpServers = useAppSelector(
     (state) => agentId ? selectAgentMcpServers(state, agentId) : EMPTY_LIST
   );
-  const toolCatalog = useAppSelector(selectAllTools);
-  const toolsStatus = useAppSelector(selectToolsStatus);
+  const toolCatalog = useToolCatalog(selectAllTools);
+  const toolsStatus = useToolCatalog(selectToolsStatus);
   const agentReady = useAppSelector(
     (state) => agentId ? selectAgentRunControlsReady(state, agentId) : true
   );
@@ -156,7 +152,7 @@ function QuicksetPanel({
   });
   useEffect(() => {
     if (toolsStatus !== "succeeded" && toolsStatus !== "loading") {
-      void dispatch(fetchAvailableTools());
+      void loadAvailableTools();
     }
   }, [dispatch, toolsStatus]);
   useEffect(() => {

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

@@ -17,7 +17,7 @@ import { fetchAgentRunControls } from "../../../redux/agent-definition/thunks.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";
-import { useSkills } from "../../../../host/ui-slots.js";
+import { useSkills } from "../../../identity/skill-catalog.js";
 import { ReadFailure } from "../../../../host/ui-slots.js";
 import { filterAndSortBySearch } from "@ai-matrx/kit/search-scoring";
 import {

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

@@ -14,13 +14,7 @@ import {
   PicksSkeletons,
   PicksSwitchRow
 } from "./RunPicksSurface.js";
-import {
-  selectAllTools,
-  selectToolsStatus,
-  selectToolsError
-} from "../../../redux/tools/tools.selectors.js";
 import { ReadFailure } from "../../../../host/ui-slots.js";
-import { fetchAvailableTools } from "../../../redux/tools/tools.thunks.js";
 import {
   selectAgentError,
   selectAgentTools,
@@ -44,11 +38,12 @@ import { DEFAULT_BUILDER_ADVANCED_SETTINGS } from "../../../types/instance.types
 import { filterAndSortBySearch } from "@ai-matrx/kit/search-scoring";
 import { getToolDisplayName } from "../../../../tool-call-visualization/registry/registry.js";
 import { groupToolCatalog, toolCategoryLabel } from "./run-tool-catalog.js";
+import { loadAvailableTools, selectAllTools, selectToolsError, selectToolsStatus, useToolCatalog } from "../../../identity/tool-catalog.js";
 function RunToolPicker({ conversationId }) {
   const dispatch = useAppDispatch();
-  const tools = useAppSelector(selectAllTools);
-  const status = useAppSelector(selectToolsStatus);
-  const toolsError = useAppSelector(selectToolsError);
+  const tools = useToolCatalog(selectAllTools);
+  const status = useToolCatalog(selectToolsStatus);
+  const toolsError = useToolCatalog(selectToolsError);
   const agentId = useAppSelector(selectAgentIdFromInstance(conversationId));
   const agentToolIds = useAppSelector(
     (s) => agentId ? selectAgentTools(s, agentId) : void 0
@@ -92,7 +87,7 @@ function RunToolPicker({ conversationId }) {
   const added = new Set(addedList);
   useEffect(() => {
     if (status === "idle") {
-      void dispatch(fetchAvailableTools());
+      void loadAvailableTools();
     }
   }, [status, dispatch]);
   useEffect(() => {
@@ -249,7 +244,7 @@ function RunToolPicker({ conversationId }) {
           error: toolsError ?? true,
           what: "the tool catalog",
           className: "m-2",
-          onRetry: () => void dispatch(fetchAvailableTools())
+          onRetry: () => void loadAvailableTools()
         }
       ) : void 0,
       addDisabledReason: modelSupportsTools ? void 0 : "Pick a model that supports tools to add any."

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

@@ -12,7 +12,7 @@ import { useAppDispatch, useAppSelector } from "../../../../store/hooks.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";
-import { useSkills } from "../../../../host/ui-slots.js";
+import { useSkills } from "../../../identity/skill-catalog.js";
 import { SHAPE_CHIP_DEFS } from "./shape-chips.js";
 import { selectedOutputKinds, toggleOutputKind } from "./composer/output-selection.js";
 const CHIP_ICONS = {

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

@@ -12,7 +12,7 @@ import {
   resetOverride,
   setOverrides
 } from "../../../../redux/execution-system/instance-model-overrides/instance-model-overrides.slice.js";
-import { useModelFull } from "../../../../../host/ui-slots.js";
+import { useModelFull } from "../../../../identity/model-catalog.js";
 import { resolveModelControls } from "../../../../hooks/useModelControls.js";
 import {
   ComposerMenuDivider,

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

@@ -31,7 +31,7 @@ import { useAppDispatch, useAppSelector } from "../../../../../store/hooks.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";
-import { useSkills } from "../../../../../host/ui-slots.js";
+import { useSkills } from "../../../../identity/skill-catalog.js";
 import { useClippedContentGuard } from "../../../../../host/ui-slots.js";
 import { ComposerMenuDivider, ComposerMenuHelp, ComposerMenuLabel, ComposerMenuRow } from "./ComposerMenu.js";
 import {

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

@@ -33,7 +33,7 @@ import { useAppDispatch, useAppSelector } from "../../../../../store/hooks.js";
 import { ResourcePickerMenu } from "../../../../../host/ui-slots.js";
 import { flattenResourcePickerItems } from "../../../../../host/ui-slots.js";
 import { useKnowledgeAttachSearch } from "../../../../../host/ui-slots.js";
-import { useRunControlCounts } from "../../../../../host/ui-slots.js";
+import { useRunControlCounts } from "./useRunControlCounts.js";
 import {
   useAttachResource,
   useDetachResource

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

@@ -13,7 +13,7 @@ import {
   selectModelLabelById,
   selectModelLabelWithClass
 } from "@ai-matrx/agents/models";
-import { useModelOptions } from "../../../../../host/ui-slots.js";
+import { useModelOptions } from "../../../../identity/model-catalog.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";

package/dist/agents/components/inputs/smart-input/composer/useRunControlCounts.d.ts

@@ -0,0 +1,3 @@
+import { type RunControlCounts } from "@ai-matrx/agents/runtime";
+export type { RunControlCounts };
+export declare function useRunControlCounts(conversationId?: string): RunControlCounts;

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

@@ -0,0 +1,54 @@
+"use client";
+import { useEffect } from "react";
+import { computeRunControlCounts } from "@ai-matrx/agents/runtime";
+import { hasField } from "@ai-matrx/agents/field-flags";
+import { useAppDispatch, useAppSelector } from "../../../../../store/hooks.js";
+import { selectAgentIdFromInstance } from "../../../../redux/execution-system/conversations/conversations.selectors.js";
+import {
+  selectAgentById,
+  selectAgentCustomTools,
+  selectAgentRunTier,
+  selectAgentSkillConfig,
+  selectAgentTools
+} from "../../../../redux/agent-definition/selectors.js";
+import { fetchAgentRunTier } from "../../../../redux/agent-definition/thunks.js";
+import { selectBuilderAdvancedSettings } from "../../../../redux/execution-system/instance-ui-state/instance-ui-state.selectors.js";
+import { DEFAULT_BUILDER_ADVANCED_SETTINGS } from "../../../../types/instance.types.js";
+function useRunControlCounts(conversationId) {
+  const dispatch = useAppDispatch();
+  const agentId = useAppSelector((s) => conversationId ? selectAgentIdFromInstance(conversationId)(s) : void 0);
+  const runTierReady = useAppSelector((s) => agentId ? selectAgentRunTier(s, agentId).isReady : false);
+  const customToolsKnown = useAppSelector((s) => {
+    const record = agentId ? selectAgentById(s, agentId) : void 0;
+    return !!record && hasField(record._loadedFields, "customTools");
+  });
+  const skillConfigKnown = useAppSelector((s) => {
+    const record = agentId ? selectAgentById(s, agentId) : void 0;
+    return !!record && hasField(record._loadedFields, "skillConfig");
+  });
+  const runCounts = useAppSelector((s) => agentId ? selectAgentRunTier(s, agentId).counts : null);
+  const builtInToolIds = useAppSelector((s) => agentId ? selectAgentTools(s, agentId) : void 0);
+  const customTools = useAppSelector((s) => agentId ? selectAgentCustomTools(s, agentId) : void 0);
+  const skillConfig = useAppSelector((s) => agentId ? selectAgentSkillConfig(s, agentId) : void 0);
+  const settings = useAppSelector((s) => conversationId ? selectBuilderAdvancedSettings(conversationId)(s) : void 0);
+  useEffect(() => {
+    if (agentId && !runTierReady) void dispatch(fetchAgentRunTier(agentId));
+  }, [agentId, runTierReady, dispatch]);
+  if (!conversationId) return {};
+  const advanced = settings ?? DEFAULT_BUILDER_ADVANCED_SETTINGS;
+  return computeRunControlCounts({
+    hasAgent: Boolean(agentId),
+    runTierReady,
+    runCounts,
+    builtInToolIds: Array.isArray(builtInToolIds) ? builtInToolIds : [],
+    customTools: Array.isArray(customTools) ? customTools : [],
+    customToolsKnown,
+    skillConfig: skillConfig ?? null,
+    skillConfigKnown,
+    addedTools: advanced.addedTools ?? [],
+    addedSkills: advanced.addedSkills ?? []
+  });
+}
+export {
+  useRunControlCounts
+};

package/dist/agents/components/model-tiers/ModelTierIdentityList.js

@@ -1,6 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { AiModelRef } from "../../../host/ui-slots.js";
+import { AiModelRef } from "../identity-refs/AiIdentityRef.js";
 import { cn } from "@ai-matrx/design-system";
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);

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

@@ -29,7 +29,7 @@ import {
 import {
   buildSettingsRows
 } from "../../redux/agent-settings/settings-catalogue.js";
-import { SettingControlInput } from "../../../host/ui-slots.js";
+import { SettingControlInput } from "@ai-matrx/agents/settings/react";
 import { Label, ErrorBox } from "@ai-matrx/design-system";
 import { cn } from "@ai-matrx/design-system";
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "../../../ui/tabs.js";

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

@@ -1,7 +1,7 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useAppDispatch, useAppSelector } from "../../../store/hooks.js";
-import { InputCapabilitiesEditor } from "../../../host/ui-slots.js";
+import { InputCapabilitiesEditor } from "@ai-matrx/agents/settings/react";
 import { selectInputCapabilitiesState } from "../../redux/execution-system/instance-input-capabilities/instance-input-capabilities.selectors.js";
 import {
   resetInputCapabilityOverride,

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

@@ -30,7 +30,6 @@ export declare function makeSelectConversationRequests(conversationId: string):
     agentShortcut: import("../../../redux/agent-shortcuts/types.js").AgentShortcutSliceState;
     agentShortcutCategory: import("../../../redux/agent-shortcut-categories/types.js").AgentShortcutCategorySliceState;
     surfaceUserState: import("../../../../surfaces/redux/userStateSlice.js").SurfaceUserStateSlice;
-    tools: import("../../../redux/tools/tools.slice.js").ToolsSliceState;
     conversations: import("../../../redux/execution-system/conversations/conversations.slice.js").ConversationsState;
     chatIncognito: import("../../../redux/chat/chat-incognito.slice.js").ChatIncognitoState;
     chatRoute: import("../../../redux/chat/chat-route.slice.js").ChatRouteState;
@@ -62,7 +61,6 @@ export declare function makeSelectConversationRequests(conversationId: string):
     agentAssistantMarkdownDraft: import("../../../redux/agent-assistant-markdown-draft.slice.js").AgentAssistantMarkdownDraftState;
     mcp: import("../../../redux/mcp/mcp.slice.js").McpSliceState;
     proposedDirectives: import("../../../redux/proposed-directives/proposedDirectivesSlice.js").ProposedDirectivesState;
-    agentSettings: import("../../../redux/agent-settings/types.js").AgentSettingsState;
     conversationAttachments: import("../../../connectors/attachments.slice.js").AttachmentsSliceState;
     chatHost: import("../../../../store/chat-host.slice.js").ChatHostState;
     hostConversations: import("../../../redux/execution-system/host-conversations/host-conversations.slice.js").HostConversationsState;

package/dist/agents/hooks/useDiffEnrichment.js

@@ -1,15 +1,12 @@
 "use client";
 import { useMemo } from "react";
 import { useAppSelector } from "../../store/hooks.js";
-import {
-  selectAllTools,
-  selectToolIdentityMap
-} from "../redux/tools/tools.selectors.js";
 import { selectMcpCatalog } from "../redux/mcp/mcp.slice.js";
 import { useModelRecords } from "../identity/model-catalog.js";
+import { selectAllTools, selectToolIdentityMap, useToolCatalog } from "../identity/tool-catalog.js";
 function useDiffEnrichment() {
-  const allTools = useAppSelector(selectAllTools);
-  const toolIdentities = useAppSelector(selectToolIdentityMap);
+  const allTools = useToolCatalog(selectAllTools);
+  const toolIdentities = useToolCatalog(selectToolIdentityMap);
   const mcpCatalog = useAppSelector(selectMcpCatalog);
   const modelEntities = useModelRecords((s) => s.entities);
   const modelIdentities = useModelRecords((s) => s.identityById);

package/dist/agents/identity/agent-catalog-lists.js

@@ -1,6 +1,7 @@
 "use client";
 import { useEffect, useMemo, useSyncExternalStore } from "react";
-import { getAgentCatalog } from "../../host/ui-slots.js";
+import { getChatHost } from "../../host/configure.js";
+const getAgentCatalog = () => getChatHost().catalog();
 import { ensureAgentCatalog } from "./agent-identity.js";
 const EMPTY_ROWS = [];
 const EMPTY_BY_ID = {};

package/dist/agents/identity/agent-identity.js

@@ -1,5 +1,6 @@
 "use client";
-import { getAgentCatalog } from "../../host/ui-slots.js";
+import { getChatHost } from "../../host/configure.js";
+const getAgentCatalog = () => getChatHost().catalog();
 import { useAppSelector } from "../../store/hooks.js";
 import { useEffect, useMemo, useSyncExternalStore } from "react";
 import { hasField } from "@ai-matrx/agents/field-flags";

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

@@ -35,3 +35,12 @@ export type ModelClassControls = undefined | {
     config: ModelClassConfig;
 };
 export declare function useModelClassControls(modelId: string | null | undefined, offeringId: string | null | undefined): ModelClassControls;
+/** The active model options; loads them once (idempotent, shared with every picker). */
+export declare function useModelOptions(): {
+    options: import("@ai-matrx/agents/models").ModelOption[];
+    isLoading: boolean;
+    error: string | null;
+    isReady: boolean;
+};
+/** One model's FULL record (controls included), or undefined until it has loaded. */
+export declare function useModelFull(modelId: string | null | undefined): ModelRecord | undefined;

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

@@ -4,8 +4,11 @@ import {
   classConfigKey,
   createModelCatalog,
   EMPTY_MODEL_RECORDS,
+  selectActiveModelsReady,
   selectModelById,
+  selectModelFullyLoaded,
   selectModelLabelById,
+  selectModelOptions,
   selectModelLabelWithClass
 } from "@ai-matrx/agents/models";
 import { useModelRecordsSelector } from "@ai-matrx/agents/models/react";
@@ -92,14 +95,36 @@ function useModelClassControls(modelId, offeringId) {
   if (status === "failed") return { failed: true };
   return { pending: true };
 }
+function useModelOptions() {
+  const options = useModelRecords(selectModelOptions);
+  const isLoading = useModelRecords((s) => s.isLoading);
+  const error = useModelRecords((s) => s.error);
+  const isReady = useModelRecords(selectActiveModelsReady);
+  useEffect(() => {
+    if (chatHostHasDatabase()) void getModelRecords().loadOptions();
+  }, []);
+  return { options, isLoading, error, isReady };
+}
+function useModelFull(modelId) {
+  const record = useModelRecords((s) => selectModelById(s, modelId));
+  const isFull = useModelRecords((s) => selectModelFullyLoaded(s, modelId));
+  useEffect(() => {
+    if (!chatHostHasDatabase()) return;
+    void getModelRecords().loadOptions();
+    if (modelId && !isFull) void getModelRecords().loadModel(modelId);
+  }, [modelId, isFull]);
+  return isFull ? record : void 0;
+}
 export {
   getModelCatalog,
   getModelRecords,
   readModelRecords,
   useModelClassControls,
   useModelClassLabels,
+  useModelFull,
   useModelLabel,
   useModelLabelWithClass,
+  useModelOptions,
   useModelRecord,
   useModelRecords
 };

package/dist/agents/identity/preferred-chat-model.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The person's preferred chat model (agent core B6 — chat resolves it itself; the
+ * `resolvePreferredChatModel` host slot is retired). `agents.model_prefs.chat_default_model` and
+ * its class companion, through the settings ladder (organization → user → device) of the host's
+ * knobs port. Null when nobody set one — the Holder's own model answers. A read failure is
+ * announced and answers null: a run never blocks on a preference.
+ */
+import { type PreferredModelChoice } from "@ai-matrx/agents/models";
+export declare function resolvePreferredChatModel(): Promise<PreferredModelChoice | null>;

package/dist/agents/identity/preferred-chat-model.js

@@ -0,0 +1,33 @@
+import {
+  CHAT_DEFAULT_MODEL_KNOB,
+  modelClassKnobFor,
+  modelClassPinOf,
+  resolvePreferredModelChoice
+} from "@ai-matrx/agents/models";
+import { supabase } from "../../host/db.js";
+import { ensureEffectiveKnob } from "../../host/prefs.js";
+import { getActiveOrgId } from "../../host/org.js";
+import { getUserId } from "../../host/identity.js";
+async function resolvePreferredChatModel() {
+  try {
+    return await resolvePreferredModelChoice(
+      {
+        client: () => supabase,
+        resolveKnob: (fullKey) => ensureEffectiveKnob(getActiveOrgId(), getUserId(), fullKey),
+        classKnobFor: modelClassKnobFor,
+        classPinOf: (value) => modelClassPinOf(value) ?? null
+      },
+      CHAT_DEFAULT_MODEL_KNOB,
+      "preferredChatModel"
+    );
+  } catch (error) {
+    console.error(
+      `[preferredChatModel] ${CHAT_DEFAULT_MODEL_KNOB} could not be resolved \u2014 the Holder's own model answers this run:`,
+      error
+    );
+    return null;
+  }
+}
+export {
+  resolvePreferredChatModel
+};

package/dist/agents/identity/settings-store.d.ts

@@ -0,0 +1,10 @@
+import { type NormalizedControls, type SettingsStore } from "@ai-matrx/agents/settings";
+export declare function getSettingsStore(): SettingsStore;
+/** One agent's settings entry from the page's store. */
+export declare function useAgentSettingsEntry(agentId: string | null | undefined): import("@ai-matrx/agents/settings").AgentSettingsEntry | undefined;
+/**
+ * Parsed controls for a settings entry's effective model: the pinned CLASS's controls when a pin
+ * is set and loaded (a model's classes run through different APIs), else the model's own. Null
+ * until the record (full, with controls) is loaded or when the agent has no entry.
+ */
+export declare function useNormalizedControls(agentId: string): NormalizedControls | null;