lua-cli 3.0.0-alpha.1 → 3.0.0-alpha.5

package/template/src/index-agent-example.ts

@@ -1,201 +0,0 @@
-// /**
-//  * LuaAgent Example - Simplified Agent Configuration
-//  * 
-//  * This example shows the NEW, RECOMMENDED way to define your agent using LuaAgent.
-//  * Instead of exporting individual skills, webhooks, jobs, and processors,
-//  * you create one unified LuaAgent object that contains everything.
-//  * 
-//  * Benefits:
-//  * - Simpler, cleaner code
-//  * - All configuration in one place
-//  * - Easier to understand and maintain
-//  * - Agent persona is synced with lua.skill.yaml automatically
-//  */
-
-// import { LuaAgent, LuaSkill } 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 { 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";
-
-// // ============================================================================
-// // WEBHOOK EXAMPLES (Uncomment to enable)
-// // ============================================================================
-// // import userEventWebhook from "./webhooks/UserEventWebhook";
-// // import paymentWebhook from "./webhooks/PaymentWebhook";
-
-// // ============================================================================
-// // JOB EXAMPLES (Uncomment to enable)
-// // ============================================================================
-// // import dailyCleanupJob from "./jobs/DailyCleanupJob";
-// // import healthCheckJob from "./jobs/HealthCheckJob";
-
-// // ============================================================================
-// // PREPROCESSOR/POSTPROCESSOR EXAMPLES
-// // ============================================================================
-// import messageFilter from "./preprocessors/MessageFilter";
-// import responseFormatter from "./postprocessors/ResponseFormatter";
-
-// // ============================================================================
-// // SKILLS
-// // ============================================================================
-
-// // Skills can be defined separately for better organization
-// const generalSkill = new LuaSkill({
-//   name: "general-skill",
-//   version: "1.0.0",
-//   description: "General utilities including weather and post creation",
-//   context: "This skill provides weather information and post creation capabilities.",
-//   tools: [
-//     new GetWeatherTool(),
-//     new CreatePostTool()
-//   ]
-// });
-
-// const userDataSkill = new LuaSkill({
-//   name: "user-data-skill",
-//   version: "1.0.0",
-//   description: "User data management",
-//   context: "This skill provides user data retrieval and update capabilities.",
-//   tools: [
-//     new GetUserDataTool(),
-//     new UpdateUserDataTool()
-//   ]
-// });
-
-// const productSkill = new LuaSkill({
-//   name: "product-skill",
-//   version: "1.0.0",
-//   description: "Product catalog management",
-//   context: "This skill provides comprehensive product management capabilities.",
-//   tools: [
-//     new SearchProductsTool(),
-//     new GetAllProductsTool(),
-//     new CreateProductTool(),
-//     new UpdateProductTool(),
-//     new GetProductByIdTool(),
-//     new DeleteProductTool()
-//   ]
-// });
-
-// const basketSkill = new LuaSkill({
-//   name: "basket-skill",
-//   version: "1.0.0",
-//   description: "Shopping basket management",
-//   context: "This skill provides shopping basket operations.",
-//   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: "1.0.0",
-//   description: "Order management",
-//   context: "This skill provides order management capabilities.",
-//   tools: [
-//     new CreateOrderTool(),
-//     new UpdateOrderStatusTool(),
-//     new GetOrderByIdTool(),
-//     new GetUserOrdersTool()
-//   ]
-// });
-
-// const customDataSkill = new LuaSkill({
-//   name: "custom-data-skill",
-//   version: "1.0.0",
-//   description: "Custom data management for movies",
-//   context: "This skill provides custom data storage and retrieval for movies.",
-//   tools: [
-//     new CreateMovieTool(),
-//     new GetMoviesTool(),
-//     new GetMovieByIdTool(),
-//     new UpdateMovieTool(),
-//     new SearchMoviesTool(),
-//     new DeleteMovieTool()
-//   ]
-// });
-
-// // ============================================================================
-// // AGENT CONFIGURATION (NEW APPROACH)
-// // ============================================================================
-
-// /**
-//  * This is the main agent configuration.
-//  * The LuaAgent consolidates everything in one place:
-//  * - Agent persona (behavior and personality)
-//  * - Skills (collections of tools)
-//  * - Webhooks (HTTP endpoints)
-//  * - Jobs (scheduled tasks)
-//  * - PreProcessors (run before messages reach agent)
-//  * - PostProcessors (run after agent generates responses)
-//  * 
-//  * The compiler will:
-//  * 1. Detect this LuaAgent
-//  * 2. Extract all components (skills, webhooks, jobs, processors)
-//  * 3. Sync the persona with lua.skill.yaml
-//  * 4. Deploy everything to the Lua platform
-//  */
-// export const agent = new LuaAgent({
-//   name: "my-assistant",
-//   persona: `You are a helpful e-commerce assistant that can help users with:
-//     - Weather information
-//     - User account management
-//     - Product browsing and search
-//     - Shopping basket operations
-//     - Order management
-//     - Movie database management
-    
-//     You are friendly, helpful, and provide clear responses. When users ask about products,
-//     help them search and find what they need. When they want to purchase, guide them through
-//     the basket and checkout process.`,
-  
-//   welcomeMessage: "Hello! I'm your e-commerce assistant. I can help you find products, manage your basket, and track orders. How can I help you today?",
-  
-//   // Add all your skills here
-//   skills: [
-//     generalSkill,
-//     userDataSkill,
-//     productSkill,
-//     basketSkill,
-//     orderSkill,
-//     customDataSkill
-//   ],
-  
-//   // Uncomment to add webhooks
-//   // webhooks: [
-//   //   userEventWebhook,
-//   //   paymentWebhook
-//   // ],
-  
-//   // Uncomment to add scheduled jobs
-//   // jobs: [
-//   //   dailyCleanupJob,
-//   //   healthCheckJob
-//   // ],
-  
-//   // Message preprocessors (filter spam, add context, etc.)
-//   preProcessors: [
-//     messageFilter
-//   ],
-  
-//   // Response postprocessors (format output, add branding, etc.)
-//   postProcessors: [
-//     responseFormatter
-//   ]
-// });
-
-// // That's it! The compiler will detect this LuaAgent and deploy everything.
-// // No need to export individual skills, webhooks, jobs, etc.
-

package/template/src/postprocessors/ResponseFormatter.ts

@@ -1,151 +0,0 @@
-/**
- * Response Formatter PostProcessor
- * 
- * PostProcessors run AFTER the AI agent generates a response.
- * They can:
- * - Format or beautify responses
- * - Add branding or signatures
- * - Translate responses
- * - Add disclaimers
- * - Filter sensitive information
- * - Adapt tone or style
- * 
- * The execute function receives:
- * - user: UserDataInstance (current user info)
- * - message: string (the user's original message)
- * - response: string (the agent's generated response)
- * - channel: string (where the response will be sent)
- * 
- * Returns: The formatted response that will be sent to the user
- */
-
-import { PostProcessor } from "lua-cli";
-
-const responseFormatter = new PostProcessor({
-  name: "response-formatter",
-  version: "1.0.0",
-  description: "Formats and enhances agent responses before sending to users",
-  context: "This postprocessor adds branding, formats responses for different channels, and ensures consistency.",
-  
-  execute: async (user, message, response, channel) => {
-    console.log(`[ResponseFormatter] Formatting response for user ${user.id} via ${channel}`);
-    
-    let formattedResponse = response;
-    
-    // Example 1: Add personalized greeting for first-time users
-    if (user.metadata?.isFirstMessage) {
-      formattedResponse = `👋 Welcome, ${user.name || 'there'}! ${formattedResponse}`;
-    }
-    
-    // Example 2: Format based on channel
-    switch (channel.toLowerCase()) {
-      case 'sms':
-        // SMS: Keep it short, remove emojis, add link to full response
-        formattedResponse = formattedResponse
-          .replace(/[^\w\s.,!?-]/g, '') // Remove special chars
-          .substring(0, 160); // SMS limit
-        if (response.length > 160) {
-          formattedResponse += '... (continued at app.example.com)';
-        }
-        break;
-        
-      case 'email':
-        // Email: Add proper formatting and signature
-        formattedResponse = `
-<html>
-<body style="font-family: Arial, sans-serif; line-height: 1.6;">
-  <p>Hi ${user.name || 'there'},</p>
-  <p>${formattedResponse.replace(/\n/g, '<br>')}</p>
-  <br>
-  <p>Best regards,<br>
-  <strong>Zara</strong><br>
-  <em>Your E-commerce Assistant</em></p>
-  <hr>
-  <p style="font-size: 0.8em; color: #666;">
-    This is an automated response. Reply to this email if you need further assistance.
-  </p>
-</body>
-</html>`;
-        break;
-        
-      case 'slack':
-      case 'discord':
-        // Chat platforms: Add markdown formatting
-        formattedResponse = formattedResponse
-          .replace(/\*\*(.*?)\*\*/g, '*$1*') // Bold
-          .replace(/__(.*?)__/g, '_$1_'); // Italic
-        break;
-        
-      default:
-        // Default: Clean formatting
-        break;
-    }
-    
-    // Example 3: Add product links automatically
-    // Detect when products are mentioned and add quick links
-    const productMentionPattern = /(?:product|item|sku)[\s:]+(\w+)/gi;
-    const matches = formattedResponse.matchAll(productMentionPattern);
-    
-    for (const match of matches) {
-      const productId = match[1];
-      // You could look up actual product URLs here
-      formattedResponse = formattedResponse.replace(
-        match[0],
-        `${match[0]} [View](https://example.com/products/${productId})`
-      );
-    }
-    
-    // Example 4: Add helpful footer based on context
-    const hasOrderMention = /order|purchase|buy/i.test(message);
-    const hasBasketMention = /basket|cart|checkout/i.test(message);
-    
-    if (hasOrderMention) {
-      formattedResponse += '\n\n💡 Tip: You can track your orders anytime by asking "show my orders"';
-    } else if (hasBasketMention) {
-      formattedResponse += '\n\n🛒 Need help? Just ask me to "show my basket" or "checkout"';
-    }
-    
-    // Example 5: Filter sensitive information
-    // Remove any accidentally exposed sensitive data
-    formattedResponse = formattedResponse
-      .replace(/\b\d{16}\b/g, '****-****-****-****') // Credit card numbers
-      .replace(/\b\d{3}-\d{2}-\d{4}\b/g, '***-**-****') // SSN
-      .replace(/password[:\s]+\S+/gi, 'password: [REDACTED]'); // Passwords
-    
-    // Example 6: Add emoji based on sentiment (simple version)
-    if (/thank|great|awesome|love|perfect/i.test(message)) {
-      formattedResponse = `😊 ${formattedResponse}`;
-    } else if (/problem|issue|error|wrong|broken/i.test(message)) {
-      formattedResponse = `🔧 ${formattedResponse}`;
-    } else if (/help|how|what|where/i.test(message)) {
-      formattedResponse = `💡 ${formattedResponse}`;
-    }
-    
-    // Example 7: Add timestamp for long responses
-    if (formattedResponse.length > 500) {
-      const timestamp = new Date().toLocaleTimeString();
-      formattedResponse += `\n\n_Response generated at ${timestamp}_`;
-    }
-    
-    // Example 8: Add disclaimer for legal/financial advice
-    const needsDisclaimer = /legal|law|lawsuit|sue|invest|stock|crypto|tax/i.test(message);
-    if (needsDisclaimer) {
-      formattedResponse += '\n\n⚠️ _Disclaimer: This information is for general guidance only and should not be considered professional legal or financial advice. Please consult with a qualified professional for your specific situation._';
-    }
-    
-    // Example 9: Ensure proper length
-    const MAX_LENGTH = 4000; // Most platforms have limits
-    if (formattedResponse.length > MAX_LENGTH) {
-      formattedResponse = formattedResponse.substring(0, MAX_LENGTH - 50) + 
-        '...\n\n_Response truncated. Please ask for more specific information._';
-    }
-    
-    console.log(`[ResponseFormatter] Original length: ${response.length} chars`);
-    console.log(`[ResponseFormatter] Formatted length: ${formattedResponse.length} chars`);
-    
-    return formattedResponse;
-  }
-});
-
-export default responseFormatter;
-

package/template/src/preprocessors/MessageFilter.ts

@@ -1,91 +0,0 @@
-/**
- * Message Filter PreProcessor
- * 
- * PreProcessors run BEFORE messages reach the AI agent.
- * They can:
- * - Filter out spam or inappropriate content
- * - Translate messages
- * - Add context to messages
- * - Modify user input
- * - Block certain types of requests
- * 
- * The execute function receives:
- * - user: UserDataInstance (current user info)
- * - message: string (the user's message)
- * - channel: string (where the message came from)
- * 
- * Returns: The potentially modified message that will be sent to the agent
- */
-
-import { PreProcessor } from "lua-cli";
-
-const messageFilter = new PreProcessor({
-  name: "message-filter",
-  version: "1.0.0",
-  description: "Filters and preprocesses user messages before they reach the agent",
-  context: "This preprocessor removes spam, blocks inappropriate content, and adds helpful context to user messages.",
-  
-  execute: async (user, message, channel) => {
-    console.log(`[MessageFilter] Processing message from user ${user.id} via ${channel}`);
-    
-    // Example 1: Block spam patterns
-    const spamPatterns = [
-      /buy now/i,
-      /click here/i,
-      /free money/i,
-      /\b(viagra|cialis)\b/i
-    ];
-    
-    for (const pattern of spamPatterns) {
-      if (pattern.test(message)) {
-        console.log('[MessageFilter] Spam detected, blocking message');
-        return "[This message was blocked by spam filter]";
-      }
-    }
-    
-    // Example 2: Remove excessive punctuation
-    let filteredMessage = message.replace(/([!?.]){3,}/g, '$1$1'); // Reduce !!!!! to !!
-    
-    // Example 3: Normalize whitespace
-    filteredMessage = filteredMessage.trim().replace(/\s+/g, ' ');
-    
-    // Example 4: Add user context for the agent
-    // This helps the agent understand who they're talking to
-    if (user.name && !filteredMessage.toLowerCase().includes('my name')) {
-      // Agent will have context about user's name without being intrusive
-      filteredMessage = `[User: ${user.name}] ${filteredMessage}`;
-    }
-    
-    // Example 5: Detect and flag urgent messages
-    const urgentKeywords = ['urgent', 'emergency', 'asap', 'immediately', 'help'];
-    const isUrgent = urgentKeywords.some(keyword => 
-      filteredMessage.toLowerCase().includes(keyword)
-    );
-    
-    if (isUrgent) {
-      filteredMessage = `[URGENT] ${filteredMessage}`;
-      console.log('[MessageFilter] Urgent message flagged');
-    }
-    
-    // Example 6: Add channel context
-    // This helps the agent adapt its response based on the channel
-    if (channel && channel !== 'default') {
-      filteredMessage = `[Via ${channel}] ${filteredMessage}`;
-    }
-    
-    // Example 7: Language detection hint (optional)
-    // You could integrate with a language detection library here
-    const hasNonEnglish = /[^\u0000-\u007F]/.test(message);
-    if (hasNonEnglish) {
-      filteredMessage = `[Contains non-ASCII characters] ${filteredMessage}`;
-    }
-    
-    console.log(`[MessageFilter] Original: "${message}"`);
-    console.log(`[MessageFilter] Filtered: "${filteredMessage}"`);
-    
-    return filteredMessage;
-  }
-});
-
-export default messageFilter;
-