plazbot-cli 0.2.26 → 0.3.2

package/CLAUDE.md

@@ -7,8 +7,9 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 Plazbot CLI v2.0 es una interfaz de línea de comandos oficial para la plataforma Plazbot. Permite gestionar agentes de IA, portales web y comunicaciones vía WhatsApp desde la terminal.
 
 - **Lenguaje**: TypeScript 5.0+
-- **Runtime**: Node.js >=16.0.0
+- **Runtime**: Node.js >=18.17.0 (ESM)
 - **Framework CLI**: Commander.js
+- **TUI**: Ink v5 + React 18 + zustand (solo para `plazbot studio`)
 
 ## Comandos de Desarrollo
 
@@ -47,13 +48,37 @@ src/
 │   ├── agent/             # CRUD + chat interactivo de agentes
 │   ├── auth/              # init (login) y logout
 │   ├── portal/            # CRUD + gestión de enlaces
-│   └── whatsapp/          # Mensajes y webhooks
+│   ├── whatsapp/          # Mensajes y webhooks
+│   └── workers/           # Tools, syncs, schedules, webhooks
+├── studio/                # REPL interactivo (Ink + SSE)
+│   ├── index.ts           # studioCommand + subcomando ask
+│   ├── runRepl.tsx        # Bootstrap Ink render(<App/>)
+│   ├── runOneShot.ts      # Modo no interactivo (stdout)
+│   ├── api/               # types, studioApi, sseClient (fetch + ReadableStream)
+│   ├── state/store.ts     # zustand: messages, steps, agentConfig, usage
+│   ├── slash/             # parser, registry, handlers (/help, /clear, /agents…)
+│   ├── render/            # markdown (marked-terminal), steps, json
+│   └── components/        # App, Header, ChatLog, Message, ToolCall, Input…
 ├── types/                 # Interfaces TypeScript
 └── utils/
     ├── logger.ts          # Logging formateado (info, success, warning, error)
+    ├── api.ts             # axios con Authorization Bearer + x-workspace-id
     └── credentials.ts     # Persistencia en ~/.plazbot/config.json
 ```
 
+### Studio (REPL interactivo)
+
+`plazbot studio` abre una TUI estilo Claude Code que consume el endpoint SSE
+`POST /api/agent/studio`. Permite crear, cargar, diagnosticar y guardar agentes
+en conversación natural. Las tool_calls se renderizan como cards con spinner;
+el `agentConfig` aparece en un panel lateral con tabs preview/json/diagnose.
+
+- `plazbot studio` → REPL completo (Ink)
+- `plazbot studio -m "..."` o `plazbot studio ask "..."` → one-shot a stdout
+- `plazbot studio ask "..." --json` → NDJSON crudo de los chunks SSE
+
+Atajos: `Tab` panel · `Esc` cancelar stream · `Ctrl+C` salir.
+
 ### Flujo de Comandos
 
 1. `cli.ts` usa Commander.js para registrar grupos de comandos
@@ -74,13 +99,17 @@ El CLI depende del paquete `plazbot` que expone tres clases principales:
 Se almacenan en `~/.plazbot/config.json`:
 ```json
 {
-  "email": "string",
-  "apiKey": "string",
+  "email": "string (opcional)",
+  "apiKey": "string (JWT)",
   "workspace": "string",
-  "zone": "LA | EU"
+  "zone": "LA | EU",
+  "userId": "string (opcional, usado por studio como x-user-id)"
 }
 ```
 
+El `apiKey` es un JWT válido. El CLI lo envía como `Authorization: Bearer <jwt>`
+y mantiene transitoriamente `x-api-key` para endpoints legacy.
+
 ### Flag --dev
 
 Todos los comandos soportan `--dev` para apuntar al backend local (`http://localhost:5090`).

package/README.md

@@ -4,6 +4,27 @@ Official Command Line Interface for Plazbot - Manage your AI agents and portals
 
 ## Features
 
+🧠 **Agent Studio (REPL interactivo, estilo Claude Code)**
+```bash
+# Modo REPL completo (TUI con Ink)
+plazbot studio
+
+# One-shot (resultado a stdout, sin TUI)
+plazbot studio ask "lista mis agentes"
+plazbot studio -m "crea un agente de ventas para WhatsApp"
+
+# NDJSON crudo de los chunks SSE
+plazbot studio ask "diagnostica el agente xyz" --json
+
+# Backend local
+plazbot studio --dev
+```
+
+Slash commands: `/help`, `/clear`, `/quit`, `/agents`, `/load <id>`, `/save`,
+`/diagnose`, `/panel`, `/json`, `/preview`.
+
+Atajos: `Tab` panel · `Esc` cancelar stream · `Ctrl+C` salir.
+
 🤖 **Agent Management**
 ```bash
 # Create a new agent

package/dist/cli.js

@@ -1,36 +1,48 @@
 #!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const commander_1 = require("commander");
-const portal_1 = require("./commands/portal");
-const auth_1 = require("./commands/auth");
-const agent_1 = require("./commands/agent");
-const whatsapp_1 = require("./commands/whatsapp");
-const workers_1 = require("./commands/workers");
-const banner_1 = require("./utils/banner");
+import { program } from 'commander';
+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
-commander_1.program
+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
-auth_1.authCommands.forEach(cmd => commander_1.program.addCommand(cmd));
+authCommands.forEach(cmd => program.addCommand(cmd));
 // Registrar todos los comandos de agente
-commander_1.program.addCommand(agent_1.agentCommands);
+program.addCommand(agentCommands);
 // Registrar todos los comandos de portal
-commander_1.program.addCommand(portal_1.portalCommands);
+program.addCommand(portalCommands);
 // Registrar todos los comandos de WhatsApp
-commander_1.program.addCommand(whatsapp_1.whatsappCommands);
+program.addCommand(whatsappCommands);
 // Registrar todos los comandos de Workers
-commander_1.program.addCommand(workers_1.workersCommands);
+program.addCommand(workersCommands);
+// Registrar el comando Studio (REPL interactivo)
+program.addCommand(studioCommand);
 // Si no se pasan argumentos, mostrar banner
 if (process.argv.length <= 2) {
-    (0, banner_1.showBanner)().then(() => {
-        commander_1.program.outputHelp();
+    showBanner().then(() => {
+        program.outputHelp();
     });
 }
 else {
-    commander_1.program.parse(process.argv);
+    program.parse(process.argv);
 }

package/dist/commands/agent/ai-config.js

@@ -1,82 +1,126 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.aiConfigCommand = void 0;
-const commander_1 = require("commander");
-const plazbot_1 = require("plazbot");
-const inquirer_1 = __importDefault(require("inquirer"));
-const credentials_1 = require("../../utils/credentials");
-const logger_1 = require("../../utils/logger");
-const ui_1 = require("../../utils/ui");
+import { Command } from 'commander';
+import { Agent } from 'plazbot';
+import inquirer from 'inquirer';
+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';
+// Catalogo de modelos sincronizado con el front (AIModelSection.tsx).
+// Si se actualiza el dropdown del front, actualizar aqui tambien.
 const MODELS = {
-    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 = {
+    openai: 'gpt-4o',
+    claude: 'claude-sonnet-4-6',
+    gemini: 'gemini-2.5-pro',
 };
-exports.aiConfigCommand = new commander_1.Command('ai-config')
-    .description('Configurar proveedor de IA del agente')
-    .argument('<agentId>', 'ID del agente')
-    .option('--dev', 'Usar ambiente de desarrollo', false)
+export const aiConfigCommand = new Command('ai-config')
+    .description('Configure the agent AI provider')
+    .argument('<agentId>', 'Agent ID')
+    .option('--dev', 'Use development environment', false)
     .action(async (agentId, options) => {
     try {
-        const credentials = await (0, credentials_1.getStoredCredentials)();
-        const agent = new plazbot_1.Agent({
+        const credentials = await getStoredCredentials();
+        const agent = new Agent({
             workspaceId: credentials.workspace,
             apiKey: credentials.apiKey,
             zone: credentials.zone,
             ...(options.dev && { customUrl: "http://localhost:5090" })
         });
-        const spinner = (0, ui_1.createSpinner)('Cargando agente...');
+        const spinner = createSpinner('Loading agent...');
         spinner.start();
-        const _res = await agent.getAgentById({ id: agentId });
-        const agentData = _res.agent || _res.data || _res;
-        spinner.stop();
-        console.log((0, ui_1.section)('Configuracion de IA - ' + (agentData.name || agentId)));
+        let agentData;
+        try {
+            const _res = 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('AI Configuration - ' + (agentData.name || agentId)));
         const currentProviders = agentData.aiProviders || [];
         if (currentProviders.length > 0 && agentData.customAIConfig) {
-            console.log(ui_1.theme.bold('\n  Configuracion actual:'));
+            console.log(theme.bold('\n  Current configuration:'));
             currentProviders.forEach((p) => {
-                console.log((0, ui_1.kvPair)('  Proveedor', p.provider));
-                console.log((0, ui_1.kvPair)('  Modelo', p.model));
-                console.log((0, ui_1.kvPair)('  Temperatura', String(p.temperature)));
-                console.log((0, ui_1.kvPair)('  Max Tokens', String(p.maxTokens)));
-                console.log((0, ui_1.kvPair)('  Default', p.isDefault ? 'Si' : 'No'));
+                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 ? 'Yes' : 'No'));
             });
         }
         else {
-            console.log(ui_1.theme.muted('\n  Usando configuracion de IA por defecto (Plazbot)'));
+            console.log(theme.muted('\n  Using default AI configuration (Plazbot)'));
         }
-        const { action } = await inquirer_1.default.prompt([{
+        const { action } = await inquirer.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' },
                 ],
             }]);
         if (action === 'exit')
             return;
         if (action === 'reset') {
             const { id, _id, ...resetConfig } = { ...agentData, customAIConfig: false, aiProviders: [] };
-            const resetSpinner = (0, ui_1.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_1.default.prompt([
-            { type: 'list', name: 'provider', message: 'Proveedor:', choices: ['openai', 'claude', 'gemini'] },
+        const ai = await inquirer.prompt([
+            { type: 'list', name: 'provider', message: 'Provider:', choices: ['openai', 'claude', 'gemini'] },
         ]);
         const models = MODELS[ai.provider] || MODELS.openai;
-        const config = await inquirer_1.default.prompt([
-            { type: 'list', name: 'model', message: 'Modelo:', choices: models },
-            { type: 'password', name: 'apiToken', message: 'API Token:', mask: '*', validate: (v) => v.length > 0 || 'Requerido' },
-            { type: 'number', name: 'temperature', message: 'Temperatura (0-2):', default: 0.7 },
+        const config = await inquirer.prompt([
+            { type: 'list', name: 'model', message: 'Model:', choices: models, default: DEFAULT_MODEL[ai.provider] },
+            { type: 'password', name: 'apiToken', message: 'API Token:', mask: '*', validate: (v) => 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 },
         ]);
         const { id: _uid, _id: _oid, ...updatedConfig } = {
@@ -91,14 +135,18 @@ exports.aiConfigCommand = new commander_1.Command('ai-config')
                     isDefault: true,
                 }],
         };
-        const updateSpinner = (0, ui_1.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';
-        logger_1.logger.error(message);
+        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/dist/commands/agent/chat.js

@@ -1,84 +1,82 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.chatCommand = void 0;
-const commander_1 = require("commander");
-const plazbot_1 = require("plazbot");
-const credentials_1 = require("../../utils/credentials");
-const logger_1 = require("../../utils/logger");
-const ui_1 = require("../../utils/ui");
-const crypto_1 = __importDefault(require("crypto"));
-const readline_1 = __importDefault(require("readline"));
-const chalk_1 = __importDefault(require("chalk"));
+import { Command } from 'commander';
+import { Agent } from 'plazbot';
+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 { section } from '../../utils/ui.js';
+import crypto from 'crypto';
+import readline from 'readline';
+import chalk from 'chalk';
 const COMMANDS_HELP = `
-  ${chalk_1.default.bold('Comandos disponibles:')}
-  ${chalk_1.default.hex('#4CAF50')('/exit')}      Terminar conversacion
-  ${chalk_1.default.hex('#4CAF50')('/clear')}     Limpiar pantalla
-  ${chalk_1.default.hex('#4CAF50')('/info')}      Informacion de la sesion
-  ${chalk_1.default.hex('#4CAF50')('/sources')}   Mostrar/ocultar fuentes
-  ${chalk_1.default.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
 `;
-exports.chatCommand = new commander_1.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) => {
+export const chatCommand = new Command('chat')
+    .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, options) => {
     try {
-        const credentials = await (0, credentials_1.getStoredCredentials)();
-        const agent = new plazbot_1.Agent({
+        const credentials = await getStoredCredentials();
+        const agent = new Agent({
             workspaceId: credentials.workspace,
             apiKey: credentials.apiKey,
             zone: credentials.zone,
             ...(options.dev && { customUrl: "http://localhost:5090" })
         });
-        const sessionId = options.sessionId || crypto_1.default.randomUUID();
+        const sessionId = options.sessionId || crypto.randomUUID();
         let showSources = true;
         // Cargar info del agente
         let agentInfo = null;
         try {
-            process.stdout.write(chalk_1.default.gray('  Conectando con agente...'));
-            const _res = await agent.getAgentById({ id: options.agentId });
+            process.stdout.write(chalk.gray('  Connecting to agent...'));
+            const _res = 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_1.default.createInterface({
+        const rl = readline.createInterface({
             input: process.stdin,
             output: process.stdout
         });
         // Pantalla de chat
         console.clear();
-        const agentName = agentInfo?.name || 'Agente';
-        const toolCalling = agentInfo?.useToolCalling ? chalk_1.default.hex('#4CAF50')(' [Tool Calling]') : '';
+        const agentName = agentInfo?.name || 'Agent';
+        const toolCalling = agentInfo?.useToolCalling ? chalk.hex('#4CAF50')(' [Tool Calling]') : '';
         console.log();
-        console.log(chalk_1.default.hex('#4CAF50')('  ┌' + '─'.repeat(58) + '┐'));
-        console.log(chalk_1.default.hex('#4CAF50')('  │') + chalk_1.default.bold(`  ${agentName}${toolCalling}`).padEnd(68) + chalk_1.default.hex('#4CAF50')('│'));
-        console.log(chalk_1.default.hex('#4CAF50')('  │') + chalk_1.default.gray(`  Session: ${sessionId.substring(0, 8)}...`).padEnd(68) + chalk_1.default.hex('#4CAF50')('│'));
-        console.log(chalk_1.default.hex('#4CAF50')('  │') + chalk_1.default.gray('  /help para ver comandos').padEnd(68) + chalk_1.default.hex('#4CAF50')('│'));
-        console.log(chalk_1.default.hex('#4CAF50')('  └' + '─'.repeat(58) + '┘'));
+        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 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' });
-            console.log(chalk_1.default.hex('#4CAF50')(`  ${agentName}`) + chalk_1.default.gray(` ${timestamp}`));
-            console.log(chalk_1.default.white(`  ${agentInfo.instructions.greeting}`));
+            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_1.default.hex('#2196F3')('  Tu > '), async (question) => {
+            rl.question(chalk.hex('#2196F3')('  You > '), async (question) => {
                 if (!question.trim()) {
                     askQuestion();
                     return;
                 }
                 // Comandos especiales
                 if (question.toLowerCase() === '/exit') {
-                    console.log(chalk_1.default.gray('\n  Sesion terminada.\n'));
+                    console.log(chalk.gray('\n  Session ended.\n'));
                     rl.close();
                     return;
                 }
@@ -93,60 +91,60 @@ exports.chatCommand = new commander_1.Command('chat')
                     return;
                 }
                 if (question.toLowerCase() === '/info') {
-                    console.log((0, ui_1.section)('Informacion de sesion'));
-                    logger_1.logger.label('Agent ID', options.agentId);
-                    logger_1.logger.label('Session ID', sessionId);
-                    logger_1.logger.label('Agente', agentName);
-                    logger_1.logger.label('Tool Calling', agentInfo?.useToolCalling ? 'Activado' : 'Desactivado');
-                    logger_1.logger.label('AI Provider', agentInfo?.customAIConfig ? (agentInfo.aiProviders?.[0]?.provider || 'Custom') : 'Default');
+                    console.log(section('Session information'));
+                    logger.label('Agent ID', agentId);
+                    logger.label('Session ID', sessionId);
+                    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();
                     return;
                 }
                 if (question.toLowerCase() === '/sources') {
                     showSources = !showSources;
-                    console.log(chalk_1.default.gray(`  Fuentes: ${showSources ? 'activadas' : 'desactivadas'}`));
+                    console.log(chalk.gray(`  Sources: ${showSources ? 'on' : 'off'}`));
                     console.log();
                     askQuestion();
                     return;
                 }
                 try {
-                    process.stdout.write(chalk_1.default.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
                     });
-                    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) {
                         response.actionsExecuted.forEach((action) => {
-                            console.log(chalk_1.default.hex('#FFA726')(`  Tool: ${action.name || action.intent || 'action'}`));
+                            console.log(chalk.hex('#FFA726')(`  Tool: ${action.name || action.intent || 'action'}`));
                         });
                     }
                     // Respuesta del agente
                     console.log();
-                    console.log(chalk_1.default.hex('#4CAF50')(`  ${agentName}`) + chalk_1.default.gray(` ${timestamp}`));
+                    console.log(chalk.hex('#4CAF50')(`  ${agentName}`) + chalk.gray(` ${timestamp}`));
                     // Formatear respuesta (soporte basico de markdown)
                     const formattedAnswer = formatResponse(response.answer);
                     console.log(formattedAnswer);
                     console.log();
                     // Fuentes
                     if (showSources && response.sources && response.sources.length > 0) {
-                        console.log(chalk_1.default.gray('  Fuentes:'));
+                        console.log(chalk.gray('  Sources:'));
                         response.sources.forEach((source) => {
-                            console.log(chalk_1.default.gray(`    - ${source.title || 'Sin titulo'}`));
+                            console.log(chalk.gray(`    - ${source.title || 'Untitled'}`));
                             if (source.url)
-                                console.log(chalk_1.default.gray(`      ${source.url}`));
+                                console.log(chalk.gray(`      ${source.url}`));
                         });
                         console.log();
                     }
                     askQuestion();
                 }
                 catch (error) {
-                    const message = error instanceof Error ? error.message : 'Error desconocido';
-                    console.log(chalk_1.default.hex('#EF5350')(`\n  ✖ Error: ${message}\n`));
+                    const message = error instanceof Error ? error.message : 'Unknown error';
+                    console.log(chalk.hex('#EF5350')(`\n  ✖ Error: ${message}\n`));
                     askQuestion();
                 }
             });
@@ -154,36 +152,44 @@ exports.chatCommand = new commander_1.Command('chat')
         askQuestion();
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : 'Error desconocido';
-        logger_1.logger.error(message);
+        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) {
     if (!text)
         return '';
     return text.split('\n').map(line => {
         // Headers
         if (line.startsWith('### '))
-            return chalk_1.default.bold.hex('#4CAF50')('  ' + line.substring(4));
+            return chalk.bold.hex('#4CAF50')('  ' + line.substring(4));
         if (line.startsWith('## '))
-            return chalk_1.default.bold.hex('#4CAF50')('  ' + line.substring(3));
+            return chalk.bold.hex('#4CAF50')('  ' + line.substring(3));
         if (line.startsWith('# '))
-            return chalk_1.default.bold.hex('#4CAF50')('  ' + line.substring(2));
+            return chalk.bold.hex('#4CAF50')('  ' + line.substring(2));
         // Bold
-        line = line.replace(/\*\*(.*?)\*\*/g, (_, text) => chalk_1.default.bold(text));
+        line = line.replace(/\*\*(.*?)\*\*/g, (_, text) => chalk.bold(text));
         // Italic
-        line = line.replace(/\*(.*?)\*/g, (_, text) => chalk_1.default.italic(text));
+        line = line.replace(/\*(.*?)\*/g, (_, text) => chalk.italic(text));
         // Code inline
-        line = line.replace(/`(.*?)`/g, (_, text) => chalk_1.default.hex('#FFA726')(text));
+        line = line.replace(/`(.*?)`/g, (_, text) => chalk.hex('#FFA726')(text));
         // List items
         if (line.match(/^\s*[-*]\s/)) {
-            return chalk_1.default.white('  ' + line.replace(/^\s*[-*]\s/, '  • '));
+            return chalk.white('  ' + line.replace(/^\s*[-*]\s/, '  • '));
         }
         // Numbered lists
         if (line.match(/^\s*\d+\.\s/)) {
-            return chalk_1.default.white('  ' + line);
+            return chalk.white('  ' + line);
         }
-        return chalk_1.default.white('  ' + line);
+        return chalk.white('  ' + line);
     }).join('\n');
 }