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

package/README.md

@@ -105,7 +105,6 @@ import { LuaAgent, LuaSkill, LuaWebhook, LuaJob } from 'lua-cli';
 export const agent = new LuaAgent({
   name: 'my-assistant',
   persona: 'You are a helpful AI assistant...',
-  welcomeMessage: 'Hello! How can I help you today?',
   
   skills: [customerSupportSkill, productSkill],
   webhooks: [paymentWebhook],
@@ -166,7 +165,6 @@ import { z } from 'zod';
 
 export default new LuaWebhook({
   name: 'payment-webhook',
-  version: '1.0.0',
   description: 'Handle payment notifications',
   
   bodySchema: z.object({
@@ -194,7 +192,6 @@ import { LuaJob } from 'lua-cli';
 
 export default new LuaJob({
   name: 'daily-cleanup',
-  version: '1.0.0',
   description: 'Clean up old data daily',
   
   schedule: {
@@ -564,7 +561,6 @@ agent:
   orgId: your-org-id
   persona: |
     You are a helpful AI assistant...
-  welcomeMessage: Hello! How can I help you today?
 
 skills:
   - name: general-skill

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

@@ -0,0 +1,18 @@
+/**
+ * CDN API Service
+ * Handles file upload and retrieval from the Lua CDN
+ */
+import { CdnAPI } from "../types/api-contracts.js";
+export default class CdnApi implements CdnAPI {
+    private baseUrl;
+    private apiKey;
+    constructor(baseUrl: string, apiKey: string);
+    /**
+     * Uploads a file to the CDN
+     */
+    upload(file: File): Promise<string>;
+    /**
+     * Fetches a file from the CDN by its ID
+     */
+    get(fileId: string): Promise<File>;
+}

package/dist/api/cdn.api.service.js

@@ -0,0 +1,43 @@
+/**
+ * CDN API Service
+ * Handles file upload and retrieval from the Lua CDN
+ */
+export default class CdnApi {
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl;
+        this.apiKey = apiKey;
+    }
+    /**
+     * Uploads a file to the CDN
+     */
+    async upload(file) {
+        const formData = new FormData();
+        formData.append('file', file, file.name);
+        const response = await fetch(`${this.baseUrl}/upload`, {
+            method: 'POST',
+            headers: { 'Authorization': `Bearer ${this.apiKey}` },
+            body: formData,
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({}));
+            throw new Error(error.message || `Upload failed: ${response.status}`);
+        }
+        const data = await response.json();
+        return data.fileId;
+    }
+    /**
+     * Fetches a file from the CDN by its ID
+     */
+    async get(fileId) {
+        const response = await fetch(`${this.baseUrl}/${fileId}`);
+        if (!response.ok) {
+            throw new Error(`File not found: ${response.status}`);
+        }
+        const contentType = response.headers.get('content-type') || 'application/octet-stream';
+        const contentDisposition = response.headers.get('content-disposition') || '';
+        const filenameMatch = contentDisposition.match(/filename="?([^"]+)"?/);
+        const filename = filenameMatch?.[1] || fileId;
+        const blob = await response.blob();
+        return new File([blob], filename, { type: contentType });
+    }
+}

package/dist/api/custom.data.api.service.d.ts

@@ -1,6 +1,6 @@
 import { HttpClient } from "../common/http.client.js";
 import { CustomDataAPI } from "../types/index.js";
-import { GetCustomDataResponse, UpdateCustomDataRequest, UpdateCustomDataResponse, DeleteCustomDataResponse } from "../interfaces/custom.data.js";
+import { GetCustomDataResponse, UpdateCustomDataResponse, DeleteCustomDataResponse } from "../interfaces/custom.data.js";
 import DataEntryInstance from "../common/data.entry.instance.js";
 export default class CustomDataApi extends HttpClient implements CustomDataAPI {
     private apiKey;
@@ -43,11 +43,12 @@ export default class CustomDataApi extends HttpClient implements CustomDataAPI {
      * Updates an existing custom data entry
      * @param collectionName - The name of the collection containing the entry
      * @param entryId - The unique identifier of the entry to update
-     * @param data - The update data containing fields to modify (data and/or searchText)
+     * @param data - The data object to update
+     * @param searchText - Optional text to be used for semantic search indexing
      * @returns Promise resolving to an UpdateCustomDataResponse with the updated entry details
      * @throws Error if the entry is not found or the update fails
      */
-    update(collectionName: string, entryId: string, data: UpdateCustomDataRequest): Promise<UpdateCustomDataResponse>;
+    update(collectionName: string, entryId: string, data: Record<string, any>, searchText?: string): Promise<UpdateCustomDataResponse>;
     /**
      * Performs semantic search on custom data entries using text similarity
      * @param collectionName - The name of the collection to search within

package/dist/api/custom.data.api.service.js

@@ -73,12 +73,13 @@ export default class CustomDataApi extends HttpClient {
      * Updates an existing custom data entry
      * @param collectionName - The name of the collection containing the entry
      * @param entryId - The unique identifier of the entry to update
-     * @param data - The update data containing fields to modify (data and/or searchText)
+     * @param data - The data object to update
+     * @param searchText - Optional text to be used for semantic search indexing
      * @returns Promise resolving to an UpdateCustomDataResponse with the updated entry details
      * @throws Error if the entry is not found or the update fails
      */
-    async update(collectionName, entryId, data) {
-        const response = await this.httpPut(`/developer/agents/${this.agentId}/custom-data/${collectionName}/${entryId}`, data, {
+    async update(collectionName, entryId, data, searchText) {
+        const response = await this.httpPut(`/developer/agents/${this.agentId}/custom-data/${collectionName}/${entryId}`, { data, searchText }, {
             Authorization: `Bearer ${this.apiKey}`,
         });
         if (response.success) {

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

@@ -1,5 +1,5 @@
 import { HttpClient } from "../common/http.client.js";
-import { ApiResponse } from "../interfaces/common.js";
+import { ApiResponse, MCPServerResponse, CreateMCPServerRequest, UpdateMCPServerRequest } from "../interfaces/index.js";
 /**
  * Environment variables response structure from the API
  * The actual environment variables are nested in the 'data' property
@@ -50,5 +50,58 @@ export default class DeveloperApi extends HttpClient {
         message: string;
         key: string;
     }>>;
+    /**
+     * Retrieves all MCP server configurations for the agent
+     * @returns Promise resolving to an ApiResponse containing MCP server configurations
+     */
+    getMCPServers(): Promise<ApiResponse<MCPServerResponse[]>>;
+    /**
+     * Retrieves only active MCP server configurations for the agent
+     * @returns Promise resolving to an ApiResponse containing active MCP server configurations
+     */
+    getActiveMCPServers(): Promise<ApiResponse<MCPServerResponse[]>>;
+    /**
+     * Gets a single MCP server by ID
+     * @param mcpServerId - The ID of the MCP server
+     * @returns Promise resolving to an ApiResponse with the MCP server
+     */
+    getMCPServer(mcpServerId: string): Promise<ApiResponse<MCPServerResponse>>;
+    /**
+     * Creates a new MCP server
+     * @param mcpServerData - The MCP server configuration
+     * @returns Promise resolving to an ApiResponse with the created MCP server
+     */
+    createMCPServer(mcpServerData: CreateMCPServerRequest): Promise<ApiResponse<MCPServerResponse>>;
+    /**
+     * Updates an existing MCP server
+     * @param mcpServerId - The ID of the MCP server to update
+     * @param mcpServerData - The updated MCP server configuration
+     * @returns Promise resolving to an ApiResponse with the updated MCP server
+     */
+    updateMCPServer(mcpServerId: string, mcpServerData: UpdateMCPServerRequest): Promise<ApiResponse<MCPServerResponse>>;
+    /**
+     * Deletes an MCP server
+     * @param mcpServerId - The ID of the MCP server to delete
+     * @returns Promise resolving to an ApiResponse with confirmation
+     */
+    deleteMCPServer(mcpServerId: string): Promise<ApiResponse<void>>;
+    /**
+     * Activates an MCP server
+     * @param mcpServerId - The ID of the MCP server to activate
+     * @returns Promise resolving to an ApiResponse with the activated MCP server
+     */
+    activateMCPServer(mcpServerId: string): Promise<ApiResponse<MCPServerResponse>>;
+    /**
+     * Deactivates an MCP server
+     * @param mcpServerId - The ID of the MCP server to deactivate
+     * @returns Promise resolving to an ApiResponse with the deactivated MCP server
+     */
+    deactivateMCPServer(mcpServerId: string): Promise<ApiResponse<MCPServerResponse>>;
+    /**
+     * Creates or updates an MCP server by name (upsert)
+     * @param mcpServerData - The MCP server configuration
+     * @returns Promise resolving to an ApiResponse with the created/updated MCP server
+     */
+    upsertMCPServer(mcpServerData: CreateMCPServerRequest): Promise<ApiResponse<MCPServerResponse>>;
 }
 export {};

package/dist/api/developer.api.service.js

@@ -48,4 +48,93 @@ export default class DeveloperApi extends HttpClient {
             Authorization: `Bearer ${this.apiKey}`,
         });
     }
+    /**
+     * Retrieves all MCP server configurations for the agent
+     * @returns Promise resolving to an ApiResponse containing MCP server configurations
+     */
+    async getMCPServers() {
+        return this.httpGet(`/developer/agents/${this.agentId}/mcp-servers`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Retrieves only active MCP server configurations for the agent
+     * @returns Promise resolving to an ApiResponse containing active MCP server configurations
+     */
+    async getActiveMCPServers() {
+        return this.httpGet(`/developer/agents/${this.agentId}/mcp-servers/active`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Gets a single MCP server by ID
+     * @param mcpServerId - The ID of the MCP server
+     * @returns Promise resolving to an ApiResponse with the MCP server
+     */
+    async getMCPServer(mcpServerId) {
+        return this.httpGet(`/developer/agents/${this.agentId}/mcp-servers/${mcpServerId}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Creates a new MCP server
+     * @param mcpServerData - The MCP server configuration
+     * @returns Promise resolving to an ApiResponse with the created MCP server
+     */
+    async createMCPServer(mcpServerData) {
+        return this.httpPost(`/developer/agents/${this.agentId}/mcp-servers`, mcpServerData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Updates an existing MCP server
+     * @param mcpServerId - The ID of the MCP server to update
+     * @param mcpServerData - The updated MCP server configuration
+     * @returns Promise resolving to an ApiResponse with the updated MCP server
+     */
+    async updateMCPServer(mcpServerId, mcpServerData) {
+        return this.httpPut(`/developer/agents/${this.agentId}/mcp-servers/${mcpServerId}`, mcpServerData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Deletes an MCP server
+     * @param mcpServerId - The ID of the MCP server to delete
+     * @returns Promise resolving to an ApiResponse with confirmation
+     */
+    async deleteMCPServer(mcpServerId) {
+        return this.httpDelete(`/developer/agents/${this.agentId}/mcp-servers/${mcpServerId}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Activates an MCP server
+     * @param mcpServerId - The ID of the MCP server to activate
+     * @returns Promise resolving to an ApiResponse with the activated MCP server
+     */
+    async activateMCPServer(mcpServerId) {
+        return this.httpPut(`/developer/agents/${this.agentId}/mcp-servers/${mcpServerId}/activate`, {}, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Deactivates an MCP server
+     * @param mcpServerId - The ID of the MCP server to deactivate
+     * @returns Promise resolving to an ApiResponse with the deactivated MCP server
+     */
+    async deactivateMCPServer(mcpServerId) {
+        return this.httpPut(`/developer/agents/${this.agentId}/mcp-servers/${mcpServerId}/deactivate`, {}, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Creates or updates an MCP server by name (upsert)
+     * @param mcpServerData - The MCP server configuration
+     * @returns Promise resolving to an ApiResponse with the created/updated MCP server
+     */
+    async upsertMCPServer(mcpServerData) {
+        return this.httpPost(`/developer/agents/${this.agentId}/mcp-servers/upsert`, mcpServerData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
 }

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

@@ -1,69 +1,7 @@
 import { HttpClient } from "../common/http.client.js";
 import { ApiResponse } from "../interfaces/common.js";
-import { CreateJobDTO, PushJobVersionDTO, UpdateJobVersionDTO } from "../interfaces/jobs.js";
+import { CreateJobDTO, Job, JobVersion, JobExecution, PushJobVersionDTO, UpdateJobVersionDTO, GetJobsResponseData, GetJobExecutionsResponseData, DeleteJobResponseData, UpdateJobMetadataResponseData } 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
@@ -85,7 +23,17 @@ export default class JobApi extends HttpClient {
      */
     getJobs(options?: {
         includeDynamic?: boolean;
-    }): Promise<ApiResponse<GetJobsResponse>>;
+    }): Promise<ApiResponse<GetJobsResponseData>>;
+    /**
+     * Retrieves all jobs for the agent as JobInstance array
+     * @param options - Optional configuration
+     * @param options.includeDynamic - Include dynamically created jobs (default: false)
+     * @returns Promise resolving to an array of JobInstance
+     * @throws Error if the API request fails
+     */
+    getAll(options?: {
+        includeDynamic?: boolean;
+    }): Promise<JobInstance[]>;
     /**
      * Retrieves a job by its unique identifier
      * @param jobId - The unique identifier of the job to retrieve
@@ -100,10 +48,10 @@ export default class JobApi extends HttpClient {
      * @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
+     * @returns Promise resolving to an ApiResponse containing the full job with versions
      * @throws Error if the job creation fails or validation errors occur
      */
-    createJob(jobData: CreateJobDTO): Promise<ApiResponse<CreateJobResponse>>;
+    createJob(jobData: CreateJobDTO): Promise<ApiResponse<Job>>;
     /**
     * Creates a new job for the agent and returns a JobInstance.
     * Supports automatic version creation and activation.
@@ -120,50 +68,42 @@ export default class JobApi extends HttpClient {
      * 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
+     * @returns Promise resolving to an ApiResponse containing the full job version
      * @throws Error if the job is not found or the push operation fails
      */
-    pushJob(jobId: string, versionData: PushJobVersionDTO): Promise<ApiResponse<JobVersionResponse>>;
+    pushJob(jobId: string, versionData: PushJobVersionDTO): Promise<ApiResponse<JobVersion>>;
     /**
      * 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
+     * @returns Promise resolving to an ApiResponse containing the full job version
      * @throws Error if the job is not found or the push operation fails
      */
-    pushDevJob(jobId: string, versionData: PushJobVersionDTO): Promise<ApiResponse<JobVersionResponse>>;
+    pushDevJob(jobId: string, versionData: PushJobVersionDTO): Promise<ApiResponse<JobVersion>>;
     /**
      * 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
+     * @returns Promise resolving to an ApiResponse containing the full updated job version
      * @throws Error if the job or version is not found or the update fails
      */
-    updateDevJob(jobId: string, sandboxVersionId: string, versionData: UpdateJobVersionDTO): Promise<ApiResponse<UpdateJobVersionResponse>>;
+    updateDevJob(jobId: string, sandboxVersionId: string, versionData: UpdateJobVersionDTO): Promise<ApiResponse<JobVersion>>;
     /**
      * 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;
-    }>>;
+    getJobVersions(jobId: string): Promise<ApiResponse<JobVersion[]>>;
     /**
      * 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
+     * @returns Promise resolving to an ApiResponse containing the full updated job
      * @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;
-    }>>;
+    publishJobVersion(jobId: string, version: string): Promise<ApiResponse<Job>>;
     /**
      * Deletes a job and all its versions, or deactivates it if it has versions
      * @param jobId - The unique identifier of the job to delete
@@ -172,34 +112,29 @@ export default class JobApi extends HttpClient {
      *   - 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>>;
+    deleteJob(jobId: string): Promise<ApiResponse<DeleteJobResponseData>>;
     /**
      * 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
+     * @returns Promise resolving to an ApiResponse with the full updated job
      * @throws Error if the job is not found or the operation fails
      */
-    activateJob(jobId: string): Promise<ApiResponse<{
-        message: string;
-        active: boolean;
-    }>>;
+    activateJob(jobId: string): Promise<ApiResponse<Job>>;
     /**
      * 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
+     * @returns Promise resolving to an ApiResponse with the full updated job
      * @throws Error if the job is not found or the operation fails
      */
-    deactivateJob(jobId: string): Promise<ApiResponse<{
-        message: string;
-        active: boolean;
-    }>>;
+    deactivateJob(jobId: string): Promise<ApiResponse<Job>>;
     /**
      * 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
+     * @param versionId - The version identifier to execute (optional, defaults to activeVersionId)
+     * @returns Promise resolving to an ApiResponse with the execution record
      * @throws Error if the job is not found or the operation fails
      */
-    triggerJob(jobId: string): Promise<ApiResponse<JobExecutionResponse>>;
+    triggerJob(jobId: string, versionId?: string): Promise<ApiResponse<JobExecution>>;
     /**
      * Retrieves execution history for a job
      * @param jobId - The unique identifier of the job
@@ -207,9 +142,7 @@ export default class JobApi extends HttpClient {
      * @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[];
-    }>>;
+    getJobExecutions(jobId: string, limit?: number): Promise<ApiResponse<GetJobExecutionsResponseData>>;
     /**
      * Updates the metadata of a job
      * @param jobId - The unique identifier of the job
@@ -217,5 +150,5 @@ export default class JobApi extends HttpClient {
      * @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>>;
+    updateMetadata(jobId: string, metadata: Record<string, any>): Promise<ApiResponse<UpdateJobMetadataResponseData>>;
 }

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

@@ -32,6 +32,20 @@ export default class JobApi extends HttpClient {
             Authorization: `Bearer ${this.apiKey}`,
         });
     }
+    /**
+     * Retrieves all jobs for the agent as JobInstance array
+     * @param options - Optional configuration
+     * @param options.includeDynamic - Include dynamically created jobs (default: false)
+     * @returns Promise resolving to an array of JobInstance
+     * @throws Error if the API request fails
+     */
+    async getAll(options = {}) {
+        const response = await this.getJobs(options);
+        if (response.success && response.data?.jobs) {
+            return response.data.jobs.map(job => new JobInstance(this, job));
+        }
+        throw new Error(response.error?.message || 'Failed to get all jobs');
+    }
     /**
      * Retrieves a job by its unique identifier
      * @param jobId - The unique identifier of the job to retrieve
@@ -54,7 +68,7 @@ export default class JobApi extends HttpClient {
      * @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
+     * @returns Promise resolving to an ApiResponse containing the full job with versions
      * @throws Error if the job creation fails or validation errors occur
      */
     async createJob(jobData) {
@@ -92,7 +106,7 @@ export default class JobApi extends HttpClient {
      * 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
+     * @returns Promise resolving to an ApiResponse containing the full job version
      * @throws Error if the job is not found or the push operation fails
      */
     async pushJob(jobId, versionData) {
@@ -104,7 +118,7 @@ export default class JobApi extends HttpClient {
      * 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
+     * @returns Promise resolving to an ApiResponse containing the full job version
      * @throws Error if the job is not found or the push operation fails
      */
     async pushDevJob(jobId, versionData) {
@@ -117,7 +131,7 @@ export default class JobApi extends HttpClient {
      * @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
+     * @returns Promise resolving to an ApiResponse containing the full updated job version
      * @throws Error if the job or version is not found or the update fails
      */
     async updateDevJob(jobId, sandboxVersionId, versionData) {
@@ -140,11 +154,11 @@ export default class JobApi extends HttpClient {
      * 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
+     * @returns Promise resolving to an ApiResponse containing the full updated job
      * @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, {
+        return this.httpPost(`/developer/jobs/${this.agentId}/${jobId}/${version}/publish`, {}, {
             Authorization: `Bearer ${this.apiKey}`,
         });
     }
@@ -164,7 +178,7 @@ export default class JobApi extends HttpClient {
     /**
      * 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
+     * @returns Promise resolving to an ApiResponse with the full updated job
      * @throws Error if the job is not found or the operation fails
      */
     async activateJob(jobId) {
@@ -175,7 +189,7 @@ export default class JobApi extends HttpClient {
     /**
      * 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
+     * @returns Promise resolving to an ApiResponse with the full updated job
      * @throws Error if the job is not found or the operation fails
      */
     async deactivateJob(jobId) {
@@ -186,11 +200,13 @@ export default class JobApi extends HttpClient {
     /**
      * 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
+     * @param versionId - The version identifier to execute (optional, defaults to activeVersionId)
+     * @returns Promise resolving to an ApiResponse with the execution record
      * @throws Error if the job is not found or the operation fails
      */
-    async triggerJob(jobId) {
-        return this.httpPost(`/developer/jobs/${this.agentId}/${jobId}/trigger`, {}, {
+    async triggerJob(jobId, versionId) {
+        const body = versionId ? { versionId } : {};
+        return this.httpPost(`/developer/jobs/${this.agentId}/${jobId}/trigger`, body, {
             Authorization: `Bearer ${this.apiKey}`,
         });
     }

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

@@ -10,6 +10,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";
 /**
  * Gets or creates User Data API instance.
  * Instance is created once and reused for subsequent calls.
@@ -66,6 +68,20 @@ export declare function getJobInstance(): Promise<JobApi>;
  * @returns ChatApi instance
  */
 export declare function getChatInstance(): Promise<ChatApi>;
+/**
+ * Gets or creates Templates API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns WhatsAppTemplatesApiService instance
+ */
+export declare function getWhatsAppTemplatesInstance(): Promise<WhatsAppTemplatesApiService>;
+/**
+ * Gets or creates CDN API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns CdnApi instance
+ */
+export declare function getCdnInstance(): Promise<CdnApi>;
 /**
  * Clears all cached API instances.
  * Useful for testing or when credentials change.