Lists ROM files available on the server (from its --roms-dir). Use the returned "name" with load_rom.

Loads a ROM into the emulator and starts the game, paused, ready for the next tool call. Provide either "name" (from list_roms) or "romBase64" + "fileName" for a ROM not in the library. Returns the first screenshot once the game has booted — this can take a while the first time a system's core is downloaded.

Hard-resets the currently loaded game (equivalent to a console reset button). Returns a fresh screenshot.

Captures the current emulator frame as a PNG image, without changing emulator state.

Presses or releases a controller button. The emulator briefly resumes just long enough for the input to register, then pauses again — so it never runs unattended while you're "thinking". To hold a direction across multiple skip_frames() calls, send state="down" once and state="up" later.

Advances the emulator by exactly N core-internal frames (frame-accurate, not wall-clock), then pauses and returns a fresh screenshot. Use this to let held inputs or animations play out. Above ~180 frames, native fast-forward is used so long waits do not block on real time.