plazbot-cli 0.3.7 → 0.4.0

package/src/commands/auth/index.ts

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

package/src/commands/auth/login.ts

@@ -1,72 +0,0 @@
-import { Command } from 'commander';
-import { saveCredentials } from '../../utils/credentials.js';
-import { logger } from '../../utils/logger.js';
-import { addExamples } from '../../utils/help.js';
-import { LoginOptions } from '../../types/auth.js';
-
-export const loginCommand = new Command('init')
-  .description('Save the API key and user email locally')
-  .option('-e, --email <email>', 'User email (optional)')
-  .requiredOption('-k, --api-key <apiKey>', 'User API key')
-  .requiredOption('-w, --workspace <workspace>', 'Workspace ID')
-  .requiredOption('-z, --zone <zone>', 'Zone (LA or EU)')
-  .option('-u, --user-id <userId>', 'User ID for x-user-id (optional, used by studio)')
-  .option('--dev', 'Use development environment', false)
-  .action(async (options: LoginOptions) => {
-    try {
-      // Limpiar la pantalla
-      console.clear();
-
-      // Banner de bienvenida
-      logger.info('┌' + '─'.repeat(70) + '┐');
-      logger.info('│' + ' Welcome to Plazbot CLI'.padEnd(69) + '│');
-      logger.info('│' + ''.padEnd(69) + '│');
-      logger.info('│' + ' With this tool you can:'.padEnd(69) + '│');
-      logger.info('│' + '   Create and update agents'.padEnd(69) + '│');
-      logger.info('│' + '   Manage configurations'.padEnd(69) + '│');
-      logger.info('│' + '   Interact with your agents'.padEnd(69) + '│');
-      logger.info('│' + '   Activate all their capabilities'.padEnd(69) + '│');
-      logger.info('└' + '─'.repeat(70) + '┘\n');
-
-      await saveCredentials({
-        email: options.email || '',
-        apiKey: options.apiKey,
-        workspace: options.workspace,
-        zone: options.zone,
-        userId: options.userId
-      });
-
-      logger.success('Configuration saved successfully:');
-      if (options.email) logger.label('Email', options.email);
-      logger.label('Workspace', options.workspace);
-      logger.label('Zone', options.zone);
-      if (options.userId) logger.label('UserId', options.userId);
-
-      logger.title('You can start by using the following commands');
-      logger.dim('plazbot agent list        - View your agents');
-      logger.dim('plazbot agent templates   - Create an agent from a template');
-      logger.dim('plazbot agent chat        - Chat with an agent');
-      logger.dim('plazbot --help            - View all commands');
-      console.log();
-
-      if (options.dev) {
-        logger.warning('Environment: development');
-      }
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-addExamples(loginCommand, [
-  { description: 'Save credentials for a LA workspace',
-    command: 'plazbot init -e you@company.com -k <jwt> -w wok_AbcDef123 -z LA' },
-  { description: 'Save credentials for an EU workspace',
-    command: 'plazbot init -k <jwt> -w wok_AbcDef123 -z EU' },
-  { description: 'Include userId (used by studio support mode)',
-    command: 'plazbot init -k <jwt> -w wok_AbcDef123 -z LA -u usr_AbcDef123' },
-  { description: 'Target the local backend (dev mode)',
-    command: 'plazbot init -k <jwt> -w wok_AbcDef123 -z LA --dev' },
-]);

package/src/commands/auth/logout.ts

@@ -1,28 +0,0 @@
-import { Command } from 'commander';
-import { removeCredentials } from '../../utils/credentials.js';
-import { logger } from '../../utils/logger.js';
-import { addExamples } from '../../utils/help.js';
-import { BaseCommandOptions } from '../../types/common.js';
-
-export const logoutCommand = new Command('finish')
-  .description('Remove the local user configuration')
-  .option('--dev', 'Use development environment', false)
-  .action(async (options: BaseCommandOptions) => {
-    try {
-      await removeCredentials();
-      logger.success('You have been signed out successfully');
-
-      if (options.dev) {
-        logger.warning('Environment: development');
-      }
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error while signing out';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-addExamples(logoutCommand, [
-  { description: 'Remove the local configuration (~/.plazbot/config.json)',
-    command: 'plazbot finish' },
-]);

package/src/commands/auth/status.ts

@@ -1,28 +0,0 @@
-import { Command } from 'commander';
-import { getStoredCredentials } from '../../utils/credentials.js';
-import { logger } from '../../utils/logger.js';
-import { addExamples } from '../../utils/help.js';
-import { theme, section } from '../../utils/ui.js';
-
-export const statusCommand = new Command('status')
-  .description('Show the active session (workspace, email, zone)')
-  .action(async () => {
-    try {
-      const credentials = await getStoredCredentials();
-
-      console.log(section('Active session'));
-      if (credentials.email) logger.label('Email', credentials.email);
-      logger.label('Workspace', credentials.workspace);
-      logger.label('Zone', credentials.zone === 'LA' ? 'Latin America (LA)' : 'Europe (EU)');
-      logger.label('API', credentials.zone === 'EU' ? 'https://apieu.plazbot.com' : 'https://api.plazbot.com');
-      console.log();
-    } catch {
-      logger.error("No active session. Run 'plazbot init' to sign in.");
-      process.exit(1);
-    }
-  });
-
-addExamples(statusCommand, [
-  { description: 'Show the active workspace, email and zone',
-    command: 'plazbot status' },
-]);

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

@@ -1,66 +0,0 @@
-import { Command } from 'commander';
-import { Portal, Agent } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials.js';
-import { logger } from '../../utils/logger.js';
-import { addExamples } from '../../utils/help.js';
-import { AddAgentToPortalOptions } from '../../types/portal.js';
-
-export const addAgentCommand = new Command('add-agent-portal')
-  .description('Add an existing agent to a portal')
-  .requiredOption('-p, --portal-id <portalId>', 'Portal ID')
-  .requiredOption('-a, --agent-id <agentId>', 'ID of the agent to add')
-  .option('--dev', 'Use development environment', 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.title('Operation details');
-      logger.label('Portal ID', portalDetails.portal?.id || options.portalId);
-      logger.label('Portal Name', portalDetails.portal?.name || 'N/A');
-      logger.label('Agent ID', agentDetails.id);
-      logger.label('Agent Name', agentDetails.name);
-
-      await portal.addAgentToPortal({
-        portalId: options.portalId,
-        id: options.agentId
-      });
-
-      logger.success('Agent added to the portal successfully');
-
-      if (options.dev) {
-        logger.warning('Environment: development');
-      }
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-addExamples(addAgentCommand, [
-  { description: 'Attach an existing agent to a portal',
-    command: 'plazbot portal add-agent-portal -p prt_AbcDef123 -a agt_AbcDef123' },
-]);

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

@@ -1,47 +0,0 @@
-import { Command } from 'commander'
-import { Portal } from 'plazbot'
-import { getStoredCredentials } from '../../utils/credentials.js'
-import { logger } from '../../utils/logger.js'
-import { addExamples } from '../../utils/help.js'
-import { BaseCommandOptions } from '../../types/common.js'
-
-interface AddLinkOptions extends BaseCommandOptions {
-  title: string
-  url: string
-}
-
-export const addLinkCommand = new Command('add-link')
-  .description('Add a link to the portal')
-  .argument('<portalId>', 'Portal ID')
-  .requiredOption('-t, --title <title>', 'Link title')
-  .requiredOption('-u, --url <url>', 'Link URL')
-  .option('--dev', 'Use development environment')
-  .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
-      })
-
-      logger.success('Link added successfully')
-    } catch (error: unknown) {
-      logger.error((error as Error).message)
-      process.exit(1)
-    }
-  })
-
-addExamples(addLinkCommand, [
-  { description: 'Add a documentation link to the portal',
-    command: 'plazbot portal add-link prt_AbcDef123 -t "Docs" -u https://docs.example.com' },
-  { description: 'Add a support link',
-    command: 'plazbot portal add-link prt_AbcDef123 -t "Contact us" -u https://example.com/contact' },
-])

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

@@ -1,33 +0,0 @@
-import { Command } from 'commander';
-import { Portal } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials.js';
-import { logger } from '../../utils/logger.js';
-import { addExamples } from '../../utils/help.js';
-import { BaseCommandOptions } from '../../types/common.js';
-
-export const clearLinksCommand = new Command('clear-links')
-  .description('Remove all links from the portal')
-  .argument('<portalId>', 'Portal ID')
-  .option('--dev', 'Use development environment')
-  .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);
-      logger.success('Links removed successfully');
-    } catch (error: unknown) {
-      logger.error((error as Error).message);
-      process.exit(1);
-    }
-  });
-
-addExamples(clearLinksCommand, [
-  { description: 'Remove every link from a portal',
-    command: 'plazbot portal clear-links prt_AbcDef123' },
-]);

package/src/commands/portal/create.ts

@@ -1,58 +0,0 @@
-import { Command } from 'commander';
-import { Portal } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials.js';
-import { logger } from '../../utils/logger.js';
-import { addExamples } from '../../utils/help.js';
-import { PortalCommandOptions } from '../../types/portal.js';
-
-export const createCommand = new Command('create')
-  .description('Create a new portal with a simplified configuration')
-  .requiredOption('-n, --name <name>', 'Portal name')
-  .requiredOption('-t, --title <title>', 'Portal welcome title')
-  .option('--dev', 'Use development environment', false)
-  .action(async (options: PortalCommandOptions & { name: string; title: string }) => {
-    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" })
-      });
-
-      const portalCreated = await portal.addPortal({
-        name: options.name,
-        title: options.title,
-        zone: credentials.zone as "LA" | "EU",
-        subtitle: "",
-        logo: "",
-        logodark: "",
-        access: "direct",
-        disabled: false,
-        brandOff: false
-      });
-
-      logger.success('Portal created successfully');
-      logger.title('Portal details');
-      logger.label('ID', portalCreated.id);
-      logger.label('URL', portalCreated.url);
-
-      if (options.dev) {
-        logger.warning('\nEnvironment: development');
-      }
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error while creating the portal';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-addExamples(createCommand, [
-  { description: 'Create a portal with name and welcome title',
-    command: 'plazbot portal create -n "Customer Portal" -t "Welcome to our help center"' },
-  { description: 'Create against the local backend',
-    command: 'plazbot portal create -n "Test" -t "Hello" --dev' },
-]);

package/src/commands/portal/delete.ts

@@ -1,70 +0,0 @@
-import { Command } from 'commander';
-import { Portal } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials.js';
-import { logger } from '../../utils/logger.js';
-import { addExamples } from '../../utils/help.js';
-import { PortalCommandOptions, PortalResponse } from '../../types/portal.js';
-import inquirer from 'inquirer';
-
-export const deleteCommand = new Command('delete')
-  .description('Delete a portal')
-  .argument('<portalId>', 'Portal ID')
-  .option('--force', 'Delete without confirmation', false)
-  .option('--dev', 'Use development environment', false)
-  .action(async (portalId: string, options: PortalCommandOptions) => {
-    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 para mostrar qué se va a eliminar
-      const portalDetails = await portal.getPortal(portalId) as PortalResponse;
-
-      logger.title('Portal to delete');
-      logger.label('ID', portalDetails.portal.id);
-      logger.label('Name', portalDetails.portal.name);
-      logger.label('URL', portalDetails.portal.url);
-
-      if (!options.force) {
-        const { confirm } = await inquirer.prompt([{
-          type: 'confirm',
-          name: 'confirm',
-          message: 'Are you sure you want to delete this portal?',
-          default: false
-        }]);
-
-        if (!confirm) {
-          logger.info('Operation cancelled.');
-          return;
-        }
-      }
-
-      logger.dim('Deleting portal...');
-
-      await portal.deletePortal(portalId);
-
-      logger.success('Portal deleted successfully');
-
-      if (options.dev) {
-        logger.warning('\nEnvironment: development');
-      }
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error while deleting the portal';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-addExamples(deleteCommand, [
-  { description: 'Delete a portal with confirmation prompt',
-    command: 'plazbot portal delete prt_AbcDef123' },
-  { description: 'Delete without confirmation (use in scripts)',
-    command: 'plazbot portal delete prt_AbcDef123 --force' },
-]);

package/src/commands/portal/get.ts

@@ -1,77 +0,0 @@
-import { Command } from 'commander';
-import { Portal } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials.js';
-import { logger } from '../../utils/logger.js';
-import { addExamples } from '../../utils/help.js';
-import { PortalCommandOptions, PortalResponse, PortalLink, PortalAgent } from '../../types/portal.js';
-
-export const getCommand = new Command('get')
-  .description('Show detailed information for a portal')
-  .argument('<portalId>', 'Portal ID')
-  .option('--dev', 'Use development environment', false)
-  .action(async (portalId: string, options: PortalCommandOptions) => {
-    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" })
-      });
-
-      const response = await portal.getPortal(portalId) as PortalResponse;
-      const portalDetails = response.portal;
-
-      logger.title('Portal details');
-      logger.label('ID', portalDetails.id);
-      logger.label('Name', portalDetails.name);
-      logger.label('URL', portalDetails.url);
-      logger.label('Access', portalDetails.access);
-      logger.label('Status', portalDetails.disabled ? 'Disabled' : 'Enabled');
-
-      if (portalDetails.title) {
-        logger.label('Title', portalDetails.title);
-      }
-      if (portalDetails.subtitle) {
-        logger.label('Subtitle', portalDetails.subtitle);
-      }
-
-      if (portalDetails.logo) {
-        logger.title('Assets');
-        logger.label('Logo', portalDetails.logo);
-        if (portalDetails.logodark) {
-          logger.label('Logo (dark mode)', portalDetails.logodark);
-        }
-      }
-
-      if (portalDetails.links && portalDetails.links.length > 0) {
-        logger.title('Links');
-        portalDetails.links.forEach((link: PortalLink) => {
-          logger.label(link.value, link.url);
-        });
-      }
-
-      if (portalDetails.agents && portalDetails.agents.length > 0) {
-        logger.title('Associated agents');
-        portalDetails.agents.forEach((agent: PortalAgent) => {
-          logger.label(agent.name, agent.id);
-        });
-      }
-
-      if (options.dev) {
-        logger.warning('\nEnvironment: development');
-      }
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error while fetching portal details';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-addExamples(getCommand, [
-  { description: 'Show details for a specific portal',
-    command: 'plazbot portal get prt_AbcDef123' },
-]);

package/src/commands/portal/index.ts

@@ -1,32 +0,0 @@
-import { Command } from 'commander';
-import { addExamples } from '../../utils/help.js';
-import { getCommand } from './get.js';
-import { deleteCommand } from './delete.js';
-import { createCommand } from './create.js';
-import { updateCommand } from './update.js';
-import { addAgentCommand } from './add-agent.js';
-import { listCommand } from './list.js';
-import { addLinkCommand } from './add-link.js';
-import { clearLinksCommand } from './clear-links.js';
-
-export const portalCommands = new Command('portal')
-  .description('Commands related to portals')
-  .addCommand(listCommand)
-  .addCommand(getCommand)
-  .addCommand(deleteCommand)
-  .addCommand(createCommand)
-  .addCommand(updateCommand)
-  .addCommand(addAgentCommand)
-  .addCommand(addLinkCommand)
-  .addCommand(clearLinksCommand);
-
-addExamples(portalCommands, [
-  { description: 'List the portal of the active workspace',
-    command: 'plazbot portal list' },
-  { description: 'Create a portal',
-    command: 'plazbot portal create -n "Help Center" -t "Welcome"' },
-  { description: 'Attach an agent to a portal',
-    command: 'plazbot portal add-agent-portal -p prt_AbcDef123 -a agt_AbcDef123' },
-  { description: 'Add a link to a portal',
-    command: 'plazbot portal add-link prt_AbcDef123 -t "Docs" -u https://docs.example.com' },
-]);

package/src/commands/portal/list.ts

@@ -1,79 +0,0 @@
-import { Command } from 'commander';
-import { Portal } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials.js';
-import { logger } from '../../utils/logger.js';
-import { addExamples } from '../../utils/help.js';
-import { PortalCommandOptions } from '../../types/portal.js';
-
-export const listCommand = new Command('list')
-  .description('Show the portal associated with the workspace')
-  .option('--dev', 'Use development environment', false)
-  .action(async (options: PortalCommandOptions) => {
-    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" })
-      });
-
-      const response = await portal.getExistsPortal();
-      const portalDetails = response.portal;
-
-      logger.title('Portal found');
-      logger.label('ID', portalDetails.id);
-      logger.label('Name', portalDetails.name);
-      logger.label('URL', portalDetails.url);
-      logger.label('Access', portalDetails.access || 'N/A');
-      logger.label('Status', portalDetails.disabled ? 'Disabled' : 'Enabled');
-
-      if (portalDetails.title) {
-        logger.label('Title', portalDetails.title);
-      }
-      if (portalDetails.subtitle) {
-        logger.label('Subtitle', portalDetails.subtitle);
-      }
-
-      if (portalDetails.logo) {
-        logger.title('Assets');
-        logger.label('Logo', portalDetails.logo);
-        if (portalDetails.logodark) {
-          logger.label('Logo (dark mode)', portalDetails.logodark);
-        }
-      }
-
-      const portalAny = portalDetails as any;
-      if (portalAny.links && portalAny.links.length > 0) {
-        logger.title('Links');
-        portalAny.links.forEach((link: { value: string; url: string }) => {
-          logger.label(link.value, link.url);
-        });
-      }
-
-      if (portalAny.agents && portalAny.agents.length > 0) {
-        logger.title('Associated agents');
-        portalAny.agents.forEach((agent: { name: string; id: string }) => {
-          logger.label(agent.name, agent.id);
-        });
-      }
-
-      if (options.dev) {
-        logger.warning('\nEnvironment: development');
-      }
-
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error while listing the portal';
-      logger.error(message);
-      process.exit(1);
-    }
-  });
-
-addExamples(listCommand, [
-  { description: 'Show the portal of the active workspace',
-    command: 'plazbot portal list' },
-  { description: 'Use the development backend',
-    command: 'plazbot portal list --dev' },
-]);