plazbot-cli 0.2.26 → 0.3.2

package/src/commands/agent/chat.ts

@@ -1,30 +1,31 @@
 import { Command } from 'commander';
 import { Agent } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { AgentCommandOptions, AgentResponse, AgentSource } from '../../types/agent';
-import { theme, section } from '../../utils/ui';
+import { getStoredCredentials } from '../../utils/credentials.js';
+import { logger } from '../../utils/logger.js';
+import { addExamples } from '../../utils/help.js';
+import { describeAgentLoadError } from '../../utils/agent-errors.js';
+import { AgentCommandOptions, AgentResponse, AgentSource } from '../../types/agent.js';
+import { theme, section } from '../../utils/ui.js';
 import crypto from 'crypto';
 import readline from 'readline';
 import chalk from 'chalk';
 
 const COMMANDS_HELP = `
-  ${chalk.bold('Comandos disponibles:')}
-  ${chalk.hex('#4CAF50')('/exit')}      Terminar conversacion
-  ${chalk.hex('#4CAF50')('/clear')}     Limpiar pantalla
-  ${chalk.hex('#4CAF50')('/info')}      Informacion de la sesion
-  ${chalk.hex('#4CAF50')('/sources')}   Mostrar/ocultar fuentes
-  ${chalk.hex('#4CAF50')('/help')}      Mostrar estos comandos
+  ${chalk.bold('Available commands:')}
+  ${chalk.hex('#4CAF50')('/exit')}      End conversation
+  ${chalk.hex('#4CAF50')('/clear')}     Clear screen
+  ${chalk.hex('#4CAF50')('/info')}      Session information
+  ${chalk.hex('#4CAF50')('/sources')}   Toggle sources
+  ${chalk.hex('#4CAF50')('/help')}      Show these commands
 `;
 
 export const chatCommand = new Command('chat')
-  .description('Inicia una sesion de chat interactiva con un agente')
-  .requiredOption('-a, --agent-id <id>', 'ID del agente')
-  .option('-s, --session-id <id>', 'ID de sesion (opcional)')
-  .option('-m, --multiple-answers', 'Permitir multiples respuestas', false)
-  .option('--dev', 'Usar ambiente de desarrollo', false)
-  .action(async (options: AgentCommandOptions & {
-    agentId: string;
+  .description('Start an interactive chat session with an agent')
+  .argument('<agentId>', 'Agent ID')
+  .option('-s, --session-id <id>', 'Session ID (optional)')
+  .option('-m, --multiple-answers', 'Allow multiple answers', false)
+  .option('--dev', 'Use development environment', false)
+  .action(async (agentId: string, options: AgentCommandOptions & {
     sessionId?: string;
     multipleAnswers?: boolean;
   }) => {
@@ -44,12 +45,14 @@ export const chatCommand = new Command('chat')
       // Cargar info del agente
       let agentInfo: any = null;
       try {
-        process.stdout.write(chalk.gray('  Conectando con agente...'));
-        const _res: any = await agent.getAgentById({ id: options.agentId });
+        process.stdout.write(chalk.gray('  Connecting to agent...'));
+        const _res: any = await agent.getAgentById({ id: agentId });
         agentInfo = _res.agent || _res.data || _res;
         process.stdout.write('\r' + ' '.repeat(40) + '\r');
-      } catch {
+      } catch (loadErr) {
         process.stdout.write('\r' + ' '.repeat(40) + '\r');
+        logger.error(describeAgentLoadError(loadErr, agentId, credentials, { dev: options.dev }));
+        process.exit(1);
       }
 
       const rl = readline.createInterface({
@@ -59,27 +62,27 @@ export const chatCommand = new Command('chat')
 
       // Pantalla de chat
       console.clear();
-      const agentName = agentInfo?.name || 'Agente';
+      const agentName = agentInfo?.name || 'Agent';
       const toolCalling = agentInfo?.useToolCalling ? chalk.hex('#4CAF50')(' [Tool Calling]') : '';
 
       console.log();
       console.log(chalk.hex('#4CAF50')('  ┌' + '─'.repeat(58) + '┐'));
       console.log(chalk.hex('#4CAF50')('  │') + chalk.bold(`  ${agentName}${toolCalling}`).padEnd(68) + chalk.hex('#4CAF50')('│'));
       console.log(chalk.hex('#4CAF50')('  │') + chalk.gray(`  Session: ${sessionId.substring(0, 8)}...`).padEnd(68) + chalk.hex('#4CAF50')('│'));
-      console.log(chalk.hex('#4CAF50')('  │') + chalk.gray('  /help para ver comandos').padEnd(68) + chalk.hex('#4CAF50')('│'));
+      console.log(chalk.hex('#4CAF50')('  │') + chalk.gray('  /help to see commands').padEnd(68) + chalk.hex('#4CAF50')('│'));
       console.log(chalk.hex('#4CAF50')('  └' + '─'.repeat(58) + '┘'));
       console.log();
 
       // Saludo del agente
       if (agentInfo?.instructions?.greeting) {
-        const timestamp = new Date().toLocaleTimeString('es-ES', { hour: '2-digit', minute: '2-digit' });
+        const timestamp = new Date().toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit' });
         console.log(chalk.hex('#4CAF50')(`  ${agentName}`) + chalk.gray(` ${timestamp}`));
         console.log(chalk.white(`  ${agentInfo.instructions.greeting}`));
         console.log();
       }
 
       const askQuestion = () => {
-        rl.question(chalk.hex('#2196F3')('  Tu > '), async (question) => {
+        rl.question(chalk.hex('#2196F3')('  You > '), async (question) => {
           if (!question.trim()) {
             askQuestion();
             return;
@@ -87,7 +90,7 @@ export const chatCommand = new Command('chat')
 
           // Comandos especiales
           if (question.toLowerCase() === '/exit') {
-            console.log(chalk.gray('\n  Sesion terminada.\n'));
+            console.log(chalk.gray('\n  Session ended.\n'));
             rl.close();
             return;
           }
@@ -105,11 +108,11 @@ export const chatCommand = new Command('chat')
           }
 
           if (question.toLowerCase() === '/info') {
-            console.log(section('Informacion de sesion'));
-            logger.label('Agent ID', options.agentId);
+            console.log(section('Session information'));
+            logger.label('Agent ID', agentId);
             logger.label('Session ID', sessionId);
-            logger.label('Agente', agentName);
-            logger.label('Tool Calling', agentInfo?.useToolCalling ? 'Activado' : 'Desactivado');
+            logger.label('Agent', agentName);
+            logger.label('Tool Calling', agentInfo?.useToolCalling ? 'Enabled' : 'Disabled');
             logger.label('AI Provider', agentInfo?.customAIConfig ? (agentInfo.aiProviders?.[0]?.provider || 'Custom') : 'Default');
             console.log();
             askQuestion();
@@ -118,23 +121,23 @@ export const chatCommand = new Command('chat')
 
           if (question.toLowerCase() === '/sources') {
             showSources = !showSources;
-            console.log(chalk.gray(`  Fuentes: ${showSources ? 'activadas' : 'desactivadas'}`));
+            console.log(chalk.gray(`  Sources: ${showSources ? 'on' : 'off'}`));
             console.log();
             askQuestion();
             return;
           }
 
           try {
-            process.stdout.write(chalk.gray('  ...pensando\n'));
+            process.stdout.write(chalk.gray('  ...thinking\n'));
 
             const response = await agent.onMessage({
-              agentId: options.agentId,
+              agentId: agentId,
               question,
               sessionId,
               multipleAnswers: options.multipleAnswers
             }) as AgentResponse & { actionsExecuted?: any[] };
 
-            const timestamp = new Date().toLocaleTimeString('es-ES', { hour: '2-digit', minute: '2-digit' });
+            const timestamp = new Date().toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit' });
 
             // Mostrar tool calls si hay
             if (response.actionsExecuted && response.actionsExecuted.length > 0) {
@@ -154,9 +157,9 @@ export const chatCommand = new Command('chat')
 
             // Fuentes
             if (showSources && response.sources && response.sources.length > 0) {
-              console.log(chalk.gray('  Fuentes:'));
+              console.log(chalk.gray('  Sources:'));
               response.sources.forEach((source: AgentSource) => {
-                console.log(chalk.gray(`    - ${source.title || 'Sin titulo'}`));
+                console.log(chalk.gray(`    - ${source.title || 'Untitled'}`));
                 if (source.url) console.log(chalk.gray(`      ${source.url}`));
               });
               console.log();
@@ -164,7 +167,7 @@ export const chatCommand = new Command('chat')
 
             askQuestion();
           } catch (error) {
-            const message = error instanceof Error ? error.message : 'Error desconocido';
+            const message = error instanceof Error ? error.message : 'Unknown error';
             console.log(chalk.hex('#EF5350')(`\n  ✖ Error: ${message}\n`));
             askQuestion();
           }
@@ -174,12 +177,21 @@ export const chatCommand = new Command('chat')
       askQuestion();
 
     } catch (error) {
-      const message = error instanceof Error ? error.message : 'Error desconocido';
+      const message = error instanceof Error ? error.message : 'Unknown error';
       logger.error(message);
       process.exit(1);
     }
   });
 
+addExamples(chatCommand, [
+  { description: 'Open an interactive chat with the agent',
+    command: 'plazbot agent chat agt_AbcDef123' },
+  { description: 'Reuse a previous session ID to continue the conversation',
+    command: 'plazbot agent chat agt_AbcDef123 -s sess_AbcDef123' },
+  { description: 'Allow the agent to send multiple answers per turn',
+    command: 'plazbot agent chat agt_AbcDef123 -m' },
+]);
+
 function formatResponse(text: string): string {
   if (!text) return '';
 

package/src/commands/agent/copy.ts

@@ -1,14 +1,15 @@
 import { Command } from 'commander';
 import { Agent } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { createSpinner } from '../../utils/ui';
-import { AgentCommandOptions } from '../../types/agent';
+import { getStoredCredentials } from '../../utils/credentials.js';
+import { logger } from '../../utils/logger.js';
+import { addExamples } from '../../utils/help.js';
+import { createSpinner } from '../../utils/ui.js';
+import { AgentCommandOptions } from '../../types/agent.js';
 
 export const copyCommand = new Command('copy')
-  .description('Clonar un agente existente')
-  .argument('<agentId>', 'ID del agente a clonar')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .description('Clone an existing agent')
+  .argument('<agentId>', 'Agent ID to clone')
+  .option('--dev', 'Use development environment', false)
   .action(async (agentId: string, options: AgentCommandOptions) => {
     try {
       const credentials = await getStoredCredentials();
@@ -19,22 +20,27 @@ export const copyCommand = new Command('copy')
         ...(options.dev && { customUrl: "http://localhost:5090" })
       });
 
-      const spinner = createSpinner('Clonando agente...');
+      const spinner = createSpinner('Cloning agent...');
       spinner.start();
 
       const result = await (agent as any).copyAgent({ id: agentId });
 
-      spinner.succeed('Agente clonado exitosamente');
+      spinner.succeed('Agent cloned successfully');
 
-      logger.title('Agente clonado');
+      logger.title('Cloned agent');
       if (result?.agentId || result?.id) {
-        logger.label('Nuevo ID', result.agentId || result.id);
+        logger.label('New ID', result.agentId || result.id);
       }
-      logger.dim('\nEl agente clonado tiene el widget deshabilitado por defecto.');
+      logger.dim('\nThe cloned agent has the widget disabled by default.');
 
     } catch (error) {
-      const message = error instanceof Error ? error.message : 'Error desconocido';
+      const message = error instanceof Error ? error.message : 'Unknown error';
       logger.error(message);
       process.exit(1);
     }
   });
+
+addExamples(copyCommand, [
+  { description: 'Clone an agent (widget stays disabled on the copy)',
+    command: 'plazbot agent copy agt_AbcDef123' },
+]);

package/src/commands/agent/create.ts

@@ -1,16 +1,17 @@
 import { Command } from 'commander';
 import { Agent } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { AgentCommandOptions } from '../../types/agent';
-import { createSpinner } from '../../utils/ui';
-import { runAgentWizard } from './wizard';
+import { getStoredCredentials } from '../../utils/credentials.js';
+import { logger } from '../../utils/logger.js';
+import { addExamples } from '../../utils/help.js';
+import { AgentCommandOptions } from '../../types/agent.js';
+import { createSpinner } from '../../utils/ui.js';
+import { runAgentWizard } from './wizard.js';
 import fs from 'fs/promises';
 
 export const createCommand = new Command('create')
-  .description('Crea un nuevo agente de IA (wizard interactivo o archivo JSON)')
-  .argument('[configPath]', 'Ruta al archivo de configuracion JSON (opcional)')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .description('Create a new AI agent (interactive wizard or JSON file)')
+  .argument('[configPath]', 'Path to the JSON config file (optional)')
+  .option('--dev', 'Use development environment', false)
   .action(async (configPath: string | undefined, options: AgentCommandOptions) => {
     try {
       const credentials = await getStoredCredentials();
@@ -30,10 +31,10 @@ export const createCommand = new Command('create')
           const fileContent = await fs.readFile(configPath, 'utf-8');
           agentConfig = JSON.parse(fileContent);
         } catch (error) {
-          const errorMessage = error instanceof Error ? error.message : 'Error desconocido';
-          throw new Error(`Error al leer el archivo de configuracion: ${errorMessage}`);
+          const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+          throw new Error(`Failed to read config file: ${errorMessage}`);
         }
-        logger.title('Creando agente desde archivo');
+        logger.title('Creating agent from file');
         logger.json(agentConfig);
       } else {
         // Modo wizard interactivo
@@ -43,51 +44,60 @@ export const createCommand = new Command('create')
         const { confirm } = await inquirer.default.prompt([{
           type: 'confirm',
           name: 'confirm',
-          message: 'Crear el agente con esta configuracion?',
+          message: 'Create the agent with this configuration?',
           default: true,
         }]);
 
         if (!confirm) {
-          logger.warning('Creacion cancelada');
+          logger.warning('Creation cancelled');
           return;
         }
       }
 
-      const spinner = createSpinner('Creando agente...');
+      const spinner = createSpinner('Creating agent...');
       spinner.start();
 
       const result = await agent.addAgent(agentConfig);
 
-      spinner.succeed('Agente creado exitosamente');
+      spinner.succeed('Agent created successfully');
 
-      logger.title('Detalles del agente');
+      logger.title('Agent details');
       if (result.agentId) {
         logger.label('ID', result.agentId);
       }
       if (agentConfig.name) {
-        logger.label('Nombre', agentConfig.name);
+        logger.label('Name', agentConfig.name);
       }
-      logger.label('Tool Calling', agentConfig.useToolCalling ? 'Activado' : 'Desactivado');
+      logger.label('Tool Calling', agentConfig.useToolCalling ? 'Enabled' : 'Disabled');
 
       if (agentConfig.channels && agentConfig.channels.length > 0) {
         agentConfig.channels.forEach((ch: any) => {
-          logger.label(`Canal (${ch.channel})`, ch.key);
+          logger.label(`Channel (${ch.channel})`, ch.key);
         });
       }
 
       console.log();
-      logger.dim('Siguiente paso: plazbot agent chat -a ' + (result.agentId || '<agentId>'));
+      logger.dim('Next step: plazbot agent chat -a ' + (result.agentId || '<agentId>'));
       console.log();
 
       if (options.dev) {
-        logger.warning('Ambiente: desarrollo');
+        logger.warning('Environment: development');
       }
 
       process.exit(0);
 
     } catch (error) {
-      const message = error instanceof Error ? error.message : 'Error desconocido al crear el agente';
+      const message = error instanceof Error ? error.message : 'Unknown error while creating the agent';
       logger.error(message);
       process.exit(1);
     }
   });
+
+addExamples(createCommand, [
+  { description: 'Launch the interactive wizard to design the agent',
+    command: 'plazbot agent create' },
+  { description: 'Create directly from a JSON configuration file',
+    command: 'plazbot agent create ./agent.json' },
+  { description: 'Create against a local backend (dev mode)',
+    command: 'plazbot agent create ./agent.json --dev' },
+]);

package/src/commands/agent/delete.ts

@@ -1,14 +1,15 @@
 import { Command } from 'commander';
 import { Agent } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { AgentCommandOptions } from '../../types/agent';
+import { getStoredCredentials } from '../../utils/credentials.js';
+import { logger } from '../../utils/logger.js';
+import { addExamples } from '../../utils/help.js';
+import { AgentCommandOptions } from '../../types/agent.js';
 import readline from 'readline';
 
 export const deleteCommand = new Command('delete')
-  .description('Elimina un agente existente')
-  .argument('<agentId>', 'ID del agente a eliminar')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .description('Delete an existing agent')
+  .argument('<agentId>', 'Agent ID to delete')
+  .option('--dev', 'Use development environment', false)
   .action(async (agentId: string, options: AgentCommandOptions) => {
     try {
       // Obtener credenciales guardadas
@@ -25,11 +26,11 @@ export const deleteCommand = new Command('delete')
       const response: any = await agent.getAgentById({ id: agentId });
       const agentDetails = response.agent || response.data || response;
 
-      logger.warning('\nVas a eliminar el siguiente agente:');
+      logger.warning('\nYou are about to delete the following agent:');
       logger.divider();
       logger.info(`ID: ${agentDetails.id || agentId}`);
-      logger.info(`Nombre: ${agentDetails.name || '—'}`);
-      logger.info(`Descripcion: ${agentDetails.description || '—'}`);
+      logger.info(`Name: ${agentDetails.name || '—'}`);
+      logger.info(`Description: ${agentDetails.description || '—'}`);
       logger.divider();
 
       // Crear interfaz para confirmación
@@ -39,27 +40,32 @@ export const deleteCommand = new Command('delete')
       });
 
       // Preguntar por confirmación
-      rl.question('\nEstas seguro que deseas eliminar este agente? (y/N): ', async (answer) => {
+      rl.question('\nAre you sure you want to delete this agent? (y/N): ', async (answer) => {
         if (answer.toLowerCase() === 'y') {
           await agent.deleteAgent({
             id: agentId
           });
-          
-          logger.success('Agente eliminado exitosamente');
-          
+
+          logger.success('Agent deleted successfully');
+
           if (options.dev) {
-            logger.warning('Ambiente: desarrollo');
+            logger.warning('Environment: development');
           }
         } else {
-          logger.error('Operación cancelada');
+          logger.error('Operation cancelled');
         }
-        
+
         rl.close();
       });
 
     } catch (error) {
-      const message = error instanceof Error ? error.message : 'Error desconocido al eliminar el agente';
+      const message = error instanceof Error ? error.message : 'Unknown error while deleting the agent';
       logger.error(message);
       process.exit(1);
     }
-  }); 
+  });
+
+addExamples(deleteCommand, [
+  { description: 'Delete an agent (asks for y/N confirmation)',
+    command: 'plazbot agent delete agt_AbcDef123' },
+]);

package/src/commands/agent/enable-widget.ts

@@ -1,14 +1,15 @@
 import { Command } from 'commander';
 import { Agent } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { EnableWidgetOptions } from '../../types/agent';
+import { getStoredCredentials } from '../../utils/credentials.js';
+import { logger } from '../../utils/logger.js';
+import { addExamples } from '../../utils/help.js';
+import { EnableWidgetOptions } from '../../types/agent.js';
 
 export const enableCommand = new Command('enable-widget')
-  .description('Habilita o deshabilita el widget de un agente')
-  .argument('<agentId>', 'ID del agente')
-  .option('-d, --disable', 'Deshabilitar el widget en lugar de habilitarlo')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .description('Enable or disable an agent widget')
+  .argument('<agentId>', 'Agent ID')
+  .option('-d, --disable', 'Disable the widget instead of enabling it')
+  .option('--dev', 'Use development environment', false)
   .action(async (agentId: string, options: EnableWidgetOptions) => {
     try {
       // Obtener credenciales guardadas
@@ -25,35 +26,42 @@ export const enableCommand = new Command('enable-widget')
       const _res: any = await agent.getAgentById({ id: agentId });
       const agentDetails = _res.agent || _res.data || _res;
 
-      logger.title('Estado actual del widget');
-      logger.label('Agente', agentDetails.name);
+      logger.title('Current widget status');
+      logger.label('Agent', agentDetails.name);
 
       // Cambiar estado
       const newState = !options.disable; // Si --disable está presente, newState será false
-      const result = await agent.enableWidget({ 
-        id: agentId, 
-        enable: newState 
+      const result = await agent.enableWidget({
+        id: agentId,
+        enable: newState
       });
 
-      logger.success(`Widget ${newState ? 'habilitado' : 'deshabilitado'} exitosamente`);
-      
-      logger.title('Respuesta del servidor');
-      logger.label('Estado', result.success ? 'Exitoso' : 'Fallido');
-      logger.label('Mensaje', result.message);
+      logger.success(`Widget ${newState ? 'enabled' : 'disabled'} successfully`);
+
+      logger.title('Server response');
+      logger.label('Status', result.success ? 'Success' : 'Failed');
+      logger.label('Message', result.message);
 
       if (newState && result.script) {
-        logger.title('Instrucciones de instalacion');
-        logger.dim('Coloca este script debajo de la etiqueta <HEAD> en tu sitio web:');
+        logger.title('Installation instructions');
+        logger.dim('Place this script under the <HEAD> tag of your website:');
         logger.info('\n' + result.script);
       }
-      
+
       if (options.dev) {
-        logger.warning('Ambiente: desarrollo');
+        logger.warning('Environment: development');
       }
 
     } catch (error) {
-      const message = error instanceof Error ? error.message : 'Error desconocido al modificar el widget';
+      const message = error instanceof Error ? error.message : 'Unknown error while updating the widget';
       logger.error(message);
       process.exit(1);
     }
-  }); 
+  });
+
+addExamples(enableCommand, [
+  { description: 'Enable the widget and print the <script> snippet',
+    command: 'plazbot agent enable-widget agt_AbcDef123' },
+  { description: 'Disable an existing widget',
+    command: 'plazbot agent enable-widget agt_AbcDef123 --disable' },
+]);