mnemocyte 0.3.0 → 0.4.0

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["insertMemoryRows","vectorSearchQuery","lexicalSearchQuery","getMemoryEmbeddingsQuery","deleteMemoryQuery","deleteMemoriesForEntityQuery","findDuplicatePairsQuery"],"sources":["../src/db/vector.ts","../src/db/schema.ts","../src/db/index.ts","../src/memory/json.ts","../src/memory/records.ts","../src/retrieval/scorer.ts","../src/context/formatter.ts","../src/context/tokens.ts","../src/context/builder.ts","../src/observability.ts","../src/memory/defaults.ts","../src/resilience.ts","../src/memory/embeddings.ts","../src/memory/validation.ts","../src/memory/client-core.ts","../src/memory/filters.ts","../src/memory/in-memory.ts","../src/db/queries/events.ts","../src/db/queries/memories.ts","../src/db/queries/meta.ts","../src/memory/postgres-records.ts","../src/memory/postgres.ts","../src/client.ts"],"sourcesContent":["export function formatVectorComponent(value: number): string {\n\tif (!Number.isFinite(value)) {\n\t\tthrow new Error(\"Vector values must be finite numbers.\");\n\t}\n\treturn Object.is(value, -0) ? \"0\" : value.toFixed(17);\n}\n","import { sql } from \"drizzle-orm\";\nimport {\n\ttype AnyPgColumn,\n\tcustomType,\n\tindex,\n\tinteger,\n\tjsonb,\n\tpgTable,\n\treal,\n\ttext,\n\ttimestamp,\n} from \"drizzle-orm/pg-core\";\nimport type { JsonObject } from \"../types.js\";\nimport { formatVectorComponent } from \"./vector.js\";\n\nconst vector = customType<{\n\tdata: number[];\n\tdriverData: string;\n\tconfig: { dimensions?: number };\n}>({\n\tdataType(config) {\n\t\tconst dimensions = config?.dimensions ?? 1536;\n\t\treturn `vector(${dimensions})`;\n\t},\n\ttoDriver(value) {\n\t\treturn `[${value.map(formatVectorComponent).join(\",\")}]`;\n\t},\n\tfromDriver(value) {\n\t\treturn value.slice(1, -1).split(\",\").filter(Boolean).map(Number);\n\t},\n});\n\nexport const memoriesTable = pgTable(\n\t\"mnemocyte_memories\",\n\t{\n\t\tid: text(\"id\").primaryKey(),\n\t\tentityId: text(\"entity_id\").notNull(),\n\t\tcontent: text(\"content\").notNull(),\n\t\ttype: text(\"type\").notNull().default(\"fact\"),\n\t\timportance: text(\"importance\").notNull().default(\"normal\"),\n\t\ttags: text(\"tags\").array().notNull().default(sql`'{}'::text[]`),\n\t\tsource: text(\"source\"),\n\t\tmetadata: jsonb(\"metadata\").$type<JsonObject>().notNull().default({}),\n\t\tconfidence: real(\"confidence\").notNull().default(1),\n\t\tembedding: vector(\"embedding\", { dimensions: 1536 }),\n\t\tembeddingModel: text(\"embedding_model\").notNull(),\n\t\tembeddingDimensions: integer(\"embedding_dimensions\").notNull(),\n\t\tsupersededBy: text(\"superseded_by\").references(\n\t\t\t(): AnyPgColumn => memoriesTable.id,\n\t\t),\n\t\tsupersededAt: timestamp(\"superseded_at\", { withTimezone: true }),\n\t\texpiresAt: timestamp(\"expires_at\", { withTimezone: true }),\n\t\tlastAccessedAt: timestamp(\"last_accessed_at\", { withTimezone: true }),\n\t\taccessCount: integer(\"access_count\").notNull().default(0),\n\t\tcreatedAt: timestamp(\"created_at\", { withTimezone: true })\n\t\t\t.notNull()\n\t\t\t.defaultNow(),\n\t\tupdatedAt: timestamp(\"updated_at\", { withTimezone: true })\n\t\t\t.notNull()\n\t\t\t.defaultNow(),\n\t},\n\t(table) => [\n\t\tindex(\"mnemocyte_memories_entity_idx\").on(table.entityId),\n\t\tindex(\"mnemocyte_memories_entity_type_idx\").on(table.entityId, table.type),\n\t\tindex(\"mnemocyte_memories_embedding_hnsw_idx\").using(\n\t\t\t\"hnsw\",\n\t\t\ttable.embedding.op(\"vector_cosine_ops\"),\n\t\t),\n\t],\n);\n\nexport const eventsTable = pgTable(\n\t\"mnemocyte_events\",\n\t{\n\t\tid: text(\"id\").primaryKey(),\n\t\tentityId: text(\"entity_id\").notNull(),\n\t\tdescription: text(\"description\").notNull(),\n\t\tmetadata: jsonb(\"metadata\").$type<JsonObject>().notNull().default({}),\n\t\ttimestamp: timestamp(\"timestamp\", { withTimezone: true })\n\t\t\t.notNull()\n\t\t\t.defaultNow(),\n\t},\n\t(table) => [\n\t\tindex(\"mnemocyte_events_entity_time_idx\").on(\n\t\t\ttable.entityId,\n\t\t\ttable.timestamp,\n\t\t),\n\t],\n);\n\nexport const metaTable = pgTable(\"mnemocyte_meta\", {\n\tkey: text(\"key\").primaryKey(),\n\tembeddingDimensions: integer(\"embedding_dimensions\").notNull(),\n});\n\nexport type MemoryRow = typeof memoriesTable.$inferSelect;\nexport type NewMemoryRow = typeof memoriesTable.$inferInsert;\nexport type EventRow = typeof eventsTable.$inferSelect;\nexport type NewEventRow = typeof eventsTable.$inferInsert;\nexport type MetaRow = typeof metaTable.$inferSelect;\n","import { drizzle, type PostgresJsDatabase } from \"drizzle-orm/postgres-js\";\nimport postgres from \"postgres\";\nimport { MnemocyteError } from \"../errors.js\";\nimport * as schema from \"./schema.js\";\n\nexport type MnemocyteDatabase = PostgresJsDatabase<typeof schema>;\n\nexport interface DatabaseHandle {\n\tdb: MnemocyteDatabase;\n\tclose(): Promise<void>;\n}\n\ntype PostgresSslMode =\n\t| \"require\"\n\t| \"prefer\"\n\t| \"allow\"\n\t| \"verify-full\"\n\t| \"disable\";\n\ntype ValidPostgresSsl =\n\t| \"require\"\n\t| \"prefer\"\n\t| \"allow\"\n\t| \"verify-full\"\n\t| boolean\n\t| { rejectUnauthorized: false };\n\nfunction parseSslFromUrl(url: URL): ValidPostgresSsl | undefined {\n\tconst mode = url.searchParams.get(\"sslmode\") as PostgresSslMode | null;\n\tif (!mode || mode === \"disable\") return undefined;\n\n\tif (mode === \"require\" || mode === \"prefer\" || mode === \"allow\") {\n\t\treturn { rejectUnauthorized: false };\n\t}\n\n\tif (mode === \"verify-full\") return \"verify-full\";\n\n\treturn undefined;\n}\n\nexport function createDatabase(databaseUrl: string): DatabaseHandle {\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\tconst ssl = parseSslFromUrl(url);\n\n\tconst isPooler =\n\t\turl.port === \"6543\" || url.searchParams.get(\"pgbouncer\") === \"true\";\n\n\tconst client = postgres(databaseUrl, {\n\t\tmax: 10,\n\t\tidle_timeout: 20,\n\t\tconnect_timeout: 10,\n\t\t...(ssl ? { ssl } : {}),\n\t\t...(isPooler ? { prepare: false } : {}),\n\t});\n\n\treturn {\n\t\tdb: drizzle(client, { schema }),\n\t\tasync close() {\n\t\t\tawait client.end();\n\t\t},\n\t};\n}\n","import { MnemocyteError } from \"../errors.js\";\nimport type { JsonObject, JsonValue } from \"../types.js\";\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(value: unknown, path = \"metadata\"): JsonObject {\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 JsonObject;\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\n/** Assert that a runtime value is a JSON-compatible object. */\nexport function validateJsonObject(\n\tvalue: unknown,\n\tpath = \"metadata\",\n): asserts value is JsonObject {\n\tcloneJsonObject(value, path);\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\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 { 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 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 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] of memories.entries()) {\n\t\tlines.push(\n\t\t\t\"\",\n\t\t\t`--- MEMORY ${index + 1} START ---`,\n\t\t\tformatMetadata(memory),\n\t\t\tmemory.content,\n\t\t\t`--- MEMORY ${index + 1} END ---`,\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\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[truncated to fit token budget]`;\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\treturn best || \"[truncated to fit token budget]\";\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\nexport async 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\tconst startedAt = Date.now();\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","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 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\"` / `\"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 === \"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\"` / `\"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 { 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}\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 { DEFAULT_RETRIEVAL_WEIGHTS } from \"../retrieval/scorer.js\";\nimport type {\n\tBuildContextInput,\n\tConsolidateInput,\n\tEmbedder,\n\tFindDuplicatesInput,\n\tListAuditLogInput,\n\tPruneInput,\n\tRecallInput,\n\tRememberInput,\n\tRetrievalConfig,\n\tRetrievalScoreWeights,\n} from \"../types.js\";\nimport { validateJsonObject } from \"./json.js\";\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 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: RememberInput): void {\n\tassertNonEmptyString(input.entityId, \"entityId\");\n\tassertNonEmptyString(input.content, \"content\");\n\tif (input.metadata !== undefined) {\n\t\tvalidateJsonObject(input.metadata);\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}\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}\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 a {@link PruneInput} and throw a `\"VALIDATION\"`\n * {@link MnemocyteError} when no selector is supplied. Mnemocyte\n * deliberately rejects `prune({})` to avoid surprise full-table deletes.\n */\nexport function validatePruneInput(input: PruneInput): void {\n\tif (input.entityId !== undefined) {\n\t\tassertNonEmptyString(input.entityId, \"entityId\");\n\t}\n\tconst hasSelector =\n\t\tinput.entityId !== undefined ||\n\t\tinput.expired === true ||\n\t\tinput.superseded === true ||\n\t\tinput.createdBefore !== undefined ||\n\t\tinput.notAccessedSince !== undefined ||\n\t\t(input.types !== undefined && input.types.length > 0) ||\n\t\t(input.tags !== undefined && input.tags.length > 0) ||\n\t\tinput.maxImportance !== undefined;\n\tif (!hasSelector) {\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 * 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}\n\n/**\n * Validate a {@link ConsolidateInput} and throw a `\"VALIDATION\"`\n * {@link MnemocyteError} for malformed inputs (empty `supersededIds`\n * or a `survivorId` appearing in `supersededIds`).\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\tfor (const id of input.supersededIds) {\n\t\tassertNonEmptyString(id, \"supersededIds[*]\");\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}\n","import { buildContext } from \"../context/builder.js\";\nimport { MnemocyteError } from \"../errors.js\";\nimport { observe } from \"../observability.js\";\nimport {\n\tcosineSimilarity,\n\tcreateLexicalScorer,\n\tcreateScoringConfig,\n\tDEFAULT_CANDIDATE_MULTIPLIER,\n\ttoScoredMemoryWithConfig,\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\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 { MemoryStore } from \"./store.js\";\nimport {\n\tassertLimit,\n\tassertMinScore,\n\tassertNonEmptyString,\n\tcontextInputToRecallInput,\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\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 createStoredMemory(\n\tconfig: MnemocyteConfig,\n\tinput: RememberInput,\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: cloneJsonObject(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: cloneJsonObject(metadata),\n\t\ttimestamp,\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\tlet closed = false;\n\n\tfunction assertOpen(): void {\n\t\tif (closed) {\n\t\t\tthrow new MnemocyteError(\"Mnemocyte client is closed.\", \"DB\");\n\t\t}\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\tasync function remember(input: RememberInput): Promise<Memory> {\n\t\tconst preparedInput: RememberInput = {\n\t\t\t...input,\n\t\t\tmetadata: cloneJsonObject(input.metadata ?? {}),\n\t\t};\n\t\treturn observe(\n\t\t\tconfig,\n\t\t\tstore.backend,\n\t\t\t\"remember\",\n\t\t\t{ entityId: preparedInput.entityId },\n\t\t\tasync () => {\n\t\t\t\tassertOpen();\n\t\t\t\tvalidateRememberInput(preparedInput);\n\t\t\t\tawait ensureEmbeddingCompatibility();\n\t\t\t\tconst embedding = await embedOne(\n\t\t\t\t\tconfig.embedder,\n\t\t\t\t\tpreparedInput.content,\n\t\t\t\t\tproviderOptions(config, preparedInput.signal),\n\t\t\t\t);\n\t\t\t\tconst [memory] = await store.insertMemories([\n\t\t\t\t\tcreateStoredMemory(config, preparedInput, embedding, new Date()),\n\t\t\t\t]);\n\t\t\t\tif (!memory) {\n\t\t\t\t\tthrow new MnemocyteError(\"Memory insert returned no rows.\", \"DB\");\n\t\t\t\t}\n\t\t\t\tawait recordAudit([\n\t\t\t\t\tauditEvent(memory.entityId, \"memory.created\", {\n\t\t\t\t\t\tmemoryId: memory.id,\n\t\t\t\t\t\ttype: memory.type,\n\t\t\t\t\t\timportance: memory.importance,\n\t\t\t\t\t}),\n\t\t\t\t]);\n\t\t\t\treturn cloneMemory(memory);\n\t\t\t},\n\t\t\t(memory) => ({ memoryId: memory.id, count: 1 }),\n\t\t);\n\t}\n\n\tasync function rememberMany(\n\t\tinput: RememberManyInput | readonly RememberInput[],\n\t): Promise<Memory[]> {\n\t\tconst positional = isPositionalRememberManyInput(input);\n\t\tconst inputs = positional ? input : input.inputs;\n\t\tconst signal = positional ? input[0]?.signal : input.signal;\n\t\tconst preparedInputs = inputs.map(\n\t\t\t(item): RememberInput => ({\n\t\t\t\t...item,\n\t\t\t\tmetadata: cloneJsonObject(item.metadata ?? {}),\n\t\t\t}),\n\t\t);\n\t\treturn observe(\n\t\t\tconfig,\n\t\t\tstore.backend,\n\t\t\t\"rememberMany\",\n\t\t\t{ count: preparedInputs.length },\n\t\t\tasync () => {\n\t\t\t\tassertOpen();\n\t\t\t\tif (preparedInputs.length === 0) {\n\t\t\t\t\treturn [];\n\t\t\t\t}\n\t\t\t\tfor (const item of preparedInputs) {\n\t\t\t\t\tvalidateRememberInput(item);\n\t\t\t\t}\n\t\t\t\tawait ensureEmbeddingCompatibility();\n\t\t\t\tconst embeddings = await embedMany(\n\t\t\t\t\tconfig.embedder,\n\t\t\t\t\tpreparedInputs.map((item) => item.content),\n\t\t\t\t\tproviderOptions(config, signal),\n\t\t\t\t);\n\t\t\t\tconst now = new Date();\n\t\t\t\tconst stored = preparedInputs.map((item, idx) =>\n\t\t\t\t\tcreateStoredMemory(config, item, embeddings[idx] as number[], now),\n\t\t\t\t);\n\t\t\t\tconst memories = await store.insertMemories(stored);\n\t\t\t\tawait recordAudit(\n\t\t\t\t\tmemories.map((memory) =>\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);\n\t\t\t\treturn memories.map(cloneMemory);\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\tasync recall(input) {\n\t\t\treturn observe(\n\t\t\t\tconfig,\n\t\t\t\tstore.backend,\n\t\t\t\t\"recall\",\n\t\t\t\t{ entityId: input.entityId },\n\t\t\t\tasync () => {\n\t\t\t\t\tassertOpen();\n\t\t\t\t\tvalidateRecallInput(input);\n\t\t\t\t\tconst limit = input.limit ?? config.defaults?.limit ?? DEFAULT_LIMIT;\n\t\t\t\t\tconst minScore =\n\t\t\t\t\t\tinput.minScore ?? config.defaults?.minScore ?? DEFAULT_MIN_SCORE;\n\t\t\t\t\tassertLimit(limit);\n\t\t\t\t\tassertMinScore(minScore);\n\t\t\t\t\tawait ensureEmbeddingCompatibility();\n\t\t\t\t\tconst queryEmbedding = await embedOne(\n\t\t\t\t\t\tconfig.embedder,\n\t\t\t\t\t\tinput.query,\n\t\t\t\t\t\tproviderOptions(config, input.signal),\n\t\t\t\t\t);\n\t\t\t\t\tconst candidateMultiplier =\n\t\t\t\t\t\tconfig.retrieval?.candidateMultiplier ??\n\t\t\t\t\t\tDEFAULT_CANDIDATE_MULTIPLIER;\n\t\t\t\t\tconst candidateLimit = Math.max(limit, limit * candidateMultiplier);\n\t\t\t\t\tconst scoreLexical = createLexicalScorer(input.query);\n\t\t\t\t\tconst scoringConfig = createScoringConfig(config.retrieval);\n\t\t\t\t\tconst [vectorCandidates, lexicalCandidates] = await Promise.all([\n\t\t\t\t\t\tstore.vectorSearch({\n\t\t\t\t\t\t\t...input,\n\t\t\t\t\t\t\tembedding: queryEmbedding,\n\t\t\t\t\t\t\tlimit: candidateLimit,\n\t\t\t\t\t\t\tminScore: 0,\n\t\t\t\t\t\t}),\n\t\t\t\t\t\tstore.lexicalSearch({ ...input, limit: candidateLimit }),\n\t\t\t\t\t]);\n\t\t\t\t\tconst merged = new Map<string, ScoredCandidate>();\n\t\t\t\t\tfor (const candidate of vectorCandidates) {\n\t\t\t\t\t\tmerged.set(candidate.memory.id, {\n\t\t\t\t\t\t\tmemory: candidate.memory,\n\t\t\t\t\t\t\tvectorScore: candidate.vectorScore,\n\t\t\t\t\t\t\tlexicalScore: scoreLexical(candidate.memory.content),\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\tconst lexicalOnly = lexicalCandidates.filter(\n\t\t\t\t\t\t(candidate) => !merged.has(candidate.memory.id),\n\t\t\t\t\t);\n\t\t\t\t\tconst lexicalOnlyEmbeddings = await store.getMemoryEmbeddings(\n\t\t\t\t\t\tlexicalOnly.map((candidate) => candidate.memory.id),\n\t\t\t\t\t);\n\t\t\t\t\tfor (const candidate of lexicalCandidates) {\n\t\t\t\t\t\tconst existing = merged.get(candidate.memory.id);\n\t\t\t\t\t\tif (existing) {\n\t\t\t\t\t\t\texisting.lexicalScore = candidate.lexicalScore;\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst embedding = lexicalOnlyEmbeddings.get(candidate.memory.id);\n\t\t\t\t\t\tconst similarity = embedding\n\t\t\t\t\t\t\t? cosineSimilarity(embedding, queryEmbedding)\n\t\t\t\t\t\t\t: 0;\n\t\t\t\t\t\tmerged.set(candidate.memory.id, {\n\t\t\t\t\t\t\tmemory: candidate.memory,\n\t\t\t\t\t\t\tvectorScore: Math.max(0, similarity),\n\t\t\t\t\t\t\tlexicalScore: candidate.lexicalScore,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\tconst scored: MemoryWithScore[] = Array.from(merged.values())\n\t\t\t\t\t\t.map((entry) =>\n\t\t\t\t\t\t\ttoScoredMemoryWithConfig(\n\t\t\t\t\t\t\t\tentry.memory,\n\t\t\t\t\t\t\t\tMath.max(0, entry.vectorScore),\n\t\t\t\t\t\t\t\tMath.max(0, entry.lexicalScore),\n\t\t\t\t\t\t\t\tinput,\n\t\t\t\t\t\t\t\tscoringConfig,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t)\n\t\t\t\t\t\t.filter((memory) => memory.score >= minScore)\n\t\t\t\t\t\t.sort((a, b) => b.score - a.score)\n\t\t\t\t\t\t.slice(0, limit);\n\t\t\t\t\tawait store.markMemoriesAccessed(scored.map((memory) => memory.id));\n\t\t\t\t\treturn scored;\n\t\t\t\t},\n\t\t\t\t(result) => ({ count: result.length }),\n\t\t\t);\n\t\t},\n\t\tasync buildContext(input) {\n\t\t\treturn observe(\n\t\t\t\tconfig,\n\t\t\t\tstore.backend,\n\t\t\t\t\"buildContext\",\n\t\t\t\t{ entityId: input.entityId },\n\t\t\t\tasync () => {\n\t\t\t\t\tassertOpen();\n\t\t\t\t\tvalidateBuildContextInput(input);\n\t\t\t\t\treturn buildContext({\n\t\t\t\t\t\tinput,\n\t\t\t\t\t\trecall: (contextInput) => {\n\t\t\t\t\t\t\tconst recallInput = contextInputToRecallInput(contextInput);\n\t\t\t\t\t\t\treturn client.recall(\n\t\t\t\t\t\t\t\tinput.signal === undefined\n\t\t\t\t\t\t\t\t\t? recallInput\n\t\t\t\t\t\t\t\t\t: { ...recallInput, signal: input.signal },\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\tasync forget(input) {\n\t\t\treturn observe(\n\t\t\t\tconfig,\n\t\t\t\tstore.backend,\n\t\t\t\t\"forget\",\n\t\t\t\t{ entityId: input.entityId, memoryId: input.memoryId },\n\t\t\t\tasync () => {\n\t\t\t\t\tassertOpen();\n\t\t\t\t\tassertNonEmptyString(input.entityId, \"entityId\");\n\t\t\t\t\tassertNonEmptyString(input.memoryId, \"memoryId\");\n\t\t\t\t\tawait ensureSchema();\n\t\t\t\t\tconst deleted = await store.deleteMemory(\n\t\t\t\t\t\tinput.entityId,\n\t\t\t\t\t\tinput.memoryId,\n\t\t\t\t\t);\n\t\t\t\t\tif (!deleted) {\n\t\t\t\t\t\tthrow new MnemocyteError(\"Memory was not found.\", \"NOT_FOUND\");\n\t\t\t\t\t}\n\t\t\t\t\tawait recordAudit([\n\t\t\t\t\t\tauditEvent(input.entityId, \"memory.deleted\", {\n\t\t\t\t\t\t\tmemoryId: input.memoryId,\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\tasync forgetAll(input) {\n\t\t\treturn observe(\n\t\t\t\tconfig,\n\t\t\t\tstore.backend,\n\t\t\t\t\"forgetAll\",\n\t\t\t\t{ entityId: input.entityId },\n\t\t\t\tasync () => {\n\t\t\t\t\tassertOpen();\n\t\t\t\t\tassertNonEmptyString(input.entityId, \"entityId\");\n\t\t\t\t\tawait ensureSchema();\n\t\t\t\t\tconst deletedCount = await store.deleteMemoriesForEntity(\n\t\t\t\t\t\tinput.entityId,\n\t\t\t\t\t);\n\t\t\t\t\tawait recordAudit([\n\t\t\t\t\t\tauditEvent(input.entityId, \"entity.cleared\", {\n\t\t\t\t\t\t\tcount: deletedCount,\n\t\t\t\t\t\t}),\n\t\t\t\t\t]);\n\t\t\t\t\treturn deletedCount;\n\t\t\t\t},\n\t\t\t\t(count) => ({ count }),\n\t\t\t).then(() => undefined);\n\t\t},\n\t\tasync prune(input) {\n\t\t\treturn observe(\n\t\t\t\tconfig,\n\t\t\t\tstore.backend,\n\t\t\t\t\"prune\",\n\t\t\t\tinput.entityId === undefined ? {} : { entityId: input.entityId },\n\t\t\t\tasync () => {\n\t\t\t\t\tassertOpen();\n\t\t\t\t\tvalidatePruneInput(input);\n\t\t\t\t\tawait ensureSchema();\n\t\t\t\t\tconst result = await store.prune(input);\n\t\t\t\t\tif (\n\t\t\t\t\t\tresult.deletedCount > 0 &&\n\t\t\t\t\t\tinput.entityId !== undefined &&\n\t\t\t\t\t\tresult.dryRun === false\n\t\t\t\t\t) {\n\t\t\t\t\t\tawait recordAudit([\n\t\t\t\t\t\t\tauditEvent(input.entityId, \"memory.pruned\", {\n\t\t\t\t\t\t\t\tcount: result.deletedCount,\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 result;\n\t\t\t\t},\n\t\t\t\t(result) => ({ count: result.deletedCount }),\n\t\t\t);\n\t\t},\n\t\tasync findDuplicates(input) {\n\t\t\treturn observe(\n\t\t\t\tconfig,\n\t\t\t\tstore.backend,\n\t\t\t\t\"findDuplicates\",\n\t\t\t\t{ entityId: input.entityId },\n\t\t\t\tasync () => {\n\t\t\t\t\tassertOpen();\n\t\t\t\t\tvalidateFindDuplicatesInput(input);\n\t\t\t\t\tawait ensureEmbeddingCompatibility();\n\t\t\t\t\tconst pairs = await store.findDuplicatePairs(input);\n\t\t\t\t\treturn pairs.map(toDuplicatePair);\n\t\t\t\t},\n\t\t\t\t(result) => ({ count: result.length }),\n\t\t\t);\n\t\t},\n\t\tasync listAuditLog(input) {\n\t\t\treturn observe(\n\t\t\t\tconfig,\n\t\t\t\tstore.backend,\n\t\t\t\t\"listAuditLog\",\n\t\t\t\t{ entityId: input.entityId },\n\t\t\t\tasync () => {\n\t\t\t\t\tassertOpen();\n\t\t\t\t\tvalidateListAuditLogInput(input);\n\t\t\t\t\tawait ensureSchema();\n\t\t\t\t\tconst events = await store.listAuditLog(input);\n\t\t\t\t\treturn events.map((event) => ({\n\t\t\t\t\t\tid: event.id,\n\t\t\t\t\t\tentityId: event.entityId,\n\t\t\t\t\t\tdescription: event.description,\n\t\t\t\t\t\tmetadata: cloneJsonObject(event.metadata),\n\t\t\t\t\t\ttimestamp: new Date(event.timestamp),\n\t\t\t\t\t}));\n\t\t\t\t},\n\t\t\t\t(result) => ({ count: result.length }),\n\t\t\t);\n\t\t},\n\t\tasync stats(input) {\n\t\t\treturn observe(\n\t\t\t\tconfig,\n\t\t\t\tstore.backend,\n\t\t\t\t\"stats\",\n\t\t\t\tinput?.entityId ? { entityId: input.entityId } : {},\n\t\t\t\tasync () => {\n\t\t\t\t\tassertOpen();\n\t\t\t\t\tawait ensureSchema();\n\t\t\t\t\treturn store.stats(input, new Date());\n\t\t\t\t},\n\t\t\t);\n\t\t},\n\t\texperimental: {\n\t\t\tasync consolidate(input: ConsolidateInput): Promise<ConsolidateResult> {\n\t\t\t\treturn observe(\n\t\t\t\t\tconfig,\n\t\t\t\t\tstore.backend,\n\t\t\t\t\t\"consolidate\",\n\t\t\t\t\t{ entityId: input.entityId, memoryId: input.survivorId },\n\t\t\t\t\tasync () => {\n\t\t\t\t\t\tassertOpen();\n\t\t\t\t\t\tvalidateConsolidateInput(input);\n\t\t\t\t\t\tawait ensureSchema();\n\t\t\t\t\t\tconst survivor = await store.getMemory(\n\t\t\t\t\t\t\tinput.entityId,\n\t\t\t\t\t\t\tinput.survivorId,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tif (!survivor) {\n\t\t\t\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\t\t\t\"Survivor memory was not found.\",\n\t\t\t\t\t\t\t\t\"NOT_FOUND\",\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (survivor.supersededBy !== null) {\n\t\t\t\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\t\t\t\"Survivor memory is itself superseded.\",\n\t\t\t\t\t\t\t\t\"VALIDATION\",\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst targets = await store.loadConsolidationTargets(\n\t\t\t\t\t\t\tinput.entityId,\n\t\t\t\t\t\t\tinput.supersededIds,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tconst foundIds = new Set(targets.map((target) => target.id));\n\t\t\t\t\t\tfor (const id of input.supersededIds) {\n\t\t\t\t\t\t\tif (!foundIds.has(id)) {\n\t\t\t\t\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\t\t\t\t\"Superseded memory was not found.\",\n\t\t\t\t\t\t\t\t\t\"NOT_FOUND\",\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\tconst losers = targets.filter(\n\t\t\t\t\t\t\t(target) => target.supersededBy === null,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tif (losers.length === 0) {\n\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\tsurvivorId: survivor.id,\n\t\t\t\t\t\t\t\tsupersededCount: 0,\n\t\t\t\t\t\t\t\tsupersededIds: [],\n\t\t\t\t\t\t\t} satisfies ConsolidateResult;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst result = await store.consolidate({\n\t\t\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\t\t\tsurvivorId: survivor.id,\n\t\t\t\t\t\t\tsurvivorTags: survivor.tags,\n\t\t\t\t\t\t\tsupersededIds: losers.map((loser) => loser.id),\n\t\t\t\t\t\t\tmergeTags: input.mergeTags !== false,\n\t\t\t\t\t\t\tnow: new Date(),\n\t\t\t\t\t\t\tauditEnabled: config.audit?.enabled === true,\n\t\t\t\t\t\t});\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tsurvivorId: survivor.id,\n\t\t\t\t\t\t\tsupersededCount: result.supersededIds.length,\n\t\t\t\t\t\t\tsupersededIds: result.supersededIds,\n\t\t\t\t\t\t} satisfies ConsolidateResult;\n\t\t\t\t\t},\n\t\t\t\t\t(result) => ({ count: result.supersededCount }),\n\t\t\t\t);\n\t\t\t},\n\t\t},\n\t\tasync close() {\n\t\t\treturn observe(config, store.backend, \"close\", {}, async () => {\n\t\t\t\tif (!closed) {\n\t\t\t\t\tclosed = true;\n\t\t\t\t\tawait store.close();\n\t\t\t\t}\n\t\t\t});\n\t\t},\n\t};\n\n\treturn client;\n}\n","import type {\n\tFindDuplicatesInput,\n\tMemory,\n\tPruneInput,\n\tRecallInput,\n} from \"../types.js\";\nimport { IMPORTANCE_RANK } from \"./defaults.js\";\n\nexport function isExpired(memory: Memory, now: Date): boolean {\n\treturn (\n\t\tmemory.expiresAt !== null && memory.expiresAt.getTime() <= now.getTime()\n\t);\n}\n\n/**\n * Test whether `memory` matches a {@link PruneInput}. All specified\n * selectors are AND-combined; unspecified selectors do not restrict.\n *\n * `now` is supplied by the caller so callers can share a consistent\n * timestamp across a batch.\n */\nexport function matchesPruneFilter(\n\tmemory: Memory,\n\tinput: PruneInput,\n\tnow: Date,\n): boolean {\n\tif (input.entityId !== undefined && memory.entityId !== input.entityId) {\n\t\treturn false;\n\t}\n\tif (input.expired === true && !isExpired(memory, now)) {\n\t\treturn false;\n\t}\n\tif (input.superseded === true && memory.supersededBy === null) {\n\t\treturn false;\n\t}\n\tif (\n\t\tinput.createdBefore !== undefined &&\n\t\tmemory.createdAt.getTime() >= input.createdBefore.getTime()\n\t) {\n\t\treturn false;\n\t}\n\tif (input.notAccessedSince !== undefined) {\n\t\tconst last = memory.lastAccessedAt;\n\t\tif (last !== null && last.getTime() >= input.notAccessedSince.getTime()) {\n\t\t\treturn false;\n\t\t}\n\t}\n\tif (input.types !== undefined && !input.types.includes(memory.type)) {\n\t\treturn false;\n\t}\n\tif (\n\t\tinput.tags !== undefined &&\n\t\tinput.tags.length > 0 &&\n\t\t!input.tags.every((tag) => memory.tags.includes(tag))\n\t) {\n\t\treturn false;\n\t}\n\tif (\n\t\tinput.maxImportance !== undefined &&\n\t\tIMPORTANCE_RANK[memory.importance] > IMPORTANCE_RANK[input.maxImportance]\n\t) {\n\t\treturn false;\n\t}\n\treturn true;\n}\n\n/**\n * Return `true` when a memory should participate in a duplicate scan,\n * given the filters on `input` and a shared `now` timestamp.\n */\nexport function matchesDuplicateFilter(\n\tmemory: Memory,\n\tinput: FindDuplicatesInput,\n\tnow: Date,\n): boolean {\n\tif (memory.entityId !== input.entityId) {\n\t\treturn false;\n\t}\n\tif (input.includeSuperseded !== true && memory.supersededBy !== null) {\n\t\treturn false;\n\t}\n\tif (input.includeExpired !== true && isExpired(memory, now)) {\n\t\treturn false;\n\t}\n\tif (input.types !== undefined && !input.types.includes(memory.type)) {\n\t\treturn false;\n\t}\n\tif (\n\t\tinput.tags !== undefined &&\n\t\tinput.tags.length > 0 &&\n\t\t!input.tags.every((tag) => memory.tags.includes(tag))\n\t) {\n\t\treturn false;\n\t}\n\treturn true;\n}\n\nexport function matchesRecallFilter(\n\tmemory: Memory,\n\tinput: RecallInput,\n\tnow: Date,\n): boolean {\n\tif (memory.entityId !== input.entityId) {\n\t\treturn false;\n\t}\n\tif (!input.includeSuperseded && memory.supersededBy !== null) {\n\t\treturn false;\n\t}\n\tif (!input.includeExpired && isExpired(memory, now)) {\n\t\treturn false;\n\t}\n\tif (input.types && !input.types.includes(memory.type)) {\n\t\treturn false;\n\t}\n\tif (input.tags && !input.tags.every((tag) => memory.tags.includes(tag))) {\n\t\treturn false;\n\t}\n\tif (input.before && memory.createdAt >= input.before) {\n\t\treturn false;\n\t}\n\tif (input.after && memory.createdAt <= input.after) {\n\t\treturn false;\n\t}\n\treturn true;\n}\n","import { cosineSimilarity, createLexicalScorer } from \"../retrieval/scorer.js\";\nimport type {\n\tAuditEvent,\n\tEntityStats,\n\tGlobalStats,\n\tMemory,\n\tMnemocyteClient,\n\tMnemocyteConfig,\n} from \"../types.js\";\nimport { createMemoryClient } from \"./client-core.js\";\nimport {\n\tDEFAULT_AUDIT_LOG_LIMIT,\n\tDEFAULT_DUPLICATE_LIMIT,\n\tDEFAULT_DUPLICATE_THRESHOLD,\n} from \"./defaults.js\";\nimport {\n\tisExpired,\n\tmatchesDuplicateFilter,\n\tmatchesPruneFilter,\n\tmatchesRecallFilter,\n} from \"./filters.js\";\nimport { cloneJsonObject } from \"./json.js\";\nimport { cloneMemory, createEventId, type StoredMemory } from \"./records.js\";\nimport type {\n\tMemoryStore,\n\tStoreConsolidateInput,\n\tStoreConsolidateResult,\n\tStoreDuplicatePair,\n\tStoreLexicalCandidate,\n\tStoreLexicalSearchInput,\n\tStoreVectorCandidate,\n\tStoreVectorSearchInput,\n} from \"./store.js\";\n\nfunction cloneStoredMemory(memory: StoredMemory): StoredMemory {\n\treturn {\n\t\t...cloneMemory(memory),\n\t\tembedding: [...memory.embedding],\n\t};\n}\n\nfunction cloneAuditEvent(event: AuditEvent): AuditEvent {\n\treturn {\n\t\tid: event.id,\n\t\tentityId: event.entityId,\n\t\tdescription: event.description,\n\t\tmetadata: cloneJsonObject(event.metadata),\n\t\ttimestamp: new Date(event.timestamp),\n\t};\n}\n\nexport function createInMemoryStore(): MemoryStore {\n\tconst memories = new Map<string, StoredMemory>();\n\tconst auditLog: AuditEvent[] = [];\n\n\treturn {\n\t\tbackend: \"in-memory\",\n\t\tasync ensureSchema() {},\n\t\tasync ensureEmbeddingCompatibility() {},\n\t\tasync insertMemories(rows) {\n\t\t\tconst inserted: Memory[] = [];\n\t\t\tfor (const row of rows) {\n\t\t\t\tconst stored = cloneStoredMemory(row);\n\t\t\t\tmemories.set(stored.id, stored);\n\t\t\t\tinserted.push(cloneMemory(stored));\n\t\t\t}\n\t\t\treturn inserted;\n\t\t},\n\t\tasync vectorSearch(input: StoreVectorSearchInput) {\n\t\t\tconst now = new Date();\n\t\t\tconst minScore = input.minScore ?? 0;\n\t\t\treturn Array.from(memories.values())\n\t\t\t\t.filter((memory) => matchesRecallFilter(memory, input, now))\n\t\t\t\t.map((memory) => ({\n\t\t\t\t\tmemory: cloneMemory(memory),\n\t\t\t\t\tvectorScore: Math.max(\n\t\t\t\t\t\t0,\n\t\t\t\t\t\tcosineSimilarity(memory.embedding, input.embedding),\n\t\t\t\t\t),\n\t\t\t\t}))\n\t\t\t\t.filter((candidate) => candidate.vectorScore >= minScore)\n\t\t\t\t.sort((a, b) => b.vectorScore - a.vectorScore)\n\t\t\t\t.slice(0, input.limit) satisfies StoreVectorCandidate[];\n\t\t},\n\t\tasync lexicalSearch(input: StoreLexicalSearchInput) {\n\t\t\tconst now = new Date();\n\t\t\tconst scoreLexical = createLexicalScorer(input.query);\n\t\t\treturn Array.from(memories.values())\n\t\t\t\t.filter((memory) => matchesRecallFilter(memory, input, now))\n\t\t\t\t.map((memory) => ({\n\t\t\t\t\tmemory: cloneMemory(memory),\n\t\t\t\t\tlexicalScore: scoreLexical(memory.content),\n\t\t\t\t}))\n\t\t\t\t.filter((candidate) => candidate.lexicalScore > 0)\n\t\t\t\t.sort((a, b) => b.lexicalScore - a.lexicalScore)\n\t\t\t\t.slice(0, input.limit) satisfies StoreLexicalCandidate[];\n\t\t},\n\t\tasync getMemoryEmbeddings(memoryIds) {\n\t\t\tconst result = new Map<string, number[]>();\n\t\t\tfor (const id of memoryIds) {\n\t\t\t\tconst memory = memories.get(id);\n\t\t\t\tif (memory) {\n\t\t\t\t\tresult.set(id, [...memory.embedding]);\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn result;\n\t\t},\n\t\tasync markMemoriesAccessed(memoryIds) {\n\t\t\tconst now = new Date();\n\t\t\tfor (const id of memoryIds) {\n\t\t\t\tconst memory = memories.get(id);\n\t\t\t\tif (memory) {\n\t\t\t\t\tmemory.lastAccessedAt = now;\n\t\t\t\t\tmemory.accessCount += 1;\n\t\t\t\t\tmemory.updatedAt = now;\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\tasync deleteMemory(entityId, memoryId) {\n\t\t\tconst memory = memories.get(memoryId);\n\t\t\tif (!memory || memory.entityId !== entityId) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\treturn memories.delete(memoryId);\n\t\t},\n\t\tasync deleteMemoriesForEntity(entityId) {\n\t\t\tlet deleted = 0;\n\t\t\tfor (const [id, memory] of memories) {\n\t\t\t\tif (memory.entityId === entityId) {\n\t\t\t\t\tmemories.delete(id);\n\t\t\t\t\tdeleted += 1;\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn deleted;\n\t\t},\n\t\tasync prune(input) {\n\t\t\tconst now = new Date();\n\t\t\tconst matched: string[] = [];\n\t\t\tfor (const memory of memories.values()) {\n\t\t\t\tif (matchesPruneFilter(memory, input, now)) {\n\t\t\t\t\tmatched.push(memory.id);\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst dryRun = input.dryRun === true;\n\t\t\tif (!dryRun) {\n\t\t\t\tfor (const id of matched) {\n\t\t\t\t\tmemories.delete(id);\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tmatchedCount: matched.length,\n\t\t\t\tdeletedCount: dryRun ? 0 : matched.length,\n\t\t\t\tdryRun,\n\t\t\t};\n\t\t},\n\t\tasync findDuplicatePairs(input) {\n\t\t\tconst threshold = input.threshold ?? DEFAULT_DUPLICATE_THRESHOLD;\n\t\t\tconst limit = input.limit ?? DEFAULT_DUPLICATE_LIMIT;\n\t\t\tconst now = new Date();\n\t\t\tconst candidates = Array.from(memories.values()).filter((memory) =>\n\t\t\t\tmatchesDuplicateFilter(memory, input, now),\n\t\t\t);\n\t\t\tconst pairs: StoreDuplicatePair[] = [];\n\t\t\tfor (let i = 0; i < candidates.length; i += 1) {\n\t\t\t\tconst a = candidates[i];\n\t\t\t\tif (a === undefined) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tfor (let j = i + 1; j < candidates.length; j += 1) {\n\t\t\t\t\tconst b = candidates[j];\n\t\t\t\t\tif (b === undefined) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tconst similarity = Math.max(\n\t\t\t\t\t\t0,\n\t\t\t\t\t\tMath.min(1, cosineSimilarity(a.embedding, b.embedding)),\n\t\t\t\t\t);\n\t\t\t\t\tif (similarity >= threshold) {\n\t\t\t\t\t\tpairs.push({\n\t\t\t\t\t\t\ta: cloneMemory(a),\n\t\t\t\t\t\t\tb: cloneMemory(b),\n\t\t\t\t\t\t\tsimilarity,\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\tpairs.sort((x, y) => y.similarity - x.similarity);\n\t\t\treturn pairs.slice(0, limit);\n\t\t},\n\t\tasync addAuditEvents(events) {\n\t\t\tauditLog.push(...events.map(cloneAuditEvent));\n\t\t},\n\t\tasync listAuditLog(input) {\n\t\t\tconst limit = input.limit ?? DEFAULT_AUDIT_LOG_LIMIT;\n\t\t\tconst indexed = auditLog.map((event, idx) => ({ event, idx }));\n\t\t\treturn indexed\n\t\t\t\t.filter(({ event }) => {\n\t\t\t\t\tif (event.entityId !== input.entityId) {\n\t\t\t\t\t\treturn false;\n\t\t\t\t\t}\n\t\t\t\t\tif (\n\t\t\t\t\t\tinput.before !== undefined &&\n\t\t\t\t\t\tevent.timestamp.getTime() >= input.before.getTime()\n\t\t\t\t\t) {\n\t\t\t\t\t\treturn false;\n\t\t\t\t\t}\n\t\t\t\t\tif (\n\t\t\t\t\t\tinput.after !== undefined &&\n\t\t\t\t\t\tevent.timestamp.getTime() <= input.after.getTime()\n\t\t\t\t\t) {\n\t\t\t\t\t\treturn false;\n\t\t\t\t\t}\n\t\t\t\t\treturn true;\n\t\t\t\t})\n\t\t\t\t.sort((a, b) => {\n\t\t\t\t\tconst dt = b.event.timestamp.getTime() - a.event.timestamp.getTime();\n\t\t\t\t\treturn dt === 0 ? b.idx - a.idx : dt;\n\t\t\t\t})\n\t\t\t\t.slice(0, limit)\n\t\t\t\t.map(({ event }) => cloneAuditEvent(event));\n\t\t},\n\t\tasync getMemory(entityId, memoryId) {\n\t\t\tconst memory = memories.get(memoryId);\n\t\t\treturn memory && memory.entityId === entityId\n\t\t\t\t? cloneMemory(memory)\n\t\t\t\t: null;\n\t\t},\n\t\tasync loadConsolidationTargets(entityId, ids) {\n\t\t\treturn ids.flatMap((id) => {\n\t\t\t\tconst memory = memories.get(id);\n\t\t\t\tif (!memory || memory.entityId !== entityId) {\n\t\t\t\t\treturn [];\n\t\t\t\t}\n\t\t\t\treturn [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: memory.id,\n\t\t\t\t\t\ttags: [...memory.tags],\n\t\t\t\t\t\tsupersededBy: memory.supersededBy,\n\t\t\t\t\t},\n\t\t\t\t];\n\t\t\t});\n\t\t},\n\t\tasync consolidate(\n\t\t\tinput: StoreConsolidateInput,\n\t\t): Promise<StoreConsolidateResult> {\n\t\t\tconst survivor = memories.get(input.survivorId);\n\t\t\tconst newlySuperseded: string[] = [];\n\t\t\tfor (const id of input.supersededIds) {\n\t\t\t\tconst memory = memories.get(id);\n\t\t\t\tif (!memory || memory.entityId !== input.entityId) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tif (memory.supersededBy !== null) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tmemory.supersededBy = input.survivorId;\n\t\t\t\tmemory.supersededAt = input.now;\n\t\t\t\tmemory.updatedAt = input.now;\n\t\t\t\tnewlySuperseded.push(memory.id);\n\t\t\t}\n\t\t\tif (survivor && input.mergeTags && newlySuperseded.length > 0) {\n\t\t\t\tconst mergedTags = new Set(input.survivorTags);\n\t\t\t\tfor (const id of newlySuperseded) {\n\t\t\t\t\tconst memory = memories.get(id);\n\t\t\t\t\tif (memory) {\n\t\t\t\t\t\tfor (const tag of memory.tags) {\n\t\t\t\t\t\t\tmergedTags.add(tag);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tif (mergedTags.size !== survivor.tags.length) {\n\t\t\t\t\tsurvivor.tags = [...mergedTags];\n\t\t\t\t\tsurvivor.updatedAt = input.now;\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (input.auditEnabled) {\n\t\t\t\tfor (const id of newlySuperseded) {\n\t\t\t\t\tauditLog.push({\n\t\t\t\t\t\tid: createEventId(),\n\t\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\t\tdescription: \"memory.superseded\",\n\t\t\t\t\t\tmetadata: { memoryId: id, supersededBy: input.survivorId },\n\t\t\t\t\t\ttimestamp: input.now,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn { supersededIds: newlySuperseded };\n\t\t},\n\t\tasync stats(input, now) {\n\t\t\tconst allMemories = Array.from(memories.values());\n\t\t\tconst selected = input?.entityId\n\t\t\t\t? allMemories.filter((memory) => memory.entityId === input.entityId)\n\t\t\t\t: allMemories;\n\t\t\tconst activeMemoryCount = selected.filter(\n\t\t\t\t(memory) => !isExpired(memory, now) && memory.supersededBy === null,\n\t\t\t).length;\n\t\t\tconst expiredMemoryCount = selected.filter((memory) =>\n\t\t\t\tisExpired(memory, now),\n\t\t\t).length;\n\t\t\tconst supersededMemoryCount = selected.filter(\n\t\t\t\t(memory) => memory.supersededBy !== null,\n\t\t\t).length;\n\t\t\tif (input?.entityId) {\n\t\t\t\treturn {\n\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\tmemoryCount: selected.length,\n\t\t\t\t\tactiveMemoryCount,\n\t\t\t\t\texpiredMemoryCount,\n\t\t\t\t\tsupersededMemoryCount,\n\t\t\t\t} satisfies EntityStats;\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tentityCount: new Set(allMemories.map((memory) => memory.entityId)).size,\n\t\t\t\tmemoryCount: selected.length,\n\t\t\t\tactiveMemoryCount,\n\t\t\t\texpiredMemoryCount,\n\t\t\t\tsupersededMemoryCount,\n\t\t\t} satisfies GlobalStats;\n\t\t},\n\t\tasync close() {\n\t\t\tmemories.clear();\n\t\t\tauditLog.length = 0;\n\t\t},\n\t};\n}\n\nexport function createInMemoryClient(config: MnemocyteConfig): MnemocyteClient {\n\treturn createMemoryClient(config, createInMemoryStore());\n}\n","import { and, desc, eq, gt, lt } from \"drizzle-orm\";\nimport { MnemocyteError } from \"../../errors.js\";\nimport type { MnemocyteDatabase } from \"../index.js\";\nimport { type EventRow, eventsTable, type NewEventRow } from \"../schema.js\";\n\nexport interface EventFilter {\n\tentityId: string;\n\tlimit?: number;\n\tbefore?: Date;\n\tafter?: Date;\n}\n\nexport async function insertEvent(\n\tdb: MnemocyteDatabase,\n\trow: NewEventRow,\n): Promise<EventRow> {\n\tconst result = await db.insert(eventsTable).values(row).returning();\n\tconst inserted = result[0];\n\tif (!inserted) {\n\t\tthrow new MnemocyteError(\"Event insert returned no rows.\", \"DB\");\n\t}\n\treturn inserted;\n}\n\nexport async function listEvents(\n\tdb: MnemocyteDatabase,\n\tfilter: EventFilter,\n): Promise<EventRow[]> {\n\treturn db\n\t\t.select()\n\t\t.from(eventsTable)\n\t\t.where(\n\t\t\tand(\n\t\t\t\teq(eventsTable.entityId, filter.entityId),\n\t\t\t\tfilter.before ? lt(eventsTable.timestamp, filter.before) : undefined,\n\t\t\t\tfilter.after ? gt(eventsTable.timestamp, filter.after) : undefined,\n\t\t\t),\n\t\t)\n\t\t.orderBy(desc(eventsTable.timestamp))\n\t\t.limit(filter.limit ?? 50);\n}\n","import {\n\tand,\n\tcount,\n\tcountDistinct,\n\teq,\n\tinArray,\n\tisNotNull,\n\tisNull,\n\tlt,\n\tor,\n\tsql,\n} from \"drizzle-orm\";\nimport type { ImportanceLevel, MemoryType } from \"../../types.js\";\nimport type { MnemocyteDatabase } from \"../index.js\";\nimport { type MemoryRow, memoriesTable, type NewMemoryRow } from \"../schema.js\";\nimport { formatVectorComponent } from \"../vector.js\";\n\nexport interface MemoryFilter {\n\tentityId: string;\n\ttypes?: readonly MemoryType[];\n\ttags?: readonly string[];\n\tbefore?: Date;\n\tafter?: Date;\n\tincludeSuperseded?: boolean;\n\tincludeExpired?: boolean;\n}\n\nexport interface VectorSearchInput extends MemoryFilter {\n\tembedding: readonly number[];\n\tlimit: number;\n\tminScore?: number;\n}\n\nexport interface LexicalSearchInput extends MemoryFilter {\n\tquery: string;\n\tlimit: number;\n}\n\nexport interface MemoryStatsCounts {\n\tmemoryCount: number;\n\tactiveMemoryCount: number;\n\texpiredMemoryCount: number;\n\tsupersededMemoryCount: number;\n}\n\nexport interface GlobalMemoryStatsCounts extends MemoryStatsCounts {\n\tentityCount: number;\n}\n\nfunction vectorLiteral(embedding: readonly number[]): string {\n\treturn `[${embedding.map(formatVectorComponent).join(\",\")}]`;\n}\n\ntype RawTimestamp = Date | string;\n\nexport type RecallMemoryRow = Omit<\n\tMemoryRow,\n\t| \"embedding\"\n\t| \"supersededAt\"\n\t| \"expiresAt\"\n\t| \"lastAccessedAt\"\n\t| \"createdAt\"\n\t| \"updatedAt\"\n> & {\n\tsupersededAt: RawTimestamp | null;\n\texpiresAt: RawTimestamp | null;\n\tlastAccessedAt: RawTimestamp | null;\n\tcreatedAt: RawTimestamp;\n\tupdatedAt: RawTimestamp;\n};\n\nexport type VectorSearchRow = RecallMemoryRow & { vectorScore: number };\n\nexport type LexicalSearchRow = RecallMemoryRow & { lexicalScore: number };\n\nfunction timestampParam(value: Date) {\n\treturn sql`${value.toISOString()}::timestamptz`;\n}\n\nfunction textArrayLiteral(values: readonly string[]) {\n\treturn sql`ARRAY[${sql.join(\n\t\tvalues.map((value) => sql`${value}`),\n\t\tsql`, `,\n\t)}]::text[]`;\n}\n\nfunction tagsContainAll(tags: readonly string[] | undefined) {\n\treturn tags && tags.length > 0\n\t\t? sql`${memoriesTable.tags} @> ${textArrayLiteral(tags)}`\n\t\t: undefined;\n}\n\nfunction rawTagsFilter(tags: readonly string[] | undefined) {\n\treturn tags && tags.length > 0\n\t\t? sql`AND tags @> ${textArrayLiteral(tags)}`\n\t\t: sql``;\n}\n\nfunction duplicateTagsFilter(tags: readonly string[] | undefined) {\n\treturn tags && tags.length > 0\n\t\t? sql`AND a.tags @> ${textArrayLiteral(tags)} AND b.tags @> ${textArrayLiteral(tags)}`\n\t\t: sql``;\n}\n\nfunction memoryStatsCountFields(now: Date) {\n\treturn {\n\t\tmemoryCount: count(),\n\t\tactiveMemoryCount: sql<number>`\n\t\t\t(count(*) FILTER (\n\t\t\t\tWHERE ${memoriesTable.supersededBy} IS NULL\n\t\t\t\t\tAND (${memoriesTable.expiresAt} IS NULL OR ${memoriesTable.expiresAt} > ${timestampParam(now)})\n\t\t\t))::int\n\t\t`.mapWith(Number),\n\t\texpiredMemoryCount: sql<number>`\n\t\t\t(count(*) FILTER (\n\t\t\t\tWHERE ${memoriesTable.expiresAt} IS NOT NULL\n\t\t\t\t\tAND ${memoriesTable.expiresAt} <= ${timestampParam(now)}\n\t\t\t))::int\n\t\t`.mapWith(Number),\n\t\tsupersededMemoryCount:\n\t\t\tsql<number>`(count(*) FILTER (WHERE ${memoriesTable.supersededBy} IS NOT NULL))::int`.mapWith(\n\t\t\t\tNumber,\n\t\t\t),\n\t};\n}\n\nfunction emptyMemoryStatsCounts(): MemoryStatsCounts {\n\treturn {\n\t\tmemoryCount: 0,\n\t\tactiveMemoryCount: 0,\n\t\texpiredMemoryCount: 0,\n\t\tsupersededMemoryCount: 0,\n\t};\n}\n\nexport async function insertMemories(\n\tdb: MnemocyteDatabase,\n\trows: NewMemoryRow[],\n): Promise<MemoryRow[]> {\n\tif (rows.length === 0) {\n\t\treturn [];\n\t}\n\treturn db.insert(memoriesTable).values(rows).returning();\n}\n\nexport async function getMemoryById(\n\tdb: MnemocyteDatabase,\n\tentityId: string,\n\tmemoryId: string,\n): Promise<MemoryRow | null> {\n\tconst result = await db\n\t\t.select()\n\t\t.from(memoriesTable)\n\t\t.where(\n\t\t\tand(eq(memoriesTable.entityId, entityId), eq(memoriesTable.id, memoryId)),\n\t\t)\n\t\t.limit(1);\n\treturn result[0] ?? null;\n}\n\nexport async function getEntityMemoryStatsCounts(\n\tdb: MnemocyteDatabase,\n\tentityId: string,\n\tnow: Date,\n): Promise<MemoryStatsCounts> {\n\tconst rows = await db\n\t\t.select(memoryStatsCountFields(now))\n\t\t.from(memoriesTable)\n\t\t.where(eq(memoriesTable.entityId, entityId));\n\treturn rows[0] ?? emptyMemoryStatsCounts();\n}\n\nexport async function getGlobalMemoryStatsCounts(\n\tdb: MnemocyteDatabase,\n\tnow: Date,\n): Promise<GlobalMemoryStatsCounts> {\n\tconst rows = await db\n\t\t.select({\n\t\t\tentityCount: countDistinct(memoriesTable.entityId),\n\t\t\t...memoryStatsCountFields(now),\n\t\t})\n\t\t.from(memoriesTable);\n\treturn rows[0] ?? { entityCount: 0, ...emptyMemoryStatsCounts() };\n}\n\nexport async function deleteMemory(\n\tdb: MnemocyteDatabase,\n\tentityId: string,\n\tmemoryId: string,\n): Promise<boolean> {\n\tconst result = await db\n\t\t.delete(memoriesTable)\n\t\t.where(\n\t\t\tand(eq(memoriesTable.entityId, entityId), eq(memoriesTable.id, memoryId)),\n\t\t)\n\t\t.returning({ id: memoriesTable.id });\n\treturn result.length > 0;\n}\n\nexport async function deleteMemoriesForEntity(\n\tdb: MnemocyteDatabase,\n\tentityId: string,\n): Promise<number> {\n\tconst result = await db\n\t\t.delete(memoriesTable)\n\t\t.where(eq(memoriesTable.entityId, entityId))\n\t\t.returning({ id: memoriesTable.id });\n\treturn result.length;\n}\n\nexport interface PruneFilter {\n\tentityId?: string;\n\texpired?: boolean;\n\tsuperseded?: boolean;\n\tcreatedBefore?: Date;\n\tnotAccessedSince?: Date;\n\ttypes?: readonly MemoryType[];\n\ttags?: readonly string[];\n\tmaxImportanceLevels?: readonly ImportanceLevel[];\n}\n\nfunction pruneConditions(filter: PruneFilter) {\n\treturn and(\n\t\tfilter.entityId !== undefined\n\t\t\t? eq(memoriesTable.entityId, filter.entityId)\n\t\t\t: undefined,\n\t\tfilter.expired\n\t\t\t? and(\n\t\t\t\t\tisNotNull(memoriesTable.expiresAt),\n\t\t\t\t\tsql`${memoriesTable.expiresAt} <= now()`,\n\t\t\t\t)\n\t\t\t: undefined,\n\t\tfilter.superseded ? isNotNull(memoriesTable.supersededBy) : undefined,\n\t\tfilter.createdBefore\n\t\t\t? lt(memoriesTable.createdAt, filter.createdBefore)\n\t\t\t: undefined,\n\t\tfilter.notAccessedSince\n\t\t\t? or(\n\t\t\t\t\tisNull(memoriesTable.lastAccessedAt),\n\t\t\t\t\tlt(memoriesTable.lastAccessedAt, filter.notAccessedSince),\n\t\t\t\t)\n\t\t\t: undefined,\n\t\tfilter.types && filter.types.length > 0\n\t\t\t? inArray(memoriesTable.type, [...filter.types])\n\t\t\t: undefined,\n\t\ttagsContainAll(filter.tags),\n\t\tfilter.maxImportanceLevels && filter.maxImportanceLevels.length > 0\n\t\t\t? inArray(memoriesTable.importance, [...filter.maxImportanceLevels])\n\t\t\t: undefined,\n\t);\n}\n\nexport async function countPruneMatches(\n\tdb: MnemocyteDatabase,\n\tfilter: PruneFilter,\n): Promise<number> {\n\treturn db.$count(memoriesTable, pruneConditions(filter));\n}\n\nexport async function pruneMemories(\n\tdb: MnemocyteDatabase,\n\tfilter: PruneFilter,\n): Promise<number> {\n\tconst result = await db\n\t\t.delete(memoriesTable)\n\t\t.where(pruneConditions(filter))\n\t\t.returning({ id: memoriesTable.id });\n\treturn result.length;\n}\n\nexport interface DuplicateSearchInput {\n\tentityId: string;\n\tthreshold: number;\n\tlimit: number;\n\ttypes?: readonly string[];\n\ttags?: readonly string[];\n\tincludeSuperseded?: boolean;\n\tincludeExpired?: boolean;\n}\n\nexport async function findDuplicatePairs(\n\tdb: MnemocyteDatabase,\n\tinput: DuplicateSearchInput,\n): Promise<Array<{ a: MemoryRow; b: MemoryRow; similarity: number }>> {\n\tconst rows = await db.execute(sql`\n\t\tSELECT\n\t\t\ta.id AS \"aId\",\n\t\t\ta.entity_id AS \"aEntityId\",\n\t\t\ta.content AS \"aContent\",\n\t\t\ta.type AS \"aType\",\n\t\t\ta.importance AS \"aImportance\",\n\t\t\ta.tags AS \"aTags\",\n\t\t\ta.source AS \"aSource\",\n\t\t\ta.metadata AS \"aMetadata\",\n\t\t\ta.confidence AS \"aConfidence\",\n\t\t\ta.embedding AS \"aEmbedding\",\n\t\t\ta.embedding_model AS \"aEmbeddingModel\",\n\t\t\ta.embedding_dimensions AS \"aEmbeddingDimensions\",\n\t\t\ta.superseded_by AS \"aSupersededBy\",\n\t\t\ta.superseded_at AS \"aSupersededAt\",\n\t\t\ta.expires_at AS \"aExpiresAt\",\n\t\t\ta.last_accessed_at AS \"aLastAccessedAt\",\n\t\t\ta.access_count AS \"aAccessCount\",\n\t\t\ta.created_at AS \"aCreatedAt\",\n\t\t\ta.updated_at AS \"aUpdatedAt\",\n\t\t\tb.id AS \"bId\",\n\t\t\tb.entity_id AS \"bEntityId\",\n\t\t\tb.content AS \"bContent\",\n\t\t\tb.type AS \"bType\",\n\t\t\tb.importance AS \"bImportance\",\n\t\t\tb.tags AS \"bTags\",\n\t\t\tb.source AS \"bSource\",\n\t\t\tb.metadata AS \"bMetadata\",\n\t\t\tb.confidence AS \"bConfidence\",\n\t\t\tb.embedding AS \"bEmbedding\",\n\t\t\tb.embedding_model AS \"bEmbeddingModel\",\n\t\t\tb.embedding_dimensions AS \"bEmbeddingDimensions\",\n\t\t\tb.superseded_by AS \"bSupersededBy\",\n\t\t\tb.superseded_at AS \"bSupersededAt\",\n\t\t\tb.expires_at AS \"bExpiresAt\",\n\t\t\tb.last_accessed_at AS \"bLastAccessedAt\",\n\t\t\tb.access_count AS \"bAccessCount\",\n\t\t\tb.created_at AS \"bCreatedAt\",\n\t\t\tb.updated_at AS \"bUpdatedAt\",\n\t\t\t1 - (a.embedding <=> b.embedding) AS \"similarity\"\n\t\tFROM mnemocyte_memories a\n\t\tJOIN mnemocyte_memories b\n\t\t\tON b.entity_id = a.entity_id\n\t\t\tAND a.id < b.id\n\t\t\tAND a.embedding IS NOT NULL\n\t\t\tAND b.embedding IS NOT NULL\n\t\tWHERE\n\t\t\ta.entity_id = ${input.entityId}\n\t\t\t${input.includeSuperseded ? sql`` : sql`AND a.superseded_by IS NULL AND b.superseded_by IS NULL`}\n\t\t\t${input.includeExpired ? sql`` : sql`AND (a.expires_at IS NULL OR a.expires_at > now()) AND (b.expires_at IS NULL OR b.expires_at > now())`}\n\t\t\t${\n\t\t\t\tinput.types && input.types.length > 0\n\t\t\t\t\t? sql`AND a.type IN (${sql.join(\n\t\t\t\t\t\t\tinput.types.map((type) => sql`${type}`),\n\t\t\t\t\t\t\tsql`, `,\n\t\t\t\t\t\t)}) AND b.type IN (${sql.join(\n\t\t\t\t\t\t\tinput.types.map((type) => sql`${type}`),\n\t\t\t\t\t\t\tsql`, `,\n\t\t\t\t\t\t)})`\n\t\t\t\t\t: sql``\n\t\t\t}\n\t\t\t${duplicateTagsFilter(input.tags)}\n\t\t\tAND 1 - (a.embedding <=> b.embedding) >= ${input.threshold}\n\t\tORDER BY \"similarity\" DESC\n\t\tLIMIT ${input.limit}\n\t`);\n\tconst records = rows as unknown as Array<Record<string, unknown>>;\n\treturn records.map((row) => {\n\t\tconst a = {\n\t\t\tid: row.aId,\n\t\t\tentityId: row.aEntityId,\n\t\t\tcontent: row.aContent,\n\t\t\ttype: row.aType,\n\t\t\timportance: row.aImportance,\n\t\t\ttags: row.aTags,\n\t\t\tsource: row.aSource,\n\t\t\tmetadata: row.aMetadata,\n\t\t\tconfidence: row.aConfidence,\n\t\t\tembedding: row.aEmbedding,\n\t\t\tembeddingModel: row.aEmbeddingModel,\n\t\t\tembeddingDimensions: row.aEmbeddingDimensions,\n\t\t\tsupersededBy: row.aSupersededBy,\n\t\t\tsupersededAt: row.aSupersededAt,\n\t\t\texpiresAt: row.aExpiresAt,\n\t\t\tlastAccessedAt: row.aLastAccessedAt,\n\t\t\taccessCount: row.aAccessCount,\n\t\t\tcreatedAt: row.aCreatedAt,\n\t\t\tupdatedAt: row.aUpdatedAt,\n\t\t} as unknown as MemoryRow;\n\t\tconst b = {\n\t\t\tid: row.bId,\n\t\t\tentityId: row.bEntityId,\n\t\t\tcontent: row.bContent,\n\t\t\ttype: row.bType,\n\t\t\timportance: row.bImportance,\n\t\t\ttags: row.bTags,\n\t\t\tsource: row.bSource,\n\t\t\tmetadata: row.bMetadata,\n\t\t\tconfidence: row.bConfidence,\n\t\t\tembedding: row.bEmbedding,\n\t\t\tembeddingModel: row.bEmbeddingModel,\n\t\t\tembeddingDimensions: row.bEmbeddingDimensions,\n\t\t\tsupersededBy: row.bSupersededBy,\n\t\t\tsupersededAt: row.bSupersededAt,\n\t\t\texpiresAt: row.bExpiresAt,\n\t\t\tlastAccessedAt: row.bLastAccessedAt,\n\t\t\taccessCount: row.bAccessCount,\n\t\t\tcreatedAt: row.bCreatedAt,\n\t\t\tupdatedAt: row.bUpdatedAt,\n\t\t} as unknown as MemoryRow;\n\t\treturn {\n\t\t\ta,\n\t\t\tb,\n\t\t\tsimilarity: Number(row.similarity) || 0,\n\t\t};\n\t});\n}\n\nexport interface SupersedeRow {\n\tid: string;\n\ttags: string[];\n}\n\nexport async function loadConsolidationTargets(\n\tdb: MnemocyteDatabase,\n\tentityId: string,\n\tids: readonly string[],\n): Promise<Array<{ id: string; tags: string[]; supersededBy: string | null }>> {\n\tif (ids.length === 0) {\n\t\treturn [];\n\t}\n\tconst rows = await db\n\t\t.select({\n\t\t\tid: memoriesTable.id,\n\t\t\ttags: memoriesTable.tags,\n\t\t\tsupersededBy: memoriesTable.supersededBy,\n\t\t})\n\t\t.from(memoriesTable)\n\t\t.where(\n\t\t\tand(\n\t\t\t\teq(memoriesTable.entityId, entityId),\n\t\t\t\tinArray(memoriesTable.id, [...ids]),\n\t\t\t),\n\t\t);\n\treturn rows;\n}\n\nexport async function markMemoriesSuperseded(\n\tdb: MnemocyteDatabase,\n\tparams: {\n\t\tsurvivorId: string;\n\t\tentityId: string;\n\t\tids: readonly string[];\n\t\tnow: Date;\n\t},\n): Promise<SupersedeRow[]> {\n\tif (params.ids.length === 0) {\n\t\treturn [];\n\t}\n\tconst result = await db\n\t\t.update(memoriesTable)\n\t\t.set({\n\t\t\tsupersededBy: params.survivorId,\n\t\t\tsupersededAt: params.now,\n\t\t\tupdatedAt: params.now,\n\t\t})\n\t\t.where(\n\t\t\tand(\n\t\t\t\teq(memoriesTable.entityId, params.entityId),\n\t\t\t\tinArray(memoriesTable.id, [...params.ids]),\n\t\t\t\tisNull(memoriesTable.supersededBy),\n\t\t\t),\n\t\t)\n\t\t.returning({ id: memoriesTable.id, tags: memoriesTable.tags });\n\treturn result;\n}\n\nexport async function setMemoryTags(\n\tdb: MnemocyteDatabase,\n\tparams: {\n\t\tentityId: string;\n\t\tmemoryId: string;\n\t\ttags: readonly string[];\n\t\tnow: Date;\n\t},\n): Promise<void> {\n\tawait db\n\t\t.update(memoriesTable)\n\t\t.set({ tags: [...params.tags], updatedAt: params.now })\n\t\t.where(\n\t\t\tand(\n\t\t\t\teq(memoriesTable.entityId, params.entityId),\n\t\t\t\teq(memoriesTable.id, params.memoryId),\n\t\t\t),\n\t\t);\n}\n\nexport async function markMemoriesAccessed(\n\tdb: MnemocyteDatabase,\n\tmemoryIds: readonly string[],\n): Promise<void> {\n\tconst now = new Date();\n\tif (memoryIds.length === 0) {\n\t\treturn;\n\t}\n\tawait db\n\t\t.update(memoriesTable)\n\t\t.set({\n\t\t\tlastAccessedAt: now,\n\t\t\taccessCount: sql`${memoriesTable.accessCount} + 1`,\n\t\t\tupdatedAt: now,\n\t\t})\n\t\t.where(inArray(memoriesTable.id, [...memoryIds]));\n}\n\nexport async function getMemoryEmbeddings(\n\tdb: MnemocyteDatabase,\n\tmemoryIds: readonly string[],\n): Promise<Map<string, number[]>> {\n\tif (memoryIds.length === 0) {\n\t\treturn new Map();\n\t}\n\tconst rows = await db\n\t\t.select({\n\t\t\tid: memoriesTable.id,\n\t\t\tembedding: memoriesTable.embedding,\n\t\t})\n\t\t.from(memoriesTable)\n\t\t.where(inArray(memoriesTable.id, [...memoryIds]));\n\treturn new Map(\n\t\trows.flatMap((row) => (row.embedding ? [[row.id, row.embedding]] : [])),\n\t);\n}\n\nexport async function vectorSearch(\n\tdb: MnemocyteDatabase,\n\tinput: VectorSearchInput,\n): Promise<VectorSearchRow[]> {\n\tconst embedding = vectorLiteral(input.embedding);\n\tconst minScore = input.minScore ?? 0;\n\tconst rows = await db.execute(sql`\n\t\tSELECT\n\t\t\tid,\n\t\t\tentity_id AS \"entityId\",\n\t\t\tcontent,\n\t\t\ttype,\n\t\t\timportance,\n\t\t\ttags,\n\t\t\tsource,\n\t\t\tmetadata,\n\t\t\tconfidence,\n\t\t\tembedding_model AS \"embeddingModel\",\n\t\t\tembedding_dimensions AS \"embeddingDimensions\",\n\t\t\tsuperseded_by AS \"supersededBy\",\n\t\t\tsuperseded_at AS \"supersededAt\",\n\t\t\texpires_at AS \"expiresAt\",\n\t\t\tlast_accessed_at AS \"lastAccessedAt\",\n\t\t\taccess_count AS \"accessCount\",\n\t\t\tcreated_at AS \"createdAt\",\n\t\t\tupdated_at AS \"updatedAt\",\n\t\t\t1 - (embedding <=> ${embedding}::vector) AS \"vectorScore\"\n\t\tFROM mnemocyte_memories\n\t\tWHERE\n\t\t\tentity_id = ${input.entityId}\n\t\t\tAND embedding IS NOT NULL\n\t\t\t${input.includeSuperseded ? sql`` : sql`AND superseded_by IS NULL`}\n\t\t\t${input.includeExpired ? sql`` : sql`AND (expires_at IS NULL OR expires_at > now())`}\n\t\t\t${\n\t\t\t\tinput.types && input.types.length > 0\n\t\t\t\t\t? sql`AND type IN (${sql.join(\n\t\t\t\t\t\t\tinput.types.map((type) => sql`${type}`),\n\t\t\t\t\t\t\tsql`, `,\n\t\t\t\t\t\t)})`\n\t\t\t\t\t: sql``\n\t\t\t}\n\t\t\t${rawTagsFilter(input.tags)}\n\t\t\t${input.before ? sql`AND created_at < ${timestampParam(input.before)}` : sql``}\n\t\t\t${input.after ? sql`AND created_at > ${timestampParam(input.after)}` : sql``}\n\t\t\tAND 1 - (embedding <=> ${embedding}::vector) >= ${minScore}\n\t\tORDER BY embedding <=> ${embedding}::vector\n\t\tLIMIT ${input.limit}\n\t`);\n\treturn rows as unknown as VectorSearchRow[];\n}\n\nexport async function lexicalSearch(\n\tdb: MnemocyteDatabase,\n\tinput: LexicalSearchInput,\n): Promise<LexicalSearchRow[]> {\n\tconst rows = await db.execute(sql`\n\t\tSELECT\n\t\t\tid,\n\t\t\tentity_id AS \"entityId\",\n\t\t\tcontent,\n\t\t\ttype,\n\t\t\timportance,\n\t\t\ttags,\n\t\t\tsource,\n\t\t\tmetadata,\n\t\t\tconfidence,\n\t\t\tembedding_model AS \"embeddingModel\",\n\t\t\tembedding_dimensions AS \"embeddingDimensions\",\n\t\t\tsuperseded_by AS \"supersededBy\",\n\t\t\tsuperseded_at AS \"supersededAt\",\n\t\t\texpires_at AS \"expiresAt\",\n\t\t\tlast_accessed_at AS \"lastAccessedAt\",\n\t\t\taccess_count AS \"accessCount\",\n\t\t\tcreated_at AS \"createdAt\",\n\t\t\tupdated_at AS \"updatedAt\",\n\t\t\tts_rank(to_tsvector('english', content), websearch_to_tsquery('english', ${input.query})) AS \"lexicalScore\"\n\t\tFROM mnemocyte_memories\n\t\tWHERE\n\t\t\tentity_id = ${input.entityId}\n\t\t\t${input.includeSuperseded ? sql`` : sql`AND superseded_by IS NULL`}\n\t\t\t${input.includeExpired ? sql`` : sql`AND (expires_at IS NULL OR expires_at > now())`}\n\t\t\t${\n\t\t\t\tinput.types && input.types.length > 0\n\t\t\t\t\t? sql`AND type IN (${sql.join(\n\t\t\t\t\t\t\tinput.types.map((type) => sql`${type}`),\n\t\t\t\t\t\t\tsql`, `,\n\t\t\t\t\t\t)})`\n\t\t\t\t\t: sql``\n\t\t\t}\n\t\t\t${rawTagsFilter(input.tags)}\n\t\t\t${input.before ? sql`AND created_at < ${timestampParam(input.before)}` : sql``}\n\t\t\t${input.after ? sql`AND created_at > ${timestampParam(input.after)}` : sql``}\n\t\t\tAND to_tsvector('english', content) @@ websearch_to_tsquery('english', ${input.query})\n\t\tORDER BY \"lexicalScore\" DESC\n\t\tLIMIT ${input.limit}\n\t`);\n\treturn rows as unknown as LexicalSearchRow[];\n}\n","import { eq } from \"drizzle-orm\";\nimport type { MnemocyteDatabase } from \"../index.js\";\nimport { type MetaRow, metaTable } from \"../schema.js\";\n\nexport const INSTALLATION_META_KEY = \"installation\";\n\nexport async function getInstallationMeta(\n\tdb: MnemocyteDatabase,\n): Promise<MetaRow | null> {\n\tconst rows = await db\n\t\t.select()\n\t\t.from(metaTable)\n\t\t.where(eq(metaTable.key, INSTALLATION_META_KEY))\n\t\t.limit(1);\n\treturn rows[0] ?? null;\n}\n","import type { MemoryRow } from \"../db/schema.js\";\nimport type { ImportanceLevel, Memory, MemoryType } from \"../types.js\";\nimport { cloneJsonObject } from \"./json.js\";\n\ntype MemoryRowTimestamp = Date | string;\n\ntype MemoryLikeRow = Omit<\n\tMemoryRow,\n\t| \"embedding\"\n\t| \"supersededAt\"\n\t| \"expiresAt\"\n\t| \"lastAccessedAt\"\n\t| \"createdAt\"\n\t| \"updatedAt\"\n> & {\n\tsupersededAt: MemoryRowTimestamp | null;\n\texpiresAt: MemoryRowTimestamp | null;\n\tlastAccessedAt: MemoryRowTimestamp | null;\n\tcreatedAt: MemoryRowTimestamp;\n\tupdatedAt: MemoryRowTimestamp;\n};\n\nfunction toDate(value: MemoryRowTimestamp): Date {\n\treturn value instanceof Date ? value : new Date(value);\n}\n\nfunction toNullableDate(value: MemoryRowTimestamp | null): Date | null {\n\treturn value === null ? null : toDate(value);\n}\n\nexport function rowToMemory(row: MemoryLikeRow): Memory {\n\treturn {\n\t\tid: row.id,\n\t\tentityId: row.entityId,\n\t\tcontent: row.content,\n\t\ttype: row.type as MemoryType,\n\t\timportance: row.importance as ImportanceLevel,\n\t\ttags: row.tags,\n\t\tsource: row.source,\n\t\tmetadata: cloneJsonObject(row.metadata),\n\t\tconfidence: row.confidence,\n\t\tembeddingModel: row.embeddingModel,\n\t\tembeddingDimensions: row.embeddingDimensions,\n\t\tsupersededBy: row.supersededBy,\n\t\tsupersededAt: toNullableDate(row.supersededAt),\n\t\texpiresAt: toNullableDate(row.expiresAt),\n\t\tlastAccessedAt: toNullableDate(row.lastAccessedAt),\n\t\taccessCount: row.accessCount,\n\t\tcreatedAt: toDate(row.createdAt),\n\t\tupdatedAt: toDate(row.updatedAt),\n\t};\n}\n","import type { DatabaseHandle } from \"../db/index.js\";\nimport { insertEvent, listEvents } from \"../db/queries/events.js\";\nimport {\n\tcountPruneMatches,\n\tdeleteMemoriesForEntity as deleteMemoriesForEntityQuery,\n\tdeleteMemory as deleteMemoryQuery,\n\tfindDuplicatePairs as findDuplicatePairsQuery,\n\tgetEntityMemoryStatsCounts,\n\tgetGlobalMemoryStatsCounts,\n\tgetMemoryById,\n\tgetMemoryEmbeddings as getMemoryEmbeddingsQuery,\n\tinsertMemories as insertMemoryRows,\n\tlexicalSearch as lexicalSearchQuery,\n\tloadConsolidationTargets,\n\tmarkMemoriesAccessed,\n\tmarkMemoriesSuperseded,\n\ttype PruneFilter,\n\tpruneMemories,\n\tsetMemoryTags,\n\tvectorSearch as vectorSearchQuery,\n} from \"../db/queries/memories.js\";\nimport { getInstallationMeta } from \"../db/queries/meta.js\";\nimport type { EventRow, NewMemoryRow } from \"../db/schema.js\";\nimport { MnemocyteError } from \"../errors.js\";\nimport type {\n\tAuditEvent,\n\tEmbedder,\n\tEntityStats,\n\tGlobalStats,\n\tImportanceLevel,\n\tMnemocyteClient,\n\tMnemocyteConfig,\n\tPruneInput,\n} from \"../types.js\";\nimport { createMemoryClient } from \"./client-core.js\";\nimport {\n\tDEFAULT_AUDIT_LOG_LIMIT,\n\tDEFAULT_DUPLICATE_LIMIT,\n\tDEFAULT_DUPLICATE_THRESHOLD,\n\tIMPORTANCE_RANK,\n} from \"./defaults.js\";\nimport { cloneJsonObject } from \"./json.js\";\nimport { rowToMemory } from \"./postgres-records.js\";\nimport { createEventId, type StoredMemory } from \"./records.js\";\nimport type {\n\tMemoryStore,\n\tStoreConsolidateInput,\n\tStoreConsolidateResult,\n\tStoreDuplicatePair,\n\tStoreLexicalCandidate,\n\tStoreLexicalSearchInput,\n\tStoreVectorCandidate,\n\tStoreVectorSearchInput,\n} from \"./store.js\";\n\nconst IMPORTANCE_LEVELS: readonly ImportanceLevel[] = [\n\t\"low\",\n\t\"normal\",\n\t\"high\",\n\t\"critical\",\n];\n\nconst MIGRATION_ERROR_CODES = new Set([\"42P01\", \"42703\", \"42704\", \"42883\"]);\n\nfunction rowToAuditEvent(row: EventRow): AuditEvent {\n\treturn {\n\t\tid: row.id,\n\t\tentityId: row.entityId,\n\t\tdescription: row.description,\n\t\tmetadata: cloneJsonObject(row.metadata),\n\t\ttimestamp: row.timestamp,\n\t};\n}\n\nfunction importanceCeilingLevels(\n\tmax: ImportanceLevel,\n): readonly ImportanceLevel[] {\n\treturn IMPORTANCE_LEVELS.filter(\n\t\t(level) => IMPORTANCE_RANK[level] <= IMPORTANCE_RANK[max],\n\t);\n}\n\nfunction hasPostgresErrorCode(error: unknown, code: string): boolean {\n\treturn (\n\t\ttypeof error === \"object\" &&\n\t\terror !== null &&\n\t\t\"code\" in error &&\n\t\terror.code === code\n\t);\n}\n\nfunction getPostgresErrorCode(error: unknown): string | undefined {\n\treturn typeof error === \"object\" &&\n\t\terror !== null &&\n\t\t\"code\" in error &&\n\t\ttypeof (error as { code?: unknown }).code === \"string\"\n\t\t? (error as { code: string }).code\n\t\t: undefined;\n}\n\nfunction normalizePostgresError(error: unknown): MnemocyteError {\n\tif (error instanceof MnemocyteError) {\n\t\treturn error;\n\t}\n\tconst code = getPostgresErrorCode(error);\n\tif (code && MIGRATION_ERROR_CODES.has(code)) {\n\t\treturn new MnemocyteError(\n\t\t\t\"Postgres schema is missing or incompatible. Apply the bundled Mnemocyte migrations before using the Postgres backend.\",\n\t\t\t\"MIGRATION\",\n\t\t\terror,\n\t\t);\n\t}\n\treturn new MnemocyteError(\"Postgres operation failed.\", \"DB\", error);\n}\n\nasync function runPostgresOperation<T>(\n\toperation: () => Promise<T>,\n): Promise<T> {\n\ttry {\n\t\treturn await operation();\n\t} catch (error) {\n\t\tthrow normalizePostgresError(error);\n\t}\n}\n\nfunction toPruneFilter(input: PruneInput): PruneFilter {\n\tconst filter: PruneFilter = {};\n\tif (input.entityId !== undefined) {\n\t\tfilter.entityId = input.entityId;\n\t}\n\tif (input.expired === true) {\n\t\tfilter.expired = true;\n\t}\n\tif (input.superseded === true) {\n\t\tfilter.superseded = true;\n\t}\n\tif (input.createdBefore !== undefined) {\n\t\tfilter.createdBefore = input.createdBefore;\n\t}\n\tif (input.notAccessedSince !== undefined) {\n\t\tfilter.notAccessedSince = input.notAccessedSince;\n\t}\n\tif (input.types !== undefined && input.types.length > 0) {\n\t\tfilter.types = input.types;\n\t}\n\tif (input.tags !== undefined && input.tags.length > 0) {\n\t\tfilter.tags = input.tags;\n\t}\n\tif (input.maxImportance !== undefined) {\n\t\tfilter.maxImportanceLevels = importanceCeilingLevels(input.maxImportance);\n\t}\n\treturn filter;\n}\n\nfunction toMemoryRow(memory: StoredMemory): NewMemoryRow {\n\treturn {\n\t\t...memory,\n\t\ttags: [...memory.tags],\n\t\tmetadata: cloneJsonObject(memory.metadata),\n\t\tembedding: [...memory.embedding],\n\t};\n}\n\nexport function createPostgresStore(handle: DatabaseHandle): MemoryStore {\n\tlet schemaValidated = false;\n\tlet schemaValidationPromise: Promise<void> | undefined;\n\n\tasync function ensureEmbeddingCompatibility(\n\t\tembedder: Embedder,\n\t): Promise<void> {\n\t\tif (schemaValidated) {\n\t\t\treturn;\n\t\t}\n\t\tif (!schemaValidationPromise) {\n\t\t\tschemaValidationPromise = validateEmbeddingCompatibility(embedder).catch(\n\t\t\t\t(error: unknown) => {\n\t\t\t\t\tschemaValidationPromise = undefined;\n\t\t\t\t\tthrow error;\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\t\tawait schemaValidationPromise;\n\t}\n\n\tasync function validateEmbeddingCompatibility(\n\t\tembedder: Embedder,\n\t): Promise<void> {\n\t\tlet meta: Awaited<ReturnType<typeof getInstallationMeta>>;\n\t\ttry {\n\t\t\tmeta = await getInstallationMeta(handle.db);\n\t\t} catch (error) {\n\t\t\tif (hasPostgresErrorCode(error, \"42P01\")) {\n\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\"mnemocyte_meta is missing. Apply the v0.2.0 migration or render a dimension-specific initial migration before using the Postgres backend.\",\n\t\t\t\t\t\"MIGRATION\",\n\t\t\t\t\terror,\n\t\t\t\t);\n\t\t\t}\n\t\t\tthrow normalizePostgresError(error);\n\t\t}\n\t\tif (!meta) {\n\t\t\tthrow new MnemocyteError(\n\t\t\t\t'mnemocyte_meta is missing the \"installation\" row. Apply the v0.2.0 migration or render a dimension-specific initial migration before using the Postgres backend.',\n\t\t\t\t\"MIGRATION\",\n\t\t\t);\n\t\t}\n\t\tif (meta.embeddingDimensions !== embedder.dimensions) {\n\t\t\tthrow new MnemocyteError(\n\t\t\t\t`embedder.dimensions (${embedder.dimensions}) must match mnemocyte_meta.embedding_dimensions (${meta.embeddingDimensions}). Render and apply a migration for the selected embedding dimension, or configure an embedder that matches this installation.`,\n\t\t\t\t\"CONFIG\",\n\t\t\t);\n\t\t}\n\t\tschemaValidated = true;\n\t}\n\n\treturn {\n\t\tbackend: \"postgres\",\n\t\tasync ensureSchema() {},\n\t\tensureEmbeddingCompatibility,\n\t\tasync insertMemories(memories) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tconst rows = await insertMemoryRows(\n\t\t\t\t\thandle.db,\n\t\t\t\t\tmemories.map(toMemoryRow),\n\t\t\t\t);\n\t\t\t\treturn rows.map(rowToMemory);\n\t\t\t});\n\t\t},\n\t\tasync vectorSearch(input: StoreVectorSearchInput) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tconst rows = await vectorSearchQuery(handle.db, input);\n\t\t\t\treturn rows.map(\n\t\t\t\t\t(row) =>\n\t\t\t\t\t\t({\n\t\t\t\t\t\t\tmemory: rowToMemory(row),\n\t\t\t\t\t\t\tvectorScore: row.vectorScore,\n\t\t\t\t\t\t}) satisfies StoreVectorCandidate,\n\t\t\t\t);\n\t\t\t});\n\t\t},\n\t\tasync lexicalSearch(input: StoreLexicalSearchInput) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tconst rows = await lexicalSearchQuery(handle.db, input);\n\t\t\t\treturn rows.map(\n\t\t\t\t\t(row) =>\n\t\t\t\t\t\t({\n\t\t\t\t\t\t\tmemory: rowToMemory(row),\n\t\t\t\t\t\t\tlexicalScore: row.lexicalScore,\n\t\t\t\t\t\t}) satisfies StoreLexicalCandidate,\n\t\t\t\t);\n\t\t\t});\n\t\t},\n\t\tasync getMemoryEmbeddings(memoryIds) {\n\t\t\treturn runPostgresOperation(() =>\n\t\t\t\tgetMemoryEmbeddingsQuery(handle.db, memoryIds),\n\t\t\t);\n\t\t},\n\t\tasync markMemoriesAccessed(memoryIds) {\n\t\t\treturn runPostgresOperation(() =>\n\t\t\t\tmarkMemoriesAccessed(handle.db, memoryIds),\n\t\t\t);\n\t\t},\n\t\tasync deleteMemory(entityId, memoryId) {\n\t\t\treturn runPostgresOperation(() =>\n\t\t\t\tdeleteMemoryQuery(handle.db, entityId, memoryId),\n\t\t\t);\n\t\t},\n\t\tasync deleteMemoriesForEntity(entityId) {\n\t\t\treturn runPostgresOperation(() =>\n\t\t\t\tdeleteMemoriesForEntityQuery(handle.db, entityId),\n\t\t\t);\n\t\t},\n\t\tasync prune(input) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tconst filter = toPruneFilter(input);\n\t\t\t\tconst dryRun = input.dryRun === true;\n\t\t\t\tif (dryRun) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tmatchedCount: await countPruneMatches(handle.db, filter),\n\t\t\t\t\t\tdeletedCount: 0,\n\t\t\t\t\t\tdryRun: true,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tconst deletedCount = await pruneMemories(handle.db, filter);\n\t\t\t\treturn {\n\t\t\t\t\tmatchedCount: deletedCount,\n\t\t\t\t\tdeletedCount,\n\t\t\t\t\tdryRun: false,\n\t\t\t\t};\n\t\t\t});\n\t\t},\n\t\tasync findDuplicatePairs(input) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tconst rows = await findDuplicatePairsQuery(handle.db, {\n\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\tthreshold: input.threshold ?? DEFAULT_DUPLICATE_THRESHOLD,\n\t\t\t\t\tlimit: input.limit ?? DEFAULT_DUPLICATE_LIMIT,\n\t\t\t\t\t...(input.types === undefined ? {} : { types: input.types }),\n\t\t\t\t\t...(input.tags === undefined ? {} : { tags: input.tags }),\n\t\t\t\t\t...(input.includeSuperseded === undefined\n\t\t\t\t\t\t? {}\n\t\t\t\t\t\t: { includeSuperseded: input.includeSuperseded }),\n\t\t\t\t\t...(input.includeExpired === undefined\n\t\t\t\t\t\t? {}\n\t\t\t\t\t\t: { includeExpired: input.includeExpired }),\n\t\t\t\t});\n\t\t\t\treturn rows.map(\n\t\t\t\t\t(row) =>\n\t\t\t\t\t\t({\n\t\t\t\t\t\t\ta: rowToMemory(row.a),\n\t\t\t\t\t\t\tb: rowToMemory(row.b),\n\t\t\t\t\t\t\tsimilarity: Math.max(0, Math.min(1, row.similarity)),\n\t\t\t\t\t\t}) satisfies StoreDuplicatePair,\n\t\t\t\t);\n\t\t\t});\n\t\t},\n\t\tasync addAuditEvents(events) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tfor (const event of events) {\n\t\t\t\t\tawait insertEvent(handle.db, {\n\t\t\t\t\t\tid: event.id,\n\t\t\t\t\t\tentityId: event.entityId,\n\t\t\t\t\t\tdescription: event.description,\n\t\t\t\t\t\tmetadata: cloneJsonObject(event.metadata),\n\t\t\t\t\t\ttimestamp: event.timestamp,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t});\n\t\t},\n\t\tasync listAuditLog(input) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tconst rows = await listEvents(handle.db, {\n\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\tlimit: input.limit ?? DEFAULT_AUDIT_LOG_LIMIT,\n\t\t\t\t\t...(input.before === undefined ? {} : { before: input.before }),\n\t\t\t\t\t...(input.after === undefined ? {} : { after: input.after }),\n\t\t\t\t});\n\t\t\t\treturn rows.map(rowToAuditEvent);\n\t\t\t});\n\t\t},\n\t\tasync getMemory(entityId, memoryId) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tconst row = await getMemoryById(handle.db, entityId, memoryId);\n\t\t\t\treturn row ? rowToMemory(row) : null;\n\t\t\t});\n\t\t},\n\t\tasync loadConsolidationTargets(entityId, ids) {\n\t\t\treturn runPostgresOperation(() =>\n\t\t\t\tloadConsolidationTargets(handle.db, entityId, ids),\n\t\t\t);\n\t\t},\n\t\tasync consolidate(\n\t\t\tinput: StoreConsolidateInput,\n\t\t): Promise<StoreConsolidateResult> {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tconst newSupersededIds = await handle.db.transaction(async (tx) => {\n\t\t\t\t\tconst updated = await markMemoriesSuperseded(tx, {\n\t\t\t\t\t\tsurvivorId: input.survivorId,\n\t\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\t\tids: input.supersededIds,\n\t\t\t\t\t\tnow: input.now,\n\t\t\t\t\t});\n\t\t\t\t\tconst ids = updated.map((row) => row.id);\n\t\t\t\t\tif (input.auditEnabled) {\n\t\t\t\t\t\tfor (const id of ids) {\n\t\t\t\t\t\t\tawait insertEvent(tx, {\n\t\t\t\t\t\t\t\tid: createEventId(),\n\t\t\t\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\t\t\t\tdescription: \"memory.superseded\",\n\t\t\t\t\t\t\t\tmetadata: { memoryId: id, supersededBy: input.survivorId },\n\t\t\t\t\t\t\t\ttimestamp: input.now,\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\tif (input.mergeTags && updated.length > 0) {\n\t\t\t\t\t\tconst mergedTags = new Set(input.survivorTags);\n\t\t\t\t\t\tfor (const row of updated) {\n\t\t\t\t\t\t\tfor (const tag of row.tags) {\n\t\t\t\t\t\t\t\tmergedTags.add(tag);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (mergedTags.size !== input.survivorTags.length) {\n\t\t\t\t\t\t\tawait setMemoryTags(tx, {\n\t\t\t\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\t\t\t\tmemoryId: input.survivorId,\n\t\t\t\t\t\t\t\ttags: [...mergedTags],\n\t\t\t\t\t\t\t\tnow: input.now,\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 ids;\n\t\t\t\t});\n\t\t\t\treturn { supersededIds: newSupersededIds };\n\t\t\t});\n\t\t},\n\t\tasync stats(input, now) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tif (input?.entityId) {\n\t\t\t\t\tconst counts = await getEntityMemoryStatsCounts(\n\t\t\t\t\t\thandle.db,\n\t\t\t\t\t\tinput.entityId,\n\t\t\t\t\t\tnow,\n\t\t\t\t\t);\n\t\t\t\t\treturn {\n\t\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\t\t...counts,\n\t\t\t\t\t} satisfies EntityStats;\n\t\t\t\t}\n\t\t\t\treturn (await getGlobalMemoryStatsCounts(\n\t\t\t\t\thandle.db,\n\t\t\t\t\tnow,\n\t\t\t\t)) satisfies GlobalStats;\n\t\t\t});\n\t\t},\n\t\tasync close() {\n\t\t\treturn runPostgresOperation(() => handle.close());\n\t\t},\n\t};\n}\n\nexport function createPostgresClient(\n\tconfig: MnemocyteConfig,\n\thandle: DatabaseHandle,\n): MnemocyteClient {\n\treturn createMemoryClient(config, createPostgresStore(handle));\n}\n","import { createDatabase } from \"./db/index.js\";\nimport { createInMemoryClient } from \"./memory/in-memory.js\";\nimport { createPostgresClient } from \"./memory/postgres.js\";\nimport {\n\tassertEmbedder,\n\tassertNonEmptyString,\n\tvalidateRetrievalConfig,\n} from \"./memory/validation.js\";\nimport type { MnemocyteClient, MnemocyteConfig } from \"./types.js\";\n\n/**\n * Create a Mnemocyte client.\n *\n * When {@link MnemocyteConfig.databaseUrl} is provided, a Postgres-backed\n * client is returned (requires the `pgvector` extension and the bundled\n * migration applied). Otherwise an in-memory client is returned, intended\n * for tests, demos, and short-lived processes.\n *\n * The returned client owns any underlying resources (e.g. the Postgres\n * connection pool). Call {@link MnemocyteClient.close} when finished to\n * release them.\n *\n * @param config - Client configuration. {@link MnemocyteConfig.embedder} is required.\n * @returns A {@link MnemocyteClient} instance.\n * @throws {MnemocyteError} With code `\"CONFIG\"` if `embedder`, retrieval\n * tuning, or the database URL is malformed, or `\"VALIDATION\"` if\n * `databaseUrl` is explicitly empty.\n *\n * @example Postgres-backed client\n * ```ts\n * const client = createMnemocyte({\n *   databaseUrl: process.env.DATABASE_URL,\n *   embedder, // embedder.dimensions must match mnemocyte_meta\n * });\n * ```\n */\nexport function createMnemocyte(config: MnemocyteConfig): MnemocyteClient {\n\tassertEmbedder(config.embedder);\n\tvalidateRetrievalConfig(config.retrieval);\n\tif (config.databaseUrl !== undefined) {\n\t\tassertNonEmptyString(config.databaseUrl, \"databaseUrl\");\n\t\treturn createPostgresClient(config, createDatabase(config.databaseUrl));\n\t}\n\treturn createInMemoryClient(config);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA,SAAgB,sBAAsB,OAAuB;CAC5D,IAAI,CAAC,OAAO,SAAS,KAAK,GACzB,MAAM,IAAI,MAAM,uCAAuC;CAExD,OAAO,OAAO,GAAG,OAAO,EAAE,IAAI,MAAM,MAAM,QAAQ,EAAE;AACrD;;;;;;;;ACUA,MAAM,SAAS,WAIZ;CACF,SAAS,QAAQ;EAEhB,OAAO,UADY,QAAQ,cAAc,KACb;CAC7B;CACA,SAAS,OAAO;EACf,OAAO,IAAI,MAAM,IAAI,qBAAqB,EAAE,KAAK,GAAG,EAAE;CACvD;CACA,WAAW,OAAO;EACjB,OAAO,MAAM,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,OAAO,OAAO,EAAE,IAAI,MAAM;CAChE;AACD,CAAC;AAED,MAAa,gBAAgB,QAC5B,sBACA;CACC,IAAI,KAAK,IAAI,EAAE,WAAW;CAC1B,UAAU,KAAK,WAAW,EAAE,QAAQ;CACpC,SAAS,KAAK,SAAS,EAAE,QAAQ;CACjC,MAAM,KAAK,MAAM,EAAE,QAAQ,EAAE,QAAQ,MAAM;CAC3C,YAAY,KAAK,YAAY,EAAE,QAAQ,EAAE,QAAQ,QAAQ;CACzD,MAAM,KAAK,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,cAAc;CAC9D,QAAQ,KAAK,QAAQ;CACrB,UAAU,MAAM,UAAU,EAAE,MAAkB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;CACpE,YAAY,KAAK,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC;CAClD,WAAW,OAAO,aAAa,EAAE,YAAY,KAAK,CAAC;CACnD,gBAAgB,KAAK,iBAAiB,EAAE,QAAQ;CAChD,qBAAqB,QAAQ,sBAAsB,EAAE,QAAQ;CAC7D,cAAc,KAAK,eAAe,EAAE,iBAChB,cAAc,EAClC;CACA,cAAc,UAAU,iBAAiB,EAAE,cAAc,KAAK,CAAC;CAC/D,WAAW,UAAU,cAAc,EAAE,cAAc,KAAK,CAAC;CACzD,gBAAgB,UAAU,oBAAoB,EAAE,cAAc,KAAK,CAAC;CACpE,aAAa,QAAQ,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC;CACxD,WAAW,UAAU,cAAc,EAAE,cAAc,KAAK,CAAC,EACvD,QAAQ,EACR,WAAW;CACb,WAAW,UAAU,cAAc,EAAE,cAAc,KAAK,CAAC,EACvD,QAAQ,EACR,WAAW;AACd,IACC,UAAU;CACV,MAAM,+BAA+B,EAAE,GAAG,MAAM,QAAQ;CACxD,MAAM,oCAAoC,EAAE,GAAG,MAAM,UAAU,MAAM,IAAI;CACzE,MAAM,uCAAuC,EAAE,MAC9C,QACA,MAAM,UAAU,GAAG,mBAAmB,CACvC;AACD,CACD;AAEA,MAAa,cAAc,QAC1B,oBACA;CACC,IAAI,KAAK,IAAI,EAAE,WAAW;CAC1B,UAAU,KAAK,WAAW,EAAE,QAAQ;CACpC,aAAa,KAAK,aAAa,EAAE,QAAQ;CACzC,UAAU,MAAM,UAAU,EAAE,MAAkB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;CACpE,WAAW,UAAU,aAAa,EAAE,cAAc,KAAK,CAAC,EACtD,QAAQ,EACR,WAAW;AACd,IACC,UAAU,CACV,MAAM,kCAAkC,EAAE,GACzC,MAAM,UACN,MAAM,SACP,CACD,CACD;AAEA,MAAa,YAAY,QAAQ,kBAAkB;CAClD,KAAK,KAAK,KAAK,EAAE,WAAW;CAC5B,qBAAqB,QAAQ,sBAAsB,EAAE,QAAQ;AAC9D,CAAC;;;AClED,SAAS,gBAAgB,KAAwC;CAChE,MAAM,OAAO,IAAI,aAAa,IAAI,SAAS;CAC3C,IAAI,CAAC,QAAQ,SAAS,WAAW,OAAO,KAAA;CAExC,IAAI,SAAS,aAAa,SAAS,YAAY,SAAS,SACvD,OAAO,EAAE,oBAAoB,MAAM;CAGpC,IAAI,SAAS,eAAe,OAAO;AAGpC;AAEA,SAAgB,eAAe,aAAqC;CACnE,IAAI;CACJ,IAAI;EACH,MAAM,IAAI,IAAI,WAAW;CAC1B,SAAS,OAAO;EACf,MAAM,IAAI,eACT,wDACA,UACA,KACD;CACD;CACA,MAAM,MAAM,gBAAgB,GAAG;CAE/B,MAAM,WACL,IAAI,SAAS,UAAU,IAAI,aAAa,IAAI,WAAW,MAAM;CAE9D,MAAM,SAAS,SAAS,aAAa;EACpC,KAAK;EACL,cAAc;EACd,iBAAiB;EACjB,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC;EACrB,GAAI,WAAW,EAAE,SAAS,MAAM,IAAI,CAAC;CACtC,CAAC;CAED,OAAO;EACN,IAAI,QAAQ,QAAQ,EAAE,QAAA,eAAO,CAAC;EAC9B,MAAM,QAAQ;GACb,MAAM,OAAO,IAAI;EAClB;CACD;AACD;;;ACnEA,SAAS,iBAAiB,MAAc,OAAiC;CACxE,OAAO,IAAI,eACV,GAAG,KAAK,iDACR,cACA,KACD;AACD;AAEA,SAAS,eACR,OACA,MACA,WACY;CACZ,IACC,UAAU,QACV,OAAO,UAAU,YACjB,OAAO,UAAU,WAEjB,OAAO;CAER,IAAI,OAAO,UAAU,UAAU;EAC9B,IAAI,CAAC,OAAO,SAAS,KAAK,GACzB,MAAM,iBAAiB,IAAI;EAE5B,OAAO,OAAO,GAAG,OAAO,EAAE,IAAI,IAAI;CACnC;CACA,IAAI,OAAO,UAAU,UACpB,MAAM,iBAAiB,IAAI;CAE5B,IAAI,UAAU,IAAI,KAAK,GACtB,MAAM,iBAAiB,IAAI;CAG5B,UAAU,IAAI,KAAK;CACnB,IAAI;EACH,IAAI,MAAM,QAAQ,KAAK,GAAG;GACzB,IACC,OAAO,sBAAsB,KAAK,EAAE,SAAS,KAC7C,OAAO,KAAK,KAAK,EAAE,MAAM,QAAQ,CAAC,iBAAiB,KAAK,GAAG,CAAC,GAE5D,MAAM,iBAAiB,IAAI;GAE5B,OAAO,MAAM,KAAK,EAAE,QAAQ,MAAM,OAAO,IAAI,GAAG,UAAU;IACzD,IAAI,CAAC,OAAO,OAAO,OAAO,KAAK,GAC9B,MAAM,iBAAiB,GAAG,KAAK,GAAG,MAAM,EAAE;IAE3C,OAAO,eAAe,MAAM,QAAQ,GAAG,KAAK,GAAG,MAAM,IAAI,SAAS;GACnE,CAAC;EACF;EAEA,MAAM,YAAY,OAAO,eAAe,KAAK;EAC7C,IAAI,cAAc,OAAO,aAAa,cAAc,MACnD,MAAM,iBAAiB,IAAI;EAE5B,MAAM,cAAc,OAAO,0BAA0B,KAAK;EAC1D,MAAM,UAAsC,CAAC;EAC7C,KAAK,MAAM,OAAO,QAAQ,QAAQ,WAAW,GAAG;GAC/C,IAAI,OAAO,QAAQ,UAClB,MAAM,iBAAiB,IAAI;GAE5B,MAAM,aAAa,YAAY;GAC/B,IACC,eAAe,KAAA,KACf,WAAW,eAAe,QAC1B,EAAE,WAAW,aAEb,MAAM,iBAAiB,GAAG,KAAK,GAAG,KAAK;GAExC,QAAQ,KAAK,CACZ,KACA,eAAe,WAAW,OAAO,GAAG,KAAK,GAAG,OAAO,SAAS,CAC7D,CAAC;EACF;EACA,OAAO,OAAO,YAAY,OAAO;CAClC,UAAU;EACT,UAAU,OAAO,KAAK;CACvB;AACD;;AAGA,SAAgB,gBAAgB,OAAgB,OAAO,YAAwB;CAC9E,IAAI;EACH,IAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GACrE,MAAM,iBAAiB,IAAI;EAE5B,OAAO,eAAe,OAAO,sBAAM,IAAI,IAAI,CAAC;CAC7C,SAAS,OAAO;EACf,IAAI,iBAAiB,gBACpB,MAAM;EAEP,MAAM,iBAAiB,MAAM,KAAK;CACnC;AACD;;AAGA,SAAgB,mBACf,OACA,OAAO,YACuB;CAC9B,gBAAgB,OAAO,IAAI;AAC5B;;;AChGA,SAAgB,cAAc,MAA+C;CAC5E,IAAI,CAAC,MACJ,OAAO,CAAC;CAET,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,OAAO,OAAO,CAAC,CAAC;AAClE;AAEA,SAAgB,WAAmB;CAClC,OAAO,OAAO,KAAK,IAAI,EAAE,SAAS,EAAE,EAAE,GAAG,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE;AAChF;;AAGA,SAAgB,gBAAwB;CACvC,OAAO,OAAO,KAAK,IAAI,EAAE,SAAS,EAAE,EAAE,GAAG,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE;AAChF;AAEA,SAAgB,YAAY,QAAwB;CACnD,OAAO;EACN,IAAI,OAAO;EACX,UAAU,OAAO;EACjB,SAAS,OAAO;EAChB,MAAM,OAAO;EACb,YAAY,OAAO;EACnB,MAAM,CAAC,GAAG,OAAO,IAAI;EACrB,QAAQ,OAAO;EACf,UAAU,gBAAgB,OAAO,QAAQ;EACzC,YAAY,OAAO;EACnB,gBAAgB,OAAO;EACvB,qBAAqB,OAAO;EAC5B,cAAc,OAAO;EACrB,cAAc,OAAO,eAAe,IAAI,KAAK,OAAO,YAAY,IAAI;EACpE,WAAW,OAAO,YAAY,IAAI,KAAK,OAAO,SAAS,IAAI;EAC3D,gBAAgB,OAAO,iBACpB,IAAI,KAAK,OAAO,cAAc,IAC9B;EACH,aAAa,OAAO;EACpB,WAAW,IAAI,KAAK,OAAO,SAAS;EACpC,WAAW,IAAI,KAAK,OAAO,SAAS;CACrC;AACD;;;ACpCA,MAAM,oBAAqD;CAC1D,KAAK;CACL,QAAQ;CACR,MAAM;CACN,UAAU;AACX;AAEA,MAAa,4BAET;CACH,QAAQ;CACR,SAAS;CACT,SAAS;CACT,YAAY;CACZ,QAAQ;CACR,YAAY;AACb;AAEA,MAAM,iCAAiC;AACvC,MAAM,4BAA4B;AASlC,SAAgB,iBACf,GACA,GACS;CACT,IAAI,MAAM;CACV,IAAI,aAAa;CACjB,IAAI,aAAa;CACjB,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK,GAAG;EACrC,MAAM,KAAK,EAAE,MAAM;EACnB,MAAM,KAAK,EAAE,MAAM;EACnB,OAAO,KAAK;EACZ,cAAc,KAAK;EACnB,cAAc,KAAK;CACpB;CACA,IAAI,eAAe,KAAK,eAAe,GACtC,OAAO;CAER,OAAO,OAAO,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,UAAU;AAC3D;AAEA,SAAgB,cAAc,OAAkC;CAC/D,OAAO,MAAM,YAAY,EAAE,MAAM,KAAK,EAAE,OAAO,OAAO;AACvD;AAEA,SAAgB,sBACf,SACA,OACS;CACT,IAAI,MAAM,WAAW,GACpB,OAAO;CAER,MAAM,eAAe,QAAQ,YAAY;CAEzC,OADgB,MAAM,QAAQ,SAAS,aAAa,SAAS,IAAI,CAAC,EAAE,SACnD,MAAM;AACxB;AAEA,SAAgB,oBACf,OAC8B;CAC9B,MAAM,QAAQ,cAAc,KAAK;CACjC,QAAQ,YAAY,sBAAsB,SAAS,KAAK;AACzD;AAEA,SAAS,WAAW,OAAuB;CAC1C,IAAI,CAAC,OAAO,SAAS,KAAK,GACzB,OAAO;CAER,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,CAAC;AACtC;AAEA,SAAS,iBACR,SACkC;CAClC,MAAM,SAAS;EAAE,GAAG;EAA2B,GAAG;CAAQ;CAC1D,MAAM,QACL,OAAO,SACP,OAAO,UACP,OAAO,UACP,OAAO,aACP,OAAO,SACP,OAAO;CACR,IAAI,SAAS,GACZ,OAAO,EAAE,GAAG,0BAA0B;CAEvC,OAAO;EACN,QAAQ,OAAO,SAAS;EACxB,SAAS,OAAO,UAAU;EAC1B,SAAS,OAAO,UAAU;EAC1B,YAAY,OAAO,aAAa;EAChC,QAAQ,OAAO,SAAS;EACxB,YAAY,OAAO,aAAa;CACjC;AACD;AAEA,SAAgB,oBAAoB,QAAyC;CAC5E,OAAO;EACN,SAAS,iBAAiB,QAAQ,OAAO;EACzC,qBACC,QAAQ,uBAAuB;EAChC,kBAAkB,QAAQ,oBAAoB;CAC/C;AACD;AAEA,SAAS,aAAa,WAAiB,cAA8B;CACpE,MAAM,QAAQ,KAAK,IAAI,IAAI,UAAU,QAAQ;CAC7C,MAAM,UAAU,KAAK,IAAI,GAAG,QAAQ,KAAU;CAC9C,OAAO,KAAK,IAAK,CAAC,KAAK,MAAM,UAAW,YAAY;AACrD;AAEA,SAAS,YAAY,aAAqB,YAA4B;CACrE,IAAI,eAAe,GAClB,OAAO;CAER,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,WAAW,IAAI,KAAK,MAAM,UAAU,CAAC;AACpE;AAEA,SAAgB,yBACf,QACA,QACA,SACA,OACA,QACkB;CAClB,MAAM,EAAE,YAAY;CACpB,MAAM,UAAU,aAAa,OAAO,WAAW,OAAO,mBAAmB;CACzE,MAAM,aAAa,WAAW,OAAO,UAAU;CAC/C,MAAM,SAAS,YAAY,OAAO,aAAa,OAAO,gBAAgB;CACtE,MAAM,aAAa,kBAAkB,OAAO;CAC5C,MAAM,QAAQ,KAAK,IAClB,GACA,KAAK,IACJ,GACA,WAAW,MAAM,IAAI,QAAQ,SAC5B,WAAW,OAAO,IAAI,QAAQ,UAC9B,UAAU,QAAQ,UAClB,aAAa,QAAQ,aACrB,SAAS,QAAQ,SACjB,aAAa,QAAQ,UACvB,CACD;CACA,OAAO;EACN,GAAG,YAAY,MAAM;EACrB;EACA,QAAQ;GACP,QAAQ,WAAW,MAAM;GACzB,SAAS,WAAW,OAAO;GAC3B;GACA;GACA;GACA;EACD;EACA,aAAa,MAAM,UAChB;GACA,aAAa,WAAW,MAAM;GAC9B,cAAc,WAAW,OAAO;GAChC,cAAc;GACd,iBAAiB;GACjB,aAAa;GACb,iBAAiB;GACjB,iBAAiB,aAAa,QAAQ;GACtC;GACA,YAAY;EACb,IACC;CACJ;AACD;;;ACrLA,SAAS,UAAU,OAAuB;CACzC,OAAO,MACL,WAAW,KAAK,OAAO,EACvB,WAAW,KAAK,MAAM,EACtB,WAAW,KAAK,MAAM,EACtB,WAAW,MAAK,QAAQ,EACxB,WAAW,KAAK,QAAQ;AAC3B;AAEA,SAAS,eAAe,QAAiC;CACxD,MAAM,QAAQ;EACb,QAAQ,OAAO;EACf,cAAc,OAAO;EACrB,SAAS,OAAO,MAAM,QAAQ,CAAC;CAChC;CACA,IAAI,OAAO,QACV,MAAM,KAAK,UAAU,OAAO,QAAQ;CAErC,IAAI,OAAO,KAAK,SAAS,GACxB,MAAM,KAAK,QAAQ,OAAO,KAAK,KAAK,GAAG,GAAG;CAE3C,OAAO,MAAM,KAAK,IAAI;AACvB;AAEA,SAAS,cAAc,OAAuB;CAC7C,MAAM,qBAAqB,KAAK,IAC/B,GACA,GAAG,MAAM,KAAK,MAAM,SAAS,KAAK,IAAI,UAAU,MAAM,GAAG,MAAM,CAChE;CACA,OAAO,IAAI,OAAO,KAAK,IAAI,GAAG,qBAAqB,CAAC,CAAC;AACtD;AAEA,SAAS,eACR,UACA,OACA,cACS;CACT,MAAM,QAAQ;EACb;EACA;EACA,UAAU;EACV;EACA;CACD;CACA,KAAK,MAAM,UAAU,UAAU;EAC9B,MAAM,QAAQ,cAAc,OAAO,OAAO;EAC1C,MAAM,KACL,IACA,KAAK,eAAe,MAAM,KAC1B,KAAK,MAAM,OACX,GAAG,OAAO,QAAQ,MAAM,IAAI,EAAE,KAAK,SAAS,KAAK,MAAM,GACvD,KAAK,OACN;CACD;CACA,IAAI,eAAe,GAClB,MAAM,KAAK,IAAI,IAAI,aAAa,uCAAuC;CAExE,OAAO,MAAM,KAAK,IAAI;AACvB;AAEA,SAAS,YACR,UACA,OACA,cACS;CACT,MAAM,QAAQ;EACb;EACA;EACA,UAAU;EACV;EACA;CACD;CACA,KAAK,MAAM,CAAC,OAAO,WAAW,SAAS,QAAQ,GAC9C,MAAM,KACL,IACA,cAAc,QAAQ,EAAE,aACxB,eAAe,MAAM,GACrB,OAAO,SACP,cAAc,QAAQ,EAAE,SACzB;CAED,IAAI,eAAe,GAClB,MAAM,KAAK,IAAI,IAAI,aAAa,uCAAuC;CAExE,OAAO,MAAM,KAAK,IAAI;AACvB;AAEA,SAAS,UACR,UACA,OACA,cACS;CACT,MAAM,QAAQ,CAAC,0BAA0B,UAAU,KAAK,EAAE,GAAG;CAC7D,KAAK,MAAM,UAAU,UACpB,MAAM,KACL,iBAAiB,UAAU,OAAO,EAAE,EAAE,UAAU,UAAU,OAAO,IAAI,EAAE,gBAAgB,UAAU,OAAO,UAAU,EAAE,WAAW,OAAO,MAAM,QAAQ,CAAC,EAAE,KACvJ,gBAAgB,UAAU,OAAO,OAAO,EAAE,aAC1C,iBAAiB,UAAU,eAAe,MAAM,CAAC,EAAE,cACnD,aACD;CAED,IAAI,eAAe,GAClB,MAAM,KAAK,qBAAqB,aAAa,2BAA2B;CAEzE,MAAM,KAAK,mBAAmB;CAC9B,OAAO,MAAM,KAAK,IAAI;AACvB;AAEA,SAAgB,cACf,UACA,OACA,QACA,eAAe,GACN;CACT,QAAQ,QAAR;EACC,KAAK,YACJ,OAAO,eAAe,UAAU,OAAO,YAAY;EACpD,KAAK,SACJ,OAAO,YAAY,UAAU,OAAO,YAAY;EACjD,KAAK,OACJ,OAAO,UAAU,UAAU,OAAO,YAAY;CAChD;AACD;;;AC1HA,MAAa,wBAAsC,EAClD,MAAM,MAAM;CACX,OAAO,KAAK,KAAK,KAAK,SAAS,CAAC;AACjC,EACD;AAEA,SAAgB,kBACf,MACA,WACA,cACS;CACT,IAAI,YAAY,KAAK,aAAa,MAAM,IAAI,KAAK,WAChD,OAAO;CAER,IAAI,MAAM;CACV,IAAI,OAAO,KAAK;CAChB,IAAI,OAAO;CACX,OAAO,OAAO,MAAM;EACnB,MAAM,MAAM,KAAK,OAAO,MAAM,QAAQ,CAAC;EAEvC,MAAM,SAAS,GADG,KAAK,MAAM,GAAG,GAAG,EAAE,QACX,EAAE;EAC5B,IAAI,aAAa,MAAM,MAAM,KAAK,WAAW;GAC5C,OAAO;GACP,MAAM,MAAM;EACb,OACC,OAAO,MAAM;CAEf;CACA,OAAO,QAAQ;AAChB;;;ACtBA,eAAsB,aACrB,SACkB;CAClB,MAAM,SAAS,QAAQ,MAAM,UAAU;CACvC,MAAM,YAAY,QAAQ,MAAM,aAAa;CAC7C,MAAM,eAAe,QAAQ,MAAM,gBAAgB;CACnD,MAAM,WAAW,MAAM,QAAQ,OAAO,QAAQ,KAAK;CACnD,IAAI,MAAM;CACV,IAAI,OAAO,SAAS;CACpB,IAAI,cAAc;CAClB,OAAO,OAAO,MAAM;EACnB,MAAM,MAAM,KAAK,OAAO,MAAM,QAAQ,CAAC;EACvC,MAAM,eAAe,SAAS,SAAS;EACvC,MAAM,UAAU,cACf,SAAS,MAAM,GAAG,GAAG,GACrB,QAAQ,MAAM,OACd,QACA,YACD;EACA,IAAI,aAAa,MAAM,OAAO,KAAK,WAAW;GAC7C,cAAc;GACd,MAAM,MAAM;EACb,OACC,OAAO,MAAM;CAEf;CACA,IAAI,eAAe,SAAS,WAAW,GACtC,OAAO;CAER,OAAO,kBACN,cAAc,CAAC,GAAG,QAAQ,MAAM,OAAO,QAAQ,SAAS,MAAM,GAC9D,WACA,YACD;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,eAAsB,QACrB,QACA,SACA,WACA,UACA,QACA,iBACa;CACb,MAAM,YAAY,KAAK,IAAI;CAC3B,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;;;;;;AC1EA,MAAa,kBAAmD;CAC/D,KAAK;CACL,QAAQ;CACR,MAAM;CACN,UAAU;AACX;;;;;;;;ACbA,MAAM,qBAAqB;;AAE3B,MAAM,kBAAkB;;AAExB,MAAM,wBAAwB;;AAE9B,MAAM,uBAAuB;;;;;AAM7B,SAAgB,eAAe,QAAuC;CACrE,IAAI,QAAQ,SACX,MAAM,IAAI,eACT,0BACA,WACA,OAAO,MACR;AAEF;;;;;;;;;AAUA,SAAgB,mBAAmB,OAAyB;CAC3D,IAAI,iBAAiB,gBAAgB;EACpC,IACC,MAAM,SAAS,gBACf,MAAM,SAAS,YACf,MAAM,SAAS,WAEf,OAAO;EAER,OAAO;CACR;CACA,IACC,OAAO,UAAU,YACjB,UAAU,QACV,YAAY,SACZ,OAAQ,MAA+B,WAAW,YAClD;EAAC;EAAK;EAAK;EAAK;EAAK;CAAG,EAAE,SAAU,MAA6B,MAAM,GAEvE,OAAO;CAER,IAAI,iBAAiB,OAAO;EAC3B,MAAM,UAAU,MAAM,QAAQ,YAAY;EAC1C,IACC,QAAQ,SAAS,OAAO,KACxB,QAAQ,SAAS,WAAW,KAC5B,QAAQ,SAAS,SAAS,KAC1B,QAAQ,SAAS,SAAS,KAC1B,QAAQ,SAAS,aAAa,KAC9B,QAAQ,SAAS,YAAY,KAC7B,QAAQ,SAAS,KAAK,KACtB,QAAQ,SAAS,KAAK,KACtB,QAAQ,SAAS,KAAK,KACtB,QAAQ,SAAS,KAAK,GAEtB,OAAO;CAET;CACA,OAAO;AACR;;;;;;;;AASA,SAAS,eACR,SACA,aACA,YACS;CACT,MAAM,cAAc,cAAc,MAAM,UAAU;CAClD,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,YAAY,WAAW,CAAC;AACrD;;;;;AAMA,SAAS,MAAM,IAAY,QAAgD;CAC1E,IAAI,MAAM,GAAG;EACZ,eAAe,MAAM;EACrB,OAAO,QAAQ,QAAQ;CACxB;CACA,OAAO,IAAI,SAAe,SAAS,WAAW;EAC7C,MAAM,QAAQ,iBAAiB;GAC9B,QAAQ,oBAAoB,SAAS,OAAO;GAC5C,QAAQ;EACT,GAAG,EAAE;EACL,MAAM,gBAAsB;GAC3B,aAAa,KAAK;GAClB,OACC,IAAI,eAAe,0BAA0B,WAAW,QAAQ,MAAM,CACvE;EACD;EACA,IAAI,QAAQ;GACX,IAAI,OAAO,SAAS;IACnB,aAAa,KAAK;IAClB,OACC,IAAI,eACH,0BACA,WACA,OAAO,MACR,CACD;IACA;GACD;GACA,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;EACzD;CACD,CAAC;AACF;AAEA,SAAS,aAAa,WAAmC;CACxD,OAAO,IAAI,eACV,iCAAiC,UAAU,MAC3C,SACD;AACD;;;;;;AAOA,SAAS,WACR,QACA,WACA,QACa;CACb,IAAI,aAAa,KAAK,CAAC,QACtB,OAAO,OAAO,KAAA,CAAS;CAExB,OAAO,IAAI,SAAY,SAAS,WAAW;EAC1C,IAAI,UAAU;EACd,MAAM,aAAa,IAAI,gBAAgB;EACvC,MAAM,QACL,YAAY,IACT,iBAAiB;GACjB,IAAI,SACH;GAED,UAAU;GACV,QAAQ,oBAAoB,SAAS,OAAO;GAC5C,WAAW,MAAM,aAAa,SAAS,CAAC;GACxC,OAAO,aAAa,SAAS,CAAC;EAC/B,GAAG,SAAS,IACX,KAAA;EACJ,MAAM,gBAAsB;GAC3B,IAAI,SACH;GAED,UAAU;GACV,IAAI,OACH,aAAa,KAAK;GAEnB,WAAW,MAAM,QAAQ,MAAM;GAC/B,OACC,IAAI,eAAe,0BAA0B,WAAW,QAAQ,MAAM,CACvE;EACD;EACA,IAAI,QAAQ;GACX,IAAI,OAAO,SAAS;IACnB,IAAI,OACH,aAAa,KAAK;IAEnB,UAAU;IACV,WAAW,MAAM,OAAO,MAAM;IAC9B,OACC,IAAI,eACH,0BACA,WACA,OAAO,MACR,CACD;IACA;GACD;GACA,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;EACzD;EACA,OAAO,WAAW,MAAM,EAAE,MACxB,UAAU;GACV,IAAI,SACH;GAED,UAAU;GACV,IAAI,OACH,aAAa,KAAK;GAEnB,QAAQ,oBAAoB,SAAS,OAAO;GAC5C,QAAQ,KAAK;EACd,IACC,UAAU;GACV,IAAI,SACH;GAED,UAAU;GACV,IAAI,OACH,aAAa,KAAK;GAEnB,QAAQ,oBAAoB,SAAS,OAAO;GAC5C,OAAO,KAAK;EACb,CACD;CACD,CAAC;AACF;;;;;;;;;;;AAsBA,eAAsB,eACrB,QACA,UAAiC,CAAC,GACrB;CACb,MAAM,SAAS,QAAQ,cAAc,CAAC;CACtC,MAAM,YAAY,OAAO,aAAa;CACtC,MAAM,UAAU,KAAK,IAAI,GAAG,OAAO,WAAW,eAAe;CAC7D,MAAM,cAAc,KAAK,IAAI,GAAG,OAAO,eAAe,qBAAqB;CAC3E,MAAM,aAAa,KAAK,IACvB,aACA,OAAO,cAAc,oBACtB;CACA,MAAM,cAAc,OAAO,eAAe;CAC1C,MAAM,iBAAiB,QAAQ;CAE/B,eAAe,cAAc;CAE7B,MAAM,cAAc,UAAU;CAC9B,IAAI;CACJ,KAAK,IAAI,UAAU,GAAG,WAAW,aAAa,WAAW,GAAG;EAC3D,eAAe,cAAc;EAC7B,IAAI;GACH,OAAO,MAAM,WAAW,QAAQ,WAAW,cAAc;EAC1D,SAAS,OAAO;GACf,YAAY;GACZ,IAAI,iBAAiB,kBAAkB,MAAM,SAAS,WACrD,MAAM;GAEP,IAAI,WAAW,aACd,MAAM;GAEP,IAAI,CAAC,YAAY,OAAO,OAAO,GAC9B,MAAM;GAGP,MAAM,MADS,eAAe,SAAS,aAAa,UACnC,GAAG,cAAc;EACnC;CACD;CACA,MAAM;AACP;;;ACvRA,SAAS,kBACR,WACA,YACO;CACP,IAAI,UAAU,WAAW,YACxB,MAAM,IAAI,eACT,8DACA,WACD;CAED,IAAI,UAAU,MAAM,cAAc,CAAC,OAAO,SAAS,SAAS,CAAC,GAC5D,MAAM,IAAI,eACT,0DACA,WACD;AAEF;AAEA,eAAsB,SACrB,UACA,MACA,UAGI,CAAC,GACe;CACpB,IAAI;CACJ,IAAI;EACH,aAAa,MAAM,gBACjB,WACA,WAAW,KAAA,IACR,SAAS,MAAM,CAAC,IAAI,CAAC,IACrB,SAAS,MAAM,CAAC,IAAI,GAAG,EAAE,OAAO,CAAC,GACrC;GACC,GAAI,QAAQ,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ,QAAQ,OAAO;GACjE,GAAI,QAAQ,eAAe,KAAA,IACxB,CAAC,IACD,EAAE,YAAY,QAAQ,WAAW;EACrC,CACD;CACD,SAAS,OAAO;EACf,IACC,iBAAiB,mBAChB,MAAM,SAAS,aAAa,MAAM,SAAS,YAE5C,MAAM;EAEP,MAAM,IAAI,eAAe,yBAAyB,aAAa,KAAK;CACrE;CACA,MAAM,YAAY,WAAW;CAC7B,IAAI,CAAC,WACJ,MAAM,IAAI,eAAe,mCAAmC,WAAW;CAExE,kBAAkB,WAAW,SAAS,UAAU;CAChD,OAAO;AACR;AAEA,eAAsB,UACrB,UACA,OACA,UAGI,CAAC,GACiB;CACtB,IAAI,MAAM,WAAW,GACpB,OAAO,CAAC;CAET,IAAI;CACJ,IAAI;EACH,aAAa,MAAM,gBACjB,WACA,WAAW,KAAA,IACR,SAAS,MAAM,KAAK,IACpB,SAAS,MAAM,OAAO,EAAE,OAAO,CAAC,GACpC;GACC,GAAI,QAAQ,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ,QAAQ,OAAO;GACjE,GAAI,QAAQ,eAAe,KAAA,IACxB,CAAC,IACD,EAAE,YAAY,QAAQ,WAAW;EACrC,CACD;CACD,SAAS,OAAO;EACf,IACC,iBAAiB,mBAChB,MAAM,SAAS,aAAa,MAAM,SAAS,YAE5C,MAAM;EAEP,MAAM,IAAI,eAAe,0BAA0B,aAAa,KAAK;CACtE;CACA,IAAI,WAAW,WAAW,MAAM,QAC/B,MAAM,IAAI,eACT,qBAAqB,WAAW,OAAO,kBAAkB,MAAM,OAAO,UACtE,WACD;CAED,KAAK,MAAM,aAAa,YACvB,kBAAkB,WAAW,SAAS,UAAU;CAEjD,OAAO;AACR;;;ACzFA,SAAgB,qBACf,OACA,OACA,OAAgC,cACN;CAC1B,IAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,WAAW,GACxD,MAAM,IAAI,eAAe,GAAG,MAAM,+BAA+B,IAAI;AAEvE;AAEA,SAAgB,YAAY,OAAqB;CAChD,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,GACvC,MAAM,IAAI,eAAe,qCAAqC,YAAY;AAE5E;AAEA,SAAgB,eAAe,OAAqB;CACnD,IAAI,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ,KAAK,QAAQ,GACnD,MAAM,IAAI,eACT,8CACA,YACD;AAEF;AAEA,SAAgB,eAAe,UAA0B;CACxD,IAAI,CAAC,YAAY,OAAO,SAAS,UAAU,YAC1C,MAAM,IAAI,eACT,gDACA,QACD;CAED,qBAAqB,SAAS,OAAO,kBAAkB,QAAQ;CAC/D,IAAI,CAAC,OAAO,UAAU,SAAS,UAAU,KAAK,SAAS,aAAa,GACnE,MAAM,IAAI,eACT,mDACA,QACD;AAEF;AAEA,MAAM,wBAAwB;CAC7B;CACA;CACA;CACA;CACA;CACA;AACD;AAEA,SAAS,gCAAgC,OAAe,OAAqB;CAC5E,IAAI,CAAC,OAAO,SAAS,KAAK,KAAK,SAAS,GACvC,MAAM,IAAI,eACT,GAAG,MAAM,qCACT,QACD;AAEF;AAEA,SAAgB,wBACf,QACO;CACP,IAAI,WAAW,KAAA,GACd;CAGD,IAAI,cAAc;CAClB,KAAK,MAAM,OAAO,uBAAuB;EACxC,MAAM,SAAS,OAAO,UAAU,QAAQ,0BAA0B;EAClE,IAAI,CAAC,OAAO,SAAS,MAAM,KAAK,SAAS,GACxC,MAAM,IAAI,eACT,qBAAqB,IAAI,yCACzB,QACD;EAED,eAAe;CAChB;CACA,IAAI,gBAAgB,GACnB,MAAM,IAAI,eACT,qEACA,QACD;CAGD,IAAI,OAAO,wBAAwB,KAAA,GAClC,gCACC,OAAO,qBACP,+BACD;CAED,IAAI,OAAO,qBAAqB,KAAA,GAC/B,gCACC,OAAO,kBACP,4BACD;CAED,IACC,OAAO,wBAAwB,KAAA,MAC9B,CAAC,OAAO,UAAU,OAAO,mBAAmB,KAC5C,OAAO,sBAAsB,IAE9B,MAAM,IAAI,eACT,gFACA,QACD;AAEF;AAEA,SAAgB,0BAA0B,OAAgC;CACzE,IACC,MAAM,cAAc,KAAA,MACnB,CAAC,OAAO,UAAU,MAAM,SAAS,KAAK,MAAM,YAAY,IAEzD,MAAM,IAAI,eACT,uDACA,YACD;AAEF;AAEA,SAAgB,sBAAsB,OAA4B;CACjE,qBAAqB,MAAM,UAAU,UAAU;CAC/C,qBAAqB,MAAM,SAAS,SAAS;CAC7C,IAAI,MAAM,aAAa,KAAA,GACtB,mBAAmB,MAAM,QAAQ;CAElC,IACC,MAAM,eAAe,KAAA,MACpB,CAAC,OAAO,SAAS,MAAM,UAAU,KACjC,MAAM,aAAa,KACnB,MAAM,aAAa,IAEpB,MAAM,IAAI,eACT,gDACA,YACD;AAEF;AAEA,SAAgB,oBAAoB,OAA0B;CAC7D,qBAAqB,MAAM,UAAU,UAAU;CAC/C,qBAAqB,MAAM,OAAO,OAAO;CACzC,IAAI,MAAM,UAAU,KAAA,GACnB,YAAY,MAAM,KAAK;CAExB,IAAI,MAAM,aAAa,KAAA,GACtB,eAAe,MAAM,QAAQ;AAE/B;AAEA,SAAgB,0BACf,OACc;CACd,OAAO;EACN,UAAU,MAAM;EAChB,OAAO,MAAM;EACb,GAAI,MAAM,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,MAAM,MAAM;EAC1D,GAAI,MAAM,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,MAAM,SAAS;EACnE,GAAI,MAAM,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,MAAM,MAAM;EAC1D,GAAI,MAAM,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,MAAM,KAAK;EACvD,GAAI,MAAM,sBAAsB,KAAA,IAC7B,CAAC,IACD,EAAE,mBAAmB,MAAM,kBAAkB;EAChD,GAAI,MAAM,mBAAmB,KAAA,IAC1B,CAAC,IACD,EAAE,gBAAgB,MAAM,eAAe;CAC3C;AACD;;;;;;AAOA,SAAgB,mBAAmB,OAAyB;CAC3D,IAAI,MAAM,aAAa,KAAA,GACtB,qBAAqB,MAAM,UAAU,UAAU;CAWhD,IAAI,EARH,MAAM,aAAa,KAAA,KACnB,MAAM,YAAY,QAClB,MAAM,eAAe,QACrB,MAAM,kBAAkB,KAAA,KACxB,MAAM,qBAAqB,KAAA,KAC1B,MAAM,UAAU,KAAA,KAAa,MAAM,MAAM,SAAS,KAClD,MAAM,SAAS,KAAA,KAAa,MAAM,KAAK,SAAS,KACjD,MAAM,kBAAkB,KAAA,IAExB,MAAM,IAAI,eACT,yIACA,YACD;AAEF;;;;;AAMA,SAAgB,4BAA4B,OAAkC;CAC7E,qBAAqB,MAAM,UAAU,UAAU;CAC/C,IAAI,MAAM,cAAc,KAAA;MAEtB,CAAC,OAAO,SAAS,MAAM,SAAS,KAChC,MAAM,YAAY,KAClB,MAAM,YAAY,GAElB,MAAM,IAAI,eACT,+CACA,YACD;CAAA;CAGF,IAAI,MAAM,UAAU,KAAA,GACnB,YAAY,MAAM,KAAK;AAEzB;;;;;;AAOA,SAAgB,yBAAyB,OAA+B;CACvE,qBAAqB,MAAM,UAAU,UAAU;CAC/C,qBAAqB,MAAM,YAAY,YAAY;CACnD,IAAI,MAAM,cAAc,WAAW,GAClC,MAAM,IAAI,eACT,sDACA,YACD;CAED,IAAI,MAAM,cAAc,SAAS,MAAM,UAAU,GAChD,MAAM,IAAI,eACT,gDACA,YACD;CAED,KAAK,MAAM,MAAM,MAAM,eACtB,qBAAqB,IAAI,kBAAkB;AAE7C;;;;;AAMA,SAAgB,0BAA0B,OAAgC;CACzE,qBAAqB,MAAM,UAAU,UAAU;CAC/C,IAAI,MAAM,UAAU,KAAA,GACnB,YAAY,MAAM,KAAK;AAEzB;;;AClNA,SAAS,8BACR,OACoC;CACpC,OAAO,MAAM,QAAQ,KAAK;AAC3B;AAEA,SAAS,gBACR,QACA,QACC;CACD,OAAO;EACN,GAAI,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO;EACzC,GAAI,OAAO,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY,OAAO,SAAS;CACxE;AACD;AAEA,SAAS,mBACR,QACA,OACA,WACA,KACC;CACD,OAAO;EACN,IAAI,SAAS;EACb,UAAU,MAAM;EAChB,SAAS,MAAM;EACf,MAAM,MAAM,QAAA;EACZ,YAAY,MAAM,cAAA;EAClB,MAAM,cAAc,MAAM,IAAI;EAC9B,QAAQ,MAAM,UAAU;EACxB,UAAU,gBAAgB,MAAM,YAAY,CAAC,CAAC;EAC9C,YAAY,MAAM,cAAc;EAChC,gBAAgB,OAAO,SAAS;EAChC,qBAAqB,OAAO,SAAS;EACrC,cAAc;EACd,cAAc;EACd,WAAW,MAAM,aAAa;EAC9B,gBAAgB;EAChB,aAAa;EACb,WAAW;EACX,WAAW;EACX;CACD;AACD;AAEA,SAAS,WACR,UACA,aACA,UACA,4BAAY,IAAI,KAAK,GACR;CACb,OAAO;EACN,IAAI,cAAc;EAClB;EACA;EACA,UAAU,gBAAgB,QAAQ;EAClC;CACD;AACD;AAEA,SAAS,gBAAgB,MAIP;CACjB,OAAO;EACN,GAAG,YAAY,KAAK,CAAC;EACrB,GAAG,YAAY,KAAK,CAAC;EACrB,YAAY,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,UAAU,CAAC;CACrD;AACD;AAEA,SAAgB,mBACf,QACA,OACkB;CAClB,IAAI,SAAS;CAEb,SAAS,aAAmB;EAC3B,IAAI,QACH,MAAM,IAAI,eAAe,+BAA+B,IAAI;CAE9D;CAEA,eAAe,eAA8B;EAC5C,MAAM,MAAM,aAAa;CAC1B;CAEA,eAAe,+BAA8C;EAC5D,MAAM,MAAM,6BAA6B,OAAO,QAAQ;CACzD;CAEA,eAAe,YAAY,QAA8C;EACxE,IAAI,OAAO,WAAW,KAAK,OAAO,OAAO,YAAY,MACpD;EAED,IAAI;GACH,MAAM,MAAM,eAAe,MAAM;EAClC,QAAQ,CAER;CACD;CAEA,eAAe,SAAS,OAAuC;EAC9D,MAAM,gBAA+B;GACpC,GAAG;GACH,UAAU,gBAAgB,MAAM,YAAY,CAAC,CAAC;EAC/C;EACA,OAAO,QACN,QACA,MAAM,SACN,YACA,EAAE,UAAU,cAAc,SAAS,GACnC,YAAY;GACX,WAAW;GACX,sBAAsB,aAAa;GACnC,MAAM,6BAA6B;GACnC,MAAM,YAAY,MAAM,SACvB,OAAO,UACP,cAAc,SACd,gBAAgB,QAAQ,cAAc,MAAM,CAC7C;GACA,MAAM,CAAC,UAAU,MAAM,MAAM,eAAe,CAC3C,mBAAmB,QAAQ,eAAe,2BAAW,IAAI,KAAK,CAAC,CAChE,CAAC;GACD,IAAI,CAAC,QACJ,MAAM,IAAI,eAAe,mCAAmC,IAAI;GAEjE,MAAM,YAAY,CACjB,WAAW,OAAO,UAAU,kBAAkB;IAC7C,UAAU,OAAO;IACjB,MAAM,OAAO;IACb,YAAY,OAAO;GACpB,CAAC,CACF,CAAC;GACD,OAAO,YAAY,MAAM;EAC1B,IACC,YAAY;GAAE,UAAU,OAAO;GAAI,OAAO;EAAE,EAC9C;CACD;CAEA,eAAe,aACd,OACoB;EACpB,MAAM,aAAa,8BAA8B,KAAK;EACtD,MAAM,SAAS,aAAa,QAAQ,MAAM;EAC1C,MAAM,SAAS,aAAa,MAAM,IAAI,SAAS,MAAM;EACrD,MAAM,iBAAiB,OAAO,KAC5B,UAAyB;GACzB,GAAG;GACH,UAAU,gBAAgB,KAAK,YAAY,CAAC,CAAC;EAC9C,EACD;EACA,OAAO,QACN,QACA,MAAM,SACN,gBACA,EAAE,OAAO,eAAe,OAAO,GAC/B,YAAY;GACX,WAAW;GACX,IAAI,eAAe,WAAW,GAC7B,OAAO,CAAC;GAET,KAAK,MAAM,QAAQ,gBAClB,sBAAsB,IAAI;GAE3B,MAAM,6BAA6B;GACnC,MAAM,aAAa,MAAM,UACxB,OAAO,UACP,eAAe,KAAK,SAAS,KAAK,OAAO,GACzC,gBAAgB,QAAQ,MAAM,CAC/B;GACA,MAAM,sBAAM,IAAI,KAAK;GACrB,MAAM,SAAS,eAAe,KAAK,MAAM,QACxC,mBAAmB,QAAQ,MAAM,WAAW,MAAkB,GAAG,CAClE;GACA,MAAM,WAAW,MAAM,MAAM,eAAe,MAAM;GAClD,MAAM,YACL,SAAS,KAAK,WACb,WAAW,OAAO,UAAU,kBAAkB;IAC7C,UAAU,OAAO;IACjB,MAAM,OAAO;IACb,YAAY,OAAO;GACpB,CAAC,CACF,CACD;GACA,OAAO,SAAS,IAAI,WAAW;EAChC,IACC,YAAY,EAAE,OAAO,OAAO,OAAO,EACrC;CACD;CAEA,MAAM,SAA0B;EAC/B;EACA;EACA,MAAM,OAAO,OAAO;GACnB,OAAO,QACN,QACA,MAAM,SACN,UACA,EAAE,UAAU,MAAM,SAAS,GAC3B,YAAY;IACX,WAAW;IACX,oBAAoB,KAAK;IACzB,MAAM,QAAQ,MAAM,SAAS,OAAO,UAAU,SAAA;IAC9C,MAAM,WACL,MAAM,YAAY,OAAO,UAAU,YAAA;IACpC,YAAY,KAAK;IACjB,eAAe,QAAQ;IACvB,MAAM,6BAA6B;IACnC,MAAM,iBAAiB,MAAM,SAC5B,OAAO,UACP,MAAM,OACN,gBAAgB,QAAQ,MAAM,MAAM,CACrC;IACA,MAAM,sBACL,OAAO,WAAW,uBAAA;IAEnB,MAAM,iBAAiB,KAAK,IAAI,OAAO,QAAQ,mBAAmB;IAClE,MAAM,eAAe,oBAAoB,MAAM,KAAK;IACpD,MAAM,gBAAgB,oBAAoB,OAAO,SAAS;IAC1D,MAAM,CAAC,kBAAkB,qBAAqB,MAAM,QAAQ,IAAI,CAC/D,MAAM,aAAa;KAClB,GAAG;KACH,WAAW;KACX,OAAO;KACP,UAAU;IACX,CAAC,GACD,MAAM,cAAc;KAAE,GAAG;KAAO,OAAO;IAAe,CAAC,CACxD,CAAC;IACD,MAAM,yBAAS,IAAI,IAA6B;IAChD,KAAK,MAAM,aAAa,kBACvB,OAAO,IAAI,UAAU,OAAO,IAAI;KAC/B,QAAQ,UAAU;KAClB,aAAa,UAAU;KACvB,cAAc,aAAa,UAAU,OAAO,OAAO;IACpD,CAAC;IAEF,MAAM,cAAc,kBAAkB,QACpC,cAAc,CAAC,OAAO,IAAI,UAAU,OAAO,EAAE,CAC/C;IACA,MAAM,wBAAwB,MAAM,MAAM,oBACzC,YAAY,KAAK,cAAc,UAAU,OAAO,EAAE,CACnD;IACA,KAAK,MAAM,aAAa,mBAAmB;KAC1C,MAAM,WAAW,OAAO,IAAI,UAAU,OAAO,EAAE;KAC/C,IAAI,UAAU;MACb,SAAS,eAAe,UAAU;MAClC;KACD;KACA,MAAM,YAAY,sBAAsB,IAAI,UAAU,OAAO,EAAE;KAC/D,MAAM,aAAa,YAChB,iBAAiB,WAAW,cAAc,IAC1C;KACH,OAAO,IAAI,UAAU,OAAO,IAAI;MAC/B,QAAQ,UAAU;MAClB,aAAa,KAAK,IAAI,GAAG,UAAU;MACnC,cAAc,UAAU;KACzB,CAAC;IACF;IACA,MAAM,SAA4B,MAAM,KAAK,OAAO,OAAO,CAAC,EAC1D,KAAK,UACL,yBACC,MAAM,QACN,KAAK,IAAI,GAAG,MAAM,WAAW,GAC7B,KAAK,IAAI,GAAG,MAAM,YAAY,GAC9B,OACA,aACD,CACD,EACC,QAAQ,WAAW,OAAO,SAAS,QAAQ,EAC3C,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,EAChC,MAAM,GAAG,KAAK;IAChB,MAAM,MAAM,qBAAqB,OAAO,KAAK,WAAW,OAAO,EAAE,CAAC;IAClE,OAAO;GACR,IACC,YAAY,EAAE,OAAO,OAAO,OAAO,EACrC;EACD;EACA,MAAM,aAAa,OAAO;GACzB,OAAO,QACN,QACA,MAAM,SACN,gBACA,EAAE,UAAU,MAAM,SAAS,GAC3B,YAAY;IACX,WAAW;IACX,0BAA0B,KAAK;IAC/B,OAAO,aAAa;KACnB;KACA,SAAS,iBAAiB;MACzB,MAAM,cAAc,0BAA0B,YAAY;MAC1D,OAAO,OAAO,OACb,MAAM,WAAW,KAAA,IACd,cACA;OAAE,GAAG;OAAa,QAAQ,MAAM;MAAO,CAC3C;KACD;IACD,CAAC;GACF,CACD;EACD;EACA,MAAM,OAAO,OAAO;GACnB,OAAO,QACN,QACA,MAAM,SACN,UACA;IAAE,UAAU,MAAM;IAAU,UAAU,MAAM;GAAS,GACrD,YAAY;IACX,WAAW;IACX,qBAAqB,MAAM,UAAU,UAAU;IAC/C,qBAAqB,MAAM,UAAU,UAAU;IAC/C,MAAM,aAAa;IAKnB,IAAI,CAAC,MAJiB,MAAM,aAC3B,MAAM,UACN,MAAM,QACP,GAEC,MAAM,IAAI,eAAe,yBAAyB,WAAW;IAE9D,MAAM,YAAY,CACjB,WAAW,MAAM,UAAU,kBAAkB,EAC5C,UAAU,MAAM,SACjB,CAAC,CACF,CAAC;GACF,CACD;EACD;EACA,MAAM,UAAU,OAAO;GACtB,OAAO,QACN,QACA,MAAM,SACN,aACA,EAAE,UAAU,MAAM,SAAS,GAC3B,YAAY;IACX,WAAW;IACX,qBAAqB,MAAM,UAAU,UAAU;IAC/C,MAAM,aAAa;IACnB,MAAM,eAAe,MAAM,MAAM,wBAChC,MAAM,QACP;IACA,MAAM,YAAY,CACjB,WAAW,MAAM,UAAU,kBAAkB,EAC5C,OAAO,aACR,CAAC,CACF,CAAC;IACD,OAAO;GACR,IACC,WAAW,EAAE,MAAM,EACrB,EAAE,WAAW,KAAA,CAAS;EACvB;EACA,MAAM,MAAM,OAAO;GAClB,OAAO,QACN,QACA,MAAM,SACN,SACA,MAAM,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,MAAM,SAAS,GAC/D,YAAY;IACX,WAAW;IACX,mBAAmB,KAAK;IACxB,MAAM,aAAa;IACnB,MAAM,SAAS,MAAM,MAAM,MAAM,KAAK;IACtC,IACC,OAAO,eAAe,KACtB,MAAM,aAAa,KAAA,KACnB,OAAO,WAAW,OAElB,MAAM,YAAY,CACjB,WAAW,MAAM,UAAU,iBAAiB,EAC3C,OAAO,OAAO,aACf,CAAC,CACF,CAAC;IAEF,OAAO;GACR,IACC,YAAY,EAAE,OAAO,OAAO,aAAa,EAC3C;EACD;EACA,MAAM,eAAe,OAAO;GAC3B,OAAO,QACN,QACA,MAAM,SACN,kBACA,EAAE,UAAU,MAAM,SAAS,GAC3B,YAAY;IACX,WAAW;IACX,4BAA4B,KAAK;IACjC,MAAM,6BAA6B;IAEnC,QAAO,MADa,MAAM,mBAAmB,KAAK,GACrC,IAAI,eAAe;GACjC,IACC,YAAY,EAAE,OAAO,OAAO,OAAO,EACrC;EACD;EACA,MAAM,aAAa,OAAO;GACzB,OAAO,QACN,QACA,MAAM,SACN,gBACA,EAAE,UAAU,MAAM,SAAS,GAC3B,YAAY;IACX,WAAW;IACX,0BAA0B,KAAK;IAC/B,MAAM,aAAa;IAEnB,QAAO,MADc,MAAM,aAAa,KAAK,GAC/B,KAAK,WAAW;KAC7B,IAAI,MAAM;KACV,UAAU,MAAM;KAChB,aAAa,MAAM;KACnB,UAAU,gBAAgB,MAAM,QAAQ;KACxC,WAAW,IAAI,KAAK,MAAM,SAAS;IACpC,EAAE;GACH,IACC,YAAY,EAAE,OAAO,OAAO,OAAO,EACrC;EACD;EACA,MAAM,MAAM,OAAO;GAClB,OAAO,QACN,QACA,MAAM,SACN,SACA,OAAO,WAAW,EAAE,UAAU,MAAM,SAAS,IAAI,CAAC,GAClD,YAAY;IACX,WAAW;IACX,MAAM,aAAa;IACnB,OAAO,MAAM,MAAM,uBAAO,IAAI,KAAK,CAAC;GACrC,CACD;EACD;EACA,cAAc,EACb,MAAM,YAAY,OAAqD;GACtE,OAAO,QACN,QACA,MAAM,SACN,eACA;IAAE,UAAU,MAAM;IAAU,UAAU,MAAM;GAAW,GACvD,YAAY;IACX,WAAW;IACX,yBAAyB,KAAK;IAC9B,MAAM,aAAa;IACnB,MAAM,WAAW,MAAM,MAAM,UAC5B,MAAM,UACN,MAAM,UACP;IACA,IAAI,CAAC,UACJ,MAAM,IAAI,eACT,kCACA,WACD;IAED,IAAI,SAAS,iBAAiB,MAC7B,MAAM,IAAI,eACT,yCACA,YACD;IAED,MAAM,UAAU,MAAM,MAAM,yBAC3B,MAAM,UACN,MAAM,aACP;IACA,MAAM,WAAW,IAAI,IAAI,QAAQ,KAAK,WAAW,OAAO,EAAE,CAAC;IAC3D,KAAK,MAAM,MAAM,MAAM,eACtB,IAAI,CAAC,SAAS,IAAI,EAAE,GACnB,MAAM,IAAI,eACT,oCACA,WACD;IAGF,MAAM,SAAS,QAAQ,QACrB,WAAW,OAAO,iBAAiB,IACrC;IACA,IAAI,OAAO,WAAW,GACrB,OAAO;KACN,YAAY,SAAS;KACrB,iBAAiB;KACjB,eAAe,CAAC;IACjB;IAED,MAAM,SAAS,MAAM,MAAM,YAAY;KACtC,UAAU,MAAM;KAChB,YAAY,SAAS;KACrB,cAAc,SAAS;KACvB,eAAe,OAAO,KAAK,UAAU,MAAM,EAAE;KAC7C,WAAW,MAAM,cAAc;KAC/B,qBAAK,IAAI,KAAK;KACd,cAAc,OAAO,OAAO,YAAY;IACzC,CAAC;IACD,OAAO;KACN,YAAY,SAAS;KACrB,iBAAiB,OAAO,cAAc;KACtC,eAAe,OAAO;IACvB;GACD,IACC,YAAY,EAAE,OAAO,OAAO,gBAAgB,EAC9C;EACD,EACD;EACA,MAAM,QAAQ;GACb,OAAO,QAAQ,QAAQ,MAAM,SAAS,SAAS,CAAC,GAAG,YAAY;IAC9D,IAAI,CAAC,QAAQ;KACZ,SAAS;KACT,MAAM,MAAM,MAAM;IACnB;GACD,CAAC;EACF;CACD;CAEA,OAAO;AACR;;;AC/iBA,SAAgB,UAAU,QAAgB,KAAoB;CAC7D,OACC,OAAO,cAAc,QAAQ,OAAO,UAAU,QAAQ,KAAK,IAAI,QAAQ;AAEzE;;;;;;;;AASA,SAAgB,mBACf,QACA,OACA,KACU;CACV,IAAI,MAAM,aAAa,KAAA,KAAa,OAAO,aAAa,MAAM,UAC7D,OAAO;CAER,IAAI,MAAM,YAAY,QAAQ,CAAC,UAAU,QAAQ,GAAG,GACnD,OAAO;CAER,IAAI,MAAM,eAAe,QAAQ,OAAO,iBAAiB,MACxD,OAAO;CAER,IACC,MAAM,kBAAkB,KAAA,KACxB,OAAO,UAAU,QAAQ,KAAK,MAAM,cAAc,QAAQ,GAE1D,OAAO;CAER,IAAI,MAAM,qBAAqB,KAAA,GAAW;EACzC,MAAM,OAAO,OAAO;EACpB,IAAI,SAAS,QAAQ,KAAK,QAAQ,KAAK,MAAM,iBAAiB,QAAQ,GACrE,OAAO;CAET;CACA,IAAI,MAAM,UAAU,KAAA,KAAa,CAAC,MAAM,MAAM,SAAS,OAAO,IAAI,GACjE,OAAO;CAER,IACC,MAAM,SAAS,KAAA,KACf,MAAM,KAAK,SAAS,KACpB,CAAC,MAAM,KAAK,OAAO,QAAQ,OAAO,KAAK,SAAS,GAAG,CAAC,GAEpD,OAAO;CAER,IACC,MAAM,kBAAkB,KAAA,KACxB,gBAAgB,OAAO,cAAc,gBAAgB,MAAM,gBAE3D,OAAO;CAER,OAAO;AACR;;;;;AAMA,SAAgB,uBACf,QACA,OACA,KACU;CACV,IAAI,OAAO,aAAa,MAAM,UAC7B,OAAO;CAER,IAAI,MAAM,sBAAsB,QAAQ,OAAO,iBAAiB,MAC/D,OAAO;CAER,IAAI,MAAM,mBAAmB,QAAQ,UAAU,QAAQ,GAAG,GACzD,OAAO;CAER,IAAI,MAAM,UAAU,KAAA,KAAa,CAAC,MAAM,MAAM,SAAS,OAAO,IAAI,GACjE,OAAO;CAER,IACC,MAAM,SAAS,KAAA,KACf,MAAM,KAAK,SAAS,KACpB,CAAC,MAAM,KAAK,OAAO,QAAQ,OAAO,KAAK,SAAS,GAAG,CAAC,GAEpD,OAAO;CAER,OAAO;AACR;AAEA,SAAgB,oBACf,QACA,OACA,KACU;CACV,IAAI,OAAO,aAAa,MAAM,UAC7B,OAAO;CAER,IAAI,CAAC,MAAM,qBAAqB,OAAO,iBAAiB,MACvD,OAAO;CAER,IAAI,CAAC,MAAM,kBAAkB,UAAU,QAAQ,GAAG,GACjD,OAAO;CAER,IAAI,MAAM,SAAS,CAAC,MAAM,MAAM,SAAS,OAAO,IAAI,GACnD,OAAO;CAER,IAAI,MAAM,QAAQ,CAAC,MAAM,KAAK,OAAO,QAAQ,OAAO,KAAK,SAAS,GAAG,CAAC,GACrE,OAAO;CAER,IAAI,MAAM,UAAU,OAAO,aAAa,MAAM,QAC7C,OAAO;CAER,IAAI,MAAM,SAAS,OAAO,aAAa,MAAM,OAC5C,OAAO;CAER,OAAO;AACR;;;AC1FA,SAAS,kBAAkB,QAAoC;CAC9D,OAAO;EACN,GAAG,YAAY,MAAM;EACrB,WAAW,CAAC,GAAG,OAAO,SAAS;CAChC;AACD;AAEA,SAAS,gBAAgB,OAA+B;CACvD,OAAO;EACN,IAAI,MAAM;EACV,UAAU,MAAM;EAChB,aAAa,MAAM;EACnB,UAAU,gBAAgB,MAAM,QAAQ;EACxC,WAAW,IAAI,KAAK,MAAM,SAAS;CACpC;AACD;AAEA,SAAgB,sBAAmC;CAClD,MAAM,2BAAW,IAAI,IAA0B;CAC/C,MAAM,WAAyB,CAAC;CAEhC,OAAO;EACN,SAAS;EACT,MAAM,eAAe,CAAC;EACtB,MAAM,+BAA+B,CAAC;EACtC,MAAM,eAAe,MAAM;GAC1B,MAAM,WAAqB,CAAC;GAC5B,KAAK,MAAM,OAAO,MAAM;IACvB,MAAM,SAAS,kBAAkB,GAAG;IACpC,SAAS,IAAI,OAAO,IAAI,MAAM;IAC9B,SAAS,KAAK,YAAY,MAAM,CAAC;GAClC;GACA,OAAO;EACR;EACA,MAAM,aAAa,OAA+B;GACjD,MAAM,sBAAM,IAAI,KAAK;GACrB,MAAM,WAAW,MAAM,YAAY;GACnC,OAAO,MAAM,KAAK,SAAS,OAAO,CAAC,EACjC,QAAQ,WAAW,oBAAoB,QAAQ,OAAO,GAAG,CAAC,EAC1D,KAAK,YAAY;IACjB,QAAQ,YAAY,MAAM;IAC1B,aAAa,KAAK,IACjB,GACA,iBAAiB,OAAO,WAAW,MAAM,SAAS,CACnD;GACD,EAAE,EACD,QAAQ,cAAc,UAAU,eAAe,QAAQ,EACvD,MAAM,GAAG,MAAM,EAAE,cAAc,EAAE,WAAW,EAC5C,MAAM,GAAG,MAAM,KAAK;EACvB;EACA,MAAM,cAAc,OAAgC;GACnD,MAAM,sBAAM,IAAI,KAAK;GACrB,MAAM,eAAe,oBAAoB,MAAM,KAAK;GACpD,OAAO,MAAM,KAAK,SAAS,OAAO,CAAC,EACjC,QAAQ,WAAW,oBAAoB,QAAQ,OAAO,GAAG,CAAC,EAC1D,KAAK,YAAY;IACjB,QAAQ,YAAY,MAAM;IAC1B,cAAc,aAAa,OAAO,OAAO;GAC1C,EAAE,EACD,QAAQ,cAAc,UAAU,eAAe,CAAC,EAChD,MAAM,GAAG,MAAM,EAAE,eAAe,EAAE,YAAY,EAC9C,MAAM,GAAG,MAAM,KAAK;EACvB;EACA,MAAM,oBAAoB,WAAW;GACpC,MAAM,yBAAS,IAAI,IAAsB;GACzC,KAAK,MAAM,MAAM,WAAW;IAC3B,MAAM,SAAS,SAAS,IAAI,EAAE;IAC9B,IAAI,QACH,OAAO,IAAI,IAAI,CAAC,GAAG,OAAO,SAAS,CAAC;GAEtC;GACA,OAAO;EACR;EACA,MAAM,qBAAqB,WAAW;GACrC,MAAM,sBAAM,IAAI,KAAK;GACrB,KAAK,MAAM,MAAM,WAAW;IAC3B,MAAM,SAAS,SAAS,IAAI,EAAE;IAC9B,IAAI,QAAQ;KACX,OAAO,iBAAiB;KACxB,OAAO,eAAe;KACtB,OAAO,YAAY;IACpB;GACD;EACD;EACA,MAAM,aAAa,UAAU,UAAU;GACtC,MAAM,SAAS,SAAS,IAAI,QAAQ;GACpC,IAAI,CAAC,UAAU,OAAO,aAAa,UAClC,OAAO;GAER,OAAO,SAAS,OAAO,QAAQ;EAChC;EACA,MAAM,wBAAwB,UAAU;GACvC,IAAI,UAAU;GACd,KAAK,MAAM,CAAC,IAAI,WAAW,UAC1B,IAAI,OAAO,aAAa,UAAU;IACjC,SAAS,OAAO,EAAE;IAClB,WAAW;GACZ;GAED,OAAO;EACR;EACA,MAAM,MAAM,OAAO;GAClB,MAAM,sBAAM,IAAI,KAAK;GACrB,MAAM,UAAoB,CAAC;GAC3B,KAAK,MAAM,UAAU,SAAS,OAAO,GACpC,IAAI,mBAAmB,QAAQ,OAAO,GAAG,GACxC,QAAQ,KAAK,OAAO,EAAE;GAGxB,MAAM,SAAS,MAAM,WAAW;GAChC,IAAI,CAAC,QACJ,KAAK,MAAM,MAAM,SAChB,SAAS,OAAO,EAAE;GAGpB,OAAO;IACN,cAAc,QAAQ;IACtB,cAAc,SAAS,IAAI,QAAQ;IACnC;GACD;EACD;EACA,MAAM,mBAAmB,OAAO;GAC/B,MAAM,YAAY,MAAM,aAAA;GACxB,MAAM,QAAQ,MAAM,SAAA;GACpB,MAAM,sBAAM,IAAI,KAAK;GACrB,MAAM,aAAa,MAAM,KAAK,SAAS,OAAO,CAAC,EAAE,QAAQ,WACxD,uBAAuB,QAAQ,OAAO,GAAG,CAC1C;GACA,MAAM,QAA8B,CAAC;GACrC,KAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK,GAAG;IAC9C,MAAM,IAAI,WAAW;IACrB,IAAI,MAAM,KAAA,GACT;IAED,KAAK,IAAI,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK,GAAG;KAClD,MAAM,IAAI,WAAW;KACrB,IAAI,MAAM,KAAA,GACT;KAED,MAAM,aAAa,KAAK,IACvB,GACA,KAAK,IAAI,GAAG,iBAAiB,EAAE,WAAW,EAAE,SAAS,CAAC,CACvD;KACA,IAAI,cAAc,WACjB,MAAM,KAAK;MACV,GAAG,YAAY,CAAC;MAChB,GAAG,YAAY,CAAC;MAChB;KACD,CAAC;IAEH;GACD;GACA,MAAM,MAAM,GAAG,MAAM,EAAE,aAAa,EAAE,UAAU;GAChD,OAAO,MAAM,MAAM,GAAG,KAAK;EAC5B;EACA,MAAM,eAAe,QAAQ;GAC5B,SAAS,KAAK,GAAG,OAAO,IAAI,eAAe,CAAC;EAC7C;EACA,MAAM,aAAa,OAAO;GACzB,MAAM,QAAQ,MAAM,SAAA;GAEpB,OADgB,SAAS,KAAK,OAAO,SAAS;IAAE;IAAO;GAAI,EAC9C,EACX,QAAQ,EAAE,YAAY;IACtB,IAAI,MAAM,aAAa,MAAM,UAC5B,OAAO;IAER,IACC,MAAM,WAAW,KAAA,KACjB,MAAM,UAAU,QAAQ,KAAK,MAAM,OAAO,QAAQ,GAElD,OAAO;IAER,IACC,MAAM,UAAU,KAAA,KAChB,MAAM,UAAU,QAAQ,KAAK,MAAM,MAAM,QAAQ,GAEjD,OAAO;IAER,OAAO;GACR,CAAC,EACA,MAAM,GAAG,MAAM;IACf,MAAM,KAAK,EAAE,MAAM,UAAU,QAAQ,IAAI,EAAE,MAAM,UAAU,QAAQ;IACnE,OAAO,OAAO,IAAI,EAAE,MAAM,EAAE,MAAM;GACnC,CAAC,EACA,MAAM,GAAG,KAAK,EACd,KAAK,EAAE,YAAY,gBAAgB,KAAK,CAAC;EAC5C;EACA,MAAM,UAAU,UAAU,UAAU;GACnC,MAAM,SAAS,SAAS,IAAI,QAAQ;GACpC,OAAO,UAAU,OAAO,aAAa,WAClC,YAAY,MAAM,IAClB;EACJ;EACA,MAAM,yBAAyB,UAAU,KAAK;GAC7C,OAAO,IAAI,SAAS,OAAO;IAC1B,MAAM,SAAS,SAAS,IAAI,EAAE;IAC9B,IAAI,CAAC,UAAU,OAAO,aAAa,UAClC,OAAO,CAAC;IAET,OAAO,CACN;KACC,IAAI,OAAO;KACX,MAAM,CAAC,GAAG,OAAO,IAAI;KACrB,cAAc,OAAO;IACtB,CACD;GACD,CAAC;EACF;EACA,MAAM,YACL,OACkC;GAClC,MAAM,WAAW,SAAS,IAAI,MAAM,UAAU;GAC9C,MAAM,kBAA4B,CAAC;GACnC,KAAK,MAAM,MAAM,MAAM,eAAe;IACrC,MAAM,SAAS,SAAS,IAAI,EAAE;IAC9B,IAAI,CAAC,UAAU,OAAO,aAAa,MAAM,UACxC;IAED,IAAI,OAAO,iBAAiB,MAC3B;IAED,OAAO,eAAe,MAAM;IAC5B,OAAO,eAAe,MAAM;IAC5B,OAAO,YAAY,MAAM;IACzB,gBAAgB,KAAK,OAAO,EAAE;GAC/B;GACA,IAAI,YAAY,MAAM,aAAa,gBAAgB,SAAS,GAAG;IAC9D,MAAM,aAAa,IAAI,IAAI,MAAM,YAAY;IAC7C,KAAK,MAAM,MAAM,iBAAiB;KACjC,MAAM,SAAS,SAAS,IAAI,EAAE;KAC9B,IAAI,QACH,KAAK,MAAM,OAAO,OAAO,MACxB,WAAW,IAAI,GAAG;IAGrB;IACA,IAAI,WAAW,SAAS,SAAS,KAAK,QAAQ;KAC7C,SAAS,OAAO,CAAC,GAAG,UAAU;KAC9B,SAAS,YAAY,MAAM;IAC5B;GACD;GACA,IAAI,MAAM,cACT,KAAK,MAAM,MAAM,iBAChB,SAAS,KAAK;IACb,IAAI,cAAc;IAClB,UAAU,MAAM;IAChB,aAAa;IACb,UAAU;KAAE,UAAU;KAAI,cAAc,MAAM;IAAW;IACzD,WAAW,MAAM;GAClB,CAAC;GAGH,OAAO,EAAE,eAAe,gBAAgB;EACzC;EACA,MAAM,MAAM,OAAO,KAAK;GACvB,MAAM,cAAc,MAAM,KAAK,SAAS,OAAO,CAAC;GAChD,MAAM,WAAW,OAAO,WACrB,YAAY,QAAQ,WAAW,OAAO,aAAa,MAAM,QAAQ,IACjE;GACH,MAAM,oBAAoB,SAAS,QACjC,WAAW,CAAC,UAAU,QAAQ,GAAG,KAAK,OAAO,iBAAiB,IAChE,EAAE;GACF,MAAM,qBAAqB,SAAS,QAAQ,WAC3C,UAAU,QAAQ,GAAG,CACtB,EAAE;GACF,MAAM,wBAAwB,SAAS,QACrC,WAAW,OAAO,iBAAiB,IACrC,EAAE;GACF,IAAI,OAAO,UACV,OAAO;IACN,UAAU,MAAM;IAChB,aAAa,SAAS;IACtB;IACA;IACA;GACD;GAED,OAAO;IACN,aAAa,IAAI,IAAI,YAAY,KAAK,WAAW,OAAO,QAAQ,CAAC,EAAE;IACnE,aAAa,SAAS;IACtB;IACA;IACA;GACD;EACD;EACA,MAAM,QAAQ;GACb,SAAS,MAAM;GACf,SAAS,SAAS;EACnB;CACD;AACD;AAEA,SAAgB,qBAAqB,QAA0C;CAC9E,OAAO,mBAAmB,QAAQ,oBAAoB,CAAC;AACxD;;;AC5TA,eAAsB,YACrB,IACA,KACoB;CAEpB,MAAM,YAAW,MADI,GAAG,OAAO,WAAW,EAAE,OAAO,GAAG,EAAE,UAAU,GAC1C;CACxB,IAAI,CAAC,UACJ,MAAM,IAAI,eAAe,kCAAkC,IAAI;CAEhE,OAAO;AACR;AAEA,eAAsB,WACrB,IACA,QACsB;CACtB,OAAO,GACL,OAAO,EACP,KAAK,WAAW,EAChB,MACA,IACC,GAAG,YAAY,UAAU,OAAO,QAAQ,GACxC,OAAO,SAAS,GAAG,YAAY,WAAW,OAAO,MAAM,IAAI,KAAA,GAC3D,OAAO,QAAQ,GAAG,YAAY,WAAW,OAAO,KAAK,IAAI,KAAA,CAC1D,CACD,EACC,QAAQ,KAAK,YAAY,SAAS,CAAC,EACnC,MAAM,OAAO,SAAS,EAAE;AAC3B;;;ACSA,SAAS,cAAc,WAAsC;CAC5D,OAAO,IAAI,UAAU,IAAI,qBAAqB,EAAE,KAAK,GAAG,EAAE;AAC3D;AAwBA,SAAS,eAAe,OAAa;CACpC,OAAO,GAAG,GAAG,MAAM,YAAY,EAAE;AAClC;AAEA,SAAS,iBAAiB,QAA2B;CACpD,OAAO,GAAG,SAAS,IAAI,KACtB,OAAO,KAAK,UAAU,GAAG,GAAG,OAAO,GACnC,GAAG,IACJ,EAAE;AACH;AAEA,SAAS,eAAe,MAAqC;CAC5D,OAAO,QAAQ,KAAK,SAAS,IAC1B,GAAG,GAAG,cAAc,KAAK,MAAM,iBAAiB,IAAI,MACpD,KAAA;AACJ;AAEA,SAAS,cAAc,MAAqC;CAC3D,OAAO,QAAQ,KAAK,SAAS,IAC1B,GAAG,eAAe,iBAAiB,IAAI,MACvC,GAAG;AACP;AAEA,SAAS,oBAAoB,MAAqC;CACjE,OAAO,QAAQ,KAAK,SAAS,IAC1B,GAAG,iBAAiB,iBAAiB,IAAI,EAAE,iBAAiB,iBAAiB,IAAI,MACjF,GAAG;AACP;AAEA,SAAS,uBAAuB,KAAW;CAC1C,OAAO;EACN,aAAa,MAAM;EACnB,mBAAmB,GAAW;;YAEpB,cAAc,aAAa;YAC3B,cAAc,UAAU,cAAc,cAAc,UAAU,KAAK,eAAe,GAAG,EAAE;;IAE/F,QAAQ,MAAM;EAChB,oBAAoB,GAAW;;YAErB,cAAc,UAAU;WACzB,cAAc,UAAU,MAAM,eAAe,GAAG,EAAE;;IAEzD,QAAQ,MAAM;EAChB,uBACC,GAAW,2BAA2B,cAAc,aAAa,qBAAqB,QACrF,MACD;CACF;AACD;AAEA,SAAS,yBAA4C;CACpD,OAAO;EACN,aAAa;EACb,mBAAmB;EACnB,oBAAoB;EACpB,uBAAuB;CACxB;AACD;AAEA,eAAsB,eACrB,IACA,MACuB;CACvB,IAAI,KAAK,WAAW,GACnB,OAAO,CAAC;CAET,OAAO,GAAG,OAAO,aAAa,EAAE,OAAO,IAAI,EAAE,UAAU;AACxD;AAEA,eAAsB,cACrB,IACA,UACA,UAC4B;CAQ5B,QAAO,MAPc,GACnB,OAAO,EACP,KAAK,aAAa,EAClB,MACA,IAAI,GAAG,cAAc,UAAU,QAAQ,GAAG,GAAG,cAAc,IAAI,QAAQ,CAAC,CACzE,EACC,MAAM,CAAC,GACK,MAAM;AACrB;AAEA,eAAsB,2BACrB,IACA,UACA,KAC6B;CAK7B,QAAO,MAJY,GACjB,OAAO,uBAAuB,GAAG,CAAC,EAClC,KAAK,aAAa,EAClB,MAAM,GAAG,cAAc,UAAU,QAAQ,CAAC,GAChC,MAAM,uBAAuB;AAC1C;AAEA,eAAsB,2BACrB,IACA,KACmC;CAOnC,QAAO,MANY,GACjB,OAAO;EACP,aAAa,cAAc,cAAc,QAAQ;EACjD,GAAG,uBAAuB,GAAG;CAC9B,CAAC,EACA,KAAK,aAAa,GACR,MAAM;EAAE,aAAa;EAAG,GAAG,uBAAuB;CAAE;AACjE;AAEA,eAAsB,aACrB,IACA,UACA,UACmB;CAOnB,QAAO,MANc,GACnB,OAAO,aAAa,EACpB,MACA,IAAI,GAAG,cAAc,UAAU,QAAQ,GAAG,GAAG,cAAc,IAAI,QAAQ,CAAC,CACzE,EACC,UAAU,EAAE,IAAI,cAAc,GAAG,CAAC,GACtB,SAAS;AACxB;AAEA,eAAsB,wBACrB,IACA,UACkB;CAKlB,QAAO,MAJc,GACnB,OAAO,aAAa,EACpB,MAAM,GAAG,cAAc,UAAU,QAAQ,CAAC,EAC1C,UAAU,EAAE,IAAI,cAAc,GAAG,CAAC,GACtB;AACf;AAaA,SAAS,gBAAgB,QAAqB;CAC7C,OAAO,IACN,OAAO,aAAa,KAAA,IACjB,GAAG,cAAc,UAAU,OAAO,QAAQ,IAC1C,KAAA,GACH,OAAO,UACJ,IACA,UAAU,cAAc,SAAS,GACjC,GAAG,GAAG,cAAc,UAAU,UAC/B,IACC,KAAA,GACH,OAAO,aAAa,UAAU,cAAc,YAAY,IAAI,KAAA,GAC5D,OAAO,gBACJ,GAAG,cAAc,WAAW,OAAO,aAAa,IAChD,KAAA,GACH,OAAO,mBACJ,GACA,OAAO,cAAc,cAAc,GACnC,GAAG,cAAc,gBAAgB,OAAO,gBAAgB,CACzD,IACC,KAAA,GACH,OAAO,SAAS,OAAO,MAAM,SAAS,IACnC,QAAQ,cAAc,MAAM,CAAC,GAAG,OAAO,KAAK,CAAC,IAC7C,KAAA,GACH,eAAe,OAAO,IAAI,GAC1B,OAAO,uBAAuB,OAAO,oBAAoB,SAAS,IAC/D,QAAQ,cAAc,YAAY,CAAC,GAAG,OAAO,mBAAmB,CAAC,IACjE,KAAA,CACJ;AACD;AAEA,eAAsB,kBACrB,IACA,QACkB;CAClB,OAAO,GAAG,OAAO,eAAe,gBAAgB,MAAM,CAAC;AACxD;AAEA,eAAsB,cACrB,IACA,QACkB;CAKlB,QAAO,MAJc,GACnB,OAAO,aAAa,EACpB,MAAM,gBAAgB,MAAM,CAAC,EAC7B,UAAU,EAAE,IAAI,cAAc,GAAG,CAAC,GACtB;AACf;AAYA,eAAsB,mBACrB,IACA,OACqE;CAqErE,QAAO,MApEY,GAAG,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAgDf,MAAM,SAAS;KAC7B,MAAM,oBAAoB,GAAG,KAAK,GAAG,0DAA0D;KAC/F,MAAM,iBAAiB,GAAG,KAAK,GAAG,wGAAwG;KAE3I,MAAM,SAAS,MAAM,MAAM,SAAS,IACjC,GAAG,kBAAkB,IAAI,KACzB,MAAM,MAAM,KAAK,SAAS,GAAG,GAAG,MAAM,GACtC,GAAG,IACJ,EAAE,mBAAmB,IAAI,KACxB,MAAM,MAAM,KAAK,SAAS,GAAG,GAAG,MAAM,GACtC,GAAG,IACJ,EAAE,KACD,GAAG,GACN;KACC,oBAAoB,MAAM,IAAI,EAAE;8CACS,MAAM,UAAU;;UAEpD,MAAM,MAAM;EACpB,GAEc,KAAK,QAAQ;EA2C3B,OAAO;GACN,GAAA;IA1CA,IAAI,IAAI;IACR,UAAU,IAAI;IACd,SAAS,IAAI;IACb,MAAM,IAAI;IACV,YAAY,IAAI;IAChB,MAAM,IAAI;IACV,QAAQ,IAAI;IACZ,UAAU,IAAI;IACd,YAAY,IAAI;IAChB,WAAW,IAAI;IACf,gBAAgB,IAAI;IACpB,qBAAqB,IAAI;IACzB,cAAc,IAAI;IAClB,cAAc,IAAI;IAClB,WAAW,IAAI;IACf,gBAAgB,IAAI;IACpB,aAAa,IAAI;IACjB,WAAW,IAAI;IACf,WAAW,IAAI;GAwBf;GACA,GAAA;IAtBA,IAAI,IAAI;IACR,UAAU,IAAI;IACd,SAAS,IAAI;IACb,MAAM,IAAI;IACV,YAAY,IAAI;IAChB,MAAM,IAAI;IACV,QAAQ,IAAI;IACZ,UAAU,IAAI;IACd,YAAY,IAAI;IAChB,WAAW,IAAI;IACf,gBAAgB,IAAI;IACpB,qBAAqB,IAAI;IACzB,cAAc,IAAI;IAClB,cAAc,IAAI;IAClB,WAAW,IAAI;IACf,gBAAgB,IAAI;IACpB,aAAa,IAAI;IACjB,WAAW,IAAI;IACf,WAAW,IAAI;GAIf;GACA,YAAY,OAAO,IAAI,UAAU,KAAK;EACvC;CACD,CAAC;AACF;AAOA,eAAsB,yBACrB,IACA,UACA,KAC8E;CAC9E,IAAI,IAAI,WAAW,GAClB,OAAO,CAAC;CAeT,OAAO,MAbY,GACjB,OAAO;EACP,IAAI,cAAc;EAClB,MAAM,cAAc;EACpB,cAAc,cAAc;CAC7B,CAAC,EACA,KAAK,aAAa,EAClB,MACA,IACC,GAAG,cAAc,UAAU,QAAQ,GACnC,QAAQ,cAAc,IAAI,CAAC,GAAG,GAAG,CAAC,CACnC,CACD;AAEF;AAEA,eAAsB,uBACrB,IACA,QAM0B;CAC1B,IAAI,OAAO,IAAI,WAAW,GACzB,OAAO,CAAC;CAiBT,OAAO,MAfc,GACnB,OAAO,aAAa,EACpB,IAAI;EACJ,cAAc,OAAO;EACrB,cAAc,OAAO;EACrB,WAAW,OAAO;CACnB,CAAC,EACA,MACA,IACC,GAAG,cAAc,UAAU,OAAO,QAAQ,GAC1C,QAAQ,cAAc,IAAI,CAAC,GAAG,OAAO,GAAG,CAAC,GACzC,OAAO,cAAc,YAAY,CAClC,CACD,EACC,UAAU;EAAE,IAAI,cAAc;EAAI,MAAM,cAAc;CAAK,CAAC;AAE/D;AAEA,eAAsB,cACrB,IACA,QAMgB;CAChB,MAAM,GACJ,OAAO,aAAa,EACpB,IAAI;EAAE,MAAM,CAAC,GAAG,OAAO,IAAI;EAAG,WAAW,OAAO;CAAI,CAAC,EACrD,MACA,IACC,GAAG,cAAc,UAAU,OAAO,QAAQ,GAC1C,GAAG,cAAc,IAAI,OAAO,QAAQ,CACrC,CACD;AACF;AAEA,eAAsB,qBACrB,IACA,WACgB;CAChB,MAAM,sBAAM,IAAI,KAAK;CACrB,IAAI,UAAU,WAAW,GACxB;CAED,MAAM,GACJ,OAAO,aAAa,EACpB,IAAI;EACJ,gBAAgB;EAChB,aAAa,GAAG,GAAG,cAAc,YAAY;EAC7C,WAAW;CACZ,CAAC,EACA,MAAM,QAAQ,cAAc,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;AAClD;AAEA,eAAsB,oBACrB,IACA,WACiC;CACjC,IAAI,UAAU,WAAW,GACxB,uBAAO,IAAI,IAAI;CAEhB,MAAM,OAAO,MAAM,GACjB,OAAO;EACP,IAAI,cAAc;EAClB,WAAW,cAAc;CAC1B,CAAC,EACA,KAAK,aAAa,EAClB,MAAM,QAAQ,cAAc,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;CACjD,OAAO,IAAI,IACV,KAAK,SAAS,QAAS,IAAI,YAAY,CAAC,CAAC,IAAI,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC,CAAE,CACvE;AACD;AAEA,eAAsB,aACrB,IACA,OAC6B;CAC7B,MAAM,YAAY,cAAc,MAAM,SAAS;CAC/C,MAAM,WAAW,MAAM,YAAY;CA2CnC,OAAO,MA1CY,GAAG,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;wBAoBV,UAAU;;;iBAGjB,MAAM,SAAS;;KAE3B,MAAM,oBAAoB,GAAG,KAAK,GAAG,4BAA4B;KACjE,MAAM,iBAAiB,GAAG,KAAK,GAAG,iDAAiD;KAEpF,MAAM,SAAS,MAAM,MAAM,SAAS,IACjC,GAAG,gBAAgB,IAAI,KACvB,MAAM,MAAM,KAAK,SAAS,GAAG,GAAG,MAAM,GACtC,GAAG,IACJ,EAAE,KACD,GAAG,GACN;KACC,cAAc,MAAM,IAAI,EAAE;KAC1B,MAAM,SAAS,GAAG,oBAAoB,eAAe,MAAM,MAAM,MAAM,GAAG,GAAG;KAC7E,MAAM,QAAQ,GAAG,oBAAoB,eAAe,MAAM,KAAK,MAAM,GAAG,GAAG;4BACpD,UAAU,eAAe,SAAS;2BACnC,UAAU;UAC3B,MAAM,MAAM;EACpB;AAEF;AAEA,eAAsB,cACrB,IACA,OAC8B;CA0C9B,OAAO,MAzCY,GAAG,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;8EAoB4C,MAAM,MAAM;;;iBAGzE,MAAM,SAAS;KAC3B,MAAM,oBAAoB,GAAG,KAAK,GAAG,4BAA4B;KACjE,MAAM,iBAAiB,GAAG,KAAK,GAAG,iDAAiD;KAEpF,MAAM,SAAS,MAAM,MAAM,SAAS,IACjC,GAAG,gBAAgB,IAAI,KACvB,MAAM,MAAM,KAAK,SAAS,GAAG,GAAG,MAAM,GACtC,GAAG,IACJ,EAAE,KACD,GAAG,GACN;KACC,cAAc,MAAM,IAAI,EAAE;KAC1B,MAAM,SAAS,GAAG,oBAAoB,eAAe,MAAM,MAAM,MAAM,GAAG,GAAG;KAC7E,MAAM,QAAQ,GAAG,oBAAoB,eAAe,MAAM,KAAK,MAAM,GAAG,GAAG;4EACJ,MAAM,MAAM;;UAE9E,MAAM,MAAM;EACpB;AAEF;AClmBA,eAAsB,oBACrB,IAC0B;CAM1B,QAAO,MALY,GACjB,OAAO,EACP,KAAK,SAAS,EACd,MAAM,GAAG,UAAU,KAAA,cAA0B,CAAC,EAC9C,MAAM,CAAC,GACG,MAAM;AACnB;;;ACOA,SAAS,OAAO,OAAiC;CAChD,OAAO,iBAAiB,OAAO,QAAQ,IAAI,KAAK,KAAK;AACtD;AAEA,SAAS,eAAe,OAA+C;CACtE,OAAO,UAAU,OAAO,OAAO,OAAO,KAAK;AAC5C;AAEA,SAAgB,YAAY,KAA4B;CACvD,OAAO;EACN,IAAI,IAAI;EACR,UAAU,IAAI;EACd,SAAS,IAAI;EACb,MAAM,IAAI;EACV,YAAY,IAAI;EAChB,MAAM,IAAI;EACV,QAAQ,IAAI;EACZ,UAAU,gBAAgB,IAAI,QAAQ;EACtC,YAAY,IAAI;EAChB,gBAAgB,IAAI;EACpB,qBAAqB,IAAI;EACzB,cAAc,IAAI;EAClB,cAAc,eAAe,IAAI,YAAY;EAC7C,WAAW,eAAe,IAAI,SAAS;EACvC,gBAAgB,eAAe,IAAI,cAAc;EACjD,aAAa,IAAI;EACjB,WAAW,OAAO,IAAI,SAAS;EAC/B,WAAW,OAAO,IAAI,SAAS;CAChC;AACD;;;ACIA,MAAM,oBAAgD;CACrD;CACA;CACA;CACA;AACD;AAEA,MAAM,wBAAwB,IAAI,IAAI;CAAC;CAAS;CAAS;CAAS;AAAO,CAAC;AAE1E,SAAS,gBAAgB,KAA2B;CACnD,OAAO;EACN,IAAI,IAAI;EACR,UAAU,IAAI;EACd,aAAa,IAAI;EACjB,UAAU,gBAAgB,IAAI,QAAQ;EACtC,WAAW,IAAI;CAChB;AACD;AAEA,SAAS,wBACR,KAC6B;CAC7B,OAAO,kBAAkB,QACvB,UAAU,gBAAgB,UAAU,gBAAgB,IACtD;AACD;AAEA,SAAS,qBAAqB,OAAgB,MAAuB;CACpE,OACC,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS;AAEjB;AAEA,SAAS,qBAAqB,OAAoC;CACjE,OAAO,OAAO,UAAU,YACvB,UAAU,QACV,UAAU,SACV,OAAQ,MAA6B,SAAS,WAC3C,MAA2B,OAC5B,KAAA;AACJ;AAEA,SAAS,uBAAuB,OAAgC;CAC/D,IAAI,iBAAiB,gBACpB,OAAO;CAER,MAAM,OAAO,qBAAqB,KAAK;CACvC,IAAI,QAAQ,sBAAsB,IAAI,IAAI,GACzC,OAAO,IAAI,eACV,yHACA,aACA,KACD;CAED,OAAO,IAAI,eAAe,8BAA8B,MAAM,KAAK;AACpE;AAEA,eAAe,qBACd,WACa;CACb,IAAI;EACH,OAAO,MAAM,UAAU;CACxB,SAAS,OAAO;EACf,MAAM,uBAAuB,KAAK;CACnC;AACD;AAEA,SAAS,cAAc,OAAgC;CACtD,MAAM,SAAsB,CAAC;CAC7B,IAAI,MAAM,aAAa,KAAA,GACtB,OAAO,WAAW,MAAM;CAEzB,IAAI,MAAM,YAAY,MACrB,OAAO,UAAU;CAElB,IAAI,MAAM,eAAe,MACxB,OAAO,aAAa;CAErB,IAAI,MAAM,kBAAkB,KAAA,GAC3B,OAAO,gBAAgB,MAAM;CAE9B,IAAI,MAAM,qBAAqB,KAAA,GAC9B,OAAO,mBAAmB,MAAM;CAEjC,IAAI,MAAM,UAAU,KAAA,KAAa,MAAM,MAAM,SAAS,GACrD,OAAO,QAAQ,MAAM;CAEtB,IAAI,MAAM,SAAS,KAAA,KAAa,MAAM,KAAK,SAAS,GACnD,OAAO,OAAO,MAAM;CAErB,IAAI,MAAM,kBAAkB,KAAA,GAC3B,OAAO,sBAAsB,wBAAwB,MAAM,aAAa;CAEzE,OAAO;AACR;AAEA,SAAS,YAAY,QAAoC;CACxD,OAAO;EACN,GAAG;EACH,MAAM,CAAC,GAAG,OAAO,IAAI;EACrB,UAAU,gBAAgB,OAAO,QAAQ;EACzC,WAAW,CAAC,GAAG,OAAO,SAAS;CAChC;AACD;AAEA,SAAgB,oBAAoB,QAAqC;CACxE,IAAI,kBAAkB;CACtB,IAAI;CAEJ,eAAe,6BACd,UACgB;EAChB,IAAI,iBACH;EAED,IAAI,CAAC,yBACJ,0BAA0B,+BAA+B,QAAQ,EAAE,OACjE,UAAmB;GACnB,0BAA0B,KAAA;GAC1B,MAAM;EACP,CACD;EAED,MAAM;CACP;CAEA,eAAe,+BACd,UACgB;EAChB,IAAI;EACJ,IAAI;GACH,OAAO,MAAM,oBAAoB,OAAO,EAAE;EAC3C,SAAS,OAAO;GACf,IAAI,qBAAqB,OAAO,OAAO,GACtC,MAAM,IAAI,eACT,6IACA,aACA,KACD;GAED,MAAM,uBAAuB,KAAK;EACnC;EACA,IAAI,CAAC,MACJ,MAAM,IAAI,eACT,sKACA,WACD;EAED,IAAI,KAAK,wBAAwB,SAAS,YACzC,MAAM,IAAI,eACT,wBAAwB,SAAS,WAAW,oDAAoD,KAAK,oBAAoB,iIACzH,QACD;EAED,kBAAkB;CACnB;CAEA,OAAO;EACN,SAAS;EACT,MAAM,eAAe,CAAC;EACtB;EACA,MAAM,eAAe,UAAU;GAC9B,OAAO,qBAAqB,YAAY;IAKvC,QAAO,MAJYA,eAClB,OAAO,IACP,SAAS,IAAI,WAAW,CACzB,GACY,IAAI,WAAW;GAC5B,CAAC;EACF;EACA,MAAM,aAAa,OAA+B;GACjD,OAAO,qBAAqB,YAAY;IAEvC,QAAO,MADYC,aAAkB,OAAO,IAAI,KAAK,GACzC,KACV,SACC;KACA,QAAQ,YAAY,GAAG;KACvB,aAAa,IAAI;IAClB,EACF;GACD,CAAC;EACF;EACA,MAAM,cAAc,OAAgC;GACnD,OAAO,qBAAqB,YAAY;IAEvC,QAAO,MADYC,cAAmB,OAAO,IAAI,KAAK,GAC1C,KACV,SACC;KACA,QAAQ,YAAY,GAAG;KACvB,cAAc,IAAI;IACnB,EACF;GACD,CAAC;EACF;EACA,MAAM,oBAAoB,WAAW;GACpC,OAAO,2BACNC,oBAAyB,OAAO,IAAI,SAAS,CAC9C;EACD;EACA,MAAM,qBAAqB,WAAW;GACrC,OAAO,2BACN,qBAAqB,OAAO,IAAI,SAAS,CAC1C;EACD;EACA,MAAM,aAAa,UAAU,UAAU;GACtC,OAAO,2BACNC,aAAkB,OAAO,IAAI,UAAU,QAAQ,CAChD;EACD;EACA,MAAM,wBAAwB,UAAU;GACvC,OAAO,2BACNC,wBAA6B,OAAO,IAAI,QAAQ,CACjD;EACD;EACA,MAAM,MAAM,OAAO;GAClB,OAAO,qBAAqB,YAAY;IACvC,MAAM,SAAS,cAAc,KAAK;IAElC,IADe,MAAM,WAAW,MAE/B,OAAO;KACN,cAAc,MAAM,kBAAkB,OAAO,IAAI,MAAM;KACvD,cAAc;KACd,QAAQ;IACT;IAED,MAAM,eAAe,MAAM,cAAc,OAAO,IAAI,MAAM;IAC1D,OAAO;KACN,cAAc;KACd;KACA,QAAQ;IACT;GACD,CAAC;EACF;EACA,MAAM,mBAAmB,OAAO;GAC/B,OAAO,qBAAqB,YAAY;IAcvC,QAAO,MAbYC,mBAAwB,OAAO,IAAI;KACrD,UAAU,MAAM;KAChB,WAAW,MAAM,aAAA;KACjB,OAAO,MAAM,SAAA;KACb,GAAI,MAAM,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,MAAM,MAAM;KAC1D,GAAI,MAAM,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,MAAM,KAAK;KACvD,GAAI,MAAM,sBAAsB,KAAA,IAC7B,CAAC,IACD,EAAE,mBAAmB,MAAM,kBAAkB;KAChD,GAAI,MAAM,mBAAmB,KAAA,IAC1B,CAAC,IACD,EAAE,gBAAgB,MAAM,eAAe;IAC3C,CAAC,GACW,KACV,SACC;KACA,GAAG,YAAY,IAAI,CAAC;KACpB,GAAG,YAAY,IAAI,CAAC;KACpB,YAAY,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,IAAI,UAAU,CAAC;IACpD,EACF;GACD,CAAC;EACF;EACA,MAAM,eAAe,QAAQ;GAC5B,OAAO,qBAAqB,YAAY;IACvC,KAAK,MAAM,SAAS,QACnB,MAAM,YAAY,OAAO,IAAI;KAC5B,IAAI,MAAM;KACV,UAAU,MAAM;KAChB,aAAa,MAAM;KACnB,UAAU,gBAAgB,MAAM,QAAQ;KACxC,WAAW,MAAM;IAClB,CAAC;GAEH,CAAC;EACF;EACA,MAAM,aAAa,OAAO;GACzB,OAAO,qBAAqB,YAAY;IAOvC,QAAO,MANY,WAAW,OAAO,IAAI;KACxC,UAAU,MAAM;KAChB,OAAO,MAAM,SAAA;KACb,GAAI,MAAM,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ,MAAM,OAAO;KAC7D,GAAI,MAAM,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,MAAM,MAAM;IAC3D,CAAC,GACW,IAAI,eAAe;GAChC,CAAC;EACF;EACA,MAAM,UAAU,UAAU,UAAU;GACnC,OAAO,qBAAqB,YAAY;IACvC,MAAM,MAAM,MAAM,cAAc,OAAO,IAAI,UAAU,QAAQ;IAC7D,OAAO,MAAM,YAAY,GAAG,IAAI;GACjC,CAAC;EACF;EACA,MAAM,yBAAyB,UAAU,KAAK;GAC7C,OAAO,2BACN,yBAAyB,OAAO,IAAI,UAAU,GAAG,CAClD;EACD;EACA,MAAM,YACL,OACkC;GAClC,OAAO,qBAAqB,YAAY;IAsCvC,OAAO,EAAE,eAAe,MArCO,OAAO,GAAG,YAAY,OAAO,OAAO;KAClE,MAAM,UAAU,MAAM,uBAAuB,IAAI;MAChD,YAAY,MAAM;MAClB,UAAU,MAAM;MAChB,KAAK,MAAM;MACX,KAAK,MAAM;KACZ,CAAC;KACD,MAAM,MAAM,QAAQ,KAAK,QAAQ,IAAI,EAAE;KACvC,IAAI,MAAM,cACT,KAAK,MAAM,MAAM,KAChB,MAAM,YAAY,IAAI;MACrB,IAAI,cAAc;MAClB,UAAU,MAAM;MAChB,aAAa;MACb,UAAU;OAAE,UAAU;OAAI,cAAc,MAAM;MAAW;MACzD,WAAW,MAAM;KAClB,CAAC;KAGH,IAAI,MAAM,aAAa,QAAQ,SAAS,GAAG;MAC1C,MAAM,aAAa,IAAI,IAAI,MAAM,YAAY;MAC7C,KAAK,MAAM,OAAO,SACjB,KAAK,MAAM,OAAO,IAAI,MACrB,WAAW,IAAI,GAAG;MAGpB,IAAI,WAAW,SAAS,MAAM,aAAa,QAC1C,MAAM,cAAc,IAAI;OACvB,UAAU,MAAM;OAChB,UAAU,MAAM;OAChB,MAAM,CAAC,GAAG,UAAU;OACpB,KAAK,MAAM;MACZ,CAAC;KAEH;KACA,OAAO;IACR,CAAC,EACwC;GAC1C,CAAC;EACF;EACA,MAAM,MAAM,OAAO,KAAK;GACvB,OAAO,qBAAqB,YAAY;IACvC,IAAI,OAAO,UAAU;KACpB,MAAM,SAAS,MAAM,2BACpB,OAAO,IACP,MAAM,UACN,GACD;KACA,OAAO;MACN,UAAU,MAAM;MAChB,GAAG;KACJ;IACD;IACA,OAAQ,MAAM,2BACb,OAAO,IACP,GACD;GACD,CAAC;EACF;EACA,MAAM,QAAQ;GACb,OAAO,2BAA2B,OAAO,MAAM,CAAC;EACjD;CACD;AACD;AAEA,SAAgB,qBACf,QACA,QACkB;CAClB,OAAO,mBAAmB,QAAQ,oBAAoB,MAAM,CAAC;AAC9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACrYA,SAAgB,gBAAgB,QAA0C;CACzE,eAAe,OAAO,QAAQ;CAC9B,wBAAwB,OAAO,SAAS;CACxC,IAAI,OAAO,gBAAgB,KAAA,GAAW;EACrC,qBAAqB,OAAO,aAAa,aAAa;EACtD,OAAO,qBAAqB,QAAQ,eAAe,OAAO,WAAW,CAAC;CACvE;CACA,OAAO,qBAAqB,MAAM;AACnC"}
+{"version":3,"file":"index.mjs","names":["IMPORTANCE_LEVELS","timestampParam","insertMemoryRows","vectorSearchQuery","lexicalSearchQuery","getMemoryEmbeddingsQuery","deleteMemoryQuery","deleteMemoriesForEntityQuery","findDuplicatePairsQuery"],"sources":["../src/db/vector.ts","../src/db/schema.ts","../src/db/index.ts","../src/resilience.ts","../src/memory/json.ts","../src/memory/records.ts","../src/retrieval/scorer.ts","../src/context/formatter.ts","../src/context/tokens.ts","../src/context/builder.ts","../src/observability.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/filters.ts","../src/memory/in-memory.ts","../src/db/cancellation.ts","../src/db/queries/events.ts","../src/db/queries/memories.ts","../src/db/queries/meta.ts","../src/memory/postgres-records.ts","../src/memory/postgres.ts","../src/client.ts"],"sourcesContent":["export function formatVectorComponent(value: number): string {\n\tif (!Number.isFinite(value)) {\n\t\tthrow new Error(\"Vector values must be finite numbers.\");\n\t}\n\treturn Object.is(value, -0) ? \"0\" : value.toString();\n}\n","import { sql } from \"drizzle-orm\";\nimport {\n\ttype AnyPgColumn,\n\tcustomType,\n\tindex,\n\tinteger,\n\tjsonb,\n\tpgTable,\n\treal,\n\ttext,\n\ttimestamp,\n} from \"drizzle-orm/pg-core\";\nimport type { JsonObject } from \"../types.js\";\nimport { formatVectorComponent } from \"./vector.js\";\n\nconst vector = customType<{\n\tdata: number[];\n\tdriverData: string;\n\tconfig: { dimensions?: number };\n}>({\n\tdataType(config) {\n\t\tconst dimensions = config?.dimensions ?? 1536;\n\t\treturn `vector(${dimensions})`;\n\t},\n\ttoDriver(value) {\n\t\treturn `[${value.map(formatVectorComponent).join(\",\")}]`;\n\t},\n\tfromDriver(value) {\n\t\treturn value.slice(1, -1).split(\",\").filter(Boolean).map(Number);\n\t},\n});\n\nexport const memoriesTable = pgTable(\n\t\"mnemocyte_memories\",\n\t{\n\t\tid: text(\"id\").primaryKey(),\n\t\tentityId: text(\"entity_id\").notNull(),\n\t\tcontent: text(\"content\").notNull(),\n\t\ttype: text(\"type\").notNull().default(\"fact\"),\n\t\timportance: text(\"importance\").notNull().default(\"normal\"),\n\t\ttags: text(\"tags\").array().notNull().default(sql`'{}'::text[]`),\n\t\tsource: text(\"source\"),\n\t\tmetadata: jsonb(\"metadata\").$type<JsonObject>().notNull().default({}),\n\t\tconfidence: real(\"confidence\").notNull().default(1),\n\t\tembedding: vector(\"embedding\", { dimensions: 1536 }),\n\t\tembeddingModel: text(\"embedding_model\").notNull(),\n\t\tembeddingDimensions: integer(\"embedding_dimensions\").notNull(),\n\t\tsupersededBy: text(\"superseded_by\").references(\n\t\t\t(): AnyPgColumn => memoriesTable.id,\n\t\t),\n\t\tsupersededAt: timestamp(\"superseded_at\", { withTimezone: true }),\n\t\texpiresAt: timestamp(\"expires_at\", { withTimezone: true }),\n\t\tlastAccessedAt: timestamp(\"last_accessed_at\", { withTimezone: true }),\n\t\taccessCount: integer(\"access_count\").notNull().default(0),\n\t\tcreatedAt: timestamp(\"created_at\", { withTimezone: true })\n\t\t\t.notNull()\n\t\t\t.defaultNow(),\n\t\tupdatedAt: timestamp(\"updated_at\", { withTimezone: true })\n\t\t\t.notNull()\n\t\t\t.defaultNow(),\n\t},\n\t(table) => [\n\t\tindex(\"mnemocyte_memories_entity_idx\").on(table.entityId),\n\t\tindex(\"mnemocyte_memories_entity_type_idx\").on(table.entityId, table.type),\n\t\tindex(\"mnemocyte_memories_embedding_hnsw_idx\").using(\n\t\t\t\"hnsw\",\n\t\t\ttable.embedding.op(\"vector_cosine_ops\"),\n\t\t),\n\t],\n);\n\nexport const eventsTable = pgTable(\n\t\"mnemocyte_events\",\n\t{\n\t\tid: text(\"id\").primaryKey(),\n\t\tentityId: text(\"entity_id\").notNull(),\n\t\tdescription: text(\"description\").notNull(),\n\t\tmetadata: jsonb(\"metadata\").$type<JsonObject>().notNull().default({}),\n\t\ttimestamp: timestamp(\"timestamp\", { withTimezone: true })\n\t\t\t.notNull()\n\t\t\t.defaultNow(),\n\t},\n\t(table) => [\n\t\tindex(\"mnemocyte_events_entity_time_idx\").on(\n\t\t\ttable.entityId,\n\t\t\ttable.timestamp,\n\t\t),\n\t],\n);\n\nexport const metaTable = pgTable(\"mnemocyte_meta\", {\n\tkey: text(\"key\").primaryKey(),\n\tembeddingDimensions: integer(\"embedding_dimensions\").notNull(),\n\tembeddingModel: text(\"embedding_model\"),\n});\n\nexport type MemoryRow = typeof memoriesTable.$inferSelect;\nexport type NewMemoryRow = typeof memoriesTable.$inferInsert;\nexport type EventRow = typeof eventsTable.$inferSelect;\nexport type NewEventRow = typeof eventsTable.$inferInsert;\nexport type MetaRow = typeof metaTable.$inferSelect;\n","import { drizzle, type PostgresJsDatabase } from \"drizzle-orm/postgres-js\";\nimport postgres from \"postgres\";\nimport { MnemocyteError } from \"../errors.js\";\nimport * as schema from \"./schema.js\";\n\nexport type MnemocyteDatabase = PostgresJsDatabase<typeof schema>;\n\nexport interface DatabaseHandle {\n\tdb: MnemocyteDatabase;\n\tclose(): Promise<void>;\n}\n\ntype PostgresSslMode =\n\t| \"require\"\n\t| \"prefer\"\n\t| \"allow\"\n\t| \"verify-full\"\n\t| \"disable\";\n\ntype ValidPostgresSsl =\n\t| \"require\"\n\t| \"prefer\"\n\t| \"allow\"\n\t| \"verify-full\"\n\t| boolean\n\t| { rejectUnauthorized: false };\n\nfunction parseSslFromUrl(url: URL): ValidPostgresSsl | undefined {\n\tconst mode = url.searchParams.get(\"sslmode\") as PostgresSslMode | null;\n\tif (!mode || mode === \"disable\") return undefined;\n\n\tif (mode === \"require\" || mode === \"prefer\" || mode === \"allow\") {\n\t\treturn { rejectUnauthorized: false };\n\t}\n\n\tif (mode === \"verify-full\") return \"verify-full\";\n\n\treturn undefined;\n}\n\nexport function createDatabase(databaseUrl: string): DatabaseHandle {\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\tconst ssl = parseSslFromUrl(url);\n\n\tconst isPooler =\n\t\turl.port === \"6543\" || url.searchParams.get(\"pgbouncer\") === \"true\";\n\n\tconst client = postgres(databaseUrl, {\n\t\tmax: 10,\n\t\tidle_timeout: 20,\n\t\tconnect_timeout: 10,\n\t\t...(ssl ? { ssl } : {}),\n\t\t...(isPooler ? { prepare: false } : {}),\n\t});\n\n\treturn {\n\t\tdb: drizzle(client, { schema }),\n\t\tasync close() {\n\t\t\tawait client.end();\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 { 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 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\tsurvivorTags: readonly 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 */\nexport interface MemoryStore {\n\treadonly backend: MnemocyteBackend;\n\n\tensureSchema(): Promise<void>;\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 input ID. Return order is not trusted; shared\n\t * orchestration validates the ID set and restores input order. Missing,\n\t * duplicate, or unknown returned IDs are storage-contract violations.\n\t * Callers must not mutate or reuse rows after passing them here.\n\t */\n\tinsertMemories(memories: readonly StoredMemory[]): Promise<Memory[]>;\n\tvectorSearch(input: StoreVectorSearchInput): Promise<StoreVectorCandidate[]>;\n\tlexicalSearch(\n\t\tinput: StoreLexicalSearchInput,\n\t): Promise<StoreLexicalCandidate[]>;\n\tgetMemoryEmbeddings(\n\t\tmemoryIds: readonly string[],\n\t): Promise<Map<string, number[]>>;\n\t/**\n\t * Returns exactly one post-update access record for every input ID. Return\n\t * order is not trusted and is normalized by shared orchestration.\n\t */\n\tmarkMemoriesAccessed(\n\t\tmemoryIds: readonly string[],\n\t): Promise<StoreAccessUpdate[]>;\n\n\t/** Throws `\"CONFLICT\"` when the selected memory has dependents. */\n\tdeleteMemory(entityId: string, memoryId: string): Promise<boolean>;\n\t/** Throws `\"CONFLICT\"` before deleting when any selected memory has dependents. */\n\tdeleteMemoriesForEntity(entityId: string): Promise<number>;\n\tprune(\n\t\tinput: ValidatedPruneFilter,\n\t\toptions?: StoreOperationOptions,\n\t): Promise<StorePruneResult>;\n\tfindDuplicatePairs(\n\t\tinput: FindDuplicatesInput,\n\t\toptions?: StoreOperationOptions,\n\t): Promise<StoreDuplicatePair[]>;\n\n\t/** Persists independent copies of audit events supplied by shared core. */\n\taddAuditEvents(events: readonly AuditEvent[]): Promise<void>;\n\t/** Returns detached audit events safe to expose through the public client. */\n\tlistAuditLog(\n\t\tinput: ListAuditLogInput,\n\t\toptions?: StoreOperationOptions,\n\t): Promise<AuditEvent[]>;\n\n\tgetMemory(\n\t\tentityId: string,\n\t\tmemoryId: string,\n\t\toptions?: StoreOperationOptions,\n\t): Promise<Memory | null>;\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. Throws `\"CONFLICT\"` before mutation\n\t * when any requested loser already points to a different survivor.\n\t */\n\tconsolidate(\n\t\tinput: StoreConsolidateInput,\n\t\toptions?: StoreOperationOptions,\n\t): Promise<StoreConsolidateResult>;\n\n\tstats(\n\t\tinput: { entityId?: string } | undefined,\n\t\tnow: Date,\n\t): Promise<EntityStats | GlobalStats>;\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 * or a `survivorId` appearing in `supersededIds`).\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\tfor (const id of input.supersededIds) {\n\t\tassertNonEmptyString(id, \"supersededIds[*]\");\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\tsurvivorTags: survivor.tags,\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 type { FindDuplicatesInput, Memory, RecallInput } from \"../types.js\";\nimport { IMPORTANCE_RANK } from \"./defaults.js\";\nimport type { ValidatedPruneFilter } from \"./store.js\";\n\nexport function isExpired(memory: Memory, now: Date): boolean {\n\treturn (\n\t\tmemory.expiresAt !== null && memory.expiresAt.getTime() <= now.getTime()\n\t);\n}\n\n/**\n * Test whether `memory` matches a validated prune filter. All specified\n * selectors are AND-combined; unspecified selectors do not restrict.\n *\n * `now` is supplied by the caller so callers can share a consistent\n * timestamp across a batch.\n */\nexport function matchesPruneFilter(\n\tmemory: Memory,\n\tinput: ValidatedPruneFilter,\n\tnow: Date,\n): boolean {\n\tif (input.entityId !== undefined && memory.entityId !== input.entityId) {\n\t\treturn false;\n\t}\n\tif (input.expired === true && !isExpired(memory, now)) {\n\t\treturn false;\n\t}\n\tif (input.superseded === true && memory.supersededBy === null) {\n\t\treturn false;\n\t}\n\tif (\n\t\tinput.createdBefore !== undefined &&\n\t\tmemory.createdAt.getTime() >= input.createdBefore.getTime()\n\t) {\n\t\treturn false;\n\t}\n\tif (input.notAccessedSince !== undefined) {\n\t\tconst last = memory.lastAccessedAt;\n\t\tif (last !== null && last.getTime() >= input.notAccessedSince.getTime()) {\n\t\t\treturn false;\n\t\t}\n\t}\n\tif (input.types !== undefined && !input.types.includes(memory.type)) {\n\t\treturn false;\n\t}\n\tif (\n\t\tinput.tags !== undefined &&\n\t\tinput.tags.length > 0 &&\n\t\t!input.tags.every((tag) => memory.tags.includes(tag))\n\t) {\n\t\treturn false;\n\t}\n\tif (\n\t\tinput.maxImportance !== undefined &&\n\t\tIMPORTANCE_RANK[memory.importance] > IMPORTANCE_RANK[input.maxImportance]\n\t) {\n\t\treturn false;\n\t}\n\treturn true;\n}\n\n/**\n * Return `true` when a memory should participate in a duplicate scan,\n * given the filters on `input` and a shared `now` timestamp.\n */\nexport function matchesDuplicateFilter(\n\tmemory: Memory,\n\tinput: FindDuplicatesInput,\n\tnow: Date,\n): boolean {\n\tif (memory.entityId !== input.entityId) {\n\t\treturn false;\n\t}\n\tif (input.includeSuperseded !== true && memory.supersededBy !== null) {\n\t\treturn false;\n\t}\n\tif (input.includeExpired !== true && isExpired(memory, now)) {\n\t\treturn false;\n\t}\n\tif (input.types !== undefined && !input.types.includes(memory.type)) {\n\t\treturn false;\n\t}\n\tif (\n\t\tinput.tags !== undefined &&\n\t\tinput.tags.length > 0 &&\n\t\t!input.tags.every((tag) => memory.tags.includes(tag))\n\t) {\n\t\treturn false;\n\t}\n\treturn true;\n}\n\nexport function matchesRecallFilter(\n\tmemory: Memory,\n\tinput: RecallInput,\n\tnow: Date,\n): boolean {\n\tif (memory.entityId !== input.entityId) {\n\t\treturn false;\n\t}\n\tif (!input.includeSuperseded && memory.supersededBy !== null) {\n\t\treturn false;\n\t}\n\tif (!input.includeExpired && isExpired(memory, now)) {\n\t\treturn false;\n\t}\n\tif (input.types && !input.types.includes(memory.type)) {\n\t\treturn false;\n\t}\n\tif (input.tags && !input.tags.every((tag) => memory.tags.includes(tag))) {\n\t\treturn false;\n\t}\n\tif (input.before && memory.createdAt >= input.before) {\n\t\treturn false;\n\t}\n\tif (input.after && memory.createdAt <= input.after) {\n\t\treturn false;\n\t}\n\treturn true;\n}\n","import { MnemocyteError } from \"../errors.js\";\nimport { throwIfAborted } from \"../resilience.js\";\nimport {\n\tcosineSimilarity,\n\tcreateLexicalScorer,\n\ttoVectorScore,\n} from \"../retrieval/scorer.js\";\nimport type {\n\tAuditEvent,\n\tEntityStats,\n\tGlobalStats,\n\tMemory,\n\tMnemocyteClient,\n\tMnemocyteConfig,\n} from \"../types.js\";\nimport { createMemoryClient } from \"./client-core.js\";\nimport {\n\tDEFAULT_AUDIT_LOG_LIMIT,\n\tDEFAULT_DUPLICATE_LIMIT,\n\tDEFAULT_DUPLICATE_THRESHOLD,\n} from \"./defaults.js\";\nimport { memoryHasDependentsError } from \"./deletion.js\";\nimport {\n\tisExpired,\n\tmatchesDuplicateFilter,\n\tmatchesPruneFilter,\n\tmatchesRecallFilter,\n} from \"./filters.js\";\nimport { cloneJsonObject } from \"./json.js\";\nimport { cloneMemory, createEventId, type StoredMemory } from \"./records.js\";\nimport {\n\tassertPruneFilterHasSelector,\n\ttype MemoryStore,\n\ttype StoreAccessUpdate,\n\ttype StoreConsolidateInput,\n\ttype StoreConsolidateResult,\n\ttype StoreDuplicatePair,\n\ttype StoreLexicalCandidate,\n\ttype StoreLexicalSearchInput,\n\ttype StorePruneEntityDeletion,\n\ttype StoreVectorCandidate,\n\ttype StoreVectorSearchInput,\n} from \"./store.js\";\n\nfunction cloneAuditEvent(event: AuditEvent): AuditEvent {\n\treturn {\n\t\tid: event.id,\n\t\tentityId: event.entityId,\n\t\tdescription: event.description,\n\t\tmetadata: cloneJsonObject(event.metadata),\n\t\ttimestamp: new Date(event.timestamp),\n\t};\n}\n\nfunction compareAuditPositions(\n\ta: { id: string; timestamp: Date },\n\tb: { id: string; timestamp: Date },\n): number {\n\tconst timestampDifference = a.timestamp.getTime() - b.timestamp.getTime();\n\tif (timestampDifference !== 0) {\n\t\treturn timestampDifference;\n\t}\n\tif (a.id === b.id) {\n\t\treturn 0;\n\t}\n\treturn a.id < b.id ? -1 : 1;\n}\n\nfunction assertNoDependentMemories(\n\tmemories: ReadonlyMap<string, StoredMemory>,\n\ttargetIds: ReadonlySet<string>,\n): void {\n\tfor (const memory of memories.values()) {\n\t\tif (memory.supersededBy !== null && targetIds.has(memory.supersededBy)) {\n\t\t\tthrow memoryHasDependentsError();\n\t\t}\n\t}\n}\n\nexport function createInMemoryStore(): MemoryStore {\n\tconst memories = new Map<string, StoredMemory>();\n\tconst auditLog: AuditEvent[] = [];\n\n\treturn {\n\t\tbackend: \"in-memory\",\n\t\tasync ensureSchema() {},\n\t\tasync ensureEmbeddingCompatibility() {},\n\t\tasync insertMemories(rows) {\n\t\t\tconst inserted: Memory[] = [];\n\t\t\tfor (const row of rows) {\n\t\t\t\tmemories.set(row.id, row);\n\t\t\t\tinserted.push(cloneMemory(row));\n\t\t\t}\n\t\t\treturn inserted;\n\t\t},\n\t\tasync vectorSearch(input: StoreVectorSearchInput) {\n\t\t\tconst now = new Date();\n\t\t\tconst minVectorScore = input.minVectorScore ?? 0;\n\t\t\treturn Array.from(memories.values())\n\t\t\t\t.filter((memory) => matchesRecallFilter(memory, input, now))\n\t\t\t\t.map((memory) => ({\n\t\t\t\t\tmemory: cloneMemory(memory),\n\t\t\t\t\tvectorScore: toVectorScore(\n\t\t\t\t\t\tcosineSimilarity(memory.embedding, input.embedding),\n\t\t\t\t\t),\n\t\t\t\t}))\n\t\t\t\t.filter((candidate) => candidate.vectorScore >= minVectorScore)\n\t\t\t\t.sort((a, b) => b.vectorScore - a.vectorScore)\n\t\t\t\t.slice(0, input.limit) satisfies StoreVectorCandidate[];\n\t\t},\n\t\tasync lexicalSearch(input: StoreLexicalSearchInput) {\n\t\t\tconst now = new Date();\n\t\t\tconst scoreLexical = createLexicalScorer(input.query);\n\t\t\treturn Array.from(memories.values())\n\t\t\t\t.filter((memory) => matchesRecallFilter(memory, input, now))\n\t\t\t\t.map((memory) => ({\n\t\t\t\t\tmemory: cloneMemory(memory),\n\t\t\t\t\tlexicalScore: scoreLexical(memory.content),\n\t\t\t\t}))\n\t\t\t\t.filter((candidate) => candidate.lexicalScore > 0)\n\t\t\t\t.sort((a, b) => b.lexicalScore - a.lexicalScore)\n\t\t\t\t.slice(0, input.limit) satisfies StoreLexicalCandidate[];\n\t\t},\n\t\tasync getMemoryEmbeddings(memoryIds) {\n\t\t\tconst result = new Map<string, number[]>();\n\t\t\tfor (const id of memoryIds) {\n\t\t\t\tconst memory = memories.get(id);\n\t\t\t\tif (memory) {\n\t\t\t\t\tresult.set(id, [...memory.embedding]);\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn result;\n\t\t},\n\t\tasync markMemoriesAccessed(memoryIds) {\n\t\t\tconst now = new Date();\n\t\t\tconst updates: StoreAccessUpdate[] = [];\n\t\t\tfor (const id of memoryIds) {\n\t\t\t\tconst memory = memories.get(id);\n\t\t\t\tif (memory) {\n\t\t\t\t\tmemory.lastAccessedAt = now;\n\t\t\t\t\tmemory.accessCount += 1;\n\t\t\t\t\tmemory.updatedAt = now;\n\t\t\t\t\tupdates.push({\n\t\t\t\t\t\tid: memory.id,\n\t\t\t\t\t\tlastAccessedAt: now,\n\t\t\t\t\t\taccessCount: memory.accessCount,\n\t\t\t\t\t\tupdatedAt: now,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn updates;\n\t\t},\n\t\tasync deleteMemory(entityId, memoryId) {\n\t\t\tconst memory = memories.get(memoryId);\n\t\t\tif (!memory || memory.entityId !== entityId) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tassertNoDependentMemories(memories, new Set([memoryId]));\n\t\t\treturn memories.delete(memoryId);\n\t\t},\n\t\tasync deleteMemoriesForEntity(entityId) {\n\t\t\tconst targetIds = new Set(\n\t\t\t\tArray.from(memories.values())\n\t\t\t\t\t.filter((memory) => memory.entityId === entityId)\n\t\t\t\t\t.map((memory) => memory.id),\n\t\t\t);\n\t\t\tassertNoDependentMemories(memories, targetIds);\n\t\t\tfor (const id of targetIds) {\n\t\t\t\tmemories.delete(id);\n\t\t\t}\n\t\t\treturn targetIds.size;\n\t\t},\n\t\tasync prune(input, options) {\n\t\t\tthrowIfAborted(options?.signal);\n\t\t\tassertPruneFilterHasSelector(input);\n\t\t\tconst now = new Date();\n\t\t\tconst matched: StoredMemory[] = [];\n\t\t\tfor (const memory of memories.values()) {\n\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\tif (matchesPruneFilter(memory, input, now)) {\n\t\t\t\t\tmatched.push(memory);\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst dryRun = input.dryRun === true;\n\t\t\tlet deletedByEntity: StorePruneEntityDeletion[] = [];\n\t\t\tif (!dryRun) {\n\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\tassertNoDependentMemories(\n\t\t\t\t\tmemories,\n\t\t\t\t\tnew Set(matched.map((memory) => memory.id)),\n\t\t\t\t);\n\t\t\t\tconst deletedCounts = new Map<string, number>();\n\t\t\t\tfor (const memory of matched) {\n\t\t\t\t\tmemories.delete(memory.id);\n\t\t\t\t\tdeletedCounts.set(\n\t\t\t\t\t\tmemory.entityId,\n\t\t\t\t\t\t(deletedCounts.get(memory.entityId) ?? 0) + 1,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tdeletedByEntity = Array.from(\n\t\t\t\t\tdeletedCounts,\n\t\t\t\t\t([entityId, deletedCount]) => ({ entityId, deletedCount }),\n\t\t\t\t).sort((a, b) => a.entityId.localeCompare(b.entityId));\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tmatchedCount: matched.length,\n\t\t\t\tdeletedCount: dryRun ? 0 : matched.length,\n\t\t\t\tdryRun,\n\t\t\t\tdeletedByEntity,\n\t\t\t};\n\t\t},\n\t\tasync findDuplicatePairs(input, options) {\n\t\t\tthrowIfAborted(options?.signal);\n\t\t\tconst threshold = input.threshold ?? DEFAULT_DUPLICATE_THRESHOLD;\n\t\t\tconst limit = input.limit ?? DEFAULT_DUPLICATE_LIMIT;\n\t\t\tconst now = new Date();\n\t\t\tconst candidates = Array.from(memories.values()).filter((memory) => {\n\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\treturn matchesDuplicateFilter(memory, input, now);\n\t\t\t});\n\t\t\tconst pairs: StoreDuplicatePair[] = [];\n\t\t\tfor (let i = 0; i < candidates.length; i += 1) {\n\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\tconst a = candidates[i];\n\t\t\t\tif (a === undefined) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tfor (let j = i + 1; j < candidates.length; j += 1) {\n\t\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\t\tconst b = candidates[j];\n\t\t\t\t\tif (b === undefined) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tconst similarity = Math.max(\n\t\t\t\t\t\t0,\n\t\t\t\t\t\tMath.min(1, cosineSimilarity(a.embedding, b.embedding)),\n\t\t\t\t\t);\n\t\t\t\t\tif (similarity >= threshold) {\n\t\t\t\t\t\tpairs.push({\n\t\t\t\t\t\t\ta: cloneMemory(a),\n\t\t\t\t\t\t\tb: cloneMemory(b),\n\t\t\t\t\t\t\tsimilarity,\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\tpairs.sort((x, y) => y.similarity - x.similarity);\n\t\t\treturn pairs.slice(0, limit);\n\t\t},\n\t\tasync addAuditEvents(events) {\n\t\t\tauditLog.push(...events.map(cloneAuditEvent));\n\t\t},\n\t\tasync listAuditLog(input, options) {\n\t\t\tthrowIfAborted(options?.signal);\n\t\t\tconst limit = input.limit ?? DEFAULT_AUDIT_LOG_LIMIT;\n\t\t\treturn auditLog\n\t\t\t\t.filter((event) => {\n\t\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\t\tif (event.entityId !== input.entityId) {\n\t\t\t\t\t\treturn false;\n\t\t\t\t\t}\n\t\t\t\t\tif (\n\t\t\t\t\t\tinput.before !== undefined &&\n\t\t\t\t\t\tevent.timestamp.getTime() >= input.before.getTime()\n\t\t\t\t\t) {\n\t\t\t\t\t\treturn false;\n\t\t\t\t\t}\n\t\t\t\t\tif (\n\t\t\t\t\t\tinput.after !== undefined &&\n\t\t\t\t\t\tevent.timestamp.getTime() <= input.after.getTime()\n\t\t\t\t\t) {\n\t\t\t\t\t\treturn false;\n\t\t\t\t\t}\n\t\t\t\t\tif (\n\t\t\t\t\t\tinput.beforeCursor !== undefined &&\n\t\t\t\t\t\tcompareAuditPositions(event, input.beforeCursor) >= 0\n\t\t\t\t\t) {\n\t\t\t\t\t\treturn false;\n\t\t\t\t\t}\n\t\t\t\t\tif (\n\t\t\t\t\t\tinput.afterCursor !== undefined &&\n\t\t\t\t\t\tcompareAuditPositions(event, input.afterCursor) <= 0\n\t\t\t\t\t) {\n\t\t\t\t\t\treturn false;\n\t\t\t\t\t}\n\t\t\t\t\treturn true;\n\t\t\t\t})\n\t\t\t\t.sort((a, b) => {\n\t\t\t\t\treturn compareAuditPositions(b, a);\n\t\t\t\t})\n\t\t\t\t.slice(0, limit)\n\t\t\t\t.map(cloneAuditEvent);\n\t\t},\n\t\tasync getMemory(entityId, memoryId, options) {\n\t\t\tthrowIfAborted(options?.signal);\n\t\t\tconst memory = memories.get(memoryId);\n\t\t\treturn memory && memory.entityId === entityId\n\t\t\t\t? cloneMemory(memory)\n\t\t\t\t: null;\n\t\t},\n\t\tasync loadConsolidationTargets(entityId, ids, options) {\n\t\t\treturn ids.flatMap((id) => {\n\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\tconst memory = memories.get(id);\n\t\t\t\tif (!memory || memory.entityId !== entityId) {\n\t\t\t\t\treturn [];\n\t\t\t\t}\n\t\t\t\treturn [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: memory.id,\n\t\t\t\t\t\ttags: [...memory.tags],\n\t\t\t\t\t\tsupersededBy: memory.supersededBy,\n\t\t\t\t\t},\n\t\t\t\t];\n\t\t\t});\n\t\t},\n\t\tasync consolidate(\n\t\t\tinput: StoreConsolidateInput,\n\t\t\toptions,\n\t\t): Promise<StoreConsolidateResult> {\n\t\t\tthrowIfAborted(options?.signal);\n\t\t\tconst survivor = memories.get(input.survivorId);\n\t\t\tconst newlySuperseded: StoredMemory[] = [];\n\t\t\tconst targets: StoredMemory[] = [];\n\t\t\tfor (const id of input.supersededIds) {\n\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\tconst memory = memories.get(id);\n\t\t\t\tif (!memory || memory.entityId !== input.entityId) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\ttargets.push(memory);\n\t\t\t}\n\t\t\tif (\n\t\t\t\ttargets.some(\n\t\t\t\t\t(memory) =>\n\t\t\t\t\t\tmemory.supersededBy !== null &&\n\t\t\t\t\t\tmemory.supersededBy !== input.survivorId,\n\t\t\t\t)\n\t\t\t) {\n\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\"Superseded memory already belongs to a different survivor.\",\n\t\t\t\t\t\"CONFLICT\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tfor (const memory of targets) {\n\t\t\t\tif (memory.supersededBy === null) {\n\t\t\t\t\tnewlySuperseded.push(memory);\n\t\t\t\t}\n\t\t\t}\n\t\t\tlet mergedSurvivorTags: string[] | undefined;\n\t\t\tif (survivor && input.mergeTags && newlySuperseded.length > 0) {\n\t\t\t\tconst mergedTags = new Set(input.survivorTags);\n\t\t\t\tfor (const memory of newlySuperseded) {\n\t\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\t\tfor (const tag of memory.tags) {\n\t\t\t\t\t\tmergedTags.add(tag);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tif (mergedTags.size !== survivor.tags.length) {\n\t\t\t\t\tmergedSurvivorTags = [...mergedTags];\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst auditEvents = input.auditEnabled\n\t\t\t\t? newlySuperseded.map((memory) => ({\n\t\t\t\t\t\tid: createEventId(),\n\t\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\t\tdescription: \"memory.superseded\",\n\t\t\t\t\t\tmetadata: {\n\t\t\t\t\t\t\tmemoryId: memory.id,\n\t\t\t\t\t\t\tsupersededBy: input.survivorId,\n\t\t\t\t\t\t},\n\t\t\t\t\t\ttimestamp: input.now,\n\t\t\t\t\t}))\n\t\t\t\t: [];\n\t\t\tthrowIfAborted(options?.signal);\n\t\t\tfor (const memory of newlySuperseded) {\n\t\t\t\tmemory.supersededBy = input.survivorId;\n\t\t\t\tmemory.supersededAt = input.now;\n\t\t\t\tmemory.updatedAt = input.now;\n\t\t\t}\n\t\t\tif (survivor && mergedSurvivorTags) {\n\t\t\t\tsurvivor.tags = mergedSurvivorTags;\n\t\t\t\tsurvivor.updatedAt = input.now;\n\t\t\t}\n\t\t\tif (input.auditEnabled) {\n\t\t\t\tauditLog.push(...auditEvents);\n\t\t\t}\n\t\t\treturn { supersededIds: newlySuperseded.map((memory) => memory.id) };\n\t\t},\n\t\tasync stats(input, now) {\n\t\t\tconst allMemories = Array.from(memories.values());\n\t\t\tconst selected = input?.entityId\n\t\t\t\t? allMemories.filter((memory) => memory.entityId === input.entityId)\n\t\t\t\t: allMemories;\n\t\t\tconst activeMemoryCount = selected.filter(\n\t\t\t\t(memory) => !isExpired(memory, now) && memory.supersededBy === null,\n\t\t\t).length;\n\t\t\tconst expiredMemoryCount = selected.filter((memory) =>\n\t\t\t\tisExpired(memory, now),\n\t\t\t).length;\n\t\t\tconst supersededMemoryCount = selected.filter(\n\t\t\t\t(memory) => memory.supersededBy !== null,\n\t\t\t).length;\n\t\t\tif (input?.entityId) {\n\t\t\t\treturn {\n\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\tmemoryCount: selected.length,\n\t\t\t\t\tactiveMemoryCount,\n\t\t\t\t\texpiredMemoryCount,\n\t\t\t\t\tsupersededMemoryCount,\n\t\t\t\t} satisfies EntityStats;\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tentityCount: new Set(allMemories.map((memory) => memory.entityId)).size,\n\t\t\t\tmemoryCount: selected.length,\n\t\t\t\tactiveMemoryCount,\n\t\t\t\texpiredMemoryCount,\n\t\t\t\tsupersededMemoryCount,\n\t\t\t} satisfies GlobalStats;\n\t\t},\n\t\tasync close() {\n\t\t\tmemories.clear();\n\t\t\tauditLog.length = 0;\n\t\t},\n\t};\n}\n\nexport function createInMemoryClient(config: MnemocyteConfig): MnemocyteClient {\n\treturn createMemoryClient(config, createInMemoryStore());\n}\n","import type { SQL } from \"drizzle-orm\";\nimport { PgDialect } from \"drizzle-orm/pg-core\";\nimport type { Sql } from \"postgres\";\nimport { MnemocyteError } from \"../errors.js\";\nimport { throwIfAborted } from \"../resilience.js\";\nimport type { MnemocyteDatabase } from \"./index.js\";\n\nconst postgresDialect = new PgDialect();\n\ninterface CancelableQuery<T> extends PromiseLike<T> {\n\tcancel(): void;\n}\n\nasync function awaitCancelableQuery<T>(\n\tquery: CancelableQuery<T>,\n\tsignal: AbortSignal | undefined,\n): Promise<T> {\n\tthrowIfAborted(signal);\n\tif (!signal) {\n\t\treturn await query;\n\t}\n\tconst onAbort = (): void => {\n\t\tquery.cancel();\n\t};\n\tsignal.addEventListener(\"abort\", onAbort, { once: true });\n\ttry {\n\t\treturn await query;\n\t} catch (error) {\n\t\tif (signal.aborted) {\n\t\t\tthrow new MnemocyteError(\n\t\t\t\t\"Operation was aborted.\",\n\t\t\t\t\"ABORTED\",\n\t\t\t\tsignal.reason,\n\t\t\t);\n\t\t}\n\t\tthrow error;\n\t} finally {\n\t\tsignal.removeEventListener(\"abort\", onAbort);\n\t}\n}\n\nexport async function executeCancelableSql<T>(\n\tdb: MnemocyteDatabase,\n\tstatement: SQL,\n\tsignal: AbortSignal | undefined,\n): Promise<T> {\n\tconst query = postgresDialect.sqlToQuery(statement);\n\tconst client = (db as MnemocyteDatabase & { $client?: Sql }).$client;\n\tif (!client) {\n\t\tthrow new MnemocyteError(\n\t\t\t\"Cancelable Postgres query requires the postgres.js client.\",\n\t\t\t\"DB\",\n\t\t);\n\t}\n\treturn (await awaitCancelableQuery(\n\t\tclient.unsafe(query.sql, query.params as never[]),\n\t\tsignal,\n\t)) as T;\n}\n","import { sql } from \"drizzle-orm\";\nimport { MnemocyteError } from \"../../errors.js\";\nimport type { AuditLogCursor } from \"../../types.js\";\nimport { executeCancelableSql } from \"../cancellation.js\";\nimport type { MnemocyteDatabase } from \"../index.js\";\nimport { type EventRow, eventsTable, type NewEventRow } from \"../schema.js\";\n\nexport interface EventFilter {\n\tentityId: string;\n\tlimit?: number;\n\tbefore?: Date;\n\tafter?: Date;\n\tbeforeCursor?: AuditLogCursor;\n\tafterCursor?: AuditLogCursor;\n}\n\nfunction timestampParam(value: Date) {\n\treturn sql`${value.toISOString()}::timestamptz`;\n}\n\nexport async function insertEvent(\n\tdb: MnemocyteDatabase,\n\trow: NewEventRow,\n): Promise<EventRow> {\n\tconst result = await db.insert(eventsTable).values(row).returning();\n\tconst inserted = result[0];\n\tif (!inserted) {\n\t\tthrow new MnemocyteError(\"Event insert returned no rows.\", \"DB\");\n\t}\n\treturn inserted;\n}\n\nexport async function listEvents(\n\tdb: MnemocyteDatabase,\n\tfilter: EventFilter,\n\tsignal?: AbortSignal,\n): Promise<EventRow[]> {\n\treturn executeCancelableSql<EventRow[]>(\n\t\tdb,\n\t\tsql`\n\t\t\tSELECT\n\t\t\t\tid,\n\t\t\t\tentity_id AS \"entityId\",\n\t\t\t\tdescription,\n\t\t\t\tmetadata,\n\t\t\t\ttimestamp\n\t\t\tFROM mnemocyte_events\n\t\t\tWHERE entity_id = ${filter.entityId}\n\t\t\t\t${filter.before ? sql`AND timestamp < ${timestampParam(filter.before)}` : sql``}\n\t\t\t\t${filter.after ? sql`AND timestamp > ${timestampParam(filter.after)}` : sql``}\n\t\t\t\t${\n\t\t\t\t\tfilter.beforeCursor\n\t\t\t\t\t\t? sql`AND (timestamp, id) < (${timestampParam(filter.beforeCursor.timestamp)}, ${filter.beforeCursor.id})`\n\t\t\t\t\t\t: sql``\n\t\t\t\t}\n\t\t\t\t${\n\t\t\t\t\tfilter.afterCursor\n\t\t\t\t\t\t? sql`AND (timestamp, id) > (${timestampParam(filter.afterCursor.timestamp)}, ${filter.afterCursor.id})`\n\t\t\t\t\t\t: sql``\n\t\t\t\t}\n\t\t\tORDER BY timestamp DESC, id DESC\n\t\t\tLIMIT ${filter.limit ?? 50}\n\t\t`,\n\t\tsignal,\n\t);\n}\n","import {\n\tand,\n\tcount,\n\tcountDistinct,\n\teq,\n\tinArray,\n\tisNotNull,\n\tisNull,\n\tlt,\n\tor,\n\ttype SQL,\n\tsql,\n} from \"drizzle-orm\";\nimport type { ImportanceLevel, MemoryType } from \"../../types.js\";\nimport { executeCancelableSql } from \"../cancellation.js\";\nimport type { MnemocyteDatabase } from \"../index.js\";\nimport { type MemoryRow, memoriesTable, type NewMemoryRow } from \"../schema.js\";\nimport { formatVectorComponent } from \"../vector.js\";\n\nexport interface MemoryFilter {\n\tentityId: string;\n\ttypes?: readonly MemoryType[];\n\ttags?: readonly string[];\n\tbefore?: Date;\n\tafter?: Date;\n\tincludeSuperseded?: boolean;\n\tincludeExpired?: boolean;\n}\n\nexport interface VectorSearchInput extends MemoryFilter {\n\tembedding: readonly number[];\n\tlimit: number;\n\tminVectorScore?: number;\n}\n\nexport interface LexicalSearchInput extends MemoryFilter {\n\tquery: string;\n\tlimit: number;\n}\n\nexport interface MemoryStatsCounts {\n\tmemoryCount: number;\n\tactiveMemoryCount: number;\n\texpiredMemoryCount: number;\n\tsupersededMemoryCount: number;\n}\n\nexport interface GuardedDeleteResult {\n\tmatchedCount: number;\n\tdeletedCount: number;\n\thasDependents: boolean;\n\tdeletedByEntity: Array<{ entityId: string; deletedCount: number }>;\n}\n\nexport interface GlobalMemoryStatsCounts extends MemoryStatsCounts {\n\tentityCount: number;\n}\n\nfunction vectorLiteral(embedding: readonly number[]): string {\n\treturn `[${embedding.map(formatVectorComponent).join(\",\")}]`;\n}\n\nfunction clampedVectorScore(embedding: string) {\n\tconst rawScore = sql`1 - (embedding <=> ${embedding}::vector)`;\n\treturn sql<number>`\n\t\tCASE\n\t\t\tWHEN ${rawScore} = 'NaN'::double precision\n\t\t\t\tOR ${rawScore} = 'Infinity'::double precision\n\t\t\t\tOR ${rawScore} = '-Infinity'::double precision\n\t\t\t\tTHEN 0::double precision\n\t\t\tELSE GREATEST(\n\t\t\t\t0::double precision,\n\t\t\t\tLEAST(1::double precision, ${rawScore})\n\t\t\t)\n\t\tEND\n\t`;\n}\n\ntype RawTimestamp = Date | string;\n\nexport type RecallMemoryRow = Omit<\n\tMemoryRow,\n\t| \"embedding\"\n\t| \"supersededAt\"\n\t| \"expiresAt\"\n\t| \"lastAccessedAt\"\n\t| \"createdAt\"\n\t| \"updatedAt\"\n> & {\n\tsupersededAt: RawTimestamp | null;\n\texpiresAt: RawTimestamp | null;\n\tlastAccessedAt: RawTimestamp | null;\n\tcreatedAt: RawTimestamp;\n\tupdatedAt: RawTimestamp;\n};\n\nexport type VectorSearchRow = RecallMemoryRow & { vectorScore: number };\n\nexport type LexicalSearchRow = RecallMemoryRow & { lexicalScore: number };\n\nfunction timestampParam(value: Date) {\n\treturn sql`${value.toISOString()}::timestamptz`;\n}\n\nfunction textArrayLiteral(values: readonly string[]) {\n\treturn sql`ARRAY[${sql.join(\n\t\tvalues.map((value) => sql`${value}`),\n\t\tsql`, `,\n\t)}]::text[]`;\n}\n\nfunction tagsContainAll(tags: readonly string[] | undefined) {\n\treturn tags && tags.length > 0\n\t\t? sql`${memoriesTable.tags} @> ${textArrayLiteral(tags)}`\n\t\t: undefined;\n}\n\nfunction rawTagsFilter(tags: readonly string[] | undefined) {\n\treturn tags && tags.length > 0\n\t\t? sql`AND tags @> ${textArrayLiteral(tags)}`\n\t\t: sql``;\n}\n\nfunction duplicateTagsFilter(tags: readonly string[] | undefined) {\n\treturn tags && tags.length > 0\n\t\t? sql`AND a.tags @> ${textArrayLiteral(tags)} AND b.tags @> ${textArrayLiteral(tags)}`\n\t\t: sql``;\n}\n\nfunction memoryStatsCountFields(now: Date) {\n\treturn {\n\t\tmemoryCount: count(),\n\t\tactiveMemoryCount: sql<number>`\n\t\t\t(count(*) FILTER (\n\t\t\t\tWHERE ${memoriesTable.supersededBy} IS NULL\n\t\t\t\t\tAND (${memoriesTable.expiresAt} IS NULL OR ${memoriesTable.expiresAt} > ${timestampParam(now)})\n\t\t\t))::int\n\t\t`.mapWith(Number),\n\t\texpiredMemoryCount: sql<number>`\n\t\t\t(count(*) FILTER (\n\t\t\t\tWHERE ${memoriesTable.expiresAt} IS NOT NULL\n\t\t\t\t\tAND ${memoriesTable.expiresAt} <= ${timestampParam(now)}\n\t\t\t))::int\n\t\t`.mapWith(Number),\n\t\tsupersededMemoryCount:\n\t\t\tsql<number>`(count(*) FILTER (WHERE ${memoriesTable.supersededBy} IS NOT NULL))::int`.mapWith(\n\t\t\t\tNumber,\n\t\t\t),\n\t};\n}\n\nfunction emptyMemoryStatsCounts(): MemoryStatsCounts {\n\treturn {\n\t\tmemoryCount: 0,\n\t\tactiveMemoryCount: 0,\n\t\texpiredMemoryCount: 0,\n\t\tsupersededMemoryCount: 0,\n\t};\n}\n\nexport async function insertMemories(\n\tdb: MnemocyteDatabase,\n\trows: NewMemoryRow[],\n): Promise<MemoryRow[]> {\n\tif (rows.length === 0) {\n\t\treturn [];\n\t}\n\treturn db.insert(memoriesTable).values(rows).returning();\n}\n\nexport async function getMemoryById(\n\tdb: MnemocyteDatabase,\n\tentityId: string,\n\tmemoryId: string,\n): Promise<MemoryRow | null> {\n\tconst result = await db\n\t\t.select()\n\t\t.from(memoriesTable)\n\t\t.where(\n\t\t\tand(eq(memoriesTable.entityId, entityId), eq(memoriesTable.id, memoryId)),\n\t\t)\n\t\t.limit(1);\n\treturn result[0] ?? null;\n}\n\nexport async function getEntityMemoryStatsCounts(\n\tdb: MnemocyteDatabase,\n\tentityId: string,\n\tnow: Date,\n): Promise<MemoryStatsCounts> {\n\tconst rows = await db\n\t\t.select(memoryStatsCountFields(now))\n\t\t.from(memoriesTable)\n\t\t.where(eq(memoriesTable.entityId, entityId));\n\treturn rows[0] ?? emptyMemoryStatsCounts();\n}\n\nexport async function getGlobalMemoryStatsCounts(\n\tdb: MnemocyteDatabase,\n\tnow: Date,\n): Promise<GlobalMemoryStatsCounts> {\n\tconst rows = await db\n\t\t.select({\n\t\t\tentityCount: countDistinct(memoriesTable.entityId),\n\t\t\t...memoryStatsCountFields(now),\n\t\t})\n\t\t.from(memoriesTable);\n\treturn rows[0] ?? { entityCount: 0, ...emptyMemoryStatsCounts() };\n}\n\nexport async function deleteMemory(\n\tdb: MnemocyteDatabase,\n\tentityId: string,\n\tmemoryId: string,\n): Promise<GuardedDeleteResult> {\n\treturn deleteMemoriesWithDependentGuard(\n\t\tdb,\n\t\tand(eq(memoriesTable.entityId, entityId), eq(memoriesTable.id, memoryId)),\n\t);\n}\n\nexport async function deleteMemoriesForEntity(\n\tdb: MnemocyteDatabase,\n\tentityId: string,\n): Promise<GuardedDeleteResult> {\n\treturn deleteMemoriesWithDependentGuard(\n\t\tdb,\n\t\teq(memoriesTable.entityId, entityId),\n\t);\n}\n\nexport interface PruneFilter {\n\tentityId?: string;\n\texpired?: boolean;\n\tsuperseded?: boolean;\n\tcreatedBefore?: Date;\n\tnotAccessedSince?: Date;\n\ttypes?: readonly MemoryType[];\n\ttags?: readonly string[];\n\tmaxImportanceLevels?: readonly ImportanceLevel[];\n}\n\nfunction pruneConditions(filter: PruneFilter) {\n\treturn and(\n\t\tfilter.entityId !== undefined\n\t\t\t? eq(memoriesTable.entityId, filter.entityId)\n\t\t\t: undefined,\n\t\tfilter.expired\n\t\t\t? and(\n\t\t\t\t\tisNotNull(memoriesTable.expiresAt),\n\t\t\t\t\tsql`${memoriesTable.expiresAt} <= now()`,\n\t\t\t\t)\n\t\t\t: undefined,\n\t\tfilter.superseded ? isNotNull(memoriesTable.supersededBy) : undefined,\n\t\tfilter.createdBefore\n\t\t\t? lt(memoriesTable.createdAt, filter.createdBefore)\n\t\t\t: undefined,\n\t\tfilter.notAccessedSince\n\t\t\t? or(\n\t\t\t\t\tisNull(memoriesTable.lastAccessedAt),\n\t\t\t\t\tlt(memoriesTable.lastAccessedAt, filter.notAccessedSince),\n\t\t\t\t)\n\t\t\t: undefined,\n\t\tfilter.types && filter.types.length > 0\n\t\t\t? inArray(memoriesTable.type, [...filter.types])\n\t\t\t: undefined,\n\t\ttagsContainAll(filter.tags),\n\t\tfilter.maxImportanceLevels && filter.maxImportanceLevels.length > 0\n\t\t\t? inArray(memoriesTable.importance, [...filter.maxImportanceLevels])\n\t\t\t: undefined,\n\t);\n}\n\nexport async function countPruneMatches(\n\tdb: MnemocyteDatabase,\n\tfilter: PruneFilter,\n\tsignal?: AbortSignal,\n): Promise<number> {\n\tconst conditions = pruneConditions(filter);\n\tconst rows = await executeCancelableSql<Array<{ count: number | string }>>(\n\t\tdb,\n\t\tsql`\n\t\t\tSELECT count(*)::int AS count\n\t\t\tFROM ${memoriesTable}\n\t\t\t${conditions ? sql`WHERE ${conditions}` : sql``}\n\t\t`,\n\t\tsignal,\n\t);\n\treturn Number(rows[0]?.count ?? 0);\n}\n\nexport async function pruneMemories(\n\tdb: MnemocyteDatabase,\n\tfilter: PruneFilter,\n\tsignal?: AbortSignal,\n): Promise<GuardedDeleteResult> {\n\tconst conditions = pruneConditions(filter);\n\treturn deleteMemoriesWithDependentGuard(db, conditions, signal);\n}\n\nasync function deleteMemoriesWithDependentGuard(\n\tdb: MnemocyteDatabase,\n\tconditions: SQL | undefined,\n\tsignal?: AbortSignal,\n): Promise<GuardedDeleteResult> {\n\tconst rows = await executeCancelableSql<\n\t\tArray<{\n\t\t\tmatchedCount: number | string;\n\t\t\tdeletedCount: number | string;\n\t\t\thasDependents: boolean;\n\t\t\tentityId: string | null;\n\t\t\tentityDeletedCount: number | string | null;\n\t\t}>\n\t>(\n\t\tdb,\n\t\tsql`\n\t\t\tWITH candidates AS MATERIALIZED (\n\t\t\t\tSELECT id, entity_id\n\t\t\t\tFROM ${memoriesTable}\n\t\t\t\t${conditions ? sql`WHERE ${conditions}` : sql``}\n\t\t\t),\n\t\t\tdependents AS MATERIALIZED (\n\t\t\t\tSELECT 1\n\t\t\t\tFROM ${memoriesTable} AS dependent\n\t\t\t\tINNER JOIN candidates AS target\n\t\t\t\t\tON dependent.superseded_by = target.id\n\t\t\t\tLIMIT 1\n\t\t\t),\n\t\t\tdeleted AS (\n\t\t\t\tDELETE FROM ${memoriesTable}\n\t\t\t\tWHERE ${memoriesTable.id} IN (SELECT id FROM candidates)\n\t\t\t\t\tAND NOT EXISTS (SELECT 1 FROM dependents)\n\t\t\t\tRETURNING id, entity_id\n\t\t\t),\n\t\t\tdeleted_counts AS (\n\t\t\t\tSELECT entity_id, count(*)::int AS deleted_count\n\t\t\t\tFROM deleted\n\t\t\t\tGROUP BY entity_id\n\t\t\t),\n\t\t\tsummary AS (\n\t\t\t\tSELECT\n\t\t\t\t\t(SELECT count(*)::int FROM candidates) AS matched_count,\n\t\t\t\t\t(SELECT count(*)::int FROM deleted) AS deleted_count,\n\t\t\t\t\tEXISTS (SELECT 1 FROM dependents) AS has_dependents\n\t\t\t)\n\t\t\tSELECT\n\t\t\t\tsummary.matched_count AS \"matchedCount\",\n\t\t\t\tsummary.deleted_count AS \"deletedCount\",\n\t\t\t\tsummary.has_dependents AS \"hasDependents\",\n\t\t\t\tdeleted_counts.entity_id AS \"entityId\",\n\t\t\t\tdeleted_counts.deleted_count AS \"entityDeletedCount\"\n\t\t\tFROM summary\n\t\t\tLEFT JOIN deleted_counts ON true\n\t\t\tORDER BY deleted_counts.entity_id\n\t\t`,\n\t\tsignal,\n\t);\n\tconst row = rows[0];\n\treturn {\n\t\tmatchedCount: Number(row?.matchedCount ?? 0),\n\t\tdeletedCount: Number(row?.deletedCount ?? 0),\n\t\thasDependents: row?.hasDependents === true,\n\t\tdeletedByEntity: rows.flatMap((detail) =>\n\t\t\tdetail.entityId === null\n\t\t\t\t? []\n\t\t\t\t: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tentityId: detail.entityId,\n\t\t\t\t\t\t\tdeletedCount: Number(detail.entityDeletedCount ?? 0),\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t),\n\t};\n}\n\nexport interface DuplicateSearchInput {\n\tentityId: string;\n\tthreshold: number;\n\tlimit: number;\n\ttypes?: readonly string[];\n\ttags?: readonly string[];\n\tincludeSuperseded?: boolean;\n\tincludeExpired?: boolean;\n}\n\nexport async function findDuplicatePairs(\n\tdb: MnemocyteDatabase,\n\tinput: DuplicateSearchInput,\n\tsignal?: AbortSignal,\n): Promise<Array<{ a: MemoryRow; b: MemoryRow; similarity: number }>> {\n\tconst rows = await executeCancelableSql<Array<Record<string, unknown>>>(\n\t\tdb,\n\t\tsql`\n\t\t\tSELECT\n\t\t\t\ta.id AS \"aId\",\n\t\t\t\ta.entity_id AS \"aEntityId\",\n\t\t\t\ta.content AS \"aContent\",\n\t\t\t\ta.type AS \"aType\",\n\t\t\t\ta.importance AS \"aImportance\",\n\t\t\t\ta.tags AS \"aTags\",\n\t\t\t\ta.source AS \"aSource\",\n\t\t\t\ta.metadata AS \"aMetadata\",\n\t\t\t\ta.confidence AS \"aConfidence\",\n\t\t\t\ta.embedding AS \"aEmbedding\",\n\t\t\t\ta.embedding_model AS \"aEmbeddingModel\",\n\t\t\t\ta.embedding_dimensions AS \"aEmbeddingDimensions\",\n\t\t\t\ta.superseded_by AS \"aSupersededBy\",\n\t\t\t\ta.superseded_at AS \"aSupersededAt\",\n\t\t\t\ta.expires_at AS \"aExpiresAt\",\n\t\t\t\ta.last_accessed_at AS \"aLastAccessedAt\",\n\t\t\t\ta.access_count AS \"aAccessCount\",\n\t\t\t\ta.created_at AS \"aCreatedAt\",\n\t\t\t\ta.updated_at AS \"aUpdatedAt\",\n\t\t\t\tb.id AS \"bId\",\n\t\t\t\tb.entity_id AS \"bEntityId\",\n\t\t\t\tb.content AS \"bContent\",\n\t\t\t\tb.type AS \"bType\",\n\t\t\t\tb.importance AS \"bImportance\",\n\t\t\t\tb.tags AS \"bTags\",\n\t\t\t\tb.source AS \"bSource\",\n\t\t\t\tb.metadata AS \"bMetadata\",\n\t\t\t\tb.confidence AS \"bConfidence\",\n\t\t\t\tb.embedding AS \"bEmbedding\",\n\t\t\t\tb.embedding_model AS \"bEmbeddingModel\",\n\t\t\t\tb.embedding_dimensions AS \"bEmbeddingDimensions\",\n\t\t\t\tb.superseded_by AS \"bSupersededBy\",\n\t\t\t\tb.superseded_at AS \"bSupersededAt\",\n\t\t\t\tb.expires_at AS \"bExpiresAt\",\n\t\t\t\tb.last_accessed_at AS \"bLastAccessedAt\",\n\t\t\t\tb.access_count AS \"bAccessCount\",\n\t\t\t\tb.created_at AS \"bCreatedAt\",\n\t\t\t\tb.updated_at AS \"bUpdatedAt\",\n\t\t\t\t1 - (a.embedding <=> b.embedding) AS \"similarity\"\n\t\t\tFROM mnemocyte_memories a\n\t\t\tJOIN mnemocyte_memories b\n\t\t\t\tON b.entity_id = a.entity_id\n\t\t\t\tAND a.id < b.id\n\t\t\t\tAND a.embedding IS NOT NULL\n\t\t\t\tAND b.embedding IS NOT NULL\n\t\t\tWHERE\n\t\t\t\ta.entity_id = ${input.entityId}\n\t\t\t\t${input.includeSuperseded ? sql`` : sql`AND a.superseded_by IS NULL AND b.superseded_by IS NULL`}\n\t\t\t\t${input.includeExpired ? sql`` : sql`AND (a.expires_at IS NULL OR a.expires_at > now()) AND (b.expires_at IS NULL OR b.expires_at > now())`}\n\t\t\t\t${\n\t\t\t\t\tinput.types && input.types.length > 0\n\t\t\t\t\t\t? sql`AND a.type IN (${sql.join(\n\t\t\t\t\t\t\t\tinput.types.map((type) => sql`${type}`),\n\t\t\t\t\t\t\t\tsql`, `,\n\t\t\t\t\t\t\t)}) AND b.type IN (${sql.join(\n\t\t\t\t\t\t\t\tinput.types.map((type) => sql`${type}`),\n\t\t\t\t\t\t\t\tsql`, `,\n\t\t\t\t\t\t\t)})`\n\t\t\t\t\t\t: sql``\n\t\t\t\t}\n\t\t\t\t${duplicateTagsFilter(input.tags)}\n\t\t\t\tAND 1 - (a.embedding <=> b.embedding) >= ${input.threshold}\n\t\t\tORDER BY \"similarity\" DESC\n\t\t\tLIMIT ${input.limit}\n\t\t`,\n\t\tsignal,\n\t);\n\treturn rows.map((row) => {\n\t\tconst a = {\n\t\t\tid: row.aId,\n\t\t\tentityId: row.aEntityId,\n\t\t\tcontent: row.aContent,\n\t\t\ttype: row.aType,\n\t\t\timportance: row.aImportance,\n\t\t\ttags: row.aTags,\n\t\t\tsource: row.aSource,\n\t\t\tmetadata: row.aMetadata,\n\t\t\tconfidence: row.aConfidence,\n\t\t\tembedding: row.aEmbedding,\n\t\t\tembeddingModel: row.aEmbeddingModel,\n\t\t\tembeddingDimensions: row.aEmbeddingDimensions,\n\t\t\tsupersededBy: row.aSupersededBy,\n\t\t\tsupersededAt: row.aSupersededAt,\n\t\t\texpiresAt: row.aExpiresAt,\n\t\t\tlastAccessedAt: row.aLastAccessedAt,\n\t\t\taccessCount: row.aAccessCount,\n\t\t\tcreatedAt: row.aCreatedAt,\n\t\t\tupdatedAt: row.aUpdatedAt,\n\t\t} as unknown as MemoryRow;\n\t\tconst b = {\n\t\t\tid: row.bId,\n\t\t\tentityId: row.bEntityId,\n\t\t\tcontent: row.bContent,\n\t\t\ttype: row.bType,\n\t\t\timportance: row.bImportance,\n\t\t\ttags: row.bTags,\n\t\t\tsource: row.bSource,\n\t\t\tmetadata: row.bMetadata,\n\t\t\tconfidence: row.bConfidence,\n\t\t\tembedding: row.bEmbedding,\n\t\t\tembeddingModel: row.bEmbeddingModel,\n\t\t\tembeddingDimensions: row.bEmbeddingDimensions,\n\t\t\tsupersededBy: row.bSupersededBy,\n\t\t\tsupersededAt: row.bSupersededAt,\n\t\t\texpiresAt: row.bExpiresAt,\n\t\t\tlastAccessedAt: row.bLastAccessedAt,\n\t\t\taccessCount: row.bAccessCount,\n\t\t\tcreatedAt: row.bCreatedAt,\n\t\t\tupdatedAt: row.bUpdatedAt,\n\t\t} as unknown as MemoryRow;\n\t\treturn {\n\t\t\ta,\n\t\t\tb,\n\t\t\tsimilarity: Number(row.similarity) || 0,\n\t\t};\n\t});\n}\n\nexport interface SupersedeRow {\n\tid: string;\n\ttags: string[];\n}\n\nexport async function loadConsolidationTargets(\n\tdb: MnemocyteDatabase,\n\tentityId: string,\n\tids: readonly string[],\n): Promise<Array<{ id: string; tags: string[]; supersededBy: string | null }>> {\n\tif (ids.length === 0) {\n\t\treturn [];\n\t}\n\tconst rows = await db\n\t\t.select({\n\t\t\tid: memoriesTable.id,\n\t\t\ttags: memoriesTable.tags,\n\t\t\tsupersededBy: memoriesTable.supersededBy,\n\t\t})\n\t\t.from(memoriesTable)\n\t\t.where(\n\t\t\tand(\n\t\t\t\teq(memoriesTable.entityId, entityId),\n\t\t\t\tinArray(memoriesTable.id, [...ids]),\n\t\t\t),\n\t\t);\n\treturn rows;\n}\n\nexport async function lockConsolidationTargets(\n\tdb: MnemocyteDatabase,\n\tentityId: string,\n\tids: readonly string[],\n): Promise<Array<{ id: string; tags: string[]; supersededBy: string | null }>> {\n\tif (ids.length === 0) {\n\t\treturn [];\n\t}\n\treturn db\n\t\t.select({\n\t\t\tid: memoriesTable.id,\n\t\t\ttags: memoriesTable.tags,\n\t\t\tsupersededBy: memoriesTable.supersededBy,\n\t\t})\n\t\t.from(memoriesTable)\n\t\t.where(\n\t\t\tand(\n\t\t\t\teq(memoriesTable.entityId, entityId),\n\t\t\t\tinArray(memoriesTable.id, [...ids]),\n\t\t\t),\n\t\t)\n\t\t.orderBy(memoriesTable.id)\n\t\t.for(\"update\");\n}\n\nexport async function markMemoriesSuperseded(\n\tdb: MnemocyteDatabase,\n\tparams: {\n\t\tsurvivorId: string;\n\t\tentityId: string;\n\t\tids: readonly string[];\n\t\tnow: Date;\n\t},\n): Promise<SupersedeRow[]> {\n\tif (params.ids.length === 0) {\n\t\treturn [];\n\t}\n\tconst result = await db\n\t\t.update(memoriesTable)\n\t\t.set({\n\t\t\tsupersededBy: params.survivorId,\n\t\t\tsupersededAt: params.now,\n\t\t\tupdatedAt: params.now,\n\t\t})\n\t\t.where(\n\t\t\tand(\n\t\t\t\teq(memoriesTable.entityId, params.entityId),\n\t\t\t\tinArray(memoriesTable.id, [...params.ids]),\n\t\t\t\tisNull(memoriesTable.supersededBy),\n\t\t\t),\n\t\t)\n\t\t.returning({ id: memoriesTable.id, tags: memoriesTable.tags });\n\treturn result;\n}\n\nexport async function setMemoryTags(\n\tdb: MnemocyteDatabase,\n\tparams: {\n\t\tentityId: string;\n\t\tmemoryId: string;\n\t\ttags: readonly string[];\n\t\tnow: Date;\n\t},\n): Promise<void> {\n\tawait db\n\t\t.update(memoriesTable)\n\t\t.set({ tags: [...params.tags], updatedAt: params.now })\n\t\t.where(\n\t\t\tand(\n\t\t\t\teq(memoriesTable.entityId, params.entityId),\n\t\t\t\teq(memoriesTable.id, params.memoryId),\n\t\t\t),\n\t\t);\n}\n\nexport async function markMemoriesAccessed(\n\tdb: MnemocyteDatabase,\n\tmemoryIds: readonly string[],\n): Promise<\n\tArray<{\n\t\tid: string;\n\t\tlastAccessedAt: Date | null;\n\t\taccessCount: number;\n\t\tupdatedAt: Date;\n\t}>\n> {\n\tconst now = new Date();\n\tif (memoryIds.length === 0) {\n\t\treturn [];\n\t}\n\treturn db\n\t\t.update(memoriesTable)\n\t\t.set({\n\t\t\tlastAccessedAt: now,\n\t\t\taccessCount: sql`${memoriesTable.accessCount} + 1`,\n\t\t\tupdatedAt: now,\n\t\t})\n\t\t.where(inArray(memoriesTable.id, [...memoryIds]))\n\t\t.returning({\n\t\t\tid: memoriesTable.id,\n\t\t\tlastAccessedAt: memoriesTable.lastAccessedAt,\n\t\t\taccessCount: memoriesTable.accessCount,\n\t\t\tupdatedAt: memoriesTable.updatedAt,\n\t\t});\n}\n\nexport async function getMemoryEmbeddings(\n\tdb: MnemocyteDatabase,\n\tmemoryIds: readonly string[],\n): Promise<Map<string, number[]>> {\n\tif (memoryIds.length === 0) {\n\t\treturn new Map();\n\t}\n\tconst rows = await db\n\t\t.select({\n\t\t\tid: memoriesTable.id,\n\t\t\tembedding: memoriesTable.embedding,\n\t\t})\n\t\t.from(memoriesTable)\n\t\t.where(inArray(memoriesTable.id, [...memoryIds]));\n\treturn new Map(\n\t\trows.flatMap((row) => (row.embedding ? [[row.id, row.embedding]] : [])),\n\t);\n}\n\nexport async function vectorSearch(\n\tdb: MnemocyteDatabase,\n\tinput: VectorSearchInput,\n): Promise<VectorSearchRow[]> {\n\tconst embedding = vectorLiteral(input.embedding);\n\tconst vectorScore = clampedVectorScore(embedding);\n\tconst minVectorScore = input.minVectorScore ?? 0;\n\tconst rows = await db.execute(sql`\n\t\tSELECT\n\t\t\tid,\n\t\t\tentity_id AS \"entityId\",\n\t\t\tcontent,\n\t\t\ttype,\n\t\t\timportance,\n\t\t\ttags,\n\t\t\tsource,\n\t\t\tmetadata,\n\t\t\tconfidence,\n\t\t\tembedding_model AS \"embeddingModel\",\n\t\t\tembedding_dimensions AS \"embeddingDimensions\",\n\t\t\tsuperseded_by AS \"supersededBy\",\n\t\t\tsuperseded_at AS \"supersededAt\",\n\t\t\texpires_at AS \"expiresAt\",\n\t\t\tlast_accessed_at AS \"lastAccessedAt\",\n\t\t\taccess_count AS \"accessCount\",\n\t\t\tcreated_at AS \"createdAt\",\n\t\t\tupdated_at AS \"updatedAt\",\n\t\t\t${vectorScore} AS \"vectorScore\"\n\t\tFROM mnemocyte_memories\n\t\tWHERE\n\t\t\tentity_id = ${input.entityId}\n\t\t\tAND embedding IS NOT NULL\n\t\t\t${input.includeSuperseded ? sql`` : sql`AND superseded_by IS NULL`}\n\t\t\t${input.includeExpired ? sql`` : sql`AND (expires_at IS NULL OR expires_at > now())`}\n\t\t\t${\n\t\t\t\tinput.types && input.types.length > 0\n\t\t\t\t\t? sql`AND type IN (${sql.join(\n\t\t\t\t\t\t\tinput.types.map((type) => sql`${type}`),\n\t\t\t\t\t\t\tsql`, `,\n\t\t\t\t\t\t)})`\n\t\t\t\t\t: sql``\n\t\t\t}\n\t\t\t${rawTagsFilter(input.tags)}\n\t\t\t${input.before ? sql`AND created_at < ${timestampParam(input.before)}` : sql``}\n\t\t\t${input.after ? sql`AND created_at > ${timestampParam(input.after)}` : sql``}\n\t\t\tAND ${vectorScore} >= ${minVectorScore}\n\t\tORDER BY embedding <=> ${embedding}::vector\n\t\tLIMIT ${input.limit}\n\t`);\n\treturn rows as unknown as VectorSearchRow[];\n}\n\nexport async function lexicalSearch(\n\tdb: MnemocyteDatabase,\n\tinput: LexicalSearchInput,\n): Promise<LexicalSearchRow[]> {\n\tconst rows = await db.execute(sql`\n\t\tSELECT\n\t\t\tid,\n\t\t\tentity_id AS \"entityId\",\n\t\t\tcontent,\n\t\t\ttype,\n\t\t\timportance,\n\t\t\ttags,\n\t\t\tsource,\n\t\t\tmetadata,\n\t\t\tconfidence,\n\t\t\tembedding_model AS \"embeddingModel\",\n\t\t\tembedding_dimensions AS \"embeddingDimensions\",\n\t\t\tsuperseded_by AS \"supersededBy\",\n\t\t\tsuperseded_at AS \"supersededAt\",\n\t\t\texpires_at AS \"expiresAt\",\n\t\t\tlast_accessed_at AS \"lastAccessedAt\",\n\t\t\taccess_count AS \"accessCount\",\n\t\t\tcreated_at AS \"createdAt\",\n\t\t\tupdated_at AS \"updatedAt\",\n\t\t\tts_rank(to_tsvector('english', content), websearch_to_tsquery('english', ${input.query})) AS \"lexicalScore\"\n\t\tFROM mnemocyte_memories\n\t\tWHERE\n\t\t\tentity_id = ${input.entityId}\n\t\t\t${input.includeSuperseded ? sql`` : sql`AND superseded_by IS NULL`}\n\t\t\t${input.includeExpired ? sql`` : sql`AND (expires_at IS NULL OR expires_at > now())`}\n\t\t\t${\n\t\t\t\tinput.types && input.types.length > 0\n\t\t\t\t\t? sql`AND type IN (${sql.join(\n\t\t\t\t\t\t\tinput.types.map((type) => sql`${type}`),\n\t\t\t\t\t\t\tsql`, `,\n\t\t\t\t\t\t)})`\n\t\t\t\t\t: sql``\n\t\t\t}\n\t\t\t${rawTagsFilter(input.tags)}\n\t\t\t${input.before ? sql`AND created_at < ${timestampParam(input.before)}` : sql``}\n\t\t\t${input.after ? sql`AND created_at > ${timestampParam(input.after)}` : sql``}\n\t\t\tAND to_tsvector('english', content) @@ websearch_to_tsquery('english', ${input.query})\n\t\tORDER BY \"lexicalScore\" DESC\n\t\tLIMIT ${input.limit}\n\t`);\n\treturn rows as unknown as LexicalSearchRow[];\n}\n","import { and, eq, isNull } from \"drizzle-orm\";\nimport type { MnemocyteDatabase } from \"../index.js\";\nimport { type MetaRow, memoriesTable, metaTable } from \"../schema.js\";\n\nexport const INSTALLATION_META_KEY = \"installation\";\n\nexport async function getInstallationMeta(\n\tdb: MnemocyteDatabase,\n): Promise<MetaRow | null> {\n\tconst rows = await db\n\t\t.select()\n\t\t.from(metaTable)\n\t\t.where(eq(metaTable.key, INSTALLATION_META_KEY))\n\t\t.limit(1);\n\treturn rows[0] ?? null;\n}\n\nexport async function getStoredEmbeddingModels(\n\tdb: MnemocyteDatabase,\n): Promise<string[]> {\n\tconst rows = await db\n\t\t.selectDistinct({ embeddingModel: memoriesTable.embeddingModel })\n\t\t.from(memoriesTable)\n\t\t.limit(2);\n\treturn rows.map((row) => row.embeddingModel);\n}\n\nexport async function recordInstallationEmbeddingModel(\n\tdb: MnemocyteDatabase,\n\tembeddingModel: string,\n): Promise<MetaRow | null> {\n\tconst rows = await db\n\t\t.update(metaTable)\n\t\t.set({ embeddingModel })\n\t\t.where(\n\t\t\tand(\n\t\t\t\teq(metaTable.key, INSTALLATION_META_KEY),\n\t\t\t\tisNull(metaTable.embeddingModel),\n\t\t\t),\n\t\t)\n\t\t.returning();\n\treturn rows[0] ?? null;\n}\n","import type { MemoryRow } from \"../db/schema.js\";\nimport type { ImportanceLevel, Memory, MemoryType } from \"../types.js\";\nimport { cloneJsonObject } from \"./json.js\";\n\ntype MemoryRowTimestamp = Date | string;\n\ntype MemoryLikeRow = Omit<\n\tMemoryRow,\n\t| \"embedding\"\n\t| \"supersededAt\"\n\t| \"expiresAt\"\n\t| \"lastAccessedAt\"\n\t| \"createdAt\"\n\t| \"updatedAt\"\n> & {\n\tsupersededAt: MemoryRowTimestamp | null;\n\texpiresAt: MemoryRowTimestamp | null;\n\tlastAccessedAt: MemoryRowTimestamp | null;\n\tcreatedAt: MemoryRowTimestamp;\n\tupdatedAt: MemoryRowTimestamp;\n};\n\nfunction toDate(value: MemoryRowTimestamp): Date {\n\treturn value instanceof Date ? value : new Date(value);\n}\n\nfunction toNullableDate(value: MemoryRowTimestamp | null): Date | null {\n\treturn value === null ? null : toDate(value);\n}\n\nexport function rowToMemory(row: MemoryLikeRow): Memory {\n\treturn {\n\t\tid: row.id,\n\t\tentityId: row.entityId,\n\t\tcontent: row.content,\n\t\ttype: row.type as MemoryType,\n\t\timportance: row.importance as ImportanceLevel,\n\t\ttags: row.tags,\n\t\tsource: row.source,\n\t\tmetadata: cloneJsonObject(row.metadata),\n\t\tconfidence: row.confidence,\n\t\tembeddingModel: row.embeddingModel,\n\t\tembeddingDimensions: row.embeddingDimensions,\n\t\tsupersededBy: row.supersededBy,\n\t\tsupersededAt: toNullableDate(row.supersededAt),\n\t\texpiresAt: toNullableDate(row.expiresAt),\n\t\tlastAccessedAt: toNullableDate(row.lastAccessedAt),\n\t\taccessCount: row.accessCount,\n\t\tcreatedAt: toDate(row.createdAt),\n\t\tupdatedAt: toDate(row.updatedAt),\n\t};\n}\n","import type { DatabaseHandle } from \"../db/index.js\";\nimport { insertEvent, listEvents } from \"../db/queries/events.js\";\nimport {\n\tcountPruneMatches,\n\tdeleteMemoriesForEntity as deleteMemoriesForEntityQuery,\n\tdeleteMemory as deleteMemoryQuery,\n\tfindDuplicatePairs as findDuplicatePairsQuery,\n\tgetEntityMemoryStatsCounts,\n\tgetGlobalMemoryStatsCounts,\n\tgetMemoryById,\n\tgetMemoryEmbeddings as getMemoryEmbeddingsQuery,\n\tinsertMemories as insertMemoryRows,\n\tlexicalSearch as lexicalSearchQuery,\n\tloadConsolidationTargets,\n\tlockConsolidationTargets,\n\tmarkMemoriesAccessed,\n\tmarkMemoriesSuperseded,\n\ttype PruneFilter,\n\tpruneMemories,\n\tsetMemoryTags,\n\tvectorSearch as vectorSearchQuery,\n} from \"../db/queries/memories.js\";\nimport {\n\tgetInstallationMeta,\n\tgetStoredEmbeddingModels,\n\trecordInstallationEmbeddingModel,\n} from \"../db/queries/meta.js\";\nimport type { EventRow, NewMemoryRow } from \"../db/schema.js\";\nimport { MnemocyteError } from \"../errors.js\";\nimport { throwIfAborted } from \"../resilience.js\";\nimport type {\n\tAuditEvent,\n\tEmbedder,\n\tEntityStats,\n\tGlobalStats,\n\tImportanceLevel,\n\tMnemocyteClient,\n\tMnemocyteConfig,\n} from \"../types.js\";\nimport { createMemoryClient } from \"./client-core.js\";\nimport {\n\tDEFAULT_AUDIT_LOG_LIMIT,\n\tDEFAULT_DUPLICATE_LIMIT,\n\tDEFAULT_DUPLICATE_THRESHOLD,\n\tIMPORTANCE_RANK,\n} from \"./defaults.js\";\nimport { memoryHasDependentsError } from \"./deletion.js\";\nimport { cloneJsonObject } from \"./json.js\";\nimport { rowToMemory } from \"./postgres-records.js\";\nimport { createEventId, type StoredMemory } from \"./records.js\";\nimport {\n\tassertPruneFilterHasSelector,\n\ttype MemoryStore,\n\ttype StoreConsolidateInput,\n\ttype StoreConsolidateResult,\n\ttype StoreDuplicatePair,\n\ttype StoreLexicalCandidate,\n\ttype StoreLexicalSearchInput,\n\ttype StoreVectorCandidate,\n\ttype StoreVectorSearchInput,\n\ttype ValidatedPruneFilter,\n} from \"./store.js\";\n\nconst IMPORTANCE_LEVELS: readonly ImportanceLevel[] = [\n\t\"low\",\n\t\"normal\",\n\t\"high\",\n\t\"critical\",\n];\n\nconst MIGRATION_ERROR_CODES = new Set([\"42P01\", \"42703\", \"42704\", \"42883\"]);\nconst CONSOLIDATION_SURVIVOR_FOREIGN_KEY =\n\t\"mnemocyte_memories_superseded_by_mnemocyte_memories_id_fk\";\n\nfunction rowToAuditEvent(row: EventRow): AuditEvent {\n\treturn {\n\t\tid: row.id,\n\t\tentityId: row.entityId,\n\t\tdescription: row.description,\n\t\tmetadata: cloneJsonObject(row.metadata),\n\t\ttimestamp: new Date(row.timestamp),\n\t};\n}\n\nfunction importanceCeilingLevels(\n\tmax: ImportanceLevel,\n): readonly ImportanceLevel[] {\n\treturn IMPORTANCE_LEVELS.filter(\n\t\t(level) => IMPORTANCE_RANK[level] <= IMPORTANCE_RANK[max],\n\t);\n}\n\nfunction hasPostgresErrorCode(error: unknown, code: string): boolean {\n\treturn (\n\t\ttypeof error === \"object\" &&\n\t\terror !== null &&\n\t\t\"code\" in error &&\n\t\terror.code === code\n\t);\n}\n\nfunction hasPostgresConstraintName(error: unknown, name: string): boolean {\n\treturn (\n\t\ttypeof error === \"object\" &&\n\t\terror !== null &&\n\t\t\"constraint_name\" in error &&\n\t\terror.constraint_name === name\n\t);\n}\n\nfunction getPostgresErrorCode(error: unknown): string | undefined {\n\treturn typeof error === \"object\" &&\n\t\terror !== null &&\n\t\t\"code\" in error &&\n\t\ttypeof (error as { code?: unknown }).code === \"string\"\n\t\t? (error as { code: string }).code\n\t\t: undefined;\n}\n\nfunction normalizePostgresError(error: unknown): MnemocyteError {\n\tif (error instanceof MnemocyteError) {\n\t\treturn error;\n\t}\n\tconst code = getPostgresErrorCode(error);\n\tif (code && MIGRATION_ERROR_CODES.has(code)) {\n\t\treturn new MnemocyteError(\n\t\t\t\"Postgres schema is missing or incompatible. Apply the bundled Mnemocyte migrations before using the Postgres backend.\",\n\t\t\t\"MIGRATION\",\n\t\t\terror,\n\t\t);\n\t}\n\treturn new MnemocyteError(\"Postgres operation failed.\", \"DB\", error);\n}\n\nasync function runPostgresOperation<T>(\n\toperation: () => Promise<T>,\n): Promise<T> {\n\ttry {\n\t\treturn await operation();\n\t} catch (error) {\n\t\tthrow normalizePostgresError(error);\n\t}\n}\n\nasync function runPostgresDeleteOperation<T>(\n\toperation: () => Promise<T>,\n): Promise<T> {\n\ttry {\n\t\treturn await operation();\n\t} catch (error) {\n\t\tif (error instanceof MnemocyteError) {\n\t\t\tthrow error;\n\t\t}\n\t\tif (\n\t\t\thasPostgresErrorCode(error, \"23503\") &&\n\t\t\thasPostgresConstraintName(error, CONSOLIDATION_SURVIVOR_FOREIGN_KEY)\n\t\t) {\n\t\t\tthrow memoryHasDependentsError(error);\n\t\t}\n\t\tthrow normalizePostgresError(error);\n\t}\n}\n\nfunction toPruneFilter(input: ValidatedPruneFilter): PruneFilter {\n\tconst filter: PruneFilter = {};\n\tif (input.entityId !== undefined) {\n\t\tfilter.entityId = input.entityId;\n\t}\n\tif (input.expired === true) {\n\t\tfilter.expired = true;\n\t}\n\tif (input.superseded === true) {\n\t\tfilter.superseded = true;\n\t}\n\tif (input.createdBefore !== undefined) {\n\t\tfilter.createdBefore = input.createdBefore;\n\t}\n\tif (input.notAccessedSince !== undefined) {\n\t\tfilter.notAccessedSince = input.notAccessedSince;\n\t}\n\tif (input.types !== undefined && input.types.length > 0) {\n\t\tfilter.types = input.types;\n\t}\n\tif (input.tags !== undefined && input.tags.length > 0) {\n\t\tfilter.tags = input.tags;\n\t}\n\tif (input.maxImportance !== undefined) {\n\t\tfilter.maxImportanceLevels = importanceCeilingLevels(input.maxImportance);\n\t}\n\treturn filter;\n}\n\nfunction toMemoryRow(memory: StoredMemory): NewMemoryRow {\n\treturn {\n\t\t...memory,\n\t\ttags: [...memory.tags],\n\t\tembedding: [...memory.embedding],\n\t};\n}\n\nexport function createPostgresStore(handle: DatabaseHandle): MemoryStore {\n\tlet schemaValidated = false;\n\tlet schemaValidationPromise: Promise<void> | undefined;\n\n\tasync function ensureEmbeddingCompatibility(\n\t\tembedder: Embedder,\n\t): Promise<void> {\n\t\tif (schemaValidated) {\n\t\t\treturn;\n\t\t}\n\t\tif (!schemaValidationPromise) {\n\t\t\tschemaValidationPromise = validateEmbeddingCompatibility(embedder).catch(\n\t\t\t\t(error: unknown) => {\n\t\t\t\t\tschemaValidationPromise = undefined;\n\t\t\t\t\tthrow error;\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\t\tawait schemaValidationPromise;\n\t}\n\n\tasync function validateEmbeddingCompatibility(\n\t\tembedder: Embedder,\n\t): Promise<void> {\n\t\tlet meta: Awaited<ReturnType<typeof getInstallationMeta>>;\n\t\ttry {\n\t\t\tmeta = await getInstallationMeta(handle.db);\n\t\t} catch (error) {\n\t\t\tif (\n\t\t\t\thasPostgresErrorCode(error, \"42P01\") ||\n\t\t\t\thasPostgresErrorCode(error, \"42703\")\n\t\t\t) {\n\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\"Postgres embedding metadata is missing or outdated. Apply the bundled migrations through 0002_add_embedding_model.sql, or render a fresh dimension-specific initial migration, before using embedding-dependent operations.\",\n\t\t\t\t\t\"MIGRATION\",\n\t\t\t\t\terror,\n\t\t\t\t);\n\t\t\t}\n\t\t\tthrow normalizePostgresError(error);\n\t\t}\n\t\tif (!meta) {\n\t\t\tthrow new MnemocyteError(\n\t\t\t\t'mnemocyte_meta is missing the \"installation\" row. Apply the bundled migrations, or render a fresh dimension-specific initial migration, before using embedding-dependent operations.',\n\t\t\t\t\"MIGRATION\",\n\t\t\t);\n\t\t}\n\t\tif (meta.embeddingDimensions !== embedder.dimensions) {\n\t\t\tthrow new MnemocyteError(\n\t\t\t\t`embedder.dimensions (${embedder.dimensions}) must match mnemocyte_meta.embedding_dimensions (${meta.embeddingDimensions}). Render and apply a migration for the selected embedding dimension, or configure an embedder that matches this installation.`,\n\t\t\t\t\"CONFIG\",\n\t\t\t);\n\t\t}\n\t\tlet installationModel = meta.embeddingModel;\n\t\tif (installationModel === null) {\n\t\t\ttry {\n\t\t\t\tconst storedModels = await getStoredEmbeddingModels(handle.db);\n\t\t\t\tif (storedModels.length > 1) {\n\t\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\t\"mnemocyte_meta.embedding_model is unset, but stored memories contain multiple embedding_model values. Re-embed or remove the mixed historical rows, then explicitly record the installation model before using embedding-dependent operations.\",\n\t\t\t\t\t\t\"MIGRATION\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst inferredModel = storedModels[0] ?? embedder.model;\n\t\t\t\tconst recorded = await recordInstallationEmbeddingModel(\n\t\t\t\t\thandle.db,\n\t\t\t\t\tinferredModel,\n\t\t\t\t);\n\t\t\t\tif (recorded) {\n\t\t\t\t\tinstallationModel = recorded.embeddingModel;\n\t\t\t\t} else {\n\t\t\t\t\tconst concurrentlyRecorded = await getInstallationMeta(handle.db);\n\t\t\t\t\tinstallationModel = concurrentlyRecorded?.embeddingModel ?? null;\n\t\t\t\t}\n\t\t\t} catch (error) {\n\t\t\t\tthrow normalizePostgresError(error);\n\t\t\t}\n\t\t\tif (installationModel === null) {\n\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\"mnemocyte_meta.embedding_model could not be recorded. Verify the installation metadata row and retry.\",\n\t\t\t\t\t\"MIGRATION\",\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\tif (installationModel !== embedder.model) {\n\t\t\tthrow new MnemocyteError(\n\t\t\t\t`embedder.model (\"${embedder.model}\") must match mnemocyte_meta.embedding_model (\"${installationModel}\"). Configure the recorded model, or explicitly re-embed existing memories and update the installation metadata.`,\n\t\t\t\t\"CONFIG\",\n\t\t\t);\n\t\t}\n\t\tschemaValidated = true;\n\t}\n\n\treturn {\n\t\tbackend: \"postgres\",\n\t\tasync ensureSchema() {},\n\t\tensureEmbeddingCompatibility,\n\t\tasync insertMemories(memories) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tconst rows = await insertMemoryRows(\n\t\t\t\t\thandle.db,\n\t\t\t\t\tmemories.map(toMemoryRow),\n\t\t\t\t);\n\t\t\t\treturn rows.map(rowToMemory);\n\t\t\t});\n\t\t},\n\t\tasync vectorSearch(input: StoreVectorSearchInput) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tconst rows = await vectorSearchQuery(handle.db, input);\n\t\t\t\treturn rows.map(\n\t\t\t\t\t(row) =>\n\t\t\t\t\t\t({\n\t\t\t\t\t\t\tmemory: rowToMemory(row),\n\t\t\t\t\t\t\tvectorScore: row.vectorScore,\n\t\t\t\t\t\t}) satisfies StoreVectorCandidate,\n\t\t\t\t);\n\t\t\t});\n\t\t},\n\t\tasync lexicalSearch(input: StoreLexicalSearchInput) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tconst rows = await lexicalSearchQuery(handle.db, input);\n\t\t\t\treturn rows.map(\n\t\t\t\t\t(row) =>\n\t\t\t\t\t\t({\n\t\t\t\t\t\t\tmemory: rowToMemory(row),\n\t\t\t\t\t\t\tlexicalScore: row.lexicalScore,\n\t\t\t\t\t\t}) satisfies StoreLexicalCandidate,\n\t\t\t\t);\n\t\t\t});\n\t\t},\n\t\tasync getMemoryEmbeddings(memoryIds) {\n\t\t\treturn runPostgresOperation(() =>\n\t\t\t\tgetMemoryEmbeddingsQuery(handle.db, memoryIds),\n\t\t\t);\n\t\t},\n\t\tasync markMemoriesAccessed(memoryIds) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tconst rows = await markMemoriesAccessed(handle.db, memoryIds);\n\t\t\t\treturn rows.map((row) => {\n\t\t\t\t\tif (row.lastAccessedAt === null) {\n\t\t\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\t\t\"Postgres access update returned no timestamp.\",\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...row,\n\t\t\t\t\t\tlastAccessedAt: row.lastAccessedAt,\n\t\t\t\t\t};\n\t\t\t\t});\n\t\t\t});\n\t\t},\n\t\tasync deleteMemory(entityId, memoryId) {\n\t\t\treturn runPostgresDeleteOperation(async () => {\n\t\t\t\tconst result = await deleteMemoryQuery(handle.db, entityId, memoryId);\n\t\t\t\tif (result.hasDependents) {\n\t\t\t\t\tthrow memoryHasDependentsError();\n\t\t\t\t}\n\t\t\t\treturn result.deletedCount > 0;\n\t\t\t});\n\t\t},\n\t\tasync deleteMemoriesForEntity(entityId) {\n\t\t\treturn runPostgresDeleteOperation(async () => {\n\t\t\t\tconst result = await deleteMemoriesForEntityQuery(handle.db, entityId);\n\t\t\t\tif (result.hasDependents) {\n\t\t\t\t\tthrow memoryHasDependentsError();\n\t\t\t\t}\n\t\t\t\treturn result.deletedCount;\n\t\t\t});\n\t\t},\n\t\tasync prune(input, options) {\n\t\t\treturn runPostgresDeleteOperation(async () => {\n\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\tassertPruneFilterHasSelector(input);\n\t\t\t\tconst filter = toPruneFilter(input);\n\t\t\t\tconst dryRun = input.dryRun === true;\n\t\t\t\tif (dryRun) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tmatchedCount: await countPruneMatches(\n\t\t\t\t\t\t\thandle.db,\n\t\t\t\t\t\t\tfilter,\n\t\t\t\t\t\t\toptions?.signal,\n\t\t\t\t\t\t),\n\t\t\t\t\t\tdeletedCount: 0,\n\t\t\t\t\t\tdryRun: true,\n\t\t\t\t\t\tdeletedByEntity: [],\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tconst result = await pruneMemories(handle.db, filter, options?.signal);\n\t\t\t\tif (result.hasDependents) {\n\t\t\t\t\tthrow memoryHasDependentsError();\n\t\t\t\t}\n\t\t\t\treturn {\n\t\t\t\t\tmatchedCount: result.matchedCount,\n\t\t\t\t\tdeletedCount: result.deletedCount,\n\t\t\t\t\tdryRun: false,\n\t\t\t\t\tdeletedByEntity: result.deletedByEntity,\n\t\t\t\t};\n\t\t\t});\n\t\t},\n\t\tasync findDuplicatePairs(input, options) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tconst rows = await findDuplicatePairsQuery(\n\t\t\t\t\thandle.db,\n\t\t\t\t\t{\n\t\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\t\tthreshold: input.threshold ?? DEFAULT_DUPLICATE_THRESHOLD,\n\t\t\t\t\t\tlimit: input.limit ?? DEFAULT_DUPLICATE_LIMIT,\n\t\t\t\t\t\t...(input.types === undefined ? {} : { types: input.types }),\n\t\t\t\t\t\t...(input.tags === undefined ? {} : { tags: input.tags }),\n\t\t\t\t\t\t...(input.includeSuperseded === undefined\n\t\t\t\t\t\t\t? {}\n\t\t\t\t\t\t\t: { includeSuperseded: input.includeSuperseded }),\n\t\t\t\t\t\t...(input.includeExpired === undefined\n\t\t\t\t\t\t\t? {}\n\t\t\t\t\t\t\t: { includeExpired: input.includeExpired }),\n\t\t\t\t\t},\n\t\t\t\t\toptions?.signal,\n\t\t\t\t);\n\t\t\t\treturn rows.map(\n\t\t\t\t\t(row) =>\n\t\t\t\t\t\t({\n\t\t\t\t\t\t\ta: rowToMemory(row.a),\n\t\t\t\t\t\t\tb: rowToMemory(row.b),\n\t\t\t\t\t\t\tsimilarity: Math.max(0, Math.min(1, row.similarity)),\n\t\t\t\t\t\t}) satisfies StoreDuplicatePair,\n\t\t\t\t);\n\t\t\t});\n\t\t},\n\t\tasync addAuditEvents(events) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tfor (const event of events) {\n\t\t\t\t\tawait insertEvent(handle.db, {\n\t\t\t\t\t\tid: event.id,\n\t\t\t\t\t\tentityId: event.entityId,\n\t\t\t\t\t\tdescription: event.description,\n\t\t\t\t\t\tmetadata: cloneJsonObject(event.metadata),\n\t\t\t\t\t\ttimestamp: event.timestamp,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t});\n\t\t},\n\t\tasync listAuditLog(input, options) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tconst rows = await listEvents(\n\t\t\t\t\thandle.db,\n\t\t\t\t\t{\n\t\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\t\tlimit: input.limit ?? DEFAULT_AUDIT_LOG_LIMIT,\n\t\t\t\t\t\t...(input.before === undefined ? {} : { before: input.before }),\n\t\t\t\t\t\t...(input.after === undefined ? {} : { after: input.after }),\n\t\t\t\t\t\t...(input.beforeCursor === undefined\n\t\t\t\t\t\t\t? {}\n\t\t\t\t\t\t\t: { beforeCursor: input.beforeCursor }),\n\t\t\t\t\t\t...(input.afterCursor === undefined\n\t\t\t\t\t\t\t? {}\n\t\t\t\t\t\t\t: { afterCursor: input.afterCursor }),\n\t\t\t\t\t},\n\t\t\t\t\toptions?.signal,\n\t\t\t\t);\n\t\t\t\treturn rows.map(rowToAuditEvent);\n\t\t\t});\n\t\t},\n\t\tasync getMemory(entityId, memoryId, options) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\tconst row = await getMemoryById(handle.db, entityId, memoryId);\n\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\treturn row ? rowToMemory(row) : null;\n\t\t\t});\n\t\t},\n\t\tasync loadConsolidationTargets(entityId, ids, options) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\tconst targets = await loadConsolidationTargets(\n\t\t\t\t\thandle.db,\n\t\t\t\t\tentityId,\n\t\t\t\t\tids,\n\t\t\t\t);\n\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\treturn targets;\n\t\t\t});\n\t\t},\n\t\tasync consolidate(\n\t\t\tinput: StoreConsolidateInput,\n\t\t\toptions,\n\t\t): Promise<StoreConsolidateResult> {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\tconst newSupersededIds = await handle.db.transaction(async (tx) => {\n\t\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\t\tconst targets = await lockConsolidationTargets(\n\t\t\t\t\t\ttx,\n\t\t\t\t\t\tinput.entityId,\n\t\t\t\t\t\tinput.supersededIds,\n\t\t\t\t\t);\n\t\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\t\tif (\n\t\t\t\t\t\ttargets.some(\n\t\t\t\t\t\t\t(target) =>\n\t\t\t\t\t\t\t\ttarget.supersededBy !== null &&\n\t\t\t\t\t\t\t\ttarget.supersededBy !== input.survivorId,\n\t\t\t\t\t\t)\n\t\t\t\t\t) {\n\t\t\t\t\t\tthrow new MnemocyteError(\n\t\t\t\t\t\t\t\"Superseded memory already belongs to a different survivor.\",\n\t\t\t\t\t\t\t\"CONFLICT\",\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tconst activeIds = targets\n\t\t\t\t\t\t.filter((target) => target.supersededBy === null)\n\t\t\t\t\t\t.map((target) => target.id);\n\t\t\t\t\tconst updated = await markMemoriesSuperseded(tx, {\n\t\t\t\t\t\tsurvivorId: input.survivorId,\n\t\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\t\tids: activeIds,\n\t\t\t\t\t\tnow: input.now,\n\t\t\t\t\t});\n\t\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\t\tconst ids = updated.map((row) => row.id);\n\t\t\t\t\tif (input.auditEnabled) {\n\t\t\t\t\t\tfor (const id of ids) {\n\t\t\t\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\t\t\t\tawait insertEvent(tx, {\n\t\t\t\t\t\t\t\tid: createEventId(),\n\t\t\t\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\t\t\t\tdescription: \"memory.superseded\",\n\t\t\t\t\t\t\t\tmetadata: { memoryId: id, supersededBy: input.survivorId },\n\t\t\t\t\t\t\t\ttimestamp: input.now,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tif (input.mergeTags && updated.length > 0) {\n\t\t\t\t\t\tconst mergedTags = new Set(input.survivorTags);\n\t\t\t\t\t\tfor (const row of updated) {\n\t\t\t\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\t\t\t\tfor (const tag of row.tags) {\n\t\t\t\t\t\t\t\tmergedTags.add(tag);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (mergedTags.size !== input.survivorTags.length) {\n\t\t\t\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\t\t\t\tawait setMemoryTags(tx, {\n\t\t\t\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\t\t\t\tmemoryId: input.survivorId,\n\t\t\t\t\t\t\t\ttags: [...mergedTags],\n\t\t\t\t\t\t\t\tnow: input.now,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tthrowIfAborted(options?.signal);\n\t\t\t\t\treturn ids;\n\t\t\t\t});\n\t\t\t\treturn { supersededIds: newSupersededIds };\n\t\t\t});\n\t\t},\n\t\tasync stats(input, now) {\n\t\t\treturn runPostgresOperation(async () => {\n\t\t\t\tif (input?.entityId) {\n\t\t\t\t\tconst counts = await getEntityMemoryStatsCounts(\n\t\t\t\t\t\thandle.db,\n\t\t\t\t\t\tinput.entityId,\n\t\t\t\t\t\tnow,\n\t\t\t\t\t);\n\t\t\t\t\treturn {\n\t\t\t\t\t\tentityId: input.entityId,\n\t\t\t\t\t\t...counts,\n\t\t\t\t\t} satisfies EntityStats;\n\t\t\t\t}\n\t\t\t\treturn (await getGlobalMemoryStatsCounts(\n\t\t\t\t\thandle.db,\n\t\t\t\t\tnow,\n\t\t\t\t)) satisfies GlobalStats;\n\t\t\t});\n\t\t},\n\t\tasync close() {\n\t\t\treturn runPostgresOperation(() => handle.close());\n\t\t},\n\t};\n}\n\nexport function createPostgresClient(\n\tconfig: MnemocyteConfig,\n\thandle: DatabaseHandle,\n): MnemocyteClient {\n\treturn createMemoryClient(config, createPostgresStore(handle));\n}\n","import { createDatabase } from \"./db/index.js\";\nimport { createInMemoryClient } from \"./memory/in-memory.js\";\nimport { createPostgresClient } from \"./memory/postgres.js\";\nimport {\n\tassertEmbedder,\n\tassertNonEmptyString,\n\tvalidateProviderResilienceConfig,\n\tvalidateRetrievalConfig,\n} from \"./memory/validation.js\";\nimport type { MnemocyteClient, MnemocyteConfig } from \"./types.js\";\n\n/**\n * Create a Mnemocyte client.\n *\n * When {@link MnemocyteConfig.databaseUrl} is provided, a Postgres-backed\n * client is returned (requires the `pgvector` extension and the bundled\n * migration applied). Otherwise an in-memory client is returned, intended\n * for tests, demos, and short-lived processes.\n *\n * The returned client owns any underlying resources (e.g. the Postgres\n * connection pool). Call {@link MnemocyteClient.close} when finished to\n * release them.\n *\n * @param config - Client configuration. {@link MnemocyteConfig.embedder} is required.\n * @returns A {@link MnemocyteClient} instance.\n * @throws {MnemocyteError} With code `\"CONFIG\"` if `embedder`, retrieval\n * tuning, provider resilience, or the database URL is malformed or does not\n * use the `postgres:` / `postgresql:` protocol, or `\"VALIDATION\"` if\n * `databaseUrl` is explicitly empty.\n *\n * @example Postgres-backed client\n * ```ts\n * const client = createMnemocyte({\n *   databaseUrl: process.env.DATABASE_URL,\n *   embedder, // embedder.dimensions must match mnemocyte_meta\n * });\n * ```\n */\nexport function createMnemocyte(config: MnemocyteConfig): MnemocyteClient {\n\tassertEmbedder(config.embedder);\n\tvalidateRetrievalConfig(config.retrieval);\n\tvalidateProviderResilienceConfig(config.provider);\n\tif (config.databaseUrl !== undefined) {\n\t\tassertNonEmptyString(config.databaseUrl, \"databaseUrl\");\n\t\treturn createPostgresClient(config, createDatabase(config.databaseUrl));\n\t}\n\treturn createInMemoryClient(config);\n}\n"],"mappings":"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"}