@unbrained/pm-cli 2026.5.30 → 2026.6.5

package/dist/core/search/cache.d.ts

@@ -1,4 +1,5 @@
 import { readSettings } from "../store/settings.js";
+import type { VectorizationEmbeddingMetadata } from "./vectorization-metadata.js";
 export declare const SEARCH_CACHE_ARTIFACT_PATHS: readonly ["index/manifest.json", "search/embeddings.jsonl"];
 export declare const VECTORIZATION_STATUS_LEDGER_PATH = "search/vectorization-status.json";
 export interface SearchCacheInvalidationResult {
@@ -13,6 +14,17 @@ export interface SemanticMutationRefreshResult {
 export interface SearchMutationArtifactRefreshResult extends SearchCacheInvalidationResult {
     refreshed: string[];
     skipped: string[];
+    /** True when the semantic refresh was dispatched to a detached background worker. */
+    scheduled?: boolean;
+}
+export interface RefreshSearchArtifactsForMutationOptions {
+    /**
+     * When true and semantic search is active, the (slow) embedding refresh is
+     * dispatched to a detached background worker instead of awaited inline so the
+     * mutation returns immediately. The synchronous keyword-cache invalidation
+     * still runs first. Callers pass this only outside test runners.
+     */
+    background?: boolean;
 }
 export interface SemanticRefreshOptions {
     settings?: Awaited<ReturnType<typeof readSettings>>;
@@ -20,10 +32,19 @@ export interface SemanticRefreshOptions {
 }
 export interface VectorizationStatusLedgerReadResult {
     entries: Record<string, string>;
+    embedding: VectorizationEmbeddingMetadata | null;
     warnings: string[];
 }
 export declare function readVectorizationStatusLedger(pmRoot: string): Promise<VectorizationStatusLedgerReadResult>;
-export declare function writeVectorizationStatusLedger(pmRoot: string, entries: Record<string, string>): Promise<void>;
+export declare function writeVectorizationStatusLedger(pmRoot: string, entries: Record<string, string>, embedding?: VectorizationEmbeddingMetadata | null): Promise<void>;
 export declare function invalidateSearchCacheArtifacts(pmRoot: string): Promise<SearchCacheInvalidationResult>;
 export declare function refreshSemanticEmbeddingsForMutatedItems(pmRoot: string, itemIds: string[], options?: SemanticRefreshOptions): Promise<SemanticMutationRefreshResult>;
-export declare function refreshSearchArtifactsForMutation(pmRoot: string, itemIds: string[]): Promise<SearchMutationArtifactRefreshResult>;
+/**
+ * Returns true when a semantic embedding refresh would do real work for these
+ * settings (an embedding provider AND a vector store both resolve). Used to
+ * decide whether a mutation's refresh is worth dispatching to a background
+ * worker — when semantic search is not configured the inline path is already a
+ * fast no-op and no child is spawned.
+ */
+export declare function isSemanticRefreshActive(settings: Awaited<ReturnType<typeof readSettings>>, applyRuntimeDefaults: boolean): boolean;
+export declare function refreshSearchArtifactsForMutation(pmRoot: string, itemIds: string[], options?: RefreshSearchArtifactsForMutationOptions): Promise<SearchMutationArtifactRefreshResult>;

package/dist/core/search/cache.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4a4a71bc-457b-5496-a2e8-e3e3537d01ae")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5d698c95-b557-5c29-bc3f-caf70b5d6d0f")}catch(e){}}();
 import path from "node:path";
 import { getActiveExtensionRegistrations } from "../extensions/index.js";
 import { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from "../fs/fs-utils.js";
@@ -12,7 +12,9 @@ import { executeEmbeddingBatchesWithRetry } from "./embedding-batches.js";
 import { buildSemanticCorpusInput } from "./corpus.js";
 import { resolveEmbeddingProviders } from "./providers.js";
 import { resolveSettingsWithSemanticRuntimeDefaults } from "./semantic-defaults.js";
-import { executeVectorDelete, executeVectorUpsert, resolveVectorStores } from "./vector-stores.js";
+import { scheduleBackgroundSemanticRefresh } from "./background-refresh.js";
+import { executeVectorDelete, executeVectorReset, executeVectorUpsert, resolveVectorStores } from "./vector-stores.js";
+import { buildVectorizationEmbeddingIdentity, buildVectorizationEmbeddingMetadata, hasVectorizationEmbeddingIdentityChanged, hasVectorizationVectorDimensionChanged, inferConsistentVectorDimension, normalizeVectorizationEmbeddingMetadata, } from "./vectorization-metadata.js";
 import { nowIso } from "../shared/time.js";
 export const SEARCH_CACHE_ARTIFACT_PATHS = ["index/manifest.json", "search/embeddings.jsonl"];
 export const VECTORIZATION_STATUS_LEDGER_PATH = "search/vectorization-status.json";
@@ -43,6 +45,7 @@ export async function readVectorizationStatusLedger(pmRoot) {
     if (raw === null || raw.trim().length === 0) {
         return {
             entries: {},
+            embedding: null,
             warnings: [],
         };
     }
@@ -53,6 +56,7 @@ export async function readVectorizationStatusLedger(pmRoot) {
     catch {
         return {
             entries: {},
+            embedding: null,
             warnings: ["search_vectorization_status_ledger_invalid"],
         };
     }
@@ -62,6 +66,7 @@ export async function readVectorizationStatusLedger(pmRoot) {
         !Array.isArray(parsed.items)) {
         return {
             entries: {},
+            embedding: null,
             warnings: ["search_vectorization_status_ledger_invalid"],
         };
     }
@@ -70,6 +75,7 @@ export async function readVectorizationStatusLedger(pmRoot) {
         if (typeof entry !== "object" || entry === null) {
             return {
                 entries: {},
+                embedding: null,
                 warnings: ["search_vectorization_status_ledger_invalid"],
             };
         }
@@ -78,22 +84,36 @@ export async function readVectorizationStatusLedger(pmRoot) {
         if (typeof id !== "string" || id.trim().length === 0 || !isValidUpdatedAt(updatedAt)) {
             return {
                 entries: {},
+                embedding: null,
                 warnings: ["search_vectorization_status_ledger_invalid"],
             };
         }
         mapped.set(id.trim(), updatedAt);
     }
+    let embedding = null;
+    try {
+        embedding = normalizeVectorizationEmbeddingMetadata(parsed.embedding);
+    }
+    catch {
+        return {
+            entries: {},
+            embedding: null,
+            warnings: ["search_vectorization_status_ledger_invalid"],
+        };
+    }
     return {
         entries: Object.fromEntries([...mapped.entries()].sort((left, right) => left[0].localeCompare(right[0]))),
+        embedding,
         warnings: [],
     };
 }
-export async function writeVectorizationStatusLedger(pmRoot, entries) {
+export async function writeVectorizationStatusLedger(pmRoot, entries, embedding) {
     const normalizedEntries = normalizeVectorizationLedgerEntries(entries);
     const ledgerPath = path.join(pmRoot, VECTORIZATION_STATUS_LEDGER_PATH);
     const serialized = `${JSON.stringify({
         version: 1,
         generated_at: nowIso(),
+        ...(embedding ? { embedding } : {}),
         items: Object.entries(normalizedEntries).map(([id, updated_at]) => ({
             id,
             updated_at,
@@ -110,6 +130,13 @@ function buildVectorPayload(item) {
         updated_at: item.updated_at,
     };
 }
+function buildVectorizationIdentityForProvider(provider) {
+    const identity = buildVectorizationEmbeddingIdentity(provider.name, provider.model);
+    if (!identity) {
+        throw new Error("Embedding provider must include a provider name and model");
+    }
+    return identity;
+}
 function buildSkippedSemanticRefreshResult(itemIds, warning) {
     return {
         refreshed: [],
@@ -176,31 +203,39 @@ async function collectSemanticRefreshWorkload(pmRoot, idPrefix, preferredFormat,
         warnings,
     };
 }
-async function refreshLocatedSemanticVectors(settings, provider, vectorStore, documents) {
-    if (documents.length === 0) {
-        return { refreshed: [], skipped: [], warnings: [] };
-    }
+async function embedLocatedSemanticVectors(settings, provider, documents) {
+    const corpusInputs = documents.map((entry) => buildSemanticCorpusInput(entry.document, {
+        providerName: provider.name,
+    }));
+    const embeddingResult = await executeEmbeddingBatchesWithRetry(provider, settings, corpusInputs);
+    return {
+        vectors: embeddingResult.vectors,
+        vector_dimension: inferConsistentVectorDimension(embeddingResult.vectors, "Semantic refresh embedding"),
+        warnings: embeddingResult.warnings,
+    };
+}
+async function upsertLocatedSemanticVectors(vectorStore, documents, vectors) {
+    await executeVectorUpsert(vectorStore, documents.map((entry, index) => ({
+        id: entry.id,
+        vector: vectors[index],
+        payload: buildVectorPayload(entry.document.metadata),
+    })));
+    return {
+        refreshed: documents.map((entry) => entry.id),
+        skipped: [],
+        warnings: [],
+    };
+}
+async function resetSemanticVectorStore(vectorStore, ledgerEntries) {
     try {
-        const corpusInputs = documents.map((entry) => buildSemanticCorpusInput(entry.document, {
-            providerName: provider.name,
-        }));
-        const embeddingResult = await executeEmbeddingBatchesWithRetry(provider, settings, corpusInputs);
-        await executeVectorUpsert(vectorStore, documents.map((entry, index) => ({
-            id: entry.id,
-            vector: embeddingResult.vectors[index],
-            payload: buildVectorPayload(entry.document.metadata),
-        })));
-        return {
-            refreshed: documents.map((entry) => entry.id),
-            skipped: [],
-            warnings: embeddingResult.warnings,
-        };
+        await executeVectorReset(vectorStore, Object.keys(ledgerEntries));
+        return { refreshed: [], skipped: [], warnings: [] };
     }
     catch (error) {
         return {
             refreshed: [],
-            skipped: documents.map((entry) => entry.id),
-            warnings: [`search_semantic_refresh_failed:${toErrorMessage(error)}`],
+            skipped: [],
+            warnings: [`search_semantic_refresh_reset_failed:${toErrorMessage(error)}`],
         };
     }
 }
@@ -260,7 +295,50 @@ export async function refreshSemanticEmbeddingsForMutatedItems(pmRoot, itemIds,
     }
     const typeRegistry = resolveItemTypeRegistry(runtimeContext.settings, getActiveExtensionRegistrations());
     const workload = await collectSemanticRefreshWorkload(pmRoot, runtimeContext.settings.id_prefix, runtimeContext.settings.item_format, normalizedItemIds, typeRegistry.type_to_folder, runtimeContext.settings.schema);
-    const refreshedResult = await refreshLocatedSemanticVectors(runtimeContext.settings, runtimeContext.provider, runtimeContext.vectorStore, workload.documents);
+    const ledgerRead = workload.documents.length > 0 || workload.missingIds.length > 0
+        ? await readVectorizationStatusLedger(pmRoot)
+        : { entries: {}, embedding: null, warnings: [] };
+    const embeddingIdentity = buildVectorizationIdentityForProvider(runtimeContext.provider);
+    const nextLedgerBaseEntries = ledgerRead.entries;
+    let refreshedResult = { refreshed: [], skipped: [], warnings: [] };
+    let nextEmbeddingMetadata = ledgerRead.embedding;
+    if (workload.documents.length > 0) {
+        if (ledgerRead.embedding && hasVectorizationEmbeddingIdentityChanged(ledgerRead.embedding, embeddingIdentity)) {
+            refreshedResult = {
+                refreshed: [],
+                skipped: workload.documents.map((entry) => entry.id),
+                warnings: ["search_semantic_refresh_requires_reindex:embedding_identity_changed"],
+            };
+        }
+        else {
+            try {
+                const embedded = await embedLocatedSemanticVectors(runtimeContext.settings, runtimeContext.provider, workload.documents);
+                if (hasVectorizationVectorDimensionChanged(ledgerRead.embedding, embedded.vector_dimension)) {
+                    refreshedResult = {
+                        refreshed: [],
+                        skipped: workload.documents.map((entry) => entry.id),
+                        warnings: [...embedded.warnings, "search_semantic_refresh_requires_reindex:vector_dimension_changed"],
+                    };
+                }
+                else {
+                    nextEmbeddingMetadata = buildVectorizationEmbeddingMetadata(embeddingIdentity, embedded.vector_dimension);
+                    const upserted = await upsertLocatedSemanticVectors(runtimeContext.vectorStore, workload.documents, embedded.vectors);
+                    refreshedResult = {
+                        refreshed: upserted.refreshed,
+                        skipped: upserted.skipped,
+                        warnings: [...embedded.warnings, ...upserted.warnings],
+                    };
+                }
+            }
+            catch (error) {
+                refreshedResult = {
+                    refreshed: [],
+                    skipped: workload.documents.map((entry) => entry.id),
+                    warnings: [`search_semantic_refresh_failed:${toErrorMessage(error)}`],
+                };
+            }
+        }
+    }
     const pruneResult = await pruneMissingSemanticVectors(runtimeContext.vectorStore, workload.missingIds);
     const refreshedIdSet = new Set(refreshedResult.refreshed);
     const refreshedEntries = Object.fromEntries(workload.documents
@@ -268,16 +346,15 @@ export async function refreshSemanticEmbeddingsForMutatedItems(pmRoot, itemIds,
         .map((entry) => [entry.id, entry.document.metadata.updated_at]));
     const ledgerWarnings = [];
     if (Object.keys(refreshedEntries).length > 0 || workload.missingIds.length > 0) {
-        const ledgerRead = await readVectorizationStatusLedger(pmRoot);
         const nextEntries = {
-            ...ledgerRead.entries,
+            ...nextLedgerBaseEntries,
             ...normalizeVectorizationLedgerEntries(refreshedEntries),
         };
         for (const missingId of workload.missingIds) {
             delete nextEntries[missingId];
         }
         try {
-            await writeVectorizationStatusLedger(pmRoot, nextEntries);
+            await writeVectorizationStatusLedger(pmRoot, nextEntries, nextEmbeddingMetadata);
         }
         catch (error) {
             ledgerWarnings.push(`search_vectorization_status_ledger_write_failed:${toErrorMessage(error)}`);
@@ -290,7 +367,20 @@ export async function refreshSemanticEmbeddingsForMutatedItems(pmRoot, itemIds,
         warnings: [...workload.warnings, ...refreshedResult.warnings, ...pruneResult.warnings, ...ledgerWarnings],
     };
 }
-export async function refreshSearchArtifactsForMutation(pmRoot, itemIds) {
+/**
+ * Returns true when a semantic embedding refresh would do real work for these
+ * settings (an embedding provider AND a vector store both resolve). Used to
+ * decide whether a mutation's refresh is worth dispatching to a background
+ * worker — when semantic search is not configured the inline path is already a
+ * fast no-op and no child is spawned.
+ */
+export function isSemanticRefreshActive(settings, applyRuntimeDefaults) {
+    const effectiveSettings = applyRuntimeDefaults
+        ? resolveSettingsWithSemanticRuntimeDefaults(settings).settings
+        : settings;
+    return Boolean(resolveEmbeddingProviders(effectiveSettings).active && resolveVectorStores(effectiveSettings).active);
+}
+export async function refreshSearchArtifactsForMutation(pmRoot, itemIds, options = {}) {
     const invalidation = await invalidateSearchCacheArtifacts(pmRoot);
     const normalizedItemIds = toUniqueSorted(itemIds);
     if (normalizedItemIds.length === 0) {
@@ -333,9 +423,24 @@ export async function refreshSearchArtifactsForMutation(pmRoot, itemIds) {
             warnings: invalidation.warnings,
         };
     }
+    const applyRuntimeDefaults = settings.search.mutation_refresh_policy === "semantic_auto";
+    // Keyword cache is already invalidated synchronously above (so keyword search
+    // stays immediately correct). When requested, dispatch the slow embedding
+    // refresh to a detached worker so the mutation returns instantly; the
+    // vector_index_stale health/search warning covers the catch-up window.
+    if (options.background && isSemanticRefreshActive(settings, applyRuntimeDefaults)) {
+        await scheduleBackgroundSemanticRefresh(pmRoot, normalizedItemIds);
+        return {
+            invalidated: invalidation.invalidated,
+            refreshed: [],
+            skipped: [],
+            warnings: [...invalidation.warnings, "search_semantic_refresh_scheduled_background"],
+            scheduled: true,
+        };
+    }
     const semanticRefresh = await refreshSemanticEmbeddingsForMutatedItems(pmRoot, normalizedItemIds, {
         settings,
-        apply_runtime_defaults: settings.search.mutation_refresh_policy === "semantic_auto",
+        apply_runtime_defaults: applyRuntimeDefaults,
     });
     return {
         invalidated: invalidation.invalidated,
@@ -345,4 +450,4 @@ export async function refreshSearchArtifactsForMutation(pmRoot, itemIds) {
     };
 }
 //# sourceMappingURL=cache.js.map
-//# debugId=4a4a71bc-457b-5496-a2e8-e3e3537d01ae
+//# debugId=5d698c95-b557-5c29-bc3f-caf70b5d6d0f

package/dist/core/search/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sources":["core/search/cache.ts"],"sourceRoot":"/","sourcesContent":["import path from \"node:path\";\nimport { getActiveExtensionRegistrations } from \"../extensions/index.js\";\nimport { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { resolveItemTypeRegistry } from \"../item/type-registry.js\";\nimport { toErrorMessage } from \"../shared/primitives.js\";\nimport { locateItem, readLocatedItem } from \"../store/item-store.js\";\nimport { getSettingsPath } from \"../store/paths.js\";\nimport { readSettings } from \"../store/settings.js\";\nimport { executeEmbeddingBatchesWithRetry } from \"./embedding-batches.js\";\nimport { buildSemanticCorpusInput } from \"./corpus.js\";\nimport { resolveEmbeddingProviders } from \"./providers.js\";\nimport type { EmbeddingProviderConfig } from \"./providers.js\";\nimport { resolveSettingsWithSemanticRuntimeDefaults } from \"./semantic-defaults.js\";\nimport { executeVectorDelete, executeVectorUpsert, resolveVectorStores } from \"./vector-stores.js\";\nimport type { VectorStoreConfig } from \"./vector-stores.js\";\nimport { nowIso } from \"../shared/time.js\";\nimport type { ItemDocument, ItemFrontMatter } from \"../../types/index.js\";\n\nexport const SEARCH_CACHE_ARTIFACT_PATHS = [\"index/manifest.json\", \"search/embeddings.jsonl\"] as const;\nexport const VECTORIZATION_STATUS_LEDGER_PATH = \"search/vectorization-status.json\";\n\nexport interface SearchCacheInvalidationResult {\n  invalidated: string[];\n  warnings: string[];\n}\n\nexport interface SemanticMutationRefreshResult {\n  refreshed: string[];\n  skipped: string[];\n  warnings: string[];\n}\n\nexport interface SearchMutationArtifactRefreshResult extends SearchCacheInvalidationResult {\n  refreshed: string[];\n  skipped: string[];\n}\n\nexport interface SemanticRefreshOptions {\n  settings?: Awaited<ReturnType<typeof readSettings>>;\n  apply_runtime_defaults?: boolean;\n}\n\nexport interface VectorizationStatusLedgerReadResult {\n  entries: Record<string, string>;\n  warnings: string[];\n}\n\nfunction formatInvalidationWarning(relativePath: string, error: unknown): string {\n  return `search_cache_invalidation_failed:${relativePath}:${String(error)}`;\n}\n\n\nfunction toUniqueSorted(values: Iterable<string>): string[] {\n  return [...new Set([...values].map((value) => value.trim()).filter((value) => value.length > 0))]\n    .sort((left, right) => left.localeCompare(right));\n}\n\nfunction isValidUpdatedAt(value: unknown): value is string {\n  return typeof value === \"string\" && value.trim().length > 0 && Number.isFinite(Date.parse(value));\n}\n\nfunction normalizeVectorizationLedgerEntries(entries: Record<string, string>): Record<string, string> {\n  const normalized = new Map<string, string>();\n  for (const [rawId, rawUpdatedAt] of Object.entries(entries)) {\n    const id = rawId.trim();\n    if (id.length === 0 || !isValidUpdatedAt(rawUpdatedAt)) {\n      continue;\n    }\n    normalized.set(id, rawUpdatedAt);\n  }\n  return Object.fromEntries([...normalized.entries()].sort((left, right) => left[0].localeCompare(right[0])));\n}\n\nexport async function readVectorizationStatusLedger(pmRoot: string): Promise<VectorizationStatusLedgerReadResult> {\n  const ledgerPath = path.join(pmRoot, VECTORIZATION_STATUS_LEDGER_PATH);\n  const raw = await readFileIfExists(ledgerPath);\n  if (raw === null || raw.trim().length === 0) {\n    return {\n      entries: {},\n      warnings: [],\n    };\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    return {\n      entries: {},\n      warnings: [\"search_vectorization_status_ledger_invalid\"],\n    };\n  }\n\n  if (\n    typeof parsed !== \"object\" ||\n    parsed === null ||\n    (parsed as { version?: unknown }).version !== 1 ||\n    !Array.isArray((parsed as { items?: unknown }).items)\n  ) {\n    return {\n      entries: {},\n      warnings: [\"search_vectorization_status_ledger_invalid\"],\n    };\n  }\n\n  const mapped = new Map<string, string>();\n  for (const entry of (parsed as { items: unknown[] }).items) {\n    if (typeof entry !== \"object\" || entry === null) {\n      return {\n        entries: {},\n        warnings: [\"search_vectorization_status_ledger_invalid\"],\n      };\n    }\n    const id = (entry as { id?: unknown }).id;\n    const updatedAt = (entry as { updated_at?: unknown }).updated_at;\n    if (typeof id !== \"string\" || id.trim().length === 0 || !isValidUpdatedAt(updatedAt)) {\n      return {\n        entries: {},\n        warnings: [\"search_vectorization_status_ledger_invalid\"],\n      };\n    }\n    mapped.set(id.trim(), updatedAt);\n  }\n\n  return {\n    entries: Object.fromEntries([...mapped.entries()].sort((left, right) => left[0].localeCompare(right[0]))),\n    warnings: [],\n  };\n}\n\nexport async function writeVectorizationStatusLedger(pmRoot: string, entries: Record<string, string>): Promise<void> {\n  const normalizedEntries = normalizeVectorizationLedgerEntries(entries);\n  const ledgerPath = path.join(pmRoot, VECTORIZATION_STATUS_LEDGER_PATH);\n  const serialized = `${JSON.stringify(\n    {\n      version: 1,\n      generated_at: nowIso(),\n      items: Object.entries(normalizedEntries).map(([id, updated_at]) => ({\n        id,\n        updated_at,\n      })),\n    },\n    null,\n    2,\n  )}\\n`;\n  await writeFileAtomic(ledgerPath, serialized);\n}\n\nfunction buildVectorPayload(item: ItemFrontMatter): Record<string, unknown> {\n  return {\n    id: item.id,\n    type: item.type,\n    status: item.status,\n    priority: item.priority,\n    updated_at: item.updated_at,\n  };\n}\n\ninterface SemanticRefreshRuntimeContext {\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  provider: EmbeddingProviderConfig;\n  vectorStore: VectorStoreConfig;\n}\n\ninterface SemanticRefreshWorkload {\n  documents: Array<{ id: string; document: ItemDocument }>;\n  missingIds: string[];\n  skippedIds: string[];\n  warnings: string[];\n}\n\ninterface SemanticRefreshOperationResult {\n  refreshed: string[];\n  skipped: string[];\n  warnings: string[];\n}\n\nfunction buildSkippedSemanticRefreshResult(itemIds: string[], warning: string): SemanticMutationRefreshResult {\n  return {\n    refreshed: [],\n    skipped: itemIds,\n    warnings: [warning],\n  };\n}\n\nasync function resolveSemanticRefreshRuntimeContext(\n  pmRoot: string,\n  normalizedItemIds: string[],\n  options: SemanticRefreshOptions,\n): Promise<SemanticRefreshRuntimeContext | SemanticMutationRefreshResult> {\n  if (!options.settings && !(await pathExists(getSettingsPath(pmRoot)))) {\n    return buildSkippedSemanticRefreshResult(normalizedItemIds, \"search_semantic_refresh_skipped:settings_not_initialized\");\n  }\n\n  let settings: Awaited<ReturnType<typeof readSettings>>;\n  try {\n    settings = options.settings ?? (await readSettings(pmRoot));\n  } catch (error: unknown) {\n    return buildSkippedSemanticRefreshResult(\n      normalizedItemIds,\n      `search_semantic_refresh_skipped:settings_read_failed:${toErrorMessage(error)}`,\n    );\n  }\n  const effectiveSettings = options.apply_runtime_defaults\n    ? resolveSettingsWithSemanticRuntimeDefaults(settings).settings\n    : settings;\n\n  const provider = resolveEmbeddingProviders(effectiveSettings).active;\n  if (!provider) {\n    return buildSkippedSemanticRefreshResult(normalizedItemIds, \"search_semantic_refresh_skipped:provider_unconfigured\");\n  }\n  const vectorStore = resolveVectorStores(effectiveSettings).active;\n  if (!vectorStore) {\n    return buildSkippedSemanticRefreshResult(normalizedItemIds, \"search_semantic_refresh_skipped:vector_store_unconfigured\");\n  }\n\n  return {\n    settings: effectiveSettings,\n    provider,\n    vectorStore,\n  };\n}\n\nasync function collectSemanticRefreshWorkload(\n  pmRoot: string,\n  idPrefix: string,\n  preferredFormat: \"toon\" | \"json_markdown\",\n  normalizedItemIds: string[],\n  typeToFolder: Record<string, string>,\n  schema: Awaited<ReturnType<typeof readSettings>>[\"schema\"],\n): Promise<SemanticRefreshWorkload> {\n  const warnings: string[] = [];\n  const skipped = new Set<string>();\n  const missing = new Set<string>();\n  const documents: Array<{ id: string; document: ItemDocument }> = [];\n\n  for (const itemId of normalizedItemIds) {\n    const located = await locateItem(pmRoot, itemId, idPrefix, preferredFormat, typeToFolder);\n    if (!located) {\n      missing.add(itemId);\n      continue;\n    }\n\n    try {\n      const loaded = await readLocatedItem(located, { schema });\n      documents.push({\n        id: loaded.document.metadata.id,\n        document: loaded.document,\n      });\n    } catch (error: unknown) {\n      skipped.add(located.id);\n      warnings.push(`search_semantic_refresh_item_read_failed:${located.id}:${toErrorMessage(error)}`);\n    }\n  }\n\n  documents.sort((left, right) => left.id.localeCompare(right.id));\n  return {\n    documents,\n    missingIds: toUniqueSorted(missing),\n    skippedIds: toUniqueSorted(skipped),\n    warnings,\n  };\n}\n\nasync function refreshLocatedSemanticVectors(\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  provider: EmbeddingProviderConfig,\n  vectorStore: VectorStoreConfig,\n  documents: Array<{ id: string; document: ItemDocument }>,\n): Promise<SemanticRefreshOperationResult> {\n  if (documents.length === 0) {\n    return { refreshed: [], skipped: [], warnings: [] };\n  }\n\n  try {\n    const corpusInputs = documents.map((entry) =>\n      buildSemanticCorpusInput(entry.document, {\n        providerName: provider.name,\n      }),\n    );\n    const embeddingResult = await executeEmbeddingBatchesWithRetry(provider, settings, corpusInputs);\n    await executeVectorUpsert(\n      vectorStore,\n      documents.map((entry, index) => ({\n        id: entry.id,\n        vector: embeddingResult.vectors[index],\n        payload: buildVectorPayload(entry.document.metadata),\n      })),\n    );\n    return {\n      refreshed: documents.map((entry) => entry.id),\n      skipped: [],\n      warnings: embeddingResult.warnings,\n    };\n  } catch (error: unknown) {\n    return {\n      refreshed: [],\n      skipped: documents.map((entry) => entry.id),\n      warnings: [`search_semantic_refresh_failed:${toErrorMessage(error)}`],\n    };\n  }\n}\n\nasync function pruneMissingSemanticVectors(\n  vectorStore: VectorStoreConfig,\n  missingIds: string[],\n): Promise<SemanticRefreshOperationResult> {\n  if (missingIds.length === 0) {\n    return { refreshed: [], skipped: [], warnings: [] };\n  }\n  try {\n    await executeVectorDelete(vectorStore, missingIds);\n    return {\n      refreshed: [],\n      skipped: [],\n      warnings: [],\n    };\n  } catch (error: unknown) {\n    return {\n      refreshed: [],\n      skipped: missingIds,\n      warnings: [`search_semantic_refresh_delete_failed:${toErrorMessage(error)}`],\n    };\n  }\n}\n\nexport async function invalidateSearchCacheArtifacts(pmRoot: string): Promise<SearchCacheInvalidationResult> {\n  const invalidated: string[] = [];\n  const warnings: string[] = [];\n\n  for (const relativePath of SEARCH_CACHE_ARTIFACT_PATHS) {\n    const artifactPath = path.join(pmRoot, relativePath);\n    try {\n      if (!(await pathExists(artifactPath))) {\n        continue;\n      }\n      await removeFileIfExists(artifactPath);\n      invalidated.push(relativePath);\n    } catch (error: unknown) {\n      warnings.push(formatInvalidationWarning(relativePath, error));\n    }\n  }\n\n  return {\n    invalidated,\n    warnings,\n  };\n}\n\nexport async function refreshSemanticEmbeddingsForMutatedItems(\n  pmRoot: string,\n  itemIds: string[],\n  options: SemanticRefreshOptions = {},\n): Promise<SemanticMutationRefreshResult> {\n  const normalizedItemIds = toUniqueSorted(itemIds);\n  if (normalizedItemIds.length === 0) {\n    return {\n      refreshed: [],\n      skipped: [],\n      warnings: [],\n    };\n  }\n\n  const runtimeContext = await resolveSemanticRefreshRuntimeContext(pmRoot, normalizedItemIds, options);\n  if (!(\"settings\" in runtimeContext)) {\n    return runtimeContext;\n  }\n  const typeRegistry = resolveItemTypeRegistry(runtimeContext.settings, getActiveExtensionRegistrations());\n  const workload = await collectSemanticRefreshWorkload(\n    pmRoot,\n    runtimeContext.settings.id_prefix,\n    runtimeContext.settings.item_format,\n    normalizedItemIds,\n    typeRegistry.type_to_folder,\n    runtimeContext.settings.schema,\n  );\n  const refreshedResult = await refreshLocatedSemanticVectors(\n    runtimeContext.settings,\n    runtimeContext.provider,\n    runtimeContext.vectorStore,\n    workload.documents,\n  );\n  const pruneResult = await pruneMissingSemanticVectors(runtimeContext.vectorStore, workload.missingIds);\n  const refreshedIdSet = new Set(refreshedResult.refreshed);\n  const refreshedEntries = Object.fromEntries(\n    workload.documents\n      .filter((entry) => refreshedIdSet.has(entry.id))\n      .map((entry) => [entry.id, entry.document.metadata.updated_at]),\n  );\n  const ledgerWarnings: string[] = [];\n  if (Object.keys(refreshedEntries).length > 0 || workload.missingIds.length > 0) {\n    const ledgerRead = await readVectorizationStatusLedger(pmRoot);\n    const nextEntries = {\n      ...ledgerRead.entries,\n      ...normalizeVectorizationLedgerEntries(refreshedEntries),\n    };\n    for (const missingId of workload.missingIds) {\n      delete nextEntries[missingId];\n    }\n    try {\n      await writeVectorizationStatusLedger(pmRoot, nextEntries);\n    } catch (error: unknown) {\n      ledgerWarnings.push(`search_vectorization_status_ledger_write_failed:${toErrorMessage(error)}`);\n    }\n    ledgerWarnings.push(...ledgerRead.warnings);\n  }\n\n  return {\n    refreshed: toUniqueSorted([...refreshedResult.refreshed, ...pruneResult.refreshed]),\n    skipped: toUniqueSorted([...workload.skippedIds, ...refreshedResult.skipped, ...pruneResult.skipped]),\n    warnings: [...workload.warnings, ...refreshedResult.warnings, ...pruneResult.warnings, ...ledgerWarnings],\n  };\n}\n\nexport async function refreshSearchArtifactsForMutation(\n  pmRoot: string,\n  itemIds: string[],\n): Promise<SearchMutationArtifactRefreshResult> {\n  const invalidation = await invalidateSearchCacheArtifacts(pmRoot);\n  const normalizedItemIds = toUniqueSorted(itemIds);\n  if (normalizedItemIds.length === 0) {\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: [],\n      warnings: invalidation.warnings,\n    };\n  }\n\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    const semanticRefresh = await refreshSemanticEmbeddingsForMutatedItems(pmRoot, normalizedItemIds);\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: semanticRefresh.refreshed,\n      skipped: semanticRefresh.skipped,\n      warnings: [...invalidation.warnings, ...semanticRefresh.warnings],\n    };\n  }\n\n  let settings: Awaited<ReturnType<typeof readSettings>>;\n  try {\n    settings = await readSettings(pmRoot);\n  } catch (error: unknown) {\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: normalizedItemIds,\n      warnings: [\n        ...invalidation.warnings,\n        `search_semantic_refresh_skipped:settings_read_failed:${toErrorMessage(error)}`,\n      ],\n    };\n  }\n\n  if (settings.search.mutation_refresh_policy === \"cache_only\") {\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: normalizedItemIds,\n      warnings: invalidation.warnings,\n    };\n  }\n\n  const semanticRefresh = await refreshSemanticEmbeddingsForMutatedItems(pmRoot, normalizedItemIds, {\n    settings,\n    apply_runtime_defaults: settings.search.mutation_refresh_policy === \"semantic_auto\",\n  });\n  return {\n    invalidated: invalidation.invalidated,\n    refreshed: semanticRefresh.refreshed,\n    skipped: semanticRefresh.skipped,\n    warnings: [...invalidation.warnings, ...semanticRefresh.warnings],\n  };\n}\n"],"names":[],"mappings":"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","debugId":"4a4a71bc-457b-5496-a2e8-e3e3537d01ae"}
+{"version":3,"file":"cache.js","sources":["core/search/cache.ts"],"sourceRoot":"/","sourcesContent":["import path from \"node:path\";\nimport { getActiveExtensionRegistrations } from \"../extensions/index.js\";\nimport { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { resolveItemTypeRegistry } from \"../item/type-registry.js\";\nimport { toErrorMessage } from \"../shared/primitives.js\";\nimport { locateItem, readLocatedItem } from \"../store/item-store.js\";\nimport { getSettingsPath } from \"../store/paths.js\";\nimport { readSettings } from \"../store/settings.js\";\nimport { executeEmbeddingBatchesWithRetry } from \"./embedding-batches.js\";\nimport { buildSemanticCorpusInput } from \"./corpus.js\";\nimport { resolveEmbeddingProviders } from \"./providers.js\";\nimport type { EmbeddingProviderConfig } from \"./providers.js\";\nimport { resolveSettingsWithSemanticRuntimeDefaults } from \"./semantic-defaults.js\";\nimport { scheduleBackgroundSemanticRefresh } from \"./background-refresh.js\";\nimport { executeVectorDelete, executeVectorReset, executeVectorUpsert, resolveVectorStores } from \"./vector-stores.js\";\nimport type { VectorStoreConfig } from \"./vector-stores.js\";\nimport {\n  buildVectorizationEmbeddingIdentity,\n  buildVectorizationEmbeddingMetadata,\n  hasVectorizationEmbeddingIdentityChanged,\n  hasVectorizationVectorDimensionChanged,\n  inferConsistentVectorDimension,\n  normalizeVectorizationEmbeddingMetadata,\n} from \"./vectorization-metadata.js\";\nimport type {\n  VectorizationEmbeddingIdentity,\n  VectorizationEmbeddingMetadata,\n} from \"./vectorization-metadata.js\";\nimport { nowIso } from \"../shared/time.js\";\nimport type { ItemDocument, ItemFrontMatter } from \"../../types/index.js\";\n\nexport const SEARCH_CACHE_ARTIFACT_PATHS = [\"index/manifest.json\", \"search/embeddings.jsonl\"] as const;\nexport const VECTORIZATION_STATUS_LEDGER_PATH = \"search/vectorization-status.json\";\n\nexport interface SearchCacheInvalidationResult {\n  invalidated: string[];\n  warnings: string[];\n}\n\nexport interface SemanticMutationRefreshResult {\n  refreshed: string[];\n  skipped: string[];\n  warnings: string[];\n}\n\nexport interface SearchMutationArtifactRefreshResult extends SearchCacheInvalidationResult {\n  refreshed: string[];\n  skipped: string[];\n  /** True when the semantic refresh was dispatched to a detached background worker. */\n  scheduled?: boolean;\n}\n\nexport interface RefreshSearchArtifactsForMutationOptions {\n  /**\n   * When true and semantic search is active, the (slow) embedding refresh is\n   * dispatched to a detached background worker instead of awaited inline so the\n   * mutation returns immediately. The synchronous keyword-cache invalidation\n   * still runs first. Callers pass this only outside test runners.\n   */\n  background?: boolean;\n}\n\nexport interface SemanticRefreshOptions {\n  settings?: Awaited<ReturnType<typeof readSettings>>;\n  apply_runtime_defaults?: boolean;\n}\n\nexport interface VectorizationStatusLedgerReadResult {\n  entries: Record<string, string>;\n  embedding: VectorizationEmbeddingMetadata | null;\n  warnings: string[];\n}\n\nfunction formatInvalidationWarning(relativePath: string, error: unknown): string {\n  return `search_cache_invalidation_failed:${relativePath}:${String(error)}`;\n}\n\n\nfunction toUniqueSorted(values: Iterable<string>): string[] {\n  return [...new Set([...values].map((value) => value.trim()).filter((value) => value.length > 0))]\n    .sort((left, right) => left.localeCompare(right));\n}\n\nfunction isValidUpdatedAt(value: unknown): value is string {\n  return typeof value === \"string\" && value.trim().length > 0 && Number.isFinite(Date.parse(value));\n}\n\nfunction normalizeVectorizationLedgerEntries(entries: Record<string, string>): Record<string, string> {\n  const normalized = new Map<string, string>();\n  for (const [rawId, rawUpdatedAt] of Object.entries(entries)) {\n    const id = rawId.trim();\n    if (id.length === 0 || !isValidUpdatedAt(rawUpdatedAt)) {\n      continue;\n    }\n    normalized.set(id, rawUpdatedAt);\n  }\n  return Object.fromEntries([...normalized.entries()].sort((left, right) => left[0].localeCompare(right[0])));\n}\n\nexport async function readVectorizationStatusLedger(pmRoot: string): Promise<VectorizationStatusLedgerReadResult> {\n  const ledgerPath = path.join(pmRoot, VECTORIZATION_STATUS_LEDGER_PATH);\n  const raw = await readFileIfExists(ledgerPath);\n  if (raw === null || raw.trim().length === 0) {\n    return {\n      entries: {},\n      embedding: null,\n      warnings: [],\n    };\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    return {\n      entries: {},\n      embedding: null,\n      warnings: [\"search_vectorization_status_ledger_invalid\"],\n    };\n  }\n\n  if (\n    typeof parsed !== \"object\" ||\n    parsed === null ||\n    (parsed as { version?: unknown }).version !== 1 ||\n    !Array.isArray((parsed as { items?: unknown }).items)\n  ) {\n    return {\n      entries: {},\n      embedding: null,\n      warnings: [\"search_vectorization_status_ledger_invalid\"],\n    };\n  }\n\n  const mapped = new Map<string, string>();\n  for (const entry of (parsed as { items: unknown[] }).items) {\n    if (typeof entry !== \"object\" || entry === null) {\n      return {\n        entries: {},\n        embedding: null,\n        warnings: [\"search_vectorization_status_ledger_invalid\"],\n      };\n    }\n    const id = (entry as { id?: unknown }).id;\n    const updatedAt = (entry as { updated_at?: unknown }).updated_at;\n    if (typeof id !== \"string\" || id.trim().length === 0 || !isValidUpdatedAt(updatedAt)) {\n      return {\n        entries: {},\n        embedding: null,\n        warnings: [\"search_vectorization_status_ledger_invalid\"],\n      };\n    }\n    mapped.set(id.trim(), updatedAt);\n  }\n\n  let embedding: VectorizationEmbeddingMetadata | null = null;\n  try {\n    embedding = normalizeVectorizationEmbeddingMetadata((parsed as { embedding?: unknown }).embedding);\n  } catch {\n    return {\n      entries: {},\n      embedding: null,\n      warnings: [\"search_vectorization_status_ledger_invalid\"],\n    };\n  }\n\n  return {\n    entries: Object.fromEntries([...mapped.entries()].sort((left, right) => left[0].localeCompare(right[0]))),\n    embedding,\n    warnings: [],\n  };\n}\n\nexport async function writeVectorizationStatusLedger(\n  pmRoot: string,\n  entries: Record<string, string>,\n  embedding?: VectorizationEmbeddingMetadata | null,\n): Promise<void> {\n  const normalizedEntries = normalizeVectorizationLedgerEntries(entries);\n  const ledgerPath = path.join(pmRoot, VECTORIZATION_STATUS_LEDGER_PATH);\n  const serialized = `${JSON.stringify(\n    {\n      version: 1,\n      generated_at: nowIso(),\n      ...(embedding ? { embedding } : {}),\n      items: Object.entries(normalizedEntries).map(([id, updated_at]) => ({\n        id,\n        updated_at,\n      })),\n    },\n    null,\n    2,\n  )}\\n`;\n  await writeFileAtomic(ledgerPath, serialized);\n}\n\nfunction buildVectorPayload(item: ItemFrontMatter): Record<string, unknown> {\n  return {\n    id: item.id,\n    type: item.type,\n    status: item.status,\n    priority: item.priority,\n    updated_at: item.updated_at,\n  };\n}\n\ninterface SemanticRefreshRuntimeContext {\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  provider: EmbeddingProviderConfig;\n  vectorStore: VectorStoreConfig;\n}\n\ninterface SemanticRefreshWorkload {\n  documents: Array<{ id: string; document: ItemDocument }>;\n  missingIds: string[];\n  skippedIds: string[];\n  warnings: string[];\n}\n\ninterface SemanticRefreshOperationResult {\n  refreshed: string[];\n  skipped: string[];\n  warnings: string[];\n}\n\ninterface SemanticEmbeddingOperationResult {\n  vectors: number[][];\n  vector_dimension: number;\n  warnings: string[];\n}\n\nfunction buildVectorizationIdentityForProvider(provider: EmbeddingProviderConfig): VectorizationEmbeddingIdentity {\n  const identity = buildVectorizationEmbeddingIdentity(provider.name, provider.model);\n  if (!identity) {\n    throw new Error(\"Embedding provider must include a provider name and model\");\n  }\n  return identity;\n}\n\nfunction buildSkippedSemanticRefreshResult(itemIds: string[], warning: string): SemanticMutationRefreshResult {\n  return {\n    refreshed: [],\n    skipped: itemIds,\n    warnings: [warning],\n  };\n}\n\nasync function resolveSemanticRefreshRuntimeContext(\n  pmRoot: string,\n  normalizedItemIds: string[],\n  options: SemanticRefreshOptions,\n): Promise<SemanticRefreshRuntimeContext | SemanticMutationRefreshResult> {\n  if (!options.settings && !(await pathExists(getSettingsPath(pmRoot)))) {\n    return buildSkippedSemanticRefreshResult(normalizedItemIds, \"search_semantic_refresh_skipped:settings_not_initialized\");\n  }\n\n  let settings: Awaited<ReturnType<typeof readSettings>>;\n  try {\n    settings = options.settings ?? (await readSettings(pmRoot));\n  } catch (error: unknown) {\n    return buildSkippedSemanticRefreshResult(\n      normalizedItemIds,\n      `search_semantic_refresh_skipped:settings_read_failed:${toErrorMessage(error)}`,\n    );\n  }\n  const effectiveSettings = options.apply_runtime_defaults\n    ? resolveSettingsWithSemanticRuntimeDefaults(settings).settings\n    : settings;\n\n  const provider = resolveEmbeddingProviders(effectiveSettings).active;\n  if (!provider) {\n    return buildSkippedSemanticRefreshResult(normalizedItemIds, \"search_semantic_refresh_skipped:provider_unconfigured\");\n  }\n  const vectorStore = resolveVectorStores(effectiveSettings).active;\n  if (!vectorStore) {\n    return buildSkippedSemanticRefreshResult(normalizedItemIds, \"search_semantic_refresh_skipped:vector_store_unconfigured\");\n  }\n\n  return {\n    settings: effectiveSettings,\n    provider,\n    vectorStore,\n  };\n}\n\nasync function collectSemanticRefreshWorkload(\n  pmRoot: string,\n  idPrefix: string,\n  preferredFormat: \"toon\" | \"json_markdown\",\n  normalizedItemIds: string[],\n  typeToFolder: Record<string, string>,\n  schema: Awaited<ReturnType<typeof readSettings>>[\"schema\"],\n): Promise<SemanticRefreshWorkload> {\n  const warnings: string[] = [];\n  const skipped = new Set<string>();\n  const missing = new Set<string>();\n  const documents: Array<{ id: string; document: ItemDocument }> = [];\n\n  for (const itemId of normalizedItemIds) {\n    const located = await locateItem(pmRoot, itemId, idPrefix, preferredFormat, typeToFolder);\n    if (!located) {\n      missing.add(itemId);\n      continue;\n    }\n\n    try {\n      const loaded = await readLocatedItem(located, { schema });\n      documents.push({\n        id: loaded.document.metadata.id,\n        document: loaded.document,\n      });\n    } catch (error: unknown) {\n      skipped.add(located.id);\n      warnings.push(`search_semantic_refresh_item_read_failed:${located.id}:${toErrorMessage(error)}`);\n    }\n  }\n\n  documents.sort((left, right) => left.id.localeCompare(right.id));\n  return {\n    documents,\n    missingIds: toUniqueSorted(missing),\n    skippedIds: toUniqueSorted(skipped),\n    warnings,\n  };\n}\n\nasync function embedLocatedSemanticVectors(\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  provider: EmbeddingProviderConfig,\n  documents: Array<{ id: string; document: ItemDocument }>,\n): Promise<SemanticEmbeddingOperationResult> {\n  const corpusInputs = documents.map((entry) =>\n    buildSemanticCorpusInput(entry.document, {\n      providerName: provider.name,\n    }),\n  );\n  const embeddingResult = await executeEmbeddingBatchesWithRetry(provider, settings, corpusInputs);\n  return {\n    vectors: embeddingResult.vectors,\n    vector_dimension: inferConsistentVectorDimension(embeddingResult.vectors, \"Semantic refresh embedding\"),\n    warnings: embeddingResult.warnings,\n  };\n}\n\nasync function upsertLocatedSemanticVectors(\n  vectorStore: VectorStoreConfig,\n  documents: Array<{ id: string; document: ItemDocument }>,\n  vectors: number[][],\n): Promise<SemanticRefreshOperationResult> {\n  await executeVectorUpsert(\n    vectorStore,\n    documents.map((entry, index) => ({\n      id: entry.id,\n      vector: vectors[index],\n      payload: buildVectorPayload(entry.document.metadata),\n    })),\n  );\n  return {\n    refreshed: documents.map((entry) => entry.id),\n    skipped: [],\n    warnings: [],\n  };\n}\n\nasync function resetSemanticVectorStore(\n  vectorStore: VectorStoreConfig,\n  ledgerEntries: Record<string, string>,\n): Promise<SemanticRefreshOperationResult> {\n  try {\n    await executeVectorReset(vectorStore, Object.keys(ledgerEntries));\n    return { refreshed: [], skipped: [], warnings: [] };\n  } catch (error: unknown) {\n    return {\n      refreshed: [],\n      skipped: [],\n      warnings: [`search_semantic_refresh_reset_failed:${toErrorMessage(error)}`],\n    };\n  }\n}\n\nasync function pruneMissingSemanticVectors(\n  vectorStore: VectorStoreConfig,\n  missingIds: string[],\n): Promise<SemanticRefreshOperationResult> {\n  if (missingIds.length === 0) {\n    return { refreshed: [], skipped: [], warnings: [] };\n  }\n  try {\n    await executeVectorDelete(vectorStore, missingIds);\n    return {\n      refreshed: [],\n      skipped: [],\n      warnings: [],\n    };\n  } catch (error: unknown) {\n    return {\n      refreshed: [],\n      skipped: missingIds,\n      warnings: [`search_semantic_refresh_delete_failed:${toErrorMessage(error)}`],\n    };\n  }\n}\n\nexport async function invalidateSearchCacheArtifacts(pmRoot: string): Promise<SearchCacheInvalidationResult> {\n  const invalidated: string[] = [];\n  const warnings: string[] = [];\n\n  for (const relativePath of SEARCH_CACHE_ARTIFACT_PATHS) {\n    const artifactPath = path.join(pmRoot, relativePath);\n    try {\n      if (!(await pathExists(artifactPath))) {\n        continue;\n      }\n      await removeFileIfExists(artifactPath);\n      invalidated.push(relativePath);\n    } catch (error: unknown) {\n      warnings.push(formatInvalidationWarning(relativePath, error));\n    }\n  }\n\n  return {\n    invalidated,\n    warnings,\n  };\n}\n\nexport async function refreshSemanticEmbeddingsForMutatedItems(\n  pmRoot: string,\n  itemIds: string[],\n  options: SemanticRefreshOptions = {},\n): Promise<SemanticMutationRefreshResult> {\n  const normalizedItemIds = toUniqueSorted(itemIds);\n  if (normalizedItemIds.length === 0) {\n    return {\n      refreshed: [],\n      skipped: [],\n      warnings: [],\n    };\n  }\n\n  const runtimeContext = await resolveSemanticRefreshRuntimeContext(pmRoot, normalizedItemIds, options);\n  if (!(\"settings\" in runtimeContext)) {\n    return runtimeContext;\n  }\n  const typeRegistry = resolveItemTypeRegistry(runtimeContext.settings, getActiveExtensionRegistrations());\n  const workload = await collectSemanticRefreshWorkload(\n    pmRoot,\n    runtimeContext.settings.id_prefix,\n    runtimeContext.settings.item_format,\n    normalizedItemIds,\n    typeRegistry.type_to_folder,\n    runtimeContext.settings.schema,\n  );\n  const ledgerRead =\n    workload.documents.length > 0 || workload.missingIds.length > 0\n      ? await readVectorizationStatusLedger(pmRoot)\n      : { entries: {}, embedding: null, warnings: [] };\n  const embeddingIdentity = buildVectorizationIdentityForProvider(runtimeContext.provider);\n  const nextLedgerBaseEntries = ledgerRead.entries;\n  let refreshedResult: SemanticRefreshOperationResult = { refreshed: [], skipped: [], warnings: [] };\n  let nextEmbeddingMetadata = ledgerRead.embedding;\n  if (workload.documents.length > 0) {\n    if (ledgerRead.embedding && hasVectorizationEmbeddingIdentityChanged(ledgerRead.embedding, embeddingIdentity)) {\n      refreshedResult = {\n        refreshed: [],\n        skipped: workload.documents.map((entry) => entry.id),\n        warnings: [\"search_semantic_refresh_requires_reindex:embedding_identity_changed\"],\n      };\n    } else {\n      try {\n        const embedded = await embedLocatedSemanticVectors(\n          runtimeContext.settings,\n          runtimeContext.provider,\n          workload.documents,\n        );\n        if (hasVectorizationVectorDimensionChanged(ledgerRead.embedding, embedded.vector_dimension)) {\n          refreshedResult = {\n            refreshed: [],\n            skipped: workload.documents.map((entry) => entry.id),\n            warnings: [...embedded.warnings, \"search_semantic_refresh_requires_reindex:vector_dimension_changed\"],\n          };\n        } else {\n          nextEmbeddingMetadata = buildVectorizationEmbeddingMetadata(embeddingIdentity, embedded.vector_dimension);\n          const upserted = await upsertLocatedSemanticVectors(runtimeContext.vectorStore, workload.documents, embedded.vectors);\n          refreshedResult = {\n            refreshed: upserted.refreshed,\n            skipped: upserted.skipped,\n            warnings: [...embedded.warnings, ...upserted.warnings],\n          };\n        }\n      } catch (error: unknown) {\n        refreshedResult = {\n          refreshed: [],\n          skipped: workload.documents.map((entry) => entry.id),\n          warnings: [`search_semantic_refresh_failed:${toErrorMessage(error)}`],\n        };\n      }\n    }\n  }\n  const pruneResult = await pruneMissingSemanticVectors(runtimeContext.vectorStore, workload.missingIds);\n  const refreshedIdSet = new Set(refreshedResult.refreshed);\n  const refreshedEntries = Object.fromEntries(\n    workload.documents\n      .filter((entry) => refreshedIdSet.has(entry.id))\n      .map((entry) => [entry.id, entry.document.metadata.updated_at]),\n  );\n  const ledgerWarnings: string[] = [];\n  if (Object.keys(refreshedEntries).length > 0 || workload.missingIds.length > 0) {\n    const nextEntries = {\n      ...nextLedgerBaseEntries,\n      ...normalizeVectorizationLedgerEntries(refreshedEntries),\n    };\n    for (const missingId of workload.missingIds) {\n      delete nextEntries[missingId];\n    }\n    try {\n      await writeVectorizationStatusLedger(pmRoot, nextEntries, nextEmbeddingMetadata);\n    } catch (error: unknown) {\n      ledgerWarnings.push(`search_vectorization_status_ledger_write_failed:${toErrorMessage(error)}`);\n    }\n    ledgerWarnings.push(...ledgerRead.warnings);\n  }\n\n  return {\n    refreshed: toUniqueSorted([...refreshedResult.refreshed, ...pruneResult.refreshed]),\n    skipped: toUniqueSorted([...workload.skippedIds, ...refreshedResult.skipped, ...pruneResult.skipped]),\n    warnings: [...workload.warnings, ...refreshedResult.warnings, ...pruneResult.warnings, ...ledgerWarnings],\n  };\n}\n\n/**\n * Returns true when a semantic embedding refresh would do real work for these\n * settings (an embedding provider AND a vector store both resolve). Used to\n * decide whether a mutation's refresh is worth dispatching to a background\n * worker — when semantic search is not configured the inline path is already a\n * fast no-op and no child is spawned.\n */\nexport function isSemanticRefreshActive(\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  applyRuntimeDefaults: boolean,\n): boolean {\n  const effectiveSettings = applyRuntimeDefaults\n    ? resolveSettingsWithSemanticRuntimeDefaults(settings).settings\n    : settings;\n  return Boolean(resolveEmbeddingProviders(effectiveSettings).active && resolveVectorStores(effectiveSettings).active);\n}\n\nexport async function refreshSearchArtifactsForMutation(\n  pmRoot: string,\n  itemIds: string[],\n  options: RefreshSearchArtifactsForMutationOptions = {},\n): Promise<SearchMutationArtifactRefreshResult> {\n  const invalidation = await invalidateSearchCacheArtifacts(pmRoot);\n  const normalizedItemIds = toUniqueSorted(itemIds);\n  if (normalizedItemIds.length === 0) {\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: [],\n      warnings: invalidation.warnings,\n    };\n  }\n\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    const semanticRefresh = await refreshSemanticEmbeddingsForMutatedItems(pmRoot, normalizedItemIds);\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: semanticRefresh.refreshed,\n      skipped: semanticRefresh.skipped,\n      warnings: [...invalidation.warnings, ...semanticRefresh.warnings],\n    };\n  }\n\n  let settings: Awaited<ReturnType<typeof readSettings>>;\n  try {\n    settings = await readSettings(pmRoot);\n  } catch (error: unknown) {\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: normalizedItemIds,\n      warnings: [\n        ...invalidation.warnings,\n        `search_semantic_refresh_skipped:settings_read_failed:${toErrorMessage(error)}`,\n      ],\n    };\n  }\n\n  if (settings.search.mutation_refresh_policy === \"cache_only\") {\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: normalizedItemIds,\n      warnings: invalidation.warnings,\n    };\n  }\n\n  const applyRuntimeDefaults = settings.search.mutation_refresh_policy === \"semantic_auto\";\n\n  // Keyword cache is already invalidated synchronously above (so keyword search\n  // stays immediately correct). When requested, dispatch the slow embedding\n  // refresh to a detached worker so the mutation returns instantly; the\n  // vector_index_stale health/search warning covers the catch-up window.\n  if (options.background && isSemanticRefreshActive(settings, applyRuntimeDefaults)) {\n    await scheduleBackgroundSemanticRefresh(pmRoot, normalizedItemIds);\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: [],\n      warnings: [...invalidation.warnings, \"search_semantic_refresh_scheduled_background\"],\n      scheduled: true,\n    };\n  }\n\n  const semanticRefresh = await refreshSemanticEmbeddingsForMutatedItems(pmRoot, normalizedItemIds, {\n    settings,\n    apply_runtime_defaults: applyRuntimeDefaults,\n  });\n  return {\n    invalidated: invalidation.invalidated,\n    refreshed: semanticRefresh.refreshed,\n    skipped: semanticRefresh.skipped,\n    warnings: [...invalidation.warnings, ...semanticRefresh.warnings],\n  };\n}\n"],"names":[],"mappings":";;AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtG,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,gCAAgC,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,0CAA0C,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEvH,OAAO,EACL,mCAAmC,EACnC,mCAAmC,EACnC,wCAAwC,EACxC,sCAAsC,EACtC,8BAA8B,EAC9B,uCAAuC,GACxC,MAAM,6BAA6B,CAAC;AAKrC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,qBAAqB,EAAE,yBAAyB,CAAU,CAAC;AACvG,MAAM,CAAC,MAAM,gCAAgC,GAAG,kCAAkC,CAAC;AAyCnF,SAAS,yBAAyB,CAAC,YAAoB,EAAE,KAAc;IACrE,OAAO,oCAAoC,YAAY,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC7E,CAAC;AAGD,SAAS,cAAc,CAAC,MAAwB;IAC9C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;SAC9F,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,SAAS,mCAAmC,CAAC,OAA+B;IAC1E,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE,CAAC;YACvD,SAAS;QACX,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,MAAc;IAChE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC/C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO;YACL,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,CAAC,4CAA4C,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACd,MAAgC,CAAC,OAAO,KAAK,CAAC;QAC/C,CAAC,KAAK,CAAC,OAAO,CAAE,MAA8B,CAAC,KAAK,CAAC,EACrD,CAAC;QACD,OAAO;YACL,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,CAAC,4CAA4C,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,KAAK,IAAK,MAA+B,CAAC,KAAK,EAAE,CAAC;QAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAChD,OAAO;gBACL,OAAO,EAAE,EAAE;gBACX,SAAS,EAAE,IAAI;gBACf,QAAQ,EAAE,CAAC,4CAA4C,CAAC;aACzD,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,GAAI,KAA0B,CAAC,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAI,KAAkC,CAAC,UAAU,CAAC;QACjE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;YACrF,OAAO;gBACL,OAAO,EAAE,EAAE;gBACX,SAAS,EAAE,IAAI;gBACf,QAAQ,EAAE,CAAC,4CAA4C,CAAC;aACzD,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,SAAS,GAA0C,IAAI,CAAC;IAC5D,IAAI,CAAC;QACH,SAAS,GAAG,uCAAuC,CAAE,MAAkC,CAAC,SAAS,CAAC,CAAC;IACrG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,CAAC,4CAA4C,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzG,SAAS;QACT,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,MAAc,EACd,OAA+B,EAC/B,SAAiD;IAEjD,MAAM,iBAAiB,GAAG,mCAAmC,CAAC,OAAO,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,SAAS,CAClC;QACE,OAAO,EAAE,CAAC;QACV,YAAY,EAAE,MAAM,EAAE;QACtB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;YAClE,EAAE;YACF,UAAU;SACX,CAAC,CAAC;KACJ,EACD,IAAI,EACJ,CAAC,CACF,IAAI,CAAC;IACN,MAAM,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAqB;IAC/C,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AA2BD,SAAS,qCAAqC,CAAC,QAAiC;IAC9E,MAAM,QAAQ,GAAG,mCAAmC,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,iCAAiC,CAAC,OAAiB,EAAE,OAAe;IAC3E,OAAO;QACL,SAAS,EAAE,EAAE;QACb,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,oCAAoC,CACjD,MAAc,EACd,iBAA2B,EAC3B,OAA+B;IAE/B,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO,iCAAiC,CAAC,iBAAiB,EAAE,0DAA0D,CAAC,CAAC;IAC1H,CAAC;IAED,IAAI,QAAkD,CAAC;IACvD,IAAI,CAAC;QACH,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,iCAAiC,CACtC,iBAAiB,EACjB,wDAAwD,cAAc,CAAC,KAAK,CAAC,EAAE,CAChF,CAAC;IACJ,CAAC;IACD,MAAM,iBAAiB,GAAG,OAAO,CAAC,sBAAsB;QACtD,CAAC,CAAC,0CAA0C,CAAC,QAAQ,CAAC,CAAC,QAAQ;QAC/D,CAAC,CAAC,QAAQ,CAAC;IAEb,MAAM,QAAQ,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC;IACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,iCAAiC,CAAC,iBAAiB,EAAE,uDAAuD,CAAC,CAAC;IACvH,CAAC;IACD,MAAM,WAAW,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC;IAClE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,iCAAiC,CAAC,iBAAiB,EAAE,2DAA2D,CAAC,CAAC;IAC3H,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,iBAAiB;QAC3B,QAAQ;QACR,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,8BAA8B,CAC3C,MAAc,EACd,QAAgB,EAChB,eAAyC,EACzC,iBAA2B,EAC3B,YAAoC,EACpC,MAA0D;IAE1D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,SAAS,GAAkD,EAAE,CAAC;IAEpE,KAAK,MAAM,MAAM,IAAI,iBAAiB,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC;QAC1F,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1D,SAAS,CAAC,IAAI,CAAC;gBACb,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;gBAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,4CAA4C,OAAO,CAAC,EAAE,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnG,CAAC;IACH,CAAC;IAED,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACjE,OAAO;QACL,SAAS;QACT,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC;QACnC,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC;QACnC,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,2BAA2B,CACxC,QAAkD,EAClD,QAAiC,EACjC,SAAwD;IAExD,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC3C,wBAAwB,CAAC,KAAK,CAAC,QAAQ,EAAE;QACvC,YAAY,EAAE,QAAQ,CAAC,IAAI;KAC5B,CAAC,CACH,CAAC;IACF,MAAM,eAAe,GAAG,MAAM,gCAAgC,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IACjG,OAAO;QACL,OAAO,EAAE,eAAe,CAAC,OAAO;QAChC,gBAAgB,EAAE,8BAA8B,CAAC,eAAe,CAAC,OAAO,EAAE,4BAA4B,CAAC;QACvG,QAAQ,EAAE,eAAe,CAAC,QAAQ;KACnC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,4BAA4B,CACzC,WAA8B,EAC9B,SAAwD,EACxD,OAAmB;IAEnB,MAAM,mBAAmB,CACvB,WAAW,EACX,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC/B,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC;QACtB,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;KACrD,CAAC,CAAC,CACJ,CAAC;IACF,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,WAA8B,EAC9B,aAAqC;IAErC,IAAI,CAAC;QACH,MAAM,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QAClE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACtD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO;YACL,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,CAAC,wCAAwC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;SAC5E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,2BAA2B,CACxC,WAA8B,EAC9B,UAAoB;IAEpB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACtD,CAAC;IACD,IAAI,CAAC;QACH,MAAM,mBAAmB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACnD,OAAO;YACL,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO;YACL,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,UAAU;YACnB,QAAQ,EAAE,CAAC,yCAAyC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;SAC7E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,MAAc;IACjE,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,YAAY,IAAI,2BAA2B,EAAE,CAAC;QACvD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;gBACtC,SAAS;YACX,CAAC;YACD,MAAM,kBAAkB,CAAC,YAAY,CAAC,CAAC;YACvC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,yBAAyB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW;QACX,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wCAAwC,CAC5D,MAAc,EACd,OAAiB,EACjB,UAAkC,EAAE;IAEpC,MAAM,iBAAiB,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,oCAAoC,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;IACtG,IAAI,CAAC,CAAC,UAAU,IAAI,cAAc,CAAC,EAAE,CAAC;QACpC,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,MAAM,YAAY,GAAG,uBAAuB,CAAC,cAAc,CAAC,QAAQ,EAAE,+BAA+B,EAAE,CAAC,CAAC;IACzG,MAAM,QAAQ,GAAG,MAAM,8BAA8B,CACnD,MAAM,EACN,cAAc,CAAC,QAAQ,CAAC,SAAS,EACjC,cAAc,CAAC,QAAQ,CAAC,WAAW,EACnC,iBAAiB,EACjB,YAAY,CAAC,cAAc,EAC3B,cAAc,CAAC,QAAQ,CAAC,MAAM,CAC/B,CAAC;IACF,MAAM,UAAU,GACd,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;QAC7D,CAAC,CAAC,MAAM,6BAA6B,CAAC,MAAM,CAAC;QAC7C,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACrD,MAAM,iBAAiB,GAAG,qCAAqC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzF,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,CAAC;IACjD,IAAI,eAAe,GAAmC,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACnG,IAAI,qBAAqB,GAAG,UAAU,CAAC,SAAS,CAAC;IACjD,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,IAAI,UAAU,CAAC,SAAS,IAAI,wCAAwC,CAAC,UAAU,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,CAAC;YAC9G,eAAe,GAAG;gBAChB,SAAS,EAAE,EAAE;gBACb,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpD,QAAQ,EAAE,CAAC,qEAAqE,CAAC;aAClF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAChD,cAAc,CAAC,QAAQ,EACvB,cAAc,CAAC,QAAQ,EACvB,QAAQ,CAAC,SAAS,CACnB,CAAC;gBACF,IAAI,sCAAsC,CAAC,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBAC5F,eAAe,GAAG;wBAChB,SAAS,EAAE,EAAE;wBACb,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;wBACpD,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,mEAAmE,CAAC;qBACtG,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,qBAAqB,GAAG,mCAAmC,CAAC,iBAAiB,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;oBAC1G,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;oBACtH,eAAe,GAAG;wBAChB,SAAS,EAAE,QAAQ,CAAC,SAAS;wBAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO;wBACzB,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC;qBACvD,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,eAAe,GAAG;oBAChB,SAAS,EAAE,EAAE;oBACb,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;oBACpD,QAAQ,EAAE,CAAC,kCAAkC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;iBACtE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,2BAA2B,CAAC,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IACvG,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,CACzC,QAAQ,CAAC,SAAS;SACf,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;SAC/C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAClE,CAAC;IACF,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/E,MAAM,WAAW,GAAG;YAClB,GAAG,qBAAqB;YACxB,GAAG,mCAAmC,CAAC,gBAAgB,CAAC;SACzD,CAAC;QACF,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC5C,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,CAAC;YACH,MAAM,8BAA8B,CAAC,MAAM,EAAE,WAAW,EAAE,qBAAqB,CAAC,CAAC;QACnF,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,cAAc,CAAC,IAAI,CAAC,mDAAmD,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClG,CAAC;QACD,cAAc,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,SAAS,EAAE,cAAc,CAAC,CAAC,GAAG,eAAe,CAAC,SAAS,EAAE,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACnF,OAAO,EAAE,cAAc,CAAC,CAAC,GAAG,QAAQ,CAAC,UAAU,EAAE,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACrG,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,eAAe,CAAC,QAAQ,EAAE,GAAG,WAAW,CAAC,QAAQ,EAAE,GAAG,cAAc,CAAC;KAC1G,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAkD,EAClD,oBAA6B;IAE7B,MAAM,iBAAiB,GAAG,oBAAoB;QAC5C,CAAC,CAAC,0CAA0C,CAAC,QAAQ,CAAC,CAAC,QAAQ;QAC/D,CAAC,CAAC,QAAQ,CAAC;IACb,OAAO,OAAO,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,CAAC,MAAM,IAAI,mBAAmB,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,MAAc,EACd,OAAiB,EACjB,UAAoD,EAAE;IAEtD,MAAM,YAAY,GAAG,MAAM,8BAA8B,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,iBAAiB,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,YAAY,CAAC,QAAQ;SAChC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,eAAe,GAAG,MAAM,wCAAwC,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAClG,OAAO;YACL,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,SAAS,EAAE,eAAe,CAAC,SAAS;YACpC,OAAO,EAAE,eAAe,CAAC,OAAO;YAChC,QAAQ,EAAE,CAAC,GAAG,YAAY,CAAC,QAAQ,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC;SAClE,CAAC;IACJ,CAAC;IAED,IAAI,QAAkD,CAAC;IACvD,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO;YACL,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE;gBACR,GAAG,YAAY,CAAC,QAAQ;gBACxB,wDAAwD,cAAc,CAAC,KAAK,CAAC,EAAE;aAChF;SACF,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,CAAC,uBAAuB,KAAK,YAAY,EAAE,CAAC;QAC7D,OAAO;YACL,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE,YAAY,CAAC,QAAQ;SAChC,CAAC;IACJ,CAAC;IAED,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAAC,uBAAuB,KAAK,eAAe,CAAC;IAEzF,8EAA8E;IAC9E,0EAA0E;IAC1E,sEAAsE;IACtE,uEAAuE;IACvE,IAAI,OAAO,CAAC,UAAU,IAAI,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,CAAC,EAAE,CAAC;QAClF,MAAM,iCAAiC,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QACnE,OAAO;YACL,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,CAAC,GAAG,YAAY,CAAC,QAAQ,EAAE,8CAA8C,CAAC;YACpF,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,wCAAwC,CAAC,MAAM,EAAE,iBAAiB,EAAE;QAChG,QAAQ;QACR,sBAAsB,EAAE,oBAAoB;KAC7C,CAAC,CAAC;IACH,OAAO;QACL,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,SAAS,EAAE,eAAe,CAAC,SAAS;QACpC,OAAO,EAAE,eAAe,CAAC,OAAO;QAChC,QAAQ,EAAE,CAAC,GAAG,YAAY,CAAC,QAAQ,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC;KAClE,CAAC;AACJ,CAAC","debugId":"5d698c95-b557-5c29-bc3f-caf70b5d6d0f"}

package/dist/core/search/http-client.d.ts

@@ -7,7 +7,7 @@ export interface SearchHttpResponse {
     text(): Promise<string>;
 }
 export interface SearchHttpRequestInit {
-    method: "POST";
+    method: "DELETE" | "POST" | "PUT";
     headers: Record<string, string>;
     body: string;
     signal: AbortSignal;
@@ -15,7 +15,7 @@ export interface SearchHttpRequestInit {
 export type SearchHttpFetcher<ResponseType extends SearchHttpResponse = SearchHttpResponse> = (url: string, init: SearchHttpRequestInit) => Promise<ResponseType>;
 export interface ExecuteSearchJsonRequestOptions<ResponseType extends SearchHttpResponse = SearchHttpResponse> {
     endpoint: string;
-    method: "POST";
+    method: "DELETE" | "POST" | "PUT";
     headers: Record<string, string>;
     body: Record<string, unknown>;
     timeoutMs: number;

package/dist/core/search/http-client.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="38ceb1f2-1c32-5e61-9982-cac553c770f4")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="197ad05c-3904-5eed-8de9-def28a40c3f4")}catch(e){}}();
 import { toErrorMessage } from "../shared/primitives.js";
 export const DEFAULT_SEARCH_HTTP_TIMEOUT_MS = 30_000;
 export function normalizeSearchHttpTimeoutMs(timeoutMs, requestLabel, defaultTimeoutMs = DEFAULT_SEARCH_HTTP_TIMEOUT_MS) {
@@ -64,4 +64,4 @@ export async function executeSearchJsonRequest(options) {
     }
 }
 //# sourceMappingURL=http-client.js.map
-//# debugId=38ceb1f2-1c32-5e61-9982-cac553c770f4
+//# debugId=197ad05c-3904-5eed-8de9-def28a40c3f4

package/dist/core/search/http-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.js","sources":["core/search/http-client.ts"],"sourceRoot":"/","sourcesContent":["import { toErrorMessage } from \"../shared/primitives.js\";\n\nexport const DEFAULT_SEARCH_HTTP_TIMEOUT_MS = 30_000;\n\nexport interface SearchHttpResponse {\n  ok: boolean;\n  status: number;\n  statusText: string;\n  json(): Promise<unknown>;\n  text(): Promise<string>;\n}\n\nexport interface SearchHttpRequestInit {\n  method: \"POST\";\n  headers: Record<string, string>;\n  body: string;\n  signal: AbortSignal;\n}\n\nexport type SearchHttpFetcher<ResponseType extends SearchHttpResponse = SearchHttpResponse> = (\n  url: string,\n  init: SearchHttpRequestInit,\n) => Promise<ResponseType>;\n\nexport interface ExecuteSearchJsonRequestOptions<ResponseType extends SearchHttpResponse = SearchHttpResponse> {\n  endpoint: string;\n  method: \"POST\";\n  headers: Record<string, string>;\n  body: Record<string, unknown>;\n  timeoutMs: number;\n  fetcher: SearchHttpFetcher<ResponseType>;\n  requestLabel: string;\n  responseLabel: string;\n}\n\nexport function normalizeSearchHttpTimeoutMs(\n  timeoutMs: number | undefined,\n  requestLabel: string,\n  defaultTimeoutMs = DEFAULT_SEARCH_HTTP_TIMEOUT_MS,\n): number {\n  const resolved = timeoutMs ?? defaultTimeoutMs;\n  if (!Number.isFinite(resolved) || resolved <= 0) {\n    throw new Error(`${requestLabel} timeout must be a positive finite number`);\n  }\n  return Math.floor(resolved);\n}\n\nexport function resolveSearchHttpFetcher<ResponseType extends SearchHttpResponse>(\n  fetcher: SearchHttpFetcher<ResponseType> | undefined,\n  requestLabel: string,\n): SearchHttpFetcher<ResponseType> {\n  if (fetcher) {\n    return fetcher;\n  }\n  if (typeof globalThis.fetch === \"function\") {\n    return globalThis.fetch.bind(globalThis) as unknown as SearchHttpFetcher<ResponseType>;\n  }\n  throw new Error(`${requestLabel} execution requires a fetch implementation`);\n}\n\nexport async function readFailedSearchHttpResponseBody(response: SearchHttpResponse): Promise<string> {\n  try {\n    return (await response.text()).replaceAll(/\\s+/g, \" \").trim();\n  } catch (error) {\n    return `(failed to read response body: ${toErrorMessage(error)})`;\n  }\n}\n\nexport async function executeSearchJsonRequest<ResponseType extends SearchHttpResponse>(\n  options: ExecuteSearchJsonRequestOptions<ResponseType>,\n): Promise<unknown> {\n  const controller = new AbortController();\n  const timeoutHandle = setTimeout(() => {\n    controller.abort();\n  }, options.timeoutMs);\n\n  try {\n    let response: ResponseType;\n    try {\n      response = await options.fetcher(options.endpoint, {\n        method: options.method,\n        headers: options.headers,\n        body: JSON.stringify(options.body),\n        signal: controller.signal,\n      });\n    } catch (error) {\n      if (error instanceof Error && error.name === \"AbortError\") {\n        throw new Error(`${options.requestLabel} timed out after ${options.timeoutMs}ms`);\n      }\n      throw new Error(`${options.requestLabel} execution failed: ${toErrorMessage(error)}`);\n    }\n\n    if (!response.ok) {\n      const responseBody = await readFailedSearchHttpResponseBody(response);\n      const detail = responseBody.length > 0 ? `: ${responseBody}` : \"\";\n      throw new Error(`${options.requestLabel} failed with status ${response.status} ${response.statusText}${detail}`);\n    }\n\n    try {\n      return await response.json();\n    } catch (error) {\n      throw new Error(`${options.responseLabel} JSON parse failed: ${toErrorMessage(error)}`);\n    }\n  } finally {\n    clearTimeout(timeoutHandle);\n  }\n}\n"],"names":[],"mappings":"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","debugId":"38ceb1f2-1c32-5e61-9982-cac553c770f4"}
+{"version":3,"file":"http-client.js","sources":["core/search/http-client.ts"],"sourceRoot":"/","sourcesContent":["import { toErrorMessage } from \"../shared/primitives.js\";\n\nexport const DEFAULT_SEARCH_HTTP_TIMEOUT_MS = 30_000;\n\nexport interface SearchHttpResponse {\n  ok: boolean;\n  status: number;\n  statusText: string;\n  json(): Promise<unknown>;\n  text(): Promise<string>;\n}\n\nexport interface SearchHttpRequestInit {\n  method: \"DELETE\" | \"POST\" | \"PUT\";\n  headers: Record<string, string>;\n  body: string;\n  signal: AbortSignal;\n}\n\nexport type SearchHttpFetcher<ResponseType extends SearchHttpResponse = SearchHttpResponse> = (\n  url: string,\n  init: SearchHttpRequestInit,\n) => Promise<ResponseType>;\n\nexport interface ExecuteSearchJsonRequestOptions<ResponseType extends SearchHttpResponse = SearchHttpResponse> {\n  endpoint: string;\n  method: \"DELETE\" | \"POST\" | \"PUT\";\n  headers: Record<string, string>;\n  body: Record<string, unknown>;\n  timeoutMs: number;\n  fetcher: SearchHttpFetcher<ResponseType>;\n  requestLabel: string;\n  responseLabel: string;\n}\n\nexport function normalizeSearchHttpTimeoutMs(\n  timeoutMs: number | undefined,\n  requestLabel: string,\n  defaultTimeoutMs = DEFAULT_SEARCH_HTTP_TIMEOUT_MS,\n): number {\n  const resolved = timeoutMs ?? defaultTimeoutMs;\n  if (!Number.isFinite(resolved) || resolved <= 0) {\n    throw new Error(`${requestLabel} timeout must be a positive finite number`);\n  }\n  return Math.floor(resolved);\n}\n\nexport function resolveSearchHttpFetcher<ResponseType extends SearchHttpResponse>(\n  fetcher: SearchHttpFetcher<ResponseType> | undefined,\n  requestLabel: string,\n): SearchHttpFetcher<ResponseType> {\n  if (fetcher) {\n    return fetcher;\n  }\n  if (typeof globalThis.fetch === \"function\") {\n    return globalThis.fetch.bind(globalThis) as unknown as SearchHttpFetcher<ResponseType>;\n  }\n  throw new Error(`${requestLabel} execution requires a fetch implementation`);\n}\n\nexport async function readFailedSearchHttpResponseBody(response: SearchHttpResponse): Promise<string> {\n  try {\n    return (await response.text()).replaceAll(/\\s+/g, \" \").trim();\n  } catch (error) {\n    return `(failed to read response body: ${toErrorMessage(error)})`;\n  }\n}\n\nexport async function executeSearchJsonRequest<ResponseType extends SearchHttpResponse>(\n  options: ExecuteSearchJsonRequestOptions<ResponseType>,\n): Promise<unknown> {\n  const controller = new AbortController();\n  const timeoutHandle = setTimeout(() => {\n    controller.abort();\n  }, options.timeoutMs);\n\n  try {\n    let response: ResponseType;\n    try {\n      response = await options.fetcher(options.endpoint, {\n        method: options.method,\n        headers: options.headers,\n        body: JSON.stringify(options.body),\n        signal: controller.signal,\n      });\n    } catch (error) {\n      if (error instanceof Error && error.name === \"AbortError\") {\n        throw new Error(`${options.requestLabel} timed out after ${options.timeoutMs}ms`);\n      }\n      throw new Error(`${options.requestLabel} execution failed: ${toErrorMessage(error)}`);\n    }\n\n    if (!response.ok) {\n      const responseBody = await readFailedSearchHttpResponseBody(response);\n      const detail = responseBody.length > 0 ? `: ${responseBody}` : \"\";\n      throw new Error(`${options.requestLabel} failed with status ${response.status} ${response.statusText}${detail}`);\n    }\n\n    try {\n      return await response.json();\n    } catch (error) {\n      throw new Error(`${options.responseLabel} JSON parse failed: ${toErrorMessage(error)}`);\n    }\n  } finally {\n    clearTimeout(timeoutHandle);\n  }\n}\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAiCrD,MAAM,UAAU,4BAA4B,CAC1C,SAA6B,EAC7B,YAAoB,EACpB,gBAAgB,GAAG,8BAA8B;IAEjD,MAAM,QAAQ,GAAG,SAAS,IAAI,gBAAgB,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,2CAA2C,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAAoD,EACpD,YAAoB;IAEpB,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC3C,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAA+C,CAAC;IACzF,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,4CAA4C,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gCAAgC,CAAC,QAA4B;IACjF,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,kCAAkC,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC;IACpE,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAsD;IAEtD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;QACpC,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtB,IAAI,CAAC;QACH,IAAI,QAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE;gBACjD,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;gBAClC,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,YAAY,oBAAoB,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;YACpF,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,YAAY,sBAAsB,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,YAAY,GAAG,MAAM,gCAAgC,CAAC,QAAQ,CAAC,CAAC;YACtE,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,YAAY,uBAAuB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC,CAAC;QACnH,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,aAAa,uBAAuB,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC","debugId":"197ad05c-3904-5eed-8de9-def28a40c3f4"}

package/dist/core/search/vector-stores.d.ts

@@ -77,4 +77,5 @@ export declare function buildVectorDeletePlan(store: VectorStoreConfig, ids: str
 export declare function executeVectorQuery(store: VectorStoreConfig, vector: number[], limit: number, options?: ExecuteVectorRequestOptions): Promise<VectorQueryHit[]>;
 export declare function executeVectorUpsert(store: VectorStoreConfig, records: VectorRecord[], options?: ExecuteVectorRequestOptions): Promise<VectorUpsertResult>;
 export declare function executeVectorDelete(store: VectorStoreConfig, ids: string[], options?: ExecuteVectorRequestOptions): Promise<VectorUpsertResult>;
+export declare function executeVectorReset(store: VectorStoreConfig, knownIds?: string[], options?: ExecuteVectorRequestOptions, vectorDimension?: number): Promise<VectorUpsertResult>;
 export {};