lua-cli 3.0.3 → 3.1.0-alpha.2

package/README.md

@@ -12,6 +12,7 @@
 ## ✨ Features
 
 - 🤖 **LuaAgent** - Unified agent configuration with persona, skills, webhooks, and jobs
+- 🛒 **Marketplace** - Publish and install verified skills from the community
 - 🛠️ **Custom Tools** - Build TypeScript tools with full type safety and Zod validation
 - 🪝 **Webhooks** - HTTP endpoints for external integrations (Stripe, Shopify, etc.)
 - ⏰ **Scheduled Jobs** - Cron-based and one-time background tasks
@@ -289,6 +290,12 @@ lua auth configure          # Set up API key
 lua init                    # Initialize new project
 ```
 
+### Marketplace
+
+```bash
+lua marketplace             # Access the skills marketplace (Creator & Installer)
+```
+
 ### Development
 
 ```bash
@@ -311,7 +318,7 @@ lua deploy                  # Deploy version to production
 lua production              # View production status
 lua env                     # Manage environment variables
 lua persona                 # Update agent persona
-lua logs                    # View agent logs
+lua logs                    # View and filter agent logs (interactive)
 lua skills                  # Manage skills
 lua webhooks                # Manage webhooks
 lua jobs                    # Manage scheduled jobs

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

@@ -83,7 +83,9 @@ export default class JobApi extends HttpClient {
      * @returns Promise resolving to an ApiResponse containing an array of jobs with their versions
      * @throws Error if the API request fails or the agent is not found
      */
-    getJobs(): Promise<ApiResponse<GetJobsResponse>>;
+    getJobs(options?: {
+        includeDynamic?: boolean;
+    }): Promise<ApiResponse<GetJobsResponse>>;
     /**
      * Retrieves a job by its unique identifier
      * @param jobId - The unique identifier of the job to retrieve

package/dist/api/job.api.service.js

@@ -22,8 +22,13 @@ export default class JobApi extends HttpClient {
      * @returns Promise resolving to an ApiResponse containing an array of jobs with their versions
      * @throws Error if the API request fails or the agent is not found
      */
-    async getJobs() {
-        return this.httpGet(`/developer/jobs/${this.agentId}`, {
+    async getJobs(options = {}) {
+        const queryParams = new URLSearchParams();
+        if (options.includeDynamic) {
+            queryParams.append('includeDynamic', 'true');
+        }
+        const url = `/developer/jobs/${this.agentId}?${queryParams.toString()}`;
+        return this.httpGet(url, {
             Authorization: `Bearer ${this.apiKey}`,
         });
     }

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

@@ -15,21 +15,19 @@ export default class LogsApi extends HttpClient {
     constructor(baseUrl: string, apiKey: string);
     /**
      * Retrieves logs for an agent
-     * @param agentId - The unique identifier of the agent
+     * @param agentId - The ID of the agent
      * @param limit - Number of logs per page (default: 20)
      * @param page - Page number (default: 1)
+     * @param skillId - Optional skill ID to filter logs
+     * @param logType - Optional log type to filter logs
      * @returns Promise resolving to an ApiResponse containing logs and pagination
-     * @throws Error if the API request fails
      */
-    getAgentLogs(agentId: string, limit?: number, page?: number): Promise<ApiResponse<LogsResponse>>;
-    /**
-     * Retrieves logs for a specific skill
-     * @param agentId - The unique identifier of the agent
-     * @param skillId - The unique identifier of the skill
-     * @param limit - Number of logs per page (default: 20)
-     * @param page - Page number (default: 1)
-     * @returns Promise resolving to an ApiResponse containing logs and pagination
-     * @throws Error if the API request fails
-     */
-    getSkillLogs(agentId: string, skillId: string, limit?: number, page?: number): Promise<ApiResponse<LogsResponse>>;
+    getAgentLogs(agentId: string, limit: number, page: number, filters?: {
+        primitiveType?: "skill" | "job" | "webhook" | "preprocessor" | "postprocessor";
+        primitiveId?: string;
+        primitiveName?: string;
+        toolId?: string;
+        toolName?: string;
+        logType?: string;
+    }): Promise<ApiResponse<LogsResponse>>;
 }

package/dist/api/logs.api.service.js

@@ -15,28 +15,31 @@ export default class LogsApi extends HttpClient {
     }
     /**
      * Retrieves logs for an agent
-     * @param agentId - The unique identifier of the agent
+     * @param agentId - The ID of the agent
      * @param limit - Number of logs per page (default: 20)
      * @param page - Page number (default: 1)
+     * @param skillId - Optional skill ID to filter logs
+     * @param logType - Optional log type to filter logs
      * @returns Promise resolving to an ApiResponse containing logs and pagination
-     * @throws Error if the API request fails
      */
-    async getAgentLogs(agentId, limit = 20, page = 1) {
-        return this.httpGet(`/developer/agents/${agentId}/logs?limit=${limit}&page=${page}`, {
-            Authorization: `Bearer ${this.apiKey}`,
+    async getAgentLogs(agentId, limit, page, filters = {}) {
+        const queryParams = new URLSearchParams({
+            limit: limit.toString(),
+            page: page.toString(),
         });
-    }
-    /**
-     * Retrieves logs for a specific skill
-     * @param agentId - The unique identifier of the agent
-     * @param skillId - The unique identifier of the skill
-     * @param limit - Number of logs per page (default: 20)
-     * @param page - Page number (default: 1)
-     * @returns Promise resolving to an ApiResponse containing logs and pagination
-     * @throws Error if the API request fails
-     */
-    async getSkillLogs(agentId, skillId, limit = 20, page = 1) {
-        return this.httpGet(`/developer/skills/${agentId}/${skillId}/logs?limit=${limit}&page=${page}`, {
+        if (filters.primitiveType)
+            queryParams.append("primitiveType", filters.primitiveType);
+        if (filters.primitiveId)
+            queryParams.append("primitiveId", filters.primitiveId);
+        if (filters.primitiveName)
+            queryParams.append("primitiveName", filters.primitiveName);
+        if (filters.toolId)
+            queryParams.append("toolId", filters.toolId);
+        if (filters.toolName)
+            queryParams.append("toolName", filters.toolName);
+        if (filters.logType)
+            queryParams.append("logType", filters.logType);
+        return this.httpGet(`/developer/agents/${agentId}/logs?${queryParams.toString()}`, {
             Authorization: `Bearer ${this.apiKey}`,
         });
     }

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

@@ -0,0 +1,25 @@
+import { MarketplaceSkillWithVersionsResponse, MarketplaceVersionResponse, SkillResponse, UnpublishVersionResponse, UnlistSkillResponse } from "../interfaces/marketplace.js";
+export declare class MarketplaceApiService {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string);
+    private _fetch;
+    listSkill(data: any): Promise<MarketplaceSkillWithVersionsResponse>;
+    updateSkill(marketplaceSkillId: string, data: any): Promise<MarketplaceSkillWithVersionsResponse>;
+    unlistSkill(marketplaceSkillId: string): Promise<UnlistSkillResponse>;
+    publishVersion(marketplaceSkillId: string, data: any): Promise<MarketplaceVersionResponse>;
+    unpublishVersion(marketplaceSkillId: string, versionId: string): Promise<UnpublishVersionResponse>;
+    getCreatorSkills(): Promise<MarketplaceSkillWithVersionsResponse[]>;
+    searchSkills(filters?: {
+        search?: string;
+        name?: string;
+        creatorId?: string;
+        publishedVersionsOnly?: boolean;
+    }): Promise<MarketplaceSkillWithVersionsResponse[]>;
+    getSkillById(marketplaceSkillId: string): Promise<MarketplaceSkillWithVersionsResponse>;
+    getSkillVersions(marketplaceSkillId: string): Promise<MarketplaceVersionResponse[]>;
+    installSkill(marketplaceSkillId: string, agentId: string, data: any): Promise<SkillResponse>;
+    updateInstallation(marketplaceSkillId: string, agentId: string, data: any): Promise<SkillResponse>;
+    uninstallSkill(marketplaceSkillId: string, agentId: string): Promise<SkillResponse>;
+    getInstalledSkills(agentId: string): Promise<SkillResponse[]>;
+}

package/dist/api/marketplace.api.service.js

@@ -0,0 +1,105 @@
+/**
+ * Marketplace API Service
+ * Handles all communication with the Lua Marketplace API.
+ */
+import { BASE_URLS } from "../config/constants.js";
+export class MarketplaceApiService {
+    constructor(apiKey) {
+        this.baseUrl = BASE_URLS.API;
+        this.apiKey = apiKey;
+    }
+    async _fetch(endpoint, options = {}) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+            ...options.headers,
+        };
+        const response = await fetch(url, { ...options, headers });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`API Error: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        if (response.status === 204) {
+            // No content
+            return null;
+        }
+        return response.json();
+    }
+    // --- Creator Methods ---
+    async listSkill(data) {
+        return this._fetch("/marketplace/skills/list", {
+            method: "POST",
+            body: JSON.stringify(data),
+        });
+    }
+    async updateSkill(marketplaceSkillId, data) {
+        return this._fetch(`/marketplace/skills/${marketplaceSkillId}`, {
+            method: "PATCH",
+            body: JSON.stringify(data),
+        });
+    }
+    async unlistSkill(marketplaceSkillId) {
+        return this._fetch(`/marketplace/skills/${marketplaceSkillId}/unlist`, {
+            method: "PUT",
+        });
+    }
+    async publishVersion(marketplaceSkillId, data) {
+        return this._fetch(`/marketplace/skills/${marketplaceSkillId}/versions/publish`, {
+            method: "POST",
+            body: JSON.stringify(data),
+        });
+    }
+    async unpublishVersion(marketplaceSkillId, versionId) {
+        return this._fetch(`/marketplace/skills/${marketplaceSkillId}/unpublish`, {
+            method: "PUT",
+            body: JSON.stringify({ versionId }),
+        });
+    }
+    async getCreatorSkills() {
+        return this._fetch("/marketplace/creator/skills");
+    }
+    // --- Installer Methods ---
+    async searchSkills(filters) {
+        const params = new URLSearchParams();
+        if (filters?.search) {
+            params.append("search", filters.search);
+        }
+        if (filters?.name) {
+            params.append("name", filters.name);
+        }
+        if (filters?.creatorId) {
+            params.append("creatorId", filters.creatorId);
+        }
+        if (filters?.publishedVersionsOnly !== undefined) {
+            params.append("publishedVersionsOnly", String(filters.publishedVersionsOnly));
+        }
+        return this._fetch(`/marketplace/skills?${params.toString()}`);
+    }
+    async getSkillById(marketplaceSkillId) {
+        return this._fetch(`/marketplace/skills/${marketplaceSkillId}`);
+    }
+    async getSkillVersions(marketplaceSkillId) {
+        return this._fetch(`/marketplace/skills/${marketplaceSkillId}/versions`);
+    }
+    async installSkill(marketplaceSkillId, agentId, data) {
+        return this._fetch(`/marketplace/install/${marketplaceSkillId}/${agentId}`, {
+            method: "POST",
+            body: JSON.stringify(data),
+        });
+    }
+    async updateInstallation(marketplaceSkillId, agentId, data) {
+        return this._fetch(`/marketplace/install/${marketplaceSkillId}/${agentId}`, {
+            method: "PUT",
+            body: JSON.stringify(data),
+        });
+    }
+    async uninstallSkill(marketplaceSkillId, agentId) {
+        return this._fetch(`/marketplace/install/${marketplaceSkillId}/${agentId}`, {
+            method: "DELETE",
+        });
+    }
+    async getInstalledSkills(agentId) {
+        return this._fetch(`/marketplace/installations/${agentId}`);
+    }
+}

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

@@ -29,7 +29,10 @@ export default class UserDataApi extends HttpClient {
         if (!response.success) {
             throw new Error(response.error?.message || 'Failed to get user data');
         }
-        return new UserDataInstance(this, response.data);
+        // Extract profile data and remove from response
+        const profile = response.data?._luaProfile;
+        const { _luaProfile, ...data } = response.data || {};
+        return new UserDataInstance(this, data, profile);
     }
     /**
      * Updates the current user's data for the specific agent
@@ -44,7 +47,9 @@ export default class UserDataApi extends HttpClient {
         if (!response.success) {
             throw new Error(response.error?.message || 'Failed to update user data');
         }
-        return response.data;
+        // Extract profile if present and remove from response
+        const { _luaProfile, ...cleanData } = response.data || {};
+        return cleanData;
     }
     /**
      * Clears all user data for the current user and specific agent

package/dist/cli/command-definitions.d.ts

@@ -14,6 +14,12 @@ import { Command } from "commander";
  * @param program - Commander program instance
  */
 export declare function setupAuthCommands(program: Command): void;
+/**
+ * Sets up marketplace commands.
+ *
+ * @param program - Commander program instance
+ */
+export declare function setupMarketplaceCommands(program: Command): void;
 /**
  * Sets up skill management commands.
  *

package/dist/cli/command-definitions.js

@@ -2,7 +2,7 @@
  * Command Definitions
  * Centralized command structure for the CLI
  */
-import { configureCommand, initCommand, destroyCommand, apiKeyCommand, compileCommand, testCommand, pushCommand, deployCommand, chatCommand, chatClearCommand, envCommand, personaCommand, productionCommand, resourcesCommand, adminCommand, docsCommand, channelsCommand, logsCommand, completionCommand, skillsCommand, webhooksCommand, jobsCommand, featuresCommand, preprocessorsCommand, postprocessorsCommand } from "../commands/index.js";
+import { configureCommand, initCommand, destroyCommand, apiKeyCommand, compileCommand, testCommand, pushCommand, deployCommand, chatCommand, chatClearCommand, envCommand, personaCommand, productionCommand, resourcesCommand, adminCommand, docsCommand, channelsCommand, logsCommand, completionCommand, skillsCommand, webhooksCommand, jobsCommand, featuresCommand, preprocessorsCommand, postprocessorsCommand, marketplaceCommand } from "../commands/index.js";
 /**
  * Sets up authentication-related commands.
  *
@@ -36,6 +36,30 @@ Examples:
         .description("Display your stored API key")
         .action(apiKeyCommand);
 }
+/**
+ * Sets up marketplace commands.
+ *
+ * @param program - Commander program instance
+ */
+export function setupMarketplaceCommands(program) {
+    program
+        .command("marketplace [role]")
+        .description("🛍️  Browse, install, and manage marketplace skills")
+        .addHelpText('after', `
+Arguments:
+  role                   Optional: 'create' or 'install' (prompts if not provided)
+
+Features:
+  • Creator: List, publish, update, unlist skills and manage versions
+  • Installer: Browse, search, install, and manage marketplace skills
+
+Examples:
+  $ lua marketplace                Interactive selection
+  $ lua marketplace create         Creator actions directly
+  $ lua marketplace install        Installer actions directly
+`)
+        .action(marketplaceCommand);
+}
 /**
  * Sets up skill management commands.
  *

package/dist/commands/env.d.ts

@@ -2,6 +2,17 @@
  * Environment Variables Command
  * Manages environment variables for sandbox and production environments
  */
+import DeveloperApi from '../api/developer.api.service.js';
+export interface EnvVariable {
+    key: string;
+    value: string;
+}
+export interface EnvCommandContext {
+    environment: 'sandbox' | 'production';
+    agentId: string;
+    apiKey: string;
+    developerApi?: DeveloperApi;
+}
 /**
  * Main env command - manages environment variables
  *

package/dist/commands/env.js

@@ -11,6 +11,7 @@ import { withErrorHandling, writeProgress, writeSuccess } from '../utils/cli.js'
 import { BASE_URLS } from '../config/constants.js';
 import { validateConfig, validateAgentConfig, } from '../utils/dev-helpers.js';
 import DeveloperApi from '../api/developer.api.service.js';
+import { loadEnvironmentVariables } from '../utils/env-loader.utils.js';
 /**
  * Main env command - manages environment variables
  *
@@ -154,85 +155,6 @@ async function manageEnvironmentVariables(context) {
         }
     }
 }
-/**
- * Load environment variables based on context
- */
-async function loadEnvironmentVariables(context) {
-    if (context.environment === 'sandbox') {
-        return loadSandboxEnvVariables();
-    }
-    else {
-        return loadProductionEnvVariables(context);
-    }
-}
-/**
- * Load sandbox environment variables from .env file
- */
-function loadSandboxEnvVariables() {
-    const envFilePath = path.join(process.cwd(), '.env');
-    if (!fs.existsSync(envFilePath)) {
-        return [];
-    }
-    try {
-        const content = fs.readFileSync(envFilePath, 'utf8');
-        return parseEnvContent(content);
-    }
-    catch (error) {
-        console.error('❌ Error reading .env file:', error);
-        return [];
-    }
-}
-/**
- * Load production environment variables from API
- */
-async function loadProductionEnvVariables(context) {
-    try {
-        if (!context.developerApi) {
-            throw new Error('Developer API not initialized');
-        }
-        const response = await context.developerApi.getEnvironmentVariables();
-        if (!response.success) {
-            throw new Error(response.error?.message || 'Failed to load environment variables');
-        }
-        // The API returns environment variables nested in a 'data' property
-        // Response structure: { success: true, data: { data: { KEY: "value", ... }, _id: "...", ... } }
-        const envData = response.data?.data || response.data;
-        if (envData && typeof envData === 'object') {
-            // Filter out metadata fields like _id, agentId, createdAt, updatedAt, __v
-            const metadataKeys = ['_id', 'agentId', 'data', 'createdAt', 'updatedAt', '__v'];
-            return Object.entries(envData)
-                .filter(([key]) => !metadataKeys.includes(key))
-                .map(([key, value]) => ({
-                key,
-                value: String(value)
-            }));
-        }
-        return [];
-    }
-    catch (error) {
-        console.error('❌ Error loading production env variables:', error);
-        return [];
-    }
-}
-/**
- * Parse .env file content into variables
- */
-function parseEnvContent(content) {
-    if (!content.trim())
-        return [];
-    return content
-        .split('\n')
-        .map(line => line.trim())
-        .filter(line => line && !line.startsWith('#'))
-        .map(line => {
-        const [key, ...valueParts] = line.split('=');
-        return {
-            key: key?.trim() || '',
-            value: valueParts.join('=') || ''
-        };
-    })
-        .filter(item => item.key);
-}
 /**
  * Convert variables array to .env file content
  */

package/dist/commands/index.d.ts

@@ -24,3 +24,4 @@ export { jobsCommand } from "./jobs.js";
 export { featuresCommand } from "./features.js";
 export { preprocessorsCommand } from "./preprocessors.js";
 export { postprocessorsCommand } from "./postprocessors.js";
+export { marketplaceCommand } from "./marketplace.js";

package/dist/commands/index.js

@@ -24,3 +24,4 @@ export { jobsCommand } from "./jobs.js";
 export { featuresCommand } from "./features.js";
 export { preprocessorsCommand } from "./preprocessors.js";
 export { postprocessorsCommand } from "./postprocessors.js";
+export { marketplaceCommand } from "./marketplace.js";