lua-cli 2.5.8 → 3.0.0-alpha.10

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

@@ -18,4 +18,12 @@ export default class ChatApi extends HttpClient {
      * @throws Error if the agent is not found or the chat request fails
      */
     sendMessage(agentId: string, chatData: ChatRequest): Promise<ApiResponse<ChatResponse>>;
+    /**
+     * Streams a message to an agent and receives chunked responses
+     * @param agentId - The unique identifier of the agent to chat with
+     * @param chatData - The chat request data including message, conversation history, and context
+     * @param onChunk - Callback function to handle each text chunk as it arrives
+     * @returns Promise resolving when stream completes
+     */
+    sendMessageStream(agentId: string, chatData: ChatRequest, onChunk: (text: string) => void): Promise<void>;
 }

package/dist/api/chat.api.service.js

@@ -21,4 +21,54 @@ export default class ChatApi extends HttpClient {
             Authorization: `Bearer ${this.apiKey}`,
         });
     }
+    /**
+     * Streams a message to an agent and receives chunked responses
+     * @param agentId - The unique identifier of the agent to chat with
+     * @param chatData - The chat request data including message, conversation history, and context
+     * @param onChunk - Callback function to handle each text chunk as it arrives
+     * @returns Promise resolving when stream completes
+     */
+    async sendMessageStream(agentId, chatData, onChunk) {
+        const response = await fetch(`${this.baseUrl}/chat/stream/${agentId}?channel=dev`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(chatData)
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        const reader = response.body?.getReader();
+        if (!reader) {
+            throw new Error('Response body is not readable');
+        }
+        const decoder = new TextDecoder();
+        let buffer = '';
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            // Decode the chunk and add to buffer
+            buffer += decoder.decode(value, { stream: true });
+            // Process complete lines (chunks are separated by newlines)
+            const lines = buffer.split('\n');
+            buffer = lines.pop() || ''; // Keep incomplete line in buffer
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const chunk = JSON.parse(line);
+                    // Only process text-delta chunks
+                    if (chunk.type === 'text-delta' && chunk.textDelta) {
+                        onChunk(chunk.textDelta);
+                    }
+                }
+                catch (error) {
+                    // Skip invalid JSON lines
+                }
+            }
+        }
+    }
 }

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

@@ -0,0 +1,219 @@
+import { HttpClient } from "../common/http.client.js";
+import { ApiResponse } from "../interfaces/common.js";
+import { CreateJobDTO, PushJobVersionDTO, UpdateJobVersionDTO } from "../interfaces/jobs.js";
+import { JobInstance } from "../common/job.instance.js";
+/**
+ * Job API Response Types
+ */
+export interface JobVersion {
+    version: string;
+    jobId: string;
+    createdAt: string | number;
+    isActive?: boolean;
+    schedule?: any;
+    timeout?: number;
+    retry?: {
+        maxAttempts: number;
+        backoffSeconds?: number;
+    };
+}
+export interface GetJobsResponse {
+    jobs: Array<{
+        id: string;
+        name: string;
+        description?: string;
+        context?: string;
+        versions: JobVersion[];
+        activeVersionId?: string;
+        lastRunAt?: string;
+        nextRunAt?: string;
+        status?: 'active' | 'paused' | 'failed';
+    }>;
+}
+export interface CreateJobResponse {
+    id: string;
+    name: string;
+    description?: string;
+    agentId: string;
+    context?: string;
+}
+export interface JobVersionResponse {
+    versionId: string;
+    jobId: string;
+    version: string;
+    createdAt: string;
+    schedule: any;
+}
+export interface UpdateJobVersionResponse {
+    versionId: string;
+    jobId: string;
+    version: string;
+    updatedAt: string;
+}
+export interface DeleteJobResponse {
+    deleted: boolean;
+    deactivated?: boolean;
+    message: string;
+}
+export interface JobExecutionResponse {
+    executionId: string;
+    jobId: string;
+    startedAt: string;
+    completedAt?: string;
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    result?: any;
+    error?: string;
+}
+/**
+ * Job API Service
+ * Handles all job-related API calls
+ */
+export default class JobApi extends HttpClient {
+    apiKey: string;
+    agentId: string;
+    /**
+     * Creates an instance of JobApi
+     * @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);
+    /**
+     * Retrieves all jobs for the agent
+     * @returns Promise resolving to an ApiResponse containing an array of jobs with their versions
+     * @throws Error if the API request fails or the agent is not found
+     */
+    getJobs(): Promise<ApiResponse<GetJobsResponse>>;
+    /**
+     * 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>;
+    /**
+     * Creates a new job for the agent.
+     * Optionally creates initial version and activates the job in one call.
+     *
+     * @param jobData - The job data including name, description, schedule, and optional version
+     * @param jobData.version - If provided, creates first version automatically
+     * @param jobData.activate - If true, activates the job immediately
+     * @returns Promise resolving to an ApiResponse containing the created job details
+     * @throws Error if the job creation fails or validation errors occur
+     */
+    createJob(jobData: CreateJobDTO): Promise<ApiResponse<CreateJobResponse>>;
+    /**
+    * Creates a new job for the agent and returns a JobInstance.
+    * Supports automatic version creation and activation.
+    *
+    * @param jobData - The job data including name, description, schedule, and optional version
+    * @param jobData.version - If provided, creates first version automatically
+    * @param jobData.activate - If true, activates the job immediately
+    * @returns Promise resolving to a JobInstance containing the created job details
+    * @throws Error if the job creation fails or validation errors occur
+    */
+    createJobInstance(jobData: CreateJobDTO): Promise<JobInstance>;
+    private compressCode;
+    /**
+     * Pushes a new version of a job to production
+     * @param jobId - The unique identifier of the job
+     * @param versionData - The version data including code, configuration, and metadata
+     * @returns Promise resolving to an ApiResponse containing the created version details
+     * @throws Error if the job is not found or the push operation fails
+     */
+    pushJob(jobId: string, versionData: PushJobVersionDTO): Promise<ApiResponse<JobVersionResponse>>;
+    /**
+     * Pushes a new development/sandbox version of a job for testing
+     * @param jobId - The unique identifier of the job
+     * @param versionData - The version data including code, configuration, and metadata
+     * @returns Promise resolving to an ApiResponse containing the development version details
+     * @throws Error if the job is not found or the push operation fails
+     */
+    pushDevJob(jobId: string, versionData: PushJobVersionDTO): Promise<ApiResponse<JobVersionResponse>>;
+    /**
+     * Updates an existing development/sandbox version of a job
+     * @param jobId - The unique identifier of the job
+     * @param sandboxVersionId - The unique identifier of the sandbox version to update
+     * @param versionData - The updated version data including code, configuration, and metadata
+     * @returns Promise resolving to an ApiResponse containing the updated version details
+     * @throws Error if the job or version is not found or the update fails
+     */
+    updateDevJob(jobId: string, sandboxVersionId: string, versionData: UpdateJobVersionDTO): Promise<ApiResponse<UpdateJobVersionResponse>>;
+    /**
+     * Retrieves all versions of a specific job
+     * @param jobId - The unique identifier of the job
+     * @returns Promise resolving to an ApiResponse containing an array of job versions
+     * @throws Error if the job is not found or the request fails
+     */
+    getJobVersions(jobId: string): Promise<ApiResponse<{
+        versions: JobVersion[];
+        activeVersionId?: string;
+    }>>;
+    /**
+     * Publishes a specific version of a job to production
+     * @param jobId - The unique identifier of the job
+     * @param version - The version identifier to publish
+     * @returns Promise resolving to an ApiResponse containing publication confirmation details
+     * @throws Error if the job or version is not found or the publish operation fails
+     */
+    publishJobVersion(jobId: string, version: string): Promise<ApiResponse<{
+        message: string;
+        jobId: string;
+        activeVersionId: string;
+        publishedAt: string;
+    }>>;
+    /**
+     * Deletes a job and all its versions, or deactivates it if it has versions
+     * @param jobId - The unique identifier of the job to delete
+     * @returns Promise resolving to an ApiResponse with deletion status
+     *   - If deleted is true: job was successfully deleted
+     *   - If deleted is false and deactivated is true: job has versions and was deactivated instead
+     * @throws Error if the job is not found or the delete operation fails
+     */
+    deleteJob(jobId: string): Promise<ApiResponse<DeleteJobResponse>>;
+    /**
+     * Activates a job (enables it to run on schedule)
+     * @param jobId - The unique identifier of the job to activate
+     * @returns Promise resolving to an ApiResponse with activation status
+     * @throws Error if the job is not found or the operation fails
+     */
+    activateJob(jobId: string): Promise<ApiResponse<{
+        message: string;
+        active: boolean;
+    }>>;
+    /**
+     * Deactivates a job (disables it from running)
+     * @param jobId - The unique identifier of the job to deactivate
+     * @returns Promise resolving to an ApiResponse with deactivation status
+     * @throws Error if the job is not found or the operation fails
+     */
+    deactivateJob(jobId: string): Promise<ApiResponse<{
+        message: string;
+        active: boolean;
+    }>>;
+    /**
+     * Manually triggers a job execution (ignores schedule)
+     * @param jobId - The unique identifier of the job to trigger
+     * @returns Promise resolving to an ApiResponse with execution details
+     * @throws Error if the job is not found or the operation fails
+     */
+    triggerJob(jobId: string): Promise<ApiResponse<JobExecutionResponse>>;
+    /**
+     * Retrieves execution history for a job
+     * @param jobId - The unique identifier of the job
+     * @param limit - Maximum number of executions to return (default: 50)
+     * @returns Promise resolving to an ApiResponse with execution history
+     * @throws Error if the job is not found or the request fails
+     */
+    getJobExecutions(jobId: string, limit?: number): Promise<ApiResponse<{
+        executions: JobExecutionResponse[];
+    }>>;
+    /**
+     * Updates the metadata of a job
+     * @param jobId - The unique identifier of the job
+     * @param metadata - The metadata object to update or merge with existing metadata
+     * @returns Promise resolving to the updated metadata
+     * @throws Error if the job is not found or the metadata update fails
+     */
+    updateMetadata(jobId: string, metadata: any): Promise<ApiResponse<any>>;
+}

package/dist/api/job.api.service.js

@@ -0,0 +1,216 @@
+import { HttpClient } from "../common/http.client.js";
+import { JobInstance } from "../common/job.instance.js";
+import { gzipSync } from "zlib";
+/**
+ * Job API Service
+ * Handles all job-related API calls
+ */
+export default class JobApi extends HttpClient {
+    /**
+     * Creates an instance of JobApi
+     * @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;
+    }
+    /**
+     * Retrieves all jobs for the agent
+     * @returns Promise resolving to an ApiResponse containing an array of jobs with their versions
+     * @throws Error if the API request fails or the agent is not found
+     */
+    async getJobs() {
+        return this.httpGet(`/developer/jobs/${this.agentId}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * 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 response = await this.httpGet(`/developer/jobs/${this.agentId}/${jobId}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success && response.data) {
+            return new JobInstance(this, response.data);
+        }
+        throw new Error(response.error?.message || 'Failed to get job');
+    }
+    /**
+     * Creates a new job for the agent.
+     * Optionally creates initial version and activates the job in one call.
+     *
+     * @param jobData - The job data including name, description, schedule, and optional version
+     * @param jobData.version - If provided, creates first version automatically
+     * @param jobData.activate - If true, activates the job immediately
+     * @returns Promise resolving to an ApiResponse containing the created job details
+     * @throws Error if the job creation fails or validation errors occur
+     */
+    async createJob(jobData) {
+        return this.httpPost(`/developer/jobs/${this.agentId}`, jobData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+    * Creates a new job for the agent and returns a JobInstance.
+    * Supports automatic version creation and activation.
+    *
+    * @param jobData - The job data including name, description, schedule, and optional version
+    * @param jobData.version - If provided, creates first version automatically
+    * @param jobData.activate - If true, activates the job immediately
+    * @returns Promise resolving to a JobInstance containing the created job details
+    * @throws Error if the job creation fails or validation errors occur
+    */
+    async createJobInstance(jobData) {
+        if (jobData.version?.executeFunction && jobData.version?.executeFunction.length > 0) {
+            jobData.version.code = this.compressCode(jobData.version.executeFunction);
+        }
+        const response = await this.httpPost(`/developer/jobs/${this.agentId}`, jobData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success && response.data) {
+            return new JobInstance(this, response.data);
+        }
+        throw new Error(response.error?.message || 'Failed to create job');
+    }
+    compressCode(code) {
+        const compressed = gzipSync(code);
+        return compressed.toString('base64');
+    }
+    /**
+     * Pushes a new version of a job to production
+     * @param jobId - The unique identifier of the job
+     * @param versionData - The version data including code, configuration, and metadata
+     * @returns Promise resolving to an ApiResponse containing the created version details
+     * @throws Error if the job is not found or the push operation fails
+     */
+    async pushJob(jobId, versionData) {
+        return this.httpPost(`/developer/jobs/${this.agentId}/${jobId}/version`, versionData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Pushes a new development/sandbox version of a job for testing
+     * @param jobId - The unique identifier of the job
+     * @param versionData - The version data including code, configuration, and metadata
+     * @returns Promise resolving to an ApiResponse containing the development version details
+     * @throws Error if the job is not found or the push operation fails
+     */
+    async pushDevJob(jobId, versionData) {
+        return this.httpPost(`/developer/jobs/${this.agentId}/${jobId}/version/sandbox`, versionData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Updates an existing development/sandbox version of a job
+     * @param jobId - The unique identifier of the job
+     * @param sandboxVersionId - The unique identifier of the sandbox version to update
+     * @param versionData - The updated version data including code, configuration, and metadata
+     * @returns Promise resolving to an ApiResponse containing the updated version details
+     * @throws Error if the job or version is not found or the update fails
+     */
+    async updateDevJob(jobId, sandboxVersionId, versionData) {
+        return this.httpPut(`/developer/jobs/${this.agentId}/${jobId}/version/sandbox/${sandboxVersionId}`, versionData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Retrieves all versions of a specific job
+     * @param jobId - The unique identifier of the job
+     * @returns Promise resolving to an ApiResponse containing an array of job versions
+     * @throws Error if the job is not found or the request fails
+     */
+    async getJobVersions(jobId) {
+        return this.httpGet(`/developer/jobs/${this.agentId}/${jobId}/versions`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Publishes a specific version of a job to production
+     * @param jobId - The unique identifier of the job
+     * @param version - The version identifier to publish
+     * @returns Promise resolving to an ApiResponse containing publication confirmation details
+     * @throws Error if the job or version is not found or the publish operation fails
+     */
+    async publishJobVersion(jobId, version) {
+        return this.httpPut(`/developer/jobs/${this.agentId}/${jobId}/${version}/publish`, undefined, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Deletes a job and all its versions, or deactivates it if it has versions
+     * @param jobId - The unique identifier of the job to delete
+     * @returns Promise resolving to an ApiResponse with deletion status
+     *   - If deleted is true: job was successfully deleted
+     *   - If deleted is false and deactivated is true: job has versions and was deactivated instead
+     * @throws Error if the job is not found or the delete operation fails
+     */
+    async deleteJob(jobId) {
+        return this.httpDelete(`/developer/jobs/${this.agentId}/${jobId}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Activates a job (enables it to run on schedule)
+     * @param jobId - The unique identifier of the job to activate
+     * @returns Promise resolving to an ApiResponse with activation status
+     * @throws Error if the job is not found or the operation fails
+     */
+    async activateJob(jobId) {
+        return this.httpPost(`/developer/jobs/${this.agentId}/${jobId}/activate`, {}, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Deactivates a job (disables it from running)
+     * @param jobId - The unique identifier of the job to deactivate
+     * @returns Promise resolving to an ApiResponse with deactivation status
+     * @throws Error if the job is not found or the operation fails
+     */
+    async deactivateJob(jobId) {
+        return this.httpPost(`/developer/jobs/${this.agentId}/${jobId}/deactivate`, {}, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Manually triggers a job execution (ignores schedule)
+     * @param jobId - The unique identifier of the job to trigger
+     * @returns Promise resolving to an ApiResponse with execution details
+     * @throws Error if the job is not found or the operation fails
+     */
+    async triggerJob(jobId) {
+        return this.httpPost(`/developer/jobs/${this.agentId}/${jobId}/trigger`, {}, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Retrieves execution history for a job
+     * @param jobId - The unique identifier of the job
+     * @param limit - Maximum number of executions to return (default: 50)
+     * @returns Promise resolving to an ApiResponse with execution history
+     * @throws Error if the job is not found or the request fails
+     */
+    async getJobExecutions(jobId, limit = 50) {
+        return this.httpGet(`/developer/jobs/${this.agentId}/${jobId}/executions?limit=${limit}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Updates the metadata of a job
+     * @param jobId - The unique identifier of the job
+     * @param metadata - The metadata object to update or merge with existing metadata
+     * @returns Promise resolving to the updated metadata
+     * @throws Error if the job is not found or the metadata update fails
+     */
+    async updateMetadata(jobId, metadata) {
+        return this.httpPut(`/developer/jobs/${this.agentId}/${jobId}/metadata`, metadata, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+}

package/dist/api/lazy-instances.d.ts

@@ -7,6 +7,9 @@ import BasketApiService from "./basket.api.service.js";
 import OrderApiService from "./order.api.service.js";
 import UserDataApiService from "./user.data.api.service.js";
 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";
 /**
  * Gets or creates User Data API instance.
  * Instance is created once and reused for subsequent calls.
@@ -42,6 +45,27 @@ export declare function getBasketsInstance(): Promise<BasketApiService>;
  * @returns OrderApiService instance
  */
 export declare function getOrderInstance(): Promise<OrderApiService>;
+/**
+ * Gets or creates Webhook API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns WebhookApi instance
+ */
+export declare function getWebhookInstance(): Promise<WebhookApi>;
+/**
+ * Gets or creates Job API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns JobApi instance
+ */
+export declare function getJobInstance(): Promise<JobApi>;
+/**
+ * Gets or creates Chat API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns ChatApi instance
+ */
+export declare function getChatInstance(): Promise<ChatApi>;
 /**
  * Clears all cached API instances.
  * Useful for testing or when credentials change.

package/dist/api/lazy-instances.js

@@ -9,6 +9,9 @@ import BasketApiService from "./basket.api.service.js";
 import OrderApiService from "./order.api.service.js";
 import UserDataApiService from "./user.data.api.service.js";
 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";
 /**
  * Singleton instances (lazy-loaded)
  */
@@ -17,6 +20,9 @@ let _dataInstance = null;
 let _productsInstance = null;
 let _basketsInstance = null;
 let _orderInstance = null;
+let _webhookInstance = null;
+let _jobInstance = null;
+let _chatInstance = null;
 /**
  * Gets or creates User Data API instance.
  * Instance is created once and reused for subsequent calls.
@@ -82,6 +88,45 @@ export async function getOrderInstance() {
     }
     return _orderInstance;
 }
+/**
+ * Gets or creates Webhook API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns WebhookApi instance
+ */
+export async function getWebhookInstance() {
+    if (!_webhookInstance) {
+        const creds = await getCredentials();
+        _webhookInstance = new WebhookApi(BASE_URLS.API, creds.apiKey, creds.agentId);
+    }
+    return _webhookInstance;
+}
+/**
+ * Gets or creates Job API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns JobApi instance
+ */
+export async function getJobInstance() {
+    if (!_jobInstance) {
+        const creds = await getCredentials();
+        _jobInstance = new JobApi(BASE_URLS.API, creds.apiKey, creds.agentId);
+    }
+    return _jobInstance;
+}
+/**
+ * Gets or creates Chat API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns ChatApi instance
+ */
+export async function getChatInstance() {
+    if (!_chatInstance) {
+        const creds = await getCredentials();
+        _chatInstance = new ChatApi(BASE_URLS.API, creds.apiKey);
+    }
+    return _chatInstance;
+}
 /**
  * Clears all cached API instances.
  * Useful for testing or when credentials change.
@@ -92,4 +137,7 @@ export function clearAllInstances() {
     _productsInstance = null;
     _basketsInstance = null;
     _orderInstance = null;
+    _webhookInstance = null;
+    _jobInstance = null;
+    _chatInstance = null;
 }