plazbot-cli 0.2.26 → 0.3.2

package/dist/commands/agent/monitor.js

@@ -1,16 +1,11 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.monitorCommand = 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 chalk_1 = __importDefault(require("chalk"));
-const readline_1 = __importDefault(require("readline"));
-const signalr_1 = require("@microsoft/signalr");
+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 chalk from 'chalk';
+import readline from 'readline';
+import { HubConnectionBuilder, HttpTransportType, HubConnectionState } from '@microsoft/signalr';
 // Colores por tipo de evento (mismos del MonitorTab frontend)
 const EVENT_COLORS = {
     msg_in: { color: '#22d3ee', label: 'msg_in' },
@@ -36,7 +31,7 @@ function getBaseUrl(zone, dev) {
 function formatTimestamp(ts) {
     try {
         const d = new Date(ts);
-        return d.toLocaleTimeString('es-ES', { hour: '2-digit', minute: '2-digit', second: '2-digit' });
+        return d.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', second: '2-digit' });
     }
     catch {
         return ts.substring(11, 19);
@@ -58,19 +53,19 @@ function renderLogLine(log, opts, lastSessionId) {
         return JSON.stringify(log);
     }
     const config = EVENT_COLORS[log.event_type] || DEFAULT_EVENT_COLOR;
-    const colorFn = chalk_1.default.hex(config.color);
-    const grayFn = chalk_1.default.hex('#71717a');
-    const dimFn = chalk_1.default.hex('#52525b');
+    const colorFn = chalk.hex(config.color);
+    const grayFn = chalk.hex('#71717a');
+    const dimFn = chalk.hex('#52525b');
     let lines = [];
     // Separador de sesion
     if (lastSessionId && log.session_id && log.session_id !== lastSessionId) {
-        lines.push(dimFn('  ' + '─'.repeat(16) + ' nueva sesion ' + '─'.repeat(16)));
+        lines.push(dimFn('  ' + '─'.repeat(16) + ' new session ' + '─'.repeat(16)));
     }
     // Linea principal
     const timestamp = grayFn(formatTimestamp(log.timestamp));
     const dot = colorFn('●');
     const eventType = colorFn(config.label.padEnd(14));
-    const title = chalk_1.default.white(truncate(log.event_title, 80));
+    const title = chalk.white(truncate(log.event_title, 80));
     const duration = log.duration_ms > 0 ? dimFn(` ${log.duration_ms}ms`) : '';
     const session = opts.showSession && log.session_id
         ? dimFn(` [${shortSession(log.session_id)}]`)
@@ -78,74 +73,74 @@ function renderLogLine(log, opts, lastSessionId) {
     lines.push(`  ${timestamp}  ${dot} ${eventType} ${title}${duration}${session}`);
     // Linea de contacto para mensajes
     if (log.contact_name && (log.event_type === 'msg_in' || log.event_type === 'msg_out')) {
-        lines.push(dimFn('                     | contacto: ') + dimFn(log.contact_name));
+        lines.push(dimFn('                     | contact: ') + dimFn(log.contact_name));
     }
     return lines.join('\n');
 }
 function printHeader(agentName) {
     console.log();
-    console.log(chalk_1.default.hex('#4CAF50')('  ┌' + '─'.repeat(62) + '┐'));
-    console.log(chalk_1.default.hex('#4CAF50')('  │') +
-        chalk_1.default.bold(`  Monitor`) +
-        chalk_1.default.hex('#4ade80')('  ● En vivo') +
-        ' '.repeat(38) +
-        chalk_1.default.hex('#4CAF50')('│'));
-    console.log(chalk_1.default.hex('#4CAF50')('  │') +
-        chalk_1.default.gray(`  Agente: ${truncate(agentName, 44)}`) +
-        ' '.repeat(Math.max(0, 49 - agentName.length)) +
-        chalk_1.default.hex('#4CAF50')('│'));
-    console.log(chalk_1.default.hex('#4CAF50')('  │') +
-        chalk_1.default.gray('  Ctrl+C salir | /filter <tipo> | /clear | /help') +
-        ' '.repeat(12) +
-        chalk_1.default.hex('#4CAF50')('│'));
-    console.log(chalk_1.default.hex('#4CAF50')('  └' + '─'.repeat(62) + '┘'));
+    console.log(chalk.hex('#4CAF50')('  ┌' + '─'.repeat(62) + '┐'));
+    console.log(chalk.hex('#4CAF50')('  │') +
+        chalk.bold(`  Monitor`) +
+        chalk.hex('#4ade80')('  ● Live') +
+        ' '.repeat(42) +
+        chalk.hex('#4CAF50')('│'));
+    console.log(chalk.hex('#4CAF50')('  │') +
+        chalk.gray(`  Agent: ${truncate(agentName, 44)}`) +
+        ' '.repeat(Math.max(0, 50 - agentName.length)) +
+        chalk.hex('#4CAF50')('│'));
+    console.log(chalk.hex('#4CAF50')('  │') +
+        chalk.gray('  Ctrl+C exit | /filter <type> | /clear | /help') +
+        ' '.repeat(13) +
+        chalk.hex('#4CAF50')('│'));
+    console.log(chalk.hex('#4CAF50')('  └' + '─'.repeat(62) + '┘'));
     console.log();
 }
 const COMMANDS_HELP = `
-  ${chalk_1.default.bold('Comandos disponibles:')}
-  ${chalk_1.default.hex('#4CAF50')('/filter <tipo>')}   Toggle filtro por tipo (ej: msg_in, error, tool_call)
-  ${chalk_1.default.hex('#4CAF50')('/filter clear')}    Quitar todos los filtros
-  ${chalk_1.default.hex('#4CAF50')('/filters')}         Mostrar filtros activos
-  ${chalk_1.default.hex('#4CAF50')('/clear')}           Limpiar pantalla
-  ${chalk_1.default.hex('#4CAF50')('/json')}            Toggle modo JSON expandido
-  ${chalk_1.default.hex('#4CAF50')('/help')}            Mostrar estos comandos
+  ${chalk.bold('Available commands:')}
+  ${chalk.hex('#4CAF50')('/filter <type>')}   Toggle filter by type (e.g. msg_in, error, tool_call)
+  ${chalk.hex('#4CAF50')('/filter clear')}    Remove all filters
+  ${chalk.hex('#4CAF50')('/filters')}         Show active filters
+  ${chalk.hex('#4CAF50')('/clear')}           Clear screen
+  ${chalk.hex('#4CAF50')('/json')}            Toggle expanded JSON mode
+  ${chalk.hex('#4CAF50')('/help')}            Show these commands
 
-  ${chalk_1.default.bold('Tipos de evento:')}
-  ${Object.entries(EVENT_COLORS).map(([key, val]) => `  ${chalk_1.default.hex(val.color)('●')} ${key}`).join('\n')}
+  ${chalk.bold('Event types:')}
+  ${Object.entries(EVENT_COLORS).map(([key, val]) => `  ${chalk.hex(val.color)('●')} ${key}`).join('\n')}
 `;
-exports.monitorCommand = new commander_1.Command('monitor')
-    .description('Monitor en tiempo real de un agente (logs via SignalR)')
-    .requiredOption('-a, --agent-id <id>', 'ID del agente')
-    .option('-f, --filter <types>', 'Filtrar por tipos separados por coma (ej: msg_in,msg_out)')
-    .option('--no-session', 'Ocultar session ID')
-    .option('--json', 'Modo JSON crudo (para piping)', false)
-    .option('-w, --workspace <id>', 'Workspace ID (sobreescribe config local)')
-    .option('-z, --zone <zone>', 'Zona LA o EU (sobreescribe config local)')
-    .option('--dev', 'Usar ambiente de desarrollo', false)
-    .action(async (options) => {
+export const monitorCommand = new Command('monitor')
+    .description('Real-time agent monitor (logs via SignalR)')
+    .argument('<agentId>', 'Agent ID')
+    .option('-f, --filter <types>', 'Filter by comma-separated types (e.g. msg_in,msg_out)')
+    .option('--no-session', 'Hide session ID')
+    .option('--json', 'Raw JSON mode (for piping)', false)
+    .option('-w, --workspace <id>', 'Workspace ID (overrides local config)')
+    .option('-z, --zone <zone>', 'Zone LA or EU (overrides local config)')
+    .option('--dev', 'Use development environment', false)
+    .action(async (agentId, options) => {
     try {
-        const credentials = await (0, credentials_1.getStoredCredentials)();
+        const credentials = await getStoredCredentials();
         const effectiveWorkspace = options.workspace || credentials.workspace;
         const effectiveZone = (options.zone?.toUpperCase() === 'EU' ? 'EU' : options.zone?.toUpperCase() === 'LA' ? 'LA' : credentials.zone);
         const baseUrl = getBaseUrl(effectiveZone, options.dev);
         if (options.workspace || options.zone) {
-            console.log(chalk_1.default.hex('#FFA726')(`\n  Modo soporte: workspace=${effectiveWorkspace} zona=${effectiveZone}`));
+            console.log(chalk.hex('#FFA726')(`\n  Support mode: workspace=${effectiveWorkspace} zone=${effectiveZone}`));
         }
         // Filtros iniciales
         const activeFilters = new Set(options.filter ? options.filter.split(',').map(f => f.trim()) : []);
         let jsonMode = options.json;
         let lastSessionId = '';
         // Cargar info del agente
-        let agentName = 'Agente';
+        let agentName = 'Agent';
         try {
-            process.stdout.write(chalk_1.default.gray('  Conectando con agente...'));
-            const agent = new plazbot_1.Agent({
+            process.stdout.write(chalk.gray('  Connecting to agent...'));
+            const agent = new Agent({
                 workspaceId: effectiveWorkspace,
                 apiKey: credentials.apiKey,
                 zone: effectiveZone,
                 ...(options.dev && { customUrl: 'http://localhost:5090' }),
             });
-            const _res = await agent.getAgentById({ id: options.agentId });
+            const _res = await agent.getAgentById({ id: agentId });
             const info = _res.agent || _res.data || _res;
             if (info?.name)
                 agentName = info.name;
@@ -161,10 +156,10 @@ exports.monitorCommand = new commander_1.Command('monitor')
         }
         // Conectar a SignalR
         const hubUrl = `${baseUrl}/agentMonitorHub`;
-        const connection = new signalr_1.HubConnectionBuilder()
+        const connection = new HubConnectionBuilder()
             .withUrl(hubUrl, {
             skipNegotiation: true,
-            transport: signalr_1.HttpTransportType.WebSockets,
+            transport: HttpTransportType.WebSockets,
         })
             .withAutomaticReconnect([0, 2000, 5000, 10000, 30000])
             .build();
@@ -183,35 +178,35 @@ exports.monitorCommand = new commander_1.Command('monitor')
         // Eventos de conexion
         connection.onreconnecting(() => {
             if (!jsonMode) {
-                console.log(chalk_1.default.hex('#FFA726')('  ⟳ Reconectando...'));
+                console.log(chalk.hex('#FFA726')('  ⟳ Reconnecting...'));
             }
         });
         connection.onreconnected(() => {
             if (!jsonMode) {
-                console.log(chalk_1.default.hex('#4ade80')('  ● Reconectado'));
+                console.log(chalk.hex('#4ade80')('  ● Reconnected'));
             }
-            connection.invoke('JoinAgentMonitor', options.agentId).catch(() => { });
+            connection.invoke('JoinAgentMonitor', agentId).catch(() => { });
         });
         connection.onclose(() => {
             if (!jsonMode) {
-                console.log(chalk_1.default.hex('#ef4444')('  ● Desconectado'));
+                console.log(chalk.hex('#ef4444')('  ● Disconnected'));
             }
         });
         // Iniciar conexion
         try {
             await connection.start();
-            await connection.invoke('JoinAgentMonitor', options.agentId);
+            await connection.invoke('JoinAgentMonitor', agentId);
             if (!jsonMode) {
-                console.log(chalk_1.default.hex('#4ade80')('  ● Conectado al monitor en tiempo real'));
+                console.log(chalk.hex('#4ade80')('  ● Connected to real-time monitor'));
                 console.log();
             }
         }
         catch (err) {
-            logger_1.logger.error(`No se pudo conectar al monitor: ${err instanceof Error ? err.message : err}`);
+            logger.error(`Could not connect to monitor: ${err instanceof Error ? err.message : err}`);
             process.exit(1);
         }
         // readline para comandos interactivos
-        const rl = readline_1.default.createInterface({
+        const rl = readline.createInterface({
             input: process.stdin,
             output: process.stdout,
             prompt: '',
@@ -230,48 +225,48 @@ exports.monitorCommand = new commander_1.Command('monitor')
             }
             if (cmd === '/json') {
                 jsonMode = !jsonMode;
-                console.log(chalk_1.default.gray(`  Modo JSON: ${jsonMode ? 'activado' : 'desactivado'}`));
+                console.log(chalk.gray(`  JSON mode: ${jsonMode ? 'enabled' : 'disabled'}`));
                 return;
             }
             if (cmd === '/filters') {
                 if (activeFilters.size === 0) {
-                    console.log(chalk_1.default.gray('  Sin filtros activos (mostrando todos)'));
+                    console.log(chalk.gray('  No active filters (showing all)'));
                 }
                 else {
-                    console.log(chalk_1.default.gray('  Filtros activos: ') + chalk_1.default.white([...activeFilters].join(', ')));
+                    console.log(chalk.gray('  Active filters: ') + chalk.white([...activeFilters].join(', ')));
                 }
                 return;
             }
             if (cmd.startsWith('/filter ')) {
                 const filterType = cmd.substring(8).trim();
                 if (!filterType) {
-                    console.log(chalk_1.default.gray('  Uso: /filter <tipo> | /filter clear'));
+                    console.log(chalk.gray('  Usage: /filter <type> | /filter clear'));
                     return;
                 }
                 if (filterType === 'clear') {
                     activeFilters.clear();
-                    console.log(chalk_1.default.gray('  Todos los filtros removidos (mostrando todos)'));
+                    console.log(chalk.gray('  All filters cleared (showing all)'));
                     return;
                 }
                 if (activeFilters.has(filterType)) {
                     activeFilters.delete(filterType);
-                    console.log(chalk_1.default.gray(`  Filtro removido: ${filterType}`));
+                    console.log(chalk.gray(`  Filter removed: ${filterType}`));
                 }
                 else {
                     activeFilters.add(filterType);
                     const config = EVENT_COLORS[filterType];
                     if (config) {
-                        console.log(chalk_1.default.hex(config.color)(`  ● Filtro agregado: ${filterType}`));
+                        console.log(chalk.hex(config.color)(`  ● Filter added: ${filterType}`));
                     }
                     else {
-                        console.log(chalk_1.default.gray(`  Filtro agregado: ${filterType} (tipo desconocido)`));
+                        console.log(chalk.gray(`  Filter added: ${filterType} (unknown type)`));
                     }
                 }
                 if (activeFilters.size > 0) {
-                    console.log(chalk_1.default.gray('  Activos: ') + chalk_1.default.white([...activeFilters].join(', ')));
+                    console.log(chalk.gray('  Active: ') + chalk.white([...activeFilters].join(', ')));
                 }
                 else {
-                    console.log(chalk_1.default.gray('  Sin filtros (mostrando todos)'));
+                    console.log(chalk.gray('  No filters (showing all)'));
                 }
                 return;
             }
@@ -279,11 +274,11 @@ exports.monitorCommand = new commander_1.Command('monitor')
         // Cierre limpio
         const cleanup = async () => {
             if (!jsonMode) {
-                console.log(chalk_1.default.gray('\n  Cerrando monitor...'));
+                console.log(chalk.gray('\n  Closing monitor...'));
             }
             try {
-                if (connection.state === signalr_1.HubConnectionState.Connected) {
-                    await connection.invoke('LeaveAgentMonitor', options.agentId);
+                if (connection.state === HubConnectionState.Connected) {
+                    await connection.invoke('LeaveAgentMonitor', agentId);
                 }
                 await connection.stop();
             }
@@ -292,7 +287,7 @@ exports.monitorCommand = new commander_1.Command('monitor')
             }
             rl.close();
             if (!jsonMode) {
-                console.log(chalk_1.default.gray('  Monitor cerrado.\n'));
+                console.log(chalk.gray('  Monitor closed.\n'));
             }
             process.exit(0);
         };
@@ -300,8 +295,18 @@ exports.monitorCommand = new commander_1.Command('monitor')
         process.on('SIGTERM', cleanup);
     }
     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(monitorCommand, [
+    { description: 'Stream every event of an agent in real time',
+        command: 'plazbot agent monitor agt_AbcDef123' },
+    { description: 'Only show inbound/outbound messages and errors',
+        command: 'plazbot agent monitor agt_AbcDef123 -f msg_in,msg_out,error' },
+    { description: 'Emit raw JSON (one event per line) for piping to jq',
+        command: 'plazbot agent monitor agt_AbcDef123 --json' },
+    { description: 'Tail an agent from a different workspace (support mode)',
+        command: 'plazbot agent monitor agt_AbcDef123 -w wok_Other123 -z LA' },
+]);

package/dist/commands/agent/on-message.js

@@ -1,65 +1,68 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.messageCommand = 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 crypto_1 = __importDefault(require("crypto"));
-exports.messageCommand = new commander_1.Command('message')
-    .description('Envía un mensaje a un agente y obtiene su respuesta')
-    .requiredOption('-a, --agent-id <id>', 'ID del agente')
-    .requiredOption('-q, --question <text>', 'Mensaje o pregunta para el agente')
-    .option('-s, --session-id <id>', 'ID de sesión (opcional)')
-    .option('-m, --multiple-answers', 'Permitir múltiples respuestas', false)
-    .option('--dev', 'Usar ambiente de desarrollo', false)
-    .action(async (options) => {
+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 crypto from 'crypto';
+export const messageCommand = new Command('message')
+    .description('Send a message to an agent and get its response')
+    .argument('<agentId>', 'Agent ID')
+    .requiredOption('-q, --question <text>', 'Message or question for the agent')
+    .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 {
         // Obtener credenciales guardadas
-        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" })
         });
         // Generar un sessionId si no se proporcionó uno
-        const sessionId = options.sessionId || crypto_1.default.randomUUID();
-        logger_1.logger.title('Enviando mensaje al agente');
-        logger_1.logger.label('ID del agente', options.agentId);
-        logger_1.logger.label('Pregunta', options.question);
-        logger_1.logger.label('ID de sesion', sessionId);
+        const sessionId = options.sessionId || crypto.randomUUID();
+        logger.title('Sending message to agent');
+        logger.label('Agent ID', agentId);
+        logger.label('Question', options.question);
+        logger.label('Session ID', sessionId);
         if (options.multipleAnswers) {
-            logger_1.logger.info('Modo: Múltiples respuestas');
+            logger.info('Mode: Multiple answers');
         }
         const response = await agent.onMessage({
-            agentId: options.agentId,
+            agentId: agentId,
             question: options.question,
             sessionId,
             multipleAnswers: options.multipleAnswers
         });
-        logger_1.logger.title('Respuesta del Agente');
+        logger.title('Agent Response');
         console.log(response.answer);
         if (response.sources && response.sources.length > 0) {
-            logger_1.logger.title('Fuentes');
+            logger.title('Sources');
             response.sources.forEach((source) => {
-                logger_1.logger.label('Titulo', source.title || 'Sin titulo');
+                logger.label('Title', source.title || 'Untitled');
                 if (source.url)
-                    logger_1.logger.label('URL', source.url);
+                    logger.label('URL', source.url);
             });
         }
-        logger_1.logger.title('Sesion');
-        logger_1.logger.label('ID', sessionId);
+        logger.title('Session');
+        logger.label('ID', sessionId);
         if (options.dev) {
-            logger_1.logger.warning('\nAmbiente: desarrollo');
+            logger.warning('\nEnvironment: development');
         }
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : 'Error desconocido al enviar el mensaje';
-        logger_1.logger.error(message);
+        const message = error instanceof Error ? error.message : 'Unknown error while sending the message';
+        logger.error(message);
         process.exit(1);
     }
 });
+addExamples(messageCommand, [
+    { description: 'Send a one-shot question to an agent',
+        command: 'plazbot agent message agt_AbcDef123 -q "What plans do you offer?"' },
+    { description: 'Continue an existing session',
+        command: 'plazbot agent message agt_AbcDef123 -q "And the price?" -s sess_AbcDef123' },
+    { description: 'Allow multiple answers per turn',
+        command: 'plazbot agent message agt_AbcDef123 -q "Tell me everything" -m' },
+]);