@ai-devkit/agent-manager 0.37.0 → 0.39.0

package/dist/terminal/TtyWriter.js

@@ -1,355 +1,20 @@
-import { execFile } from "child_process";
-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";
+import { TERMINAL_BACKENDS, terminalBackendFor } from "./backends/index.js";
+const SUPPORTED = `Supported: ${TERMINAL_BACKENDS.map((backend)=>backend.label).join(", ")}.`;
 export 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 async send(location, message) {
-        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, WezTerm, iTerm2, Terminal.app.");
+    static async send(location, message) {
+        const backend = terminalBackendFor(location.type);
+        if (!backend) {
+            throw new Error(`Cannot send input: unsupported terminal type "${location.type}". ${SUPPORTED}`);
         }
+        await backend.send(location, message);
     }
-    /**
-   * 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 sendKey(location, key) {
+        const backend = terminalBackendFor(location.type);
+        if (!backend) {
+            throw new Error(`Cannot send key: unsupported terminal type "${location.type}". ${SUPPORTED}`);
         }
+        await backend.sendKey(location, key);
     }
-    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,
-            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", [
-            "send-keys",
-            "-t",
-            identifier,
-            "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
-   * `tell targetSession` block.
-   */ static iterm2SessionScript(tty, sessionCommand) {
-        return `
-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
-          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"
-  tell targetSession to ${sessionCommand}
-end tell
-return "ok"`;
-    }
-    static async sendViaITerm2(tty, message) {
-        const escaped = escapeAppleScript(message);
-        // Send text and Enter as two separate write text calls so the newline
-        // is delivered outside the bracketed paste sequence of the message body.
-        // iTerm2 appends the newline after the paste-end marker (\e[201~), so
-        // the inner TUI (Claude Code, Codex) sees it as a real submit action.
-        const textScript = TtyWriter.iterm2SessionScript(tty, `write text "${escaped}" newline no`);
-        const { stdout: textResult } = await execFileAsync("osascript", [
-            "-e",
-            textScript
-        ]);
-        if (textResult.trim() !== "ok") {
-            throw new Error(`iTerm2 session not found for TTY ${tty}`);
-        }
-        // Wait for the paste to complete before sending Enter separately
-        await new Promise((resolve)=>setTimeout(resolve, 150));
-        const enterScript = TtyWriter.iterm2SessionScript(tty, 'write text "" newline yes');
-        const { stdout: enterResult } = await execFileAsync("osascript", [
-            "-e",
-            enterScript
-        ]);
-        if (enterResult.trim() !== "ok") {
-            throw new Error(`iTerm2 session disappeared before Enter could be sent for TTY ${tty}`);
-        }
-    }
-    static async sendViaTerminalApp(tty, message) {
-        const escaped = escapeAppleScript(message);
-        // Use Terminal.app's `do script` to send text to the correct tab by TTY.
-        // We avoid System Events `keystroke` + `key code 36` because it requires
-        // accessibility permissions and unreliably delivers the Return key.
-        //
-        // `do script` with `in` targets a specific tab without opening a new one.
-        // We send text and Enter as two separate calls so the newline arrives
-        // outside of bracketed paste mode — same pattern as iTerm2 and tmux.
-        const textScript = `
-tell application "Terminal"
-  set targetTab 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
-        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"
-  do script "${escaped}" in targetTab
-end tell
-return "ok"`;
-        const { stdout: textResult } = await execFileAsync("osascript", [
-            "-e",
-            textScript
-        ]);
-        if (textResult.trim() !== "ok") {
-            throw new Error(`Terminal.app tab not found for TTY ${tty}`);
-        }
-        // Wait for the text to be delivered before sending Enter
-        await new Promise((resolve)=>setTimeout(resolve, 150));
-        const enterScript = `
-tell application "Terminal"
-  set targetTab 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
-        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"
-  do script "" in targetTab
-end tell
-return "ok"`;
-        const { stdout: enterResult } = await execFileAsync("osascript", [
-            "-e",
-            enterScript
-        ]);
-        if (enterResult.trim() !== "ok") {
-            throw new Error(`Terminal.app tab disappeared before Enter could be sent for TTY ${tty}`);
-        }
-    }
-}
-/**
- * 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\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\", [\"cli\", \"send-text\", \"--pane-id\", paneId, \"--no-paste\", key]);\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(\n      \"wezterm\",\n      [\"cli\", \"send-text\", \"--pane-id\", paneId],\n      message,\n    );\n    await new Promise((resolve) => setTimeout(resolve, 150));\n    await execFileAsync(\"wezterm\", [\n      \"cli\",\n      \"send-text\",\n      \"--pane-id\",\n      paneId,\n      \"--no-paste\",\n      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(\n    command: string,\n    args: string[],\n    input: string,\n  ): 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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"}
+{"version":3,"sources":["../../src/terminal/TtyWriter.ts"],"sourcesContent":["import { TERMINAL_BACKENDS, terminalBackendFor } from \"./backends/index.js\";\nimport type { TerminalLocation } from \"./types.js\";\n\nconst SUPPORTED = `Supported: ${TERMINAL_BACKENDS.map((backend) => backend.label).join(\", \")}.`;\n\nexport class TtyWriter {\n  static async send(location: TerminalLocation, message: string): Promise<void> {\n    const backend = terminalBackendFor(location.type);\n    if (!backend) {\n      throw new Error(\n        `Cannot send input: unsupported terminal type \"${location.type}\". ${SUPPORTED}`,\n      );\n    }\n    await backend.send(location, message);\n  }\n\n  static async sendKey(location: TerminalLocation, key: string): Promise<void> {\n    const backend = terminalBackendFor(location.type);\n    if (!backend) {\n      throw new Error(\n        `Cannot send key: unsupported terminal type \"${location.type}\". ${SUPPORTED}`,\n      );\n    }\n    await backend.sendKey(location, key);\n  }\n}\n"],"names":["TERMINAL_BACKENDS","terminalBackendFor","SUPPORTED","map","backend","label","join","TtyWriter","send","location","message","type","Error","sendKey","key"],"mappings":"AAAA,SAASA,iBAAiB,EAAEC,kBAAkB,QAAQ,sBAAsB;AAG5E,MAAMC,YAAY,CAAC,WAAW,EAAEF,kBAAkBG,GAAG,CAAC,CAACC,UAAYA,QAAQC,KAAK,EAAEC,IAAI,CAAC,MAAM,CAAC,CAAC;AAE/F,OAAO,MAAMC;IACX,aAAaC,KAAKC,QAA0B,EAAEC,OAAe,EAAiB;QAC5E,MAAMN,UAAUH,mBAAmBQ,SAASE,IAAI;QAChD,IAAI,CAACP,SAAS;YACZ,MAAM,IAAIQ,MACR,CAAC,8CAA8C,EAAEH,SAASE,IAAI,CAAC,GAAG,EAAET,WAAW;QAEnF;QACA,MAAME,QAAQI,IAAI,CAACC,UAAUC;IAC/B;IAEA,aAAaG,QAAQJ,QAA0B,EAAEK,GAAW,EAAiB;QAC3E,MAAMV,UAAUH,mBAAmBQ,SAASE,IAAI;QAChD,IAAI,CAACP,SAAS;YACZ,MAAM,IAAIQ,MACR,CAAC,4CAA4C,EAAEH,SAASE,IAAI,CAAC,GAAG,EAAET,WAAW;QAEjF;QACA,MAAME,QAAQS,OAAO,CAACJ,UAAUK;IAClC;AACF"}

package/dist/terminal/backends/ghostty.d.ts

@@ -0,0 +1,3 @@
+import { type TerminalBackend } from "../types.js";
+export declare const ghosttyBackend: TerminalBackend;
+//# sourceMappingURL=ghostty.d.ts.map

package/dist/terminal/backends/ghostty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghostty.d.ts","sourceRoot":"","sources":["../../../src/terminal/backends/ghostty.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,KAAK,eAAe,EAAyB,MAAM,aAAa,CAAC;AA2IxF,eAAO,MAAM,cAAc,EAAE,eAmC5B,CAAC"}

package/dist/terminal/backends/ghostty.js

@@ -0,0 +1,161 @@
+import { execFile } from "child_process";
+import { writeFile } from "fs/promises";
+import { promisify } from "util";
+import { escapeAppleScript } from "../../utils/applescript.js";
+import { getProcessCwdsAsync } from "../../utils/process.js";
+import { TerminalType } from "../types.js";
+import { CARRIAGE_RETURN, isProcessName, sleep } from "./shared.js";
+const execFileAsync = promisify(execFile);
+/** Separates fields in AppleScript output; never part of an id, title or path. */ const FIELD_SEPARATOR = "\x1f";
+const MARKER_POLL_ATTEMPTS = 10;
+const MARKER_POLL_INTERVAL_MS = 50;
+async function listProcesses() {
+    const { stdout } = await execFileAsync("ps", [
+        "-Axo",
+        "pid=,ppid=,tty=,comm="
+    ]);
+    const rows = [];
+    for (const line of stdout.split("\n")){
+        const match = line.trim().match(/^(\d+)\s+(\d+)\s+(\S+)\s+(.+)$/);
+        if (match) {
+            rows.push({
+                pid: Number(match[1]),
+                ppid: Number(match[2]),
+                tty: match[3],
+                comm: match[4]
+            });
+        }
+    }
+    return rows;
+}
+async function listTerminals() {
+    const script = `
+tell application "Ghostty"
+  set out to ""
+  repeat with t in terminals
+    set out to out & (id of t) & (character id 31) & (name of t) & (character id 31) & (working directory of t) & linefeed
+  end repeat
+  return out
+end tell`;
+    const { stdout } = await execFileAsync("osascript", [
+        "-e",
+        script
+    ]);
+    return stdout.split("\n").map((line)=>line.split(FIELD_SEPARATOR)).filter((fields)=>fields.length === 3 && fields[0]).map(([id, name, workingDirectory])=>({
+            id,
+            name,
+            workingDirectory
+        }));
+}
+/** Run an AppleScript `command` with `t` bound to the located terminal; false if it is gone. */ async function onTerminal(location, command) {
+    const script = `
+tell application "Ghostty"
+  set matches to (every terminal whose id is "${escapeAppleScript(location.identifier)}")
+  if (count of matches) is 0 then return "not_found"
+  set t to item 1 of matches
+  ${command}
+end tell
+return "ok"`;
+    const { stdout } = await execFileAsync("osascript", [
+        "-e",
+        script
+    ]);
+    return stdout.trim() === "ok";
+}
+/** Set the window title of whatever terminal owns `tty` (OSC 2). */ async function writeTitle(tty, title) {
+    // eslint-disable-next-line no-control-regex
+    const safe = title.replace(/[\x00-\x1f\x7f]/g, "");
+    await writeFile(tty, `\x1b]2;${safe}\x07`, {
+        flag: "a"
+    });
+}
+/**
+ * Ghostty's AppleScript terminals expose an id, title and working directory,
+ * but not their TTY. Find the one owning `tty` without guessing:
+ * 1. only TTYs whose session was started by a ghostty process qualify;
+ * 2. if exactly one terminal's working directory matches a process on this
+ *    TTY, and no other Ghostty TTY has a process there, that is it;
+ * 3. otherwise briefly set a unique title on the TTY, find the terminal now
+ *    showing it, and restore its previous title.
+ */ async function findTerminalId(tty) {
+    const processes = await listProcesses();
+    const ghosttyPids = new Set(processes.filter((p)=>isProcessName(p.comm, "ghostty")).map((p)=>p.pid));
+    if (ghosttyPids.size === 0) return null;
+    const ttyName = tty.replace(/^\/dev\//, "");
+    const ghosttyTtys = new Set(processes.filter((p)=>ghosttyPids.has(p.ppid) && p.tty !== "??").map((p)=>p.tty));
+    if (!ghosttyTtys.has(ttyName)) return null;
+    const terminals = await listTerminals();
+    const sessionProcesses = processes.filter((p)=>ghosttyTtys.has(p.tty));
+    const cwdByPid = await getProcessCwdsAsync(sessionProcesses.map((p)=>p.pid));
+    const ownDirs = new Set();
+    const otherDirs = new Set();
+    for (const p of sessionProcesses){
+        const cwd = cwdByPid.get(p.pid);
+        if (cwd) (p.tty === ttyName ? ownDirs : otherDirs).add(cwd);
+    }
+    // Trust the directory only when exactly one terminal is in a folder no other Ghostty TTY uses.
+    const byDirectory = terminals.filter((t)=>ownDirs.has(t.workingDirectory));
+    if (byDirectory.length === 1 && !otherDirs.has(byDirectory[0].workingDirectory)) {
+        return byDirectory[0].id;
+    }
+    const marker = `ai-devkit-${process.pid}-${Date.now()}`;
+    await writeTitle(tty, marker);
+    for(let attempt = 0; attempt < MARKER_POLL_ATTEMPTS; attempt++){
+        const marked = (await listTerminals()).find((t)=>t.name === marker);
+        if (marked) {
+            const previous = terminals.find((t)=>t.id === marked.id)?.name ?? "";
+            await writeTitle(tty, previous);
+            return marked.id;
+        }
+        await sleep(MARKER_POLL_INTERVAL_MS);
+    }
+    return null;
+}
+/**
+ * A Ghostty `text:` action that writes `bytes` to the terminal as typed.
+ * Unlike `send key`, it does not go through the keyboard layout or input
+ * method, which can turn a digit key into another character.
+ */ function textAction(bytes) {
+    const escaped = Array.from(bytes, (char)=>{
+        if (char === "\\") return "\\\\";
+        const code = char.charCodeAt(0);
+        return code >= 0x20 && code < 0x7f ? char : `\\x${code.toString(16).padStart(2, "0")}`;
+    }).join("");
+    return `perform action "${escapeAppleScript(`text:${escaped}`)}" on t`;
+}
+export const ghosttyBackend = {
+    type: TerminalType.GHOSTTY,
+    label: "Ghostty",
+    async find (tty) {
+        try {
+            const id = await findTerminalId(tty);
+            return id ? {
+                type: TerminalType.GHOSTTY,
+                identifier: id,
+                tty
+            } : null;
+        } catch  {
+            // Ghostty not installed, not scriptable, or the TTY is not writable
+            return null;
+        }
+    },
+    async focus (location) {
+        return onTerminal(location, "focus t\n  activate");
+    },
+    async send (location, message) {
+        if (!await onTerminal(location, `input text "${escapeAppleScript(message)}" to t`)) {
+            throw new Error(`Ghostty terminal not found for TTY ${location.tty}`);
+        }
+        await sleep(150);
+        if (!await onTerminal(location, textAction(CARRIAGE_RETURN))) {
+            throw new Error(`Ghostty terminal disappeared before Enter could be sent for TTY ${location.tty}`);
+        }
+    },
+    async sendKey (location, key) {
+        if (!await onTerminal(location, textAction(key))) {
+            throw new Error(`Ghostty terminal not found for TTY ${location.tty}`);
+        }
+    }
+};
+
+//# sourceMappingURL=ghostty.js.map

package/dist/terminal/backends/ghostty.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/terminal/backends/ghostty.ts"],"sourcesContent":["import { execFile } from \"child_process\";\nimport { writeFile } from \"fs/promises\";\nimport { promisify } from \"util\";\nimport { escapeAppleScript } from \"../../utils/applescript.js\";\nimport { getProcessCwdsAsync } from \"../../utils/process.js\";\nimport { TerminalType, type TerminalBackend, type TerminalLocation } from \"../types.js\";\nimport { CARRIAGE_RETURN, isProcessName, sleep } from \"./shared.js\";\n\nconst execFileAsync = promisify(execFile);\n\n/** Separates fields in AppleScript output; never part of an id, title or path. */\nconst FIELD_SEPARATOR = \"\\x1f\";\nconst MARKER_POLL_ATTEMPTS = 10;\nconst MARKER_POLL_INTERVAL_MS = 50;\n\ninterface GhosttyTerminal {\n  id: string;\n  name: string;\n  workingDirectory: string;\n}\n\ninterface ProcessRow {\n  pid: number;\n  ppid: number;\n  tty: string;\n  comm: string;\n}\n\nasync function listProcesses(): Promise<ProcessRow[]> {\n  const { stdout } = await execFileAsync(\"ps\", [\"-Axo\", \"pid=,ppid=,tty=,comm=\"]);\n  const rows: ProcessRow[] = [];\n  for (const line of stdout.split(\"\\n\")) {\n    const match = line.trim().match(/^(\\d+)\\s+(\\d+)\\s+(\\S+)\\s+(.+)$/);\n    if (match) {\n      rows.push({ pid: Number(match[1]), ppid: Number(match[2]), tty: match[3], comm: match[4] });\n    }\n  }\n  return rows;\n}\n\nasync function listTerminals(): Promise<GhosttyTerminal[]> {\n  const script = `\ntell application \"Ghostty\"\n  set out to \"\"\n  repeat with t in terminals\n    set out to out & (id of t) & (character id 31) & (name of t) & (character id 31) & (working directory of t) & linefeed\n  end repeat\n  return out\nend tell`;\n  const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n  return stdout\n    .split(\"\\n\")\n    .map((line) => line.split(FIELD_SEPARATOR))\n    .filter((fields) => fields.length === 3 && fields[0])\n    .map(([id, name, workingDirectory]) => ({ id, name, workingDirectory }));\n}\n\n/** Run an AppleScript `command` with `t` bound to the located terminal; false if it is gone. */\nasync function onTerminal(location: TerminalLocation, command: string): Promise<boolean> {\n  const script = `\ntell application \"Ghostty\"\n  set matches to (every terminal whose id is \"${escapeAppleScript(location.identifier)}\")\n  if (count of matches) is 0 then return \"not_found\"\n  set t to item 1 of matches\n  ${command}\nend tell\nreturn \"ok\"`;\n  const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n  return stdout.trim() === \"ok\";\n}\n\n/** Set the window title of whatever terminal owns `tty` (OSC 2). */\nasync function writeTitle(tty: string, title: string): Promise<void> {\n  // eslint-disable-next-line no-control-regex\n  const safe = title.replace(/[\\x00-\\x1f\\x7f]/g, \"\");\n  await writeFile(tty, `\\x1b]2;${safe}\\x07`, { flag: \"a\" });\n}\n\n/**\n * Ghostty's AppleScript terminals expose an id, title and working directory,\n * but not their TTY. Find the one owning `tty` without guessing:\n * 1. only TTYs whose session was started by a ghostty process qualify;\n * 2. if exactly one terminal's working directory matches a process on this\n *    TTY, and no other Ghostty TTY has a process there, that is it;\n * 3. otherwise briefly set a unique title on the TTY, find the terminal now\n *    showing it, and restore its previous title.\n */\nasync function findTerminalId(tty: string): Promise<string | null> {\n  const processes = await listProcesses();\n  const ghosttyPids = new Set(\n    processes.filter((p) => isProcessName(p.comm, \"ghostty\")).map((p) => p.pid),\n  );\n  if (ghosttyPids.size === 0) return null;\n\n  const ttyName = tty.replace(/^\\/dev\\//, \"\");\n  const ghosttyTtys = new Set(\n    processes.filter((p) => ghosttyPids.has(p.ppid) && p.tty !== \"??\").map((p) => p.tty),\n  );\n  if (!ghosttyTtys.has(ttyName)) return null;\n\n  const terminals = await listTerminals();\n  const sessionProcesses = processes.filter((p) => ghosttyTtys.has(p.tty));\n  const cwdByPid = await getProcessCwdsAsync(sessionProcesses.map((p) => p.pid));\n  const ownDirs = new Set<string>();\n  const otherDirs = new Set<string>();\n  for (const p of sessionProcesses) {\n    const cwd = cwdByPid.get(p.pid);\n    if (cwd) (p.tty === ttyName ? ownDirs : otherDirs).add(cwd);\n  }\n\n  // Trust the directory only when exactly one terminal is in a folder no other Ghostty TTY uses.\n  const byDirectory = terminals.filter((t) => ownDirs.has(t.workingDirectory));\n  if (byDirectory.length === 1 && !otherDirs.has(byDirectory[0].workingDirectory)) {\n    return byDirectory[0].id;\n  }\n\n  const marker = `ai-devkit-${process.pid}-${Date.now()}`;\n  await writeTitle(tty, marker);\n  for (let attempt = 0; attempt < MARKER_POLL_ATTEMPTS; attempt++) {\n    const marked = (await listTerminals()).find((t) => t.name === marker);\n    if (marked) {\n      const previous = terminals.find((t) => t.id === marked.id)?.name ?? \"\";\n      await writeTitle(tty, previous);\n      return marked.id;\n    }\n    await sleep(MARKER_POLL_INTERVAL_MS);\n  }\n  return null;\n}\n\n/**\n * A Ghostty `text:` action that writes `bytes` to the terminal as typed.\n * Unlike `send key`, it does not go through the keyboard layout or input\n * method, which can turn a digit key into another character.\n */\nfunction textAction(bytes: string): string {\n  const escaped = Array.from(bytes, (char) => {\n    if (char === \"\\\\\") return \"\\\\\\\\\";\n    const code = char.charCodeAt(0);\n    return code >= 0x20 && code < 0x7f ? char : `\\\\x${code.toString(16).padStart(2, \"0\")}`;\n  }).join(\"\");\n  return `perform action \"${escapeAppleScript(`text:${escaped}`)}\" on t`;\n}\n\nexport const ghosttyBackend: TerminalBackend = {\n  type: TerminalType.GHOSTTY,\n  label: \"Ghostty\",\n\n  async find(tty) {\n    try {\n      const id = await findTerminalId(tty);\n      return id ? { type: TerminalType.GHOSTTY, identifier: id, tty } : null;\n    } catch {\n      // Ghostty not installed, not scriptable, or the TTY is not writable\n      return null;\n    }\n  },\n\n  async focus(location) {\n    return onTerminal(location, \"focus t\\n  activate\");\n  },\n\n  async send(location, message) {\n    if (!(await onTerminal(location, `input text \"${escapeAppleScript(message)}\" to t`))) {\n      throw new Error(`Ghostty terminal not found for TTY ${location.tty}`);\n    }\n    await sleep(150);\n    if (!(await onTerminal(location, textAction(CARRIAGE_RETURN)))) {\n      throw new Error(\n        `Ghostty terminal disappeared before Enter could be sent for TTY ${location.tty}`,\n      );\n    }\n  },\n\n  async sendKey(location, key) {\n    if (!(await onTerminal(location, textAction(key)))) {\n      throw new Error(`Ghostty terminal not found for TTY ${location.tty}`);\n    }\n  },\n};\n"],"names":["execFile","writeFile","promisify","escapeAppleScript","getProcessCwdsAsync","TerminalType","CARRIAGE_RETURN","isProcessName","sleep","execFileAsync","FIELD_SEPARATOR","MARKER_POLL_ATTEMPTS","MARKER_POLL_INTERVAL_MS","listProcesses","stdout","rows","line","split","match","trim","push","pid","Number","ppid","tty","comm","listTerminals","script","map","filter","fields","length","id","name","workingDirectory","onTerminal","location","command","identifier","writeTitle","title","safe","replace","flag","findTerminalId","processes","ghosttyPids","Set","p","size","ttyName","ghosttyTtys","has","terminals","sessionProcesses","cwdByPid","ownDirs","otherDirs","cwd","get","add","byDirectory","t","marker","process","Date","now","attempt","marked","find","previous","textAction","bytes","escaped","Array","from","char","code","charCodeAt","toString","padStart","join","ghosttyBackend","type","GHOSTTY","label","focus","send","message","Error","sendKey","key"],"mappings":"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"}

package/dist/terminal/backends/index.d.ts

@@ -0,0 +1,5 @@
+import type { TerminalBackend } from "../types.js";
+import { TerminalType } from "../types.js";
+export declare const TERMINAL_BACKENDS: readonly TerminalBackend[];
+export declare function terminalBackendFor(type: TerminalType): TerminalBackend | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/terminal/backends/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/terminal/backends/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAMvD,CAAC;AAMF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,GAAG,SAAS,CAElF"}

package/dist/terminal/backends/index.js

@@ -0,0 +1,21 @@
+import { ghosttyBackend } from "./ghostty.js";
+import { iterm2Backend } from "./iterm2.js";
+import { terminalAppBackend } from "./terminal-app.js";
+import { tmuxBackend } from "./tmux.js";
+import { weztermBackend } from "./wezterm.js";
+export const TERMINAL_BACKENDS = [
+    tmuxBackend,
+    weztermBackend,
+    ghosttyBackend,
+    iterm2Backend,
+    terminalAppBackend
+];
+const BACKENDS_BY_TYPE = new Map(TERMINAL_BACKENDS.map((backend)=>[
+        backend.type,
+        backend
+    ]));
+export function terminalBackendFor(type) {
+    return BACKENDS_BY_TYPE.get(type);
+}
+
+//# sourceMappingURL=index.js.map

package/dist/terminal/backends/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/terminal/backends/index.ts"],"sourcesContent":["import type { TerminalBackend } from \"../types.js\";\nimport { TerminalType } from \"../types.js\";\nimport { ghosttyBackend } from \"./ghostty.js\";\nimport { iterm2Backend } from \"./iterm2.js\";\nimport { terminalAppBackend } from \"./terminal-app.js\";\nimport { tmuxBackend } from \"./tmux.js\";\nimport { weztermBackend } from \"./wezterm.js\";\n\nexport const TERMINAL_BACKENDS: readonly TerminalBackend[] = [\n  tmuxBackend,\n  weztermBackend,\n  ghosttyBackend,\n  iterm2Backend,\n  terminalAppBackend,\n];\n\nconst BACKENDS_BY_TYPE = new Map<TerminalType, TerminalBackend>(\n  TERMINAL_BACKENDS.map((backend) => [backend.type, backend]),\n);\n\nexport function terminalBackendFor(type: TerminalType): TerminalBackend | undefined {\n  return BACKENDS_BY_TYPE.get(type);\n}\n"],"names":["ghosttyBackend","iterm2Backend","terminalAppBackend","tmuxBackend","weztermBackend","TERMINAL_BACKENDS","BACKENDS_BY_TYPE","Map","map","backend","type","terminalBackendFor","get"],"mappings":"AAEA,SAASA,cAAc,QAAQ,eAAe;AAC9C,SAASC,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,oBAAoB;AACvD,SAASC,WAAW,QAAQ,YAAY;AACxC,SAASC,cAAc,QAAQ,eAAe;AAE9C,OAAO,MAAMC,oBAAgD;IAC3DF;IACAC;IACAJ;IACAC;IACAC;CACD,CAAC;AAEF,MAAMI,mBAAmB,IAAIC,IAC3BF,kBAAkBG,GAAG,CAAC,CAACC,UAAY;QAACA,QAAQC,IAAI;QAAED;KAAQ;AAG5D,OAAO,SAASE,mBAAmBD,IAAkB;IACnD,OAAOJ,iBAAiBM,GAAG,CAACF;AAC9B"}