@ai-matrx/agents 0.59.256 → 0.59.257

package/CHANGELOG.md

@@ -1,10 +1,15 @@
 # Changelog
 
-## 0.59.256
+## 0.59.257
 
 UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
 Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/matrx-agents/src`.
 
+## 0.59.256
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff be3d056be5 76b41cb76b -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
 ## 0.59.255
 
 Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 9137bf6ff3 be3d056be5 -- apps/shared/matrx-agents/src`

package/dist/catalog/native/index.cjs

@@ -266,7 +266,7 @@ var import_react_native12 = require("react-native");
 var import_react6 = require("react");
 var import_react_native11 = require("react-native");
 
-// catalog/shared/useAgentListCore.ts
+// catalog/shared/useAgentListCore-react.ts
 var import_react4 = require("react");
 
 // catalog/shared/useAgentConsumer.ts
@@ -841,14 +841,7 @@ function agentListFooterLabel(args) {
   return archivedHiddenCount > 0 ? `${base} \xB7 ${archivedHiddenCount} archived hidden` : base;
 }
 
-// catalog/shared/useAgentListCore.ts
-var HOVER_GRACE_MS = 900;
-function coerceVisibleTab(current, allowed, initialTab) {
-  if (allowed.length === 0) return null;
-  if (allowed.includes(current)) return null;
-  return initialTab && allowed.includes(initialTab) ? initialTab : allowed[0] ?? null;
-}
-var EMPTY_EXCLUDES = [];
+// catalog/shared/useAgentListCore-react.ts
 function useAgentListCore({
   consumerId,
   onSelect,
@@ -1074,6 +1067,15 @@ function useAgentListCore({
     handleDetailPanelMouseLeave
   };
 }
+
+// catalog/shared/useAgentListCore.ts
+var HOVER_GRACE_MS = 900;
+function coerceVisibleTab(current, allowed, initialTab) {
+  if (allowed.length === 0) return null;
+  if (allowed.includes(current)) return null;
+  return initialTab && allowed.includes(initialTab) ? initialTab : allowed[0] ?? null;
+}
+var EMPTY_EXCLUDES = [];
 var selectStatus = (state) => state.status;
 
 // catalog/native/AgentDetailCard.tsx

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

@@ -498,24 +498,6 @@ declare function AgentListSheet({ title, ...props }: AgentListSheetProps): react
 type AgentListInlinePickerProps = AgentPickerProps;
 declare function AgentListInlinePicker(props: AgentListInlinePickerProps): 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;
@@ -585,6 +567,33 @@ declare function useAgentConsumer(consumerId: string, options?: {
     initialArchFilter?: AgentArchFilter;
 }): UseAgentConsumerReturn;
 
+declare function useAgentListCore({ consumerId, onSelect, navigateTo, activeAgentIdOverride, initialTab, includeSystemInAll, visibleTabs, initialArchFilter, excludeAgentIds, includeQuickAgents, defaultMandateKey, agentFilter, loadOnMount, }: AgentListCoreOptions): {
+    agents: AgentSummary[];
+    archivedHiddenCount: number;
+    footerLabel: string;
+    isLoading: boolean;
+    activeAgentId: string | null;
+    pinnedAgent: AgentSummary | null;
+    defaultRow: DefaultRowState | null;
+    /** The host filter's chip label while it narrows the list; else null. */
+    agentFilterLabel: string | null;
+    clearAgentFilter: () => void;
+    resumeAgentFilter: () => void;
+    allCategories: string[];
+    allTags: string[];
+    consumer: UseAgentConsumerReturn;
+    tabCounts: AgentListTabCounts;
+    activeFilterCount: number;
+    hoveredAgent: AgentSummary | null;
+    setHoveredAgent: react.Dispatch<react.SetStateAction<AgentSummary | null>>;
+    ensureLoaded: () => void;
+    handleSelectAgent: (agent: AgentSummary) => void;
+    handleAgentHover: (agent: AgentSummary, panelOpen: boolean) => void;
+    handleAgentHoverEnd: (agent: AgentSummary, onClear: () => void) => void;
+    handleDetailPanelMouseEnter: () => void;
+    handleDetailPanelMouseLeave: (onClear: () => void) => void;
+};
+
 /**
  * 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
@@ -699,32 +708,6 @@ declare const HOVER_GRACE_MS = 900;
  * else the first allowed tab.
  */
 declare function coerceVisibleTab(current: AgentTab, allowed: readonly AgentTab[], initialTab?: AgentTab): AgentTab | null;
-declare function useAgentListCore({ consumerId, onSelect, navigateTo, activeAgentIdOverride, initialTab, includeSystemInAll, visibleTabs, initialArchFilter, excludeAgentIds, includeQuickAgents, defaultMandateKey, agentFilter, loadOnMount, }: AgentListCoreOptions): {
-    agents: AgentSummary[];
-    archivedHiddenCount: number;
-    footerLabel: string;
-    isLoading: boolean;
-    activeAgentId: string | null;
-    pinnedAgent: AgentSummary | null;
-    defaultRow: DefaultRowState | null;
-    /** The host filter's chip label while it narrows the list; else null. */
-    agentFilterLabel: string | null;
-    clearAgentFilter: () => void;
-    resumeAgentFilter: () => void;
-    allCategories: string[];
-    allTags: string[];
-    consumer: UseAgentConsumerReturn;
-    tabCounts: AgentListTabCounts;
-    activeFilterCount: number;
-    hoveredAgent: AgentSummary | null;
-    setHoveredAgent: react.Dispatch<react.SetStateAction<AgentSummary | null>>;
-    ensureLoaded: () => void;
-    handleSelectAgent: (agent: AgentSummary) => void;
-    handleAgentHover: (agent: AgentSummary, panelOpen: boolean) => void;
-    handleAgentHoverEnd: (agent: AgentSummary, onClear: () => void) => void;
-    handleDetailPanelMouseEnter: () => void;
-    handleDetailPanelMouseLeave: (onClear: () => void) => void;
-};
 
 interface AgentListContentProps {
     agents: AgentSummary[];

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

@@ -498,24 +498,6 @@ declare function AgentListSheet({ title, ...props }: AgentListSheetProps): react
 type AgentListInlinePickerProps = AgentPickerProps;
 declare function AgentListInlinePicker(props: AgentListInlinePickerProps): 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;
@@ -585,6 +567,33 @@ declare function useAgentConsumer(consumerId: string, options?: {
     initialArchFilter?: AgentArchFilter;
 }): UseAgentConsumerReturn;
 
+declare function useAgentListCore({ consumerId, onSelect, navigateTo, activeAgentIdOverride, initialTab, includeSystemInAll, visibleTabs, initialArchFilter, excludeAgentIds, includeQuickAgents, defaultMandateKey, agentFilter, loadOnMount, }: AgentListCoreOptions): {
+    agents: AgentSummary[];
+    archivedHiddenCount: number;
+    footerLabel: string;
+    isLoading: boolean;
+    activeAgentId: string | null;
+    pinnedAgent: AgentSummary | null;
+    defaultRow: DefaultRowState | null;
+    /** The host filter's chip label while it narrows the list; else null. */
+    agentFilterLabel: string | null;
+    clearAgentFilter: () => void;
+    resumeAgentFilter: () => void;
+    allCategories: string[];
+    allTags: string[];
+    consumer: UseAgentConsumerReturn;
+    tabCounts: AgentListTabCounts;
+    activeFilterCount: number;
+    hoveredAgent: AgentSummary | null;
+    setHoveredAgent: react.Dispatch<react.SetStateAction<AgentSummary | null>>;
+    ensureLoaded: () => void;
+    handleSelectAgent: (agent: AgentSummary) => void;
+    handleAgentHover: (agent: AgentSummary, panelOpen: boolean) => void;
+    handleAgentHoverEnd: (agent: AgentSummary, onClear: () => void) => void;
+    handleDetailPanelMouseEnter: () => void;
+    handleDetailPanelMouseLeave: (onClear: () => void) => void;
+};
+
 /**
  * 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
@@ -699,32 +708,6 @@ declare const HOVER_GRACE_MS = 900;
  * else the first allowed tab.
  */
 declare function coerceVisibleTab(current: AgentTab, allowed: readonly AgentTab[], initialTab?: AgentTab): AgentTab | null;
-declare function useAgentListCore({ consumerId, onSelect, navigateTo, activeAgentIdOverride, initialTab, includeSystemInAll, visibleTabs, initialArchFilter, excludeAgentIds, includeQuickAgents, defaultMandateKey, agentFilter, loadOnMount, }: AgentListCoreOptions): {
-    agents: AgentSummary[];
-    archivedHiddenCount: number;
-    footerLabel: string;
-    isLoading: boolean;
-    activeAgentId: string | null;
-    pinnedAgent: AgentSummary | null;
-    defaultRow: DefaultRowState | null;
-    /** The host filter's chip label while it narrows the list; else null. */
-    agentFilterLabel: string | null;
-    clearAgentFilter: () => void;
-    resumeAgentFilter: () => void;
-    allCategories: string[];
-    allTags: string[];
-    consumer: UseAgentConsumerReturn;
-    tabCounts: AgentListTabCounts;
-    activeFilterCount: number;
-    hoveredAgent: AgentSummary | null;
-    setHoveredAgent: react.Dispatch<react.SetStateAction<AgentSummary | null>>;
-    ensureLoaded: () => void;
-    handleSelectAgent: (agent: AgentSummary) => void;
-    handleAgentHover: (agent: AgentSummary, panelOpen: boolean) => void;
-    handleAgentHoverEnd: (agent: AgentSummary, onClear: () => void) => void;
-    handleDetailPanelMouseEnter: () => void;
-    handleDetailPanelMouseLeave: (onClear: () => void) => void;
-};
 
 interface AgentListContentProps {
     agents: AgentSummary[];

package/dist/catalog/native/index.js

@@ -218,14 +218,8 @@ import { StyleSheet as StyleSheet9, Text as Text9, View as View7 } from "react-n
 import { useEffect as useEffect3, useState as useState3 } from "react";
 import { StyleSheet as StyleSheet8, View as View6 } from "react-native";
 
-// catalog/shared/useAgentListCore.ts
-import {
-  useCallback as useCallback3,
-  useEffect as useEffect2,
-  useMemo as useMemo3,
-  useRef as useRef2,
-  useState as useState2
-} from "react";
+// catalog/shared/useAgentListCore-react.ts
+import { useCallback as useCallback3, useEffect as useEffect2, useMemo as useMemo3, useRef as useRef2, useState as useState2 } from "react";
 
 // catalog/shared/useAgentConsumer.ts
 import { useCallback as useCallback2, useEffect, useRef, useState } from "react";
@@ -799,14 +793,7 @@ function agentListFooterLabel(args) {
   return archivedHiddenCount > 0 ? `${base} \xB7 ${archivedHiddenCount} archived hidden` : base;
 }
 
-// catalog/shared/useAgentListCore.ts
-var HOVER_GRACE_MS = 900;
-function coerceVisibleTab(current, allowed, initialTab) {
-  if (allowed.length === 0) return null;
-  if (allowed.includes(current)) return null;
-  return initialTab && allowed.includes(initialTab) ? initialTab : allowed[0] ?? null;
-}
-var EMPTY_EXCLUDES = [];
+// catalog/shared/useAgentListCore-react.ts
 function useAgentListCore({
   consumerId,
   onSelect,
@@ -1032,6 +1019,15 @@ function useAgentListCore({
     handleDetailPanelMouseLeave
   };
 }
+
+// catalog/shared/useAgentListCore.ts
+var HOVER_GRACE_MS = 900;
+function coerceVisibleTab(current, allowed, initialTab) {
+  if (allowed.length === 0) return null;
+  if (allowed.includes(current)) return null;
+  return initialTab && allowed.includes(initialTab) ? initialTab : allowed[0] ?? null;
+}
+var EMPTY_EXCLUDES = [];
 var selectStatus = (state) => state.status;
 
 // catalog/native/AgentDetailCard.tsx

package/dist/catalog/react/index.cjs

@@ -1,6 +1,5 @@
 "use client";
 "use strict";
-"use client";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -398,7 +397,7 @@ function useAgentConsumer(consumerId, options) {
   };
 }
 
-// catalog/shared/useAgentListCore.ts
+// catalog/shared/useAgentListCore-react.ts
 var import_react5 = require("react");
 
 // catalog/score.ts
@@ -789,14 +788,7 @@ function agentListFooterLabel(args) {
   return archivedHiddenCount > 0 ? `${base} \xB7 ${archivedHiddenCount} archived hidden` : base;
 }
 
-// catalog/shared/useAgentListCore.ts
-var HOVER_GRACE_MS = 900;
-function coerceVisibleTab(current, allowed, initialTab) {
-  if (allowed.length === 0) return null;
-  if (allowed.includes(current)) return null;
-  return initialTab && allowed.includes(initialTab) ? initialTab : allowed[0] ?? null;
-}
-var EMPTY_EXCLUDES = [];
+// catalog/shared/useAgentListCore-react.ts
 function useAgentListCore({
   consumerId,
   onSelect,
@@ -1022,6 +1014,15 @@ function useAgentListCore({
     handleDetailPanelMouseLeave
   };
 }
+
+// catalog/shared/useAgentListCore.ts
+var HOVER_GRACE_MS = 900;
+function coerceVisibleTab(current, allowed, initialTab) {
+  if (allowed.length === 0) return null;
+  if (allowed.includes(current)) return null;
+  return initialTab && allowed.includes(initialTab) ? initialTab : allowed[0] ?? null;
+}
+var EMPTY_EXCLUDES = [];
 var selectStatus = (state) => state.status;
 
 // catalog/react/AgentListDropdown.tsx

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

@@ -572,24 +572,6 @@ declare function lookUpAgentOnce(catalog: AgentCatalog, agentId: string): Promis
  */
 declare function useAgentSummary(catalog: AgentCatalog | null | undefined, agentId: string | null | undefined): AgentSummary | undefined;
 
-/**
- * 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;
@@ -659,6 +641,33 @@ declare function useAgentConsumer(consumerId: string, options?: {
     initialArchFilter?: AgentArchFilter;
 }): UseAgentConsumerReturn;
 
+declare function useAgentListCore({ consumerId, onSelect, navigateTo, activeAgentIdOverride, initialTab, includeSystemInAll, visibleTabs, initialArchFilter, excludeAgentIds, includeQuickAgents, defaultMandateKey, agentFilter, loadOnMount, }: AgentListCoreOptions): {
+    agents: AgentSummary[];
+    archivedHiddenCount: number;
+    footerLabel: string;
+    isLoading: boolean;
+    activeAgentId: string | null;
+    pinnedAgent: AgentSummary | null;
+    defaultRow: DefaultRowState | null;
+    /** The host filter's chip label while it narrows the list; else null. */
+    agentFilterLabel: string | null;
+    clearAgentFilter: () => void;
+    resumeAgentFilter: () => void;
+    allCategories: string[];
+    allTags: string[];
+    consumer: UseAgentConsumerReturn;
+    tabCounts: AgentListTabCounts;
+    activeFilterCount: number;
+    hoveredAgent: AgentSummary | null;
+    setHoveredAgent: react.Dispatch<react.SetStateAction<AgentSummary | null>>;
+    ensureLoaded: () => void;
+    handleSelectAgent: (agent: AgentSummary) => void;
+    handleAgentHover: (agent: AgentSummary, panelOpen: boolean) => void;
+    handleAgentHoverEnd: (agent: AgentSummary, onClear: () => void) => void;
+    handleDetailPanelMouseEnter: () => void;
+    handleDetailPanelMouseLeave: (onClear: () => void) => void;
+};
+
 /**
  * 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
@@ -773,32 +782,6 @@ declare const HOVER_GRACE_MS = 900;
  * else the first allowed tab.
  */
 declare function coerceVisibleTab(current: AgentTab, allowed: readonly AgentTab[], initialTab?: AgentTab): AgentTab | null;
-declare function useAgentListCore({ consumerId, onSelect, navigateTo, activeAgentIdOverride, initialTab, includeSystemInAll, visibleTabs, initialArchFilter, excludeAgentIds, includeQuickAgents, defaultMandateKey, agentFilter, loadOnMount, }: AgentListCoreOptions): {
-    agents: AgentSummary[];
-    archivedHiddenCount: number;
-    footerLabel: string;
-    isLoading: boolean;
-    activeAgentId: string | null;
-    pinnedAgent: AgentSummary | null;
-    defaultRow: DefaultRowState | null;
-    /** The host filter's chip label while it narrows the list; else null. */
-    agentFilterLabel: string | null;
-    clearAgentFilter: () => void;
-    resumeAgentFilter: () => void;
-    allCategories: string[];
-    allTags: string[];
-    consumer: UseAgentConsumerReturn;
-    tabCounts: AgentListTabCounts;
-    activeFilterCount: number;
-    hoveredAgent: AgentSummary | null;
-    setHoveredAgent: react.Dispatch<react.SetStateAction<AgentSummary | null>>;
-    ensureLoaded: () => void;
-    handleSelectAgent: (agent: AgentSummary) => void;
-    handleAgentHover: (agent: AgentSummary, panelOpen: boolean) => void;
-    handleAgentHoverEnd: (agent: AgentSummary, onClear: () => void) => void;
-    handleDetailPanelMouseEnter: () => void;
-    handleDetailPanelMouseLeave: (onClear: () => void) => void;
-};
 
 interface AgentListDropdownProps {
     onSelect?: (agentId: string) => void;

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

@@ -572,24 +572,6 @@ declare function lookUpAgentOnce(catalog: AgentCatalog, agentId: string): Promis
  */
 declare function useAgentSummary(catalog: AgentCatalog | null | undefined, agentId: string | null | undefined): AgentSummary | undefined;
 
-/**
- * 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;
@@ -659,6 +641,33 @@ declare function useAgentConsumer(consumerId: string, options?: {
     initialArchFilter?: AgentArchFilter;
 }): UseAgentConsumerReturn;
 
+declare function useAgentListCore({ consumerId, onSelect, navigateTo, activeAgentIdOverride, initialTab, includeSystemInAll, visibleTabs, initialArchFilter, excludeAgentIds, includeQuickAgents, defaultMandateKey, agentFilter, loadOnMount, }: AgentListCoreOptions): {
+    agents: AgentSummary[];
+    archivedHiddenCount: number;
+    footerLabel: string;
+    isLoading: boolean;
+    activeAgentId: string | null;
+    pinnedAgent: AgentSummary | null;
+    defaultRow: DefaultRowState | null;
+    /** The host filter's chip label while it narrows the list; else null. */
+    agentFilterLabel: string | null;
+    clearAgentFilter: () => void;
+    resumeAgentFilter: () => void;
+    allCategories: string[];
+    allTags: string[];
+    consumer: UseAgentConsumerReturn;
+    tabCounts: AgentListTabCounts;
+    activeFilterCount: number;
+    hoveredAgent: AgentSummary | null;
+    setHoveredAgent: react.Dispatch<react.SetStateAction<AgentSummary | null>>;
+    ensureLoaded: () => void;
+    handleSelectAgent: (agent: AgentSummary) => void;
+    handleAgentHover: (agent: AgentSummary, panelOpen: boolean) => void;
+    handleAgentHoverEnd: (agent: AgentSummary, onClear: () => void) => void;
+    handleDetailPanelMouseEnter: () => void;
+    handleDetailPanelMouseLeave: (onClear: () => void) => void;
+};
+
 /**
  * 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
@@ -773,32 +782,6 @@ declare const HOVER_GRACE_MS = 900;
  * else the first allowed tab.
  */
 declare function coerceVisibleTab(current: AgentTab, allowed: readonly AgentTab[], initialTab?: AgentTab): AgentTab | null;
-declare function useAgentListCore({ consumerId, onSelect, navigateTo, activeAgentIdOverride, initialTab, includeSystemInAll, visibleTabs, initialArchFilter, excludeAgentIds, includeQuickAgents, defaultMandateKey, agentFilter, loadOnMount, }: AgentListCoreOptions): {
-    agents: AgentSummary[];
-    archivedHiddenCount: number;
-    footerLabel: string;
-    isLoading: boolean;
-    activeAgentId: string | null;
-    pinnedAgent: AgentSummary | null;
-    defaultRow: DefaultRowState | null;
-    /** The host filter's chip label while it narrows the list; else null. */
-    agentFilterLabel: string | null;
-    clearAgentFilter: () => void;
-    resumeAgentFilter: () => void;
-    allCategories: string[];
-    allTags: string[];
-    consumer: UseAgentConsumerReturn;
-    tabCounts: AgentListTabCounts;
-    activeFilterCount: number;
-    hoveredAgent: AgentSummary | null;
-    setHoveredAgent: react.Dispatch<react.SetStateAction<AgentSummary | null>>;
-    ensureLoaded: () => void;
-    handleSelectAgent: (agent: AgentSummary) => void;
-    handleAgentHover: (agent: AgentSummary, panelOpen: boolean) => void;
-    handleAgentHoverEnd: (agent: AgentSummary, onClear: () => void) => void;
-    handleDetailPanelMouseEnter: () => void;
-    handleDetailPanelMouseLeave: (onClear: () => void) => void;
-};
 
 interface AgentListDropdownProps {
     onSelect?: (agentId: string) => void;

package/dist/catalog/react/index.js

@@ -1,5 +1,4 @@
 "use client";
-"use client";
 
 // catalog/react/context.tsx
 import { useMemo as useMemo2 } from "react";
@@ -339,14 +338,8 @@ function useAgentConsumer(consumerId, options) {
   };
 }
 
-// catalog/shared/useAgentListCore.ts
-import {
-  useCallback as useCallback3,
-  useEffect as useEffect3,
-  useMemo as useMemo3,
-  useRef as useRef2,
-  useState as useState2
-} from "react";
+// catalog/shared/useAgentListCore-react.ts
+import { useCallback as useCallback3, useEffect as useEffect3, useMemo as useMemo3, useRef as useRef2, useState as useState2 } from "react";
 
 // catalog/score.ts
 function computeAgentSearchScore(agent, query) {
@@ -736,14 +729,7 @@ function agentListFooterLabel(args) {
   return archivedHiddenCount > 0 ? `${base} \xB7 ${archivedHiddenCount} archived hidden` : base;
 }
 
-// catalog/shared/useAgentListCore.ts
-var HOVER_GRACE_MS = 900;
-function coerceVisibleTab(current, allowed, initialTab) {
-  if (allowed.length === 0) return null;
-  if (allowed.includes(current)) return null;
-  return initialTab && allowed.includes(initialTab) ? initialTab : allowed[0] ?? null;
-}
-var EMPTY_EXCLUDES = [];
+// catalog/shared/useAgentListCore-react.ts
 function useAgentListCore({
   consumerId,
   onSelect,
@@ -969,6 +955,15 @@ function useAgentListCore({
     handleDetailPanelMouseLeave
   };
 }
+
+// catalog/shared/useAgentListCore.ts
+var HOVER_GRACE_MS = 900;
+function coerceVisibleTab(current, allowed, initialTab) {
+  if (allowed.length === 0) return null;
+  if (allowed.includes(current)) return null;
+  return initialTab && allowed.includes(initialTab) ? initialTab : allowed[0] ?? null;
+}
+var EMPTY_EXCLUDES = [];
 var selectStatus = (state) => state.status;
 
 // catalog/react/AgentListDropdown.tsx

package/dist/content-transfer/react/index.cjs

@@ -1,6 +1,5 @@
 "use client";
 "use strict";
-"use client";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/content-transfer/react/index.js

@@ -1,5 +1,4 @@
 "use client";
-"use client";
 
 // content-transfer/react/index.tsx
 import * as React from "react";

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

@@ -1,11 +1,5 @@
 import { RunRequest, AppletError, KindEnvelope, ServedInput, RunRef, IntelligencePort } from '@ai-matrx/agents/intelligence';
 
-/**
- * `@ai-matrx/agents/intelligence/react` — `useMandateRun`, the smallest
- * React binding over an `IntelligencePort`. Never throws into React: every
- * failure lands in `error` and `status: "error"`.
- */
-
 type MandateRunStatus = "idle" | "resolving" | "running" | "needs_input" | "done" | "error";
 interface UseMandateRun {
     /** Start the job; `key` is bound by the hook, the rest is the run request. */

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

@@ -1,11 +1,5 @@
 import { RunRequest, AppletError, KindEnvelope, ServedInput, RunRef, IntelligencePort } from '@ai-matrx/agents/intelligence';
 
-/**
- * `@ai-matrx/agents/intelligence/react` — `useMandateRun`, the smallest
- * React binding over an `IntelligencePort`. Never throws into React: every
- * failure lands in `error` and `status: "error"`.
- */
-
 type MandateRunStatus = "idle" | "resolving" | "running" | "needs_input" | "done" | "error";
 interface UseMandateRun {
     /** Start the job; `key` is bound by the hook, the rest is the run request. */

package/dist/runtime/react/index.cjs

@@ -1,6 +1,5 @@
 "use client";
 "use strict";
-"use client";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;

package/dist/runtime/react/index.js

@@ -1,5 +1,4 @@
 "use client";
-"use client";
 
 // runtime/react/index.ts
 import { useEffect, useSyncExternalStore } from "react";

package/dist/settings/react/index.cjs

@@ -1,6 +1,5 @@
 "use client";
 "use strict";
-"use client";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;

package/dist/settings/react/index.js

@@ -1,5 +1,4 @@
 "use client";
-"use client";
 
 // settings/react/index.ts
 import { useSyncExternalStore } from "react";

package/dist/skills/react/index.cjs

@@ -1,6 +1,5 @@
 "use client";
 "use strict";
-"use client";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;

package/dist/skills/react/index.js

@@ -1,5 +1,4 @@
 "use client";
-"use client";
 
 // skills/react/useSkillCatalog.ts
 import { useEffect, useMemo, useSyncExternalStore } from "react";

package/dist/sources/index.d.cts

@@ -47,7 +47,13 @@ interface SourceRef {
     promote?: ResourcePromotion | ResourcePromotion[];
     exclude?: string[];
 }
-interface SourceSet {
+/**
+ * A TYPE, not an interface (2026-10-23): it IS a JSON object, so it is assignable wherever the server
+ * contract types the field as a JSON object (@ai-matrx/api's request bodies carry `source_set` as
+ * `{ [key: string]: JsonValue }` — the podcast generate request). An interface has no implicit index
+ * signature and would need a cast at every send.
+ */
+type SourceSet = {
     __kind: typeof SOURCE_SET_KIND;
     version: typeof SOURCE_SET_VERSION;
     sources: SourceRef[];
@@ -59,7 +65,7 @@ interface SourceSet {
     retrieve_query?: string;
     /** The model whose context window sets the budget. */
     target_model_id?: string;
-}
+};
 type SourceState = "ready" | "processing" | "failed" | "unavailable";
 interface SourceManifestForm {
     form: string;

package/dist/sources/index.d.ts

@@ -47,7 +47,13 @@ interface SourceRef {
     promote?: ResourcePromotion | ResourcePromotion[];
     exclude?: string[];
 }
-interface SourceSet {
+/**
+ * A TYPE, not an interface (2026-10-23): it IS a JSON object, so it is assignable wherever the server
+ * contract types the field as a JSON object (@ai-matrx/api's request bodies carry `source_set` as
+ * `{ [key: string]: JsonValue }` — the podcast generate request). An interface has no implicit index
+ * signature and would need a cast at every send.
+ */
+type SourceSet = {
     __kind: typeof SOURCE_SET_KIND;
     version: typeof SOURCE_SET_VERSION;
     sources: SourceRef[];
@@ -59,7 +65,7 @@ interface SourceSet {
     retrieve_query?: string;
     /** The model whose context window sets the budget. */
     target_model_id?: string;
-}
+};
 type SourceState = "ready" | "processing" | "failed" | "unavailable";
 interface SourceManifestForm {
     form: string;

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

@@ -47,7 +47,13 @@ interface SourceRef {
     promote?: ResourcePromotion | ResourcePromotion[];
     exclude?: string[];
 }
-interface SourceSet {
+/**
+ * A TYPE, not an interface (2026-10-23): it IS a JSON object, so it is assignable wherever the server
+ * contract types the field as a JSON object (@ai-matrx/api's request bodies carry `source_set` as
+ * `{ [key: string]: JsonValue }` — the podcast generate request). An interface has no implicit index
+ * signature and would need a cast at every send.
+ */
+type SourceSet = {
     __kind: typeof SOURCE_SET_KIND;
     version: typeof SOURCE_SET_VERSION;
     sources: SourceRef[];
@@ -59,7 +65,7 @@ interface SourceSet {
     retrieve_query?: string;
     /** The model whose context window sets the budget. */
     target_model_id?: string;
-}
+};
 type SourceState = "ready" | "processing" | "failed" | "unavailable";
 interface SourceManifestForm {
     form: string;
@@ -705,21 +711,6 @@ interface FileRecoveryDeps {
     fileOrganizationId?: ((fileId: string) => string | null | undefined) | undefined;
 }
 
-/**
- * `@ai-matrx/agents/sources/react` — thin React hooks over the Source runtime
- * (`@ai-matrx/agents/sources/runtime`). No logic lives here that a non-React
- * client could not reach through the runtime itself: the hooks subscribe,
- * schedule, and hand back the same controller.
- *
- *   const set = useSourceSet(adapter, { persistenceReady });
- *   const intake = useSourceIntake(set, deps);
- *   useSourceRecovery(set, intake, runner, { organizationId, readFileState });
- *   const search = useSourcePartsSearch(client, ref, query);
- *
- * A host binds the adapter to its own store once (memoized per surface) —
- * the web app binds Redux; another client binds its own.
- */
-
 interface UseSourceSetOptions {
     /**
      * The draft store has been read back (a device store loads a moment after

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

@@ -47,7 +47,13 @@ interface SourceRef {
     promote?: ResourcePromotion | ResourcePromotion[];
     exclude?: string[];
 }
-interface SourceSet {
+/**
+ * A TYPE, not an interface (2026-10-23): it IS a JSON object, so it is assignable wherever the server
+ * contract types the field as a JSON object (@ai-matrx/api's request bodies carry `source_set` as
+ * `{ [key: string]: JsonValue }` — the podcast generate request). An interface has no implicit index
+ * signature and would need a cast at every send.
+ */
+type SourceSet = {
     __kind: typeof SOURCE_SET_KIND;
     version: typeof SOURCE_SET_VERSION;
     sources: SourceRef[];
@@ -59,7 +65,7 @@ interface SourceSet {
     retrieve_query?: string;
     /** The model whose context window sets the budget. */
     target_model_id?: string;
-}
+};
 type SourceState = "ready" | "processing" | "failed" | "unavailable";
 interface SourceManifestForm {
     form: string;
@@ -705,21 +711,6 @@ interface FileRecoveryDeps {
     fileOrganizationId?: ((fileId: string) => string | null | undefined) | undefined;
 }
 
-/**
- * `@ai-matrx/agents/sources/react` — thin React hooks over the Source runtime
- * (`@ai-matrx/agents/sources/runtime`). No logic lives here that a non-React
- * client could not reach through the runtime itself: the hooks subscribe,
- * schedule, and hand back the same controller.
- *
- *   const set = useSourceSet(adapter, { persistenceReady });
- *   const intake = useSourceIntake(set, deps);
- *   useSourceRecovery(set, intake, runner, { organizationId, readFileState });
- *   const search = useSourcePartsSearch(client, ref, query);
- *
- * A host binds the adapter to its own store once (memoized per surface) —
- * the web app binds Redux; another client binds its own.
- */
-
 interface UseSourceSetOptions {
     /**
      * The draft store has been read back (a device store loads a moment after

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.256",
+  "version": "0.59.257",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -508,12 +508,12 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@ai-matrx/api": "latest",
-    "@ai-matrx/data": "latest",
     "@ai-matrx/alchemy": "latest",
+    "@ai-matrx/associations": "latest",
     "@ai-matrx/content-ir": "latest",
+    "@ai-matrx/api": "latest",
     "@ai-matrx/design-system": "latest",
-    "@ai-matrx/associations": "latest",
+    "@ai-matrx/data": "latest",
     "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest"
@@ -561,5 +561,5 @@
     "verify:tarball": "node ./scripts/verify-tarball.mjs",
     "typegen:self-test": "node scripts/typegen/drop-guard.self-test.mjs && node scripts/typegen/check-api-types-fresh.mjs --self-test"
   },
-  "gitHead": "76b41cb76b379c9c04a1e26535fcf64606f59595"
+  "gitHead": "0a2b8c9356bcba5cf0338a6c2c63b1c6058374ef"
 }