c64bridge 0.8.1 → 0.9.1

package/mcp/schemas/c64_printer.schema.json

@@ -1,218 +1,415 @@
 {
   "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
+  "properties": {
+    "op": {
+      "type": "string",
+      "enum": [
+        "print_text",
+        "print_bitmap",
+        "define_chars"
+      ],
+      "description": "Selects the operation."
+    },
+    "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
+      },
+      "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
+    },
+    "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"
+            ],
+            "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
+          }
         },
-        "op": {
-          "const": "print_text"
-        }
+        "required": [
+          "columns"
+        ],
+        "additionalProperties": false
       },
+      "minItems": 1,
+      "maxItems": 32
+    }
+  },
+  "required": [
+    "op"
+  ],
+  "description": "Printer operations available via the c64_printer tool.\n\nOperations:\n- print_text: Generate BASIC that prints text to device 4. Required inputs: text. Optional inputs: target, secondaryAddress, formFeed.\n- print_bitmap: Print a bitmap row via Commodore (BIM) or Epson ESC/P workflows. Required inputs: printer, columns. Optional inputs: repeats, useSubRepeat, secondaryAddress, ensureMsb, mode, density, timesPerLine.\n- define_chars: Define custom printer characters (Commodore DLL mode). Required inputs: firstChar, chars. Optional inputs: secondaryAddress.",
+  "additionalProperties": false,
+  "x-c64bridge-operations": [
+    {
+      "op": "print_text",
+      "description": "Generate BASIC that prints text to device 4.",
       "required": [
-        "text",
-        "op"
+        "text"
+      ],
+      "optional": [
+        "target",
+        "secondaryAddress",
+        "formFeed"
       ],
-      "additionalProperties": false
+      "inputSchema": {
+        "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",
+      "op": "print_bitmap",
       "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"
+        "columns"
       ],
-      "additionalProperties": false
+      "optional": [
+        "repeats",
+        "useSubRepeat",
+        "secondaryAddress",
+        "ensureMsb",
+        "mode",
+        "density",
+        "timesPerLine"
+      ],
+      "inputSchema": {
+        "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",
+      "op": "define_chars",
       "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
+      "required": [
+        "firstChar",
+        "chars"
+      ],
+      "optional": [
+        "secondaryAddress"
+      ],
+      "inputSchema": {
+        "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
+                  ]
                 },
-                "minItems": 11,
-                "maxItems": 11
-              }
+                "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": [
-              "columns"
+            "minItems": 1,
+            "maxItems": 32
+          },
+          "secondaryAddress": {
+            "description": "Secondary address for device 4 (0 = upper/graphics, 7 = lowercase).",
+            "type": [
+              "integer",
+              "null"
             ],
-            "additionalProperties": false
+            "enum": [
+              0,
+              7
+            ]
           },
-          "minItems": 1,
-          "maxItems": 32
+          "op": {
+            "const": "define_chars"
+          }
         },
-        "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
+        "required": [
+          "firstChar",
+          "chars",
+          "op"
+        ],
+        "additionalProperties": false
+      }
     }
-  ],
-  "discriminator": {
-    "propertyName": "op"
-  }
+  ]
 }