npm - plazbot-cli - Versions diffs - 0.1.2 - Mend

plazbot-cli 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (76) hide show

package/agent.config.json +21 -0
package/dist/cli.js +22 -0
package/dist/commands/agent/chat.js +92 -0
package/dist/commands/agent/create.js +52 -0
package/dist/commands/agent/delete.js +61 -0
package/dist/commands/agent/enable-widget.js +55 -0
package/dist/commands/agent/get.js +161 -0
package/dist/commands/agent/index.js +22 -0
package/dist/commands/agent/list.js +47 -0
package/dist/commands/agent/on-message.js +67 -0
package/dist/commands/agent/update.js +52 -0
package/dist/commands/auth/index.js +9 -0
package/dist/commands/auth/login.js +52 -0
package/dist/commands/auth/logout.js +23 -0
package/dist/commands/message/delete-webhook.js +39 -0
package/dist/commands/message/index.js +14 -0
package/dist/commands/message/register-webhook.js +42 -0
package/dist/commands/message/send-template.js +42 -0
package/dist/commands/message/send.js +42 -0
package/dist/commands/portal/add-agent.js +58 -0
package/dist/commands/portal/add-link.js +33 -0
package/dist/commands/portal/clear-links.js +27 -0
package/dist/commands/portal/create.js +51 -0
package/dist/commands/portal/delete.js +58 -0
package/dist/commands/portal/get.js +66 -0
package/dist/commands/portal/index.js +22 -0
package/dist/commands/portal/list.js +65 -0
package/dist/commands/portal/update.js +79 -0
package/dist/commands/whatsapp/delete-webhook.js +32 -0
package/dist/commands/whatsapp/index.js +14 -0
package/dist/commands/whatsapp/register-webhook.js +35 -0
package/dist/commands/whatsapp/send-template.js +41 -0
package/dist/commands/whatsapp/send.js +42 -0
package/dist/types/agent.js +2 -0
package/dist/types/auth.js +2 -0
package/dist/types/common.js +2 -0
package/dist/types/message.js +2 -0
package/dist/types/portal.js +2 -0
package/dist/utils/credentials.js +33 -0
package/dist/utils/logger.js +24 -0
package/package.json +47 -0
package/src/cli.ts +26 -0
package/src/commands/agent/chat.ts +103 -0
package/src/commands/agent/create.ts +53 -0
package/src/commands/agent/delete.ts +64 -0
package/src/commands/agent/enable-widget.ts +62 -0
package/src/commands/agent/get.ts +175 -0
package/src/commands/agent/index.ts +20 -0
package/src/commands/agent/list.ts +52 -0
package/src/commands/agent/on-message.ts +75 -0
package/src/commands/agent/update.ts +53 -0
package/src/commands/auth/index.ts +8 -0
package/src/commands/auth/login.ts +56 -0
package/src/commands/auth/logout.ts +22 -0
package/src/commands/portal/add-agent.ts +66 -0
package/src/commands/portal/add-link.ts +39 -0
package/src/commands/portal/clear-links.ts +26 -0
package/src/commands/portal/create.ts +55 -0
package/src/commands/portal/delete.ts +63 -0
package/src/commands/portal/get.ts +75 -0
package/src/commands/portal/index.ts +20 -0
package/src/commands/portal/list.ts +73 -0
package/src/commands/portal/update.ts +82 -0
package/src/commands/whatsapp/delete-webhook.ts +37 -0
package/src/commands/whatsapp/index.ts +12 -0
package/src/commands/whatsapp/register-webhook.ts +41 -0
package/src/commands/whatsapp/send-template.ts +44 -0
package/src/commands/whatsapp/send.ts +46 -0
package/src/types/agent.ts +63 -0
package/src/types/auth.ts +8 -0
package/src/types/common.ts +10 -0
package/src/types/message.ts +34 -0
package/src/types/portal.ts +56 -0
package/src/utils/credentials.ts +37 -0
package/src/utils/logger.ts +21 -0
package/tsconfig.json +15 -0

package/src/commands/agent/enable-widget.ts ADDED Viewed

@@ -0,0 +1,62 @@
+import { Command } from 'commander';
+import { Agent } from 'plazbot';
+import { getStoredCredentials } from '../../utils/credentials';
+import { logger } from '../../utils/logger';
+import { EnableWidgetOptions } from '../../types/agent';
+export const enableCommand = new Command('enable-widget')
+  .description('Habilita o deshabilita el widget de un agente')
+  .argument('<agentId>', 'ID del agente')
+  .option('-d, --disable', 'Deshabilitar el widget en lugar de habilitarlo')
+  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .action(async (agentId: string, options: EnableWidgetOptions) => {
+    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" })
+      });
+      // Obtener estado actual del agente
+      const agentDetails = await agent.getAgentById({ id: agentId });
+      logger.info('\n🔧 Estado actual del widget:');
+      logger.divider();
+      logger.info(`Agente: ${agentDetails.agent.name}`);
+      logger.divider();
+      // Cambiar estado
+      const newState = !options.disable; // Si --disable está presente, newState será false
+      const result = await agent.enableWidget({
+        id: agentId,
+        enable: newState
+      });
+      logger.success(`Widget ${newState ? 'habilitado' : 'deshabilitado'} exitosamente`);
+      logger.info('\n🔧 Respuesta del servidor:');
+      logger.divider();
+      logger.info(`Estado: ${result.success ? '✅ Exitoso' : '❌ Fallido'}`);
+      logger.info(`Mensaje: ${result.message}`);
+      if (newState && result.script) {
+        logger.info('\n📝 Instrucciones de instalación:');
+        logger.divider();
+        logger.info('Coloca este script debajo de la etiqueta <HEAD> en tu sitio web:');
+        logger.info('\n' + result.script);
+      }
+      if (options.dev) {
+        logger.warning('Ambiente: desarrollo');
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Error desconocido al modificar el widget';
+      logger.error(message);
+      process.exit(1);
+    }
+  });

package/src/commands/agent/get.ts ADDED Viewed

@@ -0,0 +1,175 @@
+import { Command } from 'commander';
+import { Agent } from 'plazbot';
+import { getStoredCredentials } from '../../utils/credentials';
+import { logger } from '../../utils/logger';
+import { AgentCommandOptions } from '../../types/agent';
+export const getCommand = new Command('get')
+  .description('Obtiene información detallada de un agente específico')
+  .argument('<agentId>', 'ID del agente a consultar')
+  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .action(async (agentId: string, options: AgentCommandOptions) => {
+    try {
+      // Obtener credenciales guardadas
+      const credentials = await getStoredCredentials();
+      // Crear instancia del agente con las credenciales guardadas
+      const agent = new Agent({
+        workspaceId: credentials.workspace,
+        apiKey: credentials.apiKey,
+        zone: credentials.zone,
+        ...(options.dev && { customUrl: "http://localhost:5090" })
+      });
+      // Obtener detalles del agente
+      const agentDetails = await agent.getAgentById({ id: agentId });
+      const agentData = agentDetails.agent;
+      logger.info('\nDetalles del Agente:');
+      logger.doubleDivider();
+      // Información básica
+      logger.info('Información Básica:');
+      logger.divider();
+      logger.info(`ID: ${agentData.id}`);
+      logger.info(`Nombre: ${agentData.name}`);
+      logger.info(`Descripción: ${agentData.description}`);
+      logger.info(`Estado: ${agentData.enable ? '✅ Activo' : '❌ Inactivo'}`);
+      logger.info(`Zona: ${agentData.zone}`);
+      logger.info(`Buffer: ${agentData.buffer}`);
+      logger.info(`Color: ${agentData.color}`);
+      logger.info(`Pregunta inicial: ${agentData.question}`);
+      logger.info(`Zona horaria: ${agentData.timezone}`);
+      logger.info(`Mostrar en chat: ${agentData.showInChat ? 'Sí' : 'No'}`);
+      // Tags
+      if (agentData.tags && agentData.tags.length > 0) {
+        logger.info(`\nTags: ${agentData.tags.join(', ')}`);
+      }
+      // Ejemplos
+      if (agentData.examples && agentData.examples.length > 0) {
+        logger.info('\nEjemplos:');
+        logger.divider();
+        agentData.examples.forEach((example: { value: string; color: string }) => {
+          logger.info(`- ${example.value} (${example.color})`);
+        });
+      }
+      // Instrucciones
+      if (agentData.instructions) {
+        logger.info('\nInstrucciones:');
+        logger.divider();
+        const instructions = agentData.instructions;
+        logger.info(`Tono: ${instructions.tone}`);
+        logger.info(`Estilo: ${instructions.style}`);
+        logger.info(`Personalidad: ${instructions.personality}`);
+        logger.info(`Objetivo: ${instructions.objective}`);
+        logger.info(`Idioma: ${instructions.language}`);
+        logger.info(`Emojis: ${instructions.emojis ? 'Sí' : 'No'}`);
+        logger.info(`Formato preferido: ${instructions.preferredFormat}`);
+        logger.info(`Máximo de palabras: ${instructions.maxWords}`);
+        if (instructions.avoidTopics) {
+          logger.info(`Temas a evitar: ${instructions.avoidTopics.join(', ')}`);
+        }
+        logger.info(`Responder solo si sabe: ${instructions.respondOnlyIfKnows ? 'Sí' : 'No'}`);
+        logger.info(`Mantener tono entre mensajes: ${instructions.maintainToneBetweenMessages ? 'Sí' : 'No'}`);
+        logger.info(`Saludo: ${instructions.greeting}`);
+      }
+      // Persona
+      if (agentData.person) {
+        logger.info('\nPersona:');
+        logger.divider();
+        const person = agentData.person;
+        logger.info(`Nombre: ${person.name}`);
+        logger.info(`Rol: ${person.role}`);
+        logger.info(`Habla en primera persona: ${person.speaksInFirstPerson ? 'Sí' : 'No'}`);
+        logger.info(`Es humano: ${person.isHuman ? 'Sí' : 'No'}`);
+      }
+      // Fallbacks
+      if (agentData.fallbacks) {
+        logger.info('\nFallbacks:');
+        logger.divider();
+        const fallbacks = agentData.fallbacks;
+        logger.info(`Sin respuesta: ${fallbacks.noAnswer}`);
+        logger.info(`Error de servicio: ${fallbacks.serviceError}`);
+        logger.info(`No entiende: ${fallbacks.doNotUnderstand}`);
+      }
+      // Reglas
+      if (agentData.rules) {
+        logger.info('\nReglas:');
+        logger.divider();
+        const rules = agentData.rules;
+        logger.info(`No mencionar precios: ${rules.doNotMentionPrices ? 'Sí' : 'No'}`);
+        logger.info(`No diagnosticar: ${rules.doNotDiagnose ? 'Sí' : 'No'}`);
+        if (rules.doNotRespondOutsideHours) {
+          logger.info(`Horario de atención: ${rules.doNotRespondOutsideHours}`);
+        }
+      }
+      // Servicios
+      if (agentData.services && agentData.services.length > 0) {
+        logger.info('\nServicios:');
+        logger.divider();
+        agentData.services.forEach((service: any, index: number) => {
+          logger.info(`\nServicio ${index + 1}:`);
+          logger.info(`Intent: ${service.intent}`);
+          logger.info(`Referencia: ${service.reference}`);
+          logger.info(`Habilitado: ${service.enabled ? 'Sí' : 'No'}`);
+          logger.info(`Método: ${service.method}`);
+          logger.info(`Endpoint: ${service.endpoint}`);
+          if (service.requiredFields) {
+            logger.info('Campos requeridos:');
+            service.requiredFields.forEach((field: any) => {
+              logger.info(`  - ${field.name} (${field.type}): ${field.description}`);
+            });
+          }
+        });
+      }
+      // Acciones
+      if (agentData.actions && agentData.actions.length > 0) {
+        logger.info('\nAcciones:');
+        logger.divider();
+        agentData.actions.forEach((action: any, index: number) => {
+          logger.info(`\nAcción ${index + 1}:`);
+          logger.info(`Intent: ${action.intent}`);
+          logger.info(`Referencia: ${action.reference}`);
+          logger.info(`Habilitado: ${action.enabled ? 'Sí' : 'No'}`);
+          if (action.tags) {
+            logger.info(`Tags: ${action.tags.join(', ')}`);
+          }
+          logger.info(`Mensaje de respuesta: ${action.responseMessage}`);
+          if (action.action) {
+            logger.info('Sub-acciones:');
+            action.action.forEach((subAction: any) => {
+              logger.info(`  - ${subAction.type}: ${subAction.value}`);
+            });
+          }
+        });
+      }
+      // Canales
+      if (agentData.channels && agentData.channels.length > 0) {
+        logger.info('\nCanales:');
+        logger.divider();
+        agentData.channels.forEach((channel: { channel: string; key: string }) => {
+          logger.info(`${channel.channel}: ${channel.key}`);
+        });
+      }
+      logger.doubleDivider();
+      if (options.dev) {
+        logger.warning('Ambiente: desarrollo');
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Error desconocido al obtener el agente';
+      logger.error(message);
+      process.exit(1);
+    }
+  });

package/src/commands/agent/index.ts ADDED Viewed

@@ -0,0 +1,20 @@
+import { Command } from 'commander';
+import { listCommand } from './list';
+import { getCommand } from './get';
+import { deleteCommand } from './delete';
+import { createCommand } from './create';
+import { updateCommand } from './update';
+import { enableCommand } from './enable-widget';
+import { chatCommand } from './chat';
+import { messageCommand } from './on-message';
+export const agentCommands = new Command('agent')
+  .description('Comandos relacionados con agentes')
+  .addCommand(listCommand)
+  .addCommand(getCommand)
+  .addCommand(deleteCommand)
+  .addCommand(createCommand)
+  .addCommand(updateCommand)
+  .addCommand(enableCommand)
+  .addCommand(chatCommand)
+  .addCommand(messageCommand);

package/src/commands/agent/list.ts ADDED Viewed

@@ -0,0 +1,52 @@
+import { Command } from 'commander';
+import { Agent } from 'plazbot';
+import { getStoredCredentials } from '../../utils/credentials';
+import { logger } from '../../utils/logger';
+import { ListAgentsOptions, AgentListItem } from '../../types/agent';
+export const listCommand = new Command('list')
+  .description('Lista todos los agentes del workspace')
+  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .action(async (options: ListAgentsOptions) => {
+    try {
+      // Obtener credenciales guardadas
+      const credentials = await getStoredCredentials();
+      // Crear instancia del agente con las credenciales guardadas
+      const agent = new Agent({
+        workspaceId: credentials.workspace,
+        apiKey: credentials.apiKey,
+        zone: credentials.zone,
+        ...(options.dev && { customUrl: "http://localhost:5090" })
+      });
+      // Obtener lista de agentes
+      const agents = await agent.getAgents();
+      if (agents.length === 0) {
+        logger.info('No se encontraron agentes en este workspace');
+        return;
+      }
+      logger.info('\nLista de Agentes:');
+      logger.doubleDivider();
+      agents.forEach((agent: AgentListItem, index: number) => {
+        logger.info(`${index + 1}. ID: ${agent.id}`);
+        logger.info(`   Nombre: ${agent.name}`);
+        logger.info(`   Estado: ${agent.enable ? '✅ Activo' : '❌ Inactivo'}`);
+        logger.info(`   Descripción: ${agent.description}`);
+        logger.info(`   Creado: ${new Date(agent.createdAt).toLocaleString()}`);
+        logger.divider();
+      });
+      if (options.dev) {
+        logger.warning('Ambiente: desarrollo');
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Error desconocido al listar agentes';
+      logger.error(message);
+      process.exit(1);
+    }
+  });

package/src/commands/agent/on-message.ts ADDED Viewed

@@ -0,0 +1,75 @@
+import { Command } from 'commander';
+import { Agent } from 'plazbot';
+import { getStoredCredentials } from '../../utils/credentials';
+import { logger } from '../../utils/logger';
+import { AgentCommandOptions, AgentResponse, AgentSource } from '../../types/agent';
+import crypto from 'crypto';
+export const messageCommand = new 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: AgentCommandOptions & {
+    agentId: string;
+    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.info('\n🤖 Enviando mensaje al agente...');
+      logger.info(`ID del agente: ${options.agentId}`);
+      logger.info(`Pregunta: ${options.question}`);
+      logger.info(`ID de sesión: ${sessionId}`);
+      if (options.multipleAnswers) {
+        logger.info('Modo: Múltiples respuestas');
+      }
+      const response = await agent.onMessage({
+        agentId: options.agentId,
+        question: options.question,
+        sessionId,
+        multipleAnswers: options.multipleAnswers
+      }) as AgentResponse;
+      logger.info('\n💬 Respuesta del Agente:');
+      logger.divider();
+      console.log(response.answer);
+      if (response.sources && response.sources.length > 0) {
+        logger.info('\n📚 Fuentes:');
+        logger.divider();
+        response.sources.forEach((source: AgentSource) => {
+          logger.info(`- ${source.title || 'Sin título'}`);
+          if (source.url) logger.info(`  URL: ${source.url}`);
+        });
+      }
+      logger.info('\n🔑 ID de Sesión:');
+      logger.info(sessionId);
+      if (options.dev) {
+        logger.warning('\nAmbiente: desarrollo');
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Error desconocido al enviar el mensaje';
+      logger.error(message);
+      process.exit(1);
+    }
+  });

package/src/commands/agent/update.ts ADDED Viewed

@@ -0,0 +1,53 @@
+import { Command } from 'commander';
+import { Agent } from 'plazbot';
+import { getStoredCredentials } from '../../utils/credentials';
+import { logger } from '../../utils/logger';
+import { AgentCommandOptions } from '../../types/agent';
+import fs from 'fs/promises';
+export const updateCommand = new Command('update')
+  .description('Actualiza un agente existente en Plazbot')
+  .argument('<agentId>', 'ID del agente a actualizar')
+  .argument('<configPath>', 'Ruta al archivo de configuración JSON del agente')
+  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .action(async (agentId: string, configPath: string, options: AgentCommandOptions) => {
+    try {
+      // Obtener credenciales guardadas
+      const credentials = await getStoredCredentials();
+      // Leer archivo de configuración del agente
+      let agentConfig;
+      try {
+        const fileContent = await fs.readFile(configPath, 'utf-8');
+        agentConfig = JSON.parse(fileContent);
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Error desconocido';
+        throw new Error(`Error al leer el archivo de configuración: ${errorMessage}`);
+      }
+      // Crear instancia del agente con las credenciales guardadas
+      const agent = new Agent({
+        workspaceId: credentials.workspace,
+        apiKey: credentials.apiKey,
+        zone: credentials.zone,
+        ...(options.dev && { customUrl: "http://localhost:5090" })
+      });
+      logger.info('\n🔄 Actualizando agente...');
+      // Actualizar el agente
+      const result = await agent.updateAgent(agentId, agentConfig);
+      logger.success('Agente actualizado exitosamente');
+      logger.info(`Mensaje: ${result.message}`);
+      if (options.dev) {
+        logger.warning('Ambiente: desarrollo');
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Error desconocido al actualizar el agente';
+      logger.error(message);
+      process.exit(1);
+    }
+  });

package/src/commands/auth/index.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+import { loginCommand } from './login';
+import { logoutCommand } from './logout';
+export const authCommands: Command[] = [
+  loginCommand,
+  logoutCommand
+];

package/src/commands/auth/login.ts ADDED Viewed

@@ -0,0 +1,56 @@
+import { Command } from 'commander';
+import { saveCredentials } from '../../utils/credentials';
+import { logger } from '../../utils/logger';
+import { LoginOptions } from '../../types/auth';
+export const loginCommand = new Command('init')
+  .description('Guarda la API Key y correo del usuario localmente')
+  .requiredOption('-e, --email <email>', 'Correo del usuario')
+  .requiredOption('-k, --api-key <apiKey>', 'API Key del usuario')
+  .requiredOption('-w, --workspace <workspace>', 'ID del workspace')
+  .requiredOption('-z, --zone <zone>', 'Zona (LA o EU)')
+  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .action(async (options: LoginOptions) => {
+    try {
+      // Limpiar la pantalla
+      console.clear();
+      // Banner de bienvenida
+      logger.info('┌' + '─'.repeat(70) + '┐');
+      logger.info('│' + ' Bienvenido a Plazbot CLI'.padEnd(69) + '│');
+      logger.info('│' + ''.padEnd(69) + '│');
+      logger.info('│' + ' Con esta herramienta podrás:'.padEnd(69) + '│');
+      logger.info('│' + ' • Crear y actualizar agentes'.padEnd(69) + '│');
+      logger.info('│' + ' • Gestionar configuraciones'.padEnd(69) + '│');
+      logger.info('│' + ' • Interactuar con tus agentes'.padEnd(69) + '│');
+      logger.info('│' + ' • Activar todas sus capacidades'.padEnd(69) + '│');
+      logger.info('└' + '─'.repeat(70) + '┘\n');
+      await saveCredentials({
+        email: options.email,
+        apiKey: options.apiKey,
+        workspace: options.workspace,
+        zone: options.zone
+      });
+      logger.success('Configuración guardada exitosamente:');
+      logger.info('   • Email: ' + options.email);
+      logger.info('   • Workspace: ' + options.workspace);
+      logger.info('   • Zona: ' + options.zone);
+      logger.info('\n🚀 Puedes comenzar usando los siguientes comandos:');
+      logger.info('   • plazbot list-agents     - Ver tus agentes');
+      logger.info('   • plazbot create-agent    - Crear un nuevo agente');
+      logger.info('   • plazbot chat            - Chatear con un agente');
+      logger.info('   • plazbot --help          - Ver todos los comandos\n');
+      if (options.dev) {
+        logger.warning('Ambiente: desarrollo');
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Error desconocido';
+      logger.error(message);
+      process.exit(1);
+    }
+  });

package/src/commands/auth/logout.ts ADDED Viewed

@@ -0,0 +1,22 @@
+import { Command } from 'commander';
+import { removeCredentials } from '../../utils/credentials';
+import { logger } from '../../utils/logger';
+import { BaseCommandOptions } from '../../types/common';
+export const logoutCommand = new Command('finish')
+  .description('Elimina la configuración local del usuario')
+  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .action(async (options: BaseCommandOptions) => {
+    try {
+      await removeCredentials();
+      logger.success('Has cerrado sesión correctamente');
+      if (options.dev) {
+        logger.warning('Ambiente: desarrollo');
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Error desconocido al cerrar sesión';
+      logger.error(message);
+      process.exit(1);
+    }
+  });

package/src/commands/portal/add-agent.ts ADDED Viewed

@@ -0,0 +1,66 @@
+import { Command } from 'commander';
+import { Portal, Agent } from 'plazbot';
+import { getStoredCredentials } from '../../utils/credentials';
+import { logger } from '../../utils/logger';
+import { AddAgentToPortalOptions } from '../../types/portal';
+export const addAgentCommand = new Command('add-agent-portal')
+  .description('Agrega un agente existente a un portal')
+  .requiredOption('-p, --portal-id <portalId>', 'ID del portal')
+  .requiredOption('-a, --agent-id <agentId>', 'ID del agente a agregar')
+  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .action(async (options: AddAgentToPortalOptions) => {
+    try {
+      // Obtener credenciales guardadas
+      const credentials = await getStoredCredentials();
+      const portal = new Portal({
+        workspaceId: credentials.workspace,
+        apiKey: credentials.apiKey,
+        zone: credentials.zone,
+        ...(options.dev && { customUrl: "http://localhost:5090" })
+      });
+      // Obtener detalles del portal
+      const portalDetails = await portal.getPortal(options.portalId);
+      // Crear instancia del agente para obtener sus detalles
+      const agent = new Agent({
+        workspaceId: credentials.workspace,
+        apiKey: credentials.apiKey,
+        zone: credentials.zone,
+        ...(options.dev && { customUrl: "http://localhost:5090" })
+      });
+      // Obtener detalles del agente
+      const agentDetails = await agent.getAgentById({ id: options.agentId });
+      logger.info('\n📎 Detalles de la operación:');
+      logger.divider();
+      logger.info('Portal:');
+      logger.info(`  ID: ${portalDetails.portal.id}`);
+      logger.info(`  Nombre: ${portalDetails.portal.name}`);
+      logger.info('\nAgente:');
+      logger.info(`  ID: ${agentDetails.agent.id}`);
+      logger.info(`  Nombre: ${agentDetails.agent.name}`);
+      logger.divider();
+      logger.info('\n🔄 Agregando agente al portal...');
+      await portal.addAgentToPortal({
+        portalId: options.portalId,
+        id: options.agentId
+      });
+      logger.success('Agente agregado exitosamente al portal');
+      if (options.dev) {
+        logger.warning('Ambiente: desarrollo');
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Error desconocido';
+      logger.error(message);
+      process.exit(1);
+    }
+  });

package/src/commands/portal/add-link.ts ADDED Viewed

@@ -0,0 +1,39 @@
+import { Command } from 'commander'
+import { Portal } from 'plazbot'
+import { getStoredCredentials } from '../../utils/credentials'
+import { logger } from '../../utils/logger'
+import { BaseCommandOptions } from '../../types/common'
+interface AddLinkOptions extends BaseCommandOptions {
+  title: string
+  url: string
+}
+export const addLinkCommand = new Command('add-link')
+  .description('Agregar un enlace al portal')
+  .argument('<portalId>', 'ID del portal')
+  .requiredOption('-t, --title <title>', 'Título del enlace')
+  .requiredOption('-u, --url <url>', 'URL del enlace')
+  .option('--dev', 'Usar entorno de desarrollo')
+  .action(async (portalId: string, options: AddLinkOptions) => {
+    try {
+      const credentials = await getStoredCredentials()
+      const portal = new Portal({
+        workspaceId: credentials.workspace,
+        apiKey: credentials.apiKey,
+        zone: credentials.zone,
+        ...(options.dev && { customUrl: "http://localhost:5090" })
+      })
+      await portal.addLinkToPortal({
+        portalId,
+        value: options.title,
+        url: options.url
+      })
+      console.log('✅ Enlace agregado exitosamente')
+    } catch (error: unknown) {
+      console.error('❌ Error al agregar el enlace:', (error as Error).message)
+      process.exit(1)
+    }
+  })

package/src/commands/portal/clear-links.ts ADDED Viewed

@@ -0,0 +1,26 @@
+import { Command } from 'commander';
+import { Portal } from 'plazbot';
+import { getStoredCredentials } from '../../utils/credentials';
+import { BaseCommandOptions } from '../../types/common';
+export const clearLinksCommand = new Command('clear-links')
+  .description('Eliminar todos los enlaces del portal')
+  .argument('<portalId>', 'ID del portal')
+  .option('--dev', 'Usar entorno de desarrollo')
+  .action(async (portalId: string, options: BaseCommandOptions) => {
+    try {
+      const credentials = await getStoredCredentials();
+      const portal = new Portal({
+        workspaceId: credentials.workspace,
+        apiKey: credentials.apiKey,
+        zone: credentials.zone,
+        ...(options.dev && { customUrl: "http://localhost:5090" })
+      });
+      await portal.clearLinks(portalId);
+      console.log('✅ Enlaces eliminados exitosamente');
+    } catch (error: unknown) {
+      console.error('❌ Error al eliminar los enlaces:', (error as Error).message);
+      process.exit(1);
+    }
+  });