@ai-matrx/agents 0.9.1 → 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 AgentArchFilter, j as AgentSortOption } from '../orchestra-CID-rsu8.cjs';
-export { k as AGENT_NONE_SENTINEL, l as AgentAccessFilter, m as AgentAccessLevel, 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-CID-rsu8.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
@@ -342,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). */
@@ -395,10 +442,13 @@ declare function agentConsumerHasActiveFilters(consumer: AgentConsumerState, def
  *
  * `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.
- * The system tab is the exception with a reason: `filterBuiltinTypeAgents`
- * applies no archive filter (a builtin belongs to the platform and is never
- * the user's to archive), so its count applies none either — it already
- * counted exactly what it rendered.
+ *
+ * 🚨 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;
 /**
@@ -416,6 +466,12 @@ declare const selectAgentTabCounts: (a: readonly AgentSummary[], b: AgentArchFil
 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;
 
@@ -435,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, 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, agentConsumerHasActiveFilters, agentListEmptyLabel, 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 };
+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 AgentArchFilter, j as AgentSortOption } from '../orchestra-CID-rsu8.js';
-export { k as AGENT_NONE_SENTINEL, l as AgentAccessFilter, m as AgentAccessLevel, 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-CID-rsu8.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
@@ -342,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). */
@@ -395,10 +442,13 @@ declare function agentConsumerHasActiveFilters(consumer: AgentConsumerState, def
  *
  * `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.
- * The system tab is the exception with a reason: `filterBuiltinTypeAgents`
- * applies no archive filter (a builtin belongs to the platform and is never
- * the user's to archive), so its count applies none either — it already
- * counted exactly what it rendered.
+ *
+ * 🚨 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;
 /**
@@ -416,6 +466,12 @@ declare const selectAgentTabCounts: (a: readonly AgentSummary[], b: AgentArchFil
 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;
 
@@ -435,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, 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, agentConsumerHasActiveFilters, agentListEmptyLabel, 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 };
+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.js

@@ -15,6 +15,24 @@ var SORT_OPTIONS = [
   { value: "name-desc", label: "Z \u2192 A" },
   { value: "category-asc", label: "Category" }
 ];
+var ARCHIVE_FILTER_ORDER = [
+  "active",
+  "both",
+  "archived"
+];
+var ARCHIVE_FILTER_OPTIONS = [
+  { value: "active", label: "Hide archived", chip: "Archive" },
+  { value: "both", label: "Show all", chip: "All + archived" },
+  { value: "archived", label: "Archived only", chip: "Archived only" }
+];
+function nextArchFilter(current) {
+  const index = ARCHIVE_FILTER_ORDER.indexOf(current);
+  if (index < 0) return ARCHIVE_FILTER_ORDER[0];
+  return ARCHIVE_FILTER_ORDER[(index + 1) % ARCHIVE_FILTER_ORDER.length];
+}
+function isAgentArchFilter(value) {
+  return value === "active" || value === "archived" || value === "both";
+}
 var AGENT_NONE_SENTINEL = "__none__";
 var DEFAULT_AGENT_CONSUMER_STATE = {
   tab: "mine",
@@ -637,6 +655,18 @@ function createAgentCatalog(config) {
       remedy: "pass `identity: { requireUserId() }` \u2014 never a silent anonymous read"
     });
   }
+  const archiveDefault = config.defaults?.archiveFilter;
+  if (archiveDefault !== void 0 && !isAgentArchFilter(archiveDefault)) {
+    throw new AgentCatalogConfigError({
+      code: "invalid_archive_default",
+      message: `defaults.archiveFilter was ${JSON.stringify(archiveDefault)}, which is not one of the three states of the platform archive filter`,
+      remedy: 'pass "active" (hide archived), "both" (show all) or "archived" (archived only)'
+    });
+  }
+  const consumerDefaults = {
+    ...DEFAULT_AGENT_CONSUMER_STATE,
+    ...archiveDefault ? { archFilter: archiveDefault } : {}
+  };
   const catalogId = config.catalogId ?? "default";
   const client = config.client;
   const identity = config.identity;
@@ -737,7 +767,7 @@ function createAgentCatalog(config) {
     return run;
   }
   function getConsumer(consumerId) {
-    return state.consumers[consumerId] ?? DEFAULT_AGENT_CONSUMER_STATE;
+    return state.consumers[consumerId] ?? consumerDefaults;
   }
   function writeConsumer(consumerId, next) {
     publish({
@@ -748,7 +778,7 @@ function createAgentCatalog(config) {
   function registerConsumer(consumerId, initial) {
     if (state.consumers[consumerId]) return;
     writeConsumer(consumerId, {
-      ...DEFAULT_AGENT_CONSUMER_STATE,
+      ...consumerDefaults,
       ...initial ?? {}
     });
   }
@@ -759,9 +789,7 @@ function createAgentCatalog(config) {
     publish({ ...state, consumers });
   }
   function setConsumerFilter(consumerId, patch) {
-    const current = state.consumers[consumerId] ?? {
-      ...DEFAULT_AGENT_CONSUMER_STATE
-    };
+    const current = state.consumers[consumerId] ?? { ...consumerDefaults };
     writeConsumer(consumerId, {
       ...current,
       ...patch,
@@ -778,9 +806,7 @@ function createAgentCatalog(config) {
     );
   }
   function setConsumerServerSearch(consumerId, args) {
-    const current = state.consumers[consumerId] ?? {
-      ...DEFAULT_AGENT_CONSUMER_STATE
-    };
+    const current = state.consumers[consumerId] ?? { ...consumerDefaults };
     const next = { ...current };
     if (args.matchedIds !== void 0) next.serverMatchedIds = args.matchedIds;
     if (args.isSearching !== void 0) next.isServerSearching = args.isSearching;
@@ -791,7 +817,7 @@ function createAgentCatalog(config) {
   }
   function resetConsumerFilters(consumerId) {
     if (!state.consumers[consumerId]) return;
-    writeConsumer(consumerId, { ...DEFAULT_AGENT_CONSUMER_STATE });
+    writeConsumer(consumerId, { ...consumerDefaults });
   }
   async function searchServer(query, deep = false) {
     const result = await searchAgentsOnServer(client, { query, deep });
@@ -921,6 +947,7 @@ function createAgentCatalog(config) {
     errorSink,
     notifier,
     canResolveMandates: transport !== void 0,
+    consumerDefaults,
     getState: () => state,
     subscribe: (listener) => {
       listeners.add(listener);
@@ -998,6 +1025,26 @@ function shouldDefaultAgentListToPublicTab(args) {
   if (!args.agentsLoaded) return false;
   return args.ownedCount === 0;
 }
+function agentArchiveFilterChipLabel(archFilter) {
+  return ARCHIVE_FILTER_OPTIONS.find((o) => o.value === archFilter)?.chip ?? "Archive";
+}
+function agentArchiveFilterStateLabel(archFilter) {
+  return ARCHIVE_FILTER_OPTIONS.find((o) => o.value === archFilter)?.label ?? "Hide archived";
+}
+function agentArchiveFilterControlLabel(archFilter) {
+  return `Archive filter: ${agentArchiveFilterStateLabel(
+    archFilter
+  ).toLowerCase()}. Click for ${agentArchiveFilterStateLabel(
+    nextArchFilter(archFilter)
+  ).toLowerCase()}`;
+}
+function agentListFooterLabel(args) {
+  const { count, archFilter, archivedHiddenCount } = args;
+  if (archFilter === "archived") return `${count} archived shown`;
+  const base = `${count} agent${count !== 1 ? "s" : ""}`;
+  if (archFilter === "both") return `${base} \xB7 archived shown`;
+  return archivedHiddenCount > 0 ? `${base} \xB7 ${archivedHiddenCount} archived hidden` : base;
+}
 
 // catalog/score.ts
 function computeAgentSearchScore(agent, query) {
@@ -1208,8 +1255,7 @@ function filterUserTypeAgents(agents, consumer) {
     if (tab === "mine" && agent.isOwner !== true) return false;
     if (tab === "shared" && !(agent.isOwner === false && agent.accessLevel != null))
       return false;
-    if (archFilter === "active" && agent.isArchived) return false;
-    if (archFilter === "archived" && !agent.isArchived) return false;
+    if (!agentMatchesArchiveFilter(agent, archFilter)) return false;
     if (favFilter === "yes" && !agent.isFavorite) return false;
     if (favFilter === "no" && agent.isFavorite) return false;
     if (accessFilter === "owned" && agent.isOwner !== true) return false;
@@ -1239,9 +1285,10 @@ function filterUserTypeAgents(agents, consumer) {
   return sortFilteredAgents(filtered, consumer);
 }
 function filterBuiltinTypeAgents(agents, consumer) {
-  const { searchTerm, favFilter, includedCats, includedTags } = consumer;
+  const { searchTerm, favFilter, archFilter, includedCats, includedTags } = consumer;
   const serverMatched = new Set(consumer.serverMatchedIds);
   const filtered = agents.filter((agent) => {
+    if (!agentMatchesArchiveFilter(agent, archFilter)) return false;
     if (favFilter === "yes" && !agent.isFavorite) return false;
     if (favFilter === "no" && agent.isFavorite) return false;
     if (includedCats.length > 0) {
@@ -1359,6 +1406,15 @@ function agentMatchesArchiveFilter(agent, archFilter) {
   if (archFilter === "archived") return Boolean(agent.isArchived);
   return true;
 }
+function countBuiltinRows(agents, archFilter) {
+  let n = 0;
+  for (const a of agents) {
+    if (a.agentType !== "builtin") continue;
+    if (!agentMatchesArchiveFilter(a, archFilter)) continue;
+    n += 1;
+  }
+  return n;
+}
 function countUserRows(agents, archFilter, predicate) {
   let n = 0;
   for (const a of agents) {
@@ -1377,7 +1433,7 @@ var selectAgentTabCounts = memoize2(
     mine: countUserRows(agents, archFilter, isOwned),
     shared: countUserRows(agents, archFilter, isShared),
     all: countUserRows(agents, archFilter, isAny),
-    system: selectBuiltinTypeAgents(agents).length
+    system: countBuiltinRows(agents, archFilter)
   })
 );
 var selectTotalUserAgentsCount = memoize1(
@@ -1390,7 +1446,7 @@ var selectTotalSharedAgentsCount = memoize1(
   (agents) => countUserRows(agents, "active", isShared)
 );
 var selectTotalBuiltinAgentsCount = memoize1(
-  (agents) => selectBuiltinTypeAgents(agents).length
+  (agents) => countBuiltinRows(agents, "active")
 );
 var selectTotalFavoriteAgentsCount = memoize1(
   (agents) => countUserRows(agents, "active", isFavorite)
@@ -1401,6 +1457,8 @@ export {
   AGENT_LIST_ITEMS_PER_PAGE,
   AGENT_NONE_SENTINEL,
   AGENT_SEARCH_LIMIT,
+  ARCHIVE_FILTER_OPTIONS,
+  ARCHIVE_FILTER_ORDER,
   AgentCatalogConfigError,
   AgentCatalogReadError,
   DEFAULT_AGENT_CATALOG_LABELS,
@@ -1408,8 +1466,12 @@ export {
   MandateDefaultRowError,
   SORT_OPTIONS,
   _resetCatalogGlobalState,
+  agentArchiveFilterChipLabel,
+  agentArchiveFilterControlLabel,
+  agentArchiveFilterStateLabel,
   agentConsumerHasActiveFilters,
   agentListEmptyLabel,
+  agentListFooterLabel,
   agentMatchesArchiveFilter,
   agentMatchesSearch,
   applyAgentSortComparator,
@@ -1425,6 +1487,7 @@ export {
   filterBuiltinTypeAgents,
   filterUserTypeAgents,
   getRegisteredAgentCatalog,
+  isAgentArchFilter,
   isMandateAgentId,
   makeSelectFilteredAgents,
   makeSelectFilteredAgentsCount,
@@ -1440,6 +1503,7 @@ export {
   memoize1,
   memoize2,
   memoize3,
+  nextArchFilter,
   orchestraDelegatesLine,
   orchestraDepthLine,
   orchestraLabel,