c64bridge 0.7.4 → 0.8.0

package/mcp/schemas/c64_debug.schema.json

@@ -0,0 +1,380 @@
+{
+  "type": "object",
+  "description": "Available debugger operations.",
+  "oneOf": [
+    {
+      "type": "object",
+      "description": "List all active VICE checkpoints (breakpoints).",
+      "properties": {
+        "op": {
+          "const": "list_checkpoints"
+        }
+      },
+      "required": [
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Fetch a single checkpoint by id.",
+      "properties": {
+        "op": {
+          "const": "get_checkpoint"
+        },
+        "id": {
+          "type": "integer",
+          "description": "Debugger checkpoint identifier.",
+          "minimum": 1
+        }
+      },
+      "required": [
+        "op",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Create a new checkpoint (breakpoint) in VICE.",
+      "properties": {
+        "op": {
+          "const": "create_checkpoint"
+        },
+        "address": {
+          "type": "string",
+          "description": "Start address (e.g. $0801).",
+          "minLength": 1
+        },
+        "endAddress": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Optional end address for range.",
+          "minLength": 1
+        },
+        "stopOnHit": {
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "description": "Pause execution when hit (default true).",
+          "default": true
+        },
+        "enabled": {
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "description": "Whether the checkpoint is enabled (default true).",
+          "default": true
+        },
+        "temporary": {
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "description": "Automatically remove after first hit.",
+          "default": false
+        },
+        "operations": {
+          "type": [
+            "object",
+            "null"
+          ],
+          "description": "Checkpoint operation filters.",
+          "properties": {
+            "execute": {
+              "type": [
+                "boolean",
+                "null"
+              ],
+              "description": "Trigger on execute (default true).",
+              "default": true
+            },
+            "load": {
+              "type": [
+                "boolean",
+                "null"
+              ],
+              "description": "Trigger on memory load.",
+              "default": false
+            },
+            "store": {
+              "type": [
+                "boolean",
+                "null"
+              ],
+              "description": "Trigger on memory store.",
+              "default": false
+            }
+          },
+          "additionalProperties": false
+        },
+        "memspace": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "VICE memory space (0=CPU, 1=Drive8, etc.).",
+          "minimum": 0,
+          "maximum": 4
+        }
+      },
+      "required": [
+        "op",
+        "address"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Remove a checkpoint by id.",
+      "properties": {
+        "op": {
+          "const": "delete_checkpoint"
+        },
+        "id": {
+          "type": "integer",
+          "description": "Debugger checkpoint identifier.",
+          "minimum": 1
+        }
+      },
+      "required": [
+        "op",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Enable or disable a checkpoint by id.",
+      "properties": {
+        "op": {
+          "const": "toggle_checkpoint"
+        },
+        "id": {
+          "type": "integer",
+          "description": "Debugger checkpoint identifier.",
+          "minimum": 1
+        },
+        "enabled": {
+          "type": "boolean",
+          "description": "Set to true to enable, false to disable."
+        }
+      },
+      "required": [
+        "op",
+        "id",
+        "enabled"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Attach a conditional expression to a checkpoint.",
+      "properties": {
+        "op": {
+          "const": "set_condition"
+        },
+        "id": {
+          "type": "integer",
+          "description": "Debugger checkpoint identifier.",
+          "minimum": 1
+        },
+        "expression": {
+          "type": "string",
+          "description": "VICE monitor conditional expression.",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "op",
+        "id",
+        "expression"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "List available registers (metadata).",
+      "properties": {
+        "op": {
+          "const": "list_registers"
+        },
+        "memspace": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "VICE memory space (0=CPU, 1=Drive8, etc.).",
+          "minimum": 0,
+          "maximum": 4
+        }
+      },
+      "required": [
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Read register values, optionally filtered by name or id.",
+      "properties": {
+        "op": {
+          "const": "get_registers"
+        },
+        "memspace": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "VICE memory space (0=CPU, 1=Drive8, etc.).",
+          "minimum": 0,
+          "maximum": 4
+        },
+        "registers": {
+          "type": [
+            "array",
+            "null"
+          ],
+          "description": "Registers to include.",
+          "items": {
+            "type": "object",
+            "description": "Selects a register by id or name.",
+            "properties": {
+              "name": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "description": "Register name (case-insensitive)."
+              },
+              "id": {
+                "type": [
+                  "integer",
+                  "null"
+                ],
+                "description": "Register id.",
+                "minimum": 0
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Write register values.",
+      "properties": {
+        "op": {
+          "const": "set_registers"
+        },
+        "memspace": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "VICE memory space (0=CPU, 1=Drive8, etc.).",
+          "minimum": 0,
+          "maximum": 4
+        },
+        "writes": {
+          "type": "array",
+          "description": "Register writes to apply.",
+          "items": {
+            "type": "object",
+            "description": "Register write descriptor.",
+            "properties": {
+              "name": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "description": "Register name (case-insensitive)."
+              },
+              "id": {
+                "type": [
+                  "integer",
+                  "null"
+                ],
+                "description": "Register id.",
+                "minimum": 0
+              },
+              "value": {
+                "type": "integer",
+                "description": "Value to write.",
+                "minimum": 0
+              }
+            },
+            "required": [
+              "value"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        }
+      },
+      "required": [
+        "op",
+        "writes"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Single-step CPU execution.",
+      "properties": {
+        "op": {
+          "const": "step"
+        },
+        "count": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Number of instructions to step.",
+          "minimum": 1,
+          "default": 1
+        },
+        "mode": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Step mode (into or over).",
+          "enum": [
+            "into",
+            "over"
+          ]
+        }
+      },
+      "required": [
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Continue execution until the current routine returns.",
+      "properties": {
+        "op": {
+          "const": "step_return"
+        }
+      },
+      "required": [
+        "op"
+      ],
+      "additionalProperties": false
+    }
+  ],
+  "discriminator": {
+    "propertyName": "op"
+  }
+}

package/mcp/schemas/c64_disk.schema.json

@@ -0,0 +1,278 @@
+{
+  "type": "object",
+  "description": "Disk operations available via the c64_disk tool.",
+  "oneOf": [
+    {
+      "type": "object",
+      "description": "List Ultimate drive slots and their mounted images.",
+      "properties": {
+        "op": {
+          "const": "list_drives"
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "op"
+      ]
+    },
+    {
+      "type": "object",
+      "description": "Mount a disk image with optional verification and retries.",
+      "properties": {
+        "drive": {
+          "type": "string",
+          "description": "Drive identifier (for example drive8).",
+          "minLength": 1
+        },
+        "image": {
+          "type": "string",
+          "description": "Absolute or Ultimate filesystem path to the disk image.",
+          "minLength": 1
+        },
+        "type": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Override detected image type when firmware guesses incorrectly.",
+          "enum": [
+            "d64",
+            "g64",
+            "d71",
+            "g71",
+            "d81"
+          ]
+        },
+        "attachmentMode": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Attachment mode controlling how the firmware treats the mounted image.",
+          "enum": [
+            "readwrite",
+            "readonly",
+            "unlinked"
+          ]
+        },
+        "driveMode": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Drive emulation mode to switch to during verification.",
+          "enum": [
+            "1541",
+            "1571",
+            "1581"
+          ]
+        },
+        "verify": {
+          "type": "boolean",
+          "description": "When true, power on/reset/verify using the reliability workflow.",
+          "default": false
+        },
+        "powerOnIfNeeded": {
+          "type": "boolean",
+          "description": "Power on the drive automatically before mounting when verify=true.",
+          "default": true
+        },
+        "resetAfterMount": {
+          "type": "boolean",
+          "description": "Issue a drive reset after mounting when verify=true.",
+          "default": true
+        },
+        "maxRetries": {
+          "type": "integer",
+          "description": "Maximum number of mount retries when verify=true.",
+          "minimum": 0,
+          "maximum": 5,
+          "default": 2
+        },
+        "retryDelayMs": {
+          "type": "integer",
+          "description": "Delay between mount retry attempts when verify=true.",
+          "minimum": 0,
+          "maximum": 5000,
+          "default": 500
+        },
+        "op": {
+          "const": "mount"
+        }
+      },
+      "required": [
+        "drive",
+        "image",
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Remove the mounted image from an Ultimate drive slot.",
+      "properties": {
+        "drive": {
+          "type": "string",
+          "description": "Drive identifier such as drive8, drive9, or unit name defined in the Ultimate UI.",
+          "minLength": 1
+        },
+        "op": {
+          "const": "unmount"
+        }
+      },
+      "required": [
+        "drive",
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Inspect metadata for a file on the Ultimate filesystem.",
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "Absolute or Ultimate filesystem path to the disk image to mount or manage.",
+          "minLength": 1
+        },
+        "op": {
+          "const": "file_info"
+        }
+      },
+      "required": [
+        "path",
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Create a blank disk image of the specified format.",
+      "properties": {
+        "format": {
+          "type": "string",
+          "description": "Disk image format to create.",
+          "enum": [
+            "d64",
+            "d71",
+            "d81",
+            "dnp"
+          ]
+        },
+        "path": {
+          "type": "string",
+          "description": "Destination path on the Ultimate filesystem.",
+          "minLength": 1
+        },
+        "diskname": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Optional disk label (1-16 characters, converted to PETSCII).",
+          "minLength": 1,
+          "maxLength": 16
+        },
+        "tracks": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Track count (D64 supports 35 or 40; DNP requires explicit tracks).",
+          "minimum": 1,
+          "maximum": 255
+        },
+        "op": {
+          "const": "create_image"
+        }
+      },
+      "required": [
+        "format",
+        "path",
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Search for a PRG/CRT by name substring and run the first match.",
+      "properties": {
+        "root": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Root path to search",
+          "minLength": 1,
+          "default": "/"
+        },
+        "nameContains": {
+          "type": "string",
+          "description": "Substring to match",
+          "minLength": 1
+        },
+        "extensions": {
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "type": "string",
+            "description": "File extensions to include (without dot)",
+            "minLength": 1
+          }
+        },
+        "caseInsensitive": {
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "description": "Case-insensitive name match",
+          "default": true
+        },
+        "sort": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Sort order for matches",
+          "enum": [
+            "discovered",
+            "alphabetical"
+          ],
+          "default": "discovered"
+        },
+        "waitMs": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Delay after firmware run before returning",
+          "minimum": 0,
+          "default": 0
+        },
+        "captureCandidates": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Include up to this many candidates in result",
+          "minimum": 1,
+          "maximum": 100,
+          "default": 10
+        },
+        "op": {
+          "const": "find_and_run"
+        }
+      },
+      "required": [
+        "nameContains",
+        "op"
+      ],
+      "additionalProperties": false
+    }
+  ],
+  "discriminator": {
+    "propertyName": "op"
+  }
+}