c64bridge 0.9.2 → 1.0.0

package/dist/tools/programRunners.js

@@ -668,7 +668,7 @@ export const programRunnersModule = defineToolModule({
                 "Invoke right after you generate BASIC source so it runs on the C64 without extra user steps.",
                 "Ensure the program includes line numbers and uppercase keywords before calling the tool.",
             ],
-            supportedPlatforms: ["c64u", "vice"],
+            supportedPlatforms: ["c64u", "u2", "vice"],
             async execute(args, ctx) {
                 return executeUploadRunBasic(args, ctx);
             },
@@ -693,7 +693,7 @@ export const programRunnersModule = defineToolModule({
                 "Use when the user requests to run new 6502 code; surface any assembler diagnostics in your reply.",
                 "Mention the entry routine or important addresses after execution so the user can continue debugging.",
             ],
-            supportedPlatforms: ["c64u", "vice"],
+            supportedPlatforms: ["c64u", "u2", "vice"],
             async execute(args, ctx) {
                 return executeUploadRunAsm(args, ctx);
             },
@@ -717,7 +717,7 @@ export const programRunnersModule = defineToolModule({
                 "Stage PRG files without running when the user wants to inspect memory first.",
                 "Confirm the Ultimate filesystem path (e.g. //USB0/demo.prg) is accessible before invoking.",
             ],
-            supportedPlatforms: ["c64u"],
+            supportedPlatforms: ["c64u", "u2"],
             async execute(args, ctx) {
                 return executeLoadPrg(args, ctx);
             },
@@ -733,7 +733,7 @@ export const programRunnersModule = defineToolModule({
                 "Call when the user provides a PRG path and expects immediate execution without compiling.",
                 "Mention that firmware issues a RUN so the user knows the machine state changed.",
             ],
-            supportedPlatforms: ["c64u", "vice"],
+            supportedPlatforms: ["c64u", "u2", "vice"],
             prerequisites: ["drives_list"],
             examples: [
                 {
@@ -765,7 +765,7 @@ export const programRunnersModule = defineToolModule({
                     arguments: { path: "//USB0/game.crt" },
                 },
             ],
-            supportedPlatforms: ["c64u"],
+            supportedPlatforms: ["c64u", "u2"],
             async execute(args, ctx) {
                 try {
                     const parsed = crtFileArgsSchema.parse(args ?? {});

package/dist/tools/rag.js

@@ -181,7 +181,7 @@ export const ragModule = defineToolModule({
     ],
     prompts: ["basic-program", "assembly-program"],
     defaultTags: ["rag", "search"],
-    supportedPlatforms: ["c64u", "vice"],
+    supportedPlatforms: ["c64u", "u2", "vice"],
     workflowHints: [
         "Call RAG tools when the user needs references or examples before generating new code.",
         "Summarise the number of refs returned and suggest follow-up actions like reading specific docs.",

package/dist/tools/registry/batch.js

@@ -35,7 +35,7 @@ const executeBatchArgsSchema = objectSchema({
 export const batchModuleGroup = defineToolModule({
     domain: "batch",
     summary: "Execute multiple tool calls in a single MCP request for reduced round-trip overhead.",
-    supportedPlatforms: ["c64u", "vice"],
+    supportedPlatforms: ["c64u", "u2", "vice"],
     resources: [],
     prompts: [],
     defaultTags: ["batch", "orchestration"],

package/dist/tools/registry/config.js

@@ -154,7 +154,7 @@ export const configModuleGroup = defineToolModule({
     resources: ["c64://guide/bootstrap", "c64://guide/index"],
     prompts: ["memory-debug"],
     defaultTags: ["config", "diagnostics"],
-    supportedPlatforms: ["c64u", "vice"],
+    supportedPlatforms: ["c64u", "u2", "vice"],
     workflowHints: [
         "List categories before changing values so users can confirm firmware-provided names.",
         "Mention when operations persist to flash or modify debug registers to highlight impacts.",
@@ -171,12 +171,12 @@ export const configModuleGroup = defineToolModule({
             }),
             tags: ["config", "diagnostics", "grouped"],
             operationPlatforms: {
-                load_flash: ["c64u"],
-                save_flash: ["c64u"],
-                reset_defaults: ["c64u"],
+                load_flash: ["c64u", "u2"],
+                save_flash: ["c64u", "u2"],
+                reset_defaults: ["c64u", "u2"],
                 read_debugreg: ["c64u"],
                 write_debugreg: ["c64u"],
-                shuffle: ["c64u"],
+                shuffle: ["c64u", "u2"],
             },
             operationToolNames: {
                 load_flash: "config_load_from_flash",

package/dist/tools/registry/disk.js

@@ -251,7 +251,7 @@ const diskOperationHandlers = createOperationHandlers(diskOperations);
 export const diskModuleGroup = defineToolModule({
     domain: "storage",
     summary: "Grouped disk image management, mounting, and discovery tools.",
-    supportedPlatforms: ["c64u", "vice"],
+    supportedPlatforms: ["c64u", "u2", "vice"],
     resources: ["c64://guide/bootstrap"],
     prompts: ["drive-management"],
     defaultTags: ["storage", "drive"],
@@ -269,7 +269,7 @@ export const diskModuleGroup = defineToolModule({
                 variants: diskOperations.map((operation) => operation.schema),
             }),
             tags: ["storage", "drive", "grouped"],
-            operationPlatforms: { file_info: ["c64u"], create_image: ["c64u"], find_and_run: ["c64u"] },
+            operationPlatforms: { file_info: ["c64u", "u2"], create_image: ["c64u", "u2"], find_and_run: ["c64u", "u2"] },
             operationToolNames: {
                 file_info: "file_info",
                 create_image: "create_image",

package/dist/tools/registry/drive.js

@@ -33,7 +33,7 @@ const driveOperationHandlers = createOperationHandlers(driveOperations);
 export const driveModuleGroup = defineToolModule({
     domain: "drive",
     summary: "Grouped drive power, reset, ROM, and mode helpers.",
-    supportedPlatforms: ["c64u", "vice"],
+    supportedPlatforms: ["c64u", "u2", "vice"],
     resources: ["c64://guide/bootstrap"],
     defaultTags: ["drive", "hardware"],
     workflowHints: [
@@ -50,7 +50,7 @@ export const driveModuleGroup = defineToolModule({
                 variants: driveOperations.map((operation) => operation.schema),
             }),
             tags: ["drive", "hardware", "grouped"],
-            operationPlatforms: { load_rom: ["c64u"] },
+            operationPlatforms: { load_rom: ["c64u", "u2"] },
             operationToolNames: { load_rom: "drive_load_rom" },
             examples: [
                 {

package/dist/tools/registry/graphics.js

@@ -89,7 +89,7 @@ function parseVicState(d011, d016, d018, dd00, d020, d021) {
     };
 }
 const getDisplayStateArgsSchema = objectSchema({
-    description: "Read VIC-II and CIA2 registers to determine the current graphics mode and memory layout. Works on C64U and VICE; both backends are read through shared memory primitives so the response shape is identical.",
+    description: "Read VIC-II and CIA2 registers to determine the current graphics mode and memory layout. The same shared-memory path is used on C64U/U64, U2-family hardware, and VICE, so the response shape is identical.",
     properties: {
         op: literalSchema("get_display_state"),
     },
@@ -212,7 +212,7 @@ export const graphicsModuleGroup = defineToolModule({
         "Use render helpers for PETSCII text, PETSCII art, sprites, and bitmaps; clarify whether PETSCII art executed or stayed a dry run.",
         "Mention sprite positions/colours so follow-up memory inspection stays grounded.",
     ],
-    supportedPlatforms: ["c64u", "vice"],
+    supportedPlatforms: ["c64u", "u2", "vice"],
     tools: [
         {
             name: "c64_graphics",

package/dist/tools/registry/memory.js

@@ -27,7 +27,7 @@ const memoryOperations = [
     },
     {
         op: "disassemble",
-        schema: extendSchemaWithOp("disassemble", disassembleArgsSchema.jsonSchema, { description: "Disassemble a memory region into annotated 6502/6510 instructions, including undocumented opcodes with canonical names. Symbol annotations from `.vs` files are applied when available. Works on both C64U and VICE." }),
+        schema: extendSchemaWithOp("disassemble", disassembleArgsSchema.jsonSchema, { description: "Disassemble a memory region into annotated 6502/6510 instructions, including undocumented opcodes with canonical names. Symbol annotations from `.vs` files are applied when available. Works on C64U/U64, U2-family hardware, and VICE." }),
         handler: groupedMemoryHandlers.disassemble,
     },
     {
@@ -60,7 +60,7 @@ const memoryOperationHandlers = createOperationHandlers(memoryOperations);
 export const memoryModuleGroup = defineToolModule({
     domain: "memory",
     summary: "Grouped memory, screen, and polling operations.",
-    supportedPlatforms: ["c64u", "vice"],
+    supportedPlatforms: ["c64u", "u2", "vice"],
     resources: ["c64://guide/bootstrap", "c64://basic/spec", "c64://assembly/6510-spec"],
     prompts: ["memory-debug", "basic-program", "assembly-program"],
     defaultTags: ["memory", "debug"],

package/dist/tools/registry/platform.js

@@ -50,7 +50,7 @@ const selectBackendSchema = operationSchema("select", {
     properties: {
         backend: {
             type: "string",
-            enum: ["c64u", "vice"],
+            enum: ["c64u", "u2", "vice"],
             description: "Backend to activate for subsequent tool calls.",
         },
     },
@@ -76,14 +76,16 @@ const platformOperationHandlers = {
         ctx.client.switchBackend(backend);
         ctx.setPlatform(backend);
         const { availableTools, unavailableTools } = describeTargetPlatform(backend);
-        const switchBackTarget = backend === "c64u" ? "vice" : "c64u";
+        const switchBackTarget = availableBackends.find((candidate) => candidate !== backend);
         const data = {
             success: true,
             activeBackend: backend,
             configuredBackends: availableBackends,
             availableTools,
             unavailableTools,
-            usageHint: `Use c64_select_backend again with backend: "${switchBackTarget}" to switch back.`,
+            usageHint: switchBackTarget
+                ? `Use c64_select_backend again with backend: "${switchBackTarget}" to switch back.`
+                : "No other backend is configured.",
         };
         return jsonResult(data, { success: true });
     },
@@ -91,7 +93,7 @@ const platformOperationHandlers = {
 export const platformModuleGroup = defineToolModule({
     domain: "platform",
     summary: "Runtime backend selection and platform-status coordination.",
-    supportedPlatforms: ["c64u", "vice"],
+    supportedPlatforms: ["c64u", "u2", "vice"],
     resources: ["c64://platform/status", "c64://guide/bootstrap"],
     prompts: [],
     defaultTags: ["platform", "backend", "grouped"],
@@ -101,7 +103,7 @@ export const platformModuleGroup = defineToolModule({
     tools: [
         {
             name: "c64_select_backend",
-            description: "Switch the active backend between C64U hardware and the VICE emulator at runtime.",
+            description: "Switch the active backend between C64U/U64 hardware, U2-family cartridges, and the VICE emulator at runtime.",
             summary: "Changes the active backend without restarting the MCP server and reports resulting tool availability.",
             inputSchema: discriminatedUnionSchema({
                 description: "Runtime backend selection operations.",

package/dist/tools/registry/program.js

@@ -12,7 +12,7 @@ const programOperations = [
     },
     {
         op: "run_prg",
-        schema: extendSchemaWithOp("run_prg", ensureDescriptor(programDescriptorIndex, "run_prg").inputSchema, { description: "Load and execute a PRG from Ultimate-visible storage on c64u or a host-local path on VICE." }),
+        schema: extendSchemaWithOp("run_prg", ensureDescriptor(programDescriptorIndex, "run_prg").inputSchema, { 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." }),
         handler: async (rawArgs, ctx) => invokeModuleTool(programRunnersModule, "run_prg", rawArgs, ctx),
     },
     {
@@ -55,10 +55,10 @@ export const programModule = defineToolModule({
     defaultTags: ["programs", "execution"],
     workflowHints: [
         "Choose BASIC or assembly uploaders based on the language you just generated for the user.",
-        "Prefer PRG or CRT runners when the user supplies a file path instead of source text; PRG paths are host-local on VICE and Ultimate-visible on c64u.",
-        "For a quick visible confirmation on VICE and/or C64U, prefer cross_platform_greeting instead of composing manual backend switches and BASIC upload steps.",
+        "Prefer PRG or CRT runners when the user supplies a file path instead of source text; PRG paths are host-local on VICE and Ultimate-visible on hardware.",
+        "For a quick visible confirmation on VICE, C64U/U64, or U2-family hardware, prefer cross_platform_greeting instead of composing manual backend switches and BASIC upload steps.",
     ],
-    supportedPlatforms: ["c64u", "vice"],
+    supportedPlatforms: ["c64u", "u2", "vice"],
     tools: [
         {
             name: "c64_program",
@@ -69,7 +69,7 @@ export const programModule = defineToolModule({
                 variants: programOperations.map((operation) => operation.schema),
             }),
             tags: ["programs", "execution", "grouped"],
-            operationPlatforms: { load_prg: ["c64u"], run_crt: ["c64u"], bundle_run: ["c64u"] },
+            operationPlatforms: { load_prg: ["c64u", "u2"], run_crt: ["c64u", "u2"], bundle_run: ["c64u", "u2"] },
             operationToolNames: {
                 load_prg: "load_prg",
                 run_crt: "run_crt",

package/dist/tools/registry/rag.js

@@ -25,7 +25,7 @@ export const ragModuleGroup = defineToolModule({
         "Use BASIC retrieval before synthesising new BASIC code and mention primary resources in responses.",
         "For assembly, note registers or addresses surfaced so the user can inspect them further.",
     ],
-    supportedPlatforms: ["c64u", "vice"],
+    supportedPlatforms: ["c64u", "u2", "vice"],
     tools: [
         {
             name: "c64_rag",

package/dist/tools/registry/sound.js

@@ -139,7 +139,7 @@ const soundOperationHandlers = createOperationHandlers(soundOperations);
 export const soundModuleGroup = defineToolModule({
     domain: "audio",
     summary: "Grouped SID control, playback, composition, and analysis operations.",
-    supportedPlatforms: ["c64u", "vice"],
+    supportedPlatforms: ["c64u", "u2", "vice"],
     resources: ["c64://sound/sid/spec", "c64://sound/sidwave/spec", "c64://sound/sid/file-format"],
     prompts: ["sid-music"],
     defaultTags: ["sid", "audio"],
@@ -159,9 +159,9 @@ export const soundModuleGroup = defineToolModule({
             tags: ["sid", "audio", "grouped"],
             operationPlatforms: {
                 capture_samples: ["c64u"],
-                play_sid_file: ["c64u"],
-                play_mod_file: ["c64u"],
-                pipeline: ["c64u"],
+                play_sid_file: ["c64u", "u2"],
+                play_mod_file: ["c64u", "u2"],
+                pipeline: ["c64u", "u2"],
                 analyze: ["c64u"],
                 record_analyze: ["c64u"],
             },

package/dist/tools/registry/system.js

@@ -30,11 +30,21 @@ const systemOperations = [
         schema: extendSchemaWithOp("poweroff", ensureDescriptor(machineDescriptorIndex, "poweroff").inputSchema, { description: "Request a controlled shutdown via the Ultimate firmware." }),
         handler: async (rawArgs, ctx) => invokeModuleTool(machineControlModule, "poweroff", rawArgs, ctx),
     },
+    {
+        op: "power_cycle",
+        schema: extendSchemaWithOp("power_cycle", ensureDescriptor(machineDescriptorIndex, "power_cycle").inputSchema, { 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." }),
+        handler: async (rawArgs, ctx) => invokeModuleTool(machineControlModule, "power_cycle", rawArgs, ctx),
+    },
     {
         op: "menu",
         schema: extendSchemaWithOp("menu", ensureDescriptor(machineDescriptorIndex, "menu_button").inputSchema, { description: "Toggle the Ultimate menu button for navigation." }),
         handler: async (rawArgs, ctx) => invokeModuleTool(machineControlModule, "menu_button", rawArgs, ctx),
     },
+    {
+        op: "read_menu_screen",
+        schema: extendSchemaWithOp("read_menu_screen", ensureDescriptor(machineDescriptorIndex, "read_menu_screen").inputSchema, { 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+)." }),
+        handler: async (rawArgs, ctx) => invokeModuleTool(machineControlModule, "read_menu_screen", rawArgs, ctx),
+    },
     {
         op: "start_task",
         schema: extendSchemaWithOp("start_task", ensureDescriptor(metaDescriptorIndex, "start_background_task").inputSchema, { description: "Start a named background task that runs on an interval." }),
@@ -65,7 +75,7 @@ const systemOperationHandlers = createOperationHandlers(systemOperations);
 export const systemModuleGroup = defineToolModule({
     domain: "system",
     summary: "Grouped machine control and background task orchestration.",
-    supportedPlatforms: ["c64u", "vice"],
+    supportedPlatforms: ["c64u", "u2", "vice"],
     resources: ["c64://guide/bootstrap"],
     prompts: ["memory-debug"],
     defaultTags: ["system", "control"],
@@ -83,8 +93,8 @@ export const systemModuleGroup = defineToolModule({
                 variants: systemOperations.map((operation) => operation.schema),
             }),
             tags: ["system", "control", "grouped"],
-            operationPlatforms: { pause: ["c64u"], resume: ["c64u"], menu: ["c64u"] },
-            operationToolNames: { pause: "pause", resume: "resume", menu: "menu_button" },
+            operationPlatforms: { pause: ["c64u", "u2"], resume: ["c64u", "u2"], menu: ["c64u", "u2"], read_menu_screen: ["c64u", "u2"] },
+            operationToolNames: { pause: "pause", resume: "resume", menu: "menu_button", read_menu_screen: "read_menu_screen" },
             examples: [
                 {
                     name: "Soft reset",

package/dist/tools/storage.js

@@ -143,7 +143,7 @@ const createDnpArgsSchema = objectSchema({
 export const storageModule = defineToolModule({
     domain: "storage",
     summary: "Drive management, disk image creation, and file inspection utilities.",
-    supportedPlatforms: ["c64u", "vice"],
+    supportedPlatforms: ["c64u", "u2", "vice"],
     resources: ["c64://guide/bootstrap"],
     prompts: ["memory-debug"],
     defaultTags: ["drive", "storage"],