@jazzmind/busibox-app 3.0.18

package/dist/lib/search/client.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Search API Client for busibox-app
+ *
+ * Unified client for all search-api capabilities:
+ * - Web search (Tavily, DuckDuckGo, Perplexity, Bing, etc.)
+ * - Document search (BM25 keyword, vector semantic, hybrid, MMR)
+ * - Chat insights (Milvus vector store - see insights/client.ts)
+ *
+ * Replaces direct provider SDK integrations and Milvus client.
+ */
+import 'server-only';
+export interface WebSearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+    score?: number;
+    publishedDate?: string;
+    domain?: string;
+}
+export interface WebSearchResponse {
+    query: string;
+    results: WebSearchResult[];
+    provider: string;
+    timestamp: string;
+    metadata?: Record<string, any>;
+}
+export interface WebSearchOptions {
+    provider?: string;
+    maxResults?: number;
+    searchDepth?: 'basic' | 'advanced';
+    includeAnswer?: boolean;
+    includeDomains?: string[];
+    excludeDomains?: string[];
+}
+export interface DocumentSearchResult {
+    id: string;
+    fileId: string;
+    documentId: string;
+    chunkId: string;
+    text: string;
+    markdown?: string;
+    score: number;
+    highlights?: string[];
+    metadata?: {
+        filename?: string;
+        page?: number;
+        section?: string;
+        [key: string]: any;
+    };
+    semanticAlignment?: {
+        query: string;
+        document: string;
+        similarity: number;
+        matchedSpans: Array<{
+            start: number;
+            end: number;
+            score: number;
+        }>;
+    };
+}
+export interface DocumentSearchResponse {
+    query: string;
+    results: DocumentSearchResult[];
+    mode: 'keyword' | 'semantic' | 'hybrid' | 'mmr';
+    totalResults: number;
+    executionTimeMs: number;
+    metadata?: {
+        reranked?: boolean;
+        rerankerModel?: string;
+        fusionMethod?: string;
+        [key: string]: any;
+    };
+}
+export interface DocumentSearchOptions {
+    mode?: 'keyword' | 'semantic' | 'hybrid' | 'mmr';
+    limit?: number;
+    offset?: number;
+    useReranker?: boolean;
+    rerankerModel?: 'qwen3-gpu' | 'baai-gpu' | 'baai-cpu' | 'none';
+    enableHighlighting?: boolean;
+    highlightFragmentSize?: number;
+    enableSemanticAlignment?: boolean;
+    semanticAlignmentTopK?: number;
+    diversityLambda?: number;
+    fileIds?: string[];
+    documentIds?: string[];
+    partitions?: string[];
+}
+export interface TokenManager {
+    getAuthzToken(audience: string, scopes: string[]): Promise<string>;
+}
+export interface ProviderStatus {
+    provider_name: string;
+    is_configured: boolean;
+    is_enabled: boolean;
+    status: string;
+}
+/**
+ * Perform web search using search-api
+ *
+ * @param query - Search query
+ * @param options - Search options including provider selection
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Search response with results
+ */
+export declare function searchWeb(query: string, options?: WebSearchOptions, tokenManager?: TokenManager): Promise<WebSearchResponse>;
+/**
+ * Get available web search providers
+ *
+ * @param tokenManager - Optional token manager for authentication
+ * @returns List of available provider names
+ */
+export declare function getAvailableProviders(tokenManager?: TokenManager): Promise<string[]>;
+/**
+ * Get provider status
+ *
+ * @param provider - Provider name
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Provider status information
+ */
+export declare function getProviderStatus(provider: string, tokenManager?: TokenManager): Promise<ProviderStatus>;
+/**
+ * Search documents using search-api
+ *
+ * Supports multiple search modes:
+ * - keyword: BM25 full-text search (fast, exact matching)
+ * - semantic: Vector similarity search (understands meaning)
+ * - hybrid: Combined keyword + semantic with RRF fusion (recommended)
+ * - mmr: Maximal Marginal Relevance for diverse results
+ *
+ * @param query - Search query
+ * @param options - Search options
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Search response with results
+ */
+export declare function searchDocuments(query: string, options?: DocumentSearchOptions, tokenManager?: TokenManager): Promise<DocumentSearchResponse>;
+/**
+ * Keyword search (BM25 only)
+ *
+ * Fast full-text search with exact term matching.
+ * Best for technical terms, codes, IDs, and known phrases.
+ *
+ * @param query - Search query
+ * @param options - Search options
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Search response with results
+ */
+export declare function searchKeyword(query: string, options?: Omit<DocumentSearchOptions, 'mode'>, tokenManager?: TokenManager): Promise<DocumentSearchResponse>;
+/**
+ * Semantic search (vector only)
+ *
+ * Dense vector similarity search using embeddings.
+ * Understands meaning and context beyond exact keywords.
+ * Best for conceptual queries and natural language questions.
+ *
+ * @param query - Search query
+ * @param options - Search options
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Search response with results
+ */
+export declare function searchSemantic(query: string, options?: Omit<DocumentSearchOptions, 'mode'>, tokenManager?: TokenManager): Promise<DocumentSearchResponse>;
+/**
+ * Hybrid search (keyword + semantic with RRF fusion)
+ *
+ * Combines BM25 keyword search and vector semantic search.
+ * Provides best of both worlds - exact matching and semantic understanding.
+ * Recommended for most use cases.
+ *
+ * @param query - Search query
+ * @param options - Search options
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Search response with results
+ */
+export declare function searchHybrid(query: string, options?: Omit<DocumentSearchOptions, 'mode'>, tokenManager?: TokenManager): Promise<DocumentSearchResponse>;
+/**
+ * MMR search (Maximal Marginal Relevance)
+ *
+ * Returns diverse results by balancing relevance and diversity.
+ * Useful for exploratory search and avoiding redundant results.
+ *
+ * @param query - Search query
+ * @param options - Search options (diversityLambda: 0.0 = max diversity, 1.0 = max relevance)
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Search response with results
+ */
+export declare function searchMMR(query: string, options?: Omit<DocumentSearchOptions, 'mode'>, tokenManager?: TokenManager): Promise<DocumentSearchResponse>;
+/**
+ * Get semantic alignment for a query and document
+ *
+ * Visualizes query-document similarity with matched spans.
+ * Useful for understanding why a document matched a query.
+ *
+ * @param query - Search query
+ * @param documentId - Document ID
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Semantic alignment data
+ */
+export declare function getSemanticAlignment(query: string, documentId: string, tokenManager?: TokenManager): Promise<{
+    query: string;
+    document: string;
+    similarity: number;
+    matchedSpans: Array<{
+        start: number;
+        end: number;
+        score: number;
+    }>;
+}>;
+/**
+ * Check search-api health
+ *
+ * @returns true if service is healthy
+ */
+export declare function checkSearchHealth(): Promise<boolean>;
+//# sourceMappingURL=client.d.ts.map

package/dist/lib/search/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/lib/search/client.ts"],"names":[],"mappings":"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"}

package/dist/lib/search/client.js

@@ -0,0 +1,289 @@
+/**
+ * Search API Client for busibox-app
+ *
+ * Unified client for all search-api capabilities:
+ * - Web search (Tavily, DuckDuckGo, Perplexity, Bing, etc.)
+ * - Document search (BM25 keyword, vector semantic, hybrid, MMR)
+ * - Chat insights (Milvus vector store - see insights/client.ts)
+ *
+ * Replaces direct provider SDK integrations and Milvus client.
+ */
+import 'server-only';
+// ============================================================================
+// Configuration
+// ============================================================================
+const SEARCH_API_URL = process.env.SEARCH_API_URL || process.env.NEXT_PUBLIC_SEARCH_API_URL || 'http://localhost:8001';
+// ============================================================================
+// Web Search Functions
+// ============================================================================
+/**
+ * Perform web search using search-api
+ *
+ * @param query - Search query
+ * @param options - Search options including provider selection
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Search response with results
+ */
+export async function searchWeb(query, options, tokenManager) {
+    let headers = {
+        'Content-Type': 'application/json',
+    };
+    if (tokenManager) {
+        try {
+            const token = await tokenManager.getAuthzToken('search-api', []);
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        catch (error) {
+            console.warn('[searchWeb] Failed to get auth token, proceeding without auth:', error);
+        }
+    }
+    const requestBody = {
+        query,
+        provider: options?.provider,
+        max_results: options?.maxResults || 5,
+        search_depth: options?.searchDepth || 'basic',
+        include_answer: options?.includeAnswer ?? false,
+        include_domains: options?.includeDomains,
+        exclude_domains: options?.excludeDomains,
+    };
+    const response = await fetch(`${SEARCH_API_URL}/web-search`, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(requestBody),
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({ detail: response.statusText }));
+        throw new Error(`Web search failed: ${error.detail || response.statusText}`);
+    }
+    return response.json();
+}
+/**
+ * Get available web search providers
+ *
+ * @param tokenManager - Optional token manager for authentication
+ * @returns List of available provider names
+ */
+export async function getAvailableProviders(tokenManager) {
+    let headers = {};
+    if (tokenManager) {
+        try {
+            const token = await tokenManager.getAuthzToken('search-api', []);
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        catch (error) {
+            console.warn('[getAvailableProviders] Failed to get auth token:', error);
+        }
+    }
+    const response = await fetch(`${SEARCH_API_URL}/web-search/providers`, {
+        headers,
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get providers: ${response.statusText}`);
+    }
+    const providers = await response.json();
+    return providers
+        .filter((p) => p.is_enabled && p.is_configured)
+        .map((p) => p.provider_name);
+}
+/**
+ * Get provider status
+ *
+ * @param provider - Provider name
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Provider status information
+ */
+export async function getProviderStatus(provider, tokenManager) {
+    let headers = {};
+    if (tokenManager) {
+        try {
+            const token = await tokenManager.getAuthzToken('search-api', []);
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        catch (error) {
+            console.warn('[getProviderStatus] Failed to get auth token:', error);
+        }
+    }
+    const response = await fetch(`${SEARCH_API_URL}/web-search/providers/${provider}`, {
+        headers,
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get provider status: ${response.statusText}`);
+    }
+    return response.json();
+}
+// ============================================================================
+// Document Search Functions
+// ============================================================================
+/**
+ * Search documents using search-api
+ *
+ * Supports multiple search modes:
+ * - keyword: BM25 full-text search (fast, exact matching)
+ * - semantic: Vector similarity search (understands meaning)
+ * - hybrid: Combined keyword + semantic with RRF fusion (recommended)
+ * - mmr: Maximal Marginal Relevance for diverse results
+ *
+ * @param query - Search query
+ * @param options - Search options
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Search response with results
+ */
+export async function searchDocuments(query, options, tokenManager) {
+    const mode = options?.mode || 'hybrid';
+    let headers = {
+        'Content-Type': 'application/json',
+    };
+    if (tokenManager) {
+        try {
+            const token = await tokenManager.getAuthzToken('search-api', []);
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        catch (error) {
+            console.warn('[searchDocuments] Failed to get auth token, proceeding without auth:', error);
+        }
+    }
+    const requestBody = {
+        query,
+        mode,
+        limit: options?.limit || 10,
+        offset: options?.offset || 0,
+        use_reranker: options?.useReranker ?? true,
+        reranker_model: options?.rerankerModel || 'baai-gpu',
+        enable_highlighting: options?.enableHighlighting ?? true,
+        highlight_fragment_size: options?.highlightFragmentSize || 150,
+        enable_semantic_alignment: options?.enableSemanticAlignment ?? false,
+        semantic_alignment_top_k: options?.semanticAlignmentTopK || 3,
+        diversity_lambda: options?.diversityLambda,
+        file_ids: options?.fileIds,
+        document_ids: options?.documentIds,
+        partitions: options?.partitions,
+    };
+    // Use mode-specific endpoint if specified, otherwise use main /search endpoint
+    const endpoint = mode === 'mmr' ? '/search/mmr' : `/search/${mode}`;
+    const response = await fetch(`${SEARCH_API_URL}${endpoint}`, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(requestBody),
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({ detail: response.statusText }));
+        throw new Error(`Document search failed: ${error.detail || response.statusText}`);
+    }
+    return response.json();
+}
+/**
+ * Keyword search (BM25 only)
+ *
+ * Fast full-text search with exact term matching.
+ * Best for technical terms, codes, IDs, and known phrases.
+ *
+ * @param query - Search query
+ * @param options - Search options
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Search response with results
+ */
+export async function searchKeyword(query, options, tokenManager) {
+    return searchDocuments(query, { ...options, mode: 'keyword' }, tokenManager);
+}
+/**
+ * Semantic search (vector only)
+ *
+ * Dense vector similarity search using embeddings.
+ * Understands meaning and context beyond exact keywords.
+ * Best for conceptual queries and natural language questions.
+ *
+ * @param query - Search query
+ * @param options - Search options
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Search response with results
+ */
+export async function searchSemantic(query, options, tokenManager) {
+    return searchDocuments(query, { ...options, mode: 'semantic' }, tokenManager);
+}
+/**
+ * Hybrid search (keyword + semantic with RRF fusion)
+ *
+ * Combines BM25 keyword search and vector semantic search.
+ * Provides best of both worlds - exact matching and semantic understanding.
+ * Recommended for most use cases.
+ *
+ * @param query - Search query
+ * @param options - Search options
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Search response with results
+ */
+export async function searchHybrid(query, options, tokenManager) {
+    return searchDocuments(query, { ...options, mode: 'hybrid' }, tokenManager);
+}
+/**
+ * MMR search (Maximal Marginal Relevance)
+ *
+ * Returns diverse results by balancing relevance and diversity.
+ * Useful for exploratory search and avoiding redundant results.
+ *
+ * @param query - Search query
+ * @param options - Search options (diversityLambda: 0.0 = max diversity, 1.0 = max relevance)
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Search response with results
+ */
+export async function searchMMR(query, options, tokenManager) {
+    return searchDocuments(query, { ...options, mode: 'mmr' }, tokenManager);
+}
+/**
+ * Get semantic alignment for a query and document
+ *
+ * Visualizes query-document similarity with matched spans.
+ * Useful for understanding why a document matched a query.
+ *
+ * @param query - Search query
+ * @param documentId - Document ID
+ * @param tokenManager - Optional token manager for authentication
+ * @returns Semantic alignment data
+ */
+export async function getSemanticAlignment(query, documentId, tokenManager) {
+    let headers = {
+        'Content-Type': 'application/json',
+    };
+    if (tokenManager) {
+        try {
+            const token = await tokenManager.getAuthzToken('search-api', []);
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        catch (error) {
+            console.warn('[getSemanticAlignment] Failed to get auth token:', error);
+        }
+    }
+    const response = await fetch(`${SEARCH_API_URL}/search/explain`, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify({ query, document_id: documentId }),
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({ detail: response.statusText }));
+        throw new Error(`Failed to get semantic alignment: ${error.detail || response.statusText}`);
+    }
+    return response.json();
+}
+// ============================================================================
+// Health Check
+// ============================================================================
+/**
+ * Check search-api health
+ *
+ * @returns true if service is healthy
+ */
+export async function checkSearchHealth() {
+    try {
+        const response = await fetch(`${SEARCH_API_URL}/health`);
+        if (!response.ok) {
+            return false;
+        }
+        const data = await response.json();
+        return data.status === 'healthy' || data.status === 'degraded';
+    }
+    catch (error) {
+        console.error('[checkSearchHealth] Health check failed:', error);
+        return false;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/lib/search/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/lib/search/client.ts"],"names":[],"mappings":"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"}

package/dist/lib/search/config.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Search Provider Configuration Loader for busibox-portal
+ *
+ * Web search is now handled entirely by search-api. This module provides
+ * initializeSearchProviders() and clearSearchProviderCache() for backward
+ * compatibility; both are no-ops since SearchProviderFactory was removed.
+ */
+/**
+ * No-op. Web search is handled by search-api; no client-side provider init needed.
+ */
+export declare function initializeSearchProviders(): Promise<void>;
+/**
+ * No-op. Kept for backward compatibility (e.g. admin route calls after config updates).
+ */
+export declare function clearSearchProviderCache(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/search/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/lib/search/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/lib/search/config.js

@@ -0,0 +1,20 @@
+/**
+ * Search Provider Configuration Loader for busibox-portal
+ *
+ * Web search is now handled entirely by search-api. This module provides
+ * initializeSearchProviders() and clearSearchProviderCache() for backward
+ * compatibility; both are no-ops since SearchProviderFactory was removed.
+ */
+/**
+ * No-op. Web search is handled by search-api; no client-side provider init needed.
+ */
+export async function initializeSearchProviders() {
+    // No-op: search-api handles all provider configuration
+}
+/**
+ * No-op. Kept for backward compatibility (e.g. admin route calls after config updates).
+ */
+export function clearSearchProviderCache() {
+    // No-op: no client-side cache to clear
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/search/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/lib/search/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,uDAAuD;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,uCAAuC;AACzC,CAAC"}

package/dist/lib/search/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Search exports for busibox-app
+ *
+ * Unified search client for:
+ * - Web search (Tavily, DuckDuckGo, Perplexity, Bing, etc.)
+ * - Document search (BM25 keyword, vector semantic, hybrid, MMR)
+ *
+ * For chat insights, use '@jazzmind/busibox-app/lib/agent/insights' instead.
+ */
+export { searchWeb, getAvailableProviders, getProviderStatus, type WebSearchResult, type WebSearchResponse, type WebSearchOptions, type ProviderStatus, } from './client';
+export { searchDocuments, searchKeyword, searchSemantic, searchHybrid, searchMMR, getSemanticAlignment, type DocumentSearchResult, type DocumentSearchResponse, type DocumentSearchOptions, } from './client';
+export { checkSearchHealth, type TokenManager, } from './client';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/search/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,UAAU,CAAC;AAMlB,OAAO,EACL,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,SAAS,EACT,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,UAAU,CAAC;AAMlB,OAAO,EACL,iBAAiB,EACjB,KAAK,YAAY,GAClB,MAAM,UAAU,CAAC"}

package/dist/lib/search/index.js

@@ -0,0 +1,22 @@
+/**
+ * Search exports for busibox-app
+ *
+ * Unified search client for:
+ * - Web search (Tavily, DuckDuckGo, Perplexity, Bing, etc.)
+ * - Document search (BM25 keyword, vector semantic, hybrid, MMR)
+ *
+ * For chat insights, use '@jazzmind/busibox-app/lib/agent/insights' instead.
+ */
+// ============================================================================
+// Web Search
+// ============================================================================
+export { searchWeb, getAvailableProviders, getProviderStatus, } from './client';
+// ============================================================================
+// Document Search
+// ============================================================================
+export { searchDocuments, searchKeyword, searchSemantic, searchHybrid, searchMMR, getSemanticAlignment, } from './client';
+// ============================================================================
+// Common
+// ============================================================================
+export { checkSearchHealth, } from './client';
+//# sourceMappingURL=index.js.map

package/dist/lib/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/search/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,iBAAiB,GAKlB,MAAM,UAAU,CAAC;AAElB,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO,EACL,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,SAAS,EACT,oBAAoB,GAIrB,MAAM,UAAU,CAAC;AAElB,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EACL,iBAAiB,GAElB,MAAM,UAAU,CAAC"}