c64bridge 0.9.2 → 1.0.0

package/mcp.json

@@ -1,6 +1,6 @@
 {
   "name": "c64bridge",
-  "version": "0.9.2",
+  "version": "1.0.0",
   "description": "Stdio-based Model Context Protocol (MCP) server that bridges Commodore 64 Ultimate hardware with AI agents.",
   "entry": "dist/index.js",
   "type": "stdio",
@@ -37,7 +37,7 @@
       "default": "~/.c64bridge.json"
     },
     "C64_MODE": {
-      "description": "Select active backend (c64u for Ultimate hardware, vice for emulator)",
+      "description": "Select active backend (c64u/U64 hardware, u2/U2-family cartridge, or vice emulator)",
       "default": "c64u"
     },
     "C64U_HOST": {
@@ -52,6 +52,18 @@
       "description": "Override the C64 Ultimate network password sent as X-Password",
       "default": ""
     },
+    "U2_HOST": {
+      "description": "Override the U2/U2+/U2+L host name or IP address when C64_MODE=u2",
+      "default": ""
+    },
+    "U2_PORT": {
+      "description": "Override the U2-family REST port when C64_MODE=u2",
+      "default": ""
+    },
+    "U2_PASSWORD": {
+      "description": "Override the U2-family network password sent as X-Password when C64_MODE=u2",
+      "default": ""
+    },
     "C64BRIDGE_DIAGNOSTICS_DIR": {
       "description": "Override the directory where persistent MCP diagnostics files are written",
       "default": "~/.c64bridge/diagnostics"
@@ -129,7 +141,7 @@
       "default": "6502"
     },
     "VICE_VISIBLE": {
-      "description": "Launch VICE visibly on the desktop instead of headless/Xvfb when possible",
+      "description": "Launch VICE as a desktop window when true; use headless/Xvfb managed launch when false",
       "default": "true"
     },
     "VICE_WARP": {
@@ -137,15 +149,19 @@
       "default": "false when visible, true when headless"
     },
     "VICE_ARGS": {
-      "description": "Extra command-line arguments forwarded to managed VICE launches",
+      "description": "Extra command-line arguments forwarded to managed VICE launches, such as -minimized for a visible window that starts iconified",
       "default": ""
     },
+    "VICE_PREWARM": {
+      "description": "Set to 1 to start/connect VICE in the background during MCP startup; disabled by default so VICE starts lazily on first use",
+      "default": "0"
+    },
     "VICE_RUN_TIMEOUT_MS": {
       "description": "Timeout for headless VICE runs in milliseconds",
       "default": "10000"
     },
     "FORCE_XVFB": {
-      "description": "Set to 1 to force managed VICE launches to run under Xvfb",
+      "description": "Set to 1 to force managed VICE launches to use Xvfb even when a graphical session is detected",
       "default": "0"
     },
     "DISABLE_XVFB": {

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "c64bridge",
-  "version": "0.9.2",
+  "version": "1.0.0",
   "mcpName": "io.github.chrisgleissner/c64bridge",
   "description": "C64 Bridge MCP server for Commodore 64 Ultimate hardware and VICE emulator control",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chrisgleissner/c64bridge.git"
+  },
   "type": "module",
   "main": "dist/index.js",
   "packageManager": "bun@1.3.1",
@@ -34,7 +38,9 @@
     "check": "npm run build && npm test",
     "check:node-compat": "node scripts/check-node-compat.mjs",
     "build:rag": "node scripts/invoke-bun.mjs scripts/rag-rebuild.mjs",
-    "api:generate": "npx --yes swagger-typescript-api@12.0.4 -p doc/c64u/c64-openapi.yaml -o generated/c64 -n index.ts --axios --single-http-client --module-name-first-tag",
+    "api:generate": "npm run api:generate:c64u && npm run api:generate:u2",
+    "api:generate:c64u": "npx --yes swagger-typescript-api@12.0.4 -p doc/c64u/c64-openapi.yaml -o generated/openapi/c64u -n index.ts --axios --single-http-client --module-name-index 0",
+    "api:generate:u2": "npx --yes swagger-typescript-api@12.0.4 -p doc/u2/u2-openapi.yaml -o generated/openapi/u2 -n index.ts --axios --single-http-client --module-name-index 0",
     "c64:tool": "bash scripts/c64-tool.sh",
     "rag:rebuild": "node scripts/invoke-bun.mjs scripts/rag-rebuild.mjs",
     "rag:fetch": "node scripts/fetch-external-sources.mjs",
@@ -63,22 +69,22 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "axios": "^1.16.0",
-    "date-fns": "^4.1.0",
-    "fastify": "^5.8.5",
+    "axios": "^1.18.1",
+    "date-fns": "^4.4.0",
+    "fastify": "^5.10.0",
     "jimp": "^1.6.1",
     "meyda": "^5.6.3",
     "octokit": "^5.0.5",
     "pitchfinder": "^2.3.4",
     "reflect-metadata": "^0.2.2",
-    "yaml": "^2.8.4"
+    "yaml": "^2.9.0"
   },
   "optionalDependencies": {
     "naudiodon": "^2.3.6"
   },
   "devDependencies": {
-    "@types/node": "^25.6.0",
-    "tsx": "^4.21.0",
+    "@types/node": "^25.9.5",
+    "tsx": "^4.23.0",
     "typescript": "^6.0.3"
   },
   "files": [

package/scripts/mockC64Server.mjs

@@ -112,6 +112,8 @@ function createInitialState() {
     lastConfigAction: null,
   menuToggleCount: 0,
   lastMenuTarget: null,
+    menuScreen: Buffer.from([0x41, 0x01, 0x42, 0x02]),
+    inputState: { keyboard: { inputs: [] }, joysticks: [{ port: 1, inputs: [] }, { port: 2, inputs: [] }] },
     streams: {
       video: { active: false, target: null, packetsSent: 0 },
       audio: { active: false, target: null, packetsSent: 0 },
@@ -331,6 +333,44 @@ export async function startMockC64Server(options = {}) {
       return;
     }
 
+    if (method === "GET" && url === "/v1/machine:menu_screen") {
+      res.setHeader("Content-Type", "application/octet-stream");
+      res.end(state.menuScreen);
+      return;
+    }
+
+    if (method === "GET" && url === "/v1/machine:input") {
+      sendJson(res, state.inputState);
+      return;
+    }
+
+    if (method === "POST" && url === "/v1/machine:input") {
+      const batch = await readJson(req);
+      for (const event of batch.events ?? []) {
+        if (event.kind === "release_all") {
+          state.inputState.keyboard.inputs = [];
+          state.inputState.joysticks.forEach((joystick) => { joystick.inputs = []; });
+          continue;
+        }
+        const target = event.kind === "keyboard"
+          ? state.inputState.keyboard
+          : state.inputState.joysticks.find((joystick) => joystick.port === event.port);
+        if (!target) continue;
+        const inputs = new Set(target.inputs);
+        for (const input of event.inputs ?? []) {
+          if (event.transition === "release") inputs.delete(input);
+          else if (event.transition === "press") inputs.add(input);
+          else if (event.transition === "tap") {
+            inputs.add(input);
+            inputs.delete(input);
+          }
+        }
+        target.inputs = [...inputs];
+      }
+      sendJson(res, state.inputState);
+      return;
+    }
+
     if (method === "GET" && url === "/v1/machine:debugreg") {
       sendJson(res, { value: state.debugreg ?? "00" });
       return;

package/scripts/prepare-release.mjs

@@ -26,8 +26,19 @@ const fileExists = async (relativePath) => {
 };
 
 const getRepositoryMetadata = (repository) => {
-  const url = typeof repository === 'string' ? repository : repository?.url;
-  if (!url) {
+  const rawUrl = typeof repository === 'string' ? repository : repository?.url;
+  if (!rawUrl) {
+    return undefined;
+  }
+
+  let url = rawUrl.trim();
+  if (url.startsWith('git+')) {
+    url = url.slice(4);
+  }
+  if (url.endsWith('.git')) {
+    url = url.slice(0, -4);
+  }
+  if (!/^https?:\/\//.test(url)) {
     return undefined;
   }
 

package/scripts/update-readme.ts

@@ -27,6 +27,7 @@ type ManifestEnvEntry = {
 type EnvCategory =
   | "Server Runtime"
   | "C64 Ultimate"
+  | "U2-family"
   | "VICE Runtime"
   | "VICE Audio Capture"
   | "SID Playback"
@@ -55,6 +56,9 @@ function classifyEnvVariable(name: string): EnvCategory {
   if (name.startsWith("C64U_")) {
     return "C64 Ultimate";
   }
+  if (name.startsWith("U2_")) {
+    return "U2-family";
+  }
   if (name.startsWith("VICE_") || name === "FORCE_XVFB" || name === "DISABLE_XVFB") {
     if (name === "VICE_MODE" || name === "VICE_LIMIT_CYCLES" || name === "VICE_RUN_TIMEOUT_MS") {
       return "VICE Audio Capture";
@@ -79,6 +83,9 @@ function resolveJsonConfigKey(name: string): string {
     C64U_HOST: "c64u.host",
     C64U_PORT: "c64u.port",
     C64U_PASSWORD: "c64u.networkPassword",
+    U2_HOST: "u2.host",
+    U2_PORT: "u2.port",
+    U2_PASSWORD: "u2.networkPassword",
     VICE_BINARY: "vice.exe",
     VICE_DIRECTORY: "vice.directory",
     VICE_HOST: "vice.host",
@@ -86,6 +93,7 @@ function resolveJsonConfigKey(name: string): string {
     VICE_VISIBLE: "vice.visible",
     VICE_WARP: "vice.warp",
     VICE_ARGS: "vice.args",
+    VICE_PREWARM: "vice.prewarm",
   };
   return map[name] ?? "—";
 }
@@ -103,6 +111,7 @@ export function renderEnvironmentSection(envEntries: Readonly<Record<string, Man
   const orderedCategories: readonly EnvCategory[] = [
     "Server Runtime",
     "C64 Ultimate",
+    "U2-family",
     "VICE Runtime",
     "VICE Audio Capture",
     "SID Playback",
@@ -144,7 +153,6 @@ type GroupedOperation = {
   readonly required: readonly string[];
   readonly optional: readonly string[];
   readonly properties: Readonly<Record<string, JsonSchema | undefined>>;
-  readonly notes: readonly string[];
 };
 
 type GroupedToolInfo = {
@@ -167,6 +175,11 @@ function toTableValue(values: readonly string[]): string {
   return values.join(", ");
 }
 
+function withVerificationNote(description: string, properties: Readonly<Record<string, JsonSchema | undefined>>): string {
+  const supportsVerification = Object.keys(properties).some((name) => name.toLowerCase().startsWith("verify"));
+  return supportsVerification ? `${description} Supports verification.` : description;
+}
+
 function formatInputName(name: string, schema?: JsonSchema): string {
   const defaultSuffix = schema && Object.prototype.hasOwnProperty.call(schema, "default")
     ? `=${JSON.stringify(schema.default)}`
@@ -228,21 +241,12 @@ function collectFromOperationMetadata(schema: JsonSchema): readonly GroupedOpera
       ? entry.optional.filter((name): name is string => typeof name === "string" && name !== "op")
       : Object.keys(properties).filter((name) => name !== "op" && !requiredProps.includes(name));
 
-    const notes: string[] = [];
-    const hasVerificationProperty = Object.keys(properties).some((name) =>
-      name.toLowerCase().startsWith("verify"),
-    );
-    if (hasVerificationProperty) {
-      notes.push("supports verify");
-    }
-
     operations.push({
       op: opName,
-      description: getString(entry.description, `Operation ${opName}`),
+      description: withVerificationNote(getString(entry.description, `Operation ${opName}`), properties),
       required: requiredProps,
       optional: optionalProps,
       properties,
-      notes,
     });
   }
 
@@ -281,21 +285,12 @@ function collectFromVariantList(variants: readonly JsonSchema[]): readonly Group
     const description = getString(typedVariant.description, getString(opSchema?.description, `Operation ${opName}`));
     const requiredProps = ((typedVariant.required as readonly string[] | undefined) ?? []).filter((name) => name !== "op");
 
-    const notes: string[] = [];
-    const hasVerificationProperty = Object.keys(properties).some((name) =>
-      name.toLowerCase().startsWith("verify"),
-    );
-    if (hasVerificationProperty) {
-      notes.push("supports verify");
-    }
-
     operations.push({
       op: opName,
-      description,
+      description: withVerificationNote(description, properties),
       required: requiredProps,
       optional: Object.keys(properties).filter((name) => name !== "op" && !requiredProps.includes(name)),
       properties,
-      notes,
     });
   }
 
@@ -320,18 +315,12 @@ function collectFromFlattenedSchema(schema: JsonSchema): readonly GroupedOperati
   }
 
   const descriptionMap = parseOperationDescriptions(getString(schema.description));
-  const hasVerificationProperty = Object.keys(properties).some((name) =>
-    name !== "op" && name.toLowerCase().startsWith("verify"),
-  );
-  const notes = hasVerificationProperty ? ["supports verify"] : [];
-
   return opNames.map((opName) => ({
     op: opName,
-    description: descriptionMap.get(opName) ?? `Operation ${opName}`,
+    description: withVerificationNote(descriptionMap.get(opName) ?? `Operation ${opName}`, properties),
     required: [] as readonly string[],
     optional: Object.keys(properties).filter((name) => name !== "op"),
     properties,
-    notes,
   }));
 }
 
@@ -390,13 +379,13 @@ export function renderToolsSection(modules: readonly ToolModuleDescriptor[] = de
               escapeCell(operation.description),
               escapeCell(formatInputs(operation.required, operation.properties)),
               escapeCell(formatInputs(operation.optional, operation.properties)),
-              operation.notes.length ? escapeCell(operation.notes.join(", ")) : "—",
               effectivePlatforms.includes("c64u") ? "✅" : "",
+              effectivePlatforms.includes("u2") ? "✅" : "",
               effectivePlatforms.includes("vice") ? "✅" : "",
             ];
           });
 
-        lines.push(renderTable(["Operation", "Description", "Required Inputs", "Optional Inputs", "Notes", "C64U", "VICE"], operationRows));
+        lines.push(renderTable(["Operation", "Description", "Required Inputs", "Optional Inputs", "C64U", "U2", "VICE"], operationRows));
       }
 
       lines.push("");

package/server.json

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