@agentdeck/bridge 1.0.1 → 1.0.3

package/dist/observed-inject.js

@@ -0,0 +1,405 @@
+/**
+ * Deliver an option selection INTO an observed session's own UI — the rung of
+ * the observed-steering ladder that answers a live prompt without any
+ * hold-and-timeout machinery: the prompt is already on screen; the daemon does
+ * what the user would do, and if it cannot reach the UI **nothing happens**
+ * (the prompt keeps waiting — never an auto-proceed).
+ *
+ * Two families of host, resolved by the passive observer:
+ *
+ *   Terminal-hosted (`tty` known) — the session runs in a real terminal, so
+ *   the answer is keystrokes into that terminal's own input:
+ *     1. tmux — the pane whose `#{pane_tty}` matches gets `send-keys`.
+ *     2. iTerm2 — the session whose `tty` matches gets `write text` (no focus
+ *        change; iTerm2 writes straight into the session).
+ *     3. Terminal.app — has no write API, so: select the tab owning that tty
+ *        (scriptable, no activation) and post keys to Terminal's pid.
+ *
+ *   App-hosted (`appName` known, no tty) — Claude.app / ChatGPT.app run the
+ *   agent inside a native window, so the answer is that window's own control:
+ *     4. Press the button whose title matches the chosen option's label
+ *        (AXPress — precise; works for native AppKit dialogs).
+ *     5. Post keys to the app's pid (focus-free).
+ *     6. Raise + keys + restore, only if the app ignores posted events.
+ *
+ * Every rung is focus-free except the last: measured 2026-07-26, keys posted
+ * with `CGEventPostToPid` reached a background Terminal tab while iTerm2
+ * stayed frontmost.
+ *
+ * Two measured dead ends, recorded so they are not retried:
+ *   • TIOCSTI — the one kernel path that would cover every emulator at once —
+ *     is EPERM on macOS unless the tty is the caller's own controlling
+ *     terminal.
+ *   • ChatGPT.app exposes no content in its accessibility tree (its window is
+ *     three untitled AXButtons plus empty AXGroups, and
+ *     `AXManualAccessibility` returns kAXErrorAttributeUnsupported), so the
+ *     button rung cannot see its controls — key posting is the working path
+ *     for that host.
+ *
+ * Node-daemon only by design: every rung needs a subprocess (tmux/osascript),
+ * which the App Store Swift daemon must never spawn. See
+ * docs/appstore-feature-matrix.md.
+ */
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { debug } from './logger.js';
+const execFileAsync = promisify(execFile);
+/** Known bundle ids for GUI agent hosts — matched before localized names,
+ *  which differ per system language. */
+const APP_BUNDLE_IDS = {
+    Claude: ['com.anthropic.claudefordesktop', 'com.anthropic.claude'],
+    ChatGPT: ['com.openai.chat'],
+    Terminal: ['com.apple.Terminal'],
+    iTerm2: ['com.googlecode.iterm2'],
+};
+/** AppleScript string literal escaping (quotes + backslashes). */
+export function escapeAppleScript(s) {
+    return s.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+/** Parse `tmux list-panes -a -F "#{pane_tty}\t#{pane_id}"` output into a
+ *  tty-suffix → paneId map ("/dev/ttys012" is matched by "ttys012"). */
+export function parseTmuxPanes(output) {
+    const map = new Map();
+    for (const line of output.split('\n')) {
+        const [paneTty, paneId] = line.trim().split('\t');
+        if (!paneTty || !paneId)
+            continue;
+        map.set(paneTty.replace(/^\/dev\//, ''), paneId);
+    }
+    return map;
+}
+async function injectViaTmux(tty, downs) {
+    try {
+        const { stdout } = await execFileAsync('tmux', ['list-panes', '-a', '-F', '#{pane_tty}\t#{pane_id}'], { encoding: 'utf8', timeout: 2_000 });
+        const paneId = parseTmuxPanes(stdout).get(tty);
+        if (!paneId)
+            return false;
+        const keys = [...Array(downs).fill('Down'), 'Enter'];
+        await execFileAsync('tmux', ['send-keys', '-t', paneId, ...keys], { timeout: 2_000 });
+        return true;
+    }
+    catch {
+        return false; // no tmux server / pane gone — fall through the ladder
+    }
+}
+/** AppleScript that types the selection into the iTerm2 session owning `tty`. */
+export function buildItermSelectScript(tty, downs) {
+    // ESC [ B per Down, then a bare `write text ""` for Enter (write text
+    // appends CR by default; the arrow writes suppress it with `newline NO`).
+    const writes = [];
+    for (let i = 0; i < downs; i++) {
+        writes.push('write s text ((character id 27) & "[B") newline NO');
+    }
+    writes.push('write s text ""');
+    return [
+        'tell application "iTerm2"',
+        '  repeat with w in windows',
+        '    repeat with t in tabs of w',
+        '      repeat with s in sessions of t',
+        `        if tty of s is "/dev/${tty}" then`,
+        ...writes.map((l) => `          ${l}`),
+        '          return "ok"',
+        '        end if',
+        '      end repeat',
+        '    end repeat',
+        '  end repeat',
+        'end tell',
+        'return "notfound"',
+    ].join('\n');
+}
+/**
+ * AppleScript for Terminal.app: select the tab whose `tty` matches, WITHOUT
+ * activating the app. Keys are then posted straight to Terminal's pid
+ * (`buildPostKeysScript`), so answering a prompt never steals the user's
+ * focus — measured 2026-07-26: iTerm2 stayed frontmost while the Terminal
+ * tab received ESC[B + CR.
+ */
+export function buildTerminalAppSelectTabScript(tty) {
+    return [
+        'set found to false',
+        'tell application "Terminal"',
+        '  repeat with w in windows',
+        '    repeat with t in tabs of w',
+        `      if tty of t is "/dev/${tty}" then`,
+        '        set selected of t to true',
+        '        set index of w to 1',
+        '        set found to true',
+        '        exit repeat',
+        '      end if',
+        '    end repeat',
+        '    if found then exit repeat',
+        '  end repeat',
+        'end tell',
+        'if found then',
+        '  return "ok"',
+        'else',
+        '  return "notfound"',
+        'end if',
+    ].join('\n');
+}
+/**
+ * JXA that posts Down×n + Return directly to a running app's process with
+ * `CGEventPostToPid` — the event reaches that app's key window without
+ * raising it, so the user's foreground work is untouched.
+ *
+ * The app is matched by bundle id first and localized name second: on a
+ * Korean system `Terminal` is "터미널", so name matching alone silently
+ * missed it.
+ *
+ * Requires Accessibility permission for whatever process runs the daemon
+ * (the terminal that launched it, or the LaunchAgent itself).
+ */
+export function buildPostKeysScript(match, downs) {
+    const bundles = JSON.stringify(match.bundleIds ?? []);
+    const names = JSON.stringify(match.names ?? []);
+    return [
+        "ObjC.import('ApplicationServices'); ObjC.import('AppKit');",
+        `const wantBundles = ${bundles}; const wantNames = ${names};`,
+        'function findPid() {',
+        '  const apps = $.NSWorkspace.sharedWorkspace.runningApplications;',
+        '  for (let i = 0; i < apps.count; i++) {',
+        '    const a = apps.objectAtIndex(i);',
+        '    const b = ObjC.unwrap(a.bundleIdentifier);',
+        '    if (b && wantBundles.indexOf(b) >= 0) return a.processIdentifier;',
+        '  }',
+        '  for (let i = 0; i < apps.count; i++) {',
+        '    const a = apps.objectAtIndex(i);',
+        '    const n = ObjC.unwrap(a.localizedName);',
+        '    if (n && wantNames.indexOf(n) >= 0) return a.processIdentifier;',
+        '  }',
+        '  return -1;',
+        '}',
+        'const pid = findPid();',
+        'if (pid < 0) { "notfound" } else {',
+        '  function key(code) {',
+        '    const d = $.CGEventCreateKeyboardEvent($(), code, true);',
+        '    const u = $.CGEventCreateKeyboardEvent($(), code, false);',
+        '    $.CGEventPostToPid(pid, d); $.CGEventPostToPid(pid, u);',
+        '    delay(0.12);',
+        '  }',
+        // A background app drops the first posted events until its input queue is
+        // warm: measured with 0.05s pacing and no lead-in, two Downs vanished and
+        // only the Return landed (which would silently pick the WRONG option).
+        '  delay(0.30);',
+        `  for (let i = 0; i < ${downs}; i++) key(125);`,
+        '  key(36);',
+        '  "ok"',
+        '}',
+    ].join('\n');
+}
+/**
+ * AppleScript for an app-hosted session: press the button whose title matches
+ * the option label inside the app's front window. Matching is
+ * case-insensitive and prefix-tolerant (native buttons often shorten a long
+ * option label). AXPress needs no focus change, so this is the preferred
+ * app-hosted rung.
+ */
+export function buildAppButtonPressScript(appName, label) {
+    const app = escapeAppleScript(appName);
+    // AppleScript text comparison ignores case by default — no lowercasing dance.
+    const want = escapeAppleScript(label.trim());
+    // `entire contents` yields a flat element list; AppleScript cannot filter it
+    // with `every button of …`, so iterate and test the accessibility role.
+    return [
+        `tell application "System Events" to tell process "${app}"`,
+        '  if not (exists window 1) then return "nowindow"',
+        '  set target to missing value',
+        '  repeat with e in (entire contents of window 1)',
+        '    try',
+        '      if role of e is "AXButton" or role of e is "AXRadioButton" then',
+        '        set bt to name of e',
+        '        if bt is not missing value and bt is not "" then',
+        `          if bt is "${want}" or bt starts with "${want}" or "${want}" starts with bt then`,
+        '            set target to e',
+        '            exit repeat',
+        '          end if',
+        '        end if',
+        '      end if',
+        '    end try',
+        '  end repeat',
+        '  if target is missing value then return "nobutton"',
+        '  click target',
+        '  return "ok"',
+        'end tell',
+    ].join('\n');
+}
+/**
+ * Last-resort key path: raise the app, post Down×n + Return through System
+ * Events, restore the previous frontmost app. Only used when the focus-free
+ * `CGEventPostToPid` route reports the app is not running or the app ignores
+ * posted events.
+ */
+export function buildAppKeysScript(appName, downs) {
+    const app = escapeAppleScript(appName);
+    const keyLines = [];
+    for (let i = 0; i < downs; i++)
+        keyLines.push('key code 125');
+    keyLines.push('key code 36');
+    return [
+        'set prevApp to ""',
+        'try',
+        '  tell application "System Events" to set prevApp to name of first process whose frontmost is true',
+        'end try',
+        `tell application "${app}" to activate`,
+        'delay 0.15',
+        'tell application "System Events"',
+        ...keyLines.map((l) => `  ${l}`),
+        'end tell',
+        'delay 0.05',
+        `if prevApp is not "" and prevApp is not "${app}" then`,
+        '  try',
+        '    tell application prevApp to activate',
+        '  end try',
+        'end if',
+        'return "ok"',
+    ].join('\n');
+}
+async function runJxa(script, timeoutMs = 8_000) {
+    try {
+        const { stdout } = await execFileAsync('osascript', ['-l', 'JavaScript', '-e', script], { encoding: 'utf8', timeout: timeoutMs });
+        return stdout.trim();
+    }
+    catch (err) {
+        debug('inject', `jxa failed: ${String(err).slice(0, 200)}`);
+        return null;
+    }
+}
+async function runOsa(script, timeoutMs = 8_000) {
+    try {
+        const { stdout } = await execFileAsync('osascript', ['-e', script], { encoding: 'utf8', timeout: timeoutMs });
+        return stdout.trim();
+    }
+    catch (err) {
+        debug('inject', `osascript failed: ${String(err).slice(0, 200)}`);
+        return null;
+    }
+}
+/**
+ * Answer the session's on-screen prompt by driving its host UI.
+ * `index` is the zero-based option position (Claude's pickers start with the
+ * cursor on the first option, so index == the number of Down presses).
+ */
+export async function injectObservedSelection(target, index) {
+    if (index < 0 || index > 16)
+        return { ok: false, reason: 'index out of range' };
+    const { tty, appName, label } = target;
+    if (!tty && !appName)
+        return { ok: false, reason: 'no tty or app host for session' };
+    if (tty) {
+        if (await injectViaTmux(tty, index))
+            return { ok: true, via: 'tmux' };
+        if (await runOsa(buildItermSelectScript(tty, index), 5_000) === 'ok') {
+            return { ok: true, via: 'iterm2' };
+        }
+        // Terminal.app: select the owning tab (no activation), then post keys to
+        // its pid — focus-free.
+        if (await runOsa(buildTerminalAppSelectTabScript(tty), 5_000) === 'ok') {
+            const posted = await runJxa(buildPostKeysScript({ bundleIds: ['com.apple.Terminal'], names: ['Terminal', '터미널'] }, index));
+            if (posted === 'ok')
+                return { ok: true, via: 'terminal-app' };
+            debug('inject', `Terminal.app tab selected but key post failed: ${posted ?? 'error'}`);
+        }
+        return { ok: false, reason: `no reachable terminal for ${tty}` };
+    }
+    // App-hosted. Try the labelled control first (works for native AppKit
+    // dialogs); then focus-free key posting; raise+restore only as last resort.
+    if (label) {
+        const r = await runOsa(buildAppButtonPressScript(appName, label));
+        if (r === 'ok')
+            return { ok: true, via: 'app-button' };
+        debug('inject', `app-button press on ${appName}: ${r ?? 'error'}`);
+    }
+    const posted = await runJxa(buildPostKeysScript({ bundleIds: APP_BUNDLE_IDS[appName] ?? [], names: [appName] }, index));
+    if (posted === 'ok')
+        return { ok: true, via: 'app-keys' };
+    if (await runOsa(buildAppKeysScript(appName, index)) === 'ok') {
+        return { ok: true, via: 'app-keys-raised' };
+    }
+    return { ok: false, reason: `no reachable UI in ${appName}` };
+}
+/**
+ * Type a whole line of text into the session's terminal and submit it — the
+ * delivery path for a dictated prompt. Same host ladder as
+ * `injectObservedSelection`, but writing text instead of arrow keys.
+ *
+ * Only terminal hosts are supported: typing free text into a GUI app's focused
+ * field is far riskier (no way to know what has focus), and a spoken prompt
+ * that lands in the wrong place is worse than one that is refused.
+ */
+export async function injectObservedText(target, text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return { ok: false, reason: 'empty text' };
+    // Newlines would submit early and split the prompt across turns.
+    const line = trimmed.replace(/[\r\n]+/g, ' ');
+    const { tty } = target;
+    if (!tty)
+        return { ok: false, reason: 'no tty for session (text injection is terminal-only)' };
+    // tmux: -l sends the payload literally, then a separate Enter submits it.
+    try {
+        const { stdout } = await execFileAsync('tmux', ['list-panes', '-a', '-F', '#{pane_tty}\t#{pane_id}'], { encoding: 'utf8', timeout: 2_000 });
+        const paneId = parseTmuxPanes(stdout).get(tty);
+        if (paneId) {
+            await execFileAsync('tmux', ['send-keys', '-t', paneId, '-l', line], { timeout: 2_000 });
+            // Same beat as above: process spawn alone happens to provide ~50 ms, which
+            // is not a guarantee worth relying on for the keystroke that commits.
+            await new Promise((r) => setTimeout(r, 250));
+            await execFileAsync('tmux', ['send-keys', '-t', paneId, 'Enter'], { timeout: 2_000 });
+            return { ok: true, via: 'tmux' };
+        }
+    }
+    catch { /* no tmux server — fall through */ }
+    // iTerm2: type the line, pause, then submit with an explicit carriage return.
+    //
+    // `write text "..."` alone would do both — measured in raw mode it delivers
+    // the text followed by 0x0d, which is the right byte (0x0a would land as a
+    // newline *inside* the prompt instead of submitting it; the tty's ICRNL
+    // translation hides that difference from any canonical-mode probe, so test
+    // this with `stty raw` or the reading is meaningless). It is split anyway
+    // because a TUI that treats one burst as a paste can absorb a trailing return
+    // as content, and the same missing beat cost us the option keys earlier.
+    const iterm = [
+        'tell application "iTerm2"',
+        '  repeat with w in windows',
+        '    repeat with t in tabs of w',
+        '      repeat with s in sessions of t',
+        `        if tty of s is "/dev/${tty}" then`,
+        `          write s text "${escapeAppleScript(line)}" newline NO`,
+        '          delay 0.25',
+        '          write s text (ASCII character 13) newline NO',
+        '          return "ok"',
+        '        end if',
+        '      end repeat',
+        '    end repeat',
+        '  end repeat',
+        'end tell',
+        'return "notfound"',
+    ].join('\n');
+    if (await runOsa(iterm, 5_000) === 'ok')
+        return { ok: true, via: 'iterm2' };
+    // Terminal.app: `do script … in <tab>` types into that tab and returns.
+    const term = [
+        'set done to false',
+        'tell application "Terminal"',
+        '  repeat with w in windows',
+        '    repeat with t in tabs of w',
+        `      if tty of t is "/dev/${tty}" then`,
+        `        do script "${escapeAppleScript(line)}" in t`,
+        '        set done to true',
+        '        exit repeat',
+        '      end if',
+        '    end repeat',
+        '    if done then exit repeat',
+        '  end repeat',
+        'end tell',
+        'if done then',
+        '  return "ok"',
+        'else',
+        '  return "notfound"',
+        'end if',
+    ].join('\n');
+    if (await runOsa(term, 5_000) === 'ok')
+        return { ok: true, via: 'terminal-app' };
+    return { ok: false, reason: `no reachable terminal for ${tty}` };
+}
+//# sourceMappingURL=observed-inject.js.map

package/dist/observed-inject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observed-inject.js","sourceRoot":"","sources":["../src/observed-inject.ts"],"names":[],"mappings":"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"}

package/dist/passive-observer.d.ts

@@ -3,6 +3,8 @@ export type ObservedState = 'idle' | 'processing';
 export interface ProcInfo {
     pid: number;
     ppid: number;
+    /** Controlling terminal short name ("ttys008") or "??" for none. */
+    tty?: string;
     rssKb: number;
     command: string;
 }
@@ -22,6 +24,11 @@ export interface TranscriptSummary {
  */
 export declare function cleanGoal(raw: string): string;
 export interface ObservedSession extends EnrichedSession {
+    /** Controlling terminal ("ttys008") — the observed-answer injection target. */
+    tty?: string;
+    /** Owning .app for GUI-hosted sessions ("Claude", "ChatGPT") — the app-hosted
+     *  injection target when there is no tty. */
+    appName?: string;
     controlMode: 'observed';
     pid: number;
     cwd?: string;
@@ -65,6 +72,13 @@ export declare function parseCodexRollout(raw: string): TranscriptSummary & {
     effort?: string;
     hasPendingCalls?: boolean;
 };
+/** Extract the enclosing macOS app name from an executable path, e.g.
+ *  "/Applications/ChatGPT.app/Contents/Resources/codex …" → "ChatGPT". */
+export declare function appNameFromCommand(command: string): string | undefined;
+/** Walk up the process tree (bounded) looking for the .app bundle that hosts
+ *  this process. GUI-hosted agent sessions (Claude.app, ChatGPT.app) have no
+ *  tty, so the owning app is how the injector finds their UI. */
+export declare function resolveHostApp(pid: number, byPid: Map<number, ProcInfo>, maxDepth?: number): string | undefined;
 export declare function isAntigravityProcessCommand(command: string): boolean;
 export declare function parseLsofRollouts(output: string): Map<number, string>;
 //# sourceMappingURL=passive-observer.d.ts.map

package/dist/passive-observer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"passive-observer.d.ts","sourceRoot":"","sources":["../src/passive-observer.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAW/D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,YAAY,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAgBD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU7C;AASD,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,WAAW,EAAE,UAAU,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;sEAIkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAQD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,YAAY,CAAS;IAE7B;;0DAEsD;IACtD,WAAW,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAEtC;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE;YAYhD,IAAI;CAenB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CAa5D;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAoFpE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,CA6HvK;AA0KD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAapE;AAkID,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAYrE"}
+{"version":3,"file":"passive-observer.d.ts","sourceRoot":"","sources":["../src/passive-observer.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAW/D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,YAAY,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAgBD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU7C;AASD,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;iDAC6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,UAAU,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;sEAIkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAQD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,YAAY,CAAS;IAE7B;;0DAEsD;IACtD,WAAW,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAEtC;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE;YAYhD,IAAI;CAenB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CAc5D;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAoFpE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,CA6HvK;AAeD;0EAC0E;AAC1E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGtE;AAED;;iEAEiE;AACjE,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC5B,QAAQ,SAAI,GACX,MAAM,GAAG,SAAS,CASpB;AAqKD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAapE;AAkID,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAYrE"}

package/dist/passive-observer.js

@@ -5,7 +5,7 @@ import { closeSync, existsSync, lstatSync, openSync, readFileSync, readlinkSync,
 import { basename, join } from 'node:path';
 import { homedir } from 'node:os';
 import { resolveProjectNameFromCwdCached } from './utils/project-name.js';
-import { stripUnsafeText } from '@agentdeck/shared';
+import { stripUnsafeText, rawSessionId } from '@agentdeck/shared';
 import { parseAntigravityTranscript, antigravityDefaultModel, antigravityConversationId, antigravityTranscriptPath, } from './apme/antigravity-transcript.js';
 /** Pull display text out of a Claude user message (string or text blocks). */
 function claudeUserText(message) {
@@ -92,14 +92,15 @@ export class PassiveSessionObserver {
 export function parseProcessTable(output) {
     const rows = [];
     for (const line of output.split('\n')) {
-        const match = line.match(/^\s*(\d+)\s+(\d+)\s+(\d+)\s+(.+?)\s*$/);
+        const match = line.match(/^\s*(\d+)\s+(\d+)\s+(\d+)\s+(\S+)\s+(.+?)\s*$/);
         if (!match)
             continue;
         rows.push({
             pid: Number(match[1]),
             ppid: Number(match[2]),
             rssKb: Number(match[3]),
-            command: match[4] ?? '',
+            tty: match[4] === '??' ? undefined : match[4],
+            command: match[5] ?? '',
         });
     }
     return rows.filter((p) => p.pid > 0 && p.command.length > 0);
@@ -332,7 +333,7 @@ export function parseCodexRollout(raw) {
 }
 async function collectProcessInfo() {
     try {
-        const { stdout } = await execFileAsync('ps', ['-ww', '-eo', 'pid=,ppid=,rss=,command='], {
+        const { stdout } = await execFileAsync('ps', ['-ww', '-eo', 'pid=,ppid=,rss=,tty=,command='], {
             encoding: 'utf8',
             timeout: 2_000,
             maxBuffer: 2 * 1024 * 1024,
@@ -343,8 +344,30 @@ async function collectProcessInfo() {
         return [];
     }
 }
+/** Extract the enclosing macOS app name from an executable path, e.g.
+ *  "/Applications/ChatGPT.app/Contents/Resources/codex …" → "ChatGPT". */
+export function appNameFromCommand(command) {
+    const m = command.match(/\/([^/]+)\.app\//);
+    return m ? m[1] : undefined;
+}
+/** Walk up the process tree (bounded) looking for the .app bundle that hosts
+ *  this process. GUI-hosted agent sessions (Claude.app, ChatGPT.app) have no
+ *  tty, so the owning app is how the injector finds their UI. */
+export function resolveHostApp(pid, byPid, maxDepth = 6) {
+    let cur = byPid.get(pid);
+    for (let i = 0; i < maxDepth && cur; i++) {
+        const name = appNameFromCommand(cur.command);
+        if (name)
+            return name;
+        if (!cur.ppid || cur.ppid <= 1)
+            break;
+        cur = byPid.get(cur.ppid);
+    }
+    return undefined;
+}
 function collectClaudeSessions(processes) {
     const configDirs = claudeConfigDirs();
+    const byPid = new Map(processes.map((p) => [p.pid, p]));
     const sessions = [];
     for (const proc of processes) {
         if (!cmdHasBinary(proc.command, 'claude') || proc.command.includes('--print'))
@@ -370,6 +393,8 @@ function collectClaudeSessions(processes) {
             startedAt: new Date(sessionFile.startedAt).toISOString(),
             controlMode: 'observed',
             cwd: sessionFile.cwd,
+            tty: proc.tty,
+            appName: proc.tty ? undefined : resolveHostApp(proc.pid, byPid),
             currentTask: summary.currentTask,
             goal: summary.goal,
             contextPercent: summary.contextPercent,
@@ -380,6 +405,7 @@ function collectClaudeSessions(processes) {
     return sessions;
 }
 async function collectCodexSessions(processes) {
+    const byPid = new Map(processes.map((p) => [p.pid, p]));
     const codex = processes.filter((p) => cmdHasBinary(p.command, 'codex') &&
         !p.command.includes('app-server') &&
         !p.command.includes('grep'));
@@ -410,6 +436,10 @@ async function collectCodexSessions(processes) {
             pid: proc.pid,
             projectName: cwd ? projectNameFromCwd(cwd) : 'Codex',
             agentType: 'codex-cli',
+            // Same injection targets as observed Claude: answering or dictating into
+            // a Codex session means typing into the terminal that owns it.
+            tty: proc.tty,
+            appName: proc.tty ? undefined : resolveHostApp(proc.pid, byPid),
             alive: true,
             state,
             modelName: parsed.modelName,
@@ -544,7 +574,7 @@ function dedupeObservedSessions(observed, managedSessions, processes) {
     return observed.filter((session) => {
         if (managedIds.has(session.id))
             return false;
-        const rawId = session.id.replace(/^observed:(?:claude|codex|opencode|antigravity):/, '');
+        const rawId = rawSessionId(session.id);
         if (managedIds.has(rawId))
             return false;
         return !managedPids.some((pid) => pid === session.pid || isDescendantOf(session.pid, pid, byPid));