@guidify-ai/vapi-studio 0.1.0

package/dist/forms/forms.service.js

@@ -0,0 +1,434 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormsService = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const event_service_1 = require("../events/event.service");
+const form_types_1 = require("./form.types");
+const form_tokens_1 = require("./form.tokens");
+const noop_form_dispose_adapter_1 = require("./noop-form-dispose.adapter");
+const studio_env_1 = require("../util/studio-env");
+const DEFAULT_ACK_MS = 15_000;
+const DEFAULT_FILLOUT_MS = 10 * 60_000;
+function resolveAckMs() {
+    return (0, studio_env_1.envNumber)('STUDIO_FORM_ACK_MS', undefined, DEFAULT_ACK_MS);
+}
+let FormsService = class FormsService {
+    events;
+    pending = new Map();
+    byConversation = new Map();
+    adapter;
+    constructor(events, adapter) {
+        this.events = events;
+        this.adapter = adapter ?? new noop_form_dispose_adapter_1.NoopFormDisposeAdapter();
+    }
+    /**
+     * Deliver + ACK + onDelivered, then **block** until submit / fillout timeout.
+     * Prefer {@link open} on live Vapi — holding Custom LLM SSE open for minutes
+     * truncates TTS and races silence hangup.
+     */
+    async expose(conversationId, spec) {
+        const entry = await this.beginExpose(conversationId, spec, false);
+        try {
+            const values = await this.waitFillout(entry, spec.filloutTimeoutMs ?? DEFAULT_FILLOUT_MS);
+            await this.events.emit({
+                type: 'FORM_SUBMITTED',
+                conversationId,
+                payload: {
+                    exposeId: entry.exposeId,
+                    formId: entry.formId,
+                    branch: entry.branch ?? null,
+                    deliveryBranch: entry.deliveryBranch,
+                    keys: Object.keys(values),
+                    mode: 'blocking',
+                },
+            });
+            return values;
+        }
+        catch (err) {
+            if (err instanceof form_types_1.FormFilloutTimeoutError) {
+                await this.events.emit({
+                    type: 'FORM_FILLOUT_TIMEOUT',
+                    conversationId,
+                    payload: {
+                        exposeId: entry.exposeId,
+                        formId: entry.formId,
+                        branch: entry.branch ?? null,
+                        deliveryBranch: entry.deliveryBranch,
+                        filloutMs: spec.filloutTimeoutMs ?? DEFAULT_FILLOUT_MS,
+                    },
+                });
+            }
+            throw err;
+        }
+        finally {
+            this.cleanup(entry.exposeId);
+        }
+    }
+    /**
+     * Deliver + ACK + onDelivered, return immediately. Caller finishes the channel
+     * turn (so TTS can complete). Later: {@link submit} then {@link claimSubmitted}.
+     */
+    async open(conversationId, spec) {
+        const entry = await this.beginExpose(conversationId, spec, true);
+        const filloutMs = spec.filloutTimeoutMs ?? DEFAULT_FILLOUT_MS;
+        entry.fillTimer = setTimeout(() => {
+            if (!this.pending.has(entry.exposeId) || entry.values)
+                return;
+            void this.events.emit({
+                type: 'FORM_FILLOUT_TIMEOUT',
+                conversationId,
+                payload: {
+                    exposeId: entry.exposeId,
+                    formId: entry.formId,
+                    branch: entry.branch ?? null,
+                    deliveryBranch: entry.deliveryBranch,
+                    filloutMs,
+                    mode: 'open',
+                },
+            });
+            this.cleanup(entry.exposeId);
+        }, filloutMs);
+        return this.toHandle(entry);
+    }
+    /** Studio / channel ACK — form is openable on the client. */
+    ack(exposeId) {
+        const entry = this.pending.get(exposeId);
+        if (!entry)
+            return null;
+        entry.ackReceived = true;
+        entry.ackResolve?.();
+        entry.ackResolve = undefined;
+        return this.toHandle(entry);
+    }
+    /** Studio / channel submit — resolves blocking expose() or parks values for claim. */
+    submit(exposeId, values) {
+        const entry = this.pending.get(exposeId);
+        if (!entry)
+            return null;
+        const cleaned = {};
+        for (const field of entry.fields) {
+            const raw = values[field.name];
+            cleaned[field.name] = typeof raw === 'string' ? raw.trim() : '';
+            if (field.required && !cleaned[field.name]) {
+                throw new Error(`Missing required field: ${field.name}`);
+            }
+        }
+        entry.values = cleaned;
+        if (entry.fillTimer) {
+            clearTimeout(entry.fillTimer);
+            entry.fillTimer = undefined;
+        }
+        if (entry.fillResolve) {
+            entry.fillResolve(cleaned);
+            entry.fillResolve = undefined;
+            entry.fillReject = undefined;
+        }
+        else {
+            void this.events.emit({
+                type: 'FORM_SUBMITTED',
+                conversationId: entry.conversationId,
+                payload: {
+                    exposeId: entry.exposeId,
+                    formId: entry.formId,
+                    branch: entry.branch ?? null,
+                    deliveryBranch: entry.deliveryBranch,
+                    keys: Object.keys(cleaned),
+                    mode: 'open',
+                },
+            });
+        }
+        return this.toHandle(entry);
+    }
+    /**
+     * Take submitted values for a conversation (open() path) and remove the expose.
+     * Returns null when still waiting or nothing pending.
+     */
+    claimSubmitted(conversationId) {
+        const ids = this.byConversation.get(conversationId);
+        if (!ids)
+            return null;
+        for (const id of [...ids]) {
+            const entry = this.pending.get(id);
+            if (entry?.values) {
+                const values = entry.values;
+                this.cleanup(id);
+                return values;
+            }
+        }
+        return null;
+    }
+    /** True when open() expose has been submitted but not yet claimed. */
+    hasUnclaimedSubmit(conversationId) {
+        const ids = this.byConversation.get(conversationId);
+        if (!ids)
+            return false;
+        for (const id of ids) {
+            const entry = this.pending.get(id);
+            if (entry?.values)
+                return true;
+        }
+        return false;
+    }
+    /** Pending undelivered/unsubmitted expose for Studio poll. */
+    getPending(conversationId) {
+        const ids = this.byConversation.get(conversationId);
+        if (!ids)
+            return null;
+        for (const id of ids) {
+            const entry = this.pending.get(id);
+            if (entry && !entry.values) {
+                return this.toHandle(entry);
+            }
+        }
+        return null;
+    }
+    /**
+     * All open (unsubmitted) exposes — newest first.
+     * Operator / localhost watchers use this when conversationId is unknown.
+     */
+    listPending() {
+        const rows = [];
+        for (const entry of this.pending.values()) {
+            if (!entry.values)
+                rows.push(this.toHandle(entry));
+        }
+        return rows.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    /** Newest open expose, or null. */
+    getLatestPending() {
+        return this.listPending()[0] ?? null;
+    }
+    getByExposeId(exposeId) {
+        const entry = this.pending.get(exposeId);
+        return entry ? this.toHandle(entry) : null;
+    }
+    /**
+     * Re-run dispose for the conversation’s open (unsubmitted) expose — e.g. caller
+     * says they never got the SMS / link. Same exposeId; adapter may text again.
+     */
+    async resend(conversationId) {
+        const pending = this.getPending(conversationId);
+        if (!pending)
+            return null;
+        const entry = this.pending.get(pending.exposeId);
+        if (!entry || entry.values)
+            return null;
+        await this.events.persist(conversationId, 'FORM_RESEND', {
+            exposeId: entry.exposeId,
+            formId: entry.formId,
+            branch: entry.branch ?? null,
+            deliveryBranch: entry.deliveryBranch,
+            adapter: this.adapter.id,
+            disposeContext: entry.disposeContext ?? null,
+        });
+        try {
+            await this.adapter.dispose({
+                exposeId: entry.exposeId,
+                formId: entry.formId,
+                conversationId: entry.conversationId,
+                fields: entry.fields,
+                branch: entry.branch,
+                disposeContext: entry.disposeContext,
+            });
+        }
+        catch (err) {
+            throw err instanceof Error
+                ? err
+                : new form_types_1.FormChannelUnavailableError(String(err));
+        }
+        // Link adapters ACK immediately; keep delivered=true either way.
+        entry.delivered = true;
+        entry.ackReceived = true;
+        await this.events.emit({
+            type: 'FORM_RESENT',
+            conversationId,
+            payload: {
+                exposeId: entry.exposeId,
+                formId: entry.formId,
+                branch: entry.branch ?? null,
+                deliveryBranch: entry.deliveryBranch,
+            },
+        });
+        return this.toHandle(entry);
+    }
+    async beginExpose(conversationId, spec, deferFillout) {
+        if (!conversationId) {
+            throw new Error('forms.expose requires conversationId');
+        }
+        if (!spec.fields?.length) {
+            throw new Error('forms.expose requires at least one field');
+        }
+        const exposeId = (0, crypto_1.randomUUID)();
+        const createdAt = new Date().toISOString();
+        const conversationBranch = spec.branch?.trim() || undefined;
+        const deliveryBranch = this.adapter.branch;
+        const entry = {
+            exposeId,
+            formId: spec.formId,
+            conversationId,
+            fields: spec.fields,
+            branch: conversationBranch,
+            deliveryBranch,
+            createdAt,
+            delivered: false,
+            ackReceived: false,
+            deferFillout,
+            disposeContext: spec.disposeContext,
+        };
+        this.pending.set(exposeId, entry);
+        const set = this.byConversation.get(conversationId) ?? new Set();
+        set.add(exposeId);
+        this.byConversation.set(conversationId, set);
+        await this.events.persist(conversationId, 'FORM_SENDOUT', {
+            exposeId,
+            formId: spec.formId,
+            branch: conversationBranch ?? null,
+            deliveryBranch,
+            adapter: this.adapter.id,
+            fields: spec.fields.map((f) => f.name),
+            disposeContext: spec.disposeContext ?? null,
+            deferFillout,
+        });
+        await this.events.emit({
+            type: 'FORM_EXPOSE',
+            conversationId,
+            payload: {
+                exposeId,
+                formId: spec.formId,
+                branch: conversationBranch ?? null,
+                deliveryBranch,
+                fields: spec.fields.map((f) => f.name),
+                adapter: this.adapter.id,
+                disposeContext: spec.disposeContext ?? null,
+                deferFillout,
+            },
+        });
+        try {
+            await this.adapter.dispose({
+                exposeId,
+                formId: spec.formId,
+                conversationId,
+                fields: spec.fields,
+                branch: conversationBranch,
+                disposeContext: spec.disposeContext,
+            });
+        }
+        catch (err) {
+            this.cleanup(exposeId);
+            throw err instanceof Error
+                ? err
+                : new form_types_1.FormChannelUnavailableError(String(err));
+        }
+        const ackWindowMs = resolveAckMs();
+        const ackOk = await this.waitAck(entry, ackWindowMs);
+        if (!ackOk) {
+            await this.events.emit({
+                type: 'FORM_DELIVER_TIMEOUT',
+                conversationId,
+                payload: {
+                    exposeId,
+                    formId: spec.formId,
+                    branch: conversationBranch ?? null,
+                    deliveryBranch,
+                    ackMs: ackWindowMs,
+                },
+            });
+            this.cleanup(exposeId);
+            throw new form_types_1.FormDeliverTimeoutError(exposeId, conversationId);
+        }
+        entry.delivered = true;
+        await this.events.emit({
+            type: 'FORM_DELIVERED',
+            conversationId,
+            payload: {
+                exposeId,
+                formId: spec.formId,
+                branch: conversationBranch ?? null,
+                deliveryBranch,
+            },
+        });
+        if (spec.onDelivered) {
+            await spec.onDelivered();
+        }
+        return entry;
+    }
+    toHandle(entry) {
+        return {
+            exposeId: entry.exposeId,
+            formId: entry.formId,
+            conversationId: entry.conversationId,
+            fields: entry.fields,
+            createdAt: entry.createdAt,
+            branch: entry.branch,
+            deliveryBranch: entry.deliveryBranch,
+        };
+    }
+    waitAck(entry, ms) {
+        if (entry.ackReceived)
+            return Promise.resolve(true);
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                entry.ackResolve = undefined;
+                resolve(false);
+            }, ms);
+            entry.ackResolve = () => {
+                clearTimeout(timer);
+                resolve(true);
+            };
+        });
+    }
+    waitFillout(entry, ms) {
+        if (entry.values)
+            return Promise.resolve(entry.values);
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                entry.fillResolve = undefined;
+                entry.fillReject = undefined;
+                reject(new form_types_1.FormFilloutTimeoutError(entry.exposeId, entry.conversationId));
+            }, ms);
+            entry.fillResolve = (values) => {
+                clearTimeout(timer);
+                resolve(values);
+            };
+            entry.fillReject = (err) => {
+                clearTimeout(timer);
+                reject(err);
+            };
+        });
+    }
+    cleanup(exposeId) {
+        const entry = this.pending.get(exposeId);
+        if (!entry)
+            return;
+        if (entry.fillTimer)
+            clearTimeout(entry.fillTimer);
+        this.pending.delete(exposeId);
+        const set = this.byConversation.get(entry.conversationId);
+        if (set) {
+            set.delete(exposeId);
+            if (!set.size)
+                this.byConversation.delete(entry.conversationId);
+        }
+    }
+};
+exports.FormsService = FormsService;
+exports.FormsService = FormsService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Inject)(form_tokens_1.FORM_DISPOSE_ADAPTER)),
+    __metadata("design:paramtypes", [event_service_1.EventService, Object])
+], FormsService);
+//# sourceMappingURL=forms.service.js.map

package/dist/forms/forms.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.service.js","sourceRoot":"","sources":["../../src/forms/forms.service.ts"],"names":[],"mappings":"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"}

package/dist/forms/noop-form-dispose.adapter.d.ts

@@ -0,0 +1,12 @@
+import type { FormDisposeAdapter, FormDisposePayload } from './form.types';
+/**
+ * Default dispose — phone / unknown channels cannot show a Studio modal.
+ * FormsService treats dispose failure / missing ACK as deliver timeout so
+ * Nodes can fall back to voice collection.
+ */
+export declare class NoopFormDisposeAdapter implements FormDisposeAdapter {
+    readonly id: "noop";
+    readonly branch: "unavailable";
+    dispose(_payload: FormDisposePayload): Promise<void>;
+}
+//# sourceMappingURL=noop-form-dispose.adapter.d.ts.map

package/dist/forms/noop-form-dispose.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-form-dispose.adapter.d.ts","sourceRoot":"","sources":["../../src/forms/noop-form-dispose.adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAEtB;;;;GAIG;AACH,qBACa,sBAAuB,YAAW,kBAAkB;IAC/D,SAAgB,EAAE,EAAE,MAAM,CAAU;IACpC,SAAgB,MAAM,EAAE,aAAa,CAAiB;IAEzC,OAAO,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlE"}

package/dist/forms/noop-form-dispose.adapter.js

@@ -0,0 +1,27 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoopFormDisposeAdapter = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Default dispose — phone / unknown channels cannot show a Studio modal.
+ * FormsService treats dispose failure / missing ACK as deliver timeout so
+ * Nodes can fall back to voice collection.
+ */
+let NoopFormDisposeAdapter = class NoopFormDisposeAdapter {
+    id = 'noop';
+    branch = 'unavailable';
+    async dispose(_payload) {
+        // Intentionally no-op: nothing to show; ACK will never arrive.
+    }
+};
+exports.NoopFormDisposeAdapter = NoopFormDisposeAdapter;
+exports.NoopFormDisposeAdapter = NoopFormDisposeAdapter = __decorate([
+    (0, common_1.Injectable)()
+], NoopFormDisposeAdapter);
+//# sourceMappingURL=noop-form-dispose.adapter.js.map

package/dist/forms/noop-form-dispose.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-form-dispose.adapter.js","sourceRoot":"","sources":["../../src/forms/noop-form-dispose.adapter.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAM5C;;;;GAIG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjB,EAAE,GAAW,MAAM,CAAC;IACpB,MAAM,GAAkB,aAAa,CAAC;IAE/C,KAAK,CAAC,OAAO,CAAC,QAA4B;QAC/C,+DAA+D;IACjE,CAAC;CACF,CAAA;AAPY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;GACA,sBAAsB,CAOlC"}

package/dist/forms/twilio-sms-form-dispose.adapter.d.ts

@@ -0,0 +1,33 @@
+import { EventService } from '../events/event.service';
+import { FormsService } from './forms.service';
+import type { FormDisposeAdapter, FormDisposePayload } from './form.types';
+import { type TwilioSmsSender } from './twilio-sms.sender';
+/**
+ * Form sendout driver — texts a form URL via Twilio.
+ *
+ * Env (reserved): `TWILIO_ACCOUNT_SID`, `TWILIO_AUTH_TOKEN`,
+ * `TWILIO_FROM_NUMBER` or `TWILIO_MESSAGING_SERVICE_SID`,
+ * `TWILIO_SMS_DRY_RUN` (default **on** — prepare mode, no live API).
+ *
+ * On success (dry-run or live) emits `OUTBOUND_NOTIFICATION` via EventService
+ * → listeners / app exporters (`onStudioEvent`).
+ *
+ * Wire: `VapiStudioModule.forRoot({ formDisposeAdapter: TwilioSmsFormDisposeAdapter })`.
+ * Install peer `twilio` only when leaving dry-run for live sends.
+ * `disposeContext.contactPhone` required; `formUrl` optional (falls back to
+ * `{PUBLIC_BASE_URL}/forms/{exposeId}`).
+ */
+export declare class TwilioSmsFormDisposeAdapter implements FormDisposeAdapter {
+    private readonly events?;
+    private readonly forms?;
+    /** Test double — when omitted, sender is built from env each dispose. */
+    private readonly senderOverride?;
+    readonly id: "twilio-sms";
+    readonly branch: "sms";
+    constructor(events?: EventService | undefined, forms?: FormsService | undefined, 
+    /** Test double — when omitted, sender is built from env each dispose. */
+    senderOverride?: TwilioSmsSender | undefined);
+    dispose(payload: FormDisposePayload): Promise<void>;
+    private persistOutboundError;
+}
+//# sourceMappingURL=twilio-sms-form-dispose.adapter.d.ts.map

package/dist/forms/twilio-sms-form-dispose.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilio-sms-form-dispose.adapter.d.ts","sourceRoot":"","sources":["../../src/forms/twilio-sms-form-dispose.adapter.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAQtB,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;GAcG;AACH,qBACa,2BAA4B,YAAW,kBAAkB;IAKtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAGpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACvB,yEAAyE;IAC7D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAT9C,SAAgB,EAAE,EAAE,YAAY,CAAgB;IAChD,SAAgB,MAAM,EAAE,KAAK,CAAS;gBAGP,MAAM,CAAC,EAAE,YAAY,YAAA,EAGjC,KAAK,CAAC,EAAE,YAAY,YAAA;IACrC,yEAAyE;IAC5C,cAAc,CAAC,EAAE,eAAe,YAAA;IAGlD,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;YAgElD,oBAAoB;CAuBnC"}

package/dist/forms/twilio-sms-form-dispose.adapter.js

@@ -0,0 +1,125 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TwilioSmsFormDisposeAdapter = void 0;
+const common_1 = require("@nestjs/common");
+const event_service_1 = require("../events/event.service");
+const studio_event_1 = require("../events/studio-event");
+const forms_service_1 = require("./forms.service");
+const form_types_1 = require("./form.types");
+const twilio_sms_env_1 = require("./twilio-sms.env");
+const twilio_sms_sender_1 = require("./twilio-sms.sender");
+/**
+ * Form sendout driver — texts a form URL via Twilio.
+ *
+ * Env (reserved): `TWILIO_ACCOUNT_SID`, `TWILIO_AUTH_TOKEN`,
+ * `TWILIO_FROM_NUMBER` or `TWILIO_MESSAGING_SERVICE_SID`,
+ * `TWILIO_SMS_DRY_RUN` (default **on** — prepare mode, no live API).
+ *
+ * On success (dry-run or live) emits `OUTBOUND_NOTIFICATION` via EventService
+ * → listeners / app exporters (`onStudioEvent`).
+ *
+ * Wire: `VapiStudioModule.forRoot({ formDisposeAdapter: TwilioSmsFormDisposeAdapter })`.
+ * Install peer `twilio` only when leaving dry-run for live sends.
+ * `disposeContext.contactPhone` required; `formUrl` optional (falls back to
+ * `{PUBLIC_BASE_URL}/forms/{exposeId}`).
+ */
+let TwilioSmsFormDisposeAdapter = class TwilioSmsFormDisposeAdapter {
+    events;
+    forms;
+    senderOverride;
+    id = 'twilio-sms';
+    branch = 'sms';
+    constructor(events, forms, senderOverride) {
+        this.events = events;
+        this.forms = forms;
+        this.senderOverride = senderOverride;
+    }
+    async dispose(payload) {
+        const resolved = (0, twilio_sms_env_1.resolveTwilioSmsConfig)();
+        if (!resolved.ok && !resolved.config.dryRun) {
+            await this.persistOutboundError(payload, resolved.reason);
+            throw new form_types_1.FormChannelUnavailableError(resolved.reason);
+        }
+        const to = (0, twilio_sms_env_1.pickSmsDestination)(payload.disposeContext);
+        if (!to) {
+            const reason = 'Twilio SMS dispose needs disposeContext.contactPhone (E.164 or 10-digit NA)';
+            await this.persistOutboundError(payload, reason);
+            throw new form_types_1.FormChannelUnavailableError(reason);
+        }
+        const formUrl = (0, twilio_sms_env_1.resolveSmsFormUrl)(payload.disposeContext, payload.exposeId);
+        if (!formUrl) {
+            const reason = 'Twilio SMS dispose needs disposeContext.formUrl or PUBLIC_BASE_URL (for /forms/{exposeId})';
+            await this.persistOutboundError(payload, reason);
+            throw new form_types_1.FormChannelUnavailableError(reason);
+        }
+        const body = (0, twilio_sms_env_1.resolveSmsBody)(payload.disposeContext, formUrl);
+        const sender = this.senderOverride ?? (0, twilio_sms_sender_1.createTwilioSmsSender)(resolved.config);
+        let result;
+        try {
+            result = await sender.send({ to, body });
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            await this.persistOutboundError(payload, reason, { to, body });
+            throw err instanceof Error
+                ? err
+                : new form_types_1.FormChannelUnavailableError(reason);
+        }
+        // Produce → listeners / onStudioEvent exporters.
+        await this.events?.persist(payload.conversationId, studio_event_1.STUDIO_EVENTS.OUTBOUND_NOTIFICATION, {
+            channel: 'sms',
+            provider: 'twilio',
+            status: result.dryRun ? 'dry_run' : 'sent',
+            exposeId: payload.exposeId,
+            formId: payload.formId,
+            branch: payload.branch ?? null,
+            deliveryBranch: this.branch,
+            adapter: this.id,
+            to: result.to,
+            body: result.body,
+            sid: result.sid,
+            dryRun: result.dryRun,
+        });
+        // Delivery accepted — ACK so FormsService can emit FORM_DELIVERED.
+        this.forms?.ack(payload.exposeId);
+    }
+    async persistOutboundError(payload, reason, extra = {}) {
+        if (!this.events || !payload.conversationId)
+            return;
+        await this.events.persist(payload.conversationId, studio_event_1.STUDIO_EVENTS.OUTBOUND_NOTIFICATION_ERROR, {
+            channel: 'sms',
+            provider: 'twilio',
+            status: 'error',
+            exposeId: payload.exposeId,
+            formId: payload.formId,
+            branch: payload.branch ?? null,
+            deliveryBranch: this.branch,
+            adapter: this.id,
+            reason,
+            ...extra,
+        });
+    }
+};
+exports.TwilioSmsFormDisposeAdapter = TwilioSmsFormDisposeAdapter;
+exports.TwilioSmsFormDisposeAdapter = TwilioSmsFormDisposeAdapter = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Inject)((0, common_1.forwardRef)(() => forms_service_1.FormsService))),
+    __param(2, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [event_service_1.EventService,
+        forms_service_1.FormsService, Object])
+], TwilioSmsFormDisposeAdapter);
+//# sourceMappingURL=twilio-sms-form-dispose.adapter.js.map