lua-cli 3.46.0 → 3.47.0

package/docs/README.md

@@ -1,6 +1,6 @@
-# lua-cli v3.46.0
+# lua-cli v3.47.0
 
-Welcome to the comprehensive API documentation for lua-cli v3.43.0. This guide covers every API, class, and function exported by the package.
+Welcome to the comprehensive API documentation for lua-cli v3.47.0. This guide covers every API, class, and function exported by the package.
 
 ## 📚 Documentation Index
 
@@ -263,8 +263,8 @@ Each API doc includes:
 
 ---
 
-**Version:** 3.29.1
-**Last Updated:** August 2026
+**Version:** 3.47.0
+**Last Updated:** October 2026
 
 ---
 

package/docs/api/User.md

@@ -266,7 +266,7 @@ await user.send([
 
 #### `user.clear()`
 
-Clears all user data.
+Clears all user data, including the user's My work list.
 
 **Returns:** `Promise<{ success: boolean }>` - `{ success: true }` once the data is cleared. Throws if the clear fails.
 
@@ -277,6 +277,57 @@ const user = await User.get();
 await user.clear();
 ```
 
+#### `user.setWorkItems(items)`
+
+Publishes this user's **My work** list: the open work an agent lists for them (a ticket they raised or hold, an approval waiting on them). Their client shows it beside the conversation, for example Frontline's "My work" tab. Each call replaces the whole list.
+
+**Parameters:** `items: WorkItem[]`, at most 100.
+
+| Field         | Type             | Notes                                                                   |
+| ------------- | ---------------- | ----------------------------------------------------------------------- |
+| `id`          | `string`         | Unique in the list, ≤ 200 chars (e.g. a ticket number)                  |
+| `title`       | `string`         | One line the user recognises, ≤ 120 chars                               |
+| `group`       | `string`         | Display group you choose, ≤ 40 chars ("Waiting on you", "Your tickets") |
+| `needsAction` | `boolean?`       | The user's own action is needed; listed first and highlighted           |
+| `status`      | `string?`        | Short label, ≤ 40 chars ("In progress")                                 |
+| `updatedAt`   | `string \| Date` | When this work last changed                                             |
+| `action`      | `string`         | Message the client sends when the item is tapped, ≤ 200 chars           |
+
+**Returns:** `Promise<void>`. Throws an error naming the first invalid item before anything is written, or `Failed to set work items` if the write fails.
+
+**Rules:**
+
+- **`action` is a show/open request, never a decision.** Use "Show MNT-00123", not "Approve MNT-00123". A tap must not act on a list that may be minutes old; ask for decisions in the conversation instead.
+- **Publish whenever the work changes, for everyone it affects.** That means the raiser, the assignee and the next approver. Use `User.get({ phone })` or `User.get(userId)` to address each of them.
+- **Add a scheduled job (every ~30 min)** that rebuilds the lists of recently active users. It catches any write that failed.
+- **Leave closed or cancelled work out.** An empty list (`[]`) means "nothing waiting".
+- **The list is kept out of `user.data`.** `update()`, `save()` and `patch()` never write it, so a stale read can't overwrite a newer list. `user.clear()` removes it.
+
+**Example:**
+
+```typescript
+import { User } from 'lua-cli';
+
+// After assigning MNT-00123 to a technician:
+const technician = await User.get({ phone: '+254700000000' });
+await technician?.setWorkItems([
+  {
+    id: 'MNT-00123',
+    title: 'MNT-00123 · Fryer not heating',
+    group: 'Assigned to you',
+    status: 'In progress',
+    updatedAt: new Date(),
+    action: 'Show MNT-00123',
+  },
+]);
+```
+
+#### `user.clearWorkItems()`
+
+Removes this user's My work list. Their client then shows no list from this agent.
+
+**Returns:** `Promise<void>`
+
 #### `user.save()`
 
 Saves current user data state.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lua-cli",
-  "version": "3.46.0",
+  "version": "3.47.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",
@@ -116,9 +116,9 @@
     "tsup": "^8.5.1",
     "@lua/sandbox-runtime": "0.0.1",
     "@lua/shared-sandbox": "0.0.1",
+    "@lua/workflow-graph": "0.0.1",
     "@lua/shared-source-sync": "0.0.1",
-    "@lua/shared-types": "0.0.1",
-    "@lua/workflow-graph": "0.0.1"
+    "@lua/shared-types": "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.46.0",
+    "lua-cli": "^3.47.0",
     "openai": "^5.23.0",
     "uuid": "^13.0.0",
     "zod": "^3.24.1"