lua-cli 2.5.8 → 3.0.0-alpha.10

package/dist/config/constants.js

@@ -1,16 +1,18 @@
 /**
  * Base URLs for the API, Auth, and Chat - Production
  */
-export const BASE_URLS = {
-    API: 'https://api.heylua.ai',
-    AUTH: 'https://auth.heylua.ai',
-    CHAT: 'https://api.heylua.ai',
-};
-/**
- * Base URLs for the API, Auth, and Chat - Development
- */
 // export const BASE_URLS = {
 //   API: 'http://localhost:3022',
 //   AUTH: 'https://auth.heylua.ai',
 //   CHAT: 'http://localhost:3001',
+//   WEBHOOK: 'https://webhook.heylua.ai',
 // } as const;
+/**
+ * Base URLs for the API, Auth, and Chat - Development
+ */
+export const BASE_URLS = {
+    API: 'https://api.heylua.ai',
+    AUTH: 'https://auth.heylua.ai',
+    CHAT: 'https://api.heylua.ai',
+    WEBHOOK: 'https://webhook.heylua.ai',
+};

package/dist/interfaces/agent.d.ts

@@ -39,7 +39,8 @@ export interface CreateAgentRequest {
     features: Record<string, boolean>;
     channels: any[];
     org: {
-        registeredName: string;
+        id?: string;
+        registeredName?: string;
     };
 }
 /**

package/dist/interfaces/chat.d.ts

@@ -6,10 +6,21 @@
  * Chat message structure.
  * Currently only supports text messages.
  */
-export interface ChatMessage {
+export type ChatMessage = TextMessage | ImageMessage | FileMessage;
+export interface TextMessage {
     type: 'text';
     text: string;
 }
+export interface ImageMessage {
+    type: 'image';
+    image: string;
+    mimeType: string;
+}
+export interface FileMessage {
+    type: 'file';
+    data: string;
+    mimeType: string;
+}
 /**
  * Skill override for testing specific skill versions.
  * Used in dev mode to override production skills with sandbox versions.
@@ -18,6 +29,22 @@ export interface SkillOverride {
     skillId: string;
     sandboxId: string;
 }
+/**
+ * PreProcessor override for sandbox testing.
+ * Maps production preprocessor ID to sandbox version ID.
+ */
+export interface PreProcessorOverride {
+    preprocessorId: string;
+    sandboxId: string;
+}
+/**
+ * PostProcessor override for sandbox testing.
+ * Maps production postprocessor ID to sandbox version ID.
+ */
+export interface PostProcessorOverride {
+    postprocessorId: string;
+    sandboxId: string;
+}
 /**
  * Chat request payload.
  * Sent to the chat API to start or continue a conversation.
@@ -26,7 +53,10 @@ export interface ChatRequest {
     messages: ChatMessage[];
     navigate: boolean;
     skillOverride: SkillOverride[];
+    preprocessorOverride?: PreProcessorOverride[];
+    postprocessorOverride?: PostProcessorOverride[];
     personaOverride?: string;
+    runtimeContext?: string;
 }
 /**
  * Chat response from API.
@@ -59,3 +89,24 @@ export interface DetailedChatResponse {
     steps: any[];
     sources: any[];
 }
+/**
+ * Chat history message content item
+ */
+export interface ChatHistoryContent {
+    type: 'text' | 'image' | 'file';
+    text?: string;
+    url?: string;
+    filename?: string;
+}
+/**
+ * Chat history message from conversation
+ */
+export interface ChatHistoryMessage {
+    role: 'user' | 'assistant';
+    id: string;
+    createdAt: string;
+    resourceId: string;
+    threadId: string;
+    type: string;
+    content: ChatHistoryContent[];
+}

package/dist/interfaces/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Interfaces Module - Barrel Export
+ *
+ * This file serves as the main entry point for all interface definitions.
+ * It re-exports interfaces and DTOs from various modules for convenient importing.
+ */
+export { CreateWebhookDTO, PushWebhookVersionDTO, UpdateWebhookVersionDTO, WebhookVersion, Webhook, GetWebhooksResponse, DeleteWebhookResponse, CreateWebhookResponse, PushWebhookVersionResponse, } from './webhooks.js';
+export { CreateJobDTO, PushJobVersionDTO, UpdateJobVersionDTO, JobSchedule, JobScheduleType, JobRetryConfig, JobVersion, JobExecutionStatus, JobExecution, JobStatus, Job, GetJobsResponse, DeleteJobResponse, CreateJobResponse, PushJobVersionResponse, JobExecutionResponse, GetJobExecutionsResponse, } from './jobs.js';
+export { ApiResponse, Pagination, } from './common.js';
+export { SkillTool, SkillVersion, Skill, GetSkillsResponse, DeleteSkillResponse, } from './skills.js';

package/dist/interfaces/index.js

@@ -0,0 +1,7 @@
+/**
+ * Interfaces Module - Barrel Export
+ *
+ * This file serves as the main entry point for all interface definitions.
+ * It re-exports interfaces and DTOs from various modules for convenient importing.
+ */
+export {};

package/dist/interfaces/jobs.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Jobs Interfaces
+ * Structures for job management
+ */
+/**
+ * DTO for creating a new job
+ */
+export interface CreateJobDTO {
+    name: string;
+    description?: string;
+    context?: string;
+    schedule: JobSchedule;
+    timeout?: number;
+    retry?: JobRetryConfig;
+    metadata?: Record<string, any>;
+    dynamic?: boolean;
+    /**
+     * Optional initial version data.
+     * If provided, creates the first version automatically.
+     */
+    version?: {
+        version: string;
+        description?: string;
+        context?: string;
+        code: string;
+        executeFunction: string;
+        timeout?: number;
+        retry?: JobRetryConfig;
+        metadata?: Record<string, any>;
+    };
+    /**
+     * Auto-publish and activate the job after creation.
+     * If true, the job will be immediately active and running.
+     * Default: false
+     */
+    activate?: boolean;
+}
+/**
+ * DTO for pushing a job version
+ */
+export interface PushJobVersionDTO {
+    name: string;
+    version: string;
+    description?: string;
+    context?: string;
+    jobId: string;
+    schedule: JobSchedule;
+    timeout?: number;
+    retry?: JobRetryConfig;
+    code?: string;
+    executeFunction?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * DTO for updating a job version
+ */
+export interface UpdateJobVersionDTO {
+    version?: string;
+    description?: string;
+    context?: string;
+    schedule?: JobSchedule;
+    timeout?: number;
+    retry?: JobRetryConfig;
+    code?: string;
+    executeFunction?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Job schedule configuration
+ */
+export type JobScheduleType = 'cron' | 'once' | 'interval';
+export interface JobSchedule {
+    type: JobScheduleType;
+    expression?: string;
+    executeAt?: string;
+    seconds?: number;
+    timezone?: string;
+}
+/**
+ * Job retry configuration
+ */
+export interface JobRetryConfig {
+    maxAttempts: number;
+    backoffSeconds?: number;
+}
+/**
+ * Job version information
+ */
+export interface JobVersion {
+    id: string;
+    version: string;
+    description: string;
+    active: boolean;
+    context: string;
+    schedule: JobSchedule;
+    timeout?: number;
+    retry?: JobRetryConfig;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Job execution status
+ */
+export type JobExecutionStatus = 'pending' | 'running' | 'completed' | 'failed' | 'timeout';
+/**
+ * Job execution record
+ */
+export interface JobExecution {
+    id: string;
+    jobId: string;
+    versionId: string;
+    status: JobExecutionStatus;
+    startedAt: string;
+    completedAt?: string;
+    duration?: number;
+    result?: any;
+    error?: string;
+    retryCount?: number;
+}
+/**
+ * Job status
+ */
+export type JobStatus = 'active' | 'paused' | 'failed' | 'inactive';
+/**
+ * Job information
+ */
+export interface Job {
+    id: string;
+    name: string;
+    description: string;
+    public: boolean;
+    active: boolean;
+    status: JobStatus;
+    createdAt: string;
+    updatedAt: string;
+    versions: JobVersion[];
+    activeVersionId?: string;
+    lastRunAt?: string;
+    nextRunAt?: string;
+    lastExecution?: JobExecution;
+}
+/**
+ * Response from get all jobs API endpoint
+ */
+export interface GetJobsResponse {
+    jobs: Job[];
+}
+/**
+ * Response from delete job API endpoint
+ * If deleted is false and deactivated is true, the job has versions
+ * and cannot be deleted, so it was deactivated instead
+ */
+export interface DeleteJobResponse {
+    message: string;
+    deleted: boolean;
+    deactivated: boolean;
+}
+/**
+ * Response from create job API endpoint
+ */
+export interface CreateJobResponse {
+    id: string;
+    name: string;
+    description?: string;
+    agentId: string;
+    context?: string;
+    schedule: JobSchedule;
+}
+/**
+ * Response from push job version API endpoint
+ */
+export interface PushJobVersionResponse {
+    versionId: string;
+    jobId: string;
+    version: string;
+    createdAt: string;
+    schedule: JobSchedule;
+}
+/**
+ * Response from job execution APIs
+ */
+export interface JobExecutionResponse {
+    execution: JobExecution;
+}
+/**
+ * Response from get job executions API
+ */
+export interface GetJobExecutionsResponse {
+    executions: JobExecution[];
+    total: number;
+    page?: number;
+    limit?: number;
+}

package/dist/interfaces/jobs.js

@@ -0,0 +1,5 @@
+/**
+ * Jobs Interfaces
+ * Structures for job management
+ */
+export {};

package/dist/interfaces/postprocessors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * PostProcessor Interfaces
+ */
+/**
+ * DTO for creating a new postprocessor
+ */
+export interface CreatePostProcessorDTO {
+    name: string;
+    description?: string;
+    context?: string;
+}
+/**
+ * DTO for pushing a postprocessor version
+ */
+export interface PushPostProcessorVersionDTO {
+    name: string;
+    version: string;
+    description?: string;
+    context?: string;
+    postprocessorId: string;
+    code?: string;
+    executeFunction?: string;
+}
+/**
+ * PostProcessor version information
+ */
+export interface PostProcessorVersion {
+    id: string;
+    version: string;
+    description: string;
+    active: boolean;
+    context: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/dist/interfaces/postprocessors.js

@@ -0,0 +1,4 @@
+/**
+ * PostProcessor Interfaces
+ */
+export {};

package/dist/interfaces/preprocessors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * PreProcessor Interfaces
+ */
+/**
+ * DTO for creating a new preprocessor
+ */
+export interface CreatePreProcessorDTO {
+    name: string;
+    description?: string;
+    context?: string;
+}
+/**
+ * DTO for pushing a preprocessor version
+ */
+export interface PushPreProcessorVersionDTO {
+    name: string;
+    version: string;
+    description?: string;
+    context?: string;
+    preprocessorId: string;
+    code?: string;
+    executeFunction?: string;
+}
+/**
+ * PreProcessor version information
+ */
+export interface PreProcessorVersion {
+    id: string;
+    version: string;
+    description: string;
+    active: boolean;
+    context: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/dist/interfaces/preprocessors.js

@@ -0,0 +1,4 @@
+/**
+ * PreProcessor Interfaces
+ */
+export {};

package/dist/interfaces/webhooks.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Webhooks Interfaces
+ * Structures for webhook management
+ */
+/**
+ * DTO for creating a new webhook
+ */
+export interface CreateWebhookDTO {
+    name: string;
+    description?: string;
+    context?: string;
+}
+/**
+ * DTO for pushing a webhook version
+ */
+export interface PushWebhookVersionDTO {
+    name: string;
+    version: string;
+    description?: string;
+    context?: string;
+    webhookId: string;
+    querySchema?: any;
+    headerSchema?: any;
+    bodySchema?: any;
+    code?: string;
+    executeFunction?: string;
+}
+/**
+ * DTO for updating a webhook version
+ */
+export interface UpdateWebhookVersionDTO {
+    version?: string;
+    description?: string;
+    context?: string;
+    querySchema?: any;
+    headerSchema?: any;
+    bodySchema?: any;
+    code?: string;
+    executeFunction?: string;
+}
+/**
+ * Webhook version information
+ */
+export interface WebhookVersion {
+    id: string;
+    version: string;
+    description: string;
+    active: boolean;
+    context: string;
+    querySchema?: any;
+    headerSchema?: any;
+    bodySchema?: any;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Webhook information
+ */
+export interface Webhook {
+    id: string;
+    name: string;
+    description: string;
+    public: boolean;
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+    versions: WebhookVersion[];
+    activeVersionId?: string;
+}
+/**
+ * Response from get all webhooks API endpoint
+ */
+export interface GetWebhooksResponse {
+    webhooks: Webhook[];
+}
+/**
+ * Response from delete webhook API endpoint
+ * If deleted is false and deactivated is true, the webhook has versions
+ * and cannot be deleted, so it was deactivated instead
+ */
+export interface DeleteWebhookResponse {
+    message: string;
+    deleted: boolean;
+    deactivated: boolean;
+}
+/**
+ * Response from create webhook API endpoint
+ */
+export interface CreateWebhookResponse {
+    id: string;
+    name: string;
+    description?: string;
+    agentId: string;
+    context?: string;
+}
+/**
+ * Response from push webhook version API endpoint
+ */
+export interface PushWebhookVersionResponse {
+    versionId: string;
+    webhookId: string;
+    version: string;
+    createdAt: string;
+}

package/dist/interfaces/webhooks.js

@@ -0,0 +1,5 @@
+/**
+ * Webhooks Interfaces
+ * Structures for webhook management
+ */
+export {};

package/dist/services/auth.d.ts

@@ -13,9 +13,15 @@ import { UserData } from "../interfaces/admin.js";
  */
 export declare function saveApiKey(apiKey: string): Promise<void>;
 /**
- * Loads API key from secure system keychain.
+ * Loads API key from multiple sources in priority order:
+ * 1. Secure system keychain (macOS Keychain, Windows Credential Vault, Linux libsecret)
+ * 2. LUA_API_KEY environment variable
+ * 3. LUA_API_KEY from .env file
  *
- * @returns Promise resolving to API key or null if not found
+ * This fallback mechanism allows the CLI to work in CI/CD environments where
+ * keychain access isn't available.
+ *
+ * @returns Promise resolving to API key or null if not found in any source
  */
 export declare function loadApiKey(): Promise<string | null>;
 /**

package/dist/services/auth.js

@@ -22,12 +22,44 @@ export async function saveApiKey(apiKey) {
     await keytar.setPassword(KEYTAR_SERVICE, KEYTAR_ACCOUNT, apiKey);
 }
 /**
- * Loads API key from secure system keychain.
+ * Loads API key from multiple sources in priority order:
+ * 1. Secure system keychain (macOS Keychain, Windows Credential Vault, Linux libsecret)
+ * 2. LUA_API_KEY environment variable
+ * 3. LUA_API_KEY from .env file
  *
- * @returns Promise resolving to API key or null if not found
+ * This fallback mechanism allows the CLI to work in CI/CD environments where
+ * keychain access isn't available.
+ *
+ * @returns Promise resolving to API key or null if not found in any source
  */
 export async function loadApiKey() {
-    return keytar.getPassword(KEYTAR_SERVICE, KEYTAR_ACCOUNT);
+    // Priority 1: Check secure system keychain
+    const keychainKey = await keytar.getPassword(KEYTAR_SERVICE, KEYTAR_ACCOUNT);
+    if (keychainKey) {
+        return keychainKey;
+    }
+    // Priority 2: Check environment variable
+    if (process.env.LUA_API_KEY) {
+        return process.env.LUA_API_KEY;
+    }
+    // Priority 3: Check .env file
+    try {
+        const fs = await import('fs');
+        const path = await import('path');
+        const envPath = path.join(process.cwd(), '.env');
+        if (fs.existsSync(envPath)) {
+            const envContent = fs.readFileSync(envPath, 'utf8');
+            const match = envContent.match(/^LUA_API_KEY=(.+)$/m);
+            if (match && match[1]) {
+                // Remove quotes if present
+                return match[1].trim().replace(/^["']|["']$/g, '');
+            }
+        }
+    }
+    catch (error) {
+        // Silently fail if .env file can't be read
+    }
+    return null;
 }
 /**
  * Deletes API key from secure system keychain.

package/dist/types/api-contracts.d.ts

@@ -35,6 +35,11 @@ export interface UserDataAPI {
      * @throws Error if the message sending fails or the request is unsuccessful
      */
     sendMessage(messages: Message[]): Promise<any>;
+    /**
+     * Gets chat history.
+     * @returns Promise resolving to chat history
+     */
+    getChatHistory(): Promise<any>;
 }
 /**
  * Product API contract.

package/dist/types/compile.types.d.ts

@@ -20,6 +20,30 @@ export interface SkillMetadata {
     context: string;
     constructorTools: string[];
 }
+/**
+ * Webhook metadata extracted from source code
+ */
+export interface WebhookMetadata {
+    name: string;
+    version: string;
+    description: string;
+    context: string;
+}
+/**
+ * Job metadata extracted from source code
+ */
+export interface JobMetadata {
+    name: string;
+    version: string;
+    description: string;
+    context: string;
+    schedule: any;
+    timeout?: number;
+    retry?: {
+        maxAttempts: number;
+        backoffSeconds?: number;
+    };
+}
 /**
  * Configuration from lua.skill.yaml
  */
@@ -30,15 +54,40 @@ export interface SkillConfig {
         skillId?: string;
         description?: string;
         context?: string;
+        env?: Record<string, string>;
     };
     agent?: {
         agentId?: string;
+        orgId?: string;
+        persona?: string;
+        welcomeMessage?: string;
     };
     skills?: Array<{
         name: string;
         version: string;
         skillId: string;
     }>;
+    webhooks?: Array<{
+        name: string;
+        version: string;
+        webhookId: string;
+    }>;
+    jobs?: Array<{
+        name: string;
+        version: string;
+        jobId: string;
+        schedule?: any;
+    }>;
+    preprocessors?: Array<{
+        name: string;
+        version: string;
+        preprocessorId: string;
+    }>;
+    postprocessors?: Array<{
+        name: string;
+        version: string;
+        postprocessorId: string;
+    }>;
 }
 /**
  * Deployment data format for new deployment system

package/dist/types/index.d.ts

@@ -14,7 +14,7 @@
  * import { validateToolName } from './types/tool-validation.js';
  * ```
  */
-export { LuaSkill, LuaTool, LuaSkillConfig, env } from './skill.js';
+export { LuaSkill, LuaTool, LuaSkillConfig, LuaWebhook, LuaWebhookConfig, LuaJob, LuaJobConfig, JobSchedule, env } from './skill.js';
 export { validateToolName, assertValidToolName } from './tool-validation.js';
 export { UserDataAPI, ProductAPI, BasketAPI, OrderAPI, CustomDataAPI } from './api-contracts.js';
 export { UserData, EmailAddress, Country, Admin, Organization, AgentAuth, OTPResponse, ApiKeyResponse } from '../interfaces/admin.js';