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

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

@@ -0,0 +1,125 @@
+import { HttpClient } from "../common/http.client.js";
+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;
+    }
+    /**
+     * 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}`,
+        });
+        if (response.success) {
+            return new DataEntryInstance(this, response.data, collectionName);
+        }
+        throw new Error(response.error?.message || 'Failed to create custom data entry');
+    }
+    /**
+     * 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}`;
+        if (filter) {
+            const encodedFilter = encodeURIComponent(JSON.stringify(filter));
+            url += `&filter=${encodedFilter}`;
+        }
+        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 custom data entries');
+    }
+    /**
+     * 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}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return new DataEntryInstance(this, response.data, collectionName);
+        }
+        throw new Error(response.error?.message || 'Failed to get 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, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return response.data;
+        }
+        throw new Error(response.error?.message || 'Failed to update custom data entry');
+    }
+    /**
+     * 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}`;
+        const response = await this.httpGet(url, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            const entries = response.data?.data || [];
+            return entries.map((entry) => new DataEntryInstance(this, entry, collectionName)) || [];
+        }
+        throw new Error(response.error?.message || 'Failed to search custom data entries');
+    }
+    /**
+     * 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}`,
+        });
+        if (response.success) {
+            return response.data;
+        }
+        throw new Error(response.error?.message || 'Failed to delete custom data entry');
+    }
+}

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

@@ -0,0 +1,53 @@
+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";
+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);
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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

@@ -0,0 +1,95 @@
+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;
+    }
+    /**
+     * 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, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success && response.data) {
+            const orderInstance = new OrderInstance(this, response.data);
+            return orderInstance;
+        }
+        throw new Error(response.error?.message || 'Failed to create order');
+    }
+    /**
+     * 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}`, {}, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return response.data;
+        }
+        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}`,
+        });
+        if (response.success) {
+            return response.data;
+        }
+        throw new Error(response.error?.message || 'Failed to update order status');
+    }
+    /**
+     * 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}` : '';
+        const response = await this.httpGet(`/developer/agents/${this.agentId}/order/user${statusParam}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            const orders = response.data;
+            return orders.map((order) => new OrderInstance(this, order)) || [];
+        }
+        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

@@ -0,0 +1,66 @@
+import { HttpClient } from "../common/http.client.js";
+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";
+/**
+ * Product API calls
+ */
+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);
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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

@@ -0,0 +1,112 @@
+import { HttpClient } from "../common/http.client.js";
+import ProductInstance from "../common/product.instance.js";
+import ProductPaginationInstance from "../common/product.pagination.instance.js";
+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;
+    }
+    /**
+     * 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}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return new ProductPaginationInstance(this, response);
+        }
+        throw new Error(response.error?.message || 'Failed to get products');
+    }
+    /**
+     * 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, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success && response.data) {
+            return new ProductInstance(this, response.data.product);
+        }
+        throw new Error(response.error?.message || 'Failed to create 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 }, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return response.data;
+        }
+        throw new Error(response.error?.message || 'Failed to update 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}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return response.data;
+        }
+        throw new Error(response.error?.message || 'Failed to delete product');
+    }
+    /**
+     * 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)}`, {
+            Authorization: `Bearer ${this.apiKey}`,
+        });
+        if (response.success) {
+            return new ProductSearchInstance(this, response);
+        }
+        throw new Error(response.error?.message || 'Failed to search products');
+    }
+}

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

@@ -0,0 +1,77 @@
+import { DevVersionResponse, UpdateDevVersionResponse } from "../interfaces/dev.js";
+import { HttpClient } from "../common/http.client.js";
+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;
+        description?: string;
+        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;
+        activeVersionId: string;
+        publishedAt: string;
+    }>>;
+}