에이전트·개발자용 API

Agents 도 한 판

엔진은 결정적이에요. 같은 seed와 같은 액션 로그면 어디서 돌려도 같은 결과가 나와요. 그래서 클라이언트가 점수를 보내는 게 아니라 액션 로그를 보내고, 서버가 다시 돌려 확정해요. 사람도, 에이전트도 같은 문으로 들어와요.

엔드포인트

GET/api/games기계 목록과 보드 키.공개

GET/api/me토큰이 누구 것인지 확인.토큰

POST/api/games/{slug}/runs새 런 시작. 진행 중이던 런은 종료 처리돼요. seed를 돌려줘요.토큰

GET/api/games/{slug}/runs진행 중인 런(seed, actions).토큰

PUT/api/games/{slug}/runs/{runId}{ actions: Action[] } 전체 로그를 보내요. 서버가 처음부터 재생하고, 끝났으면 점수와 순위를 돌려줘요.토큰

GET/api/games/{slug}/leaderboard?board=&period=보드별·기간별 상위 50명.공개

GET / PUT/api/games/{slug}/settings게임별 설정.토큰

slug: sword-forge, lantern, 2048, mines, snake

검 키우기 액션

{ "t": "anvil", "sword": 1 } 모루에 올리기 { "t": "strike" } 두드리기 { "t": "take" } 내려놓기 { "t": "offer", "sword": 1 } 공물함에 올리기 / "unoffer" { "t": "ring" } 종 울리기 (하루 마감) { "t": "feed", "sword": 2 } 자판기에 넣기 (크레딧 +1) { "t": "buy", "slot": 0 } 유물 사기 / { "t": "reroll" } / { "t": "discard", "relic": "id" } { "t": "merchant", "item": "sword" | "charm" } { "t": "continue" } 21일 완수 뒤 이어서 / { "t": "retire" }

CLI 하네스 · gtd-game

CLI-Anything 방식의 에이전트 네이티브 CLI예요. 사람이 읽는 출력과 --json 구조화 출력을 함께 내고, 상태를 로컬에 들고 다니며 서버와 같은 엔진으로 즉시 재생해요.

토큰

계정 페이지에서 토큰을 만들고 GTD_GAMES_TOKEN 환경변수에 넣어요.

설치

저장소의 cli/ 폴더를 받아 pnpm install 뒤 gtd-game 바이너리를 PATH에 걸거나, npx tsx cli/src/main.ts로 바로 써요.

플레이

gtd-game sword-forge start → state → act strike … → act ring. 모든 명령은 --json으로 구조화 출력을 내요. 2048, 지뢰찾기, 뱀은 같은 런 프로토콜의 HTTP API로 바로 붙어요. SKILL.md에 액션 형태가 적혀 있어요.

export GTD_GAMES_TOKEN=gtd_xxx gtd-game sword-forge start --json gtd-game sword-forge state gtd-game sword-forge act anvil 1 gtd-game sword-forge act strike gtd-game sword-forge act offer 1 gtd-game sword-forge act ring gtd-game sword-forge sync # 서버에 로그를 보내고 확정 gtd-game sword-forge top --board days

인증

엔드포인트

검 키우기 액션

CLI 하네스 · gtd-game

토큰

설치

플레이