lua-cli 3.12.2 → 3.14.0

package/dist/commands/channels.js

@@ -2,13 +2,14 @@
  * Channels Command
  * Manages agent communication channels (list, create)
  */
-import inquirer from "inquirer";
+import inquirer from 'inquirer';
 import open from 'open';
-import { withErrorHandling, writeSuccess, writeInfo, clearPromptLines, writeProgress } from "../utils/cli.js";
-import { initializeCommand } from "../utils/command-utils.js";
+import { withErrorHandling, writeSuccess, writeInfo, clearPromptLines, writeProgress } from '../utils/cli.js';
+import { initializeCommand } from '../utils/command-utils.js';
 import AgentApi from '../api/agent.api.service.js';
 import { BASE_URLS } from '../config/constants.js';
 import { trackEvent } from '../services/analytics.js';
+import { validateOrSuggest } from '../utils/aliases.js';
 // ─────────────────────────────────────────────────────────────────────────────
 // Main Command Entry
 // ─────────────────────────────────────────────────────────────────────────────
@@ -32,7 +33,7 @@ export async function channelsCommand(action) {
             await channelsInteractive(agentApi, agentId, apiKey, config);
         }
         trackEvent('cli_channels_action', { action: action || 'interactive', non_interactive: !!action });
-    }, "channels management");
+    }, 'channels management');
 }
 // ─────────────────────────────────────────────────────────────────────────────
 // Shared Core Functions
@@ -53,12 +54,12 @@ async function fetchChannelsCore(agentApi, agentId) {
  */
 function getChannelIcon(type) {
     const icons = {
-        'whatsapp': '📱',
-        'facebook': '💬',
-        'instagram': '📸',
-        'slack': '💼',
-        'email': '📧',
-        'webchat': '💻'
+        whatsapp: '📱',
+        facebook: '💬',
+        instagram: '📸',
+        slack: '💼',
+        email: '📧',
+        webchat: '💻',
     };
     return icons[type] || '📡';
 }
@@ -85,11 +86,11 @@ function getChannelLabel(channel) {
  * Displays all channels (non-interactive).
  */
 function displayChannelsCore(channels) {
-    console.log("\n" + "=".repeat(60));
-    console.log("📡 Agent Channels");
-    console.log("=".repeat(60) + "\n");
+    console.log('\n' + '='.repeat(60));
+    console.log('📡 Agent Channels');
+    console.log('='.repeat(60) + '\n');
     if (channels.length === 0) {
-        console.log("ℹ️  No channels configured for this agent.");
+        console.log('ℹ️  No channels configured for this agent.');
         console.log("💡 Use 'lua channels' (interactive) to add channels.\n");
         return;
     }
@@ -103,28 +104,18 @@ function displayChannelsCore(channels) {
         console.log(`   Created: ${created}`);
         console.log();
     });
-    console.log("=".repeat(60));
+    console.log('='.repeat(60));
     console.log(`Total: ${channels.length} channel(s)`);
 }
 // ─────────────────────────────────────────────────────────────────────────────
 // Non-Interactive Mode
 // ─────────────────────────────────────────────────────────────────────────────
 async function executeNonInteractive(agentApi, agentId, action) {
-    const validActions = ['list'];
-    const normalizedAction = action.toLowerCase();
-    if (!validActions.includes(normalizedAction)) {
-        console.error(`❌ Invalid action: "${action}"`);
-        console.log('\nValid actions: list');
-        console.log('\nNote: Channel creation requires interactive mode.');
-        console.log('\nExamples:');
-        console.log('  lua channels list    List all channels');
-        console.log('  lua channels         Interactive mode');
-        throw new Error("Invalid action:");
-    }
+    action = validateOrSuggest('channels.action', action);
     writeInfo(`📡 Fetching channels for agent: ${agentId}...`);
     const channels = await fetchChannelsCore(agentApi, agentId);
     if (!channels)
-        throw new Error("Operation failed");
+        throw new Error('Operation failed');
     displayChannelsCore(channels);
 }
 // ─────────────────────────────────────────────────────────────────────────────
@@ -133,25 +124,25 @@ async function executeNonInteractive(agentApi, agentId, action) {
 async function channelsInteractive(agentApi, agentId, apiKey, config) {
     const { operation } = await inquirer.prompt([
         {
-            type: "list",
-            name: "operation",
-            message: "What would you like to do?",
+            type: 'list',
+            name: 'operation',
+            message: 'What would you like to do?',
             choices: [
-                { name: "📋 List channels", value: "list" },
-                { name: "🔗 Link new channel", value: "create" },
-                { name: "🌐 Link on admin dashboard", value: "admin" }
-            ]
-        }
+                { name: '📋 List channels', value: 'list' },
+                { name: '🔗 Link new channel', value: 'create' },
+                { name: '🌐 Link on admin dashboard', value: 'admin' },
+            ],
+        },
     ]);
     clearPromptLines(2);
     trackEvent('cli_channels_interactive_action', { operation });
-    if (operation === "list") {
+    if (operation === 'list') {
         await listChannelsInteractive(agentApi, agentId, config);
     }
-    else if (operation === "create") {
+    else if (operation === 'create') {
         await createChannel(agentApi, agentId);
     }
-    else if (operation === "admin") {
+    else if (operation === 'admin') {
         await openAdminDashboard(apiKey, config);
     }
 }
@@ -182,10 +173,10 @@ async function listChannelsInteractive(agentApi, agentId, config) {
     writeInfo(`📡 Fetching channels for agent: ${agentId}...`);
     const channels = await fetchChannelsCore(agentApi, agentId);
     if (!channels)
-        throw new Error("Operation failed");
+        throw new Error('Operation failed');
     writeSuccess(`✅ Found ${channels.length} channel(s)\n`);
     if (channels.length === 0) {
-        writeInfo("No channels configured for this agent.");
+        writeInfo('No channels configured for this agent.');
         writeInfo("\n💡 Use the 'Create new channel' option to add channels.\n");
         return;
     }
@@ -194,20 +185,20 @@ async function listChannelsInteractive(agentApi, agentId, config) {
         const label = getChannelLabel(channel);
         return {
             name: `${icon} ${channel.type.toUpperCase()} - ${label}`,
-            value: index
+            value: index,
         };
     });
     channelChoices.push({
         name: '← Back to main menu',
-        value: -1
+        value: -1,
     });
     const { selectedIndex } = await inquirer.prompt([
         {
-            type: "list",
-            name: "selectedIndex",
-            message: "Select a channel to view details:",
-            choices: channelChoices
-        }
+            type: 'list',
+            name: 'selectedIndex',
+            message: 'Select a channel to view details:',
+            choices: channelChoices,
+        },
     ]);
     if (selectedIndex === -1) {
         return;
@@ -374,34 +365,34 @@ function displayEmailDetails(channel) {
 async function createChannel(agentApi, agentId) {
     const { channelType } = await inquirer.prompt([
         {
-            type: "list",
-            name: "channelType",
-            message: "Select channel type:",
+            type: 'list',
+            name: 'channelType',
+            message: 'Select channel type:',
             choices: [
-                { name: "📱 WhatsApp", value: "whatsapp" },
-                { name: "💬 Facebook Messenger", value: "facebook" },
-                { name: "📧 Email", value: "email" },
-                { name: "🔒 Slack (Private)", value: "slack-private" },
-                { name: "🌐 Slack (Public)", value: "slack-public" }
-            ]
-        }
+                { name: '📱 WhatsApp', value: 'whatsapp' },
+                { name: '💬 Facebook Messenger', value: 'facebook' },
+                { name: '📧 Email', value: 'email' },
+                { name: '🔒 Slack (Private)', value: 'slack-private' },
+                { name: '🌐 Slack (Public)', value: 'slack-public' },
+            ],
+        },
     ]);
     clearPromptLines(2);
     trackEvent('cli_channel_created', { channel_type: channelType });
     switch (channelType) {
-        case "whatsapp":
+        case 'whatsapp':
             await createWhatsAppChannel(agentApi, agentId);
             break;
-        case "facebook":
+        case 'facebook':
             await createFacebookChannel(agentApi, agentId);
             break;
-        case "email":
+        case 'email':
             await createEmailChannel(agentApi, agentId);
             break;
-        case "slack-private":
+        case 'slack-private':
             await createSlackPrivateChannel(agentApi, agentId);
             break;
-        case "slack-public":
+        case 'slack-public':
             await createSlackPublicChannel(agentApi, agentId);
             break;
     }
@@ -410,44 +401,44 @@ async function createChannel(agentApi, agentId) {
  * Creates a WhatsApp channel
  */
 async function createWhatsAppChannel(agentApi, agentId) {
-    writeInfo("📱 Creating WhatsApp Channel\n");
+    writeInfo('📱 Creating WhatsApp Channel\n');
     const answers = await inquirer.prompt([
         {
-            type: "input",
-            name: "phoneNumberId",
-            message: "Enter phone number ID:",
+            type: 'input',
+            name: 'phoneNumberId',
+            message: 'Enter phone number ID:',
             validate: (input) => {
-                return input.trim().length > 0 || "Phone number ID is required";
-            }
+                return input.trim().length > 0 || 'Phone number ID is required';
+            },
         },
         {
-            type: "input",
-            name: "wabaId",
-            message: "Enter WhatsApp Business Account ID (WABA ID):",
+            type: 'input',
+            name: 'wabaId',
+            message: 'Enter WhatsApp Business Account ID (WABA ID):',
             validate: (input) => {
-                return input.trim().length > 0 || "WABA ID is required";
-            }
+                return input.trim().length > 0 || 'WABA ID is required';
+            },
         },
         {
-            type: "password",
-            name: "accessToken",
-            message: "Enter access token:",
-            mask: "*",
+            type: 'password',
+            name: 'accessToken',
+            message: 'Enter access token:',
+            mask: '*',
             validate: (input) => {
-                return input.trim().length > 0 || "Access token is required";
-            }
-        }
+                return input.trim().length > 0 || 'Access token is required';
+            },
+        },
     ]);
     const channelData = {
-        type: "whatsapp",
+        type: 'whatsapp',
         whatsapp: {
             phoneNumberId: answers.phoneNumberId.trim(),
             wabaId: answers.wabaId.trim(),
-            accessToken: answers.accessToken.trim()
+            accessToken: answers.accessToken.trim(),
         },
-        isManual: true
+        isManual: true,
     };
-    writeInfo("\n📡 Creating WhatsApp channel...");
+    writeInfo('\n📡 Creating WhatsApp channel...');
     const response = await agentApi.createWhatsAppChannel(agentId, channelData);
     if (!response.success) {
         const error = response.error;
@@ -462,10 +453,10 @@ async function createWhatsAppChannel(agentApi, agentId) {
                 console.error(`   ${error.error}\n`);
             }
         }
-        throw new Error("Operation failed");
+        throw new Error('Operation failed');
     }
     const data = response.data;
-    writeSuccess("\n✅ WhatsApp channel created successfully!\n");
+    writeSuccess('\n✅ WhatsApp channel created successfully!\n');
     writeInfo(`📞 Phone Number: ${data.whatsapp.number}`);
     writeInfo(`🆔 Identifier: ${data.identifier}`);
     writeInfo(`✅ Status: ${data.whatsapp.metadata.status}`);
@@ -475,34 +466,34 @@ async function createWhatsAppChannel(agentApi, agentId) {
  * Creates a Facebook Messenger channel
  */
 async function createFacebookChannel(agentApi, agentId) {
-    writeInfo("💬 Creating Facebook Messenger Channel\n");
+    writeInfo('💬 Creating Facebook Messenger Channel\n');
     const answers = await inquirer.prompt([
         {
-            type: "password",
-            name: "accessToken",
-            message: "Enter Facebook page access token:",
-            mask: "*",
+            type: 'password',
+            name: 'accessToken',
+            message: 'Enter Facebook page access token:',
+            mask: '*',
             validate: (input) => {
-                return input.trim().length > 0 || "Access token is required";
-            }
+                return input.trim().length > 0 || 'Access token is required';
+            },
         },
         {
-            type: "input",
-            name: "pageId",
-            message: "Enter Facebook page ID:",
+            type: 'input',
+            name: 'pageId',
+            message: 'Enter Facebook page ID:',
             validate: (input) => {
-                return input.trim().length > 0 || "Page ID is required";
-            }
-        }
+                return input.trim().length > 0 || 'Page ID is required';
+            },
+        },
     ]);
     const channelData = {
-        type: "facebook",
+        type: 'facebook',
         facebook: {
             accessToken: answers.accessToken.trim(),
-            pageId: answers.pageId.trim()
-        }
+            pageId: answers.pageId.trim(),
+        },
     };
-    writeInfo("\n📡 Creating Facebook channel...");
+    writeInfo('\n📡 Creating Facebook channel...');
     const response = await agentApi.createFacebookChannel(agentId, channelData);
     if (!response.success) {
         const error = response.error;
@@ -517,10 +508,10 @@ async function createFacebookChannel(agentApi, agentId) {
                 console.error(`   ${error.error}\n`);
             }
         }
-        throw new Error("Operation failed");
+        throw new Error('Operation failed');
     }
     const data = response.data;
-    writeSuccess("\n✅ Facebook channel created successfully!\n");
+    writeSuccess('\n✅ Facebook channel created successfully!\n');
     writeInfo(`📄 Page Name: ${data.facebook.name}`);
     writeInfo(`🆔 Identifier: ${data.identifier}`);
     writeInfo(`📋 Category: ${data.facebook.category}`);
@@ -530,57 +521,57 @@ async function createFacebookChannel(agentApi, agentId) {
  * Creates an Email channel
  */
 async function createEmailChannel(agentApi, agentId) {
-    writeInfo("📧 Creating Email Channel\n");
+    writeInfo('📧 Creating Email Channel\n');
     const { mode } = await inquirer.prompt([
         {
-            type: "list",
-            name: "mode",
-            message: "Select email channel mode:",
+            type: 'list',
+            name: 'mode',
+            message: 'Select email channel mode:',
             choices: [
-                { name: "📬 Generate new inbox (Lua creates an email address for you)", value: "generated" },
-                { name: "📧 Use existing email (forward from your own address)", value: "existing" }
-            ]
-        }
+                { name: '📬 Generate new inbox (Lua creates an email address for you)', value: 'generated' },
+                { name: '📧 Use existing email (forward from your own address)', value: 'existing' },
+            ],
+        },
     ]);
     clearPromptLines(2);
     const { displayName } = await inquirer.prompt([
         {
-            type: "input",
-            name: "displayName",
-            message: "Enter display name (shown in email header):",
+            type: 'input',
+            name: 'displayName',
+            message: 'Enter display name (shown in email header):',
             validate: (input) => {
-                return input.trim().length > 0 || "Display name is required";
-            }
-        }
+                return input.trim().length > 0 || 'Display name is required';
+            },
+        },
     ]);
     const channelData = {
-        type: "email",
+        type: 'email',
         email: {
             mode: mode,
             displayName: displayName.trim(),
-        }
+        },
     };
-    if (mode === "existing") {
+    if (mode === 'existing') {
         const { email } = await inquirer.prompt([
             {
-                type: "input",
-                name: "email",
-                message: "Enter sender email address:",
+                type: 'input',
+                name: 'email',
+                message: 'Enter sender email address:',
                 validate: (input) => {
                     if (input.trim().length === 0) {
-                        return "Email address is required";
+                        return 'Email address is required';
                     }
                     const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
                     if (!emailRegex.test(input.trim())) {
-                        return "Please enter a valid email address";
+                        return 'Please enter a valid email address';
                     }
                     return true;
-                }
-            }
+                },
+            },
         ]);
         channelData.email.email = email.trim();
     }
-    writeInfo("\n📡 Creating Email channel...");
+    writeInfo('\n📡 Creating Email channel...');
     const response = await agentApi.createEmailChannel(agentId, channelData);
     if (!response.success) {
         const error = response.error;
@@ -595,12 +586,12 @@ async function createEmailChannel(agentApi, agentId) {
                 console.error(`   ${error.error}\n`);
             }
         }
-        throw new Error("Operation failed");
+        throw new Error('Operation failed');
     }
     const data = response.data;
-    writeSuccess("\n✅ Email channel created successfully!\n");
+    writeSuccess('\n✅ Email channel created successfully!\n');
     writeInfo(`📧 Display Name:    ${displayName}`);
-    if (mode === "generated") {
+    if (mode === 'generated') {
         const generatedData = data;
         writeInfo(`📬 Email Address:   ${generatedData.emailAddress}\n`);
         writeInfo(`${'─'.repeat(60)}`);
@@ -632,32 +623,32 @@ async function createEmailChannel(agentApi, agentId) {
  * Creates a private Slack channel
  */
 async function createSlackPrivateChannel(agentApi, agentId) {
-    writeInfo("🔒 Creating Private Slack Channel\n");
+    writeInfo('🔒 Creating Private Slack Channel\n');
     const answers = await inquirer.prompt([
         {
-            type: "password",
-            name: "accessToken",
-            message: "Enter Slack bot access token (xoxb-...):",
-            mask: "*",
+            type: 'password',
+            name: 'accessToken',
+            message: 'Enter Slack bot access token (xoxb-...):',
+            mask: '*',
             validate: (input) => {
                 if (input.trim().length === 0) {
-                    return "Access token is required";
+                    return 'Access token is required';
                 }
-                if (!input.trim().startsWith("xoxb-")) {
+                if (!input.trim().startsWith('xoxb-')) {
                     return "Bot token should start with 'xoxb-'";
                 }
                 return true;
-            }
-        }
+            },
+        },
     ]);
     const channelData = {
-        type: "slack",
+        type: 'slack',
         slack: {
-            type: "private",
-            accessToken: answers.accessToken.trim()
-        }
+            type: 'private',
+            accessToken: answers.accessToken.trim(),
+        },
     };
-    writeInfo("\n📡 Creating Slack private channel...");
+    writeInfo('\n📡 Creating Slack private channel...');
     const response = await agentApi.createSlackChannel(agentId, channelData);
     if (!response.success) {
         const error = response.error;
@@ -672,11 +663,11 @@ async function createSlackPrivateChannel(agentApi, agentId) {
                 console.error(`   ${error.error}\n`);
             }
         }
-        throw new Error("Operation failed");
+        throw new Error('Operation failed');
     }
     const data = response.data;
     if ('slack' in data && 'botName' in data.slack) {
-        writeSuccess("\n✅ Slack private channel created successfully!\n");
+        writeSuccess('\n✅ Slack private channel created successfully!\n');
         writeInfo(`🤖 Bot Name: ${data.slack.botName}`);
         writeInfo(`🏢 Workspace: ${data.slack.url}`);
         writeInfo(`🆔 Bot ID: ${data.slack.botId}`);
@@ -688,44 +679,44 @@ async function createSlackPrivateChannel(agentApi, agentId) {
  * Creates a public Slack channel
  */
 async function createSlackPublicChannel(agentApi, agentId) {
-    writeInfo("🌐 Creating Public Slack Channel\n");
+    writeInfo('🌐 Creating Public Slack Channel\n');
     const answers = await inquirer.prompt([
         {
-            type: "input",
-            name: "appId",
-            message: "Enter Slack app ID:",
+            type: 'input',
+            name: 'appId',
+            message: 'Enter Slack app ID:',
             validate: (input) => {
-                return input.trim().length > 0 || "App ID is required";
-            }
+                return input.trim().length > 0 || 'App ID is required';
+            },
         },
         {
-            type: "input",
-            name: "clientId",
-            message: "Enter Slack client ID:",
+            type: 'input',
+            name: 'clientId',
+            message: 'Enter Slack client ID:',
             validate: (input) => {
-                return input.trim().length > 0 || "Client ID is required";
-            }
+                return input.trim().length > 0 || 'Client ID is required';
+            },
         },
         {
-            type: "password",
-            name: "clientSecret",
-            message: "Enter Slack client secret:",
-            mask: "*",
+            type: 'password',
+            name: 'clientSecret',
+            message: 'Enter Slack client secret:',
+            mask: '*',
             validate: (input) => {
-                return input.trim().length > 0 || "Client secret is required";
-            }
-        }
+                return input.trim().length > 0 || 'Client secret is required';
+            },
+        },
     ]);
     const channelData = {
-        type: "slack",
+        type: 'slack',
         slack: {
-            type: "public",
+            type: 'public',
             appId: answers.appId.trim(),
             clientId: answers.clientId.trim(),
-            clientSecret: answers.clientSecret.trim()
-        }
+            clientSecret: answers.clientSecret.trim(),
+        },
     };
-    writeInfo("\n📡 Creating Slack public channel...");
+    writeInfo('\n📡 Creating Slack public channel...');
     const response = await agentApi.createSlackChannel(agentId, channelData);
     if (!response.success) {
         const error = response.error;
@@ -740,11 +731,11 @@ async function createSlackPublicChannel(agentApi, agentId) {
                 console.error(`   ${error.error}\n`);
             }
         }
-        throw new Error("Operation failed");
+        throw new Error('Operation failed');
     }
     const data = response.data;
     if ('redirectUri' in data) {
-        writeSuccess("\n✅ Slack public channel created successfully!\n");
+        writeSuccess('\n✅ Slack public channel created successfully!\n');
         writeInfo(`🆔 App ID: ${data.appId}`);
         writeInfo(`🔗 Redirect URI: ${data.redirectUri}`);
         writeInfo(`🔗 Webhook URL: ${data.webhookUrl}\n`);