lua-cli 2.2.8-alpha.1 → 2.3.0-alpha.1

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

@@ -0,0 +1,45 @@
+import { HttpClient } from "../common/http.client.js";
+import { ApiResponse } from "../interfaces/common.js";
+import { Organization } from "../interfaces/admin.js";
+import { AgentType } from "../interfaces/agent.js";
+import { CreateAgentRequest } from "../interfaces/agent.js";
+import { CreateAgentResponse } from "../interfaces/agent.js";
+import { Agent } from "../interfaces/agent.js";
+/**
+ * Agent API calls
+ */
+export default class AgentApi extends HttpClient {
+    private apiKey;
+    /**
+     * Creates an instance of AgentApi
+     * @param baseUrl - The base URL for the API
+     * @param apiKey - The API key for authentication
+     */
+    constructor(baseUrl: string, apiKey: string);
+    /**
+     * Retrieves all organizations associated with the authenticated user
+     * @returns Promise resolving to an ApiResponse containing an array of Organization objects
+     * @throws Error if the API request fails
+     */
+    getOrganizations(): Promise<ApiResponse<Organization[]>>;
+    /**
+     * Retrieves all available agent types that can be created
+     * @returns Promise resolving to an ApiResponse containing an array of AgentType objects
+     * @throws Error if the API request fails
+     */
+    getAgentTypes(): Promise<ApiResponse<AgentType[]>>;
+    /**
+     * Creates a new agent with the provided configuration
+     * @param agentData - The agent configuration data including name, type, and other settings
+     * @returns Promise resolving to an ApiResponse containing the created agent details
+     * @throws Error if the API request fails or agent creation is unsuccessful
+     */
+    createAgent(agentData: CreateAgentRequest): Promise<ApiResponse<CreateAgentResponse>>;
+    /**
+     * Retrieves detailed information about a specific agent
+     * @param agentId - The unique identifier of the agent to retrieve
+     * @returns Promise resolving to an ApiResponse containing the Agent details
+     * @throws Error if the API request fails or the agent is not found
+     */
+    getAgent(agentId: string): Promise<ApiResponse<Agent>>;
+}

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

@@ -0,0 +1,57 @@
+import { HttpClient } from "../common/http.client.js";
+/**
+ * Agent API calls
+ */
+export default class AgentApi extends HttpClient {
+    /**
+     * Creates an instance of AgentApi
+     * @param baseUrl - The base URL for the API
+     * @param apiKey - The API key for authentication
+     */
+    constructor(baseUrl, apiKey) {
+        super(baseUrl);
+        this.apiKey = apiKey;
+    }
+    /**
+     * Retrieves all organizations associated with the authenticated user
+     * @returns Promise resolving to an ApiResponse containing an array of Organization objects
+     * @throws Error if the API request fails
+     */
+    async getOrganizations() {
+        return this.httpGet(`/admin`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Retrieves all available agent types that can be created
+     * @returns Promise resolving to an ApiResponse containing an array of AgentType objects
+     * @throws Error if the API request fails
+     */
+    async getAgentTypes() {
+        return this.httpGet(`/agents/self-serve/types`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Creates a new agent with the provided configuration
+     * @param agentData - The agent configuration data including name, type, and other settings
+     * @returns Promise resolving to an ApiResponse containing the created agent details
+     * @throws Error if the API request fails or agent creation is unsuccessful
+     */
+    async createAgent(agentData) {
+        return this.httpPost(`/agents/self-serve/create`, agentData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+    /**
+     * Retrieves detailed information about a specific agent
+     * @param agentId - The unique identifier of the agent to retrieve
+     * @returns Promise resolving to an ApiResponse containing the Agent details
+     * @throws Error if the API request fails or the agent is not found
+     */
+    async getAgent(agentId) {
+        return this.httpGet(`/admin/agents/${agentId}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+}

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

@@ -0,0 +1,48 @@
+import { HttpClient } from "../common/http.client.js";
+import { ApiResponse } from "../interfaces/common.js";
+import { UserData } from "../interfaces/admin.js";
+/**
+ * Authentication API calls
+ */
+export default class AuthApi extends HttpClient {
+    /**
+     * Creates an instance of AuthApi
+     * @param baseUrl - The base URL for the API
+     */
+    constructor(baseUrl: string);
+    /**
+     * Validates an API key and retrieves associated user data
+     * @param apiKey - The API key to validate
+     * @returns Promise resolving to an ApiResponse containing UserData if the key is valid
+     * @throws Error if the API key is invalid or the request fails
+     */
+    checkApiKey(apiKey: string): Promise<ApiResponse<UserData>>;
+    /**
+     * Sends a one-time password (OTP) to the specified email address
+     * @param email - The email address to send the OTP to
+     * @returns Promise resolving to an ApiResponse with a success message
+     * @throws Error if the email is invalid or the request fails
+     */
+    sendOtp(email: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Verifies the OTP sent to the user's email and returns a sign-in token
+     * @param email - The email address the OTP was sent to
+     * @param otp - The one-time password received via email
+     * @returns Promise resolving to an ApiResponse containing a signInToken for authentication
+     * @throws Error if the OTP is invalid, expired, or the request fails
+     */
+    verifyOtp(email: string, otp: string): Promise<ApiResponse<{
+        signInToken: string;
+    }>>;
+    /**
+     * Exchanges a sign-in token for an API key
+     * @param signInToken - The temporary sign-in token obtained from OTP verification
+     * @returns Promise resolving to an ApiResponse containing the API key
+     * @throws Error if the sign-in token is invalid or the request fails
+     */
+    getApiKey(signInToken: string): Promise<ApiResponse<{
+        apiKey: string;
+    }>>;
+}

package/dist/api/auth.api.service.js

@@ -0,0 +1,54 @@
+import { HttpClient } from "../common/http.client.js";
+/**
+ * Authentication API calls
+ */
+export default class AuthApi extends HttpClient {
+    /**
+     * Creates an instance of AuthApi
+     * @param baseUrl - The base URL for the API
+     */
+    constructor(baseUrl) {
+        super(baseUrl);
+    }
+    /**
+     * Validates an API key and retrieves associated user data
+     * @param apiKey - The API key to validate
+     * @returns Promise resolving to an ApiResponse containing UserData if the key is valid
+     * @throws Error if the API key is invalid or the request fails
+     */
+    async checkApiKey(apiKey) {
+        return this.httpGet(`/admin`, {
+            Authorization: `Bearer ${apiKey}`,
+        });
+    }
+    /**
+     * Sends a one-time password (OTP) to the specified email address
+     * @param email - The email address to send the OTP to
+     * @returns Promise resolving to an ApiResponse with a success message
+     * @throws Error if the email is invalid or the request fails
+     */
+    async sendOtp(email) {
+        return this.httpPost(`/otp`, { email, type: 'email' });
+    }
+    /**
+     * Verifies the OTP sent to the user's email and returns a sign-in token
+     * @param email - The email address the OTP was sent to
+     * @param otp - The one-time password received via email
+     * @returns Promise resolving to an ApiResponse containing a signInToken for authentication
+     * @throws Error if the OTP is invalid, expired, or the request fails
+     */
+    async verifyOtp(email, otp) {
+        return this.httpPost(`/otp/verify`, { email, pin: otp, type: 'email' });
+    }
+    /**
+     * Exchanges a sign-in token for an API key
+     * @param signInToken - The temporary sign-in token obtained from OTP verification
+     * @returns Promise resolving to an ApiResponse containing the API key
+     * @throws Error if the sign-in token is invalid or the request fails
+     */
+    async getApiKey(signInToken) {
+        return this.httpPost(`/profile/apiKey`, undefined, {
+            Authorization: `Bearer ${signInToken}`,
+        });
+    }
+}

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

@@ -0,0 +1,85 @@
+import BasketInstance from "../common/basket.instance.js";
+import { HttpClient } from "../common/http.client.js";
+import OrderInstance from "../common/order.instance.js";
+import { BasketStatus, CreateBasketRequest, AddItemToBasketRequest, Basket } from "../interfaces/baskets.js";
+import { UpdateBasketMetadataResponse } from "../interfaces/baskets.js";
+import { BasketAPI } from "../types/index.js";
+export default class BasketApi extends HttpClient implements BasketAPI {
+    private apiKey;
+    private agentId;
+    /**
+     * Creates an instance of BasketApi
+     * @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);
+    /**
+     * Creates a new user basket
+     * @param basketData - The basket creation request data containing user ID and optional metadata
+     * @returns Promise resolving to a BasketInstance representing the created basket
+     * @throws Error if the basket creation fails or the API request is unsuccessful
+     */
+    create(basketData: CreateBasketRequest): Promise<BasketInstance>;
+    /**
+     * Retrieves all user baskets with optional status filtering
+     * @param status - Optional basket status to filter by (e.g., 'active', 'completed', 'abandoned')
+     * @returns Promise resolving to an array of BasketInstance objects
+     * @throws Error if the request fails or baskets cannot be retrieved
+     */
+    get(status?: BasketStatus): Promise<BasketInstance[]>;
+    /**
+     * Retrieves a single basket by its unique identifier
+     * @param basketId - The unique identifier of the basket to retrieve
+     * @returns Promise resolving to a BasketInstance representing the basket
+     * @throws Error if the basket is not found or the request fails
+     */
+    getById(basketId: string): Promise<BasketInstance>;
+    /**
+     * Adds an item to a specific basket
+     * @param basketId - The unique identifier of the basket
+     * @param itemData - The item data including product ID, quantity, and optional metadata
+     * @returns Promise resolving to the updated Basket object
+     * @throws Error if the basket is not found or the item cannot be added
+     */
+    addItem(basketId: string, itemData: AddItemToBasketRequest): Promise<Basket>;
+    /**
+     * Removes a specific item from a basket
+     * @param basketId - The unique identifier of the basket
+     * @param itemId - The unique identifier of the item to remove
+     * @returns Promise resolving to the updated Basket object
+     * @throws Error if the basket or item is not found or the removal fails
+     */
+    removeItem(basketId: string, itemId: string): Promise<Basket>;
+    /**
+     * Clears all items from a basket
+     * @param basketId - The unique identifier of the basket to clear
+     * @returns Promise resolving to the updated empty Basket object
+     * @throws Error if the basket is not found or the clear operation fails
+     */
+    clear(basketId: string): Promise<Basket>;
+    /**
+     * Updates the status of a basket
+     * @param basketId - The unique identifier of the basket
+     * @param status - The new status to set for the basket
+     * @returns Promise resolving to the updated BasketStatus
+     * @throws Error if the basket is not found or the status update fails
+     */
+    updateStatus(basketId: string, status: BasketStatus): Promise<BasketStatus>;
+    /**
+     * Updates the metadata of a basket
+     * @param basketId - The unique identifier of the basket
+     * @param metadata - The metadata object to update or merge with existing metadata
+     * @returns Promise resolving to the updated metadata
+     * @throws Error if the basket is not found or the metadata update fails
+     */
+    updateMetadata(basketId: string, metadata: any): Promise<UpdateBasketMetadataResponse>;
+    /**
+     * Creates an order from a basket
+     * @param data - Additional order data (shipping info, payment details, etc.)
+     * @param basketId - The unique identifier of the basket to convert to an order
+     * @returns Promise resolving to an OrderInstance representing the created order
+     * @throws Error if the basket is not found or the order creation fails
+     */
+    placeOrder(data: Record<string, any>, basketId: string): Promise<OrderInstance>;
+}

package/dist/api/basket.api.service.js

@@ -0,0 +1,164 @@
+import BasketInstance from "../common/basket.instance.js";
+import { HttpClient } from "../common/http.client.js";
+import OrderInstance from "../common/order.instance.js";
+import OrderApi from "./order.api.service.js";
+export default class BasketApi extends HttpClient {
+    /**
+     * Creates an instance of BasketApi
+     * @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;
+    }
+    /**
+     * Creates a new user basket
+     * @param basketData - The basket creation request data containing user ID and optional metadata
+     * @returns Promise resolving to a BasketInstance representing the created basket
+     * @throws Error if the basket creation fails or the API request is unsuccessful
+     */
+    async create(basketData) {
+        const response = await this.httpPost(`/developer/agents/${this.agentId}/basket`, basketData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success && response.data) {
+            return new BasketInstance(this, response.data);
+        }
+        throw new Error(response.error?.message || 'Failed to create basket');
+    }
+    /**
+     * Retrieves all user baskets with optional status filtering
+     * @param status - Optional basket status to filter by (e.g., 'active', 'completed', 'abandoned')
+     * @returns Promise resolving to an array of BasketInstance objects
+     * @throws Error if the request fails or baskets cannot be retrieved
+     */
+    async get(status) {
+        const statusParam = status ? `?status=${status}` : '';
+        const response = await this.httpGet(`/developer/agents/${this.agentId}/basket/user${statusParam}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            const baskets = response.data;
+            return baskets.map((basket) => {
+                return new BasketInstance(this, basket);
+            });
+        }
+        throw new Error(response.error?.message || 'Failed to get user baskets');
+    }
+    /**
+     * Retrieves a single basket by its unique identifier
+     * @param basketId - The unique identifier of the basket to retrieve
+     * @returns Promise resolving to a BasketInstance representing the basket
+     * @throws Error if the basket is not found or the request fails
+     */
+    async getById(basketId) {
+        const response = await this.httpGet(`/developer/agents/${this.agentId}/basket/${basketId}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success && response.data) {
+            return new BasketInstance(this, response.data);
+        }
+        throw new Error(response.error?.message || 'Failed to get basket');
+    }
+    /**
+     * Adds an item to a specific basket
+     * @param basketId - The unique identifier of the basket
+     * @param itemData - The item data including product ID, quantity, and optional metadata
+     * @returns Promise resolving to the updated Basket object
+     * @throws Error if the basket is not found or the item cannot be added
+     */
+    async addItem(basketId, itemData) {
+        const response = await this.httpPost(`/developer/agents/${this.agentId}/basket/${basketId}/item`, itemData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return response.data;
+        }
+        throw new Error(response.error?.message || 'Failed to add item to basket');
+    }
+    /**
+     * Removes a specific item from a basket
+     * @param basketId - The unique identifier of the basket
+     * @param itemId - The unique identifier of the item to remove
+     * @returns Promise resolving to the updated Basket object
+     * @throws Error if the basket or item is not found or the removal fails
+     */
+    async removeItem(basketId, itemId) {
+        const response = await this.httpDelete(`/developer/agents/${this.agentId}/basket/${basketId}/item/${itemId}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return response.data;
+        }
+        throw new Error(response.error?.message || 'Failed to remove item from basket');
+    }
+    /**
+     * Clears all items from a basket
+     * @param basketId - The unique identifier of the basket to clear
+     * @returns Promise resolving to the updated empty Basket object
+     * @throws Error if the basket is not found or the clear operation fails
+     */
+    async clear(basketId) {
+        const response = await this.httpDelete(`/developer/agents/${this.agentId}/basket/${basketId}/clear`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return response.data;
+        }
+        throw new Error(response.message || 'Failed to clear basket');
+    }
+    /**
+     * Updates the status of a basket
+     * @param basketId - The unique identifier of the basket
+     * @param status - The new status to set for the basket
+     * @returns Promise resolving to the updated BasketStatus
+     * @throws Error if the basket is not found or the status update fails
+     */
+    async updateStatus(basketId, status) {
+        const response = await this.httpPut(`/developer/agents/${this.agentId}/basket/${basketId}/${status}`, undefined, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return status;
+        }
+        throw new Error(response.message || 'Failed to update basket status');
+    }
+    /**
+     * Updates the metadata of a basket
+     * @param basketId - The unique identifier of the basket
+     * @param metadata - The metadata object to update or merge with existing metadata
+     * @returns Promise resolving to the updated metadata
+     * @throws Error if the basket is not found or the metadata update fails
+     */
+    async updateMetadata(basketId, metadata) {
+        const response = await this.httpPut(`/developer/agents/${this.agentId}/basket/${basketId}/metadata`, metadata, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return metadata;
+        }
+        throw new Error(response.message || 'Failed to update basket metadata');
+    }
+    /**
+     * Creates an order from a basket
+     * @param data - Additional order data (shipping info, payment details, etc.)
+     * @param basketId - The unique identifier of the basket to convert to an order
+     * @returns Promise resolving to an OrderInstance representing the created order
+     * @throws Error if the basket is not found or the order creation fails
+     */
+    async placeOrder(data, basketId) {
+        const response = await this.httpPost(`/developer/agents/${this.agentId}/order`, { basketId, data }, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success && response.data) {
+            //create order api instance
+            const orderApi = new OrderApi(this.baseUrl, this.apiKey, this.agentId);
+            const orderInstance = new OrderInstance(orderApi, response.data);
+            return orderInstance;
+        }
+        throw new Error(response.message || 'Failed to create order');
+    }
+}

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

@@ -0,0 +1,21 @@
+import { ChatResponse } from "../interfaces/chat.js";
+import { HttpClient } from "../common/http.client.js";
+import { ApiResponse } from "../interfaces/common.js";
+import { ChatRequest } from "../interfaces/chat.js";
+export default class ChatApi extends HttpClient {
+    private apiKey;
+    /**
+     * Creates an instance of ChatApi
+     * @param baseUrl - The base URL for the API
+     * @param apiKey - The API key for authentication
+     */
+    constructor(baseUrl: string, apiKey: string);
+    /**
+     * Sends a message to an agent and receives a response
+     * @param agentId - The unique identifier of the agent to chat with
+     * @param chatData - The chat request data including message, conversation history, and context
+     * @returns Promise resolving to an ApiResponse containing the agent's chat response
+     * @throws Error if the agent is not found or the chat request fails
+     */
+    sendMessage(agentId: string, chatData: ChatRequest): Promise<ApiResponse<ChatResponse>>;
+}

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

@@ -0,0 +1,24 @@
+import { HttpClient } from "../common/http.client.js";
+export default class ChatApi extends HttpClient {
+    /**
+     * Creates an instance of ChatApi
+     * @param baseUrl - The base URL for the API
+     * @param apiKey - The API key for authentication
+     */
+    constructor(baseUrl, apiKey) {
+        super(baseUrl);
+        this.apiKey = apiKey;
+    }
+    /**
+     * Sends a message to an agent and receives a response
+     * @param agentId - The unique identifier of the agent to chat with
+     * @param chatData - The chat request data including message, conversation history, and context
+     * @returns Promise resolving to an ApiResponse containing the agent's chat response
+     * @throws Error if the agent is not found or the chat request fails
+     */
+    async sendMessage(agentId, chatData) {
+        return this.httpPost(`/chat/generate/${agentId}?channel=dev`, chatData, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+    }
+}

package/dist/api/credentials.d.ts

@@ -0,0 +1,24 @@
+/**
+ * API Credentials Management
+ * Handles loading and caching of API credentials for skill execution
+ */
+/**
+ * API credentials structure
+ */
+export interface ApiCredentials {
+    apiKey: string;
+    agentId: string;
+}
+/**
+ * Gets API credentials from keystore and configuration.
+ * Results are cached for subsequent calls.
+ *
+ * @returns API key and agent ID
+ * @throws Error if credentials are not found or incomplete
+ */
+export declare function getCredentials(): Promise<ApiCredentials>;
+/**
+ * Clears the cached credentials.
+ * Useful for testing or when credentials change.
+ */
+export declare function clearCredentialsCache(): void;

package/dist/api/credentials.js

@@ -0,0 +1,46 @@
+/**
+ * API Credentials Management
+ * Handles loading and caching of API credentials for skill execution
+ */
+import { loadApiKey } from "../services/auth.js";
+import { readSkillConfig } from "../utils/files.js";
+/**
+ * Cached credentials to avoid repeated file/keychain access
+ */
+let cachedCredentials = null;
+/**
+ * Gets API credentials from keystore and configuration.
+ * Results are cached for subsequent calls.
+ *
+ * @returns API key and agent ID
+ * @throws Error if credentials are not found or incomplete
+ */
+export async function getCredentials() {
+    // Return cached credentials if available
+    if (cachedCredentials) {
+        return cachedCredentials;
+    }
+    // Load API key from keystore
+    const apiKey = await loadApiKey();
+    if (!apiKey) {
+        throw new Error('No API key found. Please run "lua auth configure" first.');
+    }
+    // Load agent ID from YAML file
+    const config = readSkillConfig();
+    if (!config?.agent?.agentId) {
+        throw new Error('No agent ID found in lua.skill.yaml. Please run "lua init" first.');
+    }
+    // Cache and return credentials
+    cachedCredentials = {
+        apiKey,
+        agentId: config.agent.agentId
+    };
+    return cachedCredentials;
+}
+/**
+ * Clears the cached credentials.
+ * Useful for testing or when credentials change.
+ */
+export function clearCredentialsCache() {
+    cachedCredentials = null;
+}

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

@@ -0,0 +1,69 @@
+import { HttpClient } from "../common/http.client.js";
+import { CustomDataAPI } from "../types/index.js";
+import { GetCustomDataResponse, UpdateCustomDataRequest, 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;
+    private agentId;
+    /**
+     * Creates an instance of CustomDataApi
+     * @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);
+    /**
+     * Creates a new custom data entry in a specified collection
+     * @param collectionName - The name of the collection to create the entry in
+     * @param data - The data object to store in the entry
+     * @param searchText - Optional text to be used for semantic search indexing
+     * @returns Promise resolving to a DataEntryInstance representing the created entry
+     * @throws Error if the entry creation fails or the API request is unsuccessful
+     */
+    create(collectionName: string, data: Record<string, any>, searchText?: string): Promise<DataEntryInstance>;
+    /**
+     * Retrieves custom data entries from a collection with optional filtering and pagination
+     * @param collectionName - The name of the collection to query
+     * @param filter - Optional filter object to apply to the query (JSON-serializable)
+     * @param page - The page number for pagination (default: 1)
+     * @param limit - The number of entries per page (default: 10)
+     * @returns Promise resolving to a GetCustomDataResponse containing the entries and pagination info
+     * @throws Error if the query fails or the API request is unsuccessful
+     */
+    get(collectionName: string, filter?: any, page?: number, limit?: number): Promise<GetCustomDataResponse>;
+    /**
+     * Retrieves a single custom data entry by its ID
+     * @param collectionName - The name of the collection containing the entry
+     * @param entryId - The unique identifier of the entry to retrieve
+     * @returns Promise resolving to a DataEntryInstance representing the entry
+     * @throws Error if the entry is not found or the API request is unsuccessful
+     */
+    getEntry(collectionName: string, entryId: string): Promise<DataEntryInstance>;
+    /**
+     * 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)
+     * @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>;
+    /**
+     * Performs semantic search on custom data entries using text similarity
+     * @param collectionName - The name of the collection to search within
+     * @param searchText - The text query to search for
+     * @param limit - Maximum number of results to return (default: 10)
+     * @param scoreThreshold - Minimum similarity score threshold 0-1 (default: 0.6)
+     * @returns Promise resolving to an array of DataEntryInstance objects matching the search
+     * @throws Error if the search fails or the API request is unsuccessful
+     */
+    search(collectionName: string, searchText: string, limit?: number, scoreThreshold?: number): Promise<DataEntryInstance[]>;
+    /**
+     * Deletes a custom data entry from a collection
+     * @param collectionName - The name of the collection containing the entry
+     * @param entryId - The unique identifier of the entry to delete
+     * @returns Promise resolving to a DeleteCustomDataResponse confirming deletion
+     * @throws Error if the entry is not found or the deletion fails
+     */
+    delete(collectionName: string, entryId: string): Promise<DeleteCustomDataResponse>;
+}