lua-cli 3.0.0-alpha.9 → 3.0.0

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);
-    }
-}