@ai-devkit/agent-manager 0.37.0 → 0.39.0

package/dist/{terminal → runtime/tmux}/TmuxManager.js

@@ -1,5 +1,5 @@
-import { execFile } from "child_process";
-import { promisify } from "util";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
 const execFileAsync = promisify(execFile);
 export class TmuxManager {
     async isAvailable() {
@@ -54,22 +54,7 @@ export class TmuxManager {
         // Already gone — ignore
         }
     }
-    /**
-   * Find the actual agent process PID inside a tmux pane.
-   *
-   * Strategy: BFS the process tree, return the deepest process whose
-   * `ps` command line is accepted by `matches`. The caller supplies the
-   * matcher so this method has no agent-type knowledge.
-   *
-   * This handles two real-world process shapes:
-   * - Wrapper case: shell → claude-wrapper (matches) → claude (matches, deeper)
-   *   → returns the deeper one
-   * - Subprocess case: shell → claude (matches) → MCP server child (doesn't match)
-   *   → returns claude, not the subprocess
-   *
-   * Returns null when no process matches yet (agent still starting); the
-   * caller's poll loop retries.
-   */ async findAgentPid(session, matches) {
+    async findAgentPid(session, matches) {
         const panePid = await this.getPanePid(session);
         if (panePid === null) return null;
         const visited = new Set();
@@ -82,11 +67,8 @@ export class TmuxManager {
             if (visited.has(pid)) continue;
             visited.add(pid);
             const command = await this.getProcessCommand(pid);
-            if (command && matches(command)) {
-                deepestMatch = pid;
-            }
-            const children = await this.pgrepChildren(pid);
-            queue.push(...children);
+            if (command && matches(command)) deepestMatch = pid;
+            queue.push(...await this.pgrepChildren(pid));
         }
         return deepestMatch;
     }
@@ -99,8 +81,8 @@ export class TmuxManager {
                 "-F",
                 "#{pane_pid}"
             ]);
-            const panePid = parseInt(stdout.trim().split("\n")[0], 10);
-            return isNaN(panePid) ? null : panePid;
+            const panePid = Number.parseInt(stdout.trim().split("\n")[0], 10);
+            return Number.isNaN(panePid) ? null : panePid;
         } catch  {
             return null;
         }
@@ -111,7 +93,7 @@ export class TmuxManager {
                 "-P",
                 String(pid)
             ]);
-            return stdout.trim().split("\n").map((s)=>parseInt(s, 10)).filter((n)=>!isNaN(n));
+            return stdout.trim().split("\n").map((value)=>Number.parseInt(value, 10)).filter((value)=>!Number.isNaN(value));
         } catch  {
             return [];
         }
@@ -124,8 +106,7 @@ export class TmuxManager {
                 "-o",
                 "command="
             ]);
-            const trimmed = stdout.trim();
-            return trimmed || null;
+            return stdout.trim() || null;
         } catch  {
             return null;
         }

package/dist/runtime/tmux/TmuxManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/tmux/TmuxManager.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\n\nconst execFileAsync = promisify(execFile);\n\nexport class TmuxManager {\n  async isAvailable(): Promise<boolean> {\n    try {\n      await execFileAsync(\"tmux\", [\"-V\"]);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async sessionExists(name: string): Promise<boolean> {\n    try {\n      await execFileAsync(\"tmux\", [\"has-session\", \"-t\", name]);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async createSession(name: string, cwd: string): Promise<void> {\n    await execFileAsync(\"tmux\", [\"new-session\", \"-d\", \"-s\", name, \"-c\", cwd]);\n  }\n\n  async sendKeys(session: string, keys: string): Promise<void> {\n    await execFileAsync(\"tmux\", [\"send-keys\", \"-t\", session, keys, \"Enter\"]);\n  }\n\n  async killSession(name: string): Promise<void> {\n    try {\n      await execFileAsync(\"tmux\", [\"kill-session\", \"-t\", name]);\n    } catch {\n      // Already gone — ignore\n    }\n  }\n\n  async findAgentPid(\n    session: string,\n    matches: (psCommand: string) => boolean,\n  ): Promise<number | null> {\n    const panePid = await this.getPanePid(session);\n    if (panePid === null) return null;\n\n    const visited = new Set<number>();\n    const queue: number[] = [panePid];\n    let deepestMatch: number | null = null;\n\n    while (queue.length > 0) {\n      const pid = queue.shift()!;\n      if (visited.has(pid)) continue;\n      visited.add(pid);\n\n      const command = await this.getProcessCommand(pid);\n      if (command && matches(command)) deepestMatch = pid;\n      queue.push(...(await this.pgrepChildren(pid)));\n    }\n\n    return deepestMatch;\n  }\n\n  private async getPanePid(session: string): Promise<number | null> {\n    try {\n      const { stdout } = await execFileAsync(\"tmux\", [\n        \"list-panes\",\n        \"-t\",\n        session,\n        \"-F\",\n        \"#{pane_pid}\",\n      ]);\n      const panePid = Number.parseInt(stdout.trim().split(\"\\n\")[0], 10);\n      return Number.isNaN(panePid) ? null : panePid;\n    } catch {\n      return null;\n    }\n  }\n\n  private async pgrepChildren(pid: number): Promise<number[]> {\n    try {\n      const { stdout } = await execFileAsync(\"pgrep\", [\"-P\", String(pid)]);\n      return stdout\n        .trim()\n        .split(\"\\n\")\n        .map((value) => Number.parseInt(value, 10))\n        .filter((value) => !Number.isNaN(value));\n    } catch {\n      return [];\n    }\n  }\n\n  private async getProcessCommand(pid: number): Promise<string | null> {\n    try {\n      const { stdout } = await execFileAsync(\"ps\", [\"-p\", String(pid), \"-o\", \"command=\"]);\n      return stdout.trim() || null;\n    } catch {\n      return null;\n    }\n  }\n}\n"],"names":["execFile","promisify","execFileAsync","TmuxManager","isAvailable","sessionExists","name","createSession","cwd","sendKeys","session","keys","killSession","findAgentPid","matches","panePid","getPanePid","visited","Set","queue","deepestMatch","length","pid","shift","has","add","command","getProcessCommand","push","pgrepChildren","stdout","Number","parseInt","trim","split","isNaN","String","map","value","filter"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,qBAAqB;AAC9C,SAASC,SAAS,QAAQ,YAAY;AAEtC,MAAMC,gBAAgBD,UAAUD;AAEhC,OAAO,MAAMG;IACX,MAAMC,cAAgC;QACpC,IAAI;YACF,MAAMF,cAAc,QAAQ;gBAAC;aAAK;YAClC,OAAO;QACT,EAAE,OAAM;YACN,OAAO;QACT;IACF;IAEA,MAAMG,cAAcC,IAAY,EAAoB;QAClD,IAAI;YACF,MAAMJ,cAAc,QAAQ;gBAAC;gBAAe;gBAAMI;aAAK;YACvD,OAAO;QACT,EAAE,OAAM;YACN,OAAO;QACT;IACF;IAEA,MAAMC,cAAcD,IAAY,EAAEE,GAAW,EAAiB;QAC5D,MAAMN,cAAc,QAAQ;YAAC;YAAe;YAAM;YAAMI;YAAM;YAAME;SAAI;IAC1E;IAEA,MAAMC,SAASC,OAAe,EAAEC,IAAY,EAAiB;QAC3D,MAAMT,cAAc,QAAQ;YAAC;YAAa;YAAMQ;YAASC;YAAM;SAAQ;IACzE;IAEA,MAAMC,YAAYN,IAAY,EAAiB;QAC7C,IAAI;YACF,MAAMJ,cAAc,QAAQ;gBAAC;gBAAgB;gBAAMI;aAAK;QAC1D,EAAE,OAAM;QACN,wBAAwB;QAC1B;IACF;IAEA,MAAMO,aACJH,OAAe,EACfI,OAAuC,EACf;QACxB,MAAMC,UAAU,MAAM,IAAI,CAACC,UAAU,CAACN;QACtC,IAAIK,YAAY,MAAM,OAAO;QAE7B,MAAME,UAAU,IAAIC;QACpB,MAAMC,QAAkB;YAACJ;SAAQ;QACjC,IAAIK,eAA8B;QAElC,MAAOD,MAAME,MAAM,GAAG,EAAG;YACvB,MAAMC,MAAMH,MAAMI,KAAK;YACvB,IAAIN,QAAQO,GAAG,CAACF,MAAM;YACtBL,QAAQQ,GAAG,CAACH;YAEZ,MAAMI,UAAU,MAAM,IAAI,CAACC,iBAAiB,CAACL;YAC7C,IAAII,WAAWZ,QAAQY,UAAUN,eAAeE;YAChDH,MAAMS,IAAI,IAAK,MAAM,IAAI,CAACC,aAAa,CAACP;QAC1C;QAEA,OAAOF;IACT;IAEA,MAAcJ,WAAWN,OAAe,EAA0B;QAChE,IAAI;YACF,MAAM,EAAEoB,MAAM,EAAE,GAAG,MAAM5B,cAAc,QAAQ;gBAC7C;gBACA;gBACAQ;gBACA;gBACA;aACD;YACD,MAAMK,UAAUgB,OAAOC,QAAQ,CAACF,OAAOG,IAAI,GAAGC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE;YAC9D,OAAOH,OAAOI,KAAK,CAACpB,WAAW,OAAOA;QACxC,EAAE,OAAM;YACN,OAAO;QACT;IACF;IAEA,MAAcc,cAAcP,GAAW,EAAqB;QAC1D,IAAI;YACF,MAAM,EAAEQ,MAAM,EAAE,GAAG,MAAM5B,cAAc,SAAS;gBAAC;gBAAMkC,OAAOd;aAAK;YACnE,OAAOQ,OACJG,IAAI,GACJC,KAAK,CAAC,MACNG,GAAG,CAAC,CAACC,QAAUP,OAAOC,QAAQ,CAACM,OAAO,KACtCC,MAAM,CAAC,CAACD,QAAU,CAACP,OAAOI,KAAK,CAACG;QACrC,EAAE,OAAM;YACN,OAAO,EAAE;QACX;IACF;IAEA,MAAcX,kBAAkBL,GAAW,EAA0B;QACnE,IAAI;YACF,MAAM,EAAEQ,MAAM,EAAE,GAAG,MAAM5B,cAAc,MAAM;gBAAC;gBAAMkC,OAAOd;gBAAM;gBAAM;aAAW;YAClF,OAAOQ,OAAOG,IAAI,MAAM;QAC1B,EAAE,OAAM;YACN,OAAO;QACT;IACF;AACF"}

package/dist/runtime/types.d.ts

@@ -1,5 +1,5 @@
 import type { AgentInfo } from "../adapters/AgentAdapter.js";
-import type { TerminalLocation } from "../terminal/TerminalFocusManager.js";
+import type { TerminalLocation } from "../terminal/types.js";
 import type { AgentRuntimeProvider } from "../utils/AgentRegistry.js";
 export type AgentRuntimeAvailability = {
     ok: true;

package/dist/runtime/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,MAAM,wBAAwB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,gBAAgB,GAAG,qBAAqB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;IACvC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,YAAY,EAAE;QACZ,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;QAC5D,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAC7D,CAAC;CACH;AAED,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE;QACZ,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;KAC7D,CAAC;IACF,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,WAAW,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACjD,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,MAAM,wBAAwB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,gBAAgB,GAAG,qBAAqB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;IACvC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,YAAY,EAAE;QACZ,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;QAC5D,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAC7D,CAAC;CACH;AAED,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE;QACZ,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;KAC7D,CAAC;IACF,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,WAAW,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACjD,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C"}

package/dist/runtime/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/types.ts"],"sourcesContent":["import type { AgentInfo } from \"../adapters/AgentAdapter.js\";\nimport type { TerminalLocation } from \"../terminal/TerminalFocusManager.js\";\nimport type { AgentRuntimeProvider } from \"../utils/AgentRegistry.js\";\n\nexport type AgentRuntimeAvailability =\n  | { ok: true; insideRuntime: boolean; currentPaneId?: string }\n  | { ok: false; reason: \"binary-missing\" | \"backend-unreachable\"; detail: string };\n\nexport interface RuntimeStartInput {\n  name: string;\n  cwd: string;\n  kind: string;\n  args: string[];\n  timeoutMs: number;\n}\n\nexport interface RuntimeStartResult {\n  pid: number;\n  runtimeRef: unknown;\n}\n\nexport interface RuntimeTargetInput {\n  agent: Pick<AgentInfo, \"name\" | \"pid\">;\n  runtimeRef: unknown | null;\n}\n\nexport interface RuntimeSendInput extends RuntimeTargetInput {\n  prompt: string;\n}\n\nexport interface RuntimeFocusInput extends RuntimeTargetInput {\n  focusManager: {\n    findTerminal(pid: number): Promise<TerminalLocation | null>;\n    focusTerminal(location: TerminalLocation): Promise<boolean>;\n  };\n}\n\nexport interface RuntimeStopInput extends RuntimeTargetInput {\n  killProcess?: (pid: number, signal: NodeJS.Signals) => void;\n}\n\nexport interface RuntimeSendDeps {\n  focusManager: {\n    findTerminal(pid: number): Promise<TerminalLocation | null>;\n  };\n  writer?: (location: TerminalLocation, text: string) => Promise<void>;\n}\n\nexport interface InteractiveAgentRuntime {\n  provider: AgentRuntimeProvider;\n  isAvailable(): Promise<AgentRuntimeAvailability>;\n  startAgent(input: RuntimeStartInput): Promise<RuntimeStartResult>;\n  send(input: RuntimeSendInput, deps?: RuntimeSendDeps): Promise<void>;\n  focus(input: RuntimeFocusInput): Promise<boolean>;\n  stop(input: RuntimeStopInput): Promise<void>;\n}\n"],"names":[],"mappings":"AAgDA,WAOC"}
+{"version":3,"sources":["../../src/runtime/types.ts"],"sourcesContent":["import type { AgentInfo } from \"../adapters/AgentAdapter.js\";\nimport type { TerminalLocation } from \"../terminal/types.js\";\nimport type { AgentRuntimeProvider } from \"../utils/AgentRegistry.js\";\n\nexport type AgentRuntimeAvailability =\n  | { ok: true; insideRuntime: boolean; currentPaneId?: string }\n  | { ok: false; reason: \"binary-missing\" | \"backend-unreachable\"; detail: string };\n\nexport interface RuntimeStartInput {\n  name: string;\n  cwd: string;\n  kind: string;\n  args: string[];\n  timeoutMs: number;\n}\n\nexport interface RuntimeStartResult {\n  pid: number;\n  runtimeRef: unknown;\n}\n\nexport interface RuntimeTargetInput {\n  agent: Pick<AgentInfo, \"name\" | \"pid\">;\n  runtimeRef: unknown | null;\n}\n\nexport interface RuntimeSendInput extends RuntimeTargetInput {\n  prompt: string;\n}\n\nexport interface RuntimeFocusInput extends RuntimeTargetInput {\n  focusManager: {\n    findTerminal(pid: number): Promise<TerminalLocation | null>;\n    focusTerminal(location: TerminalLocation): Promise<boolean>;\n  };\n}\n\nexport interface RuntimeStopInput extends RuntimeTargetInput {\n  killProcess?: (pid: number, signal: NodeJS.Signals) => void;\n}\n\nexport interface RuntimeSendDeps {\n  focusManager: {\n    findTerminal(pid: number): Promise<TerminalLocation | null>;\n  };\n  writer?: (location: TerminalLocation, text: string) => Promise<void>;\n}\n\nexport interface InteractiveAgentRuntime {\n  provider: AgentRuntimeProvider;\n  isAvailable(): Promise<AgentRuntimeAvailability>;\n  startAgent(input: RuntimeStartInput): Promise<RuntimeStartResult>;\n  send(input: RuntimeSendInput, deps?: RuntimeSendDeps): Promise<void>;\n  focus(input: RuntimeFocusInput): Promise<boolean>;\n  stop(input: RuntimeStopInput): Promise<void>;\n}\n"],"names":[],"mappings":"AAgDA,WAOC"}

package/dist/terminal/TerminalFocusManager.d.ts

@@ -1,40 +1,12 @@
-export declare enum TerminalType {
-    TMUX = "tmux",
-    WEZTERM = "wezterm",
-    ITERM2 = "iterm2",
-    TERMINAL_APP = "terminal-app",
-    UNKNOWN = "unknown"
-}
-export interface TerminalLocation {
-    type: TerminalType;
-    identifier: string;
-    tty: string;
-}
-/**
- * Optional trace sink. When provided to {@link TerminalFocusManager}, each
- * discovery/focus step reports a human-readable line so callers (e.g. the
- * `agent open --debug` command) can inspect the matching/focus decision path.
- */
+import { TerminalType, type TerminalLocation } from "./types.js";
+export { TerminalType };
+export type { TerminalLocation };
+/** Optional trace sink for terminal discovery and focus decisions. */
 export type TerminalDebugLogger = (message: string) => void;
 export declare class TerminalFocusManager {
     private readonly debug?;
     constructor(debug?: TerminalDebugLogger | undefined);
-    /**
-     * Find the terminal location (emulator info) for a given process ID
-     */
     findTerminal(pid: number): Promise<TerminalLocation | null>;
-    /**
-     * Focus the terminal identified by the location
-     */
     focusTerminal(location: TerminalLocation): Promise<boolean>;
-    private findWeztermPane;
-    private focusWeztermPane;
-    private findTmuxPane;
-    private findITerm2Session;
-    private findTerminalAppWindow;
-    private isProcessRunning;
-    private focusTmuxPane;
-    private focusITerm2Session;
-    private focusTerminalAppWindow;
 }
 //# sourceMappingURL=TerminalFocusManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"TerminalFocusManager.d.ts","sourceRoot":"","sources":["../../src/terminal/TerminalFocusManager.ts"],"names":[],"mappings":"AAOA,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,YAAY,iBAAiB;IAC7B,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAaD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAE5D,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAN,KAAK,CAAC,EAAE,mBAAmB,YAAA;IAExD;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAqDjE;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;YA6BnD,eAAe;YA2Bf,gBAAgB;YAShB,YAAY;YA2BZ,iBAAiB;YAsCjB,qBAAqB;YAoCrB,gBAAgB;YAQhB,aAAa;YASb,kBAAkB;YAqBlB,sBAAsB;CAmBrC"}
+{"version":3,"file":"TerminalFocusManager.d.ts","sourceRoot":"","sources":["../../src/terminal/TerminalFocusManager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,CAAC;AACxB,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAE5D,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAN,KAAK,CAAC,EAAE,mBAAmB,YAAA;IAElD,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAuB3D,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;CAelE"}

package/dist/terminal/TerminalFocusManager.js

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

package/dist/terminal/TerminalFocusManager.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/terminal/TerminalFocusManager.ts"],"sourcesContent":["import { execFile } from \"child_process\";\nimport { promisify } from \"util\";\nimport { getProcessTty } from \"../utils/process.js\";\nimport { escapeAppleScript } from \"../utils/applescript.js\";\n\nconst execFileAsync = promisify(execFile);\n\nexport enum TerminalType {\n  TMUX = \"tmux\",\n  WEZTERM = \"wezterm\",\n  ITERM2 = \"iterm2\",\n  TERMINAL_APP = \"terminal-app\",\n  UNKNOWN = \"unknown\",\n}\n\nexport interface TerminalLocation {\n  type: TerminalType;\n  identifier: string; // e.g., \"session:window.pane\" for tmux, WezTerm pane id, or TTY for others\n  tty: string; // e.g., \"/dev/ttys030\"\n}\n\n/**\n * Subset of a `wezterm cli list --format json` entry. Only `pane_id` and\n * `tty_name` are read; extra fields are ignored so schema additions across\n * WezTerm versions don't break parsing. (The TTY is exposed as `tty_name` in\n * the JSON, not `tty`.)\n */\ninterface WeztermPaneEntry {\n  pane_id?: number;\n  tty_name?: string | null;\n}\n\n/**\n * Optional trace sink. When provided to {@link TerminalFocusManager}, each\n * discovery/focus step reports a human-readable line so callers (e.g. the\n * `agent open --debug` command) can inspect the matching/focus decision path.\n */\nexport type TerminalDebugLogger = (message: string) => void;\n\nexport class TerminalFocusManager {\n  constructor(private readonly debug?: TerminalDebugLogger) {}\n\n  /**\n   * Find the terminal location (emulator info) for a given process ID\n   */\n  async findTerminal(pid: number): Promise<TerminalLocation | null> {\n    const ttyShort = getProcessTty(pid);\n\n    // If no TTY or invalid, we can't find the terminal\n    if (!ttyShort || ttyShort === \"?\") {\n      this.debug?.(`findTerminal(pid=${pid}): no usable TTY, cannot resolve terminal`);\n      return null;\n    }\n\n    const fullTty = `/dev/${ttyShort}`;\n    this.debug?.(`findTerminal(pid=${pid}): resolving terminal for ${fullTty}`);\n\n    // 1. Check tmux (most specific if running inside it)\n    const tmuxLocation = await this.findTmuxPane(fullTty);\n    if (tmuxLocation) {\n      this.debug?.(`findTerminal: matched tmux (identifier=${tmuxLocation.identifier})`);\n      return tmuxLocation;\n    }\n    this.debug?.(\"findTerminal: tmux no match\");\n\n    // 2. Check WezTerm (cross-platform, via its CLI — no AppleScript)\n    const weztermLocation = await this.findWeztermPane(fullTty);\n    if (weztermLocation) {\n      this.debug?.(`findTerminal: matched wezterm (pane_id=${weztermLocation.identifier})`);\n      return weztermLocation;\n    }\n    this.debug?.(\"findTerminal: wezterm no match\");\n\n    // 3. Check iTerm2\n    const itermLocation = await this.findITerm2Session(fullTty);\n    if (itermLocation) {\n      this.debug?.(`findTerminal: matched iTerm2 (tty=${itermLocation.tty})`);\n      return itermLocation;\n    }\n    this.debug?.(\"findTerminal: iTerm2 no match\");\n\n    // 4. Check Terminal.app\n    const terminalAppLocation = await this.findTerminalAppWindow(fullTty);\n    if (terminalAppLocation) {\n      this.debug?.(`findTerminal: matched Terminal.app (tty=${terminalAppLocation.tty})`);\n      return terminalAppLocation;\n    }\n    this.debug?.(\"findTerminal: Terminal.app no match\");\n\n    // 5. Fallback: we know the TTY but not the emulator wrapper\n    this.debug?.(\"findTerminal: no emulator matched; returning UNKNOWN\");\n    return {\n      type: TerminalType.UNKNOWN,\n      identifier: \"\",\n      tty: fullTty,\n    };\n  }\n\n  /**\n   * Focus the terminal identified by the location\n   */\n  async focusTerminal(location: TerminalLocation): Promise<boolean> {\n    this.debug?.(\n      `focusTerminal: focusing ${location.type} (identifier=${location.identifier}, tty=${location.tty})`,\n    );\n    let success = false;\n    try {\n      switch (location.type) {\n        case TerminalType.TMUX:\n          success = await this.focusTmuxPane(location.identifier);\n          break;\n        case TerminalType.WEZTERM:\n          success = await this.focusWeztermPane(location.identifier);\n          break;\n        case TerminalType.ITERM2:\n          success = await this.focusITerm2Session(location.tty);\n          break;\n        case TerminalType.TERMINAL_APP:\n          success = await this.focusTerminalAppWindow(location.tty);\n          break;\n        default:\n          success = false;\n      }\n    } catch {\n      success = false;\n    }\n    this.debug?.(`focusTerminal: ${success ? \"succeeded\" : \"failed\"} for ${location.type}`);\n    return success;\n  }\n\n  private async findWeztermPane(tty: string): Promise<TerminalLocation | null> {\n    try {\n      const { stdout } = await execFileAsync(\"wezterm\", [\"cli\", \"list\", \"--format\", \"json\"]);\n\n      const panes = JSON.parse(stdout) as WeztermPaneEntry[];\n      if (!Array.isArray(panes)) return null;\n\n      for (const pane of panes) {\n        if (\n          pane &&\n          typeof pane.tty_name === \"string\" &&\n          pane.tty_name === tty &&\n          pane.pane_id != null\n        ) {\n          return {\n            type: TerminalType.WEZTERM,\n            identifier: String(pane.pane_id),\n            tty,\n          };\n        }\n      }\n    } catch {\n      // wezterm not installed, not running, or returned invalid JSON\n    }\n    return null;\n  }\n\n  private async focusWeztermPane(paneId: string): Promise<boolean> {\n    try {\n      await execFileAsync(\"wezterm\", [\"cli\", \"activate-pane\", \"--pane-id\", paneId]);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private async findTmuxPane(tty: string): Promise<TerminalLocation | null> {\n    try {\n      const { stdout } = await execFileAsync(\"tmux\", [\n        \"list-panes\",\n        \"-a\",\n        \"-F\",\n        \"#{pane_tty}|#{session_name}:#{window_index}.#{pane_index}\",\n      ]);\n\n      const lines = stdout.trim().split(\"\\n\");\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        const [paneTty, identifier] = line.split(\"|\");\n        if (paneTty === tty && identifier) {\n          return {\n            type: TerminalType.TMUX,\n            identifier,\n            tty,\n          };\n        }\n      }\n    } catch {\n      // tmux might not be installed or running\n    }\n    return null;\n  }\n\n  private async findITerm2Session(tty: string): Promise<TerminalLocation | null> {\n    try {\n      // Check if iTerm2 is running first to avoid launching it.\n      if (!(await this.isProcessRunning(\"iTerm2\"))) return null;\n    } catch {\n      return null;\n    }\n\n    try {\n      const escapedTty = escapeAppleScript(tty);\n      const script = `\n        tell application \"iTerm\"\n          repeat with w in windows\n            repeat with t in tabs of w\n              repeat with s in sessions of t\n                if tty of s is \"${escapedTty}\" then\n                  return \"found\"\n                end if\n              end repeat\n            end repeat\n          end repeat\n        end tell\n      `;\n\n      const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n      if (stdout.trim() === \"found\") {\n        return {\n          type: TerminalType.ITERM2,\n          identifier: tty,\n          tty,\n        };\n      }\n    } catch {\n      // iTerm2 script failed\n    }\n    return null;\n  }\n\n  private async findTerminalAppWindow(tty: string): Promise<TerminalLocation | null> {\n    try {\n      // Check if Terminal.app is running\n      if (!(await this.isProcessRunning(\"Terminal\"))) return null;\n    } catch {\n      return null;\n    }\n\n    try {\n      const escapedTty = escapeAppleScript(tty);\n      const script = `\n        tell application \"Terminal\"\n          repeat with w in windows\n            repeat with t in tabs of w\n              if tty of t is \"${escapedTty}\" then\n                return \"found\"\n              end if\n            end repeat\n          end repeat\n        end tell\n      `;\n\n      const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n      if (stdout.trim() === \"found\") {\n        return {\n          type: TerminalType.TERMINAL_APP,\n          identifier: tty,\n          tty,\n        };\n      }\n    } catch {\n      // Terminal.app script failed\n    }\n    return null;\n  }\n\n  private async isProcessRunning(name: string): Promise<boolean> {\n    const { stdout } = await execFileAsync(\"ps\", [\"-Axo\", \"comm\"]);\n    return stdout\n      .split(\"\\n\")\n      .map((line) => line.trim())\n      .some((command) => command === name || command.endsWith(`/${name}`));\n  }\n\n  private async focusTmuxPane(identifier: string): Promise<boolean> {\n    try {\n      await execFileAsync(\"tmux\", [\"switch-client\", \"-t\", identifier]);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private async focusITerm2Session(tty: string): Promise<boolean> {\n    const escapedTty = escapeAppleScript(tty);\n    const script = `\n       tell application \"iTerm\"\n         activate\n         repeat with w in windows\n           repeat with t in tabs of w\n             repeat with s in sessions of t\n               if tty of s is \"${escapedTty}\" then\n                 select s\n                 return \"true\"\n               end if\n             end repeat\n           end repeat\n         end repeat\n       end tell\n     `;\n    const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n    return stdout.trim() === \"true\";\n  }\n\n  private async focusTerminalAppWindow(tty: string): Promise<boolean> {\n    const escapedTty = escapeAppleScript(tty);\n    const script = `\n       tell application \"Terminal\"\n         activate\n         repeat with w in windows\n           repeat with t in tabs of w\n             if tty of t is \"${escapedTty}\" then\n               set index of w to 1\n               set selected tab of w to t\n               return \"true\"\n             end if\n           end repeat\n         end repeat\n       end tell\n    `;\n    const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n    return stdout.trim() === \"true\";\n  }\n}\n"],"names":["execFile","promisify","getProcessTty","escapeAppleScript","execFileAsync","TerminalType","TerminalFocusManager","debug","findTerminal","pid","ttyShort","fullTty","tmuxLocation","findTmuxPane","identifier","weztermLocation","findWeztermPane","itermLocation","findITerm2Session","tty","terminalAppLocation","findTerminalAppWindow","type","focusTerminal","location","success","focusTmuxPane","focusWeztermPane","focusITerm2Session","focusTerminalAppWindow","stdout","panes","JSON","parse","Array","isArray","pane","tty_name","pane_id","String","paneId","lines","trim","split","line","paneTty","isProcessRunning","escapedTty","script","name","map","some","command","endsWith"],"mappings":"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"}
+{"version":3,"sources":["../../src/terminal/TerminalFocusManager.ts"],"sourcesContent":["import { getProcessTty } from \"../utils/process.js\";\nimport { TERMINAL_BACKENDS, terminalBackendFor } from \"./backends/index.js\";\nimport { TerminalType, type TerminalLocation } from \"./types.js\";\n\nexport { TerminalType };\nexport type { TerminalLocation };\n\n/** Optional trace sink for terminal discovery and focus decisions. */\nexport type TerminalDebugLogger = (message: string) => void;\n\nexport class TerminalFocusManager {\n  constructor(private readonly debug?: TerminalDebugLogger) {}\n\n  async findTerminal(pid: number): Promise<TerminalLocation | null> {\n    const tty = getProcessTty(pid);\n    if (!tty || tty === \"?\") {\n      this.debug?.(`findTerminal(pid=${pid}): no usable TTY, cannot resolve terminal`);\n      return null;\n    }\n\n    const fullTty = `/dev/${tty}`;\n    this.debug?.(`findTerminal(pid=${pid}): resolving terminal for ${fullTty}`);\n\n    for (const backend of TERMINAL_BACKENDS) {\n      const location = await backend.find(fullTty);\n      if (location) {\n        this.debug?.(`findTerminal: matched ${backend.label} (identifier=${location.identifier})`);\n        return location;\n      }\n      this.debug?.(`findTerminal: ${backend.label} no match`);\n    }\n\n    this.debug?.(\"findTerminal: no emulator matched; returning UNKNOWN\");\n    return { type: TerminalType.UNKNOWN, identifier: \"\", tty: fullTty };\n  }\n\n  async focusTerminal(location: TerminalLocation): Promise<boolean> {\n    this.debug?.(\n      `focusTerminal: focusing ${location.type} (identifier=${location.identifier}, tty=${location.tty})`,\n    );\n\n    let success = false;\n    try {\n      success = (await terminalBackendFor(location.type)?.focus(location)) ?? false;\n    } catch {\n      success = false;\n    }\n\n    this.debug?.(`focusTerminal: ${success ? \"succeeded\" : \"failed\"} for ${location.type}`);\n    return success;\n  }\n}\n"],"names":["getProcessTty","TERMINAL_BACKENDS","terminalBackendFor","TerminalType","TerminalFocusManager","debug","findTerminal","pid","tty","fullTty","backend","location","find","label","identifier","type","UNKNOWN","focusTerminal","success","focus"],"mappings":"AAAA,SAASA,aAAa,QAAQ,sBAAsB;AACpD,SAASC,iBAAiB,EAAEC,kBAAkB,QAAQ,sBAAsB;AAC5E,SAASC,YAAY,QAA+B,aAAa;AAEjE,SAASA,YAAY,GAAG;AAMxB,OAAO,MAAMC;;IACX,YAAY,AAAiBC,KAA2B,CAAE;aAA7BA,QAAAA;IAA8B;IAE3D,MAAMC,aAAaC,GAAW,EAAoC;QAChE,MAAMC,MAAMR,cAAcO;QAC1B,IAAI,CAACC,OAAOA,QAAQ,KAAK;YACvB,IAAI,CAACH,KAAK,GAAG,CAAC,iBAAiB,EAAEE,IAAI,yCAAyC,CAAC;YAC/E,OAAO;QACT;QAEA,MAAME,UAAU,CAAC,KAAK,EAAED,KAAK;QAC7B,IAAI,CAACH,KAAK,GAAG,CAAC,iBAAiB,EAAEE,IAAI,0BAA0B,EAAEE,SAAS;QAE1E,KAAK,MAAMC,WAAWT,kBAAmB;YACvC,MAAMU,WAAW,MAAMD,QAAQE,IAAI,CAACH;YACpC,IAAIE,UAAU;gBACZ,IAAI,CAACN,KAAK,GAAG,CAAC,sBAAsB,EAAEK,QAAQG,KAAK,CAAC,aAAa,EAAEF,SAASG,UAAU,CAAC,CAAC,CAAC;gBACzF,OAAOH;YACT;YACA,IAAI,CAACN,KAAK,GAAG,CAAC,cAAc,EAAEK,QAAQG,KAAK,CAAC,SAAS,CAAC;QACxD;QAEA,IAAI,CAACR,KAAK,GAAG;QACb,OAAO;YAAEU,MAAMZ,aAAaa,OAAO;YAAEF,YAAY;YAAIN,KAAKC;QAAQ;IACpE;IAEA,MAAMQ,cAAcN,QAA0B,EAAoB;QAChE,IAAI,CAACN,KAAK,GACR,CAAC,wBAAwB,EAAEM,SAASI,IAAI,CAAC,aAAa,EAAEJ,SAASG,UAAU,CAAC,MAAM,EAAEH,SAASH,GAAG,CAAC,CAAC,CAAC;QAGrG,IAAIU,UAAU;QACd,IAAI;YACFA,UAAU,AAAC,MAAMhB,mBAAmBS,SAASI,IAAI,GAAGI,MAAMR,aAAc;QAC1E,EAAE,OAAM;YACNO,UAAU;QACZ;QAEA,IAAI,CAACb,KAAK,GAAG,CAAC,eAAe,EAAEa,UAAU,cAAc,SAAS,KAAK,EAAEP,SAASI,IAAI,EAAE;QACtF,OAAOG;IACT;AACF"}

package/dist/terminal/TtyWriter.d.ts

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

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

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