lua-cli 3.54.0 → 3.55.0

package/docs/README.md

@@ -1,6 +1,6 @@
-# lua-cli v3.54.0
+# lua-cli v3.55.0
 
-Welcome to the comprehensive API documentation for lua-cli v3.54.0. This guide covers every API, class, and function exported by the package.
+Welcome to the comprehensive API documentation for lua-cli v3.55.0. This guide covers every API, class, and function exported by the package.
 
 ## 📚 Documentation Index
 
@@ -263,7 +263,7 @@ Each API doc includes:
 
 ---
 
-**Version:** 3.54.0
+**Version:** 3.55.0
 **Last Updated:** October 2026
 
 ---

package/docs/api/Data.md

@@ -93,7 +93,7 @@ for (const movie of results) {
 }
 ```
 
-### `Data.create(collectionName, data, searchText?)`
+### `Data.create(collectionName, data, searchTextOrOptions?)`
 
 Creates a new entry in a collection.
 
@@ -101,7 +101,14 @@ Creates a new entry in a collection.
 
 - `collectionName` (string) - Collection name
 - `data` (object) - Data to store
-- `searchText` (string, optional) - Text to use for vector search indexing
+- `searchTextOrOptions` (string or `{ searchText?, index? }`, optional) - A bare string is the text to use for
+  vector search indexing. The options object adds `index`: the `data` fields you filter on, as a path
+  (`'business_id'`) or a compound of up to 2 paths (`['country', 'business_id']`); at most 3 per call and 5 built
+  per agent (per shared collection on `Data.shared`). The platform builds each index within minutes, reports it in
+  `collections()`, and drops it 14 days after the last declaration or filtered read. The same in `lua test`,
+  deployed agents (skills, jobs, webhooks, workflow steps other than `tier: 'job'`, which have no `Data`) and voice
+  hooks. `Data.update` (4th argument),
+  `Data.patch` (`mutation.index`), `entry.update` and `entry.save` accept it too.
 
 **Returns:** `Promise<DataEntryInstance>`
 
@@ -309,6 +316,14 @@ const names = await map.collections();
   can only ever reach its own organization's shared collections.
 - **Audit.** Every write records the agent, the collection and the entry id (never the value) in the
   organization's audit log.
+- **Managed indexes.** A writer declares them like on `Data`, on its writes:
+  `map.create('api_endpoints', row, { index: [['repoKey', 'service']] })` (also `update`, `patch`, `entry.update`).
+  The index belongs to the shared collection, not to the agent that declared it: at most 5 are built across all its
+  sub-collections (`'per-shared-collection cap (5) reached'` beyond that), they serve every reader's filtered `get`,
+  and they are dropped 14 days after the last declaration or filtered read by any agent. `collections()` reports
+  each one's status (`pending`, `building`, `ready`, `failed`, `rejected`) to readers and writers. Readers cannot
+  declare (they cannot write). Declare compound indexes so their first field serves the single-field filters too:
+  `[repoKey, service]` already serves a filter on `repoKey` alone in the same sub-collection.
 - **Test sessions** may read a shared collection but not write it (`shared_data_test_session_write_refused`, 409).
 - **Local runs** (`lua test`) have no org ACL to consult: every call rejects with
   `code === 'shared_data_unavailable_offline'`.
@@ -370,7 +385,7 @@ A change applies to the next `Data.shared` call. Re-creating a deleted name star
 
 Data entries have convenient methods:
 
-### `entry.update(data, searchText?)`
+### `entry.update(data, searchTextOrOptions?)`
 
 Updates this entry.
 
@@ -401,7 +416,7 @@ if (oldMovie) {
 }
 ```
 
-### `entry.save(searchText?)`
+### `entry.save(searchTextOrOptions?)`
 
 Saves modifications to this entry.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lua-cli",
-  "version": "3.54.0",
+  "version": "3.55.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",
@@ -114,6 +114,7 @@
     "stripe": "^19.2.0",
     "ts-node": "^10.9.2",
     "tsup": "^8.5.1",
+    "tsx": "4.21.0",
     "@lua/sandbox-runtime": "0.0.1",
     "@lua/shared-sandbox": "0.0.1",
     "@lua/shared-source-sync": "0.0.1",

package/template/package.json

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

package/template-web-app/web/package.json

@@ -8,9 +8,8 @@
   },
   "dependencies": {
     "@base-ui/react": "~1.8.0",
-    "@lua-ai-global/app-chat": "~0.0.1",
-    "@lua-ai-global/app-client": "~0.0.3",
-    "@lua-ai-global/ui": "~0.2.3",
+    "@lua-ai-global/app-client": "~0.1.0",
+    "@lua-ai-global/ui": "~0.3.0",
     "@phosphor-icons/react": "~2.1.10",
     "react": "~19.3.0",
     "react-dom": "~19.3.0"

package/template-web-app/web/src/index.css

@@ -1,5 +1,3 @@
 @import '@lua-ai-global/ui/styles.css';
-/* The agent pane's styles: after the design system's, on its tokens. */
-@import '@lua-ai-global/app-chat/styles.css';
 /* Tailwind scans the design system's compiled components for the classes they use. */
 @source '../node_modules/@lua-ai-global/ui/dist';

package/template-web-app/web/src/main.tsx

@@ -2,19 +2,11 @@ import { StrictMode } from 'react';
 import { createRoot } from 'react-dom/client';
 import { App } from './App';
 import { lua } from '@lua-ai-global/app-client';
-import { AgentPaneLayout } from '@lua-ai-global/app-chat';
 import './index.css';
 
-// Theme follows the shell: first from the bootstrap, then from the host's `init`.
-document.documentElement.classList.toggle('dark', lua.theme === 'dark');
-lua.onInit((init) => document.documentElement.classList.toggle('dark', init.theme === 'dark'));
-
 createRoot(document.getElementById('root')!).render(
   <StrictMode>
-    {/* The agent pane: the person's own conversation with this app's agent, docked beside the page. */}
-    <AgentPaneLayout>
-      <App />
-    </AgentPaneLayout>
+    <App />
   </StrictMode>
 );
 void lua.start();