lua-cli 3.1.0-alpha.4 → 3.1.0-alpha.5

package/dist/api-exports.js

@@ -26,10 +26,10 @@
  * const products = await Products.search('laptop');
  * ```
  */
-import { LuaSkill, LuaWebhook, LuaJob, PreProcessor, PostProcessor, LuaAgent, env } from "./types/skill.js";
+import { LuaSkill, LuaWebhook, LuaJob, PreProcessor, PostProcessor, LuaAgent, LuaMCPServer, env } from "./types/skill.js";
 import { BasketStatus } from "./interfaces/baskets.js";
 import { OrderStatus } from "./interfaces/orders.js";
-import { getUserInstance, getDataInstance, getProductsInstance, getBasketsInstance, getOrderInstance, getJobInstance, getChatInstance, getWhatsAppTemplatesInstance, } from "./api/lazy-instances.js";
+import { getUserInstance, getDataInstance, getProductsInstance, getBasketsInstance, getOrderInstance, getJobInstance, getChatInstance, getWhatsAppTemplatesInstance, getCdnInstance, } from "./api/lazy-instances.js";
 import { JobInstance } from "./common/job.instance.js";
 import ProductInstance from "./common/product.instance.js";
 import DataEntryInstance from "./common/data.entry.instance.js";
@@ -114,12 +114,13 @@ export const Data = {
      *
      * @param collectionName - Name of the collection
      * @param entryId - ID of the entry to update
-     * @param data - Updated data
-     * @returns Promise resolving to updated entry
+     * @param data - Updated data fields to merge with existing entry
+     * @param searchText - Optional new search text for vector search indexing
+     * @returns Promise resolving to update response
      */
-    async update(collectionName, entryId, data) {
+    async update(collectionName, entryId, data, searchText) {
         const instance = await getDataInstance();
-        return instance.update(collectionName, entryId, data);
+        return instance.update(collectionName, entryId, data, searchText);
     },
     /**
      * Performs vector search on a collection.
@@ -467,6 +468,25 @@ export const Jobs = {
     async getJob(jobId) {
         const instance = await getJobInstance();
         return instance.getJob(jobId);
+    },
+    /**
+     * Retrieves all jobs for the current agent
+     * @param options - Optional configuration
+     * @param options.includeDynamic - Include dynamically created jobs (default: false)
+     * @returns Promise resolving to an array of JobInstance
+     *
+     * @example
+     * ```typescript
+     * // Get all jobs including dynamically created ones
+     * const jobs = await Jobs.getAll({ includeDynamic: true });
+     * for (const job of jobs) {
+     *   console.log(job.name, job.data.active ? 'active' : 'inactive');
+     * }
+     * ```
+     */
+    async getAll(options = {}) {
+        const instance = await getJobInstance();
+        return instance.getAll(options);
     }
 };
 // ============================================================================
@@ -619,9 +639,69 @@ export const Templates = {
     }
 };
 // ============================================================================
+// CDN API
+// ============================================================================
+/**
+ * CDN API
+ * Upload and retrieve files from the Lua CDN
+ */
+export const CDN = {
+    /**
+     * Uploads a file to the CDN.
+     *
+     * @param file - The File object to upload
+     * @returns Promise resolving to the file ID
+     *
+     * @example
+     * ```typescript
+     * import { CDN } from 'lua-cli';
+     * import { readFileSync } from 'fs';
+     *
+     * const buffer = readFileSync('image.png');
+     * const file = new File([buffer], 'image.png', { type: 'image/png' });
+     * const fileId = await CDN.upload(file);
+     * console.log('Uploaded file ID:', fileId);
+     * ```
+     */
+    async upload(file) {
+        const instance = await getCdnInstance();
+        return instance.upload(file);
+    },
+    /**
+     * Retrieves a file from the CDN by its ID.
+     *
+     * @param fileId - The unique identifier of the file
+     * @returns Promise resolving to a File object
+     *
+     * @example
+     * ```typescript
+     * import { CDN, AI } from 'lua-cli';
+     *
+     * const file = await CDN.get('abc123-def456');
+     * console.log(file.name, file.type, file.size);
+     *
+     * // Use with AI API for image analysis
+     * const buffer = Buffer.from(await file.arrayBuffer());
+     * const response = await AI.generate(
+     *   'You are an image analysis expert.',
+     *   [
+     *     { type: 'text', text: 'What do you see in this image?' },
+     *     { type: 'image', image: buffer, mediaType: file.type }
+     *   ]
+     * );
+     * ```
+     */
+    async get(fileId) {
+        const instance = await getCdnInstance();
+        return instance.get(fileId);
+    }
+};
+// ============================================================================
 // EXPORTS
 // ============================================================================
 // Export skill classes and utilities
-export { LuaSkill, LuaWebhook, LuaJob, PreProcessor, PostProcessor, LuaAgent, BasketStatus, OrderStatus, env };
+export { LuaSkill, LuaWebhook, LuaJob, PreProcessor, PostProcessor, LuaAgent, 
+// MCP Server exports
+LuaMCPServer, BasketStatus, OrderStatus, env };
 // Export instance classes
 export { JobInstance, UserDataInstance, DataEntryInstance, ProductInstance, BasketInstance, OrderInstance };

package/dist/cli/command-definitions.js

@@ -2,7 +2,7 @@
  * Command Definitions
  * Centralized command structure for the CLI
  */
-import { configureCommand, initCommand, destroyCommand, apiKeyCommand, compileCommand, testCommand, pushCommand, deployCommand, chatCommand, chatClearCommand, envCommand, personaCommand, productionCommand, resourcesCommand, adminCommand, docsCommand, channelsCommand, logsCommand, completionCommand, skillsCommand, webhooksCommand, jobsCommand, featuresCommand, preprocessorsCommand, postprocessorsCommand, marketplaceCommand } from "../commands/index.js";
+import { configureCommand, initCommand, destroyCommand, apiKeyCommand, compileCommand, testCommand, pushCommand, deployCommand, devCommand, chatCommand, chatClearCommand, envCommand, personaCommand, productionCommand, resourcesCommand, adminCommand, evalsCommand, docsCommand, channelsCommand, logsCommand, completionCommand, skillsCommand, webhooksCommand, jobsCommand, featuresCommand, preprocessorsCommand, postprocessorsCommand, marketplaceCommand, mcpCommand } from "../commands/index.js";
 /**
  * Sets up authentication-related commands.
  *
@@ -70,6 +70,7 @@ export function setupSkillCommands(program) {
     program
         .command("init")
         .description("🚀 Initialize a new Lua skill project")
+        .option("--with-examples", "Include example skills, tools, jobs, and webhooks")
         .action(initCommand);
     // Development Commands
     program
@@ -94,12 +95,12 @@ Examples:
     // Deployment Commands
     program
         .command("push [type]")
-        .description("☁️  Push skill, webhook, job, or persona version to server")
+        .description("☁️  Push skill, webhook, job, MCP server, or persona version to server")
         .option('--force', 'Skip all confirmation prompts (auto-confirm)')
         .option('--auto-deploy', 'Automatically deploy to production after push')
         .addHelpText('after', `
 Arguments:
-  type                   Optional: 'skill', 'webhook', 'job', 'preprocessor', 'postprocessor', 'persona', or 'all' (prompts if not provided)
+  type                   Optional: 'skill', 'webhook', 'job', 'preprocessor', 'postprocessor', 'mcp', 'persona', or 'all' (prompts if not provided)
 
 Options:
   --force                Skip all confirmation prompts
@@ -110,6 +111,7 @@ Examples:
   $ lua push skill                  Push a skill directly
   $ lua push webhook                Push a webhook directly
   $ lua push job                    Push a job directly
+  $ lua push mcp                    Push an MCP server directly
   $ lua push all --force            Push all components from YAML without prompts
   $ lua push all --force --auto-deploy   Push and deploy all to production
 `)
@@ -119,10 +121,10 @@ Examples:
         .description("🚀 Deploy version to production")
         .action(deployCommand);
     // Temporarily disabled - will be released later
-    // program
-    //   .command("dev")
-    //   .description("🔧 Development mode with live reload")
-    //   .action(devCommand);
+    program
+        .command("dev")
+        .description("🔧 Development mode with live reload")
+        .action(devCommand);
     // Chat Commands
     const chatCmd = program
         .command("chat")
@@ -178,6 +180,10 @@ Examples:
         .command("admin")
         .description("🔧 Open Lua Admin Dashboard in browser")
         .action(adminCommand);
+    program
+        .command("evals")
+        .description("📊 Open Lua Evaluations Dashboard in browser")
+        .action(evalsCommand);
     program
         .command("docs")
         .description("📖 Open Lua documentation in browser")
@@ -276,6 +282,27 @@ Examples:
   $ lua postprocessors         Manage production postprocessors
 `)
         .action(postprocessorsCommand);
+    program
+        .command("mcp [action] [name]")
+        .description("🔌 Manage MCP (Model Context Protocol) servers")
+        .addHelpText('after', `
+Arguments:
+  action                 Optional: 'list', 'activate', 'deactivate', or 'delete'
+  name                   Optional: server name (for activate/deactivate/delete)
+
+Features:
+  • List all MCP servers and their status
+  • Activate/deactivate MCP servers
+  • Delete MCP servers
+
+Examples:
+  $ lua mcp                          Interactive management
+  $ lua mcp list                     List all MCP servers
+  $ lua mcp activate filesystem      Activate a specific server
+  $ lua mcp deactivate api-server    Deactivate a specific server
+  $ lua mcp delete old-server        Delete a server
+`)
+        .action(mcpCommand);
     program
         .command("completion [shell]")
         .description("🎯 Generate shell completion script")

package/dist/commands/admin.js

@@ -51,7 +51,7 @@ export async function adminCommand() {
         }
         // Construct the admin dashboard URL
         // This URL authenticates with the API key and redirects to the usage page
-        const adminUrl = `https://admin.heylua.ai/validate-token/${apiKey}?redirect=/admin/usage?&agentId=${agentId}&orgId=${orgId}&hideToolBar=true`;
+        const adminUrl = `https://admin.heylua.ai/validate-token/${apiKey}?redirect=/admin/usage?&agentId=${agentId}&orgId=${orgId}`;
         // Open the URL in the default browser
         await open(adminUrl);
         writeSuccess('Lua Admin Dashboard opened in your browser');

package/dist/commands/channels.js

@@ -77,7 +77,7 @@ async function openAdminDashboard(apiKey, config) {
         throw new Error('No orgId found in lua.skill.yaml. Please ensure your configuration is valid.');
     }
     // Construct the admin dashboard URL
-    const adminUrl = `https://admin.heylua.ai/validate-token/${apiKey}?redirect=/admin/usage?&agentId=${agentId}&orgId=${orgId}&hideToolBar=true`;
+    const adminUrl = `https://admin.heylua.ai/validate-token/${apiKey}?redirect=/admin/usage?&agentId=${agentId}&orgId=${orgId}`;
     // Open the URL in the default browser
     await open(adminUrl);
     writeSuccess('✅ Lua Admin Dashboard opened in your browser');

package/dist/commands/compile.js

@@ -6,15 +6,16 @@ import fs from "fs";
 import path from "path";
 import { Project } from "ts-morph";
 import { withErrorHandling, writeProgress, writeSuccess } from "../utils/cli.js";
-import { findIndexFile, extractWebhooksMetadata, extractJobsMetadata, extractPreProcessorsMetadata, extractPostProcessorsMetadata } from '../utils/compile.js';
+import { findIndexFile, extractWebhooksMetadata, extractJobsMetadata, extractPreProcessorsMetadata, extractPostProcessorsMetadata, extractMCPServersMetadata } from '../utils/compile.js';
 import { detectTools } from '../utils/tool-detection.js';
-import { bundleTool, bundleMainIndex, extractExecuteCode, bundleWebhook, bundleJob, bundlePreProcessor, bundlePostProcessor } from '../utils/bundling.js';
+import { bundleTool, bundleMainIndex, extractToolCode, bundleWebhook, bundleJob, bundlePreProcessor, bundlePostProcessor } from '../utils/bundling.js';
 import { createDeploymentData, createLegacyDeploymentData } from '../utils/deployment.js';
 import { syncYamlWithDeployJson, syncServerSkillsWithYaml } from '../utils/skill-management.js';
 import { ensureWebhooksExistInYaml, syncServerWebhooksWithYaml } from '../utils/webhook-management.js';
 import { ensureJobsExistInYaml, syncServerJobsWithYaml } from '../utils/job-management.js';
 import { ensurePreProcessorsExistInYaml, syncServerPreProcessorsWithYaml } from '../utils/preprocessor-management.js';
 import { ensurePostProcessorsExistInYaml, syncServerPostProcessorsWithYaml } from '../utils/postprocessor-management.js';
+import { ensureMCPServersExistInYaml, syncServerMCPServersWithYaml } from '../utils/mcp-server-management.js';
 import { readSkillConfig } from '../utils/files.js';
 import { COMPILE_DIRS, COMPILE_FILES } from '../config/compile.constants.js';
 import { syncAgentPersonaWithYaml } from '../utils/agent-management.js';
@@ -95,7 +96,7 @@ export async function compileCommand(options) {
             resolvedAgentData = resolveLuaAgentReferences(agentMetadata, indexFile, project);
             // Get file paths where skills are defined so we can scan them for tools
             skillFilePaths = getSkillFilePaths(agentMetadata, indexFile);
-            writeProgress(`📦 Agent contains: ${resolvedAgentData?.skills?.length || 0} skill(s), ${resolvedAgentData?.webhooks?.length || 0} webhook(s), ${resolvedAgentData?.jobs?.length || 0} job(s), ${resolvedAgentData?.preProcessors?.length || 0} preprocessor(s), ${resolvedAgentData?.postProcessors?.length || 0} postprocessor(s)`);
+            writeProgress(`📦 Agent contains: ${resolvedAgentData?.skills?.length || 0} skill(s), ${resolvedAgentData?.webhooks?.length || 0} webhook(s), ${resolvedAgentData?.jobs?.length || 0} job(s), ${resolvedAgentData?.preProcessors?.length || 0} preprocessor(s), ${resolvedAgentData?.postProcessors?.length || 0} postprocessor(s), ${resolvedAgentData?.mcpServers?.length || 0} MCP server(s)`);
         }
         else {
             writeProgress(`ℹ️  No LuaAgent found, using legacy detection for individual components`);
@@ -132,7 +133,7 @@ export async function compileCommand(options) {
                 }
             }
             // Step 3d: Extract execute code
-            await extractExecuteCode(tool, project, distDir);
+            await extractToolCode(tool, project);
             if (debugMode) {
                 const toolTime = Date.now() - toolStartTime;
                 const bundledPath = path.join(distDir, 'tools', `${tool.className}.js`);
@@ -258,6 +259,22 @@ export async function compileCommand(options) {
             await syncServerPostProcessorsWithYaml(postprocessorConfig);
             fs.writeFileSync(path.join(distDir, 'postprocessors.json'), JSON.stringify(bundledPostProcessors, null, 2));
         }
+        // Step 12: Detect and process MCP servers
+        writeProgress("🔍 Detecting MCP servers...");
+        // Use resolved agent MCP servers if available
+        let mcpServersMetadata = resolvedAgentData?.mcpServers || extractMCPServersMetadata(indexFile);
+        if (mcpServersMetadata.length > 0) {
+            writeProgress(`📦 Found ${mcpServersMetadata.length} MCP server(s)...`);
+            // Ensure MCP servers exist in YAML
+            const configForMCP = readSkillConfig();
+            await ensureMCPServersExistInYaml(mcpServersMetadata, configForMCP);
+            // Sync server MCP servers with YAML
+            writeProgress("🔄 Syncing server MCP servers with YAML...");
+            const mcpServerConfig = readSkillConfig();
+            await syncServerMCPServersWithYaml(mcpServerConfig);
+            // Write MCP servers to file for reference
+            fs.writeFileSync(path.join(distDir, 'mcp-servers.json'), JSON.stringify(mcpServersMetadata, null, 2));
+        }
         // Build compilation summary
         const summaryParts = [`${tools.length} tools bundled`];
         if (webhooksMetadata.length > 0)
@@ -268,6 +285,8 @@ export async function compileCommand(options) {
             summaryParts.push(`${preprocessorsMetadata.length} preprocessor(s) registered`);
         if (postprocessorsMetadata.length > 0)
             summaryParts.push(`${postprocessorsMetadata.length} postprocessor(s) registered`);
+        if (mcpServersMetadata.length > 0)
+            summaryParts.push(`${mcpServersMetadata.length} MCP server(s) registered`);
         // Check for empty bundles (potential failures)
         const emptyBundles = [];
         for (const tool of tools) {

package/dist/commands/evals.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Evals Command
+ * Opens the Lua Evaluations Dashboard in the user's default browser
+ */
+/**
+ * Evals command - opens the Lua evaluations dashboard in the browser.
+ */
+export declare function evalsCommand(): Promise<void>;

package/dist/commands/evals.js

@@ -0,0 +1,41 @@
+/**
+ * Evals Command
+ * Opens the Lua Evaluations Dashboard in the user's default browser
+ */
+import open from 'open';
+import { loadApiKey } from '../services/auth.js';
+import { readSkillConfig } from '../utils/files.js';
+import { withErrorHandling, writeSuccess, writeProgress } from '../utils/cli.js';
+/**
+ * Evals command - opens the Lua evaluations dashboard in the browser.
+ */
+export async function evalsCommand() {
+    return withErrorHandling(async () => {
+        writeProgress('Opening Lua Evaluations Dashboard...');
+        // Load API key from secure storage
+        const apiKey = await loadApiKey();
+        if (!apiKey) {
+            throw new Error('No API key found. Please run "lua auth configure" first.');
+        }
+        // Read skill configuration
+        let config;
+        try {
+            config = readSkillConfig();
+        }
+        catch (error) {
+            throw new Error('Could not read lua.skill.yaml. Please ensure you are in a Lua agent directory, or run "lua init" to create a new agent.');
+        }
+        // Extract agentId from config
+        const agentId = config?.agent?.agentId;
+        if (!agentId) {
+            throw new Error('No agentId found in lua.skill.yaml. Please ensure your configuration is valid.');
+        }
+        // Construct the evals dashboard URL
+        const evalsUrl = `https://evals.heylua.ai?apiKey=${apiKey}&agentID=${agentId}`;
+        // Open the URL in the default browser
+        await open(evalsUrl);
+        writeSuccess('Lua Evaluations Dashboard opened in your browser');
+        console.log(`\n  Dashboard URL: https://evals.heylua.ai`);
+        console.log(`  Agent ID: ${agentId}\n`);
+    }, 'evals');
+}

package/dist/commands/index.d.ts

@@ -14,6 +14,7 @@ export { personaCommand } from "./persona.js";
 export { productionCommand } from "./production.js";
 export { resourcesCommand } from "./resources.js";
 export { adminCommand } from "./admin.js";
+export { evalsCommand } from "./evals.js";
 export { docsCommand } from "./docs.js";
 export { channelsCommand } from "./channels.js";
 export { logsCommand } from "./logs.js";
@@ -25,3 +26,4 @@ export { featuresCommand } from "./features.js";
 export { preprocessorsCommand } from "./preprocessors.js";
 export { postprocessorsCommand } from "./postprocessors.js";
 export { marketplaceCommand } from "./marketplace.js";
+export { mcpCommand } from "./mcp.js";

package/dist/commands/index.js

@@ -14,6 +14,7 @@ export { personaCommand } from "./persona.js";
 export { productionCommand } from "./production.js";
 export { resourcesCommand } from "./resources.js";
 export { adminCommand } from "./admin.js";
+export { evalsCommand } from "./evals.js";
 export { docsCommand } from "./docs.js";
 export { channelsCommand } from "./channels.js";
 export { logsCommand } from "./logs.js";
@@ -25,3 +26,4 @@ export { featuresCommand } from "./features.js";
 export { preprocessorsCommand } from "./preprocessors.js";
 export { postprocessorsCommand } from "./postprocessors.js";
 export { marketplaceCommand } from "./marketplace.js";
+export { mcpCommand } from "./mcp.js";

package/dist/commands/init.d.ts

@@ -2,6 +2,12 @@
  * Init Command
  * Orchestrates the initialization of a new Lua skill project
  */
+/**
+ * Options for the init command
+ */
+interface InitCommandOptions {
+    withExamples?: boolean;
+}
 /**
  * Main init command - initializes a new Lua skill project.
  *
@@ -22,7 +28,10 @@
  * - Feature configuration
  * - Automatic project scaffolding
  * - Dependency installation
+ * - Optional example code with --with-examples flag
  *
+ * @param options - Command options including --with-examples
  * @returns Promise that resolves when initialization is complete
  */
-export declare function initCommand(): Promise<void>;
+export declare function initCommand(options?: InitCommandOptions): Promise<void>;
+export {};

package/dist/commands/init.js

@@ -29,10 +29,13 @@ import { readSkillYaml, updateYamlAgent } from "../utils/files.js";
  * - Feature configuration
  * - Automatic project scaffolding
  * - Dependency installation
+ * - Optional example code with --with-examples flag
  *
+ * @param options - Command options including --with-examples
  * @returns Promise that resolves when initialization is complete
  */
-export async function initCommand() {
+export async function initCommand(options = {}) {
+    const withExamples = options.withExamples ?? false;
     return withErrorHandling(async () => {
         // Step 1: Authenticate
         const apiKey = await loadApiKey();
@@ -139,10 +142,17 @@ export async function initCommand() {
         }
         else {
             // Full project initialization
-            const currentDir = initializeProject(selectedAgent.agentId, selectedOrg.id, persona, selectedAgent.name);
+            const currentDir = initializeProject(selectedAgent.agentId, selectedOrg.id, persona, selectedAgent.name, withExamples);
             // Step 6: Install dependencies
             await installDependencies(currentDir);
-            writeSuccess("✅ Lua skill project initialized successfully!");
+            if (withExamples) {
+                writeSuccess("✅ Lua skill project initialized with examples!");
+                writeInfo("💡 Check the examples/ folder for sample skills, tools, jobs, and webhooks");
+            }
+            else {
+                writeSuccess("✅ Lua skill project initialized successfully!");
+                writeInfo("💡 Tip: Use `lua init --with-examples` to include example code");
+            }
         }
     }, "initialization");
 }

package/dist/commands/mcp.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MCP Command
+ * Manages Model Context Protocol (MCP) servers for agents
+ */
+/**
+ * Main MCP command - manages MCP servers
+ *
+ * Subcommands:
+ * - lua mcp list       - List all MCP servers
+ * - lua mcp activate   - Activate an MCP server
+ * - lua mcp deactivate - Deactivate an MCP server
+ * - lua mcp delete     - Delete an MCP server
+ *
+ * @param action - Optional action ('list', 'activate', 'deactivate', 'delete')
+ * @param serverName - Optional server name for actions
+ * @returns Promise that resolves when command completes
+ */
+export declare function mcpCommand(action?: string, serverName?: string): Promise<void>;