c64bridge 1.0.6 → 1.1.0

package/mcp/schemas/c64_stream.schema.json

@@ -20,84 +20,13 @@
     },
     "target": {
       "type": "string",
-      "description": "Destination host:port or UDP target understood by the firmware.",
-      "minLength": 3
+      "description": "Destination of the UDP stream: IPv4 address or hostname with an optional :port (1-65535), e.g. 192.168.1.10, 192.168.1.10:11000 or pc.local:11000. The device sends the stream unencrypted over UDP to this address.",
+      "minLength": 1
     }
   },
   "required": [
     "op"
   ],
-  "description": "Streaming operations available via the c64_stream tool.\n\nOperations:\n- start: Start an Ultimate streaming session toward a host:port target. Required inputs: stream, target.\n- stop: Stop an active Ultimate streaming session. Required inputs: stream.",
-  "additionalProperties": false,
-  "x-c64bridge-operations": [
-    {
-      "op": "start",
-      "description": "Start an Ultimate streaming session toward a host:port target.",
-      "required": [
-        "stream",
-        "target"
-      ],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Start an Ultimate streaming session toward a host:port target.",
-        "properties": {
-          "stream": {
-            "type": "string",
-            "description": "Stream type to control (video/audio/debug).",
-            "enum": [
-              "video",
-              "audio",
-              "debug"
-            ]
-          },
-          "target": {
-            "type": "string",
-            "description": "Destination host:port or UDP target understood by the firmware.",
-            "minLength": 3
-          },
-          "op": {
-            "const": "start"
-          }
-        },
-        "required": [
-          "stream",
-          "target",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "stop",
-      "description": "Stop an active Ultimate streaming session.",
-      "required": [
-        "stream"
-      ],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Stop an active Ultimate streaming session.",
-        "properties": {
-          "stream": {
-            "type": "string",
-            "description": "Stream type to control (video/audio/debug).",
-            "enum": [
-              "video",
-              "audio",
-              "debug"
-            ]
-          },
-          "op": {
-            "const": "stop"
-          }
-        },
-        "required": [
-          "stream",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    }
-  ]
+  "description": "Streaming operations available via the c64_stream tool.\n\nOperations:\n- start [write]: Start an Ultimate streaming session. The device sends an unencrypted UDP stream to the target (IPv4 address or hostname, optional :port). Required inputs: stream, target.\n- stop [write]: Stop an active Ultimate streaming session. Required inputs: stream.",
+  "additionalProperties": false
 }

package/mcp/schemas/c64_system.schema.json

@@ -20,15 +20,32 @@
       ],
       "description": "Selects the operation."
     },
+    "waitForReady": {
+      "type": [
+        "boolean",
+        "null"
+      ],
+      "description": "Wait until the BASIC READY. prompt is visible before returning. A timeout is reported as ready=false, not as an error.",
+      "default": false
+    },
+    "readyTimeoutMs": {
+      "type": [
+        "integer",
+        "null"
+      ],
+      "description": "Maximum time to wait for READY. when waitForReady is true (1-120000 ms).",
+      "minimum": 1,
+      "maximum": 120000,
+      "default": 15000
+    },
     "name": {
       "type": "string",
-      "description": "Unique task name (letters, digits, spaces, '_', '-', '.'; must not start with '.' or a space).",
-      "minLength": 1,
-      "pattern": "^[A-Za-z0-9_][A-Za-z0-9_. -]*$"
+      "description": "Unique task name (letters, digits, spaces, '_', '-', '.'; must not start with '.' or a space). Limits depend on op.",
+      "minLength": 1
     },
     "operation": {
       "type": "string",
-      "description": "Operation name (e.g., read, read_screen)",
+      "description": "Operation name: read, write, read_screen or menu_button (read_memory and write_memory are aliases). write requires arguments.address and arguments.bytes.",
       "minLength": 1
     },
     "arguments": {
@@ -46,8 +63,8 @@
         "integer",
         "null"
       ],
-      "description": "Interval milliseconds",
-      "minimum": 1,
+      "description": "Interval milliseconds (minimum 100)",
+      "minimum": 100,
       "default": 1000
     },
     "maxIterations": {
@@ -55,8 +72,9 @@
         "integer",
         "null"
       ],
-      "description": "Maximum number of iterations (omit for indefinite)",
-      "minimum": 1
+      "description": "Maximum number of iterations (1 to 100000; omit for indefinite)",
+      "minimum": 1,
+      "maximum": 100000
     },
     "scope": {
       "type": [
@@ -92,344 +110,6 @@
   "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: 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": [
-    {
-      "op": "pause",
-      "description": "Pause the machine until resumed.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Pause the machine until resumed.",
-        "properties": {
-          "op": {
-            "const": "pause"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "resume",
-      "description": "Resume CPU execution after a pause.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Resume CPU execution after a pause.",
-        "properties": {
-          "op": {
-            "const": "resume"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "reset",
-      "description": "Issue a soft reset without cutting power.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Issue a soft reset without cutting power.",
-        "properties": {
-          "op": {
-            "const": "reset"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "reboot",
-      "description": "Trigger a firmware reboot to recover from faults.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Trigger a firmware reboot to recover from faults.",
-        "properties": {
-          "op": {
-            "const": "reboot"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "poweroff",
-      "description": "Shut down C64U/U64 or quit VICE. U2-family hardware cannot power off.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Shut down C64U/U64 or quit VICE. U2-family hardware cannot power off.",
-        "properties": {
-          "op": {
-            "const": "poweroff"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "power_cycle",
-      "description": "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": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "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.",
-        "properties": {
-          "op": {
-            "const": "power_cycle"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "menu",
-      "description": "Toggle the Ultimate menu button for navigation.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Toggle the Ultimate menu button for navigation.",
-        "properties": {
-          "op": {
-            "const": "menu"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "read_menu_screen",
-      "description": "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": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "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+).",
-        "properties": {
-          "op": {
-            "const": "read_menu_screen"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "start_task",
-      "description": "Start a named background task that runs on an interval.",
-      "required": [
-        "name",
-        "operation"
-      ],
-      "optional": [
-        "arguments",
-        "intervalMs",
-        "maxIterations"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Start a named background task that runs on an interval.",
-        "properties": {
-          "name": {
-            "type": "string",
-            "description": "Unique task name (letters, digits, spaces, '_', '-', '.'; must not start with '.' or a space).",
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9_][A-Za-z0-9_. -]*$"
-          },
-          "operation": {
-            "type": "string",
-            "description": "Operation name (e.g., read, read_screen)",
-            "minLength": 1
-          },
-          "arguments": {
-            "type": [
-              "object",
-              "null"
-            ],
-            "description": "Operation-specific arguments",
-            "properties": {},
-            "additionalProperties": true,
-            "default": {}
-          },
-          "intervalMs": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Interval milliseconds",
-            "minimum": 1,
-            "default": 1000
-          },
-          "maxIterations": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Maximum number of iterations (omit for indefinite)",
-            "minimum": 1
-          },
-          "op": {
-            "const": "start_task"
-          }
-        },
-        "required": [
-          "name",
-          "operation",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "stop_task",
-      "description": "Stop a specific background task and clear its timer.",
-      "required": [
-        "name"
-      ],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Stop a specific background task and clear its timer.",
-        "properties": {
-          "name": {
-            "type": "string",
-            "description": "Task name",
-            "minLength": 1
-          },
-          "op": {
-            "const": "stop_task"
-          }
-        },
-        "required": [
-          "name",
-          "op"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "stop_all_tasks",
-      "description": "Stop every running background task and persist state.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Stop every running background task and persist state.",
-        "properties": {
-          "op": {
-            "const": "stop_all_tasks"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "list_tasks",
-      "description": "List known background tasks with status metadata.",
-      "required": [],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "List known background tasks with status metadata.",
-        "properties": {
-          "op": {
-            "const": "list_tasks"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    },
-    {
-      "op": "performance_report",
-      "description": "Summarize diagnostics spans and tool latencies from the current or latest MCP session.",
-      "required": [],
-      "optional": [
-        "scope",
-        "includeTimeline",
-        "maxEntries"
-      ],
-      "inputSchema": {
-        "type": "object",
-        "description": "Summarize diagnostics spans and tool latencies from the current or latest MCP session.",
-        "properties": {
-          "scope": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "description": "Which diagnostics session to summarize.",
-            "enum": [
-              "current",
-              "latest"
-            ],
-            "default": "current"
-          },
-          "includeTimeline": {
-            "type": [
-              "boolean",
-              "null"
-            ],
-            "description": "Include the tail of the event timeline.",
-            "default": true
-          },
-          "maxEntries": {
-            "type": [
-              "integer",
-              "null"
-            ],
-            "description": "Maximum number of span and timeline entries to return.",
-            "minimum": 1,
-            "maximum": 200,
-            "default": 25
-          },
-          "op": {
-            "const": "performance_report"
-          }
-        },
-        "additionalProperties": false,
-        "required": [
-          "op"
-        ]
-      }
-    }
-  ]
+  "description": "System operations available via the c64_system tool.\n\nOperations:\n- pause [c64u, u2] [write]: Pause the machine until resumed. Required inputs: none.\n- resume [c64u, u2] [write]: Resume CPU execution after a pause. Required inputs: none.\n- reset [write]: Issue a soft reset without cutting power. Required inputs: none. Optional inputs: waitForReady, readyTimeoutMs.\n- reboot [destructive]: Trigger a firmware reboot to recover from faults. Required inputs: none. Optional inputs: waitForReady, readyTimeoutMs.\n- poweroff [c64u, vice] [destructive]: Shut down C64U/U64 or quit VICE. U2-family hardware cannot power off. On C64U/U64 the machine cannot be restarted by software afterwards: power must be restored at the outlet, and it starts by itself only if automatic startup on power restoration is enabled. Required inputs: none.\n- power_cycle [destructive]: 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. Optional inputs: waitForReady, readyTimeoutMs.\n- menu [c64u, u2] [write]: Toggle the Ultimate menu button for navigation. Required inputs: none.\n- read_menu_screen [c64u, u2]: 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 [write]: Start a named background task that runs on an interval. Required inputs: name, operation. Optional inputs: arguments, intervalMs, maxIterations.\n- stop_task [write]: Stop a specific background task and clear its timer. Required inputs: name.\n- stop_all_tasks [write]: 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
 }

package/mcp/schemas/c64_vice.schema.json

@@ -27,75 +27,6 @@
   "required": [
     "op"
   ],
-  "description": "VICE emulator operations available via the c64_vice tool.\n\nOperations:\n- resource_get: Read a VICE configuration resource (safe prefixes only). Required inputs: name.\n- resource_set: Write a VICE configuration resource (safe prefixes only). Required inputs: name, value.",
-  "additionalProperties": false,
-  "x-c64bridge-operations": [
-    {
-      "op": "resource_get",
-      "description": "Read a VICE configuration resource (safe prefixes only).",
-      "required": [
-        "name"
-      ],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Read a VICE configuration resource (safe prefixes only).",
-        "properties": {
-          "op": {
-            "const": "resource_get"
-          },
-          "name": {
-            "type": "string",
-            "description": "VICE resource name (example: SidEngine, SidModel).",
-            "minLength": 1,
-            "maxLength": 64,
-            "pattern": "^[A-Z][A-Za-z0-9_.-]{0,63}$"
-          }
-        },
-        "required": [
-          "op",
-          "name"
-        ],
-        "additionalProperties": false
-      }
-    },
-    {
-      "op": "resource_set",
-      "description": "Write a VICE configuration resource (safe prefixes only).",
-      "required": [
-        "name",
-        "value"
-      ],
-      "optional": [],
-      "inputSchema": {
-        "type": "object",
-        "description": "Write a VICE configuration resource (safe prefixes only).",
-        "properties": {
-          "op": {
-            "const": "resource_set"
-          },
-          "name": {
-            "type": "string",
-            "description": "VICE resource name (example: SidEngine, SidModel).",
-            "minLength": 1,
-            "maxLength": 64,
-            "pattern": "^[A-Z][A-Za-z0-9_.-]{0,63}$"
-          },
-          "value": {
-            "type": [
-              "string",
-              "integer"
-            ],
-            "description": "VICE resource value (string or integer)."
-          }
-        },
-        "required": [
-          "op",
-          "name",
-          "value"
-        ],
-        "additionalProperties": false
-      }
-    }
-  ]
+  "description": "VICE emulator operations available via the c64_vice tool.\n\nOperations:\n- resource_get: Read a VICE configuration resource (safe prefixes only). Required inputs: name.\n- resource_set [write]: Write a VICE configuration resource (safe prefixes only). Required inputs: name, value.",
+  "additionalProperties": false
 }

package/mcp/server.json

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