@ai-matrx/agents 0.9.0 → 0.9.2

package/dist/catalog/react/index.js

@@ -117,53 +117,27 @@ function AgentCatalogProvider({
 
 // 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) {
@@ -286,7 +260,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,
@@ -295,6 +272,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,
@@ -330,6 +308,34 @@ import {
   useState as useState2
 } 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 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) {
@@ -346,6 +352,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) {
@@ -422,7 +448,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 ?? "");
@@ -524,8 +562,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;
@@ -555,9 +592,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) {
@@ -598,22 +636,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
@@ -632,6 +703,7 @@ function useAgentListCore({
   initialTab,
   includeSystemInAll = false,
   visibleTabs,
+  initialArchFilter,
   excludeAgentIds = EMPTY_EXCLUDES,
   defaultMandateKey
 }) {
@@ -641,10 +713,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]
@@ -654,19 +730,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(() => {
@@ -746,7 +830,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;
@@ -787,8 +873,15 @@ function useAgentListCore({
     },
     []
   );
+  const footerLabel = agentListFooterLabel({
+    count: agents.length,
+    archFilter: consumer.archFilter,
+    archivedHiddenCount
+  });
   return {
     agents,
+    archivedHiddenCount,
+    footerLabel,
     isLoading,
     activeAgentId,
     pinnedAgent: pinnedAgent ?? null,
@@ -918,6 +1011,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 }]
@@ -988,6 +1093,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");
@@ -1045,13 +1151,17 @@ function FilterChip({
   label,
   active,
   focused,
-  onClick
+  onClick,
+  ariaLabel,
+  testId
 }) {
   return /* @__PURE__ */ jsxs2(
     "button",
     {
       type: "button",
       onClick,
+      ...ariaLabel ? { "aria-label": ariaLabel } : {},
+      ...testId ? { "data-testid": testId } : {},
       className: 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"
@@ -1196,15 +1306,15 @@ function FavoriteAgentButton({
     [id]
   );
   const record = useAgentCatalogState(select);
-  const isFavorite = record?.isFavorite ?? false;
+  const isFavorite2 = record?.isFavorite ?? false;
   const isOwner = record?.isOwner ?? true;
   const handleClick = (e) => {
     e.stopPropagation();
     if (disabled || !isOwner) return;
-    void catalog.setFavorite(id, !isFavorite).catch(() => {
+    void catalog.setFavorite(id, !isFavorite2).catch(() => {
     });
   };
-  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";
   if (variant === "list") {
     return /* @__PURE__ */ jsx6(
       "button",
@@ -1218,14 +1328,14 @@ function FavoriteAgentButton({
         onClick: handleClick,
         disabled: disabled || !isOwner,
         title,
-        "aria-label": isFavorite ? "Remove from favorites" : "Add to favorites",
+        "aria-label": isFavorite2 ? "Remove from favorites" : "Add to favorites",
         children: /* @__PURE__ */ jsx6(
           StarIcon,
           {
-            filled: isFavorite,
+            filled: isFavorite2,
             className: cn2(
               "h-3.5 w-3.5 transition-all duration-150",
-              isFavorite ? "matrx-agent-star-on" : "text-muted-foreground/40 hover:matrx-agent-star-on"
+              isFavorite2 ? "matrx-agent-star-on" : "text-muted-foreground/40 hover:matrx-agent-star-on"
             )
           }
         )
@@ -1240,13 +1350,13 @@ function FavoriteAgentButton({
         "absolute top-2.5 right-2.5 z-10 p-0.5 rounded transition-all duration-150",
         "focus:outline-none focus-visible:ring-2 focus-visible:ring-primary",
         disabled || !isOwner ? "cursor-not-allowed" : "hover:scale-110 cursor-pointer",
-        isFavorite ? "matrx-agent-star-on" : "text-muted-foreground/40 hover:matrx-agent-star-on"
+        isFavorite2 ? "matrx-agent-star-on" : "text-muted-foreground/40 hover:matrx-agent-star-on"
       ),
       onClick: handleClick,
       disabled: disabled || !isOwner,
       title,
-      "aria-label": isFavorite ? "Remove from favorites" : "Add to favorites",
-      children: /* @__PURE__ */ jsx6(StarIcon, { filled: isFavorite, className: "w-4 h-4 transition-all duration-150" })
+      "aria-label": isFavorite2 ? "Remove from favorites" : "Add to favorites",
+      children: /* @__PURE__ */ jsx6(StarIcon, { filled: isFavorite2, className: "w-4 h-4 transition-all duration-150" })
     }
   );
 }
@@ -1474,6 +1584,17 @@ function AgentFilterBar({
         }
       }
     ),
+    /* @__PURE__ */ jsx8(
+      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__ */ jsx8(
       FilterChip,
       {
@@ -1582,6 +1703,7 @@ function AgentRow({
   return /* @__PURE__ */ jsxs7(
     "div",
     {
+      "data-testid": `agent-row-${agent.id}`,
       className: cn5(
         "flex items-center w-full text-left transition-colors group",
         "hover:bg-muted/50 active:bg-muted/70",
@@ -1672,7 +1794,8 @@ function AgentListContent({
   systemTabLabel,
   pinnedAgent = null,
   defaultRow = null,
-  listOpen = false
+  listOpen = false,
+  archivedHiddenCount = 0
 }) {
   const catalog = useAgentCatalog();
   const listScrollRef = useRef3(null);
@@ -1810,11 +1933,18 @@ function AgentListContent({
     ] }) }),
     /* @__PURE__ */ jsx11("div", { className: "h-px bg-border shrink-0" }),
     /* @__PURE__ */ jsxs8("div", { className: "flex items-center justify-between px-2.5 py-1.5 shrink-0", children: [
-      /* @__PURE__ */ jsxs8("span", { className: "text-[10px] text-muted-foreground tabular-nums", children: [
-        agents.length,
-        " agent",
-        agents.length !== 1 ? "s" : ""
-      ] }),
+      /* @__PURE__ */ jsx11(
+        "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__ */ jsx11(
         "button",
         {
@@ -2037,6 +2167,7 @@ function AgentListDropdown({
   const inputRef = useRef4(null);
   const {
     agents,
+    archivedHiddenCount,
     isLoading,
     activeAgentId,
     pinnedAgent,
@@ -2172,6 +2303,7 @@ function AgentListDropdown({
       onFilterChipClick: handleFilterChipClick,
       rightPanel,
       tabCounts,
+      archivedHiddenCount,
       ...visibleTabs ? { visibleTabs } : {},
       ...systemTabLabel ?? (includeSystemInAll ? "System" : void 0) ? {
         systemTabLabel: systemTabLabel ?? (includeSystemInAll ? "System" : void 0)
@@ -2328,6 +2460,7 @@ function AgentListInlinePicker({
   const [mobileSubView, setMobileSubView] = useState4(null);
   const {
     agents,
+    archivedHiddenCount,
     isLoading,
     allCategories,
     allTags,
@@ -2434,6 +2567,7 @@ function AgentListInlinePicker({
       onFilterChipClick: handleFilterChipClick,
       rightPanel: null,
       tabCounts,
+      archivedHiddenCount,
       ...visibleTabs ? { visibleTabs } : {},
       ...systemTabLabel ?? (includeSystemInAll ? "System" : void 0) ? {
         systemTabLabel: systemTabLabel ?? (includeSystemInAll ? "System" : void 0)