lua-cli 3.29.1 → 3.30.0

package/dist/api-exports.d.ts

@@ -934,6 +934,31 @@ export declare interface ChannelsApi {
          */
         send(input: EmailSendInput): Promise<ChannelSendOutput>;
     };
+    /**
+     * Read the delivery status of one outbound message.
+     *
+     * Pass the `deliveryId` any send returned. The record moves
+     * `queued -> accepted -> sent -> delivered -> read`, or terminates on
+     * `failed`, and a failure carries a canonical `error.category`, the vendor
+     * code and a remediation link.
+     *
+     * @example
+     * ```typescript
+     * const sent = await Channels.send({ channel: 'whatsapp', to: { phoneNumber: '+15551234567' }, text: 'Hi' });
+     * const delivery = await Channels.getStatus(sent.deliveryId);
+     * if (delivery.status === 'failed') console.error(delivery.error?.category, delivery.error?.title);
+     * ```
+     */
+    getStatus(deliveryId: string): Promise<DeliveryView>;
+    /**
+     * List the agent's recent deliveries, newest first.
+     *
+     * @example
+     * ```typescript
+     * const failures = await Channels.listDeliveries({ status: 'failed', since: '2026-09-01T00:00:00Z', limit: 50 });
+     * ```
+     */
+    listDeliveries(filter?: DeliveryListFilter): Promise<DeliveryView[]>;
 }
 
 export declare type ChannelSendChannel = (typeof CHANNEL_SEND_CHANNELS)[number];
@@ -971,6 +996,18 @@ export declare interface ChannelSendOptions {
  * `warning` — never an error status for a delivered message.
  */
 export declare interface ChannelSendOutput {
+    /** Delivery record id. Stable across the send's whole lifecycle; query it for status. */
+    deliveryId: string;
+    /**
+     * Where the delivery stands the moment the send returns. `queued` means the
+     * WhatsApp window was closed and the text flushes when the user replies.
+     * Receipts move it further (delivered, read, failed) after this call.
+     *
+     * A live send returns `queued`, `accepted` or `sent`. Replaying an
+     * `X-Idempotency-Key` returns wherever the first send's delivery has since
+     * got to, so any status is possible there.
+     */
+    status: DeliveryStatus;
     delivered: boolean;
     /** False for conversation-scoped sends: a shared conversation has no single
      * user to attribute the message to, so nothing is written to agent memory. */
@@ -1543,6 +1580,98 @@ declare interface DeleteProductResponse {
     deleted: boolean;
 }
 
+/** Canonical, cross-vendor failure reason. Vendor codes map onto these. */
+declare const DELIVERY_ERROR_CATEGORIES: readonly ["window_closed", "unreachable", "billing", "opted_out", "throttled", "auth", "template", "media", "invalid_request", "compliance", "experiment", "provider", "unknown"];
+
+declare const DELIVERY_ORIGINS: readonly ["agent_reply", "channels_send", "template", "system_template", "queued_flush", "admin_template", "notification", "unknown"];
+
+declare const DELIVERY_PROVIDERS: readonly ["meta", "vonage", "bird", "ses", "agentmail", "slack", "front", "teams", "pusher"];
+
+/**
+ * Outbound delivery record contracts.
+ *
+ * One outbound message is one delivery document moving through a monotone
+ * status rank with a single terminal failure. Vendor callbacks are normalised
+ * into `ProviderStatusUpdate` by a per-provider mapper, so vendor vocabulary
+ * stops at the mapper and everything downstream speaks these types.
+ */
+declare const DELIVERY_STATUSES: readonly ["queued", "accepted", "sent", "delivered", "read", "failed", "expired"];
+
+export declare interface DeliveryError {
+    category: DeliveryErrorCategory;
+    provider: DeliveryProvider;
+    /** Vendor code as a string. '131042', '1240', 'Permanent/General'. */
+    code: string;
+    title: string;
+    detail?: string;
+    href?: string;
+    retryable: boolean;
+    owner: DeliveryErrorOwner;
+}
+
+export declare type DeliveryErrorCategory = (typeof DELIVERY_ERROR_CATEGORIES)[number];
+
+/** Who has to act on a failure. Drives the operator surface, not retry logic. */
+declare type DeliveryErrorOwner = 'customer' | 'recipient' | 'lua' | 'vendor';
+
+declare type DeliveryEventSource = 'send' | 'callback' | 'sweep';
+
+declare interface DeliveryEventView {
+    status: DeliveryStatus;
+    at: string;
+    source: DeliveryEventSource;
+}
+
+/** Query filter accepted by the delivery list read APIs. */
+export declare interface DeliveryListFilter {
+    userId?: string;
+    status?: DeliveryStatus;
+    channel?: string;
+    /** Only deliveries created at or after this instant. */
+    since?: string | Date;
+    /** 1..200, defaults to 50. */
+    limit?: number;
+}
+
+declare type DeliveryOrigin = (typeof DELIVERY_ORIGINS)[number];
+
+/** Vendor-reported cost metadata. Meta only today. */
+declare interface DeliveryPricing {
+    billable: boolean;
+    category?: string;
+    model?: string;
+}
+
+declare type DeliveryProvider = (typeof DELIVERY_PROVIDERS)[number];
+
+export declare type DeliveryStatus = (typeof DELIVERY_STATUSES)[number];
+
+/** Wire shape of a delivery as returned by read APIs (dates as ISO strings). */
+export declare interface DeliveryView {
+    id: string;
+    agentId: string;
+    userId?: string;
+    /** `ChannelSendChannel | 'rcs' | 'messagebird' | 'slack' | 'front' | 'webchat' | 'sms'`. */
+    channel: string;
+    provider: DeliveryProvider;
+    channelIdentifier: string;
+    recipient: string;
+    providerMessageId?: string;
+    conversationMessageId?: string;
+    origin: DeliveryOrigin;
+    templateName?: string;
+    idempotencyKey?: string;
+    status: DeliveryStatus;
+    error?: DeliveryError;
+    events: DeliveryEventView[];
+    pricing?: DeliveryPricing;
+    createdAt: string;
+    updatedAt: string;
+    deliveredAt?: string;
+    readAt?: string;
+    failedAt?: string;
+}
+
 /** Configuration for a single device command (agent → device) */
 export declare interface DeviceCommandConfig {
     /** Description of what this command does */
@@ -3485,14 +3614,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     }, {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
@@ -3505,13 +3634,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     }, {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     }>]>;
     stt: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"inference">;
@@ -3551,14 +3680,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     }, {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
@@ -3571,13 +3700,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     }, {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     }>]>>;
     tts: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"inference">;
@@ -3617,14 +3746,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     }, {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
@@ -3637,13 +3766,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     }, {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     }>]>>;
     vad: z.ZodOptional<z.ZodString>;
     vadOptions: z.ZodOptional<z.ZodObject<{
@@ -3809,14 +3938,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         kind?: "inference";
         model?: string;
     } | {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     };
     volume?: number;
     llm?: {
@@ -3825,14 +3954,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         kind?: "inference";
         model?: string;
     } | {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     };
     tts?: {
         voice?: string;
@@ -3840,14 +3969,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         kind?: "inference";
         model?: string;
     } | {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     };
     vadOptions?: {
         minSpeechDuration?: number;
@@ -3903,14 +4032,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         kind?: "inference";
         model?: string;
     } | {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     };
     volume?: number;
     llm?: {
@@ -3919,14 +4048,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         kind?: "inference";
         model?: string;
     } | {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     };
     tts?: {
         voice?: string;
@@ -3934,14 +4063,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         kind?: "inference";
         model?: string;
     } | {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     };
     vadOptions?: {
         minSpeechDuration?: number;
@@ -3997,14 +4126,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         kind?: "inference";
         model?: string;
     } | {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     };
     volume?: number;
     llm?: {
@@ -4013,14 +4142,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         kind?: "inference";
         model?: string;
     } | {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     };
     tts?: {
         voice?: string;
@@ -4028,14 +4157,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         kind?: "inference";
         model?: string;
     } | {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     };
     vadOptions?: {
         minSpeechDuration?: number;
@@ -4091,14 +4220,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         kind?: "inference";
         model?: string;
     } | {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     };
     volume?: number;
     llm?: {
@@ -4107,14 +4236,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         kind?: "inference";
         model?: string;
     } | {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     };
     tts?: {
         voice?: string;
@@ -4122,14 +4251,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         kind?: "inference";
         model?: string;
     } | {
+        provider?: "deepgram" | "elevenlabs";
         options?: Record<string, unknown>;
         kind?: "plugin";
-        provider?: "deepgram" | "elevenlabs";
         class?: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
+        provider?: "google" | "xai" | "openai";
         options?: Record<string, unknown>;
         kind?: "realtime";
-        provider?: "google" | "xai" | "openai";
     };
     vadOptions?: {
         minSpeechDuration?: number;

package/dist/api-exports.js

@@ -6560,11 +6560,22 @@ var init_voice_api_service = __esm({
 });
 
 // src/api/channels-send.api.service.ts
+function deliveryQuery(filter) {
+  const params = new URLSearchParams();
+  if (filter?.userId) params.set("userId", filter.userId);
+  if (filter?.status) params.set("status", filter.status);
+  if (filter?.channel) params.set("channel", filter.channel);
+  if (filter?.since) params.set("since", new Date(filter.since).toISOString());
+  if (filter?.limit !== void 0) params.set("limit", String(filter.limit));
+  const query = params.toString();
+  return query ? `?${query}` : "";
+}
 var ChannelsSendApiService;
 var init_channels_send_api_service = __esm({
   "src/api/channels-send.api.service.ts"() {
     "use strict";
     init_http_client();
+    __name(deliveryQuery, "deliveryQuery");
     ChannelsSendApiService = class extends HttpClient {
       static {
         __name(this, "ChannelsSendApiService");
@@ -6636,6 +6647,33 @@ var init_channels_send_api_service = __esm({
         }
         return result.data;
       }
+      /** GET /developer/agents/:agentId/channels/deliveries/:deliveryId */
+      async getDeliveryStatus(deliveryId) {
+        return this.httpGet(`/developer/agents/${this.agentId}/channels/deliveries/${encodeURIComponent(deliveryId)}`);
+      }
+      /** GET /developer/agents/:agentId/channels/deliveries */
+      async listDeliveries(filter) {
+        return this.httpGet(`/developer/agents/${this.agentId}/channels/deliveries${deliveryQuery(filter)}`);
+      }
+      /** Sandbox helper for a single delivery read. */
+      async getDeliveryStatusForSandbox(deliveryId) {
+        const result = await this.getDeliveryStatus(deliveryId);
+        if (!result.success) {
+          throw new Error(result.error?.message || "Delivery status lookup failed");
+        }
+        if (!result.data) {
+          throw new Error("Delivery status lookup failed: empty response");
+        }
+        return result.data;
+      }
+      /** Sandbox helper for the delivery list read. */
+      async listDeliveriesForSandbox(filter) {
+        const result = await this.listDeliveries(filter);
+        if (!result.success) {
+          throw new Error(result.error?.message || "Delivery list failed");
+        }
+        return result.data ?? [];
+      }
     };
   }
 });
@@ -8299,6 +8337,16 @@ var Channels = {
       const channels = await getChannelsSendInstance2();
       return channels.sendEmailForSandbox(input);
     }
+  },
+  async getStatus(deliveryId) {
+    const { getChannelsSendInstance: getChannelsSendInstance2 } = await Promise.resolve().then(() => (init_lazy_instances(), lazy_instances_exports));
+    const channels = await getChannelsSendInstance2();
+    return channels.getDeliveryStatusForSandbox(deliveryId);
+  },
+  async listDeliveries(filter) {
+    const { getChannelsSendInstance: getChannelsSendInstance2 } = await Promise.resolve().then(() => (init_lazy_instances(), lazy_instances_exports));
+    const channels = await getChannelsSendInstance2();
+    return channels.listDeliveriesForSandbox(filter);
   }
 };
 var Team = {