plazbot-cli 0.2.26 → 0.3.2

package/src/commands/auth/login.ts

@@ -1,15 +1,17 @@
 import { Command } from 'commander';
-import { saveCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { LoginOptions } from '../../types/auth';
+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('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)
+  .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
@@ -17,41 +19,54 @@ export const loginCommand = new Command('init')
 
       // Banner de bienvenida
       logger.info('┌' + '─'.repeat(70) + '┐');
-      logger.info('│' + ' Bienvenido a Plazbot CLI'.padEnd(69) + '│');
+      logger.info('│' + ' Welcome to 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('│' + ' 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,
+        email: options.email || '',
         apiKey: options.apiKey,
         workspace: options.workspace,
-        zone: options.zone
+        zone: options.zone,
+        userId: options.userId
       });
 
-      logger.success('Configuración guardada exitosamente:');
-      logger.label('Email', options.email);
+      logger.success('Configuration saved successfully:');
+      if (options.email) logger.label('Email', options.email);
       logger.label('Workspace', options.workspace);
-      logger.label('Zona', options.zone);
-      
-      logger.title('Puedes comenzar usando los siguientes comandos');
-      logger.dim('plazbot agent list        - Ver tus agentes');
-      logger.dim('plazbot agent templates   - Crear agente desde plantilla');
-      logger.dim('plazbot agent chat        - Chatear con un agente');
-      logger.dim('plazbot --help            - Ver todos los comandos');
+      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('Ambiente: desarrollo');
+        logger.warning('Environment: development');
       }
 
     } catch (error) {
-      const message = error instanceof Error ? error.message : 'Error desconocido';
+      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,22 +1,28 @@
 import { Command } from 'commander';
-import { removeCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { BaseCommandOptions } from '../../types/common';
+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('Elimina la configuración local del usuario')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .description('Remove the local user configuration')
+  .option('--dev', 'Use development environment', false)
   .action(async (options: BaseCommandOptions) => {
     try {
       await removeCredentials();
-      logger.success('Has cerrado sesión correctamente');
-      
+      logger.success('You have been signed out successfully');
+
       if (options.dev) {
-        logger.warning('Ambiente: desarrollo');
+        logger.warning('Environment: development');
       }
     } catch (error) {
-      const message = error instanceof Error ? error.message : 'Error desconocido al cerrar sesión';
+      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,22 +1,28 @@
 import { Command } from 'commander';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { theme, section } from '../../utils/ui';
+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('Muestra la sesion activa (workspace, email, zona)')
+  .description('Show the active session (workspace, email, zone)')
   .action(async () => {
     try {
       const credentials = await getStoredCredentials();
 
-      console.log(section('Sesion activa'));
-      logger.label('Email', credentials.email);
+      console.log(section('Active session'));
+      if (credentials.email) logger.label('Email', credentials.email);
       logger.label('Workspace', credentials.workspace);
-      logger.label('Zona', credentials.zone === 'LA' ? 'Latinoamerica (LA)' : 'Europa (EU)');
+      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 hay sesion activa. Ejecuta 'plazbot init' para conectarte.");
+      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,14 +1,15 @@
 import { Command } from 'commander';
 import { Portal, Agent } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { AddAgentToPortalOptions } from '../../types/portal';
+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('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)
+  .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
@@ -35,26 +36,31 @@ export const addAgentCommand = new Command('add-agent-portal')
       // Obtener detalles del agente
       const agentDetails = await agent.getAgentById({ id: options.agentId });
 
-      logger.title('Detalles de la operacion');
+      logger.title('Operation details');
       logger.label('Portal ID', portalDetails.portal?.id || options.portalId);
-      logger.label('Portal Nombre', portalDetails.portal?.name || 'N/A');
-      logger.label('Agente ID', agentDetails.id);
-      logger.label('Agente Nombre', agentDetails.name);
-      
+      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('Agente agregado exitosamente al portal');
-      
+      logger.success('Agent added to the portal successfully');
+
       if (options.dev) {
-        logger.warning('Ambiente: desarrollo');
+        logger.warning('Environment: development');
       }
 
     } catch (error) {
-      const message = error instanceof Error ? error.message : 'Error desconocido';
+      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,8 +1,9 @@
 import { Command } from 'commander'
 import { Portal } from 'plazbot'
-import { getStoredCredentials } from '../../utils/credentials'
-import { logger } from '../../utils/logger'
-import { BaseCommandOptions } from '../../types/common'
+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
@@ -10,11 +11,11 @@ interface AddLinkOptions extends BaseCommandOptions {
 }
 
 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')
+  .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()
@@ -31,9 +32,16 @@ export const addLinkCommand = new Command('add-link')
         url: options.url
       })
 
-      logger.success('Enlace agregado exitosamente')
+      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,13 +1,14 @@
 import { Command } from 'commander';
 import { Portal } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { BaseCommandOptions } from '../../types/common';
+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('Eliminar todos los enlaces del portal')
-  .argument('<portalId>', 'ID del portal')
-  .option('--dev', 'Usar entorno de desarrollo')
+  .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();
@@ -19,9 +20,14 @@ export const clearLinksCommand = new Command('clear-links')
       });
 
       await portal.clearLinks(portalId);
-      logger.success('Enlaces eliminados exitosamente');
+      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,14 +1,15 @@
 import { Command } from 'commander';
 import { Portal } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { PortalCommandOptions } from '../../types/portal';
+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('Crea un nuevo portal con configuración simplificada')
-  .requiredOption('-n, --name <name>', 'Nombre del portal')
-  .requiredOption('-t, --title <title>', 'Título de bienvenida del portal')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .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
@@ -33,18 +34,25 @@ export const createCommand = new Command('create')
         brandOff: false
       });
 
-      logger.success('Portal creado exitosamente');
-      logger.title('Detalles del portal');
+      logger.success('Portal created successfully');
+      logger.title('Portal details');
       logger.label('ID', portalCreated.id);
       logger.label('URL', portalCreated.url);
 
       if (options.dev) {
-        logger.warning('\nAmbiente: desarrollo');
+        logger.warning('\nEnvironment: development');
       }
 
     } catch (error) {
-      const message = error instanceof Error ? error.message : 'Error desconocido al crear el portal';
+      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,15 +1,16 @@
 import { Command } from 'commander';
 import { Portal } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { PortalCommandOptions, PortalResponse } from '../../types/portal';
+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('Elimina un portal')
-  .argument('<portalId>', 'ID del portal')
-  .option('--force', 'Eliminar sin confirmación', false)
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .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
@@ -25,38 +26,45 @@ export const deleteCommand = new Command('delete')
       // Obtener detalles del portal para mostrar qué se va a eliminar
       const portalDetails = await portal.getPortal(portalId) as PortalResponse;
 
-      logger.title('Portal a eliminar');
+      logger.title('Portal to delete');
       logger.label('ID', portalDetails.portal.id);
-      logger.label('Nombre', portalDetails.portal.name);
+      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: '¿Estás seguro de que quieres eliminar este portal?',
+          message: 'Are you sure you want to delete this portal?',
           default: false
         }]);
 
         if (!confirm) {
-          logger.info('Operación cancelada.');
+          logger.info('Operation cancelled.');
           return;
         }
       }
 
-      logger.dim('Eliminando portal...');
-      
+      logger.dim('Deleting portal...');
+
       await portal.deletePortal(portalId);
-      
-      logger.success('Portal eliminado exitosamente');
-      
+
+      logger.success('Portal deleted successfully');
+
       if (options.dev) {
-        logger.warning('\nAmbiente: desarrollo');
+        logger.warning('\nEnvironment: development');
       }
 
     } catch (error) {
-      const message = error instanceof Error ? error.message : 'Error desconocido al eliminar el portal';
+      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,13 +1,14 @@
 import { Command } from 'commander';
 import { Portal } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials';
-import { logger } from '../../utils/logger';
-import { PortalCommandOptions, PortalResponse, PortalLink, PortalAgent } from '../../types/portal';
+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('Muestra información detallada de un portal')
-  .argument('<portalId>', 'ID del portal')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .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
@@ -23,49 +24,54 @@ export const getCommand = new Command('get')
       const response = await portal.getPortal(portalId) as PortalResponse;
       const portalDetails = response.portal;
 
-      logger.title('Detalles del portal');
+      logger.title('Portal details');
       logger.label('ID', portalDetails.id);
-      logger.label('Nombre', portalDetails.name);
+      logger.label('Name', portalDetails.name);
       logger.label('URL', portalDetails.url);
-      logger.label('Acceso', portalDetails.access);
-      logger.label('Estado', portalDetails.disabled ? 'Deshabilitado' : 'Habilitado');
+      logger.label('Access', portalDetails.access);
+      logger.label('Status', portalDetails.disabled ? 'Disabled' : 'Enabled');
 
       if (portalDetails.title) {
-        logger.label('Titulo', portalDetails.title);
+        logger.label('Title', portalDetails.title);
       }
       if (portalDetails.subtitle) {
-        logger.label('Subtitulo', portalDetails.subtitle);
+        logger.label('Subtitle', portalDetails.subtitle);
       }
 
       if (portalDetails.logo) {
-        logger.title('Recursos');
+        logger.title('Assets');
         logger.label('Logo', portalDetails.logo);
         if (portalDetails.logodark) {
-          logger.label('Logo (modo oscuro)', portalDetails.logodark);
+          logger.label('Logo (dark mode)', portalDetails.logodark);
         }
       }
 
       if (portalDetails.links && portalDetails.links.length > 0) {
-        logger.title('Enlaces');
+        logger.title('Links');
         portalDetails.links.forEach((link: PortalLink) => {
           logger.label(link.value, link.url);
         });
       }
 
       if (portalDetails.agents && portalDetails.agents.length > 0) {
-        logger.title('Agentes asociados');
+        logger.title('Associated agents');
         portalDetails.agents.forEach((agent: PortalAgent) => {
           logger.label(agent.name, agent.id);
         });
       }
 
       if (options.dev) {
-        logger.warning('\nAmbiente: desarrollo');
+        logger.warning('\nEnvironment: development');
       }
 
     } catch (error) {
-      const message = error instanceof Error ? error.message : 'Error desconocido al obtener detalles del portal';
+      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,15 +1,16 @@
 import { Command } from 'commander';
-import { getCommand } from './get';
-import { deleteCommand } from './delete';
-import { createCommand } from './create';
-import { updateCommand } from './update';
-import { addAgentCommand } from './add-agent';
-import { listCommand } from './list';
-import { addLinkCommand } from './add-link';
-import { clearLinksCommand } from './clear-links';
+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('Comandos relacionados con portales')
+  .description('Commands related to portals')
   .addCommand(listCommand)
   .addCommand(getCommand)
   .addCommand(deleteCommand)
@@ -17,4 +18,15 @@ export const portalCommands = new Command('portal')
   .addCommand(updateCommand)
   .addCommand(addAgentCommand)
   .addCommand(addLinkCommand)
-  .addCommand(clearLinksCommand); 
+  .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' },
+]);