@ai-matrx/agents 0.9.0 → 0.9.2

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

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
-import { t as AgentCatalogNavigate, v as AgentCatalogOpenPeek, n as AgentCatalog, A as AgentSummary, z as AgentCatalogState, f as AgentTab, i as AgentSortOption, E as AgentFavFilter, m as AgentArchFilter, k as AgentAccessFilter, h as AgentConsumerState, J as DefaultRowState } from '../../orchestra-BWJM2MWP.cjs';
-export { O as OrchestraBadge, W as orchestraDelegatesLine, X as orchestraDepthLine, Y as orchestraLabel, Z as orchestraModeLabel } from '../../orchestra-BWJM2MWP.cjs';
+import { x as AgentCatalogNavigate, z as AgentCatalogOpenPeek, q as AgentCatalog, A as AgentSummary, E as AgentCatalogState, g as AgentTab, j as AgentSortOption, I as AgentFavFilter, f as AgentArchFilter, n as AgentAccessFilter, i as AgentConsumerState, O as DefaultRowState } from '../../orchestra-DljbEiks.cjs';
+export { P as OrchestraBadge, a0 as orchestraDelegatesLine, a1 as orchestraDepthLine, a2 as orchestraLabel, a3 as orchestraModeLabel } from '../../orchestra-DljbEiks.cjs';
 
 /**
  * The anchor a row renders for cmd/ctrl-click. DEFAULT (web): a plain `<a>` —
@@ -249,6 +249,13 @@ interface UseAgentConsumerReturn {
     includedTags: string[];
     favFilter: AgentFavFilter;
     archFilter: AgentArchFilter;
+    /**
+     * The archive-filter state this catalog starts consumers in — the platform
+     * default `"active"` unless the host set the knob. What "not the default
+     * state" means on this surface, so the control and the footer can both say
+     * it honestly.
+     */
+    archFilterDefault: AgentArchFilter;
     accessFilter: AgentAccessFilter;
     favoritesFirst: boolean;
     listPage: number;
@@ -295,12 +302,23 @@ declare function useAgentConsumer(consumerId: string, options?: {
     unregisterOnUnmount?: boolean;
     /** Applied only when the consumer is first registered (idempotent). */
     initialTab?: AgentTab;
+    /**
+     * THE ARCHIVED-ITEMS LAW's per-consumer override of the catalog-wide
+     * `defaults.archiveFilter` knob. Applied only at first registration — the
+     * state belongs to the person after that.
+     */
+    initialArchFilter?: AgentArchFilter;
 }): 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`).
+ *
+ * 🚨 These are the numbers on the BADGES, and since 0.9.1 they count exactly
+ * the rows the tab renders under the consumer's own archive filter. A badge
+ * that counted rows the list hid was the screen telling the user something
+ * untrue about her own agents.
  */
 interface AgentListTabCounts {
     mine: number;
@@ -344,6 +362,13 @@ interface AgentListCoreOptions {
      * not just at mount — so a restriction that arrives later is enforced later.
      */
     visibleTabs?: readonly AgentTab[];
+    /**
+     * THE ARCHIVED-ITEMS LAW's per-consumer override of the catalog-wide
+     * `defaults.archiveFilter` knob, applied once at first registration. Almost
+     * nothing should pass it: the platform answer is "hide archived", and the
+     * person reveals the archive from the control on the filter bar.
+     */
+    initialArchFilter?: AgentArchFilter;
     /** Hide records that are invalid for this call site. */
     excludeAgentIds?: readonly string[];
     /**
@@ -369,8 +394,10 @@ 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, excludeAgentIds, defaultMandateKey, }: AgentListCoreOptions): {
+declare function useAgentListCore({ consumerId, onSelect, navigateTo, activeAgentIdOverride, initialTab, includeSystemInAll, visibleTabs, initialArchFilter, excludeAgentIds, defaultMandateKey, }: AgentListCoreOptions): {
     agents: AgentSummary[];
+    archivedHiddenCount: number;
+    footerLabel: string;
     isLoading: boolean;
     activeAgentId: string | null;
     pinnedAgent: AgentSummary | null;
@@ -408,8 +435,13 @@ interface AgentListContentProps {
     pinnedAgent?: AgentSummary | null | undefined;
     defaultRow?: DefaultRowState | null | undefined;
     autoFocusSearch?: boolean;
+    /**
+     * Rows the ARCHIVE FILTER is keeping off this screen — from
+     * `useAgentListCore`. The footer names them, exactly as on the web.
+     */
+    archivedHiddenCount?: number | undefined;
 }
-declare function AgentListContent({ agents, isLoading, consumer, activeAgentId, allCategories, allTags, onSelectAgent, onDetailPress, onFilterChipPress, onReset, activeFilterCount, tabCounts, visibleTabs, systemTabLabel, pinnedAgent, defaultRow, autoFocusSearch, }: AgentListContentProps): react.JSX.Element;
+declare function AgentListContent({ agents, isLoading, consumer, activeAgentId, allCategories, allTags, onSelectAgent, onDetailPress, onFilterChipPress, onReset, activeFilterCount, tabCounts, visibleTabs, systemTabLabel, pinnedAgent, defaultRow, autoFocusSearch, archivedHiddenCount, }: AgentListContentProps): react.JSX.Element;
 
 interface AgentListTabsProps {
     consumer: UseAgentConsumerReturn;
@@ -565,6 +597,14 @@ declare const SHAPES: {
     rocket: {
         paths: string[];
     };
+    /**
+     * THE ARCHIVE GLYPH (Lucide `archive`) — the ONE mark of the platform
+     * archive filter, drawn identically in every Matrx client so the control a
+     * person learns on one surface is recognisable on all of them.
+     */
+    archive: {
+        paths: string[];
+    };
     circleCheck: {
         paths: string[];
         circles: {
@@ -631,11 +671,15 @@ declare function SearchInput({ value, onChange, placeholder, autoFocus, }: {
     placeholder: string;
     autoFocus?: boolean;
 }): react.JSX.Element;
-declare function FilterChip({ icon, label, active, onPress, }: {
+declare function FilterChip({ icon, label, active, onPress, accessibilityLabel, testID, }: {
     icon: AgentCatalogIconName;
     label: string;
     active: boolean;
     onPress: () => void;
+    /** Accessible name when the visible label alone would not say the state. */
+    accessibilityLabel?: string;
+    /** Stable hook so a shell test can measure the control, not a style. */
+    testID?: string;
 }): react.JSX.Element;
 declare function OptionRow({ label, selected, onPress, }: {
     label: string;

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

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
-import { t as AgentCatalogNavigate, v as AgentCatalogOpenPeek, n as AgentCatalog, A as AgentSummary, z as AgentCatalogState, f as AgentTab, i as AgentSortOption, E as AgentFavFilter, m as AgentArchFilter, k as AgentAccessFilter, h as AgentConsumerState, J as DefaultRowState } from '../../orchestra-BWJM2MWP.js';
-export { O as OrchestraBadge, W as orchestraDelegatesLine, X as orchestraDepthLine, Y as orchestraLabel, Z as orchestraModeLabel } from '../../orchestra-BWJM2MWP.js';
+import { x as AgentCatalogNavigate, z as AgentCatalogOpenPeek, q as AgentCatalog, A as AgentSummary, E as AgentCatalogState, g as AgentTab, j as AgentSortOption, I as AgentFavFilter, f as AgentArchFilter, n as AgentAccessFilter, i as AgentConsumerState, O as DefaultRowState } from '../../orchestra-DljbEiks.js';
+export { P as OrchestraBadge, a0 as orchestraDelegatesLine, a1 as orchestraDepthLine, a2 as orchestraLabel, a3 as orchestraModeLabel } from '../../orchestra-DljbEiks.js';
 
 /**
  * The anchor a row renders for cmd/ctrl-click. DEFAULT (web): a plain `<a>` —
@@ -249,6 +249,13 @@ interface UseAgentConsumerReturn {
     includedTags: string[];
     favFilter: AgentFavFilter;
     archFilter: AgentArchFilter;
+    /**
+     * The archive-filter state this catalog starts consumers in — the platform
+     * default `"active"` unless the host set the knob. What "not the default
+     * state" means on this surface, so the control and the footer can both say
+     * it honestly.
+     */
+    archFilterDefault: AgentArchFilter;
     accessFilter: AgentAccessFilter;
     favoritesFirst: boolean;
     listPage: number;
@@ -295,12 +302,23 @@ declare function useAgentConsumer(consumerId: string, options?: {
     unregisterOnUnmount?: boolean;
     /** Applied only when the consumer is first registered (idempotent). */
     initialTab?: AgentTab;
+    /**
+     * THE ARCHIVED-ITEMS LAW's per-consumer override of the catalog-wide
+     * `defaults.archiveFilter` knob. Applied only at first registration — the
+     * state belongs to the person after that.
+     */
+    initialArchFilter?: AgentArchFilter;
 }): 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`).
+ *
+ * 🚨 These are the numbers on the BADGES, and since 0.9.1 they count exactly
+ * the rows the tab renders under the consumer's own archive filter. A badge
+ * that counted rows the list hid was the screen telling the user something
+ * untrue about her own agents.
  */
 interface AgentListTabCounts {
     mine: number;
@@ -344,6 +362,13 @@ interface AgentListCoreOptions {
      * not just at mount — so a restriction that arrives later is enforced later.
      */
     visibleTabs?: readonly AgentTab[];
+    /**
+     * THE ARCHIVED-ITEMS LAW's per-consumer override of the catalog-wide
+     * `defaults.archiveFilter` knob, applied once at first registration. Almost
+     * nothing should pass it: the platform answer is "hide archived", and the
+     * person reveals the archive from the control on the filter bar.
+     */
+    initialArchFilter?: AgentArchFilter;
     /** Hide records that are invalid for this call site. */
     excludeAgentIds?: readonly string[];
     /**
@@ -369,8 +394,10 @@ 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, excludeAgentIds, defaultMandateKey, }: AgentListCoreOptions): {
+declare function useAgentListCore({ consumerId, onSelect, navigateTo, activeAgentIdOverride, initialTab, includeSystemInAll, visibleTabs, initialArchFilter, excludeAgentIds, defaultMandateKey, }: AgentListCoreOptions): {
     agents: AgentSummary[];
+    archivedHiddenCount: number;
+    footerLabel: string;
     isLoading: boolean;
     activeAgentId: string | null;
     pinnedAgent: AgentSummary | null;
@@ -408,8 +435,13 @@ interface AgentListContentProps {
     pinnedAgent?: AgentSummary | null | undefined;
     defaultRow?: DefaultRowState | null | undefined;
     autoFocusSearch?: boolean;
+    /**
+     * Rows the ARCHIVE FILTER is keeping off this screen — from
+     * `useAgentListCore`. The footer names them, exactly as on the web.
+     */
+    archivedHiddenCount?: number | undefined;
 }
-declare function AgentListContent({ agents, isLoading, consumer, activeAgentId, allCategories, allTags, onSelectAgent, onDetailPress, onFilterChipPress, onReset, activeFilterCount, tabCounts, visibleTabs, systemTabLabel, pinnedAgent, defaultRow, autoFocusSearch, }: AgentListContentProps): react.JSX.Element;
+declare function AgentListContent({ agents, isLoading, consumer, activeAgentId, allCategories, allTags, onSelectAgent, onDetailPress, onFilterChipPress, onReset, activeFilterCount, tabCounts, visibleTabs, systemTabLabel, pinnedAgent, defaultRow, autoFocusSearch, archivedHiddenCount, }: AgentListContentProps): react.JSX.Element;
 
 interface AgentListTabsProps {
     consumer: UseAgentConsumerReturn;
@@ -565,6 +597,14 @@ declare const SHAPES: {
     rocket: {
         paths: string[];
     };
+    /**
+     * THE ARCHIVE GLYPH (Lucide `archive`) — the ONE mark of the platform
+     * archive filter, drawn identically in every Matrx client so the control a
+     * person learns on one surface is recognisable on all of them.
+     */
+    archive: {
+        paths: string[];
+    };
     circleCheck: {
         paths: string[];
         circles: {
@@ -631,11 +671,15 @@ declare function SearchInput({ value, onChange, placeholder, autoFocus, }: {
     placeholder: string;
     autoFocus?: boolean;
 }): react.JSX.Element;
-declare function FilterChip({ icon, label, active, onPress, }: {
+declare function FilterChip({ icon, label, active, onPress, accessibilityLabel, testID, }: {
     icon: AgentCatalogIconName;
     label: string;
     active: boolean;
     onPress: () => void;
+    /** Accessible name when the visible label alone would not say the state. */
+    accessibilityLabel?: string;
+    /** Stable hook so a shell test can measure the control, not a style. */
+    testID?: string;
 }): react.JSX.Element;
 declare function OptionRow({ label, selected, onPress, }: {
     label: string;