@ai-matrx/agents 0.8.0 → 0.9.0

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

@@ -418,10 +418,23 @@ interface AgentCatalog {
 }
 
 /**
- * The anchor a row renders for cmd/ctrl-click. DEFAULT: a plain `<a>` — which
- * is a REAL, working link in every framework. A Next.js host passes
- * `next/link`; a TanStack host passes its own `Link`.
+ * The anchor a row renders for cmd/ctrl-click. DEFAULT (web): a plain `<a>` —
+ * which is a REAL, working link in every framework. A Next.js host passes
+ * `next/link`; a TanStack host passes its own `Link`. On React Native the
+ * default is a pressable `Text` that routes through `navigate`.
  */
+/**
+ * What a row's link handler receives. A DOM `React.MouseEvent` satisfies this
+ * structurally, and the native default link supplies the two methods itself —
+ * so a shared component can call `preventDefault()` on either platform
+ * without a platform check.
+ */
+interface AgentCatalogLinkClickEvent {
+    metaKey?: boolean;
+    ctrlKey?: boolean;
+    preventDefault(): void;
+    stopPropagation(): void;
+}
 type AgentCatalogLinkComponent = ComponentType<{
     href: string;
     className?: string;
@@ -429,7 +442,7 @@ type AgentCatalogLinkComponent = ComponentType<{
     rel?: string;
     title?: string;
     "aria-label"?: string;
-    onClick?: (e: React.MouseEvent<HTMLAnchorElement>) => void;
+    onClick?: (e: AgentCatalogLinkClickEvent) => void;
     children: ReactNode;
 }>;
 /** Render a model id as whatever door the host has. DEFAULT: plain text. */
@@ -438,9 +451,9 @@ type AgentCatalogRenderModelRef = (args: {
     className?: string;
 }) => ReactNode;
 interface AgentCatalogUiPorts {
-    /** DEFAULT: `window.location.assign`. */
+    /** DEFAULT (web): `window.location.assign`. DEFAULT (native): a reporting no-op. */
     navigate?: AgentCatalogNavigate;
-    /** DEFAULT: a plain `<a>`. */
+    /** DEFAULT: a plain `<a>` (web) / a pressable `Text` (native). */
     LinkComponent?: AgentCatalogLinkComponent;
     /** DEFAULT: the model id as plain text. */
     renderModelRef?: AgentCatalogRenderModelRef;
@@ -449,14 +462,10 @@ interface AgentCatalogUiPorts {
     /**
      * Portal container for the desktop popover, when the picker is mounted
      * inside a dialog. DEFAULT: the document body (Radix's own default).
+     * Web only — the native entry ignores it.
      */
     popoverContainer?: HTMLElement | null;
 }
-interface AgentCatalogProviderProps extends AgentCatalogUiPorts {
-    catalog: AgentCatalog;
-    children: ReactNode;
-}
-declare function AgentCatalogProvider({ catalog, children, ...ports }: AgentCatalogProviderProps): react.JSX.Element;
 /** The headless catalog this tree is bound to. Throws with no provider. */
 declare function useAgentCatalog(): AgentCatalog;
 /** The UI ports this tree is bound to, with every default already applied. */
@@ -474,6 +483,30 @@ declare function useAgentCatalogState<T>(select: (state: AgentCatalogState) => T
 /** Every row currently in the catalogue, as one stable array. */
 declare function useAgentCatalogRows(): AgentSummary[];
 
+interface AgentCatalogProviderProps extends AgentCatalogUiPorts {
+    catalog: AgentCatalog;
+    children: ReactNode;
+}
+declare function AgentCatalogProvider({ catalog, children, ...ports }: AgentCatalogProviderProps): react.JSX.Element;
+
+/**
+ * catalog/shared/useAgentConsumer.ts — VERBATIM port of matrx-frontend
+ * `features/agents/hooks/useAgentConsumer.ts`.
+ *
+ * Wraps a single consumer slot identified by `consumerId`. Registers the slot
+ * on mount, optionally unregisters on unmount, and returns every filter/sort/
+ * pagination value plus stable write helpers.
+ *
+ * Two seams inverted, nothing else:
+ *   - `useAppSelector`/`useAppDispatch` → `useAgentCatalog()` + the store's
+ *     own methods.
+ *   - `useServerAgentSearch` (a separate frontend hook) is folded IN, because
+ *     it was already wired here and nowhere else: EVERY agent surface that
+ *     uses a consumer searches the full server-side set. A local-only search
+ *     over a paginated list reports "no results" for agents that were merely
+ *     never fetched — a wrong answer, not a missing feature.
+ */
+
 interface UseAgentConsumerReturn {
     tab: AgentTab;
     sortBy: AgentSortOption;
@@ -530,26 +563,17 @@ declare function useAgentConsumer(consumerId: string, options?: {
     initialTab?: AgentTab;
 }): UseAgentConsumerReturn;
 
+/**
+ * The four ownership counts a tab strip prints. Declared HERE, beside the code
+ * that computes them, so both the web tab strip and the native one name the
+ * same shape (0.9.0 — it used to live in the web-only `AgentListTabs`).
+ */
 interface AgentListTabCounts {
     mine: number;
     shared: number;
     all: number;
     system: number;
 }
-interface AgentListTabsProps {
-    consumer: UseAgentConsumerReturn;
-    tabCounts: AgentListTabCounts;
-    /** Limit the ownership tabs for constrained pickers. */
-    visibleTabs?: readonly AgentTab[] | undefined;
-    /**
-     * Label for the builtin-agent tab. Users see "Public" (that is what a
-     * platform agent is to them); ADMIN surfaces pass "System", because there
-     * these are the agents they own and maintain.
-     */
-    systemTabLabel?: string | undefined;
-}
-declare function AgentListTabs({ consumer, tabCounts, systemTabLabel, visibleTabs, }: AgentListTabsProps): react.JSX.Element;
-
 interface AgentListCoreOptions {
     consumerId: string;
     onSelect?: (agentId: string) => void;
@@ -707,6 +731,20 @@ interface AgentListInlinePickerProps {
 }
 declare function AgentListInlinePicker({ consumerId, onSelect, activeAgentId, className, autoFocusSearch, initialTab, includeSystemInAll, visibleTabs, systemTabLabel, resolveAgentHref, showPinnedAgent, excludeAgentIds, defaultMandateKey, }: AgentListInlinePickerProps): react.JSX.Element;
 
+interface AgentListTabsProps {
+    consumer: UseAgentConsumerReturn;
+    tabCounts: AgentListTabCounts;
+    /** Limit the ownership tabs for constrained pickers. */
+    visibleTabs?: readonly AgentTab[] | undefined;
+    /**
+     * Label for the builtin-agent tab. Users see "Public" (that is what a
+     * platform agent is to them); ADMIN surfaces pass "System", because there
+     * these are the agents they own and maintain.
+     */
+    systemTabLabel?: string | undefined;
+}
+declare function AgentListTabs({ consumer, tabCounts, systemTabLabel, visibleTabs, }: AgentListTabsProps): react.JSX.Element;
+
 /**
  * catalog/react/types.ts — VERBATIM port of matrx-frontend
  * `features/agents/components/agent-listings/core/types.ts`.
@@ -886,7 +924,7 @@ type IconProps = SVGProps<SVGSVGElement> & {
  * picker used for a conductor, kept identical so the same agent wears the same
  * mark in every client.
  */
-declare function Music4Icon(props: IconProps): react.JSX.Element;
+declare const Music4Icon: (props: IconProps) => react.JSX.Element;
 
 /**
  * catalog/orchestra.ts — @ai-matrx/agents/catalog

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

@@ -418,10 +418,23 @@ interface AgentCatalog {
 }
 
 /**
- * The anchor a row renders for cmd/ctrl-click. DEFAULT: a plain `<a>` — which
- * is a REAL, working link in every framework. A Next.js host passes
- * `next/link`; a TanStack host passes its own `Link`.
+ * The anchor a row renders for cmd/ctrl-click. DEFAULT (web): a plain `<a>` —
+ * which is a REAL, working link in every framework. A Next.js host passes
+ * `next/link`; a TanStack host passes its own `Link`. On React Native the
+ * default is a pressable `Text` that routes through `navigate`.
  */
+/**
+ * What a row's link handler receives. A DOM `React.MouseEvent` satisfies this
+ * structurally, and the native default link supplies the two methods itself —
+ * so a shared component can call `preventDefault()` on either platform
+ * without a platform check.
+ */
+interface AgentCatalogLinkClickEvent {
+    metaKey?: boolean;
+    ctrlKey?: boolean;
+    preventDefault(): void;
+    stopPropagation(): void;
+}
 type AgentCatalogLinkComponent = ComponentType<{
     href: string;
     className?: string;
@@ -429,7 +442,7 @@ type AgentCatalogLinkComponent = ComponentType<{
     rel?: string;
     title?: string;
     "aria-label"?: string;
-    onClick?: (e: React.MouseEvent<HTMLAnchorElement>) => void;
+    onClick?: (e: AgentCatalogLinkClickEvent) => void;
     children: ReactNode;
 }>;
 /** Render a model id as whatever door the host has. DEFAULT: plain text. */
@@ -438,9 +451,9 @@ type AgentCatalogRenderModelRef = (args: {
     className?: string;
 }) => ReactNode;
 interface AgentCatalogUiPorts {
-    /** DEFAULT: `window.location.assign`. */
+    /** DEFAULT (web): `window.location.assign`. DEFAULT (native): a reporting no-op. */
     navigate?: AgentCatalogNavigate;
-    /** DEFAULT: a plain `<a>`. */
+    /** DEFAULT: a plain `<a>` (web) / a pressable `Text` (native). */
     LinkComponent?: AgentCatalogLinkComponent;
     /** DEFAULT: the model id as plain text. */
     renderModelRef?: AgentCatalogRenderModelRef;
@@ -449,14 +462,10 @@ interface AgentCatalogUiPorts {
     /**
      * Portal container for the desktop popover, when the picker is mounted
      * inside a dialog. DEFAULT: the document body (Radix's own default).
+     * Web only — the native entry ignores it.
      */
     popoverContainer?: HTMLElement | null;
 }
-interface AgentCatalogProviderProps extends AgentCatalogUiPorts {
-    catalog: AgentCatalog;
-    children: ReactNode;
-}
-declare function AgentCatalogProvider({ catalog, children, ...ports }: AgentCatalogProviderProps): react.JSX.Element;
 /** The headless catalog this tree is bound to. Throws with no provider. */
 declare function useAgentCatalog(): AgentCatalog;
 /** The UI ports this tree is bound to, with every default already applied. */
@@ -474,6 +483,30 @@ declare function useAgentCatalogState<T>(select: (state: AgentCatalogState) => T
 /** Every row currently in the catalogue, as one stable array. */
 declare function useAgentCatalogRows(): AgentSummary[];
 
+interface AgentCatalogProviderProps extends AgentCatalogUiPorts {
+    catalog: AgentCatalog;
+    children: ReactNode;
+}
+declare function AgentCatalogProvider({ catalog, children, ...ports }: AgentCatalogProviderProps): react.JSX.Element;
+
+/**
+ * catalog/shared/useAgentConsumer.ts — VERBATIM port of matrx-frontend
+ * `features/agents/hooks/useAgentConsumer.ts`.
+ *
+ * Wraps a single consumer slot identified by `consumerId`. Registers the slot
+ * on mount, optionally unregisters on unmount, and returns every filter/sort/
+ * pagination value plus stable write helpers.
+ *
+ * Two seams inverted, nothing else:
+ *   - `useAppSelector`/`useAppDispatch` → `useAgentCatalog()` + the store's
+ *     own methods.
+ *   - `useServerAgentSearch` (a separate frontend hook) is folded IN, because
+ *     it was already wired here and nowhere else: EVERY agent surface that
+ *     uses a consumer searches the full server-side set. A local-only search
+ *     over a paginated list reports "no results" for agents that were merely
+ *     never fetched — a wrong answer, not a missing feature.
+ */
+
 interface UseAgentConsumerReturn {
     tab: AgentTab;
     sortBy: AgentSortOption;
@@ -530,26 +563,17 @@ declare function useAgentConsumer(consumerId: string, options?: {
     initialTab?: AgentTab;
 }): UseAgentConsumerReturn;
 
+/**
+ * The four ownership counts a tab strip prints. Declared HERE, beside the code
+ * that computes them, so both the web tab strip and the native one name the
+ * same shape (0.9.0 — it used to live in the web-only `AgentListTabs`).
+ */
 interface AgentListTabCounts {
     mine: number;
     shared: number;
     all: number;
     system: number;
 }
-interface AgentListTabsProps {
-    consumer: UseAgentConsumerReturn;
-    tabCounts: AgentListTabCounts;
-    /** Limit the ownership tabs for constrained pickers. */
-    visibleTabs?: readonly AgentTab[] | undefined;
-    /**
-     * Label for the builtin-agent tab. Users see "Public" (that is what a
-     * platform agent is to them); ADMIN surfaces pass "System", because there
-     * these are the agents they own and maintain.
-     */
-    systemTabLabel?: string | undefined;
-}
-declare function AgentListTabs({ consumer, tabCounts, systemTabLabel, visibleTabs, }: AgentListTabsProps): react.JSX.Element;
-
 interface AgentListCoreOptions {
     consumerId: string;
     onSelect?: (agentId: string) => void;
@@ -707,6 +731,20 @@ interface AgentListInlinePickerProps {
 }
 declare function AgentListInlinePicker({ consumerId, onSelect, activeAgentId, className, autoFocusSearch, initialTab, includeSystemInAll, visibleTabs, systemTabLabel, resolveAgentHref, showPinnedAgent, excludeAgentIds, defaultMandateKey, }: AgentListInlinePickerProps): react.JSX.Element;
 
+interface AgentListTabsProps {
+    consumer: UseAgentConsumerReturn;
+    tabCounts: AgentListTabCounts;
+    /** Limit the ownership tabs for constrained pickers. */
+    visibleTabs?: readonly AgentTab[] | undefined;
+    /**
+     * Label for the builtin-agent tab. Users see "Public" (that is what a
+     * platform agent is to them); ADMIN surfaces pass "System", because there
+     * these are the agents they own and maintain.
+     */
+    systemTabLabel?: string | undefined;
+}
+declare function AgentListTabs({ consumer, tabCounts, systemTabLabel, visibleTabs, }: AgentListTabsProps): react.JSX.Element;
+
 /**
  * catalog/react/types.ts — VERBATIM port of matrx-frontend
  * `features/agents/components/agent-listings/core/types.ts`.
@@ -886,7 +924,7 @@ type IconProps = SVGProps<SVGSVGElement> & {
  * picker used for a conductor, kept identical so the same agent wears the same
  * mark in every client.
  */
-declare function Music4Icon(props: IconProps): react.JSX.Element;
+declare const Music4Icon: (props: IconProps) => react.JSX.Element;
 
 /**
  * catalog/orchestra.ts — @ai-matrx/agents/catalog