lua-cli 2.5.7 → 2.5.8

package/dist/commands/skills.js

@@ -0,0 +1,438 @@
+/**
+ * Skills Command
+ * Manages agent skills for sandbox and production environments
+ */
+import { loadApiKey, checkApiKey } from '../services/auth.js';
+import { readSkillConfig } from '../utils/files.js';
+import { withErrorHandling, writeProgress, writeSuccess, writeInfo } from '../utils/cli.js';
+import { BASE_URLS } from '../config/constants.js';
+import { safePrompt } from '../utils/prompt-handler.js';
+import { validateConfig, validateAgentConfig, } from '../utils/dev-helpers.js';
+/**
+ * Main skills command - manages agent skills
+ *
+ * Features:
+ * - Environment selection (sandbox/staging or production)
+ * - Sandbox: view local skills from configuration
+ * - Production: view deployed skills, versions, and deploy new versions
+ *
+ * @param env - Optional environment argument ('sandbox', 'staging', or 'production')
+ * @returns Promise that resolves when command completes
+ */
+export async function skillsCommand(env) {
+    return withErrorHandling(async () => {
+        // Step 1: Load configuration first (to get agentId)
+        const config = readSkillConfig();
+        validateConfig(config);
+        validateAgentConfig(config);
+        const agentId = config.agent.agentId;
+        // Step 2: Authenticate
+        const apiKey = await loadApiKey();
+        if (!apiKey) {
+            console.error("❌ No API key found. Please run 'lua auth configure' to set up your API key.");
+            process.exit(1);
+        }
+        await checkApiKey(apiKey);
+        writeProgress("✅ Authenticated");
+        let selectedEnvironment;
+        // Step 3: Check if environment was provided as argument
+        if (env) {
+            // Normalize the environment (staging is an alias for sandbox)
+            const normalizedEnv = env.toLowerCase();
+            if (normalizedEnv === 'sandbox' || normalizedEnv === 'staging') {
+                selectedEnvironment = 'sandbox';
+            }
+            else if (normalizedEnv === 'production') {
+                selectedEnvironment = 'production';
+            }
+            else {
+                console.error(`❌ Invalid environment: "${env}". Must be "sandbox", "staging", or "production".`);
+                console.log('\nUsage:');
+                console.log('  lua skills                   - Interactive selection');
+                console.log('  lua skills sandbox           - View sandbox skills directly');
+                console.log('  lua skills staging           - View staging skills (alias for sandbox)');
+                console.log('  lua skills production        - Manage production skills directly');
+                process.exit(1);
+            }
+        }
+        else {
+            // Step 4: Prompt for environment selection
+            const envAnswer = await safePrompt([
+                {
+                    type: 'list',
+                    name: 'environment',
+                    message: 'Select environment:',
+                    choices: [
+                        { name: '🔧 Sandbox (local skills)', value: 'sandbox' },
+                        { name: '🚀 Production (deployed skills)', value: 'production' }
+                    ]
+                }
+            ]);
+            if (!envAnswer)
+                return;
+            selectedEnvironment = envAnswer.environment;
+        }
+        const context = {
+            environment: selectedEnvironment,
+            agentId,
+            apiKey,
+        };
+        // Step 5: Start management based on environment
+        if (selectedEnvironment === 'sandbox') {
+            await manageSandboxSkills(context, config);
+        }
+        else {
+            await manageProductionSkills(context, config);
+        }
+    }, "skills");
+}
+/**
+ * Manage sandbox skills - view local configuration
+ */
+async function manageSandboxSkills(context, config) {
+    let continueManaging = true;
+    while (continueManaging) {
+        console.log("\n" + "=".repeat(60));
+        console.log("🔧 Sandbox Skills");
+        console.log("=".repeat(60) + "\n");
+        const skills = config.skills || [];
+        if (skills.length === 0) {
+            console.log("ℹ️  No skills found in configuration.");
+            console.log("💡 Run 'lua compile' to add skills to your configuration.\n");
+        }
+        else {
+            console.log("Local skills in lua.skill.yaml:\n");
+            skills.forEach((skill, index) => {
+                console.log(`${index + 1}. 📦 ${skill.name}`);
+                console.log(`   Version: ${skill.version}`);
+                console.log(`   Skill ID: ${skill.skillId}`);
+                console.log();
+            });
+        }
+        const actionAnswer = await safePrompt([
+            {
+                type: 'list',
+                name: 'action',
+                message: 'What would you like to do?',
+                choices: [
+                    { name: '🔄 Refresh list', value: 'refresh' },
+                    { name: '📦 Compile skills', value: 'compile' },
+                    { name: '☁️  Push a skill', value: 'push' },
+                    { name: '❌ Exit', value: 'exit' }
+                ]
+            }
+        ]);
+        if (!actionAnswer)
+            return;
+        const { action } = actionAnswer;
+        switch (action) {
+            case 'refresh':
+                // Reload config
+                const newConfig = readSkillConfig();
+                config.skills = newConfig.skills;
+                break;
+            case 'compile':
+                console.log("\n💡 Run 'lua compile' in your terminal to compile your skills.\n");
+                await safePrompt([{ type: 'input', name: 'continue', message: 'Press Enter to continue...' }]);
+                break;
+            case 'push':
+                console.log("\n💡 Run 'lua push skill' in your terminal to push a skill.\n");
+                await safePrompt([{ type: 'input', name: 'continue', message: 'Press Enter to continue...' }]);
+                break;
+            case 'exit':
+                continueManaging = false;
+                console.log("\n👋 Goodbye!\n");
+                break;
+        }
+    }
+}
+/**
+ * Manage production skills - view and deploy versions
+ */
+async function manageProductionSkills(context, config) {
+    let continueManaging = true;
+    while (continueManaging) {
+        console.log("\n" + "=".repeat(60));
+        console.log("🚀 Production Skills");
+        console.log("=".repeat(60) + "\n");
+        const actionAnswer = await safePrompt([
+            {
+                type: 'list',
+                name: 'action',
+                message: 'What would you like to do?',
+                choices: [
+                    { name: '👁️  View deployed skills', value: 'view' },
+                    { name: '📜 View skill versions', value: 'versions' },
+                    { name: '🚀 Deploy a version', value: 'deploy' },
+                    { name: '❌ Exit', value: 'exit' }
+                ]
+            }
+        ]);
+        if (!actionAnswer)
+            return;
+        const { action } = actionAnswer;
+        switch (action) {
+            case 'view':
+                await viewDeployedSkills(context, config);
+                break;
+            case 'versions':
+                await viewSkillVersions(context, config);
+                break;
+            case 'deploy':
+                await deploySkillVersion(context, config);
+                break;
+            case 'exit':
+                continueManaging = false;
+                console.log("\n👋 Goodbye!\n");
+                break;
+        }
+    }
+}
+/**
+ * View deployed skills in production
+ */
+async function viewDeployedSkills(context, config) {
+    writeProgress("🔄 Loading skill information...");
+    try {
+        const skills = config.skills || [];
+        if (skills.length === 0) {
+            console.log("\nℹ️  No skills found in configuration.\n");
+            await safePrompt([{ type: 'input', name: 'continue', message: 'Press Enter to continue...' }]);
+            return;
+        }
+        console.log("\n" + "=".repeat(60));
+        console.log("⚙️  Production Skills");
+        console.log("=".repeat(60) + "\n");
+        // Fetch version info for each skill
+        for (const skill of skills) {
+            try {
+                const response = await fetch(`${BASE_URLS.API}/developer/skills/${context.agentId}/${skill.skillId}/versions`, {
+                    method: 'GET',
+                    headers: {
+                        'Authorization': `Bearer ${context.apiKey}`,
+                        'Content-Type': 'application/json'
+                    }
+                });
+                if (response.ok) {
+                    const data = await response.json();
+                    const versions = data.data?.versions || data.versions || [];
+                    const activeVersionId = data.data?.activeVersionId || data.activeVersionId;
+                    // Find active version
+                    const activeVersion = versions.find((v) => v.skillId === activeVersionId);
+                    console.log(`📦 ${skill.name}`);
+                    console.log(`   Skill ID: ${skill.skillId}`);
+                    if (activeVersion) {
+                        console.log(`   Deployed Version: ${activeVersion.version} ⭐`);
+                        const date = new Date(activeVersion.createdAt);
+                        console.log(`   Deployed: ${date.toLocaleString()}`);
+                    }
+                    else {
+                        console.log(`   Deployed Version: Not deployed`);
+                    }
+                    console.log(`   Total Versions: ${versions.length}`);
+                    console.log();
+                }
+                else {
+                    console.log(`📦 ${skill.name}`);
+                    console.log(`   Skill ID: ${skill.skillId}`);
+                    console.log(`   Status: Unable to fetch version info`);
+                    console.log();
+                }
+            }
+            catch (error) {
+                console.log(`📦 ${skill.name}`);
+                console.log(`   Skill ID: ${skill.skillId}`);
+                console.log(`   Status: Error loading versions`);
+                console.log();
+            }
+        }
+        console.log("=".repeat(60) + "\n");
+        await safePrompt([{ type: 'input', name: 'continue', message: 'Press Enter to continue...' }]);
+    }
+    catch (error) {
+        console.error('❌ Error loading skill information:', error);
+        await safePrompt([{ type: 'input', name: 'continue', message: 'Press Enter to continue...' }]);
+    }
+}
+/**
+ * View versions for a specific skill
+ */
+async function viewSkillVersions(context, config) {
+    const skills = config.skills || [];
+    if (skills.length === 0) {
+        console.log("\nℹ️  No skills found in configuration.\n");
+        await safePrompt([{ type: 'input', name: 'continue', message: 'Press Enter to continue...' }]);
+        return;
+    }
+    // Prompt to select a skill
+    const skillAnswer = await safePrompt([
+        {
+            type: 'list',
+            name: 'selectedSkill',
+            message: 'Select a skill to view versions:',
+            choices: skills.map((skill) => ({
+                name: `${skill.name} (${skill.skillId})`,
+                value: skill
+            }))
+        }
+    ]);
+    if (!skillAnswer)
+        return;
+    const selectedSkill = skillAnswer.selectedSkill;
+    writeProgress(`🔄 Loading versions for ${selectedSkill.name}...`);
+    try {
+        const response = await fetch(`${BASE_URLS.API}/developer/skills/${context.agentId}/${selectedSkill.skillId}/versions`, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${context.apiKey}`,
+                'Content-Type': 'application/json'
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        const data = await response.json();
+        const versions = data.data?.versions || data.versions || [];
+        const activeVersionId = data.data?.activeVersionId || data.activeVersionId;
+        if (versions.length === 0) {
+            console.log(`\nℹ️  No versions found for ${selectedSkill.name}.\n`);
+            console.log("💡 Push a version first using 'lua push skill'.\n");
+            await safePrompt([{ type: 'input', name: 'continue', message: 'Press Enter to continue...' }]);
+            return;
+        }
+        console.log("\n" + "=".repeat(60));
+        console.log(`📜 Versions for ${selectedSkill.name}`);
+        console.log("=".repeat(60) + "\n");
+        // Sort versions by date (newest first)
+        const sortedVersions = versions.sort((a, b) => {
+            const dateA = new Date(a.createdAt).getTime();
+            const dateB = new Date(b.createdAt).getTime();
+            return dateB - dateA;
+        });
+        sortedVersions.forEach((version, index) => {
+            const isActive = version.skillId === activeVersionId;
+            const date = new Date(version.createdAt);
+            console.log(`${index + 1}. Version ${version.version}${isActive ? ' ⭐ DEPLOYED' : ''}`);
+            console.log(`   Created: ${date.toLocaleString()}`);
+            console.log(`   Version ID: ${version.skillId}`);
+            console.log();
+        });
+        console.log("=".repeat(60) + "\n");
+        await safePrompt([{ type: 'input', name: 'continue', message: 'Press Enter to continue...' }]);
+    }
+    catch (error) {
+        console.error('❌ Error loading versions:', error);
+        await safePrompt([{ type: 'input', name: 'continue', message: 'Press Enter to continue...' }]);
+    }
+}
+/**
+ * Deploy a skill version to production
+ */
+async function deploySkillVersion(context, config) {
+    const skills = config.skills || [];
+    if (skills.length === 0) {
+        console.log("\nℹ️  No skills found in configuration.\n");
+        await safePrompt([{ type: 'input', name: 'continue', message: 'Press Enter to continue...' }]);
+        return;
+    }
+    // Prompt to select a skill
+    const skillAnswer = await safePrompt([
+        {
+            type: 'list',
+            name: 'selectedSkill',
+            message: 'Select a skill to deploy:',
+            choices: skills.map((skill) => ({
+                name: `${skill.name} (${skill.skillId})`,
+                value: skill
+            }))
+        }
+    ]);
+    if (!skillAnswer)
+        return;
+    const selectedSkill = skillAnswer.selectedSkill;
+    writeProgress(`🔄 Loading versions for ${selectedSkill.name}...`);
+    try {
+        const response = await fetch(`${BASE_URLS.API}/developer/skills/${context.agentId}/${selectedSkill.skillId}/versions`, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${context.apiKey}`,
+                'Content-Type': 'application/json'
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        const data = await response.json();
+        const versions = data.data?.versions || data.versions || [];
+        const activeVersionId = data.data?.activeVersionId || data.activeVersionId;
+        if (versions.length === 0) {
+            console.log(`\nℹ️  No versions found for ${selectedSkill.name}.\n`);
+            console.log("💡 Push a version first using 'lua push skill'.\n");
+            await safePrompt([{ type: 'input', name: 'continue', message: 'Press Enter to continue...' }]);
+            return;
+        }
+        // Sort versions by date (newest first)
+        const sortedVersions = versions.sort((a, b) => {
+            const dateA = new Date(a.createdAt).getTime();
+            const dateB = new Date(b.createdAt).getTime();
+            return dateB - dateA;
+        });
+        // Prompt to select a version
+        const versionAnswer = await safePrompt([
+            {
+                type: 'list',
+                name: 'selectedVersion',
+                message: 'Select a version to deploy:',
+                choices: sortedVersions.map((version) => {
+                    const isActive = version.skillId === activeVersionId;
+                    const date = new Date(version.createdAt);
+                    return {
+                        name: `Version ${version.version} (${date.toLocaleDateString()})${isActive ? ' ⭐ CURRENT' : ''}`,
+                        value: version
+                    };
+                })
+            }
+        ]);
+        if (!versionAnswer)
+            return;
+        const selectedVersion = versionAnswer.selectedVersion;
+        // Show warning
+        console.log("\n⚠️  WARNING: You are about to deploy to PRODUCTION!");
+        console.log("⚠️  This will affect ALL users immediately.\n");
+        console.log(`Skill: ${selectedSkill.name}`);
+        console.log(`Version: ${selectedVersion.version}\n`);
+        const confirmAnswer = await safePrompt([
+            {
+                type: 'confirm',
+                name: 'confirm',
+                message: 'Are you absolutely sure you want to deploy this version?',
+                default: false
+            }
+        ]);
+        if (!confirmAnswer || !confirmAnswer.confirm) {
+            console.log("\n❌ Deployment cancelled.\n");
+            return;
+        }
+        writeProgress("🔄 Deploying version...");
+        const deployResponse = await fetch(`${BASE_URLS.API}/developer/skills/${context.agentId}/${selectedSkill.skillId}/${selectedVersion.version}/publish`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${context.apiKey}`,
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({})
+        });
+        if (!deployResponse.ok) {
+            const errorText = await deployResponse.text();
+            console.error(`\n❌ Deploy Error: ${deployResponse.status} - ${errorText}\n`);
+            throw new Error(`HTTP error! status: ${deployResponse.status}`);
+        }
+        writeSuccess(`\n✅ Version ${selectedVersion.version} of "${selectedSkill.name}" deployed successfully to production\n`);
+        writeInfo("💡 The new version is now active for all users.");
+        await safePrompt([{ type: 'input', name: 'continue', message: 'Press Enter to continue...' }]);
+    }
+    catch (error) {
+        console.error('\n❌ Error deploying version:', error);
+        await safePrompt([{ type: 'input', name: 'continue', message: 'Press Enter to continue...' }]);
+    }
+}

package/dist/common/data.entry.instance.d.ts

@@ -39,4 +39,11 @@ export default class DataEntryInstance {
      * @throws Error if the deletion fails
      */
     delete(): Promise<boolean>;
+    /**
+     * Saves the data entry
+     * @param searchText - Optional search text for vector search indexing
+     * @returns Promise resolving to true if saving was successful
+     * @throws Error if the save operation fails
+     */
+    save(searchText?: string): Promise<boolean>;
 }

package/dist/common/data.entry.instance.js

@@ -144,4 +144,19 @@ export default class DataEntryInstance {
             throw new Error('Failed to clear user data');
         }
     }
+    /**
+     * Saves the data entry
+     * @param searchText - Optional search text for vector search indexing
+     * @returns Promise resolving to true if saving was successful
+     * @throws Error if the save operation fails
+     */
+    async save(searchText) {
+        try {
+            await this.customDataAPI.update(this.collectionName, this.id, { data: this.data, searchText: searchText });
+            return true;
+        }
+        catch (error) {
+            throw new Error('Failed to save data entry');
+        }
+    }
 }

package/dist/common/order.instance.d.ts

@@ -40,4 +40,10 @@ export default class OrderInstance {
      * @throws Error if the data update fails
      */
     update(data: Record<string, any>): Promise<any>;
+    /**
+     * Saves the order's data
+     * @returns Promise resolving to true if saving was successful
+     * @throws Error if the save operation fails
+     */
+    save(): Promise<boolean>;
 }

package/dist/common/order.instance.js

@@ -170,4 +170,18 @@ export default class OrderInstance {
             id: this.id
         };
     }
+    /**
+     * Saves the order's data
+     * @returns Promise resolving to true if saving was successful
+     * @throws Error if the save operation fails
+     */
+    async save() {
+        try {
+            await this.orderAPI.updateData(this.data, this.id);
+            return true;
+        }
+        catch (error) {
+            throw new Error('Failed to save order data');
+        }
+    }
 }

package/dist/common/product.instance.d.ts

@@ -33,4 +33,10 @@ export default class ProductInstance {
      * @throws Error if the deletion fails or the product is not found
      */
     delete(): Promise<Product>;
+    /**
+     * Saves the product's data
+     * @returns Promise resolving to true if saving was successful
+     * @throws Error if the save operation fails
+     */
+    save(): Promise<boolean>;
 }

package/dist/common/product.instance.js

@@ -127,4 +127,18 @@ export default class ProductInstance {
         }
         return this.data;
     }
+    /**
+     * Saves the product's data
+     * @returns Promise resolving to true if saving was successful
+     * @throws Error if the save operation fails
+     */
+    async save() {
+        try {
+            await this.productAPI.update(this.data, this.data.id);
+            return true;
+        }
+        catch (error) {
+            throw new Error('Failed to save product data');
+        }
+    }
 }

package/dist/common/user.instance.d.ts

@@ -1,3 +1,4 @@
+import { Message } from "../interfaces/message.js";
 import { UserDataAPI } from "../types/index.js";
 /**
  * User data instance class providing a fluent API for managing user data
@@ -33,4 +34,17 @@ export default class UserDataInstance {
      * @throws Error if the clear operation fails
      */
     clear(): Promise<boolean>;
+    /**
+     * Saves the user's data
+     * @returns Promise resolving to true if saving was successful
+     * @throws Error if the save operation fails
+     */
+    save(): Promise<boolean>;
+    /**
+     * Sends a message to a specific user conversation for the agent
+     * @param messages - An array of messages to send (can be text, image, or file types)
+     * @returns Promise resolving to the response data from the server
+     * @throws Error if the message sending fails or the request is unsuccessful
+     */
+    send(messages: Message[]): Promise<any>;
 }

package/dist/common/user.instance.js

@@ -129,4 +129,33 @@ export default class UserDataInstance {
             throw new Error('Failed to clear user data');
         }
     }
+    /**
+     * Saves the user's data
+     * @returns Promise resolving to true if saving was successful
+     * @throws Error if the save operation fails
+     */
+    async save() {
+        try {
+            await this.userAPI.update(this.data);
+            return true;
+        }
+        catch (error) {
+            throw new Error('Failed to save user data');
+        }
+    }
+    /**
+     * Sends a message to a specific user conversation for the agent
+     * @param messages - An array of messages to send (can be text, image, or file types)
+     * @returns Promise resolving to the response data from the server
+     * @throws Error if the message sending fails or the request is unsuccessful
+     */
+    async send(messages) {
+        try {
+            await this.userAPI.sendMessage(messages);
+            return true;
+        }
+        catch (error) {
+            throw new Error('Failed to send message');
+        }
+    }
 }

package/dist/index.js

@@ -37,13 +37,24 @@ Examples:
   $ lua init               🚀 Initialize a new project
   $ lua compile            📦 Compile your skills
   $ lua test               🧪 Test tools interactively
-  $ lua push               ☁️  Push to server
+  $ lua push               ☁️  Push to server (interactive)
+  $ lua push skill         ☁️  Push skill directly
+  $ lua push persona       ☁️  Push persona directly
   $ lua deploy             🚀 Deploy to production
   $ lua chat               💬 Start interactive chat
-  $ lua env                ⚙️  Manage environment variables
-  $ lua persona            🤖 Manage agent persona
+  $ lua env                ⚙️  Manage environment variables (interactive)
+  $ lua env staging        ⚙️  Manage staging env vars directly
+  $ lua env production     ⚙️  Manage production env vars directly
+  $ lua persona            🤖 Manage agent persona (interactive)
+  $ lua persona staging    🤖 Manage staging persona directly
+  $ lua persona production 🤖 Manage production persona directly
+  $ lua skills             ⚙️  Manage skills (interactive)
+  $ lua skills staging     ⚙️  View staging skills directly
+  $ lua skills production  ⚙️  Manage production skills directly
+  $ lua features           🎯 Manage agent features
   $ lua admin              🔧 Open admin dashboard
   $ lua docs               📖 Open documentation
+  $ lua completion         🎯 Enable shell autocomplete
 
 🌙 Documentation: https://docs.heylua.ai
 🌙 Support: https://heylua.ai/support

package/dist/interfaces/agent.d.ts

@@ -307,3 +307,34 @@ export interface CreateEmailChannelResponse {
     forwardTo: string;
     status: string;
 }
+/**
+ * Agent feature configuration.
+ * Represents a feature that can be enabled/disabled for an agent.
+ */
+export interface AgentFeature {
+    name: string;
+    title: string;
+    context: string;
+    active: boolean;
+}
+/**
+ * Response from get agent features API.
+ */
+export interface GetAgentFeaturesResponse {
+    features: AgentFeature[];
+}
+/**
+ * Request payload for updating an agent feature.
+ * At least one of active or featureContext must be provided.
+ */
+export interface UpdateAgentFeatureRequest {
+    featureName: string;
+    active?: boolean;
+    featureContext?: string;
+}
+/**
+ * Response from updating an agent feature.
+ */
+export interface UpdateAgentFeatureResponse {
+    message: string;
+}

package/dist/interfaces/message.d.ts

@@ -0,0 +1,18 @@
+export type TextMessage = {
+    type: "text";
+    text: string;
+};
+export type ImageMessage = {
+    type: "image";
+    image: string;
+    mimeType: string;
+};
+export type FileMessage = {
+    type: "file";
+    data: string;
+    mimeType: string;
+};
+export type Message = TextMessage | ImageMessage | FileMessage;
+export interface SendMessageRequest {
+    messages: Message[];
+}

package/dist/interfaces/message.js

@@ -0,0 +1 @@
+export {};