@ai-matrx/agents 0.59.258 → 0.59.260

package/CHANGELOG.md

@@ -1,9 +1,14 @@
 # Changelog
 
-## 0.59.258
-
-UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
-Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/matrx-agents/src`.
+## 0.59.260
+### the pinned read asks the server for those agents only (FW-015)
+
+- `ensureFavoriteRows()` / `readFavoriteAgentRows` now read the starred agents through
+  `agent.agx_get_by_ids(p_ids)` (same columns and access words as `agx_get_list_full`) instead of
+  `agx_get_list_full` filtered by id, which made the server build the caller's whole catalog first.
+  Measured on live: ordinary account 161 → 41 ms, admin 390 → 53 ms, identical rows.
+- 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.257
 

package/dist/catalog/index.cjs

@@ -398,6 +398,9 @@ async function readFavoriteAgentRows(client, favorites) {
   if (typeof favorites.list !== "function") {
     throw new AgentPinnedReadUnsupported("the favorites port has no list()");
   }
+  if (typeof client.schema !== "function") {
+    throw new AgentPinnedReadUnsupported("the client has no schema()");
+  }
   const listed = await favorites.list("favorite");
   if (!listed.ok) {
     throw new AgentCatalogReadError(
@@ -416,13 +419,9 @@ async function readFavoriteAgentRows(client, favorites) {
   const rows = [];
   for (let at = 0; at < ids.length; at += PINNED_ID_CHUNK) {
     const chunk = ids.slice(at, at + PINNED_ID_CHUNK);
-    const call = client.rpc("agx_get_list_full", {});
-    if (typeof call.in !== "function") {
-      throw new AgentPinnedReadUnsupported("the client's rpc builder has no in()");
-    }
-    const { data, error } = await call.in("id", chunk);
+    const { data, error } = await client.schema("agent").rpc("agx_get_by_ids", { p_ids: chunk });
     if (error) {
-      throw new AgentCatalogReadError("agx_get_list_full (pinned)", pgDetail(error));
+      throw new AgentCatalogReadError("agent.agx_get_by_ids (pinned)", pgDetail(error));
     }
     for (const item of Array.isArray(data) ? data : []) {
       const summary = toAgentSummary(item);

package/dist/catalog/index.d.cts

@@ -814,10 +814,11 @@ declare function getRegisteredAgentCatalog(catalogId?: string): AgentCatalog | u
  *      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.
- *   6. THE PINNED READ (2026-10-09): the caller's starred ids (`ues_list`
- *      through the favorites port), then `agx_get_list_full` filtered to
- *      exactly those ids (`?id=in.(…)`). A sidebar's Pinned section shows a
- *      handful of rows; it never pays for the whole catalog to find them.
+ *   6. THE PINNED READ (2026-10-09; by-ids 2026-10-23): the caller's starred
+ *      ids (`ues_list` through the favorites port), then
+ *      `agent.agx_get_by_ids(p_ids)` for exactly those ids. A sidebar's Pinned
+ *      section shows a handful of rows; it never pays for the whole catalog,
+ *      in the browser or on the server, to find them.
  *
  * 🚨 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

package/dist/catalog/index.d.ts

@@ -814,10 +814,11 @@ declare function getRegisteredAgentCatalog(catalogId?: string): AgentCatalog | u
  *      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.
- *   6. THE PINNED READ (2026-10-09): the caller's starred ids (`ues_list`
- *      through the favorites port), then `agx_get_list_full` filtered to
- *      exactly those ids (`?id=in.(…)`). A sidebar's Pinned section shows a
- *      handful of rows; it never pays for the whole catalog to find them.
+ *   6. THE PINNED READ (2026-10-09; by-ids 2026-10-23): the caller's starred
+ *      ids (`ues_list` through the favorites port), then
+ *      `agent.agx_get_by_ids(p_ids)` for exactly those ids. A sidebar's Pinned
+ *      section shows a handful of rows; it never pays for the whole catalog,
+ *      in the browser or on the server, to find them.
  *
  * 🚨 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

package/dist/catalog/index.js

@@ -292,6 +292,9 @@ async function readFavoriteAgentRows(client, favorites) {
   if (typeof favorites.list !== "function") {
     throw new AgentPinnedReadUnsupported("the favorites port has no list()");
   }
+  if (typeof client.schema !== "function") {
+    throw new AgentPinnedReadUnsupported("the client has no schema()");
+  }
   const listed = await favorites.list("favorite");
   if (!listed.ok) {
     throw new AgentCatalogReadError(
@@ -310,13 +313,9 @@ async function readFavoriteAgentRows(client, favorites) {
   const rows = [];
   for (let at = 0; at < ids.length; at += PINNED_ID_CHUNK) {
     const chunk = ids.slice(at, at + PINNED_ID_CHUNK);
-    const call = client.rpc("agx_get_list_full", {});
-    if (typeof call.in !== "function") {
-      throw new AgentPinnedReadUnsupported("the client's rpc builder has no in()");
-    }
-    const { data, error } = await call.in("id", chunk);
+    const { data, error } = await client.schema("agent").rpc("agx_get_by_ids", { p_ids: chunk });
     if (error) {
-      throw new AgentCatalogReadError("agx_get_list_full (pinned)", pgDetail(error));
+      throw new AgentCatalogReadError("agent.agx_get_by_ids (pinned)", pgDetail(error));
     }
     for (const item of Array.isArray(data) ? data : []) {
       const summary = toAgentSummary(item);

package/dist/context/index.cjs

@@ -426,7 +426,7 @@ function compareReceipt(expected, receipt) {
         reason: "self_check"
       });
     }
-    if (!selfChecked && !consumed && modelReadsContext && !exp.serverResolved && exp.delivery !== "server" && exp.chars !== null && actual.chars !== null && actual.delivery !== exp.delivery) {
+    if (!selfChecked && !consumed && modelReadsContext && !serverOwned && exp.delivery !== "server" && exp.chars !== null && actual.chars !== null && actual.delivery !== exp.delivery) {
       mismatches.push({ key: exp.key, field: "delivery", expected: exp.delivery, actual: actual.delivery });
     }
     const expRule = normalizeUserRule(exp.userRule);

package/dist/context/index.js

@@ -363,7 +363,7 @@ function compareReceipt(expected, receipt) {
         reason: "self_check"
       });
     }
-    if (!selfChecked && !consumed && modelReadsContext && !exp.serverResolved && exp.delivery !== "server" && exp.chars !== null && actual.chars !== null && actual.delivery !== exp.delivery) {
+    if (!selfChecked && !consumed && modelReadsContext && !serverOwned && exp.delivery !== "server" && exp.chars !== null && actual.chars !== null && actual.delivery !== exp.delivery) {
       mismatches.push({ key: exp.key, field: "delivery", expected: exp.delivery, actual: actual.delivery });
     }
     const expRule = normalizeUserRule(exp.userRule);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.258",
+  "version": "0.59.260",
   "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": "48dc0c53e766ad507fa37f41893b2b358be229f4"
+  "gitHead": "9a4fd3053c05194032de663989ec2f851ab0db6c"
 }