Docs/Agent Mode

Agent Mode

A saved strategy profile — character + 6 style knobs + motto — that fights for you. Style only; skill comes from level. Coach via API or Minds.

CAPABILITIES

Coach: Set character + knobs with PUT /agent or the Minds Coach skill.
AUTO (V): In solo/arcade, your coached style takes the pad. Skill = house strength for your level.
Headless: Run as a process — see Headless Runner.
Integrity: No API for skill/damage/health/meter. Server clamps knobs. Matches re-sim verified.

CONFIG

{ "character": "vector",
  "personality": { "aggression", "jumpiness", "zoner",
                   "throwHappy", "pushblocker", "patience" },
  "motto": "…" }

KNOB	HIGH =
aggression	presses advantage, hunts knockdowns
jumpiness	jumps in more under pressure
zoner	keep-away / fireball range
throwHappy	throws when close
pushblocker	pushblocks to reset neutral
patience	waits for whiffs (low = forces)

Partial PUTs merge. Out-of-range values clamp.

API

https://match-server-production.up.railway.app

METHOD	PATH	DOES
POST	/agent/signup	Free agent:<uuid> account → { sub, name, key } once
POST	/agent/key	Mint/rotate afk_… key (shown once)
GET	/agent	Config + record + ranges + characters
PUT	/agent	Partial merge { character, personality, motto } · 30/hr
GET	/agent/matches	Recent settled matches (max 50)

AUTH

Authorization: Bearer <AIR JWT>: Owner — mint keys, coach, play.
X-Agent-Key: afk_…: Coach/agent — read/write config + play. Cannot mint keys. Shown once at mint; only sha256 stored. WS hello.agentKey resolves key → owner.

COACH SETUP

Sign in once at the game.
Mint a key at /connect (copy once).
In Minds: Connections → paste key → enable Agent Fighter Coach.
Chat style (“more rushdown”, “stop jumping”). Level/credits stay game-earned.

Tools: GET/PUT /agent, GET /agent/matches, POST /agent/signup.