@ai-matrx/agents 0.15.1 → 0.16.19

package/dist/catalog/index.d.cts

@@ -1,17 +1,21 @@
-import { A as AgentSummary, a as AgentCatalogClient, b as AgentCatalogTransport, c as AgentCatalogStorageLike, d as AgentCatalogErrorSink, R as ResolvedDefaultRow, e as AgentCatalogStorage, M as MandateResolutionVerdict, f as AgentArchFilter, g as AgentTab, h as AgentCatalogLabels, i as AgentConsumerState, j as AgentSortOption } from '../orchestra-BDXdut6Y.cjs';
-export { k as AGENT_NONE_SENTINEL, l as ARCHIVE_FILTER_OPTIONS, m as ARCHIVE_FILTER_ORDER, n as AgentAccessFilter, o as AgentAccessLevel, p as AgentArchFilterOption, q as AgentCatalog, r as AgentCatalogAgentType, s as AgentCatalogAsyncStorage, t as AgentCatalogConfig, u as AgentCatalogConfigError, v as AgentCatalogDefaults, w as AgentCatalogIdentity, x as AgentCatalogNavigate, y as AgentCatalogNotifier, z as AgentCatalogOpenPeek, B as AgentCatalogResolveHref, C as AgentCatalogRpcCall, D as AgentCatalogSchemaReport, E as AgentCatalogState, F as AgentCatalogStatus, G as AgentCatalogTableQuery, H as AgentConsumerPatch, I as AgentFavFilter, J as AgentId, K as AssertAgentCatalogSchemaOptions, L as DEFAULT_AGENT_CATALOG_LABELS, N as DEFAULT_AGENT_CONSUMER_STATE, O as DefaultRowState, P as OrchestraBadge, Q as PgErrorLike, S as PgResultLike, T as SORT_OPTIONS, U as asAgentId, V as assertAgentCatalogSchema, W as createAgentCatalog, X as getRegisteredAgentCatalog, Y as isAgentArchFilter, Z as isMandateAgentId, _ as mandateAgentId, $ as nextArchFilter, a0 as orchestraDelegatesLine, a1 as orchestraDepthLine, a2 as orchestraLabel, a3 as orchestraModeLabel } from '../orchestra-BDXdut6Y.cjs';
+import { A as AgentSummary, a as AgentCatalogClient, b as AgentCatalogFavorites, c as AgentCatalogTransport, d as AgentCatalogStorageLike, e as AgentCatalogErrorSink, R as ResolvedDefaultRow, f as AgentCatalogStorage, M as MandateResolutionVerdict, g as AgentArchFilter, h as AgentTab, i as AgentCatalogLabels, j as AgentConsumerState, k as AgentSortOption } from '../orchestra-PbGGooqJ.cjs';
+export { l as AGENT_NONE_SENTINEL, m as ARCHIVE_FILTER_OPTIONS, n as ARCHIVE_FILTER_ORDER, o as AgentAccessFilter, p as AgentAccessLevel, q as AgentArchFilterOption, r as AgentCatalog, s as AgentCatalogAgentType, t as AgentCatalogAsyncStorage, u as AgentCatalogConfig, v as AgentCatalogConfigError, w as AgentCatalogDefaults, x as AgentCatalogIdentity, y as AgentCatalogNavigate, z as AgentCatalogNotifier, B as AgentCatalogOpenPeek, C as AgentCatalogResolveHref, D as AgentCatalogRpcCall, E as AgentCatalogSchemaReport, F as AgentCatalogState, G as AgentCatalogStatus, H as AgentConsumerPatch, I as AgentFavFilter, J as AgentId, K as AssertAgentCatalogSchemaOptions, L as DEFAULT_AGENT_CATALOG_LABELS, N as DEFAULT_AGENT_CONSUMER_STATE, O as DefaultRowState, P as OrchestraBadge, Q as PgErrorLike, S as PgResultLike, T as SORT_OPTIONS, U as asAgentId, V as assertAgentCatalogSchema, W as createAgentCatalog, X as getRegisteredAgentCatalog, Y as isAgentArchFilter, Z as isMandateAgentId, _ as mandateAgentId, $ as nextArchFilter, a0 as orchestraDelegatesLine, a1 as orchestraDepthLine, a2 as orchestraLabel, a3 as orchestraModeLabel } from '../orchestra-PbGGooqJ.cjs';
 
 /**
  * catalog/data.ts — @ai-matrx/agents/catalog
  *
- * Every database call the catalog makes, and nothing else. Four of them:
+ * Every database call the catalog makes, and nothing else. Five of them:
  *
  *   1. `agx_get_list_full()` — the complete catalogue (owned + directly-shared
  *      + org-shared user agents, unioned with active builtins).
  *   2. `agx_search(p_query, p_deep, p_limit, p_offset)` — tier-2 server search.
  *   3. `agx_resolve_agent_address(p_ids)` — the single-agent name read, used
  *      when a mandate's Holder is not in the caller's own catalogue.
- *   4. ONE write: `agent.definition.is_favorite`.
+ *   4. The caller's stars: `ues_get_bulk('agent', ids)` through the
+ *      favorites port (`platform.user_entity_state`), overlaid on every row
+ *      set this module returns to the store.
+ *   5. ONE write: the caller's star, `ues_set` through the same port. The
+ *      retired `agent.definition.is_favorite` column is never read or written.
  *
  * 🚨 THE LIST READ IS COMPLETE OR IT THROWS. PostgREST caps every response at
  * `db-max-rows` (1000 on Matrx Main) and reports success — matrx-frontend's
@@ -68,10 +72,11 @@ declare function searchAgentsOnServer(client: AgentCatalogClient, args: {
  */
 declare function readSingleAgentRow(client: AgentCatalogClient, agentId: string): Promise<AgentSummary | null>;
 /**
- * THE ONE WRITE. Mirrors matrx-frontend's `saveAgentField` for this field
- * exactly: `agent.definition.is_favorite`, addressed by id.
+ * THE ONE WRITE: the caller's star on one agent, in
+ * `platform.user_entity_state` through the favorites port. Throws an
+ * `AgentCatalogReadError` carrying the refusal in words.
  */
-declare function writeAgentFavorite(client: AgentCatalogClient, agentId: string, isFavorite: boolean): Promise<void>;
+declare function writeAgentFavorite(favorites: AgentCatalogFavorites, agentId: string, isFavorite: boolean): Promise<void>;
 
 /**
  * catalog/rows.ts — @ai-matrx/agents/catalog
@@ -174,8 +179,14 @@ interface ResolveDefaultRowArgs {
     client: AgentCatalogClient;
     storage: AgentCatalogStorageLike;
     errorSink: AgentCatalogErrorSink;
-    /** Look the Holder up in the rows this catalog already holds. */
-    lookupRow: (agentId: string) => AgentSummary | undefined;
+    /**
+     * Look the Holder up in the rows this catalog already holds. May answer
+     * asynchronously: the store waits for an in-flight list read before
+     * declaring a miss, so a default row never costs a second network read just
+     * because the verdict outran the list (the list read now also overlays the
+     * caller's stars).
+     */
+    lookupRow: (agentId: string) => AgentSummary | undefined | Promise<AgentSummary | undefined>;
 }
 interface ResolveDefaultRowOutcome {
     resolved: ResolvedDefaultRow;
@@ -491,4 +502,4 @@ declare const selectTotalFavoriteAgentsCount: (a: readonly AgentSummary[]) => nu
 /** @internal Test-only: forget every session-shared value. */
 declare function _resetCatalogGlobalState(): void;
 
-export { AGENT_CARDS_LIMIT_DESKTOP, AGENT_CARDS_LIMIT_MOBILE, AGENT_LIST_ITEMS_PER_PAGE, AGENT_SEARCH_LIMIT, AgentArchFilter, AgentCatalogClient, AgentCatalogErrorSink, AgentCatalogLabels, AgentCatalogReadError, AgentCatalogStorage, AgentCatalogStorageLike, AgentCatalogTransport, AgentConsumerState, type AgentListPage, type AgentSearchable, type AgentServerSearchResult, AgentSortOption, AgentSummary, AgentTab, MandateDefaultRowError, MandateResolutionVerdict, type ResolveDefaultRowArgs, type ResolveDefaultRowOutcome, ResolvedDefaultRow, _resetCatalogGlobalState, agentArchiveFilterChipLabel, agentArchiveFilterControlLabel, agentArchiveFilterStateLabel, agentConsumerHasActiveFilters, agentListEmptyLabel, agentListFooterLabel, agentMatchesArchiveFilter, agentMatchesSearch, applyAgentSortComparator, compareAgentIds, computeAgentSearchScore, createMemoryStorage, defaultRowFromResolution, defaultStorage, detectDefaultRowDrift, filterBuiltinTypeAgents, filterUserTypeAgents, makeSelectFilteredAgents, makeSelectFilteredAgentsCount, makeSelectFilteredBuiltinAgents, makeSelectFilteredBuiltinAgentsCount, makeSelectFilteredOwnedAgents, makeSelectFilteredSharedAgents, makeSelectOwnedAgentCards, makeSelectOwnedAgentListItems, makeSelectSharedAgentCards, makeSelectSharedAgentListItems, memoize1, memoize2, memoize3, parseMandateResolution, readAgentCatalogRows, readCachedDefaultRow, readCachedDefaultRowAsync, readSingleAgentRow, resolveDefaultRow, searchAgentsOnServer, selectAgentTabCounts, selectAllAgentCategories, selectAllAgentTags, selectAllSystemAgentCategories, selectAllSystemAgentTags, selectBuiltinTypeAgents, selectTotalBuiltinAgentsCount, selectTotalFavoriteAgentsCount, selectTotalOwnedAgentsCount, selectTotalSharedAgentsCount, selectTotalUserAgentsCount, selectUserTypeAgents, shouldDefaultAgentListToPublicTab, sortFilteredAgents, toAgentSummary, writeAgentFavorite, writeCachedDefaultRow, writeCachedDefaultRowAsync };
+export { AGENT_CARDS_LIMIT_DESKTOP, AGENT_CARDS_LIMIT_MOBILE, AGENT_LIST_ITEMS_PER_PAGE, AGENT_SEARCH_LIMIT, AgentArchFilter, AgentCatalogClient, AgentCatalogErrorSink, AgentCatalogFavorites, AgentCatalogLabels, AgentCatalogReadError, AgentCatalogStorage, AgentCatalogStorageLike, AgentCatalogTransport, AgentConsumerState, type AgentListPage, type AgentSearchable, type AgentServerSearchResult, AgentSortOption, AgentSummary, AgentTab, MandateDefaultRowError, MandateResolutionVerdict, type ResolveDefaultRowArgs, type ResolveDefaultRowOutcome, ResolvedDefaultRow, _resetCatalogGlobalState, agentArchiveFilterChipLabel, agentArchiveFilterControlLabel, agentArchiveFilterStateLabel, agentConsumerHasActiveFilters, agentListEmptyLabel, agentListFooterLabel, agentMatchesArchiveFilter, agentMatchesSearch, applyAgentSortComparator, compareAgentIds, computeAgentSearchScore, createMemoryStorage, defaultRowFromResolution, defaultStorage, detectDefaultRowDrift, filterBuiltinTypeAgents, filterUserTypeAgents, makeSelectFilteredAgents, makeSelectFilteredAgentsCount, makeSelectFilteredBuiltinAgents, makeSelectFilteredBuiltinAgentsCount, makeSelectFilteredOwnedAgents, makeSelectFilteredSharedAgents, makeSelectOwnedAgentCards, makeSelectOwnedAgentListItems, makeSelectSharedAgentCards, makeSelectSharedAgentListItems, memoize1, memoize2, memoize3, parseMandateResolution, readAgentCatalogRows, readCachedDefaultRow, readCachedDefaultRowAsync, readSingleAgentRow, resolveDefaultRow, searchAgentsOnServer, selectAgentTabCounts, selectAllAgentCategories, selectAllAgentTags, selectAllSystemAgentCategories, selectAllSystemAgentTags, selectBuiltinTypeAgents, selectTotalBuiltinAgentsCount, selectTotalFavoriteAgentsCount, selectTotalOwnedAgentsCount, selectTotalSharedAgentsCount, selectTotalUserAgentsCount, selectUserTypeAgents, shouldDefaultAgentListToPublicTab, sortFilteredAgents, toAgentSummary, writeAgentFavorite, writeCachedDefaultRow, writeCachedDefaultRowAsync };

package/dist/catalog/index.d.ts

@@ -1,17 +1,21 @@
-import { A as AgentSummary, a as AgentCatalogClient, b as AgentCatalogTransport, c as AgentCatalogStorageLike, d as AgentCatalogErrorSink, R as ResolvedDefaultRow, e as AgentCatalogStorage, M as MandateResolutionVerdict, f as AgentArchFilter, g as AgentTab, h as AgentCatalogLabels, i as AgentConsumerState, j as AgentSortOption } from '../orchestra-BDXdut6Y.js';
-export { k as AGENT_NONE_SENTINEL, l as ARCHIVE_FILTER_OPTIONS, m as ARCHIVE_FILTER_ORDER, n as AgentAccessFilter, o as AgentAccessLevel, p as AgentArchFilterOption, q as AgentCatalog, r as AgentCatalogAgentType, s as AgentCatalogAsyncStorage, t as AgentCatalogConfig, u as AgentCatalogConfigError, v as AgentCatalogDefaults, w as AgentCatalogIdentity, x as AgentCatalogNavigate, y as AgentCatalogNotifier, z as AgentCatalogOpenPeek, B as AgentCatalogResolveHref, C as AgentCatalogRpcCall, D as AgentCatalogSchemaReport, E as AgentCatalogState, F as AgentCatalogStatus, G as AgentCatalogTableQuery, H as AgentConsumerPatch, I as AgentFavFilter, J as AgentId, K as AssertAgentCatalogSchemaOptions, L as DEFAULT_AGENT_CATALOG_LABELS, N as DEFAULT_AGENT_CONSUMER_STATE, O as DefaultRowState, P as OrchestraBadge, Q as PgErrorLike, S as PgResultLike, T as SORT_OPTIONS, U as asAgentId, V as assertAgentCatalogSchema, W as createAgentCatalog, X as getRegisteredAgentCatalog, Y as isAgentArchFilter, Z as isMandateAgentId, _ as mandateAgentId, $ as nextArchFilter, a0 as orchestraDelegatesLine, a1 as orchestraDepthLine, a2 as orchestraLabel, a3 as orchestraModeLabel } from '../orchestra-BDXdut6Y.js';
+import { A as AgentSummary, a as AgentCatalogClient, b as AgentCatalogFavorites, c as AgentCatalogTransport, d as AgentCatalogStorageLike, e as AgentCatalogErrorSink, R as ResolvedDefaultRow, f as AgentCatalogStorage, M as MandateResolutionVerdict, g as AgentArchFilter, h as AgentTab, i as AgentCatalogLabels, j as AgentConsumerState, k as AgentSortOption } from '../orchestra-PbGGooqJ.js';
+export { l as AGENT_NONE_SENTINEL, m as ARCHIVE_FILTER_OPTIONS, n as ARCHIVE_FILTER_ORDER, o as AgentAccessFilter, p as AgentAccessLevel, q as AgentArchFilterOption, r as AgentCatalog, s as AgentCatalogAgentType, t as AgentCatalogAsyncStorage, u as AgentCatalogConfig, v as AgentCatalogConfigError, w as AgentCatalogDefaults, x as AgentCatalogIdentity, y as AgentCatalogNavigate, z as AgentCatalogNotifier, B as AgentCatalogOpenPeek, C as AgentCatalogResolveHref, D as AgentCatalogRpcCall, E as AgentCatalogSchemaReport, F as AgentCatalogState, G as AgentCatalogStatus, H as AgentConsumerPatch, I as AgentFavFilter, J as AgentId, K as AssertAgentCatalogSchemaOptions, L as DEFAULT_AGENT_CATALOG_LABELS, N as DEFAULT_AGENT_CONSUMER_STATE, O as DefaultRowState, P as OrchestraBadge, Q as PgErrorLike, S as PgResultLike, T as SORT_OPTIONS, U as asAgentId, V as assertAgentCatalogSchema, W as createAgentCatalog, X as getRegisteredAgentCatalog, Y as isAgentArchFilter, Z as isMandateAgentId, _ as mandateAgentId, $ as nextArchFilter, a0 as orchestraDelegatesLine, a1 as orchestraDepthLine, a2 as orchestraLabel, a3 as orchestraModeLabel } from '../orchestra-PbGGooqJ.js';
 
 /**
  * catalog/data.ts — @ai-matrx/agents/catalog
  *
- * Every database call the catalog makes, and nothing else. Four of them:
+ * Every database call the catalog makes, and nothing else. Five of them:
  *
  *   1. `agx_get_list_full()` — the complete catalogue (owned + directly-shared
  *      + org-shared user agents, unioned with active builtins).
  *   2. `agx_search(p_query, p_deep, p_limit, p_offset)` — tier-2 server search.
  *   3. `agx_resolve_agent_address(p_ids)` — the single-agent name read, used
  *      when a mandate's Holder is not in the caller's own catalogue.
- *   4. ONE write: `agent.definition.is_favorite`.
+ *   4. The caller's stars: `ues_get_bulk('agent', ids)` through the
+ *      favorites port (`platform.user_entity_state`), overlaid on every row
+ *      set this module returns to the store.
+ *   5. ONE write: the caller's star, `ues_set` through the same port. The
+ *      retired `agent.definition.is_favorite` column is never read or written.
  *
  * 🚨 THE LIST READ IS COMPLETE OR IT THROWS. PostgREST caps every response at
  * `db-max-rows` (1000 on Matrx Main) and reports success — matrx-frontend's
@@ -68,10 +72,11 @@ declare function searchAgentsOnServer(client: AgentCatalogClient, args: {
  */
 declare function readSingleAgentRow(client: AgentCatalogClient, agentId: string): Promise<AgentSummary | null>;
 /**
- * THE ONE WRITE. Mirrors matrx-frontend's `saveAgentField` for this field
- * exactly: `agent.definition.is_favorite`, addressed by id.
+ * THE ONE WRITE: the caller's star on one agent, in
+ * `platform.user_entity_state` through the favorites port. Throws an
+ * `AgentCatalogReadError` carrying the refusal in words.
  */
-declare function writeAgentFavorite(client: AgentCatalogClient, agentId: string, isFavorite: boolean): Promise<void>;
+declare function writeAgentFavorite(favorites: AgentCatalogFavorites, agentId: string, isFavorite: boolean): Promise<void>;
 
 /**
  * catalog/rows.ts — @ai-matrx/agents/catalog
@@ -174,8 +179,14 @@ interface ResolveDefaultRowArgs {
     client: AgentCatalogClient;
     storage: AgentCatalogStorageLike;
     errorSink: AgentCatalogErrorSink;
-    /** Look the Holder up in the rows this catalog already holds. */
-    lookupRow: (agentId: string) => AgentSummary | undefined;
+    /**
+     * Look the Holder up in the rows this catalog already holds. May answer
+     * asynchronously: the store waits for an in-flight list read before
+     * declaring a miss, so a default row never costs a second network read just
+     * because the verdict outran the list (the list read now also overlays the
+     * caller's stars).
+     */
+    lookupRow: (agentId: string) => AgentSummary | undefined | Promise<AgentSummary | undefined>;
 }
 interface ResolveDefaultRowOutcome {
     resolved: ResolvedDefaultRow;
@@ -491,4 +502,4 @@ declare const selectTotalFavoriteAgentsCount: (a: readonly AgentSummary[]) => nu
 /** @internal Test-only: forget every session-shared value. */
 declare function _resetCatalogGlobalState(): void;
 
-export { AGENT_CARDS_LIMIT_DESKTOP, AGENT_CARDS_LIMIT_MOBILE, AGENT_LIST_ITEMS_PER_PAGE, AGENT_SEARCH_LIMIT, AgentArchFilter, AgentCatalogClient, AgentCatalogErrorSink, AgentCatalogLabels, AgentCatalogReadError, AgentCatalogStorage, AgentCatalogStorageLike, AgentCatalogTransport, AgentConsumerState, type AgentListPage, type AgentSearchable, type AgentServerSearchResult, AgentSortOption, AgentSummary, AgentTab, MandateDefaultRowError, MandateResolutionVerdict, type ResolveDefaultRowArgs, type ResolveDefaultRowOutcome, ResolvedDefaultRow, _resetCatalogGlobalState, agentArchiveFilterChipLabel, agentArchiveFilterControlLabel, agentArchiveFilterStateLabel, agentConsumerHasActiveFilters, agentListEmptyLabel, agentListFooterLabel, agentMatchesArchiveFilter, agentMatchesSearch, applyAgentSortComparator, compareAgentIds, computeAgentSearchScore, createMemoryStorage, defaultRowFromResolution, defaultStorage, detectDefaultRowDrift, filterBuiltinTypeAgents, filterUserTypeAgents, makeSelectFilteredAgents, makeSelectFilteredAgentsCount, makeSelectFilteredBuiltinAgents, makeSelectFilteredBuiltinAgentsCount, makeSelectFilteredOwnedAgents, makeSelectFilteredSharedAgents, makeSelectOwnedAgentCards, makeSelectOwnedAgentListItems, makeSelectSharedAgentCards, makeSelectSharedAgentListItems, memoize1, memoize2, memoize3, parseMandateResolution, readAgentCatalogRows, readCachedDefaultRow, readCachedDefaultRowAsync, readSingleAgentRow, resolveDefaultRow, searchAgentsOnServer, selectAgentTabCounts, selectAllAgentCategories, selectAllAgentTags, selectAllSystemAgentCategories, selectAllSystemAgentTags, selectBuiltinTypeAgents, selectTotalBuiltinAgentsCount, selectTotalFavoriteAgentsCount, selectTotalOwnedAgentsCount, selectTotalSharedAgentsCount, selectTotalUserAgentsCount, selectUserTypeAgents, shouldDefaultAgentListToPublicTab, sortFilteredAgents, toAgentSummary, writeAgentFavorite, writeCachedDefaultRow, writeCachedDefaultRowAsync };
+export { AGENT_CARDS_LIMIT_DESKTOP, AGENT_CARDS_LIMIT_MOBILE, AGENT_LIST_ITEMS_PER_PAGE, AGENT_SEARCH_LIMIT, AgentArchFilter, AgentCatalogClient, AgentCatalogErrorSink, AgentCatalogFavorites, AgentCatalogLabels, AgentCatalogReadError, AgentCatalogStorage, AgentCatalogStorageLike, AgentCatalogTransport, AgentConsumerState, type AgentListPage, type AgentSearchable, type AgentServerSearchResult, AgentSortOption, AgentSummary, AgentTab, MandateDefaultRowError, MandateResolutionVerdict, type ResolveDefaultRowArgs, type ResolveDefaultRowOutcome, ResolvedDefaultRow, _resetCatalogGlobalState, agentArchiveFilterChipLabel, agentArchiveFilterControlLabel, agentArchiveFilterStateLabel, agentConsumerHasActiveFilters, agentListEmptyLabel, agentListFooterLabel, agentMatchesArchiveFilter, agentMatchesSearch, applyAgentSortComparator, compareAgentIds, computeAgentSearchScore, createMemoryStorage, defaultRowFromResolution, defaultStorage, detectDefaultRowDrift, filterBuiltinTypeAgents, filterUserTypeAgents, makeSelectFilteredAgents, makeSelectFilteredAgentsCount, makeSelectFilteredBuiltinAgents, makeSelectFilteredBuiltinAgentsCount, makeSelectFilteredOwnedAgents, makeSelectFilteredSharedAgents, makeSelectOwnedAgentCards, makeSelectOwnedAgentListItems, makeSelectSharedAgentCards, makeSelectSharedAgentListItems, memoize1, memoize2, memoize3, parseMandateResolution, readAgentCatalogRows, readCachedDefaultRow, readCachedDefaultRowAsync, readSingleAgentRow, resolveDefaultRow, searchAgentsOnServer, selectAgentTabCounts, selectAllAgentCategories, selectAllAgentTags, selectAllSystemAgentCategories, selectAllSystemAgentTags, selectBuiltinTypeAgents, selectTotalBuiltinAgentsCount, selectTotalFavoriteAgentsCount, selectTotalOwnedAgentsCount, selectTotalSharedAgentsCount, selectTotalUserAgentsCount, selectUserTypeAgents, shouldDefaultAgentListToPublicTab, sortFilteredAgents, toAgentSummary, writeAgentFavorite, writeCachedDefaultRow, writeCachedDefaultRowAsync };

package/dist/catalog/index.js

@@ -80,6 +80,9 @@ var DEFAULT_AGENT_CATALOG_LABELS = {
   hoverHint: "Hover an agent to preview its details, or click to select."
 };
 
+// catalog/store.ts
+import { createAssociationsStore } from "@ai-matrx/associations/core";
+
 // catalog/data.ts
 import { readAllRows } from "@ai-matrx/data/db";
 
@@ -129,7 +132,9 @@ function toAgentSummary(raw) {
     modelId: str(raw["model_id"]),
     isActive: bool(raw["is_active"]),
     isArchived: bool(raw["is_archived"]),
-    isFavorite: bool(raw["is_favorite"]),
+    // Stars are per-person (platform.user_entity_state) and are overlaid by
+    // `overlayAgentFavorites` — a list row never carries the caller's star.
+    isFavorite: false,
     createdBy: str(raw["created_by"]),
     organizationId: str(raw["organization_id"]),
     taskId: str(raw["task_id"]),
@@ -238,12 +243,40 @@ async function readSingleAgentRow(client, agentId) {
   }
   return null;
 }
-async function writeAgentFavorite(client, agentId, isFavorite2) {
-  const { error } = await client.schema("agent").from("definition").update({ is_favorite: isFavorite2 }).eq("id", agentId);
-  if (error) {
+var AGENT_FAVORITE_ENTITY_TYPE = "agent";
+async function overlayAgentFavorites(favorites, rows, onError) {
+  if (rows.length === 0) return rows;
+  let starred = null;
+  try {
+    const result = await favorites.getBulk(
+      AGENT_FAVORITE_ENTITY_TYPE,
+      rows.map((r) => r.id)
+    );
+    if (result.ok) {
+      starred = new Set(
+        result.data.items.filter((s) => s.isFavorite).map((s) => s.entityId)
+      );
+    } else {
+      onError(result.error.message);
+    }
+  } catch (e) {
+    onError(e instanceof Error ? e.message : String(e));
+  }
+  return rows.map((r) => {
+    const isFavorite2 = starred?.has(r.id) ?? false;
+    return r.isFavorite === isFavorite2 ? r : { ...r, isFavorite: isFavorite2 };
+  });
+}
+async function writeAgentFavorite(favorites, agentId, isFavorite2) {
+  const result = await favorites.setFavorite(
+    AGENT_FAVORITE_ENTITY_TYPE,
+    agentId,
+    isFavorite2
+  );
+  if (!result.ok) {
     throw new AgentCatalogReadError(
-      "agent.definition.is_favorite",
-      pgDetail(error)
+      "user_entity_state (ues_set)",
+      result.error.code ? `${result.error.message} (${result.error.code})` : result.error.message
     );
   }
 }
@@ -457,7 +490,7 @@ async function resolveDefaultRow(args) {
       remedy: `bind the ${verdict.provenance} rung to an agent`
     });
   }
-  let holder = lookupRow(holderId);
+  let holder = await lookupRow(holderId);
   if (!holder) {
     holder = await readSingleAgentRow(client, holderId) ?? void 0;
   }
@@ -511,7 +544,9 @@ var SELF_TEST_MISSING_RPC = "agx_this_function_does_not_exist_probe";
 var DEMANDED_RPCS = {
   agx_get_list_full: {},
   agx_search: { p_query: "__probe__", p_deep: false, p_limit: 1, p_offset: 0 },
-  agx_resolve_agent_address: { p_ids: [BAD_UUID] }
+  agx_resolve_agent_address: { p_ids: [BAD_UUID] },
+  // The caller's stars. Read-only, and an impossible id touches no row.
+  ues_get_bulk: { p_entity_type: "agent", p_entity_ids: [BAD_UUID] }
 };
 function isMissingFunctionError(error) {
   if (!error || typeof error !== "object") return false;
@@ -519,11 +554,7 @@ function isMissingFunctionError(error) {
   return code === "PGRST202" || code === "42883";
 }
 async function assertAgentCatalogSchema(client, options = {}) {
-  const {
-    selfTest = false,
-    throwOnViolation = true,
-    probeWrite = true
-  } = options;
+  const { selfTest = false, throwOnViolation = true } = options;
   const names = Object.keys(DEMANDED_RPCS);
   if (selfTest) names.push(SELF_TEST_MISSING_RPC);
   const missing = [];
@@ -556,41 +587,22 @@ async function assertAgentCatalogSchema(client, options = {}) {
       );
     }
   }
-  let favoriteWritable = null;
-  if (probeWrite) {
-    try {
-      const { error } = await client.schema("agent").from("definition").update({ is_favorite: false }).eq("id", BAD_UUID);
-      favoriteWritable = !isPermissionRefusal(error);
-    } catch (e) {
-      unreachable.push({ fn: "agent.definition.is_favorite", error: e });
-    }
-  }
   if (unreachable.length > 0) {
     throw new Error(
       `assertAgentCatalogSchema could not complete: ${unreachable.length} probe call(s) failed to reach the database (${unreachable.map((u) => u.fn).join(", ")}). This is NOT a schema verdict \u2014 fix connectivity and re-run.`
     );
   }
-  const ok = missing.length === 0 && favoriteWritable !== false;
+  const ok = missing.length === 0;
   const report = {
     ok,
     missing,
     unreachable,
     answered,
-    favoriteWritable,
     orchestraColumn
   };
   if (!ok && throwOnViolation) {
-    const parts = [];
-    if (missing.length > 0) {
-      parts.push(
-        `cannot answer ${missing.length} demanded function(s): ${missing.join(", ")}`
-      );
-    }
-    if (favoriteWritable === false) {
-      parts.push("refuses a write to agent.definition.is_favorite");
-    }
     throw new Error(
-      `DEMANDED SCHEMA VIOLATION: the database this client points at ${parts.join("; and ")}. @ai-matrx/agents/catalog cannot render a correct picker against it \u2014 point the client at Matrx Main, or apply the agx_* migrations.`
+      `DEMANDED SCHEMA VIOLATION: the database this client points at cannot answer ${missing.length} demanded function(s): ${missing.join(", ")}. @ai-matrx/agents/catalog cannot render a correct picker against it \u2014 point the client at Matrx Main, or apply the agx_* migrations.`
     );
   }
   return report;
@@ -601,11 +613,6 @@ function readsOrchestraColumn(data) {
     (row) => typeof row === "object" && row !== null && Object.prototype.hasOwnProperty.call(row, "orchestra")
   );
 }
-function isPermissionRefusal(error) {
-  if (!error) return false;
-  const code = error.code;
-  return code === "42501" || code === "42P01" || code === "PGRST205";
-}
 
 // catalog/store.ts
 var LIST_TTL_MS = 15 * 60 * 1e3;
@@ -642,13 +649,6 @@ function createAgentCatalog(config) {
       remedy: "pass `client` (a supabase-js client, or anything with rpc() and schema().from())"
     });
   }
-  if (typeof config.client.schema !== "function") {
-    throw new AgentCatalogConfigError({
-      code: "client_cannot_write",
-      message: "the client passed to createAgentCatalog has no schema() \u2014 the favorite write has nowhere to go",
-      remedy: "pass a full supabase-js client"
-    });
-  }
   if (!config.identity || typeof config.identity.requireUserId !== "function") {
     throw new AgentCatalogConfigError({
       code: "missing_identity",
@@ -675,6 +675,21 @@ function createAgentCatalog(config) {
   const notifier = config.notifier;
   const storage = config.storage ?? defaultStorage();
   const transport = config.transport;
+  const favorites = config.favorites ?? createAssociationsStore({
+    // The catalog's client IS a supabase-js client; the associations
+    // data-source port is the same `rpc(fn, args)` shape, typed over its
+    // own demanded-RPC names.
+    dataSource: client,
+    identity,
+    errorSink
+  }).favorites;
+  function reportFavoriteReadFailure(message) {
+    errorSink({
+      code: "favorite_read_failed",
+      message: `your starred agents could not be read (${message}); every star is shown unset until the next catalogue load`,
+      context: { catalogId }
+    });
+  }
   const labels = {
     ...DEFAULT_AGENT_CATALOG_LABELS,
     ...config.labels ?? {}
@@ -739,7 +754,11 @@ function createAgentCatalog(config) {
   async function load() {
     publish({ ...state, status: "loading", error: null });
     try {
-      const rows = await readAgentCatalogRows(client);
+      const rows = await overlayAgentFavorites(
+        favorites,
+        await readAgentCatalogRows(client),
+        reportFavoriteReadFailure
+      );
       replaceRows(rows);
       publish({ ...state, status: "succeeded", error: null });
       globalState.listFetchedAt.set(catalogId, Date.now());
@@ -822,7 +841,13 @@ function createAgentCatalog(config) {
   }
   async function searchServer(query, deep = false) {
     const result = await searchAgentsOnServer(client, { query, deep });
-    mergeRows(result.rows);
+    mergeRows(
+      await overlayAgentFavorites(
+        favorites,
+        result.rows,
+        reportFavoriteReadFailure
+      )
+    );
     return result.ids;
   }
   async function setFavorite(agentId, isFavorite2) {
@@ -836,7 +861,7 @@ function createAgentCatalog(config) {
     }
     mergeRows([{ ...existing, isFavorite: isFavorite2 }]);
     try {
-      await writeAgentFavorite(client, agentId, isFavorite2);
+      await writeAgentFavorite(favorites, agentId, isFavorite2);
     } catch (e) {
       mergeRows([existing]);
       errorSink({
@@ -888,7 +913,14 @@ function createAgentCatalog(config) {
           client,
           storage,
           errorSink,
-          lookupRow: (id) => state.byId[id]
+          lookupRow: async (id) => {
+            const hit = state.byId[id];
+            if (hit) return hit;
+            const inFlight = globalState.listInFlight.get(catalogId);
+            if (!inFlight) return void 0;
+            await inFlight.catch(() => void 0);
+            return state.byId[id];
+          }
         });
         getCatalogGlobalState().defaultRows.set(
           `${catalogId}::${mandateKey}`,