@ai-matrx/agents 0.14.3 → 0.15.0

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

@@ -765,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;
@@ -1056,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, 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, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore };

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

@@ -765,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;
@@ -1056,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, 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, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore };