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

package/dist/commands/init.d.ts

@@ -1 +1,28 @@
+/**
+ * Init Command
+ * Orchestrates the initialization of a new Lua skill project
+ */
+/**
+ * Main init command - initializes a new Lua skill project.
+ *
+ * This command performs the following steps:
+ * 1. Authenticates the user
+ * 2. Prompts to select existing agent or create new one
+ * 3. For existing: Lets user select organization and agent
+ * 4. For new: Collects configuration and creates agent
+ * 5. Copies template files to current directory
+ * 6. Creates lua.skill.yaml configuration
+ * 7. Installs npm dependencies
+ *
+ * Features:
+ * - Interactive agent selection or creation
+ * - Organization management
+ * - Business configuration
+ * - Agent type selection (defaults to Base Agent)
+ * - Feature configuration
+ * - Automatic project scaffolding
+ * - Dependency installation
+ *
+ * @returns Promise that resolves when initialization is complete
+ */
 export declare function initCommand(): Promise<void>;

package/dist/commands/init.js

@@ -1,279 +1,117 @@
-import inquirer from "inquirer";
-import { fileURLToPath } from "url";
-import path from "path";
+/**
+ * Init Command
+ * Orchestrates the initialization of a new Lua skill project
+ */
 import { loadApiKey, checkApiKey } from "../services/auth.js";
-import { ApiService } from "../services/api.js";
-import { copyTemplateFiles, createSkillYaml } from "../utils/files.js";
-import { withErrorHandling, clearPromptLines, writeProgress, writeSuccess } from "../utils/cli.js";
-function getTemplateDir() {
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = path.dirname(__filename);
-    return path.join(__dirname, "..", "..", "template");
-}
+import { withErrorHandling, 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";
+/**
+ * Main init command - initializes a new Lua skill project.
+ *
+ * This command performs the following steps:
+ * 1. Authenticates the user
+ * 2. Prompts to select existing agent or create new one
+ * 3. For existing: Lets user select organization and agent
+ * 4. For new: Collects configuration and creates agent
+ * 5. Copies template files to current directory
+ * 6. Creates lua.skill.yaml configuration
+ * 7. Installs npm dependencies
+ *
+ * Features:
+ * - Interactive agent selection or creation
+ * - Organization management
+ * - Business configuration
+ * - Agent type selection (defaults to Base Agent)
+ * - Feature configuration
+ * - Automatic project scaffolding
+ * - Dependency installation
+ *
+ * @returns Promise that resolves when initialization is complete
+ */
 export async function initCommand() {
     return withErrorHandling(async () => {
+        // Step 1: Authenticate
         const apiKey = await loadApiKey();
         if (!apiKey) {
             console.error("❌ No API key found. Run `lua auth configure` first.");
             process.exit(1);
         }
-        // Ask user if they want to create a new agent or select existing one
-        const { agentChoice } = await inquirer.prompt([
-            {
-                type: "list",
-                name: "agentChoice",
-                message: "What would you like to do?",
-                choices: [
-                    { name: "Select existing agent", value: "existing" },
-                    { name: "Create new agent", value: "create" }
-                ]
-            }
-        ]);
-        // Clear the agent choice prompt lines
-        // clearPromptLines(2);
+        // Step 2: Choose between existing or new agent
+        const agentChoice = await promptAgentChoice();
         let selectedAgent;
         let selectedOrg;
         let persona;
         let welcomeMessage;
         if (agentChoice === "existing") {
-            // Get user data from API only when selecting existing agent
-            const userData = await checkApiKey(apiKey);
-            writeProgress("✅ Authenticated");
-            // Extract organizations and create choices for selection
-            const orgs = userData.admin.orgs;
-            if (!orgs || orgs.length === 0) {
-                console.error("❌ No organizations found.");
-                process.exit(1);
-            }
-            const orgChoices = orgs.map((org) => ({
-                name: org.registeredName || org.name || 'Unknown Organization',
-                value: org
-            }));
-            // Select organization
-            const { selectedOrg: existingOrg } = await inquirer.prompt([
-                {
-                    type: "list",
-                    name: "selectedOrg",
-                    message: "Select an organization:",
-                    choices: orgChoices
-                }
-            ]);
-            selectedOrg = existingOrg;
-            // Clear the organization selection prompt lines
-            // clearPromptLines(2);
-            // Extract agents from selected organization
-            if (!selectedOrg.agents || selectedOrg.agents.length === 0) {
-                console.error("❌ No agents found in the selected organization.");
-                process.exit(1);
-            }
-            const agentChoices = selectedOrg.agents.map((agent) => ({
-                name: agent.name,
-                value: agent
-            }));
-            // Select agent
-            const { selectedAgent: existingAgent } = await inquirer.prompt([
-                {
-                    type: "list",
-                    name: "selectedAgent",
-                    message: "Select an agent:",
-                    choices: agentChoices
-                }
-            ]);
-            selectedAgent = existingAgent;
-            // Clear the agent selection prompt lines
-            // clearPromptLines(2);
+            // Step 3a: Select existing agent
+            const result = await selectExistingAgent(apiKey);
+            selectedAgent = result.agent;
+            selectedOrg = result.org;
         }
         else {
-            // Create new agent flow - always use baseAgent
-            writeProgress("🔄 Fetching agent types...");
-            const agentTypesResult = await ApiService.Agent.getAgentTypes(apiKey);
-            const agentTypes = agentTypesResult.success ? agentTypesResult.data || [] : [];
-            writeProgress("✅ Agent types loaded");
-            // Always select Base Agent (skip user selection)
-            let selectedAgentType = agentTypes.find((type) => type.name === 'Base Agent' ||
-                type.name === 'baseAgent' ||
-                type.name.toLowerCase().includes('base'));
-            // If still not found, use the first available type
-            if (!selectedAgentType && agentTypes.length > 0) {
-                selectedAgentType = agentTypes[0];
-                writeProgress(`⚠️  baseAgent not found, using ${selectedAgentType.name} instead`);
-            }
-            if (!selectedAgentType) {
-                throw new Error("No agent types available. Please contact support.");
-            }
-            writeProgress(`✅ Using agent type: ${selectedAgentType.name}`);
-            // Collect required metadata
-            const metadata = {};
-            if (selectedAgentType.requiredSubAgentMetadata && selectedAgentType.requiredSubAgentMetadata.length > 0) {
-                for (const field of selectedAgentType.requiredSubAgentMetadata) {
-                    const { [field]: value } = await inquirer.prompt([
-                        {
-                            type: "input",
-                            name: field,
-                            message: `Enter ${field}:`,
-                            validate: (input) => input.trim().length > 0 || `${field} is required`
-                        }
-                    ]);
-                    metadata[field] = value;
-                    // Clear the metadata prompt lines
-                    // clearPromptLines(2);
-                }
-            }
-            // Configure features
-            const features = {};
-            const availableFeatures = Object.keys(selectedAgentType.features);
-            let linesToClear = 1;
-            if (availableFeatures.length > 0) {
-                for (const feature of availableFeatures) {
-                    const { [feature]: enabled } = await inquirer.prompt([
-                        {
-                            type: "confirm",
-                            name: feature,
-                            message: `Enable ${feature} feature?`,
-                            default: selectedAgentType.features[feature]?.active || false
-                        }
-                    ]);
-                    features[feature] = enabled;
-                    linesToClear++;
-                    // Clear the feature prompt lines
-                    // clearPromptLines(2);
-                }
-            }
-            // Collect persona information
-            const businessTypes = [
-                "Retail & Consumer Goods (e.g. clothing store, bookstore)",
-                "Food & Beverage (e.g. restaurant, bakery)",
-                "Hospitality (e.g. hotel, resort)",
-                "Personal services (e.g. hair salon, spa)",
-                "Education (e.g. language school, online courses)",
-                "Health (e.g. gym, yoga studio, clinic)"
-            ];
-            const brandPersonalities = [
-                "Energetic & fun",
-                "Refined & elegant",
-                "Chatty",
-                "Casual",
-                "Funny",
-                "Friendly"
-            ];
-            const { businessName } = await inquirer.prompt([
-                {
-                    type: "input",
-                    name: "businessName",
-                    message: "Enter business name:",
-                    default: "Private"
-                }
-            ]);
-            // clearPromptLines(2);
-            linesToClear++;
-            const { agentName } = await inquirer.prompt([
-                {
-                    type: "input",
-                    name: "agentName",
-                    message: "Enter agent name:",
-                    validate: (input) => input.trim().length > 0 || "Agent name is required"
-                }
-            ]);
-            // clearPromptLines(2);
-            linesToClear++;
-            const { businessType } = await inquirer.prompt([
-                {
-                    type: "list",
-                    name: "businessType",
-                    message: "Select business type:",
-                    choices: businessTypes
-                }
-            ]);
-            // clearPromptLines(2);
-            linesToClear++;
-            const { brandPersonality } = await inquirer.prompt([
-                {
-                    type: "list",
-                    name: "brandPersonality",
-                    message: "Select brand personality:",
-                    choices: brandPersonalities
-                }
-            ]);
-            // clearPromptLines(2);
-            linesToClear++;
-            const { brandTraits } = await inquirer.prompt([
-                {
-                    type: "input",
-                    name: "brandTraits",
-                    message: "Enter brand traits (any traits the agent might have):",
-                    default: ""
-                }
-            ]);
-            // clearPromptLines(2);
-            linesToClear++;
-            // For new agents, we need to handle organization selection
-            // For now, we'll create a new organization with the business name
-            // In the future, we could add organization selection here too
-            clearPromptLines(linesToClear);
-            linesToClear = 0;
-            // Create agent
-            writeProgress("🔄 Creating agent...");
-            const agentData = {
-                id: `agent_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
-                type: selectedAgentType.id,
-                metadata,
-                persona: {
-                    agentName,
-                    businessType,
-                    brandPersonality,
-                    brandTraits
-                },
-                features,
-                channels: [],
-                org: {
-                    registeredName: businessName
-                }
-            };
-            const createAgentResult = await ApiService.Agent.createAgent(apiKey, agentData);
-            if (!createAgentResult.success || !createAgentResult.data) {
-                console.error("❌ Failed to create agent:", createAgentResult.error?.message || "Unknown error");
-                process.exit(1);
-            }
-            writeProgress("✅ Agent created successfully!");
-            // Wait 30 seconds and get agent details
-            writeProgress("⏳ Waiting for agent to be ready...");
-            await new Promise(resolve => setTimeout(resolve, 30000));
-            writeProgress("🔄 Fetching agent details...");
-            const agentDetailsResult = await ApiService.Agent.getAgent(apiKey, createAgentResult.data?.agentId);
-            if (!agentDetailsResult.success || !agentDetailsResult.data) {
-                console.error("❌ Failed to fetch agent details:", agentDetailsResult.error?.message || "Unknown error");
-                process.exit(1);
-            }
-            selectedAgent = {
-                agentId: createAgentResult.data.agentId,
-                name: createAgentResult.data.name
-            };
-            persona = agentDetailsResult.data.persona;
-            welcomeMessage = agentDetailsResult.data.welcomeMessage;
-            // For new agents, get the organization ID from the created agent response
-            selectedOrg = {
-                id: createAgentResult.data.org.id
-            };
-            writeProgress("✅ Agent details loaded");
-        }
-        // Skills will be created automatically during compilation
-        // Copy template files
-        const templateDir = getTemplateDir();
-        const currentDir = process.cwd();
-        copyTemplateFiles(templateDir, currentDir);
-        createSkillYaml(selectedAgent.agentId, selectedOrg.id, undefined, undefined, persona, welcomeMessage);
-        writeProgress("✅ Created lua.skill.yaml");
-        writeProgress("✅ Copied template files");
-        // Install dependencies
-        writeProgress("📦 Installing dependencies...");
-        const { execSync } = await import('child_process');
-        try {
-            execSync('npm install --force', { stdio: 'inherit', cwd: currentDir });
-            writeProgress("✅ Dependencies installed successfully");
-        }
-        catch (error) {
-            writeProgress("⚠️  Warning: Failed to install dependencies automatically. Please run 'npm install' manually.");
+            // Step 3b: Create new agent
+            const result = await createNewAgentFlow(apiKey);
+            selectedAgent = result.agent;
+            selectedOrg = result.org;
+            persona = result.persona;
+            welcomeMessage = result.welcomeMessage;
         }
+        // Step 4: Initialize project
+        const currentDir = initializeProject(selectedAgent.agentId, selectedOrg.id, persona, welcomeMessage);
+        // Step 5: Install dependencies
+        await installDependencies(currentDir);
         writeSuccess("✅ Lua skill project initialized successfully!");
     }, "initialization");
 }
+/**
+ * Handles the flow for selecting an existing agent.
+ *
+ * @param apiKey - User's API key
+ * @returns Selected agent and organization
+ */
+async function selectExistingAgent(apiKey) {
+    // Get user data from API
+    const userData = await checkApiKey(apiKey);
+    // Extract organizations
+    const orgs = userData.admin.orgs;
+    if (!orgs || orgs.length === 0) {
+        throw new Error("No organizations found.");
+    }
+    // Select organization
+    const selectedOrg = await promptOrganizationSelection(orgs);
+    // Select agent from organization
+    const selectedAgent = await promptAgentSelection(selectedOrg);
+    return { agent: selectedAgent, org: selectedOrg };
+}
+/**
+ * Handles the flow for creating a new agent.
+ *
+ * @param apiKey - User's API key
+ * @returns Created agent, organization, and optional persona/welcome message
+ */
+async function createNewAgentFlow(apiKey) {
+    // Fetch and select agent type
+    const agentTypes = await fetchAgentTypes(apiKey);
+    const selectedAgentType = selectBaseAgentType(agentTypes);
+    // Collect required metadata
+    let linesToClear = 1;
+    const metadata = selectedAgentType.requiredSubAgentMetadata?.length
+        ? await promptMetadataCollection(selectedAgentType.requiredSubAgentMetadata)
+        : {};
+    // Configure features
+    const availableFeatures = Object.keys(selectedAgentType.features);
+    const features = availableFeatures.length > 0
+        ? await promptFeatureConfiguration(selectedAgentType)
+        : {};
+    linesToClear += availableFeatures.length;
+    // Collect business configuration
+    const businessConfig = await promptBusinessConfiguration();
+    linesToClear += 5; // businessName, agentName, businessType, brandPersonality, brandTraits
+    // Clear all prompts
+    clearLinesIfNeeded(linesToClear);
+    // Create the agent
+    const result = await createNewAgent(apiKey, selectedAgentType, businessConfig, metadata, features);
+    return result;
+}

package/dist/commands/push.d.ts

@@ -1,22 +1,25 @@
-export interface PushVersionResponse {
-    success: boolean;
-    data?: {
-        skillsId: string;
-        version: string;
-        context: string;
-        description: string;
-        tools: any[];
-        _id: string;
-        id: string;
-        createdAt: string;
-        updatedAt: string;
-        __v: number;
-    };
-    error?: {
-        message: string;
-        error: string;
-        statusCode: number;
-    };
-}
-export declare function pushVersion(apiKey: string, agentId: string, skillId: string, versionData: any): Promise<PushVersionResponse>;
+/**
+ * Push Command
+ * Orchestrates pushing skill versions to the server
+ */
+/**
+ * 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
+ *
+ * Use this command to:
+ * - Upload a new version of your skill
+ * - Make your skill available for testing in dev mode
+ * - Prepare your skill for deployment
+ *
+ * Note: This does NOT deploy to production. Use `lua deploy` for that.
+ *
+ * @returns Promise that resolves when push completes
+ */
 export declare function pushCommand(): Promise<void>;

package/dist/commands/push.js

@@ -1,115 +1,62 @@
-import fs from 'fs';
-import path from 'path';
-import inquirer from 'inquirer';
+/**
+ * Push Command
+ * Orchestrates pushing skill versions to the server
+ */
 import { compileCommand } from './compile.js';
 import { checkApiKey, loadApiKey } 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 pushVersion(apiKey, agentId, skillId, versionData) {
-    try {
-        const response = await ApiService.Skill.pushSkill(apiKey, agentId, skillId, versionData);
-        if (response.success) {
-            return {
-                success: true,
-                data: response.data
-            };
-        }
-        else {
-            return {
-                success: false,
-                error: {
-                    message: response.error?.message || 'Unknown error',
-                    error: response.error?.message || 'Unknown error',
-                    statusCode: response.error?.statusCode || 500
-                }
-            };
-        }
-    }
-    catch (error) {
-        console.error("❌ Error pushing version:", error);
-        return {
-            success: false,
-            error: {
-                message: "Network error",
-                error: "Failed to connect to server",
-                statusCode: 500
-            }
-        };
-    }
-}
-function readConfigVersion() {
-    const config = readSkillConfig();
-    return config?.skill?.version || null;
-}
-function readDeployJson() {
-    const deployPath = path.join(process.cwd(), '.lua', 'deploy.json');
-    if (!fs.existsSync(deployPath)) {
-        return null;
-    }
-    const deployContent = fs.readFileSync(deployPath, 'utf8');
-    return JSON.parse(deployContent);
-}
+import { withErrorHandling, writeProgress, writeSuccess } from '../utils/cli.js';
+import { readDeployJson, confirmVersionPush, validatePushConfig, validateDeployData, } 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
+ *
+ * Use this command to:
+ * - Upload a new version of your skill
+ * - Make your skill available for testing in dev mode
+ * - Prepare your skill for deployment
+ *
+ * Note: This does NOT deploy to production. Use `lua deploy` for that.
+ *
+ * @returns Promise that resolves when push completes
+ */
 export async function pushCommand() {
     return withErrorHandling(async () => {
-        // Check if we're in a skill directory
+        // Step 1: Validate configuration
         const config = readSkillConfig();
-        if (!config) {
-            console.error("❌ No lua.skill.yaml found. Please run this command from a skill directory.");
-            process.exit(1);
-        }
-        // Read version from config
-        const version = config.skill?.version;
-        if (!version) {
-            console.error("❌ No version found in skill configuration");
-            process.exit(1);
-        }
-        // Confirm with user
-        const { confirmed } = await inquirer.prompt([
-            {
-                type: "confirm",
-                name: "confirmed",
-                message: `Are you sure you want to push version ${version}?`,
-                default: false
-            }
-        ]);
-        // Clear the confirmation prompt lines
-        clearPromptLines(2);
+        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);
         }
-        // Load API key
+        // 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.");
             process.exit(1);
         }
-        // Validate API key
         const userData = await checkApiKey(apiKey);
         writeProgress("✅ Authenticated");
-        // Compile the skill first
+        // Step 4: Compile the skill
         writeProgress("🔄 Compiling skill...");
         await compileCommand();
-        // Read deploy.json
+        // Step 5: Validate deploy data
         const deployData = readDeployJson();
-        if (!deployData) {
-            console.error("❌ No deploy.json found. Compilation may have failed.");
-            process.exit(1);
-        }
-        // Verify version matches
-        if (deployData.version !== version) {
-            console.error(`❌ Version mismatch: config has ${version}, deploy.json has ${deployData.version}`);
-            process.exit(1);
-        }
-        // Extract agentId and skillId from config
-        const agentId = config.agent?.agentId;
-        const skillId = config.skill?.skillId;
-        if (!agentId || !skillId) {
-            console.error("❌ Missing agentId or skillId in skill configuration");
-            process.exit(1);
-        }
-        // Push version
+        validateDeployData(deployData, version);
+        // Step 6: Push version to server
+        const agentId = config.agent.agentId;
+        const skillId = config.skill.skillId;
         writeProgress("🔄 Pushing version to server...");
         const result = await pushVersion(apiKey, agentId, skillId, deployData);
         if (result.success && result.data) {

package/dist/commands/test.d.ts

@@ -1 +1,27 @@
+/**
+ * Test Command
+ * Orchestrates the testing of individual tools in a local sandbox environment
+ */
+/**
+ * Main test command - tests a tool in a local sandbox environment.
+ *
+ * This command performs the following steps:
+ * 1. Compiles the skill to ensure latest code
+ * 2. Loads deploy.json with tool definitions
+ * 3. Extracts all available tools
+ * 4. Prompts user to select a tool
+ * 5. Collects input values based on tool's input schema
+ * 6. Executes the tool in a sandboxed environment
+ * 7. Displays the results
+ *
+ * Features:
+ * - Interactive tool selection from compiled tools
+ * - Dynamic input prompts based on tool schemas
+ * - Support for nested object inputs
+ * - Environment variable injection
+ * - Secure sandbox execution
+ * - Detailed error reporting
+ *
+ * @returns Promise that resolves when test completes
+ */
 export declare function testCommand(): Promise<void>;