lua-cli 3.4.0 → 3.5.0-alpha.2

package/dist/interfaces/unifiedto.d.ts

@@ -0,0 +1,91 @@
+/**
+ * UnifiedTo Interfaces
+ * Types for UnifiedTo integration API responses
+ */
+/**
+ * Auth support types for integrations
+ */
+export type UnifiedToAuthSupport = 'token' | 'oauth' | 'both';
+/**
+ * OAuth scope mapping (unified scope -> original provider scopes)
+ */
+export interface UnifiedToOAuthScope {
+    unifiedScope: string;
+    originalScopes: string[];
+}
+/**
+ * Token auth field info
+ */
+export interface UnifiedToTokenField {
+    name: string;
+    instructions?: string;
+}
+/**
+ * Available integration from UnifiedTo
+ */
+export interface UnifiedToIntegrationResponse {
+    type: string;
+    name: string;
+    categories: string[];
+    logoUrl?: string;
+    authSupport: UnifiedToAuthSupport;
+    oauthConfigured: boolean;
+    oauthScopes?: UnifiedToOAuthScope[];
+    tokenFields?: UnifiedToTokenField[];
+}
+/**
+ * Auth URL response from UnifiedTo
+ */
+export interface UnifiedToAuthUrlResponse {
+    authUrl: string;
+    integrationType: string;
+}
+/**
+ * Connected account (connection) response
+ */
+export interface UnifiedToConnectionResponse {
+    id: string;
+    integrationType: string;
+    status: string;
+    integrationName?: string;
+    logoUrl?: string;
+    createdAt: string;
+    updatedAt?: string;
+}
+/**
+ * Available webhook event info (derived from integration support data)
+ */
+export interface WebhookEventInfo {
+    objectType: string;
+    objectTypeDisplay: string;
+    event: 'created' | 'updated' | 'deleted';
+    webhookType: 'native' | 'virtual';
+    availableFilters: string[];
+}
+/**
+ * Request params for creating a webhook subscription
+ */
+export interface CreateWebhookSubscriptionParams {
+    connectionId: string;
+    objectType: string;
+    event: 'created' | 'updated' | 'deleted';
+    hookUrl: string;
+    interval?: number;
+    filters?: Record<string, string>;
+}
+/**
+ * Webhook subscription response
+ */
+export interface WebhookSubscriptionResponse {
+    id: string;
+    connectionId: string;
+    integrationType: string;
+    objectType: string;
+    event: string;
+    hookUrl: string;
+    webhookType: 'native' | 'virtual';
+    interval?: number;
+    filters?: Record<string, string>;
+    status: string;
+    createdAt: string;
+}

package/dist/interfaces/unifiedto.js

@@ -0,0 +1,6 @@
+/**
+ * UnifiedTo Interfaces
+ * Types for UnifiedTo integration API responses
+ */
+export {};
+//# sourceMappingURL=unifiedto.js.map

package/dist/interfaces/unifiedto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unifiedto.js","sourceRoot":"","sources":["../../src/interfaces/unifiedto.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/interfaces/user.d.ts

@@ -38,3 +38,12 @@ export interface ProfileResponse {
         name?: string;
     };
 }
+/**
+ * Options for looking up a user by email or phone
+ */
+export interface UserLookupOptions {
+    /** Email address to look up */
+    email?: string;
+    /** Phone number to look up (with or without + prefix) */
+    phone?: string;
+}

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

@@ -1,5 +1,6 @@
 import { Message } from "../interfaces/message.js";
 import { GetCustomDataResponse, UpdateCustomDataResponse, DeleteCustomDataResponse } from "../interfaces/custom.data.js";
+import { UserLookupOptions } from "../interfaces/user.js";
 import DataEntryInstance from "../common/data.entry.instance.js";
 /**
  * API Contract Interfaces
@@ -14,10 +15,11 @@ import DataEntryInstance from "../common/data.entry.instance.js";
  */
 export interface UserDataAPI {
     /**
-     * Retrieves current user data.
-     * @returns Promise resolving to user data
+     * Retrieves user data by userId, email, or phone.
+     * @param identifier - Optional userId string or lookup options object
+     * @returns Promise resolving to user data, or null if not found
      */
-    get(): Promise<any>;
+    get(identifier?: string | UserLookupOptions): Promise<any>;
     /**
      * Updates user data.
      * @param data - Data to update

package/dist/utils/auth-flows.d.ts

@@ -3,13 +3,41 @@
  * Handles different authentication methods (API key and email OTP)
  */
 /**
- * Handles API key authentication flow.
+ * Handles API key authentication flow (interactive).
  * Prompts for API key, validates it, and saves it securely.
  *
  * @returns Promise that resolves when authentication is complete
  * @throws Error if API key is invalid
  */
 export declare function handleApiKeyAuth(): Promise<void>;
+/**
+ * Handles API key authentication (non-interactive).
+ * Validates the provided API key and saves it securely.
+ *
+ * @param apiKey - The API key to validate and save
+ * @returns Promise that resolves when authentication is complete
+ * @throws Error if API key is invalid
+ */
+export declare function handleApiKeyAuthNonInteractive(apiKey: string): Promise<void>;
+/**
+ * Handles email OTP request (non-interactive step 1).
+ * Sends OTP to the provided email address.
+ *
+ * @param email - Email address to send OTP to
+ * @returns Promise that resolves when OTP is sent
+ * @throws Error if email is invalid or OTP sending fails
+ */
+export declare function handleEmailOtpRequest(email: string): Promise<void>;
+/**
+ * Handles email OTP verification (non-interactive step 2).
+ * Verifies the OTP, generates an API key, and saves it.
+ *
+ * @param email - Email address the OTP was sent to
+ * @param otp - The OTP code received via email
+ * @returns Promise that resolves when authentication is complete
+ * @throws Error if OTP is invalid or API key generation fails
+ */
+export declare function handleEmailOtpVerify(email: string, otp: string): Promise<void>;
 /**
  * Handles email authentication flow with OTP verification.
  * Sends OTP to email, verifies it, generates API key, and saves it.

package/dist/utils/auth-flows.js

@@ -12,8 +12,11 @@ const OTP_CONFIG = {
     MAX_ATTEMPTS: 3,
     OTP_LENGTH: 6,
 };
+// ============================================================================
+// INTERACTIVE AUTHENTICATION FLOWS
+// ============================================================================
 /**
- * Handles API key authentication flow.
+ * Handles API key authentication flow (interactive).
  * Prompts for API key, validates it, and saves it securely.
  *
  * @returns Promise that resolves when authentication is complete
@@ -35,6 +38,86 @@ export async function handleApiKeyAuth() {
     await saveApiKey(answers.apiKey);
     writeSuccess("✅ API key saved securely.");
 }
+// ============================================================================
+// NON-INTERACTIVE AUTHENTICATION FLOWS
+// ============================================================================
+/**
+ * Handles API key authentication (non-interactive).
+ * Validates the provided API key and saves it securely.
+ *
+ * @param apiKey - The API key to validate and save
+ * @returns Promise that resolves when authentication is complete
+ * @throws Error if API key is invalid
+ */
+export async function handleApiKeyAuthNonInteractive(apiKey) {
+    writeProgress("🔐 Validating API key...");
+    const data = await checkApiKey(apiKey);
+    if (!data) {
+        throw new Error("Invalid API key. Please check your key and try again.");
+    }
+    await saveApiKey(apiKey);
+    writeSuccess("✅ API key validated and saved securely.");
+    writeInfo(`   Welcome, ${data.fullName || data.email}!`);
+}
+/**
+ * Handles email OTP request (non-interactive step 1).
+ * Sends OTP to the provided email address.
+ *
+ * @param email - Email address to send OTP to
+ * @returns Promise that resolves when OTP is sent
+ * @throws Error if email is invalid or OTP sending fails
+ */
+export async function handleEmailOtpRequest(email) {
+    // Validate email format
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    if (!emailRegex.test(email)) {
+        throw new Error("Invalid email address format.");
+    }
+    writeProgress(`📧 Sending OTP to ${email}...`);
+    const otpSent = await requestEmailOTP(email);
+    if (!otpSent) {
+        throw new Error("Failed to send OTP. Please check your email address and try again.");
+    }
+    writeSuccess("✅ OTP sent successfully!");
+    writeInfo("\n📬 Check your email for the 6-digit code, then run:");
+    writeInfo(`   lua auth configure --email ${email} --otp <code>\n`);
+}
+/**
+ * Handles email OTP verification (non-interactive step 2).
+ * Verifies the OTP, generates an API key, and saves it.
+ *
+ * @param email - Email address the OTP was sent to
+ * @param otp - The OTP code received via email
+ * @returns Promise that resolves when authentication is complete
+ * @throws Error if OTP is invalid or API key generation fails
+ */
+export async function handleEmailOtpVerify(email, otp) {
+    // Validate OTP format
+    if (otp.length !== OTP_CONFIG.OTP_LENGTH) {
+        throw new Error(`OTP must be ${OTP_CONFIG.OTP_LENGTH} digits.`);
+    }
+    writeProgress("🔐 Verifying OTP...");
+    const signInToken = await verifyOTPAndGetToken(email, otp);
+    if (!signInToken) {
+        throw new Error("Invalid OTP. Please check the code and try again.");
+    }
+    writeSuccess("✅ OTP verified successfully!");
+    writeProgress("🔑 Generating API key...");
+    const apiKey = await generateApiKey(signInToken);
+    if (!apiKey) {
+        throw new Error("Failed to generate API key. Please try again.");
+    }
+    await saveApiKey(apiKey);
+    writeSuccess("✅ API key generated and saved securely.");
+    // Guide user to next steps
+    writeInfo("\n🎉 You're all set! Here's what to do next:\n");
+    writeInfo("   1️⃣  Create a new project directory:");
+    writeInfo("      mkdir my-agent && cd my-agent\n");
+    writeInfo("   2️⃣  Initialize your agent:");
+    writeInfo("      lua init\n");
+    writeInfo("   3️⃣  Follow the prompts to create or select an agent\n");
+    writeInfo("💡 Tip: Run 'lua --help' to see all available commands\n");
+}
 /**
  * Handles email authentication flow with OTP verification.
  * Sends OTP to email, verifies it, generates API key, and saves it.

package/dist/utils/auth-flows.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth-flows.js","sourceRoot":"","sources":["../../src/utils/auth-flows.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"auth-flows.js","sourceRoot":"","sources":["../../src/utils/auth-flows.ts"],"names":[],"mappings":"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"}

package/dist/utils/sandbox.d.ts

@@ -77,9 +77,9 @@ export declare function executeJob(options: ExecuteJobOptions): Promise<any>;
  * Executes a preprocessor in a sandboxed environment.
  *
  * @param options - PreProcessor execution options
- * @returns Processed message string
+ * @returns PreProcessorResult - { action: 'block', response: string } or { action: 'proceed', modifiedMessage?: ChatMessage[] }
  */
-export declare function executePreProcessor(options: ExecutePreProcessorOptions): Promise<any[]>;
+export declare function executePreProcessor(options: ExecutePreProcessorOptions): Promise<any>;
 /**
  * Executes a postprocessor in a sandboxed environment.
  *

package/dist/utils/sandbox.js

@@ -472,7 +472,7 @@ try{
  * Executes a preprocessor in a sandboxed environment.
  *
  * @param options - PreProcessor execution options
- * @returns Processed message string
+ * @returns PreProcessorResult - { action: 'block', response: string } or { action: 'proceed', modifiedMessage?: ChatMessage[] }
  */
 export async function executePreProcessor(options) {
     const { processorCode, messages, channel, apiKey, agentId } = options;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lua-cli",
-  "version": "3.4.0",
+  "version": "3.5.0-alpha.2",
   "description": "Build, test, and deploy AI agents with custom tools, webhooks, and scheduled jobs. Features LuaAgent unified configuration, streaming chat, and batch deployment.",
   "readmeFilename": "README.md",
   "main": "dist/api-exports.js",

package/template/package.json

@@ -20,7 +20,7 @@
     "inquirer": "^12.9.6",
     "stripe": "^17.5.0",
     "js-yaml": "^4.1.0",
-    "lua-cli": "^3.4.0",
+    "lua-cli": "^3.5.0-alpha.2",
     "openai": "^5.23.0",
     "uuid": "^13.0.0",
     "zod": "^3.24.1"