@ai-matrx/agents 0.59.151 → 0.59.153

package/CHANGELOG.md

@@ -1,10 +1,20 @@
 # Changelog
 
-## 0.59.151
+## 0.59.153
 
 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.151
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 0746898655 5f3243d496 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
+## 0.59.150
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 14c15decf1 0746898655 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
 ## 0.59.149
 
 Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 62116d54f1 14c15decf1 -- apps/shared/matrx-agents/src`

package/README.md

@@ -197,9 +197,9 @@ import { AgentCatalogProvider, AgentListDropdown } from "@ai-matrx/agents/catalo
 </AgentCatalogProvider>
 ```
 
-You get, on every surface and in every app: the complete catalogue read (owned
+You get, on every surface and in every app: the complete catalog read (owned
 + shared + org-shared + platform agents), Mine / Shared / All / Public tabs
-with live counts, sort, favourites (the caller's own stars, read and written in
+with live counts, sort, favorites (the caller's own stars, read and written in
 `platform.user_entity_state`), category and tag filters,
 local relevance scoring plus server-side search, the current agent pinned on
 top, per-row origin badges, a hover detail panel, a mobile drawer, and a footer
@@ -215,7 +215,7 @@ utilities are generated:
 
 **The default row.** Pass `defaultMandateKey` and the picker offers the
 platform default for that Mandate, resolved LIVE through the server and
-labelled with the Holder's real name — no client ever hardcodes an agent name
+labeled with the Holder's real name — no client ever hardcodes an agent name
 again. Its id is `mandate:<key>`. If the cached name and the live one disagree,
 the picker shows a persistent banner and calls your `notifier`.
 

package/dist/catalog/index.cjs

@@ -295,7 +295,7 @@ async function readAgentCatalogRows(client) {
   if (dropped > 0) {
     throw new AgentCatalogReadError(
       "agx_get_list_full",
-      `${dropped} row(s) came back without an id and were refused. A row that cannot be identified cannot be selected, so the catalogue is not trustworthy \u2014 check the RPC's return shape.`
+      `${dropped} row(s) came back without an id and were refused. A row that cannot be identified cannot be selected, so the catalog is not trustworthy \u2014 check the RPC's return shape.`
     );
   }
   return rows;
@@ -796,7 +796,7 @@ function createAgentCatalog(config) {
   if (!config.client || typeof config.client.rpc !== "function") {
     throw new AgentCatalogConfigError({
       code: "missing_client",
-      message: "createAgentCatalog needs a Supabase client \u2014 it IS the catalogue read",
+      message: "createAgentCatalog needs a Supabase client \u2014 it IS the catalog read",
       remedy: "pass `client` (a supabase-js client, or anything with rpc() and schema().from())"
     });
   }
@@ -836,7 +836,7 @@ function createAgentCatalog(config) {
   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`,
+      message: `your starred agents could not be read (${message}); every star is shown unset until the next catalog load`,
       context: { catalogId }
     });
   }
@@ -886,7 +886,7 @@ function createAgentCatalog(config) {
         anonymousReported = true;
         errorSink({
           code: "identity_unavailable",
-          message: "identity.requireUserId() threw, so the picker is treating this session as signed out and opening on the public catalogue. Favoriting is unavailable until a session exists.",
+          message: "identity.requireUserId() threw, so the picker is treating this session as signed out and opening on the public catalog. Favoriting is unavailable until a session exists.",
           context: { detail: errorMessage(e) }
         });
       }
@@ -924,7 +924,7 @@ function createAgentCatalog(config) {
       publish({ ...state, status: "failed", error: message });
       errorSink({
         code: "list_read_failed",
-        message: `the agent catalogue could not be read: ${message}`,
+        message: `the agent catalog could not be read: ${message}`,
         context: { catalogId }
       });
       throw e;
@@ -970,7 +970,7 @@ function createAgentCatalog(config) {
           pinnedFallbackReported = true;
           errorSink({
             code: "pinned_read_unsupported",
-            message: `the pinned-agents read fell back to the whole catalogue (${e.message}); pass a favorites port with list() and a supabase-js client`,
+            message: `the pinned-agents read fell back to the whole catalog (${e.message}); pass a favorites port with list() and a supabase-js client`,
             context: { catalogId }
           });
         }
@@ -1079,7 +1079,7 @@ function createAgentCatalog(config) {
     if (!existing) {
       errorSink({
         code: "favorite_unknown_agent",
-        message: `cannot favorite ${agentId}: it is not in this catalogue`
+        message: `cannot favorite ${agentId}: it is not in this catalog`
       });
       return;
     }

package/dist/catalog/index.d.cts

@@ -299,7 +299,7 @@ interface AgentCatalogRpcCall extends PromiseLike<PgResultLike> {
      * PostgREST's `in` filter on the function's result rows — how the pinned
      * read asks `agx_get_list_full` for just the starred ids (2026-10-09).
      * OPTIONAL in the structural type: a host bridge without it gets the whole
-     * catalogue instead, announced through the errorSink.
+     * catalog instead, announced through the errorSink.
      */
     in?(column: string, values: readonly string[]): AgentCatalogRpcCall;
 }
@@ -313,7 +313,7 @@ interface AgentCatalogRpcCall extends PromiseLike<PgResultLike> {
  * the public schema's functions, so a bridge never crashes the pickers.
  *
  * Absent → `createAgentCatalog` throws `AgentCatalogConfigError`. There is no
- * degraded mode: the package IS the catalogue read.
+ * degraded mode: the package IS the catalog read.
  */
 interface AgentCatalogClient {
     schema?(name: string): {
@@ -367,8 +367,8 @@ interface AgentCatalogFavorites {
     /**
      * Every state row the caller owns of one kind (`ues_list`). The pinned read
      * asks for `"favorite"` to learn WHICH agents to read, so a sidebar never
-     * pulls the whole catalogue to show a handful of stars. OPTIONAL: a port
-     * without it makes the pinned read fall back to the whole catalogue, loudly.
+     * pulls the whole catalog to show a handful of stars. OPTIONAL: a port
+     * without it makes the pinned read fall back to the whole catalog, loudly.
      */
     list?(kind?: "favorite" | "pinned" | "hidden"): Promise<{
         ok: true;
@@ -394,7 +394,7 @@ interface AgentCatalogFavorites {
  * `requireUserId` THROWS when there is no session — never a silent anonymous
  * read. The catalog catches that throw in exactly ONE place (the tab-default
  * heuristic, where a signed-out visitor legitimately lands on the public
- * catalogue) and reports it to the `errorSink` the first time; every other
+ * catalog) and reports it to the `errorSink` the first time; every other
  * caller lets it propagate.
  */
 interface AgentCatalogIdentity {
@@ -485,7 +485,7 @@ interface AgentCatalogLabels {
     emptyDefault: string;
     emptyShared: string;
     emptySystem: string;
-    /** Empty state for a signed-out visitor — there is no catalogue to read. */
+    /** Empty state for a signed-out visitor — there is no catalog to read. */
     emptySignedOut: string;
     loading: string;
     triggerFallback: string;
@@ -604,7 +604,7 @@ interface ResolvedDefaultRow {
     mandateKey: string;
     /** The `agent.definition` id the mandate resolved to. */
     holderId: string;
-    /** The holder's REAL name, read from the catalogue — never hardcoded. */
+    /** The holder's REAL name, read from the catalog — never hardcoded. */
     holderName: string;
     holderDescription: string | null;
     provenance: string;
@@ -716,7 +716,7 @@ interface AgentCatalogState {
     /**
      * The caller's starred rows (`ensureFavoriteRows`): `succeeded` once every
      * starred agent the caller can see is in `byId` — by the narrow pinned read
-     * or by a complete catalogue load, whichever came first.
+     * or by a complete catalog load, whichever came first.
      */
     favoriteRowsStatus: AgentCatalogStatus;
 }
@@ -741,17 +741,17 @@ interface AgentCatalog {
     /**
      * The signed-in user id, or `null` when there is no session. The ONE place
      * `identity.requireUserId()`'s throw is caught — a signed-out visitor
-     * legitimately lands on the public catalogue — and it is reported to the
+     * legitimately lands on the public catalog — and it is reported to the
      * errorSink the first time so it is never silent.
      */
     getUserIdOrNull(): string | null;
-    /** Load the catalogue if it is not fresh. Safe to call on every mount. */
+    /** Load the catalog if it is not fresh. Safe to call on every mount. */
     ensureLoaded(options?: {
         force?: boolean;
     }): Promise<void>;
     /**
      * Load ONLY the caller's starred agents into the registry (the pinned read —
-     * `ues_list` then `agx_get_list_full?id=in.(…)`), never the whole catalogue.
+     * `ues_list` then `agx_get_list_full?id=in.(…)`), never the whole catalog.
      * Answered at once when a complete load is fresh. Deduped; safe on every
      * mount. For surfaces that show stars without being a picker (a sidebar's
      * Pinned section): nothing loads the full list until a picker opens.
@@ -804,11 +804,11 @@ declare function getRegisteredAgentCatalog(catalogId?: string): AgentCatalog | u
  *
  * Every database call the catalog makes, and nothing else. Five of them:
  *
- *   1. `agx_get_list_full()` — the complete catalogue (owned + directly-shared
+ *   1. `agx_get_list_full()` — the complete catalog (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.
+ *      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.
@@ -817,12 +817,12 @@ declare function getRegisteredAgentCatalog(catalogId?: string): AgentCatalog | u
  *   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 catalogue to find them.
+ *      handful of rows; it never pays for the whole catalog 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
  * `fetchAgentsListFull` issued a bare `.rpc()` and would silently have
- * returned 1000 rows of a larger catalogue (the ~400-builtin truncation
+ * returned 1000 rows of a larger catalog (the ~400-builtin truncation
  * incident is the near-miss). Here the read goes through `readAllRows` with
  * `{ count: "exact" }` and a stable `.order("id")`, so a truncation is a
  * loud `IncompleteReadError` instead of a confidently short picker.
@@ -838,7 +838,7 @@ declare class AgentCatalogReadError extends Error {
     constructor(source: string, detail: string);
 }
 /**
- * Read the WHOLE agent catalogue. Throws rather than returning a partial
+ * Read the WHOLE agent catalog. Throws rather than returning a partial
  * list — see the file header.
  */
 declare function readAgentCatalogRows(client: AgentCatalogClient): Promise<AgentSummary[]>;
@@ -859,7 +859,7 @@ declare function searchAgentsOnServer(client: AgentCatalogClient, args: {
 }): Promise<AgentServerSearchResult>;
 /**
  * The single-agent read, used when a mandate's resolved Holder is not in the
- * caller's own catalogue (a platform agent nobody has shared, most often).
+ * caller's own catalog (a platform agent nobody has shared, most often).
  *
  * Two existing doors, in order — never a new RPC:
  *   1. `agx_search` with the id as the query. The scorer awards an exact id
@@ -942,7 +942,7 @@ declare function orchestraDelegatesLine(badge: OrchestraBadge, limit?: number):
  * What every client used to do: prepend a placeholder row whose id is
  * `mandate:<key>` and whose name and description are HARDCODED, and let the
  * server resolve the real Holder at run time. That is how matrx-local's row
- * came to be labelled "Matrx Desktop Agent" while `local.cloud_chat` actually
+ * came to be labeled "Matrx Desktop Agent" while `local.cloud_chat` actually
  * resolves to General Chat — a label lying on screen, with nothing anywhere
  * that could notice.
  *
@@ -957,8 +957,8 @@ declare function orchestraDelegatesLine(badge: OrchestraBadge, limit?: number):
  *     itself. It asks. That is why a `defaultMandateKey` with no transport is
  *     a loud config error and not a DB read.
  *   - The row renders the Holder's REAL name and description, read from the
- *     catalogue rows already in hand, or through ONE existing single-agent
- *     read when the Holder is not in this caller's catalogue.
+ *     catalog rows already in hand, or through ONE existing single-agent
+ *     read when the Holder is not in this caller's catalog.
  *   - The last resolution is cached in the `storage` port for first paint.
  *   - Whenever the cached row and the LIVE resolution disagree on holder id
  *     or holder name, the picker shows a PERSISTENT in-picker banner AND the
@@ -1038,7 +1038,7 @@ declare function resolveDefaultRow(args: ResolveDefaultRowArgs): Promise<Resolve
  * VERBATIM port of matrx-frontend `features/agents/constants/agent-list-labels.ts`.
  * The only seam inverted: the two label constants moved into the `labels` port
  * (`DEFAULT_AGENT_CATALOG_LABELS.publicTab` / `.publicBadge`) so a host can
- * override them; the FUNCTIONS below keep their exact behaviour.
+ * override them; the FUNCTIONS below keep their exact behavior.
  */
 
 declare function agentListEmptyLabel(tab: AgentTab, labels: AgentCatalogLabels): string;
@@ -1137,7 +1137,7 @@ declare function agentMatchesSearch(agent: AgentSearchable, query: string): bool
  *   F1 — every sort now ends on `id` ASC, the same final key `agx_get_list`
  *        ends on, so the order of TIED rows is defined by the rows instead of
  *        by whichever transport the host used to fetch them.
- *   F5 — the tab-badge counts honour the archive filter, so the badge, the
+ *   F5 — the tab-badge counts honor the archive filter, so the badge, the
  *        footer and the rendered rows are the same number.
  *
  * Everything else below is byte-identical to the original.
@@ -1148,7 +1148,7 @@ declare const AGENT_CARDS_LIMIT_MOBILE = 4;
 declare const AGENT_LIST_ITEMS_PER_PAGE = 20;
 /**
  * Last-arguments memoization on reference equality — reselect's default
- * `defaultMemoize` behaviour, in eleven lines and with no dependency. A
+ * `defaultMemoize` behavior, in eleven lines and with no dependency. A
  * selector built here is memoized PER INSTANCE, exactly like a
  * `createSelector` result, so the factories below keep their contract:
  * build the selector once per (consumerId, …) and reuse it.
@@ -1196,13 +1196,13 @@ declare const selectAllAgentTags: (a: readonly AgentSummary[]) => string[];
 declare const selectAllSystemAgentTags: (a: readonly AgentSummary[]) => string[];
 /** Live user-type agents (excludes builtins). */
 declare const selectUserTypeAgents: (a: readonly AgentSummary[]) => AgentSummary[];
-/** Builtin/system agents only. For chat pickers and full catalogues. */
+/** Builtin/system agents only. For chat pickers and full catalogs. */
 declare const selectBuiltinTypeAgents: (a: readonly AgentSummary[]) => AgentSummary[];
 /**
  * The ONE ordering rule, and it is TOTAL on every path.
  *
  *   searching:     score DESC → server rank ASC → sort key → id ASC
- *   not searching: favourites first (when asked) → sort key → id ASC
+ *   not searching: favorites first (when asked) → sort key → id ASC
  *
  * `id` ASC is the final key `agx_get_list` itself ends on, so two hosts that
  * fetched the same rows through different transports render the same screen.
@@ -1246,9 +1246,9 @@ declare const makeSelectFilteredSharedAgents: () => (a: readonly AgentSummary[],
  * all) draw from user-type agents; the system tab draws from builtins.
  *
  * `includeSystemInAll` is the ADMIN reading of the "All" tab. For a normal
- * user, system agents are a separate catalogue and "All" means "all of MY
+ * user, system agents are a separate catalog and "All" means "all of MY
  * agents". For an admin surface, system agents ARE their agents — so "All"
- * must be a single blended list, with each row still labelled (the `system`
+ * must be a single blended list, with each row still labeled (the `system`
  * badge on `AgentRow`) so the two are never confused.
  */
 declare const makeSelectFilteredAgents: (includeSystemInAll?: boolean) => (a: readonly AgentSummary[], b: AgentConsumerState) => AgentSummary[];
@@ -1282,7 +1282,7 @@ declare function agentConsumerHasActiveFilters(consumer: AgentConsumerState, def
  * footer said "412 agents" — one screen, three numbers, one of them a lie
  * about agents the user cannot see or reach from there.
  *
- * `is_archived` is now honoured by the same rule the list uses, so the badge,
+ * `is_archived` is now honored by the same rule the list uses, so the badge,
  * the footer and the rows agree on every tab and under every archive filter.
  *
  * 🚨 0.9.2 — AND THERE IS NO LONGER AN EXCEPTION. The system tab used to be

package/dist/catalog/index.d.ts

@@ -299,7 +299,7 @@ interface AgentCatalogRpcCall extends PromiseLike<PgResultLike> {
      * PostgREST's `in` filter on the function's result rows — how the pinned
      * read asks `agx_get_list_full` for just the starred ids (2026-10-09).
      * OPTIONAL in the structural type: a host bridge without it gets the whole
-     * catalogue instead, announced through the errorSink.
+     * catalog instead, announced through the errorSink.
      */
     in?(column: string, values: readonly string[]): AgentCatalogRpcCall;
 }
@@ -313,7 +313,7 @@ interface AgentCatalogRpcCall extends PromiseLike<PgResultLike> {
  * the public schema's functions, so a bridge never crashes the pickers.
  *
  * Absent → `createAgentCatalog` throws `AgentCatalogConfigError`. There is no
- * degraded mode: the package IS the catalogue read.
+ * degraded mode: the package IS the catalog read.
  */
 interface AgentCatalogClient {
     schema?(name: string): {
@@ -367,8 +367,8 @@ interface AgentCatalogFavorites {
     /**
      * Every state row the caller owns of one kind (`ues_list`). The pinned read
      * asks for `"favorite"` to learn WHICH agents to read, so a sidebar never
-     * pulls the whole catalogue to show a handful of stars. OPTIONAL: a port
-     * without it makes the pinned read fall back to the whole catalogue, loudly.
+     * pulls the whole catalog to show a handful of stars. OPTIONAL: a port
+     * without it makes the pinned read fall back to the whole catalog, loudly.
      */
     list?(kind?: "favorite" | "pinned" | "hidden"): Promise<{
         ok: true;
@@ -394,7 +394,7 @@ interface AgentCatalogFavorites {
  * `requireUserId` THROWS when there is no session — never a silent anonymous
  * read. The catalog catches that throw in exactly ONE place (the tab-default
  * heuristic, where a signed-out visitor legitimately lands on the public
- * catalogue) and reports it to the `errorSink` the first time; every other
+ * catalog) and reports it to the `errorSink` the first time; every other
  * caller lets it propagate.
  */
 interface AgentCatalogIdentity {
@@ -485,7 +485,7 @@ interface AgentCatalogLabels {
     emptyDefault: string;
     emptyShared: string;
     emptySystem: string;
-    /** Empty state for a signed-out visitor — there is no catalogue to read. */
+    /** Empty state for a signed-out visitor — there is no catalog to read. */
     emptySignedOut: string;
     loading: string;
     triggerFallback: string;
@@ -604,7 +604,7 @@ interface ResolvedDefaultRow {
     mandateKey: string;
     /** The `agent.definition` id the mandate resolved to. */
     holderId: string;
-    /** The holder's REAL name, read from the catalogue — never hardcoded. */
+    /** The holder's REAL name, read from the catalog — never hardcoded. */
     holderName: string;
     holderDescription: string | null;
     provenance: string;
@@ -716,7 +716,7 @@ interface AgentCatalogState {
     /**
      * The caller's starred rows (`ensureFavoriteRows`): `succeeded` once every
      * starred agent the caller can see is in `byId` — by the narrow pinned read
-     * or by a complete catalogue load, whichever came first.
+     * or by a complete catalog load, whichever came first.
      */
     favoriteRowsStatus: AgentCatalogStatus;
 }
@@ -741,17 +741,17 @@ interface AgentCatalog {
     /**
      * The signed-in user id, or `null` when there is no session. The ONE place
      * `identity.requireUserId()`'s throw is caught — a signed-out visitor
-     * legitimately lands on the public catalogue — and it is reported to the
+     * legitimately lands on the public catalog — and it is reported to the
      * errorSink the first time so it is never silent.
      */
     getUserIdOrNull(): string | null;
-    /** Load the catalogue if it is not fresh. Safe to call on every mount. */
+    /** Load the catalog if it is not fresh. Safe to call on every mount. */
     ensureLoaded(options?: {
         force?: boolean;
     }): Promise<void>;
     /**
      * Load ONLY the caller's starred agents into the registry (the pinned read —
-     * `ues_list` then `agx_get_list_full?id=in.(…)`), never the whole catalogue.
+     * `ues_list` then `agx_get_list_full?id=in.(…)`), never the whole catalog.
      * Answered at once when a complete load is fresh. Deduped; safe on every
      * mount. For surfaces that show stars without being a picker (a sidebar's
      * Pinned section): nothing loads the full list until a picker opens.
@@ -804,11 +804,11 @@ declare function getRegisteredAgentCatalog(catalogId?: string): AgentCatalog | u
  *
  * Every database call the catalog makes, and nothing else. Five of them:
  *
- *   1. `agx_get_list_full()` — the complete catalogue (owned + directly-shared
+ *   1. `agx_get_list_full()` — the complete catalog (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.
+ *      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.
@@ -817,12 +817,12 @@ declare function getRegisteredAgentCatalog(catalogId?: string): AgentCatalog | u
  *   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 catalogue to find them.
+ *      handful of rows; it never pays for the whole catalog 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
  * `fetchAgentsListFull` issued a bare `.rpc()` and would silently have
- * returned 1000 rows of a larger catalogue (the ~400-builtin truncation
+ * returned 1000 rows of a larger catalog (the ~400-builtin truncation
  * incident is the near-miss). Here the read goes through `readAllRows` with
  * `{ count: "exact" }` and a stable `.order("id")`, so a truncation is a
  * loud `IncompleteReadError` instead of a confidently short picker.
@@ -838,7 +838,7 @@ declare class AgentCatalogReadError extends Error {
     constructor(source: string, detail: string);
 }
 /**
- * Read the WHOLE agent catalogue. Throws rather than returning a partial
+ * Read the WHOLE agent catalog. Throws rather than returning a partial
  * list — see the file header.
  */
 declare function readAgentCatalogRows(client: AgentCatalogClient): Promise<AgentSummary[]>;
@@ -859,7 +859,7 @@ declare function searchAgentsOnServer(client: AgentCatalogClient, args: {
 }): Promise<AgentServerSearchResult>;
 /**
  * The single-agent read, used when a mandate's resolved Holder is not in the
- * caller's own catalogue (a platform agent nobody has shared, most often).
+ * caller's own catalog (a platform agent nobody has shared, most often).
  *
  * Two existing doors, in order — never a new RPC:
  *   1. `agx_search` with the id as the query. The scorer awards an exact id
@@ -942,7 +942,7 @@ declare function orchestraDelegatesLine(badge: OrchestraBadge, limit?: number):
  * What every client used to do: prepend a placeholder row whose id is
  * `mandate:<key>` and whose name and description are HARDCODED, and let the
  * server resolve the real Holder at run time. That is how matrx-local's row
- * came to be labelled "Matrx Desktop Agent" while `local.cloud_chat` actually
+ * came to be labeled "Matrx Desktop Agent" while `local.cloud_chat` actually
  * resolves to General Chat — a label lying on screen, with nothing anywhere
  * that could notice.
  *
@@ -957,8 +957,8 @@ declare function orchestraDelegatesLine(badge: OrchestraBadge, limit?: number):
  *     itself. It asks. That is why a `defaultMandateKey` with no transport is
  *     a loud config error and not a DB read.
  *   - The row renders the Holder's REAL name and description, read from the
- *     catalogue rows already in hand, or through ONE existing single-agent
- *     read when the Holder is not in this caller's catalogue.
+ *     catalog rows already in hand, or through ONE existing single-agent
+ *     read when the Holder is not in this caller's catalog.
  *   - The last resolution is cached in the `storage` port for first paint.
  *   - Whenever the cached row and the LIVE resolution disagree on holder id
  *     or holder name, the picker shows a PERSISTENT in-picker banner AND the
@@ -1038,7 +1038,7 @@ declare function resolveDefaultRow(args: ResolveDefaultRowArgs): Promise<Resolve
  * VERBATIM port of matrx-frontend `features/agents/constants/agent-list-labels.ts`.
  * The only seam inverted: the two label constants moved into the `labels` port
  * (`DEFAULT_AGENT_CATALOG_LABELS.publicTab` / `.publicBadge`) so a host can
- * override them; the FUNCTIONS below keep their exact behaviour.
+ * override them; the FUNCTIONS below keep their exact behavior.
  */
 
 declare function agentListEmptyLabel(tab: AgentTab, labels: AgentCatalogLabels): string;
@@ -1137,7 +1137,7 @@ declare function agentMatchesSearch(agent: AgentSearchable, query: string): bool
  *   F1 — every sort now ends on `id` ASC, the same final key `agx_get_list`
  *        ends on, so the order of TIED rows is defined by the rows instead of
  *        by whichever transport the host used to fetch them.
- *   F5 — the tab-badge counts honour the archive filter, so the badge, the
+ *   F5 — the tab-badge counts honor the archive filter, so the badge, the
  *        footer and the rendered rows are the same number.
  *
  * Everything else below is byte-identical to the original.
@@ -1148,7 +1148,7 @@ declare const AGENT_CARDS_LIMIT_MOBILE = 4;
 declare const AGENT_LIST_ITEMS_PER_PAGE = 20;
 /**
  * Last-arguments memoization on reference equality — reselect's default
- * `defaultMemoize` behaviour, in eleven lines and with no dependency. A
+ * `defaultMemoize` behavior, in eleven lines and with no dependency. A
  * selector built here is memoized PER INSTANCE, exactly like a
  * `createSelector` result, so the factories below keep their contract:
  * build the selector once per (consumerId, …) and reuse it.
@@ -1196,13 +1196,13 @@ declare const selectAllAgentTags: (a: readonly AgentSummary[]) => string[];
 declare const selectAllSystemAgentTags: (a: readonly AgentSummary[]) => string[];
 /** Live user-type agents (excludes builtins). */
 declare const selectUserTypeAgents: (a: readonly AgentSummary[]) => AgentSummary[];
-/** Builtin/system agents only. For chat pickers and full catalogues. */
+/** Builtin/system agents only. For chat pickers and full catalogs. */
 declare const selectBuiltinTypeAgents: (a: readonly AgentSummary[]) => AgentSummary[];
 /**
  * The ONE ordering rule, and it is TOTAL on every path.
  *
  *   searching:     score DESC → server rank ASC → sort key → id ASC
- *   not searching: favourites first (when asked) → sort key → id ASC
+ *   not searching: favorites first (when asked) → sort key → id ASC
  *
  * `id` ASC is the final key `agx_get_list` itself ends on, so two hosts that
  * fetched the same rows through different transports render the same screen.
@@ -1246,9 +1246,9 @@ declare const makeSelectFilteredSharedAgents: () => (a: readonly AgentSummary[],
  * all) draw from user-type agents; the system tab draws from builtins.
  *
  * `includeSystemInAll` is the ADMIN reading of the "All" tab. For a normal
- * user, system agents are a separate catalogue and "All" means "all of MY
+ * user, system agents are a separate catalog and "All" means "all of MY
  * agents". For an admin surface, system agents ARE their agents — so "All"
- * must be a single blended list, with each row still labelled (the `system`
+ * must be a single blended list, with each row still labeled (the `system`
  * badge on `AgentRow`) so the two are never confused.
  */
 declare const makeSelectFilteredAgents: (includeSystemInAll?: boolean) => (a: readonly AgentSummary[], b: AgentConsumerState) => AgentSummary[];
@@ -1282,7 +1282,7 @@ declare function agentConsumerHasActiveFilters(consumer: AgentConsumerState, def
  * footer said "412 agents" — one screen, three numbers, one of them a lie
  * about agents the user cannot see or reach from there.
  *
- * `is_archived` is now honoured by the same rule the list uses, so the badge,
+ * `is_archived` is now honored by the same rule the list uses, so the badge,
  * the footer and the rows agree on every tab and under every archive filter.
  *
  * 🚨 0.9.2 — AND THERE IS NO LONGER AN EXCEPTION. The system tab used to be

package/dist/catalog/index.js

@@ -189,7 +189,7 @@ async function readAgentCatalogRows(client) {
   if (dropped > 0) {
     throw new AgentCatalogReadError(
       "agx_get_list_full",
-      `${dropped} row(s) came back without an id and were refused. A row that cannot be identified cannot be selected, so the catalogue is not trustworthy \u2014 check the RPC's return shape.`
+      `${dropped} row(s) came back without an id and were refused. A row that cannot be identified cannot be selected, so the catalog is not trustworthy \u2014 check the RPC's return shape.`
     );
   }
   return rows;
@@ -690,7 +690,7 @@ function createAgentCatalog(config) {
   if (!config.client || typeof config.client.rpc !== "function") {
     throw new AgentCatalogConfigError({
       code: "missing_client",
-      message: "createAgentCatalog needs a Supabase client \u2014 it IS the catalogue read",
+      message: "createAgentCatalog needs a Supabase client \u2014 it IS the catalog read",
       remedy: "pass `client` (a supabase-js client, or anything with rpc() and schema().from())"
     });
   }
@@ -730,7 +730,7 @@ function createAgentCatalog(config) {
   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`,
+      message: `your starred agents could not be read (${message}); every star is shown unset until the next catalog load`,
       context: { catalogId }
     });
   }
@@ -780,7 +780,7 @@ function createAgentCatalog(config) {
         anonymousReported = true;
         errorSink({
           code: "identity_unavailable",
-          message: "identity.requireUserId() threw, so the picker is treating this session as signed out and opening on the public catalogue. Favoriting is unavailable until a session exists.",
+          message: "identity.requireUserId() threw, so the picker is treating this session as signed out and opening on the public catalog. Favoriting is unavailable until a session exists.",
           context: { detail: errorMessage(e) }
         });
       }
@@ -818,7 +818,7 @@ function createAgentCatalog(config) {
       publish({ ...state, status: "failed", error: message });
       errorSink({
         code: "list_read_failed",
-        message: `the agent catalogue could not be read: ${message}`,
+        message: `the agent catalog could not be read: ${message}`,
         context: { catalogId }
       });
       throw e;
@@ -864,7 +864,7 @@ function createAgentCatalog(config) {
           pinnedFallbackReported = true;
           errorSink({
             code: "pinned_read_unsupported",
-            message: `the pinned-agents read fell back to the whole catalogue (${e.message}); pass a favorites port with list() and a supabase-js client`,
+            message: `the pinned-agents read fell back to the whole catalog (${e.message}); pass a favorites port with list() and a supabase-js client`,
             context: { catalogId }
           });
         }
@@ -973,7 +973,7 @@ function createAgentCatalog(config) {
     if (!existing) {
       errorSink({
         code: "favorite_unknown_agent",
-        message: `cannot favorite ${agentId}: it is not in this catalogue`
+        message: `cannot favorite ${agentId}: it is not in this catalog`
       });
       return;
     }

package/dist/catalog/native/index.cjs

@@ -1205,7 +1205,7 @@ var SHAPES = {
   /**
    * THE ARCHIVE GLYPH (Lucide `archive`) — the ONE mark of the platform
    * archive filter, drawn identically in every Matrx client so the control a
-   * person learns on one surface is recognisable on all of them.
+   * person learns on one surface is recognizable on all of them.
    */
   archive: {
     paths: [