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

package/dist/utils/init-helpers.d.ts

@@ -14,10 +14,11 @@ export declare function getTemplateDir(): string;
  * @param agentId - Agent ID for configuration
  * @param orgId - Organization ID for configuration
  * @param persona - Optional persona configuration
- * @param welcomeMessage - Optional welcome message
+ * @param agentName - Optional agent name
+ * @param withExamples - Whether to include example skills, tools, jobs, etc. (default: false)
  * @returns Current working directory
  */
-export declare function initializeProject(agentId: string, orgId: string, persona?: string, welcomeMessage?: string, agentName?: string): string;
+export declare function initializeProject(agentId: string, orgId: string, persona?: string, agentName?: string, withExamples?: boolean): string;
 /**
  * Installs npm dependencies for the project.
  *
@@ -45,6 +46,5 @@ export declare function clearLinesIfNeeded(lineCount: number): void;
  * @param projectDir - Project directory containing src/index.ts
  * @param agentName - Name of the agent
  * @param persona - Agent persona
- * @param welcomeMessage - Welcome message
  */
-export declare function updateLuaAgentInIndexFile(projectDir: string, agentName?: string, persona?: string, welcomeMessage?: string): void;
+export declare function updateLuaAgentInIndexFile(projectDir: string, agentName?: string, persona?: string): void;

package/dist/utils/init-helpers.js

@@ -24,18 +24,22 @@ export function getTemplateDir() {
  * @param agentId - Agent ID for configuration
  * @param orgId - Organization ID for configuration
  * @param persona - Optional persona configuration
- * @param welcomeMessage - Optional welcome message
+ * @param agentName - Optional agent name
+ * @param withExamples - Whether to include example skills, tools, jobs, etc. (default: false)
  * @returns Current working directory
  */
-export function initializeProject(agentId, orgId, persona, welcomeMessage, agentName) {
+export function initializeProject(agentId, orgId, persona, agentName, withExamples = false) {
     const templateDir = getTemplateDir();
     const currentDir = process.cwd();
-    copyTemplateFiles(templateDir, currentDir);
-    createSkillYaml(agentId, orgId, undefined, undefined, persona, welcomeMessage);
+    copyTemplateFiles(templateDir, currentDir, withExamples);
+    createSkillYaml(agentId, orgId, undefined, undefined, persona);
     // Update LuaAgent in index.ts with agent configuration
-    updateLuaAgentInIndexFile(currentDir, agentName, persona, welcomeMessage);
+    updateLuaAgentInIndexFile(currentDir, agentName, persona);
     writeProgress("✅ Created lua.skill.yaml");
     writeProgress("✅ Copied template files");
+    if (withExamples) {
+        writeProgress("✅ Included example skills, tools, jobs, and webhooks");
+    }
     writeProgress("✅ Updated LuaAgent configuration");
     return currentDir;
 }
@@ -81,9 +85,8 @@ export function clearLinesIfNeeded(lineCount) {
  * @param projectDir - Project directory containing src/index.ts
  * @param agentName - Name of the agent
  * @param persona - Agent persona
- * @param welcomeMessage - Welcome message
  */
-export function updateLuaAgentInIndexFile(projectDir, agentName, persona, welcomeMessage) {
+export function updateLuaAgentInIndexFile(projectDir, agentName, persona) {
     const indexPath = path.join(projectDir, 'src', 'index.ts');
     if (!fs.existsSync(indexPath)) {
         // If no index.ts, skip (might be an old template structure)
@@ -103,10 +106,6 @@ export function updateLuaAgentInIndexFile(projectDir, agentName, persona, welcom
         if (persona) {
             content = content.replace(/(persona:\s*['"`])[\s\S]*?(['"`])/, `$1${persona.replace(/'/g, "\\'").replace(/`/g, '\\`')}$2`);
         }
-        // Update welcome message
-        if (welcomeMessage) {
-            content = content.replace(/(welcomeMessage:\s*['"])[\s\S]*?(['"])/, `$1${welcomeMessage.replace(/'/g, "\\'")}$2`);
-        }
         fs.writeFileSync(indexPath, content);
     }
     catch (error) {

package/dist/utils/job-management.js

@@ -82,7 +82,6 @@ async function createJobViaApi(job, config, existingJobs, existingJob) {
         const jobPayload = {
             name: job.name,
             description: job.description || `A Lua job for ${job.name}`,
-            context: job.context || '',
             schedule: job.schedule || { type: 'cron', expression: '0 0 * * *' },
             timeout: job.timeout,
             retry: job.retry,
@@ -96,7 +95,6 @@ async function createJobViaApi(job, config, existingJobs, existingJob) {
             if (!existingJob) {
                 existingJobs.push({
                     name: job.name || '',
-                    version: job.version || SKILL_DEFAULTS.VERSION,
                     jobId: newJobId,
                     schedule: job.schedule
                 });

package/dist/utils/mcp-server-management.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MCP Server Management Utilities
+ * Handles MCP server configuration in lua.skill.yaml
+ */
+import { YamlConfig } from '../types/compile.types.js';
+/**
+ * Ensures all detected MCP servers exist in the YAML config and database.
+ * Uses upsert to create or update servers via API during compile (like skills).
+ * YAML only tracks name and ID - the full configuration stays in source code.
+ *
+ * @param mcpServersArray - Array of MCP servers detected from source code (with full config)
+ * @param config - The skill configuration from lua.skill.yaml
+ * @returns Updated MCP servers array with IDs assigned
+ */
+export declare function ensureMCPServersExistInYaml(mcpServersArray: any[], config: YamlConfig): Promise<any[]>;
+/**
+ * Syncs the server MCP servers with the YAML configuration.
+ * Deletes MCP servers from the server that aren't in YAML (removed from source code).
+ *
+ * @param config - The skill configuration from lua.skill.yaml
+ * @returns Array of messages about sync operations
+ */
+export declare function syncServerMCPServersWithYaml(config: YamlConfig): Promise<string[]>;

package/dist/utils/mcp-server-management.js

@@ -0,0 +1,212 @@
+/**
+ * MCP Server Management Utilities
+ * Handles MCP server configuration in lua.skill.yaml
+ */
+import fs from "fs";
+import path from "path";
+import yaml from "js-yaml";
+import { COMPILE_FILES, YAML_FORMAT, } from '../config/compile.constants.js';
+import { loadApiKey } from '../services/auth.js';
+import { BASE_URLS } from '../config/constants.js';
+import DeveloperApi from '../api/developer.api.service.js';
+/**
+ * Ensures all detected MCP servers exist in the YAML config and database.
+ * Uses upsert to create or update servers via API during compile (like skills).
+ * YAML only tracks name and ID - the full configuration stays in source code.
+ *
+ * @param mcpServersArray - Array of MCP servers detected from source code (with full config)
+ * @param config - The skill configuration from lua.skill.yaml
+ * @returns Updated MCP servers array with IDs assigned
+ */
+export async function ensureMCPServersExistInYaml(mcpServersArray, config) {
+    const existingServers = config?.mcpServers || [];
+    const existingServersMap = createMCPServersMap(existingServers);
+    const updatedServersArray = [];
+    let yamlUpdated = false;
+    // Process each detected MCP server from source code
+    for (const server of mcpServersArray) {
+        const existingServer = existingServersMap.get(server.name);
+        if (existingServer && existingServer.mcpServerId && existingServer.mcpServerId !== '') {
+            // Server exists with valid ID - reuse it
+            updatedServersArray.push({
+                ...server, // Full config from source code
+                mcpServerId: existingServer.mcpServerId // ID from YAML
+            });
+        }
+        else {
+            // Server doesn't exist or missing ID - upsert via API
+            const upsertedServer = await upsertMCPServerViaApi(server, config, existingServers, existingServer);
+            updatedServersArray.push(upsertedServer);
+            yamlUpdated = true;
+        }
+    }
+    // Update YAML file with tracking info (name + ID only)
+    if (yamlUpdated) {
+        await updateYamlWithMCPServers(updatedServersArray, config);
+    }
+    return updatedServersArray;
+}
+/**
+ * Creates a map of existing MCP servers for quick lookup by name.
+ */
+function createMCPServersMap(existingServers) {
+    const map = new Map();
+    existingServers.forEach((server) => {
+        map.set(server.name, server);
+    });
+    return map;
+}
+/**
+ * Creates or updates an MCP server via the Lua API (upsert by name).
+ *
+ * @param server - The MCP server to upsert (with full config)
+ * @param config - The skill configuration
+ * @param existingServers - Array of existing servers (mutated)
+ * @param existingServer - The existing server entry if one exists (may be without ID)
+ * @returns The server with its ID
+ */
+async function upsertMCPServerViaApi(server, config, existingServers, existingServer) {
+    try {
+        // Validate prerequisites
+        const apiKey = await loadApiKey();
+        if (!apiKey) {
+            throw new Error("No API key found. Run 'lua auth configure' first.");
+        }
+        const agentId = config?.agent?.agentId;
+        if (!agentId) {
+            throw new Error("No agent ID found in lua.skill.yaml. Run 'lua init' first.");
+        }
+        // Prepare server data for upsert
+        const serverData = {
+            name: server.name,
+            transport: server.transport,
+            timeout: server.timeout,
+            ...(server.transport === 'stdio' ? {
+                command: server.command,
+                args: server.args,
+                env: server.env
+            } : {
+                url: server.url,
+                headers: server.headers
+            })
+        };
+        // Upsert server via API (creates if new, updates if exists by name)
+        const developerApi = new DeveloperApi(BASE_URLS.API, apiKey, agentId);
+        const result = await developerApi.upsertMCPServer(serverData);
+        if (!result.success || !result.data?.id) {
+            throw new Error(result.error?.message || 'Failed to upsert MCP server');
+        }
+        const mcpServerId = result.data.id;
+        // Update or add to existing servers array
+        if (existingServer) {
+            existingServer.mcpServerId = mcpServerId;
+        }
+        else {
+            existingServers.push({
+                name: server.name,
+                mcpServerId: mcpServerId
+            });
+        }
+        console.log(`  ✅ Synced MCP server "${server.name}" with ID: ${mcpServerId}`);
+        return {
+            ...server,
+            mcpServerId: mcpServerId
+        };
+    }
+    catch (error) {
+        console.error(`  ❌ Failed to sync MCP server "${server.name}":`, error.message);
+        throw error;
+    }
+}
+/**
+ * Updates the lua.skill.yaml file with MCP server tracking (name and ID only).
+ * IDs are assigned during compile via API (like skills).
+ * The full server configuration remains in the source code as the single source of truth.
+ */
+async function updateYamlWithMCPServers(mcpServers, config) {
+    const yamlPath = path.join(process.cwd(), COMPILE_FILES.LUA_SKILL_YAML);
+    // Read existing content
+    let existingConfig = {};
+    if (fs.existsSync(yamlPath)) {
+        const yamlContent = fs.readFileSync(yamlPath, 'utf8');
+        existingConfig = yaml.load(yamlContent);
+    }
+    // Update MCP servers section - only track name and ID (like skills)
+    existingConfig.mcpServers = mcpServers.map(server => ({
+        name: server.name,
+        mcpServerId: server.mcpServerId // Always present after upsert during compile
+    }));
+    // Write updated YAML
+    const yamlContent = yaml.dump(existingConfig, {
+        indent: YAML_FORMAT.INDENT,
+        lineWidth: YAML_FORMAT.LINE_WIDTH,
+        noRefs: YAML_FORMAT.NO_REFS
+    });
+    fs.writeFileSync(yamlPath, yamlContent);
+}
+/**
+ * Syncs the server MCP servers with the YAML configuration.
+ * Deletes MCP servers from the server that aren't in YAML (removed from source code).
+ *
+ * @param config - The skill configuration from lua.skill.yaml
+ * @returns Array of messages about sync operations
+ */
+export async function syncServerMCPServersWithYaml(config) {
+    const messages = [];
+    try {
+        // Validate prerequisites
+        const apiKey = await loadApiKey();
+        if (!apiKey) {
+            console.warn("⚠️  No API key found. Skipping server MCP server sync.");
+            return messages;
+        }
+        const agentId = config?.agent?.agentId;
+        if (!agentId) {
+            console.warn("⚠️  No agent ID found in lua.skill.yaml. Skipping server MCP server sync.");
+            return messages;
+        }
+        // Get MCP servers from server
+        const developerApi = new DeveloperApi(BASE_URLS.API, apiKey, agentId);
+        const serverMCPServersResponse = await developerApi.getMCPServers();
+        if (!serverMCPServersResponse.success || !serverMCPServersResponse.data) {
+            console.warn("⚠️  Could not retrieve server MCP servers. Skipping server MCP server sync.");
+            return messages;
+        }
+        const serverMCPServers = serverMCPServersResponse.data;
+        const yamlMCPServers = config?.mcpServers || [];
+        // Create map of YAML MCP servers by ID for efficient lookup
+        const yamlMCPServersMap = new Map(yamlMCPServers
+            .filter((server) => server.mcpServerId)
+            .map((server) => [server.mcpServerId, server]));
+        // Find MCP servers on server that aren't in YAML (removed from source code)
+        const serversToDelete = serverMCPServers.filter(serverMCP => !yamlMCPServersMap.has(serverMCP.id));
+        // Delete servers that are no longer in YAML
+        for (const server of serversToDelete) {
+            try {
+                const deleteResponse = await developerApi.deleteMCPServer(server.id);
+                if (deleteResponse.success) {
+                    const msg = `✅ Deleted MCP server "${server.name}" from server (removed from source code)`;
+                    messages.push(msg);
+                    console.log(msg);
+                }
+                else {
+                    const msg = `❌ Failed to delete MCP server "${server.name}": ${deleteResponse.error?.message || 'Unknown error'}`;
+                    messages.push(msg);
+                    console.error(msg);
+                }
+            }
+            catch (error) {
+                const msg = `❌ Error deleting MCP server "${server.name}": ${error}`;
+                messages.push(msg);
+                console.error(msg);
+            }
+        }
+        if (serversToDelete.length === 0) {
+            console.log("✅ Server MCP servers and YAML are fully in sync");
+        }
+    }
+    catch (error) {
+        console.error("❌ Error syncing server MCP servers:", error);
+    }
+    return messages;
+}

package/dist/utils/postprocessor-management.js

@@ -7,7 +7,7 @@ import yaml from "js-yaml";
 import PostProcessorApi from '../api/postprocessor.api.service.js';
 import { BASE_URLS } from '../config/constants.js';
 import { loadApiKey } from '../services/auth.js';
-import { SKILL_DEFAULTS, YAML_FORMAT } from '../config/compile.constants.js';
+import { YAML_FORMAT } from '../config/compile.constants.js';
 /**
  * Ensures all detected postprocessors exist in the YAML config with valid IDs.
  */
@@ -45,8 +45,7 @@ async function createPostProcessorViaApi(postprocessor, config, existingPostProc
             throw new Error("No agent ID found in lua.skill.yaml. Run 'lua init' first.");
         const payload = {
             name: postprocessor.name,
-            description: postprocessor.description || `A Lua postprocessor for ${postprocessor.name}`,
-            context: postprocessor.context || ''
+            description: postprocessor.description || `A Lua postprocessor for ${postprocessor.name}`
         };
         const api = new PostProcessorApi(BASE_URLS.API, apiKey, agentId);
         const result = await api.createPostProcessor(payload);
@@ -55,7 +54,6 @@ async function createPostProcessorViaApi(postprocessor, config, existingPostProc
             if (!existingPostProcessor) {
                 existingPostProcessors.push({
                     name: postprocessor.name || '',
-                    version: postprocessor.version || SKILL_DEFAULTS.VERSION,
                     postprocessorId: newId
                 });
             }

package/dist/utils/preprocessor-management.js

@@ -7,7 +7,7 @@ import yaml from "js-yaml";
 import PreProcessorApi from '../api/preprocessor.api.service.js';
 import { BASE_URLS } from '../config/constants.js';
 import { loadApiKey } from '../services/auth.js';
-import { SKILL_DEFAULTS, YAML_FORMAT } from '../config/compile.constants.js';
+import { YAML_FORMAT } from '../config/compile.constants.js';
 /**
  * Ensures all detected preprocessors exist in the YAML config with valid IDs.
  */
@@ -45,8 +45,7 @@ async function createPreProcessorViaApi(preprocessor, config, existingPreProcess
             throw new Error("No agent ID found in lua.skill.yaml. Run 'lua init' first.");
         const payload = {
             name: preprocessor.name,
-            description: preprocessor.description || `A Lua preprocessor for ${preprocessor.name}`,
-            context: preprocessor.context || ''
+            description: preprocessor.description || `A Lua preprocessor for ${preprocessor.name}`
         };
         const api = new PreProcessorApi(BASE_URLS.API, apiKey, agentId);
         const result = await api.createPreProcessor(payload);
@@ -55,7 +54,6 @@ async function createPreProcessorViaApi(preprocessor, config, existingPreProcess
             if (!existingPreProcessor) {
                 existingPreProcessors.push({
                     name: preprocessor.name || '',
-                    version: preprocessor.version || SKILL_DEFAULTS.VERSION,
                     preprocessorId: newId
                 });
             }

package/dist/utils/sandbox.d.ts

@@ -45,8 +45,10 @@ export declare function loadEnvironmentVariables(): Record<string, string>;
  * - Data: Custom data collections API
  * - Baskets: Shopping basket API
  * - Orders: Order management API
- * - Webhooks: Webhook management API (new)
- * - Jobs: Job scheduling API (new)
+ * - Templates: Template APIs (whatsapp)
+ * - CDN: File upload/retrieval API
+ * - Jobs: Job scheduling API
+ * - AI: AI generation API
  * - env(): Environment variable access function
  * - console, fetch, and other standard globals
  */

package/dist/utils/sandbox.js

@@ -11,6 +11,8 @@ import OrderApiService from "../api/order.api.service.js";
 import CustomDataApiService from "../api/custom.data.api.service.js";
 import WebhookApi from "../api/webhook.api.service.js";
 import JobApi from "../api/job.api.service.js";
+import WhatsAppTemplatesApiService from "../api/whatsapp-templates.api.service.js";
+import CdnApiService from "../api/cdn.api.service.js";
 import { BasketStatus } from "../interfaces/baskets.js";
 import { OrderStatus } from "../interfaces/orders.js";
 import { compressCode } from "./compile.js";
@@ -67,8 +69,10 @@ export function loadEnvironmentVariables() {
  * - Data: Custom data collections API
  * - Baskets: Shopping basket API
  * - Orders: Order management API
- * - Webhooks: Webhook management API (new)
- * - Jobs: Job scheduling API (new)
+ * - Templates: Template APIs (whatsapp)
+ * - CDN: File upload/retrieval API
+ * - Jobs: Job scheduling API
+ * - AI: AI generation API
  * - env(): Environment variable access function
  * - console, fetch, and other standard globals
  */
@@ -88,6 +92,8 @@ export function createSandbox(options) {
     const orderService = new OrderApiService(BASE_URLS.API, apiKey, agentId);
     const webhookService = new WebhookApi(BASE_URLS.API, apiKey, agentId);
     const jobService = new JobApi(BASE_URLS.API, apiKey, agentId);
+    const whatsAppTemplatesService = new WhatsAppTemplatesApiService(BASE_URLS.API, apiKey, agentId);
+    const cdnService = new CdnApiService(BASE_URLS.CDN, apiKey);
     // Override User service methods if needed
     // Example: Override the update method
     // const originalUpdate = userService.update.bind(userService);
@@ -195,6 +201,8 @@ export function createSandbox(options) {
         Headers: globalThis.Headers,
         Request: globalThis.Request,
         Response: globalThis.Response,
+        File: globalThis.File,
+        Blob: globalThis.Blob,
         FormData: polyfills.FormData,
         AbortController: polyfills.AbortController,
         TextEncoder: polyfills.TextEncoder,
@@ -224,6 +232,12 @@ export function createSandbox(options) {
         Baskets: basketsService,
         compressCode: compressCode,
         Orders: orderService,
+        // Templates API with namespaces for different template types
+        Templates: {
+            whatsapp: whatsAppTemplatesService
+        },
+        // CDN API
+        CDN: cdnService,
         // Jobs API
         Jobs: {
             create: async (config) => {
@@ -235,7 +249,6 @@ export function createSandbox(options) {
                 return await jobService.createJobInstance({
                     name: config.name + '_' + Date.now(),
                     description: config.description,
-                    context: config.description || '',
                     schedule: config.schedule,
                     timeout: config.timeout,
                     retry: config.retry,
@@ -244,7 +257,6 @@ export function createSandbox(options) {
                     version: {
                         version: '1.0.0',
                         description: config.description,
-                        context: config.description || '',
                         code: '',
                         executeFunction: executeString,
                         timeout: config.timeout,
@@ -254,7 +266,8 @@ export function createSandbox(options) {
                     activate: config.activate ?? true
                 });
             },
-            get: async (jobId) => jobService.getJob(jobId)
+            getJob: async (jobId) => jobService.getJob(jobId),
+            getAll: async (options = {}) => jobService.getAll(options)
         },
         // Environment variables function
         env: (key) => envVars[key],
@@ -323,6 +336,8 @@ try{
       global.Response = Response;
       global.URL = URL;
       global.URLSearchParams = URLSearchParams;
+      global.File = File;
+      global.Blob = Blob;
     }
   `, context);
     vm.runInContext(commonJsWrapper, context);
@@ -345,9 +360,9 @@ export async function executeWebhook(options) {
 const executeFunction = ${webhookCode};
 
 // Export the function for testing
-module.exports = async (query, headers, body) => {
+module.exports = async (event) => {
 try{
-  return await executeFunction(query, headers, body);
+  return await executeFunction(event);
 }catch(e){
   console.error(e);
   return { status: 'error', error: e.message };
@@ -370,12 +385,20 @@ try{
       global.Response = Response;
       global.URL = URL;
       global.URLSearchParams = URLSearchParams;
+      global.File = File;
+      global.Blob = Blob;
     }
   `, context);
     vm.runInContext(commonJsWrapper, context);
-    // Get the exported function and execute with webhook input structure
+    // Get the exported function and execute with unified event object
     const executeFunction = context.module.exports;
-    return await executeFunction({ query, headers, body });
+    const event = {
+        query: query ?? {},
+        headers: headers ?? {},
+        body,
+        timestamp: new Date().toISOString()
+    };
+    return await executeFunction(event);
 }
 /**
  * Executes a job in a sandboxed environment.
@@ -439,6 +462,8 @@ try{
       global.Response = Response;
       global.URL = URL;
       global.URLSearchParams = URLSearchParams;
+      global.File = File;
+      global.Blob = Blob;
     }
   `, context);
     vm.runInContext(commonJsWrapper, context);
@@ -491,6 +516,8 @@ try{
       global.Response = Response;
       global.URL = URL;
       global.URLSearchParams = URLSearchParams;
+      global.File = File;
+      global.Blob = Blob;
     }
   `, context);
     vm.runInContext(commonJsWrapper, context);
@@ -543,6 +570,8 @@ try{
       global.Response = Response;
       global.URL = URL;
       global.URLSearchParams = URLSearchParams;
+      global.File = File;
+      global.Blob = Blob;
     }
   `, context);
     vm.runInContext(commonJsWrapper, context);

package/dist/utils/webhook-management.js

@@ -81,8 +81,7 @@ async function createWebhookViaApi(webhook, config, existingWebhooks, existingWe
         // Create webhook via API
         const webhookPayload = {
             name: webhook.name,
-            description: webhook.description || `A Lua webhook for ${webhook.name}`,
-            context: webhook.context || ''
+            description: webhook.description || `A Lua webhook for ${webhook.name}`
         };
         const webhookApi = new WebhookApi(BASE_URLS.API, apiKey, agentId);
         const result = await webhookApi.createWebhook(webhookPayload);
@@ -92,7 +91,6 @@ async function createWebhookViaApi(webhook, config, existingWebhooks, existingWe
             if (!existingWebhook) {
                 existingWebhooks.push({
                     name: webhook.name || '',
-                    version: webhook.version || SKILL_DEFAULTS.VERSION,
                     webhookId: newWebhookId
                 });
             }