c64bridge 1.0.6 → 1.1.0

package/mcp/schemas/c64_input.schema.json

@@ -15,7 +15,7 @@
     },
     "text": {
       "type": "string",
-      "description": "Text to type. Use {RETURN}, {CLR}, {F1}…{F8}, {UP/DOWN/LEFT/RIGHT}, colour names, etc.",
+      "description": "Text to type: printable ASCII (letters are sent as PETSCII upper case), \\n for RETURN, and {TOKEN}s such as {RETURN}, {CLR}, {F1}…{F8}, {UP}, {DOWN}, {LEFT}, {RIGHT}, colour names, or {$1D}/{29} codes. Characters with no PETSCII mapping and unknown tokens are rejected.",
       "minLength": 1,
       "maxLength": 512
     },
@@ -40,10 +40,9 @@
         "integer",
         "null"
       ],
-      "description": "Delay in ms after each queued key press before the next press (default 0 = no delay).",
+      "description": "Delay in ms after each queued key press before the next press (default 0 = no delay). Limits depend on op.",
       "minimum": 0,
-      "maximum": 5000,
-      "default": 0
+      "maximum": 5000
     },
     "count": {
       "type": [
@@ -178,318 +177,6 @@
   "required": [
     "op"
   ],
-  "description": "Input operations: write_text, key, keyboard, joystick, release_all, state.\n\nOperations:\n- write_text: Send a text string to the keyboard buffer, with PETSCII token expansion. Required inputs: text. Optional inputs: delayMs.\n- key: Tap a single key or hold it for a duration. Required inputs: key. Optional inputs: durationMs, count.\n- joystick: Simulate joystick input. On C64U/U64 this uses machine:input. On VICE it attaches VICE's I/O simulation joyport device while pressed; that device also pulls CIA lines 5-7 low, so port 1 produces phantom keys (e.g. SHIFT+C=) and port 2 reads $1E for up instead of $7E. Prefer port 2 on VICE and test bits 0-4. Required inputs: port, controls, action. Optional inputs: durationMs.\n- keyboard: Send physical C64 keyboard matrix events through machine:input (a C64U firmware version that provides it, or U64 3.15+). Required inputs: inputs, transition.\n- release_all: Release every key and joystick control injected through machine:input (a C64U firmware version that provides it, or U64 3.15+). Required inputs: none.\n- state: Read the keys and joystick controls held through machine:input (a C64U firmware version that provides it, or U64 3.15+). Required inputs: none.",
-  "additionalProperties": false,
-  "x-c64bridge-operations": [
-    {
-      "op": "write_text",
-      "description": "Send a text string to the keyboard buffer, with PETSCII token expansion.",
-      "required": [
-        "text"
-      ],
-      "optional": [
-        "delayMs"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Send a text string to the keyboard buffer, with PETSCII token expansion.",
-        "properties": {
-          "op": {
-            "const": "write_text"
-          },
-          "text": {
-            "type": "string",
-            "description": "Text to type. Use {RETURN}, {CLR}, {F1}…{F8}, {UP/DOWN/LEFT/RIGHT}, colour names, etc.",
-            "minLength": 1,
-            "maxLength": 512
-          },
-          "delayMs": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Delay in ms after sending (default 0).",
-            "minimum": 0,
-            "maximum": 10000,
-            "default": 0
-          }
-        },
-        "required": [
-          "op",
-          "text"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "key",
-      "description": "Tap a single key or hold it for a duration.",
-      "required": [
-        "key"
-      ],
-      "optional": [
-        "durationMs",
-        "count"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Tap a single key or hold it for a duration.",
-        "properties": {
-          "op": {
-            "const": "key"
-          },
-          "key": {
-            "type": "string",
-            "description": "Key to press: a printable character, or a PETSCII token name (RETURN, F1…F8, UP, etc.).",
-            "minLength": 1,
-            "maxLength": 32
-          },
-          "durationMs": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Delay in ms after each queued key press before the next press (default 0 = no delay).",
-            "minimum": 0,
-            "maximum": 5000,
-            "default": 0
-          },
-          "count": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Number of times to press the key (default 1).",
-            "minimum": 1,
-            "maximum": 100,
-            "default": 1
-          }
-        },
-        "required": [
-          "op",
-          "key"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "joystick",
-      "description": "Simulate joystick input. On C64U/U64 this uses machine:input. On VICE it attaches VICE's I/O simulation joyport device while pressed; that device also pulls CIA lines 5-7 low, so port 1 produces phantom keys (e.g. SHIFT+C=) and port 2 reads $1E for up instead of $7E. Prefer port 2 on VICE and test bits 0-4.",
-      "required": [
-        "port",
-        "controls",
-        "action"
-      ],
-      "optional": [
-        "durationMs"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Simulate joystick input. On C64U/U64 this uses machine:input. On VICE it attaches VICE's I/O simulation joyport device while pressed; that device also pulls CIA lines 5-7 low, so port 1 produces phantom keys (e.g. SHIFT+C=) and port 2 reads $1E for up instead of $7E. Prefer port 2 on VICE and test bits 0-4.",
-        "properties": {
-          "op": {
-            "const": "joystick"
-          },
-          "port": {
-            "type": "integer",
-            "description": "Joystick port (1 or 2).",
-            "minimum": 1,
-            "maximum": 2
-          },
-          "controls": {
-            "type": "array",
-            "description": "List of controls to activate simultaneously.",
-            "items": {
-              "type": "string",
-              "description": "Control to activate.",
-              "enum": [
-                "up",
-                "down",
-                "left",
-                "right",
-                "fire",
-                "fire2",
-                "fire3"
-              ]
-            },
-            "minItems": 0
-          },
-          "action": {
-            "type": "string",
-            "description": "press = hold until a release call; release = restore all bits; tap = press then release after durationMs.",
-            "enum": [
-              "press",
-              "release",
-              "tap"
-            ]
-          },
-          "durationMs": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Duration to hold for tap action in ms (default 80).",
-            "minimum": 10,
-            "maximum": 5000,
-            "default": 80
-          }
-        },
-        "required": [
-          "op",
-          "port",
-          "controls",
-          "action"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "keyboard",
-      "description": "Send physical C64 keyboard matrix events through machine:input (a C64U firmware version that provides it, or U64 3.15+).",
-      "required": [
-        "inputs",
-        "transition"
-      ],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Send physical C64 keyboard matrix events through machine:input (a C64U firmware version that provides it, or U64 3.15+).",
-        "properties": {
-          "op": {
-            "const": "keyboard"
-          },
-          "inputs": {
-            "type": "array",
-            "description": "One or more keys to transition together (for example left_shift + a).",
-            "items": {
-              "type": "string",
-              "description": "Physical keyboard input.",
-              "enum": [
-                "inst_del",
-                "return",
-                "cursor_left_right",
-                "f7",
-                "f1",
-                "f3",
-                "f5",
-                "cursor_up_down",
-                "0",
-                "1",
-                "2",
-                "3",
-                "4",
-                "5",
-                "6",
-                "7",
-                "8",
-                "9",
-                "a",
-                "b",
-                "c",
-                "d",
-                "e",
-                "f",
-                "g",
-                "h",
-                "i",
-                "j",
-                "k",
-                "l",
-                "m",
-                "n",
-                "o",
-                "p",
-                "q",
-                "r",
-                "s",
-                "t",
-                "u",
-                "v",
-                "w",
-                "x",
-                "y",
-                "z",
-                "left_shift",
-                "right_shift",
-                "plus",
-                "minus",
-                "period",
-                "colon",
-                "at",
-                "comma",
-                "pound",
-                "star",
-                "semicolon",
-                "clr_home",
-                "equals",
-                "arrow_up",
-                "slash",
-                "arrow_left",
-                "ctrl",
-                "space",
-                "commodore",
-                "run_stop",
-                "restore"
-              ]
-            },
-            "minItems": 1,
-            "maxItems": 8
-          },
-          "transition": {
-            "type": "string",
-            "description": "press holds, release frees, tap presses and releases.",
-            "enum": [
-              "press",
-              "release",
-              "tap"
-            ]
-          }
-        },
-        "required": [
-          "op",
-          "inputs",
-          "transition"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "release_all",
-      "description": "Release every key and joystick control injected through machine:input (a C64U firmware version that provides it, or U64 3.15+).",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Release every key and joystick control injected through machine:input (a C64U firmware version that provides it, or U64 3.15+).",
-        "properties": {
-          "op": {
-            "const": "release_all"
-          }
-        },
-        "required": [
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "state",
-      "description": "Read the keys and joystick controls held through machine:input (a C64U firmware version that provides it, or U64 3.15+).",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Read the keys and joystick controls held through machine:input (a C64U firmware version that provides it, or U64 3.15+).",
-        "properties": {
-          "op": {
-            "const": "state"
-          }
-        },
-        "required": [
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    }
-  ]
+  "description": "Input operations: write_text, key, keyboard, joystick, release_all, state.\n\nOperations:\n- write_text [write]: Send a text string to the keyboard buffer, with PETSCII token expansion. Required inputs: text. Optional inputs: delayMs.\n- key [write]: Press a single key one or more times, optionally with a delay between presses. Required inputs: key. Optional inputs: durationMs, count.\n- joystick [c64u, vice] [write]: Simulate joystick input. On C64U/U64 this uses machine:input. On VICE it attaches VICE's I/O simulation joyport device while pressed; that device also pulls CIA lines 5-7 low, so port 1 produces phantom keys (e.g. SHIFT+C=) and port 2 reads $1E for up instead of $7E. Prefer port 2 on VICE and test bits 0-4. Required inputs: port, controls, action. Optional inputs: durationMs.\n- keyboard [c64u] [write]: Send physical C64 keyboard matrix events through machine:input (a C64U firmware version that provides it, or U64 3.15+). Required inputs: inputs, transition.\n- release_all [c64u] [write]: Release every key and joystick control injected through machine:input (a C64U firmware version that provides it, or U64 3.15+). Required inputs: none.\n- state [c64u]: Read the keys and joystick controls held through machine:input (a C64U firmware version that provides it, or U64 3.15+). Required inputs: none.",
+  "additionalProperties": false
 }