supafone-labs 0.3.1 → 0.4.0

package/dist/index.js

@@ -38,27 +38,40 @@ const COACH_SYSTEM = "You are the coaching core of a second mind for a live voic
 export class SupafoneLabs {
     baseUrl;
     supafoneApiBaseUrl;
+    appUrl;
     apiKey;
     supafoneApiKey;
     timeoutMs;
     sessionToken;
+    accountToken;
+    accountSessionToken;
+    accountEmail;
+    accountPassword;
     labs;
     builder;
     qa;
     optimizer;
+    campaigns;
     constructor(opts) {
-        if (!opts?.apiKey)
-            throw new SupafoneLabsError("apiKey is required");
-        this.apiKey = opts.apiKey;
+        const hasAccountAuth = !!(opts?.accountToken || (opts?.accountEmail && opts?.accountPassword));
+        if (!opts?.apiKey && !hasAccountAuth) {
+            throw new SupafoneLabsError("apiKey is required — or, for campaigns/calls, pass accountToken or accountEmail + accountPassword");
+        }
+        this.apiKey = opts.apiKey ?? "";
         this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE).replace(/\/$/, "");
-        this.supafoneApiKey = opts.supafoneApiKey ?? opts.apiKey;
+        this.supafoneApiKey = opts.supafoneApiKey ?? this.apiKey;
         this.supafoneApiBaseUrl = (opts.supafoneApiBaseUrl ?? DEFAULT_SUPAFONE_API_BASE).replace(/\/$/, "");
+        this.appUrl = (opts.appUrl ?? "https://app.supafone.ai").replace(/\/$/, "");
         this.timeoutMs = opts.timeoutMs ?? 30_000;
         this.sessionToken = opts.sessionToken;
+        this.accountToken = opts.accountToken;
+        this.accountEmail = opts.accountEmail;
+        this.accountPassword = opts.accountPassword;
         this.labs = new LabsNamespace(this);
         this.builder = new BuilderNamespace(this);
         this.qa = new QANamespace(this);
         this.optimizer = new OptimizerNamespace(this);
+        this.campaigns = new CampaignsNamespace(this);
     }
     /** True once login() (or a passed sessionToken) is in effect. */
     get isLoggedIn() {
@@ -121,6 +134,87 @@ export class SupafoneLabs {
             clearTimeout(timer);
         }
     }
+    /**
+     * Exchange the account email/password for a product-API JWT (the same login
+     * as app.supafone.ai). Called lazily by campaigns/calls — call directly only
+     * to fail fast.
+     */
+    async accountLogin(email, password) {
+        const useEmail = email ?? this.accountEmail;
+        const usePassword = password ?? this.accountPassword;
+        if (!useEmail || !usePassword) {
+            throw new SupafoneLabsError("Not authenticated: pass accountToken, or accountEmail + accountPassword");
+        }
+        const body = await this.accountHttp("POST", "/api/v1/auth/login", { email: useEmail, password: usePassword }, "");
+        const token = body.access_token || body.token;
+        if (!token)
+            throw new SupafoneLabsError("Login succeeded but returned no token");
+        this.accountSessionToken = token;
+        return token;
+    }
+    /**
+     * @internal JSON request to the Supafone product API with the ACCOUNT JWT
+     * (campaigns + real calls). A minted token that expires gets one transparent
+     * re-login; an explicit accountToken is the caller's to refresh.
+     */
+    async requestAccountApi(method, path, body) {
+        const token = this.accountToken || this.accountSessionToken || (await this.accountLogin());
+        try {
+            return await this.accountHttp(method, path, body, token);
+        }
+        catch (err) {
+            const expired = err instanceof SupafoneLabsError && err.status === 401;
+            if (expired && !this.accountToken && this.accountEmail && this.accountPassword) {
+                this.accountSessionToken = undefined;
+                return this.accountHttp(method, path, body, await this.accountLogin());
+            }
+            throw err;
+        }
+    }
+    /** @internal Raw product-API request with an explicit bearer ("" = none). */
+    async accountHttp(method, path, body, token) {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+        try {
+            const headers = { "Content-Type": "application/json" };
+            if (token)
+                headers.Authorization = `Bearer ${token}`;
+            const res = await fetch(this.supafoneApiBaseUrl + path, {
+                method,
+                signal: ctrl.signal,
+                headers,
+                body: body === undefined ? undefined : JSON.stringify(body),
+            });
+            const text = await res.text();
+            const parsed = text ? safeJson(text) : {};
+            if (!res.ok) {
+                const detail = parsed?.detail ?? text ?? `HTTP ${res.status}`;
+                throw new SupafoneLabsError(`${method} ${path}: ${detail}`, res.status, parsed);
+            }
+            return parsed;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * PLACE A REAL OUTBOUND PHONE CALL: dials toNumber from the account's
+     * calling provider and bridges the voice agent onto the line.
+     */
+    async placeCall(opts) {
+        if (!opts?.agentId)
+            throw new SupafoneLabsError("agentId is required (see listVoiceAgents())");
+        if (!opts?.toNumber)
+            throw new SupafoneLabsError("toNumber is required (E.164, e.g. +15551234567)");
+        return this.requestAccountApi("POST", "/api/v1/phone/test-call", {
+            agent_id: opts.agentId,
+            to_number: opts.toNumber,
+        });
+    }
+    /** The account's voice agents — pick an agent id for campaigns/calls. */
+    async listVoiceAgents() {
+        return this.requestAccountApi("GET", "/api/v1/agents");
+    }
     /** Raw oracle completion — full control over messages and model. */
     async oracle(req) {
         return this.request("POST", "/v1/oracle/complete", {
@@ -166,6 +260,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 +310,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 +378,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;
@@ -284,7 +428,131 @@ class LiveTranscription {
         return this.ws;
     }
 }
-/** Programmatic hosted Supafone agents, inside the Supafone API. */
+/**
+ * Typical flow:
+ * ```ts
+ * const sf = new Supafone({ accountEmail, accountPassword });
+ * const { agents } = await sf.listVoiceAgents();
+ * const { campaign } = await sf.campaigns.create({ name: "Q3 win-back", goal: "reengage", agentId: agents[0].id });
+ * await sf.campaigns.applyPreset(campaign.id, "win_back");
+ * await sf.campaigns.addRecipients(campaign.id, [{ name: "Jane", phone: "+15551234567", outreach_consent: "yes" }]);
+ * await sf.campaigns.launch(campaign.id);
+ * const live = await sf.campaigns.live(campaign.id); // in-flight calls + portal links
+ * ```
+ */
+class CampaignsNamespace {
+    sm;
+    constructor(sm) {
+        this.sm = sm;
+    }
+    list(opts = {}) {
+        const query = opts.accountId ? `?${new URLSearchParams({ account_id: opts.accountId })}` : "";
+        return this.sm.requestAccountApi("GET", `/api/v1/campaigns${query}`);
+    }
+    create(opts = {}) {
+        return this.sm.requestAccountApi("POST", "/api/v1/campaigns", compact({
+            name: opts.name ?? "New campaign",
+            goal: opts.goal ?? "book",
+            agent_id: opts.agentId,
+            account_id: opts.accountId,
+        }));
+    }
+    get(campaignId) {
+        return this.sm.requestAccountApi("GET", `/api/v1/campaigns/${encodeURIComponent(campaignId)}`);
+    }
+    update(campaignId, input) {
+        const payload = compact({
+            name: input.name,
+            goal: input.goal,
+            agent_id: input.agentId,
+            email_subject: input.emailSubject,
+            email_body: input.emailBody,
+            cadence: input.cadence,
+            settings: input.settings,
+        });
+        if (!Object.keys(payload).length) {
+            throw new SupafoneLabsError("Nothing to update — pass name, goal, agentId, emailSubject, emailBody, cadence, or settings");
+        }
+        return this.sm.requestAccountApi("PUT", `/api/v1/campaigns/${encodeURIComponent(campaignId)}`, payload);
+    }
+    /** Add consented leads: [{name, phone, email, outreach_consent: "yes"}]. */
+    addRecipients(campaignId, recipients) {
+        if (!Array.isArray(recipients) || !recipients.length) {
+            throw new SupafoneLabsError("recipients must be a non-empty array of lead rows");
+        }
+        return this.sm.requestAccountApi("POST", `/api/v1/campaigns/${encodeURIComponent(campaignId)}/recipients`, { recipients });
+    }
+    recipients(campaignId) {
+        return this.sm.requestAccountApi("GET", `/api/v1/campaigns/${encodeURIComponent(campaignId)}/recipients`);
+    }
+    /** Starts REAL calls/emails on the cadence immediately. */
+    launch(campaignId) {
+        return this.sm.requestAccountApi("POST", `/api/v1/campaigns/${encodeURIComponent(campaignId)}/launch`, {});
+    }
+    pause(campaignId) {
+        return this.sm.requestAccountApi("POST", `/api/v1/campaigns/${encodeURIComponent(campaignId)}/pause`, {});
+    }
+    /** Built-in playbooks + the account's saved custom presets. */
+    async presets() {
+        const builtIn = await this.sm.requestAccountApi("GET", "/api/v1/campaigns/outbound-presets");
+        let custom = [];
+        try {
+            const mine = await this.sm.requestAccountApi("GET", "/api/v1/campaigns/custom-presets");
+            custom = mine.presets ?? [];
+        }
+        catch {
+            /* custom presets need account scope — built-ins still return */
+        }
+        return { built_in: builtIn.presets ?? [], custom };
+    }
+    /** Materialize a preset (goal, questions, scripts, signing doc) in one write. */
+    applyPreset(campaignId, presetId) {
+        return this.sm.requestAccountApi("POST", `/api/v1/campaigns/${encodeURIComponent(campaignId)}/apply-preset`, {
+            preset_id: presetId,
+        });
+    }
+    stats(campaignId) {
+        return this.sm.requestAccountApi("GET", `/api/v1/campaigns/${encodeURIComponent(campaignId)}/stats`);
+    }
+    /** The live funnel + the campaign's most recent calls (newest first). */
+    activity(campaignId) {
+        return this.sm.requestAccountApi("GET", `/api/v1/campaigns/${encodeURIComponent(campaignId)}/activity`);
+    }
+    /**
+     * In-flight calls right now, each with a portal link to watch/listen. Poll
+     * getCall(callId) (or open the link) for the transcript as it grows.
+     */
+    async live(campaignId) {
+        const activity = await this.activity(campaignId);
+        const inFlight = [];
+        for (const call of activity.calls ?? []) {
+            const status = String(call.status ?? "");
+            if (status === "initiated" || status === "dialing" || status === "in_progress") {
+                const id = String(call.id ?? "");
+                inFlight.push({
+                    ...call,
+                    id,
+                    status,
+                    listen_url: `${this.sm.appUrl}/app/calls?call=${encodeURIComponent(id)}`,
+                });
+            }
+        }
+        return {
+            campaign_id: campaignId,
+            in_flight: inFlight,
+            portal_url: `${this.sm.appUrl}/app/developer?campaign=${encodeURIComponent(campaignId)}`,
+            stats: activity.stats ?? null,
+        };
+    }
+    /** One call — while in_progress the transcript grows on each poll. */
+    getCall(callId) {
+        return this.sm.requestAccountApi("GET", `/api/v1/calls/${encodeURIComponent(callId)}`);
+    }
+    /** Mint a recipient's tracked tap-to-sign link (inherits the campaign's signing PDF). */
+    createSignLink(campaignId, recipientId, opts = {}) {
+        return this.sm.requestAccountApi("POST", `/api/v1/campaigns/${encodeURIComponent(campaignId)}/recipients/${encodeURIComponent(recipientId)}/sign-link`, compact({ title: opts.title, message: opts.message }));
+    }
+}
 class LabsNamespace {
     sm;
     agents;
@@ -293,6 +561,9 @@ class LabsNamespace {
     voices;
     phoneNumbers;
     telephony;
+    calls;
+    recordings;
+    transcripts;
     constructor(sm) {
         this.sm = sm;
         this.agents = new LabsAgentsNamespace(sm);
@@ -301,6 +572,9 @@ 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() {
@@ -396,6 +670,18 @@ class LabsAgentsNamespace {
         const suffix = q.toString() ? `?${q}` : "";
         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 {
     sm;
@@ -431,6 +717,75 @@ class LabsVoicesNamespace {
         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 {
     sm;
     constructor(sm) {
@@ -461,6 +816,27 @@ class LabsPhoneNumbersNamespace {
     assign(numberId, 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
      * it to the supplied agent. This is the zero-Twilio-account happy path.
@@ -578,17 +954,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 +982,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 +1023,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 +1059,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 +1076,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 +1180,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 +1212,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 +1278,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 +1354,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 +1382,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);