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

package/dist/api-exports.js

@@ -1,189 +1,372 @@
-// API exports for use in LuaSkills - separate from CLI
-import { LuaSkill } from "./skill.js";
+/**
+ * Lua Skill API Exports
+ *
+ * Public API surface for LuaSkill tools.
+ * This module provides simplified interfaces to Lua platform APIs
+ * for use within skill implementations.
+ *
+ * Available APIs:
+ * - User: User data management
+ * - Data: Custom data collections (vector search, CRUD)
+ * - Products: Product catalog management
+ * - Baskets: Shopping basket operations
+ * - Orders: Order management
+ *
+ * Usage in skills:
+ * ```typescript
+ * import { User, Data, Products, Baskets, Orders } from 'lua-cli';
+ *
+ * // Get user data
+ * const user = await User.get();
+ *
+ * // Create custom data entry
+ * await Data.create('customers', { name: 'John' });
+ *
+ * // Search products
+ * const products = await Products.search('laptop');
+ * ```
+ */
+import { LuaSkill, env } from "./types/skill.js";
 import { BasketStatus } from "./interfaces/baskets.js";
 import { OrderStatus } from "./interfaces/orders.js";
-import { loadApiKey } from "./services/auth.js";
-import { readSkillConfig } from "./utils/files.js";
-import { BASE_URLS } from "./common/config.js";
-// Import the actual API service classes for proper instantiation
-import ProductApiService from "./api/products.api.service.js";
-import BasketApiService from "./api/basket.api.service.js";
-import OrderApiService from "./api/order.api.service.js";
-import UserDataApiService from "./api/user.data.api.service.js";
-import CustomDataApiService from "./api/custom.data.api.service.js";
-async function getCredentials() {
-    // Load API key from keystore
-    const apiKey = await loadApiKey();
-    if (!apiKey) {
-        throw new Error('No API key found. Please run "lua auth configure" first.');
-    }
-    // Load agent ID from YAML file
-    const config = readSkillConfig();
-    if (!config?.agent?.agentId) {
-        throw new Error('No agent ID found in lua.skill.yaml. Please run "lua init" first.');
-    }
-    return {
-        apiKey,
-        agentId: config.agent.agentId
-    };
-}
-// Lazy-loaded API instances to avoid top-level await
-let _userInstance = null;
-let _dataInstance = null;
-let _productsInstance = null;
-let _basketsInstance = null;
-let _orderInstance = null;
-async function getUserInstance() {
-    if (!_userInstance) {
-        const creds = await getCredentials();
-        _userInstance = new UserDataApiService(BASE_URLS.API, creds.apiKey, creds.agentId);
-    }
-    return _userInstance;
-}
-async function getDataInstance() {
-    if (!_dataInstance) {
-        const creds = await getCredentials();
-        _dataInstance = new CustomDataApiService(BASE_URLS.API, creds.apiKey, creds.agentId);
-    }
-    return _dataInstance;
-}
-async function getProductsInstance() {
-    if (!_productsInstance) {
-        const creds = await getCredentials();
-        _productsInstance = new ProductApiService(BASE_URLS.API, creds.apiKey, creds.agentId);
-    }
-    return _productsInstance;
-}
-async function getBasketsInstance() {
-    if (!_basketsInstance) {
-        const creds = await getCredentials();
-        _basketsInstance = new BasketApiService(BASE_URLS.API, creds.apiKey, creds.agentId);
-    }
-    return _basketsInstance;
-}
-async function getOrderInstance() {
-    if (!_orderInstance) {
-        const creds = await getCredentials();
-        _orderInstance = new OrderApiService(BASE_URLS.API, creds.apiKey, creds.agentId);
-    }
-    return _orderInstance;
-}
+import { getUserInstance, getDataInstance, getProductsInstance, getBasketsInstance, getOrderInstance, } from "./api/lazy-instances.js";
+// ============================================================================
+// USER DATA API
+// ============================================================================
+/**
+ * User Data API
+ * Access user information and preferences
+ */
 export const User = {
+    /**
+     * Retrieves current user data.
+     *
+     * @returns Promise resolving to user data
+     */
     async get() {
         const instance = await getUserInstance();
         return instance.get();
-    },
-    async update(data) {
-        const instance = await getUserInstance();
-        return instance.update(data);
-    },
-    async clear() {
-        const instance = await getUserInstance();
-        return instance.clear();
     }
 };
+// ============================================================================
+// CUSTOM DATA API
+// ============================================================================
+/**
+ * Custom Data API
+ * Store and retrieve custom data with vector search capabilities
+ */
 export const Data = {
+    /**
+     * Creates a new entry in a custom data collection.
+     *
+     * @param collectionName - Name of the collection
+     * @param data - Data to store
+     * @param searchText - Optional text for vector search indexing
+     * @returns Promise resolving to created entry
+     */
     async create(collectionName, data, searchText) {
         const instance = await getDataInstance();
-        console.log('collectionName', collectionName);
-        console.log('data', data);
-        console.log('searchText', searchText);
         return instance.create(collectionName, data, searchText);
     },
+    /**
+     * Retrieves entries from a collection with optional filtering and pagination.
+     *
+     * @param collectionName - Name of the collection
+     * @param filter - Optional filter criteria
+     * @param page - Page number (default: 1)
+     * @param limit - Items per page (default: 10)
+     * @returns Promise resolving to array of entries
+     */
     async get(collectionName, filter, page, limit) {
         const instance = await getDataInstance();
         return instance.get(collectionName, filter, page, limit);
     },
+    /**
+     * Retrieves a specific entry by ID.
+     *
+     * @param collectionName - Name of the collection
+     * @param entryId - ID of the entry
+     * @returns Promise resolving to entry data
+     */
     async getEntry(collectionName, entryId) {
         const instance = await getDataInstance();
         return instance.getEntry(collectionName, entryId);
     },
+    /**
+     * Updates an existing entry.
+     *
+     * @param collectionName - Name of the collection
+     * @param entryId - ID of the entry to update
+     * @param data - Updated data
+     * @returns Promise resolving to updated entry
+     */
     async update(collectionName, entryId, data) {
         const instance = await getDataInstance();
         return instance.update(collectionName, entryId, data);
     },
+    /**
+     * Performs vector search on a collection.
+     *
+     * @param collectionName - Name of the collection
+     * @param searchText - Text to search for
+     * @param limit - Maximum results to return
+     * @param scoreThreshold - Minimum similarity score (0-1)
+     * @returns Promise resolving to search results
+     */
     async search(collectionName, searchText, limit, scoreThreshold) {
         const instance = await getDataInstance();
         return instance.search(collectionName, searchText, limit, scoreThreshold);
     },
+    /**
+     * Deletes an entry from a collection.
+     *
+     * @param collectionName - Name of the collection
+     * @param entryId - ID of the entry to delete
+     * @returns Promise resolving when deletion is complete
+     */
     async delete(collectionName, entryId) {
         const instance = await getDataInstance();
         return instance.delete(collectionName, entryId);
     }
 };
+// ============================================================================
+// PRODUCTS API
+// ============================================================================
+/**
+ * Products API
+ * Manage product catalog
+ */
 export const Products = {
+    /**
+     * Retrieves products with pagination.
+     *
+     * @param limit - Items per page
+     * @param page - Page number
+     * @returns Promise resolving to product list
+     */
     async get(limit, page) {
         const instance = await getProductsInstance();
         return instance.get(limit, page);
     },
+    /**
+     * Creates a new product.
+     *
+     * @param product - Product data
+     * @returns Promise resolving to created product
+     */
     async create(product) {
         const instance = await getProductsInstance();
         return instance.create(product);
     },
+    /**
+     * Updates an existing product.
+     *
+     * @param data - Updated product data
+     * @param id - Product ID
+     * @returns Promise resolving to updated product
+     */
     async update(data, id) {
         const instance = await getProductsInstance();
         return instance.update(data, id);
     },
+    /**
+     * Deletes a product.
+     *
+     * @param id - Product ID
+     * @returns Promise resolving when deletion is complete
+     */
     async delete(id) {
         const instance = await getProductsInstance();
         return instance.delete(id);
     },
+    /**
+     * Searches products by query string.
+     *
+     * @param query - Search query
+     * @returns Promise resolving to search results
+     */
     async search(query) {
         const instance = await getProductsInstance();
         return instance.search(query);
+    },
+    /**
+     * Retrieves a specific product by ID.
+     *
+     * @param id - Product ID
+     * @returns Promise resolving to product data
+     */
+    async getById(id) {
+        const instance = await getProductsInstance();
+        return instance.getById(id);
     }
 };
+// ============================================================================
+// BASKETS API
+// ============================================================================
+/**
+ * Baskets API
+ * Manage shopping baskets
+ */
 export const Baskets = {
+    /**
+     * Creates a new basket.
+     *
+     * @param basketData - Basket initialization data
+     * @returns Promise resolving to created basket
+     */
     async create(basketData) {
         const instance = await getBasketsInstance();
         return instance.create(basketData);
     },
+    /**
+     * Retrieves baskets, optionally filtered by status.
+     *
+     * @param status - Optional basket status filter
+     * @returns Promise resolving to basket list
+     */
     async get(status) {
         const instance = await getBasketsInstance();
         return instance.get(status);
     },
+    /**
+     * Adds an item to a basket.
+     *
+     * @param basketId - Basket ID
+     * @param itemData - Item data to add
+     * @returns Promise resolving to updated basket
+     */
     async addItem(basketId, itemData) {
         const instance = await getBasketsInstance();
         return instance.addItem(basketId, itemData);
     },
+    /**
+     * Removes an item from a basket.
+     *
+     * @param basketId - Basket ID
+     * @param itemId - Item ID to remove
+     * @returns Promise resolving to updated basket
+     */
     async removeItem(basketId, itemId) {
         const instance = await getBasketsInstance();
         return instance.removeItem(basketId, itemId);
     },
+    /**
+     * Clears all items from a basket.
+     *
+     * @param basketId - Basket ID
+     * @returns Promise resolving to cleared basket
+     */
     async clear(basketId) {
         const instance = await getBasketsInstance();
         return instance.clear(basketId);
     },
+    /**
+     * Updates basket status.
+     *
+     * @param basketId - Basket ID
+     * @param status - New basket status
+     * @returns Promise resolving to updated basket
+     */
     async updateStatus(basketId, status) {
         const instance = await getBasketsInstance();
         return instance.updateStatus(basketId, status);
     },
+    /**
+     * Updates basket metadata.
+     *
+     * @param basketId - Basket ID
+     * @param metadata - Metadata to update
+     * @returns Promise resolving to updated basket
+     */
     async updateMetadata(basketId, metadata) {
         const instance = await getBasketsInstance();
         return instance.updateMetadata(basketId, metadata);
     },
+    /**
+     * Converts basket to order.
+     *
+     * @param data - Order data
+     * @param basketId - Basket ID to convert
+     * @returns Promise resolving to created order
+     */
     async placeOrder(data, basketId) {
         const instance = await getBasketsInstance();
         return instance.placeOrder(data, basketId);
+    },
+    /**
+     * Retrieves a specific basket by ID.
+     *
+     * @param basketId - Basket ID
+     * @returns Promise resolving to basket data
+     */
+    async getById(basketId) {
+        const instance = await getBasketsInstance();
+        return instance.getById(basketId);
     }
 };
+// ============================================================================
+// ORDERS API
+// ============================================================================
+/**
+ * Orders API
+ * Manage orders
+ */
 export const Orders = {
+    /**
+     * Creates a new order.
+     *
+     * @param orderData - Order data
+     * @returns Promise resolving to created order
+     */
     async create(orderData) {
         const instance = await getOrderInstance();
         return instance.create(orderData);
     },
+    /**
+     * Updates order status.
+     *
+     * @param status - New order status
+     * @param orderId - Order ID
+     * @returns Promise resolving to updated order
+     */
     async updateStatus(status, orderId) {
         const instance = await getOrderInstance();
         return instance.updateStatus(status, orderId);
     },
+    /**
+     * Updates order data.
+     *
+     * @param data - Data to update
+     * @param orderId - Order ID
+     * @returns Promise resolving to updated order
+     */
     async updateData(data, orderId) {
         const instance = await getOrderInstance();
         return instance.updateData(data, orderId);
     },
+    /**
+     * Retrieves orders, optionally filtered by status.
+     *
+     * @param status - Optional order status filter
+     * @returns Promise resolving to order list
+     */
     async get(status) {
         const instance = await getOrderInstance();
         return instance.get(status);
+    },
+    /**
+     * Retrieves a specific order by ID.
+     *
+     * @param orderId - Order ID
+     * @returns Promise resolving to order data
+     */
+    async getById(orderId) {
+        const instance = await getOrderInstance();
+        return instance.getById(orderId);
     }
 };
-// Export classes and utilities
-export { LuaSkill, BasketStatus, OrderStatus };
+// ============================================================================
+// EXPORTS
+// ============================================================================
+// Export skill classes and utilities
+export { LuaSkill, BasketStatus, OrderStatus, env };

package/dist/cli/command-definitions.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Command Definitions
+ * Centralized command structure for the CLI
+ */
+import { Command } from "commander";
+/**
+ * Sets up authentication-related commands.
+ *
+ * Commands:
+ * - `lua auth configure` - Set up API key
+ * - `lua auth logout` - Delete stored API key
+ * - `lua auth key` - Display current API key
+ *
+ * @param program - Commander program instance
+ */
+export declare function setupAuthCommands(program: Command): void;
+/**
+ * Sets up skill management commands.
+ *
+ * Commands:
+ * - `lua init` - Initialize new project
+ * - `lua compile` - Compile skill
+ * - `lua test` - Test tools interactively
+ * - `lua push` - Push to server
+ * - `lua deploy` - Deploy to production
+ * - `lua dev` - Development mode with live reload
+ *
+ * @param program - Commander program instance
+ */
+export declare function setupSkillCommands(program: Command): void;

package/dist/cli/command-definitions.js

@@ -0,0 +1,71 @@
+/**
+ * Command Definitions
+ * Centralized command structure for the CLI
+ */
+import { configureCommand, initCommand, destroyCommand, apiKeyCommand, compileCommand, testCommand, pushCommand, deployCommand, devCommand } from "../commands/index.js";
+/**
+ * Sets up authentication-related commands.
+ *
+ * Commands:
+ * - `lua auth configure` - Set up API key
+ * - `lua auth logout` - Delete stored API key
+ * - `lua auth key` - Display current API key
+ *
+ * @param program - Commander program instance
+ */
+export function setupAuthCommands(program) {
+    const authCommand = program
+        .command("auth")
+        .description("Authentication management commands");
+    authCommand
+        .command("configure")
+        .description("Set up your API key")
+        .action(configureCommand);
+    authCommand
+        .command("logout")
+        .description("Delete your stored API key")
+        .action(destroyCommand);
+    authCommand
+        .command("key")
+        .description("Display your stored API key")
+        .action(apiKeyCommand);
+}
+/**
+ * Sets up skill management commands.
+ *
+ * Commands:
+ * - `lua init` - Initialize new project
+ * - `lua compile` - Compile skill
+ * - `lua test` - Test tools interactively
+ * - `lua push` - Push to server
+ * - `lua deploy` - Deploy to production
+ * - `lua dev` - Development mode with live reload
+ *
+ * @param program - Commander program instance
+ */
+export function setupSkillCommands(program) {
+    program
+        .command("init")
+        .description("Initialize a new Lua skill project")
+        .action(initCommand);
+    program
+        .command("compile")
+        .description("Compile Lua skill to generate deployable format")
+        .action(compileCommand);
+    program
+        .command("test")
+        .description("Test Lua skill tools interactively")
+        .action(testCommand);
+    program
+        .command("push")
+        .description("Push compiled skill version to server")
+        .action(pushCommand);
+    program
+        .command("deploy")
+        .description("Deploy a version to production")
+        .action(deployCommand);
+    program
+        .command("dev")
+        .description("Push compiled skill version to sandbox for development")
+        .action(devCommand);
+}

package/dist/commands/agents.d.ts

@@ -1 +1,21 @@
+/**
+ * Agents Command
+ * Lists all organizations and agents accessible to the authenticated user
+ */
+/**
+ * Main agents command - retrieves and displays organization/agent information.
+ *
+ * This command:
+ * 1. Loads the API key from secure storage
+ * 2. Calls the agents API to retrieve organizations
+ * 3. Displays the retrieved data in JSON format
+ *
+ * Use this command to:
+ * - View all organizations you have access to
+ * - Get agent IDs for configuration
+ * - Verify API key permissions
+ *
+ * @returns Promise that resolves when agents are listed
+ * @throws Error if API key is not found or API call fails
+ */
 export declare function agentsCommand(): Promise<void>;

package/dist/commands/agents.js

@@ -1,6 +1,27 @@
-import { ApiService } from '../services/api.js';
+/**
+ * Agents Command
+ * Lists all organizations and agents accessible to the authenticated user
+ */
 import { loadApiKey } from "../services/auth.js";
 import { withErrorHandling, writeSuccess } from "../utils/cli.js";
+import AgentApi from '../api/agent.api.service.js';
+import { BASE_URLS } from '../config/constants.js';
+/**
+ * Main agents command - retrieves and displays organization/agent information.
+ *
+ * This command:
+ * 1. Loads the API key from secure storage
+ * 2. Calls the agents API to retrieve organizations
+ * 3. Displays the retrieved data in JSON format
+ *
+ * Use this command to:
+ * - View all organizations you have access to
+ * - Get agent IDs for configuration
+ * - Verify API key permissions
+ *
+ * @returns Promise that resolves when agents are listed
+ * @throws Error if API key is not found or API call fails
+ */
 export async function agentsCommand() {
     return withErrorHandling(async () => {
         const apiKey = await loadApiKey();
@@ -8,7 +29,8 @@ export async function agentsCommand() {
             console.error("❌ No API key found. Run `lua auth configure` first.");
             process.exit(1);
         }
-        const response = await ApiService.Agent.getOrganizations(apiKey);
+        const agentApi = new AgentApi(BASE_URLS.API, apiKey);
+        const response = await agentApi.getOrganizations();
         if (!response.success) {
             console.error(`❌ Error: ${response.error?.message || 'Unknown error'}`);
             process.exit(1);

package/dist/commands/apiKey.d.ts

@@ -1 +1,24 @@
+/**
+ * API Key Display Command
+ * Securely displays the stored API key with user confirmation
+ */
+/**
+ * Main API key command - displays the stored API key with confirmation.
+ *
+ * This command:
+ * 1. Loads the API key from secure storage
+ * 2. Prompts for confirmation before displaying
+ * 3. Displays the API key if confirmed
+ *
+ * Security:
+ * - Requires explicit confirmation to prevent accidental exposure
+ * - Only displays if user confirms the action
+ *
+ * Use this command to:
+ * - Retrieve your API key for use elsewhere
+ * - Verify which API key is currently configured
+ * - Copy your API key to clipboard
+ *
+ * @returns Promise that resolves when command completes
+ */
 export declare function apiKeyCommand(): Promise<void>;

package/dist/commands/apiKey.js

@@ -1,6 +1,29 @@
+/**
+ * API Key Display Command
+ * Securely displays the stored API key with user confirmation
+ */
 import inquirer from "inquirer";
 import { loadApiKey } from "../services/auth.js";
 import { withErrorHandling, writeProgress, writeSuccess } from "../utils/cli.js";
+/**
+ * Main API key command - displays the stored API key with confirmation.
+ *
+ * This command:
+ * 1. Loads the API key from secure storage
+ * 2. Prompts for confirmation before displaying
+ * 3. Displays the API key if confirmed
+ *
+ * Security:
+ * - Requires explicit confirmation to prevent accidental exposure
+ * - Only displays if user confirms the action
+ *
+ * Use this command to:
+ * - Retrieve your API key for use elsewhere
+ * - Verify which API key is currently configured
+ * - Copy your API key to clipboard
+ *
+ * @returns Promise that resolves when command completes
+ */
 export async function apiKeyCommand() {
     return withErrorHandling(async () => {
         const apiKey = await loadApiKey();

package/dist/commands/compile.d.ts

@@ -1 +1,25 @@
+/**
+ * Compile Command
+ * Orchestrates the skill compilation process by coordinating various compilation steps
+ */
+/**
+ * Main compile command - orchestrates the entire skill compilation process.
+ *
+ * This command performs the following steps:
+ * 1. Cleans and prepares output directories (dist/ and .lua/)
+ * 2. Analyzes the TypeScript project to detect all tools
+ * 3. Bundles each tool individually using esbuild
+ * 4. Extracts execute code and schemas from bundled tools
+ * 5. Bundles the main index file
+ * 6. Creates deployment data in both new and legacy formats
+ *
+ * Output:
+ * - dist/deployment.json - New deployment format with tool references
+ * - dist/tools/*.js - Individual bundled tool files
+ * - dist/index.js - Main skill entry point
+ * - .lua/deploy.json - Legacy deployment format with compressed tools
+ * - .lua/*.js - Individual uncompressed tool files for debugging
+ *
+ * @returns Promise that resolves when compilation is complete
+ */
 export declare function compileCommand(): Promise<void>;