c64bridge 0.7.4 → 0.8.0

package/mcp/schemas/c64_drive.schema.json

@@ -0,0 +1,120 @@
+{
+  "type": "object",
+  "description": "Drive operations available via the c64_drive tool.",
+  "oneOf": [
+    {
+      "type": "object",
+      "description": "Issue an IEC reset for the selected 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": "reset"
+        }
+      },
+      "required": [
+        "drive",
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Power on a specific 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": "power_on"
+        }
+      },
+      "required": [
+        "drive",
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Power off a specific 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": "power_off"
+        }
+      },
+      "required": [
+        "drive",
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Temporarily load a custom ROM into 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
+        },
+        "path": {
+          "type": "string",
+          "description": "Absolute or Ultimate filesystem path to the disk image to mount or manage.",
+          "minLength": 1
+        },
+        "op": {
+          "const": "load_rom"
+        }
+      },
+      "required": [
+        "drive",
+        "path",
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Set the emulation mode for a drive slot (1541/1571/1581).",
+      "properties": {
+        "drive": {
+          "type": "string",
+          "description": "Drive identifier such as drive8, drive9, or unit name defined in the Ultimate UI.",
+          "minLength": 1
+        },
+        "mode": {
+          "type": "string",
+          "description": "Drive hardware profile to emulate.",
+          "enum": [
+            "1541",
+            "1571",
+            "1581"
+          ]
+        },
+        "op": {
+          "const": "set_mode"
+        }
+      },
+      "required": [
+        "drive",
+        "mode",
+        "op"
+      ],
+      "additionalProperties": false
+    }
+  ],
+  "discriminator": {
+    "propertyName": "op"
+  }
+}

package/mcp/schemas/c64_extract.schema.json

@@ -0,0 +1,302 @@
+{
+  "type": "object",
+  "description": "Extraction operations available via the c64_extract tool.",
+  "oneOf": [
+    {
+      "type": "object",
+      "description": "Scan RAM for sprites and optionally export .spr files.",
+      "properties": {
+        "address": {
+          "type": "string",
+          "description": "Start address ($HHHH or decimal)",
+          "minLength": 1
+        },
+        "length": {
+          "type": "integer",
+          "description": "Number of bytes to scan",
+          "minimum": 63,
+          "maximum": 65536
+        },
+        "stride": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Stride between sprite candidates in bytes",
+          "minimum": 1,
+          "default": 64
+        },
+        "maxSprites": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Maximum sprites to return",
+          "minimum": 1,
+          "maximum": 256,
+          "default": 16
+        },
+        "minNonZeroRows": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Minimum non-empty rows required",
+          "minimum": 1,
+          "maximum": 21,
+          "default": 4
+        },
+        "minSetBits": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Minimum number of set bits required",
+          "minimum": 1,
+          "maximum": 504,
+          "default": 12
+        },
+        "includeBase64": {
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "description": "Include base64 data in response",
+          "default": true
+        },
+        "outputDir": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Directory to write .spr files",
+          "minLength": 1
+        },
+        "pauseDuringRead": {
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "description": "Pause the machine during memory read",
+          "default": true
+        },
+        "op": {
+          "const": "sprites"
+        }
+      },
+      "required": [
+        "address",
+        "length",
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Locate and extract 2KB character sets from RAM.",
+      "properties": {
+        "address": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Start address to scan ($HHHH or decimal). If not provided, scans common locations.",
+          "minLength": 1
+        },
+        "scanRange": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Range to scan if address not provided: 'common' or 'full'",
+          "enum": [
+            "common",
+            "full"
+          ],
+          "default": "common"
+        },
+        "outputPath": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "File path to write charset binary",
+          "minLength": 1
+        },
+        "pauseDuringRead": {
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "description": "Pause the machine during memory read",
+          "default": true
+        },
+        "minNonEmptyChars": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Minimum non-empty characters required",
+          "minimum": 1,
+          "maximum": 256,
+          "default": 32
+        },
+        "minEntropy": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "description": "Minimum average entropy threshold",
+          "minimum": 0,
+          "maximum": 1,
+          "default": 0.3
+        },
+        "op": {
+          "const": "charset"
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "op"
+      ]
+    },
+    {
+      "type": "object",
+      "description": "Dump a RAM range to hex or binary files with manifest metadata.",
+      "properties": {
+        "address": {
+          "type": "string",
+          "description": "Start address ($HHHH or decimal)",
+          "minLength": 1
+        },
+        "length": {
+          "type": "integer",
+          "description": "Number of bytes to dump",
+          "minimum": 1,
+          "maximum": 65536
+        },
+        "outputPath": {
+          "type": "string",
+          "description": "Destination file path",
+          "minLength": 1
+        },
+        "format": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Output format: hex|binary",
+          "enum": [
+            "hex",
+            "binary"
+          ],
+          "default": "hex"
+        },
+        "chunkSize": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Chunk size for reads",
+          "minimum": 1,
+          "maximum": 4096,
+          "default": 512
+        },
+        "pauseDuringRead": {
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "description": "Pause/resume around dump",
+          "default": true
+        },
+        "retries": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Retries per chunk on failure",
+          "minimum": 0,
+          "default": 1
+        },
+        "op": {
+          "const": "memory_dump"
+        }
+      },
+      "required": [
+        "address",
+        "length",
+        "outputPath",
+        "op"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "description": "Walk the filesystem and aggregate counts/bytes by extension.",
+      "properties": {
+        "root": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Root path to scan",
+          "minLength": 1,
+          "default": "/"
+        },
+        "extensions": {
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "type": "string",
+            "description": "Limit to these extensions (without dot)",
+            "minLength": 1
+          }
+        },
+        "includeContainers": {
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "description": "Include container images (d64/d81/etc.) in extension stats",
+          "default": true
+        },
+        "maxSamplesPerExtension": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "description": "Number of sample paths to keep per extension",
+          "minimum": 1,
+          "maximum": 10,
+          "default": 3
+        },
+        "op": {
+          "const": "fs_stats"
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "op"
+      ]
+    },
+    {
+      "type": "object",
+      "description": "Run firmware readiness checks and report status metrics.",
+      "properties": {
+        "op": {
+          "const": "firmware_health"
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "op"
+      ]
+    }
+  ],
+  "discriminator": {
+    "propertyName": "op"
+  }
+}