c64bridge 0.7.4 → 0.8.1

package/mcp/schemas/c64_graphics.schema.json

@@ -0,0 +1,333 @@
+{
+  "type": "object",
+  "description": "Graphics operations available via the c64_graphics tool.",
+  "oneOf": [
+    {
+      "type": "object",
+      "description": "Capture one or more complete video frames from the active backend.",
+      "properties": {
+        "op": {
+          "const": "capture_frame"
+        },
+        "count": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Number of frames to capture.",
+          "minimum": 1,
+          "maximum": 32,
+          "default": 1
+        },
+        "includePixels": {
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "description": "Include pixel payload bytes in the response.",
+          "default": true
+        },
+        "encoding": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Encoding used for the pixel payload when included.",
+          "enum": [
+            "base64",
+            "hex"
+          ],
+          "default": "base64"
+        }
+      },
+      "required": [
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Create PETSCII art from prompts, text, or explicit bitmap data, and optionally display it on the C64.",
+      "properties": {
+        "prompt": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Natural language prompt describing the desired PETSCII art.",
+          "minLength": 1
+        },
+        "text": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Exact text to render in PETSCII (overrides prompt derivation).",
+          "minLength": 1
+        },
+        "maxWidth": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Maximum bitmap width in pixels (1-320).",
+          "minimum": 1,
+          "maximum": 320
+        },
+        "maxHeight": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Maximum bitmap height in pixels (1-200).",
+          "minimum": 1,
+          "maximum": 200
+        },
+        "borderColor": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Border colour index (0-15).",
+          "minimum": 0,
+          "maximum": 15
+        },
+        "backgroundColor": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Background colour index (0-15).",
+          "minimum": 0,
+          "maximum": 15
+        },
+        "foregroundColor": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Foreground colour index (0-15).",
+          "minimum": 0,
+          "maximum": 15
+        },
+        "dryRun": {
+          "type": "boolean",
+          "description": "When true, skip uploading the generated BASIC program to the C64.",
+          "default": false
+        },
+        "bitmap": {
+          "description": "Explicit bitmap definition for PETSCII rendering.",
+          "type": [
+            "object",
+            "null"
+          ],
+          "properties": {
+            "width": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 320
+            },
+            "height": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 200
+            },
+            "pixels": {
+              "type": "array",
+              "items": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 1
+              }
+            }
+          },
+          "required": [
+            "width",
+            "height",
+            "pixels"
+          ],
+          "additionalProperties": false
+        },
+        "op": {
+          "const": "render_petscii_art"
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "op"
+      ]
+    },
+    {
+      "type": "object",
+      "description": "Display PETSCII text with optional border and background colours.",
+      "properties": {
+        "text": {
+          "type": "string",
+          "description": "The PETSCII text to print after clearing the screen.",
+          "minLength": 1
+        },
+        "borderColor": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Border colour index (0-15).",
+          "minimum": 0,
+          "maximum": 15
+        },
+        "backgroundColor": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Background colour index (0-15).",
+          "minimum": 0,
+          "maximum": 15
+        },
+        "op": {
+          "const": "render_petscii_text"
+        }
+      },
+      "required": [
+        "text",
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Display supplied 63-byte sprite data at the requested position and colour by writing memory and patching VIC-II registers directly.",
+      "properties": {
+        "sprite": {
+          "description": "63-byte sprite definition provided as base64/hex string or array of bytes.",
+          "type": [
+            "string",
+            "array"
+          ],
+          "items": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 255
+          },
+          "minItems": 63,
+          "maxItems": 63
+        },
+        "index": {
+          "type": "integer",
+          "description": "Sprite index (0-7) to configure in screen memory.",
+          "minimum": 0,
+          "maximum": 7,
+          "default": 0
+        },
+        "x": {
+          "type": "integer",
+          "description": "Sprite X position (0-511).",
+          "minimum": 0,
+          "maximum": 511,
+          "default": 100
+        },
+        "y": {
+          "type": "integer",
+          "description": "Sprite Y position (0-255).",
+          "minimum": 0,
+          "maximum": 255,
+          "default": 100
+        },
+        "color": {
+          "type": "integer",
+          "description": "Sprite colour index (0-15).",
+          "minimum": 0,
+          "maximum": 15,
+          "default": 1
+        },
+        "multicolour": {
+          "type": "boolean",
+          "description": "Enable multicolour mode for the sprite.",
+          "default": false
+        },
+        "op": {
+          "const": "render_sprite"
+        }
+      },
+      "required": [
+        "sprite",
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Import an image file, convert it to VIC-II bitmap memory, write it into RAM, and display it.",
+      "properties": {
+        "imagePath": {
+          "type": "string",
+          "description": "Filesystem path of the source image (PNG, JPEG, BMP, GIF, TIFF, and other Jimp-supported formats).",
+          "minLength": 1
+        },
+        "format": {
+          "description": "Bitmap encoding mode to generate for the VIC-II display.",
+          "type": "string",
+          "enum": [
+            "hires",
+            "multicolor"
+          ]
+        },
+        "bitmapAddress": {
+          "description": "Absolute C64 memory address, provided as an integer or hex string such as $2000.",
+          "type": [
+            "integer",
+            "string",
+            "null"
+          ],
+          "default": 8192
+        },
+        "screenAddress": {
+          "description": "Absolute C64 memory address, provided as an integer or hex string such as $2000.",
+          "type": [
+            "integer",
+            "string",
+            "null"
+          ],
+          "default": 1024
+        },
+        "borderColor": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Border colour index (0-15).",
+          "minimum": 0,
+          "maximum": 15,
+          "default": 0
+        },
+        "backgroundColor": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Background colour index (0-15). Used for multicolor mode and aspect-ratio padding.",
+          "minimum": 0,
+          "maximum": 15,
+          "default": 0
+        },
+        "preserveAspect": {
+          "type": "boolean",
+          "description": "Preserve the source image aspect ratio and pad with the background colour.",
+          "default": true
+        },
+        "op": {
+          "const": "render_bitmap"
+        }
+      },
+      "required": [
+        "imagePath",
+        "format",
+        "op"
+      ],
+      "additionalProperties": false
+    }
+  ],
+  "discriminator": {
+    "propertyName": "op"
+  }
+}

package/mcp/schemas/c64_memory.schema.json

@@ -0,0 +1,155 @@
+{
+  "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"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "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
+    },
+    {
+      "type": "object",
+      "description": "Return the current 40x25 text screen converted to ASCII.",
+      "properties": {
+        "op": {
+          "const": "read_screen"
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "op"
+      ]
+    },
+    {
+      "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
+    }
+  ],
+  "discriminator": {
+    "propertyName": "op"
+  }
+}

package/mcp/schemas/c64_printer.schema.json

@@ -0,0 +1,218 @@
+{
+  "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"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "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"
+        }
+      },
+      "required": [
+        "printer",
+        "columns",
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "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"
+            ],
+            "additionalProperties": false
+          },
+          "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"
+        }
+      },
+      "required": [
+        "firstChar",
+        "chars",
+        "op"
+      ],
+      "additionalProperties": false
+    }
+  ],
+  "discriminator": {
+    "propertyName": "op"
+  }
+}