plazbot-cli 0.3.7 → 0.4.0

package/src/commands/agent/export.ts

@@ -1,430 +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 { createSpinner } from '../../utils/ui.js';
-import chalk from 'chalk';
-import fs from 'fs';
-import path from 'path';
-import inquirer from 'inquirer';
-
-// Campos validos segun el schema de agentValidation.ts (additionalProperties: false)
-const VALID_AGENT_FIELDS = new Set([
-  'name', 'description', 'prompt', 'zone', 'timezone', 'buffer',
-  'color', 'question', 'enable', 'tags', 'showInChat',
-  'instructions', 'person', 'fallbacks', 'rules',
-  'examples', 'channels', 'services', 'actions', 'variables',
-  'useToolCalling', 'customAIConfig', 'aiProviders',
-  'responseMode', 'batchWaitSeconds',
-  'enableWidget', 'enableWhatsappWidget', 'urlWhatsappWidget',
-  'formWidget', 'darkWidget', 'nameWidget', 'initialShowWidget',
-  'fUseAutomationFlowWidget', 'iconWidget',
-  'enableAvatarWidget', 'avatarGender', 'avatarVoiceId', 'avatarLanguage',
-]);
-
-// Campos que el schema espera como string (no pueden ser null)
-const STRING_FIELDS = new Set([
-  'name', 'description', 'prompt', 'zone', 'timezone', 'color',
-  'question', 'responseMode', 'iconWidget', 'avatarGender',
-  'avatarVoiceId', 'avatarLanguage', 'urlWhatsappWidget', 'nameWidget',
-]);
-
-// Campos que el schema espera como array (no pueden ser null)
-const ARRAY_FIELDS = new Set([
-  'tags', 'examples', 'channels', 'services', 'actions', 'aiProviders', 'variables',
-]);
-
-function cleanRequiredFields(fields: any): any[] {
-  if (!fields || !Array.isArray(fields)) return [];
-  return fields.map((f: any) => {
-    const clean: any = {};
-    if (f.name) clean.name = f.name;
-    if (f.description) clean.description = f.description;
-    if (f.promptHint) clean.promptHint = f.promptHint;
-    if (f.type) clean.type = f.type;
-    // properties debe ser array o no existir
-    if (f.properties && Array.isArray(f.properties)) {
-      clean.properties = f.properties.map((p: any) => ({
-        name: p.name || '',
-        type: p.type || 'string',
-      }));
-    }
-    // Si properties es null o no es array, no incluirlo
-    return clean;
-  });
-}
-
-function cleanServices(services: any): any[] {
-  if (!services || !Array.isArray(services)) return [];
-  return services.map((svc: any) => {
-    const clean: any = {
-      intent: svc.intent || '',
-      reference: svc.reference || '',
-      enabled: svc.enabled ?? true,
-      method: svc.method || 'GET',
-      endpoint: svc.endpoint || '',
-      requiredFields: cleanRequiredFields(svc.requiredFields),
-    };
-    if (svc.tags && Array.isArray(svc.tags)) clean.tags = svc.tags;
-    if (svc.headers && typeof svc.headers === 'object') clean.headers = svc.headers;
-    if (svc.bodyTemplate && typeof svc.bodyTemplate === 'object') clean.bodyTemplate = svc.bodyTemplate;
-    if (svc.bodySchema && typeof svc.bodySchema === 'object') clean.bodySchema = svc.bodySchema;
-    if (svc.responseMapping && typeof svc.responseMapping === 'object') clean.responseMapping = svc.responseMapping;
-    if (typeof svc.responseMessage === 'string') clean.responseMessage = svc.responseMessage;
-    if (svc.responseConditions && Array.isArray(svc.responseConditions)) {
-      clean.responseConditions = svc.responseConditions.map((rc: any) => {
-        const c: any = { condition: rc.condition || '' };
-        if (typeof rc.message === 'string') c.message = rc.message;
-        if (typeof rc.nextService === 'string') c.nextService = rc.nextService;
-        return c;
-      });
-    }
-    if (typeof svc.action === 'string') clean.action = svc.action;
-    return clean;
-  });
-}
-
-function cleanActions(actions: any): any[] {
-  if (!actions || !Array.isArray(actions)) return [];
-  return actions.map((act: any) => {
-    const clean: any = {
-      intent: act.intent || '',
-      reference: act.reference || '',
-      enabled: act.enabled ?? true,
-      action: Array.isArray(act.action) ? act.action.map((a: any) => ({
-        type: a.type || '',
-        value: a.value ?? '',
-      })) : [],
-    };
-    if (act.tags && Array.isArray(act.tags)) clean.tags = act.tags;
-    clean.requiredFields = cleanRequiredFields(act.requiredFields);
-    if (typeof act.responseMessage === 'string') clean.responseMessage = act.responseMessage;
-    if (typeof act.responseJson === 'boolean') clean.responseJson = act.responseJson;
-    return clean;
-  });
-}
-
-function cleanVariables(variables: any): any[] {
-  if (!variables || !Array.isArray(variables)) return [];
-  return variables
-    .filter((v: any) => v && v.code && v.name && v.type)
-    .map((v: any) => {
-      const clean: any = {
-        code: v.code,
-        name: v.name,
-        type: v.type,
-      };
-      if (v.defaultValue !== undefined && v.defaultValue !== null && v.defaultValue !== '') {
-        clean.defaultValue = String(v.defaultValue);
-      }
-      if (v.description !== undefined && v.description !== null && v.description !== '') {
-        clean.description = v.description;
-      }
-      return clean;
-    });
-}
-
-function cleanAgentForExport(agentData: any): any {
-  const cleaned: any = {};
-
-  for (const key of Object.keys(agentData)) {
-    if (!VALID_AGENT_FIELDS.has(key)) continue;
-
-    const value = agentData[key];
-
-    // Eliminar campos null en campos string
-    if (STRING_FIELDS.has(key)) {
-      if (value !== null && value !== undefined) {
-        cleaned[key] = String(value);
-      }
-      continue;
-    }
-
-    // Asegurar que campos array sean arrays
-    if (ARRAY_FIELDS.has(key)) {
-      if (key === 'services') {
-        cleaned[key] = cleanServices(value);
-      } else if (key === 'actions') {
-        cleaned[key] = cleanActions(value);
-      } else if (key === 'variables') {
-        cleaned[key] = cleanVariables(value);
-      } else if (Array.isArray(value)) {
-        cleaned[key] = value;
-      } else {
-        cleaned[key] = [];
-      }
-      continue;
-    }
-
-    // Eliminar nulls genericos
-    if (value !== null && value !== undefined) {
-      cleaned[key] = value;
-    }
-  }
-
-  // Limpiar channels
-  if (cleaned.channels && Array.isArray(cleaned.channels)) {
-    cleaned.channels = cleaned.channels.map((ch: any) => ({
-      channel: ch.channel || '',
-      key: ch.key || '',
-      multianswer: ch.multianswer || false,
-    }));
-  }
-
-  // Limpiar aiProviders
-  if (cleaned.aiProviders && Array.isArray(cleaned.aiProviders)) {
-    cleaned.aiProviders = cleaned.aiProviders.map((ai: any) => ({
-      provider: ai.provider,
-      model: ai.model,
-      apiToken: ai.apiToken || '',
-      temperature: ai.temperature,
-      maxTokens: ai.maxTokens,
-      isDefault: ai.isDefault,
-    }));
-  }
-
-  // Limpiar examples
-  if (cleaned.examples && Array.isArray(cleaned.examples)) {
-    cleaned.examples = cleaned.examples.map((ex: any) => ({
-      value: ex.value || '',
-      color: ex.color || 'blue',
-    }));
-  }
-
-  return cleaned;
-}
-
-export const exportCommand = new Command('export')
-  .description('Export a clean agent configuration (compatible with import)')
-  .argument('<agentId>', 'Agent ID to export')
-  .option('-w, --workspace <id>', 'Source workspace ID (overrides local config)')
-  .option('-z, --zone <zone>', 'Zone LA or EU (overrides local config)')
-  .option('-o, --output <path>', 'Output file path (.json)')
-  .option('--no-channels', 'Exclude channels from export')
-  .option('--no-ai', 'Exclude custom AI configuration')
-  .option('--dev', 'Use development environment', false)
-  .action(async (agentId: string, options: {
-    workspace?: string;
-    zone?: string;
-    output?: string;
-    channels: boolean;
-    ai: boolean;
-    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';
-
-      if (options.workspace || options.zone) {
-        console.log(chalk.hex('#FFA726')(`\n  Support mode: workspace=${effectiveWorkspace} zone=${effectiveZone}`));
-      }
-
-      const agent = new Agent({
-        workspaceId: effectiveWorkspace,
-        apiKey: credentials.apiKey,
-        zone: effectiveZone,
-        ...(options.dev && { customUrl: 'http://localhost:5090' }),
-      });
-
-      const spinner = createSpinner('Fetching agent...');
-      spinner.start();
-
-      const response: any = await agent.getAgentById({ id: agentId });
-      const agentData = response.agent || response.data || response;
-
-      spinner.succeed('Agent fetched');
-
-      // Limpiar para exportacion
-      const cleaned = cleanAgentForExport(agentData);
-
-      // Aplicar opciones de exclusion
-      if (!options.channels) {
-        delete cleaned.channels;
-      }
-
-      if (!options.ai) {
-        cleaned.customAIConfig = false;
-        delete cleaned.aiProviders;
-      }
-
-      const jsonOutput = JSON.stringify(cleaned, null, 2);
-
-      // Guardar en archivo o mostrar en consola
-      if (options.output) {
-        const outputPath = path.resolve(options.output);
-        fs.writeFileSync(outputPath, jsonOutput, 'utf-8');
-        console.log(chalk.hex('#4ade80')(`\n  Exported to: ${outputPath}`));
-      } else {
-        console.log();
-        console.log(jsonOutput);
-      }
-
-      console.log();
-      console.log(chalk.gray('  This JSON is compatible with:'));
-      console.log(chalk.gray('  - plazbot agent create <file.json>'));
-      console.log(chalk.gray('  - Importing JSON in the platform (AgentTraining)'));
-      console.log();
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-addExamples(exportCommand, [
-  { description: 'Print the cleaned JSON to stdout',
-    command: 'plazbot agent export agt_AbcDef123' },
-  { description: 'Write the cleaned JSON to a file',
-    command: 'plazbot agent export agt_AbcDef123 -o ./agent.json' },
-  { description: 'Export without channels nor AI credentials (portable JSON)',
-    command: 'plazbot agent export agt_AbcDef123 -o ./agent.json --no-channels --no-ai' },
-  { description: 'Export from a different workspace (support mode)',
-    command: 'plazbot agent export agt_AbcDef123 -w wok_Other123 -z LA -o ./agent.json' },
-]);
-
-export const crossCopyCommand = new Command('cross-copy')
-  .description('Copy an agent from one workspace to another')
-  .argument('<agentId>', 'Agent ID to copy')
-  .requiredOption('--from-workspace <id>', 'Source workspace ID')
-  .requiredOption('--to-workspace <id>', 'Target workspace ID')
-  .option('--from-zone <zone>', 'Source workspace zone (LA or EU)', 'LA')
-  .option('--to-zone <zone>', 'Target workspace zone (LA or EU)', 'LA')
-  .option('--no-channels', 'Do not copy channels (recommended)')
-  .option('--no-ai', 'Do not copy custom AI configuration')
-  .option('--dev', 'Use development environment', false)
-  .action(async (agentId: string, options: {
-    fromWorkspace: string;
-    toWorkspace: string;
-    fromZone: string;
-    toZone: string;
-    channels: boolean;
-    ai: boolean;
-    dev: boolean;
-  }) => {
-    try {
-      const credentials = await getStoredCredentials();
-      const fromZone = (options.fromZone.toUpperCase() === 'EU' ? 'EU' : 'LA') as 'LA' | 'EU';
-      const toZone = (options.toZone.toUpperCase() === 'EU' ? 'EU' : 'LA') as 'LA' | 'EU';
-
-      console.log();
-      console.log(chalk.hex('#4CAF50')('  ┌' + '─'.repeat(58) + '┐'));
-      console.log(chalk.hex('#4CAF50')('  │') + chalk.bold('  Copy agent between workspaces').padEnd(68) + chalk.hex('#4CAF50')('│'));
-      console.log(chalk.hex('#4CAF50')('  └' + '─'.repeat(58) + '┘'));
-      console.log();
-      console.log(chalk.gray(`  Source: ${options.fromWorkspace} (${fromZone})`));
-      console.log(chalk.gray(`  Target: ${options.toWorkspace} (${toZone})`));
-      console.log(chalk.gray(`  Agent:  ${agentId}`));
-      console.log();
-
-      // 1. Obtener agente del workspace origen
-      const spinnerGet = createSpinner('Fetching agent from source workspace...');
-      spinnerGet.start();
-
-      const sourceAgent = new Agent({
-        workspaceId: options.fromWorkspace,
-        apiKey: credentials.apiKey,
-        zone: fromZone,
-        ...(options.dev && { customUrl: 'http://localhost:5090' }),
-      });
-
-      const response: any = await sourceAgent.getAgentById({ id: agentId });
-      const agentData = response.agent || response.data || response;
-
-      if (!agentData || !agentData.name) {
-        spinnerGet.fail('Agent not found in source workspace');
-        process.exit(1);
-      }
-
-      spinnerGet.succeed(`Agent fetched: ${agentData.name}`);
-
-      // 2. Limpiar JSON
-      const cleaned = cleanAgentForExport(agentData);
-
-      // Ajustar zona al destino
-      cleaned.zone = toZone;
-
-      // Limpiar canales (los canales son especificos del workspace)
-      if (!options.channels) {
-        cleaned.channels = [];
-      }
-
-      // Limpiar AI config si se solicita
-      if (!options.ai) {
-        cleaned.customAIConfig = false;
-        delete cleaned.aiProviders;
-      }
-
-      // Desactivar widget (seguridad)
-      cleaned.enableWidget = false;
-
-      // 3. Mostrar resumen
-      console.log();
-      console.log(chalk.bold('  Configuration to copy:'));
-      console.log(chalk.gray(`  Name:        ${cleaned.name}`));
-      console.log(chalk.gray(`  Target zone: ${cleaned.zone}`));
-      console.log(chalk.gray(`  Channels:    ${cleaned.channels?.length || 0}`));
-      console.log(chalk.gray(`  Services:    ${cleaned.services?.length || 0}`));
-      console.log(chalk.gray(`  Actions:     ${cleaned.actions?.length || 0}`));
-      console.log(chalk.gray(`  Custom AI:   ${cleaned.customAIConfig ? 'Yes' : 'No'}`));
-      console.log();
-
-      const { confirm } = await (inquirer as any).prompt([{
-        type: 'confirm',
-        name: 'confirm',
-        message: 'Create this agent in the target workspace?',
-        default: true,
-      }]);
-
-      if (!confirm) {
-        console.log(chalk.gray('  Operation cancelled.'));
-        return;
-      }
-
-      // 4. Crear en workspace destino
-      const spinnerCreate = createSpinner('Creating agent in target workspace...');
-      spinnerCreate.start();
-
-      const targetAgent = new Agent({
-        workspaceId: options.toWorkspace,
-        apiKey: credentials.apiKey,
-        zone: toZone,
-        ...(options.dev && { customUrl: 'http://localhost:5090' }),
-      });
-
-      const result: any = await targetAgent.addAgent(cleaned);
-
-      if (result?.success === false) {
-        spinnerCreate.fail(`Error: ${result.message || 'Could not create the agent'}`);
-        process.exit(1);
-      }
-
-      const newId = result?.agentId || result?.id || result?.data?.agentId;
-      spinnerCreate.succeed('Agent created successfully');
-
-      console.log();
-      if (newId) {
-        console.log(chalk.hex('#4ade80')(`  New ID: ${newId}`));
-      }
-      console.log(chalk.gray('  Widget disabled by default.'));
-      console.log(chalk.gray('  Channels must be configured manually in the target workspace.'));
-      console.log();
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-addExamples(crossCopyCommand, [
-  { description: 'Copy an agent between two LA workspaces (skip channels)',
-    command: 'plazbot agent cross-copy agt_AbcDef123 --from-workspace wok_Source123 --to-workspace wok_Target456' },
-  { description: 'Copy across zones (LA → EU)',
-    command: 'plazbot agent cross-copy agt_AbcDef123 --from-workspace wok_Source123 --from-zone LA --to-workspace wok_Target456 --to-zone EU' },
-  { description: 'Copy preserving channels and AI providers',
-    command: 'plazbot agent cross-copy agt_AbcDef123 --from-workspace wok_Source123 --to-workspace wok_Target456 --channels --ai' },
-]);

package/src/commands/agent/files.ts

@@ -1,171 +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 { createSpinner, createTable, theme, section, statusBadge } from '../../utils/ui.js';
-import { AgentCommandOptions } from '../../types/agent.js';
-
-const filesGroup = new Command('files')
-  .description('Manage files in the agent knowledge base');
-
-addExamples(filesGroup, [
-  { description: 'List the knowledge-base files of an agent',
-    command: 'plazbot agent files list agt_AbcDef123' },
-  { description: 'Add a remote PDF/DOC to the knowledge base',
-    command: 'plazbot agent files add agt_AbcDef123 -u https://files.example.com/manual.pdf -r manual -t docs,onboarding' },
-  { description: 'Check whether a file finished processing',
-    command: 'plazbot agent files status file_AbcDef123' },
-  { description: 'Remove a file from the knowledge base',
-    command: 'plazbot agent files delete agt_AbcDef123 file_AbcDef123' },
-]);
-
-// Listar archivos
-filesGroup.command('list')
-  .description('List agent files')
-  .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 spinner = createSpinner('Loading files...');
-      spinner.start();
-      const _res: any = await agent.getAgentById({ id: agentId });
-      const agentData = _res.agent || _res.data || _res;
-      spinner.stop();
-
-      const files = (agentData as any).files || [];
-      console.log(section('Files - ' + (agentData.name || agentId)));
-
-      if (files.length === 0) {
-        console.log(theme.muted('\n  No files in the knowledge base'));
-        console.log(theme.muted('  Use: plazbot agent files add <agentId> --url <url>\n'));
-        return;
-      }
-
-      const rows = files.map((f: any) => [
-        f.fileId || f.id || 'N/A',
-        f.name || f.reference || 'Untitled',
-        (f.tags || []).join(', ') || '-',
-      ]);
-
-      console.log(createTable(['ID', 'Name', 'Tags'], rows));
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-// Agregar archivo
-filesGroup.command('add')
-  .description('Add a file to the knowledge base')
-  .argument('<agentId>', 'Agent ID')
-  .requiredOption('-u, --url <url>', 'File URL (PDF, DOC, DOCX)')
-  .option('-r, --reference <name>', 'Reference name', 'documento')
-  .option('-t, --tags <tags>', 'Comma-separated tags', '')
-  .option('--dev', 'Use development environment', false)
-  .action(async (agentId: string, options: any) => {
-    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('Uploading file...');
-      spinner.start();
-
-      const tags = options.tags ? options.tags.split(',').map((t: string) => t.trim()) : [];
-      const result = await agent.addFile({
-        fileUrl: options.url,
-        reference: options.reference,
-        agentId,
-        tags,
-      });
-
-      spinner.succeed('File added');
-
-      if (result?.fileId) {
-        logger.label('File ID', result.fileId);
-        logger.dim('The file is being processed. Check status with:');
-        logger.dim(`plazbot agent files status ${result.fileId}`);
-      }
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-// Verificar estado
-filesGroup.command('status')
-  .description('Check the processing status of a file')
-  .argument('<fileId>', 'File ID')
-  .option('--dev', 'Use development environment', false)
-  .action(async (fileId: 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('Checking...');
-      spinner.start();
-      const result = await agent.validateFile({ fileId });
-      spinner.stop();
-
-      logger.title('File status');
-      logger.label('File ID', fileId);
-      logger.label('Status', result?.status ? 'Completed' : 'Processing');
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-// Eliminar archivo
-filesGroup.command('delete')
-  .description('Delete a file from the knowledge base')
-  .argument('<agentId>', 'Agent ID')
-  .argument('<fileId>', 'File ID')
-  .option('--dev', 'Use development environment', false)
-  .action(async (agentId: string, fileId: 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('Deleting file...');
-      spinner.start();
-      await agent.deleteFile({ fileId, agentId });
-      spinner.succeed('File deleted');
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-export const filesCommand = filesGroup;