c64-debug-mcp 1.0.13 → 1.0.14

package/dist/http.cjs

@@ -66,7 +66,7 @@ var stopReasonSchema = import_zod.z.enum([
 ]);
 var sessionHealthSchema = import_zod.z.enum(["not_configured", "starting", "ready", "recovering", "stopped", "error"]);
 var breakpointKindSchema = import_zod.z.enum(["exec", "read", "write", "read_write"]);
-var resetModeSchema = import_zod.z.enum(["soft", "hard"]);
+var resetModeSchema = import_zod.z.enum(["soft", "hard", "nuclear"]);
 var inputActionSchema = import_zod.z.enum(["press", "release", "tap"]);
 var joystickControlSchema = import_zod.z.enum(["up", "down", "left", "right", "fire"]);
 var joystickPortSchema = import_zod.z.union([import_zod.z.literal(1), import_zod.z.literal(2)]);
@@ -1728,7 +1728,17 @@ var ViceSession = class {
       }
       this.#syncMonitorRuntimeState();
       if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
-        void this.#scheduleRecovery();
+        void this.#scheduleRecovery().catch((error) => {
+          this.#writeProcessLogLine(`[recovery-error] ${error instanceof Error ? error.message : String(error)}`);
+        });
+      }
+    });
+    this.#client.on("transport-error", (error) => {
+      this.#writeProcessLogLine(`[monitor-error] transport error: ${error.message}`);
+      if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
+        void this.#scheduleRecovery().catch((recoveryError) => {
+          this.#writeProcessLogLine(`[recovery-error] ${recoveryError instanceof Error ? recoveryError.message : String(recoveryError)}`);
+        });
       }
     });
     this.#client.on("event", (event) => {
@@ -2069,6 +2079,10 @@ var ViceSession = class {
   async resetMachine(mode) {
     return this.#withExecutionLock(async () => {
       await this.#ensureReady();
+      this.#clearHeldInputState();
+      if (mode === "nuclear") {
+        return await this.#performNuclearReset();
+      }
       const wasPaused = this.#explicitPauseActive;
       this.#lastExecutionIntent = "reset";
       this.#writeProcessLogLine(`[tx] execute reset mode=${mode}`);
@@ -2088,6 +2102,67 @@ var ViceSession = class {
       };
     });
   }
+  async #performNuclearReset() {
+    const savedBreakpoints = await this.#captureBreakpointState();
+    const wasPaused = this.#explicitPauseActive;
+    this.#writeProcessLogLine("[nuclear-reset] initiating full VICE process restart");
+    await this.#scheduleRecovery();
+    await this.#restoreBreakpointState(savedBreakpoints);
+    this.#explicitPauseActive = wasPaused;
+    if (wasPaused) {
+      this.#writeProcessLogLine("[nuclear-reset] restoring paused state");
+      await this.pauseExecution();
+    }
+    this.#writeProcessLogLine("[nuclear-reset] completed successfully");
+    const debugState = await this.#readDebugState();
+    return {
+      executionState: debugState.executionState,
+      lastStopReason: debugState.lastStopReason,
+      programCounter: debugState.programCounter,
+      registers: debugState.registers,
+      warnings: []
+    };
+  }
+  async #captureBreakpointState() {
+    try {
+      const result = await this.listBreakpoints(true);
+      return result.breakpoints.map((bp) => ({
+        kind: bp.kind,
+        start: bp.start,
+        end: bp.end,
+        enabled: bp.enabled,
+        temporary: bp.temporary,
+        hasCondition: bp.hasCondition,
+        label: this.#breakpointLabels.get(bp.id) ?? null
+      }));
+    } catch (error) {
+      this.#writeProcessLogLine(`[nuclear-reset] failed to capture breakpoints: ${error instanceof Error ? error.message : String(error)}`);
+      return [];
+    }
+  }
+  async #restoreBreakpointState(savedBreakpoints) {
+    if (savedBreakpoints.length === 0) {
+      return;
+    }
+    this.#writeProcessLogLine(`[nuclear-reset] restoring ${savedBreakpoints.length} breakpoints`);
+    for (const bp of savedBreakpoints) {
+      try {
+        await this.breakpointSet({
+          kind: bp.kind,
+          address: bp.start,
+          length: bp.end - bp.start + 1,
+          enabled: bp.enabled,
+          temporary: bp.temporary,
+          label: bp.label ?? void 0
+        });
+        this.#writeProcessLogLine(`[nuclear-reset] restored breakpoint at $${bp.start.toString(16).toUpperCase()}`);
+      } catch (error) {
+        this.#writeProcessLogLine(
+          `[nuclear-reset] failed to restore breakpoint at $${bp.start.toString(16).toUpperCase()}: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  }
   async listBreakpoints(includeDisabled = true) {
     await this.#ensureReady();
     this.#writeProcessLogLine(`[tx] breakpoint_list includeDisabled=${includeDisabled}`);
@@ -2802,7 +2877,9 @@ var ViceSession = class {
         makeWarning(`C64 emulator process exited (${code ?? "null"} / ${signal ?? "null"})`, "process_exit")
       ];
       if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
-        void this.#scheduleRecovery();
+        void this.#scheduleRecovery().catch((error) => {
+          this.#writeProcessLogLine(`[recovery-error] ${error instanceof Error ? error.message : String(error)}`);
+        });
       }
     });
     child.once("error", (error) => {
@@ -2815,12 +2892,16 @@ var ViceSession = class {
       this.#transportState = "faulted";
       this.#warnings = [...this.#warnings.filter((warning) => warning.code !== "process_error"), makeWarning(error.message, "process_error")];
       if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
-        void this.#scheduleRecovery();
+        void this.#scheduleRecovery().catch((error2) => {
+          this.#writeProcessLogLine(`[recovery-error] ${error2 instanceof Error ? error2.message : String(error2)}`);
+        });
       }
     });
   }
   #attachProcessLogging(child, binary, args) {
     const logStream = (0, import_node_fs.createWriteStream)(VICE_PROCESS_LOG_PATH, { flags: "a" });
+    logStream.on("error", () => {
+    });
     this.#processLogStream = logStream;
     this.#stdoutMirrorBuffer = "";
     this.#stderrMirrorBuffer = "";
@@ -2854,7 +2935,10 @@ var ViceSession = class {
     logStream.write(`
 === Emulator stream closed ${nowIso()} (${reason}) ===
 `);
-    logStream.end();
+    logStream.end(() => {
+    });
+    logStream.on("error", () => {
+    });
     this.#processLogStream = null;
   }
   #mirrorViceOutputChunk(stream, chunk) {
@@ -3697,7 +3781,7 @@ var executeTool = createViceTool({
   inputSchema: import_zod4.z.object({
     action: import_zod4.z.enum(["pause", "resume", "step", "step_over", "step_out", "reset"]),
     count: import_zod4.z.number().int().positive().default(1).describe("Instruction count for step and step_over actions"),
-    resetMode: resetModeSchema.default("soft").describe("Reset mode when action is reset"),
+    resetMode: resetModeSchema.default("soft").describe("Reset mode: soft (CPU reset), hard (full machine reset), or nuclear (complete VICE restart)"),
     waitUntilRunningStable: import_zod4.z.boolean().default(false).describe("When action is resume, wait until running becomes stable before returning")
   }),
   dataSchema: debugStateSchema.extend({

package/dist/http.js

@@ -43,7 +43,7 @@ var stopReasonSchema = z.enum([
 ]);
 var sessionHealthSchema = z.enum(["not_configured", "starting", "ready", "recovering", "stopped", "error"]);
 var breakpointKindSchema = z.enum(["exec", "read", "write", "read_write"]);
-var resetModeSchema = z.enum(["soft", "hard"]);
+var resetModeSchema = z.enum(["soft", "hard", "nuclear"]);
 var inputActionSchema = z.enum(["press", "release", "tap"]);
 var joystickControlSchema = z.enum(["up", "down", "left", "right", "fire"]);
 var joystickPortSchema = z.union([z.literal(1), z.literal(2)]);
@@ -1705,7 +1705,17 @@ var ViceSession = class {
       }
       this.#syncMonitorRuntimeState();
       if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
-        void this.#scheduleRecovery();
+        void this.#scheduleRecovery().catch((error) => {
+          this.#writeProcessLogLine(`[recovery-error] ${error instanceof Error ? error.message : String(error)}`);
+        });
+      }
+    });
+    this.#client.on("transport-error", (error) => {
+      this.#writeProcessLogLine(`[monitor-error] transport error: ${error.message}`);
+      if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
+        void this.#scheduleRecovery().catch((recoveryError) => {
+          this.#writeProcessLogLine(`[recovery-error] ${recoveryError instanceof Error ? recoveryError.message : String(recoveryError)}`);
+        });
       }
     });
     this.#client.on("event", (event) => {
@@ -2046,6 +2056,10 @@ var ViceSession = class {
   async resetMachine(mode) {
     return this.#withExecutionLock(async () => {
       await this.#ensureReady();
+      this.#clearHeldInputState();
+      if (mode === "nuclear") {
+        return await this.#performNuclearReset();
+      }
       const wasPaused = this.#explicitPauseActive;
       this.#lastExecutionIntent = "reset";
       this.#writeProcessLogLine(`[tx] execute reset mode=${mode}`);
@@ -2065,6 +2079,67 @@ var ViceSession = class {
       };
     });
   }
+  async #performNuclearReset() {
+    const savedBreakpoints = await this.#captureBreakpointState();
+    const wasPaused = this.#explicitPauseActive;
+    this.#writeProcessLogLine("[nuclear-reset] initiating full VICE process restart");
+    await this.#scheduleRecovery();
+    await this.#restoreBreakpointState(savedBreakpoints);
+    this.#explicitPauseActive = wasPaused;
+    if (wasPaused) {
+      this.#writeProcessLogLine("[nuclear-reset] restoring paused state");
+      await this.pauseExecution();
+    }
+    this.#writeProcessLogLine("[nuclear-reset] completed successfully");
+    const debugState = await this.#readDebugState();
+    return {
+      executionState: debugState.executionState,
+      lastStopReason: debugState.lastStopReason,
+      programCounter: debugState.programCounter,
+      registers: debugState.registers,
+      warnings: []
+    };
+  }
+  async #captureBreakpointState() {
+    try {
+      const result = await this.listBreakpoints(true);
+      return result.breakpoints.map((bp) => ({
+        kind: bp.kind,
+        start: bp.start,
+        end: bp.end,
+        enabled: bp.enabled,
+        temporary: bp.temporary,
+        hasCondition: bp.hasCondition,
+        label: this.#breakpointLabels.get(bp.id) ?? null
+      }));
+    } catch (error) {
+      this.#writeProcessLogLine(`[nuclear-reset] failed to capture breakpoints: ${error instanceof Error ? error.message : String(error)}`);
+      return [];
+    }
+  }
+  async #restoreBreakpointState(savedBreakpoints) {
+    if (savedBreakpoints.length === 0) {
+      return;
+    }
+    this.#writeProcessLogLine(`[nuclear-reset] restoring ${savedBreakpoints.length} breakpoints`);
+    for (const bp of savedBreakpoints) {
+      try {
+        await this.breakpointSet({
+          kind: bp.kind,
+          address: bp.start,
+          length: bp.end - bp.start + 1,
+          enabled: bp.enabled,
+          temporary: bp.temporary,
+          label: bp.label ?? void 0
+        });
+        this.#writeProcessLogLine(`[nuclear-reset] restored breakpoint at $${bp.start.toString(16).toUpperCase()}`);
+      } catch (error) {
+        this.#writeProcessLogLine(
+          `[nuclear-reset] failed to restore breakpoint at $${bp.start.toString(16).toUpperCase()}: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  }
   async listBreakpoints(includeDisabled = true) {
     await this.#ensureReady();
     this.#writeProcessLogLine(`[tx] breakpoint_list includeDisabled=${includeDisabled}`);
@@ -2779,7 +2854,9 @@ var ViceSession = class {
         makeWarning(`C64 emulator process exited (${code ?? "null"} / ${signal ?? "null"})`, "process_exit")
       ];
       if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
-        void this.#scheduleRecovery();
+        void this.#scheduleRecovery().catch((error) => {
+          this.#writeProcessLogLine(`[recovery-error] ${error instanceof Error ? error.message : String(error)}`);
+        });
       }
     });
     child.once("error", (error) => {
@@ -2792,12 +2869,16 @@ var ViceSession = class {
       this.#transportState = "faulted";
       this.#warnings = [...this.#warnings.filter((warning) => warning.code !== "process_error"), makeWarning(error.message, "process_error")];
       if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
-        void this.#scheduleRecovery();
+        void this.#scheduleRecovery().catch((error2) => {
+          this.#writeProcessLogLine(`[recovery-error] ${error2 instanceof Error ? error2.message : String(error2)}`);
+        });
       }
     });
   }
   #attachProcessLogging(child, binary, args) {
     const logStream = createWriteStream(VICE_PROCESS_LOG_PATH, { flags: "a" });
+    logStream.on("error", () => {
+    });
     this.#processLogStream = logStream;
     this.#stdoutMirrorBuffer = "";
     this.#stderrMirrorBuffer = "";
@@ -2831,7 +2912,10 @@ var ViceSession = class {
     logStream.write(`
 === Emulator stream closed ${nowIso()} (${reason}) ===
 `);
-    logStream.end();
+    logStream.end(() => {
+    });
+    logStream.on("error", () => {
+    });
     this.#processLogStream = null;
   }
   #mirrorViceOutputChunk(stream, chunk) {
@@ -3674,7 +3758,7 @@ var executeTool = createViceTool({
   inputSchema: z3.object({
     action: z3.enum(["pause", "resume", "step", "step_over", "step_out", "reset"]),
     count: z3.number().int().positive().default(1).describe("Instruction count for step and step_over actions"),
-    resetMode: resetModeSchema.default("soft").describe("Reset mode when action is reset"),
+    resetMode: resetModeSchema.default("soft").describe("Reset mode: soft (CPU reset), hard (full machine reset), or nuclear (complete VICE restart)"),
     waitUntilRunningStable: z3.boolean().default(false).describe("When action is resume, wait until running becomes stable before returning")
   }),
   dataSchema: debugStateSchema.extend({

package/dist/stdio.cjs

@@ -63,7 +63,7 @@ var stopReasonSchema = import_zod.z.enum([
 ]);
 var sessionHealthSchema = import_zod.z.enum(["not_configured", "starting", "ready", "recovering", "stopped", "error"]);
 var breakpointKindSchema = import_zod.z.enum(["exec", "read", "write", "read_write"]);
-var resetModeSchema = import_zod.z.enum(["soft", "hard"]);
+var resetModeSchema = import_zod.z.enum(["soft", "hard", "nuclear"]);
 var inputActionSchema = import_zod.z.enum(["press", "release", "tap"]);
 var joystickControlSchema = import_zod.z.enum(["up", "down", "left", "right", "fire"]);
 var joystickPortSchema = import_zod.z.union([import_zod.z.literal(1), import_zod.z.literal(2)]);
@@ -1725,7 +1725,17 @@ var ViceSession = class {
       }
       this.#syncMonitorRuntimeState();
       if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
-        void this.#scheduleRecovery();
+        void this.#scheduleRecovery().catch((error) => {
+          this.#writeProcessLogLine(`[recovery-error] ${error instanceof Error ? error.message : String(error)}`);
+        });
+      }
+    });
+    this.#client.on("transport-error", (error) => {
+      this.#writeProcessLogLine(`[monitor-error] transport error: ${error.message}`);
+      if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
+        void this.#scheduleRecovery().catch((recoveryError) => {
+          this.#writeProcessLogLine(`[recovery-error] ${recoveryError instanceof Error ? recoveryError.message : String(recoveryError)}`);
+        });
       }
     });
     this.#client.on("event", (event) => {
@@ -2066,6 +2076,10 @@ var ViceSession = class {
   async resetMachine(mode) {
     return this.#withExecutionLock(async () => {
       await this.#ensureReady();
+      this.#clearHeldInputState();
+      if (mode === "nuclear") {
+        return await this.#performNuclearReset();
+      }
       const wasPaused = this.#explicitPauseActive;
       this.#lastExecutionIntent = "reset";
       this.#writeProcessLogLine(`[tx] execute reset mode=${mode}`);
@@ -2085,6 +2099,67 @@ var ViceSession = class {
       };
     });
   }
+  async #performNuclearReset() {
+    const savedBreakpoints = await this.#captureBreakpointState();
+    const wasPaused = this.#explicitPauseActive;
+    this.#writeProcessLogLine("[nuclear-reset] initiating full VICE process restart");
+    await this.#scheduleRecovery();
+    await this.#restoreBreakpointState(savedBreakpoints);
+    this.#explicitPauseActive = wasPaused;
+    if (wasPaused) {
+      this.#writeProcessLogLine("[nuclear-reset] restoring paused state");
+      await this.pauseExecution();
+    }
+    this.#writeProcessLogLine("[nuclear-reset] completed successfully");
+    const debugState = await this.#readDebugState();
+    return {
+      executionState: debugState.executionState,
+      lastStopReason: debugState.lastStopReason,
+      programCounter: debugState.programCounter,
+      registers: debugState.registers,
+      warnings: []
+    };
+  }
+  async #captureBreakpointState() {
+    try {
+      const result = await this.listBreakpoints(true);
+      return result.breakpoints.map((bp) => ({
+        kind: bp.kind,
+        start: bp.start,
+        end: bp.end,
+        enabled: bp.enabled,
+        temporary: bp.temporary,
+        hasCondition: bp.hasCondition,
+        label: this.#breakpointLabels.get(bp.id) ?? null
+      }));
+    } catch (error) {
+      this.#writeProcessLogLine(`[nuclear-reset] failed to capture breakpoints: ${error instanceof Error ? error.message : String(error)}`);
+      return [];
+    }
+  }
+  async #restoreBreakpointState(savedBreakpoints) {
+    if (savedBreakpoints.length === 0) {
+      return;
+    }
+    this.#writeProcessLogLine(`[nuclear-reset] restoring ${savedBreakpoints.length} breakpoints`);
+    for (const bp of savedBreakpoints) {
+      try {
+        await this.breakpointSet({
+          kind: bp.kind,
+          address: bp.start,
+          length: bp.end - bp.start + 1,
+          enabled: bp.enabled,
+          temporary: bp.temporary,
+          label: bp.label ?? void 0
+        });
+        this.#writeProcessLogLine(`[nuclear-reset] restored breakpoint at $${bp.start.toString(16).toUpperCase()}`);
+      } catch (error) {
+        this.#writeProcessLogLine(
+          `[nuclear-reset] failed to restore breakpoint at $${bp.start.toString(16).toUpperCase()}: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  }
   async listBreakpoints(includeDisabled = true) {
     await this.#ensureReady();
     this.#writeProcessLogLine(`[tx] breakpoint_list includeDisabled=${includeDisabled}`);
@@ -2799,7 +2874,9 @@ var ViceSession = class {
         makeWarning(`C64 emulator process exited (${code ?? "null"} / ${signal ?? "null"})`, "process_exit")
       ];
       if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
-        void this.#scheduleRecovery();
+        void this.#scheduleRecovery().catch((error) => {
+          this.#writeProcessLogLine(`[recovery-error] ${error instanceof Error ? error.message : String(error)}`);
+        });
       }
     });
     child.once("error", (error) => {
@@ -2812,12 +2889,16 @@ var ViceSession = class {
       this.#transportState = "faulted";
       this.#warnings = [...this.#warnings.filter((warning) => warning.code !== "process_error"), makeWarning(error.message, "process_error")];
       if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
-        void this.#scheduleRecovery();
+        void this.#scheduleRecovery().catch((error2) => {
+          this.#writeProcessLogLine(`[recovery-error] ${error2 instanceof Error ? error2.message : String(error2)}`);
+        });
       }
     });
   }
   #attachProcessLogging(child, binary, args) {
     const logStream = (0, import_node_fs.createWriteStream)(VICE_PROCESS_LOG_PATH, { flags: "a" });
+    logStream.on("error", () => {
+    });
     this.#processLogStream = logStream;
     this.#stdoutMirrorBuffer = "";
     this.#stderrMirrorBuffer = "";
@@ -2851,7 +2932,10 @@ var ViceSession = class {
     logStream.write(`
 === Emulator stream closed ${nowIso()} (${reason}) ===
 `);
-    logStream.end();
+    logStream.end(() => {
+    });
+    logStream.on("error", () => {
+    });
     this.#processLogStream = null;
   }
   #mirrorViceOutputChunk(stream, chunk) {
@@ -3694,7 +3778,7 @@ var executeTool = createViceTool({
   inputSchema: import_zod4.z.object({
     action: import_zod4.z.enum(["pause", "resume", "step", "step_over", "step_out", "reset"]),
     count: import_zod4.z.number().int().positive().default(1).describe("Instruction count for step and step_over actions"),
-    resetMode: resetModeSchema.default("soft").describe("Reset mode when action is reset"),
+    resetMode: resetModeSchema.default("soft").describe("Reset mode: soft (CPU reset), hard (full machine reset), or nuclear (complete VICE restart)"),
     waitUntilRunningStable: import_zod4.z.boolean().default(false).describe("When action is resume, wait until running becomes stable before returning")
   }),
   dataSchema: debugStateSchema.extend({

package/dist/stdio.js

@@ -40,7 +40,7 @@ var stopReasonSchema = z.enum([
 ]);
 var sessionHealthSchema = z.enum(["not_configured", "starting", "ready", "recovering", "stopped", "error"]);
 var breakpointKindSchema = z.enum(["exec", "read", "write", "read_write"]);
-var resetModeSchema = z.enum(["soft", "hard"]);
+var resetModeSchema = z.enum(["soft", "hard", "nuclear"]);
 var inputActionSchema = z.enum(["press", "release", "tap"]);
 var joystickControlSchema = z.enum(["up", "down", "left", "right", "fire"]);
 var joystickPortSchema = z.union([z.literal(1), z.literal(2)]);
@@ -1702,7 +1702,17 @@ var ViceSession = class {
       }
       this.#syncMonitorRuntimeState();
       if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
-        void this.#scheduleRecovery();
+        void this.#scheduleRecovery().catch((error) => {
+          this.#writeProcessLogLine(`[recovery-error] ${error instanceof Error ? error.message : String(error)}`);
+        });
+      }
+    });
+    this.#client.on("transport-error", (error) => {
+      this.#writeProcessLogLine(`[monitor-error] transport error: ${error.message}`);
+      if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
+        void this.#scheduleRecovery().catch((recoveryError) => {
+          this.#writeProcessLogLine(`[recovery-error] ${recoveryError instanceof Error ? recoveryError.message : String(recoveryError)}`);
+        });
       }
     });
     this.#client.on("event", (event) => {
@@ -2043,6 +2053,10 @@ var ViceSession = class {
   async resetMachine(mode) {
     return this.#withExecutionLock(async () => {
       await this.#ensureReady();
+      this.#clearHeldInputState();
+      if (mode === "nuclear") {
+        return await this.#performNuclearReset();
+      }
       const wasPaused = this.#explicitPauseActive;
       this.#lastExecutionIntent = "reset";
       this.#writeProcessLogLine(`[tx] execute reset mode=${mode}`);
@@ -2062,6 +2076,67 @@ var ViceSession = class {
       };
     });
   }
+  async #performNuclearReset() {
+    const savedBreakpoints = await this.#captureBreakpointState();
+    const wasPaused = this.#explicitPauseActive;
+    this.#writeProcessLogLine("[nuclear-reset] initiating full VICE process restart");
+    await this.#scheduleRecovery();
+    await this.#restoreBreakpointState(savedBreakpoints);
+    this.#explicitPauseActive = wasPaused;
+    if (wasPaused) {
+      this.#writeProcessLogLine("[nuclear-reset] restoring paused state");
+      await this.pauseExecution();
+    }
+    this.#writeProcessLogLine("[nuclear-reset] completed successfully");
+    const debugState = await this.#readDebugState();
+    return {
+      executionState: debugState.executionState,
+      lastStopReason: debugState.lastStopReason,
+      programCounter: debugState.programCounter,
+      registers: debugState.registers,
+      warnings: []
+    };
+  }
+  async #captureBreakpointState() {
+    try {
+      const result = await this.listBreakpoints(true);
+      return result.breakpoints.map((bp) => ({
+        kind: bp.kind,
+        start: bp.start,
+        end: bp.end,
+        enabled: bp.enabled,
+        temporary: bp.temporary,
+        hasCondition: bp.hasCondition,
+        label: this.#breakpointLabels.get(bp.id) ?? null
+      }));
+    } catch (error) {
+      this.#writeProcessLogLine(`[nuclear-reset] failed to capture breakpoints: ${error instanceof Error ? error.message : String(error)}`);
+      return [];
+    }
+  }
+  async #restoreBreakpointState(savedBreakpoints) {
+    if (savedBreakpoints.length === 0) {
+      return;
+    }
+    this.#writeProcessLogLine(`[nuclear-reset] restoring ${savedBreakpoints.length} breakpoints`);
+    for (const bp of savedBreakpoints) {
+      try {
+        await this.breakpointSet({
+          kind: bp.kind,
+          address: bp.start,
+          length: bp.end - bp.start + 1,
+          enabled: bp.enabled,
+          temporary: bp.temporary,
+          label: bp.label ?? void 0
+        });
+        this.#writeProcessLogLine(`[nuclear-reset] restored breakpoint at $${bp.start.toString(16).toUpperCase()}`);
+      } catch (error) {
+        this.#writeProcessLogLine(
+          `[nuclear-reset] failed to restore breakpoint at $${bp.start.toString(16).toUpperCase()}: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  }
   async listBreakpoints(includeDisabled = true) {
     await this.#ensureReady();
     this.#writeProcessLogLine(`[tx] breakpoint_list includeDisabled=${includeDisabled}`);
@@ -2776,7 +2851,9 @@ var ViceSession = class {
         makeWarning(`C64 emulator process exited (${code ?? "null"} / ${signal ?? "null"})`, "process_exit")
       ];
       if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
-        void this.#scheduleRecovery();
+        void this.#scheduleRecovery().catch((error) => {
+          this.#writeProcessLogLine(`[recovery-error] ${error instanceof Error ? error.message : String(error)}`);
+        });
       }
     });
     child.once("error", (error) => {
@@ -2789,12 +2866,16 @@ var ViceSession = class {
       this.#transportState = "faulted";
       this.#warnings = [...this.#warnings.filter((warning) => warning.code !== "process_error"), makeWarning(error.message, "process_error")];
       if (!this.#suppressRecovery && !this.#shuttingDown && this.#config) {
-        void this.#scheduleRecovery();
+        void this.#scheduleRecovery().catch((error2) => {
+          this.#writeProcessLogLine(`[recovery-error] ${error2 instanceof Error ? error2.message : String(error2)}`);
+        });
       }
     });
   }
   #attachProcessLogging(child, binary, args) {
     const logStream = createWriteStream(VICE_PROCESS_LOG_PATH, { flags: "a" });
+    logStream.on("error", () => {
+    });
     this.#processLogStream = logStream;
     this.#stdoutMirrorBuffer = "";
     this.#stderrMirrorBuffer = "";
@@ -2828,7 +2909,10 @@ var ViceSession = class {
     logStream.write(`
 === Emulator stream closed ${nowIso()} (${reason}) ===
 `);
-    logStream.end();
+    logStream.end(() => {
+    });
+    logStream.on("error", () => {
+    });
     this.#processLogStream = null;
   }
   #mirrorViceOutputChunk(stream, chunk) {
@@ -3671,7 +3755,7 @@ var executeTool = createViceTool({
   inputSchema: z3.object({
     action: z3.enum(["pause", "resume", "step", "step_over", "step_out", "reset"]),
     count: z3.number().int().positive().default(1).describe("Instruction count for step and step_over actions"),
-    resetMode: resetModeSchema.default("soft").describe("Reset mode when action is reset"),
+    resetMode: resetModeSchema.default("soft").describe("Reset mode: soft (CPU reset), hard (full machine reset), or nuclear (complete VICE restart)"),
     waitUntilRunningStable: z3.boolean().default(false).describe("When action is resume, wait until running becomes stable before returning")
   }),
   dataSchema: debugStateSchema.extend({

package/package.json

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