Package-level declarations

Whether a captured chat line is something run_command target=client may hand back by default.

Runs a Minecraft command on the server thread and captures its chat feedback, for the run_command MCP tool. Vanilla mechanism throughout: a custom CommandSource collects the feedback the command would normally print, attached to a server-level (OP) CommandSourceStack, executed via Commands#performPrefixedCommand.

Everything this endpoint puts on the wire: JSON-RPC envelopes, MCP tool results and the tools/list prose. All pure functions of their arguments, which is why they are here rather than in McpServer — that file keeps what needs a live server behind it.

The single MCP endpoint the mod exposes: Streamable HTTP, bound to loopback, Bearer-token gated. Three tools: execute_code (runs Kotlin inside the running game via ReplBridge), run_command (runs a Minecraft command) and take_screenshot (the client's framebuffer, as an image).

Captures the game's framebuffer for the take_screenshot tool.

eval's outcome, writing a space every second meanwhile: whitespace before the JSON is harmless, and a write is the only thing that notices a hangup — as the IOException it throws. ex is null for a notification.

stringOr's contract for booleans: "false" is a string, not a false, and folding the two would turn a typo into a policy.

Stable string form of a JSON-RPC id for the in-flight key: 2 ->"2", "a" ->"\"a\"". The cancellation's requestId is stringified the same way, so the two match.

A nested object, or an empty one: a missing member and a non-object one both mean "no fields to read".

isString, not isJsonPrimitive: gson's asString stringifies a number or boolean and cannot be told not to, so {"code": 123} would compile and run 123. Absent (or JSON null) reads as missing; a null return means present with the wrong type, which the caller refuses rather than folding into missing.