lua-cli 3.1.0-alpha.3 → 3.1.0-alpha.5

package/dist/api/lazy-instances.js

@@ -12,6 +12,8 @@ import CustomDataApiService from "./custom.data.api.service.js";
 import WebhookApi from "./webhook.api.service.js";
 import JobApi from "./job.api.service.js";
 import ChatApi from "./chat.api.service.js";
+import WhatsAppTemplatesApiService from "./whatsapp-templates.api.service.js";
+import CdnApi from "./cdn.api.service.js";
 /**
  * Singleton instances (lazy-loaded)
  */
@@ -23,6 +25,8 @@ let _orderInstance = null;
 let _webhookInstance = null;
 let _jobInstance = null;
 let _chatInstance = null;
+let _whatsAppTemplatesInstance = null;
+let _cdnInstance = null;
 /**
  * Gets or creates User Data API instance.
  * Instance is created once and reused for subsequent calls.
@@ -127,6 +131,32 @@ export async function getChatInstance() {
     }
     return _chatInstance;
 }
+/**
+ * Gets or creates Templates API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns WhatsAppTemplatesApiService instance
+ */
+export async function getWhatsAppTemplatesInstance() {
+    if (!_whatsAppTemplatesInstance) {
+        const creds = await getCredentials();
+        _whatsAppTemplatesInstance = new WhatsAppTemplatesApiService(BASE_URLS.API, creds.apiKey, creds.agentId);
+    }
+    return _whatsAppTemplatesInstance;
+}
+/**
+ * Gets or creates CDN API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns CdnApi instance
+ */
+export async function getCdnInstance() {
+    if (!_cdnInstance) {
+        const creds = await getCredentials();
+        _cdnInstance = new CdnApi(BASE_URLS.CDN, creds.apiKey);
+    }
+    return _cdnInstance;
+}
 /**
  * Clears all cached API instances.
  * Useful for testing or when credentials change.
@@ -140,4 +170,6 @@ export function clearAllInstances() {
     _webhookInstance = null;
     _jobInstance = null;
     _chatInstance = null;
+    _whatsAppTemplatesInstance = null;
+    _cdnInstance = null;
 }

package/dist/api/postprocessor.api.service.d.ts

@@ -14,7 +14,6 @@ export interface GetPostProcessorsResponse {
         id: string;
         name: string;
         description?: string;
-        context?: string;
         versions: PostProcessorVersion[];
         activeVersionId?: string;
     }>;
@@ -23,8 +22,8 @@ export interface CreatePostProcessorResponse {
     id: string;
     name: string;
     description?: string;
+    priority: number;
     agentId: string;
-    context?: string;
 }
 export interface PostProcessorVersionResponse {
     versionId: string;
@@ -55,29 +54,24 @@ export default class PostProcessorApi extends HttpClient {
     createPostProcessor(data: {
         name: string;
         description?: string;
-        context?: string;
     }): Promise<ApiResponse<CreatePostProcessorResponse>>;
     /**
      * Pushes a new version of a postprocessor
      *
      * @param postprocessorId - The postprocessor ID
-     * @param versionData - Version data including code, description, context, and async flag
+     * @param versionData - Version data including code and description
      * @param versionData.version - Version number
      * @param versionData.code - Compressed execute function code
      * @param versionData.executeFunction - Raw execute function code
      * @param versionData.description - Postprocessor description
-     * @param versionData.context - Postprocessor context
-     * @param versionData.async - Async execution flag (true = background, false = blocking)
      */
     pushPostProcessor(postprocessorId: string, versionData: {
         name: string;
         version: string;
         description?: string;
-        context?: string;
         postprocessorId: string;
         code: string;
         executeFunction: string;
-        async?: boolean;
     }): Promise<ApiResponse<PostProcessorVersionResponse>>;
     /**
      * Retrieves all versions of a specific postprocessor
@@ -118,17 +112,15 @@ export default class PostProcessorApi extends HttpClient {
      * Creates a new sandbox version for testing without affecting production
      *
      * @param postprocessorId - The postprocessor ID
-     * @param versionData - Version data including code and async flag
+     * @param versionData - Version data including code
      * @returns Sandbox version response with sandboxId
      */
     pushDevPostProcessor(postprocessorId: string, versionData: {
         name: string;
         version?: string;
         description?: string;
-        context?: string;
         code: string;
         executeFunction: string;
-        async?: boolean;
     }): Promise<ApiResponse<{
         versionId: string;
         postprocessorId: string;
@@ -147,10 +139,8 @@ export default class PostProcessorApi extends HttpClient {
         name: string;
         version?: string;
         description?: string;
-        context?: string;
         code: string;
         executeFunction: string;
-        async?: boolean;
     }): Promise<ApiResponse<{
         message: string;
         versionId: string;

package/dist/api/postprocessor.api.service.js

@@ -29,13 +29,11 @@ export default class PostProcessorApi extends HttpClient {
      * Pushes a new version of a postprocessor
      *
      * @param postprocessorId - The postprocessor ID
-     * @param versionData - Version data including code, description, context, and async flag
+     * @param versionData - Version data including code and description
      * @param versionData.version - Version number
      * @param versionData.code - Compressed execute function code
      * @param versionData.executeFunction - Raw execute function code
      * @param versionData.description - Postprocessor description
-     * @param versionData.context - Postprocessor context
-     * @param versionData.async - Async execution flag (true = background, false = blocking)
      */
     async pushPostProcessor(postprocessorId, versionData) {
         return this.httpPost(`/developer/postprocessors/${this.agentId}/${postprocessorId}/version`, versionData, {
@@ -87,7 +85,7 @@ export default class PostProcessorApi extends HttpClient {
      * Creates a new sandbox version for testing without affecting production
      *
      * @param postprocessorId - The postprocessor ID
-     * @param versionData - Version data including code and async flag
+     * @param versionData - Version data including code
      * @returns Sandbox version response with sandboxId
      */
     async pushDevPostProcessor(postprocessorId, versionData) {

package/dist/api/preprocessor.api.service.d.ts

@@ -14,7 +14,6 @@ export interface GetPreProcessorsResponse {
         id: string;
         name: string;
         description?: string;
-        context?: string;
         versions: PreProcessorVersion[];
         activeVersionId?: string;
     }>;
@@ -24,7 +23,6 @@ export interface CreatePreProcessorResponse {
     name: string;
     description?: string;
     agentId: string;
-    context?: string;
 }
 export interface PreProcessorVersionResponse {
     versionId: string;
@@ -55,25 +53,22 @@ export default class PreProcessorApi extends HttpClient {
     createPreProcessor(data: {
         name: string;
         description?: string;
-        context?: string;
     }): Promise<ApiResponse<CreatePreProcessorResponse>>;
     /**
      * Pushes a new version of a preprocessor
      *
      * @param preprocessorId - The preprocessor ID
-     * @param versionData - Version data including code, description, context, and async flag
+     * @param versionData - Version data including code, description, and async flag
      * @param versionData.version - Version number
      * @param versionData.code - Compressed execute function code
      * @param versionData.executeFunction - Raw execute function code
      * @param versionData.description - Preprocessor description
-     * @param versionData.context - Preprocessor context
      * @param versionData.async - Async execution flag (true = background, false = blocking)
      */
     pushPreProcessor(preprocessorId: string, versionData: {
         name: string;
         version: string;
         description?: string;
-        context?: string;
         preprocessorId: string;
         code: string;
         executeFunction: string;
@@ -125,7 +120,6 @@ export default class PreProcessorApi extends HttpClient {
         name: string;
         version?: string;
         description?: string;
-        context?: string;
         code: string;
         executeFunction: string;
         async?: boolean;
@@ -147,7 +141,6 @@ export default class PreProcessorApi extends HttpClient {
         name: string;
         version?: string;
         description?: string;
-        context?: string;
         code: string;
         executeFunction: string;
         async?: boolean;

package/dist/api/preprocessor.api.service.js

@@ -29,12 +29,11 @@ export default class PreProcessorApi extends HttpClient {
      * Pushes a new version of a preprocessor
      *
      * @param preprocessorId - The preprocessor ID
-     * @param versionData - Version data including code, description, context, and async flag
+     * @param versionData - Version data including code, description, and async flag
      * @param versionData.version - Version number
      * @param versionData.code - Compressed execute function code
      * @param versionData.executeFunction - Raw execute function code
      * @param versionData.description - Preprocessor description
-     * @param versionData.context - Preprocessor context
      * @param versionData.async - Async execution flag (true = background, false = blocking)
      */
     async pushPreProcessor(preprocessorId, versionData) {

package/dist/api/webhook.api.service.d.ts

@@ -15,7 +15,6 @@ export interface GetWebhooksResponse {
         id: string;
         name: string;
         description?: string;
-        context?: string;
         versions: WebhookVersion[];
         activeVersionId?: string;
     }>;
@@ -25,7 +24,6 @@ export interface CreateWebhookResponse {
     name: string;
     description?: string;
     agentId: string;
-    context?: string;
 }
 export interface WebhookVersionResponse {
     versionId: string;
@@ -66,7 +64,7 @@ export default class WebhookApi extends HttpClient {
     getWebhooks(): Promise<ApiResponse<GetWebhooksResponse>>;
     /**
      * Creates a new webhook for the agent
-     * @param webhookData - The webhook data including name, description, and optional context
+     * @param webhookData - The webhook data including name and description
      * @returns Promise resolving to an ApiResponse containing the created webhook details
      * @throws Error if the webhook creation fails or validation errors occur
      */

package/dist/api/webhook.api.service.js

@@ -27,7 +27,7 @@ export default class WebhookApi extends HttpClient {
     }
     /**
      * Creates a new webhook for the agent
-     * @param webhookData - The webhook data including name, description, and optional context
+     * @param webhookData - The webhook data including name and description
      * @returns Promise resolving to an ApiResponse containing the created webhook details
      * @throws Error if the webhook creation fails or validation errors occur
      */

package/dist/api/whatsapp-templates.api.service.d.ts

@@ -0,0 +1,40 @@
+import { HttpClient } from "../common/http.client.js";
+import { WhatsAppTemplatesAPI } from "../types/index.js";
+import { WhatsAppTemplate, PaginatedTemplatesResponse, ListTemplatesOptions, SendTemplateData, SendTemplateResponse } from "../interfaces/whatsapp-templates.js";
+/**
+ * WhatsApp Templates API Service
+ * Handles WhatsApp template operations
+ */
+export default class WhatsAppTemplatesApiService extends HttpClient implements WhatsAppTemplatesAPI {
+    private apiKey;
+    private agentId;
+    /**
+     * Creates an instance of WhatsAppTemplatesApiService
+     * @param baseUrl - The base URL for the API
+     * @param apiKey - The API key for authentication
+     * @param agentId - The unique identifier of the agent
+     */
+    constructor(baseUrl: string, apiKey: string, agentId: string);
+    /**
+     * Lists WhatsApp templates for a channel with optional pagination and search
+     * @param channelId - The WhatsApp channel identifier
+     * @param options - Optional pagination and search options
+     * @returns Promise resolving to paginated templates response
+     */
+    list(channelId: string, options?: ListTemplatesOptions): Promise<PaginatedTemplatesResponse>;
+    /**
+     * Gets a specific WhatsApp template by ID
+     * @param channelId - The WhatsApp channel identifier
+     * @param templateId - The template identifier
+     * @returns Promise resolving to the template
+     */
+    get(channelId: string, templateId: string): Promise<WhatsAppTemplate>;
+    /**
+     * Sends a WhatsApp template message to one or more phone numbers
+     * @param channelId - The WhatsApp channel identifier
+     * @param templateId - The template identifier
+     * @param data - Send data including phone numbers and template values
+     * @returns Promise resolving to the send response with results and errors
+     */
+    send(channelId: string, templateId: string, data: SendTemplateData): Promise<SendTemplateResponse>;
+}

package/dist/api/whatsapp-templates.api.service.js

@@ -0,0 +1,78 @@
+import { HttpClient } from "../common/http.client.js";
+/**
+ * WhatsApp Templates API Service
+ * Handles WhatsApp template operations
+ */
+export default class WhatsAppTemplatesApiService extends HttpClient {
+    /**
+     * Creates an instance of WhatsAppTemplatesApiService
+     * @param baseUrl - The base URL for the API
+     * @param apiKey - The API key for authentication
+     * @param agentId - The unique identifier of the agent
+     */
+    constructor(baseUrl, apiKey, agentId) {
+        super(baseUrl);
+        this.apiKey = apiKey;
+        this.agentId = agentId;
+    }
+    /**
+     * Lists WhatsApp templates for a channel with optional pagination and search
+     * @param channelId - The WhatsApp channel identifier
+     * @param options - Optional pagination and search options
+     * @returns Promise resolving to paginated templates response
+     */
+    async list(channelId, options) {
+        const page = options?.page ?? 1;
+        const limit = options?.limit ?? 10;
+        const search = options?.search;
+        let url = `/admin/agents/${this.agentId}/channels/${channelId}/whatsapp-templates?page=${page}&limit=${limit}`;
+        if (search) {
+            url += `&search=${encodeURIComponent(search)}`;
+        }
+        const response = await this.httpGet(url, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return response.data;
+        }
+        throw new Error(response.error?.message || 'Failed to list templates');
+    }
+    /**
+     * Gets a specific WhatsApp template by ID
+     * @param channelId - The WhatsApp channel identifier
+     * @param templateId - The template identifier
+     * @returns Promise resolving to the template
+     */
+    async get(channelId, templateId) {
+        const url = `/admin/agents/${this.agentId}/channels/${channelId}/whatsapp-templates/${templateId}`;
+        const response = await this.httpGet(url, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return response.data;
+        }
+        throw new Error(response.error?.message || 'Failed to get template');
+    }
+    /**
+     * Sends a WhatsApp template message to one or more phone numbers
+     * @param channelId - The WhatsApp channel identifier
+     * @param templateId - The template identifier
+     * @param data - Send data including phone numbers and template values
+     * @returns Promise resolving to the send response with results and errors
+     */
+    async send(channelId, templateId, data) {
+        const url = `/admin/agents/${this.agentId}/channels/${channelId}/whatsapp-templates/${templateId}/trigger`;
+        // Transform to API format (phoneNumbers -> phone_numbers)
+        const body = {
+            phone_numbers: data.phoneNumbers,
+            values: data.values,
+        };
+        const response = await this.httpPost(url, body, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return response.data;
+        }
+        throw new Error(response.error?.message || 'Failed to send template');
+    }
+}

package/dist/api-exports.d.ts

@@ -26,7 +26,7 @@
  * const products = await Products.search('laptop');
  * ```
  */
-import { LuaSkill, LuaTool, LuaWebhook, LuaWebhookConfig, LuaJob, LuaJobConfig, JobSchedule, PreProcessor, PreProcessorConfig, PostProcessor, PostProcessorConfig, LuaAgent, LuaAgentConfig, env } from "./types/skill.js";
+import { LuaSkill, LuaTool, LuaWebhook, LuaWebhookConfig, LuaJob, LuaJobConfig, JobSchedule, PreProcessor, PreProcessorConfig, PreProcessorAction, PreProcessorResult, PreProcessorBlockResponse, PreProcessorProceedResponse, PostProcessor, PostProcessorConfig, PostProcessorResponse, LuaAgent, LuaAgentConfig, LuaMCPServer, LuaMCPServerConfig, MCPStdioServerConfig, MCPSSEServerConfig, MCPTransport, MCPServerBaseConfig, env } from "./types/skill.js";
 import { Basket, BasketStatus, UpdateBasketMetadataResponse } from "./interfaces/baskets.js";
 import { OrderResponse, OrderStatus } from "./interfaces/orders.js";
 import { ChatHistoryMessage, ChatHistoryContent, ChatMessage, TextMessage, ImageMessage, FileMessage, PreProcessorOverride, PostProcessorOverride } from "./interfaces/chat.js";
@@ -40,6 +40,7 @@ import { DeleteCustomDataResponse, GetCustomDataResponse, UpdateCustomDataRespon
 import UserDataInstance from "./common/user.instance.js";
 import BasketInstance from "./common/basket.instance.js";
 import OrderInstance from "./common/order.instance.js";
+import { WhatsAppTemplate, PaginatedTemplatesResponse, ListTemplatesOptions, SendTemplateData, SendTemplateResponse } from "./interfaces/whatsapp-templates.js";
 export declare const User: {
     /**
      * Retrieves current user data.
@@ -76,7 +77,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<DataEntryInstance>;
+    create(collectionName: string, data: Record<string, any>, searchText?: string): Promise<DataEntryInstance>;
     /**
      * Retrieves entries from a collection with optional filtering and pagination.
      *
@@ -100,10 +101,11 @@ export declare const Data: {
      *
      * @param collectionName - Name of the collection
      * @param entryId - ID of the entry to update
-     * @param data - Updated data
-     * @returns Promise resolving to updated entry
+     * @param data - Updated data fields to merge with existing entry
+     * @param searchText - Optional new search text for vector search indexing
+     * @returns Promise resolving to update response
      */
-    update(collectionName: string, entryId: string, data: any): Promise<UpdateCustomDataResponse>;
+    update(collectionName: string, entryId: string, data: Record<string, any>, searchText?: string): Promise<UpdateCustomDataResponse>;
     /**
      * Performs vector search on a collection.
      *
@@ -359,6 +361,24 @@ export declare const Jobs: {
      * @throws Error if the job is not found or the request fails
      */
     getJob(jobId: string): Promise<JobInstance>;
+    /**
+     * Retrieves all jobs for the current agent
+     * @param options - Optional configuration
+     * @param options.includeDynamic - Include dynamically created jobs (default: false)
+     * @returns Promise resolving to an array of JobInstance
+     *
+     * @example
+     * ```typescript
+     * // Get all jobs including dynamically created ones
+     * const jobs = await Jobs.getAll({ includeDynamic: true });
+     * for (const job of jobs) {
+     *   console.log(job.name, job.data.active ? 'active' : 'inactive');
+     * }
+     * ```
+     */
+    getAll(options?: {
+        includeDynamic?: boolean;
+    }): Promise<JobInstance[]>;
 };
 /**
  * AI API
@@ -401,6 +421,133 @@ export declare const AI: {
      */
     generate(context: string, messages: import("./interfaces/chat.js").ChatMessage[], agentId?: string): Promise<string>;
 };
-export { LuaSkill, LuaTool, LuaWebhook, LuaWebhookConfig, LuaJob, LuaJobConfig, JobSchedule, PreProcessor, PreProcessorConfig, PostProcessor, PostProcessorConfig, LuaAgent, LuaAgentConfig, BasketStatus, OrderStatus, env };
+/**
+ * Templates API
+ *
+ * Manage templates across different channel types.
+ * Use the appropriate namespace for your template type:
+ *
+ * - `Templates.whatsapp` - WhatsApp Business templates
+ *
+ * @example
+ * ```typescript
+ * // List WhatsApp templates
+ * const result = await Templates.whatsapp.list(channelId);
+ *
+ * // Send a WhatsApp template
+ * await Templates.whatsapp.send(channelId, templateId, {
+ *   phoneNumbers: ['+447551166594'],
+ *   values: { body: { name: 'John' } }
+ * });
+ * ```
+ */
+export declare const Templates: {
+    /**
+     * WhatsApp Templates
+     *
+     * Pre-approved message formats for WhatsApp Business Accounts.
+     * Required for initiating conversations outside the 24-hour messaging window.
+     */
+    whatsapp: {
+        /**
+         * Lists WhatsApp templates for a channel with optional pagination and search.
+         *
+         * @param channelId - The WhatsApp channel identifier
+         * @param options - Optional pagination and search options
+         * @returns Promise resolving to paginated templates response
+         *
+         * @example
+         * ```typescript
+         * const result = await Templates.whatsapp.list(channelId);
+         * const filtered = await Templates.whatsapp.list(channelId, { search: 'order' });
+         * const paginated = await Templates.whatsapp.list(channelId, { page: 2, limit: 20 });
+         * ```
+         */
+        list(channelId: string, options?: ListTemplatesOptions): Promise<PaginatedTemplatesResponse>;
+        /**
+         * Gets a specific WhatsApp template by ID.
+         *
+         * @param channelId - The WhatsApp channel identifier
+         * @param templateId - The template identifier
+         * @returns Promise resolving to the template
+         *
+         * @example
+         * ```typescript
+         * const template = await Templates.whatsapp.get(channelId, 'template_123');
+         * ```
+         */
+        get(channelId: string, templateId: string): Promise<WhatsAppTemplate>;
+        /**
+         * Sends a WhatsApp template message to one or more phone numbers.
+         *
+         * @param channelId - The WhatsApp channel identifier
+         * @param templateId - The template identifier
+         * @param data - Send data including phone numbers and template values
+         * @returns Promise resolving to the send response with results and errors
+         *
+         * @example
+         * ```typescript
+         * const result = await Templates.whatsapp.send(channelId, 'template_123', {
+         *   phoneNumbers: ['+447551166594'],
+         *   values: {
+         *     body: { first_name: 'John', order_number: '12345' }
+         *   }
+         * });
+         * ```
+         */
+        send(channelId: string, templateId: string, data: SendTemplateData): Promise<SendTemplateResponse>;
+    };
+};
+/**
+ * CDN API
+ * Upload and retrieve files from the Lua CDN
+ */
+export declare const CDN: {
+    /**
+     * Uploads a file to the CDN.
+     *
+     * @param file - The File object to upload
+     * @returns Promise resolving to the file ID
+     *
+     * @example
+     * ```typescript
+     * import { CDN } from 'lua-cli';
+     * import { readFileSync } from 'fs';
+     *
+     * const buffer = readFileSync('image.png');
+     * const file = new File([buffer], 'image.png', { type: 'image/png' });
+     * const fileId = await CDN.upload(file);
+     * console.log('Uploaded file ID:', fileId);
+     * ```
+     */
+    upload(file: File): Promise<string>;
+    /**
+     * Retrieves a file from the CDN by its ID.
+     *
+     * @param fileId - The unique identifier of the file
+     * @returns Promise resolving to a File object
+     *
+     * @example
+     * ```typescript
+     * import { CDN, AI } from 'lua-cli';
+     *
+     * const file = await CDN.get('abc123-def456');
+     * console.log(file.name, file.type, file.size);
+     *
+     * // Use with AI API for image analysis
+     * const buffer = Buffer.from(await file.arrayBuffer());
+     * const response = await AI.generate(
+     *   'You are an image analysis expert.',
+     *   [
+     *     { type: 'text', text: 'What do you see in this image?' },
+     *     { type: 'image', image: buffer, mediaType: file.type }
+     *   ]
+     * );
+     * ```
+     */
+    get(fileId: string): Promise<File>;
+};
+export { LuaSkill, LuaTool, LuaWebhook, LuaWebhookConfig, LuaJob, LuaJobConfig, JobSchedule, PreProcessor, PreProcessorConfig, PreProcessorAction, PreProcessorResult, PreProcessorBlockResponse, PreProcessorProceedResponse, PostProcessor, PostProcessorConfig, PostProcessorResponse, LuaAgent, LuaAgentConfig, LuaMCPServer, LuaMCPServerConfig, MCPStdioServerConfig, MCPSSEServerConfig, MCPTransport, MCPServerBaseConfig, BasketStatus, OrderStatus, env };
 export { JobInstance, UserDataInstance, DataEntryInstance, ProductInstance, BasketInstance, OrderInstance };
 export { ChatHistoryMessage, ChatHistoryContent, ChatMessage, TextMessage, ImageMessage, FileMessage, PreProcessorOverride, PostProcessorOverride };
+export { WhatsAppTemplate, PaginatedTemplatesResponse, ListTemplatesOptions, SendTemplateData, SendTemplateResponse, WhatsAppTemplateCategory, WhatsAppTemplateStatus, WhatsAppTemplateComponent, SendTemplateValues } from "./interfaces/whatsapp-templates.js";