captify 0.1.17 → 0.1.19

package/dist/search/search.constants.js

@@ -0,0 +1,1111 @@
+/**
+ * Search Module Constants
+ *
+ * Routes, result types, defaults, and index names for the global unified search feature.
+ */
+import { BookOpen, Bot, File, FileCode, FileJson, FileSpreadsheet, FileText, FileType, MessageCircle, MessageSquare, Search, ShieldUser, User, } from "lucide-react";
+/**
+ * API routes for search endpoints
+ */
+export const SEARCH_ROUTES = {
+    SEARCH: "/api/search",
+    LOCK_EVENTS: "/api/search/locks/events",
+};
+/**
+ * Searchable result types
+ */
+export const SEARCH_RESULT_TYPES = [
+    "document",
+    "user",
+    "group",
+    "agent",
+    "feedback",
+    "chat",
+    "message",
+];
+/**
+ * Search configuration defaults
+ */
+export const SEARCH_DEFAULTS = {
+    /** Minimum query length required to perform search */
+    MIN_QUERY_LENGTH: 2,
+    /** Maximum query length allowed */
+    MAX_QUERY_LENGTH: 500,
+    /** Default number of results per page */
+    DEFAULT_LIMIT: 10,
+    /** Maximum results per page */
+    MAX_LIMIT: 50,
+    /** Debounce delay in milliseconds */
+    DEBOUNCE_MS: 600,
+    /** Maximum recent searches to store */
+    MAX_RECENT_SEARCHES: 5,
+};
+/**
+ * OpenSearch index names for each entity type
+ */
+export const SEARCH_INDEX_NAMES = {
+    DOCUMENTS: "captify-search-documents",
+    USERS: "captify-search-users",
+    GROUPS: "captify-search-groups",
+    AGENTS: "captify-search-agents",
+    FEEDBACKS: "captify-search-feedbacks",
+    CHATS: "captify-search-chats",
+    MESSAGES: "captify-search-messages",
+};
+/**
+ * All search index names as an array
+ */
+export const ALL_SEARCH_INDICES = Object.values(SEARCH_INDEX_NAMES);
+/**
+ * Index name to result type mapping
+ */
+export const INDEX_TO_TYPE_MAP = {
+    [SEARCH_INDEX_NAMES.DOCUMENTS]: "document",
+    [SEARCH_INDEX_NAMES.USERS]: "user",
+    [SEARCH_INDEX_NAMES.GROUPS]: "group",
+    [SEARCH_INDEX_NAMES.AGENTS]: "agent",
+    [SEARCH_INDEX_NAMES.FEEDBACKS]: "feedback",
+    [SEARCH_INDEX_NAMES.CHATS]: "chat",
+    [SEARCH_INDEX_NAMES.MESSAGES]: "message",
+};
+/**
+ * Result type to index name mapping
+ */
+export const TYPE_TO_INDEX_MAP = {
+    document: SEARCH_INDEX_NAMES.DOCUMENTS,
+    user: SEARCH_INDEX_NAMES.USERS,
+    group: SEARCH_INDEX_NAMES.GROUPS,
+    agent: SEARCH_INDEX_NAMES.AGENTS,
+    feedback: SEARCH_INDEX_NAMES.FEEDBACKS,
+    chat: SEARCH_INDEX_NAMES.CHATS,
+    message: SEARCH_INDEX_NAMES.MESSAGES,
+};
+/**
+ * Display labels for result types (used in search result category badges)
+ */
+export const SEARCH_CATEGORY_LABELS = {
+    document: "Documents",
+    user: "Users",
+    group: "Groups",
+    agent: "AI Agents",
+    feedback: "Feedback",
+    chat: "Chats",
+    message: "Messages",
+};
+/**
+ * Icon names for result types (Lucide icons)
+ */
+export const SEARCH_CATEGORY_ICONS = {
+    document: "BookOpen",
+    user: "User",
+    group: "ShieldUser",
+    agent: "Bot",
+    feedback: "MessageCircle",
+    chat: "MessageSquare",
+    message: "MessageCircle",
+};
+/**
+ * Default placeholder URL when no page exists yet
+ */
+export const NO_PAGE_PLACEHOLDER = "#";
+/**
+ * URL patterns for navigation to search results.
+ * Use buildSearchResultHref() utility to generate actual URLs from these patterns.
+ */
+export const SEARCH_URL_PATTERNS = {
+    document: "/documents?bucket={bucket}&key={key}",
+    user: "/users/{username}",
+    group: "/groups/{name}",
+    agent: "/agents/{id}",
+    feedback: "/feedbacks/{id}",
+    chat: "/chat/{id}",
+    message: "/chat/{sessionId}#message-{id}",
+};
+/**
+ * Default search tabs configuration
+ */
+export const DEFAULT_SEARCH_TABS = [
+    { id: "all", label: "All", icon: "Search", visible: true },
+    { id: "document", label: "Documents", icon: "BookOpen", visible: true },
+    { id: "user", label: "Users", icon: "User", visible: true },
+    { id: "group", label: "Groups", icon: "ShieldUser", visible: true },
+    { id: "agent", label: "Agents", icon: "Bot", visible: true },
+    { id: "feedback", label: "Feedback", icon: "MessageCircle", visible: true },
+    { id: "chat", label: "Chats", icon: "MessageSquare", visible: true },
+    // Messages are hidden but searched as part of "chat" tab - clicking navigates to the chat
+    { id: "message", label: "Messages", icon: "MessageCircle", visible: false },
+];
+/**
+ * LocalStorage keys for search persistence
+ */
+export const SEARCH_STORAGE_KEYS = {
+    RECENT_SEARCHES: "captify-core:global-search-recent",
+    TAB_SETTINGS: "captify-core:global-search-tab-settings",
+};
+/**
+ * Query cache configuration for React Query/TanStack Query
+ */
+export const SEARCH_QUERY_CONFIG = {
+    /** How long results are considered fresh (30 seconds) */
+    STALE_TIME_MS: 30 * 1000,
+    /** How long to keep results in cache after unused (5 minutes) */
+    GC_TIME_MS: 5 * 60 * 1000,
+    /** Number of retry attempts for failed queries */
+    RETRY_COUNT: 2,
+    /** Maximum retry delay in milliseconds */
+    MAX_RETRY_DELAY_MS: 10000,
+    /** Base delay multiplier for exponential backoff */
+    RETRY_DELAY_BASE_MS: 1000,
+};
+/**
+ * Index health status values
+ */
+export const INDEX_HEALTH_STATUS = {
+    GREEN: "green",
+    YELLOW: "yellow",
+    RED: "red",
+};
+/**
+ * Error codes for search operations
+ */
+export const SEARCH_ERROR_CODES = {
+    INVALID_QUERY: "INVALID_QUERY",
+    SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE",
+    UNAUTHORIZED: "UNAUTHORIZED",
+    OPENSEARCH_ERROR: "OPENSEARCH_ERROR",
+    VALIDATION_ERROR: "VALIDATION_ERROR",
+};
+/**
+ * Error messages for search operations
+ */
+export const SEARCH_ERROR_MESSAGES = {
+    QUERY_TOO_SHORT: `Query must be at least ${SEARCH_DEFAULTS.MIN_QUERY_LENGTH} characters`,
+    QUERY_TOO_LONG: `Query must not exceed ${SEARCH_DEFAULTS.MAX_QUERY_LENGTH} characters`,
+    SERVICE_UNAVAILABLE: "Search service is temporarily unavailable",
+    UNAUTHORIZED: "Authentication required",
+    INVALID_TYPE: "Invalid search type filter",
+    OPENSEARCH_CONNECTION_FAILED: "Failed to connect to search service",
+    SYNC_INDEX_FAILED: "An error occurred while syncing the index",
+    SYNC_DOCUMENTS_FAILED: "Error syncing documents — check logs for details",
+    SYNC_AGENTS_FAILED: "Error syncing agents — check logs for details",
+    SYNC_FEEDBACKS_FAILED: "Error syncing feedbacks — check logs for details",
+    SYNC_CHATS_FAILED: "Error syncing chats — check logs for details",
+    SYNC_MESSAGES_FAILED: "Error syncing messages — check logs for details",
+    SYNC_USERS_FAILED: "Error syncing users — check logs for details",
+    SYNC_GROUPS_FAILED: "Error syncing groups — check logs for details",
+};
+// ============================================================================
+// Sync Constants
+// ============================================================================
+/**
+ * Indices that support sync operations
+ */
+export const SYNCABLE_INDICES = [
+    SEARCH_INDEX_NAMES.DOCUMENTS,
+    SEARCH_INDEX_NAMES.AGENTS,
+    SEARCH_INDEX_NAMES.FEEDBACKS,
+    SEARCH_INDEX_NAMES.CHATS,
+    SEARCH_INDEX_NAMES.MESSAGES,
+    SEARCH_INDEX_NAMES.USERS,
+    SEARCH_INDEX_NAMES.GROUPS,
+];
+// ============================================================================
+// OpenSearch Service Constants
+// ============================================================================
+/**
+ * OpenSearch error messages
+ */
+export const OPENSEARCH_ERROR_MESSAGES = {
+    ENDPOINT_REQUIRED: "OpenSearch endpoint is required",
+    REGION_REQUIRED: "AWS region is required for OpenSearch",
+    CONNECTION_FAILED: "Failed to connect to OpenSearch",
+    ACCESS_KEY_REQUIRED: "AWS access key ID is required",
+    SECRET_KEY_REQUIRED: "AWS secret access key is required",
+    INVALID_INDEX_DELETION: "Cannot delete index: only captify-managed search indices can be deleted",
+    INDEX_CREATION_FAILED: "An error occurred while creating the index",
+};
+/**
+ * Embedding error messages
+ */
+export const EMBEDDING_ERROR_MESSAGES = {
+    EMPTY_TEXT: "Cannot generate embedding for empty text - check upstream document content extraction",
+};
+/**
+ * Network error codes that indicate connection/availability issues
+ */
+export const NETWORK_ERROR_CODES = {
+    CONNECTION_REFUSED: "ECONNREFUSED",
+    TIMEOUT: "ETIMEDOUT",
+    NOT_FOUND: "ENOTFOUND",
+    UNAVAILABLE: "unavailable",
+};
+/**
+ * OpenSearch default configuration values
+ */
+export const OPENSEARCH_DEFAULT_CONFIG = {
+    /** Default request timeout in milliseconds */
+    REQUEST_TIMEOUT_MS: 30000,
+    /** AWS service name for OpenSearch SigV4 signing */
+    AWS_SERVICE_NAME: "es",
+    /** User client cache TTL in milliseconds (5 minutes) */
+    USER_CLIENT_TTL_MS: 5 * 60 * 1000,
+    /** Interval for periodic cleanup of stale user clients (1 minute) */
+    USER_CLIENT_CLEANUP_INTERVAL_MS: 60 * 1000,
+    /** Maximum number of cached user clients (LRU eviction when exceeded) */
+    USER_CLIENT_MAX_CACHE_SIZE: 100,
+    /** Default wildcard pattern for index searches */
+    DEFAULT_INDEX_PATTERN: "*",
+    /** Default document count when unavailable */
+    DEFAULT_DOCS_COUNT: "0",
+    /** Default number of primary shards for new indices */
+    DEFAULT_NUMBER_OF_SHARDS: 1,
+    /** Default number of replicas for new indices */
+    DEFAULT_NUMBER_OF_REPLICAS: 1,
+    /** Maximum number of retries for failed requests */
+    MAX_RETRIES: 3,
+    /**
+     * Resurrection strategy for dead connections.
+     * 'optimistic' = immediately try dead nodes on next request (best for AWS OpenSearch)
+     * 'ping' = periodically ping dead nodes to check if alive
+     * 'none' = never resurrect dead nodes
+     *
+     * AWS OpenSearch provides a single endpoint URL that load-balances to the cluster.
+     * Using 'optimistic' ensures transient failures don't permanently mark the endpoint as dead.
+     */
+    RESURRECT_STRATEGY: "optimistic",
+};
+/**
+ * OpenSearch query cache configuration for index-level caching.
+ *
+ * Trade-offs:
+ * - QUERY_CACHE_ENABLED: Caches filter query results. Improves performance for repeated
+ *   queries but uses memory. Recommended for read-heavy workloads.
+ * - REFRESH_INTERVAL: Controls how often new documents become searchable.
+ *   - Lower values (1s): Near real-time search, higher I/O overhead
+ *   - Higher values (30s+): Better indexing performance, stale search results
+ *   - 5s is a balanced default for most use cases with moderate update frequency
+ *
+ * These settings are applied at index creation time. To modify existing indices,
+ * use the OpenSearch Update Settings API or recreate the index.
+ *
+ * @see https://opensearch.org/docs/latest/install-and-configure/configuring-opensearch/index-settings/
+ */
+export const OPENSEARCH_CACHE_CONFIG = {
+    /**
+     * Enable query cache for filter results.
+     * Caches results of filter queries to speed up repeated searches.
+     */
+    QUERY_CACHE_ENABLED: true,
+    /**
+     * How often the index refreshes to make new documents searchable.
+     * 5s balances search freshness with indexing performance.
+     */
+    REFRESH_INTERVAL: "5s",
+};
+// ============================================================================
+// Embedding Service Constants
+// ============================================================================
+/**
+ * Titan Embedding model configuration
+ * - titan-embed-text-v1: 1536 dimensions
+ * - titan-embed-text-v2:0: 1024 dimensions (default), configurable
+ */
+export const EMBEDDING_CONFIG = {
+    /** Model ID for Amazon Titan Embeddings */
+    MODEL_ID: "amazon.titan-embed-text-v2:0",
+    /** Number of embedding dimensions */
+    DIMENSIONS: 1024,
+    /** Maximum text length before truncation (Titan has 8k token limit) */
+    MAX_TEXT_LENGTH: 50000,
+    /** Concurrency limit for batch embedding operations */
+    BATCH_CONCURRENCY: 5,
+};
+/**
+ * Embedding cache configuration for LRU cache
+ */
+export const EMBEDDING_CACHE_CONFIG = {
+    /** Maximum number of cached embeddings (~4MB at 4KB per entry) */
+    MAX_CACHE_SIZE: 1000,
+    /** Time-to-live for cached embeddings in milliseconds (5 minutes) */
+    TTL_MS: 5 * 60 * 1000,
+    /** Maximum cache key length for normalization */
+    CACHE_KEY_MAX_LENGTH: 200,
+};
+// ============================================================================
+// OpenSearch Index Mappings
+// ============================================================================
+/**
+ * Index schema version for migration tracking.
+ * Increment minor version for backward-compatible changes (new optional fields).
+ * Increment major version for breaking changes (removed fields, type changes).
+ */
+export const INDEX_SCHEMA_VERSION = {
+    /** Current schema version for all indices */
+    CURRENT: "1.0",
+    /** Initial version when versioning was introduced */
+    INITIAL: "1.0",
+};
+/**
+ * k-NN settings for vector fields (using faiss engine with cosinesimil for OpenSearch 2.19.0+)
+ */
+export const KNN_VECTOR_FIELD = {
+    type: "knn_vector",
+    dimension: EMBEDDING_CONFIG.DIMENSIONS,
+    method: {
+        name: "hnsw",
+        space_type: "cosinesimil",
+        engine: "faiss",
+        parameters: {
+            ef_construction: 128,
+            m: 16,
+        },
+    },
+};
+/**
+ * Common index settings applied to all search indices.
+ * Combines k-NN support with query cache configuration for optimal performance.
+ */
+export const COMMON_INDEX_SETTINGS = {
+    "index.knn": true,
+    "index.queries.cache.enabled": OPENSEARCH_CACHE_CONFIG.QUERY_CACHE_ENABLED,
+    refresh_interval: OPENSEARCH_CACHE_CONFIG.REFRESH_INTERVAL,
+};
+/**
+ * OpenSearch index definitions with mappings for all searchable entity types.
+ * Each definition includes a version number for schema migration support.
+ */
+export const INDEX_DEFINITIONS = [
+    {
+        name: SEARCH_INDEX_NAMES.DOCUMENTS,
+        version: INDEX_SCHEMA_VERSION.CURRENT,
+        settings: COMMON_INDEX_SETTINGS,
+        mappings: {
+            properties: {
+                id: { type: "keyword" },
+                collapseId: { type: "keyword" },
+                documentId: { type: "keyword" },
+                parentId: { type: "keyword" },
+                chunkIndex: { type: "integer" },
+                totalChunks: { type: "integer" },
+                title: { type: "text", analyzer: "standard" },
+                originalName: { type: "keyword" },
+                description: { type: "text", analyzer: "standard" },
+                content: { type: "text", analyzer: "standard" },
+                type: { type: "keyword" },
+                href: { type: "keyword" },
+                category: { type: "keyword" },
+                tenantId: { type: "keyword" },
+                userId: { type: "keyword" },
+                bucket: { type: "keyword" },
+                key: { type: "keyword" },
+                size: { type: "long" },
+                lastModified: { type: "date" },
+                embedding: KNN_VECTOR_FIELD,
+            },
+        },
+    },
+    {
+        name: SEARCH_INDEX_NAMES.USERS,
+        version: INDEX_SCHEMA_VERSION.CURRENT,
+        settings: COMMON_INDEX_SETTINGS,
+        mappings: {
+            properties: {
+                id: { type: "keyword" },
+                collapseId: { type: "keyword" },
+                name: { type: "text", analyzer: "standard" },
+                displayName: { type: "text", analyzer: "standard" },
+                email: { type: "text", analyzer: "standard" },
+                type: { type: "keyword" },
+                href: { type: "keyword" },
+                category: { type: "keyword" },
+                tenantId: { type: "keyword" },
+                enabled: { type: "boolean" },
+                status: { type: "keyword" },
+                department: { type: "text", analyzer: "standard" },
+                jobTitle: { type: "text", analyzer: "standard" },
+                roles: { type: "keyword" },
+                createdAt: { type: "date" },
+                updatedAt: { type: "date" },
+                embedding: KNN_VECTOR_FIELD,
+            },
+        },
+    },
+    {
+        name: SEARCH_INDEX_NAMES.GROUPS,
+        version: INDEX_SCHEMA_VERSION.CURRENT,
+        settings: COMMON_INDEX_SETTINGS,
+        mappings: {
+            properties: {
+                id: { type: "keyword" },
+                collapseId: { type: "keyword" },
+                name: { type: "text", analyzer: "standard" },
+                displayName: { type: "text", analyzer: "standard" },
+                description: { type: "text", analyzer: "standard" },
+                type: { type: "keyword" },
+                href: { type: "keyword" },
+                category: { type: "keyword" },
+                tenantId: { type: "keyword" },
+                createdAt: { type: "date" },
+                updatedAt: { type: "date" },
+                embedding: KNN_VECTOR_FIELD,
+            },
+        },
+    },
+    {
+        name: SEARCH_INDEX_NAMES.AGENTS,
+        version: INDEX_SCHEMA_VERSION.CURRENT,
+        settings: COMMON_INDEX_SETTINGS,
+        mappings: {
+            properties: {
+                id: { type: "keyword" },
+                collapseId: { type: "keyword" },
+                name: { type: "text", analyzer: "standard" },
+                title: { type: "text", analyzer: "standard" },
+                description: { type: "text", analyzer: "standard" },
+                instructions: { type: "text", analyzer: "standard" },
+                type: { type: "keyword" },
+                href: { type: "keyword" },
+                category: { type: "keyword" },
+                tenantId: { type: "keyword" },
+                status: { type: "keyword" },
+                createdAt: { type: "date" },
+                updatedAt: { type: "date" },
+                embedding: KNN_VECTOR_FIELD,
+            },
+        },
+    },
+    {
+        name: SEARCH_INDEX_NAMES.FEEDBACKS,
+        version: INDEX_SCHEMA_VERSION.CURRENT,
+        settings: COMMON_INDEX_SETTINGS,
+        mappings: {
+            properties: {
+                id: { type: "keyword" },
+                collapseId: { type: "keyword" },
+                title: { type: "text", analyzer: "standard" },
+                description: { type: "text", analyzer: "standard" },
+                content: { type: "text", analyzer: "standard" },
+                type: { type: "keyword" },
+                href: { type: "keyword" },
+                category: { type: "keyword" },
+                tenantId: { type: "keyword" },
+                userId: { type: "keyword" },
+                status: { type: "keyword" },
+                createdAt: { type: "date" },
+                updatedAt: { type: "date" },
+                embedding: KNN_VECTOR_FIELD,
+            },
+        },
+    },
+    {
+        name: SEARCH_INDEX_NAMES.CHATS,
+        version: INDEX_SCHEMA_VERSION.CURRENT,
+        settings: COMMON_INDEX_SETTINGS,
+        mappings: {
+            properties: {
+                id: { type: "keyword" },
+                collapseId: { type: "keyword" },
+                title: { type: "text", analyzer: "standard" },
+                description: { type: "text", analyzer: "standard" },
+                type: { type: "keyword" },
+                href: { type: "keyword" },
+                category: { type: "keyword" },
+                tenantId: { type: "keyword" },
+                userId: { type: "keyword" },
+                messageCount: { type: "integer" },
+                isArchived: { type: "boolean" },
+                createdAt: { type: "date" },
+                updatedAt: { type: "date" },
+                embedding: KNN_VECTOR_FIELD,
+            },
+        },
+    },
+    {
+        name: SEARCH_INDEX_NAMES.MESSAGES,
+        version: INDEX_SCHEMA_VERSION.CURRENT,
+        settings: COMMON_INDEX_SETTINGS,
+        mappings: {
+            properties: {
+                id: { type: "keyword" },
+                collapseId: { type: "keyword" },
+                sessionId: { type: "keyword" },
+                sessionTitle: { type: "text", analyzer: "standard" },
+                title: { type: "text", analyzer: "standard" },
+                content: { type: "text", analyzer: "standard" },
+                role: { type: "keyword" },
+                type: { type: "keyword" },
+                href: { type: "keyword" },
+                category: { type: "keyword" },
+                tenantId: { type: "keyword" },
+                userId: { type: "keyword" },
+                createdAt: { type: "date" },
+                embedding: KNN_VECTOR_FIELD,
+            },
+        },
+    },
+];
+// ============================================================================
+// Unified Search Service Constants
+// ============================================================================
+/**
+ * Unified search configuration
+ */
+export const UNIFIED_SEARCH_CONFIG = {
+    /** Minimum score threshold for semantic search results (0-1, cosine similarity) */
+    MIN_SEMANTIC_SCORE: 0.65,
+    /** Ratio of max score used as threshold for filtering low-relevance results */
+    SCORE_THRESHOLD_RATIO: 0.2,
+    /** Divisor for normalizing OpenSearch scores to 0-1 range */
+    SCORE_NORMALIZATION_DIVISOR: 10,
+    /** Batch size for count queries when calculating total results */
+    COUNT_QUERY_BATCH_SIZE: 1000,
+    /** Multiplier for k-NN vector search (k = limit * multiplier) - deprecated in favor of KNN_MULTIPLIER_CONFIG */
+    KNN_MULTIPLIER: 3,
+    /**
+     * Threshold for using parallel search (number of indices).
+     * When searching more than this many indices with semantic search,
+     * use parallel search for better performance.
+     */
+    PARALLEL_SEARCH_THRESHOLD: 2,
+};
+/**
+ * k-NN search parameters for different search modes
+ * ef_search controls the size of the dynamic candidate list during search
+ * Higher values = better recall but slower search
+ */
+export const KNN_SEARCH_PARAMS = {
+    /** ef_search for standard keyword + semantic hybrid search */
+    STANDARD_EF_SEARCH: 100,
+    /** ef_search for semantic-only search (higher for better recall) */
+    SEMANTIC_ONLY_EF_SEARCH: 150,
+    /** ef_search for hybrid search with keyword fallback (lower for better performance) */
+    HYBRID_EF_SEARCH: 80,
+};
+/**
+ * Dynamic k-NN multiplier configuration for optimizing vector search performance
+ * k controls how many nearest neighbors to retrieve before filtering
+ */
+export const KNN_MULTIPLIER_CONFIG = {
+    /** Multiplier for semantic-only searches (need more candidates to ensure good results) */
+    SEMANTIC_ONLY: 4,
+    /** Multiplier for hybrid searches (keyword search helps, need fewer vector candidates) */
+    HYBRID: 2,
+    /** Minimum k value to ensure reasonable recall */
+    MIN_K: 20,
+};
+/**
+ * Source fields to return for each result type
+ * Excludes embedding field to reduce response size (~4KB per document)
+ */
+export const SEARCH_SOURCE_FIELDS = {
+    document: [
+        "id",
+        "collapseId",
+        "title",
+        "content",
+        "description",
+        "tenantId",
+        "type",
+        "href",
+        "bucket",
+        "key",
+        "parentId",
+    ],
+    message: [
+        "id",
+        "collapseId",
+        "sessionId",
+        "sessionTitle",
+        "content",
+        "role",
+        "type",
+        "userId",
+        "tenantId",
+    ],
+    user: ["id", "collapseId", "name", "displayName", "email", "tenantId", "type"],
+    group: ["id", "collapseId", "name", "description", "tenantId", "type"],
+    agent: ["id", "collapseId", "name", "description", "systemPrompt", "tenantId", "type"],
+    feedback: ["id", "collapseId", "title", "description", "status", "tenantId", "type"],
+    chat: ["id", "collapseId", "title", "tenantId", "userId", "type"],
+    all: [
+        "id",
+        "collapseId",
+        "title",
+        "name",
+        "displayName",
+        "content",
+        "description",
+        "email",
+        "tenantId",
+        "userId",
+        "type",
+        "sessionId",
+        "sessionTitle",
+        "role",
+    ],
+};
+/**
+ * OpenSearch query configuration for multi-match search
+ */
+export const QUERY_CONFIG = {
+    /** Boost factor for high-priority fields (title, name, displayName) */
+    HIGH_PRIORITY_BOOST: 3,
+    /** Boost factor for medium-priority fields (content, description, email, roles) */
+    MEDIUM_PRIORITY_BOOST: 2,
+    /** Boost factor for low-priority fields (instructions) */
+    LOW_PRIORITY_BOOST: 1,
+    /** Minimum prefix length before applying fuzzy matching */
+    FUZZY_PREFIX_LENGTH: 2,
+    /** Minimum should match for boolean queries */
+    MINIMUM_SHOULD_MATCH: 1,
+};
+// ============================================================================
+// Content Extraction Service Constants
+// ============================================================================
+/**
+ * Content extraction configuration
+ */
+export const CONTENT_EXTRACTION_CONFIG = {
+    /** Maximum file size for content extraction (10MB) */
+    MAX_FILE_SIZE: 10 * 1024 * 1024,
+    /** Maximum content length for single extraction (legacy, used when chunking disabled) */
+    MAX_CONTENT_LENGTH: 15000,
+};
+/**
+ * Document chunking configuration for semantic search
+ */
+export const CHUNK_CONFIG = {
+    /** Target chunk size in characters (~400 tokens for good embedding quality) */
+    CHUNK_SIZE: 1500,
+    /** Overlap between chunks to maintain context */
+    CHUNK_OVERLAP: 200,
+    /** Maximum number of chunks per document to prevent excessive indexing */
+    MAX_CHUNKS: 50,
+};
+/**
+ * Supported file extensions for content extraction
+ */
+export const SUPPORTED_CONTENT_EXTENSIONS = [
+    ".pdf",
+    ".docx",
+    ".txt",
+    ".csv",
+    ".json",
+    ".md",
+    ".html",
+    ".htm",
+    ".xml",
+    ".rtf",
+];
+/**
+ * Legacy file formats that are not supported
+ * Note: .doc (legacy Word binary format) requires word-extractor library
+ */
+export const UNSUPPORTED_LEGACY_EXTENSIONS = [".doc"];
+// ============================================================================
+// Sync Service Constants
+// ============================================================================
+/**
+ * Sync service configuration constants
+ */
+export const SYNC_CONFIG = {
+    /** Empty delimiter for recursive S3 file listing */
+    RECURSIVE_DELIMITER: "",
+    /** Number of items to process before sending progress update for chats */
+    CHAT_PROGRESS_INTERVAL: 10,
+    /** Number of items to process before sending progress update for messages */
+    MESSAGE_PROGRESS_INTERVAL: 50,
+    /** Default error count for successful operations */
+    NO_ERRORS: 0,
+    /** Maximum number of S3 keys to fetch per batch */
+    S3_MAX_KEYS_PER_BATCH: 1000,
+    /** Cognito user list limit for group member pagination */
+    COGNITO_USER_LIST_LIMIT: 60,
+    /** Batch size for bulk indexing operations (number of documents per bulk API call) */
+    BULK_INDEX_BATCH_SIZE: 50,
+    /** Maximum concurrent embedding generation requests (to avoid overwhelming Bedrock) */
+    PARALLEL_EMBEDDING_CONCURRENCY: 10,
+    /** Maximum retries for connection pool exhaustion recovery */
+    CONNECTION_RECOVERY_MAX_RETRIES: 3,
+    /** Delay between connection recovery retries in milliseconds */
+    CONNECTION_RECOVERY_DELAY_MS: 1000,
+    /** Maximum retries for credential expiration recovery */
+    CREDENTIAL_REFRESH_MAX_RETRIES: 2,
+    /** Delay before retrying after credential refresh in milliseconds */
+    CREDENTIAL_REFRESH_DELAY_MS: 500,
+    /** Buffer time before expiration to proactively refresh credentials (5 minutes) */
+    CREDENTIAL_EXPIRY_BUFFER_MS: 5 * 60 * 1000,
+};
+/**
+ * Message preview configuration
+ */
+export const MESSAGE_PREVIEW_CONFIG = {
+    /** Maximum characters for message title preview */
+    TITLE_PREVIEW_LENGTH: 100,
+    /** Suffix for truncated previews */
+    TRUNCATION_SUFFIX: "...",
+};
+// ============================================================================
+// Content Extraction Chunking Constants
+// ============================================================================
+/**
+ * Advanced chunking configuration for sentence-aware splitting
+ */
+export const CHUNK_SPLITTING_CONFIG = {
+    /** Characters before target chunk size to start searching for sentence break */
+    SENTENCE_SEARCH_BEFORE: 200,
+    /** Characters after target chunk size to continue searching for sentence break */
+    SENTENCE_SEARCH_AFTER: 100,
+    /** Minimum ratio of chunk size before accepting sentence break (0.5 = 50%) */
+    MIN_CHUNK_SIZE_RATIO: 0.5,
+    /** Maximum recursion depth for JSON string extraction */
+    MAX_JSON_RECURSION_DEPTH: 10,
+};
+/**
+ * String parsing and utility constants
+ */
+export const STRING_PARSING_CONFIG = {
+    /** Return value from indexOf/lastIndexOf when not found */
+    NOT_FOUND_INDEX: -1,
+    /** Empty string constant for fallback values */
+    EMPTY_STRING: "",
+};
+// ============================================================================
+// Result Preview Constants
+// ============================================================================
+/**
+ * Configuration for search result content previews
+ */
+export const RESULT_PREVIEW_CONFIG = {
+    /** Character limit for document content preview */
+    DOCUMENT_PREVIEW_LENGTH: 200,
+    /** Character limit for message content preview */
+    MESSAGE_PREVIEW_LENGTH: 200,
+    /** Character limit for metadata content snippet */
+    METADATA_SNIPPET_LENGTH: 300,
+};
+/**
+ * Mark tag for highlighting
+ */
+export const HIGHLIGHT_MARK_CLASS = "search-highlight";
+/**
+ * Highlight HTML configuration
+ */
+export const HIGHLIGHT_CONFIG = {
+    /** HTML tag to wrap highlighted text (uses class for client-side styling) */
+    PRE_TAG: `<mark class="${HIGHLIGHT_MARK_CLASS}">`,
+    /** Closing HTML tag for highlights */
+    POST_TAG: "</mark>",
+    /** Number of fragments for single-line fields */
+    SINGLE_FRAGMENT_COUNT: 1,
+    /** Number of fragments for multi-line content fields */
+    CONTENT_FRAGMENT_COUNT: 3,
+    /** Number of fragments for description fields */
+    DESCRIPTION_FRAGMENT_COUNT: 2,
+    /** Fragment size in characters for content/description fields */
+    FRAGMENT_SIZE: 150,
+};
+// ============================================================================
+// Validation Constants
+// ============================================================================
+/**
+ * Common validation limits used in schemas
+ */
+export const VALIDATION_LIMITS = {
+    /** Minimum string length for required fields */
+    MIN_STRING_LENGTH: 1,
+    /** Minimum numeric value (non-negative) */
+    MIN_NUMERIC_VALUE: 0,
+};
+/**
+ * Boolean string values for query parameter parsing
+ */
+export const BOOLEAN_STRING_VALUES = ["true", "false", "1", "0"];
+/**
+ * Boolean string true values
+ */
+export const BOOLEAN_TRUE_STRING = "true";
+export const BOOLEAN_ONE_STRING = "1";
+// ============================================================================
+// API Handler Constants
+// ============================================================================
+/**
+ * Index creation status values for sync/creation responses
+ */
+export const INDEX_STATUS = {
+    ALREADY_EXISTS: "already_exists",
+    CREATED: "created",
+    ERROR: "error",
+};
+/**
+ * SSE (Server-Sent Events) response headers
+ */
+export const SSE_HEADERS = {
+    CONTENT_TYPE: "text/event-stream",
+    CACHE_CONTROL: "no-cache",
+    CONNECTION: "keep-alive",
+};
+/**
+ * SSE event format strings
+ */
+export const SSE_EVENT_FORMAT = {
+    /** Event data prefix */
+    DATA_PREFIX: "data: ",
+    /** Event terminator (double newline) */
+    EVENT_TERMINATOR: "\n\n",
+    /** Keepalive comment (SSE comment format, ignored by clients) */
+    KEEPALIVE: ":keepalive\n\n",
+};
+/**
+ * SSE keepalive configuration
+ */
+export const SSE_KEEPALIVE_CONFIG = {
+    /** Interval between keepalive messages in milliseconds (30 seconds) */
+    INTERVAL_MS: 30000,
+};
+/**
+ * Sync progress event types
+ */
+export const SYNC_PROGRESS_TYPES = {
+    START: "start",
+    PROGRESS: "progress",
+    COMPLETE: "complete",
+    ERROR: "error",
+    DONE: "done",
+};
+/**
+ * Search type filter value for "all" types
+ */
+export const SEARCH_TYPE_ALL = "all";
+/**
+ * Cache configuration for search API responses.
+ * Short TTL to reduce redundant requests while keeping results fresh.
+ */
+export const SEARCH_CACHE_CONFIG = {
+    /** Cache TTL in seconds (60 seconds) */
+    TTL_SECONDS: 60,
+    /** Cache-Control header value for search responses */
+    CACHE_CONTROL: "private, max-age=60",
+};
+/**
+ * Search response cache configuration for server-side LRU cache.
+ * Optimizes performance by caching recent search results with tenant/user isolation.
+ */
+export const SEARCH_RESPONSE_CACHE_CONFIG = {
+    /** Maximum number of cached entries (LRU eviction when exceeded) */
+    MAX_SIZE: 1000,
+    /** Cache entry TTL in milliseconds (30 seconds) */
+    TTL_MS: 30000,
+    /** Interval for cleanup of expired entries in milliseconds (10 seconds) */
+    CLEANUP_INTERVAL_MS: 10000,
+};
+// ============================================================================
+// Migration Constants
+// ============================================================================
+/**
+ * Index metadata keys for version tracking (stored in mappings._meta)
+ */
+export const INDEX_METADATA_KEYS = {
+    /** Key for storing schema version in mappings._meta */
+    SCHEMA_VERSION: "schema_version",
+    /** Key for storing creation timestamp in mappings._meta */
+    CREATED_AT: "created_at",
+};
+/**
+ * Migration status values
+ */
+export const MIGRATION_STATUS = {
+    /** Index is up-to-date */
+    UP_TO_DATE: "up_to_date",
+    /** Index needs migration (version mismatch) */
+    NEEDS_MIGRATION: "needs_migration",
+    /** Index does not exist */
+    NOT_EXISTS: "not_exists",
+    /** Migration in progress */
+    IN_PROGRESS: "in_progress",
+    /** Migration completed successfully */
+    COMPLETED: "completed",
+    /** Migration failed */
+    FAILED: "failed",
+    /** Version unknown (legacy index without version) */
+    UNKNOWN_VERSION: "unknown_version",
+};
+/**
+ * Migration configuration
+ */
+export const MIGRATION_CONFIG = {
+    /** Batch size for reindex operations */
+    REINDEX_BATCH_SIZE: 1000,
+    /** Timeout for reindex operations in milliseconds (30 minutes) */
+    REINDEX_TIMEOUT_MS: 30 * 60 * 1000,
+    /** Delay between reindex status checks in milliseconds */
+    REINDEX_POLL_INTERVAL_MS: 2000,
+    /** Suffix for temporary migration index */
+    TEMP_INDEX_SUFFIX: "_migration_temp",
+    /** Version to assign to legacy indices without version metadata */
+    LEGACY_VERSION: "0.0",
+};
+/**
+ * Migration error messages
+ */
+export const MIGRATION_ERROR_MESSAGES = {
+    INDEX_NOT_FOUND: "Index not found",
+    MIGRATION_IN_PROGRESS: "Migration already in progress for this index",
+    REINDEX_FAILED: "Reindex operation failed",
+    REINDEX_TIMEOUT: "Reindex operation timed out",
+    VERSION_PARSE_ERROR: "Failed to parse version string",
+    ALIAS_UPDATE_FAILED: "Failed to update index alias",
+    INDEX_CREATION_FAILED: "Failed to create index",
+    MIGRATION_FAILED: "Index migration failed",
+};
+// ============================================================================
+// UI Style Constants
+// ============================================================================
+/**
+ * Health status to Tailwind color class mapping
+ */
+export const HEALTH_COLOR_MAP = {
+    [INDEX_HEALTH_STATUS.GREEN]: "bg-green-500",
+    [INDEX_HEALTH_STATUS.YELLOW]: "bg-yellow-500",
+    [INDEX_HEALTH_STATUS.RED]: "bg-red-500",
+    unknown: "bg-gray-500",
+};
+// ============================================================================
+// Search Metrics Constants
+// ============================================================================
+/**
+ * Search performance metrics configuration for monitoring and optimization.
+ * These settings control when and how metrics are logged for search operations.
+ */
+export const SEARCH_METRICS_CONFIG = {
+    /** Interval for periodic metrics logging in milliseconds (1 minute) */
+    LOG_INTERVAL_MS: 60000,
+    /** Warning threshold for search latency in milliseconds */
+    LATENCY_WARN_THRESHOLD_MS: 500,
+    /** Memory estimation bytes per cache entry (rough average) */
+    EMBEDDING_CACHE_ENTRY_SIZE_BYTES: 4096,
+    /** Memory estimation bytes per response cache entry (rough average) */
+    RESPONSE_CACHE_ENTRY_SIZE_BYTES: 2048,
+};
+// ============================================================================
+// Component UI Constants
+// ============================================================================
+/**
+ * File size units and thresholds
+ */
+export const FILE_SIZE_UNITS = {
+    BYTES_PER_KB: 1024,
+    BYTES_PER_MB: 1024 * 1024,
+    BYTES_PER_GB: 1024 * 1024 * 1024,
+    DECIMAL_PLACES: 1,
+};
+/**
+ * Content preview and truncation lengths
+ */
+export const CONTENT_PREVIEW_LIMITS = {
+    /** Maximum characters for content snippet in search results */
+    SNIPPET_LENGTH: 150,
+    /** Maximum characters for message description preview */
+    MESSAGE_DESCRIPTION_LENGTH: 150,
+    /** Number of content highlights to show in document results */
+    MAX_CONTENT_HIGHLIGHTS: 2,
+};
+/**
+ * Keyboard shortcuts
+ */
+export const SEARCH_KEYBOARD_SHORTCUTS = {
+    /** Ctrl + F to open search (when not in editable element) */
+    FIND_KEY: "f",
+};
+/**
+ * Available search tabs configuration with LucideIcon components
+ */
+export const COMPONENT_SEARCH_TABS = [
+    { id: "all", label: "All", icon: Search },
+    { id: "document", label: "Documents", icon: BookOpen },
+    { id: "user", label: "Users", icon: User },
+    { id: "group", label: "Groups", icon: ShieldUser },
+    { id: "agent", label: "Agents", icon: Bot },
+    { id: "feedback", label: "Feedback", icon: MessageCircle },
+    { id: "chat", label: "Chats", icon: MessageSquare },
+];
+/**
+ * Type icons for search results
+ */
+export const TYPE_ICONS = {
+    document: BookOpen,
+    user: User,
+    group: ShieldUser,
+    agent: Bot,
+    feedback: MessageCircle,
+    chat: MessageSquare,
+    message: MessageCircle,
+};
+/**
+ * Type colors for category badges in search results
+ */
+export const TYPE_COLORS = {
+    document: "bg-blue-500/10 text-blue-600 dark:text-blue-400",
+    user: "bg-green-500/10 text-green-600 dark:text-green-400",
+    group: "bg-purple-500/10 text-purple-600 dark:text-purple-400",
+    agent: "bg-orange-500/10 text-orange-600 dark:text-orange-400",
+    feedback: "bg-pink-500/10 text-pink-600 dark:text-pink-400",
+    chat: "bg-cyan-500/10 text-cyan-600 dark:text-cyan-400",
+    message: "bg-teal-500/10 text-teal-600 dark:text-teal-400",
+};
+/**
+ * Search suggestions for empty state
+ */
+export const SEARCH_SUGGESTIONS = [
+    "Try searching for a document name",
+    "Search for a colleague by name",
+    "Find an AI agent to help you",
+    "Look up recent feedback items",
+];
+/**
+ * File type icon mapping
+ */
+export const FILE_EXTENSION_ICONS = {
+    pdf: FileType,
+    doc: FileText,
+    docx: FileText,
+    xls: FileSpreadsheet,
+    xlsx: FileSpreadsheet,
+    csv: FileSpreadsheet,
+    json: FileJson,
+    md: FileText,
+    txt: FileText,
+    js: FileCode,
+    ts: FileCode,
+    tsx: FileCode,
+    jsx: FileCode,
+    py: FileCode,
+    java: FileCode,
+    go: FileCode,
+    rs: FileCode,
+};
+/**
+ * Default file icon (fallback)
+ */
+export const DEFAULT_FILE_ICON = File;
+/**
+ * Message role display names
+ */
+export const MESSAGE_ROLE_LABELS = {
+    user: "You",
+    assistant: "Assistant",
+    system: "System",
+};
+/**
+ * Message role colors
+ */
+export const MESSAGE_ROLE_COLORS = {
+    user: "text-blue-500/70",
+    assistant: "text-green-500/70",
+    system: "text-muted-foreground/60",
+};
+/**
+ * Index name prefix for Captify search indices
+ */
+export const CAPTIFY_INDEX_PREFIX = "captify-search-";
+//# sourceMappingURL=search.constants.js.map