c64bridge 1.0.3 → 1.0.4

package/mcp/schemas/c64_program.schema.json

@@ -185,8 +185,7 @@
         "boolean",
         "null"
       ],
-      "description": "Capture debugreg state",
-      "default": true
+      "description": "Capture Ultimate debug registers (C64U/U64 only). Defaults to true on C64U/U64 and false on U2/VICE."
     },
     "platforms": {
       "type": [
@@ -199,13 +198,10 @@
         "minLength": 1,
         "enum": [
           "vice",
-          "c64u"
+          "c64u",
+          "u2"
         ]
-      },
-      "default": [
-        "vice",
-        "c64u"
-      ]
+      }
     },
     "messageTemplate": {
       "type": [
@@ -221,7 +217,7 @@
         "boolean",
         "null"
       ],
-      "description": "Capture a framebuffer screenshot and save it as a PNG per backend.",
+      "description": "Capture a framebuffer screenshot on C64U/U64 or VICE. U2 skips screenshots by default; explicitly requesting one on U2 fails before execution.",
       "default": true
     },
     "restoreActiveBackend": {
@@ -623,8 +619,7 @@
               "boolean",
               "null"
             ],
-            "description": "Capture debugreg state",
-            "default": true
+            "description": "Capture Ultimate debug registers (C64U/U64 only). Defaults to true on C64U/U64 and false on U2/VICE."
           },
           "op": {
             "const": "bundle_run"
@@ -667,13 +662,10 @@
               "minLength": 1,
               "enum": [
                 "vice",
-                "c64u"
+                "c64u",
+                "u2"
               ]
-            },
-            "default": [
-              "vice",
-              "c64u"
-            ]
+            }
           },
           "messageTemplate": {
             "type": [
@@ -697,7 +689,7 @@
               "boolean",
               "null"
             ],
-            "description": "Capture a framebuffer screenshot and save it as a PNG per backend.",
+            "description": "Capture a framebuffer screenshot on C64U/U64 or VICE. U2 skips screenshots by default; explicitly requesting one on U2 fails before execution.",
             "default": true
           },
           "outputPath": {

package/mcp/schemas/c64_sound.schema.json

@@ -223,7 +223,7 @@
         "string",
         "null"
       ],
-      "description": "Playback target format.",
+      "description": "Playback target format. PRG works on all backends; SID playback requires C64U/U64 or U2 (SID export with dryRun works everywhere).",
       "enum": [
         "prg",
         "sid"
@@ -249,7 +249,8 @@
         "minLength": 1,
         "enum": [
           "vice",
-          "c64u"
+          "c64u",
+          "u2"
         ]
       }
     },
@@ -815,7 +816,7 @@
               "string",
               "null"
             ],
-            "description": "Playback target format.",
+            "description": "Playback target format. PRG works on all backends; SID playback requires C64U/U64 or U2 (SID export with dryRun works everywhere).",
             "enum": [
               "prg",
               "sid"
@@ -876,7 +877,8 @@
               "minLength": 1,
               "enum": [
                 "vice",
-                "c64u"
+                "c64u",
+                "u2"
               ]
             }
           },
@@ -885,7 +887,7 @@
               "boolean",
               "null"
             ],
-            "description": "Capture and analyze audio on supported backends after playback starts.",
+            "description": "Capture and analyze audio after playback starts: native streaming on C64U/U64, host audio input on U2/VICE (PortAudio required).",
             "default": true
           },
           "analysisDurationSeconds": {
@@ -969,7 +971,7 @@
               "string",
               "null"
             ],
-            "description": "Playback artifact format.",
+            "description": "Playback artifact format. PRG works on all backends; SID attachment playback requires C64U/U64 or U2.",
             "enum": [
               "prg",
               "sid"

package/mcp/schemas/c64_system.schema.json

@@ -91,7 +91,7 @@
   "required": [
     "op"
   ],
-  "description": "System operations available via the c64_system tool.\n\nOperations:\n- pause: Pause the machine until resumed. Required inputs: none.\n- resume: Resume CPU execution after a pause. Required inputs: none.\n- reset: Issue a soft reset without cutting power. Required inputs: none.\n- reboot: Trigger a firmware reboot to recover from faults. Required inputs: none.\n- poweroff: Request a controlled shutdown via the Ultimate firmware. Required inputs: none.\n- power_cycle: Return the active backend to a fresh state. C64U/U64 Tool Menu verification requires machine:menu_screen (a C64U firmware version that provides it, or U64 3.15+); U2-family reboots through REST. Required inputs: none.\n- menu: Toggle the Ultimate menu button for navigation. Required inputs: none.\n- read_menu_screen: Read the active Ultimate menu's raw character and colour matrix through machine:menu_screen (a C64U firmware version that provides it, or U64/U2 3.15+). Required inputs: none.\n- start_task: Start a named background task that runs on an interval. Required inputs: name, operation. Optional inputs: arguments, intervalMs, maxIterations.\n- stop_task: Stop a specific background task and clear its timer. Required inputs: name.\n- stop_all_tasks: Stop every running background task and persist state. Required inputs: none.\n- list_tasks: List known background tasks with status metadata. Required inputs: none.\n- performance_report: Summarize diagnostics spans and tool latencies from the current or latest MCP session. Required inputs: none. Optional inputs: scope, includeTimeline, maxEntries.",
+  "description": "System operations available via the c64_system tool.\n\nOperations:\n- pause: Pause the machine until resumed. Required inputs: none.\n- resume: Resume CPU execution after a pause. Required inputs: none.\n- reset: Issue a soft reset without cutting power. Required inputs: none.\n- reboot: Trigger a firmware reboot to recover from faults. Required inputs: none.\n- poweroff: Shut down C64U/U64 or quit VICE. U2-family hardware cannot power off. Required inputs: none.\n- power_cycle: Return the active backend to a fresh state. C64U/U64 Tool Menu verification requires machine:menu_screen (a C64U firmware version that provides it, or U64 3.15+); U2-family reboots through REST. Required inputs: none.\n- menu: Toggle the Ultimate menu button for navigation. Required inputs: none.\n- read_menu_screen: Read the active Ultimate menu's raw character and colour matrix through machine:menu_screen (a C64U firmware version that provides it, or U64/U2 3.15+). Required inputs: none.\n- start_task: Start a named background task that runs on an interval. Required inputs: name, operation. Optional inputs: arguments, intervalMs, maxIterations.\n- stop_task: Stop a specific background task and clear its timer. Required inputs: name.\n- stop_all_tasks: Stop every running background task and persist state. Required inputs: none.\n- list_tasks: List known background tasks with status metadata. Required inputs: none.\n- performance_report: Summarize diagnostics spans and tool latencies from the current or latest MCP session. Required inputs: none. Optional inputs: scope, includeTimeline, maxEntries.",
   "additionalProperties": false,
   "x-c64bridge-operations": [
     {
@@ -172,12 +172,12 @@
     },
     {
       "op": "poweroff",
-      "description": "Request a controlled shutdown via the Ultimate firmware.",
+      "description": "Shut down C64U/U64 or quit VICE. U2-family hardware cannot power off.",
       "required": [],
       "optional": [],
       "inputSchema": {
         "type": "object",
-        "description": "Request a controlled shutdown via the Ultimate firmware.",
+        "description": "Shut down C64U/U64 or quit VICE. U2-family hardware cannot power off.",
         "properties": {
           "op": {
             "const": "poweroff"

package/mcp/server.json

@@ -1,6 +1,6 @@
 {
   "name": "c64bridge",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Stdio-based Model Context Protocol (MCP) server that bridges Commodore 64 Ultimate hardware with AI agents.",
   "transports": [
     "stdio"

package/mcp/tools.json

@@ -191,8 +191,7 @@
               "boolean",
               "null"
             ],
-            "description": "Capture debugreg state",
-            "default": true
+            "description": "Capture Ultimate debug registers (C64U/U64 only). Defaults to true on C64U/U64 and false on U2/VICE."
           },
           "platforms": {
             "type": [
@@ -205,13 +204,10 @@
               "minLength": 1,
               "enum": [
                 "vice",
-                "c64u"
+                "c64u",
+                "u2"
               ]
-            },
-            "default": [
-              "vice",
-              "c64u"
-            ]
+            }
           },
           "messageTemplate": {
             "type": [
@@ -227,7 +223,7 @@
               "boolean",
               "null"
             ],
-            "description": "Capture a framebuffer screenshot and save it as a PNG per backend.",
+            "description": "Capture a framebuffer screenshot on C64U/U64 or VICE. U2 skips screenshots by default; explicitly requesting one on U2 fails before execution.",
             "default": true
           },
           "restoreActiveBackend": {
@@ -629,8 +625,7 @@
                     "boolean",
                     "null"
                   ],
-                  "description": "Capture debugreg state",
-                  "default": true
+                  "description": "Capture Ultimate debug registers (C64U/U64 only). Defaults to true on C64U/U64 and false on U2/VICE."
                 },
                 "op": {
                   "const": "bundle_run"
@@ -673,13 +668,10 @@
                     "minLength": 1,
                     "enum": [
                       "vice",
-                      "c64u"
+                      "c64u",
+                      "u2"
                     ]
-                  },
-                  "default": [
-                    "vice",
-                    "c64u"
-                  ]
+                  }
                 },
                 "messageTemplate": {
                   "type": [
@@ -703,7 +695,7 @@
                     "boolean",
                     "null"
                   ],
-                  "description": "Capture a framebuffer screenshot and save it as a PNG per backend.",
+                  "description": "Capture a framebuffer screenshot on C64U/U64 or VICE. U2 skips screenshots by default; explicitly requesting one on U2 fails before execution.",
                   "default": true
                 },
                 "outputPath": {
@@ -815,10 +807,6 @@
           "run_crt": [
             "c64u",
             "u2"
-          ],
-          "bundle_run": [
-            "c64u",
-            "u2"
           ]
         }
       }
@@ -1829,7 +1817,7 @@
               "string",
               "null"
             ],
-            "description": "Playback target format.",
+            "description": "Playback target format. PRG works on all backends; SID playback requires C64U/U64 or U2 (SID export with dryRun works everywhere).",
             "enum": [
               "prg",
               "sid"
@@ -1855,7 +1843,8 @@
               "minLength": 1,
               "enum": [
                 "vice",
-                "c64u"
+                "c64u",
+                "u2"
               ]
             }
           },
@@ -2421,7 +2410,7 @@
                     "string",
                     "null"
                   ],
-                  "description": "Playback target format.",
+                  "description": "Playback target format. PRG works on all backends; SID playback requires C64U/U64 or U2 (SID export with dryRun works everywhere).",
                   "enum": [
                     "prg",
                     "sid"
@@ -2482,7 +2471,8 @@
                     "minLength": 1,
                     "enum": [
                       "vice",
-                      "c64u"
+                      "c64u",
+                      "u2"
                     ]
                   }
                 },
@@ -2491,7 +2481,7 @@
                     "boolean",
                     "null"
                   ],
-                  "description": "Capture and analyze audio on supported backends after playback starts.",
+                  "description": "Capture and analyze audio after playback starts: native streaming on C64U/U64, host audio input on U2/VICE (PortAudio required).",
                   "default": true
                 },
                 "analysisDurationSeconds": {
@@ -2575,7 +2565,7 @@
                     "string",
                     "null"
                   ],
-                  "description": "Playback artifact format.",
+                  "description": "Playback artifact format. PRG works on all backends; SID attachment playback requires C64U/U64 or U2.",
                   "enum": [
                     "prg",
                     "sid"
@@ -2838,13 +2828,18 @@
           ],
           "pipeline": [
             "c64u",
-            "u2"
+            "u2",
+            "vice"
           ],
           "analyze": [
-            "c64u"
+            "c64u",
+            "u2",
+            "vice"
           ],
           "record_analyze": [
-            "c64u"
+            "c64u",
+            "u2",
+            "vice"
           ]
         }
       }
@@ -2946,7 +2941,7 @@
         "required": [
           "op"
         ],
-        "description": "System operations available via the c64_system tool.\n\nOperations:\n- pause: Pause the machine until resumed. Required inputs: none.\n- resume: Resume CPU execution after a pause. Required inputs: none.\n- reset: Issue a soft reset without cutting power. Required inputs: none.\n- reboot: Trigger a firmware reboot to recover from faults. Required inputs: none.\n- poweroff: Request a controlled shutdown via the Ultimate firmware. Required inputs: none.\n- power_cycle: Return the active backend to a fresh state. C64U/U64 Tool Menu verification requires machine:menu_screen (a C64U firmware version that provides it, or U64 3.15+); U2-family reboots through REST. Required inputs: none.\n- menu: Toggle the Ultimate menu button for navigation. Required inputs: none.\n- read_menu_screen: Read the active Ultimate menu's raw character and colour matrix through machine:menu_screen (a C64U firmware version that provides it, or U64/U2 3.15+). Required inputs: none.\n- start_task: Start a named background task that runs on an interval. Required inputs: name, operation. Optional inputs: arguments, intervalMs, maxIterations.\n- stop_task: Stop a specific background task and clear its timer. Required inputs: name.\n- stop_all_tasks: Stop every running background task and persist state. Required inputs: none.\n- list_tasks: List known background tasks with status metadata. Required inputs: none.\n- performance_report: Summarize diagnostics spans and tool latencies from the current or latest MCP session. Required inputs: none. Optional inputs: scope, includeTimeline, maxEntries.",
+        "description": "System operations available via the c64_system tool.\n\nOperations:\n- pause: Pause the machine until resumed. Required inputs: none.\n- resume: Resume CPU execution after a pause. Required inputs: none.\n- reset: Issue a soft reset without cutting power. Required inputs: none.\n- reboot: Trigger a firmware reboot to recover from faults. Required inputs: none.\n- poweroff: Shut down C64U/U64 or quit VICE. U2-family hardware cannot power off. Required inputs: none.\n- power_cycle: Return the active backend to a fresh state. C64U/U64 Tool Menu verification requires machine:menu_screen (a C64U firmware version that provides it, or U64 3.15+); U2-family reboots through REST. Required inputs: none.\n- menu: Toggle the Ultimate menu button for navigation. Required inputs: none.\n- read_menu_screen: Read the active Ultimate menu's raw character and colour matrix through machine:menu_screen (a C64U firmware version that provides it, or U64/U2 3.15+). Required inputs: none.\n- start_task: Start a named background task that runs on an interval. Required inputs: name, operation. Optional inputs: arguments, intervalMs, maxIterations.\n- stop_task: Stop a specific background task and clear its timer. Required inputs: name.\n- stop_all_tasks: Stop every running background task and persist state. Required inputs: none.\n- list_tasks: List known background tasks with status metadata. Required inputs: none.\n- performance_report: Summarize diagnostics spans and tool latencies from the current or latest MCP session. Required inputs: none. Optional inputs: scope, includeTimeline, maxEntries.",
         "additionalProperties": false,
         "x-c64bridge-operations": [
           {
@@ -3027,12 +3022,12 @@
           },
           {
             "op": "poweroff",
-            "description": "Request a controlled shutdown via the Ultimate firmware.",
+            "description": "Shut down C64U/U64 or quit VICE. U2-family hardware cannot power off.",
             "required": [],
             "optional": [],
             "inputSchema": {
               "type": "object",
-              "description": "Request a controlled shutdown via the Ultimate firmware.",
+              "description": "Shut down C64U/U64 or quit VICE. U2-family hardware cannot power off.",
               "properties": {
                 "op": {
                   "const": "poweroff"
@@ -3338,6 +3333,10 @@
           "vice"
         ],
         "operationPlatforms": {
+          "poweroff": [
+            "c64u",
+            "vice"
+          ],
           "pause": [
             "c64u",
             "u2"
@@ -4183,7 +4182,13 @@
           "c64u",
           "u2",
           "vice"
-        ]
+        ],
+        "operationPlatforms": {
+          "capture_frame": [
+            "c64u",
+            "vice"
+          ]
+        }
       }
     },
     {
@@ -5732,7 +5737,7 @@
               "boolean",
               "null"
             ],
-            "description": "When true, save the restored configuration to flash immediately.",
+            "description": "When true, save the restored configuration to flash immediately (C64U/U64 and U2 only).",
             "default": false
           },
           "root": {
@@ -6131,7 +6136,7 @@
                     "boolean",
                     "null"
                   ],
-                  "description": "When true, save the restored configuration to flash immediately.",
+                  "description": "When true, save the restored configuration to flash immediately (C64U/U64 and U2 only).",
                   "default": false
                 },
                 "op": {
@@ -6954,8 +6959,16 @@
           "Summarise output file paths or sample counts so users can inspect artifacts quickly."
         ],
         "platforms": [
-          "c64u"
-        ]
+          "c64u",
+          "u2",
+          "vice"
+        ],
+        "operationPlatforms": {
+          "fs_stats": [
+            "c64u",
+            "u2"
+          ]
+        }
       }
     },
     {

package/mcp.json

@@ -1,6 +1,6 @@
 {
   "name": "c64bridge",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Stdio-based Model Context Protocol (MCP) server that bridges Commodore 64 Ultimate hardware with AI agents.",
   "entry": "dist/index.js",
   "type": "stdio",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "c64bridge",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "mcpName": "io.github.chrisgleissner/c64bridge",
   "description": "C64 Bridge MCP server for Commodore 64 Ultimate hardware and VICE emulator control",
   "repository": {

package/server.json

@@ -8,12 +8,12 @@
     "source": "github"
   },
   "websiteUrl": "https://github.com/chrisgleissner/c64bridge",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "c64bridge",
-      "version": "1.0.3",
+      "version": "1.0.4",
       "transport": {
         "type": "stdio"
       },