plazbot-cli 0.4.0 → 0.5.0

package/dist/commands/agent/templates.js

@@ -3,8 +3,10 @@ import inquirer from 'inquirer';
 import { Agent } from 'plazbot';
 import { getStoredCredentials } from '../../utils/credentials.js';
 import { logger } from '../../utils/logger.js';
-import { addExamples } from '../../utils/help.js';
+import { addExamples, addNotes } from '../../utils/help.js';
 import { theme, section, kvPair, createTable, createSpinner } from '../../utils/ui.js';
+import { jsonOption, isJsonMode, printJson, fail, CliError } from '../../utils/output.js';
+import { addYesOption, confirmAction } from '../../utils/confirm.js';
 import { connectChannelFlow } from './wizard.js';
 // Plantilla: Clinica
 const plantillaClinica = {
@@ -572,60 +574,70 @@ const plantillaVentas = {
     "customAIConfig": true,
     "aiProviders": [{ "provider": "openai", "model": "gpt-4o", "apiToken": "", "temperature": 0.7, "maxTokens": 500, "isDefault": true }]
 };
-// Registro de plantillas con sus placeholders
+const FIELD_FLAGS = {
+    business: '--business <name>',
+    address: '--address <text>',
+    contactPhone: '--contact-phone <number>',
+    supportEmail: '--support-email <email>',
+};
 const TEMPLATES = [
     {
+        id: 'sales',
         name: 'Sales Assistant',
-        description: 'Agent for sales management, quotes and orders',
+        description: 'Sales management, quotes and orders',
         industry: 'Sales',
         placeholders: [
-            { key: '[NOMBRE DE LA EMPRESA]', label: 'Your company name' },
-            { key: '[DIRECCION COMPLETA]', label: 'Your company address' },
-            { key: '[NUMERO DE TELEFONO]', label: 'Contact phone' },
+            { key: '[NOMBRE DE LA EMPRESA]', label: 'Company name', field: 'business' },
+            { key: '[DIRECCION COMPLETA]', label: 'Company address', field: 'address' },
+            { key: '[NUMERO DE TELEFONO]', label: 'Contact phone', field: 'contactPhone' },
         ],
         config: plantillaVentas,
     },
     {
+        id: 'it-support',
         name: 'IT Technical Support',
-        description: 'Agent for technical support, tickets and problem resolution',
+        description: 'Technical support, tickets and troubleshooting',
         industry: 'Technology',
         placeholders: [
-            { key: '[NOMBRE DE LA EMPRESA]', label: 'Your company name' },
-            { key: '[NUMERO DE TELEFONO]', label: 'Support phone' },
-            { key: '[EMAIL DE SOPORTE]', label: 'Support email (e.g. support@company.com)' },
+            { key: '[NOMBRE DE LA EMPRESA]', label: 'Company name', field: 'business' },
+            { key: '[NUMERO DE TELEFONO]', label: 'Support phone', field: 'contactPhone' },
+            { key: '[EMAIL DE SOPORTE]', label: 'Support email (e.g. support@company.com)', field: 'supportEmail' },
         ],
         config: plantillaSoporteIT,
     },
     {
+        id: 'clinic',
         name: 'Clinic Assistant',
-        description: 'Agent for clinics: medical appointments, schedules and specialties',
+        description: 'Medical appointments, schedules and specialties',
         industry: 'Health',
         placeholders: [
-            { key: '[NOMBRE DE LA CLINICA]', label: 'Your clinic name' },
-            { key: '[DIRECCION COMPLETA]', label: 'Clinic address' },
-            { key: '[NUMERO DE TELEFONO]', label: 'Clinic phone' },
+            { key: '[NOMBRE DE LA CLINICA]', label: 'Clinic name', field: 'business' },
+            { key: '[DIRECCION COMPLETA]', label: 'Clinic address', field: 'address' },
+            { key: '[NUMERO DE TELEFONO]', label: 'Clinic phone', field: 'contactPhone' },
         ],
         config: plantillaClinica,
     },
     {
+        id: 'restaurant',
         name: 'Restaurant Assistant',
-        description: 'Agent for restaurants: reservations, menu and delivery',
-        industry: 'Gastronomy',
+        description: 'Reservations, menu and delivery',
+        industry: 'Food & beverage',
         placeholders: [
-            { key: '[NOMBRE DEL RESTAURANTE]', label: 'Your restaurant name' },
-            { key: '[DIRECCION COMPLETA]', label: 'Restaurant address' },
-            { key: '[NUMERO DE TELEFONO]', label: 'Restaurant phone' },
+            { key: '[NOMBRE DEL RESTAURANTE]', label: 'Restaurant name', field: 'business' },
+            { key: '[DIRECCION COMPLETA]', label: 'Restaurant address', field: 'address' },
+            { key: '[NUMERO DE TELEFONO]', label: 'Restaurant phone', field: 'contactPhone' },
         ],
         config: plantillaRestaurante,
     },
     {
+        id: 'real-estate',
         name: 'Real Estate Assistant',
-        description: 'Agent for real estate: properties, viewings and advisory',
-        industry: 'Real Estate',
+        description: 'Properties, viewings and advisory',
+        industry: 'Real estate',
         placeholders: [
-            { key: '[NOMBRE DE LA INMOBILIARIA]', label: 'Your real estate name' },
-            { key: '[DIRECCION COMPLETA]', label: 'Office address' },
-            { key: '[NUMERO DE TELEFONO]', label: 'Contact phone' },
+            { key: '[NOMBRE DE LA INMOBILIARIA]', label: 'Agency name', field: 'business' },
+            { key: '[DIRECCION COMPLETA]', label: 'Office address', field: 'address' },
+            { key: '[NUMERO DE TELEFONO]', label: 'Contact phone', field: 'contactPhone' },
         ],
         config: plantillaInmobiliario,
     },
@@ -653,191 +665,282 @@ function replacePlaceholders(obj, replacements) {
     }
     return obj;
 }
+/** Accepts a template id ("clinic"), its list number ("3") or its name ("Clinic Assistant"). */
+function findTemplate(value) {
+    const v = value.trim().toLowerCase();
+    const byIndex = /^\d+$/.test(v) ? TEMPLATES[Number(v) - 1] : undefined;
+    const found = byIndex || TEMPLATES.find(t => t.id === v || t.name.toLowerCase() === v);
+    if (!found) {
+        throw new CliError(`Unknown template "${value}".`, 'invalid_template', `Available: ${TEMPLATES.map(t => t.id).join(', ')}. See them with: plazbot agent templates --list`);
+    }
+    return found;
+}
+function templateAsJson(t) {
+    return {
+        id: t.id,
+        name: t.name,
+        industry: t.industry,
+        description: t.description,
+        persona: `${t.config.person?.name} - ${t.config.person?.role}`,
+        actions: (t.config.actions || []).length,
+        fields: t.placeholders.map(p => ({ flag: FIELD_FLAGS[p.field].split(' ')[0], label: p.label })),
+    };
+}
+function printTemplateTable() {
+    console.log(section('Agent templates'));
+    console.log(createTable(['#', 'ID', 'Name', 'Industry', 'Description'], TEMPLATES.map((t, i) => [String(i + 1), t.id, t.name, t.industry, t.description])));
+}
 export const templatesCommand = new Command('templates')
-    .description('Create an agent from pre-configured templates')
-    .option('--dev', 'Use development environment', false)
-    .option('--json', 'Only show the resulting JSON without creating the agent', false)
-    .action(async (options) => {
+    .description('Create an agent from a ready-made template (sales, support, clinic, restaurant, real estate)')
+    .option('--list', 'List the available templates and exit')
+    .option('-t, --template <id>', `Template to use: ${TEMPLATES.map(t => t.id).join(', ')} (or its number)`)
+    .option('--name <name>', 'Agent name (default: the template name)')
+    .option('--business <name>', 'Business name used in the template prompt')
+    .option('--address <text>', 'Business address (templates that use it)')
+    .option('--contact-phone <number>', 'Business phone shown to customers (templates that use it)')
+    .option('--support-email <email>', 'Support email (it-support template)')
+    .option('--timezone <iana>', 'IANA timezone, e.g. America/Lima (default: America/Lima)')
+    .option('--api-token <key>', 'OpenAI API key for the agent (templates use OpenAI gpt-4o)')
+    .option('--skip-channels', 'Do not offer to connect channels')
+    .addOption(jsonOption('Print the resulting agent config as JSON without creating it (no API calls); with --list, print templates as JSON'))
+    .option('--dev', 'Use development environment', false);
+addYesOption(templatesCommand);
+templatesCommand.action(async (options) => {
     try {
-        console.log(section('Agent templates'));
-        console.log(theme.muted('  Create a pre-configured agent in seconds\n'));
-        const rows = TEMPLATES.map((t, i) => [
-            String(i + 1),
-            t.name,
-            t.industry,
-            t.description,
-        ]);
-        console.log(createTable(['#', 'Name', 'Industry', 'Description'], rows));
-        // Paso 1: Seleccionar plantilla
-        const { selected } = await inquirer.prompt([{
-                type: 'list',
-                name: 'selected',
-                message: 'Select a template:',
-                choices: [
-                    ...TEMPLATES.map((t, i) => ({ name: `${t.name} (${t.industry})`, value: i })),
-                    { name: 'Cancel', value: -1 },
-                ],
-            }]);
-        if (selected === -1)
+        const json = isJsonMode();
+        const interactive = !!process.stdin.isTTY && !json;
+        // --list
+        if (options.list) {
+            if (json)
+                printJson(TEMPLATES.map(templateAsJson));
+            else {
+                printTemplateTable();
+                console.log(theme.muted('\n  Use one with: plazbot agent templates --template <id>\n'));
+            }
             return;
-        const template = TEMPLATES[selected];
-        console.log(section(`${template.name}`));
-        console.log(kvPair('Industry', template.industry));
-        console.log(kvPair('Persona', `${template.config.person.name} - ${template.config.person.role}`));
-        console.log(kvPair('Actions', String(template.config.actions.length)));
-        console.log(kvPair('Tool Calling', 'Enabled'));
-        console.log();
-        // Paso 2: Personalizar placeholders
-        console.log(theme.bold('\n  Quick customization'));
-        console.log(theme.muted('  Fill in your business details:\n'));
+        }
+        // 1. Template
+        let template;
+        if (options.template) {
+            template = findTemplate(options.template);
+        }
+        else {
+            if (!interactive) {
+                throw new CliError('A template is required when running without prompts.', 'missing_template', `Pass it with --template <id> (${TEMPLATES.map(t => t.id).join(', ')}). See plazbot agent templates --list.`);
+            }
+            printTemplateTable();
+            const { selected } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'selected',
+                    message: 'Select a template:',
+                    choices: [
+                        ...TEMPLATES.map((t, i) => ({ name: `${t.name} ${theme.muted(`(${t.industry})`)}`, value: i })),
+                        new inquirer.Separator(),
+                        { name: 'Cancel', value: -1 },
+                    ],
+                }]);
+            if (selected === -1) {
+                logger.dim('Aborted.');
+                process.exit(1);
+            }
+            template = TEMPLATES[selected];
+        }
+        if (!json) {
+            console.log(section(template.name));
+            console.log(kvPair('Industry', template.industry));
+            console.log(kvPair('Persona', `${template.config.person.name} - ${template.config.person.role}`));
+            console.log(kvPair('Actions', String(template.config.actions.length)));
+            console.log(kvPair('Tool Calling', 'Enabled'));
+            console.log();
+        }
+        // 2. Placeholders: flags first, then prompts (interactive), else error / keep as is (--json)
         const placeholderAnswers = {};
+        const missing = [];
+        let headerShown = false;
         for (const ph of template.placeholders) {
-            const { value } = await inquirer.prompt([{
-                    type: 'input',
-                    name: 'value',
-                    message: `${ph.label}:`,
-                    validate: (v) => v.trim().length > 0 || 'This field is required',
-                }]);
-            placeholderAnswers[ph.key] = value.trim();
+            const fromFlag = (options[ph.field] || '').trim();
+            if (fromFlag) {
+                placeholderAnswers[ph.key] = fromFlag;
+                continue;
+            }
+            if (interactive) {
+                if (!headerShown) {
+                    console.log(theme.bold('  Your business details'));
+                    headerShown = true;
+                }
+                const { value } = await inquirer.prompt([{
+                        type: 'input',
+                        name: 'value',
+                        message: `${ph.label}:`,
+                        validate: (v) => v.trim().length > 0 || 'This field is required',
+                    }]);
+                placeholderAnswers[ph.key] = value.trim();
+            }
+            else {
+                missing.push(ph);
+            }
+        }
+        if (missing.length > 0) {
+            const flags = missing.map(p => FIELD_FLAGS[p.field]).join(', ');
+            if (!json) {
+                throw new CliError(`Missing business details for the "${template.id}" template.`, 'missing_fields', `Pass ${flags}.`);
+            }
+            logger.warning(`Placeholders left unfilled: ${missing.map(p => p.key).join(', ')}. Pass ${flags} to fill them.`);
+        }
+        // 3. Build the config (no API calls)
+        const finalConfig = replacePlaceholders(JSON.parse(JSON.stringify(template.config)), placeholderAnswers);
+        if (options.name?.trim()) {
+            finalConfig.name = options.name.trim();
+        }
+        finalConfig.channels = [];
+        // --json: print the config and stop. Never prompt, never call the API.
+        if (json) {
+            if (options.timezone)
+                finalConfig.timezone = options.timezone.trim();
+            if (options.apiToken) {
+                logger.warning('The API token is not included in the JSON output. Set it after creating the agent: plazbot agent ai-config <agentId> --api-token <key>');
+            }
+            printJson(finalConfig);
+            return;
         }
-        // Paso 3: Canales (WhatsApp, Messenger, Instagram, Telegram)
-        console.log(theme.bold('\n  Channel connection'));
-        const { wantChannels } = await inquirer.prompt([{
-                type: 'confirm',
-                name: 'wantChannels',
-                message: 'Connect channels (WhatsApp, Messenger, Instagram, Telegram)?',
-                default: true,
-            }]);
         const credentials = await getStoredCredentials();
+        // 4. Channels (interactive only)
         let connectedChannels = [];
-        if (wantChannels) {
-            const wizardCtx = {
-                zone: credentials.zone,
-                workspaceId: credentials.workspace,
-                apiKey: credentials.apiKey,
-                dev: !!options.dev,
-            };
-            connectedChannels = await connectChannelFlow(wizardCtx);
-        }
-        // Paso 4: API Key de OpenAI
-        console.log(theme.bold('\n  AI configuration'));
-        const { configureApiKey } = await inquirer.prompt([{
-                type: 'confirm',
-                name: 'configureApiKey',
-                message: 'Configure your OpenAI API Key now? (required for the agent to work)',
-                default: true,
-            }]);
-        let apiToken = '';
-        if (configureApiKey) {
-            const { key } = await inquirer.prompt([{
-                    type: 'password',
-                    name: 'key',
-                    message: 'OpenAI API Key (sk-...):',
-                    mask: '*',
-                    validate: (v) => v.trim().length > 0 || 'The API Key is required',
+        if (interactive && !options.skipChannels) {
+            console.log(theme.bold('\n  Channels'));
+            const { wantChannels } = await inquirer.prompt([{
+                    type: 'confirm',
+                    name: 'wantChannels',
+                    message: 'Connect a channel now (WhatsApp, Messenger, Instagram, Telegram)?',
+                    default: true,
                 }]);
-            apiToken = key.trim();
+            if (wantChannels) {
+                const wizardCtx = {
+                    zone: credentials.zone,
+                    workspaceId: credentials.workspace,
+                    apiKey: credentials.apiKey,
+                    dev: !!options.dev,
+                };
+                connectedChannels = await connectChannelFlow(wizardCtx);
+            }
         }
-        // Paso 5: Zona horaria
-        const { timezone } = await inquirer.prompt([{
-                type: 'input',
-                name: 'timezone',
-                message: 'Timezone (e.g. America/Lima, America/Bogota, America/Mexico_City):',
-                default: template.config.timezone,
-            }]);
-        // Construir config final
-        const configClone = JSON.parse(JSON.stringify(template.config));
-        const finalConfig = replacePlaceholders(configClone, placeholderAnswers);
-        finalConfig.timezone = timezone;
-        if (connectedChannels.length > 0) {
-            finalConfig.channels = connectedChannels;
+        // 5. OpenAI API key
+        let apiToken = (options.apiToken || '').trim();
+        if (!apiToken && interactive) {
+            console.log(theme.bold('\n  AI configuration'));
+            const { configureApiKey } = await inquirer.prompt([{
+                    type: 'confirm',
+                    name: 'configureApiKey',
+                    message: 'Add your OpenAI API key now? (the agent needs it to reply)',
+                    default: true,
+                }]);
+            if (configureApiKey) {
+                const { key } = await inquirer.prompt([{
+                        type: 'password',
+                        name: 'key',
+                        message: 'OpenAI API key (sk-...):',
+                        mask: '*',
+                        validate: (v) => v.trim().length > 0 || 'The API key is required',
+                    }]);
+                apiToken = key.trim();
+            }
         }
-        else {
-            finalConfig.channels = [];
+        // 6. Timezone
+        let timezone = (options.timezone || '').trim() || template.config.timezone;
+        if (!options.timezone && interactive) {
+            ({ timezone } = await inquirer.prompt([{
+                    type: 'input',
+                    name: 'timezone',
+                    message: 'Timezone (e.g. America/Lima, America/Bogota, Europe/Madrid):',
+                    default: template.config.timezone,
+                }]));
         }
+        finalConfig.timezone = timezone;
+        finalConfig.channels = connectedChannels;
+        finalConfig.zone = credentials.zone;
         if (apiToken && finalConfig.aiProviders && finalConfig.aiProviders.length > 0) {
             finalConfig.aiProviders[0].apiToken = apiToken;
         }
-        // Si es --json, solo mostrar y salir
-        if (options.json) {
-            console.log(section('Configuration JSON'));
-            logger.json(finalConfig);
-            return;
-        }
-        // Paso 6: Confirmacion
+        // 7. Summary + confirmation
         console.log(section('Summary'));
-        console.log(kvPair('Template', template.name));
+        console.log(kvPair('Template', `${template.name} (${template.id})`));
+        console.log(kvPair('Agent name', finalConfig.name));
         for (const ph of template.placeholders) {
             console.log(kvPair(ph.label, placeholderAnswers[ph.key]));
         }
-        console.log(kvPair('Channels', connectedChannels.length > 0 ? connectedChannels.map(c => `${c.channel} (${c.key})`).join(', ') : 'Not configured'));
-        console.log(kvPair('OpenAI API Key', apiToken ? 'Configured' : 'Not configured (the agent will not work without it)'));
+        console.log(kvPair('Channels', connectedChannels.length > 0 ? connectedChannels.map(c => `${c.channel} (${c.key})`).join(', ') : 'Not connected'));
+        console.log(kvPair('OpenAI API key', apiToken ? 'Set' : theme.warning('Not set (the agent will not reply without it)')));
         console.log(kvPair('Timezone', timezone));
         console.log(kvPair('Actions', String(finalConfig.actions.length)));
         console.log(kvPair('AI', `${finalConfig.aiProviders[0].provider} / ${finalConfig.aiProviders[0].model}`));
         console.log();
-        const { confirm } = await inquirer.prompt([{
-                type: 'confirm',
-                name: 'confirm',
-                message: 'Create the agent with this configuration?',
-                default: true,
-            }]);
-        if (!confirm) {
-            logger.warning('Creation cancelled');
-            return;
+        const ok = await confirmAction('Create the agent with this configuration?', options);
+        if (!ok) {
+            logger.dim('Aborted.');
+            process.exit(1);
         }
-        // Paso 7: Crear agente
+        // 8. Create
         const agent = new Agent({
             workspaceId: credentials.workspace,
             apiKey: credentials.apiKey,
             zone: credentials.zone,
             ...(options.dev && { customUrl: "http://localhost:5090" })
         });
-        finalConfig.zone = credentials.zone;
         const spinner = createSpinner('Creating agent...');
         spinner.start();
-        const result = await agent.addAgent(finalConfig);
-        spinner.succeed('Agent created successfully');
+        let result;
+        try {
+            result = await agent.addAgent(finalConfig);
+        }
+        catch (err) {
+            spinner.stop();
+            throw err;
+        }
+        spinner.succeed('Agent created');
+        const agentId = result.agentId || '<agentId>';
         logger.title('Agent details');
-        if (result.agentId) {
+        if (result.agentId)
             logger.label('ID', result.agentId);
-        }
         logger.label('Name', finalConfig.name);
-        logger.label('Industry', template.industry);
+        logger.label('Template', template.name);
         if (connectedChannels.length > 0) {
             logger.label('Channels', connectedChannels.map(c => `${c.channel} (${c.key})`).join(', '));
         }
         logger.label('Actions', String(finalConfig.actions.length));
         console.log();
         console.log(section('Next steps'));
-        if (connectedChannels.length === 0) {
-            console.log(theme.bold('  1.') + ' Connect channels from: ' + theme.success('plazbot agent chat -a <agentId>'));
-            console.log(theme.bold('  2.') + ' Or connect from the platform in Settings > Integrations');
+        let step = 1;
+        if (!apiToken) {
+            console.log(theme.bold(`  ${step++}.`) + ' Add your OpenAI API key (required): ' + theme.success(`plazbot agent ai-config ${agentId} --provider openai --api-token <key>`));
         }
-        else {
-            console.log(theme.bold('  1.') + ' Your agent already has channels connected and enabled');
+        console.log(theme.bold(`  ${step++}.`) + ' Test the agent: ' + theme.success(`plazbot agent chat ${agentId}`));
+        if (connectedChannels.length === 0) {
+            console.log(theme.bold(`  ${step++}.`) + ' Connect a WhatsApp number: ' + theme.success(`plazbot whatsapp assign -p <phone> -a ${agentId}`));
         }
-        console.log(theme.bold(`  ${connectedChannels.length === 0 ? '3' : '2'}.`) + ' Add your OpenAI API Key if you have not yet');
         console.log();
         if (!apiToken) {
-            logger.warning('Remember to configure your OpenAI API Key for the agent to work:');
-            logger.dim(`plazbot agent ai-config ${result.agentId || '<agentId>'}`);
-            console.log();
+            logger.warning('The agent will not reply until an OpenAI API key is configured.');
         }
-        logger.dim('Test agent: plazbot agent chat -a ' + (result.agentId || '<agentId>'));
         if (options.dev) {
             logger.warning('Environment: development');
         }
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        logger.error(message);
-        process.exit(1);
+        fail(error);
     }
 });
 addExamples(templatesCommand, [
-    { description: 'Pick a template and create the agent interactively',
+    { description: 'Pick a template and create the agent step by step',
         command: 'plazbot agent templates' },
-    { description: 'Preview the resulting JSON without creating the agent',
-        command: 'plazbot agent templates --json' },
+    { description: 'List the available templates as JSON',
+        command: 'plazbot agent templates --list --json' },
+    { description: 'Create a clinic agent without prompts',
+        command: 'plazbot agent templates -t clinic --name "Clinic Bot" --business "Clinica Sol" --address "Av. Arequipa 123, Lima" --contact-phone "+51 1 234 5678" --api-token sk-xxx --yes' },
+    { description: 'Preview the resulting config (no API calls) and save it for agent create',
+        command: 'plazbot agent templates -t sales --business "Acme" --address "Calle 1" --contact-phone "+51912345678" --json > agent.json' },
+]);
+addNotes(templatesCommand, [
+    'Templates are written in Spanish and use OpenAI (gpt-4o): the agent needs an OpenAI API key to reply.',
+    'Without a terminal (CI, pipes) pass --template, the business flags and --yes. Channels are only offered interactively.',
+    '--json never calls the API and leaves the API token out of the output.',
 ]);