lua-cli 3.17.6 → 3.20.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'];
@@ -265,11 +266,11 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     }, {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     }>]>;
     stt: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"inference">;
@@ -331,11 +332,11 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     }, {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     }>]>>;
     tts: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"inference">;
@@ -397,11 +398,11 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     }, {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     }>]>>;
     vad: z.ZodOptional<z.ZodString>;
     vadOptions: z.ZodOptional<z.ZodObject<{
@@ -434,28 +435,28 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         maxDelay: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         enabled?: boolean;
-        mode?: "vad" | "adaptive";
+        mode?: "adaptive" | "vad";
         falseInterruptionTimeout?: number;
         resumeFalseInterruption?: boolean;
         minDelay?: number;
         maxDelay?: number;
     }, {
         enabled?: boolean;
-        mode?: "vad" | "adaptive";
+        mode?: "adaptive" | "vad";
         falseInterruptionTimeout?: number;
         resumeFalseInterruption?: boolean;
         minDelay?: number;
         maxDelay?: number;
     }>, {
         enabled?: boolean;
-        mode?: "vad" | "adaptive";
+        mode?: "adaptive" | "vad";
         falseInterruptionTimeout?: number;
         resumeFalseInterruption?: boolean;
         minDelay?: number;
         maxDelay?: number;
     }, {
         enabled?: boolean;
-        mode?: "vad" | "adaptive";
+        mode?: "adaptive" | "vad";
         falseInterruptionTimeout?: number;
         resumeFalseInterruption?: boolean;
         minDelay?: number;
@@ -557,7 +558,9 @@ 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, {
+    name?: string;
     vad?: string;
     stt?: {
         voice?: string;
@@ -572,10 +575,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     };
     volume?: number;
-    name?: string;
     llm?: {
         voice?: string;
         options?: Record<string, unknown>;
@@ -589,7 +591,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     };
     tts?: {
         voice?: string;
@@ -604,7 +606,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     };
     vadOptions?: {
         minSpeechDuration?: number;
@@ -619,7 +621,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     preemptiveGeneration?: boolean;
     interruption?: {
         enabled?: boolean;
-        mode?: "vad" | "adaptive";
+        mode?: "adaptive" | "vad";
         falseInterruptionTimeout?: number;
         resumeFalseInterruption?: boolean;
         minDelay?: number;
@@ -650,7 +652,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
     onToolFailureSay?: string;
+    excludeTools?: string[];
 }, {
+    name?: string;
     vad?: string;
     stt?: {
         voice?: string;
@@ -665,10 +669,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     };
     volume?: number;
-    name?: string;
     llm?: {
         voice?: string;
         options?: Record<string, unknown>;
@@ -682,7 +685,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     };
     tts?: {
         voice?: string;
@@ -697,7 +700,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     };
     vadOptions?: {
         minSpeechDuration?: number;
@@ -712,7 +715,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     preemptiveGeneration?: boolean;
     interruption?: {
         enabled?: boolean;
-        mode?: "vad" | "adaptive";
+        mode?: "adaptive" | "vad";
         falseInterruptionTimeout?: number;
         resumeFalseInterruption?: boolean;
         minDelay?: number;
@@ -743,7 +746,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
     onToolFailureSay?: string;
+    excludeTools?: string[];
 }>, {
+    name?: string;
     vad?: string;
     stt?: {
         voice?: string;
@@ -758,10 +763,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     };
     volume?: number;
-    name?: string;
     llm?: {
         voice?: string;
         options?: Record<string, unknown>;
@@ -775,7 +779,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     };
     tts?: {
         voice?: string;
@@ -790,7 +794,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     };
     vadOptions?: {
         minSpeechDuration?: number;
@@ -805,7 +809,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     preemptiveGeneration?: boolean;
     interruption?: {
         enabled?: boolean;
-        mode?: "vad" | "adaptive";
+        mode?: "adaptive" | "vad";
         falseInterruptionTimeout?: number;
         resumeFalseInterruption?: boolean;
         minDelay?: number;
@@ -836,7 +840,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
     onToolFailureSay?: string;
+    excludeTools?: string[];
 }, {
+    name?: string;
     vad?: string;
     stt?: {
         voice?: string;
@@ -851,10 +857,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     };
     volume?: number;
-    name?: string;
     llm?: {
         voice?: string;
         options?: Record<string, unknown>;
@@ -868,7 +873,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     };
     tts?: {
         voice?: string;
@@ -883,7 +888,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "openai" | "google" | "xai";
+        provider?: "google" | "xai" | "openai";
     };
     vadOptions?: {
         minSpeechDuration?: number;
@@ -898,7 +903,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     preemptiveGeneration?: boolean;
     interruption?: {
         enabled?: boolean;
-        mode?: "vad" | "adaptive";
+        mode?: "adaptive" | "vad";
         falseInterruptionTimeout?: number;
         resumeFalseInterruption?: boolean;
         minDelay?: number;
@@ -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,6 +1,6 @@
-# lua-cli v3.16.2
+# lua-cli v3.20.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.
+Welcome to the comprehensive API documentation for lua-cli v3.20.0. This guide covers every API, class, and function exported by the package.
 
 ## 📚 Documentation Index
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lua-cli",
-  "version": "3.17.6",
+  "version": "3.20.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.6",
+    "lua-cli": "^3.20.0",
     "openai": "^5.23.0",
     "uuid": "^13.0.0",
     "zod": "^3.24.1"