@ai-matrx/agents 0.9.0 → 0.9.2

package/dist/catalog/index.d.cts

@@ -1,5 +1,5 @@
-import { A as AgentSummary, a as AgentCatalogClient, b as AgentCatalogTransport, c as AgentCatalogStorageLike, d as AgentCatalogErrorSink, R as ResolvedDefaultRow, e as AgentCatalogStorage, M as MandateResolutionVerdict, f as AgentTab, g as AgentCatalogLabels, h as AgentConsumerState, i as AgentSortOption } from '../orchestra-BWJM2MWP.cjs';
-export { j as AGENT_NONE_SENTINEL, k as AgentAccessFilter, l as AgentAccessLevel, m as AgentArchFilter, n as AgentCatalog, o as AgentCatalogAgentType, p as AgentCatalogAsyncStorage, q as AgentCatalogConfig, r as AgentCatalogConfigError, s as AgentCatalogIdentity, t as AgentCatalogNavigate, u as AgentCatalogNotifier, v as AgentCatalogOpenPeek, w as AgentCatalogResolveHref, x as AgentCatalogRpcCall, y as AgentCatalogSchemaReport, z as AgentCatalogState, B as AgentCatalogStatus, C as AgentCatalogTableQuery, D as AgentConsumerPatch, E as AgentFavFilter, F as AgentId, G as AssertAgentCatalogSchemaOptions, H as DEFAULT_AGENT_CATALOG_LABELS, I as DEFAULT_AGENT_CONSUMER_STATE, J as DefaultRowState, O as OrchestraBadge, P as PgErrorLike, K as PgResultLike, S as SORT_OPTIONS, L as asAgentId, N as assertAgentCatalogSchema, Q as createAgentCatalog, T as getRegisteredAgentCatalog, U as isMandateAgentId, V as mandateAgentId, W as orchestraDelegatesLine, X as orchestraDepthLine, Y as orchestraLabel, Z as orchestraModeLabel } from '../orchestra-BWJM2MWP.cjs';
+import { A as AgentSummary, a as AgentCatalogClient, b as AgentCatalogTransport, c as AgentCatalogStorageLike, d as AgentCatalogErrorSink, R as ResolvedDefaultRow, e as AgentCatalogStorage, M as MandateResolutionVerdict, f as AgentArchFilter, g as AgentTab, h as AgentCatalogLabels, i as AgentConsumerState, j as AgentSortOption } from '../orchestra-DljbEiks.cjs';
+export { k as AGENT_NONE_SENTINEL, l as ARCHIVE_FILTER_OPTIONS, m as ARCHIVE_FILTER_ORDER, n as AgentAccessFilter, o as AgentAccessLevel, p as AgentArchFilterOption, q as AgentCatalog, r as AgentCatalogAgentType, s as AgentCatalogAsyncStorage, t as AgentCatalogConfig, u as AgentCatalogConfigError, v as AgentCatalogDefaults, w as AgentCatalogIdentity, x as AgentCatalogNavigate, y as AgentCatalogNotifier, z as AgentCatalogOpenPeek, B as AgentCatalogResolveHref, C as AgentCatalogRpcCall, D as AgentCatalogSchemaReport, E as AgentCatalogState, F as AgentCatalogStatus, G as AgentCatalogTableQuery, H as AgentConsumerPatch, I as AgentFavFilter, J as AgentId, K as AssertAgentCatalogSchemaOptions, L as DEFAULT_AGENT_CATALOG_LABELS, N as DEFAULT_AGENT_CONSUMER_STATE, O as DefaultRowState, P as OrchestraBadge, Q as PgErrorLike, S as PgResultLike, T as SORT_OPTIONS, U as asAgentId, V as assertAgentCatalogSchema, W as createAgentCatalog, X as getRegisteredAgentCatalog, Y as isAgentArchFilter, Z as isMandateAgentId, _ as mandateAgentId, $ as nextArchFilter, a0 as orchestraDelegatesLine, a1 as orchestraDepthLine, a2 as orchestraLabel, a3 as orchestraModeLabel } from '../orchestra-DljbEiks.cjs';
 
 /**
  * catalog/data.ts — @ai-matrx/agents/catalog
@@ -206,6 +206,36 @@ declare function shouldDefaultAgentListToPublicTab(args: {
     ownedCount: number;
     agentsLoaded: boolean;
 }): boolean;
+/** What the filter-bar chip reads in each state. */
+declare function agentArchiveFilterChipLabel(archFilter: AgentArchFilter): string;
+/** The platform's words for the state — menus, aria-labels, help text. */
+declare function agentArchiveFilterStateLabel(archFilter: AgentArchFilter): string;
+/**
+ * The accessible name of the ONE control, always naming the state it is IN
+ * and the state one click moves it to. A control whose label does not say
+ * what it currently does is the "dead or dishonest" shape the platform bans.
+ */
+declare function agentArchiveFilterControlLabel(archFilter: AgentArchFilter): string;
+/**
+ * THE FOOTER. It counts exactly what the list rendered and, whenever archived
+ * rows are involved, says so — hidden ones included.
+ *
+ *   hide archived, nothing archived behind it → "412 agents"
+ *   hide archived, 4 archived behind it       → "412 agents · 4 archived hidden"
+ *   show all                                  → "416 agents · archived shown"
+ *   archived only                             → "4 archived shown"
+ */
+declare function agentListFooterLabel(args: {
+    /** Rows actually rendered. */
+    count: number;
+    archFilter: AgentArchFilter;
+    /**
+     * Rows this view WOULD render if the filter were flipped to "archived only"
+     * — exactly what the default state is keeping off the screen. Only ever
+     * read in the `active` state.
+     */
+    archivedHiddenCount: number;
+}): string;
 
 /**
  * The structural shape a record needs to be searchable. Every field except
@@ -257,7 +287,18 @@ declare function agentMatchesSearch(agent: AgentSearchable, query: string): bool
  * frontend's `selectLiveAgents` filters `isVersion` snapshots out of a store
  * that also holds them. This catalog only ever holds list rows — a version
  * snapshot cannot enter it — so that filter is a no-op here and is not
- * ported. Every ordering, tie-break and count below is byte-identical.
+ * ported.
+ *
+ * 🚨 TWO DELIBERATE DEPARTURES FROM THE ORIGINAL, both defects the port
+ * inherited and 0.9.1 fixes at the class (see CHANGELOG 0.9.1):
+ *
+ *   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
+ *        footer and the rendered rows are the same number.
+ *
+ * Everything else below is byte-identical to the original.
  */
 
 declare const AGENT_CARDS_LIMIT_DESKTOP = 8;
@@ -273,6 +314,31 @@ declare const AGENT_LIST_ITEMS_PER_PAGE = 20;
 declare function memoize1<A, R>(fn: (a: A) => R): (a: A) => R;
 declare function memoize2<A, B, R>(fn: (a: A, b: B) => R): (a: A, b: B) => R;
 declare function memoize3<A, B, C, R>(fn: (a: A, b: B, c: C) => R): (a: A, b: B, c: C) => R;
+/**
+ * 🚨 THE FINAL TIEBREAKER. `agx_get_list` orders
+ * `is_favorite DESC, updated_at DESC, id` — `id` ASCENDING is the unique key
+ * that makes the SERVER's order TOTAL. Every sort in this file ends on the
+ * same key, so the rendered order is a function of the ROWS and never of the
+ * order they happened to arrive in.
+ *
+ * Why a raw `<` / `>` and not `localeCompare`: Postgres orders `uuid` by its
+ * 16 raw bytes. The canonical text form is lowercase hex with dashes at fixed
+ * positions, so a codepoint comparison of those strings reproduces the
+ * database's order exactly. A locale collator does not — it is free to fold
+ * case or ignore punctuation, and would silently diverge from the server on
+ * precisely the ties this key exists to settle.
+ */
+declare function compareAgentIds(a: AgentSummary, b: AgentSummary): number;
+/**
+ * The chosen sort key, then `id`. TOTAL for every option.
+ *
+ * Before 0.9.1 each branch below returned 0 for tied rows, which left their
+ * relative order to whatever `Array.prototype.sort` had been handed — i.e. to
+ * the transport. A host that fetched the RPC in one shot kept the server's
+ * favourites-first/`updated_at DESC` order for ties; a host that paged it with
+ * `order=id.asc` kept id-ASC. Same rows, same filters, two different screens.
+ * The key below is the server's own, so both now render the server's answer.
+ */
 declare function applyAgentSortComparator(a: AgentSummary, b: AgentSummary, sortBy: AgentSortOption): number;
 /** All unique categories across live USER agents, sorted alphabetically. */
 declare const selectAllAgentCategories: (a: readonly AgentSummary[]) => string[];
@@ -290,6 +356,15 @@ declare const selectAllSystemAgentTags: (a: readonly AgentSummary[]) => string[]
 declare const selectUserTypeAgents: (a: readonly AgentSummary[]) => AgentSummary[];
 /** Builtin/system agents only. For chat pickers and full catalogues. */
 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
+ *
+ * `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.
+ */
 declare function sortFilteredAgents(filtered: AgentSummary[], consumer: AgentConsumerState): AgentSummary[];
 /** User-type agents — mine / shared / all tabs with full consumer filters. */
 declare function filterUserTypeAgents(agents: readonly AgentSummary[], consumer: AgentConsumerState): AgentSummary[];
@@ -297,10 +372,27 @@ declare function filterUserTypeAgents(agents: readonly AgentSummary[], consumer:
  * Builtin/system agents (tab === "system").
  *
  * Gets the SAME filter surface every other tab has — search, favorites,
- * category, tags, sort. Ownership/archive/access filters are meaningless here
- * (a builtin is always active and belongs to the platform), so those are the
- * only ones skipped. A picker that offers less on one tab than another is the
- * exact half-built shape this list exists to prevent.
+ * category, tags, sort, AND THE ARCHIVE FILTER. Only the ownership/access
+ * filters are skipped, because a builtin has no owner to filter on. A picker
+ * that offers less on one tab than another is the exact half-built shape this
+ * list exists to prevent.
+ *
+ * 🚨 0.9.2 — THE BUILTIN ARCHIVE EXEMPTION IS GONE, AND IT IS NOW ILLEGAL.
+ *
+ * Until 0.9.1 this function applied no archive filter, on the theory that "a
+ * builtin belongs to the platform and is never the user's to archive". The
+ * database disagreed: `Foundry Planner`
+ * (`001b22f6-fa4d-40c6-a1a4-8575d4d04379`) is an ARCHIVED builtin, and it
+ * rendered at Public index 216 and was pickable — while Mine / Shared / All
+ * hid their archived rows. One picker, two rules, and a person could choose a
+ * retired agent from the one tab that did not obey.
+ *
+ * THE ARCHIVED-ITEMS LAW (`common-docs/policies/archived-items.md`, Arman
+ * 2026-09-09) closed the question for every entity at once: "everything should
+ * have an archive filter, and the default should always hide archived… all
+ * archived items should always be treated the same." Clause 4 makes it a
+ * class, not an instance — so there is no per-tab, per-entity or per-surface
+ * exemption left to grant, here or anywhere.
  */
 declare function filterBuiltinTypeAgents(agents: readonly AgentSummary[], consumer: AgentConsumerState): AgentSummary[];
 /** Factory: owned user-type agents with consumer filters applied (ignores tab). */
@@ -339,9 +431,47 @@ declare const makeSelectFilteredAgentsCount: () => (a: readonly AgentSummary[],
 declare const makeSelectFilteredBuiltinAgentsCount: () => (a: readonly AgentSummary[], b: AgentConsumerState) => number;
 /** Returns whether a consumer has any non-default filters active. */
 declare function agentConsumerHasActiveFilters(consumer: AgentConsumerState, defaults: AgentConsumerState): boolean;
+/**
+ * 🚨 A BADGE COUNTS WHAT THE TAB RENDERS. Nothing else.
+ *
+ * Before 0.9.1 these five counted every user-type row, archived included,
+ * while `filterUserTypeAgents` (archive filter `active`, the default) hid the
+ * archived ones. The badge said "Mine 416", the list showed 412 rows and the
+ * 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,
+ * 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
+ * one ("a builtin is never the user's to archive"), which was false in the
+ * database and illegal under THE ARCHIVED-ITEMS LAW. Its badge now counts
+ * under the same archive rule its rows render under, so `Foundry Planner`
+ * leaves the Public badge and the Public list together, or returns to both
+ * together — never one without the other.
+ */
+declare function agentMatchesArchiveFilter(agent: AgentSummary, archFilter: AgentArchFilter): boolean;
+/**
+ * The four tab badges for a consumer's CURRENT archive filter — the numbers
+ * `useAgentListCore` puts on the tab strip. Flip the archive filter to
+ * "archived" and the badges follow the list into the archive.
+ */
+declare const selectAgentTabCounts: (a: readonly AgentSummary[], b: AgentArchFilter) => {
+    mine: number;
+    shared: number;
+    all: number;
+    system: number;
+};
+/** Live user-type agents the default (`active`) list renders. */
 declare const selectTotalUserAgentsCount: (a: readonly AgentSummary[]) => number;
 declare const selectTotalOwnedAgentsCount: (a: readonly AgentSummary[]) => number;
 declare const selectTotalSharedAgentsCount: (a: readonly AgentSummary[]) => number;
+/**
+ * Live builtin agents the DEFAULT (`active`) list renders — archived builtins
+ * excluded, exactly like every other "total" beside it. Before 0.9.2 this
+ * counted archived builtins too, which is how an archived `Foundry Planner`
+ * reached the Public badge.
+ */
 declare const selectTotalBuiltinAgentsCount: (a: readonly AgentSummary[]) => number;
 declare const selectTotalFavoriteAgentsCount: (a: readonly AgentSummary[]) => number;
 
@@ -361,4 +491,4 @@ declare const selectTotalFavoriteAgentsCount: (a: readonly AgentSummary[]) => nu
 /** @internal Test-only: forget every session-shared value. */
 declare function _resetCatalogGlobalState(): void;
 
-export { AGENT_CARDS_LIMIT_DESKTOP, AGENT_CARDS_LIMIT_MOBILE, AGENT_LIST_ITEMS_PER_PAGE, AGENT_SEARCH_LIMIT, AgentCatalogClient, AgentCatalogErrorSink, AgentCatalogLabels, AgentCatalogReadError, AgentCatalogStorage, AgentCatalogStorageLike, AgentCatalogTransport, AgentConsumerState, type AgentListPage, type AgentSearchable, type AgentServerSearchResult, AgentSortOption, AgentSummary, AgentTab, MandateDefaultRowError, MandateResolutionVerdict, type ResolveDefaultRowArgs, type ResolveDefaultRowOutcome, ResolvedDefaultRow, _resetCatalogGlobalState, agentConsumerHasActiveFilters, agentListEmptyLabel, agentMatchesSearch, applyAgentSortComparator, computeAgentSearchScore, createMemoryStorage, defaultRowFromResolution, defaultStorage, detectDefaultRowDrift, filterBuiltinTypeAgents, filterUserTypeAgents, makeSelectFilteredAgents, makeSelectFilteredAgentsCount, makeSelectFilteredBuiltinAgents, makeSelectFilteredBuiltinAgentsCount, makeSelectFilteredOwnedAgents, makeSelectFilteredSharedAgents, makeSelectOwnedAgentCards, makeSelectOwnedAgentListItems, makeSelectSharedAgentCards, makeSelectSharedAgentListItems, memoize1, memoize2, memoize3, parseMandateResolution, readAgentCatalogRows, readCachedDefaultRow, readCachedDefaultRowAsync, readSingleAgentRow, resolveDefaultRow, searchAgentsOnServer, selectAllAgentCategories, selectAllAgentTags, selectAllSystemAgentCategories, selectAllSystemAgentTags, selectBuiltinTypeAgents, selectTotalBuiltinAgentsCount, selectTotalFavoriteAgentsCount, selectTotalOwnedAgentsCount, selectTotalSharedAgentsCount, selectTotalUserAgentsCount, selectUserTypeAgents, shouldDefaultAgentListToPublicTab, sortFilteredAgents, toAgentSummary, writeAgentFavorite, writeCachedDefaultRow, writeCachedDefaultRowAsync };
+export { AGENT_CARDS_LIMIT_DESKTOP, AGENT_CARDS_LIMIT_MOBILE, AGENT_LIST_ITEMS_PER_PAGE, AGENT_SEARCH_LIMIT, AgentArchFilter, AgentCatalogClient, AgentCatalogErrorSink, AgentCatalogLabels, AgentCatalogReadError, AgentCatalogStorage, AgentCatalogStorageLike, AgentCatalogTransport, AgentConsumerState, type AgentListPage, type AgentSearchable, type AgentServerSearchResult, AgentSortOption, AgentSummary, AgentTab, MandateDefaultRowError, MandateResolutionVerdict, type ResolveDefaultRowArgs, type ResolveDefaultRowOutcome, ResolvedDefaultRow, _resetCatalogGlobalState, agentArchiveFilterChipLabel, agentArchiveFilterControlLabel, agentArchiveFilterStateLabel, agentConsumerHasActiveFilters, agentListEmptyLabel, agentListFooterLabel, agentMatchesArchiveFilter, agentMatchesSearch, applyAgentSortComparator, compareAgentIds, computeAgentSearchScore, createMemoryStorage, defaultRowFromResolution, defaultStorage, detectDefaultRowDrift, filterBuiltinTypeAgents, filterUserTypeAgents, makeSelectFilteredAgents, makeSelectFilteredAgentsCount, makeSelectFilteredBuiltinAgents, makeSelectFilteredBuiltinAgentsCount, makeSelectFilteredOwnedAgents, makeSelectFilteredSharedAgents, makeSelectOwnedAgentCards, makeSelectOwnedAgentListItems, makeSelectSharedAgentCards, makeSelectSharedAgentListItems, memoize1, memoize2, memoize3, parseMandateResolution, readAgentCatalogRows, readCachedDefaultRow, readCachedDefaultRowAsync, readSingleAgentRow, resolveDefaultRow, searchAgentsOnServer, selectAgentTabCounts, selectAllAgentCategories, selectAllAgentTags, selectAllSystemAgentCategories, selectAllSystemAgentTags, selectBuiltinTypeAgents, selectTotalBuiltinAgentsCount, selectTotalFavoriteAgentsCount, selectTotalOwnedAgentsCount, selectTotalSharedAgentsCount, selectTotalUserAgentsCount, selectUserTypeAgents, shouldDefaultAgentListToPublicTab, sortFilteredAgents, toAgentSummary, writeAgentFavorite, writeCachedDefaultRow, writeCachedDefaultRowAsync };

package/dist/catalog/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentSummary, a as AgentCatalogClient, b as AgentCatalogTransport, c as AgentCatalogStorageLike, d as AgentCatalogErrorSink, R as ResolvedDefaultRow, e as AgentCatalogStorage, M as MandateResolutionVerdict, f as AgentTab, g as AgentCatalogLabels, h as AgentConsumerState, i as AgentSortOption } from '../orchestra-BWJM2MWP.js';
-export { j as AGENT_NONE_SENTINEL, k as AgentAccessFilter, l as AgentAccessLevel, m as AgentArchFilter, n as AgentCatalog, o as AgentCatalogAgentType, p as AgentCatalogAsyncStorage, q as AgentCatalogConfig, r as AgentCatalogConfigError, s as AgentCatalogIdentity, t as AgentCatalogNavigate, u as AgentCatalogNotifier, v as AgentCatalogOpenPeek, w as AgentCatalogResolveHref, x as AgentCatalogRpcCall, y as AgentCatalogSchemaReport, z as AgentCatalogState, B as AgentCatalogStatus, C as AgentCatalogTableQuery, D as AgentConsumerPatch, E as AgentFavFilter, F as AgentId, G as AssertAgentCatalogSchemaOptions, H as DEFAULT_AGENT_CATALOG_LABELS, I as DEFAULT_AGENT_CONSUMER_STATE, J as DefaultRowState, O as OrchestraBadge, P as PgErrorLike, K as PgResultLike, S as SORT_OPTIONS, L as asAgentId, N as assertAgentCatalogSchema, Q as createAgentCatalog, T as getRegisteredAgentCatalog, U as isMandateAgentId, V as mandateAgentId, W as orchestraDelegatesLine, X as orchestraDepthLine, Y as orchestraLabel, Z as orchestraModeLabel } from '../orchestra-BWJM2MWP.js';
+import { A as AgentSummary, a as AgentCatalogClient, b as AgentCatalogTransport, c as AgentCatalogStorageLike, d as AgentCatalogErrorSink, R as ResolvedDefaultRow, e as AgentCatalogStorage, M as MandateResolutionVerdict, f as AgentArchFilter, g as AgentTab, h as AgentCatalogLabels, i as AgentConsumerState, j as AgentSortOption } from '../orchestra-DljbEiks.js';
+export { k as AGENT_NONE_SENTINEL, l as ARCHIVE_FILTER_OPTIONS, m as ARCHIVE_FILTER_ORDER, n as AgentAccessFilter, o as AgentAccessLevel, p as AgentArchFilterOption, q as AgentCatalog, r as AgentCatalogAgentType, s as AgentCatalogAsyncStorage, t as AgentCatalogConfig, u as AgentCatalogConfigError, v as AgentCatalogDefaults, w as AgentCatalogIdentity, x as AgentCatalogNavigate, y as AgentCatalogNotifier, z as AgentCatalogOpenPeek, B as AgentCatalogResolveHref, C as AgentCatalogRpcCall, D as AgentCatalogSchemaReport, E as AgentCatalogState, F as AgentCatalogStatus, G as AgentCatalogTableQuery, H as AgentConsumerPatch, I as AgentFavFilter, J as AgentId, K as AssertAgentCatalogSchemaOptions, L as DEFAULT_AGENT_CATALOG_LABELS, N as DEFAULT_AGENT_CONSUMER_STATE, O as DefaultRowState, P as OrchestraBadge, Q as PgErrorLike, S as PgResultLike, T as SORT_OPTIONS, U as asAgentId, V as assertAgentCatalogSchema, W as createAgentCatalog, X as getRegisteredAgentCatalog, Y as isAgentArchFilter, Z as isMandateAgentId, _ as mandateAgentId, $ as nextArchFilter, a0 as orchestraDelegatesLine, a1 as orchestraDepthLine, a2 as orchestraLabel, a3 as orchestraModeLabel } from '../orchestra-DljbEiks.js';
 
 /**
  * catalog/data.ts — @ai-matrx/agents/catalog
@@ -206,6 +206,36 @@ declare function shouldDefaultAgentListToPublicTab(args: {
     ownedCount: number;
     agentsLoaded: boolean;
 }): boolean;
+/** What the filter-bar chip reads in each state. */
+declare function agentArchiveFilterChipLabel(archFilter: AgentArchFilter): string;
+/** The platform's words for the state — menus, aria-labels, help text. */
+declare function agentArchiveFilterStateLabel(archFilter: AgentArchFilter): string;
+/**
+ * The accessible name of the ONE control, always naming the state it is IN
+ * and the state one click moves it to. A control whose label does not say
+ * what it currently does is the "dead or dishonest" shape the platform bans.
+ */
+declare function agentArchiveFilterControlLabel(archFilter: AgentArchFilter): string;
+/**
+ * THE FOOTER. It counts exactly what the list rendered and, whenever archived
+ * rows are involved, says so — hidden ones included.
+ *
+ *   hide archived, nothing archived behind it → "412 agents"
+ *   hide archived, 4 archived behind it       → "412 agents · 4 archived hidden"
+ *   show all                                  → "416 agents · archived shown"
+ *   archived only                             → "4 archived shown"
+ */
+declare function agentListFooterLabel(args: {
+    /** Rows actually rendered. */
+    count: number;
+    archFilter: AgentArchFilter;
+    /**
+     * Rows this view WOULD render if the filter were flipped to "archived only"
+     * — exactly what the default state is keeping off the screen. Only ever
+     * read in the `active` state.
+     */
+    archivedHiddenCount: number;
+}): string;
 
 /**
  * The structural shape a record needs to be searchable. Every field except
@@ -257,7 +287,18 @@ declare function agentMatchesSearch(agent: AgentSearchable, query: string): bool
  * frontend's `selectLiveAgents` filters `isVersion` snapshots out of a store
  * that also holds them. This catalog only ever holds list rows — a version
  * snapshot cannot enter it — so that filter is a no-op here and is not
- * ported. Every ordering, tie-break and count below is byte-identical.
+ * ported.
+ *
+ * 🚨 TWO DELIBERATE DEPARTURES FROM THE ORIGINAL, both defects the port
+ * inherited and 0.9.1 fixes at the class (see CHANGELOG 0.9.1):
+ *
+ *   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
+ *        footer and the rendered rows are the same number.
+ *
+ * Everything else below is byte-identical to the original.
  */
 
 declare const AGENT_CARDS_LIMIT_DESKTOP = 8;
@@ -273,6 +314,31 @@ declare const AGENT_LIST_ITEMS_PER_PAGE = 20;
 declare function memoize1<A, R>(fn: (a: A) => R): (a: A) => R;
 declare function memoize2<A, B, R>(fn: (a: A, b: B) => R): (a: A, b: B) => R;
 declare function memoize3<A, B, C, R>(fn: (a: A, b: B, c: C) => R): (a: A, b: B, c: C) => R;
+/**
+ * 🚨 THE FINAL TIEBREAKER. `agx_get_list` orders
+ * `is_favorite DESC, updated_at DESC, id` — `id` ASCENDING is the unique key
+ * that makes the SERVER's order TOTAL. Every sort in this file ends on the
+ * same key, so the rendered order is a function of the ROWS and never of the
+ * order they happened to arrive in.
+ *
+ * Why a raw `<` / `>` and not `localeCompare`: Postgres orders `uuid` by its
+ * 16 raw bytes. The canonical text form is lowercase hex with dashes at fixed
+ * positions, so a codepoint comparison of those strings reproduces the
+ * database's order exactly. A locale collator does not — it is free to fold
+ * case or ignore punctuation, and would silently diverge from the server on
+ * precisely the ties this key exists to settle.
+ */
+declare function compareAgentIds(a: AgentSummary, b: AgentSummary): number;
+/**
+ * The chosen sort key, then `id`. TOTAL for every option.
+ *
+ * Before 0.9.1 each branch below returned 0 for tied rows, which left their
+ * relative order to whatever `Array.prototype.sort` had been handed — i.e. to
+ * the transport. A host that fetched the RPC in one shot kept the server's
+ * favourites-first/`updated_at DESC` order for ties; a host that paged it with
+ * `order=id.asc` kept id-ASC. Same rows, same filters, two different screens.
+ * The key below is the server's own, so both now render the server's answer.
+ */
 declare function applyAgentSortComparator(a: AgentSummary, b: AgentSummary, sortBy: AgentSortOption): number;
 /** All unique categories across live USER agents, sorted alphabetically. */
 declare const selectAllAgentCategories: (a: readonly AgentSummary[]) => string[];
@@ -290,6 +356,15 @@ declare const selectAllSystemAgentTags: (a: readonly AgentSummary[]) => string[]
 declare const selectUserTypeAgents: (a: readonly AgentSummary[]) => AgentSummary[];
 /** Builtin/system agents only. For chat pickers and full catalogues. */
 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
+ *
+ * `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.
+ */
 declare function sortFilteredAgents(filtered: AgentSummary[], consumer: AgentConsumerState): AgentSummary[];
 /** User-type agents — mine / shared / all tabs with full consumer filters. */
 declare function filterUserTypeAgents(agents: readonly AgentSummary[], consumer: AgentConsumerState): AgentSummary[];
@@ -297,10 +372,27 @@ declare function filterUserTypeAgents(agents: readonly AgentSummary[], consumer:
  * Builtin/system agents (tab === "system").
  *
  * Gets the SAME filter surface every other tab has — search, favorites,
- * category, tags, sort. Ownership/archive/access filters are meaningless here
- * (a builtin is always active and belongs to the platform), so those are the
- * only ones skipped. A picker that offers less on one tab than another is the
- * exact half-built shape this list exists to prevent.
+ * category, tags, sort, AND THE ARCHIVE FILTER. Only the ownership/access
+ * filters are skipped, because a builtin has no owner to filter on. A picker
+ * that offers less on one tab than another is the exact half-built shape this
+ * list exists to prevent.
+ *
+ * 🚨 0.9.2 — THE BUILTIN ARCHIVE EXEMPTION IS GONE, AND IT IS NOW ILLEGAL.
+ *
+ * Until 0.9.1 this function applied no archive filter, on the theory that "a
+ * builtin belongs to the platform and is never the user's to archive". The
+ * database disagreed: `Foundry Planner`
+ * (`001b22f6-fa4d-40c6-a1a4-8575d4d04379`) is an ARCHIVED builtin, and it
+ * rendered at Public index 216 and was pickable — while Mine / Shared / All
+ * hid their archived rows. One picker, two rules, and a person could choose a
+ * retired agent from the one tab that did not obey.
+ *
+ * THE ARCHIVED-ITEMS LAW (`common-docs/policies/archived-items.md`, Arman
+ * 2026-09-09) closed the question for every entity at once: "everything should
+ * have an archive filter, and the default should always hide archived… all
+ * archived items should always be treated the same." Clause 4 makes it a
+ * class, not an instance — so there is no per-tab, per-entity or per-surface
+ * exemption left to grant, here or anywhere.
  */
 declare function filterBuiltinTypeAgents(agents: readonly AgentSummary[], consumer: AgentConsumerState): AgentSummary[];
 /** Factory: owned user-type agents with consumer filters applied (ignores tab). */
@@ -339,9 +431,47 @@ declare const makeSelectFilteredAgentsCount: () => (a: readonly AgentSummary[],
 declare const makeSelectFilteredBuiltinAgentsCount: () => (a: readonly AgentSummary[], b: AgentConsumerState) => number;
 /** Returns whether a consumer has any non-default filters active. */
 declare function agentConsumerHasActiveFilters(consumer: AgentConsumerState, defaults: AgentConsumerState): boolean;
+/**
+ * 🚨 A BADGE COUNTS WHAT THE TAB RENDERS. Nothing else.
+ *
+ * Before 0.9.1 these five counted every user-type row, archived included,
+ * while `filterUserTypeAgents` (archive filter `active`, the default) hid the
+ * archived ones. The badge said "Mine 416", the list showed 412 rows and the
+ * 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,
+ * 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
+ * one ("a builtin is never the user's to archive"), which was false in the
+ * database and illegal under THE ARCHIVED-ITEMS LAW. Its badge now counts
+ * under the same archive rule its rows render under, so `Foundry Planner`
+ * leaves the Public badge and the Public list together, or returns to both
+ * together — never one without the other.
+ */
+declare function agentMatchesArchiveFilter(agent: AgentSummary, archFilter: AgentArchFilter): boolean;
+/**
+ * The four tab badges for a consumer's CURRENT archive filter — the numbers
+ * `useAgentListCore` puts on the tab strip. Flip the archive filter to
+ * "archived" and the badges follow the list into the archive.
+ */
+declare const selectAgentTabCounts: (a: readonly AgentSummary[], b: AgentArchFilter) => {
+    mine: number;
+    shared: number;
+    all: number;
+    system: number;
+};
+/** Live user-type agents the default (`active`) list renders. */
 declare const selectTotalUserAgentsCount: (a: readonly AgentSummary[]) => number;
 declare const selectTotalOwnedAgentsCount: (a: readonly AgentSummary[]) => number;
 declare const selectTotalSharedAgentsCount: (a: readonly AgentSummary[]) => number;
+/**
+ * Live builtin agents the DEFAULT (`active`) list renders — archived builtins
+ * excluded, exactly like every other "total" beside it. Before 0.9.2 this
+ * counted archived builtins too, which is how an archived `Foundry Planner`
+ * reached the Public badge.
+ */
 declare const selectTotalBuiltinAgentsCount: (a: readonly AgentSummary[]) => number;
 declare const selectTotalFavoriteAgentsCount: (a: readonly AgentSummary[]) => number;
 
@@ -361,4 +491,4 @@ declare const selectTotalFavoriteAgentsCount: (a: readonly AgentSummary[]) => nu
 /** @internal Test-only: forget every session-shared value. */
 declare function _resetCatalogGlobalState(): void;
 
-export { AGENT_CARDS_LIMIT_DESKTOP, AGENT_CARDS_LIMIT_MOBILE, AGENT_LIST_ITEMS_PER_PAGE, AGENT_SEARCH_LIMIT, AgentCatalogClient, AgentCatalogErrorSink, AgentCatalogLabels, AgentCatalogReadError, AgentCatalogStorage, AgentCatalogStorageLike, AgentCatalogTransport, AgentConsumerState, type AgentListPage, type AgentSearchable, type AgentServerSearchResult, AgentSortOption, AgentSummary, AgentTab, MandateDefaultRowError, MandateResolutionVerdict, type ResolveDefaultRowArgs, type ResolveDefaultRowOutcome, ResolvedDefaultRow, _resetCatalogGlobalState, agentConsumerHasActiveFilters, agentListEmptyLabel, agentMatchesSearch, applyAgentSortComparator, computeAgentSearchScore, createMemoryStorage, defaultRowFromResolution, defaultStorage, detectDefaultRowDrift, filterBuiltinTypeAgents, filterUserTypeAgents, makeSelectFilteredAgents, makeSelectFilteredAgentsCount, makeSelectFilteredBuiltinAgents, makeSelectFilteredBuiltinAgentsCount, makeSelectFilteredOwnedAgents, makeSelectFilteredSharedAgents, makeSelectOwnedAgentCards, makeSelectOwnedAgentListItems, makeSelectSharedAgentCards, makeSelectSharedAgentListItems, memoize1, memoize2, memoize3, parseMandateResolution, readAgentCatalogRows, readCachedDefaultRow, readCachedDefaultRowAsync, readSingleAgentRow, resolveDefaultRow, searchAgentsOnServer, selectAllAgentCategories, selectAllAgentTags, selectAllSystemAgentCategories, selectAllSystemAgentTags, selectBuiltinTypeAgents, selectTotalBuiltinAgentsCount, selectTotalFavoriteAgentsCount, selectTotalOwnedAgentsCount, selectTotalSharedAgentsCount, selectTotalUserAgentsCount, selectUserTypeAgents, shouldDefaultAgentListToPublicTab, sortFilteredAgents, toAgentSummary, writeAgentFavorite, writeCachedDefaultRow, writeCachedDefaultRowAsync };
+export { AGENT_CARDS_LIMIT_DESKTOP, AGENT_CARDS_LIMIT_MOBILE, AGENT_LIST_ITEMS_PER_PAGE, AGENT_SEARCH_LIMIT, AgentArchFilter, AgentCatalogClient, AgentCatalogErrorSink, AgentCatalogLabels, AgentCatalogReadError, AgentCatalogStorage, AgentCatalogStorageLike, AgentCatalogTransport, AgentConsumerState, type AgentListPage, type AgentSearchable, type AgentServerSearchResult, AgentSortOption, AgentSummary, AgentTab, MandateDefaultRowError, MandateResolutionVerdict, type ResolveDefaultRowArgs, type ResolveDefaultRowOutcome, ResolvedDefaultRow, _resetCatalogGlobalState, agentArchiveFilterChipLabel, agentArchiveFilterControlLabel, agentArchiveFilterStateLabel, agentConsumerHasActiveFilters, agentListEmptyLabel, agentListFooterLabel, agentMatchesArchiveFilter, agentMatchesSearch, applyAgentSortComparator, compareAgentIds, computeAgentSearchScore, createMemoryStorage, defaultRowFromResolution, defaultStorage, detectDefaultRowDrift, filterBuiltinTypeAgents, filterUserTypeAgents, makeSelectFilteredAgents, makeSelectFilteredAgentsCount, makeSelectFilteredBuiltinAgents, makeSelectFilteredBuiltinAgentsCount, makeSelectFilteredOwnedAgents, makeSelectFilteredSharedAgents, makeSelectOwnedAgentCards, makeSelectOwnedAgentListItems, makeSelectSharedAgentCards, makeSelectSharedAgentListItems, memoize1, memoize2, memoize3, parseMandateResolution, readAgentCatalogRows, readCachedDefaultRow, readCachedDefaultRowAsync, readSingleAgentRow, resolveDefaultRow, searchAgentsOnServer, selectAgentTabCounts, selectAllAgentCategories, selectAllAgentTags, selectAllSystemAgentCategories, selectAllSystemAgentTags, selectBuiltinTypeAgents, selectTotalBuiltinAgentsCount, selectTotalFavoriteAgentsCount, selectTotalOwnedAgentsCount, selectTotalSharedAgentsCount, selectTotalUserAgentsCount, selectUserTypeAgents, shouldDefaultAgentListToPublicTab, sortFilteredAgents, toAgentSummary, writeAgentFavorite, writeCachedDefaultRow, writeCachedDefaultRowAsync };