@monotykamary/localterm-server 2.31.0 → 2.33.0

package/dist/secret-shims.js.map

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

package/dist/session-automation.d.ts

@@ -0,0 +1,53 @@
+import type { CdpClient } from "./cdp/cdp-client.js";
+import type { SessionManager } from "./session-manager.js";
+import type { MouseButton } from "./utils/sgr-mouse.js";
+export interface SessionAutomationDeps {
+    cdpClient: CdpClient | null;
+    buildTabUrl: (sessionId: string) => string;
+}
+export declare const capturePanePng: (deps: SessionAutomationDeps, registry: SessionManager, id: string) => Promise<Buffer | null>;
+interface MouseActionBase {
+    button: MouseButton;
+}
+interface MouseClickColRow extends MouseActionBase {
+    action: "click";
+    col: number;
+    row: number;
+    clicks: number;
+}
+interface MouseClickText extends MouseActionBase {
+    action: "click";
+    onText: string;
+    clicks: number;
+}
+interface MouseDrag extends MouseActionBase {
+    action: "drag";
+    fromCol: number;
+    fromRow: number;
+    toCol: number;
+    toRow: number;
+}
+interface MouseMove {
+    action: "move";
+    col: number;
+    row: number;
+}
+interface MouseScroll {
+    action: "scroll";
+    direction: "up" | "down";
+    amount: number;
+    col: number;
+    row: number;
+}
+export type MouseAction = MouseClickColRow | MouseClickText | MouseDrag | MouseMove | MouseScroll;
+export interface MouseResult {
+    ok: boolean;
+    mode: "cdp" | "sgr";
+    col: number | null;
+    row: number | null;
+    text: string | null;
+    reason: string | null;
+}
+export declare const sendMouse: (deps: SessionAutomationDeps, registry: SessionManager, id: string, action: MouseAction, sgrFallback: (id: string, action: MouseAction, col: number, row: number) => boolean) => Promise<MouseResult>;
+export {};
+//# sourceMappingURL=session-automation.d.ts.map

package/dist/session-automation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-automation.d.ts","sourceRoot":"","sources":["../src/session-automation.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAS3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxD,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAG5B,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C;AAkED,eAAO,MAAM,cAAc,GACzB,MAAM,qBAAqB,EAC3B,UAAU,cAAc,EACxB,IAAI,MAAM,KACT,OAAO,CAAC,MAAM,GAAG,IAAI,CAsBvB,CAAC;AAOF,UAAU,eAAe;IACvB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,UAAU,gBAAiB,SAAQ,eAAe;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,cAAe,SAAQ,eAAe;IAC9C,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,SAAU,SAAQ,eAAe;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAElG,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IAIZ,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IAGpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAGpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAQD,eAAO,MAAM,SAAS,GACpB,MAAM,qBAAqB,EAC3B,UAAU,cAAc,EACxB,IAAI,MAAM,EACV,QAAQ,WAAW,EAGnB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,KAClF,OAAO,CAAC,WAAW,CAyIrB,CAAC"}

package/dist/session-automation.js

@@ -0,0 +1,230 @@
+// CDP-backed terminal-use parity: capture-pane --png and session mouse, built
+// on the insight that the daemon's existing CDP socket (the one `localterm
+// start` opened for background-tab automation) plus the tmux-parity surface
+// compose without new deps. The browser (already a hard dep for the viewer) is
+// the rasterizer; xterm.js (already speaking SGR mouse natively) is the mouse
+// encoder. The tmux-parity capture renderer is the render-landed source of
+// truth and the no-browser fallback for text capture.
+//
+// Reuse strategy: prefer a live viewer tab for the session (zero spawn latency,
+// render already current) before opening an ephemeral background tab. A pinned
+// session (the REST default) survives between calls with no tab burning a slot.
+import { CDP_MOUSE_TIMEOUT_MS, CDP_RENDER_LANDED_POLL_INTERVAL_MS, CDP_RENDER_LANDED_SETTLE_MS, CDP_SCREENSHOT_TIMEOUT_MS, LOCALTERM_MOUSE_CELLS_PROPERTY, LOCALTERM_PANE_TEXT_PROPERTY, } from "./constants.js";
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+// Find an existing viewer tab for `id` (a page whose URL carries `?sid=<id>`),
+// or open an ephemeral background tab and attach it. Returns null when no
+// browser is reachable (caller falls back to the headless SGR path for mouse,
+// or reports no_browser for screenshot).
+const resolveTab = async (deps, id) => {
+    const { cdpClient } = deps;
+    if (!cdpClient)
+        return null;
+    const sidParam = `sid=${encodeURIComponent(id)}`;
+    const existing = await cdpClient.findTargetByUrl((url) => url.includes(sidParam));
+    const targetId = existing ?? (await cdpClient.openBackgroundTab(deps.buildTabUrl(id)));
+    if (!targetId)
+        return null;
+    const cdpSessionId = await cdpClient.attachSession(targetId);
+    if (!cdpSessionId) {
+        if (!existing)
+            await cdpClient.closeTab(targetId);
+        return null;
+    }
+    return {
+        targetId,
+        cdpSessionId,
+        close: existing ? async () => undefined : async () => cdpClient.closeTab(targetId),
+    };
+};
+// Wait for the tab's xterm to render the session's current pane text. Robust
+// against xterm's async write: polls the tab's `__localtermPaneText` and
+// compares to the server-side `capturePane` (flushed, the source of truth) —
+// when they're equal the grid is fully parsed; a short settle covers the
+// canvas paint. Returns true on land, false on timeout (caller screenshots
+// anyway, best effort).
+const waitForRenderLanded = async (cdpClient, cdpSessionId, registry, id, timeoutMs) => {
+    const deadline = Date.now() + timeoutMs;
+    const expr = `window[${JSON.stringify(LOCALTERM_PANE_TEXT_PROPERTY)}]?.() ?? null`;
+    while (Date.now() < deadline) {
+        const expected = await registry.capturePane(id).catch(() => null);
+        const tabText = await cdpClient.evaluateInSession(cdpSessionId, expr);
+        if (expected !== null && tabText === expected) {
+            await sleep(CDP_RENDER_LANDED_SETTLE_MS);
+            return true;
+        }
+        await sleep(CDP_RENDER_LANDED_POLL_INTERVAL_MS);
+    }
+    return false;
+};
+// `capture-pane --png`: render the session's current screen to a PNG via the
+// browser. Reuses an existing viewer tab or opens an ephemeral one; clips to
+// the `.xterm` element so the PNG is just the terminal. Returns the PNG bytes,
+// or null when no browser is reachable (the caller reports `no_browser`; text
+// `capture-pane` still works headlessly via the capture renderer).
+export const capturePanePng = async (deps, registry, id) => {
+    const { cdpClient } = deps;
+    if (!cdpClient)
+        return null;
+    const tab = await resolveTab(deps, id);
+    if (!tab)
+        return null;
+    try {
+        await waitForRenderLanded(cdpClient, tab.cdpSessionId, registry, id, CDP_SCREENSHOT_TIMEOUT_MS);
+        const clipExpr = `(() => {
+      const el = document.querySelector(".xterm");
+      if (!el) return null;
+      const r = el.getBoundingClientRect();
+      return JSON.stringify({ x: r.left, y: r.top, width: r.width, height: r.height });
+    })()`;
+        const clipRaw = await cdpClient.evaluateInSession(tab.cdpSessionId, clipExpr);
+        const clip = typeof clipRaw === "string"
+            ? JSON.parse(clipRaw)
+            : undefined;
+        return cdpClient.captureScreenshotInSession(tab.cdpSessionId, clip);
+    }
+    finally {
+        await tab.close();
+    }
+};
+// `session mouse`: dispatch a mouse gesture. Primary path is CDP — drive the
+// browser's xterm.js, which generates the SGR sequence itself, so drag/scroll/
+// click-count semantics are exactly right with no encoder. Falls back to
+// direct SGR-1006 bytes written to the PTY when no browser is reachable (the
+// true-headless case), gated on the session's mouse mode so the bytes aren't
+// fed to an app that didn't enable mouse.
+export const sendMouse = async (deps, registry, id, action, 
+// Headless SGR fallback (injected from the route to avoid a circular import
+// of the encoder here): writes the encoded sequence to the session PTY.
+sgrFallback) => {
+    const { cdpClient } = deps;
+    // Resolve the target cell for any coord-bearing action. `--on-text` reads the
+    // server-side capture grid (no tab needed) so the fallback path can also
+    // locate a label.
+    let target = null;
+    let labelText = null;
+    if (action.action === "click" && "onText" in action) {
+        const found = await registry.findTextInViewport(id, action.onText);
+        if (!found) {
+            return {
+                ok: false,
+                mode: "sgr",
+                col: null,
+                row: null,
+                text: action.onText,
+                reason: "text_not_found",
+            };
+        }
+        target = found;
+        labelText = action.onText;
+    }
+    else if ("col" in action && "row" in action) {
+        target = { col: action.col, row: action.row };
+    }
+    // Try the CDP path first: dispatch through the tab's xterm.js.
+    if (cdpClient) {
+        const tab = await resolveTab(deps, id);
+        if (tab) {
+            try {
+                await waitForRenderLanded(cdpClient, tab.cdpSessionId, registry, id, CDP_MOUSE_TIMEOUT_MS);
+                const cellsExpr = `window[${JSON.stringify(LOCALTERM_MOUSE_CELLS_PROPERTY)}]?.() ?? null`;
+                const cellsRaw = await cdpClient.evaluateInSession(tab.cdpSessionId, cellsExpr);
+                const cells = typeof cellsRaw === "string"
+                    ? JSON.parse(cellsRaw)
+                    : null;
+                if (!cells) {
+                    return {
+                        ok: false,
+                        mode: "cdp",
+                        col: null,
+                        row: null,
+                        text: labelText,
+                        reason: "no_xterm",
+                    };
+                }
+                // Coords for scroll: default to the viewport center so the wheel lands
+                // on the terminal even when the caller didn't specify a cell.
+                const t = target ?? { col: Math.floor(cells.cols / 2), row: Math.floor(cells.rows / 2) };
+                if (t.col < 0 || t.col >= cells.cols || t.row < 0 || t.row >= cells.rows) {
+                    return {
+                        ok: false,
+                        mode: "cdp",
+                        col: t.col,
+                        row: t.row,
+                        text: labelText,
+                        reason: "out_of_bounds",
+                    };
+                }
+                const px = (col, row) => ({
+                    x: cells.left + (col + 0.5) * cells.cellWidth,
+                    y: cells.top + (row + 0.5) * cells.cellHeight,
+                });
+                const buttonName = action.action === "click" || action.action === "drag" ? action.button : "left";
+                const events = [];
+                if (action.action === "click") {
+                    const at = px(t.col, t.row);
+                    for (let i = 0; i < action.clicks; i++) {
+                        events.push({ type: "mousePressed", ...at, button: buttonName, clickCount: 1 });
+                    }
+                    events.push({
+                        type: "mouseReleased",
+                        ...at,
+                        button: buttonName,
+                        clickCount: action.clicks,
+                    });
+                }
+                else if (action.action === "drag") {
+                    const from = px(action.fromCol, action.fromRow);
+                    const to = px(action.toCol, action.toRow);
+                    events.push({ type: "mousePressed", ...from, button: buttonName, clickCount: 1 });
+                    events.push({ type: "mouseMoved", ...to, button: buttonName, buttons: 1 });
+                    events.push({ type: "mouseReleased", ...to, button: buttonName, clickCount: 1 });
+                }
+                else if (action.action === "move") {
+                    const at = px(t.col, t.row);
+                    events.push({ type: "mouseMoved", ...at, button: "none" });
+                }
+                else {
+                    const at = px(t.col, t.row);
+                    const delta = action.direction === "up" ? -action.amount : action.amount;
+                    events.push({
+                        type: "mouseWheel",
+                        ...at,
+                        deltaX: 0,
+                        deltaY: delta * Math.max(cells.cellHeight, 1),
+                    });
+                }
+                await cdpClient.dispatchMouseEventsInSession(tab.cdpSessionId, events);
+                // CDP dispatch via xterm.js always "succeeds" from our view — whether the
+                // app responds depends on its mouse mode, which xterm gates internally.
+                return { ok: true, mode: "cdp", col: t.col, row: t.row, text: labelText, reason: null };
+            }
+            finally {
+                await tab.close();
+            }
+        }
+    }
+    // Headless fallback: write SGR-1006 bytes straight to the PTY. Gated on the
+    // session's mouse mode so the bytes aren't fed to an app that can't read them.
+    if (!registry.mouseEnabledFor(id)) {
+        return {
+            ok: false,
+            mode: "sgr",
+            col: target?.col ?? null,
+            row: target?.row ?? null,
+            text: labelText,
+            reason: "mouse_disabled",
+        };
+    }
+    // Scroll needs a cell to anchor the SGR event; default to viewport center.
+    const fallbackTarget = target ?? { col: 0, row: 0 };
+    const written = sgrFallback(id, action, fallbackTarget.col, fallbackTarget.row);
+    return {
+        ok: written,
+        mode: "sgr",
+        col: fallbackTarget.col,
+        row: fallbackTarget.row,
+        text: labelText,
+        reason: written ? null : "not_found",
+    };
+};
+//# sourceMappingURL=session-automation.js.map

package/dist/session-automation.js.map

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

package/dist/session-manager.d.ts

@@ -20,6 +20,15 @@ export interface ExecOptions {
     timeoutMs?: number;
     outputLimitBytes?: number;
 }
+export interface WaitPredicate {
+    kind: "text" | "regex" | "idle";
+    test: (text: string) => boolean;
+}
+export interface WaitResult {
+    matched: boolean;
+    elapsedMs: number;
+    snapshot: string;
+}
 export type SessionActivityState = "running" | "alive-quiet" | "ready";
 interface ManagedClient {
     ws: ClientSocket;
@@ -103,6 +112,17 @@ export declare class SessionManager {
     capturePane(id: string, lines?: number): Promise<string | null>;
     setPinned(id: string, pinned: boolean): boolean;
     setTitleById(id: string, title: string): boolean;
+    pressKeysById(id: string, input: string): boolean;
+    waitFor(id: string, predicate: WaitPredicate, timeoutMs: number, idleMs?: number): Promise<WaitResult | null>;
+    findTextInViewport(id: string, needle: string): Promise<{
+        col: number;
+        row: number;
+    } | null>;
+    mouseEnabledFor(id: string): boolean;
+    sessionSizeFor(id: string): {
+        cols: number;
+        rows: number;
+    };
     private ensureCaptureRenderer;
     execInSession(id: string, command: string, options?: ExecOptions): Promise<ExecResult | null>;
     private buildExecResult;
@@ -130,6 +150,7 @@ export declare class SessionManager {
     private coordinatorForCwd;
     private releaseCoordinator;
     broadcastGitBranchPr(cwd: string, pr: GitBranchPr | null): void;
+    hasCoordinatorFor(cwd: string): boolean;
 }
 export interface SessionListItem {
     id: string;

package/dist/session-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAwBxD,OAAO,EACL,cAAc,EAGf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE5E,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAUD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AASD,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,aAAa,GAAG,OAAO,CAAC;AAEvE,UAAU,aAAa;IACrB,EAAE,EAAE,YAAY,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IAKjB,cAAc,EAAE,qBAAqB,EAAE,CAAC;IACxC,YAAY,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;IACrC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACxC,cAAc,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACtC,UAAU,EAAE,cAAc,CAAC;IAK3B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IAOvB,UAAU,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAOxB,MAAM,EAAE,OAAO,CAAC;IAIhB,eAAe,EAAE,eAAe,GAAG,SAAS,CAAC;IAK7C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAM3B,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,cAAc,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,gBAAgB,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAClF,YAAY,EAAE,CAAC,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACnE;AAED,UAAU,qBAAqB;IAC7B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,WAAW,EAAE,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAMxE,UAAU,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAKjC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAIjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAeD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGvB;IACJ,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;IAC/D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6C;IAC/E,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6D;IACzF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;gBAEvB,OAAO,EAAE,qBAAqB;IAS1C,IAAI,IAAI,MAAM;IAId,UAAU,IAAI,OAAO;IAcrB,IAAI,IAAI,MAAM,EAAE;IAIhB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IASnE,IAAI,IAAI,eAAe,EAAE;IAwBzB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,EAAE;IAgBrD,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAcjC,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAYvC,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,IAAI;IAMvD,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,cAAc,GAAG,IAAI;IAkClF,cAAc,CACZ,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,aAAa,EACpB,UAAU,CAAC,EAAE,iBAAiB,GAC7B,cAAc,GAAG,IAAI;IAQxB,MAAM,CAAC,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAuE3D,OAAO,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAyBhD,UAAU,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAYhD,MAAM,CACJ,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI;IAaP,MAAM,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI;IAsB9B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAiBzB,UAAU,IAAI,IAAI;IAYlB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAanE,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAUjD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAarD,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAWrE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO;IAW/C,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;YAYlC,qBAAqB;IAmB7B,aAAa,CACjB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;YAuGf,eAAe;IAyC7B,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,eAAe;IA6CvB,OAAO,CAAC,uBAAuB;IAqD/B,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,QAAQ;IAqChB,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,UAAU;IAoClB,UAAU,IAAI,IAAI;IAMlB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,kBAAkB;IAS1B,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;CAGhE;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;CACjB"}
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"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"}

package/dist/session-manager.js

@@ -1,10 +1,11 @@
 import { randomBytes } from "node:crypto";
 import path from "node:path";
 import { CaptureRenderer } from "./capture-renderer.js";
-import { CAPTURE_PANE_MAX_LINES, EXEC_DEFAULT_OUTPUT_LIMIT_BYTES, EXEC_DEFAULT_TIMEOUT_MS, EXEC_EPHEMERAL_SCROLLBACK, EXEC_MAX_OUTPUT_LIMIT_BYTES, EXEC_MAX_TIMEOUT_MS, EXEC_RAW_ACCUMULATE_CAP_BYTES, EXEC_TIMEOUT_INTERRUPT_GRACE_MS, MAX_CONCURRENT_SESSIONS, MAX_OUTPUT_BYTES, OUTPUT_BATCH_FLUSH_BYTES, OUTPUT_BATCH_WINDOW_MS, SESSION_ACTIVITY_WINDOW_MS, SESSION_GRACE_MS, SESSION_PENDING_PROMOTE_TIMEOUT_MS, WS_BACKPRESSURE_THRESHOLD_BYTES, WS_CLOSE_BACKPRESSURE, WS_OUTBOUND_DRAIN_POLL_MS, WS_OUTBOUND_PAUSE_HIGH_WATER_BYTES, WS_OUTBOUND_RESUME_LOW_WATER_BYTES, WS_READY_STATE_OPEN, } from "./constants.js";
+import { CAPTURE_PANE_MAX_LINES, EXEC_DEFAULT_OUTPUT_LIMIT_BYTES, EXEC_DEFAULT_TIMEOUT_MS, EXEC_EPHEMERAL_SCROLLBACK, EXEC_MAX_OUTPUT_LIMIT_BYTES, EXEC_MAX_TIMEOUT_MS, EXEC_RAW_ACCUMULATE_CAP_BYTES, EXEC_TIMEOUT_INTERRUPT_GRACE_MS, MAX_CONCURRENT_SESSIONS, MAX_OUTPUT_BYTES, OUTPUT_BATCH_FLUSH_BYTES, OUTPUT_BATCH_WINDOW_MS, SESSION_ACTIVITY_WINDOW_MS, SESSION_GRACE_MS, SESSION_PENDING_PROMOTE_TIMEOUT_MS, WAIT_IDLE_POLL_INTERVAL_MS, WS_BACKPRESSURE_THRESHOLD_BYTES, WS_CLOSE_BACKPRESSURE, WS_OUTBOUND_DRAIN_POLL_MS, WS_OUTBOUND_PAUSE_HIGH_WATER_BYTES, WS_OUTBOUND_RESUME_LOW_WATER_BYTES, WS_READY_STATE_OPEN, } from "./constants.js";
 import { GitDiffWatcher, GIT_DIFF_WATCHER_EVENT_NAMES, } from "./git-diff-watcher.js";
 import { GitMetadataCoordinator } from "./git-metadata-coordinator.js";
 import { Session } from "./session.js";
+import { resolveNamedKeys } from "./utils/named-keys.js";
 import { getBufferedAmount } from "./utils/ws-socket.js";
 // Owns every live PTY for the daemon's lifetime. A Session is created on spawn
 // and stays here until its shell exits, it's explicitly killed, or its
@@ -429,6 +430,119 @@ export class SessionManager {
         managed.session.setTitle(title);
         return true;
     }
+    // Resolve space-separated named keys (`F2`, `Escape`, `Ctrl-C`, literal text)
+    // to xterm bytes and write them to a session — the `localterm session press`
+    // path. Unknown tokens pass through as literal text so `press hello` types
+    // "hello". Returns false for an unknown/exited session.
+    pressKeysById(id, input) {
+        const managed = this.sessions.get(id);
+        if (!managed || managed.session.isExited)
+            return false;
+        const data = resolveNamedKeys(input);
+        if (!data)
+            return false;
+        managed.session.write(data);
+        return true;
+    }
+    // Wait primitive: block until the session's rendered pane matches a text /
+    // regex predicate or goes idle for `idleMs`, bounded by `timeoutMs`. Reuses
+    // the tmux-parity capture renderer (flushed per frame) as the source of
+    // truth — the same grid `capture-pane` and `exec` read — so the predicate
+    // tests clean, ANSI-processed text, not raw bytes. Resolves `{matched,
+    // elapsedMs, snapshot}`. Returns null for an unknown/exited session.
+    async waitFor(id, predicate, timeoutMs, idleMs) {
+        const managed = this.sessions.get(id);
+        if (!managed || managed.session.isExited)
+            return null;
+        const session = managed.session;
+        const startedAt = Date.now();
+        let resolved = false;
+        let lastChangeAt = Date.now();
+        let timeoutHandle = null;
+        let idleTimer = null;
+        return new Promise((resolve) => {
+            const finalize = async (matched) => {
+                if (resolved)
+                    return;
+                resolved = true;
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                if (idleTimer)
+                    clearInterval(idleTimer);
+                session.off("output", onOutput);
+                session.off("exit", onExit);
+                const snapshot = await this.capturePane(id).catch(() => "");
+                resolve({
+                    matched,
+                    elapsedMs: Date.now() - startedAt,
+                    snapshot: snapshot ?? "",
+                });
+            };
+            const testPredicate = async () => {
+                const renderer = await this.ensureCaptureRenderer(managed);
+                await renderer.flush();
+                return predicate.test(renderer.capture());
+            };
+            const onOutput = () => {
+                lastChangeAt = Date.now();
+                void testPredicate().then((hit) => {
+                    if (hit && !resolved)
+                        finalize(true);
+                });
+            };
+            const onExit = () => {
+                void finalize(false);
+            };
+            // Idle mode: resolve once no output has arrived for `idleMs`. The interval
+            // checks recency without forcing a renderer read each tick (the output
+            // listener already bumps lastChangeAt).
+            if (predicate.kind === "idle") {
+                idleTimer = setInterval(() => {
+                    if (!resolved && Date.now() - lastChangeAt >= (idleMs ?? 0))
+                        finalize(true);
+                }, WAIT_IDLE_POLL_INTERVAL_MS);
+                idleTimer.unref?.();
+            }
+            else {
+                // Text/regex: test once up front in case the pane already matches, then
+                // react to output events.
+                void testPredicate().then((hit) => {
+                    if (hit && !resolved)
+                        finalize(true);
+                });
+            }
+            session.on("output", onOutput);
+            session.on("exit", onExit);
+            timeoutHandle = setTimeout(() => finalize(false), timeoutMs);
+            timeoutHandle.unref?.();
+        });
+    }
+    // Resolve the (col, row) of a label on the session's visible viewport — the
+    // `mouse --on-text` coord source. Reads the capture renderer's grid (the same
+    // source `capture-pane` uses) so no browser tab is required to find the label.
+    // Returns null when the text isn't on screen.
+    async findTextInViewport(id, needle) {
+        const managed = this.sessions.get(id);
+        if (!managed || managed.session.isExited)
+            return null;
+        const renderer = await this.ensureCaptureRenderer(managed);
+        await renderer.flush();
+        return renderer.findTextInViewport(needle);
+    }
+    // Whether the session's foreground app enabled a mouse tracking mode — gates
+    // the SGR-1006 fallback for `mouse` when no CDP tab is available.
+    mouseEnabledFor(id) {
+        const managed = this.sessions.get(id);
+        return managed ? managed.session.mouseEnabled : false;
+    }
+    // The session's current PTY size (cols/rows), for the mouse-state endpoint
+    // and any coord-bounds check. Returns `{0,0}` for an unknown id.
+    sessionSizeFor(id) {
+        const managed = this.sessions.get(id);
+        return managed
+            ? { cols: managed.session.cols, rows: managed.session.rows }
+            : { cols: 0, rows: 0 };
+    }
     // Lazily create (and prime) a session's capture renderer. Fed the scrollback
     // snapshot at creation so it catches up on recent history before the renderer
     // existed, then kept alive and fed live output by onSessionOutput. Awaits the
@@ -972,5 +1086,13 @@ export class SessionManager {
     broadcastGitBranchPr(cwd, pr) {
         this.coordinatorsByCwd.get(path.resolve(cwd))?.broadcastPr(pr);
     }
+    // Whether any tab is currently subscribed to the per-cwd coordinator — i.e.
+    // there is a live audience for a PR lease refresh. Used to gate the
+    // gh-activity refresh so a `gh` invocation in a cwd nobody is viewing never
+    // triggers a pointless GitHub API call (mirrors broadcastGitBranchPr's
+    // non-creating philosophy).
+    hasCoordinatorFor(cwd) {
+        return this.coordinatorsByCwd.has(path.resolve(cwd));
+    }
 }
 //# sourceMappingURL=session-manager.js.map