@ai-matrx/chat 0.3.23 → 0.3.24

package/dist/agents/redux/agent-definition/list-mirror.d.ts

@@ -0,0 +1,139 @@
+/**
+ * DEPRECATED — the agent-list MIRROR (agent core B2). Removed in the next chat
+ * release: readers move to `agents/identity/agent-identity.ts` and
+ * `agents/identity/agent-catalog-lists.ts`, which read the ONE catalog store.
+ * Kept one release so hosts can repoint before the exports disappear.
+ */
+import type { ChatDispatch, ChatRootState } from "../../../store/root-state.js";
+/** Thunk form of `overlayAgentFavorites`, for surfaces that seed rows themselves. */
+export declare const overlayAgentFavoritesThunk: import("@reduxjs/toolkit").AsyncThunk<void, readonly string[], {
+    extra?: unknown;
+    rejectValue?: unknown;
+    serializedErrorType?: unknown;
+    pendingMeta?: unknown;
+    fulfilledMeta?: unknown;
+    rejectedMeta?: unknown;
+    dispatch: ChatDispatch;
+    state: ChatRootState;
+}>;
+/**
+ * Hydrates this registry from the ONE agent catalog. The gallery, the agent
+ * pages, and every name-resolving surface read `agentDefinition`; the catalog
+ * reads the database. This is the seam between them.
+ *
+ * The catalog's own freshness window and in-flight dedupe make this safe to
+ * dispatch on every mount — no thunk-level TTL guard is needed or wanted.
+ */
+export declare const fetchAgentsList: import("@reduxjs/toolkit").AsyncThunk<void, void, {
+    extra?: unknown;
+    rejectValue?: unknown;
+    serializedErrorType?: unknown;
+    pendingMeta?: unknown;
+    fulfilledMeta?: unknown;
+    rejectedMeta?: unknown;
+    dispatch: ChatDispatch;
+    state: ChatRootState;
+}>;
+/**
+ * Server-side agent search — the canonical path for finding an agent.
+ *
+ * WHY THIS EXISTS: the list is paginated. Filtering only what the client has
+ * already loaded silently reports "no results" for agents that were simply
+ * never fetched. Any paginated collection therefore needs a server search.
+ *
+ * ADDITIVE BY CONTRACT: results go through `mergeAgentListRows`, the same
+ * merge the list fetch uses. Rows are ADDED to the store and existing records
+ * are enriched, never replaced or evicted. Local matches keep rendering
+ * instantly while this resolves, then server-only matches fold in beneath
+ * them — nothing the user is already looking at disappears.
+ *
+ * Two tiers:
+ *   deep = false (default) — name, description, category, tags, model, id
+ *   deep = true            — the above PLUS the agent's own prompt content
+ *
+ * Tier 2 is a strict superset and prompt hits always score below every tier-1
+ * field, so enabling it can only append below the obvious matches.
+ *
+ * Returns the matched ids in server rank order so a caller can preserve
+ * server relevance ordering if it wants to.
+ */
+export declare const searchAgentsServer: import("@reduxjs/toolkit").AsyncThunk<{
+    ids: string[];
+    deep: boolean;
+    query: string;
+}, {
+    query: string;
+    deep?: boolean;
+    limit?: number;
+}, {
+    extra?: unknown;
+    rejectValue?: unknown;
+    serializedErrorType?: unknown;
+    pendingMeta?: unknown;
+    fulfilledMeta?: unknown;
+    rejectedMeta?: unknown;
+    dispatch: ChatDispatch;
+    state: ChatRootState;
+}>;
+/**
+ * The picker-era name for the same hydration. Kept because ~20 surfaces
+ * dispatch it by name; it is `fetchAgentsList` with no status writes, because
+ * a picker's own loading state comes from the package now.
+ */
+export declare const fetchAgentsListFull: import("@reduxjs/toolkit").AsyncThunk<void, void, {
+    extra?: unknown;
+    rejectValue?: unknown;
+    serializedErrorType?: unknown;
+    pendingMeta?: unknown;
+    fulfilledMeta?: unknown;
+    rejectedMeta?: unknown;
+    dispatch: ChatDispatch;
+    state: ChatRootState;
+}>;
+/**
+ * Makes sure ONE agent's identity (name, description, …) is in this registry.
+ *
+ * Neither execution fetch (`agx_get_execution_minimal` / `_full`) carries the
+ * name, so an agent that no list fetch had loaded launched with a nameless
+ * record: every window titled it "Agent" and the empty hero lost its name.
+ * The name comes from the same place every name comes from — the ONE catalog —
+ * projected through `mergeAgentSummaries`. No-op when the name is present.
+ */
+export declare const ensureAgentIdentity: import("@reduxjs/toolkit").AsyncThunk<void, string, {
+    extra?: unknown;
+    rejectValue?: unknown;
+    serializedErrorType?: unknown;
+    pendingMeta?: unknown;
+    fulfilledMeta?: unknown;
+    rejectedMeta?: unknown;
+    dispatch: ChatDispatch;
+    state: ChatRootState;
+}>;
+/**
+ * THE FRESHNESS IS THE PACKAGE'S. `isChatListFresh` and its module-level
+ * timestamp are gone: the catalog owns the 15-minute TTL and the 4-hour
+ * tab-restore threshold, so there is exactly one answer to "is the list
+ * stale" on this platform.
+ */
+export declare function isChatListStale(): boolean;
+/**
+ * Initializes the agent catalogue for the chat sidebar and hydrates this
+ * registry from it. Safe to call on every mount — the catalog's own TTL and
+ * shared in-flight promise collapse concurrent mounts to one read.
+ *
+ * Usage:
+ *   dispatch(initializeChatAgents())                 // skip if fresh
+ *   dispatch(initializeChatAgents({ force: true }))  // always re-read
+ */
+export declare const initializeChatAgents: import("@reduxjs/toolkit").AsyncThunk<void, void | {
+    force?: boolean;
+}, {
+    extra?: unknown;
+    rejectValue?: unknown;
+    serializedErrorType?: unknown;
+    pendingMeta?: unknown;
+    fulfilledMeta?: unknown;
+    rejectedMeta?: unknown;
+    dispatch: ChatDispatch;
+    state: ChatRootState;
+}>;

package/dist/agents/redux/agent-definition/list-mirror.js

@@ -0,0 +1,157 @@
+import { createAsyncThunk } from "@reduxjs/toolkit";
+import { getAgentCatalog } from "../../../host/ui-slots.js";
+import { readFavoriteIds } from "../../../context/sources/scopes.js";
+import {
+  mergePartialAgent,
+  setAgentFetchStatus,
+  setAgentsStatus,
+  setAgentsError
+} from "./slice.js";
+const REGISTRY_ACCESS_LEVELS = [
+  "owner",
+  "admin",
+  "editor",
+  "viewer",
+  "system"
+];
+function toRegistryAccessLevel(value) {
+  return REGISTRY_ACCESS_LEVELS.find(
+    (level) => level === value
+  ) ?? null;
+}
+function mergeAgentSummaries(dispatch, rows) {
+  for (const row of rows) {
+    dispatch(
+      mergePartialAgent({
+        id: row.id,
+        name: row.name ?? void 0,
+        description: row.description,
+        category: row.category,
+        tags: row.tags,
+        agentType: row.agentType,
+        modelId: row.modelId,
+        isActive: row.isActive,
+        isArchived: row.isArchived,
+        // No `isFavorite`: the catalog row's column is retired — stars are
+        // overlaid from platform.user_entity_state by `overlayAgentFavorites`.
+        // The registry spells "absent" as `undefined` where the DB row spells
+        // it `null`. Five fields differ; this is the vocabulary translation
+        // at the seam, not a value change.
+        createdBy: row.createdBy ?? void 0,
+        organizationId: row.organizationId ?? void 0,
+        taskId: row.taskId,
+        sourceAgentId: row.sourceAgentId,
+        createdAt: row.createdAt ?? void 0,
+        updatedAt: row.updatedAt ?? void 0,
+        isVersion: false,
+        isOwner: row.isOwner,
+        // `access_level` is a DB-owned vocabulary the package deliberately
+        // leaves open (an unknown level renders as itself). This registry's
+        // field is a closed union, so an unrecognised level is stored as
+        // `null` — absent, never silently coerced into a wrong level.
+        accessLevel: toRegistryAccessLevel(row.accessLevel),
+        sharedByEmail: row.sharedByEmail ?? void 0,
+        // The class pin; a catalog read that lacks the column leaves it absent.
+        ...row.offeringId === void 0 ? {} : { listOfferingPin: row.offeringId }
+      })
+    );
+    dispatch(setAgentFetchStatus({ id: row.id, status: "list" }));
+  }
+}
+async function overlayAgentFavorites(dispatch, ids) {
+  if (ids.length === 0) return;
+  const favorites = await readFavoriteIds("agent", ids);
+  if (!favorites) return;
+  for (const id of ids) {
+    dispatch(mergePartialAgent({ id, isFavorite: favorites.has(id) }));
+  }
+}
+const overlayAgentFavoritesThunk = createAsyncThunk("agentDefinition/overlayFavorites", async (ids, { dispatch }) => {
+  await overlayAgentFavorites(dispatch, ids);
+});
+const fetchAgentsList = createAsyncThunk(
+  "agentDefinition/fetchList",
+  async (_, { dispatch }) => {
+    dispatch(setAgentsStatus("loading"));
+    dispatch(setAgentsError(null));
+    const catalog = getAgentCatalog();
+    try {
+      await catalog.ensureLoaded();
+    } catch (e) {
+      dispatch(setAgentsError(e instanceof Error ? e.message : String(e)));
+      dispatch(setAgentsStatus("failed"));
+      throw e;
+    }
+    const rows = catalog.getState().rows;
+    mergeAgentSummaries(dispatch, rows);
+    await overlayAgentFavorites(
+      dispatch,
+      rows.map((r) => r.id)
+    );
+    dispatch(setAgentsStatus("succeeded"));
+  }
+);
+const searchAgentsServer = createAsyncThunk(
+  "agentDefinition/searchServer",
+  async ({ query, deep = false }, { dispatch }) => {
+    const q = query.trim();
+    if (!q) return { ids: [], deep, query: q };
+    const catalog = getAgentCatalog();
+    const ids = await catalog.searchServer(q, deep);
+    const state = catalog.getState();
+    const hits = ids.map((id) => state.byId[id]).filter((r) => !!r);
+    mergeAgentSummaries(dispatch, hits);
+    await overlayAgentFavorites(
+      dispatch,
+      hits.map((r) => r.id)
+    );
+    return { ids, deep, query: q };
+  }
+);
+const fetchAgentsListFull = createAsyncThunk(
+  "agentDefinition/fetchListFull",
+  async (_, { dispatch }) => {
+    const catalog = getAgentCatalog();
+    await catalog.ensureLoaded();
+    const rows = catalog.getState().rows;
+    mergeAgentSummaries(dispatch, rows);
+    await overlayAgentFavorites(
+      dispatch,
+      rows.map((r) => r.id)
+    );
+  }
+);
+const ensureAgentIdentity = createAsyncThunk(
+  "agentDefinition/ensureIdentity",
+  async (agentId, { dispatch, getState }) => {
+    if (getState().agentDefinition.agents?.[agentId]?.name) return;
+    const catalog = getAgentCatalog();
+    let row = catalog.getState().byId[agentId];
+    if (!row) {
+      await catalog.ensureLoaded();
+      row = catalog.getState().byId[agentId];
+    }
+    if (row) {
+      mergeAgentSummaries(dispatch, [row]);
+      await overlayAgentFavorites(dispatch, [row.id]);
+    }
+  }
+);
+function isChatListStale() {
+  return getAgentCatalog().isStale();
+}
+const initializeChatAgents = createAsyncThunk("agentDefinition/initializeChatAgents", async (arg, { dispatch }) => {
+  const force = arg?.force ?? false;
+  const catalog = getAgentCatalog();
+  await catalog.ensureLoaded(force ? { force: true } : void 0);
+  mergeAgentSummaries(dispatch, catalog.getState().rows);
+});
+export {
+  ensureAgentIdentity,
+  fetchAgentsList,
+  fetchAgentsListFull,
+  initializeChatAgents,
+  isChatListStale,
+  overlayAgentFavoritesThunk,
+  searchAgentsServer
+};

package/dist/agents/redux/agent-definition/selectors.d.ts

@@ -3007,7 +3007,7 @@ export declare const selectAgentRunTier: ((state: {
         youtube_videos?: boolean | undefined;
     };
     toolIds: string[];
-    counts: import("../../types/agent-definition.types.js").AgentRunCounts | null;
+    counts: import("@ai-matrx/agents/runtime").AgentRunCounts | null;
 }) & {
     clearCache: () => void;
     resultsCount: () => number;
@@ -3037,7 +3037,7 @@ export declare const selectAgentRunTier: ((state: {
             youtube_videos?: boolean | undefined;
         };
         toolIds: string[];
-        counts: import("../../types/agent-definition.types.js").AgentRunCounts | null;
+        counts: import("@ai-matrx/agents/runtime").AgentRunCounts | null;
     };
     memoizedResultFunc: ((resultFuncArgs_0: AgentDefinitionRecord | undefined) => {
         isReady: false;
@@ -3063,7 +3063,7 @@ export declare const selectAgentRunTier: ((state: {
             youtube_videos?: boolean | undefined;
         };
         toolIds: string[];
-        counts: import("../../types/agent-definition.types.js").AgentRunCounts | null;
+        counts: import("@ai-matrx/agents/runtime").AgentRunCounts | null;
     }) & {
         clearCache: () => void;
         resultsCount: () => number;
@@ -3093,7 +3093,7 @@ export declare const selectAgentRunTier: ((state: {
             youtube_videos?: boolean | undefined;
         };
         toolIds: string[];
-        counts: import("../../types/agent-definition.types.js").AgentRunCounts | null;
+        counts: import("@ai-matrx/agents/runtime").AgentRunCounts | null;
     };
     dependencies: [((state: {
         voiceAgent: import("../../../voice-agent/types.js").VoiceAgentState;
@@ -13990,7 +13990,7 @@ export declare const selectAgentFieldOriginalValue: ((state: {
     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, _id: string, field: keyof AgentDefinition) => string | number | boolean | import("../../types/agent-definition.types.js").AgentRunControls | import("../../types/agent-definition.types.js").AgentRunCounts | string[] | import("../../types/agent-definition.types.js").AgentDefinitionDataIssue[] | import("../../types/agent-message-types.js").AgentDefinitionMessage[] | import("../../types/agent-api-types.js").ContextPolicy[] | import("../../types/agent-definition.types.js").VariableDefinition[] | {
+} & import("../../../store/root-state.js").ChatHostReadSlices, _id: string, field: keyof AgentDefinition) => string | number | boolean | import("../../types/agent-definition.types.js").AgentRunControls | import("@ai-matrx/agents/runtime").AgentRunCounts | string[] | import("../../types/agent-definition.types.js").AgentDefinitionDataIssue[] | import("../../types/agent-message-types.js").AgentDefinitionMessage[] | import("../../types/agent-api-types.js").ContextPolicy[] | import("../../types/agent-definition.types.js").VariableDefinition[] | {
     name: string;
     description?: string;
     input_schema?: import("@ai-matrx/agents/generated/api-types").components["schemas"]["CustomToolInputSchema"];
@@ -14251,7 +14251,7 @@ export declare const selectAgentFieldOriginalValue: ((state: {
     resultsCount: () => number;
     resetResultsCount: () => void;
 } & {
-    resultFunc: (resultFuncArgs_0: AgentDefinitionRecord | undefined, resultFuncArgs_1: keyof AgentDefinition) => string | number | boolean | import("../../types/agent-definition.types.js").AgentRunControls | import("../../types/agent-definition.types.js").AgentRunCounts | string[] | import("../../types/agent-definition.types.js").AgentDefinitionDataIssue[] | import("../../types/agent-message-types.js").AgentDefinitionMessage[] | import("../../types/agent-api-types.js").ContextPolicy[] | import("../../types/agent-definition.types.js").VariableDefinition[] | {
+    resultFunc: (resultFuncArgs_0: AgentDefinitionRecord | undefined, resultFuncArgs_1: keyof AgentDefinition) => string | number | boolean | import("../../types/agent-definition.types.js").AgentRunControls | import("@ai-matrx/agents/runtime").AgentRunCounts | string[] | import("../../types/agent-definition.types.js").AgentDefinitionDataIssue[] | import("../../types/agent-message-types.js").AgentDefinitionMessage[] | import("../../types/agent-api-types.js").ContextPolicy[] | import("../../types/agent-definition.types.js").VariableDefinition[] | {
         name: string;
         description?: string;
         input_schema?: import("@ai-matrx/agents/generated/api-types").components["schemas"]["CustomToolInputSchema"];
@@ -14508,7 +14508,7 @@ export declare const selectAgentFieldOriginalValue: ((state: {
         file_urls?: boolean | undefined;
         youtube_videos?: boolean | undefined;
     } | undefined;
-    memoizedResultFunc: ((resultFuncArgs_0: AgentDefinitionRecord | undefined, resultFuncArgs_1: keyof AgentDefinition) => string | number | boolean | import("../../types/agent-definition.types.js").AgentRunControls | import("../../types/agent-definition.types.js").AgentRunCounts | string[] | import("../../types/agent-definition.types.js").AgentDefinitionDataIssue[] | import("../../types/agent-message-types.js").AgentDefinitionMessage[] | import("../../types/agent-api-types.js").ContextPolicy[] | import("../../types/agent-definition.types.js").VariableDefinition[] | {
+    memoizedResultFunc: ((resultFuncArgs_0: AgentDefinitionRecord | undefined, resultFuncArgs_1: keyof AgentDefinition) => string | number | boolean | import("../../types/agent-definition.types.js").AgentRunControls | import("@ai-matrx/agents/runtime").AgentRunCounts | string[] | import("../../types/agent-definition.types.js").AgentDefinitionDataIssue[] | import("../../types/agent-message-types.js").AgentDefinitionMessage[] | import("../../types/agent-api-types.js").ContextPolicy[] | import("../../types/agent-definition.types.js").VariableDefinition[] | {
         name: string;
         description?: string;
         input_schema?: import("@ai-matrx/agents/generated/api-types").components["schemas"]["CustomToolInputSchema"];
@@ -14769,7 +14769,7 @@ export declare const selectAgentFieldOriginalValue: ((state: {
         resultsCount: () => number;
         resetResultsCount: () => void;
     };
-    lastResult: () => string | number | boolean | import("../../types/agent-definition.types.js").AgentRunControls | import("../../types/agent-definition.types.js").AgentRunCounts | string[] | import("../../types/agent-definition.types.js").AgentDefinitionDataIssue[] | import("../../types/agent-message-types.js").AgentDefinitionMessage[] | import("../../types/agent-api-types.js").ContextPolicy[] | import("../../types/agent-definition.types.js").VariableDefinition[] | {
+    lastResult: () => string | number | boolean | import("../../types/agent-definition.types.js").AgentRunControls | import("@ai-matrx/agents/runtime").AgentRunCounts | string[] | import("../../types/agent-definition.types.js").AgentDefinitionDataIssue[] | import("../../types/agent-message-types.js").AgentDefinitionMessage[] | import("../../types/agent-api-types.js").ContextPolicy[] | import("../../types/agent-definition.types.js").VariableDefinition[] | {
         name: string;
         description?: string;
         input_schema?: import("@ai-matrx/agents/generated/api-types").components["schemas"]["CustomToolInputSchema"];

package/dist/agents/redux/agent-definition/slice.d.ts

@@ -1,5 +1,6 @@
 import { type PayloadAction } from "@reduxjs/toolkit";
 import type { AgentDefinition, AgentDefinitionRecord, AgentDefinitionSliceState, AgentFetchStatus, LoadedFields } from "../../types/agent-definition.types.js";
+export declare function makeEmptyRecord(id: string): AgentDefinitionRecord;
 /**
  * Marks a record as clean. Clears dirty state, field history, and undo stacks.
  * _loadedFields is NOT cleared — fetched state is cumulative.

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

@@ -339,6 +339,7 @@ var slice_default = agentDefinitionSlice.reducer;
 export {
   agentDefinitionSlice,
   slice_default as default,
+  makeEmptyRecord,
   markAgentFieldsLoaded,
   markAgentRecordClean,
   mergePartialAgent,

package/dist/agents/redux/agent-definition/thunks.d.ts

@@ -1,20 +1,13 @@
 /**
  * Agent Definition — Redux Thunks
  *
- * 🚨 THE LIST IS THE PACKAGE'S (2026-09-08). `@ai-matrx/agents/catalog` owns
- * every agent-list read on this platform — `agx_get_list_full`, `agx_search`,
- * the freshness window, the in-flight dedupe. The four list thunks below are
- * THIN HYDRATORS: they ask the ONE catalog and project its `AgentSummary`
- * rows into this registry as `_fetchStatus: "list"` records, so the ~50
- * non-picker surfaces that read names / the builtin catalogue / gallery rows
- * from `agentDefinition` keep working unchanged. No RPC is issued here, and
- * adding one back is a defect (guard: `pnpm check:agent-list-reads`).
+ * 🚨 THE LIST IS THE CORE'S, AND ONLY THE CORE'S (agent core B2, 2026-10-07).
+ * Chat keeps NO agent-list mirror: every list, name and description reads the
+ * `@ai-matrx/agents/catalog` store (`agents/identity/agent-identity.ts`). The
+ * run tier, run controls, access level and shared lists are read through the
+ * core `createRunTierStore` (`agents/identity/run-tier-store.ts`).
  *
  * Read thunks:
- *   fetchAgentsList              — hydrate the registry from the catalog
- *   fetchAgentsListFull          — same; kept as the picker-era name
- *   fetchSharedAgents            — agents shared with me (for "shared" tab)
- *   fetchSharedAgentsForChat     — minimal shared list for chat agent picker
  *   fetchAgentAccessLevel        — current user's permission level on an agent
  *   fetchAgentRunTier            — TIER 2: what a run needs, never the definition (skips if ready)
  *   fetchAgentExecutionMinimal   — the run tier under its pre-P24 name (app callers)
@@ -39,6 +32,7 @@
  * old agx_check_drift / agx_check_references / agx_accept_version RPCs were
  * replaced by agx_usage_scan / agx_usage_report / agx_usage_update_to_active.
  */
+import { type AgentAccessLevelRow } from "@ai-matrx/agents/runtime";
 import type { ChatDispatch, ChatRootState } from "../../../store/root-state.js";
 import type { Database } from "../../../host/db-types.js";
 import { type AIModelRecord } from "../../model-registry/modelRegistrySlice.js";
@@ -59,110 +53,6 @@ export declare function isAvailableToolModel(model: AIModelRecord | undefined):
 export declare function applyAgentToolDelta(currentTools: readonly string[], addToolIds: readonly string[], removeToolIds: readonly string[]): string[];
 export declare function sameStringArray(a: readonly string[], b: readonly string[]): boolean;
 export declare function isToolAssignmentPhantom(current: AgentToolAssignmentRow, base: AgentToolAssignmentRow): boolean;
-/** Thunk form of `overlayAgentFavorites`, for surfaces that seed rows themselves. */
-export declare const overlayAgentFavoritesThunk: import("@reduxjs/toolkit").AsyncThunk<void, readonly string[], {
-    extra?: unknown;
-    rejectValue?: unknown;
-    serializedErrorType?: unknown;
-    pendingMeta?: unknown;
-    fulfilledMeta?: unknown;
-    rejectedMeta?: unknown;
-    dispatch: ChatDispatch;
-    state: ChatRootState;
-}>;
-/**
- * Hydrates this registry from the ONE agent catalog. The gallery, the agent
- * pages, and every name-resolving surface read `agentDefinition`; the catalog
- * reads the database. This is the seam between them.
- *
- * The catalog's own freshness window and in-flight dedupe make this safe to
- * dispatch on every mount — no thunk-level TTL guard is needed or wanted.
- */
-export declare const fetchAgentsList: import("@reduxjs/toolkit").AsyncThunk<void, void, {
-    extra?: unknown;
-    rejectValue?: unknown;
-    serializedErrorType?: unknown;
-    pendingMeta?: unknown;
-    fulfilledMeta?: unknown;
-    rejectedMeta?: unknown;
-    dispatch: ChatDispatch;
-    state: ChatRootState;
-}>;
-/**
- * Server-side agent search — the canonical path for finding an agent.
- *
- * WHY THIS EXISTS: the list is paginated. Filtering only what the client has
- * already loaded silently reports "no results" for agents that were simply
- * never fetched. Any paginated collection therefore needs a server search.
- *
- * ADDITIVE BY CONTRACT: results go through `mergeAgentListRows`, the same
- * merge the list fetch uses. Rows are ADDED to the store and existing records
- * are enriched, never replaced or evicted. Local matches keep rendering
- * instantly while this resolves, then server-only matches fold in beneath
- * them — nothing the user is already looking at disappears.
- *
- * Two tiers:
- *   deep = false (default) — name, description, category, tags, model, id
- *   deep = true            — the above PLUS the agent's own prompt content
- *
- * Tier 2 is a strict superset and prompt hits always score below every tier-1
- * field, so enabling it can only append below the obvious matches.
- *
- * Returns the matched ids in server rank order so a caller can preserve
- * server relevance ordering if it wants to.
- */
-export declare const searchAgentsServer: import("@reduxjs/toolkit").AsyncThunk<{
-    ids: string[];
-    deep: boolean;
-    query: string;
-}, {
-    query: string;
-    deep?: boolean;
-    limit?: number;
-}, {
-    extra?: unknown;
-    rejectValue?: unknown;
-    serializedErrorType?: unknown;
-    pendingMeta?: unknown;
-    fulfilledMeta?: unknown;
-    rejectedMeta?: unknown;
-    dispatch: ChatDispatch;
-    state: ChatRootState;
-}>;
-/**
- * The picker-era name for the same hydration. Kept because ~20 surfaces
- * dispatch it by name; it is `fetchAgentsList` with no status writes, because
- * a picker's own loading state comes from the package now.
- */
-export declare const fetchAgentsListFull: import("@reduxjs/toolkit").AsyncThunk<void, void, {
-    extra?: unknown;
-    rejectValue?: unknown;
-    serializedErrorType?: unknown;
-    pendingMeta?: unknown;
-    fulfilledMeta?: unknown;
-    rejectedMeta?: unknown;
-    dispatch: ChatDispatch;
-    state: ChatRootState;
-}>;
-/**
- * Makes sure ONE agent's identity (name, description, …) is in this registry.
- *
- * Neither execution fetch (`agx_get_execution_minimal` / `_full`) carries the
- * name, so an agent that no list fetch had loaded launched with a nameless
- * record: every window titled it "Agent" and the empty hero lost its name.
- * The name comes from the same place every name comes from — the ONE catalog —
- * projected through `mergeAgentSummaries`. No-op when the name is present.
- */
-export declare const ensureAgentIdentity: import("@reduxjs/toolkit").AsyncThunk<void, string, {
-    extra?: unknown;
-    rejectValue?: unknown;
-    serializedErrorType?: unknown;
-    pendingMeta?: unknown;
-    fulfilledMeta?: unknown;
-    rejectedMeta?: unknown;
-    dispatch: ChatDispatch;
-    state: ChatRootState;
-}>;
 /**
  * TIER 2 — THE RUN TIER (PACKAGE-INDEPENDENCE §3, P24). Everything a run needs
  * and nothing it does not: variables, context rules, the kill switch, the
@@ -227,66 +117,8 @@ export declare const fetchAgentRunControls: import("@reduxjs/toolkit").AsyncThun
     dispatch: ChatDispatch;
     state: ChatRootState;
 }>;
-export interface SharedAgentItem {
-    id: string;
-    name: string;
-    description: string | null;
-    agent_type: "user" | "builtin";
-    category: string | null;
-    tags: string[];
-    owner_id: string | null;
-    owner_email: string | null;
-    permission_level: string;
-    created_at: string;
-    updated_at: string;
-}
-export interface SharedAgentForChat {
-    id: string;
-    name: string;
-    permission_level: string;
-    owner_email: string | null;
-}
-/**
- * Fetches all agents shared with the current user (not owned by them).
- *
- * @deprecated agx_get_list() now returns both owned and shared agents in one
- * call with full access metadata. Prefer fetchAgentsList() instead.
- * This thunk is kept for cases where only the shared subset is needed
- * (e.g. a targeted refresh of the "Shared with me" tab without re-fetching owned agents).
- */
-export declare const fetchSharedAgents: import("@reduxjs/toolkit").AsyncThunk<SharedAgentItem[], void, {
-    extra?: unknown;
-    rejectValue?: unknown;
-    serializedErrorType?: unknown;
-    pendingMeta?: unknown;
-    fulfilledMeta?: unknown;
-    rejectedMeta?: unknown;
-    dispatch: ChatDispatch;
-    state: ChatRootState;
-}>;
-/**
- * Fetches the minimal shared agent list for the chat agent picker.
- * Returns the raw list — lightweight, not stored in slice
- * (the picker only needs name + id, no need to hydrate execution fields).
- */
-export declare const fetchSharedAgentsForChat: import("@reduxjs/toolkit").AsyncThunk<SharedAgentForChat[], void, {
-    extra?: unknown;
-    rejectValue?: unknown;
-    serializedErrorType?: unknown;
-    pendingMeta?: unknown;
-    fulfilledMeta?: unknown;
-    rejectedMeta?: unknown;
-    dispatch: ChatDispatch;
-    state: ChatRootState;
-}>;
-export interface AgentAccessLevel {
-    agent_id: string;
-    agent_name: string;
-    owner_id: string;
-    owner_email: string;
-    access_level: "owner" | "admin" | "editor" | "viewer" | "public" | "none";
-    is_owner: boolean;
-}
+export type { SharedAgentItem, SharedAgentForChat } from "@ai-matrx/agents/runtime";
+export type AgentAccessLevel = AgentAccessLevelRow;
 /**
  * Returns the current user's permission level on a specific agent.
  * Also merges the result into the slice so selectors stay consistent.
@@ -294,35 +126,7 @@ export interface AgentAccessLevel {
  * Use when opening the agent builder, or when the record arrived via a
  * shortcut/execution RPC (which don't include access metadata).
  */
-export declare const fetchAgentAccessLevel: import("@reduxjs/toolkit").AsyncThunk<AgentAccessLevel, string, {
-    extra?: unknown;
-    rejectValue?: unknown;
-    serializedErrorType?: unknown;
-    pendingMeta?: unknown;
-    fulfilledMeta?: unknown;
-    rejectedMeta?: unknown;
-    dispatch: ChatDispatch;
-    state: ChatRootState;
-}>;
-/**
- * THE FRESHNESS IS THE PACKAGE'S. `isChatListFresh` and its module-level
- * timestamp are gone: the catalog owns the 15-minute TTL and the 4-hour
- * tab-restore threshold, so there is exactly one answer to "is the list
- * stale" on this platform.
- */
-export declare function isChatListStale(): boolean;
-/**
- * Initializes the agent catalogue for the chat sidebar and hydrates this
- * registry from it. Safe to call on every mount — the catalog's own TTL and
- * shared in-flight promise collapse concurrent mounts to one read.
- *
- * Usage:
- *   dispatch(initializeChatAgents())                 // skip if fresh
- *   dispatch(initializeChatAgents({ force: true }))  // always re-read
- */
-export declare const initializeChatAgents: import("@reduxjs/toolkit").AsyncThunk<void, void | {
-    force?: boolean;
-}, {
+export declare const fetchAgentAccessLevel: import("@reduxjs/toolkit").AsyncThunk<AgentAccessLevelRow, string, {
     extra?: unknown;
     rejectValue?: unknown;
     serializedErrorType?: unknown;
@@ -332,3 +136,4 @@ export declare const initializeChatAgents: import("@reduxjs/toolkit").AsyncThunk
     dispatch: ChatDispatch;
     state: ChatRootState;
 }>;
+export { overlayAgentFavoritesThunk, fetchAgentsList, searchAgentsServer, fetchAgentsListFull, ensureAgentIdentity, isChatListStale, initializeChatAgents, } from "./list-mirror.js";