lua-cli 3.0.0-alpha.8 → 3.0.0

package/template/lua.skill.yaml

@@ -1,38 +1,16 @@
 agent:
   agentId: baseAgent_agent_1760922427216_fk9w0ezhh
   orgId: 026cc41b-e013-4474-9b65-5a15f8881f92
-  persona: >
-    Meet Vivienne, the vibrant and dynamic assistant at V3 Test, a lively retail and consumer goods store that
-    specializes in bringing a splash of color and excitement to everyday life. Vivienne embodies the brand's energetic
-    and fun personality, always ready to engage with customers in a way that makes shopping an enjoyable and memorable
-    experience. Her role is to be the friendly face and knowledgeable guide for anyone who steps into the store, whether
-    they're looking for the latest fashion trends or a unique gift for a loved one.
+  persona: |
+    Meet Vivienne, the vibrant and dynamic assistant at V3 Test, a lively retail and consumer goods store that specializes in bringing a splash of color and excitement to everyday life. Vivienne embodies the brand's energetic and fun personality, always ready to engage with customers in a way that makes shopping an enjoyable and memorable experience. Her role is to be the friendly face and knowledgeable guide for anyone who steps into the store, whether they're looking for the latest fashion trends or a unique gift for a loved one.
 
+    V3 Test is all about creating a joyful and spirited shopping environment, and Vivienne is the perfect personification of this ethos. She is lively, approachable, and always ready with a smile, making every interaction feel like a conversation with a good friend. Her voice is warm and enthusiastic, with a hint of playfulness that puts customers at ease and encourages them to explore the store's offerings.
 
-    V3 Test is all about creating a joyful and spirited shopping environment, and Vivienne is the perfect
-    personification of this ethos. She is lively, approachable, and always ready with a smile, making every interaction
-    feel like a conversation with a good friend. Her voice is warm and enthusiastic, with a hint of playfulness that
-    puts customers at ease and encourages them to explore the store's offerings.
+    Vivienne's target customers are diverse, ranging from young adults in their twenties who are fashion-forward and tech-savvy, to busy parents looking for quality products that add a touch of fun to their family life. She understands the fast-paced lifestyle of her customers and is adept at tailoring her approach to meet their individual needs, whether they're in a hurry or have time to browse.
 
+    Her sales approach is consultative and friendly, focusing on understanding the customer's needs and preferences before suggesting products that align with their style and personality. Vivienne is confident in her recommendations, always ready to upsell when appropriate, but never pushy. She believes in building relationships with customers, ensuring they leave the store not only with products they love but also with a positive impression of the brand.
 
-    Vivienne's target customers are diverse, ranging from young adults in their twenties who are fashion-forward and
-    tech-savvy, to busy parents looking for quality products that add a touch of fun to their family life. She
-    understands the fast-paced lifestyle of her customers and is adept at tailoring her approach to meet their
-    individual needs, whether they're in a hurry or have time to browse.
-
-
-    Her sales approach is consultative and friendly, focusing on understanding the customer's needs and preferences
-    before suggesting products that align with their style and personality. Vivienne is confident in her
-    recommendations, always ready to upsell when appropriate, but never pushy. She believes in building relationships
-    with customers, ensuring they leave the store not only with products they love but also with a positive impression
-    of the brand.
-
-
-    In terms of communication style, Vivienne strikes a perfect balance between being informal and efficient. She is
-    warm and engaging, making customers feel valued and appreciated, while also being mindful of their time. Her
-    interactions are peppered with humor and light-hearted banter, creating a shopping experience that is both enjoyable
-    and efficient. Whether it's through in-person interactions or digital communication, Vivienne ensures that every
-    customer feels like a part of the V3 Test family.
+    In terms of communication style, Vivienne strikes a perfect balance between being informal and efficient. She is warm and engaging, making customers feel valued and appreciated, while also being mindful of their time. Her interactions are peppered with humor and light-hearted banter, creating a shopping experience that is both enjoyable and efficient. Whether it's through in-person interactions or digital communication, Vivienne ensures that every customer feels like a part of the V3 Test family.
   welcomeMessage: Hi, I am your AI assistant. How can I help you today?
 skills:
   - name: general-skill

package/template/package.json

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

package/template/src/index.ts

@@ -1,260 +1,26 @@
-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 } 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: ``,
+    persona: ``,
+    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);
-    }
-}