oto/agent-ops/roadmap/milestones/agent-message-protocol.md

agent 메시지 프로토콜

목표

oto agent 또는 oto daemon 모드에서 Edge와 proto-socket 기반 양방향 메시지 통신을 하기 위한 기본 메시지 범위와 계약을 정의한다.

단계

메시지 기반 빌드 에이전트

상태

계획

구현 잠금

• 상태: 잠금
• 이유: OTO agent 등록 경계와 iop Edge 쪽 specialized domain agent protocol 경계가 먼저 정리되어야 하는 계약 Milestone이다.
• 해제 조건:
  • OTO agent 등록 흐름과 Edge 직접 outbound 연결 책임 경계가 문서화됨
  • register, capabilities, run request, event, cancel, status 메시지의 소유 repo와 proto-socket 경계가 구체화됨
  • 사용자가 이 Milestone의 구현 구체화와 잠금 해제를 명시적으로 승인함
• 잠금 중 금지:
  • 코드 구현 또는 agent-task 구현 계획 생성
  • proto 파일, 생성 코드, 메시지 버전을 추측해 확정
  • 기존 YAML 실행 경로를 대체하는 새 원격 DSL을 선확정

범위

• agent register, capabilities, run request, step event, log stream, artifact event, cancel, status, self-update 메시지의 최소 필드를 정의한다.
• 메시지 버전, 호환성, 에러 표현 방식을 정리한다.
• OTO가 Edge의 build/deploy 전용 domain agent라는 경계를 명시한다.

필수 기능

• [message-list] 기본 메시지 목록과 방향성이 정의되어 있다.
• [message-fields] 각 메시지의 최소 필드와 실패 응답 형식이 정의되어 있다.
• [version-capability] 프로토콜 버전과 capability 협상 기준이 정의되어 있다.
• [domain-boundary] generic node 하위 실행물이 아니라는 제품 경계가 문서화되어 있다.

완료 기준

• Edge와 agent 구현자가 같은 메시지 계약을 기준으로 병렬 작업을 시작할 수 있다.
• YAML 파이프라인과 커맨드 모델이 메시지 위에서 어떻게 호출되는지 설명된다.
• 메시지 추가가 기존 CLI 실행 경로를 깨지 않는다는 경계가 명확하다.

범위 제외

• 웹 UI 또는 Edge 관리 화면을 구현하지 않는다.
• 기존 YAML 파이프라인 형식을 대체하지 않는다.
• 모든 운영 보안 정책을 완성하지 않는다.

작업 컨텍스트

• CLI 자동화 표면 정리 단계의 구조화 실행 결과와 step event 기준을 먼저 확인한다.
• 선행 Milestone: OTO-iop proto-socket 통신 기반
• 선행 Milestone: oto-agent 등록 흐름
• 관련 iop Milestone: ../iop/agent-ops/roadmap/milestones/agent-bootstrap-oto-enrollment.md
• 책임 경계: iop는 Edge가 이해해야 하는 specialized domain agent registry/protocol 경계를 정리한다.
• 책임 경계: OTO는 build/deploy domain agent가 노출할 capabilities, YAML run request 연결, step/log/artifact event 의미를 정리한다.
• 프로토콜 파일이나 생성 코드가 추가되면 관련 도메인 rule 또는 새 도메인 rule 필요 여부를 검토한다.