plazbot-cli 0.2.25 → 0.3.1

package/src/commands/workers/secret.ts

@@ -1,27 +1,39 @@
 import { Command } from 'commander';
-import { getStoredCredentials } from '../../utils/credentials';
-import { createApiClient } from '../../utils/api';
-import { logger } from '../../utils/logger';
-import { createSpinner, createTable, theme, formatDate } from '../../utils/ui';
-import { WorkerSecretItem } from '../../types/workers';
+import { getStoredCredentials } from '../../utils/credentials.js';
+import { createApiClient } from '../../utils/api.js';
+import { logger } from '../../utils/logger.js';
+import { addExamples } from '../../utils/help.js';
+import { createSpinner, createTable, theme, formatDate } from '../../utils/ui.js';
+import { WorkerSecretItem } from '../../types/workers.js';
 import readline from 'readline';
 
 // ── Comando padre: secret ───────────────────────────────────────────────────
 
 export const secretCommand = new Command('secret')
-  .description('Gestionar secrets (variables de entorno) de los workers')
+  .description('Manage worker secrets (environment variables)')
   .addCommand(secretSetCommand())
   .addCommand(secretListCommand())
   .addCommand(secretRemoveCommand());
 
+addExamples(secretCommand, [
+  { description: 'Save (or update) an API key as a secret',
+    command: 'plazbot workers secret set STRIPE_API_KEY sk_live_xxxxx' },
+  { description: 'List every secret (values are hidden)',
+    command: 'plazbot workers secret list' },
+  { description: 'Delete a secret with confirmation prompt',
+    command: 'plazbot workers secret remove STRIPE_API_KEY' },
+  { description: 'Delete a secret without confirmation',
+    command: 'plazbot workers secret remove STRIPE_API_KEY -f' },
+]);
+
 // ── secret set ──────────────────────────────────────────────────────────────
 
 function secretSetCommand(): Command {
   return new Command('set')
-    .description('Crear o actualizar un secret')
-    .argument('<key>', 'Nombre del secret (ej: STRIPE_API_KEY)')
-    .argument('<value>', 'Valor del secret')
-    .option('--dev', 'Usar ambiente de desarrollo', false)
+    .description('Create or update a secret')
+    .argument('<key>', 'Secret name (e.g.: STRIPE_API_KEY)')
+    .argument('<value>', 'Secret value')
+    .option('--dev', 'Use development environment', false)
     .action(async (key: string, value: string, options: { dev?: boolean }) => {
       try {
         const credentials = await getStoredCredentials();
@@ -32,21 +44,21 @@ function secretSetCommand(): Command {
           dev: options.dev,
         });
 
-        const spinner = createSpinner(`Guardando secret "${key}"...`);
+        const spinner = createSpinner(`Saving secret "${key}"...`);
         spinner.start();
 
         await api.put('/api/worker/secrets', { key, value });
 
-        spinner.succeed(`Secret "${key}" guardado`);
-        logger.dim(`  Disponible en tus workers como plz.env.${key}`);
+        spinner.succeed(`Secret "${key}" saved`);
+        logger.dim(`  Available in your workers as plz.env.${key}`);
         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);
       }
@@ -57,8 +69,8 @@ function secretSetCommand(): Command {
 
 function secretListCommand(): Command {
   return new Command('list')
-    .description('Lista todos los secrets del workspace (sin mostrar valores)')
-    .option('--dev', 'Usar ambiente de desarrollo', false)
+    .description('List all secrets in the workspace (without showing values)')
+    .option('--dev', 'Use development environment', false)
     .action(async (options: { dev?: boolean }) => {
       try {
         const credentials = await getStoredCredentials();
@@ -69,7 +81,7 @@ function secretListCommand(): Command {
           dev: options.dev,
         });
 
-        const spinner = createSpinner('Obteniendo secrets...');
+        const spinner = createSpinner('Fetching secrets...');
         spinner.start();
 
         const response = await api.get('/api/worker/secrets');
@@ -78,8 +90,8 @@ function secretListCommand(): Command {
         spinner.stop();
 
         if (!secrets || secrets.length === 0) {
-          logger.info('\n  No hay secrets configurados');
-          logger.dim('  Agrega uno: plazbot workers secret set MI_KEY mi_valor');
+          logger.info('\n  No secrets configured');
+          logger.dim('  Add one: plazbot workers secret set MY_KEY my_value');
           console.log();
           return;
         }
@@ -93,18 +105,18 @@ function secretListCommand(): Command {
         ]);
 
         console.log(createTable(
-          ['Key', 'Valor', 'Actualizado'],
+          ['Key', 'Value', 'Updated'],
           rows,
         ));
 
         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);
       }
@@ -115,10 +127,10 @@ function secretListCommand(): Command {
 
 function secretRemoveCommand(): Command {
   return new Command('remove')
-    .description('Elimina un secret del workspace')
-    .argument('<key>', 'Nombre del secret a eliminar')
-    .option('-f, --force', 'Eliminar sin confirmacion', false)
-    .option('--dev', 'Usar ambiente de desarrollo', false)
+    .description('Delete a secret from the workspace')
+    .argument('<key>', 'Name of the secret to delete')
+    .option('-f, --force', 'Delete without confirmation', false)
+    .option('--dev', 'Use development environment', false)
     .action(async (key: string, options: { dev?: boolean; force?: boolean }) => {
       try {
         const credentials = await getStoredCredentials();
@@ -131,32 +143,32 @@ function secretRemoveCommand(): Command {
 
         if (!options.force) {
           const confirmed = await askConfirmation(
-            `  Eliminar secret "${key}"? (y/N): `
+            `  Delete secret "${key}"? (y/N): `
           );
 
           if (!confirmed) {
-            logger.info('\n  Operacion cancelada');
+            logger.info('\n  Operation cancelled');
             process.exit(0);
           }
         }
 
-        const spinner = createSpinner(`Eliminando secret "${key}"...`);
+        const spinner = createSpinner(`Deleting secret "${key}"...`);
         spinner.start();
 
         await api.delete(`/api/worker/secrets/${encodeURIComponent(key)}`);
 
-        spinner.succeed(`Secret "${key}" eliminado`);
+        spinner.succeed(`Secret "${key}" deleted`);
         console.log();
 
         if (options.dev) {
-          logger.warning('Ambiente: desarrollo');
+          logger.warning('Environment: development');
         }
 
       } catch (error: any) {
         if (error.response?.status === 404) {
-          logger.error(`Secret "${key}" no encontrado`);
+          logger.error(`Secret "${key}" not found`);
         } else {
-          const message = error instanceof Error ? error.message : 'Error desconocido';
+          const message = error instanceof Error ? error.message : 'Unknown error';
           logger.error(message);
         }
         process.exit(1);

package/src/commands/workers/test.ts

@@ -1,8 +1,9 @@
 import { Command } from 'commander';
-import { getStoredCredentials } from '../../utils/credentials';
-import { createApiClient } from '../../utils/api';
-import { logger } from '../../utils/logger';
-import { createSpinner, theme } from '../../utils/ui';
+import { getStoredCredentials } from '../../utils/credentials.js';
+import { createApiClient } from '../../utils/api.js';
+import { logger } from '../../utils/logger.js';
+import { addExamples } from '../../utils/help.js';
+import { createSpinner, theme } from '../../utils/ui.js';
 
 interface WorkerTestResult {
   success: boolean;
@@ -12,13 +13,13 @@ interface WorkerTestResult {
 }
 
 export const testCommand = new Command('test')
-  .description('Ejecutar un worker manualmente para probarlo')
-  .argument('<name>', 'Nombre del worker a ejecutar')
-  .option('-p, --payload <json>', 'Payload JSON para el worker (ej: \'{"producto":"iPhone"}\')')
-  .option('-t, --type <type>', 'Tipo del worker (tool, worker, sync, schedule, webhook)')
-  .option('--contact <id>', 'ID del contacto (contexto para tools)')
-  .option('--agent <id>', 'ID del agente (contexto para tools)')
-  .option('--dev', 'Usar ambiente de desarrollo', false)
+  .description('Run a worker manually to test it')
+  .argument('<name>', 'Name of the worker to run')
+  .option('-p, --payload <json>', 'JSON payload for the worker (e.g.: \'{"product":"iPhone"}\')')
+  .option('-t, --type <type>', 'Worker type (tool, worker, sync, schedule, webhook)')
+  .option('--contact <id>', 'Contact ID (context for tools)')
+  .option('--agent <id>', 'Agent ID (context for tools)')
+  .option('--dev', 'Use development environment', false)
   .action(async (name: string, options: {
     payload?: string;
     type?: string;
@@ -41,13 +42,13 @@ export const testCommand = new Command('test')
         try {
           payload = JSON.parse(options.payload);
         } catch {
-          logger.error('El payload no es JSON valido');
-          logger.dim('Ejemplo: --payload \'{"producto":"iPhone 15"}\'');
+          logger.error('Payload is not valid JSON');
+          logger.dim('Example: --payload \'{"product":"iPhone 15"}\'');
           process.exit(1);
         }
       }
 
-      logger.title(`Ejecutando worker "${name}"`);
+      logger.title(`Running worker "${name}"`);
       console.log();
 
       if (Object.keys(payload).length > 0) {
@@ -55,7 +56,7 @@ export const testCommand = new Command('test')
         console.log();
       }
 
-      const spinner = createSpinner('Ejecutando...');
+      const spinner = createSpinner('Running...');
       spinner.start();
 
       const response = await api.post('/api/worker/execute', {
@@ -73,16 +74,16 @@ export const testCommand = new Command('test')
       spinner.stop();
 
       if (data.success) {
-        logger.success(`Ejecutado en ${duration}ms`);
+        logger.success(`Completed in ${duration}ms`);
       } else {
-        logger.error(`Fallo en ${duration}ms`);
+        logger.error(`Failed in ${duration}ms`);
       }
 
       console.log();
 
       // Mostrar resultado
       if (data.result !== undefined && data.result !== null) {
-        logger.label('Resultado', '');
+        logger.label('Result', '');
 
         const result = data.result as Record<string, unknown>;
 
@@ -117,17 +118,28 @@ export const testCommand = new Command('test')
       console.log();
 
       if (options.dev) {
-        logger.warning('Ambiente: desarrollo');
+        logger.warning('Environment: development');
       }
 
     } catch (error: any) {
       if (error.response?.status === 404) {
-        logger.error(`Worker "${name}" no encontrado o inactivo`);
-        logger.dim('Verifica que el worker este desplegado con: plazbot workers list');
+        logger.error(`Worker "${name}" not found or inactive`);
+        logger.dim('Verify the worker is deployed with: plazbot workers list');
       } else {
-        const message = error.response?.data?.message || error.message || 'Error desconocido';
+        const message = error.response?.data?.message || error.message || 'Unknown error';
         logger.error(message);
       }
       process.exit(1);
     }
   });
+
+addExamples(testCommand, [
+  { description: 'Run a worker without payload',
+    command: 'plazbot workers test my-tool' },
+  { description: 'Run a worker with a JSON payload',
+    command: 'plazbot workers test get-stock -p \'{"product":"iPhone 15"}\'' },
+  { description: 'Run a tool with contact and agent context',
+    command: 'plazbot workers test my-tool --contact ctc_AbcDef123 --agent agt_AbcDef123' },
+  { description: 'Run against the local backend',
+    command: 'plazbot workers test my-tool --dev' },
+]);