lua-cli 3.46.0 → 3.47.0

package/dist/api-exports.d.ts

@@ -1884,10 +1884,37 @@ export declare enum BasketStatus {
  * Overrides platform-wide env var defaults for this specific agent.
  */
 export declare interface BatchingConfig {
-    /** Hold first message N ms before processing, to allow rapid follow-ups to batch together. 0 = disabled. */
+    /**
+     * Fixed hold applied to the first message of a turn before processing, so rapid
+     * follow-ups can join it. 0 = disabled.
+     *
+     * This is a tax on EVERY turn, including single-message ones: `10000` delays every
+     * reply by 10s whether or not the user sends a second message. Keep it small
+     * (a few hundred ms to ~2s) unless your users routinely send bursts.
+     */
     firstMessageDelayMs?: number;
-    /** Window to collect subsequent messages while one is in-flight (ms). 0 = batching disabled. */
+    /**
+     * Quiet period (ms) that collects subsequent messages while one is in-flight. 0 = batching disabled.
+     *
+     * The window SLIDES: every new message in the batch restarts it, so the reply goes out
+     * `debounceWindowMs` after the user's LAST message. `30000` means a user who keeps typing
+     * waits 30s after their final message. Larger values batch long bursts better but add
+     * latency; pair a large value with `maxWaitMs` to bound the wait.
+     */
     debounceWindowMs?: number;
+    /**
+     * Hard cap (ms) on how long a sliding debounce batch can be held, measured from batch
+     * creation (the arrival of the message that formed the batch, not from the
+     * `firstMessageDelayMs` hold). The batch fires on the quiet period OR this cap, whichever
+     * comes first, so a continuous stream of messages cannot postpone the reply indefinitely.
+     *
+     * Optional; absent or 0 = no cap (the window slides until `maxBatchMessages` or silence).
+     * If smaller than `debounceWindowMs`, the cap still applies from batch creation.
+     * Per-agent only, no platform-wide default. Bounds the debounce wait only; the serialize-mode
+     * wait for an in-flight turn is not covered. Measure the effect with
+     * `lua_chat_stage_duration_seconds{stage="batch_wait"}`.
+     */
+    maxWaitMs?: number;
     /** Maximum messages collected in a single batch. */
     maxBatchMessages?: number;
     /**
@@ -5945,13 +5972,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     }, {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"plugin">;
         provider: z.ZodEnum<["deepgram", "elevenlabs"]>;
@@ -5965,14 +5992,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     }, {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -5985,12 +6012,12 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     }, {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     }>]>;
     stt: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"inference">;
@@ -6011,13 +6038,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     }, {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"plugin">;
         provider: z.ZodEnum<["deepgram", "elevenlabs"]>;
@@ -6031,14 +6058,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     }, {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -6051,12 +6078,12 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     }, {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     }>]>>;
     tts: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"inference">;
@@ -6077,13 +6104,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     }, {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"plugin">;
         provider: z.ZodEnum<["deepgram", "elevenlabs"]>;
@@ -6097,14 +6124,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     }, {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -6117,12 +6144,12 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     }, {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     }>]>>;
     vad: z.ZodOptional<z.ZodString>;
     vadOptions: z.ZodOptional<z.ZodObject<{
@@ -6283,50 +6310,50 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     llm: {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     } | {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     } | {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     } | undefined;
     volume?: number | undefined;
     tts?: {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     } | {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -6377,50 +6404,50 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     llm: {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     } | {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     } | {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     } | undefined;
     volume?: number | undefined;
     tts?: {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     } | {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -6471,50 +6498,50 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     llm: {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     } | {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     } | {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     } | undefined;
     volume?: number | undefined;
     tts?: {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     } | {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -6565,50 +6592,50 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     llm: {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     } | {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     } | {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     } | undefined;
     volume?: number | undefined;
     tts?: {
         kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
         kind: "plugin";
-        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
         class: "LLM" | "STT" | "STTv2" | "TTS";
+        options: Record<string, unknown>;
     } | {
         kind: "realtime";
-        options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        options: Record<string, unknown>;
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -9827,6 +9854,10 @@ declare interface UserDataAPI {
         set?: Record<string, any>;
         unset?: string[];
     }): Promise<any>;
+    /** Publishes the user's My work list (LUA-1028), replacing the previous one. */
+    setWorkItems(items: WorkItem[]): Promise<any>;
+    /** Removes the user's My work list. */
+    clearWorkItems(): Promise<any>;
     /**
      * Clears user data.
      * @returns Promise resolving when data is cleared
@@ -9883,7 +9914,23 @@ export declare class UserDataInstance {
     }): Promise<any>;
     unset(...fields: string[]): Promise<any>;
     /**
-     * Clears all user data for the current user
+     * Publishes this user's My work list (LUA-1028): the open work they see in Frontline's "My work",
+     * replacing the previous list. Publish whenever the work changes, for everyone it affects.
+     * @param items - At most 100 items; each `action` is the message sent when the user taps it
+     * @throws Error naming the first invalid item (nothing is sent), or if the write fails
+     *
+     * @example
+     * 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' },
+     * ]);
+     */
+    setWorkItems(items: WorkItem[]): Promise<void>;
+    /** Removes this user's My work list. */
+    clearWorkItems(): Promise<void>;
+    /**
+     * Clears all user data for the current user (the My work list included)
      * @returns Promise resolving to `{ success: true }` if clearing was successful
      * @throws Error if the clear operation fails
      */
@@ -11267,6 +11314,27 @@ declare type WorkflowTier = (typeof WORKFLOW_TIERS)[number];
 
 export declare type WorkflowWorkspaceBackend = 'ebs' | 'efs' | 's3';
 
+/** One item as an agent publishes it. */
+export declare interface WorkItem {
+    /** Stable id within the list (e.g. a ticket number). */
+    id: string;
+    /** One line the user recognises, e.g. "MNT-00123 · Fryer not heating". */
+    title: string;
+    /** Display group chosen by the agent, e.g. "Waiting on you", "Your tickets". */
+    group: string;
+    /** The user's own action is needed (a fix to confirm, an approval to give); listed first. */
+    needsAction?: boolean;
+    /** Short status label, e.g. "In progress". */
+    status?: string;
+    /** When the work last changed. */
+    updatedAt: string | Date;
+    /**
+     * The message the user's client sends when the item is tapped. A show/open request
+     * ("Show MNT-00123"), never a decision: decisions are made in the conversation.
+     */
+    action: string;
+}
+
 export declare type WorkspaceSpec = {
     kind: 'git';
     repo: string | TemplateBinding;