lua-cli 2.3.0 → 2.4.0

package/dist/errors/auth.error.js

@@ -0,0 +1,27 @@
+/**
+ * Authentication Error
+ * Thrown when API requests fail with 401 Unauthorized status
+ */
+export class AuthenticationError extends Error {
+    constructor(message = "Invalid API key") {
+        super(message);
+        this.statusCode = 401;
+        this.isAuthenticationError = true;
+        this.name = "AuthenticationError";
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, AuthenticationError);
+        }
+    }
+    /**
+     * Checks if an error is an AuthenticationError
+     * @param error - The error to check
+     * @returns True if the error is an AuthenticationError
+     */
+    static isAuthenticationError(error) {
+        return (error instanceof AuthenticationError ||
+            (error instanceof Error &&
+                "isAuthenticationError" in error &&
+                error.isAuthenticationError === true));
+    }
+}

package/dist/errors/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Error types and utilities
+ */
+export { AuthenticationError } from "./auth.error.js";

package/dist/errors/index.js

@@ -0,0 +1,4 @@
+/**
+ * Error types and utilities
+ */
+export { AuthenticationError } from "./auth.error.js";

package/dist/index.d.ts

@@ -6,15 +6,6 @@
  * Provides tools for authentication, project initialization, compilation,
  * testing, deployment, and development.
  *
- * Usage:
- *   lua auth configure        # Set up authentication
- *   lua init                  # Initialize new project
- *   lua compile               # Compile skill
- *   lua test                  # Test tools
- *   lua push                  # Push to server
- *   lua deploy                # Deploy to production
- *   lua dev                   # Start development mode
- *
  * For more information: https://docs.heylua.ai
  */
 export {};

package/dist/index.js

@@ -6,15 +6,6 @@
  * Provides tools for authentication, project initialization, compilation,
  * testing, deployment, and development.
  *
- * Usage:
- *   lua auth configure        # Set up authentication
- *   lua init                  # Initialize new project
- *   lua compile               # Compile skill
- *   lua test                  # Test tools
- *   lua push                  # Push to server
- *   lua deploy                # Deploy to production
- *   lua dev                   # Start development mode
- *
  * For more information: https://docs.heylua.ai
  */
 import { Command } from "commander";
@@ -24,8 +15,36 @@ const program = new Command();
 // Configure program metadata
 program
     .name("lua")
-    .description("Lua AI Skill Management CLI")
-    .version("2.3.0");
+    .description("Lua AI - Build and deploy AI agents with superpowers")
+    .version("2.4.0")
+    .addHelpText('before', `
+------------------------------------------------------------------
+  Lua AI CLI v2.4.0 - Build and deploy AI agents with superpowers
+------------------------------------------------------------------
+`)
+    .addHelpText('after', `
+Categories:
+  🔐 Authentication    Manage API keys and authentication
+  🚀 Project Setup     Initialize and configure projects
+  📦 Development       Build and test your skills locally
+  ☁️  Deployment       Push and deploy to production
+  💬 Testing          Chat and test your agent
+  ⚙️  Configuration    Manage environment and persona
+
+Examples:
+  $ lua auth configure      🔑 Set up your API key
+  $ lua init               🚀 Initialize a new project
+  $ lua compile            📦 Compile your skills
+  $ lua test               🧪 Test tools interactively
+  $ lua push               ☁️  Push to server
+  $ lua deploy             🚀 Deploy to production
+  $ lua chat               💬 Start interactive chat
+  $ lua env                ⚙️  Manage environment variables
+  $ lua persona            🤖 Manage agent persona
+
+🌙 Documentation: https://docs.heylua.ai
+🌙 Support: https://heylua.ai/support
+`);
 // Set up all command groups
 setupAuthCommands(program);
 setupSkillCommands(program);

package/dist/interfaces/agent.d.ts

@@ -46,62 +46,46 @@ export interface CreateAgentRequest {
  * Response from agent creation API.
  */
 export interface CreateAgentResponse {
-    success: boolean;
-    data?: {
-        agentId: string;
-        name: string;
-        baseAgentId: string;
-        persona: string;
-        createdAt: string;
-        welcomeMessage: string;
-        featuresOverride: Record<string, any>;
+    agentId: string;
+    name: string;
+    baseAgentId: string;
+    persona: string;
+    createdAt: string;
+    welcomeMessage: string;
+    featuresOverride: Record<string, any>;
+    _id: string;
+    updatedAt: string;
+    __v: number;
+    org: {
+        registeredName: string;
+        type: string;
+        agents: string[];
+        paymentMethods: any[];
         _id: string;
-        updatedAt: string;
+        id: string;
+        createdAt: number;
         __v: number;
-        org: {
-            registeredName: string;
-            type: string;
-            agents: string[];
-            paymentMethods: any[];
-            _id: string;
-            id: string;
-            createdAt: number;
-            __v: number;
-        };
-    };
-    error?: {
-        message: string;
-        error: string;
-        statusCode: number;
     };
 }
 /**
  * Response from get agent details API.
  */
 export interface AgentDetailsResponse {
-    success: boolean;
-    data?: {
-        _id: string;
-        agentId: string;
-        name: string;
-        baseAgentId: string;
-        persona: string;
-        createdAt: string;
-        welcomeMessage: string;
-        featuresOverride: Record<string, any>;
-        updatedAt: string;
-        __v: number;
-        personaConfig: {
-            agentName: string;
-            businessType: string;
-            brandPersonality: string;
-            brandTraits: string;
-        };
-        skills: any[];
-    };
-    error?: {
-        message: string;
-        error: string;
-        statusCode: number;
+    _id: string;
+    agentId: string;
+    name: string;
+    baseAgentId: string;
+    persona: string;
+    createdAt: string;
+    welcomeMessage: string;
+    featuresOverride: Record<string, any>;
+    updatedAt: string;
+    __v: number;
+    personaConfig: {
+        agentName: string;
+        businessType: string;
+        brandPersonality: string;
+        brandTraits: string;
     };
+    skills: any[];
 }

package/dist/services/auth.d.ts

@@ -27,11 +27,10 @@ export declare function loadApiKey(): Promise<string | null>;
 export declare function deleteApiKey(): Promise<boolean>;
 /**
  * Validates an API key with the server and retrieves user data.
- * This function will exit the process if the API key is invalid.
  *
  * @param apiKey - The API key to validate
  * @returns Promise resolving to user data including admin info and organizations
- * @throws Exits process with code 1 if API key is invalid
+ * @throws AuthenticationError if the API key is invalid
  */
 export declare function checkApiKey(apiKey: string): Promise<UserData>;
 /**

package/dist/services/auth.js

@@ -6,6 +6,7 @@ import keytar from "keytar";
 import AuthApi from "../api/auth.api.service.js";
 import { BASE_URLS } from "../config/constants.js";
 import { KEYTAR_SERVICE, KEYTAR_ACCOUNT } from "../config/auth.constants.js";
+import { AuthenticationError } from "../errors/auth.error.js";
 // ============================================================================
 // KEYTAR OPERATIONS (Secure Local Storage)
 // ============================================================================
@@ -42,18 +43,16 @@ export async function deleteApiKey() {
 // ============================================================================
 /**
  * Validates an API key with the server and retrieves user data.
- * This function will exit the process if the API key is invalid.
  *
  * @param apiKey - The API key to validate
  * @returns Promise resolving to user data including admin info and organizations
- * @throws Exits process with code 1 if API key is invalid
+ * @throws AuthenticationError if the API key is invalid
  */
 export async function checkApiKey(apiKey) {
     const authApi = new AuthApi(BASE_URLS.API);
     const result = await authApi.checkApiKey(apiKey);
     if (!result.success) {
-        console.error(`❌ Invalid API key`);
-        process.exit(1);
+        throw new AuthenticationError("Invalid API key");
     }
     return result.data;
 }

package/dist/utils/bundling.js

@@ -8,6 +8,66 @@ import { build } from "esbuild";
 import { writeProgress } from "./cli.js";
 import { COMPILE_DIRS, COMPILE_FILES, ESBUILD_TOOL_CONFIG, ESBUILD_INDEX_CONFIG, DEFAULT_INPUT_SCHEMA, } from '../config/compile.constants.js';
 import { wrapToolForVM, createExecuteFunction, evaluateZodSchemaToJsonSchema, } from './compile.js';
+/**
+ * esbuild plugin to inject sandbox globals instead of requiring lua-cli
+ * This removes require("lua-cli") statements and injects the global API objects
+ * that are available in the sandbox (Product, User, Data, Baskets, Order)
+ */
+const sandboxGlobalsPlugin = {
+    name: 'sandbox-globals',
+    setup(build) {
+        // Only process user files, not node_modules
+        build.onLoad({ filter: /\.([jt]sx?)$/, namespace: 'file' }, async (args) => {
+            // Skip node_modules
+            if (args.path.includes('node_modules')) {
+                return null;
+            }
+            const contents = await fs.promises.readFile(args.path, 'utf8');
+            // Only transform files that import from lua-cli
+            if (!contents.includes('lua-cli')) {
+                return null;
+            }
+            // Replace lua-cli imports with global references
+            let transformedContents = contents;
+            // Replace named imports from lua-cli
+            // Match: import { Products, User, Data, etc. } from "lua-cli"
+            transformedContents = transformedContents.replace(/import\s+{([^}]+)}\s+from\s+["']lua-cli["'];?/g, (match, imports) => {
+                // Just remove the import, globals will be available in sandbox
+                return '// lua-cli imports removed - using sandbox globals';
+            });
+            // Replace lua-cli/skill imports - keep env and LuaTool as they might be needed
+            transformedContents = transformedContents.replace(/import\s+{([^}]+)}\s+from\s+["']lua-cli\/skill["'];?/g, (match, imports) => {
+                // Check if env is imported, if so we need to keep a reference
+                if (imports.includes('env')) {
+                    return '// lua-cli/skill imports removed - env available in sandbox';
+                }
+                return '// lua-cli/skill imports removed - using sandbox globals';
+            });
+            // Map import names to sandbox global names
+            // Products -> Product, Orders -> Order, etc.
+            const globalMappings = {
+                'Products': 'Products',
+                'User': 'User',
+                'Data': 'Data',
+                'Baskets': 'Baskets',
+                'Orders': 'Orders'
+            };
+            // Replace usage of imported names with globals
+            for (const [importName, globalName] of Object.entries(globalMappings)) {
+                // Replace standalone usage (e.g., Products.method() -> Product.method())
+                const regex = new RegExp(`\\b${importName}\\.`, 'g');
+                transformedContents = transformedContents.replace(regex, `${globalName}.`);
+            }
+            // Note: env function and LuaTool interface are already available in sandbox
+            // env is a function in the sandbox context (see sandbox.ts line 333)
+            return {
+                contents: transformedContents,
+                loader: args.path.endsWith('.ts') ? 'ts' :
+                    args.path.endsWith('.tsx') ? 'tsx' : 'js'
+            };
+        });
+    },
+};
 /**
  * Bundles a tool's TypeScript code into a standalone JavaScript file.
  * Uses esbuild to:
@@ -26,6 +86,7 @@ export async function bundleTool(tool, distDir) {
             ...ESBUILD_TOOL_CONFIG,
             entryPoints: [tool.filePath],
             outfile: outputPath,
+            plugins: [sandboxGlobalsPlugin],
         });
         // Wrap the bundled code for VM execution environment
         await wrapToolForVM(outputPath, tool);

package/dist/utils/cli.js

@@ -1,6 +1,7 @@
 /**
  * Centralized CLI utilities for consistent error handling and output management
  */
+import { AuthenticationError } from "../errors/auth.error.js";
 /**
  * Wraps a command function with standardized error handling
  * Handles SIGINT (Ctrl+C) gracefully and provides consistent error messages
@@ -14,6 +15,11 @@ export async function withErrorHandling(commandFn, commandName) {
             console.log("\n❌ Operation cancelled.");
             process.exit(0);
         }
+        if (AuthenticationError.isAuthenticationError(error)) {
+            console.error(`❌ Authentication failed: ${error.message}`);
+            console.error("💡 Run 'lua auth configure' to update your API key.");
+            process.exit(1);
+        }
         console.error(`❌ Error during ${commandName}:`, error.message);
         process.exit(1);
     }

package/dist/utils/deploy-helpers.d.ts

@@ -3,6 +3,14 @@
  * Helper functions for deployment operations
  */
 import { VersionInfo } from '../interfaces/deploy.js';
+/**
+ * Selected skill for deployment.
+ */
+export interface SelectedSkillForDeploy {
+    name: string;
+    version: string;
+    skillId: string;
+}
 /**
  * Formats a version for display in the selection list.
  *
@@ -30,6 +38,13 @@ export declare function promptVersionSelection(versions: VersionInfo[]): Promise
  * @returns True if confirmed, false otherwise
  */
 export declare function confirmDeployment(): Promise<boolean>;
+/**
+ * Prompts user to select a skill from available skills.
+ *
+ * @param skills - Array of available skills
+ * @returns Selected skill
+ */
+export declare function promptSkillSelection(skills: SelectedSkillForDeploy[]): Promise<SelectedSkillForDeploy>;
 /**
  * Validates that configuration has required fields for deployment.
  *
@@ -37,6 +52,13 @@ export declare function confirmDeployment(): Promise<boolean>;
  * @throws Error if configuration is invalid
  */
 export declare function validateDeployConfig(config: any): void;
+/**
+ * Gets available skills from configuration.
+ *
+ * @param config - Skill configuration
+ * @returns Array of available skills
+ */
+export declare function getAvailableSkills(config: any): SelectedSkillForDeploy[];
 /**
  * Validates that versions are available for deployment.
  *

package/dist/utils/deploy-helpers.js

@@ -62,6 +62,28 @@ export async function confirmDeployment() {
     clearPromptLines(2);
     return confirmed;
 }
+/**
+ * Prompts user to select a skill from available skills.
+ *
+ * @param skills - Array of available skills
+ * @returns Selected skill
+ */
+export async function promptSkillSelection(skills) {
+    const skillChoices = skills.map((skill) => ({
+        name: `${skill.name} (v${skill.version})`,
+        value: skill
+    }));
+    const { selectedSkill } = await inquirer.prompt([
+        {
+            type: "list",
+            name: "selectedSkill",
+            message: "Select a skill to deploy:",
+            choices: skillChoices
+        }
+    ]);
+    clearPromptLines(2);
+    return selectedSkill;
+}
 /**
  * Validates that configuration has required fields for deployment.
  *
@@ -69,9 +91,46 @@ export async function confirmDeployment() {
  * @throws Error if configuration is invalid
  */
 export function validateDeployConfig(config) {
-    if (!config || !config.agent?.agentId || !config.skill?.skillId) {
-        throw new Error("No lua.skill.yaml found or missing agentId/skillId. Please run this command from a skill directory.");
+    if (!config) {
+        throw new Error("No lua.skill.yaml found. Please run this command from a skill directory.");
+    }
+    if (!config.agent?.agentId) {
+        throw new Error("Missing agentId in skill configuration");
+    }
+    // Check for new multi-skill format
+    if (config.skills && Array.isArray(config.skills) && config.skills.length > 0) {
+        return; // Valid multi-skill config
+    }
+    // Check for legacy single-skill format
+    if (config.skill?.skillId) {
+        return; // Valid legacy config
+    }
+    throw new Error("No skills found in configuration. Please compile your skill first.");
+}
+/**
+ * Gets available skills from configuration.
+ *
+ * @param config - Skill configuration
+ * @returns Array of available skills
+ */
+export function getAvailableSkills(config) {
+    // Check for new multi-skill format
+    if (config.skills && Array.isArray(config.skills) && config.skills.length > 0) {
+        return config.skills.map((skill) => ({
+            name: skill.name,
+            version: skill.version,
+            skillId: skill.skillId
+        }));
+    }
+    // Fallback to legacy single-skill format
+    if (config.skill) {
+        return [{
+                name: config.skill.name || 'unnamed-skill',
+                version: config.skill.version,
+                skillId: config.skill.skillId
+            }];
     }
+    return [];
 }
 /**
  * Validates that versions are available for deployment.

package/dist/utils/deployment.js

@@ -62,9 +62,11 @@ export async function createLegacyDeploymentData(tools, luaDir, indexFile) {
     const skillsArray = buildSkillsArray(skillsMetadata, skillToTools, tools);
     // Ensure all skills exist in YAML config and have valid IDs
     const updatedSkillsArray = await ensureSkillsExistInYaml(skillsArray, config);
+    // Override versions from YAML config if they exist
+    const finalSkillsArray = overrideVersionsFromConfig(updatedSkillsArray, config);
     // Write deployment data
     const deployData = {
-        skills: updatedSkillsArray
+        skills: finalSkillsArray
     };
     fs.writeFileSync(path.join(luaDir, COMPILE_FILES.DEPLOY_JSON), JSON.stringify(deployData, null, JSON_FORMAT.INDENT));
     // Write individual tool files (uncompressed for debugging)
@@ -144,6 +146,36 @@ function buildSkillsArray(skillsMetadata, skillToTools, tools) {
         };
     });
 }
+/**
+ * Overrides skill versions from YAML config.
+ * This ensures that any version updates in the YAML take precedence over code versions.
+ *
+ * @param skillsArray - Array of skills from code
+ * @param config - Skill configuration from YAML
+ * @returns Skills array with versions overridden from config
+ */
+function overrideVersionsFromConfig(skillsArray, config) {
+    // Get version map from YAML config
+    const configVersionMap = new Map();
+    if (config.skills && Array.isArray(config.skills)) {
+        config.skills.forEach((skill) => {
+            if (skill.name && skill.version) {
+                configVersionMap.set(skill.name, skill.version);
+            }
+        });
+    }
+    // Override versions in skills array
+    return skillsArray.map(skill => {
+        const configVersion = configVersionMap.get(skill.name);
+        if (configVersion) {
+            return {
+                ...skill,
+                version: configVersion
+            };
+        }
+        return skill;
+    });
+}
 /**
  * Writes individual tool files to the .lua directory for debugging.
  * These are uncompressed versions of the tool code.