plazbot-cli 0.4.1 → 0.5.1

package/dist/commands/agent/create.js

@@ -2,16 +2,22 @@ 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 { addExamples, addNotes } from '../../utils/help.js';
 import { createSpinner } from '../../utils/ui.js';
+import { jsonOption, isJsonMode, printJson, fail, CliError } from '../../utils/output.js';
+import { requireInteractive } from '../../utils/confirm.js';
 import { runAgentWizard } from './wizard.js';
 import fs from 'fs/promises';
 export const createCommand = new Command('create')
     .description('Create a new AI agent (interactive wizard or JSON file)')
-    .argument('[configPath]', 'Path to the JSON config file (optional)')
+    .argument('[configPath]', 'Path to a JSON config file; omit it to launch the interactive wizard')
+    .addOption(jsonOption('Print the created agent as JSON ({"id","name"})'))
     .option('--dev', 'Use development environment', false)
     .action(async (configPath, options) => {
     try {
+        if (!configPath) {
+            requireInteractive('The agent wizard', 'Pass a JSON file instead: plazbot agent create ./agent.json');
+        }
         const credentials = await getStoredCredentials();
         const agent = new Agent({
             workspaceId: credentials.workspace,
@@ -22,16 +28,28 @@ export const createCommand = new Command('create')
         let agentConfig;
         if (configPath) {
             // Modo archivo: leer JSON
+            let fileContent;
+            try {
+                fileContent = await fs.readFile(configPath, 'utf-8');
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                throw new CliError(`Could not read the config file: ${errorMessage}`, 'file_not_readable');
+            }
             try {
-                const fileContent = await fs.readFile(configPath, 'utf-8');
                 agentConfig = JSON.parse(fileContent);
             }
             catch (error) {
                 const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-                throw new Error(`Failed to read config file: ${errorMessage}`);
+                throw new CliError(`The config file is not valid JSON: ${errorMessage}`, 'invalid_json', `Check it with: plazbot agent validate ${configPath}`);
+            }
+            if (!agentConfig || typeof agentConfig !== 'object' || Array.isArray(agentConfig)) {
+                throw new CliError('The config file must contain a JSON object.', 'invalid_config');
+            }
+            if (!isJsonMode()) {
+                logger.title('Creating agent from file');
+                logger.json(agentConfig);
             }
-            logger.title('Creating agent from file');
-            logger.json(agentConfig);
         }
         else {
             // Modo wizard interactivo
@@ -44,17 +62,39 @@ export const createCommand = new Command('create')
                     default: true,
                 }]);
             if (!confirm) {
-                logger.warning('Creation cancelled');
-                return;
+                logger.dim('Aborted.');
+                process.exit(1);
             }
         }
         const spinner = createSpinner('Creating agent...');
         spinner.start();
-        const result = await agent.addAgent(agentConfig);
+        let result;
+        try {
+            result = await agent.addAgent(agentConfig);
+        }
+        catch (err) {
+            spinner.fail('Could not create the agent');
+            throw err;
+        }
+        if (result?.success === false) {
+            spinner.fail('Could not create the agent');
+            const errors = (Array.isArray(result?.errors) ? result.errors : [])
+                .map((err) => (typeof err === 'string' ? err : JSON.stringify(err)));
+            const base = result.message || 'The API rejected the agent configuration.';
+            const message = errors.length
+                ? `${base.replace(/\.?$/, ':')}\n${errors.map((e, i) => `    ${i + 1}. ${e}`).join('\n')}`
+                : base;
+            throw new CliError(message, 'create_failed', `Check the file with: plazbot agent validate ${configPath || '<file.json>'}`);
+        }
         spinner.succeed('Agent created successfully');
+        const newId = result?.agentId || result?.id;
+        if (isJsonMode()) {
+            printJson({ id: newId ?? null, name: agentConfig.name ?? null });
+            process.exit(0);
+        }
         logger.title('Agent details');
-        if (result.agentId) {
-            logger.label('ID', result.agentId);
+        if (newId) {
+            logger.label('ID', newId);
         }
         if (agentConfig.name) {
             logger.label('Name', agentConfig.name);
@@ -66,17 +106,18 @@ export const createCommand = new Command('create')
             });
         }
         console.log();
-        logger.dim('Next step: plazbot agent chat -a ' + (result.agentId || '<agentId>'));
+        logger.dim('Next steps:');
+        logger.dim(`  plazbot agent chat ${newId || '<agentId>'}       # test it in the terminal`);
+        logger.dim(`  plazbot agent get ${newId || '<agentId>'}        # review the configuration`);
         console.log();
         if (options.dev) {
             logger.warning('Environment: development');
         }
+        // El wizard deja handles abiertos (inquirer); salir explicitamente
         process.exit(0);
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error while creating the agent';
-        logger.error(message);
-        process.exit(1);
+        fail(error);
     }
 });
 addExamples(createCommand, [
@@ -84,6 +125,10 @@ addExamples(createCommand, [
         command: 'plazbot agent create' },
     { description: 'Create directly from a JSON configuration file',
         command: 'plazbot agent create ./agent.json' },
-    { description: 'Create against a local backend (dev mode)',
-        command: 'plazbot agent create ./agent.json --dev' },
+    { description: 'Create from a file and capture the new ID (scripts)',
+        command: "plazbot agent create ./agent.json --json | jq -r '.id'" },
+]);
+addNotes(createCommand, [
+    'The wizard needs an interactive terminal. In CI or scripts, pass a JSON file.',
+    'Validate a file before creating it: plazbot agent validate ./agent.json',
 ]);

package/dist/commands/agent/delete.js

@@ -2,15 +2,18 @@ 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 readline from 'readline';
+import { addExamples, addNotes } from '../../utils/help.js';
+import { createSpinner } from '../../utils/ui.js';
+import { jsonOption, isJsonMode, printJson, fail } from '../../utils/output.js';
+import { addYesOption, confirmAction } from '../../utils/confirm.js';
 export const deleteCommand = new Command('delete')
     .description('Delete an existing agent')
     .argument('<agentId>', 'Agent ID to delete')
-    .option('--dev', 'Use development environment', false)
-    .action(async (agentId, options) => {
+    .addOption(jsonOption('Print the result as JSON ({"id","deleted"})'))
+    .option('--dev', 'Use development environment', false);
+addYesOption(deleteCommand);
+deleteCommand.action(async (agentId, options) => {
     try {
-        // Obtener credenciales guardadas
         const credentials = await getStoredCredentials();
         const agent = new Agent({
             workspaceId: credentials.workspace,
@@ -18,44 +21,52 @@ export const deleteCommand = new Command('delete')
             zone: credentials.zone,
             ...(options.dev && { customUrl: "http://localhost:5090" })
         });
-        // Obtener detalles del agente para mostrar información
+        // Cargar el agente: valida que exista y permite mostrar su nombre en la confirmacion
         const response = await agent.getAgentById({ id: agentId });
-        const agentDetails = response.agent || response.data || response;
-        logger.warning('\nYou are about to delete the following agent:');
-        logger.divider();
-        logger.info(`ID: ${agentDetails.id || agentId}`);
-        logger.info(`Name: ${agentDetails.name || '—'}`);
-        logger.info(`Description: ${agentDetails.description || '—'}`);
-        logger.divider();
-        // Crear interfaz para confirmación
-        const rl = readline.createInterface({
-            input: process.stdin,
-            output: process.stdout
-        });
-        // Preguntar por confirmación
-        rl.question('\nAre you sure you want to delete this agent? (y/N): ', async (answer) => {
-            if (answer.toLowerCase() === 'y') {
-                await agent.deleteAgent({
-                    id: agentId
-                });
-                logger.success('Agent deleted successfully');
-                if (options.dev) {
-                    logger.warning('Environment: development');
-                }
-            }
-            else {
-                logger.error('Operation cancelled');
-            }
-            rl.close();
-        });
+        const agentDetails = response?.agent || response?.data || response || {};
+        const name = agentDetails.name;
+        if (!isJsonMode() && !options.yes && !options.confirm && !options.force) {
+            logger.warning('You are about to delete the following agent:');
+            logger.label('ID', agentDetails.id || agentId);
+            logger.label('Name', name || '—');
+            logger.label('Description', agentDetails.description || '—');
+            console.log();
+        }
+        const ok = await confirmAction(name ? `Delete agent "${name}" (${agentId})? This cannot be undone.` : `Delete agent ${agentId}? This cannot be undone.`, options);
+        if (!ok) {
+            logger.dim('Aborted.');
+            process.exit(1);
+        }
+        const spinner = createSpinner('Deleting agent...');
+        spinner.start();
+        try {
+            await agent.deleteAgent({ id: agentId });
+        }
+        catch (err) {
+            spinner.fail('Could not delete the agent');
+            throw err;
+        }
+        spinner.succeed(name ? `Agent "${name}" deleted` : 'Agent deleted');
+        if (isJsonMode()) {
+            printJson({ id: agentId, ...(name && { name }), deleted: true });
+            return;
+        }
+        if (options.dev) {
+            logger.warning('Environment: development');
+        }
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error while deleting the agent';
-        logger.error(message);
-        process.exit(1);
+        fail(error);
     }
 });
 addExamples(deleteCommand, [
-    { description: 'Delete an agent (asks for y/N confirmation)',
-        command: 'plazbot agent delete agt_AbcDef123' },
+    { description: 'Delete an agent (asks for confirmation)',
+        command: 'plazbot agent delete age_AbcDef123' },
+    { description: 'Delete without prompting (scripts and CI)',
+        command: 'plazbot agent delete age_AbcDef123 --yes' },
+    { description: 'Delete and get a JSON result',
+        command: 'plazbot agent delete age_AbcDef123 --yes --json' },
+]);
+addNotes(deleteCommand, [
+    'Deleting an agent cannot be undone. Export it first if you may need it again: plazbot agent export <agentId> -o agent.json',
 ]);

package/dist/commands/agent/enable-widget.js

@@ -2,15 +2,17 @@ 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 { addExamples, addNotes } from '../../utils/help.js';
+import { createSpinner } from '../../utils/ui.js';
+import { jsonOption, isJsonMode, printJson, fail, CliError } from '../../utils/output.js';
 export const enableCommand = new Command('enable-widget')
-    .description('Enable or disable an agent widget')
+    .description('Enable or disable the web chat widget of an agent')
     .argument('<agentId>', 'Agent ID')
     .option('-d, --disable', 'Disable the widget instead of enabling it')
+    .addOption(jsonOption('Print the result as JSON ({"id","widgetEnabled","script"})'))
     .option('--dev', 'Use development environment', false)
     .action(async (agentId, options) => {
     try {
-        // Obtener credenciales guardadas
         const credentials = await getStoredCredentials();
         const agent = new Agent({
             workspaceId: credentials.workspace,
@@ -18,39 +20,57 @@ export const enableCommand = new Command('enable-widget')
             zone: credentials.zone,
             ...(options.dev && { customUrl: "http://localhost:5090" })
         });
-        // Obtener estado actual del agente
-        const _res = await agent.getAgentById({ id: agentId });
-        const agentDetails = _res.agent || _res.data || _res;
-        logger.title('Current widget status');
-        logger.label('Agent', agentDetails.name);
-        // 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 ? 'enabled' : 'disabled'} successfully`);
-        logger.title('Server response');
-        logger.label('Status', result.success ? 'Success' : 'Failed');
-        logger.label('Message', result.message);
-        if (newState && result.script) {
-            logger.title('Installation instructions');
-            logger.dim('Place this script under the <HEAD> tag of your website:');
-            logger.info('\n' + result.script);
+        const newState = !options.disable;
+        const spinner = createSpinner(`${newState ? 'Enabling' : 'Disabling'} widget...`);
+        spinner.start();
+        let agentDetails;
+        let result;
+        try {
+            // Valida que el agente exista antes de cambiar el widget
+            const res = await agent.getAgentById({ id: agentId });
+            agentDetails = res?.agent || res?.data || res || {};
+            result = await agent.enableWidget({ id: agentId, enable: newState });
+        }
+        catch (err) {
+            spinner.fail(`Could not ${newState ? 'enable' : 'disable'} the widget`);
+            throw err;
+        }
+        if (result?.success === false) {
+            spinner.fail(`Could not ${newState ? 'enable' : 'disable'} the widget`);
+            throw new CliError(result.message || 'The API rejected the request.', 'widget_failed');
+        }
+        spinner.succeed(`Widget ${newState ? 'enabled' : 'disabled'}${agentDetails?.name ? ` for "${agentDetails.name}"` : ''}`);
+        if (isJsonMode()) {
+            printJson({
+                id: agentId,
+                widgetEnabled: newState,
+                ...(newState && result?.script && { script: result.script }),
+            });
+            return;
+        }
+        if (result?.message)
+            logger.dim(result.message);
+        if (newState && result?.script) {
+            logger.title('Installation');
+            logger.dim('Paste this script inside the <head> tag of your website:');
+            logger.info('\n' + result.script + '\n');
         }
         if (options.dev) {
             logger.warning('Environment: development');
         }
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error while updating the widget';
-        logger.error(message);
-        process.exit(1);
+        fail(error);
     }
 });
 addExamples(enableCommand, [
     { description: 'Enable the widget and print the <script> snippet',
-        command: 'plazbot agent enable-widget agt_AbcDef123' },
+        command: 'plazbot agent enable-widget age_AbcDef123' },
     { description: 'Disable an existing widget',
-        command: 'plazbot agent enable-widget agt_AbcDef123 --disable' },
+        command: 'plazbot agent enable-widget age_AbcDef123 --disable' },
+    { description: 'Save the install snippet to a file',
+        command: "plazbot agent enable-widget age_AbcDef123 --json | jq -r '.script' > widget.html" },
+]);
+addNotes(enableCommand, [
+    'Copied agents (copy, cross-copy) start with the widget disabled.',
 ]);