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

package/dist/interfaces/baskets.d.ts

@@ -1,9 +1,25 @@
+/**
+ * Basket Interfaces
+ * Shopping basket management and operations
+ */
+/**
+ * Basket status enumeration.
+ * Represents the lifecycle states of a shopping basket.
+ */
 export declare enum BasketStatus {
+    /** Basket is active and can be modified */
     ACTIVE = "active",
+    /** Basket has been checked out (converted to order) */
     CHECKED_OUT = "checked_out",
+    /** Basket was abandoned by the user */
     ABANDONED = "abandoned",
+    /** Basket has expired (TTL exceeded) */
     EXPIRED = "expired"
 }
+/**
+ * Item in a basket.
+ * Represents a single product or service in the basket.
+ */
 export interface BasketItem {
     id: string;
     price: number;
@@ -12,17 +28,29 @@ export interface BasketItem {
     addedAt?: string;
     [key: string]: any;
 }
+/**
+ * Basket data container.
+ * Contains the actual basket contents and metadata.
+ */
 export interface BasketData {
     currency: string;
     metadata?: any;
     items: BasketItem[];
     createdAt: string;
 }
+/**
+ * Common basket properties.
+ * Calculated/derived properties maintained by the system.
+ */
 export interface BasketCommon {
     status: BasketStatus;
     totalAmount: string | number;
     itemCount: number;
 }
+/**
+ * Complete basket entity.
+ * Full basket object as stored in the database.
+ */
 export interface Basket {
     id: string;
     userId: string;
@@ -33,43 +61,75 @@ export interface Basket {
     updatedAt: string;
     __v: number;
 }
+/**
+ * Request to create a new basket.
+ */
 export interface CreateBasketRequest {
     currency: string;
     metadata?: any;
 }
+/**
+ * Response from basket creation.
+ */
 export interface CreateBasketResponse {
     success: boolean;
     message: string;
     data?: Basket;
 }
+/**
+ * Response from get baskets API.
+ */
 export interface GetBasketsResponse {
     success: boolean;
     message: string;
     data?: Basket[];
 }
+/**
+ * Request to add an item to a basket.
+ */
 export interface AddItemToBasketRequest {
     id: string;
     price: number;
     quantity: number;
     [key: string]: any;
 }
+/**
+ * Response from adding item to basket.
+ */
 export interface AddItemToBasketResponse {
     success: boolean;
     message: string;
     data?: Basket;
 }
+/**
+ * Response from removing item from basket.
+ */
 export interface RemoveItemFromBasketResponse {
     success: boolean;
     message: string;
     data?: Basket;
 }
+/**
+ * Response from clearing basket.
+ */
 export interface ClearBasketResponse {
     success: boolean;
     message: string;
     data?: Basket;
 }
+/**
+ * Response from updating basket status.
+ */
 export interface UpdateBasketStatusResponse {
     success: boolean;
     message: string;
     data?: Basket;
 }
+/**
+ * Response from updating basket metadata.
+ */
+export interface UpdateBasketMetadataResponse {
+    success: boolean;
+    message: string;
+    data?: Basket;
+}

package/dist/interfaces/baskets.js

@@ -1,7 +1,19 @@
+/**
+ * Basket Interfaces
+ * Shopping basket management and operations
+ */
+/**
+ * Basket status enumeration.
+ * Represents the lifecycle states of a shopping basket.
+ */
 export var BasketStatus;
 (function (BasketStatus) {
+    /** Basket is active and can be modified */
     BasketStatus["ACTIVE"] = "active";
+    /** Basket has been checked out (converted to order) */
     BasketStatus["CHECKED_OUT"] = "checked_out";
+    /** Basket was abandoned by the user */
     BasketStatus["ABANDONED"] = "abandoned";
+    /** Basket has expired (TTL exceeded) */
     BasketStatus["EXPIRED"] = "expired";
 })(BasketStatus || (BasketStatus = {}));

package/dist/interfaces/chat.d.ts

@@ -1,17 +1,61 @@
+/**
+ * Chat Interfaces
+ * Chat API structures for agent conversations
+ */
+/**
+ * Chat message structure.
+ * Currently only supports text messages.
+ */
 export interface ChatMessage {
     type: 'text';
     text: string;
 }
+/**
+ * Skill override for testing specific skill versions.
+ * Used in dev mode to override production skills with sandbox versions.
+ */
+export interface SkillOverride {
+    skillId: string;
+    sandboxId: string;
+}
+/**
+ * Chat request payload.
+ * Sent to the chat API to start or continue a conversation.
+ */
 export interface ChatRequest {
     messages: ChatMessage[];
     navigate: boolean;
-    skillOverride: Array<{
-        skillId: string;
-        sandboxId: string;
-    }>;
+    skillOverride: SkillOverride[];
+    personaOverride?: string;
 }
+/**
+ * Chat response from API.
+ * Contains the agent's response and metadata.
+ */
 export interface ChatResponse {
     success: boolean;
     text?: string;
     error?: string;
 }
+/**
+ * Detailed chat response with full conversation context.
+ * Used in dev mode for detailed debugging.
+ */
+export interface DetailedChatResponse {
+    text: string;
+    files: any[];
+    reasoningDetails: any[];
+    toolCalls: any[];
+    toolResults: any[];
+    finishReason: string;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    warnings: any[];
+    request: any;
+    response: any;
+    steps: any[];
+    sources: any[];
+}

package/dist/interfaces/chat.js

@@ -1 +1,5 @@
+/**
+ * Chat Interfaces
+ * Chat API structures for agent conversations
+ */
 export {};

package/dist/interfaces/common.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Common Interfaces
+ * Shared interfaces used across multiple modules
+ *
+ * This file contains base interfaces that are used throughout the application,
+ * particularly standard API response patterns.
+ */
+/**
+ * Standard API response wrapper.
+ * Used by all API endpoints to provide consistent response structure.
+ *
+ * @template T - Type of data returned on success
+ *
+ * @example
+ * ```typescript
+ * const response: ApiResponse<User> = await api.getUser();
+ * if (response.success) {
+ *   console.log(response.data); // User object
+ * } else {
+ *   console.error(response.error?.message);
+ * }
+ * ```
+ */
+export interface ApiResponse<T = any> {
+    success: boolean;
+    message?: string;
+    data?: T;
+    error?: {
+        message: string;
+        statusCode?: number;
+    };
+}
+/**
+ * Standard pagination information for list responses.
+ * Used by APIs that return paginated results.
+ */
+export interface Pagination {
+    currentPage: number;
+    totalPages: number;
+    totalCount: number;
+    limit: number;
+    hasNextPage: boolean;
+    hasPrevPage: boolean;
+    nextPage: number | null;
+    prevPage: number | null;
+}
+/**
+ * Base interface for entities with timestamps.
+ * Most database entities include these fields.
+ */
+export interface TimestampedEntity {
+    createdAt: string | number;
+    updatedAt: string | number;
+    __v?: number;
+}
+/**
+ * Base interface for entities with string IDs.
+ */
+export interface IdentifiedEntity {
+    id: string;
+    _id?: string;
+}

package/dist/interfaces/common.js

@@ -0,0 +1,8 @@
+/**
+ * Common Interfaces
+ * Shared interfaces used across multiple modules
+ *
+ * This file contains base interfaces that are used throughout the application,
+ * particularly standard API response patterns.
+ */
+export {};

package/dist/interfaces/compile.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Interface definitions for compile command
+ */
+export interface ToolInfo {
+    name: string;
+    className: string;
+    filePath: string;
+    description?: string;
+    inputSchema?: any;
+    executeCode?: string;
+}

package/dist/interfaces/compile.js

@@ -0,0 +1,4 @@
+/**
+ * Interface definitions for compile command
+ */
+export {};

package/dist/interfaces/custom.data.d.ts

@@ -1,52 +1,82 @@
-export interface CustomDataEntry {
+/**
+ * Custom Data Interfaces
+ * Custom data collections with vector search capabilities
+ */
+import { Pagination, TimestampedEntity, IdentifiedEntity } from './common.js';
+/**
+ * Custom data entry.
+ * Represents a single entry in a custom data collection.
+ *
+ * Features:
+ * - Flexible schema (data can be any JSON object)
+ * - Vector search via searchText
+ * - Automatic timestamps
+ */
+export interface CustomDataEntry extends IdentifiedEntity, TimestampedEntity {
     id: string;
     data: any;
     createdAt: number;
     updatedAt: number;
     searchText?: string;
 }
+/**
+ * Request to create a new custom data entry.
+ *
+ * @example
+ * ```typescript
+ * const request: CreateCustomDataRequest = {
+ *   data: { name: 'John Doe', email: 'john@example.com' },
+ *   searchText: 'John Doe john@example.com'
+ * };
+ * ```
+ */
 export interface CreateCustomDataRequest {
     data: any;
     searchText?: string;
 }
-export interface CreateCustomDataResponse {
-    id: string;
-    data: any;
-    createdAt: number;
-    updatedAt: number;
-    searchText?: string;
+/**
+ * Response from creating custom data entry.
+ * Includes optional similarity score for search results.
+ */
+export interface CreateCustomDataResponse extends CustomDataEntry {
     score?: number;
 }
+/**
+ * Response from getting custom data entries.
+ * Includes pagination information.
+ */
 export interface GetCustomDataResponse {
     data: CustomDataEntry[];
-    pagination: {
-        currentPage: number;
-        totalPages: number;
-        totalCount: number;
-        limit: number;
-        hasNextPage: boolean;
-        hasPrevPage: boolean;
-    };
+    pagination: Pagination;
 }
+/**
+ * Request to update a custom data entry.
+ */
 export interface UpdateCustomDataRequest {
     data: any;
     searchText?: string;
 }
+/**
+ * Response from updating custom data entry.
+ */
 export interface UpdateCustomDataResponse {
     status: string;
     message: string;
 }
+/**
+ * Response from searching custom data.
+ * Includes similarity scores for each result.
+ */
 export interface SearchCustomDataResponse {
     data: Array<CustomDataEntry & {
         score: number;
     }>;
     count: number;
 }
+/**
+ * Response from deleting custom data entry.
+ */
 export interface DeleteCustomDataResponse {
     status: string;
     message: string;
 }
-export interface UpdateBasketMetadataResponse {
-    status: string;
-    message: string;
-}

package/dist/interfaces/custom.data.js

@@ -1 +1,5 @@
+/**
+ * Custom Data Interfaces
+ * Custom data collections with vector search capabilities
+ */
 export {};

package/dist/interfaces/deploy.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Interface definitions for deploy command
+ */
+/**
+ * Version information from API
+ */
+export interface VersionInfo {
+    version: string;
+    createdDate: string;
+    createdBy: string;
+    isCurrent: boolean;
+    createdByEmail: string;
+    createdByFullName: string;
+}
+/**
+ * Response from versions API endpoint
+ */
+export interface VersionsResponse {
+    versions: VersionInfo[];
+}
+/**
+ * Response from publish API endpoint
+ */
+export interface PublishResponse {
+    message: string;
+    skillId: string;
+    activeVersionId: string;
+    publishedAt: string;
+}

package/dist/interfaces/deploy.js

@@ -0,0 +1,4 @@
+/**
+ * Interface definitions for deploy command
+ */
+export {};

package/dist/interfaces/dev.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Dev Mode Interfaces
+ * Development mode specific structures
+ */
+import { ChatMessage, ChatRequest, DetailedChatResponse, SkillOverride } from './chat.js';
+export { ChatMessage, ChatRequest, SkillOverride };
+/**
+ * Response from dev version API endpoint.
+ * Used when pushing skills to sandbox environment.
+ */
+export interface DevVersionResponse {
+    success: boolean;
+    data?: {
+        message: string;
+        skillId: string;
+        version: string;
+        publishedAt: string;
+    };
+    error?: {
+        message: string;
+        error: string;
+        statusCode: number;
+    };
+}
+/**
+ * Response from update dev version API endpoint.
+ * Used when updating existing sandbox versions.
+ */
+export interface UpdateDevVersionResponse {
+    success: boolean;
+    data?: {
+        message: string;
+        skillId: string;
+        version: string;
+        updatedAt: string;
+    };
+    error?: {
+        message: string;
+        error: string;
+        statusCode: number;
+    };
+}
+/**
+ * Chat response type alias.
+ * Re-exported from chat.ts for backward compatibility.
+ */
+export type ChatResponse = DetailedChatResponse;
+/**
+ * Map of skill names to their sandbox IDs.
+ */
+export interface SandboxIdsMap {
+    [skillName: string]: string;
+}

package/dist/interfaces/dev.js

@@ -0,0 +1,5 @@
+/**
+ * Dev Mode Interfaces
+ * Development mode specific structures
+ */
+export {};

package/dist/interfaces/init.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Interface definitions for init command
+ */
+/**
+ * Agent choice options
+ */
+export type AgentChoiceType = 'existing' | 'create';
+/**
+ * Selected agent information
+ */
+export interface SelectedAgent {
+    agentId: string;
+    name: string;
+}
+/**
+ * Selected organization information
+ */
+export interface SelectedOrg {
+    id: string;
+    registeredName?: string;
+    name?: string;
+    agents?: any[];
+}
+/**
+ * Organization from API response
+ */
+export interface OrganizationData {
+    id: string;
+    registeredName?: string;
+    name?: string;
+    agents: any[];
+}
+/**
+ * Persona information for new agents
+ */
+export interface PersonaInfo {
+    agentName: string;
+    businessType: string;
+    brandPersonality: string;
+    brandTraits: string;
+}
+/**
+ * Business configuration options
+ */
+export interface BusinessConfig {
+    businessName: string;
+    agentName: string;
+    businessType: string;
+    brandPersonality: string;
+    brandTraits: string;
+}
+/**
+ * Agent creation result
+ */
+export interface AgentCreationResult {
+    agent: SelectedAgent;
+    org: SelectedOrg;
+    persona?: string;
+    welcomeMessage?: string;
+}

package/dist/interfaces/init.js

@@ -0,0 +1,4 @@
+/**
+ * Interface definitions for init command
+ */
+export {};

package/dist/interfaces/orders.d.ts

@@ -1,10 +1,26 @@
+/**
+ * Order Interfaces
+ * Order management and fulfillment
+ */
 import { BasketItem } from "./baskets.js";
+/**
+ * Order status enumeration.
+ * Represents the lifecycle states of an order.
+ */
 export declare enum OrderStatus {
+    /** Order created but not yet confirmed */
     PENDING = "pending",
+    /** Order confirmed and being processed */
     CONFIRMED = "confirmed",
+    /** Order completed and delivered */
     FULFILLED = "fulfilled",
+    /** Order cancelled */
     CANCELLED = "cancelled"
 }
+/**
+ * Order data container.
+ * Contains the order details, items, and metadata.
+ */
 export interface OrderData {
     currency: string;
     items: BasketItem[];
@@ -14,12 +30,20 @@ export interface OrderData {
     orderId: string;
     [key: string]: any;
 }
+/**
+ * Common order properties.
+ * Calculated/derived properties maintained by the system.
+ */
 export interface OrderCommon {
     status: 'pending' | 'confirmed' | 'fulfilled' | 'cancelled';
     totalAmount: string | number;
     currency: string;
     itemCount: number;
 }
+/**
+ * Complete order entity.
+ * Full order object as stored in the database.
+ */
 export interface OrderResponse {
     id: string;
     userId: string;
@@ -31,22 +55,35 @@ export interface OrderResponse {
     updatedAt: string;
     __v: number;
 }
+/**
+ * Request to create a new order.
+ * Typically created from a basket.
+ */
 export interface CreateOrderRequest {
     basketId: string;
     data: {
         [key: string]: any;
     };
 }
+/**
+ * Response from order creation.
+ */
 export interface CreateOrderResponse {
     success: boolean;
     message: string;
     data: OrderResponse;
 }
+/**
+ * Response from updating order status.
+ */
 export interface UpdateOrderStatusResponse {
     success: boolean;
     message: string;
     data: OrderResponse;
 }
+/**
+ * Response from getting user orders.
+ */
 export interface GetUserOrdersResponse {
     success: boolean;
     message: string;

package/dist/interfaces/orders.js

@@ -1,7 +1,19 @@
+/**
+ * Order Interfaces
+ * Order management and fulfillment
+ */
+/**
+ * Order status enumeration.
+ * Represents the lifecycle states of an order.
+ */
 export var OrderStatus;
 (function (OrderStatus) {
+    /** Order created but not yet confirmed */
     OrderStatus["PENDING"] = "pending";
+    /** Order confirmed and being processed */
     OrderStatus["CONFIRMED"] = "confirmed";
+    /** Order completed and delivered */
     OrderStatus["FULFILLED"] = "fulfilled";
+    /** Order cancelled */
     OrderStatus["CANCELLED"] = "cancelled";
 })(OrderStatus || (OrderStatus = {}));