Agent mode: an AI agent plays in the player's own tab, with the agent's clock or a running one

The MCP server gains a second session, --browser: the game in the player's tab, reached through the
agent relay npm run dev hosts at /agent (loopback unless --host; Host and Origin checked, no token).
The player turns it on in Settings → Agent API, a section only the development page has, and picks the
clock: a pace of 30 s to 5 min a day that nobody can pause, or the agent's own. Headless gets the
running clock too (--clock realtime --pace MS) and both get a wait tool.

All of it lives in src/agent/ (development page only). The game offers HOOKS, UI.clockLocked,
setSpeed() and runClock(dt), the frame's day block moved out unchanged, and nothing more: the page
players get grows by under 1 KB gzipped and runs exactly as before.
This commit is contained in:
Wolfgang Nagele 2026-11-03 15:30:04 -05:00
parent 2526dd458d
commit 7438fd1065
53 changed files with 1827 additions and 170 deletions

View file

@ -1,8 +1,9 @@
/* ================= AGENT API: argument domains =================
The agent facade (window.TUBES, this folder) is how tools play the game: the MCP server (scripts/mcp.js) calls it in
its own jsdom page. It is part of the development page only (<!-- @include-dev agent -->): the page players get has
none of it, so nothing in src/game/ may name anything defined here. Nothing here runs until a tool calls it: these
files only define tables and functions.
its own jsdom page, or in the player's tab through the agent relay (80-relay.js). It is part of the development page
only (<!-- @include-dev agent -->): the page players get has none of it, so nothing in src/game/ may name anything
defined here; the game offers HOOKS instead. Nothing here runs until a tool calls it or the player switches agent
mode on: these files define tables and functions, and 99-start.js wires agent mode in.
A domain is what an argument may be: an id in a catalog table, a key, an index, a small fixed list, or a check. */
const API_DOMAINS={
// Tables from the catalog: an id in a list, a key in an object, or an index into a list.