@ai-devkit/agent-manager 0.32.0 → 0.33.0

package/src/terminal/TerminalFocusManager.ts

@@ -1,22 +1,22 @@
-import { execFile } from 'child_process';
-import { promisify } from 'util';
-import { getProcessTty } from '../utils/process.js';
-import { escapeAppleScript } from '../utils/applescript.js';
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { getProcessTty } from "../utils/process.js";
+import { escapeAppleScript } from "../utils/applescript.js";
 
 const execFileAsync = promisify(execFile);
 
 export enum TerminalType {
-    TMUX = 'tmux',
-    WEZTERM = 'wezterm',
-    ITERM2 = 'iterm2',
-    TERMINAL_APP = 'terminal-app',
-    UNKNOWN = 'unknown',
+  TMUX = "tmux",
+  WEZTERM = "wezterm",
+  ITERM2 = "iterm2",
+  TERMINAL_APP = "terminal-app",
+  UNKNOWN = "unknown",
 }
 
 export interface TerminalLocation {
-    type: TerminalType;
-    identifier: string; // e.g., "session:window.pane" for tmux, WezTerm pane id, or TTY for others
-    tty: string;        // e.g., "/dev/ttys030"
+  type: TerminalType;
+  identifier: string; // e.g., "session:window.pane" for tmux, WezTerm pane id, or TTY for others
+  tty: string; // e.g., "/dev/ttys030"
 }
 
 /**
@@ -26,8 +26,8 @@ export interface TerminalLocation {
  * the JSON, not `tty`.)
  */
 interface WeztermPaneEntry {
-    pane_id?: number;
-    tty_name?: string | null;
+  pane_id?: number;
+  tty_name?: string | null;
 }
 
 /**
@@ -38,167 +38,170 @@ interface WeztermPaneEntry {
 export type TerminalDebugLogger = (message: string) => void;
 
 export class TerminalFocusManager {
-    constructor(private readonly debug?: TerminalDebugLogger) {}
+  constructor(private readonly debug?: TerminalDebugLogger) {}
 
-    /**
-     * Find the terminal location (emulator info) for a given process ID
-     */
-    async findTerminal(pid: number): Promise<TerminalLocation | null> {
-        const ttyShort = getProcessTty(pid);
+  /**
+   * Find the terminal location (emulator info) for a given process ID
+   */
+  async findTerminal(pid: number): Promise<TerminalLocation | null> {
+    const ttyShort = getProcessTty(pid);
 
-        // If no TTY or invalid, we can't find the terminal
-        if (!ttyShort || ttyShort === '?') {
-            this.debug?.(`findTerminal(pid=${pid}): no usable TTY, cannot resolve terminal`);
-            return null;
-        }
-
-        const fullTty = `/dev/${ttyShort}`;
-        this.debug?.(`findTerminal(pid=${pid}): resolving terminal for ${fullTty}`);
+    // If no TTY or invalid, we can't find the terminal
+    if (!ttyShort || ttyShort === "?") {
+      this.debug?.(`findTerminal(pid=${pid}): no usable TTY, cannot resolve terminal`);
+      return null;
+    }
 
-        // 1. Check tmux (most specific if running inside it)
-        const tmuxLocation = await this.findTmuxPane(fullTty);
-        if (tmuxLocation) {
-            this.debug?.(`findTerminal: matched tmux (identifier=${tmuxLocation.identifier})`);
-            return tmuxLocation;
-        }
-        this.debug?.('findTerminal: tmux no match');
+    const fullTty = `/dev/${ttyShort}`;
+    this.debug?.(`findTerminal(pid=${pid}): resolving terminal for ${fullTty}`);
 
-        // 2. Check WezTerm (cross-platform, via its CLI — no AppleScript)
-        const weztermLocation = await this.findWeztermPane(fullTty);
-        if (weztermLocation) {
-            this.debug?.(`findTerminal: matched wezterm (pane_id=${weztermLocation.identifier})`);
-            return weztermLocation;
-        }
-        this.debug?.('findTerminal: wezterm no match');
+    // 1. Check tmux (most specific if running inside it)
+    const tmuxLocation = await this.findTmuxPane(fullTty);
+    if (tmuxLocation) {
+      this.debug?.(`findTerminal: matched tmux (identifier=${tmuxLocation.identifier})`);
+      return tmuxLocation;
+    }
+    this.debug?.("findTerminal: tmux no match");
 
-        // 3. Check iTerm2
-        const itermLocation = await this.findITerm2Session(fullTty);
-        if (itermLocation) {
-            this.debug?.(`findTerminal: matched iTerm2 (tty=${itermLocation.tty})`);
-            return itermLocation;
-        }
-        this.debug?.('findTerminal: iTerm2 no match');
+    // 2. Check WezTerm (cross-platform, via its CLI — no AppleScript)
+    const weztermLocation = await this.findWeztermPane(fullTty);
+    if (weztermLocation) {
+      this.debug?.(`findTerminal: matched wezterm (pane_id=${weztermLocation.identifier})`);
+      return weztermLocation;
+    }
+    this.debug?.("findTerminal: wezterm no match");
 
-        // 4. Check Terminal.app
-        const terminalAppLocation = await this.findTerminalAppWindow(fullTty);
-        if (terminalAppLocation) {
-            this.debug?.(`findTerminal: matched Terminal.app (tty=${terminalAppLocation.tty})`);
-            return terminalAppLocation;
-        }
-        this.debug?.('findTerminal: Terminal.app no match');
+    // 3. Check iTerm2
+    const itermLocation = await this.findITerm2Session(fullTty);
+    if (itermLocation) {
+      this.debug?.(`findTerminal: matched iTerm2 (tty=${itermLocation.tty})`);
+      return itermLocation;
+    }
+    this.debug?.("findTerminal: iTerm2 no match");
 
-        // 5. Fallback: we know the TTY but not the emulator wrapper
-        this.debug?.('findTerminal: no emulator matched; returning UNKNOWN');
-        return {
-            type: TerminalType.UNKNOWN,
-            identifier: '',
-            tty: fullTty
-        };
+    // 4. Check Terminal.app
+    const terminalAppLocation = await this.findTerminalAppWindow(fullTty);
+    if (terminalAppLocation) {
+      this.debug?.(`findTerminal: matched Terminal.app (tty=${terminalAppLocation.tty})`);
+      return terminalAppLocation;
     }
+    this.debug?.("findTerminal: Terminal.app no match");
 
-    /**
-     * Focus the terminal identified by the location
-     */
-    async focusTerminal(location: TerminalLocation): Promise<boolean> {
-        this.debug?.(`focusTerminal: focusing ${location.type} (identifier=${location.identifier}, tty=${location.tty})`);
-        let success = false;
-        try {
-            switch (location.type) {
-                case TerminalType.TMUX:
-                    success = await this.focusTmuxPane(location.identifier);
-                    break;
-                case TerminalType.WEZTERM:
-                    success = await this.focusWeztermPane(location.identifier);
-                    break;
-                case TerminalType.ITERM2:
-                    success = await this.focusITerm2Session(location.tty);
-                    break;
-                case TerminalType.TERMINAL_APP:
-                    success = await this.focusTerminalAppWindow(location.tty);
-                    break;
-                default:
-                    success = false;
-            }
-        } catch {
-            success = false;
-        }
-        this.debug?.(`focusTerminal: ${success ? 'succeeded' : 'failed'} for ${location.type}`);
-        return success;
+    // 5. Fallback: we know the TTY but not the emulator wrapper
+    this.debug?.("findTerminal: no emulator matched; returning UNKNOWN");
+    return {
+      type: TerminalType.UNKNOWN,
+      identifier: "",
+      tty: fullTty,
+    };
+  }
+
+  /**
+   * Focus the terminal identified by the location
+   */
+  async focusTerminal(location: TerminalLocation): Promise<boolean> {
+    this.debug?.(
+      `focusTerminal: focusing ${location.type} (identifier=${location.identifier}, tty=${location.tty})`,
+    );
+    let success = false;
+    try {
+      switch (location.type) {
+        case TerminalType.TMUX:
+          success = await this.focusTmuxPane(location.identifier);
+          break;
+        case TerminalType.WEZTERM:
+          success = await this.focusWeztermPane(location.identifier);
+          break;
+        case TerminalType.ITERM2:
+          success = await this.focusITerm2Session(location.tty);
+          break;
+        case TerminalType.TERMINAL_APP:
+          success = await this.focusTerminalAppWindow(location.tty);
+          break;
+        default:
+          success = false;
+      }
+    } catch {
+      success = false;
     }
+    this.debug?.(`focusTerminal: ${success ? "succeeded" : "failed"} for ${location.type}`);
+    return success;
+  }
 
-    private async findWeztermPane(tty: string): Promise<TerminalLocation | null> {
-        try {
-            const { stdout } = await execFileAsync('wezterm', [
-                'cli', 'list', '--format', 'json',
-            ]);
+  private async findWeztermPane(tty: string): Promise<TerminalLocation | null> {
+    try {
+      const { stdout } = await execFileAsync("wezterm", ["cli", "list", "--format", "json"]);
 
-            const panes = JSON.parse(stdout) as WeztermPaneEntry[];
-            if (!Array.isArray(panes)) return null;
+      const panes = JSON.parse(stdout) as WeztermPaneEntry[];
+      if (!Array.isArray(panes)) return null;
 
-            for (const pane of panes) {
-                if (
-                    pane &&
-                    typeof pane.tty_name === 'string' &&
-                    pane.tty_name === tty &&
-                    pane.pane_id != null
-                ) {
-                    return {
-                        type: TerminalType.WEZTERM,
-                        identifier: String(pane.pane_id),
-                        tty,
-                    };
-                }
-            }
-        } catch {
-            // wezterm not installed, not running, or returned invalid JSON
+      for (const pane of panes) {
+        if (
+          pane &&
+          typeof pane.tty_name === "string" &&
+          pane.tty_name === tty &&
+          pane.pane_id != null
+        ) {
+          return {
+            type: TerminalType.WEZTERM,
+            identifier: String(pane.pane_id),
+            tty,
+          };
         }
-        return null;
+      }
+    } catch {
+      // wezterm not installed, not running, or returned invalid JSON
     }
+    return null;
+  }
 
-    private async focusWeztermPane(paneId: string): Promise<boolean> {
-        try {
-            await execFileAsync('wezterm', ['cli', 'activate-pane', '--pane-id', paneId]);
-            return true;
-        } catch {
-            return false;
-        }
+  private async focusWeztermPane(paneId: string): Promise<boolean> {
+    try {
+      await execFileAsync("wezterm", ["cli", "activate-pane", "--pane-id", paneId]);
+      return true;
+    } catch {
+      return false;
     }
+  }
 
-    private async findTmuxPane(tty: string): Promise<TerminalLocation | null> {
-        try {
-            const { stdout } = await execFileAsync('tmux', [
-                'list-panes', '-a', '-F', '#{pane_tty}|#{session_name}:#{window_index}.#{pane_index}'
-            ]);
+  private async findTmuxPane(tty: string): Promise<TerminalLocation | null> {
+    try {
+      const { stdout } = await execFileAsync("tmux", [
+        "list-panes",
+        "-a",
+        "-F",
+        "#{pane_tty}|#{session_name}:#{window_index}.#{pane_index}",
+      ]);
 
-            const lines = stdout.trim().split('\n');
-            for (const line of lines) {
-                if (!line.trim()) continue;
-                const [paneTty, identifier] = line.split('|');
-                if (paneTty === tty && identifier) {
-                    return {
-                        type: TerminalType.TMUX,
-                        identifier,
-                        tty
-                    };
-                }
-            }
-        } catch {
-            // tmux might not be installed or running
+      const lines = stdout.trim().split("\n");
+      for (const line of lines) {
+        if (!line.trim()) continue;
+        const [paneTty, identifier] = line.split("|");
+        if (paneTty === tty && identifier) {
+          return {
+            type: TerminalType.TMUX,
+            identifier,
+            tty,
+          };
         }
-        return null;
+      }
+    } catch {
+      // tmux might not be installed or running
     }
+    return null;
+  }
 
-    private async findITerm2Session(tty: string): Promise<TerminalLocation | null> {
-        try {
-            // Check if iTerm2 is running first to avoid launching it.
-            if (!await this.isProcessRunning('iTerm2')) return null;
-        } catch {
-            return null;
-        }
+  private async findITerm2Session(tty: string): Promise<TerminalLocation | null> {
+    try {
+      // Check if iTerm2 is running first to avoid launching it.
+      if (!(await this.isProcessRunning("iTerm2"))) return null;
+    } catch {
+      return null;
+    }
 
-        try {
-            const escapedTty = escapeAppleScript(tty);
-            const script = `
+    try {
+      const escapedTty = escapeAppleScript(tty);
+      const script = `
         tell application "iTerm"
           repeat with w in windows
             repeat with t in tabs of w
@@ -212,31 +215,31 @@ export class TerminalFocusManager {
         end tell
       `;
 
-            const { stdout } = await execFileAsync('osascript', ['-e', script]);
-            if (stdout.trim() === "found") {
-                return {
-                    type: TerminalType.ITERM2,
-                    identifier: tty,
-                    tty
-                };
-            }
-        } catch {
-            // iTerm2 script failed
-        }
-        return null;
+      const { stdout } = await execFileAsync("osascript", ["-e", script]);
+      if (stdout.trim() === "found") {
+        return {
+          type: TerminalType.ITERM2,
+          identifier: tty,
+          tty,
+        };
+      }
+    } catch {
+      // iTerm2 script failed
     }
+    return null;
+  }
 
-    private async findTerminalAppWindow(tty: string): Promise<TerminalLocation | null> {
-        try {
-            // Check if Terminal.app is running
-            if (!await this.isProcessRunning('Terminal')) return null;
-        } catch {
-            return null;
-        }
+  private async findTerminalAppWindow(tty: string): Promise<TerminalLocation | null> {
+    try {
+      // Check if Terminal.app is running
+      if (!(await this.isProcessRunning("Terminal"))) return null;
+    } catch {
+      return null;
+    }
 
-        try {
-            const escapedTty = escapeAppleScript(tty);
-            const script = `
+    try {
+      const escapedTty = escapeAppleScript(tty);
+      const script = `
         tell application "Terminal"
           repeat with w in windows
             repeat with t in tabs of w
@@ -248,40 +251,40 @@ export class TerminalFocusManager {
         end tell
       `;
 
-            const { stdout } = await execFileAsync('osascript', ['-e', script]);
-            if (stdout.trim() === "found") {
-                return {
-                    type: TerminalType.TERMINAL_APP,
-                    identifier: tty,
-                    tty
-                };
-            }
-        } catch {
-            // Terminal.app script failed
-        }
-        return null;
+      const { stdout } = await execFileAsync("osascript", ["-e", script]);
+      if (stdout.trim() === "found") {
+        return {
+          type: TerminalType.TERMINAL_APP,
+          identifier: tty,
+          tty,
+        };
+      }
+    } catch {
+      // Terminal.app script failed
     }
+    return null;
+  }
 
-    private async isProcessRunning(name: string): Promise<boolean> {
-        const { stdout } = await execFileAsync('ps', ['-Axo', 'comm']);
-        return stdout
-            .split('\n')
-            .map((line) => line.trim())
-            .some((command) => command === name || command.endsWith(`/${name}`));
-    }
+  private async isProcessRunning(name: string): Promise<boolean> {
+    const { stdout } = await execFileAsync("ps", ["-Axo", "comm"]);
+    return stdout
+      .split("\n")
+      .map((line) => line.trim())
+      .some((command) => command === name || command.endsWith(`/${name}`));
+  }
 
-    private async focusTmuxPane(identifier: string): Promise<boolean> {
-        try {
-            await execFileAsync('tmux', ['switch-client', '-t', identifier]);
-            return true;
-        } catch {
-            return false;
-        }
+  private async focusTmuxPane(identifier: string): Promise<boolean> {
+    try {
+      await execFileAsync("tmux", ["switch-client", "-t", identifier]);
+      return true;
+    } catch {
+      return false;
     }
+  }
 
-    private async focusITerm2Session(tty: string): Promise<boolean> {
-        const escapedTty = escapeAppleScript(tty);
-        const script = `
+  private async focusITerm2Session(tty: string): Promise<boolean> {
+    const escapedTty = escapeAppleScript(tty);
+    const script = `
        tell application "iTerm"
          activate
          repeat with w in windows
@@ -296,13 +299,13 @@ export class TerminalFocusManager {
          end repeat
        end tell
      `;
-        const { stdout } = await execFileAsync('osascript', ['-e', script]);
-        return stdout.trim() === "true";
-    }
+    const { stdout } = await execFileAsync("osascript", ["-e", script]);
+    return stdout.trim() === "true";
+  }
 
-    private async focusTerminalAppWindow(tty: string): Promise<boolean> {
-        const escapedTty = escapeAppleScript(tty);
-        const script = `
+  private async focusTerminalAppWindow(tty: string): Promise<boolean> {
+    const escapedTty = escapeAppleScript(tty);
+    const script = `
        tell application "Terminal"
          activate
          repeat with w in windows
@@ -316,7 +319,7 @@ export class TerminalFocusManager {
          end repeat
        end tell
     `;
-        const { stdout } = await execFileAsync('osascript', ['-e', script]);
-        return stdout.trim() === "true";
-    }
+    const { stdout } = await execFileAsync("osascript", ["-e", script]);
+    return stdout.trim() === "true";
+  }
 }