@desplega.ai/qa-use 2.14.1 → 2.15.1

package/dist/src/cli/commands/browser/_detached.js

@@ -0,0 +1,422 @@
+/**
+ * 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';
+import { BrowserManager } from '../../../../lib/browser/index.js';
+import { getAgentSessionId } from '../../../../lib/env/index.js';
+import { removeSessionRecord, sessionFilePath, writeSessionRecord, } from '../../../../lib/env/sessions.js';
+import { classifyTunnelFailure, TunnelError } from '../../../../lib/tunnel/errors.js';
+import { canonicalTarget, tunnelRegistry, } from '../../../../lib/tunnel/registry.js';
+import { createStoredSession, removeStoredSession, storeSession, } from '../../lib/browser-sessions.js';
+import { createBrowserClient, loadConfig } from '../../lib/config.js';
+/**
+ * Silence stdout/stderr after startup. The parent spawns us with
+ * `{ stdio: 'ignore' }` so these fds are already pointed at /dev/null —
+ * we additionally muzzle `console.log`/`console.error` so any stray log
+ * statements don't accidentally write to a reused fd.
+ */
+function muzzleConsole() {
+    const noop = () => {
+        /* intentional no-op */
+    };
+    console.log = noop;
+    console.error = noop;
+    console.warn = noop;
+    console.info = noop;
+}
+async function runDetached(spawnId, options) {
+    // Resource bookkeeping for cleanup. Declared up-front so the outer
+    // try/catch (around the whole startup sequence) can reference them.
+    let browser = null;
+    let tunnelHandle = null;
+    let backendSessionId = null;
+    let heartbeatTimer = null;
+    let shuttingDown = false;
+    // Set to true when we've written a `phase: 'failed'` record that the
+    // parent still needs to read. Prevents `cleanup()` from deleting it.
+    let preserveSpawnRecord = false;
+    // Deferred client reference — populated once config is loaded. Before
+    // that point `cleanup()` treats the backend session as absent.
+    let client = null;
+    const cleanup = async (exitCode) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        if (heartbeatTimer) {
+            clearInterval(heartbeatTimer);
+            heartbeatTimer = null;
+        }
+        // Close API session.
+        if (backendSessionId && client) {
+            try {
+                await client.deleteSession(backendSessionId);
+            }
+            catch {
+                /* best-effort */
+            }
+            try {
+                await removeStoredSession(backendSessionId);
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+        // Release tunnel handle.
+        if (tunnelHandle) {
+            try {
+                await tunnelRegistry.release(tunnelHandle);
+            }
+            catch {
+                /* best-effort */
+            }
+            tunnelHandle = null;
+        }
+        // Close local browser.
+        if (browser) {
+            try {
+                await browser.stopBrowser();
+            }
+            catch {
+                /* best-effort */
+            }
+            browser = null;
+        }
+        // Remove PID file.
+        if (backendSessionId) {
+            removeSessionRecord(backendSessionId);
+        }
+        // Only remove the spawn-id record when we didn't write a failure
+        // payload the parent still needs to read.
+        if (!preserveSpawnRecord) {
+            removeSessionRecord(spawnId);
+        }
+        process.exit(exitCode);
+    };
+    // Helper: write a structured failure record and mark it for preservation
+    // so the parent poll loop can read it before cleanup wipes the file.
+    const reportFailure = (err, labelPrefix) => {
+        preserveSpawnRecord = true;
+        writePhase({
+            spawnId,
+            phase: 'failed',
+            errorObject: serializeError(err, labelPrefix),
+        });
+    };
+    process.on('SIGTERM', () => {
+        void cleanup(0);
+    });
+    process.on('SIGINT', () => {
+        void cleanup(0);
+    });
+    try {
+        // Phase 1: write initial PID file under spawnId so the parent can see
+        // that the child is alive. This happens BEFORE any expensive work.
+        writePhase({
+            spawnId,
+            phase: 'starting',
+            target: options.target ?? '',
+        });
+        // Config + option parsing — moved inside the try/catch so any error
+        // here (missing API key, malformed --var-json, etc.) is surfaced to
+        // the parent as a structured failure record.
+        const config = await loadConfig();
+        if (!config.api_key) {
+            reportFailure(new Error('API key not configured'), 'ConfigError');
+            await cleanup(1);
+            return;
+        }
+        client = createBrowserClient(config);
+        const viewport = (options.viewport ?? 'desktop');
+        const timeout = options.timeout ? parseInt(options.timeout, 10) : 300;
+        const headless = options.headless === true;
+        const tunnelOn = options.tunnelMode === 'on';
+        const vars = options.varJson
+            ? JSON.parse(options.varJson)
+            : undefined;
+        const sessionIndex = options.sessionIndex ? parseInt(options.sessionIndex, 10) : 0;
+        // Phase 2: start local browser.
+        browser = new BrowserManager();
+        const browserResult = await browser.startBrowser({ headless });
+        const wsEndpoint = browserResult.wsEndpoint;
+        let wsUrlToUse = wsEndpoint;
+        let publicUrlForRecord = null;
+        // Phase 3: acquire tunnel if needed.
+        if (tunnelOn) {
+            try {
+                tunnelHandle = await tunnelRegistry.acquire(wsEndpoint, {
+                    apiKey: config.api_key,
+                    sessionIndex,
+                    subdomain: options.subdomain,
+                });
+            }
+            catch (err) {
+                const classified = err instanceof TunnelError ? err : classifyTunnelFailure(err, { target: wsEndpoint });
+                reportFailure(classified, 'tunnel_start_failed');
+                await cleanup(1);
+                return;
+            }
+            publicUrlForRecord = tunnelHandle.publicUrl;
+            // Resolve tunneled WS URL for the backend.
+            if (tunnelHandle.isCrossProcessAttach) {
+                try {
+                    const wsPath = new URL(wsEndpoint).pathname;
+                    wsUrlToUse =
+                        tunnelHandle.publicUrl.replace('https://', 'wss://').replace('http://', 'ws://') +
+                            wsPath;
+                }
+                catch (err) {
+                    reportFailure(err, 'tunnel_ws_url_resolution_failed');
+                    await cleanup(1);
+                    return;
+                }
+            }
+            else {
+                const liveManager = tunnelRegistry.getLiveManager(wsEndpoint);
+                const tunneled = liveManager?.getWebSocketUrl(wsEndpoint);
+                if (!tunneled) {
+                    reportFailure(new Error('Failed to resolve tunneled WebSocket URL'), 'tunnel_ws_url_resolution_failed');
+                    await cleanup(1);
+                    return;
+                }
+                wsUrlToUse = tunneled;
+                // Health-check with warmup retries (mirrors legacy logic).
+                let ready = false;
+                for (let attempt = 0; attempt < 15; attempt++) {
+                    if (await liveManager.checkHealth()) {
+                        ready = true;
+                        break;
+                    }
+                    await new Promise((r) => setTimeout(r, 500));
+                }
+                if (!ready) {
+                    reportFailure(new Error('Tunnel health check failed — tunnel is not proxying connections'), 'tunnel_health_check_failed');
+                    await cleanup(1);
+                    return;
+                }
+            }
+            writePhase({
+                spawnId,
+                phase: 'tunnel_ready',
+                target: canonicalTarget(wsEndpoint),
+                publicUrl: publicUrlForRecord,
+            });
+        }
+        else {
+            writePhase({
+                spawnId,
+                phase: 'browser_ready',
+                target: canonicalTarget(wsEndpoint),
+            });
+        }
+        // Phase 4: create backend session with resolved ws_url.
+        let session;
+        try {
+            session = await client.createSession({
+                viewport,
+                timeout,
+                ws_url: tunnelOn ? wsUrlToUse : undefined,
+                after_test_id: options.afterTestId,
+                vars,
+                agent_session_id: getAgentSessionId(),
+                start_url: options.startUrl,
+            });
+        }
+        catch (err) {
+            reportFailure(err, 'api_session_create_failed');
+            await cleanup(1);
+            return;
+        }
+        backendSessionId = session.id;
+        // Write the real session record — now keyed by backend session id.
+        const record = {
+            id: session.id,
+            pid: process.pid,
+            target: canonicalTarget(options.target ?? wsEndpoint),
+            publicUrl: publicUrlForRecord,
+            startedAt: new Date().toISOString(),
+            ttlExpiresAt: Date.now() + timeout * 1000,
+            crossProcessTunnel: tunnelHandle?.isCrossProcessAttach === true,
+            subdomain: options.subdomain,
+            viewport,
+            headless,
+        };
+        writeSessionRecord(record);
+        // Remove the pending spawnId file now that we have the real session.
+        if (spawnId !== session.id) {
+            removeSessionRecord(spawnId);
+        }
+        await storeSession(createStoredSession(session.id));
+        // Wait for session active (if starting). We don't surface this to
+        // the parent — the parent has already returned.
+        if (session.status === 'starting') {
+            try {
+                const waitTimeout = options.afterTestId ? 180_000 : 60_000;
+                await client.waitForStatus(session.id, 'active', waitTimeout);
+            }
+            catch {
+                // Session creation failed post-handoff. Let the heartbeat below
+                // detect the closed state and tear down.
+            }
+        }
+        // Phase 5: heartbeat — verify backend session + tunnel health.
+        // Capture client in a non-nullable local so the closure doesn't need
+        // repeated null checks (it's guaranteed non-null at this point).
+        const heartbeatClient = client;
+        heartbeatTimer = setInterval(async () => {
+            if (shuttingDown)
+                return;
+            try {
+                const status = await heartbeatClient.getSession(session.id);
+                if (status.status === 'closed' || status.status === 'failed') {
+                    await cleanup(0);
+                    return;
+                }
+                // Tunnel health — only meaningful when we own the live manager.
+                if (tunnelHandle && !tunnelHandle.isCrossProcessAttach) {
+                    const manager = tunnelRegistry.getLiveManager(wsEndpoint);
+                    if (manager) {
+                        await manager.checkHealth();
+                    }
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (msg.includes('not found') || msg.includes('404')) {
+                    await cleanup(0);
+                }
+            }
+        }, 30_000);
+        if (typeof heartbeatTimer.unref === 'function') {
+            heartbeatTimer.unref();
+        }
+        // After startup, muzzle all console output. The parent gave us
+        // `{ stdio: 'ignore' }` anyway, but this belt-and-braces ensures
+        // that even libraries that try to log don't spam unknown fds.
+        muzzleConsole();
+        // Keep the event loop alive indefinitely — heartbeat timer isn't
+        // enough because of `.unref()`. Use a long interval with ref().
+        const aliveTimer = setInterval(() => {
+            /* keep alive */
+        }, 60_000);
+        // Hold a reference so the process doesn't exit prematurely.
+        void aliveTimer;
+    }
+    catch (err) {
+        reportFailure(err);
+        await cleanup(1);
+    }
+}
+/**
+ * Serialize an unknown error value into a structured payload the parent
+ * can surface cleanly. Guards against circular refs, truncates stacks to
+ * the first 5 lines, and prefixes `name` with an optional label for
+ * failure-site context (e.g. `tunnel_start_failed`).
+ */
+function serializeError(err, labelPrefix) {
+    let message;
+    let name;
+    let stack;
+    if (err instanceof Error) {
+        message = err.message || 'Unknown error';
+        name = err.name || 'Error';
+        if (typeof err.stack === 'string') {
+            stack = err.stack.split('\n').slice(0, 5).join('\n');
+        }
+    }
+    else {
+        name = 'NonError';
+        try {
+            message = typeof err === 'string' ? err : JSON.stringify(err);
+        }
+        catch {
+            message = String(err);
+        }
+    }
+    if (labelPrefix) {
+        name = `${labelPrefix}:${name}`;
+    }
+    return stack ? { message, name, stack } : { message, name };
+}
+/**
+ * Write a "pending" record under the spawn id so the parent can poll
+ * progress. This is a minimal variant of `DetachedSessionRecord` that
+ * carries just enough state for the parent. Once the backend session id
+ * is known, we switch to writing a full record keyed by session id.
+ */
+function writePhase(phase) {
+    const record = {
+        id: phase.spawnId,
+        pid: process.pid,
+        target: phase.target ?? '',
+        publicUrl: phase.publicUrl ?? null,
+        startedAt: new Date().toISOString(),
+        ttlExpiresAt: Date.now() + 60_000,
+        phase: phase.phase,
+        error: phase.errorObject,
+        spawnId: phase.spawnId,
+        failedAt: phase.phase === 'failed' ? Date.now() : undefined,
+    };
+    try {
+        writeSessionRecord(record);
+    }
+    catch {
+        /* best-effort */
+    }
+}
+export const detachedCommand = new Command('__browser-detach')
+    .description('(internal) Detached browser-session lifecycle holder')
+    .argument('<spawn-id>', 'Spawn token generated by the parent')
+    .option('--target <url>', 'Tunnel target URL (browser WS endpoint source)')
+    .option('--tunnel-mode <mode>', 'on | off')
+    .option('-s, --subdomain <name>', 'Deterministic tunnel subdomain')
+    .option('--viewport <type>', 'Viewport type', 'desktop')
+    .option('--timeout <seconds>', 'Session timeout', '300')
+    .option('--headless', 'Headless browser', false)
+    .option('--after-test-id <id>', 'After-test to run')
+    .option('--start-url <url>', 'Start URL')
+    .option('--var-json <json>', 'Variables as JSON string')
+    .option('--session-index <idx>', 'Tunnel session index', '0')
+    .action(async (spawnId, options) => {
+    try {
+        await runDetached(spawnId, options);
+    }
+    catch (err) {
+        // Belt-and-braces: if `runDetached` somehow throws out of its own
+        // try/catch (should not happen), still persist a failure record so
+        // the parent doesn't time out with the generic readiness message.
+        try {
+            writePhase({
+                spawnId,
+                phase: 'failed',
+                errorObject: serializeError(err, 'fatal'),
+            });
+        }
+        catch {
+            /* best-effort */
+        }
+        process.exit(1);
+    }
+});
+detachedCommand._hidden = true;
+/**
+ * Convenience export for the lookup table used by PID-file consumers.
+ * Kept in sync with `DetachedSessionRecord` shape.
+ */
+export const __detachedPhaseFileName = (spawnId) => sessionFilePath(spawnId);
+//# sourceMappingURL=_detached.js.map

package/dist/src/cli/commands/browser/_detached.js.map

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

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

@@ -1,5 +1,12 @@
 /**
  * qa-use browser close - Close a browser session
+ *
+ * Phase 4: when a PID file exists under `~/.qa-use/sessions/<id>.json`,
+ * the session is a detached child. SIGTERM the child, wait up to 5s for
+ * the PID file to disappear (child cleans up on signal), then SIGKILL
+ * as a fallback. Also calls the backend session delete for
+ * consistency and prints a one-line grace hint when a tunnel handle
+ * kept the tunnel alive post-close.
  */
 import { Command } from 'commander';
 export declare const closeCommand: Command;

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

@@ -1 +1 @@
-{"version":3,"file":"close.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/browser/close.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,eAAO,MAAM,YAAY,SAuCrB,CAAC"}
+{"version":3,"file":"close.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/browser/close.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqCpC,eAAO,MAAM,YAAY,SAyHrB,CAAC"}

package/dist/src/cli/commands/browser/close.js

@@ -1,13 +1,43 @@
 /**
  * qa-use browser close - Close a browser session
+ *
+ * Phase 4: when a PID file exists under `~/.qa-use/sessions/<id>.json`,
+ * the session is a detached child. SIGTERM the child, wait up to 5s for
+ * the PID file to disappear (child cleans up on signal), then SIGKILL
+ * as a fallback. Also calls the backend session delete for
+ * consistency and prints a one-line grace hint when a tunnel handle
+ * kept the tunnel alive post-close.
  */
+import fs from 'node:fs';
 import { Command } from 'commander';
+import { isPidAlive, readSessionRecord, removeSessionRecord, sessionFilePath, } from '../../../../lib/env/sessions.js';
+import { canonicalTarget, tunnelRegistry } from '../../../../lib/tunnel/registry.js';
 import { removeStoredSession, resolveSessionId } from '../../lib/browser-sessions.js';
 import { createBrowserClient, loadConfig } from '../../lib/config.js';
-import { error, info, success } from '../../lib/output.js';
+import { error, info, success, warning } from '../../lib/output.js';
+const SIGTERM_GRACE_MS = 5_000;
+function fileExists(path) {
+    try {
+        return fs.existsSync(path);
+    }
+    catch {
+        return false;
+    }
+}
+async function waitForFileGone(path, graceMs) {
+    const deadline = Date.now() + graceMs;
+    while (Date.now() < deadline) {
+        if (!fileExists(path))
+            return true;
+        await new Promise((r) => setTimeout(r, 100));
+    }
+    return !fileExists(path);
+}
 export const closeCommand = new Command('close')
     .description('Close a browser session')
     .option('-s, --session-id <id>', 'Session ID (auto-resolved if only one session)')
+    .option('--json', 'Output as JSON')
+    .option('--quiet', 'Suppress non-essential stderr output')
     .action(async (options) => {
     try {
         // Load configuration
@@ -18,16 +48,82 @@ export const closeCommand = new Command('close')
         }
         // Create client and set API key
         const client = createBrowserClient(config);
-        // Resolve session ID
+        // Resolve session ID (verify=false — the detached child might have
+        // already cleaned the backend session; we still want to reap the
+        // PID file regardless)
         const resolved = await resolveSessionId({
             explicitId: options.sessionId,
             client,
+            verify: false,
         });
-        console.log(info(`Closing session ${resolved.id}...`));
-        // Close session on API
-        await client.deleteSession(resolved.id);
+        if (!options.json) {
+            console.log(info(`Closing session ${resolved.id}...`));
+        }
+        // Detached-child path: check for a PID file.
+        const record = readSessionRecord(resolved.id);
+        let sigkilled = false;
+        let pidFileCleared = false;
+        if (record?.pid && isPidAlive(record.pid)) {
+            try {
+                process.kill(record.pid, 'SIGTERM');
+            }
+            catch {
+                /* already gone */
+            }
+            pidFileCleared = await waitForFileGone(sessionFilePath(resolved.id), SIGTERM_GRACE_MS);
+            if (!pidFileCleared) {
+                // Child didn't clean up — SIGKILL fallback.
+                try {
+                    process.kill(record.pid, 'SIGKILL');
+                    sigkilled = true;
+                    if (!options.quiet && !options.json) {
+                        console.log(warning(`Session PID ${record.pid} did not exit on SIGTERM within ${SIGTERM_GRACE_MS}ms; sent SIGKILL`));
+                    }
+                }
+                catch {
+                    /* already gone */
+                }
+                // Remove stale PID file ourselves.
+                removeSessionRecord(resolved.id);
+            }
+        }
+        else if (record) {
+            // PID file exists but owner is gone — just remove it.
+            removeSessionRecord(resolved.id);
+        }
+        // Close session on backend (best-effort — the child may have done it).
+        try {
+            await client.deleteSession(resolved.id);
+        }
+        catch {
+            /* best-effort — backend may already report closed */
+        }
         // Remove from local storage
         await removeStoredSession(resolved.id);
+        // Grace-period hint: when the session released a tunnel handle but
+        // the registry entry lingers (refcount 0 + grace window), let the
+        // user know how to force tear-down.
+        if (record?.target) {
+            const canon = canonicalTarget(record.target);
+            const lingering = tunnelRegistry.get(canon);
+            if (lingering?.ttlExpiresAt &&
+                lingering.refcount === 0 &&
+                !options.json &&
+                !options.quiet) {
+                const remainMs = Math.max(0, lingering.ttlExpiresAt - Date.now());
+                const remainSeconds = Math.ceil(remainMs / 1000);
+                console.error(`✓ Session ${resolved.id} closed. Tunnel ${canon} kept alive ~${remainSeconds}s (grace) — run \`qa-use tunnel close ${canon}\` to tear it down now.`);
+            }
+        }
+        if (options.json) {
+            console.log(JSON.stringify({
+                closed: true,
+                id: resolved.id,
+                sigkilled,
+                pid: record?.pid ?? null,
+            }, null, 2));
+            return;
+        }
         console.log(success(`Session ${resolved.id} closed successfully`));
         // Show source if auto-resolved
         if (resolved.source === 'stored') {

package/dist/src/cli/commands/browser/close.js.map

@@ -1 +1 @@
-{"version":3,"file":"close.js","sourceRoot":"","sources":["../../../../../src/cli/commands/browser/close.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAM3D,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,yBAAyB,CAAC;KACtC,MAAM,CAAC,uBAAuB,EAAE,gDAAgD,CAAC;KACjF,MAAM,CAAC,KAAK,EAAE,OAAqB,EAAE,EAAE;IACtC,IAAI,CAAC;QACH,qBAAqB;QACrB,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC,CAAC;YACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,gCAAgC;QAChC,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAE3C,qBAAqB;QACrB,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC;YACtC,UAAU,EAAE,OAAO,CAAC,SAAS;YAC7B,MAAM;SACP,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QAEvD,uBAAuB;QACvB,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAExC,4BAA4B;QAC5B,MAAM,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAEvC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,QAAQ,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC;QAEnE,+BAA+B;QAC/B,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACnF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}
+{"version":3,"file":"close.js","sourceRoot":"","sources":["../../../../../src/cli/commands/browser/close.ts"],"names":[],"mappings":"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"}

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

@@ -1,5 +1,12 @@
 /**
  * qa-use browser create - Create a new browser session
+ *
+ * Phase 4: when tunnel mode is 'on', the lifecycle is handed off to a
+ * detached child process (re-exec of the CLI with the hidden
+ * `__browser-detach` subcommand). The parent returns in < 2 s after
+ * printing the session id + public URL. For `QA_USE_DETACH=0` we
+ * preserve the legacy blocking flow for one release as a rollback
+ * escape hatch.
  */
 import { Command } from 'commander';
 export declare const createCommand: Command;

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

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/browser/create.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgCpC,eAAO,MAAM,aAAa,SAqEtB,CAAC"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/browser/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4CpC,eAAO,MAAM,aAAa,SAsFxB,CAAC"}