Glossary
| Term | Meaning |
|---|---|
| 2004scape | The RuneScape 2 of 2004, as recreated by the LostCity project. |
| Agent | The AI that plays an avatar: a stock coding agent (an engine) driving rs-sdk. |
| agent-runner | The per-avatar process the API spawns. It owns the game client and the sandbox and runs the autonomy loop. |
| Ambitions | Long-term aims in the avatar's TASK.md (quest points, skill levels, money). The agent picks self goals from them. |
| Autonomy loop | The part of the runner that sends the next prompt after every turn: continue, choose a goal, resume or wrap up. |
| Avatar | One in-game character owned by one owner, played by its own agent. |
| Botclient | rs-sdk's enhanced web game client. AutoRune runs it in headless Chromium while someone watches. |
| Bridge (gateway bridge) | The runner-side proxy between the sandbox and rs-sdk's gateway. It injects the real password and pins the connection to one bot. |
| Candidate | A skill with at least 3 successes and a success rate of 70 % or more, waiting for operator review. |
| Choose prompt | The automatic prompt that asks an avatar with no goal to choose one. |
| Claude subscription | The provider option that runs Claude Code on the owner's own Claude Pro/Max plan. |
| Controller | How the agent's SDK connects to the gateway: it sends actions, and the game client carries them out. |
| Desired state | What the owner wants for an avatar (running, or stopped and why), kept across restarts. |
| Egress allowlist | The short list of hosts a sandbox may reach: the owner's AI provider only. |
| Engine | The stock coding agent: opencode or Claude Code. |
execute_code | rs-sdk's MCP tool that runs a code snippet against a bot. It is the agent's main way to play. |
friends.md | An avatar's own notes about the players it befriended. |
| Gateway | rs-sdk's server that connects SDK instances and game clients by bot name. |
| Goal | What an avatar is working on: an owner goal or a self goal. |
| Lab log | bots/<bot>/lab_log.md, rs-sdk's per-bot notes, where lessons go. |
| LostCity | The open-source 2004scape server emulator that rs-sdk forks. |
| Lite client | rs-sdk's headless game client, with no rendering. Used while nobody watches. |
| MCP | Model Context Protocol: how the engine calls rs-sdk's tools. |
| Operator | An admin who reviews skills before they are shared. |
| Owner | A signed-in user who owns avatars. |
| Owner direction | Standing guidance from the owner, repeated in every automatic prompt. |
| Parked goal | An owner goal the avatar set aside because it was blocked. It is offered again later. |
| Ralph loop | Re-prompting an agent with its goal until the job is done. rs-sdk's stated research target, and the idea behind the autonomy loop. |
| rs-sdk | The research kit AutoRune is built on: SDK, MCP server, clients, gateway and a LostCity fork. |
| Sandbox | The per-avatar bubblewrap + cgroup jail the engine runs in. |
| Sibling | Another avatar of the same owner, listed in list_bots. You can message it, not control it. |
| Skill | A saved, working script with a description and stats in the skill library. |
STATUS: / GOAL: | The text lines the agent ends each reply with to report progress. |
TASK.md | The agent's notes file. AutoRune keeps its Goal, Owner direction and Finished goals sections up to date. |
| Thought stream | The live view of the agent's reasoning and tool calls in the app. |
| Turn | One round of the agent working on a prompt. |
| Warm browser | A recently watched avatar's browser client kept running (not streaming) for 3 minutes, for instant re-watch. |
| Wrap-up turn | The one extra prompt after a goal or step ends, to record the lesson and save a skill. |