convoai 1.0.0

package/dist/src/commands/template/show.js

@@ -0,0 +1,98 @@
+import chalk from 'chalk';
+import { loadTemplate } from '../../templates/manager.js';
+import { printKeyValue } from '../../ui/table.js';
+import { handleError } from '../../utils/errors.js';
+// ─── Action ─────────────────────────────────────────────────────────────────
+function showAction(name, opts) {
+    const template = loadTemplate(name);
+    if (!template) {
+        throw new Error(`Template "${name}" not found. Run \`convoai template list\` to see available templates.`);
+    }
+    // --raw: output only the properties object as JSON (useful for piping)
+    if (opts.raw) {
+        console.log(JSON.stringify(template.properties, null, 2));
+        return;
+    }
+    // --json: output the full template as JSON
+    if (opts.json) {
+        console.log(JSON.stringify(template, null, 2));
+        return;
+    }
+    // Human-readable detail view
+    console.log();
+    console.log(chalk.bold(`  Template: ${template.name}`));
+    console.log();
+    const pairs = [
+        ['Name', template.name],
+        ['Description', template.description ?? '—'],
+        ['Created', new Date(template.created_at).toLocaleString()],
+        ['Updated', new Date(template.updated_at).toLocaleString()],
+    ];
+    // Agent properties
+    const props = template.properties;
+    if (props.channel) {
+        pairs.push(['Channel', props.channel]);
+    }
+    if (props.llm) {
+        if (props.llm.vendor)
+            pairs.push(['LLM Vendor', props.llm.vendor]);
+        if (props.llm.model)
+            pairs.push(['LLM Model', props.llm.model]);
+        if (props.llm.style)
+            pairs.push(['LLM Style', props.llm.style]);
+        if (props.llm.greeting_message)
+            pairs.push(['Greeting', props.llm.greeting_message]);
+        if (props.llm.system_messages?.length) {
+            const firstMsg = props.llm.system_messages[0];
+            const content = firstMsg.content ?? '';
+            pairs.push(['System Message', content]);
+        }
+        if (props.llm.max_history !== undefined) {
+            pairs.push(['Max History', String(props.llm.max_history)]);
+        }
+        if (props.llm.params?.temperature !== undefined) {
+            pairs.push(['Temperature', String(props.llm.params.temperature)]);
+        }
+        if (props.llm.params?.max_tokens !== undefined) {
+            pairs.push(['Max Tokens', String(props.llm.params.max_tokens)]);
+        }
+    }
+    if (props.tts) {
+        if (props.tts.vendor)
+            pairs.push(['TTS Vendor', props.tts.vendor]);
+        if (props.tts.params?.voice_name)
+            pairs.push(['TTS Voice', props.tts.params.voice_name]);
+        if (props.tts.params?.speed !== undefined)
+            pairs.push(['TTS Speed', String(props.tts.params.speed)]);
+    }
+    if (props.asr) {
+        if (props.asr.vendor)
+            pairs.push(['ASR Vendor', props.asr.vendor]);
+        if (props.asr.language)
+            pairs.push(['ASR Language', props.asr.language]);
+        if (props.asr.params?.model)
+            pairs.push(['ASR Model', props.asr.params.model]);
+    }
+    if (props.idle_timeout !== undefined) {
+        pairs.push(['Idle Timeout', `${props.idle_timeout}s`]);
+    }
+    printKeyValue(pairs);
+    console.log();
+}
+// ─── Command Registration ─────────────────────────────────────────────────
+export function registerTemplateShow(program) {
+    program
+        .command('show <name>')
+        .description('Show full details of a saved template')
+        .option('--json', 'Output as JSON')
+        .option('--raw', 'Output only the properties object as raw JSON (useful for piping)')
+        .action((name, opts) => {
+        try {
+            showAction(name, opts);
+        }
+        catch (error) {
+            handleError(error, { json: opts.json });
+        }
+    });
+}
+//# sourceMappingURL=show.js.map

package/dist/src/commands/template/show.js.map

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

package/dist/src/commands/template/use.d.ts

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

package/dist/src/commands/template/use.js

@@ -0,0 +1,109 @@
+import chalk from 'chalk';
+import { loadTemplate } from '../../templates/manager.js';
+import { getAgentAPI, formatTimestamp } from '../agent/_helpers.js';
+import { resolveConfig } from '../../config/manager.js';
+import { withSpinner } from '../../ui/spinner.js';
+import { printKeyValue } from '../../ui/table.js';
+import { printSuccess, 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}`;
+}
+// ─── Action ─────────────────────────────────────────────────────────────────
+async function useAction(name, opts) {
+    const template = loadTemplate(name);
+    if (!template) {
+        throw new Error(`Template "${name}" not found. Run \`convoai template list\` to see available templates.`);
+    }
+    // Determine channel: CLI flag > template default > interactive prompt
+    let channel = opts.channel ?? template.properties.channel;
+    if (!channel && process.stdin.isTTY) {
+        const { default: inquirer } = await import('inquirer');
+        const answers = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'channel',
+                message: 'Channel name:',
+            },
+        ]);
+        channel = answers.channel;
+    }
+    if (!channel) {
+        throw new Error('--channel is required. Provide it as a flag or run interactively in a TTY.');
+    }
+    // Merge template properties with resolved config
+    const config = resolveConfig(opts.profile);
+    const llm = {
+        ...config.llm,
+        ...template.properties.llm,
+    };
+    const properties = {
+        ...template.properties,
+        channel,
+        agent_rtc_uid: template.properties.agent_rtc_uid ?? 'Agent',
+        remote_rtc_uids: template.properties.remote_rtc_uids ?? ['*'],
+        idle_timeout: template.properties.idle_timeout ?? 30,
+        llm: Object.keys(llm).length > 0 ? llm : undefined,
+    };
+    // Apply TTS: template > config
+    if (template.properties.tts) {
+        properties.tts = template.properties.tts;
+    }
+    else if (config.tts) {
+        properties.tts = config.tts;
+    }
+    // Apply ASR: template > config
+    if (template.properties.asr) {
+        properties.asr = template.properties.asr;
+    }
+    else if (config.asr) {
+        properties.asr = config.asr;
+    }
+    const request = {
+        name: generateAgentName(),
+        properties,
+    };
+    // Dry-run: print the 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 from template "${chalk.bold(name)}"...`, () => api.start(request));
+    if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    printSuccess(`Agent started from template "${name}".`);
+    printKeyValue([
+        ['Agent ID', result.agent_id],
+        ['Status', result.status],
+        ['Channel', channel],
+        ['Template', name],
+        ['Created', formatTimestamp(result.create_ts)],
+    ]);
+    printHint(hintAfterStart(result.agent_id));
+}
+// ─── Command Registration ─────────────────────────────────────────────────
+export function registerTemplateUse(program) {
+    program
+        .command('use <name>')
+        .description('Start an agent using a saved template')
+        .option('-c, --channel <name>', 'RTC channel name')
+        .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 (name, opts) => {
+        try {
+            await useAction(name, opts);
+        }
+        catch (error) {
+            handleError(error, { json: opts.json });
+        }
+    });
+}
+//# sourceMappingURL=use.js.map

package/dist/src/commands/template/use.js.map

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

package/dist/src/commands/token.d.ts

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

package/dist/src/commands/token.js

@@ -0,0 +1,75 @@
+import { loadConfig } from '../config/manager.js';
+import { printSuccess, printError, printHint } from '../ui/output.js';
+import { printKeyValue } from '../ui/table.js';
+import { handleError } from '../utils/errors.js';
+// ─── Command Registration ──────────────────────────────────────────────────
+export function registerToken(program) {
+    program
+        .command('token')
+        .description('Generate an RTC token for agent authentication')
+        .requiredOption('-c, --channel <name>', 'Channel name')
+        .option('--uid <uid>', 'UID for the token (default: 0)', '0')
+        .option('--expire <seconds>', 'Token expiry in seconds (default: 86400)', '86400')
+        .option('--certificate <cert>', 'App Certificate (or set via config/env)')
+        .option('--profile <name>', 'Config profile to use')
+        .option('--json', 'Output as JSON')
+        .action(async (opts) => {
+        try {
+            await tokenAction(opts);
+        }
+        catch (error) {
+            handleError(error, { json: opts.json });
+        }
+    });
+}
+// ─── Action ────────────────────────────────────────────────────────────────
+async function tokenAction(opts) {
+    // Load agora-token dynamically
+    let RtcTokenBuilder;
+    let RtcRole;
+    try {
+        const pkg = await import('agora-token');
+        const mod = pkg.default ?? pkg;
+        RtcTokenBuilder = mod.RtcTokenBuilder;
+        RtcRole = mod.RtcRole;
+    }
+    catch {
+        printError('agora-token package not found. Run: npm install agora-token');
+        process.exit(1);
+    }
+    const config = loadConfig();
+    const appId = config.app_id;
+    const certificate = opts.certificate
+        ?? process.env.AGORA_APP_CERTIFICATE
+        ?? config.app_certificate;
+    if (!appId) {
+        printError('App ID not configured. Run `convoai auth login` first.');
+        process.exit(1);
+    }
+    if (!certificate) {
+        printError('App Certificate is required. Provide via --certificate flag, AGORA_APP_CERTIFICATE env var, or `convoai config set app_certificate <value>`.');
+        process.exit(1);
+    }
+    const uid = parseInt(opts.uid, 10);
+    const expireSeconds = parseInt(opts.expire, 10);
+    const expireTs = Math.floor(Date.now() / 1000) + expireSeconds;
+    const token = RtcTokenBuilder.buildTokenWithUid(appId, certificate, opts.channel, uid, RtcRole.PUBLISHER, expireTs, expireTs);
+    if (opts.json) {
+        console.log(JSON.stringify({
+            token,
+            channel: opts.channel,
+            uid,
+            expires_at: new Date(expireTs * 1000).toISOString(),
+        }, null, 2));
+        return;
+    }
+    printSuccess('Token generated.');
+    printKeyValue([
+        ['Token', token],
+        ['Channel', opts.channel],
+        ['UID', String(uid)],
+        ['Expires', new Date(expireTs * 1000).toLocaleString()],
+    ]);
+    printHint(`Use it: convoai agent start --channel ${opts.channel} --token "${token}"`);
+}
+//# sourceMappingURL=token.js.map

package/dist/src/commands/token.js.map

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

package/dist/src/config/manager.d.ts

@@ -0,0 +1,22 @@
+import type { ConvoAIConfig, ProfileConfig } from '../api/types.js';
+export interface ResolvedProfile extends ProfileConfig {
+    app_id: string;
+    customer_id: string;
+    customer_secret: string;
+}
+/** Load the global config file. Returns an empty config if the file is missing or unreadable. */
+export declare function loadConfig(): ConvoAIConfig;
+/** Persist the config object to disk. */
+export declare function saveConfig(config: ConvoAIConfig): void;
+/** Load a project-local .convoai.json if it exists. Returns null otherwise. */
+export declare function loadProjectConfig(): Partial<ProfileConfig> | null;
+/**
+ * Get the active profile, merging base config fields with the named (or default) profile.
+ * Throws if required credentials (app_id, customer_id, customer_secret) are missing.
+ */
+export declare function getActiveProfile(profileName?: string): ResolvedProfile;
+/**
+ * Fully resolved config: project config > profile config > base config.
+ * Returns a merged ProfileConfig (credentials may still be absent if unconfigured).
+ */
+export declare function resolveConfig(profileName?: string): ProfileConfig;

package/dist/src/config/manager.js

@@ -0,0 +1,130 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { getConfigPath, getProjectConfigPath, getConfigDir } from './paths.js';
+import { validateConfig } from './schema.js';
+// ─── Load / Save ────────────────────────────────────────────────────────────
+/** Load the global config file. Returns an empty config if the file is missing or unreadable. */
+export function loadConfig() {
+    const configPath = getConfigPath();
+    if (!existsSync(configPath)) {
+        return {};
+    }
+    try {
+        const raw = readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return validateConfig(parsed);
+    }
+    catch {
+        return {};
+    }
+}
+/** Persist the config object to disk. */
+export function saveConfig(config) {
+    // Ensure the directory exists before writing
+    getConfigDir();
+    const configPath = getConfigPath();
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', { encoding: 'utf-8', mode: 0o600 });
+}
+// ─── Project Config ─────────────────────────────────────────────────────────
+/** Load a project-local .convoai.json if it exists. Returns null otherwise. */
+export function loadProjectConfig() {
+    const projectPath = getProjectConfigPath();
+    if (!existsSync(projectPath)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(projectPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+// ─── Deep Merge Helper ──────────────────────────────────────────────────────
+function deepMerge(...sources) {
+    const result = {};
+    for (const source of sources) {
+        if (!source)
+            continue;
+        for (const [key, value] of Object.entries(source)) {
+            if (value !== undefined && value !== null) {
+                if (typeof value === 'object' && !Array.isArray(value) && typeof result[key] === 'object' && result[key] !== null && !Array.isArray(result[key])) {
+                    result[key] = deepMerge(result[key], value);
+                }
+                else {
+                    result[key] = value;
+                }
+            }
+        }
+    }
+    return result;
+}
+// ─── Profile Resolution ─────────────────────────────────────────────────────
+/**
+ * Get the active profile, merging base config fields with the named (or default) profile.
+ * Throws if required credentials (app_id, customer_id, customer_secret) are missing.
+ */
+export function getActiveProfile(profileName) {
+    const config = loadConfig();
+    // Environment variables (highest priority after flags)
+    const env = {
+        app_id: process.env.CONVOAI_APP_ID,
+        customer_id: process.env.CONVOAI_CUSTOMER_ID,
+        customer_secret: process.env.CONVOAI_CUSTOMER_SECRET,
+        base_url: process.env.CONVOAI_BASE_URL,
+        region: process.env.CONVOAI_REGION,
+    };
+    // Determine which profile to use
+    const name = profileName ?? config.default_profile;
+    const profile = (name && config.profiles?.[name]) ? config.profiles[name] : {};
+    // Merge: env > profile fields > base config fields
+    const merged = {
+        app_id: env.app_id ?? profile.app_id ?? config.app_id,
+        customer_id: env.customer_id ?? profile.customer_id ?? config.customer_id,
+        customer_secret: env.customer_secret ?? profile.customer_secret ?? config.customer_secret,
+        base_url: env.base_url ?? profile.base_url ?? config.base_url,
+        region: env.region ?? profile.region ?? config.region,
+        llm: profile.llm,
+        tts: profile.tts,
+        asr: profile.asr,
+    };
+    if (!merged.app_id || !merged.customer_id || !merged.customer_secret) {
+        const missing = [];
+        if (!merged.app_id)
+            missing.push('app_id');
+        if (!merged.customer_id)
+            missing.push('customer_id');
+        if (!merged.customer_secret)
+            missing.push('customer_secret');
+        throw new Error(`Missing required credentials: ${missing.join(', ')}. Run "convoai auth login" to configure.`);
+    }
+    return merged;
+}
+/**
+ * Fully resolved config: project config > profile config > base config.
+ * Returns a merged ProfileConfig (credentials may still be absent if unconfigured).
+ */
+export function resolveConfig(profileName) {
+    const config = loadConfig();
+    // Environment variables (highest priority after flags)
+    const env = {
+        app_id: process.env.CONVOAI_APP_ID,
+        customer_id: process.env.CONVOAI_CUSTOMER_ID,
+        customer_secret: process.env.CONVOAI_CUSTOMER_SECRET,
+        base_url: process.env.CONVOAI_BASE_URL,
+        region: process.env.CONVOAI_REGION,
+    };
+    const name = profileName ?? config.default_profile;
+    const profile = (name && config.profiles?.[name]) ? config.profiles[name] : {};
+    const project = loadProjectConfig();
+    return {
+        app_id: env.app_id ?? project?.app_id ?? profile.app_id ?? config.app_id,
+        customer_id: env.customer_id ?? project?.customer_id ?? profile.customer_id ?? config.customer_id,
+        customer_secret: env.customer_secret ?? project?.customer_secret ?? profile.customer_secret ?? config.customer_secret,
+        base_url: env.base_url ?? project?.base_url ?? profile.base_url ?? config.base_url,
+        region: env.region ?? project?.region ?? profile.region ?? config.region,
+        llm: deepMerge(profile.llm, project?.llm),
+        tts: deepMerge(profile.tts, project?.tts),
+        asr: deepMerge(profile.asr, project?.asr),
+    };
+}
+//# sourceMappingURL=manager.js.map

package/dist/src/config/manager.js.map

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

package/dist/src/config/paths.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns the config directory, respecting XDG_CONFIG_HOME.
+ * Creates the directory if it does not exist.
+ */
+export declare function getConfigDir(): string;
+/** Returns the full path to the global config file. */
+export declare function getConfigPath(): string;
+/** Returns the full path to a project-local config file in the CWD. */
+export declare function getProjectConfigPath(): string;

package/dist/src/config/paths.js

@@ -0,0 +1,28 @@
+import { mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+// ─── Constants ──────────────────────────────────────────────────────────────
+const CONFIG_DIR_NAME = 'convoai';
+const CONFIG_FILE_NAME = 'config.json';
+const PROJECT_CONFIG_NAME = '.convoai.json';
+// ─── XDG-Compliant Config Paths ────────────────────────────────────────────
+/**
+ * Returns the config directory, respecting XDG_CONFIG_HOME.
+ * Creates the directory if it does not exist.
+ */
+export function getConfigDir() {
+    const xdgHome = process.env.XDG_CONFIG_HOME;
+    const base = xdgHome || join(homedir(), '.config');
+    const dir = join(base, CONFIG_DIR_NAME);
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    return dir;
+}
+/** Returns the full path to the global config file. */
+export function getConfigPath() {
+    return join(getConfigDir(), CONFIG_FILE_NAME);
+}
+/** Returns the full path to a project-local config file in the CWD. */
+export function getProjectConfigPath() {
+    return resolve(process.cwd(), PROJECT_CONFIG_NAME);
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/config/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,+EAA+E;AAE/E,MAAM,eAAe,GAAG,SAAS,CAAC;AAClC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AACvC,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAE5C,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC5C,MAAM,IAAI,GAAG,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAExC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,gBAAgB,CAAC,CAAC;AAChD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,mBAAmB,CAAC,CAAC;AACrD,CAAC"}