@remnic/core 9.3.563 → 9.3.565

package/dist/{chunk-SI3QCHWF.js → chunk-DARLGSFX.js}

@@ -1,6 +1,6 @@
 import {
   listNamespaces
-} from "./chunk-5GX5MUQ2.js";
+} from "./chunk-574MU2Y3.js";
 import {
   runConsolidationProvenanceCheck
 } from "./chunk-LZ3VEOU5.js";
@@ -32,17 +32,17 @@ import {
 } from "./chunk-AJU4PJGY.js";
 import {
   parseConfig
-} from "./chunk-7H6CFEBJ.js";
+} from "./chunk-NZPF2SYV.js";
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-E5OECWZ5.js";
+} from "./chunk-XT7XVA53.js";
 import {
   analyzeGraphHealth
 } from "./chunk-4JRRISLU.js";
 import {
   StorageManager
-} from "./chunk-TVZ6LKKS.js";
+} from "./chunk-IRFF6LSF.js";
 import {
   lintWorkspaceFiles
 } from "./chunk-DM2T26WE.js";
@@ -1333,4 +1333,4 @@ export {
   runBenchmarkRecall,
   runOperatorRepair
 };
-//# sourceMappingURL=chunk-SI3QCHWF.js.map
+//# sourceMappingURL=chunk-DARLGSFX.js.map

package/dist/chunk-EWLQPEO6.js

@@ -0,0 +1,308 @@
+import {
+  withTimeoutSignal
+} from "./chunk-CINZGPSJ.js";
+import {
+  getHostEmbeddingProvider,
+  normalizeHostEmbeddingVector
+} from "./chunk-3ONXXHQO.js";
+import {
+  isAbortError
+} from "./chunk-PVGDJXVK.js";
+import {
+  log
+} from "./chunk-2ODBA7MQ.js";
+
+// src/search/embed-helper.ts
+var DEFAULT_OPENAI_MODEL = "text-embedding-3-small";
+var DEFAULT_PROVIDER_CACHE_TTL_MS = 250;
+var EmbedHelper = class {
+  constructor(config, options = {}) {
+    this.config = config;
+    this.options = options;
+  }
+  config;
+  options;
+  cachedProvider;
+  cachedProviderAt = 0;
+  providerCacheTtlMs = DEFAULT_PROVIDER_CACHE_TTL_MS;
+  /**
+   * Whether an embedding provider is available.
+   * Re-resolves periodically so late host-provider registration is visible
+   * without repeatedly probing provider state on every hot-path call.
+   */
+  isAvailable() {
+    return this.getProvider() !== null;
+  }
+  /**
+   * Embed a single text string. Returns null if no provider is available.
+   */
+  async embed(text, options = {}) {
+    return (await this.embedWithProvider(text, options))?.vector ?? null;
+  }
+  async embedWithProvider(text, options = {}) {
+    const provider = this.getProvider();
+    if (!provider) return null;
+    const result = await this.callEmbed(text, provider, options.signal, "query");
+    if (result) {
+      return {
+        vector: result,
+        providerIdentity: providerIdentity(provider)
+      };
+    }
+    if (provider.type !== "host") return null;
+    const fallbackProvider = this.resolveProvider({ includeHost: false });
+    if (!fallbackProvider) return null;
+    const fallbackResult = await this.callEmbed(text, fallbackProvider, options.signal, "query");
+    return fallbackResult ? {
+      vector: fallbackResult,
+      providerIdentity: providerIdentity(fallbackProvider)
+    } : null;
+  }
+  async embedWithFallbackProviderIdentity(text, identity, options = {}) {
+    const provider = this.resolveFallbackProviderForIdentity(identity);
+    if (!provider) return null;
+    const result = await this.callEmbed(text, provider, options.signal, "query");
+    return result ? {
+      vector: result,
+      providerIdentity: providerIdentity(provider)
+    } : null;
+  }
+  /**
+   * Embed a batch of texts. Returns an array parallel to input; entries are null on failure.
+   */
+  async embedBatch(texts, batchSize = 32, options = {}) {
+    return (await this.embedBatchWithProvider(texts, batchSize, options))?.vectors ?? texts.map(() => null);
+  }
+  async embedBatchWithProvider(texts, batchSize = 32, options = {}) {
+    const provider = this.getProvider();
+    if (!provider) return null;
+    if (provider.type === "host") {
+      const hostResults = await this.embedAllWithProvider(texts, batchSize, provider, options);
+      if (!hostResults.some((result) => result === null)) {
+        return {
+          vectors: hostResults,
+          providerIdentity: providerIdentity(provider)
+        };
+      }
+      const fallbackProvider = this.resolveProvider({ includeHost: false });
+      if (!fallbackProvider) {
+        return {
+          vectors: hostResults,
+          providerIdentity: providerIdentity(provider)
+        };
+      }
+      const fallbackResults = await this.embedAllWithProvider(texts, batchSize, fallbackProvider, options);
+      return {
+        vectors: fallbackResults,
+        providerIdentity: providerIdentity(fallbackProvider)
+      };
+    }
+    return {
+      vectors: await this.embedAllWithProvider(texts, batchSize, provider, options),
+      providerIdentity: providerIdentity(provider)
+    };
+  }
+  getProviderIdentity() {
+    const provider = this.getProvider();
+    return provider ? providerIdentity(provider) : null;
+  }
+  async embedAllWithProvider(texts, batchSize, provider, options = {}) {
+    const results = new Array(texts.length).fill(null);
+    for (let i = 0; i < texts.length; i += batchSize) {
+      const batch = texts.slice(i, i + batchSize);
+      const batchResults = provider.type === "host" && provider.hostProvider?.embedBatch ? await this.callHostEmbedBatch(batch, provider.hostProvider, options.signal) : await Promise.all(
+        batch.map((t) => this.callEmbed(t, provider, options.signal, "document"))
+      );
+      for (let j = 0; j < batchResults.length; j++) {
+        results[i + j] = batchResults[j];
+      }
+    }
+    return results;
+  }
+  getProvider() {
+    const now = Date.now();
+    if (this.cachedProvider !== void 0 && now - this.cachedProviderAt < this.providerCacheTtlMs) {
+      return this.cachedProvider;
+    }
+    this.cachedProvider = this.resolveProvider();
+    this.cachedProviderAt = now;
+    return this.cachedProvider;
+  }
+  resolveProvider(options = {}) {
+    if (!this.config.embeddingFallbackEnabled) return null;
+    if (options.includeHost !== false && this.config.hostEmbeddingProviderEnabled !== false) {
+      const hostProvider = this.resolveHostEmbeddingProvider();
+      if (hostProvider) {
+        return {
+          type: "host",
+          model: hostProvider.model || hostProvider.id,
+          hostProvider
+        };
+      }
+    }
+    const preferred = this.config.embeddingFallbackProvider;
+    const providers = preferred === "auto" ? ["openai", "local"] : [preferred];
+    for (const p of providers) {
+      if (p === "openai") {
+        const provider = this.createOpenAiProvider();
+        if (provider) return provider;
+      }
+      if (p === "local") {
+        const provider = this.createLocalProvider();
+        if (provider) return provider;
+      }
+    }
+    return null;
+  }
+  resolveFallbackProviderForIdentity(identity) {
+    if (!this.config.embeddingFallbackEnabled) return null;
+    const separator = identity.indexOf(":");
+    if (separator <= 0 || separator === identity.length - 1) return null;
+    const type = identity.slice(0, separator);
+    const model = identity.slice(separator + 1);
+    if (type === "openai") {
+      const provider = this.createOpenAiProvider();
+      return provider && provider.model === model ? provider : null;
+    }
+    if (type === "local") {
+      const provider = this.createLocalProvider();
+      return provider && provider.model === model ? provider : null;
+    }
+    return null;
+  }
+  createOpenAiProvider() {
+    if (!this.config.openaiApiKey) return null;
+    const baseUrl = this.config.openaiBaseUrl ?? "https://api.openai.com/v1";
+    return {
+      type: "openai",
+      model: DEFAULT_OPENAI_MODEL,
+      endpoint: `${baseUrl.replace(/\/$/, "")}/embeddings`,
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.config.openaiApiKey}`
+      }
+    };
+  }
+  createLocalProvider() {
+    if (!this.config.localLlmEnabled || !this.config.localLlmUrl) return null;
+    const base = this.config.localLlmUrl.replace(/\/$/, "");
+    const endpoint = /\/v1$/i.test(base) ? `${base}/embeddings` : `${base}/v1/embeddings`;
+    const headers = {
+      "Content-Type": "application/json",
+      ...this.config.localLlmHeaders ?? {}
+    };
+    if (this.config.localLlmApiKey && this.config.localLlmAuthHeader !== false) {
+      headers.Authorization = `Bearer ${this.config.localLlmApiKey}`;
+    }
+    return {
+      type: "local",
+      model: this.config.embeddingFallbackModel || this.config.localLlmModel || DEFAULT_OPENAI_MODEL,
+      endpoint,
+      headers
+    };
+  }
+  resolveHostEmbeddingProvider() {
+    const scopedConfig = this.config;
+    const scopes = [
+      scopedConfig.memoryDir,
+      scopedConfig.hostEmbeddingProviderScope
+    ].filter((scope) => typeof scope === "string" && scope.trim().length > 0);
+    for (const scope of new Set(scopes)) {
+      const provider = getHostEmbeddingProvider(scope);
+      if (provider) return provider;
+    }
+    return void 0;
+  }
+  async callEmbed(input, provider, signal, inputType = "document") {
+    if (provider.type === "host") {
+      return this.callHostEmbed(input, provider.hostProvider, signal, inputType);
+    }
+    if (!provider.endpoint || !provider.headers) return null;
+    try {
+      const res = await fetch(provider.endpoint, {
+        method: "POST",
+        headers: provider.headers,
+        body: JSON.stringify({
+          model: provider.model,
+          input: input.slice(0, 8e3),
+          encoding_format: "float"
+        }),
+        signal: withTimeoutSignal(signal, 3e4)
+      });
+      if (!res.ok) {
+        log.debug(`EmbedHelper request failed: ${provider.type} ${res.status}`);
+        return null;
+      }
+      const payload = await res.json();
+      const vector = payload?.data?.[0]?.embedding;
+      return normalizeHttpEmbeddingVector(vector);
+    } catch (err) {
+      if (isAbortError(err)) throw err;
+      log.debug(`EmbedHelper error: ${err}`);
+      return null;
+    }
+  }
+  async callHostEmbed(input, provider, signal, inputType = "document") {
+    if (!provider) return null;
+    try {
+      const vector = await provider.embed(input.slice(0, 8e3), {
+        signal: withTimeoutSignal(signal, 3e4),
+        inputType
+      });
+      return this.normalizeHostEmbeddingVector(vector);
+    } catch (err) {
+      if (isAbortError(err)) throw err;
+      log.debug(`EmbedHelper host provider error: ${err}`);
+      return null;
+    }
+  }
+  async callHostEmbedBatch(inputs, provider, signal) {
+    try {
+      const vectors = await provider.embedBatch?.(
+        inputs.map((input) => input.slice(0, 8e3)),
+        {
+          signal: withTimeoutSignal(signal, 3e4),
+          inputType: "document"
+        }
+      );
+      if (!Array.isArray(vectors)) return inputs.map(() => null);
+      return inputs.map((_, index) => this.normalizeHostEmbeddingVector(vectors[index]));
+    } catch (err) {
+      if (isAbortError(err)) throw err;
+      log.debug(`EmbedHelper host provider batch error: ${err}`);
+      return inputs.map(() => null);
+    }
+  }
+  normalizeHostEmbeddingVector(value) {
+    const vector = normalizeHostEmbeddingVector(value);
+    if (!vector) return null;
+    const expectedDimension = this.resolveHostEmbeddingExpectedDimension();
+    if (expectedDimension !== null && vector.length !== expectedDimension) {
+      return null;
+    }
+    return vector;
+  }
+  resolveHostEmbeddingExpectedDimension() {
+    const value = this.options.hostEmbeddingExpectedDimension;
+    return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : null;
+  }
+};
+function providerIdentity(provider) {
+  return `${provider.type}:${provider.model}`;
+}
+function normalizeHttpEmbeddingVector(vector) {
+  if (!Array.isArray(vector)) return null;
+  const normalized = [];
+  for (const component of vector) {
+    if (typeof component !== "number" || !Number.isFinite(component)) {
+      return null;
+    }
+    normalized.push(component);
+  }
+  return normalized;
+}
+
+export {
+  EmbedHelper
+};
+//# sourceMappingURL=chunk-EWLQPEO6.js.map

package/dist/chunk-EWLQPEO6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/search/embed-helper.ts"],"sourcesContent":["import { log } from \"../logger.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 (!this.config.embeddingFallbackEnabled) 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 (!this.config.embeddingFallbackEnabled) 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 (!this.config.localLlmEnabled || !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":[]}

package/dist/{chunk-FVCZINOF.js → chunk-FHBEL473.js}

@@ -4,7 +4,7 @@ import {
 import {
   compareEntityTimestamps,
   normalizeEntityName
-} from "./chunk-TVZ6LKKS.js";
+} from "./chunk-IRFF6LSF.js";
 import {
   sanitizeMemoryContent
 } from "./chunk-FVQJYWH7.js";
@@ -628,4 +628,4 @@ export {
   entityIndexVersion,
   entityRecentTranscriptLookbackHours
 };
-//# sourceMappingURL=chunk-FVCZINOF.js.map
+//# sourceMappingURL=chunk-FHBEL473.js.map

package/dist/{chunk-7Q3RCKAQ.js → chunk-FXKPZ3H6.js}

@@ -1,6 +1,6 @@
 import {
   isRecallDisclosure
-} from "./chunk-M5T4Q2ZU.js";
+} from "./chunk-KGK2QKWL.js";
 import {
   normalizeRetrievedMemoryProvenance
 } from "./chunk-AC5LO7IU.js";
@@ -269,4 +269,4 @@ export {
   RecallXrayBuilder,
   summarizeDisclosureTokens
 };
-//# sourceMappingURL=chunk-7Q3RCKAQ.js.map
+//# sourceMappingURL=chunk-FXKPZ3H6.js.map

package/dist/{chunk-5WLYNZPC.js → chunk-GBXGCFRH.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-HQ6NIBL6.js";
 import {
   StorageManager
-} from "./chunk-TVZ6LKKS.js";
+} from "./chunk-IRFF6LSF.js";
 import {
   getCachedEpisodeMap,
   setCachedEpisodeMap
@@ -105,4 +105,4 @@ async function searchVerifiedEpisodes(options) {
 export {
   searchVerifiedEpisodes
 };
-//# sourceMappingURL=chunk-5WLYNZPC.js.map
+//# sourceMappingURL=chunk-GBXGCFRH.js.map

package/dist/{chunk-ILJXM3FV.js → chunk-HQO5EBUC.js}

@@ -10,10 +10,17 @@ import {
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-E5OECWZ5.js";
+} from "./chunk-XT7XVA53.js";
 import {
   StorageManager
-} from "./chunk-TVZ6LKKS.js";
+} from "./chunk-IRFF6LSF.js";
+import {
+  MEMORY_LIFECYCLE_EVENT_SORT_ORDER,
+  buildLifecycleEventsForMemory,
+  inferMemoryStatus,
+  sortMemoryLifecycleEvents,
+  toMemoryPathRel
+} from "./chunk-RULE4VG5.js";
 import {
   normalizeProjectionPreview,
   normalizeProjectionTags
@@ -32,13 +39,6 @@ import {
 import {
   openBetterSqlite3
 } from "./chunk-3HPAPHUK.js";
-import {
-  MEMORY_LIFECYCLE_EVENT_SORT_ORDER,
-  buildLifecycleEventsForMemory,
-  inferMemoryStatus,
-  sortMemoryLifecycleEvents,
-  toMemoryPathRel
-} from "./chunk-RULE4VG5.js";
 
 // src/maintenance/rebuild-memory-projection.ts
 import path from "path";
@@ -929,4 +929,4 @@ export {
   verifyMemoryProjection,
   repairMemoryProjection
 };
-//# sourceMappingURL=chunk-ILJXM3FV.js.map
+//# sourceMappingURL=chunk-HQO5EBUC.js.map

package/dist/{chunk-FK556DDH.js → chunk-I4UNL747.js}

@@ -1,10 +1,10 @@
-import {
-  scanMemoryDir
-} from "./chunk-Q4CAQGKQ.js";
 import {
   isSearchAborted,
   throwIfSearchAborted
 } from "./chunk-CINZGPSJ.js";
+import {
+  scanMemoryDir
+} from "./chunk-Q4CAQGKQ.js";
 import {
   log
 } from "./chunk-2ODBA7MQ.js";
@@ -204,4 +204,4 @@ var MeilisearchBackend = class {
 export {
   MeilisearchBackend
 };
-//# sourceMappingURL=chunk-FK556DDH.js.map
+//# sourceMappingURL=chunk-I4UNL747.js.map