plazbot-cli 0.2.26 → 0.3.1

package/dist/utils/ui.js

@@ -1,44 +1,30 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.theme = void 0;
-exports.createSpinner = createSpinner;
-exports.createTable = createTable;
-exports.box = box;
-exports.formatDate = formatDate;
-exports.statusBadge = statusBadge;
-exports.kvPair = kvPair;
-exports.section = section;
-exports.progressBar = progressBar;
-const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
-const cli_table3_1 = __importDefault(require("cli-table3"));
+import chalk from 'chalk';
+import ora from 'ora';
+import Table from 'cli-table3';
 // Colores del tema Plazbot
-exports.theme = {
-    primary: chalk_1.default.hex('#4CAF50'),
-    secondary: chalk_1.default.hex('#2196F3'),
-    accent: chalk_1.default.hex('#FFA726'),
-    success: chalk_1.default.hex('#66BB6A'),
-    error: chalk_1.default.hex('#EF5350'),
-    warning: chalk_1.default.hex('#FFA726'),
-    muted: chalk_1.default.gray,
-    bold: chalk_1.default.bold,
-    dim: chalk_1.default.dim,
+export const theme = {
+    primary: chalk.hex('#4CAF50'),
+    secondary: chalk.hex('#2196F3'),
+    accent: chalk.hex('#FFA726'),
+    success: chalk.hex('#66BB6A'),
+    error: chalk.hex('#EF5350'),
+    warning: chalk.hex('#FFA726'),
+    muted: chalk.gray,
+    bold: chalk.bold,
+    dim: chalk.dim,
 };
 // Spinner
-function createSpinner(text) {
-    return (0, ora_1.default)({
-        text: exports.theme.muted(text),
+export function createSpinner(text) {
+    return ora({
+        text: theme.muted(text),
         spinner: 'dots',
         color: 'green',
     });
 }
 // Tabla formateada
-function createTable(headers, rows) {
-    const table = new cli_table3_1.default({
-        head: headers.map(h => exports.theme.bold.hex('#4CAF50')(h)),
+export function createTable(headers, rows) {
+    const table = new Table({
+        head: headers.map(h => theme.bold.hex('#4CAF50')(h)),
         style: {
             head: [],
             border: ['gray'],
@@ -54,22 +40,22 @@ function createTable(headers, rows) {
     return table.toString();
 }
 // Box simple
-function box(content, title) {
+export function box(content, title) {
     const lines = content.split('\n');
     const maxLen = Math.max(...lines.map(l => stripAnsi(l).length), title ? stripAnsi(title).length + 4 : 0);
     const width = maxLen + 4;
     let result = '';
     if (title) {
-        result += exports.theme.muted('  ┌─ ') + exports.theme.primary(title) + exports.theme.muted(' ' + '─'.repeat(Math.max(0, width - stripAnsi(title).length - 5))) + exports.theme.muted('┐') + '\n';
+        result += theme.muted('  ┌─ ') + theme.primary(title) + theme.muted(' ' + '─'.repeat(Math.max(0, width - stripAnsi(title).length - 5))) + theme.muted('┐') + '\n';
     }
     else {
-        result += exports.theme.muted('  ┌' + '─'.repeat(width) + '┐') + '\n';
+        result += theme.muted('  ┌' + '─'.repeat(width) + '┐') + '\n';
     }
     for (const line of lines) {
         const pad = ' '.repeat(Math.max(0, maxLen - stripAnsi(line).length));
-        result += exports.theme.muted('  │') + '  ' + line + pad + '  ' + exports.theme.muted('│') + '\n';
+        result += theme.muted('  │') + '  ' + line + pad + '  ' + theme.muted('│') + '\n';
     }
-    result += exports.theme.muted('  └' + '─'.repeat(width) + '┘');
+    result += theme.muted('  └' + '─'.repeat(width) + '┘');
     return result;
 }
 // Strip ANSI codes para calcular longitud real
@@ -77,7 +63,7 @@ function stripAnsi(str) {
     return str.replace(/\x1b\[[0-9;]*m/g, '');
 }
 // Formato de fecha legible
-function formatDate(date) {
+export function formatDate(date) {
     const d = new Date(date);
     return d.toLocaleDateString('es-ES', {
         year: 'numeric',
@@ -88,24 +74,24 @@ function formatDate(date) {
     });
 }
 // Status badge
-function statusBadge(enabled) {
+export function statusBadge(enabled) {
     return enabled
-        ? exports.theme.success('● activo')
-        : exports.theme.error('○ inactivo');
+        ? theme.success('● activo')
+        : theme.error('○ inactivo');
 }
 // Key-value pair formateado
-function kvPair(key, value) {
-    return `  ${exports.theme.muted(key + ':')} ${value}`;
+export function kvPair(key, value) {
+    return `  ${theme.muted(key + ':')} ${value}`;
 }
 // Sección con título
-function section(title) {
-    return '\n' + exports.theme.bold.hex('#4CAF50')(`  ${title}`) + '\n' + exports.theme.muted('  ' + '─'.repeat(40));
+export function section(title) {
+    return '\n' + theme.bold.hex('#4CAF50')(`  ${title}`) + '\n' + theme.muted('  ' + '─'.repeat(40));
 }
 // Progress bar simple
-function progressBar(current, total, width = 30) {
+export function progressBar(current, total, width = 30) {
     const percent = Math.round((current / total) * 100);
     const filled = Math.round((current / total) * width);
     const empty = width - filled;
-    const bar = exports.theme.success('█'.repeat(filled)) + exports.theme.muted('░'.repeat(empty));
-    return `${bar} ${exports.theme.bold(percent + '%')} (${current}/${total})`;
+    const bar = theme.success('█'.repeat(filled)) + theme.muted('░'.repeat(empty));
+    return `${bar} ${theme.bold(percent + '%')} (${current}/${total})`;
 }

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "plazbot-cli",
-  "version": "0.2.26",
+  "version": "0.3.1",
   "description": "CLI para Plazbot SDK",
+  "type": "module",
   "main": "dist/cli.js",
   "bin": {
     "plazbot": "dist/cli.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && mkdir -p dist/schemas && cp src/schemas/*.json dist/schemas/ && chmod +x dist/cli.js",
     "start": "node dist/cli.js",
     "dev": "tsc -w",
+    "typecheck": "tsc --noEmit",
     "prepare:dev": "npm uninstall plazbot && npm install file:../Plazbot-SDK-v2.0",
     "prepare:prod": "npm uninstall plazbot && npm install plazbot@latest",
     "prepublishOnly": "npm run prepare:prod && npm run build",
@@ -32,25 +34,34 @@
   "license": "MIT",
   "dependencies": {
     "@microsoft/signalr": "^10.0.0",
-    "@types/inquirer": "^9.0.8",
+    "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1",
     "axios": "^1.6.0",
-    "boxen": "^5.1.2",
-    "chalk": "^4.1.2",
+    "boxen": "^7.1.1",
+    "chalk": "^5.3.0",
     "cli-table3": "^0.6.5",
     "commander": "^12.0.0",
-    "figures": "^3.2.0",
-    "gradient-string": "^2.0.2",
+    "figures": "^6.1.0",
+    "gradient-string": "^3.0.0",
+    "ink": "^5.0.1",
+    "ink-spinner": "^5.0.0",
+    "ink-syntax-highlight": "^2.0.2",
+    "ink-text-input": "^6.0.0",
     "inquirer": "^12.6.3",
     "marked": "^12.0.2",
     "marked-terminal": "^7.2.1",
-    "ora": "^5.4.1",
-    "plazbot": "^2.1.4"
+    "ora": "^8.0.1",
+    "plazbot": "^2.1.4",
+    "react": "^18.3.1",
+    "zustand": "^4.5.4"
   },
   "devDependencies": {
+    "@types/inquirer": "^9.0.8",
     "@types/node": "^20.0.0",
+    "@types/react": "^18.3.3",
     "typescript": "^5.0.0"
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=18.17.0"
   }
 }

package/src/cli.ts

@@ -1,19 +1,32 @@
 #!/usr/bin/env node
 import { program } from 'commander';
-import { portalCommands } from './commands/portal';
-import { authCommands } from './commands/auth';
-import { agentCommands } from './commands/agent';
-import { whatsappCommands } from './commands/whatsapp';
-import { workersCommands } from './commands/workers';
-import { showBanner } from './utils/banner';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { portalCommands } from './commands/portal/index.js';
+import { authCommands } from './commands/auth/index.js';
+import { agentCommands } from './commands/agent/index.js';
+import { whatsappCommands } from './commands/whatsapp/index.js';
+import { workersCommands } from './commands/workers/index.js';
+import { studioCommand } from './studio/index.js';
+import { showBanner } from './utils/banner.js';
+
+// Guard de runtime: Plazbot CLI v0.3+ requiere Node 18.17+
+const [major, minor] = process.versions.node.split('.').map(Number);
+if (major < 18 || (major === 18 && minor < 17)) {
+  console.error(`Plazbot CLI v0.3+ requires Node.js >=18.17.0. Current version: ${process.versions.node}`);
+  process.exit(1);
+}
 
 // Leer version desde package.json
-const { version } = require('../package.json');
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkgPath = join(__dirname, '..', 'package.json');
+const { version } = JSON.parse(readFileSync(pkgPath, 'utf-8'));
 
 // Configuracion basica del CLI
 program
   .name('plazbot')
-  .description('CLI oficial de Plazbot - Agentes de IA para WhatsApp, portales y desarrolladores')
+  .description('Official Plazbot CLI - AI agents for WhatsApp, portals and developers')
   .version(version);
 
 // Registrar todos los comandos de autenticacion
@@ -31,6 +44,9 @@ program.addCommand(whatsappCommands);
 // Registrar todos los comandos de Workers
 program.addCommand(workersCommands);
 
+// Registrar el comando Studio (REPL interactivo)
+program.addCommand(studioCommand);
+
 // Si no se pasan argumentos, mostrar banner
 if (process.argv.length <= 2) {
   showBanner().then(() => {

package/src/commands/agent/ai-config.ts

@@ -1,21 +1,64 @@
 import { Command } from 'commander';
 import { Agent } from 'plazbot';
 import inquirer from 'inquirer';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { createSpinner, theme, section, kvPair } 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 { describeAgentLoadError } from '../../utils/agent-errors.js';
+import { createSpinner, theme, section, kvPair } from '../../utils/ui.js';
+import { AgentCommandOptions } from '../../types/agent.js';
 
+// Catalogo de modelos sincronizado con el front (AIModelSection.tsx).
+// Si se actualiza el dropdown del front, actualizar aqui tambien.
 const MODELS: Record<string, string[]> = {
-  openai: ['gpt-4o', 'gpt-4', 'gpt-3.5-turbo', 'o1-preview', 'o1-mini'],
-  claude: ['claude-3-5-sonnet-20241022', 'claude-3-opus-20240229', 'claude-3-haiku-20240307'],
-  gemini: ['gemini-2.0-flash', 'gemini-1.5-pro', 'gemini-1.5-flash'],
+  openai: [
+    // GPT-5.4 (flagship actual)
+    'gpt-5.4', 'gpt-5.4-mini', 'gpt-5.4-nano',
+    // GPT-5.2
+    'gpt-5.2',
+    // GPT-5.1
+    'gpt-5.1', 'gpt-5.1-codex', 'gpt-5.1-codex-mini',
+    // GPT-5
+    'gpt-5', 'gpt-5-mini', 'gpt-5-nano',
+    // GPT-4.1
+    'gpt-4.1', 'gpt-4.1-mini', 'gpt-4.1-nano',
+    // GPT-4o
+    'gpt-4o', 'gpt-4o-mini',
+    // Razonamiento (o-series)
+    'o4-mini', 'o3', 'o3-mini', 'o1-2024-12-17',
+    // Legacy
+    'gpt-4-turbo', 'gpt-3.5-turbo',
+  ],
+  claude: [
+    // Mythos-class (flagship)
+    'claude-fable-5',
+    // Claude 4.6
+    'claude-opus-4-6', 'claude-sonnet-4-6',
+    // Claude 4.5
+    'claude-opus-4-5-20251101', 'claude-sonnet-4-5-20250929', 'claude-haiku-4-5-20251001',
+    // Claude 4.x
+    'claude-opus-4-1-20250805', 'claude-opus-4-20250514', 'claude-sonnet-4-20250514',
+  ],
+  gemini: [
+    // Gemini 3.1 (flagship actual)
+    'gemini-3.1-pro-preview', 'gemini-3.1-flash-lite-preview',
+    // Gemini 2.5
+    'gemini-2.5-pro', 'gemini-2.5-flash', 'gemini-2.5-flash-lite',
+    // Gemini 2.0
+    'gemini-2.0-flash',
+  ],
+};
+
+const DEFAULT_MODEL: Record<string, string> = {
+  openai: 'gpt-4o',
+  claude: 'claude-sonnet-4-6',
+  gemini: 'gemini-2.5-pro',
 };
 
 export const aiConfigCommand = new Command('ai-config')
-  .description('Configurar proveedor de IA del agente')
-  .argument('<agentId>', 'ID del agente')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .description('Configure the agent AI provider')
+  .argument('<agentId>', 'Agent ID')
+  .option('--dev', 'Use development environment', false)
   .action(async (agentId: string, options: AgentCommandOptions) => {
     try {
       const credentials = await getStoredCredentials();
@@ -26,36 +69,43 @@ export const aiConfigCommand = new Command('ai-config')
         ...(options.dev && { customUrl: "http://localhost:5090" })
       });
 
-      const spinner = createSpinner('Cargando agente...');
+      const spinner = createSpinner('Loading agent...');
       spinner.start();
-      const _res: any = await agent.getAgentById({ id: agentId });
-      const agentData = _res.agent || _res.data || _res;
-      spinner.stop();
+      let agentData: any;
+      try {
+        const _res: any = await agent.getAgentById({ id: agentId });
+        agentData = _res.agent || _res.data || _res;
+        spinner.stop();
+      } catch (loadErr) {
+        spinner.stop();
+        logger.error(describeAgentLoadError(loadErr, agentId, credentials, { dev: options.dev }));
+        process.exit(1);
+      }
 
-      console.log(section('Configuracion de IA - ' + (agentData.name || agentId)));
+      console.log(section('AI Configuration - ' + (agentData.name || agentId)));
 
       const currentProviders = agentData.aiProviders || [];
       if (currentProviders.length > 0 && agentData.customAIConfig) {
-        console.log(theme.bold('\n  Configuracion actual:'));
+        console.log(theme.bold('\n  Current configuration:'));
         currentProviders.forEach((p: any) => {
-          console.log(kvPair('  Proveedor', p.provider));
-          console.log(kvPair('  Modelo', p.model));
-          console.log(kvPair('  Temperatura', String(p.temperature)));
+          console.log(kvPair('  Provider', p.provider));
+          console.log(kvPair('  Model', p.model));
+          console.log(kvPair('  Temperature', String(p.temperature)));
           console.log(kvPair('  Max Tokens', String(p.maxTokens)));
-          console.log(kvPair('  Default', p.isDefault ? 'Si' : 'No'));
+          console.log(kvPair('  Default', p.isDefault ? 'Yes' : 'No'));
         });
       } else {
-        console.log(theme.muted('\n  Usando configuracion de IA por defecto (Plazbot)'));
+        console.log(theme.muted('\n  Using default AI configuration (Plazbot)'));
       }
 
       const { action } = await (inquirer as any).prompt([{
         type: 'list',
         name: 'action',
-        message: 'Que deseas hacer?',
+        message: 'What would you like to do?',
         choices: [
-          { name: 'Configurar nuevo proveedor', value: 'set' },
-          { name: 'Usar configuracion por defecto', value: 'reset' },
-          { name: 'Salir', value: 'exit' },
+          { name: 'Configure new provider', value: 'set' },
+          { name: 'Use default configuration', value: 'reset' },
+          { name: 'Exit', value: 'exit' },
         ],
       }]);
 
@@ -63,24 +113,24 @@ export const aiConfigCommand = new Command('ai-config')
 
       if (action === 'reset') {
         const { id, _id, ...resetConfig } = { ...agentData, customAIConfig: false, aiProviders: [] };
-        const resetSpinner = createSpinner('Reseteando configuracion...');
+        const resetSpinner = createSpinner('Resetting configuration...');
         resetSpinner.start();
         await agent.updateAgent(agentId, resetConfig);
-        resetSpinner.succeed('Usando configuracion por defecto');
+        resetSpinner.succeed('Using default configuration');
         return;
       }
 
       // Configurar nuevo proveedor
       const ai = await (inquirer as any).prompt([
-        { type: 'list', name: 'provider', message: 'Proveedor:', choices: ['openai', 'claude', 'gemini'] },
+        { type: 'list', name: 'provider', message: 'Provider:', choices: ['openai', 'claude', 'gemini'] },
       ]);
 
       const models = MODELS[ai.provider] || MODELS.openai;
 
       const config = await (inquirer as any).prompt([
-        { type: 'list', name: 'model', message: 'Modelo:', choices: models },
-        { type: 'password', name: 'apiToken', message: 'API Token:', mask: '*', validate: (v: string) => v.length > 0 || 'Requerido' },
-        { type: 'number', name: 'temperature', message: 'Temperatura (0-2):', default: 0.7 },
+        { type: 'list', name: 'model', message: 'Model:', choices: models, default: DEFAULT_MODEL[ai.provider] },
+        { type: 'password', name: 'apiToken', message: 'API Token:', mask: '*', validate: (v: string) => v.length > 0 || 'Required' },
+        { type: 'number', name: 'temperature', message: 'Temperature (0-2):', default: 0.7 },
         { type: 'number', name: 'maxTokens', message: 'Max tokens (1024-16384):', default: 4096 },
       ]);
 
@@ -96,14 +146,19 @@ export const aiConfigCommand = new Command('ai-config')
           isDefault: true,
         }],
       };
-      const updateSpinner = createSpinner('Guardando configuracion...');
+      const updateSpinner = createSpinner('Saving configuration...');
       updateSpinner.start();
       await agent.updateAgent(agentId, updatedConfig);
-      updateSpinner.succeed(`Proveedor configurado: ${ai.provider} / ${config.model}`);
+      updateSpinner.succeed(`Provider configured: ${ai.provider} / ${config.model}`);
 
     } 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(aiConfigCommand, [
+  { description: 'Pick provider/model/API key for the agent interactively',
+    command: 'plazbot agent ai-config agt_AbcDef123' },
+]);

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 '';