lua-cli 1.3.0-alpha.1 → 1.3.1

package/CHANGELOG.md

@@ -11,12 +11,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Centralized CLI Utilities**: New `src/utils/cli.ts` module for consistent error handling and output management
 - **Command Restructuring**: Reorganized commands into logical groups:
   - `lua auth` - Authentication management (configure, logout, key)
-  - `lua skill` - Skill development (init, compile, test, push, deploy)
+  - `lua skill` - Skill development (init, compile, test, push, dev, deploy)
 - **Enhanced Error Handling**: Graceful handling of Ctrl+C (SIGINT) across all commands
 - **Consistent Output Management**: Standardized progress messages, success messages, and prompt clearing
 - **Tool Name Validation**: Regex-based validation for tool names (alphanumeric, hyphens, underscores only)
 - **Version Management**: TOML-based version tracking with automatic versioning
-- **Skill Push/Deploy**: New commands for version management and production deployment
+- **Skill Push/Deploy/Dev**: New commands for version management, sandbox development, and production deployment
+- **Smart Sandbox Management**: Dev command intelligently reuses existing sandbox skill IDs and falls back to creating new ones when needed
+- **File Watching Mode**: Dev command now watches for file changes and automatically recompiles and pushes to sandbox
+- **Web Chat Interface**: Dev command now includes a beautiful web-based chat interface for real-time skill testing
+- **Live Log Panel**: Real-time log feed with WebSocket connection for monitoring execution details
+- **Log Details Support**: Enhanced log display with detailed information sections and proper error handling
 - **Comprehensive Testing**: 100% test coverage for CLI utilities with 44 passing tests
 
 ### Changed
@@ -27,7 +32,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `lua init` → `lua skill init`
   - `lua compile` → `lua skill compile`
   - `lua test` → `lua skill test`
-  - Added `lua skill push` and `lua skill deploy`
+  - Added `lua skill push`, `lua skill dev`, and `lua skill deploy`
 - **LuaSkill Constructor**: Now accepts object `{description, context}` instead of separate parameters
 - **TOML Configuration**: Added `version` and `skillId` fields to `lua.skill.toml`
 - **Error Messages**: Standardized format: `"❌ Error during [command]: [message]"`

package/README.md

@@ -27,6 +27,7 @@ lua --help
 - 🧪 **Interactive Testing**: Test your tools with real-time execution
 - 🚀 **Deployment**: Compile and deploy skills to the Lua platform
 - 🔑 **API Key Management**: Securely store, view, and manage your API keys
+- 💾 **User Data API**: Built-in API for persistent user data storage in your tools
 - 📚 **Comprehensive Documentation**: Complete guides and examples
 
 ## Quick Start
@@ -41,7 +42,7 @@ lua --help
    ```bash
    lua skill init
    ```
-   Select your organization and agent, then provide skill details.
+   Choose between selecting an existing agent or creating a new one, then provide skill details.
 
 3. **Develop your tools:**
    ```bash
@@ -111,9 +112,16 @@ lua skill 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
+- **Choose between existing agents or creating a new one:**
+  - **Existing Agent**: Select from your current agents
+  - **New Agent**: Create a custom agent with:
+    - Agent type selection (Base Agent, Shopify, WooCommerce, etc.)
+    - Required metadata collection (API keys, IDs, etc.)
+    - Feature configuration (RAG, tickets, web search, etc.)
+    - Business information (name, type, personality, traits)
+    - Automatic persona generation and welcome message
 - Prompt for skill name and description
-- Create a `lua.skill.toml` configuration file
+- Create a `lua.skill.yaml` configuration file with agent details
 - Copy template files to the current directory
 
 #### `lua skill compile`
@@ -162,7 +170,43 @@ This command will:
 - Compile your skill first
 - Confirm the version you want to push
 - Send the compiled skill data to the server
-- Store the skill ID in your TOML file
+- Store the skill ID in your YAML file
+
+#### `lua skill dev`
+
+Push your compiled skill version to the sandbox for development and testing with automatic file watching and web chat interface.
+
+```bash
+lua skill dev
+```
+
+This command will:
+- Compile your skill first
+- Confirm the version you want to push to sandbox
+- **Smart Sandbox Management**:
+  - If you have a previous sandbox skill ID stored, it will try to update the existing sandbox
+  - If the update fails or no sandbox exists, it will create a new one
+  - The sandbox skill ID is securely stored on your machine for future use
+- Display the sandbox skill ID for testing
+- **Web Chat Interface**:
+  - Automatically opens a beautiful chat interface in your browser
+  - Test your sandbox skill in real-time with natural language
+  - Messages are sent to the sandbox environment via the chat API
+  - Available at `http://localhost:3000` (opens automatically)
+- **Live Log Panel**:
+  - Real-time log feed showing execution details
+  - WebSocket connection to `wss://api.lua.dev/feed`
+  - Console-style interface with color-coded log levels
+  - Shows tool calls, errors, metrics, and execution metadata
+  - Displays detailed information in expandable sections
+  - Connection status indicator and automatic reconnection
+  - Supports log types: error, debug, warn, info
+- **File Watching Mode**:
+  - Watches for file changes in the current directory
+  - Automatically recompiles and pushes to sandbox when files change
+  - Ignores build artifacts (`.lua/`, `node_modules/`, `.git/`, etc.)
+  - Debounces rapid changes to prevent excessive builds
+  - Press `Ctrl+C` to stop watching and exit
 
 #### `lua skill deploy`
 
@@ -237,17 +281,19 @@ template/
 
 ## Configuration File
 
-The `lua.skill.toml` file is created when you run `lua skill init`:
+The `lua.skill.yaml` file is created when you run `lua skill init`:
 
-```toml
-[agent]
-agentId = "your-agent-id"
-orgId = "your-organization-id"
+```yaml
+agent:
+  agentId: "your-agent-id"
+  orgId: "your-organization-id"
+  persona: "Generated persona description" # Only for newly created agents
+  welcomeMessage: "Welcome message" # Only for newly created agents
 
-[skill]
-name = "Your Skill Name"
-version = "0.0.1"
-skillId = "your-skill-id"
+skill:
+  name: "Your Skill Name"
+  version: "0.0.1"
+  skillId: "your-skill-id"
 ```
 
 ## Authentication Methods
@@ -348,6 +394,106 @@ To contribute to this project:
 
 MIT License - see [LICENSE](LICENSE) file for details.
 
+## User Data API
+
+The Lua CLI provides a built-in User Data API that allows your tools to interact with persistent user data stored in the Lua system.
+
+### Basic Usage
+
+```typescript
+import { user } from 'lua-cli/user-data-api';
+
+// Get user data
+const userData = await user.data.get();
+console.log('User data:', userData);
+
+// Create or update user data
+await user.data.create({
+  name: 'John Doe',
+  preferences: {
+    theme: 'dark',
+    language: 'en'
+  }
+});
+
+// Update existing data
+await user.data.update({
+  name: 'Jane Doe',
+  preferences: {
+    theme: 'light',
+    language: 'es'
+  }
+});
+
+// Clear all user data
+await user.data.clear();
+```
+
+### Using in Tools
+
+```typescript
+import { LuaTool } from 'lua-cli/skill';
+import { user } from 'lua-cli/user-data-api';
+import { z } from 'zod';
+
+export class UserPreferencesTool extends LuaTool {
+  constructor() {
+    super('user-preferences', 'Manage user preferences');
+  }
+
+  async execute(input: { action: string; key?: string; value?: string }) {
+    const { action, key, value } = input;
+
+    switch (action) {
+      case 'get':
+        const userData = await user.data.get();
+        return { preferences: userData.preferences || {} };
+      
+      case 'set':
+        if (!key || !value) {
+          throw new Error('Key and value are required for set action');
+        }
+        
+        const currentData = await user.data.get();
+        const updatedData = {
+          ...currentData,
+          preferences: {
+            ...currentData.preferences,
+            [key]: value
+          }
+        };
+        
+        await user.data.update(updatedData);
+        return { success: true, message: `Set ${key} to ${value}` };
+      
+      case 'clear':
+        await user.data.clear();
+        return { success: true, message: 'All preferences cleared' };
+      
+      default:
+        throw new Error('Invalid action. Use: get, set, or clear');
+    }
+  }
+
+  getInputSchema() {
+    return z.object({
+      action: z.enum(['get', 'set', 'clear']).describe('Action to perform'),
+      key: z.string().optional().describe('Preference key (required for set action)'),
+      value: z.string().optional().describe('Preference value (required for set action)')
+    });
+  }
+}
+```
+
+### API Reference
+
+- `user.data.get()` - Retrieves current user data
+- `user.data.create(data)` - Creates or updates user data
+- `user.data.update(data)` - Updates existing user data (alias for create)
+- `user.data.clear()` - Clears all user data
+
+For more details, see [USER_DATA_API.md](./USER_DATA_API.md).
+
 ## Support
 
 For support and questions:
@@ -356,11 +502,19 @@ For support and questions:
 
 ## Changelog
 
+### 1.4.0
+- **Agent Creation**: Added ability to create new agents during `lua skill init`
+- **Agent Type Selection**: Choose from various agent types (Base Agent, Shopify, WooCommerce, etc.)
+- **Metadata Collection**: Automatic collection of required metadata for agent types
+- **Feature Configuration**: Enable/disable features like RAG, tickets, web search
+- **Persona Generation**: Automatic persona and welcome message generation for new agents
+- **Enhanced YAML**: Added persona and welcome message fields to configuration file
+
 ### 1.3.0
 - **Command Restructure**: Reorganized commands under `lua auth` and `lua skill` groups
 - **New Push Command**: Added `lua skill push` to push versions to server
 - **New Deploy Command**: Added `lua skill deploy` to deploy versions to production
-- **Version Management**: Added version field to TOML configuration
+- **Version Management**: Added version field to YAML configuration
 - **Improved UX**: Better command organization and intuitive naming
 - **Enhanced Workflow**: Complete skill lifecycle from init to production deployment
 

package/dist/commands/agents.js

@@ -1,4 +1,4 @@
-import fetch from "node-fetch";
+import { ApiService } from '../services/api.js';
 import { loadApiKey } from "../services/auth.js";
 import { withErrorHandling, writeSuccess } from "../utils/cli.js";
 export async function agentsCommand() {
@@ -8,16 +8,12 @@ export async function agentsCommand() {
             console.error("❌ No API key found. Run `lua configure` first.");
             process.exit(1);
         }
-        const response = await fetch("https://api.lua.dev/admin", {
-            headers: {
-                Authorization: `Bearer ${apiKey}`,
-            },
-        });
-        if (!response.ok) {
-            console.error(`❌ Error ${response.status}: ${await response.text()}`);
+        const response = await ApiService.Agent.getOrganizations(apiKey);
+        if (!response.success) {
+            console.error(`❌ Error: ${response.error?.message || 'Unknown error'}`);
             process.exit(1);
         }
-        const data = await response.json();
+        const data = response.data;
         writeSuccess("✅ Agents retrieved successfully:");
         console.log(JSON.stringify(data, null, 2));
     }, "agents listing");