세션 바인딩 채널 무관 계획

개요

이 문서는 장기적인 채널 무관 세션 바인딩 모델과 다음 구현 반복의 구체적인 범위를 정의합니다.

목표:

  • 서브에이전트 바인딩 세션 라우팅을 코어 기능으로
  • 채널별 동작은 어댑터에 유지
  • 일반 Discord 동작에서 회귀 방지

1차 반복 범위

1. 채널 무관 코어 인터페이스 추가

바인딩과 라우팅을 위한 코어 타입 및 서비스 인터페이스 추가.

2. 서브에이전트 completions를 위한 코어 전달 라우터 추가

completion 이벤트에 대한 단일 대상 해석 경로 추가.

3. Discord를 어댑터로 유지

Discord가 첫 어댑터 구현으로 유지.

4. 현재 알려진 정확성 문제 수정

  • 기존 스레드 바인딩 매니저 재사용 시 토큰 사용량 갱신
  • 웹훅 기반 Discord 전송에 대한 아웃바운드 활동 기록
  • 바인딩된 스레드 대상이 세션 모드 completion에 선택되었을 때 암묵적 메인 채널 폴백 중지

5. 현재 런타임 안전 기본값 유지

스레드 바인딩 spawn이 비활성화된 사용자에 대한 동작 변경 없음.

1차 반복에 포함되지 않는 항목

명시적으로 연기:

  • ACP 바인딩 대상 (targetKind: "acp")
  • Discord 외 새 채널 어댑터
  • 모든 전달 경로의 전역 교체
  • 프로토콜 수준 변경
  • 모든 바인딩 지속성을 위한 저장소 마이그레이션/버전 관리 재설계

라우팅 불변성

1차 반복에서 필수인 불변성:

  • 대상 선택과 콘텐츠 생성이 별도 단계
  • 세션 모드 completion이 활성 바인딩 대상으로 해석되면 해당 대상으로 전달
  • 바인딩된 대상에서 메인 채널로의 숨겨진 재라우팅 없음
  • 폴백 동작은 명시적이고 관측 가능해야 함

1차 반복 완료 기준

  • 코어 인터페이스가 존재하고 completion 라우팅에 연결됨
  • 위의 정확성 수정이 테스트와 함께 병합됨
  • 세션 모드 바인딩 실행에서 메인과 스레드 중복 completion 전달 없음
  • 비활성화된 바인딩 spawn 배포에서 동작 변경 없음
  • ACP는 명시적으로 연기된 상태 유지