@ai-matrx/agents 0.59.261 → 0.59.262

package/CHANGELOG.md

@@ -1,6 +1,22 @@
 # Changelog
 
+## 0.59.262
+### no second star read after a catalog or search read (FW-014)
+
+- `ensureLoaded()` and `searchServer()` no longer follow each read with `ues_get_bulk('agent', every id)`.
+  Every catalog read (`agx_get_list_full`, `agx_search`, `agent.agx_get_by_ids`) already returns
+  `is_favorite` computed server-side from `platform.user_entity_state` (`platform.my_favorite`), so
+  `toAgentSummary` now reads it. Saves one sequential request uploading every agent id (673 ids for an
+  ordinary account, 1,478 for admin) on every picker load and search.
+- Removed: `overlayAgentFavorites` (internal) and the `favorite_read_failed` error code. The favorites
+  port's `getBulk` is no longer called by the catalog. Consumer action: none.
+
 ## 0.59.261
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 9a4fd3053c c006aa4394 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
+## 0.59.260
 ### the pinned read asks the server for those agents only (FW-015)
 
 - `ensureFavoriteRows()` / `readFavoriteAgentRows` now read the starred agents through
@@ -10,6 +26,16 @@
 - The narrow read needs a client with `schema()` (supabase-js has it); without one the store falls back to the
   whole catalog and reports `pinned_read_unsupported`, as before. Consumer action: none.
 
+## 0.59.259
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 48dc0c53e7 c3bd77d32a -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
+## 0.59.258
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 0a2b8c9356 48dc0c53e7 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
 ## 0.59.257
 
 Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 76b41cb76b 0a2b8c9356 -- apps/shared/matrx-agents/src`

package/dist/catalog/index.cjs

@@ -239,9 +239,11 @@ function toAgentSummary(raw) {
     modelId: str(raw["model_id"]),
     isActive: bool(raw["is_active"]),
     isArchived: bool(raw["is_archived"]),
-    // Stars are per-person (platform.user_entity_state) and are overlaid by
-    // `overlayAgentFavorites` — a list row never carries the caller's star.
-    isFavorite: false,
+    // The caller's star. Every read this module maps (agx_get_list_full,
+    // agx_search, agent.agx_get_by_ids) computes it server-side with
+    // platform.my_favorite — platform.user_entity_state for auth.uid(), the
+    // same table the favorites port reads — so no second read is needed (FW-014).
+    isFavorite: bool(raw["is_favorite"]),
     createdBy: str(raw["created_by"]),
     organizationId: str(raw["organization_id"]),
     taskId: str(raw["task_id"]),
@@ -354,29 +356,6 @@ async function readSingleAgentRow(client, agentId) {
   return null;
 }
 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,
@@ -832,13 +811,6 @@ function createAgentCatalog(config) {
     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 catalog load`,
-      context: { catalogId }
-    });
-  }
   const labels = {
     ...DEFAULT_AGENT_CATALOG_LABELS,
     ...config.labels ?? {}
@@ -910,11 +882,7 @@ function createAgentCatalog(config) {
     }
     publish({ ...state, status: "loading", error: null });
     try {
-      const rows = await overlayAgentFavorites(
-        favorites,
-        await readAgentCatalogRows(client),
-        reportFavoriteReadFailure
-      );
+      const rows = await readAgentCatalogRows(client);
       replaceRows(rows);
       publish({ ...state, status: "succeeded", error: null, favoriteRowsStatus: "succeeded" });
       globalState.listFetchedAt.set(catalogId, Date.now());
@@ -1064,13 +1032,7 @@ function createAgentCatalog(config) {
   }
   async function searchServer(query, deep = false) {
     const result = await searchAgentsOnServer(client, { query, deep });
-    mergeRows(
-      await overlayAgentFavorites(
-        favorites,
-        result.rows,
-        reportFavoriteReadFailure
-      )
-    );
+    mergeRows(result.rows);
     return result.ids;
   }
   async function setFavorite(agentId, isFavorite2) {

package/dist/catalog/index.d.cts

@@ -809,9 +809,10 @@ declare function getRegisteredAgentCatalog(catalogId?: string): AgentCatalog | u
  *   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 catalog.
- *   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.
+ *   4. The caller's stars arrive ON the rows: every read above computes
+ *      `is_favorite` server-side from `platform.user_entity_state`
+ *      (`platform.my_favorite`). There is no second star read (FW-014; the
+ *      `ues_get_bulk` overlay over every id was retired 2026-10-23).
  *   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.
  *   6. THE PINNED READ (2026-10-09; by-ids 2026-10-23): the caller's starred

package/dist/catalog/index.d.ts

@@ -809,9 +809,10 @@ declare function getRegisteredAgentCatalog(catalogId?: string): AgentCatalog | u
  *   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 catalog.
- *   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.
+ *   4. The caller's stars arrive ON the rows: every read above computes
+ *      `is_favorite` server-side from `platform.user_entity_state`
+ *      (`platform.my_favorite`). There is no second star read (FW-014; the
+ *      `ues_get_bulk` overlay over every id was retired 2026-10-23).
  *   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.
  *   6. THE PINNED READ (2026-10-09; by-ids 2026-10-23): the caller's starred

package/dist/catalog/index.js

@@ -133,9 +133,11 @@ function toAgentSummary(raw) {
     modelId: str(raw["model_id"]),
     isActive: bool(raw["is_active"]),
     isArchived: bool(raw["is_archived"]),
-    // Stars are per-person (platform.user_entity_state) and are overlaid by
-    // `overlayAgentFavorites` — a list row never carries the caller's star.
-    isFavorite: false,
+    // The caller's star. Every read this module maps (agx_get_list_full,
+    // agx_search, agent.agx_get_by_ids) computes it server-side with
+    // platform.my_favorite — platform.user_entity_state for auth.uid(), the
+    // same table the favorites port reads — so no second read is needed (FW-014).
+    isFavorite: bool(raw["is_favorite"]),
     createdBy: str(raw["created_by"]),
     organizationId: str(raw["organization_id"]),
     taskId: str(raw["task_id"]),
@@ -248,29 +250,6 @@ async function readSingleAgentRow(client, agentId) {
   return null;
 }
 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,
@@ -726,13 +705,6 @@ function createAgentCatalog(config) {
     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 catalog load`,
-      context: { catalogId }
-    });
-  }
   const labels = {
     ...DEFAULT_AGENT_CATALOG_LABELS,
     ...config.labels ?? {}
@@ -804,11 +776,7 @@ function createAgentCatalog(config) {
     }
     publish({ ...state, status: "loading", error: null });
     try {
-      const rows = await overlayAgentFavorites(
-        favorites,
-        await readAgentCatalogRows(client),
-        reportFavoriteReadFailure
-      );
+      const rows = await readAgentCatalogRows(client);
       replaceRows(rows);
       publish({ ...state, status: "succeeded", error: null, favoriteRowsStatus: "succeeded" });
       globalState.listFetchedAt.set(catalogId, Date.now());
@@ -958,13 +926,7 @@ function createAgentCatalog(config) {
   }
   async function searchServer(query, deep = false) {
     const result = await searchAgentsOnServer(client, { query, deep });
-    mergeRows(
-      await overlayAgentFavorites(
-        favorites,
-        result.rows,
-        reportFavoriteReadFailure
-      )
-    );
+    mergeRows(result.rows);
     return result.ids;
   }
   async function setFavorite(agentId, isFavorite2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.261",
+  "version": "0.59.262",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -562,5 +562,5 @@
     "verify:tarball": "node ./scripts/verify-tarball.mjs",
     "typegen:self-test": "node scripts/typegen/drop-guard.self-test.mjs && node scripts/typegen/check-api-types-fresh.mjs --self-test"
   },
-  "gitHead": "c006aa4394ac233c23c923f57d06b49f769037ab"
+  "gitHead": "de2b95873473d1fd1878b0e3b06ce75570190a1b"
 }