@desplega.ai/qa-use 2.1.7 → 2.2.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"back.js","sourceRoot":"","sources":["../../../../../src/cli/commands/browser/back.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAMrD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC3C,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,uBAAuB,EAAE,gDAAgD,CAAC;KACjF,MAAM,CAAC,KAAK,EAAE,OAAoB,EAAE,EAAE;IACrC,IAAI,CAAC;QACH,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,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEjC,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC;YACtC,UAAU,EAAE,OAAO,CAAC,SAAS;YAC7B,MAAM;SACP,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,EAAE;YACrD,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;YACvC,MAAM,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,mBAAmB,CAAC,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,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"}

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

@@ -0,0 +1,6 @@
+/**
+ * qa-use browser check - Check a checkbox by ref or semantic text
+ */
+import { Command } from 'commander';
+export declare const checkCommand: Command;
+//# sourceMappingURL=check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/browser/check.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,eAAO,MAAM,YAAY,SAiDrB,CAAC"}

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

@@ -0,0 +1,62 @@
+/**
+ * qa-use browser check - Check a checkbox by ref or semantic text
+ */
+import { Command } from 'commander';
+import { BrowserApiClient } from '../../../../lib/api/browser.js';
+import { resolveSessionId, touchSession } from '../../lib/browser-sessions.js';
+import { loadConfig } from '../../lib/config.js';
+import { success, error } from '../../lib/output.js';
+/**
+ * Normalize ref by stripping leading @ if present
+ */
+function normalizeRef(ref) {
+    return ref.startsWith('@') ? ref.slice(1) : ref;
+}
+export const checkCommand = new Command('check')
+    .description('Check a checkbox by ref or semantic description')
+    .argument('[ref]', 'Element ref from snapshot (e.g., "e3" or "@e3")')
+    .option('-s, --session-id <id>', 'Session ID (auto-resolved if only one session)')
+    .option('-t, --text <description>', 'Semantic element description (AI-based, slower)')
+    .action(async (ref, options) => {
+    try {
+        // Validate that either ref or --text is provided
+        if (!ref && !options.text) {
+            console.log(error('Either <ref> argument or --text option is required'));
+            process.exit(1);
+        }
+        const config = await loadConfig();
+        if (!config.api_key) {
+            console.log(error('API key not configured. Run `qa-use setup` first.'));
+            process.exit(1);
+        }
+        const client = new BrowserApiClient(config.api_url);
+        client.setApiKey(config.api_key);
+        const resolved = await resolveSessionId({
+            explicitId: options.sessionId,
+            client,
+        });
+        // Build action with either ref or text
+        const action = { type: 'check' };
+        if (ref) {
+            action.ref = normalizeRef(ref);
+        }
+        else if (options.text) {
+            action.text = options.text;
+        }
+        const result = await client.executeAction(resolved.id, action);
+        if (result.success) {
+            const target = ref ? `checkbox ${normalizeRef(ref)}` : `"${options.text}"`;
+            console.log(success(`Checked ${target}`));
+            await touchSession(resolved.id);
+        }
+        else {
+            console.log(error(result.error || 'Check failed'));
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.log(error(err instanceof Error ? err.message : 'Failed to check checkbox'));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=check.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * qa-use browser click - Click element by ref or semantic text
+ */
+import { Command } from 'commander';
+export declare const clickCommand: Command;
+//# sourceMappingURL=click.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/browser/click.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,eAAO,MAAM,YAAY,SAkDrB,CAAC"}

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

@@ -0,0 +1,63 @@
+/**
+ * qa-use browser click - Click element by ref or semantic text
+ */
+import { Command } from 'commander';
+import { BrowserApiClient } from '../../../../lib/api/browser.js';
+import { resolveSessionId, touchSession } from '../../lib/browser-sessions.js';
+import { loadConfig } from '../../lib/config.js';
+import { success, error } from '../../lib/output.js';
+/**
+ * Normalize ref by stripping leading @ if present
+ */
+function normalizeRef(ref) {
+    return ref.startsWith('@') ? ref.slice(1) : ref;
+}
+export const clickCommand = new Command('click')
+    .description('Click an element by ref or semantic description')
+    .argument('[ref]', 'Element ref from snapshot (e.g., "e3" or "@e3")')
+    .option('-s, --session-id <id>', 'Session ID (auto-resolved if only one session)')
+    .option('-t, --text <description>', 'Semantic element description (AI-based, slower)')
+    .action(async (ref, options) => {
+    try {
+        // Validate that either ref or --text is provided
+        if (!ref && !options.text) {
+            console.log(error('Either <ref> argument or --text option is required'));
+            process.exit(1);
+        }
+        const config = await loadConfig();
+        if (!config.api_key) {
+            console.log(error('API key not configured. Run `qa-use setup` first.'));
+            process.exit(1);
+        }
+        const client = new BrowserApiClient(config.api_url);
+        client.setApiKey(config.api_key);
+        const resolved = await resolveSessionId({
+            explicitId: options.sessionId,
+            client,
+        });
+        // Build action with either ref or text
+        const action = { type: 'click' };
+        if (ref) {
+            action.ref = normalizeRef(ref);
+        }
+        else if (options.text) {
+            action.text = options.text;
+        }
+        const result = await client.executeAction(resolved.id, action);
+        if (result.success) {
+            const target = ref ? `element ${normalizeRef(ref)}` : `"${options.text}"`;
+            console.log(success(`Clicked ${target}`));
+            await touchSession(resolved.id);
+        }
+        else {
+            const hint = result.error || 'Click failed';
+            console.log(error(`${hint}. Use 'qa-use browser snapshot' to see available elements.`));
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.log(error(err instanceof Error ? err.message : 'Failed to click element'));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=click.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * qa-use browser close - Close a browser session
+ */
+import { Command } from 'commander';
+export declare const closeCommand: Command;
+//# sourceMappingURL=close.d.ts.map

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

@@ -0,0 +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;AAUpC,eAAO,MAAM,YAAY,SAwCrB,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * qa-use browser close - Close a browser session
+ */
+import { Command } from 'commander';
+import { BrowserApiClient } from '../../../../lib/api/browser.js';
+import { resolveSessionId, removeStoredSession } from '../../lib/browser-sessions.js';
+import { loadConfig } from '../../lib/config.js';
+import { success, error, info } from '../../lib/output.js';
+export const closeCommand = new Command('close')
+    .description('Close a browser session')
+    .option('-s, --session-id <id>', 'Session ID (auto-resolved if only one session)')
+    .action(async (options) => {
+    try {
+        // Load configuration
+        const config = await loadConfig();
+        if (!config.api_key) {
+            console.log(error('API key not configured. Run `qa-use setup` first.'));
+            process.exit(1);
+        }
+        // Create client and set API key
+        const client = new BrowserApiClient(config.api_url);
+        client.setApiKey(config.api_key);
+        // Resolve session ID
+        const resolved = await resolveSessionId({
+            explicitId: options.sessionId,
+            client,
+        });
+        console.log(info(`Closing session ${resolved.id}...`));
+        // Close session on API
+        await client.deleteSession(resolved.id);
+        // Remove from local storage
+        await removeStoredSession(resolved.id);
+        console.log(success(`Session ${resolved.id} closed successfully`));
+        // Show source if auto-resolved
+        if (resolved.source === 'stored') {
+            console.log(info('(Session was auto-resolved from local storage)'));
+        }
+    }
+    catch (err) {
+        console.log(error(err instanceof Error ? err.message : 'Failed to close session'));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=close.js.map

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

@@ -0,0 +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,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,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,IAAI,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEjC,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"}

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

@@ -0,0 +1,6 @@
+/**
+ * qa-use browser create - Create a new browser session
+ */
+import { Command } from 'commander';
+export declare const createCommand: Command;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +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;AAuBpC,eAAO,MAAM,aAAa,SA4DtB,CAAC"}

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

@@ -0,0 +1,284 @@
+/**
+ * qa-use browser create - Create a new browser session
+ */
+import { Command } from 'commander';
+import { BrowserApiClient } from '../../../../lib/api/browser.js';
+import { BrowserManager } from '../../../../lib/browser/index.js';
+import { TunnelManager } from '../../../../lib/tunnel/index.js';
+import { storeSession, createStoredSession, removeStoredSession, } from '../../lib/browser-sessions.js';
+import { loadConfig } from '../../lib/config.js';
+import { success, error, info, warning } from '../../lib/output.js';
+import { ensureBrowsersInstalled } from '../../lib/browser.js';
+export const createCommand = new Command('create')
+    .description('Create a new browser session')
+    .option('--headless', 'Run browser in headless mode (default: true for remote, false for tunnel)')
+    .option('--no-headless', 'Run browser with visible UI')
+    .option('--viewport <type>', 'Viewport type: desktop, mobile, or tablet (default: desktop)', 'desktop')
+    .option('--timeout <seconds>', 'Session timeout in seconds (default: 300)', '300')
+    .option('--ws-url <url>', 'WebSocket URL for remote/tunneled browser')
+    .option('--tunnel', 'Start local browser with tunnel (keeps process running)')
+    .option('-s, --subdomain <name>', 'Custom tunnel subdomain (only with --tunnel)')
+    .action(async (options) => {
+    // Validate mutually exclusive options
+    if (options.tunnel && options.wsUrl) {
+        console.log(error('Cannot use both --tunnel and --ws-url'));
+        process.exit(1);
+    }
+    if (options.subdomain && !options.tunnel) {
+        console.log(error('--subdomain can only be used with --tunnel'));
+        process.exit(1);
+    }
+    // Load configuration
+    const config = await loadConfig();
+    if (!config.api_key) {
+        console.log(error('API key not configured. Run `qa-use setup` first.'));
+        process.exit(1);
+    }
+    // Validate viewport type
+    const validViewports = ['desktop', 'mobile', 'tablet'];
+    const viewport = (options.viewport || 'desktop');
+    if (!validViewports.includes(viewport)) {
+        console.log(error(`Invalid viewport: ${viewport}. Must be one of: ${validViewports.join(', ')}`));
+        process.exit(1);
+    }
+    // Parse timeout
+    const timeout = parseInt(String(options.timeout), 10);
+    if (isNaN(timeout) || timeout < 60 || timeout > 3600) {
+        console.log(error('Timeout must be between 60 and 3600 seconds'));
+        process.exit(1);
+    }
+    // Create client and set API key
+    const client = new BrowserApiClient(config.api_url);
+    client.setApiKey(config.api_key);
+    if (options.tunnel) {
+        // Tunnel mode: start local browser + tunnel, then create session
+        await runTunnelMode(client, config.api_key, options, viewport, timeout);
+    }
+    else {
+        // Normal mode: create remote session and exit
+        await createRemoteSession(client, options, viewport, timeout);
+    }
+});
+/**
+ * Create a remote browser session (normal mode)
+ */
+async function createRemoteSession(client, options, viewport, timeout) {
+    try {
+        console.log(info('Creating browser session...'));
+        // Create session
+        const session = await client.createSession({
+            headless: options.headless !== false,
+            viewport,
+            timeout,
+            ws_url: options.wsUrl,
+        });
+        console.log(info(`Session created: ${session.id}`));
+        console.log(info(`Status: ${session.status}`));
+        // Wait for session to become active if starting
+        if (session.status === 'starting') {
+            console.log(info('Waiting for session to become active...'));
+            const activeSession = await client.waitForStatus(session.id, 'active', 60000);
+            console.log(success(`Session ${activeSession.id} is now active`));
+        }
+        else if (session.status === 'active') {
+            console.log(success(`Session ${session.id} is active`));
+        }
+        // Store session locally
+        const storedSession = createStoredSession(session.id);
+        await storeSession(storedSession);
+        // Print session info
+        console.log('');
+        console.log(`Session ID: ${session.id}`);
+        console.log(`Viewport: ${viewport}`);
+        console.log(`Headless: ${options.headless !== false}`);
+        console.log(`Timeout: ${timeout}s`);
+        if (options.wsUrl) {
+            console.log(`WebSocket URL: ${options.wsUrl}`);
+        }
+    }
+    catch (err) {
+        console.log(error(err instanceof Error ? err.message : 'Failed to create session'));
+        process.exit(1);
+    }
+}
+/**
+ * Tunnel mode: start local browser + tunnel + API session, then keep running
+ */
+async function runTunnelMode(client, apiKey, options, viewport, timeout) {
+    // Check that browsers are installed before expensive operations
+    ensureBrowsersInstalled();
+    // Track resources for cleanup
+    let browser = null;
+    let tunnel = null;
+    let sessionId = null;
+    let heartbeatIntervalId = null;
+    // Cleanup function
+    const cleanup = async (exitCode = 0) => {
+        console.log('');
+        console.log(info('Shutting down...'));
+        // Stop heartbeat
+        if (heartbeatIntervalId) {
+            clearInterval(heartbeatIntervalId);
+            console.log(success('Heartbeat stopped'));
+        }
+        // Close API session and remove from local storage
+        if (sessionId && client) {
+            try {
+                await client.deleteSession(sessionId);
+                await removeStoredSession(sessionId);
+                console.log(success('API session closed'));
+            }
+            catch (err) {
+                console.log(warning(`Session cleanup: ${err instanceof Error ? err.message : 'Unknown error'}`));
+            }
+        }
+        // Stop tunnel
+        if (tunnel) {
+            try {
+                await tunnel.stopTunnel();
+                console.log(success('Tunnel closed'));
+            }
+            catch (err) {
+                console.log(warning(`Tunnel cleanup: ${err instanceof Error ? err.message : 'Unknown error'}`));
+            }
+        }
+        // Stop browser
+        if (browser) {
+            try {
+                await browser.stopBrowser();
+                console.log(success('Browser closed'));
+            }
+            catch (err) {
+                console.log(warning(`Browser cleanup: ${err instanceof Error ? err.message : 'Unknown error'}`));
+            }
+        }
+        console.log('');
+        console.log(info('Tunnel mode stopped'));
+        process.exit(exitCode);
+    };
+    // Handle signals for graceful shutdown
+    process.on('SIGINT', () => cleanup(0));
+    process.on('SIGTERM', () => cleanup(0));
+    try {
+        // Default to visible browser for tunnel mode (unless --headless explicitly set)
+        const headless = options.headless === true;
+        console.log('');
+        console.log(info('Starting browser with tunnel...'));
+        console.log(`Mode: ${headless ? 'Headless' : 'Visible Browser'}`);
+        console.log('');
+        // Step 1: Start local browser
+        console.log(info('Starting browser...'));
+        browser = new BrowserManager();
+        const browserResult = await browser.startBrowser({ headless });
+        const wsEndpoint = browserResult.wsEndpoint;
+        console.log(success('Browser started'));
+        // Step 2: Start tunnel with deterministic subdomain
+        console.log(info('Creating tunnel...'));
+        tunnel = new TunnelManager();
+        const wsUrl = new URL(wsEndpoint);
+        const browserPort = parseInt(wsUrl.port);
+        await tunnel.startTunnel(browserPort, {
+            subdomain: options.subdomain,
+            apiKey: apiKey,
+            sessionIndex: 0,
+        });
+        console.log(success('Tunnel created'));
+        // Step 3: Get tunneled WebSocket URL
+        const localWsUrl = browser.getWebSocketEndpoint();
+        if (!localWsUrl) {
+            console.log(error('Failed to get browser WebSocket endpoint'));
+            await cleanup(1);
+            return;
+        }
+        const tunneledWsUrl = tunnel.getWebSocketUrl(localWsUrl);
+        if (!tunneledWsUrl) {
+            console.log(error('Failed to create tunneled WebSocket URL'));
+            await cleanup(1);
+            return;
+        }
+        console.log(info(`Tunneled WebSocket: ${tunneledWsUrl}`));
+        console.log('');
+        // Step 4: Create API session with tunneled ws_url
+        console.log(info('Creating API session...'));
+        const session = await client.createSession({
+            headless,
+            viewport,
+            timeout,
+            ws_url: tunneledWsUrl,
+        });
+        sessionId = session.id;
+        console.log(info(`Session created: ${session.id}`));
+        // Wait for session to become active if starting
+        if (session.status === 'starting') {
+            console.log(info('Waiting for session to become active...'));
+            await client.waitForStatus(session.id, 'active', 60000);
+        }
+        console.log(success('Session is active'));
+        // Store session locally
+        const storedSession = createStoredSession(session.id);
+        await storeSession(storedSession);
+        // Print session info
+        console.log('');
+        console.log('='.repeat(50));
+        console.log(success('Browser tunnel ready!'));
+        console.log('='.repeat(50));
+        console.log('');
+        console.log(`Session ID:     ${session.id}`);
+        console.log(`Viewport:       ${viewport}`);
+        console.log(`Headless:       ${headless}`);
+        console.log(`Timeout:        ${timeout}s`);
+        console.log(`WebSocket URL:  ${tunneledWsUrl}`);
+        console.log('');
+        console.log(info('Use this session with other browser commands:'));
+        console.log(`  qa-use browser goto https://example.com`);
+        console.log(`  qa-use browser screenshot`);
+        console.log(`  qa-use browser snapshot`);
+        console.log('');
+        console.log(info('Press Ctrl+C to stop'));
+        console.log('');
+        // Step 5: Set up heartbeat to check session and tunnel health
+        let heartbeatCount = 0;
+        const heartbeatInterval = 30000; // 30 seconds
+        heartbeatIntervalId = setInterval(async () => {
+            heartbeatCount++;
+            const timestamp = new Date().toLocaleTimeString();
+            try {
+                // Check if API session still exists
+                const sessionStatus = await client.getSession(sessionId);
+                if (sessionStatus.status === 'closed') {
+                    console.log(`[${timestamp}] Session closed externally, shutting down...`);
+                    await removeStoredSession(sessionId);
+                    sessionId = null;
+                    await cleanup(0);
+                    return;
+                }
+                // Check tunnel health
+                const tunnelHealthy = await tunnel.checkHealth();
+                if (tunnelHealthy) {
+                    console.log(`[${timestamp}] Heartbeat #${heartbeatCount} - healthy`);
+                }
+                else {
+                    console.log(`[${timestamp}] ${warning(`Heartbeat #${heartbeatCount} - tunnel unhealthy`)}`);
+                }
+            }
+            catch (err) {
+                const errMessage = err instanceof Error ? err.message : 'Unknown error';
+                // If session not found, it was closed externally
+                if (errMessage.includes('not found') || errMessage.includes('404')) {
+                    console.log(`[${timestamp}] Session closed externally, shutting down...`);
+                    await removeStoredSession(sessionId);
+                    sessionId = null;
+                    await cleanup(0);
+                    return;
+                }
+                console.log(`[${timestamp}] ${warning(`Heartbeat error: ${errMessage}`)}`);
+            }
+        }, heartbeatInterval);
+        // Keep the process running
+    }
+    catch (err) {
+        console.log(error(err instanceof Error ? err.message : 'Failed to start tunnel'));
+        await cleanup(1);
+    }
+}
+//# sourceMappingURL=create.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * qa-use browser fill - Fill input field by ref or semantic text
+ */
+import { Command } from 'commander';
+export declare const fillCommand: Command;
+//# sourceMappingURL=fill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/browser/fill.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,eAAO,MAAM,WAAW,SA0ErB,CAAC"}

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

@@ -0,0 +1,83 @@
+/**
+ * qa-use browser fill - Fill input field by ref or semantic text
+ */
+import { Command } from 'commander';
+import { BrowserApiClient } from '../../../../lib/api/browser.js';
+import { resolveSessionId, touchSession } from '../../lib/browser-sessions.js';
+import { loadConfig } from '../../lib/config.js';
+import { success, error } from '../../lib/output.js';
+/**
+ * Normalize ref by stripping leading @ if present
+ */
+function normalizeRef(ref) {
+    return ref.startsWith('@') ? ref.slice(1) : ref;
+}
+export const fillCommand = new Command('fill')
+    .description('Fill an input field by ref or semantic description')
+    .argument('[ref]', 'Element ref from snapshot (e.g., "e4" or "@e4")')
+    .argument('<value>', 'Value to fill into the field')
+    .option('-s, --session-id <id>', 'Session ID (auto-resolved if only one session)')
+    .option('-t, --text <description>', 'Semantic element description (AI-based, slower)')
+    .action(async (refOrValue, valueOrUndefined, options) => {
+    try {
+        // Handle argument parsing: if --text is used, first arg is value; otherwise first is ref, second is value
+        let ref;
+        let value;
+        if (options.text) {
+            // When using --text, the first argument is the value
+            value = refOrValue;
+            if (!value) {
+                console.log(error('Value argument is required'));
+                process.exit(1);
+            }
+        }
+        else {
+            // Normal mode: first arg is ref, second is value
+            ref = refOrValue;
+            value = valueOrUndefined;
+            if (!ref || !value) {
+                console.log(error('Both <ref> and <value> arguments are required (or use --text with <value>)'));
+                process.exit(1);
+            }
+        }
+        const config = await loadConfig();
+        if (!config.api_key) {
+            console.log(error('API key not configured. Run `qa-use setup` first.'));
+            process.exit(1);
+        }
+        const client = new BrowserApiClient(config.api_url);
+        client.setApiKey(config.api_key);
+        const resolved = await resolveSessionId({
+            explicitId: options.sessionId,
+            client,
+        });
+        // Build action with either ref or text
+        const action = {
+            type: 'fill',
+            value,
+        };
+        if (ref) {
+            action.ref = normalizeRef(ref);
+        }
+        else if (options.text) {
+            action.text = options.text;
+        }
+        const result = await client.executeAction(resolved.id, action);
+        if (result.success) {
+            const displayValue = value.length > 50 ? value.slice(0, 47) + '...' : value;
+            const target = ref ? normalizeRef(ref) : `"${options.text}"`;
+            console.log(success(`Filled ${target} with "${displayValue}"`));
+            await touchSession(resolved.id);
+        }
+        else {
+            const hint = result.error || 'Fill failed';
+            console.log(error(`${hint}. Use 'qa-use browser snapshot' to see available elements.`));
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.log(error(err instanceof Error ? err.message : 'Failed to fill input'));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=fill.js.map