c64bridge 1.0.6 → 1.1.0

package/mcp/schemas/c64_program.schema.json

@@ -34,9 +34,19 @@
       "minLength": 1
     },
     "verify": {
-      "type": "boolean",
-      "description": "Run post-execution polling to ensure the BASIC program executed without errors.",
-      "default": false
+      "type": [
+        "boolean",
+        "null"
+      ],
+      "description": "Run post-execution polling to ensure the BASIC program executed without errors. Limits depend on op."
+    },
+    "autoFix": {
+      "type": [
+        "boolean",
+        "null"
+      ],
+      "description": "When a BASIC error is detected on screen, append a missing closing quote or parentheses to the failing line and run the program again (default true). The rewritten lines are reported with before and after text. Set false for programs with side effects, which must not run twice.",
+      "default": true
     },
     "programs": {
       "type": "array",
@@ -127,7 +137,7 @@
         "string",
         "null"
       ],
-      "description": "Output directory for test results",
+      "description": "Output directory for test results Limits depend on op.",
       "minLength": 1
     },
     "resetDelayMs": {
@@ -252,491 +262,6 @@
   "required": [
     "op"
   ],
-  "description": "Program operations available via the c64_program tool.\n\nOperations:\n- load_prg: Load a PRG from Ultimate storage without executing it. Required inputs: path. Optional inputs: symbolsFile.\n- run_prg: Load and execute a PRG from Ultimate-visible storage on C64U/U64 or U2-family hardware, or from a host-local path on VICE. Required inputs: path. Optional inputs: symbolsFile.\n- run_crt: Mount and run a CRT cartridge image. Required inputs: path.\n- upload_run_basic: Upload Commodore BASIC v2 source and execute it immediately. Required inputs: program. Optional inputs: verify.\n- upload_run_asm: Assemble 6502/6510 source, upload the PRG, and execute it. Required inputs: program. Optional inputs: verify.\n- batch_run: Run multiple PRG/CRT programs with post-run assertions. Required inputs: programs. Optional inputs: continueOnError, durationMs, outputPath, resetDelayMs.\n- bundle_run: Capture screen, memory, and debug registers into an artifact bundle. Required inputs: runId, outputPath. Optional inputs: captureScreen, memoryRanges, captureDebugReg.\n- cross_platform_greeting: Show a platform-customized greeting on one or more configured backends, capture screenshots, and verify the results. Required inputs: none. Optional inputs: platforms, messageTemplate, verify, captureScreenshot, outputPath, restoreActiveBackend, timeoutMs, pollIntervalMs.",
-  "additionalProperties": false,
-  "x-c64bridge-operations": [
-    {
-      "op": "load_prg",
-      "description": "Load a PRG from Ultimate storage without executing it.",
-      "required": [
-        "path"
-      ],
-      "optional": [
-        "symbolsFile"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Load a PRG from Ultimate storage without executing it.",
-        "properties": {
-          "path": {
-            "type": "string",
-            "description": "Path to the PRG image. Use an Ultimate-visible filesystem path on c64u, or a host-local filesystem path on VICE.",
-            "minLength": 1
-          },
-          "symbolsFile": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "description": "Path to a VICE symbol file (.vs) to load alongside the PRG. Symbols are used by the disassemble tool when annotating addresses.",
-            "minLength": 1
-          },
-          "op": {
-            "const": "load_prg"
-          }
-        },
-        "required": [
-          "path",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "run_prg",
-      "description": "Load and execute a PRG from Ultimate-visible storage on C64U/U64 or U2-family hardware, or from a host-local path on VICE.",
-      "required": [
-        "path"
-      ],
-      "optional": [
-        "symbolsFile"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Load and execute a PRG from Ultimate-visible storage on C64U/U64 or U2-family hardware, or from a host-local path on VICE.",
-        "properties": {
-          "path": {
-            "type": "string",
-            "description": "Path to the PRG image. Use an Ultimate-visible filesystem path on c64u, or a host-local filesystem path on VICE.",
-            "minLength": 1
-          },
-          "symbolsFile": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "description": "Path to a VICE symbol file (.vs) to load alongside the PRG. Symbols are used by the disassemble tool when annotating addresses.",
-            "minLength": 1
-          },
-          "op": {
-            "const": "run_prg"
-          }
-        },
-        "required": [
-          "path",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "run_crt",
-      "description": "Mount and run a CRT cartridge image.",
-      "required": [
-        "path"
-      ],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Mount and run a CRT cartridge image.",
-        "properties": {
-          "path": {
-            "type": "string",
-            "description": "Path to the CRT image on Ultimate-visible storage. CRT mounting is only supported on c64u.",
-            "minLength": 1
-          },
-          "op": {
-            "const": "run_crt"
-          }
-        },
-        "required": [
-          "path",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "upload_run_basic",
-      "description": "Upload Commodore BASIC v2 source and execute it immediately.",
-      "required": [
-        "program"
-      ],
-      "optional": [
-        "verify"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Upload Commodore BASIC v2 source and execute it immediately.",
-        "properties": {
-          "program": {
-            "type": "string",
-            "description": "Commodore BASIC v2 program source to upload and run.",
-            "minLength": 1
-          },
-          "verify": {
-            "type": "boolean",
-            "description": "Run post-execution polling to ensure the BASIC program executed without errors.",
-            "default": false
-          },
-          "op": {
-            "const": "upload_run_basic"
-          }
-        },
-        "required": [
-          "program",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "upload_run_asm",
-      "description": "Assemble 6502/6510 source, upload the PRG, and execute it.",
-      "required": [
-        "program"
-      ],
-      "optional": [
-        "verify"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Assemble 6502/6510 source, upload the PRG, and execute it.",
-        "properties": {
-          "program": {
-            "type": "string",
-            "description": "Assembly source that will be assembled to a PRG and executed.",
-            "minLength": 1
-          },
-          "verify": {
-            "type": "boolean",
-            "description": "Run post-execution polling to confirm the assembly program remained stable.",
-            "default": false
-          },
-          "op": {
-            "const": "upload_run_asm"
-          }
-        },
-        "required": [
-          "program",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "batch_run",
-      "description": "Run multiple PRG/CRT programs with post-run assertions.",
-      "required": [
-        "programs"
-      ],
-      "optional": [
-        "continueOnError",
-        "durationMs",
-        "outputPath",
-        "resetDelayMs"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Run multiple PRG/CRT programs with post-run assertions.",
-        "properties": {
-          "programs": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "description": "Program to run with assertions",
-              "properties": {
-                "path": {
-                  "type": "string",
-                  "description": "Program path (PRG or CRT)",
-                  "minLength": 1
-                },
-                "assertions": {
-                  "type": [
-                    "array",
-                    "null"
-                  ],
-                  "items": {
-                    "type": "object",
-                    "description": "Assertion to check after run",
-                    "properties": {
-                      "type": {
-                        "type": "string",
-                        "description": "Assertion type; sid_silent needs the C64 Ultimate audio stream (c64u backend).",
-                        "enum": [
-                          "screen_contains",
-                          "memory_equals",
-                          "sid_silent"
-                        ]
-                      },
-                      "pattern": {
-                        "type": [
-                          "string",
-                          "null"
-                        ],
-                        "description": "Pattern for screen_contains",
-                        "minLength": 1
-                      },
-                      "address": {
-                        "type": [
-                          "string",
-                          "null"
-                        ],
-                        "description": "Address for memory_equals",
-                        "minLength": 1
-                      },
-                      "expected": {
-                        "type": [
-                          "string",
-                          "null"
-                        ],
-                        "description": "Expected value (hex)",
-                        "minLength": 1
-                      }
-                    },
-                    "required": [
-                      "type"
-                    ],
-                    "additionalProperties": false
-                  }
-                }
-              },
-              "required": [
-                "path"
-              ],
-              "additionalProperties": false
-            }
-          },
-          "continueOnError": {
-            "type": [
-              "boolean",
-              "null"
-            ],
-            "description": "Continue running programs after assertion failure",
-            "default": false
-          },
-          "durationMs": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Duration to run each program before assertions",
-            "minimum": 1,
-            "default": 2000
-          },
-          "outputPath": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "description": "Output directory for test results",
-            "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": "batch_run"
-          }
-        },
-        "required": [
-          "programs",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "bundle_run",
-      "description": "Capture screen, memory, and debug registers into an artifact bundle.",
-      "required": [
-        "runId",
-        "outputPath"
-      ],
-      "optional": [
-        "captureScreen",
-        "memoryRanges",
-        "captureDebugReg"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Capture screen, memory, and debug registers into an artifact bundle.",
-        "properties": {
-          "runId": {
-            "type": "string",
-            "description": "Unique identifier for this run",
-            "minLength": 1
-          },
-          "outputPath": {
-            "type": "string",
-            "description": "Output directory for artifacts bundle",
-            "minLength": 1
-          },
-          "captureScreen": {
-            "type": [
-              "boolean",
-              "null"
-            ],
-            "description": "Capture screen content",
-            "default": true
-          },
-          "memoryRanges": {
-            "type": [
-              "array",
-              "null"
-            ],
-            "items": {
-              "type": "object",
-              "description": "Memory range to snapshot",
-              "properties": {
-                "address": {
-                  "type": "string",
-                  "description": "Start address",
-                  "minLength": 1
-                },
-                "length": {
-                  "type": "integer",
-                  "description": "Length in bytes",
-                  "minimum": 1
-                }
-              },
-              "required": [
-                "address",
-                "length"
-              ],
-              "additionalProperties": false
-            }
-          },
-          "captureDebugReg": {
-            "type": [
-              "boolean",
-              "null"
-            ],
-            "description": "Capture Ultimate debug registers (C64U/U64 only). Defaults to true on C64U/U64 and false on U2/VICE."
-          },
-          "op": {
-            "const": "bundle_run"
-          }
-        },
-        "required": [
-          "runId",
-          "outputPath",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "cross_platform_greeting",
-      "description": "Show a platform-customized greeting on one or more configured backends, capture screenshots, and verify the results.",
-      "required": [],
-      "optional": [
-        "platforms",
-        "messageTemplate",
-        "verify",
-        "captureScreenshot",
-        "outputPath",
-        "restoreActiveBackend",
-        "timeoutMs",
-        "pollIntervalMs"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Show a platform-customized greeting on one or more configured backends, capture screenshots, and verify the results.",
-        "properties": {
-          "platforms": {
-            "type": [
-              "array",
-              "null"
-            ],
-            "items": {
-              "type": "string",
-              "description": "Backends to target in sequence.",
-              "minLength": 1,
-              "enum": [
-                "vice",
-                "c64u",
-                "u2"
-              ]
-            }
-          },
-          "messageTemplate": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "description": "Greeting template. Use {PLATFORM}/{BACKEND} for uppercase or {platform}/{backend} for lowercase substitution.",
-            "minLength": 1,
-            "default": "HAVE A GREAT DAY, {PLATFORM}!"
-          },
-          "verify": {
-            "type": [
-              "boolean",
-              "null"
-            ],
-            "description": "Poll the text screen and require the rendered greeting to appear.",
-            "default": true
-          },
-          "captureScreenshot": {
-            "type": [
-              "boolean",
-              "null"
-            ],
-            "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": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "description": "Directory for screenshots and the workflow summary JSON.",
-            "minLength": 1
-          },
-          "restoreActiveBackend": {
-            "type": [
-              "boolean",
-              "null"
-            ],
-            "description": "Restore the backend that was active before the workflow started.",
-            "default": true
-          },
-          "timeoutMs": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Maximum time to wait for each greeting to appear on screen.",
-            "minimum": 100,
-            "maximum": 5000,
-            "default": 1500
-          },
-          "pollIntervalMs": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Delay between screen polls while verifying the greeting.",
-            "minimum": 50,
-            "maximum": 1000,
-            "default": 100
-          },
-          "op": {
-            "const": "cross_platform_greeting"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    }
-  ]
+  "description": "Program operations available via the c64_program tool.\n\nOperations:\n- load_prg [write]: Load a PRG from Ultimate storage without executing it. Required inputs: path. Optional inputs: symbolsFile.\n- run_prg [write]: Load and execute a PRG from Ultimate-visible storage on C64U/U64 or U2-family hardware, or from a host-local path on VICE. Required inputs: path. Optional inputs: symbolsFile.\n- run_crt [c64u, u2] [write]: Mount and run a CRT cartridge image. Required inputs: path.\n- upload_run_basic [write]: Upload Commodore BASIC v2 source and execute it immediately. Required inputs: program. Optional inputs: verify, autoFix.\n- upload_run_asm [write]: Assemble 6502/6510 source, upload the PRG, and execute it. Required inputs: program. Optional inputs: verify.\n- batch_run [write]: Run multiple PRG/CRT programs with post-run assertions. Required inputs: programs. Optional inputs: continueOnError, durationMs, outputPath, resetDelayMs.\n- bundle_run [write]: Capture screen, memory, and debug registers into an artifact bundle. Required inputs: runId, outputPath. Optional inputs: captureScreen, memoryRanges, captureDebugReg.\n- cross_platform_greeting [write]: Show a platform-customized greeting on one or more configured backends, capture screenshots, and verify the results. Required inputs: none. Optional inputs: platforms, messageTemplate, verify, captureScreenshot, outputPath, restoreActiveBackend, timeoutMs, pollIntervalMs.",
+  "additionalProperties": false
 }

package/mcp/schemas/c64_rag.schema.json

@@ -29,85 +29,5 @@
     "op"
   ],
   "description": "RAG operations available via the c64_rag tool.\n\nOperations:\n- basic: Retrieve BASIC references and snippets from the local knowledge base. Required inputs: q. Optional inputs: k.\n- asm: Retrieve 6502/6510 assembly references from the local knowledge base. Required inputs: q. Optional inputs: k.",
-  "additionalProperties": false,
-  "x-c64bridge-operations": [
-    {
-      "op": "basic",
-      "description": "Retrieve BASIC references and snippets from the local knowledge base.",
-      "required": [
-        "q"
-      ],
-      "optional": [
-        "k"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Retrieve BASIC references and snippets from the local knowledge base.",
-        "properties": {
-          "q": {
-            "type": "string",
-            "description": "Natural-language query describing the desired BASIC or assembly guidance.",
-            "minLength": 3
-          },
-          "k": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Maximum number of references to return (1-12).",
-            "minimum": 1,
-            "maximum": 12,
-            "default": 3
-          },
-          "op": {
-            "const": "basic"
-          }
-        },
-        "required": [
-          "q",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "asm",
-      "description": "Retrieve 6502/6510 assembly references from the local knowledge base.",
-      "required": [
-        "q"
-      ],
-      "optional": [
-        "k"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Retrieve 6502/6510 assembly references from the local knowledge base.",
-        "properties": {
-          "q": {
-            "type": "string",
-            "description": "Natural-language query describing the desired BASIC or assembly guidance.",
-            "minLength": 3
-          },
-          "k": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Maximum number of references to return (1-12).",
-            "minimum": 1,
-            "maximum": 12,
-            "default": 3
-          },
-          "op": {
-            "const": "asm"
-          }
-        },
-        "required": [
-          "q",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    }
-  ]
+  "additionalProperties": false
 }

package/mcp/schemas/c64_select_backend.schema.json

@@ -21,40 +21,6 @@
   "required": [
     "op"
   ],
-  "description": "Runtime backend selection operations.\n\nOperations:\n- select: Switch the active runtime backend without restarting the MCP server. Required inputs: backend.",
-  "additionalProperties": false,
-  "x-c64bridge-operations": [
-    {
-      "op": "select",
-      "description": "Switch the active runtime backend without restarting the MCP server.",
-      "required": [
-        "backend"
-      ],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Switch the active runtime backend without restarting the MCP server.",
-        "properties": {
-          "op": {
-            "const": "select",
-            "description": "Selects the select operation."
-          },
-          "backend": {
-            "type": "string",
-            "enum": [
-              "c64u",
-              "u2",
-              "vice"
-            ],
-            "description": "Backend to activate for subsequent tool calls."
-          }
-        },
-        "required": [
-          "op",
-          "backend"
-        ],
-        "additionalProperties": false
-      }
-    }
-  ]
+  "description": "Runtime backend selection operations.\n\nOperations:\n- select [write]: Switch the active runtime backend without restarting the MCP server. Required inputs: backend.",
+  "additionalProperties": false
 }