convoai 1.0.0

package/dist/src/commands/agent/interrupt.js

@@ -0,0 +1,32 @@
+import { getAgentAPI } from './_helpers.js';
+import { withSpinner } from '../../ui/spinner.js';
+import { printSuccess } from '../../ui/output.js';
+import { handleError } from '../../utils/errors.js';
+import { shortId } from '../../utils/hints.js';
+// ─── Command Registration ──────────────────────────────────────────────────
+export function registerAgentInterrupt(program) {
+    program
+        .command('interrupt <agent-id>')
+        .description('Interrupt an agent that is currently speaking')
+        .option('--profile <name>', 'Use a named config profile')
+        .option('--json', 'Output result as JSON')
+        .action(async (agentId, opts) => {
+        try {
+            await interruptAction(agentId, opts);
+        }
+        catch (error) {
+            handleError(error, { json: opts.json });
+        }
+    });
+}
+// ─── Action ────────────────────────────────────────────────────────────────
+async function interruptAction(agentId, opts) {
+    const api = getAgentAPI(opts.profile);
+    await withSpinner('Interrupting agent...', () => api.interrupt(agentId));
+    if (opts.json) {
+        console.log(JSON.stringify({ agent_id: agentId, interrupted: true }, null, 2));
+        return;
+    }
+    printSuccess(`Agent ${shortId(agentId)} interrupted.`);
+}
+//# sourceMappingURL=interrupt.js.map

package/dist/src/commands/agent/interrupt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt.js","sourceRoot":"","sources":["../../../../src/commands/agent/interrupt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,8EAA8E;AAE9E,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,sBAAsB,CAAC;SAC/B,WAAW,CAAC,+CAA+C,CAAC;SAC5D,MAAM,CAAC,kBAAkB,EAAE,4BAA4B,CAAC;SACxD,MAAM,CAAC,QAAQ,EAAE,uBAAuB,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,IAAsB,EAAE,EAAE;QACxD,IAAI,CAAC;YACH,MAAM,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AASD,8EAA8E;AAE9E,KAAK,UAAU,eAAe,CAC5B,OAAe,EACf,IAAsB;IAEtB,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEtC,MAAM,WAAW,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/E,OAAO;IACT,CAAC;IAED,YAAY,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;AACzD,CAAC"}

package/dist/src/commands/agent/join.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerAgentJoin(program: Command): void;

package/dist/src/commands/agent/join.js

@@ -0,0 +1,168 @@
+import { createServer } from 'node:http';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { execSync } from 'node:child_process';
+import chalk from 'chalk';
+import { getAgentAPI } from './_helpers.js';
+import { resolveConfig } from '../../config/manager.js';
+import { getPreset } from '../../presets/defaults.js';
+import { generateRtcToken } from '../../utils/token.js';
+import { withSpinner } from '../../ui/spinner.js';
+import { printSuccess, printError } from '../../ui/output.js';
+import { printKeyValue } from '../../ui/table.js';
+import { handleError } from '../../utils/errors.js';
+import { shortId } from '../../utils/hints.js';
+// ─── Locate HTML Client ───────────────────────────────────────────────────
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function findClientHtml() {
+    // Walk up to find src/web/client.html (works from dist/ and src/)
+    let dir = __dirname;
+    for (let i = 0; i < 6; i++) {
+        const candidate = join(dir, 'src', 'web', 'client.html');
+        try {
+            readFileSync(candidate);
+            return candidate;
+        }
+        catch { /* keep looking */ }
+        dir = dirname(dir);
+    }
+    throw new Error('Could not find web client HTML. Reinstall the package.');
+}
+// ─── Command Registration ──────────────────────────────────────────────────
+export function registerAgentJoin(program) {
+    program
+        .command('join')
+        .description('Start an agent and open voice chat in your browser')
+        .requiredOption('-c, --channel <name>', 'Channel name')
+        .option('--preset <name>', 'Use a built-in preset')
+        .option('--model <model>', 'LLM model name')
+        .option('--tts <vendor>', 'TTS vendor (overrides preset)')
+        .option('--asr <vendor>', 'ASR vendor (overrides preset)')
+        .option('--system-message <msg>', 'System prompt for the LLM')
+        .option('--greeting <msg>', 'Greeting message')
+        .option('--idle-timeout <seconds>', 'Idle timeout in seconds', '300')
+        .option('--port <port>', 'Local server port', '3210')
+        .option('--profile <name>', 'Config profile')
+        .option('--no-open', 'Do not auto-open the browser')
+        .action(async (opts) => {
+        try {
+            await joinAction(opts);
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}
+// ─── Action ────────────────────────────────────────────────────────────────
+async function joinAction(opts) {
+    const config = resolveConfig(opts.profile);
+    const appId = config.app_id;
+    if (!appId) {
+        printError('App ID not configured. Run `convoai config init` first.');
+        process.exit(1);
+    }
+    // ── 1. Generate tokens ─────────────────────────────────────────────────
+    const agentUid = 0;
+    const clientUid = 12345;
+    const agentToken = await generateRtcToken(opts.channel, agentUid);
+    const clientToken = await generateRtcToken(opts.channel, clientUid);
+    if (!agentToken) {
+        printError('Cannot generate RTC token. Run `convoai config set app_certificate <cert>` first.');
+        process.exit(1);
+    }
+    // ── 2. Start the agent ─────────────────────────────────────────────────
+    const presetProps = getPreset(opts.preset);
+    const llm = {
+        ...config.llm,
+        ...presetProps?.llm,
+        api_key: config.llm?.api_key ?? presetProps?.llm?.api_key,
+        url: config.llm?.url ?? presetProps?.llm?.url,
+    };
+    if (opts.model)
+        llm.model = opts.model;
+    if (opts.systemMessage)
+        llm.system_messages = [{ role: 'system', content: opts.systemMessage }];
+    if (opts.greeting)
+        llm.greeting_message = opts.greeting;
+    const request = {
+        name: `join-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+        properties: {
+            channel: opts.channel,
+            token: agentToken,
+            agent_rtc_uid: String(agentUid),
+            remote_rtc_uids: ['*'],
+            idle_timeout: parseInt(opts.idleTimeout, 10),
+            llm: Object.keys(llm).length > 0 ? llm : undefined,
+            tts: opts.tts
+                ? { ...config.tts, vendor: opts.tts, params: { ...config.tts?.params } }
+                : { ...config.tts, ...presetProps?.tts, params: { ...config.tts?.params, ...presetProps?.tts?.params } },
+            asr: opts.asr
+                ? { ...config.asr, vendor: opts.asr, params: { ...config.asr?.params } }
+                : config.asr?.vendor
+                    ? config.asr
+                    : { vendor: 'ares', language: 'zh-CN' },
+        },
+    };
+    const api = getAgentAPI(opts.profile);
+    const result = await withSpinner('Starting agent...', () => api.start(request));
+    printSuccess('Agent started.');
+    printKeyValue([
+        ['Agent ID', result.agent_id],
+        ['Channel', opts.channel],
+        ['Status', result.status],
+    ]);
+    // ── 3. Start local web server ──────────────────────────────────────────
+    const port = parseInt(opts.port, 10);
+    const htmlPath = findClientHtml();
+    const html = readFileSync(htmlPath, 'utf-8');
+    const server = createServer((req, res) => {
+        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+        res.end(html);
+    });
+    await new Promise((resolve, reject) => {
+        server.listen(port, () => resolve());
+        server.on('error', reject);
+    });
+    // ── 4. Open browser ────────────────────────────────────────────────────
+    const params = new URLSearchParams({
+        appId: appId,
+        channel: opts.channel,
+        token: clientToken ?? '',
+        uid: String(clientUid),
+    });
+    const url = `http://localhost:${port}?${params}`;
+    console.log('');
+    console.log(chalk.cyan('  Voice chat: ') + chalk.bold(url));
+    console.log('');
+    if (opts.open) {
+        try {
+            const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+            execSync(`${cmd} "${url}"`);
+            printSuccess('Browser opened. Allow microphone and start talking!');
+        }
+        catch {
+            console.log(chalk.dim('  Open the URL above in your browser.'));
+        }
+    }
+    console.log(chalk.dim('  Press Ctrl+C to stop the agent and exit.\n'));
+    // ── 5. Handle shutdown ─────────────────────────────────────────────────
+    const cleanup = async () => {
+        console.log('');
+        try {
+            await withSpinner(`Stopping agent ${shortId(result.agent_id)}...`, () => api.stop(result.agent_id));
+            printSuccess('Agent stopped.');
+        }
+        catch {
+            // Agent may have already stopped
+        }
+        server.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+    // Keep alive
+    await new Promise(() => { });
+}
+//# sourceMappingURL=join.js.map

package/dist/src/commands/agent/join.js.map

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

package/dist/src/commands/agent/list.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerAgentList(program: Command): void;

package/dist/src/commands/agent/list.js

@@ -0,0 +1,67 @@
+import { getAgentAPI, relativeTime } from './_helpers.js';
+import { withSpinner } from '../../ui/spinner.js';
+import { printTable } from '../../ui/table.js';
+import { printHint } from '../../ui/output.js';
+import { colorStatus } from '../../ui/colors.js';
+import { handleError } from '../../utils/errors.js';
+import { hintAfterList, shortId } from '../../utils/hints.js';
+// ─── State Name Mapping ────────────────────────────────────────────────────
+const STATE_MAP = {
+    running: 2,
+    stopped: 4,
+    failed: 6,
+    all: undefined,
+};
+// ─── Command Registration ──────────────────────────────────────────────────
+export function registerAgentList(program) {
+    program
+        .command('list')
+        .alias('ls')
+        .description('List agents')
+        .option('-s, --state <state>', 'Filter by state: running, stopped, failed, all', 'running')
+        .option('-c, --channel <name>', 'Filter by channel name')
+        .option('-l, --limit <n>', 'Maximum number of agents to return', '20')
+        .option('--profile <name>', 'Config profile to use')
+        .option('--json', 'Output result as JSON')
+        .action(async (opts) => {
+        try {
+            const stateName = opts.state.toLowerCase();
+            if (!(stateName in STATE_MAP)) {
+                throw new Error(`Invalid state "${opts.state}". Choose from: running, stopped, failed, all`);
+            }
+            const params = {
+                state: STATE_MAP[stateName],
+                limit: parseInt(opts.limit, 10),
+            };
+            if (opts.channel) {
+                params.channel = opts.channel;
+            }
+            const api = getAgentAPI(opts.profile);
+            const response = await withSpinner('Fetching agents...', () => api.list(params));
+            if (opts.json) {
+                console.log(JSON.stringify(response, null, 2));
+                return;
+            }
+            const agents = response.data.list;
+            const total = response.meta.total ?? response.data.count;
+            if (agents.length === 0) {
+                console.log(`No ${stateName === 'all' ? '' : stateName + ' '}agents found.`);
+                printHint(hintAfterList());
+                return;
+            }
+            const rows = agents.map((agent) => [
+                shortId(agent.agent_id),
+                colorStatus(agent.status),
+                agent.channel ?? '—',
+                relativeTime(agent.start_ts),
+            ]);
+            printTable(['AGENT_ID', 'STATUS', 'CHANNEL', 'CREATED'], rows);
+            console.log(`\nShowing ${agents.length} of ${total} agents`);
+            printHint(hintAfterList());
+        }
+        catch (error) {
+            handleError(error, { json: opts.json });
+        }
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/src/commands/agent/list.js.map

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

package/dist/src/commands/agent/speak.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerAgentSpeak(program: Command): void;

package/dist/src/commands/agent/speak.js

@@ -0,0 +1,48 @@
+import { getAgentAPI } from './_helpers.js';
+import { withSpinner } from '../../ui/spinner.js';
+import { printSuccess } from '../../ui/output.js';
+import { handleError } from '../../utils/errors.js';
+import { shortId } from '../../utils/hints.js';
+// ─── Command Registration ──────────────────────────────────────────────────
+export function registerAgentSpeak(program) {
+    program
+        .command('speak <agent-id> <text>')
+        .description('Instruct an agent to speak the given text')
+        .option('--priority <priority>', 'Message priority: INTERRUPT, APPEND, or IGNORE', 'INTERRUPT')
+        .option('--no-interrupt', 'Prevent user from voice-interrupting this message')
+        .option('--profile <name>', 'Use a named config profile')
+        .option('--json', 'Output result as JSON')
+        .action(async (agentId, text, opts) => {
+        try {
+            await speakAction(agentId, text, opts);
+        }
+        catch (error) {
+            handleError(error, { json: opts.json });
+        }
+    });
+}
+// ─── Action ────────────────────────────────────────────────────────────────
+async function speakAction(agentId, text, opts) {
+    const priority = validatePriority(opts.priority);
+    const api = getAgentAPI(opts.profile);
+    const response = await withSpinner('Sending message...', () => api.speak(agentId, {
+        text,
+        priority,
+        interrupt: opts.interrupt,
+    }));
+    if (opts.json) {
+        console.log(JSON.stringify(response, null, 2));
+        return;
+    }
+    printSuccess(`Message sent to agent ${shortId(agentId)}`);
+}
+// ─── Helpers ───────────────────────────────────────────────────────────────
+const VALID_PRIORITIES = ['INTERRUPT', 'APPEND', 'IGNORE'];
+function validatePriority(value) {
+    const upper = value.toUpperCase();
+    if (!VALID_PRIORITIES.includes(upper)) {
+        throw new Error(`Invalid priority "${value}". Must be one of: ${VALID_PRIORITIES.join(', ')}`);
+    }
+    return upper;
+}
+//# sourceMappingURL=speak.js.map

package/dist/src/commands/agent/speak.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speak.js","sourceRoot":"","sources":["../../../../src/commands/agent/speak.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,8EAA8E;AAE9E,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,yBAAyB,CAAC;SAClC,WAAW,CAAC,2CAA2C,CAAC;SACxD,MAAM,CACL,uBAAuB,EACvB,gDAAgD,EAChD,WAAW,CACZ;SACA,MAAM,CACL,gBAAgB,EAChB,mDAAmD,CACpD;SACA,MAAM,CAAC,kBAAkB,EAAE,4BAA4B,CAAC;SACxD,MAAM,CAAC,QAAQ,EAAE,uBAAuB,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,IAAY,EAAE,IAAkB,EAAE,EAAE;QAClE,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAWD,8EAA8E;AAE9E,KAAK,UAAU,WAAW,CACxB,OAAe,EACf,IAAY,EACZ,IAAkB;IAElB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEtC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAC5D,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE;QACjB,IAAI;QACJ,QAAQ;QACR,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CACH,CAAC;IAEF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO;IACT,CAAC;IAED,YAAY,CAAC,yBAAyB,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,8EAA8E;AAE9E,MAAM,gBAAgB,GAAoB,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAE5E,SAAS,gBAAgB,CAAC,KAAa;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAmB,CAAC;IACnD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,sBAAsB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9E,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/commands/agent/start.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerAgentStart(program: Command): void;

package/dist/src/commands/agent/start.js

@@ -0,0 +1,212 @@
+import { getAgentAPI, formatTimestamp } from './_helpers.js';
+import { resolveConfig } from '../../config/manager.js';
+import { getPreset } from '../../presets/defaults.js';
+import { generateRtcToken } from '../../utils/token.js';
+import { withSpinner } from '../../ui/spinner.js';
+import { printKeyValue } from '../../ui/table.js';
+import { printSuccess, printError, printHint } from '../../ui/output.js';
+import { handleError } from '../../utils/errors.js';
+import { hintAfterStart } from '../../utils/hints.js';
+// ─── Name Generation ───────────────────────────────────────────────────────
+function generateAgentName() {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).substring(2, 6);
+    return `agent-${timestamp}-${random}`;
+}
+async function promptForMissing(opts) {
+    // Dynamic import so inquirer is only loaded when needed
+    const { default: inquirer } = await import('inquirer');
+    const questions = [];
+    if (!opts.channel) {
+        questions.push({
+            type: 'input',
+            name: 'channel',
+            message: 'Channel name:',
+        });
+    }
+    if (!opts.preset) {
+        questions.push({
+            type: 'input',
+            name: 'preset',
+            message: 'Preset (leave empty for none):',
+        });
+    }
+    if (!opts.model) {
+        questions.push({
+            type: 'input',
+            name: 'model',
+            message: 'LLM model (leave empty for config default):',
+        });
+    }
+    if (questions.length === 0) {
+        return {
+            channel: opts.channel,
+            preset: opts.preset,
+            model: opts.model,
+        };
+    }
+    const answers = await inquirer.prompt(questions);
+    return {
+        channel: opts.channel ?? answers.channel,
+        preset: (opts.preset ?? answers.preset) || undefined,
+        model: (opts.model ?? answers.model) || undefined,
+    };
+}
+// ─── Request Builder ───────────────────────────────────────────────────────
+function buildRequest(opts) {
+    const config = resolveConfig(opts.profile);
+    // Start with preset properties if specified
+    const presetProps = opts.preset ? getPreset(opts.preset) : undefined;
+    // Build LLM config by layering: config defaults -> preset -> CLI flags
+    // Deep merge so config api_key/url are preserved when preset sets vendor/model
+    const llm = {
+        ...config.llm,
+        ...presetProps?.llm,
+        // Preserve config credentials that presets don't provide
+        api_key: config.llm?.api_key ?? presetProps?.llm?.api_key,
+        url: config.llm?.url ?? presetProps?.llm?.url,
+    };
+    if (opts.model) {
+        llm.model = opts.model;
+    }
+    if (opts.llmUrl) {
+        llm.url = opts.llmUrl;
+    }
+    if (opts.llmKey) {
+        llm.api_key = opts.llmKey;
+    }
+    if (opts.systemMessage) {
+        llm.system_messages = [{ role: 'system', content: opts.systemMessage }];
+    }
+    if (opts.greeting) {
+        llm.greeting_message = opts.greeting;
+    }
+    // Build the agent properties
+    const properties = {
+        ...presetProps,
+        channel: opts.channel,
+        token: opts.token,
+        agent_rtc_uid: opts.uid ?? presetProps?.agent_rtc_uid ?? '0',
+        remote_rtc_uids: opts.remoteUids
+            ? opts.remoteUids.split(',').map((u) => u.trim())
+            : presetProps?.remote_rtc_uids ?? ['*'],
+        idle_timeout: opts.idleTimeout
+            ? parseInt(opts.idleTimeout, 10)
+            : presetProps?.idle_timeout ?? 30,
+        llm: Object.keys(llm).length > 0 ? llm : undefined,
+    };
+    // Apply TTS: deep merge config + preset + CLI flag (config keys preserved)
+    if (opts.tts) {
+        properties.tts = { ...config.tts, vendor: opts.tts, params: { ...config.tts?.params } };
+    }
+    else {
+        properties.tts = {
+            ...config.tts,
+            ...presetProps?.tts,
+            params: { ...config.tts?.params, ...presetProps?.tts?.params },
+        };
+    }
+    // Apply ASR: deep merge config + preset + CLI flag
+    if (opts.asr) {
+        properties.asr = { ...config.asr, vendor: opts.asr, params: { ...config.asr?.params } };
+    }
+    else {
+        properties.asr = {
+            ...config.asr,
+            ...presetProps?.asr,
+            params: { ...config.asr?.params, ...presetProps?.asr?.params },
+        };
+    }
+    const request = {
+        name: opts.name ?? generateAgentName(),
+        properties,
+    };
+    return request;
+}
+// ─── Command Registration ──────────────────────────────────────────────────
+export function registerAgentStart(program) {
+    program
+        .command('start')
+        .description('Start a new conversational AI agent')
+        .option('-c, --channel <name>', 'RTC channel name (required)')
+        .option('-n, --name <name>', 'Agent name (auto-generated if omitted)')
+        .option('--preset <name>', 'Use a built-in preset configuration')
+        .option('--model <model>', 'LLM model name (e.g. gpt-4o-mini)')
+        .option('--llm-url <url>', 'LLM API URL')
+        .option('--llm-key <key>', 'LLM API key')
+        .option('--tts <vendor>', 'TTS vendor')
+        .option('--asr <vendor>', 'ASR vendor')
+        .option('--system-message <msg>', 'System prompt for the LLM')
+        .option('--greeting <msg>', 'Greeting message spoken on join')
+        .option('--uid <uid>', 'Agent RTC UID (default: "0" for random assignment)')
+        .option('--remote-uids <uids>', 'Comma-separated remote UIDs (default: "*")')
+        .option('--idle-timeout <seconds>', 'Idle timeout in seconds (default: 30)')
+        .option('--token <token>', 'RTC token (auto-generated if app_certificate is configured)')
+        .option('--profile <name>', 'Config profile to use')
+        .option('--json', 'Output result as JSON')
+        .option('--dry-run', 'Show the request payload without sending it')
+        .action(async (opts) => {
+        try {
+            let channel = opts.channel;
+            let model = opts.model;
+            let preset = opts.preset;
+            // Interactive prompts if running in a TTY and channel is missing
+            if (!channel && process.stdin.isTTY) {
+                const answers = await promptForMissing({ channel, preset, model });
+                channel = answers.channel;
+                preset = answers.preset ?? preset;
+                model = answers.model ?? model;
+            }
+            if (!channel) {
+                printError('--channel is required. Provide it as a flag or run interactively in a TTY.');
+                process.exit(1);
+            }
+            // Auto-generate RTC token if not provided and certificate is configured
+            let token = opts.token;
+            if (!token) {
+                const uid = opts.uid ? parseInt(opts.uid, 10) : 0;
+                token = await generateRtcToken(channel, uid);
+            }
+            const request = buildRequest({
+                channel,
+                name: opts.name,
+                preset,
+                model,
+                llmUrl: opts.llmUrl,
+                llmKey: opts.llmKey,
+                tts: opts.tts,
+                asr: opts.asr,
+                systemMessage: opts.systemMessage,
+                greeting: opts.greeting,
+                uid: opts.uid,
+                remoteUids: opts.remoteUids,
+                idleTimeout: opts.idleTimeout,
+                token,
+                profile: opts.profile,
+            });
+            // Dry-run mode: print request and exit
+            if (opts.dryRun) {
+                console.log(JSON.stringify(request, null, 2));
+                return;
+            }
+            const api = getAgentAPI(opts.profile);
+            const result = await withSpinner('Starting agent...', () => api.start(request));
+            if (opts.json) {
+                console.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            printSuccess(`Agent started successfully.`);
+            printKeyValue([
+                ['Agent ID', result.agent_id],
+                ['Status', result.status],
+                ['Channel', channel],
+                ['Created', formatTimestamp(result.create_ts)],
+            ]);
+            printHint(hintAfterStart(result.agent_id));
+        }
+        catch (error) {
+            handleError(error, { json: opts.json });
+        }
+    });
+}
+//# sourceMappingURL=start.js.map

package/dist/src/commands/agent/start.js.map

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

package/dist/src/commands/agent/status.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerAgentStatus(program: Command): void;

package/dist/src/commands/agent/status.js

@@ -0,0 +1,42 @@
+import { getAgentAPI, formatTimestamp } from './_helpers.js';
+import { withSpinner } from '../../ui/spinner.js';
+import { printKeyValue } from '../../ui/table.js';
+import { colorStatus } from '../../ui/colors.js';
+import { handleError } from '../../utils/errors.js';
+// ─── Command Registration ──────────────────────────────────────────────────
+export function registerAgentStatus(program) {
+    program
+        .command('status <agent-id>')
+        .description('Query the status of an agent')
+        .option('--profile <name>', 'Config profile to use')
+        .option('--json', 'Output result as JSON')
+        .action(async (agentId, opts) => {
+        try {
+            const api = getAgentAPI(opts.profile);
+            const result = await withSpinner('Fetching agent status...', () => api.status(agentId));
+            if (opts.json) {
+                console.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            const pairs = [
+                ['Agent ID', result.agent_id],
+                ['Status', colorStatus(result.status)],
+            ];
+            if (result.channel) {
+                pairs.push(['Channel', result.channel]);
+            }
+            pairs.push(['Started', formatTimestamp(result.start_ts)]);
+            if (result.stop_ts) {
+                pairs.push(['Stopped', formatTimestamp(result.stop_ts)]);
+            }
+            if (result.message) {
+                pairs.push(['Message', result.message]);
+            }
+            printKeyValue(pairs);
+        }
+        catch (error) {
+            handleError(error, { json: opts.json });
+        }
+    });
+}
+//# sourceMappingURL=status.js.map