c64bridge 1.0.7 → 1.1.0

package/mcp/schemas/c64_memory.schema.json

@@ -8,6 +8,7 @@
         "write",
         "read_screen",
         "wait_for_text",
+        "list_basic",
         "disassemble",
         "copy_memory",
         "fill_memory",
@@ -24,10 +25,21 @@
     },
     "length": {
       "type": "integer",
-      "description": "Number of bytes to read starting from the resolved address.",
+      "description": "Number of bytes to read starting from the resolved address. Limits depend on op.",
       "minimum": 1,
-      "maximum": 4096,
-      "default": 256
+      "maximum": 16384
+    },
+    "format": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "Output layout. hex (default) returns one hex string; dump adds a 16-bytes-per-line listing with addresses and a printable PETSCII column.",
+      "enum": [
+        "hex",
+        "dump"
+      ],
+      "default": "hex"
     },
     "bytes": {
       "type": "string",
@@ -65,7 +77,7 @@
     },
     "pattern": {
       "type": "string",
-      "description": "Substring or regex to find",
+      "description": "Substring or regex to find (at most 200 characters; regex with nested quantifiers or backreferences is rejected) Limits depend on op.",
       "minLength": 1
     },
     "isRegex": {
@@ -89,8 +101,9 @@
         "integer",
         "null"
       ],
-      "description": "Overall timeout in milliseconds",
+      "description": "Overall timeout in milliseconds (1-120000)",
       "minimum": 1,
+      "maximum": 120000,
       "default": 3000
     },
     "intervalMs": {
@@ -98,8 +111,8 @@
         "integer",
         "null"
       ],
-      "description": "Poll interval in milliseconds",
-      "minimum": 1,
+      "description": "Poll interval in milliseconds (at least 20)",
+      "minimum": 20,
       "default": 100
     },
     "instructionCount": {
@@ -107,7 +120,7 @@
         "integer",
         "null"
       ],
-      "description": "Stop after this many instructions (overrides length as a termination condition).",
+      "description": "Stop after this many instructions. When given, it replaces length: 3 x instructionCount bytes are read (fewer near $FFFF).",
       "minimum": 1,
       "maximum": 512
     },
@@ -178,487 +191,6 @@
   "required": [
     "op"
   ],
-  "description": "Memory operations available via the c64_memory tool.\n\nOperations:\n- read: Read a range of bytes and return a hex dump with address metadata. Required inputs: address. Optional inputs: length.\n- write: Write a hexadecimal byte sequence into RAM. Required inputs: address, bytes. Optional inputs: verify, expected, mask, abortOnMismatch.\n- read_screen: Return the current 40x25 text screen converted to ASCII. Required inputs: none.\n- wait_for_text: Poll the screen until a substring or regex appears, or timeout elapses. Required inputs: pattern. Optional inputs: isRegex, caseInsensitive, timeoutMs, intervalMs.\n- disassemble: Disassemble a memory region into annotated 6502/6510 instructions, including undocumented opcodes with canonical names. Symbol annotations from `.vs` files are applied when available. Works on C64U/U64, U2-family hardware, and VICE. Required inputs: address. Optional inputs: length, instructionCount.\n- copy_memory: Copy a RAM region to another address. Required inputs: source, dest, length.\n- fill_memory: Fill a memory range with a repeating byte pattern. Required inputs: address, length, pattern.\n- search_memory: Search for a byte pattern within a memory range and return matching addresses. Required inputs: startAddress, endAddress, pattern. Optional inputs: maxResults.\n- compare_memory: Compare two memory regions byte-by-byte and report differences. Required inputs: address1, address2, length. Optional inputs: maxDiffs.\n- save_memory: Dump a memory range to a local file, with an optional PRG load-address header. Required inputs: startAddress, endAddress, filePath. Optional inputs: asPrg.",
-  "additionalProperties": false,
-  "x-c64bridge-operations": [
-    {
-      "op": "read",
-      "description": "Read a range of bytes and return a hex dump with address metadata.",
-      "required": [
-        "address"
-      ],
-      "optional": [
-        "length"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Read a range of bytes and return a hex dump with address metadata.",
-        "properties": {
-          "address": {
-            "type": "string",
-            "description": "Start address expressed as $HHHH, decimal, or a documented symbol name.",
-            "minLength": 1
-          },
-          "length": {
-            "type": "integer",
-            "description": "Number of bytes to read starting from the resolved address.",
-            "minimum": 1,
-            "maximum": 4096,
-            "default": 256
-          },
-          "op": {
-            "const": "read"
-          }
-        },
-        "required": [
-          "address",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "write",
-      "description": "Write a hexadecimal byte sequence into RAM.",
-      "required": [
-        "address",
-        "bytes"
-      ],
-      "optional": [
-        "verify",
-        "expected",
-        "mask",
-        "abortOnMismatch"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Write a hexadecimal byte sequence into RAM.",
-        "properties": {
-          "address": {
-            "type": "string",
-            "description": "Destination address expressed as $HHHH, decimal, or a documented symbol name.",
-            "minLength": 1
-          },
-          "bytes": {
-            "type": "string",
-            "description": "Hex byte sequence like $AABBCC or AA BB CC to write starting at the resolved address.",
-            "minLength": 2,
-            "pattern": "^[\\s_0-9A-Fa-f$]+$"
-          },
-          "verify": {
-            "type": "boolean",
-            "description": "When true, verify the write by reading before and after the change; Ultimate hardware also pauses during verification.",
-            "default": false
-          },
-          "expected": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "description": "Optional hex data expected before the write (verifies before writing).",
-            "minLength": 2,
-            "pattern": "^[\\s_0-9A-Fa-f$]+$"
-          },
-          "mask": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "description": "Optional verification mask (hex); only bits set in the mask are compared.",
-            "minLength": 2,
-            "pattern": "^[\\s_0-9A-Fa-f$]+$"
-          },
-          "abortOnMismatch": {
-            "type": "boolean",
-            "description": "Abort the write when the pre-write verification fails.",
-            "default": true
-          },
-          "op": {
-            "const": "write"
-          }
-        },
-        "required": [
-          "address",
-          "bytes",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "read_screen",
-      "description": "Return the current 40x25 text screen converted to ASCII.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Return the current 40x25 text screen converted to ASCII.",
-        "properties": {
-          "op": {
-            "const": "read_screen"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "wait_for_text",
-      "description": "Poll the screen until a substring or regex appears, or timeout elapses.",
-      "required": [
-        "pattern"
-      ],
-      "optional": [
-        "isRegex",
-        "caseInsensitive",
-        "timeoutMs",
-        "intervalMs"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Poll the screen until a substring or regex appears, or timeout elapses.",
-        "properties": {
-          "pattern": {
-            "type": "string",
-            "description": "Substring or regex to find",
-            "minLength": 1
-          },
-          "isRegex": {
-            "type": [
-              "boolean",
-              "null"
-            ],
-            "description": "Interpret pattern as regular expression",
-            "default": false
-          },
-          "caseInsensitive": {
-            "type": [
-              "boolean",
-              "null"
-            ],
-            "description": "Case-insensitive search",
-            "default": true
-          },
-          "timeoutMs": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Overall timeout in milliseconds",
-            "minimum": 1,
-            "default": 3000
-          },
-          "intervalMs": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Poll interval in milliseconds",
-            "minimum": 1,
-            "default": 100
-          },
-          "op": {
-            "const": "wait_for_text"
-          }
-        },
-        "required": [
-          "pattern",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "disassemble",
-      "description": "Disassemble a memory region into annotated 6502/6510 instructions, including undocumented opcodes with canonical names. Symbol annotations from `.vs` files are applied when available. Works on C64U/U64, U2-family hardware, and VICE.",
-      "required": [
-        "address"
-      ],
-      "optional": [
-        "length",
-        "instructionCount"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Disassemble a memory region into annotated 6502/6510 instructions, including undocumented opcodes with canonical names. Symbol annotations from `.vs` files are applied when available. Works on C64U/U64, U2-family hardware, and VICE.",
-        "properties": {
-          "address": {
-            "type": "string",
-            "description": "Start address as $HHHH, decimal, or symbol name.",
-            "minLength": 1
-          },
-          "length": {
-            "type": "integer",
-            "description": "Number of bytes to read and disassemble.",
-            "minimum": 1,
-            "maximum": 4096,
-            "default": 64
-          },
-          "instructionCount": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Stop after this many instructions (overrides length as a termination condition).",
-            "minimum": 1,
-            "maximum": 512
-          },
-          "op": {
-            "const": "disassemble"
-          }
-        },
-        "required": [
-          "address",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "copy_memory",
-      "description": "Copy a RAM region to another address.",
-      "required": [
-        "source",
-        "dest",
-        "length"
-      ],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Copy a RAM region to another address.",
-        "properties": {
-          "source": {
-            "type": "string",
-            "description": "Source start address ($HHHH, decimal, or symbol).",
-            "minLength": 1
-          },
-          "dest": {
-            "type": "string",
-            "description": "Destination start address.",
-            "minLength": 1
-          },
-          "length": {
-            "type": "integer",
-            "description": "Number of bytes to copy (1–16384).",
-            "minimum": 1,
-            "maximum": 16384
-          },
-          "op": {
-            "const": "copy_memory"
-          }
-        },
-        "required": [
-          "source",
-          "dest",
-          "length",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "fill_memory",
-      "description": "Fill a memory range with a repeating byte pattern.",
-      "required": [
-        "address",
-        "length",
-        "pattern"
-      ],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Fill a memory range with a repeating byte pattern.",
-        "properties": {
-          "address": {
-            "type": "string",
-            "description": "Start address ($HHHH, decimal, or symbol).",
-            "minLength": 1
-          },
-          "length": {
-            "type": "integer",
-            "description": "Number of bytes to fill (1–16384).",
-            "minimum": 1,
-            "maximum": 16384
-          },
-          "pattern": {
-            "type": "string",
-            "description": "Hex bytes to repeat, e.g. 'FF' or 'AA 55'. Space-separated or run together.",
-            "minLength": 2,
-            "pattern": "^[\\s0-9A-Fa-f$]+$"
-          },
-          "op": {
-            "const": "fill_memory"
-          }
-        },
-        "required": [
-          "address",
-          "length",
-          "pattern",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "search_memory",
-      "description": "Search for a byte pattern within a memory range and return matching addresses.",
-      "required": [
-        "startAddress",
-        "endAddress",
-        "pattern"
-      ],
-      "optional": [
-        "maxResults"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Search for a byte pattern within a memory range and return matching addresses.",
-        "properties": {
-          "startAddress": {
-            "type": "string",
-            "description": "Start of search range ($HHHH, decimal, or symbol).",
-            "minLength": 1
-          },
-          "endAddress": {
-            "type": "string",
-            "description": "End of search range (inclusive).",
-            "minLength": 1
-          },
-          "pattern": {
-            "type": "string",
-            "description": "Hex bytes to find, e.g. 'A9 00' for LDA #$00.",
-            "minLength": 2,
-            "pattern": "^[\\s0-9A-Fa-f$]+$"
-          },
-          "maxResults": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Maximum matches to return (default 10).",
-            "minimum": 1,
-            "maximum": 100,
-            "default": 10
-          },
-          "op": {
-            "const": "search_memory"
-          }
-        },
-        "required": [
-          "startAddress",
-          "endAddress",
-          "pattern",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "compare_memory",
-      "description": "Compare two memory regions byte-by-byte and report differences.",
-      "required": [
-        "address1",
-        "address2",
-        "length"
-      ],
-      "optional": [
-        "maxDiffs"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Compare two memory regions byte-by-byte and report differences.",
-        "properties": {
-          "address1": {
-            "type": "string",
-            "description": "First region start address.",
-            "minLength": 1
-          },
-          "address2": {
-            "type": "string",
-            "description": "Second region start address.",
-            "minLength": 1
-          },
-          "length": {
-            "type": "integer",
-            "description": "Number of bytes to compare (1–16384).",
-            "minimum": 1,
-            "maximum": 16384
-          },
-          "maxDiffs": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Max differences to report (default 10).",
-            "minimum": 1,
-            "maximum": 200,
-            "default": 10
-          },
-          "op": {
-            "const": "compare_memory"
-          }
-        },
-        "required": [
-          "address1",
-          "address2",
-          "length",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "save_memory",
-      "description": "Dump a memory range to a local file, with an optional PRG load-address header.",
-      "required": [
-        "startAddress",
-        "endAddress",
-        "filePath"
-      ],
-      "optional": [
-        "asPrg"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Dump a memory range to a local file, with an optional PRG load-address header.",
-        "properties": {
-          "startAddress": {
-            "type": "string",
-            "description": "Start address of region to save.",
-            "minLength": 1
-          },
-          "endAddress": {
-            "type": "string",
-            "description": "End address (inclusive).",
-            "minLength": 1
-          },
-          "filePath": {
-            "type": "string",
-            "description": "Absolute or relative path for the output file.",
-            "minLength": 1
-          },
-          "asPrg": {
-            "type": [
-              "boolean",
-              "null"
-            ],
-            "description": "Prepend a 2-byte little-endian load-address header (PRG format). Default: true.",
-            "default": true
-          },
-          "op": {
-            "const": "save_memory"
-          }
-        },
-        "required": [
-          "startAddress",
-          "endAddress",
-          "filePath",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    }
-  ]
+  "description": "Memory operations available via the c64_memory tool.\n\nOperations:\n- read: Read a range of bytes and return a hex dump with address metadata. Required inputs: address. Optional inputs: length, format.\n- write [write]: Write a hexadecimal byte sequence into RAM. Required inputs: address, bytes. Optional inputs: verify, expected, mask, abortOnMismatch.\n- read_screen: Return the current 40x25 text screen converted to ASCII. Required inputs: none.\n- wait_for_text: Poll the screen until a substring or regex appears, or timeout elapses. Required inputs: pattern. Optional inputs: isRegex, caseInsensitive, timeoutMs, intervalMs.\n- list_basic: List the BASIC program in memory as text: reads the $2B-$2E pointers, walks the line links and detokenises. Works on C64U/U64, U2-family hardware, and VICE. Required inputs: none.\n- disassemble: Disassemble a memory region into annotated 6502/6510 instructions, including undocumented opcodes with canonical names. Symbol annotations from `.vs` files are applied when available. Works on C64U/U64, U2-family hardware, and VICE. Required inputs: address. Optional inputs: length, instructionCount.\n- copy_memory [write]: Copy a RAM region to another address. Required inputs: source, dest, length.\n- fill_memory [write]: Fill a memory range with a repeating byte pattern. Required inputs: address, length, pattern.\n- search_memory: Search for a byte pattern within a memory range and return matching addresses. Required inputs: startAddress, endAddress, pattern. Optional inputs: maxResults.\n- compare_memory: Compare two memory regions byte-by-byte and report differences. Required inputs: address1, address2, length. Optional inputs: maxDiffs.\n- save_memory [write]: Dump a memory range to a local file, with an optional PRG load-address header. Required inputs: startAddress, endAddress, filePath. Optional inputs: asPrg.",
+  "additionalProperties": false
 }