lua-cli 3.13.0 → 3.14.0

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

@@ -1,49 +1,48 @@
-import { AI, LuaTool, User, Jobs, JobInstance } from "lua-cli";
-import { z } from "zod";
-
+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({ });
+  name = 'get_user_data';
+  description = 'Get the user data for a given user id';
+  inputSchema = z.object({});
 
-    constructor() {}
+  constructor() {}
 
-    async execute(input: z.infer<typeof this.inputSchema>) {
-        const user = await User.get();
-        return {
-            success: true,
-            message: "User data retrieved",
-            data: user.data,
-            name: user.name,
-            age: user.age
-        };
-    }
+  async execute(input: z.infer<typeof this.inputSchema>) {
+    const user = await User.get();
+    return {
+      success: true,
+      message: 'User data retrieved',
+      data: user.data,
+      name: user.name,
+      age: user.age,
+    };
+  }
 }
 
 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()
-        })
-    });
+  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() {}
+  constructor() {}
 
-    async execute(input: z.infer<typeof this.inputSchema>) {
-        const user = await User.get(); //get instance of user
-        user.name = input.data.name;
-        user.age = input.data.age;
-        await user.save();
-        // await user.send([{ type: "text", text: "Hello, how are you?" }]);
-        return {
-            success: true,
-            message: "User data updated"
-        };
-    }
+  async execute(input: z.infer<typeof this.inputSchema>) {
+    const user = await User.get(); //get instance of user
+    user.name = input.data.name;
+    user.age = input.data.age;
+    await user.save();
+    // await user.send([{ type: "text", text: "Hello, how are you?" }]);
+    return {
+      success: true,
+      message: 'User data updated',
+    };
+  }
 }
 
 /**
@@ -51,72 +50,72 @@ export class UpdateUserDataTool implements LuaTool {
  * Useful for analyzing past interactions or providing context.
  */
 export class GetChatHistoryTool implements LuaTool {
-    name = "get_chat_history";
-    description = "Get the conversation history for the current user";
-    inputSchema = z.object({
-        limit: z.number().optional().describe("Maximum number of messages to retrieve")
-    });
+  name = 'get_chat_history';
+  description = 'Get the conversation history for the current user';
+  inputSchema = z.object({
+    limit: z.number().optional().describe('Maximum number of messages to retrieve'),
+  });
+
+  async execute(input: z.infer<typeof this.inputSchema>) {
+    const history = await User.getChatHistory();
 
-    async execute(input: z.infer<typeof this.inputSchema>) {
-        const history = await User.getChatHistory();
-        
-        // Optionally limit the results
-        const messages = input.limit ? history.slice(-input.limit) : history;
-        
-        // Format the history for easier reading
-        const formattedHistory = messages.map(msg => ({
-            role: msg.role,
-            content: msg.content,
-            createdAt: msg.createdAt,
-            id: msg.id
-        }));
-        
-        return {
-            success: true,
-            totalMessages: history.length,
-            returnedMessages: messages.length,
-            history: formattedHistory
-        };
-    }
+    // Optionally limit the results
+    const messages = input.limit ? history.slice(-input.limit) : history;
+
+    // Format the history for easier reading
+    const formattedHistory = messages.map((msg) => ({
+      role: msg.role,
+      content: msg.content,
+      createdAt: msg.createdAt,
+      id: msg.id,
+    }));
+
+    return {
+      success: true,
+      totalMessages: history.length,
+      returnedMessages: messages.length,
+      history: formattedHistory,
+    };
+  }
 }
 
 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 }]);
-    }
+  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()
+  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' };
+      },
     });
-    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 };
-    }
-}
+    return { success: true, job: job };
+  }
+}

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

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

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.13.0",
+    "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);