@desplega.ai/qa-use 2.14.1 → 2.15.0

package/dist/src/cli/commands/doctor.js

@@ -0,0 +1,267 @@
+/**
+ * qa-use doctor - Scan `~/.qa-use/sessions/*.json` and `~/.qa-use/tunnels/*.json`
+ * for orphaned entries (owning PID no longer alive), and reap them.
+ *
+ * Responsibilities:
+ *   1. Session files: for each, check `process.kill(pid, 0)`. If dead:
+ *      - Remove the PID file.
+ *      - Force-release the registry handle if the session referenced a tunnel target.
+ *      - Best-effort backend session-end call.
+ *   2. Tunnel files: for each entry with `pid`, check pid liveness. If dead,
+ *      zero refcount and run registry teardown (via `forceClose`).
+ *   3. `--dry-run` mode prints the reap plan without acting.
+ *   4. Exits non-zero when any action was needed (so CI/scripts can notice).
+ *
+ * This is the manual counterpart to the bounded startup sweep in
+ * `src/cli/lib/startup-sweep.ts` — `doctor` does more thorough work and is
+ * permitted to make network calls.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { Command } from 'commander';
+import { sessionsDir, tunnelsDir } from '../../../lib/env/paths.js';
+import { isPidAlive, listSessionRecords, removeSessionRecord, } from '../../../lib/env/sessions.js';
+import { tunnelRegistry } from '../../../lib/tunnel/registry.js';
+import { createBrowserClient, loadConfig } from '../lib/config.js';
+import { error, formatError, info, success, warning } from '../lib/output.js';
+function listRawTunnelRecords() {
+    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;
+        try {
+            const raw = fs.readFileSync(path.join(dir, name), 'utf8');
+            const parsed = JSON.parse(raw);
+            if (typeof parsed.id !== 'string' || typeof parsed.target !== 'string')
+                continue;
+            out.push(parsed);
+        }
+        catch {
+            /* skip unreadable */
+        }
+    }
+    return out;
+}
+function findStaleSessions() {
+    const records = listSessionRecords();
+    const stale = [];
+    for (const record of records) {
+        if (!isPidAlive(record.pid)) {
+            stale.push({ id: record.id, pid: record.pid, target: record.target });
+        }
+    }
+    return stale;
+}
+function findStaleTunnels() {
+    const records = listRawTunnelRecords();
+    const stale = [];
+    for (const record of records) {
+        if (typeof record.pid !== 'number' || !isPidAlive(record.pid)) {
+            stale.push({
+                id: record.id ?? '?',
+                target: record.target ?? '?',
+                pid: record.pid ?? 0,
+            });
+        }
+    }
+    return stale;
+}
+async function reapSession(stale, backendClient) {
+    // Remove the PID file.
+    removeSessionRecord(stale.id);
+    // Force-release any tunnel owned by this session's target.
+    if (stale.target) {
+        try {
+            await tunnelRegistry.forceClose(stale.target);
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    // Best-effort backend session-end call.
+    if (backendClient) {
+        try {
+            await backendClient.deleteSession(stale.id);
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+}
+async function reapTunnel(stale) {
+    // Force-close removes the on-disk record (by target-hash) and (if we own
+    // it) tears down the manager. For dead foreign PIDs this removes the
+    // file we expect. However, if the on-disk `id` was drifted from the
+    // canonical hash of `target` (e.g. legacy data, test fixtures), the
+    // file-by-id fallback below catches it.
+    if (stale.target && stale.target !== '?') {
+        try {
+            await tunnelRegistry.forceClose(stale.target);
+        }
+        catch {
+            /* best-effort; fall through to manual unlink by id */
+        }
+    }
+    // Fallback: unlink by raw id. Safe because `forceClose` already removed
+    // whatever the canonical-hash file name was.
+    if (stale.id && stale.id !== '?') {
+        try {
+            fs.unlinkSync(path.join(tunnelsDir(), `${stale.id}.json`));
+        }
+        catch {
+            /* already gone */
+        }
+    }
+}
+/**
+ * Internal entry point — exported for tests. Returns `{ reaped, plan }` so
+ * tests can assert the number of actions without parsing stdout.
+ */
+export async function runDoctor(options) {
+    const staleSessions = findStaleSessions();
+    const staleTunnels = findStaleTunnels();
+    if (options.dryRun) {
+        if (options.json) {
+            console.log(JSON.stringify({
+                dryRun: true,
+                staleSessions,
+                staleTunnels,
+                actionsTaken: 0,
+            }, null, 2));
+        }
+        else {
+            if (staleSessions.length === 0 && staleTunnels.length === 0) {
+                console.log(success('Nothing to do'));
+            }
+            else {
+                console.log(info('Dry run — no files removed.'));
+                if (staleSessions.length > 0) {
+                    console.log(info(`Would reap ${staleSessions.length} stale session(s):`));
+                    for (const s of staleSessions) {
+                        console.log(`  - ${s.id} (pid=${s.pid}, target=${s.target})`);
+                    }
+                }
+                if (staleTunnels.length > 0) {
+                    console.log(info(`Would reap ${staleTunnels.length} stale tunnel(s):`));
+                    for (const t of staleTunnels) {
+                        console.log(`  - ${t.id} (pid=${t.pid}, target=${t.target})`);
+                    }
+                }
+            }
+        }
+        return { staleSessions, staleTunnels, actionsTaken: 0 };
+    }
+    // Non-dry-run: actually reap.
+    let backendClient = null;
+    if (staleSessions.length > 0) {
+        try {
+            const config = await loadConfig();
+            if (config.api_key) {
+                backendClient = createBrowserClient(config);
+            }
+        }
+        catch {
+            /* best-effort — proceed without backend calls */
+        }
+    }
+    let actionsTaken = 0;
+    for (const s of staleSessions) {
+        await reapSession(s, backendClient);
+        actionsTaken += 1;
+    }
+    for (const t of staleTunnels) {
+        await reapTunnel(t);
+        actionsTaken += 1;
+    }
+    if (options.json) {
+        console.log(JSON.stringify({
+            dryRun: false,
+            staleSessions,
+            staleTunnels,
+            actionsTaken,
+        }, null, 2));
+    }
+    else if (actionsTaken === 0) {
+        console.log(success('Nothing to do'));
+    }
+    else {
+        if (staleSessions.length > 0) {
+            console.log(success(`Reaped ${staleSessions.length} stale session(s)`));
+            for (const s of staleSessions) {
+                console.log(`  - ${s.id} (pid=${s.pid})`);
+            }
+        }
+        if (staleTunnels.length > 0) {
+            console.log(success(`Reaped ${staleTunnels.length} stale tunnel(s)`));
+            for (const t of staleTunnels) {
+                console.log(`  - ${t.id} (pid=${t.pid}, target=${t.target})`);
+            }
+        }
+    }
+    return { staleSessions, staleTunnels, actionsTaken };
+}
+/**
+ * Detect orphaned files that could not be reached. A warning — but not a
+ * failure — when seen in the wild.
+ */
+function checkTunnelsDirExists() {
+    try {
+        fs.accessSync(tunnelsDir());
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function checkSessionsDirExists() {
+    try {
+        fs.accessSync(sessionsDir());
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export const doctorCommand = new Command('doctor')
+    .description('Scan for and reap stale session / tunnel files')
+    .option('--dry-run', 'Report what would be reaped without acting')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        // Surface dir-missing state only in JSON mode; in human mode the
+        // underlying reapers already handle empty dirs cleanly.
+        if (options.json &&
+            !checkSessionsDirExists() &&
+            !checkTunnelsDirExists() &&
+            !options.dryRun) {
+            console.log(JSON.stringify({
+                dryRun: false,
+                staleSessions: [],
+                staleTunnels: [],
+                actionsTaken: 0,
+            }, null, 2));
+            return;
+        }
+        const result = await runDoctor(options);
+        // Silence "did nothing" cases with exit 0; any actual action exits
+        // with a non-zero status so scripts notice.
+        if (!options.dryRun && result.actionsTaken > 0) {
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.log(error(`Doctor failed: ${formatError(err)}`));
+        process.exit(2);
+    }
+});
+// Silence lint when `warning` isn't used — keep import for future output paths.
+void warning;
+//# sourceMappingURL=doctor.js.map

package/dist/src/cli/commands/doctor.js.map

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

package/dist/src/cli/commands/test/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/test/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmCpC,eAAO,MAAM,UAAU,SAuMnB,CAAC"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/test/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqCpC,eAAO,MAAM,UAAU,SAoNrB,CAAC"}

package/dist/src/cli/commands/test/run.js

@@ -2,33 +2,33 @@
  * qa-use test run - Run test definitions
  */
 import { Command } from 'commander';
-import { getAgentSessionId } from '../../../../lib/env/index.js';
+import { getAgentSessionId, getTunnelModeFromConfig } from '../../../../lib/env/index.js';
 import { getEffectiveWsUrl, startBrowserWithTunnel, stopBrowserWithTunnel, } from '../../lib/browser.js';
 import { createApiClient, loadConfig } from '../../lib/config.js';
 import { downloadAssets } from '../../lib/download.js';
 import { applyVariableOverrides, loadAllTests, loadTestWithDeps, resolveTestPath, } from '../../lib/loader.js';
 import { addDownloadedFile, clearDownloadedFiles, clearStepScreenshots, error, formatError, info, printDownloadedFilesSummary, printPersistenceNote, printScreenshotsSummary, success, } from '../../lib/output.js';
 import { runTest } from '../../lib/runner.js';
+import { addTunnelOption } from '../../lib/tunnel-option.js';
+import { resolveTunnelFlag, resolveTunnelMode } from '../../lib/tunnel-resolve.js';
 function collectVars(value, previous) {
     const [key, val] = value.split('=');
     return { ...previous, [key]: val };
 }
-export const runCommand = new Command('run')
+export const runCommand = addTunnelOption(new Command('run')
     .description('Run a test definition')
     .argument('[test]', 'Test name or path (e.g., auth/login)')
     .option('--id <uuid>', 'Run cloud test by ID instead of local file')
     .option('--all', 'Run all tests in test directory')
     .option('--persist', 'Save test to cloud after run')
-    .option('--tunnel', 'Start local browser with tunnel (required for localhost URLs)')
-    .option('--headful', 'Show browser window (use with --tunnel)')
-    .option('--ws-url <url>', 'Use existing tunneled browser (from `browser create --tunnel`)')
+    .option('--headful', 'Show browser window (use with --tunnel on)')
+    .option('--ws-url <url>', 'Use existing tunneled browser (from `browser create --tunnel on`)')
     .option('--screenshots', 'Capture screenshots at each step')
     .option('--download', 'Download all assets (screenshots, recordings, HAR) to /tmp/qa-use/downloads/')
     .option('--var <key=value...>', 'Variable overrides', collectVars, {})
     .option('--app-config-id <uuid>', 'App config ID to use')
     .option('--timeout <seconds>', 'Timeout in seconds', '300')
-    .option('--verbose', 'Output raw SSE event data for debugging')
-    .action(async (test, options) => {
+    .option('--verbose', 'Output raw SSE event data for debugging')).action(async (test, options) => {
     try {
         const config = await loadConfig();
         // Check API key
@@ -74,30 +74,41 @@ export const runCommand = new Command('run')
         let browserSession = null;
         let wsUrl = options.wsUrl;
         try {
+            // Resolve tri-state tunnel flag: CLI > config > default 'auto'.
+            const resolvedTunnelMode = resolveTunnelFlag(options.tunnel, getTunnelModeFromConfig());
+            // Figure out the effective base URL for the Phase-2 auto decision:
+            // explicit --var base_url wins; otherwise the first test definition's
+            // `variables.base_url` (if any). Undefined disables auto.
+            const varBaseUrl = options.var?.base_url ??
+                testDefinitions?.[0]?.variables?.base_url;
+            const tunnelDecision = resolveTunnelMode(resolvedTunnelMode, varBaseUrl, config.api_url);
+            const tunnelOn = tunnelDecision === 'on';
             // Validate flag combinations
-            if (options.wsUrl && (options.tunnel || options.headful)) {
-                console.log(error('Cannot use --ws-url with --tunnel or --headful'));
+            if (options.wsUrl && (tunnelOn || options.headful)) {
+                console.log(error('Cannot use --ws-url with --tunnel on or --headful'));
                 process.exit(1);
             }
             // Check if running in development mode (localhost API)
             const isDevelopment = process.env.NODE_ENV === 'development' ||
                 config.api_url?.includes('localhost') ||
                 config.api_url?.includes('127.0.0.1');
-            // Handle --headful without --tunnel
-            if (options.headful && !options.tunnel && !isDevelopment) {
-                console.log(error('--headful requires --tunnel flag'));
-                console.log('  Use: qa-use test run <name> --tunnel --headful');
-                console.log('  Or for headless local browser: qa-use test run <name> --tunnel');
+            // Handle --headful without --tunnel on
+            if (options.headful && !tunnelOn && !isDevelopment) {
+                console.log(error('--headful requires --tunnel on'));
+                console.log('  Use: qa-use test run <name> --tunnel on --headful');
+                console.log('  Or for headless local browser: qa-use test run <name> --tunnel on');
                 process.exit(1);
             }
-            if (options.tunnel) {
+            if (tunnelOn) {
                 const headless = !options.headful;
-                console.log(`Starting local browser with tunnel (${headless ? 'headless' : 'visible'})...`);
-                console.log('⏳ First run may take a moment while the tunnel establishes connection');
-                browserSession = await startBrowserWithTunnel(undefined, {
+                // Banner + triage-hint come from startBrowserWithTunnel itself;
+                // don't double-print an ad-hoc "Starting local browser..." line.
+                browserSession = await startBrowserWithTunnel(varBaseUrl, {
                     headless,
                     apiKey: config.api_key,
                     sessionIndex: 0,
+                    tunnelMode: 'on', // decision already made above
+                    apiUrl: config.api_url,
                 });
                 wsUrl = getEffectiveWsUrl(browserSession);
                 console.log(success('Browser ready, running test...'));

package/dist/src/cli/commands/test/run.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * qa-use tunnel close - Force-tear down a tunnel entry in the registry.
+ *
+ * Phase 3 scope: accept a target URL or hash, resolve the record, and
+ * force-release it (tears down in-process handle if we own it, otherwise
+ * removes the stale-looking registry file).
+ *
+ * Phase 4 extends this with session-PID cross-referencing: when the
+ * owning PID belongs to a detached browser session (`~/.qa-use/sessions/
+ * <id>.json`), SIGTERM that child with a 5 s timeout, SIGKILL fallback,
+ * and best-effort backend session-end. That path is scaffolded here but
+ * guarded by the sessions-dir tolerance the plan calls for: if the dir
+ * doesn't exist or is empty, we skip the session lookup and fall back
+ * to a plain force-release + file removal.
+ */
+import { Command } from 'commander';
+export declare const closeCommand: Command;
+//# sourceMappingURL=close.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"close.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/tunnel/close.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyEpC,eAAO,MAAM,YAAY,SAiFrB,CAAC"}

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

@@ -0,0 +1,154 @@
+/**
+ * qa-use tunnel close - Force-tear down a tunnel entry in the registry.
+ *
+ * Phase 3 scope: accept a target URL or hash, resolve the record, and
+ * force-release it (tears down in-process handle if we own it, otherwise
+ * removes the stale-looking registry file).
+ *
+ * Phase 4 extends this with session-PID cross-referencing: when the
+ * owning PID belongs to a detached browser session (`~/.qa-use/sessions/
+ * <id>.json`), SIGTERM that child with a 5 s timeout, SIGKILL fallback,
+ * and best-effort backend session-end. That path is scaffolded here but
+ * guarded by the sessions-dir tolerance the plan calls for: if the dir
+ * doesn't exist or is empty, we skip the session lookup and fall back
+ * to a plain force-release + file removal.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { Command } from 'commander';
+import { sessionsDir } from '../../../../lib/env/paths.js';
+import { tunnelRegistry } from '../../../../lib/tunnel/registry.js';
+import { error, formatError, info, success, warning } from '../../lib/output.js';
+const SIGTERM_GRACE_MS = 5_000;
+function resolveRecord(identifier) {
+    if (/^[a-f0-9]{10}$/i.test(identifier)) {
+        return tunnelRegistry.getByHash(identifier.toLowerCase());
+    }
+    return tunnelRegistry.get(identifier);
+}
+/**
+ * Read sessions that reference this tunnel target, if any. Tolerates a
+ * missing / empty directory (common in Phase 3 since sessions don't
+ * exist yet).
+ */
+function findSessionsForTarget(target) {
+    const dir = sessionsDir();
+    let files;
+    try {
+        files = fs.readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const name of files) {
+        if (!name.endsWith('.json'))
+            continue;
+        try {
+            const raw = fs.readFileSync(path.join(dir, name), 'utf8');
+            const parsed = JSON.parse(raw);
+            if (parsed.target === target)
+                out.push(parsed);
+        }
+        catch {
+            /* skip unreadable */
+        }
+    }
+    return out;
+}
+function isPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        if (err.code === 'EPERM')
+            return true;
+        return false;
+    }
+}
+async function sigtermWithGrace(pid, graceMs) {
+    try {
+        process.kill(pid, 'SIGTERM');
+    }
+    catch {
+        // Already gone.
+        return true;
+    }
+    const deadline = Date.now() + graceMs;
+    while (Date.now() < deadline) {
+        await new Promise((r) => setTimeout(r, 100));
+        if (!isPidAlive(pid))
+            return true;
+    }
+    return false;
+}
+export const closeCommand = new Command('close')
+    .description('Force-close a tunnel (by target URL or hash ID)')
+    .argument('<target-or-hash>', 'Target URL or tunnel hash ID')
+    .option('--json', 'Output as JSON')
+    .action(async (identifier, options) => {
+    try {
+        const record = resolveRecord(identifier);
+        if (!record) {
+            if (options.json) {
+                console.log(JSON.stringify({ closed: false, reason: 'not_found' }));
+            }
+            else {
+                console.log(warning(`No active tunnel matching ${identifier}`));
+            }
+            return;
+        }
+        // Phase-4 hook: if a detached browser session owns this tunnel,
+        // SIGTERM it so the child releases the registry handle cleanly.
+        // Phase 3 tolerates an empty sessions dir.
+        const sessions = findSessionsForTarget(record.target);
+        const reaped = [];
+        for (const session of sessions) {
+            if (!session.pid || !isPidAlive(session.pid))
+                continue;
+            const termed = await sigtermWithGrace(session.pid, SIGTERM_GRACE_MS);
+            if (!termed) {
+                try {
+                    process.kill(session.pid, 'SIGKILL');
+                    console.error(warning(`Session PID ${session.pid} did not exit on SIGTERM within ${SIGTERM_GRACE_MS}ms; sent SIGKILL`));
+                }
+                catch {
+                    /* already gone */
+                }
+            }
+            reaped.push(session.pid);
+        }
+        // Force-release regardless of PID-reap outcome. In Phase 3 this is
+        // the primary path.
+        await tunnelRegistry.forceClose(record.target);
+        // Non-session holders (e.g. `tunnel start --hold`, foreground
+        // `test run`) are intentionally NOT SIGTERM'd. But after the
+        // registry file is gone, the user has no clue the holder is still
+        // around. Emit a one-line hint if (a) the registry record pointed
+        // at a pid, (b) that pid is still alive, and (c) no session was
+        // matched above (otherwise the "Reaped ..." line covers it).
+        const lingeringHolderPid = record.pid && reaped.length === 0 && isPidAlive(record.pid) ? record.pid : undefined;
+        if (options.json) {
+            const payload = { closed: true, target: record.target, reapedPids: reaped };
+            if (lingeringHolderPid !== undefined) {
+                payload.holderPid = lingeringHolderPid;
+            }
+            console.log(JSON.stringify(payload, null, 2));
+        }
+        else {
+            console.log(success(`Tunnel closed: ${record.target}`));
+            if (reaped.length > 0) {
+                console.log(info(`Reaped ${reaped.length} session process(es): ${reaped.join(', ')}`));
+            }
+            if (lingeringHolderPid !== undefined) {
+                console.error(info(`Note: holder process PID ${lingeringHolderPid} still running — send SIGTERM (kill ${lingeringHolderPid}) to terminate.`));
+            }
+        }
+    }
+    catch (err) {
+        console.log(error(`Failed to close tunnel: ${formatError(err)}`));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=close.js.map

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

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

package/dist/src/cli/commands/tunnel/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * qa-use tunnel - Manage background tunnels
+ */
+import { Command } from 'commander';
+export declare function tunnelCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/cli/commands/tunnel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/tunnel/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,aAAa,IAAI,OAAO,CAWvC"}

package/dist/src/cli/commands/tunnel/index.js

@@ -0,0 +1,17 @@
+/**
+ * qa-use tunnel - Manage background tunnels
+ */
+import { Command } from 'commander';
+import { closeCommand } from './close.js';
+import { lsCommand } from './ls.js';
+import { startCommand } from './start.js';
+import { statusCommand } from './status.js';
+export function tunnelCommand() {
+    const cmd = new Command('tunnel').description('Inspect and manage the qa-use tunnel registry (localhost → public URL)');
+    cmd.addCommand(startCommand);
+    cmd.addCommand(lsCommand);
+    cmd.addCommand(statusCommand);
+    cmd.addCommand(closeCommand);
+    return cmd;
+}
+//# sourceMappingURL=index.js.map

package/dist/src/cli/commands/tunnel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/cli/commands/tunnel/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAC3C,wEAAwE,CACzE,CAAC;IAEF,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAC7B,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC1B,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAC9B,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAE7B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/cli/commands/tunnel/ls.d.ts

@@ -0,0 +1,10 @@
+/**
+ * qa-use tunnel ls - List active tunnels in the registry.
+ *
+ * Scans `~/.qa-use/tunnels/*.json`, reconciles against owning PID, and
+ * renders a table (or JSON) with target, public URL, refcount, TTL
+ * remaining.
+ */
+import { Command } from 'commander';
+export declare const lsCommand: Command;
+//# sourceMappingURL=ls.d.ts.map