@xopcai/xopc 0.0.140 → 0.0.142

package/dist/src/agent/memory/dreaming/short-term-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"short-term-store.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/short-term-store.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { createHash, randomUUID } from 'node:crypto';\n\nimport type { MemorySearchOptions } from '../../prompt/memory/index.js';\nimport { createLogger } from '../../../utils/logger.js';\nimport {\n  SHORT_TERM_PROMOTION_LOCK_RELATIVE,\n  SHORT_TERM_RECALL_STORE_RELATIVE,\n} from './constants.js';\nimport { buildEntryKey, clamp01, isoDay, normalizeMemoryPath } from './utils.js';\n\nconst log = createLogger('Dreaming:Store');\n\nexport type DreamingStoreEntry = {\n  key: string;\n  path: string;\n  startLine: number;\n  endLine: number;\n  snippet: string;\n\n  // ── Signal dimensions ────────────────────────────────────────────────\n  /** Number of times this snippet was returned by a memory recall query. */\n  recallCount: number;\n  /** Number of times recorded from source-side sweep phases. */\n  sourceCount: number;\n  /** Number of times replayed from grounded context (agent-initiated). */\n  groundedCount: number;\n  /** Number of times the light phase touched this entry. */\n  lightHits: number;\n  /** Number of times the REM phase touched this entry. */\n  remHits: number;\n  /** Cross-phase hit count (light + deep + rem combined touches). */\n  phaseHitCount: number;\n  /** Weighted aggregate of all signal dimensions. */\n  totalSignalCount: number;\n\n  // ── Score tracking ───────────────────────────────────────────────────\n  totalScore: number;\n  maxScore: number;\n  queryHashes: string[];\n  recallDays: string[];\n\n  // ── Timestamps ───────────────────────────────────────────────────────\n  firstRecalledAt: string;\n  lastRecalledAt: string;\n  promotedAt?: string;\n};\n\nexport type DreamingStore = {\n  version: 1;\n  updatedAt: string;\n  entries: Record<string, DreamingStoreEntry>;\n};\n\ntype MemoryMatch = Awaited<ReturnType<typeof import('../../prompt/memory/index.js').memorySearch>>[number];\n\nfunction isRecordableMemoryPath(rel: string): boolean {\n  const p = normalizeMemoryPath(rel);\n  return p.length > 0 && !p.startsWith('../') && !path.isAbsolute(p);\n}\n\nfunction hashQuery(query: string): string {\n  return createHash('sha1').update(query.trim().toLowerCase()).digest('hex').slice(0, 12);\n}\n\nfunction mergeRecentDistinct(existing: string[], nextValue: string, limit: number): string[] {\n  const seen = new Set<string>();\n  const normalized = existing\n    .filter((v): v is string => typeof v === 'string')\n    .map((v) => v.trim())\n    .filter((v) => v.length > 0 && !seen.has(v) && (seen.add(v), true));\n  if (nextValue && !normalized.includes(nextValue)) {\n    normalized.push(nextValue);\n  }\n  return normalized.length <= limit ? normalized : normalized.slice(-limit);\n}\n\nfunction mergeQueryHashes(existing: string[], nextHash: string): string[] {\n  const out = mergeRecentDistinct(existing, nextHash, 32);\n  return out;\n}\n\nfunction emptyStore(nowIso: string): DreamingStore {\n  return { version: 1, updatedAt: nowIso, entries: {} };\n}\n\nasync function ensureDreamDir(dreamingRoot: string): Promise<string> {\n  const dir = path.join(dreamingRoot, path.dirname(SHORT_TERM_RECALL_STORE_RELATIVE));\n  await fs.mkdir(dir, { recursive: true });\n  return dir;\n}\n\nasync function readStore(dreamingRoot: string, nowIso: string): Promise<DreamingStore> {\n  const storePath = path.join(dreamingRoot, SHORT_TERM_RECALL_STORE_RELATIVE);\n  try {\n    const raw = await fs.readFile(storePath, 'utf-8');\n    const parsed = JSON.parse(raw) as unknown;\n    if (!parsed || typeof parsed !== 'object') return emptyStore(nowIso);\n    const rec = parsed as Partial<DreamingStore>;\n    if (rec.version !== 1 || !rec.entries || typeof rec.entries !== 'object') {\n      return emptyStore(nowIso);\n    }\n    return {\n      version: 1,\n      updatedAt: typeof rec.updatedAt === 'string' ? rec.updatedAt : nowIso,\n      entries: rec.entries as Record<string, DreamingStoreEntry>,\n    };\n  } catch (err) {\n    const code = (err as NodeJS.ErrnoException | undefined)?.code;\n    if (code === 'ENOENT') return emptyStore(nowIso);\n    log.warn({ err, dreamingRoot }, 'Failed to read dreaming store; resetting');\n    return emptyStore(nowIso);\n  }\n}\n\nasync function writeStore(dreamingRoot: string, store: DreamingStore): Promise<void> {\n  await ensureDreamDir(dreamingRoot);\n  const storePath = path.join(dreamingRoot, SHORT_TERM_RECALL_STORE_RELATIVE);\n  const tmp = `${storePath}.${process.pid}.${Date.now()}.${randomUUID()}.tmp`;\n  await fs.writeFile(tmp, `${JSON.stringify(store, null, 2)}\\n`, 'utf-8');\n  await fs.rename(tmp, storePath);\n}\n\nexport async function recordDreamingRecalls(params: {\n  dreamingRoot: string;\n  query: string;\n  matches: MemoryMatch[];\n  options?: MemorySearchOptions;\n  now?: Date;\n}): Promise<{ recorded: number; skipped: number; storePath: string }> {\n  const dreamingRoot = params.dreamingRoot.trim();\n  const query = params.query.trim();\n  if (!dreamingRoot || !query) {\n    return { recorded: 0, skipped: params.matches.length, storePath: SHORT_TERM_RECALL_STORE_RELATIVE };\n  }\n  const now = params.now ?? new Date();\n  const nowIso = now.toISOString();\n  const dayBucket = isoDay(now);\n  const qHash = hashQuery(query);\n\n  const store = await readStore(dreamingRoot, nowIso);\n\n  let recorded = 0;\n  let skipped = 0;\n  for (const match of params.matches) {\n    const file = typeof match?.file === \"string\" ? match.file : \"\";\n    if (!file || !isRecordableMemoryPath(file)) {\n      skipped += 1;\n      continue;\n    }\n    const lines = typeof match?.lines === \"string\" ? match.lines.trim() : \"\";\n    const lineNumbers = Array.isArray(match?.lineNumbers) ? match.lineNumbers : [];\n    const startLine = Math.max(1, Math.min(...lineNumbers.filter((n) => Number.isFinite(n) && n > 0)));\n    const endLine = Math.max(startLine, Math.max(...lineNumbers.filter((n) => Number.isFinite(n) && n > 0)));\n    if (!Number.isFinite(startLine) || !Number.isFinite(endLine)) {\n      skipped += 1;\n      continue;\n    }\n    const score = clamp01(Number(match.score));\n    const key = buildEntryKey({ path: file, startLine, endLine });\n    const existing = store.entries[key];\n    const snippet = lines.length > 0 ? lines.slice(0, 360) : file;\n\n    const next: DreamingStoreEntry = existing\n      ? {\n          ...existing,\n          snippet,\n          recallCount: Math.max(0, Math.floor(existing.recallCount + 1)),\n          sourceCount: existing.sourceCount ?? 0,\n          groundedCount: existing.groundedCount ?? 0,\n          lightHits: existing.lightHits ?? 0,\n          remHits: existing.remHits ?? 0,\n          phaseHitCount: existing.phaseHitCount ?? 0,\n          totalSignalCount: Math.max(0, (existing.totalSignalCount ?? existing.recallCount ?? 0) + 1),\n          totalScore: Math.max(0, existing.totalScore + score),\n          maxScore: Math.max(existing.maxScore, score),\n          queryHashes: mergeQueryHashes(existing.queryHashes ?? [], qHash),\n          recallDays: mergeRecentDistinct(existing.recallDays ?? [], dayBucket, 16),\n          lastRecalledAt: nowIso,\n        }\n      : {\n          key,\n          path: normalizeMemoryPath(file),\n          startLine,\n          endLine,\n          snippet,\n          recallCount: 1,\n          sourceCount: 0,\n          groundedCount: 0,\n          lightHits: 0,\n          remHits: 0,\n          phaseHitCount: 0,\n          totalSignalCount: 1,\n          totalScore: score,\n          maxScore: score,\n          queryHashes: [qHash],\n          recallDays: [dayBucket],\n          firstRecalledAt: nowIso,\n          lastRecalledAt: nowIso,\n        };\n\n    store.entries[key] = next;\n    recorded += 1;\n  }\n\n  if (recorded > 0) {\n    store.updatedAt = nowIso;\n    await writeStore(dreamingRoot, store);\n  }\n\n  return {\n    recorded,\n    skipped,\n    storePath: SHORT_TERM_RECALL_STORE_RELATIVE,\n  };\n}\n\nexport async function withDreamingPromotionLock<T>(\n  dreamingRoot: string,\n  task: () => Promise<T>,\n): Promise<T> {\n  const lockPath = path.join(dreamingRoot, SHORT_TERM_PROMOTION_LOCK_RELATIVE);\n  await ensureDreamDir(dreamingRoot);\n\n  const startedAt = Date.now();\n  const timeoutMs = 10_000;\n  const retryDelayMs = 50;\n\n  while (true) {\n    try {\n      const handle = await fs.open(lockPath, 'wx');\n      await handle.writeFile(`${process.pid}:${Date.now()}\\n`, 'utf-8').catch(() => undefined);\n      try {\n        return await task();\n      } finally {\n        await handle.close().catch(() => undefined);\n        await fs.unlink(lockPath).catch(() => undefined);\n      }\n    } catch (err) {\n      const code = (err as NodeJS.ErrnoException | undefined)?.code;\n      if (code !== 'EEXIST') {\n        throw err;\n      }\n      if (Date.now() - startedAt >= timeoutMs) {\n        throw new Error(`Timed out waiting for dreaming promotion lock at ${lockPath}`);\n      }\n      await new Promise((r) => setTimeout(r, retryDelayMs));\n    }\n  }\n}\n\nexport async function loadDreamingStore(params: {\n  dreamingRoot: string;\n}): Promise<{ store: DreamingStore; storePath: string }> {\n  const nowIso = new Date().toISOString();\n  const store = await readStore(params.dreamingRoot, nowIso);\n  return { store, storePath: SHORT_TERM_RECALL_STORE_RELATIVE };\n}\n\nexport async function saveDreamingStore(params: {\n  dreamingRoot: string;\n  store: DreamingStore;\n}): Promise<void> {\n  await writeStore(params.dreamingRoot, params.store);\n}\n\n// ── Phase-level signal helpers ─────────────────────────────────────────\n\ntype PhaseSignalField = 'sourceCount' | 'groundedCount' | 'lightHits' | 'remHits';\n\n/**\n * Increment a phase-specific signal counter on an existing store entry.\n * Also bumps `phaseHitCount` and `totalSignalCount`.\n * Returns `true` if the entry existed and was updated.\n */\nexport function bumpEntryPhaseSignal(\n  entry: DreamingStoreEntry,\n  field: PhaseSignalField,\n  increment = 1,\n): void {\n  entry[field] = (entry[field] ?? 0) + increment;\n  entry.phaseHitCount = (entry.phaseHitCount ?? 0) + increment;\n  entry.totalSignalCount = (entry.totalSignalCount ?? 0) + increment;\n}\n"],"mappings":"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"}
+{"version":3,"file":"short-term-store.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/short-term-store.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { createHash, randomUUID } from 'node:crypto';\n\nimport type { MemorySearchOptions } from '../../prompt/memory/index.js';\nimport { createLogger } from '../../../utils/logger.js';\nimport {\n  SHORT_TERM_PROMOTION_LOCK_RELATIVE,\n  SHORT_TERM_RECALL_STORE_RELATIVE,\n} from './constants.js';\nimport { buildEntryKey, clamp01, isoDay, normalizeMemoryPath } from './utils.js';\n\nconst log = createLogger('Dreaming:Store');\nconst STORE_MAX_ENTRIES = 2_000;\nconst STORE_MAX_AGE_MS = 90 * 24 * 60 * 60 * 1_000;\nconst PROMOTED_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1_000;\nconst LOCK_STALE_MS = 60_000;\n\nexport type DreamingStoreEntry = {\n  key: string;\n  path: string;\n  startLine: number;\n  endLine: number;\n  snippet: string;\n\n  // ── Signal dimensions ────────────────────────────────────────────────\n  /** Number of times this snippet was returned by a memory recall query. */\n  recallCount: number;\n  /** Number of times recorded from source-side sweep phases. */\n  sourceCount: number;\n  /** Number of times replayed from grounded context (agent-initiated). */\n  groundedCount: number;\n  /** Number of times the light phase touched this entry. */\n  lightHits: number;\n  /** Number of times the REM phase touched this entry. */\n  remHits: number;\n  /** Cross-phase hit count (light + deep + rem combined touches). */\n  phaseHitCount: number;\n  /** Weighted aggregate of all signal dimensions. */\n  totalSignalCount: number;\n\n  // ── Score tracking ───────────────────────────────────────────────────\n  totalScore: number;\n  maxScore: number;\n  queryHashes: string[];\n  recallDays: string[];\n\n  // ── Timestamps ───────────────────────────────────────────────────────\n  firstRecalledAt: string;\n  lastRecalledAt: string;\n  lastObservedAt?: string;\n  promotedAt?: string;\n};\n\nexport type DreamingStore = {\n  version: 1;\n  updatedAt: string;\n  entries: Record<string, DreamingStoreEntry>;\n};\n\ntype MemoryMatch = Awaited<ReturnType<typeof import('../../prompt/memory/index.js').memorySearch>>[number];\n\nfunction isRecordableMemoryPath(rel: string): boolean {\n  const p = normalizeMemoryPath(rel);\n  return p.length > 0 && !p.startsWith('../') && !path.isAbsolute(p);\n}\n\nfunction hashQuery(query: string): string {\n  return createHash('sha1').update(query.trim().toLowerCase()).digest('hex').slice(0, 12);\n}\n\nfunction mergeRecentDistinct(existing: string[], nextValue: string, limit: number): string[] {\n  const seen = new Set<string>();\n  const normalized = existing\n    .filter((v): v is string => typeof v === 'string')\n    .map((v) => v.trim())\n    .filter((v) => v.length > 0 && !seen.has(v) && (seen.add(v), true));\n  if (nextValue && !normalized.includes(nextValue)) {\n    normalized.push(nextValue);\n  }\n  return normalized.length <= limit ? normalized : normalized.slice(-limit);\n}\n\nfunction mergeQueryHashes(existing: string[], nextHash: string): string[] {\n  const out = mergeRecentDistinct(existing, nextHash, 32);\n  return out;\n}\n\nfunction emptyStore(nowIso: string): DreamingStore {\n  return { version: 1, updatedAt: nowIso, entries: {} };\n}\n\nasync function ensureDreamDir(dreamingRoot: string): Promise<string> {\n  const dir = path.join(dreamingRoot, path.dirname(SHORT_TERM_RECALL_STORE_RELATIVE));\n  await fs.mkdir(dir, { recursive: true });\n  return dir;\n}\n\nasync function readStore(dreamingRoot: string, nowIso: string): Promise<DreamingStore> {\n  const storePath = path.join(dreamingRoot, SHORT_TERM_RECALL_STORE_RELATIVE);\n  try {\n    const raw = await fs.readFile(storePath, 'utf-8');\n    const parsed = JSON.parse(raw) as unknown;\n    if (!parsed || typeof parsed !== 'object') {\n      throw new Error('Dreaming store root must be an object');\n    }\n    const rec = parsed as Partial<DreamingStore>;\n    if (rec.version !== 1 || !rec.entries || typeof rec.entries !== 'object') {\n      throw new Error('Dreaming store has an unsupported or invalid shape');\n    }\n    return {\n      version: 1,\n      updatedAt: typeof rec.updatedAt === 'string' ? rec.updatedAt : nowIso,\n      entries: rec.entries as Record<string, DreamingStoreEntry>,\n    };\n  } catch (err) {\n    const code = (err as NodeJS.ErrnoException | undefined)?.code;\n    if (code === 'ENOENT') return emptyStore(nowIso);\n    const quarantinePath = `${storePath}.corrupt-${Date.now()}`;\n    await fs.rename(storePath, quarantinePath).catch(() => undefined);\n    log.warn({ err, dreamingRoot, quarantinePath }, 'Failed to read dreaming store; quarantined corrupt data');\n    return emptyStore(nowIso);\n  }\n}\n\nfunction pruneStore(store: DreamingStore, nowMs = Date.now()): void {\n  for (const [key, entry] of Object.entries(store.entries)) {\n    const lastSeenMs = Math.max(\n      Date.parse(entry.lastRecalledAt || entry.firstRecalledAt),\n      entry.lastObservedAt ? Date.parse(entry.lastObservedAt) : 0,\n    );\n    const promotedMs = entry.promotedAt ? Date.parse(entry.promotedAt) : Number.NaN;\n    if (\n      (Number.isFinite(promotedMs) && nowMs - promotedMs > PROMOTED_MAX_AGE_MS)\n      || (Number.isFinite(lastSeenMs) && nowMs - lastSeenMs > STORE_MAX_AGE_MS)\n    ) {\n      delete store.entries[key];\n    }\n  }\n  const entries = Object.values(store.entries);\n  if (entries.length <= STORE_MAX_ENTRIES) return;\n  entries.sort((left, right) => {\n    if (Boolean(left.promotedAt) !== Boolean(right.promotedAt)) return left.promotedAt ? 1 : -1;\n    const signalDelta = (right.totalSignalCount ?? 0) - (left.totalSignalCount ?? 0);\n    if (signalDelta !== 0) return signalDelta;\n    return Date.parse(right.lastRecalledAt) - Date.parse(left.lastRecalledAt);\n  });\n  const keep = new Set(entries.slice(0, STORE_MAX_ENTRIES).map((entry) => entry.key));\n  for (const key of Object.keys(store.entries)) {\n    if (!keep.has(key)) delete store.entries[key];\n  }\n}\n\nasync function writeStore(dreamingRoot: string, store: DreamingStore): Promise<void> {\n  pruneStore(store);\n  await ensureDreamDir(dreamingRoot);\n  const storePath = path.join(dreamingRoot, SHORT_TERM_RECALL_STORE_RELATIVE);\n  const tmp = `${storePath}.${process.pid}.${Date.now()}.${randomUUID()}.tmp`;\n  await fs.writeFile(tmp, `${JSON.stringify(store, null, 2)}\\n`, 'utf-8');\n  await fs.rename(tmp, storePath);\n}\n\nexport async function recordDreamingRecalls(params: {\n  dreamingRoot: string;\n  query: string;\n  matches: MemoryMatch[];\n  options?: MemorySearchOptions;\n  now?: Date;\n}): Promise<{ recorded: number; skipped: number; storePath: string }> {\n  const dreamingRoot = params.dreamingRoot.trim();\n  const query = params.query.trim();\n  if (!dreamingRoot || !query) {\n    return { recorded: 0, skipped: params.matches.length, storePath: SHORT_TERM_RECALL_STORE_RELATIVE };\n  }\n  return withDreamingStoreLock(dreamingRoot, async () => {\n    const now = params.now ?? new Date();\n    const nowIso = now.toISOString();\n    const dayBucket = isoDay(now);\n    const qHash = hashQuery(query);\n    const store = await readStore(dreamingRoot, nowIso);\n\n    let recorded = 0;\n    let skipped = 0;\n    for (const match of params.matches) {\n      const file = typeof match?.file === 'string' ? match.file : '';\n      if (!file || !isRecordableMemoryPath(file)) {\n        skipped += 1;\n        continue;\n      }\n      const lines = typeof match?.lines === 'string' ? match.lines.trim() : '';\n      const lineNumbers = Array.isArray(match?.lineNumbers) ? match.lineNumbers : [];\n      const startLine = Math.max(1, Math.min(...lineNumbers.filter((n) => Number.isFinite(n) && n > 0)));\n      const endLine = Math.max(startLine, Math.max(...lineNumbers.filter((n) => Number.isFinite(n) && n > 0)));\n      if (!Number.isFinite(startLine) || !Number.isFinite(endLine)) {\n        skipped += 1;\n        continue;\n      }\n      const score = clamp01(Number(match.score));\n      const key = buildEntryKey({ path: file, startLine, endLine });\n      const existing = store.entries[key];\n      const snippet = lines.length > 0 ? lines.slice(0, 360) : file;\n\n      const next: DreamingStoreEntry = existing\n        ? {\n            ...existing,\n            snippet,\n            recallCount: Math.max(0, Math.floor(existing.recallCount + 1)),\n            sourceCount: existing.sourceCount ?? 0,\n            groundedCount: existing.groundedCount ?? 0,\n            lightHits: existing.lightHits ?? 0,\n            remHits: existing.remHits ?? 0,\n            phaseHitCount: existing.phaseHitCount ?? 0,\n            totalSignalCount: Math.max(0, (existing.totalSignalCount ?? existing.recallCount ?? 0) + 1),\n            totalScore: Math.max(0, existing.totalScore + score),\n            maxScore: Math.max(existing.maxScore, score),\n            queryHashes: mergeQueryHashes(existing.queryHashes ?? [], qHash),\n            recallDays: mergeRecentDistinct(existing.recallDays ?? [], dayBucket, 16),\n            lastRecalledAt: nowIso,\n          }\n        : {\n            key,\n            path: normalizeMemoryPath(file),\n            startLine,\n            endLine,\n            snippet,\n            recallCount: 1,\n            sourceCount: 0,\n            groundedCount: 0,\n            lightHits: 0,\n            remHits: 0,\n            phaseHitCount: 0,\n            totalSignalCount: 1,\n            totalScore: score,\n            maxScore: score,\n            queryHashes: [qHash],\n            recallDays: [dayBucket],\n            firstRecalledAt: nowIso,\n            lastRecalledAt: nowIso,\n          };\n\n      store.entries[key] = next;\n      recorded += 1;\n    }\n\n    if (recorded > 0) {\n      store.updatedAt = nowIso;\n      await writeStore(dreamingRoot, store);\n    }\n\n    return { recorded, skipped, storePath: SHORT_TERM_RECALL_STORE_RELATIVE };\n  });\n}\n\n/** Serialize all read-modify-write operations against the shared Dreaming store. */\nexport async function withDreamingStoreLock<T>(\n  dreamingRoot: string,\n  task: () => Promise<T>,\n): Promise<T> {\n  const lockPath = path.join(dreamingRoot, SHORT_TERM_PROMOTION_LOCK_RELATIVE);\n  await ensureDreamDir(dreamingRoot);\n\n  const startedAt = Date.now();\n  const timeoutMs = 10_000;\n  const retryDelayMs = 50;\n\n  while (true) {\n    try {\n      const handle = await fs.open(lockPath, 'wx');\n      await handle.writeFile(`${process.pid}:${Date.now()}\\n`, 'utf-8').catch(() => undefined);\n      try {\n        return await task();\n      } finally {\n        await handle.close().catch(() => undefined);\n        await fs.unlink(lockPath).catch(() => undefined);\n      }\n    } catch (err) {\n      const code = (err as NodeJS.ErrnoException | undefined)?.code;\n      if (code !== 'EEXIST') {\n        throw err;\n      }\n      const lockStat = await fs.stat(lockPath).catch(() => null);\n      if (lockStat && Date.now() - lockStat.mtimeMs > LOCK_STALE_MS && await lockOwnerIsDead(lockPath)) {\n        await fs.unlink(lockPath).catch(() => undefined);\n        log.warn({ lockPath, ageMs: Date.now() - lockStat.mtimeMs }, 'Removed stale dreaming lock');\n        continue;\n      }\n      if (Date.now() - startedAt >= timeoutMs) {\n        throw new Error(`Timed out waiting for dreaming promotion lock at ${lockPath}`);\n      }\n      await new Promise((r) => setTimeout(r, retryDelayMs));\n    }\n  }\n}\n\n/** @deprecated Use the store-level name; retained for callers outside this module. */\nexport async function withDreamingPromotionLock<T>(\n  dreamingRoot: string,\n  task: () => Promise<T>,\n): Promise<T> {\n  return withDreamingStoreLock(dreamingRoot, task);\n}\n\nasync function lockOwnerIsDead(lockPath: string): Promise<boolean> {\n  const raw = await fs.readFile(lockPath, 'utf-8').catch(() => '');\n  const pid = Number.parseInt(raw.split(':', 1)[0] ?? '', 10);\n  if (!Number.isFinite(pid) || pid <= 0) return true;\n  try {\n    process.kill(pid, 0);\n    return false;\n  } catch (error) {\n    return (error as NodeJS.ErrnoException | undefined)?.code === 'ESRCH';\n  }\n}\n\nexport async function loadDreamingStore(params: {\n  dreamingRoot: string;\n}): Promise<{ store: DreamingStore; storePath: string }> {\n  const nowIso = new Date().toISOString();\n  const store = await readStore(params.dreamingRoot, nowIso);\n  return { store, storePath: SHORT_TERM_RECALL_STORE_RELATIVE };\n}\n\nexport async function saveDreamingStore(params: {\n  dreamingRoot: string;\n  store: DreamingStore;\n}): Promise<void> {\n  await writeStore(params.dreamingRoot, params.store);\n}\n\nexport async function resetDreamingStore(params: {\n  dreamingRoot: string;\n  now?: Date;\n}): Promise<number> {\n  return withDreamingStoreLock(params.dreamingRoot, async () => {\n    const nowIso = (params.now ?? new Date()).toISOString();\n    const store = await readStore(params.dreamingRoot, nowIso);\n    const removed = Object.keys(store.entries).length;\n    await writeStore(params.dreamingRoot, emptyStore(nowIso));\n    return removed;\n  });\n}\n\n/** Remove only a stale lock whose owning process is no longer alive. */\nexport async function clearStaleDreamingLock(dreamingRoot: string): Promise<boolean> {\n  const lockPath = path.join(dreamingRoot, SHORT_TERM_PROMOTION_LOCK_RELATIVE);\n  const lockStat = await fs.stat(lockPath).catch((error: unknown) => {\n    if ((error as NodeJS.ErrnoException | undefined)?.code === 'ENOENT') return null;\n    throw error;\n  });\n  if (!lockStat) return false;\n  const ageMs = Date.now() - lockStat.mtimeMs;\n  if (ageMs <= LOCK_STALE_MS || !(await lockOwnerIsDead(lockPath))) {\n    throw new Error(`Dreaming lock is active and cannot be cleared: ${lockPath}`);\n  }\n  await fs.unlink(lockPath);\n  log.warn({ lockPath, ageMs }, 'Cleared stale dreaming lock');\n  return true;\n}\n\n// ── Phase-level signal helpers ─────────────────────────────────────────\n\ntype PhaseSignalField = 'sourceCount' | 'groundedCount' | 'lightHits' | 'remHits';\n\n/**\n * Increment a phase-specific signal counter on an existing store entry.\n * Also bumps `phaseHitCount` and `totalSignalCount`.\n * Returns `true` if the entry existed and was updated.\n */\nexport function bumpEntryPhaseSignal(\n  entry: DreamingStoreEntry,\n  field: PhaseSignalField,\n  increment = 1,\n): void {\n  entry[field] = (entry[field] ?? 0) + increment;\n  entry.phaseHitCount = (entry.phaseHitCount ?? 0) + increment;\n  entry.totalSignalCount = (entry.totalSignalCount ?? 0) + increment;\n}\n"],"mappings":"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"}

package/dist/src/agent/memory/manager.d.ts

@@ -1,6 +1,7 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';
 import type { UnderstandingCandidate } from './understanding/types.js';
+import type { MemoryAccessPolicy } from './access-policy.js';
 import type { MemoryDeleteRequest, MemoryListRequest, MemoryReadRequest, MemoryReadResult, MemorySearchRequest, MemorySearchResult, MemoryUpdateRequest, MemoryWriteRequest, MemoryWriteResult, MemoryRecord, MemorySignal, MemoryKind } from './types.js';
 export type MemorySearchStrategy = 'local-first' | 'external-first' | 'fanout' | 'local-only' | 'external-only';
 export type MemoryWriteStrategy = 'local-first' | 'external-first' | 'write-through' | 'local-only' | 'external-only';
@@ -12,6 +13,7 @@ export interface MemoryRoutingOptions {
 export interface MemoryManagerOptions extends MemoryRoutingOptions {
     loadProviders?: () => Promise<MemoryProvider[]>;
     writePolicy?: MemoryWritePolicy;
+    accessPolicy?: MemoryAccessPolicy;
 }
 export interface MemoryWritePolicy {
     allowExternalWrites?: boolean;
@@ -29,6 +31,7 @@ export declare class MemoryManager {
     private readonly understanding;
     private readonly lastTurnSourceItem;
     private understandingAgentId;
+    private readonly accessPolicy?;
     constructor(options?: MemoryManagerOptions);
     addProvider(provider: MemoryProvider): void;
     get providersList(): MemoryProvider[];
@@ -43,6 +46,7 @@ export declare class MemoryManager {
         sessionId?: string;
     }): Promise<void>;
     captureTurnUnderstanding(userContent: string, assistantContent: string, options?: {
+        agentId?: string;
         sessionId?: string;
         correctionTargetRecordIds?: string[];
     }): Promise<void>;
@@ -50,6 +54,7 @@ export declare class MemoryManager {
         sessionId?: string;
     }): Promise<void>;
     applyUnderstandingCandidates(candidates: UnderstandingCandidate[], context?: {
+        agentId?: string;
         sessionKey?: string;
         sourceText?: string;
         reviewSource?: 'turn' | 'background';
@@ -63,6 +68,8 @@ export declare class MemoryManager {
     write(request: MemoryWriteRequest): Promise<MemoryWriteResult>;
     update(request: MemoryUpdateRequest): Promise<MemoryWriteResult>;
     delete(request: MemoryDeleteRequest): Promise<MemoryWriteResult>;
+    private canReadRecord;
+    private crossAgentWriteDenied;
     onMemoryWrite(action: 'add' | 'replace' | 'remove', target: 'memory' | 'user', content: string): void;
     recordSignal(signal: MemorySignal): void;
     initializeAll(sessionId: string, options?: MemoryProviderInitOptions): Promise<void>;

package/dist/src/agent/memory/manager.js

@@ -17,6 +17,7 @@ var MemoryManager = class {
 	understanding;
 	lastTurnSourceItem = /* @__PURE__ */ new Map();
 	understandingAgentId;
+	accessPolicy;
 	constructor(options = {}) {
 		this.routing = {
 			searchStrategy: options.searchStrategy ?? "fanout",
@@ -24,6 +25,7 @@ var MemoryManager = class {
 			replicateTo: options.replicateTo ?? []
 		};
 		this.loadProviders = options.loadProviders;
+		this.accessPolicy = options.accessPolicy;
 		this.writePolicy = {
 			allowExternalWrites: options.writePolicy?.allowExternalWrites ?? false,
 			requireUserProfileApproval: options.writePolicy?.requireUserProfileApproval ?? false,
@@ -91,7 +93,7 @@ var MemoryManager = class {
 	}
 	async captureTurnUnderstanding(userContent, assistantContent, options) {
 		const review = await this.understanding.reviewTurn({
-			agentId: this.understandingAgentId,
+			agentId: options?.agentId ?? this.understandingAgentId,
 			userContent,
 			assistantContent,
 			sessionKey: options?.sessionId,
@@ -132,7 +134,7 @@ var MemoryManager = class {
 		const sourceItemId = context.sessionKey ? this.lastTurnSourceItem.get(context.sessionKey) : void 0;
 		await this.understanding.applyCandidates(candidates, {
 			...context,
-			agentId: this.understandingAgentId,
+			agentId: context.agentId ?? this.understandingAgentId,
 			sourceItemId
 		});
 		if (sourceItemId) setKnowledgeSourceItemSynthesisStatus([sourceItemId], "completed");
@@ -191,7 +193,7 @@ var MemoryManager = class {
 			}
 		}
 		const seen = /* @__PURE__ */ new Set();
-		return results.sort((a, b) => b.score - a.score).filter((result) => {
+		return results.sort((a, b) => b.score - a.score).filter((result) => this.canReadRecord(result.record, request.scope)).filter((result) => {
 			const key = `${result.citation.providerId}:${result.citation.recordId}`;
 			if (seen.has(key)) return false;
 			seen.add(key);
@@ -210,7 +212,7 @@ var MemoryManager = class {
 					durationMs: Date.now() - started,
 					sessionKey: request.scope?.sessionKey
 				});
-				if (result) return result;
+				if (result && this.canReadRecord(result.record, request.scope)) return result;
 			} catch (err) {
 				this.trace("read", p.id, request, {
 					error: err instanceof Error ? err.message : String(err),
@@ -230,7 +232,7 @@ var MemoryManager = class {
 			if (!p.capabilities.read) continue;
 			try {
 				const direct = await p.get?.(id);
-				if (direct) return direct;
+				if (direct && this.canReadRecord(direct)) return direct;
 			} catch (err) {
 				log.warn({
 					err,
@@ -246,7 +248,7 @@ var MemoryManager = class {
 		for (const p of this.providersForSearch()) {
 			if (!p.capabilities.read || !p.list) continue;
 			try {
-				out.push(...await p.list(request));
+				out.push(...(await p.list(request)).filter((record) => this.canReadRecord(record, request.scope)));
 			} catch (err) {
 				log.warn({
 					err,
@@ -257,14 +259,37 @@ var MemoryManager = class {
 		return out;
 	}
 	async write(request) {
+		const denied = this.crossAgentWriteDenied("write", request);
+		if (denied) return denied;
 		return this.writeWithStrategy("write", request);
 	}
 	async update(request) {
+		const denied = this.crossAgentWriteDenied("update", request);
+		if (denied) return denied;
 		return this.writeWithStrategy("update", request);
 	}
 	async delete(request) {
+		const denied = this.crossAgentWriteDenied("delete", request);
+		if (denied) return denied;
 		return this.writeWithStrategy("delete", request);
 	}
+	canReadRecord(record, scope) {
+		return this.accessPolicy?.canReadRecord(record, scope) ?? true;
+	}
+	crossAgentWriteDenied(action, request) {
+		if (!this.accessPolicy) return null;
+		const ownerAgentId = request.scope?.agentId ?? this.accessPolicy.requesterAgentId;
+		if (ownerAgentId === this.accessPolicy.requesterAgentId) return null;
+		if (action !== "write" || !("status" in request) || request.status !== "candidate") return {
+			success: false,
+			error: "Cross-agent changes must be submitted as memory candidates"
+		};
+		if (!this.accessPolicy.canSubmitCandidate(ownerAgentId)) return {
+			success: false,
+			error: "Cross-agent candidate submission is not allowed"
+		};
+		return null;
+	}
 	onMemoryWrite(action, target, content) {
 		for (const p of this.providers) {
 			if (p.capabilities.local) continue;

package/dist/src/agent/memory/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","names":[],"sources":["../../../../src/agent/memory/manager.ts"],"sourcesContent":["import type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport { appendMemoryTraceEvent, setKnowledgeSourceItemSynthesisStatus } from '../../storage/sqlite/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';\nimport { UserUnderstandingService } from './understanding/service.js';\nimport type { UnderstandingCandidate } from './understanding/types.js';\nimport type {\n  MemoryDeleteRequest,\n  MemoryListRequest,\n  MemoryReadRequest,\n  MemoryReadResult,\n  MemorySearchRequest,\n  MemorySearchResult,\n  MemorySyncEvent,\n  MemoryUpdateRequest,\n  MemoryWriteRequest,\n  MemoryWriteResult,\n  MemoryRecord,\n  MemorySignal,\n  MemoryKind,\n} from './types.js';\n\nconst log = createLogger('MemoryManager');\n\nexport type MemorySearchStrategy = 'local-first' | 'external-first' | 'fanout' | 'local-only' | 'external-only';\nexport type MemoryWriteStrategy = 'local-first' | 'external-first' | 'write-through' | 'local-only' | 'external-only';\n\nexport interface MemoryRoutingOptions {\n  searchStrategy?: MemorySearchStrategy;\n  writeStrategy?: MemoryWriteStrategy;\n  replicateTo?: string[];\n}\n\nexport interface MemoryManagerOptions extends MemoryRoutingOptions {\n  loadProviders?: () => Promise<MemoryProvider[]>;\n  writePolicy?: MemoryWritePolicy;\n}\n\nexport interface MemoryWritePolicy {\n  allowExternalWrites?: boolean;\n  allowedProviderIds?: string[];\n  autoWriteKinds?: MemoryKind[];\n  requireUserProfileApproval?: boolean;\n}\n\nexport class MemoryManager {\n  private providers: MemoryProvider[] = [];\n  private toolToProvider = new Map<string, MemoryProvider>();\n  private readonly routing: Required<MemoryRoutingOptions>;\n  private readonly loadProviders?: () => Promise<MemoryProvider[]>;\n  private readonly writePolicy: Required<Pick<MemoryWritePolicy, 'allowExternalWrites' | 'requireUserProfileApproval'>> &\n    Omit<MemoryWritePolicy, 'allowExternalWrites' | 'requireUserProfileApproval'>;\n  private pluginProvidersLoaded = false;\n  private readonly understanding: UserUnderstandingService;\n  private readonly lastTurnSourceItem = new Map<string, string>();\n  private understandingAgentId: string | undefined;\n\n  constructor(options: MemoryManagerOptions = {}) {\n    this.routing = {\n      searchStrategy: options.searchStrategy ?? 'fanout',\n      writeStrategy: options.writeStrategy ?? 'local-first',\n      replicateTo: options.replicateTo ?? [],\n    };\n    this.loadProviders = options.loadProviders;\n    this.writePolicy = {\n      allowExternalWrites: options.writePolicy?.allowExternalWrites ?? false,\n      requireUserProfileApproval: options.writePolicy?.requireUserProfileApproval ?? false,\n      allowedProviderIds: options.writePolicy?.allowedProviderIds,\n      autoWriteKinds: options.writePolicy?.autoWriteKinds,\n    };\n    this.understanding = new UserUnderstandingService({\n      write: (request) => this.write(request),\n      list: (canonicalKey) => this.list({ canonicalKey }),\n    });\n  }\n\n  addProvider(provider: MemoryProvider): void {\n    this.providers.push(provider);\n\n    for (const schema of provider.getToolSchemas?.() ?? []) {\n      const toolName = schema.name;\n      if (!toolName) {\n        continue;\n      }\n      if (!this.toolToProvider.has(toolName)) {\n        this.toolToProvider.set(toolName, provider);\n      } else {\n        log.warn(\n          { toolName, existing: this.toolToProvider.get(toolName)?.id, ignored: provider.id },\n          'Memory tool name conflict',\n        );\n      }\n    }\n\n    log.info(\n      { id: provider.id, toolCount: provider.getToolSchemas?.().length ?? 0, capabilities: provider.capabilities },\n      'Memory provider registered',\n    );\n  }\n\n  get providersList(): MemoryProvider[] {\n    return [...this.providers];\n  }\n\n  /**\n   * Non-builtin static instructions (builtin uses curated snapshot in system prompt builder).\n   */\n  buildExternalSystemPrompt(): string {\n    const blocks: string[] = [];\n    for (const p of this.providers) {\n      if (p.capabilities.local) {\n        continue;\n      }\n      try {\n        const block = p.systemPromptBlock?.();\n        if (block?.trim()) {\n          blocks.push(block.trim());\n        }\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'systemPromptBlock failed');\n      }\n    }\n    return blocks.join('\\n\\n');\n  }\n\n  queuePrefetchAll(query: string, options?: { sessionId?: string }): void {\n    for (const p of this.providers) {\n      try {\n        p.queuePrefetch?.(query, options);\n      } catch (err) {\n        log.debug({ err, id: p.id }, 'queuePrefetch failed (non-fatal)');\n      }\n    }\n  }\n\n  async syncAll(userContent: string, assistantContent: string, options?: { sessionId?: string }): Promise<void> {\n    await this.captureTurnUnderstanding(userContent, assistantContent, options);\n    await this.syncProvidersForTurn(userContent, assistantContent, options);\n  }\n\n  async captureTurnUnderstanding(\n    userContent: string,\n    assistantContent: string,\n    options?: { sessionId?: string; correctionTargetRecordIds?: string[] },\n  ): Promise<void> {\n    const review = await this.understanding.reviewTurn({\n      agentId: this.understandingAgentId,\n      userContent,\n      assistantContent,\n      sessionKey: options?.sessionId,\n      correctionTargetRecordIds: options?.correctionTargetRecordIds,\n    });\n    if (options?.sessionId && review.sourceItemId) {\n      this.lastTurnSourceItem.set(options.sessionId, review.sourceItemId);\n    }\n  }\n\n  async syncProvidersForTurn(\n    userContent: string,\n    assistantContent: string,\n    options?: { sessionId?: string },\n  ): Promise<void> {\n    const event: MemorySyncEvent = {\n      type: 'turn',\n      userContent,\n      assistantContent,\n      sessionId: options?.sessionId,\n    };\n    for (const p of this.providers) {\n      const started = Date.now();\n      try {\n        await p.sync?.(event);\n        this.trace('sync', p.id, event, {\n          resultCount: 1,\n          durationMs: Date.now() - started,\n          sessionKey: options?.sessionId,\n        });\n      } catch (err) {\n        this.trace('sync', p.id, event, {\n          error: err instanceof Error ? err.message : String(err),\n          durationMs: Date.now() - started,\n          sessionKey: options?.sessionId,\n        });\n        log.warn({ err, id: p.id }, 'memory sync failed');\n      }\n    }\n  }\n\n  async applyUnderstandingCandidates(\n    candidates: UnderstandingCandidate[],\n    context: {\n      sessionKey?: string;\n      sourceText?: string;\n      reviewSource?: 'turn' | 'background';\n    } = {},\n  ): Promise<void> {\n    const sourceItemId = context.sessionKey\n      ? this.lastTurnSourceItem.get(context.sessionKey)\n      : undefined;\n    await this.understanding.applyCandidates(candidates, {\n      ...context,\n      agentId: this.understandingAgentId,\n      sourceItemId,\n    });\n    if (sourceItemId) {\n      setKnowledgeSourceItemSynthesisStatus([sourceItemId], 'completed');\n    }\n  }\n\n  getAdditionalTools(): AgentTool[] {\n    const out: AgentTool[] = [];\n    const seen = new Set<string>();\n    for (const p of this.providers) {\n      if (p.capabilities.local) {\n        continue;\n      }\n      try {\n        for (const t of p.getToolSchemas?.() ?? []) {\n          if (t.name && !seen.has(t.name)) {\n            seen.add(t.name);\n            out.push(t);\n          }\n        }\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'getToolSchemas failed');\n      }\n    }\n    return out;\n  }\n\n  async handleToolCall(toolName: string, args: Record<string, unknown>): Promise<string> {\n    const provider = this.toolToProvider.get(toolName);\n    if (!provider) {\n      throw new Error(`No memory provider handles tool '${toolName}'`);\n    }\n    if (!provider.handleToolCall) {\n      throw new Error(`Memory provider '${provider.id}' does not handle tool calls`);\n    }\n    return provider.handleToolCall(toolName, args);\n  }\n\n  async search(request: MemorySearchRequest): Promise<MemorySearchResult[]> {\n    const providers = this.providersForSearch();\n    const results: MemorySearchResult[] = [];\n\n    for (const p of providers) {\n      if (!p.capabilities.search || !p.search) continue;\n      const started = Date.now();\n      try {\n        const providerResults = await p.search(request);\n        this.trace('search', p.id, request, {\n          resultCount: providerResults.length,\n          selectedRecordIds: providerResults.map((result) => result.record.id),\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        results.push(...providerResults);\n        if (providerResults.length > 0 && this.routing.searchStrategy !== 'fanout') {\n          break;\n        }\n      } catch (err) {\n        this.trace('search', p.id, request, {\n          error: err instanceof Error ? err.message : String(err),\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        log.warn({ err, id: p.id }, 'memory search failed');\n      }\n    }\n\n    const seen = new Set<string>();\n    return results\n      .sort((a, b) => b.score - a.score)\n      .filter((result) => {\n        const key = `${result.citation.providerId}:${result.citation.recordId}`;\n        if (seen.has(key)) return false;\n        seen.add(key);\n        return true;\n      })\n      .slice(0, request.maxResults ?? 5);\n  }\n\n  async read(request: MemoryReadRequest): Promise<MemoryReadResult | null> {\n    for (const p of this.providersForSearch()) {\n      if (!p.capabilities.read || !p.read) continue;\n      const started = Date.now();\n      try {\n        const result = await p.read(request);\n        this.trace('read', p.id, request, {\n          resultCount: result ? 1 : 0,\n          selectedRecordIds: result ? [result.record.id] : [],\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        if (result) return result;\n      } catch (err) {\n        this.trace('read', p.id, request, {\n          error: err instanceof Error ? err.message : String(err),\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        log.warn({ err, id: p.id }, 'memory read failed');\n      }\n    }\n    return null;\n  }\n\n  async get(id: string): Promise<MemoryRecord | null> {\n    for (const p of this.providers) {\n      if (!p.capabilities.read) continue;\n      try {\n        const direct = await p.get?.(id);\n        if (direct) return direct;\n      } catch (err) {\n        log.warn({ err, id: p.id, recordId: id }, 'memory get failed');\n      }\n    }\n    return null;\n  }\n\n  async list(request: MemoryListRequest): Promise<MemoryRecord[]> {\n    const out: MemoryRecord[] = [];\n    for (const p of this.providersForSearch()) {\n      if (!p.capabilities.read || !p.list) continue;\n      try {\n        out.push(...await p.list(request));\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'memory list failed');\n      }\n    }\n    return out;\n  }\n\n  async write(request: MemoryWriteRequest): Promise<MemoryWriteResult> {\n    return this.writeWithStrategy('write', request);\n  }\n\n  async update(request: MemoryUpdateRequest): Promise<MemoryWriteResult> {\n    return this.writeWithStrategy('update', request);\n  }\n\n  async delete(request: MemoryDeleteRequest): Promise<MemoryWriteResult> {\n    return this.writeWithStrategy('delete', request);\n  }\n\n  onMemoryWrite(action: 'add' | 'replace' | 'remove', target: 'memory' | 'user', content: string): void {\n    for (const p of this.providers) {\n      if (p.capabilities.local) {\n        continue;\n      }\n      try {\n        p.sync?.({ type: 'write', action, target, content });\n      } catch (err) {\n        log.debug({ err, id: p.id }, 'memory write sync failed');\n      }\n    }\n  }\n\n  recordSignal(signal: MemorySignal): void {\n    for (const p of this.providers) {\n      const started = Date.now();\n      try {\n        p.sync?.({ type: 'signal', signal });\n        this.trace('sync', p.id, { type: 'signal', signal }, {\n          resultCount: 1,\n          durationMs: Date.now() - started,\n        });\n      } catch (err) {\n        this.trace('sync', p.id, { type: 'signal', signal }, {\n          error: err instanceof Error ? err.message : String(err),\n          durationMs: Date.now() - started,\n        });\n        log.debug({ err, id: p.id, source: signal.source }, 'memory signal sync failed');\n      }\n    }\n  }\n\n  async initializeAll(sessionId: string, options?: MemoryProviderInitOptions): Promise<void> {\n    this.understandingAgentId = options?.agentId;\n    await this.loadPluginProvidersOnce();\n    for (const p of this.providers) {\n      try {\n        await p.initialize(sessionId, options);\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'initialize failed');\n      }\n    }\n  }\n\n  private async loadPluginProvidersOnce(): Promise<void> {\n    if (this.pluginProvidersLoaded || !this.loadProviders) return;\n    this.pluginProvidersLoaded = true;\n    try {\n      const providers = await this.loadProviders();\n      const existingIds = new Set(this.providers.map((p) => p.id));\n      for (const provider of providers) {\n        if (existingIds.has(provider.id)) {\n          log.warn({ id: provider.id }, 'Skipped duplicate memory provider');\n          continue;\n        }\n        this.addProvider(provider);\n        existingIds.add(provider.id);\n      }\n    } catch (err) {\n      log.warn({ err }, 'Memory provider plugin loading failed');\n    }\n  }\n\n  async shutdownAll(): Promise<void> {\n    this.lastTurnSourceItem.clear();\n    for (const p of [...this.providers].reverse()) {\n      try {\n        await p.shutdown();\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'shutdown failed');\n      }\n    }\n  }\n\n  private providersForSearch(): MemoryProvider[] {\n    const locals = this.providers.filter((p) => p.capabilities.local);\n    const externals = this.providers.filter((p) => !p.capabilities.local);\n    switch (this.routing.searchStrategy) {\n      case 'local-only':\n        return locals;\n      case 'external-only':\n        return externals;\n      case 'external-first':\n        return [...externals, ...locals];\n      case 'local-first':\n      case 'fanout':\n      default:\n        return [...locals, ...externals];\n    }\n  }\n\n  private providersForWrite(): MemoryProvider[] {\n    const locals = this.providers.filter((p) => p.capabilities.local);\n    const externals = this.providers.filter((p) => !p.capabilities.local);\n    switch (this.routing.writeStrategy) {\n      case 'local-only':\n        return locals;\n      case 'external-only':\n        return externals;\n      case 'external-first':\n        return [...externals, ...locals];\n      case 'write-through':\n      case 'local-first':\n      default:\n        return [...locals, ...externals];\n    }\n  }\n\n  private async writeWithStrategy(\n    operation: 'write' | 'update' | 'delete',\n    request: MemoryWriteRequest | MemoryUpdateRequest | MemoryDeleteRequest,\n  ): Promise<MemoryWriteResult> {\n    const providers =\n      operation === 'write' && (request as MemoryWriteRequest).status === 'candidate'\n        ? this.providers.filter((provider) => provider.capabilities.local)\n        : this.providersForWrite();\n    const errors: string[] = [];\n    let firstSuccess: MemoryWriteResult | null = null;\n\n    for (const p of providers) {\n      const fn = p[operation];\n      if (!this.providerAllowedForWrite(p, operation, request)) {\n        this.trace(operation, p.id, request, {\n          skippedReason: 'policy',\n          sessionKey: request.scope?.sessionKey,\n        });\n        continue;\n      }\n      const canWrite =\n        (operation === 'write' && p.capabilities.write) ||\n        (operation === 'update' && p.capabilities.update) ||\n        (operation === 'delete' && p.capabilities.delete);\n      if (!canWrite || !fn) continue;\n      const started = Date.now();\n      try {\n        const result = await fn.call(p, request as never);\n        this.trace(operation, p.id, request, {\n          resultCount: result.record ? 1 : 0,\n          selectedRecordIds: result.record ? [result.record.id] : [],\n          error: result.success ? undefined : result.error,\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        if (result.success) {\n          firstSuccess ??= result;\n          if (this.routing.writeStrategy !== 'write-through') {\n            return result;\n          }\n        } else if (result.error) {\n          errors.push(`${p.id}: ${result.error}`);\n        }\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        this.trace(operation, p.id, request, {\n          error: message,\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        errors.push(`${p.id}: ${message}`);\n        log.warn({ err, id: p.id, operation }, 'memory write operation failed');\n      }\n    }\n\n    if (firstSuccess) return firstSuccess;\n    return { success: false, error: errors.join('; ') || `No provider supports memory ${operation}` };\n  }\n\n  private providerAllowedForWrite(\n    provider: MemoryProvider,\n    operation: 'write' | 'update' | 'delete',\n    request: MemoryWriteRequest | MemoryUpdateRequest | MemoryDeleteRequest,\n  ): boolean {\n    if (!provider.capabilities.local && !this.writePolicy.allowExternalWrites) {\n      return false;\n    }\n    if (\n      !provider.capabilities.local &&\n      this.writePolicy.allowedProviderIds &&\n      this.writePolicy.allowedProviderIds.length > 0 &&\n      !this.writePolicy.allowedProviderIds.includes(provider.id)\n    ) {\n      return false;\n    }\n    if (operation === 'write') {\n      const writeRequest = request as MemoryWriteRequest;\n      if (writeRequest.status === 'candidate' && !provider.capabilities.local) {\n        return false;\n      }\n      if (\n        this.writePolicy.autoWriteKinds &&\n        this.writePolicy.autoWriteKinds.length > 0 &&\n        !this.writePolicy.autoWriteKinds.includes(writeRequest.kind)\n      ) {\n        return false;\n      }\n      if (\n        this.writePolicy.requireUserProfileApproval &&\n        writeRequest.kind === 'user_profile' &&\n        !writeRequest.approved\n      ) {\n        return false;\n      }\n    }\n    if (operation === 'update' && this.writePolicy.requireUserProfileApproval) {\n      const updateRequest = request as MemoryUpdateRequest;\n      if (updateRequest.target === 'user' && !updateRequest.approved) {\n        return false;\n      }\n    }\n    return true;\n  }\n\n  private trace(\n    phase: 'search' | 'read' | 'write' | 'update' | 'delete' | 'sync' | 'inject' | 'test',\n    providerId: string,\n    request: unknown,\n    meta: {\n      sessionKey?: string;\n      resultCount?: number;\n      selectedRecordIds?: string[];\n      skippedReason?: string;\n      error?: string;\n      durationMs?: number;\n    } = {},\n  ): void {\n    try {\n      appendMemoryTraceEvent({\n        phase,\n        providerId,\n        request: sanitizeTraceRequest(request),\n        ...meta,\n      });\n    } catch (err) {\n      log.debug({ err, providerId, phase }, 'memory trace append failed');\n    }\n  }\n}\n\nfunction sanitizeTraceRequest(request: unknown): unknown {\n  if (!request || typeof request !== 'object') return request;\n  const copy = { ...(request as Record<string, unknown>) };\n  if (typeof copy.content === 'string' && copy.content.length > 500) {\n    copy.content = `${copy.content.slice(0, 500)}…`;\n  }\n  return copy;\n}\n"],"mappings":";;;;;;;aAGqD;AAoBrD,MAAM,MAAM,aAAa,gBAAgB;AAuBzC,IAAa,gBAAb,MAA2B;CACzB,YAAsC,EAAE;CACxC,iCAAyB,IAAI,KAA6B;CAC1D;CACA;CACA;CAEA,wBAAgC;CAChC;CACA,qCAAsC,IAAI,KAAqB;CAC/D;CAEA,YAAY,UAAgC,EAAE,EAAE;AAC9C,OAAK,UAAU;GACb,gBAAgB,QAAQ,kBAAkB;GAC1C,eAAe,QAAQ,iBAAiB;GACxC,aAAa,QAAQ,eAAe,EAAE;GACvC;AACD,OAAK,gBAAgB,QAAQ;AAC7B,OAAK,cAAc;GACjB,qBAAqB,QAAQ,aAAa,uBAAuB;GACjE,4BAA4B,QAAQ,aAAa,8BAA8B;GAC/E,oBAAoB,QAAQ,aAAa;GACzC,gBAAgB,QAAQ,aAAa;GACtC;AACD,OAAK,gBAAgB,IAAI,yBAAyB;GAChD,QAAQ,YAAY,KAAK,MAAM,QAAQ;GACvC,OAAO,iBAAiB,KAAK,KAAK,EAAE,cAAc,CAAC;GACpD,CAAC;;CAGJ,YAAY,UAAgC;AAC1C,OAAK,UAAU,KAAK,SAAS;AAE7B,OAAK,MAAM,UAAU,SAAS,kBAAkB,IAAI,EAAE,EAAE;GACtD,MAAM,WAAW,OAAO;AACxB,OAAI,CAAC,SACH;AAEF,OAAI,CAAC,KAAK,eAAe,IAAI,SAAS,CACpC,MAAK,eAAe,IAAI,UAAU,SAAS;OAE3C,KAAI,KACF;IAAE;IAAU,UAAU,KAAK,eAAe,IAAI,SAAS,EAAE;IAAI,SAAS,SAAS;IAAI,EACnF,4BACD;;AAIL,MAAI,KACF;GAAE,IAAI,SAAS;GAAI,WAAW,SAAS,kBAAkB,CAAC,UAAU;GAAG,cAAc,SAAS;GAAc,EAC5G,6BACD;;CAGH,IAAI,gBAAkC;AACpC,SAAO,CAAC,GAAG,KAAK,UAAU;;;;;CAM5B,4BAAoC;EAClC,MAAM,SAAmB,EAAE;AAC3B,OAAK,MAAM,KAAK,KAAK,WAAW;AAC9B,OAAI,EAAE,aAAa,MACjB;AAEF,OAAI;IACF,MAAM,QAAQ,EAAE,qBAAqB;AACrC,QAAI,OAAO,MAAM,CACf,QAAO,KAAK,MAAM,MAAM,CAAC;YAEpB,KAAK;AACZ,QAAI,KAAK;KAAE;KAAK,IAAI,EAAE;KAAI,EAAE,2BAA2B;;;AAG3D,SAAO,OAAO,KAAK,OAAO;;CAG5B,iBAAiB,OAAe,SAAwC;AACtE,OAAK,MAAM,KAAK,KAAK,UACnB,KAAI;AACF,KAAE,gBAAgB,OAAO,QAAQ;WAC1B,KAAK;AACZ,OAAI,MAAM;IAAE;IAAK,IAAI,EAAE;IAAI,EAAE,mCAAmC;;;CAKtE,MAAM,QAAQ,aAAqB,kBAA0B,SAAiD;AAC5G,QAAM,KAAK,yBAAyB,aAAa,kBAAkB,QAAQ;AAC3E,QAAM,KAAK,qBAAqB,aAAa,kBAAkB,QAAQ;;CAGzE,MAAM,yBACJ,aACA,kBACA,SACe;EACf,MAAM,SAAS,MAAM,KAAK,cAAc,WAAW;GACjD,SAAS,KAAK;GACd;GACA;GACA,YAAY,SAAS;GACrB,2BAA2B,SAAS;GACrC,CAAC;AACF,MAAI,SAAS,aAAa,OAAO,aAC/B,MAAK,mBAAmB,IAAI,QAAQ,WAAW,OAAO,aAAa;;CAIvE,MAAM,qBACJ,aACA,kBACA,SACe;EACf,MAAM,QAAyB;GAC7B,MAAM;GACN;GACA;GACA,WAAW,SAAS;GACrB;AACD,OAAK,MAAM,KAAK,KAAK,WAAW;GAC9B,MAAM,UAAU,KAAK,KAAK;AAC1B,OAAI;AACF,UAAM,EAAE,OAAO,MAAM;AACrB,SAAK,MAAM,QAAQ,EAAE,IAAI,OAAO;KAC9B,aAAa;KACb,YAAY,KAAK,KAAK,GAAG;KACzB,YAAY,SAAS;KACtB,CAAC;YACK,KAAK;AACZ,SAAK,MAAM,QAAQ,EAAE,IAAI,OAAO;KAC9B,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;KACvD,YAAY,KAAK,KAAK,GAAG;KACzB,YAAY,SAAS;KACtB,CAAC;AACF,QAAI,KAAK;KAAE;KAAK,IAAI,EAAE;KAAI,EAAE,qBAAqB;;;;CAKvD,MAAM,6BACJ,YACA,UAII,EAAE,EACS;EACf,MAAM,eAAe,QAAQ,aACzB,KAAK,mBAAmB,IAAI,QAAQ,WAAW,GAC/C,KAAA;AACJ,QAAM,KAAK,cAAc,gBAAgB,YAAY;GACnD,GAAG;GACH,SAAS,KAAK;GACd;GACD,CAAC;AACF,MAAI,aACF,uCAAsC,CAAC,aAAa,EAAE,YAAY;;CAItE,qBAAkC;EAChC,MAAM,MAAmB,EAAE;EAC3B,MAAM,uBAAO,IAAI,KAAa;AAC9B,OAAK,MAAM,KAAK,KAAK,WAAW;AAC9B,OAAI,EAAE,aAAa,MACjB;AAEF,OAAI;AACF,SAAK,MAAM,KAAK,EAAE,kBAAkB,IAAI,EAAE,CACxC,KAAI,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE;AAC/B,UAAK,IAAI,EAAE,KAAK;AAChB,SAAI,KAAK,EAAE;;YAGR,KAAK;AACZ,QAAI,KAAK;KAAE;KAAK,IAAI,EAAE;KAAI,EAAE,wBAAwB;;;AAGxD,SAAO;;CAGT,MAAM,eAAe,UAAkB,MAAgD;EACrF,MAAM,WAAW,KAAK,eAAe,IAAI,SAAS;AAClD,MAAI,CAAC,SACH,OAAM,IAAI,MAAM,oCAAoC,SAAS,GAAG;AAElE,MAAI,CAAC,SAAS,eACZ,OAAM,IAAI,MAAM,oBAAoB,SAAS,GAAG,8BAA8B;AAEhF,SAAO,SAAS,eAAe,UAAU,KAAK;;CAGhD,MAAM,OAAO,SAA6D;EACxE,MAAM,YAAY,KAAK,oBAAoB;EAC3C,MAAM,UAAgC,EAAE;AAExC,OAAK,MAAM,KAAK,WAAW;AACzB,OAAI,CAAC,EAAE,aAAa,UAAU,CAAC,EAAE,OAAQ;GACzC,MAAM,UAAU,KAAK,KAAK;AAC1B,OAAI;IACF,MAAM,kBAAkB,MAAM,EAAE,OAAO,QAAQ;AAC/C,SAAK,MAAM,UAAU,EAAE,IAAI,SAAS;KAClC,aAAa,gBAAgB;KAC7B,mBAAmB,gBAAgB,KAAK,WAAW,OAAO,OAAO,GAAG;KACpE,YAAY,KAAK,KAAK,GAAG;KACzB,YAAY,QAAQ,OAAO;KAC5B,CAAC;AACF,YAAQ,KAAK,GAAG,gBAAgB;AAChC,QAAI,gBAAgB,SAAS,KAAK,KAAK,QAAQ,mBAAmB,SAChE;YAEK,KAAK;AACZ,SAAK,MAAM,UAAU,EAAE,IAAI,SAAS;KAClC,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;KACvD,YAAY,KAAK,KAAK,GAAG;KACzB,YAAY,QAAQ,OAAO;KAC5B,CAAC;AACF,QAAI,KAAK;KAAE;KAAK,IAAI,EAAE;KAAI,EAAE,uBAAuB;;;EAIvD,MAAM,uBAAO,IAAI,KAAa;AAC9B,SAAO,QACJ,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,CACjC,QAAQ,WAAW;GAClB,MAAM,MAAM,GAAG,OAAO,SAAS,WAAW,GAAG,OAAO,SAAS;AAC7D,OAAI,KAAK,IAAI,IAAI,CAAE,QAAO;AAC1B,QAAK,IAAI,IAAI;AACb,UAAO;IACP,CACD,MAAM,GAAG,QAAQ,cAAc,EAAE;;CAGtC,MAAM,KAAK,SAA8D;AACvE,OAAK,MAAM,KAAK,KAAK,oBAAoB,EAAE;AACzC,OAAI,CAAC,EAAE,aAAa,QAAQ,CAAC,EAAE,KAAM;GACrC,MAAM,UAAU,KAAK,KAAK;AAC1B,OAAI;IACF,MAAM,SAAS,MAAM,EAAE,KAAK,QAAQ;AACpC,SAAK,MAAM,QAAQ,EAAE,IAAI,SAAS;KAChC,aAAa,SAAS,IAAI;KAC1B,mBAAmB,SAAS,CAAC,OAAO,OAAO,GAAG,GAAG,EAAE;KACnD,YAAY,KAAK,KAAK,GAAG;KACzB,YAAY,QAAQ,OAAO;KAC5B,CAAC;AACF,QAAI,OAAQ,QAAO;YACZ,KAAK;AACZ,SAAK,MAAM,QAAQ,EAAE,IAAI,SAAS;KAChC,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;KACvD,YAAY,KAAK,KAAK,GAAG;KACzB,YAAY,QAAQ,OAAO;KAC5B,CAAC;AACF,QAAI,KAAK;KAAE;KAAK,IAAI,EAAE;KAAI,EAAE,qBAAqB;;;AAGrD,SAAO;;CAGT,MAAM,IAAI,IAA0C;AAClD,OAAK,MAAM,KAAK,KAAK,WAAW;AAC9B,OAAI,CAAC,EAAE,aAAa,KAAM;AAC1B,OAAI;IACF,MAAM,SAAS,MAAM,EAAE,MAAM,GAAG;AAChC,QAAI,OAAQ,QAAO;YACZ,KAAK;AACZ,QAAI,KAAK;KAAE;KAAK,IAAI,EAAE;KAAI,UAAU;KAAI,EAAE,oBAAoB;;;AAGlE,SAAO;;CAGT,MAAM,KAAK,SAAqD;EAC9D,MAAM,MAAsB,EAAE;AAC9B,OAAK,MAAM,KAAK,KAAK,oBAAoB,EAAE;AACzC,OAAI,CAAC,EAAE,aAAa,QAAQ,CAAC,EAAE,KAAM;AACrC,OAAI;AACF,QAAI,KAAK,GAAG,MAAM,EAAE,KAAK,QAAQ,CAAC;YAC3B,KAAK;AACZ,QAAI,KAAK;KAAE;KAAK,IAAI,EAAE;KAAI,EAAE,qBAAqB;;;AAGrD,SAAO;;CAGT,MAAM,MAAM,SAAyD;AACnE,SAAO,KAAK,kBAAkB,SAAS,QAAQ;;CAGjD,MAAM,OAAO,SAA0D;AACrE,SAAO,KAAK,kBAAkB,UAAU,QAAQ;;CAGlD,MAAM,OAAO,SAA0D;AACrE,SAAO,KAAK,kBAAkB,UAAU,QAAQ;;CAGlD,cAAc,QAAsC,QAA2B,SAAuB;AACpG,OAAK,MAAM,KAAK,KAAK,WAAW;AAC9B,OAAI,EAAE,aAAa,MACjB;AAEF,OAAI;AACF,MAAE,OAAO;KAAE,MAAM;KAAS;KAAQ;KAAQ;KAAS,CAAC;YAC7C,KAAK;AACZ,QAAI,MAAM;KAAE;KAAK,IAAI,EAAE;KAAI,EAAE,2BAA2B;;;;CAK9D,aAAa,QAA4B;AACvC,OAAK,MAAM,KAAK,KAAK,WAAW;GAC9B,MAAM,UAAU,KAAK,KAAK;AAC1B,OAAI;AACF,MAAE,OAAO;KAAE,MAAM;KAAU;KAAQ,CAAC;AACpC,SAAK,MAAM,QAAQ,EAAE,IAAI;KAAE,MAAM;KAAU;KAAQ,EAAE;KACnD,aAAa;KACb,YAAY,KAAK,KAAK,GAAG;KAC1B,CAAC;YACK,KAAK;AACZ,SAAK,MAAM,QAAQ,EAAE,IAAI;KAAE,MAAM;KAAU;KAAQ,EAAE;KACnD,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;KACvD,YAAY,KAAK,KAAK,GAAG;KAC1B,CAAC;AACF,QAAI,MAAM;KAAE;KAAK,IAAI,EAAE;KAAI,QAAQ,OAAO;KAAQ,EAAE,4BAA4B;;;;CAKtF,MAAM,cAAc,WAAmB,SAAoD;AACzF,OAAK,uBAAuB,SAAS;AACrC,QAAM,KAAK,yBAAyB;AACpC,OAAK,MAAM,KAAK,KAAK,UACnB,KAAI;AACF,SAAM,EAAE,WAAW,WAAW,QAAQ;WAC/B,KAAK;AACZ,OAAI,KAAK;IAAE;IAAK,IAAI,EAAE;IAAI,EAAE,oBAAoB;;;CAKtD,MAAc,0BAAyC;AACrD,MAAI,KAAK,yBAAyB,CAAC,KAAK,cAAe;AACvD,OAAK,wBAAwB;AAC7B,MAAI;GACF,MAAM,YAAY,MAAM,KAAK,eAAe;GAC5C,MAAM,cAAc,IAAI,IAAI,KAAK,UAAU,KAAK,MAAM,EAAE,GAAG,CAAC;AAC5D,QAAK,MAAM,YAAY,WAAW;AAChC,QAAI,YAAY,IAAI,SAAS,GAAG,EAAE;AAChC,SAAI,KAAK,EAAE,IAAI,SAAS,IAAI,EAAE,oCAAoC;AAClE;;AAEF,SAAK,YAAY,SAAS;AAC1B,gBAAY,IAAI,SAAS,GAAG;;WAEvB,KAAK;AACZ,OAAI,KAAK,EAAE,KAAK,EAAE,wCAAwC;;;CAI9D,MAAM,cAA6B;AACjC,OAAK,mBAAmB,OAAO;AAC/B,OAAK,MAAM,KAAK,CAAC,GAAG,KAAK,UAAU,CAAC,SAAS,CAC3C,KAAI;AACF,SAAM,EAAE,UAAU;WACX,KAAK;AACZ,OAAI,KAAK;IAAE;IAAK,IAAI,EAAE;IAAI,EAAE,kBAAkB;;;CAKpD,qBAA+C;EAC7C,MAAM,SAAS,KAAK,UAAU,QAAQ,MAAM,EAAE,aAAa,MAAM;EACjE,MAAM,YAAY,KAAK,UAAU,QAAQ,MAAM,CAAC,EAAE,aAAa,MAAM;AACrE,UAAQ,KAAK,QAAQ,gBAArB;GACE,KAAK,aACH,QAAO;GACT,KAAK,gBACH,QAAO;GACT,KAAK,iBACH,QAAO,CAAC,GAAG,WAAW,GAAG,OAAO;GAGlC,QACE,QAAO,CAAC,GAAG,QAAQ,GAAG,UAAU;;;CAItC,oBAA8C;EAC5C,MAAM,SAAS,KAAK,UAAU,QAAQ,MAAM,EAAE,aAAa,MAAM;EACjE,MAAM,YAAY,KAAK,UAAU,QAAQ,MAAM,CAAC,EAAE,aAAa,MAAM;AACrE,UAAQ,KAAK,QAAQ,eAArB;GACE,KAAK,aACH,QAAO;GACT,KAAK,gBACH,QAAO;GACT,KAAK,iBACH,QAAO,CAAC,GAAG,WAAW,GAAG,OAAO;GAGlC,QACE,QAAO,CAAC,GAAG,QAAQ,GAAG,UAAU;;;CAItC,MAAc,kBACZ,WACA,SAC4B;EAC5B,MAAM,YACJ,cAAc,WAAY,QAA+B,WAAW,cAChE,KAAK,UAAU,QAAQ,aAAa,SAAS,aAAa,MAAM,GAChE,KAAK,mBAAmB;EAC9B,MAAM,SAAmB,EAAE;EAC3B,IAAI,eAAyC;AAE7C,OAAK,MAAM,KAAK,WAAW;GACzB,MAAM,KAAK,EAAE;AACb,OAAI,CAAC,KAAK,wBAAwB,GAAG,WAAW,QAAQ,EAAE;AACxD,SAAK,MAAM,WAAW,EAAE,IAAI,SAAS;KACnC,eAAe;KACf,YAAY,QAAQ,OAAO;KAC5B,CAAC;AACF;;AAMF,OAAI,EAHD,cAAc,WAAW,EAAE,aAAa,SACxC,cAAc,YAAY,EAAE,aAAa,UACzC,cAAc,YAAY,EAAE,aAAa,WAC3B,CAAC,GAAI;GACtB,MAAM,UAAU,KAAK,KAAK;AAC1B,OAAI;IACF,MAAM,SAAS,MAAM,GAAG,KAAK,GAAG,QAAiB;AACjD,SAAK,MAAM,WAAW,EAAE,IAAI,SAAS;KACnC,aAAa,OAAO,SAAS,IAAI;KACjC,mBAAmB,OAAO,SAAS,CAAC,OAAO,OAAO,GAAG,GAAG,EAAE;KAC1D,OAAO,OAAO,UAAU,KAAA,IAAY,OAAO;KAC3C,YAAY,KAAK,KAAK,GAAG;KACzB,YAAY,QAAQ,OAAO;KAC5B,CAAC;AACF,QAAI,OAAO,SAAS;AAClB,sBAAiB;AACjB,SAAI,KAAK,QAAQ,kBAAkB,gBACjC,QAAO;eAEA,OAAO,MAChB,QAAO,KAAK,GAAG,EAAE,GAAG,IAAI,OAAO,QAAQ;YAElC,KAAK;IACZ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAChE,SAAK,MAAM,WAAW,EAAE,IAAI,SAAS;KACnC,OAAO;KACP,YAAY,KAAK,KAAK,GAAG;KACzB,YAAY,QAAQ,OAAO;KAC5B,CAAC;AACF,WAAO,KAAK,GAAG,EAAE,GAAG,IAAI,UAAU;AAClC,QAAI,KAAK;KAAE;KAAK,IAAI,EAAE;KAAI;KAAW,EAAE,gCAAgC;;;AAI3E,MAAI,aAAc,QAAO;AACzB,SAAO;GAAE,SAAS;GAAO,OAAO,OAAO,KAAK,KAAK,IAAI,+BAA+B;GAAa;;CAGnG,wBACE,UACA,WACA,SACS;AACT,MAAI,CAAC,SAAS,aAAa,SAAS,CAAC,KAAK,YAAY,oBACpD,QAAO;AAET,MACE,CAAC,SAAS,aAAa,SACvB,KAAK,YAAY,sBACjB,KAAK,YAAY,mBAAmB,SAAS,KAC7C,CAAC,KAAK,YAAY,mBAAmB,SAAS,SAAS,GAAG,CAE1D,QAAO;AAET,MAAI,cAAc,SAAS;GACzB,MAAM,eAAe;AACrB,OAAI,aAAa,WAAW,eAAe,CAAC,SAAS,aAAa,MAChE,QAAO;AAET,OACE,KAAK,YAAY,kBACjB,KAAK,YAAY,eAAe,SAAS,KACzC,CAAC,KAAK,YAAY,eAAe,SAAS,aAAa,KAAK,CAE5D,QAAO;AAET,OACE,KAAK,YAAY,8BACjB,aAAa,SAAS,kBACtB,CAAC,aAAa,SAEd,QAAO;;AAGX,MAAI,cAAc,YAAY,KAAK,YAAY,4BAA4B;GACzE,MAAM,gBAAgB;AACtB,OAAI,cAAc,WAAW,UAAU,CAAC,cAAc,SACpD,QAAO;;AAGX,SAAO;;CAGT,MACE,OACA,YACA,SACA,OAOI,EAAE,EACA;AACN,MAAI;AACF,0BAAuB;IACrB;IACA;IACA,SAAS,qBAAqB,QAAQ;IACtC,GAAG;IACJ,CAAC;WACK,KAAK;AACZ,OAAI,MAAM;IAAE;IAAK;IAAY;IAAO,EAAE,6BAA6B;;;;AAKzE,SAAS,qBAAqB,SAA2B;AACvD,KAAI,CAAC,WAAW,OAAO,YAAY,SAAU,QAAO;CACpD,MAAM,OAAO,EAAE,GAAI,SAAqC;AACxD,KAAI,OAAO,KAAK,YAAY,YAAY,KAAK,QAAQ,SAAS,IAC5D,MAAK,UAAU,GAAG,KAAK,QAAQ,MAAM,GAAG,IAAI,CAAC;AAE/C,QAAO"}
+{"version":3,"file":"manager.js","names":[],"sources":["../../../../src/agent/memory/manager.ts"],"sourcesContent":["import type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport { appendMemoryTraceEvent, setKnowledgeSourceItemSynthesisStatus } from '../../storage/sqlite/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';\nimport { UserUnderstandingService } from './understanding/service.js';\nimport type { UnderstandingCandidate } from './understanding/types.js';\nimport type { MemoryAccessPolicy } from './access-policy.js';\nimport type {\n  MemoryDeleteRequest,\n  MemoryListRequest,\n  MemoryReadRequest,\n  MemoryReadResult,\n  MemorySearchRequest,\n  MemorySearchResult,\n  MemorySyncEvent,\n  MemoryUpdateRequest,\n  MemoryWriteRequest,\n  MemoryWriteResult,\n  MemoryRecord,\n  MemorySignal,\n  MemoryKind,\n} from './types.js';\n\nconst log = createLogger('MemoryManager');\n\nexport type MemorySearchStrategy = 'local-first' | 'external-first' | 'fanout' | 'local-only' | 'external-only';\nexport type MemoryWriteStrategy = 'local-first' | 'external-first' | 'write-through' | 'local-only' | 'external-only';\n\nexport interface MemoryRoutingOptions {\n  searchStrategy?: MemorySearchStrategy;\n  writeStrategy?: MemoryWriteStrategy;\n  replicateTo?: string[];\n}\n\nexport interface MemoryManagerOptions extends MemoryRoutingOptions {\n  loadProviders?: () => Promise<MemoryProvider[]>;\n  writePolicy?: MemoryWritePolicy;\n  accessPolicy?: MemoryAccessPolicy;\n}\n\nexport interface MemoryWritePolicy {\n  allowExternalWrites?: boolean;\n  allowedProviderIds?: string[];\n  autoWriteKinds?: MemoryKind[];\n  requireUserProfileApproval?: boolean;\n}\n\nexport class MemoryManager {\n  private providers: MemoryProvider[] = [];\n  private toolToProvider = new Map<string, MemoryProvider>();\n  private readonly routing: Required<MemoryRoutingOptions>;\n  private readonly loadProviders?: () => Promise<MemoryProvider[]>;\n  private readonly writePolicy: Required<Pick<MemoryWritePolicy, 'allowExternalWrites' | 'requireUserProfileApproval'>> &\n    Omit<MemoryWritePolicy, 'allowExternalWrites' | 'requireUserProfileApproval'>;\n  private pluginProvidersLoaded = false;\n  private readonly understanding: UserUnderstandingService;\n  private readonly lastTurnSourceItem = new Map<string, string>();\n  private understandingAgentId: string | undefined;\n  private readonly accessPolicy?: MemoryAccessPolicy;\n\n  constructor(options: MemoryManagerOptions = {}) {\n    this.routing = {\n      searchStrategy: options.searchStrategy ?? 'fanout',\n      writeStrategy: options.writeStrategy ?? 'local-first',\n      replicateTo: options.replicateTo ?? [],\n    };\n    this.loadProviders = options.loadProviders;\n    this.accessPolicy = options.accessPolicy;\n    this.writePolicy = {\n      allowExternalWrites: options.writePolicy?.allowExternalWrites ?? false,\n      requireUserProfileApproval: options.writePolicy?.requireUserProfileApproval ?? false,\n      allowedProviderIds: options.writePolicy?.allowedProviderIds,\n      autoWriteKinds: options.writePolicy?.autoWriteKinds,\n    };\n    this.understanding = new UserUnderstandingService({\n      write: (request) => this.write(request),\n      list: (canonicalKey) => this.list({ canonicalKey }),\n    });\n  }\n\n  addProvider(provider: MemoryProvider): void {\n    this.providers.push(provider);\n\n    for (const schema of provider.getToolSchemas?.() ?? []) {\n      const toolName = schema.name;\n      if (!toolName) {\n        continue;\n      }\n      if (!this.toolToProvider.has(toolName)) {\n        this.toolToProvider.set(toolName, provider);\n      } else {\n        log.warn(\n          { toolName, existing: this.toolToProvider.get(toolName)?.id, ignored: provider.id },\n          'Memory tool name conflict',\n        );\n      }\n    }\n\n    log.info(\n      { id: provider.id, toolCount: provider.getToolSchemas?.().length ?? 0, capabilities: provider.capabilities },\n      'Memory provider registered',\n    );\n  }\n\n  get providersList(): MemoryProvider[] {\n    return [...this.providers];\n  }\n\n  /**\n   * Non-builtin static instructions (builtin uses curated snapshot in system prompt builder).\n   */\n  buildExternalSystemPrompt(): string {\n    const blocks: string[] = [];\n    for (const p of this.providers) {\n      if (p.capabilities.local) {\n        continue;\n      }\n      try {\n        const block = p.systemPromptBlock?.();\n        if (block?.trim()) {\n          blocks.push(block.trim());\n        }\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'systemPromptBlock failed');\n      }\n    }\n    return blocks.join('\\n\\n');\n  }\n\n  queuePrefetchAll(query: string, options?: { sessionId?: string }): void {\n    for (const p of this.providers) {\n      try {\n        p.queuePrefetch?.(query, options);\n      } catch (err) {\n        log.debug({ err, id: p.id }, 'queuePrefetch failed (non-fatal)');\n      }\n    }\n  }\n\n  async syncAll(userContent: string, assistantContent: string, options?: { sessionId?: string }): Promise<void> {\n    await this.captureTurnUnderstanding(userContent, assistantContent, options);\n    await this.syncProvidersForTurn(userContent, assistantContent, options);\n  }\n\n  async captureTurnUnderstanding(\n    userContent: string,\n    assistantContent: string,\n    options?: { agentId?: string; sessionId?: string; correctionTargetRecordIds?: string[] },\n  ): Promise<void> {\n    const review = await this.understanding.reviewTurn({\n      agentId: options?.agentId ?? this.understandingAgentId,\n      userContent,\n      assistantContent,\n      sessionKey: options?.sessionId,\n      correctionTargetRecordIds: options?.correctionTargetRecordIds,\n    });\n    if (options?.sessionId && review.sourceItemId) {\n      this.lastTurnSourceItem.set(options.sessionId, review.sourceItemId);\n    }\n  }\n\n  async syncProvidersForTurn(\n    userContent: string,\n    assistantContent: string,\n    options?: { sessionId?: string },\n  ): Promise<void> {\n    const event: MemorySyncEvent = {\n      type: 'turn',\n      userContent,\n      assistantContent,\n      sessionId: options?.sessionId,\n    };\n    for (const p of this.providers) {\n      const started = Date.now();\n      try {\n        await p.sync?.(event);\n        this.trace('sync', p.id, event, {\n          resultCount: 1,\n          durationMs: Date.now() - started,\n          sessionKey: options?.sessionId,\n        });\n      } catch (err) {\n        this.trace('sync', p.id, event, {\n          error: err instanceof Error ? err.message : String(err),\n          durationMs: Date.now() - started,\n          sessionKey: options?.sessionId,\n        });\n        log.warn({ err, id: p.id }, 'memory sync failed');\n      }\n    }\n  }\n\n  async applyUnderstandingCandidates(\n    candidates: UnderstandingCandidate[],\n    context: {\n      agentId?: string;\n      sessionKey?: string;\n      sourceText?: string;\n      reviewSource?: 'turn' | 'background';\n    } = {},\n  ): Promise<void> {\n    const sourceItemId = context.sessionKey\n      ? this.lastTurnSourceItem.get(context.sessionKey)\n      : undefined;\n    await this.understanding.applyCandidates(candidates, {\n      ...context,\n      agentId: context.agentId ?? this.understandingAgentId,\n      sourceItemId,\n    });\n    if (sourceItemId) {\n      setKnowledgeSourceItemSynthesisStatus([sourceItemId], 'completed');\n    }\n  }\n\n  getAdditionalTools(): AgentTool[] {\n    const out: AgentTool[] = [];\n    const seen = new Set<string>();\n    for (const p of this.providers) {\n      if (p.capabilities.local) {\n        continue;\n      }\n      try {\n        for (const t of p.getToolSchemas?.() ?? []) {\n          if (t.name && !seen.has(t.name)) {\n            seen.add(t.name);\n            out.push(t);\n          }\n        }\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'getToolSchemas failed');\n      }\n    }\n    return out;\n  }\n\n  async handleToolCall(toolName: string, args: Record<string, unknown>): Promise<string> {\n    const provider = this.toolToProvider.get(toolName);\n    if (!provider) {\n      throw new Error(`No memory provider handles tool '${toolName}'`);\n    }\n    if (!provider.handleToolCall) {\n      throw new Error(`Memory provider '${provider.id}' does not handle tool calls`);\n    }\n    return provider.handleToolCall(toolName, args);\n  }\n\n  async search(request: MemorySearchRequest): Promise<MemorySearchResult[]> {\n    const providers = this.providersForSearch();\n    const results: MemorySearchResult[] = [];\n\n    for (const p of providers) {\n      if (!p.capabilities.search || !p.search) continue;\n      const started = Date.now();\n      try {\n        const providerResults = await p.search(request);\n        this.trace('search', p.id, request, {\n          resultCount: providerResults.length,\n          selectedRecordIds: providerResults.map((result) => result.record.id),\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        results.push(...providerResults);\n        if (providerResults.length > 0 && this.routing.searchStrategy !== 'fanout') {\n          break;\n        }\n      } catch (err) {\n        this.trace('search', p.id, request, {\n          error: err instanceof Error ? err.message : String(err),\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        log.warn({ err, id: p.id }, 'memory search failed');\n      }\n    }\n\n    const seen = new Set<string>();\n    return results\n      .sort((a, b) => b.score - a.score)\n      .filter((result) => this.canReadRecord(result.record, request.scope))\n      .filter((result) => {\n        const key = `${result.citation.providerId}:${result.citation.recordId}`;\n        if (seen.has(key)) return false;\n        seen.add(key);\n        return true;\n      })\n      .slice(0, request.maxResults ?? 5);\n  }\n\n  async read(request: MemoryReadRequest): Promise<MemoryReadResult | null> {\n    for (const p of this.providersForSearch()) {\n      if (!p.capabilities.read || !p.read) continue;\n      const started = Date.now();\n      try {\n        const result = await p.read(request);\n        this.trace('read', p.id, request, {\n          resultCount: result ? 1 : 0,\n          selectedRecordIds: result ? [result.record.id] : [],\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        if (result && this.canReadRecord(result.record, request.scope)) return result;\n      } catch (err) {\n        this.trace('read', p.id, request, {\n          error: err instanceof Error ? err.message : String(err),\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        log.warn({ err, id: p.id }, 'memory read failed');\n      }\n    }\n    return null;\n  }\n\n  async get(id: string): Promise<MemoryRecord | null> {\n    for (const p of this.providers) {\n      if (!p.capabilities.read) continue;\n      try {\n        const direct = await p.get?.(id);\n        if (direct && this.canReadRecord(direct)) return direct;\n      } catch (err) {\n        log.warn({ err, id: p.id, recordId: id }, 'memory get failed');\n      }\n    }\n    return null;\n  }\n\n  async list(request: MemoryListRequest): Promise<MemoryRecord[]> {\n    const out: MemoryRecord[] = [];\n    for (const p of this.providersForSearch()) {\n      if (!p.capabilities.read || !p.list) continue;\n      try {\n        out.push(...(await p.list(request)).filter((record) => this.canReadRecord(record, request.scope)));\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'memory list failed');\n      }\n    }\n    return out;\n  }\n\n  async write(request: MemoryWriteRequest): Promise<MemoryWriteResult> {\n    const denied = this.crossAgentWriteDenied('write', request);\n    if (denied) return denied;\n    return this.writeWithStrategy('write', request);\n  }\n\n  async update(request: MemoryUpdateRequest): Promise<MemoryWriteResult> {\n    const denied = this.crossAgentWriteDenied('update', request);\n    if (denied) return denied;\n    return this.writeWithStrategy('update', request);\n  }\n\n  async delete(request: MemoryDeleteRequest): Promise<MemoryWriteResult> {\n    const denied = this.crossAgentWriteDenied('delete', request);\n    if (denied) return denied;\n    return this.writeWithStrategy('delete', request);\n  }\n\n  private canReadRecord(record: MemoryRecord, scope?: MemorySearchRequest['scope']): boolean {\n    return this.accessPolicy?.canReadRecord(record, scope) ?? true;\n  }\n\n  private crossAgentWriteDenied(\n    action: 'write' | 'update' | 'delete',\n    request: MemoryWriteRequest | MemoryUpdateRequest | MemoryDeleteRequest,\n  ): MemoryWriteResult | null {\n    if (!this.accessPolicy) return null;\n    const ownerAgentId = request.scope?.agentId ?? this.accessPolicy.requesterAgentId;\n    if (ownerAgentId === this.accessPolicy.requesterAgentId) return null;\n    if (action !== 'write' || !('status' in request) || request.status !== 'candidate') {\n      return { success: false, error: 'Cross-agent changes must be submitted as memory candidates' };\n    }\n    if (!this.accessPolicy.canSubmitCandidate(ownerAgentId)) {\n      return { success: false, error: 'Cross-agent candidate submission is not allowed' };\n    }\n    return null;\n  }\n\n  onMemoryWrite(action: 'add' | 'replace' | 'remove', target: 'memory' | 'user', content: string): void {\n    for (const p of this.providers) {\n      if (p.capabilities.local) {\n        continue;\n      }\n      try {\n        p.sync?.({ type: 'write', action, target, content });\n      } catch (err) {\n        log.debug({ err, id: p.id }, 'memory write sync failed');\n      }\n    }\n  }\n\n  recordSignal(signal: MemorySignal): void {\n    for (const p of this.providers) {\n      const started = Date.now();\n      try {\n        p.sync?.({ type: 'signal', signal });\n        this.trace('sync', p.id, { type: 'signal', signal }, {\n          resultCount: 1,\n          durationMs: Date.now() - started,\n        });\n      } catch (err) {\n        this.trace('sync', p.id, { type: 'signal', signal }, {\n          error: err instanceof Error ? err.message : String(err),\n          durationMs: Date.now() - started,\n        });\n        log.debug({ err, id: p.id, source: signal.source }, 'memory signal sync failed');\n      }\n    }\n  }\n\n  async initializeAll(sessionId: string, options?: MemoryProviderInitOptions): Promise<void> {\n    this.understandingAgentId = options?.agentId;\n    await this.loadPluginProvidersOnce();\n    for (const p of this.providers) {\n      try {\n        await p.initialize(sessionId, options);\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'initialize failed');\n      }\n    }\n  }\n\n  private async loadPluginProvidersOnce(): Promise<void> {\n    if (this.pluginProvidersLoaded || !this.loadProviders) return;\n    this.pluginProvidersLoaded = true;\n    try {\n      const providers = await this.loadProviders();\n      const existingIds = new Set(this.providers.map((p) => p.id));\n      for (const provider of providers) {\n        if (existingIds.has(provider.id)) {\n          log.warn({ id: provider.id }, 'Skipped duplicate memory provider');\n          continue;\n        }\n        this.addProvider(provider);\n        existingIds.add(provider.id);\n      }\n    } catch (err) {\n      log.warn({ err }, 'Memory provider plugin loading failed');\n    }\n  }\n\n  async shutdownAll(): Promise<void> {\n    this.lastTurnSourceItem.clear();\n    for (const p of [...this.providers].reverse()) {\n      try {\n        await p.shutdown();\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'shutdown failed');\n      }\n    }\n  }\n\n  private providersForSearch(): MemoryProvider[] {\n    const locals = this.providers.filter((p) => p.capabilities.local);\n    const externals = this.providers.filter((p) => !p.capabilities.local);\n    switch (this.routing.searchStrategy) {\n      case 'local-only':\n        return locals;\n      case 'external-only':\n        return externals;\n      case 'external-first':\n        return [...externals, ...locals];\n      case 'local-first':\n      case 'fanout':\n      default:\n        return [...locals, ...externals];\n    }\n  }\n\n  private providersForWrite(): MemoryProvider[] {\n    const locals = this.providers.filter((p) => p.capabilities.local);\n    const externals = this.providers.filter((p) => !p.capabilities.local);\n    switch (this.routing.writeStrategy) {\n      case 'local-only':\n        return locals;\n      case 'external-only':\n        return externals;\n      case 'external-first':\n        return [...externals, ...locals];\n      case 'write-through':\n      case 'local-first':\n      default:\n        return [...locals, ...externals];\n    }\n  }\n\n  private async writeWithStrategy(\n    operation: 'write' | 'update' | 'delete',\n    request: MemoryWriteRequest | MemoryUpdateRequest | MemoryDeleteRequest,\n  ): Promise<MemoryWriteResult> {\n    const providers =\n      operation === 'write' && (request as MemoryWriteRequest).status === 'candidate'\n        ? this.providers.filter((provider) => provider.capabilities.local)\n        : this.providersForWrite();\n    const errors: string[] = [];\n    let firstSuccess: MemoryWriteResult | null = null;\n\n    for (const p of providers) {\n      const fn = p[operation];\n      if (!this.providerAllowedForWrite(p, operation, request)) {\n        this.trace(operation, p.id, request, {\n          skippedReason: 'policy',\n          sessionKey: request.scope?.sessionKey,\n        });\n        continue;\n      }\n      const canWrite =\n        (operation === 'write' && p.capabilities.write) ||\n        (operation === 'update' && p.capabilities.update) ||\n        (operation === 'delete' && p.capabilities.delete);\n      if (!canWrite || !fn) continue;\n      const started = Date.now();\n      try {\n        const result = await fn.call(p, request as never);\n        this.trace(operation, p.id, request, {\n          resultCount: result.record ? 1 : 0,\n          selectedRecordIds: result.record ? [result.record.id] : [],\n          error: result.success ? undefined : result.error,\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        if (result.success) {\n          firstSuccess ??= result;\n          if (this.routing.writeStrategy !== 'write-through') {\n            return result;\n          }\n        } else if (result.error) {\n          errors.push(`${p.id}: ${result.error}`);\n        }\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        this.trace(operation, p.id, request, {\n          error: message,\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        errors.push(`${p.id}: ${message}`);\n        log.warn({ err, id: p.id, operation }, 'memory write operation failed');\n      }\n    }\n\n    if (firstSuccess) return firstSuccess;\n    return { success: false, error: errors.join('; ') || `No provider supports memory ${operation}` };\n  }\n\n  private providerAllowedForWrite(\n    provider: MemoryProvider,\n    operation: 'write' | 'update' | 'delete',\n    request: MemoryWriteRequest | MemoryUpdateRequest | MemoryDeleteRequest,\n  ): boolean {\n    if (!provider.capabilities.local && !this.writePolicy.allowExternalWrites) {\n      return false;\n    }\n    if (\n      !provider.capabilities.local &&\n      this.writePolicy.allowedProviderIds &&\n      this.writePolicy.allowedProviderIds.length > 0 &&\n      !this.writePolicy.allowedProviderIds.includes(provider.id)\n    ) {\n      return false;\n    }\n    if (operation === 'write') {\n      const writeRequest = request as MemoryWriteRequest;\n      if (writeRequest.status === 'candidate' && !provider.capabilities.local) {\n        return false;\n      }\n      if (\n        this.writePolicy.autoWriteKinds &&\n        this.writePolicy.autoWriteKinds.length > 0 &&\n        !this.writePolicy.autoWriteKinds.includes(writeRequest.kind)\n      ) {\n        return false;\n      }\n      if (\n        this.writePolicy.requireUserProfileApproval &&\n        writeRequest.kind === 'user_profile' &&\n        !writeRequest.approved\n      ) {\n        return false;\n      }\n    }\n    if (operation === 'update' && this.writePolicy.requireUserProfileApproval) {\n      const updateRequest = request as MemoryUpdateRequest;\n      if (updateRequest.target === 'user' && !updateRequest.approved) {\n        return false;\n      }\n    }\n    return true;\n  }\n\n  private trace(\n    phase: 'search' | 'read' | 'write' | 'update' | 'delete' | 'sync' | 'inject' | 'test',\n    providerId: string,\n    request: unknown,\n    meta: {\n      sessionKey?: string;\n      resultCount?: number;\n      selectedRecordIds?: string[];\n      skippedReason?: string;\n      error?: string;\n      durationMs?: number;\n    } = {},\n  ): void {\n    try {\n      appendMemoryTraceEvent({\n        phase,\n        providerId,\n        request: sanitizeTraceRequest(request),\n        ...meta,\n      });\n    } catch (err) {\n      log.debug({ err, providerId, phase }, 'memory trace append failed');\n    }\n  }\n}\n\nfunction sanitizeTraceRequest(request: unknown): unknown {\n  if (!request || typeof request !== 'object') return request;\n  const copy = { ...(request as Record<string, unknown>) };\n  if (typeof copy.content === 'string' && copy.content.length > 500) {\n    copy.content = `${copy.content.slice(0, 500)}…`;\n  }\n  return copy;\n}\n"],"mappings":"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"}

package/dist/src/agent/memory/memory-config.d.ts

@@ -4,7 +4,7 @@ import type { MemoryStoreConfig } from './types.js';
 export declare function isMemorySubsystemEnabled(config: Config | undefined): boolean;
 /** Curated memory tool + agent-home `memories/` store (not injected into system prompt). */
 export declare function isCuratedMemoryInPrompt(config: Config | undefined): boolean;
-export declare function resolveBuiltinMemoryStoreConfig(workspaceDir: string, config: Config | undefined): MemoryStoreConfig;
+export declare function resolveBuiltinMemoryStoreConfig(workspaceDir: string, config: Config | undefined, requestedAgentId?: string): MemoryStoreConfig;
 /**
  * Whether to prefix the user message with prefetched external memory this turn.
  * `first-turn` only injects on turn 1. `contextCadence` N injects on turns 1, N+1, 2N+1, …

package/dist/src/agent/memory/memory-config.js

@@ -15,14 +15,14 @@ function isCuratedMemoryInPrompt(config) {
 	if (!config) return true;
 	return config.agents.list.some((agent) => agent.enabled !== false && agent.memory.sources.includes("curated"));
 }
-function resolveBuiltinMemoryStoreConfig(workspaceDir, config) {
-	const agentId = config != null ? resolveAgentIdForWorkspacePath(config, workspaceDir) : void 0;
+function resolveBuiltinMemoryStoreConfig(workspaceDir, config, requestedAgentId) {
+	const agentId = config != null ? requestedAgentId?.trim() || resolveAgentIdForWorkspacePath(config, workspaceDir) : void 0;
 	const manifest = config && agentId ? resolveEffectiveAgentManifestForAgent(config, agentId) : void 0;
 	return {
 		workspaceDir,
 		memoriesDir: config != null ? join(resolveAgentHomeDir(config, agentId ?? "main"), "memories") : join(workspaceDir, "memories"),
 		userMemoryPath: config != null ? resolveUserMemoryPath() : join(workspaceDir, "user", "MEMORY.md"),
-		memoryCharLimit: manifest?.memory.retention?.maxItems ?? 2200,
+		memoryCharLimit: manifest?.memory.retention?.maxChars ?? 2200,
 		userCharLimit: 1375,
 		userProfileEnabled: manifest?.memory.sources.includes("userProfile") ?? true
 	};

package/dist/src/agent/memory/memory-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-config.js","names":[],"sources":["../../../../src/agent/memory/memory-config.ts"],"sourcesContent":["import { join } from 'node:path';\n\nimport type { Config } from '../../config/schema.js';\nimport { resolveUserMemoryPath } from '../../config/paths.js';\nimport { resolveEffectiveAgentManifestForAgent } from '../../config/agent-profile.js';\nimport { resolveAgentHomeDir, resolveAgentIdForWorkspacePath } from '../agent-scope.js';\n\nimport type { MemoryStoreConfig } from './types.js';\n\n/** When false, curated `memories/` (under agent home) + external memory providers are off. */\nexport function isMemorySubsystemEnabled(config: Config | undefined): boolean {\n  if (!config) return true;\n  return config.agents.list.some((agent) => agent.enabled !== false && agent.memory.mode !== 'off');\n}\n\n/** Curated memory tool + agent-home `memories/` store (not injected into system prompt). */\nexport function isCuratedMemoryInPrompt(config: Config | undefined): boolean {\n  if (!config) return true;\n  return config.agents.list.some((agent) => agent.enabled !== false && agent.memory.sources.includes('curated'));\n}\n\nexport function resolveBuiltinMemoryStoreConfig(\n  workspaceDir: string,\n  config: Config | undefined,\n): MemoryStoreConfig {\n  const agentId = config != null ? resolveAgentIdForWorkspacePath(config, workspaceDir) : undefined;\n  const manifest = config && agentId ? resolveEffectiveAgentManifestForAgent(config, agentId) : undefined;\n  const memoriesDir =\n    config != null\n      ? join(\n          resolveAgentHomeDir(config, agentId ?? 'main'),\n          'memories',\n        )\n      : join(workspaceDir, 'memories');\n  return {\n    workspaceDir,\n    memoriesDir,\n    userMemoryPath: config != null ? resolveUserMemoryPath() : join(workspaceDir, 'user', 'MEMORY.md'),\n    memoryCharLimit: manifest?.memory.retention?.maxItems ?? 2200,\n    userCharLimit: 1375,\n    userProfileEnabled: manifest?.memory.sources.includes('userProfile') ?? true,\n  };\n}\n\n/**\n * Whether to prefix the user message with prefetched external memory this turn.\n * `first-turn` only injects on turn 1. `contextCadence` N injects on turns 1, N+1, 2N+1, …\n */\nexport function shouldPlanUserContextThisTurn(\n  _config: Config | undefined,\n  turnNumber: number,\n): boolean {\n  return turnNumber >= 1;\n}\n\nexport function shouldRegisterCuratedMemoryTool(config: Config | undefined): boolean {\n  return isCuratedMemoryInPrompt(config);\n}\n"],"mappings":";;;;;YAG8D;kBAE0B;;AAKxF,SAAgB,yBAAyB,QAAqC;AAC5E,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO,OAAO,OAAO,KAAK,MAAM,UAAU,MAAM,YAAY,SAAS,MAAM,OAAO,SAAS,MAAM;;;AAInG,SAAgB,wBAAwB,QAAqC;AAC3E,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO,OAAO,OAAO,KAAK,MAAM,UAAU,MAAM,YAAY,SAAS,MAAM,OAAO,QAAQ,SAAS,UAAU,CAAC;;AAGhH,SAAgB,gCACd,cACA,QACmB;CACnB,MAAM,UAAU,UAAU,OAAO,+BAA+B,QAAQ,aAAa,GAAG,KAAA;CACxF,MAAM,WAAW,UAAU,UAAU,sCAAsC,QAAQ,QAAQ,GAAG,KAAA;AAQ9F,QAAO;EACL;EACA,aARA,UAAU,OACN,KACE,oBAAoB,QAAQ,WAAW,OAAO,EAC9C,WACD,GACD,KAAK,cAAc,WAAW;EAIlC,gBAAgB,UAAU,OAAO,uBAAuB,GAAG,KAAK,cAAc,QAAQ,YAAY;EAClG,iBAAiB,UAAU,OAAO,WAAW,YAAY;EACzD,eAAe;EACf,oBAAoB,UAAU,OAAO,QAAQ,SAAS,cAAc,IAAI;EACzE;;;;;;AAOH,SAAgB,8BACd,SACA,YACS;AACT,QAAO,cAAc;;AAGvB,SAAgB,gCAAgC,QAAqC;AACnF,QAAO,wBAAwB,OAAO"}
+{"version":3,"file":"memory-config.js","names":[],"sources":["../../../../src/agent/memory/memory-config.ts"],"sourcesContent":["import { join } from 'node:path';\n\nimport type { Config } from '../../config/schema.js';\nimport { resolveUserMemoryPath } from '../../config/paths.js';\nimport { resolveEffectiveAgentManifestForAgent } from '../../config/agent-profile.js';\nimport { resolveAgentHomeDir, resolveAgentIdForWorkspacePath } from '../agent-scope.js';\n\nimport type { MemoryStoreConfig } from './types.js';\n\n/** When false, curated `memories/` (under agent home) + external memory providers are off. */\nexport function isMemorySubsystemEnabled(config: Config | undefined): boolean {\n  if (!config) return true;\n  return config.agents.list.some((agent) => agent.enabled !== false && agent.memory.mode !== 'off');\n}\n\n/** Curated memory tool + agent-home `memories/` store (not injected into system prompt). */\nexport function isCuratedMemoryInPrompt(config: Config | undefined): boolean {\n  if (!config) return true;\n  return config.agents.list.some((agent) => agent.enabled !== false && agent.memory.sources.includes('curated'));\n}\n\nexport function resolveBuiltinMemoryStoreConfig(\n  workspaceDir: string,\n  config: Config | undefined,\n  requestedAgentId?: string,\n): MemoryStoreConfig {\n  const agentId = config != null\n    ? requestedAgentId?.trim() || resolveAgentIdForWorkspacePath(config, workspaceDir)\n    : undefined;\n  const manifest = config && agentId ? resolveEffectiveAgentManifestForAgent(config, agentId) : undefined;\n  const memoriesDir =\n    config != null\n      ? join(\n          resolveAgentHomeDir(config, agentId ?? 'main'),\n          'memories',\n        )\n      : join(workspaceDir, 'memories');\n  return {\n    workspaceDir,\n    memoriesDir,\n    userMemoryPath: config != null ? resolveUserMemoryPath() : join(workspaceDir, 'user', 'MEMORY.md'),\n    memoryCharLimit: manifest?.memory.retention?.maxChars ?? 2200,\n    userCharLimit: 1375,\n    userProfileEnabled: manifest?.memory.sources.includes('userProfile') ?? true,\n  };\n}\n\n/**\n * Whether to prefix the user message with prefetched external memory this turn.\n * `first-turn` only injects on turn 1. `contextCadence` N injects on turns 1, N+1, 2N+1, …\n */\nexport function shouldPlanUserContextThisTurn(\n  _config: Config | undefined,\n  turnNumber: number,\n): boolean {\n  return turnNumber >= 1;\n}\n\nexport function shouldRegisterCuratedMemoryTool(config: Config | undefined): boolean {\n  return isCuratedMemoryInPrompt(config);\n}\n"],"mappings":";;;;;YAG8D;kBAE0B;;AAKxF,SAAgB,yBAAyB,QAAqC;AAC5E,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO,OAAO,OAAO,KAAK,MAAM,UAAU,MAAM,YAAY,SAAS,MAAM,OAAO,SAAS,MAAM;;;AAInG,SAAgB,wBAAwB,QAAqC;AAC3E,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO,OAAO,OAAO,KAAK,MAAM,UAAU,MAAM,YAAY,SAAS,MAAM,OAAO,QAAQ,SAAS,UAAU,CAAC;;AAGhH,SAAgB,gCACd,cACA,QACA,kBACmB;CACnB,MAAM,UAAU,UAAU,OACtB,kBAAkB,MAAM,IAAI,+BAA+B,QAAQ,aAAa,GAChF,KAAA;CACJ,MAAM,WAAW,UAAU,UAAU,sCAAsC,QAAQ,QAAQ,GAAG,KAAA;AAQ9F,QAAO;EACL;EACA,aARA,UAAU,OACN,KACE,oBAAoB,QAAQ,WAAW,OAAO,EAC9C,WACD,GACD,KAAK,cAAc,WAAW;EAIlC,gBAAgB,UAAU,OAAO,uBAAuB,GAAG,KAAK,cAAc,QAAQ,YAAY;EAClG,iBAAiB,UAAU,OAAO,WAAW,YAAY;EACzD,eAAe;EACf,oBAAoB,UAAU,OAAO,QAAQ,SAAS,cAAc,IAAI;EACzE;;;;;;AAOH,SAAgB,8BACd,SACA,YACS;AACT,QAAO,cAAc;;AAGvB,SAAgB,gCAAgC,QAAqC;AACnF,QAAO,wBAAwB,OAAO"}

package/dist/src/agent/memory/sensitivity.d.ts

@@ -0,0 +1,3 @@
+import type { MemorySensitivity } from './types.js';
+export declare function inferMemorySensitivity(content: string): MemorySensitivity;
+export declare function redactSensitiveMemoryText(content: string): string;

package/dist/src/agent/memory/sensitivity.js

@@ -0,0 +1,13 @@
+//#region src/agent/memory/sensitivity.ts
+function inferMemorySensitivity(content) {
+	if (/\b(api[_-]?key|access[_-]?key|token|password|secret|credential|private[_-]?key|bearer)\b/i.test(content) || /密钥|密码|令牌|私钥/.test(content) || /\b(?:sk|gh[opsu]|xox[abprs])-[a-z0-9_-]{8,}\b/i.test(content) || /\bAKIA[A-Z0-9]{12,}\b/.test(content) || /-----BEGIN [A-Z ]*PRIVATE KEY-----/.test(content)) return "secret";
+	if (/\b(ssn|social security|bank account|credit card|medical record)\b/i.test(content) || /身份证|银行卡|信用卡|医疗记录/.test(content)) return "regulated";
+	return /家庭|住址|生日|健康|关系|family|address|birthday|health/i.test(content) ? "personal" : "normal";
+}
+function redactSensitiveMemoryText(content) {
+	return content.replace(/-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g, "[REDACTED PRIVATE KEY]").replace(/\b(api[_-]?key|access[_-]?key|token|password|secret|credential|private[_-]?key|bearer)\b\s*[:=]?\s*[^\s,;]+/gi, "$1=[REDACTED]").replace(/(密钥|密码|令牌|私钥)\s*[：:=]?\s*[^\s，；]+/g, "$1=[REDACTED]").replace(/\b(?:sk|gh[opsu]|xox[abprs])-[a-z0-9_-]{8,}\b/gi, "[REDACTED TOKEN]").replace(/\bAKIA[A-Z0-9]{12,}\b/g, "[REDACTED ACCESS KEY]");
+}
+//#endregion
+export { inferMemorySensitivity, redactSensitiveMemoryText };
+
+//# sourceMappingURL=sensitivity.js.map

package/dist/src/agent/memory/sensitivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensitivity.js","names":[],"sources":["../../../../src/agent/memory/sensitivity.ts"],"sourcesContent":["import type { MemorySensitivity } from './types.js';\n\nexport function inferMemorySensitivity(content: string): MemorySensitivity {\n  if (\n    /\\b(api[_-]?key|access[_-]?key|token|password|secret|credential|private[_-]?key|bearer)\\b/i.test(content)\n    || /密钥|密码|令牌|私钥/.test(content)\n    || /\\b(?:sk|gh[opsu]|xox[abprs])-[a-z0-9_-]{8,}\\b/i.test(content)\n    || /\\bAKIA[A-Z0-9]{12,}\\b/.test(content)\n    || /-----BEGIN [A-Z ]*PRIVATE KEY-----/.test(content)\n  ) return 'secret';\n  if (\n    /\\b(ssn|social security|bank account|credit card|medical record)\\b/i.test(content)\n    || /身份证|银行卡|信用卡|医疗记录/.test(content)\n  ) return 'regulated';\n  return /家庭|住址|生日|健康|关系|family|address|birthday|health/i.test(content)\n    ? 'personal'\n    : 'normal';\n}\n\nexport function redactSensitiveMemoryText(content: string): string {\n  return content\n    .replace(/-----BEGIN [A-Z ]*PRIVATE KEY-----[\\s\\S]*?-----END [A-Z ]*PRIVATE KEY-----/g, '[REDACTED PRIVATE KEY]')\n    .replace(/\\b(api[_-]?key|access[_-]?key|token|password|secret|credential|private[_-]?key|bearer)\\b\\s*[:=]?\\s*[^\\s,;]+/gi, '$1=[REDACTED]')\n    .replace(/(密钥|密码|令牌|私钥)\\s*[：:=]?\\s*[^\\s，；]+/g, '$1=[REDACTED]')\n    .replace(/\\b(?:sk|gh[opsu]|xox[abprs])-[a-z0-9_-]{8,}\\b/gi, '[REDACTED TOKEN]')\n    .replace(/\\bAKIA[A-Z0-9]{12,}\\b/g, '[REDACTED ACCESS KEY]');\n}\n"],"mappings":";AAEA,SAAgB,uBAAuB,SAAoC;AACzE,KACE,4FAA4F,KAAK,QAAQ,IACtG,cAAc,KAAK,QAAQ,IAC3B,iDAAiD,KAAK,QAAQ,IAC9D,wBAAwB,KAAK,QAAQ,IACrC,qCAAqC,KAAK,QAAQ,CACrD,QAAO;AACT,KACE,qEAAqE,KAAK,QAAQ,IAC/E,mBAAmB,KAAK,QAAQ,CACnC,QAAO;AACT,QAAO,iDAAiD,KAAK,QAAQ,GACjE,aACA;;AAGN,SAAgB,0BAA0B,SAAyB;AACjE,QAAO,QACJ,QAAQ,+EAA+E,yBAAyB,CAChH,QAAQ,iHAAiH,gBAAgB,CACzI,QAAQ,sCAAsC,gBAAgB,CAC9D,QAAQ,mDAAmD,mBAAmB,CAC9E,QAAQ,0BAA0B,wBAAwB"}

package/dist/src/agent/memory/understanding/service.js

@@ -4,6 +4,7 @@ import { appendMemoryTraceEvent } from "../../../storage/sqlite/memory-records-r
 import { attachMemoryEvidence, upsertKnowledgeSourceItems } from "../../../storage/sqlite/knowledge-repository.js";
 import "../../../storage/sqlite/index.js";
 import { extractExplicitUnderstandingCorrectionContent } from "./correction.js";
+import { inferMemorySensitivity, redactSensitiveMemoryText } from "../sensitivity.js";
 import { createHash } from "node:crypto";
 //#region src/agent/memory/understanding/service.ts
 init_logger();
@@ -28,14 +29,6 @@ function inferKind(content) {
 	if (/\b(next time|lesson|failed|error)\b/i.test(content) || /下次|教训|失败|错误/.test(content)) return "task_lesson";
 	return "agent_note";
 }
-function inferSensitivity(content) {
-	if (/\b(api[_-]?key|access[_-]?key|token|password|secret|credential|private[_-]?key|bearer)\b/i.test(content) || /密钥|密码|令牌|私钥/.test(content) || /\b(?:sk|gh[opsu]|xox[abprs])-[a-z0-9_-]{8,}\b/i.test(content) || /\bAKIA[A-Z0-9]{12,}\b/.test(content) || /-----BEGIN [A-Z ]*PRIVATE KEY-----/.test(content)) return "secret";
-	if (/\b(ssn|social security|bank account|credit card|medical record)\b/i.test(content) || /身份证|银行卡|信用卡|医疗记录/.test(content)) return "regulated";
-	return /家庭|住址|生日|健康|关系|family|address|birthday|health/i.test(content) ? "personal" : "normal";
-}
-function redactSensitiveText(content) {
-	return content.replace(/-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g, "[REDACTED PRIVATE KEY]").replace(/\b(api[_-]?key|access[_-]?key|token|password|secret|credential|private[_-]?key|bearer)\b\s*[:=]?\s*[^\s,;]+/gi, "$1=[REDACTED]").replace(/(密钥|密码|令牌|私钥)\s*[：:=]?\s*[^\s，；]+/g, "$1=[REDACTED]").replace(/\b(?:sk|gh[opsu]|xox[abprs])-[a-z0-9_-]{8,}\b/gi, "[REDACTED TOKEN]").replace(/\bAKIA[A-Z0-9]{12,}\b/g, "[REDACTED ACCESS KEY]");
-}
 const SENSITIVITY_RANK = {
 	normal: 0,
 	personal: 1,
@@ -43,7 +36,7 @@ const SENSITIVITY_RANK = {
 	secret: 3
 };
 function stricterSensitivity(content, declared) {
-	const inferred = inferSensitivity(content);
+	const inferred = inferMemorySensitivity(content);
 	return SENSITIVITY_RANK[inferred] > SENSITIVITY_RANK[declared] ? inferred : declared;
 }
 function canonicalKey(kind, content) {
@@ -62,7 +55,7 @@ function extractExplicitUnderstandingCandidates(userContent) {
 			importance: kind === "boundary" ? .9 : .8,
 			explicitness: "explicit",
 			durability: "durable",
-			sensitivity: inferSensitivity(correction),
+			sensitivity: inferMemorySensitivity(correction),
 			disclosurePolicy: kind === "boundary" ? "silent" : "referenceable",
 			tags: ["user-understanding", "explicit-user-correction"]
 		}];
@@ -80,7 +73,7 @@ function extractExplicitUnderstandingCandidates(userContent) {
 			importance: kind === "boundary" ? .9 : .75,
 			explicitness: "explicit",
 			durability: "durable",
-			sensitivity: inferSensitivity(content),
+			sensitivity: inferMemorySensitivity(content),
 			disclosurePolicy: kind === "boundary" ? "silent" : "referenceable",
 			tags: ["user-understanding", "explicit-user-request"]
 		}];
@@ -94,7 +87,7 @@ var UserUnderstandingService = class {
 	async reviewTurn(params) {
 		const candidates = extractExplicitUnderstandingCandidates(params.userContent);
 		const sourceText = `User:\n${params.userContent.trim()}\n\nAssistant:\n${params.assistantContent.trim()}`;
-		const normalizedText = redactSensitiveText(sourceText);
+		const normalizedText = redactSensitiveMemoryText(sourceText);
 		const contentHash = createHash("sha256").update(sourceText).digest("hex");
 		const sourceItemId = upsertKnowledgeSourceItems([{
 			sourceInstanceId: params.sessionKey ? `session:${params.sessionKey}` : "session:unknown",
@@ -134,7 +127,7 @@ var UserUnderstandingService = class {
 				rejected += 1;
 				continue;
 			}
-			const evidenceText = context.sourceText ? redactSensitiveText(context.sourceText).slice(0, MAX_CANDIDATE_CHARS) : void 0;
+			const evidenceText = context.sourceText ? redactSensitiveMemoryText(context.sourceText).slice(0, MAX_CANDIDATE_CHARS) : void 0;
 			const key = candidate.canonicalKey ?? canonicalKey(candidate.kind, content);
 			const supersedesRecordId = context.supersedesRecordIds && [...new Set(context.supersedesRecordIds)].length === 1 ? context.supersedesRecordIds[0] : void 0;
 			const existing = await this.options.list(key);
@@ -162,7 +155,10 @@ var UserUnderstandingService = class {
 				kind: candidate.kind,
 				content,
 				canonicalKey: key,
-				scope: context.sessionKey ? { sessionKey: context.sessionKey } : void 0,
+				scope: context.agentId || context.sessionKey ? {
+					agentId: context.agentId,
+					sessionKey: context.sessionKey
+				} : void 0,
 				target: candidate.kind === "preference" ? "user" : "memory",
 				tags: [...new Set(["user-understanding", ...candidate.tags ?? []])],
 				source: { provider: "user-understanding" },