c64bridge 0.9.0 → 0.9.1

package/mcp/schemas/c64_stream.schema.json

@@ -27,6 +27,77 @@
   "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.\n- stop: Stop an active Ultimate streaming session.",
-  "additionalProperties": false
+  "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
+      }
+    }
+  ]
 }

package/mcp/schemas/c64_system.schema.json

@@ -89,6 +89,305 @@
   "required": [
     "op"
   ],
-  "description": "System operations available via the c64_system tool.\n\nOperations:\n- pause: Pause the machine until resumed.\n- resume: Resume CPU execution after a pause.\n- reset: Issue a soft reset without cutting power.\n- reboot: Trigger a firmware reboot to recover from faults.\n- poweroff: Request a controlled shutdown via the Ultimate firmware.\n- menu: Toggle the Ultimate menu button for navigation.\n- start_task: Start a named background task that runs on an interval.\n- stop_task: Stop a specific background task and clear its timer.\n- stop_all_tasks: Stop every running background task and persist state.\n- list_tasks: List known background tasks with status metadata.\n- performance_report: Summarize diagnostics spans and tool latencies from the current or latest MCP session.",
-  "additionalProperties": false
+  "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- menu: Toggle the Ultimate menu button for navigation. 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": "Request a controlled shutdown via the Ultimate firmware.",
+      "required": [],
+      "optional": [],
+      "inputSchema": {
+        "type": "object",
+        "description": "Request a controlled shutdown via the Ultimate firmware.",
+        "properties": {
+          "op": {
+            "const": "poweroff"
+          }
+        },
+        "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": "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",
+            "minLength": 1
+          },
+          "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"
+        ]
+      }
+    }
+  ]
 }

package/mcp/schemas/c64_vice.schema.json

@@ -27,6 +27,75 @@
   "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).\n- resource_set: Write a VICE configuration resource (safe prefixes only).",
-  "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 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, C64Model).",
+            "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, C64Model).",
+            "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
+      }
+    }
+  ]
 }

package/mcp/server.json

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