c64bridge 0.8.1 → 0.9.0

package/mcp/schemas/c64_memory.schema.json

@@ -1,155 +1,105 @@
 {
   "type": "object",
-  "description": "Memory operations available via the c64_memory tool.",
-  "oneOf": [
-    {
-      "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"
+  "properties": {
+    "op": {
+      "type": "string",
+      "enum": [
+        "read",
+        "write",
+        "read_screen",
+        "wait_for_text"
       ],
-      "additionalProperties": false
+      "description": "Selects the operation."
     },
-    {
-      "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"
+    "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
+    },
+    "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"
       ],
-      "additionalProperties": false
+      "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
     },
-    {
-      "type": "object",
-      "description": "Return the current 40x25 text screen converted to ASCII.",
-      "properties": {
-        "op": {
-          "const": "read_screen"
-        }
-      },
-      "additionalProperties": false,
-      "required": [
-        "op"
-      ]
+    "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
     },
-    {
-      "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"
+    "intervalMs": {
+      "type": [
+        "integer",
+        "null"
       ],
-      "additionalProperties": false
+      "description": "Poll interval in milliseconds",
+      "minimum": 1,
+      "default": 100
     }
+  },
+  "required": [
+    "op"
   ],
-  "discriminator": {
-    "propertyName": "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.\n- write: Write a hexadecimal byte sequence into RAM.\n- read_screen: Return the current 40x25 text screen converted to ASCII.\n- wait_for_text: Poll the screen until a substring or regex appears, or timeout elapses.",
+  "additionalProperties": false
 }

package/mcp/schemas/c64_printer.schema.json

@@ -1,218 +1,164 @@
 {
   "type": "object",
-  "description": "Printer operations available via the c64_printer tool.",
-  "oneOf": [
-    {
-      "type": "object",
-      "description": "Generate BASIC that prints text to device 4.",
-      "properties": {
-        "text": {
-          "type": "string",
-          "description": "Text to print on the connected printer.",
-          "minLength": 1
-        },
-        "target": {
-          "description": "Printer target: Commodore MPS (PETSCII) or Epson FX (ESC/P).",
-          "type": "string",
-          "enum": [
-            "commodore",
-            "epson"
-          ],
-          "default": "commodore"
-        },
-        "secondaryAddress": {
-          "description": "Secondary address for device 4 (0 = upper/graphics, 7 = lowercase).",
-          "type": [
-            "integer",
-            "null"
-          ],
-          "enum": [
-            0,
-            7
-          ]
-        },
-        "formFeed": {
-          "type": "boolean",
-          "description": "Emit a form-feed (CHR$(12)) at the end of the job.",
-          "default": false
-        },
-        "op": {
-          "const": "print_text"
-        }
-      },
-      "required": [
-        "text",
-        "op"
+  "properties": {
+    "op": {
+      "type": "string",
+      "enum": [
+        "print_text",
+        "print_bitmap",
+        "define_chars"
       ],
-      "additionalProperties": false
+      "description": "Selects the operation."
     },
-    {
-      "type": "object",
-      "description": "Print a bitmap row via Commodore (BIM) or Epson ESC/P workflows.",
-      "properties": {
-        "printer": {
-          "type": "string",
-          "description": "Target printer family.",
-          "enum": [
-            "commodore",
-            "epson"
-          ],
-          "default": "commodore"
-        },
-        "columns": {
-          "type": "array",
-          "description": "Sequence of bitmap columns.",
-          "items": {
-            "type": "integer",
-            "description": "Bitmap column byte (0-255).",
-            "minimum": 0,
-            "maximum": 255
-          },
-          "minItems": 1
-        },
-        "repeats": {
-          "type": [
-            "integer",
-            "null"
-          ],
-          "description": "Number of times to repeat the row (1-255).",
-          "minimum": 1,
-          "maximum": 255
-        },
-        "useSubRepeat": {
-          "type": [
-            "integer",
-            "null"
-          ],
-          "description": "Repeat the next byte this many times (Commodore BIM SUB).",
-          "minimum": 1,
-          "maximum": 255
-        },
-        "secondaryAddress": {
-          "type": [
-            "integer",
-            "null"
-          ],
-          "description": "Secondary address for device 4 (0 or 7).",
-          "minimum": 0,
-          "maximum": 7
-        },
-        "ensureMsb": {
-          "type": "boolean",
-          "description": "Ensure MSB set for Commodore printers.",
-          "default": true
-        },
-        "mode": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "description": "Epson ESC/P graphics mode (K/L/Y/Z/*).",
-          "minLength": 1,
-          "maxLength": 1
-        },
-        "density": {
-          "type": [
-            "integer",
-            "null"
-          ],
-          "description": "Density parameter when using Epson mode '*'.",
-          "minimum": 0,
-          "maximum": 3
-        },
-        "timesPerLine": {
-          "type": [
-            "integer",
-            "null"
-          ],
-          "description": "Number of times to print the row per line (1-10).",
-          "minimum": 1,
-          "maximum": 10
-        },
-        "op": {
-          "const": "print_bitmap"
-        }
+    "text": {
+      "type": "string",
+      "description": "Text to print on the connected printer.",
+      "minLength": 1
+    },
+    "target": {
+      "description": "Printer target: Commodore MPS (PETSCII) or Epson FX (ESC/P).",
+      "type": "string",
+      "enum": [
+        "commodore",
+        "epson"
+      ],
+      "default": "commodore"
+    },
+    "secondaryAddress": {
+      "description": "Secondary address for device 4 (0 = upper/graphics, 7 = lowercase).",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "enum": [
+        0,
+        7
+      ]
+    },
+    "formFeed": {
+      "type": "boolean",
+      "description": "Emit a form-feed (CHR$(12)) at the end of the job.",
+      "default": false
+    },
+    "printer": {
+      "type": "string",
+      "description": "Target printer family.",
+      "enum": [
+        "commodore",
+        "epson"
+      ],
+      "default": "commodore"
+    },
+    "columns": {
+      "type": "array",
+      "description": "Sequence of bitmap columns.",
+      "items": {
+        "type": "integer",
+        "description": "Bitmap column byte (0-255).",
+        "minimum": 0,
+        "maximum": 255
       },
-      "required": [
-        "printer",
-        "columns",
-        "op"
+      "minItems": 1
+    },
+    "repeats": {
+      "type": [
+        "integer",
+        "null"
       ],
-      "additionalProperties": false
+      "description": "Number of times to repeat the row (1-255).",
+      "minimum": 1,
+      "maximum": 255
     },
-    {
-      "type": "object",
-      "description": "Define custom printer characters (Commodore DLL mode).",
-      "properties": {
-        "firstChar": {
-          "type": "integer",
-          "description": "PETSCII code of first character to redefine (33-126).",
-          "minimum": 33,
-          "maximum": 126
-        },
-        "chars": {
-          "type": "array",
-          "description": "Character definitions to upload (1-32).",
-          "items": {
-            "type": "object",
-            "description": "Commodore MPS DLL character definition (11 columns).",
-            "properties": {
-              "a": {
-                "description": "Attribute flag (0=normal, 1=graphics).",
-                "type": [
-                  "integer",
-                  "null"
-                ],
-                "enum": [
-                  0,
-                  1
-                ]
-              },
-              "columns": {
-                "type": "array",
-                "description": "11 column bytes describing the character.",
-                "items": {
-                  "type": "integer",
-                  "description": "Column byte (0-255).",
-                  "minimum": 0,
-                  "maximum": 255
-                },
-                "minItems": 11,
-                "maxItems": 11
-              }
-            },
-            "required": [
-              "columns"
+    "useSubRepeat": {
+      "type": [
+        "integer",
+        "null"
+      ],
+      "description": "Repeat the next byte this many times (Commodore BIM SUB).",
+      "minimum": 1,
+      "maximum": 255
+    },
+    "ensureMsb": {
+      "type": "boolean",
+      "description": "Ensure MSB set for Commodore printers.",
+      "default": true
+    },
+    "mode": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "Epson ESC/P graphics mode (K/L/Y/Z/*).",
+      "minLength": 1,
+      "maxLength": 1
+    },
+    "density": {
+      "type": [
+        "integer",
+        "null"
+      ],
+      "description": "Density parameter when using Epson mode '*'.",
+      "minimum": 0,
+      "maximum": 3
+    },
+    "timesPerLine": {
+      "type": [
+        "integer",
+        "null"
+      ],
+      "description": "Number of times to print the row per line (1-10).",
+      "minimum": 1,
+      "maximum": 10
+    },
+    "firstChar": {
+      "type": "integer",
+      "description": "PETSCII code of first character to redefine (33-126).",
+      "minimum": 33,
+      "maximum": 126
+    },
+    "chars": {
+      "type": "array",
+      "description": "Character definitions to upload (1-32).",
+      "items": {
+        "type": "object",
+        "description": "Commodore MPS DLL character definition (11 columns).",
+        "properties": {
+          "a": {
+            "description": "Attribute flag (0=normal, 1=graphics).",
+            "type": [
+              "integer",
+              "null"
             ],
-            "additionalProperties": false
+            "enum": [
+              0,
+              1
+            ]
           },
-          "minItems": 1,
-          "maxItems": 32
-        },
-        "secondaryAddress": {
-          "description": "Secondary address for device 4 (0 = upper/graphics, 7 = lowercase).",
-          "type": [
-            "integer",
-            "null"
-          ],
-          "enum": [
-            0,
-            7
-          ]
-        },
-        "op": {
-          "const": "define_chars"
-        }
+          "columns": {
+            "type": "array",
+            "description": "11 column bytes describing the character.",
+            "items": {
+              "type": "integer",
+              "description": "Column byte (0-255).",
+              "minimum": 0,
+              "maximum": 255
+            },
+            "minItems": 11,
+            "maxItems": 11
+          }
+        },
+        "required": [
+          "columns"
+        ],
+        "additionalProperties": false
       },
-      "required": [
-        "firstChar",
-        "chars",
-        "op"
-      ],
-      "additionalProperties": false
+      "minItems": 1,
+      "maxItems": 32
     }
+  },
+  "required": [
+    "op"
   ],
-  "discriminator": {
-    "propertyName": "op"
-  }
+  "description": "Printer operations available via the c64_printer tool.\n\nOperations:\n- print_text: Generate BASIC that prints text to device 4.\n- print_bitmap: Print a bitmap row via Commodore (BIM) or Epson ESC/P workflows.\n- define_chars: Define custom printer characters (Commodore DLL mode).",
+  "additionalProperties": false
 }