lua-cli 3.20.0 → 3.22.0

package/docs/CLI_REFERENCE.md

@@ -587,39 +587,42 @@ $ lua channels list
 
 ## Marketplace
 
-### `lua marketplace`
+### `lua marketplace [noun] [action]`
 
-Access the skills marketplace.
+Browse, install, and manage marketplace skills and agent templates.
 
 **Usage:**
 ```bash
-lua marketplace [options]
+lua marketplace [noun] [action] [options]
 ```
 
 **Description:**
-Interactive marketplace for discovering and installing community skills. Also allows publishing your own skills.
+With no arguments, prompts for a domain — **Skills** or **Agent templates** — then hands off to that domain's own interactive picker. Pass `noun` (`skill` or `template`) to skip straight to a domain, and `action` for non-interactive mode.
 
-**Features:**
-- 🔍 Browse verified skills
-- 📥 Install skills to your agent
-- 📤 Publish your own skills
-- ⭐ View ratings and reviews
+**Skill actions** (`lua marketplace skill <action>`):
+- `list`, `publish`, `edit`, `unlist`, `unpublish`, `mine` — manage your own listings
+- `search`, `view`, `install`, `update`, `uninstall`, `installed` — browse and manage skills on this agent
+
+**Template actions** (`lua marketplace template <action>`):
+- `create`, `publish`, `view`, `versions` — manage a versioned snapshot of an agent's deployable manifest
+- `install`, `apply`, `status`, `installed`, `uninstall` — install onto one agent, or fleet-apply across many
 
 **Example:**
 ```bash
 $ lua marketplace
-? What would you like to do?
-❯ Browse Skills (Installer)
-  Publish Skill (Creator)
+? What would you like to browse?
+❯ Skills
+  Agent templates
 
-? Select category:
-  - E-commerce
-  - Productivity
-  - Data Analysis
-  - Communication
+? What would you like to do?
+❯ Browse & search for skills
+  Install a skill
+  ...
 
-? Install "Advanced Calculator"? Yes
+$ lua marketplace skill install --marketplace-id xyz --version-id v1 --force
 ✅ Skill installed successfully
+
+$ lua marketplace template apply --template-id xyz --all-installed --force
 ```
 
 ---

package/docs/README.md

@@ -1,6 +1,6 @@
-# lua-cli v3.20.0
+# lua-cli v3.22.0
 
-Welcome to the comprehensive API documentation for lua-cli v3.20.0. This guide covers every API, class, and function exported by the package.
+Welcome to the comprehensive API documentation for lua-cli v3.22.0. This guide covers every API, class, and function exported by the package.
 
 ## 📚 Documentation Index
 

package/docs/api/Templates.md

@@ -107,7 +107,7 @@ Sends a template message to one or more phone numbers.
 - `data` (object)
   - `phoneNumbers` (string[]) - Array of phone numbers (E.164 format)
   - `values` (object, optional) - Template variable values
-    - `header` (object) - Header variables (key-value pairs). For media-header templates, pass the media URL instead: `image_url` (IMAGE), `video_url` (VIDEO), or `document_url` + optional `document_filename` (DOCUMENT). URLs must be publicly reachable over HTTPS.
+    - `header` (object) - Header variables (key-value pairs). For media-header templates, pass the media instead, either as a URL — `image_url` (IMAGE), `video_url` (VIDEO), `document_url` + optional `document_filename` (DOCUMENT), all of which must be publicly reachable over HTTPS — or as a Meta media id: `image_id`, `video_id`, `document_id`. An id takes precedence if both are given.
     - `body` (object) - Body variables (key-value pairs)
     - `buttons` (array) - Button values
 
@@ -154,6 +154,29 @@ const response = await Templates.whatsapp.send(
 );
 ```
 
+**Example (media header by Meta media id):**
+```typescript
+// Upload the image to Meta once via POST /{phone-number-id}/media, then reuse the returned
+// media id across every send. WhatsApp skips the per-send URL fetch entirely, which is the
+// cheaper and more reliable option for bulk campaigns.
+//
+// Three constraints: the id must come from POST /{phone-number-id}/media (NOT the Resumable
+// Upload API, whose "h:..." handle is only valid for template creation); it is scoped to the
+// business phone number it was uploaded on, which must be the one behind this channel; and
+// Meta expires media ids after 30 days.
+const response = await Templates.whatsapp.send(
+  'channel_123',
+  'promo_template',
+  {
+    phoneNumbers: ['+1234567890'],
+    values: {
+      header: { image_id: '1234567890123456' },
+      body: { discount: '20%' }
+    }
+  }
+);
+```
+
 ## Template Structure
 
 ### Template Components

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lua-cli",
-  "version": "3.20.0",
+  "version": "3.22.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",
@@ -109,9 +109,9 @@
     "stripe": "^19.2.0",
     "ts-node": "^10.9.2",
     "tsup": "^8.5.1",
-    "@lua/shared-sandbox": "0.0.1",
     "@lua/shared-source-sync": "0.0.1",
-    "@lua/shared-types": "0.0.1"
+    "@lua/shared-types": "0.0.1",
+    "@lua/shared-sandbox": "0.0.1"
   },
   "scripts": {
     "clean": "rm -rf dist temp",

package/template/package.json

@@ -20,7 +20,7 @@
     "inquirer": "^12.9.6",
     "stripe": "^17.5.0",
     "js-yaml": "^4.1.0",
-    "lua-cli": "^3.20.0",
+    "lua-cli": "^3.22.0",
     "openai": "^5.23.0",
     "uuid": "^13.0.0",
     "zod": "^3.24.1"