mnemocyte 0.3.0 → 0.5.0

package/dist/store-config-BFFTm1sj.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-config-BFFTm1sj.mjs","names":[],"sources":["../src/database-url.ts","../src/context/formatter.ts","../src/context/tokens.ts","../src/context/builder.ts","../src/observability.ts","../src/resilience.ts","../src/memory/json.ts","../src/memory/records.ts","../src/retrieval/scorer.ts","../src/memory/defaults.ts","../src/memory/embeddings.ts","../src/memory/store.ts","../src/memory/validation.ts","../src/memory/client-core.ts","../src/memory/deletion.ts","../src/memory/store-config.ts"],"sourcesContent":["import { MnemocyteError } from \"./errors.js\";\n\nexport function parsePostgresDatabaseUrl(databaseUrl: string): URL {\n\tlet url: URL;\n\ttry {\n\t\turl = new URL(databaseUrl);\n\t} catch (error) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"databaseUrl must be a valid Postgres connection URL.\",\n\t\t\t\"CONFIG\",\n\t\t\terror,\n\t\t);\n\t}\n\tif (url.protocol !== \"postgres:\" && url.protocol !== \"postgresql:\") {\n\t\tthrow new MnemocyteError(\n\t\t\t\"databaseUrl must use the postgres: or postgresql: protocol.\",\n\t\t\t\"CONFIG\",\n\t\t);\n\t}\n\treturn url;\n}\n","import type { ContextFormat, MemoryWithScore } from \"../types.js\";\n\nfunction escapeXml(value: string): string {\n\treturn value\n\t\t.replaceAll(\"&\", \"&amp;\")\n\t\t.replaceAll(\"<\", \"&lt;\")\n\t\t.replaceAll(\">\", \"&gt;\")\n\t\t.replaceAll('\"', \"&quot;\")\n\t\t.replaceAll(\"'\", \"&apos;\");\n}\n\nfunction formatMetadata(memory: MemoryWithScore): string {\n\tconst parts = [\n\t\t`type=${memory.type}`,\n\t\t`importance=${memory.importance}`,\n\t\t`score=${memory.score.toFixed(3)}`,\n\t];\n\tif (memory.source) {\n\t\tparts.push(`source=${memory.source}`);\n\t}\n\tif (memory.tags.length > 0) {\n\t\tparts.push(`tags=${memory.tags.join(\",\")}`);\n\t}\n\treturn parts.join(\"; \");\n}\n\nfunction markdownFence(value: string): string {\n\tconst longestBacktickRun = Math.max(\n\t\t0,\n\t\t...Array.from(value.matchAll(/`+/g), (match) => match[0].length),\n\t);\n\treturn \"`\".repeat(Math.max(3, longestBacktickRun + 1));\n}\n\nfunction plainFence(values: readonly string[]): string {\n\tconst longestEqualsRun = Math.max(\n\t\t0,\n\t\t...values.flatMap((value) =>\n\t\t\tArray.from(value.matchAll(/=+/g), (match) => match[0].length),\n\t\t),\n\t);\n\treturn \"=\".repeat(Math.max(8, longestEqualsRun + 1));\n}\n\nfunction formatMarkdown(\n\tmemories: readonly MemoryWithScore[],\n\tquery: string,\n\tomittedCount: number,\n): string {\n\tconst lines = [\n\t\t\"# Memory Context\",\n\t\t\"\",\n\t\t`Query: ${query}`,\n\t\t\"\",\n\t\t\"## Relevant Memories\",\n\t];\n\tfor (const memory of memories) {\n\t\tconst fence = markdownFence(memory.content);\n\t\tlines.push(\n\t\t\t\"\",\n\t\t\t`- ${formatMetadata(memory)}`,\n\t\t\t`  ${fence}text`,\n\t\t\t...memory.content.split(\"\\n\").map((line) => `  ${line}`),\n\t\t\t`  ${fence}`,\n\t\t);\n\t}\n\tif (omittedCount > 0) {\n\t\tlines.push(\"\", `[${omittedCount} memories omitted to fit token budget]`);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\nfunction formatPlain(\n\tmemories: readonly MemoryWithScore[],\n\tquery: string,\n\tomittedCount: number,\n): string {\n\tconst formattedMemories = memories.map((memory) => ({\n\t\tmemory,\n\t\tmetadata: formatMetadata(memory),\n\t}));\n\tconst fence = plainFence([\n\t\tquery,\n\t\t...formattedMemories.flatMap(({ memory, metadata }) => [\n\t\t\tmetadata,\n\t\t\tmemory.content,\n\t\t]),\n\t]);\n\tconst lines = [\n\t\t\"MEMORY CONTEXT\",\n\t\t\"\",\n\t\t`QUERY: ${query}`,\n\t\t\"\",\n\t\t\"RELEVANT MEMORIES\",\n\t];\n\tfor (const [index, { memory, metadata }] of formattedMemories.entries()) {\n\t\tlines.push(\n\t\t\t\"\",\n\t\t\t`${fence} MEMORY ${index + 1} START ${fence}`,\n\t\t\tmetadata,\n\t\t\tmemory.content,\n\t\t\t`${fence} MEMORY ${index + 1} END ${fence}`,\n\t\t);\n\t}\n\tif (omittedCount > 0) {\n\t\tlines.push(\"\", `[${omittedCount} memories omitted to fit token budget]`);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\nfunction formatXml(\n\tmemories: readonly MemoryWithScore[],\n\tquery: string,\n\tomittedCount: number,\n): string {\n\tconst lines = [`<memory_context query=\"${escapeXml(query)}\">`];\n\tfor (const memory of memories) {\n\t\tlines.push(\n\t\t\t`  <memory id=\"${escapeXml(memory.id)}\" type=\"${escapeXml(memory.type)}\" importance=\"${escapeXml(memory.importance)}\" score=\"${memory.score.toFixed(3)}\">`,\n\t\t\t`    <content>${escapeXml(memory.content)}</content>`,\n\t\t\t`    <metadata>${escapeXml(formatMetadata(memory))}</metadata>`,\n\t\t\t\"  </memory>\",\n\t\t);\n\t}\n\tif (omittedCount > 0) {\n\t\tlines.push(`  <omitted count=\"${omittedCount}\" reason=\"token_budget\" />`);\n\t}\n\tlines.push(\"</memory_context>\");\n\treturn lines.join(\"\\n\");\n}\n\nexport function formatContext(\n\tmemories: readonly MemoryWithScore[],\n\tquery: string,\n\tformat: ContextFormat,\n\tomittedCount = 0,\n): string {\n\tswitch (format) {\n\t\tcase \"markdown\":\n\t\t\treturn formatMarkdown(memories, query, omittedCount);\n\t\tcase \"plain\":\n\t\t\treturn formatPlain(memories, query, omittedCount);\n\t\tcase \"xml\":\n\t\t\treturn formatXml(memories, query, omittedCount);\n\t}\n}\n","import type { TokenCounter } from \"../types.js\";\n\nconst TRUNCATION_MARKER = \"[truncated to fit token budget]\";\n\nexport const heuristicTokenCounter: TokenCounter = {\n\tcount(text) {\n\t\treturn Math.ceil(text.length / 4);\n\t},\n};\n\nexport function trimToTokenBudget(\n\ttext: string,\n\tmaxTokens: number,\n\ttokenCounter: TokenCounter,\n): string {\n\tif (maxTokens < 1 || tokenCounter.count(text) <= maxTokens) {\n\t\treturn text;\n\t}\n\tlet low = 0;\n\tlet high = text.length;\n\tlet best = \"\";\n\twhile (low <= high) {\n\t\tconst mid = Math.floor((low + high) / 2);\n\t\tconst candidate = text.slice(0, mid).trimEnd();\n\t\tconst output = `${candidate}\\n${TRUNCATION_MARKER}`;\n\t\tif (tokenCounter.count(output) <= maxTokens) {\n\t\t\tbest = output;\n\t\t\tlow = mid + 1;\n\t\t} else {\n\t\t\thigh = mid - 1;\n\t\t}\n\t}\n\tif (best) {\n\t\treturn best;\n\t}\n\tfor (let length = TRUNCATION_MARKER.length; length > 0; length -= 1) {\n\t\tconst markerFragment = TRUNCATION_MARKER.slice(0, length);\n\t\tif (tokenCounter.count(markerFragment) <= maxTokens) {\n\t\t\treturn markerFragment;\n\t\t}\n\t}\n\treturn \"\";\n}\n","import type { BuildContextInput, MemoryWithScore } from \"../types.js\";\nimport { formatContext } from \"./formatter.js\";\nimport { heuristicTokenCounter, trimToTokenBudget } from \"./tokens.js\";\n\nexport interface BuildContextOptions {\n\tinput: BuildContextInput;\n\trecall(input: BuildContextInput): Promise<MemoryWithScore[]>;\n}\n\nexport async function buildContext(\n\toptions: BuildContextOptions,\n): Promise<string> {\n\tconst format = options.input.format ?? \"markdown\";\n\tconst maxTokens = options.input.maxTokens ?? 1200;\n\tconst tokenCounter = options.input.tokenCounter ?? heuristicTokenCounter;\n\tconst memories = await options.recall(options.input);\n\tlet low = 0;\n\tlet high = memories.length;\n\tlet bestContext = \"\";\n\twhile (low <= high) {\n\t\tconst mid = Math.floor((low + high) / 2);\n\t\tconst omittedCount = memories.length - mid;\n\t\tconst context = formatContext(\n\t\t\tmemories.slice(0, mid),\n\t\t\toptions.input.query,\n\t\t\tformat,\n\t\t\tomittedCount,\n\t\t);\n\t\tif (tokenCounter.count(context) <= maxTokens) {\n\t\t\tbestContext = context;\n\t\t\tlow = mid + 1;\n\t\t} else {\n\t\t\thigh = mid - 1;\n\t\t}\n\t}\n\tif (bestContext || memories.length === 0) {\n\t\treturn bestContext;\n\t}\n\treturn trimToTokenBudget(\n\t\tformatContext([], options.input.query, format, memories.length),\n\t\tmaxTokens,\n\t\ttokenCounter,\n\t);\n}\n","import type {\n\tMnemocyteBackend,\n\tMnemocyteConfig,\n\tMnemocyteObservation,\n\tMnemocyteOperation,\n} from \"./types.js\";\n\ninterface ObservationMetadata {\n\tentityId?: string;\n\tmemoryId?: string;\n\tcount?: number;\n}\n\nfunction withMetadata(\n\tevent: MnemocyteObservation,\n\tmetadata: ObservationMetadata,\n): MnemocyteObservation {\n\treturn {\n\t\t...event,\n\t\t...(metadata.entityId === undefined ? {} : { entityId: metadata.entityId }),\n\t\t...(metadata.memoryId === undefined ? {} : { memoryId: metadata.memoryId }),\n\t\t...(metadata.count === undefined ? {} : { count: metadata.count }),\n\t};\n}\n\nasync function emitObservation(\n\tconfig: MnemocyteConfig,\n\tevent: MnemocyteObservation,\n): Promise<void> {\n\ttry {\n\t\tawait config.observability?.onEvent?.(event);\n\t} catch {\n\t\treturn;\n\t}\n}\n\nasync function observeFromStartedAt<T>(\n\tconfig: MnemocyteConfig,\n\tbackend: MnemocyteBackend,\n\toperation: MnemocyteOperation,\n\tmetadata: ObservationMetadata,\n\tstartedAt: number,\n\taction: () => Promise<T>,\n\tsuccessMetadata?: (result: T) => ObservationMetadata,\n): Promise<T> {\n\tawait emitObservation(\n\t\tconfig,\n\t\twithMetadata(\n\t\t\t{\n\t\t\t\toperation,\n\t\t\t\tphase: \"start\",\n\t\t\t\tbackend,\n\t\t\t\ttimestamp: new Date(startedAt),\n\t\t\t},\n\t\t\tmetadata,\n\t\t),\n\t);\n\ttry {\n\t\tconst result = await action();\n\t\tawait emitObservation(\n\t\t\tconfig,\n\t\t\twithMetadata(\n\t\t\t\t{\n\t\t\t\t\toperation,\n\t\t\t\t\tphase: \"success\",\n\t\t\t\t\tbackend,\n\t\t\t\t\ttimestamp: new Date(),\n\t\t\t\t\tdurationMs: Date.now() - startedAt,\n\t\t\t\t},\n\t\t\t\t{ ...metadata, ...successMetadata?.(result) },\n\t\t\t),\n\t\t);\n\t\treturn result;\n\t} catch (error) {\n\t\tawait emitObservation(\n\t\t\tconfig,\n\t\t\twithMetadata(\n\t\t\t\t{\n\t\t\t\t\toperation,\n\t\t\t\t\tphase: \"error\",\n\t\t\t\t\tbackend,\n\t\t\t\t\ttimestamp: new Date(),\n\t\t\t\t\tdurationMs: Date.now() - startedAt,\n\t\t\t\t\terror,\n\t\t\t\t},\n\t\t\t\tmetadata,\n\t\t\t),\n\t\t);\n\t\tthrow error;\n\t}\n}\n\nexport function observe<T>(\n\tconfig: MnemocyteConfig,\n\tbackend: MnemocyteBackend,\n\toperation: MnemocyteOperation,\n\tmetadata: ObservationMetadata,\n\taction: () => Promise<T>,\n\tsuccessMetadata?: (result: T) => ObservationMetadata,\n): Promise<T> {\n\treturn observeFromStartedAt(\n\t\tconfig,\n\t\tbackend,\n\t\toperation,\n\t\tmetadata,\n\t\tDate.now(),\n\t\taction,\n\t\tsuccessMetadata,\n\t);\n}\n\nexport function observePrepared<Prepared, Result>(\n\tconfig: MnemocyteConfig,\n\tbackend: MnemocyteBackend,\n\toperation: MnemocyteOperation,\n\tmetadata: ObservationMetadata,\n\tprepare: () => Prepared,\n\taction: (prepared: Prepared) => Promise<Result>,\n\tsuccessMetadata?: (result: Result) => ObservationMetadata,\n): Promise<Result> {\n\tconst startedAt = Date.now();\n\ttry {\n\t\tconst prepared = prepare();\n\t\treturn observeFromStartedAt(\n\t\t\tconfig,\n\t\t\tbackend,\n\t\t\toperation,\n\t\t\tmetadata,\n\t\t\tstartedAt,\n\t\t\t() => action(prepared),\n\t\t\tsuccessMetadata,\n\t\t);\n\t} catch (error) {\n\t\treturn observeFromStartedAt(\n\t\t\tconfig,\n\t\t\tbackend,\n\t\t\toperation,\n\t\t\tmetadata,\n\t\t\tstartedAt,\n\t\t\tasync () => {\n\t\t\t\tthrow error;\n\t\t\t},\n\t\t);\n\t}\n}\n","import { MnemocyteError } from \"./errors.js\";\nimport type { ProviderResilienceConfig } from \"./types.js\";\n\n/**\n * Default per-provider-call timeout. Disabled by default so that callers\n * who do not configure {@link ProviderResilienceConfig.timeoutMs} are\n * unaffected.\n */\nconst DEFAULT_TIMEOUT_MS = 0;\n/** Default number of retry attempts on transient provider failures. */\nconst DEFAULT_RETRIES = 0;\n/** Default base backoff delay used between retry attempts. */\nconst DEFAULT_BASE_DELAY_MS = 100;\n/** Default ceiling for retry backoff delay. */\nconst DEFAULT_MAX_DELAY_MS = 2000;\n\n/**\n * Throw a {@link MnemocyteError} with code `\"ABORTED\"` if `signal` is\n * already aborted. Safe to call with `undefined`.\n */\nexport function throwIfAborted(signal: AbortSignal | undefined): void {\n\tif (signal?.aborted) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"Operation was aborted.\",\n\t\t\t\"ABORTED\",\n\t\t\tsignal.reason,\n\t\t);\n\t}\n}\n\n/**\n * Heuristic default for whether an error should be retried.\n *\n * Conservative by design: only retries on common transient failure\n * indicators (network errors, 5xx-ish messages, `ECONN*` etc.). Never\n * retries on validation, configuration, or {@link MnemocyteError} of\n * code `\"VALIDATION\"` / `\"CONFIG\"` / `\"CONFLICT\"` / `\"ABORTED\"`.\n */\nexport function defaultShouldRetry(error: unknown): boolean {\n\tif (error instanceof MnemocyteError) {\n\t\tif (\n\t\t\terror.code === \"VALIDATION\" ||\n\t\t\terror.code === \"CONFIG\" ||\n\t\t\terror.code === \"CONFLICT\" ||\n\t\t\terror.code === \"ABORTED\"\n\t\t) {\n\t\t\treturn false;\n\t\t}\n\t\treturn true;\n\t}\n\tif (\n\t\ttypeof error === \"object\" &&\n\t\terror !== null &&\n\t\t\"status\" in error &&\n\t\ttypeof (error as { status?: unknown }).status === \"number\" &&\n\t\t[429, 500, 502, 503, 504].includes((error as { status: number }).status)\n\t) {\n\t\treturn true;\n\t}\n\tif (error instanceof Error) {\n\t\tconst message = error.message.toLowerCase();\n\t\tif (\n\t\t\tmessage.includes(\"econn\") ||\n\t\t\tmessage.includes(\"etimedout\") ||\n\t\t\tmessage.includes(\"network\") ||\n\t\t\tmessage.includes(\"timeout\") ||\n\t\t\tmessage.includes(\"temporarily\") ||\n\t\t\tmessage.includes(\"rate limit\") ||\n\t\t\tmessage.includes(\"503\") ||\n\t\t\tmessage.includes(\"502\") ||\n\t\t\tmessage.includes(\"504\") ||\n\t\t\tmessage.includes(\"500\")\n\t\t) {\n\t\t\treturn true;\n\t\t}\n\t}\n\treturn false;\n}\n\n/**\n * Compute the backoff delay for the given retry attempt, using exponential\n * growth capped at {@link ProviderResilienceConfig.maxDelayMs}.\n *\n * `attempt` is 1-indexed: the delay before the first retry uses\n * `attempt = 1`, before the second retry `attempt = 2`, etc.\n */\nfunction computeDelayMs(\n\tattempt: number,\n\tbaseDelayMs: number,\n\tmaxDelayMs: number,\n): number {\n\tconst exponential = baseDelayMs * 2 ** (attempt - 1);\n\treturn Math.max(0, Math.min(maxDelayMs, exponential));\n}\n\n/**\n * Promise-based `setTimeout` that rejects with an `\"ABORTED\"`\n * {@link MnemocyteError} if `signal` aborts while waiting.\n */\nfunction delay(ms: number, signal: AbortSignal | undefined): Promise<void> {\n\tif (ms <= 0) {\n\t\tthrowIfAborted(signal);\n\t\treturn Promise.resolve();\n\t}\n\treturn new Promise<void>((resolve, reject) => {\n\t\tconst timer = setTimeout(() => {\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\tresolve();\n\t\t}, ms);\n\t\tconst onAbort = (): void => {\n\t\t\tclearTimeout(timer);\n\t\t\treject(\n\t\t\t\tnew MnemocyteError(\"Operation was aborted.\", \"ABORTED\", signal?.reason),\n\t\t\t);\n\t\t};\n\t\tif (signal) {\n\t\t\tif (signal.aborted) {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\treject(\n\t\t\t\t\tnew MnemocyteError(\n\t\t\t\t\t\t\"Operation was aborted.\",\n\t\t\t\t\t\t\"ABORTED\",\n\t\t\t\t\t\tsignal.reason,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tsignal.addEventListener(\"abort\", onAbort, { once: true });\n\t\t}\n\t});\n}\n\nfunction timeoutError(timeoutMs: number): MnemocyteError {\n\treturn new MnemocyteError(\n\t\t`Provider call timed out after ${timeoutMs}ms.`,\n\t\t\"TIMEOUT\",\n\t);\n}\n\n/**\n * Run one provider attempt with a signal linked to the caller's signal and\n * Mnemocyte's configured timeout. Timeout aborts are actively propagated to\n * providers that honor `AbortSignal`.\n */\nfunction runAttempt<T>(\n\taction: (signal: AbortSignal | undefined) => Promise<T>,\n\ttimeoutMs: number,\n\tsignal: AbortSignal | undefined,\n): Promise<T> {\n\tif (timeoutMs <= 0 && !signal) {\n\t\treturn action(undefined);\n\t}\n\treturn new Promise<T>((resolve, reject) => {\n\t\tlet settled = false;\n\t\tconst controller = new AbortController();\n\t\tconst timer =\n\t\t\ttimeoutMs > 0\n\t\t\t\t? setTimeout(() => {\n\t\t\t\t\t\tif (settled) {\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tsettled = true;\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\t\tcontroller.abort(timeoutError(timeoutMs));\n\t\t\t\t\t\treject(timeoutError(timeoutMs));\n\t\t\t\t\t}, timeoutMs)\n\t\t\t\t: undefined;\n\t\tconst onAbort = (): void => {\n\t\t\tif (settled) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tsettled = true;\n\t\t\tif (timer) {\n\t\t\t\tclearTimeout(timer);\n\t\t\t}\n\t\t\tcontroller.abort(signal?.reason);\n\t\t\treject(\n\t\t\t\tnew MnemocyteError(\"Operation was aborted.\", \"ABORTED\", signal?.reason),\n\t\t\t);\n\t\t};\n\t\tif (signal) {\n\t\t\tif (signal.aborted) {\n\t\t\t\tif (timer) {\n\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t}\n\t\t\t\tsettled = true;\n\t\t\t\tcontroller.abort(signal.reason);\n\t\t\t\treject(\n\t\t\t\t\tnew MnemocyteError(\n\t\t\t\t\t\t\"Operation was aborted.\",\n\t\t\t\t\t\t\"ABORTED\",\n\t\t\t\t\t\tsignal.reason,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tsignal.addEventListener(\"abort\", onAbort, { once: true });\n\t\t}\n\t\taction(controller.signal).then(\n\t\t\t(value) => {\n\t\t\t\tif (settled) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tsettled = true;\n\t\t\t\tif (timer) {\n\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t}\n\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\tresolve(value);\n\t\t\t},\n\t\t\t(error) => {\n\t\t\t\tif (settled) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tsettled = true;\n\t\t\t\tif (timer) {\n\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t}\n\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\treject(error);\n\t\t\t},\n\t\t);\n\t});\n}\n\n/**\n * Options accepted by {@link withResilience}.\n */\nexport interface ResilienceCallOptions {\n\t/** External cancellation signal forwarded to each attempt. */\n\tsignal?: AbortSignal;\n\t/** Provider-level retry/timeout configuration. */\n\tresilience?: ProviderResilienceConfig;\n}\n\n/**\n * Run `action` with timeout, retry, and abort handling derived from\n * `options.resilience` and `options.signal`. Each retry attempt receives\n * a fresh `AbortSignal` linked to the caller's signal — so callers may\n * abort mid-retry and the in-flight attempt will cancel promptly if the\n * underlying provider honours signals.\n *\n * Errors from {@link MnemocyteError} with code `\"VALIDATION\"` /\n * `\"CONFIG\"` / `\"CONFLICT\"` / `\"ABORTED\"` are never retried.\n */\nexport async function withResilience<T>(\n\taction: (signal: AbortSignal | undefined) => Promise<T>,\n\toptions: ResilienceCallOptions = {},\n): Promise<T> {\n\tconst config = options.resilience ?? {};\n\tconst timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n\tconst retries = Math.max(0, config.retries ?? DEFAULT_RETRIES);\n\tconst baseDelayMs = Math.max(0, config.baseDelayMs ?? DEFAULT_BASE_DELAY_MS);\n\tconst maxDelayMs = Math.max(\n\t\tbaseDelayMs,\n\t\tconfig.maxDelayMs ?? DEFAULT_MAX_DELAY_MS,\n\t);\n\tconst shouldRetry = config.shouldRetry ?? defaultShouldRetry;\n\tconst externalSignal = options.signal;\n\n\tthrowIfAborted(externalSignal);\n\n\tconst maxAttempts = retries + 1;\n\tlet lastError: unknown;\n\tfor (let attempt = 1; attempt <= maxAttempts; attempt += 1) {\n\t\tthrowIfAborted(externalSignal);\n\t\ttry {\n\t\t\treturn await runAttempt(action, timeoutMs, externalSignal);\n\t\t} catch (error) {\n\t\t\tlastError = error;\n\t\t\tif (error instanceof MnemocyteError && error.code === \"ABORTED\") {\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tif (attempt >= maxAttempts) {\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tif (!shouldRetry(error, attempt)) {\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tconst waitMs = computeDelayMs(attempt, baseDelayMs, maxDelayMs);\n\t\t\tawait delay(waitMs, externalSignal);\n\t\t}\n\t}\n\tthrow lastError;\n}\n","import { MnemocyteError } from \"../errors.js\";\nimport type { JsonObject, JsonValue } from \"../types.js\";\n\ndeclare const ownedJsonObject: unique symbol;\n\n/** Internal marker for a JSON object that Mnemocyte has validated and cloned. */\nexport type OwnedJsonObject = JsonObject & {\n\treadonly [ownedJsonObject]: true;\n};\n\nfunction invalidJsonValue(path: string, cause?: unknown): MnemocyteError {\n\treturn new MnemocyteError(\n\t\t`${path} must contain only JSON-compatible value data.`,\n\t\t\"VALIDATION\",\n\t\tcause,\n\t);\n}\n\nfunction cloneJsonValue(\n\tvalue: unknown,\n\tpath: string,\n\tancestors: Set<object>,\n): JsonValue {\n\tif (\n\t\tvalue === null ||\n\t\ttypeof value === \"string\" ||\n\t\ttypeof value === \"boolean\"\n\t) {\n\t\treturn value;\n\t}\n\tif (typeof value === \"number\") {\n\t\tif (!Number.isFinite(value)) {\n\t\t\tthrow invalidJsonValue(path);\n\t\t}\n\t\treturn Object.is(value, -0) ? 0 : value;\n\t}\n\tif (typeof value !== \"object\") {\n\t\tthrow invalidJsonValue(path);\n\t}\n\tif (ancestors.has(value)) {\n\t\tthrow invalidJsonValue(path);\n\t}\n\n\tancestors.add(value);\n\ttry {\n\t\tif (Array.isArray(value)) {\n\t\t\tif (\n\t\t\t\tObject.getOwnPropertySymbols(value).length > 0 ||\n\t\t\t\tObject.keys(value).some((key) => !/^(0|[1-9]\\d*)$/.test(key))\n\t\t\t) {\n\t\t\t\tthrow invalidJsonValue(path);\n\t\t\t}\n\t\t\treturn Array.from({ length: value.length }, (_, index) => {\n\t\t\t\tif (!Object.hasOwn(value, index)) {\n\t\t\t\t\tthrow invalidJsonValue(`${path}[${index}]`);\n\t\t\t\t}\n\t\t\t\treturn cloneJsonValue(value[index], `${path}[${index}]`, ancestors);\n\t\t\t});\n\t\t}\n\n\t\tconst prototype = Object.getPrototypeOf(value);\n\t\tif (prototype !== Object.prototype && prototype !== null) {\n\t\t\tthrow invalidJsonValue(path);\n\t\t}\n\t\tconst descriptors = Object.getOwnPropertyDescriptors(value);\n\t\tconst entries: Array<[string, JsonValue]> = [];\n\t\tfor (const key of Reflect.ownKeys(descriptors)) {\n\t\t\tif (typeof key !== \"string\") {\n\t\t\t\tthrow invalidJsonValue(path);\n\t\t\t}\n\t\t\tconst descriptor = descriptors[key];\n\t\t\tif (\n\t\t\t\tdescriptor === undefined ||\n\t\t\t\tdescriptor.enumerable !== true ||\n\t\t\t\t!(\"value\" in descriptor)\n\t\t\t) {\n\t\t\t\tthrow invalidJsonValue(`${path}.${key}`);\n\t\t\t}\n\t\t\tentries.push([\n\t\t\t\tkey,\n\t\t\t\tcloneJsonValue(descriptor.value, `${path}.${key}`, ancestors),\n\t\t\t]);\n\t\t}\n\t\treturn Object.fromEntries(entries);\n\t} finally {\n\t\tancestors.delete(value);\n\t}\n}\n\n/** Validate and deep-clone a JSON-compatible object. */\nexport function cloneJsonObject(\n\tvalue: unknown,\n\tpath = \"metadata\",\n): OwnedJsonObject {\n\ttry {\n\t\tif (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n\t\t\tthrow invalidJsonValue(path);\n\t\t}\n\t\treturn cloneJsonValue(value, path, new Set()) as OwnedJsonObject;\n\t} catch (error) {\n\t\tif (error instanceof MnemocyteError) {\n\t\t\tthrow error;\n\t\t}\n\t\tthrow invalidJsonValue(path, error);\n\t}\n}\n","import type { Memory } from \"../types.js\";\nimport { cloneJsonObject } from \"./json.js\";\n\nexport interface StoredMemory extends Memory {\n\tembedding: number[];\n}\n\nexport function normalizeTags(tags: readonly string[] | undefined): string[] {\n\tif (!tags) {\n\t\treturn [];\n\t}\n\treturn [...new Set(tags.map((tag) => tag.trim()).filter(Boolean))];\n}\n\nexport function createId(): string {\n\treturn `mem_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\n/** Generate a unique audit-event id (`evt_*`). */\nexport function createEventId(): string {\n\treturn `evt_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport function cloneMemory(memory: Memory): Memory {\n\treturn {\n\t\tid: memory.id,\n\t\tentityId: memory.entityId,\n\t\tcontent: memory.content,\n\t\ttype: memory.type,\n\t\timportance: memory.importance,\n\t\ttags: [...memory.tags],\n\t\tsource: memory.source,\n\t\tmetadata: cloneJsonObject(memory.metadata),\n\t\tconfidence: memory.confidence,\n\t\tembeddingModel: memory.embeddingModel,\n\t\tembeddingDimensions: memory.embeddingDimensions,\n\t\tsupersededBy: memory.supersededBy,\n\t\tsupersededAt: memory.supersededAt ? new Date(memory.supersededAt) : null,\n\t\texpiresAt: memory.expiresAt ? new Date(memory.expiresAt) : null,\n\t\tlastAccessedAt: memory.lastAccessedAt\n\t\t\t? new Date(memory.lastAccessedAt)\n\t\t\t: null,\n\t\taccessCount: memory.accessCount,\n\t\tcreatedAt: new Date(memory.createdAt),\n\t\tupdatedAt: new Date(memory.updatedAt),\n\t};\n}\n","import { cloneMemory } from \"../memory/records.js\";\nimport type {\n\tImportanceLevel,\n\tMemory,\n\tMemoryWithScore,\n\tRecallInput,\n\tRetrievalConfig,\n\tRetrievalScoreWeights,\n} from \"../types.js\";\n\nconst IMPORTANCE_SCORES: Record<ImportanceLevel, number> = {\n\tlow: 0,\n\tnormal: 0.5,\n\thigh: 0.8,\n\tcritical: 1,\n};\n\nexport const DEFAULT_RETRIEVAL_WEIGHTS: Readonly<\n\tRequired<RetrievalScoreWeights>\n> = {\n\tvector: 0.55,\n\tlexical: 0.2,\n\trecency: 0.1,\n\tconfidence: 0.05,\n\taccess: 0.05,\n\timportance: 0.05,\n};\n\nconst DEFAULT_RECENCY_HALF_LIFE_DAYS = 90;\nconst DEFAULT_ACCESS_SATURATION = 10;\nexport const DEFAULT_CANDIDATE_MULTIPLIER = 3;\n\nexport interface ScoringConfig {\n\tweights: Required<RetrievalScoreWeights>;\n\trecencyHalfLifeDays: number;\n\taccessSaturation: number;\n}\n\nexport function cosineSimilarity(\n\ta: readonly number[],\n\tb: readonly number[],\n): number {\n\tlet dot = 0;\n\tlet aMagnitude = 0;\n\tlet bMagnitude = 0;\n\tfor (let i = 0; i < a.length; i += 1) {\n\t\tconst av = a[i] ?? 0;\n\t\tconst bv = b[i] ?? 0;\n\t\tdot += av * bv;\n\t\taMagnitude += av * av;\n\t\tbMagnitude += bv * bv;\n\t}\n\tif (aMagnitude === 0 || bMagnitude === 0) {\n\t\treturn 0;\n\t}\n\treturn dot / (Math.sqrt(aMagnitude) * Math.sqrt(bMagnitude));\n}\n\nexport function tokenizeQuery(query: string): readonly string[] {\n\treturn query.toLowerCase().split(/\\s+/).filter(Boolean);\n}\n\nexport function lexicalScoreWithTerms(\n\tcontent: string,\n\tterms: readonly string[],\n): number {\n\tif (terms.length === 0) {\n\t\treturn 0;\n\t}\n\tconst lowerContent = content.toLowerCase();\n\tconst matches = terms.filter((term) => lowerContent.includes(term)).length;\n\treturn matches / terms.length;\n}\n\nexport function createLexicalScorer(\n\tquery: string,\n): (content: string) => number {\n\tconst terms = tokenizeQuery(query);\n\treturn (content) => lexicalScoreWithTerms(content, terms);\n}\n\nfunction clampScore(value: number): number {\n\tif (!Number.isFinite(value)) {\n\t\treturn 0;\n\t}\n\treturn Math.max(0, Math.min(1, value));\n}\n\nexport function toVectorScore(cosineSimilarity: number): number {\n\treturn clampScore(cosineSimilarity);\n}\n\nfunction normalizeWeights(\n\tweights: RetrievalScoreWeights | undefined,\n): Required<RetrievalScoreWeights> {\n\tconst merged = { ...DEFAULT_RETRIEVAL_WEIGHTS, ...weights };\n\tconst total =\n\t\tmerged.vector +\n\t\tmerged.lexical +\n\t\tmerged.recency +\n\t\tmerged.confidence +\n\t\tmerged.access +\n\t\tmerged.importance;\n\tif (total <= 0) {\n\t\treturn { ...DEFAULT_RETRIEVAL_WEIGHTS };\n\t}\n\treturn {\n\t\tvector: merged.vector / total,\n\t\tlexical: merged.lexical / total,\n\t\trecency: merged.recency / total,\n\t\tconfidence: merged.confidence / total,\n\t\taccess: merged.access / total,\n\t\timportance: merged.importance / total,\n\t};\n}\n\nexport function createScoringConfig(config?: RetrievalConfig): ScoringConfig {\n\treturn {\n\t\tweights: normalizeWeights(config?.weights),\n\t\trecencyHalfLifeDays:\n\t\t\tconfig?.recencyHalfLifeDays ?? DEFAULT_RECENCY_HALF_LIFE_DAYS,\n\t\taccessSaturation: config?.accessSaturation ?? DEFAULT_ACCESS_SATURATION,\n\t};\n}\n\nfunction recencyScore(createdAt: Date, halfLifeDays: number): number {\n\tconst ageMs = Date.now() - createdAt.getTime();\n\tconst ageDays = Math.max(0, ageMs / 86_400_000);\n\treturn Math.exp((-Math.LN2 * ageDays) / halfLifeDays);\n}\n\nfunction accessScore(accessCount: number, saturation: number): number {\n\tif (accessCount <= 0) {\n\t\treturn 0;\n\t}\n\treturn Math.min(1, Math.log1p(accessCount) / Math.log1p(saturation));\n}\n\nexport function toScoredMemoryWithConfig(\n\tmemory: Memory,\n\tvector: number,\n\tlexical: number,\n\tinput: RecallInput,\n\tconfig: ScoringConfig,\n): MemoryWithScore {\n\tconst { weights } = config;\n\tconst recency = recencyScore(memory.createdAt, config.recencyHalfLifeDays);\n\tconst confidence = clampScore(memory.confidence);\n\tconst access = accessScore(memory.accessCount, config.accessSaturation);\n\tconst importance = IMPORTANCE_SCORES[memory.importance];\n\tconst score = Math.max(\n\t\t0,\n\t\tMath.min(\n\t\t\t1,\n\t\t\tclampScore(vector) * weights.vector +\n\t\t\t\tclampScore(lexical) * weights.lexical +\n\t\t\t\trecency * weights.recency +\n\t\t\t\tconfidence * weights.confidence +\n\t\t\t\taccess * weights.access +\n\t\t\t\timportance * weights.importance,\n\t\t),\n\t);\n\treturn {\n\t\t...cloneMemory(memory),\n\t\tscore,\n\t\tscores: {\n\t\t\tvector: clampScore(vector),\n\t\t\tlexical: clampScore(lexical),\n\t\t\trecency,\n\t\t\tconfidence,\n\t\t\taccess,\n\t\t\timportance,\n\t\t},\n\t\texplanation: input.explain\n\t\t\t? {\n\t\t\t\t\tvectorScore: clampScore(vector),\n\t\t\t\t\tlexicalScore: clampScore(lexical),\n\t\t\t\t\trecencyScore: recency,\n\t\t\t\t\tconfidenceScore: confidence,\n\t\t\t\t\taccessScore: access,\n\t\t\t\t\timportanceScore: importance,\n\t\t\t\t\timportanceBoost: importance * weights.importance,\n\t\t\t\t\tweights,\n\t\t\t\t\tfinalScore: score,\n\t\t\t\t}\n\t\t\t: null,\n\t};\n}\n","import type {\n\tFindDuplicatesInput,\n\tImportanceLevel,\n\tMemoryType,\n} from \"../types.js\";\n\nexport const DEFAULT_LIMIT = 10;\nexport const DEFAULT_MIN_SCORE = 0;\nexport const DEFAULT_TYPE: MemoryType = \"fact\";\nexport const DEFAULT_IMPORTANCE: ImportanceLevel = \"normal\";\n\n/**\n * Ordering of {@link ImportanceLevel} from least to most important. Used\n * by `prune({ maxImportance })` to compare a memory's importance against\n * the caller-supplied ceiling.\n */\nexport const IMPORTANCE_RANK: Record<ImportanceLevel, number> = {\n\tlow: 0,\n\tnormal: 1,\n\thigh: 2,\n\tcritical: 3,\n};\n\n/** Default cosine-similarity threshold for {@link FindDuplicatesInput}. */\nexport const DEFAULT_DUPLICATE_THRESHOLD = 0.95;\n/** Default cap on the number of duplicate pairs returned. */\nexport const DEFAULT_DUPLICATE_LIMIT = 100;\n/** Default cap on audit-log entries returned per `listAuditLog`. */\nexport const DEFAULT_AUDIT_LOG_LIMIT = 50;\n","import { MnemocyteError } from \"../errors.js\";\nimport { withResilience } from \"../resilience.js\";\nimport type { Embedder, ProviderResilienceConfig } from \"../types.js\";\n\nfunction validateEmbedding(\n\tembedding: readonly number[],\n\tdimensions: number,\n): void {\n\tif (embedding.length !== dimensions) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"Embedder returned an embedding with unexpected dimensions.\",\n\t\t\t\"EMBEDDING\",\n\t\t);\n\t}\n\tif (embedding.some((component) => !Number.isFinite(component))) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"Embedder returned an embedding with non-finite values.\",\n\t\t\t\"EMBEDDING\",\n\t\t);\n\t}\n\tif (embedding.every((component) => component === 0)) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"Embedder returned an embedding with zero norm.\",\n\t\t\t\"EMBEDDING\",\n\t\t);\n\t}\n}\n\nexport async function embedOne(\n\tembedder: Embedder,\n\ttext: string,\n\toptions: {\n\t\tsignal?: AbortSignal;\n\t\tresilience?: ProviderResilienceConfig;\n\t} = {},\n): Promise<number[]> {\n\tlet embeddings: number[][];\n\ttry {\n\t\tembeddings = await withResilience(\n\t\t\t(signal) =>\n\t\t\t\tsignal === undefined\n\t\t\t\t\t? embedder.embed([text])\n\t\t\t\t\t: embedder.embed([text], { signal }),\n\t\t\t{\n\t\t\t\t...(options.signal === undefined ? {} : { signal: options.signal }),\n\t\t\t\t...(options.resilience === undefined\n\t\t\t\t\t? {}\n\t\t\t\t\t: { resilience: options.resilience }),\n\t\t\t},\n\t\t);\n\t} catch (error) {\n\t\tif (\n\t\t\terror instanceof MnemocyteError &&\n\t\t\t(error.code === \"TIMEOUT\" || error.code === \"ABORTED\")\n\t\t) {\n\t\t\tthrow error;\n\t\t}\n\t\tthrow new MnemocyteError(\"Failed to embed text.\", \"EMBEDDING\", error);\n\t}\n\tconst embedding = embeddings[0];\n\tif (!embedding) {\n\t\tthrow new MnemocyteError(\"Embedder returned no embedding.\", \"EMBEDDING\");\n\t}\n\tvalidateEmbedding(embedding, embedder.dimensions);\n\treturn embedding;\n}\n\nexport async function embedMany(\n\tembedder: Embedder,\n\ttexts: readonly string[],\n\toptions: {\n\t\tsignal?: AbortSignal;\n\t\tresilience?: ProviderResilienceConfig;\n\t} = {},\n): Promise<number[][]> {\n\tif (texts.length === 0) {\n\t\treturn [];\n\t}\n\tlet embeddings: number[][];\n\ttry {\n\t\tembeddings = await withResilience(\n\t\t\t(signal) =>\n\t\t\t\tsignal === undefined\n\t\t\t\t\t? embedder.embed(texts)\n\t\t\t\t\t: embedder.embed(texts, { signal }),\n\t\t\t{\n\t\t\t\t...(options.signal === undefined ? {} : { signal: options.signal }),\n\t\t\t\t...(options.resilience === undefined\n\t\t\t\t\t? {}\n\t\t\t\t\t: { resilience: options.resilience }),\n\t\t\t},\n\t\t);\n\t} catch (error) {\n\t\tif (\n\t\t\terror instanceof MnemocyteError &&\n\t\t\t(error.code === \"TIMEOUT\" || error.code === \"ABORTED\")\n\t\t) {\n\t\t\tthrow error;\n\t\t}\n\t\tthrow new MnemocyteError(\"Failed to embed texts.\", \"EMBEDDING\", error);\n\t}\n\tif (embeddings.length !== texts.length) {\n\t\tthrow new MnemocyteError(\n\t\t\t`Embedder returned ${embeddings.length} embeddings for ${texts.length} texts.`,\n\t\t\t\"EMBEDDING\",\n\t\t);\n\t}\n\tfor (const embedding of embeddings) {\n\t\tvalidateEmbedding(embedding, embedder.dimensions);\n\t}\n\treturn embeddings;\n}\n","import { MnemocyteError } from \"../errors.js\";\nimport type {\n\tAuditEvent,\n\tEmbedder,\n\tEntityStats,\n\tFindDuplicatesInput,\n\tGlobalStats,\n\tImportanceLevel,\n\tListAuditLogInput,\n\tMemory,\n\tMemoryType,\n\tMnemocyteBackend,\n\tPruneResult,\n\tRecallInput,\n} from \"../types.js\";\nimport type { StoredMemory } from \"./records.js\";\n\nexport interface StoreVectorSearchInput extends Omit<RecallInput, \"minScore\"> {\n\tembedding: readonly number[];\n\tlimit: number;\n\tminVectorScore?: number;\n}\n\nexport interface StoreLexicalSearchInput extends RecallInput {\n\tlimit: number;\n}\n\nexport interface StoreVectorCandidate {\n\tmemory: Memory;\n\t/** Finite cosine component clamped to the inclusive range `[0, 1]`. */\n\tvectorScore: number;\n}\n\nexport interface StoreLexicalCandidate {\n\tmemory: Memory;\n\tlexicalScore: number;\n}\n\nexport interface StoreDuplicatePair {\n\ta: Memory;\n\tb: Memory;\n\tsimilarity: number;\n}\n\nexport interface StoreAccessUpdate {\n\tid: string;\n\tlastAccessedAt: Date;\n\taccessCount: number;\n\tupdatedAt: Date;\n}\n\nexport interface StorePruneEntityDeletion {\n\tentityId: string;\n\tdeletedCount: number;\n}\n\nexport interface StorePruneResult extends PruneResult {\n\tdeletedByEntity: readonly StorePruneEntityDeletion[];\n}\n\nexport interface StoreConsolidationTarget {\n\tid: string;\n\ttags: readonly string[];\n\tsupersededBy: string | null;\n}\n\nexport interface StoreConsolidateInput {\n\tentityId: string;\n\tsurvivorId: string;\n\tsupersededIds: readonly string[];\n\tmergeTags: boolean;\n\tnow: Date;\n\tauditEnabled: boolean;\n}\n\nexport interface StoreConsolidateResult {\n\tsupersededIds: readonly string[];\n}\n\nexport interface StoreOperationOptions {\n\tsignal?: AbortSignal;\n}\n\nexport interface ValidatedPruneFilter {\n\treadonly entityId?: string;\n\treadonly expired?: true;\n\treadonly superseded?: true;\n\treadonly createdBefore?: Date;\n\treadonly notAccessedSince?: Date;\n\treadonly types?: readonly MemoryType[];\n\treadonly tags?: readonly string[];\n\treadonly maxImportance?: ImportanceLevel;\n\treadonly dryRun: boolean;\n}\n\nexport function hasPruneSelector(filter: ValidatedPruneFilter): boolean {\n\treturn (\n\t\tfilter.entityId !== undefined ||\n\t\tfilter.expired === true ||\n\t\tfilter.superseded === true ||\n\t\tfilter.createdBefore !== undefined ||\n\t\tfilter.notAccessedSince !== undefined ||\n\t\t(filter.types !== undefined && filter.types.length > 0) ||\n\t\t(filter.tags !== undefined && filter.tags.length > 0) ||\n\t\tfilter.maxImportance !== undefined\n\t);\n}\n\nexport function assertPruneFilterHasSelector(\n\tfilter: ValidatedPruneFilter,\n): void {\n\tif (!hasPruneSelector(filter)) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"prune requires at least one selector (entityId, expired, superseded, createdBefore, notAccessedSince, types, tags, or maxImportance).\",\n\t\t\t\"VALIDATION\",\n\t\t);\n\t}\n}\n\n/**\n * Internal storage adapter boundary used by the shared client orchestration.\n *\n * This is intentionally not exported from the public package root in 0.3.x.\n * The public adapter surface is reserved for the later `drizzleStore(db)` line.\n *\n * Every method is unconditional. There is intentionally no capability-flag\n * surface, and adapters do not declare capabilities before shared orchestration\n * calls a method.\n *\n * Deleting a referenced consolidation survivor through `deleteMemory`,\n * `deleteMemoriesForEntity`, or a non-dry-run `prune` must reject with\n * `\"CONFLICT\"` before deleting anything. The dependency check and mutation must\n * be one atomic, non-interleavable operation; a check followed by a later write\n * with an interleaving gap does not satisfy the contract.\n *\n * Unless a method documents a stronger boundary, cancellation support and its\n * mechanism are implementation-defined. Adapters may use cooperative checks,\n * active statement cancellation, or no mid-operation cancellation while still\n * honoring the method's documented postconditions.\n */\nexport interface MemoryStore {\n\treadonly backend: MnemocyteBackend;\n\n\t/**\n\t * Completes the adapter's base-schema readiness hook.\n\t *\n\t * The built-in stores currently resolve without work and rely on explicit\n\t * schema management. An implementation may verify externally managed schema\n\t * state here, but this hook does not authorize hidden schema creation or\n\t * migration.\n\t */\n\tensureSchema(): Promise<void>;\n\t/**\n\t * Enforces the embedding compatibility check meaningful to this store's\n\t * persistence model before embedding-dependent work proceeds.\n\t *\n\t * The hook is unconditional and needs no capability flag. A store with no\n\t * persistent installation state may legitimately resolve without work. The\n\t * built-in Postgres store validates installation model and dimensions and may\n\t * reject with `\"MIGRATION\"` or `\"CONFIG\"`; the in-memory store is a no-op.\n\t */\n\tensureEmbeddingCompatibility(embedder: Embedder): Promise<void>;\n\n\t/**\n\t * Takes ownership of freshly prepared rows and returns exactly one detached\n\t * public record for every prepared input ID. Callers must not mutate or reuse\n\t * rows after passing them here.\n\t *\n\t * The store has no return-order obligation. Shared orchestration treats order\n\t * as untrusted, rejects missing or duplicate results and any returned ID\n\t * outside the prepared set, then restores prepared-input order.\n\t */\n\tinsertMemories(memories: readonly StoredMemory[]): Promise<Memory[]>;\n\t/**\n\t * Returns up to `input.limit` detached candidates that satisfy the shared\n\t * recall filters and `minVectorScore`, ordered by decreasing vector\n\t * similarity. Every `vectorScore` is finite and clamped to `[0, 1]`.\n\t *\n\t * An implementation may scan or use an index. When an approximate index is\n\t * available, candidate inclusion, ranking, and performance are index- and\n\t * planner-dependent and are not guaranteed to match an exhaustive scan.\n\t */\n\tvectorSearch(input: StoreVectorSearchInput): Promise<StoreVectorCandidate[]>;\n\t/**\n\t * Returns up to `input.limit` detached candidates that satisfy the shared\n\t * recall filters and have a positive implementation-defined lexical score,\n\t * ordered by decreasing score.\n\t *\n\t * Lexical parsing and relevance scoring are backend-defined. Implementations\n\t * may therefore differ in mechanism, returned candidates, and ranking, not\n\t * only in latency.\n\t */\n\tlexicalSearch(\n\t\tinput: StoreLexicalSearchInput,\n\t): Promise<StoreLexicalCandidate[]>;\n\t/**\n\t * Returns available embeddings for the requested IDs, keyed by memory ID.\n\t * Missing memories and memories without an embedding are omitted. Returned\n\t * vectors are detached from stored state, and input or map iteration order is\n\t * not part of the contract.\n\t */\n\tgetMemoryEmbeddings(\n\t\tmemoryIds: readonly string[],\n\t): Promise<Map<string, number[]>>;\n\t/**\n\t * Increments access state exactly once for each requested stored memory and\n\t * returns one record per ID containing its post-update `accessCount`,\n\t * `lastAccessedAt`, and `updatedAt`. Return order is untrusted and normalized\n\t * by shared orchestration.\n\t *\n\t * The input IDs must be distinct. Duplicate-ID behavior is backend-specific,\n\t * and callers must not rely on any particular deduplication or increment\n\t * behavior when this precondition is violated.\n\t */\n\tmarkMemoriesAccessed(\n\t\tmemoryIds: readonly string[],\n\t): Promise<StoreAccessUpdate[]>;\n\n\t/**\n\t * Deletes the memory only when both entity and memory ID match, returning\n\t * `false` when they do not and `true` after deletion.\n\t *\n\t * If any memory references the target through `supersededBy`, rejects with\n\t * `\"CONFLICT\"` without deleting it. Dependency detection and deletion must be\n\t * atomic and non-interleavable.\n\t */\n\tdeleteMemory(entityId: string, memoryId: string): Promise<boolean>;\n\t/**\n\t * Deletes every memory for the entity and returns the number deleted.\n\t *\n\t * If any memory references a selected target through `supersededBy`, rejects\n\t * the entire operation with `\"CONFLICT\"` before deleting anything, including\n\t * when the dependent is itself selected. Dependency detection and the batch\n\t * deletion must be atomic and non-interleavable.\n\t */\n\tdeleteMemoriesForEntity(entityId: string): Promise<number>;\n\tprune(\n\t\tinput: ValidatedPruneFilter,\n\t\toptions?: StoreOperationOptions,\n\t): Promise<StorePruneResult>;\n\t/**\n\t * Compares qualifying memories pairwise and returns up to the requested limit\n\t * of unordered pairs meeting the similarity threshold, ordered by decreasing\n\t * similarity. Similarities are clamped to `[0, 1]`; pair orientation and\n\t * equal-score order are not guaranteed.\n\t *\n\t * This contract neither implies nor requires indexed nearest-neighbor pair\n\t * generation. A database planner may still use ordinary indexes while\n\t * filtering or executing a pairwise join.\n\t */\n\tfindDuplicatePairs(\n\t\tinput: FindDuplicatesInput,\n\t\toptions?: StoreOperationOptions,\n\t): Promise<StoreDuplicatePair[]>;\n\n\t/**\n\t * Persists independent copies of audit events supplied by shared core.\n\t *\n\t * Ordinary audit writes are best-effort at the shared caller. Rejection does\n\t * not promise batch atomicity: failure behavior is implementation-defined,\n\t * and some stores may retain a partial batch after the promise rejects.\n\t */\n\taddAuditEvents(events: readonly AuditEvent[]): Promise<void>;\n\t/**\n\t * Returns detached events for the requested entity in strict descending\n\t * `(timestamp, id)` order, subject to the requested limit.\n\t *\n\t * Event IDs must be stable and timestamps comparable. Plain `before` and\n\t * `after` values are strict timestamp filters. Composite cursors use strict\n\t * tuple filtering on the same `(timestamp, id)` tuple used for ordering, so\n\t * equal-timestamp events can be paged without requiring a transaction.\n\t * Cancellation may be cooperative or active and is implementation-defined.\n\t */\n\tlistAuditLog(\n\t\tinput: ListAuditLogInput,\n\t\toptions?: StoreOperationOptions,\n\t): Promise<AuditEvent[]>;\n\n\t/**\n\t * Returns a detached memory only when both entity and memory ID match;\n\t * otherwise returns `null`.\n\t */\n\tgetMemory(\n\t\tentityId: string,\n\t\tmemoryId: string,\n\t\toptions?: StoreOperationOptions,\n\t): Promise<Memory | null>;\n\t/** Shared validation supplies distinct IDs before this preflight lookup. */\n\tloadConsolidationTargets(\n\t\tentityId: string,\n\t\tids: readonly string[],\n\t\toptions?: StoreOperationOptions,\n\t): Promise<StoreConsolidationTarget[]>;\n\t/**\n\t * Applies one atomic consolidation after re-reading and protecting the\n\t * survivor and requested losers. Throws `\"CONFLICT\"` before mutation when\n\t * the survivor is missing or superseded, or when any requested loser points\n\t * to a different survivor. Tag merging starts from the protected survivor's\n\t * mutation-time tags.\n\t */\n\tconsolidate(\n\t\tinput: StoreConsolidateInput,\n\t\toptions?: StoreOperationOptions,\n\t): Promise<StoreConsolidateResult>;\n\n\t/**\n\t * Returns entity-scoped or global counts evaluated against the supplied\n\t * `now`. `memoryCount` includes every selected memory; active memories are\n\t * neither expired nor superseded. Expired and superseded counts are\n\t * independent and may overlap. Global `entityCount` counts distinct entities\n\t * across all stored memories, and an empty scope returns zero counts.\n\t */\n\tstats(\n\t\tinput: { entityId?: string } | undefined,\n\t\tnow: Date,\n\t): Promise<EntityStats | GlobalStats>;\n\t/**\n\t * Releases only resources and transient state owned by this store instance.\n\t *\n\t * The in-memory store destroys its owned memory and audit state. The built-in\n\t * Postgres store closes the connection handle it created while leaving\n\t * persisted rows intact. An adapter wrapping a caller-supplied connection must\n\t * not close that connection or any other resource it does not own.\n\t */\n\tclose(): Promise<void>;\n}\n","import { MnemocyteError } from \"../errors.js\";\nimport { DEFAULT_RETRIEVAL_WEIGHTS } from \"../retrieval/scorer.js\";\nimport type {\n\tAuditLogCursor,\n\tBuildContextInput,\n\tConsolidateInput,\n\tEmbedder,\n\tFindDuplicatesInput,\n\tImportanceLevel,\n\tListAuditLogInput,\n\tMemoryType,\n\tProviderResilienceConfig,\n\tPruneInput,\n\tRecallInput,\n\tRememberInput,\n\tRetrievalConfig,\n\tRetrievalScoreWeights,\n} from \"../types.js\";\nimport type { OwnedJsonObject } from \"./json.js\";\nimport {\n\tassertPruneFilterHasSelector,\n\ttype ValidatedPruneFilter,\n} from \"./store.js\";\n\nconst MEMORY_TYPES = [\n\t\"fact\",\n\t\"preference\",\n\t\"instruction\",\n\t\"backstory\",\n\t\"episode\",\n\t\"session\",\n] as const satisfies readonly MemoryType[];\n\nconst IMPORTANCE_LEVELS = [\n\t\"low\",\n\t\"normal\",\n\t\"high\",\n\t\"critical\",\n] as const satisfies readonly ImportanceLevel[];\n\nexport interface PreparedRememberInput extends Omit<RememberInput, \"metadata\"> {\n\tmetadata: OwnedJsonObject;\n}\n\nfunction isMemoryType(value: unknown): value is MemoryType {\n\treturn (\n\t\ttypeof value === \"string\" &&\n\t\t(MEMORY_TYPES as readonly string[]).includes(value)\n\t);\n}\n\nfunction isImportanceLevel(value: unknown): value is ImportanceLevel {\n\treturn (\n\t\ttypeof value === \"string\" &&\n\t\t(IMPORTANCE_LEVELS as readonly string[]).includes(value)\n\t);\n}\n\nfunction assertMemoryType(\n\tvalue: unknown,\n\tfield: string,\n): asserts value is MemoryType {\n\tif (!isMemoryType(value)) {\n\t\tthrow new MnemocyteError(\n\t\t\t`${field} must be a known memory type.`,\n\t\t\t\"VALIDATION\",\n\t\t);\n\t}\n}\n\nfunction assertImportanceLevel(\n\tvalue: unknown,\n\tfield: string,\n): asserts value is ImportanceLevel {\n\tif (!isImportanceLevel(value)) {\n\t\tthrow new MnemocyteError(\n\t\t\t`${field} must be a known importance level.`,\n\t\t\t\"VALIDATION\",\n\t\t);\n\t}\n}\n\nfunction assertMemoryTypeArray(\n\tvalue: unknown,\n\tfield: string,\n): asserts value is readonly MemoryType[] {\n\tif (!Array.isArray(value)) {\n\t\tthrow new MnemocyteError(`${field} must be an array.`, \"VALIDATION\");\n\t}\n\tfor (const item of value) {\n\t\tif (!isMemoryType(item)) {\n\t\t\tthrow new MnemocyteError(\n\t\t\t\t`${field} must contain only known memory types.`,\n\t\t\t\t\"VALIDATION\",\n\t\t\t);\n\t\t}\n\t}\n}\n\nfunction assertValidDate(value: unknown, field: string): asserts value is Date {\n\tif (!(value instanceof Date) || !Number.isFinite(value.getTime())) {\n\t\tthrow new MnemocyteError(`${field} must be a valid Date.`, \"VALIDATION\");\n\t}\n}\n\nexport function assertNonEmptyString(\n\tvalue: unknown,\n\tfield: string,\n\tcode: \"CONFIG\" | \"VALIDATION\" = \"VALIDATION\",\n): asserts value is string {\n\tif (typeof value !== \"string\" || value.trim().length === 0) {\n\t\tthrow new MnemocyteError(`${field} must be a non-empty string.`, code);\n\t}\n}\n\nexport function assertLimit(value: number): void {\n\tif (!Number.isInteger(value) || value < 1) {\n\t\tthrow new MnemocyteError(\"limit must be a positive integer.\", \"VALIDATION\");\n\t}\n}\n\nexport function assertMinScore(value: number): void {\n\tif (!Number.isFinite(value) || value < 0 || value > 1) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"minScore must be a number between 0 and 1.\",\n\t\t\t\"VALIDATION\",\n\t\t);\n\t}\n}\n\nexport function assertEmbedder(embedder: Embedder): void {\n\tif (!embedder || typeof embedder.embed !== \"function\") {\n\t\tthrow new MnemocyteError(\n\t\t\t\"embedder with an embed function is required.\",\n\t\t\t\"CONFIG\",\n\t\t);\n\t}\n\tassertNonEmptyString(embedder.model, \"embedder.model\", \"CONFIG\");\n\tif (!Number.isInteger(embedder.dimensions) || embedder.dimensions < 1) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"embedder.dimensions must be a positive integer.\",\n\t\t\t\"CONFIG\",\n\t\t);\n\t}\n}\n\nconst RETRIEVAL_WEIGHT_KEYS = [\n\t\"vector\",\n\t\"lexical\",\n\t\"recency\",\n\t\"confidence\",\n\t\"access\",\n\t\"importance\",\n] as const satisfies readonly (keyof RetrievalScoreWeights)[];\n\nfunction assertPositiveFiniteConfigValue(value: number, field: string): void {\n\tif (!Number.isFinite(value) || value <= 0) {\n\t\tthrow new MnemocyteError(\n\t\t\t`${field} must be a positive finite number.`,\n\t\t\t\"CONFIG\",\n\t\t);\n\t}\n}\n\nexport function validateRetrievalConfig(\n\tconfig: RetrievalConfig | undefined,\n): void {\n\tif (config === undefined) {\n\t\treturn;\n\t}\n\n\tlet weightTotal = 0;\n\tfor (const key of RETRIEVAL_WEIGHT_KEYS) {\n\t\tconst weight = config.weights?.[key] ?? DEFAULT_RETRIEVAL_WEIGHTS[key];\n\t\tif (!Number.isFinite(weight) || weight < 0) {\n\t\t\tthrow new MnemocyteError(\n\t\t\t\t`retrieval.weights.${key} must be a non-negative finite number.`,\n\t\t\t\t\"CONFIG\",\n\t\t\t);\n\t\t}\n\t\tweightTotal += weight;\n\t}\n\tif (weightTotal === 0) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"retrieval.weights must have an effective total greater than zero.\",\n\t\t\t\"CONFIG\",\n\t\t);\n\t}\n\n\tif (config.recencyHalfLifeDays !== undefined) {\n\t\tassertPositiveFiniteConfigValue(\n\t\t\tconfig.recencyHalfLifeDays,\n\t\t\t\"retrieval.recencyHalfLifeDays\",\n\t\t);\n\t}\n\tif (config.accessSaturation !== undefined) {\n\t\tassertPositiveFiniteConfigValue(\n\t\t\tconfig.accessSaturation,\n\t\t\t\"retrieval.accessSaturation\",\n\t\t);\n\t}\n\tif (\n\t\tconfig.candidateMultiplier !== undefined &&\n\t\t(!Number.isInteger(config.candidateMultiplier) ||\n\t\t\tconfig.candidateMultiplier < 1)\n\t) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"retrieval.candidateMultiplier must be an integer greater than or equal to 1.\",\n\t\t\t\"CONFIG\",\n\t\t);\n\t}\n}\n\nexport function validateProviderResilienceConfig(\n\tconfig: ProviderResilienceConfig | undefined,\n): void {\n\tif (config === undefined) {\n\t\treturn;\n\t}\n\tif (typeof config !== \"object\" || config === null || Array.isArray(config)) {\n\t\tthrow new MnemocyteError(\"provider must be an object.\", \"CONFIG\");\n\t}\n\n\tfor (const [field, value] of [\n\t\t[\"provider.timeoutMs\", config.timeoutMs],\n\t\t[\"provider.baseDelayMs\", config.baseDelayMs],\n\t\t[\"provider.maxDelayMs\", config.maxDelayMs],\n\t] as const) {\n\t\tif (value !== undefined && (!Number.isFinite(value) || value < 0)) {\n\t\t\tthrow new MnemocyteError(\n\t\t\t\t`${field} must be a non-negative finite number.`,\n\t\t\t\t\"CONFIG\",\n\t\t\t);\n\t\t}\n\t}\n\tif (\n\t\tconfig.retries !== undefined &&\n\t\t(!Number.isInteger(config.retries) || config.retries < 0)\n\t) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"provider.retries must be a non-negative integer.\",\n\t\t\t\"CONFIG\",\n\t\t);\n\t}\n\tif (\n\t\tconfig.shouldRetry !== undefined &&\n\t\ttypeof config.shouldRetry !== \"function\"\n\t) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"provider.shouldRetry must be a function.\",\n\t\t\t\"CONFIG\",\n\t\t);\n\t}\n}\n\nexport function validateBuildContextInput(input: BuildContextInput): void {\n\tif (\n\t\tinput.maxTokens !== undefined &&\n\t\t(!Number.isInteger(input.maxTokens) || input.maxTokens < 1)\n\t) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"maxTokens must be a positive integer when supplied.\",\n\t\t\t\"VALIDATION\",\n\t\t);\n\t}\n}\n\nexport function validateRememberInput(input: PreparedRememberInput): void {\n\tassertNonEmptyString(input.entityId, \"entityId\");\n\tassertNonEmptyString(input.content, \"content\");\n\tif (input.type !== undefined) {\n\t\tassertMemoryType(input.type, \"type\");\n\t}\n\tif (input.importance !== undefined) {\n\t\tassertImportanceLevel(input.importance, \"importance\");\n\t}\n\tif (input.tags !== undefined) {\n\t\tif (!Array.isArray(input.tags)) {\n\t\t\tthrow new MnemocyteError(\"tags must be an array.\", \"VALIDATION\");\n\t\t}\n\t\tfor (const tag of input.tags as readonly unknown[]) {\n\t\t\tif (typeof tag !== \"string\") {\n\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\"tags must contain only strings.\",\n\t\t\t\t\t\"VALIDATION\",\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t}\n\tif (input.source !== undefined && typeof input.source !== \"string\") {\n\t\tthrow new MnemocyteError(\"source must be a string.\", \"VALIDATION\");\n\t}\n\tif (\n\t\tinput.confidence !== undefined &&\n\t\t(!Number.isFinite(input.confidence) ||\n\t\t\tinput.confidence < 0 ||\n\t\t\tinput.confidence > 1)\n\t) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"confidence must be a number between 0 and 1.\",\n\t\t\t\"VALIDATION\",\n\t\t);\n\t}\n\tif (input.expiresAt !== undefined) {\n\t\tassertValidDate(input.expiresAt, \"expiresAt\");\n\t}\n}\n\nexport function validateRecallInput(input: RecallInput): void {\n\tassertNonEmptyString(input.entityId, \"entityId\");\n\tassertNonEmptyString(input.query, \"query\");\n\tif (input.limit !== undefined) {\n\t\tassertLimit(input.limit);\n\t}\n\tif (input.minScore !== undefined) {\n\t\tassertMinScore(input.minScore);\n\t}\n\tif (input.types !== undefined) {\n\t\tassertMemoryTypeArray(input.types, \"types\");\n\t}\n}\n\nexport function contextInputToRecallInput(\n\tinput: BuildContextInput,\n): RecallInput {\n\treturn {\n\t\tentityId: input.entityId,\n\t\tquery: input.query,\n\t\t...(input.limit === undefined ? {} : { limit: input.limit }),\n\t\t...(input.minScore === undefined ? {} : { minScore: input.minScore }),\n\t\t...(input.types === undefined ? {} : { types: input.types }),\n\t\t...(input.tags === undefined ? {} : { tags: input.tags }),\n\t\t...(input.includeSuperseded === undefined\n\t\t\t? {}\n\t\t\t: { includeSuperseded: input.includeSuperseded }),\n\t\t...(input.includeExpired === undefined\n\t\t\t? {}\n\t\t\t: { includeExpired: input.includeExpired }),\n\t};\n}\n\n/**\n * Validate and normalize a {@link PruneInput}. Throws a `\"VALIDATION\"`\n * {@link MnemocyteError} for malformed fields or when normalization leaves no\n * effective selector, preventing surprise full-table deletes.\n */\nexport function validatePruneInput(input: PruneInput): ValidatedPruneFilter {\n\tif (input.entityId !== undefined) {\n\t\tassertNonEmptyString(input.entityId, \"entityId\");\n\t}\n\tfor (const [field, value] of [\n\t\t[\"expired\", input.expired],\n\t\t[\"superseded\", input.superseded],\n\t\t[\"dryRun\", input.dryRun],\n\t] as const) {\n\t\tif (value !== undefined && typeof value !== \"boolean\") {\n\t\t\tthrow new MnemocyteError(`${field} must be a boolean.`, \"VALIDATION\");\n\t\t}\n\t}\n\tfor (const [field, value] of [\n\t\t[\"createdBefore\", input.createdBefore],\n\t\t[\"notAccessedSince\", input.notAccessedSince],\n\t] as const) {\n\t\tif (value !== undefined) {\n\t\t\tassertValidDate(value, field);\n\t\t}\n\t}\n\tlet types: readonly MemoryType[] | undefined;\n\tif (input.types !== undefined) {\n\t\tassertMemoryTypeArray(input.types, \"types\");\n\t\tconst normalized = new Set<MemoryType>(input.types);\n\t\tif (normalized.size > 0) {\n\t\t\ttypes = [...normalized];\n\t\t}\n\t}\n\tlet tags: readonly string[] | undefined;\n\tif (input.tags !== undefined) {\n\t\tif (!Array.isArray(input.tags)) {\n\t\t\tthrow new MnemocyteError(\"tags must be an array.\", \"VALIDATION\");\n\t\t}\n\t\tconst normalized = new Set<string>();\n\t\tfor (const value of input.tags as readonly unknown[]) {\n\t\t\tif (typeof value !== \"string\" || value.trim().length === 0) {\n\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\"tags must contain only non-empty strings.\",\n\t\t\t\t\t\"VALIDATION\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tnormalized.add(value.trim());\n\t\t}\n\t\tif (normalized.size > 0) {\n\t\t\ttags = [...normalized];\n\t\t}\n\t}\n\tif (input.maxImportance !== undefined) {\n\t\tassertImportanceLevel(input.maxImportance, \"maxImportance\");\n\t}\n\tif (\n\t\tinput.signal !== undefined &&\n\t\t(typeof input.signal !== \"object\" ||\n\t\t\tinput.signal === null ||\n\t\t\ttypeof input.signal.aborted !== \"boolean\" ||\n\t\t\ttypeof input.signal.addEventListener !== \"function\" ||\n\t\t\ttypeof input.signal.removeEventListener !== \"function\")\n\t) {\n\t\tthrow new MnemocyteError(\"signal must be an AbortSignal.\", \"VALIDATION\");\n\t}\n\tconst filter: ValidatedPruneFilter = {\n\t\t...(input.entityId === undefined ? {} : { entityId: input.entityId }),\n\t\t...(input.expired === true ? { expired: true as const } : {}),\n\t\t...(input.superseded === true ? { superseded: true as const } : {}),\n\t\t...(input.createdBefore === undefined\n\t\t\t? {}\n\t\t\t: { createdBefore: new Date(input.createdBefore) }),\n\t\t...(input.notAccessedSince === undefined\n\t\t\t? {}\n\t\t\t: { notAccessedSince: new Date(input.notAccessedSince) }),\n\t\t...(types === undefined ? {} : { types }),\n\t\t...(tags === undefined ? {} : { tags }),\n\t\t...(input.maxImportance === undefined\n\t\t\t? {}\n\t\t\t: { maxImportance: input.maxImportance }),\n\t\tdryRun: input.dryRun === true,\n\t};\n\tassertPruneFilterHasSelector(filter);\n\treturn filter;\n}\n\n/**\n * Validate a {@link FindDuplicatesInput} and throw a `\"VALIDATION\"`\n * {@link MnemocyteError} for malformed `threshold` / `limit` values.\n */\nexport function validateFindDuplicatesInput(input: FindDuplicatesInput): void {\n\tassertNonEmptyString(input.entityId, \"entityId\");\n\tif (input.threshold !== undefined) {\n\t\tif (\n\t\t\t!Number.isFinite(input.threshold) ||\n\t\t\tinput.threshold < 0 ||\n\t\t\tinput.threshold > 1\n\t\t) {\n\t\t\tthrow new MnemocyteError(\n\t\t\t\t\"threshold must be a number between 0 and 1.\",\n\t\t\t\t\"VALIDATION\",\n\t\t\t);\n\t\t}\n\t}\n\tif (input.limit !== undefined) {\n\t\tassertLimit(input.limit);\n\t}\n\tif (input.types !== undefined) {\n\t\tassertMemoryTypeArray(input.types, \"types\");\n\t}\n}\n\n/**\n * Validate a {@link ConsolidateInput} and throw a `\"VALIDATION\"`\n * {@link MnemocyteError} for malformed inputs (empty `supersededIds`\n * a `survivorId` appearing in `supersededIds`, or duplicate loser IDs).\n */\nexport function validateConsolidateInput(input: ConsolidateInput): void {\n\tassertNonEmptyString(input.entityId, \"entityId\");\n\tassertNonEmptyString(input.survivorId, \"survivorId\");\n\tif (input.supersededIds.length === 0) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"supersededIds must contain at least one memory id.\",\n\t\t\t\"VALIDATION\",\n\t\t);\n\t}\n\tif (input.supersededIds.includes(input.survivorId)) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"survivorId must not appear in supersededIds.\",\n\t\t\t\"VALIDATION\",\n\t\t);\n\t}\n\tconst seenIds = new Set<string>();\n\tfor (const id of input.supersededIds) {\n\t\tassertNonEmptyString(id, \"supersededIds[*]\");\n\t\tif (seenIds.has(id)) {\n\t\t\tthrow new MnemocyteError(\n\t\t\t\t\"supersededIds must not contain duplicate memory ids.\",\n\t\t\t\t\"VALIDATION\",\n\t\t\t);\n\t\t}\n\t\tseenIds.add(id);\n\t}\n}\n\n/**\n * Validate a {@link ListAuditLogInput} and throw a `\"VALIDATION\"`\n * {@link MnemocyteError} when malformed.\n */\nexport function validateListAuditLogInput(input: ListAuditLogInput): void {\n\tassertNonEmptyString(input.entityId, \"entityId\");\n\tif (input.limit !== undefined) {\n\t\tassertLimit(input.limit);\n\t}\n\tfor (const [field, cursor] of [\n\t\t[\"beforeCursor\", input.beforeCursor],\n\t\t[\"afterCursor\", input.afterCursor],\n\t] as const) {\n\t\tif (cursor === undefined) {\n\t\t\tcontinue;\n\t\t}\n\t\tassertAuditLogCursor(cursor, field);\n\t}\n}\n\nfunction assertAuditLogCursor(\n\tvalue: unknown,\n\tfield: string,\n): asserts value is AuditLogCursor {\n\tif (typeof value !== \"object\" || value === null) {\n\t\tthrow new MnemocyteError(\n\t\t\t`${field} must be an audit-log cursor.`,\n\t\t\t\"VALIDATION\",\n\t\t);\n\t}\n\tconst cursor = value as { id?: unknown; timestamp?: unknown };\n\tassertValidDate(cursor.timestamp, `${field}.timestamp`);\n\tassertNonEmptyString(cursor.id, `${field}.id`);\n}\n","import { buildContext } from \"../context/builder.js\";\nimport { MnemocyteError } from \"../errors.js\";\nimport { observe, observePrepared } from \"../observability.js\";\nimport { throwIfAborted } from \"../resilience.js\";\nimport {\n\tcosineSimilarity,\n\tcreateLexicalScorer,\n\tcreateScoringConfig,\n\tDEFAULT_CANDIDATE_MULTIPLIER,\n\ttoScoredMemoryWithConfig,\n\ttoVectorScore,\n} from \"../retrieval/scorer.js\";\nimport type {\n\tAuditEvent,\n\tConsolidateInput,\n\tConsolidateResult,\n\tDuplicatePair,\n\tJsonObject,\n\tMemory,\n\tMemoryWithScore,\n\tMnemocyteClient,\n\tMnemocyteConfig,\n\tMnemocyteOperation,\n\tRecallInput,\n\tRememberInput,\n\tRememberManyInput,\n} from \"../types.js\";\nimport {\n\tDEFAULT_IMPORTANCE,\n\tDEFAULT_LIMIT,\n\tDEFAULT_MIN_SCORE,\n\tDEFAULT_TYPE,\n} from \"./defaults.js\";\nimport { embedMany, embedOne } from \"./embeddings.js\";\nimport { cloneJsonObject } from \"./json.js\";\nimport {\n\tcloneMemory,\n\tcreateEventId,\n\tcreateId,\n\tnormalizeTags,\n} from \"./records.js\";\nimport type {\n\tMemoryStore,\n\tStorePruneEntityDeletion,\n\tStorePruneResult,\n} from \"./store.js\";\nimport {\n\tassertLimit,\n\tassertMinScore,\n\tassertNonEmptyString,\n\tcontextInputToRecallInput,\n\ttype PreparedRememberInput,\n\tvalidateBuildContextInput,\n\tvalidateConsolidateInput,\n\tvalidateFindDuplicatesInput,\n\tvalidateListAuditLogInput,\n\tvalidatePruneInput,\n\tvalidateRecallInput,\n\tvalidateRememberInput,\n} from \"./validation.js\";\n\ninterface ScoredCandidate {\n\tmemory: Memory;\n\tvectorScore: number;\n\tlexicalScore: number;\n}\n\ninterface OperationMetadata {\n\tentityId?: string;\n\tmemoryId?: string;\n\tcount?: number;\n}\n\nfunction isPositionalRememberManyInput(\n\tinput: RememberManyInput | readonly RememberInput[],\n): input is readonly RememberInput[] {\n\treturn Array.isArray(input);\n}\n\nfunction providerOptions(\n\tconfig: MnemocyteConfig,\n\tsignal: AbortSignal | undefined,\n) {\n\treturn {\n\t\t...(signal === undefined ? {} : { signal }),\n\t\t...(config.provider === undefined ? {} : { resilience: config.provider }),\n\t};\n}\n\nfunction storeOptions(signal: AbortSignal | undefined) {\n\treturn signal === undefined ? undefined : { signal };\n}\n\nfunction snapshotRememberInput(input: RememberInput): PreparedRememberInput {\n\treturn {\n\t\t...input,\n\t\t...(input.tags === undefined\n\t\t\t? {}\n\t\t\t: { tags: Array.isArray(input.tags) ? [...input.tags] : input.tags }),\n\t\tmetadata: cloneJsonObject(input.metadata ?? {}),\n\t\t...(input.expiresAt === undefined\n\t\t\t? {}\n\t\t\t: {\n\t\t\t\t\texpiresAt:\n\t\t\t\t\t\tinput.expiresAt instanceof Date\n\t\t\t\t\t\t\t? new Date(input.expiresAt)\n\t\t\t\t\t\t\t: input.expiresAt,\n\t\t\t\t}),\n\t};\n}\n\nfunction createStoredMemory(\n\tconfig: MnemocyteConfig,\n\tinput: PreparedRememberInput,\n\tembedding: number[],\n\tnow: Date,\n) {\n\treturn {\n\t\tid: createId(),\n\t\tentityId: input.entityId,\n\t\tcontent: input.content,\n\t\ttype: input.type ?? DEFAULT_TYPE,\n\t\timportance: input.importance ?? DEFAULT_IMPORTANCE,\n\t\ttags: normalizeTags(input.tags),\n\t\tsource: input.source ?? null,\n\t\tmetadata: input.metadata,\n\t\tconfidence: input.confidence ?? 1,\n\t\tembeddingModel: config.embedder.model,\n\t\tembeddingDimensions: config.embedder.dimensions,\n\t\tsupersededBy: null,\n\t\tsupersededAt: null,\n\t\texpiresAt: input.expiresAt ?? null,\n\t\tlastAccessedAt: null,\n\t\taccessCount: 0,\n\t\tcreatedAt: now,\n\t\tupdatedAt: now,\n\t\tembedding,\n\t};\n}\n\nfunction auditEvent(\n\tentityId: string,\n\tdescription: string,\n\tmetadata: JsonObject,\n\ttimestamp = new Date(),\n): AuditEvent {\n\treturn {\n\t\tid: createEventId(),\n\t\tentityId,\n\t\tdescription,\n\t\tmetadata,\n\t\ttimestamp,\n\t};\n}\n\nfunction normalizeStoreRows<T extends { id: string }>(\n\texpected: readonly { id: string }[],\n\treturned: readonly T[],\n\toperation: string,\n): T[] {\n\tconst expectedIds = new Set(expected.map((memory) => memory.id));\n\tconst returnedById = new Map<string, T>();\n\n\tfor (const row of returned) {\n\t\tif (!expectedIds.has(row.id)) {\n\t\t\tthrow new MnemocyteError(`${operation} returned an unknown ID.`, \"DB\");\n\t\t}\n\t\tif (returnedById.has(row.id)) {\n\t\t\tthrow new MnemocyteError(`${operation} returned a duplicate ID.`, \"DB\");\n\t\t}\n\t\treturnedById.set(row.id, row);\n\t}\n\n\treturn expected.map((row) => {\n\t\tconst returnedRow = returnedById.get(row.id);\n\t\tif (!returnedRow) {\n\t\t\tthrow new MnemocyteError(\n\t\t\t\t`${operation} did not return every requested ID.`,\n\t\t\t\t\"DB\",\n\t\t\t);\n\t\t}\n\t\treturn returnedRow;\n\t});\n}\n\nfunction normalizePruneEntityDeletions(\n\tresult: StorePruneResult,\n\texpectedEntityId: string | undefined,\n): StorePruneEntityDeletion[] {\n\tconst seenEntityIds = new Set<string>();\n\tlet detailedDeletedCount = 0;\n\n\tfor (const detail of result.deletedByEntity) {\n\t\tif (\n\t\t\tdetail.entityId.length === 0 ||\n\t\t\t!Number.isInteger(detail.deletedCount) ||\n\t\t\tdetail.deletedCount <= 0 ||\n\t\t\tseenEntityIds.has(detail.entityId) ||\n\t\t\t(expectedEntityId !== undefined && detail.entityId !== expectedEntityId)\n\t\t) {\n\t\t\tthrow new MnemocyteError(\n\t\t\t\t\"Memory prune returned invalid per-entity deletion details.\",\n\t\t\t\t\"DB\",\n\t\t\t);\n\t\t}\n\t\tseenEntityIds.add(detail.entityId);\n\t\tdetailedDeletedCount += detail.deletedCount;\n\t}\n\n\tif (\n\t\tdetailedDeletedCount !== result.deletedCount ||\n\t\t(result.dryRun && result.deletedByEntity.length > 0)\n\t) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"Memory prune deletion details did not match the deleted count.\",\n\t\t\t\"DB\",\n\t\t);\n\t}\n\n\treturn [...result.deletedByEntity].sort((a, b) =>\n\t\ta.entityId.localeCompare(b.entityId),\n\t);\n}\n\nfunction toDuplicatePair(pair: {\n\ta: Memory;\n\tb: Memory;\n\tsimilarity: number;\n}): DuplicatePair {\n\treturn {\n\t\ta: cloneMemory(pair.a),\n\t\tb: cloneMemory(pair.b),\n\t\tsimilarity: Math.max(0, Math.min(1, pair.similarity)),\n\t};\n}\n\nexport function createMemoryClient(\n\tconfig: MnemocyteConfig,\n\tstore: MemoryStore,\n): MnemocyteClient {\n\ttype ClientState = \"open\" | \"closing\" | \"closed\";\n\n\tlet state: ClientState = \"open\";\n\tlet activeOperations = 0;\n\tlet operationsDrainedPromise: Promise<void> | undefined;\n\tlet resolveOperationsDrained: (() => void) | undefined;\n\tlet closePromise: Promise<void> | undefined;\n\n\tfunction assertOpen(): void {\n\t\tif (state === \"closed\") {\n\t\t\tthrow new MnemocyteError(\"Mnemocyte client is closed.\", \"DB\");\n\t\t}\n\t}\n\n\tfunction beginOperation(): () => void {\n\t\tif (state !== \"open\") {\n\t\t\tthrow new MnemocyteError(\"Mnemocyte client is closed.\", \"DB\");\n\t\t}\n\t\tactiveOperations += 1;\n\t\tlet completed = false;\n\t\treturn () => {\n\t\t\tif (completed) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcompleted = true;\n\t\t\tactiveOperations -= 1;\n\t\t\tif (activeOperations === 0 && resolveOperationsDrained) {\n\t\t\t\tconst resolve = resolveOperationsDrained;\n\t\t\t\tresolveOperationsDrained = undefined;\n\t\t\t\toperationsDrainedPromise = undefined;\n\t\t\t\tresolve();\n\t\t\t}\n\t\t};\n\t}\n\n\tfunction runOperation<T>(\n\t\toperationName: MnemocyteOperation,\n\t\tmetadata: OperationMetadata,\n\t\toperation: () => Promise<T>,\n\t): Promise<T> {\n\t\tlet complete: () => void;\n\t\ttry {\n\t\t\tcomplete = beginOperation();\n\t\t} catch (error) {\n\t\t\treturn observe(\n\t\t\t\tconfig,\n\t\t\t\tstore.backend,\n\t\t\t\toperationName,\n\t\t\t\tmetadata,\n\t\t\t\tasync () => {\n\t\t\t\t\tthrow error;\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\t\ttry {\n\t\t\treturn operation().then(\n\t\t\t\t(result) => {\n\t\t\t\t\tcomplete();\n\t\t\t\t\treturn result;\n\t\t\t\t},\n\t\t\t\t(error: unknown) => {\n\t\t\t\t\tcomplete();\n\t\t\t\t\tthrow error;\n\t\t\t\t},\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tcomplete();\n\t\t\treturn Promise.reject(error);\n\t\t}\n\t}\n\n\tfunction waitForActiveOperations(): Promise<void> {\n\t\tif (activeOperations === 0) {\n\t\t\treturn Promise.resolve();\n\t\t}\n\t\tif (!operationsDrainedPromise) {\n\t\t\toperationsDrainedPromise = new Promise<void>((resolve) => {\n\t\t\t\tresolveOperationsDrained = resolve;\n\t\t\t});\n\t\t}\n\t\treturn operationsDrainedPromise;\n\t}\n\n\tasync function ensureSchema(): Promise<void> {\n\t\tawait store.ensureSchema();\n\t}\n\n\tasync function ensureEmbeddingCompatibility(): Promise<void> {\n\t\tawait store.ensureEmbeddingCompatibility(config.embedder);\n\t}\n\n\tasync function recordAudit(events: readonly AuditEvent[]): Promise<void> {\n\t\tif (events.length === 0 || config.audit?.enabled !== true) {\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tawait store.addAuditEvents(events);\n\t\t} catch {\n\t\t\t// Audit writes must not break the primary operation.\n\t\t}\n\t}\n\n\tfunction remember(input: RememberInput): Promise<Memory> {\n\t\treturn runOperation(\"remember\", { entityId: input.entityId }, () =>\n\t\t\tobservePrepared(\n\t\t\t\tconfig,\n\t\t\t\tstore.backend,\n\t\t\t\t\"remember\",\n\t\t\t\t{ entityId: input.entityId },\n\t\t\t\t() => snapshotRememberInput(input),\n\t\t\t\tasync (preparedInput) => {\n\t\t\t\t\tassertOpen();\n\t\t\t\t\tvalidateRememberInput(preparedInput);\n\t\t\t\t\tawait ensureEmbeddingCompatibility();\n\t\t\t\t\tconst embedding = await embedOne(\n\t\t\t\t\t\tconfig.embedder,\n\t\t\t\t\t\tpreparedInput.content,\n\t\t\t\t\t\tproviderOptions(config, preparedInput.signal),\n\t\t\t\t\t);\n\t\t\t\t\tconst stored = [\n\t\t\t\t\t\tcreateStoredMemory(config, preparedInput, embedding, new Date()),\n\t\t\t\t\t];\n\t\t\t\t\tconst [memory] = normalizeStoreRows(\n\t\t\t\t\t\tstored,\n\t\t\t\t\t\tawait store.insertMemories(stored),\n\t\t\t\t\t\t\"Memory insert\",\n\t\t\t\t\t);\n\t\t\t\t\tif (!memory) {\n\t\t\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\t\t\"Memory insert did not return the inserted ID.\",\n\t\t\t\t\t\t\t\"DB\",\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tawait recordAudit([\n\t\t\t\t\t\tauditEvent(memory.entityId, \"memory.created\", {\n\t\t\t\t\t\t\tmemoryId: memory.id,\n\t\t\t\t\t\t\ttype: memory.type,\n\t\t\t\t\t\t\timportance: memory.importance,\n\t\t\t\t\t\t}),\n\t\t\t\t\t]);\n\t\t\t\t\treturn memory;\n\t\t\t\t},\n\t\t\t\t(memory) => ({ memoryId: memory.id, count: 1 }),\n\t\t\t),\n\t\t);\n\t}\n\n\tfunction rememberMany(\n\t\tinput: RememberManyInput | readonly RememberInput[],\n\t): Promise<Memory[]> {\n\t\tconst count = isPositionalRememberManyInput(input)\n\t\t\t? input.length\n\t\t\t: input.inputs.length;\n\t\treturn runOperation(\"rememberMany\", { count }, () =>\n\t\t\tobservePrepared(\n\t\t\t\tconfig,\n\t\t\t\tstore.backend,\n\t\t\t\t\"rememberMany\",\n\t\t\t\t{ count },\n\t\t\t\t() => {\n\t\t\t\t\tconst positional = isPositionalRememberManyInput(input);\n\t\t\t\t\tconst inputs = positional ? input : input.inputs;\n\t\t\t\t\treturn {\n\t\t\t\t\t\tpreparedInputs: inputs.map(snapshotRememberInput),\n\t\t\t\t\t\tsignal: positional ? input[0]?.signal : input.signal,\n\t\t\t\t\t};\n\t\t\t\t},\n\t\t\t\tasync ({ preparedInputs, signal }) => {\n\t\t\t\t\tassertOpen();\n\t\t\t\t\tif (preparedInputs.length === 0) {\n\t\t\t\t\t\treturn [];\n\t\t\t\t\t}\n\t\t\t\t\tfor (const item of preparedInputs) {\n\t\t\t\t\t\tvalidateRememberInput(item);\n\t\t\t\t\t}\n\t\t\t\t\tawait ensureEmbeddingCompatibility();\n\t\t\t\t\tconst embeddings = await embedMany(\n\t\t\t\t\t\tconfig.embedder,\n\t\t\t\t\t\tpreparedInputs.map((item) => item.content),\n\t\t\t\t\t\tproviderOptions(config, signal),\n\t\t\t\t\t);\n\t\t\t\t\tconst now = new Date();\n\t\t\t\t\tconst stored = preparedInputs.map((item, idx) =>\n\t\t\t\t\t\tcreateStoredMemory(config, item, embeddings[idx] as number[], now),\n\t\t\t\t\t);\n\t\t\t\t\tconst memories = normalizeStoreRows(\n\t\t\t\t\t\tstored,\n\t\t\t\t\t\tawait store.insertMemories(stored),\n\t\t\t\t\t\t\"Memory insert\",\n\t\t\t\t\t);\n\t\t\t\t\tawait recordAudit(\n\t\t\t\t\t\tmemories.map((memory) =>\n\t\t\t\t\t\t\tauditEvent(memory.entityId, \"memory.created\", {\n\t\t\t\t\t\t\t\tmemoryId: memory.id,\n\t\t\t\t\t\t\t\ttype: memory.type,\n\t\t\t\t\t\t\t\timportance: memory.importance,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t\treturn memories;\n\t\t\t\t},\n\t\t\t\t(result) => ({ count: result.length }),\n\t\t\t),\n\t\t);\n\t}\n\n\tfunction recall(input: RecallInput): Promise<MemoryWithScore[]> {\n\t\treturn observe(\n\t\t\tconfig,\n\t\t\tstore.backend,\n\t\t\t\"recall\",\n\t\t\t{ entityId: input.entityId },\n\t\t\tasync () => {\n\t\t\t\tassertOpen();\n\t\t\t\tvalidateRecallInput(input);\n\t\t\t\tconst limit = input.limit ?? config.defaults?.limit ?? DEFAULT_LIMIT;\n\t\t\t\tconst minScore =\n\t\t\t\t\tinput.minScore ?? config.defaults?.minScore ?? DEFAULT_MIN_SCORE;\n\t\t\t\tassertLimit(limit);\n\t\t\t\tassertMinScore(minScore);\n\t\t\t\tawait ensureEmbeddingCompatibility();\n\t\t\t\tconst queryEmbedding = await embedOne(\n\t\t\t\t\tconfig.embedder,\n\t\t\t\t\tinput.query,\n\t\t\t\t\tproviderOptions(config, input.signal),\n\t\t\t\t);\n\t\t\t\tconst candidateMultiplier =\n\t\t\t\t\tconfig.retrieval?.candidateMultiplier ?? DEFAULT_CANDIDATE_MULTIPLIER;\n\t\t\t\tconst candidateLimit = Math.max(limit, limit * candidateMultiplier);\n\t\t\t\tconst scoreLexical = createLexicalScorer(input.query);\n\t\t\t\tconst scoringConfig = createScoringConfig(config.retrieval);\n\t\t\t\tconst [vectorCandidates, lexicalCandidates] = await Promise.all([\n\t\t\t\t\tstore.vectorSearch({\n\t\t\t\t\t\t...input,\n\t\t\t\t\t\tembedding: queryEmbedding,\n\t\t\t\t\t\tlimit: candidateLimit,\n\t\t\t\t\t\tminVectorScore: 0,\n\t\t\t\t\t}),\n\t\t\t\t\tstore.lexicalSearch({ ...input, limit: candidateLimit }),\n\t\t\t\t]);\n\t\t\t\tconst merged = new Map<string, ScoredCandidate>();\n\t\t\t\tfor (const candidate of vectorCandidates) {\n\t\t\t\t\tmerged.set(candidate.memory.id, {\n\t\t\t\t\t\tmemory: candidate.memory,\n\t\t\t\t\t\tvectorScore: candidate.vectorScore,\n\t\t\t\t\t\tlexicalScore: scoreLexical(candidate.memory.content),\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tconst lexicalOnly = lexicalCandidates.filter(\n\t\t\t\t\t(candidate) => !merged.has(candidate.memory.id),\n\t\t\t\t);\n\t\t\t\tconst lexicalOnlyEmbeddings = await store.getMemoryEmbeddings(\n\t\t\t\t\tlexicalOnly.map((candidate) => candidate.memory.id),\n\t\t\t\t);\n\t\t\t\tfor (const candidate of lexicalCandidates) {\n\t\t\t\t\tconst existing = merged.get(candidate.memory.id);\n\t\t\t\t\tif (existing) {\n\t\t\t\t\t\texisting.lexicalScore = candidate.lexicalScore;\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tconst embedding = lexicalOnlyEmbeddings.get(candidate.memory.id);\n\t\t\t\t\tconst similarity = embedding\n\t\t\t\t\t\t? cosineSimilarity(embedding, queryEmbedding)\n\t\t\t\t\t\t: 0;\n\t\t\t\t\tmerged.set(candidate.memory.id, {\n\t\t\t\t\t\tmemory: candidate.memory,\n\t\t\t\t\t\tvectorScore: toVectorScore(similarity),\n\t\t\t\t\t\tlexicalScore: candidate.lexicalScore,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tconst scored: MemoryWithScore[] = Array.from(merged.values())\n\t\t\t\t\t.map((entry) =>\n\t\t\t\t\t\ttoScoredMemoryWithConfig(\n\t\t\t\t\t\t\tentry.memory,\n\t\t\t\t\t\t\tMath.max(0, entry.vectorScore),\n\t\t\t\t\t\t\tMath.max(0, entry.lexicalScore),\n\t\t\t\t\t\t\tinput,\n\t\t\t\t\t\t\tscoringConfig,\n\t\t\t\t\t\t),\n\t\t\t\t\t)\n\t\t\t\t\t.filter((memory) => memory.score >= minScore)\n\t\t\t\t\t.sort((a, b) => b.score - a.score)\n\t\t\t\t\t.slice(0, limit);\n\t\t\t\tconst accessUpdates = normalizeStoreRows(\n\t\t\t\t\tscored,\n\t\t\t\t\tawait store.markMemoriesAccessed(scored.map((memory) => memory.id)),\n\t\t\t\t\t\"Memory access update\",\n\t\t\t\t);\n\t\t\t\treturn scored.map((memory, index) => {\n\t\t\t\t\tconst update = accessUpdates[index];\n\t\t\t\t\tif (!update) {\n\t\t\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\t\t\"Memory access update did not return every requested ID.\",\n\t\t\t\t\t\t\t\"DB\",\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\t...memory,\n\t\t\t\t\t\tlastAccessedAt: new Date(update.lastAccessedAt),\n\t\t\t\t\t\taccessCount: update.accessCount,\n\t\t\t\t\t\tupdatedAt: new Date(update.updatedAt),\n\t\t\t\t\t};\n\t\t\t\t});\n\t\t\t},\n\t\t\t(result) => ({ count: result.length }),\n\t\t);\n\t}\n\n\tconst client: MnemocyteClient = {\n\t\tremember,\n\t\trememberMany,\n\t\trecall(input) {\n\t\t\treturn runOperation(\"recall\", { entityId: input.entityId }, () =>\n\t\t\t\trecall(input),\n\t\t\t);\n\t\t},\n\t\tbuildContext(input) {\n\t\t\treturn runOperation(\"buildContext\", { entityId: input.entityId }, () =>\n\t\t\t\tobserve(\n\t\t\t\t\tconfig,\n\t\t\t\t\tstore.backend,\n\t\t\t\t\t\"buildContext\",\n\t\t\t\t\t{ entityId: input.entityId },\n\t\t\t\t\tasync () => {\n\t\t\t\t\t\tassertOpen();\n\t\t\t\t\t\tvalidateBuildContextInput(input);\n\t\t\t\t\t\treturn buildContext({\n\t\t\t\t\t\t\tinput,\n\t\t\t\t\t\t\trecall: (contextInput) => {\n\t\t\t\t\t\t\t\tconst recallInput = contextInputToRecallInput(contextInput);\n\t\t\t\t\t\t\t\treturn recall(\n\t\t\t\t\t\t\t\t\tinput.signal === undefined\n\t\t\t\t\t\t\t\t\t\t? recallInput\n\t\t\t\t\t\t\t\t\t\t: { ...recallInput, signal: input.signal },\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t});\n\t\t\t\t\t},\n\t\t\t\t),\n\t\t\t);\n\t\t},\n\t\tforget(input) {\n\t\t\treturn runOperation(\n\t\t\t\t\"forget\",\n\t\t\t\t{ entityId: input.entityId, memoryId: input.memoryId },\n\t\t\t\t() =>\n\t\t\t\t\tobserve(\n\t\t\t\t\t\tconfig,\n\t\t\t\t\t\tstore.backend,\n\t\t\t\t\t\t\"forget\",\n\t\t\t\t\t\t{ entityId: input.entityId, memoryId: input.memoryId },\n\t\t\t\t\t\tasync () => {\n\t\t\t\t\t\t\tassertOpen();\n\t\t\t\t\t\t\tassertNonEmptyString(input.entityId, \"entityId\");\n\t\t\t\t\t\t\tassertNonEmptyString(input.memoryId, \"memoryId\");\n\t\t\t\t\t\t\tawait ensureSchema();\n\t\t\t\t\t\t\tconst deleted = await store.deleteMemory(\n\t\t\t\t\t\t\t\tinput.entityId,\n\t\t\t\t\t\t\t\tinput.memoryId,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tif (!deleted) {\n\t\t\t\t\t\t\t\tthrow new MnemocyteError(\"Memory was not found.\", \"NOT_FOUND\");\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tawait recordAudit([\n\t\t\t\t\t\t\t\tauditEvent(input.entityId, \"memory.deleted\", {\n\t\t\t\t\t\t\t\t\tmemoryId: input.memoryId,\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t]);\n\t\t\t\t\t\t},\n\t\t\t\t\t),\n\t\t\t);\n\t\t},\n\t\tforgetAll(input) {\n\t\t\treturn runOperation(\"forgetAll\", { entityId: input.entityId }, () =>\n\t\t\t\tobserve(\n\t\t\t\t\tconfig,\n\t\t\t\t\tstore.backend,\n\t\t\t\t\t\"forgetAll\",\n\t\t\t\t\t{ entityId: input.entityId },\n\t\t\t\t\tasync () => {\n\t\t\t\t\t\tassertOpen();\n\t\t\t\t\t\tassertNonEmptyString(input.entityId, \"entityId\");\n\t\t\t\t\t\tawait ensureSchema();\n\t\t\t\t\t\tconst deletedCount = await store.deleteMemoriesForEntity(\n\t\t\t\t\t\t\tinput.entityId,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tawait recordAudit([\n\t\t\t\t\t\t\tauditEvent(input.entityId, \"entity.cleared\", {\n\t\t\t\t\t\t\t\tcount: deletedCount,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t]);\n\t\t\t\t\t\treturn deletedCount;\n\t\t\t\t\t},\n\t\t\t\t\t(count) => ({ count }),\n\t\t\t\t).then(() => undefined),\n\t\t\t);\n\t\t},\n\t\tprune(input) {\n\t\t\treturn runOperation(\n\t\t\t\t\"prune\",\n\t\t\t\tinput.entityId === undefined ? {} : { entityId: input.entityId },\n\t\t\t\t() =>\n\t\t\t\t\tobserve(\n\t\t\t\t\t\tconfig,\n\t\t\t\t\t\tstore.backend,\n\t\t\t\t\t\t\"prune\",\n\t\t\t\t\t\tinput.entityId === undefined ? {} : { entityId: input.entityId },\n\t\t\t\t\t\tasync () => {\n\t\t\t\t\t\t\tassertOpen();\n\t\t\t\t\t\t\tthrowIfAborted(input.signal);\n\t\t\t\t\t\t\tconst filter = validatePruneInput(input);\n\t\t\t\t\t\t\tawait ensureSchema();\n\t\t\t\t\t\t\tconst result = await store.prune(\n\t\t\t\t\t\t\t\tfilter,\n\t\t\t\t\t\t\t\tstoreOptions(input.signal),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tconst deletedByEntity = normalizePruneEntityDeletions(\n\t\t\t\t\t\t\t\tresult,\n\t\t\t\t\t\t\t\tinput.entityId,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tif (result.deletedCount > 0 && result.dryRun === false) {\n\t\t\t\t\t\t\t\tawait recordAudit(\n\t\t\t\t\t\t\t\t\tdeletedByEntity.map((detail) =>\n\t\t\t\t\t\t\t\t\t\tauditEvent(detail.entityId, \"memory.pruned\", {\n\t\t\t\t\t\t\t\t\t\t\tcount: detail.deletedCount,\n\t\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\tmatchedCount: result.matchedCount,\n\t\t\t\t\t\t\t\tdeletedCount: result.deletedCount,\n\t\t\t\t\t\t\t\tdryRun: result.dryRun,\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t},\n\t\t\t\t\t\t(result) => ({ count: result.deletedCount }),\n\t\t\t\t\t),\n\t\t\t);\n\t\t},\n\t\tfindDuplicates(input) {\n\t\t\treturn runOperation(\"findDuplicates\", { entityId: input.entityId }, () =>\n\t\t\t\tobserve(\n\t\t\t\t\tconfig,\n\t\t\t\t\tstore.backend,\n\t\t\t\t\t\"findDuplicates\",\n\t\t\t\t\t{ entityId: input.entityId },\n\t\t\t\t\tasync () => {\n\t\t\t\t\t\tassertOpen();\n\t\t\t\t\t\tthrowIfAborted(input.signal);\n\t\t\t\t\t\tvalidateFindDuplicatesInput(input);\n\t\t\t\t\t\tawait ensureEmbeddingCompatibility();\n\t\t\t\t\t\tconst pairs = await store.findDuplicatePairs(\n\t\t\t\t\t\t\tinput,\n\t\t\t\t\t\t\tstoreOptions(input.signal),\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn pairs.map(toDuplicatePair);\n\t\t\t\t\t},\n\t\t\t\t\t(result) => ({ count: result.length }),\n\t\t\t\t),\n\t\t\t);\n\t\t},\n\t\tlistAuditLog(input) {\n\t\t\treturn runOperation(\"listAuditLog\", { entityId: input.entityId }, () =>\n\t\t\t\tobserve(\n\t\t\t\t\tconfig,\n\t\t\t\t\tstore.backend,\n\t\t\t\t\t\"listAuditLog\",\n\t\t\t\t\t{ entityId: input.entityId },\n\t\t\t\t\tasync () => {\n\t\t\t\t\t\tassertOpen();\n\t\t\t\t\t\tthrowIfAborted(input.signal);\n\t\t\t\t\t\tvalidateListAuditLogInput(input);\n\t\t\t\t\t\tawait ensureSchema();\n\t\t\t\t\t\tconst events = await store.listAuditLog(\n\t\t\t\t\t\t\tinput,\n\t\t\t\t\t\t\tstoreOptions(input.signal),\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn events;\n\t\t\t\t\t},\n\t\t\t\t\t(result) => ({ count: result.length }),\n\t\t\t\t),\n\t\t\t);\n\t\t},\n\t\tstats(input) {\n\t\t\treturn runOperation(\n\t\t\t\t\"stats\",\n\t\t\t\tinput?.entityId ? { entityId: input.entityId } : {},\n\t\t\t\t() =>\n\t\t\t\t\tobserve(\n\t\t\t\t\t\tconfig,\n\t\t\t\t\t\tstore.backend,\n\t\t\t\t\t\t\"stats\",\n\t\t\t\t\t\tinput?.entityId ? { entityId: input.entityId } : {},\n\t\t\t\t\t\tasync () => {\n\t\t\t\t\t\t\tassertOpen();\n\t\t\t\t\t\t\tawait ensureSchema();\n\t\t\t\t\t\t\treturn store.stats(input, new Date());\n\t\t\t\t\t\t},\n\t\t\t\t\t),\n\t\t\t);\n\t\t},\n\t\texperimental: {\n\t\t\tconsolidate(input: ConsolidateInput): Promise<ConsolidateResult> {\n\t\t\t\treturn runOperation(\n\t\t\t\t\t\"consolidate\",\n\t\t\t\t\t{ entityId: input.entityId, memoryId: input.survivorId },\n\t\t\t\t\t() =>\n\t\t\t\t\t\tobserve(\n\t\t\t\t\t\t\tconfig,\n\t\t\t\t\t\t\tstore.backend,\n\t\t\t\t\t\t\t\"consolidate\",\n\t\t\t\t\t\t\t{ entityId: input.entityId, memoryId: input.survivorId },\n\t\t\t\t\t\t\tasync () => {\n\t\t\t\t\t\t\t\tassertOpen();\n\t\t\t\t\t\t\t\tthrowIfAborted(input.signal);\n\t\t\t\t\t\t\t\tvalidateConsolidateInput(input);\n\t\t\t\t\t\t\t\tawait ensureSchema();\n\t\t\t\t\t\t\t\tconst survivor = await store.getMemory(\n\t\t\t\t\t\t\t\t\tinput.entityId,\n\t\t\t\t\t\t\t\t\tinput.survivorId,\n\t\t\t\t\t\t\t\t\tstoreOptions(input.signal),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\tthrowIfAborted(input.signal);\n\t\t\t\t\t\t\t\tif (!survivor) {\n\t\t\t\t\t\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\t\t\t\t\t\"Survivor memory was not found.\",\n\t\t\t\t\t\t\t\t\t\t\"NOT_FOUND\",\n\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tif (survivor.supersededBy !== null) {\n\t\t\t\t\t\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\t\t\t\t\t\"Survivor memory is itself superseded.\",\n\t\t\t\t\t\t\t\t\t\t\"VALIDATION\",\n\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tconst targets = await store.loadConsolidationTargets(\n\t\t\t\t\t\t\t\t\tinput.entityId,\n\t\t\t\t\t\t\t\t\tinput.supersededIds,\n\t\t\t\t\t\t\t\t\tstoreOptions(input.signal),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\tthrowIfAborted(input.signal);\n\t\t\t\t\t\t\t\tconst foundIds = new Set(targets.map((target) => target.id));\n\t\t\t\t\t\t\t\tfor (const id of input.supersededIds) {\n\t\t\t\t\t\t\t\t\tif (!foundIds.has(id)) {\n\t\t\t\t\t\t\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\t\t\t\t\t\t\"Superseded memory was not found.\",\n\t\t\t\t\t\t\t\t\t\t\t\"NOT_FOUND\",\n\t\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\t\ttargets.some(\n\t\t\t\t\t\t\t\t\t\t(target) =>\n\t\t\t\t\t\t\t\t\t\t\ttarget.supersededBy !== null &&\n\t\t\t\t\t\t\t\t\t\t\ttarget.supersededBy !== survivor.id,\n\t\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\t\t\t\t\t\"Superseded memory already belongs to a different survivor.\",\n\t\t\t\t\t\t\t\t\t\t\"CONFLICT\",\n\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tconst losers = targets.filter(\n\t\t\t\t\t\t\t\t\t(target) => target.supersededBy === null,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\tif (losers.length === 0) {\n\t\t\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\t\t\tsurvivorId: survivor.id,\n\t\t\t\t\t\t\t\t\t\tsupersededCount: 0,\n\t\t\t\t\t\t\t\t\t\tsupersededIds: [],\n\t\t\t\t\t\t\t\t\t} satisfies ConsolidateResult;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tconst result = await store.consolidate(\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\t\t\t\t\t\tsurvivorId: survivor.id,\n\t\t\t\t\t\t\t\t\t\tsupersededIds: input.supersededIds,\n\t\t\t\t\t\t\t\t\t\tmergeTags: input.mergeTags !== false,\n\t\t\t\t\t\t\t\t\t\tnow: new Date(),\n\t\t\t\t\t\t\t\t\t\tauditEnabled: config.audit?.enabled === true,\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\tstoreOptions(input.signal),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\t\tsurvivorId: survivor.id,\n\t\t\t\t\t\t\t\t\tsupersededCount: result.supersededIds.length,\n\t\t\t\t\t\t\t\t\tsupersededIds: result.supersededIds,\n\t\t\t\t\t\t\t\t} satisfies ConsolidateResult;\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t(result) => ({ count: result.supersededCount }),\n\t\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t},\n\t\t},\n\t\tclose() {\n\t\t\tif (closePromise) {\n\t\t\t\treturn closePromise;\n\t\t\t}\n\t\t\tstate = \"closing\";\n\t\t\tclosePromise = observe(config, store.backend, \"close\", {}, async () => {\n\t\t\t\tawait waitForActiveOperations();\n\t\t\t\ttry {\n\t\t\t\t\tawait store.close();\n\t\t\t\t\tstate = \"closed\";\n\t\t\t\t} catch (error) {\n\t\t\t\t\tstate = \"open\";\n\t\t\t\t\tclosePromise = undefined;\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t});\n\t\t\treturn closePromise;\n\t\t},\n\t};\n\n\treturn client;\n}\n","import { MnemocyteError } from \"../errors.js\";\n\nexport function memoryHasDependentsError(cause?: unknown): MnemocyteError {\n\treturn new MnemocyteError(\n\t\t\"Memory cannot be deleted while other memories reference it as their consolidation survivor.\",\n\t\t\"CONFLICT\",\n\t\tcause,\n\t);\n}\n","import { MnemocyteError } from \"../errors.js\";\nimport type { MnemocyteStoreConfig } from \"../types.js\";\nimport type { MemoryStore } from \"./store.js\";\n\nconst MEMORY_STORE_CONFIG = Symbol.for(\"mnemocyte.memory-store-config\");\n\ninterface MemoryStoreConfigEnvelope {\n\treadonly [MEMORY_STORE_CONFIG]: MemoryStore;\n}\n\nexport function createMnemocyteStoreConfig(\n\tstore: MemoryStore,\n): MnemocyteStoreConfig {\n\treturn Object.freeze({\n\t\t[MEMORY_STORE_CONFIG]: store,\n\t}) as unknown as MnemocyteStoreConfig;\n}\n\nexport function unwrapMnemocyteStoreConfig(\n\tconfig: MnemocyteStoreConfig,\n): MemoryStore {\n\tconst candidate: unknown = config;\n\tif (\n\t\ttypeof candidate !== \"object\" ||\n\t\tcandidate === null ||\n\t\t!(MEMORY_STORE_CONFIG in candidate)\n\t) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"store must be created by a supported Mnemocyte store adapter.\",\n\t\t\t\"CONFIG\",\n\t\t);\n\t}\n\n\treturn (candidate as MemoryStoreConfigEnvelope)[MEMORY_STORE_CONFIG];\n}\n"],"mappings":"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CD;AACD;;;AC9BA,SAAS,aACR,OACA,UACuB;CACvB,OAAO;EACN,GAAG;EACH,GAAI,SAAS,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,SAAS,SAAS;EACzE,GAAI,SAAS,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,SAAS,SAAS;EACzE,GAAI,SAAS,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,SAAS,MAAM;CACjE;AACD;AAEA,eAAe,gBACd,QACA,OACgB;CAChB,IAAI;EACH,MAAM,OAAO,eAAe,UAAU,KAAK;CAC5C,QAAQ;EACP;CACD;AACD;AAEA,eAAe,qBACd,QACA,SACA,WACA,UACA,WACA,QACA,iBACa;CACb,MAAM,gBACL,QACA,aACC;EACC;EACA,OAAO;EACP;EACA,WAAW,IAAI,KAAK,SAAS;CAC9B,GACA,QACD,CACD;CACA,IAAI;EACH,MAAM,SAAS,MAAM,OAAO;EAC5B,MAAM,gBACL,QACA,aACC;GACC;GACA,OAAO;GACP;GACA,2BAAW,IAAI,KAAK;GACpB,YAAY,KAAK,IAAI,IAAI;EAC1B,GACA;GAAE,GAAG;GAAU,GAAG,kBAAkB,MAAM;EAAE,CAC7C,CACD;EACA,OAAO;CACR,SAAS,OAAO;EACf,MAAM,gBACL,QACA,aACC;GACC;GACA,OAAO;GACP;GACA,2BAAW,IAAI,KAAK;GACpB,YAAY,KAAK,IAAI,IAAI;GACzB;EACD,GACA,QACD,CACD;EACA,MAAM;CACP;AACD;AAEA,SAAgB,QACf,QACA,SACA,WACA,UACA,QACA,iBACa;CACb,OAAO,qBACN,QACA,SACA,WACA,UACA,KAAK,IAAI,GACT,QACA,eACD;AACD;AAEA,SAAgB,gBACf,QACA,SACA,WACA,UACA,SACA,QACA,iBACkB;CAClB,MAAM,YAAY,KAAK,IAAI;CAC3B,IAAI;EACH,MAAM,WAAW,QAAQ;EACzB,OAAO,qBACN,QACA,SACA,WACA,UACA,iBACM,OAAO,QAAQ,GACrB,eACD;CACD,SAAS,OAAO;EACf,OAAO,qBACN,QACA,SACA,WACA,UACA,WACA,YAAY;GACX,MAAM;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"}

package/dist/stores/drizzle.d.mts

@@ -0,0 +1,18 @@
+import { D as MnemocyteStoreConfig } from "../types-XUWYDoXM.mjs";
+import { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+
+//#region src/stores/drizzle.d.ts
+/**
+ * Wrap a caller-owned postgres.js Drizzle instance for
+ * {@link MnemocyteConfig.store}.
+ *
+ * The Mnemocyte tables must already exist in the public schema through the
+ * bundled migrations. Closing the Mnemocyte client does not close the supplied
+ * Drizzle instance or its underlying postgres.js client.
+ *
+ * @param db - A Drizzle instance created with `drizzle-orm/postgres-js`.
+ */
+declare function drizzleStore<TSchema extends Record<string, unknown>>(db: PostgresJsDatabase<TSchema>): MnemocyteStoreConfig;
+//#endregion
+export { drizzleStore };
+//# sourceMappingURL=drizzle.d.mts.map

package/dist/stores/drizzle.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.d.mts","names":[],"sources":["../../src/stores/drizzle.ts"],"mappings":";;;;;;AAgBA;;;;;;;;iBAAgB,YAAA,iBAA6B,MAAA,kBAAA,CAC5C,EAAA,EAAI,kBAAA,CAAmB,OAAA,IACrB,oBAAA"}

package/dist/stores/drizzle.mjs

@@ -0,0 +1,20 @@
+import { n as createCallerOwnedDatabaseHandle, t as createPostgresStore } from "../postgres-BHQ1pj16.mjs";
+import { t as createMnemocyteStoreConfig } from "../store-config-BFFTm1sj.mjs";
+//#region src/stores/drizzle.ts
+/**
+* Wrap a caller-owned postgres.js Drizzle instance for
+* {@link MnemocyteConfig.store}.
+*
+* The Mnemocyte tables must already exist in the public schema through the
+* bundled migrations. Closing the Mnemocyte client does not close the supplied
+* Drizzle instance or its underlying postgres.js client.
+*
+* @param db - A Drizzle instance created with `drizzle-orm/postgres-js`.
+*/
+function drizzleStore(db) {
+	return createMnemocyteStoreConfig(createPostgresStore(createCallerOwnedDatabaseHandle(db)));
+}
+//#endregion
+export { drizzleStore };
+
+//# sourceMappingURL=drizzle.mjs.map

package/dist/stores/drizzle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.mjs","names":[],"sources":["../../src/stores/drizzle.ts"],"sourcesContent":["import type { PostgresJsDatabase } from \"drizzle-orm/postgres-js\";\nimport { createCallerOwnedDatabaseHandle } from \"../db/index.js\";\nimport { createPostgresStore } from \"../memory/postgres.js\";\nimport { createMnemocyteStoreConfig } from \"../memory/store-config.js\";\nimport type { MnemocyteStoreConfig } from \"../types.js\";\n\n/**\n * Wrap a caller-owned postgres.js Drizzle instance for\n * {@link MnemocyteConfig.store}.\n *\n * The Mnemocyte tables must already exist in the public schema through the\n * bundled migrations. Closing the Mnemocyte client does not close the supplied\n * Drizzle instance or its underlying postgres.js client.\n *\n * @param db - A Drizzle instance created with `drizzle-orm/postgres-js`.\n */\nexport function drizzleStore<TSchema extends Record<string, unknown>>(\n\tdb: PostgresJsDatabase<TSchema>,\n): MnemocyteStoreConfig {\n\treturn createMnemocyteStoreConfig(\n\t\tcreatePostgresStore(createCallerOwnedDatabaseHandle(db)),\n\t);\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,SAAgB,aACf,IACuB;CACvB,OAAO,2BACN,oBAAoB,gCAAgC,EAAE,CAAC,CACxD;AACD"}