lua-cli 3.12.2 → 3.14.0

package/template/examples/webhooks/FileUploadWebhook.ts

@@ -1,37 +1,39 @@
 /**
  * File Upload Webhook
- * 
+ *
  * Receives file uploads from external systems and stores them in the CDN.
- * 
+ *
  * Use cases:
  * - Customer uploads documents via your website form
  * - Integration with document management systems
  * - Receiving images/files from third-party services
- * 
+ *
  * Webhook URL: https://webhook.heylua.ai/{agentId}/file-upload
  */
 
-import { LuaWebhook, CDN, Data, User } from "lua-cli";
-import { z } from "zod";
+import { LuaWebhook, CDN, Data, User } from 'lua-cli';
+import { z } from 'zod';
 
 const fileUploadWebhook = new LuaWebhook({
-  name: "file-upload",
-  description: "Receives file uploads and stores them in CDN",
+  name: 'file-upload',
+  description: 'Receives file uploads and stores them in CDN',
 
   headerSchema: z.object({
     'content-type': z.string(),
-    'x-api-key': z.string().optional()
+    'x-api-key': z.string().optional(),
   }),
 
   bodySchema: z.object({
     filename: z.string(),
     contentType: z.string(),
-    data: z.string().describe("Base64 encoded file data"),
-    metadata: z.object({
-      category: z.string().optional(),
-      description: z.string().optional(),
-      tags: z.array(z.string()).optional()
-    }).optional()
+    data: z.string().describe('Base64 encoded file data'),
+    metadata: z
+      .object({
+        category: z.string().optional(),
+        description: z.string().optional(),
+        tags: z.array(z.string()).optional(),
+      })
+      .optional(),
   }),
 
   execute: async (event: any) => {
@@ -51,24 +53,30 @@ const fileUploadWebhook = new LuaWebhook({
     console.log(`✅ File stored with ID: ${fileId}`);
 
     // Store file metadata in custom data for later retrieval
-    const fileRecord = await Data.create('uploaded-files', {
-      fileId: fileId,
-      filename: body.filename,
-      contentType: body.contentType,
-      size: file.size,
-      category: body.metadata?.category || 'uncategorized',
-      description: body.metadata?.description,
-      tags: body.metadata?.tags || [],
-      uploadedAt: new Date().toISOString()
-    }, `${body.filename} ${body.metadata?.category || ''} ${body.metadata?.tags?.join(' ') || ''}`);
+    const fileRecord = await Data.create(
+      'uploaded-files',
+      {
+        fileId: fileId,
+        filename: body.filename,
+        contentType: body.contentType,
+        size: file.size,
+        category: body.metadata?.category || 'uncategorized',
+        description: body.metadata?.description,
+        tags: body.metadata?.tags || [],
+        uploadedAt: new Date().toISOString(),
+      },
+      `${body.filename} ${body.metadata?.category || ''} ${body.metadata?.tags?.join(' ') || ''}`
+    );
 
     // Notify user about the upload
     const user = await User.get();
     if (user) {
-      await user.send([{
-        type: "text",
-        text: `📁 New file uploaded: ${body.filename}`
-      }]);
+      await user.send([
+        {
+          type: 'text',
+          text: `📁 New file uploaded: ${body.filename}`,
+        },
+      ]);
     }
 
     return {
@@ -77,10 +85,9 @@ const fileUploadWebhook = new LuaWebhook({
       recordId: fileRecord.id,
       filename: body.filename,
       size: file.size,
-      message: 'File uploaded and stored successfully'
+      message: 'File uploaded and stored successfully',
     };
-  }
+  },
 });
 
 export default fileUploadWebhook;
-

package/template/examples/webhooks/PaymentWebhook.ts

@@ -1,44 +1,46 @@
 /**
  * Payment Webhook Example
- * 
+ *
  * This webhook receives payment notifications from payment providers (Stripe, PayPal, etc.).
  * It validates signatures, processes payment events, and updates order status.
- * 
+ *
  * Common use case: Stripe webhook for payment confirmations
- * 
+ *
  * Webhook URLs:
  *   https://webhook.heylua.ai/{agentId}/{webhookId}
  *   https://webhook.heylua.ai/{agentId}/{webhook-name}
  */
 
-import { LuaWebhook, Orders, Data } from "lua-cli";
-import { z } from "zod";
+import { LuaWebhook, Orders, Data } from 'lua-cli';
+import { z } from 'zod';
 
 const paymentWebhook = new LuaWebhook({
-  name: "payment-notifications",
-  description: "Receives payment notifications from payment providers",
+  name: 'payment-notifications',
+  description: 'Receives payment notifications from payment providers',
 
   // Headers typically include webhook signature for verification
   headerSchema: z.object({
     'stripe-signature': z.string().optional(),
-    'content-type': z.string()
+    'content-type': z.string(),
   }),
 
   // Payment event body
   bodySchema: z.object({
-    type: z.string(),  // e.g., 'payment_intent.succeeded'
+    type: z.string(), // e.g., 'payment_intent.succeeded'
     data: z.object({
       object: z.object({
         id: z.string(),
         amount: z.number(),
         currency: z.string(),
         status: z.string(),
-        metadata: z.object({
-          orderId: z.string().optional(),
-          customerId: z.string().optional()
-        }).optional()
-      })
-    })
+        metadata: z
+          .object({
+            orderId: z.string().optional(),
+            customerId: z.string().optional(),
+          })
+          .optional(),
+      }),
+    }),
   }),
 
   execute: async (event: any) => {
@@ -76,14 +78,14 @@ const paymentWebhook = new LuaWebhook({
         orderId: payment.metadata?.orderId,
         customerId: payment.metadata?.customerId,
         status: 'succeeded',
-        receivedAt: new Date().toISOString()
+        receivedAt: new Date().toISOString(),
       });
 
       return {
         success: true,
         paymentId: payment.id,
         orderId: payment.metadata?.orderId,
-        message: 'Payment processed successfully'
+        message: 'Payment processed successfully',
       };
     }
 
@@ -94,23 +96,22 @@ const paymentWebhook = new LuaWebhook({
       await Data.create('payment-logs', {
         paymentId: payment.id,
         status: 'failed',
-        receivedAt: new Date().toISOString()
+        receivedAt: new Date().toISOString(),
       });
 
       return {
         success: true,
         paymentId: payment.id,
-        message: 'Payment failure logged'
+        message: 'Payment failure logged',
       };
     }
 
     // Other event types
     return {
       success: true,
-      message: `Event ${eventType} received`
+      message: `Event ${eventType} received`,
     };
-  }
+  },
 });
 
 export default paymentWebhook;
-

package/template/examples/webhooks/UserEventWebhook.ts

@@ -1,32 +1,32 @@
 /**
  * User Event Webhook Example
- * 
+ *
  * This webhook receives user events from external systems (e.g., CRM, marketing tools).
  * It validates incoming data, stores events for processing, and can send template
  * messages using the Templates API (currently supports WhatsApp templates).
- * 
+ *
  * Webhook URLs:
  *   https://webhook.heylua.ai/{agentId}/{webhookId}
  *   https://webhook.heylua.ai/{agentId}/{webhook-name}
  */
 
-import { LuaWebhook, Data, Templates } from "lua-cli";
-import { z } from "zod";
+import { LuaWebhook, Data, Templates } from 'lua-cli';
+import { z } from 'zod';
 
 const userEventWebhook = new LuaWebhook({
-  name: "user-events",
-  description: "Receives user events from external systems",
+  name: 'user-events',
+  description: 'Receives user events from external systems',
 
   // Validate query parameters (optional source tracking)
   querySchema: z.object({
     source: z.string().optional(),
-    version: z.string().optional()
+    version: z.string().optional(),
   }),
 
   // Validate headers (require API key for security)
   headerSchema: z.object({
     'x-api-key': z.string(),
-    'content-type': z.string().optional()
+    'content-type': z.string().optional(),
   }),
 
   // Validate request body
@@ -38,7 +38,7 @@ const userEventWebhook = new LuaWebhook({
     phoneNumber: z.string().optional(),
     channelId: z.string().optional(),
     metadata: z.record(z.any()).optional(),
-    timestamp: z.string()
+    timestamp: z.string(),
   }),
 
   execute: async (event: any) => {
@@ -57,12 +57,10 @@ const userEventWebhook = new LuaWebhook({
       ...body,
       source: query?.source,
       receivedAt: new Date().toISOString(),
-      processed: false
+      processed: false,
     };
 
-    const result = await Data.create('user-events', eventData, 
-      `${body?.eventType} ${body?.email} ${body?.name || ''}`
-    );
+    const result = await Data.create('user-events', eventData, `${body?.eventType} ${body?.email} ${body?.name || ''}`);
 
     console.log('✅ Event stored successfully:', result.id);
 
@@ -74,14 +72,14 @@ const userEventWebhook = new LuaWebhook({
         // Search for a welcome template
         const response = await Templates.whatsapp.list(body.channelId, { search: 'welcome' });
         const welcomeTemplate = response.templates.find((t: any) => t.status === 'APPROVED');
-        
+
         if (welcomeTemplate) {
           // Send the template message
           templateResult = await Templates.whatsapp.send(body.channelId, welcomeTemplate.id, {
             phoneNumbers: [body.phoneNumber],
             values: {
-              body: { name: body.name || 'there' }
-            }
+              body: { name: body.name || 'there' },
+            },
           });
           console.log('📱 Welcome template sent:', templateResult.results[0]?.messages[0]?.id);
         }
@@ -96,10 +94,9 @@ const userEventWebhook = new LuaWebhook({
       eventId: result.id,
       userId: body?.userId,
       templateSent: templateResult?.totalErrors === 0,
-      timestamp: new Date().toISOString()
+      timestamp: new Date().toISOString(),
     };
-  }
+  },
 });
 
 export default userEventWebhook;
-

package/template/lua.skill.yaml

@@ -1,6 +1,6 @@
 agent:
-  agentId: ""
-  orgId: ""
+  agentId: ''
+  orgId: ''
 
 # State-only manifest (managed by the CLI)
 skills: []

package/template/package.json

@@ -20,7 +20,7 @@
     "inquirer": "^12.9.6",
     "stripe": "^17.5.0",
     "js-yaml": "^4.1.0",
-    "lua-cli": "^3.12.2",
+    "lua-cli": "^3.14.0",
     "openai": "^5.23.0",
     "uuid": "^13.0.0",
     "zod": "^3.24.1"

package/template/src/index.ts

@@ -1,49 +1,49 @@
-import { LuaAgent } from "lua-cli";
+import { LuaAgent } from 'lua-cli';
 
 /**
  * Your Lua AI Agent
- * 
+ *
  * This is a minimal agent ready for you to customize.
  * Add skills, webhooks, jobs, and processors as needed.
- * 
+ *
  * Quick start:
  *   1. Create a tool in src/skills/tools/MyTool.ts
  *   2. Create a skill in src/skills/my.skill.ts
  *   3. Import and add it to the skills array below
  *   4. Run `lua test` to test your tool
  *   5. Run `lua chat` to chat with your agent
- * 
+ *
  * Need examples? Run `lua init --with-examples` in a new project
  * or see: https://docs.heylua.ai/examples
  */
 const agent = new LuaAgent({
-    name: ``,      // Set during lua init
-    persona: ``,   // Set during lua init
-    
-    // Add your skills here
-    skills: [],
-    
-    // Optional: Add webhooks for external integrations
-    // webhooks: [],
-    
-    // Optional: Add scheduled jobs
-    // jobs: [],
-    
-    // Optional: Add message preprocessors
-    // preProcessors: [],
-    
-    // Optional: Add response postprocessors
-    // postProcessors: [],
+  name: ``, // Set during lua init
+  persona: ``, // Set during lua init
+
+  // Add your skills here
+  skills: [],
+
+  // Optional: Add webhooks for external integrations
+  // webhooks: [],
+
+  // Optional: Add scheduled jobs
+  // jobs: [],
+
+  // Optional: Add message preprocessors
+  // preProcessors: [],
+
+  // Optional: Add response postprocessors
+  // postProcessors: [],
 });
 
 async function main() {
-    // Your agent is ready!
-    // 
-    // Next steps:
-    // 1. Create your first skill with tools
-    // 2. Run `lua test` to test tools interactively
-    // 3. Run `lua chat` to chat with your agent
-    // 4. Run `lua push` to deploy
+  // Your agent is ready!
+  //
+  // Next steps:
+  // 1. Create your first skill with tools
+  // 2. Run `lua test` to test tools interactively
+  // 3. Run `lua chat` to chat with your agent
+  // 4. Run `lua push` to deploy
 }
 
 main().catch(console.error);