supafone-labs 0.3.0 → 0.3.2

package/dist/index.js

@@ -9,9 +9,9 @@
  *
  * Works in Node 18+ (native fetch/WebSocket) and the browser.
  *
- *   npm i @supafonesupafone-labs
+ *   npm i supafone-labs
  *
- *   import { Supafone } from "@supafonesupafone-labs";
+ *   import { Supafone } from "supafone-labs";
  *   const supafone = new Supafone({ apiKey: process.env.SUPAFONE_API_KEY! });
  *   const agent = await supafone.labs.agents.createInboundWithNumber({
  *     agentKey: "northline-intake",
@@ -98,7 +98,7 @@ export class SupafoneLabs {
             clearTimeout(timer);
         }
     }
-    /** @internal Authenticated JSON request to the Supafone app API (`/api/v1supafone-labs/*`). */
+    /** @internal Authenticated JSON request to the Supafone app API (`/api/v1/labs/*`). */
     async requestSupafoneApi(method, path, body) {
         const ctrl = new AbortController();
         const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
@@ -166,6 +166,10 @@ export class SupafoneLabs {
             clearTimeout(timer);
         }
     }
+    /** Convenience alias for voice preview UI/buttons. */
+    previewVoice(voice = "supafone-labs-calm-en", text = "Hi, this is your Supafone agent voice preview.") {
+        return this.tts(text, voice);
+    }
     /** Hosted STT for a finished audio clip — returns transcript + language tags. */
     async stt(audio, opts = {}) {
         const bytes = audio instanceof ArrayBuffer ? new Uint8Array(audio) : audio;
@@ -212,6 +216,48 @@ export class SupafoneLabs {
     logs(limit = 100) {
         return this.request("GET", `/v1/logs?limit=${limit}`);
     }
+    /** Live audit-log stream. Works in Node 18+ and browsers via fetch streaming. */
+    async *streamLogs(opts = {}) {
+        const q = new URLSearchParams({
+            limit: String(opts.limit ?? 100),
+            poll_ms: String(opts.pollMs ?? 1000),
+            snapshot: String(opts.snapshot ?? true),
+        });
+        if (opts.afterId !== undefined)
+            q.set("after_id", String(opts.afterId));
+        const res = await fetch(`${this.baseUrl}/v1/logs/stream?${q}`, {
+            method: "GET",
+            signal: opts.signal,
+            headers: { Authorization: `Bearer ${this.apiKey}` },
+        });
+        if (!res.ok)
+            throw new SupafoneLabsError(`streamLogs: ${await res.text()}`, res.status);
+        if (!res.body)
+            throw new SupafoneLabsError("streamLogs: response body is not readable");
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        try {
+            for (;;) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                let split = buffer.indexOf("\n\n");
+                while (split >= 0) {
+                    const raw = buffer.slice(0, split);
+                    buffer = buffer.slice(split + 2);
+                    const parsed = parseSseLog(raw);
+                    if (parsed)
+                        yield parsed;
+                    split = buffer.indexOf("\n\n");
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
     /** The structured whisper feed (what the console shows). */
     nudges(limit = 50) {
         return this.request("GET", `/v1/nudges?limit=${limit}`);
@@ -238,6 +284,10 @@ export class SupafoneLabs {
         const d = await this.request("GET", "/v1/voices");
         return d.voices.map((v) => (typeof v === "string" ? v : (v.voice ?? v.id ?? ""))).filter(Boolean);
     }
+    /** Full hosted voice catalog with provider live/configured flags. */
+    voiceCatalog() {
+        return this.request("GET", "/v1/voices");
+    }
 }
 class LiveTranscription {
     ws;
@@ -293,6 +343,9 @@ class LabsNamespace {
     voices;
     phoneNumbers;
     telephony;
+    calls;
+    recordings;
+    transcripts;
     constructor(sm) {
         this.sm = sm;
         this.agents = new LabsAgentsNamespace(sm);
@@ -301,10 +354,13 @@ class LabsNamespace {
         this.voices = new LabsVoicesNamespace(sm);
         this.phoneNumbers = new LabsPhoneNumbersNamespace(sm);
         this.telephony = new LabsTelephonyNamespace(sm);
+        this.calls = new LabsCallsNamespace(sm);
+        this.recordings = new LabsRecordingsNamespace(sm);
+        this.transcripts = new LabsTranscriptsNamespace(sm);
     }
     /** Discover the Supafone convenience layer over Ultravox. */
     capabilities() {
-        return this.sm.requestSupafoneApi("GET", "/api/v1supafone-labs/capabilities");
+        return this.sm.requestSupafoneApi("GET", "/api/v1/labs/capabilities");
     }
 }
 class LabsAgentsNamespace {
@@ -314,7 +370,7 @@ class LabsAgentsNamespace {
     }
     /** Spawn a durable hosted Supafone agent backed by Ultravox and Supafone-managed providers. */
     create(input) {
-        return this.sm.requestSupafoneApi("POST", "/api/v1supafone-labs/agents", labsAgentPayload(input));
+        return this.sm.requestSupafoneApi("POST", "/api/v1/labs/agents", labsAgentPayload(input));
     }
     /** Create an inbound receptionist/intake agent. No Twilio account is required. */
     createInbound(input) {
@@ -384,7 +440,7 @@ class LabsAgentsNamespace {
         if (opts.style)
             q.set("style", opts.style);
         const suffix = q.toString() ? `?${q}` : "";
-        return this.sm.requestSupafoneApi("GET", `/api/v1supafone-labs/agents${suffix}`);
+        return this.sm.requestSupafoneApi("GET", `/api/v1/labs/agents${suffix}`);
     }
     /** Fetch one durable agent by key. */
     get(agentKey, opts = {}) {
@@ -394,7 +450,19 @@ class LabsAgentsNamespace {
         if (opts.agentType)
             q.set("agent_type", opts.agentType);
         const suffix = q.toString() ? `?${q}` : "";
-        return this.sm.requestSupafoneApi("GET", `/api/v1supafone-labs/agents/${encodeURIComponent(agentKey)}${suffix}`);
+        return this.sm.requestSupafoneApi("GET", `/api/v1/labs/agents/${encodeURIComponent(agentKey)}${suffix}`);
+    }
+    /** Delete an agent. Optionally ask the backend to release assigned numbers. */
+    delete(agentKey, opts = {}) {
+        const q = new URLSearchParams();
+        const agencyId = opts.agency_id ?? opts.agencyId;
+        const releaseNumbers = opts.release_numbers ?? opts.releaseNumbers;
+        if (agencyId)
+            q.set("agency_id", agencyId);
+        if (releaseNumbers !== undefined)
+            q.set("release_numbers", String(releaseNumbers));
+        const suffix = q.toString() ? `?${q}` : "";
+        return this.sm.requestSupafoneApi("DELETE", `/api/v1/labs/agents/${encodeURIComponent(agentKey)}${suffix}`);
     }
 }
 class LabsPresetsNamespace {
@@ -404,7 +472,7 @@ class LabsPresetsNamespace {
     }
     /** Out-of-the-box multistage agent presets. */
     list() {
-        return this.sm.requestSupafoneApi("GET", "/api/v1supafone-labs/presets");
+        return this.sm.requestSupafoneApi("GET", "/api/v1/labs/presets");
     }
 }
 class LabsToolsNamespace {
@@ -414,7 +482,7 @@ class LabsToolsNamespace {
     }
     /** Built-in tools Supafone agents can use. */
     list() {
-        return this.sm.requestSupafoneApi("GET", "/api/v1supafone-labs/tools");
+        return this.sm.requestSupafoneApi("GET", "/api/v1/labs/tools");
     }
 }
 class LabsVoicesNamespace {
@@ -428,7 +496,76 @@ class LabsVoicesNamespace {
         if (opts.provider)
             q.set("provider", opts.provider);
         const suffix = q.toString() ? `?${q}` : "";
-        return this.sm.requestSupafoneApi("GET", `/api/v1supafone-labs/voices${suffix}`);
+        return this.sm.requestSupafoneApi("GET", `/api/v1/labs/voices${suffix}`);
+    }
+}
+class LabsCallsNamespace {
+    sm;
+    constructor(sm) {
+        this.sm = sm;
+    }
+    list(opts = {}) {
+        const q = hostedListQuery(opts);
+        const suffix = q.toString() ? `?${q}` : "";
+        return this.sm.requestSupafoneApi("GET", `/api/v1/labs/calls${suffix}`);
+    }
+    get(callId, opts = {}) {
+        const q = new URLSearchParams();
+        if (opts.agencyId)
+            q.set("agency_id", opts.agencyId);
+        const suffix = q.toString() ? `?${q}` : "";
+        return this.sm.requestSupafoneApi("GET", `/api/v1/labs/calls/${encodeURIComponent(callId)}${suffix}`);
+    }
+}
+class LabsRecordingsNamespace {
+    sm;
+    constructor(sm) {
+        this.sm = sm;
+    }
+    list(opts = {}) {
+        const q = hostedListQuery(opts);
+        const callId = opts.call_id ?? opts.callId;
+        if (callId)
+            q.set("call_id", callId);
+        const suffix = q.toString() ? `?${q}` : "";
+        return this.sm.requestSupafoneApi("GET", `/api/v1/labs/recordings${suffix}`);
+    }
+    get(recordingId, opts = {}) {
+        const q = new URLSearchParams();
+        if (opts.agencyId)
+            q.set("agency_id", opts.agencyId);
+        const suffix = q.toString() ? `?${q}` : "";
+        return this.sm.requestSupafoneApi("GET", `/api/v1/labs/recordings/${encodeURIComponent(recordingId)}${suffix}`);
+    }
+    delete(recordingId, opts = {}) {
+        const q = new URLSearchParams();
+        if (opts.agencyId)
+            q.set("agency_id", opts.agencyId);
+        if (opts.reason)
+            q.set("reason", opts.reason);
+        const suffix = q.toString() ? `?${q}` : "";
+        return this.sm.requestSupafoneApi("DELETE", `/api/v1/labs/recordings/${encodeURIComponent(recordingId)}${suffix}`);
+    }
+}
+class LabsTranscriptsNamespace {
+    sm;
+    constructor(sm) {
+        this.sm = sm;
+    }
+    list(opts = {}) {
+        const q = hostedListQuery(opts);
+        const callId = opts.call_id ?? opts.callId;
+        if (callId)
+            q.set("call_id", callId);
+        const suffix = q.toString() ? `?${q}` : "";
+        return this.sm.requestSupafoneApi("GET", `/api/v1/labs/transcripts${suffix}`);
+    }
+    get(transcriptId, opts = {}) {
+        const q = new URLSearchParams();
+        if (opts.agencyId)
+            q.set("agency_id", opts.agencyId);
+        const suffix = q.toString() ? `?${q}` : "";
+        return this.sm.requestSupafoneApi("GET", `/api/v1/labs/transcripts/${encodeURIComponent(transcriptId)}${suffix}`);
     }
 }
 class LabsPhoneNumbersNamespace {
@@ -444,22 +581,43 @@ class LabsPhoneNumbersNamespace {
         if (opts.activeOnly !== undefined)
             q.set("active_only", String(opts.activeOnly));
         const suffix = q.toString() ? `?${q}` : "";
-        return this.sm.requestSupafoneApi("GET", `/api/v1supafone-labs/phone-numbers${suffix}`);
+        return this.sm.requestSupafoneApi("GET", `/api/v1/labs/phone-numbers${suffix}`);
     }
     /** Search Supafone-managed inventory. This uses Supafone's master telephony account. */
     search(opts = {}) {
-        return this.sm.requestSupafoneApi("POST", "/api/v1supafone-labs/phone-numbers/search", phoneNumberSearchPayload(opts));
+        return this.sm.requestSupafoneApi("POST", "/api/v1/labs/phone-numbers/search", phoneNumberSearchPayload(opts));
     }
     /** Buy a Supafone-managed number. Developers do not need a Twilio account. */
     buy(input) {
-        return this.sm.requestSupafoneApi("POST", "/api/v1supafone-labs/phone-numbers", phoneNumberProvisionPayload({
+        return this.sm.requestSupafoneApi("POST", "/api/v1/labs/phone-numbers", phoneNumberProvisionPayload({
             ...input,
             telephony: input.telephony ?? { mode: "supafone_managed", provider: "supafone" },
         }));
     }
     /** Attach an existing Supafone number to an inbound or outbound agent. */
     assign(numberId, input = {}) {
-        return this.sm.requestSupafoneApi("POST", `/api/v1supafone-labs/phone-numbers/${encodeURIComponent(numberId)}/assign`, phoneNumberAssignPayload(input));
+        return this.sm.requestSupafoneApi("POST", `/api/v1/labs/phone-numbers/${encodeURIComponent(numberId)}/assign`, phoneNumberAssignPayload(input));
+    }
+    /** Unassign a number from an agent but keep it reserved on the account. */
+    unassign(numberId, input = {}) {
+        return this.sm.requestSupafoneApi("POST", `/api/v1/labs/phone-numbers/${encodeURIComponent(numberId)}/unassign`, phoneNumberReleasePayload(input));
+    }
+    /** Give a number back to the shared pool or release the reservation. */
+    release(numberId, input = {}) {
+        return this.sm.requestSupafoneApi("POST", `/api/v1/labs/phone-numbers/${encodeURIComponent(numberId)}/release`, phoneNumberReleasePayload({ ...input, returnToPool: input.returnToPool ?? input.return_to_pool ?? true }));
+    }
+    /** Alias for release(numberId, { returnToPool: true }). */
+    returnToPool(numberId, input = {}) {
+        return this.release(numberId, { ...input, returnToPool: true });
+    }
+    /** Delete/release a number reservation. Backend policy decides whether this is allowed. */
+    delete(numberId, input = {}) {
+        const q = new URLSearchParams();
+        const agencyId = input.agency_id ?? input.agencyId;
+        if (agencyId)
+            q.set("agency_id", agencyId);
+        const suffix = q.toString() ? `?${q}` : "";
+        return this.sm.requestSupafoneApi("DELETE", `/api/v1/labs/phone-numbers/${encodeURIComponent(numberId)}${suffix}`, phoneNumberReleasePayload(input));
     }
     /**
      * Search if needed, buy the first matching Supafone-managed number, and assign
@@ -496,11 +654,11 @@ class LabsTelephonyNamespace {
         if (opts.agencyId)
             q.set("agency_id", opts.agencyId);
         const suffix = q.toString() ? `?${q}` : "";
-        return this.sm.requestSupafoneApi("GET", `/api/v1supafone-labs/telephony${suffix}`);
+        return this.sm.requestSupafoneApi("GET", `/api/v1/labs/telephony${suffix}`);
     }
     /** Configure advanced BYOK telephony, or reset back to Supafone-managed. */
     configure(input) {
-        return this.sm.requestSupafoneApi("PUT", "/api/v1supafone-labs/telephony", telephonyPayload(input));
+        return this.sm.requestSupafoneApi("PUT", "/api/v1/labs/telephony", telephonyPayload(input));
     }
     /** Reset to the seamless default where Supafone buys and routes numbers. */
     useSupafoneManaged(agencyId) {
@@ -561,6 +719,10 @@ class OptimizerNamespace {
     standing(agent = "builder") {
         return this.sm.request("GET", `/v1/optimizer/standing?agent=${encodeURIComponent(agent)}`);
     }
+    /** SSR grade distribution: five nominal levels folded into a real score distribution. */
+    distribution(agent = "builder", limit = 500) {
+        return this.sm.request("GET", `/v1/objective/distribution?agent=${encodeURIComponent(agent)}&limit=${limit}`);
+    }
     /** List the post-call reports behind the optimizer. */
     reports(agent = "builder", limit = 40) {
         return this.sm.request("GET", `/v1/optimizer/reports?agent=${encodeURIComponent(agent)}&limit=${limit}`);
@@ -578,17 +740,26 @@ function labsAgentPayload(input) {
         industry: input.industry,
         website_url: input.website_url ?? input.websiteUrl,
         phone_number: input.phone_number ?? input.phoneNumber,
+        number_strategy: input.number_strategy ?? input.numberStrategy,
+        number_pool: input.number_pool ?? input.numberPool,
+        premium: input.premium,
         direction: input.direction,
         preset_key: input.preset_key ?? input.presetKey,
         runtime_mode: input.runtime_mode ?? input.runtimeMode,
+        call_stages: callStagesPayload(input),
         goal: input.goal,
         greeting: input.greeting,
         system_prompt: input.system_prompt ?? input.systemPrompt,
         language: input.language,
         voice: input.voice ? voicePayload(input.voice) : undefined,
         provider_keys: input.provider_keys ?? (input.providerKeys ? providerKeysPayload(input.providerKeys) : undefined),
-        byok: input.byok ? providerKeysPayload(input.byok) : undefined,
+        byok: input.byok ? byokPayload(input.byok) : undefined,
         telephony: input.telephony ? telephonyPayload(input.telephony) : undefined,
+        custom_sip: customSipPayload(input.custom_sip ?? input.customSip ?? input.sip),
+        recording: input.recording ? recordingPayload(input.recording) : undefined,
+        transcription: input.transcription ? transcriptionPayload(input.transcription) : undefined,
+        artifacts: input.artifacts ? artifactsPayload(input.artifacts) : undefined,
+        compliance: input.compliance,
         tools: input.tools ? toolsPayload(input.tools) : undefined,
         labs: input.labs ? labsPayload(input.labs) : undefined,
         ultravox: input.ultravox ? ultravoxPayload(input.ultravox) : undefined,
@@ -597,13 +768,30 @@ function labsAgentPayload(input) {
         metadata: input.metadata,
     });
 }
+function hostedListQuery(opts) {
+    const q = new URLSearchParams();
+    if (opts.agencyId)
+        q.set("agency_id", opts.agencyId);
+    const agentKey = opts.agent_key ?? opts.agentKey;
+    if (agentKey)
+        q.set("agent_key", agentKey);
+    if (opts.limit !== undefined)
+        q.set("limit", String(opts.limit));
+    return q;
+}
 function telephonyPayload(input) {
     return compact({
         agency_id: input.agency_id ?? input.agencyId,
         mode: input.mode,
         provider: input.provider,
+        number_strategy: input.number_strategy ?? input.numberStrategy,
+        number_pool: input.number_pool ?? input.numberPool,
+        number_id: input.number_id ?? input.numberId,
+        premium: input.premium,
         label: input.label,
         credentials: input.credentials ? telephonyCredentialsPayload(input.credentials) : undefined,
+        provider_settings: input.provider_settings ?? input.providerSettings,
+        custom_sip: customSipPayload(input.custom_sip ?? input.customSip),
         metadata: input.metadata,
     });
 }
@@ -621,11 +809,22 @@ function telephonyCredentialsPayload(input) {
         username: input.username,
         password: input.password,
         webhook_secret: input.webhook_secret ?? input.webhookSecret,
+        telnyx_connection_id: input.telnyx_connection_id ?? input.telnyxConnectionId,
+        signalwire_space_url: input.signalwire_space_url ?? input.signalwireSpaceUrl,
+        project_id: input.project_id ?? input.projectId,
+        application_id: input.application_id ?? input.applicationId,
+        trunk_id: input.trunk_id ?? input.trunkId,
+        endpoint_id: input.endpoint_id ?? input.endpointId,
+        token: input.token,
+        secret: input.secret,
+        custom_sip: customSipPayload(input.custom_sip ?? input.customSip),
     });
 }
 function phoneNumberSearchPayload(input) {
     return compact({
         agency_id: input.agency_id ?? input.agencyId,
+        number_pool: input.number_pool ?? input.numberPool,
+        number_strategy: input.number_strategy ?? input.numberStrategy,
         country_code: input.country_code ?? input.countryCode,
         area_code: input.area_code ?? input.areaCode,
         postal_code: input.postal_code ?? input.postalCode,
@@ -646,6 +845,9 @@ function phoneNumberProvisionPayload(input) {
         agent_id: input.agent_id ?? input.agentId,
         agent_name: input.agent_name ?? input.agentName,
         preset_key: input.preset_key ?? input.presetKey,
+        number_strategy: input.number_strategy ?? input.numberStrategy,
+        number_pool: input.number_pool ?? input.numberPool,
+        premium: input.premium,
         style: input.agent_style ?? input.agentStyle ?? input.style,
         direction: input.direction,
         telephony: input.telephony ? telephonyPayload(input.telephony) : undefined,
@@ -660,12 +862,99 @@ function phoneNumberAssignPayload(input) {
         agent_name: input.agent_name ?? input.agentName,
         friendly_name: input.friendly_name ?? input.friendlyName,
         preset_key: input.preset_key ?? input.presetKey,
+        number_strategy: input.number_strategy ?? input.numberStrategy,
+        number_pool: input.number_pool ?? input.numberPool,
+        premium: input.premium,
         style: input.agent_style ?? input.agentStyle ?? input.style,
         direction: input.direction,
         telephony: input.telephony ? telephonyPayload(input.telephony) : undefined,
         metadata: input.metadata,
     });
 }
+function phoneNumberReleasePayload(input) {
+    return compact({
+        agency_id: input.agency_id ?? input.agencyId,
+        reason: input.reason,
+        return_to_pool: input.return_to_pool ?? input.returnToPool,
+        metadata: input.metadata,
+    });
+}
+function callStagesPayload(input) {
+    const explicit = input.call_stages ?? input.callStages ?? input.stages;
+    const auto = input.auto_call_stages ?? input.autoCallStages;
+    if (Array.isArray(explicit))
+        return explicit.map(callStagePayload);
+    if (explicit === false || auto === false)
+        return undefined;
+    return generateCallStages(input).map(callStagePayload);
+}
+function callStagePayload(input) {
+    return compact({
+        key: input.key ?? input.id,
+        name: input.name,
+        goal: input.goal,
+        instructions: input.instructions,
+        exit_criteria: input.exit_criteria ?? input.exitCriteria,
+        tools: input.tools,
+        metadata: input.metadata,
+    });
+}
+export function generateCallStages(input) {
+    const direction = String(input.direction ?? input.agent_style ?? input.agentStyle ?? input.style ?? "inbound").toLowerCase();
+    const haystack = [
+        input.name,
+        input.assistant_name ?? input.assistantName,
+        input.business_name ?? input.businessName,
+        input.industry,
+        input.goal,
+        input.system_prompt ?? input.systemPrompt,
+        input.preset_key ?? input.presetKey,
+    ].filter(Boolean).join(" ").toLowerCase();
+    const meta = { auto_generated: true, source: "supafone-labs-sdk" };
+    if (direction === "outbound" || haystack.includes("sales") || haystack.includes("lead")) {
+        return [
+            stage("intro_consent", "Intro and consent", "State who you are, why you are calling, and offer an immediate opt-out.", ["Caller understands purpose", "Opt-out is honored"], meta),
+            stage("qualification", "Qualification", "Confirm fit, urgency, decision process, and the best next step.", ["Need and timeline are clear"], meta),
+            stage("offer", "Offer", "Explain the next step in plain language without unsupported claims.", ["Caller understands the next step"], meta),
+            stage("booking", "Booking", "Book or route the caller only after confirming required details.", ["Next step is confirmed by a tool or human handoff"], meta),
+            stage("close", "Close", "Summarize what will happen next and end politely.", ["Caller knows the follow-up path"], meta),
+        ];
+    }
+    if (haystack.includes("legal") || haystack.includes("law") || haystack.includes("injury") || haystack.includes("intake")) {
+        return [
+            stage("greeting", "Greeting", "Open warmly and acknowledge the caller before logistics.", ["Caller need is understood"], meta),
+            stage("incident", "Incident details", "Collect what happened, when it happened, injuries, insurance, and contact details.", ["Core facts are collected"], meta),
+            stage("screening", "Screening", "Identify urgency, jurisdiction, conflicts, and whether human escalation is required.", ["Escalation decision is clear"], meta),
+            stage("booking", "Consult booking", "Book the right next step without quoting fees or inventing availability.", ["Booking or handoff is tool-confirmed"], meta),
+            stage("close", "Close", "Summarize the next step and set expectations accurately.", ["Caller knows exactly what happens next"], meta),
+        ];
+    }
+    if (haystack.includes("medical") || haystack.includes("clinic") || haystack.includes("patient") || haystack.includes("health")) {
+        return [
+            stage("greeting", "Greeting", "Identify the caller need and keep the tone calm and concise.", ["Caller need is understood"], meta),
+            stage("patient_context", "Patient context", "Collect non-sensitive scheduling context and avoid medical advice.", ["Required scheduling context is collected"], meta),
+            stage("routing", "Routing", "Route urgent, billing, clinical, and scheduling requests correctly.", ["Correct route is selected"], meta),
+            stage("appointment", "Appointment", "Book or request the appointment only after confirming details.", ["Appointment path is confirmed"], meta),
+            stage("close", "Close", "Recap next steps and any confirmed timing.", ["Caller knows the next step"], meta),
+        ];
+    }
+    return [
+        stage("greeting", "Greeting", "Open naturally, identify the caller need, and set a helpful tone.", ["Caller need is understood"], meta),
+        stage("discovery", "Discovery", "Ask one question at a time until the key details are clear.", ["Required details are collected"], meta),
+        stage("resolution", "Resolution", "Answer approved questions or route to the right workflow.", ["Resolution path is selected"], meta),
+        stage("action", "Action", "Use tools for booking, routing, messaging, or handoff before claiming success.", ["Action is confirmed by a tool or handoff"], meta),
+        stage("close", "Close", "Summarize the outcome and next step accurately.", ["Caller knows what happens next"], meta),
+    ];
+}
+function stage(key, name, instructions, exitCriteria, metadata) {
+    return {
+        key,
+        name,
+        instructions,
+        exitCriteria,
+        metadata,
+    };
+}
 function voicePayload(input) {
     return compact({
         provider: input.provider,
@@ -677,6 +966,30 @@ function providerKeysPayload(input) {
     return compact({
         ultravox: input.ultravox,
         ultravox_api_key: input.ultravox_api_key ?? input.ultravoxApiKey,
+        retell: input.retell,
+        retell_api_key: input.retell_api_key ?? input.retellApiKey,
+        vapi: input.vapi,
+        vapi_api_key: input.vapi_api_key ?? input.vapiApiKey,
+        bland: input.bland,
+        bland_api_key: input.bland_api_key ?? input.blandApiKey,
+        livekit: input.livekit,
+        livekit_api_key: input.livekit_api_key ?? input.livekitApiKey,
+        livekit_api_secret: input.livekit_api_secret ?? input.livekitApiSecret,
+        pipecat: input.pipecat,
+        pipecat_api_key: input.pipecat_api_key ?? input.pipecatApiKey,
+        twilio: input.twilio,
+        twilio_account_sid: input.twilio_account_sid ?? input.twilioAccountSid,
+        twilio_auth_token: input.twilio_auth_token ?? input.twilioAuthToken,
+        twilio_api_key_sid: input.twilio_api_key_sid ?? input.twilioApiKeySid,
+        twilio_api_key_secret: input.twilio_api_key_secret ?? input.twilioApiKeySecret,
+        telnyx: input.telnyx,
+        telnyx_api_key: input.telnyx_api_key ?? input.telnyxApiKey,
+        plivo: input.plivo,
+        plivo_auth_id: input.plivo_auth_id ?? input.plivoAuthId,
+        plivo_auth_token: input.plivo_auth_token ?? input.plivoAuthToken,
+        signalwire: input.signalwire,
+        signalwire_api_token: input.signalwire_api_token ?? input.signalwireApiToken,
+        signalwire_project_id: input.signalwire_project_id ?? input.signalwireProjectId,
         elevenlabs: input.elevenlabs,
         elevenlabs_api_key: input.elevenlabs_api_key ?? input.elevenlabsApiKey,
         cartesia: input.cartesia,
@@ -685,6 +998,56 @@ function providerKeysPayload(input) {
         inworld_api_key: input.inworld_api_key ?? input.inworldApiKey,
         deepgram: input.deepgram,
         deepgram_api_key: input.deepgram_api_key ?? input.deepgramApiKey,
+        anthropic: input.anthropic,
+        anthropic_api_key: input.anthropic_api_key ?? input.anthropicApiKey,
+        openai: input.openai,
+        openai_api_key: input.openai_api_key ?? input.openaiApiKey,
+        xai: input.xai,
+        xai_api_key: input.xai_api_key ?? input.xaiApiKey,
+    });
+}
+function byokPayload(input) {
+    const structured = input;
+    if (structured.agentProvider ||
+        structured.agent_provider ||
+        structured.runtime ||
+        structured.telephony ||
+        structured.tts ||
+        structured.stt ||
+        structured.llm ||
+        structured.providerKeys ||
+        structured.provider_keys ||
+        structured.customSip ||
+        structured.custom_sip ||
+        structured.sip) {
+        return compact({
+            provider_keys: providerKeysPayload(structured.provider_keys ?? structured.providerKeys ?? {}),
+            agent_provider: providerConfigPayload(structured.agent_provider ?? structured.agentProvider ?? structured.runtime),
+            telephony: structured.telephony ? telephonyPayload(structured.telephony) : undefined,
+            tts: providerConfigPayload(structured.tts),
+            stt: providerConfigPayload(structured.stt),
+            llm: providerConfigPayload(structured.llm),
+            custom_sip: customSipPayload(structured.custom_sip ?? structured.customSip ?? structured.sip),
+        });
+    }
+    return providerKeysPayload(input);
+}
+function providerConfigPayload(input) {
+    if (!input)
+        return undefined;
+    const out = { ...input };
+    delete out.apiKey;
+    delete out.api_key;
+    delete out.voiceId;
+    delete out.voice_id;
+    return compact({
+        ...out,
+        provider: input.provider,
+        api_key: input.api_key ?? input.apiKey,
+        credentials: input.credentials,
+        settings: input.settings,
+        model: input.model,
+        voice_id: input.voice_id ?? input.voiceId,
     });
 }
 function toolsPayload(input) {
@@ -701,11 +1064,54 @@ function toolsPayload(input) {
         custom_tools: input.custom_tools ?? input.customTools,
     });
 }
+function recordingPayload(input) {
+    return compact({
+        enabled: input.enabled,
+        record_audio: input.record_audio ?? input.recordAudio,
+        consent_required: input.consent_required ?? input.consentRequired,
+        announcement: input.announcement,
+        retention_days: input.retention_days ?? input.retentionDays,
+        storage: input.storage,
+        redact_pii: input.redact_pii ?? input.redactPii,
+        metadata: input.metadata,
+    });
+}
+function transcriptionPayload(input) {
+    return compact({
+        enabled: input.enabled,
+        provider: input.provider,
+        model: input.model,
+        language: input.language,
+        redact_pii: input.redact_pii ?? input.redactPii,
+        diarization: input.diarization,
+        timestamps: input.timestamps,
+        metadata: input.metadata,
+    });
+}
+function artifactsPayload(input) {
+    return compact({
+        recordings: input.recordings,
+        transcripts: input.transcripts,
+        summaries: input.summaries,
+        qa_reports: input.qa_reports ?? input.qaReports,
+        logs: input.logs,
+        webhooks: input.webhooks,
+        retention_days: input.retention_days ?? input.retentionDays,
+        metadata: input.metadata,
+    });
+}
 function labsPayload(input) {
     return compact({
         enabled: input.enabled,
         voice_watcher: input.voice_watcher ?? input.voiceWatcher,
+        api_key: input.api_key ?? input.apiKey,
         model: input.model,
+        mode: input.mode,
+        managed_infrastructure: input.managed_infrastructure ?? input.managedInfrastructure,
+        stt: input.stt,
+        llm: input.llm,
+        tts: input.tts,
+        provider_keys: input.provider_keys ?? input.providerKeys,
         label: input.label,
     });
 }
@@ -734,6 +1140,24 @@ function ultravoxPayload(input) {
         voiceOverrides: input.voiceOverrides ?? input.voice_overrides,
         retentionPolicy: input.retentionPolicy ?? input.retention_policy,
         callTemplate: input.callTemplate ?? input.call_template,
+        custom_sip: customSipPayload(input.custom_sip ?? input.customSip ?? input.sip),
+    });
+}
+function customSipPayload(input) {
+    if (!input)
+        return undefined;
+    return compact({
+        sip_trunk_uri: input.sip_trunk_uri ?? input.sipTrunkUri,
+        trunk_uri: input.trunk_uri ?? input.trunkUri,
+        sip_host: input.sip_host ?? input.sipHost,
+        from_number: input.from_number ?? input.fromNumber,
+        username: input.username,
+        password: input.password,
+        transport: input.transport,
+        headers: input.headers,
+        codecs: input.codecs,
+        dtmf_mode: input.dtmf_mode ?? input.dtmfMode,
+        metadata: input.metadata,
     });
 }
 function compact(input) {
@@ -744,6 +1168,21 @@ function compact(input) {
     }
     return out;
 }
+function parseSseLog(raw) {
+    const data = [];
+    for (const line of raw.split(/\r?\n/)) {
+        if (!line || line.startsWith(":"))
+            continue;
+        if (line.startsWith("data:"))
+            data.push(line.slice(5).trimStart());
+    }
+    if (!data.length)
+        return null;
+    const parsed = safeJson(data.join("\n"));
+    if (!parsed || typeof parsed !== "object")
+        return null;
+    return parsed;
+}
 function safeJson(text) {
     try {
         return JSON.parse(text);