plazbot-cli 0.3.6 → 0.4.0

package/src/commands/agent/monitor.ts

@@ -1,375 +0,0 @@
-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 { theme } from '../../utils/ui.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: Record<string, { color: string; label: string }> = {
-  msg_in:        { color: '#22d3ee', label: 'msg_in' },
-  msg_out:       { color: '#4ade80', label: 'msg_out' },
-  tool_call:     { color: '#c084fc', label: 'tool_call' },
-  api_req:       { color: '#fbbf24', label: 'api_req' },
-  api_res:       { color: '#fbbf24', label: 'api_res' },
-  action:        { color: '#f97316', label: 'action' },
-  rag:           { color: '#60a5fa', label: 'rag' },
-  tokens:        { color: '#94a3b8', label: 'tokens' },
-  error:         { color: '#ef4444', label: 'error' },
-  model:         { color: '#a78bfa', label: 'model' },
-  intent:        { color: '#a78bfa', label: 'intent' },
-  bot_off:       { color: '#f97316', label: 'bot_off' },
-  session_field: { color: '#a78bfa', label: 'session_field' },
-};
-
-const DEFAULT_EVENT_COLOR = { color: '#94a3b8', label: 'unknown' };
-
-interface AgentLogEvent {
-  timestamp: string;
-  workspace_id: string;
-  agent_id: string;
-  contact_id: string;
-  contact_name: string;
-  session_id: string;
-  event_type: string;
-  event_title: string;
-  event_data: string;
-  duration_ms: number;
-  level: string;
-}
-
-function getBaseUrl(zone: string, dev: boolean): string {
-  if (dev) return 'http://localhost:5090';
-  return zone === 'EU' ? 'https://apieu.plazbot.com' : 'https://api.plazbot.com';
-}
-
-function formatTimestamp(ts: string): string {
-  try {
-    const d = new Date(ts);
-    return d.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', second: '2-digit' });
-  } catch {
-    return ts.substring(11, 19);
-  }
-}
-
-function truncate(text: string, maxLen: number): string {
-  if (!text) return '';
-  return text.length > maxLen ? text.substring(0, maxLen - 3) + '...' : text;
-}
-
-function shortSession(sessionId: string): string {
-  if (!sessionId) return '';
-  return sessionId.substring(0, 6);
-}
-
-function renderLogLine(
-  log: AgentLogEvent,
-  opts: { showSession: boolean; jsonMode: boolean },
-  lastSessionId: string
-): string {
-  // Modo JSON crudo
-  if (opts.jsonMode) {
-    return JSON.stringify(log);
-  }
-
-  const config = EVENT_COLORS[log.event_type] || DEFAULT_EVENT_COLOR;
-  const colorFn = chalk.hex(config.color);
-  const grayFn = chalk.hex('#71717a');
-  const dimFn = chalk.hex('#52525b');
-
-  let lines: string[] = [];
-
-  // Separador de sesion
-  if (lastSessionId && log.session_id && log.session_id !== lastSessionId) {
-    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.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)}]`)
-    : '';
-
-  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('                     | contact: ') + dimFn(log.contact_name));
-  }
-
-  return lines.join('\n');
-}
-
-function printHeader(agentName: string) {
-  console.log();
-  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.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.bold('Event types:')}
-  ${Object.entries(EVENT_COLORS).map(([key, val]) =>
-    `  ${chalk.hex(val.color)('●')} ${key}`
-  ).join('\n')}
-`;
-
-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: string, options: {
-    filter?: string;
-    session: boolean;
-    json: boolean;
-    workspace?: string;
-    zone?: string;
-    dev: boolean;
-  }) => {
-    try {
-      const credentials = await getStoredCredentials();
-
-      const effectiveWorkspace = options.workspace || credentials.workspace;
-      const effectiveZone = (options.zone?.toUpperCase() === 'EU' ? 'EU' : options.zone?.toUpperCase() === 'LA' ? 'LA' : credentials.zone) as 'LA' | 'EU';
-      const baseUrl = getBaseUrl(effectiveZone, options.dev);
-
-      if (options.workspace || options.zone) {
-        console.log(chalk.hex('#FFA726')(`\n  Support mode: workspace=${effectiveWorkspace} zone=${effectiveZone}`));
-      }
-
-      // Filtros iniciales
-      const activeFilters: Set<string> = new Set(
-        options.filter ? options.filter.split(',').map(f => f.trim()) : []
-      );
-      let jsonMode = options.json;
-      let lastSessionId = '';
-
-      // Cargar info del agente
-      let agentName = 'Agent';
-      try {
-        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: any = await agent.getAgentById({ id: agentId });
-        const info = _res.agent || _res.data || _res;
-        if (info?.name) agentName = info.name;
-        process.stdout.write('\r' + ' '.repeat(40) + '\r');
-      } catch {
-        process.stdout.write('\r' + ' '.repeat(40) + '\r');
-      }
-
-      // Dibujar header
-      if (!jsonMode) {
-        console.clear();
-        printHeader(agentName);
-      }
-
-      // Conectar a SignalR
-      const hubUrl = `${baseUrl}/agentMonitorHub`;
-      const connection = new HubConnectionBuilder()
-        .withUrl(hubUrl, {
-          skipNegotiation: true,
-          transport: HttpTransportType.WebSockets,
-        })
-        .withAutomaticReconnect([0, 2000, 5000, 10000, 30000])
-        .build();
-
-      // Evento de log
-      connection.on('agent_log', (log: AgentLogEvent) => {
-        // Aplicar filtros
-        if (activeFilters.size > 0 && !activeFilters.has(log.event_type)) return;
-
-        const line = renderLogLine(log, {
-          showSession: options.session,
-          jsonMode,
-        }, lastSessionId);
-
-        console.log(line);
-        lastSessionId = log.session_id || lastSessionId;
-      });
-
-      // Eventos de conexion
-      connection.onreconnecting(() => {
-        if (!jsonMode) {
-          console.log(chalk.hex('#FFA726')('  ⟳ Reconnecting...'));
-        }
-      });
-
-      connection.onreconnected(() => {
-        if (!jsonMode) {
-          console.log(chalk.hex('#4ade80')('  ● Reconnected'));
-        }
-        connection.invoke('JoinAgentMonitor', agentId).catch(() => {});
-      });
-
-      connection.onclose(() => {
-        if (!jsonMode) {
-          console.log(chalk.hex('#ef4444')('  ● Disconnected'));
-        }
-      });
-
-      // Iniciar conexion
-      try {
-        await connection.start();
-        await connection.invoke('JoinAgentMonitor', agentId);
-        if (!jsonMode) {
-          console.log(chalk.hex('#4ade80')('  ● Connected to real-time monitor'));
-          console.log();
-        }
-      } catch (err) {
-        logger.error(`Could not connect to monitor: ${err instanceof Error ? err.message : err}`);
-        process.exit(1);
-      }
-
-      // readline para comandos interactivos
-      const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-        prompt: '',
-      });
-
-      // No mostrar prompt para no interferir con el stream
-      rl.on('line', (input: string) => {
-        const cmd = input.trim().toLowerCase();
-
-        if (cmd === '/help') {
-          console.log(COMMANDS_HELP);
-          return;
-        }
-
-        if (cmd === '/clear') {
-          console.clear();
-          printHeader(agentName);
-          return;
-        }
-
-        if (cmd === '/json') {
-          jsonMode = !jsonMode;
-          console.log(chalk.gray(`  JSON mode: ${jsonMode ? 'enabled' : 'disabled'}`));
-          return;
-        }
-
-        if (cmd === '/filters') {
-          if (activeFilters.size === 0) {
-            console.log(chalk.gray('  No active filters (showing all)'));
-          } else {
-            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.gray('  Usage: /filter <type> | /filter clear'));
-            return;
-          }
-          if (filterType === 'clear') {
-            activeFilters.clear();
-            console.log(chalk.gray('  All filters cleared (showing all)'));
-            return;
-          }
-          if (activeFilters.has(filterType)) {
-            activeFilters.delete(filterType);
-            console.log(chalk.gray(`  Filter removed: ${filterType}`));
-          } else {
-            activeFilters.add(filterType);
-            const config = EVENT_COLORS[filterType];
-            if (config) {
-              console.log(chalk.hex(config.color)(`  ● Filter added: ${filterType}`));
-            } else {
-              console.log(chalk.gray(`  Filter added: ${filterType} (unknown type)`));
-            }
-          }
-          if (activeFilters.size > 0) {
-            console.log(chalk.gray('  Active: ') + chalk.white([...activeFilters].join(', ')));
-          } else {
-            console.log(chalk.gray('  No filters (showing all)'));
-          }
-          return;
-        }
-      });
-
-      // Cierre limpio
-      const cleanup = async () => {
-        if (!jsonMode) {
-          console.log(chalk.gray('\n  Closing monitor...'));
-        }
-        try {
-          if (connection.state === HubConnectionState.Connected) {
-            await connection.invoke('LeaveAgentMonitor', agentId);
-          }
-          await connection.stop();
-        } catch {
-          // Ignorar errores al cerrar
-        }
-        rl.close();
-        if (!jsonMode) {
-          console.log(chalk.gray('  Monitor closed.\n'));
-        }
-        process.exit(0);
-      };
-
-      process.on('SIGINT', cleanup);
-      process.on('SIGTERM', cleanup);
-
-    } catch (error) {
-      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/src/commands/agent/on-message.ts

@@ -1,82 +0,0 @@
-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 { AgentCommandOptions, AgentResponse, AgentSource } from '../../types/agent.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: string, options: AgentCommandOptions & {
-    question: string;
-    sessionId?: string;
-    multipleAnswers?: boolean;
-  }) => {
-    try {
-      // Obtener credenciales guardadas
-      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.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.info('Mode: Multiple answers');
-      }
-
-      const response = await agent.onMessage({
-        agentId: agentId,
-        question: options.question,
-        sessionId,
-        multipleAnswers: options.multipleAnswers
-      }) as AgentResponse;
-
-      logger.title('Agent Response');
-      console.log(response.answer);
-
-      if (response.sources && response.sources.length > 0) {
-        logger.title('Sources');
-        response.sources.forEach((source: AgentSource) => {
-          logger.label('Title', source.title || 'Untitled');
-          if (source.url) logger.label('URL', source.url);
-        });
-      }
-
-      logger.title('Session');
-      logger.label('ID', sessionId);
-
-      if (options.dev) {
-        logger.warning('\nEnvironment: development');
-      }
-
-    } catch (error) {
-      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' },
-]);

package/src/commands/agent/set.ts

@@ -1,149 +0,0 @@
-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 { createSpinner, theme, section, kvPair } from '../../utils/ui.js';
-import { AgentCommandOptions } from '../../types/agent.js';
-
-const setGroup = new Command('set')
-  .description('Quickly configure agent properties');
-
-addExamples(setGroup, [
-  { description: 'Replace the agent greeting',
-    command: 'plazbot agent set greeting agt_AbcDef123 "Hi! How can I help you today?"' },
-  { description: 'Configure tone, style, language, etc. interactively',
-    command: 'plazbot agent set instructions agt_AbcDef123' },
-  { description: 'Define the agent persona (name, role, voice)',
-    command: 'plazbot agent set persona agt_AbcDef123' },
-]);
-
-// Set greeting
-setGroup.command('greeting')
-  .description('Change the agent greeting')
-  .argument('<agentId>', 'Agent ID')
-  .argument('<greeting>', 'New greeting')
-  .option('--dev', 'Use development environment', false)
-  .action(async (agentId: string, greeting: string, options: AgentCommandOptions) => {
-    try {
-      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 = createSpinner('Updating greeting...');
-      spinner.start();
-      await agent.setGreeting(agentId, greeting);
-      spinner.succeed('Greeting updated');
-      logger.label('New greeting', greeting);
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-// Set instructions (wizard)
-setGroup.command('instructions')
-  .description('Configure agent instructions')
-  .argument('<agentId>', 'Agent ID')
-  .option('--dev', 'Use development environment', false)
-  .action(async (agentId: string, options: AgentCommandOptions) => {
-    try {
-      const credentials = await getStoredCredentials();
-      const agent = new Agent({
-        workspaceId: credentials.workspace,
-        apiKey: credentials.apiKey,
-        zone: credentials.zone,
-        ...(options.dev && { customUrl: "http://localhost:5090" })
-      });
-
-      // Cargar instrucciones actuales
-      const loadSpinner = createSpinner('Loading...');
-      loadSpinner.start();
-      const _res1: any = await agent.getAgentById({ id: agentId });
-      const agentData = _res1.agent || _res1.data || _res1;
-      loadSpinner.stop();
-
-      const current = agentData.instructions || {};
-      console.log(section('Instructions - ' + (agentData.name || agentId)));
-
-      const answers = await (inquirer as any).prompt([
-        { type: 'list', name: 'tone', message: 'Tone:', choices: ['profesional', 'amigable', 'formal', 'casual', 'tecnico', 'empatico'], default: current.tone || 'profesional' },
-        { type: 'list', name: 'style', message: 'Style:', choices: ['conciso', 'detallado', 'conversacional', 'directo'], default: current.style || 'conciso' },
-        { type: 'input', name: 'personality', message: 'Personality:', default: current.personality || '' },
-        { type: 'input', name: 'objective', message: 'Objective:', default: current.objective || '' },
-        { type: 'list', name: 'language', message: 'Language:', choices: ['Espanol', 'English', 'Portugues'], default: current.language || 'Espanol' },
-        { type: 'confirm', name: 'emojis', message: 'Use emojis?', default: current.emojis === true },
-      ]);
-
-      const instructions = {
-        ...current,
-        tone: answers.tone,
-        style: answers.style,
-        personality: answers.personality,
-        objective: answers.objective,
-        language: answers.language,
-        emojis: answers.emojis,
-      };
-
-      const spinner = createSpinner('Saving instructions...');
-      spinner.start();
-      await agent.setInstructions(agentId, instructions);
-      spinner.succeed('Instructions updated');
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-// Set persona (wizard)
-setGroup.command('persona')
-  .description('Configure the agent persona')
-  .argument('<agentId>', 'Agent ID')
-  .option('--dev', 'Use development environment', false)
-  .action(async (agentId: string, options: AgentCommandOptions) => {
-    try {
-      const credentials = await getStoredCredentials();
-      const agent = new Agent({
-        workspaceId: credentials.workspace,
-        apiKey: credentials.apiKey,
-        zone: credentials.zone,
-        ...(options.dev && { customUrl: "http://localhost:5090" })
-      });
-
-      const loadSpinner = createSpinner('Loading...');
-      loadSpinner.start();
-      const _res2: any = await agent.getAgentById({ id: agentId });
-      const agentData = _res2.agent || _res2.data || _res2;
-      loadSpinner.stop();
-
-      const current = agentData.person || {};
-      console.log(section('Persona - ' + (agentData.name || agentId)));
-
-      const answers = await (inquirer as any).prompt([
-        { type: 'input', name: 'name', message: 'Character name:', default: current.name || '' },
-        { type: 'input', name: 'role', message: 'Role:', default: current.role || '' },
-        { type: 'confirm', name: 'speaksInFirstPerson', message: 'Speak in first person?', default: current.speaksInFirstPerson !== false },
-      ]);
-
-      const spinner = createSpinner('Saving persona...');
-      spinner.start();
-      await agent.setPersona(agentId, answers);
-      spinner.succeed('Persona updated');
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-export const setCommand = setGroup;