자동 메모리 & 드림 시스템

자동 메모리 시스템은 두 가지 핵심 프로세스로 구성됩니다: 대화 중 실시간으로 메모리를 추출하는 턴별 추출과, 축적된 메모리를 주기적으로 통합하는 교차 세션 통합(드림)입니다.

두 가지 핵심 프로세스:

• 턴별 추출: 대화가 진행되는 동안 백그라운드에서 메모리를 추출. 커서 기반, 상호 배제, 포크 에이전트 패턴, 프롬프트 캐시 공유를 활용
• 교차 세션 통합 (드림): 세션 간에 축적된 메모리를 통합하고 정리. 3개 게이트를 통과해야 실행되며, DreamTask로 비동기 처리

턴별 추출은 대화의 각 턴이 완료될 때마다 백그라운드에서 실행됩니다. 메인 에이전트의 응답 지연에 영향을 주지 않도록 설계되어 있습니다.

커서 기반 추적

추출 에이전트는 마지막으로 처리한 대화 위치를 커서로 추적합니다. 새 턴이 추가되면 커서 이후의 내용만 처리하여 중복 추출을 방지합니다.

상호 배제

추출 에이전트는 한 번에 하나만 실행됩니다. 이전 추출이 아직 진행 중이면 새 추출은 대기하거나 건너뜁니다.

포크 에이전트 패턴과 프롬프트 캐시 공유

추출 에이전트는 메인 에이전트와 동일한 도구 목록을 사용하는 포크 에이전트 패턴을 따릅니다. 이를 통해 API 프롬프트 캐시를 공유합니다.

// 포크 에이전트 패턴 — 캐시 공유 핵심
// 메인 에이전트와 동일한 도구 목록을 전달하되
// canUseTool()로 런타임에서 실제 사용을 제한
const extractionAgent = {
  tools: mainAgent.tools,          // 동일 목록 → 캐시 공유
  canUseTool: (tool) => {
    return memoryWriteTools.includes(tool.name)
  },
}

드림은 여러 세션에서 축적된 메모리를 통합하고 정리하는 프로세스입니다. 메모리 파일이 많아지면 중복, 충돌, 낡은 정보가 발생할 수 있으므로 주기적인 통합이 필요합니다.

3개 게이트

드림은 다음 세 가지 게이트를 모두 통과해야 실행됩니다:

1. 시간 게이트: 마지막 통합 이후 충분한 시간이 경과했는지 확인
2. 세션 게이트: 마지막 통합 이후 충분한 세션이 종료되었는지 확인
3. 잠금 게이트: .consolidate-lock 파일로 동시 실행을 방지

.consolidate-lock과 타임스탬프

마지막 통합 타임스탬프는 .consolidate-lock 파일의 mtime(파일 수정 시간)에 저장됩니다. 파일 내용이나 별도의 JSON 필드가 아니라 파일시스템의 mtime을 활용하여 원자적 타임스탬프 기록을 달성합니다.

// .consolidate-lock — mtime 기반 타임스탬프
async function shouldRunConsolidation(): Promise<boolean> {
  const lockPath = join(memoryDir, '.consolidate-lock')
  const stat = await fsStat(lockPath)

  // mtime = 마지막 통합 시간
  const lastConsolidation = stat.mtime
  const elapsed = Date.now() - lastConsolidation.getTime()

  return elapsed > MIN_CONSOLIDATION_INTERVAL
}

4단계 통합 프롬프트

드림이 실행되면 DreamTask가 4단계로 메모리를 통합합니다:

1. 수집: 모든 토픽 파일을 읽어들임
2. 중복 제거: 의미적으로 동일한 메모리를 병합
3. 충돌 해결: 상충하는 메모리 중 최신/더 구체적인 것을 선택
4. 재구성: 통합된 메모리를 토픽별로 재작성

리콜은 새 세션 시작 시 저장된 메모리에서 현재 작업에 관련된 것들을 선택하는 프로세스입니다.

findRelevantMemories와 Sonnet 사이드쿼리

리콜은 Sonnet 모델에 사이드쿼리를 보내 관련성을 평가합니다. 이 쿼리는 메인 대화와 병렬로 실행되어 응답 지연에 영향을 주지 않습니다.

억제 로직

리콜 시스템은 현재 활성 사용 중인 도구의 참조 문서를 선택에서 억제합니다. 이유는 해당 도구가 이미 대화에서 사용되고 있으므로, 작동 예시가 대화 자체에 존재하기 때문입니다. 참조 문서를 중복으로 주입하면 컨텍스트 윈도우만 낭비됩니다.

팀 환경에서는 여러 팀메이트가 독립적으로 메모리를 추출합니다. 팀 메모리 통합 모드는 이 분산된 메모리를 일관되게 병합하고 동기화합니다.

통합 시 SHA-256 해시를 사용하여 변경을 감지하고, 비밀 스캐닝으로 민감한 정보가 팀 전체에 전파되지 않도록 합니다. 동일한 드림 3개 게이트(시간/세션/잠금)를 통과해야 팀 통합이 실행됩니다.