How penguinpecker/agentgames-2026 works
This repository implements a signed HTTPS game agent for Steal the VFY and Proof Gatekeeper. The principal workflow authenticates and validates an incoming envelope, routes it to a game-specific handler, and returns a signed answer. Steal computes a policy action and Groth16 proof; Gatekeeper checks trap conditions, tracks proof replays, and generates a statement proof. Vercel also archives competition exchanges in Blob. The local server is an alternate wrapper around the transport core. Edges reflect README statements and shown imports or calls; circuit artifacts are external inputs, and their runtime details are not represented as inspected source.
Main entry points: gatekeeper-task.mjs Task evaluation · handler.mjs Request handler · agent.mjs Vercel endpoint · handlers.mjs Game dispatch
Components 14
Signed transport
- Vercel endpoint
api/agent.mjs - Request handler
src/handler.mjs - HMAC and time checks
src/security.mjs - Game dispatch
src/handlers.mjs
Steal the VFY
- Turn strategy and proof
src/steal.mjs - Policy rules
src/policy.mjs
Proof Gatekeeper
- Task evaluation
src/gatekeeper-task.mjs - Trap checks
src/gatekeeper.mjs - Circuit proof verification
src/proofs.mjs - Task ID encoding
src/gk-encoding.mjs
Persistence
- Accepted proof set
src/seen.mjs - Exchange archive
src/seen.mjs
Other components
- Game platform
- Vercel Blob
Connections 15
- Game platform → Vercel endpoint: sends tasks
README.md - Vercel endpoint → Request handler: passes request
api/agent.mjs - Request handler → HMAC and time checks: authenticates and checks time
src/handler.mjs - Request handler → Game dispatch: dispatches task
api/agent.mjs - Game dispatch → Turn strategy and proof: runs turn
src/handlers.mjs - Game dispatch → Task evaluation: runs task
src/handlers.mjs - Turn strategy and proof → Policy rules: computes action
src/steal.mjs - Task evaluation → Trap checks: evaluates input
src/gatekeeper-task.mjs - Task evaluation → Accepted proof set: checks and marks replay
src/gatekeeper-task.mjs - Task evaluation → Circuit proof verification: creates proof
src/gatekeeper-task.mjs - Task evaluation → Task ID encoding: encodes task ID
src/gatekeeper-task.mjs - Accepted proof set → Vercel Blob: reads and writes
src/seen.mjs - Request handler → Exchange archive: archives competition reply
src/handler.mjs - Vercel endpoint → Exchange archive: provides archive callback
api/agent.mjs - Exchange archive → Vercel Blob: stores exchanges
src/seen.mjs