lua-cli 3.13.0 → 3.14.1

package/template/examples/README.md

@@ -5,74 +5,80 @@ This folder contains example implementations of all Lua AI Agent features. Use t
 ## 📁 What's Inside
 
 ### skills/
+
 Example skills and tools demonstrating platform APIs:
 
-| File | What it shows |
-|------|--------------|
-| `tools/GetWeatherTool.ts` | External API integration |
-| `tools/UserDataTool.ts` | User API - get/update user data, chat history, AI generation |
-| `tools/ProductsTool.ts` | Products API - CRUD operations |
-| `tools/BasketTool.ts` | Baskets API - shopping cart |
-| `tools/OrderTool.ts` | Orders API - order management, status & data updates |
-| `tools/CustomDataTool.ts` | Data API - custom collections with semantic search |
-| `tools/PaymentTool.ts` | Stripe integration, environment variables |
-| `tools/SmartBasketTool.ts` | Dynamic job creation from tools |
-| `tools/GameScoreTrackerTool.ts` | Jobs API - interval jobs, deactivation, getAll |
+| File                            | What it shows                                                |
+| ------------------------------- | ------------------------------------------------------------ |
+| `tools/GetWeatherTool.ts`       | External API integration                                     |
+| `tools/UserDataTool.ts`         | User API - get/update user data, chat history, AI generation |
+| `tools/ProductsTool.ts`         | Products API - CRUD operations                               |
+| `tools/BasketTool.ts`           | Baskets API - shopping cart                                  |
+| `tools/OrderTool.ts`            | Orders API - order management, status & data updates         |
+| `tools/CustomDataTool.ts`       | Data API - custom collections with semantic search           |
+| `tools/PaymentTool.ts`          | Stripe integration, environment variables                    |
+| `tools/SmartBasketTool.ts`      | Dynamic job creation from tools                              |
+| `tools/GameScoreTrackerTool.ts` | Jobs API - interval jobs, deactivation, getAll               |
 
 ### webhooks/
+
 HTTP endpoints for external integrations:
 
-| File | What it shows |
-|------|--------------|
-| `PaymentWebhook.ts` | Stripe payment notifications, Orders API |
-| `UserEventWebhook.ts` | External events, **Templates API** (WhatsApp) |
-| `FileUploadWebhook.ts` | **CDN API** - file uploads, Data API |
+| File                   | What it shows                                 |
+| ---------------------- | --------------------------------------------- |
+| `PaymentWebhook.ts`    | Stripe payment notifications, Orders API      |
+| `UserEventWebhook.ts`  | External events, **Templates API** (WhatsApp) |
+| `FileUploadWebhook.ts` | **CDN API** - file uploads, Data API          |
 
 ### jobs/
+
 Scheduled background tasks:
 
-| File | What it shows |
-|------|--------------|
-| `HealthCheckJob.ts` | Interval schedule, health monitoring |
-| `DailyCleanupJob.ts` | Cron schedule, data cleanup |
-| `DataMigrationJob.ts` | One-time schedule, batch processing |
+| File                             | What it shows                                 |
+| -------------------------------- | --------------------------------------------- |
+| `HealthCheckJob.ts`              | Interval schedule, health monitoring          |
+| `DailyCleanupJob.ts`             | Cron schedule, data cleanup                   |
+| `DataMigrationJob.ts`            | One-time schedule, batch processing           |
 | `AbandonedBasketProcessorJob.ts` | **Templates API** (WhatsApp), batch reminders |
 
 ### preprocessors/
+
 Message filtering before the agent:
 
-| File | What it shows |
-|------|--------------|
+| File                 | What it shows                          |
+| -------------------- | -------------------------------------- |
 | `messageMatching.ts` | Modify/block messages based on content |
 
 ### postprocessors/
+
 Response transformation after the agent:
 
-| File | What it shows |
-|------|--------------|
+| File                | What it shows             |
+| ------------------- | ------------------------- |
 | `modifyResponse.ts` | Transform agent responses |
 
 ### services/
+
 Helper utilities:
 
-| File | What it shows |
-|------|--------------|
-| `ApiService.ts` | HTTP client wrapper |
+| File            | What it shows            |
+| --------------- | ------------------------ |
+| `ApiService.ts` | HTTP client wrapper      |
 | `GetWeather.ts` | Mock service for testing |
 
 ## 🎯 API Coverage
 
-| API | Where it's demonstrated |
-|-----|------------------------|
-| **User** | `UserDataTool.ts` |
-| **Products** | `ProductsTool.ts` |
-| **Baskets** | `BasketTool.ts`, `SmartBasketTool.ts` |
-| **Orders** | `OrderTool.ts`, `PaymentWebhook.ts` |
-| **Data** | `CustomDataTool.ts`, `FileUploadWebhook.ts` |
-| **Jobs** | `SmartBasketTool.ts`, `GameScoreTrackerTool.ts` |
-| **AI** | `UserDataTool.ts` |
+| API           | Where it's demonstrated                                 |
+| ------------- | ------------------------------------------------------- |
+| **User**      | `UserDataTool.ts`                                       |
+| **Products**  | `ProductsTool.ts`                                       |
+| **Baskets**   | `BasketTool.ts`, `SmartBasketTool.ts`                   |
+| **Orders**    | `OrderTool.ts`, `PaymentWebhook.ts`                     |
+| **Data**      | `CustomDataTool.ts`, `FileUploadWebhook.ts`             |
+| **Jobs**      | `SmartBasketTool.ts`, `GameScoreTrackerTool.ts`         |
+| **AI**        | `UserDataTool.ts`                                       |
 | **Templates** | `UserEventWebhook.ts`, `AbandonedBasketProcessorJob.ts` |
-| **CDN** | `FileUploadWebhook.ts` |
+| **CDN**       | `FileUploadWebhook.ts`                                  |
 
 ## 🚀 How to Use
 

package/template/examples/jobs/AbandonedBasketProcessorJob.ts

@@ -1,15 +1,15 @@
 /**
  * Abandoned Basket Processor Job
- * 
+ *
  * Processes abandoned cart reminders and sends WhatsApp notifications.
- * 
+ *
  * Flow:
  * 1. User creates basket → Tool schedules reminder in custom data
  * 2. This job runs every 15 minutes
  * 3. Checks which reminders are due
  * 4. Checks if baskets were checked out
  * 5. Sends WhatsApp template message for abandoned baskets
- * 
+ *
  * Demonstrates:
  * - Interval job scheduling
  * - Batch processing pattern
@@ -17,19 +17,19 @@
  * - Data API for tracking state
  */
 
-import { LuaJob, Data, Baskets, Templates, env } from "lua-cli";
+import { LuaJob, Data, Baskets, Templates, env } from 'lua-cli';
 
 const abandonedBasketProcessorJob = new LuaJob({
-  name: "process-basket-reminders",
-  description: "Processes abandoned basket reminders and sends WhatsApp notifications",
+  name: 'process-basket-reminders',
+  description: 'Processes abandoned basket reminders and sends WhatsApp notifications',
 
   // Run every 15 minutes
   schedule: {
     type: 'interval',
-    seconds: 900  // 15 minutes = 900 seconds
+    seconds: 900, // 15 minutes = 900 seconds
   },
 
-  timeout: 120,  // 2 minutes
+  timeout: 120, // 2 minutes
 
   execute: async () => {
     // Configuration - set these in your environment variables
@@ -70,9 +70,10 @@ const abandonedBasketProcessorJob = new LuaJob({
           abandonedCount++;
 
           // Calculate basket value
-          const totalValue = basket.items?.reduce((sum: number, item: any) => {
-            return sum + (item.price * item.quantity);
-          }, 0) || 0;
+          const totalValue =
+            basket.items?.reduce((sum: number, item: any) => {
+              return sum + item.price * item.quantity;
+            }, 0) || 0;
 
           // Log abandoned basket
           await Data.create('abandoned-baskets', {
@@ -82,7 +83,7 @@ const abandonedBasketProcessorJob = new LuaJob({
             totalValue,
             items: basket.items,
             abandonedAt: new Date().toISOString(),
-            reminderSent: false
+            reminderSent: false,
           });
 
           // Send WhatsApp reminder if we have a phone number
@@ -90,12 +91,10 @@ const abandonedBasketProcessorJob = new LuaJob({
             try {
               // Find the abandoned cart template
               const templatesResponse = await Templates.whatsapp.list(WHATSAPP_CHANNEL_ID, {
-                search: ABANDONED_CART_TEMPLATE_NAME
+                search: ABANDONED_CART_TEMPLATE_NAME,
               });
-              
-              const template = templatesResponse.templates.find(
-                t => t.status === 'APPROVED'
-              );
+
+              const template = templatesResponse.templates.find((t) => t.status === 'APPROVED');
 
               if (template) {
                 // Send the template message
@@ -104,15 +103,15 @@ const abandonedBasketProcessorJob = new LuaJob({
                   values: {
                     body: {
                       item_count: String(basket.items?.length || 0),
-                      total_value: `${basket.currency} ${totalValue.toFixed(2)}`
-                    }
-                  }
+                      total_value: `${basket.currency} ${totalValue.toFixed(2)}`,
+                    },
+                  },
                 });
 
                 if (result.totalErrors === 0) {
                   console.log(`📱 WhatsApp reminder sent to ${reminder.data.phoneNumber}`);
                   messagesSent++;
-                  
+
                   // Update the abandoned basket record
                   const abandonedRecords = await Data.get('abandoned-baskets', {}, 1, 100);
                   const record = abandonedRecords.data?.find((r: any) => r.data.basketId === basket.id);
@@ -120,7 +119,7 @@ const abandonedBasketProcessorJob = new LuaJob({
                     await Data.update('abandoned-baskets', record.id, {
                       ...record.data,
                       reminderSent: true,
-                      reminderSentAt: new Date().toISOString()
+                      reminderSentAt: new Date().toISOString(),
                     });
                   }
                 } else {
@@ -139,9 +138,8 @@ const abandonedBasketProcessorJob = new LuaJob({
             ...reminder.data,
             status: 'completed',
             result: 'abandoned',
-            processedAt: new Date().toISOString()
+            processedAt: new Date().toISOString(),
           });
-
         } else {
           // Basket was checked out
           console.log(`✅ Basket ${basket.id} was checked out (${basket.status})`);
@@ -152,22 +150,21 @@ const abandonedBasketProcessorJob = new LuaJob({
             ...reminder.data,
             status: 'completed',
             result: 'checked-out',
-            processedAt: new Date().toISOString()
+            processedAt: new Date().toISOString(),
           });
         }
 
         processedCount++;
-
       } catch (error) {
         console.error(`❌ Error processing basket ${reminder.data.basketId}:`, error);
-        
+
         // Mark as error
         try {
           await Data.update('basket-reminders', reminder.id, {
             ...reminder.data,
             status: 'error',
             error: String(error),
-            processedAt: new Date().toISOString()
+            processedAt: new Date().toISOString(),
           });
         } catch (updateError) {
           console.error('Failed to update reminder status:', updateError);
@@ -176,7 +173,9 @@ const abandonedBasketProcessorJob = new LuaJob({
     }
 
     console.log('✅ Reminder processing complete');
-    console.log(`📊 Processed: ${processedCount}, Abandoned: ${abandonedCount}, Checked out: ${checkedOutCount}, Messages sent: ${messagesSent}`);
+    console.log(
+      `📊 Processed: ${processedCount}, Abandoned: ${abandonedCount}, Checked out: ${checkedOutCount}, Messages sent: ${messagesSent}`
+    );
 
     return {
       success: true,
@@ -184,9 +183,9 @@ const abandonedBasketProcessorJob = new LuaJob({
       abandonedCount,
       checkedOutCount,
       messagesSent,
-      timestamp: new Date().toISOString()
+      timestamp: new Date().toISOString(),
     };
-  }
+  },
 });
 
 export default abandonedBasketProcessorJob;

package/template/examples/jobs/DailyCleanupJob.ts

@@ -1,21 +1,21 @@
 /**
  * Daily Cleanup Job Example
- * 
+ *
  * This job runs daily at 2 AM to clean up old data and maintain database performance.
  * Demonstrates: Cron scheduling, data cleanup, and error handling.
  */
 
-import { LuaJob, Data } from "lua-cli";
+import { LuaJob, Data } from 'lua-cli';
 
 const dailyCleanupJob = new LuaJob({
-  name: "daily-cleanup",
-  description: "Daily database cleanup and maintenance",
+  name: 'daily-cleanup',
+  description: 'Daily database cleanup and maintenance',
 
   // Cron schedule: Every day at 2 AM EST
   schedule: {
     type: 'cron',
-    expression: '0 2 * * *',  // minute hour day month day-of-week
-    timezone: 'America/New_York'
+    expression: '0 2 * * *', // minute hour day month day-of-week
+    timezone: 'America/New_York',
   },
 
   // Give it 10 minutes to complete
@@ -24,7 +24,7 @@ const dailyCleanupJob = new LuaJob({
   // Retry up to 3 times if it fails
   retry: {
     maxAttempts: 3,
-    backoffSeconds: 60  // Wait 60s between retries
+    backoffSeconds: 60, // Wait 60s between retries
   },
 
   execute: async () => {
@@ -35,11 +35,11 @@ const dailyCleanupJob = new LuaJob({
 
     // 1. Clean up old user events (older than 90 days)
     const ninetyDaysAgo = new Date(Date.now() - 90 * 24 * 60 * 60 * 1000);
-    
+
     try {
       const oldEventsResponse = await Data.get('user-events', {}, 1, 1000);
       const oldEvents = oldEventsResponse.data || [];
-      
+
       for (const event of oldEvents) {
         const eventDate = new Date(event.data.receivedAt);
         if (eventDate < ninetyDaysAgo) {
@@ -47,7 +47,7 @@ const dailyCleanupJob = new LuaJob({
           totalRecordsDeleted++;
         }
       }
-      
+
       console.log(`✅ Deleted ${totalRecordsDeleted} old user events`);
     } catch (error) {
       console.error('❌ Error cleaning user events:', error);
@@ -55,12 +55,12 @@ const dailyCleanupJob = new LuaJob({
 
     // 2. Clean up old payment logs (older than 180 days)
     const oneEightyDaysAgo = new Date(Date.now() - 180 * 24 * 60 * 60 * 1000);
-    
+
     try {
       const oldLogsResponse = await Data.get('payment-logs', {}, 1, 1000);
       const oldLogs = oldLogsResponse.data || [];
       let logsDeleted = 0;
-      
+
       for (const log of oldLogs) {
         const logDate = new Date(log.data.receivedAt);
         if (logDate < oneEightyDaysAgo) {
@@ -69,7 +69,7 @@ const dailyCleanupJob = new LuaJob({
           totalRecordsDeleted++;
         }
       }
-      
+
       console.log(`✅ Deleted ${logsDeleted} old payment logs`);
     } catch (error) {
       console.error('❌ Error cleaning payment logs:', error);
@@ -78,9 +78,9 @@ const dailyCleanupJob = new LuaJob({
     // 3. Clean up abandoned baskets (older than 7 days)
     // Note: This would require basket API support for deletion
     // For now, we'll just log the count
-    
+
     const duration = Date.now() - startTime;
-    
+
     console.log(`✅ Cleanup complete in ${duration}ms`);
 
     return {
@@ -88,10 +88,9 @@ const dailyCleanupJob = new LuaJob({
       recordsDeleted: totalRecordsDeleted,
       duration: `${duration}ms`,
       completedAt: new Date().toISOString(),
-      collections: ['user-events', 'payment-logs']
+      collections: ['user-events', 'payment-logs'],
     };
-  }
+  },
 });
 
 export default dailyCleanupJob;
-

package/template/examples/jobs/DataMigrationJob.ts

@@ -1,20 +1,20 @@
 /**
  * Data Migration Job Example
- * 
+ *
  * This is a one-time job that runs at a specific date/time to migrate data.
  * Demonstrates: One-time scheduling, data migration, and batch processing.
  */
 
-import { LuaJob, Data } from "lua-cli";
+import { LuaJob, Data } from 'lua-cli';
 
 const dataMigrationJob = new LuaJob({
-  name: "migrate-user-schema",
-  description: "One-time migration to new user event schema",
+  name: 'migrate-user-schema',
+  description: 'One-time migration to new user event schema',
 
   // One-time schedule: Run at specific date/time
   schedule: {
     type: 'once',
-    executeAt: new Date('2025-12-31T02:00:00Z')  // December 31, 2025 at 2 AM UTC
+    executeAt: new Date('2025-12-31T02:00:00Z'), // December 31, 2025 at 2 AM UTC
   },
 
   // Give it 30 minutes for large migration
@@ -23,7 +23,7 @@ const dataMigrationJob = new LuaJob({
   // Retry important migrations
   retry: {
     maxAttempts: 3,
-    backoffSeconds: 300  // 5 minutes between retries
+    backoffSeconds: 300, // 5 minutes between retries
   },
 
   execute: async () => {
@@ -37,7 +37,7 @@ const dataMigrationJob = new LuaJob({
       // Get all user events with old schema
       const oldEventsResponse = await Data.get('user-events', {}, 1, 1000);
       const oldEvents = oldEventsResponse.data || [];
-      
+
       console.log(`📊 Found ${oldEvents.length} events to migrate`);
 
       // Migrate each event
@@ -48,26 +48,24 @@ const dataMigrationJob = new LuaJob({
             // New fields
             eventId: event.id,
             eventType: event.data.type || 'unknown',
-            userId: event.data.userId || event.data.user_id,  // Handle both formats
+            userId: event.data.userId || event.data.user_id, // Handle both formats
             email: event.data.email,
             name: event.data.name,
-            
+
             // Preserve metadata
             metadata: {
               ...event.data.metadata,
               migratedFrom: 'old-schema',
-              migratedAt: new Date().toISOString()
+              migratedAt: new Date().toISOString(),
             },
-            
+
             // Copy timestamps
             originalTimestamp: event.data.timestamp,
-            receivedAt: event.data.receivedAt
+            receivedAt: event.data.receivedAt,
           };
 
           // Create in new collection
-          await Data.create('user-events-v2', migratedEvent, 
-            `${migratedEvent.eventType} ${migratedEvent.email}`
-          );
+          await Data.create('user-events-v2', migratedEvent, `${migratedEvent.eventType} ${migratedEvent.email}`);
 
           totalMigrated++;
 
@@ -75,7 +73,6 @@ const dataMigrationJob = new LuaJob({
           if (totalMigrated % 100 === 0) {
             console.log(`✅ Migrated ${totalMigrated} records...`);
           }
-
         } catch (error) {
           console.error(`❌ Failed to migrate event ${event.id}:`, error);
           totalErrors++;
@@ -101,7 +98,7 @@ const dataMigrationJob = new LuaJob({
         errors: totalErrors,
         successRate: parseFloat(successRate),
         duration,
-        completedAt: new Date().toISOString()
+        completedAt: new Date().toISOString(),
       });
 
       return {
@@ -110,21 +107,19 @@ const dataMigrationJob = new LuaJob({
         migrated: totalMigrated,
         errors: totalErrors,
         successRate: `${successRate}%`,
-        duration: `${duration}ms`
+        duration: `${duration}ms`,
       };
-
     } catch (error) {
       console.error('💥 Migration failed:', error);
-      
+
       return {
         success: false,
         error: String(error),
         totalMigrated,
-        totalErrors
+        totalErrors,
       };
     }
-  }
+  },
 });
 
 export default dataMigrationJob;
-

package/template/examples/jobs/HealthCheckJob.ts

@@ -1,20 +1,20 @@
 /**
  * Health Check Job Example
- * 
+ *
  * This job runs every 5 minutes to check system health and alert on issues.
  * Demonstrates: Interval scheduling, monitoring, and alerting.
  */
 
-import { LuaJob, Data, Products } from "lua-cli";
+import { LuaJob, Data, Products } from 'lua-cli';
 
 const healthCheckJob = new LuaJob({
-  name: "health-check",
-  description: "System health monitoring",
+  name: 'health-check',
+  description: 'System health monitoring',
 
   // Interval schedule: Every 5 minutes
   schedule: {
     type: 'interval',
-    seconds: 300  // 5 minutes = 300 seconds
+    seconds: 300, // 5 minutes = 300 seconds
   },
 
   // Quick timeout for health checks
@@ -29,12 +29,12 @@ const healthCheckJob = new LuaJob({
       const testQuery = await Data.get('health-checks', {}, 1, 1);
       checks.database = {
         status: 'healthy',
-        responseTime: Date.now()
+        responseTime: Date.now(),
       };
     } catch (error) {
       checks.database = {
         status: 'unhealthy',
-        error: String(error)
+        error: String(error),
       };
     }
 
@@ -43,15 +43,15 @@ const healthCheckJob = new LuaJob({
       const startTime = Date.now();
       await Products.get(1, 1);
       const responseTime = Date.now() - startTime;
-      
+
       checks.productsApi = {
         status: 'healthy',
-        responseTime: `${responseTime}ms`
+        responseTime: `${responseTime}ms`,
       };
     } catch (error) {
       checks.productsApi = {
         status: 'unhealthy',
-        error: String(error)
+        error: String(error),
       };
     }
 
@@ -63,7 +63,7 @@ const healthCheckJob = new LuaJob({
     await Data.create('health-checks', {
       status: overallStatus,
       checks,
-      timestamp: new Date().toISOString()
+      timestamp: new Date().toISOString(),
     });
 
     // Alert if unhealthy (in production, send to monitoring service)
@@ -75,10 +75,9 @@ const healthCheckJob = new LuaJob({
     return {
       status: overallStatus,
       checks,
-      timestamp: new Date().toISOString()
+      timestamp: new Date().toISOString(),
     };
-  }
+  },
 });
 
 export default healthCheckJob;
-

package/template/examples/postprocessors/modifyResponse.ts

@@ -1,20 +1,19 @@
-import { PostProcessor, UserDataInstance } from "lua-cli";
-
+import { PostProcessor, UserDataInstance } from 'lua-cli';
 
 const modifyResponsePostProcessor = new PostProcessor({
-    name: "modify-response",
-    description: "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 { modifiedResponse: message.toUpperCase() };
-        }
-        return { modifiedResponse: response };
+  name: 'modify-response',
+  description: '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 { modifiedResponse: message.toUpperCase() };
     }
+    return { modifiedResponse: response };
+  },
 });
 
-export default modifyResponsePostProcessor;
+export default modifyResponsePostProcessor;