@open-mercato/search 0.6.6-develop.5586.1.c9ed1d68a8 → 0.6.6-develop.5588.1.a8f6c51d1f

package/.turbo/turbo-build.log

@@ -1,2 +1,2 @@
-[build:search] found 88 entry points
+[build:search] found 89 entry points
 [build:search] built successfully

package/dist/lib/debug.js

@@ -18,6 +18,13 @@ function searchDebugWarn(prefix, message, data) {
     console.warn(`[${prefix}] ${message}`);
   }
 }
+function searchWarn(prefix, message, data) {
+  if (data) {
+    console.warn(`[${prefix}] ${message}`, data);
+  } else {
+    console.warn(`[${prefix}] ${message}`);
+  }
+}
 function searchError(prefix, message, data) {
   if (data) {
     console.error(`[${prefix}] ${message}`, data);
@@ -29,6 +36,7 @@ export {
   isSearchDebugEnabled,
   searchDebug,
   searchDebugWarn,
-  searchError
+  searchError,
+  searchWarn
 };
 //# sourceMappingURL=debug.js.map

package/dist/lib/debug.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/debug.ts"],
-  "sourcesContent": ["/**\n * Debug utilities for search module.\n *\n * Set OM_SEARCH_DEBUG=true to enable debug logging.\n */\n\nexport function isSearchDebugEnabled(): boolean {\n  const raw = (process.env.OM_SEARCH_DEBUG ?? '').toLowerCase()\n  return raw === '1' || raw === 'true' || raw === 'yes' || raw === 'on'\n}\n\n/**\n * Log a debug message if OM_SEARCH_DEBUG is enabled.\n */\nexport function searchDebug(prefix: string, message: string, data?: Record<string, unknown>): void {\n  if (!isSearchDebugEnabled()) return\n  if (data) {\n    console.log(`[${prefix}] ${message}`, data)\n  } else {\n    console.log(`[${prefix}] ${message}`)\n  }\n}\n\n/**\n * Log a warning message if OM_SEARCH_DEBUG is enabled.\n */\nexport function searchDebugWarn(prefix: string, message: string, data?: Record<string, unknown>): void {\n  if (!isSearchDebugEnabled()) return\n  if (data) {\n    console.warn(`[${prefix}] ${message}`, data)\n  } else {\n    console.warn(`[${prefix}] ${message}`)\n  }\n}\n\n/**\n * Log an error message (always logs, not gated by debug flag).\n * Errors should always be visible for troubleshooting.\n */\nexport function searchError(prefix: string, message: string, data?: Record<string, unknown>): void {\n  if (data) {\n    console.error(`[${prefix}] ${message}`, data)\n  } else {\n    console.error(`[${prefix}] ${message}`)\n  }\n}\n"],
-  "mappings": "AAMO,SAAS,uBAAgC;AAC9C,QAAM,OAAO,QAAQ,IAAI,mBAAmB,IAAI,YAAY;AAC5D,SAAO,QAAQ,OAAO,QAAQ,UAAU,QAAQ,SAAS,QAAQ;AACnE;AAKO,SAAS,YAAY,QAAgB,SAAiB,MAAsC;AACjG,MAAI,CAAC,qBAAqB,EAAG;AAC7B,MAAI,MAAM;AACR,YAAQ,IAAI,IAAI,MAAM,KAAK,OAAO,IAAI,IAAI;AAAA,EAC5C,OAAO;AACL,YAAQ,IAAI,IAAI,MAAM,KAAK,OAAO,EAAE;AAAA,EACtC;AACF;AAKO,SAAS,gBAAgB,QAAgB,SAAiB,MAAsC;AACrG,MAAI,CAAC,qBAAqB,EAAG;AAC7B,MAAI,MAAM;AACR,YAAQ,KAAK,IAAI,MAAM,KAAK,OAAO,IAAI,IAAI;AAAA,EAC7C,OAAO;AACL,YAAQ,KAAK,IAAI,MAAM,KAAK,OAAO,EAAE;AAAA,EACvC;AACF;AAMO,SAAS,YAAY,QAAgB,SAAiB,MAAsC;AACjG,MAAI,MAAM;AACR,YAAQ,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,IAAI;AAAA,EAC9C,OAAO;AACL,YAAQ,MAAM,IAAI,MAAM,KAAK,OAAO,EAAE;AAAA,EACxC;AACF;",
+  "sourcesContent": ["/**\n * Debug utilities for search module.\n *\n * Set OM_SEARCH_DEBUG=true to enable debug logging.\n */\n\nexport function isSearchDebugEnabled(): boolean {\n  const raw = (process.env.OM_SEARCH_DEBUG ?? '').toLowerCase()\n  return raw === '1' || raw === 'true' || raw === 'yes' || raw === 'on'\n}\n\n/**\n * Log a debug message if OM_SEARCH_DEBUG is enabled.\n */\nexport function searchDebug(prefix: string, message: string, data?: Record<string, unknown>): void {\n  if (!isSearchDebugEnabled()) return\n  if (data) {\n    console.log(`[${prefix}] ${message}`, data)\n  } else {\n    console.log(`[${prefix}] ${message}`)\n  }\n}\n\n/**\n * Log a warning message if OM_SEARCH_DEBUG is enabled.\n */\nexport function searchDebugWarn(prefix: string, message: string, data?: Record<string, unknown>): void {\n  if (!isSearchDebugEnabled()) return\n  if (data) {\n    console.warn(`[${prefix}] ${message}`, data)\n  } else {\n    console.warn(`[${prefix}] ${message}`)\n  }\n}\n\n/**\n * Log a warning message (always logs, not gated by debug flag).\n * Use for operational warnings that must stay visible without OM_SEARCH_DEBUG,\n * such as skipping a vector-index run because the provider is unreachable or\n * the configured embedding dimension no longer matches the vector table.\n */\nexport function searchWarn(prefix: string, message: string, data?: Record<string, unknown>): void {\n  if (data) {\n    console.warn(`[${prefix}] ${message}`, data)\n  } else {\n    console.warn(`[${prefix}] ${message}`)\n  }\n}\n\n/**\n * Log an error message (always logs, not gated by debug flag).\n * Errors should always be visible for troubleshooting.\n */\nexport function searchError(prefix: string, message: string, data?: Record<string, unknown>): void {\n  if (data) {\n    console.error(`[${prefix}] ${message}`, data)\n  } else {\n    console.error(`[${prefix}] ${message}`)\n  }\n}\n"],
+  "mappings": "AAMO,SAAS,uBAAgC;AAC9C,QAAM,OAAO,QAAQ,IAAI,mBAAmB,IAAI,YAAY;AAC5D,SAAO,QAAQ,OAAO,QAAQ,UAAU,QAAQ,SAAS,QAAQ;AACnE;AAKO,SAAS,YAAY,QAAgB,SAAiB,MAAsC;AACjG,MAAI,CAAC,qBAAqB,EAAG;AAC7B,MAAI,MAAM;AACR,YAAQ,IAAI,IAAI,MAAM,KAAK,OAAO,IAAI,IAAI;AAAA,EAC5C,OAAO;AACL,YAAQ,IAAI,IAAI,MAAM,KAAK,OAAO,EAAE;AAAA,EACtC;AACF;AAKO,SAAS,gBAAgB,QAAgB,SAAiB,MAAsC;AACrG,MAAI,CAAC,qBAAqB,EAAG;AAC7B,MAAI,MAAM;AACR,YAAQ,KAAK,IAAI,MAAM,KAAK,OAAO,IAAI,IAAI;AAAA,EAC7C,OAAO;AACL,YAAQ,KAAK,IAAI,MAAM,KAAK,OAAO,EAAE;AAAA,EACvC;AACF;AAQO,SAAS,WAAW,QAAgB,SAAiB,MAAsC;AAChG,MAAI,MAAM;AACR,YAAQ,KAAK,IAAI,MAAM,KAAK,OAAO,IAAI,IAAI;AAAA,EAC7C,OAAO;AACL,YAAQ,KAAK,IAAI,MAAM,KAAK,OAAO,EAAE;AAAA,EACvC;AACF;AAMO,SAAS,YAAY,QAAgB,SAAiB,MAAsC;AACjG,MAAI,MAAM;AACR,YAAQ,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,IAAI;AAAA,EAC9C,OAAO;AACL,YAAQ,MAAM,IAAI,MAAM,KAAK,OAAO,EAAE;AAAA,EACxC;AACF;",
   "names": []
 }

package/dist/modules/search/workers/vector-index.worker.js

@@ -4,7 +4,8 @@ import { applyCoverageAdjustments, createCoverageAdjustments } from "@open-merca
 import { logVectorOperation } from "../../../vector/lib/vector-logs.js";
 import { resolveAutoIndexingEnabled } from "../lib/auto-indexing.js";
 import { resolveEmbeddingConfig } from "../lib/embedding-config.js";
-import { searchDebugWarn } from "../../../lib/debug.js";
+import { searchDebugWarn, searchWarn } from "../../../lib/debug.js";
+import { evaluateVectorPreflight } from "../../../vector/lib/preflight.js";
 import { clearReindexLock, updateReindexProgress } from "../lib/reindex-lock.js";
 import { incrementReindexProgress } from "../lib/reindex-progress.js";
 const DEFAULT_CONCURRENCY = 2;
@@ -13,6 +14,32 @@ const metadata = {
   queue: VECTOR_INDEXING_QUEUE_NAME,
   concurrency: envConcurrency ? parseInt(envConcurrency, 10) : DEFAULT_CONCURRENCY
 };
+async function runVectorPreflight(ctx, options) {
+  let embeddingService = null;
+  try {
+    embeddingService = ctx.resolve("vectorEmbeddingService");
+  } catch {
+    embeddingService = null;
+  }
+  if (!embeddingService) return { ok: true };
+  let tableDimension = null;
+  try {
+    const drivers = ctx.resolve("vectorDrivers");
+    const pgvectorDriver = drivers.find((driver) => driver.id === "pgvector");
+    if (pgvectorDriver?.getTableDimension) {
+      tableDimension = await pgvectorDriver.getTableDimension();
+    }
+  } catch {
+    tableDimension = null;
+  }
+  const service = embeddingService;
+  return evaluateVectorPreflight({
+    providerConfigured: service.available,
+    effectiveDimension: typeof service.dimension === "number" ? service.dimension : null,
+    tableDimension,
+    probe: options.withProbe ? () => service.createEmbedding("preflight") : void 0
+  });
+}
 async function handleVectorIndexJob(job, jobCtx, ctx) {
   const { jobType, entityType, recordId, tenantId, organizationId, records } = job.payload;
   if (jobType === "batch-index") {
@@ -57,6 +84,32 @@ async function handleVectorIndexJob(job, jobCtx, ctx) {
         error: configErr instanceof Error ? configErr.message : configErr
       });
     }
+    const preflight = await runVectorPreflight(ctx, { withProbe: true });
+    if (!preflight.ok) {
+      searchWarn("vector-index.worker", `Skipping vector batch: ${preflight.reason}`, {
+        jobId: jobCtx.jobId,
+        code: preflight.code,
+        totalRecords: records.length,
+        tenantId
+      });
+      if (db && records.length > 0) {
+        await updateReindexProgress(db, tenantId, "vector", records.length, organizationId ?? null);
+      }
+      if (progressService && em2 && records.length > 0) {
+        const completed = await incrementReindexProgress({
+          em: em2,
+          progressService,
+          type: "vector",
+          tenantId,
+          organizationId: organizationId ?? null,
+          delta: records.length
+        });
+        if (completed && db) {
+          await clearReindexLock(db, tenantId, "vector", organizationId ?? null);
+        }
+      }
+      return;
+    }
     let successCount = 0;
     let failCount = 0;
     for (const { entityId, recordId: recId } of records) {
@@ -136,6 +189,19 @@ async function handleVectorIndexJob(job, jobCtx, ctx) {
       });
     }
   }
+  if (jobType === "index") {
+    const preflight = await runVectorPreflight(ctx, { withProbe: false });
+    if (!preflight.ok) {
+      searchWarn("vector-index.worker", `Skipping vector index for record: ${preflight.reason}`, {
+        jobId: jobCtx.jobId,
+        code: preflight.code,
+        entityType,
+        recordId,
+        tenantId
+      });
+      return;
+    }
+  }
   let em = null;
   try {
     em = ctx.resolve("em");

package/dist/modules/search/workers/vector-index.worker.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/search/workers/vector-index.worker.ts"],
-  "sourcesContent": ["import type { QueuedJob, JobContext, WorkerMeta } from '@open-mercato/queue'\nimport type { Kysely } from 'kysely'\nimport { VECTOR_INDEXING_QUEUE_NAME, type VectorIndexJobPayload } from '../../../queue/vector-indexing'\nimport type { SearchIndexer } from '../../../indexer/search-indexer'\nimport type { EmbeddingService } from '../../../vector'\nimport type { EntityManager } from '@mikro-orm/postgresql'\n\nimport type { ProgressService } from '@open-mercato/core/modules/progress/lib/progressService'\nimport { recordIndexerError } from '@open-mercato/shared/lib/indexers/error-log'\nimport { applyCoverageAdjustments, createCoverageAdjustments } from '@open-mercato/core/modules/query_index/lib/coverage'\nimport { logVectorOperation } from '../../../vector/lib/vector-logs'\nimport { resolveAutoIndexingEnabled } from '../lib/auto-indexing'\nimport { resolveEmbeddingConfig } from '../lib/embedding-config'\nimport { searchDebugWarn } from '../../../lib/debug'\nimport { clearReindexLock, updateReindexProgress } from '../lib/reindex-lock'\nimport { incrementReindexProgress } from '../lib/reindex-progress'\n\n// Worker metadata for auto-discovery\nconst DEFAULT_CONCURRENCY = 2\nconst envConcurrency = process.env.WORKERS_VECTOR_INDEXING_CONCURRENCY\n\nexport const metadata: WorkerMeta = {\n  queue: VECTOR_INDEXING_QUEUE_NAME,\n  concurrency: envConcurrency ? parseInt(envConcurrency, 10) : DEFAULT_CONCURRENCY,\n}\n\ntype HandlerContext = { resolve: <T = unknown>(name: string) => T }\n\n/**\n * Process a vector index job.\n *\n * This handler is called by the queue worker to process indexing and deletion jobs.\n * It uses SearchIndexer to load records and index them via SearchService.\n *\n * @param job - The queued job containing payload\n * @param jobCtx - Queue job context with job ID and attempt info\n * @param ctx - DI container context for resolving services\n */\nexport async function handleVectorIndexJob(\n  job: QueuedJob<VectorIndexJobPayload>,\n  jobCtx: JobContext,\n  ctx: HandlerContext,\n): Promise<void> {\n  const { jobType, entityType, recordId, tenantId, organizationId, records } = job.payload\n\n  // Handle batch-index jobs (from reindex operations)\n  if (jobType === 'batch-index') {\n    if (!records?.length || !tenantId) {\n      searchDebugWarn('vector-index.worker', 'Skipping batch-index job with missing required fields', {\n        jobId: jobCtx.jobId,\n        recordCount: records?.length ?? 0,\n        tenantId,\n      })\n      return\n    }\n\n    let searchIndexer: SearchIndexer\n    try {\n      searchIndexer = ctx.resolve<SearchIndexer>('searchIndexer')\n    } catch {\n      searchDebugWarn('vector-index.worker', 'searchIndexer not available')\n      return\n    }\n\n    // Get Kysely for heartbeat updates\n    let db: Kysely<any> | null = null\n    let em: EntityManager | null = null\n    try {\n      em = ctx.resolve('em') as EntityManager\n      db = (em as unknown as { getKysely: () => Kysely<any> }).getKysely()\n    } catch {\n      db = null\n      em = null\n    }\n\n    let progressService: ProgressService | null = null\n    try {\n      progressService = ctx.resolve<ProgressService>('progressService')\n    } catch {\n      progressService = null\n    }\n\n    // Load saved embedding config to use the correct provider/model\n    try {\n      const embeddingConfig = await resolveEmbeddingConfig(ctx, { defaultValue: null })\n      if (embeddingConfig) {\n        const embeddingService = ctx.resolve<EmbeddingService>('vectorEmbeddingService')\n        embeddingService.updateConfig(embeddingConfig)\n      }\n    } catch (configErr) {\n      searchDebugWarn('vector-index.worker', 'Failed to load embedding config for batch, using defaults', {\n        error: configErr instanceof Error ? configErr.message : configErr,\n      })\n    }\n\n    // Process each record in the batch\n    let successCount = 0\n    let failCount = 0\n    for (const { entityId, recordId: recId } of records) {\n      try {\n        const result = await searchIndexer.indexRecordById({\n          entityId: entityId as Parameters<typeof searchIndexer.indexRecordById>[0]['entityId'],\n          recordId: recId,\n          tenantId,\n          organizationId,\n        })\n        if (result.action === 'indexed') {\n          successCount++\n        }\n      } catch (error) {\n        failCount++\n        searchDebugWarn('vector-index.worker', 'Failed to index record in batch', {\n          entityId,\n          recordId: recId,\n          error: error instanceof Error ? error.message : error,\n        })\n      }\n    }\n\n    // Update heartbeat to signal worker is still processing\n    if (db && records.length > 0) {\n      await updateReindexProgress(db, tenantId, 'vector', successCount, organizationId ?? null)\n    }\n    if (progressService && em && records.length > 0) {\n      const completed = await incrementReindexProgress({\n        em,\n        progressService,\n        type: 'vector',\n        tenantId,\n        organizationId: organizationId ?? null,\n        delta: successCount,\n      })\n      if (completed && db) {\n        await clearReindexLock(db, tenantId, 'vector', organizationId ?? null)\n      }\n    }\n\n    searchDebugWarn('vector-index.worker', 'Batch-index job completed', {\n      jobId: jobCtx.jobId,\n      totalRecords: records.length,\n      successCount,\n      failCount,\n    })\n    return\n  }\n\n  // Handle single record jobs (index/delete)\n  if (!entityType || !recordId || !tenantId) {\n    searchDebugWarn('vector-index.worker', 'Skipping job with missing required fields', {\n      jobId: jobCtx.jobId,\n      entityType,\n      recordId,\n      tenantId,\n    })\n    return\n  }\n\n  const autoIndexingEnabled = await resolveAutoIndexingEnabled(ctx, { defaultValue: true })\n  if (!autoIndexingEnabled) {\n    return\n  }\n\n  let searchIndexer: SearchIndexer\n  try {\n    searchIndexer = ctx.resolve<SearchIndexer>('searchIndexer')\n  } catch {\n    searchDebugWarn('vector-index.worker', 'searchIndexer not available')\n    return\n  }\n\n  // Load saved embedding config to use the correct provider/model\n  try {\n    const embeddingConfig = await resolveEmbeddingConfig(ctx, { defaultValue: null })\n    if (embeddingConfig) {\n      const embeddingService = ctx.resolve<EmbeddingService>('vectorEmbeddingService')\n      embeddingService.updateConfig(embeddingConfig)\n    }\n  } catch (configErr) {\n    // Delete operations don't require embedding, only warn for index operations\n    if (jobType === 'index') {\n      searchDebugWarn('vector-index.worker', 'Failed to load embedding config, using defaults', {\n        error: configErr instanceof Error ? configErr.message : configErr,\n      })\n    }\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let em: any | null = null\n  try {\n    em = ctx.resolve('em')\n  } catch {\n    em = null\n  }\n\n  let eventBus: { emitEvent(event: string, payload: unknown, options?: unknown): Promise<void> } | null = null\n  try {\n    eventBus = ctx.resolve('eventBus')\n  } catch {\n    eventBus = null\n  }\n\n  const handlerName = jobType === 'delete'\n    ? 'worker:vector-indexing:delete'\n    : 'worker:vector-indexing:index'\n\n  try {\n    let action: 'indexed' | 'deleted' | 'skipped' = 'skipped'\n    let delta = 0\n\n    if (jobType === 'delete') {\n      await searchIndexer.deleteRecord({\n        entityId: entityType,\n        recordId,\n        tenantId,\n      })\n      action = 'deleted'\n      delta = -1\n    } else {\n      const result = await searchIndexer.indexRecordById({\n        entityId: entityType,\n        recordId,\n        tenantId,\n        organizationId,\n      })\n      action = result.action\n      if (result.action === 'indexed') {\n        delta = 1\n      }\n    }\n\n    if (delta !== 0) {\n      let adjustmentsApplied = false\n      if (em) {\n        try {\n          const adjustments = createCoverageAdjustments({\n            entityType,\n            tenantId,\n            organizationId,\n            baseDelta: 0,\n            indexDelta: 0,\n            vectorDelta: delta,\n          })\n          if (adjustments.length) {\n            await applyCoverageAdjustments(em, adjustments)\n            adjustmentsApplied = true\n          }\n        } catch (coverageError) {\n          searchDebugWarn('vector-index.worker', 'Failed to adjust vector coverage', {\n            error: coverageError instanceof Error ? coverageError.message : coverageError,\n          })\n        }\n      }\n\n      if (!adjustmentsApplied && eventBus) {\n        try {\n          await eventBus.emitEvent('query_index.coverage.refresh', {\n            entityType,\n            tenantId,\n            organizationId,\n            withDeleted: false,\n            delayMs: 1000,\n          })\n        } catch (emitError) {\n          searchDebugWarn('vector-index.worker', 'Failed to enqueue coverage refresh', {\n            error: emitError instanceof Error ? emitError.message : emitError,\n          })\n        }\n      }\n    }\n\n    await logVectorOperation({\n      em,\n      handler: handlerName,\n      entityType,\n      recordId,\n      result: {\n        action,\n        tenantId,\n        organizationId: organizationId ?? null,\n        created: action === 'indexed',\n        existed: action === 'deleted',\n      },\n    })\n  } catch (error) {\n    searchDebugWarn('vector-index.worker', `Failed to ${jobType} vector index`, {\n      entityType,\n      recordId,\n      error: error instanceof Error ? error.message : error,\n    })\n    await recordIndexerError(\n      { em: em ?? undefined },\n      {\n        source: 'vector',\n        handler: handlerName,\n        error,\n        entityType,\n        recordId,\n        tenantId,\n        organizationId,\n        payload: job.payload,\n      },\n    )\n    // Re-throw to let the queue handle retry logic\n    throw error\n  }\n}\n\n/**\n * Default export for worker auto-discovery.\n * Wraps handleVectorIndexJob to match the expected handler signature.\n */\nexport default async function handle(\n  job: QueuedJob<VectorIndexJobPayload>,\n  ctx: JobContext & HandlerContext\n): Promise<void> {\n  return handleVectorIndexJob(job, ctx, ctx)\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { QueuedJob, JobContext, WorkerMeta } from '@open-mercato/queue'\nimport type { Kysely } from 'kysely'\nimport { VECTOR_INDEXING_QUEUE_NAME, type VectorIndexJobPayload } from '../../../queue/vector-indexing'\nimport type { SearchIndexer } from '../../../indexer/search-indexer'\nimport type { EmbeddingService, VectorDriver } from '../../../vector'\nimport type { EntityManager } from '@mikro-orm/postgresql'\n\nimport type { ProgressService } from '@open-mercato/core/modules/progress/lib/progressService'\nimport { recordIndexerError } from '@open-mercato/shared/lib/indexers/error-log'\nimport { applyCoverageAdjustments, createCoverageAdjustments } from '@open-mercato/core/modules/query_index/lib/coverage'\nimport { logVectorOperation } from '../../../vector/lib/vector-logs'\nimport { resolveAutoIndexingEnabled } from '../lib/auto-indexing'\nimport { resolveEmbeddingConfig } from '../lib/embedding-config'\nimport { searchDebugWarn, searchWarn } from '../../../lib/debug'\nimport { evaluateVectorPreflight, type VectorPreflightResult } from '../../../vector/lib/preflight'\nimport { clearReindexLock, updateReindexProgress } from '../lib/reindex-lock'\nimport { incrementReindexProgress } from '../lib/reindex-progress'\n\n// Worker metadata for auto-discovery\nconst DEFAULT_CONCURRENCY = 2\nconst envConcurrency = process.env.WORKERS_VECTOR_INDEXING_CONCURRENCY\n\nexport const metadata: WorkerMeta = {\n  queue: VECTOR_INDEXING_QUEUE_NAME,\n  concurrency: envConcurrency ? parseInt(envConcurrency, 10) : DEFAULT_CONCURRENCY,\n}\n\ntype HandlerContext = { resolve: <T = unknown>(name: string) => T }\n\n/**\n * Decide once per job whether vector work can succeed, so the worker can skip a\n * doomed run with a single warning instead of failing every record. When the\n * embedding service is not resolvable we return `ok` and let the existing\n * strategy path decide, preserving prior behavior.\n *\n * `withProbe` issues one tiny embedding to detect an unreachable provider; use\n * it for bulk reindex batches, not for hot single-record writes.\n */\nasync function runVectorPreflight(\n  ctx: HandlerContext,\n  options: { withProbe: boolean },\n): Promise<VectorPreflightResult> {\n  let embeddingService: EmbeddingService | null = null\n  try {\n    embeddingService = ctx.resolve<EmbeddingService>('vectorEmbeddingService')\n  } catch {\n    embeddingService = null\n  }\n  if (!embeddingService) return { ok: true }\n\n  let tableDimension: number | null = null\n  try {\n    const drivers = ctx.resolve<VectorDriver[]>('vectorDrivers')\n    const pgvectorDriver = drivers.find((driver) => driver.id === 'pgvector')\n    if (pgvectorDriver?.getTableDimension) {\n      tableDimension = await pgvectorDriver.getTableDimension()\n    }\n  } catch {\n    tableDimension = null\n  }\n\n  const service = embeddingService\n  return evaluateVectorPreflight({\n    providerConfigured: service.available,\n    effectiveDimension: typeof service.dimension === 'number' ? service.dimension : null,\n    tableDimension,\n    probe: options.withProbe ? () => service.createEmbedding('preflight') : undefined,\n  })\n}\n\n/**\n * Process a vector index job.\n *\n * This handler is called by the queue worker to process indexing and deletion jobs.\n * It uses SearchIndexer to load records and index them via SearchService.\n *\n * @param job - The queued job containing payload\n * @param jobCtx - Queue job context with job ID and attempt info\n * @param ctx - DI container context for resolving services\n */\nexport async function handleVectorIndexJob(\n  job: QueuedJob<VectorIndexJobPayload>,\n  jobCtx: JobContext,\n  ctx: HandlerContext,\n): Promise<void> {\n  const { jobType, entityType, recordId, tenantId, organizationId, records } = job.payload\n\n  // Handle batch-index jobs (from reindex operations)\n  if (jobType === 'batch-index') {\n    if (!records?.length || !tenantId) {\n      searchDebugWarn('vector-index.worker', 'Skipping batch-index job with missing required fields', {\n        jobId: jobCtx.jobId,\n        recordCount: records?.length ?? 0,\n        tenantId,\n      })\n      return\n    }\n\n    let searchIndexer: SearchIndexer\n    try {\n      searchIndexer = ctx.resolve<SearchIndexer>('searchIndexer')\n    } catch {\n      searchDebugWarn('vector-index.worker', 'searchIndexer not available')\n      return\n    }\n\n    // Get Kysely for heartbeat updates\n    let db: Kysely<any> | null = null\n    let em: EntityManager | null = null\n    try {\n      em = ctx.resolve('em') as EntityManager\n      db = (em as unknown as { getKysely: () => Kysely<any> }).getKysely()\n    } catch {\n      db = null\n      em = null\n    }\n\n    let progressService: ProgressService | null = null\n    try {\n      progressService = ctx.resolve<ProgressService>('progressService')\n    } catch {\n      progressService = null\n    }\n\n    // Load saved embedding config to use the correct provider/model\n    try {\n      const embeddingConfig = await resolveEmbeddingConfig(ctx, { defaultValue: null })\n      if (embeddingConfig) {\n        const embeddingService = ctx.resolve<EmbeddingService>('vectorEmbeddingService')\n        embeddingService.updateConfig(embeddingConfig)\n      }\n    } catch (configErr) {\n      searchDebugWarn('vector-index.worker', 'Failed to load embedding config for batch, using defaults', {\n        error: configErr instanceof Error ? configErr.message : configErr,\n      })\n    }\n\n    // Preflight once: if the provider is unreachable/misconfigured or its\n    // dimension no longer matches the shared vector table, skip the whole batch\n    // with a single warning instead of failing every record. Still advance the\n    // reindex progress/lock so the run completes (records counted as processed).\n    const preflight = await runVectorPreflight(ctx, { withProbe: true })\n    if (!preflight.ok) {\n      searchWarn('vector-index.worker', `Skipping vector batch: ${preflight.reason}`, {\n        jobId: jobCtx.jobId,\n        code: preflight.code,\n        totalRecords: records.length,\n        tenantId,\n      })\n      if (db && records.length > 0) {\n        await updateReindexProgress(db, tenantId, 'vector', records.length, organizationId ?? null)\n      }\n      if (progressService && em && records.length > 0) {\n        const completed = await incrementReindexProgress({\n          em,\n          progressService,\n          type: 'vector',\n          tenantId,\n          organizationId: organizationId ?? null,\n          delta: records.length,\n        })\n        if (completed && db) {\n          await clearReindexLock(db, tenantId, 'vector', organizationId ?? null)\n        }\n      }\n      return\n    }\n\n    // Process each record in the batch\n    let successCount = 0\n    let failCount = 0\n    for (const { entityId, recordId: recId } of records) {\n      try {\n        const result = await searchIndexer.indexRecordById({\n          entityId: entityId as Parameters<typeof searchIndexer.indexRecordById>[0]['entityId'],\n          recordId: recId,\n          tenantId,\n          organizationId,\n        })\n        if (result.action === 'indexed') {\n          successCount++\n        }\n      } catch (error) {\n        failCount++\n        searchDebugWarn('vector-index.worker', 'Failed to index record in batch', {\n          entityId,\n          recordId: recId,\n          error: error instanceof Error ? error.message : error,\n        })\n      }\n    }\n\n    // Update heartbeat to signal worker is still processing\n    if (db && records.length > 0) {\n      await updateReindexProgress(db, tenantId, 'vector', successCount, organizationId ?? null)\n    }\n    if (progressService && em && records.length > 0) {\n      const completed = await incrementReindexProgress({\n        em,\n        progressService,\n        type: 'vector',\n        tenantId,\n        organizationId: organizationId ?? null,\n        delta: successCount,\n      })\n      if (completed && db) {\n        await clearReindexLock(db, tenantId, 'vector', organizationId ?? null)\n      }\n    }\n\n    searchDebugWarn('vector-index.worker', 'Batch-index job completed', {\n      jobId: jobCtx.jobId,\n      totalRecords: records.length,\n      successCount,\n      failCount,\n    })\n    return\n  }\n\n  // Handle single record jobs (index/delete)\n  if (!entityType || !recordId || !tenantId) {\n    searchDebugWarn('vector-index.worker', 'Skipping job with missing required fields', {\n      jobId: jobCtx.jobId,\n      entityType,\n      recordId,\n      tenantId,\n    })\n    return\n  }\n\n  const autoIndexingEnabled = await resolveAutoIndexingEnabled(ctx, { defaultValue: true })\n  if (!autoIndexingEnabled) {\n    return\n  }\n\n  let searchIndexer: SearchIndexer\n  try {\n    searchIndexer = ctx.resolve<SearchIndexer>('searchIndexer')\n  } catch {\n    searchDebugWarn('vector-index.worker', 'searchIndexer not available')\n    return\n  }\n\n  // Load saved embedding config to use the correct provider/model\n  try {\n    const embeddingConfig = await resolveEmbeddingConfig(ctx, { defaultValue: null })\n    if (embeddingConfig) {\n      const embeddingService = ctx.resolve<EmbeddingService>('vectorEmbeddingService')\n      embeddingService.updateConfig(embeddingConfig)\n    }\n  } catch (configErr) {\n    // Delete operations don't require embedding, only warn for index operations\n    if (jobType === 'index') {\n      searchDebugWarn('vector-index.worker', 'Failed to load embedding config, using defaults', {\n        error: configErr instanceof Error ? configErr.message : configErr,\n      })\n    }\n  }\n\n  // Preflight index jobs only (delete never needs the provider): skip with a\n  // single warning when the provider is misconfigured or the configured\n  // dimension no longer matches the shared vector table. No reachability probe\n  // here \u2014 single-record writes are the hot path and the cheap checks already\n  // catch the common misconfiguration without an extra embedding call.\n  if (jobType === 'index') {\n    const preflight = await runVectorPreflight(ctx, { withProbe: false })\n    if (!preflight.ok) {\n      searchWarn('vector-index.worker', `Skipping vector index for record: ${preflight.reason}`, {\n        jobId: jobCtx.jobId,\n        code: preflight.code,\n        entityType,\n        recordId,\n        tenantId,\n      })\n      return\n    }\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let em: any | null = null\n  try {\n    em = ctx.resolve('em')\n  } catch {\n    em = null\n  }\n\n  let eventBus: { emitEvent(event: string, payload: unknown, options?: unknown): Promise<void> } | null = null\n  try {\n    eventBus = ctx.resolve('eventBus')\n  } catch {\n    eventBus = null\n  }\n\n  const handlerName = jobType === 'delete'\n    ? 'worker:vector-indexing:delete'\n    : 'worker:vector-indexing:index'\n\n  try {\n    let action: 'indexed' | 'deleted' | 'skipped' = 'skipped'\n    let delta = 0\n\n    if (jobType === 'delete') {\n      await searchIndexer.deleteRecord({\n        entityId: entityType,\n        recordId,\n        tenantId,\n      })\n      action = 'deleted'\n      delta = -1\n    } else {\n      const result = await searchIndexer.indexRecordById({\n        entityId: entityType,\n        recordId,\n        tenantId,\n        organizationId,\n      })\n      action = result.action\n      if (result.action === 'indexed') {\n        delta = 1\n      }\n    }\n\n    if (delta !== 0) {\n      let adjustmentsApplied = false\n      if (em) {\n        try {\n          const adjustments = createCoverageAdjustments({\n            entityType,\n            tenantId,\n            organizationId,\n            baseDelta: 0,\n            indexDelta: 0,\n            vectorDelta: delta,\n          })\n          if (adjustments.length) {\n            await applyCoverageAdjustments(em, adjustments)\n            adjustmentsApplied = true\n          }\n        } catch (coverageError) {\n          searchDebugWarn('vector-index.worker', 'Failed to adjust vector coverage', {\n            error: coverageError instanceof Error ? coverageError.message : coverageError,\n          })\n        }\n      }\n\n      if (!adjustmentsApplied && eventBus) {\n        try {\n          await eventBus.emitEvent('query_index.coverage.refresh', {\n            entityType,\n            tenantId,\n            organizationId,\n            withDeleted: false,\n            delayMs: 1000,\n          })\n        } catch (emitError) {\n          searchDebugWarn('vector-index.worker', 'Failed to enqueue coverage refresh', {\n            error: emitError instanceof Error ? emitError.message : emitError,\n          })\n        }\n      }\n    }\n\n    await logVectorOperation({\n      em,\n      handler: handlerName,\n      entityType,\n      recordId,\n      result: {\n        action,\n        tenantId,\n        organizationId: organizationId ?? null,\n        created: action === 'indexed',\n        existed: action === 'deleted',\n      },\n    })\n  } catch (error) {\n    searchDebugWarn('vector-index.worker', `Failed to ${jobType} vector index`, {\n      entityType,\n      recordId,\n      error: error instanceof Error ? error.message : error,\n    })\n    await recordIndexerError(\n      { em: em ?? undefined },\n      {\n        source: 'vector',\n        handler: handlerName,\n        error,\n        entityType,\n        recordId,\n        tenantId,\n        organizationId,\n        payload: job.payload,\n      },\n    )\n    // Re-throw to let the queue handle retry logic\n    throw error\n  }\n}\n\n/**\n * Default export for worker auto-discovery.\n * Wraps handleVectorIndexJob to match the expected handler signature.\n */\nexport default async function handle(\n  job: QueuedJob<VectorIndexJobPayload>,\n  ctx: JobContext & HandlerContext\n): Promise<void> {\n  return handleVectorIndexJob(job, ctx, ctx)\n}\n"],
+  "mappings": "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",
   "names": ["searchIndexer", "em"]
 }

package/dist/vector/lib/preflight.js

@@ -0,0 +1,32 @@
+async function evaluateVectorPreflight(input) {
+  if (!input.providerConfigured) {
+    return {
+      ok: false,
+      code: "provider_not_configured",
+      reason: "embedding provider is not configured (missing API key/base URL); set the provider credentials or re-point the provider in Settings \u2192 Search"
+    };
+  }
+  if (typeof input.effectiveDimension === "number" && typeof input.tableDimension === "number" && input.effectiveDimension !== input.tableDimension) {
+    return {
+      ok: false,
+      code: "dimension_mismatch",
+      reason: `configured provider produces ${input.effectiveDimension}-dim embeddings but the shared vector table is ${input.tableDimension}-dim; re-point the provider in Settings \u2192 Search to recreate the table at the new dimension, then reindex`
+    };
+  }
+  if (input.probe) {
+    try {
+      await input.probe();
+    } catch (error) {
+      return {
+        ok: false,
+        code: "provider_unreachable",
+        reason: `embedding provider is unreachable: ${error instanceof Error ? error.message : String(error)}`
+      };
+    }
+  }
+  return { ok: true };
+}
+export {
+  evaluateVectorPreflight
+};
+//# sourceMappingURL=preflight.js.map

package/dist/vector/lib/preflight.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vector/lib/preflight.ts"],
+  "sourcesContent": ["/**\n * Vector indexing preflight.\n *\n * The embedding provider config and the pgvector table dimension are global\n * (per-database), not per-tenant. When the configured provider is unreachable,\n * not configured, or produces a dimension that no longer matches the shared\n * vector table, every record in a reindex run fails the same way \u2014 producing a\n * storm of per-record errors and wasted embedding calls.\n *\n * This helper lets a caller decide ONCE per run whether vector work can succeed,\n * so it can skip with a single warning instead of failing every record. It is a\n * pure function: the reachability probe is injected so it stays unit-testable.\n */\n\nexport type VectorPreflightSkipCode =\n  | 'provider_not_configured'\n  | 'dimension_mismatch'\n  | 'provider_unreachable'\n\nexport type VectorPreflightInput = {\n  /** Whether the active embedding provider has its credentials/config present. */\n  providerConfigured: boolean\n  /** Dimension the active embedding config will produce (null when unknown). */\n  effectiveDimension: number | null\n  /** Dimension of the shared vector table (null when unknown/unavailable). */\n  tableDimension: number | null\n  /**\n   * Optional reachability probe. When provided it is invoked last and MUST\n   * throw if the provider cannot be reached. Omit it on hot paths (e.g.\n   * single-record indexing) where the extra embedding call is not worth it.\n   */\n  probe?: () => Promise<unknown>\n}\n\nexport type VectorPreflightResult =\n  | { ok: true }\n  | { ok: false; code: VectorPreflightSkipCode; reason: string }\n\nexport async function evaluateVectorPreflight(\n  input: VectorPreflightInput,\n): Promise<VectorPreflightResult> {\n  if (!input.providerConfigured) {\n    return {\n      ok: false,\n      code: 'provider_not_configured',\n      reason:\n        'embedding provider is not configured (missing API key/base URL); set the provider credentials or re-point the provider in Settings \u2192 Search',\n    }\n  }\n\n  if (\n    typeof input.effectiveDimension === 'number' &&\n    typeof input.tableDimension === 'number' &&\n    input.effectiveDimension !== input.tableDimension\n  ) {\n    return {\n      ok: false,\n      code: 'dimension_mismatch',\n      reason:\n        `configured provider produces ${input.effectiveDimension}-dim embeddings but the shared vector table is ${input.tableDimension}-dim; ` +\n        're-point the provider in Settings \u2192 Search to recreate the table at the new dimension, then reindex',\n    }\n  }\n\n  if (input.probe) {\n    try {\n      await input.probe()\n    } catch (error) {\n      return {\n        ok: false,\n        code: 'provider_unreachable',\n        reason: `embedding provider is unreachable: ${error instanceof Error ? error.message : String(error)}`,\n      }\n    }\n  }\n\n  return { ok: true }\n}\n"],
+  "mappings": "AAsCA,eAAsB,wBACpB,OACgC;AAChC,MAAI,CAAC,MAAM,oBAAoB;AAC7B,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,QACE;AAAA,IACJ;AAAA,EACF;AAEA,MACE,OAAO,MAAM,uBAAuB,YACpC,OAAO,MAAM,mBAAmB,YAChC,MAAM,uBAAuB,MAAM,gBACnC;AACA,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,QACE,gCAAgC,MAAM,kBAAkB,kDAAkD,MAAM,cAAc;AAAA,IAElI;AAAA,EACF;AAEA,MAAI,MAAM,OAAO;AACf,QAAI;AACF,YAAM,MAAM,MAAM;AAAA,IACpB,SAAS,OAAO;AACd,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,MAAM;AAAA,QACN,QAAQ,sCAAsC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,MACtG;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,IAAI,KAAK;AACpB;",
+  "names": []
+}

package/dist/vector/services/embedding.js

@@ -187,17 +187,22 @@ class EmbeddingService {
     const model = this.getEmbeddingModel();
     const providerOptions = this.getProviderOptions();
     const timeoutMs = resolveEmbeddingTimeoutMs();
+    const abortController = new AbortController();
     let timeoutHandle = null;
     try {
       const result = await Promise.race([
         embed({
           model,
           value: merged,
+          abortSignal: abortController.signal,
           ...providerOptions && { providerOptions }
         }),
         new Promise((_, reject) => {
           timeoutHandle = setTimeout(
-            () => reject(timeoutError(this.config.providerId, timeoutMs)),
+            () => {
+              abortController.abort();
+              reject(timeoutError(this.config.providerId, timeoutMs));
+            },
             timeoutMs
           );
         })

package/dist/vector/services/embedding.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/vector/services/embedding.ts"],
-  "sourcesContent": ["import { embed } from 'ai'\nimport type { EmbeddingModel } from 'ai'\nimport { createOpenAI } from '@ai-sdk/openai'\n\n// Local type definition to avoid @ai-sdk/provider version conflicts\n// Matches SharedV3ProviderOptions = Record<string, JSONObject>\ntype JSONValue = string | number | boolean | null | JSONValue[] | { [key: string]: JSONValue }\ntype JSONObject = { [key: string]: JSONValue }\ntype ProviderOptions = Record<string, JSONObject>\nimport { createGoogleGenerativeAI } from '@ai-sdk/google'\nimport { createMistral } from '@ai-sdk/mistral'\nimport { createCohere } from '@ai-sdk/cohere'\nimport { createAmazonBedrock } from '@ai-sdk/amazon-bedrock'\nimport { createOllama } from 'ai-sdk-ollama'\nimport type { EmbeddingProviderId, EmbeddingProviderConfig } from '../types'\nimport { EMBEDDING_PROVIDERS, DEFAULT_EMBEDDING_CONFIG } from '../types'\n\nexport type EmbeddingServiceOptions = {\n  apiKey?: string\n  model?: string\n  config?: EmbeddingProviderConfig\n}\n\ntype OllamaClient = ReturnType<typeof createOllama>\n\ntype ProviderClient = ReturnType<typeof createOpenAI>\n  | ReturnType<typeof createGoogleGenerativeAI>\n  | ReturnType<typeof createMistral>\n  | ReturnType<typeof createCohere>\n  | ReturnType<typeof createAmazonBedrock>\n  | OllamaClient\n\nconst DEFAULT_EMBEDDING_TIMEOUT_MS = 3_000\n\nfunction resolveEmbeddingTimeoutMs(): number {\n  const rawValue = process.env.VECTOR_EMBEDDING_TIMEOUT_MS\n  if (!rawValue) return DEFAULT_EMBEDDING_TIMEOUT_MS\n  const parsed = Number.parseInt(rawValue, 10)\n  if (!Number.isFinite(parsed) || parsed <= 0) {\n    return DEFAULT_EMBEDDING_TIMEOUT_MS\n  }\n  return parsed\n}\n\nfunction timeoutError(providerId: EmbeddingProviderId, timeoutMs: number): Error {\n  const providerInfo = EMBEDDING_PROVIDERS[providerId]\n  return new Error(\n    `${providerInfo.name} request timed out after ${timeoutMs}ms. Check ${providerInfo.envKeyRequired}.`,\n  )\n}\n\nexport class EmbeddingService {\n  private config: EmbeddingProviderConfig\n  private clientCache: Map<EmbeddingProviderId, ProviderClient> = new Map()\n\n  constructor(private readonly opts: EmbeddingServiceOptions = {}) {\n    if (opts.config) {\n      this.config = opts.config\n    } else {\n      this.config = {\n        providerId: 'openai',\n        model: opts.model ?? DEFAULT_EMBEDDING_CONFIG.model,\n        dimension: DEFAULT_EMBEDDING_CONFIG.dimension,\n        updatedAt: new Date().toISOString(),\n      }\n    }\n  }\n\n  updateConfig(config: EmbeddingProviderConfig): void {\n    this.config = config\n    this.clientCache.clear()\n  }\n\n  get currentConfig(): EmbeddingProviderConfig {\n    return { ...this.config }\n  }\n\n  get dimension(): number {\n    return this.config.outputDimensionality ?? this.config.dimension\n  }\n\n  get available(): boolean {\n    return this.isProviderConfigured(this.config.providerId)\n  }\n\n  private isProviderConfigured(providerId: EmbeddingProviderId): boolean {\n    switch (providerId) {\n      case 'openai':\n        return Boolean(this.opts.apiKey ?? process.env.OPENAI_API_KEY)\n      case 'google':\n        return Boolean(process.env.GOOGLE_GENERATIVE_AI_API_KEY)\n      case 'mistral':\n        return Boolean(process.env.MISTRAL_API_KEY)\n      case 'cohere':\n        return Boolean(process.env.COHERE_API_KEY)\n      case 'bedrock':\n        return Boolean(process.env.AWS_ACCESS_KEY_ID && process.env.AWS_SECRET_ACCESS_KEY)\n      case 'ollama':\n        return true\n      default:\n        return false\n    }\n  }\n\n  private getClient(providerId: EmbeddingProviderId): ProviderClient {\n    const cached = this.clientCache.get(providerId)\n    if (cached) {\n      return cached\n    }\n\n    let client: ProviderClient\n    switch (providerId) {\n      case 'openai': {\n        const apiKey = this.opts.apiKey ?? process.env.OPENAI_API_KEY\n        if (!apiKey) {\n          throw new Error('[vector.embedding] Missing OPENAI_API_KEY environment variable')\n        }\n        client = createOpenAI({ apiKey })\n        break\n      }\n      case 'google': {\n        const apiKey = process.env.GOOGLE_GENERATIVE_AI_API_KEY\n        if (!apiKey) {\n          throw new Error('[vector.embedding] Missing GOOGLE_GENERATIVE_AI_API_KEY environment variable')\n        }\n        client = createGoogleGenerativeAI({ apiKey })\n        break\n      }\n      case 'mistral': {\n        const apiKey = process.env.MISTRAL_API_KEY\n        if (!apiKey) {\n          throw new Error('[vector.embedding] Missing MISTRAL_API_KEY environment variable')\n        }\n        client = createMistral({ apiKey })\n        break\n      }\n      case 'cohere': {\n        const apiKey = process.env.COHERE_API_KEY\n        if (!apiKey) {\n          throw new Error('[vector.embedding] Missing COHERE_API_KEY environment variable')\n        }\n        client = createCohere({ apiKey })\n        break\n      }\n      case 'bedrock': {\n        const accessKeyId = process.env.AWS_ACCESS_KEY_ID\n        const secretAccessKey = process.env.AWS_SECRET_ACCESS_KEY\n        if (!accessKeyId || !secretAccessKey) {\n          throw new Error('[vector.embedding] Missing AWS_ACCESS_KEY_ID or AWS_SECRET_ACCESS_KEY environment variables')\n        }\n        client = createAmazonBedrock({\n          accessKeyId,\n          secretAccessKey,\n          region: process.env.AWS_REGION ?? 'us-east-1',\n        })\n        break\n      }\n      case 'ollama': {\n        const baseURL = this.config.baseUrl ?? process.env.OLLAMA_BASE_URL ?? 'http://localhost:11434'\n        client = createOllama({ baseURL })\n        break\n      }\n      default:\n        throw new Error(`[vector.embedding] Unknown provider: ${providerId}`)\n    }\n\n    this.clientCache.set(providerId, client)\n    return client\n  }\n\n  private getEmbeddingModel() {\n    const client = this.getClient(this.config.providerId)\n    const { providerId, model, outputDimensionality } = this.config\n\n    switch (providerId) {\n      case 'openai':\n        return (client as ReturnType<typeof createOpenAI>).embedding(model)\n      case 'google':\n        return (client as ReturnType<typeof createGoogleGenerativeAI>).textEmbeddingModel(model)\n      case 'mistral':\n        return (client as ReturnType<typeof createMistral>).textEmbeddingModel(model)\n      case 'cohere':\n        return (client as ReturnType<typeof createCohere>).textEmbeddingModel(model)\n      case 'bedrock':\n        return (client as ReturnType<typeof createAmazonBedrock>).embedding(model)\n      case 'ollama':\n        return (client as OllamaClient).embedding(model)\n      default:\n        throw new Error(`[vector.embedding] Unknown provider: ${providerId}`)\n    }\n  }\n\n  private getProviderOptions(): ProviderOptions | undefined {\n    const { providerId, outputDimensionality, model } = this.config\n\n    if (!outputDimensionality) {\n      if (providerId === 'cohere') {\n        return { cohere: { inputType: 'search_document' } }\n      }\n      return undefined\n    }\n\n    switch (providerId) {\n      case 'openai':\n        if (model === 'text-embedding-3-large' || model === 'text-embedding-3-small') {\n        return { openai: { dimensions: outputDimensionality } }\n        }\n        return undefined\n      case 'google':\n        return { google: { outputDimensionality } }\n      case 'bedrock':\n        return { bedrock: { dimensions: outputDimensionality } }\n      case 'cohere':\n        return { cohere: { inputType: 'search_document' } }\n      default:\n        return undefined\n    }\n  }\n\n  async createEmbedding(input: string | string[]): Promise<number[]> {\n    const merged = Array.isArray(input)\n      ? input.map((part) => String(part ?? '')).filter((part) => part.length > 0).join('\\n\\n')\n      : String(input ?? '')\n    if (!merged.length) {\n      throw new Error('[vector.embedding] Refusing to embed empty payload')\n    }\n\n    if (!this.available) {\n      const providerInfo = EMBEDDING_PROVIDERS[this.config.providerId]\n      throw new Error(`[vector.embedding] Provider ${providerInfo.name} is not configured. Set ${providerInfo.envKeyRequired} environment variable.`)\n    }\n\n    const model = this.getEmbeddingModel() as EmbeddingModel\n    const providerOptions = this.getProviderOptions()\n    const timeoutMs = resolveEmbeddingTimeoutMs()\n\n    let timeoutHandle: ReturnType<typeof setTimeout> | null = null\n    try {\n      const result = await Promise.race([\n        embed({\n          model,\n          value: merged,\n          ...(providerOptions && { providerOptions }),\n        }),\n        new Promise<never>((_, reject) => {\n          timeoutHandle = setTimeout(\n            () => reject(timeoutError(this.config.providerId, timeoutMs)),\n            timeoutMs,\n          )\n        }),\n      ])\n      const emb = Array.isArray(result.embedding)\n        ? result.embedding\n        : Array.from(result.embedding as ArrayLike<number>)\n      return emb.map((n) => Number.isFinite(n) ? Number(n) : 0)\n    } catch (err: unknown) {\n      const error = err as { statusCode?: number; status?: number; response?: { status?: number; statusCode?: number; data?: { error?: { message?: string; code?: string }; message?: string } }; data?: { error?: { message?: string; code?: string } }; body?: { error?: { message?: string; code?: string } }; message?: string }\n      const statusCandidate =\n        error?.statusCode ?? error?.status ?? error?.response?.status ?? error?.response?.statusCode\n      const status =\n        typeof statusCandidate === 'number'\n          ? Number.isFinite(statusCandidate) ? statusCandidate : undefined\n          : typeof statusCandidate === 'string'\n            ? Number.parseInt(statusCandidate, 10)\n            : undefined\n      const apiError = error?.data?.error ?? error?.body?.error ?? error?.response?.data?.error\n      const apiMessage = apiError?.message ?? error?.response?.data?.message\n      const apiCode = typeof apiError?.code === 'string' ? apiError.code : undefined\n      const rawMessage = typeof apiMessage === 'string'\n        ? apiMessage\n        : (typeof error?.message === 'string' ? error.message : 'Embedding request failed')\n\n      const providerInfo = EMBEDDING_PROVIDERS[this.config.providerId]\n      let guidance: string\n      switch (apiCode) {\n        case 'insufficient_quota':\n          guidance = `${providerInfo.name} usage quota exceeded. Please review your plan and billing.`\n          break\n        case 'invalid_api_key':\n          guidance = `Invalid ${providerInfo.name} API key. Update the key and retry.`\n          break\n        case 'account_deactivated':\n          guidance = `${providerInfo.name} account is disabled. Contact support or provide a different key.`\n          break\n        default:\n          guidance = rawMessage.startsWith('[vector.embedding] ')\n            ? rawMessage.slice('[vector.embedding] '.length)\n            : rawMessage.includes('https://')\n            ? rawMessage\n            : rawMessage.includes(providerInfo.envKeyRequired)\n              ? rawMessage\n              : `${rawMessage}. Check ${providerInfo.envKeyRequired}.`\n      }\n      const wrapped = new Error(`[vector.embedding] ${guidance}`) as Error & { status?: number; code?: string; cause?: unknown }\n      if (typeof status === 'number' && Number.isFinite(status)) {\n        const normalizedStatus = status === 401 || status === 403 ? 502 : status\n        if (normalizedStatus >= 400 && normalizedStatus < 600) {\n          wrapped.status = normalizedStatus\n        }\n      }\n      if (apiCode) {\n        wrapped.code = apiCode\n      }\n      wrapped.cause = err\n      throw wrapped\n    } finally {\n      if (timeoutHandle !== null) {\n        clearTimeout(timeoutHandle)\n      }\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { embed } from 'ai'\nimport type { EmbeddingModel } from 'ai'\nimport { createOpenAI } from '@ai-sdk/openai'\n\n// Local type definition to avoid @ai-sdk/provider version conflicts\n// Matches SharedV3ProviderOptions = Record<string, JSONObject>\ntype JSONValue = string | number | boolean | null | JSONValue[] | { [key: string]: JSONValue }\ntype JSONObject = { [key: string]: JSONValue }\ntype ProviderOptions = Record<string, JSONObject>\nimport { createGoogleGenerativeAI } from '@ai-sdk/google'\nimport { createMistral } from '@ai-sdk/mistral'\nimport { createCohere } from '@ai-sdk/cohere'\nimport { createAmazonBedrock } from '@ai-sdk/amazon-bedrock'\nimport { createOllama } from 'ai-sdk-ollama'\nimport type { EmbeddingProviderId, EmbeddingProviderConfig } from '../types'\nimport { EMBEDDING_PROVIDERS, DEFAULT_EMBEDDING_CONFIG } from '../types'\n\nexport type EmbeddingServiceOptions = {\n  apiKey?: string\n  model?: string\n  config?: EmbeddingProviderConfig\n}\n\ntype OllamaClient = ReturnType<typeof createOllama>\n\ntype ProviderClient = ReturnType<typeof createOpenAI>\n  | ReturnType<typeof createGoogleGenerativeAI>\n  | ReturnType<typeof createMistral>\n  | ReturnType<typeof createCohere>\n  | ReturnType<typeof createAmazonBedrock>\n  | OllamaClient\n\nconst DEFAULT_EMBEDDING_TIMEOUT_MS = 3_000\n\nfunction resolveEmbeddingTimeoutMs(): number {\n  const rawValue = process.env.VECTOR_EMBEDDING_TIMEOUT_MS\n  if (!rawValue) return DEFAULT_EMBEDDING_TIMEOUT_MS\n  const parsed = Number.parseInt(rawValue, 10)\n  if (!Number.isFinite(parsed) || parsed <= 0) {\n    return DEFAULT_EMBEDDING_TIMEOUT_MS\n  }\n  return parsed\n}\n\nfunction timeoutError(providerId: EmbeddingProviderId, timeoutMs: number): Error {\n  const providerInfo = EMBEDDING_PROVIDERS[providerId]\n  return new Error(\n    `${providerInfo.name} request timed out after ${timeoutMs}ms. Check ${providerInfo.envKeyRequired}.`,\n  )\n}\n\nexport class EmbeddingService {\n  private config: EmbeddingProviderConfig\n  private clientCache: Map<EmbeddingProviderId, ProviderClient> = new Map()\n\n  constructor(private readonly opts: EmbeddingServiceOptions = {}) {\n    if (opts.config) {\n      this.config = opts.config\n    } else {\n      this.config = {\n        providerId: 'openai',\n        model: opts.model ?? DEFAULT_EMBEDDING_CONFIG.model,\n        dimension: DEFAULT_EMBEDDING_CONFIG.dimension,\n        updatedAt: new Date().toISOString(),\n      }\n    }\n  }\n\n  updateConfig(config: EmbeddingProviderConfig): void {\n    this.config = config\n    this.clientCache.clear()\n  }\n\n  get currentConfig(): EmbeddingProviderConfig {\n    return { ...this.config }\n  }\n\n  get dimension(): number {\n    return this.config.outputDimensionality ?? this.config.dimension\n  }\n\n  get available(): boolean {\n    return this.isProviderConfigured(this.config.providerId)\n  }\n\n  private isProviderConfigured(providerId: EmbeddingProviderId): boolean {\n    switch (providerId) {\n      case 'openai':\n        return Boolean(this.opts.apiKey ?? process.env.OPENAI_API_KEY)\n      case 'google':\n        return Boolean(process.env.GOOGLE_GENERATIVE_AI_API_KEY)\n      case 'mistral':\n        return Boolean(process.env.MISTRAL_API_KEY)\n      case 'cohere':\n        return Boolean(process.env.COHERE_API_KEY)\n      case 'bedrock':\n        return Boolean(process.env.AWS_ACCESS_KEY_ID && process.env.AWS_SECRET_ACCESS_KEY)\n      case 'ollama':\n        return true\n      default:\n        return false\n    }\n  }\n\n  private getClient(providerId: EmbeddingProviderId): ProviderClient {\n    const cached = this.clientCache.get(providerId)\n    if (cached) {\n      return cached\n    }\n\n    let client: ProviderClient\n    switch (providerId) {\n      case 'openai': {\n        const apiKey = this.opts.apiKey ?? process.env.OPENAI_API_KEY\n        if (!apiKey) {\n          throw new Error('[vector.embedding] Missing OPENAI_API_KEY environment variable')\n        }\n        client = createOpenAI({ apiKey })\n        break\n      }\n      case 'google': {\n        const apiKey = process.env.GOOGLE_GENERATIVE_AI_API_KEY\n        if (!apiKey) {\n          throw new Error('[vector.embedding] Missing GOOGLE_GENERATIVE_AI_API_KEY environment variable')\n        }\n        client = createGoogleGenerativeAI({ apiKey })\n        break\n      }\n      case 'mistral': {\n        const apiKey = process.env.MISTRAL_API_KEY\n        if (!apiKey) {\n          throw new Error('[vector.embedding] Missing MISTRAL_API_KEY environment variable')\n        }\n        client = createMistral({ apiKey })\n        break\n      }\n      case 'cohere': {\n        const apiKey = process.env.COHERE_API_KEY\n        if (!apiKey) {\n          throw new Error('[vector.embedding] Missing COHERE_API_KEY environment variable')\n        }\n        client = createCohere({ apiKey })\n        break\n      }\n      case 'bedrock': {\n        const accessKeyId = process.env.AWS_ACCESS_KEY_ID\n        const secretAccessKey = process.env.AWS_SECRET_ACCESS_KEY\n        if (!accessKeyId || !secretAccessKey) {\n          throw new Error('[vector.embedding] Missing AWS_ACCESS_KEY_ID or AWS_SECRET_ACCESS_KEY environment variables')\n        }\n        client = createAmazonBedrock({\n          accessKeyId,\n          secretAccessKey,\n          region: process.env.AWS_REGION ?? 'us-east-1',\n        })\n        break\n      }\n      case 'ollama': {\n        const baseURL = this.config.baseUrl ?? process.env.OLLAMA_BASE_URL ?? 'http://localhost:11434'\n        client = createOllama({ baseURL })\n        break\n      }\n      default:\n        throw new Error(`[vector.embedding] Unknown provider: ${providerId}`)\n    }\n\n    this.clientCache.set(providerId, client)\n    return client\n  }\n\n  private getEmbeddingModel() {\n    const client = this.getClient(this.config.providerId)\n    const { providerId, model, outputDimensionality } = this.config\n\n    switch (providerId) {\n      case 'openai':\n        return (client as ReturnType<typeof createOpenAI>).embedding(model)\n      case 'google':\n        return (client as ReturnType<typeof createGoogleGenerativeAI>).textEmbeddingModel(model)\n      case 'mistral':\n        return (client as ReturnType<typeof createMistral>).textEmbeddingModel(model)\n      case 'cohere':\n        return (client as ReturnType<typeof createCohere>).textEmbeddingModel(model)\n      case 'bedrock':\n        return (client as ReturnType<typeof createAmazonBedrock>).embedding(model)\n      case 'ollama':\n        return (client as OllamaClient).embedding(model)\n      default:\n        throw new Error(`[vector.embedding] Unknown provider: ${providerId}`)\n    }\n  }\n\n  private getProviderOptions(): ProviderOptions | undefined {\n    const { providerId, outputDimensionality, model } = this.config\n\n    if (!outputDimensionality) {\n      if (providerId === 'cohere') {\n        return { cohere: { inputType: 'search_document' } }\n      }\n      return undefined\n    }\n\n    switch (providerId) {\n      case 'openai':\n        if (model === 'text-embedding-3-large' || model === 'text-embedding-3-small') {\n        return { openai: { dimensions: outputDimensionality } }\n        }\n        return undefined\n      case 'google':\n        return { google: { outputDimensionality } }\n      case 'bedrock':\n        return { bedrock: { dimensions: outputDimensionality } }\n      case 'cohere':\n        return { cohere: { inputType: 'search_document' } }\n      default:\n        return undefined\n    }\n  }\n\n  async createEmbedding(input: string | string[]): Promise<number[]> {\n    const merged = Array.isArray(input)\n      ? input.map((part) => String(part ?? '')).filter((part) => part.length > 0).join('\\n\\n')\n      : String(input ?? '')\n    if (!merged.length) {\n      throw new Error('[vector.embedding] Refusing to embed empty payload')\n    }\n\n    if (!this.available) {\n      const providerInfo = EMBEDDING_PROVIDERS[this.config.providerId]\n      throw new Error(`[vector.embedding] Provider ${providerInfo.name} is not configured. Set ${providerInfo.envKeyRequired} environment variable.`)\n    }\n\n    const model = this.getEmbeddingModel() as EmbeddingModel\n    const providerOptions = this.getProviderOptions()\n    const timeoutMs = resolveEmbeddingTimeoutMs()\n\n    const abortController = new AbortController()\n    let timeoutHandle: ReturnType<typeof setTimeout> | null = null\n    try {\n      const result = await Promise.race([\n        embed({\n          model,\n          value: merged,\n          abortSignal: abortController.signal,\n          ...(providerOptions && { providerOptions }),\n        }),\n        new Promise<never>((_, reject) => {\n          timeoutHandle = setTimeout(\n            () => {\n              // Abort the in-flight request so a dead/unreachable provider releases\n              // its socket \u2014 and, in a worker, the per-job DB connection held while\n              // this awaits \u2014 promptly, instead of lingering until the platform's\n              // default network timeout and pinning pool capacity under a storm.\n              abortController.abort()\n              reject(timeoutError(this.config.providerId, timeoutMs))\n            },\n            timeoutMs,\n          )\n        }),\n      ])\n      const emb = Array.isArray(result.embedding)\n        ? result.embedding\n        : Array.from(result.embedding as ArrayLike<number>)\n      return emb.map((n) => Number.isFinite(n) ? Number(n) : 0)\n    } catch (err: unknown) {\n      const error = err as { statusCode?: number; status?: number; response?: { status?: number; statusCode?: number; data?: { error?: { message?: string; code?: string }; message?: string } }; data?: { error?: { message?: string; code?: string } }; body?: { error?: { message?: string; code?: string } }; message?: string }\n      const statusCandidate =\n        error?.statusCode ?? error?.status ?? error?.response?.status ?? error?.response?.statusCode\n      const status =\n        typeof statusCandidate === 'number'\n          ? Number.isFinite(statusCandidate) ? statusCandidate : undefined\n          : typeof statusCandidate === 'string'\n            ? Number.parseInt(statusCandidate, 10)\n            : undefined\n      const apiError = error?.data?.error ?? error?.body?.error ?? error?.response?.data?.error\n      const apiMessage = apiError?.message ?? error?.response?.data?.message\n      const apiCode = typeof apiError?.code === 'string' ? apiError.code : undefined\n      const rawMessage = typeof apiMessage === 'string'\n        ? apiMessage\n        : (typeof error?.message === 'string' ? error.message : 'Embedding request failed')\n\n      const providerInfo = EMBEDDING_PROVIDERS[this.config.providerId]\n      let guidance: string\n      switch (apiCode) {\n        case 'insufficient_quota':\n          guidance = `${providerInfo.name} usage quota exceeded. Please review your plan and billing.`\n          break\n        case 'invalid_api_key':\n          guidance = `Invalid ${providerInfo.name} API key. Update the key and retry.`\n          break\n        case 'account_deactivated':\n          guidance = `${providerInfo.name} account is disabled. Contact support or provide a different key.`\n          break\n        default:\n          guidance = rawMessage.startsWith('[vector.embedding] ')\n            ? rawMessage.slice('[vector.embedding] '.length)\n            : rawMessage.includes('https://')\n            ? rawMessage\n            : rawMessage.includes(providerInfo.envKeyRequired)\n              ? rawMessage\n              : `${rawMessage}. Check ${providerInfo.envKeyRequired}.`\n      }\n      const wrapped = new Error(`[vector.embedding] ${guidance}`) as Error & { status?: number; code?: string; cause?: unknown }\n      if (typeof status === 'number' && Number.isFinite(status)) {\n        const normalizedStatus = status === 401 || status === 403 ? 502 : status\n        if (normalizedStatus >= 400 && normalizedStatus < 600) {\n          wrapped.status = normalizedStatus\n        }\n      }\n      if (apiCode) {\n        wrapped.code = apiCode\n      }\n      wrapped.cause = err\n      throw wrapped\n    } finally {\n      if (timeoutHandle !== null) {\n        clearTimeout(timeoutHandle)\n      }\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/search",
-  "version": "0.6.6-develop.5586.1.c9ed1d68a8",
+  "version": "0.6.6-develop.5588.1.a8f6c51d1f",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {
@@ -126,9 +126,9 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@open-mercato/core": "0.6.6-develop.5586.1.c9ed1d68a8",
-    "@open-mercato/queue": "0.6.6-develop.5586.1.c9ed1d68a8",
-    "@open-mercato/shared": "0.6.6-develop.5586.1.c9ed1d68a8"
+    "@open-mercato/core": "0.6.6-develop.5588.1.a8f6c51d1f",
+    "@open-mercato/queue": "0.6.6-develop.5588.1.a8f6c51d1f",
+    "@open-mercato/shared": "0.6.6-develop.5588.1.a8f6c51d1f"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",

package/src/__tests__/embedding.test.ts

@@ -38,6 +38,29 @@ describe('EmbeddingService', () => {
     )
   })
 
+  it('aborts the in-flight request when it times out', async () => {
+    process.env.OLLAMA_BASE_URL = 'http://localhost:11434'
+    process.env.VECTOR_EMBEDDING_TIMEOUT_MS = '5'
+    let capturedSignal: AbortSignal | undefined
+    mockedEmbed.mockImplementation((options) => {
+      capturedSignal = (options as { abortSignal?: AbortSignal }).abortSignal
+      return new Promise(() => undefined)
+    })
+
+    const service = new EmbeddingService({
+      config: {
+        providerId: 'ollama',
+        model: 'nomic-embed-text',
+        dimension: 768,
+        updatedAt: new Date().toISOString(),
+      },
+    })
+
+    await expect(service.createEmbedding('test input')).rejects.toThrow('timed out')
+    expect(capturedSignal).toBeInstanceOf(AbortSignal)
+    expect(capturedSignal?.aborted).toBe(true)
+  })
+
   it('returns embeddings when provider responds before the timeout', async () => {
     process.env.OLLAMA_BASE_URL = 'http://localhost:11434'
     process.env.VECTOR_EMBEDDING_TIMEOUT_MS = '100'

package/src/__tests__/vector-preflight.test.ts

@@ -0,0 +1,78 @@
+import { evaluateVectorPreflight } from '../vector/lib/preflight'
+
+describe('evaluateVectorPreflight', () => {
+  it('passes when provider is configured, dimensions match, and probe succeeds', async () => {
+    const probe = jest.fn().mockResolvedValue([0.1, 0.2])
+    const result = await evaluateVectorPreflight({
+      providerConfigured: true,
+      effectiveDimension: 1536,
+      tableDimension: 1536,
+      probe,
+    })
+    expect(result).toEqual({ ok: true })
+    expect(probe).toHaveBeenCalledTimes(1)
+  })
+
+  it('skips when the provider is not configured (and does not probe)', async () => {
+    const probe = jest.fn()
+    const result = await evaluateVectorPreflight({
+      providerConfigured: false,
+      effectiveDimension: 1536,
+      tableDimension: 1536,
+      probe,
+    })
+    expect(result.ok).toBe(false)
+    if (result.ok) throw new Error('expected skip')
+    expect(result.code).toBe('provider_not_configured')
+    expect(probe).not.toHaveBeenCalled()
+  })
+
+  it('skips when the configured dimension differs from the table dimension', async () => {
+    const probe = jest.fn()
+    const result = await evaluateVectorPreflight({
+      providerConfigured: true,
+      effectiveDimension: 1536,
+      tableDimension: 768,
+      probe,
+    })
+    expect(result.ok).toBe(false)
+    if (result.ok) throw new Error('expected skip')
+    expect(result.code).toBe('dimension_mismatch')
+    expect(result.reason).toContain('1536')
+    expect(result.reason).toContain('768')
+    // Dimension mismatch is detected before the (expensive) probe runs.
+    expect(probe).not.toHaveBeenCalled()
+  })
+
+  it('skips when the reachability probe throws', async () => {
+    const probe = jest.fn().mockRejectedValue(new Error('fetch failed. Check OLLAMA_BASE_URL.'))
+    const result = await evaluateVectorPreflight({
+      providerConfigured: true,
+      effectiveDimension: 768,
+      tableDimension: 768,
+      probe,
+    })
+    expect(result.ok).toBe(false)
+    if (result.ok) throw new Error('expected skip')
+    expect(result.code).toBe('provider_unreachable')
+    expect(result.reason).toContain('OLLAMA_BASE_URL')
+  })
+
+  it('does not treat unknown dimensions as a mismatch', async () => {
+    const result = await evaluateVectorPreflight({
+      providerConfigured: true,
+      effectiveDimension: null,
+      tableDimension: 768,
+    })
+    expect(result).toEqual({ ok: true })
+  })
+
+  it('passes without a probe when provider is configured and dimensions match', async () => {
+    const result = await evaluateVectorPreflight({
+      providerConfigured: true,
+      effectiveDimension: 1536,
+      tableDimension: 1536,
+    })
+    expect(result).toEqual({ ok: true })
+  })
+})

package/src/__tests__/workers.test.ts

@@ -30,8 +30,19 @@ jest.mock('../modules/search/lib/embedding-config', () => ({
   resolveEmbeddingConfig: jest.fn().mockResolvedValue(null),
 }))
 
+jest.mock('../modules/search/lib/reindex-lock', () => ({
+  updateReindexProgress: jest.fn().mockResolvedValue(undefined),
+  clearReindexLock: jest.fn().mockResolvedValue(undefined),
+}))
+
+jest.mock('../modules/search/lib/reindex-progress', () => ({
+  incrementReindexProgress: jest.fn().mockResolvedValue(true),
+}))
+
 import { handleVectorIndexJob } from '../modules/search/workers/vector-index.worker'
 import { handleFulltextIndexJob } from '../modules/search/workers/fulltext-index.worker'
+import { updateReindexProgress, clearReindexLock } from '../modules/search/lib/reindex-lock'
+import { incrementReindexProgress } from '../modules/search/lib/reindex-progress'
 
 /**
  * Create a mock job context
@@ -62,18 +73,41 @@ describe('Vector Index Worker', () => {
     deleteRecord: jest.fn().mockResolvedValue({ action: 'deleted', existed: true }),
   }
 
+  // Configurable embedding/preflight surface — defaults to a healthy provider.
+  const mockEmbeddingService: {
+    updateConfig: jest.Mock
+    available: boolean
+    dimension: number
+    createEmbedding: jest.Mock
+  } = {
+    updateConfig: jest.fn(),
+    available: true,
+    dimension: 1536,
+    createEmbedding: jest.fn().mockResolvedValue([0.1, 0.2, 0.3]),
+  }
+  let mockTableDimension: number | null = null
+  const mockPgvectorDriver = {
+    id: 'pgvector',
+    getTableDimension: jest.fn(async () => mockTableDimension),
+  }
+
   const mockContainer: HandlerContext = {
     resolve: jest.fn((name: string) => {
       if (name === 'searchIndexer') return mockSearchIndexer
       if (name === 'em') return null
       if (name === 'eventBus') return null
-      if (name === 'vectorEmbeddingService') return { updateConfig: jest.fn() }
+      if (name === 'vectorEmbeddingService') return mockEmbeddingService
+      if (name === 'vectorDrivers') return [mockPgvectorDriver]
       throw new Error(`Unknown service: ${name}`)
     }) as HandlerContext['resolve'],
   }
 
   beforeEach(() => {
     jest.clearAllMocks()
+    mockEmbeddingService.available = true
+    mockEmbeddingService.dimension = 1536
+    mockEmbeddingService.createEmbedding.mockResolvedValue([0.1, 0.2, 0.3])
+    mockTableDimension = null
   })
 
   it('should skip job with missing required fields', async () => {
@@ -148,6 +182,124 @@ describe('Vector Index Worker', () => {
     // Should not throw
     await handleVectorIndexJob(job, ctx, containerWithoutService)
   })
+
+  it('should skip a batch with one warning when the dimension mismatches (no per-record indexing)', async () => {
+    mockTableDimension = 768
+    mockEmbeddingService.dimension = 1536
+    const warnSpy = jest.spyOn(console, 'warn').mockImplementation(() => {})
+    const job = createMockJob<VectorIndexJobPayload>({
+      jobType: 'batch-index',
+      tenantId: 'tenant-123',
+      organizationId: 'org-456',
+      records: [
+        { entityId: 'test:entity', recordId: 'rec-1' },
+        { entityId: 'test:entity', recordId: 'rec-2' },
+      ],
+    })
+
+    await handleVectorIndexJob(job, createMockJobContext(), mockContainer)
+
+    expect(mockSearchIndexer.indexRecordById).not.toHaveBeenCalled()
+    expect(mockEmbeddingService.createEmbedding).not.toHaveBeenCalled()
+    expect(warnSpy).toHaveBeenCalledTimes(1)
+    expect(String(warnSpy.mock.calls[0][0])).toContain('Skipping vector batch')
+    warnSpy.mockRestore()
+  })
+
+  it('should skip a batch with one warning when the provider probe is unreachable', async () => {
+    mockTableDimension = 1536
+    mockEmbeddingService.dimension = 1536
+    mockEmbeddingService.createEmbedding.mockRejectedValueOnce(
+      new Error('fetch failed. Check OLLAMA_BASE_URL.'),
+    )
+    const warnSpy = jest.spyOn(console, 'warn').mockImplementation(() => {})
+    const job = createMockJob<VectorIndexJobPayload>({
+      jobType: 'batch-index',
+      tenantId: 'tenant-123',
+      organizationId: null,
+      records: [{ entityId: 'test:entity', recordId: 'rec-1' }],
+    })
+
+    await handleVectorIndexJob(job, createMockJobContext(), mockContainer)
+
+    expect(mockSearchIndexer.indexRecordById).not.toHaveBeenCalled()
+    expect(mockEmbeddingService.createEmbedding).toHaveBeenCalledTimes(1)
+    expect(warnSpy).toHaveBeenCalledTimes(1)
+    expect(String(warnSpy.mock.calls[0][0])).toContain('Skipping vector batch')
+    warnSpy.mockRestore()
+  })
+
+  it('should still advance reindex progress/lock when a batch is skipped (no stuck run)', async () => {
+    mockTableDimension = 768
+    mockEmbeddingService.dimension = 1536
+    const warnSpy = jest.spyOn(console, 'warn').mockImplementation(() => {})
+    const mockDb = { kysely: true }
+    const containerWithProgress: HandlerContext = {
+      resolve: jest.fn((name: string) => {
+        if (name === 'searchIndexer') return mockSearchIndexer
+        if (name === 'em') return { getKysely: () => mockDb }
+        if (name === 'progressService') return { id: 'progress' }
+        if (name === 'vectorEmbeddingService') return mockEmbeddingService
+        if (name === 'vectorDrivers') return [mockPgvectorDriver]
+        throw new Error(`Unknown service: ${name}`)
+      }) as HandlerContext['resolve'],
+    }
+    const job = createMockJob<VectorIndexJobPayload>({
+      jobType: 'batch-index',
+      tenantId: 'tenant-123',
+      organizationId: 'org-456',
+      records: [
+        { entityId: 'test:entity', recordId: 'rec-1' },
+        { entityId: 'test:entity', recordId: 'rec-2' },
+      ],
+    })
+
+    await handleVectorIndexJob(job, createMockJobContext(), containerWithProgress)
+
+    expect(mockSearchIndexer.indexRecordById).not.toHaveBeenCalled()
+    // Skipped records are counted as processed so the reindex run still completes.
+    expect(updateReindexProgress).toHaveBeenCalledWith(mockDb, 'tenant-123', 'vector', 2, 'org-456')
+    expect(incrementReindexProgress).toHaveBeenCalledWith(
+      expect.objectContaining({ type: 'vector', tenantId: 'tenant-123', delta: 2 }),
+    )
+    expect(clearReindexLock).toHaveBeenCalledWith(mockDb, 'tenant-123', 'vector', 'org-456')
+    warnSpy.mockRestore()
+  })
+
+  it('should skip a single-record index on dimension mismatch without indexing or embedding', async () => {
+    mockTableDimension = 768
+    mockEmbeddingService.dimension = 1536
+    const warnSpy = jest.spyOn(console, 'warn').mockImplementation(() => {})
+    const job = createMockJob<VectorIndexJobPayload>({
+      jobType: 'index',
+      entityType: 'customers:customer_person_profile',
+      recordId: 'rec-123',
+      tenantId: 'tenant-123',
+      organizationId: 'org-456',
+    })
+
+    await handleVectorIndexJob(job, createMockJobContext(), mockContainer)
+
+    expect(mockSearchIndexer.indexRecordById).not.toHaveBeenCalled()
+    expect(mockEmbeddingService.createEmbedding).not.toHaveBeenCalled()
+    expect(warnSpy).toHaveBeenCalledTimes(1)
+    warnSpy.mockRestore()
+  })
+
+  it('should still delete a record even when the provider is misconfigured', async () => {
+    mockEmbeddingService.available = false
+    const job = createMockJob<VectorIndexJobPayload>({
+      jobType: 'delete',
+      entityType: 'customers:customer_person_profile',
+      recordId: 'rec-123',
+      tenantId: 'tenant-123',
+      organizationId: null,
+    })
+
+    await handleVectorIndexJob(job, createMockJobContext(), mockContainer)
+
+    expect(mockSearchIndexer.deleteRecord).toHaveBeenCalled()
+  })
 })
 
 describe('Fulltext Index Worker', () => {

package/src/lib/debug.ts

@@ -33,6 +33,20 @@ export function searchDebugWarn(prefix: string, message: string, data?: Record<s
   }
 }
 
+/**
+ * Log a warning message (always logs, not gated by debug flag).
+ * Use for operational warnings that must stay visible without OM_SEARCH_DEBUG,
+ * such as skipping a vector-index run because the provider is unreachable or
+ * the configured embedding dimension no longer matches the vector table.
+ */
+export function searchWarn(prefix: string, message: string, data?: Record<string, unknown>): void {
+  if (data) {
+    console.warn(`[${prefix}] ${message}`, data)
+  } else {
+    console.warn(`[${prefix}] ${message}`)
+  }
+}
+
 /**
  * Log an error message (always logs, not gated by debug flag).
  * Errors should always be visible for troubleshooting.

package/src/modules/search/workers/vector-index.worker.ts

@@ -2,7 +2,7 @@ import type { QueuedJob, JobContext, WorkerMeta } from '@open-mercato/queue'
 import type { Kysely } from 'kysely'
 import { VECTOR_INDEXING_QUEUE_NAME, type VectorIndexJobPayload } from '../../../queue/vector-indexing'
 import type { SearchIndexer } from '../../../indexer/search-indexer'
-import type { EmbeddingService } from '../../../vector'
+import type { EmbeddingService, VectorDriver } from '../../../vector'
 import type { EntityManager } from '@mikro-orm/postgresql'
 
 import type { ProgressService } from '@open-mercato/core/modules/progress/lib/progressService'
@@ -11,7 +11,8 @@ import { applyCoverageAdjustments, createCoverageAdjustments } from '@open-merca
 import { logVectorOperation } from '../../../vector/lib/vector-logs'
 import { resolveAutoIndexingEnabled } from '../lib/auto-indexing'
 import { resolveEmbeddingConfig } from '../lib/embedding-config'
-import { searchDebugWarn } from '../../../lib/debug'
+import { searchDebugWarn, searchWarn } from '../../../lib/debug'
+import { evaluateVectorPreflight, type VectorPreflightResult } from '../../../vector/lib/preflight'
 import { clearReindexLock, updateReindexProgress } from '../lib/reindex-lock'
 import { incrementReindexProgress } from '../lib/reindex-progress'
 
@@ -26,6 +27,47 @@ export const metadata: WorkerMeta = {
 
 type HandlerContext = { resolve: <T = unknown>(name: string) => T }
 
+/**
+ * Decide once per job whether vector work can succeed, so the worker can skip a
+ * doomed run with a single warning instead of failing every record. When the
+ * embedding service is not resolvable we return `ok` and let the existing
+ * strategy path decide, preserving prior behavior.
+ *
+ * `withProbe` issues one tiny embedding to detect an unreachable provider; use
+ * it for bulk reindex batches, not for hot single-record writes.
+ */
+async function runVectorPreflight(
+  ctx: HandlerContext,
+  options: { withProbe: boolean },
+): Promise<VectorPreflightResult> {
+  let embeddingService: EmbeddingService | null = null
+  try {
+    embeddingService = ctx.resolve<EmbeddingService>('vectorEmbeddingService')
+  } catch {
+    embeddingService = null
+  }
+  if (!embeddingService) return { ok: true }
+
+  let tableDimension: number | null = null
+  try {
+    const drivers = ctx.resolve<VectorDriver[]>('vectorDrivers')
+    const pgvectorDriver = drivers.find((driver) => driver.id === 'pgvector')
+    if (pgvectorDriver?.getTableDimension) {
+      tableDimension = await pgvectorDriver.getTableDimension()
+    }
+  } catch {
+    tableDimension = null
+  }
+
+  const service = embeddingService
+  return evaluateVectorPreflight({
+    providerConfigured: service.available,
+    effectiveDimension: typeof service.dimension === 'number' ? service.dimension : null,
+    tableDimension,
+    probe: options.withProbe ? () => service.createEmbedding('preflight') : undefined,
+  })
+}
+
 /**
  * Process a vector index job.
  *
@@ -93,6 +135,37 @@ export async function handleVectorIndexJob(
       })
     }
 
+    // Preflight once: if the provider is unreachable/misconfigured or its
+    // dimension no longer matches the shared vector table, skip the whole batch
+    // with a single warning instead of failing every record. Still advance the
+    // reindex progress/lock so the run completes (records counted as processed).
+    const preflight = await runVectorPreflight(ctx, { withProbe: true })
+    if (!preflight.ok) {
+      searchWarn('vector-index.worker', `Skipping vector batch: ${preflight.reason}`, {
+        jobId: jobCtx.jobId,
+        code: preflight.code,
+        totalRecords: records.length,
+        tenantId,
+      })
+      if (db && records.length > 0) {
+        await updateReindexProgress(db, tenantId, 'vector', records.length, organizationId ?? null)
+      }
+      if (progressService && em && records.length > 0) {
+        const completed = await incrementReindexProgress({
+          em,
+          progressService,
+          type: 'vector',
+          tenantId,
+          organizationId: organizationId ?? null,
+          delta: records.length,
+        })
+        if (completed && db) {
+          await clearReindexLock(db, tenantId, 'vector', organizationId ?? null)
+        }
+      }
+      return
+    }
+
     // Process each record in the batch
     let successCount = 0
     let failCount = 0
@@ -184,6 +257,25 @@ export async function handleVectorIndexJob(
     }
   }
 
+  // Preflight index jobs only (delete never needs the provider): skip with a
+  // single warning when the provider is misconfigured or the configured
+  // dimension no longer matches the shared vector table. No reachability probe
+  // here — single-record writes are the hot path and the cheap checks already
+  // catch the common misconfiguration without an extra embedding call.
+  if (jobType === 'index') {
+    const preflight = await runVectorPreflight(ctx, { withProbe: false })
+    if (!preflight.ok) {
+      searchWarn('vector-index.worker', `Skipping vector index for record: ${preflight.reason}`, {
+        jobId: jobCtx.jobId,
+        code: preflight.code,
+        entityType,
+        recordId,
+        tenantId,
+      })
+      return
+    }
+  }
+
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   let em: any | null = null
   try {

package/src/vector/lib/preflight.ts

@@ -0,0 +1,78 @@
+/**
+ * Vector indexing preflight.
+ *
+ * The embedding provider config and the pgvector table dimension are global
+ * (per-database), not per-tenant. When the configured provider is unreachable,
+ * not configured, or produces a dimension that no longer matches the shared
+ * vector table, every record in a reindex run fails the same way — producing a
+ * storm of per-record errors and wasted embedding calls.
+ *
+ * This helper lets a caller decide ONCE per run whether vector work can succeed,
+ * so it can skip with a single warning instead of failing every record. It is a
+ * pure function: the reachability probe is injected so it stays unit-testable.
+ */
+
+export type VectorPreflightSkipCode =
+  | 'provider_not_configured'
+  | 'dimension_mismatch'
+  | 'provider_unreachable'
+
+export type VectorPreflightInput = {
+  /** Whether the active embedding provider has its credentials/config present. */
+  providerConfigured: boolean
+  /** Dimension the active embedding config will produce (null when unknown). */
+  effectiveDimension: number | null
+  /** Dimension of the shared vector table (null when unknown/unavailable). */
+  tableDimension: number | null
+  /**
+   * Optional reachability probe. When provided it is invoked last and MUST
+   * throw if the provider cannot be reached. Omit it on hot paths (e.g.
+   * single-record indexing) where the extra embedding call is not worth it.
+   */
+  probe?: () => Promise<unknown>
+}
+
+export type VectorPreflightResult =
+  | { ok: true }
+  | { ok: false; code: VectorPreflightSkipCode; reason: string }
+
+export async function evaluateVectorPreflight(
+  input: VectorPreflightInput,
+): Promise<VectorPreflightResult> {
+  if (!input.providerConfigured) {
+    return {
+      ok: false,
+      code: 'provider_not_configured',
+      reason:
+        'embedding provider is not configured (missing API key/base URL); set the provider credentials or re-point the provider in Settings → Search',
+    }
+  }
+
+  if (
+    typeof input.effectiveDimension === 'number' &&
+    typeof input.tableDimension === 'number' &&
+    input.effectiveDimension !== input.tableDimension
+  ) {
+    return {
+      ok: false,
+      code: 'dimension_mismatch',
+      reason:
+        `configured provider produces ${input.effectiveDimension}-dim embeddings but the shared vector table is ${input.tableDimension}-dim; ` +
+        're-point the provider in Settings → Search to recreate the table at the new dimension, then reindex',
+    }
+  }
+
+  if (input.probe) {
+    try {
+      await input.probe()
+    } catch (error) {
+      return {
+        ok: false,
+        code: 'provider_unreachable',
+        reason: `embedding provider is unreachable: ${error instanceof Error ? error.message : String(error)}`,
+      }
+    }
+  }
+
+  return { ok: true }
+}

package/src/vector/services/embedding.ts

@@ -234,17 +234,26 @@ export class EmbeddingService {
     const providerOptions = this.getProviderOptions()
     const timeoutMs = resolveEmbeddingTimeoutMs()
 
+    const abortController = new AbortController()
     let timeoutHandle: ReturnType<typeof setTimeout> | null = null
     try {
       const result = await Promise.race([
         embed({
           model,
           value: merged,
+          abortSignal: abortController.signal,
           ...(providerOptions && { providerOptions }),
         }),
         new Promise<never>((_, reject) => {
           timeoutHandle = setTimeout(
-            () => reject(timeoutError(this.config.providerId, timeoutMs)),
+            () => {
+              // Abort the in-flight request so a dead/unreachable provider releases
+              // its socket — and, in a worker, the per-job DB connection held while
+              // this awaits — promptly, instead of lingering until the platform's
+              // default network timeout and pinning pool capacity under a storm.
+              abortController.abort()
+              reject(timeoutError(this.config.providerId, timeoutMs))
+            },
             timeoutMs,
           )
         }),