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

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

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

package/dist/api-exports.d.ts

@@ -26,7 +26,7 @@
  * const products = await Products.search('laptop');
  * ```
  */
-import { LuaSkill, LuaTool, LuaWebhook, LuaWebhookConfig, LuaJob, LuaJobConfig, JobSchedule, PreProcessor, PreProcessorConfig, PostProcessor, PostProcessorConfig, LuaAgent, LuaAgentConfig, env } from "./types/skill.js";
+import { LuaSkill, LuaTool, LuaWebhook, LuaWebhookConfig, LuaJob, LuaJobConfig, JobSchedule, PreProcessor, PreProcessorConfig, PreProcessorAction, PreProcessorResult, PreProcessorBlockResponse, PreProcessorProceedResponse, PostProcessor, PostProcessorConfig, LuaAgent, LuaAgentConfig, env } from "./types/skill.js";
 import { Basket, BasketStatus, UpdateBasketMetadataResponse } from "./interfaces/baskets.js";
 import { OrderResponse, OrderStatus } from "./interfaces/orders.js";
 import { ChatHistoryMessage, ChatHistoryContent, ChatMessage, TextMessage, ImageMessage, FileMessage, PreProcessorOverride, PostProcessorOverride } from "./interfaces/chat.js";
@@ -40,6 +40,7 @@ import { DeleteCustomDataResponse, GetCustomDataResponse, UpdateCustomDataRespon
 import UserDataInstance from "./common/user.instance.js";
 import BasketInstance from "./common/basket.instance.js";
 import OrderInstance from "./common/order.instance.js";
+import { WhatsAppTemplate, PaginatedTemplatesResponse, ListTemplatesOptions, SendTemplateData, SendTemplateResponse } from "./interfaces/whatsapp-templates.js";
 export declare const User: {
     /**
      * Retrieves current user data.
@@ -401,6 +402,84 @@ export declare const AI: {
      */
     generate(context: string, messages: import("./interfaces/chat.js").ChatMessage[], agentId?: string): Promise<string>;
 };
-export { LuaSkill, LuaTool, LuaWebhook, LuaWebhookConfig, LuaJob, LuaJobConfig, JobSchedule, PreProcessor, PreProcessorConfig, PostProcessor, PostProcessorConfig, LuaAgent, LuaAgentConfig, BasketStatus, OrderStatus, env };
+/**
+ * Templates API
+ *
+ * Manage templates across different channel types.
+ * Use the appropriate namespace for your template type:
+ *
+ * - `Templates.whatsapp` - WhatsApp Business templates
+ *
+ * @example
+ * ```typescript
+ * // List WhatsApp templates
+ * const result = await Templates.whatsapp.list(channelId);
+ *
+ * // Send a WhatsApp template
+ * await Templates.whatsapp.send(channelId, templateId, {
+ *   phoneNumbers: ['+447551166594'],
+ *   values: { body: { name: 'John' } }
+ * });
+ * ```
+ */
+export declare const Templates: {
+    /**
+     * WhatsApp Templates
+     *
+     * Pre-approved message formats for WhatsApp Business Accounts.
+     * Required for initiating conversations outside the 24-hour messaging window.
+     */
+    whatsapp: {
+        /**
+         * Lists WhatsApp templates for a channel with optional pagination and search.
+         *
+         * @param channelId - The WhatsApp channel identifier
+         * @param options - Optional pagination and search options
+         * @returns Promise resolving to paginated templates response
+         *
+         * @example
+         * ```typescript
+         * const result = await Templates.whatsapp.list(channelId);
+         * const filtered = await Templates.whatsapp.list(channelId, { search: 'order' });
+         * const paginated = await Templates.whatsapp.list(channelId, { page: 2, limit: 20 });
+         * ```
+         */
+        list(channelId: string, options?: ListTemplatesOptions): Promise<PaginatedTemplatesResponse>;
+        /**
+         * Gets a specific WhatsApp template by ID.
+         *
+         * @param channelId - The WhatsApp channel identifier
+         * @param templateId - The template identifier
+         * @returns Promise resolving to the template
+         *
+         * @example
+         * ```typescript
+         * const template = await Templates.whatsapp.get(channelId, 'template_123');
+         * ```
+         */
+        get(channelId: string, templateId: string): Promise<WhatsAppTemplate>;
+        /**
+         * Sends a WhatsApp template message to one or more phone numbers.
+         *
+         * @param channelId - The WhatsApp channel identifier
+         * @param templateId - The template identifier
+         * @param data - Send data including phone numbers and template values
+         * @returns Promise resolving to the send response with results and errors
+         *
+         * @example
+         * ```typescript
+         * const result = await Templates.whatsapp.send(channelId, 'template_123', {
+         *   phoneNumbers: ['+447551166594'],
+         *   values: {
+         *     body: { first_name: 'John', order_number: '12345' }
+         *   }
+         * });
+         * ```
+         */
+        send(channelId: string, templateId: string, data: SendTemplateData): Promise<SendTemplateResponse>;
+    };
+};
+export { LuaSkill, LuaTool, LuaWebhook, LuaWebhookConfig, LuaJob, LuaJobConfig, JobSchedule, PreProcessor, PreProcessorConfig, PreProcessorAction, PreProcessorResult, PreProcessorBlockResponse, PreProcessorProceedResponse, PostProcessor, PostProcessorConfig, LuaAgent, LuaAgentConfig, BasketStatus, OrderStatus, env };
 export { JobInstance, UserDataInstance, DataEntryInstance, ProductInstance, BasketInstance, OrderInstance };
 export { ChatHistoryMessage, ChatHistoryContent, ChatMessage, TextMessage, ImageMessage, FileMessage, PreProcessorOverride, PostProcessorOverride };
+export { WhatsAppTemplate, PaginatedTemplatesResponse, ListTemplatesOptions, SendTemplateData, SendTemplateResponse, WhatsAppTemplateCategory, WhatsAppTemplateStatus, WhatsAppTemplateComponent, SendTemplateValues } from "./interfaces/whatsapp-templates.js";

package/dist/api-exports.js

@@ -29,7 +29,7 @@
 import { LuaSkill, LuaWebhook, LuaJob, PreProcessor, PostProcessor, LuaAgent, env } from "./types/skill.js";
 import { BasketStatus } from "./interfaces/baskets.js";
 import { OrderStatus } from "./interfaces/orders.js";
-import { getUserInstance, getDataInstance, getProductsInstance, getBasketsInstance, getOrderInstance, getJobInstance, getChatInstance, } from "./api/lazy-instances.js";
+import { getUserInstance, getDataInstance, getProductsInstance, getBasketsInstance, getOrderInstance, getJobInstance, getChatInstance, getWhatsAppTemplatesInstance, } from "./api/lazy-instances.js";
 import { JobInstance } from "./common/job.instance.js";
 import ProductInstance from "./common/product.instance.js";
 import DataEntryInstance from "./common/data.entry.instance.js";
@@ -436,11 +436,10 @@ export const Jobs = {
         const executeString = config.execute.toString();
         console.log('Creating Job');
         // Create the job with initial version and activation in one call
-        const createResult = await instance.createJobInstance({
+        return await instance.createJobInstance({
             dynamic: true,
             name: config.name,
             description: config.description,
-            context: config.description || '',
             schedule: config.schedule,
             timeout: config.timeout,
             retry: config.retry,
@@ -449,7 +448,6 @@ export const Jobs = {
             version: {
                 version: '1.0.0',
                 description: config.description,
-                context: config.description || '',
                 code: '', // Will be set by server
                 executeFunction: executeString,
                 timeout: config.timeout,
@@ -459,17 +457,6 @@ export const Jobs = {
             // Activate immediately
             activate: config.activate ?? true
         });
-        const jobId = createResult.jobId;
-        // Server has created the job, version, and activated it
-        // Return a JobInstance for easy manipulation
-        return new JobInstance(instance, {
-            id: jobId,
-            jobId: jobId,
-            name: config.name,
-            schedule: config.schedule,
-            metadata: config.metadata || {},
-            active: config.activate ?? true
-        });
     },
     /**
      * Retrieves a job by its unique identifier
@@ -543,6 +530,95 @@ export const AI = {
     }
 };
 // ============================================================================
+// TEMPLATES API
+// ============================================================================
+/**
+ * Templates API
+ *
+ * Manage templates across different channel types.
+ * Use the appropriate namespace for your template type:
+ *
+ * - `Templates.whatsapp` - WhatsApp Business templates
+ *
+ * @example
+ * ```typescript
+ * // List WhatsApp templates
+ * const result = await Templates.whatsapp.list(channelId);
+ *
+ * // Send a WhatsApp template
+ * await Templates.whatsapp.send(channelId, templateId, {
+ *   phoneNumbers: ['+447551166594'],
+ *   values: { body: { name: 'John' } }
+ * });
+ * ```
+ */
+export const Templates = {
+    /**
+     * WhatsApp Templates
+     *
+     * Pre-approved message formats for WhatsApp Business Accounts.
+     * Required for initiating conversations outside the 24-hour messaging window.
+     */
+    whatsapp: {
+        /**
+         * Lists WhatsApp templates for a channel with optional pagination and search.
+         *
+         * @param channelId - The WhatsApp channel identifier
+         * @param options - Optional pagination and search options
+         * @returns Promise resolving to paginated templates response
+         *
+         * @example
+         * ```typescript
+         * const result = await Templates.whatsapp.list(channelId);
+         * const filtered = await Templates.whatsapp.list(channelId, { search: 'order' });
+         * const paginated = await Templates.whatsapp.list(channelId, { page: 2, limit: 20 });
+         * ```
+         */
+        async list(channelId, options) {
+            const instance = await getWhatsAppTemplatesInstance();
+            return instance.list(channelId, options);
+        },
+        /**
+         * Gets a specific WhatsApp template by ID.
+         *
+         * @param channelId - The WhatsApp channel identifier
+         * @param templateId - The template identifier
+         * @returns Promise resolving to the template
+         *
+         * @example
+         * ```typescript
+         * const template = await Templates.whatsapp.get(channelId, 'template_123');
+         * ```
+         */
+        async get(channelId, templateId) {
+            const instance = await getWhatsAppTemplatesInstance();
+            return instance.get(channelId, templateId);
+        },
+        /**
+         * Sends a WhatsApp template message to one or more phone numbers.
+         *
+         * @param channelId - The WhatsApp channel identifier
+         * @param templateId - The template identifier
+         * @param data - Send data including phone numbers and template values
+         * @returns Promise resolving to the send response with results and errors
+         *
+         * @example
+         * ```typescript
+         * const result = await Templates.whatsapp.send(channelId, 'template_123', {
+         *   phoneNumbers: ['+447551166594'],
+         *   values: {
+         *     body: { first_name: 'John', order_number: '12345' }
+         *   }
+         * });
+         * ```
+         */
+        async send(channelId, templateId, data) {
+            const instance = await getWhatsAppTemplatesInstance();
+            return instance.send(channelId, templateId, data);
+        }
+    }
+};
+// ============================================================================
 // EXPORTS
 // ============================================================================
 // Export skill classes and utilities

package/dist/commands/chat.js

@@ -123,10 +123,8 @@ async function startChatLoop(chatEnv) {
     console.log(`Environment: ${chatEnv.type === 'sandbox' ? '🔧 Sandbox' : '🚀 Production'}`);
     console.log("Press Ctrl+C to exit");
     console.log("=".repeat(60) + "\n");
-    // Welcome message from config or default
-    const config = readSkillConfig();
-    const welcomeMessage = config?.agent?.welcomeMessage || "Hi there! How can I help you today?";
-    console.log(`🌙 Assistant: ${welcomeMessage}\n`);
+    // Welcome message
+    console.log("🌙 Assistant: Hi there! How can I help you today?\n");
     // Create readline interface
     const rl = readline.createInterface({
         input: process.stdin,

package/dist/commands/init.js

@@ -111,7 +111,6 @@ export async function initCommand() {
         let selectedAgent;
         let selectedOrg;
         let persona;
-        let welcomeMessage;
         let skipProjectInit = false;
         if (agentChoice === "existing") {
             // Step 4a: Select existing agent
@@ -119,7 +118,6 @@ export async function initCommand() {
             selectedAgent = result.agent;
             selectedOrg = result.org;
             persona = result.persona;
-            welcomeMessage = result.welcomeMessage;
         }
         else {
             // Step 4b: Create new agent
@@ -127,22 +125,21 @@ export async function initCommand() {
             selectedAgent = result.agent;
             selectedOrg = result.org;
             persona = result.persona;
-            welcomeMessage = result.welcomeMessage;
         }
         // Step 5: Initialize or update project
         if (yamlExists) {
             // Update existing YAML and LuaAgent in index.ts
             writeInfo("📝 Updating existing lua.skill.yaml with new agent...");
-            updateYamlAgent(selectedAgent.agentId, selectedOrg.id, persona, welcomeMessage);
+            updateYamlAgent(selectedAgent.agentId, selectedOrg.id, persona);
             // Also update LuaAgent in index.ts if it exists
             const { updateLuaAgentInIndexFile } = await import("../utils/init-helpers.js");
-            updateLuaAgentInIndexFile(process.cwd(), selectedAgent.name, persona, welcomeMessage);
+            updateLuaAgentInIndexFile(process.cwd(), selectedAgent.name, persona);
             writeSuccess("✅ lua.skill.yaml updated successfully!");
             writeSuccess("✅ LuaAgent configuration updated!");
         }
         else {
             // Full project initialization
-            const currentDir = initializeProject(selectedAgent.agentId, selectedOrg.id, persona, welcomeMessage, selectedAgent.name);
+            const currentDir = initializeProject(selectedAgent.agentId, selectedOrg.id, persona, selectedAgent.name);
             // Step 6: Install dependencies
             await installDependencies(currentDir);
             writeSuccess("✅ Lua skill project initialized successfully!");
@@ -151,11 +148,11 @@ export async function initCommand() {
 }
 /**
  * Handles the flow for selecting an existing agent.
- * Fetches the agent details from the server to get persona and welcomeMessage.
+ * Fetches the agent details from the server to get persona.
  *
  * @param userData - User's data
  * @param apiKey - User's API key
- * @returns Selected agent, organization, and optional persona/welcome message
+ * @returns Selected agent, organization, and optional persona
  */
 async function selectExistingAgent(userData, apiKey) {
     // Extract organizations
@@ -167,13 +164,12 @@ async function selectExistingAgent(userData, apiKey) {
     const selectedOrg = await promptOrganizationSelection(orgs);
     // Select agent from organization
     const selectedAgent = await promptAgentSelection(selectedOrg);
-    // Fetch agent details to get persona and welcomeMessage
+    // Fetch agent details to get persona
     const agentDetails = await fetchExistingAgentDetails(apiKey, selectedAgent.agentId);
     return {
         agent: selectedAgent,
         org: selectedOrg,
-        persona: agentDetails.persona,
-        welcomeMessage: agentDetails.welcomeMessage
+        persona: agentDetails.persona
     };
 }
 /**
@@ -181,7 +177,7 @@ async function selectExistingAgent(userData, apiKey) {
  *
  * @param apiKey - User's API key
  * @param userData - User data containing organizations
- * @returns Created agent, organization, and optional persona/welcome message
+ * @returns Created agent, organization, and optional persona
  */
 async function createNewAgentFlow(apiKey, userData) {
     // Fetch and select agent type
@@ -275,14 +271,12 @@ async function handleAgentSwitch(userData, apiKey, existingYaml) {
     let selectedAgent;
     let selectedOrg;
     let persona;
-    let welcomeMessage;
     if (agentChoice === "existing") {
         // Select existing agent
         const result = await selectExistingAgent(userData, apiKey);
         selectedAgent = result.agent;
         selectedOrg = result.org;
         persona = result.persona;
-        welcomeMessage = result.welcomeMessage;
     }
     else {
         // Create new agent
@@ -290,17 +284,15 @@ async function handleAgentSwitch(userData, apiKey, existingYaml) {
         selectedAgent = result.agent;
         selectedOrg = result.org;
         persona = result.persona;
-        welcomeMessage = result.welcomeMessage;
     }
-    // Ask about persona and welcome message
+    // Ask about persona
     const finalPersona = await promptPersonaReplacement(existingYaml, persona);
-    const finalWelcomeMessage = await promptWelcomeMessageReplacement(existingYaml, welcomeMessage);
     // Update existing YAML file with new agent
     writeInfo("\n📝 Updating lua.skill.yaml with new agent...");
-    updateYamlAgent(selectedAgent.agentId, selectedOrg.id, finalPersona, finalWelcomeMessage);
+    updateYamlAgent(selectedAgent.agentId, selectedOrg.id, finalPersona);
     // Also update LuaAgent in index.ts if it exists
     const { updateLuaAgentInIndexFile } = await import("../utils/init-helpers.js");
-    updateLuaAgentInIndexFile(process.cwd(), selectedAgent.name, finalPersona, finalWelcomeMessage);
+    updateLuaAgentInIndexFile(process.cwd(), selectedAgent.name, finalPersona);
     writeSuccess("✅ lua.skill.yaml updated successfully!");
     writeSuccess("✅ LuaAgent configuration updated!");
     writeInfo("\n💡 Your project now uses the new agent. Run 'lua compile' to update your skills.\n");
@@ -331,28 +323,3 @@ async function promptPersonaReplacement(existingYaml, newPersona) {
     ]);
     return replacePersona ? newPersona : existingPersona;
 }
-/**
- * Prompt user about replacing existing welcome message
- */
-async function promptWelcomeMessageReplacement(existingYaml, newWelcomeMessage) {
-    const existingWelcomeMessage = existingYaml?.agent?.welcomeMessage;
-    // If no existing welcome message, use new one
-    if (!existingWelcomeMessage) {
-        return newWelcomeMessage;
-    }
-    // If no new welcome message, keep existing
-    if (!newWelcomeMessage) {
-        return existingWelcomeMessage;
-    }
-    // Both exist - ask user
-    writeInfo("   Existing welcome message found in project");
-    const { replaceWelcomeMessage } = await inquirer.prompt([
-        {
-            type: 'confirm',
-            name: 'replaceWelcomeMessage',
-            message: 'Replace existing welcome message with the new agent\'s welcome message?',
-            default: false
-        }
-    ]);
-    return replaceWelcomeMessage ? newWelcomeMessage : existingWelcomeMessage;
-}

package/dist/commands/jobs.js

@@ -203,8 +203,8 @@ async function viewJobVersions(context, config) {
         if (!response.success || !response.data) {
             throw new Error(response.error?.message || 'Failed to fetch versions');
         }
-        const versions = response.data.versions || [];
-        const activeVersionId = response.data.activeVersionId;
+        const versions = response.data;
+        const activeVersionId = selectedJob.activeVersionId;
         if (versions.length === 0) {
             console.log(`\nℹ️  No versions found for ${selectedJob.name}.\n`);
             console.log("💡 Push a version first using 'lua push job'.\n");
@@ -270,8 +270,8 @@ async function deployJobVersion(context, config) {
         if (!response.success || !response.data) {
             throw new Error(response.error?.message || 'Failed to fetch versions');
         }
-        const versions = response.data.versions || [];
-        const activeVersionId = response.data.activeVersionId;
+        const versions = response.data;
+        const activeVersionId = selectedJob.activeVersionId;
         if (versions.length === 0) {
             console.log(`\nℹ️  No versions found for ${selectedJob.name}.\n`);
             console.log("💡 Push a version first using 'lua push job'.\n");
@@ -434,7 +434,7 @@ async function triggerJob(context, config) {
     const response = await jobApi.triggerJob(jobAnswer.selectedJob.jobId);
     if (response.success && response.data) {
         writeSuccess(`✅ Job "${jobAnswer.selectedJob.name}" triggered successfully`);
-        writeInfo(`📋 Execution ID: ${response.data.executionId || 'N/A'}`);
+        writeInfo(`📋 Execution ID: ${response.data.id || 'N/A'}`);
     }
     else {
         console.error(`❌ Failed to trigger job: ${response.error?.message || 'Unknown error'}`);

package/dist/commands/push.js

@@ -434,7 +434,6 @@ async function pushWebhookVersion() {
             name: selectedWebhook.name,
             version: versionToPush,
             description: bundledWebhookData.description || selectedWebhook.description || `Webhook: ${selectedWebhook.name}`,
-            context: bundledWebhookData.context || selectedWebhook.context || '',
             webhookId: selectedWebhook.webhookId,
             querySchema: bundledWebhookData.querySchema,
             headerSchema: bundledWebhookData.headerSchema,
@@ -459,7 +458,8 @@ async function pushWebhookVersion() {
         }
         const result = await response.json();
         writeSuccess(`\n✅ Successfully pushed ${selectedWebhook.name} v${versionToPush}\n`);
-        writeInfo(`📦 Webhook URL: ${BASE_URLS.WEBHOOK}/${config.agent.agentId}/${selectedWebhook.webhookId}`);
+        writeInfo(`📦 Webhook URL (id):   ${BASE_URLS.WEBHOOK}/${config.agent.agentId}/${selectedWebhook.webhookId}`);
+        writeInfo(`🔗 Webhook URL (name): ${BASE_URLS.WEBHOOK}/${config.agent.agentId}/${selectedWebhook.name}`);
         // Step 8: Ask if user wants to deploy now
         const deployAnswer = await safePrompt([
             {
@@ -633,7 +633,6 @@ async function pushJobVersion() {
             name: selectedJob.name,
             version: versionToPush,
             description: bundledJobData.description || selectedJob.description || `Job: ${selectedJob.name}`,
-            context: bundledJobData.context || selectedJob.context || '',
             jobId: selectedJob.jobId,
             schedule: bundledJobData.schedule || selectedJob.schedule,
             timeout: bundledJobData.timeout,
@@ -780,7 +779,6 @@ async function pushPreProcessorVersion() {
                 name: selected.name,
                 version: confirmedVersion,
                 description: bundledData.description || selected.description,
-                context: bundledData.context || selected.context,
                 preprocessorId: selected.preprocessorId,
                 code: bundledData.code,
                 executeFunction: bundledData.executeFunction,
@@ -912,7 +910,6 @@ async function pushPostProcessorVersion() {
                 name: selected.name,
                 version: confirmedVersion,
                 description: bundledData.description || selected.description,
-                context: bundledData.context || selected.context,
                 postprocessorId: selected.postprocessorId,
                 code: bundledData.code,
                 executeFunction: bundledData.executeFunction,
@@ -1193,7 +1190,6 @@ async function pushAllCommand(options) {
                     name: webhookConfig.name,
                     version: newVersion,
                     description: webhookData.description || webhookConfig.description || '',
-                    context: webhookData.context || webhookConfig.context || '',
                     webhookId: webhookConfig.webhookId,
                     querySchema: webhookData.querySchema,
                     headerSchema: webhookData.headerSchema,
@@ -1254,7 +1250,6 @@ async function pushAllCommand(options) {
                     name: jobConfig.name,
                     version: newVersion,
                     description: jobData.description || jobConfig.description || '',
-                    context: jobData.context || jobConfig.context || '',
                     jobId: jobConfig.jobId,
                     schedule: jobData.schedule || jobConfig.schedule,
                     timeout: jobData.timeout,
@@ -1319,7 +1314,6 @@ async function pushAllCommand(options) {
                     name: processorConfig.name,
                     version: newVersion,
                     description: processorData.description || processorConfig.description || '',
-                    context: processorData.context || processorConfig.context || '',
                     preprocessorId: preprocessorId,
                     code: processorData.code,
                     executeFunction: processorData.executeFunction,
@@ -1374,7 +1368,6 @@ async function pushAllCommand(options) {
                     name: processorConfig.name,
                     version: newVersion,
                     description: processorData.description || processorConfig.description || '',
-                    context: processorData.context || processorConfig.context || '',
                     postprocessorId: postprocessorId,
                     code: processorData.code,
                     executeFunction: processorData.executeFunction,

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

@@ -4,6 +4,7 @@
  */
 import JobApi from '../api/job.api.service.js';
 import UserDataInstance from './user.instance.js';
+import { Job, JobVersion, JobExecution } from '../interfaces/jobs.js';
 /**
  * Job Instance class.
  * Represents a single job with helper methods for common operations.
@@ -36,15 +37,15 @@ export declare class JobInstance {
     private _data;
     readonly id: string;
     readonly name: string;
-    readonly jobId: string;
-    readonly schedule: any;
+    /** The active version of the job (if one exists) */
+    readonly activeVersion?: JobVersion;
     metadata: Record<string, any>;
-    private userApi;
-    constructor(jobApi: JobApi, jobData: any);
+    private userApi?;
+    constructor(jobApi: JobApi, jobData: Job);
     /**
      * Gets the full job data.
      */
-    get data(): any;
+    get data(): Job;
     /**
      * Updates the job's metadata.
      *
@@ -61,7 +62,7 @@ export declare class JobInstance {
      */
     updateMetadata(metadata: Record<string, any>): Promise<void>;
     /**
-     * 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
      *
@@ -72,9 +73,36 @@ export declare class JobInstance {
      * ```
      */
     delete(): Promise<void>;
+    /**
+     * 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);
+     * ```
+     */
     user(): Promise<UserDataInstance>;
+    /**
+     * 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);
+     * ```
+     */
+    trigger(versionId?: string): Promise<JobExecution>;
     /**
      * Converts the job instance to JSON.
      */
-    toJSON(): any;
+    toJSON(): Job;
 }