mcp-pine - npm Package Compare versions

Comparing version 0.2.0 to 0.2.1

dist/tools.d.ts.map

@@ -1,1 +0,1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAoKvC,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CA+EpE"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAkVvC,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CA+EpE"}

dist/tools.js

 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 const PS2_REGIONS = `
-PlayStation 2 main address space landmarks:
-  0x00000000  EE main RAM (32 MiB) — game code & data
-  0x10000000  Hardware registers (DMA, GIF, VIF, etc.)
-  0x11000000  VU0 / VU1 memory
-  0x12000000  GS privileged registers
-  0x1C000000  IOP RAM (2 MiB)
-  0x1F800000  IOP scratchpad
-  0x70000000  EE scratchpad (16 KiB)
-PINE memory operations target the EE address space.`.trim();
+PlayStation 2 main address space landmarks (PCSX2):
+  0x00100000-0x01FFFFFF  EE main RAM (32 MiB) — game code & data; the most common target
+  0x10000000             Hardware registers (DMA, GIF, VIF, etc.)
+  0x11000000             VU0 / VU1 memory
+  0x12000000             GS privileged registers
+  0x1C000000-0x1C1FFFFF  IOP RAM (2 MiB)
+  0x1F800000             IOP scratchpad
+  0x70000000             EE scratchpad (16 KiB)
+PINE memory operations target the EE address space. Other PINE-protocol
+emulators (RPCS3, Duckstation) use entirely different maps — consult their docs.`.trim();
+// ──────────────────────────────────────────────────────────────────────────────
+// Tool descriptions are written to the TDQS rubric (Glama's Tool Definition
+// Quality Score). Each description covers, in order:
+//
+//   • PURPOSE — one clear action sentence.
+//   • USAGE — when to use this vs sibling tools (read8 vs read16/32/64 vs
+//     read_range, write* vs save_state, get_status vs get_info, etc.).
+//   • BEHAVIOR — side effects, error conditions, destructive notes. Reads say
+//     "no side effects — pure read." Writes say "DESTRUCTIVE: overwrites".
+//     Every tool documents the failure modes it can return (FAIL response,
+//     timeout, alignment garbage, dropped pipeline, etc.).
+//   • RETURNS — exact shape of the success output.
+//
+// Each parameter has a `description` that adds context the schema can't
+// (units, alignment requirements, value-encoding rules, examples).
+// ──────────────────────────────────────────────────────────────────────────────
+const ADDRESS_PARAM_DESC = (widthBytes) => {
+    const alignNote = widthBytes === 1
+        ? "No alignment requirement for byte access."
+        : `MUST be ${widthBytes}-byte aligned (address % ${widthBytes} === 0). PINE on PCSX2 does NOT enforce ` +
+            `alignment — unaligned ${widthBytes * 8}-bit access typically returns whatever bytes are at the ` +
+            `aligned address below, silently corrupting the value. If you need an unaligned multi-byte read, ` +
+            `use pine_read_range and assemble the bytes yourself.`;
+    return (`Absolute byte address in the EE main address space (NOT a per-domain offset). Pass as a number; ` +
+        `hex literals like 0x00200000 are fine. Reads ${widthBytes} consecutive byte` +
+        `${widthBytes === 1 ? "" : "s"} starting here. ${alignNote} ` +
+        `Useful range: 0x00100000-0x01FFFFFF for EE main RAM (where 99% of game state lives). ` +
+        `An unmapped or invalid address returns a PINE FAIL response.`);
+};
+const SLOT_PARAM_DESC = "Save state slot number (0-255). PCSX2 conventionally uses slots 0-9 (mapped to F1-F10 in the GUI), " +
+    "but the PINE protocol accepts the full 0-255 range. Slot files live in PCSX2's per-game savestate " +
+    "folder (typically %USERPROFILE%/Documents/PCSX2/sstates on Windows, ~/.config/PCSX2/sstates on Linux) " +
+    "with filenames like '<serial> (<crc>).<slot>.p2s'. Slot numbers are independent of any path.";
 const TOOLS = [
+    // ── Connectivity & introspection ────────────────────────────────────────
     {
         name: "pine_ping",
-        description: "Verify the PINE connection by querying the emulator version. Returns the version string if reachable.",
+        description: "PURPOSE: Verify that the PINE server (PCSX2 or another PINE-compatible emulator) is reachable and responding to RPC over its socket. " +
+            "USAGE: Call this once at start-of-session before issuing other tool calls; if it succeeds, every other tool will work for the live emulator instance. Internally issues the PINE Version opcode (0x08) — a cheap round-trip that doubles as a liveness probe and an emulator-version sniff. " +
+            "BEHAVIOR: No side effects — pure liveness probe. The bridge connects on demand: on Linux/macOS it opens a Unix domain socket at $XDG_RUNTIME_DIR/<target>.sock.<slot> (or $TMPDIR / /tmp fallback), on Windows it opens TCP to 127.0.0.1:<slot> (default port 28011 for PCSX2). Times out after ~10 seconds with a clear error if the emulator isn't running, PINE isn't enabled (PCSX2: Settings > Advanced > Enable PINE Server), or the slot/port doesn't match. " +
+            "RETURNS: Single line 'OK — emulator: VERSION_STRING' (e.g. 'OK — emulator: PCSX2 2.6.3').",
         inputSchema: { type: "object", properties: {} },
@@ -20,3 +58,6 @@ },
         name: "pine_get_info",
-        description: "Get the loaded game's title, serial (e.g. SLUS-21274), disc CRC, game version, and emulator status.",
+        description: "PURPOSE: Get the loaded game's metadata — title, serial code, disc CRC, in-game version string — plus the current emulator run state in one call. " +
+            "USAGE: Call after pine_ping to confirm what game is loaded (don't poke memory blindly — the same address means different things across games). For just the run state without the metadata round-trips use pine_get_status (1 PINE call vs 5 here). The serial (e.g. 'SLUS-21274') uniquely identifies the disc release region; combine with disc CRC to identify a specific revision. " +
+            "BEHAVIOR: No side effects — pure read of emulator metadata. Issues five PINE opcodes in parallel (Title, ID, UUID, GameVersion, Status). Any individual field that the emulator doesn't expose or that fails is replaced with the literal string '(unavailable)' and the rest still come back. If the entire connection fails the call propagates an error. " +
+            "RETURNS: Multi-line text with Title, Serial, Disc CRC, Game version, and Status — one field per line.",
         inputSchema: { type: "object", properties: {} },
@@ -26,12 +67,23 @@ },
         name: "pine_get_status",
-        description: "Get the current emulator state: 'running', 'paused', 'shutdown', or 'unknown'.",
+        description: "PURPOSE: Get just the emulator run state — 'running', 'paused', 'shutdown', or 'unknown'. " +
+            "USAGE: Use as a cheap (single PINE round-trip) check before timing-sensitive sequences — e.g. before a sequence of memory writes you may want to confirm the emulator isn't paused (writes still work but won't take visible effect until unpaused). For game metadata (title, serial, CRC) use pine_get_info instead — that batches Status with Title/ID/UUID/GameVersion. PINE itself has no pause/resume opcode, so this tool only reports state; pause from the emulator UI or via a separate hotkey. " +
+            "BEHAVIOR: No side effects — pure read. Issues PINE Status opcode (0x0F) and decodes the 32-bit response (0=running, 1=paused, 2=shutdown, anything else='unknown'). Returns an error if the connection fails or PINE returns FAIL. " +
+            "RETURNS: Single line 'Status: STATE' where STATE is one of 'running', 'paused', 'shutdown', 'unknown'.",
         inputSchema: { type: "object", properties: {} },
     },
+    // ── Memory reads ────────────────────────────────────────────────────────
     {
         name: "pine_read8",
-        description: `Read a single unsigned byte (u8) from emulated memory.\n\n${PS2_REGIONS}`,
+        description: "PURPOSE: Read an unsigned 8-bit byte from the emulator's EE address space at the given absolute address. " +
+            "USAGE: Use for single-byte fields — status flags, counters, 8-bit enums, character bytes. For 16/32/64-bit values use pine_read16/read32/read64 (one call instead of multi-byte assembly); for spans of more than ~4 bytes use pine_read_range (one batched call instead of N round-trips). For PS2 game-state pointers and 64-bit IDs prefer pine_read64 (PS2's EE is a 128-bit MIPS — 64-bit fields are common). " +
+            "BEHAVIOR: No side effects — pure read. Reads work whether the emulator is running or paused. No alignment requirement (byte access is naturally aligned). Returns an error if the address is unmapped, the connection drops, or PINE returns its FAIL response (0xFF). The 10-second per-call timeout fires if the emulator drops the reply (PCSX2 has been observed to do this under heavy pipeline load — see pine_read_range for the wider context).\n\n" +
+            PS2_REGIONS + "\n\n" +
+            "RETURNS: Single line 'ADDR_HEX: VAL_DEC (0xVAL_HEX)', e.g. '0x00200000: 99 (0x63)'.",
         inputSchema: {
             type: "object",
             required: ["address"],
-            properties: { address: { type: "integer", description: "Memory address" } },
+            properties: {
+                address: { type: "integer", minimum: 0, description: ADDRESS_PARAM_DESC(1) },
+            },
+            additionalProperties: false,
         },
@@ -41,7 +93,14 @@ },
         name: "pine_read16",
-        description: "Read an unsigned 16-bit little-endian value from emulated memory. Address should be 2-byte aligned.",
+        description: "PURPOSE: Read an unsigned 16-bit little-endian value from the emulator's EE address space at the given absolute address. " +
+            "USAGE: Use for 16-bit fields (HP, score, coordinates on many PS2 titles). For single bytes use pine_read8; for 32/64-bit use pine_read32/read64; for unaligned reads or big-endian fields, use pine_read_range and decode the bytes yourself (this tool always interprets bytes as little-endian, which matches PS2's native EE byte order). " +
+            "BEHAVIOR: No side effects — pure read. Reads two consecutive bytes (low byte at `address`, high byte at `address+1`) and combines them as little-endian. Address MUST be 2-byte aligned — PINE silently aligns down on PCSX2, returning corrupted data instead of an error if you pass an odd address. Returns a PINE FAIL response on unmapped addresses; times out after ~10s if the reply is dropped.\n\n" +
+            PS2_REGIONS + "\n\n" +
+            "RETURNS: Single line 'ADDR_HEX: VAL_DEC (0xVAL_HEX)'.",
         inputSchema: {
             type: "object",
             required: ["address"],
-            properties: { address: { type: "integer", description: "Memory address (2-byte aligned)" } },
+            properties: {
+                address: { type: "integer", minimum: 0, description: ADDRESS_PARAM_DESC(2) },
+            },
+            additionalProperties: false,
         },
@@ -51,7 +110,14 @@ },
         name: "pine_read32",
-        description: "Read an unsigned 32-bit little-endian value from emulated memory. Address should be 4-byte aligned.",
+        description: "PURPOSE: Read an unsigned 32-bit little-endian value from the emulator's EE address space at the given absolute address. " +
+            "USAGE: Use for 32-bit fields — timestamps, large counters, RGBA colors, and the lower half of 64-bit pointers. For single byte / 16-bit / 64-bit values use pine_read8/read16/read64; for big-endian or unaligned multi-word reads use pine_read_range and decode yourself. PS2 EE pointers are technically 64-bit but the upper bits are usually zero — many tools treat them as 32-bit, in which case this is the right call. " +
+            "BEHAVIOR: No side effects — pure read. Reads four consecutive bytes starting at `address` and combines them as little-endian (LSB at `address`, MSB at `address+3`). Address MUST be 4-byte aligned — PINE on PCSX2 does not enforce this; an unaligned address silently returns corrupted data. Returns a PINE FAIL response on unmapped addresses; times out after ~10s if the reply is dropped.\n\n" +
+            PS2_REGIONS + "\n\n" +
+            "RETURNS: Single line 'ADDR_HEX: VAL_DEC (0xVAL_HEX)'.",
         inputSchema: {
             type: "object",
             required: ["address"],
-            properties: { address: { type: "integer", description: "Memory address (4-byte aligned)" } },
+            properties: {
+                address: { type: "integer", minimum: 0, description: ADDRESS_PARAM_DESC(4) },
+            },
+            additionalProperties: false,
         },
@@ -61,24 +127,53 @@ },
         name: "pine_read64",
-        description: "Read an unsigned 64-bit little-endian value from emulated memory. Address should be 8-byte aligned. Returned as a string to preserve precision past 2^53.",
+        description: "PURPOSE: Read an unsigned 64-bit little-endian value from the emulator's EE address space at the given absolute address. " +
+            "USAGE: Use for true 64-bit fields — full PS2 EE pointers, large IDs, packed double-word state. The PS2 EE is a 128-bit MIPS (Emotion Engine), and a lot of game state genuinely lives in 64-bit slots; reach for this rather than chaining two pine_read32 calls. For 8/16/32-bit values use the corresponding sibling; for byte spans use pine_read_range. " +
+            "BEHAVIOR: No side effects — pure read. Reads eight consecutive bytes starting at `address` and combines them as little-endian. Address MUST be 8-byte aligned — PINE on PCSX2 does not enforce this; unaligned addresses silently return corrupted data. The result is returned as a decimal STRING (not a JSON number) to preserve precision past 2^53 (JavaScript number limit) — parse with BigInt if you need to do arithmetic. Returns a PINE FAIL response on unmapped addresses; times out after ~10s if the reply is dropped.\n\n" +
+            PS2_REGIONS + "\n\n" +
+            "RETURNS: Single line 'ADDR_HEX: VAL_DEC (0xVAL_HEX)' — VAL_DEC is a decimal string that may exceed 2^53.",
         inputSchema: {
             type: "object",
             required: ["address"],
-            properties: { address: { type: "integer", description: "Memory address (8-byte aligned)" } },
+            properties: {
+                address: { type: "integer", minimum: 0, description: ADDRESS_PARAM_DESC(8) },
+            },
+            additionalProperties: false,
         },
     },
     {
-        name: "pine_write8",
-        description: "Write a byte (u8) to emulated RAM. Writes to ROM/read-only regions are silently ignored by the emulator.",
+        name: "pine_read_range",
+        description: "PURPOSE: Read a contiguous range of bytes from the emulator's EE address space and return them as a hex-formatted dump. " +
+            "USAGE: Use whenever you need more than ~4 bytes — far cheaper than looping pine_read8 since this tool batches the work into the largest aligned loads available (read64 on 8-byte boundaries, falling back to 32/16/8 at the unaligned edges). Hard cap of 4096 bytes per call; for larger reads, batch in 4 KiB chunks yourself. Classic uses: snapshot-diff RAM hunts (snapshot before a known game change, snapshot after, diff for matching deltas), inspecting unknown structs, capturing a region for later restore via cheats. " +
+            "BEHAVIOR: No side effects — pure read. PINE has NO native bulk-read opcode; this tool synthesizes the range by issuing a sequence of read64/32/16/8 calls and assembling the bytes client-side. By default it issues these calls FULLY SERIALLY (one in flight at a time) because PCSX2's PINE server has a fragile request queue — at as few as ~7 mixed in-flight requests it silently drops replies, which leaves the bridge's reply pipeline desynced and times out ALL subsequent calls until the emulator is restarted. Loopback is fast enough that serial is OK (~52 ms for 4096 bytes against PCSX2 v2.6.3). The PINE_PIPELINE_BATCH env var can raise the in-flight count if you trust your specific emulator's PINE implementation. Returns an error if length < 1 or > 4096, if any underlying read FAILs, or if a reply times out.\n\n" +
+            PS2_REGIONS + "\n\n" +
+            "RETURNS: Header line 'ADDR_HEX [N bytes]:' followed by space-separated 2-digit uppercase hex bytes.",
         inputSchema: {
             type: "object",
-            required: ["address", "value"],
+            required: ["address", "length"],
             properties: {
-                address: { type: "integer", description: "Memory address" },
-                value: { type: "integer", minimum: 0, maximum: 255 },
+                address: {
+                    type: "integer",
+                    minimum: 0,
+                    description: "Starting absolute byte address in the EE address space. Bytes [address, address+length) are read. " +
+                        "No alignment requirement — the tool picks the largest aligned load it can at each step (e.g. an unaligned start, " +
+                        "an aligned middle, and an unaligned tail are handled in three different load widths)."
+                },
+                length: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: 4096,
+                    description: "Number of consecutive bytes to read (1-4096). Hard cap is the tool's max; chunk larger reads yourself. " +
+                        "Latency is roughly proportional to length / 8 in serial mode (the default) — a 4096-byte read is ~512 PINE round-trips on a typical 8-byte-aligned region, around 50 ms over loopback."
+                },
             },
+            additionalProperties: false,
         },
     },
+    // ── Memory writes ───────────────────────────────────────────────────────
     {
-        name: "pine_write16",
-        description: "Write a 16-bit value (LE) to emulated RAM. Address must be 2-byte aligned.",
+        name: "pine_write8",
+        description: "PURPOSE: Write a single unsigned byte (0-255) to the emulator's EE address space at the given absolute address. " +
+            "USAGE: Use for single-byte cheats, debug pokes, and game-state mutations (give a player N lives, unlock a flag, set a counter). For 16/32/64-bit values prefer pine_write16/write32/write64 (single call instead of byte-at-a-time, and atomic from the emulator's perspective). For seeding many bytes there is no native bulk write — loop pine_write8 yourself or batch via pine_write64 on aligned regions. To roll back later use pine_save_state BEFORE the write and pine_load_state to restore. " +
+            "BEHAVIOR: DESTRUCTIVE: overwrites whatever was at `address` with no undo. The write is direct memory access — bypasses TLB protection and any DMA semantics — so writes to read-only regions (BIOS, IOP ROM, etc.) are silently dropped by PCSX2 with no error. The write takes effect immediately, but visible game-state effects only appear when the emulator next ticks (so writing while paused shows changes only after unpause or frame-step). No alignment requirement for byte access. Returns an error if the connection drops or PINE returns FAIL on a wholly invalid address.\n\n" +
+            PS2_REGIONS + "\n\n" +
+            "RETURNS: Single line 'Wrote VAL_DEC (0xVAL_HEX) → ADDR_HEX'.",
         inputSchema: {
@@ -88,10 +183,20 @@ type: "object",
             properties: {
-                address: { type: "integer", description: "Memory address (2-byte aligned)" },
-                value: { type: "integer", minimum: 0, maximum: 65535 },
+                address: { type: "integer", minimum: 0, description: ADDRESS_PARAM_DESC(1) },
+                value: {
+                    type: "integer",
+                    minimum: 0,
+                    maximum: 255,
+                    description: "Byte value to write. Must be 0-255 (0x00-0xFF). Values outside this range are rejected by the schema."
+                },
             },
+            additionalProperties: false,
         },
     },
     {
-        name: "pine_write32",
-        description: "Write a 32-bit value (LE) to emulated RAM. Address must be 4-byte aligned.",
+        name: "pine_write16",
+        description: "PURPOSE: Write an unsigned 16-bit little-endian value to the emulator's EE address space at the given absolute address. " +
+            "USAGE: Use for 16-bit cheats and pokes (HP, score, coordinates). For single bytes use pine_write8; for 32/64-bit use pine_write32/write64; for big-endian fields, byteswap into a value with the bytes reversed yourself before calling — this tool always writes little-endian. To roll back, snapshot first via pine_save_state. " +
+            "BEHAVIOR: DESTRUCTIVE: overwrites two bytes (low byte at `address`, high byte at `address+1`) with no undo. Direct memory write — bypasses TLB protection; writes to read-only regions are silently dropped. Address MUST be 2-byte aligned — PINE on PCSX2 does NOT enforce this; an unaligned address writes the bytes at the aligned address below, silently corrupting unrelated state. Returns an error if the connection drops or PINE returns FAIL on a wholly invalid address.\n\n" +
+            PS2_REGIONS + "\n\n" +
+            "RETURNS: Single line 'Wrote VAL_DEC (0xVAL_HEX) → ADDR_HEX'.",
         inputSchema: {
@@ -101,10 +206,21 @@ type: "object",
             properties: {
-                address: { type: "integer", description: "Memory address (4-byte aligned)" },
-                value: { type: "integer", minimum: 0 },
+                address: { type: "integer", minimum: 0, description: ADDRESS_PARAM_DESC(2) },
+                value: {
+                    type: "integer",
+                    minimum: 0,
+                    maximum: 65535,
+                    description: "16-bit value to write. Must be 0-65535 (0x0000-0xFFFF). LSB lands at `address`, MSB at `address+1`. " +
+                        "For signed 16-bit values, encode as two's complement (e.g. -1 → 0xFFFF). Values outside the range are rejected by the schema."
+                },
             },
+            additionalProperties: false,
         },
     },
     {
-        name: "pine_write64",
-        description: "Write a 64-bit value (LE) to emulated RAM. Address must be 8-byte aligned. Pass the value as a decimal string to preserve precision past 2^53.",
+        name: "pine_write32",
+        description: "PURPOSE: Write an unsigned 32-bit little-endian value to the emulator's EE address space at the given absolute address. " +
+            "USAGE: Use for 32-bit cheats and pokes — timestamps, large counters, RGBA colors, the lower half of pointers. For single byte / 16-bit values use pine_write8/write16; for true 64-bit fields (full EE pointers, large IDs) use pine_write64 — chaining two pine_write32 calls is non-atomic and can be observed mid-update by the running game. For big-endian layouts, byteswap into a little-endian value yourself first. " +
+            "BEHAVIOR: DESTRUCTIVE: overwrites four bytes starting at `address` with no undo. Direct memory write — bypasses TLB protection and DMA mediation; writes to read-only regions (BIOS, IOP ROM) are silently dropped with no error. Address MUST be 4-byte aligned — PINE on PCSX2 does NOT enforce this; an unaligned address silently corrupts the bytes at the aligned address below, NOT what you asked for, and supplies no error. Values are NOT truncated by this tool: the schema rejects anything outside 0-4294967295 (0x00000000-0xFFFFFFFF) before the call ever reaches PINE. Returns an error if the connection drops or PINE returns FAIL on a wholly invalid address.\n\n" +
+            PS2_REGIONS + "\n\n" +
+            "RETURNS: Single line 'Wrote VAL_DEC (0xVAL_HEX) → ADDR_HEX'.",
         inputSchema: {
@@ -114,22 +230,46 @@ type: "object",
             properties: {
-                address: { type: "integer", description: "Memory address (8-byte aligned)" },
-                value: { type: "string", pattern: "^[0-9]+$", description: "Decimal string (e.g. \"18446744073709551615\")" },
+                address: { type: "integer", minimum: 0, description: ADDRESS_PARAM_DESC(4) },
+                value: {
+                    type: "integer",
+                    minimum: 0,
+                    maximum: 4294967295,
+                    description: "32-bit value to write. Must be 0-4294967295 (0x00000000-0xFFFFFFFF). LSB lands at `address`, MSB at `address+3`. " +
+                        "For signed 32-bit values, encode as two's complement (e.g. -1 → 0xFFFFFFFF). For floats, reinterpret the IEEE-754 bits as an integer first. " +
+                        "Values outside the range are rejected by the schema, NOT silently truncated — pass the value you actually want stored."
+                },
             },
+            additionalProperties: false,
         },
     },
     {
-        name: "pine_read_range",
-        description: "Read a contiguous range of bytes from emulated memory and return them as an array of integers. Implemented client-side as a pipelined sequence of PINE read64/32/16/8 calls (PINE has no native bulk-read), choosing the largest aligned load at each step. Maximum 4096 bytes per call. Slower than mGBA's native readRange but fast enough for cheat-table refresh and small struct dumps over loopback.",
+        name: "pine_write64",
+        description: "PURPOSE: Write an unsigned 64-bit little-endian value to the emulator's EE address space at the given absolute address. " +
+            "USAGE: Use for true 64-bit writes — full PS2 EE pointers, large IDs, packed doubleword state. Single atomic write from the emulator's perspective; preferred over chaining two pine_write32 calls when atomicity matters (a running game can observe the in-between state with the chained approach). For 8/16/32-bit values use the corresponding sibling. " +
+            "BEHAVIOR: DESTRUCTIVE: overwrites eight bytes starting at `address` with no undo. Direct memory write — bypasses TLB protection; writes to read-only regions are silently dropped. Address MUST be 8-byte aligned — PINE on PCSX2 does NOT enforce this; an unaligned address silently corrupts unrelated bytes. The `value` is passed as a DECIMAL STRING (not a JSON number) to preserve precision past 2^53 (JavaScript number limit) — pass '0' through '18446744073709551615' as a string, e.g. \"4294967296\". Strings that don't match ^[0-9]+$ are rejected by the schema. Returns an error if the connection drops or PINE returns FAIL on a wholly invalid address.\n\n" +
+            PS2_REGIONS + "\n\n" +
+            "RETURNS: Single line 'Wrote VAL_DEC (0xVAL_HEX) → ADDR_HEX' — VAL_DEC may exceed 2^53.",
         inputSchema: {
             type: "object",
-            required: ["address", "length"],
+            required: ["address", "value"],
             properties: {
-                address: { type: "integer", description: "Start address" },
-                length: { type: "integer", minimum: 1, maximum: 4096, description: "Number of bytes to read" },
+                address: { type: "integer", minimum: 0, description: ADDRESS_PARAM_DESC(8) },
+                value: {
+                    type: "string",
+                    pattern: "^[0-9]+$",
+                    description: "64-bit value to write, as a non-negative DECIMAL STRING (digits only, no '0x' prefix, no sign, no separators). " +
+                        "Range 0 through 18446744073709551615 (2^64 - 1). Example: \"18446744073709551615\" writes 0xFFFFFFFFFFFFFFFF. " +
+                        "Encoded as a string so values past 2^53 are preserved exactly (JSON numbers lose precision at that point). " +
+                        "For signed 64-bit values, encode as two's complement (e.g. -1 → \"18446744073709551615\")."
+                },
             },
+            additionalProperties: false,
         },
     },
+    // ── Save state ─────────────────────────────────────────────────────────
     {
         name: "pine_save_state",
-        description: "Trigger the emulator to save its current state to a numbered slot.",
+        description: "PURPOSE: Trigger the emulator to save its complete state (RAM, EE/IOP/VU registers, GS state, sound, timing) to the given numbered savestate slot. " +
+            "USAGE: Use as a rollback point before risky writes, to bookmark an interesting game state, or to share a repro state with a teammate. The companion pine_load_state restores from the same slot. PINE savestates are SLOT-BASED (0-255 integer), unlike file-path-based emulator APIs (e.g. BizHawk's) — the emulator decides where on disk to put the file. PCSX2's GUI uses slots 0-9 as F1-F10; programmatic use can extend up to 255 if you don't mind being outside the GUI's range. " +
+            "BEHAVIOR: DESTRUCTIVE TO TARGET SLOT: silently overwrites whatever was previously saved in that slot — no prompt, no backup, no way to recover the old state. The save is bound to the EXACT game disc and PCSX2 version that produced it; loading a slot saved against a different game or major PCSX2 version usually crashes the core. The PINE call returns immediately after PCSX2 schedules the save, NOT after the file is fully on disk — for very large states there can be a brief window where the file is half-written. Returns an error if PCSX2 has no game loaded, the savestate folder isn't writable, or PINE returns FAIL.\n\n" +
+            "RETURNS: Single line 'Save state triggered for slot N'.",
         inputSchema: {
@@ -139,4 +279,5 @@ type: "object",
             properties: {
-                slot: { type: "integer", minimum: 0, maximum: 255, description: "Save state slot (0-255)" },
+                slot: { type: "integer", minimum: 0, maximum: 255, description: SLOT_PARAM_DESC },
             },
+            additionalProperties: false,
         },
@@ -146,3 +287,6 @@ },
         name: "pine_load_state",
-        description: "Trigger the emulator to load a previously-saved state from a numbered slot.",
+        description: "PURPOSE: Trigger the emulator to load a previously-saved state from the given numbered savestate slot, replacing all live state. " +
+            "USAGE: Counterpart to pine_save_state. Use to undo a sequence of writes/inputs (the snapshot/experiment/restore workflow), to jump to a bookmarked game state, or to start each tool-call sequence from a known baseline. There is no PINE 'reset' opcode — to start fresh from boot you must use the emulator's GUI or pre-prepare a slot containing a freshly booted state. " +
+            "BEHAVIOR: DESTRUCTIVE TO LIVE STATE: replaces ALL current emulator state (RAM, registers, GS, audio, etc.) with the contents of the slot's file. Anything not previously snapshotted is lost permanently. The state file MUST come from the same game disc and same PCSX2 version that produced it; loading an incompatible state typically crashes the core (no recovery without restarting PCSX2). The PINE call returns immediately after PCSX2 schedules the load, NOT after the load is fully visible — there can be a brief window where state is partially loaded. Returns an error if the slot file doesn't exist, the file is corrupt or for the wrong game, or PINE returns FAIL.\n\n" +
+            "RETURNS: Single line 'Load state triggered for slot N'.",
         inputSchema: {
@@ -152,4 +296,5 @@ type: "object",
             properties: {
-                slot: { type: "integer", minimum: 0, maximum: 255, description: "Save state slot (0-255)" },
+                slot: { type: "integer", minimum: 0, maximum: 255, description: SLOT_PARAM_DESC },
             },
+            additionalProperties: false,
         },
@@ -156,0 +301,0 @@ },

dist/tools.js.map

@@ -1,1 +0,1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package.json

 {
   "name": "mcp-pine",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "MCP server for emulators that speak PINE (PCSX2, and other PINE-compatible emulators) — exposes memory read/write and savestate control",
@@ -5,0 +5,0 @@ "license": "MIT",

No alert changes

Improved metrics

Total package byte prevSize

101972

31.08%

Lines of code

863

25.44%

No dependency changes