lua-cli 2.3.2 → 2.4.0

package/dist/commands/resources.js

@@ -0,0 +1,361 @@
+/**
+ * Resources Command
+ * Manages agent resources (knowledge base documents)
+ */
+import { loadApiKey, checkApiKey } from '../services/auth.js';
+import { readSkillConfig } from '../utils/files.js';
+import { withErrorHandling, writeProgress, writeSuccess } from '../utils/cli.js';
+import { BASE_URLS } from '../config/constants.js';
+import { safePrompt } from '../utils/prompt-handler.js';
+import { validateConfig, validateAgentConfig, } from '../utils/dev-helpers.js';
+/**
+ * Main resources command - manages agent resources
+ *
+ * Features:
+ * - List all resources
+ * - Create new resources
+ * - Update existing resources
+ * - Delete resources
+ * - View resource content
+ *
+ * @returns Promise that resolves when command completes
+ */
+export async function resourcesCommand() {
+    return withErrorHandling(async () => {
+        // Step 1: Load configuration
+        const config = readSkillConfig();
+        validateConfig(config);
+        validateAgentConfig(config);
+        const agentId = config.agent.agentId;
+        // 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);
+        }
+        await checkApiKey(apiKey);
+        writeProgress("✅ Authenticated");
+        const context = {
+            agentId,
+            apiKey,
+        };
+        // Step 3: Start management loop
+        await manageResources(context);
+    }, "resources");
+}
+/**
+ * Main resources management loop
+ */
+async function manageResources(context) {
+    let continueManaging = true;
+    while (continueManaging) {
+        // Load current resources
+        const resources = await loadResources(context);
+        console.log("\n" + "=".repeat(60));
+        console.log("📚 Agent Resources");
+        console.log("=".repeat(60) + "\n");
+        if (resources.length === 0) {
+            console.log("ℹ️  No resources configured.\n");
+            console.log("💡 Resources are knowledge base documents your agent can reference.\n");
+        }
+        else {
+            resources.forEach((resource, index) => {
+                const preview = resource.content.length > 60
+                    ? resource.content.substring(0, 60) + '...'
+                    : resource.content;
+                console.log(`${index + 1}. ${resource.name}`);
+                console.log(`   Preview: ${preview}`);
+                console.log();
+            });
+        }
+        const actionAnswer = await safePrompt([
+            {
+                type: 'list',
+                name: 'action',
+                message: 'What would you like to do?',
+                choices: [
+                    { name: '➕ Create new resource', value: 'create' },
+                    { name: '✏️  Update existing resource', value: 'update' },
+                    { name: '🗑️  Delete resource', value: 'delete' },
+                    { name: '👁️  View resource content', value: 'view' },
+                    { name: '🔄 Refresh list', value: 'refresh' },
+                    { name: '❌ Exit', value: 'exit' }
+                ]
+            }
+        ]);
+        if (!actionAnswer)
+            return;
+        const { action } = actionAnswer;
+        switch (action) {
+            case 'create':
+                await createResource(context);
+                break;
+            case 'update':
+                await updateResource(context, resources);
+                break;
+            case 'delete':
+                await deleteResource(context, resources);
+                break;
+            case 'view':
+                await viewResource(resources);
+                break;
+            case 'refresh':
+                // Just loop again
+                break;
+            case 'exit':
+                continueManaging = false;
+                console.log("\n👋 Goodbye!\n");
+                break;
+        }
+    }
+}
+/**
+ * Load resources from API
+ */
+async function loadResources(context) {
+    try {
+        const response = await fetch(`${BASE_URLS.API}/admin/agents/${context.agentId}/resources`, {
+            method: 'GET',
+            headers: {
+                'accept': 'application/json',
+                'Authorization': `Bearer ${context.apiKey}`
+            }
+        });
+        if (!response.ok) {
+            return [];
+        }
+        const data = await response.json();
+        if (Array.isArray(data)) {
+            return data;
+        }
+        else if (data.data && Array.isArray(data.data)) {
+            return data.data;
+        }
+        return [];
+    }
+    catch (error) {
+        console.error('⚠️  Error loading resources');
+        return [];
+    }
+}
+/**
+ * Create a new resource
+ */
+async function createResource(context) {
+    const answers = await safePrompt([
+        {
+            type: 'input',
+            name: 'name',
+            message: 'Resource name:',
+            validate: (input) => {
+                if (!input.trim())
+                    return 'Resource name is required';
+                return true;
+            }
+        },
+        {
+            type: 'editor',
+            name: 'content',
+            message: 'Resource content (will open in your default editor):',
+            validate: (input) => {
+                if (!input.trim())
+                    return 'Resource content cannot be empty';
+                return true;
+            }
+        }
+    ]);
+    if (!answers)
+        return;
+    writeProgress("🔄 Creating resource...");
+    try {
+        const response = await fetch(`${BASE_URLS.API}/admin/agents/${context.agentId}/resources`, {
+            method: 'POST',
+            headers: {
+                'accept': 'application/json',
+                'Authorization': `Bearer ${context.apiKey}`,
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                name: answers.name.trim(),
+                content: answers.content.trim()
+            })
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`HTTP error! status: ${response.status} - ${errorText}`);
+        }
+        writeSuccess(`✅ Resource "${answers.name}" created successfully`);
+    }
+    catch (error) {
+        console.error('❌ Error creating resource:', error);
+    }
+}
+/**
+ * Update an existing resource
+ */
+async function updateResource(context, resources) {
+    if (resources.length === 0) {
+        console.log("\nℹ️  No resources to update.\n");
+        return;
+    }
+    const selectAnswer = await safePrompt([
+        {
+            type: 'list',
+            name: 'selectedId',
+            message: 'Select resource to update:',
+            choices: resources.map(r => ({
+                name: r.name,
+                value: r.id
+            }))
+        }
+    ]);
+    if (!selectAnswer)
+        return;
+    const selectedResource = resources.find(r => r.id === selectAnswer.selectedId);
+    const updateAnswers = await safePrompt([
+        {
+            type: 'input',
+            name: 'name',
+            message: 'Resource name:',
+            default: selectedResource.name,
+            validate: (input) => {
+                if (!input.trim())
+                    return 'Resource name is required';
+                return true;
+            }
+        },
+        {
+            type: 'editor',
+            name: 'content',
+            message: 'Resource content (will open in your default editor):',
+            default: selectedResource.content,
+            validate: (input) => {
+                if (!input.trim())
+                    return 'Resource content cannot be empty';
+                return true;
+            }
+        }
+    ]);
+    if (!updateAnswers)
+        return;
+    writeProgress("🔄 Updating resource...");
+    try {
+        const response = await fetch(`${BASE_URLS.API}/admin/agents/${context.agentId}/resources/${selectAnswer.selectedId}`, {
+            method: 'PUT',
+            headers: {
+                'accept': 'application/json',
+                'Authorization': `Bearer ${context.apiKey}`,
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                name: updateAnswers.name.trim(),
+                content: updateAnswers.content.trim()
+            })
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`HTTP error! status: ${response.status} - ${errorText}`);
+        }
+        writeSuccess(`✅ Resource "${updateAnswers.name}" updated successfully`);
+    }
+    catch (error) {
+        console.error('❌ Error updating resource:', error);
+    }
+}
+/**
+ * Delete a resource
+ */
+async function deleteResource(context, resources) {
+    if (resources.length === 0) {
+        console.log("\nℹ️  No resources to delete.\n");
+        return;
+    }
+    const selectAnswer = await safePrompt([
+        {
+            type: 'list',
+            name: 'selectedId',
+            message: 'Select resource to delete:',
+            choices: resources.map(r => ({
+                name: r.name,
+                value: r.id
+            }))
+        }
+    ]);
+    if (!selectAnswer)
+        return;
+    const selectedResource = resources.find(r => r.id === selectAnswer.selectedId);
+    const confirmAnswer = await safePrompt([
+        {
+            type: 'confirm',
+            name: 'confirm',
+            message: `Are you sure you want to delete "${selectedResource.name}"?`,
+            default: false
+        }
+    ]);
+    if (!confirmAnswer || !confirmAnswer.confirm) {
+        console.log("\nℹ️  Deletion cancelled.\n");
+        return;
+    }
+    writeProgress("🔄 Deleting resource...");
+    try {
+        const response = await fetch(`${BASE_URLS.API}/admin/agents/${context.agentId}/resources/${selectAnswer.selectedId}`, {
+            method: 'DELETE',
+            headers: {
+                'accept': '*/*',
+                'Authorization': `Bearer ${context.apiKey}`
+            }
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`HTTP error! status: ${response.status} - ${errorText}`);
+        }
+        writeSuccess(`✅ Resource "${selectedResource.name}" deleted successfully`);
+    }
+    catch (error) {
+        console.error('❌ Error deleting resource:', error);
+    }
+}
+/**
+ * View a resource's full content
+ */
+async function viewResource(resources) {
+    if (resources.length === 0) {
+        console.log("\nℹ️  No resources to view.\n");
+        return;
+    }
+    const selectAnswer = await safePrompt([
+        {
+            type: 'list',
+            name: 'selectedId',
+            message: 'Select resource to view:',
+            choices: resources.map(r => ({
+                name: r.name,
+                value: r.id
+            }))
+        }
+    ]);
+    if (!selectAnswer)
+        return;
+    const resource = resources.find(r => r.id === selectAnswer.selectedId);
+    console.log("\n" + "=".repeat(60));
+    console.log(`📄 Resource: ${resource.name}`);
+    console.log("=".repeat(60));
+    if (resource.createdAt) {
+        const date = new Date(resource.createdAt);
+        console.log(`Created: ${date.toLocaleString()}`);
+    }
+    if (resource.updatedAt) {
+        const date = new Date(resource.updatedAt);
+        console.log(`Updated: ${date.toLocaleString()}`);
+    }
+    console.log("=".repeat(60) + "\n");
+    console.log(resource.content);
+    console.log("\n" + "=".repeat(60) + "\n");
+    await safePrompt([
+        {
+            type: 'input',
+            name: 'continue',
+            message: 'Press Enter to continue...'
+        }
+    ]);
+}

package/dist/common/data.entry.instance.js

@@ -29,7 +29,9 @@ export default class DataEntryInstance {
     toJSON() {
         return {
             ...this.data,
-            score: this.score
+            score: this.score,
+            id: this.id,
+            collectionName: this.collectionName
         };
     }
     /**
@@ -39,7 +41,9 @@ export default class DataEntryInstance {
     [Symbol.for('nodejs.util.inspect.custom')]() {
         return {
             ...this.data,
-            score: this.score
+            score: this.score,
+            id: this.id,
+            collectionName: this.collectionName
         };
     }
     /**

package/dist/config/compile.constants.d.ts

@@ -33,10 +33,11 @@ export declare const SKILL_DEFAULTS: {
 };
 /**
  * External packages that should not be bundled with tools
- * These are either lua-cli modules, native modules, or modules
- * that should be provided by the runtime environment
+ * These are native modules, or modules that should be provided by the runtime environment
+ * Note: lua-cli is NOT in this list because it's handled by the sandboxGlobalsPlugin
+ * which transforms imports to use sandbox globals instead
  */
-export declare const EXTERNAL_PACKAGES: readonly ["lua-cli/skill", "lua-cli", "lua-cli/user-data-api", "lua-cli/product-api", "lua-cli/custom-data-api", "zod", "keytar", "esbuild", "commander", "inquirer", "node-fetch", "ws", "socket.io-client", "ts-morph"];
+export declare const EXTERNAL_PACKAGES: readonly ["zod", "keytar", "esbuild", "commander", "inquirer", "node-fetch", "ws", "socket.io-client", "ts-morph"];
 /**
  * Common esbuild configuration for tool bundling
  */

package/dist/config/compile.constants.js

@@ -32,15 +32,11 @@ export const SKILL_DEFAULTS = {
 };
 /**
  * External packages that should not be bundled with tools
- * These are either lua-cli modules, native modules, or modules
- * that should be provided by the runtime environment
+ * These are native modules, or modules that should be provided by the runtime environment
+ * Note: lua-cli is NOT in this list because it's handled by the sandboxGlobalsPlugin
+ * which transforms imports to use sandbox globals instead
  */
 export const EXTERNAL_PACKAGES = [
-    'lua-cli/skill',
-    'lua-cli',
-    'lua-cli/user-data-api',
-    'lua-cli/product-api',
-    'lua-cli/custom-data-api',
     'zod',
     'keytar',
     'esbuild',

package/dist/config/constants.d.ts

@@ -1,5 +1,11 @@
+/**
+ * Base URLs for the API, Auth, and Chat - Production
+ */
 export declare const BASE_URLS: {
     readonly API: "https://api.heylua.ai";
     readonly AUTH: "https://auth.heylua.ai";
     readonly CHAT: "https://api.heylua.ai";
 };
+/**
+ * Base URLs for the API, Auth, and Chat - Development
+ */

package/dist/config/constants.js

@@ -1,5 +1,16 @@
+/**
+ * Base URLs for the API, Auth, and Chat - Production
+ */
 export const BASE_URLS = {
     API: 'https://api.heylua.ai',
     AUTH: 'https://auth.heylua.ai',
     CHAT: 'https://api.heylua.ai',
 };
+/**
+ * Base URLs for the API, Auth, and Chat - Development
+ */
+// export const BASE_URLS = {
+//   API: 'http://localhost:3022',
+//   AUTH: 'https://auth.heylua.ai',
+//   CHAT: 'http://localhost:3001',
+// } as const;

package/dist/index.d.ts

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

package/dist/index.js

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

package/dist/utils/bundling.js

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

package/dist/utils/prompt-handler.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Prompt Handler Utility
+ * Gracefully handles user interruptions (Ctrl+C) in inquirer prompts
+ */
+/**
+ * Wraps inquirer.prompt to gracefully handle Ctrl+C interruptions
+ */
+export declare function safePrompt<T = any>(questions: any): Promise<T | null>;
+/**
+ * Setup global SIGINT handler for graceful exits
+ */
+export declare function setupGlobalInterruptHandler(): void;

package/dist/utils/prompt-handler.js

@@ -0,0 +1,31 @@
+/**
+ * Prompt Handler Utility
+ * Gracefully handles user interruptions (Ctrl+C) in inquirer prompts
+ */
+import inquirer from 'inquirer';
+/**
+ * Wraps inquirer.prompt to gracefully handle Ctrl+C interruptions
+ */
+export async function safePrompt(questions) {
+    try {
+        const answers = await inquirer.prompt(questions);
+        return answers;
+    }
+    catch (error) {
+        // Handle Ctrl+C gracefully
+        if (error.name === 'ExitPromptError' || error.message?.includes('SIGINT')) {
+            console.log('\n\n👋 Operation cancelled. Goodbye!\n');
+            process.exit(0);
+        }
+        throw error;
+    }
+}
+/**
+ * Setup global SIGINT handler for graceful exits
+ */
+export function setupGlobalInterruptHandler() {
+    process.on('SIGINT', () => {
+        console.log('\n\n👋 Operation cancelled. Goodbye!\n');
+        process.exit(0);
+    });
+}