@xopcai/xopc 0.0.117 → 0.0.118

package/dist/src/storage/sqlite/memory-index-repository.js

@@ -4,7 +4,8 @@ import { join, relative } from "node:path";
 import { existsSync, readFileSync, statSync } from "node:fs";
 import { createHash } from "node:crypto";
 //#region src/storage/sqlite/memory-index-repository.ts
-const CURATED_MEMORY_FILENAMES = new Set(["MEMORY.md", "USER.md"]);
+const AGENT_MEMORY_FILENAME = "MEMORY.md";
+const USER_MEMORY_DISPLAY_PATH = "user/MEMORY.md";
 const MEMORY_SYNC_CACHE_TTL_MS = 3e4;
 const memorySyncCache = /* @__PURE__ */ new Map();
 function resolveAgentIdFromMemoriesDir(memoriesDir) {
@@ -15,13 +16,12 @@ function getDailyMemoryPath(baseDir, date) {
 	const d = date || /* @__PURE__ */ new Date();
 	return join(baseDir, "memory", `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}.md`);
 }
-function getCuratedMemoryPaths(memoriesDir) {
-	if (!memoriesDir) return [];
-	return [join(memoriesDir, "MEMORY.md"), join(memoriesDir, "USER.md")].filter((p) => existsSync(p));
+function getCuratedMemoryPaths(memoriesDir, userMemoryPath) {
+	return [...memoriesDir ? [join(memoriesDir, AGENT_MEMORY_FILENAME)] : [], ...userMemoryPath ? [userMemoryPath] : []].filter((p) => existsSync(p));
 }
-function collectMemoryPaths(baseDir, memoriesDir) {
+function collectMemoryPaths(baseDir, memoriesDir, userMemoryPath) {
 	const paths = [];
-	paths.push(...getCuratedMemoryPaths(memoriesDir));
+	paths.push(...getCuratedMemoryPaths(memoriesDir, userMemoryPath));
 	const longTermPath = join(baseDir, "MEMORY.md");
 	if (existsSync(longTermPath)) paths.push(longTermPath);
 	if (existsSync(join(baseDir, "memory"))) {
@@ -35,13 +35,14 @@ function collectMemoryPaths(baseDir, memoriesDir) {
 	}
 	return paths;
 }
-function displayPath(baseDir, memoriesDir, absPath) {
+function displayPath(baseDir, memoriesDir, userMemoryPath, absPath) {
 	const normalized = absPath.replace(/\\/g, "/");
+	if (userMemoryPath && normalized === userMemoryPath.replace(/\\/g, "/")) return USER_MEMORY_DISPLAY_PATH;
 	if (memoriesDir) {
 		const memoriesRoot = memoriesDir.replace(/\\/g, "/");
 		if (normalized.startsWith(memoriesRoot)) {
 			const filename = normalized.slice(memoriesRoot.length).replace(/^\//, "");
-			if (CURATED_MEMORY_FILENAMES.has(filename)) return filename;
+			if (filename === AGENT_MEMORY_FILENAME) return filename;
 		}
 	}
 	return relative(baseDir, absPath).replace(/\\/g, "/");
@@ -52,11 +53,11 @@ function contentHash(content) {
 function bm25ToScore(rank) {
 	return 1 / (1 + Math.max(0, -rank));
 }
-function indexFile(db, agentId, baseDir, memoriesDir, absPath) {
+function indexFile(db, agentId, baseDir, memoriesDir, userMemoryPath, absPath) {
 	const content = readFileSync(absPath, "utf-8");
 	const mtimeMs = statSync(absPath).mtimeMs;
 	const hash = contentHash(content);
-	const relPath = displayPath(baseDir, memoriesDir, absPath);
+	const relPath = displayPath(baseDir, memoriesDir, userMemoryPath, absPath);
 	const fileId = `${agentId}:${relPath}`;
 	const existing = db.prepare(`SELECT content_hash, mtime_ms FROM memory_files WHERE file_id = ?`).get(fileId);
 	if (existing && existing.content_hash === hash && existing.mtime_ms === mtimeMs) return;
@@ -80,11 +81,11 @@ function indexFile(db, agentId, baseDir, memoriesDir, absPath) {
 	}
 }
 function syncMemoryIndex(params) {
-	const cacheKey = `${params.agentId}:${params.workspaceDir}:${params.memoriesDir ?? ""}`;
+	const cacheKey = `${params.agentId}:${params.workspaceDir}:${params.memoriesDir ?? ""}:${params.userMemoryPath ?? ""}`;
 	const now = Date.now();
 	const cached = memorySyncCache.get(cacheKey);
 	if (cached && now - cached.timestamp < MEMORY_SYNC_CACHE_TTL_MS) return;
-	const paths = collectMemoryPaths(params.workspaceDir, params.memoriesDir);
+	const paths = collectMemoryPaths(params.workspaceDir, params.memoriesDir, params.userMemoryPath);
 	memorySyncCache.set(cacheKey, {
 		timestamp: now,
 		paths
@@ -92,8 +93,8 @@ function syncMemoryIndex(params) {
 	runSqliteWriteTransaction((db) => {
 		const seen = /* @__PURE__ */ new Set();
 		for (const absPath of paths) {
-			seen.add(`${params.agentId}:${displayPath(params.workspaceDir, params.memoriesDir, absPath)}`);
-			indexFile(db, params.agentId, params.workspaceDir, params.memoriesDir, absPath);
+			seen.add(`${params.agentId}:${displayPath(params.workspaceDir, params.memoriesDir, params.userMemoryPath, absPath)}`);
+			indexFile(db, params.agentId, params.workspaceDir, params.memoriesDir, params.userMemoryPath, absPath);
 		}
 		const stale = db.prepare(`SELECT file_id FROM memory_files WHERE agent_id = ?`).all(params.agentId);
 		for (const row of stale) if (!seen.has(row.file_id)) {

package/dist/src/storage/sqlite/memory-index-repository.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-index-repository.js","names":[],"sources":["../../../../src/storage/sqlite/memory-index-repository.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { existsSync, readFileSync, statSync } from 'node:fs';\nimport { join, relative } from 'node:path';\n\nimport { escapeFts5Query } from './fts.js';\nimport { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';\n\nexport type MemorySearchHit = {\n  path: string;\n  lines: string;\n  score: number;\n  lineNumbers: number[];\n};\n\nconst CURATED_MEMORY_FILENAMES = new Set(['MEMORY.md', 'USER.md']);\nconst MEMORY_SYNC_CACHE_TTL_MS = 30_000;\n\ntype MemorySyncCache = {\n  timestamp: number;\n  paths: string[];\n};\n\nconst memorySyncCache = new Map<string, MemorySyncCache>();\n\nexport function resolveAgentIdFromMemoriesDir(memoriesDir: string | undefined): string {\n  if (!memoriesDir) return 'main';\n  const normalized = memoriesDir.replace(/\\\\/g, '/');\n  const match = normalized.match(/\\/agents\\/([^/]+)\\/memories\\/?$/);\n  return match?.[1] ?? 'main';\n}\n\nfunction getDailyMemoryPath(baseDir: string, date?: Date): string {\n  const d = date || new Date();\n  const year = d.getFullYear();\n  const month = String(d.getMonth() + 1).padStart(2, '0');\n  const day = String(d.getDate()).padStart(2, '0');\n  return join(baseDir, 'memory', `${year}-${month}-${day}.md`);\n}\n\nfunction getCuratedMemoryPaths(memoriesDir: string | undefined): string[] {\n  if (!memoriesDir) return [];\n  return [join(memoriesDir, 'MEMORY.md'), join(memoriesDir, 'USER.md')].filter((p) => existsSync(p));\n}\n\nfunction collectMemoryPaths(baseDir: string, memoriesDir?: string): string[] {\n  const paths: string[] = [];\n  paths.push(...getCuratedMemoryPaths(memoriesDir));\n\n  const longTermPath = join(baseDir, 'MEMORY.md');\n  if (existsSync(longTermPath)) {\n    paths.push(longTermPath);\n  }\n\n  const memoryDir = join(baseDir, 'memory');\n  if (existsSync(memoryDir)) {\n    const today = new Date();\n    for (let i = 0; i < 30; i++) {\n      const date = new Date(today);\n      date.setDate(date.getDate() - i);\n      const path = getDailyMemoryPath(baseDir, date);\n      if (existsSync(path)) {\n        paths.push(path);\n      }\n    }\n  }\n\n  return paths;\n}\n\nfunction displayPath(baseDir: string, memoriesDir: string | undefined, absPath: string): string {\n  const normalized = absPath.replace(/\\\\/g, '/');\n  if (memoriesDir) {\n    const memoriesRoot = memoriesDir.replace(/\\\\/g, '/');\n    if (normalized.startsWith(memoriesRoot)) {\n      const filename = normalized.slice(memoriesRoot.length).replace(/^\\//, '');\n      if (CURATED_MEMORY_FILENAMES.has(filename)) {\n        return filename;\n      }\n    }\n  }\n  return relative(baseDir, absPath).replace(/\\\\/g, '/');\n}\n\nfunction contentHash(content: string): string {\n  return createHash('sha256').update(content).digest('hex');\n}\n\nfunction bm25ToScore(rank: number): number {\n  return 1 / (1 + Math.max(0, -rank));\n}\n\nfunction indexFile(\n  db: ReturnType<typeof getSqliteDatabase>,\n  agentId: string,\n  baseDir: string,\n  memoriesDir: string | undefined,\n  absPath: string,\n): void {\n  const content = readFileSync(absPath, 'utf-8');\n  const mtimeMs = statSync(absPath).mtimeMs;\n  const hash = contentHash(content);\n  const relPath = displayPath(baseDir, memoriesDir, absPath);\n  const fileId = `${agentId}:${relPath}`;\n\n  const existing = db\n    .prepare(`SELECT content_hash, mtime_ms FROM memory_files WHERE file_id = ?`)\n    .get(fileId) as { content_hash: string; mtime_ms: number } | undefined;\n  if (existing && existing.content_hash === hash && existing.mtime_ms === mtimeMs) {\n    return;\n  }\n\n  db.prepare(`DELETE FROM memory_fts WHERE chunk_id IN (SELECT chunk_id FROM memory_chunks WHERE file_id = ?)`).run(\n    fileId,\n  );\n  db.prepare(`DELETE FROM memory_chunks WHERE file_id = ?`).run(fileId);\n  db.prepare(`DELETE FROM memory_files WHERE file_id = ?`).run(fileId);\n\n  db.prepare(\n    `INSERT INTO memory_files (file_id, agent_id, path, mtime_ms, content_hash)\n     VALUES (?, ?, ?, ?, ?)`,\n  ).run(fileId, agentId, relPath, mtimeMs, hash);\n\n  const lines = content.split('\\n');\n  const insertChunk = db.prepare(\n    `INSERT INTO memory_chunks (chunk_id, file_id, start_line, end_line, content)\n     VALUES (?, ?, ?, ?, ?)`,\n  );\n  const insertFts = db.prepare(\n    `INSERT INTO memory_fts (content, chunk_id, agent_id, path, start_line, end_line)\n     VALUES (?, ?, ?, ?, ?, ?)`,\n  );\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i];\n    if (!line.trim()) continue;\n    const lineNo = i + 1;\n    const chunkId = `${fileId}:${lineNo}`;\n    insertChunk.run(chunkId, fileId, lineNo, lineNo, line);\n    insertFts.run(line, chunkId, agentId, relPath, lineNo, lineNo);\n  }\n}\n\nexport function syncMemoryIndex(params: {\n  agentId: string;\n  workspaceDir: string;\n  memoriesDir?: string;\n}): void {\n  const cacheKey = `${params.agentId}:${params.workspaceDir}:${params.memoriesDir ?? ''}`;\n  const now = Date.now();\n  const cached = memorySyncCache.get(cacheKey);\n  if (cached && now - cached.timestamp < MEMORY_SYNC_CACHE_TTL_MS) {\n    return;\n  }\n\n  const paths = collectMemoryPaths(params.workspaceDir, params.memoriesDir);\n  memorySyncCache.set(cacheKey, { timestamp: now, paths });\n  runSqliteWriteTransaction((db) => {\n    const seen = new Set<string>();\n    for (const absPath of paths) {\n      seen.add(`${params.agentId}:${displayPath(params.workspaceDir, params.memoriesDir, absPath)}`);\n      indexFile(db, params.agentId, params.workspaceDir, params.memoriesDir, absPath);\n    }\n\n    const stale = db\n      .prepare(`SELECT file_id FROM memory_files WHERE agent_id = ?`)\n      .all(params.agentId) as Array<{ file_id: string }>;\n    for (const row of stale) {\n      if (!seen.has(row.file_id)) {\n        db.prepare(\n          `DELETE FROM memory_fts WHERE chunk_id IN (SELECT chunk_id FROM memory_chunks WHERE file_id = ?)`,\n        ).run(row.file_id);\n        db.prepare(`DELETE FROM memory_chunks WHERE file_id = ?`).run(row.file_id);\n        db.prepare(`DELETE FROM memory_files WHERE file_id = ?`).run(row.file_id);\n      }\n    }\n  });\n}\n\nexport function searchMemoryIndex(params: {\n  agentId: string;\n  query: string;\n  maxResults?: number;\n  minScore?: number;\n}): MemorySearchHit[] {\n  const { agentId, query, maxResults = 5, minScore = 0.3 } = params;\n  const ftsQuery = escapeFts5Query(query);\n  if (!ftsQuery) {\n    return [];\n  }\n\n  const db = getSqliteDatabase();\n  const rows = db\n    .prepare(\n      `SELECT chunk_id, path, start_line, end_line, content, bm25(memory_fts) AS rank\n       FROM memory_fts\n       WHERE memory_fts MATCH ? AND agent_id = ?\n       ORDER BY rank\n       LIMIT ?`,\n    )\n    .all(ftsQuery, agentId, maxResults * 3) as Array<{\n    chunk_id: string;\n    path: string;\n    start_line: number;\n    end_line: number;\n    content: string;\n    rank: number;\n  }>;\n\n  const results: MemorySearchHit[] = [];\n  for (const row of rows) {\n    const score = bm25ToScore(row.rank);\n    if (score < minScore) continue;\n    results.push({\n      path: row.path,\n      lines: row.content,\n      score,\n      lineNumbers: [row.start_line],\n    });\n  }\n\n  results.sort((a, b) => b.score - a.score);\n  return results.slice(0, maxResults);\n}\n"],"mappings":"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"}
+{"version":3,"file":"memory-index-repository.js","names":[],"sources":["../../../../src/storage/sqlite/memory-index-repository.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { existsSync, readFileSync, statSync } from 'node:fs';\nimport { join, relative } from 'node:path';\n\nimport { escapeFts5Query } from './fts.js';\nimport { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';\n\nexport type MemorySearchHit = {\n  path: string;\n  lines: string;\n  score: number;\n  lineNumbers: number[];\n};\n\nconst AGENT_MEMORY_FILENAME = 'MEMORY.md';\nconst USER_MEMORY_DISPLAY_PATH = 'user/MEMORY.md';\nconst MEMORY_SYNC_CACHE_TTL_MS = 30_000;\n\ntype MemorySyncCache = {\n  timestamp: number;\n  paths: string[];\n};\n\nconst memorySyncCache = new Map<string, MemorySyncCache>();\n\nexport function resolveAgentIdFromMemoriesDir(memoriesDir: string | undefined): string {\n  if (!memoriesDir) return 'main';\n  const normalized = memoriesDir.replace(/\\\\/g, '/');\n  const match = normalized.match(/\\/agents\\/([^/]+)\\/memories\\/?$/);\n  return match?.[1] ?? 'main';\n}\n\nfunction getDailyMemoryPath(baseDir: string, date?: Date): string {\n  const d = date || new Date();\n  const year = d.getFullYear();\n  const month = String(d.getMonth() + 1).padStart(2, '0');\n  const day = String(d.getDate()).padStart(2, '0');\n  return join(baseDir, 'memory', `${year}-${month}-${day}.md`);\n}\n\nfunction getCuratedMemoryPaths(memoriesDir: string | undefined, userMemoryPath: string | undefined): string[] {\n  return [\n    ...(memoriesDir ? [join(memoriesDir, AGENT_MEMORY_FILENAME)] : []),\n    ...(userMemoryPath ? [userMemoryPath] : []),\n  ].filter((p) => existsSync(p));\n}\n\nfunction collectMemoryPaths(baseDir: string, memoriesDir?: string, userMemoryPath?: string): string[] {\n  const paths: string[] = [];\n  paths.push(...getCuratedMemoryPaths(memoriesDir, userMemoryPath));\n\n  const longTermPath = join(baseDir, 'MEMORY.md');\n  if (existsSync(longTermPath)) {\n    paths.push(longTermPath);\n  }\n\n  const memoryDir = join(baseDir, 'memory');\n  if (existsSync(memoryDir)) {\n    const today = new Date();\n    for (let i = 0; i < 30; i++) {\n      const date = new Date(today);\n      date.setDate(date.getDate() - i);\n      const path = getDailyMemoryPath(baseDir, date);\n      if (existsSync(path)) {\n        paths.push(path);\n      }\n    }\n  }\n\n  return paths;\n}\n\nfunction displayPath(\n  baseDir: string,\n  memoriesDir: string | undefined,\n  userMemoryPath: string | undefined,\n  absPath: string,\n): string {\n  const normalized = absPath.replace(/\\\\/g, '/');\n  if (userMemoryPath && normalized === userMemoryPath.replace(/\\\\/g, '/')) {\n    return USER_MEMORY_DISPLAY_PATH;\n  }\n  if (memoriesDir) {\n    const memoriesRoot = memoriesDir.replace(/\\\\/g, '/');\n    if (normalized.startsWith(memoriesRoot)) {\n      const filename = normalized.slice(memoriesRoot.length).replace(/^\\//, '');\n      if (filename === AGENT_MEMORY_FILENAME) {\n        return filename;\n      }\n    }\n  }\n  return relative(baseDir, absPath).replace(/\\\\/g, '/');\n}\n\nfunction contentHash(content: string): string {\n  return createHash('sha256').update(content).digest('hex');\n}\n\nfunction bm25ToScore(rank: number): number {\n  return 1 / (1 + Math.max(0, -rank));\n}\n\nfunction indexFile(\n  db: ReturnType<typeof getSqliteDatabase>,\n  agentId: string,\n  baseDir: string,\n  memoriesDir: string | undefined,\n  userMemoryPath: string | undefined,\n  absPath: string,\n): void {\n  const content = readFileSync(absPath, 'utf-8');\n  const mtimeMs = statSync(absPath).mtimeMs;\n  const hash = contentHash(content);\n  const relPath = displayPath(baseDir, memoriesDir, userMemoryPath, absPath);\n  const fileId = `${agentId}:${relPath}`;\n\n  const existing = db\n    .prepare(`SELECT content_hash, mtime_ms FROM memory_files WHERE file_id = ?`)\n    .get(fileId) as { content_hash: string; mtime_ms: number } | undefined;\n  if (existing && existing.content_hash === hash && existing.mtime_ms === mtimeMs) {\n    return;\n  }\n\n  db.prepare(`DELETE FROM memory_fts WHERE chunk_id IN (SELECT chunk_id FROM memory_chunks WHERE file_id = ?)`).run(\n    fileId,\n  );\n  db.prepare(`DELETE FROM memory_chunks WHERE file_id = ?`).run(fileId);\n  db.prepare(`DELETE FROM memory_files WHERE file_id = ?`).run(fileId);\n\n  db.prepare(\n    `INSERT INTO memory_files (file_id, agent_id, path, mtime_ms, content_hash)\n     VALUES (?, ?, ?, ?, ?)`,\n  ).run(fileId, agentId, relPath, mtimeMs, hash);\n\n  const lines = content.split('\\n');\n  const insertChunk = db.prepare(\n    `INSERT INTO memory_chunks (chunk_id, file_id, start_line, end_line, content)\n     VALUES (?, ?, ?, ?, ?)`,\n  );\n  const insertFts = db.prepare(\n    `INSERT INTO memory_fts (content, chunk_id, agent_id, path, start_line, end_line)\n     VALUES (?, ?, ?, ?, ?, ?)`,\n  );\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i];\n    if (!line.trim()) continue;\n    const lineNo = i + 1;\n    const chunkId = `${fileId}:${lineNo}`;\n    insertChunk.run(chunkId, fileId, lineNo, lineNo, line);\n    insertFts.run(line, chunkId, agentId, relPath, lineNo, lineNo);\n  }\n}\n\nexport function syncMemoryIndex(params: {\n  agentId: string;\n  workspaceDir: string;\n  memoriesDir?: string;\n  userMemoryPath?: string;\n}): void {\n  const cacheKey = `${params.agentId}:${params.workspaceDir}:${params.memoriesDir ?? ''}:${params.userMemoryPath ?? ''}`;\n  const now = Date.now();\n  const cached = memorySyncCache.get(cacheKey);\n  if (cached && now - cached.timestamp < MEMORY_SYNC_CACHE_TTL_MS) {\n    return;\n  }\n\n  const paths = collectMemoryPaths(params.workspaceDir, params.memoriesDir, params.userMemoryPath);\n  memorySyncCache.set(cacheKey, { timestamp: now, paths });\n  runSqliteWriteTransaction((db) => {\n    const seen = new Set<string>();\n    for (const absPath of paths) {\n      seen.add(`${params.agentId}:${displayPath(params.workspaceDir, params.memoriesDir, params.userMemoryPath, absPath)}`);\n      indexFile(db, params.agentId, params.workspaceDir, params.memoriesDir, params.userMemoryPath, absPath);\n    }\n\n    const stale = db\n      .prepare(`SELECT file_id FROM memory_files WHERE agent_id = ?`)\n      .all(params.agentId) as Array<{ file_id: string }>;\n    for (const row of stale) {\n      if (!seen.has(row.file_id)) {\n        db.prepare(\n          `DELETE FROM memory_fts WHERE chunk_id IN (SELECT chunk_id FROM memory_chunks WHERE file_id = ?)`,\n        ).run(row.file_id);\n        db.prepare(`DELETE FROM memory_chunks WHERE file_id = ?`).run(row.file_id);\n        db.prepare(`DELETE FROM memory_files WHERE file_id = ?`).run(row.file_id);\n      }\n    }\n  });\n}\n\nexport function searchMemoryIndex(params: {\n  agentId: string;\n  query: string;\n  maxResults?: number;\n  minScore?: number;\n}): MemorySearchHit[] {\n  const { agentId, query, maxResults = 5, minScore = 0.3 } = params;\n  const ftsQuery = escapeFts5Query(query);\n  if (!ftsQuery) {\n    return [];\n  }\n\n  const db = getSqliteDatabase();\n  const rows = db\n    .prepare(\n      `SELECT chunk_id, path, start_line, end_line, content, bm25(memory_fts) AS rank\n       FROM memory_fts\n       WHERE memory_fts MATCH ? AND agent_id = ?\n       ORDER BY rank\n       LIMIT ?`,\n    )\n    .all(ftsQuery, agentId, maxResults * 3) as Array<{\n    chunk_id: string;\n    path: string;\n    start_line: number;\n    end_line: number;\n    content: string;\n    rank: number;\n  }>;\n\n  const results: MemorySearchHit[] = [];\n  for (const row of rows) {\n    const score = bm25ToScore(row.rank);\n    if (score < minScore) continue;\n    results.push({\n      path: row.path,\n      lines: row.content,\n      score,\n      lineNumbers: [row.start_line],\n    });\n  }\n\n  results.sort((a, b) => b.score - a.score);\n  return results.slice(0, maxResults);\n}\n"],"mappings":"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"}

package/dist/src/storage/sqlite/memory-records-repository.d.ts

@@ -1,4 +1,4 @@
-import type { MemoryKind, MemoryRecord, MemorySearchResult, MemorySignal } from '../../agent/memory/types.js';
+import type { MemoryKind, MemoryRecord, MemorySensitivity, MemorySearchResult, MemorySignal, MemoryStatus } from '../../agent/memory/types.js';
 export interface UpsertMemoryRecordInput {
     id?: string;
     providerId: string;
@@ -10,6 +10,11 @@ export interface UpsertMemoryRecordInput {
     source?: MemoryRecord['source'];
     confidence?: number;
     tags?: string[];
+    status?: MemoryStatus;
+    sensitivity?: MemorySensitivity;
+    evidence?: MemoryRecord['evidence'];
+    reviewAfter?: string;
+    expiresAt?: string;
     nowMs?: number;
 }
 export interface ListMemoryRecordsOptions {
@@ -17,6 +22,7 @@ export interface ListMemoryRecordsOptions {
     agentId?: string;
     workspaceId?: string;
     kind?: MemoryKind;
+    status?: MemoryStatus;
     limit?: number;
     offset?: number;
 }
@@ -26,6 +32,7 @@ export interface SearchMemoryRecordsOptions {
     workspaceId?: string;
     providerId?: string;
     kinds?: MemoryKind[];
+    statuses?: MemoryStatus[];
     maxResults?: number;
     minScore?: number;
 }
@@ -50,6 +57,15 @@ export interface MemorySignalRowPayload {
     metadata: Record<string, unknown>;
     createdAt: string;
 }
+export type MemoryTraceFeedbackOutcome = 'helpful' | 'not_helpful' | 'mixed' | 'irrelevant';
+export interface MemoryTraceFeedback {
+    outcome: MemoryTraceFeedbackOutcome;
+    score?: number;
+    reason?: string;
+    source?: 'user' | 'evaluator' | 'system';
+    createdAt: string;
+    updatedAt?: string;
+}
 export interface AppendMemoryTraceEventInput {
     sessionKey?: string;
     turnId?: string;
@@ -60,9 +76,18 @@ export interface AppendMemoryTraceEventInput {
     selectedRecordIds?: string[];
     skippedReason?: string;
     error?: string;
+    feedback?: MemoryTraceFeedback;
     durationMs?: number;
     nowMs?: number;
 }
+export interface SetMemoryTraceFeedbackInput {
+    traceId: string;
+    feedback: Omit<MemoryTraceFeedback, 'createdAt' | 'updatedAt'> & {
+        createdAt?: string;
+        updatedAt?: string;
+    };
+    nowMs?: number;
+}
 export interface MemoryTraceEventPayload {
     traceId: string;
     sessionKey?: string;
@@ -74,9 +99,20 @@ export interface MemoryTraceEventPayload {
     selectedRecordIds: string[];
     skippedReason?: string;
     error?: string;
+    feedback?: MemoryTraceFeedback;
     durationMs: number;
     createdAt: string;
 }
+export interface MemoryRecallFeedbackSummary {
+    recordId: string;
+    helpful: number;
+    notHelpful: number;
+    mixed: number;
+    irrelevant: number;
+    total: number;
+    averageScore: number | null;
+    lastFeedbackAt?: string;
+}
 export declare function upsertMemoryRecord(input: UpsertMemoryRecordInput): MemoryRecord;
 export declare function getMemoryRecord(recordId: string): MemoryRecord | null;
 export declare function listMemoryRecords(options?: ListMemoryRecordsOptions): MemoryRecord[];
@@ -99,3 +135,10 @@ export declare function listMemoryTraceEvents(options?: {
     phase?: string;
     limit?: number;
 }): MemoryTraceEventPayload[];
+export declare function setMemoryTraceFeedback(input: SetMemoryTraceFeedbackInput): MemoryTraceEventPayload | null;
+export declare function summarizeMemoryRecallFeedback(options?: {
+    recordId?: string;
+    providerId?: string;
+    sessionKey?: string;
+    limit?: number;
+}): MemoryRecallFeedbackSummary[];

package/dist/src/storage/sqlite/memory-records-repository.js

@@ -10,6 +10,73 @@ function parseStringArray(json) {
 		return [];
 	}
 }
+function parseEvidence(json) {
+	try {
+		const parsed = JSON.parse(json);
+		if (!Array.isArray(parsed)) return [];
+		return parsed.filter((item) => Boolean(item) && typeof item === "object");
+	} catch {
+		return [];
+	}
+}
+function parseMemoryTraceFeedback(json) {
+	try {
+		const parsed = JSON.parse(json);
+		if (!parsed || typeof parsed !== "object") return void 0;
+		const obj = parsed;
+		const outcome = obj.outcome;
+		if (outcome !== "helpful" && outcome !== "not_helpful" && outcome !== "mixed" && outcome !== "irrelevant") return;
+		return {
+			outcome,
+			...typeof obj.score === "number" ? { score: obj.score } : {},
+			...typeof obj.reason === "string" ? { reason: obj.reason } : {},
+			...obj.source === "user" || obj.source === "evaluator" || obj.source === "system" ? { source: obj.source } : {},
+			createdAt: typeof obj.createdAt === "string" ? obj.createdAt : (/* @__PURE__ */ new Date(0)).toISOString(),
+			...typeof obj.updatedAt === "string" ? { updatedAt: obj.updatedAt } : {}
+		};
+	} catch {
+		return;
+	}
+}
+function normalizeMemoryTraceFeedback(input, nowMs = Date.now(), existing) {
+	const score = typeof input.score === "number" ? Math.max(-1, Math.min(1, input.score)) : void 0;
+	const reason = typeof input.reason === "string" && input.reason.trim() ? input.reason.trim().slice(0, 1e3) : void 0;
+	const nowIso = new Date(nowMs).toISOString();
+	return {
+		outcome: input.outcome,
+		...score != null ? { score } : {},
+		...reason ? { reason } : {},
+		...input.source ? { source: input.source } : {},
+		createdAt: input.createdAt ?? existing?.createdAt ?? nowIso,
+		updatedAt: input.updatedAt ?? nowIso
+	};
+}
+function memoryTraceRowToPayload(row) {
+	const feedback = parseMemoryTraceFeedback(row.feedback_json);
+	return {
+		traceId: row.trace_id,
+		...row.session_key ? { sessionKey: row.session_key } : {},
+		...row.turn_id ? { turnId: row.turn_id } : {},
+		phase: row.phase,
+		providerId: row.provider_id,
+		request: parseJsonValue(row.request_json, {}),
+		...row.result_count != null ? { resultCount: row.result_count } : {},
+		selectedRecordIds: parseStringArray(row.selected_record_ids_json),
+		...row.skipped_reason ? { skippedReason: row.skipped_reason } : {},
+		...row.error ? { error: row.error } : {},
+		...feedback ? { feedback } : {},
+		durationMs: row.duration_ms,
+		createdAt: new Date(row.created_at).toISOString()
+	};
+}
+function parseOptionalTimestamp(value) {
+	if (!value?.trim()) return null;
+	const parsed = Date.parse(value);
+	return Number.isFinite(parsed) ? parsed : null;
+}
+function timestampToIso(value) {
+	return value == null ? void 0 : new Date(value).toISOString();
+}
 function parseSource(json) {
 	try {
 		const parsed = JSON.parse(json);
@@ -22,6 +89,7 @@ function rowToRecord(row) {
 	return {
 		id: row.record_id,
 		kind: row.kind,
+		status: row.status,
 		scope: {
 			agentId: row.agent_id,
 			...row.workspace_id ? { workspaceId: row.workspace_id } : {},
@@ -30,6 +98,10 @@ function rowToRecord(row) {
 		content: row.content,
 		source: parseSource(row.source_json),
 		...row.confidence != null ? { confidence: row.confidence } : {},
+		sensitivity: row.sensitivity,
+		evidence: parseEvidence(row.evidence_json),
+		...timestampToIso(row.review_after) ? { reviewAfter: timestampToIso(row.review_after) } : {},
+		...timestampToIso(row.expires_at) ? { expiresAt: timestampToIso(row.expires_at) } : {},
 		createdAt: new Date(row.created_at).toISOString(),
 		updatedAt: new Date(row.updated_at).toISOString(),
 		tags: parseStringArray(row.tags_json)
@@ -48,6 +120,10 @@ function upsertMemoryRecordFts(db, row) {
 function upsertMemoryRecord(input) {
 	const id = input.id ?? randomUUID();
 	const now = input.nowMs ?? Date.now();
+	const status = input.status ?? "active";
+	const sensitivity = input.sensitivity ?? "normal";
+	const reviewAfter = parseOptionalTimestamp(input.reviewAfter);
+	const expiresAt = parseOptionalTimestamp(input.expiresAt);
 	const source = {
 		...input.source ?? {},
 		provider: input.source?.provider ?? input.providerId
@@ -55,8 +131,9 @@ function upsertMemoryRecord(input) {
 	runSqliteWriteTransaction((db) => {
 		db.prepare(`INSERT INTO memory_records (
         record_id, provider_id, kind, agent_id, workspace_id, session_key,
-        content, source_json, confidence, tags_json, created_at, updated_at
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        content, source_json, confidence, tags_json, status, sensitivity,
+        evidence_json, review_after, expires_at, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       ON CONFLICT(record_id) DO UPDATE SET
         provider_id = excluded.provider_id,
         kind = excluded.kind,
@@ -67,7 +144,12 @@ function upsertMemoryRecord(input) {
         source_json = excluded.source_json,
         confidence = excluded.confidence,
         tags_json = excluded.tags_json,
-        updated_at = excluded.updated_at`).run(id, input.providerId, input.kind, input.agentId, input.workspaceId ?? null, input.sessionKey ?? null, input.content, JSON.stringify(source), input.confidence ?? null, JSON.stringify(input.tags ?? []), now, now);
+        status = excluded.status,
+        sensitivity = excluded.sensitivity,
+        evidence_json = excluded.evidence_json,
+        review_after = excluded.review_after,
+        expires_at = excluded.expires_at,
+        updated_at = excluded.updated_at`).run(id, input.providerId, input.kind, input.agentId, input.workspaceId ?? null, input.sessionKey ?? null, input.content, JSON.stringify(source), input.confidence ?? null, JSON.stringify(input.tags ?? []), status, sensitivity, JSON.stringify(input.evidence ?? []), reviewAfter, expiresAt, now, now);
 		upsertMemoryRecordFts(db, {
 			...input,
 			id
@@ -76,6 +158,7 @@ function upsertMemoryRecord(input) {
 	return {
 		id,
 		kind: input.kind,
+		status,
 		scope: {
 			agentId: input.agentId,
 			...input.workspaceId ? { workspaceId: input.workspaceId } : {},
@@ -84,6 +167,10 @@ function upsertMemoryRecord(input) {
 		content: input.content,
 		source,
 		...input.confidence != null ? { confidence: input.confidence } : {},
+		sensitivity,
+		evidence: input.evidence ?? [],
+		...reviewAfter != null ? { reviewAfter: new Date(reviewAfter).toISOString() } : {},
+		...expiresAt != null ? { expiresAt: new Date(expiresAt).toISOString() } : {},
 		createdAt: new Date(now).toISOString(),
 		updatedAt: new Date(now).toISOString(),
 		tags: input.tags ?? []
@@ -112,6 +199,10 @@ function listMemoryRecords(options = {}) {
 		where.push("kind = ?");
 		params.push(options.kind);
 	}
+	if (options.status) {
+		where.push("status = ?");
+		params.push(options.status);
+	}
 	const limit = Math.max(1, Math.min(500, options.limit ?? 100));
 	const offset = Math.max(0, options.offset ?? 0);
 	return getSqliteDatabase().prepare(`SELECT * FROM memory_records
@@ -140,6 +231,9 @@ function searchMemoryRecords(options) {
 		filters.push(`f.kind IN (${options.kinds.map(() => "?").join(", ")})`);
 		params.push(...options.kinds);
 	}
+	const statuses = options.statuses && options.statuses.length > 0 ? options.statuses : ["active"];
+	filters.push(`r.status IN (${statuses.map(() => "?").join(", ")})`);
+	params.push(...statuses);
 	const maxResults = Math.max(1, Math.min(50, options.maxResults ?? 5));
 	const minScore = options.minScore ?? 0;
 	return getSqliteDatabase().prepare(`SELECT
@@ -254,11 +348,12 @@ function setMemoryProviderState(providerId, scopeKey, state) {
 function appendMemoryTraceEvent(input) {
 	const id = randomUUID();
 	const now = input.nowMs ?? Date.now();
+	const feedback = input.feedback ? normalizeMemoryTraceFeedback(input.feedback, now) : void 0;
 	runSqliteWriteTransaction((db) => {
 		db.prepare(`INSERT INTO memory_trace_events (
         trace_id, session_key, turn_id, phase, provider_id, request_json,
-        result_count, selected_record_ids_json, skipped_reason, error, duration_ms, created_at
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, input.sessionKey ?? null, input.turnId ?? null, input.phase, input.providerId, JSON.stringify(input.request ?? {}), input.resultCount ?? null, JSON.stringify(input.selectedRecordIds ?? []), input.skippedReason ?? null, input.error ?? null, Math.max(0, Math.floor(input.durationMs ?? 0)), now);
+        result_count, selected_record_ids_json, skipped_reason, error, feedback_json, duration_ms, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, input.sessionKey ?? null, input.turnId ?? null, input.phase, input.providerId, JSON.stringify(input.request ?? {}), input.resultCount ?? null, JSON.stringify(input.selectedRecordIds ?? []), input.skippedReason ?? null, input.error ?? null, JSON.stringify(feedback ?? {}), Math.max(0, Math.floor(input.durationMs ?? 0)), now);
 	});
 	return id;
 }
@@ -281,20 +376,69 @@ function listMemoryTraceEvents(options = {}) {
 	return getSqliteDatabase().prepare(`SELECT * FROM memory_trace_events
        ${where.length > 0 ? `WHERE ${where.join(" AND ")}` : ""}
        ORDER BY created_at DESC
-       LIMIT ?`).all(...params, limit).map((row) => ({
-		traceId: row.trace_id,
-		...row.session_key ? { sessionKey: row.session_key } : {},
-		...row.turn_id ? { turnId: row.turn_id } : {},
-		phase: row.phase,
-		providerId: row.provider_id,
-		request: parseJsonValue(row.request_json, {}),
-		...row.result_count != null ? { resultCount: row.result_count } : {},
-		selectedRecordIds: parseStringArray(row.selected_record_ids_json),
-		...row.skipped_reason ? { skippedReason: row.skipped_reason } : {},
-		...row.error ? { error: row.error } : {},
-		durationMs: row.duration_ms,
-		createdAt: new Date(row.created_at).toISOString()
-	}));
+       LIMIT ?`).all(...params, limit).map(memoryTraceRowToPayload);
+}
+function setMemoryTraceFeedback(input) {
+	const existing = getSqliteDatabase().prepare(`SELECT * FROM memory_trace_events WHERE trace_id = ?`).get(input.traceId);
+	if (!existing) return null;
+	const feedback = normalizeMemoryTraceFeedback(input.feedback, input.nowMs, parseMemoryTraceFeedback(existing.feedback_json));
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`UPDATE memory_trace_events SET feedback_json = ? WHERE trace_id = ?`).run(JSON.stringify(feedback), input.traceId);
+	});
+	return memoryTraceRowToPayload({
+		...existing,
+		feedback_json: JSON.stringify(feedback)
+	});
+}
+function summarizeMemoryRecallFeedback(options = {}) {
+	const where = ["phase IN (?, ?)"];
+	const params = ["search", "inject"];
+	if (options.providerId) {
+		where.push("provider_id = ?");
+		params.push(options.providerId);
+	}
+	if (options.sessionKey) {
+		where.push("session_key = ?");
+		params.push(options.sessionKey);
+	}
+	const limit = Math.max(1, Math.min(5e3, options.limit ?? 1e3));
+	const rows = getSqliteDatabase().prepare(`SELECT * FROM memory_trace_events
+       WHERE ${where.join(" AND ")}
+       ORDER BY created_at DESC
+       LIMIT ?`).all(...params, limit);
+	const summaries = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		const feedback = parseMemoryTraceFeedback(row.feedback_json);
+		if (!feedback) continue;
+		const recordIds = parseStringArray(row.selected_record_ids_json);
+		for (const recordId of recordIds) {
+			if (options.recordId && recordId !== options.recordId) continue;
+			const current = summaries.get(recordId) ?? {
+				recordId,
+				helpful: 0,
+				notHelpful: 0,
+				mixed: 0,
+				irrelevant: 0,
+				total: 0,
+				averageScore: null,
+				scoreTotal: 0,
+				scoreCount: 0
+			};
+			if (feedback.outcome === "helpful") current.helpful += 1;
+			if (feedback.outcome === "not_helpful") current.notHelpful += 1;
+			if (feedback.outcome === "mixed") current.mixed += 1;
+			if (feedback.outcome === "irrelevant") current.irrelevant += 1;
+			current.total += 1;
+			if (typeof feedback.score === "number") {
+				current.scoreTotal += feedback.score;
+				current.scoreCount += 1;
+				current.averageScore = current.scoreTotal / current.scoreCount;
+			}
+			current.lastFeedbackAt ??= feedback.updatedAt ?? feedback.createdAt;
+			summaries.set(recordId, current);
+		}
+	}
+	return [...summaries.values()].map(({ scoreTotal: _scoreTotal, scoreCount: _scoreCount, ...summary }) => summary).sort((a, b) => b.total - a.total);
 }
 function parseJsonValue(json, fallback) {
 	try {
@@ -304,6 +448,6 @@ function parseJsonValue(json, fallback) {
 	}
 }
 //#endregion
-export { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryProviderState, getMemoryRecord, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, searchMemoryRecords, setMemoryProviderState, upsertMemoryRecord };
+export { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryProviderState, getMemoryRecord, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, searchMemoryRecords, setMemoryProviderState, setMemoryTraceFeedback, summarizeMemoryRecallFeedback, upsertMemoryRecord };
 
 //# sourceMappingURL=memory-records-repository.js.map