@ai-matrx/agents 0.14.0 → 0.15.0

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;
@@ -759,6 +765,54 @@ interface AgentListDropdownProps {
 }
 declare function AgentListDropdown({ onSelect, navigateTo, className, label, triggerSlot, noBorder, compact, activeAgentId: activeAgentIdProp, contentSide, consumerId, initialTab, includeSystemInAll, visibleTabs, systemTabLabel, resolveAgentHref: resolveAgentHrefProp, showPinnedAgent, excludeAgentIds, defaultMandateKey, }: AgentListDropdownProps): react.JSX.Element;
 
+/** The desktop picker's fixed footprint: a 340px list + a 340px peek. */
+declare const PANEL_WIDTH = "680px";
+type AgentListCore = ReturnType<typeof useAgentListCore>;
+interface AgentListPanelDisplayProps {
+    /** Restrict which ownership tabs are available for domain-constrained pickers. */
+    visibleTabs?: readonly AgentTab[];
+    /** Label override for the builtin-agent tab. Admin surfaces use "System". */
+    systemTabLabel?: string;
+    /** ADMIN variant: blend system agents into the "All" tab (also labels it "System"). */
+    includeSystemInAll?: boolean;
+    /** Resolve the route used by each named agent door. */
+    resolveAgentHref?: (agent: AgentSummary) => string;
+    /** Show the active agent above the filtered list. Default true. */
+    showPinnedAgent?: boolean;
+    /** Focus the search field when the picker appears. Default true. */
+    autoFocusSearch?: boolean;
+    /** Runs after an agent is chosen (the core has already called `onSelect`). */
+    onAfterSelect?: (agent: AgentSummary) => void;
+    className?: string;
+}
+interface AgentListPanelBodyProps extends AgentListPanelDisplayProps {
+    /** The list core the host holds (`useAgentListCore`). */
+    core: AgentListCore;
+}
+/** The picker body over a core the host already holds. Fills its parent. */
+declare function AgentListPanelBody({ core, visibleTabs, systemTabLabel, includeSystemInAll, resolveAgentHref, showPinnedAgent, autoFocusSearch, onAfterSelect, className, }: AgentListPanelBodyProps): react.JSX.Element;
+interface AgentListPanelProps extends AgentListPanelDisplayProps {
+    /** Unique consumer id for this picker's filter/tab state. */
+    consumerId: string;
+    /** The chosen agent's id (`mandate:<key>` for a mandate default row). */
+    onSelect?: (agentId: string) => void;
+    /** Navigate on select instead of (or besides) `onSelect`; `{id}` is replaced. */
+    navigateTo?: string;
+    /** Highlights + pins this agent in the list. */
+    activeAgentId?: string | null;
+    /** Tab to open on. Admin surfaces managing system agents pass `"system"`. */
+    initialTab?: AgentTab;
+    /** Hide records that are invalid for this call site. */
+    excludeAgentIds?: readonly string[];
+    /** Offer the mandate's live-resolved default agent at the top of the list. */
+    defaultMandateKey?: string;
+}
+/**
+ * The self-contained picker: owns its list core. Desktop renders at the fixed
+ * `PANEL_WIDTH` × `PANEL_HEIGHT` footprint; mobile fills its parent.
+ */
+declare function AgentListPanel({ consumerId, onSelect, navigateTo, activeAgentId, initialTab, includeSystemInAll, visibleTabs, excludeAgentIds, defaultMandateKey, resolveAgentHref: resolveAgentHrefProp, className, ...display }: AgentListPanelProps): react.JSX.Element;
+
 interface AgentListInlinePickerProps {
     /** Unique consumer id for filter/tab state (see `useAgentConsumer`). */
     consumerId: string;
@@ -823,6 +877,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 +1104,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, 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 };

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;
@@ -759,6 +765,54 @@ interface AgentListDropdownProps {
 }
 declare function AgentListDropdown({ onSelect, navigateTo, className, label, triggerSlot, noBorder, compact, activeAgentId: activeAgentIdProp, contentSide, consumerId, initialTab, includeSystemInAll, visibleTabs, systemTabLabel, resolveAgentHref: resolveAgentHrefProp, showPinnedAgent, excludeAgentIds, defaultMandateKey, }: AgentListDropdownProps): react.JSX.Element;
 
+/** The desktop picker's fixed footprint: a 340px list + a 340px peek. */
+declare const PANEL_WIDTH = "680px";
+type AgentListCore = ReturnType<typeof useAgentListCore>;
+interface AgentListPanelDisplayProps {
+    /** Restrict which ownership tabs are available for domain-constrained pickers. */
+    visibleTabs?: readonly AgentTab[];
+    /** Label override for the builtin-agent tab. Admin surfaces use "System". */
+    systemTabLabel?: string;
+    /** ADMIN variant: blend system agents into the "All" tab (also labels it "System"). */
+    includeSystemInAll?: boolean;
+    /** Resolve the route used by each named agent door. */
+    resolveAgentHref?: (agent: AgentSummary) => string;
+    /** Show the active agent above the filtered list. Default true. */
+    showPinnedAgent?: boolean;
+    /** Focus the search field when the picker appears. Default true. */
+    autoFocusSearch?: boolean;
+    /** Runs after an agent is chosen (the core has already called `onSelect`). */
+    onAfterSelect?: (agent: AgentSummary) => void;
+    className?: string;
+}
+interface AgentListPanelBodyProps extends AgentListPanelDisplayProps {
+    /** The list core the host holds (`useAgentListCore`). */
+    core: AgentListCore;
+}
+/** The picker body over a core the host already holds. Fills its parent. */
+declare function AgentListPanelBody({ core, visibleTabs, systemTabLabel, includeSystemInAll, resolveAgentHref, showPinnedAgent, autoFocusSearch, onAfterSelect, className, }: AgentListPanelBodyProps): react.JSX.Element;
+interface AgentListPanelProps extends AgentListPanelDisplayProps {
+    /** Unique consumer id for this picker's filter/tab state. */
+    consumerId: string;
+    /** The chosen agent's id (`mandate:<key>` for a mandate default row). */
+    onSelect?: (agentId: string) => void;
+    /** Navigate on select instead of (or besides) `onSelect`; `{id}` is replaced. */
+    navigateTo?: string;
+    /** Highlights + pins this agent in the list. */
+    activeAgentId?: string | null;
+    /** Tab to open on. Admin surfaces managing system agents pass `"system"`. */
+    initialTab?: AgentTab;
+    /** Hide records that are invalid for this call site. */
+    excludeAgentIds?: readonly string[];
+    /** Offer the mandate's live-resolved default agent at the top of the list. */
+    defaultMandateKey?: string;
+}
+/**
+ * The self-contained picker: owns its list core. Desktop renders at the fixed
+ * `PANEL_WIDTH` × `PANEL_HEIGHT` footprint; mobile fills its parent.
+ */
+declare function AgentListPanel({ consumerId, onSelect, navigateTo, activeAgentId, initialTab, includeSystemInAll, visibleTabs, excludeAgentIds, defaultMandateKey, resolveAgentHref: resolveAgentHrefProp, className, ...display }: AgentListPanelProps): react.JSX.Element;
+
 interface AgentListInlinePickerProps {
     /** Unique consumer id for filter/tab state (see `useAgentConsumer`). */
     consumerId: string;
@@ -823,6 +877,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 +1104,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, 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 };