@open-mercato/search 0.4.2-canary-c02407ff85

package/src/modules/search/frontend/index.ts

@@ -0,0 +1,3 @@
+export { GlobalSearchDialog } from './components/GlobalSearchDialog'
+export { SearchSettingsPageClient } from './components/SearchSettingsPageClient'
+export { HybridSearchTable } from './components/HybridSearchTable'

package/src/modules/search/frontend/utils.ts

@@ -0,0 +1,82 @@
+import { readApiResultOrThrow } from '@open-mercato/ui/backend/utils/apiCall'
+import type { SearchResult, SearchStrategyId } from '@open-mercato/shared/modules/search'
+
+export type HybridSearchResponse = {
+  results: SearchResult[]
+  strategiesUsed: string[]
+  timing: number
+  error?: string | null
+}
+
+export type FetchHybridSearchOptions = {
+  limit?: number
+  strategies?: SearchStrategyId[]
+  signal?: AbortSignal
+}
+
+export async function fetchHybridSearchResults(
+  query: string,
+  opts: FetchHybridSearchOptions = {}
+): Promise<HybridSearchResponse> {
+  const params = new URLSearchParams()
+  params.set('q', query)
+
+  const limit = Math.max(1, Math.min(opts.limit ?? 50, 100))
+  params.set('limit', String(limit))
+
+  if (opts.strategies && opts.strategies.length > 0) {
+    params.set('strategies', opts.strategies.join(','))
+  }
+
+  const body = await readApiResultOrThrow<{
+    results?: SearchResult[]
+    strategiesUsed?: string[]
+    timing?: number
+    error?: string
+  }>(
+    `/api/search/search?${params.toString()}`,
+    { signal: opts.signal },
+    { errorMessage: 'Hybrid search failed', allowNullResult: true }
+  )
+
+  return {
+    results: Array.isArray(body?.results) ? body.results : [],
+    strategiesUsed: Array.isArray(body?.strategiesUsed) ? body.strategiesUsed : [],
+    timing: typeof body?.timing === 'number' ? body.timing : 0,
+    error: typeof body?.error === 'string' ? body.error : null,
+  }
+}
+
+/**
+ * Fetch global search results for the Cmd+K dialog.
+ * Uses the global search API which respects saved strategy settings.
+ */
+export type FetchGlobalSearchOptions = {
+  limit?: number
+  signal?: AbortSignal
+}
+
+export async function fetchGlobalSearchResults(
+  query: string,
+  opts: FetchGlobalSearchOptions = {}
+): Promise<{ results: SearchResult[]; error?: string | null }> {
+  const params = new URLSearchParams()
+  params.set('q', query)
+
+  const limit = Math.max(1, Math.min(opts.limit ?? 10, 50))
+  params.set('limit', String(limit))
+
+  const body = await readApiResultOrThrow<{
+    results?: SearchResult[]
+    error?: string
+  }>(
+    `/api/search/search/global?${params.toString()}`,
+    { signal: opts.signal },
+    { errorMessage: 'Search failed', allowNullResult: true }
+  )
+
+  return {
+    results: Array.isArray(body?.results) ? body.results : [],
+    error: typeof body?.error === 'string' ? body.error : null,
+  }
+}

package/src/modules/search/i18n/de.json

@@ -0,0 +1,61 @@
+{
+  "search.nav.hybridSearch": "Suche",
+  "search.config.nav.hybridSearch": "Sucheinstellungen",
+  "search.config.nav.embeddings": "Einbettungen",
+  "search.messages.missingConfig": "Die Suche erfordert die Konfiguration eines Embedding-Anbieters für die semantische Suche.",
+  "search.dialog.actions.search": "Suchen",
+  "search.dialog.actions.openGlobalSearch": "Globale Suche öffnen",
+  "search.dialog.actions.cancel": "Abbrechen (Esc)",
+  "search.dialog.actions.openSelected": "Öffnen (Enter)",
+  "search.dialog.instructions": "Tippe, um in indizierten Datensätzen zu suchen. Verwende die Pfeiltasten, um Ergebnisse zu navigieren.",
+  "search.dialog.input.placeholder": "Suche nach Kunden, Notizen, Deals, Aufgaben...",
+  "search.dialog.errors.searchFailed": "Suche ist fehlgeschlagen.",
+  "search.dialog.empty.hint": "Mindestens zwei Zeichen eingeben, um in indizierten Datensätzen zu suchen.",
+  "search.dialog.empty.none": "Keine Ergebnisse gefunden.",
+  "search.dialog.score.title": "Relevanz-Score",
+  "search.dialog.shortcuts.hint": "Drücke Cmd+K zum Umschalten. Enter zum Öffnen",
+  "search.dialog.noLink": "Kein Link",
+  "search.dialog.noLinkHint": "Keine search.ts Konfiguration für diesen Entitätstyp",
+  "search.settings.statusTitle": "Status der Suche",
+  "search.settings.statusEnabled": "Embedding-Anbieter konfiguriert. Semantische Suche ist verfügbar.",
+  "search.settings.statusDisabled": "Embedding-Anbieter nicht konfiguriert. Semantische Suche ist deaktiviert.",
+  "search.settings.autoIndexingLabel": "Datenbankänderungen automatisch indexieren",
+  "search.settings.autoIndexingDescription": "Hält den Suchindex bei Änderungen an Datensätzen automatisch synchron.",
+  "search.settings.autoIndexingLocked": "Auto-Indexierung wird durch die Umgebungsvariable DISABLE_VECTOR_SEARCH_AUTOINDEXING gesperrt.",
+  "search.settings.toggleSuccess": "Einstellung zur Auto-Indexierung gespeichert.",
+  "search.settings.toggleError": "Fehler beim Aktualisieren der Auto-Indexierung.",
+  "search.settings.refresh": "Status aktualisieren",
+  "search.settings.saving": "Speichern...",
+  "search.settings.loading": "Einstellungen werden geladen...",
+  "search.settings.embeddingProviderTitle": "Embedding-Anbieter",
+  "search.settings.embeddingProviderLabel": "Anbieter",
+  "search.settings.embeddingModelLabel": "Modell",
+  "search.settings.embeddingDimensionLabel": "Dimension",
+  "search.settings.embeddingNotConfigured": "nicht konfiguriert",
+  "search.settings.embeddingCustomModelOption": "Benutzerdefiniert...",
+  "search.settings.embeddingCustomModelNameLabel": "Modellname",
+  "search.settings.embeddingCustomDimensionLabel": "Dimensionen",
+  "search.settings.embeddingChangeWarningTitle": "Warnung: Diese Änderung erfordert vollständige Neuindexierung",
+  "search.settings.embeddingChangeWarningDescription": "Das Ändern des Embedding-Anbieters oder Modells erfordert die Neuerstellung aller Vektor-Einbettungen.",
+  "search.settings.embeddingChangeWarningBullet1": "Löscht ALLE vorhandenen Vektor-Einbettungen",
+  "search.settings.embeddingChangeWarningBullet2": "Löscht und erstellt die vector_search Tabelle neu",
+  "search.settings.embeddingChangeWarningBullet3": "Erfordert Neugenerierung der Einbettungen für alle indizierten Datensätze",
+  "search.settings.embeddingChangeWarningNote": "Die semantische Suche ist bis zum Abschluss der Neuindexierung nicht verfügbar.",
+  "search.settings.embeddingCancelLabel": "Abbrechen",
+  "search.settings.embeddingConfirmLabel": "Bestätigen & Anwenden",
+  "search.settings.embeddingProviderSuccess": "Embedding-Anbieter erfolgreich aktualisiert.",
+  "search.settings.embeddingProviderError": "Fehler beim Aktualisieren des Embedding-Anbieters.",
+  "search.api.errors.invalidProvider": "Ungültiger Embedding-Anbieter.",
+  "search.api.errors.providerNotConfigured": "Anbieter ist nicht konfiguriert. Setzen Sie die erforderliche Umgebungsvariable.",
+  "search.api.errors.recreateFailed": "Fehler beim Neuerstellen der Vektortabelle mit neuer Dimension.",
+  "search.settings.reindexTitle": "Suchdaten neu indexieren",
+  "search.settings.reindexDescription": "Einbettungen für alle indizierten Datensätze mit dem aktuellen Anbieter neu generieren.",
+  "search.settings.reindexButton": "Alles neu indexieren",
+  "search.settings.reindexWarning": "Dies führt zu API-Aufrufen an Ihren Embedding-Anbieter, was je nach Tarif Kosten verursachen kann.",
+  "search.settings.reindexConfirmTitle": "Neuindexierung bestätigen",
+  "search.settings.reindexConfirmDescription": "Dies wird Einbettungen für alle indizierten Datensätze neu generieren.",
+  "search.settings.reindexConfirmButton": "Neuindexierung starten",
+  "search.settings.reindexSuccess": "Neuindexierung erfolgreich gestartet.",
+  "search.settings.reindexError": "Fehler beim Starten der Neuindexierung.",
+  "search.settings.reindexing": "Neuindexierung..."
+}

package/src/modules/search/i18n/en.json

@@ -0,0 +1,72 @@
+{
+  "search.nav.hybridSearch": "Search",
+  "search.config.nav.hybridSearch": "Search Settings",
+  "search.messages.missingConfig": "Search requires configuring an embedding provider for semantic search.",
+  "search.dialog.actions.search": "Search",
+  "search.dialog.actions.openGlobalSearch": "Open global search",
+  "search.dialog.actions.cancel": "Cancel (Esc)",
+  "search.dialog.actions.openSelected": "Open (Enter)",
+  "search.dialog.instructions": "Type to search across indexed records. Use arrow keys to navigate results.",
+  "search.dialog.input.placeholder": "Search customers, notes, deals, todos...",
+  "search.dialog.errors.searchFailed": "Search failed.",
+  "search.dialog.empty.hint": "Type at least two characters to search indexed records.",
+  "search.dialog.empty.none": "No results found.",
+  "search.dialog.score.title": "Relevance score",
+  "search.dialog.shortcuts.hint": "Press Cmd+K to toggle. Enter to open",
+  "search.dialog.noLink": "No link",
+  "search.dialog.noLinkHint": "No search.ts config for this entity type",
+  "search.dialog.strategies.toggle": "Search options",
+  "search.dialog.strategies.label": "Search with:",
+  "search.dialog.strategies.fuzzy": "Fuzzy",
+  "search.dialog.strategies.fuzzyDescription": "Typo-tolerant full-text search",
+  "search.dialog.strategies.semantic": "Semantic",
+  "search.dialog.strategies.semanticDescription": "AI-powered meaning-based search",
+  "search.dialog.strategies.exact": "Exact",
+  "search.dialog.strategies.exactDescription": "Precise keyword matching",
+  "search.settings.title": "Search Settings",
+  "search.settings.loading": "Loading...",
+  "search.settings.status.configured": "Vector search configured",
+  "search.settings.status.notConfigured": "Vector search not configured",
+  "search.settings.badge.ready": "Ready",
+  "search.settings.badge.setup": "Setup Required",
+  "search.settings.errors.loadFailed": "Failed to load settings",
+  "search.settings.errors.saveFailed": "Failed to save settings",
+  "search.settings.errors.reindexFailed": "Reindex failed",
+  "search.settings.errors.modelRequired": "Please enter a model name",
+  "search.settings.errors.dimensionRequired": "Please enter a valid dimension",
+  "search.settings.messages.saved": "Settings saved",
+  "search.settings.messages.providerSaved": "Embedding provider saved",
+  "search.settings.messages.reindexStarted": "Reindex started",
+  "search.settings.provider.title": "Embedding Provider",
+  "search.settings.provider.label": "Provider",
+  "search.settings.provider.notConfigured": "not configured",
+  "search.settings.model.label": "Model",
+  "search.settings.model.custom": "Custom...",
+  "search.settings.model.namePlaceholder": "Model name",
+  "search.settings.dimension.label": "Dimensions",
+  "search.settings.dimension.mismatch": "mismatch",
+  "search.settings.status.title": "Auto-Indexing",
+  "search.settings.autoIndexing.label": "Enable auto-indexing",
+  "search.settings.autoIndexing.description": "Automatically index new and updated records for vector search.",
+  "search.settings.autoIndexing.locked": "Disabled via environment variable.",
+  "search.settings.reindex.title": "Reindex Data",
+  "search.settings.reindex.description": "Rebuild vector embeddings for all indexed entities.",
+  "search.settings.reindex.warning": "This may take a while for large datasets.",
+  "search.settings.reindex.button": "Start Reindex",
+  "search.settings.reindex.running": "Reindexing...",
+  "search.settings.reindex.confirmTitle": "Confirm Reindex",
+  "search.settings.reindex.confirmDescription": "This will rebuild all vector embeddings. Existing data will be purged first.",
+  "search.settings.reindex.confirmButton": "Start Reindex",
+  "search.settings.change.title": "Confirm Provider Change",
+  "search.settings.change.description": "Changing the embedding provider will require reindexing all data.",
+  "search.settings.change.bullet1": "Existing vector data will be cleared",
+  "search.settings.change.bullet2": "Vector search will be unavailable during reindex",
+  "search.settings.actions.apply": "Apply",
+  "search.settings.actions.cancel": "Cancel",
+  "search.settings.actions.confirm": "Confirm",
+  "search.settings.actions.loading": "Loading...",
+  "search.settings.actions.refresh": "Refresh",
+  "search.api.errors.invalidProvider": "Invalid embedding provider.",
+  "search.api.errors.providerNotConfigured": "Provider is not configured. Set the required environment variable.",
+  "search.api.errors.recreateFailed": "Failed to recreate vector table with new dimension."
+}

package/src/modules/search/i18n/es.json

@@ -0,0 +1,61 @@
+{
+  "search.nav.hybridSearch": "Búsqueda",
+  "search.config.nav.hybridSearch": "Configuración de búsqueda",
+  "search.config.nav.embeddings": "Embeddings",
+  "search.messages.missingConfig": "La búsqueda requiere configurar un proveedor de embeddings para la búsqueda semántica.",
+  "search.dialog.actions.search": "Buscar",
+  "search.dialog.actions.openGlobalSearch": "Abrir búsqueda global",
+  "search.dialog.actions.cancel": "Cancelar (Esc)",
+  "search.dialog.actions.openSelected": "Abrir (Enter)",
+  "search.dialog.instructions": "Escribe para buscar en los registros indexados. Usa las flechas para navegar por los resultados.",
+  "search.dialog.input.placeholder": "Busca clientes, notas, oportunidades, tareas...",
+  "search.dialog.errors.searchFailed": "La búsqueda falló.",
+  "search.dialog.empty.hint": "Escribe al menos dos caracteres para buscar en los registros indexados.",
+  "search.dialog.empty.none": "No se encontraron resultados.",
+  "search.dialog.score.title": "Puntuación de relevancia",
+  "search.dialog.shortcuts.hint": "Pulsa Cmd+K para alternar. Enter para abrir",
+  "search.dialog.noLink": "Sin enlace",
+  "search.dialog.noLinkHint": "No hay configuración search.ts para este tipo de entidad",
+  "search.settings.statusTitle": "Estado de la búsqueda",
+  "search.settings.statusEnabled": "Proveedor de embeddings configurado. La búsqueda semántica está disponible.",
+  "search.settings.statusDisabled": "Proveedor de embeddings no configurado. La búsqueda semántica está deshabilitada.",
+  "search.settings.autoIndexingLabel": "Indexar automáticamente los cambios en la base de datos",
+  "search.settings.autoIndexingDescription": "Mantiene el índice de búsqueda sincronizado cuando cambian los registros.",
+  "search.settings.autoIndexingLocked": "La indexación automática está bloqueada por la variable de entorno DISABLE_VECTOR_SEARCH_AUTOINDEXING.",
+  "search.settings.toggleSuccess": "Preferencia de indexación automática guardada.",
+  "search.settings.toggleError": "No se pudo actualizar la indexación automática.",
+  "search.settings.refresh": "Actualizar estado",
+  "search.settings.saving": "Guardando...",
+  "search.settings.loading": "Cargando ajustes...",
+  "search.settings.embeddingProviderTitle": "Proveedor de Embeddings",
+  "search.settings.embeddingProviderLabel": "Proveedor",
+  "search.settings.embeddingModelLabel": "Modelo",
+  "search.settings.embeddingDimensionLabel": "Dimensión",
+  "search.settings.embeddingNotConfigured": "no configurado",
+  "search.settings.embeddingCustomModelOption": "Personalizado...",
+  "search.settings.embeddingCustomModelNameLabel": "Nombre del modelo",
+  "search.settings.embeddingCustomDimensionLabel": "Dimensiones",
+  "search.settings.embeddingChangeWarningTitle": "Advertencia: Este cambio requiere reindexación completa",
+  "search.settings.embeddingChangeWarningDescription": "Cambiar el proveedor o modelo de embeddings requiere reconstruir todos los embeddings vectoriales.",
+  "search.settings.embeddingChangeWarningBullet1": "Eliminar TODOS los embeddings vectoriales existentes",
+  "search.settings.embeddingChangeWarningBullet2": "Eliminar y recrear la tabla vector_search",
+  "search.settings.embeddingChangeWarningBullet3": "Regenerar los embeddings para todos los registros indexados",
+  "search.settings.embeddingChangeWarningNote": "La búsqueda semántica no estará disponible hasta que se complete la reindexación.",
+  "search.settings.embeddingCancelLabel": "Cancelar",
+  "search.settings.embeddingConfirmLabel": "Confirmar y Aplicar",
+  "search.settings.embeddingProviderSuccess": "Proveedor de embeddings actualizado correctamente.",
+  "search.settings.embeddingProviderError": "No se pudo actualizar el proveedor de embeddings.",
+  "search.api.errors.invalidProvider": "Proveedor de embeddings no válido.",
+  "search.api.errors.providerNotConfigured": "El proveedor no está configurado. Configure la variable de entorno requerida.",
+  "search.api.errors.recreateFailed": "No se pudo recrear la tabla vectorial con la nueva dimensión.",
+  "search.settings.reindexTitle": "Reindexar datos de búsqueda",
+  "search.settings.reindexDescription": "Regenerar embeddings para todos los registros indexados usando el proveedor actual.",
+  "search.settings.reindexButton": "Reindexar todo",
+  "search.settings.reindexWarning": "Esto realizará llamadas API a su proveedor de embeddings, lo que puede generar costos según su plan.",
+  "search.settings.reindexConfirmTitle": "Confirmar reindexación",
+  "search.settings.reindexConfirmDescription": "Esto regenerará los embeddings para todos los registros indexados.",
+  "search.settings.reindexConfirmButton": "Iniciar reindexación",
+  "search.settings.reindexSuccess": "Reindexación iniciada correctamente.",
+  "search.settings.reindexError": "No se pudo iniciar la reindexación.",
+  "search.settings.reindexing": "Reindexando..."
+}

package/src/modules/search/i18n/pl.json

@@ -0,0 +1,61 @@
+{
+  "search.nav.hybridSearch": "Wyszukiwanie",
+  "search.config.nav.hybridSearch": "Ustawienia wyszukiwania",
+  "search.config.nav.embeddings": "Osadzenia",
+  "search.messages.missingConfig": "Wyszukiwanie wymaga skonfigurowania dostawcy embeddingów dla wyszukiwania semantycznego.",
+  "search.dialog.actions.search": "Szukaj",
+  "search.dialog.actions.openGlobalSearch": "Otwórz globalne wyszukiwanie",
+  "search.dialog.actions.cancel": "Anuluj (Esc)",
+  "search.dialog.actions.openSelected": "Otwórz (Enter)",
+  "search.dialog.instructions": "Wpisz tekst, aby przeszukać zindeksowane rekordy. Użyj strzałek do nawigacji po wynikach.",
+  "search.dialog.input.placeholder": "Szukaj klientów, notatek, szans, zadań...",
+  "search.dialog.errors.searchFailed": "Wyszukiwanie nie powiodło się.",
+  "search.dialog.empty.hint": "Wpisz co najmniej dwa znaki, aby przeszukać zindeksowane rekordy.",
+  "search.dialog.empty.none": "Brak wyników.",
+  "search.dialog.score.title": "Wynik trafności",
+  "search.dialog.shortcuts.hint": "Naciśnij Cmd+K, aby przełączyć. Enter, aby otworzyć",
+  "search.dialog.noLink": "Brak linku",
+  "search.dialog.noLinkHint": "Brak konfiguracji search.ts dla tego typu encji",
+  "search.settings.statusTitle": "Status wyszukiwania",
+  "search.settings.statusEnabled": "Dostawca osadzeń skonfigurowany. Wyszukiwanie semantyczne jest dostępne.",
+  "search.settings.statusDisabled": "Dostawca osadzeń nie skonfigurowany. Wyszukiwanie semantyczne jest wyłączone.",
+  "search.settings.autoIndexingLabel": "Automatycznie indeksuj zmiany w bazie danych",
+  "search.settings.autoIndexingDescription": "Utrzymuje aktualny indeks wyszukiwania przy każdej zmianie rekordów.",
+  "search.settings.autoIndexingLocked": "Automatyczne indeksowanie jest zablokowane przez zmienną środowiskową DISABLE_VECTOR_SEARCH_AUTOINDEXING.",
+  "search.settings.toggleSuccess": "Zapisano preferencję automatycznego indeksowania.",
+  "search.settings.toggleError": "Nie udało się zaktualizować automatycznego indeksowania.",
+  "search.settings.refresh": "Odśwież status",
+  "search.settings.saving": "Zapisywanie...",
+  "search.settings.loading": "Ładowanie ustawień...",
+  "search.settings.embeddingProviderTitle": "Dostawca osadzeń",
+  "search.settings.embeddingProviderLabel": "Dostawca",
+  "search.settings.embeddingModelLabel": "Model",
+  "search.settings.embeddingDimensionLabel": "Wymiar",
+  "search.settings.embeddingNotConfigured": "nie skonfigurowany",
+  "search.settings.embeddingCustomModelOption": "Niestandardowy...",
+  "search.settings.embeddingCustomModelNameLabel": "Nazwa modelu",
+  "search.settings.embeddingCustomDimensionLabel": "Wymiary",
+  "search.settings.embeddingChangeWarningTitle": "Uwaga: Ta zmiana wymaga pełnego reindeksowania",
+  "search.settings.embeddingChangeWarningDescription": "Zmiana dostawcy lub modelu osadzeń wymaga odbudowania wszystkich osadzeń wektorowych.",
+  "search.settings.embeddingChangeWarningBullet1": "Usunięcie WSZYSTKICH istniejących osadzeń wektorowych",
+  "search.settings.embeddingChangeWarningBullet2": "Usunięcie i ponowne utworzenie tabeli vector_search",
+  "search.settings.embeddingChangeWarningBullet3": "Ponowne generowanie osadzeń dla wszystkich zindeksowanych rekordów",
+  "search.settings.embeddingChangeWarningNote": "Wyszukiwanie semantyczne będzie niedostępne do zakończenia reindeksowania.",
+  "search.settings.embeddingCancelLabel": "Anuluj",
+  "search.settings.embeddingConfirmLabel": "Potwierdź i zastosuj",
+  "search.settings.embeddingProviderSuccess": "Dostawca osadzeń zaktualizowany pomyślnie.",
+  "search.settings.embeddingProviderError": "Nie udało się zaktualizować dostawcy embeddingów.",
+  "search.api.errors.invalidProvider": "Nieprawidłowy dostawca embeddingów.",
+  "search.api.errors.providerNotConfigured": "Dostawca nie jest skonfigurowany. Ustaw wymaganą zmienną środowiskową.",
+  "search.api.errors.recreateFailed": "Nie udało się odtworzyć tabeli wektorowej z nowym wymiarem.",
+  "search.settings.reindexTitle": "Reindeksacja danych wyszukiwania",
+  "search.settings.reindexDescription": "Wygeneruj ponownie osadzenia dla wszystkich zindeksowanych rekordów używając bieżącego dostawcy.",
+  "search.settings.reindexButton": "Reindeksuj wszystko",
+  "search.settings.reindexWarning": "To spowoduje wywołania API do dostawcy osadzeń, co może wiązać się z kosztami w zależności od planu.",
+  "search.settings.reindexConfirmTitle": "Potwierdź reindeksację",
+  "search.settings.reindexConfirmDescription": "To wygeneruje ponownie osadzenia dla wszystkich zindeksowanych rekordów.",
+  "search.settings.reindexConfirmButton": "Rozpocznij reindeksację",
+  "search.settings.reindexSuccess": "Reindeksacja rozpoczęta pomyślnie.",
+  "search.settings.reindexError": "Nie udało się rozpocząć reindeksacji.",
+  "search.settings.reindexing": "Reindeksowanie..."
+}

package/src/modules/search/index.ts

@@ -0,0 +1,9 @@
+import type { ModuleInfo } from '@open-mercato/shared/modules/registry'
+
+export const metadata: ModuleInfo = {
+  name: 'search',
+  title: 'Search',
+  version: '0.1.0',
+  description: 'Unified search module with pluggable strategies (Meilisearch, Vector, Tokens).',
+  author: 'FreightTech Team',
+}

package/src/modules/search/lib/auto-indexing.ts

@@ -0,0 +1,35 @@
+import type { ModuleConfigService } from '@open-mercato/core/modules/configs/lib/module-config-service'
+import { parseBooleanToken } from '@open-mercato/shared/lib/boolean'
+
+export const SEARCH_AUTO_INDEX_CONFIG_KEY = 'auto_index_enabled'
+
+export function envDisablesAutoIndexing(): boolean {
+  const raw = process.env.DISABLE_VECTOR_SEARCH_AUTOINDEXING
+  if (!raw) return false
+  return parseBooleanToken(raw) === true
+}
+
+type Resolver = {
+  resolve: <T = unknown>(name: string) => T
+}
+
+export async function resolveAutoIndexingEnabled(
+  resolver: Resolver,
+  options?: { defaultValue?: boolean },
+): Promise<boolean> {
+  if (envDisablesAutoIndexing()) return false
+  const fallback = options?.defaultValue ?? true
+  let service: ModuleConfigService
+  try {
+    service = resolver.resolve<ModuleConfigService>('moduleConfigService')
+  } catch {
+    return fallback
+  }
+  try {
+    // Still use 'vector' module key for backwards compatibility
+    const value = await service.getValue<boolean>('vector', SEARCH_AUTO_INDEX_CONFIG_KEY, { defaultValue: fallback })
+    return value !== false
+  } catch {
+    return fallback
+  }
+}

package/src/modules/search/lib/embedding-config.ts

@@ -0,0 +1,161 @@
+import type { ModuleConfigService } from '@open-mercato/core/modules/configs/lib/module-config-service'
+import type { EmbeddingProviderConfig, EmbeddingProviderId } from '../../../vector'
+import { EMBEDDING_CONFIG_KEY, EMBEDDING_PROVIDERS, DEFAULT_EMBEDDING_CONFIG } from '../../../vector'
+
+export { EMBEDDING_CONFIG_KEY }
+
+export type EmbeddingConfigChange = {
+  previousConfig: EmbeddingProviderConfig | null
+  newConfig: EmbeddingProviderConfig
+  requiresReindex: boolean
+  reason: string | null
+}
+
+export function detectConfigChange(
+  previousConfig: EmbeddingProviderConfig | null,
+  newConfig: EmbeddingProviderConfig,
+  indexedDimension?: number | null
+): EmbeddingConfigChange {
+  const newDimension = newConfig.outputDimensionality ?? newConfig.dimension
+
+  if (!previousConfig) {
+    // First time setup - check if indexed dimension differs from new config
+    if (indexedDimension !== null && indexedDimension !== undefined && indexedDimension !== newDimension) {
+      return {
+        previousConfig,
+        newConfig,
+        requiresReindex: true,
+        reason: `Indexed dimension (${indexedDimension}) differs from new config (${newDimension})`,
+      }
+    }
+    return {
+      previousConfig,
+      newConfig,
+      requiresReindex: false,
+      reason: null,
+    }
+  }
+
+  const previousDimension = previousConfig.outputDimensionality ?? previousConfig.dimension
+
+  if (previousConfig.providerId !== newConfig.providerId) {
+    return {
+      previousConfig,
+      newConfig,
+      requiresReindex: true,
+      reason: `Provider changed from ${EMBEDDING_PROVIDERS[previousConfig.providerId].name} to ${EMBEDDING_PROVIDERS[newConfig.providerId].name}`,
+    }
+  }
+
+  if (previousConfig.model !== newConfig.model) {
+    return {
+      previousConfig,
+      newConfig,
+      requiresReindex: true,
+      reason: `Model changed from ${previousConfig.model} to ${newConfig.model}`,
+    }
+  }
+
+  if (previousDimension !== newDimension) {
+    return {
+      previousConfig,
+      newConfig,
+      requiresReindex: true,
+      reason: `Dimension changed from ${previousDimension} to ${newDimension}`,
+    }
+  }
+
+  // Also check if indexed dimension differs from config dimension
+  if (indexedDimension !== null && indexedDimension !== undefined && indexedDimension !== newDimension) {
+    return {
+      previousConfig,
+      newConfig,
+      requiresReindex: true,
+      reason: `Indexed dimension (${indexedDimension}) differs from config (${newDimension})`,
+    }
+  }
+
+  return {
+    previousConfig,
+    newConfig,
+    requiresReindex: false,
+    reason: null,
+  }
+}
+
+export function isProviderConfigured(providerId: EmbeddingProviderId): boolean {
+  switch (providerId) {
+    case 'openai':
+      return Boolean(process.env.OPENAI_API_KEY?.trim())
+    case 'google':
+      return Boolean(process.env.GOOGLE_GENERATIVE_AI_API_KEY?.trim())
+    case 'mistral':
+      return Boolean(process.env.MISTRAL_API_KEY?.trim())
+    case 'cohere':
+      return Boolean(process.env.COHERE_API_KEY?.trim())
+    case 'bedrock':
+      return Boolean(process.env.AWS_ACCESS_KEY_ID?.trim() && process.env.AWS_SECRET_ACCESS_KEY?.trim())
+    case 'ollama':
+      return true
+    default:
+      return false
+  }
+}
+
+export function getConfiguredProviders(): EmbeddingProviderId[] {
+  const providers: EmbeddingProviderId[] = []
+  const allProviders: EmbeddingProviderId[] = ['openai', 'google', 'mistral', 'cohere', 'bedrock', 'ollama']
+  for (const providerId of allProviders) {
+    if (isProviderConfigured(providerId)) {
+      providers.push(providerId)
+    }
+  }
+  return providers
+}
+
+export function getEffectiveDimension(config: EmbeddingProviderConfig): number {
+  return config.outputDimensionality ?? config.dimension
+}
+
+type Resolver = {
+  resolve: <T = unknown>(name: string) => T
+}
+
+export async function resolveEmbeddingConfig(
+  resolver: Resolver,
+  options?: { defaultValue?: EmbeddingProviderConfig | null }
+): Promise<EmbeddingProviderConfig | null> {
+  const fallback = options?.defaultValue ?? null
+  let service: ModuleConfigService
+  try {
+    service = resolver.resolve<ModuleConfigService>('moduleConfigService')
+  } catch {
+    return fallback
+  }
+  try {
+    const value = await service.getValue<EmbeddingProviderConfig>('vector', EMBEDDING_CONFIG_KEY, { defaultValue: fallback })
+    return value
+  } catch {
+    return fallback
+  }
+}
+
+export async function saveEmbeddingConfig(
+  resolver: Resolver,
+  config: EmbeddingProviderConfig
+): Promise<void> {
+  let service: ModuleConfigService
+  try {
+    service = resolver.resolve<ModuleConfigService>('moduleConfigService')
+  } catch {
+    throw new Error('Configuration service unavailable')
+  }
+  await service.setValue('vector', EMBEDDING_CONFIG_KEY, {
+    ...config,
+    updatedAt: new Date().toISOString(),
+  })
+}
+
+export function createDefaultConfig(): EmbeddingProviderConfig {
+  return { ...DEFAULT_EMBEDDING_CONFIG, updatedAt: new Date().toISOString() }
+}

package/src/modules/search/lib/global-search-config.ts

@@ -0,0 +1,69 @@
+import type { ModuleConfigService } from '@open-mercato/core/modules/configs/lib/module-config-service'
+import type { SearchStrategyId } from '@open-mercato/shared/modules/search'
+
+export const GLOBAL_SEARCH_STRATEGIES_KEY = 'global_search_strategies'
+
+/** Default strategies when none are configured */
+export const DEFAULT_GLOBAL_SEARCH_STRATEGIES: SearchStrategyId[] = ['fulltext', 'vector', 'tokens']
+
+type Resolver = {
+  resolve: <T = unknown>(name: string) => T
+}
+
+/**
+ * Get the enabled strategies for global search (Cmd+K).
+ * Falls back to all strategies if not configured.
+ */
+export async function resolveGlobalSearchStrategies(
+  resolver: Resolver,
+  options?: { defaultValue?: SearchStrategyId[] },
+): Promise<SearchStrategyId[]> {
+  const fallback = options?.defaultValue ?? DEFAULT_GLOBAL_SEARCH_STRATEGIES
+  let service: ModuleConfigService
+  try {
+    service = resolver.resolve<ModuleConfigService>('moduleConfigService')
+  } catch {
+    return fallback
+  }
+  try {
+    const value = await service.getValue<SearchStrategyId[]>('search', GLOBAL_SEARCH_STRATEGIES_KEY, { defaultValue: fallback })
+    // Ensure we always return a non-empty array
+    if (!Array.isArray(value) || value.length === 0) {
+      return fallback
+    }
+    return value
+  } catch {
+    return fallback
+  }
+}
+
+/**
+ * Save the enabled strategies for global search.
+ */
+export async function saveGlobalSearchStrategies(
+  resolver: Resolver,
+  strategies: SearchStrategyId[],
+): Promise<void> {
+  let service: ModuleConfigService
+  try {
+    service = resolver.resolve<ModuleConfigService>('moduleConfigService')
+  } catch {
+    throw new Error('Module config service not available')
+  }
+
+  // Validate that at least one strategy is enabled
+  if (!Array.isArray(strategies) || strategies.length === 0) {
+    throw new Error('At least one search strategy must be enabled')
+  }
+
+  // Filter to only valid strategy IDs
+  const validStrategies = strategies.filter(
+    (s) => ['fulltext', 'vector', 'tokens'].includes(s)
+  ) as SearchStrategyId[]
+
+  if (validStrategies.length === 0) {
+    throw new Error('At least one valid search strategy must be enabled')
+  }
+
+  await service.setValue('search', GLOBAL_SEARCH_STRATEGIES_KEY, validStrategies)
+}