@ai-matrx/agents 0.9.1 → 0.9.2

package/dist/catalog/native/index.d.cts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
-import { t as AgentCatalogNavigate, v as AgentCatalogOpenPeek, n as AgentCatalog, A as AgentSummary, z as AgentCatalogState, f as AgentTab, j as AgentSortOption, E as AgentFavFilter, i as AgentArchFilter, l as AgentAccessFilter, h as AgentConsumerState, J as DefaultRowState } from '../../orchestra-CID-rsu8.cjs';
-export { O as OrchestraBadge, W as orchestraDelegatesLine, X as orchestraDepthLine, Y as orchestraLabel, Z as orchestraModeLabel } from '../../orchestra-CID-rsu8.cjs';
+import { x as AgentCatalogNavigate, z as AgentCatalogOpenPeek, q as AgentCatalog, A as AgentSummary, E as AgentCatalogState, g as AgentTab, j as AgentSortOption, I as AgentFavFilter, f as AgentArchFilter, n as AgentAccessFilter, i as AgentConsumerState, O as DefaultRowState } from '../../orchestra-DljbEiks.cjs';
+export { P as OrchestraBadge, a0 as orchestraDelegatesLine, a1 as orchestraDepthLine, a2 as orchestraLabel, a3 as orchestraModeLabel } from '../../orchestra-DljbEiks.cjs';
 
 /**
  * The anchor a row renders for cmd/ctrl-click. DEFAULT (web): a plain `<a>` —
@@ -249,6 +249,13 @@ interface UseAgentConsumerReturn {
     includedTags: string[];
     favFilter: AgentFavFilter;
     archFilter: AgentArchFilter;
+    /**
+     * The archive-filter state this catalog starts consumers in — the platform
+     * default `"active"` unless the host set the knob. What "not the default
+     * state" means on this surface, so the control and the footer can both say
+     * it honestly.
+     */
+    archFilterDefault: AgentArchFilter;
     accessFilter: AgentAccessFilter;
     favoritesFirst: boolean;
     listPage: number;
@@ -295,6 +302,12 @@ declare function useAgentConsumer(consumerId: string, options?: {
     unregisterOnUnmount?: boolean;
     /** Applied only when the consumer is first registered (idempotent). */
     initialTab?: AgentTab;
+    /**
+     * THE ARCHIVED-ITEMS LAW's per-consumer override of the catalog-wide
+     * `defaults.archiveFilter` knob. Applied only at first registration — the
+     * state belongs to the person after that.
+     */
+    initialArchFilter?: AgentArchFilter;
 }): UseAgentConsumerReturn;
 
 /**
@@ -349,6 +362,13 @@ interface AgentListCoreOptions {
      * not just at mount — so a restriction that arrives later is enforced later.
      */
     visibleTabs?: readonly AgentTab[];
+    /**
+     * THE ARCHIVED-ITEMS LAW's per-consumer override of the catalog-wide
+     * `defaults.archiveFilter` knob, applied once at first registration. Almost
+     * nothing should pass it: the platform answer is "hide archived", and the
+     * person reveals the archive from the control on the filter bar.
+     */
+    initialArchFilter?: AgentArchFilter;
     /** Hide records that are invalid for this call site. */
     excludeAgentIds?: readonly string[];
     /**
@@ -374,8 +394,10 @@ declare const HOVER_GRACE_MS = 900;
  * else the first allowed tab.
  */
 declare function coerceVisibleTab(current: AgentTab, allowed: readonly AgentTab[], initialTab?: AgentTab): AgentTab | null;
-declare function useAgentListCore({ consumerId, onSelect, navigateTo, activeAgentIdOverride, initialTab, includeSystemInAll, visibleTabs, excludeAgentIds, defaultMandateKey, }: AgentListCoreOptions): {
+declare function useAgentListCore({ consumerId, onSelect, navigateTo, activeAgentIdOverride, initialTab, includeSystemInAll, visibleTabs, initialArchFilter, excludeAgentIds, defaultMandateKey, }: AgentListCoreOptions): {
     agents: AgentSummary[];
+    archivedHiddenCount: number;
+    footerLabel: string;
     isLoading: boolean;
     activeAgentId: string | null;
     pinnedAgent: AgentSummary | null;
@@ -413,8 +435,13 @@ interface AgentListContentProps {
     pinnedAgent?: AgentSummary | null | undefined;
     defaultRow?: DefaultRowState | null | undefined;
     autoFocusSearch?: boolean;
+    /**
+     * Rows the ARCHIVE FILTER is keeping off this screen — from
+     * `useAgentListCore`. The footer names them, exactly as on the web.
+     */
+    archivedHiddenCount?: number | undefined;
 }
-declare function AgentListContent({ agents, isLoading, consumer, activeAgentId, allCategories, allTags, onSelectAgent, onDetailPress, onFilterChipPress, onReset, activeFilterCount, tabCounts, visibleTabs, systemTabLabel, pinnedAgent, defaultRow, autoFocusSearch, }: AgentListContentProps): react.JSX.Element;
+declare function AgentListContent({ agents, isLoading, consumer, activeAgentId, allCategories, allTags, onSelectAgent, onDetailPress, onFilterChipPress, onReset, activeFilterCount, tabCounts, visibleTabs, systemTabLabel, pinnedAgent, defaultRow, autoFocusSearch, archivedHiddenCount, }: AgentListContentProps): react.JSX.Element;
 
 interface AgentListTabsProps {
     consumer: UseAgentConsumerReturn;
@@ -570,6 +597,14 @@ declare const SHAPES: {
     rocket: {
         paths: string[];
     };
+    /**
+     * 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.
+     */
+    archive: {
+        paths: string[];
+    };
     circleCheck: {
         paths: string[];
         circles: {
@@ -636,11 +671,15 @@ declare function SearchInput({ value, onChange, placeholder, autoFocus, }: {
     placeholder: string;
     autoFocus?: boolean;
 }): react.JSX.Element;
-declare function FilterChip({ icon, label, active, onPress, }: {
+declare function FilterChip({ icon, label, active, onPress, accessibilityLabel, testID, }: {
     icon: AgentCatalogIconName;
     label: string;
     active: boolean;
     onPress: () => void;
+    /** Accessible name when the visible label alone would not say the state. */
+    accessibilityLabel?: string;
+    /** Stable hook so a shell test can measure the control, not a style. */
+    testID?: string;
 }): react.JSX.Element;
 declare function OptionRow({ label, selected, onPress, }: {
     label: string;

package/dist/catalog/native/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
-import { t as AgentCatalogNavigate, v as AgentCatalogOpenPeek, n as AgentCatalog, A as AgentSummary, z as AgentCatalogState, f as AgentTab, j as AgentSortOption, E as AgentFavFilter, i as AgentArchFilter, l as AgentAccessFilter, h as AgentConsumerState, J as DefaultRowState } from '../../orchestra-CID-rsu8.js';
-export { O as OrchestraBadge, W as orchestraDelegatesLine, X as orchestraDepthLine, Y as orchestraLabel, Z as orchestraModeLabel } from '../../orchestra-CID-rsu8.js';
+import { x as AgentCatalogNavigate, z as AgentCatalogOpenPeek, q as AgentCatalog, A as AgentSummary, E as AgentCatalogState, g as AgentTab, j as AgentSortOption, I as AgentFavFilter, f as AgentArchFilter, n as AgentAccessFilter, i as AgentConsumerState, O as DefaultRowState } from '../../orchestra-DljbEiks.js';
+export { P as OrchestraBadge, a0 as orchestraDelegatesLine, a1 as orchestraDepthLine, a2 as orchestraLabel, a3 as orchestraModeLabel } from '../../orchestra-DljbEiks.js';
 
 /**
  * The anchor a row renders for cmd/ctrl-click. DEFAULT (web): a plain `<a>` —
@@ -249,6 +249,13 @@ interface UseAgentConsumerReturn {
     includedTags: string[];
     favFilter: AgentFavFilter;
     archFilter: AgentArchFilter;
+    /**
+     * The archive-filter state this catalog starts consumers in — the platform
+     * default `"active"` unless the host set the knob. What "not the default
+     * state" means on this surface, so the control and the footer can both say
+     * it honestly.
+     */
+    archFilterDefault: AgentArchFilter;
     accessFilter: AgentAccessFilter;
     favoritesFirst: boolean;
     listPage: number;
@@ -295,6 +302,12 @@ declare function useAgentConsumer(consumerId: string, options?: {
     unregisterOnUnmount?: boolean;
     /** Applied only when the consumer is first registered (idempotent). */
     initialTab?: AgentTab;
+    /**
+     * THE ARCHIVED-ITEMS LAW's per-consumer override of the catalog-wide
+     * `defaults.archiveFilter` knob. Applied only at first registration — the
+     * state belongs to the person after that.
+     */
+    initialArchFilter?: AgentArchFilter;
 }): UseAgentConsumerReturn;
 
 /**
@@ -349,6 +362,13 @@ interface AgentListCoreOptions {
      * not just at mount — so a restriction that arrives later is enforced later.
      */
     visibleTabs?: readonly AgentTab[];
+    /**
+     * THE ARCHIVED-ITEMS LAW's per-consumer override of the catalog-wide
+     * `defaults.archiveFilter` knob, applied once at first registration. Almost
+     * nothing should pass it: the platform answer is "hide archived", and the
+     * person reveals the archive from the control on the filter bar.
+     */
+    initialArchFilter?: AgentArchFilter;
     /** Hide records that are invalid for this call site. */
     excludeAgentIds?: readonly string[];
     /**
@@ -374,8 +394,10 @@ declare const HOVER_GRACE_MS = 900;
  * else the first allowed tab.
  */
 declare function coerceVisibleTab(current: AgentTab, allowed: readonly AgentTab[], initialTab?: AgentTab): AgentTab | null;
-declare function useAgentListCore({ consumerId, onSelect, navigateTo, activeAgentIdOverride, initialTab, includeSystemInAll, visibleTabs, excludeAgentIds, defaultMandateKey, }: AgentListCoreOptions): {
+declare function useAgentListCore({ consumerId, onSelect, navigateTo, activeAgentIdOverride, initialTab, includeSystemInAll, visibleTabs, initialArchFilter, excludeAgentIds, defaultMandateKey, }: AgentListCoreOptions): {
     agents: AgentSummary[];
+    archivedHiddenCount: number;
+    footerLabel: string;
     isLoading: boolean;
     activeAgentId: string | null;
     pinnedAgent: AgentSummary | null;
@@ -413,8 +435,13 @@ interface AgentListContentProps {
     pinnedAgent?: AgentSummary | null | undefined;
     defaultRow?: DefaultRowState | null | undefined;
     autoFocusSearch?: boolean;
+    /**
+     * Rows the ARCHIVE FILTER is keeping off this screen — from
+     * `useAgentListCore`. The footer names them, exactly as on the web.
+     */
+    archivedHiddenCount?: number | undefined;
 }
-declare function AgentListContent({ agents, isLoading, consumer, activeAgentId, allCategories, allTags, onSelectAgent, onDetailPress, onFilterChipPress, onReset, activeFilterCount, tabCounts, visibleTabs, systemTabLabel, pinnedAgent, defaultRow, autoFocusSearch, }: AgentListContentProps): react.JSX.Element;
+declare function AgentListContent({ agents, isLoading, consumer, activeAgentId, allCategories, allTags, onSelectAgent, onDetailPress, onFilterChipPress, onReset, activeFilterCount, tabCounts, visibleTabs, systemTabLabel, pinnedAgent, defaultRow, autoFocusSearch, archivedHiddenCount, }: AgentListContentProps): react.JSX.Element;
 
 interface AgentListTabsProps {
     consumer: UseAgentConsumerReturn;
@@ -570,6 +597,14 @@ declare const SHAPES: {
     rocket: {
         paths: string[];
     };
+    /**
+     * 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.
+     */
+    archive: {
+        paths: string[];
+    };
     circleCheck: {
         paths: string[];
         circles: {
@@ -636,11 +671,15 @@ declare function SearchInput({ value, onChange, placeholder, autoFocus, }: {
     placeholder: string;
     autoFocus?: boolean;
 }): react.JSX.Element;
-declare function FilterChip({ icon, label, active, onPress, }: {
+declare function FilterChip({ icon, label, active, onPress, accessibilityLabel, testID, }: {
     icon: AgentCatalogIconName;
     label: string;
     active: boolean;
     onPress: () => void;
+    /** Accessible name when the visible label alone would not say the state. */
+    accessibilityLabel?: string;
+    /** Stable hook so a shell test can measure the control, not a style. */
+    testID?: string;
 }): react.JSX.Element;
 declare function OptionRow({ label, selected, onPress, }: {
     label: string;

package/dist/catalog/native/index.js

@@ -229,53 +229,27 @@ import {
 
 // catalog/shared/useAgentConsumer.ts
 import { useCallback as useCallback2, useEffect, useRef, useState } from "react";
-
-// catalog/types.ts
-function isMandateAgentId(id) {
-  return id.startsWith("mandate:");
-}
-var SORT_OPTIONS = [
-  { value: "updated-desc", label: "Recent" },
-  { value: "created-desc", label: "Created" },
-  { value: "name-asc", label: "A \u2192 Z" },
-  { value: "name-desc", label: "Z \u2192 A" },
-  { value: "category-asc", label: "Category" }
-];
-var AGENT_NONE_SENTINEL = "__none__";
-var DEFAULT_AGENT_CONSUMER_STATE = {
-  tab: "mine",
-  sortBy: "updated-desc",
-  searchTerm: "",
-  includedCats: [],
-  includedTags: [],
-  favFilter: "all",
-  archFilter: "active",
-  accessFilter: "any",
-  favoritesFirst: true,
-  listPage: 1,
-  sharedPage: 1,
-  serverMatchedIds: [],
-  isServerSearching: false,
-  deepSearch: false
-};
-
-// catalog/shared/useAgentConsumer.ts
 var DEBOUNCE_MS = 250;
 var MIN_QUERY_LENGTH = 2;
 function useAgentConsumer(consumerId, options) {
   const catalog = useAgentCatalog();
+  const defaults = catalog.consumerDefaults;
   const selectConsumer = useCallback2(
-    (state) => state.consumers[consumerId] ?? DEFAULT_AGENT_CONSUMER_STATE,
-    [consumerId]
+    (state) => state.consumers[consumerId] ?? defaults,
+    [consumerId, defaults]
   );
   const consumer = useAgentCatalogState(selectConsumer);
   const optionsRef = useRef(options);
   optionsRef.current = options;
   useEffect(() => {
     const opts = optionsRef.current;
+    const initial = {
+      ...opts?.initialTab ? { tab: opts.initialTab } : {},
+      ...opts?.initialArchFilter ? { archFilter: opts.initialArchFilter } : {}
+    };
     catalog.registerConsumer(
       consumerId,
-      opts?.initialTab ? { tab: opts.initialTab } : void 0
+      Object.keys(initial).length > 0 ? initial : void 0
     );
     return () => {
       if (optionsRef.current?.unregisterOnUnmount) {
@@ -398,7 +372,10 @@ function useAgentConsumer(consumerId, options) {
       isSearching
     });
   }, [consumerId, catalog, matchedIds, isSearching]);
-  const hasActiveFilters = consumer.searchTerm !== "" || consumer.includedCats.length > 0 || consumer.includedTags.length > 0 || consumer.favFilter !== "all" || consumer.archFilter !== "active" || consumer.accessFilter !== "any" || !consumer.favoritesFirst;
+  const hasActiveFilters = consumer.searchTerm !== "" || consumer.includedCats.length > 0 || consumer.includedTags.length > 0 || consumer.favFilter !== "all" || // The archive filter is compared to THIS CATALOG'S default, not to the
+  // hardcoded platform one: a host that legitimately defaults to "show all"
+  // must not have the reset control permanently lit.
+  consumer.archFilter !== defaults.archFilter || consumer.accessFilter !== "any" || !consumer.favoritesFirst;
   return {
     tab: consumer.tab,
     sortBy: consumer.sortBy,
@@ -407,6 +384,7 @@ function useAgentConsumer(consumerId, options) {
     includedTags: consumer.includedTags,
     favFilter: consumer.favFilter,
     archFilter: consumer.archFilter,
+    archFilterDefault: defaults.archFilter,
     accessFilter: consumer.accessFilter,
     favoritesFirst: consumer.favoritesFirst,
     listPage: consumer.listPage,
@@ -433,6 +411,34 @@ function useAgentConsumer(consumerId, options) {
   };
 }
 
+// catalog/types.ts
+function isMandateAgentId(id) {
+  return id.startsWith("mandate:");
+}
+var SORT_OPTIONS = [
+  { value: "updated-desc", label: "Recent" },
+  { value: "created-desc", label: "Created" },
+  { value: "name-asc", label: "A \u2192 Z" },
+  { 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];
+}
+var AGENT_NONE_SENTINEL = "__none__";
+
 // catalog/labels.ts
 function agentListEmptyLabel(tab, labels) {
   switch (tab) {
@@ -449,6 +455,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) {
@@ -639,8 +665,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;
@@ -670,9 +695,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) {
@@ -718,6 +744,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) {
@@ -736,7 +771,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(
@@ -749,7 +784,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)
@@ -771,6 +806,7 @@ function useAgentListCore({
   initialTab,
   includeSystemInAll = false,
   visibleTabs,
+  initialArchFilter,
   excludeAgentIds = EMPTY_EXCLUDES,
   defaultMandateKey
 }) {
@@ -780,7 +816,10 @@ function useAgentListCore({
   const [hoveredAgent, setHoveredAgent] = useState2(null);
   const hoverLeaveTimerRef = useRef2(null);
   const defaultTabAppliedRef = useRef2(false);
-  const consumer = useAgentConsumer(consumerId, { unregisterOnUnmount: true });
+  const consumer = useAgentConsumer(consumerId, {
+    unregisterOnUnmount: true,
+    ...initialArchFilter ? { initialArchFilter } : {}
+  });
   const rows = useAgentCatalogRows();
   const userId = catalog.getUserIdOrNull();
   const tabCountsForFilter = selectAgentTabCounts(rows, consumer.state.archFilter);
@@ -794,7 +833,20 @@ function useAgentListCore({
     () => new Set(excludeAgentIds),
     [excludeAgentIds]
   );
-  const agents = excludedAgentIds.size === 0 ? filteredAgents : filteredAgents.filter((agent) => !excludedAgentIds.has(agent.id));
+  const applyExcludes = useCallback3(
+    (list) => excludedAgentIds.size === 0 ? list : list.filter((agent) => !excludedAgentIds.has(agent.id)),
+    [excludedAgentIds]
+  );
+  const agents = applyExcludes(filteredAgents);
+  const selectArchivedProbe = useMemo3(
+    () => makeSelectFilteredAgents(includeSystemInAll),
+    [includeSystemInAll]
+  );
+  const archiveProbeState = useMemo3(
+    () => ({ ...consumer.state, archFilter: "archived" }),
+    [consumer.state]
+  );
+  const archivedHiddenCount = consumer.archFilter === "active" ? applyExcludes(selectArchivedProbe(rows, archiveProbeState)).length : 0;
   const status = useAgentCatalogState(selectStatus);
   const activeAgentId = activeAgentIdOverride ?? null;
   const pinnedAgent = activeAgentId ? catalog.getAgent(activeAgentId) : void 0;
@@ -881,7 +933,9 @@ function useAgentListCore({
     },
     [onSelect, navigateTo, navigate, catalog, consumerId]
   );
-  const activeFilterCount = (consumer.sortBy !== "updated-desc" ? 1 : 0) + (consumer.includedCats.length > 0 ? 1 : 0) + (consumer.includedTags.length > 0 ? 1 : 0) + (consumer.favFilter !== "all" ? 1 : 0);
+  const activeFilterCount = (consumer.sortBy !== "updated-desc" ? 1 : 0) + (consumer.includedCats.length > 0 ? 1 : 0) + (consumer.includedTags.length > 0 ? 1 : 0) + (consumer.favFilter !== "all" ? 1 : 0) + // The archive filter counts like every other filter, so a list showing
+  // archived rows offers the reset control that puts them away again.
+  (consumer.archFilter !== consumer.archFilterDefault ? 1 : 0);
   const handleAgentHover = useCallback3(
     (agent, panelOpen) => {
       if (panelOpen) return;
@@ -922,8 +976,15 @@ function useAgentListCore({
     },
     []
   );
+  const footerLabel = agentListFooterLabel({
+    count: agents.length,
+    archFilter: consumer.archFilter,
+    archivedHiddenCount
+  });
   return {
     agents,
+    archivedHiddenCount,
+    footerLabel,
     isLoading,
     activeAgentId,
     pinnedAgent: pinnedAgent ?? null,
@@ -1066,6 +1127,18 @@ var SHAPES = {
       "M12 15v5s3.03-.55 4-2c1.08-1.62 0-5 0-5"
     ]
   },
+  /**
+   * 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.
+   */
+  archive: {
+    paths: [
+      "M3 3h18a1 1 0 0 1 1 1v3a1 1 0 0 1-1 1H3a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1z",
+      "M4 8v11a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8",
+      "M10 12h4"
+    ]
+  },
   circleCheck: {
     paths: ["m9 12 2 2 4-4"],
     circles: [{ cx: 12, cy: 12, r: 10 }]
@@ -1135,6 +1208,7 @@ var TEXT_GLYPHS = {
   folder: "\u25A4",
   tag: "\u2317",
   rotateCcw: "\u21BA",
+  archive: "\u25A3",
   loader: "\u25CC",
   alertTriangle: "\u26A0",
   music4: "\u266A",
@@ -1648,7 +1722,9 @@ function FilterChip({
   icon,
   label,
   active,
-  onPress
+  onPress,
+  accessibilityLabel,
+  testID
 }) {
   const theme = useAgentCatalogNativeTheme();
   const { errorSink } = useAgentCatalog();
@@ -1659,7 +1735,8 @@ function FilterChip({
       onPress,
       accessibilityRole: "button",
       accessibilityState: { selected: active },
-      accessibilityLabel: label,
+      accessibilityLabel: accessibilityLabel ?? label,
+      ...testID ? { testID } : {},
       style: ({ pressed }) => [
         styles2.chip,
         {
@@ -1918,6 +1995,17 @@ function AgentFilterBar({
             }
           }
         ),
+        /* @__PURE__ */ jsx7(
+          FilterChip,
+          {
+            icon: "archive",
+            label: agentArchiveFilterChipLabel(consumer.archFilter),
+            active: consumer.archFilter !== consumer.archFilterDefault,
+            accessibilityLabel: agentArchiveFilterControlLabel(consumer.archFilter),
+            testID: "agent-archive-filter",
+            onPress: () => consumer.setArchFilter(nextArchFilter(consumer.archFilter))
+          }
+        ),
         allCategories.length > 0 && /* @__PURE__ */ jsx7(
           FilterChip,
           {
@@ -2264,7 +2352,8 @@ function AgentListContent({
   systemTabLabel,
   pinnedAgent = null,
   defaultRow = null,
-  autoFocusSearch = false
+  autoFocusSearch = false,
+  archivedHiddenCount = 0
 }) {
   const catalog = useAgentCatalog();
   const theme = useAgentCatalogNativeTheme();
@@ -2492,19 +2581,20 @@ function AgentListContent({
     ),
     /* @__PURE__ */ jsx10(View4, { style: hairline }),
     /* @__PURE__ */ jsxs7(View4, { style: [styles6.footer, { paddingHorizontal: theme.spacing.md }], children: [
-      /* @__PURE__ */ jsxs7(
+      /* @__PURE__ */ jsx10(
         Text7,
         {
+          testID: "agent-list-footer",
           style: {
             color: theme.colors.textMuted,
             fontSize: theme.fontSize.xs,
             fontVariant: ["tabular-nums"]
           },
-          children: [
-            agents.length,
-            " agent",
-            agents.length !== 1 ? "s" : ""
-          ]
+          children: agentListFooterLabel({
+            count: agents.length,
+            archFilter: consumer.archFilter,
+            archivedHiddenCount
+          })
         }
       ),
       consumer.searchTerm.length > 0 && /* @__PURE__ */ jsx10(
@@ -2671,6 +2761,7 @@ function AgentPickerBody({
   const [panelSearch, setPanelSearch] = useState3("");
   const {
     agents,
+    archivedHiddenCount,
     isLoading,
     allCategories,
     allTags,
@@ -2742,6 +2833,7 @@ function AgentPickerBody({
       onReset: consumer.resetFilters,
       activeFilterCount,
       tabCounts,
+      archivedHiddenCount,
       ...visibleTabs ? { visibleTabs } : {},
       ...systemTabLabel ?? (includeSystemInAll ? "System" : void 0) ? {
         systemTabLabel: systemTabLabel ?? (includeSystemInAll ? "System" : void 0)