@ai-matrx/agents 0.9.1 → 0.9.2

package/dist/catalog/react/index.cjs

@@ -169,53 +169,27 @@ function AgentCatalogProvider({
 
 // catalog/shared/useAgentConsumer.ts
 var import_react3 = require("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 = (0, import_react3.useCallback)(
-    (state) => state.consumers[consumerId] ?? DEFAULT_AGENT_CONSUMER_STATE,
-    [consumerId]
+    (state) => state.consumers[consumerId] ?? defaults,
+    [consumerId, defaults]
   );
   const consumer = useAgentCatalogState(selectConsumer);
   const optionsRef = (0, import_react3.useRef)(options);
   optionsRef.current = options;
   (0, import_react3.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) {
@@ -338,7 +312,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,
@@ -347,6 +324,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,
@@ -376,6 +354,34 @@ function useAgentConsumer(consumerId, options) {
 // catalog/shared/useAgentListCore.ts
 var import_react4 = require("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 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) {
@@ -392,6 +398,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) {
@@ -582,8 +608,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;
@@ -613,9 +638,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) {
@@ -661,6 +687,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) {
@@ -679,7 +714,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(
@@ -692,7 +727,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)
@@ -714,6 +749,7 @@ function useAgentListCore({
   initialTab,
   includeSystemInAll = false,
   visibleTabs,
+  initialArchFilter,
   excludeAgentIds = EMPTY_EXCLUDES,
   defaultMandateKey
 }) {
@@ -723,7 +759,10 @@ function useAgentListCore({
   const [hoveredAgent, setHoveredAgent] = (0, import_react4.useState)(null);
   const hoverLeaveTimerRef = (0, import_react4.useRef)(null);
   const defaultTabAppliedRef = (0, import_react4.useRef)(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);
@@ -737,7 +776,20 @@ function useAgentListCore({
     () => new Set(excludeAgentIds),
     [excludeAgentIds]
   );
-  const agents = excludedAgentIds.size === 0 ? filteredAgents : filteredAgents.filter((agent) => !excludedAgentIds.has(agent.id));
+  const applyExcludes = (0, import_react4.useCallback)(
+    (list) => excludedAgentIds.size === 0 ? list : list.filter((agent) => !excludedAgentIds.has(agent.id)),
+    [excludedAgentIds]
+  );
+  const agents = applyExcludes(filteredAgents);
+  const selectArchivedProbe = (0, import_react4.useMemo)(
+    () => makeSelectFilteredAgents(includeSystemInAll),
+    [includeSystemInAll]
+  );
+  const archiveProbeState = (0, import_react4.useMemo)(
+    () => ({ ...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;
@@ -824,7 +876,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 = (0, import_react4.useCallback)(
     (agent, panelOpen) => {
       if (panelOpen) return;
@@ -865,8 +919,15 @@ function useAgentListCore({
     },
     []
   );
+  const footerLabel = agentListFooterLabel({
+    count: agents.length,
+    archFilter: consumer.archFilter,
+    archivedHiddenCount
+  });
   return {
     agents,
+    archivedHiddenCount,
+    footerLabel,
     isLoading,
     activeAgentId,
     pinnedAgent: pinnedAgent ?? null,
@@ -983,6 +1044,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 }]
@@ -1053,6 +1126,7 @@ var ArrowUpDownIcon = makeIcon("arrowUpDown");
 var FolderIcon = makeIcon("folder");
 var TagIcon = makeIcon("tag");
 var RotateCcwIcon = makeIcon("rotateCcw");
+var ArchiveIcon = makeIcon("archive");
 var LoaderIcon = makeIcon("loader");
 var UsersIcon = makeIcon("users");
 var ClockIcon = makeIcon("clock");
@@ -1110,13 +1184,17 @@ function FilterChip({
   label,
   active,
   focused,
-  onClick
+  onClick,
+  ariaLabel,
+  testId
 }) {
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
     "button",
     {
       type: "button",
       onClick,
+      ...ariaLabel ? { "aria-label": ariaLabel } : {},
+      ...testId ? { "data-testid": testId } : {},
       className: (0, import_design_system.cn)(
         "inline-flex items-center gap-1 h-6 px-1.5 rounded text-[11px] font-medium shrink-0 transition-colors",
         focused ? "bg-primary/15 text-primary border border-primary/30 ring-1 ring-primary/20" : active ? "bg-primary/10 text-primary border border-primary/20" : "text-muted-foreground hover:text-foreground hover:bg-muted/50 border border-transparent"
@@ -1539,6 +1617,17 @@ function AgentFilterBar({
         }
       }
     ),
+    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+      FilterChip,
+      {
+        icon: ArchiveIcon,
+        label: agentArchiveFilterChipLabel(consumer.archFilter),
+        active: consumer.archFilter !== consumer.archFilterDefault,
+        ariaLabel: agentArchiveFilterControlLabel(consumer.archFilter),
+        testId: "agent-archive-filter",
+        onClick: () => consumer.setArchFilter(nextArchFilter(consumer.archFilter))
+      }
+    ),
     allCategories.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
       FilterChip,
       {
@@ -1738,7 +1827,8 @@ function AgentListContent({
   systemTabLabel,
   pinnedAgent = null,
   defaultRow = null,
-  listOpen = false
+  listOpen = false,
+  archivedHiddenCount = 0
 }) {
   const catalog = useAgentCatalog();
   const listScrollRef = (0, import_react6.useRef)(null);
@@ -1876,11 +1966,18 @@ function AgentListContent({
     ] }) }),
     /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("div", { className: "h-px bg-border shrink-0" }),
     /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)("div", { className: "flex items-center justify-between px-2.5 py-1.5 shrink-0", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)("span", { className: "text-[10px] text-muted-foreground tabular-nums", children: [
-        agents.length,
-        " agent",
-        agents.length !== 1 ? "s" : ""
-      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(
+        "span",
+        {
+          "data-testid": "agent-list-footer",
+          className: "text-[10px] text-muted-foreground tabular-nums",
+          children: agentListFooterLabel({
+            count: agents.length,
+            archFilter: consumer.archFilter,
+            archivedHiddenCount
+          })
+        }
+      ),
       consumer.searchTerm && /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(
         "button",
         {
@@ -2103,6 +2200,7 @@ function AgentListDropdown({
   const inputRef = (0, import_react7.useRef)(null);
   const {
     agents,
+    archivedHiddenCount,
     isLoading,
     activeAgentId,
     pinnedAgent,
@@ -2238,6 +2336,7 @@ function AgentListDropdown({
       onFilterChipClick: handleFilterChipClick,
       rightPanel,
       tabCounts,
+      archivedHiddenCount,
       ...visibleTabs ? { visibleTabs } : {},
       ...systemTabLabel ?? (includeSystemInAll ? "System" : void 0) ? {
         systemTabLabel: systemTabLabel ?? (includeSystemInAll ? "System" : void 0)
@@ -2394,6 +2493,7 @@ function AgentListInlinePicker({
   const [mobileSubView, setMobileSubView] = (0, import_react8.useState)(null);
   const {
     agents,
+    archivedHiddenCount,
     isLoading,
     allCategories,
     allTags,
@@ -2500,6 +2600,7 @@ function AgentListInlinePicker({
       onFilterChipClick: handleFilterChipClick,
       rightPanel: null,
       tabCounts,
+      archivedHiddenCount,
       ...visibleTabs ? { visibleTabs } : {},
       ...systemTabLabel ?? (includeSystemInAll ? "System" : void 0) ? {
         systemTabLabel: systemTabLabel ?? (includeSystemInAll ? "System" : void 0)