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

package/dist/common/data.entry.instance.js

@@ -122,12 +122,12 @@ export default class DataEntryInstance {
      */
     async update(data, searchText) {
         try {
-            const response = await this.customDataAPI.update(this.collectionName, this.id, { data, searchText });
+            await this.customDataAPI.update(this.collectionName, this.id, data, searchText);
             this.data = { ...this.data, ...data };
             return this.data;
         }
         catch (error) {
-            throw new Error('Failed to update user data');
+            throw new Error('Failed to update custom data entry');
         }
     }
     /**
@@ -141,7 +141,7 @@ export default class DataEntryInstance {
             return true;
         }
         catch (error) {
-            throw new Error('Failed to clear user data');
+            throw new Error('Failed to delete custom data entry');
         }
     }
     /**
@@ -152,7 +152,7 @@ export default class DataEntryInstance {
      */
     async save(searchText) {
         try {
-            await this.customDataAPI.update(this.collectionName, this.id, { data: this.data, searchText: searchText });
+            await this.customDataAPI.update(this.collectionName, this.id, this.data, searchText);
             return true;
         }
         catch (error) {

package/dist/common/job.instance.d.ts

@@ -101,6 +101,30 @@ export declare class JobInstance {
      * ```
      */
     trigger(versionId?: string): Promise<JobExecution>;
+    /**
+     * Activates the job, enabling it to run on schedule.
+     *
+     * @returns Promise resolving to updated JobInstance
+     *
+     * @example
+     * ```typescript
+     * await job.activate();
+     * console.log('Job is now active');
+     * ```
+     */
+    activate(): Promise<JobInstance>;
+    /**
+     * Deactivates the job, preventing it from running on schedule.
+     *
+     * @returns Promise resolving to updated JobInstance
+     *
+     * @example
+     * ```typescript
+     * await job.deactivate();
+     * console.log('Job is now inactive');
+     * ```
+     */
+    deactivate(): Promise<JobInstance>;
     /**
      * Converts the job instance to JSON.
      */

package/dist/common/job.instance.js

@@ -126,6 +126,44 @@ export class JobInstance {
         }
         return result.data;
     }
+    /**
+     * Activates the job, enabling it to run on schedule.
+     *
+     * @returns Promise resolving to updated JobInstance
+     *
+     * @example
+     * ```typescript
+     * await job.activate();
+     * console.log('Job is now active');
+     * ```
+     */
+    async activate() {
+        const result = await this.jobApi.activateJob(this.id);
+        if (!result.success || !result.data) {
+            throw new Error(result.error?.message || 'Failed to activate job');
+        }
+        this._data = result.data;
+        return this;
+    }
+    /**
+     * Deactivates the job, preventing it from running on schedule.
+     *
+     * @returns Promise resolving to updated JobInstance
+     *
+     * @example
+     * ```typescript
+     * await job.deactivate();
+     * console.log('Job is now inactive');
+     * ```
+     */
+    async deactivate() {
+        const result = await this.jobApi.deactivateJob(this.id);
+        if (!result.success || !result.data) {
+            throw new Error(result.error?.message || 'Failed to deactivate job');
+        }
+        this._data = result.data;
+        return this;
+    }
     /**
      * Converts the job instance to JSON.
      */

package/dist/config/constants.d.ts

@@ -9,4 +9,5 @@ export declare const BASE_URLS: {
     readonly AUTH: "https://auth.heylua.ai";
     readonly CHAT: "https://api.heylua.ai";
     readonly WEBHOOK: "https://webhook.heylua.ai";
+    readonly CDN: "https://cdn.heylua.ai";
 };

package/dist/config/constants.js

@@ -15,4 +15,5 @@ export const BASE_URLS = {
     AUTH: 'https://auth.heylua.ai',
     CHAT: 'https://api.heylua.ai',
     WEBHOOK: 'https://webhook.heylua.ai',
+    CDN: 'https://cdn.heylua.ai',
 };

package/dist/index.js

@@ -61,6 +61,7 @@ Examples:
   $ lua skills production  ⚙️  Manage production skills directly
   $ lua features           🎯 Manage agent features
   $ lua admin              🔧 Open admin dashboard
+  $ lua evals              📊 Open evaluations dashboard
   $ lua docs               📖 Open documentation
   $ lua completion         🎯 Enable shell autocomplete
   $ lua marketplace        🛍️  Interact with the Lua Marketplace

package/dist/interfaces/cdn.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CDN Interfaces
+ * Types for CDN asset upload and retrieval operations
+ */
+/**
+ * Internal response from the CDN upload endpoint
+ * @internal
+ */
+export interface CdnUploadResponse {
+    fileId: string;
+    mediaType: string;
+    extension: string;
+    originalFilename?: string;
+    compression?: CompressionStats;
+}
+/**
+ * Compression statistics for an uploaded asset
+ * @internal
+ */
+export interface CompressionStats {
+    original: number;
+    compressed: number;
+    ratio: number;
+}

package/dist/interfaces/cdn.js

@@ -0,0 +1,5 @@
+/**
+ * CDN Interfaces
+ * Types for CDN asset upload and retrieval operations
+ */
+export {};

package/dist/interfaces/compile.d.ts

@@ -8,4 +8,5 @@ export interface ToolInfo {
     description?: string;
     inputSchema?: any;
     executeCode?: string;
+    conditionCode?: string;
 }

package/dist/interfaces/custom.data.d.ts

@@ -14,7 +14,7 @@ import { Pagination, TimestampedEntity, IdentifiedEntity } from './common.js';
  */
 export interface CustomDataEntry extends IdentifiedEntity, TimestampedEntity {
     id: string;
-    data: any;
+    data: Record<string, any>;
     createdAt: number;
     updatedAt: number;
     searchText?: string;
@@ -31,7 +31,7 @@ export interface CustomDataEntry extends IdentifiedEntity, TimestampedEntity {
  * ```
  */
 export interface CreateCustomDataRequest {
-    data: any;
+    data: Record<string, any>;
     searchText?: string;
 }
 /**
@@ -53,7 +53,7 @@ export interface GetCustomDataResponse {
  * Request to update a custom data entry.
  */
 export interface UpdateCustomDataRequest {
-    data: any;
+    data: Record<string, any>;
     searchText?: string;
 }
 /**

package/dist/interfaces/index.d.ts

@@ -9,3 +9,4 @@ export { CreateJobDTO, PushJobVersionDTO, UpdateJobVersionDTO, JobSchedule, JobS
 export { ApiResponse, Pagination } from "./common.js";
 export { SkillTool, SkillVersion, Skill, GetSkillsResponse, DeleteSkillResponse, } from "./skills.js";
 export { ImmutableUserProfile, UserAgentData } from "./user.js";
+export { MCPServerResponse, MCPServerStdioResponse, MCPServerSSEResponse, CreateMCPServerRequest, UpdateMCPServerRequest, } from "./mcp.js";

package/dist/interfaces/mcp.d.ts

@@ -0,0 +1,64 @@
+/**
+ * MCP Server Interfaces
+ * API request/response types for MCP server management
+ */
+/**
+ * Base MCP Server response fields
+ */
+interface MCPServerResponseBase {
+    id: string;
+    name: string;
+    agentId: string;
+    active: boolean;
+    timeout?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * MCP Server response for stdio transport
+ */
+export interface MCPServerStdioResponse extends MCPServerResponseBase {
+    transport: 'stdio';
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+/**
+ * MCP Server response for SSE transport
+ */
+export interface MCPServerSSEResponse extends MCPServerResponseBase {
+    transport: 'sse';
+    url: string;
+    headers?: Record<string, string>;
+}
+/**
+ * Union type for MCP Server API responses
+ */
+export type MCPServerResponse = MCPServerStdioResponse | MCPServerSSEResponse;
+/**
+ * Request payload for creating an MCP server
+ */
+export interface CreateMCPServerRequest {
+    name: string;
+    transport: 'stdio' | 'sse';
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+/**
+ * Request payload for updating an MCP server
+ */
+export interface UpdateMCPServerRequest {
+    name?: string;
+    transport?: 'stdio' | 'sse';
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+export {};

package/dist/interfaces/mcp.js

@@ -0,0 +1,5 @@
+/**
+ * MCP Server Interfaces
+ * API request/response types for MCP server management
+ */
+export {};

package/dist/types/api-contracts.d.ts

@@ -1,4 +1,6 @@
 import { Message } from "../interfaces/message.js";
+import { GetCustomDataResponse, UpdateCustomDataResponse, DeleteCustomDataResponse } from "../interfaces/custom.data.js";
+import DataEntryInstance from "../common/data.entry.instance.js";
 /**
  * API Contract Interfaces
  * TypeScript interfaces that API service classes must implement
@@ -178,50 +180,52 @@ export interface CustomDataAPI {
     /**
      * Creates a new entry in a custom data collection.
      * @param collectionName - Collection name
-     * @param data - Data to store
-     * @returns Promise resolving to created entry
+     * @param data - Data object to store
+     * @param searchText - Optional text for vector search indexing
+     * @returns Promise resolving to created entry (DataEntryInstance)
      */
-    create(collectionName: string, data: any): Promise<any>;
+    create(collectionName: string, data: Record<string, any>, searchText?: string): Promise<DataEntryInstance>;
     /**
      * Gets entries from a collection with filtering and pagination.
      * @param collectionName - Collection name
      * @param filter - Optional filter criteria
      * @param page - Page number
      * @param limit - Items per page
-     * @returns Promise resolving to entries
+     * @returns Promise resolving to paginated entries
      */
-    get(collectionName: string, filter?: any, page?: number, limit?: number): Promise<any>;
+    get(collectionName: string, filter?: Record<string, any>, page?: number, limit?: number): Promise<GetCustomDataResponse>;
     /**
      * Gets a specific entry by ID.
      * @param collectionName - Collection name
      * @param entryId - Entry ID
-     * @returns Promise resolving to entry data
+     * @returns Promise resolving to entry (DataEntryInstance)
      */
-    getEntry(collectionName: string, entryId: string): Promise<any>;
+    getEntry(collectionName: string, entryId: string): Promise<DataEntryInstance>;
     /**
      * Updates an existing entry.
      * @param collectionName - Collection name
      * @param entryId - Entry ID
-     * @param data - Updated data
-     * @returns Promise resolving to updated entry
+     * @param data - Data object to update
+     * @param searchText - Optional text for vector search indexing
+     * @returns Promise resolving to update response
      */
-    update(collectionName: string, entryId: string, data: any): Promise<any>;
+    update(collectionName: string, entryId: string, data: Record<string, any>, searchText?: string): Promise<UpdateCustomDataResponse>;
     /**
      * Performs vector search on a collection.
      * @param collectionName - Collection name
      * @param searchText - Text to search for
      * @param limit - Maximum results
      * @param scoreThreshold - Minimum similarity score
-     * @returns Promise resolving to search results
+     * @returns Promise resolving to array of matching entries (DataEntryInstance[])
      */
-    search(collectionName: string, searchText: string, limit?: number, scoreThreshold?: number): Promise<any>;
+    search(collectionName: string, searchText: string, limit?: number, scoreThreshold?: number): Promise<DataEntryInstance[]>;
     /**
      * Deletes an entry from a collection.
      * @param collectionName - Collection name
      * @param entryId - Entry ID to delete
-     * @returns Promise resolving when deletion is complete
+     * @returns Promise resolving to delete response
      */
-    delete(collectionName: string, entryId: string): Promise<any>;
+    delete(collectionName: string, entryId: string): Promise<DeleteCustomDataResponse>;
 }
 /**
  * WhatsApp Templates API contract.
@@ -255,3 +259,21 @@ export interface WhatsAppTemplatesAPI {
      */
     send(channelId: string, templateId: string, data: any): Promise<any>;
 }
+/**
+ * CDN API contract.
+ * Defines operations for uploading and retrieving files from the CDN.
+ */
+export interface CdnAPI {
+    /**
+     * Uploads a file to the CDN.
+     * @param file - The File object to upload
+     * @returns Promise resolving to the file ID
+     */
+    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
+     */
+    get(fileId: string): Promise<File>;
+}

package/dist/types/compile.types.d.ts

@@ -81,6 +81,10 @@ export interface YamlConfigPostprocessor {
     version: string;
     postprocessorId: string;
 }
+export interface YamlConfigMCPServer {
+    name: string;
+    mcpServerId: string;
+}
 export interface YamlConfig {
     skill?: LegacyYamlConfigSkill;
     agent?: YamlConfigAgent;
@@ -89,6 +93,7 @@ export interface YamlConfig {
     jobs?: YamlConfigJob[];
     preprocessors?: YamlConfigPreprocessor[];
     postprocessors?: YamlConfigPostprocessor[];
+    mcpServers?: YamlConfigMCPServer[];
 }
 /**
  * Deployment data format for new deployment system

package/dist/types/index.d.ts

@@ -14,9 +14,9 @@
  * import { validateToolName } from './types/tool-validation.js';
  * ```
  */
-export { LuaSkill, LuaTool, LuaSkillConfig, LuaWebhook, LuaWebhookConfig, LuaJob, LuaJobConfig, JobSchedule, env } from './skill.js';
+export { LuaSkill, LuaTool, LuaSkillConfig, LuaWebhook, LuaWebhookConfig, LuaJob, LuaJobConfig, JobSchedule, env, LuaMCPServer, LuaMCPServerConfig, MCPStdioServerConfig, MCPSSEServerConfig, MCPTransport, MCPServerBaseConfig, } from './skill.js';
 export { validateToolName, assertValidToolName } from './tool-validation.js';
-export { UserDataAPI, ProductAPI, BasketAPI, OrderAPI, CustomDataAPI, WhatsAppTemplatesAPI } from './api-contracts.js';
+export { UserDataAPI, ProductAPI, BasketAPI, OrderAPI, CustomDataAPI, WhatsAppTemplatesAPI, CdnAPI } from './api-contracts.js';
 export { UserData, EmailAddress, Country, Admin, Organization, AgentAuth, OTPResponse, ApiKeyResponse } from '../interfaces/admin.js';
 export { Agent, AgentType, CreateAgentRequest, CreateAgentResponse, AgentDetailsResponse } from '../interfaces/agent.js';
 export { BasketStatus, BasketItem, Basket } from '../interfaces/baskets.js';

package/dist/types/index.js

@@ -18,7 +18,9 @@
 // SKILL SYSTEM EXPORTS
 // ============================================================================
 // Core skill classes and utilities
-export { LuaSkill, LuaWebhook, LuaJob, env } from './skill.js';
+export { LuaSkill, LuaWebhook, LuaJob, env, 
+// MCP Server config types (for defining servers)
+LuaMCPServer, } from './skill.js';
 // Tool validation utilities
 export { validateToolName, assertValidToolName } from './tool-validation.js';
 // Basket types

package/dist/types/skill.d.ts

@@ -47,6 +47,24 @@ export declare const env: (key: string) => string | undefined;
  *   }
  * };
  * ```
+ *
+ * @example
+ * ```typescript
+ * // Tool with condition - only available to premium users
+ * class PremiumSearchTool implements LuaTool {
+ *   name = "premium_search";
+ *   description = "Advanced search for premium users";
+ *   inputSchema = z.object({ query: z.string() });
+ *
+ *   // Condition runs before tool is offered to LLM
+ *   condition = async () => {
+ *     const user = await User.get();
+ *     return user.data?.isPremium === true;
+ *   };
+ *
+ *   execute = async (input) => { ... };
+ * }
+ * ```
  */
 export interface LuaTool<TInput extends ZodType = ZodType> {
     /** Unique tool name (alphanumeric, hyphens, underscores only) */
@@ -57,6 +75,8 @@ export interface LuaTool<TInput extends ZodType = ZodType> {
     inputSchema: TInput;
     /** Async function that executes the tool logic */
     execute: (input: any) => Promise<any>;
+    /** Optional async function that determines if the tool should be available */
+    condition?: () => Promise<boolean>;
 }
 /**
  * Lua Skill configuration.
@@ -504,6 +524,13 @@ export declare class PreProcessor {
     getPriority(): number;
     execute(user: UserDataInstance, messages: import("../interfaces/chat.js").ChatMessage[], channel: string): Promise<PreProcessorResult>;
 }
+/**
+ * PostProcessor response type.
+ * The execute function must return an object with the modified response.
+ */
+export interface PostProcessorResponse {
+    modifiedResponse: string;
+}
 /**
  * PostProcessor configuration.
  */
@@ -512,18 +539,11 @@ export interface PostProcessorConfig {
     name?: string;
     /** Short description of the postprocessor */
     description: string;
-    /**
-     * Async flag - indicates if processor should run in background on server:
-     * - true: Run asynchronously (non-blocking, for slow operations like API calls, translations)
-     * - false: Run synchronously (blocking, for fast operations like text formatting)
-     * Default: false (synchronous)
-     */
-    async?: boolean;
     /**
      * Function that processes the agent's response before sending to user.
-     * MUST return string - the formatted response text.
+     * MUST return { modifiedResponse: string } - the formatted response text.
      */
-    execute: (user: UserDataInstance, message: string, response: string, channel: string) => Promise<string>;
+    execute: (user: UserDataInstance, message: string, response: string, channel: string) => Promise<PostProcessorResponse>;
 }
 /**
  * PostProcessor class.
@@ -535,7 +555,7 @@ export interface PostProcessorConfig {
  *   name: 'response-formatter',
  *   description: 'Formats responses with branding',
  *   execute: async (user, message, response, channel) => {
- *     return response + '\n\n---\nPowered by Acme Corp';
+ *     return { modifiedResponse: response + '\n\n---\nPowered by Acme Corp' };
  *   }
  * });
  * ```
@@ -543,13 +563,95 @@ export interface PostProcessorConfig {
 export declare class PostProcessor {
     private readonly name;
     private readonly description;
-    private readonly asyncMode;
     private readonly executeFunction;
     constructor(config: PostProcessorConfig);
     getName(): string;
     getDescription(): string;
-    getAsync(): boolean;
-    execute(user: UserDataInstance, message: string, response: string, channel: string): Promise<string>;
+    execute(user: UserDataInstance, message: string, response: string, channel: string): Promise<PostProcessorResponse>;
+}
+/**
+ * MCP Server transport type - determines how to connect to the server.
+ */
+export type MCPTransport = 'stdio' | 'sse';
+/**
+ * Base configuration for all MCP servers.
+ */
+export interface MCPServerBaseConfig {
+    /** Unique identifier for this MCP server */
+    name: string;
+    /** Optional timeout in milliseconds (default: 60000) */
+    timeout?: number;
+}
+/**
+ * Configuration for stdio-based MCP servers (local execution via npx, node, etc.)
+ */
+export interface MCPStdioServerConfig extends MCPServerBaseConfig {
+    transport: 'stdio';
+    /** Command to execute (e.g., 'npx', 'node') */
+    command: string;
+    /** Arguments to pass to the command */
+    args?: string[];
+    /** Environment variables for the command */
+    env?: Record<string, string>;
+}
+/**
+ * Configuration for SSE/HTTP-based MCP servers (remote endpoints)
+ */
+export interface MCPSSEServerConfig extends MCPServerBaseConfig {
+    transport: 'sse';
+    /** URL of the MCP server endpoint */
+    url: string;
+    /** Optional headers to send with requests (e.g., Authorization) */
+    headers?: Record<string, string>;
+}
+/**
+ * Union type for all MCP server configurations.
+ */
+export type LuaMCPServerConfig = MCPStdioServerConfig | MCPSSEServerConfig;
+/**
+ * LuaMCPServer class.
+ * Defines an MCP (Model Context Protocol) server connection.
+ *
+ * MCP servers provide tools that can be used by your agent at runtime.
+ * You can connect to local servers (via stdio) or remote servers (via SSE/HTTP).
+ *
+ * @example
+ * ```typescript
+ * import { LuaMCPServer } from 'lua-cli';
+ *
+ * // Local MCP server via npx
+ * const wikipediaServer = new LuaMCPServer({
+ *   name: 'wikipedia',
+ *   transport: 'stdio',
+ *   command: 'npx',
+ *   args: ['-y', 'wikipedia-mcp'],
+ *   description: 'Wikipedia search and retrieval'
+ * });
+ *
+ * // Remote MCP server via SSE
+ * const weatherServer = new LuaMCPServer({
+ *   name: 'weather',
+ *   transport: 'sse',
+ *   url: 'https://api.example.com/mcp',
+ *   headers: {
+ *     'Authorization': 'Bearer ${env.WEATHER_API_KEY}'
+ *   },
+ *   description: 'Weather information service'
+ * });
+ * ```
+ */
+export declare class LuaMCPServer {
+    private readonly config;
+    constructor(config: LuaMCPServerConfig);
+    getName(): string;
+    getTransport(): MCPTransport;
+    getTimeout(): number | undefined;
+    getConfig(): LuaMCPServerConfig;
+    /**
+     * Returns the server configuration in a format suitable for serialization.
+     * Environment variable references (${env.VAR_NAME}) are preserved for runtime resolution.
+     */
+    toJSON(): Record<string, any>;
 }
 /**
  * LuaAgent configuration interface.
@@ -574,6 +676,8 @@ export interface LuaAgentConfig {
     preProcessors?: PreProcessor[];
     /** Array of postprocessors (run after agent generates responses) */
     postProcessors?: PostProcessor[];
+    /** Array of MCP servers (Model Context Protocol) for external tool integrations */
+    mcpServers?: LuaMCPServer[];
 }
 /**
  * LuaAgent class.
@@ -611,6 +715,7 @@ export declare class LuaAgent {
     private readonly jobs;
     private readonly preProcessors;
     private readonly postProcessors;
+    private readonly mcpServers;
     /**
      * Creates a new LuaAgent instance.
      *
@@ -622,6 +727,7 @@ export declare class LuaAgent {
      * @param config.jobs - Optional array of jobs
      * @param config.preProcessors - Optional array of preprocessors
      * @param config.postProcessors - Optional array of postprocessors
+     * @param config.mcpServers - Optional array of MCP servers
      */
     constructor(config: LuaAgentConfig);
     getName(): string;
@@ -631,4 +737,5 @@ export declare class LuaAgent {
     getJobs(): LuaJob[];
     getPreProcessors(): PreProcessor[];
     getPostProcessors(): PostProcessor[];
+    getMCPServers(): LuaMCPServer[];
 }