lua-cli 3.17.4 → 3.18.0

package/dist/voice/test/index.d.ts

@@ -157,6 +157,7 @@ declare class LuaVoice {
     readonly preemptiveGeneration: LuaVoiceConfig['preemptiveGeneration'];
     readonly interruption: LuaVoiceConfig['interruption'];
     readonly sttLanguage: LuaVoiceConfig['sttLanguage'];
+    readonly excludeTools: LuaVoiceConfig['excludeTools'];
     readonly tools: ReadonlyArray<LuaTool<any> | LuaVoiceTool<any>>;
     readonly onEnter?: LuaVoiceConfig_2['onEnter'];
     readonly onUserTurnCompleted?: LuaVoiceConfig_2['onUserTurnCompleted'];
@@ -557,6 +558,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     pronunciations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     persistTranscript: z.ZodOptional<z.ZodBoolean>;
     onToolFailureSay: z.ZodOptional<z.ZodString>;
+    excludeTools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     vad?: string;
     stt?: {
@@ -650,6 +652,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
     onToolFailureSay?: string;
+    excludeTools?: string[];
 }, {
     vad?: string;
     stt?: {
@@ -743,6 +746,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
     onToolFailureSay?: string;
+    excludeTools?: string[];
 }>, {
     vad?: string;
     stt?: {
@@ -836,6 +840,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
     onToolFailureSay?: string;
+    excludeTools?: string[];
 }, {
     vad?: string;
     stt?: {
@@ -929,6 +934,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
     onToolFailureSay?: string;
+    excludeTools?: string[];
 }>;
 
 /**
@@ -1002,10 +1008,10 @@ declare interface LuaVoiceToolConfig<TInput extends ZodType = ZodType> {
  * its second `execute` arg whether it runs over chat or voice; this
  * extension just adds the Phase-5 fields (currently optional + experimental).
  *
- * `say()` is wired today and delegates to the active LiveKit `voice.AgentSession`.
- * `disallowInterruptions()` and `handoff()` are optional placeholders for
- * Phase 5 (BAC-213, the LuaVoice handoffs + test framework ticket).
- * Marked optional both because they aren't implemented yet AND so this
+ * `say()`, `transferToHuman()`, `endCall()` and `handoff()` are wired today
+ * and delegate to the active LiveKit `voice.AgentSession`.
+ * `disallowInterruptions()` is an optional placeholder — the barge-in lock
+ * plumbing isn't implemented yet. The delegates are marked optional so this
  * type stays structurally compatible with `LuaToolCtx` — that
  * compatibility is what lets a `LuaVoiceTool` (which extends `LuaTool`)
  * present `(ctx?: LuaVoiceToolCtx)` while satisfying the parent's
@@ -1067,9 +1073,24 @@ declare interface LuaVoiceToolCtx {
          */
         disallowInterruptions?(): void;
         /**
-         * @experimental Reserved for Phase 5 (BAC-213). Optional because
-         * unimplemented — handoffs require `chatCtx.copy(exclude_instructions=True)`
-         * + `update_agent` plumbing that's part of the multi-LuaVoice flow ticket.
+         * Hand the live call to another LuaVoice on the same agent,
+         * addressed by its `name`. The caller stays in the same room; only
+         * the agent identity flips — the receiving voice starts cold from
+         * its own persona + greeting (no conversation history carries
+         * over). Pass `context` to surface a structured payload to the
+         * receiving voice on its first turn.
+         *
+         * In `lua voice test`, register reachable voices via
+         * `runVoice({ handoffTargets })`; in production, any voice pushed
+         * on the same agent is reachable. An unknown name degrades
+         * in-call (spoken fallback, no crash).
+         *
+         * @example
+         * ```typescript
+         * await ctx.voice?.handoff('billing-line', {
+         *   context: { reason: 'invoice question', orderId: input.orderId },
+         * });
+         * ```
          */
         handoff?(otherVoiceName: string, opts?: {
             context?: Record<string, unknown>;

package/dist/zod-runtime.mjs

@@ -3832,7 +3832,7 @@ ZodNaN.create = (params) => {
     ...processCreateParams(params)
   });
 };
-var BRAND = Symbol("zod_brand");
+var BRAND = /* @__PURE__ */ Symbol("zod_brand");
 var ZodBranded = class extends ZodType {
   _parse(input) {
     const { ctx } = this._processInputParams(input);
@@ -4046,7 +4046,7 @@ var coerce = {
 var NEVER = INVALID;
 
 // ../../node_modules/.pnpm/zod-to-json-schema@3.25.1_zod@3.25.76/node_modules/zod-to-json-schema/dist/esm/Options.js
-var ignoreOverride = Symbol("Let zodToJsonSchema decide on which parser to use");
+var ignoreOverride = /* @__PURE__ */ Symbol("Let zodToJsonSchema decide on which parser to use");
 var defaultOptions = {
   name: void 0,
   $refStrategy: "root",

package/docs/API_REFERENCE.md

@@ -36,6 +36,7 @@ import { User, Products, Data, Jobs, AI } from 'lua-cli';
 - [AI API](#ai-api) - AI text generation
 - [Templates API](#templates-api) - WhatsApp templates
 - [CDN API](#cdn-api) - File upload/download
+- [Channels API](#channels-api) - Outbound channel sends
 
 ### Utilities
 - [env()](#env) - Environment variables
@@ -71,7 +72,8 @@ import {
 
   // Utilities
   env,
-  Lua
+  Lua,
+  Channels,
 } from 'lua-cli';
 ```
 
@@ -584,6 +586,51 @@ const url = await CDN.get(result.fileId);
 
 ---
 
+### Channels API
+
+Send outbound messages over any supported channel (WhatsApp, SMS, email, webchat, and more)
+from inside a job, webhook, or skill tool.
+
+A successful send with a memory write failure returns `{ delivered: true, persisted: false, warning: '...' }` —
+this is HTTP 200 and is never thrown as an error.
+
+**Methods:**
+- `Channels.send(input)` - Send a text message on any channel
+- `Channels.whatsapp.sendTemplate(input)` - Send a WhatsApp Business template
+- `Channels.email.send(input)` - Send an email
+
+**Examples:**
+```typescript
+import { Channels } from 'lua-cli';
+
+// Send a text message over WhatsApp
+await Channels.send({
+  channel: 'whatsapp',
+  to: { phoneNumber: '+15551234567' },
+  text: 'Your order has shipped!',
+});
+
+// Send a WhatsApp Business template
+await Channels.whatsapp.sendTemplate({
+  to: { phoneNumber: '+447551166594' },
+  templateName: 'order_update',
+  languageCode: 'en',
+  components: [{ type: 'body', parameters: [{ type: 'text', text: 'ORD-99' }] }],
+});
+
+// Send an email
+const result = await Channels.email.send({
+  to: { email: 'alice@example.com' },
+  subject: 'Your order is ready',
+  html: '<p>Hello, Alice!</p>',
+});
+if (!result.persisted) {
+  console.warn('Delivered but not stored in memory:', result.warning);
+}
+```
+
+---
+
 ## Utilities
 
 ### env()

package/docs/README.md

@@ -1,4 +1,4 @@
-# lua-cli v3.16.2
+# lua-cli v3.18.0
 
 Welcome to the comprehensive API documentation for lua-cli v3.16.2. This guide covers every API, class, and function exported by the package.
 

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)
+    - `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.
     - `body` (object) - Body variables (key-value pairs)
     - `buttons` (array) - Button values
 
@@ -137,6 +137,23 @@ console.log(`Sent ${response.totalProcessed} messages`);
 console.log(`Errors: ${response.totalErrors}`);
 ```
 
+**Example (media header):**
+```typescript
+// Template approved with an IMAGE header — pass the image to display via image_url.
+// VIDEO headers take video_url; DOCUMENT headers take document_url (+ optional document_filename).
+const response = await Templates.whatsapp.send(
+  'channel_123',
+  'promo_template',
+  {
+    phoneNumbers: ['+1234567890'],
+    values: {
+      header: { image_url: 'https://example.com/promo.jpg' },
+      body: { discount: '20%' }
+    }
+  }
+);
+```
+
 ## Template Structure
 
 ### Template Components
@@ -153,8 +170,9 @@ interface WhatsAppTemplate {
   components: [
     {
       type: 'HEADER';
-      format: 'TEXT';
-      text: string;
+      // TEXT headers carry `text`; media headers (IMAGE/VIDEO/DOCUMENT) have no text
+      format: 'TEXT' | 'IMAGE' | 'VIDEO' | 'DOCUMENT';
+      text?: string;
     },
     {
       type: 'BODY';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lua-cli",
-  "version": "3.17.4",
+  "version": "3.18.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",
@@ -80,7 +80,7 @@
     "commander": "^14.0.1",
     "diff": "^8.0.2",
     "dotenv": "^17.2.3",
-    "esbuild": "^0.25.10",
+    "esbuild": "^0.28.1",
     "inquirer": "^12.9.6",
     "js-yaml": "^4.1.0",
     "open": "^10.1.0",

package/template/package.json

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