@athenaintel/react 0.19.0 → 0.20.0

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

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const store = require("@tanstack/store");
+const react = require("react");
+const apiClient = require("./api-client.cjs");
+const itemCache = require("./item-cache.cjs");
+const scopeRegistry = require("./scope-registry.cjs");
+const index = require("./sources/index.cjs");
+function webpageMentionFingerprint(webpages) {
+  return JSON.stringify(
+    webpages.map(({ tabId, title, url, isCurrent }) => [
+      tabId,
+      title,
+      url,
+      isCurrent
+    ])
+  );
+}
+const ROOT_MENTION_CATEGORIES = [
+  "favorites",
+  "assets",
+  "projects",
+  "browse_profiles",
+  "folders",
+  "tools",
+  "toolkits",
+  "team",
+  "drives"
+];
+function providedToolsFingerprint(tools) {
+  return JSON.stringify(
+    tools.map(({ id, name, type, description, icon }) => [
+      id,
+      name,
+      type,
+      description ?? null,
+      icon ?? null
+    ])
+  );
+}
+function buildStore({
+  auth,
+  getWebpages,
+  getTools,
+  rootCategories
+}) {
+  const registry = scopeRegistry.createScopeRegistry();
+  const cache = itemCache.createItemCache();
+  scopeRegistry.registerSource(registry, "root", index.transformRootCategories, {
+    categories: [...rootCategories],
+    getWebpages
+  });
+  scopeRegistry.registerSource(
+    registry,
+    "global_search",
+    getTools ? index.withProvidedTools(index.fetchGlobalSearch, getTools) : index.fetchGlobalSearch,
+    { auth }
+  );
+  scopeRegistry.bindScopes(registry, "root", "global_search");
+  scopeRegistry.registerSource(registry, "athena_assets", index.fetchAssets, { auth, limit: 50 });
+  scopeRegistry.registerSource(registry, "favorites", index.fetchFavorites, { auth, limit: 50 });
+  scopeRegistry.registerSource(
+    registry,
+    "athena_folders",
+    index.fetchFolders,
+    { auth, limit: 50 },
+    true
+  );
+  scopeRegistry.registerSource(registry, "internal_drive", index.fetchFolderContents, {
+    auth,
+    limit: 50
+  });
+  scopeRegistry.registerSource(registry, "athena_projects", index.fetchTypedAssets, {
+    auth,
+    includeOnlyTypes: ["project"],
+    limit: 50
+  });
+  scopeRegistry.registerSource(registry, "athena_browse_profiles", index.fetchTypedAssets, {
+    auth,
+    includeOnlyTypes: ["browse_profile"],
+    limit: 50
+  });
+  if (getTools) {
+    scopeRegistry.registerSource(registry, "tools", index.transformProvidedTools, {
+      getTools,
+      type: "tool"
+    });
+    scopeRegistry.registerSource(registry, "toolkits", index.transformProvidedTools, {
+      getTools,
+      type: "toolkit"
+    });
+  } else {
+    scopeRegistry.registerSource(registry, "tools", index.fetchTools, { auth });
+    scopeRegistry.registerSource(registry, "toolkits", index.fetchToolkits, { auth });
+  }
+  scopeRegistry.registerSource(registry, "team", index.fetchTeam, { auth });
+  scopeRegistry.registerSource(registry, "drive_catalogs", index.fetchDrives, { auth });
+  return new store.Store({ registry, cache });
+}
+function useMentionSuggestions({
+  webpages,
+  tools,
+  rootCategories = ROOT_MENTION_CATEGORIES
+}) {
+  const auth = apiClient.useMentionAuth();
+  const webpagesRef = react.useRef(webpages);
+  webpagesRef.current = webpages;
+  const toolsRef = react.useRef(tools);
+  toolsRef.current = tools;
+  const hasProvidedTools = tools !== void 0;
+  const store2 = react.useMemo(
+    () => buildStore({
+      auth,
+      getWebpages: () => webpagesRef.current,
+      getTools: hasProvidedTools ? () => toolsRef.current ?? [] : void 0,
+      rootCategories
+    }),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+      auth.backendUrl,
+      auth.accessToken,
+      auth.apiKey,
+      auth.workspaceId,
+      auth.userId,
+      hasProvidedTools,
+      rootCategories.join(",")
+    ]
+  );
+  const invalidate = react.useMemo(
+    () => (scope) => {
+      const state = store2.state;
+      const { registry, cache } = state;
+      if (cache.items) {
+        for (const item of Object.values(cache.items)) {
+          item.visibleInScopes.delete(scope);
+        }
+        for (const [id, item] of Object.entries(cache.items)) {
+          if (item.visibleInScopes.size === 0) {
+            delete cache.items[id];
+          }
+        }
+      }
+      if (registry.entries[scope]) {
+        registry.entries[scope].fetchStates = {};
+      }
+      store2.setState((prev) => ({ ...prev }));
+    },
+    [store2]
+  );
+  const webpageFingerprint = webpageMentionFingerprint(webpages);
+  const previousWebpageFingerprintRef = react.useRef(null);
+  react.useEffect(() => {
+    if (previousWebpageFingerprintRef.current === webpageFingerprint) return;
+    previousWebpageFingerprintRef.current = webpageFingerprint;
+    invalidate("root");
+  }, [invalidate, webpageFingerprint]);
+  const toolsFingerprint = tools ? providedToolsFingerprint(tools) : null;
+  const previousToolsFingerprintRef = react.useRef(null);
+  react.useEffect(() => {
+    if (previousToolsFingerprintRef.current === toolsFingerprint) return;
+    previousToolsFingerprintRef.current = toolsFingerprint;
+    if (toolsFingerprint === null) return;
+    invalidate("tools");
+    invalidate("toolkits");
+    invalidate("global_search");
+  }, [invalidate, toolsFingerprint]);
+  return { store: store2, invalidate };
+}
+exports.ROOT_MENTION_CATEGORIES = ROOT_MENTION_CATEGORIES;
+exports.providedToolsFingerprint = providedToolsFingerprint;
+exports.useMentionSuggestions = useMentionSuggestions;
+exports.webpageMentionFingerprint = webpageMentionFingerprint;
+//# sourceMappingURL=use-mention-suggestions.cjs.map

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

@@ -0,0 +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.\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 { Store } from \"@tanstack/store\";\nimport { useEffect, useMemo, useRef } from \"react\";\nimport type { MentionAuthContext } from \"./api-client\";\nimport { useMentionAuth } from \"./api-client\";\nimport { createItemCache, type ItemCache } from \"./item-cache\";\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} 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\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}: {\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}): 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  // ── Global search (aggregated) ──\n  // A host's own tools ride along so a root query finds them beside assets.\n  registerSource(\n    registry,\n    \"global_search\",\n    getTools ? withProvidedTools(fetchGlobalSearch, getTools) : fetchGlobalSearch,\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 });\n\n  // ── Drives (catalogs) ──\n  registerSource(registry, \"drive_catalogs\", fetchDrives, { auth });\n\n  return new Store<MentionSuggestionsStoreState>({ registry, cache });\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}: {\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  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\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      }),\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  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","withProvidedTools","fetchGlobalSearch","bindScopes","fetchAssets","fetchFavorites","fetchFolders","fetchFolderContents","fetchTypedAssets","transformProvidedTools","fetchTools","fetchToolkits","fetchTeam","fetchDrives","Store","useMentionAuth","useRef","store","useMemo","useEffect"],"mappings":"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"}

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

@@ -1,17 +1,19 @@
 /**
- * Chrome Extension Mention Suggestions Store
+ * Mention Suggestions Store — shared by every Athena chat host (the Chrome
+ * side panel, the Office task pane, the SDK's AthenaChat).
  *
  * Full Olympus-style mention store with all categories:
  * Favorites, Assets, Projects, Browse Profiles, Folders,
  * current/group webpages, Team, Workspace, Drives + Global Search.
  *
  * Uses registry + cache architecture from Olympus with
- * async data fetching via GraphQL.
+ * async data fetching via GraphQL. A host may hand the Tools / Toolkits
+ * categories its own list instead of the server catalog (`tools`).
  */
 import { Store } from "@tanstack/store";
 import { type ItemCache } from "./item-cache";
 import { type ScopeRegistry } from "./scope-registry";
-import type { WebpageMention } from "./types";
+import type { MentionTool, WebpageMention } from "./types";
 export declare function webpageMentionFingerprint(webpages: readonly WebpageMention[]): string;
 export interface MentionSuggestionsStoreState {
     registry: ScopeRegistry;
@@ -23,12 +25,20 @@ export type MentionSuggestionsStore = Store<MentionSuggestionsStoreState>;
  */
 export declare const ROOT_MENTION_CATEGORIES: readonly ["favorites", "assets", "projects", "browse_profiles", "folders", "tools", "toolkits", "team", "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;
 /**
  * Creates a stable MentionSuggestionsStore.
  * Uses MentionAuthCtx for API credentials.
  */
-export declare function useMentionSuggestions({ webpages, rootCategories, }: {
+export declare function useMentionSuggestions({ webpages, tools, rootCategories, }: {
     webpages: readonly WebpageMention[];
+    /**
+     * Host-provided Tools / Toolkits candidates. When set (even empty) they
+     * replace the server tool catalog for those categories and join root
+     * search results; omitted, the categories fetch the catalog.
+     */
+    tools?: readonly MentionTool[];
     /** Categories shown at the top level; hosts can narrow the default set. */
     rootCategories?: readonly MentionRootCategory[];
 }): {

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

@@ -0,0 +1,173 @@
+import { Store } from "@tanstack/store";
+import { useRef, useMemo, useEffect } from "react";
+import { useMentionAuth } from "./api-client.js";
+import { createItemCache } from "./item-cache.js";
+import { registerSource, bindScopes, createScopeRegistry } from "./scope-registry.js";
+import { transformRootCategories, fetchGlobalSearch, withProvidedTools, fetchAssets, fetchFavorites, fetchFolders, fetchFolderContents, fetchTypedAssets, transformProvidedTools, fetchTools, fetchToolkits, fetchTeam, fetchDrives } from "./sources/index.js";
+function webpageMentionFingerprint(webpages) {
+  return JSON.stringify(
+    webpages.map(({ tabId, title, url, isCurrent }) => [
+      tabId,
+      title,
+      url,
+      isCurrent
+    ])
+  );
+}
+const ROOT_MENTION_CATEGORIES = [
+  "favorites",
+  "assets",
+  "projects",
+  "browse_profiles",
+  "folders",
+  "tools",
+  "toolkits",
+  "team",
+  "drives"
+];
+function providedToolsFingerprint(tools) {
+  return JSON.stringify(
+    tools.map(({ id, name, type, description, icon }) => [
+      id,
+      name,
+      type,
+      description ?? null,
+      icon ?? null
+    ])
+  );
+}
+function buildStore({
+  auth,
+  getWebpages,
+  getTools,
+  rootCategories
+}) {
+  const registry = createScopeRegistry();
+  const cache = createItemCache();
+  registerSource(registry, "root", transformRootCategories, {
+    categories: [...rootCategories],
+    getWebpages
+  });
+  registerSource(
+    registry,
+    "global_search",
+    getTools ? withProvidedTools(fetchGlobalSearch, getTools) : fetchGlobalSearch,
+    { auth }
+  );
+  bindScopes(registry, "root", "global_search");
+  registerSource(registry, "athena_assets", fetchAssets, { auth, limit: 50 });
+  registerSource(registry, "favorites", fetchFavorites, { auth, limit: 50 });
+  registerSource(
+    registry,
+    "athena_folders",
+    fetchFolders,
+    { auth, limit: 50 },
+    true
+  );
+  registerSource(registry, "internal_drive", fetchFolderContents, {
+    auth,
+    limit: 50
+  });
+  registerSource(registry, "athena_projects", fetchTypedAssets, {
+    auth,
+    includeOnlyTypes: ["project"],
+    limit: 50
+  });
+  registerSource(registry, "athena_browse_profiles", fetchTypedAssets, {
+    auth,
+    includeOnlyTypes: ["browse_profile"],
+    limit: 50
+  });
+  if (getTools) {
+    registerSource(registry, "tools", transformProvidedTools, {
+      getTools,
+      type: "tool"
+    });
+    registerSource(registry, "toolkits", transformProvidedTools, {
+      getTools,
+      type: "toolkit"
+    });
+  } else {
+    registerSource(registry, "tools", fetchTools, { auth });
+    registerSource(registry, "toolkits", fetchToolkits, { auth });
+  }
+  registerSource(registry, "team", fetchTeam, { auth });
+  registerSource(registry, "drive_catalogs", fetchDrives, { auth });
+  return new Store({ registry, cache });
+}
+function useMentionSuggestions({
+  webpages,
+  tools,
+  rootCategories = ROOT_MENTION_CATEGORIES
+}) {
+  const auth = useMentionAuth();
+  const webpagesRef = useRef(webpages);
+  webpagesRef.current = webpages;
+  const toolsRef = useRef(tools);
+  toolsRef.current = tools;
+  const hasProvidedTools = tools !== void 0;
+  const store = useMemo(
+    () => buildStore({
+      auth,
+      getWebpages: () => webpagesRef.current,
+      getTools: hasProvidedTools ? () => toolsRef.current ?? [] : void 0,
+      rootCategories
+    }),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+      auth.backendUrl,
+      auth.accessToken,
+      auth.apiKey,
+      auth.workspaceId,
+      auth.userId,
+      hasProvidedTools,
+      rootCategories.join(",")
+    ]
+  );
+  const invalidate = useMemo(
+    () => (scope) => {
+      const state = store.state;
+      const { registry, cache } = state;
+      if (cache.items) {
+        for (const item of Object.values(cache.items)) {
+          item.visibleInScopes.delete(scope);
+        }
+        for (const [id, item] of Object.entries(cache.items)) {
+          if (item.visibleInScopes.size === 0) {
+            delete cache.items[id];
+          }
+        }
+      }
+      if (registry.entries[scope]) {
+        registry.entries[scope].fetchStates = {};
+      }
+      store.setState((prev) => ({ ...prev }));
+    },
+    [store]
+  );
+  const webpageFingerprint = webpageMentionFingerprint(webpages);
+  const previousWebpageFingerprintRef = useRef(null);
+  useEffect(() => {
+    if (previousWebpageFingerprintRef.current === webpageFingerprint) return;
+    previousWebpageFingerprintRef.current = webpageFingerprint;
+    invalidate("root");
+  }, [invalidate, webpageFingerprint]);
+  const toolsFingerprint = tools ? providedToolsFingerprint(tools) : null;
+  const previousToolsFingerprintRef = useRef(null);
+  useEffect(() => {
+    if (previousToolsFingerprintRef.current === toolsFingerprint) return;
+    previousToolsFingerprintRef.current = toolsFingerprint;
+    if (toolsFingerprint === null) return;
+    invalidate("tools");
+    invalidate("toolkits");
+    invalidate("global_search");
+  }, [invalidate, toolsFingerprint]);
+  return { store, invalidate };
+}
+export {
+  ROOT_MENTION_CATEGORIES,
+  providedToolsFingerprint,
+  useMentionSuggestions,
+  webpageMentionFingerprint
+};
+//# sourceMappingURL=use-mention-suggestions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-mention-suggestions.js","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.\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 { Store } from \"@tanstack/store\";\nimport { useEffect, useMemo, useRef } from \"react\";\nimport type { MentionAuthContext } from \"./api-client\";\nimport { useMentionAuth } from \"./api-client\";\nimport { createItemCache, type ItemCache } from \"./item-cache\";\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} 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\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}: {\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}): 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  // ── Global search (aggregated) ──\n  // A host's own tools ride along so a root query finds them beside assets.\n  registerSource(\n    registry,\n    \"global_search\",\n    getTools ? withProvidedTools(fetchGlobalSearch, getTools) : fetchGlobalSearch,\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 });\n\n  // ── Drives (catalogs) ──\n  registerSource(registry, \"drive_catalogs\", fetchDrives, { auth });\n\n  return new Store<MentionSuggestionsStoreState>({ registry, cache });\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}: {\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  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\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      }),\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  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":[],"mappings":"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"}

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

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const reactStore = require("@tanstack/react-store");
+const react = require("react");
+const orchestrator = require("./orchestrator.cjs");
+function useMenuItems(store, options) {
+  const { scope, query = "", minItems = 50, parentScope } = options;
+  const [targetCount, setTargetCount] = react.useState(minItems);
+  react.useEffect(() => {
+    setTargetCount(minItems);
+  }, [scope, query, minItems]);
+  const snapshot = reactStore.useStore(
+    store,
+    () => orchestrator.selectItems(store, scope, query, targetCount, parentScope)
+  );
+  react.useEffect(() => {
+    if (snapshot.items.length < targetCount && snapshot.hasMore && !snapshot.isFetching) {
+      orchestrator.triggerFetchIfNeeded(store, scope, query, targetCount, parentScope);
+    }
+  }, [
+    store,
+    scope,
+    query,
+    targetCount,
+    parentScope,
+    snapshot.items.length,
+    snapshot.hasMore,
+    snapshot.isFetching
+  ]);
+  const loadMore = () => {
+    if (snapshot.hasMore && !snapshot.isFetching) {
+      setTargetCount((prev) => prev + 50);
+    }
+  };
+  return {
+    items: snapshot.items,
+    isFetching: snapshot.isFetching,
+    hasMore: snapshot.hasMore,
+    loadMore,
+    targetCount
+    // Expose for debugging
+  };
+}
+exports.useMenuItems = useMenuItems;
+//# sourceMappingURL=use-menu-items.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-menu-items.cjs","sources":["../../../../../src/chat-ui/mentions/suggestions/data/use-menu-items.ts"],"sourcesContent":["import { useStore } from '@tanstack/react-store';\nimport { useEffect, useState } from 'react';\nimport { selectItems, triggerFetchIfNeeded } from './orchestrator';\nimport type { MenuItem, MenuScope } from './types';\nimport type { MentionSuggestionsStore } from './use-mention-suggestions';\n\n/**\n * useMenuItems - Like React Query, but for menu items\n *\n * Clean, automatic hook that:\n * - Reads items from store (reactive!)\n * - Auto-fetches if needed (in useEffect)\n * - Returns clean interface { items, isFetching, hasMore }\n *\n * Usage:\n * ```typescript\n * const { items, isFetching, hasMore } = useMenuItems(store, {\n *   scope: 'athena_folders',\n *   query: 'doc',\n *   minItems: 10,\n *   parentScope: 'root'\n * });\n * ```\n */\nexport interface UseMenuItemsOptions {\n  scope: MenuScope;\n  query?: string;\n  minItems?: number;\n  parentScope?: MenuScope;\n}\n\nexport interface UseMenuItemsResult {\n  items: MenuItem[];\n  isFetching: boolean;\n  hasMore: boolean;\n  loadMore: () => void; // Explicit load more (not automatic!)\n  targetCount: number; // Current target for debugging\n}\n\nexport function useMenuItems(\n  store: MentionSuggestionsStore,\n  options: UseMenuItemsOptions\n): UseMenuItemsResult {\n  const { scope, query = '', minItems = 50, parentScope } = options;\n\n  // Target item count (increases when user clicks \"Load More\")\n  const [targetCount, setTargetCount] = useState(minItems);\n\n  // Reset target when scope/query changes\n  // biome-ignore lint/correctness/useExhaustiveDependencies: We intentionally reset on scope/query change\n  useEffect(() => {\n    setTargetCount(minItems);\n  }, [scope, query, minItems]);\n\n  // Read from store (pure, reactive)\n  const snapshot = useStore(store, () =>\n    selectItems(store, scope, query, targetCount, parentScope)\n  );\n\n  // Auto-fetch when: cached < target AND hasMore AND !fetching\n  useEffect(() => {\n    if (snapshot.items.length < targetCount && snapshot.hasMore && !snapshot.isFetching) {\n      triggerFetchIfNeeded(store, scope, query, targetCount, parentScope);\n    }\n  }, [\n    store,\n    scope,\n    query,\n    targetCount,\n    parentScope,\n    snapshot.items.length,\n    snapshot.hasMore,\n    snapshot.isFetching,\n  ]);\n\n  // Explicit load more: Increase target by 50\n  const loadMore = () => {\n    if (snapshot.hasMore && !snapshot.isFetching) {\n      setTargetCount((prev) => prev + 50);\n    }\n  };\n\n  return {\n    items: snapshot.items,\n    isFetching: snapshot.isFetching,\n    hasMore: snapshot.hasMore,\n    loadMore,\n    targetCount, // Expose for debugging\n  };\n}\n"],"names":["useState","useEffect","useStore","selectItems","triggerFetchIfNeeded"],"mappings":";;;;;AAuCO,SAAS,aACd,OACA,SACoB;AACpB,QAAM,EAAE,OAAO,QAAQ,IAAI,WAAW,IAAI,gBAAgB;AAG1D,QAAM,CAAC,aAAa,cAAc,IAAIA,MAAAA,SAAS,QAAQ;AAIvDC,QAAAA,UAAU,MAAM;AACd,mBAAe,QAAQ;AAAA,EACzB,GAAG,CAAC,OAAO,OAAO,QAAQ,CAAC;AAG3B,QAAM,WAAWC,WAAAA;AAAAA,IAAS;AAAA,IAAO,MAC/BC,aAAAA,YAAY,OAAO,OAAO,OAAO,aAAa,WAAW;AAAA,EAAA;AAI3DF,QAAAA,UAAU,MAAM;AACd,QAAI,SAAS,MAAM,SAAS,eAAe,SAAS,WAAW,CAAC,SAAS,YAAY;AACnFG,mBAAAA,qBAAqB,OAAO,OAAO,OAAO,aAAa,WAAW;AAAA,IACpE;AAAA,EACF,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,MAAM;AAAA,IACf,SAAS;AAAA,IACT,SAAS;AAAA,EAAA,CACV;AAGD,QAAM,WAAW,MAAM;AACrB,QAAI,SAAS,WAAW,CAAC,SAAS,YAAY;AAC5C,qBAAe,CAAC,SAAS,OAAO,EAAE;AAAA,IACpC;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,SAAS;AAAA,IAChB,YAAY,SAAS;AAAA,IACrB,SAAS,SAAS;AAAA,IAClB;AAAA,IACA;AAAA;AAAA,EAAA;AAEJ;;"}

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

@@ -0,0 +1,45 @@
+import { useStore } from "@tanstack/react-store";
+import { useState, useEffect } from "react";
+import { selectItems, triggerFetchIfNeeded } from "./orchestrator.js";
+function useMenuItems(store, options) {
+  const { scope, query = "", minItems = 50, parentScope } = options;
+  const [targetCount, setTargetCount] = useState(minItems);
+  useEffect(() => {
+    setTargetCount(minItems);
+  }, [scope, query, minItems]);
+  const snapshot = useStore(
+    store,
+    () => selectItems(store, scope, query, targetCount, parentScope)
+  );
+  useEffect(() => {
+    if (snapshot.items.length < targetCount && snapshot.hasMore && !snapshot.isFetching) {
+      triggerFetchIfNeeded(store, scope, query, targetCount, parentScope);
+    }
+  }, [
+    store,
+    scope,
+    query,
+    targetCount,
+    parentScope,
+    snapshot.items.length,
+    snapshot.hasMore,
+    snapshot.isFetching
+  ]);
+  const loadMore = () => {
+    if (snapshot.hasMore && !snapshot.isFetching) {
+      setTargetCount((prev) => prev + 50);
+    }
+  };
+  return {
+    items: snapshot.items,
+    isFetching: snapshot.isFetching,
+    hasMore: snapshot.hasMore,
+    loadMore,
+    targetCount
+    // Expose for debugging
+  };
+}
+export {
+  useMenuItems
+};
+//# sourceMappingURL=use-menu-items.js.map

package/dist/chat-ui/mentions/suggestions/data/use-menu-items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-menu-items.js","sources":["../../../../../src/chat-ui/mentions/suggestions/data/use-menu-items.ts"],"sourcesContent":["import { useStore } from '@tanstack/react-store';\nimport { useEffect, useState } from 'react';\nimport { selectItems, triggerFetchIfNeeded } from './orchestrator';\nimport type { MenuItem, MenuScope } from './types';\nimport type { MentionSuggestionsStore } from './use-mention-suggestions';\n\n/**\n * useMenuItems - Like React Query, but for menu items\n *\n * Clean, automatic hook that:\n * - Reads items from store (reactive!)\n * - Auto-fetches if needed (in useEffect)\n * - Returns clean interface { items, isFetching, hasMore }\n *\n * Usage:\n * ```typescript\n * const { items, isFetching, hasMore } = useMenuItems(store, {\n *   scope: 'athena_folders',\n *   query: 'doc',\n *   minItems: 10,\n *   parentScope: 'root'\n * });\n * ```\n */\nexport interface UseMenuItemsOptions {\n  scope: MenuScope;\n  query?: string;\n  minItems?: number;\n  parentScope?: MenuScope;\n}\n\nexport interface UseMenuItemsResult {\n  items: MenuItem[];\n  isFetching: boolean;\n  hasMore: boolean;\n  loadMore: () => void; // Explicit load more (not automatic!)\n  targetCount: number; // Current target for debugging\n}\n\nexport function useMenuItems(\n  store: MentionSuggestionsStore,\n  options: UseMenuItemsOptions\n): UseMenuItemsResult {\n  const { scope, query = '', minItems = 50, parentScope } = options;\n\n  // Target item count (increases when user clicks \"Load More\")\n  const [targetCount, setTargetCount] = useState(minItems);\n\n  // Reset target when scope/query changes\n  // biome-ignore lint/correctness/useExhaustiveDependencies: We intentionally reset on scope/query change\n  useEffect(() => {\n    setTargetCount(minItems);\n  }, [scope, query, minItems]);\n\n  // Read from store (pure, reactive)\n  const snapshot = useStore(store, () =>\n    selectItems(store, scope, query, targetCount, parentScope)\n  );\n\n  // Auto-fetch when: cached < target AND hasMore AND !fetching\n  useEffect(() => {\n    if (snapshot.items.length < targetCount && snapshot.hasMore && !snapshot.isFetching) {\n      triggerFetchIfNeeded(store, scope, query, targetCount, parentScope);\n    }\n  }, [\n    store,\n    scope,\n    query,\n    targetCount,\n    parentScope,\n    snapshot.items.length,\n    snapshot.hasMore,\n    snapshot.isFetching,\n  ]);\n\n  // Explicit load more: Increase target by 50\n  const loadMore = () => {\n    if (snapshot.hasMore && !snapshot.isFetching) {\n      setTargetCount((prev) => prev + 50);\n    }\n  };\n\n  return {\n    items: snapshot.items,\n    isFetching: snapshot.isFetching,\n    hasMore: snapshot.hasMore,\n    loadMore,\n    targetCount, // Expose for debugging\n  };\n}\n"],"names":[],"mappings":";;;AAuCO,SAAS,aACd,OACA,SACoB;AACpB,QAAM,EAAE,OAAO,QAAQ,IAAI,WAAW,IAAI,gBAAgB;AAG1D,QAAM,CAAC,aAAa,cAAc,IAAI,SAAS,QAAQ;AAIvD,YAAU,MAAM;AACd,mBAAe,QAAQ;AAAA,EACzB,GAAG,CAAC,OAAO,OAAO,QAAQ,CAAC;AAG3B,QAAM,WAAW;AAAA,IAAS;AAAA,IAAO,MAC/B,YAAY,OAAO,OAAO,OAAO,aAAa,WAAW;AAAA,EAAA;AAI3D,YAAU,MAAM;AACd,QAAI,SAAS,MAAM,SAAS,eAAe,SAAS,WAAW,CAAC,SAAS,YAAY;AACnF,2BAAqB,OAAO,OAAO,OAAO,aAAa,WAAW;AAAA,IACpE;AAAA,EACF,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,MAAM;AAAA,IACf,SAAS;AAAA,IACT,SAAS;AAAA,EAAA,CACV;AAGD,QAAM,WAAW,MAAM;AACrB,QAAI,SAAS,WAAW,CAAC,SAAS,YAAY;AAC5C,qBAAe,CAAC,SAAS,OAAO,EAAE;AAAA,IACpC;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,SAAS;AAAA,IAChB,YAAY,SAAS;AAAA,IACrB,SAAS,SAAS;AAAA,IAClB;AAAA,IACA;AAAA;AAAA,EAAA;AAEJ;"}

package/dist/chat-ui/mentions/suggestions/data/utils/filter-items.cjs

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const matchQuery = require("./match-query.cjs");
+const scoreMatch = require("./score-match.cjs");
+function matchesItemId(itemId, query) {
+  if (!query || !itemId) return false;
+  const normalizedId = itemId.toLowerCase();
+  return normalizedId.includes(query);
+}
+function filterItems(items, query, _scope) {
+  if (!items || items.length === 0) return [];
+  const normalizedQuery = query.toLowerCase().trim();
+  if (!normalizedQuery) {
+    return items;
+  }
+  const filteredResults = items.filter(
+    (item) => matchQuery.matchesMultiWordQuery(item.name, normalizedQuery) || matchesItemId(item.id, normalizedQuery)
+  );
+  if (filteredResults.length > 0) {
+    filteredResults.sort((a, b) => {
+      const aIsToolkit = a.type === "toolkit";
+      const bIsToolkit = b.type === "toolkit";
+      if (aIsToolkit && !bIsToolkit) return -1;
+      if (!aIsToolkit && bIsToolkit) return 1;
+      const aIdMatch = matchesItemId(a.id, normalizedQuery);
+      const bIdMatch = matchesItemId(b.id, normalizedQuery);
+      if (aIdMatch && !bIdMatch) return -1;
+      if (!aIdMatch && bIdMatch) return 1;
+      if (aIdMatch && bIdMatch) {
+        const aIdScore = a.id.toLowerCase() === normalizedQuery ? 100 : Math.min(normalizedQuery.length / a.id.length * 50, 50);
+        const bIdScore = b.id.toLowerCase() === normalizedQuery ? 100 : Math.min(normalizedQuery.length / b.id.length * 50, 50);
+        if (aIdScore !== bIdScore) return bIdScore - aIdScore;
+      }
+      const aScore = scoreMatch.getMatchScore(a.name, normalizedQuery);
+      const bScore = scoreMatch.getMatchScore(b.name, normalizedQuery);
+      if (aScore !== bScore) return bScore - aScore;
+      return a.name.toLowerCase().localeCompare(b.name.toLowerCase());
+    });
+  }
+  return filteredResults;
+}
+exports.filterItems = filterItems;
+//# sourceMappingURL=filter-items.cjs.map

package/dist/chat-ui/mentions/suggestions/data/utils/filter-items.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-items.cjs","sources":["../../../../../../src/chat-ui/mentions/suggestions/data/utils/filter-items.ts"],"sourcesContent":["import type { MenuItem } from '../types';\nimport { matchesMultiWordQuery } from './match-query';\nimport { getMatchScore } from './score-match';\n\n/**\n * Checks if a query matches an item's ID.\n * This enables looking up assets by their ID (e.g., \"asset_41c91b2d-901f-4844-bdda-f74b9863ba5c\").\n *\n * @param itemId - The item's ID\n * @param query - The normalized search query\n * @returns true if the query matches the item ID\n */\nfunction matchesItemId(itemId: string, query: string): boolean {\n  if (!query || !itemId) return false;\n\n  const normalizedId: string = itemId.toLowerCase();\n\n  // Check if the query is contained in the ID\n  // This allows partial ID matching (e.g., typing part of a UUID)\n  return normalizedId.includes(query);\n}\n\n/**\n * Filter items by query match and sort by relevance\n *\n * Note: Items are already filtered by scope in getFilteredItems()\n * This function only handles query matching and scoring.\n *\n * @param items - Items already filtered by scope\n * @param query - Search query text\n * @param _scope - Current scope (unused, kept for signature compatibility)\n * @returns Filtered and sorted items\n */\nexport function filterItems(items: MenuItem[], query: string, _scope: string): MenuItem[] {\n  if (!items || items.length === 0) return [];\n\n  const normalizedQuery: string = query.toLowerCase().trim();\n\n  // No query? Return all items (already scope-filtered)\n  if (!normalizedQuery) {\n    return items;\n  }\n\n  // Filter by query match (name OR ID)\n  const filteredResults: MenuItem[] = items.filter(\n    (item) =>\n      matchesMultiWordQuery(item.name, normalizedQuery) || matchesItemId(item.id, normalizedQuery)\n  );\n\n  // Sort by match score\n  if (filteredResults.length > 0) {\n    filteredResults.sort((a, b) => {\n      // Prioritize toolkits at the top of search results\n      const aIsToolkit = a.type === 'toolkit';\n      const bIsToolkit = b.type === 'toolkit';\n      if (aIsToolkit && !bIsToolkit) return -1;\n      if (!aIsToolkit && bIsToolkit) return 1;\n\n      // Prioritize exact ID matches\n      const aIdMatch: boolean = matchesItemId(a.id, normalizedQuery);\n      const bIdMatch: boolean = matchesItemId(b.id, normalizedQuery);\n\n      // If one has ID match and other doesn't, prioritize ID match\n      if (aIdMatch && !bIdMatch) return -1;\n      if (!aIdMatch && bIdMatch) return 1;\n\n      // If both have ID matches, sort by how closely the ID matches\n      // Use ratio-based scoring for better match quality differentiation\n      if (aIdMatch && bIdMatch) {\n        const aIdScore: number =\n          a.id.toLowerCase() === normalizedQuery\n            ? 100\n            : Math.min((normalizedQuery.length / a.id.length) * 50, 50);\n        const bIdScore: number =\n          b.id.toLowerCase() === normalizedQuery\n            ? 100\n            : Math.min((normalizedQuery.length / b.id.length) * 50, 50);\n        if (aIdScore !== bIdScore) return bIdScore - aIdScore;\n      }\n\n      // Fall back to name-based scoring\n      const aScore: number = getMatchScore(a.name, normalizedQuery);\n      const bScore: number = getMatchScore(b.name, normalizedQuery);\n\n      // Sort by score descending, then alphabetically\n      if (aScore !== bScore) return bScore - aScore;\n      return a.name.toLowerCase().localeCompare(b.name.toLowerCase());\n    });\n  }\n\n  return filteredResults;\n}\n"],"names":["matchesMultiWordQuery","getMatchScore"],"mappings":";;;;AAYA,SAAS,cAAc,QAAgB,OAAwB;AAC7D,MAAI,CAAC,SAAS,CAAC,OAAQ,QAAO;AAE9B,QAAM,eAAuB,OAAO,YAAA;AAIpC,SAAO,aAAa,SAAS,KAAK;AACpC;AAaO,SAAS,YAAY,OAAmB,OAAe,QAA4B;AACxF,MAAI,CAAC,SAAS,MAAM,WAAW,UAAU,CAAA;AAEzC,QAAM,kBAA0B,MAAM,YAAA,EAAc,KAAA;AAGpD,MAAI,CAAC,iBAAiB;AACpB,WAAO;AAAA,EACT;AAGA,QAAM,kBAA8B,MAAM;AAAA,IACxC,CAAC,SACCA,iCAAsB,KAAK,MAAM,eAAe,KAAK,cAAc,KAAK,IAAI,eAAe;AAAA,EAAA;AAI/F,MAAI,gBAAgB,SAAS,GAAG;AAC9B,oBAAgB,KAAK,CAAC,GAAG,MAAM;AAE7B,YAAM,aAAa,EAAE,SAAS;AAC9B,YAAM,aAAa,EAAE,SAAS;AAC9B,UAAI,cAAc,CAAC,WAAY,QAAO;AACtC,UAAI,CAAC,cAAc,WAAY,QAAO;AAGtC,YAAM,WAAoB,cAAc,EAAE,IAAI,eAAe;AAC7D,YAAM,WAAoB,cAAc,EAAE,IAAI,eAAe;AAG7D,UAAI,YAAY,CAAC,SAAU,QAAO;AAClC,UAAI,CAAC,YAAY,SAAU,QAAO;AAIlC,UAAI,YAAY,UAAU;AACxB,cAAM,WACJ,EAAE,GAAG,YAAA,MAAkB,kBACnB,MACA,KAAK,IAAK,gBAAgB,SAAS,EAAE,GAAG,SAAU,IAAI,EAAE;AAC9D,cAAM,WACJ,EAAE,GAAG,YAAA,MAAkB,kBACnB,MACA,KAAK,IAAK,gBAAgB,SAAS,EAAE,GAAG,SAAU,IAAI,EAAE;AAC9D,YAAI,aAAa,SAAU,QAAO,WAAW;AAAA,MAC/C;AAGA,YAAM,SAAiBC,WAAAA,cAAc,EAAE,MAAM,eAAe;AAC5D,YAAM,SAAiBA,WAAAA,cAAc,EAAE,MAAM,eAAe;AAG5D,UAAI,WAAW,OAAQ,QAAO,SAAS;AACvC,aAAO,EAAE,KAAK,YAAA,EAAc,cAAc,EAAE,KAAK,aAAa;AAAA,IAChE,CAAC;AAAA,EACH;AAEA,SAAO;AACT;;"}

package/dist/chat-ui/mentions/suggestions/data/utils/filter-items.js

@@ -0,0 +1,43 @@
+import { matchesMultiWordQuery } from "./match-query.js";
+import { getMatchScore } from "./score-match.js";
+function matchesItemId(itemId, query) {
+  if (!query || !itemId) return false;
+  const normalizedId = itemId.toLowerCase();
+  return normalizedId.includes(query);
+}
+function filterItems(items, query, _scope) {
+  if (!items || items.length === 0) return [];
+  const normalizedQuery = query.toLowerCase().trim();
+  if (!normalizedQuery) {
+    return items;
+  }
+  const filteredResults = items.filter(
+    (item) => matchesMultiWordQuery(item.name, normalizedQuery) || matchesItemId(item.id, normalizedQuery)
+  );
+  if (filteredResults.length > 0) {
+    filteredResults.sort((a, b) => {
+      const aIsToolkit = a.type === "toolkit";
+      const bIsToolkit = b.type === "toolkit";
+      if (aIsToolkit && !bIsToolkit) return -1;
+      if (!aIsToolkit && bIsToolkit) return 1;
+      const aIdMatch = matchesItemId(a.id, normalizedQuery);
+      const bIdMatch = matchesItemId(b.id, normalizedQuery);
+      if (aIdMatch && !bIdMatch) return -1;
+      if (!aIdMatch && bIdMatch) return 1;
+      if (aIdMatch && bIdMatch) {
+        const aIdScore = a.id.toLowerCase() === normalizedQuery ? 100 : Math.min(normalizedQuery.length / a.id.length * 50, 50);
+        const bIdScore = b.id.toLowerCase() === normalizedQuery ? 100 : Math.min(normalizedQuery.length / b.id.length * 50, 50);
+        if (aIdScore !== bIdScore) return bIdScore - aIdScore;
+      }
+      const aScore = getMatchScore(a.name, normalizedQuery);
+      const bScore = getMatchScore(b.name, normalizedQuery);
+      if (aScore !== bScore) return bScore - aScore;
+      return a.name.toLowerCase().localeCompare(b.name.toLowerCase());
+    });
+  }
+  return filteredResults;
+}
+export {
+  filterItems
+};
+//# sourceMappingURL=filter-items.js.map