@xopcai/xopc 0.0.146 → 0.0.147

package/dist/src/agent/memory/builtin-memory-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-memory-store.js","names":[],"sources":["../../../../src/agent/memory/builtin-memory-store.ts"],"sourcesContent":["/**\n * Bounded curated memory: agent home `memories/MEMORY.md` + global `user/MEMORY.md`, §-delimited entries.\n * Snapshot for system prompt is captured at load time and not mutated until next load.\n */\n\nimport { existsSync, mkdirSync, readFileSync } from 'node:fs';\nimport { mkdir, readFile, rename, writeFile } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport lockfile from 'proper-lockfile';\n\nimport type { MemorySnapshot, MemoryStoreConfig } from './types.js';\n\nexport const MEMORY_ENTRY_DELIMITER = '\\n§\\n';\n\nconst DEFAULT_MEMORY_LIMIT = 2200;\nconst DEFAULT_USER_LIMIT = 1375;\n\nexport class BuiltinMemoryStore {\n  private memoryEntries: string[] = [];\n  private userEntries: string[] = [];\n  private snapshot: MemorySnapshot = { memory: '', user: '' };\n\n  constructor(private readonly config: MemoryStoreConfig) {}\n\n  /** When false, global user memory is omitted from the snapshot and should not be edited via `curated_memory`. */\n  isUserProfileEnabled(): boolean {\n    return this.config.userProfileEnabled !== false;\n  }\n\n  /** Agent-scoped curated memory directory (`~/.xopc/agents/<id>/memories/`). */\n  get memoriesDir(): string {\n    return this.config.memoriesDir;\n  }\n\n  /** Global user memory file (`~/.xopc/user/MEMORY.md`). */\n  get userMemoryPath(): string {\n    return this.config.userMemoryPath;\n  }\n\n  /** Workspace whose profile and curated files participate in local memory search. */\n  get workspaceDir(): string {\n    return this.config.workspaceDir;\n  }\n\n  pathFor(target: 'memory' | 'user'): string {\n    return target === 'memory' ? join(this.memoriesDir, 'MEMORY.md') : this.userMemoryPath;\n  }\n\n  /**\n   * Load from disk and freeze {@link getSnapshot}. Sync for agent creation (prefix cache stability).\n   */\n  loadFromDiskSync(): void {\n    mkdirSync(this.memoriesDir, { recursive: true });\n    this.memoryEntries = this.parseFileContent(\n      this.readPathSync(join(this.memoriesDir, 'MEMORY.md')),\n    );\n    this.userEntries =\n      this.config.userProfileEnabled === false\n        ? []\n        : this.parseFileContent(this.readPathSync(this.userMemoryPath));\n    this.memoryEntries = dedupePreserveOrder(this.memoryEntries);\n    this.userEntries = dedupePreserveOrder(this.userEntries);\n    this.snapshot = {\n      memory: this.renderBlock('memory', this.memoryEntries),\n      user: this.renderBlock('user', this.userEntries),\n    };\n  }\n\n  private readPathSync(path: string): string {\n    try {\n      if (!existsSync(path)) return '';\n      return readFileSync(path, { encoding: 'utf-8' });\n    } catch {\n      return '';\n    }\n  }\n\n  private parseFileContent(raw: string): string[] {\n    if (!raw.trim()) return [];\n    return raw\n      .split(MEMORY_ENTRY_DELIMITER)\n      .map((e) => e.trim())\n      .filter(Boolean);\n  }\n\n  getSnapshot(): MemorySnapshot {\n    return this.snapshot;\n  }\n\n  /**\n   * Live entries for read/debug (may differ from snapshot after mutations).\n   */\n  getLiveEntries(target: 'memory' | 'user'): string[] {\n    return target === 'memory' ? [...this.memoryEntries] : [...this.userEntries];\n  }\n\n  async add(\n    target: 'memory' | 'user',\n    content: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const trimmed = content.trim();\n    if (!trimmed) {\n      return { success: false, error: 'Content cannot be empty.' };\n    }\n    const scanError = scanForThreats(trimmed);\n    if (scanError) {\n      return { success: false, error: scanError };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const limit = this.charLimit(target);\n\n      if (entries.includes(trimmed)) {\n        return { success: false, error: 'Entry already exists' };\n      }\n\n      const newTotal = calculateTotal([...entries, trimmed]);\n      if (newTotal > limit) {\n        return {\n          success: false,\n          error: `Memory at ${calculateTotal(entries)}/${limit} chars. Adding would exceed limit.`,\n        };\n      }\n\n      entries.push(trimmed);\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry added.' };\n    });\n  }\n\n  async replace(\n    target: 'memory' | 'user',\n    oldText: string,\n    newContent: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const ot = oldText.trim();\n    const nc = newContent.trim();\n    if (!ot) {\n      return { success: false, error: 'old_text cannot be empty.' };\n    }\n    if (!nc) {\n      return { success: false, error: 'new_content cannot be empty. Use remove to delete entries.' };\n    }\n    const scanError = scanForThreats(nc);\n    if (scanError) {\n      return { success: false, error: scanError };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const matches: Array<{ index: number; entry: string }> = [];\n      for (let i = 0; i < entries.length; i++) {\n        if (entries[i].includes(ot)) {\n          matches.push({ index: i, entry: entries[i] });\n        }\n      }\n\n      if (matches.length === 0) {\n        return { success: false, error: `No entry matched '${ot}'.` };\n      }\n\n      if (matches.length > 1) {\n        const uniqueTexts = new Set(matches.map((m) => m.entry));\n        if (uniqueTexts.size > 1) {\n          const previews = matches.map((m) =>\n            m.entry.length > 80 ? `${m.entry.slice(0, 80)}...` : m.entry,\n          );\n          return {\n            success: false,\n            error: `Multiple entries matched '${ot}'. Be more specific. Previews: ${previews.join(' | ')}`,\n          };\n        }\n      }\n\n      const idx = matches[0].index;\n      const limit = this.charLimit(target);\n      const testEntries = [...entries];\n      testEntries[idx] = nc;\n\n      if (calculateTotal(testEntries) > limit) {\n        return {\n          success: false,\n          error: `Replacement would put memory at ${calculateTotal(testEntries)}/${limit} chars.`,\n        };\n      }\n\n      entries[idx] = nc;\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry replaced.' };\n    });\n  }\n\n  async remove(\n    target: 'memory' | 'user',\n    oldText: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const ot = oldText.trim();\n    if (!ot) {\n      return { success: false, error: 'old_text cannot be empty.' };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const matches: number[] = [];\n      for (let i = 0; i < entries.length; i++) {\n        if (entries[i].includes(ot)) {\n          matches.push(i);\n        }\n      }\n\n      if (matches.length === 0) {\n        return { success: false, error: `No entry matched '${ot}'.` };\n      }\n\n      if (matches.length > 1) {\n        const uniqueTexts = new Set(matches.map((i) => entries[i]));\n        if (uniqueTexts.size > 1) {\n          const previews = matches.map((i) => {\n            const e = entries[i];\n            return e.length > 80 ? `${e.slice(0, 80)}...` : e;\n          });\n          return {\n            success: false,\n            error: `Multiple entries matched '${ot}'. Be more specific. Previews: ${previews.join(' | ')}`,\n          };\n        }\n      }\n\n      entries.splice(matches[0], 1);\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry removed.' };\n    });\n  }\n\n  private async withFileLock<T>(\n    target: 'memory' | 'user',\n    fn: () => Promise<T>,\n  ): Promise<T> {\n    const filePath = this.pathFor(target);\n    await mkdir(dirname(filePath), { recursive: true });\n    if (!existsSync(filePath)) {\n      await writeFile(filePath, '', 'utf-8');\n    }\n    await lockfile.lock(filePath, { retries: 3, stale: 10_000 });\n    try {\n      return await fn();\n    } finally {\n      await lockfile.unlock(filePath);\n    }\n  }\n\n  private async reloadTargetFromDisk(target: 'memory' | 'user'): Promise<void> {\n    const path = this.pathFor(target);\n    let raw = '';\n    try {\n      raw = await readFile(path, 'utf-8');\n    } catch {\n      raw = '';\n    }\n    const parsed = dedupePreserveOrder(this.parseFileContent(raw));\n    if (target === 'memory') {\n      this.memoryEntries = parsed;\n    } else {\n      this.userEntries = parsed;\n    }\n  }\n\n  private async flushTargetToDisk(target: 'memory' | 'user'): Promise<void> {\n    const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n    const filePath = this.pathFor(target);\n    const content = entries.join(MEMORY_ENTRY_DELIMITER);\n    const tmpPath = `${filePath}.tmp.${Date.now()}`;\n    await mkdir(dirname(filePath), { recursive: true });\n    await writeFile(tmpPath, content, 'utf-8');\n    await rename(tmpPath, filePath);\n  }\n\n  private charLimit(target: 'memory' | 'user'): number {\n    return target === 'memory'\n      ? (this.config.memoryCharLimit ?? DEFAULT_MEMORY_LIMIT)\n      : (this.config.userCharLimit ?? DEFAULT_USER_LIMIT);\n  }\n\n  private renderBlock(target: 'memory' | 'user', entries: string[]): string {\n    if (entries.length === 0) {\n      return '';\n    }\n\n    const limit = this.charLimit(target);\n    const content = entries.join(MEMORY_ENTRY_DELIMITER);\n    const current = content.length;\n    const pct = Math.min(100, Math.round((current / limit) * 100));\n\n    const header =\n      target === 'user'\n        ? `USER PROFILE (who the user is) [${pct}% — ${current.toLocaleString()}/${limit.toLocaleString()} chars]`\n        : `MEMORY (your personal notes) [${pct}% — ${current.toLocaleString()}/${limit.toLocaleString()} chars]`;\n\n    const separator = '═'.repeat(46);\n    return `${separator}\\n${header}\\n${separator}\\n${content}`;\n  }\n}\n\nfunction dedupePreserveOrder(entries: string[]): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const e of entries) {\n    if (seen.has(e)) {\n      continue;\n    }\n    seen.add(e);\n    out.push(e);\n  }\n  return out;\n}\n\nfunction calculateTotal(entries: string[]): number {\n  if (entries.length === 0) {\n    return 0;\n  }\n  return entries.join(MEMORY_ENTRY_DELIMITER).length;\n}\n\nexport function scanForThreats(content: string): string | null {\n  const patterns: Array<{ regex: RegExp; id: string }> = [\n    { regex: /ignore\\s+(previous|all|above|prior)\\s+instructions/i, id: 'prompt_injection' },\n    { regex: /you\\s+are\\s+now\\s+/i, id: 'role_hijack' },\n    { regex: /do\\s+not\\s+tell\\s+the\\s+user/i, id: 'deception_hide' },\n    { regex: /system\\s+prompt\\s+override/i, id: 'sys_prompt_override' },\n    {\n      regex: /disregard\\s+(your|all|any)\\s+(instructions|rules|guidelines)/i,\n      id: 'disregard_rules',\n    },\n    {\n      regex: /act\\s+as\\s+(if|though)\\s+you\\s+(have\\s+no|don't\\s+have)\\s+(restrictions|limits|rules)/i,\n      id: 'bypass_restrictions',\n    },\n    { regex: /curl\\s+[^\\n]*\\$\\{?\\w*(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|API)/i, id: 'exfil_curl' },\n    { regex: /wget\\s+[^\\n]*\\$\\{?\\w*(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|API)/i, id: 'exfil_wget' },\n    {\n      regex: /cat\\s+[^\\n]*(\\.env|credentials|\\.netrc|\\.pgpass|\\.npmrc|\\.pypirc)/i,\n      id: 'read_secrets',\n    },\n    { regex: /authorized_keys/i, id: 'ssh_backdoor' },\n    { regex: /\\$HOME\\/\\.ssh|\\~\\/\\.ssh/i, id: 'ssh_access' },\n  ];\n\n  for (const { regex, id } of patterns) {\n    if (regex.test(content)) {\n      return `Blocked: content matches threat pattern '${id}'. Memory entries are injected into the system prompt and must not contain injection payloads.`;\n    }\n  }\n\n  const invisibleChars = [\n    '\\u200b',\n    '\\u200c',\n    '\\u200d',\n    '\\u2060',\n    '\\ufeff',\n    '\\u202a',\n    '\\u202b',\n    '\\u202c',\n    '\\u202d',\n    '\\u202e',\n  ];\n  for (const char of invisibleChars) {\n    if (content.includes(char)) {\n      const code = char.charCodeAt(0).toString(16).toUpperCase().padStart(4, '0');\n      return `Blocked: content contains invisible unicode character U+${code} (possible injection).`;\n    }\n  }\n\n  return null;\n}\n"],"mappings":"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"}
+{"version":3,"file":"builtin-memory-store.js","names":[],"sources":["../../../../src/agent/memory/builtin-memory-store.ts"],"sourcesContent":["/**\n * Bounded curated memory under the shared user context directory, §-delimited entries.\n * Snapshot for system prompt is captured at load time and not mutated until next load.\n */\n\nimport { existsSync, mkdirSync, readFileSync } from 'node:fs';\nimport { mkdir, readFile, rename, writeFile } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport lockfile from 'proper-lockfile';\n\nimport type { MemorySnapshot, MemoryStoreConfig } from './types.js';\n\nexport const MEMORY_ENTRY_DELIMITER = '\\n§\\n';\n\nconst DEFAULT_MEMORY_LIMIT = 2200;\nconst DEFAULT_USER_LIMIT = 1375;\n\nexport class BuiltinMemoryStore {\n  private memoryEntries: string[] = [];\n  private userEntries: string[] = [];\n  private snapshot: MemorySnapshot = { memory: '', user: '' };\n\n  constructor(private readonly config: MemoryStoreConfig) {}\n\n  /** When false, global user memory is omitted from the snapshot and should not be edited via `curated_memory`. */\n  isUserProfileEnabled(): boolean {\n    return this.config.userProfileEnabled !== false;\n  }\n\n  /** Shared curated memory directory (`~/.xopc/user/memories/`). */\n  get memoriesDir(): string {\n    return this.config.memoriesDir;\n  }\n\n  /** Global user memory file (`~/.xopc/user/MEMORY.md`). */\n  get userMemoryPath(): string {\n    return this.config.userMemoryPath;\n  }\n\n  /** Workspace whose profile and curated files participate in local memory search. */\n  get workspaceDir(): string {\n    return this.config.workspaceDir;\n  }\n\n  pathFor(target: 'memory' | 'user'): string {\n    return target === 'memory' ? join(this.memoriesDir, 'MEMORY.md') : this.userMemoryPath;\n  }\n\n  /**\n   * Load from disk and freeze {@link getSnapshot}. Sync for agent creation (prefix cache stability).\n   */\n  loadFromDiskSync(): void {\n    mkdirSync(this.memoriesDir, { recursive: true });\n    this.memoryEntries = this.parseFileContent(\n      this.readPathSync(join(this.memoriesDir, 'MEMORY.md')),\n    );\n    this.userEntries =\n      this.config.userProfileEnabled === false\n        ? []\n        : this.parseFileContent(this.readPathSync(this.userMemoryPath));\n    this.memoryEntries = dedupePreserveOrder(this.memoryEntries);\n    this.userEntries = dedupePreserveOrder(this.userEntries);\n    this.snapshot = {\n      memory: this.renderBlock('memory', this.memoryEntries),\n      user: this.renderBlock('user', this.userEntries),\n    };\n  }\n\n  private readPathSync(path: string): string {\n    try {\n      if (!existsSync(path)) return '';\n      return readFileSync(path, { encoding: 'utf-8' });\n    } catch {\n      return '';\n    }\n  }\n\n  private parseFileContent(raw: string): string[] {\n    if (!raw.trim()) return [];\n    return raw\n      .split(MEMORY_ENTRY_DELIMITER)\n      .map((e) => e.trim())\n      .filter(Boolean);\n  }\n\n  getSnapshot(): MemorySnapshot {\n    return this.snapshot;\n  }\n\n  /**\n   * Live entries for read/debug (may differ from snapshot after mutations).\n   */\n  getLiveEntries(target: 'memory' | 'user'): string[] {\n    return target === 'memory' ? [...this.memoryEntries] : [...this.userEntries];\n  }\n\n  async add(\n    target: 'memory' | 'user',\n    content: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const trimmed = content.trim();\n    if (!trimmed) {\n      return { success: false, error: 'Content cannot be empty.' };\n    }\n    const scanError = scanForThreats(trimmed);\n    if (scanError) {\n      return { success: false, error: scanError };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const limit = this.charLimit(target);\n\n      if (entries.includes(trimmed)) {\n        return { success: false, error: 'Entry already exists' };\n      }\n\n      const newTotal = calculateTotal([...entries, trimmed]);\n      if (newTotal > limit) {\n        return {\n          success: false,\n          error: `Memory at ${calculateTotal(entries)}/${limit} chars. Adding would exceed limit.`,\n        };\n      }\n\n      entries.push(trimmed);\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry added.' };\n    });\n  }\n\n  async replace(\n    target: 'memory' | 'user',\n    oldText: string,\n    newContent: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const ot = oldText.trim();\n    const nc = newContent.trim();\n    if (!ot) {\n      return { success: false, error: 'old_text cannot be empty.' };\n    }\n    if (!nc) {\n      return { success: false, error: 'new_content cannot be empty. Use remove to delete entries.' };\n    }\n    const scanError = scanForThreats(nc);\n    if (scanError) {\n      return { success: false, error: scanError };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const matches: Array<{ index: number; entry: string }> = [];\n      for (let i = 0; i < entries.length; i++) {\n        if (entries[i].includes(ot)) {\n          matches.push({ index: i, entry: entries[i] });\n        }\n      }\n\n      if (matches.length === 0) {\n        return { success: false, error: `No entry matched '${ot}'.` };\n      }\n\n      if (matches.length > 1) {\n        const uniqueTexts = new Set(matches.map((m) => m.entry));\n        if (uniqueTexts.size > 1) {\n          const previews = matches.map((m) =>\n            m.entry.length > 80 ? `${m.entry.slice(0, 80)}...` : m.entry,\n          );\n          return {\n            success: false,\n            error: `Multiple entries matched '${ot}'. Be more specific. Previews: ${previews.join(' | ')}`,\n          };\n        }\n      }\n\n      const idx = matches[0].index;\n      const limit = this.charLimit(target);\n      const testEntries = [...entries];\n      testEntries[idx] = nc;\n\n      if (calculateTotal(testEntries) > limit) {\n        return {\n          success: false,\n          error: `Replacement would put memory at ${calculateTotal(testEntries)}/${limit} chars.`,\n        };\n      }\n\n      entries[idx] = nc;\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry replaced.' };\n    });\n  }\n\n  async remove(\n    target: 'memory' | 'user',\n    oldText: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const ot = oldText.trim();\n    if (!ot) {\n      return { success: false, error: 'old_text cannot be empty.' };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const matches: number[] = [];\n      for (let i = 0; i < entries.length; i++) {\n        if (entries[i].includes(ot)) {\n          matches.push(i);\n        }\n      }\n\n      if (matches.length === 0) {\n        return { success: false, error: `No entry matched '${ot}'.` };\n      }\n\n      if (matches.length > 1) {\n        const uniqueTexts = new Set(matches.map((i) => entries[i]));\n        if (uniqueTexts.size > 1) {\n          const previews = matches.map((i) => {\n            const e = entries[i];\n            return e.length > 80 ? `${e.slice(0, 80)}...` : e;\n          });\n          return {\n            success: false,\n            error: `Multiple entries matched '${ot}'. Be more specific. Previews: ${previews.join(' | ')}`,\n          };\n        }\n      }\n\n      entries.splice(matches[0], 1);\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry removed.' };\n    });\n  }\n\n  private async withFileLock<T>(\n    target: 'memory' | 'user',\n    fn: () => Promise<T>,\n  ): Promise<T> {\n    const filePath = this.pathFor(target);\n    await mkdir(dirname(filePath), { recursive: true });\n    if (!existsSync(filePath)) {\n      await writeFile(filePath, '', 'utf-8');\n    }\n    await lockfile.lock(filePath, { retries: 3, stale: 10_000 });\n    try {\n      return await fn();\n    } finally {\n      await lockfile.unlock(filePath);\n    }\n  }\n\n  private async reloadTargetFromDisk(target: 'memory' | 'user'): Promise<void> {\n    const path = this.pathFor(target);\n    let raw = '';\n    try {\n      raw = await readFile(path, 'utf-8');\n    } catch {\n      raw = '';\n    }\n    const parsed = dedupePreserveOrder(this.parseFileContent(raw));\n    if (target === 'memory') {\n      this.memoryEntries = parsed;\n    } else {\n      this.userEntries = parsed;\n    }\n  }\n\n  private async flushTargetToDisk(target: 'memory' | 'user'): Promise<void> {\n    const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n    const filePath = this.pathFor(target);\n    const content = entries.join(MEMORY_ENTRY_DELIMITER);\n    const tmpPath = `${filePath}.tmp.${Date.now()}`;\n    await mkdir(dirname(filePath), { recursive: true });\n    await writeFile(tmpPath, content, 'utf-8');\n    await rename(tmpPath, filePath);\n  }\n\n  private charLimit(target: 'memory' | 'user'): number {\n    return target === 'memory'\n      ? (this.config.memoryCharLimit ?? DEFAULT_MEMORY_LIMIT)\n      : (this.config.userCharLimit ?? DEFAULT_USER_LIMIT);\n  }\n\n  private renderBlock(target: 'memory' | 'user', entries: string[]): string {\n    if (entries.length === 0) {\n      return '';\n    }\n\n    const limit = this.charLimit(target);\n    const content = entries.join(MEMORY_ENTRY_DELIMITER);\n    const current = content.length;\n    const pct = Math.min(100, Math.round((current / limit) * 100));\n\n    const header =\n      target === 'user'\n        ? `USER PROFILE (who the user is) [${pct}% — ${current.toLocaleString()}/${limit.toLocaleString()} chars]`\n        : `MEMORY (your personal notes) [${pct}% — ${current.toLocaleString()}/${limit.toLocaleString()} chars]`;\n\n    const separator = '═'.repeat(46);\n    return `${separator}\\n${header}\\n${separator}\\n${content}`;\n  }\n}\n\nfunction dedupePreserveOrder(entries: string[]): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const e of entries) {\n    if (seen.has(e)) {\n      continue;\n    }\n    seen.add(e);\n    out.push(e);\n  }\n  return out;\n}\n\nfunction calculateTotal(entries: string[]): number {\n  if (entries.length === 0) {\n    return 0;\n  }\n  return entries.join(MEMORY_ENTRY_DELIMITER).length;\n}\n\nexport function scanForThreats(content: string): string | null {\n  const patterns: Array<{ regex: RegExp; id: string }> = [\n    { regex: /ignore\\s+(previous|all|above|prior)\\s+instructions/i, id: 'prompt_injection' },\n    { regex: /you\\s+are\\s+now\\s+/i, id: 'role_hijack' },\n    { regex: /do\\s+not\\s+tell\\s+the\\s+user/i, id: 'deception_hide' },\n    { regex: /system\\s+prompt\\s+override/i, id: 'sys_prompt_override' },\n    {\n      regex: /disregard\\s+(your|all|any)\\s+(instructions|rules|guidelines)/i,\n      id: 'disregard_rules',\n    },\n    {\n      regex: /act\\s+as\\s+(if|though)\\s+you\\s+(have\\s+no|don't\\s+have)\\s+(restrictions|limits|rules)/i,\n      id: 'bypass_restrictions',\n    },\n    { regex: /curl\\s+[^\\n]*\\$\\{?\\w*(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|API)/i, id: 'exfil_curl' },\n    { regex: /wget\\s+[^\\n]*\\$\\{?\\w*(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|API)/i, id: 'exfil_wget' },\n    {\n      regex: /cat\\s+[^\\n]*(\\.env|credentials|\\.netrc|\\.pgpass|\\.npmrc|\\.pypirc)/i,\n      id: 'read_secrets',\n    },\n    { regex: /authorized_keys/i, id: 'ssh_backdoor' },\n    { regex: /\\$HOME\\/\\.ssh|\\~\\/\\.ssh/i, id: 'ssh_access' },\n  ];\n\n  for (const { regex, id } of patterns) {\n    if (regex.test(content)) {\n      return `Blocked: content matches threat pattern '${id}'. Memory entries are injected into the system prompt and must not contain injection payloads.`;\n    }\n  }\n\n  const invisibleChars = [\n    '\\u200b',\n    '\\u200c',\n    '\\u200d',\n    '\\u2060',\n    '\\ufeff',\n    '\\u202a',\n    '\\u202b',\n    '\\u202c',\n    '\\u202d',\n    '\\u202e',\n  ];\n  for (const char of invisibleChars) {\n    if (content.includes(char)) {\n      const code = char.charCodeAt(0).toString(16).toUpperCase().padStart(4, '0');\n      return `Blocked: content contains invisible unicode character U+${code} (possible injection).`;\n    }\n  }\n\n  return null;\n}\n"],"mappings":"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"}

package/dist/src/agent/memory/builtin-provider.d.ts

@@ -1,5 +1,4 @@
 import type { BuiltinMemoryStore } from './builtin-memory-store.js';
-import type { MemoryAccessPolicy } from './access-policy.js';
 import type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';
 import type { MemoryDeleteRequest, MemoryListRequest, MemoryReadRequest, MemoryReadResult, MemoryRecord, MemorySearchRequest, MemorySearchResult, MemoryUpdateRequest, MemoryWriteRequest, MemoryWriteResult, MemorySyncEvent } from './types.js';
 /**
@@ -8,7 +7,6 @@ import type { MemoryDeleteRequest, MemoryListRequest, MemoryReadRequest, MemoryR
  */
 export declare class BuiltinMemoryProvider implements MemoryProvider {
     private readonly store;
-    private readonly accessPolicy?;
     readonly id = "local";
     readonly displayName = "Local Knowledge Store";
     readonly capabilities: {
@@ -26,7 +24,7 @@ export declare class BuiltinMemoryProvider implements MemoryProvider {
     };
     private workspaceDir;
     private agentId;
-    constructor(store: BuiltinMemoryStore, accessPolicy?: MemoryAccessPolicy);
+    constructor(store: BuiltinMemoryStore);
     isAvailable(): boolean;
     initialize(_sessionId: string, options?: MemoryProviderInitOptions): Promise<void>;
     systemPromptBlock(): string;

package/dist/src/agent/memory/builtin-provider.js

@@ -26,9 +26,8 @@ var BuiltinMemoryProvider = class {
 	};
 	workspaceDir = "";
 	agentId = "main";
-	constructor(store, accessPolicy) {
+	constructor(store) {
 		this.store = store;
-		this.accessPolicy = accessPolicy;
 	}
 	isAvailable() {
 		return true;
@@ -46,10 +45,8 @@ var BuiltinMemoryProvider = class {
 	}
 	async search(request) {
 		const workspaceId = request.scope?.workspaceId ?? this.workspaceDir;
-		const recordHits = (this.accessPolicy?.readableAgentIds ?? [this.agentId]).flatMap((ownerAgentId) => searchMemoryRecords({
+		const recordHits = searchMemoryRecords({
 			query: request.query,
-			agentId: ownerAgentId,
-			workspaceId: ownerAgentId === this.agentId ? workspaceId : void 0,
 			visibleToSessionKey: request.scope?.sessionKey,
 			unscopedSessionOnly: request.scope?.sessionKey == null,
 			visibleToProjectId: request.scope?.projectId,
@@ -58,14 +55,13 @@ var BuiltinMemoryProvider = class {
 			kinds: request.kinds,
 			maxResults: request.maxResults,
 			minScore: request.minScore
-		})).filter((result) => this.canReadRecord(result.record, request.scope)).sort((left, right) => right.score - left.score).slice(0, request.maxResults ?? 5);
+		}).filter((result) => this.canReadRecord(result.record, request.scope)).sort((left, right) => right.score - left.score).slice(0, request.maxResults ?? 5);
 		if (recordHits.length > 0) return recordHits;
 		return (await memorySearch(this.workspaceDir, request.query, {
 			maxResults: request.maxResults,
 			minScore: request.minScore,
 			memoriesDir: this.store.memoriesDir,
-			userMemoryPath: this.store.userMemoryPath,
-			agentId: this.agentId
+			userMemoryPath: this.store.userMemoryPath
 		})).map((entry) => {
 			const start = entry.lineNumbers[0] ?? 1;
 			const end = entry.lineNumbers[entry.lineNumbers.length - 1] ?? start;
@@ -76,7 +72,7 @@ var BuiltinMemoryProvider = class {
 					id,
 					providerId: this.id,
 					kind,
-					agentId: this.agentId,
+					sourceAgentId: this.agentId,
 					workspaceId,
 					content: entry.lines,
 					source: {
@@ -113,7 +109,7 @@ var BuiltinMemoryProvider = class {
 				id: `${path}#L${result.lineNumbers.start}-L${result.lineNumbers.end}`,
 				providerId: this.id,
 				kind: inferKindFromPath(path),
-				agentId: this.agentId,
+				sourceAgentId: this.agentId,
 				workspaceId: request.scope?.workspaceId ?? this.workspaceDir,
 				content: result.content,
 				source: {
@@ -137,7 +133,6 @@ var BuiltinMemoryProvider = class {
 	async list(request) {
 		const records = listMemoryRecords({
 			providerId: this.id,
-			agentId: request.scope?.agentId ?? this.agentId,
 			workspaceId: request.scope?.workspaceId ?? this.workspaceDir,
 			visibleToSessionKey: request.scope?.sessionKey,
 			visibleToProjectId: request.scope?.projectId,
@@ -151,8 +146,8 @@ var BuiltinMemoryProvider = class {
 		return this.store.getLiveEntries(target).map((content, index) => upsertMemoryRecord({
 			id: `curated:${target}:${index + 1}`,
 			providerId: this.id,
-			kind: target === "user" ? "user_profile" : "agent_note",
-			agentId: request.scope?.agentId ?? this.agentId,
+			kind: target === "user" ? "user_profile" : "curated_note",
+			sourceAgentId: this.agentId,
 			workspaceId: request.scope?.workspaceId ?? this.workspaceDir,
 			content,
 			source: {
@@ -163,33 +158,23 @@ var BuiltinMemoryProvider = class {
 	}
 	async write(request) {
 		const target = request.target ?? (request.kind === "user_profile" ? "user" : "memory");
-		const ownerAgentId = normalizeAgentId(request.scope?.agentId ?? this.agentId);
-		const isCrossAgentWrite = ownerAgentId !== this.agentId;
-		if (isCrossAgentWrite && request.status !== "candidate") return {
-			success: false,
-			error: "Cross-agent writes must be submitted as candidates"
-		};
-		if (isCrossAgentWrite && !this.accessPolicy?.canSubmitCandidate(ownerAgentId)) return {
-			success: false,
-			error: "Cross-agent candidate submission is not allowed"
-		};
 		if (request.status === "candidate") return {
 			success: true,
 			message: "Memory candidate added to inbox",
 			record: upsertMemoryRecord({
 				providerId: this.id,
 				kind: request.kind,
-				agentId: ownerAgentId,
-				workspaceId: isCrossAgentWrite ? request.scope?.workspaceId : request.scope?.workspaceId ?? this.workspaceDir,
-				sessionKey: isCrossAgentWrite ? void 0 : request.scope?.sessionKey,
-				projectId: isCrossAgentWrite ? void 0 : request.scope?.projectId,
+				sourceAgentId: this.agentId,
+				workspaceId: request.scope?.workspaceId ?? this.workspaceDir,
+				sessionKey: request.scope?.sessionKey,
+				projectId: request.scope?.projectId,
 				content: request.content,
 				source: {
 					...request.source ?? {},
 					provider: this.id
 				},
 				confidence: request.confidence,
-				tags: isCrossAgentWrite ? [...request.tags ?? [], `shared-from:${this.agentId}`] : request.tags,
+				tags: request.tags,
 				status: "candidate",
 				sensitivity: request.sensitivity,
 				canonicalKey: request.canonicalKey,
@@ -218,7 +203,7 @@ var BuiltinMemoryProvider = class {
 				id: `curated:${target}:${Date.now()}`,
 				providerId: this.id,
 				kind: request.kind,
-				agentId: this.agentId,
+				sourceAgentId: this.agentId,
 				workspaceId: request.scope?.workspaceId ?? this.workspaceDir,
 				sessionKey: request.scope?.sessionKey,
 				content: request.content,
@@ -245,10 +230,6 @@ var BuiltinMemoryProvider = class {
 	}
 	async update(request) {
 		const target = request.target ?? "memory";
-		if (((request.id ? getMemoryRecord(request.id) : null)?.scope.agentId ?? request.scope?.agentId ?? this.agentId) !== this.agentId) return {
-			success: false,
-			error: "Cross-agent memory updates are not allowed"
-		};
 		const result = await this.store.replace(target, request.matchText ?? request.id ?? "", request.content);
 		if (!result.success) return {
 			success: false,
@@ -259,8 +240,8 @@ var BuiltinMemoryProvider = class {
 			upsertMemoryRecord({
 				id: request.id,
 				providerId: this.id,
-				kind: existing?.kind ?? (target === "user" ? "user_profile" : "agent_note"),
-				agentId: existing?.scope.agentId ?? request.scope?.agentId ?? this.agentId,
+				kind: existing?.kind ?? (target === "user" ? "user_profile" : "curated_note"),
+				sourceAgentId: existing?.provenance.sourceAgentId ?? this.agentId,
 				workspaceId: existing?.scope.workspaceId ?? request.scope?.workspaceId ?? this.workspaceDir,
 				sessionKey: existing?.scope.sessionKey ?? request.scope?.sessionKey,
 				content: request.content,
@@ -272,9 +253,8 @@ var BuiltinMemoryProvider = class {
 			});
 		} else if (request.matchText) for (const existing of listMemoryRecords({
 			providerId: this.id,
-			agentId: request.scope?.agentId ?? this.agentId,
 			workspaceId: request.scope?.workspaceId ?? this.workspaceDir,
-			kind: target === "user" ? "user_profile" : "agent_note",
+			kind: target === "user" ? "user_profile" : "curated_note",
 			limit: 200
 		})) {
 			if (!existing.content.includes(request.matchText)) continue;
@@ -282,7 +262,7 @@ var BuiltinMemoryProvider = class {
 				id: existing.id,
 				providerId: this.id,
 				kind: existing.kind,
-				agentId: existing.scope.agentId,
+				sourceAgentId: existing.provenance.sourceAgentId,
 				workspaceId: existing.scope.workspaceId,
 				sessionKey: existing.scope.sessionKey,
 				content: request.content,
@@ -297,10 +277,6 @@ var BuiltinMemoryProvider = class {
 	}
 	async delete(request) {
 		const target = request.target ?? "memory";
-		if (((request.id ? getMemoryRecord(request.id) : null)?.scope.agentId ?? request.scope?.agentId ?? this.agentId) !== this.agentId) return {
-			success: false,
-			error: "Cross-agent memory deletion is not allowed"
-		};
 		const result = await this.store.remove(target, request.matchText ?? request.id ?? "");
 		if (!result.success) return {
 			success: false,
@@ -310,9 +286,8 @@ var BuiltinMemoryProvider = class {
 		else if (request.matchText) {
 			for (const existing of listMemoryRecords({
 				providerId: this.id,
-				agentId: request.scope?.agentId ?? this.agentId,
 				workspaceId: request.scope?.workspaceId ?? this.workspaceDir,
-				kind: target === "user" ? "user_profile" : "agent_note",
+				kind: target === "user" ? "user_profile" : "curated_note",
 				limit: 200
 			})) if (existing.content.includes(request.matchText)) deleteMemoryRecord(existing.id);
 		}
@@ -326,15 +301,13 @@ var BuiltinMemoryProvider = class {
 		appendMemorySignal({
 			signal: event.signal,
 			providerId: this.id,
-			agentId: this.agentId,
+			sourceAgentId: this.agentId,
 			workspaceId: this.workspaceDir,
 			sessionKey: typeof event.signal.metadata?.sessionKey === "string" ? event.signal.metadata.sessionKey : void 0
 		});
 	}
 	async shutdown() {}
 	canReadRecord(record, scope) {
-		if (this.accessPolicy) return this.accessPolicy.canReadRecord(record, scope);
-		if (record.scope.agentId !== this.agentId) return false;
 		if (record.scope.sessionKey && record.scope.sessionKey !== scope?.sessionKey) return false;
 		if (record.scope.projectId && record.scope.projectId !== scope?.projectId) return false;
 		return true;
@@ -344,7 +317,7 @@ function inferKindFromPath(path) {
 	const normalized = path.replace(/\\/g, "/");
 	if (normalized === "user/MEMORY.md" || normalized.endsWith("/user/MEMORY.md")) return "user_profile";
 	if (/^memory\/\d{4}-\d{2}-\d{2}\.md$/.test(normalized)) return "daily_note";
-	if (normalized.endsWith("MEMORY.md")) return "agent_note";
+	if (normalized.endsWith("MEMORY.md")) return "curated_note";
 	return "workspace_fact";
 }
 function targetForKind(kind) {

package/dist/src/agent/memory/builtin-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-provider.js","names":[],"sources":["../../../../src/agent/memory/builtin-provider.ts"],"sourcesContent":["import type { BuiltinMemoryStore } from './builtin-memory-store.js';\nimport type { MemoryAccessPolicy } from './access-policy.js';\nimport { normalizeAgentId } from '../../routing/agent-session-key.js';\nimport type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';\nimport { memoryGet, memorySearch } from '../prompt/memory/index.js';\nimport {\n  appendMemorySignal,\n  deleteMemoryRecord,\n  getMemoryRecord,\n  listMemoryRecords,\n  searchMemoryRecords,\n  upsertMemoryRecord,\n} from '../../storage/sqlite/index.js';\nimport type {\n  MemoryDeleteRequest,\n  MemoryListRequest,\n  MemoryReadRequest,\n  MemoryReadResult,\n  MemoryRecord,\n  MemorySearchRequest,\n  MemorySearchResult,\n  MemoryUpdateRequest,\n  MemoryWriteRequest,\n  MemoryWriteResult,\n  MemorySyncEvent,\n} from './types.js';\n\n/**\n * Builtin local memory provider backed by profile memory, agent-home curated files,\n * and the local SQLite FTS index.\n */\nexport class BuiltinMemoryProvider implements MemoryProvider {\n  readonly id = 'local';\n  readonly displayName = 'Local Knowledge Store';\n  readonly capabilities = {\n    search: true,\n    read: true,\n    write: true,\n    update: true,\n    delete: true,\n    keywordSearch: true,\n    semanticSearch: false,\n    hybridSearch: false,\n    citations: true,\n    sync: false,\n    local: true,\n  };\n\n  private workspaceDir = '';\n  private agentId = 'main';\n\n  constructor(\n    private readonly store: BuiltinMemoryStore,\n    private readonly accessPolicy?: MemoryAccessPolicy,\n  ) {}\n\n  isAvailable(): boolean {\n    return true;\n  }\n\n  async initialize(_sessionId: string, options?: MemoryProviderInitOptions): Promise<void> {\n    this.workspaceDir = options?.workspace ?? options?.agentWorkspace ?? this.store.workspaceDir;\n    this.agentId = normalizeAgentId(String(options?.agentId ?? this.agentId));\n  }\n\n  systemPromptBlock(): string {\n    return '';\n  }\n\n  queuePrefetch(): void {}\n\n  getToolSchemas() {\n    return [];\n  }\n\n  async search(request: MemorySearchRequest): Promise<MemorySearchResult[]> {\n    const workspaceId = request.scope?.workspaceId ?? this.workspaceDir;\n    const readableAgentIds = this.accessPolicy?.readableAgentIds ?? [this.agentId];\n    const recordHits = readableAgentIds\n      .flatMap((ownerAgentId) => searchMemoryRecords({\n        query: request.query,\n        agentId: ownerAgentId,\n        workspaceId: ownerAgentId === this.agentId ? workspaceId : undefined,\n        visibleToSessionKey: request.scope?.sessionKey,\n        unscopedSessionOnly: request.scope?.sessionKey == null,\n        visibleToProjectId: request.scope?.projectId,\n        unscopedProjectOnly: request.scope?.projectId == null,\n        providerId: this.id,\n        kinds: request.kinds,\n        maxResults: request.maxResults,\n        minScore: request.minScore,\n      }))\n      .filter((result) => this.canReadRecord(result.record, request.scope))\n      .sort((left, right) => right.score - left.score)\n      .slice(0, request.maxResults ?? 5);\n    if (recordHits.length > 0) {\n      return recordHits;\n    }\n\n    const results = await memorySearch(this.workspaceDir, request.query, {\n      maxResults: request.maxResults,\n      minScore: request.minScore,\n      memoriesDir: this.store.memoriesDir,\n      userMemoryPath: this.store.userMemoryPath,\n      agentId: this.agentId,\n    });\n    return results.map((entry) => {\n      const start = entry.lineNumbers[0] ?? 1;\n      const end = entry.lineNumbers[entry.lineNumbers.length - 1] ?? start;\n      const id = `${entry.file}#L${start}-L${end}`;\n      const kind = inferKindFromPath(entry.file);\n      const record = upsertMemoryRecord({\n        id,\n        providerId: this.id,\n        kind,\n        agentId: this.agentId,\n        workspaceId,\n        content: entry.lines,\n        source: {\n          provider: this.id,\n          path: entry.file,\n          lineStart: start,\n          lineEnd: end,\n        },\n        confidence: entry.score,\n      });\n      return {\n        record,\n        score: entry.score,\n        snippet: entry.lines,\n        citation: {\n          providerId: this.id,\n          recordId: id,\n          path: entry.file,\n          lineStart: start,\n          lineEnd: end,\n        },\n      };\n    });\n  }\n\n  async read(request: MemoryReadRequest): Promise<MemoryReadResult | null> {\n    if (request.id && !request.path) {\n      const existing = getMemoryRecord(request.id);\n      if (existing && this.canReadRecord(existing, request.scope)) {\n        return { record: existing };\n      }\n      if (existing) return null;\n    }\n    const result = memoryGet(\n      this.workspaceDir,\n      request.path ?? request.id ?? '',\n      request.from,\n      request.lines,\n      this.store.memoriesDir,\n      this.store.userMemoryPath,\n    );\n    if (!result) return null;\n    const path = request.path ?? request.id ?? '';\n    const record = upsertMemoryRecord({\n      id: `${path}#L${result.lineNumbers.start}-L${result.lineNumbers.end}`,\n      providerId: this.id,\n      kind: inferKindFromPath(path),\n      agentId: this.agentId,\n      workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n      content: result.content,\n      source: {\n        provider: this.id,\n        path,\n        lineStart: result.lineNumbers.start,\n        lineEnd: result.lineNumbers.end,\n      },\n    });\n    return {\n      record,\n      lineNumbers: result.lineNumbers,\n    };\n  }\n\n  async get(id: string): Promise<MemoryRecord | null> {\n    const parsed = parseLineAddress(id);\n    const result = await this.read({\n      path: parsed.path,\n      from: parsed.lineStart,\n      lines: parsed.lineEnd != null ? parsed.lineEnd - parsed.lineStart + 1 : undefined,\n    });\n    return result?.record ?? null;\n  }\n\n  async list(request: MemoryListRequest): Promise<MemoryRecord[]> {\n    const records = listMemoryRecords({\n      providerId: this.id,\n      agentId: request.scope?.agentId ?? this.agentId,\n      workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n      visibleToSessionKey: request.scope?.sessionKey,\n      visibleToProjectId: request.scope?.projectId,\n      kind: request.kind,\n      status: request.status,\n      canonicalKey: request.canonicalKey,\n      limit: 200,\n    });\n    if (records.length > 0 || request.kind || request.status || request.canonicalKey) {\n      return request.target\n        ? records.filter((record) => targetForKind(record.kind) === request.target)\n        : records;\n    }\n\n    const target = request.target ?? (request.kind === 'user_profile' ? 'user' : 'memory');\n    return this.store.getLiveEntries(target).map((content, index) =>\n      upsertMemoryRecord({\n        id: `curated:${target}:${index + 1}`,\n        providerId: this.id,\n        kind: target === 'user' ? 'user_profile' : 'agent_note',\n        agentId: request.scope?.agentId ?? this.agentId,\n        workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n        content,\n        source: {\n          provider: this.id,\n          path: sourcePathForTarget(target),\n        },\n      }),\n    );\n  }\n\n  async write(request: MemoryWriteRequest): Promise<MemoryWriteResult> {\n    const target = request.target ?? (request.kind === 'user_profile' ? 'user' : 'memory');\n    const ownerAgentId = normalizeAgentId(request.scope?.agentId ?? this.agentId);\n    const isCrossAgentWrite = ownerAgentId !== this.agentId;\n    if (isCrossAgentWrite && request.status !== 'candidate') {\n      return { success: false, error: 'Cross-agent writes must be submitted as candidates' };\n    }\n    if (isCrossAgentWrite && !this.accessPolicy?.canSubmitCandidate(ownerAgentId)) {\n      return { success: false, error: 'Cross-agent candidate submission is not allowed' };\n    }\n    if (request.status === 'candidate') {\n      const record = upsertMemoryRecord({\n        providerId: this.id,\n        kind: request.kind,\n        agentId: ownerAgentId,\n        workspaceId: isCrossAgentWrite ? request.scope?.workspaceId : request.scope?.workspaceId ?? this.workspaceDir,\n        sessionKey: isCrossAgentWrite ? undefined : request.scope?.sessionKey,\n        projectId: isCrossAgentWrite ? undefined : request.scope?.projectId,\n        content: request.content,\n        source: {\n          ...(request.source ?? {}),\n          provider: this.id,\n        },\n        confidence: request.confidence,\n        tags: isCrossAgentWrite\n          ? [...(request.tags ?? []), `shared-from:${this.agentId}`]\n          : request.tags,\n        status: 'candidate',\n        sensitivity: request.sensitivity,\n        canonicalKey: request.canonicalKey,\n        explicitness: request.explicitness,\n        durability: request.durability,\n        importance: request.importance,\n        disclosurePolicy: request.disclosurePolicy,\n        evidence: request.evidence,\n        validFrom: request.validFrom,\n        validTo: request.validTo,\n        reviewAfter: request.reviewAfter,\n        expiresAt: request.expiresAt,\n        supersedesRecordId: request.supersedesRecordId,\n        conflictGroupId: request.conflictGroupId,\n      });\n      return {\n        success: true,\n        message: 'Memory candidate added to inbox',\n        record,\n      };\n    }\n    const result = await this.store.add(target, request.content);\n    if (!result.success) return { success: false, error: result.error };\n    return {\n      success: true,\n      message: result.message,\n      record: upsertMemoryRecord({\n        id: `curated:${target}:${Date.now()}`,\n        providerId: this.id,\n        kind: request.kind,\n        agentId: this.agentId,\n        workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n        sessionKey: request.scope?.sessionKey,\n        content: request.content,\n        source: {\n          ...(request.source ?? {}),\n          provider: this.id,\n          path: sourcePathForTarget(target),\n        },\n        tags: request.tags,\n        canonicalKey: request.canonicalKey,\n        explicitness: request.explicitness,\n        durability: request.durability,\n        importance: request.importance,\n        disclosurePolicy: request.disclosurePolicy,\n        evidence: request.evidence,\n        validFrom: request.validFrom,\n        validTo: request.validTo,\n        reviewAfter: request.reviewAfter,\n        expiresAt: request.expiresAt,\n        supersedesRecordId: request.supersedesRecordId,\n        conflictGroupId: request.conflictGroupId,\n      }),\n    };\n  }\n\n  async update(request: MemoryUpdateRequest): Promise<MemoryWriteResult> {\n    const target = request.target ?? 'memory';\n    const existingRecord = request.id ? getMemoryRecord(request.id) : null;\n    const requestedOwnerAgentId = existingRecord?.scope.agentId ?? request.scope?.agentId ?? this.agentId;\n    if (requestedOwnerAgentId !== this.agentId) {\n      return { success: false, error: 'Cross-agent memory updates are not allowed' };\n    }\n    const result = await this.store.replace(target, request.matchText ?? request.id ?? '', request.content);\n    if (!result.success) return { success: false, error: result.error };\n    if (request.id) {\n      const existing = getMemoryRecord(request.id);\n      upsertMemoryRecord({\n        id: request.id,\n        providerId: this.id,\n        kind: existing?.kind ?? (target === 'user' ? 'user_profile' : 'agent_note'),\n        agentId: existing?.scope.agentId ?? request.scope?.agentId ?? this.agentId,\n        workspaceId: existing?.scope.workspaceId ?? request.scope?.workspaceId ?? this.workspaceDir,\n        sessionKey: existing?.scope.sessionKey ?? request.scope?.sessionKey,\n        content: request.content,\n        source: existing?.source ?? { provider: this.id, path: sourcePathForTarget(target) },\n        tags: existing?.tags,\n      });\n    } else if (request.matchText) {\n      for (const existing of listMemoryRecords({\n        providerId: this.id,\n        agentId: request.scope?.agentId ?? this.agentId,\n        workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n        kind: target === 'user' ? 'user_profile' : 'agent_note',\n        limit: 200,\n      })) {\n        if (!existing.content.includes(request.matchText)) continue;\n        upsertMemoryRecord({\n          id: existing.id,\n          providerId: this.id,\n          kind: existing.kind,\n          agentId: existing.scope.agentId,\n          workspaceId: existing.scope.workspaceId,\n          sessionKey: existing.scope.sessionKey,\n          content: request.content,\n          source: existing.source,\n          tags: existing.tags,\n        });\n      }\n    }\n    return { success: true, message: result.message };\n  }\n\n  async delete(request: MemoryDeleteRequest): Promise<MemoryWriteResult> {\n    const target = request.target ?? 'memory';\n    const existingRecord = request.id ? getMemoryRecord(request.id) : null;\n    const requestedOwnerAgentId = existingRecord?.scope.agentId ?? request.scope?.agentId ?? this.agentId;\n    if (requestedOwnerAgentId !== this.agentId) {\n      return { success: false, error: 'Cross-agent memory deletion is not allowed' };\n    }\n    const result = await this.store.remove(target, request.matchText ?? request.id ?? '');\n    if (!result.success) return { success: false, error: result.error };\n    if (request.id) {\n      deleteMemoryRecord(request.id);\n    } else if (request.matchText) {\n      for (const existing of listMemoryRecords({\n        providerId: this.id,\n        agentId: request.scope?.agentId ?? this.agentId,\n        workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n        kind: target === 'user' ? 'user_profile' : 'agent_note',\n        limit: 200,\n      })) {\n        if (existing.content.includes(request.matchText)) {\n          deleteMemoryRecord(existing.id);\n        }\n      }\n    }\n    return { success: true, message: result.message };\n  }\n\n  sync(event: MemorySyncEvent): void {\n    if (event.type !== 'signal') return;\n    appendMemorySignal({\n      signal: event.signal,\n      providerId: this.id,\n      agentId: this.agentId,\n      workspaceId: this.workspaceDir,\n      sessionKey:\n        typeof event.signal.metadata?.sessionKey === 'string'\n          ? event.signal.metadata.sessionKey\n          : undefined,\n    });\n  }\n\n  async shutdown(): Promise<void> {}\n\n  private canReadRecord(record: MemoryRecord, scope: MemoryReadRequest['scope']): boolean {\n    if (this.accessPolicy) return this.accessPolicy.canReadRecord(record, scope);\n    if (record.scope.agentId !== this.agentId) return false;\n    if (record.scope.sessionKey && record.scope.sessionKey !== scope?.sessionKey) return false;\n    if (record.scope.projectId && record.scope.projectId !== scope?.projectId) return false;\n    return true;\n  }\n}\n\nfunction inferKindFromPath(path: string): MemoryRecord['kind'] {\n  const normalized = path.replace(/\\\\/g, '/');\n  if (normalized === 'user/MEMORY.md' || normalized.endsWith('/user/MEMORY.md')) return 'user_profile';\n  if (/^memory\\/\\d{4}-\\d{2}-\\d{2}\\.md$/.test(normalized)) return 'daily_note';\n  if (normalized.endsWith('MEMORY.md')) return 'agent_note';\n  return 'workspace_fact';\n}\n\nfunction targetForKind(kind: MemoryRecord['kind']): 'memory' | 'user' {\n  return kind === 'user_profile' || kind === 'preference' || kind === 'relationship' ||\n    kind === 'routine' || kind === 'personal_logistics'\n    ? 'user'\n    : 'memory';\n}\n\nfunction sourcePathForTarget(target: 'memory' | 'user'): string {\n  return target === 'user' ? 'user/MEMORY.md' : 'MEMORY.md';\n}\n\nfunction parseLineAddress(id: string): { path: string; lineStart?: number; lineEnd?: number } {\n  const match = /^(.*)#L(\\d+)(?:-L(\\d+))?$/.exec(id);\n  if (!match) return { path: id };\n  const lineStart = Number.parseInt(match[2] ?? '1', 10);\n  const lineEnd = Number.parseInt(match[3] ?? match[2] ?? '1', 10);\n  return {\n    path: match[1] ?? id,\n    lineStart: Number.isFinite(lineStart) ? lineStart : undefined,\n    lineEnd: Number.isFinite(lineEnd) ? lineEnd : undefined,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"builtin-provider.js","names":[],"sources":["../../../../src/agent/memory/builtin-provider.ts"],"sourcesContent":["import type { BuiltinMemoryStore } from './builtin-memory-store.js';\nimport { normalizeAgentId } from '../../routing/agent-session-key.js';\nimport type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';\nimport { memoryGet, memorySearch } from '../prompt/memory/index.js';\nimport {\n  appendMemorySignal,\n  deleteMemoryRecord,\n  getMemoryRecord,\n  listMemoryRecords,\n  searchMemoryRecords,\n  upsertMemoryRecord,\n} from '../../storage/sqlite/index.js';\nimport type {\n  MemoryDeleteRequest,\n  MemoryListRequest,\n  MemoryReadRequest,\n  MemoryReadResult,\n  MemoryRecord,\n  MemorySearchRequest,\n  MemorySearchResult,\n  MemoryUpdateRequest,\n  MemoryWriteRequest,\n  MemoryWriteResult,\n  MemorySyncEvent,\n} from './types.js';\n\n/**\n * Builtin local memory provider backed by profile memory, agent-home curated files,\n * and the local SQLite FTS index.\n */\nexport class BuiltinMemoryProvider implements MemoryProvider {\n  readonly id = 'local';\n  readonly displayName = 'Local Knowledge Store';\n  readonly capabilities = {\n    search: true,\n    read: true,\n    write: true,\n    update: true,\n    delete: true,\n    keywordSearch: true,\n    semanticSearch: false,\n    hybridSearch: false,\n    citations: true,\n    sync: false,\n    local: true,\n  };\n\n  private workspaceDir = '';\n  private agentId = 'main';\n\n  constructor(private readonly store: BuiltinMemoryStore) {}\n\n  isAvailable(): boolean {\n    return true;\n  }\n\n  async initialize(_sessionId: string, options?: MemoryProviderInitOptions): Promise<void> {\n    this.workspaceDir = options?.workspace ?? options?.agentWorkspace ?? this.store.workspaceDir;\n    this.agentId = normalizeAgentId(String(options?.agentId ?? this.agentId));\n  }\n\n  systemPromptBlock(): string {\n    return '';\n  }\n\n  queuePrefetch(): void {}\n\n  getToolSchemas() {\n    return [];\n  }\n\n  async search(request: MemorySearchRequest): Promise<MemorySearchResult[]> {\n    const workspaceId = request.scope?.workspaceId ?? this.workspaceDir;\n    const recordHits = searchMemoryRecords({\n        query: request.query,\n        visibleToSessionKey: request.scope?.sessionKey,\n        unscopedSessionOnly: request.scope?.sessionKey == null,\n        visibleToProjectId: request.scope?.projectId,\n        unscopedProjectOnly: request.scope?.projectId == null,\n        providerId: this.id,\n        kinds: request.kinds,\n        maxResults: request.maxResults,\n        minScore: request.minScore,\n      })\n      .filter((result) => this.canReadRecord(result.record, request.scope))\n      .sort((left, right) => right.score - left.score)\n      .slice(0, request.maxResults ?? 5);\n    if (recordHits.length > 0) {\n      return recordHits;\n    }\n\n    const results = await memorySearch(this.workspaceDir, request.query, {\n      maxResults: request.maxResults,\n      minScore: request.minScore,\n      memoriesDir: this.store.memoriesDir,\n      userMemoryPath: this.store.userMemoryPath,\n    });\n    return results.map((entry) => {\n      const start = entry.lineNumbers[0] ?? 1;\n      const end = entry.lineNumbers[entry.lineNumbers.length - 1] ?? start;\n      const id = `${entry.file}#L${start}-L${end}`;\n      const kind = inferKindFromPath(entry.file);\n      const record = upsertMemoryRecord({\n        id,\n        providerId: this.id,\n        kind,\n        sourceAgentId: this.agentId,\n        workspaceId,\n        content: entry.lines,\n        source: {\n          provider: this.id,\n          path: entry.file,\n          lineStart: start,\n          lineEnd: end,\n        },\n        confidence: entry.score,\n      });\n      return {\n        record,\n        score: entry.score,\n        snippet: entry.lines,\n        citation: {\n          providerId: this.id,\n          recordId: id,\n          path: entry.file,\n          lineStart: start,\n          lineEnd: end,\n        },\n      };\n    });\n  }\n\n  async read(request: MemoryReadRequest): Promise<MemoryReadResult | null> {\n    if (request.id && !request.path) {\n      const existing = getMemoryRecord(request.id);\n      if (existing && this.canReadRecord(existing, request.scope)) {\n        return { record: existing };\n      }\n      if (existing) return null;\n    }\n    const result = memoryGet(\n      this.workspaceDir,\n      request.path ?? request.id ?? '',\n      request.from,\n      request.lines,\n      this.store.memoriesDir,\n      this.store.userMemoryPath,\n    );\n    if (!result) return null;\n    const path = request.path ?? request.id ?? '';\n    const record = upsertMemoryRecord({\n      id: `${path}#L${result.lineNumbers.start}-L${result.lineNumbers.end}`,\n      providerId: this.id,\n      kind: inferKindFromPath(path),\n      sourceAgentId: this.agentId,\n      workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n      content: result.content,\n      source: {\n        provider: this.id,\n        path,\n        lineStart: result.lineNumbers.start,\n        lineEnd: result.lineNumbers.end,\n      },\n    });\n    return {\n      record,\n      lineNumbers: result.lineNumbers,\n    };\n  }\n\n  async get(id: string): Promise<MemoryRecord | null> {\n    const parsed = parseLineAddress(id);\n    const result = await this.read({\n      path: parsed.path,\n      from: parsed.lineStart,\n      lines: parsed.lineEnd != null ? parsed.lineEnd - parsed.lineStart + 1 : undefined,\n    });\n    return result?.record ?? null;\n  }\n\n  async list(request: MemoryListRequest): Promise<MemoryRecord[]> {\n    const records = listMemoryRecords({\n      providerId: this.id,\n      workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n      visibleToSessionKey: request.scope?.sessionKey,\n      visibleToProjectId: request.scope?.projectId,\n      kind: request.kind,\n      status: request.status,\n      canonicalKey: request.canonicalKey,\n      limit: 200,\n    });\n    if (records.length > 0 || request.kind || request.status || request.canonicalKey) {\n      return request.target\n        ? records.filter((record) => targetForKind(record.kind) === request.target)\n        : records;\n    }\n\n    const target = request.target ?? (request.kind === 'user_profile' ? 'user' : 'memory');\n    return this.store.getLiveEntries(target).map((content, index) =>\n      upsertMemoryRecord({\n        id: `curated:${target}:${index + 1}`,\n        providerId: this.id,\n        kind: target === 'user' ? 'user_profile' : 'curated_note',\n        sourceAgentId: this.agentId,\n        workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n        content,\n        source: {\n          provider: this.id,\n          path: sourcePathForTarget(target),\n        },\n      }),\n    );\n  }\n\n  async write(request: MemoryWriteRequest): Promise<MemoryWriteResult> {\n    const target = request.target ?? (request.kind === 'user_profile' ? 'user' : 'memory');\n    if (request.status === 'candidate') {\n      const record = upsertMemoryRecord({\n        providerId: this.id,\n        kind: request.kind,\n        sourceAgentId: this.agentId,\n        workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n        sessionKey: request.scope?.sessionKey,\n        projectId: request.scope?.projectId,\n        content: request.content,\n        source: {\n          ...(request.source ?? {}),\n          provider: this.id,\n        },\n        confidence: request.confidence,\n        tags: request.tags,\n        status: 'candidate',\n        sensitivity: request.sensitivity,\n        canonicalKey: request.canonicalKey,\n        explicitness: request.explicitness,\n        durability: request.durability,\n        importance: request.importance,\n        disclosurePolicy: request.disclosurePolicy,\n        evidence: request.evidence,\n        validFrom: request.validFrom,\n        validTo: request.validTo,\n        reviewAfter: request.reviewAfter,\n        expiresAt: request.expiresAt,\n        supersedesRecordId: request.supersedesRecordId,\n        conflictGroupId: request.conflictGroupId,\n      });\n      return {\n        success: true,\n        message: 'Memory candidate added to inbox',\n        record,\n      };\n    }\n    const result = await this.store.add(target, request.content);\n    if (!result.success) return { success: false, error: result.error };\n    return {\n      success: true,\n      message: result.message,\n      record: upsertMemoryRecord({\n        id: `curated:${target}:${Date.now()}`,\n        providerId: this.id,\n        kind: request.kind,\n        sourceAgentId: this.agentId,\n        workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n        sessionKey: request.scope?.sessionKey,\n        content: request.content,\n        source: {\n          ...(request.source ?? {}),\n          provider: this.id,\n          path: sourcePathForTarget(target),\n        },\n        tags: request.tags,\n        canonicalKey: request.canonicalKey,\n        explicitness: request.explicitness,\n        durability: request.durability,\n        importance: request.importance,\n        disclosurePolicy: request.disclosurePolicy,\n        evidence: request.evidence,\n        validFrom: request.validFrom,\n        validTo: request.validTo,\n        reviewAfter: request.reviewAfter,\n        expiresAt: request.expiresAt,\n        supersedesRecordId: request.supersedesRecordId,\n        conflictGroupId: request.conflictGroupId,\n      }),\n    };\n  }\n\n  async update(request: MemoryUpdateRequest): Promise<MemoryWriteResult> {\n    const target = request.target ?? 'memory';\n    const result = await this.store.replace(target, request.matchText ?? request.id ?? '', request.content);\n    if (!result.success) return { success: false, error: result.error };\n    if (request.id) {\n      const existing = getMemoryRecord(request.id);\n      upsertMemoryRecord({\n        id: request.id,\n        providerId: this.id,\n        kind: existing?.kind ?? (target === 'user' ? 'user_profile' : 'curated_note'),\n        sourceAgentId: existing?.provenance.sourceAgentId ?? this.agentId,\n        workspaceId: existing?.scope.workspaceId ?? request.scope?.workspaceId ?? this.workspaceDir,\n        sessionKey: existing?.scope.sessionKey ?? request.scope?.sessionKey,\n        content: request.content,\n        source: existing?.source ?? { provider: this.id, path: sourcePathForTarget(target) },\n        tags: existing?.tags,\n      });\n    } else if (request.matchText) {\n      for (const existing of listMemoryRecords({\n        providerId: this.id,\n        workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n        kind: target === 'user' ? 'user_profile' : 'curated_note',\n        limit: 200,\n      })) {\n        if (!existing.content.includes(request.matchText)) continue;\n        upsertMemoryRecord({\n          id: existing.id,\n          providerId: this.id,\n          kind: existing.kind,\n          sourceAgentId: existing.provenance.sourceAgentId,\n          workspaceId: existing.scope.workspaceId,\n          sessionKey: existing.scope.sessionKey,\n          content: request.content,\n          source: existing.source,\n          tags: existing.tags,\n        });\n      }\n    }\n    return { success: true, message: result.message };\n  }\n\n  async delete(request: MemoryDeleteRequest): Promise<MemoryWriteResult> {\n    const target = request.target ?? 'memory';\n    const result = await this.store.remove(target, request.matchText ?? request.id ?? '');\n    if (!result.success) return { success: false, error: result.error };\n    if (request.id) {\n      deleteMemoryRecord(request.id);\n    } else if (request.matchText) {\n      for (const existing of listMemoryRecords({\n        providerId: this.id,\n        workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n        kind: target === 'user' ? 'user_profile' : 'curated_note',\n        limit: 200,\n      })) {\n        if (existing.content.includes(request.matchText)) {\n          deleteMemoryRecord(existing.id);\n        }\n      }\n    }\n    return { success: true, message: result.message };\n  }\n\n  sync(event: MemorySyncEvent): void {\n    if (event.type !== 'signal') return;\n    appendMemorySignal({\n      signal: event.signal,\n      providerId: this.id,\n      sourceAgentId: this.agentId,\n      workspaceId: this.workspaceDir,\n      sessionKey:\n        typeof event.signal.metadata?.sessionKey === 'string'\n          ? event.signal.metadata.sessionKey\n          : undefined,\n    });\n  }\n\n  async shutdown(): Promise<void> {}\n\n  private canReadRecord(record: MemoryRecord, scope: MemoryReadRequest['scope']): boolean {\n    if (record.scope.sessionKey && record.scope.sessionKey !== scope?.sessionKey) return false;\n    if (record.scope.projectId && record.scope.projectId !== scope?.projectId) return false;\n    return true;\n  }\n}\n\nfunction inferKindFromPath(path: string): MemoryRecord['kind'] {\n  const normalized = path.replace(/\\\\/g, '/');\n  if (normalized === 'user/MEMORY.md' || normalized.endsWith('/user/MEMORY.md')) return 'user_profile';\n  if (/^memory\\/\\d{4}-\\d{2}-\\d{2}\\.md$/.test(normalized)) return 'daily_note';\n  if (normalized.endsWith('MEMORY.md')) return 'curated_note';\n  return 'workspace_fact';\n}\n\nfunction targetForKind(kind: MemoryRecord['kind']): 'memory' | 'user' {\n  return kind === 'user_profile' || kind === 'preference' || kind === 'relationship' ||\n    kind === 'routine' || kind === 'personal_logistics'\n    ? 'user'\n    : 'memory';\n}\n\nfunction sourcePathForTarget(target: 'memory' | 'user'): string {\n  return target === 'user' ? 'user/MEMORY.md' : 'MEMORY.md';\n}\n\nfunction parseLineAddress(id: string): { path: string; lineStart?: number; lineEnd?: number } {\n  const match = /^(.*)#L(\\d+)(?:-L(\\d+))?$/.exec(id);\n  if (!match) return { path: id };\n  const lineStart = Number.parseInt(match[2] ?? '1', 10);\n  const lineEnd = Number.parseInt(match[3] ?? match[2] ?? '1', 10);\n  return {\n    path: match[1] ?? id,\n    lineStart: Number.isFinite(lineStart) ? lineStart : undefined,\n    lineEnd: Number.isFinite(lineEnd) ? lineEnd : undefined,\n  };\n}\n"],"mappings":"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"}

package/dist/src/agent/memory/context/planner.js

@@ -1,6 +1,7 @@
 import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
-import { appendMemoryTraceEvent } from "../../../storage/sqlite/memory-records-repository.js";
+import { appendMemoryTraceEvent, hasUnresolvedMemoryConflict } from "../../../storage/sqlite/memory-records-repository.js";
+import { consumeMemoryReferenceConsent, ensureMemoryReferenceConsentRequest, hasMemoryReferenceConsent } from "../../../storage/sqlite/memory-reference-consent-repository.js";
 import "../../../storage/sqlite/index.js";
 import { readAgentMessageContent } from "../agent-message-access.js";
 import { buildUserContextBlock } from "../context-fence.js";
@@ -25,11 +26,13 @@ function sectionFor(record) {
 	if (record.kind === "preference" || record.kind === "user_profile" || record.kind === "relationship" || record.kind === "routine" || record.kind === "personal_logistics" || record.kind === "tool_preference") return "interaction";
 	return "task";
 }
-function rejectReason(record, now) {
+function rejectReason(record, now, hasReferenceConsent) {
+	if (record.tags?.includes("playbook:disabled")) return "disabled";
+	if (record.conflictGroupId && hasUnresolvedMemoryConflict(record.conflictGroupId)) return "conflict";
 	if (record.validFrom && Date.parse(record.validFrom) > now) return "not_yet_valid";
 	if (record.validTo && Date.parse(record.validTo) < now || record.expiresAt && Date.parse(record.expiresAt) < now) return "expired";
 	if (record.sensitivity === "secret" || record.sensitivity === "regulated") return "sensitive";
-	if (record.disclosurePolicy === "ask_before_reference") return "requires_consent";
+	if (record.disclosurePolicy === "ask_before_reference" && !hasReferenceConsent) return "requires_consent";
 	if (record.status === "needs_review" || record.status === "stale" || resolveMemoryStability(record, now).reviewDue) return "needs_review";
 }
 function scoreResult(result, now) {
@@ -40,10 +43,9 @@ function scoreResult(result, now) {
 }
 function citationFor(result, requesterAgentId) {
 	const base = result.citation.path ?? `${result.citation.providerId}:${result.citation.recordId}`;
-	const ownerPrefix = result.record.scope.agentId !== requesterAgentId ? `shared-from-agent:${result.record.scope.agentId} ` : "";
-	if (result.citation.lineStart == null) return `${ownerPrefix}${base}`;
+	if (result.citation.lineStart == null) return base;
 	const end = result.citation.lineEnd && result.citation.lineEnd !== result.citation.lineStart ? `-L${result.citation.lineEnd}` : "";
-	return `${ownerPrefix}${base}#L${result.citation.lineStart}${end}`;
+	return `${base}#L${result.citation.lineStart}${end}`;
 }
 function evidenceLabel(item) {
 	if (item.origin === "told_by_user") return "The user explicitly shared this";
@@ -91,11 +93,12 @@ var UserContextPlanner = class {
 			modelMessage: params.userMessage,
 			items: [],
 			rejected: [],
+			consentRequests: [],
 			estimatedTokens: 0
 		};
 		const started = Date.now();
 		const scope = {
-			agentId: params.agentId,
+			userId: "local-owner",
 			sessionKey: params.sessionKey
 		};
 		const [taskResults, baselineLists] = await Promise.all([params.memoryManager.search({
@@ -126,6 +129,7 @@ var UserContextPlanner = class {
 		const now = Date.now();
 		const excluded = new Set(params.excludedRecordIds ?? []);
 		const rejected = [];
+		const consentRequests = [];
 		const ranked = results.filter((result) => !excluded.has(result.record.id)).map((result) => ({
 			result,
 			score: scoreResult(result, now)
@@ -133,12 +137,27 @@ var UserContextPlanner = class {
 		const items = [];
 		let usedChars = 0;
 		for (const { result, score } of ranked) {
-			const reason = rejectReason(result.record, now) ?? (score < .25 ? "low_score" : void 0);
+			const needsConsent = result.record.disclosurePolicy === "ask_before_reference" && result.record.sensitivity !== "secret" && result.record.sensitivity !== "regulated";
+			const hasReferenceConsent = needsConsent ? hasMemoryReferenceConsent(result.record.id, params.sessionKey) : false;
+			const reason = rejectReason(result.record, now, hasReferenceConsent) ?? (score < .25 ? "low_score" : void 0);
 			if (reason) {
 				rejected.push({
 					recordId: result.record.id,
 					reason
 				});
+				if (reason === "requires_consent") {
+					const request = ensureMemoryReferenceConsentRequest({
+						recordId: result.record.id,
+						sessionKey: params.sessionKey,
+						purpose: query
+					});
+					consentRequests.push({
+						id: request.id,
+						recordId: request.recordId,
+						statement: result.record.content,
+						purpose: request.purpose
+					});
+				}
 				continue;
 			}
 			const content = result.snippet.trim();
@@ -149,6 +168,24 @@ var UserContextPlanner = class {
 				});
 				continue;
 			}
+			if (needsConsent && !consumeMemoryReferenceConsent(result.record.id, params.sessionKey)) {
+				rejected.push({
+					recordId: result.record.id,
+					reason: "requires_consent"
+				});
+				const request = ensureMemoryReferenceConsentRequest({
+					recordId: result.record.id,
+					sessionKey: params.sessionKey,
+					purpose: query
+				});
+				consentRequests.push({
+					id: request.id,
+					recordId: request.recordId,
+					statement: result.record.content,
+					purpose: request.purpose
+				});
+				continue;
+			}
 			usedChars += content.length;
 			items.push({
 				recordId: result.record.id,
@@ -169,7 +206,8 @@ var UserContextPlanner = class {
 			const sectionItems = items.filter((item) => item.section === section);
 			if (sectionItems.length > 0) sections.push(`${title}:\n${sectionItems.map((item) => `- ${item.content}\n  Evidence: ${evidenceLabel(item)}`).join("\n")}`);
 		}
-		const block = buildUserContextBlock(sections.join("\n\n"));
+		const consentNotice = consentRequests.length > 0 ? "A relevant saved understanding requires the user’s explicit permission before it can be referenced. Do not infer or reveal its contents. Briefly ask the user to approve the pending item in You > Understanding, then continue without it." : "";
+		const block = [buildUserContextBlock(sections.join("\n\n")), consentNotice].filter(Boolean).join("\n\n");
 		try {
 			appendMemoryTraceEvent({
 				traceId,
@@ -203,6 +241,7 @@ var UserContextPlanner = class {
 			modelMessage: prependContext(params.userMessage, block),
 			items,
 			rejected,
+			consentRequests,
 			estimatedTokens: Math.ceil(block.length / 4)
 		};
 	}