@xopcai/xopc 0.0.117 → 0.0.119

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 { 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 agent-home curated files, workspace MEMORY.md,\n * daily notes, and the local SQLite FTS index.\n */\nexport class BuiltinMemoryProvider implements MemoryProvider {\n  readonly id = 'local';\n  readonly displayName = 'Local Markdown Memory';\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 = String(options?.agentId ?? this.agentId);\n  }\n\n  systemPromptBlock(): string {\n    return '';\n  }\n\n  async prefetch(): Promise<string> {\n    return '';\n  }\n\n  queuePrefetch(): void {}\n\n  getToolSchemas() {\n    return [];\n  }\n\n  async search(request: MemorySearchRequest): Promise<MemorySearchResult[]> {\n    const agentId = request.scope?.agentId ?? this.agentId;\n    const workspaceId = request.scope?.workspaceId ?? this.workspaceDir;\n    const recordHits = searchMemoryRecords({\n      query: request.query,\n      agentId,\n      workspaceId,\n      providerId: this.id,\n      kinds: request.kinds,\n      maxResults: request.maxResults,\n      minScore: request.minScore,\n    });\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      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,\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) {\n        return { record: existing };\n      }\n    }\n    const result = memoryGet(\n      this.workspaceDir,\n      request.path ?? request.id ?? '',\n      request.from,\n      request.lines,\n      this.store.memoriesDir,\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: request.scope?.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      kind: request.kind,\n      limit: 200,\n    });\n    if (records.length > 0 || request.kind) {\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: target === 'user' ? 'USER.md' : 'MEMORY.md',\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 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: target === 'user' ? 'user_profile' : request.kind,\n        agentId: request.scope?.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: target === 'user' ? 'USER.md' : 'MEMORY.md',\n        },\n        tags: request.tags,\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' : '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: target === 'user' ? 'USER.md' : 'MEMORY.md' },\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 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\nfunction inferKindFromPath(path: string): MemoryRecord['kind'] {\n  if (path.endsWith('USER.md')) return 'user_profile';\n  if (path.endsWith('MEMORY.md')) return 'agent_note';\n  if (/^memory\\/\\d{4}-\\d{2}-\\d{2}\\.md$/.test(path)) return 'daily_note';\n  return 'workspace_fact';\n}\n\nfunction targetForKind(kind: MemoryRecord['kind']): 'memory' | 'user' {\n  return kind === 'user_profile' ? 'user' : 'memory';\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 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 agent-home curated files, workspace MEMORY.md,\n * daily notes, and the local SQLite FTS index.\n */\nexport class BuiltinMemoryProvider implements MemoryProvider {\n  readonly id = 'local';\n  readonly displayName = 'Local Markdown Memory';\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 = String(options?.agentId ?? this.agentId);\n  }\n\n  systemPromptBlock(): string {\n    return '';\n  }\n\n  async prefetch(): Promise<string> {\n    return '';\n  }\n\n  queuePrefetch(): void {}\n\n  getToolSchemas() {\n    return [];\n  }\n\n  async search(request: MemorySearchRequest): Promise<MemorySearchResult[]> {\n    const agentId = request.scope?.agentId ?? this.agentId;\n    const workspaceId = request.scope?.workspaceId ?? this.workspaceDir;\n    const recordHits = searchMemoryRecords({\n      query: request.query,\n      agentId,\n      workspaceId,\n      providerId: this.id,\n      kinds: request.kinds,\n      maxResults: request.maxResults,\n      minScore: request.minScore,\n    });\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,\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,\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) {\n        return { record: existing };\n      }\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: request.scope?.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      kind: request.kind,\n      limit: 200,\n    });\n    if (records.length > 0 || request.kind) {\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    if (request.status === 'candidate') {\n      const record = upsertMemoryRecord({\n        providerId: this.id,\n        kind: target === 'user' ? 'user_profile' : request.kind,\n        agentId: request.scope?.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        confidence: request.confidence,\n        tags: request.tags,\n        status: 'candidate',\n        sensitivity: request.sensitivity,\n        evidence: request.evidence,\n        reviewAfter: request.reviewAfter,\n        expiresAt: request.expiresAt,\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: target === 'user' ? 'user_profile' : request.kind,\n        agentId: request.scope?.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      }),\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' : '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 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\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' ? 'user' : '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":";;;;;;;;AA6BA,IAAa,wBAAb,MAA6D;CAC3D,KAAc;CACd,cAAuB;CACvB,eAAwB;EACtB,QAAQ;EACR,MAAM;EACN,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,eAAe;EACf,gBAAgB;EAChB,cAAc;EACd,WAAW;EACX,MAAM;EACN,OAAO;EACR;CAED,eAAuB;CACvB,UAAkB;CAElB,YAAY,OAA4C;AAA3B,OAAA,QAAA;;CAE7B,cAAuB;AACrB,SAAO;;CAGT,MAAM,WAAW,YAAoB,SAAoD;AACvF,OAAK,eAAe,SAAS,aAAa,SAAS,kBAAkB,KAAK,MAAM;AAChF,OAAK,UAAU,OAAO,SAAS,WAAW,KAAK,QAAQ;;CAGzD,oBAA4B;AAC1B,SAAO;;CAGT,MAAM,WAA4B;AAChC,SAAO;;CAGT,gBAAsB;CAEtB,iBAAiB;AACf,SAAO,EAAE;;CAGX,MAAM,OAAO,SAA6D;EACxE,MAAM,UAAU,QAAQ,OAAO,WAAW,KAAK;EAC/C,MAAM,cAAc,QAAQ,OAAO,eAAe,KAAK;EACvD,MAAM,aAAa,oBAAoB;GACrC,OAAO,QAAQ;GACf;GACA;GACA,YAAY,KAAK;GACjB,OAAO,QAAQ;GACf,YAAY,QAAQ;GACpB,UAAU,QAAQ;GACnB,CAAC;AACF,MAAI,WAAW,SAAS,EACtB,QAAO;AAUT,UAAO,MAPe,aAAa,KAAK,cAAc,QAAQ,OAAO;GACnE,YAAY,QAAQ;GACpB,UAAU,QAAQ;GAClB,aAAa,KAAK,MAAM;GACxB,gBAAgB,KAAK,MAAM;GAC3B;GACD,CAAC,EACa,KAAK,UAAU;GAC5B,MAAM,QAAQ,MAAM,YAAY,MAAM;GACtC,MAAM,MAAM,MAAM,YAAY,MAAM,YAAY,SAAS,MAAM;GAC/D,MAAM,KAAK,GAAG,MAAM,KAAK,IAAI,MAAM,IAAI;GACvC,MAAM,OAAO,kBAAkB,MAAM,KAAK;AAgB1C,UAAO;IACL,QAhBa,mBAAmB;KAChC;KACA,YAAY,KAAK;KACjB;KACA;KACA;KACA,SAAS,MAAM;KACf,QAAQ;MACN,UAAU,KAAK;MACf,MAAM,MAAM;MACZ,WAAW;MACX,SAAS;MACV;KACD,YAAY,MAAM;KACnB,CAEO;IACN,OAAO,MAAM;IACb,SAAS,MAAM;IACf,UAAU;KACR,YAAY,KAAK;KACjB,UAAU;KACV,MAAM,MAAM;KACZ,WAAW;KACX,SAAS;KACV;IACF;IACD;;CAGJ,MAAM,KAAK,SAA8D;AACvE,MAAI,QAAQ,MAAM,CAAC,QAAQ,MAAM;GAC/B,MAAM,WAAW,gBAAgB,QAAQ,GAAG;AAC5C,OAAI,SACF,QAAO,EAAE,QAAQ,UAAU;;EAG/B,MAAM,SAAS,UACb,KAAK,cACL,QAAQ,QAAQ,QAAQ,MAAM,IAC9B,QAAQ,MACR,QAAQ,OACR,KAAK,MAAM,aACX,KAAK,MAAM,eACZ;AACD,MAAI,CAAC,OAAQ,QAAO;EACpB,MAAM,OAAO,QAAQ,QAAQ,QAAQ,MAAM;AAe3C,SAAO;GACL,QAfa,mBAAmB;IAChC,IAAI,GAAG,KAAK,IAAI,OAAO,YAAY,MAAM,IAAI,OAAO,YAAY;IAChE,YAAY,KAAK;IACjB,MAAM,kBAAkB,KAAK;IAC7B,SAAS,QAAQ,OAAO,WAAW,KAAK;IACxC,aAAa,QAAQ,OAAO,eAAe,KAAK;IAChD,SAAS,OAAO;IAChB,QAAQ;KACN,UAAU,KAAK;KACf;KACA,WAAW,OAAO,YAAY;KAC9B,SAAS,OAAO,YAAY;KAC7B;IACF,CAEO;GACN,aAAa,OAAO;GACrB;;CAGH,MAAM,IAAI,IAA0C;EAClD,MAAM,SAAS,iBAAiB,GAAG;AAMnC,UAAO,MALc,KAAK,KAAK;GAC7B,MAAM,OAAO;GACb,MAAM,OAAO;GACb,OAAO,OAAO,WAAW,OAAO,OAAO,UAAU,OAAO,YAAY,IAAI,KAAA;GACzE,CAAC,GACa,UAAU;;CAG3B,MAAM,KAAK,SAAqD;EAC9D,MAAM,UAAU,kBAAkB;GAChC,YAAY,KAAK;GACjB,SAAS,QAAQ,OAAO,WAAW,KAAK;GACxC,aAAa,QAAQ,OAAO,eAAe,KAAK;GAChD,MAAM,QAAQ;GACd,OAAO;GACR,CAAC;AACF,MAAI,QAAQ,SAAS,KAAK,QAAQ,KAChC,QAAO,QAAQ,SACX,QAAQ,QAAQ,WAAW,cAAc,OAAO,KAAK,KAAK,QAAQ,OAAO,GACzE;EAGN,MAAM,SAAS,QAAQ,WAAW,QAAQ,SAAS,iBAAiB,SAAS;AAC7E,SAAO,KAAK,MAAM,eAAe,OAAO,CAAC,KAAK,SAAS,UACrD,mBAAmB;GACjB,IAAI,WAAW,OAAO,GAAG,QAAQ;GACjC,YAAY,KAAK;GACjB,MAAM,WAAW,SAAS,iBAAiB;GAC3C,SAAS,QAAQ,OAAO,WAAW,KAAK;GACxC,aAAa,QAAQ,OAAO,eAAe,KAAK;GAChD;GACA,QAAQ;IACN,UAAU,KAAK;IACf,MAAM,oBAAoB,OAAO;IAClC;GACF,CAAC,CACH;;CAGH,MAAM,MAAM,SAAyD;EACnE,MAAM,SAAS,QAAQ,WAAW,QAAQ,SAAS,iBAAiB,SAAS;AAC7E,MAAI,QAAQ,WAAW,YAqBrB,QAAO;GACL,SAAS;GACT,SAAS;GACT,QAvBa,mBAAmB;IAChC,YAAY,KAAK;IACjB,MAAM,WAAW,SAAS,iBAAiB,QAAQ;IACnD,SAAS,QAAQ,OAAO,WAAW,KAAK;IACxC,aAAa,QAAQ,OAAO,eAAe,KAAK;IAChD,YAAY,QAAQ,OAAO;IAC3B,SAAS,QAAQ;IACjB,QAAQ;KACN,GAAI,QAAQ,UAAU,EAAE;KACxB,UAAU,KAAK;KACf,MAAM,oBAAoB,OAAO;KAClC;IACD,YAAY,QAAQ;IACpB,MAAM,QAAQ;IACd,QAAQ;IACR,aAAa,QAAQ;IACrB,UAAU,QAAQ;IAClB,aAAa,QAAQ;IACrB,WAAW,QAAQ;IACpB,CAIO;GACP;EAEH,MAAM,SAAS,MAAM,KAAK,MAAM,IAAI,QAAQ,QAAQ,QAAQ;AAC5D,MAAI,CAAC,OAAO,QAAS,QAAO;GAAE,SAAS;GAAO,OAAO,OAAO;GAAO;AACnE,SAAO;GACL,SAAS;GACT,SAAS,OAAO;GAChB,QAAQ,mBAAmB;IACzB,IAAI,WAAW,OAAO,GAAG,KAAK,KAAK;IACnC,YAAY,KAAK;IACjB,MAAM,WAAW,SAAS,iBAAiB,QAAQ;IACnD,SAAS,QAAQ,OAAO,WAAW,KAAK;IACxC,aAAa,QAAQ,OAAO,eAAe,KAAK;IAChD,YAAY,QAAQ,OAAO;IAC3B,SAAS,QAAQ;IACjB,QAAQ;KACN,GAAI,QAAQ,UAAU,EAAE;KACxB,UAAU,KAAK;KACf,MAAM,oBAAoB,OAAO;KAClC;IACD,MAAM,QAAQ;IACf,CAAC;GACH;;CAGH,MAAM,OAAO,SAA0D;EACrE,MAAM,SAAS,QAAQ,UAAU;EACjC,MAAM,SAAS,MAAM,KAAK,MAAM,QAAQ,QAAQ,QAAQ,aAAa,QAAQ,MAAM,IAAI,QAAQ,QAAQ;AACvG,MAAI,CAAC,OAAO,QAAS,QAAO;GAAE,SAAS;GAAO,OAAO,OAAO;GAAO;AACnE,MAAI,QAAQ,IAAI;GACd,MAAM,WAAW,gBAAgB,QAAQ,GAAG;AAC5C,sBAAmB;IACjB,IAAI,QAAQ;IACZ,YAAY,KAAK;IACjB,MAAM,UAAU,SAAS,WAAW,SAAS,iBAAiB;IAC9D,SAAS,UAAU,MAAM,WAAW,QAAQ,OAAO,WAAW,KAAK;IACnE,aAAa,UAAU,MAAM,eAAe,QAAQ,OAAO,eAAe,KAAK;IAC/E,YAAY,UAAU,MAAM,cAAc,QAAQ,OAAO;IACzD,SAAS,QAAQ;IACjB,QAAQ,UAAU,UAAU;KAAE,UAAU,KAAK;KAAI,MAAM,oBAAoB,OAAO;KAAE;IACpF,MAAM,UAAU;IACjB,CAAC;aACO,QAAQ,UACjB,MAAK,MAAM,YAAY,kBAAkB;GACvC,YAAY,KAAK;GACjB,SAAS,QAAQ,OAAO,WAAW,KAAK;GACxC,aAAa,QAAQ,OAAO,eAAe,KAAK;GAChD,MAAM,WAAW,SAAS,iBAAiB;GAC3C,OAAO;GACR,CAAC,EAAE;AACF,OAAI,CAAC,SAAS,QAAQ,SAAS,QAAQ,UAAU,CAAE;AACnD,sBAAmB;IACjB,IAAI,SAAS;IACb,YAAY,KAAK;IACjB,MAAM,SAAS;IACf,SAAS,SAAS,MAAM;IACxB,aAAa,SAAS,MAAM;IAC5B,YAAY,SAAS,MAAM;IAC3B,SAAS,QAAQ;IACjB,QAAQ,SAAS;IACjB,MAAM,SAAS;IAChB,CAAC;;AAGN,SAAO;GAAE,SAAS;GAAM,SAAS,OAAO;GAAS;;CAGnD,MAAM,OAAO,SAA0D;EACrE,MAAM,SAAS,QAAQ,UAAU;EACjC,MAAM,SAAS,MAAM,KAAK,MAAM,OAAO,QAAQ,QAAQ,aAAa,QAAQ,MAAM,GAAG;AACrF,MAAI,CAAC,OAAO,QAAS,QAAO;GAAE,SAAS;GAAO,OAAO,OAAO;GAAO;AACnE,MAAI,QAAQ,GACV,oBAAmB,QAAQ,GAAG;WACrB,QAAQ;QACZ,MAAM,YAAY,kBAAkB;IACvC,YAAY,KAAK;IACjB,SAAS,QAAQ,OAAO,WAAW,KAAK;IACxC,aAAa,QAAQ,OAAO,eAAe,KAAK;IAChD,MAAM,WAAW,SAAS,iBAAiB;IAC3C,OAAO;IACR,CAAC,CACA,KAAI,SAAS,QAAQ,SAAS,QAAQ,UAAU,CAC9C,oBAAmB,SAAS,GAAG;;AAIrC,SAAO;GAAE,SAAS;GAAM,SAAS,OAAO;GAAS;;CAGnD,KAAK,OAA8B;AACjC,MAAI,MAAM,SAAS,SAAU;AAC7B,qBAAmB;GACjB,QAAQ,MAAM;GACd,YAAY,KAAK;GACjB,SAAS,KAAK;GACd,aAAa,KAAK;GAClB,YACE,OAAO,MAAM,OAAO,UAAU,eAAe,WACzC,MAAM,OAAO,SAAS,aACtB,KAAA;GACP,CAAC;;CAGJ,MAAM,WAA0B;;AAGlC,SAAS,kBAAkB,MAAoC;CAC7D,MAAM,aAAa,KAAK,QAAQ,OAAO,IAAI;AAC3C,KAAI,eAAe,oBAAoB,WAAW,SAAS,kBAAkB,CAAE,QAAO;AACtF,KAAI,kCAAkC,KAAK,WAAW,CAAE,QAAO;AAC/D,KAAI,WAAW,SAAS,YAAY,CAAE,QAAO;AAC7C,QAAO;;AAGT,SAAS,cAAc,MAA+C;AACpE,QAAO,SAAS,iBAAiB,SAAS;;AAG5C,SAAS,oBAAoB,QAAmC;AAC9D,QAAO,WAAW,SAAS,mBAAmB;;AAGhD,SAAS,iBAAiB,IAAoE;CAC5F,MAAM,QAAQ,4BAA4B,KAAK,GAAG;AAClD,KAAI,CAAC,MAAO,QAAO,EAAE,MAAM,IAAI;CAC/B,MAAM,YAAY,OAAO,SAAS,MAAM,MAAM,KAAK,GAAG;CACtD,MAAM,UAAU,OAAO,SAAS,MAAM,MAAM,MAAM,MAAM,KAAK,GAAG;AAChE,QAAO;EACL,MAAM,MAAM,MAAM;EAClB,WAAW,OAAO,SAAS,UAAU,GAAG,YAAY,KAAA;EACpD,SAAS,OAAO,SAAS,QAAQ,GAAG,UAAU,KAAA;EAC/C"}

package/dist/src/agent/memory/candidate-extractor.d.ts

@@ -0,0 +1,6 @@
+import type { MemoryWriteRequest } from './types.js';
+export declare function proposeMemoryCandidatesFromTurn(params: {
+    userContent: string;
+    assistantContent?: string;
+    sessionKey?: string;
+}): MemoryWriteRequest[];

package/dist/src/agent/memory/candidate-extractor.js

@@ -0,0 +1,60 @@
+//#region src/agent/memory/candidate-extractor.ts
+const MAX_CANDIDATE_CHARS = 600;
+const EXPLICIT_PATTERNS = [
+	/\b(?:please\s+)?remember(?:\s+that)?\s+(.+)/i,
+	/\bkeep\s+in\s+mind(?:\s+that)?\s+(.+)/i,
+	/(?:请)?记住[：:\s]*(.+)/,
+	/以后(?:都)?(?:请)?[：:\s]*(.+)/,
+	/下次(?:请)?[：:\s]*(.+)/
+];
+function cleanCandidateContent(raw) {
+	return raw.replace(/^["'“”‘’\s]+|["'“”‘’\s]+$/g, "").replace(/\s+/g, " ").trim().slice(0, MAX_CANDIDATE_CHARS);
+}
+function inferKind(content) {
+	const lower = content.toLowerCase();
+	if (/\b(prefer|preference|like)\b/i.test(content) || /喜欢|偏好|习惯/.test(content)) return "user_profile";
+	if (/\b(tool|command|pnpm|npm|git|ripgrep|rg)\b/i.test(content) || /工具|命令/.test(content)) return "tool_preference";
+	if (/\b(project|repo|codebase|workspace)\b/i.test(content) || /项目|仓库|代码库/.test(content)) return "workspace_fact";
+	if (/\b(next time|lesson|avoid|failed|error)\b/i.test(lower) || /下次|教训|失败|错误|不要/.test(content)) return "task_lesson";
+	return "agent_note";
+}
+function inferSensitivity(kind, content) {
+	if (/\b(api[_-]?key|token|password|secret|credential)\b/i.test(content) || /密钥|密码|令牌/.test(content)) return "secret";
+	if (kind === "user_profile") return "personal";
+	return "normal";
+}
+function extractExplicitContent(userContent) {
+	const lines = userContent.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+	for (const line of lines.length > 0 ? lines : [userContent.trim()]) for (const pattern of EXPLICIT_PATTERNS) {
+		const content = cleanCandidateContent(pattern.exec(line)?.[1] ?? "");
+		if (content.length >= 8) return content;
+	}
+	return null;
+}
+function proposeMemoryCandidatesFromTurn(params) {
+	const content = extractExplicitContent(params.userContent);
+	if (!content) return [];
+	const kind = inferKind(content);
+	const evidence = [{
+		...params.sessionKey ? { sessionKey: params.sessionKey } : {},
+		sourceText: params.userContent.trim().slice(0, MAX_CANDIDATE_CHARS)
+	}];
+	return [{
+		kind,
+		target: kind === "user_profile" ? "user" : "memory",
+		content,
+		status: "candidate",
+		sensitivity: inferSensitivity(kind, content),
+		confidence: .72,
+		evidence,
+		tags: ["auto-proposed", "explicit-user-request"],
+		source: {
+			provider: "turn-sync",
+			...params.sessionKey ? { sessionEntryId: params.sessionKey } : {}
+		}
+	}];
+}
+//#endregion
+export { proposeMemoryCandidatesFromTurn };
+
+//# sourceMappingURL=candidate-extractor.js.map

package/dist/src/agent/memory/candidate-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-extractor.js","names":[],"sources":["../../../../src/agent/memory/candidate-extractor.ts"],"sourcesContent":["import type { MemoryEvidence, MemoryKind, MemorySensitivity, MemoryWriteRequest } from './types.js';\n\nconst MAX_CANDIDATE_CHARS = 600;\n\nconst EXPLICIT_PATTERNS: RegExp[] = [\n  /\\b(?:please\\s+)?remember(?:\\s+that)?\\s+(.+)/i,\n  /\\bkeep\\s+in\\s+mind(?:\\s+that)?\\s+(.+)/i,\n  /(?:请)?记住[：:\\s]*(.+)/,\n  /以后(?:都)?(?:请)?[：:\\s]*(.+)/,\n  /下次(?:请)?[：:\\s]*(.+)/,\n];\n\nfunction cleanCandidateContent(raw: string): string {\n  return raw\n    .replace(/^[\"'“”‘’\\s]+|[\"'“”‘’\\s]+$/g, '')\n    .replace(/\\s+/g, ' ')\n    .trim()\n    .slice(0, MAX_CANDIDATE_CHARS);\n}\n\nfunction inferKind(content: string): MemoryKind {\n  const lower = content.toLowerCase();\n  if (/\\b(prefer|preference|like)\\b/i.test(content) || /喜欢|偏好|习惯/.test(content)) {\n    return 'user_profile';\n  }\n  if (/\\b(tool|command|pnpm|npm|git|ripgrep|rg)\\b/i.test(content) || /工具|命令/.test(content)) {\n    return 'tool_preference';\n  }\n  if (/\\b(project|repo|codebase|workspace)\\b/i.test(content) || /项目|仓库|代码库/.test(content)) {\n    return 'workspace_fact';\n  }\n  if (/\\b(next time|lesson|avoid|failed|error)\\b/i.test(lower) || /下次|教训|失败|错误|不要/.test(content)) {\n    return 'task_lesson';\n  }\n  return 'agent_note';\n}\n\nfunction inferSensitivity(kind: MemoryKind, content: string): MemorySensitivity {\n  if (/\\b(api[_-]?key|token|password|secret|credential)\\b/i.test(content) || /密钥|密码|令牌/.test(content)) {\n    return 'secret';\n  }\n  if (kind === 'user_profile') {\n    return 'personal';\n  }\n  return 'normal';\n}\n\nfunction extractExplicitContent(userContent: string): string | null {\n  const lines = userContent\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter(Boolean);\n  for (const line of lines.length > 0 ? lines : [userContent.trim()]) {\n    for (const pattern of EXPLICIT_PATTERNS) {\n      const match = pattern.exec(line);\n      const content = cleanCandidateContent(match?.[1] ?? '');\n      if (content.length >= 8) {\n        return content;\n      }\n    }\n  }\n  return null;\n}\n\nexport function proposeMemoryCandidatesFromTurn(params: {\n  userContent: string;\n  assistantContent?: string;\n  sessionKey?: string;\n}): MemoryWriteRequest[] {\n  const content = extractExplicitContent(params.userContent);\n  if (!content) {\n    return [];\n  }\n  const kind = inferKind(content);\n  const evidence: MemoryEvidence[] = [\n    {\n      ...(params.sessionKey ? { sessionKey: params.sessionKey } : {}),\n      sourceText: params.userContent.trim().slice(0, MAX_CANDIDATE_CHARS),\n    },\n  ];\n  return [\n    {\n      kind,\n      target: kind === 'user_profile' ? 'user' : 'memory',\n      content,\n      status: 'candidate',\n      sensitivity: inferSensitivity(kind, content),\n      confidence: 0.72,\n      evidence,\n      tags: ['auto-proposed', 'explicit-user-request'],\n      source: {\n        provider: 'turn-sync',\n        ...(params.sessionKey ? { sessionEntryId: params.sessionKey } : {}),\n      },\n    },\n  ];\n}\n"],"mappings":";AAEA,MAAM,sBAAsB;AAE5B,MAAM,oBAA8B;CAClC;CACA;CACA;CACA;CACA;CACD;AAED,SAAS,sBAAsB,KAAqB;AAClD,QAAO,IACJ,QAAQ,8BAA8B,GAAG,CACzC,QAAQ,QAAQ,IAAI,CACpB,MAAM,CACN,MAAM,GAAG,oBAAoB;;AAGlC,SAAS,UAAU,SAA6B;CAC9C,MAAM,QAAQ,QAAQ,aAAa;AACnC,KAAI,gCAAgC,KAAK,QAAQ,IAAI,WAAW,KAAK,QAAQ,CAC3E,QAAO;AAET,KAAI,8CAA8C,KAAK,QAAQ,IAAI,QAAQ,KAAK,QAAQ,CACtF,QAAO;AAET,KAAI,yCAAyC,KAAK,QAAQ,IAAI,YAAY,KAAK,QAAQ,CACrF,QAAO;AAET,KAAI,6CAA6C,KAAK,MAAM,IAAI,iBAAiB,KAAK,QAAQ,CAC5F,QAAO;AAET,QAAO;;AAGT,SAAS,iBAAiB,MAAkB,SAAoC;AAC9E,KAAI,sDAAsD,KAAK,QAAQ,IAAI,WAAW,KAAK,QAAQ,CACjG,QAAO;AAET,KAAI,SAAS,eACX,QAAO;AAET,QAAO;;AAGT,SAAS,uBAAuB,aAAoC;CAClE,MAAM,QAAQ,YACX,MAAM,QAAQ,CACd,KAAK,SAAS,KAAK,MAAM,CAAC,CAC1B,OAAO,QAAQ;AAClB,MAAK,MAAM,QAAQ,MAAM,SAAS,IAAI,QAAQ,CAAC,YAAY,MAAM,CAAC,CAChE,MAAK,MAAM,WAAW,mBAAmB;EAEvC,MAAM,UAAU,sBADF,QAAQ,KAAK,KACgB,GAAG,MAAM,GAAG;AACvD,MAAI,QAAQ,UAAU,EACpB,QAAO;;AAIb,QAAO;;AAGT,SAAgB,gCAAgC,QAIvB;CACvB,MAAM,UAAU,uBAAuB,OAAO,YAAY;AAC1D,KAAI,CAAC,QACH,QAAO,EAAE;CAEX,MAAM,OAAO,UAAU,QAAQ;CAC/B,MAAM,WAA6B,CACjC;EACE,GAAI,OAAO,aAAa,EAAE,YAAY,OAAO,YAAY,GAAG,EAAE;EAC9D,YAAY,OAAO,YAAY,MAAM,CAAC,MAAM,GAAG,oBAAoB;EACpE,CACF;AACD,QAAO,CACL;EACE;EACA,QAAQ,SAAS,iBAAiB,SAAS;EAC3C;EACA,QAAQ;EACR,aAAa,iBAAiB,MAAM,QAAQ;EAC5C,YAAY;EACZ;EACA,MAAM,CAAC,iBAAiB,wBAAwB;EAChD,QAAQ;GACN,UAAU;GACV,GAAI,OAAO,aAAa,EAAE,gBAAgB,OAAO,YAAY,GAAG,EAAE;GACnE;EACF,CACF"}

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

@@ -40,7 +40,8 @@ export declare class MemoryManager {
     }): void;
     syncAll(userContent: string, assistantContent: string, options?: {
         sessionId?: string;
-    }): void;
+    }): Promise<void>;
+    private proposeCandidatesFromTurn;
     getAdditionalTools(): AgentTool[];
     handleToolCall(toolName: string, args: Record<string, unknown>): Promise<string>;
     search(request: MemorySearchRequest): Promise<MemorySearchResult[]>;

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

@@ -2,6 +2,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 "../../storage/sqlite/index.js";
+import { proposeMemoryCandidatesFromTurn } from "./candidate-extractor.js";
 //#region src/agent/memory/manager.ts
 init_logger();
 const log = createLogger("MemoryManager");
@@ -89,17 +90,18 @@ var MemoryManager = class {
 			}, "queuePrefetch failed (non-fatal)");
 		}
 	}
-	syncAll(userContent, assistantContent, options) {
+	async syncAll(userContent, assistantContent, options) {
 		const event = {
 			type: "turn",
 			userContent,
 			assistantContent,
 			sessionId: options?.sessionId
 		};
+		await this.proposeCandidatesFromTurn(event);
 		for (const p of this.providers) {
 			const started = Date.now();
 			try {
-				p.sync?.(event);
+				await p.sync?.(event);
 				this.trace("sync", p.id, event, {
 					resultCount: 1,
 					durationMs: Date.now() - started,
@@ -118,6 +120,27 @@ var MemoryManager = class {
 			}
 		}
 	}
+	async proposeCandidatesFromTurn(event) {
+		const candidates = proposeMemoryCandidatesFromTurn({
+			userContent: event.userContent,
+			assistantContent: event.assistantContent,
+			sessionKey: event.sessionId
+		});
+		for (const candidate of candidates) try {
+			await this.write({
+				...candidate,
+				scope: {
+					...candidate.scope ?? {},
+					...event.sessionId ? { sessionKey: event.sessionId } : {}
+				}
+			});
+		} catch (err) {
+			log.debug({
+				err,
+				sessionKey: event.sessionId
+			}, "memory candidate proposal failed");
+		}
+	}
 	getAdditionalTools() {
 		const out = [];
 		const seen = /* @__PURE__ */ new Set();
@@ -355,7 +378,7 @@ var MemoryManager = class {
 		}
 	}
 	async writeWithStrategy(operation, request) {
-		const providers = this.providersForWrite();
+		const providers = operation === "write" && request.status === "candidate" ? this.providers.filter((provider) => provider.capabilities.local) : this.providersForWrite();
 		const errors = [];
 		let firstSuccess = null;
 		for (const p of providers) {
@@ -408,6 +431,7 @@ var MemoryManager = class {
 		if (!provider.capabilities.local && this.writePolicy.allowedProviderIds && this.writePolicy.allowedProviderIds.length > 0 && !this.writePolicy.allowedProviderIds.includes(provider.id)) return false;
 		if (operation === "write") {
 			const writeRequest = request;
+			if (writeRequest.status === "candidate" && !provider.capabilities.local) return false;
 			if (this.writePolicy.autoWriteKinds && this.writePolicy.autoWriteKinds.length > 0 && !this.writePolicy.autoWriteKinds.includes(writeRequest.kind)) return false;
 			if (this.writePolicy.requireUserProfileApproval && writeRequest.kind === "user_profile" && !writeRequest.approved) return false;
 		}

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 } from '../../storage/sqlite/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { MemoryProvider, MemoryProviderInitOptions } from './provider.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\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  }\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  async prefetchAll(query: string, options?: { sessionId?: string }): Promise<string> {\n    const parts: string[] = [];\n    for (const p of this.providers) {\n      try {\n        const v = await p.prefetch?.(query, options);\n        if (v?.trim()) {\n          parts.push(v.trim());\n        }\n      } catch (err) {\n        log.debug({ err, id: p.id }, 'prefetch failed (non-fatal)');\n      }\n    }\n    return parts.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  syncAll(userContent: string, assistantContent: string, options?: { sessionId?: string }): 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        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  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    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    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 = 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 (\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;AAkBrD,MAAM,MAAM,aAAa,gBAAgB;AAuBzC,IAAa,gBAAb,MAA2B;CACzB,YAAsC,EAAE;CACxC,iCAAyB,IAAI,KAA6B;CAC1D;CACA;CACA;CAEA,wBAAgC;CAEhC,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;;CAGH,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,MAAM,YAAY,OAAe,SAAmD;EAClF,MAAM,QAAkB,EAAE;AAC1B,OAAK,MAAM,KAAK,KAAK,UACnB,KAAI;GACF,MAAM,IAAI,MAAM,EAAE,WAAW,OAAO,QAAQ;AAC5C,OAAI,GAAG,MAAM,CACX,OAAM,KAAK,EAAE,MAAM,CAAC;WAEf,KAAK;AACZ,OAAI,MAAM;IAAE;IAAK,IAAI,EAAE;IAAI,EAAE,8BAA8B;;AAG/D,SAAO,MAAM,KAAK,OAAO;;CAG3B,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,QAAQ,aAAqB,kBAA0B,SAAwC;EAC7F,MAAM,QAAyB;GAC7B,MAAM;GACN;GACA;GACA,WAAW,SAAS;GACrB;AACD,OAAK,MAAM,KAAK,KAAK,WAAW;GAC9B,MAAM,UAAU,KAAK,KAAK;AAC1B,OAAI;AACF,MAAE,OAAO,MAAM;AACf,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,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,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,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,YAAY,KAAK,mBAAmB;EAC1C,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,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 } from '../../storage/sqlite/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { proposeMemoryCandidatesFromTurn } from './candidate-extractor.js';\nimport type { MemoryProvider, MemoryProviderInitOptions } from './provider.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\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  }\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  async prefetchAll(query: string, options?: { sessionId?: string }): Promise<string> {\n    const parts: string[] = [];\n    for (const p of this.providers) {\n      try {\n        const v = await p.prefetch?.(query, options);\n        if (v?.trim()) {\n          parts.push(v.trim());\n        }\n      } catch (err) {\n        log.debug({ err, id: p.id }, 'prefetch failed (non-fatal)');\n      }\n    }\n    return parts.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    const event: MemorySyncEvent = {\n      type: 'turn',\n      userContent,\n      assistantContent,\n      sessionId: options?.sessionId,\n    };\n    await this.proposeCandidatesFromTurn(event);\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  private async proposeCandidatesFromTurn(event: Extract<MemorySyncEvent, { type: 'turn' }>): Promise<void> {\n    const candidates = proposeMemoryCandidatesFromTurn({\n      userContent: event.userContent,\n      assistantContent: event.assistantContent,\n      sessionKey: event.sessionId,\n    });\n    for (const candidate of candidates) {\n      try {\n        await this.write({\n          ...candidate,\n          scope: {\n            ...(candidate.scope ?? {}),\n            ...(event.sessionId ? { sessionKey: event.sessionId } : {}),\n          },\n        });\n      } catch (err) {\n        log.debug({ err, sessionKey: event.sessionId }, 'memory candidate proposal failed');\n      }\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    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    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.js

@@ -1,7 +1,9 @@
 import { init_agent_scope, resolveAgentHomeDir, resolveAgentIdForWorkspacePath } from "../agent-scope.js";
 import { resolveEffectiveAgentManifestForAgent } from "../../config/agent-profile.js";
+import { init_paths, resolveUserMemoryPath } from "../../config/paths.js";
 import { join } from "node:path";
 //#region src/agent/memory/memory-config.ts
+init_paths();
 init_agent_scope();
 /** When false, curated `memories/` (under agent home) + external memory providers are off. */
 function isMemorySubsystemEnabled(config) {
@@ -19,6 +21,7 @@ function resolveBuiltinMemoryStoreConfig(workspaceDir, config) {
 	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,
 		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 { 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    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 shouldInjectMemoryPrefetchThisTurn(\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":";;;;kBAIwF;;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,iBAAiB,UAAU,OAAO,WAAW,YAAY;EACzD,eAAe;EACf,oBAAoB,UAAU,OAAO,QAAQ,SAAS,cAAc,IAAI;EACzE;;;;;;AAOH,SAAgB,mCACd,QACA,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): 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 shouldInjectMemoryPrefetchThisTurn(\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,mCACd,QACA,YACS;AACT,QAAO,cAAc;;AAGvB,SAAgB,gCAAgC,QAAqC;AACnF,QAAO,wBAAwB,OAAO"}

package/dist/src/agent/memory/prefetch-coordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"prefetch-coordinator.js","names":[],"sources":["../../../../src/agent/memory/prefetch-coordinator.ts"],"sourcesContent":["/**\n * MemoryPrefetchCoordinator — owns the per-session memory prefetch cadence and\n * the post-turn sync hand-off to external memory providers.\n *\n * Previously these lived as two methods + a private `Map<sessionKey, turn>` on\n * `AgentManager`. Moving them out makes the memory layer a stand-alone concern\n * with a single owner that handles both \"what to prefix on the user turn\" and\n * \"what to sync after the turn ends\".\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport type { MemoryManager } from './manager.js';\nimport { extractAgentUserPlainText } from './user-message-text.js';\nimport { injectPrefetchIntoUserMessage } from './inject-prefetch.js';\nimport {\n  isMemorySubsystemEnabled,\n  shouldInjectMemoryPrefetchThisTurn,\n} from './memory-config.js';\n\nexport interface MemoryPrefetchCoordinatorOptions {\n  /** Effective config snapshot accessor; tested against `isMemorySubsystemEnabled`. */\n  getConfig: () => Config | undefined;\n  /** Resolve the per-session memory manager (workspace runtime lookup lives in AgentManager). */\n  getMemoryManagerForSession: (sessionKey: string) => MemoryManager;\n  /** Return the last assistant text for a session — fed into external `syncAll`. */\n  getLastAssistantContent: (sessionKey: string) => string | null;\n}\n\nexport class MemoryPrefetchCoordinator {\n  private readonly opts: MemoryPrefetchCoordinatorOptions;\n  /** Per-session user-message index, incremented before each `applyPrefetch` call. */\n  private readonly prefetchUserTurn = new Map<string, number>();\n\n  constructor(opts: MemoryPrefetchCoordinatorOptions) {\n    this.opts = opts;\n  }\n\n  /** Forget a session entirely (called when AgentManager removes the agent). */\n  forgetSession(sessionKey: string): void {\n    this.prefetchUserTurn.delete(sessionKey);\n  }\n\n  /** Tear down all per-session state (process stop / hot reload). */\n  clear(): void {\n    this.prefetchUserTurn.clear();\n  }\n\n  /**\n   * Prepend the prefetched memory fence to the user turn when the cadence\n   * config says we should. Returns the original message untouched otherwise.\n   */\n  async applyToUserMessage(\n    userMessage: AgentMessage,\n    sessionKey: string,\n  ): Promise<AgentMessage> {\n    const cfg = this.opts.getConfig();\n    if (!isMemorySubsystemEnabled(cfg)) {\n      return userMessage;\n    }\n    const plain = extractAgentUserPlainText(userMessage);\n    const turn = (this.prefetchUserTurn.get(sessionKey) ?? 0) + 1;\n    this.prefetchUserTurn.set(sessionKey, turn);\n    if (!shouldInjectMemoryPrefetchThisTurn(cfg, turn)) {\n      return userMessage;\n    }\n    return injectPrefetchIntoUserMessage(\n      this.opts.getMemoryManagerForSession(sessionKey),\n      sessionKey,\n      userMessage,\n      plain,\n    );\n  }\n\n  /** Post-turn: push the latest exchange to external providers + warm next prefetch. */\n  afterTurn(sessionKey: string, userPlainText: string): void {\n    const cfg = this.opts.getConfig();\n    if (!isMemorySubsystemEnabled(cfg)) {\n      return;\n    }\n    const assistant = this.opts.getLastAssistantContent(sessionKey) ?? '';\n    const mm = this.opts.getMemoryManagerForSession(sessionKey);\n    mm.syncAll(userPlainText, assistant, { sessionId: sessionKey });\n    mm.queuePrefetchAll(userPlainText, { sessionId: sessionKey });\n  }\n}\n"],"mappings":";;;;AA8BA,IAAa,4BAAb,MAAuC;CACrC;;CAEA,mCAAoC,IAAI,KAAqB;CAE7D,YAAY,MAAwC;AAClD,OAAK,OAAO;;;CAId,cAAc,YAA0B;AACtC,OAAK,iBAAiB,OAAO,WAAW;;;CAI1C,QAAc;AACZ,OAAK,iBAAiB,OAAO;;;;;;CAO/B,MAAM,mBACJ,aACA,YACuB;EACvB,MAAM,MAAM,KAAK,KAAK,WAAW;AACjC,MAAI,CAAC,yBAAyB,IAAI,CAChC,QAAO;EAET,MAAM,QAAQ,0BAA0B,YAAY;EACpD,MAAM,QAAQ,KAAK,iBAAiB,IAAI,WAAW,IAAI,KAAK;AAC5D,OAAK,iBAAiB,IAAI,YAAY,KAAK;AAC3C,MAAI,CAAC,mCAAmC,KAAK,KAAK,CAChD,QAAO;AAET,SAAO,8BACL,KAAK,KAAK,2BAA2B,WAAW,EAChD,YACA,aACA,MACD;;;CAIH,UAAU,YAAoB,eAA6B;AAEzD,MAAI,CAAC,yBADO,KAAK,KAAK,WACW,CAAC,CAChC;EAEF,MAAM,YAAY,KAAK,KAAK,wBAAwB,WAAW,IAAI;EACnE,MAAM,KAAK,KAAK,KAAK,2BAA2B,WAAW;AAC3D,KAAG,QAAQ,eAAe,WAAW,EAAE,WAAW,YAAY,CAAC;AAC/D,KAAG,iBAAiB,eAAe,EAAE,WAAW,YAAY,CAAC"}
+{"version":3,"file":"prefetch-coordinator.js","names":[],"sources":["../../../../src/agent/memory/prefetch-coordinator.ts"],"sourcesContent":["/**\n * MemoryPrefetchCoordinator — owns the per-session memory prefetch cadence and\n * the post-turn sync hand-off to external memory providers.\n *\n * Previously these lived as two methods + a private `Map<sessionKey, turn>` on\n * `AgentManager`. Moving them out makes the memory layer a stand-alone concern\n * with a single owner that handles both \"what to prefix on the user turn\" and\n * \"what to sync after the turn ends\".\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport type { MemoryManager } from './manager.js';\nimport { extractAgentUserPlainText } from './user-message-text.js';\nimport { injectPrefetchIntoUserMessage } from './inject-prefetch.js';\nimport {\n  isMemorySubsystemEnabled,\n  shouldInjectMemoryPrefetchThisTurn,\n} from './memory-config.js';\n\nexport interface MemoryPrefetchCoordinatorOptions {\n  /** Effective config snapshot accessor; tested against `isMemorySubsystemEnabled`. */\n  getConfig: () => Config | undefined;\n  /** Resolve the per-session memory manager (workspace runtime lookup lives in AgentManager). */\n  getMemoryManagerForSession: (sessionKey: string) => MemoryManager;\n  /** Return the last assistant text for a session — fed into external `syncAll`. */\n  getLastAssistantContent: (sessionKey: string) => string | null;\n}\n\nexport class MemoryPrefetchCoordinator {\n  private readonly opts: MemoryPrefetchCoordinatorOptions;\n  /** Per-session user-message index, incremented before each `applyPrefetch` call. */\n  private readonly prefetchUserTurn = new Map<string, number>();\n\n  constructor(opts: MemoryPrefetchCoordinatorOptions) {\n    this.opts = opts;\n  }\n\n  /** Forget a session entirely (called when AgentManager removes the agent). */\n  forgetSession(sessionKey: string): void {\n    this.prefetchUserTurn.delete(sessionKey);\n  }\n\n  /** Tear down all per-session state (process stop / hot reload). */\n  clear(): void {\n    this.prefetchUserTurn.clear();\n  }\n\n  /**\n   * Prepend the prefetched memory fence to the user turn when the cadence\n   * config says we should. Returns the original message untouched otherwise.\n   */\n  async applyToUserMessage(\n    userMessage: AgentMessage,\n    sessionKey: string,\n  ): Promise<AgentMessage> {\n    const cfg = this.opts.getConfig();\n    if (!isMemorySubsystemEnabled(cfg)) {\n      return userMessage;\n    }\n    const plain = extractAgentUserPlainText(userMessage);\n    const turn = (this.prefetchUserTurn.get(sessionKey) ?? 0) + 1;\n    this.prefetchUserTurn.set(sessionKey, turn);\n    if (!shouldInjectMemoryPrefetchThisTurn(cfg, turn)) {\n      return userMessage;\n    }\n    return injectPrefetchIntoUserMessage(\n      this.opts.getMemoryManagerForSession(sessionKey),\n      sessionKey,\n      userMessage,\n      plain,\n    );\n  }\n\n  /** Post-turn: push the latest exchange to external providers + warm next prefetch. */\n  afterTurn(sessionKey: string, userPlainText: string): void {\n    const cfg = this.opts.getConfig();\n    if (!isMemorySubsystemEnabled(cfg)) {\n      return;\n    }\n    const assistant = this.opts.getLastAssistantContent(sessionKey) ?? '';\n    const mm = this.opts.getMemoryManagerForSession(sessionKey);\n    void mm.syncAll(userPlainText, assistant, { sessionId: sessionKey });\n    mm.queuePrefetchAll(userPlainText, { sessionId: sessionKey });\n  }\n}\n"],"mappings":";;;;AA8BA,IAAa,4BAAb,MAAuC;CACrC;;CAEA,mCAAoC,IAAI,KAAqB;CAE7D,YAAY,MAAwC;AAClD,OAAK,OAAO;;;CAId,cAAc,YAA0B;AACtC,OAAK,iBAAiB,OAAO,WAAW;;;CAI1C,QAAc;AACZ,OAAK,iBAAiB,OAAO;;;;;;CAO/B,MAAM,mBACJ,aACA,YACuB;EACvB,MAAM,MAAM,KAAK,KAAK,WAAW;AACjC,MAAI,CAAC,yBAAyB,IAAI,CAChC,QAAO;EAET,MAAM,QAAQ,0BAA0B,YAAY;EACpD,MAAM,QAAQ,KAAK,iBAAiB,IAAI,WAAW,IAAI,KAAK;AAC5D,OAAK,iBAAiB,IAAI,YAAY,KAAK;AAC3C,MAAI,CAAC,mCAAmC,KAAK,KAAK,CAChD,QAAO;AAET,SAAO,8BACL,KAAK,KAAK,2BAA2B,WAAW,EAChD,YACA,aACA,MACD;;;CAIH,UAAU,YAAoB,eAA6B;AAEzD,MAAI,CAAC,yBADO,KAAK,KAAK,WACW,CAAC,CAChC;EAEF,MAAM,YAAY,KAAK,KAAK,wBAAwB,WAAW,IAAI;EACnE,MAAM,KAAK,KAAK,KAAK,2BAA2B,WAAW;AACtD,KAAG,QAAQ,eAAe,WAAW,EAAE,WAAW,YAAY,CAAC;AACpE,KAAG,iBAAiB,eAAe,EAAE,WAAW,YAAY,CAAC"}

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

@@ -1,15 +1,19 @@
 /**
- * Built-in curated memory (MEMORY.md + USER.md under the agent home `memories/` dir).
+ * Built-in curated memory:
+ * - agent notes: `~/.xopc/agents/<id>/memories/MEMORY.md`
+ * - user memory: `~/.xopc/user/MEMORY.md`
  */
 export interface MemoryStoreConfig {
     workspaceDir: string;
     /** Absolute path to `…/agents/<id>/memories/` (not under markdown workspace). */
     memoriesDir: string;
+    /** Absolute path to global user memory (`~/.xopc/user/MEMORY.md`). */
+    userMemoryPath: string;
     /** Max chars for MEMORY.md entries (excluding delimiter overhead in limit check uses joined body). */
     memoryCharLimit: number;
-    /** Max chars for USER.md entries. */
+    /** Max chars for global user memory entries. */
     userCharLimit: number;
-    /** When false, USER.md is not loaded into the snapshot or shown in the system prompt. */
+    /** When false, global user memory is not loaded into the snapshot or shown in the system prompt. */
     userProfileEnabled?: boolean;
 }
 /** Frozen at session start; not updated when tools mutate disk mid-session. */
@@ -17,7 +21,15 @@ export interface MemorySnapshot {
     memory: string;
     user: string;
 }
-export type MemoryKind = 'user_profile' | 'agent_note' | 'workspace_fact' | 'daily_note' | 'session_summary' | 'derived_insight';
+export type MemoryKind = 'user_profile' | 'agent_note' | 'workspace_fact' | 'daily_note' | 'session_summary' | 'derived_insight' | 'task_lesson' | 'tool_preference' | 'long_term_goal';
+export type MemoryStatus = 'candidate' | 'active' | 'needs_review' | 'stale' | 'archived' | 'rejected';
+export type MemorySensitivity = 'normal' | 'personal' | 'secret' | 'regulated';
+export interface MemoryEvidence {
+    sessionKey?: string;
+    turnId?: string;
+    toolCallId?: string;
+    sourceText?: string;
+}
 export interface MemoryScope {
     agentId: string;
     workspaceId?: string;
@@ -36,6 +48,7 @@ export interface MemoryCitation {
 export interface MemoryRecord {
     id: string;
     kind: MemoryKind;
+    status?: MemoryStatus;
     scope: MemoryScope;
     content: string;
     source: {
@@ -46,6 +59,10 @@ export interface MemoryRecord {
         provider?: string;
     };
     confidence?: number;
+    sensitivity?: MemorySensitivity;
+    evidence?: MemoryEvidence[];
+    reviewAfter?: string;
+    expiresAt?: string;
     createdAt: string;
     updatedAt: string;
     tags?: string[];
@@ -89,6 +106,12 @@ export interface MemoryWriteRequest {
     target?: 'memory' | 'user';
     tags?: string[];
     source?: MemoryRecord['source'];
+    confidence?: number;
+    status?: MemoryStatus;
+    sensitivity?: MemorySensitivity;
+    evidence?: MemoryEvidence[];
+    reviewAfter?: string;
+    expiresAt?: string;
     approved?: boolean;
 }
 export interface MemoryUpdateRequest {

package/dist/src/agent/middleware/self-verify.d.ts

@@ -32,7 +32,6 @@ export declare class SelfVerifyMiddleware {
     private config;
     private turnCount;
     private verificationRequested;
-    private lastVerificationPrompt;
     constructor(config?: Partial<SelfVerifyConfig>);
     /**
      * Record a file edit operation

package/dist/src/agent/middleware/self-verify.js

@@ -17,7 +17,6 @@ var SelfVerifyMiddleware = class {
 	config;
 	turnCount = 0;
 	verificationRequested = false;
-	lastVerificationPrompt = "";
 	constructor(config = {}) {
 		this.config = {
 			...DEFAULT_CONFIG,
@@ -76,7 +75,6 @@ var SelfVerifyMiddleware = class {
 		this.fileEdits.clear();
 		this.turnCount = 0;
 		this.verificationRequested = false;
-		this.lastVerificationPrompt = "";
 		log.debug("Self-verify middleware reset");
 	}
 	/**

package/dist/src/agent/middleware/self-verify.js.map

@@ -1 +1 @@
-{"version":3,"file":"self-verify.js","names":[],"sources":["../../../../src/agent/middleware/self-verify.ts"],"sourcesContent":["/**\n * Self-Verification Middleware\n *\n * Implements the \"Build & Self-Verify\" pattern from harness engineering:\n * - Intercepts agent before completion to remind verification\n * - Tracks file edits to detect potential issues\n * - Injects verification reminders into context\n *\n * Inspired by: https://blog.langchain.com/improving-deep-agents-with-harness-engineering/\n */\n\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('SelfVerifyMiddleware');\n\nexport interface FileEditRecord {\n  path: string;\n  editCount: number;\n  lastEditTime: number;\n  operations: string[]; // 'write', 'edit', 'shell' (for build commands)\n}\n\nexport interface SelfVerifyConfig {\n  /** Max edits to same file before warning (default: 5) */\n  maxEditsPerFile: number;\n  /** Enable pre-completion verification check (default: true) */\n  enablePreCompletionCheck: boolean;\n  /** Min turns before triggering verification reminder (default: 3) */\n  minTurnsForVerification: number;\n  /** Reset counters on successful verification (default: true) */\n  resetOnVerification: boolean;\n}\n\nconst DEFAULT_CONFIG: SelfVerifyConfig = {\n  maxEditsPerFile: 5,\n  enablePreCompletionCheck: true,\n  minTurnsForVerification: 3,\n  resetOnVerification: true,\n};\n\n/**\n * Tracks file modifications and provides verification guidance\n */\nexport class SelfVerifyMiddleware {\n  private fileEdits: Map<string, FileEditRecord> = new Map();\n  private config: SelfVerifyConfig;\n  private turnCount = 0;\n  private verificationRequested = false;\n  private lastVerificationPrompt = '';\n\n  constructor(config: Partial<SelfVerifyConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  /**\n   * Record a file edit operation\n   */\n  recordEdit(filePath: string, operation: 'write' | 'edit' | 'shell'): void {\n    const now = Date.now();\n    const existing = this.fileEdits.get(filePath);\n\n    if (existing) {\n      existing.editCount++;\n      existing.lastEditTime = now;\n      if (!existing.operations.includes(operation)) {\n        existing.operations.push(operation);\n      }\n    } else {\n      this.fileEdits.set(filePath, {\n        path: filePath,\n        editCount: 1,\n        lastEditTime: now,\n        operations: [operation],\n      });\n    }\n\n    log.debug({ filePath, editCount: this.getEditCount(filePath), operation }, 'File edit recorded');\n  }\n\n  /**\n   * Get edit count for a specific file\n   */\n  getEditCount(filePath: string): number {\n    return this.fileEdits.get(filePath)?.editCount || 0;\n  }\n\n  /**\n   * Check if any file has excessive edits (potential doom loop)\n   */\n  hasExcessiveEdits(): { file: string; count: number } | null {\n    for (const [path, record] of this.fileEdits.entries()) {\n      if (record.editCount >= this.config.maxEditsPerFile) {\n        return { file: path, count: record.editCount };\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Increment turn counter\n   */\n  onTurnStart(): void {\n    this.turnCount++;\n    this.verificationRequested = false;\n  }\n\n  /**\n   * Reset all tracking (e.g., after successful task completion)\n   */\n  reset(): void {\n    this.fileEdits.clear();\n    this.turnCount = 0;\n    this.verificationRequested = false;\n    this.lastVerificationPrompt = '';\n    log.debug('Self-verify middleware reset');\n  }\n\n  /**\n   * Get context injection for system prompt\n   * Adds verification guidance based on current state\n   */\n  getContextInjection(): string {\n    const sections: string[] = [];\n\n    // Add workflow guidance\n    sections.push(this.buildWorkflowGuidance());\n\n    // Add excessive edit warning if needed\n    const excessive = this.hasExcessiveEdits();\n    if (excessive) {\n      sections.push(this.buildExcessiveEditWarning(excessive.file, excessive.count));\n    }\n\n    // Add pre-completion check reminder for long sessions\n    if (this.shouldPromptForVerification()) {\n      sections.push(this.buildPreCompletionReminder());\n    }\n\n    return sections.filter(Boolean).join('\\n\\n');\n  }\n\n  /**\n   * Check if we should inject verification reminder\n   */\n  private shouldPromptForVerification(): boolean {\n    if (!this.config.enablePreCompletionCheck) return false;\n    if (this.turnCount < this.config.minTurnsForVerification) return false;\n    if (this.verificationRequested) return false;\n    return true;\n  }\n\n  /**\n   * Mark verification as requested (to avoid spam)\n   */\n  markVerificationRequested(): void {\n    this.verificationRequested = true;\n  }\n\n  /**\n   * Build workflow guidance section\n   */\n  private buildWorkflowGuidance(): string {\n    return `## Problem Solving Workflow\n\nFollow this iterative process for all tasks:\n\n1. **Plan**: Understand the task, read relevant files, and create a plan\n2. **Build**: Implement your solution with verification in mind\n3. **Verify**: Test your work, run checks, compare against requirements\n4. **Fix**: If issues found, analyze and fix them\n\n**Important**: Before declaring a task complete:\n- Re-read the original requirements\n- Verify your solution meets ALL requirements\n- Run any available tests or validation\n- Check for edge cases\n\nDo not skip verification. Incomplete verification leads to incorrect solutions.`;\n  }\n\n  /**\n   * Build warning for excessive file edits (doom loop detection)\n   */\n  private buildExcessiveEditWarning(filePath: string, count: number): string {\n    return `⚠️ **Pattern Alert**: You have edited \"${filePath}\" ${count} times.\n\nThis may indicate:\n- You're fixing symptoms rather than root causes\n- The approach needs reconsideration\n- Requirements may be unclear\n\n**Recommendation**: \n- Step back and re-read the original task\n- Consider if there's a better approach\n- Verify you understand the requirements correctly`;\n  }\n\n  /**\n   * Build pre-completion verification reminder\n   */\n  private buildPreCompletionReminder(): string {\n    this.markVerificationRequested();\n    return `⏳ **Verification Check**: You've made ${this.turnCount} turns on this task.\n\nBefore completing:\n1. ✅ Verify your solution matches the original requirements\n2. ✅ Run tests or validation if available\n3. ✅ Check edge cases and error handling\n4. ✅ Review your changes one final time\n\nIf you're confident, proceed. If unsure, continue refining.`;\n  }\n\n  /**\n   * Get summary of file edits for debugging\n   */\n  getEditSummary(): { totalFiles: number; totalEdits: number; topFiles: Array<{ path: string; count: number }> } {\n    const entries = Array.from(this.fileEdits.entries());\n    const totalEdits = entries.reduce((sum, [, record]) => sum + record.editCount, 0);\n    const topFiles = entries\n      .sort((a, b) => b[1].editCount - a[1].editCount)\n      .slice(0, 5)\n      .map(([path, record]) => ({ path, count: record.editCount }));\n\n    return {\n      totalFiles: entries.length,\n      totalEdits,\n      topFiles,\n    };\n  }\n\n  /**\n   * Update configuration\n   */\n  setConfig(config: Partial<SelfVerifyConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  /**\n   * Get current configuration\n   */\n  getConfig(): SelfVerifyConfig {\n    return { ...this.config };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"self-verify.js","names":[],"sources":["../../../../src/agent/middleware/self-verify.ts"],"sourcesContent":["/**\n * Self-Verification Middleware\n *\n * Implements the \"Build & Self-Verify\" pattern from harness engineering:\n * - Intercepts agent before completion to remind verification\n * - Tracks file edits to detect potential issues\n * - Injects verification reminders into context\n *\n * Inspired by: https://blog.langchain.com/improving-deep-agents-with-harness-engineering/\n */\n\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('SelfVerifyMiddleware');\n\nexport interface FileEditRecord {\n  path: string;\n  editCount: number;\n  lastEditTime: number;\n  operations: string[]; // 'write', 'edit', 'shell' (for build commands)\n}\n\nexport interface SelfVerifyConfig {\n  /** Max edits to same file before warning (default: 5) */\n  maxEditsPerFile: number;\n  /** Enable pre-completion verification check (default: true) */\n  enablePreCompletionCheck: boolean;\n  /** Min turns before triggering verification reminder (default: 3) */\n  minTurnsForVerification: number;\n  /** Reset counters on successful verification (default: true) */\n  resetOnVerification: boolean;\n}\n\nconst DEFAULT_CONFIG: SelfVerifyConfig = {\n  maxEditsPerFile: 5,\n  enablePreCompletionCheck: true,\n  minTurnsForVerification: 3,\n  resetOnVerification: true,\n};\n\n/**\n * Tracks file modifications and provides verification guidance\n */\nexport class SelfVerifyMiddleware {\n  private fileEdits: Map<string, FileEditRecord> = new Map();\n  private config: SelfVerifyConfig;\n  private turnCount = 0;\n  private verificationRequested = false;\n\n  constructor(config: Partial<SelfVerifyConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  /**\n   * Record a file edit operation\n   */\n  recordEdit(filePath: string, operation: 'write' | 'edit' | 'shell'): void {\n    const now = Date.now();\n    const existing = this.fileEdits.get(filePath);\n\n    if (existing) {\n      existing.editCount++;\n      existing.lastEditTime = now;\n      if (!existing.operations.includes(operation)) {\n        existing.operations.push(operation);\n      }\n    } else {\n      this.fileEdits.set(filePath, {\n        path: filePath,\n        editCount: 1,\n        lastEditTime: now,\n        operations: [operation],\n      });\n    }\n\n    log.debug({ filePath, editCount: this.getEditCount(filePath), operation }, 'File edit recorded');\n  }\n\n  /**\n   * Get edit count for a specific file\n   */\n  getEditCount(filePath: string): number {\n    return this.fileEdits.get(filePath)?.editCount || 0;\n  }\n\n  /**\n   * Check if any file has excessive edits (potential doom loop)\n   */\n  hasExcessiveEdits(): { file: string; count: number } | null {\n    for (const [path, record] of this.fileEdits.entries()) {\n      if (record.editCount >= this.config.maxEditsPerFile) {\n        return { file: path, count: record.editCount };\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Increment turn counter\n   */\n  onTurnStart(): void {\n    this.turnCount++;\n    this.verificationRequested = false;\n  }\n\n  /**\n   * Reset all tracking (e.g., after successful task completion)\n   */\n  reset(): void {\n    this.fileEdits.clear();\n    this.turnCount = 0;\n    this.verificationRequested = false;\n    log.debug('Self-verify middleware reset');\n  }\n\n  /**\n   * Get context injection for system prompt\n   * Adds verification guidance based on current state\n   */\n  getContextInjection(): string {\n    const sections: string[] = [];\n\n    // Add workflow guidance\n    sections.push(this.buildWorkflowGuidance());\n\n    // Add excessive edit warning if needed\n    const excessive = this.hasExcessiveEdits();\n    if (excessive) {\n      sections.push(this.buildExcessiveEditWarning(excessive.file, excessive.count));\n    }\n\n    // Add pre-completion check reminder for long sessions\n    if (this.shouldPromptForVerification()) {\n      sections.push(this.buildPreCompletionReminder());\n    }\n\n    return sections.filter(Boolean).join('\\n\\n');\n  }\n\n  /**\n   * Check if we should inject verification reminder\n   */\n  private shouldPromptForVerification(): boolean {\n    if (!this.config.enablePreCompletionCheck) return false;\n    if (this.turnCount < this.config.minTurnsForVerification) return false;\n    if (this.verificationRequested) return false;\n    return true;\n  }\n\n  /**\n   * Mark verification as requested (to avoid spam)\n   */\n  markVerificationRequested(): void {\n    this.verificationRequested = true;\n  }\n\n  /**\n   * Build workflow guidance section\n   */\n  private buildWorkflowGuidance(): string {\n    return `## Problem Solving Workflow\n\nFollow this iterative process for all tasks:\n\n1. **Plan**: Understand the task, read relevant files, and create a plan\n2. **Build**: Implement your solution with verification in mind\n3. **Verify**: Test your work, run checks, compare against requirements\n4. **Fix**: If issues found, analyze and fix them\n\n**Important**: Before declaring a task complete:\n- Re-read the original requirements\n- Verify your solution meets ALL requirements\n- Run any available tests or validation\n- Check for edge cases\n\nDo not skip verification. Incomplete verification leads to incorrect solutions.`;\n  }\n\n  /**\n   * Build warning for excessive file edits (doom loop detection)\n   */\n  private buildExcessiveEditWarning(filePath: string, count: number): string {\n    return `⚠️ **Pattern Alert**: You have edited \"${filePath}\" ${count} times.\n\nThis may indicate:\n- You're fixing symptoms rather than root causes\n- The approach needs reconsideration\n- Requirements may be unclear\n\n**Recommendation**: \n- Step back and re-read the original task\n- Consider if there's a better approach\n- Verify you understand the requirements correctly`;\n  }\n\n  /**\n   * Build pre-completion verification reminder\n   */\n  private buildPreCompletionReminder(): string {\n    this.markVerificationRequested();\n    return `⏳ **Verification Check**: You've made ${this.turnCount} turns on this task.\n\nBefore completing:\n1. ✅ Verify your solution matches the original requirements\n2. ✅ Run tests or validation if available\n3. ✅ Check edge cases and error handling\n4. ✅ Review your changes one final time\n\nIf you're confident, proceed. If unsure, continue refining.`;\n  }\n\n  /**\n   * Get summary of file edits for debugging\n   */\n  getEditSummary(): { totalFiles: number; totalEdits: number; topFiles: Array<{ path: string; count: number }> } {\n    const entries = Array.from(this.fileEdits.entries());\n    const totalEdits = entries.reduce((sum, [, record]) => sum + record.editCount, 0);\n    const topFiles = entries\n      .sort((a, b) => b[1].editCount - a[1].editCount)\n      .slice(0, 5)\n      .map(([path, record]) => ({ path, count: record.editCount }));\n\n    return {\n      totalFiles: entries.length,\n      totalEdits,\n      topFiles,\n    };\n  }\n\n  /**\n   * Update configuration\n   */\n  setConfig(config: Partial<SelfVerifyConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  /**\n   * Get current configuration\n   */\n  getConfig(): SelfVerifyConfig {\n    return { ...this.config };\n  }\n}\n"],"mappings":";;;aAWqD;AAErD,MAAM,MAAM,aAAa,uBAAuB;AAoBhD,MAAM,iBAAmC;CACvC,iBAAiB;CACjB,0BAA0B;CAC1B,yBAAyB;CACzB,qBAAqB;CACtB;;;;AAKD,IAAa,uBAAb,MAAkC;CAChC,4BAAiD,IAAI,KAAK;CAC1D;CACA,YAAoB;CACpB,wBAAgC;CAEhC,YAAY,SAAoC,EAAE,EAAE;AAClD,OAAK,SAAS;GAAE,GAAG;GAAgB,GAAG;GAAQ;;;;;CAMhD,WAAW,UAAkB,WAA6C;EACxE,MAAM,MAAM,KAAK,KAAK;EACtB,MAAM,WAAW,KAAK,UAAU,IAAI,SAAS;AAE7C,MAAI,UAAU;AACZ,YAAS;AACT,YAAS,eAAe;AACxB,OAAI,CAAC,SAAS,WAAW,SAAS,UAAU,CAC1C,UAAS,WAAW,KAAK,UAAU;QAGrC,MAAK,UAAU,IAAI,UAAU;GAC3B,MAAM;GACN,WAAW;GACX,cAAc;GACd,YAAY,CAAC,UAAU;GACxB,CAAC;AAGJ,MAAI,MAAM;GAAE;GAAU,WAAW,KAAK,aAAa,SAAS;GAAE;GAAW,EAAE,qBAAqB;;;;;CAMlG,aAAa,UAA0B;AACrC,SAAO,KAAK,UAAU,IAAI,SAAS,EAAE,aAAa;;;;;CAMpD,oBAA4D;AAC1D,OAAK,MAAM,CAAC,MAAM,WAAW,KAAK,UAAU,SAAS,CACnD,KAAI,OAAO,aAAa,KAAK,OAAO,gBAClC,QAAO;GAAE,MAAM;GAAM,OAAO,OAAO;GAAW;AAGlD,SAAO;;;;;CAMT,cAAoB;AAClB,OAAK;AACL,OAAK,wBAAwB;;;;;CAM/B,QAAc;AACZ,OAAK,UAAU,OAAO;AACtB,OAAK,YAAY;AACjB,OAAK,wBAAwB;AAC7B,MAAI,MAAM,+BAA+B;;;;;;CAO3C,sBAA8B;EAC5B,MAAM,WAAqB,EAAE;AAG7B,WAAS,KAAK,KAAK,uBAAuB,CAAC;EAG3C,MAAM,YAAY,KAAK,mBAAmB;AAC1C,MAAI,UACF,UAAS,KAAK,KAAK,0BAA0B,UAAU,MAAM,UAAU,MAAM,CAAC;AAIhF,MAAI,KAAK,6BAA6B,CACpC,UAAS,KAAK,KAAK,4BAA4B,CAAC;AAGlD,SAAO,SAAS,OAAO,QAAQ,CAAC,KAAK,OAAO;;;;;CAM9C,8BAA+C;AAC7C,MAAI,CAAC,KAAK,OAAO,yBAA0B,QAAO;AAClD,MAAI,KAAK,YAAY,KAAK,OAAO,wBAAyB,QAAO;AACjE,MAAI,KAAK,sBAAuB,QAAO;AACvC,SAAO;;;;;CAMT,4BAAkC;AAChC,OAAK,wBAAwB;;;;;CAM/B,wBAAwC;AACtC,SAAO;;;;;;;;;;;;;;;;;;;;CAqBT,0BAAkC,UAAkB,OAAuB;AACzE,SAAO,0CAA0C,SAAS,IAAI,MAAM;;;;;;;;;;;;;;;CAgBtE,6BAA6C;AAC3C,OAAK,2BAA2B;AAChC,SAAO,yCAAyC,KAAK,UAAU;;;;;;;;;;;;;CAcjE,iBAA+G;EAC7G,MAAM,UAAU,MAAM,KAAK,KAAK,UAAU,SAAS,CAAC;EACpD,MAAM,aAAa,QAAQ,QAAQ,KAAK,GAAG,YAAY,MAAM,OAAO,WAAW,EAAE;EACjF,MAAM,WAAW,QACd,MAAM,GAAG,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,UAAU,CAC/C,MAAM,GAAG,EAAE,CACX,KAAK,CAAC,MAAM,aAAa;GAAE;GAAM,OAAO,OAAO;GAAW,EAAE;AAE/D,SAAO;GACL,YAAY,QAAQ;GACpB;GACA;GACD;;;;;CAMH,UAAU,QAAyC;AACjD,OAAK,SAAS;GAAE,GAAG,KAAK;GAAQ,GAAG;GAAQ;;;;;CAM7C,YAA8B;AAC5B,SAAO,EAAE,GAAG,KAAK,QAAQ"}

package/dist/src/agent/models/index.d.ts

@@ -3,4 +3,4 @@
  *
  * Model management and selection.
  */
-export { ModelManager, type ModelManagerConfig, type RunResult } from './manager.js';
+export { ModelManager, type ModelManagerConfig } from './manager.js';