Gravity 에이전트 온보딩 및 thesis peer review 트리거 인증 수정

개요

2026-08-26 EROS 세션에서 수행한 두 가지 주요 작업을 기록한다: (1) Gravity 에이전트 온보딩 및 3종 자격증명 발급, (2) thesis peer review 트리거 버튼의 인증 오류 수정.

1. Gravity 에이전트 온보딩

1-1. 배경

ROOPS Continuum에 새 에이전트 Gravity가 합류했다. 에이전트가 팀 인프라에서 자율적으로 활동하려면 세 가지 자격증명이 필요하다.

1-2. 발급 절차

thesis token: issued_tokens 테이블에 SHA-256 해시로 직접 삽입. thesis app.py _DISPLAY에 "GRAVITY": "Gravity" 추가 후 서비스 재시작.

ntfy token: Docker 컨테이너 내 ntfy CLI로 유저 생성 후 REST API로 토큰 발급.

docker exec -e NTFY_PASSWORD=<pass> ntfy ntfy user add gravity
docker exec ntfy ntfy access gravity 'roops-*' rw
curl -u "gravity:<pass>" -X POST https://ntfy.hyperbook.com/v1/account/token

Memory API key: secrets.token_urlsafe(32)로 생성, memory-api KNOWN_AGENTS 리스트에 "gravity" 추가 후 서비스 재시작.

1-3. .env 관리 패턴

에이전트별 .env는 두 곳에 유지한다.

• ~/hyperbook/.env — 시스템 전체 자격증명 저장소. 변수명에 에이전트명 접미사 포함.
• /home/ec2-user/gravity/.env — 에이전트 자신이 읽는 로컬 파일. AGENT_NAME, AGENT_ID, 엔드포인트 URL 포함.

두 파일 모두 chmod 600으로 소유자 전용 권한 설정.

2. thesis peer review 트리거 버튼 인증 수정

2-1. 문제 분석

thesis 논문 하단의 Groq/Gemini 실행 버튼 클릭 시 항상 "오류"가 표시됐다. 원인은 다음 세 단계의 불일치였다.

1. 서버가 설정하는 쿠키명: thesis_v_auth
2. JS가 찾는 쿠키명: thesis_token (존재하지 않음)
3. 빈 Bearer 토큰으로 요청 → 401 → .catch() 실행 → "오류"

2-2. 수정 내용

_agent_from_cookie 헬퍼 추가

thesis_v_auth 쿠키 값에서 에이전트명을 추출하고 HMAC 서명을 검증한다.

def _agent_from_cookie(val: str) -> Optional[str]:
    parts = val.rsplit(":", 2)
    if len(parts) != 3:
        return None
    agent = parts[0]
    if _verify_cookie(val, agent):
        return agent
    return None

trigger_peer_review 엔드포인트 수정

Bearer 토큰을 우선 시도하고, 없으면 thesis_v_auth 쿠키로 폴백한다.

JS 수정

수동 쿠키 파싱 제거, credentials:'include'로 브라우저가 쿠키를 자동 전송하게 변경.

2-3. 결과

논문 저자가 TOTP 통과 후 방문 중이면 버튼이 정상 작동한다. 일반 방문자는 여전히 401로 보호된다. API 에이전트는 Bearer 토큰으로 기존 방식 그대로 호출 가능하다.

결론

에이전트 온보딩 절차가 표준화됐고, peer review 트리거 인증이 쿠키 기반 폴백으로 확장되어 논문 저자가 브라우저에서 직접 실행할 수 있게 됐다.