@ai-matrx/chat 0.3.24 → 0.3.25

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @ai-matrx/chat
 
+## 0.3.25 — 2026-10-07
+### The agent-list mirror is gone (agent core B2, phase C) — guard G3
+
+- REMOVED: `fetchAgentsList`, `fetchAgentsListFull`, `initializeChatAgents`, `searchAgentsServer`, `ensureAgentIdentity`, `overlayAgentFavoritesThunk`, `isChatListStale` (`agent-definition/list-mirror`), `agents/route/AgentListHydrator`, the list selectors (`selectLiveAgents`, `selectUserAgents`, `selectBuiltinAgents`, `selectSystemAgents`, `selectActiveAgents`, `selectFavoriteAgents`, `selectOwnedAgents`, `selectSharedWithMeAgents`, `selectEditableAgents`, `selectAgentsByCategory`, `selectAgentsSliceStatus`, `selectAgentsSliceError`, `selectAgentReadyForDisplay`, `selectAgentLineageIndex` / `selectAgentLineage`), `selectAgentName`, `selectAgentDescription`, `makeSelectAgentsForFilter`, `makeSelectAgentIdsForFilter`, and the record's `listOfferingPin`. `selectAllAgentsArray` is renamed `selectAgentRecordsArray` (the records chat holds — run tier, builder, versions — never the list). `AgentLineage` / `AgentLineageRef` now come from `agents/identity/agent-catalog-lists`.
+- `useAgentSummaryRow` binds the catalog store itself (no `@ai-matrx/agents/catalog/react` import), so a host test that mocks the picker module still renders names.
+- G3 `check:one-holder` (in `check:package`, self-tested): the list mirror is a hard ban, the run-tier / list RPCs are read only through the core stores, and chat's `modelRegistry` slice is a shrink-only baseline until B3.
+- Consumer action: use the `agents/identity/*` hooks (0.3.24 lists every replacement).
+
 ## 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)
 

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

@@ -1,3 +1,18 @@
+/**
+ * AGENT IDENTITY — where chat reads one agent's name, description and star (agent core B2).
+ *
+ * The ONE holder of the agent LIST is the core's agent catalog (`@ai-matrx/agents/catalog`); chat
+ * keeps no list mirror. One agent's identity is the agent's own record when it has READ the field
+ * (the run tier `agx_get_run_tier` and the builder's full read both carry `name` / `description`,
+ * and the builder's unsaved edit lives there), else the catalog row — so an agent the person only
+ * saw in a list still has a name, and an agent the list does not include (shared by link, another
+ * organization's app) still has one too.
+ *
+ *   useAgentName(id) / useAgentDescription(id) / useAgentIdentity(id)  — components
+ *   useAgentView(id)                     — the record, completed from the catalog row (derived, no copy)
+ *   readAgentName / readAgentDescription / readAgentView(state, id)   — thunks, callbacks
+ *   ensureAgentCatalog() / isAgentCatalogStale()                         — load the list
+ */
 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";
@@ -13,7 +28,10 @@ export interface AgentIdentity {
     /** The catalog row, when the list carries this agent. */
     summary: AgentSummary | undefined;
 }
-/** One agent's catalog row, loading the catalog when it is missing. */
+/**
+ * One agent's catalog row, loading the catalog (then a server search) when it is missing — chat's
+ * own binding of the store (the same contract as `@ai-matrx/agents/catalog/react` `useAgentSummary`).
+ */
 export declare function useAgentSummaryRow(agentId: string | null | undefined): AgentSummary | undefined;
 type MaybeRecord = AgentDefinitionRecord | undefined;
 /**

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

@@ -1,8 +1,7 @@
 "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 { useEffect, useMemo, useSyncExternalStore } 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";
@@ -38,8 +37,27 @@ function isAgentCatalogStale() {
     return false;
   }
 }
+const noopSubscribe = () => () => void 0;
 function useAgentSummaryRow(agentId) {
-  return useAgentSummary(useCatalog(), agentId);
+  const catalog = useCatalog();
+  const row = useSyncExternalStore(
+    catalog ? catalog.subscribe : noopSubscribe,
+    () => catalog && agentId ? catalog.getState().byId[agentId] : void 0,
+    () => catalog && agentId ? catalog.getState().byId[agentId] : void 0
+  );
+  const present = row !== void 0;
+  useEffect(() => {
+    if (!catalog || !agentId || present) return;
+    let cancelled = false;
+    void catalog.ensureLoaded().then(() => {
+      if (cancelled || catalog.getState().byId[agentId]) return;
+      return catalog.searchServer(agentId).then(() => void 0);
+    }).catch(() => void 0);
+    return () => {
+      cancelled = true;
+    };
+  }, [catalog, agentId, present]);
+  return row;
 }
 function loaded(record, field) {
   return !!record?._loadedFields && hasField(record._loadedFields, field);
@@ -79,8 +97,7 @@ function agentViewOf(record, summary) {
     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 }
+    sharedByEmail: base.sharedByEmail ?? summary.sharedByEmail
   };
 }
 function useAgentView(agentId) {

package/dist/agents/redux/agent-definition/converters.js

@@ -258,7 +258,7 @@ function dbRowToAgentDefinition(row) {
     changedAt: null,
     changeNote: null,
     // Access metadata not available from a direct row fetch —
-    // populated separately by fetchAgentsList or fetchAgentAccessLevel
+    // populated separately by fetchAgentAccessLevel (the list lives in the catalog)
     isOwner: null,
     accessLevel: null,
     sharedByEmail: null,