@ai-matrx/agents 0.21.40 → 0.21.41

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

@@ -897,6 +897,22 @@ declare function panelHeightBelow(trigger: Element | null, options?: {
     minUsable?: number;
     gap?: number;
 }): string | null;
+/**
+ * 🚨 A SIDE-OPENING PANEL NEVER LEAVES THE SCREEN.
+ *
+ * A host may ask for `side="left"` / `"right"` (the chat composer's presets
+ * panel opens "All agents" to its left). Radix shifts a side-placed popover
+ * only VERTICALLY, so when the 680px panel does not fit on that side it runs
+ * off the screen edge and the search box, tabs and names are cut off (blind run
+ * PB-03, /chat/new in an 800px pane, 2026-10-01). Measured at open time: keep
+ * the asked side when the panel fits there, else the opposite side when it
+ * fits, else open below, where Radix can shift it horizontally into view.
+ * Vertical sides pass through unchanged.
+ */
+declare function sideThatFits(trigger: Element | null, side: "top" | "right" | "bottom" | "left", options?: {
+    width?: number;
+    gap?: number;
+}): "top" | "right" | "bottom" | "left";
 
 interface AgentListContentProps {
     agents: AgentSummary[];
@@ -1104,4 +1120,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, AgentListPanel, AgentListPanelBody, type AgentListPanelBodyProps, type AgentListPanelProps, 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, PANEL_WIDTH, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, panelHeightBelow, 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, AgentListPanel, AgentListPanelBody, type AgentListPanelBodyProps, type AgentListPanelProps, 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, PANEL_WIDTH, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, panelHeightBelow, sideThatFits, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore };

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

@@ -897,6 +897,22 @@ declare function panelHeightBelow(trigger: Element | null, options?: {
     minUsable?: number;
     gap?: number;
 }): string | null;
+/**
+ * 🚨 A SIDE-OPENING PANEL NEVER LEAVES THE SCREEN.
+ *
+ * A host may ask for `side="left"` / `"right"` (the chat composer's presets
+ * panel opens "All agents" to its left). Radix shifts a side-placed popover
+ * only VERTICALLY, so when the 680px panel does not fit on that side it runs
+ * off the screen edge and the search box, tabs and names are cut off (blind run
+ * PB-03, /chat/new in an 800px pane, 2026-10-01). Measured at open time: keep
+ * the asked side when the panel fits there, else the opposite side when it
+ * fits, else open below, where Radix can shift it horizontally into view.
+ * Vertical sides pass through unchanged.
+ */
+declare function sideThatFits(trigger: Element | null, side: "top" | "right" | "bottom" | "left", options?: {
+    width?: number;
+    gap?: number;
+}): "top" | "right" | "bottom" | "left";
 
 interface AgentListContentProps {
     agents: AgentSummary[];
@@ -1104,4 +1120,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, AgentListPanel, AgentListPanelBody, type AgentListPanelBodyProps, type AgentListPanelProps, 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, PANEL_WIDTH, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, panelHeightBelow, 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, AgentListPanel, AgentListPanelBody, type AgentListPanelBodyProps, type AgentListPanelProps, 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, PANEL_WIDTH, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, panelHeightBelow, sideThatFits, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore };

package/dist/catalog/react/index.js

@@ -1561,6 +1561,17 @@ function panelHeightBelow(trigger, options = {}) {
   if (below >= full) return null;
   return below >= minUsable ? `${Math.floor(below)}px` : null;
 }
+function sideThatFits(trigger, side, options = {}) {
+  if (!trigger || typeof window === "undefined" || side !== "left" && side !== "right") return side;
+  const width = options.width ?? 680;
+  const gap = options.gap ?? 16;
+  const rect = trigger.getBoundingClientRect();
+  const room = { left: rect.left - gap, right: window.innerWidth - rect.right - gap };
+  if (room[side] >= width) return side;
+  const other = side === "left" ? "right" : "left";
+  if (room[other] >= width) return other;
+  return "bottom";
+}
 
 // catalog/react/AgentFilterBar.tsx
 import { jsx as jsx8, jsxs as jsxs5 } from "react/jsx-runtime";
@@ -2464,6 +2475,7 @@ function AgentListDropdown({
   const [open, setOpen] = useState4(false);
   const triggerRef = useRef5(null);
   const [fitHeight, setFitHeight] = useState4(null);
+  const [openSide, setOpenSide] = useState4(contentSide);
   const core = useAgentListCore({
     consumerId,
     ...onSelect ? { onSelect } : {},
@@ -2485,6 +2497,7 @@ function AgentListDropdown({
     setOpen(nextOpen);
     if (nextOpen) {
       setFitHeight(contentSide || isMobile ? null : panelHeightBelow(triggerRef.current));
+      setOpenSide(contentSide && !isMobile ? sideThatFits(triggerRef.current, contentSide) : contentSide);
     }
   };
   const resolveAgentHref = useMemo5(() => {
@@ -2545,7 +2558,7 @@ function AgentListDropdown({
     /* @__PURE__ */ jsx16(
       PopoverContent,
       {
-        ...contentSide ? { side: contentSide } : fitHeight ? { side: "bottom" } : {},
+        ...openSide ? { side: openSide } : fitHeight ? { side: "bottom" } : {},
         align: "start",
         sideOffset: 4,
         collisionPadding: 12,
@@ -2736,6 +2749,7 @@ export {
   orchestraLabel,
   orchestraModeLabel,
   panelHeightBelow,
+  sideThatFits,
   useAgentCatalog,
   useAgentCatalogRows,
   useAgentCatalogState,