@remnic/core 9.3.739 → 9.3.741

package/dist/chunk-JQSP7YBJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/search/factory.ts"],"sourcesContent":["import type { PluginConfig } from \"../types.js\";\nimport type { SearchBackend } from \"./port.js\";\nimport path from \"node:path\";\nimport { NoopSearchBackend } from \"./noop-backend.js\";\nimport { RemoteSearchBackend } from \"./remote-backend.js\";\nimport { LanceDbBackend } from \"./lancedb-backend.js\";\nimport { MeilisearchBackend } from \"./meilisearch-backend.js\";\nimport { OramaBackend } from \"./orama-backend.js\";\nimport { EmbedHelper } from \"./embed-helper.js\";\nimport { QmdClient, type QmdClientOptions } from \"../qmd.js\";\nimport { log } from \"../logger.js\";\nimport { FaissConversationIndexAdapter } from \"../conversation-index/faiss-adapter.js\";\nimport {\n  resolveIndexingCapabilities,\n  resolveQmdCapabilities,\n} from \"../capabilities.js\";\nimport {\n  createConversationIndexBackend,\n  type ConversationIndexBackend,\n  type ConversationQmdRuntime,\n} from \"../conversation-index/backend.js\";\n\n/**\n * Resolve non-QMD backends from config.\n * Returns a SearchBackend for \"noop\" or \"remote\", or undefined to signal \"use QMD\".\n */\nfunction resolveNonQmdBackend(config: PluginConfig): SearchBackend | undefined {\n  const backend = config.searchBackend ?? \"qmd\";\n  const collection = config.qmdCollection;\n\n  if (backend === \"noop\") {\n    return new NoopSearchBackend();\n  }\n\n  if (backend === \"remote\") {\n    const baseUrl = config.remoteSearchBaseUrl || \"http://localhost:8181\";\n    if (!config.remoteSearchBaseUrl) {\n      log.warn(\"searchBackend is 'remote' but remoteSearchBaseUrl is not configured; using default http://localhost:8181\");\n    }\n    return new RemoteSearchBackend({\n      baseUrl,\n      apiKey: config.remoteSearchApiKey,\n      timeoutMs: config.remoteSearchTimeoutMs,\n    });\n  }\n\n  if (backend === \"lancedb\") {\n    const embedHelper = new EmbedHelper(config, {\n      hostEmbeddingExpectedDimension: config.lanceEmbeddingDimension,\n    });\n    return new LanceDbBackend({\n      dbPath: config.lanceDbPath!,\n      collection,\n      embedHelper,\n      memoryDir: config.memoryDir,\n      embeddingDimension: config.lanceEmbeddingDimension!,\n    });\n  }\n\n  if (backend === \"meilisearch\") {\n    return new MeilisearchBackend({\n      host: config.meilisearchHost!,\n      apiKey: config.meilisearchApiKey,\n      collection,\n      timeoutMs: config.meilisearchTimeoutMs,\n      autoIndex: config.meilisearchAutoIndex,\n      memoryDir: config.memoryDir,\n    });\n  }\n\n  if (backend === \"orama\") {\n    const embedHelper = new EmbedHelper(config, {\n      hostEmbeddingExpectedDimension: config.oramaEmbeddingDimension,\n    });\n    return new OramaBackend({\n      dbPath: config.oramaDbPath!,\n      collection,\n      embedHelper,\n      memoryDir: config.memoryDir,\n      embeddingDimension: config.oramaEmbeddingDimension!,\n    });\n  }\n\n  return undefined;\n}\n\n/** Shared QMD options derived from plugin config. */\nfunction qmdOptions(config: PluginConfig): QmdClientOptions {\n  return {\n    slowLog: {\n      enabled: config.slowLogEnabled,\n      thresholdMs: config.slowLogThresholdMs,\n    },\n    updateTimeoutMs: config.qmdUpdateTimeoutMs,\n    updateMinIntervalMs: config.qmdUpdateMinIntervalMs,\n    qmdPath: config.qmdPath,\n    daemonUrl: resolveQmdCapabilities(config).qmdDaemon ? config.qmdDaemonUrl : undefined,\n    daemonRecheckIntervalMs: config.qmdDaemonRecheckIntervalMs,\n    qmdSupportedVersion: config.qmdSupportedVersion,\n    qmdAutoUpgradeEnabled: resolveQmdCapabilities(config).qmdAutoUpgrade,\n    qmdAutoUpgradeCheckIntervalMs: config.qmdAutoUpgradeCheckIntervalMs,\n    qmdChunkStrategy: config.qmdChunkStrategy,\n    qmdCandidateLimit: config.qmdCandidateLimit,\n    qmdQueryRerankEnabled: resolveQmdCapabilities(config).qmdQueryRerank,\n    qmdIndexName: config.qmdIndexName,\n    qmdForceCpu: config.qmdForceCpu,\n    qmdGpuBackend: config.qmdGpuBackend,\n    qmdEmbedParallelism: config.qmdEmbedParallelism,\n    qmdEmbedModel: config.qmdEmbedModel,\n    qmdRerankModel: config.qmdRerankModel,\n    qmdGenerateModel: config.qmdGenerateModel,\n    qmdSearchStrategy: config.qmdSearchStrategy,\n    qmdSubprocessStrategy: config.qmdSubprocessStrategy,\n    qmdDaemonTimeoutMs: config.qmdDaemonTimeoutMs,\n  };\n}\n\n/**\n * Create a SearchBackend from plugin config.\n *\n * - \"noop\" → NoopSearchBackend\n * - \"remote\" → RemoteSearchBackend (HTTP REST)\n * - \"qmd\" (default) → QmdClient if qmdEnabled, else NoopSearchBackend\n */\nexport function createSearchBackend(config: PluginConfig): SearchBackend {\n  const nonQmd = resolveNonQmdBackend(config);\n  if (nonQmd) return nonQmd;\n\n  // Default: QMD — fall back to noop if qmdEnabled is false\n  if (!resolveQmdCapabilities(config).qmd) {\n    return new NoopSearchBackend();\n  }\n\n  return new QmdClient(config.qmdCollection, config.qmdMaxResults, qmdOptions(config));\n}\n\n/**\n * Create a SearchBackend for conversation index use.\n * Returns undefined if conversation index is not enabled or not using qmd backend.\n */\nexport function createConversationSearchBackend(config: PluginConfig): SearchBackend | undefined {\n  if (!resolveIndexingCapabilities(config).conversationIndex || config.conversationIndexBackend !== \"qmd\") {\n    return undefined;\n  }\n\n  // Conversation index is QMD-only — do not use lancedb/meilisearch/orama even if\n  // searchBackend is set to one of those. Only respect \"noop\" to allow disabling.\n  const backend = config.searchBackend ?? \"qmd\";\n  if (backend === \"noop\") return undefined;\n\n  // QMD — respect qmdEnabled to avoid spawning the binary\n  if (!resolveQmdCapabilities(config).qmd) return undefined;\n\n  return new QmdClient(\n    config.conversationIndexQmdCollection,\n    Math.max(6, config.conversationRecallTopK),\n    qmdOptions(config),\n  );\n}\n\nexport interface ConversationIndexRuntime {\n  qmd?: ConversationQmdRuntime;\n  faiss?: FaissConversationIndexAdapter;\n  backend?: ConversationIndexBackend;\n}\n\nexport function createConversationIndexRuntime(\n  config: PluginConfig,\n  overrides?: {\n    getQmd?: () => ConversationQmdRuntime | undefined;\n    getFaiss?: () => FaissConversationIndexAdapter | undefined;\n  },\n): ConversationIndexRuntime {\n  const qmd = createConversationSearchBackend(config) as ConversationQmdRuntime | undefined;\n  let faiss: FaissConversationIndexAdapter | undefined;\n  if (resolveIndexingCapabilities(config).conversationIndex && config.conversationIndexBackend === \"faiss\") {\n    try {\n      faiss = new FaissConversationIndexAdapter({\n          memoryDir: config.memoryDir,\n          scriptPath: config.conversationIndexFaissScriptPath,\n          pythonBin: config.conversationIndexFaissPythonBin,\n          modelId: config.conversationIndexFaissModelId,\n          indexDir: config.conversationIndexFaissIndexDir,\n          upsertTimeoutMs: config.conversationIndexFaissUpsertTimeoutMs,\n          searchTimeoutMs: config.conversationIndexFaissSearchTimeoutMs,\n          healthTimeoutMs: config.conversationIndexFaissHealthTimeoutMs,\n          maxBatchSize: config.conversationIndexFaissMaxBatchSize,\n          maxSearchK: config.conversationIndexFaissMaxSearchK,\n      });\n    } catch (err) {\n      log.warn(`Conversation index FAISS adapter disabled: ${err instanceof Error ? err.message : String(err)}`);\n    }\n  }\n\n  const backend = createConversationIndexBackend({\n    enabled: resolveIndexingCapabilities(config).conversationIndex,\n    backend: config.conversationIndexBackend,\n    getQmd: () => overrides?.getQmd?.() ?? qmd,\n    getFaiss: () => overrides?.getFaiss?.() ?? faiss,\n    collectionDir: path.join(config.memoryDir, \"conversation-index\"),\n  });\n\n  return { qmd, faiss, backend };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-MAU7DFCJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/search/embed-helper.ts"],"sourcesContent":["import { log } from \"../logger.js\";\nimport {\n  resolveMemoryLifecycleCapabilities,\n  resolveLocalLlmCapabilities,\n} from \"../capabilities.js\";\nimport type { PluginConfig } from \"../types.js\";\nimport { isAbortError } from \"../abort-error.js\";\nimport { withTimeoutSignal } from \"./abort.js\";\nimport {\n  getHostEmbeddingProvider,\n  type HostEmbeddingProvider,\n  type HostEmbeddingInputType,\n  normalizeHostEmbeddingVector,\n} from \"../host-embedding-provider.js\";\n\ntype ProviderConfig = {\n  type: \"openai\" | \"local\" | \"host\";\n  model: string;\n  endpoint?: string;\n  headers?: Record<string, string>;\n  hostProvider?: HostEmbeddingProvider;\n};\n\ntype HostEmbeddingScopeConfig = PluginConfig & {\n  /**\n   * Internal namespace-router metadata. Host adapters register providers at\n   * the root memoryDir while namespace backends operate under scoped dirs.\n   */\n  hostEmbeddingProviderScope?: string;\n};\n\ntype EmbedHelperOptions = {\n  /** Backend-local vector schema dimension for host-provider validation. */\n  hostEmbeddingExpectedDimension?: number;\n};\n\nexport type EmbedProviderIdentity = `${ProviderConfig[\"type\"]}:${string}`;\n\nexport type EmbedWithProviderResult = {\n  vector: number[];\n  providerIdentity: EmbedProviderIdentity;\n};\n\nexport type EmbedBatchWithProviderResult = {\n  vectors: (number[] | null)[];\n  providerIdentity: EmbedProviderIdentity;\n};\n\nconst DEFAULT_OPENAI_MODEL = \"text-embedding-3-small\";\nconst DEFAULT_PROVIDER_CACHE_TTL_MS = 250;\n\n/**\n * Standalone embedding helper for search backend adapters.\n *\n * NOTE: This intentionally duplicates provider resolution from EmbeddingFallback.\n * EmbeddingFallback is tightly integrated with the plugin lifecycle (telemetry,\n * rate-limit backoff, provider rotation). This class is a lightweight standalone\n * utility used by LanceDB/Orama backends which operate outside plugin context.\n * Merging them would break the port/adapter separation between search and plugin layers.\n */\nexport class EmbedHelper {\n  private cachedProvider: ProviderConfig | null | undefined;\n  private cachedProviderAt = 0;\n  private providerCacheTtlMs = DEFAULT_PROVIDER_CACHE_TTL_MS;\n\n  constructor(\n    private readonly config: PluginConfig,\n    private readonly options: EmbedHelperOptions = {},\n  ) {}\n\n  /**\n   * Whether an embedding provider is available.\n   * Re-resolves periodically so late host-provider registration is visible\n   * without repeatedly probing provider state on every hot-path call.\n   */\n  isAvailable(): boolean {\n    return this.getProvider() !== null;\n  }\n\n  /**\n   * Embed a single text string. Returns null if no provider is available.\n   */\n  async embed(text: string, options: { signal?: AbortSignal } = {}): Promise<number[] | null> {\n    return (await this.embedWithProvider(text, options))?.vector ?? null;\n  }\n\n  async embedWithProvider(\n    text: string,\n    options: { signal?: AbortSignal } = {},\n  ): Promise<EmbedWithProviderResult | null> {\n    const provider = this.getProvider();\n    if (!provider) return null;\n    const result = await this.callEmbed(text, provider, options.signal, \"query\");\n    if (result) {\n      return {\n        vector: result,\n        providerIdentity: providerIdentity(provider),\n      };\n    }\n    if (provider.type !== \"host\") return null;\n    const fallbackProvider = this.resolveProvider({ includeHost: false });\n    if (!fallbackProvider) return null;\n    const fallbackResult = await this.callEmbed(text, fallbackProvider, options.signal, \"query\");\n    return fallbackResult\n      ? {\n          vector: fallbackResult,\n          providerIdentity: providerIdentity(fallbackProvider),\n        }\n      : null;\n  }\n\n  async embedWithFallbackProviderIdentity(\n    text: string,\n    identity: EmbedProviderIdentity,\n    options: { signal?: AbortSignal } = {},\n  ): Promise<EmbedWithProviderResult | null> {\n    const provider = this.resolveFallbackProviderForIdentity(identity);\n    if (!provider) return null;\n    const result = await this.callEmbed(text, provider, options.signal, \"query\");\n    return result\n      ? {\n          vector: result,\n          providerIdentity: providerIdentity(provider),\n        }\n      : null;\n  }\n\n  /**\n   * Embed a batch of texts. Returns an array parallel to input; entries are null on failure.\n   */\n  async embedBatch(\n    texts: string[],\n    batchSize = 32,\n    options: { signal?: AbortSignal } = {},\n  ): Promise<(number[] | null)[]> {\n    return (await this.embedBatchWithProvider(texts, batchSize, options))?.vectors ?? texts.map(() => null);\n  }\n\n  async embedBatchWithProvider(\n    texts: string[],\n    batchSize = 32,\n    options: { signal?: AbortSignal } = {},\n  ): Promise<EmbedBatchWithProviderResult | null> {\n    const provider = this.getProvider();\n    if (!provider) return null;\n\n    if (provider.type === \"host\") {\n      const hostResults = await this.embedAllWithProvider(texts, batchSize, provider, options);\n      if (!hostResults.some((result) => result === null)) {\n        return {\n          vectors: hostResults,\n          providerIdentity: providerIdentity(provider),\n        };\n      }\n      const fallbackProvider = this.resolveProvider({ includeHost: false });\n      if (!fallbackProvider) {\n        return {\n          vectors: hostResults,\n          providerIdentity: providerIdentity(provider),\n        };\n      }\n      const fallbackResults = await this.embedAllWithProvider(texts, batchSize, fallbackProvider, options);\n      return {\n        vectors: fallbackResults,\n        providerIdentity: providerIdentity(fallbackProvider),\n      };\n    }\n\n    return {\n      vectors: await this.embedAllWithProvider(texts, batchSize, provider, options),\n      providerIdentity: providerIdentity(provider),\n    };\n  }\n\n  getProviderIdentity(): EmbedProviderIdentity | null {\n    const provider = this.getProvider();\n    return provider ? providerIdentity(provider) : null;\n  }\n\n  private async embedAllWithProvider(\n    texts: string[],\n    batchSize: number,\n    provider: ProviderConfig,\n    options: { signal?: AbortSignal } = {},\n  ): Promise<(number[] | null)[]> {\n    const results: (number[] | null)[] = new Array(texts.length).fill(null);\n    for (let i = 0; i < texts.length; i += batchSize) {\n      const batch = texts.slice(i, i + batchSize);\n      const batchResults =\n        provider.type === \"host\" && provider.hostProvider?.embedBatch\n          ? await this.callHostEmbedBatch(batch, provider.hostProvider, options.signal)\n          : await Promise.all(\n              batch.map((t) => this.callEmbed(t, provider, options.signal, \"document\")),\n            );\n      for (let j = 0; j < batchResults.length; j++) {\n        results[i + j] = batchResults[j];\n      }\n    }\n    return results;\n  }\n\n  private getProvider(): ProviderConfig | null {\n    const now = Date.now();\n    if (\n      this.cachedProvider !== undefined &&\n      now - this.cachedProviderAt < this.providerCacheTtlMs\n    ) {\n      return this.cachedProvider;\n    }\n    this.cachedProvider = this.resolveProvider();\n    this.cachedProviderAt = now;\n    return this.cachedProvider;\n  }\n\n  private resolveProvider(options: { includeHost?: boolean } = {}): ProviderConfig | null {\n    if (!resolveMemoryLifecycleCapabilities(this.config).embeddingFallback) return null;\n\n    if (\n      options.includeHost !== false &&\n      this.config.hostEmbeddingProviderEnabled !== false\n    ) {\n      const hostProvider = this.resolveHostEmbeddingProvider();\n      if (hostProvider) {\n        return {\n          type: \"host\",\n          model: hostProvider.model || hostProvider.id,\n          hostProvider,\n        };\n      }\n    }\n\n    const preferred = this.config.embeddingFallbackProvider;\n    const providers = preferred === \"auto\" ? [\"openai\", \"local\"] : [preferred];\n\n    for (const p of providers) {\n      if (p === \"openai\") {\n        const provider = this.createOpenAiProvider();\n        if (provider) return provider;\n      }\n\n      if (p === \"local\") {\n        const provider = this.createLocalProvider();\n        if (provider) return provider;\n      }\n    }\n\n    return null;\n  }\n\n  private resolveFallbackProviderForIdentity(identity: EmbedProviderIdentity): ProviderConfig | null {\n    if (!resolveMemoryLifecycleCapabilities(this.config).embeddingFallback) return null;\n    const separator = identity.indexOf(\":\");\n    if (separator <= 0 || separator === identity.length - 1) return null;\n    const type = identity.slice(0, separator);\n    const model = identity.slice(separator + 1);\n\n    if (type === \"openai\") {\n      const provider = this.createOpenAiProvider();\n      return provider && provider.model === model ? provider : null;\n    }\n    if (type === \"local\") {\n      const provider = this.createLocalProvider();\n      return provider && provider.model === model ? provider : null;\n    }\n    return null;\n  }\n\n  private createOpenAiProvider(): ProviderConfig | null {\n    if (!this.config.openaiApiKey) return null;\n    const baseUrl = this.config.openaiBaseUrl ?? \"https://api.openai.com/v1\";\n    return {\n      type: \"openai\",\n      model: DEFAULT_OPENAI_MODEL,\n      endpoint: `${baseUrl.replace(/\\/$/, \"\")}/embeddings`,\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${this.config.openaiApiKey}`,\n      },\n    };\n  }\n\n  private createLocalProvider(): ProviderConfig | null {\n    if (!resolveLocalLlmCapabilities(this.config).localLlm || !this.config.localLlmUrl) return null;\n    const base = this.config.localLlmUrl.replace(/\\/$/, \"\");\n    const endpoint = /\\/v1$/i.test(base) ? `${base}/embeddings` : `${base}/v1/embeddings`;\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      ...(this.config.localLlmHeaders ?? {}),\n    };\n    if (this.config.localLlmApiKey && this.config.localLlmAuthHeader !== false) {\n      headers.Authorization = `Bearer ${this.config.localLlmApiKey}`;\n    }\n    return {\n      type: \"local\",\n      model:\n        this.config.embeddingFallbackModel ||\n        this.config.localLlmModel ||\n        DEFAULT_OPENAI_MODEL,\n      endpoint,\n      headers,\n    };\n  }\n\n  private resolveHostEmbeddingProvider(): HostEmbeddingProvider | undefined {\n    const scopedConfig = this.config as HostEmbeddingScopeConfig;\n    const scopes = [\n      scopedConfig.memoryDir,\n      scopedConfig.hostEmbeddingProviderScope,\n    ].filter((scope): scope is string => typeof scope === \"string\" && scope.trim().length > 0);\n\n    for (const scope of new Set(scopes)) {\n      const provider = getHostEmbeddingProvider(scope);\n      if (provider) return provider;\n    }\n    return undefined;\n  }\n\n  private async callEmbed(\n    input: string,\n    provider: ProviderConfig,\n    signal?: AbortSignal,\n    inputType: HostEmbeddingInputType = \"document\",\n  ): Promise<number[] | null> {\n    if (provider.type === \"host\") {\n      return this.callHostEmbed(input, provider.hostProvider, signal, inputType);\n    }\n    if (!provider.endpoint || !provider.headers) return null;\n    try {\n      const res = await fetch(provider.endpoint, {\n        method: \"POST\",\n        headers: provider.headers,\n        body: JSON.stringify({\n          model: provider.model,\n          input: input.slice(0, 8000),\n          encoding_format: \"float\",\n        }),\n        signal: withTimeoutSignal(signal, 30_000),\n      });\n      if (!res.ok) {\n        log.debug(`EmbedHelper request failed: ${provider.type} ${res.status}`);\n        return null;\n      }\n      const payload = (await res.json()) as any;\n      const vector = payload?.data?.[0]?.embedding;\n      return normalizeHttpEmbeddingVector(vector);\n    } catch (err) {\n      if (isAbortError(err)) throw err;\n      log.debug(`EmbedHelper error: ${err}`);\n      return null;\n    }\n  }\n\n  private async callHostEmbed(\n    input: string,\n    provider: HostEmbeddingProvider | undefined,\n    signal?: AbortSignal,\n    inputType: HostEmbeddingInputType = \"document\",\n  ): Promise<number[] | null> {\n    if (!provider) return null;\n    try {\n      const vector = await provider.embed(input.slice(0, 8000), {\n        signal: withTimeoutSignal(signal, 30_000),\n        inputType,\n      });\n      return this.normalizeHostEmbeddingVector(vector);\n    } catch (err) {\n      if (isAbortError(err)) throw err;\n      log.debug(`EmbedHelper host provider error: ${err}`);\n      return null;\n    }\n  }\n\n  private async callHostEmbedBatch(\n    inputs: string[],\n    provider: HostEmbeddingProvider,\n    signal?: AbortSignal,\n  ): Promise<(number[] | null)[]> {\n    try {\n      const vectors = await provider.embedBatch?.(\n        inputs.map((input) => input.slice(0, 8000)),\n        {\n          signal: withTimeoutSignal(signal, 30_000),\n          inputType: \"document\",\n        },\n      );\n      if (!Array.isArray(vectors)) return inputs.map(() => null);\n      return inputs.map((_, index) => this.normalizeHostEmbeddingVector(vectors[index]));\n    } catch (err) {\n      if (isAbortError(err)) throw err;\n      log.debug(`EmbedHelper host provider batch error: ${err}`);\n      return inputs.map(() => null);\n    }\n  }\n\n  private normalizeHostEmbeddingVector(value: unknown): number[] | null {\n    const vector = normalizeHostEmbeddingVector(value);\n    if (!vector) return null;\n    const expectedDimension = this.resolveHostEmbeddingExpectedDimension();\n    if (expectedDimension !== null && vector.length !== expectedDimension) {\n      return null;\n    }\n    return vector;\n  }\n\n  private resolveHostEmbeddingExpectedDimension(): number | null {\n    const value = this.options.hostEmbeddingExpectedDimension;\n    return typeof value === \"number\" && Number.isInteger(value) && value > 0\n      ? value\n      : null;\n  }\n}\n\nfunction providerIdentity(provider: ProviderConfig): EmbedProviderIdentity {\n  return `${provider.type}:${provider.model}`;\n}\n\nfunction normalizeHttpEmbeddingVector(vector: unknown): number[] | null {\n  if (!Array.isArray(vector)) return null;\n  const normalized: number[] = [];\n  for (const component of vector) {\n    if (typeof component !== \"number\" || !Number.isFinite(component)) {\n      return null;\n    }\n    normalized.push(component);\n  }\n  return normalized;\n}\n"],"mappings":"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","names":[]}