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

package/dist/common/job.instance.js

@@ -35,12 +35,13 @@ export class JobInstance {
     constructor(jobApi, jobData) {
         this.jobApi = jobApi;
         this._data = jobData;
-        this.id = jobData.id || jobData.jobId;
-        this.jobId = jobData.id || jobData.jobId;
+        this.id = jobData.id;
         this.name = jobData.name;
-        this.schedule = jobData.schedule;
+        this.activeVersion = jobData.activeVersion;
         this.metadata = jobData.metadata || {};
-        this.userApi = new UserDataApi(BASE_URLS.API, jobApi.apiKey, jobApi.agentId);
+        if (jobData.userId && jobData.agentId) {
+            this.userApi = new UserDataApi(BASE_URLS.API, jobApi.apiKey, jobApi.agentId);
+        }
     }
     /**
      * Gets the full job data.
@@ -64,19 +65,13 @@ export class JobInstance {
      */
     async updateMetadata(metadata) {
         this.metadata = { ...this.metadata, ...metadata };
-        const result = await this.jobApi.updateMetadata(this.jobId, this.metadata);
+        const result = await this.jobApi.updateMetadata(this.id, this.metadata);
         if (!result.success) {
             throw new Error(result.error?.message || 'Failed to update job metadata');
         }
-        return result.data;
-        // Update metadata on the server if the job has versions
-        // Note: Metadata updates may require updating the active version
-        // For now, we just update the local instance
-        // In the future, this could call an API endpoint to update job metadata
-        console.warn('Note: Job metadata updates are stored locally. Deploy a new version to persist changes.');
     }
     /**
-     * Deletes the job from the backend.
+     * Deletes the job from the backend (or deactivates if it has versions).
      *
      * @returns Promise resolving when deletion is complete
      *
@@ -87,28 +82,60 @@ export class JobInstance {
      * ```
      */
     async delete() {
-        const result = await this.jobApi.deleteJob(this.jobId);
+        const result = await this.jobApi.deleteJob(this.id);
         if (!result.success) {
             throw new Error(result.error?.message || 'Failed to delete job');
         }
-        if (result.data?.deactivated) {
-            console.warn(`Job "${this.name}" has versions and was deactivated instead of deleted.`);
-        }
     }
+    /**
+     * Gets the user data associated with this job's agent.
+     * Provides access to user information and custom data storage.
+     *
+     * @returns Promise resolving to UserDataInstance with user information
+     *
+     * @example
+     * ```typescript
+     * const user = await job.user();
+     * console.log('User email:', user.email);
+     * console.log('User data:', user.data);
+     * ```
+     */
     async user() {
+        if (!this.userApi) {
+            throw new Error('User API not initialized');
+        }
         return await this.userApi.get();
     }
+    /**
+     * Manually triggers the job execution (ignores schedule).
+     * Uses activeVersion by default.
+     *
+     * @param versionId - Optional version to execute (defaults to activeVersion)
+     * @returns Promise resolving to execution result
+     *
+     * @example
+     * ```typescript
+     * const result = await job.trigger();
+     * console.log('Execution result:', result);
+     * ```
+     */
+    async trigger(versionId) {
+        const result = await this.jobApi.triggerJob(this.id, versionId || this.activeVersion?.id);
+        if (!result.success || !result.data) {
+            throw new Error(result.error?.message || 'Failed to trigger job');
+        }
+        return result.data;
+    }
     /**
      * Converts the job instance to JSON.
      */
     toJSON() {
         return {
+            ...this._data,
             id: this.id,
-            jobId: this.jobId,
             name: this.name,
-            schedule: this.schedule,
+            activeVersion: this.activeVersion,
             metadata: this.metadata,
-            ...this._data
         };
     }
 }

package/dist/config/constants.d.ts

@@ -5,7 +5,7 @@
  * Base URLs for the API, Auth, and Chat - Development
  */
 export declare const BASE_URLS: {
-    readonly API: "http://localhost:3001";
+    readonly API: "https://api.heylua.ai";
     readonly AUTH: "https://auth.heylua.ai";
     readonly CHAT: "https://api.heylua.ai";
     readonly WEBHOOK: "https://webhook.heylua.ai";

package/dist/config/constants.js

@@ -11,11 +11,7 @@
  * Base URLs for the API, Auth, and Chat - Development
  */
 export const BASE_URLS = {
-    // API: 'https://api.heylua.ai',
-    // AUTH: 'https://auth.heylua.ai',
-    // CHAT: 'https://api.heylua.ai',
-    // WEBHOOK: 'https://webhook.heylua.ai',
-    API: 'http://localhost:3001',
+    API: 'https://api.heylua.ai',
     AUTH: 'https://auth.heylua.ai',
     CHAT: 'https://api.heylua.ai',
     WEBHOOK: 'https://webhook.heylua.ai',

package/dist/interfaces/agent.d.ts

@@ -10,7 +10,6 @@ export interface Agent {
     id: string;
     name: string;
     persona?: string;
-    welcomeMessage?: string;
     featuresOverride?: Record<string, any>;
 }
 /**
@@ -52,7 +51,6 @@ export interface CreateAgentResponse {
     baseAgentId: string;
     persona: string;
     createdAt: string;
-    welcomeMessage: string;
     featuresOverride: Record<string, any>;
     _id: string;
     updatedAt: string;
@@ -78,7 +76,6 @@ export interface AgentDetailsResponse {
     baseAgentId: string;
     persona: string;
     createdAt: string;
-    welcomeMessage: string;
     featuresOverride: Record<string, any>;
     updatedAt: string;
     __v: number;

package/dist/interfaces/index.d.ts

@@ -5,7 +5,7 @@
  * It re-exports interfaces and DTOs from various modules for convenient importing.
  */
 export { CreateWebhookDTO, PushWebhookVersionDTO, UpdateWebhookVersionDTO, WebhookVersion, Webhook, GetWebhooksResponse, DeleteWebhookResponse, CreateWebhookResponse, PushWebhookVersionResponse, } from "./webhooks.js";
-export { CreateJobDTO, PushJobVersionDTO, UpdateJobVersionDTO, JobSchedule, JobScheduleType, JobRetryConfig, JobVersion, JobExecutionStatus, JobExecution, JobStatus, Job, GetJobsResponse, DeleteJobResponse, CreateJobResponse, PushJobVersionResponse, JobExecutionResponse, GetJobExecutionsResponse, } from "./jobs.js";
+export { CreateJobDTO, PushJobVersionDTO, UpdateJobVersionDTO, JobSchedule, JobScheduleType, JobRetryConfig, JobVersion, JobExecutionStatus, JobExecution, JobStatus, Job, GetJobsResponseData, GetJobExecutionsResponseData, DeleteJobResponseData, UpdateJobMetadataResponseData, } from "./jobs.js";
 export { ApiResponse, Pagination } from "./common.js";
 export { SkillTool, SkillVersion, Skill, GetSkillsResponse, DeleteSkillResponse, } from "./skills.js";
 export { ImmutableUserProfile, UserAgentData } from "./user.js";

package/dist/interfaces/init.d.ts

@@ -56,5 +56,4 @@ export interface AgentCreationResult {
     agent: SelectedAgent;
     org: SelectedOrg;
     persona?: string;
-    welcomeMessage?: string;
 }

package/dist/interfaces/jobs.d.ts

@@ -1,72 +1,6 @@
 /**
  * Jobs Interfaces
- * Structures for job management
- */
-/**
- * DTO for creating a new job
- */
-export interface CreateJobDTO {
-    name: string;
-    description?: string;
-    context?: string;
-    schedule: JobSchedule;
-    timeout?: number;
-    retry?: JobRetryConfig;
-    metadata?: Record<string, any>;
-    dynamic?: boolean;
-    /**
-     * Optional initial version data.
-     * If provided, creates the first version automatically.
-     */
-    version?: {
-        version: string;
-        description?: string;
-        context?: string;
-        code: string;
-        executeFunction: string;
-        timeout?: number;
-        retry?: JobRetryConfig;
-        metadata?: Record<string, any>;
-    };
-    /**
-     * Auto-publish and activate the job after creation.
-     * If true, the job will be immediately active and running.
-     * Default: false
-     */
-    activate?: boolean;
-}
-/**
- * DTO for pushing a job version
- */
-export interface PushJobVersionDTO {
-    name: string;
-    version: string;
-    description?: string;
-    context?: string;
-    jobId: string;
-    schedule: JobSchedule;
-    timeout?: number;
-    retry?: JobRetryConfig;
-    code?: string;
-    executeFunction?: string;
-    metadata?: Record<string, any>;
-}
-/**
- * DTO for updating a job version
- */
-export interface UpdateJobVersionDTO {
-    version?: string;
-    description?: string;
-    context?: string;
-    schedule?: JobSchedule;
-    timeout?: number;
-    retry?: JobRetryConfig;
-    code?: string;
-    executeFunction?: string;
-    metadata?: Record<string, any>;
-}
-/**
- * Job schedule configuration
+ * Matches lua-api/src/dto/job.dto.ts exactly
  */
 export type JobScheduleType = 'cron' | 'once' | 'interval';
 export interface JobSchedule {
@@ -76,34 +10,15 @@ export interface JobSchedule {
     seconds?: number;
     timezone?: string;
 }
-/**
- * Job retry configuration
- */
 export interface JobRetryConfig {
     maxAttempts: number;
     backoffSeconds?: number;
 }
-/**
- * Job version information
- */
-export interface JobVersion {
-    id: string;
-    version: string;
-    description: string;
-    active: boolean;
-    context: string;
-    schedule: JobSchedule;
-    timeout?: number;
-    retry?: JobRetryConfig;
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * Job execution status
- */
+export type JobStatus = 'active' | 'paused' | 'failed' | 'inactive';
 export type JobExecutionStatus = 'pending' | 'running' | 'completed' | 'failed' | 'timeout';
 /**
  * Job execution record
+ * Matches JobExecutionDto
  */
 export interface JobExecution {
     id: string;
@@ -118,76 +33,117 @@ export interface JobExecution {
     retryCount?: number;
 }
 /**
- * Job status
+ * Job version (full details)
+ * Matches JobVersionDto
  */
-export type JobStatus = 'active' | 'paused' | 'failed' | 'inactive';
+export interface JobVersion {
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    jobId: string;
+    active: boolean;
+    schedule: JobSchedule;
+    timeout?: number;
+    retry?: JobRetryConfig;
+    createdAt: string;
+    updatedAt: string;
+    metadata?: Record<string, any>;
+}
 /**
- * Job information
+ * Job with versions array
+ * Matches JobDto and job.schema.ts
  */
 export interface Job {
     id: string;
     name: string;
-    description: string;
+    description?: string;
+    agentId: string;
     public: boolean;
     active: boolean;
     status: JobStatus;
-    createdAt: string;
-    updatedAt: string;
-    versions: JobVersion[];
     activeVersionId?: string;
+    /** The active version (if one exists) */
+    activeVersion?: JobVersion;
     lastRunAt?: string;
     nextRunAt?: string;
+    createdAt: string;
+    updatedAt: string;
+    dynamic?: boolean;
+    userId?: string;
+    metadata?: Record<string, any>;
+    versions: JobVersion[];
     lastExecution?: JobExecution;
 }
-/**
- * Response from get all jobs API endpoint
- */
-export interface GetJobsResponse {
-    jobs: Job[];
-}
-/**
- * Response from delete job API endpoint
- * If deleted is false and deactivated is true, the job has versions
- * and cannot be deleted, so it was deactivated instead
- */
-export interface DeleteJobResponse {
-    message: string;
-    deleted: boolean;
-    deactivated: boolean;
-}
-/**
- * Response from create job API endpoint
- */
-export interface CreateJobResponse {
-    id: string;
+export interface CreateJobDTO {
     name: string;
     description?: string;
-    agentId: string;
-    context?: string;
     schedule: JobSchedule;
+    timeout?: number;
+    retry?: JobRetryConfig;
+    metadata?: Record<string, any>;
+    dynamic?: boolean;
+    version?: {
+        version: string;
+        description?: string;
+        code: string;
+        executeFunction: string;
+        timeout?: number;
+        retry?: JobRetryConfig;
+        metadata?: Record<string, any>;
+    };
+    activate?: boolean;
 }
-/**
- * Response from push job version API endpoint
- */
-export interface PushJobVersionResponse {
-    versionId: string;
-    jobId: string;
+export interface PushJobVersionDTO {
+    name: string;
     version: string;
-    createdAt: string;
+    description?: string;
+    jobId: string;
     schedule: JobSchedule;
+    timeout?: number;
+    retry?: JobRetryConfig;
+    code?: string;
+    executeFunction?: string;
+    metadata?: Record<string, any>;
+}
+export interface UpdateJobVersionDTO {
+    version?: string;
+    description?: string;
+    schedule?: JobSchedule;
+    timeout?: number;
+    retry?: JobRetryConfig;
+    code?: string;
+    executeFunction?: string;
+    metadata?: Record<string, any>;
 }
 /**
- * Response from job execution APIs
+ * GetJobs response data
  */
-export interface JobExecutionResponse {
-    execution: JobExecution;
+export interface GetJobsResponseData {
+    jobs: Job[];
 }
 /**
- * Response from get job executions API
+ * GetJobExecutions response data
  */
-export interface GetJobExecutionsResponse {
+export interface GetJobExecutionsResponseData {
     executions: JobExecution[];
     total: number;
-    page?: number;
-    limit?: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * DeleteJob response data
+ */
+export interface DeleteJobResponseData {
+    deleted: boolean;
+    deactivated: boolean;
+    message: string;
+}
+/**
+ * UpdateJobMetadata response data
+ */
+export interface UpdateJobMetadataResponseData {
+    message: string;
+    jobId: string;
+    metadata: Record<string, any>;
 }

package/dist/interfaces/jobs.js

@@ -1,5 +1,5 @@
 /**
  * Jobs Interfaces
- * Structures for job management
+ * Matches lua-api/src/dto/job.dto.ts exactly
  */
 export {};

package/dist/interfaces/postprocessors.d.ts

@@ -7,7 +7,6 @@
 export interface CreatePostProcessorDTO {
     name: string;
     description?: string;
-    context?: string;
 }
 /**
  * DTO for pushing a postprocessor version
@@ -16,7 +15,6 @@ export interface PushPostProcessorVersionDTO {
     name: string;
     version: string;
     description?: string;
-    context?: string;
     postprocessorId: string;
     code?: string;
     executeFunction?: string;
@@ -29,7 +27,6 @@ export interface PostProcessorVersion {
     version: string;
     description: string;
     active: boolean;
-    context: string;
     createdAt: string;
     updatedAt: string;
 }

package/dist/interfaces/preprocessors.d.ts

@@ -7,7 +7,6 @@
 export interface CreatePreProcessorDTO {
     name: string;
     description?: string;
-    context?: string;
 }
 /**
  * DTO for pushing a preprocessor version
@@ -16,7 +15,6 @@ export interface PushPreProcessorVersionDTO {
     name: string;
     version: string;
     description?: string;
-    context?: string;
     preprocessorId: string;
     code?: string;
     executeFunction?: string;
@@ -29,7 +27,6 @@ export interface PreProcessorVersion {
     version: string;
     description: string;
     active: boolean;
-    context: string;
     createdAt: string;
     updatedAt: string;
 }

package/dist/interfaces/webhooks.d.ts

@@ -8,7 +8,6 @@
 export interface CreateWebhookDTO {
     name: string;
     description?: string;
-    context?: string;
 }
 /**
  * DTO for pushing a webhook version
@@ -17,7 +16,6 @@ export interface PushWebhookVersionDTO {
     name: string;
     version: string;
     description?: string;
-    context?: string;
     webhookId: string;
     querySchema?: any;
     headerSchema?: any;
@@ -31,7 +29,6 @@ export interface PushWebhookVersionDTO {
 export interface UpdateWebhookVersionDTO {
     version?: string;
     description?: string;
-    context?: string;
     querySchema?: any;
     headerSchema?: any;
     bodySchema?: any;
@@ -46,7 +43,6 @@ export interface WebhookVersion {
     version: string;
     description: string;
     active: boolean;
-    context: string;
     querySchema?: any;
     headerSchema?: any;
     bodySchema?: any;
@@ -91,7 +87,6 @@ export interface CreateWebhookResponse {
     name: string;
     description?: string;
     agentId: string;
-    context?: string;
 }
 /**
  * Response from push webhook version API endpoint

package/dist/interfaces/whatsapp-templates.d.ts

@@ -0,0 +1,104 @@
+/**
+ * WhatsApp Templates Interfaces
+ * TypeScript interfaces for the Templates API
+ */
+export type WhatsAppTemplateCategory = 'AUTHENTICATION' | 'MARKETING' | 'UTILITY';
+export type WhatsAppTemplateStatus = 'APPROVED' | 'REJECTED' | 'PENDING';
+export type WhatsAppTemplateButtonType = 'COPY_CODE' | 'PHONE_NUMBER' | 'QUICK_REPLY' | 'URL';
+export type WhatsAppTemplateComponentType = 'HEADER' | 'BODY' | 'FOOTER' | 'BUTTONS';
+export interface WhatsAppTemplateHeaderComponent {
+    type: 'HEADER';
+    format: 'TEXT';
+    text: string;
+    example?: {
+        header_text_named_params: Array<{
+            param_name: string;
+            example: string;
+        }>;
+    };
+}
+export interface WhatsAppTemplateBodyComponent {
+    type: 'BODY';
+    text: string;
+    example?: {
+        body_text_named_params: Array<{
+            param_name: string;
+            example: string;
+        }>;
+    };
+}
+export interface WhatsAppTemplateFooterComponent {
+    type: 'FOOTER';
+    text: string;
+}
+export interface WhatsAppTemplateCopyCodeButton {
+    type: 'COPY_CODE';
+    example: string | string[];
+}
+export interface WhatsAppTemplatePhoneNumberButton {
+    type: 'PHONE_NUMBER';
+    text: string;
+    phone_number: string;
+}
+export interface WhatsAppTemplateUrlButton {
+    type: 'URL';
+    text: string;
+    url: string;
+    example?: string | string[];
+}
+export interface WhatsAppTemplateQuickReplyButton {
+    type: 'QUICK_REPLY';
+    text: string;
+}
+export type WhatsAppTemplateButton = WhatsAppTemplateCopyCodeButton | WhatsAppTemplatePhoneNumberButton | WhatsAppTemplateUrlButton | WhatsAppTemplateQuickReplyButton;
+export interface WhatsAppTemplateButtonsComponent {
+    type: 'BUTTONS';
+    buttons: WhatsAppTemplateButton[];
+}
+export type WhatsAppTemplateComponent = WhatsAppTemplateHeaderComponent | WhatsAppTemplateBodyComponent | WhatsAppTemplateFooterComponent | WhatsAppTemplateButtonsComponent;
+export interface WhatsAppTemplate {
+    id: string;
+    name: string;
+    category: WhatsAppTemplateCategory;
+    language: string;
+    status: WhatsAppTemplateStatus;
+    components: WhatsAppTemplateComponent[];
+    correct_category?: WhatsAppTemplateCategory;
+    message_send_ttl_seconds?: number;
+    parameter_format?: 'NAMED' | 'POSITIONAL';
+    previous_category?: WhatsAppTemplateCategory;
+    rejected_reason?: string;
+}
+export interface PaginatedTemplatesResponse {
+    templates: WhatsAppTemplate[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+}
+export interface ListTemplatesOptions {
+    page?: number;
+    limit?: number;
+    search?: string;
+}
+export interface SendTemplateButtonValue {
+    sub_type: WhatsAppTemplateButtonType;
+    index: string;
+    text?: string;
+    coupon_code?: string;
+}
+export interface SendTemplateValues {
+    header?: Record<string, string>;
+    body?: Record<string, string>;
+    buttons?: SendTemplateButtonValue[];
+}
+export interface SendTemplateData {
+    phoneNumbers: string[];
+    values?: SendTemplateValues;
+}
+export interface SendTemplateResponse {
+    results: any[];
+    errors: any[];
+    totalProcessed: number;
+    totalErrors: number;
+}

package/dist/interfaces/whatsapp-templates.js

@@ -0,0 +1,5 @@
+/**
+ * WhatsApp Templates Interfaces
+ * TypeScript interfaces for the Templates API
+ */
+export {};

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

@@ -223,3 +223,35 @@ export interface CustomDataAPI {
      */
     delete(collectionName: string, entryId: string): Promise<any>;
 }
+/**
+ * WhatsApp Templates API contract.
+ * Defines operations for managing WhatsApp templates.
+ */
+export interface WhatsAppTemplatesAPI {
+    /**
+     * 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?: {
+        page?: number;
+        limit?: number;
+        search?: string;
+    }): Promise<any>;
+    /**
+     * 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<any>;
+    /**
+     * 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
+     */
+    send(channelId: string, templateId: string, data: any): Promise<any>;
+}