@guidify-ai/vapi-studio 0.1.0

package/dist/flow/flow-loader.js

@@ -0,0 +1,182 @@
+"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.FlowLoader = exports.CONDITION_GOTO_PREFIX = void 0;
+exports.conditionGotoIntention = conditionGotoIntention;
+exports.parseConditionGotoNodeId = parseConditionGotoNodeId;
+const fs_1 = require("fs");
+const common_1 = require("@nestjs/common");
+const yaml_1 = require("yaml");
+const conversation_history_1 = require("../conversation/conversation-history");
+const condition_1 = require("./condition");
+/** Synthetic intention → execute a node by id (condition transitions / goto). */
+exports.CONDITION_GOTO_PREFIX = 'studio.goto.';
+function conditionGotoIntention(nodeId) {
+    return `${exports.CONDITION_GOTO_PREFIX}${nodeId}`;
+}
+function parseConditionGotoNodeId(intention) {
+    if (!intention.startsWith(exports.CONDITION_GOTO_PREFIX))
+        return null;
+    const id = intention.slice(exports.CONDITION_GOTO_PREFIX.length);
+    return id.length > 0 ? id : null;
+}
+let FlowLoader = class FlowLoader {
+    flow = null;
+    loadFromFile(path) {
+        const raw = (0, yaml_1.parse)((0, fs_1.readFileSync)(path, 'utf8'));
+        return this.loadFromObject(raw);
+    }
+    loadFromObject(raw) {
+        if (!raw?.flow?.id || !raw?.flow?.start || !raw?.nodes) {
+            throw new Error('Invalid flow schema object');
+        }
+        const nodes = {};
+        for (const [id, def] of Object.entries(raw.nodes)) {
+            nodes[id] = {
+                id,
+                class: def.class,
+                intentions: def.intentions ?? [],
+                portal: def.portal,
+                priority: def.priority,
+                terminal: def.terminal,
+            };
+        }
+        if (!nodes[raw.flow.start]) {
+            throw new Error(`Flow start node "${raw.flow.start}" missing`);
+        }
+        const transitions = [];
+        for (const [index, rawT] of (raw.transitions ?? []).entries()) {
+            const id = (rawT.id ?? `transition_${index}`).trim();
+            const to = String(rawT.to ?? '').trim();
+            if (!to || !nodes[to]) {
+                throw new Error(`Flow transition "${id}" targets unknown node "${to}"`);
+            }
+            const when = String(rawT.when ?? '').trim();
+            if (!when) {
+                throw new Error(`Flow transition "${id}" is missing when`);
+            }
+            let test;
+            try {
+                test = (0, condition_1.compileCondition)(when);
+            }
+            catch (error) {
+                throw new Error(`Flow transition "${id}" has invalid when "${when}": ${error instanceof Error ? error.message : String(error)}`);
+            }
+            const fromList = rawT.from
+                ? (Array.isArray(rawT.from) ? rawT.from : [rawT.from]).map((s) => String(s).trim())
+                : undefined;
+            if (fromList) {
+                for (const fromId of fromList) {
+                    if (!nodes[fromId]) {
+                        throw new Error(`Flow transition "${id}" from unknown node "${fromId}"`);
+                    }
+                }
+            }
+            transitions.push({
+                id,
+                from: fromList,
+                to,
+                when,
+                force: rawT.force === true,
+                priority: rawT.priority,
+                reason: rawT.reason,
+                test,
+            });
+        }
+        this.flow = {
+            version: raw.version ?? 1,
+            id: raw.flow.id,
+            start: raw.flow.start,
+            nodes,
+            transitions,
+        };
+        return this.flow;
+    }
+    getFlow() {
+        if (!this.flow) {
+            throw new Error('Flow not loaded');
+        }
+        return this.flow;
+    }
+    nodesForIntention(intention) {
+        const flow = this.getFlow();
+        const gotoId = parseConditionGotoNodeId(intention);
+        if (gotoId) {
+            const node = flow.nodes[gotoId];
+            return node ? [node] : [];
+        }
+        const matches = Object.values(flow.nodes).filter((n) => n.intentions.includes(intention));
+        return matches.sort((a, b) => {
+            const pa = a.priority ?? conversation_history_1.DEFAULT_INTENTION_PRIORITY;
+            const pb = b.priority ?? conversation_history_1.DEFAULT_INTENTION_PRIORITY;
+            if (pb !== pa)
+                return pb - pa;
+            return a.id.localeCompare(b.id);
+        });
+    }
+    /** All intention names declared on portal nodes. */
+    portalIntentionNames() {
+        const flow = this.getFlow();
+        const names = new Set();
+        for (const node of Object.values(flow.nodes)) {
+            if (!node.portal)
+                continue;
+            for (const name of node.intentions) {
+                names.add(name);
+            }
+        }
+        return [...names];
+    }
+    /** All intention names on non-portal nodes. */
+    normalIntentionNames() {
+        const flow = this.getFlow();
+        const names = new Set();
+        for (const node of Object.values(flow.nodes)) {
+            if (node.portal)
+                continue;
+            for (const name of node.intentions) {
+                names.add(name);
+            }
+        }
+        return [...names];
+    }
+    /**
+     * Condition transitions whose `when` is true for this runtime snapshot.
+     * Skips when current node is already `to`, or `from` does not include current.
+     */
+    matchingConditionTransitions(input, opts) {
+        const flow = this.getFlow();
+        const current = input.currentNodeId ?? null;
+        const ctx = {
+            memory: input.memory,
+            variables: input.variables,
+        };
+        const out = [];
+        for (const t of flow.transitions) {
+            if (opts?.force === true && t.force !== true)
+                continue;
+            if (opts?.force === false && t.force === true)
+                continue;
+            if (current === t.to)
+                continue;
+            if (t.from && t.from.length > 0) {
+                if (!current || !t.from.includes(current))
+                    continue;
+            }
+            if (!t.test(ctx))
+                continue;
+            out.push(t);
+        }
+        return out;
+    }
+};
+exports.FlowLoader = FlowLoader;
+exports.FlowLoader = FlowLoader = __decorate([
+    (0, common_1.Injectable)()
+], FlowLoader);
+//# sourceMappingURL=flow-loader.js.map

package/dist/flow/flow-loader.js.map

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

package/dist/forms/form-html.d.ts

@@ -0,0 +1,30 @@
+/**
+ * First-party HTML form renderer — builds a simple page from FormFieldSpec JSON.
+ * Apps serve this from GET /forms/:exposeId; submit posts back to FormsService.
+ */
+import type { FormExposeHandle } from './form.types';
+export interface RenderFormHtmlOptions {
+    /** Absolute or relative form POST action (default: same expose path). */
+    action?: string;
+    title?: string;
+    subtitle?: string;
+    submitLabel?: string;
+    /** Optional error banner (e.g. missing required field). */
+    error?: string;
+}
+/**
+ * Render a complete HTML document for a pending form expose.
+ * Field definitions come from the expose handle (JSON → HTML).
+ */
+export declare function renderFormHtml(handle: Pick<FormExposeHandle, 'exposeId' | 'formId' | 'fields'>, options?: RenderFormHtmlOptions): string;
+/** Thank-you page after successful submit. */
+export declare function renderFormThanksHtml(options?: {
+    title?: string;
+    body?: string;
+    /** Optional absolute or relative href shown under the body. */
+    backHref?: string;
+    backLabel?: string;
+}): string;
+/** Simple not-found / expired page. */
+export declare function renderFormGoneHtml(message?: string): string;
+//# sourceMappingURL=form-html.d.ts.map

package/dist/forms/form-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-html.d.ts","sourceRoot":"","sources":["../../src/forms/form-html.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,cAAc,CAAC;AAEpE,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAmCD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC,EAChE,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAmDR;AAED,8CAA8C;AAC9C,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAgCT;AAED,uCAAuC;AACvC,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ3D"}

package/dist/forms/form-html.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * First-party HTML form renderer — builds a simple page from FormFieldSpec JSON.
+ * Apps serve this from GET /forms/:exposeId; submit posts back to FormsService.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderFormHtml = renderFormHtml;
+exports.renderFormThanksHtml = renderFormThanksHtml;
+exports.renderFormGoneHtml = renderFormGoneHtml;
+function escapeHtml(raw) {
+    return raw
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+function inputType(field) {
+    switch (field.type) {
+        case 'email':
+            return 'email';
+        case 'tel':
+            return 'tel';
+        default:
+            return 'text';
+    }
+}
+function renderField(field) {
+    const req = field.required ? ' required' : '';
+    const ph = field.placeholder
+        ? ` placeholder="${escapeHtml(field.placeholder)}"`
+        : '';
+    const name = escapeHtml(field.name);
+    const label = escapeHtml(field.label);
+    if (field.type === 'textarea') {
+        return `<label class="field"><span>${label}</span><textarea name="${name}" rows="3"${req}${ph}></textarea></label>`;
+    }
+    return `<label class="field"><span>${label}</span><input type="${inputType(field)}" name="${name}" autocomplete="on"${req}${ph} /></label>`;
+}
+/**
+ * Render a complete HTML document for a pending form expose.
+ * Field definitions come from the expose handle (JSON → HTML).
+ */
+function renderFormHtml(handle, options = {}) {
+    const action = escapeHtml(options.action !== undefined ? options.action : '');
+    const title = escapeHtml(options.title ?? 'Your details');
+    const subtitle = escapeHtml(options.subtitle ?? 'Fill this out and submit — we are waiting on the line.');
+    const submitLabel = escapeHtml(options.submitLabel ?? 'Submit');
+    const error = options.error
+        ? `<p class="error" role="alert">${escapeHtml(options.error)}</p>`
+        : '';
+    const fields = handle.fields.map(renderField).join('\n');
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>${title}</title>
+  <style>
+    :root { color-scheme: light; --ink: #14213d; --muted: #5c6b7a; --line: #d7dde5; --accent: #1b6ef3; --bg: #f4f6f8; }
+    * { box-sizing: border-box; }
+    body { margin: 0; font-family: ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, Helvetica, Arial, sans-serif; background: var(--bg); color: var(--ink); }
+    main { max-width: 28rem; margin: 0 auto; padding: 1.5rem 1.25rem 3rem; }
+    h1 { font-size: 1.35rem; margin: 0 0 0.35rem; }
+    .sub { color: var(--muted); margin: 0 0 1.25rem; line-height: 1.4; font-size: 0.95rem; }
+    form { display: grid; gap: 0.9rem; background: #fff; border: 1px solid var(--line); border-radius: 12px; padding: 1.1rem; }
+    .field { display: grid; gap: 0.35rem; font-size: 0.9rem; }
+    .field span { font-weight: 600; }
+    input, textarea { width: 100%; font: inherit; padding: 0.65rem 0.7rem; border: 1px solid var(--line); border-radius: 8px; background: #fff; }
+    input:focus, textarea:focus { outline: 2px solid color-mix(in srgb, var(--accent) 45%, white); border-color: var(--accent); }
+    button { font: inherit; font-weight: 600; border: 0; border-radius: 999px; padding: 0.75rem 1rem; background: var(--accent); color: #fff; cursor: pointer; }
+    button:hover { filter: brightness(0.96); }
+    .error { background: #fde8e8; color: #8a1f1f; border-radius: 8px; padding: 0.65rem 0.75rem; margin: 0 0 0.75rem; }
+    .meta { margin-top: 1rem; color: var(--muted); font-size: 0.75rem; }
+  </style>
+</head>
+<body>
+  <main>
+    <h1>${title}</h1>
+    <p class="sub">${subtitle}</p>
+    ${error}
+    <form method="post" action="${action}" novalidate>
+      ${fields}
+      <button type="submit">${submitLabel}</button>
+    </form>
+    <p class="meta">Form ${handle.formId} · ${escapeHtml(handle.exposeId.slice(0, 8))}…</p>
+  </main>
+</body>
+</html>`;
+}
+/** Thank-you page after successful submit. */
+function renderFormThanksHtml(options) {
+    const title = escapeHtml(options?.title ?? 'Thanks');
+    const body = escapeHtml(options?.body ??
+        'We received your details. You can return to the call — we are still on the line.');
+    const back = options?.backHref != null
+        ? `<p><a href="${escapeHtml(options.backHref)}">${escapeHtml(options.backLabel ?? 'Back')}</a></p>`
+        : '';
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>${title}</title>
+  <style>
+    body { margin: 0; font-family: ui-sans-serif, system-ui, sans-serif; background: #f4f6f8; color: #14213d; }
+    main { max-width: 28rem; margin: 0 auto; padding: 2rem 1.25rem; }
+    h1 { font-size: 1.35rem; margin: 0 0 0.5rem; }
+    p { color: #5c6b7a; line-height: 1.45; }
+    a { color: #1b6ef3; }
+  </style>
+</head>
+<body>
+  <main>
+    <h1>${title}</h1>
+    <p>${body}</p>
+    ${back}
+  </main>
+</body>
+</html>`;
+}
+/** Simple not-found / expired page. */
+function renderFormGoneHtml(message) {
+    const body = escapeHtml(message ?? 'This form link is missing or has already been completed.');
+    return `<!DOCTYPE html>
+<html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>Form unavailable</title>
+<style>body{font-family:ui-sans-serif,system-ui,sans-serif;padding:2rem;color:#14213d;background:#f4f6f8}p{color:#5c6b7a}</style>
+</head><body><h1>Form unavailable</h1><p>${body}</p></body></html>`;
+}
+//# sourceMappingURL=form-html.js.map

package/dist/forms/form-html.js.map

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

package/dist/forms/form.tokens.d.ts

@@ -0,0 +1,3 @@
+/** Injection token for the channel FormDisposeAdapter (Studio, Formsster, …). */
+export declare const FORM_DISPOSE_ADAPTER: unique symbol;
+//# sourceMappingURL=form.tokens.d.ts.map

package/dist/forms/form.tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.tokens.d.ts","sourceRoot":"","sources":["../../src/forms/form.tokens.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,eAAiC,CAAC"}

package/dist/forms/form.tokens.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FORM_DISPOSE_ADAPTER = void 0;
+/** Injection token for the channel FormDisposeAdapter (Studio, Formsster, …). */
+exports.FORM_DISPOSE_ADAPTER = Symbol('FORM_DISPOSE_ADAPTER');
+//# sourceMappingURL=form.tokens.js.map

package/dist/forms/form.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.tokens.js","sourceRoot":"","sources":["../../src/forms/form.tokens.ts"],"names":[],"mappings":";;;AAAA,iFAAiF;AACpE,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC"}

package/dist/forms/form.types.d.ts

@@ -0,0 +1,81 @@
+export type FormFieldType = 'string' | 'email' | 'tel' | 'textarea';
+export interface FormFieldSpec {
+    name: string;
+    label: string;
+    type: FormFieldType;
+    required?: boolean;
+    placeholder?: string;
+}
+export interface FormExposeSpec {
+    /** App-defined form template id. */
+    formId: number;
+    fields: FormFieldSpec[];
+    /**
+     * Conversation branch this sendout belongs to (app-owned id for forensics /
+     * flow edges). Emitted on `FORM_SENDOUT` before delivery wait.
+     * Example: `identity_html_form`, `appointment_intake`.
+     */
+    branch?: string;
+    /** Called after the channel ACKs delivery (≤15s). Use to speak “form exposed, waiting”. */
+    onDelivered?: () => Promise<void>;
+    /** Fillout wait (ms). Default 10 minutes. */
+    filloutTimeoutMs?: number;
+    /**
+     * Optional channel hints for the dispose adapter (e.g. contactPhone, channel).
+     * Opaque to the framework — apps/adapters interpret it.
+     */
+    disposeContext?: Record<string, unknown>;
+}
+export type FormValues = Record<string, string>;
+export interface FormExposeHandle {
+    exposeId: string;
+    formId: number;
+    conversationId: string;
+    fields: FormFieldSpec[];
+    createdAt: string;
+    /** App conversation branch from the expose spec, if any. */
+    branch?: string;
+    /** Delivery branch reported by the dispose adapter. */
+    deliveryBranch?: string;
+}
+export interface FormDisposePayload {
+    exposeId: string;
+    formId: number;
+    conversationId: string;
+    fields: FormFieldSpec[];
+    /** App conversation branch from FormExposeSpec.branch. */
+    branch?: string;
+    disposeContext?: Record<string, unknown>;
+}
+/**
+ * Channel-specific dispose (Studio modal, first-party HTML link, SMS later).
+ * Must make the form visible to the caller; ACK is separate via FormsService.ack
+ * (or the adapter may ACK once the link is ready / page is openable).
+ *
+ * `branch` is the **delivery** path this driver implements (html_link / sms / …).
+ * It is stamped on `FORM_SENDOUT` early so logs show which sendout lane ran
+ * before ACK / fillout.
+ */
+export interface FormDisposeAdapter {
+    readonly id: string;
+    /** Delivery branch id this driver owns (e.g. `html_link`, `sms`, `unavailable`). */
+    readonly branch: string;
+    dispose(payload: FormDisposePayload): Promise<void>;
+}
+export declare class FormDeliverTimeoutError extends Error {
+    readonly exposeId: string;
+    readonly conversationId: string;
+    readonly code: "FORM_DELIVER_TIMEOUT";
+    constructor(exposeId: string, conversationId: string);
+}
+export declare class FormFilloutTimeoutError extends Error {
+    readonly exposeId: string;
+    readonly conversationId: string;
+    readonly code: "FORM_FILLOUT_TIMEOUT";
+    constructor(exposeId: string, conversationId: string);
+}
+export declare class FormChannelUnavailableError extends Error {
+    readonly code: "FORM_CHANNEL_UNAVAILABLE";
+    constructor(message?: string);
+}
+//# sourceMappingURL=form.types.d.ts.map

package/dist/forms/form.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.types.d.ts","sourceRoot":"","sources":["../../src/forms/form.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,qBAAa,uBAAwB,SAAQ,KAAK;aAG9B,QAAQ,EAAE,MAAM;aAChB,cAAc,EAAE,MAAM;IAHxC,SAAgB,IAAI,EAAE,sBAAsB,CAAmC;gBAE7D,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM;CAOzC;AAED,qBAAa,uBAAwB,SAAQ,KAAK;aAG9B,QAAQ,EAAE,MAAM;aAChB,cAAc,EAAE,MAAM;IAHxC,SAAgB,IAAI,EAAE,sBAAsB,CAAmC;gBAE7D,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM;CAKzC;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,SAAgB,IAAI,EAAE,0BAA0B,CAAuC;gBACpE,OAAO,SAAwD;CAInF"}

package/dist/forms/form.types.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormChannelUnavailableError = exports.FormFilloutTimeoutError = exports.FormDeliverTimeoutError = void 0;
+class FormDeliverTimeoutError extends Error {
+    exposeId;
+    conversationId;
+    code = 'FORM_DELIVER_TIMEOUT';
+    constructor(exposeId, conversationId) {
+        super(`Form expose ${exposeId} was not acknowledged within the delivery window`);
+        this.exposeId = exposeId;
+        this.conversationId = conversationId;
+        this.name = 'FormDeliverTimeoutError';
+    }
+}
+exports.FormDeliverTimeoutError = FormDeliverTimeoutError;
+class FormFilloutTimeoutError extends Error {
+    exposeId;
+    conversationId;
+    code = 'FORM_FILLOUT_TIMEOUT';
+    constructor(exposeId, conversationId) {
+        super(`Form expose ${exposeId} fillout timed out`);
+        this.exposeId = exposeId;
+        this.conversationId = conversationId;
+        this.name = 'FormFilloutTimeoutError';
+    }
+}
+exports.FormFilloutTimeoutError = FormFilloutTimeoutError;
+class FormChannelUnavailableError extends Error {
+    code = 'FORM_CHANNEL_UNAVAILABLE';
+    constructor(message = 'No form dispose adapter can deliver on this channel') {
+        super(message);
+        this.name = 'FormChannelUnavailableError';
+    }
+}
+exports.FormChannelUnavailableError = FormChannelUnavailableError;
+//# sourceMappingURL=form.types.js.map

package/dist/forms/form.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.types.js","sourceRoot":"","sources":["../../src/forms/form.types.ts"],"names":[],"mappings":";;;AAuEA,MAAa,uBAAwB,SAAQ,KAAK;IAG9B;IACA;IAHF,IAAI,GAA2B,sBAA+B,CAAC;IAC/E,YACkB,QAAgB,EAChB,cAAsB;QAEtC,KAAK,CACH,eAAe,QAAQ,kDAAkD,CAC1E,CAAC;QALc,aAAQ,GAAR,QAAQ,CAAQ;QAChB,mBAAc,GAAd,cAAc,CAAQ;QAKtC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAXD,0DAWC;AAED,MAAa,uBAAwB,SAAQ,KAAK;IAG9B;IACA;IAHF,IAAI,GAA2B,sBAA+B,CAAC;IAC/E,YACkB,QAAgB,EAChB,cAAsB;QAEtC,KAAK,CAAC,eAAe,QAAQ,oBAAoB,CAAC,CAAC;QAHnC,aAAQ,GAAR,QAAQ,CAAQ;QAChB,mBAAc,GAAd,cAAc,CAAQ;QAGtC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AATD,0DASC;AAED,MAAa,2BAA4B,SAAQ,KAAK;IACpC,IAAI,GAA+B,0BAAmC,CAAC;IACvF,YAAmB,OAAO,GAAG,qDAAqD;QAChF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAND,kEAMC"}

package/dist/forms/forms.service.d.ts

@@ -0,0 +1,52 @@
+import { EventService } from '../events/event.service';
+import { type FormDisposeAdapter, type FormExposeHandle, type FormExposeSpec, type FormValues } from './form.types';
+export declare class FormsService {
+    private readonly events;
+    private readonly pending;
+    private readonly byConversation;
+    private readonly adapter;
+    constructor(events: EventService, adapter?: FormDisposeAdapter);
+    /**
+     * 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.
+     */
+    expose(conversationId: string, spec: FormExposeSpec): Promise<FormValues>;
+    /**
+     * Deliver + ACK + onDelivered, return immediately. Caller finishes the channel
+     * turn (so TTS can complete). Later: {@link submit} then {@link claimSubmitted}.
+     */
+    open(conversationId: string, spec: FormExposeSpec): Promise<FormExposeHandle>;
+    /** Studio / channel ACK — form is openable on the client. */
+    ack(exposeId: string): FormExposeHandle | null;
+    /** Studio / channel submit — resolves blocking expose() or parks values for claim. */
+    submit(exposeId: string, values: FormValues): FormExposeHandle | null;
+    /**
+     * Take submitted values for a conversation (open() path) and remove the expose.
+     * Returns null when still waiting or nothing pending.
+     */
+    claimSubmitted(conversationId: string): FormValues | null;
+    /** True when open() expose has been submitted but not yet claimed. */
+    hasUnclaimedSubmit(conversationId: string): boolean;
+    /** Pending undelivered/unsubmitted expose for Studio poll. */
+    getPending(conversationId: string): FormExposeHandle | null;
+    /**
+     * All open (unsubmitted) exposes — newest first.
+     * Operator / localhost watchers use this when conversationId is unknown.
+     */
+    listPending(): FormExposeHandle[];
+    /** Newest open expose, or null. */
+    getLatestPending(): FormExposeHandle | null;
+    getByExposeId(exposeId: string): FormExposeHandle | 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.
+     */
+    resend(conversationId: string): Promise<FormExposeHandle | null>;
+    private beginExpose;
+    private toHandle;
+    private waitAck;
+    private waitFillout;
+    private cleanup;
+}
+//# sourceMappingURL=forms.service.d.ts.map

package/dist/forms/forms.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.service.d.ts","sourceRoot":"","sources":["../../src/forms/forms.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAkCtB,qBACa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgE;IACxF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4D;IAC3F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAG1B,MAAM,EAAE,YAAY,EAGrC,OAAO,CAAC,EAAE,kBAAkB;IAK9B;;;;OAIG;IACU,MAAM,CACjB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,UAAU,CAAC;IAwCtB;;;OAGG;IACU,IAAI,CACf,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC;IAsB5B,6DAA6D;IACtD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IASrD,sFAAsF;IAC/E,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,gBAAgB,GAAG,IAAI;IAqC5E;;;OAGG;IACI,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAchE,sEAAsE;IAC/D,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAU1D,8DAA8D;IACvD,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAYlE;;;OAGG;IACI,WAAW,IAAI,gBAAgB,EAAE;IAQxC,mCAAmC;IAC5B,gBAAgB,IAAI,gBAAgB,GAAG,IAAI;IAI3C,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAK/D;;;OAGG;IACU,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;YA8C/D,WAAW;IAiHzB,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,OAAO;CAWhB"}