@ai-devkit/agent-manager 0.22.0 → 0.24.0

package/dist/terminal/TerminalFocusManager.js

@@ -5,31 +5,58 @@ 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;
 }({});
 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 === '?') {
+            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}`);
         // 1. Check tmux (most specific if running inside it)
         const tmuxLocation = await this.findTmuxPane(fullTty);
-        if (tmuxLocation) return tmuxLocation;
-        // 2. Check iTerm2
+        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) return itermLocation;
-        // 3. Check Terminal.app
+        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) return terminalAppLocation;
-        // 4. Fallback: we know the TTY but not the emulator wrapper
+        if (terminalAppLocation) {
+            this.debug?.(`findTerminal: matched Terminal.app (tty=${terminalAppLocation.tty})`);
+            return terminalAppLocation;
+        }
+        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",
             identifier: '',
@@ -39,17 +66,64 @@ export class TerminalFocusManager {
     /**
      * Focus the terminal identified by the 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":
-                    return await this.focusTmuxPane(location.identifier);
+                    success = await this.focusTmuxPane(location.identifier);
+                    break;
+                case "wezterm":
+                    success = await this.focusWeztermPane(location.identifier);
+                    break;
                 case "iterm2":
-                    return await this.focusITerm2Session(location.tty);
+                    success = await this.focusITerm2Session(location.tty);
+                    break;
                 case "terminal-app":
-                    return await this.focusTerminalAppWindow(location.tty);
+                    success = await this.focusTerminalAppWindow(location.tty);
+                    break;
                 default:
-                    return false;
+                    success = 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;
         }

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    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, or TTY for others\n    tty: string;        // e.g., \"/dev/ttys030\"\n}\n\nexport class TerminalFocusManager {\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            return null;\n        }\n\n        const fullTty = `/dev/${ttyShort}`;\n\n        // 1. Check tmux (most specific if running inside it)\n        const tmuxLocation = await this.findTmuxPane(fullTty);\n        if (tmuxLocation) return tmuxLocation;\n\n        // 2. Check iTerm2\n        const itermLocation = await this.findITerm2Session(fullTty);\n        if (itermLocation) return itermLocation;\n\n        // 3. Check Terminal.app\n        const terminalAppLocation = await this.findTerminalAppWindow(fullTty);\n        if (terminalAppLocation) return terminalAppLocation;\n\n        // 4. Fallback: we know the TTY but not the emulator wrapper\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        try {\n            switch (location.type) {\n                case TerminalType.TMUX:\n                    return await this.focusTmuxPane(location.identifier);\n                case TerminalType.ITERM2:\n                    return await this.focusITerm2Session(location.tty);\n                case TerminalType.TERMINAL_APP:\n                    return await this.focusTerminalAppWindow(location.tty);\n                default:\n                    return false;\n            }\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', '-a', '-F', '#{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","findTerminal","pid","ttyShort","fullTty","tmuxLocation","findTmuxPane","itermLocation","findITerm2Session","terminalAppLocation","findTerminalAppWindow","type","identifier","tty","focusTerminal","location","focusTmuxPane","focusITerm2Session","focusTerminalAppWindow","stdout","lines","trim","split","line","paneTty","isProcessRunning","escapedTty","script","name","map","some","command","endsWith"],"mappings":"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"}
+{"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?.(`focusTerminal: focusing ${location.type} (identifier=${location.identifier}, tty=${location.tty})`);\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', [\n                'cli', 'list', '--format', 'json',\n            ]);\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', '-a', '-F', '#{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":"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"}

package/dist/terminal/TtyWriter.d.ts

@@ -16,7 +16,27 @@ export declare class TtyWriter {
      * @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

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;AAMlE,qBAAa,SAAS;IAClB;;;;;;;;;;;;;;OAcG;WACU,IAAI,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;mBAgBxD,WAAW;IAWhC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;mBAsBb,aAAa;mBAuBb,kBAAkB;CA0D1C"}
+{"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;IAClB;;;;;;;;;;;;;;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;mBASjB,gBAAgB;mBAkChB,qBAAqB;mBA+BrB,cAAc;mBAuBd,WAAW;mBAWX,iBAAiB;IAiBtC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;mBAsBb,aAAa;mBAuBb,kBAAkB;CA0D1C"}

package/dist/terminal/TtyWriter.js

@@ -3,6 +3,15 @@ import { promisify } from 'util';
 import { TerminalType } from './TerminalFocusManager.js';
 import { escapeAppleScript } from '../utils/applescript.js';
 const execFileAsync = promisify(execFile);
+/**
+ * Carriage return byte (0x0d). Sent as a fixed discrete argv element with
+ * `--no-paste` to deliver Enter literally (shell equivalent: $'\x0d').
+ */ const CARRIAGE_RETURN = '\x0d';
+/**
+ * Escape byte (0x1b). Recognized by `sendKey` and translated to the
+ * backend-native representation (`Escape` for tmux, `key code 53` for
+ * AppleScript, the literal byte for WezTerm).
+ */ const ESCAPE_BYTE = '\x1b';
 export class TtyWriter {
     /**
      * Send a message as keyboard input to a terminal session.
@@ -22,26 +31,182 @@ export class TtyWriter {
         switch(location.type){
             case TerminalType.TMUX:
                 return TtyWriter.sendViaTmux(location.identifier, message);
+            case TerminalType.WEZTERM:
+                return TtyWriter.sendViaWezterm(location.identifier, message);
             case TerminalType.ITERM2:
                 return TtyWriter.sendViaITerm2(location.tty, message);
             case TerminalType.TERMINAL_APP:
                 return TtyWriter.sendViaTerminalApp(location.tty, message);
             default:
-                throw new Error(`Cannot send input: unsupported terminal type "${location.type}". ` + 'Supported: tmux, iTerm2, Terminal.app.');
+                throw new Error(`Cannot send input: unsupported terminal type "${location.type}". ` + 'Supported: tmux, WezTerm, iTerm2, Terminal.app.');
         }
     }
-    static async sendViaTmux(identifier, message) {
-        // Send text and Enter as two separate calls so that Enter arrives
-        // outside of bracketed paste mode. When the inner application (e.g.
-        // Claude Code) has bracketed paste enabled, tmux wraps the send-keys
-        // payload in paste brackets — if Enter is included, it gets swallowed
-        // as part of the paste instead of acting as a submit action.
+    /**
+     * 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 async sendKey(location, key) {
+        switch(location.type){
+            case TerminalType.TMUX:
+                return TtyWriter.sendKeyViaTmux(location.identifier, key);
+            case TerminalType.WEZTERM:
+                return TtyWriter.sendKeyViaWezterm(location.identifier, key);
+            case TerminalType.ITERM2:
+                return TtyWriter.sendKeyViaITerm2(location.tty, key);
+            case TerminalType.TERMINAL_APP:
+                return TtyWriter.sendKeyViaTerminalApp(location.tty, key);
+            default:
+                throw new Error(`Cannot send key: unsupported terminal type "${location.type}". ` + 'Supported: tmux, WezTerm, iTerm2, Terminal.app.');
+        }
+    }
+    static async sendKeyViaTmux(identifier, key) {
+        // tmux send-keys interprets named keys (Enter, Up, Escape, ...) and
+        // passes literals through. No bracketed paste, no auto-Enter.
+        const arg = key === ESCAPE_BYTE ? 'Escape' : key;
         await execFileAsync('tmux', [
             'send-keys',
             '-t',
             identifier,
-            '-l',
-            message
+            arg
+        ]);
+    }
+    static async sendKeyViaWezterm(paneId, key) {
+        // --no-paste delivers the key bytes literally outside bracketed-paste
+        // markers; the TUI sees a raw keystroke. For Esc (`\x1b`), wezterm
+        // accepts the byte directly.
+        await execFileAsync('wezterm', [
+            'cli',
+            'send-text',
+            '--pane-id',
+            paneId,
+            '--no-paste',
+            key
+        ]);
+    }
+    static async sendKeyViaITerm2(tty, key) {
+        // Focus the target session, then press the key via System Events so the
+        // inner TUI sees a raw keystroke (not a bracketed-paste text run).
+        const action = appleScriptKeyAction(key);
+        const script = `
+tell application "iTerm"
+  set targetSession to missing value
+  repeat with w in windows
+    repeat with t in tabs of w
+      repeat with s in sessions of t
+        if tty of s is "${tty}" then
+          set targetSession to s
+          set frontmost of w to true
+          tell t to select
+          tell s to select
+          exit repeat
+        end if
+      end repeat
+      if targetSession is not missing value then exit repeat
+    end repeat
+    if targetSession is not missing value then exit repeat
+  end repeat
+  if targetSession is missing value then return "not_found"
+  activate
+end tell
+tell application "System Events" to ${action}
+return "ok"`;
+        const { stdout } = await execFileAsync('osascript', [
+            '-e',
+            script
+        ]);
+        if (stdout.trim() !== 'ok') {
+            throw new Error(`iTerm2 session not found for TTY ${tty}`);
+        }
+    }
+    static async sendKeyViaTerminalApp(tty, key) {
+        const action = appleScriptKeyAction(key);
+        const script = `
+tell application "Terminal"
+  set targetTab to missing value
+  set targetWindow to missing value
+  repeat with w in windows
+    repeat with i from 1 to count of tabs of w
+      set t to tab i of w
+      if tty of t is "${tty}" then
+        set targetTab to t
+        set targetWindow to w
+        exit repeat
+      end if
+    end repeat
+    if targetTab is not missing value then exit repeat
+  end repeat
+  if targetTab is missing value then return "not_found"
+  set selected of targetTab to true
+  set frontmost of targetWindow to true
+  activate
+end tell
+tell application "System Events" to ${action}
+return "ok"`;
+        const { stdout } = await execFileAsync('osascript', [
+            '-e',
+            script
+        ]);
+        if (stdout.trim() !== 'ok') {
+            throw new Error(`Terminal.app tab not found for TTY ${tty}`);
+        }
+    }
+    static async sendViaWezterm(paneId, message) {
+        // Two explicit CLI calls, mirroring the text-then-Enter convention used
+        // by tmux / iTerm2 / Terminal.app so a bracketed-paste-aware TUI still
+        // sees Enter as a submit.
+        //
+        // Step 1 (text): write the message to stdin so prompt contents are not
+        // exposed through process arguments. execFile still spawns wezterm
+        // directly (no shell), so shell metacharacters remain inert.
+        // Step 2 (Enter): pass a fixed carriage return (0x0d) as a discrete
+        // argv element (the JS char '\x0d') with --no-paste, so the CR is
+        // delivered literally rather than wrapped in paste brackets. The
+        // equivalent shell command is:
+        //   wezterm cli send-text --pane-id <id> --no-paste $'\x0d'
+        // (ANSI-C quoting, note the leading $).
+        await TtyWriter.execFileWithInput('wezterm', [
+            'cli',
+            'send-text',
+            '--pane-id',
+            paneId
+        ], message);
+        await new Promise((resolve)=>setTimeout(resolve, 150));
+        await execFileAsync('wezterm', [
+            'cli',
+            'send-text',
+            '--pane-id',
+            paneId,
+            '--no-paste',
+            CARRIAGE_RETURN
+        ]);
+    }
+    static async sendViaTmux(identifier, message) {
+        // Paste the message body using tmux bracketed paste, then send Enter as
+        // a separate key so the inner TUI treats it as submission rather than
+        // pasted content.
+        const bufferName = `ai-devkit-send-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+        await TtyWriter.execFileWithInput('tmux', [
+            'load-buffer',
+            '-b',
+            bufferName,
+            '-'
+        ], message);
+        await execFileAsync('tmux', [
+            'paste-buffer',
+            '-t',
+            identifier,
+            '-b',
+            bufferName,
+            '-p',
+            '-d'
         ]);
         await new Promise((resolve)=>setTimeout(resolve, 150));
         await execFileAsync('tmux', [
@@ -51,6 +216,22 @@ export class TtyWriter {
             'Enter'
         ]);
     }
+    static async execFileWithInput(command, args, input) {
+        await new Promise((resolve, reject)=>{
+            const child = execFile(command, args, (error)=>{
+                if (error) {
+                    reject(error);
+                    return;
+                }
+                resolve();
+            });
+            if (!child.stdin) {
+                reject(new Error(`Cannot write stdin to ${command}`));
+                return;
+            }
+            child.stdin.end(input);
+        });
+    }
     /**
      * Build an AppleScript that finds an iTerm2 session by TTY and runs a
      * command against it. The `sessionCommand` is inserted inside a
@@ -162,5 +343,13 @@ return "ok"`;
         }
     }
 }
+/**
+ * AppleScript `keystroke` only delivers typeable characters; non-typeable
+ * keys (Esc, arrows, F-keys, …) must be sent via `key code <N>`. Add more
+ * mappings here as new special keys are needed.
+ */ function appleScriptKeyAction(key) {
+    if (key === ESCAPE_BYTE) return 'key code 53';
+    return `keystroke "${escapeAppleScript(key)}"`;
+}
 
 //# sourceMappingURL=TtyWriter.js.map

package/dist/terminal/TtyWriter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/terminal/TtyWriter.ts"],"sourcesContent":["import { execFile } from 'child_process';\nimport { promisify } from 'util';\nimport type { TerminalLocation } from './TerminalFocusManager.js';\nimport { TerminalType } from './TerminalFocusManager.js';\nimport { escapeAppleScript } from '../utils/applescript.js';\n\nconst execFileAsync = promisify(execFile);\n\nexport class TtyWriter {\n    /**\n     * Send a message as keyboard input to a terminal session.\n     *\n     * Dispatches to the correct mechanism based on terminal type:\n     * - tmux: `tmux send-keys`\n     * - iTerm2: Two separate AppleScript `write text` calls (text then newline)\n     * - Terminal.app: Two separate AppleScript `do script` calls (text then newline)\n     *\n     * All AppleScript is executed via `execFile('osascript', ['-e', script])`\n     * to avoid shell interpolation and command injection.\n     *\n     * @param location Terminal location from TerminalFocusManager.findTerminal()\n     * @param message Text to send\n     * @throws Error if terminal type is unsupported or send fails\n     */\n    static async send(location: TerminalLocation, message: string): Promise<void> {\n        switch (location.type) {\n            case TerminalType.TMUX:\n                return TtyWriter.sendViaTmux(location.identifier, message);\n            case TerminalType.ITERM2:\n                return TtyWriter.sendViaITerm2(location.tty, message);\n            case TerminalType.TERMINAL_APP:\n                return TtyWriter.sendViaTerminalApp(location.tty, message);\n            default:\n                throw new Error(\n                    `Cannot send input: unsupported terminal type \"${location.type}\". ` +\n                    'Supported: tmux, iTerm2, Terminal.app.'\n                );\n        }\n    }\n\n    private static async sendViaTmux(identifier: string, message: string): Promise<void> {\n        // Send text and Enter as two separate calls so that Enter arrives\n        // outside of bracketed paste mode. When the inner application (e.g.\n        // Claude Code) has bracketed paste enabled, tmux wraps the send-keys\n        // payload in paste brackets — if Enter is included, it gets swallowed\n        // as part of the paste instead of acting as a submit action.\n        await execFileAsync('tmux', ['send-keys', '-t', identifier, '-l', message]);\n        await new Promise((resolve) => setTimeout(resolve, 150));\n        await execFileAsync('tmux', ['send-keys', '-t', identifier, 'Enter']);\n    }\n\n    /**\n     * Build an AppleScript that finds an iTerm2 session by TTY and runs a\n     * command against it. The `sessionCommand` is inserted inside a\n     * `tell targetSession` block.\n     */\n    private static iterm2SessionScript(tty: string, sessionCommand: string): string {\n        return `\ntell application \"iTerm\"\n  set targetSession to missing value\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 \"${tty}\" then\n          set targetSession to s\n          exit repeat\n        end if\n      end repeat\n      if targetSession is not missing value then exit repeat\n    end repeat\n    if targetSession is not missing value then exit repeat\n  end repeat\n  if targetSession is missing value then return \"not_found\"\n  tell targetSession to ${sessionCommand}\nend tell\nreturn \"ok\"`;\n    }\n\n    private static async sendViaITerm2(tty: string, message: string): Promise<void> {\n        const escaped = escapeAppleScript(message);\n        // Send text and Enter as two separate write text calls so the newline\n        // is delivered outside the bracketed paste sequence of the message body.\n        // iTerm2 appends the newline after the paste-end marker (\\e[201~), so\n        // the inner TUI (Claude Code, Codex) sees it as a real submit action.\n        const textScript = TtyWriter.iterm2SessionScript(tty, `write text \"${escaped}\" newline no`);\n\n        const { stdout: textResult } = await execFileAsync('osascript', ['-e', textScript]);\n        if (textResult.trim() !== 'ok') {\n            throw new Error(`iTerm2 session not found for TTY ${tty}`);\n        }\n\n        // Wait for the paste to complete before sending Enter separately\n        await new Promise((resolve) => setTimeout(resolve, 150));\n\n        const enterScript = TtyWriter.iterm2SessionScript(tty, 'write text \"\" newline yes');\n        const { stdout: enterResult } = await execFileAsync('osascript', ['-e', enterScript]);\n        if (enterResult.trim() !== 'ok') {\n            throw new Error(`iTerm2 session disappeared before Enter could be sent for TTY ${tty}`);\n        }\n    }\n\n    private static async sendViaTerminalApp(tty: string, message: string): Promise<void> {\n        const escaped = escapeAppleScript(message);\n        // Use Terminal.app's `do script` to send text to the correct tab by TTY.\n        // We avoid System Events `keystroke` + `key code 36` because it requires\n        // accessibility permissions and unreliably delivers the Return key.\n        //\n        // `do script` with `in` targets a specific tab without opening a new one.\n        // We send text and Enter as two separate calls so the newline arrives\n        // outside of bracketed paste mode — same pattern as iTerm2 and tmux.\n        const textScript = `\ntell application \"Terminal\"\n  set targetTab to missing value\n  repeat with w in windows\n    repeat with i from 1 to count of tabs of w\n      set t to tab i of w\n      if tty of t is \"${tty}\" then\n        set targetTab to t\n        exit repeat\n      end if\n    end repeat\n    if targetTab is not missing value then exit repeat\n  end repeat\n  if targetTab is missing value then return \"not_found\"\n  do script \"${escaped}\" in targetTab\nend tell\nreturn \"ok\"`;\n\n        const { stdout: textResult } = await execFileAsync('osascript', ['-e', textScript]);\n        if (textResult.trim() !== 'ok') {\n            throw new Error(`Terminal.app tab not found for TTY ${tty}`);\n        }\n\n        // Wait for the text to be delivered before sending Enter\n        await new Promise((resolve) => setTimeout(resolve, 150));\n\n        const enterScript = `\ntell application \"Terminal\"\n  set targetTab to missing value\n  repeat with w in windows\n    repeat with i from 1 to count of tabs of w\n      set t to tab i of w\n      if tty of t is \"${tty}\" then\n        set targetTab to t\n        exit repeat\n      end if\n    end repeat\n    if targetTab is not missing value then exit repeat\n  end repeat\n  if targetTab is missing value then return \"not_found\"\n  do script \"\" in targetTab\nend tell\nreturn \"ok\"`;\n\n        const { stdout: enterResult } = await execFileAsync('osascript', ['-e', enterScript]);\n        if (enterResult.trim() !== 'ok') {\n            throw new Error(`Terminal.app tab disappeared before Enter could be sent for TTY ${tty}`);\n        }\n    }\n}\n"],"names":["execFile","promisify","TerminalType","escapeAppleScript","execFileAsync","TtyWriter","send","location","message","type","TMUX","sendViaTmux","identifier","ITERM2","sendViaITerm2","tty","TERMINAL_APP","sendViaTerminalApp","Error","Promise","resolve","setTimeout","iterm2SessionScript","sessionCommand","escaped","textScript","stdout","textResult","trim","enterScript","enterResult"],"mappings":"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"}
+{"version":3,"sources":["../../src/terminal/TtyWriter.ts"],"sourcesContent":["import { execFile } from 'child_process';\nimport { promisify } from 'util';\nimport type { TerminalLocation } from './TerminalFocusManager.js';\nimport { TerminalType } from './TerminalFocusManager.js';\nimport { escapeAppleScript } from '../utils/applescript.js';\n\nconst execFileAsync = promisify(execFile);\n\n/**\n * Carriage return byte (0x0d). Sent as a fixed discrete argv element with\n * `--no-paste` to deliver Enter literally (shell equivalent: $'\\x0d').\n */\nconst CARRIAGE_RETURN = '\\x0d';\n\n/**\n * Escape byte (0x1b). Recognized by `sendKey` and translated to the\n * backend-native representation (`Escape` for tmux, `key code 53` for\n * AppleScript, the literal byte for WezTerm).\n */\nconst ESCAPE_BYTE = '\\x1b';\n\nexport class TtyWriter {\n    /**\n     * Send a message as keyboard input to a terminal session.\n     *\n     * Dispatches to the correct mechanism based on terminal type:\n     * - tmux: `tmux send-keys`\n     * - iTerm2: Two separate AppleScript `write text` calls (text then newline)\n     * - Terminal.app: Two separate AppleScript `do script` calls (text then newline)\n     *\n     * All AppleScript is executed via `execFile('osascript', ['-e', script])`\n     * to avoid shell interpolation and command injection.\n     *\n     * @param location Terminal location from TerminalFocusManager.findTerminal()\n     * @param message Text to send\n     * @throws Error if terminal type is unsupported or send fails\n     */\n    static async send(location: TerminalLocation, message: string): Promise<void> {\n        switch (location.type) {\n            case TerminalType.TMUX:\n                return TtyWriter.sendViaTmux(location.identifier, message);\n            case TerminalType.WEZTERM:\n                return TtyWriter.sendViaWezterm(location.identifier, message);\n            case TerminalType.ITERM2:\n                return TtyWriter.sendViaITerm2(location.tty, message);\n            case TerminalType.TERMINAL_APP:\n                return TtyWriter.sendViaTerminalApp(location.tty, message);\n            default:\n                throw new Error(\n                    `Cannot send input: unsupported terminal type \"${location.type}\". ` +\n                    'Supported: tmux, WezTerm, iTerm2, Terminal.app.'\n                );\n        }\n    }\n\n    /**\n     * Send a single raw key (e.g. \"1\", \"Enter\", \"Up\") to the terminal as a\n     * keystroke — bypassing bracketed paste and without auto-appending Enter.\n     *\n     * Use this when the target TUI distinguishes between typed text and raw\n     * keypresses (e.g. an `AskUserQuestion` picker that selects on digit-key\n     * press, not on a pasted digit followed by Enter).\n     *\n     * - tmux: `tmux send-keys -t <id> <key>` — direct keystroke, no paste buffer.\n     * - WezTerm: `wezterm cli send-text --pane-id <id> --no-paste <key>`.\n     * - iTerm2 / Terminal.app: AppleScript via System Events. Requires\n     *   Accessibility permissions.\n     */\n    static async sendKey(location: TerminalLocation, key: string): Promise<void> {\n        switch (location.type) {\n            case TerminalType.TMUX:\n                return TtyWriter.sendKeyViaTmux(location.identifier, key);\n            case TerminalType.WEZTERM:\n                return TtyWriter.sendKeyViaWezterm(location.identifier, key);\n            case TerminalType.ITERM2:\n                return TtyWriter.sendKeyViaITerm2(location.tty, key);\n            case TerminalType.TERMINAL_APP:\n                return TtyWriter.sendKeyViaTerminalApp(location.tty, key);\n            default:\n                throw new Error(\n                    `Cannot send key: unsupported terminal type \"${location.type}\". ` +\n                    'Supported: tmux, WezTerm, iTerm2, Terminal.app.'\n                );\n        }\n    }\n\n    private static async sendKeyViaTmux(identifier: string, key: string): Promise<void> {\n        // tmux send-keys interprets named keys (Enter, Up, Escape, ...) and\n        // passes literals through. No bracketed paste, no auto-Enter.\n        const arg = key === ESCAPE_BYTE ? 'Escape' : key;\n        await execFileAsync('tmux', ['send-keys', '-t', identifier, arg]);\n    }\n\n    private static async sendKeyViaWezterm(paneId: string, key: string): Promise<void> {\n        // --no-paste delivers the key bytes literally outside bracketed-paste\n        // markers; the TUI sees a raw keystroke. For Esc (`\\x1b`), wezterm\n        // accepts the byte directly.\n        await execFileAsync('wezterm', [\n            'cli', 'send-text', '--pane-id', paneId, '--no-paste', key,\n        ]);\n    }\n\n    private static async sendKeyViaITerm2(tty: string, key: string): Promise<void> {\n        // Focus the target session, then press the key via System Events so the\n        // inner TUI sees a raw keystroke (not a bracketed-paste text run).\n        const action = appleScriptKeyAction(key);\n        const script = `\ntell application \"iTerm\"\n  set targetSession to missing value\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 \"${tty}\" then\n          set targetSession to s\n          set frontmost of w to true\n          tell t to select\n          tell s to select\n          exit repeat\n        end if\n      end repeat\n      if targetSession is not missing value then exit repeat\n    end repeat\n    if targetSession is not missing value then exit repeat\n  end repeat\n  if targetSession is missing value then return \"not_found\"\n  activate\nend tell\ntell application \"System Events\" to ${action}\nreturn \"ok\"`;\n\n        const { stdout } = await execFileAsync('osascript', ['-e', script]);\n        if (stdout.trim() !== 'ok') {\n            throw new Error(`iTerm2 session not found for TTY ${tty}`);\n        }\n    }\n\n    private static async sendKeyViaTerminalApp(tty: string, key: string): Promise<void> {\n        const action = appleScriptKeyAction(key);\n        const script = `\ntell application \"Terminal\"\n  set targetTab to missing value\n  set targetWindow to missing value\n  repeat with w in windows\n    repeat with i from 1 to count of tabs of w\n      set t to tab i of w\n      if tty of t is \"${tty}\" then\n        set targetTab to t\n        set targetWindow to w\n        exit repeat\n      end if\n    end repeat\n    if targetTab is not missing value then exit repeat\n  end repeat\n  if targetTab is missing value then return \"not_found\"\n  set selected of targetTab to true\n  set frontmost of targetWindow to true\n  activate\nend tell\ntell application \"System Events\" to ${action}\nreturn \"ok\"`;\n\n        const { stdout } = await execFileAsync('osascript', ['-e', script]);\n        if (stdout.trim() !== 'ok') {\n            throw new Error(`Terminal.app tab not found for TTY ${tty}`);\n        }\n    }\n\n    private static async sendViaWezterm(paneId: string, message: string): Promise<void> {\n        // Two explicit CLI calls, mirroring the text-then-Enter convention used\n        // by tmux / iTerm2 / Terminal.app so a bracketed-paste-aware TUI still\n        // sees Enter as a submit.\n        //\n        // Step 1 (text): write the message to stdin so prompt contents are not\n        // exposed through process arguments. execFile still spawns wezterm\n        // directly (no shell), so shell metacharacters remain inert.\n        // Step 2 (Enter): pass a fixed carriage return (0x0d) as a discrete\n        // argv element (the JS char '\\x0d') with --no-paste, so the CR is\n        // delivered literally rather than wrapped in paste brackets. The\n        // equivalent shell command is:\n        //   wezterm cli send-text --pane-id <id> --no-paste $'\\x0d'\n        // (ANSI-C quoting, note the leading $).\n        await TtyWriter.execFileWithInput('wezterm', [\n            'cli', 'send-text', '--pane-id', paneId,\n        ], message);\n        await new Promise((resolve) => setTimeout(resolve, 150));\n        await execFileAsync('wezterm', [\n            'cli', 'send-text', '--pane-id', paneId, '--no-paste', CARRIAGE_RETURN,\n        ]);\n    }\n\n    private static async sendViaTmux(identifier: string, message: string): Promise<void> {\n        // Paste the message body using tmux bracketed paste, then send Enter as\n        // a separate key so the inner TUI treats it as submission rather than\n        // pasted content.\n        const bufferName = `ai-devkit-send-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n        await TtyWriter.execFileWithInput('tmux', ['load-buffer', '-b', bufferName, '-'], message);\n        await execFileAsync('tmux', ['paste-buffer', '-t', identifier, '-b', bufferName, '-p', '-d']);\n        await new Promise((resolve) => setTimeout(resolve, 150));\n        await execFileAsync('tmux', ['send-keys', '-t', identifier, 'Enter']);\n    }\n\n    private static async execFileWithInput(command: string, args: string[], input: string): Promise<void> {\n        await new Promise<void>((resolve, reject) => {\n            const child = execFile(command, args, (error) => {\n                if (error) {\n                    reject(error);\n                    return;\n                }\n                resolve();\n            });\n            if (!child.stdin) {\n                reject(new Error(`Cannot write stdin to ${command}`));\n                return;\n            }\n            child.stdin.end(input);\n        });\n    }\n\n    /**\n     * Build an AppleScript that finds an iTerm2 session by TTY and runs a\n     * command against it. The `sessionCommand` is inserted inside a\n     * `tell targetSession` block.\n     */\n    private static iterm2SessionScript(tty: string, sessionCommand: string): string {\n        return `\ntell application \"iTerm\"\n  set targetSession to missing value\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 \"${tty}\" then\n          set targetSession to s\n          exit repeat\n        end if\n      end repeat\n      if targetSession is not missing value then exit repeat\n    end repeat\n    if targetSession is not missing value then exit repeat\n  end repeat\n  if targetSession is missing value then return \"not_found\"\n  tell targetSession to ${sessionCommand}\nend tell\nreturn \"ok\"`;\n    }\n\n    private static async sendViaITerm2(tty: string, message: string): Promise<void> {\n        const escaped = escapeAppleScript(message);\n        // Send text and Enter as two separate write text calls so the newline\n        // is delivered outside the bracketed paste sequence of the message body.\n        // iTerm2 appends the newline after the paste-end marker (\\e[201~), so\n        // the inner TUI (Claude Code, Codex) sees it as a real submit action.\n        const textScript = TtyWriter.iterm2SessionScript(tty, `write text \"${escaped}\" newline no`);\n\n        const { stdout: textResult } = await execFileAsync('osascript', ['-e', textScript]);\n        if (textResult.trim() !== 'ok') {\n            throw new Error(`iTerm2 session not found for TTY ${tty}`);\n        }\n\n        // Wait for the paste to complete before sending Enter separately\n        await new Promise((resolve) => setTimeout(resolve, 150));\n\n        const enterScript = TtyWriter.iterm2SessionScript(tty, 'write text \"\" newline yes');\n        const { stdout: enterResult } = await execFileAsync('osascript', ['-e', enterScript]);\n        if (enterResult.trim() !== 'ok') {\n            throw new Error(`iTerm2 session disappeared before Enter could be sent for TTY ${tty}`);\n        }\n    }\n\n    private static async sendViaTerminalApp(tty: string, message: string): Promise<void> {\n        const escaped = escapeAppleScript(message);\n        // Use Terminal.app's `do script` to send text to the correct tab by TTY.\n        // We avoid System Events `keystroke` + `key code 36` because it requires\n        // accessibility permissions and unreliably delivers the Return key.\n        //\n        // `do script` with `in` targets a specific tab without opening a new one.\n        // We send text and Enter as two separate calls so the newline arrives\n        // outside of bracketed paste mode — same pattern as iTerm2 and tmux.\n        const textScript = `\ntell application \"Terminal\"\n  set targetTab to missing value\n  repeat with w in windows\n    repeat with i from 1 to count of tabs of w\n      set t to tab i of w\n      if tty of t is \"${tty}\" then\n        set targetTab to t\n        exit repeat\n      end if\n    end repeat\n    if targetTab is not missing value then exit repeat\n  end repeat\n  if targetTab is missing value then return \"not_found\"\n  do script \"${escaped}\" in targetTab\nend tell\nreturn \"ok\"`;\n\n        const { stdout: textResult } = await execFileAsync('osascript', ['-e', textScript]);\n        if (textResult.trim() !== 'ok') {\n            throw new Error(`Terminal.app tab not found for TTY ${tty}`);\n        }\n\n        // Wait for the text to be delivered before sending Enter\n        await new Promise((resolve) => setTimeout(resolve, 150));\n\n        const enterScript = `\ntell application \"Terminal\"\n  set targetTab to missing value\n  repeat with w in windows\n    repeat with i from 1 to count of tabs of w\n      set t to tab i of w\n      if tty of t is \"${tty}\" then\n        set targetTab to t\n        exit repeat\n      end if\n    end repeat\n    if targetTab is not missing value then exit repeat\n  end repeat\n  if targetTab is missing value then return \"not_found\"\n  do script \"\" in targetTab\nend tell\nreturn \"ok\"`;\n\n        const { stdout: enterResult } = await execFileAsync('osascript', ['-e', enterScript]);\n        if (enterResult.trim() !== 'ok') {\n            throw new Error(`Terminal.app tab disappeared before Enter could be sent for TTY ${tty}`);\n        }\n    }\n}\n\n/**\n * AppleScript `keystroke` only delivers typeable characters; non-typeable\n * keys (Esc, arrows, F-keys, …) must be sent via `key code <N>`. Add more\n * mappings here as new special keys are needed.\n */\nfunction appleScriptKeyAction(key: string): string {\n    if (key === ESCAPE_BYTE) return 'key code 53';\n    return `keystroke \"${escapeAppleScript(key)}\"`;\n}\n"],"names":["execFile","promisify","TerminalType","escapeAppleScript","execFileAsync","CARRIAGE_RETURN","ESCAPE_BYTE","TtyWriter","send","location","message","type","TMUX","sendViaTmux","identifier","WEZTERM","sendViaWezterm","ITERM2","sendViaITerm2","tty","TERMINAL_APP","sendViaTerminalApp","Error","sendKey","key","sendKeyViaTmux","sendKeyViaWezterm","sendKeyViaITerm2","sendKeyViaTerminalApp","arg","paneId","action","appleScriptKeyAction","script","stdout","trim","execFileWithInput","Promise","resolve","setTimeout","bufferName","process","pid","Date","now","Math","random","toString","slice","command","args","input","reject","child","error","stdin","end","iterm2SessionScript","sessionCommand","escaped","textScript","textResult","enterScript","enterResult"],"mappings":"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"}

package/dist/utils/agent-requests.d.ts

@@ -0,0 +1,10 @@
+export interface AgentRequest {
+    sessionId: string;
+    toolName: string;
+    toolInput: Record<string, unknown>;
+    timestamp: string;
+}
+export declare function getAgentRequestPath(homeDir: string, sessionId: string): string;
+export declare function readLatestAgentRequest(homeDir: string, sessionId: string): AgentRequest | null;
+export declare function writeAgentRequest(homeDir: string, entry: AgentRequest): void;
+//# sourceMappingURL=agent-requests.d.ts.map

package/dist/utils/agent-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-requests.d.ts","sourceRoot":"","sources":["../../src/utils/agent-requests.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAO9F;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAI5E"}

package/dist/utils/agent-requests.js

@@ -0,0 +1,22 @@
+import * as fs from 'fs';
+import * as path from 'path';
+export function getAgentRequestPath(homeDir, sessionId) {
+    return path.join(homeDir, '.ai-devkit', 'agent-requests', `${sessionId}.json`);
+}
+export function readLatestAgentRequest(homeDir, sessionId) {
+    try {
+        const raw = fs.readFileSync(getAgentRequestPath(homeDir, sessionId), 'utf-8');
+        return JSON.parse(raw);
+    } catch  {
+        return null;
+    }
+}
+export function writeAgentRequest(homeDir, entry) {
+    const filePath = getAgentRequestPath(homeDir, entry.sessionId);
+    fs.mkdirSync(path.dirname(filePath), {
+        recursive: true
+    });
+    fs.writeFileSync(filePath, JSON.stringify(entry, null, 2), 'utf-8');
+}
+
+//# sourceMappingURL=agent-requests.js.map

package/dist/utils/agent-requests.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/agent-requests.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\nexport interface AgentRequest {\n    sessionId: string;\n    toolName: string;\n    toolInput: Record<string, unknown>;\n    timestamp: string;\n}\n\nexport function getAgentRequestPath(homeDir: string, sessionId: string): string {\n    return path.join(homeDir, '.ai-devkit', 'agent-requests', `${sessionId}.json`);\n}\n\nexport function readLatestAgentRequest(homeDir: string, sessionId: string): AgentRequest | null {\n    try {\n        const raw = fs.readFileSync(getAgentRequestPath(homeDir, sessionId), 'utf-8');\n        return JSON.parse(raw) as AgentRequest;\n    } catch {\n        return null;\n    }\n}\n\nexport function writeAgentRequest(homeDir: string, entry: AgentRequest): void {\n    const filePath = getAgentRequestPath(homeDir, entry.sessionId);\n    fs.mkdirSync(path.dirname(filePath), { recursive: true });\n    fs.writeFileSync(filePath, JSON.stringify(entry, null, 2), 'utf-8');\n}\n"],"names":["fs","path","getAgentRequestPath","homeDir","sessionId","join","readLatestAgentRequest","raw","readFileSync","JSON","parse","writeAgentRequest","entry","filePath","mkdirSync","dirname","recursive","writeFileSync","stringify"],"mappings":"AAAA,YAAYA,QAAQ,KAAK;AACzB,YAAYC,UAAU,OAAO;AAS7B,OAAO,SAASC,oBAAoBC,OAAe,EAAEC,SAAiB;IAClE,OAAOH,KAAKI,IAAI,CAACF,SAAS,cAAc,kBAAkB,GAAGC,UAAU,KAAK,CAAC;AACjF;AAEA,OAAO,SAASE,uBAAuBH,OAAe,EAAEC,SAAiB;IACrE,IAAI;QACA,MAAMG,MAAMP,GAAGQ,YAAY,CAACN,oBAAoBC,SAASC,YAAY;QACrE,OAAOK,KAAKC,KAAK,CAACH;IACtB,EAAE,OAAM;QACJ,OAAO;IACX;AACJ;AAEA,OAAO,SAASI,kBAAkBR,OAAe,EAAES,KAAmB;IAClE,MAAMC,WAAWX,oBAAoBC,SAASS,MAAMR,SAAS;IAC7DJ,GAAGc,SAAS,CAACb,KAAKc,OAAO,CAACF,WAAW;QAAEG,WAAW;IAAK;IACvDhB,GAAGiB,aAAa,CAACJ,UAAUJ,KAAKS,SAAS,CAACN,OAAO,MAAM,IAAI;AAC/D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-devkit/agent-manager",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "type": "module",
   "description": "Standalone agent detection and management utilities for AI DevKit",
   "main": "dist/index.js",

package/src/__tests__/AgentManager.test.ts

@@ -86,9 +86,15 @@ function createMockAgent(overrides: Partial<AgentInfo> = {}): AgentInfo {
 
 describe('AgentManager', () => {
     let manager: AgentManager;
+    let tmpDir: string;
 
     beforeEach(() => {
-        manager = new AgentManager();
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-manager-'));
+        manager = new AgentManager(new AgentRegistry(path.join(tmpDir, 'agents.json')));
+    });
+
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
     });
 
     describe('registerAdapter', () => {