lua-cli 1.2.0 → 1.3.0-alpha.1

package/dist/skill.d.ts

@@ -1,9 +1,30 @@
 import { ZodType } from "zod";
 import { LuaTool } from "./types/index.js";
 export { LuaTool };
+export interface LuaSkillConfig {
+    description: string;
+    context: string;
+}
 export declare class LuaSkill {
     private readonly tools;
-    constructor();
+    private readonly description;
+    private readonly context;
+    /**
+     * Creates a new LuaSkill instance
+     *
+     * @param config - Configuration object containing skill metadata
+     * @param config.description - Short description of what the skill does (1-2 sentences)
+     * @param config.context - Detailed explanation of how the agent should use the tools
+     *
+     * @example
+     * ```typescript
+     * const skill = new LuaSkill({
+     *   description: "Weather and calculator utilities",
+     *   context: "This skill provides weather information for any city and basic mathematical operations. Use get_weather for current conditions and calculator for arithmetic operations."
+     * });
+     * ```
+     */
+    constructor(config: LuaSkillConfig);
     addTool<TInput extends ZodType, TOutput extends ZodType>(tool: LuaTool<TInput, TOutput>): void;
     run(input: Record<string, any>): Promise<any>;
 }

package/dist/skill.js

@@ -1,8 +1,28 @@
+import { assertValidToolName } from "./types/index.js";
 export class LuaSkill {
-    constructor() {
+    /**
+     * Creates a new LuaSkill instance
+     *
+     * @param config - Configuration object containing skill metadata
+     * @param config.description - Short description of what the skill does (1-2 sentences)
+     * @param config.context - Detailed explanation of how the agent should use the tools
+     *
+     * @example
+     * ```typescript
+     * const skill = new LuaSkill({
+     *   description: "Weather and calculator utilities",
+     *   context: "This skill provides weather information for any city and basic mathematical operations. Use get_weather for current conditions and calculator for arithmetic operations."
+     * });
+     * ```
+     */
+    constructor(config) {
         this.tools = [];
+        this.description = config.description;
+        this.context = config.context;
     }
     addTool(tool) {
+        // Validate the tool name before adding it
+        assertValidToolName(tool.name);
         this.tools.push(tool);
     }
     async run(input) {

package/dist/types/index.d.ts

@@ -53,6 +53,15 @@ export interface ApiKeyResponse {
     apiId: string;
 }
 import { ZodType } from "zod";
+/**
+ * Validates that a tool name contains only alphanumeric characters, hyphens, and underscores.
+ * No spaces or other special characters are allowed.
+ */
+export declare function validateToolName(name: string): boolean;
+/**
+ * Throws an error if the tool name is invalid
+ */
+export declare function assertValidToolName(name: string): void;
 export interface LuaTool<TInput extends ZodType = ZodType, TOutput extends ZodType = ZodType> {
     name: string;
     description: string;
@@ -60,10 +69,15 @@ export interface LuaTool<TInput extends ZodType = ZodType, TOutput extends ZodTy
     outputSchema: TOutput;
     execute: (input: any) => Promise<any>;
 }
+export interface LuaSkillConfig {
+    description: string;
+    context: string;
+}
 export declare class LuaSkill {
-    private readonly apiKey;
     private readonly tools;
-    constructor(apiKey: string);
+    private readonly description;
+    private readonly context;
+    constructor(config: LuaSkillConfig);
     addTool<TInput extends ZodType, TOutput extends ZodType>(tool: LuaTool<TInput, TOutput>): void;
     run(input: Record<string, any>): Promise<any>;
 }

package/dist/types/index.js

@@ -1 +1,16 @@
-export {};
+/**
+ * Validates that a tool name contains only alphanumeric characters, hyphens, and underscores.
+ * No spaces or other special characters are allowed.
+ */
+export function validateToolName(name) {
+    const validNameRegex = /^[a-zA-Z0-9_-]+$/;
+    return validNameRegex.test(name);
+}
+/**
+ * Throws an error if the tool name is invalid
+ */
+export function assertValidToolName(name) {
+    if (!validateToolName(name)) {
+        throw new Error(`Invalid tool name "${name}". Tool names can only contain alphanumeric characters, hyphens (-), and underscores (_). No spaces or other special characters are allowed.`);
+    }
+}

package/dist/utils/cli.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Centralized CLI utilities for consistent error handling and output management
+ */
+/**
+ * Wraps a command function with standardized error handling
+ * Handles SIGINT (Ctrl+C) gracefully and provides consistent error messages
+ */
+export declare function withErrorHandling<T>(commandFn: () => Promise<T>, commandName: string): Promise<T>;
+/**
+ * Clears the specified number of lines from the terminal
+ * Used to clean up inquirer prompt output ONLY
+ * Should NOT be used to clear user input commands
+ */
+export declare function clearPromptLines(count?: number): void;
+/**
+ * Writes a progress message that will be replaced by the next message
+ * Uses carriage return to overwrite the current line
+ */
+export declare function writeProgress(message: string): void;
+/**
+ * Writes a final success message that will remain visible
+ * Uses console.log to ensure it stays in the output
+ */
+export declare function writeSuccess(message: string): void;
+/**
+ * Writes an error message
+ * Uses console.error for proper error output
+ */
+export declare function writeError(message: string): void;
+/**
+ * Writes an info message
+ * Uses console.log for informational output
+ */
+export declare function writeInfo(message: string): void;

package/dist/utils/cli.js

@@ -0,0 +1,58 @@
+/**
+ * Centralized CLI utilities for consistent error handling and output management
+ */
+/**
+ * Wraps a command function with standardized error handling
+ * Handles SIGINT (Ctrl+C) gracefully and provides consistent error messages
+ */
+export async function withErrorHandling(commandFn, commandName) {
+    try {
+        return await commandFn();
+    }
+    catch (error) {
+        if (error.name === 'ExitPromptError') {
+            console.log("\n❌ Operation cancelled.");
+            process.exit(0);
+        }
+        console.error(`❌ Error during ${commandName}:`, error.message);
+        process.exit(1);
+    }
+}
+/**
+ * Clears the specified number of lines from the terminal
+ * Used to clean up inquirer prompt output ONLY
+ * Should NOT be used to clear user input commands
+ */
+export function clearPromptLines(count = 1) {
+    for (let i = 0; i < count; i++) {
+        process.stdout.write('\x1b[1A\x1b[2K'); // Move up 1 line and clear it
+    }
+}
+/**
+ * Writes a progress message that will be replaced by the next message
+ * Uses carriage return to overwrite the current line
+ */
+export function writeProgress(message) {
+    process.stdout.write(`${message}\r`);
+}
+/**
+ * Writes a final success message that will remain visible
+ * Uses console.log to ensure it stays in the output
+ */
+export function writeSuccess(message) {
+    console.log(message);
+}
+/**
+ * Writes an error message
+ * Uses console.error for proper error output
+ */
+export function writeError(message) {
+    console.error(message);
+}
+/**
+ * Writes an info message
+ * Uses console.log for informational output
+ */
+export function writeInfo(message) {
+    console.log(message);
+}

package/dist/utils/files.d.ts

@@ -1,2 +1,2 @@
 export declare function copyTemplateFiles(templateDir: string, targetDir: string): void;
-export declare function createSkillToml(agentId: string, orgId: string, skillName: string, skillDescription: string): void;
+export declare function createSkillToml(agentId: string, orgId: string, skillName: string, skillId?: string): void;

package/dist/utils/files.js

@@ -39,14 +39,15 @@ function updatePackageJson(srcPath, destPath) {
     // Write the updated package.json
     fs.writeFileSync(destPath, JSON.stringify(templatePackageJson, null, 2) + '\n');
 }
-export function createSkillToml(agentId, orgId, skillName, skillDescription) {
+export function createSkillToml(agentId, orgId, skillName, skillId) {
+    const skillIdSection = skillId ? `skillId = "${skillId}"\n` : '';
     const tomlContent = `[agent]
 agentId = "${agentId}"
 orgId = "${orgId}"
 
 [skill]
 name = "${skillName}"
-description = "${skillDescription}"
-`;
+version = "0.0.1"
+${skillIdSection}`;
     fs.writeFileSync("lua.skill.toml", tomlContent);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lua-cli",
-  "version": "1.2.0",
+  "version": "1.3.0-alpha.1",
   "description": "Command-line interface for Lua AI platform - develop, test, and deploy LuaSkills with custom tools",
   "readmeFilename": "README.md",
   "main": "dist/index.js",
@@ -11,7 +11,7 @@
   },
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "npm run clean && tsc",
+    "build": "npm run clean && tsc && chmod +x dist/index.js && npm link",
     "prepublishOnly": "npm run build",
     "test": "jest",
     "test:watch": "jest --watch",
@@ -32,7 +32,7 @@
     "deployment",
     "skills"
   ],
-  "author": "Stefan Kruger <stefan@heylua.ai>",
+  "author": "Stefan Kruger <stefan@lua.dev>",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -56,6 +56,7 @@
   ],
   "dependencies": {
     "commander": "^14.0.1",
+    "esbuild": "^0.25.10",
     "inquirer": "^12.9.6",
     "keytar": "^7.9.0",
     "node-fetch": "^3.3.2",
@@ -66,7 +67,6 @@
     "@types/jest": "^29.5.8",
     "@types/node": "^24.5.1",
     "@types/node-fetch": "^2.6.13",
-    "esbuild": "^0.25.10",
     "jest": "^29.7.0",
     "ts-jest": "^29.1.1",
     "ts-node": "^10.9.2",

package/template/.lua/deploy.json

@@ -1,6 +1,9 @@
 {
   "version": "1.0.1-beta.0",
   "skillsName": "lua-skill",
+  "skillId": "",
+  "description": "A comprehensive Lua skill with weather, user data, post creation, and mathematical tools",
+  "context": "This skill provides various utilities including weather information, user data retrieval, post creation, basic calculator operations, and advanced mathematical functions. Use get_weather to fetch current weather conditions for any city, get_user_data to retrieve user information, create_post to publish new posts, calculator for basic arithmetic operations, and advanced_math for complex mathematical computations like factorials, prime checking, fibonacci sequences, and greatest common divisor calculations.",
   "tools": [
     {
       "name": "get_weather",

package/template/index.ts

@@ -6,7 +6,10 @@ import CalculatorTool from "./tools/CalculatorTool";
 import AdvancedMathTool from "./tools/AdvancedMathTool";
 
 // Initialize skill with tools
-const skill = new LuaSkill();
+const skill = new LuaSkill({
+    description: "A comprehensive Lua skill with weather, user data, post creation, and mathematical tools",
+    context: "This skill provides various utilities including weather information, user data retrieval, post creation, basic calculator operations, and advanced mathematical functions. Use get_weather to fetch current weather conditions for any city, get_user_data to retrieve user information, create_post to publish new posts, calculator for basic arithmetic operations, and advanced_math for complex mathematical computations like factorials, prime checking, fibonacci sequences, and greatest common divisor calculations."
+});
 skill.addTool(new GetWeatherTool());
 skill.addTool(new GetUserDataTool());
 skill.addTool(new CreatePostTool());

package/template/tools/AdvancedMathTool.ts

@@ -30,7 +30,7 @@ export default class AdvancedMathTool implements LuaTool<typeof inputSchema, typ
     this.mathService = new MathService();
   }
   
-  async execute(input) {
+  async execute(input: z.infer<typeof inputSchema>) {
     let result: any;
     
     switch (input.operation) {

package/template/tools/CalculatorTool.ts

@@ -28,7 +28,7 @@ export default class CalculatorTool implements LuaTool<typeof inputSchema, typeo
     this.outputSchema = outputSchema;
   }
   
-  async execute(input) {
+  async execute(input: z.infer<typeof inputSchema>) {
     let result: number;
     let expression: string;