@ai-matrx/chat 0.3.23 → 0.3.24

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @ai-matrx/chat
 
+## 0.3.24 — 2026-10-07
+### Agent identity and lists read the ONE agent catalog; the run tier reads the core store (agent core B2, phase A)
+
+- New `agents/identity/agent-identity`: `useAgentView` / `readAgentView` / `agentViewOf` (the record completed from the catalog row — derived, no copy), `useAgentName`, `useAgentDescription`, `useAgentIdentity`, `useAgentSummaryRow` (the record when it has read the field — run tier, builder edit — else the catalog row), `readAgentName` / `readAgentDescription` (non-reactive), `ensureAgentCatalog`, `isAgentCatalogStale`.
+- New `agents/identity/agent-catalog-lists`: `useCatalogAgents`, `useAgentsById`, `useBuiltinAgents`, `useActiveAgents`, `useOwnedAgents`, `useSharedWithMeAgents`, `useAgentLineageIndex`, `useAgentCatalogStatus` / `useAgentCatalogError` / `useAgentCatalogLoad`, `readCatalogAgents` / `readBuiltinAgents` / `readOwnedAgents`, `buildAgentLineageIndex` — the catalog-backed replacements for the `agentDefinition` list selectors.
+- New `agents/redux/agent-filter/useAgentIdsForFilter` + pure `filterAgentsForFilter`.
+- `agents/identity/run-tier-store`: `getRunTierStore()` binds `@ai-matrx/agents/runtime` `createRunTierStore`; `fetchAgentRunTier`, `fetchAgentRunControls`, `fetchAgentAccessLevel` read through it (same errors: `agentNotReadableError`, `ConnectTimeoutError`, pg errors). `fetchSharedAgents` / `fetchSharedAgentsForChat` are gone (no caller; `getRunTierStore().loadSharedWithMe()` / `.loadSharedForChat()`). `AgentRunTier` / `AgentRunCounts` are the core's row types, narrowed.
+- Every chat surface that showed an agent's name reads the catalog first (run header, run window, run controls, composer, runner page, mobile name, picker sheet, history buckets, output-contract errors); the picker sheet no longer refuses an agent the run record has not loaded.
+- DEPRECATED, removed in the next release: `fetchAgentsList`, `fetchAgentsListFull`, `initializeChatAgents`, `searchAgentsServer`, `ensureAgentIdentity`, `overlayAgentFavoritesThunk`, `isChatListStale` (now `agents/redux/agent-definition/list-mirror`), `AgentListHydrator`, the list selectors (`selectAllAgentsArray`, `selectLiveAgents`, `selectBuiltinAgents`, `selectActiveAgents`, `selectOwnedAgents`, `selectSharedWithMeAgents`, `selectAgentLineageIndex`, `selectAgentsSliceStatus`, `selectAgentsSliceError`, …), `selectAgentName`, `selectAgentDescription`, `makeSelectAgentsForFilter` / `makeSelectAgentIdsForFilter`.
+- Consumer action: repoint to the hooks above (requires `@ai-matrx/agents` ≥ 0.51.0).
+
 ## 0.3.23 — 2026-10-07
 ### The working document reaches the agent again
 

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

@@ -54,7 +54,6 @@ import {
 } from "../../redux/execution-system/messages/messages.selectors.js";
 import { selectConversationTitle } from "../../redux/execution-system/conversations/conversations.selectors.js";
 import { selectIsStreaming } from "../../redux/execution-system/selectors/aggregate.selectors.js";
-import { selectAgentName } from "../../redux/agent-definition/selectors.js";
 import { selectCurrentSettings } from "../../redux/execution-system/instance-model-overrides/instance-model-overrides.selectors.js";
 import { selectInstanceResources } from "../../redux/execution-system/instance-resources/instance-resources.selectors.js";
 import { selectResolvedVariables } from "../../redux/execution-system/instance-variable-values/instance-variable-values.selectors.js";
@@ -63,6 +62,7 @@ import {
   selectAttachedScratchpadIds,
   selectWorkingDocEntry
 } from "../../redux/execution-system/instance-working-document/instance-working-document.selectors.js";
+import { readAgentName } from "../../identity/agent-identity.js";
 function promptForkOutcomeLazily(args) {
   void import("../messages-display/message-options/promptForkOutcome.js").then(({ promptForkOutcome }) => promptForkOutcome(args));
 }
@@ -161,7 +161,7 @@ function ChatConversationSurface({
     } : null;
     const conversationStatus = state.conversations?.byConversationId?.[conversationId]?.status ?? null;
     const isStreamingNow2 = selectIsStreaming(conversationId)(state);
-    const agentName = selectAgentName(state, agentId) ?? null;
+    const agentName = readAgentName(state, agentId) ?? null;
     const conversationTitle = selectConversationTitle(conversationId)(state);
     const conversation = transcript ? buildChatConversationRecord({
       id: conversationId,

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

@@ -1,8 +1,7 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useRouter } from "../../../host/navigation.js";
-import { useAppSelector, useAppStore } from "../../../store/hooks.js";
-import { selectAgentName } from "../../redux/agent-definition/selectors.js";
+import { useAppStore } from "../../../store/hooks.js";
 import { AgentListDropdown } from "@ai-matrx/agents/catalog/react";
 import { ActiveContextLensChip } from "../../../context/sources/scopes.js";
 import { ComposerModeSwitch } from "../inputs/smart-input/composer/ComposerModeSwitch.js";
@@ -15,6 +14,7 @@ import {
   stageChatAgentSwitch
 } from "./begin-fresh-chat.js";
 import { RouteHeader } from "../../../host/chrome.js";
+import { useAgentName } from "../../identity/agent-identity.js";
 const defaultAgentHref = (agentId) => `/chat/a/${encodeURIComponent(agentId)}`;
 function ChatRunHeader({
   activeAgentId,
@@ -25,9 +25,7 @@ function ChatRunHeader({
 }) {
   const router = useRouter();
   const store = useAppStore();
-  const liveName = useAppSelector(
-    (state) => activeAgentId ? selectAgentName(state, activeAgentId) : void 0
-  );
+  const liveName = useAgentName(activeAgentId);
   const label = liveName?.trim() || initialAgentName?.trim() || "Select an agent";
   const handleAgentSelect = (id) => {
     if (id === activeAgentId) return;

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

@@ -10,10 +10,10 @@ import {
   useAgentConsumer
 } from "@ai-matrx/agents/catalog/react";
 import { makeSelectFilteredAgents } from "@ai-matrx/agents/catalog";
-import { initializeChatAgents } from "../../redux/agent-definition/thunks.js";
 import { useAppStore } from "../../../store/hooks.js";
 import { stageChatAgentSwitch } from "./begin-fresh-chat.js";
 import { Button, DisclosureHeader } from "@ai-matrx/design-system/controls";
+import { ensureAgentCatalog } from "../../identity/agent-identity.js";
 const CONSUMER_ID = "chat-sidebar-pinned";
 const PINNED_COLLAPSED_LIMIT = 5;
 const selectPinnedAgents = makeSelectFilteredAgents();
@@ -28,7 +28,7 @@ function PinnedAgentsSection({
   const store = useAppStore();
   const consumer = useAgentConsumer(CONSUMER_ID);
   useEffect(() => {
-    dispatch(initializeChatAgents());
+    void ensureAgentCatalog();
   }, [dispatch]);
   useEffect(() => {
     if (consumer.favFilter !== "yes") consumer.setFavFilter("yes");

package/dist/agents/components/context-preview/ContextCompareView.js

@@ -1,6 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { useEffect, useState } from "react";
+import { useState } from "react";
 import { DiffViewer } from "@ai-matrx/diff/react";
 import { AlertTriangle, ChevronDown, GitCompareArrows, MessageSquareText, RefreshCw } from "lucide-react";
 import { AgentListDropdown } from "@ai-matrx/agents/catalog/react";
@@ -12,9 +12,7 @@ import { Tabs, TabsContent, TabsList, TabsTrigger } from "../../../ui/tabs.js";
 import { CopyButtons } from "../../../host/ui-slots.js";
 import { RichContent } from "../../../host/ui-slots.js";
 import { SystemItemsLine } from "./SystemItemsLine.js";
-import { useAppDispatch, useAppSelector } from "../../../store/hooks.js";
-import { selectAllAgents } from "../../redux/agent-definition/selectors.js";
-import { fetchAgentsList } from "../../redux/agent-definition/thunks.js";
+import { useAppDispatch } from "../../../store/hooks.js";
 import { callApi } from "../../../host/server/call-api.js";
 import { resolveRunWait } from "../../../host/server/run-wait.js";
 import { peekSelectedOrganizationId } from "../../../host/server/organization-admission.js";
@@ -26,6 +24,7 @@ import { AGENT_ICON } from "@ai-matrx/icons/domain";
 import { formatCount } from "@ai-matrx/kit/format";
 import { getUserId } from "../../../host/identity.js";
 import { humanizeIdentifier } from "@ai-matrx/kit/text-case";
+import { useAgentName } from "../../identity/agent-identity.js";
 const CLASS_LOOK = {
   defect: {
     label: "Defect",
@@ -409,12 +408,7 @@ function AnswerAgentPicker({
   agentId,
   onAgentChange
 }) {
-  const dispatch = useAppDispatch();
-  const agents = useAppSelector(selectAllAgents);
-  useEffect(() => {
-    void dispatch(fetchAgentsList());
-  }, [dispatch]);
-  const chosenName = agentId ? agents?.[agentId]?.name ?? null : null;
+  const chosenName = useAgentName(agentId) ?? null;
   return /* @__PURE__ */ jsx("div", { "data-answer-agent": agentId ?? "", children: /* @__PURE__ */ jsx(
     AgentListDropdown,
     {
@@ -441,8 +435,7 @@ function AnswerBoth({
   const [running, setRunning] = useState(false);
   const [error, setError] = useState(null);
   const [result, setResult] = useState(null);
-  const agents = useAppSelector(selectAllAgents);
-  const agentName = agentId ? agents?.[agentId]?.name ?? null : null;
+  const agentName = useAgentName(agentId) ?? null;
   usePageCaptureContribution(
     "context-compare:answer-both",
     () => [

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

@@ -6,8 +6,7 @@ import { useAppDispatch, useAppSelector } from "../../../../../store/hooks.js";
 import { useMandate } from "../../../../../mandates/useMandate.js";
 import { selectAgentIdFromInstance } from "../../../../redux/execution-system/conversations/conversations.selectors.js";
 import {
-  selectAgentModelId,
-  selectAgentName
+  selectAgentModelId
 } from "../../../../redux/agent-definition/selectors.js";
 import { selectInstanceOverrideState } from "../../../../redux/execution-system/instance-model-overrides/instance-model-overrides.selectors.js";
 import {
@@ -17,7 +16,7 @@ import {
 import { useModelOptions } from "../../../../../host/ui-slots.js";
 import { useModelClassLabels } from "../../../../../host/model-class.js";
 import { useEffectiveClassPin } from "../../../../redux/execution-system/instance-model-overrides/useEffectiveClassPin.js";
-import { initializeChatAgents } from "../../../../redux/agent-definition/thunks.js";
+import { ensureAgentCatalog, useAgentName } from "../../../../identity/agent-identity.js";
 const CHAT_AGENT_TAG = "chat-agent";
 function isPresetRow(row) {
   return !row.isArchived && row.isActive !== false && row.tags.includes(CHAT_AGENT_TAG);
@@ -41,10 +40,10 @@ function useComposerAgent(conversationId) {
   const dispatch = useAppDispatch();
   useModelOptions();
   useEffect(() => {
-    dispatch(initializeChatAgents());
+    void ensureAgentCatalog();
   }, [dispatch]);
   const agentId = useAppSelector(selectAgentIdFromInstance(conversationId)) ?? null;
-  const agentName = useAppSelector((state) => agentId ? selectAgentName(state, agentId) : void 0) ?? null;
+  const agentName = useAgentName(agentId) ?? null;
   const effectiveModelId = useEffectiveModelId(conversationId);
   useModelClassLabels();
   const classPins = useEffectiveClassPin(conversationId);

package/dist/agents/components/run/AgentRunnerPage.js

@@ -6,8 +6,7 @@ import { useSearchParams } from "../../../host/navigation.js";
 import { useAppDispatch, useAppSelector, useAppStore } from "../../../store/hooks.js";
 import { fetchAgentExecutionMinimal } from "../../redux/agent-definition/thunks.js";
 import {
-  selectAgentExecutionPayload,
-  selectAgentName
+  selectAgentExecutionPayload
 } from "../../redux/agent-definition/selectors.js";
 import { selectAuthReady } from "../../../host/identity.js";
 import { useAgentLauncher } from "../../hooks/useAgentLauncher.js";
@@ -42,6 +41,7 @@ import { selectInstanceVariableDefinitions } from "../../redux/execution-system/
 import { useAgentRunSurfaceScope } from "../../hooks/useAgentRunSurfaceScope.js";
 import { createAgentRunVariableValuesHandler } from "./agent-run-variable-write.js";
 import { ErrorAlchemyMenu } from "../../../host/ui-slots.js";
+import { useAgentName } from "../../identity/agent-identity.js";
 const RUN_INITIAL_MESSAGE_LIMIT = 12;
 function AgentRunnerPage({
   agentId,
@@ -128,7 +128,7 @@ function AgentRunnerPage({
     conversationId: conversationIdFromUrl ?? conversationId ?? void 0,
     sourceFeature
   });
-  const agentName = useAppSelector((state) => selectAgentName(state, agentId));
+  const agentName = useAgentName(agentId);
   const authReady = useAppSelector(selectAuthReady);
   const lastSyncedUrl = useRef(null);
   useEffect(() => {

package/dist/agents/hooks/useAgentModelLabel.js

@@ -9,14 +9,18 @@ import {
   selectModelLabelWithClass
 } from "../model-registry/modelRegistrySlice.js";
 import { useModelClassLabels } from "../../host/model-class.js";
+import { useAgentSummaryRow } from "../identity/agent-identity.js";
 function useAgentModelLabel(agentId) {
   useModelClassLabels();
-  const modelId = useAppSelector(
+  const summary = useAgentSummaryRow(agentId);
+  const ownModelId = useAppSelector(
     (state) => agentId ? selectAgentModelId(state, agentId) : null
   );
-  const offeringId = useAppSelector(
+  const ownOfferingId = useAppSelector(
     (state) => agentId ? selectAgentOfferingPin(state, agentId) : void 0
   );
+  const modelId = ownModelId ?? summary?.modelId ?? null;
+  const offeringId = ownOfferingId !== void 0 ? ownOfferingId : summary?.offeringId;
   const label = useAppSelector(
     (state) => offeringId === void 0 ? selectModelLabelById(state, modelId) : selectModelLabelWithClass(state, modelId, offeringId)
   );

package/dist/agents/hooks/useAgentRunSurfaceScope.js

@@ -4,9 +4,7 @@ import { createAgentRunScope } from "../../surfaces/manifests/agent-run.manifest
 import { extractAgentSystemInstruction } from "../utils/agent-system-instruction.js";
 import {
   selectAgentDefinition,
-  selectAgentDescription,
   selectAgentModelId,
-  selectAgentName,
   selectAgentSystemMessage,
   selectAgentTools,
   selectAgentVariableDefinitions,
@@ -31,6 +29,7 @@ import {
   selectLatestError,
   selectLatestToolLifecycles
 } from "../redux/execution-system/selectors/aggregate.selectors.js";
+import { readAgentDescription, readAgentName } from "../identity/agent-identity.js";
 function useAgentRunSurfaceScope({
   agentId,
   conversationId,
@@ -42,8 +41,8 @@ function useAgentRunSurfaceScope({
     const definition = selectAgentDefinition(state, agentId);
     const agentScope = {
       agent_id: agentId,
-      agent_name: selectAgentName(state, agentId) ?? void 0,
-      agent_description: selectAgentDescription(state, agentId) ?? void 0,
+      agent_name: readAgentName(state, agentId) ?? void 0,
+      agent_description: readAgentDescription(state, agentId) ?? void 0,
       agent_version: selectAgentVersion(state, agentId) ?? void 0,
       agent_system_instruction: extractAgentSystemInstruction(
         selectAgentSystemMessage(state, agentId)

package/dist/agents/identity/agent-catalog-lists.d.ts

@@ -0,0 +1,45 @@
+import type { AgentCatalogState, AgentSummary } from "@ai-matrx/agents/catalog";
+/** Every agent the person can see (owned, shared, organization, system). */
+export declare function useCatalogAgents(): AgentSummary[];
+export declare function useAgentsById(): Record<string, AgentSummary>;
+export declare const isBuiltinAgent: (a: AgentSummary) => boolean;
+export declare const isActiveAgent: (a: AgentSummary) => boolean;
+export declare const isOwnedAgent: (a: AgentSummary) => boolean;
+export declare const isSharedWithMeAgent: (a: AgentSummary) => boolean;
+export declare function useBuiltinAgents(): AgentSummary[];
+export declare function useActiveAgents(): AgentSummary[];
+export declare function useOwnedAgents(): AgentSummary[];
+export declare function useSharedWithMeAgents(): AgentSummary[];
+export interface AgentCatalogLoad {
+    status: AgentCatalogState["status"];
+    error: string | null;
+    loading: boolean;
+    reload: () => Promise<void>;
+}
+/** The catalog's load state, plus a forced reload for retry buttons. */
+export declare function useAgentCatalogLoad(): AgentCatalogLoad;
+/** The catalog's load status (`idle` | `loading` | `succeeded` | `failed`) — was `selectAgentsSliceStatus`. */
+export declare function useAgentCatalogStatus(): AgentCatalogState["status"];
+/** The catalog's last load error — was `selectAgentsSliceError`. */
+export declare function useAgentCatalogError(): string | null;
+export declare function readCatalogAgents(): AgentSummary[];
+export declare function readBuiltinAgents(): AgentSummary[];
+export declare function readOwnedAgents(): AgentSummary[];
+export interface AgentLineageRef {
+    id: string;
+    name: string;
+    agentType: string | null;
+    isSystem: boolean;
+}
+export interface AgentLineage {
+    /** The agent this one was copied FROM, when visible. */
+    parent: AgentLineageRef | null;
+    /** Agents copied FROM this one. */
+    children: AgentLineageRef[];
+    /** The system (builtin) agent in this agent's immediate lineage — always rendered WITH a door. */
+    systemTwin: AgentLineageRef | null;
+}
+export declare const EMPTY_LINEAGE: AgentLineage;
+/** agentId → lineage for every agent in the catalog, built once per catalog change. */
+export declare function buildAgentLineageIndex(agents: readonly AgentSummary[]): Record<string, AgentLineage>;
+export declare function useAgentLineageIndex(): Record<string, AgentLineage>;

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

@@ -0,0 +1,128 @@
+"use client";
+import { useEffect, useMemo, useSyncExternalStore } from "react";
+import { getAgentCatalog } from "../../host/ui-slots.js";
+import { ensureAgentCatalog } from "./agent-identity.js";
+const EMPTY_ROWS = [];
+const EMPTY_BY_ID = {};
+const noopSubscribe = () => () => void 0;
+function catalogOrNull() {
+  try {
+    return getAgentCatalog();
+  } catch {
+    return null;
+  }
+}
+function useCatalogSelector(select, fallback) {
+  const catalog = catalogOrNull();
+  const value = useSyncExternalStore(
+    catalog ? catalog.subscribe : noopSubscribe,
+    () => catalog ? select(catalog.getState()) : fallback,
+    () => catalog ? select(catalog.getState()) : fallback
+  );
+  useEffect(() => {
+    void ensureAgentCatalog();
+  }, []);
+  return value;
+}
+function useCatalogAgents() {
+  return useCatalogSelector((s) => s.rows, EMPTY_ROWS);
+}
+function useAgentsById() {
+  return useCatalogSelector((s) => s.byId, EMPTY_BY_ID);
+}
+const isBuiltinAgent = (a) => a.agentType === "builtin";
+const isActiveAgent = (a) => a.isActive && !a.isArchived;
+const isOwnedAgent = (a) => a.isOwner === true;
+const isSharedWithMeAgent = (a) => a.isOwner === false && a.accessLevel != null;
+function useFiltered(pred) {
+  const rows = useCatalogAgents();
+  return useMemo(() => rows.filter(pred), [rows, pred]);
+}
+function useBuiltinAgents() {
+  return useFiltered(isBuiltinAgent);
+}
+function useActiveAgents() {
+  return useFiltered(isActiveAgent);
+}
+function useOwnedAgents() {
+  return useFiltered(isOwnedAgent);
+}
+function useSharedWithMeAgents() {
+  return useFiltered(isSharedWithMeAgent);
+}
+function useAgentCatalogLoad() {
+  const status = useCatalogSelector((s) => s.status, "idle");
+  const error = useCatalogSelector((s) => s.error, null);
+  return {
+    status,
+    error,
+    loading: status === "loading",
+    reload: () => ensureAgentCatalog({ force: true })
+  };
+}
+function useAgentCatalogStatus() {
+  return useCatalogSelector((s) => s.status, "idle");
+}
+function useAgentCatalogError() {
+  return useCatalogSelector((s) => s.error, null);
+}
+function readCatalogAgents() {
+  return catalogOrNull()?.getState().rows ?? EMPTY_ROWS;
+}
+function readBuiltinAgents() {
+  return readCatalogAgents().filter(isBuiltinAgent);
+}
+function readOwnedAgents() {
+  return readCatalogAgents().filter(isOwnedAgent);
+}
+const EMPTY_LINEAGE = { parent: null, children: [], systemTwin: null };
+function toLineageRef(a) {
+  return { id: a.id, name: a.name ?? a.id, agentType: a.agentType ?? null, isSystem: a.agentType === "builtin" };
+}
+function buildAgentLineageIndex(agents) {
+  const byId = new Map(agents.map((a) => [a.id, a]));
+  const childrenByParent = /* @__PURE__ */ new Map();
+  for (const a of agents) {
+    if (!a.sourceAgentId) continue;
+    const bucket = childrenByParent.get(a.sourceAgentId);
+    if (bucket) bucket.push(a);
+    else childrenByParent.set(a.sourceAgentId, [a]);
+  }
+  const index = {};
+  for (const a of agents) {
+    const parentRow = a.sourceAgentId ? byId.get(a.sourceAgentId) ?? null : null;
+    const parent = parentRow ? toLineageRef(parentRow) : null;
+    const children = (childrenByParent.get(a.id) ?? []).map(toLineageRef);
+    index[a.id] = {
+      parent,
+      children,
+      systemTwin: parent?.isSystem === true ? parent : children.find((c) => c.isSystem) ?? null
+    };
+  }
+  return index;
+}
+function useAgentLineageIndex() {
+  const rows = useCatalogAgents();
+  return useMemo(() => buildAgentLineageIndex(rows), [rows]);
+}
+export {
+  EMPTY_LINEAGE,
+  buildAgentLineageIndex,
+  isActiveAgent,
+  isBuiltinAgent,
+  isOwnedAgent,
+  isSharedWithMeAgent,
+  readBuiltinAgents,
+  readCatalogAgents,
+  readOwnedAgents,
+  useActiveAgents,
+  useAgentCatalogError,
+  useAgentCatalogLoad,
+  useAgentCatalogStatus,
+  useAgentLineageIndex,
+  useAgentsById,
+  useBuiltinAgents,
+  useCatalogAgents,
+  useOwnedAgents,
+  useSharedWithMeAgents
+};

package/dist/agents/identity/agent-identity.d.ts

@@ -0,0 +1,34 @@
+import type { AgentSummary } from "@ai-matrx/agents/catalog";
+import type { ChatRootState } from "../../store/root-state.js";
+import type { AgentDefinitionRecord } from "../types/agent-definition.types.js";
+/** Load the agent catalog (its own TTL + in-flight dedupe make this safe on every mount). */
+export declare function ensureAgentCatalog(options?: {
+    force?: boolean;
+}): Promise<void>;
+/** True when the catalog's last load is older than the tab-restore threshold. */
+export declare function isAgentCatalogStale(): boolean;
+export interface AgentIdentity {
+    name: string | undefined;
+    description: string | null;
+    /** The catalog row, when the list carries this agent. */
+    summary: AgentSummary | undefined;
+}
+/** One agent's catalog row, loading the catalog when it is missing. */
+export declare function useAgentSummaryRow(agentId: string | null | undefined): AgentSummary | undefined;
+type MaybeRecord = AgentDefinitionRecord | undefined;
+/**
+ * The agent's record completed from its catalog row: every field the record has READ wins; the
+ * list fields it has not read (name, description, category, tags, star, access, lineage, dates)
+ * come from the catalog. Derived on read — the catalog stays the one holder of list data.
+ */
+export declare function agentViewOf(record: MaybeRecord, summary: AgentSummary | undefined): MaybeRecord;
+/** One agent as surfaces show it: its record completed from the catalog row (see `agentViewOf`). */
+export declare function useAgentView(agentId: string | null | undefined): MaybeRecord;
+export declare function readAgentView(state: ChatRootState, agentId: string | null | undefined): MaybeRecord;
+export declare function useAgentName(agentId: string | null | undefined): string | undefined;
+export declare function useAgentDescription(agentId: string | null | undefined): string | null;
+export declare function useAgentIdentity(agentId: string | null | undefined): AgentIdentity;
+/** Non-reactive: the record's read name, else the catalog row. */
+export declare function readAgentName(state: ChatRootState, agentId: string | null | undefined): string | undefined;
+export declare function readAgentDescription(state: ChatRootState, agentId: string | null | undefined): string | null;
+export {};

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

@@ -0,0 +1,127 @@
+"use client";
+import { useAgentSummary } from "@ai-matrx/agents/catalog/react";
+import { getAgentCatalog } from "../../host/ui-slots.js";
+import { useAppSelector } from "../../store/hooks.js";
+import { useMemo } from "react";
+import { hasField } from "@ai-matrx/agents/field-flags";
+import { selectAgentById } from "../redux/agent-definition/selectors.js";
+import { makeEmptyRecord } from "../redux/agent-definition/slice.js";
+function recordOf(state, agentId) {
+  return agentId ? selectAgentById(state, agentId) : void 0;
+}
+function catalogRow(agentId) {
+  if (!agentId) return void 0;
+  try {
+    return getAgentCatalog().getAgent(agentId);
+  } catch {
+    return void 0;
+  }
+}
+function useCatalog() {
+  try {
+    return getAgentCatalog();
+  } catch {
+    return null;
+  }
+}
+function ensureAgentCatalog(options) {
+  try {
+    return getAgentCatalog().ensureLoaded(options).catch(() => void 0);
+  } catch {
+    return Promise.resolve();
+  }
+}
+function isAgentCatalogStale() {
+  try {
+    return getAgentCatalog().isStale();
+  } catch {
+    return false;
+  }
+}
+function useAgentSummaryRow(agentId) {
+  return useAgentSummary(useCatalog(), agentId);
+}
+function loaded(record, field) {
+  return !!record?._loadedFields && hasField(record._loadedFields, field);
+}
+function nameOf(record, summary) {
+  return loaded(record, "name") && record?.name || summary?.name || record?.name || void 0;
+}
+function descriptionOf(record, summary) {
+  if (loaded(record, "description")) return record?.description ?? null;
+  return summary?.description ?? record?.description ?? null;
+}
+const ACCESS_LEVELS = ["owner", "admin", "editor", "viewer", "system"];
+function toRecordAccessLevel(value) {
+  return ACCESS_LEVELS.find((l) => l === value) ?? null;
+}
+function agentViewOf(record, summary) {
+  if (!summary) return record;
+  const base = record ?? makeEmptyRecord(summary.id);
+  const pick = (field, fromSummary) => loaded(record, field) ? base[field] : fromSummary;
+  return {
+    ...base,
+    name: nameOf(record, summary) ?? "",
+    description: descriptionOf(record, summary),
+    category: pick("category", summary.category),
+    tags: pick("tags", summary.tags),
+    agentType: pick("agentType", summary.agentType),
+    modelId: pick("modelId", summary.modelId),
+    isActive: pick("isActive", summary.isActive),
+    isArchived: pick("isArchived", summary.isArchived),
+    // The star is per-person state the catalog owns (its ONE write).
+    isFavorite: summary.isFavorite,
+    createdBy: pick("createdBy", summary.createdBy),
+    organizationId: pick("organizationId", summary.organizationId),
+    taskId: pick("taskId", summary.taskId),
+    sourceAgentId: pick("sourceAgentId", summary.sourceAgentId),
+    createdAt: pick("createdAt", summary.createdAt ?? ""),
+    updatedAt: pick("updatedAt", summary.updatedAt ?? ""),
+    isOwner: base.isOwner ?? summary.isOwner,
+    accessLevel: base.accessLevel ?? toRecordAccessLevel(summary.accessLevel),
+    sharedByEmail: base.sharedByEmail ?? summary.sharedByEmail,
+    ...summary.offeringId === void 0 ? {} : { listOfferingPin: summary.offeringId }
+  };
+}
+function useAgentView(agentId) {
+  const summary = useAgentSummaryRow(agentId);
+  const record = useAppSelector((s) => recordOf(s, agentId));
+  return useMemo(() => agentViewOf(record, summary), [record, summary]);
+}
+function readAgentView(state, agentId) {
+  return agentViewOf(recordOf(state, agentId), catalogRow(agentId));
+}
+function useAgentName(agentId) {
+  const row = useAgentSummaryRow(agentId);
+  const record = useAppSelector((s) => recordOf(s, agentId));
+  return nameOf(record, row);
+}
+function useAgentDescription(agentId) {
+  const row = useAgentSummaryRow(agentId);
+  const record = useAppSelector((s) => recordOf(s, agentId));
+  return descriptionOf(record, row);
+}
+function useAgentIdentity(agentId) {
+  const summary = useAgentSummaryRow(agentId);
+  const record = useAppSelector((s) => recordOf(s, agentId));
+  return { name: nameOf(record, summary), description: descriptionOf(record, summary), summary };
+}
+function readAgentName(state, agentId) {
+  return nameOf(recordOf(state, agentId), catalogRow(agentId));
+}
+function readAgentDescription(state, agentId) {
+  return descriptionOf(recordOf(state, agentId), catalogRow(agentId));
+}
+export {
+  agentViewOf,
+  ensureAgentCatalog,
+  isAgentCatalogStale,
+  readAgentDescription,
+  readAgentName,
+  readAgentView,
+  useAgentDescription,
+  useAgentIdentity,
+  useAgentName,
+  useAgentSummaryRow,
+  useAgentView
+};

package/dist/agents/identity/run-tier-store.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Chat's binding of the core RUN TIER store (agent core B2). `agx_get_run_tier`,
+ * `agx_get_run_controls`, `agx_get_access_level` and the shared lists are read ONLY through
+ * `createRunTierStore` (`@ai-matrx/agents/runtime`); chat's run thunks ask this store and project
+ * the answer onto the agent's record for the execution selectors.
+ *
+ * One store per page, held on `globalThis` (dual-loader graphs split module state).
+ */
+import { type RunTierStore } from "@ai-matrx/agents/runtime";
+/**
+ * The run tier store over the host's database client. Chat's thunks always read fresh
+ * (`force`) — the agent record's fetch status is chat's cache — so the store is the ONE
+ * reader (dedupe, timeout, retry, refusal) and the holder of the last answer.
+ */
+export declare function getRunTierStore(): RunTierStore;

package/dist/agents/identity/run-tier-store.js

@@ -0,0 +1,23 @@
+import { createRunTierStore } from "@ai-matrx/agents/runtime";
+import { supabase } from "../../host/db.js";
+import { runWithSessionRetry } from "../../host/session-retry.js";
+const KEY = /* @__PURE__ */ Symbol.for("ai-matrx.chat.run-tier-stores");
+function getRunTierStore() {
+  const db = supabase;
+  const g = globalThis;
+  const stores = g[KEY] ??= /* @__PURE__ */ new WeakMap();
+  const existing = stores.get(db);
+  if (existing) return existing;
+  const client = {
+    // The access level read is the one that runs at sign-in boundaries (the builder opens
+    // straight from a link), so it rides the session retry; the run tier and run controls
+    // refuse a signed-out visitor before they read (isSignedOutVisitor in the thunks).
+    rpc: (fn, args) => fn === "agx_get_access_level" ? runWithSessionRetry(() => Promise.resolve(db.rpc(fn, args))) : db.rpc(fn, args)
+  };
+  const store = createRunTierStore({ client });
+  stores.set(db, store);
+  return store;
+}
+export {
+  getRunTierStore
+};