c64-debug-mcp 0.1.10 → 1.0.1

package/README.md

@@ -91,6 +91,6 @@ AI assistant will:
 
 MIT - see [LICENSE](LICENSE) file
 
-**Made with ❤️ for retro computing enthusiasts and AI-assisted development**
+**Made with ❤️ for C64 developers and AI-assisted retro coding**
 
 *"The C64 never gets old, it just gets smarter" 🎮*

package/dist/http.cjs

@@ -1709,7 +1709,7 @@ var ViceSession = class {
     };
   }
   async readMemory(start, end, bank = 0) {
-    await this.#ensurePausedForDebug("memory_read");
+    await this.#ensureReady();
     this.#validateRange(start, end);
     const response = await this.#client.readMemory(start, end, bank);
     return {
@@ -3262,14 +3262,14 @@ var getMonitorStateTool = createViceTool({
 });
 var getSessionStateTool = createViceTool({
   id: "get_session_state",
-  description: "Returns richer emulator session state including transport/process status, auto-resume state, and the most recent hit checkpoint when known.",
+  description: "Returns emulator session state including transport/process status, auto-resume state, and the most recent hit checkpoint.",
   inputSchema: noInputSchema,
   dataSchema: sessionStateResultSchema,
   execute: async () => c64Session.snapshot()
 });
 var getRegistersTool = createViceTool({
   id: "get_registers",
-  description: "Returns the current C64 register snapshot. This requires the emulator to already be stopped.",
+  description: 'Returns the current C64 register snapshot. Requires emulator to be stopped - call execute(action="pause") first if running.',
   inputSchema: noInputSchema,
   dataSchema: import_zod4.z.object({
     registers: c64RegisterValueSchema
@@ -3278,7 +3278,7 @@ var getRegistersTool = createViceTool({
 });
 var setRegistersTool = createViceTool({
   id: "set_registers",
-  description: "Sets one or more C64 registers by field name.",
+  description: 'Sets one or more C64 registers by field name. Requires emulator to be stopped - call execute(action="pause") first if running.',
   inputSchema: import_zod4.z.object({
     registers: c64PartialRegisterValueSchema
   }),
@@ -3314,7 +3314,7 @@ var readMemoryTool = createViceTool({
 });
 var writeMemoryTool = createViceTool({
   id: "memory_write",
-  description: "Writes raw byte values into the active C64 memory space.",
+  description: 'Writes raw byte values into the active C64 memory space. Requires emulator to be stopped - call execute(action="pause") first if running.',
   inputSchema: import_zod4.z.object({
     address: address16Schema.describe("Start address in the 16-bit C64 address space"),
     data: byteArraySchema.min(1).describe("Raw bytes to write into memory")
@@ -3430,7 +3430,7 @@ var programLoadTool = createViceTool({
 });
 var captureDisplayTool = createViceTool({
   id: "capture_display",
-  description: "Captures the current screen to a PNG file and returns the saved image path. If the emulator was running, the server restores running state before returning, subject to timeout.",
+  description: "Captures the current screen to a PNG file and returns the saved image path.",
   inputSchema: import_zod4.z.object({
     useVic: import_zod4.z.boolean().default(true).describe("Whether to capture the VIC-II display when supported")
   }),
@@ -3439,21 +3439,21 @@ var captureDisplayTool = createViceTool({
 });
 var getDisplayStateTool = createViceTool({
   id: "get_display_state",
-  description: "Returns screen RAM, color RAM, the current graphics mode, screen memory addresses, and the current border and background colors. If the emulator was running, the server restores running state before returning, subject to timeout.",
+  description: "Returns screen RAM, color RAM, the current graphics mode, screen memory addresses, and the current border and background colors.",
   inputSchema: noInputSchema,
   dataSchema: displayStateResultSchema,
   execute: async () => await c64Session.getDisplayState()
 });
 var getDisplayTextTool = createViceTool({
   id: "get_display_text",
-  description: "Returns the current text screen as readable text when the C64 is in a text mode. If the emulator was running, the server restores running state before returning, subject to timeout.",
+  description: "Returns the current text screen as readable text when the C64 is in a text mode.",
   inputSchema: noInputSchema,
   dataSchema: displayTextResultSchema,
   execute: async () => await c64Session.getDisplayText()
 });
 var writeTextTool = createViceTool({
   id: "write_text",
-  description: "Types text into the C64 while it is running. Supports escaped characters and PETSCII brace tokens like {RETURN}, {CLR}, {HOME}, {PI}, and color names; limit each request to 64 bytes.",
+  description: 'Types text into the C64. Requires emulator to be running - call execute(action="resume") first if stopped. Supports escaped characters and PETSCII brace tokens like {RETURN}, {CLR}, {HOME}, {PI}, and color names. Limit 64 bytes per request.',
   inputSchema: import_zod4.z.object({
     text: import_zod4.z.string()
   }),
@@ -3465,7 +3465,7 @@ var writeTextTool = createViceTool({
 });
 var keyboardInputTool = createViceTool({
   id: "keyboard_input",
-  description: "Sends one to four keys or PETSCII tokens to the C64 while it is running. Use this for key presses, releases, and taps. If the emulator transiently stops, the server restores running state before returning, subject to timeout.",
+  description: 'Sends one to four keys or PETSCII tokens to the C64. Requires emulator to be running - call execute(action="resume") first if stopped. Use for key presses, releases, and taps.',
   inputSchema: import_zod4.z.object({
     action: inputActionSchema.describe("Use tap for a single key event or press/release for repeated buffered input"),
     keys: import_zod4.z.array(import_zod4.z.string().min(1)).min(1).max(4).describe("One to four literal keys or PETSCII token names such as RETURN, CLR, HOME, PI, LEFT, RED, or F1"),
@@ -3476,7 +3476,7 @@ var keyboardInputTool = createViceTool({
 });
 var joystickInputTool = createViceTool({
   id: "joystick_input",
-  description: "Sends joystick input to C64 joystick port 1 or 2 while the C64 is running. If the emulator transiently stops, the server restores running state before returning, subject to timeout.",
+  description: 'Sends joystick input to C64 joystick port 1 or 2. Requires emulator to be running - call execute(action="resume") first if stopped.',
   inputSchema: import_zod4.z.object({
     port: joystickPortSchema.describe("Joystick port number"),
     action: inputActionSchema.describe("Joystick action to apply"),

package/dist/http.js

@@ -1686,7 +1686,7 @@ var ViceSession = class {
     };
   }
   async readMemory(start, end, bank = 0) {
-    await this.#ensurePausedForDebug("memory_read");
+    await this.#ensureReady();
     this.#validateRange(start, end);
     const response = await this.#client.readMemory(start, end, bank);
     return {
@@ -3239,14 +3239,14 @@ var getMonitorStateTool = createViceTool({
 });
 var getSessionStateTool = createViceTool({
   id: "get_session_state",
-  description: "Returns richer emulator session state including transport/process status, auto-resume state, and the most recent hit checkpoint when known.",
+  description: "Returns emulator session state including transport/process status, auto-resume state, and the most recent hit checkpoint.",
   inputSchema: noInputSchema,
   dataSchema: sessionStateResultSchema,
   execute: async () => c64Session.snapshot()
 });
 var getRegistersTool = createViceTool({
   id: "get_registers",
-  description: "Returns the current C64 register snapshot. This requires the emulator to already be stopped.",
+  description: 'Returns the current C64 register snapshot. Requires emulator to be stopped - call execute(action="pause") first if running.',
   inputSchema: noInputSchema,
   dataSchema: z3.object({
     registers: c64RegisterValueSchema
@@ -3255,7 +3255,7 @@ var getRegistersTool = createViceTool({
 });
 var setRegistersTool = createViceTool({
   id: "set_registers",
-  description: "Sets one or more C64 registers by field name.",
+  description: 'Sets one or more C64 registers by field name. Requires emulator to be stopped - call execute(action="pause") first if running.',
   inputSchema: z3.object({
     registers: c64PartialRegisterValueSchema
   }),
@@ -3291,7 +3291,7 @@ var readMemoryTool = createViceTool({
 });
 var writeMemoryTool = createViceTool({
   id: "memory_write",
-  description: "Writes raw byte values into the active C64 memory space.",
+  description: 'Writes raw byte values into the active C64 memory space. Requires emulator to be stopped - call execute(action="pause") first if running.',
   inputSchema: z3.object({
     address: address16Schema.describe("Start address in the 16-bit C64 address space"),
     data: byteArraySchema.min(1).describe("Raw bytes to write into memory")
@@ -3407,7 +3407,7 @@ var programLoadTool = createViceTool({
 });
 var captureDisplayTool = createViceTool({
   id: "capture_display",
-  description: "Captures the current screen to a PNG file and returns the saved image path. If the emulator was running, the server restores running state before returning, subject to timeout.",
+  description: "Captures the current screen to a PNG file and returns the saved image path.",
   inputSchema: z3.object({
     useVic: z3.boolean().default(true).describe("Whether to capture the VIC-II display when supported")
   }),
@@ -3416,21 +3416,21 @@ var captureDisplayTool = createViceTool({
 });
 var getDisplayStateTool = createViceTool({
   id: "get_display_state",
-  description: "Returns screen RAM, color RAM, the current graphics mode, screen memory addresses, and the current border and background colors. If the emulator was running, the server restores running state before returning, subject to timeout.",
+  description: "Returns screen RAM, color RAM, the current graphics mode, screen memory addresses, and the current border and background colors.",
   inputSchema: noInputSchema,
   dataSchema: displayStateResultSchema,
   execute: async () => await c64Session.getDisplayState()
 });
 var getDisplayTextTool = createViceTool({
   id: "get_display_text",
-  description: "Returns the current text screen as readable text when the C64 is in a text mode. If the emulator was running, the server restores running state before returning, subject to timeout.",
+  description: "Returns the current text screen as readable text when the C64 is in a text mode.",
   inputSchema: noInputSchema,
   dataSchema: displayTextResultSchema,
   execute: async () => await c64Session.getDisplayText()
 });
 var writeTextTool = createViceTool({
   id: "write_text",
-  description: "Types text into the C64 while it is running. Supports escaped characters and PETSCII brace tokens like {RETURN}, {CLR}, {HOME}, {PI}, and color names; limit each request to 64 bytes.",
+  description: 'Types text into the C64. Requires emulator to be running - call execute(action="resume") first if stopped. Supports escaped characters and PETSCII brace tokens like {RETURN}, {CLR}, {HOME}, {PI}, and color names. Limit 64 bytes per request.',
   inputSchema: z3.object({
     text: z3.string()
   }),
@@ -3442,7 +3442,7 @@ var writeTextTool = createViceTool({
 });
 var keyboardInputTool = createViceTool({
   id: "keyboard_input",
-  description: "Sends one to four keys or PETSCII tokens to the C64 while it is running. Use this for key presses, releases, and taps. If the emulator transiently stops, the server restores running state before returning, subject to timeout.",
+  description: 'Sends one to four keys or PETSCII tokens to the C64. Requires emulator to be running - call execute(action="resume") first if stopped. Use for key presses, releases, and taps.',
   inputSchema: z3.object({
     action: inputActionSchema.describe("Use tap for a single key event or press/release for repeated buffered input"),
     keys: z3.array(z3.string().min(1)).min(1).max(4).describe("One to four literal keys or PETSCII token names such as RETURN, CLR, HOME, PI, LEFT, RED, or F1"),
@@ -3453,7 +3453,7 @@ var keyboardInputTool = createViceTool({
 });
 var joystickInputTool = createViceTool({
   id: "joystick_input",
-  description: "Sends joystick input to C64 joystick port 1 or 2 while the C64 is running. If the emulator transiently stops, the server restores running state before returning, subject to timeout.",
+  description: 'Sends joystick input to C64 joystick port 1 or 2. Requires emulator to be running - call execute(action="resume") first if stopped.',
   inputSchema: z3.object({
     port: joystickPortSchema.describe("Joystick port number"),
     action: inputActionSchema.describe("Joystick action to apply"),

package/dist/stdio.cjs

@@ -1706,7 +1706,7 @@ var ViceSession = class {
     };
   }
   async readMemory(start, end, bank = 0) {
-    await this.#ensurePausedForDebug("memory_read");
+    await this.#ensureReady();
     this.#validateRange(start, end);
     const response = await this.#client.readMemory(start, end, bank);
     return {
@@ -3259,14 +3259,14 @@ var getMonitorStateTool = createViceTool({
 });
 var getSessionStateTool = createViceTool({
   id: "get_session_state",
-  description: "Returns richer emulator session state including transport/process status, auto-resume state, and the most recent hit checkpoint when known.",
+  description: "Returns emulator session state including transport/process status, auto-resume state, and the most recent hit checkpoint.",
   inputSchema: noInputSchema,
   dataSchema: sessionStateResultSchema,
   execute: async () => c64Session.snapshot()
 });
 var getRegistersTool = createViceTool({
   id: "get_registers",
-  description: "Returns the current C64 register snapshot. This requires the emulator to already be stopped.",
+  description: 'Returns the current C64 register snapshot. Requires emulator to be stopped - call execute(action="pause") first if running.',
   inputSchema: noInputSchema,
   dataSchema: import_zod4.z.object({
     registers: c64RegisterValueSchema
@@ -3275,7 +3275,7 @@ var getRegistersTool = createViceTool({
 });
 var setRegistersTool = createViceTool({
   id: "set_registers",
-  description: "Sets one or more C64 registers by field name.",
+  description: 'Sets one or more C64 registers by field name. Requires emulator to be stopped - call execute(action="pause") first if running.',
   inputSchema: import_zod4.z.object({
     registers: c64PartialRegisterValueSchema
   }),
@@ -3311,7 +3311,7 @@ var readMemoryTool = createViceTool({
 });
 var writeMemoryTool = createViceTool({
   id: "memory_write",
-  description: "Writes raw byte values into the active C64 memory space.",
+  description: 'Writes raw byte values into the active C64 memory space. Requires emulator to be stopped - call execute(action="pause") first if running.',
   inputSchema: import_zod4.z.object({
     address: address16Schema.describe("Start address in the 16-bit C64 address space"),
     data: byteArraySchema.min(1).describe("Raw bytes to write into memory")
@@ -3427,7 +3427,7 @@ var programLoadTool = createViceTool({
 });
 var captureDisplayTool = createViceTool({
   id: "capture_display",
-  description: "Captures the current screen to a PNG file and returns the saved image path. If the emulator was running, the server restores running state before returning, subject to timeout.",
+  description: "Captures the current screen to a PNG file and returns the saved image path.",
   inputSchema: import_zod4.z.object({
     useVic: import_zod4.z.boolean().default(true).describe("Whether to capture the VIC-II display when supported")
   }),
@@ -3436,21 +3436,21 @@ var captureDisplayTool = createViceTool({
 });
 var getDisplayStateTool = createViceTool({
   id: "get_display_state",
-  description: "Returns screen RAM, color RAM, the current graphics mode, screen memory addresses, and the current border and background colors. If the emulator was running, the server restores running state before returning, subject to timeout.",
+  description: "Returns screen RAM, color RAM, the current graphics mode, screen memory addresses, and the current border and background colors.",
   inputSchema: noInputSchema,
   dataSchema: displayStateResultSchema,
   execute: async () => await c64Session.getDisplayState()
 });
 var getDisplayTextTool = createViceTool({
   id: "get_display_text",
-  description: "Returns the current text screen as readable text when the C64 is in a text mode. If the emulator was running, the server restores running state before returning, subject to timeout.",
+  description: "Returns the current text screen as readable text when the C64 is in a text mode.",
   inputSchema: noInputSchema,
   dataSchema: displayTextResultSchema,
   execute: async () => await c64Session.getDisplayText()
 });
 var writeTextTool = createViceTool({
   id: "write_text",
-  description: "Types text into the C64 while it is running. Supports escaped characters and PETSCII brace tokens like {RETURN}, {CLR}, {HOME}, {PI}, and color names; limit each request to 64 bytes.",
+  description: 'Types text into the C64. Requires emulator to be running - call execute(action="resume") first if stopped. Supports escaped characters and PETSCII brace tokens like {RETURN}, {CLR}, {HOME}, {PI}, and color names. Limit 64 bytes per request.',
   inputSchema: import_zod4.z.object({
     text: import_zod4.z.string()
   }),
@@ -3462,7 +3462,7 @@ var writeTextTool = createViceTool({
 });
 var keyboardInputTool = createViceTool({
   id: "keyboard_input",
-  description: "Sends one to four keys or PETSCII tokens to the C64 while it is running. Use this for key presses, releases, and taps. If the emulator transiently stops, the server restores running state before returning, subject to timeout.",
+  description: 'Sends one to four keys or PETSCII tokens to the C64. Requires emulator to be running - call execute(action="resume") first if stopped. Use for key presses, releases, and taps.',
   inputSchema: import_zod4.z.object({
     action: inputActionSchema.describe("Use tap for a single key event or press/release for repeated buffered input"),
     keys: import_zod4.z.array(import_zod4.z.string().min(1)).min(1).max(4).describe("One to four literal keys or PETSCII token names such as RETURN, CLR, HOME, PI, LEFT, RED, or F1"),
@@ -3473,7 +3473,7 @@ var keyboardInputTool = createViceTool({
 });
 var joystickInputTool = createViceTool({
   id: "joystick_input",
-  description: "Sends joystick input to C64 joystick port 1 or 2 while the C64 is running. If the emulator transiently stops, the server restores running state before returning, subject to timeout.",
+  description: 'Sends joystick input to C64 joystick port 1 or 2. Requires emulator to be running - call execute(action="resume") first if stopped.',
   inputSchema: import_zod4.z.object({
     port: joystickPortSchema.describe("Joystick port number"),
     action: inputActionSchema.describe("Joystick action to apply"),

package/dist/stdio.js

@@ -1683,7 +1683,7 @@ var ViceSession = class {
     };
   }
   async readMemory(start, end, bank = 0) {
-    await this.#ensurePausedForDebug("memory_read");
+    await this.#ensureReady();
     this.#validateRange(start, end);
     const response = await this.#client.readMemory(start, end, bank);
     return {
@@ -3236,14 +3236,14 @@ var getMonitorStateTool = createViceTool({
 });
 var getSessionStateTool = createViceTool({
   id: "get_session_state",
-  description: "Returns richer emulator session state including transport/process status, auto-resume state, and the most recent hit checkpoint when known.",
+  description: "Returns emulator session state including transport/process status, auto-resume state, and the most recent hit checkpoint.",
   inputSchema: noInputSchema,
   dataSchema: sessionStateResultSchema,
   execute: async () => c64Session.snapshot()
 });
 var getRegistersTool = createViceTool({
   id: "get_registers",
-  description: "Returns the current C64 register snapshot. This requires the emulator to already be stopped.",
+  description: 'Returns the current C64 register snapshot. Requires emulator to be stopped - call execute(action="pause") first if running.',
   inputSchema: noInputSchema,
   dataSchema: z3.object({
     registers: c64RegisterValueSchema
@@ -3252,7 +3252,7 @@ var getRegistersTool = createViceTool({
 });
 var setRegistersTool = createViceTool({
   id: "set_registers",
-  description: "Sets one or more C64 registers by field name.",
+  description: 'Sets one or more C64 registers by field name. Requires emulator to be stopped - call execute(action="pause") first if running.',
   inputSchema: z3.object({
     registers: c64PartialRegisterValueSchema
   }),
@@ -3288,7 +3288,7 @@ var readMemoryTool = createViceTool({
 });
 var writeMemoryTool = createViceTool({
   id: "memory_write",
-  description: "Writes raw byte values into the active C64 memory space.",
+  description: 'Writes raw byte values into the active C64 memory space. Requires emulator to be stopped - call execute(action="pause") first if running.',
   inputSchema: z3.object({
     address: address16Schema.describe("Start address in the 16-bit C64 address space"),
     data: byteArraySchema.min(1).describe("Raw bytes to write into memory")
@@ -3404,7 +3404,7 @@ var programLoadTool = createViceTool({
 });
 var captureDisplayTool = createViceTool({
   id: "capture_display",
-  description: "Captures the current screen to a PNG file and returns the saved image path. If the emulator was running, the server restores running state before returning, subject to timeout.",
+  description: "Captures the current screen to a PNG file and returns the saved image path.",
   inputSchema: z3.object({
     useVic: z3.boolean().default(true).describe("Whether to capture the VIC-II display when supported")
   }),
@@ -3413,21 +3413,21 @@ var captureDisplayTool = createViceTool({
 });
 var getDisplayStateTool = createViceTool({
   id: "get_display_state",
-  description: "Returns screen RAM, color RAM, the current graphics mode, screen memory addresses, and the current border and background colors. If the emulator was running, the server restores running state before returning, subject to timeout.",
+  description: "Returns screen RAM, color RAM, the current graphics mode, screen memory addresses, and the current border and background colors.",
   inputSchema: noInputSchema,
   dataSchema: displayStateResultSchema,
   execute: async () => await c64Session.getDisplayState()
 });
 var getDisplayTextTool = createViceTool({
   id: "get_display_text",
-  description: "Returns the current text screen as readable text when the C64 is in a text mode. If the emulator was running, the server restores running state before returning, subject to timeout.",
+  description: "Returns the current text screen as readable text when the C64 is in a text mode.",
   inputSchema: noInputSchema,
   dataSchema: displayTextResultSchema,
   execute: async () => await c64Session.getDisplayText()
 });
 var writeTextTool = createViceTool({
   id: "write_text",
-  description: "Types text into the C64 while it is running. Supports escaped characters and PETSCII brace tokens like {RETURN}, {CLR}, {HOME}, {PI}, and color names; limit each request to 64 bytes.",
+  description: 'Types text into the C64. Requires emulator to be running - call execute(action="resume") first if stopped. Supports escaped characters and PETSCII brace tokens like {RETURN}, {CLR}, {HOME}, {PI}, and color names. Limit 64 bytes per request.',
   inputSchema: z3.object({
     text: z3.string()
   }),
@@ -3439,7 +3439,7 @@ var writeTextTool = createViceTool({
 });
 var keyboardInputTool = createViceTool({
   id: "keyboard_input",
-  description: "Sends one to four keys or PETSCII tokens to the C64 while it is running. Use this for key presses, releases, and taps. If the emulator transiently stops, the server restores running state before returning, subject to timeout.",
+  description: 'Sends one to four keys or PETSCII tokens to the C64. Requires emulator to be running - call execute(action="resume") first if stopped. Use for key presses, releases, and taps.',
   inputSchema: z3.object({
     action: inputActionSchema.describe("Use tap for a single key event or press/release for repeated buffered input"),
     keys: z3.array(z3.string().min(1)).min(1).max(4).describe("One to four literal keys or PETSCII token names such as RETURN, CLR, HOME, PI, LEFT, RED, or F1"),
@@ -3450,7 +3450,7 @@ var keyboardInputTool = createViceTool({
 });
 var joystickInputTool = createViceTool({
   id: "joystick_input",
-  description: "Sends joystick input to C64 joystick port 1 or 2 while the C64 is running. If the emulator transiently stops, the server restores running state before returning, subject to timeout.",
+  description: 'Sends joystick input to C64 joystick port 1 or 2. Requires emulator to be running - call execute(action="resume") first if stopped.',
   inputSchema: z3.object({
     port: joystickPortSchema.describe("Joystick port number"),
     action: inputActionSchema.describe("Joystick action to apply"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "c64-debug-mcp",
-  "version": "0.1.10",
+  "version": "1.0.1",
   "description": "Model Context Protocol server for C64 debugging via VICE emulator",
   "type": "module",
   "keywords": [