lua-cli 2.5.8 → 3.0.0-alpha.1

package/dist/api-exports.d.ts

@@ -26,20 +26,42 @@
  * const products = await Products.search('laptop');
  * ```
  */
-import { LuaSkill, LuaTool, env } from "./types/skill.js";
-import { BasketStatus } from "./interfaces/baskets.js";
-import { OrderStatus } from "./interfaces/orders.js";
-/**
- * User Data API
- * Access user information and preferences
- */
+import { LuaSkill, LuaTool, LuaWebhook, LuaWebhookConfig, LuaJob, LuaJobConfig, JobSchedule, PreProcessor, PreProcessorConfig, PostProcessor, PostProcessorConfig, LuaAgent, LuaAgentConfig, env } from "./types/skill.js";
+import { Basket, BasketStatus, UpdateBasketMetadataResponse } from "./interfaces/baskets.js";
+import { OrderResponse, OrderStatus } from "./interfaces/orders.js";
+import { ChatHistoryMessage, ChatHistoryContent } from "./interfaces/chat.js";
+import { JobInstance } from "./common/job.instance.js";
+import { DeleteProductResponse, Product } from "./interfaces/product.js";
+import ProductInstance from "./common/product.instance.js";
+import ProductPaginationInstance from "./common/product.pagination.instance.js";
+import ProductSearchInstance from "./common/product.search.instance.js";
+import DataEntryInstance from "./common/data.entry.instance.js";
+import { DeleteCustomDataResponse, GetCustomDataResponse, UpdateCustomDataResponse } from "./interfaces/custom.data.js";
+import UserDataInstance from "./common/user.instance.js";
+import BasketInstance from "./common/basket.instance.js";
+import OrderInstance from "./common/order.instance.js";
 export declare const User: {
     /**
      * Retrieves current user data.
      *
      * @returns Promise resolving to user data
      */
-    get(): Promise<import("./common/user.instance.js").default>;
+    get(): Promise<UserDataInstance>;
+    /**
+     * Gets the chat history for the current user.
+     *
+     * @returns Promise resolving to array of chat messages
+     *
+     * @example
+     * ```typescript
+     * const history = await User.getChatHistory();
+     * // Returns: [
+     * //   { role: 'user', content: [{type: 'text', text: 'hello'}], createdAt: '...', id: '...', threadId: '...' },
+     * //   { role: 'assistant', content: [{type: 'text', text: 'hi'}], createdAt: '...', id: '...', threadId: '...' }
+     * // ]
+     * ```
+     */
+    getChatHistory(): Promise<import("./interfaces/chat.js").ChatHistoryMessage[]>;
 };
 /**
  * Custom Data API
@@ -54,7 +76,7 @@ export declare const Data: {
      * @param searchText - Optional text for vector search indexing
      * @returns Promise resolving to created entry
      */
-    create(collectionName: string, data: any, searchText?: string): Promise<import("./common/data.entry.instance.js").default>;
+    create(collectionName: string, data: any, searchText?: string): Promise<DataEntryInstance>;
     /**
      * Retrieves entries from a collection with optional filtering and pagination.
      *
@@ -64,7 +86,7 @@ export declare const Data: {
      * @param limit - Items per page (default: 10)
      * @returns Promise resolving to array of entries
      */
-    get(collectionName: string, filter?: any, page?: number, limit?: number): Promise<import("./interfaces/custom.data.js").GetCustomDataResponse>;
+    get(collectionName: string, filter?: any, page?: number, limit?: number): Promise<GetCustomDataResponse>;
     /**
      * Retrieves a specific entry by ID.
      *
@@ -72,7 +94,7 @@ export declare const Data: {
      * @param entryId - ID of the entry
      * @returns Promise resolving to entry data
      */
-    getEntry(collectionName: string, entryId: string): Promise<import("./common/data.entry.instance.js").default>;
+    getEntry(collectionName: string, entryId: string): Promise<DataEntryInstance>;
     /**
      * Updates an existing entry.
      *
@@ -81,7 +103,7 @@ export declare const Data: {
      * @param data - Updated data
      * @returns Promise resolving to updated entry
      */
-    update(collectionName: string, entryId: string, data: any): Promise<import("./interfaces/custom.data.js").UpdateCustomDataResponse>;
+    update(collectionName: string, entryId: string, data: any): Promise<UpdateCustomDataResponse>;
     /**
      * Performs vector search on a collection.
      *
@@ -91,7 +113,7 @@ export declare const Data: {
      * @param scoreThreshold - Minimum similarity score (0-1)
      * @returns Promise resolving to search results
      */
-    search(collectionName: string, searchText: string, limit?: number, scoreThreshold?: number): Promise<import("./common/data.entry.instance.js").default[]>;
+    search(collectionName: string, searchText: string, limit?: number, scoreThreshold?: number): Promise<DataEntryInstance[]>;
     /**
      * Deletes an entry from a collection.
      *
@@ -99,7 +121,7 @@ export declare const Data: {
      * @param entryId - ID of the entry to delete
      * @returns Promise resolving when deletion is complete
      */
-    delete(collectionName: string, entryId: string): Promise<import("./interfaces/custom.data.js").DeleteCustomDataResponse>;
+    delete(collectionName: string, entryId: string): Promise<DeleteCustomDataResponse>;
 };
 /**
  * Products API
@@ -113,43 +135,35 @@ export declare const Products: {
      * @param page - Page number
      * @returns Promise resolving to product list
      */
-    get(limit?: number, page?: number): Promise<import("./common/product.pagination.instance.js").default>;
+    get(limit?: number, page?: number): Promise<ProductPaginationInstance>;
     /**
      * Creates a new product.
      *
      * @param product - Product data
      * @returns Promise resolving to created product
      */
-    create(product: any): Promise<import("./common/product.instance.js").default>;
-    /**
-     * Updates an existing product.
-     *
-     * @param data - Updated product data
-     * @param id - Product ID
-     * @returns Promise resolving to updated product
-     */
-    update(data: any, id: string): Promise<import("./interfaces/product.js").UpdateProductResponse>;
+    create(product: Product): Promise<ProductInstance>;
     /**
      * Deletes a product.
      *
      * @param id - Product ID
      * @returns Promise resolving when deletion is complete
      */
-    delete(id: string): Promise<import("./interfaces/product.js").DeleteProductResponse>;
+    delete(id: string): Promise<DeleteProductResponse>;
     /**
      * Searches products by query string.
      *
      * @param query - Search query
      * @returns Promise resolving to search results
      */
-    search(query: string): Promise<import("./common/product.search.instance.js").default>;
+    search(query: string): Promise<ProductSearchInstance>;
     /**
      * Retrieves a specific product by ID.
      *
      * @param id - Product ID
      * @returns Promise resolving to product data
      */
-    getById(id: string): Promise<import("./common/product.instance.js").default>;
+    getById(id: string): Promise<ProductInstance>;
 };
 /**
  * Baskets API
@@ -162,14 +176,14 @@ export declare const Baskets: {
      * @param basketData - Basket initialization data
      * @returns Promise resolving to created basket
      */
-    create(basketData: any): Promise<import("./common/basket.instance.js").default>;
+    create(basketData: any): Promise<BasketInstance>;
     /**
      * Retrieves baskets, optionally filtered by status.
      *
      * @param status - Optional basket status filter
      * @returns Promise resolving to basket list
      */
-    get(status?: any): Promise<import("./common/basket.instance.js").default[]>;
+    get(status?: any): Promise<BasketInstance[]>;
     /**
      * Adds an item to a basket.
      *
@@ -177,7 +191,7 @@ export declare const Baskets: {
      * @param itemData - Item data to add
      * @returns Promise resolving to updated basket
      */
-    addItem(basketId: string, itemData: any): Promise<import("./interfaces/baskets.js").Basket>;
+    addItem(basketId: string, itemData: any): Promise<Basket>;
     /**
      * Removes an item from a basket.
      *
@@ -185,14 +199,14 @@ export declare const Baskets: {
      * @param itemId - Item ID to remove
      * @returns Promise resolving to updated basket
      */
-    removeItem(basketId: string, itemId: string): Promise<import("./interfaces/baskets.js").Basket>;
+    removeItem(basketId: string, itemId: string): Promise<Basket>;
     /**
      * Clears all items from a basket.
      *
      * @param basketId - Basket ID
      * @returns Promise resolving to cleared basket
      */
-    clear(basketId: string): Promise<import("./interfaces/baskets.js").Basket>;
+    clear(basketId: string): Promise<Basket>;
     /**
      * Updates basket status.
      *
@@ -208,7 +222,7 @@ export declare const Baskets: {
      * @param metadata - Metadata to update
      * @returns Promise resolving to updated basket
      */
-    updateMetadata(basketId: string, metadata: any): Promise<import("./interfaces/baskets.js").UpdateBasketMetadataResponse>;
+    updateMetadata(basketId: string, metadata: any): Promise<UpdateBasketMetadataResponse>;
     /**
      * Converts basket to order.
      *
@@ -216,14 +230,14 @@ export declare const Baskets: {
      * @param basketId - Basket ID to convert
      * @returns Promise resolving to created order
      */
-    placeOrder(data: Record<string, any>, basketId: string): Promise<import("./common/order.instance.js").default>;
+    placeOrder(data: Record<string, any>, basketId: string): Promise<OrderInstance>;
     /**
      * Retrieves a specific basket by ID.
      *
      * @param basketId - Basket ID
      * @returns Promise resolving to basket data
      */
-    getById(basketId: string): Promise<import("./common/basket.instance.js").default>;
+    getById(basketId: string): Promise<BasketInstance>;
 };
 /**
  * Orders API
@@ -236,7 +250,7 @@ export declare const Orders: {
      * @param orderData - Order data
      * @returns Promise resolving to created order
      */
-    create(orderData: any): Promise<import("./common/order.instance.js").default>;
+    create(orderData: any): Promise<OrderInstance>;
     /**
      * Updates order status.
      *
@@ -244,7 +258,7 @@ export declare const Orders: {
      * @param orderId - Order ID
      * @returns Promise resolving to updated order
      */
-    updateStatus(status: any, orderId: string): Promise<import("./interfaces/orders.js").OrderResponse>;
+    updateStatus(status: any, orderId: string): Promise<OrderResponse>;
     /**
      * Updates order data.
      *
@@ -252,20 +266,121 @@ export declare const Orders: {
      * @param orderId - Order ID
      * @returns Promise resolving to updated order
      */
-    updateData(data: Record<string, any>, orderId: string): Promise<import("./interfaces/orders.js").OrderResponse>;
+    updateData(data: Record<string, any>, orderId: string): Promise<OrderResponse>;
     /**
      * Retrieves orders, optionally filtered by status.
      *
      * @param status - Optional order status filter
      * @returns Promise resolving to order list
      */
-    get(status?: any): Promise<import("./common/order.instance.js").default[]>;
+    get(status?: any): Promise<OrderInstance[]>;
     /**
      * Retrieves a specific order by ID.
      *
      * @param orderId - Order ID
      * @returns Promise resolving to order data
      */
-    getById(orderId: string): Promise<import("./common/order.instance.js").default>;
+    getById(orderId: string): Promise<OrderInstance>;
+};
+/**
+ * Jobs API
+ * Manage and trigger scheduled jobs from within your tools
+ */
+export declare const Jobs: {
+    /**
+     * Creates a new job dynamically from within a tool.
+     * This allows tools to schedule one-time or recurring jobs programmatically.
+     *
+     * @param config - Job configuration
+     * @param config.name - Unique job name
+     * @param config.description - Job description
+     * @param config.schedule - Schedule configuration (cron, once, or interval)
+     * @param config.execute - Async function to execute
+     * @param config.timeout - Optional timeout in seconds
+     * @param config.retry - Optional retry configuration
+     * @returns Promise resolving to created job details
+     *
+     * @example
+     * ```typescript
+     * // Create a one-time job to check basket in 3 hours
+     * await Jobs.create({
+     *   name: `check-basket-${basketId}`,
+     *   description: 'Check if basket was abandoned',
+     *   schedule: {
+     *     type: 'once',
+     *     executeAt: new Date(Date.now() + 3 * 60 * 60 * 1000)
+     *   },
+     *   execute: async () => {
+     *     const basket = await Baskets.getById(basketId);
+     *     if (basket.status === 'active') {
+     *       // Send reminder
+     *     }
+     *     return { checked: true };
+     *   }
+     * });
+     * ```
+     */
+    create(config: {
+        name: string;
+        description?: string;
+        schedule: any;
+        execute: (job: JobInstance) => Promise<any>;
+        timeout?: number;
+        retry?: {
+            maxAttempts: number;
+            backoffSeconds?: number;
+        };
+        metadata?: Record<string, any>;
+    }): Promise<JobInstance>;
+    /**
+     * Retrieves a job by its unique identifier
+     * @param jobId - The unique identifier of the job to retrieve
+     * @returns Promise resolving to an JobInstance representing the job
+     * @throws Error if the job is not found or the request fails
+     */
+    getJob(jobId: string): Promise<JobInstance>;
+};
+/**
+ * AI API
+ * Generate AI responses with custom context
+ */
+export declare const AI: {
+    /**
+     * Generates an AI response with custom runtime context.
+     *
+     * @param context - Runtime context to provide to the AI
+     * @param messages - Array of messages (text, image, file, etc.)
+     * @param agentId - Optional agent ID to use (defaults to current agent)
+     * @returns Promise resolving to AI response text
+     *
+     * @example
+     * ```typescript
+     * // Simple text message with current agent
+     * const response = await AI.generate(
+     *   'You are a helpful sales assistant for our e-commerce store.',
+     *   [{ type: 'text', text: 'What products do you recommend for beginners?' }]
+     * );
+     * console.log(response); // AI-generated recommendation
+     *
+     * // Multiple messages with images
+     * const response2 = await AI.generate(
+     *   'You are an image analysis expert.',
+     *   [
+     *     { type: 'text', text: 'What do you see in this image?' },
+     *     { type: 'image', url: 'https://example.com/image.jpg' }
+     *   ]
+     * );
+     *
+     * // Use a different agent
+     * const response3 = await AI.generate(
+     *   'You are a specialized assistant.',
+     *   [{ type: 'text', text: 'Help me with this task' }],
+     *   'agent_different_123'
+     * );
+     * ```
+     */
+    generate(context: string, messages: import("./interfaces/chat.js").ChatMessage[], agentId?: string): Promise<string>;
 };
-export { LuaSkill, LuaTool, BasketStatus, OrderStatus, env };
+export { LuaSkill, LuaTool, LuaWebhook, LuaWebhookConfig, LuaJob, LuaJobConfig, JobSchedule, PreProcessor, PreProcessorConfig, PostProcessor, PostProcessorConfig, LuaAgent, LuaAgentConfig, BasketStatus, OrderStatus, env };
+export { JobInstance };
+export { ChatHistoryMessage, ChatHistoryContent };

package/dist/api-exports.js

@@ -26,17 +26,11 @@
  * const products = await Products.search('laptop');
  * ```
  */
-import { LuaSkill, env } from "./types/skill.js";
+import { LuaSkill, LuaWebhook, LuaJob, PreProcessor, PostProcessor, LuaAgent, env } from "./types/skill.js";
 import { BasketStatus } from "./interfaces/baskets.js";
 import { OrderStatus } from "./interfaces/orders.js";
-import { getUserInstance, getDataInstance, getProductsInstance, getBasketsInstance, getOrderInstance, } from "./api/lazy-instances.js";
-// ============================================================================
-// USER DATA API
-// ============================================================================
-/**
- * User Data API
- * Access user information and preferences
- */
+import { getUserInstance, getDataInstance, getProductsInstance, getBasketsInstance, getOrderInstance, getJobInstance, getChatInstance, } from "./api/lazy-instances.js";
+import { JobInstance } from "./common/job.instance.js";
 export const User = {
     /**
      * Retrieves current user data.
@@ -46,6 +40,24 @@ export const User = {
     async get() {
         const instance = await getUserInstance();
         return instance.get();
+    },
+    /**
+     * Gets the chat history for the current user.
+     *
+     * @returns Promise resolving to array of chat messages
+     *
+     * @example
+     * ```typescript
+     * const history = await User.getChatHistory();
+     * // Returns: [
+     * //   { role: 'user', content: [{type: 'text', text: 'hello'}], createdAt: '...', id: '...', threadId: '...' },
+     * //   { role: 'assistant', content: [{type: 'text', text: 'hi'}], createdAt: '...', id: '...', threadId: '...' }
+     * // ]
+     * ```
+     */
+    async getChatHistory() {
+        const instance = await getUserInstance();
+        return instance.getChatHistory();
     }
 };
 // ============================================================================
@@ -158,17 +170,6 @@ export const Products = {
         const instance = await getProductsInstance();
         return instance.create(product);
     },
-    /**
-     * Updates an existing product.
-     *
-     * @param data - Updated product data
-     * @param id - Product ID
-     * @returns Promise resolving to updated product
-     */
-    async update(data, id) {
-        const instance = await getProductsInstance();
-        return instance.update(data, id);
-    },
     /**
      * Deletes a product.
      *
@@ -366,7 +367,167 @@ export const Orders = {
     }
 };
 // ============================================================================
+// JOBS API
+// ============================================================================
+/**
+ * Jobs API
+ * Manage and trigger scheduled jobs from within your tools
+ */
+export const Jobs = {
+    /**
+     * Creates a new job dynamically from within a tool.
+     * This allows tools to schedule one-time or recurring jobs programmatically.
+     *
+     * @param config - Job configuration
+     * @param config.name - Unique job name
+     * @param config.description - Job description
+     * @param config.schedule - Schedule configuration (cron, once, or interval)
+     * @param config.execute - Async function to execute
+     * @param config.timeout - Optional timeout in seconds
+     * @param config.retry - Optional retry configuration
+     * @returns Promise resolving to created job details
+     *
+     * @example
+     * ```typescript
+     * // Create a one-time job to check basket in 3 hours
+     * await Jobs.create({
+     *   name: `check-basket-${basketId}`,
+     *   description: 'Check if basket was abandoned',
+     *   schedule: {
+     *     type: 'once',
+     *     executeAt: new Date(Date.now() + 3 * 60 * 60 * 1000)
+     *   },
+     *   execute: async () => {
+     *     const basket = await Baskets.getById(basketId);
+     *     if (basket.status === 'active') {
+     *       // Send reminder
+     *     }
+     *     return { checked: true };
+     *   }
+     * });
+     * ```
+     */
+    async create(config) {
+        const instance = await getJobInstance();
+        // Convert the execute function to a string
+        const executeString = config.execute.toString();
+        // Step 1: Create the job
+        const createResult = await instance.createJobInstance({
+            name: config.name,
+            description: config.description,
+            context: config.description || '',
+            schedule: config.schedule,
+            timeout: config.timeout,
+            retry: config.retry,
+            metadata: config.metadata
+        });
+        const jobId = createResult.jobId;
+        // Step 2: Push the initial version with execute function
+        const pushResult = await instance.pushJob(jobId, {
+            name: config.name,
+            version: '1.0.0',
+            description: config.description,
+            context: config.description || '',
+            jobId: jobId,
+            schedule: config.schedule,
+            timeout: config.timeout,
+            retry: config.retry,
+            executeFunction: executeString,
+            metadata: config.metadata
+        });
+        if (!pushResult.success) {
+            throw new Error(`Failed to push job version: ${pushResult.error?.message}`);
+        }
+        // Step 3: Activate the job so it starts running
+        const activateResult = await instance.activateJob(jobId);
+        if (!activateResult.success) {
+            console.warn(`Job created but activation failed: ${activateResult.error?.message}`);
+        }
+        // Step 4: Return a JobInstance for easy manipulation
+        return new JobInstance(instance, {
+            id: jobId,
+            jobId: jobId,
+            name: config.name,
+            schedule: config.schedule,
+            metadata: config.metadata || {},
+            active: activateResult.success
+        });
+    },
+    /**
+     * Retrieves a job by its unique identifier
+     * @param jobId - The unique identifier of the job to retrieve
+     * @returns Promise resolving to an JobInstance representing the job
+     * @throws Error if the job is not found or the request fails
+     */
+    async getJob(jobId) {
+        const instance = await getJobInstance();
+        return instance.getJob(jobId);
+    }
+};
+// ============================================================================
+// AI GENERATION API
+// ============================================================================
+/**
+ * AI API
+ * Generate AI responses with custom context
+ */
+export const AI = {
+    /**
+     * Generates an AI response with custom runtime context.
+     *
+     * @param context - Runtime context to provide to the AI
+     * @param messages - Array of messages (text, image, file, etc.)
+     * @param agentId - Optional agent ID to use (defaults to current agent)
+     * @returns Promise resolving to AI response text
+     *
+     * @example
+     * ```typescript
+     * // Simple text message with current agent
+     * const response = await AI.generate(
+     *   'You are a helpful sales assistant for our e-commerce store.',
+     *   [{ type: 'text', text: 'What products do you recommend for beginners?' }]
+     * );
+     * console.log(response); // AI-generated recommendation
+     *
+     * // Multiple messages with images
+     * const response2 = await AI.generate(
+     *   'You are an image analysis expert.',
+     *   [
+     *     { type: 'text', text: 'What do you see in this image?' },
+     *     { type: 'image', url: 'https://example.com/image.jpg' }
+     *   ]
+     * );
+     *
+     * // Use a different agent
+     * const response3 = await AI.generate(
+     *   'You are a specialized assistant.',
+     *   [{ type: 'text', text: 'Help me with this task' }],
+     *   'agent_different_123'
+     * );
+     * ```
+     */
+    async generate(context, messages, agentId) {
+        const chatInstance = await getChatInstance();
+        const { getCredentials } = await import('./api/credentials.js');
+        const credentials = await getCredentials();
+        // Use provided agentId or default to current agent
+        const targetAgentId = agentId || 'luaAgent';
+        const result = await chatInstance.sendMessage(targetAgentId, {
+            messages,
+            navigate: false,
+            skillOverride: [],
+            runtimeContext: context
+        });
+        if (!result.success) {
+            throw new Error(result.error?.message || 'AI generation failed');
+        }
+        return result.data?.text || '';
+    }
+};
+// ============================================================================
 // EXPORTS
 // ============================================================================
 // Export skill classes and utilities
-export { LuaSkill, BasketStatus, OrderStatus, env };
+export { LuaSkill, LuaWebhook, LuaJob, PreProcessor, PostProcessor, LuaAgent, BasketStatus, OrderStatus, env };
+// Export instance classes
+export { JobInstance };