@devicecloud.dev/dcd 5.0.0-beta.0 → 5.0.0-beta.2

package/dist/commands/live.js

@@ -1,20 +1,18 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.liveCommand = void 0;
-const citty_1 = require("citty");
-const node_fs_1 = require("node:fs");
-const environments_1 = require("../config/environments");
-const api_flags_1 = require("../config/flags/api.flags");
-const api_gateway_1 = require("../gateways/api-gateway");
-const auth_1 = require("../utils/auth");
-const cli_1 = require("../utils/cli");
-const config_store_1 = require("../utils/config-store");
-const styling_1 = require("../utils/styling");
+import { defineCommand } from 'citty';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { resolveFrontendUrl } from '../config/environments.js';
+import { apiFlags } from '../config/flags/api.flags.js';
+import { ApiGateway } from '../gateways/api-gateway.js';
+import { resolveAuth } from '../utils/auth.js';
+import { CliError, logger, validateEnum } from '../utils/cli.js';
+import { resolveApiUrl } from '../utils/config-store.js';
+import { colors, formatUrl } from '../utils/styling.js';
+import { ui } from '../utils/ui.js';
 const PLATFORM_OPTIONS = ['android', 'ios'];
 const READY_TIMEOUT_MS = 180_000;
 const READY_POLL_MS = 2_000;
 async function requireAuth(keyFlag) {
-    return (0, auth_1.resolveAuth)({ apiKeyFlag: keyFlag });
+    return resolveAuth({ apiKeyFlag: keyFlag });
 }
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
@@ -29,19 +27,19 @@ async function waitForReady(apiUrl, auth, sessionName, timeoutMs = READY_TIMEOUT
     const deadline = Date.now() + timeoutMs;
     let lastPhase = '';
     for (;;) {
-        const session = await api_gateway_1.ApiGateway.getLiveSession(apiUrl, auth, sessionName);
+        const session = await ApiGateway.getLiveSession(apiUrl, auth, sessionName);
         if (session.ready)
             return session;
         if (['CANCELLED', 'FAILED', 'STOPPED'].includes(session.status?.toUpperCase?.() ?? '')) {
-            throw new cli_1.CliError(`Session ${sessionName} is ${session.status}; cannot become ready.`);
+            throw new CliError(`Session ${sessionName} is ${session.status}; cannot become ready.`);
         }
         const phase = session.device_state?.phase_label ?? session.device_state?.phase ?? session.status;
         if (phase && phase !== lastPhase) {
             lastPhase = phase;
-            cli_1.logger.log(`   ${styling_1.colors.dim(phase)}`);
+            logger.log(`   ${colors.dim(phase)}`);
         }
         if (Date.now() >= deadline) {
-            throw new cli_1.CliError(`Timed out after ${Math.round(timeoutMs / 1000)}s waiting for the device to be ready` +
+            throw new CliError(`Timed out after ${Math.round(timeoutMs / 1000)}s waiting for the device to be ready` +
                 (phase ? ` (last phase: ${phase})` : '') +
                 '.');
         }
@@ -78,29 +76,29 @@ function recoverFlagValue(flag, parsed, rawArgs) {
 }
 function readFlowFile(filePath) {
     try {
-        return (0, node_fs_1.readFileSync)(filePath, 'utf8');
+        return readFileSync(filePath, 'utf8');
     }
     catch (err) {
-        throw new cli_1.CliError(`Could not read flow file '${filePath}': ${err.message}`);
+        throw new CliError(`Could not read flow file '${filePath}': ${err.message}`);
     }
 }
 function printExecResult(result) {
-    cli_1.logger.log(result.success
-        ? `${styling_1.symbols.success} Command executed successfully`
-        : `${styling_1.symbols.error} Command failed`);
+    logger.log(result.success
+        ? ui.success('Command executed successfully')
+        : `${ui.statusSymbol('FAILED')} Command failed`);
     if (result.output) {
-        cli_1.logger.log((0, styling_1.sectionHeader)('Output'));
-        cli_1.logger.log(result.output);
+        logger.log(ui.section('Output'));
+        logger.log(result.output);
     }
     if (result.error) {
-        cli_1.logger.log((0, styling_1.sectionHeader)('Error'));
-        cli_1.logger.log(styling_1.colors.error(result.error));
+        logger.log(ui.section('Error'));
+        logger.log(colors.error(result.error));
     }
 }
-const startSub = (0, citty_1.defineCommand)({
+const startSub = defineCommand({
     meta: { name: 'start', description: 'Start a new live device session' },
     args: {
-        ...api_flags_1.apiFlags,
+        ...apiFlags,
         platform: {
             type: 'string',
             default: 'android',
@@ -130,49 +128,52 @@ const startSub = (0, citty_1.defineCommand)({
     },
     async run({ args }) {
         const auth = await requireAuth(args['api-key']);
-        const apiUrl = (0, config_store_1.resolveApiUrl)(args['api-url']);
-        const platform = (0, cli_1.validateEnum)(args.platform, PLATFORM_OPTIONS, 'platform');
+        const apiUrl = resolveApiUrl(args['api-url']);
+        const platform = validateEnum(args.platform, PLATFORM_OPTIONS, 'platform');
         const binaryId = args['app-binary-id'];
         const deviceLocale = args['device-locale'];
         const androidDevice = args['android-device'];
         const androidApiLevel = args['android-api-level'];
         if ((androidDevice || androidApiLevel) && platform !== 'android') {
-            throw new cli_1.CliError('--android-device/--android-api-level are only valid with --platform android.');
+            throw new CliError('--android-device/--android-api-level are only valid with --platform android.');
         }
         if (Boolean(androidDevice) !== Boolean(androidApiLevel)) {
-            throw new cli_1.CliError('--android-device and --android-api-level must be provided together.');
+            throw new CliError('--android-device and --android-api-level must be provided together.');
         }
-        cli_1.logger.log(`${styling_1.symbols.running} Starting ${platform} live session...`);
-        const session = await api_gateway_1.ApiGateway.startLiveSession(apiUrl, auth, {
+        logger.log(ui.running(`Starting ${platform} live session…`));
+        const session = await ApiGateway.startLiveSession(apiUrl, auth, {
             binaryUploadId: binaryId,
             deviceLocale,
             platform,
             androidDevice,
             androidApiLevel,
         });
-        const frontendUrl = (0, environments_1.resolveFrontendUrl)(apiUrl);
-        cli_1.logger.log(`${styling_1.symbols.success} Live session started`);
-        cli_1.logger.log(`   ${styling_1.colors.dim('Session:')}    ${styling_1.colors.highlight(session.session_name)}`);
-        cli_1.logger.log(`   ${styling_1.colors.dim('Platform:')}   ${session.platform}`);
-        cli_1.logger.log(`   ${styling_1.colors.dim('Status:')}     ${session.status}`);
-        cli_1.logger.log(`   ${styling_1.colors.dim('Console:')}    ${styling_1.colors.highlight(`${frontendUrl}/live?session=${session.session_name}`)}`);
+        const frontendUrl = resolveFrontendUrl(apiUrl);
+        logger.log(ui.success('Live session started'));
+        logger.log(ui.branch(ui.fields([
+            ['session', colors.highlight(session.session_name)],
+            ['platform', session.platform],
+            ['status', session.status],
+            ['console', formatUrl(`${frontendUrl}/live?session=${session.session_name}`)],
+        ])));
         if (args.wait) {
-            cli_1.logger.log('');
-            cli_1.logger.log(`${styling_1.symbols.running} Waiting for the device to be ready...`);
+            logger.log(ui.running('Waiting for the device to be ready…'));
             const ready = await waitForReady(apiUrl, auth, session.session_name);
-            cli_1.logger.log(`${styling_1.symbols.success} Device ready${ready.device_model ? ` (${ready.device_model})` : ''}`);
+            logger.log(ui.success(`Device ready${ready.device_model ? ` (${ready.device_model})` : ''}`));
         }
-        cli_1.logger.log('');
-        cli_1.logger.log(`   ${styling_1.colors.dim('Install a binary:')}  ${styling_1.colors.highlight(`dcd live install --session ${session.session_name} --app-binary-id <id>`)}`);
-        cli_1.logger.log(`   ${styling_1.colors.dim('Run a flow:')}        ${styling_1.colors.highlight(`dcd live run --session ${session.session_name} path/to/flow.yaml`)}`);
-        cli_1.logger.log(`   ${styling_1.colors.dim('Inspect screen:')}    ${styling_1.colors.highlight(`dcd live hierarchy --session ${session.session_name}`)}`);
-        cli_1.logger.log(`   ${styling_1.colors.dim('Stop session:')}      ${styling_1.colors.highlight(`dcd live stop --session ${session.session_name}`)}`);
+        logger.log(ui.section('Next steps'));
+        logger.log(ui.branch(ui.fields([
+            ['install a binary', colors.highlight(`dcd live install --session ${session.session_name} --app-binary-id <id>`)],
+            ['run a flow', colors.highlight(`dcd live run --session ${session.session_name} path/to/flow.yaml`)],
+            ['inspect screen', colors.highlight(`dcd live hierarchy --session ${session.session_name}`)],
+            ['stop session', colors.highlight(`dcd live stop --session ${session.session_name}`)],
+        ])));
     },
 });
-const installSub = (0, citty_1.defineCommand)({
+const installSub = defineCommand({
     meta: { name: 'install', description: 'Install a binary on the device' },
     args: {
-        ...api_flags_1.apiFlags,
+        ...apiFlags,
         session: { type: 'string', required: true, description: 'Live session name' },
         'app-binary-id': {
             type: 'string',
@@ -187,23 +188,23 @@ const installSub = (0, citty_1.defineCommand)({
     },
     async run({ args }) {
         const auth = await requireAuth(args['api-key']);
-        const apiUrl = (0, config_store_1.resolveApiUrl)(args['api-url']);
+        const apiUrl = resolveApiUrl(args['api-url']);
         const sessionName = args.session;
         const binaryId = args['app-binary-id'];
-        cli_1.logger.log(`${styling_1.symbols.running} Installing binary ${styling_1.colors.highlight(binaryId)} on session ${styling_1.colors.highlight(sessionName)}...`);
-        await api_gateway_1.ApiGateway.installLiveBinary(apiUrl, auth, sessionName, binaryId);
-        cli_1.logger.log(`${styling_1.symbols.success} Binary installed successfully`);
+        logger.log(ui.running(`Installing binary ${colors.highlight(binaryId)} on session ${colors.highlight(sessionName)}…`));
+        await ApiGateway.installLiveBinary(apiUrl, auth, sessionName, binaryId);
+        logger.log(ui.success('Binary installed successfully'));
         if (args.wait) {
-            cli_1.logger.log(`${styling_1.symbols.running} Waiting for the device to be ready...`);
+            logger.log(ui.running('Waiting for the device to be ready…'));
             await waitForReady(apiUrl, auth, sessionName);
-            cli_1.logger.log(`${styling_1.symbols.success} Device ready`);
+            logger.log(ui.success('Device ready'));
         }
     },
 });
-const execSub = (0, citty_1.defineCommand)({
+const execSub = defineCommand({
     meta: { name: 'exec', description: 'Execute Maestro YAML commands' },
     args: {
-        ...api_flags_1.apiFlags,
+        ...apiFlags,
         session: { type: 'string', required: true, description: 'Live session name' },
         yaml: { type: 'string', description: 'Maestro YAML commands to execute' },
         file: {
@@ -218,32 +219,32 @@ const execSub = (0, citty_1.defineCommand)({
     },
     async run({ args, rawArgs }) {
         const auth = await requireAuth(args['api-key']);
-        const apiUrl = (0, config_store_1.resolveApiUrl)(args['api-url']);
+        const apiUrl = resolveApiUrl(args['api-url']);
         const sessionName = args.session;
         const inlineYaml = recoverFlagValue('--yaml', args.yaml, rawArgs);
         const file = args.file;
         if (inlineYaml && file) {
-            throw new cli_1.CliError('Pass either --yaml or --file, not both.');
+            throw new CliError('Pass either --yaml or --file, not both.');
         }
         const yaml = file ? readFlowFile(file) : inlineYaml;
         if (!yaml || !yaml.trim()) {
-            throw new cli_1.CliError('Provide commands to execute via --yaml or --file.');
+            throw new CliError('Provide commands to execute via --yaml or --file.');
         }
         if (args.wait) {
             await waitForReady(apiUrl, auth, sessionName);
         }
-        cli_1.logger.log(`${styling_1.symbols.running} Executing commands on session ${styling_1.colors.highlight(sessionName)}...`);
-        const result = await api_gateway_1.ApiGateway.execLiveYaml(apiUrl, auth, sessionName, yaml);
+        logger.log(ui.running(`Executing commands on session ${colors.highlight(sessionName)}…`));
+        const result = await ApiGateway.execLiveYaml(apiUrl, auth, sessionName, yaml);
         printExecResult(result);
     },
 });
-const runSub = (0, citty_1.defineCommand)({
+const runSub = defineCommand({
     meta: {
         name: 'run',
         description: 'Run a whole Maestro flow file against the live session',
     },
     args: {
-        ...api_flags_1.apiFlags,
+        ...apiFlags,
         session: { type: 'string', required: true, description: 'Live session name' },
         wait: {
             type: 'boolean',
@@ -263,62 +264,62 @@ const runSub = (0, citty_1.defineCommand)({
     },
     async run({ args }) {
         const auth = await requireAuth(args['api-key']);
-        const apiUrl = (0, config_store_1.resolveApiUrl)(args['api-url']);
+        const apiUrl = resolveApiUrl(args['api-url']);
         const sessionName = args.session;
         const flowFile = args.flowFile;
         const timeoutMs = Math.max(1, Number(args.timeout) || 600) * 1000;
         const commands = extractFlowCommands(readFlowFile(flowFile));
         if (!commands) {
-            throw new cli_1.CliError(`Flow file '${flowFile}' has no commands to run.`);
+            throw new CliError(`Flow file '${flowFile}' has no commands to run.`);
         }
         if (args.wait) {
             await waitForReady(apiUrl, auth, sessionName);
         }
-        cli_1.logger.log(`${styling_1.symbols.running} Running ${styling_1.colors.highlight(flowFile)} on session ${styling_1.colors.highlight(sessionName)}...`);
+        logger.log(ui.running(`Running ${colors.highlight(flowFile)} on session ${colors.highlight(sessionName)}…`));
         // Submit asynchronously and poll, so a long flow isn't capped by the
         // server's 120s synchronous exec limit. Older servers ignore `async` and
         // return the full result inline — handle that by falling through.
-        const submitted = await api_gateway_1.ApiGateway.execLiveYaml(apiUrl, auth, sessionName, commands, {
+        const submitted = await ApiGateway.execLiveYaml(apiUrl, auth, sessionName, commands, {
             async: true,
         });
         if (!submitted.commandId) {
             printExecResult(submitted);
             if (!submitted.success)
-                throw new cli_1.CliError(submitted.error || 'Flow failed.', 2);
+                throw new CliError(submitted.error || 'Flow failed.', 2);
             return;
         }
         const commandId = submitted.commandId;
         const deadline = Date.now() + timeoutMs;
         let lastKeepalive = Date.now();
         for (;;) {
-            const status = await api_gateway_1.ApiGateway.getLiveCommand(apiUrl, auth, sessionName, commandId);
+            const status = await ApiGateway.getLiveCommand(apiUrl, auth, sessionName, commandId);
             if (status.done) {
                 printExecResult(status);
                 if (!status.success)
-                    throw new cli_1.CliError(status.error || 'Flow failed.', 2);
+                    throw new CliError(status.error || 'Flow failed.', 2);
                 return;
             }
             if (Date.now() >= deadline) {
-                throw new cli_1.CliError(`Flow still running after ${Math.round(timeoutMs / 1000)}s (command ${commandId}). ` +
+                throw new CliError(`Flow still running after ${Math.round(timeoutMs / 1000)}s (command ${commandId}). ` +
                     'Raise --timeout if the flow legitimately runs longer.', 2);
             }
             // Keep the session alive during long polls so the inactivity sweep
             // doesn't cancel it mid-flow.
             if (Date.now() - lastKeepalive > 60_000) {
-                await api_gateway_1.ApiGateway.keepaliveLiveSession(apiUrl, auth, sessionName);
+                await ApiGateway.keepaliveLiveSession(apiUrl, auth, sessionName);
                 lastKeepalive = Date.now();
             }
             await sleep(2_000);
         }
     },
 });
-const screenshotSub = (0, citty_1.defineCommand)({
+const screenshotSub = defineCommand({
     meta: {
         name: 'screenshot',
         description: 'Save the current device screen to an image file (PNG/JPEG)',
     },
     args: {
-        ...api_flags_1.apiFlags,
+        ...apiFlags,
         session: { type: 'string', required: true, description: 'Live session name' },
         output: {
             type: 'string',
@@ -328,32 +329,34 @@ const screenshotSub = (0, citty_1.defineCommand)({
     },
     async run({ args }) {
         const auth = await requireAuth(args['api-key']);
-        const apiUrl = (0, config_store_1.resolveApiUrl)(args['api-url']);
+        const apiUrl = resolveApiUrl(args['api-url']);
         const sessionName = args.session;
-        const session = await api_gateway_1.ApiGateway.getLiveSession(apiUrl, auth, sessionName);
+        const session = await ApiGateway.getLiveSession(apiUrl, auth, sessionName);
         const dataUrl = session.screenshot_data_url ?? session.hierarchy?.screenshot;
         if (!dataUrl) {
-            throw new cli_1.CliError(`No screenshot available yet for ${sessionName}. The device may not be streaming — ` +
+            throw new CliError(`No screenshot available yet for ${sessionName}. The device may not be streaming — ` +
                 'try again, or start/install with --wait.');
         }
         const match = /^data:image\/(\w+);base64,(.+)$/s.exec(dataUrl);
         const ext = match ? match[1].replace('jpeg', 'jpg') : 'png';
         const base64 = match ? match[2] : dataUrl;
         const output = args.output ?? `live-screenshot.${ext}`;
-        (0, node_fs_1.writeFileSync)(output, Buffer.from(base64, 'base64'));
-        cli_1.logger.log(`${styling_1.symbols.success} Screenshot saved to ${styling_1.colors.highlight(output)}`);
+        writeFileSync(output, Buffer.from(base64, 'base64'));
+        logger.log(ui.success(`Screenshot saved to ${colors.highlight(output)}`));
         if (session.hierarchy) {
-            cli_1.logger.log(`   ${styling_1.colors.dim('Resolution:')} ${session.hierarchy.width}x${session.hierarchy.height}`);
+            logger.log(ui.branch(ui.fields([
+                ['resolution', `${session.hierarchy.width}x${session.hierarchy.height}`],
+            ])));
         }
     },
 });
-const hierarchySub = (0, citty_1.defineCommand)({
+const hierarchySub = defineCommand({
     meta: {
         name: 'hierarchy',
         description: 'Dump the current view hierarchy (the selectors you can tap/assert on)',
     },
     args: {
-        ...api_flags_1.apiFlags,
+        ...apiFlags,
         session: { type: 'string', required: true, description: 'Live session name' },
         json: { type: 'boolean', description: 'Output the raw hierarchy as JSON' },
         output: {
@@ -364,21 +367,21 @@ const hierarchySub = (0, citty_1.defineCommand)({
     },
     async run({ args }) {
         const auth = await requireAuth(args['api-key']);
-        const apiUrl = (0, config_store_1.resolveApiUrl)(args['api-url']);
+        const apiUrl = resolveApiUrl(args['api-url']);
         const sessionName = args.session;
         const json = Boolean(args.json);
         const output = args.output;
-        const session = await api_gateway_1.ApiGateway.getLiveSession(apiUrl, auth, sessionName);
+        const session = await ApiGateway.getLiveSession(apiUrl, auth, sessionName);
         const hierarchy = session.hierarchy;
         if (!hierarchy) {
-            throw new cli_1.CliError(`No hierarchy available yet for ${sessionName}. The device may not be streaming — ` +
+            throw new CliError(`No hierarchy available yet for ${sessionName}. The device may not be streaming — ` +
                 'try again, or start/install with --wait.');
         }
         if (json) {
             const out = JSON.stringify(hierarchy, null, 2);
             if (output) {
-                (0, node_fs_1.writeFileSync)(output, out);
-                cli_1.logger.log(`${styling_1.symbols.success} Hierarchy written to ${styling_1.colors.highlight(output)}`);
+                writeFileSync(output, out);
+                logger.log(ui.success(`Hierarchy written to ${colors.highlight(output)}`));
             }
             else {
                 // eslint-disable-next-line no-console
@@ -400,71 +403,74 @@ const hierarchySub = (0, citty_1.defineCommand)({
             if (parts.length === 0)
                 continue;
             const bounds = el.bounds
-                ? `  ${styling_1.colors.dim(`(${el.bounds.x},${el.bounds.y} ${el.bounds.width}x${el.bounds.height})`)}`
+                ? `  ${colors.dim(`(${el.bounds.x},${el.bounds.y} ${el.bounds.width}x${el.bounds.height})`)}`
                 : '';
             lines.push(`  ${parts.join('  ')}${bounds}`);
         }
         const out = lines.join('\n');
         if (output) {
-            (0, node_fs_1.writeFileSync)(output, `${out}\n`);
-            cli_1.logger.log(`${styling_1.symbols.success} Hierarchy written to ${styling_1.colors.highlight(output)}`);
+            writeFileSync(output, `${out}\n`);
+            logger.log(ui.success(`Hierarchy written to ${colors.highlight(output)}`));
         }
         else {
-            cli_1.logger.log(out);
+            logger.log(out);
         }
     },
 });
-const stopSub = (0, citty_1.defineCommand)({
+const stopSub = defineCommand({
     meta: { name: 'stop', description: 'Stop a live session' },
     args: {
-        ...api_flags_1.apiFlags,
+        ...apiFlags,
         session: { type: 'string', required: true, description: 'Live session name' },
     },
     async run({ args }) {
         const auth = await requireAuth(args['api-key']);
-        const apiUrl = (0, config_store_1.resolveApiUrl)(args['api-url']);
+        const apiUrl = resolveApiUrl(args['api-url']);
         const sessionName = args.session;
-        cli_1.logger.log(`${styling_1.symbols.running} Stopping session ${styling_1.colors.highlight(sessionName)}...`);
-        await api_gateway_1.ApiGateway.stopLiveSession(apiUrl, auth, sessionName);
-        cli_1.logger.log(`${styling_1.symbols.success} Session stopped`);
+        logger.log(ui.running(`Stopping session ${colors.highlight(sessionName)}…`));
+        await ApiGateway.stopLiveSession(apiUrl, auth, sessionName);
+        logger.log(ui.success('Session stopped'));
     },
 });
-const statusSub = (0, citty_1.defineCommand)({
+const statusSub = defineCommand({
     meta: { name: 'status', description: 'Get session status' },
     args: {
-        ...api_flags_1.apiFlags,
+        ...apiFlags,
         session: { type: 'string', required: true, description: 'Live session name' },
     },
     async run({ args }) {
         const auth = await requireAuth(args['api-key']);
-        const apiUrl = (0, config_store_1.resolveApiUrl)(args['api-url']);
+        const apiUrl = resolveApiUrl(args['api-url']);
         const sessionName = args.session;
-        const session = await api_gateway_1.ApiGateway.getLiveSession(apiUrl, auth, sessionName);
-        cli_1.logger.log((0, styling_1.sectionHeader)('Live Session'));
-        cli_1.logger.log(`   ${styling_1.colors.dim('Session:')}    ${styling_1.colors.highlight(session.session_name)}`);
-        cli_1.logger.log(`   ${styling_1.colors.dim('Platform:')}   ${session.platform}`);
-        cli_1.logger.log(`   ${styling_1.colors.dim('Status:')}     ${session.status}`);
-        cli_1.logger.log(`   ${styling_1.colors.dim('Ready:')}      ${session.ready ? styling_1.colors.success('yes') : styling_1.colors.warning('no')}`);
+        const session = await ApiGateway.getLiveSession(apiUrl, auth, sessionName);
+        const fields = [
+            ['session', colors.highlight(session.session_name)],
+            ['platform', session.platform],
+            ['status', session.status],
+            ['ready', session.ready ? colors.success('yes') : colors.warning('no')],
+        ];
         const phase = session.device_state?.phase_label ?? session.device_state?.phase;
         if (phase) {
-            cli_1.logger.log(`   ${styling_1.colors.dim('Phase:')}      ${phase}`);
+            fields.push(['phase', phase]);
         }
         if (session.device_model) {
-            cli_1.logger.log(`   ${styling_1.colors.dim('Device:')}     ${session.device_model}`);
+            fields.push(['device', session.device_model]);
         }
         if (session.device_locale) {
-            cli_1.logger.log(`   ${styling_1.colors.dim('Locale:')}     ${session.device_locale}`);
+            fields.push(['locale', session.device_locale]);
         }
         if (session.binary_upload_id) {
-            cli_1.logger.log(`   ${styling_1.colors.dim('Binary:')}     ${session.binary_upload_id}`);
+            fields.push(['binary', session.binary_upload_id]);
         }
         if (typeof session.seconds_until_auto_cancel === 'number') {
-            cli_1.logger.log(`   ${styling_1.colors.dim('Auto-cancel in:')} ${session.seconds_until_auto_cancel}s`);
+            fields.push(['auto-cancel in', `${session.seconds_until_auto_cancel}s`]);
         }
-        cli_1.logger.log(`   ${styling_1.colors.dim('Created:')}    ${new Date(session.created_at).toLocaleString()}`);
+        fields.push(['created', new Date(session.created_at).toLocaleString()]);
+        logger.log(ui.section('Live Session'));
+        logger.log(ui.branch(ui.fields(fields)));
     },
 });
-exports.liveCommand = (0, citty_1.defineCommand)({
+export const liveCommand = defineCommand({
     meta: {
         name: 'live',
         description: 'Start and interact with a live device session',
@@ -497,17 +503,18 @@ exports.liveCommand = (0, citty_1.defineCommand)({
         const firstPositional = rawArgs.find((arg) => !arg.startsWith('-'));
         if (firstPositional && subNames.has(firstPositional))
             return;
-        cli_1.logger.log((0, styling_1.sectionHeader)('Live Session Commands'));
-        cli_1.logger.log(`   ${styling_1.colors.bold('start')}       Start a new live device session`);
-        cli_1.logger.log(`   ${styling_1.colors.bold('install')}     Install a binary on the device`);
-        cli_1.logger.log(`   ${styling_1.colors.bold('exec')}        Execute Maestro YAML commands`);
-        cli_1.logger.log(`   ${styling_1.colors.bold('run')}         Run a whole Maestro flow file`);
-        cli_1.logger.log(`   ${styling_1.colors.bold('screenshot')}  Save the current device screen to an image file`);
-        cli_1.logger.log(`   ${styling_1.colors.bold('hierarchy')}   Dump the current view hierarchy (selectors)`);
-        cli_1.logger.log(`   ${styling_1.colors.bold('stop')}        Stop a live session`);
-        cli_1.logger.log(`   ${styling_1.colors.bold('status')}      Get session status`);
-        cli_1.logger.log('');
-        cli_1.logger.log(`   Run ${styling_1.colors.highlight('dcd live <command> --help')} for details`);
+        logger.log(ui.section('Live Session Commands'));
+        logger.log(ui.branch(ui.fields([
+            [colors.bold('start'), 'Start a new live device session'],
+            [colors.bold('install'), 'Install a binary on the device'],
+            [colors.bold('exec'), 'Execute Maestro YAML commands'],
+            [colors.bold('run'), 'Run a whole Maestro flow file'],
+            [colors.bold('screenshot'), 'Save the current device screen to an image file'],
+            [colors.bold('hierarchy'), 'Dump the current view hierarchy (selectors)'],
+            [colors.bold('stop'), 'Stop a live session'],
+            [colors.bold('status'), 'Get session status'],
+        ])));
+        logger.log(ui.note(`\nRun ${colors.highlight('dcd live <command> --help')} for details`));
     },
 });
-exports.default = exports.liveCommand;
+export default liveCommand;

package/dist/commands/login.d.ts

@@ -1,17 +1,17 @@
 export declare const loginCommand: import("citty").CommandDef<{
-    'api-url': {
-        type: "string";
-        default: string;
-        description: string;
+    readonly 'api-url': {
+        readonly type: "string";
+        readonly default: "https://api.devicecloud.dev";
+        readonly description: "API base URL";
     };
-    'frontend-url': {
-        type: "string";
-        description: string;
+    readonly 'frontend-url': {
+        readonly type: "string";
+        readonly description: "Override the frontend URL used to complete login (defaults per env)";
     };
-    browser: {
-        type: "boolean";
-        default: true;
-        description: string;
+    readonly browser: {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly description: "Open the login URL in a browser (pass --no-browser to just print it)";
     };
 }>;
 export default loginCommand;