lua-cli 3.5.0-beta.1 → 3.6.0

package/docs/API_REFERENCE.md

@@ -768,6 +768,3 @@ const user = await User.get();
 - [API Index](./API_INDEX.md) - Quick reference table
 
 ---
-
-**Version:** 3.5.0-alpha.3
-**Last Updated:** February 2026

package/docs/CLI_REFERENCE.md

@@ -663,7 +663,7 @@ lua --version
 **Example:**
 ```bash
 $ lua --version
-lua-cli v3.5.0-alpha.3
+lua-cli vX.Y.Z
 ```
 
 ---
@@ -919,6 +919,3 @@ lua deploy skill --name my-skill --version 1.0.0
 - [Main README](../README.md) - Project overview
 
 ---
-
-**Version:** 3.5.0-alpha.3
-**Last Updated:** February 2026

package/docs/GETTING_STARTED.md

@@ -52,7 +52,7 @@ npm install -g lua-cli
 
 ```bash
 lua --version
-# Output: lua-cli v3.5.0-alpha.3
+# Output: lua-cli vX.Y.Z
 ```
 
 If the command isn't found, ensure npm global bin is in your PATH:
@@ -857,6 +857,3 @@ This demonstrates a production-ready agent architecture!
 **Happy building! 🚀**
 
 ---
-
-**Version:** 3.5.0-alpha.3
-**Last Updated:** February 2026

package/docs/README.md

@@ -1,6 +1,6 @@
 # Lua CLI - Complete API Documentation
 
-Welcome to the comprehensive API documentation for lua-cli v3.5.0-alpha.3. This guide covers every API, class, and function exported by the package.
+Welcome to the comprehensive API documentation for lua-cli v3.6.0. This guide covers every API, class, and function exported by the package.
 
 ## 📚 Documentation Index
 
@@ -245,8 +245,8 @@ Each API doc includes:
 
 ---
 
-**Version:** 3.5.0-alpha.2  
-**Last Updated:** January 2026
+**Version:** 3.5.0
+**Last Updated:** February 2026
 
 ---
 

package/docs/api/LuaAgent.md

@@ -22,22 +22,25 @@ import { LuaAgent } from 'lua-cli';
 interface LuaAgentConfig {
   /** Agent name (used for identification) */
   name: string;
-  
+
   /** Agent persona - defines behavior and personality */
   persona: string;
-  
+
+  /** AI model to use - static string or dynamic resolver function (v3.6.0+) */
+  model?: string | ((request: LuaRequest) => string | Promise<string>);
+
   /** Array of skills (each with tools) */
   skills?: LuaSkill[];
-  
+
   /** Array of webhooks */
   webhooks?: LuaWebhook[];
-  
+
   /** Array of scheduled jobs */
   jobs?: LuaJob[];
-  
+
   /** Array of preprocessors (run before messages reach the agent) */
   preProcessors?: PreProcessor[];
-  
+
   /** Array of postprocessors (run after agent generates responses) */
   postProcessors?: PostProcessor[];
 }
@@ -64,6 +67,26 @@ class LuaAgent {
   - What they can and cannot do
   - Any specific behaviors or rules
 
+### `model` (optional, v3.6.0+)
+- **Type:** `string | ((request: LuaRequest) => string | Promise<string>)`
+- **Description:** AI model to use for this agent. Can be a static string (`'provider/model'`) or a resolver function that dynamically selects the model per request.
+- **Supported providers:** `google/*`, `openai/*`, `anthropic/*`
+- **Default:** Platform default model (currently `google/gemini-2.5-flash`)
+- **Examples:**
+
+```typescript
+// Static model
+model: 'openai/gpt-4o'
+
+// Dynamic resolver — picks model based on channel
+model: async (request) => {
+  if (request.channel === 'whatsapp') return 'openai/gpt-4o-mini';
+  return 'openai/gpt-4o';
+}
+```
+
+The resolver function receives a `LuaRequest` object with channel, message, and context. Runtime APIs (User, Products, Baskets, Orders, Data, AI, Jobs, CDN, Templates) are available implicitly in the sandbox context — use them directly like `await User.get()`.
+
 ### `skills` (optional)
 - **Type:** `LuaSkill[]`
 - **Description:** Array of skills (tool collections) the agent can use

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lua-cli",
-  "version": "3.5.0-beta.1",
+  "version": "3.6.0",
   "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",
@@ -10,15 +10,6 @@
   "exports": {
     ".": "./dist/api-exports.js"
   },
-  "scripts": {
-    "clean": "rm -rf dist",
-    "build:react": "cd src/web && npx tsx build.ts",
-    "build": "npm run clean && npm run build:react && tsc && chmod +x dist/index.js && npm link",
-    "prepublishOnly": "npm run build",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage"
-  },
   "keywords": [
     "lua",
     "ai",
@@ -59,6 +50,7 @@
   ],
   "dependencies": {
     "@tailwindcss/postcss": "^4.1.14",
+    "@tanstack/react-query": "^5.90.11",
     "autoprefixer": "^10.4.21",
     "chalk": "^5.3.0",
     "commander": "^14.0.1",
@@ -67,19 +59,24 @@
     "esbuild": "^0.25.10",
     "inquirer": "^12.9.6",
     "js-yaml": "^4.1.0",
-    "keytar": "^7.9.0",
+    "lua-ai-chat": "^0.0.7",
     "luaniverse": "^4.2.1",
     "node-fetch": "^3.3.2",
     "open": "^10.1.0",
     "postcss": "^8.5.6",
     "postcss-prefixwrap": "^1.57.0",
+    "posthog-node": "^5.26.0",
     "socket.io-client": "^4.7.2",
+    "sonner": "^2.0.7",
     "ts-evaluator": "^2.0.0",
     "ts-morph": "^27.0.0",
     "ws": "^8.18.3",
     "zod": "^3.24.1",
     "zod-to-json-schema": "^3.24.6"
   },
+  "optionalDependencies": {
+    "keytar": "^7.9.0"
+  },
   "devDependencies": {
     "@types/diff": "^7.0.2",
     "@types/inquirer": "^9.0.9",
@@ -99,5 +96,13 @@
     "ts-jest": "^29.1.1",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.2"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build:react": "cd src/web && npx tsx build.ts",
+    "build": "npm run clean && npm run build:react && tsc && chmod +x dist/index.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
   }
-}
+}

package/template/.gitignore

@@ -0,0 +1,21 @@
+# Compiled output
+dist/
+dist-v2/
+*.js
+*.js.map
+
+# Dependencies
+node_modules/
+
+# Environment files
+.env
+.env.local
+
+# IDE files
+.vscode/
+.idea/
+.lua/
+
+# OS files
+.DS_Store
+Thumbs.db

package/template/package.json

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