lua-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Lua AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,176 @@
+# Lua CLI
+
+A command-line interface for the Lua AI platform that helps you manage agents, organizations, and skills with ease.
+
+## Features
+
+- 🔐 **Secure Authentication**: Support for both API key and email-based OTP authentication
+- 🏢 **Organization Management**: Select and manage multiple organizations
+- 🤖 **Agent Management**: Choose from available agents within your organizations
+- 🛠️ **Skill Development**: Initialize new Lua skills with proper configuration
+- 🔑 **API Key Management**: Securely store, view, and manage your API keys
+- 📦 **Template System**: Quick project setup with pre-configured templates
+
+## Installation
+
+Install the Lua CLI globally using npm:
+
+```bash
+npm install -g lua-cli
+```
+
+## Quick Start
+
+1. **Configure your authentication:**
+   ```bash
+   lua configure
+   ```
+   Choose between API key or email authentication methods.
+
+2. **Initialize a new skill project:**
+   ```bash
+   lua init
+   ```
+   Select your organization and agent, then provide skill details.
+
+3. **View your API key:**
+   ```bash
+   lua apiKey
+   ```
+
+4. **List your agents:**
+   ```bash
+   lua agents
+   ```
+
+5. **Delete your stored credentials:**
+   ```bash
+   lua destroy
+   ```
+
+## Commands
+
+### `lua configure`
+
+Set up your authentication credentials. You can choose between:
+
+- **API Key**: Direct API key input
+- **Email**: Email-based OTP authentication
+
+```bash
+lua configure
+```
+
+### `lua init`
+
+Initialize a new Lua skill project in the current directory.
+
+```bash
+lua init
+```
+
+This command will:
+- Fetch your organizations and agents from the API
+- Let you select an organization by name
+- Let you choose an agent from the selected organization
+- Prompt for skill name and description
+- Create a `lua.skill.toml` configuration file
+- Copy template files to the current directory
+
+### `lua apiKey`
+
+Display your stored API key (with confirmation prompt).
+
+```bash
+lua apiKey
+```
+
+### `lua agents`
+
+Fetch and display your agents from the HeyLua API.
+
+```bash
+lua agents
+```
+
+### `lua destroy`
+
+Delete your stored API key and credentials.
+
+```bash
+lua destroy
+```
+
+## Configuration File
+
+The `lua.skill.toml` file is created when you run `lua init`:
+
+```toml
+[agent]
+agentId = "your-agent-id"
+orgId = "your-organization-id"
+
+[skill]
+name = "Your Skill Name"
+description = "Description of your skill"
+```
+
+## Authentication Methods
+
+### API Key Authentication
+
+1. Run `lua configure`
+2. Select "API Key"
+3. Enter your API key when prompted
+4. The key is validated and stored securely
+
+### Email Authentication
+
+1. Run `lua configure`
+2. Select "Email"
+3. Enter your email address
+4. Check your email for the OTP code
+5. Enter the 6-digit OTP code
+6. An API key is automatically generated and stored
+
+## Security
+
+- All API keys are stored securely using your system's credential manager
+- Email authentication uses OTP (One-Time Password) for secure verification
+- Confirmation prompts prevent accidental exposure of sensitive information
+- No credentials are stored in plain text
+
+## Requirements
+
+- Node.js 16.0.0 or higher
+- Valid Lua AI platform account
+
+## Development
+
+To contribute to this project:
+
+1. Clone the repository
+2. Install dependencies: `npm install`
+3. Build the project: `npm run build`
+4. Make your changes
+5. Test your changes
+6. Submit a pull request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Support
+
+For support and questions:
+- Create an issue on [GitHub](https://github.com/heylua/lua-cli/issues)
+- Contact: stefan@heylua.ai
+
+## Changelog
+
+### 1.0.0
+- Initial release
+- API key and email authentication
+- Organization and agent management
+- Skill project initialization
+- Secure credential storage

package/dist/index.js

@@ -0,0 +1,348 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import inquirer from "inquirer";
+import keytar from "keytar";
+import fetch from "node-fetch";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+const program = new Command();
+const SERVICE = "lua-cli";
+const ACCOUNT = "api-key";
+async function saveApiKey(apiKey) {
+    await keytar.setPassword(SERVICE, ACCOUNT, apiKey);
+}
+async function loadApiKey() {
+    return keytar.getPassword(SERVICE, ACCOUNT);
+}
+async function deleteApiKey() {
+    return keytar.deletePassword(SERVICE, ACCOUNT);
+}
+async function requestEmailOTP(email) {
+    try {
+        const response = await fetch("https://auth.heylua.ai/otp", {
+            method: "POST",
+            headers: {
+                "accept": "application/json",
+                "Content-Type": "application/json"
+            },
+            body: JSON.stringify({
+                type: "email",
+                email: email
+            })
+        });
+        return response.ok;
+    }
+    catch (error) {
+        console.error("❌ Error requesting OTP:", error);
+        return false;
+    }
+}
+async function verifyOTPAndGetToken(email, pin) {
+    try {
+        const response = await fetch("https://auth.heylua.ai/otp/verify", {
+            method: "POST",
+            headers: {
+                "accept": "application/json",
+                "Content-Type": "application/json"
+            },
+            body: JSON.stringify({
+                pin: pin,
+                type: "email",
+                email: email
+            })
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const data = await response.json();
+        return data.signInToken;
+    }
+    catch (error) {
+        console.error("❌ Error verifying OTP:", error);
+        return null;
+    }
+}
+async function generateApiKey(signInToken) {
+    try {
+        const response = await fetch("https://auth.heylua.ai/profile/apiKey", {
+            method: "POST",
+            headers: {
+                "Authorization": `Bearer ${signInToken}`,
+                "Content-Type": "application/json"
+            },
+            body: ""
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const data = await response.json();
+        return data.apiKey;
+    }
+    catch (error) {
+        console.error("❌ Error generating API key:", error);
+        return null;
+    }
+}
+async function checkApiKey(apiKey) {
+    const response = await fetch("https://api.heylua.ai/admin", {
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+        },
+    });
+    if (!response.ok) {
+        console.error(`❌ Invalid API key`);
+        process.exit(1);
+    }
+    return await response.json();
+}
+function copyTemplateFiles(templateDir, targetDir) {
+    const files = fs.readdirSync(templateDir);
+    for (const file of files) {
+        const srcPath = path.join(templateDir, file);
+        const destPath = path.join(targetDir, file);
+        if (fs.statSync(srcPath).isDirectory()) {
+            fs.mkdirSync(destPath, { recursive: true });
+            copyTemplateFiles(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+function createSkillToml(agentId, orgId, skillName, skillDescription) {
+    const tomlContent = `[agent]
+agentId = "${agentId}"
+orgId = "${orgId}"
+
+[skill]
+name = "${skillName}"
+description = "${skillDescription}"
+`;
+    fs.writeFileSync("lua.skill.toml", tomlContent);
+}
+program
+    .command("init")
+    .description("Initialize a new Lua skill project")
+    .action(async () => {
+    const apiKey = await loadApiKey();
+    if (!apiKey) {
+        console.error("❌ No API key found. Run `lua configure` first.");
+        process.exit(1);
+    }
+    // Get user data from API
+    const userData = await checkApiKey(apiKey);
+    // Extract organizations and create choices for selection
+    const orgs = userData.admin.orgs;
+    const orgChoices = orgs.map((org) => ({
+        name: org.registeredName,
+        value: org
+    }));
+    // Select organization
+    const { selectedOrg } = await inquirer.prompt([
+        {
+            type: "list",
+            name: "selectedOrg",
+            message: "Select an organization:",
+            choices: orgChoices
+        }
+    ]);
+    // Extract agents from selected organization
+    const agentChoices = selectedOrg.agents.map((agent) => ({
+        name: agent.name,
+        value: agent
+    }));
+    // Select agent
+    const { selectedAgent } = await inquirer.prompt([
+        {
+            type: "list",
+            name: "selectedAgent",
+            message: "Select an agent:",
+            choices: agentChoices
+        }
+    ]);
+    // Get skill details
+    const { skillName, skillDescription } = await inquirer.prompt([
+        {
+            type: "input",
+            name: "skillName",
+            message: "Enter a name for your skill:",
+            default: "My Lua Skill"
+        },
+        {
+            type: "input",
+            name: "skillDescription",
+            message: "Describe your skill:",
+            default: "A Lua skill for automation"
+        }
+    ]);
+    // Create lua.skill.toml file
+    createSkillToml(selectedAgent.agentId, selectedOrg.id, skillName, skillDescription);
+    console.log("✅ Created lua.skill.toml");
+    // Copy template files
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    const templateDir = path.join(__dirname, "..", "template");
+    const currentDir = process.cwd();
+    copyTemplateFiles(templateDir, currentDir);
+    console.log("✅ Copied template files");
+    console.log("🎉 Lua skill project initialized successfully!");
+});
+program
+    .command("destroy")
+    .description("Delete your stored API key")
+    .action(async () => {
+    const apiKey = await loadApiKey();
+    if (!apiKey) {
+        console.log("ℹ️  No API key found to delete.");
+        return;
+    }
+    const { confirm } = await inquirer.prompt([
+        {
+            type: "confirm",
+            name: "confirm",
+            message: "Are you sure you want to delete your API key? This action cannot be undone.",
+            default: false
+        }
+    ]);
+    if (confirm) {
+        const deleted = await deleteApiKey();
+        if (deleted) {
+            console.log("✅ API key deleted successfully.");
+        }
+        else {
+            console.log("❌ Failed to delete API key.");
+        }
+    }
+    else {
+        console.log("ℹ️  API key deletion cancelled.");
+    }
+});
+program
+    .command("configure")
+    .description("Set up your API key")
+    .action(async () => {
+    // Choose authentication method
+    const { authMethod } = await inquirer.prompt([
+        {
+            type: "list",
+            name: "authMethod",
+            message: "Choose authentication method:",
+            choices: [
+                { name: "API Key", value: "api-key" },
+                { name: "Email", value: "email" }
+            ]
+        }
+    ]);
+    if (authMethod === "api-key") {
+        // Existing API key flow
+        const answers = await inquirer.prompt([
+            {
+                type: "password",
+                name: "apiKey",
+                message: "Enter your API key",
+                mask: "*",
+            },
+        ]);
+        const data = await checkApiKey(answers.apiKey);
+        if (!data) {
+            console.error("❌ Invalid API key");
+            process.exit(1);
+        }
+        await saveApiKey(answers.apiKey);
+        console.log("✅ API key saved securely.");
+    }
+    else if (authMethod === "email") {
+        // Email authentication flow
+        const { email } = await inquirer.prompt([
+            {
+                type: "input",
+                name: "email",
+                message: "Enter your email address:",
+                validate: (input) => {
+                    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+                    return emailRegex.test(input) || "Please enter a valid email address";
+                }
+            }
+        ]);
+        console.log("📧 Sending OTP to your email...");
+        const otpSent = await requestEmailOTP(email);
+        if (!otpSent) {
+            console.error("❌ Failed to send OTP. Please try again.");
+            process.exit(1);
+        }
+        console.log("✅ OTP sent successfully!");
+        const { pin } = await inquirer.prompt([
+            {
+                type: "input",
+                name: "pin",
+                message: "Enter the OTP code:",
+                validate: (input) => {
+                    return input.length === 6 || "OTP must be 6 digits";
+                }
+            }
+        ]);
+        console.log("🔐 Verifying OTP...");
+        const signInToken = await verifyOTPAndGetToken(email, pin);
+        if (!signInToken) {
+            console.error("❌ Invalid OTP. Please try again.");
+            process.exit(1);
+        }
+        console.log("✅ OTP verified successfully!");
+        console.log("🔑 Generating API key...");
+        const apiKey = await generateApiKey(signInToken);
+        if (!apiKey) {
+            console.error("❌ Failed to generate API key. Please try again.");
+            process.exit(1);
+        }
+        await saveApiKey(apiKey);
+        console.log("✅ API key generated and saved securely.");
+    }
+});
+program
+    .command("apiKey")
+    .description("Display your stored API key")
+    .action(async () => {
+    const apiKey = await loadApiKey();
+    if (!apiKey) {
+        console.log("ℹ️  No API key found. Run `lua configure` first.");
+        return;
+    }
+    const { confirm } = await inquirer.prompt([
+        {
+            type: "confirm",
+            name: "confirm",
+            message: "This will display your API key. Are you sure you want to continue?",
+            default: false
+        }
+    ]);
+    if (confirm) {
+        console.log("🔑 Your API key:");
+        console.log(apiKey);
+    }
+    else {
+        console.log("ℹ️  API key display cancelled.");
+    }
+});
+program
+    .command("agents")
+    .description("Fetch agents from HeyLua API")
+    .action(async () => {
+    const apiKey = await loadApiKey();
+    if (!apiKey) {
+        console.error("❌ No API key found. Run `lua configure` first.");
+        process.exit(1);
+    }
+    const response = await fetch("https://api.heylua.ai/admin", {
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+        },
+    });
+    if (!response.ok) {
+        console.error(`❌ Error ${response.status}: ${await response.text()}`);
+        process.exit(1);
+    }
+    const data = await response.json();
+    console.log("✅ Agents:", JSON.stringify(data, null, 2));
+});
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "lua-cli",
+  "version": "1.0.0",
+  "description": "Command-line interface for Lua AI platform - manage agents, organizations, and skills",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "lua",
+    "ai",
+    "cli",
+    "command-line",
+    "automation",
+    "agents",
+    "api",
+    "typescript"
+  ],
+  "author": "Stefan Kruger <stefan@heylua.ai>",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/heylua/lua-cli.git"
+  },
+  "homepage": "https://github.com/heylua/lua-cli#readme",
+  "bugs": {
+    "url": "https://github.com/heylua/lua-cli/issues"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "template/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "commander": "^14.0.1",
+    "inquirer": "^12.9.6",
+    "keytar": "^7.9.0",
+    "node-fetch": "^3.3.2"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^24.5.1",
+    "@types/node-fetch": "^2.6.13",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.2"
+  },
+  "bin": {
+    "lua": "dist/index.js"
+  }
+}

package/template/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "lua-skill",
+  "version": "1.0.0",
+  "description": "",
+  "license": "ISC",
+  "author": "",
+  "type": "commonjs",
+  "main": "index.ts",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}