@ai-matrx/agents 0.13.16 → 0.14.3

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

@@ -280,6 +280,12 @@ interface AgentCatalogLabels {
      * Recorded in the CHANGELOG and dropped rather than ported.)
      */
     systemBadge: string;
+    /**
+     * Badge on an archived row. Archived agents stay offered (THE ARCHIVED-ITEMS
+     * LAW: one or two clicks away) and say so on the row itself. Default
+     * `"Archived"`.
+     */
+    archivedBadge: string;
     searchPlaceholder: string;
     currentAgentHeading: string;
     emptyDefault: string;
@@ -823,6 +829,26 @@ declare const PANEL_HEIGHT = "528px";
  * the popover is open.
  */
 declare const LIST_MAX_HEIGHT = "min(528px, var(--radix-popper-available-height, 528px))";
+/**
+ * 🚨 OPEN BELOW THE CONTROL WHENEVER THERE IS ROOM TO USE IT.
+ *
+ * Radix flips a popover to the side with more room using the panel's FULL
+ * height, so a trigger in the middle of a dialog (the mandate "Use my own"
+ * picker on a 1280x900 screen: 418px below, 528px panel) sent the whole panel
+ * ABOVE it — over the dialog's own title and controls, reading as a list
+ * floating at the top of the screen (2026-09-26). This measures the room
+ * below at open time: when a usable list fits there, the panel is sized to it
+ * and pinned to `side="bottom"`; only when it does not is Radix left to flip.
+ * The height is fixed for the whole time the panel is open, so nothing moves
+ * under the cursor (the reason the footprint is fixed at all).
+ *
+ * Returns a px height, or `null` for "use the default footprint and placement".
+ */
+declare function panelHeightBelow(trigger: Element | null, options?: {
+    full?: number;
+    minUsable?: number;
+    gap?: number;
+}): string | null;
 
 interface AgentListContentProps {
     agents: AgentSummary[];
@@ -1030,4 +1056,4 @@ declare function orchestraDepthLine(badge: OrchestraBadge): string | null;
  */
 declare function orchestraDelegatesLine(badge: OrchestraBadge, limit?: number): string | null;
 
-export { type AgentCatalogLinkComponent, AgentCatalogProvider, type AgentCatalogProviderProps, type AgentCatalogRenderModelRef, type AgentCatalogUiPorts, AgentCategoriesPanel, type AgentCategoriesPanelProps, AgentDetailCard, type AgentDetailCardProps, AgentFilterBar, type AgentFilterBarProps, AgentListContent, type AgentListContentProps, type AgentListCoreOptions, AgentListDropdown, type AgentListDropdownProps, AgentListInlinePicker, type AgentListInlinePickerProps, type AgentListTabCounts, AgentListTabs, AgentMobileSubView, type AgentMobileSubViewProps, AgentRow, type AgentRowProps, AgentSortPanel, type AgentSortPanelProps, AgentTagsPanel, type AgentTagsPanelProps, CheckRow, FavoriteAgentButton, FilterChip, HOVER_GRACE_MS, type IconProps, LIST_MAX_HEIGHT, Music4Icon, OptionRow, type OrchestraBadge, PANEL_HEIGHT, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore };
+export { type AgentCatalogLinkComponent, AgentCatalogProvider, type AgentCatalogProviderProps, type AgentCatalogRenderModelRef, type AgentCatalogUiPorts, AgentCategoriesPanel, type AgentCategoriesPanelProps, AgentDetailCard, type AgentDetailCardProps, AgentFilterBar, type AgentFilterBarProps, AgentListContent, type AgentListContentProps, type AgentListCoreOptions, AgentListDropdown, type AgentListDropdownProps, AgentListInlinePicker, type AgentListInlinePickerProps, type AgentListTabCounts, AgentListTabs, AgentMobileSubView, type AgentMobileSubViewProps, AgentRow, type AgentRowProps, AgentSortPanel, type AgentSortPanelProps, AgentTagsPanel, type AgentTagsPanelProps, CheckRow, FavoriteAgentButton, FilterChip, HOVER_GRACE_MS, type IconProps, LIST_MAX_HEIGHT, Music4Icon, OptionRow, type OrchestraBadge, PANEL_HEIGHT, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, panelHeightBelow, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore };

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

@@ -280,6 +280,12 @@ interface AgentCatalogLabels {
      * Recorded in the CHANGELOG and dropped rather than ported.)
      */
     systemBadge: string;
+    /**
+     * Badge on an archived row. Archived agents stay offered (THE ARCHIVED-ITEMS
+     * LAW: one or two clicks away) and say so on the row itself. Default
+     * `"Archived"`.
+     */
+    archivedBadge: string;
     searchPlaceholder: string;
     currentAgentHeading: string;
     emptyDefault: string;
@@ -823,6 +829,26 @@ declare const PANEL_HEIGHT = "528px";
  * the popover is open.
  */
 declare const LIST_MAX_HEIGHT = "min(528px, var(--radix-popper-available-height, 528px))";
+/**
+ * 🚨 OPEN BELOW THE CONTROL WHENEVER THERE IS ROOM TO USE IT.
+ *
+ * Radix flips a popover to the side with more room using the panel's FULL
+ * height, so a trigger in the middle of a dialog (the mandate "Use my own"
+ * picker on a 1280x900 screen: 418px below, 528px panel) sent the whole panel
+ * ABOVE it — over the dialog's own title and controls, reading as a list
+ * floating at the top of the screen (2026-09-26). This measures the room
+ * below at open time: when a usable list fits there, the panel is sized to it
+ * and pinned to `side="bottom"`; only when it does not is Radix left to flip.
+ * The height is fixed for the whole time the panel is open, so nothing moves
+ * under the cursor (the reason the footprint is fixed at all).
+ *
+ * Returns a px height, or `null` for "use the default footprint and placement".
+ */
+declare function panelHeightBelow(trigger: Element | null, options?: {
+    full?: number;
+    minUsable?: number;
+    gap?: number;
+}): string | null;
 
 interface AgentListContentProps {
     agents: AgentSummary[];
@@ -1030,4 +1056,4 @@ declare function orchestraDepthLine(badge: OrchestraBadge): string | null;
  */
 declare function orchestraDelegatesLine(badge: OrchestraBadge, limit?: number): string | null;
 
-export { type AgentCatalogLinkComponent, AgentCatalogProvider, type AgentCatalogProviderProps, type AgentCatalogRenderModelRef, type AgentCatalogUiPorts, AgentCategoriesPanel, type AgentCategoriesPanelProps, AgentDetailCard, type AgentDetailCardProps, AgentFilterBar, type AgentFilterBarProps, AgentListContent, type AgentListContentProps, type AgentListCoreOptions, AgentListDropdown, type AgentListDropdownProps, AgentListInlinePicker, type AgentListInlinePickerProps, type AgentListTabCounts, AgentListTabs, AgentMobileSubView, type AgentMobileSubViewProps, AgentRow, type AgentRowProps, AgentSortPanel, type AgentSortPanelProps, AgentTagsPanel, type AgentTagsPanelProps, CheckRow, FavoriteAgentButton, FilterChip, HOVER_GRACE_MS, type IconProps, LIST_MAX_HEIGHT, Music4Icon, OptionRow, type OrchestraBadge, PANEL_HEIGHT, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore };
+export { type AgentCatalogLinkComponent, AgentCatalogProvider, type AgentCatalogProviderProps, type AgentCatalogRenderModelRef, type AgentCatalogUiPorts, AgentCategoriesPanel, type AgentCategoriesPanelProps, AgentDetailCard, type AgentDetailCardProps, AgentFilterBar, type AgentFilterBarProps, AgentListContent, type AgentListContentProps, type AgentListCoreOptions, AgentListDropdown, type AgentListDropdownProps, AgentListInlinePicker, type AgentListInlinePickerProps, type AgentListTabCounts, AgentListTabs, AgentMobileSubView, type AgentMobileSubViewProps, AgentRow, type AgentRowProps, AgentSortPanel, type AgentSortPanelProps, AgentTagsPanel, type AgentTagsPanelProps, CheckRow, FavoriteAgentButton, FilterChip, HOVER_GRACE_MS, type IconProps, LIST_MAX_HEIGHT, Music4Icon, OptionRow, type OrchestraBadge, PANEL_HEIGHT, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, panelHeightBelow, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore };

package/dist/catalog/react/index.js

@@ -1549,6 +1549,15 @@ import { useEffect as useEffect3, useRef as useRef3 } from "react";
 // catalog/react/types.ts
 var PANEL_HEIGHT = "528px";
 var LIST_MAX_HEIGHT = "min(528px, var(--radix-popper-available-height, 528px))";
+function panelHeightBelow(trigger, options = {}) {
+  if (!trigger || typeof window === "undefined") return null;
+  const full = options.full ?? 528;
+  const minUsable = options.minUsable ?? 300;
+  const gap = options.gap ?? 16;
+  const below = window.innerHeight - trigger.getBoundingClientRect().bottom - gap;
+  if (below >= full) return null;
+  return below >= minUsable ? `${Math.floor(below)}px` : null;
+}
 
 // catalog/react/AgentFilterBar.tsx
 import { jsx as jsx8, jsxs as jsxs5 } from "react/jsx-runtime";
@@ -1747,7 +1756,15 @@ function AgentRow({
                   ]
                 }
               ),
-              agent.agentType === "builtin" ? /* @__PURE__ */ jsx10("span", { className: "text-[9px] font-medium text-primary bg-primary/10 px-1 py-px rounded shrink-0 ml-auto", children: labels.systemBadge }) : agent.isOwner === false ? /* @__PURE__ */ jsx10("span", { className: "text-[9px] text-muted-foreground bg-muted px-1 py-px rounded shrink-0 ml-auto", children: "shared" }) : null
+              agent.isArchived ? /* @__PURE__ */ jsx10(
+                "span",
+                {
+                  "data-testid": `agent-archived-badge-${agent.id}`,
+                  className: "text-[9px] font-medium text-muted-foreground bg-muted px-1 py-px rounded shrink-0 ml-auto",
+                  children: labels.archivedBadge
+                }
+              ) : null,
+              agent.agentType === "builtin" ? /* @__PURE__ */ jsx10("span", { className: cn5("text-[9px] font-medium text-primary bg-primary/10 px-1 py-px rounded shrink-0", !agent.isArchived && "ml-auto"), children: labels.systemBadge }) : agent.isOwner === false ? /* @__PURE__ */ jsx10("span", { className: cn5("text-[9px] text-muted-foreground bg-muted px-1 py-px rounded shrink-0", !agent.isArchived && "ml-auto"), children: "shared" }) : null
             ]
           }
         ),
@@ -2178,6 +2195,8 @@ function AgentListDropdown({
   const [mobileDetailAgent, setMobileDetailAgent] = useState3(null);
   const [mobileSubView, setMobileSubView] = useState3(null);
   const inputRef = useRef4(null);
+  const triggerRef = useRef4(null);
+  const [fitHeight, setFitHeight] = useState3(null);
   const {
     agents,
     archivedHiddenCount,
@@ -2217,6 +2236,7 @@ function AgentListDropdown({
   const handleOpen = (nextOpen) => {
     setOpen(nextOpen);
     if (nextOpen) {
+      setFitHeight(contentSide || isMobile ? null : panelHeightBelow(triggerRef.current));
       ensureLoaded();
       if (pinnedAgent && !isMobile) {
         setHoveredAgent(pinnedAgent);
@@ -2288,10 +2308,10 @@ function AgentListDropdown({
   );
   const wrapTrigger = (Trigger) => {
     if (!showAssignedTooltip) {
-      return /* @__PURE__ */ jsx15(Trigger, { asChild: true, children: triggerButton });
+      return /* @__PURE__ */ jsx15(Trigger, { asChild: true, ref: triggerRef, children: triggerButton });
     }
     return /* @__PURE__ */ jsxs12(Tooltip, { ...open ? { open: false } : {}, children: [
-      /* @__PURE__ */ jsx15(Trigger, { asChild: true, children: /* @__PURE__ */ jsx15(TooltipTrigger, { asChild: true, children: triggerButton }) }),
+      /* @__PURE__ */ jsx15(Trigger, { asChild: true, ref: triggerRef, children: /* @__PURE__ */ jsx15(TooltipTrigger, { asChild: true, children: triggerButton }) }),
       /* @__PURE__ */ jsx15(TooltipContent, { side: "bottom", className: "max-w-xs", children: displayLabel })
     ] });
   };
@@ -2378,14 +2398,14 @@ function AgentListDropdown({
     /* @__PURE__ */ jsx15(
       PopoverContent,
       {
-        ...contentSide ? { side: contentSide } : {},
+        ...contentSide ? { side: contentSide } : fitHeight ? { side: "bottom" } : {},
         align: "start",
         sideOffset: 4,
         collisionPadding: 12,
         sticky: "always",
         ...popoverContainer ? { container: popoverContainer } : {},
         className: "p-0 overflow-hidden w-[680px]",
-        style: { height: PANEL_HEIGHT, maxHeight: LIST_MAX_HEIGHT },
+        style: { height: fitHeight ?? PANEL_HEIGHT, maxHeight: fitHeight ?? LIST_MAX_HEIGHT },
         children: /* @__PURE__ */ jsxs12("div", { className: "flex h-full", children: [
           /* @__PURE__ */ jsx15("div", { className: "flex flex-col min-w-0 w-[340px] shrink-0 border-r border-border", children: listPanel }),
           /* @__PURE__ */ jsxs12(
@@ -2621,6 +2641,7 @@ export {
   orchestraDepthLine,
   orchestraLabel,
   orchestraModeLabel,
+  panelHeightBelow,
   useAgentCatalog,
   useAgentCatalogRows,
   useAgentCatalogState,