supafone-labs 0.5.4 → 0.6.0

package/dist/cjs/index.js

@@ -5,7 +5,7 @@
  * A dependency-free TypeScript client for creating hosted Supafone agents
  * through the Supafone API, including managed phone numbers, voices, stages,
  * tools, recordings, transcripts, widgets, and Supafone Supervisor. It also
- * includes the Labs cloud sidecar oracle, hosted TTS/STT, live multilingual
+ * includes Supafone Supervisor, hosted TTS/STT, live multilingual
  * transcription, telemetry, agent builder, and objective-driven optimizer.
  *
  * Works in Node 18+ (native fetch/WebSocket) and the browser.
@@ -157,6 +157,19 @@ class SupafoneLabsError extends Error {
     }
 }
 exports.SupafoneLabsError = SupafoneLabsError;
+function errorDetailMessage(detail, fallback) {
+    if (detail && typeof detail === "object" && !Array.isArray(detail)) {
+        const value = detail;
+        for (const key of ["message", "detail", "error", "code"]) {
+            const candidate = value[key];
+            if (typeof candidate === "string" && candidate.trim())
+                return candidate.trim();
+        }
+    }
+    if (typeof detail === "string" && detail.trim())
+        return detail.trim();
+    return fallback;
+}
 const DEFAULT_BASE = "https://api.labs.supafone.ai";
 const DEFAULT_SUPAFONE_API_BASE = "https://api.supafone.ai";
 const COACH_SYSTEM = "You are the coaching core of a supervisor for a live voice agent. Read the " +
@@ -358,8 +371,8 @@ class SupafoneLabs {
             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);
+                const detail = parsed?.detail ?? text;
+                throw new SupafoneLabsError(`${method} ${path}: ${errorDetailMessage(detail, `HTTP ${res.status}`)}`, res.status, parsed);
             }
             return parsed;
         }
@@ -381,8 +394,8 @@ class SupafoneLabs {
             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);
+                const detail = parsed?.detail ?? text;
+                throw new SupafoneLabsError(`${method} ${path}: ${errorDetailMessage(detail, `HTTP ${res.status}`)}`, res.status, parsed);
             }
             return parsed;
         }
@@ -408,8 +421,8 @@ class SupafoneLabs {
             const text = await res.text();
             const parsed = text ? safeJson(text) : {};
             if (!res.ok) {
-                const detail = parsed?.detail ?? text ?? `HTTP ${res.status}`;
-                throw new SupafoneLabsError(`POST ${path}: ${detail}`, res.status, parsed);
+                const detail = parsed?.detail ?? text;
+                throw new SupafoneLabsError(`POST ${path}: ${errorDetailMessage(detail, `HTTP ${res.status}`)}`, res.status, parsed);
             }
             return parsed;
         }
@@ -430,8 +443,8 @@ class SupafoneLabs {
             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);
+                const detail = parsed?.detail ?? text;
+                throw new SupafoneLabsError(`GET ${path}: ${errorDetailMessage(detail, `HTTP ${res.status}`)}`, res.status, parsed);
             }
             return {
                 content: await res.arrayBuffer(),
@@ -494,8 +507,8 @@ class SupafoneLabs {
             const text = await res.text();
             const parsed = text ? safeJson(text) : {};
             if (!res.ok) {
-                const detail = parsed?.detail ?? text ?? `HTTP ${res.status}`;
-                throw new SupafoneLabsError(`POST ${path}: ${detail}`, res.status, parsed);
+                const detail = parsed?.detail ?? text;
+                throw new SupafoneLabsError(`POST ${path}: ${errorDetailMessage(detail, `HTTP ${res.status}`)}`, res.status, parsed);
             }
             return parsed;
         };
@@ -528,8 +541,8 @@ class SupafoneLabs {
             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);
+                const detail = parsed?.detail ?? text;
+                throw new SupafoneLabsError(`${method} ${path}: ${errorDetailMessage(detail, `HTTP ${res.status}`)}`, res.status, parsed);
             }
             return parsed;
         }
@@ -604,22 +617,26 @@ class SupafoneLabs {
         }
         return this.requestAccountApi("POST", "/api/v1/agents/generate-intake", payload);
     }
-    /** Raw oracle completion — full control over messages and model. */
-    async oracle(req) {
-        return this.request("POST", "/v1/oracle/complete", {
+    /** Raw Supervisor completion with either Supafone-managed or BYOK inference. */
+    async completeWithSupervisor(req) {
+        return this.request("POST", "/v1/supervisor/complete", {
             messages: req.messages,
-            model: req.model ?? "supafone-labs-oracle",
+            model: req.model ?? "supafone-supervisor",
             max_tokens: req.maxTokens ?? 256,
             ...(req.temperature !== undefined ? { temperature: req.temperature } : {}),
         });
     }
+    /** @deprecated Use completeWithSupervisor(). */
+    async oracle(req) {
+        return this.completeWithSupervisor(req);
+    }
     /**
      * The one-liner: hand it the running transcript, get back a silent directive
      * (empty string when the agent is doing fine).
      */
     async whisper(transcript, opts = {}) {
         const system = opts.guardrails ? `${COACH_SYSTEM}\n\nOperator rules:\n${opts.guardrails}` : COACH_SYSTEM;
-        const out = await this.oracle({
+        const out = await this.completeWithSupervisor({
             model: opts.model,
             maxTokens: opts.maxTokens ?? 120,
             ...(opts.temperature !== undefined ? { temperature: opts.temperature } : {}),
@@ -645,7 +662,7 @@ class SupafoneLabs {
             directiveContractPrompt(contract),
             operatorRules.length ? `Operator rules:\n${operatorRules.join("\n")}` : "",
         ].filter(Boolean).join("\n\n");
-        const out = await this.oracle({
+        const out = await this.completeWithSupervisor({
             model: opts.model,
             maxTokens: opts.maxTokens ?? 320,
             ...(opts.temperature !== undefined ? { temperature: opts.temperature } : {}),
@@ -728,7 +745,7 @@ class SupafoneLabs {
     balance() {
         return this.request("GET", "/v1/billing/balance");
     }
-    /** Today's usage against your plan caps (oracle/tts/stt/…). */
+    /** Today's usage across Supervisor, TTS, STT, and managed runtime meters. */
     usage() {
         return this.request("GET", "/v1/usage");
     }
@@ -795,7 +812,7 @@ class SupafoneLabs {
      *
      * With `postCallAnalysis: true` on the client and a transcript (or
      * messages) present, the call is automatically classified first: the
-     * oracle labels it against the agent's objective (achieved/missed,
+     * Supervisor labels it against the agent's objective (achieved/missed,
      * per-criterion verdicts, failure reasons) and files the enriched report
      * server-side. The generated labels come back on `analysis`. Analysis is
      * best-effort — on any failure the plain zero-billed report still lands.
@@ -828,7 +845,7 @@ class SupafoneLabs {
      * objective and get labels back — achieved/missed, per-criterion verdicts,
      * failure reasons, and the blended objective value. Files an enriched call
      * report server-side (feeding optimizer.improve() and objective stats).
-     * Billed one oracle call.
+     * Billed one Supervisor inference.
      */
     classifyCall(input) {
         return this.request("POST", "/v1/calls/classify", compact({
@@ -840,7 +857,7 @@ class SupafoneLabs {
             nudges: input.nudges,
         }));
     }
-    /** Available oracle model ids (live vendor catalog). */
+    /** Available managed and BYOK Supervisor model ids. */
     async models() {
         const d = await this.request("GET", "/v1/models");
         return d.models.map((m) => (typeof m === "string" ? m : m.id));
@@ -1145,6 +1162,10 @@ class LabsBillingNamespace {
     }
     /** Start hosted Stripe Checkout. MCP callers should render checkout_url as a link. */
     checkout(input = {}) {
+        const sku = input.sku ?? input.packageSku ?? input.package_sku;
+        if (sku) {
+            return this.sm.request("POST", "/v1/billing/checkout", { sku });
+        }
         return this.sm.request("POST", "/v1/billing/checkout", compact({
             kind: input.kind ?? "plan",
             plan_key: input.plan_key ?? input.planKey,
@@ -1155,6 +1176,12 @@ class LabsBillingNamespace {
             cancel_url: input.cancel_url ?? input.cancelUrl,
         }));
     }
+    /** Start Stripe Checkout for one prepaid managed-minute package. */
+    topUp(sku = "sf_voice_minutes_400_v1") {
+        if (!sku.trim())
+            return Promise.reject(new SupafoneLabsError("sku is required"));
+        return this.checkout({ sku });
+    }
     status(checkoutSessionId) {
         if (!checkoutSessionId?.trim())
             throw new SupafoneLabsError("checkoutSessionId is required");
@@ -1644,6 +1671,37 @@ class LabsPhoneNumbersNamespace {
         const suffix = q.toString() ? `?${q}` : "";
         return this.sm.requestSupafoneApi("GET", `/api/v1/labs/phone-numbers${suffix}`);
     }
+    /**
+     * Read the explicitly enrolled shared developer-number pool. This inventory
+     * never infers customer or merely-unassigned numbers into the response.
+     */
+    pool() {
+        return this.sm.requestSupafoneApi("GET", "/api/v1/labs/phone-numbers/pool");
+    }
+    /**
+     * Connect to realtime pool state using a short-lived pool-only token. The
+     * Supafone API key is never placed in the WebSocket URL.
+     */
+    async connectPool(opts = {}) {
+        const snapshot = await this.pool();
+        const stream = snapshot.stream;
+        if (!stream?.url || !stream.token) {
+            throw new SupafoneLabsError("Phone-pool response did not include stream metadata");
+        }
+        const WS = opts.WebSocketImpl ?? globalThis.WebSocket;
+        if (!WS) {
+            throw new SupafoneLabsError("No WebSocket available - pass opts.WebSocketImpl (for example, the ws package)");
+        }
+        const url = new URL(stream.url, `${this.sm.supafoneApiBaseUrl}/`);
+        url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+        url.searchParams.set("token", stream.token);
+        const socket = new WS(url.toString(), stream.protocol || "developer_phone_pool_v1");
+        await new Promise((resolve, reject) => {
+            socket.addEventListener("open", () => resolve(), { once: true });
+            socket.addEventListener("error", () => reject(new SupafoneLabsError("Could not connect to the phone-pool stream")), { once: true });
+        });
+        return socket;
+    }
     /** Search Supafone-managed inventory. This uses Supafone's master telephony account. */
     search(opts = {}) {
         return this.sm.requestSupafoneApi("POST", "/api/v1/labs/phone-numbers/search", phoneNumberSearchPayload(opts));
@@ -1702,21 +1760,31 @@ class LabsPhoneNumbersNamespace {
      * it to the supplied agent. This is the zero-Twilio-account happy path.
      */
     async buyAndAssign(input) {
+        const strategy = input.number_strategy ?? input.numberStrategy ?? (input.premium ? "premium" : "default_pool");
         let phoneNumber = input.phoneNumber ?? input.phone_number ?? "";
         if (!phoneNumber) {
-            const found = await this.search({
-                ...(input.search ?? {}),
-                agencyId: input.agencyId ?? input.agency_id ?? input.search?.agencyId,
-                limit: input.search?.limit ?? 1,
-            });
-            phoneNumber = found.numbers[0]?.phone_number ?? "";
+            if (strategy === "default_pool") {
+                const found = await this.pool();
+                const areaCode = String(input.search?.areaCode ?? input.search?.area_code ?? "");
+                phoneNumber = found.numbers.find((number) => number.available && (!areaCode || number.phone_number.startsWith(`+1${areaCode}`)))?.phone_number ?? "";
+            }
+            else {
+                const found = await this.search({
+                    ...(input.search ?? {}),
+                    agencyId: input.agencyId ?? input.agency_id ?? input.search?.agencyId,
+                    limit: input.search?.limit ?? 1,
+                });
+                phoneNumber = found.numbers[0]?.phone_number ?? "";
+            }
             if (!phoneNumber) {
-                throw new SupafoneLabsError("No Supafone-managed phone numbers matched the search");
+                const source = strategy === "default_pool" ? "shared developer" : "Supafone-managed";
+                throw new SupafoneLabsError(`No ${source} phone numbers matched the request`);
             }
         }
         return this.buy({
             ...input,
             phoneNumber,
+            numberStrategy: strategy,
             telephony: input.telephony ?? { mode: "supafone_managed", provider: "supafone" },
         });
     }
@@ -1974,6 +2042,7 @@ function campaignSettingsPayload(settings, mode) {
 }
 function labsAgentPayload(input) {
     const fixedLanguage = input.preferred_language ?? input.preferredLanguage ?? input.language;
+    const supervisor = input.supervisor;
     return compact({
         agency_id: input.agency_id ?? input.agencyId,
         agent_key: input.agent_key ?? input.agentKey,
@@ -2017,7 +2086,12 @@ function labsAgentPayload(input) {
         email: input.email ? emailPayload(input.email) : undefined,
         labs: input.labs ? labsPayload(input.labs) : undefined,
         ultravox: input.ultravox ? ultravoxPayload(input.ultravox) : undefined,
-        voice_watcher: input.supervisor ?? input.voice_watcher ?? input.voiceWatcher,
+        supervisor: supervisor && typeof supervisor === "object" ? supervisorPayload(supervisor) : undefined,
+        voice_watcher: typeof supervisor === "boolean"
+            ? supervisor
+            : supervisor && typeof supervisor === "object"
+                ? supervisor.enabled ?? true
+                : input.voice_watcher ?? input.voiceWatcher,
         voice_watcher_model: input.voice_watcher_model ?? input.voiceWatcherModel,
         metadata: labsAgentMetadataPayload(input),
     });
@@ -2144,8 +2218,10 @@ function callStagesPayload(input) {
         return explicit.map(callStagePayload);
     if (explicit === false || auto === false)
         return false;
-    if (explicit === "oracle" || explicit === "template" || explicit === "off")
+    if (explicit === "managed" || explicit === "template" || explicit === "off")
         return explicit;
+    if (explicit === "oracle")
+        return "managed";
     // Omitted means the private Supafone API generates and compiles the plan.
     return undefined;
 }
@@ -2427,9 +2503,19 @@ function artifactsPayload(input) {
     });
 }
 function labsPayload(input) {
+    const nestedSupervisor = input.supervisor && typeof input.supervisor === "object"
+        ? input.supervisor
+        : input.provider
+            ? input
+            : undefined;
     return compact({
         enabled: input.enabled,
-        voice_watcher: input.supervisor ?? input.voice_watcher ?? input.voiceWatcher,
+        supervisor: nestedSupervisor ? supervisorPayload(nestedSupervisor) : undefined,
+        voice_watcher: typeof input.supervisor === "boolean"
+            ? input.supervisor
+            : nestedSupervisor
+                ? nestedSupervisor.enabled ?? true
+                : input.voice_watcher ?? input.voiceWatcher,
         api_key: input.api_key ?? input.apiKey,
         model: input.model,
         mode: input.mode,
@@ -2441,6 +2527,16 @@ function labsPayload(input) {
         label: input.label,
     });
 }
+function supervisorPayload(input) {
+    return compact({
+        enabled: input.enabled,
+        mode: input.mode,
+        provider: input.provider,
+        model: input.model,
+        api_key: input.api_key ?? input.apiKey,
+        api_key_configured: input.api_key_configured ?? input.apiKeyConfigured,
+    });
+}
 function ultravoxPayload(input) {
     return compact({
         model: input.model,

package/dist/index.d.ts

@@ -4,7 +4,7 @@
  * A dependency-free TypeScript client for creating hosted Supafone agents
  * through the Supafone API, including managed phone numbers, voices, stages,
  * tools, recordings, transcripts, widgets, and Supafone Supervisor. It also
- * includes the Labs cloud sidecar oracle, hosted TTS/STT, live multilingual
+ * includes Supafone Supervisor, hosted TTS/STT, live multilingual
  * transcription, telemetry, agent builder, and objective-driven optimizer.
  *
  * Works in Node 18+ (native fetch/WebSocket) and the browser.
@@ -49,7 +49,7 @@ export interface SupafoneLabsOptions {
      * (or structured messages) first classifies the finished call against the
      * agent's objective — generating labels (achieved/missed, per-criterion
      * verdicts, failure reasons) — and files the enriched report server-side.
-     * Billed one oracle call per analyzed call; reports without a transcript
+     * Billed one Supervisor inference per analyzed call; reports without a transcript
      * fall back to the plain zero-billed report.
      */
     postCallAnalysis?: boolean;
@@ -66,18 +66,22 @@ export interface ChatMessage {
     role: "system" | "user" | "assistant";
     content: string;
 }
-export interface OracleRequest {
+export interface SupervisorRequest {
     messages: ChatMessage[];
-    /** Any claude-* / gpt-* / grok-* id, or the alias "supafone-labs-oracle". */
+    /** Any supported managed/BYOK model id, or the alias "supafone-supervisor". */
     model?: string;
     maxTokens?: number;
     temperature?: number;
 }
-export interface OracleResult {
+export interface SupervisorResult {
     text: string;
     model: string;
     usage?: Record<string, number>;
 }
+/** @deprecated Use SupervisorRequest. */
+export type OracleRequest = SupervisorRequest;
+/** @deprecated Use SupervisorResult. */
+export type OracleResult = SupervisorResult;
 export interface WhisperOptions {
     model?: string;
     /** Extra operator rules folded into the coaching system prompt. */
@@ -195,7 +199,7 @@ export interface LabsCallStage {
     next_stages?: string[];
     metadata?: Record<string, unknown>;
 }
-export type LabsStageGeneration = "oracle" | "template" | "off";
+export type LabsStageGeneration = "managed" | "template" | "off" | "oracle";
 export interface LabsCallPlan {
     version: "supafone_call_plan_v1" | string;
     summary: string;
@@ -440,6 +444,8 @@ export interface LabsProviderByokConfig {
     provider?: string;
     apiKey?: string;
     api_key?: string;
+    apiKeyConfigured?: boolean;
+    api_key_configured?: boolean;
     credentials?: Record<string, unknown>;
     settings?: Record<string, unknown>;
     model?: string;
@@ -629,15 +635,29 @@ export interface LabsArtifactsConfig {
     retention_days?: number;
     metadata?: Record<string, unknown>;
 }
+export type LabsSupervisorProvider = "anthropic" | "claude" | "openai" | "gemini" | "google" | "openrouter" | "groq" | "cerebras";
+export interface LabsByokSupervisorConfig {
+    enabled?: boolean;
+    mode?: "managed" | "supafone_managed" | "byok";
+    provider?: LabsSupervisorProvider;
+    model?: string;
+    apiKey?: string;
+    api_key?: string;
+    apiKeyConfigured?: boolean;
+    api_key_configured?: boolean;
+}
 export interface LabsSupervisorConfig {
     enabled?: boolean;
-    supervisor?: boolean;
+    supervisor?: boolean | LabsByokSupervisorConfig;
     /** @deprecated Use supervisor. */
     voiceWatcher?: boolean;
     /** @deprecated Use supervisor. */
     voice_watcher?: boolean;
     apiKey?: string;
     api_key?: string;
+    apiKeyConfigured?: boolean;
+    api_key_configured?: boolean;
+    provider?: LabsSupervisorProvider;
     model?: string;
     mode?: "supafone_managed" | "byok" | string;
     managedInfrastructure?: boolean;
@@ -869,7 +889,7 @@ export interface CreateLabsAgentRequest {
     email?: LabsEmailConfig;
     labs?: LabsSupervisorConfig;
     ultravox?: LabsUltravoxRuntime;
-    supervisor?: boolean;
+    supervisor?: boolean | LabsByokSupervisorConfig;
     /** @deprecated Use supervisor. */
     voiceWatcher?: boolean;
     /** @deprecated Use supervisor. */
@@ -1192,6 +1212,44 @@ export interface LabsPhoneNumberListResponse {
     numbers: LabsPhoneNumberRecord[];
     telephony?: Record<string, unknown>;
 }
+export type LabsSharedPhonePoolStatus = "available" | "in_use" | "cooldown" | "reserved" | "unavailable";
+export interface LabsSharedPhonePoolNumber {
+    id: string;
+    pool_id: string;
+    pool_name: string;
+    phone_number: string;
+    display_name: string;
+    provider: string;
+    status: LabsSharedPhonePoolStatus;
+    status_color: "green" | "red";
+    available: boolean;
+    reason: string;
+    health: string;
+    capabilities: string[];
+    cooldown_until?: string | null;
+    updated_at: string;
+}
+export interface LabsSharedPhonePoolSnapshot {
+    version: "developer_phone_pool_v1" | string;
+    revision: string;
+    counts: {
+        total: number;
+        available: number;
+        in_use: number;
+        unavailable: number;
+    };
+    numbers: LabsSharedPhonePoolNumber[];
+    stream?: {
+        url: string;
+        token: string;
+        expires_in_seconds: number;
+        protocol: "developer_phone_pool_v1" | string;
+    };
+}
+export interface LabsPhonePoolStreamOptions {
+    /** Inject a WebSocket implementation for Node versions without a global WebSocket. */
+    WebSocketImpl?: typeof WebSocket;
+}
 export interface LabsPhoneNumberProvisionRequest {
     agencyId?: string;
     agency_id?: string;
@@ -1414,6 +1472,8 @@ export interface BuilderChatResult {
     emotion?: string;
     language?: string;
     intent?: string;
+    supervisor_ms?: number;
+    /** @deprecated Use supervisor_ms. */
     oracle_ms?: number;
     standing_version?: number;
 }
@@ -1455,7 +1515,9 @@ export interface QASuiteResult {
         passed: number;
         avg_ssr_score: number;
         ssr_histogram: Record<SSRLabel, number>;
-        oracle_calls_billed: number;
+        supervisor_inferences_billed?: number;
+        /** @deprecated Legacy server field. */
+        oracle_calls_billed?: number;
     };
 }
 export interface QAResult {
@@ -1484,7 +1546,9 @@ export interface QAResult {
         passed_supervised: number;
         passed_unsupervised: number;
         avg_lift: number;
-        oracle_calls_billed: number;
+        supervisor_inferences_billed?: number;
+        /** @deprecated Legacy server field. */
+        oracle_calls_billed?: number;
     };
 }
 export type TesterScenario = "price_probe" | "false_booking" | "language_switch" | "distressed";
@@ -1677,8 +1741,10 @@ export declare class SupafoneLabs {
         industry?: string;
         apply?: boolean;
     }): Promise<GenerateIntakeResult>;
-    /** Raw oracle completion — full control over messages and model. */
-    oracle(req: OracleRequest): Promise<OracleResult>;
+    /** Raw Supervisor completion with either Supafone-managed or BYOK inference. */
+    completeWithSupervisor(req: SupervisorRequest): Promise<SupervisorResult>;
+    /** @deprecated Use completeWithSupervisor(). */
+    oracle(req: SupervisorRequest): Promise<SupervisorResult>;
     /**
      * The one-liner: hand it the running transcript, get back a silent directive
      * (empty string when the agent is doing fine).
@@ -1709,7 +1775,7 @@ export declare class SupafoneLabs {
     liveTranscribe(opts?: LiveTranscribeOptions): LiveTranscription;
     /** Remaining prepaid balance. */
     balance(): Promise<Balance>;
-    /** Today's usage against your plan caps (oracle/tts/stt/…). */
+    /** Today's usage across Supervisor, TTS, STT, and managed runtime meters. */
     usage(): Promise<UsageToday>;
     /** The auditable whisper/billing log. */
     logs(limit?: number): Promise<{
@@ -1732,7 +1798,7 @@ export declare class SupafoneLabs {
      *
      * With `postCallAnalysis: true` on the client and a transcript (or
      * messages) present, the call is automatically classified first: the
-     * oracle labels it against the agent's objective (achieved/missed,
+     * Supervisor labels it against the agent's objective (achieved/missed,
      * per-criterion verdicts, failure reasons) and files the enriched report
      * server-side. The generated labels come back on `analysis`. Analysis is
      * best-effort — on any failure the plain zero-billed report still lands.
@@ -1743,10 +1809,10 @@ export declare class SupafoneLabs {
      * objective and get labels back — achieved/missed, per-criterion verdicts,
      * failure reasons, and the blended objective value. Files an enriched call
      * report server-side (feeding optimizer.improve() and objective stats).
-     * Billed one oracle call.
+     * Billed one Supervisor inference.
      */
     classifyCall(input: ClassifyCallInput): Promise<CallClassification>;
-    /** Available oracle model ids (live vendor catalog). */
+    /** Available managed and BYOK Supervisor model ids. */
     models(): Promise<string[]>;
     /** Available TTS voice ids. */
     voices(): Promise<string[]>;
@@ -2065,6 +2131,10 @@ declare class LabsNamespace {
 }
 export type LabsBillingCheckoutKind = "plan" | "credits" | "number_addon";
 export interface LabsBillingCheckoutInput {
+    /** Current prepaid managed-minute package SKU. */
+    sku?: string;
+    packageSku?: string;
+    package_sku?: string;
     kind?: LabsBillingCheckoutKind;
     planKey?: "developer" | "growth" | "scale" | string;
     plan_key?: string;
@@ -2079,10 +2149,16 @@ export interface LabsBillingCheckoutInput {
     cancel_url?: string;
 }
 export interface LabsBillingCheckoutResponse {
-    status: "requires_payment" | "pending" | "paid" | string;
-    checkout_session_id: string;
+    status?: "requires_payment" | "pending" | "paid" | string;
+    checkout_session_id?: string;
     checkout_url?: string;
-    kind: LabsBillingCheckoutKind | string;
+    /** Canonical minute-top-up Checkout URL. */
+    url?: string;
+    kind?: LabsBillingCheckoutKind | string;
+    sku?: string;
+    minutes?: number;
+    amount_cents?: number;
+    purchase_id?: string;
     plan_key?: string | null;
     number_strategy?: string | null;
     phone_number?: string | null;
@@ -2095,6 +2171,8 @@ declare class LabsBillingNamespace {
     constructor(sm: SupafoneLabs);
     /** Start hosted Stripe Checkout. MCP callers should render checkout_url as a link. */
     checkout(input?: LabsBillingCheckoutInput): Promise<LabsBillingCheckoutResponse>;
+    /** Start Stripe Checkout for one prepaid managed-minute package. */
+    topUp(sku?: string): Promise<LabsBillingCheckoutResponse>;
     status(checkoutSessionId: string): Promise<LabsBillingCheckoutResponse>;
     portal(): Promise<{
         url: string;
@@ -2267,6 +2345,16 @@ declare class LabsPhoneNumbersNamespace {
     constructor(sm: SupafoneLabs);
     /** List numbers already owned by this Supafone account. */
     list(opts?: LabsPhoneNumberListOptions): Promise<LabsPhoneNumberListResponse>;
+    /**
+     * Read the explicitly enrolled shared developer-number pool. This inventory
+     * never infers customer or merely-unassigned numbers into the response.
+     */
+    pool(): Promise<LabsSharedPhonePoolSnapshot>;
+    /**
+     * Connect to realtime pool state using a short-lived pool-only token. The
+     * Supafone API key is never placed in the WebSocket URL.
+     */
+    connectPool(opts?: LabsPhonePoolStreamOptions): Promise<WebSocket>;
     /** Search Supafone-managed inventory. This uses Supafone's master telephony account. */
     search(opts?: LabsPhoneNumberSearchOptions): Promise<LabsPhoneNumberSearchResponse>;
     /**