@phnx-labs/agents-cli 1.15.0 → 1.16.0

package/dist/commands/browser.js

@@ -1,6 +1,7 @@
 import { listProfiles, getProfile, createProfile, deleteProfile, } from '../lib/browser/profiles.js';
 import { sendIPCRequest } from '../lib/browser/ipc.js';
-import { isValidTaskId } from '../lib/browser/types.js';
+import { browserTaskPicker } from './browser-picker.js';
+import { isInteractiveTerminal } from './utils.js';
 export function registerBrowserCommand(program) {
     const browser = program
         .command('browser')
@@ -66,12 +67,22 @@ function registerProfilesCommands(browser) {
     profiles
         .command('show <name>')
         .description('Show profile details')
-        .action(async (name) => {
+        .option('--json', 'Output machine-readable JSON')
+        .action(async (name, opts) => {
         const profile = await getProfile(name);
         if (!profile) {
-            console.error(`Profile "${name}" not found`);
+            if (opts.json) {
+                console.log(JSON.stringify({ ok: false, error: `Profile "${name}" not found` }));
+            }
+            else {
+                console.error(`Profile "${name}" not found`);
+            }
             process.exit(1);
         }
+        if (opts.json) {
+            console.log(JSON.stringify(profile, null, 2));
+            return;
+        }
         console.log(`Name: ${profile.name}`);
         console.log(`Browser: ${profile.browser}`);
         if (profile.description)
@@ -95,24 +106,42 @@ function registerProfilesCommands(browser) {
 }
 function registerTaskCommands(browser) {
     browser
-        .command('start [task]')
-        .description('Start a browser task')
+        .command('start')
+        .description('Start a browser task with a profile')
         .requiredOption('-p, --profile <name>', 'Browser profile to use')
-        .action(async (task, opts) => {
-        if (task && !isValidTaskId(task)) {
-            console.error('Task ID must be lowercase alphanumeric with hyphens');
-            process.exit(1);
-        }
+        .option('-t, --task <name>', 'Task name (auto-generated if omitted)')
+        .option('-u, --url <url>', 'Open URL in first tab')
+        .action(async (opts) => {
         const response = await sendIPCRequest({
             action: 'start',
             profile: opts.profile,
+            taskName: opts.task,
+            url: opts.url,
+        });
+        if (!response.ok) {
+            console.error(response.error);
+            process.exit(1);
+        }
+        if (opts.url && response.tabId) {
+            console.log(`Started task "${response.task}" with tab ${response.tabId}`);
+        }
+        else {
+            console.log(`Started task "${response.task}"`);
+        }
+    });
+    browser
+        .command('done <task>')
+        .description('Complete a task and close its tabs')
+        .action(async (task) => {
+        const response = await sendIPCRequest({
+            action: 'done',
             task,
         });
         if (!response.ok) {
             console.error(response.error);
             process.exit(1);
         }
-        console.log(response.task);
+        console.log(`Completed task: ${task}`);
     });
     browser
         .command('stop <task>')
@@ -130,7 +159,7 @@ function registerTaskCommands(browser) {
     });
     browser
         .command('navigate <task> <url>')
-        .description('Open a URL in the task window')
+        .description('Navigate current tab to URL (creates tab if none exist)')
         .option('-p, --profile <name>', 'Browser profile (optional if task is unique)')
         .action(async (task, url, opts) => {
         const response = await sendIPCRequest({
@@ -143,41 +172,48 @@ function registerTaskCommands(browser) {
             console.error(response.error);
             process.exit(1);
         }
-        console.log(`Opened tab ${response.tabId}: ${url}`);
+        console.log(`Navigated ${response.tabId} to ${url}`);
     });
-    browser
-        .command('tabs [task]')
-        .description('List open tabs')
-        .option('-p, --profile <name>', 'Filter by profile')
-        .action(async (task, opts) => {
+    // Tab subcommand group
+    const tab = browser.command('tab').description('Manage tabs');
+    tab
+        .command('add <task> <url>')
+        .description('Open URL in new tab (becomes current)')
+        .option('-p, --profile <name>', 'Browser profile')
+        .action(async (task, url, opts) => {
         const response = await sendIPCRequest({
-            action: 'tabs',
+            action: 'tab-add',
             task,
+            url,
             profile: opts.profile,
         });
         if (!response.ok) {
             console.error(response.error);
             process.exit(1);
         }
-        if (!response.tabs || response.tabs.length === 0) {
-            console.log('No tabs open');
-            return;
-        }
-        console.log('TASK'.padEnd(15) + 'TAB'.padEnd(12) + 'URL');
-        console.log('-'.repeat(80));
-        for (const tab of response.tabs) {
-            const shortId = tab.id.slice(0, 8);
-            console.log(tab.task.padEnd(15) +
-                shortId.padEnd(12) +
-                tab.url.slice(0, 55));
+        console.log(`Opened tab ${response.tabId}: ${url}`);
+    });
+    tab
+        .command('focus <task> <tabId>')
+        .description('Switch to tab (by ID, prefix, or URL substring)')
+        .action(async (task, tabId) => {
+        const response = await sendIPCRequest({
+            action: 'tab-focus',
+            task,
+            tabId,
+        });
+        if (!response.ok) {
+            console.error(response.error);
+            process.exit(1);
         }
+        console.log(`Focused tab ${response.tabId}`);
     });
-    browser
+    tab
         .command('close <task> [tabId]')
-        .description('Close tabs for a task')
+        .description('Close tab(s) — omit tabId to close all')
         .action(async (task, tabId) => {
         const response = await sendIPCRequest({
-            action: 'close',
+            action: 'tab-close',
             task,
             tabId,
         });
@@ -185,7 +221,40 @@ function registerTaskCommands(browser) {
             console.error(response.error);
             process.exit(1);
         }
-        console.log(tabId ? `Closed tab ${tabId}` : `Closed all tabs for task ${task}`);
+        console.log(tabId ? `Closed tab ${tabId}` : `Closed all tabs for ${task}`);
+    });
+    tab
+        .command('list <task>')
+        .description('List tabs for a task')
+        .option('--json', 'Output machine-readable JSON')
+        .action(async (task, opts) => {
+        const response = await sendIPCRequest({
+            action: 'tab-list',
+            task,
+        });
+        if (!response.ok) {
+            if (opts.json) {
+                console.log(JSON.stringify({ ok: false, error: response.error }));
+            }
+            else {
+                console.error(response.error);
+            }
+            process.exit(1);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(response.tabs ?? [], null, 2));
+            return;
+        }
+        if (!response.tabs || response.tabs.length === 0) {
+            console.log('No tabs open');
+            return;
+        }
+        console.log('TAB'.padEnd(12) + 'URL');
+        console.log('-'.repeat(70));
+        for (const t of response.tabs) {
+            const current = t.current ? ' *' : '';
+            console.log(t.id.padEnd(12) + t.url.slice(0, 55) + current);
+        }
     });
     browser
         .command('screenshot <task> [tabId]')
@@ -205,13 +274,14 @@ function registerTaskCommands(browser) {
         console.log(response.path);
     });
     browser
-        .command('evaluate <task> <tabId> <expression>')
-        .description('Evaluate JavaScript in a tab')
-        .action(async (task, tabId, expression) => {
+        .command('evaluate <task> <expression>')
+        .description('Evaluate JavaScript in current tab')
+        .option('-t, --tab <tabId>', 'Tab ID (defaults to current)')
+        .action(async (task, expression, opts) => {
         const response = await sendIPCRequest({
             action: 'evaluate',
             task,
-            tabId,
+            tabId: opts.tab,
             expr: expression,
         });
         if (!response.ok) {
@@ -224,32 +294,98 @@ function registerTaskCommands(browser) {
         .command('status')
         .description('Show running browser tasks')
         .option('-p, --profile <name>', 'Filter by profile')
+        .option('--json', 'Output machine-readable JSON')
         .action(async (opts) => {
         const response = await sendIPCRequest({
             action: 'status',
             profile: opts.profile,
         });
         if (!response.ok) {
-            console.error(response.error);
+            if (opts.json) {
+                console.log(JSON.stringify({ ok: false, error: response.error }));
+            }
+            else {
+                console.error(response.error);
+            }
             process.exit(1);
         }
-        if (!response.profiles || response.profiles.length === 0) {
-            console.log('No browser profiles running');
+        if (opts.json) {
+            console.log(JSON.stringify(response.profiles ?? [], null, 2));
             return;
         }
-        for (const profile of response.profiles) {
-            console.log(`\n${profile.name} (port ${profile.port}, pid ${profile.pid})`);
-            if (profile.tasks.length === 0) {
-                console.log('  No active tasks');
+        // Build flat list of tasks with profile context
+        const allTasks = [];
+        for (const profile of response.profiles || []) {
+            for (const task of profile.tasks) {
+                allTasks.push({ task, profile });
+            }
+        }
+        if (allTasks.length === 0) {
+            // Show recent history instead
+            const historyResponse = await sendIPCRequest({ action: 'history', limit: 5 });
+            if (historyResponse.ok && historyResponse.history && historyResponse.history.length > 0) {
+                console.log('No active tasks. Recent history:\n');
+                console.log('PROFILE'.padEnd(15) + 'TASK'.padEnd(18) + 'DOMAINS'.padEnd(22) + 'DURATION'.padEnd(10) + 'ENDED');
+                console.log('-'.repeat(75));
+                for (const h of historyResponse.history) {
+                    const domains = h.domains?.slice(0, 2).join(', ') || '-';
+                    const duration = formatDuration(h.endedAt - h.createdAt);
+                    const ended = formatAge(h.endedAt);
+                    console.log(h.profile.padEnd(15) +
+                        h.name.padEnd(18) +
+                        domains.slice(0, 20).padEnd(22) +
+                        duration.padEnd(10) +
+                        ended);
+                }
+                console.log('\nRun `browser history` for more.');
             }
             else {
-                console.log('  TASK'.padEnd(17) + 'TABS'.padEnd(8) + 'CREATED');
-                for (const task of profile.tasks) {
-                    const age = formatAge(task.createdAt);
-                    console.log('  ' +
-                        task.id.padEnd(15) +
-                        String(task.tabCount).padEnd(8) +
-                        age);
+                console.log('No browser tasks running');
+            }
+            return;
+        }
+        // Interactive picker for TTY, plain output otherwise
+        if (isInteractiveTerminal()) {
+            const picked = await browserTaskPicker({
+                message: 'Browser tasks:',
+                tasks: allTasks,
+            });
+            if (picked) {
+                // Show tab list for the selected task
+                const tabResponse = await sendIPCRequest({
+                    action: 'tab-list',
+                    task: picked.task.task.name,
+                });
+                if (tabResponse.ok && tabResponse.tabs) {
+                    console.log(`\nTabs for ${picked.task.task.name}:`);
+                    for (const tab of tabResponse.tabs) {
+                        console.log(`  ${tab.id}  ${tab.url}`);
+                    }
+                }
+            }
+        }
+        else {
+            // Non-interactive: simple table output
+            for (const profile of response.profiles || []) {
+                const portLabel = profile.configuredPort && profile.configuredPort !== profile.port
+                    ? `port ${profile.port} (configured ${profile.configuredPort})`
+                    : `port ${profile.port}`;
+                console.log(`\n${profile.name} (${portLabel}, pid ${profile.pid})`);
+                if (profile.tasks.length === 0) {
+                    console.log('  No active tasks');
+                }
+                else {
+                    console.log('  TASK'.padEnd(20) + 'TABS'.padEnd(6) + 'DOMAINS'.padEnd(25) + 'CREATED');
+                    for (const task of profile.tasks) {
+                        const age = formatAge(task.createdAt);
+                        const name = task.name || task.id;
+                        const domains = task.domains?.slice(0, 2).join(', ') || '-';
+                        console.log('  ' +
+                            name.padEnd(18) +
+                            String(task.tabCount).padEnd(6) +
+                            domains.slice(0, 23).padEnd(25) +
+                            age);
+                    }
                 }
             }
         }
@@ -258,13 +394,19 @@ function registerTaskCommands(browser) {
         .command('tasks')
         .description('List all browser tasks')
         .option('-p, --profile <name>', 'Filter by profile')
+        .option('--json', 'Output machine-readable JSON')
         .action(async (opts) => {
         const response = await sendIPCRequest({
             action: 'status',
             profile: opts.profile,
         });
         if (!response.ok) {
-            console.error(response.error);
+            if (opts.json) {
+                console.log(JSON.stringify({ ok: false, error: response.error }));
+            }
+            else {
+                console.error(response.error);
+            }
             process.exit(1);
         }
         const allTasks = [];
@@ -272,35 +414,102 @@ function registerTaskCommands(browser) {
             for (const task of profile.tasks) {
                 allTasks.push({
                     profile: profile.name,
-                    id: task.id,
+                    name: task.name || task.id,
                     tabs: task.tabCount,
+                    domains: task.domains || [],
                     created: task.createdAt,
                 });
             }
         }
+        if (opts.json) {
+            console.log(JSON.stringify(allTasks, null, 2));
+            return;
+        }
         if (allTasks.length === 0) {
-            console.log('No active tasks');
+            // Show recent history instead
+            const historyResponse = await sendIPCRequest({ action: 'history', limit: 5 });
+            if (historyResponse.ok && historyResponse.history && historyResponse.history.length > 0) {
+                console.log('No active tasks. Recent history:\n');
+                console.log('PROFILE'.padEnd(15) + 'TASK'.padEnd(18) + 'DOMAINS'.padEnd(22) + 'DURATION'.padEnd(10) + 'ENDED');
+                console.log('-'.repeat(75));
+                for (const h of historyResponse.history) {
+                    const domains = h.domains?.slice(0, 2).join(', ') || '-';
+                    const duration = formatDuration(h.endedAt - h.createdAt);
+                    const ended = formatAge(h.endedAt);
+                    console.log(h.profile.padEnd(15) +
+                        h.name.padEnd(18) +
+                        domains.slice(0, 20).padEnd(22) +
+                        duration.padEnd(10) +
+                        ended);
+                }
+            }
+            else {
+                console.log('No active tasks');
+            }
             return;
         }
-        console.log('PROFILE'.padEnd(18) + 'TASK'.padEnd(15) + 'TABS'.padEnd(8) + 'CREATED');
-        console.log('-'.repeat(55));
+        console.log('PROFILE'.padEnd(15) + 'TASK'.padEnd(18) + 'TABS'.padEnd(6) + 'DOMAINS'.padEnd(22) + 'CREATED');
+        console.log('-'.repeat(70));
         for (const t of allTasks) {
-            console.log(t.profile.padEnd(18) +
-                t.id.padEnd(15) +
-                String(t.tabs).padEnd(8) +
+            const domains = t.domains.slice(0, 2).join(', ') || '-';
+            console.log(t.profile.padEnd(15) +
+                t.name.padEnd(18) +
+                String(t.tabs).padEnd(6) +
+                domains.slice(0, 20).padEnd(22) +
                 formatAge(t.created));
         }
     });
     browser
-        .command('refs <task> [tabId]')
+        .command('history')
+        .description('Show recent browser task history')
+        .option('-l, --limit <n>', 'Number of entries (default 10)', '10')
+        .option('--json', 'Output machine-readable JSON')
+        .action(async (opts) => {
+        const response = await sendIPCRequest({
+            action: 'history',
+            limit: parseInt(opts.limit, 10),
+        });
+        if (!response.ok) {
+            if (opts.json) {
+                console.log(JSON.stringify({ ok: false, error: response.error }));
+            }
+            else {
+                console.error(response.error);
+            }
+            process.exit(1);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(response.history ?? [], null, 2));
+            return;
+        }
+        if (!response.history || response.history.length === 0) {
+            console.log('No browser task history');
+            return;
+        }
+        console.log('PROFILE'.padEnd(15) + 'TASK'.padEnd(18) + 'DOMAINS'.padEnd(22) + 'DURATION'.padEnd(10) + 'ENDED');
+        console.log('-'.repeat(75));
+        for (const h of response.history) {
+            const domains = h.domains?.slice(0, 2).join(', ') || '-';
+            const duration = formatDuration(h.endedAt - h.createdAt);
+            const ended = formatAge(h.endedAt);
+            console.log(h.profile.padEnd(15) +
+                h.name.padEnd(18) +
+                domains.slice(0, 20).padEnd(22) +
+                duration.padEnd(10) +
+                ended);
+        }
+    });
+    browser
+        .command('refs <task>')
         .description('Get DOM refs for interactive elements')
+        .option('-t, --tab <tabId>', 'Tab ID (defaults to current)')
         .option('--all', 'Include non-interactive elements')
         .option('-l, --limit <n>', 'Max elements (default 500)', '500')
-        .action(async (task, tabId, opts) => {
+        .action(async (task, opts) => {
         const response = await sendIPCRequest({
             action: 'refs',
             task,
-            tabId,
+            tabId: opts.tab,
             interactive: !opts.all,
             limit: parseInt(opts.limit, 10),
         });
@@ -311,13 +520,14 @@ function registerTaskCommands(browser) {
         console.log(response.refs);
     });
     browser
-        .command('click <task> <tabId> <ref>')
+        .command('click <task> <ref>')
         .description('Click an element by ref')
-        .action(async (task, tabId, ref) => {
+        .option('-t, --tab <tabId>', 'Tab ID (defaults to current)')
+        .action(async (task, ref, opts) => {
         const response = await sendIPCRequest({
             action: 'click',
             task,
-            tabId,
+            tabId: opts.tab,
             ref: parseInt(ref, 10),
         });
         if (!response.ok) {
@@ -327,13 +537,14 @@ function registerTaskCommands(browser) {
         console.log('Clicked');
     });
     browser
-        .command('type <task> <tabId> <ref> <text>')
+        .command('type <task> <ref> <text>')
         .description('Type text into an element by ref')
-        .action(async (task, tabId, ref, text) => {
+        .option('-t, --tab <tabId>', 'Tab ID (defaults to current)')
+        .action(async (task, ref, text, opts) => {
         const response = await sendIPCRequest({
             action: 'type',
             task,
-            tabId,
+            tabId: opts.tab,
             ref: parseInt(ref, 10),
             text,
         });
@@ -344,13 +555,14 @@ function registerTaskCommands(browser) {
         console.log('Typed');
     });
     browser
-        .command('press <task> <tabId> <key>')
+        .command('press <task> <key>')
         .description('Press a key (Enter, Tab, Escape, etc)')
-        .action(async (task, tabId, key) => {
+        .option('-t, --tab <tabId>', 'Tab ID (defaults to current)')
+        .action(async (task, key, opts) => {
         const response = await sendIPCRequest({
             action: 'press',
             task,
-            tabId,
+            tabId: opts.tab,
             key,
         });
         if (!response.ok) {
@@ -360,13 +572,14 @@ function registerTaskCommands(browser) {
         console.log('Pressed');
     });
     browser
-        .command('hover <task> <tabId> <ref>')
+        .command('hover <task> <ref>')
         .description('Hover over an element by ref')
-        .action(async (task, tabId, ref) => {
+        .option('-t, --tab <tabId>', 'Tab ID (defaults to current)')
+        .action(async (task, ref, opts) => {
         const response = await sendIPCRequest({
             action: 'hover',
             task,
-            tabId,
+            tabId: opts.tab,
             ref: parseInt(ref, 10),
         });
         if (!response.ok) {
@@ -375,6 +588,253 @@ function registerTaskCommands(browser) {
         }
         console.log('Hovered');
     });
+    // ─── Viewport & Device ───────────────────────────────────────────────────────
+    const setCmd = browser.command('set').description('Set browser emulation options');
+    setCmd
+        .command('viewport <task> <width> <height>')
+        .description('Set viewport size')
+        .option('-t, --tab <tabId>', 'Tab ID (defaults to current)')
+        .option('-m, --mobile', 'Enable mobile emulation')
+        .option('-s, --scale <factor>', 'Device scale factor', parseFloat)
+        .action(async (task, width, height, opts) => {
+        const response = await sendIPCRequest({
+            action: 'set-viewport',
+            task,
+            tabId: opts.tab,
+            width: parseInt(width, 10),
+            height: parseInt(height, 10),
+            mobile: opts.mobile,
+            deviceScaleFactor: opts.scale,
+        });
+        if (!response.ok) {
+            console.error(response.error);
+            process.exit(1);
+        }
+        console.log(`Viewport set to ${width}x${height}${opts.mobile ? ' (mobile)' : ''}`);
+    });
+    setCmd
+        .command('device <task> <device-name>')
+        .description('Emulate a device (iPhone 14, iPad, MacBook Pro)')
+        .option('-t, --tab <tabId>', 'Tab ID (defaults to current)')
+        .action(async (task, deviceName, opts) => {
+        const response = await sendIPCRequest({
+            action: 'set-device',
+            task,
+            tabId: opts.tab,
+            deviceName,
+        });
+        if (!response.ok) {
+            console.error(response.error);
+            process.exit(1);
+        }
+        console.log(`Device set to ${deviceName}`);
+    });
+    browser
+        .command('devices')
+        .description('List available device presets')
+        .action(async () => {
+        const { DEVICES } = await import('../lib/browser/devices.js');
+        console.log('Available devices:');
+        for (const [name, desc] of Object.entries(DEVICES)) {
+            console.log(`  ${name.padEnd(16)} ${desc.width}x${desc.height} @${desc.deviceScaleFactor}x${desc.mobile ? ' (mobile)' : ''}`);
+        }
+    });
+    // ─── Console & Errors ────────────────────────────────────────────────────────
+    browser
+        .command('console <task>')
+        .description('Read console logs from a tab')
+        .option('-t, --tab <tabId>', 'Tab ID (defaults to current)')
+        .option('-l, --level <level>', 'Filter by level (log, info, warn, error)')
+        .option('--clear', 'Clear logs after reading')
+        .action(async (task, opts) => {
+        const response = await sendIPCRequest({
+            action: 'console',
+            task,
+            tabId: opts.tab,
+            level: opts.level,
+            clear: opts.clear,
+        });
+        if (!response.ok) {
+            console.error(response.error);
+            process.exit(1);
+        }
+        if (!response.logs || response.logs.length === 0) {
+            console.log('No console logs');
+            return;
+        }
+        for (const log of response.logs) {
+            const prefix = `[${log.level.toUpperCase()}]`.padEnd(8);
+            const loc = log.url ? ` (${log.url}${log.line ? `:${log.line}` : ''})` : '';
+            console.log(`${prefix} ${log.text}${loc}`);
+        }
+    });
+    browser
+        .command('errors <task>')
+        .description('Read page errors from a tab')
+        .option('-t, --tab <tabId>', 'Tab ID (defaults to current)')
+        .option('--clear', 'Clear errors after reading')
+        .action(async (task, opts) => {
+        const response = await sendIPCRequest({
+            action: 'errors',
+            task,
+            tabId: opts.tab,
+            clear: opts.clear,
+        });
+        if (!response.ok) {
+            console.error(response.error);
+            process.exit(1);
+        }
+        if (!response.errors || response.errors.length === 0) {
+            console.log('No errors');
+            return;
+        }
+        for (const err of response.errors) {
+            console.log(`[ERROR] ${err.message}`);
+            if (err.stack)
+                console.log(err.stack);
+            if (err.url)
+                console.log(`  at ${err.url}${err.line ? `:${err.line}` : ''}`);
+            console.log();
+        }
+    });
+    // ─── Network ─────────────────────────────────────────────────────────────────
+    browser
+        .command('requests <task>')
+        .description('Read captured network requests')
+        .option('-t, --tab <tabId>', 'Tab ID (defaults to current)')
+        .option('-f, --filter <text>', 'Filter URLs containing text')
+        .option('--clear', 'Clear requests after reading')
+        .action(async (task, opts) => {
+        const response = await sendIPCRequest({
+            action: 'requests',
+            task,
+            tabId: opts.tab,
+            filter: opts.filter,
+            clear: opts.clear,
+        });
+        if (!response.ok) {
+            console.error(response.error);
+            process.exit(1);
+        }
+        if (!response.requests || response.requests.length === 0) {
+            console.log('No requests captured');
+            return;
+        }
+        console.log('METHOD'.padEnd(8) + 'STATUS'.padEnd(8) + 'URL');
+        console.log('-'.repeat(72));
+        for (const req of response.requests) {
+            const status = req.status ? String(req.status) : '...';
+            console.log(`${req.method.padEnd(8)}${status.padEnd(8)}${req.url.slice(0, 100)}`);
+        }
+    });
+    browser
+        .command('responsebody <task> <url-pattern>')
+        .description('Wait for and read a response body by URL pattern')
+        .option('-t, --tab <tabId>', 'Tab ID (defaults to current)')
+        .option('--timeout <ms>', 'Timeout in milliseconds', parseInt)
+        .option('--max-chars <n>', 'Max characters to return', parseInt)
+        .action(async (task, urlPattern, opts) => {
+        const response = await sendIPCRequest({
+            action: 'response-body',
+            task,
+            tabId: opts.tab,
+            urlPattern,
+            timeout: opts.timeout,
+            maxChars: opts.maxChars,
+        });
+        if (!response.ok) {
+            console.error(response.error);
+            process.exit(1);
+        }
+        console.log(response.body);
+    });
+    // ─── Wait ────────────────────────────────────────────────────────────────────
+    browser
+        .command('wait <task>')
+        .description('Wait for a condition')
+        .option('-t, --tab <tabId>', 'Tab ID (defaults to current)')
+        .option('--time <ms>', 'Wait for milliseconds')
+        .option('--selector <css>', 'Wait for CSS selector to appear')
+        .option('--url <pattern>', 'Wait for URL to match pattern')
+        .option('--fn <js>', 'Wait for JS expression to return truthy')
+        .option('--state <state>', 'Wait for load state (domcontentloaded, load, networkidle)')
+        .option('--timeout <ms>', 'Timeout in milliseconds', parseInt)
+        .action(async (task, opts) => {
+        let waitType;
+        let waitValue;
+        if (opts.time) {
+            waitType = 'time';
+            waitValue = parseInt(opts.time, 10);
+        }
+        else if (opts.selector) {
+            waitType = 'selector';
+            waitValue = opts.selector;
+        }
+        else if (opts.url) {
+            waitType = 'url';
+            waitValue = opts.url;
+        }
+        else if (opts.fn) {
+            waitType = 'function';
+            waitValue = opts.fn;
+        }
+        else if (opts.state) {
+            waitType = 'load';
+            waitValue = opts.state;
+        }
+        else {
+            console.error('One of --time, --selector, --url, --fn, or --state required');
+            process.exit(1);
+        }
+        const response = await sendIPCRequest({
+            action: 'wait',
+            task,
+            tabId: opts.tab,
+            waitType,
+            waitValue,
+            timeout: opts.timeout,
+        });
+        if (!response.ok) {
+            console.error(response.error);
+            process.exit(1);
+        }
+        console.log('Wait condition met');
+    });
+    // ─── Downloads ───────────────────────────────────────────────────────────────
+    browser
+        .command('download <task>')
+        .description('Set download directory for a task')
+        .option('-t, --tab <tabId>', 'Tab ID (defaults to current)')
+        .requiredOption('-p, --path <dir>', 'Download directory path')
+        .action(async (task, opts) => {
+        const response = await sendIPCRequest({
+            action: 'set-download-path',
+            task,
+            tabId: opts.tab,
+            downloadPath: opts.path,
+        });
+        if (!response.ok) {
+            console.error(response.error);
+            process.exit(1);
+        }
+        console.log(`Download path set to ${opts.path}`);
+    });
+    browser
+        .command('waitdownload <task>')
+        .description('Wait for a download to complete')
+        .option('--timeout <ms>', 'Timeout in milliseconds', parseInt)
+        .action(async (task, opts) => {
+        const response = await sendIPCRequest({
+            action: 'wait-download',
+            task,
+            timeout: opts.timeout,
+        });
+        if (!response.ok) {
+            console.error(response.error);
+            process.exit(1);
+        }
+        console.log(`Downloaded: ${response.downloadPath}`);
+    });
 }
 function collect(val, memo) {
     memo.push(val);
@@ -390,3 +850,14 @@ function formatAge(timestamp) {
     const hours = Math.floor(minutes / 60);
     return `${hours}h ago`;
 }
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m`;
+    const hours = Math.floor(minutes / 60);
+    const mm = minutes % 60;
+    return mm ? `${hours}h ${mm}m` : `${hours}h`;
+}