c64bridge 1.0.7 → 1.1.0

package/mcp/schemas/c64_config.schema.json

@@ -23,8 +23,11 @@
       "description": "Selects the operation."
     },
     "category": {
-      "type": "string",
-      "description": "Configuration category reported by the Ultimate firmware (e.g. 'Audio').",
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "Configuration category reported by the Ultimate firmware (e.g. 'Audio'). Limits depend on op.",
       "minLength": 1
     },
     "item": {
@@ -32,7 +35,7 @@
         "string",
         "null"
       ],
-      "description": "Specific configuration item inside the selected category (e.g. 'Volume').",
+      "description": "Specific configuration item inside the selected category (e.g. 'Volume'). Limits depend on op.",
       "minLength": 1
     },
     "includeSecretValues": {
@@ -44,12 +47,27 @@
       "default": false
     },
     "value": {
-      "description": "Primitive configuration value (string, number, or boolean).",
       "type": [
         "string",
         "number",
         "boolean"
-      ]
+      ],
+      "description": "Primitive configuration value (string, number, or boolean). Limits depend on op."
+    },
+    "updates": {
+      "type": "object",
+      "description": "Categories mapped to item/value pairs (primitive values only), for example {\"Audio\": {\"Volume\": 80}}.",
+      "additionalProperties": {
+        "type": "object",
+        "description": "Item/value pairs of one category (primitive values only).",
+        "additionalProperties": {
+          "type": [
+            "string",
+            "number",
+            "boolean"
+          ]
+        }
+      }
     },
     "path": {
       "type": "string",
@@ -136,474 +154,6 @@
   "required": [
     "op"
   ],
-  "description": "Configuration operations available via the c64_config tool.\n\nOperations:\n- list: List configuration categories reported by the firmware. Required inputs: none.\n- get: Read a configuration category or specific item. Required inputs: category. Optional inputs: item, includeSecretValues.\n- set: Write a configuration value in the selected category. Required inputs: category, item, value.\n- batch_update: Apply multiple configuration updates in a single request. Required inputs: none.\n- load_flash: Load configuration from flash storage. Required inputs: none.\n- save_flash: Persist the current configuration to flash storage. Required inputs: none.\n- reset_defaults: Reset firmware configuration to factory defaults. Required inputs: none.\n- read_debugreg: Read the Ultimate debug register ($D7FF). Required inputs: none.\n- write_debugreg: Write a hex value to the Ultimate debug register ($D7FF). Required inputs: value.\n- info: Retrieve Ultimate hardware information and status. Required inputs: none.\n- version: Fetch firmware version details. Required inputs: none.\n- snapshot: Snapshot configuration to disk for later restore or diff. Required inputs: path.\n- restore: Restore configuration from a snapshot file. Required inputs: path. Optional inputs: applyToFlash.\n- diff: Compare the current configuration with a snapshot. Required inputs: path.\n- shuffle: Discover PRG/CRT files and run each with optional screen capture. Required inputs: none. Optional inputs: root, extensions, durationMs, captureScreen, maxPrograms, outputPath, resetDelayMs.",
-  "additionalProperties": false,
-  "x-c64bridge-operations": [
-    {
-      "op": "list",
-      "description": "List configuration categories reported by the firmware.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "List configuration categories reported by the firmware.",
-        "properties": {
-          "op": {
-            "const": "list"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "get",
-      "description": "Read a configuration category or specific item.",
-      "required": [
-        "category"
-      ],
-      "optional": [
-        "item",
-        "includeSecretValues"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Read a configuration category or specific item.",
-        "properties": {
-          "category": {
-            "type": "string",
-            "description": "Configuration category reported by the Ultimate firmware (e.g. 'Audio').",
-            "minLength": 1
-          },
-          "item": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "description": "Specific configuration item inside the selected category (e.g. 'Volume').",
-            "minLength": 1
-          },
-          "includeSecretValues": {
-            "type": [
-              "boolean",
-              "null"
-            ],
-            "description": "Return credential values (network password, FTP/Telnet passwords, Wi-Fi keys) in plain text. Default false: those values are replaced with ***.",
-            "default": false
-          },
-          "op": {
-            "const": "get"
-          }
-        },
-        "required": [
-          "category",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "set",
-      "description": "Write a configuration value in the selected category.",
-      "required": [
-        "category",
-        "item",
-        "value"
-      ],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Write a configuration value in the selected category.",
-        "properties": {
-          "category": {
-            "type": "string",
-            "description": "Configuration category reported by the Ultimate firmware (e.g. 'Audio').",
-            "minLength": 1
-          },
-          "item": {
-            "type": "string",
-            "description": "Configuration item name inside the category.",
-            "minLength": 1
-          },
-          "value": {
-            "description": "Primitive configuration value (string, number, or boolean).",
-            "type": [
-              "string",
-              "number",
-              "boolean"
-            ]
-          },
-          "op": {
-            "const": "set"
-          }
-        },
-        "required": [
-          "category",
-          "item",
-          "value",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "batch_update",
-      "description": "Apply multiple configuration updates in a single request.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "description": "Apply multiple configuration updates in a single request.",
-        "type": "object",
-        "additionalProperties": {
-          "type": "object",
-          "additionalProperties": {
-            "type": [
-              "string",
-              "number",
-              "boolean"
-            ]
-          }
-        },
-        "properties": {
-          "op": {
-            "const": "batch_update"
-          }
-        },
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "load_flash",
-      "description": "Load configuration from flash storage.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Load configuration from flash storage.",
-        "properties": {
-          "op": {
-            "const": "load_flash"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "save_flash",
-      "description": "Persist the current configuration to flash storage.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Persist the current configuration to flash storage.",
-        "properties": {
-          "op": {
-            "const": "save_flash"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "reset_defaults",
-      "description": "Reset firmware configuration to factory defaults.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Reset firmware configuration to factory defaults.",
-        "properties": {
-          "op": {
-            "const": "reset_defaults"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "read_debugreg",
-      "description": "Read the Ultimate debug register ($D7FF).",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Read the Ultimate debug register ($D7FF).",
-        "properties": {
-          "op": {
-            "const": "read_debugreg"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "write_debugreg",
-      "description": "Write a hex value to the Ultimate debug register ($D7FF).",
-      "required": [
-        "value"
-      ],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Write a hex value to the Ultimate debug register ($D7FF).",
-        "properties": {
-          "value": {
-            "type": "string",
-            "description": "Hex value (00-FF) to write to the debug register.",
-            "minLength": 1,
-            "maxLength": 2,
-            "pattern": "^[0-9A-Fa-f]{1,2}$"
-          },
-          "op": {
-            "const": "write_debugreg"
-          }
-        },
-        "required": [
-          "value",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "info",
-      "description": "Retrieve Ultimate hardware information and status.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Retrieve Ultimate hardware information and status.",
-        "properties": {
-          "op": {
-            "const": "info"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "version",
-      "description": "Fetch firmware version details.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Fetch firmware version details.",
-        "properties": {
-          "op": {
-            "const": "version"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "snapshot",
-      "description": "Snapshot configuration to disk for later restore or diff.",
-      "required": [
-        "path"
-      ],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Snapshot configuration to disk for later restore or diff.",
-        "properties": {
-          "path": {
-            "type": "string",
-            "description": "Absolute or workspace-relative path where the snapshot file will be written.",
-            "minLength": 1
-          },
-          "op": {
-            "const": "snapshot"
-          }
-        },
-        "required": [
-          "path",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "restore",
-      "description": "Restore configuration from a snapshot file.",
-      "required": [
-        "path"
-      ],
-      "optional": [
-        "applyToFlash"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Restore configuration from a snapshot file.",
-        "properties": {
-          "path": {
-            "type": "string",
-            "description": "Snapshot file to read (must contain categories payload).",
-            "minLength": 1
-          },
-          "applyToFlash": {
-            "type": [
-              "boolean",
-              "null"
-            ],
-            "description": "When true, save the restored configuration to flash immediately (C64U/U64 and U2 only).",
-            "default": false
-          },
-          "op": {
-            "const": "restore"
-          }
-        },
-        "required": [
-          "path",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "diff",
-      "description": "Compare the current configuration with a snapshot.",
-      "required": [
-        "path"
-      ],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Compare the current configuration with a snapshot.",
-        "properties": {
-          "path": {
-            "type": "string",
-            "description": "Snapshot file to compare with.",
-            "minLength": 1
-          },
-          "op": {
-            "const": "diff"
-          }
-        },
-        "required": [
-          "path",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "shuffle",
-      "description": "Discover PRG/CRT files and run each with optional screen capture.",
-      "required": [],
-      "optional": [
-        "root",
-        "extensions",
-        "durationMs",
-        "captureScreen",
-        "maxPrograms",
-        "outputPath",
-        "resetDelayMs"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Discover PRG/CRT files and run each with optional screen capture.",
-        "properties": {
-          "root": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "description": "Root path to search for programs",
-            "minLength": 1,
-            "default": "/"
-          },
-          "extensions": {
-            "type": [
-              "array",
-              "null"
-            ],
-            "items": {
-              "type": "string",
-              "description": "File extensions to include (without dot)",
-              "minLength": 1
-            },
-            "default": [
-              "prg",
-              "crt"
-            ]
-          },
-          "durationMs": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Duration to run each program in milliseconds",
-            "minimum": 1,
-            "default": 5000
-          },
-          "captureScreen": {
-            "type": [
-              "boolean",
-              "null"
-            ],
-            "description": "Capture screen after each run",
-            "default": true
-          },
-          "maxPrograms": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Maximum number of programs to run",
-            "minimum": 1,
-            "default": 10
-          },
-          "outputPath": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "description": "Output directory for run logs and captures",
-            "minLength": 1
-          },
-          "resetDelayMs": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Delay after reset operations to allow the platform to settle.",
-            "minimum": 0,
-            "maximum": 1000,
-            "default": 100
-          },
-          "op": {
-            "const": "shuffle"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    }
-  ]
+  "description": "Configuration operations available via the c64_config tool.\n\nOperations:\n- list: List configuration categories reported by the firmware. Required inputs: none.\n- get: Read a configuration category or specific item. Required inputs: category. Optional inputs: item, includeSecretValues.\n- set [write]: Write a configuration value in the selected category. Required inputs: category, item, value.\n- batch_update [write]: Apply multiple configuration updates in a single request. Pass `updates` as {category: {item: value}}; categories as top-level keys are still accepted at runtime. Required inputs: none. Optional inputs: updates.\n- load_flash [c64u, u2] [destructive]: Load configuration from flash storage. Required inputs: none. Optional inputs: category.\n- save_flash [c64u, u2] [destructive]: Persist the current configuration to flash storage. Required inputs: none. Optional inputs: category.\n- reset_defaults [c64u, u2] [destructive]: Reset firmware configuration to factory defaults. Required inputs: none. Optional inputs: category.\n- read_debugreg [c64u]: Read the Ultimate debug register ($D7FF). Required inputs: none.\n- write_debugreg [c64u] [destructive]: Write a hex value to the Ultimate debug register ($D7FF). Required inputs: value.\n- info: Retrieve Ultimate hardware information and status. Required inputs: none.\n- version: Fetch firmware version details. Required inputs: none.\n- snapshot [write]: Snapshot configuration to disk for later restore or diff. Required inputs: path.\n- restore [write]: Restore configuration from a snapshot file. Required inputs: path. Optional inputs: applyToFlash.\n- diff: Compare the current configuration with a snapshot. Required inputs: path.\n- shuffle [c64u, u2] [write]: Discover PRG/CRT files and run each with optional screen capture. Required inputs: none. Optional inputs: root, extensions, durationMs, captureScreen, maxPrograms, outputPath, resetDelayMs.",
+  "additionalProperties": false
 }