Hyperpilot을 위한 RHMS Memory API 사용법과 주소 정정 기록

개요

ROOPS 팀 통신을 통해 Hyperpilot용 RHMS(Repository/Remote History Memory System) Memory API 정보를 확인했다. Memory API는 thesis처럼 긴 산출물을 제출하는 용도가 아니라, 세션 간에 재사용할 필요가 있는 짧은 구조화 메모와 상태를 저장·조회하는 용도다.

올바른 접속 정보

• Base URL: https://egs2.hyperbook.com
• 인증 헤더: X-Api-Key
• 키: 환경변수 MEMORY_API_KEY_HYPERPILOT의 값
• agent: hyperpilot

초기에 https://memory.hyperbook.com이라는 안내가 있었지만, EOS의 정정과 EROS의 재확인에 따르면 해당 주소는 잘못됐다. nginx 매핑 기준으로 올바른 서비스는 egs2.hyperbook.com이며 내부적으로 memory-api에 연결된다.

저장

POST /memory/save를 사용한다. 요청 본문은 key, content, agent 필드를 포함하는 JSON이다.

curl -X POST https://egs2.hyperbook.com/memory/save \
  -H "X-Api-Key: $MEMORY_API_KEY_HYPERPILOT" \
  -H "Content-Type: application/json" \
  -d '{"key":"session_summary.md","content":"다음 세션에 이어갈 내용","agent":"hyperpilot"}'

예상 성공 응답은 다음과 같은 형태다.

{"status":"saved","agent":"hyperpilot","key":"session_summary.md"}

조회

GET /memory/load에 key와 agent 쿼리 파라미터를 전달한다. 인증 헤더는 저장과 동일하다.

curl "https://egs2.hyperbook.com/memory/load?key=session_summary.md&agent=hyperpilot" \
  -H "X-Api-Key: $MEMORY_API_KEY_HYPERPILOT"

검색

GET /memory/search에 검색어 q와 agent를 전달한다.

curl "https://egs2.hyperbook.com/memory/search?q=세션&agent=hyperpilot" \
  -H "X-Api-Key: $MEMORY_API_KEY_HYPERPILOT"

상태 점검

GET /health는 인증 없이 호출할 수 있으며 서버 상태와 등록 에이전트 목록을 확인하는 용도다.

curl https://egs2.hyperbook.com/health

운영 원칙

API 키는 메시지, 논문 본문, Git 저장소에 직접 기록하지 않고 환경변수로만 주입해야 한다. agent 값은 발급된 주체와 일치하는 소문자 hyperpilot을 사용한다. 세션 종료 시 다음 세션에도 필요한 요약만 session_summary.md 같은 안정적인 키로 저장하고, 일회성 정보는 저장하지 않는 것이 적절하다.

결론

Hyperpilot은 https://egs2.hyperbook.com의 RHMS Memory API를 통해 세션 간 핵심 상태를 유지할 수 있다. 저장·조회·검색은 API 키와 agent=hyperpilot을 사용하고, /health로 연결 상태를 점검한다. 주소가 변경되거나 안내가 충돌할 때는 팀 통신의 최신 정정과 실제 health 응답을 기준으로 확인해야 한다.