@athenaintel/react 0.57.2 → 0.60.0

package/dist/chat-ui/mentions/suggestions/data/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","sources":["../../../../../src/chat-ui/mentions/suggestions/data/types.ts"],"sourcesContent":["/**\n * Core types for mention suggestions data layer\n */\n\n/**\n * MenuScope - A navigable container in the mention menu hierarchy\n *\n * Conceptual model:\n * - SCOPE = Container/Group you navigate INTO (e.g., \"athena_assets\", \"folder_123\")\n * - ITEM = Individual mentionable thing you SELECT (e.g., specific asset, tool)\n *\n * Scopes form a navigation hierarchy:\n *   root → athena_assets → folder_123 → subfolder_456\n *\n * Items can be visible in multiple scopes simultaneously:\n *   Asset \"Report.pdf\" is in both \"folder_123\" AND \"asset_search\" results\n */\nexport type MenuScope = string;\n\nexport const MentionMenuSection = {\n  CURRENT_WEBPAGE: \"current-webpage\",\n  OTHER_WEBPAGES: \"other-webpages\",\n  LIBRARY: \"library\",\n} as const;\n\nexport type MentionMenuSection =\n  (typeof MentionMenuSection)[keyof typeof MentionMenuSection];\n\nexport interface WebpageMention {\n  tabId: number;\n  title: string;\n  url: string;\n  isCurrent: boolean;\n}\n\nexport interface WebpageMentionScope {\n  primaryTabId: number;\n  tabGroupId: number | null;\n  allowedTabIds: readonly number[];\n}\n\n/**\n * Selector result - provides current state + loading indicators\n * Used by the UI to get immediate access to data and loading state\n */\nexport interface MenuItemsSelector {\n  items: MenuItem[];\n  isFetching: boolean;\n  hasMore: boolean;\n}\n\n/**\n * MenuItem - individual mentionable item\n * Icon fields match MentionIcon component props exactly - no transforms needed at render time!\n *\n * Multi-scope system: Items can belong to multiple scopes simultaneously\n * Example: An asset can be visible in 'athena_assets', 'folder_123', and 'my_spaces'\n */\nexport interface MenuItem {\n  id: string;\n  name: string;\n  type:\n    | 'menu'\n    | 'asset'\n    | 'folder'\n    | 'tool'\n    | 'toolkit'\n    | 'drive'\n    | 'user'\n    | 'task'\n    | 'tab'\n    | 'workspace_item'\n    | 'drive_catalog'\n    | 'placeholder';\n\n  // Icon fields (match MentionIcon component props)\n  thumbnailUrl?: string; // For assets: URL/path to thumbnail (e.g., from AthenaTypeToThumb)\n  fallbackIcon: string; // For menus/tools: Lucide icon name (e.g., 'Folder', 'Wrench') or emoji\n\n  // Multi-scope membership: Which menu scopes this item is visible in\n  // Items can belong to multiple scopes simultaneously\n  visibleInScopes: Set<MenuScope>; // e.g., Set(['athena_assets', 'folder_123', 'my_spaces'])\n\n  // Navigation capability: If present, this item can be navigated into\n  // When user selects this item, navigate to this scope\n  navigatesToScope?: MenuScope;\n\n  // Navigation-only flag: If true, item CANNOT be inserted as mention (only navigate)\n  // Use for root categories that are pure navigation containers\n  isNavigationOnly?: boolean; // Default: false (most items are mentionable)\n\n  // Type-specific metadata\n  extra?: Record<string, any>;\n  description?: string;\n  url?: string;\n  menuSection?: MentionMenuSection;\n  updatedAt?: string;\n  email?: string; // For user type\n  version?: string; // For versioned assets\n\n  // Legacy compatibility\n  parentMenuId?: string;\n}\n\n/**\n * FetchState - fetch status and pagination state for a specific query\n * Managed by orchestrator, not returned by sources\n */\nexport interface FetchState {\n  isFetching: boolean;\n  hasNextPage: boolean;\n  fetchNext: (() => void) | null;\n  error: Error | null; // Track errors to prevent infinite retry loops\n\n  // Source-specific pagination metadata (offset, cursor, page token, etc.)\n  // Each source stores what IT needs between calls\n  // Orchestrator doesn't care what's in here!\n  meta: unknown;\n}\n\n/**\n * FetchMetadata - Common metadata fields used by orchestrator\n * Sources can extend this with their own fields (e.g., pageToken, cursor)\n */\nexport interface FetchMetadata {\n  // Orchestrator fields\n  validatedCount?: number; // Number of items fetched and validated so far\n  fetchAttempts?: number; // Number of fetch attempts (for safety limits)\n  // Source-specific fields can be added via extension or intersection\n  [key: string]: unknown;\n}\n\n/**\n * New source to register dynamically\n * Returned by sources when they discover navigable items (folders, catalogs, etc.)\n */\nexport interface SourceToRegister {\n  scope: MenuScope; // The scope ID to register\n  sourceFn: SourceFn; // The source function to use for this scope\n  sourceConfig?: any; // Configuration for the source\n  isFlat?: boolean; // Whether this scope should be flat (no navigation arrows)\n}\n\n/**\n * Scope binding to register dynamically\n * Binds a browse scope to a search scope (hot scope swap on query)\n */\nexport interface ScopeBindingToRegister {\n  browseScope: MenuScope; // The scope shown when browsing (no query)\n  searchScope: MenuScope; // The scope shown when searching (has query)\n}\n\n/**\n * Source result - returned by all source functions\n *\n * Sources come in two flavors:\n * 1. TRANSFORMERS - Transform existing data (no API calls)\n *    Examples: tools, toolkits, workspace members, opened spaces\n *    Pattern: Read from store/ref → transform → return items\n *\n * 2. FETCHERS - Fetch from API (async operations)\n *    Examples: internal assets, folders, SharePoint items\n *    Pattern: Call GraphQL/REST → transform response → return items\n *\n * 3. HYBRID - Behavior depends on query\n *    Example: Root menu (transformer when no query, fetcher with query)\n *\n * Original design: Sources can return new sources to register!\n * This allows discovered items (folders, catalogs) to be dynamically registered\n * without circular dependencies (orchestrator handles registration centrally)\n */\nexport interface SourceResult {\n  // Items to add/update (source sets navigatesToScope on navigable items)\n  // Orchestrator will tag these items with the current scope\n  items: MenuItem[];\n\n  // Pagination metadata (what we learned from this fetch)\n  // All sources return this - orchestrator uses it\n  pagination?: {\n    hasMore: boolean;\n    totalCount?: number;\n    // Rows the source consumed from the server for this page. Defaults to\n    // `items.length`; sources that drop rows after fetching must report the\n    // pre-filter count so the next offset does not re-read the same rows.\n    consumedCount?: number;\n  };\n\n  // Source-specific metadata (e.g., pageToken for SharePoint, cursor for pagination)\n  // Orchestrator merges this into fetchState.meta for the next fetch\n  meta?: Record<string, unknown>;\n\n  // New sources to register (for discovered navigable items)\n  // Orchestrator will register these in the registry\n  sources?: SourceToRegister[];\n\n  // New bindings to register (for hot scope swap on query)\n  // Example: catalogId → catalogId_search\n  bindings?: ScopeBindingToRegister[];\n}\n\n/**\n * Source function context\n *\n * Sources are pure functions - just fetch/transform and return items!\n * Orchestrator handles sync/deduplication via Cache.addItems() with scope tagging\n */\nexport interface SourceContext<TConfig = any> {\n  scope: MenuScope; // Current scope we're fetching for\n  query: string; // User's search query\n  fetchState: FetchState; // Pagination state for this query (includes source-specific meta)\n  sourceConfig: TConfig; // Source configuration (can include getters for reactive data!)\n}\n\n/**\n * Source function type\n *\n * Pure function that provides items for a scope + query combination.\n * Can be a transformer (reads from store) or fetcher (calls API).\n * State (pagination, sourceConfig) is stored externally in registry entry.\n */\nexport type SourceFn<TConfig = any> = (context: SourceContext<TConfig>) => Promise<SourceResult>;\n\n/**\n * A host-provided candidate for the Tools / Toolkits categories. A host that\n * hands the composer a list of these replaces the server tool catalog for\n * those categories with its own (AthenaChat offers the toolkits its provider\n * enabled, or whatever the host passes through `mentionTools`).\n */\nexport interface MentionTool {\n  id: string;\n  name: string;\n  description?: string;\n  /** Lucide icon name (`Package`, `Wrench`, …) or an emoji. */\n  icon?: string;\n  type: 'tool' | 'toolkit';\n}\n"],"names":[],"mappings":";;AAmBO,MAAM,qBAAqB;AAAA,EAChC,iBAAiB;AAAA,EACjB,gBAAgB;AAAA,EAChB,SAAS;AACX;;"}
+{"version":3,"file":"types.cjs","sources":["../../../../../src/chat-ui/mentions/suggestions/data/types.ts"],"sourcesContent":["/**\n * Core types for mention suggestions data layer\n */\n\n/**\n * MenuScope - A navigable container in the mention menu hierarchy\n *\n * Conceptual model:\n * - SCOPE = Container/Group you navigate INTO (e.g., \"athena_assets\", \"folder_123\")\n * - ITEM = Individual mentionable thing you SELECT (e.g., specific asset, tool)\n *\n * Scopes form a navigation hierarchy:\n *   root → athena_assets → folder_123 → subfolder_456\n *\n * Items can be visible in multiple scopes simultaneously:\n *   Asset \"Report.pdf\" is in both \"folder_123\" AND \"asset_search\" results\n */\nexport type MenuScope = string;\n\nexport const MentionMenuSection = {\n  CURRENT_WEBPAGE: \"current-webpage\",\n  OTHER_WEBPAGES: \"other-webpages\",\n  LIBRARY: \"library\",\n} as const;\n\nexport type MentionMenuSection =\n  (typeof MentionMenuSection)[keyof typeof MentionMenuSection];\n\nexport interface WebpageMention {\n  tabId: number;\n  title: string;\n  url: string;\n  isCurrent: boolean;\n}\n\nexport interface WebpageMentionScope {\n  primaryTabId: number;\n  tabGroupId: number | null;\n  allowedTabIds: readonly number[];\n}\n\n/**\n * Selector result - provides current state + loading indicators\n * Used by the UI to get immediate access to data and loading state\n */\nexport interface MenuItemsSelector {\n  items: MenuItem[];\n  isFetching: boolean;\n  hasMore: boolean;\n}\n\n/**\n * MenuItem - individual mentionable item\n * Icon fields match MentionIcon component props exactly - no transforms needed at render time!\n *\n * Multi-scope system: Items can belong to multiple scopes simultaneously\n * Example: An asset can be visible in 'athena_assets', 'folder_123', and 'my_spaces'\n */\nexport interface MenuItem {\n  id: string;\n  name: string;\n  type:\n    | 'menu'\n    | 'asset'\n    | 'folder'\n    | 'tool'\n    | 'toolkit'\n    | 'drive'\n    | 'user'\n    | 'group'\n    | 'agent'\n    | 'task'\n    | 'tab'\n    | 'workspace_item'\n    | 'drive_catalog'\n    | 'placeholder';\n\n  // Icon fields (match MentionIcon component props)\n  thumbnailUrl?: string; // For assets: URL/path to thumbnail (e.g., from AthenaTypeToThumb)\n  fallbackIcon: string; // For menus/tools: Lucide icon name (e.g., 'Folder', 'Wrench') or emoji\n\n  // Multi-scope membership: Which menu scopes this item is visible in\n  // Items can belong to multiple scopes simultaneously\n  visibleInScopes: Set<MenuScope>; // e.g., Set(['athena_assets', 'folder_123', 'my_spaces'])\n\n  // Navigation capability: If present, this item can be navigated into\n  // When user selects this item, navigate to this scope\n  navigatesToScope?: MenuScope;\n\n  // Navigation-only flag: If true, item CANNOT be inserted as mention (only navigate)\n  // Use for root categories that are pure navigation containers\n  isNavigationOnly?: boolean; // Default: false (most items are mentionable)\n\n  // Type-specific metadata\n  extra?: Record<string, any>;\n  description?: string;\n  url?: string;\n  menuSection?: MentionMenuSection;\n  updatedAt?: string;\n  email?: string; // For user type\n  version?: string; // For versioned assets\n\n  // Legacy compatibility\n  parentMenuId?: string;\n}\n\n/**\n * FetchState - fetch status and pagination state for a specific query\n * Managed by orchestrator, not returned by sources\n */\nexport interface FetchState {\n  isFetching: boolean;\n  hasNextPage: boolean;\n  fetchNext: (() => void) | null;\n  error: Error | null; // Track errors to prevent infinite retry loops\n\n  // Source-specific pagination metadata (offset, cursor, page token, etc.)\n  // Each source stores what IT needs between calls\n  // Orchestrator doesn't care what's in here!\n  meta: unknown;\n}\n\n/**\n * FetchMetadata - Common metadata fields used by orchestrator\n * Sources can extend this with their own fields (e.g., pageToken, cursor)\n */\nexport interface FetchMetadata {\n  // Orchestrator fields\n  validatedCount?: number; // Number of items fetched and validated so far\n  fetchAttempts?: number; // Number of fetch attempts (for safety limits)\n  // Source-specific fields can be added via extension or intersection\n  [key: string]: unknown;\n}\n\n/**\n * New source to register dynamically\n * Returned by sources when they discover navigable items (folders, catalogs, etc.)\n */\nexport interface SourceToRegister {\n  scope: MenuScope; // The scope ID to register\n  sourceFn: SourceFn; // The source function to use for this scope\n  sourceConfig?: any; // Configuration for the source\n  isFlat?: boolean; // Whether this scope should be flat (no navigation arrows)\n}\n\n/**\n * Scope binding to register dynamically\n * Binds a browse scope to a search scope (hot scope swap on query)\n */\nexport interface ScopeBindingToRegister {\n  browseScope: MenuScope; // The scope shown when browsing (no query)\n  searchScope: MenuScope; // The scope shown when searching (has query)\n}\n\n/**\n * Source result - returned by all source functions\n *\n * Sources come in two flavors:\n * 1. TRANSFORMERS - Transform existing data (no API calls)\n *    Examples: tools, toolkits, workspace members, opened spaces\n *    Pattern: Read from store/ref → transform → return items\n *\n * 2. FETCHERS - Fetch from API (async operations)\n *    Examples: internal assets, folders, SharePoint items\n *    Pattern: Call GraphQL/REST → transform response → return items\n *\n * 3. HYBRID - Behavior depends on query\n *    Example: Root menu (transformer when no query, fetcher with query)\n *\n * Original design: Sources can return new sources to register!\n * This allows discovered items (folders, catalogs) to be dynamically registered\n * without circular dependencies (orchestrator handles registration centrally)\n */\nexport interface SourceResult {\n  // Items to add/update (source sets navigatesToScope on navigable items)\n  // Orchestrator will tag these items with the current scope\n  items: MenuItem[];\n\n  // Pagination metadata (what we learned from this fetch)\n  // All sources return this - orchestrator uses it\n  pagination?: {\n    hasMore: boolean;\n    totalCount?: number;\n    // Rows the source consumed from the server for this page. Defaults to\n    // `items.length`; sources that drop rows after fetching must report the\n    // pre-filter count so the next offset does not re-read the same rows.\n    consumedCount?: number;\n  };\n\n  // Source-specific metadata (e.g., pageToken for SharePoint, cursor for pagination)\n  // Orchestrator merges this into fetchState.meta for the next fetch\n  meta?: Record<string, unknown>;\n\n  // New sources to register (for discovered navigable items)\n  // Orchestrator will register these in the registry\n  sources?: SourceToRegister[];\n\n  // New bindings to register (for hot scope swap on query)\n  // Example: catalogId → catalogId_search\n  bindings?: ScopeBindingToRegister[];\n}\n\n/**\n * Source function context\n *\n * Sources are pure functions - just fetch/transform and return items!\n * Orchestrator handles sync/deduplication via Cache.addItems() with scope tagging\n */\nexport interface SourceContext<TConfig = any> {\n  scope: MenuScope; // Current scope we're fetching for\n  query: string; // User's search query\n  fetchState: FetchState; // Pagination state for this query (includes source-specific meta)\n  sourceConfig: TConfig; // Source configuration (can include getters for reactive data!)\n}\n\n/**\n * Source function type\n *\n * Pure function that provides items for a scope + query combination.\n * Can be a transformer (reads from store) or fetcher (calls API).\n * State (pagination, sourceConfig) is stored externally in registry entry.\n */\nexport type SourceFn<TConfig = any> = (context: SourceContext<TConfig>) => Promise<SourceResult>;\n\n/**\n * An agent a chat message can name (identity v7 D13), as the `@` menu's Agents section offers it:\n * choosing one names it for the message (a chip on the composer's To line) and never writes a\n * mention into the text. `ref` is what the send names (`collab_agent:<asset id>`, or `assistant`\n * for the person's own assistant).\n */\nexport interface MentionChatAgent {\n  ref: string;\n  name: string;\n  /** The collab agent asset behind `ref`; `null` for the person's own assistant. */\n  assetId: string | null;\n  /** A Lucide icon name for the menu row. */\n  icon: string;\n}\n\n/**\n * What a composer that names agents hands its `@` menu (`TiptapComposer`'s `chatAgents`): the\n * agents offered now, naming what is chosen, and a way to hear the offer change.\n */\nexport interface MentionChatAgents {\n  /** The agents the Agents section offers now (none once eight are named). */\n  getAgents: () => readonly MentionChatAgent[];\n  /** Name `agents` for the message, in the order chosen. */\n  nameAgents: (agents: readonly MentionChatAgent[]) => void;\n  /** Called whenever {@link MentionChatAgents.getAgents} would answer differently. */\n  subscribe: (listener: () => void) => () => void;\n}\n\n/**\n * A host-provided candidate for the Tools / Toolkits categories. A host that\n * hands the composer a list of these replaces the server tool catalog for\n * those categories with its own (AthenaChat offers the toolkits its provider\n * enabled, or whatever the host passes through `mentionTools`).\n */\nexport interface MentionTool {\n  id: string;\n  name: string;\n  description?: string;\n  /** Lucide icon name (`Package`, `Wrench`, …) or an emoji. */\n  icon?: string;\n  type: 'tool' | 'toolkit';\n}\n"],"names":[],"mappings":";;AAmBO,MAAM,qBAAqB;AAAA,EAChC,iBAAiB;AAAA,EACjB,gBAAgB;AAAA,EAChB,SAAS;AACX;;"}

package/dist/chat-ui/mentions/suggestions/data/types.d.ts

@@ -51,7 +51,7 @@ export interface MenuItemsSelector {
 export interface MenuItem {
     id: string;
     name: string;
-    type: 'menu' | 'asset' | 'folder' | 'tool' | 'toolkit' | 'drive' | 'user' | 'task' | 'tab' | 'workspace_item' | 'drive_catalog' | 'placeholder';
+    type: 'menu' | 'asset' | 'folder' | 'tool' | 'toolkit' | 'drive' | 'user' | 'group' | 'agent' | 'task' | 'tab' | 'workspace_item' | 'drive_catalog' | 'placeholder';
     thumbnailUrl?: string;
     fallbackIcon: string;
     visibleInScopes: Set<MenuScope>;
@@ -154,6 +154,32 @@ export interface SourceContext<TConfig = any> {
  * State (pagination, sourceConfig) is stored externally in registry entry.
  */
 export type SourceFn<TConfig = any> = (context: SourceContext<TConfig>) => Promise<SourceResult>;
+/**
+ * An agent a chat message can name (identity v7 D13), as the `@` menu's Agents section offers it:
+ * choosing one names it for the message (a chip on the composer's To line) and never writes a
+ * mention into the text. `ref` is what the send names (`collab_agent:<asset id>`, or `assistant`
+ * for the person's own assistant).
+ */
+export interface MentionChatAgent {
+    ref: string;
+    name: string;
+    /** The collab agent asset behind `ref`; `null` for the person's own assistant. */
+    assetId: string | null;
+    /** A Lucide icon name for the menu row. */
+    icon: string;
+}
+/**
+ * What a composer that names agents hands its `@` menu (`TiptapComposer`'s `chatAgents`): the
+ * agents offered now, naming what is chosen, and a way to hear the offer change.
+ */
+export interface MentionChatAgents {
+    /** The agents the Agents section offers now (none once eight are named). */
+    getAgents: () => readonly MentionChatAgent[];
+    /** Name `agents` for the message, in the order chosen. */
+    nameAgents: (agents: readonly MentionChatAgent[]) => void;
+    /** Called whenever {@link MentionChatAgents.getAgents} would answer differently. */
+    subscribe: (listener: () => void) => () => void;
+}
 /**
  * A host-provided candidate for the Tools / Toolkits categories. A host that
  * hands the composer a list of these replaces the server tool catalog for

package/dist/chat-ui/mentions/suggestions/data/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../../../../src/chat-ui/mentions/suggestions/data/types.ts"],"sourcesContent":["/**\n * Core types for mention suggestions data layer\n */\n\n/**\n * MenuScope - A navigable container in the mention menu hierarchy\n *\n * Conceptual model:\n * - SCOPE = Container/Group you navigate INTO (e.g., \"athena_assets\", \"folder_123\")\n * - ITEM = Individual mentionable thing you SELECT (e.g., specific asset, tool)\n *\n * Scopes form a navigation hierarchy:\n *   root → athena_assets → folder_123 → subfolder_456\n *\n * Items can be visible in multiple scopes simultaneously:\n *   Asset \"Report.pdf\" is in both \"folder_123\" AND \"asset_search\" results\n */\nexport type MenuScope = string;\n\nexport const MentionMenuSection = {\n  CURRENT_WEBPAGE: \"current-webpage\",\n  OTHER_WEBPAGES: \"other-webpages\",\n  LIBRARY: \"library\",\n} as const;\n\nexport type MentionMenuSection =\n  (typeof MentionMenuSection)[keyof typeof MentionMenuSection];\n\nexport interface WebpageMention {\n  tabId: number;\n  title: string;\n  url: string;\n  isCurrent: boolean;\n}\n\nexport interface WebpageMentionScope {\n  primaryTabId: number;\n  tabGroupId: number | null;\n  allowedTabIds: readonly number[];\n}\n\n/**\n * Selector result - provides current state + loading indicators\n * Used by the UI to get immediate access to data and loading state\n */\nexport interface MenuItemsSelector {\n  items: MenuItem[];\n  isFetching: boolean;\n  hasMore: boolean;\n}\n\n/**\n * MenuItem - individual mentionable item\n * Icon fields match MentionIcon component props exactly - no transforms needed at render time!\n *\n * Multi-scope system: Items can belong to multiple scopes simultaneously\n * Example: An asset can be visible in 'athena_assets', 'folder_123', and 'my_spaces'\n */\nexport interface MenuItem {\n  id: string;\n  name: string;\n  type:\n    | 'menu'\n    | 'asset'\n    | 'folder'\n    | 'tool'\n    | 'toolkit'\n    | 'drive'\n    | 'user'\n    | 'task'\n    | 'tab'\n    | 'workspace_item'\n    | 'drive_catalog'\n    | 'placeholder';\n\n  // Icon fields (match MentionIcon component props)\n  thumbnailUrl?: string; // For assets: URL/path to thumbnail (e.g., from AthenaTypeToThumb)\n  fallbackIcon: string; // For menus/tools: Lucide icon name (e.g., 'Folder', 'Wrench') or emoji\n\n  // Multi-scope membership: Which menu scopes this item is visible in\n  // Items can belong to multiple scopes simultaneously\n  visibleInScopes: Set<MenuScope>; // e.g., Set(['athena_assets', 'folder_123', 'my_spaces'])\n\n  // Navigation capability: If present, this item can be navigated into\n  // When user selects this item, navigate to this scope\n  navigatesToScope?: MenuScope;\n\n  // Navigation-only flag: If true, item CANNOT be inserted as mention (only navigate)\n  // Use for root categories that are pure navigation containers\n  isNavigationOnly?: boolean; // Default: false (most items are mentionable)\n\n  // Type-specific metadata\n  extra?: Record<string, any>;\n  description?: string;\n  url?: string;\n  menuSection?: MentionMenuSection;\n  updatedAt?: string;\n  email?: string; // For user type\n  version?: string; // For versioned assets\n\n  // Legacy compatibility\n  parentMenuId?: string;\n}\n\n/**\n * FetchState - fetch status and pagination state for a specific query\n * Managed by orchestrator, not returned by sources\n */\nexport interface FetchState {\n  isFetching: boolean;\n  hasNextPage: boolean;\n  fetchNext: (() => void) | null;\n  error: Error | null; // Track errors to prevent infinite retry loops\n\n  // Source-specific pagination metadata (offset, cursor, page token, etc.)\n  // Each source stores what IT needs between calls\n  // Orchestrator doesn't care what's in here!\n  meta: unknown;\n}\n\n/**\n * FetchMetadata - Common metadata fields used by orchestrator\n * Sources can extend this with their own fields (e.g., pageToken, cursor)\n */\nexport interface FetchMetadata {\n  // Orchestrator fields\n  validatedCount?: number; // Number of items fetched and validated so far\n  fetchAttempts?: number; // Number of fetch attempts (for safety limits)\n  // Source-specific fields can be added via extension or intersection\n  [key: string]: unknown;\n}\n\n/**\n * New source to register dynamically\n * Returned by sources when they discover navigable items (folders, catalogs, etc.)\n */\nexport interface SourceToRegister {\n  scope: MenuScope; // The scope ID to register\n  sourceFn: SourceFn; // The source function to use for this scope\n  sourceConfig?: any; // Configuration for the source\n  isFlat?: boolean; // Whether this scope should be flat (no navigation arrows)\n}\n\n/**\n * Scope binding to register dynamically\n * Binds a browse scope to a search scope (hot scope swap on query)\n */\nexport interface ScopeBindingToRegister {\n  browseScope: MenuScope; // The scope shown when browsing (no query)\n  searchScope: MenuScope; // The scope shown when searching (has query)\n}\n\n/**\n * Source result - returned by all source functions\n *\n * Sources come in two flavors:\n * 1. TRANSFORMERS - Transform existing data (no API calls)\n *    Examples: tools, toolkits, workspace members, opened spaces\n *    Pattern: Read from store/ref → transform → return items\n *\n * 2. FETCHERS - Fetch from API (async operations)\n *    Examples: internal assets, folders, SharePoint items\n *    Pattern: Call GraphQL/REST → transform response → return items\n *\n * 3. HYBRID - Behavior depends on query\n *    Example: Root menu (transformer when no query, fetcher with query)\n *\n * Original design: Sources can return new sources to register!\n * This allows discovered items (folders, catalogs) to be dynamically registered\n * without circular dependencies (orchestrator handles registration centrally)\n */\nexport interface SourceResult {\n  // Items to add/update (source sets navigatesToScope on navigable items)\n  // Orchestrator will tag these items with the current scope\n  items: MenuItem[];\n\n  // Pagination metadata (what we learned from this fetch)\n  // All sources return this - orchestrator uses it\n  pagination?: {\n    hasMore: boolean;\n    totalCount?: number;\n    // Rows the source consumed from the server for this page. Defaults to\n    // `items.length`; sources that drop rows after fetching must report the\n    // pre-filter count so the next offset does not re-read the same rows.\n    consumedCount?: number;\n  };\n\n  // Source-specific metadata (e.g., pageToken for SharePoint, cursor for pagination)\n  // Orchestrator merges this into fetchState.meta for the next fetch\n  meta?: Record<string, unknown>;\n\n  // New sources to register (for discovered navigable items)\n  // Orchestrator will register these in the registry\n  sources?: SourceToRegister[];\n\n  // New bindings to register (for hot scope swap on query)\n  // Example: catalogId → catalogId_search\n  bindings?: ScopeBindingToRegister[];\n}\n\n/**\n * Source function context\n *\n * Sources are pure functions - just fetch/transform and return items!\n * Orchestrator handles sync/deduplication via Cache.addItems() with scope tagging\n */\nexport interface SourceContext<TConfig = any> {\n  scope: MenuScope; // Current scope we're fetching for\n  query: string; // User's search query\n  fetchState: FetchState; // Pagination state for this query (includes source-specific meta)\n  sourceConfig: TConfig; // Source configuration (can include getters for reactive data!)\n}\n\n/**\n * Source function type\n *\n * Pure function that provides items for a scope + query combination.\n * Can be a transformer (reads from store) or fetcher (calls API).\n * State (pagination, sourceConfig) is stored externally in registry entry.\n */\nexport type SourceFn<TConfig = any> = (context: SourceContext<TConfig>) => Promise<SourceResult>;\n\n/**\n * A host-provided candidate for the Tools / Toolkits categories. A host that\n * hands the composer a list of these replaces the server tool catalog for\n * those categories with its own (AthenaChat offers the toolkits its provider\n * enabled, or whatever the host passes through `mentionTools`).\n */\nexport interface MentionTool {\n  id: string;\n  name: string;\n  description?: string;\n  /** Lucide icon name (`Package`, `Wrench`, …) or an emoji. */\n  icon?: string;\n  type: 'tool' | 'toolkit';\n}\n"],"names":[],"mappings":"AAmBO,MAAM,qBAAqB;AAAA,EAChC,iBAAiB;AAAA,EACjB,gBAAgB;AAAA,EAChB,SAAS;AACX;"}
+{"version":3,"file":"types.js","sources":["../../../../../src/chat-ui/mentions/suggestions/data/types.ts"],"sourcesContent":["/**\n * Core types for mention suggestions data layer\n */\n\n/**\n * MenuScope - A navigable container in the mention menu hierarchy\n *\n * Conceptual model:\n * - SCOPE = Container/Group you navigate INTO (e.g., \"athena_assets\", \"folder_123\")\n * - ITEM = Individual mentionable thing you SELECT (e.g., specific asset, tool)\n *\n * Scopes form a navigation hierarchy:\n *   root → athena_assets → folder_123 → subfolder_456\n *\n * Items can be visible in multiple scopes simultaneously:\n *   Asset \"Report.pdf\" is in both \"folder_123\" AND \"asset_search\" results\n */\nexport type MenuScope = string;\n\nexport const MentionMenuSection = {\n  CURRENT_WEBPAGE: \"current-webpage\",\n  OTHER_WEBPAGES: \"other-webpages\",\n  LIBRARY: \"library\",\n} as const;\n\nexport type MentionMenuSection =\n  (typeof MentionMenuSection)[keyof typeof MentionMenuSection];\n\nexport interface WebpageMention {\n  tabId: number;\n  title: string;\n  url: string;\n  isCurrent: boolean;\n}\n\nexport interface WebpageMentionScope {\n  primaryTabId: number;\n  tabGroupId: number | null;\n  allowedTabIds: readonly number[];\n}\n\n/**\n * Selector result - provides current state + loading indicators\n * Used by the UI to get immediate access to data and loading state\n */\nexport interface MenuItemsSelector {\n  items: MenuItem[];\n  isFetching: boolean;\n  hasMore: boolean;\n}\n\n/**\n * MenuItem - individual mentionable item\n * Icon fields match MentionIcon component props exactly - no transforms needed at render time!\n *\n * Multi-scope system: Items can belong to multiple scopes simultaneously\n * Example: An asset can be visible in 'athena_assets', 'folder_123', and 'my_spaces'\n */\nexport interface MenuItem {\n  id: string;\n  name: string;\n  type:\n    | 'menu'\n    | 'asset'\n    | 'folder'\n    | 'tool'\n    | 'toolkit'\n    | 'drive'\n    | 'user'\n    | 'group'\n    | 'agent'\n    | 'task'\n    | 'tab'\n    | 'workspace_item'\n    | 'drive_catalog'\n    | 'placeholder';\n\n  // Icon fields (match MentionIcon component props)\n  thumbnailUrl?: string; // For assets: URL/path to thumbnail (e.g., from AthenaTypeToThumb)\n  fallbackIcon: string; // For menus/tools: Lucide icon name (e.g., 'Folder', 'Wrench') or emoji\n\n  // Multi-scope membership: Which menu scopes this item is visible in\n  // Items can belong to multiple scopes simultaneously\n  visibleInScopes: Set<MenuScope>; // e.g., Set(['athena_assets', 'folder_123', 'my_spaces'])\n\n  // Navigation capability: If present, this item can be navigated into\n  // When user selects this item, navigate to this scope\n  navigatesToScope?: MenuScope;\n\n  // Navigation-only flag: If true, item CANNOT be inserted as mention (only navigate)\n  // Use for root categories that are pure navigation containers\n  isNavigationOnly?: boolean; // Default: false (most items are mentionable)\n\n  // Type-specific metadata\n  extra?: Record<string, any>;\n  description?: string;\n  url?: string;\n  menuSection?: MentionMenuSection;\n  updatedAt?: string;\n  email?: string; // For user type\n  version?: string; // For versioned assets\n\n  // Legacy compatibility\n  parentMenuId?: string;\n}\n\n/**\n * FetchState - fetch status and pagination state for a specific query\n * Managed by orchestrator, not returned by sources\n */\nexport interface FetchState {\n  isFetching: boolean;\n  hasNextPage: boolean;\n  fetchNext: (() => void) | null;\n  error: Error | null; // Track errors to prevent infinite retry loops\n\n  // Source-specific pagination metadata (offset, cursor, page token, etc.)\n  // Each source stores what IT needs between calls\n  // Orchestrator doesn't care what's in here!\n  meta: unknown;\n}\n\n/**\n * FetchMetadata - Common metadata fields used by orchestrator\n * Sources can extend this with their own fields (e.g., pageToken, cursor)\n */\nexport interface FetchMetadata {\n  // Orchestrator fields\n  validatedCount?: number; // Number of items fetched and validated so far\n  fetchAttempts?: number; // Number of fetch attempts (for safety limits)\n  // Source-specific fields can be added via extension or intersection\n  [key: string]: unknown;\n}\n\n/**\n * New source to register dynamically\n * Returned by sources when they discover navigable items (folders, catalogs, etc.)\n */\nexport interface SourceToRegister {\n  scope: MenuScope; // The scope ID to register\n  sourceFn: SourceFn; // The source function to use for this scope\n  sourceConfig?: any; // Configuration for the source\n  isFlat?: boolean; // Whether this scope should be flat (no navigation arrows)\n}\n\n/**\n * Scope binding to register dynamically\n * Binds a browse scope to a search scope (hot scope swap on query)\n */\nexport interface ScopeBindingToRegister {\n  browseScope: MenuScope; // The scope shown when browsing (no query)\n  searchScope: MenuScope; // The scope shown when searching (has query)\n}\n\n/**\n * Source result - returned by all source functions\n *\n * Sources come in two flavors:\n * 1. TRANSFORMERS - Transform existing data (no API calls)\n *    Examples: tools, toolkits, workspace members, opened spaces\n *    Pattern: Read from store/ref → transform → return items\n *\n * 2. FETCHERS - Fetch from API (async operations)\n *    Examples: internal assets, folders, SharePoint items\n *    Pattern: Call GraphQL/REST → transform response → return items\n *\n * 3. HYBRID - Behavior depends on query\n *    Example: Root menu (transformer when no query, fetcher with query)\n *\n * Original design: Sources can return new sources to register!\n * This allows discovered items (folders, catalogs) to be dynamically registered\n * without circular dependencies (orchestrator handles registration centrally)\n */\nexport interface SourceResult {\n  // Items to add/update (source sets navigatesToScope on navigable items)\n  // Orchestrator will tag these items with the current scope\n  items: MenuItem[];\n\n  // Pagination metadata (what we learned from this fetch)\n  // All sources return this - orchestrator uses it\n  pagination?: {\n    hasMore: boolean;\n    totalCount?: number;\n    // Rows the source consumed from the server for this page. Defaults to\n    // `items.length`; sources that drop rows after fetching must report the\n    // pre-filter count so the next offset does not re-read the same rows.\n    consumedCount?: number;\n  };\n\n  // Source-specific metadata (e.g., pageToken for SharePoint, cursor for pagination)\n  // Orchestrator merges this into fetchState.meta for the next fetch\n  meta?: Record<string, unknown>;\n\n  // New sources to register (for discovered navigable items)\n  // Orchestrator will register these in the registry\n  sources?: SourceToRegister[];\n\n  // New bindings to register (for hot scope swap on query)\n  // Example: catalogId → catalogId_search\n  bindings?: ScopeBindingToRegister[];\n}\n\n/**\n * Source function context\n *\n * Sources are pure functions - just fetch/transform and return items!\n * Orchestrator handles sync/deduplication via Cache.addItems() with scope tagging\n */\nexport interface SourceContext<TConfig = any> {\n  scope: MenuScope; // Current scope we're fetching for\n  query: string; // User's search query\n  fetchState: FetchState; // Pagination state for this query (includes source-specific meta)\n  sourceConfig: TConfig; // Source configuration (can include getters for reactive data!)\n}\n\n/**\n * Source function type\n *\n * Pure function that provides items for a scope + query combination.\n * Can be a transformer (reads from store) or fetcher (calls API).\n * State (pagination, sourceConfig) is stored externally in registry entry.\n */\nexport type SourceFn<TConfig = any> = (context: SourceContext<TConfig>) => Promise<SourceResult>;\n\n/**\n * An agent a chat message can name (identity v7 D13), as the `@` menu's Agents section offers it:\n * choosing one names it for the message (a chip on the composer's To line) and never writes a\n * mention into the text. `ref` is what the send names (`collab_agent:<asset id>`, or `assistant`\n * for the person's own assistant).\n */\nexport interface MentionChatAgent {\n  ref: string;\n  name: string;\n  /** The collab agent asset behind `ref`; `null` for the person's own assistant. */\n  assetId: string | null;\n  /** A Lucide icon name for the menu row. */\n  icon: string;\n}\n\n/**\n * What a composer that names agents hands its `@` menu (`TiptapComposer`'s `chatAgents`): the\n * agents offered now, naming what is chosen, and a way to hear the offer change.\n */\nexport interface MentionChatAgents {\n  /** The agents the Agents section offers now (none once eight are named). */\n  getAgents: () => readonly MentionChatAgent[];\n  /** Name `agents` for the message, in the order chosen. */\n  nameAgents: (agents: readonly MentionChatAgent[]) => void;\n  /** Called whenever {@link MentionChatAgents.getAgents} would answer differently. */\n  subscribe: (listener: () => void) => () => void;\n}\n\n/**\n * A host-provided candidate for the Tools / Toolkits categories. A host that\n * hands the composer a list of these replaces the server tool catalog for\n * those categories with its own (AthenaChat offers the toolkits its provider\n * enabled, or whatever the host passes through `mentionTools`).\n */\nexport interface MentionTool {\n  id: string;\n  name: string;\n  description?: string;\n  /** Lucide icon name (`Package`, `Wrench`, …) or an emoji. */\n  icon?: string;\n  type: 'tool' | 'toolkit';\n}\n"],"names":[],"mappings":"AAmBO,MAAM,qBAAqB;AAAA,EAChC,iBAAiB;AAAA,EACjB,gBAAgB;AAAA,EAChB,SAAS;AACX;"}

package/dist/chat-ui/mentions/suggestions/data/use-mention-suggestions.cjs

@@ -26,6 +26,7 @@ const ROOT_MENTION_CATEGORIES = [
   "tools",
   "toolkits",
   "team",
+  "agents",
   "drives"
 ];
 function providedToolsFingerprint(tools) {
@@ -43,21 +44,30 @@ function buildStore({
   auth,
   getWebpages,
   getTools,
+  getChatAgents,
+  getIsAdmin,
   rootCategories,
   athenaUnavailable
 }) {
   const registry = scopeRegistry.createScopeRegistry();
   const cache = itemCache.createItemCache();
+  const offersAgents = rootCategories.includes("agents");
+  const offeredChatAgents = () => {
+    var _a;
+    return offersAgents ? ((_a = getChatAgents()) == null ? void 0 : _a.getAgents()) ?? [] : [];
+  };
   scopeRegistry.registerSource(registry, "root", index.transformRootCategories, {
     categories: [...rootCategories],
-    getWebpages
+    getWebpages,
+    getChatAgents: offeredChatAgents
   });
-  const loadTeam = index.createTeamLoader(auth);
+  const loadTeam = index.createTeamLoader(auth, { getIsAdmin });
   const withHostTools = getTools ? index.withProvidedTools(index.fetchGlobalSearch, getTools) : index.fetchGlobalSearch;
+  const withPeople = rootCategories.includes("team") ? index.withTeam(withHostTools, loadTeam) : withHostTools;
   scopeRegistry.registerSource(
     registry,
     "global_search",
-    rootCategories.includes("team") ? index.withTeam(withHostTools, loadTeam) : withHostTools,
+    offersAgents ? index.withChatAgents(withPeople, offeredChatAgents) : withPeople,
     { auth }
   );
   scopeRegistry.bindScopes(registry, "root", "global_search");
@@ -98,12 +108,25 @@ function buildStore({
     scopeRegistry.registerSource(registry, "toolkits", index.fetchToolkits, { auth });
   }
   scopeRegistry.registerSource(registry, "team", index.fetchTeam, { auth, loadTeam });
+  if (offersAgents) {
+    scopeRegistry.registerSource(registry, index.CHAT_AGENTS_SCOPE, index.transformChatAgents, {
+      getAgents: offeredChatAgents
+    });
+  }
   scopeRegistry.registerSource(registry, "drive_catalogs", index.fetchDrives, { auth });
-  return new store.Store({
+  const store$1 = new store.Store({
     registry,
     cache,
     athenaUnavailable
   });
+  store$1.nameAgents = (items) => {
+    const host = offersAgents ? getChatAgents() : void 0;
+    const agents = items.flatMap((item) => index.chatAgentFromMenuItem(item) ?? []);
+    if (!host || agents.length === 0) return false;
+    host.nameAgents(agents);
+    return true;
+  };
+  return store$1;
 }
 function sameReason(a, b) {
   if (a === null || b === null) return a === b;
@@ -113,7 +136,9 @@ function useMentionSuggestions({
   webpages,
   tools,
   rootCategories = ROOT_MENTION_CATEGORIES,
-  athenaUnavailable = null
+  athenaUnavailable = null,
+  chatAgents,
+  viewerIsAdmin = false
 }) {
   const auth = apiClient.useMentionAuth();
   const webpagesRef = require$$0.useRef(webpages);
@@ -121,6 +146,10 @@ function useMentionSuggestions({
   const toolsRef = require$$0.useRef(tools);
   toolsRef.current = tools;
   const hasProvidedTools = tools !== void 0;
+  const chatAgentsRef = require$$0.useRef(chatAgents);
+  chatAgentsRef.current = chatAgents;
+  const viewerIsAdminRef = require$$0.useRef(viewerIsAdmin);
+  viewerIsAdminRef.current = viewerIsAdmin;
   const athenaUnavailableRef = require$$0.useRef(athenaUnavailable);
   athenaUnavailableRef.current = athenaUnavailable;
   const store2 = require$$0.useMemo(
@@ -128,6 +157,8 @@ function useMentionSuggestions({
       auth,
       getWebpages: () => webpagesRef.current,
       getTools: hasProvidedTools ? () => toolsRef.current ?? [] : void 0,
+      getChatAgents: () => chatAgentsRef.current,
+      getIsAdmin: () => viewerIsAdminRef.current,
       rootCategories,
       athenaUnavailable: athenaUnavailableRef.current
     }),
@@ -188,6 +219,26 @@ function useMentionSuggestions({
     invalidate("toolkits");
     invalidate("global_search");
   }, [invalidate, toolsFingerprint]);
+  const offersAgents = rootCategories.includes("agents");
+  require$$0.useEffect(() => {
+    if (!offersAgents || !chatAgents) return;
+    const refresh = () => {
+      invalidate(index.CHAT_AGENTS_SCOPE);
+      invalidate("root");
+      invalidate("global_search");
+    };
+    refresh();
+    return chatAgents.subscribe(refresh);
+  }, [chatAgents, invalidate, offersAgents]);
+  const offersTeam = rootCategories.includes("team");
+  const previousViewerIsAdminRef = require$$0.useRef(viewerIsAdmin);
+  require$$0.useEffect(() => {
+    if (previousViewerIsAdminRef.current === viewerIsAdmin) return;
+    previousViewerIsAdminRef.current = viewerIsAdmin;
+    if (!offersTeam) return;
+    invalidate("team");
+    invalidate("global_search");
+  }, [invalidate, offersTeam, viewerIsAdmin]);
   return { store: store2, invalidate };
 }
 exports.ROOT_MENTION_CATEGORIES = ROOT_MENTION_CATEGORIES;

package/dist/chat-ui/mentions/suggestions/data/use-mention-suggestions.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-mention-suggestions.cjs","sources":["../../../../../src/chat-ui/mentions/suggestions/data/use-mention-suggestions.ts"],"sourcesContent":["/**\n * Mention Suggestions Store — shared by every Athena chat host (the Chrome\n * side panel, the Office task pane, the SDK's AthenaChat).\n *\n * Full Olympus-style mention store with all categories:\n * Favorites, Assets, Projects, Browse Profiles, Folders,\n * current/group webpages, Team, Workspace, Drives + Global Search (assets,\n * plus workspace members when Team is offered).\n *\n * Uses registry + cache architecture from Olympus with\n * async data fetching via GraphQL. A host may hand the Tools / Toolkits\n * categories its own list instead of the server catalog (`tools`).\n */\n\nimport type { LabelCopy } from \"@athenaintel/agent-runtime/offline-status\";\nimport { Store } from \"@tanstack/store\";\nimport { useEffect, useLayoutEffect, useMemo, useRef } from \"react\";\nimport type { MentionAuthContext } from \"./api-client\";\nimport { useMentionAuth } from \"./api-client\";\nimport { createItemCache, type ItemCache } from \"./item-cache\";\nimport { retryFailedFetches } from \"./orchestrator\";\nimport {\n  createScopeRegistry,\n  registerSource,\n  bindScopes,\n  type ScopeRegistry,\n} from \"./scope-registry\";\nimport {\n  transformRootCategories,\n  fetchAssets,\n  fetchFavorites,\n  fetchFolders,\n  fetchFolderContents,\n  fetchTypedAssets,\n  fetchTeam,\n  fetchTools,\n  fetchToolkits,\n  fetchDrives,\n  fetchGlobalSearch,\n  transformProvidedTools,\n  withProvidedTools,\n  createTeamLoader,\n  withTeam,\n} from \"./sources\";\nimport type { MentionTool, WebpageMention } from \"./types\";\n\nexport function webpageMentionFingerprint(\n  webpages: readonly WebpageMention[],\n): string {\n  return JSON.stringify(\n    webpages.map(({ tabId, title, url, isCurrent }) => [\n      tabId,\n      title,\n      url,\n      isCurrent,\n    ]),\n  );\n}\n\n// ── Store types ──\n\nexport interface MentionSuggestionsStoreState {\n  registry: ScopeRegistry;\n  cache: ItemCache;\n  /**\n   * Why nothing is asked of Athena right now, or `null` while it answers: the\n   * scopes whose source asks Athena fetch nothing and say this instead, while\n   * the host's own items (its tabs, its tool list) and what was already loaded\n   * still show.\n   */\n  athenaUnavailable: LabelCopy | null;\n}\n\nexport type MentionSuggestionsStore = Store<MentionSuggestionsStoreState>;\n\n// ── Categories ──\n\n/**\n * All mention menu categories, in display order.\n */\nexport const ROOT_MENTION_CATEGORIES = [\n  \"favorites\",\n  \"assets\",\n  \"projects\",\n  \"browse_profiles\",\n  \"folders\",\n  \"tools\",\n  \"toolkits\",\n  \"team\",\n  \"drives\",\n] as const;\n\nexport type MentionRootCategory = (typeof ROOT_MENTION_CATEGORIES)[number];\n\n// ── Store builder ──\n\n/** Stable fingerprint of a host's tool list, for cache invalidation. */\nexport function providedToolsFingerprint(tools: readonly MentionTool[]): string {\n  return JSON.stringify(\n    tools.map(({ id, name, type, description, icon }) => [\n      id,\n      name,\n      type,\n      description ?? null,\n      icon ?? null,\n    ]),\n  );\n}\n\nfunction buildStore({\n  auth,\n  getWebpages,\n  getTools,\n  rootCategories,\n  athenaUnavailable,\n}: {\n  auth: MentionAuthContext;\n  getWebpages: () => readonly WebpageMention[];\n  /** Present when the host supplies the Tools / Toolkits list itself. */\n  getTools?: () => readonly MentionTool[];\n  rootCategories: readonly MentionRootCategory[];\n  athenaUnavailable: LabelCopy | null;\n}): MentionSuggestionsStore {\n  const registry = createScopeRegistry();\n  const cache = createItemCache();\n\n  // ── Root categories ──\n  registerSource(registry, \"root\", transformRootCategories, {\n    categories: [...rootCategories],\n    getWebpages,\n  });\n\n  const loadTeam = createTeamLoader(auth);\n\n  // ── Global search (aggregated) ──\n  // A host's own tools ride along so a root query finds them beside assets,\n  // and so do workspace members when the host offers Team.\n  const withHostTools = getTools\n    ? withProvidedTools(fetchGlobalSearch, getTools)\n    : fetchGlobalSearch;\n  registerSource(\n    registry,\n    \"global_search\",\n    rootCategories.includes(\"team\") ? withTeam(withHostTools, loadTeam) : withHostTools,\n    { auth },\n  );\n  bindScopes(registry, \"root\", \"global_search\");\n\n  // ── Assets ──\n  registerSource(registry, \"athena_assets\", fetchAssets, { auth, limit: 50 });\n\n  // ── Favorites ──\n  registerSource(registry, \"favorites\", fetchFavorites, { auth, limit: 50 });\n\n  // ── Folders (flat list) ──\n  registerSource(\n    registry,\n    \"athena_folders\",\n    fetchFolders,\n    { auth, limit: 50 },\n    true /* isFlat */,\n  );\n\n  // ── Internal drive (folder navigation root) ──\n  registerSource(registry, \"internal_drive\", fetchFolderContents, {\n    auth,\n    limit: 50,\n  });\n\n  // ── Projects ──\n  registerSource(registry, \"athena_projects\", fetchTypedAssets, {\n    auth,\n    includeOnlyTypes: [\"project\"],\n    limit: 50,\n  });\n\n  // ── Browse Profiles ──\n  registerSource(registry, \"athena_browse_profiles\", fetchTypedAssets, {\n    auth,\n    includeOnlyTypes: [\"browse_profile\"],\n    limit: 50,\n  });\n\n  // ── Tools & Toolkits ── the server catalog, or the host's own list\n  if (getTools) {\n    registerSource(registry, \"tools\", transformProvidedTools, {\n      getTools,\n      type: \"tool\",\n    });\n    registerSource(registry, \"toolkits\", transformProvidedTools, {\n      getTools,\n      type: \"toolkit\",\n    });\n  } else {\n    registerSource(registry, \"tools\", fetchTools, { auth });\n    registerSource(registry, \"toolkits\", fetchToolkits, { auth });\n  }\n\n  // ── Team ──\n  registerSource(registry, \"team\", fetchTeam, { auth, loadTeam });\n\n  // ── Drives (catalogs) ──\n  registerSource(registry, \"drive_catalogs\", fetchDrives, { auth });\n\n  return new Store<MentionSuggestionsStoreState>({\n    registry,\n    cache,\n    athenaUnavailable,\n  });\n}\n\n/** Two reasons say the same thing (a host may hand a new object with the same words). */\nfunction sameReason(a: LabelCopy | null, b: LabelCopy | null): boolean {\n  if (a === null || b === null) return a === b;\n  return a.label === b.label && a.detail === b.detail;\n}\n\n// ── Hook ──\n\n/**\n * Creates a stable MentionSuggestionsStore.\n * Uses MentionAuthCtx for API credentials.\n */\nexport function useMentionSuggestions({\n  webpages,\n  tools,\n  rootCategories = ROOT_MENTION_CATEGORIES,\n  athenaUnavailable = null,\n}: {\n  webpages: readonly WebpageMention[];\n  /**\n   * Host-provided Tools / Toolkits candidates. When set (even empty) they\n   * replace the server tool catalog for those categories and join root\n   * search results; omitted, the categories fetch the catalog.\n   */\n  tools?: readonly MentionTool[];\n  /** Categories shown at the top level; hosts can narrow the default set. */\n  rootCategories?: readonly MentionRootCategory[];\n  /**\n   * Why nothing may be asked of Athena right now (`NEEDS_CONNECTION` while\n   * Athena can't be reached), or `null`. Once it clears, the lookups that\n   * failed meanwhile run again.\n   */\n  athenaUnavailable?: LabelCopy | null;\n}): {\n  store: MentionSuggestionsStore;\n  invalidate: (scope: string) => void;\n} {\n  const auth = useMentionAuth();\n  const webpagesRef = useRef(webpages);\n  webpagesRef.current = webpages;\n  const toolsRef = useRef(tools);\n  toolsRef.current = tools;\n  const hasProvidedTools = tools !== undefined;\n  // Read once per store build: a store rebuilt meanwhile starts where the host stands.\n  const athenaUnavailableRef = useRef(athenaUnavailable);\n  athenaUnavailableRef.current = athenaUnavailable;\n\n  // Depend on primitive values to avoid rebuilding store on object identity changes\n  const store = useMemo(\n    () =>\n      buildStore({\n        auth,\n        getWebpages: () => webpagesRef.current,\n        getTools: hasProvidedTools ? () => toolsRef.current ?? [] : undefined,\n        rootCategories,\n        athenaUnavailable: athenaUnavailableRef.current,\n      }),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [\n      auth.backendUrl,\n      auth.accessToken,\n      auth.apiKey,\n      auth.workspaceId,\n      auth.userId,\n      hasProvidedTools,\n      rootCategories.join(\",\"),\n    ],\n  );\n\n  const invalidate = useMemo(\n    () => (scope: string) => {\n      const state = store.state;\n      const { registry, cache } = state;\n\n      // Clear scope from cache\n      if (cache.items) {\n        for (const item of Object.values(cache.items)) {\n          item.visibleInScopes.delete(scope);\n        }\n        // Remove orphaned items\n        for (const [id, item] of Object.entries(cache.items)) {\n          if (item.visibleInScopes.size === 0) {\n            delete cache.items[id];\n          }\n        }\n      }\n\n      // Reset fetch states\n      if (registry.entries[scope]) {\n        registry.entries[scope].fetchStates = {};\n      }\n\n      store.setState((prev) => ({ ...prev }));\n    },\n    [store],\n  );\n\n  // Before the menu's own effects run, so no lookup leaves under a stale answer;\n  // a value that changed nothing keeps the store's state (and its readers) as is.\n  useLayoutEffect(() => {\n    const unavailableBefore = store.state.athenaUnavailable;\n    if (sameReason(unavailableBefore, athenaUnavailable)) return;\n    store.setState((prev) => ({ ...prev, athenaUnavailable }));\n    if (unavailableBefore !== null && athenaUnavailable === null) {\n      retryFailedFetches(store);\n    }\n  }, [athenaUnavailable, store]);\n\n  const webpageFingerprint = webpageMentionFingerprint(webpages);\n  const previousWebpageFingerprintRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    if (previousWebpageFingerprintRef.current === webpageFingerprint) return;\n    previousWebpageFingerprintRef.current = webpageFingerprint;\n    invalidate(\"root\");\n  }, [invalidate, webpageFingerprint]);\n\n  // A changed tool list drops the cached Tools / Toolkits entries (and the\n  // root search results they were folded into) so the next open re-reads it.\n  const toolsFingerprint = tools ? providedToolsFingerprint(tools) : null;\n  const previousToolsFingerprintRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    if (previousToolsFingerprintRef.current === toolsFingerprint) return;\n    previousToolsFingerprintRef.current = toolsFingerprint;\n    if (toolsFingerprint === null) return;\n    invalidate(\"tools\");\n    invalidate(\"toolkits\");\n    invalidate(\"global_search\");\n  }, [invalidate, toolsFingerprint]);\n\n  return { store, invalidate };\n}\n"],"names":["createScopeRegistry","createItemCache","registerSource","transformRootCategories","createTeamLoader","withProvidedTools","fetchGlobalSearch","withTeam","bindScopes","fetchAssets","fetchFavorites","fetchFolders","fetchFolderContents","fetchTypedAssets","transformProvidedTools","fetchTools","fetchToolkits","fetchTeam","fetchDrives","Store","useMentionAuth","useRef","store","useMemo","useLayoutEffect","retryFailedFetches","useEffect"],"mappings":"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"}
+{"version":3,"file":"use-mention-suggestions.cjs","sources":["../../../../../src/chat-ui/mentions/suggestions/data/use-mention-suggestions.ts"],"sourcesContent":["/**\n * Mention Suggestions Store — shared by every Athena chat host (the Chrome\n * side panel, the Office task pane, the SDK's AthenaChat).\n *\n * Full Olympus-style mention store with all categories:\n * Favorites, Assets, Projects, Browse Profiles, Folders,\n * current/group webpages, Team (members, the viewer's people, groups), Agents\n * (the agents a message can name, where the host names agents), Drives +\n * Global Search (assets, plus Team and Agents when offered).\n *\n * Uses registry + cache architecture from Olympus with\n * async data fetching via GraphQL. A host may hand the Tools / Toolkits\n * categories its own list instead of the server catalog (`tools`).\n */\n\nimport type { LabelCopy } from \"@athenaintel/agent-runtime/offline-status\";\nimport { Store } from \"@tanstack/store\";\nimport { useEffect, useLayoutEffect, useMemo, useRef } from \"react\";\nimport type { MentionAuthContext } from \"./api-client\";\nimport { useMentionAuth } from \"./api-client\";\nimport { createItemCache, type ItemCache } from \"./item-cache\";\nimport { retryFailedFetches } from \"./orchestrator\";\nimport {\n  createScopeRegistry,\n  registerSource,\n  bindScopes,\n  type ScopeRegistry,\n} from \"./scope-registry\";\nimport {\n  CHAT_AGENTS_SCOPE,\n  chatAgentFromMenuItem,\n  transformChatAgents,\n  withChatAgents,\n  transformRootCategories,\n  fetchAssets,\n  fetchFavorites,\n  fetchFolders,\n  fetchFolderContents,\n  fetchTypedAssets,\n  fetchTeam,\n  fetchTools,\n  fetchToolkits,\n  fetchDrives,\n  fetchGlobalSearch,\n  transformProvidedTools,\n  withProvidedTools,\n  createTeamLoader,\n  withTeam,\n} from \"./sources\";\nimport type {\n  MentionChatAgent,\n  MentionChatAgents,\n  MentionTool,\n  MenuItem,\n  WebpageMention,\n} from \"./types\";\n\nexport function webpageMentionFingerprint(\n  webpages: readonly WebpageMention[],\n): string {\n  return JSON.stringify(\n    webpages.map(({ tabId, title, url, isCurrent }) => [\n      tabId,\n      title,\n      url,\n      isCurrent,\n    ]),\n  );\n}\n\n// ── Store types ──\n\nexport interface MentionSuggestionsStoreState {\n  registry: ScopeRegistry;\n  cache: ItemCache;\n  /**\n   * Why nothing is asked of Athena right now, or `null` while it answers: the\n   * scopes whose source asks Athena fetch nothing and say this instead, while\n   * the host's own items (its tabs, its tool list) and what was already loaded\n   * still show.\n   */\n  athenaUnavailable: LabelCopy | null;\n}\n\nexport type MentionSuggestionsStore = Store<MentionSuggestionsStoreState> & {\n  /**\n   * Names the agents the `agent` items among `items` stand for (the Agents\n   * section), in order; `false` when there is none or the composer names no\n   * agents (no `chatAgents`), and the text is then left as it was.\n   */\n  nameAgents?: (items: readonly MenuItem[]) => boolean;\n};\n\n// ── Categories ──\n\n/**\n * All mention menu categories, in display order.\n */\nexport const ROOT_MENTION_CATEGORIES = [\n  \"favorites\",\n  \"assets\",\n  \"projects\",\n  \"browse_profiles\",\n  \"folders\",\n  \"tools\",\n  \"toolkits\",\n  \"team\",\n  \"agents\",\n  \"drives\",\n] as const;\n\nexport type MentionRootCategory = (typeof ROOT_MENTION_CATEGORIES)[number];\n\n// ── Store builder ──\n\n/** Stable fingerprint of a host's tool list, for cache invalidation. */\nexport function providedToolsFingerprint(tools: readonly MentionTool[]): string {\n  return JSON.stringify(\n    tools.map(({ id, name, type, description, icon }) => [\n      id,\n      name,\n      type,\n      description ?? null,\n      icon ?? null,\n    ]),\n  );\n}\n\nfunction buildStore({\n  auth,\n  getWebpages,\n  getTools,\n  getChatAgents,\n  getIsAdmin,\n  rootCategories,\n  athenaUnavailable,\n}: {\n  auth: MentionAuthContext;\n  getWebpages: () => readonly WebpageMention[];\n  /** Present when the host supplies the Tools / Toolkits list itself. */\n  getTools?: () => readonly MentionTool[];\n  /** The host's agents to name (`chatAgents`), read when the menu queries and when one is chosen. */\n  getChatAgents: () => MentionChatAgents | undefined;\n  /** Whether the viewer is an Athena admin (the ranked people are an admin's). */\n  getIsAdmin: () => boolean;\n  rootCategories: readonly MentionRootCategory[];\n  athenaUnavailable: LabelCopy | null;\n}): MentionSuggestionsStore {\n  const registry = createScopeRegistry();\n  const cache = createItemCache();\n  const offersAgents = rootCategories.includes(\"agents\");\n  const offeredChatAgents = (): readonly MentionChatAgent[] =>\n    offersAgents ? (getChatAgents()?.getAgents() ?? []) : [];\n\n  // ── Root categories ──\n  registerSource(registry, \"root\", transformRootCategories, {\n    categories: [...rootCategories],\n    getWebpages,\n    getChatAgents: offeredChatAgents,\n  });\n\n  const loadTeam = createTeamLoader(auth, { getIsAdmin });\n\n  // ── Global search (aggregated) ──\n  // A host's own tools ride along so a root query finds them beside assets,\n  // and so do the Team list when the host offers Team and the agents it\n  // offers to name when it offers Agents.\n  const withHostTools = getTools\n    ? withProvidedTools(fetchGlobalSearch, getTools)\n    : fetchGlobalSearch;\n  const withPeople = rootCategories.includes(\"team\")\n    ? withTeam(withHostTools, loadTeam)\n    : withHostTools;\n  registerSource(\n    registry,\n    \"global_search\",\n    offersAgents ? withChatAgents(withPeople, offeredChatAgents) : withPeople,\n    { auth },\n  );\n  bindScopes(registry, \"root\", \"global_search\");\n\n  // ── Assets ──\n  registerSource(registry, \"athena_assets\", fetchAssets, { auth, limit: 50 });\n\n  // ── Favorites ──\n  registerSource(registry, \"favorites\", fetchFavorites, { auth, limit: 50 });\n\n  // ── Folders (flat list) ──\n  registerSource(\n    registry,\n    \"athena_folders\",\n    fetchFolders,\n    { auth, limit: 50 },\n    true /* isFlat */,\n  );\n\n  // ── Internal drive (folder navigation root) ──\n  registerSource(registry, \"internal_drive\", fetchFolderContents, {\n    auth,\n    limit: 50,\n  });\n\n  // ── Projects ──\n  registerSource(registry, \"athena_projects\", fetchTypedAssets, {\n    auth,\n    includeOnlyTypes: [\"project\"],\n    limit: 50,\n  });\n\n  // ── Browse Profiles ──\n  registerSource(registry, \"athena_browse_profiles\", fetchTypedAssets, {\n    auth,\n    includeOnlyTypes: [\"browse_profile\"],\n    limit: 50,\n  });\n\n  // ── Tools & Toolkits ── the server catalog, or the host's own list\n  if (getTools) {\n    registerSource(registry, \"tools\", transformProvidedTools, {\n      getTools,\n      type: \"tool\",\n    });\n    registerSource(registry, \"toolkits\", transformProvidedTools, {\n      getTools,\n      type: \"toolkit\",\n    });\n  } else {\n    registerSource(registry, \"tools\", fetchTools, { auth });\n    registerSource(registry, \"toolkits\", fetchToolkits, { auth });\n  }\n\n  // ── Team ──\n  registerSource(registry, \"team\", fetchTeam, { auth, loadTeam });\n\n  // ── Agents ── the agents a message can name, where the host names agents\n  if (offersAgents) {\n    registerSource(registry, CHAT_AGENTS_SCOPE, transformChatAgents, {\n      getAgents: offeredChatAgents,\n    });\n  }\n\n  // ── Drives (catalogs) ──\n  registerSource(registry, \"drive_catalogs\", fetchDrives, { auth });\n\n  const store: MentionSuggestionsStore = new Store<MentionSuggestionsStoreState>({\n    registry,\n    cache,\n    athenaUnavailable,\n  });\n  store.nameAgents = (items) => {\n    const host = offersAgents ? getChatAgents() : undefined;\n    const agents = items.flatMap((item) => chatAgentFromMenuItem(item) ?? []);\n    if (!host || agents.length === 0) return false;\n    host.nameAgents(agents);\n    return true;\n  };\n  return store;\n}\n\n/** Two reasons say the same thing (a host may hand a new object with the same words). */\nfunction sameReason(a: LabelCopy | null, b: LabelCopy | null): boolean {\n  if (a === null || b === null) return a === b;\n  return a.label === b.label && a.detail === b.detail;\n}\n\n// ── Hook ──\n\n/**\n * Creates a stable MentionSuggestionsStore.\n * Uses MentionAuthCtx for API credentials.\n */\nexport function useMentionSuggestions({\n  webpages,\n  tools,\n  rootCategories = ROOT_MENTION_CATEGORIES,\n  athenaUnavailable = null,\n  chatAgents,\n  viewerIsAdmin = false,\n}: {\n  webpages: readonly WebpageMention[];\n  /**\n   * Host-provided Tools / Toolkits candidates. When set (even empty) they\n   * replace the server tool catalog for those categories and join root\n   * search results; omitted, the categories fetch the catalog.\n   */\n  tools?: readonly MentionTool[];\n  /** Categories shown at the top level; hosts can narrow the default set. */\n  rootCategories?: readonly MentionRootCategory[];\n  /**\n   * Why nothing may be asked of Athena right now (`NEEDS_CONNECTION` while\n   * Athena can't be reached), or `null`. Once it clears, the lookups that\n   * failed meanwhile run again.\n   */\n  athenaUnavailable?: LabelCopy | null;\n  /**\n   * The agents this composer's messages can name (identity v7 D13), for the\n   * Agents category: what it offers, naming what is chosen. Without it the\n   * category shows nothing.\n   */\n  chatAgents?: MentionChatAgents;\n  /**\n   * Whether the viewer is an Athena admin: Team ranks an admin's people (the\n   * people they talked to most recently first, with the people they saved),\n   * as Olympus does while Person is in preview.\n   */\n  viewerIsAdmin?: boolean;\n}): {\n  store: MentionSuggestionsStore;\n  invalidate: (scope: string) => void;\n} {\n  const auth = useMentionAuth();\n  const webpagesRef = useRef(webpages);\n  webpagesRef.current = webpages;\n  const toolsRef = useRef(tools);\n  toolsRef.current = tools;\n  const hasProvidedTools = tools !== undefined;\n  // Read at query and selection time: the store is built once per credential.\n  const chatAgentsRef = useRef(chatAgents);\n  chatAgentsRef.current = chatAgents;\n  const viewerIsAdminRef = useRef(viewerIsAdmin);\n  viewerIsAdminRef.current = viewerIsAdmin;\n  // Read once per store build: a store rebuilt meanwhile starts where the host stands.\n  const athenaUnavailableRef = useRef(athenaUnavailable);\n  athenaUnavailableRef.current = athenaUnavailable;\n\n  // Depend on primitive values to avoid rebuilding store on object identity changes\n  const store = useMemo(\n    () =>\n      buildStore({\n        auth,\n        getWebpages: () => webpagesRef.current,\n        getTools: hasProvidedTools ? () => toolsRef.current ?? [] : undefined,\n        getChatAgents: () => chatAgentsRef.current,\n        getIsAdmin: () => viewerIsAdminRef.current,\n        rootCategories,\n        athenaUnavailable: athenaUnavailableRef.current,\n      }),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [\n      auth.backendUrl,\n      auth.accessToken,\n      auth.apiKey,\n      auth.workspaceId,\n      auth.userId,\n      hasProvidedTools,\n      rootCategories.join(\",\"),\n    ],\n  );\n\n  const invalidate = useMemo(\n    () => (scope: string) => {\n      const state = store.state;\n      const { registry, cache } = state;\n\n      // Clear scope from cache\n      if (cache.items) {\n        for (const item of Object.values(cache.items)) {\n          item.visibleInScopes.delete(scope);\n        }\n        // Remove orphaned items\n        for (const [id, item] of Object.entries(cache.items)) {\n          if (item.visibleInScopes.size === 0) {\n            delete cache.items[id];\n          }\n        }\n      }\n\n      // Reset fetch states\n      if (registry.entries[scope]) {\n        registry.entries[scope].fetchStates = {};\n      }\n\n      store.setState((prev) => ({ ...prev }));\n    },\n    [store],\n  );\n\n  // Before the menu's own effects run, so no lookup leaves under a stale answer;\n  // a value that changed nothing keeps the store's state (and its readers) as is.\n  useLayoutEffect(() => {\n    const unavailableBefore = store.state.athenaUnavailable;\n    if (sameReason(unavailableBefore, athenaUnavailable)) return;\n    store.setState((prev) => ({ ...prev, athenaUnavailable }));\n    if (unavailableBefore !== null && athenaUnavailable === null) {\n      retryFailedFetches(store);\n    }\n  }, [athenaUnavailable, store]);\n\n  const webpageFingerprint = webpageMentionFingerprint(webpages);\n  const previousWebpageFingerprintRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    if (previousWebpageFingerprintRef.current === webpageFingerprint) return;\n    previousWebpageFingerprintRef.current = webpageFingerprint;\n    invalidate(\"root\");\n  }, [invalidate, webpageFingerprint]);\n\n  // A changed tool list drops the cached Tools / Toolkits entries (and the\n  // root search results they were folded into) so the next open re-reads it.\n  const toolsFingerprint = tools ? providedToolsFingerprint(tools) : null;\n  const previousToolsFingerprintRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    if (previousToolsFingerprintRef.current === toolsFingerprint) return;\n    previousToolsFingerprintRef.current = toolsFingerprint;\n    if (toolsFingerprint === null) return;\n    invalidate(\"tools\");\n    invalidate(\"toolkits\");\n    invalidate(\"global_search\");\n  }, [invalidate, toolsFingerprint]);\n\n  // What the Agents section offers moves with the host (an agent named or\n  // removed, the agent list loading): refresh the section, the root (it hides\n  // once nothing is left to name) and the cached search, which embeds it.\n  const offersAgents = rootCategories.includes(\"agents\");\n  useEffect(() => {\n    if (!offersAgents || !chatAgents) return;\n    const refresh = (): void => {\n      invalidate(CHAT_AGENTS_SCOPE);\n      invalidate(\"root\");\n      invalidate(\"global_search\");\n    };\n    refresh();\n    return chatAgents.subscribe(refresh);\n  }, [chatAgents, invalidate, offersAgents]);\n\n  // An admin answer that arrived (or changed) re-reads Team: an admin's is ranked by their people.\n  const offersTeam = rootCategories.includes(\"team\");\n  const previousViewerIsAdminRef = useRef(viewerIsAdmin);\n  useEffect(() => {\n    if (previousViewerIsAdminRef.current === viewerIsAdmin) return;\n    previousViewerIsAdminRef.current = viewerIsAdmin;\n    if (!offersTeam) return;\n    invalidate(\"team\");\n    invalidate(\"global_search\");\n  }, [invalidate, offersTeam, viewerIsAdmin]);\n\n  return { store, invalidate };\n}\n"],"names":["createScopeRegistry","createItemCache","registerSource","transformRootCategories","createTeamLoader","withProvidedTools","fetchGlobalSearch","withTeam","withChatAgents","bindScopes","fetchAssets","fetchFavorites","fetchFolders","fetchFolderContents","fetchTypedAssets","transformProvidedTools","fetchTools","fetchToolkits","fetchTeam","CHAT_AGENTS_SCOPE","transformChatAgents","fetchDrives","store","Store","chatAgentFromMenuItem","useMentionAuth","useRef","useMemo","useLayoutEffect","retryFailedFetches","useEffect"],"mappings":"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"}

package/dist/chat-ui/mentions/suggestions/data/use-mention-suggestions.d.ts

@@ -4,8 +4,9 @@
  *
  * Full Olympus-style mention store with all categories:
  * Favorites, Assets, Projects, Browse Profiles, Folders,
- * current/group webpages, Team, Workspace, Drives + Global Search (assets,
- * plus workspace members when Team is offered).
+ * current/group webpages, Team (members, the viewer's people, groups), Agents
+ * (the agents a message can name, where the host names agents), Drives +
+ * Global Search (assets, plus Team and Agents when offered).
  *
  * Uses registry + cache architecture from Olympus with
  * async data fetching via GraphQL. A host may hand the Tools / Toolkits
@@ -15,7 +16,7 @@ import type { LabelCopy } from "../../../../agent-runtime/src/offline-status";
 import { Store } from "@tanstack/store";
 import { type ItemCache } from "./item-cache";
 import { type ScopeRegistry } from "./scope-registry";
-import type { MentionTool, WebpageMention } from "./types";
+import type { MentionChatAgents, MentionTool, MenuItem, WebpageMention } from "./types";
 export declare function webpageMentionFingerprint(webpages: readonly WebpageMention[]): string;
 export interface MentionSuggestionsStoreState {
     registry: ScopeRegistry;
@@ -28,11 +29,18 @@ export interface MentionSuggestionsStoreState {
      */
     athenaUnavailable: LabelCopy | null;
 }
-export type MentionSuggestionsStore = Store<MentionSuggestionsStoreState>;
+export type MentionSuggestionsStore = Store<MentionSuggestionsStoreState> & {
+    /**
+     * Names the agents the `agent` items among `items` stand for (the Agents
+     * section), in order; `false` when there is none or the composer names no
+     * agents (no `chatAgents`), and the text is then left as it was.
+     */
+    nameAgents?: (items: readonly MenuItem[]) => boolean;
+};
 /**
  * All mention menu categories, in display order.
  */
-export declare const ROOT_MENTION_CATEGORIES: readonly ["favorites", "assets", "projects", "browse_profiles", "folders", "tools", "toolkits", "team", "drives"];
+export declare const ROOT_MENTION_CATEGORIES: readonly ["favorites", "assets", "projects", "browse_profiles", "folders", "tools", "toolkits", "team", "agents", "drives"];
 export type MentionRootCategory = (typeof ROOT_MENTION_CATEGORIES)[number];
 /** Stable fingerprint of a host's tool list, for cache invalidation. */
 export declare function providedToolsFingerprint(tools: readonly MentionTool[]): string;
@@ -40,7 +48,7 @@ export declare function providedToolsFingerprint(tools: readonly MentionTool[]):
  * Creates a stable MentionSuggestionsStore.
  * Uses MentionAuthCtx for API credentials.
  */
-export declare function useMentionSuggestions({ webpages, tools, rootCategories, athenaUnavailable, }: {
+export declare function useMentionSuggestions({ webpages, tools, rootCategories, athenaUnavailable, chatAgents, viewerIsAdmin, }: {
     webpages: readonly WebpageMention[];
     /**
      * Host-provided Tools / Toolkits candidates. When set (even empty) they
@@ -56,6 +64,18 @@ export declare function useMentionSuggestions({ webpages, tools, rootCategories,
      * failed meanwhile run again.
      */
     athenaUnavailable?: LabelCopy | null;
+    /**
+     * The agents this composer's messages can name (identity v7 D13), for the
+     * Agents category: what it offers, naming what is chosen. Without it the
+     * category shows nothing.
+     */
+    chatAgents?: MentionChatAgents;
+    /**
+     * Whether the viewer is an Athena admin: Team ranks an admin's people (the
+     * people they talked to most recently first, with the people they saved),
+     * as Olympus does while Person is in preview.
+     */
+    viewerIsAdmin?: boolean;
 }): {
     store: MentionSuggestionsStore;
     invalidate: (scope: string) => void;

package/dist/chat-ui/mentions/suggestions/data/use-mention-suggestions.js

@@ -4,7 +4,7 @@ import { useMentionAuth } from "./api-client.js";
 import { createItemCache } from "./item-cache.js";
 import { retryFailedFetches } from "./orchestrator.js";
 import { registerSource, bindScopes, createScopeRegistry } from "./scope-registry.js";
-import { transformRootCategories, withProvidedTools, fetchGlobalSearch, withTeam, fetchAssets, fetchFavorites, fetchFolders, fetchFolderContents, fetchTypedAssets, transformProvidedTools, fetchTools, fetchToolkits, fetchTeam, fetchDrives, createTeamLoader } from "./sources/index.js";
+import { transformRootCategories, withProvidedTools, fetchGlobalSearch, withTeam, withChatAgents, chatAgentFromMenuItem, CHAT_AGENTS_SCOPE, fetchAssets, fetchFavorites, fetchFolders, fetchFolderContents, fetchTypedAssets, transformProvidedTools, fetchTools, fetchToolkits, fetchTeam, transformChatAgents, fetchDrives, createTeamLoader } from "./sources/index.js";
 function webpageMentionFingerprint(webpages) {
   return JSON.stringify(
     webpages.map(({ tabId, title, url, isCurrent }) => [
@@ -24,6 +24,7 @@ const ROOT_MENTION_CATEGORIES = [
   "tools",
   "toolkits",
   "team",
+  "agents",
   "drives"
 ];
 function providedToolsFingerprint(tools) {
@@ -41,21 +42,30 @@ function buildStore({
   auth,
   getWebpages,
   getTools,
+  getChatAgents,
+  getIsAdmin,
   rootCategories,
   athenaUnavailable
 }) {
   const registry = createScopeRegistry();
   const cache = createItemCache();
+  const offersAgents = rootCategories.includes("agents");
+  const offeredChatAgents = () => {
+    var _a;
+    return offersAgents ? ((_a = getChatAgents()) == null ? void 0 : _a.getAgents()) ?? [] : [];
+  };
   registerSource(registry, "root", transformRootCategories, {
     categories: [...rootCategories],
-    getWebpages
+    getWebpages,
+    getChatAgents: offeredChatAgents
   });
-  const loadTeam = createTeamLoader(auth);
+  const loadTeam = createTeamLoader(auth, { getIsAdmin });
   const withHostTools = getTools ? withProvidedTools(fetchGlobalSearch, getTools) : fetchGlobalSearch;
+  const withPeople = rootCategories.includes("team") ? withTeam(withHostTools, loadTeam) : withHostTools;
   registerSource(
     registry,
     "global_search",
-    rootCategories.includes("team") ? withTeam(withHostTools, loadTeam) : withHostTools,
+    offersAgents ? withChatAgents(withPeople, offeredChatAgents) : withPeople,
     { auth }
   );
   bindScopes(registry, "root", "global_search");
@@ -96,12 +106,25 @@ function buildStore({
     registerSource(registry, "toolkits", fetchToolkits, { auth });
   }
   registerSource(registry, "team", fetchTeam, { auth, loadTeam });
+  if (offersAgents) {
+    registerSource(registry, CHAT_AGENTS_SCOPE, transformChatAgents, {
+      getAgents: offeredChatAgents
+    });
+  }
   registerSource(registry, "drive_catalogs", fetchDrives, { auth });
-  return new Store({
+  const store = new Store({
     registry,
     cache,
     athenaUnavailable
   });
+  store.nameAgents = (items) => {
+    const host = offersAgents ? getChatAgents() : void 0;
+    const agents = items.flatMap((item) => chatAgentFromMenuItem(item) ?? []);
+    if (!host || agents.length === 0) return false;
+    host.nameAgents(agents);
+    return true;
+  };
+  return store;
 }
 function sameReason(a, b) {
   if (a === null || b === null) return a === b;
@@ -111,7 +134,9 @@ function useMentionSuggestions({
   webpages,
   tools,
   rootCategories = ROOT_MENTION_CATEGORIES,
-  athenaUnavailable = null
+  athenaUnavailable = null,
+  chatAgents,
+  viewerIsAdmin = false
 }) {
   const auth = useMentionAuth();
   const webpagesRef = useRef(webpages);
@@ -119,6 +144,10 @@ function useMentionSuggestions({
   const toolsRef = useRef(tools);
   toolsRef.current = tools;
   const hasProvidedTools = tools !== void 0;
+  const chatAgentsRef = useRef(chatAgents);
+  chatAgentsRef.current = chatAgents;
+  const viewerIsAdminRef = useRef(viewerIsAdmin);
+  viewerIsAdminRef.current = viewerIsAdmin;
   const athenaUnavailableRef = useRef(athenaUnavailable);
   athenaUnavailableRef.current = athenaUnavailable;
   const store = useMemo(
@@ -126,6 +155,8 @@ function useMentionSuggestions({
       auth,
       getWebpages: () => webpagesRef.current,
       getTools: hasProvidedTools ? () => toolsRef.current ?? [] : void 0,
+      getChatAgents: () => chatAgentsRef.current,
+      getIsAdmin: () => viewerIsAdminRef.current,
       rootCategories,
       athenaUnavailable: athenaUnavailableRef.current
     }),
@@ -186,6 +217,26 @@ function useMentionSuggestions({
     invalidate("toolkits");
     invalidate("global_search");
   }, [invalidate, toolsFingerprint]);
+  const offersAgents = rootCategories.includes("agents");
+  useEffect(() => {
+    if (!offersAgents || !chatAgents) return;
+    const refresh = () => {
+      invalidate(CHAT_AGENTS_SCOPE);
+      invalidate("root");
+      invalidate("global_search");
+    };
+    refresh();
+    return chatAgents.subscribe(refresh);
+  }, [chatAgents, invalidate, offersAgents]);
+  const offersTeam = rootCategories.includes("team");
+  const previousViewerIsAdminRef = useRef(viewerIsAdmin);
+  useEffect(() => {
+    if (previousViewerIsAdminRef.current === viewerIsAdmin) return;
+    previousViewerIsAdminRef.current = viewerIsAdmin;
+    if (!offersTeam) return;
+    invalidate("team");
+    invalidate("global_search");
+  }, [invalidate, offersTeam, viewerIsAdmin]);
   return { store, invalidate };
 }
 export {