lua-cli 2.5.2 → 2.5.4

package/README.md

@@ -313,6 +313,12 @@ lua deploy            # Deploy version to production
 lua dev               # Development mode with live reload
 ```
 
+### Utilities
+```bash
+lua admin             # Open Lua Admin Dashboard in browser
+lua docs              # Open documentation in browser
+```
+
 **See [CLI_REFERENCE.md](CLI_REFERENCE.md) for complete command documentation.**
 
 ---

package/dist/api/agent.api.service.d.ts

@@ -5,6 +5,15 @@ import { AgentType } from "../interfaces/agent.js";
 import { CreateAgentRequest } from "../interfaces/agent.js";
 import { CreateAgentResponse } from "../interfaces/agent.js";
 import { Agent } from "../interfaces/agent.js";
+import { AgentChannelsResponse } from "../interfaces/agent.js";
+import { CreateWhatsAppChannelRequest } from "../interfaces/agent.js";
+import { CreateWhatsAppChannelResponse } from "../interfaces/agent.js";
+import { CreateFacebookChannelRequest } from "../interfaces/agent.js";
+import { CreateFacebookChannelResponse } from "../interfaces/agent.js";
+import { CreateSlackChannelRequest } from "../interfaces/agent.js";
+import { CreateSlackChannelResponse } from "../interfaces/agent.js";
+import { CreateEmailChannelRequest } from "../interfaces/agent.js";
+import { CreateEmailChannelResponse } from "../interfaces/agent.js";
 /**
  * Agent API calls
  */
@@ -42,4 +51,47 @@ export default class AgentApi extends HttpClient {
      * @throws Error if the API request fails or the agent is not found
      */
     getAgent(agentId: string): Promise<ApiResponse<Agent>>;
+    /**
+     * Retrieves all communication channels connected to a specific agent
+     * @param agentId - The unique identifier of the agent
+     * @returns Promise resolving to an ApiResponse containing channels and available channel links
+     * @throws Error if the API request fails or the agent is not found
+     */
+    getAgentChannels(agentId: string): Promise<ApiResponse<AgentChannelsResponse>>;
+    /**
+     * Creates a new WhatsApp channel for a specific agent
+     * @param agentId - The unique identifier of the agent
+     * @param channelData - The WhatsApp channel configuration including phoneNumberId, wabaId, and accessToken
+     * @returns Promise resolving to an ApiResponse containing the created WhatsApp channel details
+     * @throws Error if the API request fails or the channel creation is unsuccessful
+     */
+    createWhatsAppChannel(agentId: string, channelData: CreateWhatsAppChannelRequest): Promise<ApiResponse<CreateWhatsAppChannelResponse>>;
+    /**
+     * Creates a new Facebook Messenger channel for a specific agent
+     * @param agentId - The unique identifier of the agent
+     * @param channelData - The Facebook channel configuration including accessToken and pageId
+     * @returns Promise resolving to an ApiResponse containing the created Facebook channel details
+     * @throws Error if the API request fails or the channel creation is unsuccessful
+     */
+    createFacebookChannel(agentId: string, channelData: CreateFacebookChannelRequest): Promise<ApiResponse<CreateFacebookChannelResponse>>;
+    /**
+     * Creates a new Slack channel for a specific agent (supports both private and public channels)
+     * @param agentId - The unique identifier of the agent
+     * @param channelData - The Slack channel configuration
+     *   - For private: requires accessToken
+     *   - For public: requires appId, clientId, and clientSecret
+     * @returns Promise resolving to an ApiResponse containing the created Slack channel details
+     *   - Private channels return bot configuration and workspace details
+     *   - Public channels return OAuth configuration and redirect URI
+     * @throws Error if the API request fails or the channel creation is unsuccessful
+     */
+    createSlackChannel(agentId: string, channelData: CreateSlackChannelRequest): Promise<ApiResponse<CreateSlackChannelResponse>>;
+    /**
+     * Creates a new Email channel for a specific agent
+     * @param agentId - The unique identifier of the agent
+     * @param channelData - The Email channel configuration including sender name and email address
+     * @returns Promise resolving to an ApiResponse containing the forward-to email address
+     * @throws Error if the API request fails or the channel creation is unsuccessful
+     */
+    createEmailChannel(agentId: string, channelData: CreateEmailChannelRequest): Promise<ApiResponse<CreateEmailChannelResponse>>;
 }

package/dist/api/agent.api.service.js

@@ -54,4 +54,67 @@ export default class AgentApi extends HttpClient {
             Authorization: `Bearer ${this.apiKey}`,
         });
     }
+    /**
+     * Retrieves all communication channels connected to a specific agent
+     * @param agentId - The unique identifier of the agent
+     * @returns Promise resolving to an ApiResponse containing channels and available channel links
+     * @throws Error if the API request fails or the agent is not found
+     */
+    async getAgentChannels(agentId) {
+        return this.httpGet(`/admin/agents/${agentId}/channels`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Creates a new WhatsApp channel for a specific agent
+     * @param agentId - The unique identifier of the agent
+     * @param channelData - The WhatsApp channel configuration including phoneNumberId, wabaId, and accessToken
+     * @returns Promise resolving to an ApiResponse containing the created WhatsApp channel details
+     * @throws Error if the API request fails or the channel creation is unsuccessful
+     */
+    async createWhatsAppChannel(agentId, channelData) {
+        return this.httpPost(`/admin/agents/${agentId}/channels`, channelData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Creates a new Facebook Messenger channel for a specific agent
+     * @param agentId - The unique identifier of the agent
+     * @param channelData - The Facebook channel configuration including accessToken and pageId
+     * @returns Promise resolving to an ApiResponse containing the created Facebook channel details
+     * @throws Error if the API request fails or the channel creation is unsuccessful
+     */
+    async createFacebookChannel(agentId, channelData) {
+        return this.httpPost(`/admin/agents/${agentId}/channels`, channelData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Creates a new Slack channel for a specific agent (supports both private and public channels)
+     * @param agentId - The unique identifier of the agent
+     * @param channelData - The Slack channel configuration
+     *   - For private: requires accessToken
+     *   - For public: requires appId, clientId, and clientSecret
+     * @returns Promise resolving to an ApiResponse containing the created Slack channel details
+     *   - Private channels return bot configuration and workspace details
+     *   - Public channels return OAuth configuration and redirect URI
+     * @throws Error if the API request fails or the channel creation is unsuccessful
+     */
+    async createSlackChannel(agentId, channelData) {
+        return this.httpPost(`/admin/agents/${agentId}/channels`, channelData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Creates a new Email channel for a specific agent
+     * @param agentId - The unique identifier of the agent
+     * @param channelData - The Email channel configuration including sender name and email address
+     * @returns Promise resolving to an ApiResponse containing the forward-to email address
+     * @throws Error if the API request fails or the channel creation is unsuccessful
+     */
+    async createEmailChannel(agentId, channelData) {
+        return this.httpPost(`/admin/agents/${agentId}/channels`, channelData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
 }

package/dist/api/logs.api.service.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Logs API Service
+ * Handles log retrieval for agents and skills
+ */
+import { HttpClient } from "../common/http.client.js";
+import { ApiResponse } from "../interfaces/common.js";
+import { LogsResponse } from "../interfaces/logs.js";
+export default class LogsApi extends HttpClient {
+    private apiKey;
+    /**
+     * Creates an instance of LogsApi
+     * @param baseUrl - The base URL for the API
+     * @param apiKey - The API key for authentication
+     */
+    constructor(baseUrl: string, apiKey: string);
+    /**
+     * Retrieves logs for an agent
+     * @param agentId - The unique identifier of the agent
+     * @param limit - Number of logs per page (default: 20)
+     * @param page - Page number (default: 1)
+     * @returns Promise resolving to an ApiResponse containing logs and pagination
+     * @throws Error if the API request fails
+     */
+    getAgentLogs(agentId: string, limit?: number, page?: number): Promise<ApiResponse<LogsResponse>>;
+    /**
+     * Retrieves logs for a specific skill
+     * @param agentId - The unique identifier of the agent
+     * @param skillId - The unique identifier of the skill
+     * @param limit - Number of logs per page (default: 20)
+     * @param page - Page number (default: 1)
+     * @returns Promise resolving to an ApiResponse containing logs and pagination
+     * @throws Error if the API request fails
+     */
+    getSkillLogs(agentId: string, skillId: string, limit?: number, page?: number): Promise<ApiResponse<LogsResponse>>;
+}

package/dist/api/logs.api.service.js

@@ -0,0 +1,43 @@
+/**
+ * Logs API Service
+ * Handles log retrieval for agents and skills
+ */
+import { HttpClient } from "../common/http.client.js";
+export default class LogsApi extends HttpClient {
+    /**
+     * Creates an instance of LogsApi
+     * @param baseUrl - The base URL for the API
+     * @param apiKey - The API key for authentication
+     */
+    constructor(baseUrl, apiKey) {
+        super(baseUrl);
+        this.apiKey = apiKey;
+    }
+    /**
+     * Retrieves logs for an agent
+     * @param agentId - The unique identifier of the agent
+     * @param limit - Number of logs per page (default: 20)
+     * @param page - Page number (default: 1)
+     * @returns Promise resolving to an ApiResponse containing logs and pagination
+     * @throws Error if the API request fails
+     */
+    async getAgentLogs(agentId, limit = 20, page = 1) {
+        return this.httpGet(`/developer/agents/${agentId}/logs?limit=${limit}&page=${page}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Retrieves logs for a specific skill
+     * @param agentId - The unique identifier of the agent
+     * @param skillId - The unique identifier of the skill
+     * @param limit - Number of logs per page (default: 20)
+     * @param page - Page number (default: 1)
+     * @returns Promise resolving to an ApiResponse containing logs and pagination
+     * @throws Error if the API request fails
+     */
+    async getSkillLogs(agentId, skillId, limit = 20, page = 1) {
+        return this.httpGet(`/developer/skills/${agentId}/${skillId}/logs?limit=${limit}&page=${page}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+}

package/dist/cli/command-definitions.js

@@ -2,7 +2,7 @@
  * Command Definitions
  * Centralized command structure for the CLI
  */
-import { configureCommand, initCommand, destroyCommand, apiKeyCommand, compileCommand, testCommand, pushCommand, deployCommand, chatCommand, chatClearCommand, envCommand, personaCommand, productionCommand, resourcesCommand } from "../commands/index.js";
+import { configureCommand, initCommand, destroyCommand, apiKeyCommand, compileCommand, testCommand, pushCommand, deployCommand, chatCommand, chatClearCommand, envCommand, personaCommand, productionCommand, resourcesCommand, adminCommand, docsCommand, channelsCommand, logsCommand } from "../commands/index.js";
 /**
  * Sets up authentication-related commands.
  *
@@ -101,4 +101,20 @@ Examples:
         .command("resources")
         .description("📚 Manage agent resources and knowledge base")
         .action(resourcesCommand);
+    program
+        .command("admin")
+        .description("🔧 Open Lua Admin Dashboard in browser")
+        .action(adminCommand);
+    program
+        .command("docs")
+        .description("📖 Open Lua documentation in browser")
+        .action(docsCommand);
+    program
+        .command("channels")
+        .description("📡 Manage agent communication channels")
+        .action(channelsCommand);
+    program
+        .command("logs")
+        .description("📊 View agent and skill logs")
+        .action(logsCommand);
 }

package/dist/commands/admin.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Admin Command
+ * Opens the Lua Admin Dashboard in the user's default browser
+ */
+/**
+ * Admin command - opens the Lua admin dashboard in the browser.
+ *
+ * This command:
+ * 1. Loads the API key from secure storage
+ * 2. Reads the agent configuration (agentId and orgId)
+ * 3. Constructs the admin dashboard URL with authentication
+ * 4. Opens the URL in the user's default browser
+ *
+ * The admin dashboard provides access to:
+ * - Usage analytics and metrics
+ * - Agent configuration
+ * - Billing and subscription management
+ * - Team management
+ * - API key management
+ *
+ * @returns Promise that resolves when browser is launched
+ */
+export declare function adminCommand(): Promise<void>;

package/dist/commands/admin.js

@@ -0,0 +1,62 @@
+/**
+ * Admin Command
+ * Opens the Lua Admin Dashboard in the user's default browser
+ */
+import open from 'open';
+import { loadApiKey } from '../services/auth.js';
+import { readSkillConfig } from '../utils/files.js';
+import { withErrorHandling, writeSuccess, writeProgress } from '../utils/cli.js';
+/**
+ * Admin command - opens the Lua admin dashboard in the browser.
+ *
+ * This command:
+ * 1. Loads the API key from secure storage
+ * 2. Reads the agent configuration (agentId and orgId)
+ * 3. Constructs the admin dashboard URL with authentication
+ * 4. Opens the URL in the user's default browser
+ *
+ * The admin dashboard provides access to:
+ * - Usage analytics and metrics
+ * - Agent configuration
+ * - Billing and subscription management
+ * - Team management
+ * - API key management
+ *
+ * @returns Promise that resolves when browser is launched
+ */
+export async function adminCommand() {
+    return withErrorHandling(async () => {
+        writeProgress('Opening Lua Admin Dashboard...');
+        // Load API key from secure storage
+        const apiKey = await loadApiKey();
+        if (!apiKey) {
+            throw new Error('No API key found. Please run "lua configure" first.');
+        }
+        // Read skill configuration
+        let config;
+        try {
+            config = readSkillConfig();
+        }
+        catch (error) {
+            throw new Error('Could not read lua.skill.yaml. Please ensure you are in a Lua skill directory, or run "lua init" to create a new skill.');
+        }
+        // Extract agentId and orgId from config
+        const agentId = config?.agent?.agentId;
+        const orgId = config?.agent?.orgId;
+        if (!agentId) {
+            throw new Error('No agentId found in lua.skill.yaml. Please ensure your configuration is valid.');
+        }
+        if (!orgId) {
+            throw new Error('No orgId found in lua.skill.yaml. Please ensure your configuration is valid.');
+        }
+        // Construct the admin dashboard URL
+        // This URL authenticates with the API key and redirects to the usage page
+        const adminUrl = `https://admin.heylua.ai/validate-token/${apiKey}?redirect=/admin/usage?&agentId=${agentId}&orgId=${orgId}&hideToolBar=true`;
+        // Open the URL in the default browser
+        await open(adminUrl);
+        writeSuccess('Lua Admin Dashboard opened in your browser');
+        console.log(`\n  Dashboard URL: https://admin.heylua.ai`);
+        console.log(`  Agent ID: ${agentId}`);
+        console.log(`  Organization ID: ${orgId}\n`);
+    }, 'admin');
+}

package/dist/commands/channels.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Channels Command
+ * Manages agent communication channels (list, create)
+ */
+/**
+ * Main channels command - manages agent communication channels.
+ *
+ * This command provides:
+ * 1. List all channels for an agent
+ * 2. Create new channels (WhatsApp, Facebook, Slack)
+ *
+ * The agent ID is automatically loaded from lua.skill.yaml
+ *
+ * @returns Promise that resolves when the operation is complete
+ * @throws Error if API key is not found or API call fails
+ */
+export declare function channelsCommand(): Promise<void>;