@ai-matrx/agents 0.21.44 → 0.22.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.22.0
+
+- **A signed-out visitor never reads the agent catalogue** (live 2026-10-01: every guest page that mounted a picker — `/education/progress`, `/demos/spatial` — fired `agx_get_list_full`, which `anon` cannot execute, and captured `permission denied for function agx_get_list_full` plus `identity.requireUserId() threw`). `ensureLoaded` now answers the empty catalogue with no read when there is no user, and does not stamp freshness, so the first load after sign-in reads for real. The pickers (web + native) show `labels.emptySignedOut` ("Sign in to see your agents") instead of "No agents found". Guard: `catalog/__tests__/store.test.ts` › "signed out never reads the catalogue".
+- **New optional identity port `getUserId(): string | null`.** When bound, a signed-out visitor is a state, not a failure: `getUserIdOrNull()` answers from it and nothing is reported to the errorSink. Hosts that bind only `requireUserId` keep the old once-per-session `identity_unavailable` report.
+- **New label `emptySignedOut`** on `AgentCatalogLabels` (defaulted; hosts merging partial labels need no change).
+- Consumer action: bind `identity.getUserId` beside `requireUserId` (matrx-frontend: `lib/agents/catalog.ts`, `getUserId` from `@/utils/auth/getUserId`). A host passing a COMPLETE `AgentCatalogLabels` object adds `emptySignedOut`.
+
+## 0.21.46
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/matrx-agents/v0.21.45..npm/matrx-agents/v0.21.46 -- apps/shared/matrx-agents`).
+No source changes intended and no consumer action required.
+
+## 0.21.45
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/matrx-agents/v0.21.44..npm/matrx-agents/v0.21.45 -- apps/shared/matrx-agents`).
+No source changes intended and no consumer action required.
+
 ## 0.21.44
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/catalog/index.cjs

@@ -179,6 +179,7 @@ var DEFAULT_AGENT_CATALOG_LABELS = {
   emptyDefault: "No agents found",
   emptyShared: "No shared agents found",
   emptySystem: "No system agents found",
+  emptySignedOut: "Sign in to see your agents",
   loading: "Loading...",
   triggerFallback: "Agents",
   triggerResolving: "Naming the agent\u2026",
@@ -833,6 +834,7 @@ function createAgentCatalog(config) {
   }
   let anonymousReported = false;
   function getUserIdOrNull() {
+    if (typeof identity.getUserId === "function") return identity.getUserId();
     try {
       return identity.requireUserId();
     } catch (e) {
@@ -858,6 +860,11 @@ function createAgentCatalog(config) {
     return Date.now() - at > LIST_STALE_MS;
   }
   async function load() {
+    if (getUserIdOrNull() === null) {
+      if (state.rows.length > 0) replaceRows([]);
+      publish({ ...state, status: "succeeded", error: null });
+      return;
+    }
     publish({ ...state, status: "loading", error: null });
     try {
       const rows = await overlayAgentFavorites(