@within-7/minto 0.1.7 → 0.3.0

package/dist/utils/BackgroundShellManager.js

@@ -34,12 +34,17 @@ class RegExpCache {
     return regex;
   }
 }
+const AUTO_CLEANUP_INTERVAL = 5 * 60 * 1e3;
+const MAX_COMPLETED_SHELL_AGE = 30 * 60 * 1e3;
+const MAX_COMPLETED_SHELLS = 50;
 class BackgroundShellManager extends EventEmitter {
   static instance = null;
   shells = /* @__PURE__ */ new Map();
   regexCache = new RegExpCache();
+  autoCleanupTimer = null;
   constructor() {
     super();
+    this.startAutoCleanup();
   }
   static getInstance() {
     if (!BackgroundShellManager.instance) {
@@ -47,6 +52,62 @@ class BackgroundShellManager extends EventEmitter {
     }
     return BackgroundShellManager.instance;
   }
+  /**
+   * Start automatic cleanup timer
+   * Cleans up old completed shells periodically to prevent memory bloat
+   */
+  startAutoCleanup() {
+    if (this.autoCleanupTimer) return;
+    this.autoCleanupTimer = setInterval(() => {
+      this.autoCleanup();
+    }, AUTO_CLEANUP_INTERVAL);
+    this.autoCleanupTimer.unref();
+  }
+  /**
+   * Stop automatic cleanup timer
+   * Should be called when shutting down
+   */
+  stopAutoCleanup() {
+    if (this.autoCleanupTimer) {
+      clearInterval(this.autoCleanupTimer);
+      this.autoCleanupTimer = null;
+    }
+  }
+  /**
+   * Automatic cleanup of old and excessive completed shells
+   * Called periodically by the auto-cleanup timer
+   */
+  autoCleanup() {
+    const completedShells = [];
+    for (const [shellId, shell] of this.shells.entries()) {
+      if (shell.status !== "running") {
+        completedShells.push([shellId, shell]);
+      }
+    }
+    let removed = 0;
+    const now = Date.now();
+    for (const [shellId, shell] of completedShells) {
+      if (shell.endTime && now - shell.endTime > MAX_COMPLETED_SHELL_AGE) {
+        this.cleanupListeners(shell);
+        this.shells.delete(shellId);
+        removed++;
+      }
+    }
+    const remainingCompleted = completedShells.filter(([shellId]) => this.shells.has(shellId)).sort((a, b) => (a[1].endTime || 0) - (b[1].endTime || 0));
+    while (remainingCompleted.length > MAX_COMPLETED_SHELLS) {
+      const oldest = remainingCompleted.shift();
+      if (oldest) {
+        const [shellId, shell] = oldest;
+        this.cleanupListeners(shell);
+        this.shells.delete(shellId);
+        removed++;
+      }
+    }
+    if (removed > 0) {
+      this.emit("autoCleaned", removed);
+      this.emitListChange();
+    }
+  }
   /**
    * Create a new background shell and start executing the command
    */
@@ -74,46 +135,55 @@ class BackgroundShellManager extends EventEmitter {
       lastReadStdoutIndex: 0,
       lastReadStderrIndex: 0
     };
-    childProcess.stdout?.on("data", (data) => {
-      const lines = data.toString().split("\n");
-      shell.stdout.push(...lines);
-      if (shell.stdout.length > MAX_OUTPUT_LINES) {
-        const removed = shell.stdout.length - MAX_OUTPUT_LINES;
-        shell.stdout = shell.stdout.slice(removed);
-        shell.lastReadStdoutIndex = Math.max(
-          0,
-          shell.lastReadStdoutIndex - removed
-        );
-      }
-      this.emit("output", shellId, "stdout", lines);
-    });
-    childProcess.stderr?.on("data", (data) => {
-      const lines = data.toString().split("\n");
-      shell.stderr.push(...lines);
-      if (shell.stderr.length > MAX_OUTPUT_LINES) {
-        const removed = shell.stderr.length - MAX_OUTPUT_LINES;
-        shell.stderr = shell.stderr.slice(removed);
-        shell.lastReadStderrIndex = Math.max(
-          0,
-          shell.lastReadStderrIndex - removed
-        );
+    const listeners = {
+      stdout: (data) => {
+        const lines = data.toString().split("\n");
+        shell.stdout.push(...lines);
+        if (shell.stdout.length > MAX_OUTPUT_LINES) {
+          const removed = shell.stdout.length - MAX_OUTPUT_LINES;
+          shell.stdout = shell.stdout.slice(removed);
+          shell.lastReadStdoutIndex = Math.max(
+            0,
+            shell.lastReadStdoutIndex - removed
+          );
+        }
+        this.emit("output", shellId, "stdout", lines);
+      },
+      stderr: (data) => {
+        const lines = data.toString().split("\n");
+        shell.stderr.push(...lines);
+        if (shell.stderr.length > MAX_OUTPUT_LINES) {
+          const removed = shell.stderr.length - MAX_OUTPUT_LINES;
+          shell.stderr = shell.stderr.slice(removed);
+          shell.lastReadStderrIndex = Math.max(
+            0,
+            shell.lastReadStderrIndex - removed
+          );
+        }
+        this.emit("output", shellId, "stderr", lines);
+      },
+      exit: (code, signal) => {
+        shell.status = signal ? "killed" : "done";
+        shell.exitCode = code ?? void 0;
+        shell.endTime = Date.now();
+        this.emit("statusChange", shellId, shell.status);
+        this.emitListChange();
+        this.cleanupListeners(shell);
+      },
+      error: (error) => {
+        logError(`Background shell ${shellId} error: ${error.message}`);
+        shell.status = "killed";
+        shell.endTime = Date.now();
+        this.emit("statusChange", shellId, shell.status);
+        this.emitListChange();
+        this.cleanupListeners(shell);
       }
-      this.emit("output", shellId, "stderr", lines);
-    });
-    childProcess.on("exit", (code, signal) => {
-      shell.status = signal ? "killed" : "done";
-      shell.exitCode = code ?? void 0;
-      shell.endTime = Date.now();
-      this.emit("statusChange", shellId, shell.status);
-      this.emitListChange();
-    });
-    childProcess.on("error", (error) => {
-      logError(`Background shell ${shellId} error: ${error.message}`);
-      shell.status = "killed";
-      shell.endTime = Date.now();
-      this.emit("statusChange", shellId, shell.status);
-      this.emitListChange();
-    });
+    };
+    shell._listeners = listeners;
+    if (listeners.stdout) childProcess.stdout?.on("data", listeners.stdout);
+    if (listeners.stderr) childProcess.stderr?.on("data", listeners.stderr);
+    if (listeners.exit) childProcess.on("exit", listeners.exit);
+    if (listeners.error) childProcess.on("error", listeners.error);
     this.shells.set(shellId, shell);
     this.emit("shellCreated", shellId);
     this.emitListChange();
@@ -126,6 +196,29 @@ class BackgroundShellManager extends EventEmitter {
   emitListChange() {
     this.emit("listChange", this.list());
   }
+  /**
+   * 🔧 CRITICAL FIX: Clean up event listeners to prevent memory leaks
+   * This removes all event listeners attached to the child process
+   */
+  cleanupListeners(shell) {
+    if (!shell._listeners || !shell.process) {
+      return;
+    }
+    const { stdout, stderr, exit, error } = shell._listeners;
+    if (stdout) {
+      shell.process.stdout?.off("data", stdout);
+    }
+    if (stderr) {
+      shell.process.stderr?.off("data", stderr);
+    }
+    if (exit) {
+      shell.process.off("exit", exit);
+    }
+    if (error) {
+      shell.process.off("error", error);
+    }
+    delete shell._listeners;
+  }
   /**
    * Get a background shell by ID
    */
@@ -204,6 +297,7 @@ class BackgroundShellManager extends EventEmitter {
         }
         shell.status = "killed";
         shell.endTime = Date.now();
+        this.cleanupListeners(shell);
         this.emit("statusChange", shellId, "killed");
         this.emitListChange();
         return true;
@@ -213,6 +307,7 @@ class BackgroundShellManager extends EventEmitter {
           error
         );
         logError(`Failed to kill shell ${shellId}: ${error}`);
+        this.cleanupListeners(shell);
         return false;
       }
     }
@@ -240,6 +335,7 @@ class BackgroundShellManager extends EventEmitter {
   remove(shellId) {
     const shell = this.shells.get(shellId);
     if (!shell || shell.status === "running") return false;
+    this.cleanupListeners(shell);
     this.shells.delete(shellId);
     this.emit("shellRemoved", shellId);
     this.emitListChange();
@@ -253,6 +349,7 @@ class BackgroundShellManager extends EventEmitter {
     let removed = 0;
     for (const [shellId, shell] of this.shells.entries()) {
       if (shell.status !== "running" && shell.endTime && now - shell.endTime > maxAge) {
+        this.cleanupListeners(shell);
         this.shells.delete(shellId);
         removed++;
       }

package/dist/utils/BackgroundShellManager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/BackgroundShellManager.ts"],
-  "sourcesContent": ["import { spawn, type ChildProcess } from 'child_process'\nimport { EventEmitter } from 'events'\nimport { randomUUID } from 'crypto'\nimport { logError } from './log'\n\nexport type BackgroundShellStatus = 'running' | 'done' | 'killed'\n\nexport interface BackgroundShell {\n  id: string\n  command: string\n  status: BackgroundShellStatus\n  startTime: number\n  endTime?: number\n  process: ChildProcess\n  stdout: string[]\n  stderr: string[]\n  exitCode?: number\n  lastReadStdoutIndex: number\n  lastReadStderrIndex: number\n}\n\nconst MAX_OUTPUT_LINES = 1000 // Keep last N lines in memory\nconst REGEX_CACHE_SIZE = 50 // LRU cache size for compiled regexes\n\n// Simple LRU cache for compiled RegExp objects\nclass RegExpCache {\n  private cache = new Map<string, RegExp>()\n  private maxSize: number\n\n  constructor(maxSize: number = REGEX_CACHE_SIZE) {\n    this.maxSize = maxSize\n  }\n\n  get(pattern: string): RegExp | undefined {\n    const regex = this.cache.get(pattern)\n    if (regex) {\n      // Move to end (most recently used)\n      this.cache.delete(pattern)\n      this.cache.set(pattern, regex)\n    }\n    return regex\n  }\n\n  set(pattern: string, regex: RegExp): void {\n    // Evict oldest if at capacity\n    if (this.cache.size >= this.maxSize) {\n      const oldest = this.cache.keys().next().value\n      if (oldest) this.cache.delete(oldest)\n    }\n    this.cache.set(pattern, regex)\n  }\n\n  getOrCreate(pattern: string): RegExp {\n    let regex = this.get(pattern)\n    if (!regex) {\n      regex = new RegExp(pattern)\n      this.set(pattern, regex)\n    }\n    return regex\n  }\n}\n\nexport class BackgroundShellManager extends EventEmitter {\n  private static instance: BackgroundShellManager | null = null\n  private shells: Map<string, BackgroundShell> = new Map()\n  private regexCache = new RegExpCache()\n\n  private constructor() {\n    super()\n  }\n\n  static getInstance(): BackgroundShellManager {\n    if (!BackgroundShellManager.instance) {\n      BackgroundShellManager.instance = new BackgroundShellManager()\n    }\n    return BackgroundShellManager.instance\n  }\n\n  /**\n   * Create a new background shell and start executing the command\n   */\n  create(command: string, cwd?: string): string {\n    const shellId = randomUUID().slice(0, 8)\n\n    // Spawn the command in a shell\n    const childProcess = spawn(command, [], {\n      shell: true,\n      cwd: cwd || process.cwd(),\n      stdio: ['ignore', 'pipe', 'pipe'],\n      detached: true, // Create a new process group for easier cleanup\n      env: {\n        ...process.env,\n        GIT_EDITOR: 'true',\n      },\n    })\n\n    const shell: BackgroundShell = {\n      id: shellId,\n      command,\n      status: 'running',\n      startTime: Date.now(),\n      process: childProcess,\n      stdout: [],\n      stderr: [],\n      lastReadStdoutIndex: 0,\n      lastReadStderrIndex: 0,\n    }\n\n    // Capture stdout\n    childProcess.stdout?.on('data', (data: Buffer) => {\n      const lines = data.toString().split('\\n')\n      shell.stdout.push(...lines)\n\n      // Keep only last MAX_OUTPUT_LINES\n      if (shell.stdout.length > MAX_OUTPUT_LINES) {\n        const removed = shell.stdout.length - MAX_OUTPUT_LINES\n        shell.stdout = shell.stdout.slice(removed)\n        shell.lastReadStdoutIndex = Math.max(\n          0,\n          shell.lastReadStdoutIndex - removed,\n        )\n      }\n\n      this.emit('output', shellId, 'stdout', lines)\n    })\n\n    // Capture stderr\n    childProcess.stderr?.on('data', (data: Buffer) => {\n      const lines = data.toString().split('\\n')\n      shell.stderr.push(...lines)\n\n      // Keep only last MAX_OUTPUT_LINES\n      if (shell.stderr.length > MAX_OUTPUT_LINES) {\n        const removed = shell.stderr.length - MAX_OUTPUT_LINES\n        shell.stderr = shell.stderr.slice(removed)\n        shell.lastReadStderrIndex = Math.max(\n          0,\n          shell.lastReadStderrIndex - removed,\n        )\n      }\n\n      this.emit('output', shellId, 'stderr', lines)\n    })\n\n    // Handle process exit\n    childProcess.on('exit', (code, signal) => {\n      shell.status = signal ? 'killed' : 'done'\n      shell.exitCode = code ?? undefined\n      shell.endTime = Date.now()\n      this.emit('statusChange', shellId, shell.status)\n      this.emitListChange()\n    })\n\n    childProcess.on('error', error => {\n      logError(`Background shell ${shellId} error: ${error.message}`)\n      shell.status = 'killed'\n      shell.endTime = Date.now()\n      this.emit('statusChange', shellId, shell.status)\n      this.emitListChange()\n    })\n\n    this.shells.set(shellId, shell)\n    this.emit('shellCreated', shellId)\n    this.emitListChange()\n\n    return shellId\n  }\n\n  /**\n   * Emit a list change event with the current shell list\n   * Used for event-driven updates instead of polling\n   */\n  private emitListChange(): void {\n    this.emit('listChange', this.list())\n  }\n\n  /**\n   * Get a background shell by ID\n   */\n  get(shellId: string): BackgroundShell | undefined {\n    return this.shells.get(shellId)\n  }\n\n  /**\n   * Get new output since last read\n   */\n  getNewOutput(\n    shellId: string,\n    filter?: string,\n  ): {\n    stdout: string[]\n    stderr: string[]\n  } | null {\n    const shell = this.shells.get(shellId)\n    if (!shell) return null\n\n    let newStdout = shell.stdout.slice(shell.lastReadStdoutIndex)\n    let newStderr = shell.stderr.slice(shell.lastReadStderrIndex)\n\n    // Apply regex filter if provided (using cached regex)\n    if (filter) {\n      try {\n        const regex = this.regexCache.getOrCreate(filter)\n        newStdout = newStdout.filter(line => regex.test(line))\n        newStderr = newStderr.filter(line => regex.test(line))\n      } catch (e) {\n        logError(`Invalid regex filter: ${filter}`)\n      }\n    }\n\n    // Update read indices\n    shell.lastReadStdoutIndex = shell.stdout.length\n    shell.lastReadStderrIndex = shell.stderr.length\n\n    return { stdout: newStdout, stderr: newStderr }\n  }\n\n  /**\n   * Get all output (entire buffer)\n   */\n  getAllOutput(shellId: string): {\n    stdout: string[]\n    stderr: string[]\n  } | null {\n    const shell = this.shells.get(shellId)\n    if (!shell) return null\n\n    return {\n      stdout: [...shell.stdout],\n      stderr: [...shell.stderr],\n    }\n  }\n\n  /**\n   * Kill a background shell\n   */\n  kill(shellId: string): boolean {\n    const shell = this.shells.get(shellId)\n    if (!shell) {\n      console.log(\n        `[BackgroundShellManager] Cannot kill: shell ${shellId} not found`,\n      )\n      return false\n    }\n\n    if (shell.status === 'running') {\n      try {\n        const pid = shell.process.pid\n        if (!pid) {\n          console.log(\n            `[BackgroundShellManager] Cannot kill: shell ${shellId} has no PID`,\n          )\n          return false\n        }\n\n        console.log(\n          `[BackgroundShellManager] Killing shell ${shellId} (PID: ${pid}, command: ${shell.command})`,\n        )\n\n        // Kill the process and all its children\n        if (process.platform === 'win32') {\n          spawn('taskkill', ['/pid', pid.toString(), '/f', '/t'])\n        } else {\n          // Send SIGKILL to process group (more forceful than SIGTERM)\n          // The negative PID sends signal to the entire process group\n          try {\n            process.kill(-pid, 'SIGKILL')\n            console.log(\n              `[BackgroundShellManager] Sent SIGKILL to process group -${pid}`,\n            )\n          } catch (e) {\n            // If process group kill fails, try killing just the main process\n            console.log(\n              `[BackgroundShellManager] Process group kill failed, trying main process only`,\n            )\n            process.kill(pid, 'SIGKILL')\n          }\n        }\n\n        shell.status = 'killed'\n        shell.endTime = Date.now()\n        this.emit('statusChange', shellId, 'killed')\n        this.emitListChange()\n        return true\n      } catch (error) {\n        console.error(\n          `[BackgroundShellManager] Failed to kill shell ${shellId}:`,\n          error,\n        )\n        logError(`Failed to kill shell ${shellId}: ${error}`)\n        return false\n      }\n    }\n\n    console.log(\n      `[BackgroundShellManager] Shell ${shellId} is not running (status: ${shell.status})`,\n    )\n    return false\n  }\n\n  /**\n   * List all background shells\n   */\n  list(): BackgroundShell[] {\n    return Array.from(this.shells.values())\n  }\n\n  /**\n   * Get shell status\n   */\n  getStatus(shellId: string): BackgroundShellStatus | null {\n    const shell = this.shells.get(shellId)\n    return shell ? shell.status : null\n  }\n\n  /**\n   * Remove a shell from the manager (only if done or killed)\n   */\n  remove(shellId: string): boolean {\n    const shell = this.shells.get(shellId)\n    if (!shell || shell.status === 'running') return false\n\n    this.shells.delete(shellId)\n    this.emit('shellRemoved', shellId)\n    this.emitListChange()\n    return true\n  }\n\n  /**\n   * Clean up old completed/killed shells\n   */\n  cleanup(maxAge: number = 3600000): number {\n    const now = Date.now()\n    let removed = 0\n\n    for (const [shellId, shell] of this.shells.entries()) {\n      if (\n        shell.status !== 'running' &&\n        shell.endTime &&\n        now - shell.endTime > maxAge\n      ) {\n        this.shells.delete(shellId)\n        removed++\n      }\n    }\n\n    if (removed > 0) {\n      this.emit('cleaned', removed)\n      this.emitListChange()\n    }\n\n    return removed\n  }\n\n  /**\n   * Get summary of shell for display\n   */\n  getSummary(shellId: string): string | null {\n    const shell = this.shells.get(shellId)\n    if (!shell) return null\n\n    const duration = shell.endTime\n      ? Math.floor((shell.endTime - shell.startTime) / 1000)\n      : Math.floor((Date.now() - shell.startTime) / 1000)\n\n    // Get last few lines of output for preview\n    const lastLines = shell.stdout.slice(-2).join(' ').slice(0, 50)\n    const preview = lastLines ? ` ${lastLines}\u2026` : ''\n\n    return `${shell.command}${preview}`\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { spawn, type ChildProcess } from 'child_process'\nimport { EventEmitter } from 'events'\nimport { randomUUID } from 'crypto'\nimport { logError } from './log'\n\nexport type BackgroundShellStatus = 'running' | 'done' | 'killed'\n\n// \uD83D\uDD27 Internal event listener references for cleanup\ninterface ShellListeners {\n  stdout?: (data: Buffer) => void\n  stderr?: (data: Buffer) => void\n  exit?: (code: number | null, signal: NodeJS.Signals | null) => void\n  error?: (error: Error) => void\n}\n\nexport interface BackgroundShell {\n  id: string\n  command: string\n  status: BackgroundShellStatus\n  startTime: number\n  endTime?: number\n  process: ChildProcess\n  stdout: string[]\n  stderr: string[]\n  exitCode?: number\n  lastReadStdoutIndex: number\n  lastReadStderrIndex: number\n  /** @internal Event listeners for cleanup */\n  _listeners?: ShellListeners\n}\n\nconst MAX_OUTPUT_LINES = 1000 // Keep last N lines in memory\nconst REGEX_CACHE_SIZE = 50 // LRU cache size for compiled regexes\n\n// Simple LRU cache for compiled RegExp objects\nclass RegExpCache {\n  private cache = new Map<string, RegExp>()\n  private maxSize: number\n\n  constructor(maxSize: number = REGEX_CACHE_SIZE) {\n    this.maxSize = maxSize\n  }\n\n  get(pattern: string): RegExp | undefined {\n    const regex = this.cache.get(pattern)\n    if (regex) {\n      // Move to end (most recently used)\n      this.cache.delete(pattern)\n      this.cache.set(pattern, regex)\n    }\n    return regex\n  }\n\n  set(pattern: string, regex: RegExp): void {\n    // Evict oldest if at capacity\n    if (this.cache.size >= this.maxSize) {\n      const oldest = this.cache.keys().next().value\n      if (oldest) this.cache.delete(oldest)\n    }\n    this.cache.set(pattern, regex)\n  }\n\n  getOrCreate(pattern: string): RegExp {\n    let regex = this.get(pattern)\n    if (!regex) {\n      regex = new RegExp(pattern)\n      this.set(pattern, regex)\n    }\n    return regex\n  }\n}\n\n// Auto-cleanup configuration\nconst AUTO_CLEANUP_INTERVAL = 5 * 60 * 1000 // 5 minutes\nconst MAX_COMPLETED_SHELL_AGE = 30 * 60 * 1000 // 30 minutes\nconst MAX_COMPLETED_SHELLS = 50 // Maximum completed shells to keep\n\nexport class BackgroundShellManager extends EventEmitter {\n  private static instance: BackgroundShellManager | null = null\n  private shells: Map<string, BackgroundShell> = new Map()\n  private regexCache = new RegExpCache()\n  private autoCleanupTimer: ReturnType<typeof setInterval> | null = null\n\n  private constructor() {\n    super()\n    // Start auto-cleanup timer\n    this.startAutoCleanup()\n  }\n\n  static getInstance(): BackgroundShellManager {\n    if (!BackgroundShellManager.instance) {\n      BackgroundShellManager.instance = new BackgroundShellManager()\n    }\n    return BackgroundShellManager.instance\n  }\n\n  /**\n   * Start automatic cleanup timer\n   * Cleans up old completed shells periodically to prevent memory bloat\n   */\n  private startAutoCleanup(): void {\n    if (this.autoCleanupTimer) return\n\n    this.autoCleanupTimer = setInterval(() => {\n      this.autoCleanup()\n    }, AUTO_CLEANUP_INTERVAL)\n\n    // Don't keep the process alive just for cleanup\n    this.autoCleanupTimer.unref()\n  }\n\n  /**\n   * Stop automatic cleanup timer\n   * Should be called when shutting down\n   */\n  stopAutoCleanup(): void {\n    if (this.autoCleanupTimer) {\n      clearInterval(this.autoCleanupTimer)\n      this.autoCleanupTimer = null\n    }\n  }\n\n  /**\n   * Automatic cleanup of old and excessive completed shells\n   * Called periodically by the auto-cleanup timer\n   */\n  private autoCleanup(): void {\n    const completedShells: Array<[string, BackgroundShell]> = []\n\n    // Collect all non-running shells\n    for (const [shellId, shell] of this.shells.entries()) {\n      if (shell.status !== 'running') {\n        completedShells.push([shellId, shell])\n      }\n    }\n\n    let removed = 0\n\n    // First, remove shells older than MAX_COMPLETED_SHELL_AGE\n    const now = Date.now()\n    for (const [shellId, shell] of completedShells) {\n      if (shell.endTime && now - shell.endTime > MAX_COMPLETED_SHELL_AGE) {\n        this.cleanupListeners(shell)\n        this.shells.delete(shellId)\n        removed++\n      }\n    }\n\n    // Then, if still too many, remove oldest until under limit\n    const remainingCompleted = completedShells\n      .filter(([shellId]) => this.shells.has(shellId))\n      .sort((a, b) => (a[1].endTime || 0) - (b[1].endTime || 0))\n\n    while (remainingCompleted.length > MAX_COMPLETED_SHELLS) {\n      const oldest = remainingCompleted.shift()\n      if (oldest) {\n        const [shellId, shell] = oldest\n        this.cleanupListeners(shell)\n        this.shells.delete(shellId)\n        removed++\n      }\n    }\n\n    if (removed > 0) {\n      this.emit('autoCleaned', removed)\n      this.emitListChange()\n    }\n  }\n\n  /**\n   * Create a new background shell and start executing the command\n   */\n  create(command: string, cwd?: string): string {\n    const shellId = randomUUID().slice(0, 8)\n\n    // Spawn the command in a shell\n    const childProcess = spawn(command, [], {\n      shell: true,\n      cwd: cwd || process.cwd(),\n      stdio: ['ignore', 'pipe', 'pipe'],\n      detached: true, // Create a new process group for easier cleanup\n      env: {\n        ...process.env,\n        GIT_EDITOR: 'true',\n      },\n    })\n\n    const shell: BackgroundShell = {\n      id: shellId,\n      command,\n      status: 'running',\n      startTime: Date.now(),\n      process: childProcess,\n      stdout: [],\n      stderr: [],\n      lastReadStdoutIndex: 0,\n      lastReadStderrIndex: 0,\n    }\n\n    // \uD83D\uDD27 CRITICAL FIX: Create named listener functions for cleanup\n    const listeners: ShellListeners = {\n      stdout: (data: Buffer) => {\n        const lines = data.toString().split('\\n')\n        shell.stdout.push(...lines)\n\n        // Keep only last MAX_OUTPUT_LINES\n        if (shell.stdout.length > MAX_OUTPUT_LINES) {\n          const removed = shell.stdout.length - MAX_OUTPUT_LINES\n          shell.stdout = shell.stdout.slice(removed)\n          shell.lastReadStdoutIndex = Math.max(\n            0,\n            shell.lastReadStdoutIndex - removed,\n          )\n        }\n\n        this.emit('output', shellId, 'stdout', lines)\n      },\n      stderr: (data: Buffer) => {\n        const lines = data.toString().split('\\n')\n        shell.stderr.push(...lines)\n\n        // Keep only last MAX_OUTPUT_LINES\n        if (shell.stderr.length > MAX_OUTPUT_LINES) {\n          const removed = shell.stderr.length - MAX_OUTPUT_LINES\n          shell.stderr = shell.stderr.slice(removed)\n          shell.lastReadStderrIndex = Math.max(\n            0,\n            shell.lastReadStderrIndex - removed,\n          )\n        }\n\n        this.emit('output', shellId, 'stderr', lines)\n      },\n      exit: (code, signal) => {\n        shell.status = signal ? 'killed' : 'done'\n        shell.exitCode = code ?? undefined\n        shell.endTime = Date.now()\n        this.emit('statusChange', shellId, shell.status)\n        this.emitListChange()\n        // \uD83D\uDD27 Auto-cleanup listeners when process exits\n        this.cleanupListeners(shell)\n      },\n      error: error => {\n        logError(`Background shell ${shellId} error: ${error.message}`)\n        shell.status = 'killed'\n        shell.endTime = Date.now()\n        this.emit('statusChange', shellId, shell.status)\n        this.emitListChange()\n        // \uD83D\uDD27 Auto-cleanup listeners when process errors\n        this.cleanupListeners(shell)\n      },\n    }\n\n    // Store listeners for later cleanup\n    shell._listeners = listeners\n\n    // Attach listeners\n    if (listeners.stdout) childProcess.stdout?.on('data', listeners.stdout)\n    if (listeners.stderr) childProcess.stderr?.on('data', listeners.stderr)\n    if (listeners.exit) childProcess.on('exit', listeners.exit)\n    if (listeners.error) childProcess.on('error', listeners.error)\n\n    this.shells.set(shellId, shell)\n    this.emit('shellCreated', shellId)\n    this.emitListChange()\n\n    return shellId\n  }\n\n  /**\n   * Emit a list change event with the current shell list\n   * Used for event-driven updates instead of polling\n   */\n  private emitListChange(): void {\n    this.emit('listChange', this.list())\n  }\n\n  /**\n   * \uD83D\uDD27 CRITICAL FIX: Clean up event listeners to prevent memory leaks\n   * This removes all event listeners attached to the child process\n   */\n  private cleanupListeners(shell: BackgroundShell): void {\n    if (!shell._listeners || !shell.process) {\n      return\n    }\n\n    const { stdout, stderr, exit, error } = shell._listeners\n\n    // Remove all listeners\n    if (stdout) {\n      shell.process.stdout?.off('data', stdout)\n    }\n    if (stderr) {\n      shell.process.stderr?.off('data', stderr)\n    }\n    if (exit) {\n      shell.process.off('exit', exit)\n    }\n    if (error) {\n      shell.process.off('error', error)\n    }\n\n    // Clear the reference\n    delete shell._listeners\n  }\n\n  /**\n   * Get a background shell by ID\n   */\n  get(shellId: string): BackgroundShell | undefined {\n    return this.shells.get(shellId)\n  }\n\n  /**\n   * Get new output since last read\n   */\n  getNewOutput(\n    shellId: string,\n    filter?: string,\n  ): {\n    stdout: string[]\n    stderr: string[]\n  } | null {\n    const shell = this.shells.get(shellId)\n    if (!shell) return null\n\n    let newStdout = shell.stdout.slice(shell.lastReadStdoutIndex)\n    let newStderr = shell.stderr.slice(shell.lastReadStderrIndex)\n\n    // Apply regex filter if provided (using cached regex)\n    if (filter) {\n      try {\n        const regex = this.regexCache.getOrCreate(filter)\n        newStdout = newStdout.filter(line => regex.test(line))\n        newStderr = newStderr.filter(line => regex.test(line))\n      } catch (e) {\n        logError(`Invalid regex filter: ${filter}`)\n      }\n    }\n\n    // Update read indices\n    shell.lastReadStdoutIndex = shell.stdout.length\n    shell.lastReadStderrIndex = shell.stderr.length\n\n    return { stdout: newStdout, stderr: newStderr }\n  }\n\n  /**\n   * Get all output (entire buffer)\n   */\n  getAllOutput(shellId: string): {\n    stdout: string[]\n    stderr: string[]\n  } | null {\n    const shell = this.shells.get(shellId)\n    if (!shell) return null\n\n    return {\n      stdout: [...shell.stdout],\n      stderr: [...shell.stderr],\n    }\n  }\n\n  /**\n   * Kill a background shell\n   */\n  kill(shellId: string): boolean {\n    const shell = this.shells.get(shellId)\n    if (!shell) {\n      console.log(\n        `[BackgroundShellManager] Cannot kill: shell ${shellId} not found`,\n      )\n      return false\n    }\n\n    if (shell.status === 'running') {\n      try {\n        const pid = shell.process.pid\n        if (!pid) {\n          console.log(\n            `[BackgroundShellManager] Cannot kill: shell ${shellId} has no PID`,\n          )\n          return false\n        }\n\n        console.log(\n          `[BackgroundShellManager] Killing shell ${shellId} (PID: ${pid}, command: ${shell.command})`,\n        )\n\n        // Kill the process and all its children\n        if (process.platform === 'win32') {\n          spawn('taskkill', ['/pid', pid.toString(), '/f', '/t'])\n        } else {\n          // Send SIGKILL to process group (more forceful than SIGTERM)\n          // The negative PID sends signal to the entire process group\n          try {\n            process.kill(-pid, 'SIGKILL')\n            console.log(\n              `[BackgroundShellManager] Sent SIGKILL to process group -${pid}`,\n            )\n          } catch (e) {\n            // If process group kill fails, try killing just the main process\n            console.log(\n              `[BackgroundShellManager] Process group kill failed, trying main process only`,\n            )\n            process.kill(pid, 'SIGKILL')\n          }\n        }\n\n        shell.status = 'killed'\n        shell.endTime = Date.now()\n        // \uD83D\uDD27 CRITICAL FIX: Clean up listeners when killing shell\n        this.cleanupListeners(shell)\n        this.emit('statusChange', shellId, 'killed')\n        this.emitListChange()\n        return true\n      } catch (error) {\n        console.error(\n          `[BackgroundShellManager] Failed to kill shell ${shellId}:`,\n          error,\n        )\n        logError(`Failed to kill shell ${shellId}: ${error}`)\n        // \uD83D\uDD27 Still try to clean up listeners even on error\n        this.cleanupListeners(shell)\n        return false\n      }\n    }\n\n    console.log(\n      `[BackgroundShellManager] Shell ${shellId} is not running (status: ${shell.status})`,\n    )\n    return false\n  }\n\n  /**\n   * List all background shells\n   */\n  list(): BackgroundShell[] {\n    return Array.from(this.shells.values())\n  }\n\n  /**\n   * Get shell status\n   */\n  getStatus(shellId: string): BackgroundShellStatus | null {\n    const shell = this.shells.get(shellId)\n    return shell ? shell.status : null\n  }\n\n  /**\n   * Remove a shell from the manager (only if done or killed)\n   */\n  remove(shellId: string): boolean {\n    const shell = this.shells.get(shellId)\n    if (!shell || shell.status === 'running') return false\n\n    // \uD83D\uDD27 CRITICAL FIX: Clean up listeners before removing\n    this.cleanupListeners(shell)\n    this.shells.delete(shellId)\n    this.emit('shellRemoved', shellId)\n    this.emitListChange()\n    return true\n  }\n\n  /**\n   * Clean up old completed/killed shells\n   */\n  cleanup(maxAge: number = 3600000): number {\n    const now = Date.now()\n    let removed = 0\n\n    for (const [shellId, shell] of this.shells.entries()) {\n      if (\n        shell.status !== 'running' &&\n        shell.endTime &&\n        now - shell.endTime > maxAge\n      ) {\n        // \uD83D\uDD27 CRITICAL FIX: Clean up listeners before deleting\n        this.cleanupListeners(shell)\n        this.shells.delete(shellId)\n        removed++\n      }\n    }\n\n    if (removed > 0) {\n      this.emit('cleaned', removed)\n      this.emitListChange()\n    }\n\n    return removed\n  }\n\n  /**\n   * Get summary of shell for display\n   */\n  getSummary(shellId: string): string | null {\n    const shell = this.shells.get(shellId)\n    if (!shell) return null\n\n    const duration = shell.endTime\n      ? Math.floor((shell.endTime - shell.startTime) / 1000)\n      : Math.floor((Date.now() - shell.startTime) / 1000)\n\n    // Get last few lines of output for preview\n    const lastLines = shell.stdout.slice(-2).join(' ').slice(0, 50)\n    const preview = lastLines ? ` ${lastLines}\u2026` : ''\n\n    return `${shell.command}${preview}`\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/utils/CircuitBreaker.js

@@ -0,0 +1,242 @@
+class CircuitOpenError extends Error {
+  constructor(remainingCooldown, serverName) {
+    const message = serverName ? `Circuit breaker for "${serverName}" is open. Retry in ${Math.ceil(remainingCooldown / 1e3)}s` : `Circuit breaker is open. Retry in ${Math.ceil(remainingCooldown / 1e3)}s`;
+    super(message);
+    this.remainingCooldown = remainingCooldown;
+    this.name = "CircuitOpenError";
+  }
+}
+class CircuitBreaker {
+  state = "closed";
+  failureCount = 0;
+  successCount = 0;
+  lastFailureTime = null;
+  config;
+  listeners = /* @__PURE__ */ new Set();
+  name;
+  totalRequests = 0;
+  totalFailures = 0;
+  constructor(name = "default", config) {
+    this.name = name;
+    this.config = {
+      failureThreshold: config?.failureThreshold ?? 5,
+      successThreshold: config?.successThreshold ?? 2,
+      openTimeout: config?.openTimeout ?? 3e4,
+      halfOpenTimeout: config?.halfOpenTimeout ?? 3e4
+    };
+  }
+  /**
+   * Execute an operation through the circuit breaker
+   * @throws {CircuitOpenError} If circuit is open
+   * @throws {Error} If operation fails
+   */
+  async execute(operation) {
+    this.totalRequests++;
+    if (this.state === "open") {
+      const cooldownRemaining = this.getRemainingCooldown();
+      if (cooldownRemaining <= 0) {
+        this.transition("half-open");
+      } else {
+        const error = new CircuitOpenError(cooldownRemaining, this.name);
+        this.notifyListeners("failure", { error });
+        throw error;
+      }
+    }
+    try {
+      const result = await operation();
+      this.onSuccess();
+      return result;
+    } catch (error) {
+      this.onFailure(error instanceof Error ? error : new Error(String(error)));
+      throw error;
+    }
+  }
+  /**
+   * Execute with timeout protection
+   * @throws {CircuitOpenError} If circuit is open
+   * @throws {Error} If operation times out or fails
+   */
+  async executeWithTimeout(operation, timeoutMs) {
+    const timeout = timeoutMs ?? this.config.halfOpenTimeout;
+    if (!timeout) {
+      return this.execute(operation);
+    }
+    return Promise.race([
+      this.execute(operation),
+      new Promise(
+        (_, reject) => setTimeout(
+          () => reject(new Error(`Operation timeout after ${timeout}ms`)),
+          timeout
+        )
+      )
+    ]);
+  }
+  /**
+   * Get current circuit state
+   */
+  getState() {
+    return this.state;
+  }
+  /**
+   * Get detailed statistics
+   */
+  getStats() {
+    return {
+      state: this.state,
+      failureCount: this.failureCount,
+      successCount: this.successCount,
+      lastFailureTime: this.lastFailureTime,
+      totalRequests: this.totalRequests,
+      totalFailures: this.totalFailures
+    };
+  }
+  /**
+   * Get remaining cooldown time in milliseconds
+   */
+  getRemainingCooldown() {
+    if (!this.lastFailureTime) {
+      return 0;
+    }
+    return Math.max(
+      0,
+      this.config.openTimeout - (Date.now() - this.lastFailureTime)
+    );
+  }
+  /**
+   * Register a listener for state changes and events
+   */
+  on(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  /**
+   * Reset the circuit breaker to CLOSED state
+   */
+  reset() {
+    const previousState = this.state;
+    this.state = "closed";
+    this.failureCount = 0;
+    this.successCount = 0;
+    this.lastFailureTime = null;
+    this.totalRequests = 0;
+    this.totalFailures = 0;
+    this.notifyListeners("state-change", {
+      state: this.state,
+      previousState
+    });
+  }
+  /**
+   * Manually open the circuit (for testing or explicit fault injection)
+   */
+  forceOpen() {
+    this.transition("open");
+  }
+  /**
+   * Manually close the circuit (for recovery testing)
+   */
+  forceClosed() {
+    this.transition("closed");
+  }
+  /**
+   * Manually transition to half-open state (for testing)
+   */
+  forceHalfOpen() {
+    this.transition("half-open");
+  }
+  // Private methods
+  transition(newState) {
+    if (newState === this.state) {
+      return;
+    }
+    const previousState = this.state;
+    this.state = newState;
+    if (newState === "closed") {
+      this.failureCount = 0;
+      this.successCount = 0;
+    } else if (newState === "half-open") {
+      this.successCount = 0;
+      this.failureCount = 0;
+    }
+    this.notifyListeners("state-change", {
+      state: newState,
+      previousState
+    });
+  }
+  onSuccess() {
+    if (this.state === "half-open") {
+      this.successCount++;
+      if (this.successCount >= this.config.successThreshold) {
+        this.transition("closed");
+      }
+    } else if (this.state === "closed") {
+      this.failureCount = 0;
+    }
+    this.notifyListeners("success", {});
+  }
+  onFailure(error) {
+    this.failureCount++;
+    this.totalFailures++;
+    this.lastFailureTime = Date.now();
+    if (this.state === "closed") {
+      if (this.failureCount >= this.config.failureThreshold) {
+        this.transition("open");
+      }
+    } else if (this.state === "half-open") {
+      this.transition("open");
+    }
+    this.notifyListeners("failure", { error });
+  }
+  notifyListeners(event, details) {
+    for (const listener of this.listeners) {
+      try {
+        listener(event, details);
+      } catch {
+      }
+    }
+  }
+}
+class CircuitBreakerRegistry {
+  breakers = /* @__PURE__ */ new Map();
+  defaultConfig;
+  constructor(defaultConfig) {
+    this.defaultConfig = defaultConfig;
+  }
+  /**
+   * Get or create a circuit breaker by name
+   */
+  getOrCreate(name, config) {
+    if (!this.breakers.has(name)) {
+      const mergedConfig = { ...this.defaultConfig, ...config };
+      this.breakers.set(name, new CircuitBreaker(name, mergedConfig));
+    }
+    return this.breakers.get(name);
+  }
+  /**
+   * Get all registered circuit breakers
+   */
+  getAll() {
+    return new Map(this.breakers);
+  }
+  /**
+   * Reset all circuit breakers
+   */
+  resetAll() {
+    for (const breaker of this.breakers.values()) {
+      breaker.reset();
+    }
+  }
+  /**
+   * Clear all circuit breakers
+   */
+  clear() {
+    this.breakers.clear();
+  }
+}
+export {
+  CircuitBreaker,
+  CircuitBreakerRegistry,
+  CircuitOpenError
+};
+//# sourceMappingURL=CircuitBreaker.js.map

package/dist/utils/CircuitBreaker.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/CircuitBreaker.ts"],
+  "sourcesContent": ["/**\n * Circuit Breaker pattern implementation for handling failing services gracefully\n *\n * States:\n * - CLOSED: Service is healthy, requests pass through normally\n * - OPEN: Service is unhealthy, requests fail immediately\n * - HALF_OPEN: Testing if service has recovered, limited requests allowed\n *\n * Transitions:\n * - CLOSED \u2192 OPEN: When failure count exceeds threshold\n * - OPEN \u2192 HALF_OPEN: After cooldown timeout\n * - HALF_OPEN \u2192 CLOSED: When success count exceeds threshold\n * - HALF_OPEN \u2192 OPEN: When a request fails\n */\n\nexport interface CircuitBreakerConfig {\n  /** Number of failures that trigger opening the circuit (default: 5) */\n  failureThreshold: number\n  /** Number of successful requests needed to close circuit from HALF_OPEN (default: 2) */\n  successThreshold: number\n  /** Time in ms before transitioning from OPEN to HALF_OPEN (default: 30000) */\n  openTimeout: number\n  /** Optional timeout in ms for operations (default: none) */\n  halfOpenTimeout?: number\n}\n\nexport class CircuitOpenError extends Error {\n  constructor(\n    public readonly remainingCooldown: number,\n    serverName?: string,\n  ) {\n    const message = serverName\n      ? `Circuit breaker for \"${serverName}\" is open. Retry in ${Math.ceil(remainingCooldown / 1000)}s`\n      : `Circuit breaker is open. Retry in ${Math.ceil(remainingCooldown / 1000)}s`\n    super(message)\n    this.name = 'CircuitOpenError'\n  }\n}\n\nexport type CircuitBreakerState = 'closed' | 'open' | 'half-open'\n\nexport interface CircuitBreakerStats {\n  state: CircuitBreakerState\n  failureCount: number\n  successCount: number\n  lastFailureTime: number | null\n  totalRequests: number\n  totalFailures: number\n}\n\nexport type CircuitBreakerListener = (\n  event: 'state-change' | 'failure' | 'success',\n  details: {\n    state?: CircuitBreakerState\n    previousState?: CircuitBreakerState\n    error?: Error\n  },\n) => void\n\n/**\n * Circuit Breaker implementation for fault tolerance\n *\n * Prevents cascading failures by failing fast when a service is unhealthy,\n * while automatically attempting recovery when the service potentially recovers.\n */\nexport class CircuitBreaker<T = unknown> {\n  private state: CircuitBreakerState = 'closed'\n  private failureCount: number = 0\n  private successCount: number = 0\n  private lastFailureTime: number | null = null\n  private readonly config: Required<CircuitBreakerConfig>\n  private readonly listeners: Set<CircuitBreakerListener> = new Set()\n  private readonly name: string\n  private totalRequests: number = 0\n  private totalFailures: number = 0\n\n  constructor(\n    name: string = 'default',\n    config?: Partial<CircuitBreakerConfig>,\n  ) {\n    this.name = name\n    this.config = {\n      failureThreshold: config?.failureThreshold ?? 5,\n      successThreshold: config?.successThreshold ?? 2,\n      openTimeout: config?.openTimeout ?? 30000,\n      halfOpenTimeout: config?.halfOpenTimeout ?? 30000,\n    }\n  }\n\n  /**\n   * Execute an operation through the circuit breaker\n   * @throws {CircuitOpenError} If circuit is open\n   * @throws {Error} If operation fails\n   */\n  async execute<R>(operation: () => Promise<R>): Promise<R> {\n    this.totalRequests++\n\n    // Check if we need to transition from OPEN to HALF_OPEN\n    if (this.state === 'open') {\n      const cooldownRemaining = this.getRemainingCooldown()\n      if (cooldownRemaining <= 0) {\n        this.transition('half-open')\n      } else {\n        const error = new CircuitOpenError(cooldownRemaining, this.name)\n        this.notifyListeners('failure', { error })\n        throw error\n      }\n    }\n\n    // Execute the operation\n    try {\n      const result = await operation()\n      this.onSuccess()\n      return result\n    } catch (error) {\n      this.onFailure(error instanceof Error ? error : new Error(String(error)))\n      throw error\n    }\n  }\n\n  /**\n   * Execute with timeout protection\n   * @throws {CircuitOpenError} If circuit is open\n   * @throws {Error} If operation times out or fails\n   */\n  async executeWithTimeout<R>(\n    operation: () => Promise<R>,\n    timeoutMs?: number,\n  ): Promise<R> {\n    const timeout = timeoutMs ?? this.config.halfOpenTimeout\n    if (!timeout) {\n      return this.execute(operation)\n    }\n\n    return Promise.race([\n      this.execute(operation),\n      new Promise<R>((_, reject) =>\n        setTimeout(\n          () => reject(new Error(`Operation timeout after ${timeout}ms`)),\n          timeout,\n        ),\n      ),\n    ])\n  }\n\n  /**\n   * Get current circuit state\n   */\n  getState(): CircuitBreakerState {\n    return this.state\n  }\n\n  /**\n   * Get detailed statistics\n   */\n  getStats(): CircuitBreakerStats {\n    return {\n      state: this.state,\n      failureCount: this.failureCount,\n      successCount: this.successCount,\n      lastFailureTime: this.lastFailureTime,\n      totalRequests: this.totalRequests,\n      totalFailures: this.totalFailures,\n    }\n  }\n\n  /**\n   * Get remaining cooldown time in milliseconds\n   */\n  getRemainingCooldown(): number {\n    if (!this.lastFailureTime) {\n      return 0\n    }\n    return Math.max(\n      0,\n      this.config.openTimeout - (Date.now() - this.lastFailureTime),\n    )\n  }\n\n  /**\n   * Register a listener for state changes and events\n   */\n  on(listener: CircuitBreakerListener): () => void {\n    this.listeners.add(listener)\n    return () => {\n      this.listeners.delete(listener)\n    }\n  }\n\n  /**\n   * Reset the circuit breaker to CLOSED state\n   */\n  reset(): void {\n    const previousState = this.state\n    this.state = 'closed'\n    this.failureCount = 0\n    this.successCount = 0\n    this.lastFailureTime = null\n    this.totalRequests = 0\n    this.totalFailures = 0\n\n    this.notifyListeners('state-change', {\n      state: this.state,\n      previousState,\n    })\n  }\n\n  /**\n   * Manually open the circuit (for testing or explicit fault injection)\n   */\n  forceOpen(): void {\n    this.transition('open')\n  }\n\n  /**\n   * Manually close the circuit (for recovery testing)\n   */\n  forceClosed(): void {\n    this.transition('closed')\n  }\n\n  /**\n   * Manually transition to half-open state (for testing)\n   */\n  forceHalfOpen(): void {\n    this.transition('half-open')\n  }\n\n  // Private methods\n\n  private transition(newState: CircuitBreakerState): void {\n    if (newState === this.state) {\n      return\n    }\n\n    const previousState = this.state\n    this.state = newState\n\n    // Reset counters on state transition\n    if (newState === 'closed') {\n      this.failureCount = 0\n      this.successCount = 0\n    } else if (newState === 'half-open') {\n      this.successCount = 0\n      this.failureCount = 0\n    }\n\n    this.notifyListeners('state-change', {\n      state: newState,\n      previousState,\n    })\n  }\n\n  private onSuccess(): void {\n    if (this.state === 'half-open') {\n      this.successCount++\n      if (this.successCount >= this.config.successThreshold) {\n        this.transition('closed')\n      }\n    } else if (this.state === 'closed') {\n      this.failureCount = 0\n    }\n\n    this.notifyListeners('success', {})\n  }\n\n  private onFailure(error: Error): void {\n    this.failureCount++\n    this.totalFailures++\n    this.lastFailureTime = Date.now()\n\n    if (this.state === 'closed') {\n      if (this.failureCount >= this.config.failureThreshold) {\n        this.transition('open')\n      }\n    } else if (this.state === 'half-open') {\n      // Any failure in half-open state goes back to open\n      this.transition('open')\n    }\n\n    this.notifyListeners('failure', { error })\n  }\n\n  private notifyListeners(\n    event: 'state-change' | 'failure' | 'success',\n    details: {\n      state?: CircuitBreakerState\n      previousState?: CircuitBreakerState\n      error?: Error\n    },\n  ): void {\n    for (const listener of this.listeners) {\n      try {\n        listener(event, details)\n      } catch {\n        // Ignore listener errors to prevent them from affecting the circuit\n      }\n    }\n  }\n}\n\n/**\n * Create a simple factory for managing multiple circuit breakers\n */\nexport class CircuitBreakerRegistry {\n  private readonly breakers = new Map<string, CircuitBreaker>()\n  private readonly defaultConfig?: Partial<CircuitBreakerConfig>\n\n  constructor(defaultConfig?: Partial<CircuitBreakerConfig>) {\n    this.defaultConfig = defaultConfig\n  }\n\n  /**\n   * Get or create a circuit breaker by name\n   */\n  getOrCreate(\n    name: string,\n    config?: Partial<CircuitBreakerConfig>,\n  ): CircuitBreaker {\n    if (!this.breakers.has(name)) {\n      const mergedConfig = { ...this.defaultConfig, ...config }\n      this.breakers.set(name, new CircuitBreaker(name, mergedConfig))\n    }\n    return this.breakers.get(name)!\n  }\n\n  /**\n   * Get all registered circuit breakers\n   */\n  getAll(): Map<string, CircuitBreaker> {\n    return new Map(this.breakers)\n  }\n\n  /**\n   * Reset all circuit breakers\n   */\n  resetAll(): void {\n    for (const breaker of this.breakers.values()) {\n      breaker.reset()\n    }\n  }\n\n  /**\n   * Clear all circuit breakers\n   */\n  clear(): void {\n    this.breakers.clear()\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}