supafone-labs 0.4.10 → 0.4.13

package/dist/index.js

@@ -35,6 +35,108 @@ const COACH_SYSTEM = "You are the coaching core of a second mind for a live voic
     "conversation and return ONE short, silent directive the agent reads but never " +
     "speaks aloud — a correction or nudge, phrased imperatively. If nothing needs " +
     "correcting, return an empty string.";
+const STRUCTURED_COACH_SYSTEM = "You are the coaching core of a second mind for a live voice agent. Read the " +
+    "conversation and return ONLY one JSON object with exactly these keys: " +
+    "empathy_directive (string), tactical_directive (string), surface_facts (string[]), " +
+    "guardrails (string[]), language (short code), confidence (0-1), and kind " +
+    "(empathy, tactical, guardrail, or mixed). Be silent with low confidence when evidence is weak.";
+function boundedInteger(value, fallback, minimum, maximum) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed)
+        ? Math.max(minimum, Math.min(maximum, Math.trunc(parsed)))
+        : fallback;
+}
+function textControl(input) {
+    return {
+        enabled: input?.enabled ?? true,
+        instructions: String(input?.instructions ?? "").trim(),
+        max_chars: boundedInteger(input?.max_chars ?? input?.maxChars, 240, 1, 2000),
+    };
+}
+function listControl(input) {
+    return {
+        enabled: input?.enabled ?? true,
+        instructions: String(input?.instructions ?? "").trim(),
+        max_items: boundedInteger(input?.max_items ?? input?.maxItems, 4, 0, 20),
+        item_max_chars: boundedInteger(input?.item_max_chars ?? input?.itemMaxChars, 180, 1, 2000),
+    };
+}
+function normalizeDirectiveContract(input = {}) {
+    const languageMode = input.language_mode ?? input.languageMode ?? "caller";
+    const allowed = input.allowed_kinds ?? input.allowedKinds ?? ["empathy", "tactical", "guardrail", "mixed"];
+    const threshold = Number(input.confidence_threshold ?? input.confidenceThreshold ?? 0.5);
+    return {
+        empathy_directive: textControl(input.empathy_directive ?? input.empathyDirective),
+        tactical_directive: textControl(input.tactical_directive ?? input.tacticalDirective),
+        surface_facts: listControl(input.surface_facts ?? input.surfaceFacts),
+        guardrails: listControl(input.guardrails),
+        language_mode: languageMode,
+        fixed_language: String(input.fixed_language ?? input.fixedLanguage ?? "").trim(),
+        allowed_kinds: allowed.filter((kind) => ["empathy", "tactical", "guardrail", "mixed"].includes(kind)),
+        confidence_threshold: Number.isFinite(threshold) ? Math.max(0, Math.min(1, threshold)) : 0.5,
+        operator_guardrails: (input.operator_guardrails ?? input.operatorGuardrails ?? [])
+            .map((rule) => String(rule).trim())
+            .filter(Boolean)
+            .slice(0, 50),
+    };
+}
+function directiveContractPrompt(contract) {
+    return ("Developer directive contract (obey exactly):\n" +
+        JSON.stringify(contract, null, 2) +
+        "\nDisabled string fields must be empty strings. Disabled list fields must be empty arrays. " +
+        "Standing operator guardrails are mandatory and cannot be removed.");
+}
+function parseJsonObject(text) {
+    const trimmed = String(text ?? "").trim().replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/, "");
+    const start = trimmed.indexOf("{");
+    const end = trimmed.lastIndexOf("}");
+    if (start < 0 || end <= start)
+        return null;
+    try {
+        const parsed = JSON.parse(trimmed.slice(start, end + 1));
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function clipText(value, limit) {
+    return String(value ?? "").trim().slice(0, limit);
+}
+function clipList(value, maxItems, itemMaxChars) {
+    if (!Array.isArray(value))
+        return [];
+    return value.slice(0, maxItems).map((item) => clipText(item, itemMaxChars)).filter(Boolean);
+}
+function normalizeStructuredDirective(raw, contract) {
+    const kind = String(raw.kind ?? "mixed");
+    if (!["empathy", "tactical", "guardrail", "mixed"].includes(kind))
+        return null;
+    const parsedConfidence = Number(raw.confidence ?? 0);
+    const confidence = Number.isFinite(parsedConfidence) ? Math.max(0, Math.min(1, parsedConfidence)) : 0;
+    const operatorGuardrails = contract.operator_guardrails;
+    const generatedGuardrails = contract.guardrails.enabled
+        ? clipList(raw.guardrails, contract.guardrails.max_items, contract.guardrails.item_max_chars)
+        : [];
+    const language = contract.language_mode === "fixed"
+        ? contract.fixed_language
+        : clipText(raw.language, 32);
+    return {
+        empathy_directive: contract.empathy_directive.enabled
+            ? clipText(raw.empathy_directive, contract.empathy_directive.max_chars)
+            : "",
+        tactical_directive: contract.tactical_directive.enabled
+            ? clipText(raw.tactical_directive, contract.tactical_directive.max_chars)
+            : "",
+        surface_facts: contract.surface_facts.enabled
+            ? clipList(raw.surface_facts, contract.surface_facts.max_items, contract.surface_facts.item_max_chars)
+            : [],
+        guardrails: [...new Set([...generatedGuardrails, ...operatorGuardrails])],
+        language,
+        confidence: contract.allowed_kinds.includes(kind) ? confidence : 0,
+        kind,
+    };
+}
 export class SupafoneLabs {
     baseUrl;
     supafoneApiBaseUrl;
@@ -89,6 +191,13 @@ export class SupafoneLabs {
         this.optimizer = new OptimizerNamespace(this);
         this.campaigns = new CampaignsNamespace(this);
     }
+    /** Build a complete hosted plan with the same Supafone key used to create agents. */
+    generateCallStages(input) {
+        return this.labs.agents.plan(input);
+    }
+    generate_call_stages(input) {
+        return this.generateCallStages(input);
+    }
     /** True once login() (or a passed sessionToken) is in effect. */
     get isLoggedIn() {
         return !!this.sessionToken;
@@ -150,6 +259,31 @@ export class SupafoneLabs {
             clearTimeout(timer);
         }
     }
+    /** @internal Authenticated binary request to the Supafone app API. */
+    async requestSupafoneBinary(path) {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(this.supafoneApiBaseUrl + path, {
+                method: "GET",
+                signal: ctrl.signal,
+                headers: { Authorization: `Bearer ${this.supafoneApiKey}` },
+            });
+            if (!res.ok) {
+                const text = await res.text();
+                const parsed = text ? safeJson(text) : {};
+                const detail = parsed?.detail ?? text ?? `HTTP ${res.status}`;
+                throw new SupafoneLabsError(`GET ${path}: ${detail}`, res.status, parsed);
+            }
+            return {
+                content: await res.arrayBuffer(),
+                mediaType: res.headers.get("content-type") || "application/octet-stream",
+            };
+        }
+        finally {
+            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
@@ -338,6 +472,43 @@ export class SupafoneLabs {
         });
         return out.text.trim();
     }
+    /**
+     * Structured SecondMind guidance with developer-controlled field policy.
+     * Returns null when JSON is invalid, evidence misses the confidence gate,
+     * the generated kind is disallowed, or the local transform suppresses it.
+     */
+    async whisperStructured(transcript, opts = {}) {
+        const contract = normalizeDirectiveContract(opts.directive_contract ?? opts.directiveContract ?? {});
+        const operatorRules = [opts.guardrails, ...contract.operator_guardrails]
+            .map((rule) => String(rule ?? "").trim())
+            .filter(Boolean);
+        const system = [
+            STRUCTURED_COACH_SYSTEM,
+            directiveContractPrompt(contract),
+            operatorRules.length ? `Operator rules:\n${operatorRules.join("\n")}` : "",
+        ].filter(Boolean).join("\n\n");
+        const out = await this.oracle({
+            model: opts.model,
+            maxTokens: opts.maxTokens ?? 320,
+            ...(opts.temperature !== undefined ? { temperature: opts.temperature } : {}),
+            messages: [
+                { role: "system", content: system },
+                { role: "user", content: transcript },
+            ],
+        });
+        const parsed = parseJsonObject(out.text);
+        let directive = parsed ? normalizeStructuredDirective(parsed, contract) : null;
+        if (directive && opts.transform) {
+            directive = await opts.transform(directive);
+        }
+        if (!directive || directive.confidence < contract.confidence_threshold)
+            return null;
+        return directive;
+    }
+    /** Alias that reads naturally in applications building their own watcher loop. */
+    directive(transcript, opts = {}) {
+        return this.whisperStructured(transcript, opts);
+    }
     /** Hosted TTS — returns raw audio bytes (WAV/PCM per voice). */
     async tts(text, voice = "supafone-labs-calm-en") {
         const ctrl = new AbortController();
@@ -766,23 +937,31 @@ class CampaignsNamespace {
 class LabsNamespace {
     sm;
     agents;
+    billing;
     presets;
     tools;
     voices;
+    runtime;
     phoneNumbers;
     telephony;
     calls;
+    activity;
+    plans;
     recordings;
     transcripts;
     constructor(sm) {
         this.sm = sm;
         this.agents = new LabsAgentsNamespace(sm);
+        this.billing = new LabsBillingNamespace(sm);
         this.presets = new LabsPresetsNamespace(sm);
         this.tools = new LabsToolsNamespace(sm);
         this.voices = new LabsVoicesNamespace(sm);
+        this.runtime = new LabsRuntimeNamespace(sm);
         this.phoneNumbers = new LabsPhoneNumbersNamespace(sm);
         this.telephony = new LabsTelephonyNamespace(sm);
         this.calls = new LabsCallsNamespace(sm);
+        this.activity = new LabsActivityNamespace(sm);
+        this.plans = new LabsPlansNamespace(sm);
         this.recordings = new LabsRecordingsNamespace(sm);
         this.transcripts = new LabsTranscriptsNamespace(sm);
     }
@@ -791,6 +970,38 @@ class LabsNamespace {
         return this.sm.requestSupafoneApi("GET", "/api/v1/labs/capabilities");
     }
 }
+class LabsBillingNamespace {
+    sm;
+    constructor(sm) {
+        this.sm = sm;
+    }
+    /** Start hosted Stripe Checkout. MCP callers should render checkout_url as a link. */
+    checkout(input = {}) {
+        return this.sm.request("POST", "/v1/billing/checkout", compact({
+            kind: input.kind ?? "plan",
+            plan_key: input.plan_key ?? input.planKey,
+            number_strategy: input.number_strategy ?? input.numberStrategy,
+            phone_number: input.phone_number ?? input.phoneNumber,
+            quantity: input.quantity,
+            success_url: input.success_url ?? input.successUrl,
+            cancel_url: input.cancel_url ?? input.cancelUrl,
+        }));
+    }
+    status(checkoutSessionId) {
+        if (!checkoutSessionId?.trim())
+            throw new SupafoneLabsError("checkoutSessionId is required");
+        return this.sm.request("GET", `/v1/billing/checkout/${encodeURIComponent(checkoutSessionId)}`);
+    }
+    portal() {
+        return this.sm.request("POST", "/v1/billing/portal", {});
+    }
+    createCheckout(input = {}) {
+        return this.checkout(input);
+    }
+    getCheckout(checkoutSessionId) {
+        return this.status(checkoutSessionId);
+    }
+}
 class LabsAgentsNamespace {
     sm;
     constructor(sm) {
@@ -800,6 +1011,13 @@ class LabsAgentsNamespace {
     create(input) {
         return this.sm.requestSupafoneApi("POST", "/api/v1/labs/agents", labsAgentPayload(this.withVoiceWatcher(input)));
     }
+    /** Preview the exact validated call-plan contract the Supafone runtime executes. */
+    plan(input) {
+        return this.sm.requestSupafoneApi("POST", "/api/v1/labs/agent-plans", stagePlanPayload(input));
+    }
+    generateCallStages(input) {
+        return this.plan(input);
+    }
     /** Default the agent onto the client's Voice Watcher setting (live supervision
      * + QA + scoring) unless the caller set it explicitly; mirror into
      * labs.voice_watcher when a labs block exists. Never overwrites a caller value. */
@@ -932,14 +1150,138 @@ class LabsVoicesNamespace {
     constructor(sm) {
         this.sm = sm;
     }
-    /** Supafone-managed Cartesia voices. Other TTS engines remain explicit BYOK choices. */
+    /** Live normalized catalog from every connected/managed TTS provider. */
     list(opts = {}) {
         const q = new URLSearchParams();
         if (opts.provider)
             q.set("provider", opts.provider);
+        if (opts.search)
+            q.set("search", opts.search);
+        if (opts.language)
+            q.set("language", opts.language);
+        const compatibleLanguage = opts.compatible_language ?? opts.compatibleLanguage;
+        if (compatibleLanguage)
+            q.set("compatible_language", compatibleLanguage);
+        if (opts.gender)
+            q.set("gender", opts.gender);
+        const voiceType = opts.voice_type ?? opts.voiceType;
+        if (voiceType)
+            q.set("voice_type", voiceType);
+        if (opts.model)
+            q.set("model", opts.model);
+        const runtimeProvider = opts.runtime_provider ?? opts.runtimeProvider;
+        if (runtimeProvider)
+            q.set("runtime_provider", runtimeProvider);
+        const configuredOnly = opts.configured_only ?? opts.configuredOnly;
+        if (configuredOnly !== undefined)
+            q.set("configured_only", String(configuredOnly));
+        if (opts.cursor !== undefined)
+            q.set("cursor", String(opts.cursor));
+        if (opts.limit !== undefined)
+            q.set("limit", String(opts.limit));
+        const agencyId = opts.agency_id ?? opts.agencyId;
+        if (agencyId)
+            q.set("agency_id", agencyId);
         const suffix = q.toString() ? `?${q}` : "";
         return this.sm.requestSupafoneApi("GET", `/api/v1/labs/voices${suffix}`);
     }
+    /** Provider/model language limits and their Ultravox-compatible intersection. */
+    capabilities() {
+        return this.sm.requestSupafoneApi("GET", "/api/v1/labs/voices/capabilities");
+    }
+    /** Page through the complete normalized catalog. */
+    async listAll(opts = {}) {
+        const pageSize = Math.max(1, Math.min(opts.pageSize ?? 250, 250));
+        const maxPages = Math.max(1, opts.maxPages ?? 100);
+        let cursor = 0;
+        let pages = 0;
+        let first;
+        const voices = [];
+        const seen = new Set();
+        while (cursor !== null && pages < maxPages) {
+            if (seen.has(cursor))
+                throw new SupafoneLabsError("Voice catalog returned a repeated cursor");
+            seen.add(cursor);
+            const page = await this.list({ ...opts, cursor, limit: pageSize });
+            first ??= page;
+            voices.push(...page.voices);
+            cursor = page.next_cursor ?? null;
+            pages += 1;
+        }
+        if (cursor !== null) {
+            throw new SupafoneLabsError(`Voice catalog exceeded maxPages=${maxPages}`);
+        }
+        return {
+            ...(first ?? { total: 0, providers: [] }),
+            voices,
+            total: first?.total ?? voices.length,
+            cursor: 0,
+            next_cursor: null,
+        };
+    }
+    /** Rank real current voices from a plain-language description. */
+    recommend(opts) {
+        if (!opts.description?.trim()) {
+            throw new SupafoneLabsError("description is required — describe the voice you want");
+        }
+        return this.sm.requestSupafoneApi("POST", "/api/v1/labs/voices/recommend", compact({
+            agency_id: opts.agency_id ?? opts.agencyId,
+            description: opts.description.trim(),
+            language: opts.language,
+            provider: opts.provider,
+            gender: opts.gender,
+            voice_type: opts.voice_type ?? opts.voiceType,
+            model: opts.model,
+            configured_only: opts.configured_only ?? opts.configuredOnly,
+            premium: opts.premium,
+            limit: opts.limit,
+        }));
+    }
+    /** Download an authenticated voice preview. */
+    preview(voiceId, opts = {}) {
+        if (!voiceId.trim())
+            throw new SupafoneLabsError("voiceId is required");
+        const q = new URLSearchParams({ voice: voiceId.trim() });
+        const agencyId = opts.agency_id ?? opts.agencyId;
+        if (agencyId)
+            q.set("agency_id", agencyId);
+        return this.sm.requestSupafoneBinary(`/api/v1/labs/voices/preview?${q}`);
+    }
+    /** Convert a catalog row into the exact Agent Factory voice field. */
+    selection(voice) {
+        if (!voice?.id)
+            throw new SupafoneLabsError("A catalog voice with id is required");
+        return compact({
+            provider: voice.provider_key || voice.source,
+            voiceId: voice.id,
+            model: voice.model || undefined,
+        });
+    }
+}
+class LabsRuntimeNamespace {
+    sm;
+    constructor(sm) {
+        this.sm = sm;
+    }
+    get(opts = {}) {
+        const q = new URLSearchParams();
+        const agencyId = opts.agency_id ?? opts.agencyId;
+        if (agencyId)
+            q.set("agency_id", agencyId);
+        const suffix = q.toString() ? `?${q}` : "";
+        return this.sm.requestSupafoneApi("GET", `/api/v1/labs/runtime${suffix}`);
+    }
+    configure(input) {
+        const credentials = input.credentials ?? {};
+        return this.sm.requestSupafoneApi("PUT", "/api/v1/labs/runtime", compact({
+            agency_id: input.agency_id ?? input.agencyId,
+            provider: input.provider ?? "ultravox",
+            credentials: compact({
+                api_key: credentials.api_key ?? credentials.apiKey,
+                base_url: credentials.base_url ?? credentials.baseUrl,
+            }),
+        }));
+    }
 }
 class LabsCallsNamespace {
     sm;
@@ -953,11 +1295,61 @@ class LabsCallsNamespace {
     }
     get(callId, opts = {}) {
         const q = new URLSearchParams();
-        if (opts.agencyId)
-            q.set("agency_id", opts.agencyId);
+        const agencyId = opts.agency_id ?? opts.agencyId;
+        if (agencyId)
+            q.set("agency_id", agencyId);
         const suffix = q.toString() ? `?${q}` : "";
         return this.sm.requestSupafoneApi("GET", `/api/v1/labs/calls/${encodeURIComponent(callId)}${suffix}`);
     }
+    delete(callId, opts = {}) {
+        const q = new URLSearchParams();
+        const agencyId = opts.agency_id ?? opts.agencyId;
+        if (agencyId)
+            q.set("agency_id", agencyId);
+        const suffix = q.toString() ? `?${q}` : "";
+        return this.sm.requestSupafoneApi("DELETE", `/api/v1/labs/calls/${encodeURIComponent(callId)}${suffix}`);
+    }
+}
+class LabsActivityNamespace {
+    sm;
+    constructor(sm) {
+        this.sm = sm;
+    }
+    list(opts = {}) {
+        const q = new URLSearchParams();
+        const accountId = opts.account_id ?? opts.accountId ?? opts.agency_id ?? opts.agencyId;
+        if (accountId)
+            q.set("account_id", accountId);
+        const eventType = opts.event_type ?? opts.eventType;
+        if (eventType)
+            q.set("event_type", eventType);
+        const resourceType = opts.resource_type ?? opts.resourceType;
+        if (resourceType)
+            q.set("resource_type", resourceType);
+        const resourceId = opts.resource_id ?? opts.resourceId;
+        if (resourceId)
+            q.set("resource_id", resourceId);
+        if (opts.limit !== undefined)
+            q.set("limit", String(opts.limit));
+        if (opts.offset !== undefined)
+            q.set("offset", String(opts.offset));
+        const suffix = q.toString() ? `?${q}` : "";
+        return this.sm.requestSupafoneApi("GET", `/api/v1/labs/activity${suffix}`);
+    }
+}
+class LabsPlansNamespace {
+    sm;
+    constructor(sm) {
+        this.sm = sm;
+    }
+    list(opts = {}) {
+        const activity = new LabsActivityNamespace(this.sm);
+        return activity.list({
+            ...opts,
+            eventType: "studio.plan.created",
+            resourceType: "studio_plan",
+        });
+    }
 }
 class LabsRecordingsNamespace {
     sm;
@@ -1029,10 +1421,27 @@ class LabsPhoneNumbersNamespace {
     search(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 a managed number. Paid strategies return a hosted Checkout link first;
+     * call again with billingCheckoutSessionId after Checkout reports paid.
+     */
     buy(input) {
+        const strategy = input.number_strategy ?? input.numberStrategy ?? (input.premium ? "premium" : "default_pool");
+        const checkoutSessionId = input.billing_checkout_session_id ?? input.billingCheckoutSessionId;
+        if ((strategy === "dedicated" || strategy === "premium") && !checkoutSessionId) {
+            const phoneNumber = input.phone_number ?? input.phoneNumber;
+            if (!phoneNumber) {
+                return Promise.reject(new SupafoneLabsError("phoneNumber is required before starting number Checkout"));
+            }
+            return this.sm.labs.billing.checkout({
+                kind: "number_addon",
+                numberStrategy: strategy,
+                phoneNumber,
+            });
+        }
         return this.sm.requestSupafoneApi("POST", "/api/v1/labs/phone-numbers", phoneNumberProvisionPayload({
             ...input,
+            numberStrategy: strategy,
             telephony: input.telephony ?? { mode: "supafone_managed", provider: "supafone" },
         }));
     }
@@ -1249,12 +1658,14 @@ class OptimizerNamespace {
     }
 }
 function labsAgentPayload(input) {
+    const fixedLanguage = input.preferred_language ?? input.preferredLanguage ?? input.language;
     return compact({
         agency_id: input.agency_id ?? input.agencyId,
         agent_key: input.agent_key ?? input.agentKey,
         agent_type: input.agent_type ?? input.agentType,
         style: input.agent_style ?? input.agentStyle ?? input.style,
         name: input.name,
+        description: input.description,
         assistant_name: input.assistant_name ?? input.assistantName,
         business_name: input.business_name ?? input.businessName,
         industry: input.industry,
@@ -1267,11 +1678,15 @@ function labsAgentPayload(input) {
         preset_key: input.preset_key ?? input.presetKey,
         runtime_mode: input.runtime_mode ?? input.runtimeMode,
         call_stages: callStagesPayload(input),
+        stage_generation: input.stage_generation ?? input.stageGeneration,
+        stage_count: input.stage_count ?? input.stageCount,
+        stage_detail: input.stage_detail ?? input.stageDetail,
         goal: input.goal,
         greeting: input.greeting,
         system_prompt: input.system_prompt ?? input.systemPrompt,
-        language: input.language,
+        language: fixedLanguage,
         voice: input.voice ? voicePayload(input.voice) : undefined,
+        voice_preference: voicePreferencePayload(input.voice_preference ?? input.voicePreference, fixedLanguage),
         provider_keys: input.provider_keys ?? (input.providerKeys ? providerKeysPayload(input.providerKeys) : undefined),
         byok: input.byok ? byokPayload(input.byok) : undefined,
         telephony: input.telephony ? telephonyPayload(input.telephony) : undefined,
@@ -1290,13 +1705,16 @@ function labsAgentPayload(input) {
 }
 function hostedListQuery(opts) {
     const q = new URLSearchParams();
-    if (opts.agencyId)
-        q.set("agency_id", opts.agencyId);
+    const agencyId = opts.agency_id ?? opts.agencyId;
+    if (agencyId)
+        q.set("agency_id", 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));
+    if (opts.offset !== undefined)
+        q.set("offset", String(opts.offset));
     return q;
 }
 function telephonyPayload(input) {
@@ -1368,6 +1786,7 @@ function phoneNumberProvisionPayload(input) {
         number_strategy: input.number_strategy ?? input.numberStrategy,
         number_pool: input.number_pool ?? input.numberPool,
         premium: input.premium,
+        billing_checkout_session_id: input.billing_checkout_session_id ?? input.billingCheckoutSessionId,
         style: input.agent_style ?? input.agentStyle ?? input.style,
         direction: input.direction,
         telephony: input.telephony ? telephonyPayload(input.telephony) : undefined,
@@ -1405,8 +1824,31 @@ function callStagesPayload(input) {
     if (Array.isArray(explicit))
         return explicit.map(callStagePayload);
     if (explicit === false || auto === false)
-        return undefined;
-    return generateCallStages(input).map(callStagePayload);
+        return false;
+    if (explicit === "oracle" || explicit === "template" || explicit === "off")
+        return explicit;
+    // Omitted means the private Supafone API generates and compiles the plan.
+    return undefined;
+}
+function stagePlanPayload(input) {
+    return compact({
+        agency_id: input.agency_id ?? input.agencyId,
+        description: input.description,
+        name: input.name,
+        assistant_name: input.assistant_name ?? input.assistantName,
+        business_name: input.business_name ?? input.businessName,
+        industry: input.industry,
+        direction: input.direction ?? input.agent_style ?? input.agentStyle ?? input.style,
+        goal: input.goal,
+        system_prompt: input.system_prompt ?? input.systemPrompt,
+        tools: input.tools ? toolsPayload(input.tools) : undefined,
+        call_stages: Array.isArray(input.call_stages ?? input.callStages ?? input.stages)
+            ? (input.call_stages ?? input.callStages ?? input.stages)
+            : undefined,
+        stage_generation: input.stage_generation ?? input.stageGeneration,
+        stage_count: input.stage_count ?? input.stageCount,
+        stage_detail: input.stage_detail ?? input.stageDetail,
+    });
 }
 function callStagePayload(input) {
     return compact({
@@ -1416,10 +1858,14 @@ function callStagePayload(input) {
         instructions: input.instructions,
         exit_criteria: input.exit_criteria ?? input.exitCriteria,
         tools: input.tools,
+        temperature: input.temperature,
+        next_stages: input.next_stages ?? input.nextStages,
         metadata: input.metadata,
     });
 }
 export function generateCallStages(input) {
+    // Offline compatibility template. New code should use
+    // client.generateCallStages(...) for the hosted, executable plan.
     const direction = String(input.direction ?? input.agent_style ?? input.agentStyle ?? input.style ?? "inbound").toLowerCase();
     const haystack = [
         input.name,
@@ -1482,6 +1928,20 @@ function voicePayload(input) {
         model: input.model,
     });
 }
+function voicePreferencePayload(input, defaultLanguage) {
+    if (!input)
+        return undefined;
+    return compact({
+        description: input.description,
+        language: input.language ?? defaultLanguage,
+        provider: input.provider,
+        gender: input.gender,
+        voice_type: input.voice_type ?? input.voiceType,
+        model: input.model,
+        configured_only: input.configured_only ?? input.configuredOnly,
+        premium: input.premium,
+    });
+}
 function providerKeysPayload(input) {
     return compact({
         ultravox: input.ultravox,