c64bridge 1.0.7 → 1.1.0

package/mcp/schemas/c64_extract.schema.json

@@ -13,14 +13,17 @@
       "description": "Selects the operation."
     },
     "address": {
-      "type": "string",
-      "description": "Start address ($HHHH or decimal)",
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "Start address ($HHHH or decimal) Limits depend on op.",
       "minLength": 1
     },
     "length": {
       "type": "integer",
-      "description": "Number of bytes to scan",
-      "minimum": 63,
+      "description": "Number of bytes to scan Limits depend on op.",
+      "minimum": 1,
       "maximum": 65536
     },
     "stride": {
@@ -103,7 +106,7 @@
         "string",
         "null"
       ],
-      "description": "File path to write charset binary",
+      "description": "File path to write charset binary Limits depend on op.",
       "minLength": 1
     },
     "minNonEmptyChars": {
@@ -199,363 +202,6 @@
   "required": [
     "op"
   ],
-  "description": "Extraction operations available via the c64_extract tool.\n\nOperations:\n- sprites: Scan RAM for sprites and optionally export .spr files. Required inputs: address, length. Optional inputs: stride, maxSprites, minNonZeroRows, minSetBits, includeBase64, outputDir, pauseDuringRead.\n- charset: Locate and extract 2KB character sets from RAM. Required inputs: none. Optional inputs: address, scanRange, outputPath, pauseDuringRead, minNonEmptyChars, minEntropy.\n- memory_dump: Dump a RAM range to hex or binary files with manifest metadata. Required inputs: address, length, outputPath. Optional inputs: format, chunkSize, pauseDuringRead, retries.\n- fs_stats: Walk the filesystem and aggregate counts/bytes by extension. Required inputs: none. Optional inputs: root, extensions, includeContainers, maxSamplesPerExtension.\n- firmware_health: Run firmware readiness checks and report status metrics. Required inputs: none.",
-  "additionalProperties": false,
-  "x-c64bridge-operations": [
-    {
-      "op": "sprites",
-      "description": "Scan RAM for sprites and optionally export .spr files.",
-      "required": [
-        "address",
-        "length"
-      ],
-      "optional": [
-        "stride",
-        "maxSprites",
-        "minNonZeroRows",
-        "minSetBits",
-        "includeBase64",
-        "outputDir",
-        "pauseDuringRead"
-      ],
-      "inputSchema": {
-        "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
-      }
-    },
-    {
-      "op": "charset",
-      "description": "Locate and extract 2KB character sets from RAM.",
-      "required": [],
-      "optional": [
-        "address",
-        "scanRange",
-        "outputPath",
-        "pauseDuringRead",
-        "minNonEmptyChars",
-        "minEntropy"
-      ],
-      "inputSchema": {
-        "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"
-        ]
-      }
-    },
-    {
-      "op": "memory_dump",
-      "description": "Dump a RAM range to hex or binary files with manifest metadata.",
-      "required": [
-        "address",
-        "length",
-        "outputPath"
-      ],
-      "optional": [
-        "format",
-        "chunkSize",
-        "pauseDuringRead",
-        "retries"
-      ],
-      "inputSchema": {
-        "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
-      }
-    },
-    {
-      "op": "fs_stats",
-      "description": "Walk the filesystem and aggregate counts/bytes by extension.",
-      "required": [],
-      "optional": [
-        "root",
-        "extensions",
-        "includeContainers",
-        "maxSamplesPerExtension"
-      ],
-      "inputSchema": {
-        "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"
-        ]
-      }
-    },
-    {
-      "op": "firmware_health",
-      "description": "Run firmware readiness checks and report status metrics.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Run firmware readiness checks and report status metrics.",
-        "properties": {
-          "op": {
-            "const": "firmware_health"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    }
-  ]
+  "description": "Extraction operations available via the c64_extract tool.\n\nOperations:\n- sprites [write]: Scan RAM for sprites and optionally export .spr files. Required inputs: address, length. Optional inputs: stride, maxSprites, minNonZeroRows, minSetBits, includeBase64, outputDir, pauseDuringRead.\n- charset [write]: Locate and extract 2KB character sets from RAM. Required inputs: none. Optional inputs: address, scanRange, outputPath, pauseDuringRead, minNonEmptyChars, minEntropy.\n- memory_dump [write]: Dump a RAM range to hex or binary files with manifest metadata. Required inputs: address, length, outputPath. Optional inputs: format, chunkSize, pauseDuringRead, retries.\n- fs_stats [c64u, u2]: Walk the filesystem and aggregate counts/bytes by extension. Required inputs: none. Optional inputs: root, extensions, includeContainers, maxSamplesPerExtension.\n- firmware_health: Run firmware readiness checks and report status metrics. Required inputs: none.",
+  "additionalProperties": false
 }