lua-cli 2.5.7 → 3.0.0-alpha.1

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

@@ -14,6 +14,9 @@ import { CreateSlackChannelRequest } from "../interfaces/agent.js";
 import { CreateSlackChannelResponse } from "../interfaces/agent.js";
 import { CreateEmailChannelRequest } from "../interfaces/agent.js";
 import { CreateEmailChannelResponse } from "../interfaces/agent.js";
+import { GetAgentFeaturesResponse } from "../interfaces/agent.js";
+import { UpdateAgentFeatureRequest } from "../interfaces/agent.js";
+import { UpdateAgentFeatureResponse } from "../interfaces/agent.js";
 /**
  * Agent API calls
  */
@@ -94,4 +97,46 @@ export default class AgentApi extends HttpClient {
      * @throws Error if the API request fails or the channel creation is unsuccessful
      */
     createEmailChannel(agentId: string, channelData: CreateEmailChannelRequest): Promise<ApiResponse<CreateEmailChannelResponse>>;
+    /**
+     * Retrieves all features configured for a specific agent
+     * @param agentId - The unique identifier of the agent
+     * @returns Promise resolving to an ApiResponse containing an array of agent features
+     * @throws Error if the API request fails or the agent is not found
+     * @example
+     * const features = await agentApi.getAgentFeatures('baseAgent_agent_123');
+     * features.data.features.forEach(feature => {
+     *   console.log(`${feature.title}: ${feature.active ? 'enabled' : 'disabled'}`);
+     * });
+     */
+    getAgentFeatures(agentId: string): Promise<ApiResponse<GetAgentFeaturesResponse>>;
+    /**
+     * Updates a specific feature for an agent
+     * @param agentId - The unique identifier of the agent
+     * @param featureData - The feature update configuration
+     * @param featureData.featureName - The name of the feature to update (required)
+     * @param featureData.active - Whether the feature should be enabled or disabled (optional)
+     * @param featureData.featureContext - Custom context/instructions for the feature (optional)
+     * @returns Promise resolving to an ApiResponse with success message
+     * @throws Error if the API request fails, the agent/feature is not found, or neither active nor featureContext is provided
+     * @example
+     * // Enable a feature
+     * await agentApi.updateAgentFeature('baseAgent_agent_123', {
+     *   featureName: 'inquiry',
+     *   active: true
+     * });
+     *
+     * // Update feature context
+     * await agentApi.updateAgentFeature('baseAgent_agent_123', {
+     *   featureName: 'tickets',
+     *   featureContext: 'Custom instructions for ticket handling'
+     * });
+     *
+     * // Update both
+     * await agentApi.updateAgentFeature('baseAgent_agent_123', {
+     *   featureName: 'rag',
+     *   active: true,
+     *   featureContext: 'Enhanced RAG search instructions'
+     * });
+     */
+    updateAgentFeature(agentId: string, featureData: UpdateAgentFeatureRequest): Promise<ApiResponse<UpdateAgentFeatureResponse>>;
 }

package/dist/api/agent.api.service.js

@@ -117,4 +117,58 @@ export default class AgentApi extends HttpClient {
             Authorization: `Bearer ${this.apiKey}`,
         });
     }
+    /**
+     * Retrieves all features configured for a specific agent
+     * @param agentId - The unique identifier of the agent
+     * @returns Promise resolving to an ApiResponse containing an array of agent features
+     * @throws Error if the API request fails or the agent is not found
+     * @example
+     * const features = await agentApi.getAgentFeatures('baseAgent_agent_123');
+     * features.data.features.forEach(feature => {
+     *   console.log(`${feature.title}: ${feature.active ? 'enabled' : 'disabled'}`);
+     * });
+     */
+    async getAgentFeatures(agentId) {
+        return this.httpGet(`/admin/agents/${agentId}/features`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Updates a specific feature for an agent
+     * @param agentId - The unique identifier of the agent
+     * @param featureData - The feature update configuration
+     * @param featureData.featureName - The name of the feature to update (required)
+     * @param featureData.active - Whether the feature should be enabled or disabled (optional)
+     * @param featureData.featureContext - Custom context/instructions for the feature (optional)
+     * @returns Promise resolving to an ApiResponse with success message
+     * @throws Error if the API request fails, the agent/feature is not found, or neither active nor featureContext is provided
+     * @example
+     * // Enable a feature
+     * await agentApi.updateAgentFeature('baseAgent_agent_123', {
+     *   featureName: 'inquiry',
+     *   active: true
+     * });
+     *
+     * // Update feature context
+     * await agentApi.updateAgentFeature('baseAgent_agent_123', {
+     *   featureName: 'tickets',
+     *   featureContext: 'Custom instructions for ticket handling'
+     * });
+     *
+     * // Update both
+     * await agentApi.updateAgentFeature('baseAgent_agent_123', {
+     *   featureName: 'rag',
+     *   active: true,
+     *   featureContext: 'Enhanced RAG search instructions'
+     * });
+     */
+    async updateAgentFeature(agentId, featureData) {
+        // Validate that at least one optional field is provided
+        if (featureData.active === undefined && featureData.featureContext === undefined) {
+            throw new Error('At least one of "active" or "featureContext" must be provided');
+        }
+        return this.httpPut(`/admin/agents/${agentId}/features`, featureData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
 }

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

@@ -0,0 +1,210 @@
+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 {
+    private apiKey;
+    private agentId;
+    /**
+     * 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
+     * @param jobData - The job data including name, description, and optional context
+     * @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
+    * @param jobData - The job data including name, description, and optional context
+    * @returns Promise resolving to an JobInstance containing the created job details
+    * @throws Error if the job creation fails or validation errors occur
+    */
+    createJobInstance(jobData: CreateJobDTO): Promise<JobInstance>;
+    /**
+     * 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,200 @@
+import { HttpClient } from "../common/http.client.js";
+import { JobInstance } from "../common/job.instance.js";
+/**
+ * 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
+     * @param jobData - The job data including name, description, and optional context
+     * @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
+    * @param jobData - The job data including name, description, and optional context
+    * @returns Promise resolving to an JobInstance containing the created job details
+    * @throws Error if the job creation fails or validation errors occur
+    */
+    async createJobInstance(jobData) {
+        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');
+    }
+    /**
+     * 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;
 }