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

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

@@ -1,27 +1,43 @@
 import { HttpClient } from "../common/http.client.js";
-import DataEntryInstance from "../common/data.entry.instance";
+import DataEntryInstance from "../common/data.entry.instance.js";
 // Custom Data API calls
 export default class CustomDataApi extends HttpClient {
+    /**
+     * 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, apiKey, agentId) {
         super(baseUrl);
         this.apiKey = apiKey;
         this.agentId = agentId;
     }
     /**
-     * Create a new custom data entry
+     * 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
      */
     async create(collectionName, data, searchText) {
         const response = await this.httpPost(`/developer/agents/${this.agentId}/custom-data/${collectionName}`, { data, searchText }, {
             Authorization: `Bearer ${this.apiKey}`,
         });
-        console.log('response', response);
         if (response.success) {
             return new DataEntryInstance(this, response.data, collectionName);
         }
         throw new Error(response.error?.message || 'Failed to create custom data entry');
     }
     /**
-     * Get custom data entries with optional filtering and pagination
+     * 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
      */
     async get(collectionName, filter, page = 1, limit = 10) {
         let url = `/developer/agents/${this.agentId}/custom-data/${collectionName}?page=${page}&limit=${limit}`;
@@ -38,7 +54,11 @@ export default class CustomDataApi extends HttpClient {
         throw new Error(response.error?.message || 'Failed to get custom data entries');
     }
     /**
-     * Get a single custom data entry by ID
+     * 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
      */
     async getEntry(collectionName, entryId) {
         const response = await this.httpGet(`/developer/agents/${this.agentId}/custom-data/${collectionName}/${entryId}`, {
@@ -50,7 +70,12 @@ export default class CustomDataApi extends HttpClient {
         throw new Error(response.error?.message || 'Failed to get custom data entry');
     }
     /**
-     * Update a custom data entry
+     * 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
      */
     async update(collectionName, entryId, data) {
         const response = await this.httpPut(`/developer/agents/${this.agentId}/custom-data/${collectionName}/${entryId}`, data, {
@@ -62,7 +87,13 @@ export default class CustomDataApi extends HttpClient {
         throw new Error(response.error?.message || 'Failed to update custom data entry');
     }
     /**
-     * Search custom data entries by text
+     * 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
      */
     async search(collectionName, searchText, limit = 10, scoreThreshold = 0.6) {
         const url = `/developer/agents/${this.agentId}/custom-data/${collectionName}/search?searchText=${encodeURIComponent(searchText)}&limit=${limit}&scoreThreshold=${scoreThreshold}`;
@@ -76,13 +107,16 @@ export default class CustomDataApi extends HttpClient {
         throw new Error(response.error?.message || 'Failed to search custom data entries');
     }
     /**
-     * Delete a custom data entry
+     * 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
      */
     async delete(collectionName, entryId) {
         const response = await this.httpDelete(`/developer/agents/${this.agentId}/custom-data/${collectionName}/${entryId}`, {
             Authorization: `Bearer ${this.apiKey}`,
         });
-        console.log('response', response);
         if (response.success) {
             return response.data;
         }

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

@@ -0,0 +1,49 @@
+/**
+ * Lazy-Loaded API Instances
+ * Provides singleton instances of API services with lazy initialization
+ */
+import ProductApiService from "./products.api.service.js";
+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";
+/**
+ * Gets or creates User Data API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns UserDataApiService instance
+ */
+export declare function getUserInstance(): Promise<UserDataApiService>;
+/**
+ * Gets or creates Custom Data API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns CustomDataApiService instance
+ */
+export declare function getDataInstance(): Promise<CustomDataApiService>;
+/**
+ * Gets or creates Products API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns ProductApiService instance
+ */
+export declare function getProductsInstance(): Promise<ProductApiService>;
+/**
+ * Gets or creates Baskets API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns BasketApiService instance
+ */
+export declare function getBasketsInstance(): Promise<BasketApiService>;
+/**
+ * Gets or creates Orders API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns OrderApiService instance
+ */
+export declare function getOrderInstance(): Promise<OrderApiService>;
+/**
+ * Clears all cached API instances.
+ * Useful for testing or when credentials change.
+ */
+export declare function clearAllInstances(): void;

package/dist/api/lazy-instances.js

@@ -0,0 +1,95 @@
+/**
+ * Lazy-Loaded API Instances
+ * Provides singleton instances of API services with lazy initialization
+ */
+import { BASE_URLS } from "../config/constants.js";
+import { getCredentials } from "./credentials.js";
+import ProductApiService from "./products.api.service.js";
+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";
+/**
+ * Singleton instances (lazy-loaded)
+ */
+let _userInstance = null;
+let _dataInstance = null;
+let _productsInstance = null;
+let _basketsInstance = null;
+let _orderInstance = null;
+/**
+ * Gets or creates User Data API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns UserDataApiService instance
+ */
+export async function getUserInstance() {
+    if (!_userInstance) {
+        const creds = await getCredentials();
+        _userInstance = new UserDataApiService(BASE_URLS.API, creds.apiKey, creds.agentId);
+    }
+    return _userInstance;
+}
+/**
+ * Gets or creates Custom Data API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns CustomDataApiService instance
+ */
+export async function getDataInstance() {
+    if (!_dataInstance) {
+        const creds = await getCredentials();
+        _dataInstance = new CustomDataApiService(BASE_URLS.API, creds.apiKey, creds.agentId);
+    }
+    return _dataInstance;
+}
+/**
+ * Gets or creates Products API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns ProductApiService instance
+ */
+export async function getProductsInstance() {
+    if (!_productsInstance) {
+        const creds = await getCredentials();
+        _productsInstance = new ProductApiService(BASE_URLS.API, creds.apiKey, creds.agentId);
+    }
+    return _productsInstance;
+}
+/**
+ * Gets or creates Baskets API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns BasketApiService instance
+ */
+export async function getBasketsInstance() {
+    if (!_basketsInstance) {
+        const creds = await getCredentials();
+        _basketsInstance = new BasketApiService(BASE_URLS.API, creds.apiKey, creds.agentId);
+    }
+    return _basketsInstance;
+}
+/**
+ * Gets or creates Orders API instance.
+ * Instance is created once and reused for subsequent calls.
+ *
+ * @returns OrderApiService instance
+ */
+export async function getOrderInstance() {
+    if (!_orderInstance) {
+        const creds = await getCredentials();
+        _orderInstance = new OrderApiService(BASE_URLS.API, creds.apiKey, creds.agentId);
+    }
+    return _orderInstance;
+}
+/**
+ * Clears all cached API instances.
+ * Useful for testing or when credentials change.
+ */
+export function clearAllInstances() {
+    _userInstance = null;
+    _dataInstance = null;
+    _productsInstance = null;
+    _basketsInstance = null;
+    _orderInstance = null;
+}

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

@@ -1,4 +1,4 @@
-import { OrderAPI } from "../types";
+import { OrderAPI } from "../types/index.js";
 import { HttpClient } from "../common/http.client.js";
 import { CreateOrderRequest, OrderResponse } from "../interfaces/orders.js";
 import { OrderStatus } from "../interfaces/orders.js";
@@ -6,18 +6,48 @@ import OrderInstance from "../common/order.instance.js";
 export default class OrderApi extends HttpClient implements OrderAPI {
     private apiKey;
     private agentId;
+    /**
+     * Creates an instance of OrderApi
+     * @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);
     /**
-     * Create order from basket
+     * Creates a new order from a basket
+     * @param orderData - The order creation request data containing basketId and additional order information
+     * @returns Promise resolving to an OrderInstance representing the created order
+     * @throws Error if the basket is not found or the order creation fails
      */
     create(orderData: CreateOrderRequest): Promise<OrderInstance>;
     /**
-     * Update order status
+     * Updates the status of an existing order
+     * @param status - The new order status (e.g., 'pending', 'processing', 'shipped', 'delivered', 'cancelled')
+     * @param orderId - The unique identifier of the order to update
+     * @returns Promise resolving to the updated OrderResponse
+     * @throws Error if the order is not found or the status update fails
      */
     updateStatus(status: OrderStatus, orderId: string): Promise<OrderResponse>;
+    /**
+     * Updates the data associated with an order
+     * @param data - The data object containing fields to update (e.g., shipping info, notes, metadata)
+     * @param orderId - The unique identifier of the order to update
+     * @returns Promise resolving to the updated OrderResponse
+     * @throws Error if the order is not found or the data update fails
+     */
     updateData(data: Record<string, any>, orderId: string): Promise<OrderResponse>;
     /**
-     * Get user orders with optional status filter
+     * Retrieves all user orders with optional status filtering
+     * @param status - Optional order status to filter by (e.g., 'pending', 'processing', 'shipped', 'delivered', 'cancelled')
+     * @returns Promise resolving to an array of OrderInstance objects
+     * @throws Error if the request fails or orders cannot be retrieved
      */
     get(status?: OrderStatus): Promise<OrderInstance[]>;
+    /**
+     * Retrieves a single order by its unique identifier
+     * @param orderId - The unique identifier of the order to retrieve
+     * @returns Promise resolving to an OrderInstance representing the order
+     * @throws Error if the order is not found or the request fails
+     */
+    getById(orderId: string): Promise<OrderInstance>;
 }

package/dist/api/order.api.service.js

@@ -1,13 +1,22 @@
 import { HttpClient } from "../common/http.client.js";
 import OrderInstance from "../common/order.instance.js";
 export default class OrderApi extends HttpClient {
+    /**
+     * Creates an instance of OrderApi
+     * @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;
     }
     /**
-     * Create order from basket
+     * Creates a new order from a basket
+     * @param orderData - The order creation request data containing basketId and additional order information
+     * @returns Promise resolving to an OrderInstance representing the created order
+     * @throws Error if the basket is not found or the order creation fails
      */
     async create(orderData) {
         const response = await this.httpPost(`/developer/agents/${this.agentId}/order`, orderData, {
@@ -20,7 +29,11 @@ export default class OrderApi extends HttpClient {
         throw new Error(response.error?.message || 'Failed to create order');
     }
     /**
-     * Update order status
+     * Updates the status of an existing order
+     * @param status - The new order status (e.g., 'pending', 'processing', 'shipped', 'delivered', 'cancelled')
+     * @param orderId - The unique identifier of the order to update
+     * @returns Promise resolving to the updated OrderResponse
+     * @throws Error if the order is not found or the status update fails
      */
     async updateStatus(status, orderId) {
         const response = await this.httpPut(`/developer/agents/${this.agentId}/order/${orderId}/${status}`, {}, {
@@ -31,6 +44,13 @@ export default class OrderApi extends HttpClient {
         }
         throw new Error(response.error?.message || 'Failed to update order status');
     }
+    /**
+     * Updates the data associated with an order
+     * @param data - The data object containing fields to update (e.g., shipping info, notes, metadata)
+     * @param orderId - The unique identifier of the order to update
+     * @returns Promise resolving to the updated OrderResponse
+     * @throws Error if the order is not found or the data update fails
+     */
     async updateData(data, orderId) {
         const response = await this.httpPut(`/developer/agents/${this.agentId}/order/${orderId}`, data, {
             Authorization: `Bearer ${this.apiKey}`,
@@ -41,7 +61,10 @@ export default class OrderApi extends HttpClient {
         throw new Error(response.error?.message || 'Failed to update order status');
     }
     /**
-     * Get user orders with optional status filter
+     * Retrieves all user orders with optional status filtering
+     * @param status - Optional order status to filter by (e.g., 'pending', 'processing', 'shipped', 'delivered', 'cancelled')
+     * @returns Promise resolving to an array of OrderInstance objects
+     * @throws Error if the request fails or orders cannot be retrieved
      */
     async get(status) {
         const statusParam = status ? `?status=${status}` : '';
@@ -54,4 +77,19 @@ export default class OrderApi extends HttpClient {
         }
         throw new Error(response.error?.message || 'Failed to get user orders');
     }
+    /**
+     * Retrieves a single order by its unique identifier
+     * @param orderId - The unique identifier of the order to retrieve
+     * @returns Promise resolving to an OrderInstance representing the order
+     * @throws Error if the order is not found or the request fails
+     */
+    async getById(orderId) {
+        const response = await this.httpGet(`/developer/agents/${this.agentId}/order/${orderId}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success && response.data) {
+            return new OrderInstance(this, response.data);
+        }
+        throw new Error(response.error?.message || 'Failed to get order');
+    }
 }

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

@@ -1,8 +1,8 @@
 import { HttpClient } from "../common/http.client.js";
-import { ProductAPI } from "../types";
-import { Product } from "../interfaces/product";
-import { UpdateProductResponse } from "../interfaces/product";
-import { DeleteProductResponse } from "../interfaces/product";
+import { ProductAPI } from "../types/index.js";
+import { Product } from "../interfaces/product.js";
+import { UpdateProductResponse } from "../interfaces/product.js";
+import { DeleteProductResponse } from "../interfaces/product.js";
 import ProductInstance from "../common/product.instance.js";
 import ProductPaginationInstance from "../common/product.pagination.instance.js";
 import ProductSearchInstance from "../common/product.search.instance.js";
@@ -12,25 +12,55 @@ import ProductSearchInstance from "../common/product.search.instance.js";
 export default class ProductApi extends HttpClient implements ProductAPI {
     private apiKey;
     private agentId;
+    /**
+     * Creates an instance of ProductApi
+     * @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);
     /**
-     * Get all products for an agent with pagination
+     * Retrieves all products for an agent with pagination support
+     * @param page - The page number for pagination (default: 1)
+     * @param limit - The number of products per page (default: 10)
+     * @returns Promise resolving to a ProductPaginationInstance containing products and pagination info
+     * @throws Error if the request fails or products cannot be retrieved
      */
     get(page?: number, limit?: number): Promise<ProductPaginationInstance>;
     /**
-     * Create a new product
+     * Retrieves a single product by its unique identifier
+     * @param productId - The unique identifier of the product to retrieve
+     * @returns Promise resolving to a ProductInstance representing the product
+     * @throws Error if the product is not found or the request fails
+     */
+    getById(productId: string): Promise<ProductInstance>;
+    /**
+     * Creates a new product in the agent's catalog
+     * @param productData - The product data including name, description, price, images, and metadata
+     * @returns Promise resolving to a ProductInstance representing the created product
+     * @throws Error if the product creation fails or validation errors occur
      */
     create(productData: Product): Promise<ProductInstance>;
     /**
-     * Update an existing product
+     * Updates an existing product's information
+     * @param productData - The product data fields to update (partial update supported)
+     * @param productId - The unique identifier of the product to update
+     * @returns Promise resolving to an UpdateProductResponse with the updated product details
+     * @throws Error if the product is not found or the update fails
      */
     update(productData: Record<string, any>, productId: string): Promise<UpdateProductResponse>;
     /**
-     * Delete a product
+     * Deletes a product from the agent's catalog
+     * @param productId - The unique identifier of the product to delete
+     * @returns Promise resolving to a DeleteProductResponse confirming deletion
+     * @throws Error if the product is not found or the deletion fails
      */
     delete(productId: string): Promise<DeleteProductResponse>;
     /**
-     * Search products by text query
+     * Performs semantic search on products using a text query
+     * @param searchQuery - The search text to find matching products
+     * @returns Promise resolving to a ProductSearchInstance containing search results
+     * @throws Error if the search fails or the API request is unsuccessful
      */
     search(searchQuery: string): Promise<ProductSearchInstance>;
 }

package/dist/api/products.api.service.js

@@ -6,13 +6,23 @@ import ProductSearchInstance from "../common/product.search.instance.js";
  * Product API calls
  */
 export default class ProductApi extends HttpClient {
+    /**
+     * Creates an instance of ProductApi
+     * @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;
     }
     /**
-     * Get all products for an agent with pagination
+     * Retrieves all products for an agent with pagination support
+     * @param page - The page number for pagination (default: 1)
+     * @param limit - The number of products per page (default: 10)
+     * @returns Promise resolving to a ProductPaginationInstance containing products and pagination info
+     * @throws Error if the request fails or products cannot be retrieved
      */
     async get(page = 1, limit = 10) {
         const response = await this.httpGet(`/developer/agents/${this.agentId}/products?page=${page}&limit=${limit}`, {
@@ -24,7 +34,25 @@ export default class ProductApi extends HttpClient {
         throw new Error(response.error?.message || 'Failed to get products');
     }
     /**
-     * Create a new product
+     * Retrieves a single product by its unique identifier
+     * @param productId - The unique identifier of the product to retrieve
+     * @returns Promise resolving to a ProductInstance representing the product
+     * @throws Error if the product is not found or the request fails
+     */
+    async getById(productId) {
+        const response = await this.httpGet(`/developer/agents/${this.agentId}/products/${productId}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success && response.data) {
+            return new ProductInstance(this, response.data);
+        }
+        throw new Error(response.error?.message || 'Failed to get product');
+    }
+    /**
+     * Creates a new product in the agent's catalog
+     * @param productData - The product data including name, description, price, images, and metadata
+     * @returns Promise resolving to a ProductInstance representing the created product
+     * @throws Error if the product creation fails or validation errors occur
      */
     async create(productData) {
         const response = await this.httpPost(`/developer/agents/${this.agentId}/products`, productData, {
@@ -36,7 +64,11 @@ export default class ProductApi extends HttpClient {
         throw new Error(response.error?.message || 'Failed to create product');
     }
     /**
-     * Update an existing product
+     * Updates an existing product's information
+     * @param productData - The product data fields to update (partial update supported)
+     * @param productId - The unique identifier of the product to update
+     * @returns Promise resolving to an UpdateProductResponse with the updated product details
+     * @throws Error if the product is not found or the update fails
      */
     async update(productData, productId) {
         const response = await this.httpPut(`/developer/agents/${this.agentId}/products`, { ...productData, id: productId }, {
@@ -48,7 +80,10 @@ export default class ProductApi extends HttpClient {
         throw new Error(response.error?.message || 'Failed to update product');
     }
     /**
-     * Delete a product
+     * Deletes a product from the agent's catalog
+     * @param productId - The unique identifier of the product to delete
+     * @returns Promise resolving to a DeleteProductResponse confirming deletion
+     * @throws Error if the product is not found or the deletion fails
      */
     async delete(productId) {
         const response = await this.httpDelete(`/developer/agents/${this.agentId}/products/${productId}`, {
@@ -60,7 +95,10 @@ export default class ProductApi extends HttpClient {
         throw new Error(response.error?.message || 'Failed to delete product');
     }
     /**
-     * Search products by text query
+     * Performs semantic search on products using a text query
+     * @param searchQuery - The search text to find matching products
+     * @returns Promise resolving to a ProductSearchInstance containing search results
+     * @throws Error if the search fails or the API request is unsuccessful
      */
     async search(searchQuery) {
         const response = await this.httpGet(`/developer/agents/${this.agentId}/products/search?searchQuery=${encodeURIComponent(searchQuery)}`, {

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

@@ -1,13 +1,25 @@
-import { DevVersionResponse, UpdateDevVersionResponse } from "../interfaces/admin";
+import { DevVersionResponse, UpdateDevVersionResponse } from "../interfaces/dev.js";
 import { HttpClient } from "../common/http.client.js";
-import { ApiResponse } from "../interfaces/admin";
+import { ApiResponse } from "../interfaces/common.js";
 /**
  * Skill API calls
  */
 export default class SkillApi extends HttpClient {
     private apiKey;
     private agentId;
+    /**
+     * Creates an instance of SkillApi
+     * @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 skill for the agent
+     * @param skillData - The skill data including name, description, and optional context
+     * @returns Promise resolving to an ApiResponse containing the created skill details
+     * @throws Error if the skill creation fails or validation errors occur
+     */
     createSkill(skillData: any): Promise<ApiResponse<{
         id: string;
         name: string;
@@ -15,12 +27,47 @@ export default class SkillApi extends HttpClient {
         agentId: string;
         context?: string;
     }>>;
+    /**
+     * Pushes a new version of a skill to production
+     * @param skillId - The unique identifier of the skill
+     * @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 skill is not found or the push operation fails
+     */
     pushSkill(skillId: string, versionData: any): Promise<ApiResponse<DevVersionResponse>>;
+    /**
+     * Pushes a new development/sandbox version of a skill for testing
+     * @param skillId - The unique identifier of the skill
+     * @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 skill is not found or the push operation fails
+     */
     pushDevSkill(skillId: string, versionData: any): Promise<ApiResponse<DevVersionResponse>>;
+    /**
+     * Updates an existing development/sandbox version of a skill
+     * @param skillId - The unique identifier of the skill
+     * @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 skill or version is not found or the update fails
+     */
     updateDevSkill(skillId: string, sandboxVersionId: string, versionData: any): Promise<ApiResponse<UpdateDevVersionResponse>>;
+    /**
+     * Retrieves all versions of a specific skill
+     * @param skillId - The unique identifier of the skill
+     * @returns Promise resolving to an ApiResponse containing an array of skill versions
+     * @throws Error if the skill is not found or the request fails
+     */
     getSkillVersions(skillId: string): Promise<ApiResponse<{
         versions: any[];
     }>>;
+    /**
+     * Publishes a specific version of a skill to production
+     * @param skillId - The unique identifier of the skill
+     * @param version - The version identifier to publish
+     * @returns Promise resolving to an ApiResponse containing publication confirmation details
+     * @throws Error if the skill or version is not found or the publish operation fails
+     */
     publishSkillVersion(skillId: string, version: string): Promise<ApiResponse<{
         message: string;
         skillId: string;