@desplega.ai/qa-use 2.1.7 → 2.2.3

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

@@ -0,0 +1,135 @@
+/**
+ * qa-use browser stream - Real-time WebSocket event streaming
+ */
+import { Command } from 'commander';
+import WebSocket from 'ws';
+import { BrowserApiClient } from '../../../../lib/api/browser.js';
+import { resolveSessionId, touchSession } from '../../lib/browser-sessions.js';
+import { loadConfig } from '../../lib/config.js';
+import { error, info } from '../../lib/output.js';
+// ANSI color codes
+const colors = {
+    reset: '\x1b[0m',
+    green: '\x1b[32m',
+    red: '\x1b[31m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    gray: '\x1b[90m',
+    cyan: '\x1b[36m',
+};
+export const streamCommand = new Command('stream')
+    .description('Stream real-time events from 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(`Connecting to session ${resolved.id}...`));
+        // Get WebSocket URL
+        const wsUrl = client.getStreamUrl(resolved.id);
+        // Create WebSocket connection
+        const ws = new WebSocket(wsUrl, {
+            headers: {
+                Authorization: `Bearer ${client.getApiKey()}`,
+            },
+        });
+        // Handle connection open
+        ws.on('open', () => {
+            console.log(info('Connected. Press Ctrl+C to disconnect.\n'));
+            touchSession(resolved.id);
+        });
+        // Handle messages
+        ws.on('message', (data) => {
+            try {
+                // Handle binary data (screenshots)
+                if (Buffer.isBuffer(data)) {
+                    console.log(`${colors.gray}📷 Binary frame received (${data.length} bytes)${colors.reset}`);
+                    return;
+                }
+                // Parse JSON message
+                const message = JSON.parse(data.toString());
+                formatEvent(message);
+            }
+            catch (err) {
+                console.log(`${colors.gray}Raw: ${data.toString()}${colors.reset}`);
+            }
+        });
+        // Handle errors
+        ws.on('error', (err) => {
+            console.log(error(`WebSocket error: ${err.message}`));
+        });
+        // Handle close
+        ws.on('close', (code, reason) => {
+            console.log('');
+            console.log(info(`Disconnected (code: ${code}, reason: ${reason.toString() || 'none'})`));
+            process.exit(0);
+        });
+        // Handle Ctrl+C
+        process.on('SIGINT', () => {
+            console.log('');
+            console.log(info('Disconnecting...'));
+            ws.close();
+        });
+    }
+    catch (err) {
+        console.log(error(err instanceof Error ? err.message : 'Failed to stream events'));
+        process.exit(1);
+    }
+});
+/**
+ * Format and print a WebSocket event
+ */
+function formatEvent(event) {
+    const timestamp = event.timestamp ? new Date(event.timestamp).toLocaleTimeString() : '';
+    const timestampStr = timestamp ? `${colors.gray}[${timestamp}]${colors.reset} ` : '';
+    switch (event.type) {
+        case 'action_started': {
+            const data = event.data;
+            console.log(`${timestampStr}${colors.blue}▶${colors.reset} Action started: ${data.action_type || 'unknown'}`);
+            break;
+        }
+        case 'action_completed': {
+            const data = event.data;
+            if (data.success) {
+                console.log(`${timestampStr}${colors.green}✓${colors.reset} Action completed`);
+            }
+            else {
+                console.log(`${timestampStr}${colors.red}✗${colors.reset} Action failed: ${data.error || 'unknown error'}`);
+            }
+            break;
+        }
+        case 'status_changed': {
+            const data = event.data;
+            console.log(`${timestampStr}${colors.cyan}⚡${colors.reset} Status: ${data.status}`);
+            break;
+        }
+        case 'error': {
+            const data = event.data;
+            console.log(`${timestampStr}${colors.red}✗${colors.reset} Error: ${data.message || 'unknown'}`);
+            break;
+        }
+        case 'closed': {
+            const data = event.data;
+            console.log(`${timestampStr}${colors.yellow}●${colors.reset} Session closed${data?.reason ? `: ${data.reason}` : ''}`);
+            break;
+        }
+        case 'pong':
+            // Silently ignore pong responses
+            break;
+        default:
+            console.log(`${timestampStr}${colors.gray}[${event.type}]${colors.reset} ${JSON.stringify(event.data || {})}`);
+    }
+}
+//# sourceMappingURL=stream.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * qa-use browser tunnel - Start a local browser with tunnel and create API session
+ *
+ * This command:
+ * 1. Starts a local Playwright browser
+ * 2. Creates a tunnel to expose the browser WebSocket
+ * 3. Creates an API session with the tunneled ws_url
+ * 4. Keeps the tunnel alive with heartbeat
+ * 5. Cleans up on exit (close session, stop tunnel, stop browser)
+ */
+import { Command } from 'commander';
+export declare const tunnelCommand: Command;
+//# sourceMappingURL=tunnel.d.ts.map

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

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

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

@@ -0,0 +1,225 @@
+/**
+ * qa-use browser tunnel - Start a local browser with tunnel and create API session
+ *
+ * This command:
+ * 1. Starts a local Playwright browser
+ * 2. Creates a tunnel to expose the browser WebSocket
+ * 3. Creates an API session with the tunneled ws_url
+ * 4. Keeps the tunnel alive with heartbeat
+ * 5. Cleans up on exit (close session, stop tunnel, stop browser)
+ */
+import { Command } from 'commander';
+import { BrowserManager } from '../../../../lib/browser/index.js';
+import { TunnelManager } from '../../../../lib/tunnel/index.js';
+import { BrowserApiClient } from '../../../../lib/api/browser.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';
+export const tunnelCommand = new Command('tunnel')
+    .description('Start a local browser with tunnel and create API session')
+    .option('--headless', 'Run browser in headless mode (default: false for tunnel)', false)
+    .option('--no-headless', 'Run browser with visible UI')
+    .option('--visible', 'Run browser with visible UI (alias for --no-headless)')
+    .option('--viewport <type>', 'Viewport type: desktop, mobile, or tablet (default: desktop)', 'desktop')
+    .option('--timeout <seconds>', 'Session timeout in seconds (default: 300)', '300')
+    .option('-s, --subdomain <name>', 'Custom tunnel subdomain (overrides deterministic)')
+    .action(async (options) => {
+    // Track resources for cleanup
+    let browser = null;
+    let tunnel = null;
+    let sessionId = null;
+    let client = 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 {
+        // 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
+        client = new BrowserApiClient(config.api_url);
+        client.setApiKey(config.api_key);
+        // 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);
+        }
+        // Handle --visible as alias for --no-headless
+        const headless = options.headless !== false && !options.visible;
+        console.log('');
+        console.log(info('Starting browser 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: config.api_key,
+            sessionIndex: 0, // Use index 0 for browser tunnel command
+        });
+        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 ${session.id} https://example.com`);
+        console.log(`  qa-use browser screenshot ${session.id}`);
+        console.log(`  qa-use browser snapshot ${session.id}`);
+        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; // Prevent cleanup from trying to delete already-closed session
+                    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; // Prevent cleanup from trying to delete already-closed session
+                    await cleanup(0);
+                    return;
+                }
+                console.log(`[${timestamp}] ${warning(`Heartbeat error: ${errMessage}`)}`);
+            }
+        }, heartbeatInterval);
+        // Keep the process running
+        // The interval and signal handlers will keep it alive
+    }
+    catch (err) {
+        console.log(error(err instanceof Error ? err.message : 'Failed to start tunnel'));
+        await cleanup(1);
+    }
+});
+//# sourceMappingURL=tunnel.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * qa-use browser type - Type text with keystroke delays
+ */
+import { Command } from 'commander';
+export declare const typeCommand: Command;
+//# sourceMappingURL=type.d.ts.map

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

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

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

@@ -0,0 +1,61 @@
+/**
+ * qa-use browser type - Type text with keystroke delays
+ */
+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 typeCommand = new Command('type')
+    .description('Type text into an element with keystroke delays')
+    .argument('<ref>', 'Element ref (e.g., "e4" or "@e4")')
+    .argument('<text>', 'Text to type')
+    .option('-s, --session-id <id>', 'Session ID (auto-resolved if only one session)')
+    .action(async (ref, text, 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,
+        });
+        // Normalize ref
+        const normalizedRef = normalizeRef(ref);
+        // Execute type action
+        const result = await client.executeAction(resolved.id, {
+            type: 'type',
+            ref: normalizedRef,
+            text,
+        });
+        if (result.success) {
+            // Truncate text for display if too long
+            const displayText = text.length > 50 ? text.slice(0, 47) + '...' : text;
+            console.log(success(`Typed "${displayText}" into ${normalizedRef}`));
+            await touchSession(resolved.id);
+        }
+        else {
+            const hint = result.error || 'Type 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 type text'));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=type.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../../../src/cli/commands/browser/type.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;;GAEG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC3C,WAAW,CAAC,iDAAiD,CAAC;KAC9D,QAAQ,CAAC,OAAO,EAAE,mCAAmC,CAAC;KACtD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;KAClC,MAAM,CAAC,uBAAuB,EAAE,gDAAgD,CAAC;KACjF,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,IAAY,EAAE,OAAoB,EAAE,EAAE;IAChE,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,gBAAgB;QAChB,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAExC,sBAAsB;QACtB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,EAAE;YACrD,IAAI,EAAE,MAAM;YACZ,GAAG,EAAE,aAAa;YAClB,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,wCAAwC;YACxC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YACxE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,WAAW,UAAU,aAAa,EAAE,CAAC,CAAC,CAAC;YACrE,MAAM,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,4DAA4D,CAAC,CAAC,CAAC;YACxF,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,qBAAqB,CAAC,CAAC,CAAC;QAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,62 @@
+/**
+ * qa-use browser uncheck - Uncheck 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 uncheckCommand = new Command('uncheck')
+    .description('Uncheck 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: 'uncheck' };
+        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(`Unchecked ${target}`));
+            await touchSession(resolved.id);
+        }
+        else {
+            console.log(error(result.error || 'Uncheck failed'));
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.log(error(err instanceof Error ? err.message : 'Failed to uncheck checkbox'));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=uncheck.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * qa-use browser url - Get current page URL
+ */
+import { Command } from 'commander';
+export declare const urlCommand: Command;
+//# sourceMappingURL=url.d.ts.map

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * qa-use browser url - Get current page URL
+ */
+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 { error } from '../../lib/output.js';
+export const urlCommand = new Command('url')
+    .description('Get the current page URL')
+    .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,
+        });
+        // Get URL
+        const url = await client.getUrl(resolved.id);
+        // Output just the URL
+        console.log(url);
+        // Update session timestamp
+        await touchSession(resolved.id);
+    }
+    catch (err) {
+        console.log(error(err instanceof Error ? err.message : 'Failed to get URL'));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=url.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../../../src/cli/commands/browser/url.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,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAM5C,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KACzC,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,uBAAuB,EAAE,gDAAgD,CAAC;KACjF,MAAM,CAAC,KAAK,EAAE,OAAmB,EAAE,EAAE;IACpC,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,UAAU;QACV,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAE7C,sBAAsB;QACtB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEjB,2BAA2B;QAC3B,MAAM,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAClC,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,mBAAmB,CAAC,CAAC,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/src/cli/commands/browser/wait-for-load.d.ts

@@ -0,0 +1,6 @@
+/**
+ * qa-use browser wait-for-load - Wait for page load state
+ */
+import { Command } from 'commander';
+export declare const waitForLoadCommand: Command;
+//# sourceMappingURL=wait-for-load.d.ts.map

package/dist/src/cli/commands/browser/wait-for-load.d.ts.map

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