@ai-matrx/agents 0.21.45 → 0.23.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.23.0
+
+- **Resume never runs a live run twice — every client rejoins it** (`./matrx`). New `resumeOrRejoin(transport, resumeCall, { organizationId, onEnvelope, … })`: runs the feature's resume door and pipes its NDJSON into `onEnvelope`; on `409 run_in_progress` it follows `POST /runtime/operations/{live_request_id}/rejoin` into the SAME handler under the run's own organization; on `409 live_stream_unavailable` it follows the durable lifecycle (`followRuntimeOperationToEnd`) and says so (`kind: "followed"`); `409 resume_conflict` comes back as `kind: "resume_conflict"` (retry is host policy). Building blocks exported: `readLiveRunRequestId` (reads `live_request_id`, NEVER the envelope's own `request_id`), `readMatrxErrorCode`, `isResumeConflict`, `isLiveStreamUnavailable`, `runtimeOperationRejoinPath`, `openMatrxStream` (any NDJSON door by path), `withRunOrganization`. Guard: `matrx/rejoin.test.ts` (real envelopes with the `request_id` decoy; proven red on a mutant reading `request_id` and on one dropping the run org).
+- **`streamErrorText(event)`** — the text for a stream `error` event: `user_message` first (e.g. "OpenAI refused this request: the platform's OpenAI account is out of credit."), then `message`, else null. A host fallback must never replace a server message. `runAgentToCompletion` now uses it.
+- **`reportProviderSessionFailure(transport, failure)`** — browser-held provider sessions (OpenAI/xAI realtime voice, Cartesia TTS) report their failures to `POST /broker/provider-failures` and get `{ error_type, retryable, user_message }` back; the body is bounded exactly as the server model bounds it; never throws (null + warn when the report itself fails). Guard: `matrx/provider-failures.test.ts`.
+- Consumer action: replace hand-written `409 run_in_progress` → rejoin code with `resumeOrRejoin`; render stream `error` events with `streamErrorText`; call `reportProviderSessionFailure` from every realtime/Cartesia session error handler and show its `user_message`.
+
+## 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

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(