lua-cli 2.3.0-alpha.4 → 2.3.2

package/dist/commands/deploy.d.ts

@@ -7,13 +7,15 @@
  *
  * This command performs the following steps:
  * 1. Validates configuration has required fields
- * 2. Authenticates the user
- * 3. Fetches available versions from server
- * 4. Prompts user to select a version
- * 5. Shows warning and requests confirmation
- * 6. Publishes selected version to production
+ * 2. Prompts user to select a skill (if multiple skills exist)
+ * 3. Authenticates the user
+ * 4. Fetches available versions from server for selected skill
+ * 5. Prompts user to select a version
+ * 6. Shows warning and requests confirmation
+ * 7. Publishes selected version to production
  *
  * Features:
+ * - Supports multi-skill projects
  * - Lists all available versions with metadata
  * - Shows which version is currently deployed
  * - Sorts versions by date (newest first)

package/dist/commands/deploy.js

@@ -4,21 +4,23 @@
  */
 import { loadApiKey, checkApiKey } from '../services/auth.js';
 import { readSkillConfig } from '../utils/files.js';
-import { withErrorHandling, writeProgress, writeSuccess } from '../utils/cli.js';
-import { sortVersionsByDate, promptVersionSelection, confirmDeployment, validateDeployConfig, validateVersionsAvailable, } from '../utils/deploy-helpers.js';
+import { withErrorHandling, writeProgress, writeSuccess, writeInfo } from '../utils/cli.js';
+import { sortVersionsByDate, promptVersionSelection, confirmDeployment, validateDeployConfig, validateVersionsAvailable, promptSkillSelection, getAvailableSkills, } from '../utils/deploy-helpers.js';
 import { fetchVersions, publishVersion } from '../utils/deploy-api.js';
 /**
  * Main deploy command - deploys a skill version to production.
  *
  * This command performs the following steps:
  * 1. Validates configuration has required fields
- * 2. Authenticates the user
- * 3. Fetches available versions from server
- * 4. Prompts user to select a version
- * 5. Shows warning and requests confirmation
- * 6. Publishes selected version to production
+ * 2. Prompts user to select a skill (if multiple skills exist)
+ * 3. Authenticates the user
+ * 4. Fetches available versions from server for selected skill
+ * 5. Prompts user to select a version
+ * 6. Shows warning and requests confirmation
+ * 7. Publishes selected version to production
  *
  * Features:
+ * - Supports multi-skill projects
  * - Lists all available versions with metadata
  * - Shows which version is currently deployed
  * - Sorts versions by date (newest first)
@@ -39,7 +41,24 @@ export async function deployCommand() {
         // Step 1: Validate configuration
         const config = readSkillConfig();
         validateDeployConfig(config);
-        // Step 2: Authenticate
+        // Step 2: Get available skills and prompt for selection
+        const availableSkills = getAvailableSkills(config);
+        if (availableSkills.length === 0) {
+            console.error("❌ No skills found in configuration. Please compile your skill first using 'lua compile'.");
+            process.exit(1);
+        }
+        let selectedSkill;
+        if (availableSkills.length === 1) {
+            // Only one skill, use it automatically
+            selectedSkill = availableSkills[0];
+            writeInfo(`📦 Deploying skill: ${selectedSkill.name}`);
+        }
+        else {
+            // Multiple skills, prompt for selection
+            selectedSkill = await promptSkillSelection(availableSkills);
+            writeInfo(`📦 Selected skill: ${selectedSkill.name}`);
+        }
+        // Step 3: Authenticate
         const apiKey = await loadApiKey();
         if (!apiKey) {
             console.error("❌ No API key found. Please run 'lua auth configure' to set up your API key.");
@@ -47,22 +66,22 @@ export async function deployCommand() {
         }
         const userData = await checkApiKey(apiKey);
         writeProgress("✅ Authenticated");
-        // Step 3: Fetch available versions
+        // Step 4: Fetch available versions for the selected skill
         writeProgress("🔄 Fetching available versions...");
-        const versionsResponse = await fetchVersions(apiKey, config.agent.agentId, config.skill.skillId);
+        const versionsResponse = await fetchVersions(apiKey, config.agent.agentId, selectedSkill.skillId);
         validateVersionsAvailable(versionsResponse.versions);
-        // Step 4: Sort and display versions
+        // Step 5: Sort and display versions
         const sortedVersions = sortVersionsByDate(versionsResponse.versions);
         const selectedVersion = await promptVersionSelection(sortedVersions);
-        // Step 5: Confirm deployment
+        // Step 6: Confirm deployment
         const confirmed = await confirmDeployment();
         if (!confirmed) {
             console.log("❌ Deployment cancelled.");
             process.exit(0);
         }
-        // Step 6: Publish the selected version
+        // Step 7: Publish the selected version
         writeProgress("🔄 Publishing version...");
-        const publishResponse = await publishVersion(apiKey, config.agent.agentId, config.skill.skillId, selectedVersion);
-        writeSuccess(`✅ Version ${publishResponse.activeVersionId} deployed successfully`);
+        const publishResponse = await publishVersion(apiKey, config.agent.agentId, selectedSkill.skillId, selectedVersion);
+        writeSuccess(`✅ Version ${publishResponse.activeVersionId} of "${selectedSkill.name}" deployed successfully`);
     }, "deployment");
 }

package/dist/commands/init.js

@@ -3,7 +3,7 @@
  * Orchestrates the initialization of a new Lua skill project
  */
 import { loadApiKey, checkApiKey } from "../services/auth.js";
-import { withErrorHandling, writeSuccess } from "../utils/cli.js";
+import { withErrorHandling, writeProgress, writeSuccess, } from "../utils/cli.js";
 import { promptAgentChoice, promptOrganizationSelection, promptAgentSelection, promptMetadataCollection, promptFeatureConfiguration, promptBusinessConfiguration, } from "../utils/init-prompts.js";
 import { fetchAgentTypes, selectBaseAgentType, createNewAgent, } from "../utils/init-agent.js";
 import { initializeProject, installDependencies, clearLinesIfNeeded, } from "../utils/init-helpers.js";
@@ -38,6 +38,8 @@ export async function initCommand() {
             console.error("❌ No API key found. Run `lua auth configure` first.");
             process.exit(1);
         }
+        const userData = await checkApiKey(apiKey);
+        writeProgress("✅ Authenticated");
         // Step 2: Choose between existing or new agent
         const agentChoice = await promptAgentChoice();
         let selectedAgent;
@@ -46,7 +48,7 @@ export async function initCommand() {
         let welcomeMessage;
         if (agentChoice === "existing") {
             // Step 3a: Select existing agent
-            const result = await selectExistingAgent(apiKey);
+            const result = await selectExistingAgent(userData);
             selectedAgent = result.agent;
             selectedOrg = result.org;
         }
@@ -68,12 +70,10 @@ export async function initCommand() {
 /**
  * Handles the flow for selecting an existing agent.
  *
- * @param apiKey - User's API key
+ * @param userData - User's data
  * @returns Selected agent and organization
  */
-async function selectExistingAgent(apiKey) {
-    // Get user data from API
-    const userData = await checkApiKey(apiKey);
+async function selectExistingAgent(userData) {
     // Extract organizations
     const orgs = userData.admin.orgs;
     if (!orgs || orgs.length === 0) {

package/dist/commands/push.d.ts

@@ -7,11 +7,13 @@
  *
  * This command performs the following steps:
  * 1. Validates configuration has required fields
- * 2. Prompts for user confirmation
- * 3. Authenticates the user
- * 4. Compiles the skill
- * 5. Validates deploy.json matches configuration
- * 6. Pushes version to server
+ * 2. Prompts user to select a skill (if multiple skills exist)
+ * 3. Prompts to confirm or update version
+ * 4. Authenticates the user
+ * 5. Compiles the skill (always, to ensure deploy.json is current)
+ * 6. Validates deploy.json matches configuration for selected skill
+ * 7. Extracts the specific skill's deploy data
+ * 8. Pushes version to server
  *
  * Use this command to:
  * - Upload a new version of your skill

package/dist/commands/push.js

@@ -5,19 +5,21 @@
 import { compileCommand } from './compile.js';
 import { checkApiKey, loadApiKey } from '../services/auth.js';
 import { readSkillConfig } from '../utils/files.js';
-import { withErrorHandling, writeProgress, writeSuccess } from '../utils/cli.js';
-import { readDeployJson, confirmVersionPush, validatePushConfig, validateDeployData, } from '../utils/push-helpers.js';
+import { withErrorHandling, writeProgress, writeSuccess, writeInfo } from '../utils/cli.js';
+import { readDeployJson, validatePushConfig, validateDeployData, promptSkillSelection, promptVersionConfirmOrUpdate, getAvailableSkills, updateSkillVersionInYaml, getSkillDeployData, } from '../utils/push-helpers.js';
 import { pushVersion } from '../utils/push-api.js';
 /**
  * Main push command - pushes a skill version to the server.
  *
  * This command performs the following steps:
  * 1. Validates configuration has required fields
- * 2. Prompts for user confirmation
- * 3. Authenticates the user
- * 4. Compiles the skill
- * 5. Validates deploy.json matches configuration
- * 6. Pushes version to server
+ * 2. Prompts user to select a skill (if multiple skills exist)
+ * 3. Prompts to confirm or update version
+ * 4. Authenticates the user
+ * 5. Compiles the skill (always, to ensure deploy.json is current)
+ * 6. Validates deploy.json matches configuration for selected skill
+ * 7. Extracts the specific skill's deploy data
+ * 8. Pushes version to server
  *
  * Use this command to:
  * - Upload a new version of your skill
@@ -33,14 +35,33 @@ export async function pushCommand() {
         // Step 1: Validate configuration
         const config = readSkillConfig();
         validatePushConfig(config);
-        const version = config.skill.version;
-        // Step 2: Confirm with user
-        const confirmed = await confirmVersionPush(version);
-        if (!confirmed) {
-            console.log("❌ Push cancelled.");
-            process.exit(0);
+        // Step 2: Get available skills and prompt for selection
+        const availableSkills = getAvailableSkills(config);
+        if (availableSkills.length === 0) {
+            console.error("❌ No skills found in configuration. Please compile your skill first using 'lua compile'.");
+            process.exit(1);
+        }
+        let selectedSkill;
+        if (availableSkills.length === 1) {
+            // Only one skill, use it automatically
+            selectedSkill = availableSkills[0];
+            writeInfo(`📦 Pushing skill: ${selectedSkill.name}`);
+        }
+        else {
+            // Multiple skills, prompt for selection
+            selectedSkill = await promptSkillSelection(availableSkills);
+            writeInfo(`📦 Selected skill: ${selectedSkill.name}`);
+        }
+        // Step 3: Confirm or update version
+        const confirmedVersion = await promptVersionConfirmOrUpdate(selectedSkill.version);
+        let versionUpdated = false;
+        if (confirmedVersion !== selectedSkill.version) {
+            writeInfo(`📝 Updating version from ${selectedSkill.version} to ${confirmedVersion}`);
+            updateSkillVersionInYaml(selectedSkill.name, confirmedVersion);
+            selectedSkill.version = confirmedVersion;
+            versionUpdated = true;
         }
-        // Step 3: Authenticate
+        // Step 4: Authenticate
         const apiKey = await loadApiKey();
         if (!apiKey) {
             console.error("❌ No API key found. Please run 'lua auth configure' to set up your API key.");
@@ -48,19 +69,21 @@ export async function pushCommand() {
         }
         const userData = await checkApiKey(apiKey);
         writeProgress("✅ Authenticated");
-        // Step 4: Compile the skill
+        // Step 5: Compile the skill (always compile to ensure up-to-date, or if version was updated)
         writeProgress("🔄 Compiling skill...");
         await compileCommand();
-        // Step 5: Validate deploy data
+        // Step 6: Validate deploy data for the selected skill
         const deployData = readDeployJson();
-        validateDeployData(deployData, version);
-        // Step 6: Push version to server
+        validateDeployData(deployData, selectedSkill);
+        // Step 7: Extract the specific skill's deploy data
+        const skillDeployData = getSkillDeployData(deployData, selectedSkill.name);
+        // Step 8: Push version to server
         const agentId = config.agent.agentId;
-        const skillId = config.skill.skillId;
+        const skillId = selectedSkill.skillId;
         writeProgress("🔄 Pushing version to server...");
-        const result = await pushVersion(apiKey, agentId, skillId, deployData);
+        const result = await pushVersion(apiKey, agentId, skillId, skillDeployData);
         if (result.success && result.data) {
-            writeSuccess(`✅ Version ${result.data.version} pushed successfully`);
+            writeSuccess(`✅ Version ${result.data.version} of "${selectedSkill.name}" pushed successfully`);
         }
         else if (result.error) {
             console.error(`❌ ${result.error.message}`);

package/dist/common/http.client.js

@@ -1,3 +1,4 @@
+import { AuthenticationError } from "../errors/auth.error.js";
 /**
  * Generic HTTP client with common error handling
  * Provides a base class for all API service classes with standardized HTTP methods
@@ -28,6 +29,9 @@ export class HttpClient {
             });
             // Check if response is ok (status 200-299)
             if (!response.ok) {
+                if (response.status === 401) {
+                    throw new AuthenticationError("Invalid API key");
+                }
                 return {
                     success: false,
                     error: {
@@ -55,6 +59,9 @@ export class HttpClient {
             };
         }
         catch (error) {
+            if (AuthenticationError.isAuthenticationError(error)) {
+                throw error;
+            }
             // Handle network errors, timeouts, etc.
             return {
                 success: false,

package/dist/errors/auth.error.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Authentication Error
+ * Thrown when API requests fail with 401 Unauthorized status
+ */
+export declare class AuthenticationError extends Error {
+    readonly statusCode: number;
+    readonly isAuthenticationError: boolean;
+    constructor(message?: string);
+    /**
+     * Checks if an error is an AuthenticationError
+     * @param error - The error to check
+     * @returns True if the error is an AuthenticationError
+     */
+    static isAuthenticationError(error: unknown): error is AuthenticationError;
+}

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.js

@@ -25,7 +25,7 @@ const program = new Command();
 program
     .name("lua")
     .description("Lua AI Skill Management CLI")
-    .version("2.3.0-alpha.4");
+    .version("2.3.1");
 // 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/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.