@desplega.ai/qa-use 2.14.0 → 2.15.0

package/dist/lib/tunnel/registry.js

@@ -0,0 +1,561 @@
+/**
+ * TunnelRegistry — a shared, refcount-managed layer over `TunnelManager`.
+ *
+ * Goals:
+ *   - Two CLI commands targeting the same localhost base URL share one
+ *     remote tunnel (one public URL, one provider connection).
+ *   - State is visible and editable across sibling processes via
+ *     `~/.qa-use/tunnels/<hash>.json`, so a SECOND process targeting the
+ *     same localhost picks up the FIRST process's public URL rather than
+ *     spinning up its own tunnel.
+ *   - Last-releaser (in the OWNER process) keeps the tunnel alive for
+ *     `GRACE_MS` (30 s default) so rapid-fire invocations do not thrash
+ *     the provider.
+ *
+ * Cross-process coordination model:
+ *   - The process that first acquires a given target becomes the OWNER
+ *     and runs the in-process `TunnelManager`. Its PID is recorded in
+ *     the registry file.
+ *   - Later acquirers in OTHER processes read the file, see an alive
+ *     owner PID, increment refcount under a lockfile, and return an
+ *     "attach" handle (`isCrossProcessAttach: true`) with the owner's
+ *     `publicUrl`. They do NOT construct a `TunnelManager`.
+ *   - Read-modify-write of the record is guarded by a lockfile
+ *     (`<hash>.lock`, `O_EXCL | O_CREAT`) with bounded retry.
+ *
+ * TTL grace limitation:
+ *   - The grace window is bounded by the OWNER process's lifetime. Since
+ *     `TunnelManager` is a per-process localtunnel client, the remote
+ *     tunnel dies when the owner exits. For long-lived owners
+ *     (`tunnel start --hold`, a running `test run`, a detached
+ *     `browser create` from Phase 4) grace works as designed: a new
+ *     acquirer within `GRACE_MS` cancels tear-down. For short-lived
+ *     commands that release-and-exit immediately, grace collapses to
+ *     zero (the owner process is gone, so there is no tunnel to keep
+ *     alive anyway).
+ *
+ * Non-goals (this phase):
+ *   - Daemonised tunnel hosts. Phase 4 adds detach so short-lived
+ *     commands can leave a long-lived owner behind.
+ *   - Retries on provider failure. Zero retries, consistent with Phase 2.
+ */
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { URL } from 'node:url';
+import { getPortFromUrl } from '../env/localhost.js';
+import { ensureDir, tunnelsDir } from '../env/paths.js';
+import { TunnelQuotaError } from './errors.js';
+import { TunnelManager } from './index.js';
+/**
+ * How long (ms) to keep a tunnel alive after its refcount hits zero.
+ * A new `acquire()` within this window reuses the existing tunnel.
+ * Overridable via `QA_USE_TUNNEL_GRACE_MS` env var (primarily a
+ * test-friendly knob; production callers should stick with the default).
+ */
+export const GRACE_MS = 30_000;
+function resolveGraceMsFromEnv(fallback) {
+    const raw = process.env.QA_USE_TUNNEL_GRACE_MS;
+    if (!raw)
+        return fallback;
+    const parsed = Number.parseInt(raw, 10);
+    if (Number.isFinite(parsed) && parsed >= 0)
+        return parsed;
+    return fallback;
+}
+/**
+ * Max concurrent tunnels per API key. Mirrors the sessionIndex clamp at
+ * `lib/tunnel/index.ts:41` so we surface a clear error instead of silently
+ * colliding on subdomains.
+ */
+export const MAX_CONCURRENT_TUNNELS = 10;
+/**
+ * Canonical target key — used both as the map key and to derive the
+ * filename hash. We lowercase the hostname and drop any path/query so
+ * `http://Localhost:3000/foo` and `http://localhost:3000/` dedupe.
+ */
+export function canonicalTarget(target) {
+    try {
+        const u = new URL(target);
+        return `${u.protocol}//${u.hostname.toLowerCase()}${u.port ? `:${u.port}` : ''}`;
+    }
+    catch {
+        return target.toLowerCase();
+    }
+}
+/** Filename hash for a target. First 10 hex chars of sha256. */
+export function targetHash(target) {
+    return crypto.createHash('sha256').update(canonicalTarget(target)).digest('hex').slice(0, 10);
+}
+/**
+ * Atomic write: write to `<path>.tmp` then rename. `rename` is atomic on
+ * POSIX, so readers never see a half-written file.
+ */
+function atomicWriteJson(filePath, data) {
+    ensureDir(path.dirname(filePath));
+    const tmp = `${filePath}.tmp-${process.pid}-${Date.now()}`;
+    fs.writeFileSync(tmp, JSON.stringify(data, null, 2));
+    fs.renameSync(tmp, filePath);
+}
+function readRecord(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.id !== 'string' || typeof parsed.target !== 'string')
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function safeUnlink(filePath) {
+    try {
+        fs.unlinkSync(filePath);
+    }
+    catch {
+        /* ignore */
+    }
+}
+function isPidAlive(pid) {
+    if (!pid || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // ESRCH = no process with that pid. EPERM = exists but we can't
+        // signal it (still counts as alive).
+        if (err.code === 'EPERM')
+            return true;
+        return false;
+    }
+}
+/**
+ * Acquire a per-target advisory lockfile. Cross-process exclusion for
+ * read-modify-write of the `<hash>.json` file. Implemented via
+ * `O_EXCL | O_CREAT` with bounded retry; releases via `unlinkSync`.
+ *
+ * Returns an `unlock` callback. Always invoke it in a `finally` block.
+ */
+const LOCK_RETRY_INTERVAL_MS = 15;
+const LOCK_MAX_WAIT_MS = 2_000;
+const LOCK_STALE_THRESHOLD_MS = 5_000;
+async function withLock(lockPath, fn) {
+    ensureDir(path.dirname(lockPath));
+    const deadline = Date.now() + LOCK_MAX_WAIT_MS;
+    let fd = null;
+    while (true) {
+        try {
+            // O_EXCL | O_CREAT — fails with EEXIST if another holder is live.
+            fd = fs.openSync(lockPath, fs.constants.O_CREAT | fs.constants.O_EXCL | fs.constants.O_RDWR);
+            fs.writeSync(fd, String(process.pid));
+            break;
+        }
+        catch (err) {
+            if (err.code !== 'EEXIST')
+                throw err;
+            // Check for stale lock (older than threshold) and reap.
+            try {
+                const stat = fs.statSync(lockPath);
+                if (Date.now() - stat.mtimeMs > LOCK_STALE_THRESHOLD_MS) {
+                    safeUnlink(lockPath);
+                    continue;
+                }
+            }
+            catch {
+                // Lock file vanished between exist check and stat — loop again.
+                continue;
+            }
+            if (Date.now() >= deadline) {
+                throw new Error(`Timed out waiting for tunnel registry lock: ${lockPath}`);
+            }
+            await new Promise((r) => setTimeout(r, LOCK_RETRY_INTERVAL_MS));
+        }
+    }
+    try {
+        return await fn();
+    }
+    finally {
+        if (fd !== null) {
+            try {
+                fs.closeSync(fd);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        safeUnlink(lockPath);
+    }
+}
+/**
+ * Acquire / release / list API for tunnels.
+ *
+ * A singleton is exported as `tunnelRegistry` below for convenience;
+ * callers that need isolation (tests) construct their own instance.
+ */
+export class TunnelRegistry {
+    live = new Map();
+    graceMs;
+    maxConcurrent;
+    managerFactory;
+    constructor(opts = {}) {
+        this.graceMs = resolveGraceMsFromEnv(opts.graceMs ?? GRACE_MS);
+        this.maxConcurrent = opts.maxConcurrent ?? MAX_CONCURRENT_TUNNELS;
+        this.managerFactory = opts.managerFactory ?? (() => new TunnelManager());
+    }
+    /**
+     * Start a tunnel for `target` (or reuse an existing one — in-process
+     * OR in a sibling process), returning a handle. Caller must pair each
+     * acquire with exactly one `release(handle)`.
+     */
+    async acquire(target, opts = {}) {
+        const canon = canonicalTarget(target);
+        const hash = targetHash(canon);
+        const file = path.join(tunnelsDir(), `${hash}.json`);
+        const lock = path.join(tunnelsDir(), `${hash}.lock`);
+        // Fast path: we already own a live manager in this process.
+        const existing = this.live.get(canon);
+        if (existing) {
+            if (existing.graceTimer) {
+                clearTimeout(existing.graceTimer);
+                existing.graceTimer = undefined;
+            }
+            return withLock(lock, () => {
+                existing.record.refcount += 1;
+                existing.record.ttlExpiresAt = null;
+                this.writeRecord(existing.record);
+                return { ...existing.record, isCrossProcessAttach: false, _released: false };
+            });
+        }
+        // Slow path: consult the on-disk registry. Everything from here
+        // runs under the per-target lock.
+        const result = await withLock(lock, async () => {
+            const existingRecord = readRecord(file);
+            if (existingRecord) {
+                if (isPidAlive(existingRecord.pid) && existingRecord.pid !== process.pid) {
+                    // Another process owns this tunnel; attach.
+                    existingRecord.refcount += 1;
+                    existingRecord.ttlExpiresAt = null;
+                    this.writeRecord(existingRecord);
+                    return { kind: 'attach', record: existingRecord };
+                }
+                // Either same pid (rare — map miss means first acquire in
+                // this process; treat as stale) or dead pid. Reap and fall
+                // through.
+                safeUnlink(file);
+            }
+            return { kind: 'fresh' };
+        });
+        if (result.kind === 'attach') {
+            return { ...result.record, isCrossProcessAttach: true, _released: false };
+        }
+        // Fresh start — cap check + launch + write under a fresh lock
+        // acquisition (startTunnel can take seconds; don't hold the lock
+        // that whole time, but DO re-validate nothing raced us).
+        const activeList = this.list();
+        if (activeList.length >= this.maxConcurrent) {
+            throw new TunnelQuotaError(`Concurrent tunnel cap reached (${this.maxConcurrent}). Close an existing tunnel with \`qa-use tunnel close <target>\` and try again.`, { target: canon });
+        }
+        const port = getPortFromUrl(canon);
+        const manager = this.managerFactory();
+        const session = await manager.startTunnel(port, opts);
+        return withLock(lock, async () => {
+            // Race resolution — in-process: a concurrent acquire may have
+            // landed in `this.live` while we were booting.
+            const existingLocal = this.live.get(canon);
+            if (existingLocal) {
+                try {
+                    await manager.stopTunnel();
+                }
+                catch {
+                    /* best-effort */
+                }
+                if (existingLocal.graceTimer) {
+                    clearTimeout(existingLocal.graceTimer);
+                    existingLocal.graceTimer = undefined;
+                }
+                existingLocal.record.refcount += 1;
+                existingLocal.record.ttlExpiresAt = null;
+                this.writeRecord(existingLocal.record);
+                return {
+                    ...existingLocal.record,
+                    isCrossProcessAttach: false,
+                    _released: false,
+                };
+            }
+            // Race resolution — cross-process: if another process wrote a
+            // record while we were booting, prefer theirs and tear our
+            // tunnel down.
+            const raced = readRecord(file);
+            if (raced && isPidAlive(raced.pid) && raced.pid !== process.pid) {
+                try {
+                    await manager.stopTunnel();
+                }
+                catch {
+                    /* best-effort */
+                }
+                raced.refcount += 1;
+                raced.ttlExpiresAt = null;
+                this.writeRecord(raced);
+                return { ...raced, isCrossProcessAttach: true, _released: false };
+            }
+            const record = {
+                id: hash,
+                target: canon,
+                publicUrl: session.publicUrl,
+                pid: process.pid,
+                refcount: 1,
+                ttlExpiresAt: null,
+                startedAt: Date.now(),
+            };
+            this.live.set(canon, { record, manager });
+            this.writeRecord(record);
+            return { ...record, isCrossProcessAttach: false, _released: false };
+        });
+    }
+    /**
+     * Release a handle. Decrements refcount (under lock). When the
+     * refcount hits zero AND we are the owner, schedule a tear-down
+     * `graceMs` later. A subsequent `acquire()` within the grace window
+     * cancels the tear-down.
+     *
+     * Grace window is bounded by owner process lifetime — short-lived
+     * commands exit before grace expires and will tear down immediately.
+     */
+    async release(handle) {
+        if (handle._released)
+            return;
+        handle._released = true;
+        const canon = canonicalTarget(handle.target);
+        const hash = targetHash(canon);
+        const file = path.join(tunnelsDir(), `${hash}.json`);
+        const lock = path.join(tunnelsDir(), `${hash}.lock`);
+        await withLock(lock, async () => {
+            const record = readRecord(file);
+            if (!record)
+                return; // Already torn down.
+            record.refcount = Math.max(0, record.refcount - 1);
+            if (record.refcount > 0) {
+                record.ttlExpiresAt = null;
+                this.writeRecord(record);
+                // If we ARE the owner, keep the in-memory bookkeeping in sync.
+                const entry = this.live.get(canon);
+                if (entry) {
+                    entry.record.refcount = record.refcount;
+                    entry.record.ttlExpiresAt = null;
+                }
+                return;
+            }
+            // refcount === 0
+            record.ttlExpiresAt = Date.now() + this.graceMs;
+            this.writeRecord(record);
+            const entry = this.live.get(canon);
+            if (entry && record.pid === process.pid) {
+                // We are the owner and last releaser — schedule tear-down.
+                entry.record.refcount = 0;
+                entry.record.ttlExpiresAt = record.ttlExpiresAt;
+                if (entry.graceTimer) {
+                    clearTimeout(entry.graceTimer);
+                }
+                entry.graceTimer = setTimeout(() => {
+                    void this.maybeTeardown(canon).catch(() => {
+                        /* best-effort */
+                    });
+                }, this.graceMs);
+                if (typeof entry.graceTimer.unref === 'function') {
+                    entry.graceTimer.unref();
+                }
+            }
+            // If we are NOT the owner (cross-process attach), just leave the
+            // zeroed refcount + ttl on disk. The owner's next release or its
+            // own exit path will honour the grace timer.
+        });
+    }
+    /**
+     * Force teardown of a tunnel regardless of refcount. Used by
+     * `qa-use tunnel close`. Safe to call when no such tunnel exists.
+     *
+     * If the owner is this process, tears down the in-memory manager.
+     * Otherwise just removes the registry file (and leaves the orphan
+     * remote tunnel to die with its owner).
+     */
+    async forceClose(target) {
+        const canon = canonicalTarget(target);
+        const hash = targetHash(canon);
+        const lock = path.join(tunnelsDir(), `${hash}.lock`);
+        await withLock(lock, async () => {
+            await this.teardown(canon);
+        });
+    }
+    /**
+     * Look up a single entry by canonical target. Scans the on-disk
+     * registry; returns `null` if no record exists or the owning pid is
+     * dead.
+     */
+    get(target) {
+        const canon = canonicalTarget(target);
+        const hash = targetHash(canon);
+        const file = path.join(tunnelsDir(), `${hash}.json`);
+        const record = readRecord(file);
+        if (!record)
+            return null;
+        if (!isPidAlive(record.pid)) {
+            safeUnlink(file);
+            return null;
+        }
+        return record;
+    }
+    /**
+     * List all live entries. Reconciles against owning PID; stale entries
+     * are removed as a side-effect.
+     */
+    list() {
+        const dir = tunnelsDir();
+        let files;
+        try {
+            files = fs.readdirSync(dir);
+        }
+        catch {
+            return [];
+        }
+        const out = [];
+        for (const name of files) {
+            if (!name.endsWith('.json') || name.endsWith('.tmp'))
+                continue;
+            const file = path.join(dir, name);
+            const record = readRecord(file);
+            if (!record) {
+                safeUnlink(file);
+                continue;
+            }
+            if (!isPidAlive(record.pid)) {
+                safeUnlink(file);
+                continue;
+            }
+            out.push(record);
+        }
+        return out;
+    }
+    /**
+     * Returns the live `TunnelManager` instance for `target` IF this process
+     * currently owns it. Used by callers that need health-check / WS-URL
+     * helpers on the underlying manager. Returns `null` for targets owned
+     * by a different process (file visible via `list()` / `get()` but not
+     * live in-memory here).
+     */
+    getLiveManager(target) {
+        const canon = canonicalTarget(target);
+        const entry = this.live.get(canon);
+        return entry ? entry.manager : null;
+    }
+    /**
+     * Look up by filename hash (e.g. output of `tunnel ls`).
+     */
+    getByHash(hash) {
+        const file = path.join(tunnelsDir(), `${hash}.json`);
+        const record = readRecord(file);
+        if (!record)
+            return null;
+        if (!isPidAlive(record.pid)) {
+            safeUnlink(file);
+            return null;
+        }
+        return record;
+    }
+    // -------------------------------------------------------------------
+    // Internals
+    // -------------------------------------------------------------------
+    writeRecord(record) {
+        const file = path.join(tunnelsDir(), `${record.id}.json`);
+        atomicWriteJson(file, record);
+    }
+    /**
+     * Timer callback: re-check under lock whether we should tear down. A
+     * concurrent acquire may have bumped refcount back above zero.
+     */
+    async maybeTeardown(canon) {
+        const hash = targetHash(canon);
+        const file = path.join(tunnelsDir(), `${hash}.json`);
+        const lock = path.join(tunnelsDir(), `${hash}.lock`);
+        await withLock(lock, async () => {
+            const record = readRecord(file);
+            if (!record) {
+                // Someone else cleaned up already — drop our in-memory entry.
+                const stale = this.live.get(canon);
+                if (stale) {
+                    this.live.delete(canon);
+                    try {
+                        await stale.manager.stopTunnel();
+                    }
+                    catch {
+                        /* best-effort */
+                    }
+                }
+                return;
+            }
+            // If another consumer joined, refcount is back above zero.
+            if (record.refcount > 0) {
+                // Clear our grace timer bookkeeping; caller will rearm on next
+                // release.
+                const entry = this.live.get(canon);
+                if (entry) {
+                    entry.record.refcount = record.refcount;
+                    entry.record.ttlExpiresAt = null;
+                    if (entry.graceTimer) {
+                        clearTimeout(entry.graceTimer);
+                        entry.graceTimer = undefined;
+                    }
+                }
+                return;
+            }
+            // ttlExpiresAt guard: may have been bumped by another release,
+            // e.g. a cross-process release wrote a fresh grace window.
+            if (record.ttlExpiresAt && record.ttlExpiresAt > Date.now()) {
+                // Reschedule.
+                const entry = this.live.get(canon);
+                if (entry) {
+                    if (entry.graceTimer)
+                        clearTimeout(entry.graceTimer);
+                    const delay = Math.max(0, record.ttlExpiresAt - Date.now());
+                    entry.graceTimer = setTimeout(() => {
+                        void this.maybeTeardown(canon).catch(() => {
+                            /* best-effort */
+                        });
+                    }, delay);
+                    if (typeof entry.graceTimer.unref === 'function') {
+                        entry.graceTimer.unref();
+                    }
+                }
+                return;
+            }
+            await this.teardown(canon);
+        });
+    }
+    /**
+     * Unconditional tear-down. Callers must hold the per-target lock.
+     */
+    async teardown(canon) {
+        const entry = this.live.get(canon);
+        const hash = targetHash(canon);
+        const file = path.join(tunnelsDir(), `${hash}.json`);
+        if (entry) {
+            if (entry.graceTimer) {
+                clearTimeout(entry.graceTimer);
+                entry.graceTimer = undefined;
+            }
+            this.live.delete(canon);
+            try {
+                await entry.manager.stopTunnel();
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+        safeUnlink(file);
+    }
+}
+/** Module-level singleton for CLI use. */
+export const tunnelRegistry = new TunnelRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/lib/tunnel/registry.js.map

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

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@desplega.ai/qa-use",
-    "version": "2.14.0",
+    "version": "2.15.0",
     "packageManager": "bun@^1.3.4",
     "description": "QA automation tool for browser testing with MCP server support",
     "type": "module",

package/dist/src/cli/commands/browser/_detached.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Hidden `__browser-detach` subcommand — runs inside the detached child
+ * spawned by the parent `browser create` command.
+ *
+ * Responsibilities:
+ *   1. Start the local browser (Playwright).
+ *   2. If tunnel mode is 'on', acquire a tunnel via `TunnelRegistry`.
+ *   3. Register a backend session via the API.
+ *   4. Write a PID file at `~/.qa-use/sessions/<spawn-id>.json` for the
+ *      parent to poll. Updated in place as milestones complete.
+ *   5. Install SIGTERM/SIGINT handlers that tear down cleanly:
+ *      API session end → tunnel release → browser close → remove PID file.
+ *   6. Run a 30s heartbeat that verifies API session + tunnel health; on
+ *      external close, self-terminate.
+ *
+ * This subcommand is `.hidden()` on the Commander definition so it does
+ * not appear in `qa-use browser --help`. It is ONLY invoked by the
+ * parent `browser create` bootstrap via `child_process.spawn`.
+ */
+import { Command } from 'commander';
+export declare const detachedCommand: Command;
+/**
+ * Convenience export for the lookup table used by PID-file consumers.
+ * Kept in sync with `DetachedSessionRecord` shape.
+ */
+export declare const __detachedPhaseFileName: (spawnId: string) => string;
+//# sourceMappingURL=_detached.d.ts.map

package/dist/src/cli/commands/browser/_detached.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_detached.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/browser/_detached.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAibpC,eAAO,MAAM,eAAe,SA+BxB,CAAC;AASL;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAI,SAAS,MAAM,KAAG,MAAkC,CAAC"}