lua-cli 2.2.8-alpha.2 → 2.3.0-alpha.2

package/dist/commands/configure.d.ts

@@ -1 +1,25 @@
+/**
+ * Configure Command
+ * Orchestrates the authentication setup process
+ */
+/**
+ * Main configure command - sets up authentication credentials.
+ *
+ * This command performs the following steps:
+ * 1. Prompts user to choose authentication method (API key or email)
+ * 2. Executes the appropriate authentication flow
+ * 3. Saves credentials securely using keytar
+ *
+ * Authentication Methods:
+ * - **API Key**: Direct entry of existing API key
+ * - **Email**: OTP-based authentication that generates a new API key
+ *
+ * Features:
+ * - Secure credential storage via keytar
+ * - Email validation
+ * - OTP verification with retry logic
+ * - Automatic API key generation for email auth
+ *
+ * @returns Promise that resolves when configuration is complete
+ */
 export declare function configureCommand(): Promise<void>;

package/dist/commands/configure.js

@@ -1,105 +1,40 @@
-import inquirer from "inquirer";
-import { saveApiKey, checkApiKey, requestEmailOTP, verifyOTPAndGetToken, generateApiKey } from "../services/auth.js";
-import { withErrorHandling, clearPromptLines, writeProgress, writeSuccess } from "../utils/cli.js";
+/**
+ * Configure Command
+ * Orchestrates the authentication setup process
+ */
+import { withErrorHandling, clearPromptLines } from "../utils/cli.js";
+import { promptAuthMethod, handleApiKeyAuth, handleEmailAuth, } from "../utils/auth-flows.js";
+/**
+ * Main configure command - sets up authentication credentials.
+ *
+ * This command performs the following steps:
+ * 1. Prompts user to choose authentication method (API key or email)
+ * 2. Executes the appropriate authentication flow
+ * 3. Saves credentials securely using keytar
+ *
+ * Authentication Methods:
+ * - **API Key**: Direct entry of existing API key
+ * - **Email**: OTP-based authentication that generates a new API key
+ *
+ * Features:
+ * - Secure credential storage via keytar
+ * - Email validation
+ * - OTP verification with retry logic
+ * - Automatic API key generation for email auth
+ *
+ * @returns Promise that resolves when configuration is complete
+ */
 export async function configureCommand() {
     return withErrorHandling(async () => {
-        // Choose authentication method
-        const { authMethod } = await inquirer.prompt([
-            {
-                type: "list",
-                name: "authMethod",
-                message: "Choose authentication method:",
-                choices: [
-                    { name: "API Key", value: "api-key" },
-                    { name: "Email", value: "email" }
-                ]
-            }
-        ]);
-        // Clear the authentication method prompt lines
+        // Step 1: Choose authentication method
+        const authMethod = await promptAuthMethod();
         clearPromptLines(2);
+        // Step 2: Execute appropriate authentication flow
         if (authMethod === "api-key") {
-            // Existing API key flow
-            const answers = await inquirer.prompt([
-                {
-                    type: "password",
-                    name: "apiKey",
-                    message: "Enter your API key",
-                    mask: "*",
-                },
-            ]);
-            const data = await checkApiKey(answers.apiKey);
-            if (!data) {
-                console.error("❌ Invalid API key");
-                process.exit(1);
-            }
-            await saveApiKey(answers.apiKey);
-            writeSuccess("✅ API key saved securely.");
+            await handleApiKeyAuth();
         }
         else if (authMethod === "email") {
-            // Email authentication flow
-            const { email } = await inquirer.prompt([
-                {
-                    type: "input",
-                    name: "email",
-                    message: "Enter your email address:",
-                    validate: (input) => {
-                        const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-                        return emailRegex.test(input) || "Please enter a valid email address";
-                    }
-                }
-            ]);
-            // Clear the email prompt lines
-            clearPromptLines(2);
-            writeProgress("📧 Sending OTP to your email...");
-            const otpSent = await requestEmailOTP(email);
-            if (!otpSent) {
-                console.error("❌ Failed to send OTP. Please try again.");
-                process.exit(1);
-            }
-            writeProgress("✅ OTP sent successfully!");
-            // OTP verification with retry logic
-            let otpVerified = false;
-            let attempts = 0;
-            let signInToken = null;
-            const maxAttempts = 3;
-            while (!otpVerified && attempts < maxAttempts) {
-                const { pin } = await inquirer.prompt([
-                    {
-                        type: "input",
-                        name: "pin",
-                        message: "Enter the OTP code:",
-                        validate: (input) => {
-                            return input.length === 6 || "OTP must be 6 digits";
-                        }
-                    }
-                ]);
-                // Clear the OTP prompt lines
-                clearPromptLines(2);
-                writeProgress("🔐 Verifying OTP...");
-                signInToken = await verifyOTPAndGetToken(email, pin);
-                if (signInToken) {
-                    otpVerified = true;
-                    writeProgress("✅ OTP verified successfully!");
-                    writeProgress("🔑 Generating API key...");
-                }
-                else {
-                    attempts++;
-                    if (attempts < maxAttempts) {
-                        console.log(`❌ Invalid OTP. ${maxAttempts - attempts} attempts remaining.`);
-                    }
-                    else {
-                        console.error("❌ Invalid OTP. Maximum attempts reached. Please try again later.");
-                        process.exit(1);
-                    }
-                }
-            }
-            const apiKey = await generateApiKey(signInToken);
-            if (!apiKey) {
-                console.error("❌ Failed to generate API key. Please try again.");
-                process.exit(1);
-            }
-            await saveApiKey(apiKey);
-            writeSuccess("✅ API key generated and saved securely.");
+            await handleEmailAuth();
         }
     }, "configuration");
 }

package/dist/commands/deploy.d.ts

@@ -1,20 +1,32 @@
-export interface VersionInfo {
-    version: string;
-    createdDate: string;
-    createdBy: string;
-    isCurrent: boolean;
-    createdByEmail: string;
-    createdByFullName: string;
-}
-export interface VersionsResponse {
-    versions: VersionInfo[];
-}
-export interface PublishResponse {
-    message: string;
-    skillId: string;
-    activeVersionId: string;
-    publishedAt: string;
-}
-export declare function fetchVersions(apiKey: string, agentId: string, skillId: string): Promise<VersionsResponse>;
-export declare function publishVersion(apiKey: string, agentId: string, skillId: string, version: string): Promise<PublishResponse>;
+/**
+ * Deploy Command
+ * Orchestrates deployment of skill versions to production
+ */
+/**
+ * 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
+ *
+ * Features:
+ * - Lists all available versions with metadata
+ * - Shows which version is currently deployed
+ * - Sorts versions by date (newest first)
+ * - Requires explicit confirmation before deployment
+ * - Safety warning about production deployment
+ *
+ * Use this command to:
+ * - Deploy a tested version to production
+ * - Make your skill available to all users
+ * - Roll back to a previous version
+ *
+ * ⚠️ WARNING: This deploys to ALL users immediately!
+ *
+ * @returns Promise that resolves when deployment completes
+ */
 export declare function deployCommand(): Promise<void>;

package/dist/commands/deploy.js

@@ -1,95 +1,66 @@
-import inquirer from 'inquirer';
+/**
+ * Deploy Command
+ * Orchestrates deployment of skill versions to production
+ */
 import { loadApiKey, checkApiKey } from '../services/auth.js';
-import { ApiService } from '../services/api.js';
 import { readSkillConfig } from '../utils/files.js';
-import { withErrorHandling, clearPromptLines, writeProgress, writeSuccess } from '../utils/cli.js';
-export async function fetchVersions(apiKey, agentId, skillId) {
-    try {
-        const response = await ApiService.Skill.getSkillVersions(apiKey, agentId, skillId);
-        if (!response.success) {
-            throw new Error(`Failed to fetch versions: ${response.error?.message || 'Unknown error'}`);
-        }
-        return response.data;
-    }
-    catch (error) {
-        console.error("❌ Error fetching versions:", error);
-        throw error;
-    }
-}
-export async function publishVersion(apiKey, agentId, skillId, version) {
-    try {
-        const response = await ApiService.Skill.publishSkillVersion(apiKey, agentId, skillId, version);
-        if (!response.success) {
-            throw new Error(`Failed to publish version: ${response.error?.message || 'Unknown error'}`);
-        }
-        return response.data;
-    }
-    catch (error) {
-        console.error("❌ Error publishing version:", error);
-        throw error;
-    }
-}
-function formatVersionChoice(version) {
-    const currentIndicator = version.isCurrent ? ' (CURRENT)' : '';
-    const date = new Date(version.createdDate).toLocaleDateString();
-    return `${version.version}${currentIndicator} - Created: ${date} by ${version.createdByEmail}`;
-}
+import { withErrorHandling, writeProgress, writeSuccess } from '../utils/cli.js';
+import { sortVersionsByDate, promptVersionSelection, confirmDeployment, validateDeployConfig, validateVersionsAvailable, } 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
+ *
+ * Features:
+ * - Lists all available versions with metadata
+ * - Shows which version is currently deployed
+ * - Sorts versions by date (newest first)
+ * - Requires explicit confirmation before deployment
+ * - Safety warning about production deployment
+ *
+ * Use this command to:
+ * - Deploy a tested version to production
+ * - Make your skill available to all users
+ * - Roll back to a previous version
+ *
+ * ⚠️ WARNING: This deploys to ALL users immediately!
+ *
+ * @returns Promise that resolves when deployment completes
+ */
 export async function deployCommand() {
     return withErrorHandling(async () => {
-        // Check if we're in a skill directory
+        // Step 1: Validate configuration
         const config = readSkillConfig();
-        if (!config || !config.agent?.agentId || !config.skill?.skillId) {
-            console.error("❌ No lua.skill.yaml found or missing agentId/skillId. Please run this command from a skill directory.");
-            process.exit(1);
-        }
-        // Load API key
+        validateDeployConfig(config);
+        // 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);
         }
-        // Validate API key
         const userData = await checkApiKey(apiKey);
         writeProgress("✅ Authenticated");
-        // Fetch available versions
+        // Step 3: Fetch available versions
         writeProgress("🔄 Fetching available versions...");
         const versionsResponse = await fetchVersions(apiKey, config.agent.agentId, config.skill.skillId);
-        if (!versionsResponse.versions || versionsResponse.versions.length === 0) {
-            console.log("❌ No versions found for this skill.");
-            process.exit(1);
-        }
-        // Sort versions by creation date (newest first)
-        const sortedVersions = versionsResponse.versions.sort((a, b) => new Date(b.createdDate).getTime() - new Date(a.createdDate).getTime());
-        // Let user select a version
-        const { selectedVersion } = await inquirer.prompt([
-            {
-                type: "list",
-                name: "selectedVersion",
-                message: "Select a version to deploy:",
-                choices: sortedVersions.map(version => ({
-                    name: formatVersionChoice(version),
-                    value: version.version
-                }))
-            }
-        ]);
-        // Clear the selection prompt lines
-        clearPromptLines(2);
-        // Show warning and confirm deployment
-        const { confirmed } = await inquirer.prompt([
-            {
-                type: "confirm",
-                name: "confirmed",
-                message: "⚠️  Warning: This version will be deployed to all users. Do you want to proceed?",
-                default: false
-            }
-        ]);
-        // Clear the confirmation prompt lines
-        clearPromptLines(2);
+        validateVersionsAvailable(versionsResponse.versions);
+        // Step 4: Sort and display versions
+        const sortedVersions = sortVersionsByDate(versionsResponse.versions);
+        const selectedVersion = await promptVersionSelection(sortedVersions);
+        // Step 5: Confirm deployment
+        const confirmed = await confirmDeployment();
         if (!confirmed) {
             console.log("❌ Deployment cancelled.");
             process.exit(0);
         }
-        // Publish the selected version
+        // Step 6: 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`);

package/dist/commands/destroy.d.ts

@@ -1 +1,28 @@
+/**
+ * Destroy Command
+ * Securely deletes stored authentication credentials
+ */
+/**
+ * Main destroy command - deletes stored API key with confirmation.
+ *
+ * This command:
+ * 1. Checks if an API key exists
+ * 2. Prompts for confirmation before deletion
+ * 3. Deletes the API key from secure storage if confirmed
+ *
+ * Security:
+ * - Requires explicit confirmation to prevent accidental deletion
+ * - Action cannot be undone (must reconfigure to use CLI again)
+ *
+ * Use this command to:
+ * - Log out of the CLI
+ * - Remove credentials from your machine
+ * - Switch to a different API key
+ *
+ * After running this command:
+ * - You will need to run `lua auth configure` again to use the CLI
+ * - Your API key remains valid on the server (only local storage is cleared)
+ *
+ * @returns Promise that resolves when command completes
+ */
 export declare function destroyCommand(): Promise<void>;

package/dist/commands/destroy.js

@@ -1,6 +1,33 @@
+/**
+ * Destroy Command
+ * Securely deletes stored authentication credentials
+ */
 import inquirer from "inquirer";
 import { loadApiKey, deleteApiKey } from "../services/auth.js";
 import { withErrorHandling, clearPromptLines, writeProgress, writeSuccess } from "../utils/cli.js";
+/**
+ * Main destroy command - deletes stored API key with confirmation.
+ *
+ * This command:
+ * 1. Checks if an API key exists
+ * 2. Prompts for confirmation before deletion
+ * 3. Deletes the API key from secure storage if confirmed
+ *
+ * Security:
+ * - Requires explicit confirmation to prevent accidental deletion
+ * - Action cannot be undone (must reconfigure to use CLI again)
+ *
+ * Use this command to:
+ * - Log out of the CLI
+ * - Remove credentials from your machine
+ * - Switch to a different API key
+ *
+ * After running this command:
+ * - You will need to run `lua auth configure` again to use the CLI
+ * - Your API key remains valid on the server (only local storage is cleared)
+ *
+ * @returns Promise that resolves when command completes
+ */
 export async function destroyCommand() {
     return withErrorHandling(async () => {
         const apiKey = await loadApiKey();
@@ -16,7 +43,6 @@ export async function destroyCommand() {
                 default: false
             }
         ]);
-        // Clear the confirmation prompt lines
         clearPromptLines(2);
         if (confirm) {
             const deleted = await deleteApiKey();

package/dist/commands/dev.d.ts

@@ -1,63 +1,26 @@
-export interface DevVersionResponse {
-    success: boolean;
-    data?: {
-        message: string;
-        skillId: string;
-        version: string;
-        publishedAt: string;
-    };
-    error?: {
-        message: string;
-        error: string;
-        statusCode: number;
-    };
-}
-export interface UpdateDevVersionResponse {
-    success: boolean;
-    data?: {
-        message: string;
-        skillId: string;
-        version: string;
-        updatedAt: string;
-    };
-    error?: {
-        message: string;
-        error: string;
-        statusCode: number;
-    };
-}
-export interface ChatMessage {
-    type: "text";
-    text: string;
-}
-export interface ChatRequest {
-    messages: ChatMessage[];
-    navigate: boolean;
-    skillOverride: Array<{
-        skillId: string;
-        sandboxId: string;
-    }>;
-    personaOverride?: string;
-}
-export interface ChatResponse {
-    text: string;
-    files: any[];
-    reasoningDetails: any[];
-    toolCalls: any[];
-    toolResults: any[];
-    finishReason: string;
-    usage: {
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    };
-    warnings: any[];
-    request: any;
-    response: any;
-    steps: any[];
-    sources: any[];
-}
-export declare function sendChatMessage(apiKey: string, agentId: string, skillId: string, sandboxId: string, message: string, persona?: string): Promise<string | null>;
-export declare function updateDevVersion(apiKey: string, agentId: string, skillId: string, sandboxVersionId: string, versionData: any): Promise<UpdateDevVersionResponse>;
-export declare function pushDevVersion(apiKey: string, agentId: string, skillId: string, versionData: any): Promise<DevVersionResponse>;
+/**
+ * Dev Command
+ * Orchestrates the development mode with live reloading, chat interface, and tool testing
+ */
+/**
+ * Main dev command - starts development mode with live reloading.
+ *
+ * This command performs the following steps:
+ * 1. Validates configuration and authentication
+ * 2. Compiles the skill
+ * 3. Pushes all skills to sandbox environment
+ * 4. Starts web server with chat interface and tool testing
+ * 5. Opens browser to chat interface
+ * 6. Watches for file changes and auto-recompiles
+ *
+ * Features:
+ * - Live chat interface for testing skills
+ * - Real-time tool testing with WebSocket log streaming
+ * - Automatic recompilation and push on file changes
+ * - Environment variable management
+ * - Persona configuration
+ * - Multi-skill support
+ *
+ * @returns Promise that resolves when dev mode is stopped (never resolves normally)
+ */
 export declare function devCommand(): Promise<void>;