@athenaintel/react 0.18.0 → 0.20.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../../../../src/chat-ui/mentions/suggestions/data/sources/index.ts"],"sourcesContent":["/**\n * Mention data sources shared by every chat host.\n *\n * Each source function implements the SourceFn interface:\n *   (context: SourceContext) => Promise<SourceResult>\n *\n * Sources are either:\n * - FETCHERS: Call GraphQL API (assets, folders, team, etc.)\n * - TRANSFORMERS: Return static/local data (root categories, host-provided items)\n */\n\nimport type {\n  MenuItem,\n  MentionTool,\n  SourceFn,\n  SourceResult,\n  SourceToRegister,\n  FetchMetadata,\n  WebpageMention,\n} from \"../types\";\nimport { MentionMenuSection } from \"../types\";\nimport {\n  fetchGraphQL,\n  SIMPLE_SEARCH_QUERY,\n  PAGINATED_ASSETS_QUERY,\n  WORKSPACE_MEMBERS_QUERY,\n  TOOL_CATALOG_QUERY,\n  type MentionAuthContext,\n  type AssetResult,\n  type WorkspaceMember,\n  type ToolCatalogResult,\n} from \"../api-client\";\nimport { assetTypeToThumb, assetTypeToIcon } from \"./asset-type-icons\";\n\n// ── Helpers ──\n\nfunction assetToMenuItem(asset: AssetResult): MenuItem {\n  const isFolder = asset.athenaOriginalType === \"folder\";\n  const displayType = asset.athenaConvertedType || asset.athenaOriginalType;\n  return {\n    id: asset.id,\n    name: asset.title || \"Untitled\",\n    type: isFolder ? \"folder\" : \"asset\",\n    thumbnailUrl: assetTypeToThumb(displayType),\n    fallbackIcon: assetTypeToIcon(displayType),\n    navigatesToScope: isFolder ? asset.id : undefined,\n    visibleInScopes: new Set(),\n    updatedAt: asset.updatedAt ?? undefined,\n    extra: {\n      athenaOriginalType: asset.athenaOriginalType,\n      athenaConvertedType: asset.athenaConvertedType,\n      parentFolderId: asset.parentFolderId,\n    },\n  };\n}\n\nasync function querySimpleSearch(\n  auth: MentionAuthContext,\n  opts: {\n    query?: string;\n    limit: number;\n    offset: number;\n    includeTypes?: string[];\n    excludeTypes?: string[];\n  },\n): Promise<{ items: MenuItem[]; hasMore: boolean }> {\n  const searchRequest: Record<string, any> = {\n    query: opts.query?.trim() || \"\",\n    type: opts.includeTypes || [],\n    notType: opts.excludeTypes || [],\n    limit: opts.limit,\n    offset: opts.offset,\n  };\n\n  const input = {\n    searchRequest,\n    returnFullAsset: true,\n    shouldCalculateTotal: false,\n    sort: { field: \"UPDATED_AT\", direction: \"DESC\" },\n    filterColumns: { isArchived: false, isHidden: false },\n  };\n\n  const data = await fetchGraphQL<{\n    simpleSearch: { assets: AssetResult[]; totalCount: number };\n  }>(auth, SIMPLE_SEARCH_QUERY, { input });\n\n  const assets = data.simpleSearch?.assets || [];\n  return {\n    items: assets.map(assetToMenuItem),\n    hasMore: assets.length === opts.limit,\n  };\n}\n\n// ══════════════════════════════════════════════════════════════════════\n// ROOT CATEGORIES (Transformer)\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface RootCategoriesConfig {\n  categories: string[];\n  getWebpages: () => readonly WebpageMention[];\n}\n\nconst CATEGORY_DEFS: Record<\n  string,\n  { name: string; icon: string; scope: string }\n> = {\n  favorites: { name: \"Favorites\", icon: \"star\", scope: \"favorites\" },\n  assets: { name: \"Assets\", icon: \"file-text\", scope: \"athena_assets\" },\n  projects: {\n    name: \"Projects\",\n    icon: \"folder-kanban\",\n    scope: \"athena_projects\",\n  },\n  browse_profiles: {\n    name: \"Browse Profiles\",\n    icon: \"globe\",\n    scope: \"athena_browse_profiles\",\n  },\n  folders: { name: \"Folders\", icon: \"folder\", scope: \"athena_folders\" },\n  tools: { name: \"Tools\", icon: \"wrench\", scope: \"tools\" },\n  toolkits: { name: \"Toolkits\", icon: \"package\", scope: \"toolkits\" },\n  team: { name: \"Team\", icon: \"users\", scope: \"team\" },\n  drives: { name: \"Drives\", icon: \"hard-drive\", scope: \"drive_catalogs\" },\n};\n\nfunction webpageDescription(webpage: WebpageMention): string {\n  try {\n    const hostname = new URL(webpage.url).hostname;\n    return webpage.isCurrent ? `${webpage.title} · ${hostname}` : hostname;\n  } catch {\n    return webpage.title;\n  }\n}\n\nfunction webpageToMenuItem(webpage: WebpageMention): MenuItem {\n  return {\n    id: `webpage-tab-${webpage.tabId}`,\n    name: webpage.isCurrent ? \"This webpage\" : webpage.title,\n    type: \"tab\",\n    thumbnailUrl: assetTypeToThumb(\"web_page\"),\n    fallbackIcon: \"globe\",\n    visibleInScopes: new Set([\"root\"]),\n    description: webpageDescription(webpage),\n    url: webpage.url,\n    menuSection: webpage.isCurrent\n      ? MentionMenuSection.CURRENT_WEBPAGE\n      : MentionMenuSection.OTHER_WEBPAGES,\n    extra: {\n      tabId: webpage.tabId,\n      title: webpage.title,\n      isCurrent: webpage.isCurrent,\n    },\n  };\n}\n\nexport function buildRootMenuItems({\n  categories,\n  webpages,\n}: {\n  categories: readonly string[];\n  webpages: readonly WebpageMention[];\n}): MenuItem[] {\n  const webpageItems = webpages.map(webpageToMenuItem);\n  const categoryItems = categories\n    .filter((cat: string) => CATEGORY_DEFS[cat])\n    .map((cat: string) => {\n      const def = CATEGORY_DEFS[cat];\n      return {\n        id: cat,\n        name: def.name,\n        type: \"menu\" as const,\n        fallbackIcon: def.icon,\n        visibleInScopes: new Set([\"root\"]),\n        navigatesToScope: def.scope,\n        isNavigationOnly: true,\n        menuSection: MentionMenuSection.LIBRARY,\n      };\n    });\n\n  return [...webpageItems, ...categoryItems];\n}\n\nexport const transformRootCategories: SourceFn<RootCategoriesConfig> = async (\n  context,\n) => {\n  const { sourceConfig } = context;\n  const items = buildRootMenuItems({\n    categories: sourceConfig.categories,\n    webpages: sourceConfig.getWebpages(),\n  });\n\n  return { items, pagination: { hasMore: false } };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// ASSETS (Fetcher) — All non-folder assets via SimpleSearch\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface AssetsConfig {\n  auth: MentionAuthContext;\n  limit?: number;\n}\n\nexport const fetchAssets: SourceFn<AssetsConfig> = async (context) => {\n  const { query, fetchState, sourceConfig } = context;\n  const limit = sourceConfig.limit ?? 50;\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  const offset = meta.validatedCount || 0;\n\n  const result = await querySimpleSearch(sourceConfig.auth, {\n    query,\n    limit,\n    offset,\n    excludeTypes: [\n      \"folder\",\n      \"catalog\",\n      \"spaces\",\n      \"session\",\n      \"table\",\n      \"task_item\",\n    ],\n  });\n\n  return {\n    items: result.items,\n    pagination: { hasMore: result.hasMore },\n  };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// FAVORITES (Fetcher) — Favorited assets\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface FavoritesConfig {\n  auth: MentionAuthContext;\n  limit?: number;\n}\n\nexport const fetchFavorites: SourceFn<FavoritesConfig> = async (context) => {\n  const { query, fetchState, sourceConfig } = context;\n  const limit = sourceConfig.limit ?? 50;\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  const offset = meta.validatedCount || 0;\n\n  const data = await fetchGraphQL<{\n    getPaginatedAssetsForWorkspace: AssetResult[];\n  }>(sourceConfig.auth, PAGINATED_ASSETS_QUERY, {\n    limit,\n    offset,\n    parentFolderId: null,\n    filterTypes: null,\n    filterColumns: {\n      isFavorited: true,\n      isArchived: false,\n      isHidden: false,\n    },\n  });\n\n  const assets = data.getPaginatedAssetsForWorkspace || [];\n  const items = assets.map(assetToMenuItem);\n\n  return {\n    items,\n    pagination: { hasMore: assets.length === limit },\n  };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// FOLDERS (Fetcher) — All folders as flat list\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface FoldersConfig {\n  auth: MentionAuthContext;\n  limit?: number;\n}\n\nexport const fetchFolders: SourceFn<FoldersConfig> = async (context) => {\n  const { query, fetchState, sourceConfig } = context;\n  const limit = sourceConfig.limit ?? 50;\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  const offset = meta.validatedCount || 0;\n\n  const result = await querySimpleSearch(sourceConfig.auth, {\n    query,\n    limit,\n    offset,\n    includeTypes: [\"folder\"],\n  });\n\n  return {\n    items: result.items,\n    pagination: { hasMore: result.hasMore },\n  };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// FOLDER CONTENTS (Fetcher) — Contents of a specific folder\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface FolderContentsConfig {\n  auth: MentionAuthContext;\n  limit?: number;\n}\n\nexport const fetchFolderContents: SourceFn<FolderContentsConfig> = async (\n  context,\n) => {\n  const { scope, query, fetchState, sourceConfig } = context;\n  const limit = sourceConfig.limit ?? 50;\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  const offset = meta.validatedCount || 0;\n\n  // Scope IS the folder ID (or 'internal_drive' for root)\n  const parentFolderId = scope === \"internal_drive\" ? null : scope;\n\n  const data = await fetchGraphQL<{\n    getPaginatedAssetsForWorkspace: AssetResult[];\n  }>(sourceConfig.auth, PAGINATED_ASSETS_QUERY, {\n    limit,\n    offset,\n    parentFolderId,\n    filterTypes: null,\n    filterColumns: {\n      isArchived: false,\n      isHidden: false,\n      ...(query ? { title: [{ op: \"LIKE\", value: `%${query}%` }] } : {}),\n    },\n  });\n\n  const rawAssets = data.getPaginatedAssetsForWorkspace || [];\n  // Exclude catalogs from folder contents\n  const assets = rawAssets.filter(\n    (a) =>\n      a.athenaConvertedType !== \"catalog\" && a.athenaOriginalType !== \"catalog\",\n  );\n  const items = assets.map(assetToMenuItem);\n\n  return {\n    items,\n    pagination: {\n      hasMore: rawAssets.length === limit,\n      consumedCount: rawAssets.length,\n    },\n  };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// PROJECTS (Fetcher) — Project assets\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface TypedAssetsConfig {\n  auth: MentionAuthContext;\n  includeOnlyTypes: string[];\n  limit?: number;\n}\n\nexport const fetchTypedAssets: SourceFn<TypedAssetsConfig> = async (\n  context,\n) => {\n  const { query, fetchState, sourceConfig } = context;\n  const limit = sourceConfig.limit ?? 50;\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  const offset = meta.validatedCount || 0;\n\n  const result = await querySimpleSearch(sourceConfig.auth, {\n    query,\n    limit,\n    offset,\n    includeTypes: sourceConfig.includeOnlyTypes,\n  });\n\n  return {\n    items: result.items,\n    pagination: { hasMore: result.hasMore },\n  };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// TEAM (Fetcher) — Workspace members\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface TeamConfig {\n  auth: MentionAuthContext;\n}\n\nexport const fetchTeam: SourceFn<TeamConfig> = async (context) => {\n  const { sourceConfig } = context;\n  const { auth } = sourceConfig;\n\n  if (!auth.workspaceId) {\n    return { items: [], pagination: { hasMore: false } };\n  }\n\n  const data = await fetchGraphQL<{ getUsersInWorkspace: WorkspaceMember[] }>(\n    auth,\n    WORKSPACE_MEMBERS_QUERY,\n    { workspaceId: auth.workspaceId },\n  );\n\n  const members = data.getUsersInWorkspace || [];\n  const items: MenuItem[] = members.map((member) => {\n    const displayName =\n      [member.firstName, member.lastName].filter(Boolean).join(\" \").trim() ||\n      member.email ||\n      \"Unknown User\";\n\n    return {\n      id: member.email || member.id,\n      name: displayName,\n      type: \"user\" as const,\n      fallbackIcon: \"user\",\n      visibleInScopes: new Set<string>(),\n      email: member.email ?? undefined,\n      extra: { isAdmin: member.isAdmin },\n    };\n  });\n\n  return { items, pagination: { hasMore: false } };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// TOOLS / TOOLKITS (Fetcher) — Mentionable tool catalog\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface ToolCatalogConfig {\n  auth: MentionAuthContext;\n}\n\n// getToolkitToToolsMapping is already filtered server-side for the\n// authenticated user (admin-only entries, beta allowlist, workspace registry),\n// so only mention/menu visibility is applied here.\nasync function queryToolCatalog(\n  auth: MentionAuthContext,\n): Promise<ToolCatalogResult[\"getToolkitToToolsMapping\"]> {\n  const data = await fetchGraphQL<ToolCatalogResult>(auth, TOOL_CATALOG_QUERY);\n  return data.getToolkitToToolsMapping;\n}\n\nexport const fetchTools: SourceFn<ToolCatalogConfig> = async (context) => {\n  const catalog = await queryToolCatalog(context.sourceConfig.auth);\n\n  const items: MenuItem[] = catalog.tools\n    .filter((tool) => tool.isMentionable)\n    .map((tool) => ({\n      id: tool.id,\n      name: tool.name,\n      type: \"tool\" as const,\n      fallbackIcon: tool.icon,\n      description: tool.description ?? undefined,\n      visibleInScopes: new Set<string>(),\n      ...(tool.adminOnly ? { extra: { isAdminOnly: true } } : {}),\n    }));\n\n  return { items, pagination: { hasMore: false } };\n};\n\nexport const fetchToolkits: SourceFn<ToolCatalogConfig> = async (context) => {\n  const catalog = await queryToolCatalog(context.sourceConfig.auth);\n\n  const items: MenuItem[] = catalog.toolkits\n    .filter((toolkit) => toolkit.isMentionable && !toolkit.hideFromMenu)\n    .map((toolkit) => ({\n      id: toolkit.name,\n      name: toolkit.displayName,\n      type: \"toolkit\" as const,\n      fallbackIcon: toolkit.icon,\n      description: toolkit.description || undefined,\n      visibleInScopes: new Set<string>(),\n      ...(toolkit.onlyAdmin ? { extra: { isAdminOnly: true } } : {}),\n    }));\n\n  return { items, pagination: { hasMore: false } };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// DRIVES (Fetcher) — Drive catalog assets\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface DrivesConfig {\n  auth: MentionAuthContext;\n}\n\nexport const fetchDrives: SourceFn<DrivesConfig> = async (context) => {\n  const { fetchState, sourceConfig } = context;\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  const offset = meta.validatedCount || 0;\n\n  const result = await querySimpleSearch(sourceConfig.auth, {\n    limit: 50,\n    offset,\n    includeTypes: [\"catalog\"],\n  });\n\n  // Drive catalogs are navigation-only (navigate into them to see contents)\n  const items: MenuItem[] = result.items.map((item) => ({\n    ...item,\n    type: \"drive_catalog\" as const,\n    fallbackIcon: \"hard-drive\",\n    isNavigationOnly: true,\n    navigatesToScope: item.id,\n  }));\n\n  // Register folder contents source for each catalog\n  const sources: SourceToRegister[] = items.map((item) => ({\n    scope: item.id,\n    sourceFn: fetchFolderContents,\n    sourceConfig: { auth: sourceConfig.auth, limit: 50 },\n  }));\n\n  return {\n    items,\n    pagination: { hasMore: result.hasMore },\n    sources,\n  };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// GLOBAL SEARCH (Fetcher) — Aggregated search across all sources\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface GlobalSearchConfig {\n  auth: MentionAuthContext;\n}\n\nexport const fetchGlobalSearch: SourceFn<GlobalSearchConfig> = async (\n  context,\n) => {\n  const { query, fetchState, sourceConfig } = context;\n  if (!query?.trim()) return { items: [], pagination: { hasMore: false } };\n\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  const offset = meta.validatedCount || 0;\n\n  const result = await querySimpleSearch(sourceConfig.auth, {\n    query,\n    limit: 50,\n    offset,\n    excludeTypes: [\"table\", \"catalog\", \"spaces\", \"task_item\", \"session\"],\n  });\n\n  return {\n    items: result.items,\n    pagination: { hasMore: result.hasMore },\n  };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// HOST-PROVIDED TOOLS (Transformer) — a host's own Tools / Toolkits list\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface ProvidedToolsConfig {\n  getTools: () => readonly MentionTool[];\n  type: MentionTool[\"type\"];\n}\n\n/** Menu items for a host-provided tool list, in the host's order. */\nexport function providedToolMenuItems(\n  tools: readonly MentionTool[],\n  type?: MentionTool[\"type\"],\n): MenuItem[] {\n  return tools\n    .filter((tool) => type === undefined || tool.type === type)\n    .map((tool) => ({\n      id: tool.id,\n      name: tool.name,\n      type: tool.type,\n      fallbackIcon: tool.icon ?? (tool.type === \"toolkit\" ? \"Package\" : \"Wrench\"),\n      description: tool.description,\n      visibleInScopes: new Set<string>(),\n    }));\n}\n\nexport const transformProvidedTools: SourceFn<ProvidedToolsConfig> = async (\n  context,\n) => ({\n  items: providedToolMenuItems(\n    context.sourceConfig.getTools(),\n    context.sourceConfig.type,\n  ),\n  pagination: { hasMore: false },\n});\n\n/**\n * Prepend a host's tool list to another source's items so a root query matches\n * them the way it matches assets (the cache filters by query and sorts\n * toolkits first). The wrapped source's offset bookkeeping is preserved:\n * `consumedCount` stays the number of rows the server returned, so the added\n * items never advance the next page's offset.\n */\nexport function withProvidedTools<TConfig>(\n  source: SourceFn<TConfig>,\n  getTools: () => readonly MentionTool[],\n): SourceFn<TConfig> {\n  return async (context) => {\n    const result = await source(context);\n    return {\n      ...result,\n      items: [...providedToolMenuItems(getTools()), ...result.items],\n      pagination: {\n        ...result.pagination,\n        hasMore: result.pagination?.hasMore ?? false,\n        consumedCount: result.pagination?.consumedCount ?? result.items.length,\n      },\n    };\n  };\n}\n"],"names":["assetTypeToThumb","assetTypeToIcon","fetchGraphQL","SIMPLE_SEARCH_QUERY","MentionMenuSection","PAGINATED_ASSETS_QUERY","WORKSPACE_MEMBERS_QUERY","TOOL_CATALOG_QUERY"],"mappings":";;;;;AAoCA,SAAS,gBAAgB,OAA8B;AACrD,QAAM,WAAW,MAAM,uBAAuB;AAC9C,QAAM,cAAc,MAAM,uBAAuB,MAAM;AACvD,SAAO;AAAA,IACL,IAAI,MAAM;AAAA,IACV,MAAM,MAAM,SAAS;AAAA,IACrB,MAAM,WAAW,WAAW;AAAA,IAC5B,cAAcA,eAAAA,iBAAiB,WAAW;AAAA,IAC1C,cAAcC,eAAAA,gBAAgB,WAAW;AAAA,IACzC,kBAAkB,WAAW,MAAM,KAAK;AAAA,IACxC,qCAAqB,IAAA;AAAA,IACrB,WAAW,MAAM,aAAa;AAAA,IAC9B,OAAO;AAAA,MACL,oBAAoB,MAAM;AAAA,MAC1B,qBAAqB,MAAM;AAAA,MAC3B,gBAAgB,MAAM;AAAA,IAAA;AAAA,EACxB;AAEJ;AAEA,eAAe,kBACb,MACA,MAOkD;;AAClD,QAAM,gBAAqC;AAAA,IACzC,SAAO,UAAK,UAAL,mBAAY,WAAU;AAAA,IAC7B,MAAM,KAAK,gBAAgB,CAAA;AAAA,IAC3B,SAAS,KAAK,gBAAgB,CAAA;AAAA,IAC9B,OAAO,KAAK;AAAA,IACZ,QAAQ,KAAK;AAAA,EAAA;AAGf,QAAM,QAAQ;AAAA,IACZ;AAAA,IACA,iBAAiB;AAAA,IACjB,sBAAsB;AAAA,IACtB,MAAM,EAAE,OAAO,cAAc,WAAW,OAAA;AAAA,IACxC,eAAe,EAAE,YAAY,OAAO,UAAU,MAAA;AAAA,EAAM;AAGtD,QAAM,OAAO,MAAMC,UAAAA,aAEhB,MAAMC,UAAAA,qBAAqB,EAAE,OAAO;AAEvC,QAAM,WAAS,UAAK,iBAAL,mBAAmB,WAAU,CAAA;AAC5C,SAAO;AAAA,IACL,OAAO,OAAO,IAAI,eAAe;AAAA,IACjC,SAAS,OAAO,WAAW,KAAK;AAAA,EAAA;AAEpC;AAWA,MAAM,gBAGF;AAAA,EACF,WAAW,EAAE,MAAM,aAAa,MAAM,QAAQ,OAAO,YAAA;AAAA,EACrD,QAAQ,EAAE,MAAM,UAAU,MAAM,aAAa,OAAO,gBAAA;AAAA,EACpD,UAAU;AAAA,IACR,MAAM;AAAA,IACN,MAAM;AAAA,IACN,OAAO;AAAA,EAAA;AAAA,EAET,iBAAiB;AAAA,IACf,MAAM;AAAA,IACN,MAAM;AAAA,IACN,OAAO;AAAA,EAAA;AAAA,EAET,SAAS,EAAE,MAAM,WAAW,MAAM,UAAU,OAAO,iBAAA;AAAA,EACnD,OAAO,EAAE,MAAM,SAAS,MAAM,UAAU,OAAO,QAAA;AAAA,EAC/C,UAAU,EAAE,MAAM,YAAY,MAAM,WAAW,OAAO,WAAA;AAAA,EACtD,MAAM,EAAE,MAAM,QAAQ,MAAM,SAAS,OAAO,OAAA;AAAA,EAC5C,QAAQ,EAAE,MAAM,UAAU,MAAM,cAAc,OAAO,iBAAA;AACvD;AAEA,SAAS,mBAAmB,SAAiC;AAC3D,MAAI;AACF,UAAM,WAAW,IAAI,IAAI,QAAQ,GAAG,EAAE;AACtC,WAAO,QAAQ,YAAY,GAAG,QAAQ,KAAK,MAAM,QAAQ,KAAK;AAAA,EAChE,QAAQ;AACN,WAAO,QAAQ;AAAA,EACjB;AACF;AAEA,SAAS,kBAAkB,SAAmC;AAC5D,SAAO;AAAA,IACL,IAAI,eAAe,QAAQ,KAAK;AAAA,IAChC,MAAM,QAAQ,YAAY,iBAAiB,QAAQ;AAAA,IACnD,MAAM;AAAA,IACN,cAAcH,eAAAA,iBAAiB,UAAU;AAAA,IACzC,cAAc;AAAA,IACd,iBAAiB,oBAAI,IAAI,CAAC,MAAM,CAAC;AAAA,IACjC,aAAa,mBAAmB,OAAO;AAAA,IACvC,KAAK,QAAQ;AAAA,IACb,aAAa,QAAQ,YACjBI,MAAAA,mBAAmB,kBACnBA,MAAAA,mBAAmB;AAAA,IACvB,OAAO;AAAA,MACL,OAAO,QAAQ;AAAA,MACf,OAAO,QAAQ;AAAA,MACf,WAAW,QAAQ;AAAA,IAAA;AAAA,EACrB;AAEJ;AAEO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AACF,GAGe;AACb,QAAM,eAAe,SAAS,IAAI,iBAAiB;AACnD,QAAM,gBAAgB,WACnB,OAAO,CAAC,QAAgB,cAAc,GAAG,CAAC,EAC1C,IAAI,CAAC,QAAgB;AACpB,UAAM,MAAM,cAAc,GAAG;AAC7B,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,MAAM,IAAI;AAAA,MACV,MAAM;AAAA,MACN,cAAc,IAAI;AAAA,MAClB,iBAAiB,oBAAI,IAAI,CAAC,MAAM,CAAC;AAAA,MACjC,kBAAkB,IAAI;AAAA,MACtB,kBAAkB;AAAA,MAClB,aAAaA,MAAAA,mBAAmB;AAAA,IAAA;AAAA,EAEpC,CAAC;AAEH,SAAO,CAAC,GAAG,cAAc,GAAG,aAAa;AAC3C;AAEO,MAAM,0BAA0D,OACrE,YACG;AACH,QAAM,EAAE,iBAAiB;AACzB,QAAM,QAAQ,mBAAmB;AAAA,IAC/B,YAAY,aAAa;AAAA,IACzB,UAAU,aAAa,YAAA;AAAA,EAAY,CACpC;AAED,SAAO,EAAE,OAAO,YAAY,EAAE,SAAS,QAAM;AAC/C;AAWO,MAAM,cAAsC,OAAO,YAAY;AACpE,QAAM,EAAE,OAAO,YAAY,aAAA,IAAiB;AAC5C,QAAM,QAAQ,aAAa,SAAS;AACpC,QAAM,OAAQ,WAAW,QAA0B,CAAA;AACnD,QAAM,SAAS,KAAK,kBAAkB;AAEtC,QAAM,SAAS,MAAM,kBAAkB,aAAa,MAAM;AAAA,IACxD;AAAA,IACA;AAAA,IACA;AAAA,IACA,cAAc;AAAA,MACZ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAAA,EACF,CACD;AAED,SAAO;AAAA,IACL,OAAO,OAAO;AAAA,IACd,YAAY,EAAE,SAAS,OAAO,QAAA;AAAA,EAAQ;AAE1C;AAWO,MAAM,iBAA4C,OAAO,YAAY;AAC1E,QAAM,EAAE,OAAO,YAAY,aAAA,IAAiB;AAC5C,QAAM,QAAQ,aAAa,SAAS;AACpC,QAAM,OAAQ,WAAW,QAA0B,CAAA;AACnD,QAAM,SAAS,KAAK,kBAAkB;AAEtC,QAAM,OAAO,MAAMF,UAAAA,aAEhB,aAAa,MAAMG,UAAAA,wBAAwB;AAAA,IAC5C;AAAA,IACA;AAAA,IACA,gBAAgB;AAAA,IAChB,aAAa;AAAA,IACb,eAAe;AAAA,MACb,aAAa;AAAA,MACb,YAAY;AAAA,MACZ,UAAU;AAAA,IAAA;AAAA,EACZ,CACD;AAED,QAAM,SAAS,KAAK,kCAAkC,CAAA;AACtD,QAAM,QAAQ,OAAO,IAAI,eAAe;AAExC,SAAO;AAAA,IACL;AAAA,IACA,YAAY,EAAE,SAAS,OAAO,WAAW,MAAA;AAAA,EAAM;AAEnD;AAWO,MAAM,eAAwC,OAAO,YAAY;AACtE,QAAM,EAAE,OAAO,YAAY,aAAA,IAAiB;AAC5C,QAAM,QAAQ,aAAa,SAAS;AACpC,QAAM,OAAQ,WAAW,QAA0B,CAAA;AACnD,QAAM,SAAS,KAAK,kBAAkB;AAEtC,QAAM,SAAS,MAAM,kBAAkB,aAAa,MAAM;AAAA,IACxD;AAAA,IACA;AAAA,IACA;AAAA,IACA,cAAc,CAAC,QAAQ;AAAA,EAAA,CACxB;AAED,SAAO;AAAA,IACL,OAAO,OAAO;AAAA,IACd,YAAY,EAAE,SAAS,OAAO,QAAA;AAAA,EAAQ;AAE1C;AAWO,MAAM,sBAAsD,OACjE,YACG;AACH,QAAM,EAAE,OAAO,OAAO,YAAY,iBAAiB;AACnD,QAAM,QAAQ,aAAa,SAAS;AACpC,QAAM,OAAQ,WAAW,QAA0B,CAAA;AACnD,QAAM,SAAS,KAAK,kBAAkB;AAGtC,QAAM,iBAAiB,UAAU,mBAAmB,OAAO;AAE3D,QAAM,OAAO,MAAMH,UAAAA,aAEhB,aAAa,MAAMG,UAAAA,wBAAwB;AAAA,IAC5C;AAAA,IACA;AAAA,IACA;AAAA,IACA,aAAa;AAAA,IACb,eAAe;AAAA,MACb,YAAY;AAAA,MACZ,UAAU;AAAA,MACV,GAAI,QAAQ,EAAE,OAAO,CAAC,EAAE,IAAI,QAAQ,OAAO,IAAI,KAAK,IAAA,CAAK,EAAA,IAAM,CAAA;AAAA,IAAC;AAAA,EAClE,CACD;AAED,QAAM,YAAY,KAAK,kCAAkC,CAAA;AAEzD,QAAM,SAAS,UAAU;AAAA,IACvB,CAAC,MACC,EAAE,wBAAwB,aAAa,EAAE,uBAAuB;AAAA,EAAA;AAEpE,QAAM,QAAQ,OAAO,IAAI,eAAe;AAExC,SAAO;AAAA,IACL;AAAA,IACA,YAAY;AAAA,MACV,SAAS,UAAU,WAAW;AAAA,MAC9B,eAAe,UAAU;AAAA,IAAA;AAAA,EAC3B;AAEJ;AAYO,MAAM,mBAAgD,OAC3D,YACG;AACH,QAAM,EAAE,OAAO,YAAY,aAAA,IAAiB;AAC5C,QAAM,QAAQ,aAAa,SAAS;AACpC,QAAM,OAAQ,WAAW,QAA0B,CAAA;AACnD,QAAM,SAAS,KAAK,kBAAkB;AAEtC,QAAM,SAAS,MAAM,kBAAkB,aAAa,MAAM;AAAA,IACxD;AAAA,IACA;AAAA,IACA;AAAA,IACA,cAAc,aAAa;AAAA,EAAA,CAC5B;AAED,SAAO;AAAA,IACL,OAAO,OAAO;AAAA,IACd,YAAY,EAAE,SAAS,OAAO,QAAA;AAAA,EAAQ;AAE1C;AAUO,MAAM,YAAkC,OAAO,YAAY;AAChE,QAAM,EAAE,iBAAiB;AACzB,QAAM,EAAE,SAAS;AAEjB,MAAI,CAAC,KAAK,aAAa;AACrB,WAAO,EAAE,OAAO,CAAA,GAAI,YAAY,EAAE,SAAS,QAAM;AAAA,EACnD;AAEA,QAAM,OAAO,MAAMH,UAAAA;AAAAA,IACjB;AAAA,IACAI,UAAAA;AAAAA,IACA,EAAE,aAAa,KAAK,YAAA;AAAA,EAAY;AAGlC,QAAM,UAAU,KAAK,uBAAuB,CAAA;AAC5C,QAAM,QAAoB,QAAQ,IAAI,CAAC,WAAW;AAChD,UAAM,cACJ,CAAC,OAAO,WAAW,OAAO,QAAQ,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG,EAAE,KAAA,KAC9D,OAAO,SACP;AAEF,WAAO;AAAA,MACL,IAAI,OAAO,SAAS,OAAO;AAAA,MAC3B,MAAM;AAAA,MACN,MAAM;AAAA,MACN,cAAc;AAAA,MACd,qCAAqB,IAAA;AAAA,MACrB,OAAO,OAAO,SAAS;AAAA,MACvB,OAAO,EAAE,SAAS,OAAO,QAAA;AAAA,IAAQ;AAAA,EAErC,CAAC;AAED,SAAO,EAAE,OAAO,YAAY,EAAE,SAAS,QAAM;AAC/C;AAaA,eAAe,iBACb,MACwD;AACxD,QAAM,OAAO,MAAMJ,uBAAgC,MAAMK,UAAAA,kBAAkB;AAC3E,SAAO,KAAK;AACd;AAEO,MAAM,aAA0C,OAAO,YAAY;AACxE,QAAM,UAAU,MAAM,iBAAiB,QAAQ,aAAa,IAAI;AAEhE,QAAM,QAAoB,QAAQ,MAC/B,OAAO,CAAC,SAAS,KAAK,aAAa,EACnC,IAAI,CAAC,UAAU;AAAA,IACd,IAAI,KAAK;AAAA,IACT,MAAM,KAAK;AAAA,IACX,MAAM;AAAA,IACN,cAAc,KAAK;AAAA,IACnB,aAAa,KAAK,eAAe;AAAA,IACjC,qCAAqB,IAAA;AAAA,IACrB,GAAI,KAAK,YAAY,EAAE,OAAO,EAAE,aAAa,KAAA,MAAW,CAAA;AAAA,EAAC,EACzD;AAEJ,SAAO,EAAE,OAAO,YAAY,EAAE,SAAS,QAAM;AAC/C;AAEO,MAAM,gBAA6C,OAAO,YAAY;AAC3E,QAAM,UAAU,MAAM,iBAAiB,QAAQ,aAAa,IAAI;AAEhE,QAAM,QAAoB,QAAQ,SAC/B,OAAO,CAAC,YAAY,QAAQ,iBAAiB,CAAC,QAAQ,YAAY,EAClE,IAAI,CAAC,aAAa;AAAA,IACjB,IAAI,QAAQ;AAAA,IACZ,MAAM,QAAQ;AAAA,IACd,MAAM;AAAA,IACN,cAAc,QAAQ;AAAA,IACtB,aAAa,QAAQ,eAAe;AAAA,IACpC,qCAAqB,IAAA;AAAA,IACrB,GAAI,QAAQ,YAAY,EAAE,OAAO,EAAE,aAAa,KAAA,MAAW,CAAA;AAAA,EAAC,EAC5D;AAEJ,SAAO,EAAE,OAAO,YAAY,EAAE,SAAS,QAAM;AAC/C;AAUO,MAAM,cAAsC,OAAO,YAAY;AACpE,QAAM,EAAE,YAAY,aAAA,IAAiB;AACrC,QAAM,OAAQ,WAAW,QAA0B,CAAA;AACnD,QAAM,SAAS,KAAK,kBAAkB;AAEtC,QAAM,SAAS,MAAM,kBAAkB,aAAa,MAAM;AAAA,IACxD,OAAO;AAAA,IACP;AAAA,IACA,cAAc,CAAC,SAAS;AAAA,EAAA,CACzB;AAGD,QAAM,QAAoB,OAAO,MAAM,IAAI,CAAC,UAAU;AAAA,IACpD,GAAG;AAAA,IACH,MAAM;AAAA,IACN,cAAc;AAAA,IACd,kBAAkB;AAAA,IAClB,kBAAkB,KAAK;AAAA,EAAA,EACvB;AAGF,QAAM,UAA8B,MAAM,IAAI,CAAC,UAAU;AAAA,IACvD,OAAO,KAAK;AAAA,IACZ,UAAU;AAAA,IACV,cAAc,EAAE,MAAM,aAAa,MAAM,OAAO,GAAA;AAAA,EAAG,EACnD;AAEF,SAAO;AAAA,IACL;AAAA,IACA,YAAY,EAAE,SAAS,OAAO,QAAA;AAAA,IAC9B;AAAA,EAAA;AAEJ;AAUO,MAAM,oBAAkD,OAC7D,YACG;AACH,QAAM,EAAE,OAAO,YAAY,aAAA,IAAiB;AAC5C,MAAI,EAAC,+BAAO,QAAQ,QAAO,EAAE,OAAO,CAAA,GAAI,YAAY,EAAE,SAAS,QAAM;AAErE,QAAM,OAAQ,WAAW,QAA0B,CAAA;AACnD,QAAM,SAAS,KAAK,kBAAkB;AAEtC,QAAM,SAAS,MAAM,kBAAkB,aAAa,MAAM;AAAA,IACxD;AAAA,IACA,OAAO;AAAA,IACP;AAAA,IACA,cAAc,CAAC,SAAS,WAAW,UAAU,aAAa,SAAS;AAAA,EAAA,CACpE;AAED,SAAO;AAAA,IACL,OAAO,OAAO;AAAA,IACd,YAAY,EAAE,SAAS,OAAO,QAAA;AAAA,EAAQ;AAE1C;AAYO,SAAS,sBACd,OACA,MACY;AACZ,SAAO,MACJ,OAAO,CAAC,SAAS,SAAS,UAAa,KAAK,SAAS,IAAI,EACzD,IAAI,CAAC,UAAU;AAAA,IACd,IAAI,KAAK;AAAA,IACT,MAAM,KAAK;AAAA,IACX,MAAM,KAAK;AAAA,IACX,cAAc,KAAK,SAAS,KAAK,SAAS,YAAY,YAAY;AAAA,IAClE,aAAa,KAAK;AAAA,IAClB,qCAAqB,IAAA;AAAA,EAAY,EACjC;AACN;AAEO,MAAM,yBAAwD,OACnE,aACI;AAAA,EACJ,OAAO;AAAA,IACL,QAAQ,aAAa,SAAA;AAAA,IACrB,QAAQ,aAAa;AAAA,EAAA;AAAA,EAEvB,YAAY,EAAE,SAAS,MAAA;AACzB;AASO,SAAS,kBACd,QACA,UACmB;AACnB,SAAO,OAAO,YAAY;;AACxB,UAAM,SAAS,MAAM,OAAO,OAAO;AACnC,WAAO;AAAA,MACL,GAAG;AAAA,MACH,OAAO,CAAC,GAAG,sBAAsB,UAAU,GAAG,GAAG,OAAO,KAAK;AAAA,MAC7D,YAAY;AAAA,QACV,GAAG,OAAO;AAAA,QACV,WAAS,YAAO,eAAP,mBAAmB,YAAW;AAAA,QACvC,iBAAe,YAAO,eAAP,mBAAmB,kBAAiB,OAAO,MAAM;AAAA,MAAA;AAAA,IAClE;AAAA,EAEJ;AACF;;;;;;;;;;;;;;;;"}

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

@@ -8,7 +8,7 @@
  * - FETCHERS: Call GraphQL API (assets, folders, team, etc.)
  * - TRANSFORMERS: Return static/local data (root categories, host-provided items)
  */
-import type { MenuItem, SourceFn, WebpageMention } from "../types";
+import type { MenuItem, MentionTool, SourceFn, WebpageMention } from "../types";
 import { type MentionAuthContext } from "../api-client";
 export interface RootCategoriesConfig {
     categories: string[];
@@ -62,3 +62,18 @@ export interface GlobalSearchConfig {
     auth: MentionAuthContext;
 }
 export declare const fetchGlobalSearch: SourceFn<GlobalSearchConfig>;
+export interface ProvidedToolsConfig {
+    getTools: () => readonly MentionTool[];
+    type: MentionTool["type"];
+}
+/** Menu items for a host-provided tool list, in the host's order. */
+export declare function providedToolMenuItems(tools: readonly MentionTool[], type?: MentionTool["type"]): MenuItem[];
+export declare const transformProvidedTools: SourceFn<ProvidedToolsConfig>;
+/**
+ * Prepend a host's tool list to another source's items so a root query matches
+ * them the way it matches assets (the cache filters by query and sorts
+ * toolkits first). The wrapped source's offset bookkeeping is preserved:
+ * `consumedCount` stays the number of rows the server returned, so the added
+ * items never advance the next page's offset.
+ */
+export declare function withProvidedTools<TConfig>(source: SourceFn<TConfig>, getTools: () => readonly MentionTool[]): SourceFn<TConfig>;

package/dist/chat-ui/mentions/suggestions/data/sources/index.js

@@ -0,0 +1,375 @@
+import { MentionMenuSection } from "../types.js";
+import { fetchGraphQL, PAGINATED_ASSETS_QUERY, WORKSPACE_MEMBERS_QUERY, SIMPLE_SEARCH_QUERY, TOOL_CATALOG_QUERY } from "../api-client.js";
+import { assetTypeToThumb, assetTypeToIcon } from "./asset-type-icons.js";
+function assetToMenuItem(asset) {
+  const isFolder = asset.athenaOriginalType === "folder";
+  const displayType = asset.athenaConvertedType || asset.athenaOriginalType;
+  return {
+    id: asset.id,
+    name: asset.title || "Untitled",
+    type: isFolder ? "folder" : "asset",
+    thumbnailUrl: assetTypeToThumb(displayType),
+    fallbackIcon: assetTypeToIcon(displayType),
+    navigatesToScope: isFolder ? asset.id : void 0,
+    visibleInScopes: /* @__PURE__ */ new Set(),
+    updatedAt: asset.updatedAt ?? void 0,
+    extra: {
+      athenaOriginalType: asset.athenaOriginalType,
+      athenaConvertedType: asset.athenaConvertedType,
+      parentFolderId: asset.parentFolderId
+    }
+  };
+}
+async function querySimpleSearch(auth, opts) {
+  var _a, _b;
+  const searchRequest = {
+    query: ((_a = opts.query) == null ? void 0 : _a.trim()) || "",
+    type: opts.includeTypes || [],
+    notType: opts.excludeTypes || [],
+    limit: opts.limit,
+    offset: opts.offset
+  };
+  const input = {
+    searchRequest,
+    returnFullAsset: true,
+    shouldCalculateTotal: false,
+    sort: { field: "UPDATED_AT", direction: "DESC" },
+    filterColumns: { isArchived: false, isHidden: false }
+  };
+  const data = await fetchGraphQL(auth, SIMPLE_SEARCH_QUERY, { input });
+  const assets = ((_b = data.simpleSearch) == null ? void 0 : _b.assets) || [];
+  return {
+    items: assets.map(assetToMenuItem),
+    hasMore: assets.length === opts.limit
+  };
+}
+const CATEGORY_DEFS = {
+  favorites: { name: "Favorites", icon: "star", scope: "favorites" },
+  assets: { name: "Assets", icon: "file-text", scope: "athena_assets" },
+  projects: {
+    name: "Projects",
+    icon: "folder-kanban",
+    scope: "athena_projects"
+  },
+  browse_profiles: {
+    name: "Browse Profiles",
+    icon: "globe",
+    scope: "athena_browse_profiles"
+  },
+  folders: { name: "Folders", icon: "folder", scope: "athena_folders" },
+  tools: { name: "Tools", icon: "wrench", scope: "tools" },
+  toolkits: { name: "Toolkits", icon: "package", scope: "toolkits" },
+  team: { name: "Team", icon: "users", scope: "team" },
+  drives: { name: "Drives", icon: "hard-drive", scope: "drive_catalogs" }
+};
+function webpageDescription(webpage) {
+  try {
+    const hostname = new URL(webpage.url).hostname;
+    return webpage.isCurrent ? `${webpage.title} · ${hostname}` : hostname;
+  } catch {
+    return webpage.title;
+  }
+}
+function webpageToMenuItem(webpage) {
+  return {
+    id: `webpage-tab-${webpage.tabId}`,
+    name: webpage.isCurrent ? "This webpage" : webpage.title,
+    type: "tab",
+    thumbnailUrl: assetTypeToThumb("web_page"),
+    fallbackIcon: "globe",
+    visibleInScopes: /* @__PURE__ */ new Set(["root"]),
+    description: webpageDescription(webpage),
+    url: webpage.url,
+    menuSection: webpage.isCurrent ? MentionMenuSection.CURRENT_WEBPAGE : MentionMenuSection.OTHER_WEBPAGES,
+    extra: {
+      tabId: webpage.tabId,
+      title: webpage.title,
+      isCurrent: webpage.isCurrent
+    }
+  };
+}
+function buildRootMenuItems({
+  categories,
+  webpages
+}) {
+  const webpageItems = webpages.map(webpageToMenuItem);
+  const categoryItems = categories.filter((cat) => CATEGORY_DEFS[cat]).map((cat) => {
+    const def = CATEGORY_DEFS[cat];
+    return {
+      id: cat,
+      name: def.name,
+      type: "menu",
+      fallbackIcon: def.icon,
+      visibleInScopes: /* @__PURE__ */ new Set(["root"]),
+      navigatesToScope: def.scope,
+      isNavigationOnly: true,
+      menuSection: MentionMenuSection.LIBRARY
+    };
+  });
+  return [...webpageItems, ...categoryItems];
+}
+const transformRootCategories = async (context) => {
+  const { sourceConfig } = context;
+  const items = buildRootMenuItems({
+    categories: sourceConfig.categories,
+    webpages: sourceConfig.getWebpages()
+  });
+  return { items, pagination: { hasMore: false } };
+};
+const fetchAssets = async (context) => {
+  const { query, fetchState, sourceConfig } = context;
+  const limit = sourceConfig.limit ?? 50;
+  const meta = fetchState.meta || {};
+  const offset = meta.validatedCount || 0;
+  const result = await querySimpleSearch(sourceConfig.auth, {
+    query,
+    limit,
+    offset,
+    excludeTypes: [
+      "folder",
+      "catalog",
+      "spaces",
+      "session",
+      "table",
+      "task_item"
+    ]
+  });
+  return {
+    items: result.items,
+    pagination: { hasMore: result.hasMore }
+  };
+};
+const fetchFavorites = async (context) => {
+  const { query, fetchState, sourceConfig } = context;
+  const limit = sourceConfig.limit ?? 50;
+  const meta = fetchState.meta || {};
+  const offset = meta.validatedCount || 0;
+  const data = await fetchGraphQL(sourceConfig.auth, PAGINATED_ASSETS_QUERY, {
+    limit,
+    offset,
+    parentFolderId: null,
+    filterTypes: null,
+    filterColumns: {
+      isFavorited: true,
+      isArchived: false,
+      isHidden: false
+    }
+  });
+  const assets = data.getPaginatedAssetsForWorkspace || [];
+  const items = assets.map(assetToMenuItem);
+  return {
+    items,
+    pagination: { hasMore: assets.length === limit }
+  };
+};
+const fetchFolders = async (context) => {
+  const { query, fetchState, sourceConfig } = context;
+  const limit = sourceConfig.limit ?? 50;
+  const meta = fetchState.meta || {};
+  const offset = meta.validatedCount || 0;
+  const result = await querySimpleSearch(sourceConfig.auth, {
+    query,
+    limit,
+    offset,
+    includeTypes: ["folder"]
+  });
+  return {
+    items: result.items,
+    pagination: { hasMore: result.hasMore }
+  };
+};
+const fetchFolderContents = async (context) => {
+  const { scope, query, fetchState, sourceConfig } = context;
+  const limit = sourceConfig.limit ?? 50;
+  const meta = fetchState.meta || {};
+  const offset = meta.validatedCount || 0;
+  const parentFolderId = scope === "internal_drive" ? null : scope;
+  const data = await fetchGraphQL(sourceConfig.auth, PAGINATED_ASSETS_QUERY, {
+    limit,
+    offset,
+    parentFolderId,
+    filterTypes: null,
+    filterColumns: {
+      isArchived: false,
+      isHidden: false,
+      ...query ? { title: [{ op: "LIKE", value: `%${query}%` }] } : {}
+    }
+  });
+  const rawAssets = data.getPaginatedAssetsForWorkspace || [];
+  const assets = rawAssets.filter(
+    (a) => a.athenaConvertedType !== "catalog" && a.athenaOriginalType !== "catalog"
+  );
+  const items = assets.map(assetToMenuItem);
+  return {
+    items,
+    pagination: {
+      hasMore: rawAssets.length === limit,
+      consumedCount: rawAssets.length
+    }
+  };
+};
+const fetchTypedAssets = async (context) => {
+  const { query, fetchState, sourceConfig } = context;
+  const limit = sourceConfig.limit ?? 50;
+  const meta = fetchState.meta || {};
+  const offset = meta.validatedCount || 0;
+  const result = await querySimpleSearch(sourceConfig.auth, {
+    query,
+    limit,
+    offset,
+    includeTypes: sourceConfig.includeOnlyTypes
+  });
+  return {
+    items: result.items,
+    pagination: { hasMore: result.hasMore }
+  };
+};
+const fetchTeam = async (context) => {
+  const { sourceConfig } = context;
+  const { auth } = sourceConfig;
+  if (!auth.workspaceId) {
+    return { items: [], pagination: { hasMore: false } };
+  }
+  const data = await fetchGraphQL(
+    auth,
+    WORKSPACE_MEMBERS_QUERY,
+    { workspaceId: auth.workspaceId }
+  );
+  const members = data.getUsersInWorkspace || [];
+  const items = members.map((member) => {
+    const displayName = [member.firstName, member.lastName].filter(Boolean).join(" ").trim() || member.email || "Unknown User";
+    return {
+      id: member.email || member.id,
+      name: displayName,
+      type: "user",
+      fallbackIcon: "user",
+      visibleInScopes: /* @__PURE__ */ new Set(),
+      email: member.email ?? void 0,
+      extra: { isAdmin: member.isAdmin }
+    };
+  });
+  return { items, pagination: { hasMore: false } };
+};
+async function queryToolCatalog(auth) {
+  const data = await fetchGraphQL(auth, TOOL_CATALOG_QUERY);
+  return data.getToolkitToToolsMapping;
+}
+const fetchTools = async (context) => {
+  const catalog = await queryToolCatalog(context.sourceConfig.auth);
+  const items = catalog.tools.filter((tool) => tool.isMentionable).map((tool) => ({
+    id: tool.id,
+    name: tool.name,
+    type: "tool",
+    fallbackIcon: tool.icon,
+    description: tool.description ?? void 0,
+    visibleInScopes: /* @__PURE__ */ new Set(),
+    ...tool.adminOnly ? { extra: { isAdminOnly: true } } : {}
+  }));
+  return { items, pagination: { hasMore: false } };
+};
+const fetchToolkits = async (context) => {
+  const catalog = await queryToolCatalog(context.sourceConfig.auth);
+  const items = catalog.toolkits.filter((toolkit) => toolkit.isMentionable && !toolkit.hideFromMenu).map((toolkit) => ({
+    id: toolkit.name,
+    name: toolkit.displayName,
+    type: "toolkit",
+    fallbackIcon: toolkit.icon,
+    description: toolkit.description || void 0,
+    visibleInScopes: /* @__PURE__ */ new Set(),
+    ...toolkit.onlyAdmin ? { extra: { isAdminOnly: true } } : {}
+  }));
+  return { items, pagination: { hasMore: false } };
+};
+const fetchDrives = async (context) => {
+  const { fetchState, sourceConfig } = context;
+  const meta = fetchState.meta || {};
+  const offset = meta.validatedCount || 0;
+  const result = await querySimpleSearch(sourceConfig.auth, {
+    limit: 50,
+    offset,
+    includeTypes: ["catalog"]
+  });
+  const items = result.items.map((item) => ({
+    ...item,
+    type: "drive_catalog",
+    fallbackIcon: "hard-drive",
+    isNavigationOnly: true,
+    navigatesToScope: item.id
+  }));
+  const sources = items.map((item) => ({
+    scope: item.id,
+    sourceFn: fetchFolderContents,
+    sourceConfig: { auth: sourceConfig.auth, limit: 50 }
+  }));
+  return {
+    items,
+    pagination: { hasMore: result.hasMore },
+    sources
+  };
+};
+const fetchGlobalSearch = async (context) => {
+  const { query, fetchState, sourceConfig } = context;
+  if (!(query == null ? void 0 : query.trim())) return { items: [], pagination: { hasMore: false } };
+  const meta = fetchState.meta || {};
+  const offset = meta.validatedCount || 0;
+  const result = await querySimpleSearch(sourceConfig.auth, {
+    query,
+    limit: 50,
+    offset,
+    excludeTypes: ["table", "catalog", "spaces", "task_item", "session"]
+  });
+  return {
+    items: result.items,
+    pagination: { hasMore: result.hasMore }
+  };
+};
+function providedToolMenuItems(tools, type) {
+  return tools.filter((tool) => type === void 0 || tool.type === type).map((tool) => ({
+    id: tool.id,
+    name: tool.name,
+    type: tool.type,
+    fallbackIcon: tool.icon ?? (tool.type === "toolkit" ? "Package" : "Wrench"),
+    description: tool.description,
+    visibleInScopes: /* @__PURE__ */ new Set()
+  }));
+}
+const transformProvidedTools = async (context) => ({
+  items: providedToolMenuItems(
+    context.sourceConfig.getTools(),
+    context.sourceConfig.type
+  ),
+  pagination: { hasMore: false }
+});
+function withProvidedTools(source, getTools) {
+  return async (context) => {
+    var _a, _b;
+    const result = await source(context);
+    return {
+      ...result,
+      items: [...providedToolMenuItems(getTools()), ...result.items],
+      pagination: {
+        ...result.pagination,
+        hasMore: ((_a = result.pagination) == null ? void 0 : _a.hasMore) ?? false,
+        consumedCount: ((_b = result.pagination) == null ? void 0 : _b.consumedCount) ?? result.items.length
+      }
+    };
+  };
+}
+export {
+  buildRootMenuItems,
+  fetchAssets,
+  fetchDrives,
+  fetchFavorites,
+  fetchFolderContents,
+  fetchFolders,
+  fetchGlobalSearch,
+  fetchTeam,
+  fetchToolkits,
+  fetchTools,
+  fetchTypedAssets,
+  providedToolMenuItems,
+  transformProvidedTools,
+  transformRootCategories,
+  withProvidedTools
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../../../src/chat-ui/mentions/suggestions/data/sources/index.ts"],"sourcesContent":["/**\n * Mention data sources shared by every chat host.\n *\n * Each source function implements the SourceFn interface:\n *   (context: SourceContext) => Promise<SourceResult>\n *\n * Sources are either:\n * - FETCHERS: Call GraphQL API (assets, folders, team, etc.)\n * - TRANSFORMERS: Return static/local data (root categories, host-provided items)\n */\n\nimport type {\n  MenuItem,\n  MentionTool,\n  SourceFn,\n  SourceResult,\n  SourceToRegister,\n  FetchMetadata,\n  WebpageMention,\n} from \"../types\";\nimport { MentionMenuSection } from \"../types\";\nimport {\n  fetchGraphQL,\n  SIMPLE_SEARCH_QUERY,\n  PAGINATED_ASSETS_QUERY,\n  WORKSPACE_MEMBERS_QUERY,\n  TOOL_CATALOG_QUERY,\n  type MentionAuthContext,\n  type AssetResult,\n  type WorkspaceMember,\n  type ToolCatalogResult,\n} from \"../api-client\";\nimport { assetTypeToThumb, assetTypeToIcon } from \"./asset-type-icons\";\n\n// ── Helpers ──\n\nfunction assetToMenuItem(asset: AssetResult): MenuItem {\n  const isFolder = asset.athenaOriginalType === \"folder\";\n  const displayType = asset.athenaConvertedType || asset.athenaOriginalType;\n  return {\n    id: asset.id,\n    name: asset.title || \"Untitled\",\n    type: isFolder ? \"folder\" : \"asset\",\n    thumbnailUrl: assetTypeToThumb(displayType),\n    fallbackIcon: assetTypeToIcon(displayType),\n    navigatesToScope: isFolder ? asset.id : undefined,\n    visibleInScopes: new Set(),\n    updatedAt: asset.updatedAt ?? undefined,\n    extra: {\n      athenaOriginalType: asset.athenaOriginalType,\n      athenaConvertedType: asset.athenaConvertedType,\n      parentFolderId: asset.parentFolderId,\n    },\n  };\n}\n\nasync function querySimpleSearch(\n  auth: MentionAuthContext,\n  opts: {\n    query?: string;\n    limit: number;\n    offset: number;\n    includeTypes?: string[];\n    excludeTypes?: string[];\n  },\n): Promise<{ items: MenuItem[]; hasMore: boolean }> {\n  const searchRequest: Record<string, any> = {\n    query: opts.query?.trim() || \"\",\n    type: opts.includeTypes || [],\n    notType: opts.excludeTypes || [],\n    limit: opts.limit,\n    offset: opts.offset,\n  };\n\n  const input = {\n    searchRequest,\n    returnFullAsset: true,\n    shouldCalculateTotal: false,\n    sort: { field: \"UPDATED_AT\", direction: \"DESC\" },\n    filterColumns: { isArchived: false, isHidden: false },\n  };\n\n  const data = await fetchGraphQL<{\n    simpleSearch: { assets: AssetResult[]; totalCount: number };\n  }>(auth, SIMPLE_SEARCH_QUERY, { input });\n\n  const assets = data.simpleSearch?.assets || [];\n  return {\n    items: assets.map(assetToMenuItem),\n    hasMore: assets.length === opts.limit,\n  };\n}\n\n// ══════════════════════════════════════════════════════════════════════\n// ROOT CATEGORIES (Transformer)\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface RootCategoriesConfig {\n  categories: string[];\n  getWebpages: () => readonly WebpageMention[];\n}\n\nconst CATEGORY_DEFS: Record<\n  string,\n  { name: string; icon: string; scope: string }\n> = {\n  favorites: { name: \"Favorites\", icon: \"star\", scope: \"favorites\" },\n  assets: { name: \"Assets\", icon: \"file-text\", scope: \"athena_assets\" },\n  projects: {\n    name: \"Projects\",\n    icon: \"folder-kanban\",\n    scope: \"athena_projects\",\n  },\n  browse_profiles: {\n    name: \"Browse Profiles\",\n    icon: \"globe\",\n    scope: \"athena_browse_profiles\",\n  },\n  folders: { name: \"Folders\", icon: \"folder\", scope: \"athena_folders\" },\n  tools: { name: \"Tools\", icon: \"wrench\", scope: \"tools\" },\n  toolkits: { name: \"Toolkits\", icon: \"package\", scope: \"toolkits\" },\n  team: { name: \"Team\", icon: \"users\", scope: \"team\" },\n  drives: { name: \"Drives\", icon: \"hard-drive\", scope: \"drive_catalogs\" },\n};\n\nfunction webpageDescription(webpage: WebpageMention): string {\n  try {\n    const hostname = new URL(webpage.url).hostname;\n    return webpage.isCurrent ? `${webpage.title} · ${hostname}` : hostname;\n  } catch {\n    return webpage.title;\n  }\n}\n\nfunction webpageToMenuItem(webpage: WebpageMention): MenuItem {\n  return {\n    id: `webpage-tab-${webpage.tabId}`,\n    name: webpage.isCurrent ? \"This webpage\" : webpage.title,\n    type: \"tab\",\n    thumbnailUrl: assetTypeToThumb(\"web_page\"),\n    fallbackIcon: \"globe\",\n    visibleInScopes: new Set([\"root\"]),\n    description: webpageDescription(webpage),\n    url: webpage.url,\n    menuSection: webpage.isCurrent\n      ? MentionMenuSection.CURRENT_WEBPAGE\n      : MentionMenuSection.OTHER_WEBPAGES,\n    extra: {\n      tabId: webpage.tabId,\n      title: webpage.title,\n      isCurrent: webpage.isCurrent,\n    },\n  };\n}\n\nexport function buildRootMenuItems({\n  categories,\n  webpages,\n}: {\n  categories: readonly string[];\n  webpages: readonly WebpageMention[];\n}): MenuItem[] {\n  const webpageItems = webpages.map(webpageToMenuItem);\n  const categoryItems = categories\n    .filter((cat: string) => CATEGORY_DEFS[cat])\n    .map((cat: string) => {\n      const def = CATEGORY_DEFS[cat];\n      return {\n        id: cat,\n        name: def.name,\n        type: \"menu\" as const,\n        fallbackIcon: def.icon,\n        visibleInScopes: new Set([\"root\"]),\n        navigatesToScope: def.scope,\n        isNavigationOnly: true,\n        menuSection: MentionMenuSection.LIBRARY,\n      };\n    });\n\n  return [...webpageItems, ...categoryItems];\n}\n\nexport const transformRootCategories: SourceFn<RootCategoriesConfig> = async (\n  context,\n) => {\n  const { sourceConfig } = context;\n  const items = buildRootMenuItems({\n    categories: sourceConfig.categories,\n    webpages: sourceConfig.getWebpages(),\n  });\n\n  return { items, pagination: { hasMore: false } };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// ASSETS (Fetcher) — All non-folder assets via SimpleSearch\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface AssetsConfig {\n  auth: MentionAuthContext;\n  limit?: number;\n}\n\nexport const fetchAssets: SourceFn<AssetsConfig> = async (context) => {\n  const { query, fetchState, sourceConfig } = context;\n  const limit = sourceConfig.limit ?? 50;\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  const offset = meta.validatedCount || 0;\n\n  const result = await querySimpleSearch(sourceConfig.auth, {\n    query,\n    limit,\n    offset,\n    excludeTypes: [\n      \"folder\",\n      \"catalog\",\n      \"spaces\",\n      \"session\",\n      \"table\",\n      \"task_item\",\n    ],\n  });\n\n  return {\n    items: result.items,\n    pagination: { hasMore: result.hasMore },\n  };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// FAVORITES (Fetcher) — Favorited assets\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface FavoritesConfig {\n  auth: MentionAuthContext;\n  limit?: number;\n}\n\nexport const fetchFavorites: SourceFn<FavoritesConfig> = async (context) => {\n  const { query, fetchState, sourceConfig } = context;\n  const limit = sourceConfig.limit ?? 50;\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  const offset = meta.validatedCount || 0;\n\n  const data = await fetchGraphQL<{\n    getPaginatedAssetsForWorkspace: AssetResult[];\n  }>(sourceConfig.auth, PAGINATED_ASSETS_QUERY, {\n    limit,\n    offset,\n    parentFolderId: null,\n    filterTypes: null,\n    filterColumns: {\n      isFavorited: true,\n      isArchived: false,\n      isHidden: false,\n    },\n  });\n\n  const assets = data.getPaginatedAssetsForWorkspace || [];\n  const items = assets.map(assetToMenuItem);\n\n  return {\n    items,\n    pagination: { hasMore: assets.length === limit },\n  };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// FOLDERS (Fetcher) — All folders as flat list\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface FoldersConfig {\n  auth: MentionAuthContext;\n  limit?: number;\n}\n\nexport const fetchFolders: SourceFn<FoldersConfig> = async (context) => {\n  const { query, fetchState, sourceConfig } = context;\n  const limit = sourceConfig.limit ?? 50;\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  const offset = meta.validatedCount || 0;\n\n  const result = await querySimpleSearch(sourceConfig.auth, {\n    query,\n    limit,\n    offset,\n    includeTypes: [\"folder\"],\n  });\n\n  return {\n    items: result.items,\n    pagination: { hasMore: result.hasMore },\n  };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// FOLDER CONTENTS (Fetcher) — Contents of a specific folder\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface FolderContentsConfig {\n  auth: MentionAuthContext;\n  limit?: number;\n}\n\nexport const fetchFolderContents: SourceFn<FolderContentsConfig> = async (\n  context,\n) => {\n  const { scope, query, fetchState, sourceConfig } = context;\n  const limit = sourceConfig.limit ?? 50;\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  const offset = meta.validatedCount || 0;\n\n  // Scope IS the folder ID (or 'internal_drive' for root)\n  const parentFolderId = scope === \"internal_drive\" ? null : scope;\n\n  const data = await fetchGraphQL<{\n    getPaginatedAssetsForWorkspace: AssetResult[];\n  }>(sourceConfig.auth, PAGINATED_ASSETS_QUERY, {\n    limit,\n    offset,\n    parentFolderId,\n    filterTypes: null,\n    filterColumns: {\n      isArchived: false,\n      isHidden: false,\n      ...(query ? { title: [{ op: \"LIKE\", value: `%${query}%` }] } : {}),\n    },\n  });\n\n  const rawAssets = data.getPaginatedAssetsForWorkspace || [];\n  // Exclude catalogs from folder contents\n  const assets = rawAssets.filter(\n    (a) =>\n      a.athenaConvertedType !== \"catalog\" && a.athenaOriginalType !== \"catalog\",\n  );\n  const items = assets.map(assetToMenuItem);\n\n  return {\n    items,\n    pagination: {\n      hasMore: rawAssets.length === limit,\n      consumedCount: rawAssets.length,\n    },\n  };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// PROJECTS (Fetcher) — Project assets\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface TypedAssetsConfig {\n  auth: MentionAuthContext;\n  includeOnlyTypes: string[];\n  limit?: number;\n}\n\nexport const fetchTypedAssets: SourceFn<TypedAssetsConfig> = async (\n  context,\n) => {\n  const { query, fetchState, sourceConfig } = context;\n  const limit = sourceConfig.limit ?? 50;\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  const offset = meta.validatedCount || 0;\n\n  const result = await querySimpleSearch(sourceConfig.auth, {\n    query,\n    limit,\n    offset,\n    includeTypes: sourceConfig.includeOnlyTypes,\n  });\n\n  return {\n    items: result.items,\n    pagination: { hasMore: result.hasMore },\n  };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// TEAM (Fetcher) — Workspace members\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface TeamConfig {\n  auth: MentionAuthContext;\n}\n\nexport const fetchTeam: SourceFn<TeamConfig> = async (context) => {\n  const { sourceConfig } = context;\n  const { auth } = sourceConfig;\n\n  if (!auth.workspaceId) {\n    return { items: [], pagination: { hasMore: false } };\n  }\n\n  const data = await fetchGraphQL<{ getUsersInWorkspace: WorkspaceMember[] }>(\n    auth,\n    WORKSPACE_MEMBERS_QUERY,\n    { workspaceId: auth.workspaceId },\n  );\n\n  const members = data.getUsersInWorkspace || [];\n  const items: MenuItem[] = members.map((member) => {\n    const displayName =\n      [member.firstName, member.lastName].filter(Boolean).join(\" \").trim() ||\n      member.email ||\n      \"Unknown User\";\n\n    return {\n      id: member.email || member.id,\n      name: displayName,\n      type: \"user\" as const,\n      fallbackIcon: \"user\",\n      visibleInScopes: new Set<string>(),\n      email: member.email ?? undefined,\n      extra: { isAdmin: member.isAdmin },\n    };\n  });\n\n  return { items, pagination: { hasMore: false } };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// TOOLS / TOOLKITS (Fetcher) — Mentionable tool catalog\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface ToolCatalogConfig {\n  auth: MentionAuthContext;\n}\n\n// getToolkitToToolsMapping is already filtered server-side for the\n// authenticated user (admin-only entries, beta allowlist, workspace registry),\n// so only mention/menu visibility is applied here.\nasync function queryToolCatalog(\n  auth: MentionAuthContext,\n): Promise<ToolCatalogResult[\"getToolkitToToolsMapping\"]> {\n  const data = await fetchGraphQL<ToolCatalogResult>(auth, TOOL_CATALOG_QUERY);\n  return data.getToolkitToToolsMapping;\n}\n\nexport const fetchTools: SourceFn<ToolCatalogConfig> = async (context) => {\n  const catalog = await queryToolCatalog(context.sourceConfig.auth);\n\n  const items: MenuItem[] = catalog.tools\n    .filter((tool) => tool.isMentionable)\n    .map((tool) => ({\n      id: tool.id,\n      name: tool.name,\n      type: \"tool\" as const,\n      fallbackIcon: tool.icon,\n      description: tool.description ?? undefined,\n      visibleInScopes: new Set<string>(),\n      ...(tool.adminOnly ? { extra: { isAdminOnly: true } } : {}),\n    }));\n\n  return { items, pagination: { hasMore: false } };\n};\n\nexport const fetchToolkits: SourceFn<ToolCatalogConfig> = async (context) => {\n  const catalog = await queryToolCatalog(context.sourceConfig.auth);\n\n  const items: MenuItem[] = catalog.toolkits\n    .filter((toolkit) => toolkit.isMentionable && !toolkit.hideFromMenu)\n    .map((toolkit) => ({\n      id: toolkit.name,\n      name: toolkit.displayName,\n      type: \"toolkit\" as const,\n      fallbackIcon: toolkit.icon,\n      description: toolkit.description || undefined,\n      visibleInScopes: new Set<string>(),\n      ...(toolkit.onlyAdmin ? { extra: { isAdminOnly: true } } : {}),\n    }));\n\n  return { items, pagination: { hasMore: false } };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// DRIVES (Fetcher) — Drive catalog assets\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface DrivesConfig {\n  auth: MentionAuthContext;\n}\n\nexport const fetchDrives: SourceFn<DrivesConfig> = async (context) => {\n  const { fetchState, sourceConfig } = context;\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  const offset = meta.validatedCount || 0;\n\n  const result = await querySimpleSearch(sourceConfig.auth, {\n    limit: 50,\n    offset,\n    includeTypes: [\"catalog\"],\n  });\n\n  // Drive catalogs are navigation-only (navigate into them to see contents)\n  const items: MenuItem[] = result.items.map((item) => ({\n    ...item,\n    type: \"drive_catalog\" as const,\n    fallbackIcon: \"hard-drive\",\n    isNavigationOnly: true,\n    navigatesToScope: item.id,\n  }));\n\n  // Register folder contents source for each catalog\n  const sources: SourceToRegister[] = items.map((item) => ({\n    scope: item.id,\n    sourceFn: fetchFolderContents,\n    sourceConfig: { auth: sourceConfig.auth, limit: 50 },\n  }));\n\n  return {\n    items,\n    pagination: { hasMore: result.hasMore },\n    sources,\n  };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// GLOBAL SEARCH (Fetcher) — Aggregated search across all sources\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface GlobalSearchConfig {\n  auth: MentionAuthContext;\n}\n\nexport const fetchGlobalSearch: SourceFn<GlobalSearchConfig> = async (\n  context,\n) => {\n  const { query, fetchState, sourceConfig } = context;\n  if (!query?.trim()) return { items: [], pagination: { hasMore: false } };\n\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  const offset = meta.validatedCount || 0;\n\n  const result = await querySimpleSearch(sourceConfig.auth, {\n    query,\n    limit: 50,\n    offset,\n    excludeTypes: [\"table\", \"catalog\", \"spaces\", \"task_item\", \"session\"],\n  });\n\n  return {\n    items: result.items,\n    pagination: { hasMore: result.hasMore },\n  };\n};\n\n// ══════════════════════════════════════════════════════════════════════\n// HOST-PROVIDED TOOLS (Transformer) — a host's own Tools / Toolkits list\n// ══════════════════════════════════════════════════════════════════════\n\nexport interface ProvidedToolsConfig {\n  getTools: () => readonly MentionTool[];\n  type: MentionTool[\"type\"];\n}\n\n/** Menu items for a host-provided tool list, in the host's order. */\nexport function providedToolMenuItems(\n  tools: readonly MentionTool[],\n  type?: MentionTool[\"type\"],\n): MenuItem[] {\n  return tools\n    .filter((tool) => type === undefined || tool.type === type)\n    .map((tool) => ({\n      id: tool.id,\n      name: tool.name,\n      type: tool.type,\n      fallbackIcon: tool.icon ?? (tool.type === \"toolkit\" ? \"Package\" : \"Wrench\"),\n      description: tool.description,\n      visibleInScopes: new Set<string>(),\n    }));\n}\n\nexport const transformProvidedTools: SourceFn<ProvidedToolsConfig> = async (\n  context,\n) => ({\n  items: providedToolMenuItems(\n    context.sourceConfig.getTools(),\n    context.sourceConfig.type,\n  ),\n  pagination: { hasMore: false },\n});\n\n/**\n * Prepend a host's tool list to another source's items so a root query matches\n * them the way it matches assets (the cache filters by query and sorts\n * toolkits first). The wrapped source's offset bookkeeping is preserved:\n * `consumedCount` stays the number of rows the server returned, so the added\n * items never advance the next page's offset.\n */\nexport function withProvidedTools<TConfig>(\n  source: SourceFn<TConfig>,\n  getTools: () => readonly MentionTool[],\n): SourceFn<TConfig> {\n  return async (context) => {\n    const result = await source(context);\n    return {\n      ...result,\n      items: [...providedToolMenuItems(getTools()), ...result.items],\n      pagination: {\n        ...result.pagination,\n        hasMore: result.pagination?.hasMore ?? false,\n        consumedCount: result.pagination?.consumedCount ?? result.items.length,\n      },\n    };\n  };\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const MentionMenuSection = {
+  CURRENT_WEBPAGE: "current-webpage",
+  OTHER_WEBPAGES: "other-webpages",
+  LIBRARY: "library"
+};
+exports.MentionMenuSection = MentionMenuSection;
+//# sourceMappingURL=types.cjs.map

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

@@ -0,0 +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;;"}

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

@@ -154,3 +154,17 @@ export interface SourceContext<TConfig = any> {
  * State (pagination, sourceConfig) is stored externally in registry entry.
  */
 export type SourceFn<TConfig = any> = (context: SourceContext<TConfig>) => Promise<SourceResult>;
+/**
+ * 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
+ * those categories with its own (AthenaChat offers the toolkits its provider
+ * enabled, or whatever the host passes through `mentionTools`).
+ */
+export interface MentionTool {
+    id: string;
+    name: string;
+    description?: string;
+    /** Lucide icon name (`Package`, `Wrench`, …) or an emoji. */
+    icon?: string;
+    type: 'tool' | 'toolkit';
+}

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

@@ -0,0 +1,9 @@
+const MentionMenuSection = {
+  CURRENT_WEBPAGE: "current-webpage",
+  OTHER_WEBPAGES: "other-webpages",
+  LIBRARY: "library"
+};
+export {
+  MentionMenuSection
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +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;"}