@ai-matrx/agents 0.9.0 → 0.9.2

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) {
@@ -525,7 +551,19 @@ function memoize2(fn) {
     return last;
   };
 }
+function compareAgentIds(a, b) {
+  const idA = a.id ?? "";
+  const idB = b.id ?? "";
+  if (idA < idB) return -1;
+  if (idA > idB) return 1;
+  return 0;
+}
 function applyAgentSortComparator(a, b, sortBy) {
+  const primary = compareAgentSortKey(a, b, sortBy);
+  if (!Number.isFinite(primary) || primary === 0) return compareAgentIds(a, b);
+  return primary;
+}
+function compareAgentSortKey(a, b, sortBy) {
   switch (sortBy) {
     case "name-asc":
       return (a.name ?? "").localeCompare(b.name ?? "");
@@ -627,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;
@@ -658,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) {
@@ -701,22 +739,55 @@ var makeSelectFilteredAgents = (includeSystemInAll = false) => memoize2(
     return filterUserTypeAgents(userAgents, consumer);
   }
 );
+function agentMatchesArchiveFilter(agent, archFilter) {
+  if (archFilter === "active") return !agent.isArchived;
+  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) {
+    if (a.agentType !== "user") continue;
+    if (!agentMatchesArchiveFilter(a, archFilter)) continue;
+    if (predicate(a)) n += 1;
+  }
+  return n;
+}
+var isOwned = (a) => a.isOwner === true;
+var isShared = (a) => a.isOwner === false && a.accessLevel != null;
+var isAny = () => true;
+var isFavorite = (a) => Boolean(a.isFavorite);
+var selectAgentTabCounts = memoize2(
+  (agents, archFilter) => ({
+    mine: countUserRows(agents, archFilter, isOwned),
+    shared: countUserRows(agents, archFilter, isShared),
+    all: countUserRows(agents, archFilter, isAny),
+    system: countBuiltinRows(agents, archFilter)
+  })
+);
 var selectTotalUserAgentsCount = memoize1(
-  (agents) => selectUserTypeAgents(agents).length
+  (agents) => countUserRows(agents, "active", isAny)
 );
 var selectTotalOwnedAgentsCount = memoize1(
-  (agents) => selectUserTypeAgents(agents).filter((a) => a.isOwner === true).length
+  (agents) => countUserRows(agents, "active", isOwned)
 );
 var selectTotalSharedAgentsCount = memoize1(
-  (agents) => selectUserTypeAgents(agents).filter(
-    (a) => a.isOwner === false && a.accessLevel != null
-  ).length
+  (agents) => countUserRows(agents, "active", isShared)
 );
 var selectTotalBuiltinAgentsCount = memoize1(
-  (agents) => selectBuiltinTypeAgents(agents).length
+  (agents) => countBuiltinRows(agents, "active")
 );
 var selectTotalFavoriteAgentsCount = memoize1(
-  (agents) => selectUserTypeAgents(agents).filter((a) => a.isFavorite).length
+  (agents) => countUserRows(agents, "active", isFavorite)
 );
 
 // catalog/shared/useAgentListCore.ts
@@ -735,6 +806,7 @@ function useAgentListCore({
   initialTab,
   includeSystemInAll = false,
   visibleTabs,
+  initialArchFilter,
   excludeAgentIds = EMPTY_EXCLUDES,
   defaultMandateKey
 }) {
@@ -744,10 +816,14 @@ 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 ownedCount = selectTotalOwnedAgentsCount(rows);
+  const tabCountsForFilter = selectAgentTabCounts(rows, consumer.state.archFilter);
+  const ownedCount = tabCountsForFilter.mine;
   const selectFiltered = useMemo3(
     () => makeSelectFilteredAgents(includeSystemInAll),
     [includeSystemInAll]
@@ -757,19 +833,27 @@ 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;
   const onSystemTab = consumer.tab === "system";
   const allCategories = onSystemTab ? selectAllSystemAgentCategories(rows) : selectAllAgentCategories(rows);
   const allTags = onSystemTab ? selectAllSystemAgentTags(rows) : selectAllAgentTags(rows);
-  const tabCounts = {
-    mine: ownedCount,
-    shared: selectTotalSharedAgentsCount(rows),
-    all: selectTotalUserAgentsCount(rows),
-    system: selectTotalBuiltinAgentsCount(rows)
-  };
+  const tabCounts = tabCountsForFilter;
   const isLoading = status === "loading";
   const agentsLoaded = status === "succeeded" || status === "failed";
   const ensureLoaded = useCallback3(() => {
@@ -849,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;
@@ -890,8 +976,15 @@ function useAgentListCore({
     },
     []
   );
+  const footerLabel = agentListFooterLabel({
+    count: agents.length,
+    archFilter: consumer.archFilter,
+    archivedHiddenCount
+  });
   return {
     agents,
+    archivedHiddenCount,
+    footerLabel,
     isLoading,
     activeAgentId,
     pinnedAgent: pinnedAgent ?? null,
@@ -1034,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 }]
@@ -1103,6 +1208,7 @@ var TEXT_GLYPHS = {
   folder: "\u25A4",
   tag: "\u2317",
   rotateCcw: "\u21BA",
+  archive: "\u25A3",
   loader: "\u25CC",
   alertTriangle: "\u26A0",
   music4: "\u266A",
@@ -1185,31 +1291,31 @@ function FavoriteAgentButton({
   const theme = useAgentCatalogNativeTheme();
   const select = useCallback4((state) => state.byId[id], [id]);
   const record = useAgentCatalogState(select);
-  const isFavorite = record?.isFavorite ?? false;
+  const isFavorite2 = record?.isFavorite ?? false;
   const isOwner = record?.isOwner ?? true;
   const inert = Boolean(disabled) || !isOwner;
-  const title = isOwner ? isFavorite ? "Remove from favorites" : "Add to favorites" : "Shared \u2014 cannot favorite";
+  const title = isOwner ? isFavorite2 ? "Remove from favorites" : "Add to favorites" : "Shared \u2014 cannot favorite";
   return /* @__PURE__ */ jsx4(
     Pressable2,
     {
       onPress: () => {
         if (inert) return;
-        void catalog.setFavorite(id, !isFavorite).catch(() => {
+        void catalog.setFavorite(id, !isFavorite2).catch(() => {
         });
       },
       disabled: inert,
       hitSlop: 8,
       accessibilityRole: "button",
       accessibilityLabel: title,
-      accessibilityState: { disabled: inert, selected: isFavorite },
+      accessibilityState: { disabled: inert, selected: isFavorite2 },
       style: { opacity: inert ? 0.4 : 1 },
       children: /* @__PURE__ */ jsx4(
         AgentIcon,
         {
           name: "star",
           size,
-          filled: isFavorite,
-          color: isFavorite ? theme.colors.favorite : theme.colors.textFaint,
+          filled: isFavorite2,
+          color: isFavorite2 ? theme.colors.favorite : theme.colors.textFaint,
           report: catalog.errorSink
         }
       )
@@ -1616,7 +1722,9 @@ function FilterChip({
   icon,
   label,
   active,
-  onPress
+  onPress,
+  accessibilityLabel,
+  testID
 }) {
   const theme = useAgentCatalogNativeTheme();
   const { errorSink } = useAgentCatalog();
@@ -1627,7 +1735,8 @@ function FilterChip({
       onPress,
       accessibilityRole: "button",
       accessibilityState: { selected: active },
-      accessibilityLabel: label,
+      accessibilityLabel: accessibilityLabel ?? label,
+      ...testID ? { testID } : {},
       style: ({ pressed }) => [
         styles2.chip,
         {
@@ -1886,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,
           {
@@ -2232,7 +2352,8 @@ function AgentListContent({
   systemTabLabel,
   pinnedAgent = null,
   defaultRow = null,
-  autoFocusSearch = false
+  autoFocusSearch = false,
+  archivedHiddenCount = 0
 }) {
   const catalog = useAgentCatalog();
   const theme = useAgentCatalogNativeTheme();
@@ -2460,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(
@@ -2639,6 +2761,7 @@ function AgentPickerBody({
   const [panelSearch, setPanelSearch] = useState3("");
   const {
     agents,
+    archivedHiddenCount,
     isLoading,
     allCategories,
     allTags,
@@ -2710,6 +2833,7 @@ function AgentPickerBody({
       onReset: consumer.resetFilters,
       activeFilterCount,
       tabCounts,
+      archivedHiddenCount,
       ...visibleTabs ? { visibleTabs } : {},
       ...systemTabLabel ?? (includeSystemInAll ? "System" : void 0) ? {
         systemTabLabel: systemTabLabel ?? (includeSystemInAll ? "System" : void 0)