@ai-devkit/agent-manager 0.37.0 → 0.38.0

package/dist/terminal/TerminalFocusManager.js

@@ -1,296 +1,46 @@
-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 var TerminalType = /*#__PURE__*/ function(TerminalType) {
-    TerminalType["TMUX"] = "tmux";
-    TerminalType["WEZTERM"] = "wezterm";
-    TerminalType["ITERM2"] = "iterm2";
-    TerminalType["TERMINAL_APP"] = "terminal-app";
-    TerminalType["UNKNOWN"] = "unknown";
-    return TerminalType;
-}({});
+import { TERMINAL_BACKENDS, terminalBackendFor } from "./backends/index.js";
+import { TerminalType } from "./types.js";
+export { TerminalType };
 export class TerminalFocusManager {
     debug;
     constructor(debug){
         this.debug = debug;
     }
-    /**
-   * Find the terminal location (emulator info) for a given process ID
-   */ async findTerminal(pid) {
-        const ttyShort = getProcessTty(pid);
-        // If no TTY or invalid, we can't find the terminal
-        if (!ttyShort || ttyShort === "?") {
+    async findTerminal(pid) {
+        const tty = getProcessTty(pid);
+        if (!tty || tty === "?") {
             this.debug?.(`findTerminal(pid=${pid}): no usable TTY, cannot resolve terminal`);
             return null;
         }
-        const fullTty = `/dev/${ttyShort}`;
+        const fullTty = `/dev/${tty}`;
         this.debug?.(`findTerminal(pid=${pid}): resolving terminal for ${fullTty}`);
-        // 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");
-        // 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");
-        // 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");
-        // 4. Check Terminal.app
-        const terminalAppLocation = await this.findTerminalAppWindow(fullTty);
-        if (terminalAppLocation) {
-            this.debug?.(`findTerminal: matched Terminal.app (tty=${terminalAppLocation.tty})`);
-            return terminalAppLocation;
+        for (const backend of TERMINAL_BACKENDS){
+            const location = await backend.find(fullTty);
+            if (location) {
+                this.debug?.(`findTerminal: matched ${backend.label} (identifier=${location.identifier})`);
+                return location;
+            }
+            this.debug?.(`findTerminal: ${backend.label} no match`);
         }
-        this.debug?.("findTerminal: Terminal.app no match");
-        // 5. Fallback: we know the TTY but not the emulator wrapper
         this.debug?.("findTerminal: no emulator matched; returning UNKNOWN");
         return {
-            type: "unknown",
+            type: TerminalType.UNKNOWN,
             identifier: "",
             tty: fullTty
         };
     }
-    /**
-   * Focus the terminal identified by the location
-   */ async focusTerminal(location) {
+    async focusTerminal(location) {
         this.debug?.(`focusTerminal: focusing ${location.type} (identifier=${location.identifier}, tty=${location.tty})`);
         let success = false;
         try {
-            switch(location.type){
-                case "tmux":
-                    success = await this.focusTmuxPane(location.identifier);
-                    break;
-                case "wezterm":
-                    success = await this.focusWeztermPane(location.identifier);
-                    break;
-                case "iterm2":
-                    success = await this.focusITerm2Session(location.tty);
-                    break;
-                case "terminal-app":
-                    success = await this.focusTerminalAppWindow(location.tty);
-                    break;
-                default:
-                    success = false;
-            }
+            success = await terminalBackendFor(location.type)?.focus(location) ?? false;
         } catch  {
             success = false;
         }
         this.debug?.(`focusTerminal: ${success ? "succeeded" : "failed"} for ${location.type}`);
         return success;
     }
-    async findWeztermPane(tty) {
-        try {
-            const { stdout } = await execFileAsync("wezterm", [
-                "cli",
-                "list",
-                "--format",
-                "json"
-            ]);
-            const panes = JSON.parse(stdout);
-            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: "wezterm",
-                        identifier: String(pane.pane_id),
-                        tty
-                    };
-                }
-            }
-        } catch  {
-        // wezterm not installed, not running, or returned invalid JSON
-        }
-        return null;
-    }
-    async focusWeztermPane(paneId) {
-        try {
-            await execFileAsync("wezterm", [
-                "cli",
-                "activate-pane",
-                "--pane-id",
-                paneId
-            ]);
-            return true;
-        } catch  {
-            return false;
-        }
-    }
-    async findTmuxPane(tty) {
-        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: "tmux",
-                        identifier,
-                        tty
-                    };
-                }
-            }
-        } catch  {
-        // tmux might not be installed or running
-        }
-        return null;
-    }
-    async findITerm2Session(tty) {
-        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 = `
-        tell application "iTerm"
-          repeat with w in windows
-            repeat with t in tabs of w
-              repeat with s in sessions of t
-                if tty of s is "${escapedTty}" then
-                  return "found"
-                end if
-              end repeat
-            end repeat
-          end repeat
-        end tell
-      `;
-            const { stdout } = await execFileAsync("osascript", [
-                "-e",
-                script
-            ]);
-            if (stdout.trim() === "found") {
-                return {
-                    type: "iterm2",
-                    identifier: tty,
-                    tty
-                };
-            }
-        } catch  {
-        // iTerm2 script failed
-        }
-        return null;
-    }
-    async findTerminalAppWindow(tty) {
-        try {
-            // Check if Terminal.app is running
-            if (!await this.isProcessRunning("Terminal")) return null;
-        } catch  {
-            return null;
-        }
-        try {
-            const escapedTty = escapeAppleScript(tty);
-            const script = `
-        tell application "Terminal"
-          repeat with w in windows
-            repeat with t in tabs of w
-              if tty of t is "${escapedTty}" then
-                return "found"
-              end if
-            end repeat
-          end repeat
-        end tell
-      `;
-            const { stdout } = await execFileAsync("osascript", [
-                "-e",
-                script
-            ]);
-            if (stdout.trim() === "found") {
-                return {
-                    type: "terminal-app",
-                    identifier: tty,
-                    tty
-                };
-            }
-        } catch  {
-        // Terminal.app script failed
-        }
-        return null;
-    }
-    async isProcessRunning(name) {
-        const { stdout } = await execFileAsync("ps", [
-            "-Axo",
-            "comm"
-        ]);
-        return stdout.split("\n").map((line)=>line.trim()).some((command)=>command === name || command.endsWith(`/${name}`));
-    }
-    async focusTmuxPane(identifier) {
-        try {
-            await execFileAsync("tmux", [
-                "switch-client",
-                "-t",
-                identifier
-            ]);
-            return true;
-        } catch  {
-            return false;
-        }
-    }
-    async focusITerm2Session(tty) {
-        const escapedTty = escapeAppleScript(tty);
-        const script = `
-       tell application "iTerm"
-         activate
-         repeat with w in windows
-           repeat with t in tabs of w
-             repeat with s in sessions of t
-               if tty of s is "${escapedTty}" then
-                 select s
-                 return "true"
-               end if
-             end repeat
-           end repeat
-         end repeat
-       end tell
-     `;
-        const { stdout } = await execFileAsync("osascript", [
-            "-e",
-            script
-        ]);
-        return stdout.trim() === "true";
-    }
-    async focusTerminalAppWindow(tty) {
-        const escapedTty = escapeAppleScript(tty);
-        const script = `
-       tell application "Terminal"
-         activate
-         repeat with w in windows
-           repeat with t in tabs of w
-             if tty of t is "${escapedTty}" then
-               set index of w to 1
-               set selected tab of w to t
-               return "true"
-             end if
-           end repeat
-         end repeat
-       end tell
-    `;
-        const { stdout } = await execFileAsync("osascript", [
-            "-e",
-            script
-        ]);
-        return stdout.trim() === "true";
-    }
 }
 
 //# sourceMappingURL=TerminalFocusManager.js.map

package/dist/terminal/TerminalFocusManager.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/terminal/TerminalFocusManager.ts"],"sourcesContent":["import { execFile } from \"child_process\";\nimport { promisify } from \"util\";\nimport { getProcessTty } from \"../utils/process.js\";\nimport { escapeAppleScript } from \"../utils/applescript.js\";\n\nconst execFileAsync = promisify(execFile);\n\nexport enum TerminalType {\n  TMUX = \"tmux\",\n  WEZTERM = \"wezterm\",\n  ITERM2 = \"iterm2\",\n  TERMINAL_APP = \"terminal-app\",\n  UNKNOWN = \"unknown\",\n}\n\nexport interface TerminalLocation {\n  type: TerminalType;\n  identifier: string; // e.g., \"session:window.pane\" for tmux, WezTerm pane id, or TTY for others\n  tty: string; // e.g., \"/dev/ttys030\"\n}\n\n/**\n * Subset of a `wezterm cli list --format json` entry. Only `pane_id` and\n * `tty_name` are read; extra fields are ignored so schema additions across\n * WezTerm versions don't break parsing. (The TTY is exposed as `tty_name` in\n * the JSON, not `tty`.)\n */\ninterface WeztermPaneEntry {\n  pane_id?: number;\n  tty_name?: string | null;\n}\n\n/**\n * Optional trace sink. When provided to {@link TerminalFocusManager}, each\n * discovery/focus step reports a human-readable line so callers (e.g. the\n * `agent open --debug` command) can inspect the matching/focus decision path.\n */\nexport type TerminalDebugLogger = (message: string) => void;\n\nexport class TerminalFocusManager {\n  constructor(private readonly debug?: TerminalDebugLogger) {}\n\n  /**\n   * Find the terminal location (emulator info) for a given process ID\n   */\n  async findTerminal(pid: number): Promise<TerminalLocation | null> {\n    const ttyShort = getProcessTty(pid);\n\n    // If no TTY or invalid, we can't find the terminal\n    if (!ttyShort || ttyShort === \"?\") {\n      this.debug?.(`findTerminal(pid=${pid}): no usable TTY, cannot resolve terminal`);\n      return null;\n    }\n\n    const fullTty = `/dev/${ttyShort}`;\n    this.debug?.(`findTerminal(pid=${pid}): resolving terminal for ${fullTty}`);\n\n    // 1. Check tmux (most specific if running inside it)\n    const tmuxLocation = await this.findTmuxPane(fullTty);\n    if (tmuxLocation) {\n      this.debug?.(`findTerminal: matched tmux (identifier=${tmuxLocation.identifier})`);\n      return tmuxLocation;\n    }\n    this.debug?.(\"findTerminal: tmux no match\");\n\n    // 2. Check WezTerm (cross-platform, via its CLI — no AppleScript)\n    const weztermLocation = await this.findWeztermPane(fullTty);\n    if (weztermLocation) {\n      this.debug?.(`findTerminal: matched wezterm (pane_id=${weztermLocation.identifier})`);\n      return weztermLocation;\n    }\n    this.debug?.(\"findTerminal: wezterm no match\");\n\n    // 3. Check iTerm2\n    const itermLocation = await this.findITerm2Session(fullTty);\n    if (itermLocation) {\n      this.debug?.(`findTerminal: matched iTerm2 (tty=${itermLocation.tty})`);\n      return itermLocation;\n    }\n    this.debug?.(\"findTerminal: iTerm2 no match\");\n\n    // 4. Check Terminal.app\n    const terminalAppLocation = await this.findTerminalAppWindow(fullTty);\n    if (terminalAppLocation) {\n      this.debug?.(`findTerminal: matched Terminal.app (tty=${terminalAppLocation.tty})`);\n      return terminalAppLocation;\n    }\n    this.debug?.(\"findTerminal: Terminal.app no match\");\n\n    // 5. Fallback: we know the TTY but not the emulator wrapper\n    this.debug?.(\"findTerminal: no emulator matched; returning UNKNOWN\");\n    return {\n      type: TerminalType.UNKNOWN,\n      identifier: \"\",\n      tty: fullTty,\n    };\n  }\n\n  /**\n   * Focus the terminal identified by the location\n   */\n  async focusTerminal(location: TerminalLocation): Promise<boolean> {\n    this.debug?.(\n      `focusTerminal: focusing ${location.type} (identifier=${location.identifier}, tty=${location.tty})`,\n    );\n    let success = false;\n    try {\n      switch (location.type) {\n        case TerminalType.TMUX:\n          success = await this.focusTmuxPane(location.identifier);\n          break;\n        case TerminalType.WEZTERM:\n          success = await this.focusWeztermPane(location.identifier);\n          break;\n        case TerminalType.ITERM2:\n          success = await this.focusITerm2Session(location.tty);\n          break;\n        case TerminalType.TERMINAL_APP:\n          success = await this.focusTerminalAppWindow(location.tty);\n          break;\n        default:\n          success = false;\n      }\n    } catch {\n      success = false;\n    }\n    this.debug?.(`focusTerminal: ${success ? \"succeeded\" : \"failed\"} for ${location.type}`);\n    return success;\n  }\n\n  private async findWeztermPane(tty: string): Promise<TerminalLocation | null> {\n    try {\n      const { stdout } = await execFileAsync(\"wezterm\", [\"cli\", \"list\", \"--format\", \"json\"]);\n\n      const panes = JSON.parse(stdout) as WeztermPaneEntry[];\n      if (!Array.isArray(panes)) return null;\n\n      for (const pane of panes) {\n        if (\n          pane &&\n          typeof pane.tty_name === \"string\" &&\n          pane.tty_name === tty &&\n          pane.pane_id != null\n        ) {\n          return {\n            type: TerminalType.WEZTERM,\n            identifier: String(pane.pane_id),\n            tty,\n          };\n        }\n      }\n    } catch {\n      // wezterm not installed, not running, or returned invalid JSON\n    }\n    return null;\n  }\n\n  private async focusWeztermPane(paneId: string): Promise<boolean> {\n    try {\n      await execFileAsync(\"wezterm\", [\"cli\", \"activate-pane\", \"--pane-id\", paneId]);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private async findTmuxPane(tty: string): Promise<TerminalLocation | null> {\n    try {\n      const { stdout } = await execFileAsync(\"tmux\", [\n        \"list-panes\",\n        \"-a\",\n        \"-F\",\n        \"#{pane_tty}|#{session_name}:#{window_index}.#{pane_index}\",\n      ]);\n\n      const lines = stdout.trim().split(\"\\n\");\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        const [paneTty, identifier] = line.split(\"|\");\n        if (paneTty === tty && identifier) {\n          return {\n            type: TerminalType.TMUX,\n            identifier,\n            tty,\n          };\n        }\n      }\n    } catch {\n      // tmux might not be installed or running\n    }\n    return null;\n  }\n\n  private async findITerm2Session(tty: string): Promise<TerminalLocation | null> {\n    try {\n      // Check if iTerm2 is running first to avoid launching it.\n      if (!(await this.isProcessRunning(\"iTerm2\"))) return null;\n    } catch {\n      return null;\n    }\n\n    try {\n      const escapedTty = escapeAppleScript(tty);\n      const script = `\n        tell application \"iTerm\"\n          repeat with w in windows\n            repeat with t in tabs of w\n              repeat with s in sessions of t\n                if tty of s is \"${escapedTty}\" then\n                  return \"found\"\n                end if\n              end repeat\n            end repeat\n          end repeat\n        end tell\n      `;\n\n      const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n      if (stdout.trim() === \"found\") {\n        return {\n          type: TerminalType.ITERM2,\n          identifier: tty,\n          tty,\n        };\n      }\n    } catch {\n      // iTerm2 script failed\n    }\n    return null;\n  }\n\n  private async findTerminalAppWindow(tty: string): Promise<TerminalLocation | null> {\n    try {\n      // Check if Terminal.app is running\n      if (!(await this.isProcessRunning(\"Terminal\"))) return null;\n    } catch {\n      return null;\n    }\n\n    try {\n      const escapedTty = escapeAppleScript(tty);\n      const script = `\n        tell application \"Terminal\"\n          repeat with w in windows\n            repeat with t in tabs of w\n              if tty of t is \"${escapedTty}\" then\n                return \"found\"\n              end if\n            end repeat\n          end repeat\n        end tell\n      `;\n\n      const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n      if (stdout.trim() === \"found\") {\n        return {\n          type: TerminalType.TERMINAL_APP,\n          identifier: tty,\n          tty,\n        };\n      }\n    } catch {\n      // Terminal.app script failed\n    }\n    return null;\n  }\n\n  private async isProcessRunning(name: string): Promise<boolean> {\n    const { stdout } = await execFileAsync(\"ps\", [\"-Axo\", \"comm\"]);\n    return stdout\n      .split(\"\\n\")\n      .map((line) => line.trim())\n      .some((command) => command === name || command.endsWith(`/${name}`));\n  }\n\n  private async focusTmuxPane(identifier: string): Promise<boolean> {\n    try {\n      await execFileAsync(\"tmux\", [\"switch-client\", \"-t\", identifier]);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private async focusITerm2Session(tty: string): Promise<boolean> {\n    const escapedTty = escapeAppleScript(tty);\n    const script = `\n       tell application \"iTerm\"\n         activate\n         repeat with w in windows\n           repeat with t in tabs of w\n             repeat with s in sessions of t\n               if tty of s is \"${escapedTty}\" then\n                 select s\n                 return \"true\"\n               end if\n             end repeat\n           end repeat\n         end repeat\n       end tell\n     `;\n    const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n    return stdout.trim() === \"true\";\n  }\n\n  private async focusTerminalAppWindow(tty: string): Promise<boolean> {\n    const escapedTty = escapeAppleScript(tty);\n    const script = `\n       tell application \"Terminal\"\n         activate\n         repeat with w in windows\n           repeat with t in tabs of w\n             if tty of t is \"${escapedTty}\" then\n               set index of w to 1\n               set selected tab of w to t\n               return \"true\"\n             end if\n           end repeat\n         end repeat\n       end tell\n    `;\n    const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n    return stdout.trim() === \"true\";\n  }\n}\n"],"names":["execFile","promisify","getProcessTty","escapeAppleScript","execFileAsync","TerminalType","TerminalFocusManager","debug","findTerminal","pid","ttyShort","fullTty","tmuxLocation","findTmuxPane","identifier","weztermLocation","findWeztermPane","itermLocation","findITerm2Session","tty","terminalAppLocation","findTerminalAppWindow","type","focusTerminal","location","success","focusTmuxPane","focusWeztermPane","focusITerm2Session","focusTerminalAppWindow","stdout","panes","JSON","parse","Array","isArray","pane","tty_name","pane_id","String","paneId","lines","trim","split","line","paneTty","isProcessRunning","escapedTty","script","name","map","some","command","endsWith"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,gBAAgB;AACzC,SAASC,SAAS,QAAQ,OAAO;AACjC,SAASC,aAAa,QAAQ,sBAAsB;AACpD,SAASC,iBAAiB,QAAQ,0BAA0B;AAE5D,MAAMC,gBAAgBH,UAAUD;AAEhC,OAAO,IAAA,AAAKK,sCAAAA;;;;;;WAAAA;MAMX;AA0BD,OAAO,MAAMC;;IACX,YAAY,AAAiBC,KAA2B,CAAE;aAA7BA,QAAAA;IAA8B;IAE3D;;GAEC,GACD,MAAMC,aAAaC,GAAW,EAAoC;QAChE,MAAMC,WAAWR,cAAcO;QAE/B,mDAAmD;QACnD,IAAI,CAACC,YAAYA,aAAa,KAAK;YACjC,IAAI,CAACH,KAAK,GAAG,CAAC,iBAAiB,EAAEE,IAAI,yCAAyC,CAAC;YAC/E,OAAO;QACT;QAEA,MAAME,UAAU,CAAC,KAAK,EAAED,UAAU;QAClC,IAAI,CAACH,KAAK,GAAG,CAAC,iBAAiB,EAAEE,IAAI,0BAA0B,EAAEE,SAAS;QAE1E,qDAAqD;QACrD,MAAMC,eAAe,MAAM,IAAI,CAACC,YAAY,CAACF;QAC7C,IAAIC,cAAc;YAChB,IAAI,CAACL,KAAK,GAAG,CAAC,uCAAuC,EAAEK,aAAaE,UAAU,CAAC,CAAC,CAAC;YACjF,OAAOF;QACT;QACA,IAAI,CAACL,KAAK,GAAG;QAEb,kEAAkE;QAClE,MAAMQ,kBAAkB,MAAM,IAAI,CAACC,eAAe,CAACL;QACnD,IAAII,iBAAiB;YACnB,IAAI,CAACR,KAAK,GAAG,CAAC,uCAAuC,EAAEQ,gBAAgBD,UAAU,CAAC,CAAC,CAAC;YACpF,OAAOC;QACT;QACA,IAAI,CAACR,KAAK,GAAG;QAEb,kBAAkB;QAClB,MAAMU,gBAAgB,MAAM,IAAI,CAACC,iBAAiB,CAACP;QACnD,IAAIM,eAAe;YACjB,IAAI,CAACV,KAAK,GAAG,CAAC,kCAAkC,EAAEU,cAAcE,GAAG,CAAC,CAAC,CAAC;YACtE,OAAOF;QACT;QACA,IAAI,CAACV,KAAK,GAAG;QAEb,wBAAwB;QACxB,MAAMa,sBAAsB,MAAM,IAAI,CAACC,qBAAqB,CAACV;QAC7D,IAAIS,qBAAqB;YACvB,IAAI,CAACb,KAAK,GAAG,CAAC,wCAAwC,EAAEa,oBAAoBD,GAAG,CAAC,CAAC,CAAC;YAClF,OAAOC;QACT;QACA,IAAI,CAACb,KAAK,GAAG;QAEb,4DAA4D;QAC5D,IAAI,CAACA,KAAK,GAAG;QACb,OAAO;YACLe,IAAI;YACJR,YAAY;YACZK,KAAKR;QACP;IACF;IAEA;;GAEC,GACD,MAAMY,cAAcC,QAA0B,EAAoB;QAChE,IAAI,CAACjB,KAAK,GACR,CAAC,wBAAwB,EAAEiB,SAASF,IAAI,CAAC,aAAa,EAAEE,SAASV,UAAU,CAAC,MAAM,EAAEU,SAASL,GAAG,CAAC,CAAC,CAAC;QAErG,IAAIM,UAAU;QACd,IAAI;YACF,OAAQD,SAASF,IAAI;gBACnB;oBACEG,UAAU,MAAM,IAAI,CAACC,aAAa,CAACF,SAASV,UAAU;oBACtD;gBACF;oBACEW,UAAU,MAAM,IAAI,CAACE,gBAAgB,CAACH,SAASV,UAAU;oBACzD;gBACF;oBACEW,UAAU,MAAM,IAAI,CAACG,kBAAkB,CAACJ,SAASL,GAAG;oBACpD;gBACF;oBACEM,UAAU,MAAM,IAAI,CAACI,sBAAsB,CAACL,SAASL,GAAG;oBACxD;gBACF;oBACEM,UAAU;YACd;QACF,EAAE,OAAM;YACNA,UAAU;QACZ;QACA,IAAI,CAAClB,KAAK,GAAG,CAAC,eAAe,EAAEkB,UAAU,cAAc,SAAS,KAAK,EAAED,SAASF,IAAI,EAAE;QACtF,OAAOG;IACT;IAEA,MAAcT,gBAAgBG,GAAW,EAAoC;QAC3E,IAAI;YACF,MAAM,EAAEW,MAAM,EAAE,GAAG,MAAM1B,cAAc,WAAW;gBAAC;gBAAO;gBAAQ;gBAAY;aAAO;YAErF,MAAM2B,QAAQC,KAAKC,KAAK,CAACH;YACzB,IAAI,CAACI,MAAMC,OAAO,CAACJ,QAAQ,OAAO;YAElC,KAAK,MAAMK,QAAQL,MAAO;gBACxB,IACEK,QACA,OAAOA,KAAKC,QAAQ,KAAK,YACzBD,KAAKC,QAAQ,KAAKlB,OAClBiB,KAAKE,OAAO,IAAI,MAChB;oBACA,OAAO;wBACLhB,IAAI;wBACJR,YAAYyB,OAAOH,KAAKE,OAAO;wBAC/BnB;oBACF;gBACF;YACF;QACF,EAAE,OAAM;QACN,+DAA+D;QACjE;QACA,OAAO;IACT;IAEA,MAAcQ,iBAAiBa,MAAc,EAAoB;QAC/D,IAAI;YACF,MAAMpC,cAAc,WAAW;gBAAC;gBAAO;gBAAiB;gBAAaoC;aAAO;YAC5E,OAAO;QACT,EAAE,OAAM;YACN,OAAO;QACT;IACF;IAEA,MAAc3B,aAAaM,GAAW,EAAoC;QACxE,IAAI;YACF,MAAM,EAAEW,MAAM,EAAE,GAAG,MAAM1B,cAAc,QAAQ;gBAC7C;gBACA;gBACA;gBACA;aACD;YAED,MAAMqC,QAAQX,OAAOY,IAAI,GAAGC,KAAK,CAAC;YAClC,KAAK,MAAMC,QAAQH,MAAO;gBACxB,IAAI,CAACG,KAAKF,IAAI,IAAI;gBAClB,MAAM,CAACG,SAAS/B,WAAW,GAAG8B,KAAKD,KAAK,CAAC;gBACzC,IAAIE,YAAY1B,OAAOL,YAAY;oBACjC,OAAO;wBACLQ,IAAI;wBACJR;wBACAK;oBACF;gBACF;YACF;QACF,EAAE,OAAM;QACN,yCAAyC;QAC3C;QACA,OAAO;IACT;IAEA,MAAcD,kBAAkBC,GAAW,EAAoC;QAC7E,IAAI;YACF,0DAA0D;YAC1D,IAAI,CAAE,MAAM,IAAI,CAAC2B,gBAAgB,CAAC,WAAY,OAAO;QACvD,EAAE,OAAM;YACN,OAAO;QACT;QAEA,IAAI;YACF,MAAMC,aAAa5C,kBAAkBgB;YACrC,MAAM6B,SAAS,CAAC;;;;;gCAKU,EAAED,WAAW;;;;;;;MAOvC,CAAC;YAED,MAAM,EAAEjB,MAAM,EAAE,GAAG,MAAM1B,cAAc,aAAa;gBAAC;gBAAM4C;aAAO;YAClE,IAAIlB,OAAOY,IAAI,OAAO,SAAS;gBAC7B,OAAO;oBACLpB,IAAI;oBACJR,YAAYK;oBACZA;gBACF;YACF;QACF,EAAE,OAAM;QACN,uBAAuB;QACzB;QACA,OAAO;IACT;IAEA,MAAcE,sBAAsBF,GAAW,EAAoC;QACjF,IAAI;YACF,mCAAmC;YACnC,IAAI,CAAE,MAAM,IAAI,CAAC2B,gBAAgB,CAAC,aAAc,OAAO;QACzD,EAAE,OAAM;YACN,OAAO;QACT;QAEA,IAAI;YACF,MAAMC,aAAa5C,kBAAkBgB;YACrC,MAAM6B,SAAS,CAAC;;;;8BAIQ,EAAED,WAAW;;;;;;MAMrC,CAAC;YAED,MAAM,EAAEjB,MAAM,EAAE,GAAG,MAAM1B,cAAc,aAAa;gBAAC;gBAAM4C;aAAO;YAClE,IAAIlB,OAAOY,IAAI,OAAO,SAAS;gBAC7B,OAAO;oBACLpB,IAAI;oBACJR,YAAYK;oBACZA;gBACF;YACF;QACF,EAAE,OAAM;QACN,6BAA6B;QAC/B;QACA,OAAO;IACT;IAEA,MAAc2B,iBAAiBG,IAAY,EAAoB;QAC7D,MAAM,EAAEnB,MAAM,EAAE,GAAG,MAAM1B,cAAc,MAAM;YAAC;YAAQ;SAAO;QAC7D,OAAO0B,OACJa,KAAK,CAAC,MACNO,GAAG,CAAC,CAACN,OAASA,KAAKF,IAAI,IACvBS,IAAI,CAAC,CAACC,UAAYA,YAAYH,QAAQG,QAAQC,QAAQ,CAAC,CAAC,CAAC,EAAEJ,MAAM;IACtE;IAEA,MAAcvB,cAAcZ,UAAkB,EAAoB;QAChE,IAAI;YACF,MAAMV,cAAc,QAAQ;gBAAC;gBAAiB;gBAAMU;aAAW;YAC/D,OAAO;QACT,EAAE,OAAM;YACN,OAAO;QACT;IACF;IAEA,MAAcc,mBAAmBT,GAAW,EAAoB;QAC9D,MAAM4B,aAAa5C,kBAAkBgB;QACrC,MAAM6B,SAAS,CAAC;;;;;;+BAMW,EAAED,WAAW;;;;;;;;KAQvC,CAAC;QACF,MAAM,EAAEjB,MAAM,EAAE,GAAG,MAAM1B,cAAc,aAAa;YAAC;YAAM4C;SAAO;QAClE,OAAOlB,OAAOY,IAAI,OAAO;IAC3B;IAEA,MAAcb,uBAAuBV,GAAW,EAAoB;QAClE,MAAM4B,aAAa5C,kBAAkBgB;QACrC,MAAM6B,SAAS,CAAC;;;;;6BAKS,EAAED,WAAW;;;;;;;;IAQtC,CAAC;QACD,MAAM,EAAEjB,MAAM,EAAE,GAAG,MAAM1B,cAAc,aAAa;YAAC;YAAM4C;SAAO;QAClE,OAAOlB,OAAOY,IAAI,OAAO;IAC3B;AACF"}
+{"version":3,"sources":["../../src/terminal/TerminalFocusManager.ts"],"sourcesContent":["import { getProcessTty } from \"../utils/process.js\";\nimport { TERMINAL_BACKENDS, terminalBackendFor } from \"./backends/index.js\";\nimport { TerminalType, type TerminalLocation } from \"./types.js\";\n\nexport { TerminalType };\nexport type { TerminalLocation };\n\n/** Optional trace sink for terminal discovery and focus decisions. */\nexport type TerminalDebugLogger = (message: string) => void;\n\nexport class TerminalFocusManager {\n  constructor(private readonly debug?: TerminalDebugLogger) {}\n\n  async findTerminal(pid: number): Promise<TerminalLocation | null> {\n    const tty = getProcessTty(pid);\n    if (!tty || tty === \"?\") {\n      this.debug?.(`findTerminal(pid=${pid}): no usable TTY, cannot resolve terminal`);\n      return null;\n    }\n\n    const fullTty = `/dev/${tty}`;\n    this.debug?.(`findTerminal(pid=${pid}): resolving terminal for ${fullTty}`);\n\n    for (const backend of TERMINAL_BACKENDS) {\n      const location = await backend.find(fullTty);\n      if (location) {\n        this.debug?.(`findTerminal: matched ${backend.label} (identifier=${location.identifier})`);\n        return location;\n      }\n      this.debug?.(`findTerminal: ${backend.label} no match`);\n    }\n\n    this.debug?.(\"findTerminal: no emulator matched; returning UNKNOWN\");\n    return { type: TerminalType.UNKNOWN, identifier: \"\", tty: fullTty };\n  }\n\n  async focusTerminal(location: TerminalLocation): Promise<boolean> {\n    this.debug?.(\n      `focusTerminal: focusing ${location.type} (identifier=${location.identifier}, tty=${location.tty})`,\n    );\n\n    let success = false;\n    try {\n      success = (await terminalBackendFor(location.type)?.focus(location)) ?? false;\n    } catch {\n      success = false;\n    }\n\n    this.debug?.(`focusTerminal: ${success ? \"succeeded\" : \"failed\"} for ${location.type}`);\n    return success;\n  }\n}\n"],"names":["getProcessTty","TERMINAL_BACKENDS","terminalBackendFor","TerminalType","TerminalFocusManager","debug","findTerminal","pid","tty","fullTty","backend","location","find","label","identifier","type","UNKNOWN","focusTerminal","success","focus"],"mappings":"AAAA,SAASA,aAAa,QAAQ,sBAAsB;AACpD,SAASC,iBAAiB,EAAEC,kBAAkB,QAAQ,sBAAsB;AAC5E,SAASC,YAAY,QAA+B,aAAa;AAEjE,SAASA,YAAY,GAAG;AAMxB,OAAO,MAAMC;;IACX,YAAY,AAAiBC,KAA2B,CAAE;aAA7BA,QAAAA;IAA8B;IAE3D,MAAMC,aAAaC,GAAW,EAAoC;QAChE,MAAMC,MAAMR,cAAcO;QAC1B,IAAI,CAACC,OAAOA,QAAQ,KAAK;YACvB,IAAI,CAACH,KAAK,GAAG,CAAC,iBAAiB,EAAEE,IAAI,yCAAyC,CAAC;YAC/E,OAAO;QACT;QAEA,MAAME,UAAU,CAAC,KAAK,EAAED,KAAK;QAC7B,IAAI,CAACH,KAAK,GAAG,CAAC,iBAAiB,EAAEE,IAAI,0BAA0B,EAAEE,SAAS;QAE1E,KAAK,MAAMC,WAAWT,kBAAmB;YACvC,MAAMU,WAAW,MAAMD,QAAQE,IAAI,CAACH;YACpC,IAAIE,UAAU;gBACZ,IAAI,CAACN,KAAK,GAAG,CAAC,sBAAsB,EAAEK,QAAQG,KAAK,CAAC,aAAa,EAAEF,SAASG,UAAU,CAAC,CAAC,CAAC;gBACzF,OAAOH;YACT;YACA,IAAI,CAACN,KAAK,GAAG,CAAC,cAAc,EAAEK,QAAQG,KAAK,CAAC,SAAS,CAAC;QACxD;QAEA,IAAI,CAACR,KAAK,GAAG;QACb,OAAO;YAAEU,MAAMZ,aAAaa,OAAO;YAAEF,YAAY;YAAIN,KAAKC;QAAQ;IACpE;IAEA,MAAMQ,cAAcN,QAA0B,EAAoB;QAChE,IAAI,CAACN,KAAK,GACR,CAAC,wBAAwB,EAAEM,SAASI,IAAI,CAAC,aAAa,EAAEJ,SAASG,UAAU,CAAC,MAAM,EAAEH,SAASH,GAAG,CAAC,CAAC,CAAC;QAGrG,IAAIU,UAAU;QACd,IAAI;YACFA,UAAU,AAAC,MAAMhB,mBAAmBS,SAASI,IAAI,GAAGI,MAAMR,aAAc;QAC1E,EAAE,OAAM;YACNO,UAAU;QACZ;QAEA,IAAI,CAACb,KAAK,GAAG,CAAC,eAAe,EAAEa,UAAU,cAAc,SAAS,KAAK,EAAEP,SAASI,IAAI,EAAE;QACtF,OAAOG;IACT;AACF"}

package/dist/terminal/TtyWriter.d.ts

@@ -1,49 +1,6 @@
-import type { TerminalLocation } from "./TerminalFocusManager.js";
+import type { TerminalLocation } from "./types.js";
 export declare class TtyWriter {
-    /**
-     * Send a message as keyboard input to a terminal session.
-     *
-     * Dispatches to the correct mechanism based on terminal type:
-     * - tmux: `tmux send-keys`
-     * - iTerm2: Two separate AppleScript `write text` calls (text then newline)
-     * - Terminal.app: Two separate AppleScript `do script` calls (text then newline)
-     *
-     * All AppleScript is executed via `execFile('osascript', ['-e', script])`
-     * to avoid shell interpolation and command injection.
-     *
-     * @param location Terminal location from TerminalFocusManager.findTerminal()
-     * @param message Text to send
-     * @throws Error if terminal type is unsupported or send fails
-     */
     static send(location: TerminalLocation, message: string): Promise<void>;
-    /**
-     * Send a single raw key (e.g. "1", "Enter", "Up") to the terminal as a
-     * keystroke — bypassing bracketed paste and without auto-appending Enter.
-     *
-     * Use this when the target TUI distinguishes between typed text and raw
-     * keypresses (e.g. an `AskUserQuestion` picker that selects on digit-key
-     * press, not on a pasted digit followed by Enter).
-     *
-     * - tmux: `tmux send-keys -t <id> <key>` — direct keystroke, no paste buffer.
-     * - WezTerm: `wezterm cli send-text --pane-id <id> --no-paste <key>`.
-     * - iTerm2 / Terminal.app: AppleScript via System Events. Requires
-     *   Accessibility permissions.
-     */
     static sendKey(location: TerminalLocation, key: string): Promise<void>;
-    private static sendKeyViaTmux;
-    private static sendKeyViaWezterm;
-    private static sendKeyViaITerm2;
-    private static sendKeyViaTerminalApp;
-    private static sendViaWezterm;
-    private static sendViaTmux;
-    private static execFileWithInput;
-    /**
-     * Build an AppleScript that finds an iTerm2 session by TTY and runs a
-     * command against it. The `sessionCommand` is inserted inside a
-     * `tell targetSession` block.
-     */
-    private static iterm2SessionScript;
-    private static sendViaITerm2;
-    private static sendViaTerminalApp;
 }
 //# sourceMappingURL=TtyWriter.d.ts.map

package/dist/terminal/TtyWriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TtyWriter.d.ts","sourceRoot":"","sources":["../../src/terminal/TtyWriter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAmBlE,qBAAa,SAAS;IACpB;;;;;;;;;;;;;;OAcG;WACU,IAAI,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7E;;;;;;;;;;;;OAYG;WACU,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;mBAkBvD,cAAc;mBAOd,iBAAiB;mBAOjB,gBAAgB;mBAkChB,qBAAqB;mBA+BrB,cAAc;mBA8Bd,WAAW;mBAWX,iBAAiB;IAqBtC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;mBAsBb,aAAa;mBAuBb,kBAAkB;CA0DxC"}
+{"version":3,"file":"TtyWriter.d.ts","sourceRoot":"","sources":["../../src/terminal/TtyWriter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,SAAS;WACP,IAAI,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAWhE,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAU7E"}