lua-cli 3.0.0-alpha.10 → 3.0.0-alpha.12

package/dist/api/chat.api.service.js

@@ -40,35 +40,40 @@ export default class ChatApi extends HttpClient {
         if (!response.ok) {
             throw new Error(`HTTP error! status: ${response.status}`);
         }
-        const reader = response.body?.getReader();
-        if (!reader) {
+        if (!response.body) {
             throw new Error('Response body is not readable');
         }
+        const reader = response.body.getReader();
         const decoder = new TextDecoder();
         let buffer = '';
-        while (true) {
-            const { done, value } = await reader.read();
-            if (done)
-                break;
-            // Decode the chunk and add to buffer
-            buffer += decoder.decode(value, { stream: true });
-            // Process complete lines (chunks are separated by newlines)
-            const lines = buffer.split('\n');
-            buffer = lines.pop() || ''; // Keep incomplete line in buffer
-            for (const line of lines) {
-                if (!line.trim())
-                    continue;
-                try {
-                    const chunk = JSON.parse(line);
-                    // Only process text-delta chunks
-                    if (chunk.type === 'text-delta' && chunk.textDelta) {
-                        onChunk(chunk.textDelta);
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                // Decode the chunk and add to buffer
+                buffer += decoder.decode(value, { stream: true });
+                // Process complete lines (chunks are separated by newlines)
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || ''; // Keep incomplete line in buffer
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    try {
+                        const chunk = JSON.parse(line);
+                        // Only process text-delta chunks and call onChunk immediately
+                        if (chunk.type === 'text-delta' && chunk.textDelta) {
+                            onChunk(chunk.textDelta);
+                        }
+                    }
+                    catch (error) {
+                        // Skip invalid JSON lines
                     }
-                }
-                catch (error) {
-                    // Skip invalid JSON lines
                 }
             }
         }
+        finally {
+            reader.releaseLock();
+        }
     }
 }

package/dist/api-exports.d.ts

@@ -402,5 +402,5 @@ export declare const AI: {
     generate(context: string, messages: import("./interfaces/chat.js").ChatMessage[], agentId?: string): Promise<string>;
 };
 export { LuaSkill, LuaTool, LuaWebhook, LuaWebhookConfig, LuaJob, LuaJobConfig, JobSchedule, PreProcessor, PreProcessorConfig, PostProcessor, PostProcessorConfig, LuaAgent, LuaAgentConfig, BasketStatus, OrderStatus, env };
-export { JobInstance };
+export { JobInstance, UserDataInstance, DataEntryInstance, ProductInstance, BasketInstance, OrderInstance };
 export { ChatHistoryMessage, ChatHistoryContent, ChatMessage, TextMessage, ImageMessage, FileMessage, PreProcessorOverride, PostProcessorOverride };

package/dist/api-exports.js

@@ -31,6 +31,11 @@ import { BasketStatus } from "./interfaces/baskets.js";
 import { OrderStatus } from "./interfaces/orders.js";
 import { getUserInstance, getDataInstance, getProductsInstance, getBasketsInstance, getOrderInstance, getJobInstance, getChatInstance, } 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";
+import UserDataInstance from "./common/user.instance.js";
+import BasketInstance from "./common/basket.instance.js";
+import OrderInstance from "./common/order.instance.js";
 export const User = {
     /**
      * Retrieves current user data.
@@ -543,4 +548,4 @@ export const AI = {
 // Export skill classes and utilities
 export { LuaSkill, LuaWebhook, LuaJob, PreProcessor, PostProcessor, LuaAgent, BasketStatus, OrderStatus, env };
 // Export instance classes
-export { JobInstance };
+export { JobInstance, UserDataInstance, DataEntryInstance, ProductInstance, BasketInstance, OrderInstance };

package/dist/commands/chat.js

@@ -148,22 +148,41 @@ async function startChatLoop(chatEnv) {
             rl.prompt();
             return;
         }
+        // Start typing indicator
+        const typingInterval = startTypingIndicator();
+        let firstChunk = true;
         try {
-            // Start showing the assistant response
-            process.stdout.write('🌙 Assistant: ');
-            let fullResponse = '';
+            // Create a callback that stops typing on first chunk
+            const handleChunk = (chunk) => {
+                if (firstChunk) {
+                    // Stop typing indicator and show assistant label
+                    stopTypingIndicator(typingInterval);
+                    process.stdout.write('🌙 Assistant: ');
+                    firstChunk = false;
+                }
+                // Write the chunk immediately
+                process.stdout.write(chunk);
+            };
             if (chatEnv.type === 'sandbox') {
                 // Send to sandbox with skill overrides (streaming)
-                fullResponse = await sendSandboxMessageStream(chatEnv, message);
+                await sendSandboxMessageStream(chatEnv, message, handleChunk);
             }
             else {
                 // Send to production (streaming)
-                fullResponse = await sendProductionMessageStream(chatEnv, message);
+                await sendProductionMessageStream(chatEnv, message, handleChunk);
+            }
+            // If no chunks arrived, stop the typing indicator
+            if (firstChunk) {
+                stopTypingIndicator(typingInterval);
             }
             // Add newline after response
             console.log('\n');
         }
         catch (error) {
+            // Make sure typing indicator is stopped on error
+            if (firstChunk) {
+                stopTypingIndicator(typingInterval);
+            }
             console.error(`\n❌ Error: ${error instanceof Error ? error.message : 'Unknown error'}\n`);
         }
         rl.prompt();
@@ -200,14 +219,14 @@ function stopTypingIndicator(interval) {
 /**
  * Sends a message to the sandbox environment with skill overrides (streaming)
  */
-async function sendSandboxMessageStream(chatEnv, message) {
+async function sendSandboxMessageStream(chatEnv, message, onChunk) {
     if (!chatEnv.deployData) {
-        return "❌ Sandbox environment not properly initialized.";
+        throw new Error("Sandbox environment not properly initialized.");
     }
     // Get all sandbox skill IDs for skill override
     const allSkillOverrides = await getAllSandboxSkillIds(chatEnv.deployData);
     if (allSkillOverrides.length === 0) {
-        return "❌ No sandbox skills found. Please try running the command again.";
+        throw new Error("No sandbox skills found. Please try running the command again.");
     }
     const chatRequest = {
         messages: [
@@ -226,24 +245,12 @@ async function sendSandboxMessageStream(chatEnv, message) {
         chatRequest.personaOverride = chatEnv.persona;
     }
     const chatApi = new ChatApi(BASE_URLS.CHAT, chatEnv.apiKey);
-    let fullResponse = '';
-    try {
-        await chatApi.sendMessageStream(chatEnv.agentId, chatRequest, (chunk) => {
-            // Write each chunk to stdout as it arrives
-            process.stdout.write(chunk);
-            fullResponse += chunk;
-        });
-        return fullResponse;
-    }
-    catch (error) {
-        console.error(`\n❌ Chat API error: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        return '';
-    }
+    await chatApi.sendMessageStream(chatEnv.agentId, chatRequest, onChunk);
 }
 /**
  * Sends a message to the production environment (streaming)
  */
-async function sendProductionMessageStream(chatEnv, message) {
+async function sendProductionMessageStream(chatEnv, message, onChunk) {
     const chatRequest = {
         messages: [
             {
@@ -257,17 +264,5 @@ async function sendProductionMessageStream(chatEnv, message) {
         postprocessorOverride: []
     };
     const chatApi = new ChatApi(BASE_URLS.CHAT, chatEnv.apiKey);
-    let fullResponse = '';
-    try {
-        await chatApi.sendMessageStream(chatEnv.agentId, chatRequest, (chunk) => {
-            // Write each chunk to stdout as it arrives
-            process.stdout.write(chunk);
-            fullResponse += chunk;
-        });
-        return fullResponse;
-    }
-    catch (error) {
-        console.error(`\n❌ Chat API error: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        return '';
-    }
+    await chatApi.sendMessageStream(chatEnv.agentId, chatRequest, onChunk);
 }

package/dist/commands/init.js

@@ -127,14 +127,18 @@ export async function initCommand() {
         }
         // Step 5: Initialize or update project
         if (yamlExists) {
-            // Update existing YAML only
+            // Update existing YAML and LuaAgent in index.ts
             writeInfo("📝 Updating existing lua.skill.yaml with new agent...");
             updateYamlAgent(selectedAgent.agentId, selectedOrg.id, persona, welcomeMessage);
+            // Also update LuaAgent in index.ts if it exists
+            const { updateLuaAgentInIndexFile } = await import("../utils/init-helpers.js");
+            updateLuaAgentInIndexFile(process.cwd(), selectedAgent.name, persona, welcomeMessage);
             writeSuccess("✅ lua.skill.yaml updated successfully!");
+            writeSuccess("✅ LuaAgent configuration updated!");
         }
         else {
             // Full project initialization
-            const currentDir = initializeProject(selectedAgent.agentId, selectedOrg.id, persona, welcomeMessage);
+            const currentDir = initializeProject(selectedAgent.agentId, selectedOrg.id, persona, welcomeMessage, selectedAgent.name);
             // Step 6: Install dependencies
             await installDependencies(currentDir);
             writeSuccess("✅ Lua skill project initialized successfully!");
@@ -290,7 +294,11 @@ async function handleAgentSwitch(userData, apiKey, existingYaml) {
     // Update existing YAML file with new agent
     writeInfo("\n📝 Updating lua.skill.yaml with new agent...");
     updateYamlAgent(selectedAgent.agentId, selectedOrg.id, finalPersona, finalWelcomeMessage);
+    // Also update LuaAgent in index.ts if it exists
+    const { updateLuaAgentInIndexFile } = await import("../utils/init-helpers.js");
+    updateLuaAgentInIndexFile(process.cwd(), selectedAgent.name, finalPersona, finalWelcomeMessage);
     writeSuccess("✅ lua.skill.yaml updated successfully!");
+    writeSuccess("✅ LuaAgent configuration updated!");
     writeInfo("\n💡 Your project now uses the new agent. Run 'lua compile' to update your skills.\n");
 }
 /**

package/dist/index.js

@@ -16,10 +16,10 @@ const program = new Command();
 program
     .name("lua")
     .description("Lua AI - Build and deploy AI agents with superpowers")
-    .version("2.4.1")
+    .version("2.5.8")
     .addHelpText('before', `
 ------------------------------------------------------------------
-  Lua AI CLI v2.4.1 - Build and deploy AI agents with superpowers
+  Lua AI CLI v2.5.8 - Build and deploy AI agents with superpowers
 ------------------------------------------------------------------
 `)
     .addHelpText('after', `

package/dist/interfaces/message.d.ts

@@ -5,12 +5,12 @@ export type TextMessage = {
 export type ImageMessage = {
     type: "image";
     image: string;
-    mimeType: string;
+    mediaType: string;
 };
 export type FileMessage = {
     type: "file";
     data: string;
-    mimeType: string;
+    mediaType: string;
 };
 export type Message = TextMessage | ImageMessage | FileMessage;
 export interface SendMessageRequest {

package/dist/utils/agent-management.d.ts

@@ -3,7 +3,7 @@
  * Handles LuaAgent persona and welcome message synchronization with lua.skill.yaml
  */
 /**
- * Syncs the agent's persona and welcome message with lua.skill.yaml.
+ * Syncs the agent's name, persona, and welcome message with lua.skill.yaml.
  * This ensures the YAML configuration reflects the agent definition in code.
  *
  * @param agentMetadata - Agent metadata extracted from LuaAgent

package/dist/utils/agent-management.js

@@ -7,7 +7,7 @@ import path from "path";
 import yaml from "js-yaml";
 import { COMPILE_FILES, YAML_FORMAT } from '../config/compile.constants.js';
 /**
- * Syncs the agent's persona and welcome message with lua.skill.yaml.
+ * Syncs the agent's name, persona, and welcome message with lua.skill.yaml.
  * This ensures the YAML configuration reflects the agent definition in code.
  *
  * @param agentMetadata - Agent metadata extracted from LuaAgent
@@ -20,12 +20,14 @@ export async function syncAgentPersonaWithYaml(agentMetadata) {
         const yamlContent = fs.readFileSync(yamlPath, 'utf8');
         config = yaml.load(yamlContent);
     }
-    // Update agent section with persona and welcome message
+    // Update agent section with name, persona, and welcome message
     config.agent = {
         ...config.agent,
         persona: agentMetadata.persona,
         welcomeMessage: agentMetadata.welcomeMessage
     };
+    // Store agent name as a comment or in metadata (YAML doesn't have an agentName field)
+    // The agent name is primarily for the LuaAgent in code
     // Write updated YAML with consistent formatting
     const yamlContent = yaml.dump(config, {
         indent: YAML_FORMAT.INDENT,
@@ -37,7 +39,7 @@ export async function syncAgentPersonaWithYaml(agentMetadata) {
         }
     });
     fs.writeFileSync(yamlPath, yamlContent);
-    console.log(`✅ Synced agent persona to lua.skill.yaml`);
+    console.log(`✅ Synced agent configuration to lua.skill.yaml`);
 }
 /**
  * Reads the agent persona from lua.skill.yaml.

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

@@ -17,7 +17,7 @@ export declare function getTemplateDir(): string;
  * @param welcomeMessage - Optional welcome message
  * @returns Current working directory
  */
-export declare function initializeProject(agentId: string, orgId: string, persona?: string, welcomeMessage?: string): string;
+export declare function initializeProject(agentId: string, orgId: string, persona?: string, welcomeMessage?: string, agentName?: string): string;
 /**
  * Installs npm dependencies for the project.
  *
@@ -39,3 +39,12 @@ export declare function calculatePromptLines(baseCount: number, additionalLines:
  * @param lineCount - Number of lines to clear
  */
 export declare function clearLinesIfNeeded(lineCount: number): void;
+/**
+ * Updates the LuaAgent configuration in the template's index.ts file
+ *
+ * @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;

package/dist/utils/init-helpers.js

@@ -4,6 +4,7 @@
  */
 import { fileURLToPath } from "url";
 import path from "path";
+import fs from "fs";
 import { copyTemplateFiles, createSkillYaml } from "./files.js";
 import { clearPromptLines, writeProgress } from "./cli.js";
 import { execSync } from 'child_process';
@@ -26,13 +27,16 @@ export function getTemplateDir() {
  * @param welcomeMessage - Optional welcome message
  * @returns Current working directory
  */
-export function initializeProject(agentId, orgId, persona, welcomeMessage) {
+export function initializeProject(agentId, orgId, persona, welcomeMessage, agentName) {
     const templateDir = getTemplateDir();
     const currentDir = process.cwd();
     copyTemplateFiles(templateDir, currentDir);
     createSkillYaml(agentId, orgId, undefined, undefined, persona, welcomeMessage);
+    // Update LuaAgent in index.ts with agent configuration
+    updateLuaAgentInIndexFile(currentDir, agentName, persona, welcomeMessage);
     writeProgress("✅ Created lua.skill.yaml");
     writeProgress("✅ Copied template files");
+    writeProgress("✅ Updated LuaAgent configuration");
     return currentDir;
 }
 /**
@@ -71,3 +75,42 @@ export function clearLinesIfNeeded(lineCount) {
         clearPromptLines(lineCount);
     }
 }
+/**
+ * Updates the LuaAgent configuration in the template's index.ts file
+ *
+ * @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) {
+    const indexPath = path.join(projectDir, 'src', 'index.ts');
+    if (!fs.existsSync(indexPath)) {
+        // If no index.ts, skip (might be an old template structure)
+        return;
+    }
+    try {
+        let content = fs.readFileSync(indexPath, 'utf8');
+        // Check if LuaAgent exists in the file
+        if (!content.includes('new LuaAgent(')) {
+            return; // No LuaAgent to update
+        }
+        // Update agent name
+        if (agentName) {
+            content = content.replace(/name:\s*['"][^'"]*['"]/, `name: '${agentName.replace(/'/g, "\\'")}'`);
+        }
+        // Update persona
+        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) {
+        // Silently fail - not critical
+        console.warn('Warning: Could not update LuaAgent in index.ts');
+    }
+}

package/dist/utils/pre-bundle-jobs.js

@@ -40,7 +40,7 @@ export async function preBundleJobsInSource(sourceFilePath, project, distDir) {
                 if (object.getText() === 'Jobs' && property === 'create') {
                     jobIndex++;
                     const placeholder = `${JOB_PLACEHOLDER}_${jobIndex}`;
-                    console.log(`[PreBundleJobs] Found Jobs.create() #${jobIndex}`);
+                    // console.log(`[PreBundleJobs] Found Jobs.create() #${jobIndex}`);
                     // Get the config object argument
                     const args = node.getArguments();
                     if (args.length > 0 && Node.isObjectLiteralExpression(args[0])) {
@@ -51,12 +51,12 @@ export async function preBundleJobsInSource(sourceFilePath, project, distDir) {
                             const executeInitializer = executeProperty.getInitializer();
                             if (executeInitializer) {
                                 const executeCode = executeInitializer.getText();
-                                console.log(`[PreBundleJobs] Extracting execute function for bundling...`);
+                                // console.log(`[PreBundleJobs] Extracting execute function for bundling...`);
                                 // Bundle the execute function with dependencies (async)
                                 const bundlePromise = bundleJobExecuteFunction(executeCode, `job_${jobIndex}`, distDir, sourceFilePath).then(bundledCode => {
                                     if (bundledCode) {
                                         jobBundles.set(placeholder, bundledCode);
-                                        console.log(`[PreBundleJobs] ✅ Bundled job #${jobIndex} with dependencies`);
+                                        // console.log(`[PreBundleJobs] ✅ Bundled job #${jobIndex} with dependencies`);
                                     }
                                 });
                                 bundlingPromises.push(bundlePromise);
@@ -74,9 +74,9 @@ export async function preBundleJobsInSource(sourceFilePath, project, distDir) {
     });
     // Wait for all bundling to complete
     if (bundlingPromises.length > 0) {
-        console.log(`[PreBundleJobs] Waiting for ${bundlingPromises.length} job(s) to bundle...`);
+        // console.log(`[PreBundleJobs] Waiting for ${bundlingPromises.length} job(s) to bundle...`);
         await Promise.all(bundlingPromises);
-        console.log(`[PreBundleJobs] ✅ All job bundles complete`);
+        // console.log(`[PreBundleJobs] ✅ All job bundles complete`);
     }
     return { modifiedSource, jobBundles };
 }
@@ -103,7 +103,7 @@ async function bundleJobExecuteFunction(executeCode, jobName, distDir, sourceFil
             !imp.includes('api-exports') && // Exclude api-exports
             !imp.includes('../../../dist/api-exports') // Exclude direct api-exports imports
         );
-        console.log(`[PreBundleJobs] Including ${relevantImports.length} import(s) in job bundle`);
+        // console.log(`[PreBundleJobs] Including ${relevantImports.length} import(s) in job bundle`);
         // Create a TypeScript module with the execute function and all imports
         const moduleCode = `
 // Auto-generated job execute bundle
@@ -133,7 +133,7 @@ export default executeFunc;
         });
         // Read bundled code
         const bundledCode = fs.readFileSync(tempOutput, 'utf8');
-        console.log(`[PreBundleJobs] Bundle size: ${(bundledCode.length / 1024).toFixed(2)}KB`);
+        // console.log(`[PreBundleJobs] Bundle size: ${(bundledCode.length / 1024).toFixed(2)}KB`);
         // DON'T compress - just wrap for VM execution
         // Compression happens later when the entire tool is bundled
         const wrappedCode = `(async (job) => {
@@ -150,7 +150,7 @@ export default executeFunc;
         return wrappedCode;
     }
     catch (error) {
-        console.warn(`[PreBundleJobs] Error bundling job ${jobName}:`, error);
+        // console.warn(`[PreBundleJobs] Error bundling job ${jobName}:`, error);
         try {
             if (fs.existsSync(tempOutput))
                 fs.unlinkSync(tempOutput);
@@ -170,7 +170,7 @@ export function replaceJobPlaceholders(bundledCode, jobBundles) {
         // It appears as: execute: __BUNDLED_JOB_EXECUTE___1
         const placeholderPattern = new RegExp(placeholder, 'g');
         result = result.replace(placeholderPattern, bundledJobCode);
-        console.log(`[PreBundleJobs] ✅ Replaced ${placeholder} with bundled code (${(bundledJobCode.length / 1024).toFixed(1)}KB)`);
+        // console.log(`[PreBundleJobs] ✅ Replaced ${placeholder} with bundled code (${(bundledJobCode.length / 1024).toFixed(1)}KB)`);
     });
     return result;
 }

package/dist/utils/sandbox.js

@@ -231,10 +231,9 @@ export function createSandbox(options) {
                 const executeString = typeof config.execute === 'function'
                     ? config.execute.toString()
                     : config.execute;
-                console.log('IsDynamicJob', config.dynamic);
                 // Create job with version and activation
                 return await jobService.createJobInstance({
-                    name: config.name,
+                    name: config.name + '_' + Date.now(),
                     description: config.description,
                     context: config.description || '',
                     schedule: config.schedule,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lua-cli",
-  "version": "3.0.0-alpha.10",
+  "version": "3.0.0-alpha.12",
   "description": "Command-line interface for Lua AI platform - develop, test, and deploy LuaSkills with custom tools",
   "readmeFilename": "README.md",
   "main": "dist/api-exports.js",
@@ -72,7 +72,7 @@
     "inquirer": "^12.9.6",
     "js-yaml": "^4.1.0",
     "keytar": "^7.9.0",
-    "lua-ai-chat": "^0.0.4",
+    "lua-ai-chat": "^0.0.6",
     "lua-cli": "^2.3.0-alpha.1",
     "luaniverse": "^4.0.43",
     "node-fetch": "^3.3.2",

package/template/src/index.ts

@@ -1,260 +1,33 @@
-import { LuaSkill, User, Products, Orders, Data, Baskets, LuaJob, JobInstance, LuaWebhook, Jobs } from "lua-cli";
-import GetWeatherTool from "./tools/GetWeatherTool";
-import { GetUserDataTool, UpdateUserDataTool } from "./tools/UserDataTool";
-import CreatePostTool from "./tools/CreatePostTool";
-import { SearchProductsTool, CreateProductTool, UpdateProductTool, GetAllProductsTool, GetProductByIdTool, DeleteProductTool } from "./tools/ProductsTool";
-import CreatePaymentLinkTool from "./tools/PaymentTool";
-import { CreateBasketTool, GetBasketsTool, AddItemToBasketTool, RemoveItemFromBasketTool, ClearBasketTool, UpdateBasketStatusTool, UpdateBasketMetadataTool, CheckoutBasketTool, GetBasketByIdTool } from "./tools/BasketTool";
-import { CreateOrderTool, UpdateOrderStatusTool, GetOrderByIdTool, GetUserOrdersTool } from "./tools/OrderTool";
-import { CreateMovieTool, GetMoviesTool, GetMovieByIdTool, UpdateMovieTool, SearchMoviesTool, DeleteMovieTool } from "./tools/CustomDataTool";
-import CreateInlineJobTool from "./tools/CreateInlineJob";
-import { v4 } from 'uuid';
-
-// ============================================================================
-// WEBHOOK EXAMPLES (Uncomment to enable)
-// ============================================================================
-// Webhooks receive HTTP requests from external systems
-// See: WEBHOOK_JOB_EXAMPLES.md for detailed explanations
-
-// import userEventWebhook from "./webhooks/UserEventWebhook";
-// import paymentWebhook from "./webhooks/PaymentWebhook";
-
-// ============================================================================
-// JOB EXAMPLES (Uncomment to enable)
-// ============================================================================
-// Jobs are scheduled tasks that run at specific times or intervals
-// See: WEBHOOK_JOB_EXAMPLES.md for detailed explanations
-
-import dailyCleanupJob from "./jobs/DailyCleanupJob";
-// import healthCheckJob from "./jobs/HealthCheckJob";
-// import dataMigrationJob from "./jobs/DataMigrationJob";
-// import abandonedBasketProcessorJob from "./jobs/AbandonedBasketProcessorJob";
-
-// ============================================================================
-// SMART BASKET TOOL (Uncomment to enable)
-// ============================================================================
-// This tool creates baskets with automatic abandoned cart reminders
-// Uses Jobs.create() to schedule one-time check 3 hours after creation
-
-// import { CreateSmartBasketTool, CheckAbandonedBasketsTool } from "./tools/SmartBasketTool";
-
-// ============================================================================
-// GAME SCORE TRACKER (Uncomment to enable) - ADVANCED EXAMPLE
-// ============================================================================
-// Complex example showing:
-// - Interval jobs that start at specific time
-// - Jobs that stop themselves when condition is met
-// - Real-time monitoring with external API integration
-// See: COMPLEX_JOB_EXAMPLES.md for detailed explanation
-
-// import { TrackGameScoresTool, GetGameScoresTool, StopGameTrackingTool } from "./tools/GameScoreTrackerTool";
-
-
-// Initialize skill with tools
-const generalSkill = new LuaSkill({
-    name: "general-skill",
-    version: "0.0.2",
-    description: "A comprehensive Lua skill with weather, user data, post creation, and mathematical tools",
-    context: "This skill provides various utilities including weather information, user data retrieval, post creation, basic calculator operations, and advanced mathematical functions. Use get_weather to fetch current weather conditions for any city, get_user_data to retrieve user information, create_post to publish new posts, calculator for basic arithmetic operations, and advanced_math for complex mathematical computations like factorials, prime checking, fibonacci sequences, and greatest common divisor calculations.",
-    tools: [
-        new GetWeatherTool(),
-        new CreatePostTool(),
-        new CreateInlineJobTool()
-    ]
-});
-
-const userDataSkill = new LuaSkill({
-    name: "user-data-skill",
-    version: "0.0.1",
-    description: "A specific Lua skill with user data",
-    context: "This skill provides various utilities including user data retrieval, creation, and updating.",
-    tools: [
-        new GetUserDataTool(),
-        new UpdateUserDataTool()
-    ]
-});
-
-
-const productSkill = new LuaSkill({
-    name: "product-skill",
-    version: "0.0.1",
-    description: "A specific Lua skill with products",
-    context: "This skill provides various utilities including products.",
-    tools: [
-        new SearchProductsTool(),
-        new GetAllProductsTool(),
-        new CreateProductTool(),
-        new UpdateProductTool(),
-        new GetProductByIdTool(),
-        new DeleteProductTool()
-    ]
-});
-
-
-const basketSkill = new LuaSkill({
-    name: "basket-skill",
-    version: "0.0.1",
-    description: "A specific Lua skill with baskets",
-    context: "This skill provides various utilities including baskets.",
-    tools: [
-        new CreateBasketTool(),
-        new GetBasketsTool(),
-        new AddItemToBasketTool(),
-        new RemoveItemFromBasketTool(),
-        new ClearBasketTool(),
-        new UpdateBasketStatusTool(),
-        new UpdateBasketMetadataTool(),
-        new CheckoutBasketTool(),
-        new GetBasketByIdTool()
-    ]
-});
-
-
-const orderSkill = new LuaSkill({
-    name: "order-skill",
-    version: "0.0.1",
-    description: "A specific Lua skill with orders",
-    context: "This skill provides various utilities including orders.",
-    tools: [
-        new CreateOrderTool(),
-        new UpdateOrderStatusTool(),
-        new GetOrderByIdTool(),
-        new GetUserOrdersTool()
-    ]
+import { LuaAgent, LuaSkill, User, Products, Orders, Data, Baskets, LuaJob, JobInstance, LuaWebhook, Jobs } from "lua-cli";
+import userSkill from "./skills/user.skill";
+import productSkill from "./skills/product.skill";
+import basketSkill from "./skills/basket.skill";
+import userEventWebhook from "./webhooks/UserEventWebhook";
+import healthCheckJob from "./jobs/HealthCheckJob";
+import messageMatchingPreProcessor from "./preprocessors/messageMatching";
+import modifyResponsePostProcessor from "./postprocessors/modifyResponse";
+
+const agent = new LuaAgent({
+    name: "my-agent",
+    persona: `Meet Vivienne Spark, the energetic and fun assistant at CLI V3 Test, a dynamic retail presence in the clothing and bookstore sector. Vivienne embodies the lively spirit of the brand, bursting with enthusiasm and a zest for life. Her role as a retail agent is not just about assisting but about transforming shopping into an exciting experience. The brand's personality is vibrant and playful, resonating with a young and adventurous clientele who thrives on creativity and innovation.
+    
+    Vivienne thrives on curiosity and optimism, forever ready to brighten a customer's day with her infectious positivity. She communicates with a warmth that makes shopping feel personal and enjoyable, speaking with a friendly, down-to-earth tone that invites discussion. Customers ranging from fashionable teenagers to busy young professionals look to Vivienne for her fresh, lively insight on the latest trends and must-have reads.
+    
+    Her sales approach is consultative and engaging, effortlessly guiding customers through options with confident yet non-intrusive recommendations. Vivienne excels at upselling in a way that feels helpful, pointing out complementary items that align with her customers' tastes and needs. She creates a seamless, personalized shopping experience that feels more like a spirited adventure than a transaction.
+    
+    The environment she fosters is informal and approachable, with a focus on efficiency while maintaining a welcoming and entertaining communication style. With Vivienne's help, every visit to CLI V3 Test is transformed into a vibrant journey of discovery and delight.`,
+    welcomeMessage: "Hello! How can I help you today?",
+    skills: [ userSkill, productSkill, basketSkill ],
+    webhooks: [ userEventWebhook ],
+    jobs: [ healthCheckJob ],
+    preProcessors: [ messageMatchingPreProcessor ],
+    postProcessors: [ modifyResponsePostProcessor ]
 });
 
-const customDataSkill = new LuaSkill({
-    name: "custom-data-skill",
-    version: "0.0.1",
-    description: "A specific Lua skill with custom data",
-    context: "This skill provides various utilities including custom data.",
-    tools: [
-        new CreateMovieTool(),
-        new GetMoviesTool(),
-        new GetMovieByIdTool(),
-        new UpdateMovieTool(),
-        new SearchMoviesTool(),
-        new DeleteMovieTool()
-    ]
-});
-
-const paymentSkill = new LuaSkill({
-    name: "payment-skill",
-    version: "0.0.1",
-    description: "A specific Lua skill with payments",
-    context: "This skill provides various utilities including payments.",
-    tools: [
-        new CreatePaymentLinkTool()
-    ]
-});
-
-// Test cases
-const testCases = [
-    { tool: "get_weather", city: "London" },
-    { tool: "get_user_data", userId: "user123" },
-    { tool: "create_post", title: "Test Post", content: "This is a test post content" },
-    { tool: "calculator", operation: "add", a: 5, b: 3 },
-    { tool: "advanced_math", operation: "factorial", numbers: [5] },
-    { tool: "advanced_math", operation: "is_prime", numbers: [17] },
-    { tool: "advanced_math", operation: "fibonacci", numbers: [10] },
-    { tool: "advanced_math", operation: "gcd", numbers: [48, 18] },
-    // This should fail - wrong property name
-    { tool: "get_weather", cityLong: "London", apiKey: "123" }
-];
-
-const job = new LuaJob({
-    description: "Test job",
-    context: "Test job context",
-    name: "test-job",
-    schedule: {
-        type: "once",
-        executeAt: new Date(Date.now() + 1000).toISOString()
-    },
-    metadata: {
-        test: "test"
-    },
-    execute: async (job: JobInstance) => {
-        console.log("Job executed");
-        return { success: true, message: "Job executed successfully" };
-    }
-});
-
-//create webhook
-const webhook = new LuaWebhook({
-    description: "Test webhook",
-    context: "Test webhook context",
-    name: "test-webhook",
-    execute: async (query: any, headers: any, body: any) => {
-        console.log("Webhook executed");
-        return { success: true, message: "Webhook executed successfully" };
-    }
-});
-
-const newJob = new LuaJob({
-    description: "Test job",
-    context: "Test job context",
-    name: "test-job",
-    schedule: {
-        type: "once",
-        executeAt: new Date(Date.now() + 1000).toISOString()
-    },
-    execute: async (job: JobInstance) => {
-        console.log("Job executed", job);
-        const realtimeJob = await Jobs.create({
-            name: `realtime-job-new-this-again`,
-            description: "Realtime job",
-            schedule: {
-                type: "once",
-                executeAt: new Date(Date.now() + 1000).toISOString()
-            },
-            execute: async (job: JobInstance) => {
-                // console.log("Executing realtime job", job.data);
-                console.log("Realtime job metadata", job.metadata);
-                console.log("Realtime job user", job.user);
-                return { success: true, message: "Realtime job executed successfully" };
-            }
-        });
-        return { success: true, message: "Job executed successfully" };
-    }
-});
-
-
-console.log("Job created:", job);
-
-async function runTests() {
-    // await seedProducts();
-    console.log("🧪 Running tool tests...\n");
-
-    const user = await User.get();
-    console.log("✅ Success:", user);
-    const products = await Products.get();
-    console.log("✅ Success:", products);
-    const orders = await Orders.get();
-    console.log("✅ Success:", orders);
-    const data = await Data.get("movies");
-    console.log("✅ Success:", data);
-    const baskets = await Baskets.get();
-    console.log("✅ Success:", baskets);
-
-    for (const [index, testCase] of testCases.entries()) {
-        try {
-            // console.log(`Test ${index + 1}: ${testCase.tool}`);
-            // const resultGeneral = await generalSkill.run(testCase);
-            // console.log("✅ Success:", resultGeneral);
-            // const resultUserData = await userDataSkill.run(testCase);
-            // console.log("✅ Success:", resultUserData);
-            // const resultEccomerce = await eccomerceSkill.run(testCase);
-            // console.log("✅ Success:", resultEccomerce);
-        } catch (error: any) {
-            console.log("❌ Error:", error.message);
-        }
-        console.log(""); // Empty line for readability
-    }
-}
 
 async function main() {
     try {
-        await runTests();
+    
     } catch (error) {
         console.error("💥 Unexpected error:", error);
         process.exit(1);

package/template/src/postprocessors/modifyResponse.ts

@@ -0,0 +1,21 @@
+import { ChatMessage, PostProcessor, UserDataInstance } from "lua-cli";
+
+
+const modifyResponsePostProcessor = new PostProcessor({
+    name: "modify-response",
+    description: "Modifies the response to the user",
+    context: "Modifies the response to the user",
+    execute: async (user: UserDataInstance, message: string, response: string, channel: string) => {
+        console.log("Modify response post processor", user, message, response, channel);
+        console.log("User data", await user.data);
+        console.log("Message", message);
+        console.log("Response", response);
+        console.log("Channel", channel);
+        if (response.includes("test")) {
+            return message.toUpperCase();
+        }
+        return response;
+    }
+});
+
+export default modifyResponsePostProcessor;

package/template/src/preprocessors/messageMatching.ts

@@ -0,0 +1,22 @@
+import { ChatMessage, PreProcessor, UserDataInstance } from "lua-cli";
+
+
+const messageMatchingPreProcessor = new PreProcessor({
+    name: "message-matching",
+    description: "Matches the message to the appropriate skill",
+    context: "Matches the message to the appropriate skill",
+    execute: async (user: UserDataInstance, messages: ChatMessage[], channel: string) => {
+        console.log("Message matching pre processor", user, messages, channel);
+        console.log("User data", await user.data);
+        console.log("Messages", messages);
+        console.log("Channel", channel);
+        //check if message type text contains test and return the message
+        const testMessage = messages.find((message) => message.type === "text" && message.text.includes("test"));
+        if (testMessage) {
+            return [{ type: "text", text: "Tell the user that you got their test message and nothing else" }];
+        }
+        return messages;
+    }
+});
+
+export default messageMatchingPreProcessor;

package/template/src/skills/basket.skill.ts

@@ -0,0 +1,12 @@
+import { LuaSkill } from "lua-cli";
+import { CreateBasketTool, GetBasketByIdTool, UpdateBasketStatusTool, UpdateBasketMetadataTool, CheckoutBasketTool, GetBasketsTool, ClearBasketTool, RemoveItemFromBasketTool, AddItemToBasketTool } from "./tools/BasketTool";
+
+const basketSkill = new LuaSkill({
+    name: "basket-skill",
+    version: "1.0.0",
+    description: "Basket management skill",
+    context: "Basket management skill",
+    tools: [new CreateBasketTool(), new GetBasketByIdTool(), new UpdateBasketStatusTool(), new UpdateBasketMetadataTool(), new CheckoutBasketTool(), new GetBasketsTool(), new AddItemToBasketTool(), new RemoveItemFromBasketTool(), new ClearBasketTool()],
+});
+
+export default basketSkill;

package/template/src/skills/product.skill.ts

@@ -0,0 +1,13 @@
+import { LuaSkill } from "lua-cli";
+import { SearchProductsTool, CreateProductTool, UpdateProductTool, GetAllProductsTool, GetProductByIdTool, DeleteProductTool } from "./tools/ProductsTool";
+
+
+const productSkill = new LuaSkill({
+    name: "product-skill",
+    version: "1.0.0",
+    description: "Product management skill",
+    context: "Product management skill",
+    tools: [new SearchProductsTool(), new CreateProductTool(), new UpdateProductTool(), new GetAllProductsTool(), new GetProductByIdTool(), new DeleteProductTool()],
+});
+
+export default productSkill;

package/template/src/{tools → skills/tools}/ProductsTool.ts

@@ -58,7 +58,8 @@ export class UpdateProductTool implements LuaTool {
     });
 
     async execute(input: z.infer<typeof this.inputSchema>) {
-        return Products.update({ ...input.product }, input.product.id);
+        const product = await Products.getById(input.product.id);
+        return product.update({ ...input.product });
     }
 }
 

package/template/src/skills/tools/UserDataTool.ts

@@ -0,0 +1,75 @@
+import { AI, LuaTool, User, Jobs, JobInstance } from "lua-cli";
+import { z } from "zod";
+
+
+export class GetUserDataTool implements LuaTool {
+    name = "get_user_data";
+    description = "Get the user data for a given user id";
+    inputSchema = z.object({ });
+
+    constructor() {}
+
+    async execute(input: z.infer<typeof this.inputSchema>) {
+        return User.get();
+    }
+}
+
+export class UpdateUserDataTool implements LuaTool {
+    name = "update_user_data";
+    description = "Update the user data for a given user id";
+    inputSchema = z.object({ 
+        data: z.object({
+            name: z.string().optional(),
+            age: z.number().optional()
+        })
+    });
+
+    constructor() {}
+
+    async execute(input: z.infer<typeof this.inputSchema>) {
+        const user = await User.get(); //get instance of user
+        await user.send([{ type: "text", text: "Hello, how are you?" }]);
+        return await user.update(input.data);
+    }
+}
+
+export class WritePoemTool implements LuaTool {
+    name = "write_poem";
+    description = "Write a poem about a given topic";
+    inputSchema = z.object({
+        topic: z.string()
+    });
+    async execute(input: z.infer<typeof this.inputSchema>) {
+        return await AI.generate("Write a poem about the following topic:", [{ type: "text", text: input.topic }]);
+    }
+}
+
+export class CreateInlineJobTool implements LuaTool {
+    name = "create-job-to-notify-user";
+    description = "Create a new job to notify the user";
+    inputSchema = z.object({
+        message: z.string()
+    });
+    async execute(input: z.infer<typeof this.inputSchema>) {
+        //create a job to notify the user in exactly 20 seconds
+        const job = await Jobs.create({
+            name: "notify-user-new",
+            description: "Notify the user",
+            schedule: {
+                type: "once",
+                executeAt: new Date(Date.now() + 0)
+            },
+            metadata: {
+                message: input.message
+            },
+            execute: async (jobInstance: JobInstance) => {
+                const user = await jobInstance.user();
+                const metadata = jobInstance.metadata; //we do this to access runtime variables in the job when the job is executed
+                console.log("Metadata", metadata);
+                await user.send([{ type: "text", text: metadata.message }]);
+                return { success: true, message: "User notified" };
+            }
+        });
+        return { success: true, job: job };
+    }
+}

package/template/src/skills/user.skill.ts

@@ -0,0 +1,13 @@
+import { LuaSkill } from "lua-cli";
+import { CreateInlineJobTool, GetUserDataTool, UpdateUserDataTool, WritePoemTool } from "./tools/UserDataTool";
+
+
+const userSkill = new LuaSkill({
+    name: "user-skill",
+    version: "1.0.0",
+    description: "User management skill",
+    context: "User management skill",
+    tools: [new GetUserDataTool(), new UpdateUserDataTool(), new WritePoemTool(), new CreateInlineJobTool()],
+});
+
+export default userSkill;

package/template/src/seed.ts

@@ -1,46 +0,0 @@
-import fetch from "node-fetch";
-import OpenAI from "openai";
-import { Pinecone } from "@pinecone-database/pinecone";
-import { env } from "lua-cli/skill";
-
-const openai = new OpenAI({ apiKey: env("OPENAI_API_KEY") || "" });
-const pinecone = new Pinecone({ apiKey: env("PINECONE_API_KEY") || "" });
-const indexName = "products-demo";
-
-async function embed(text: string) {
-  const res = await openai.embeddings.create({
-    model: "text-embedding-3-small",
-    input: text,
-  });
-  return res.data[0].embedding;
-}
-
-export default async function seedProducts() {
-  const index = pinecone.Index(indexName);
-
-  // Example: Fake Store API
-  const response = await fetch("https://fakestoreapi.com/products");
-  const products = await response.json() as any[];
-
-  const vectors = await Promise.all(
-    products.map(async (product) => {
-      const embedding = await embed(`${product.title}. ${product.description}`);
-      return {
-        id: product.id.toString(),
-        values: embedding,
-        metadata: {
-          title: product.title,
-          description: product.description,
-          category: product.category,
-          price: product.price,
-          image: product.image,
-        },
-      };
-    })
-  );
-
-  await index.upsert(vectors);
-  console.log("Dummy products inserted!");
-}
-
-seedProducts().catch(console.error);

package/template/src/tools/UserDataTool.ts

@@ -1,33 +0,0 @@
-import { LuaTool, User } from "lua-cli";
-import { z } from "zod";
-
-
-export class GetUserDataTool implements LuaTool {
-    name = "get_user_data";
-    description = "Get the user data for a given user id";
-    inputSchema = z.object({ });
-
-    constructor() {}
-
-    async execute(input: z.infer<typeof this.inputSchema>) {
-        return User.get();
-    }
-}
-
-export class UpdateUserDataTool implements LuaTool {
-    name = "update_user_data";
-    description = "Update the user data for a given user id";
-    inputSchema = z.object({ 
-        data: z.object({
-            name: z.string().optional(),
-            age: z.number().optional()
-        })
-    });
-
-    constructor() {}
-
-    async execute(input: z.infer<typeof this.inputSchema>) {
-        const user = await User.get(); //get instance of user
-        return await user.update(input.data);
-    }
-}