c64bridge 0.7.4 → 0.8.1

package/mcp/schemas/c64_system.schema.json

@@ -0,0 +1,227 @@
+{
+  "type": "object",
+  "description": "System operations available via the c64_system tool.",
+  "oneOf": [
+    {
+      "type": "object",
+      "description": "Pause the machine until resumed.",
+      "properties": {
+        "op": {
+          "const": "pause"
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "op"
+      ]
+    },
+    {
+      "type": "object",
+      "description": "Resume CPU execution after a pause.",
+      "properties": {
+        "op": {
+          "const": "resume"
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "op"
+      ]
+    },
+    {
+      "type": "object",
+      "description": "Issue a soft reset without cutting power.",
+      "properties": {
+        "op": {
+          "const": "reset"
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "op"
+      ]
+    },
+    {
+      "type": "object",
+      "description": "Trigger a firmware reboot to recover from faults.",
+      "properties": {
+        "op": {
+          "const": "reboot"
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "op"
+      ]
+    },
+    {
+      "type": "object",
+      "description": "Request a controlled shutdown via the Ultimate firmware.",
+      "properties": {
+        "op": {
+          "const": "poweroff"
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "op"
+      ]
+    },
+    {
+      "type": "object",
+      "description": "Toggle the Ultimate menu button for navigation.",
+      "properties": {
+        "op": {
+          "const": "menu"
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "op"
+      ]
+    },
+    {
+      "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
+    },
+    {
+      "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
+    },
+    {
+      "type": "object",
+      "description": "Stop every running background task and persist state.",
+      "properties": {
+        "op": {
+          "const": "stop_all_tasks"
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "op"
+      ]
+    },
+    {
+      "type": "object",
+      "description": "List known background tasks with status metadata.",
+      "properties": {
+        "op": {
+          "const": "list_tasks"
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "op"
+      ]
+    },
+    {
+      "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"
+      ]
+    }
+  ],
+  "discriminator": {
+    "propertyName": "op"
+  }
+}

package/mcp/schemas/c64_vice.schema.json

@@ -0,0 +1,63 @@
+{
+  "type": "object",
+  "description": "VICE emulator operations available via the c64_vice tool.",
+  "oneOf": [
+    {
+      "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
+    },
+    {
+      "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": {
+          "description": "VICE resource value (string or integer).",
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "integer"
+            }
+          ]
+        }
+      },
+      "required": [
+        "op",
+        "name",
+        "value"
+      ],
+      "additionalProperties": false
+    }
+  ],
+  "discriminator": {
+    "propertyName": "op"
+  }
+}

package/mcp/server.json

@@ -0,0 +1,15 @@
+{
+  "name": "c64bridge",
+  "version": "0.8.1",
+  "description": "Stdio-based Model Context Protocol (MCP) server that bridges Commodore 64 Ultimate hardware with AI agents.",
+  "transports": [
+    "stdio"
+  ],
+  "capabilities": {
+    "prompts": {},
+    "resources": {},
+    "tools": {}
+  },
+  "repository": "https://github.com/chrisgleissner/c64bridge",
+  "license": "GPL-2.0-only"
+}