supafone-labs 0.3.0

package/dist/cjs/index.d.ts

@@ -0,0 +1,736 @@
+/**
+ * Supafone Labs — the agent framework behind Supafone.
+ *
+ * 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 Pro watcher. It also
+ * includes the Labs cloud sidecar oracle, hosted TTS/STT, live multilingual
+ * transcription, telemetry, agent builder, and objective-driven optimizer.
+ *
+ * Works in Node 18+ (native fetch/WebSocket) and the browser.
+ *
+ *   npm i @supafonesupafone-labs
+ *
+ *   import { Supafone } from "@supafonesupafone-labs";
+ *   const supafone = new Supafone({ apiKey: process.env.SUPAFONE_API_KEY! });
+ *   const agent = await supafone.labs.agents.createInboundWithNumber({
+ *     agentKey: "northline-intake",
+ *     name: "Northline intake",
+ *     number: { search: { areaCode: "415" } },
+ *   });
+ */
+export interface SupafoneLabsOptions {
+    /** Your key from https:/supafone-labs.supafone.ai/get-key.html */
+    apiKey: string;
+    /** Override the gateway (default: the hosted cloud). */
+    baseUrl?: string;
+    /** Supafone app/API key for hosted agent provisioning. Defaults to apiKey. */
+    supafoneApiKey?: string;
+    /** Override the Supafone API used by supafone.labs.* (default: https://api.supafone.ai). */
+    supafoneApiBaseUrl?: string;
+    /** Per-request timeout in ms (default 30_000). */
+    timeoutMs?: number;
+    /** Optional pre-obtained session token (else use login()). */
+    sessionToken?: string;
+}
+export interface ChatMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+export interface OracleRequest {
+    messages: ChatMessage[];
+    /** Any claude-* / gpt-* / grok-* id, or the alias "supafone-labs-oracle". */
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+export interface OracleResult {
+    text: string;
+    model: string;
+    usage?: Record<string, number>;
+}
+export interface WhisperOptions {
+    model?: string;
+    /** Extra operator rules folded into the coaching system prompt. */
+    guardrails?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+export interface Balance {
+    plan: string;
+    seconds_remaining: number;
+    minutes_remaining: number;
+    top_up?: {
+        subscribe_monthly?: string;
+        buy_credit_pack?: string;
+        note?: string;
+    };
+}
+export interface UsageToday {
+    plan: string;
+    day: string;
+    usage: Record<string, {
+        used: number;
+        cap: number;
+    }>;
+}
+export type LabsAgentType = "phone" | "web" | "campaign";
+export type LabsAgentStyle = "inbound" | "outbound";
+export type LabsRuntimeMode = "multi_stage" | "single_stage";
+export type LabsTelephonyMode = "supafone_managed" | "byok";
+export type LabsTelephonyProvider = "supafone" | "twilio" | "telnyx" | "plivo" | "sip" | string;
+export interface LabsVoiceSelection {
+    provider?: string;
+    voiceId?: string;
+    voice_id?: string;
+    model?: string;
+}
+export interface LabsProviderKeys {
+    ultravox?: string;
+    ultravoxApiKey?: string;
+    ultravox_api_key?: string;
+    elevenlabs?: string;
+    elevenlabsApiKey?: string;
+    elevenlabs_api_key?: string;
+    cartesia?: string;
+    cartesiaApiKey?: string;
+    cartesia_api_key?: string;
+    inworld?: string;
+    inworldApiKey?: string;
+    inworld_api_key?: string;
+    deepgram?: string;
+    deepgramApiKey?: string;
+    deepgram_api_key?: string;
+}
+export interface LabsTelephonyCredentials {
+    accountSid?: string;
+    account_sid?: string;
+    authToken?: string;
+    auth_token?: string;
+    apiKey?: string;
+    api_key?: string;
+    apiSecret?: string;
+    api_secret?: string;
+    authId?: string;
+    auth_id?: string;
+    connectionId?: string;
+    connection_id?: string;
+    fromNumber?: string;
+    from_number?: string;
+    sipTrunkUri?: string;
+    sip_trunk_uri?: string;
+    sipHost?: string;
+    sip_host?: string;
+    username?: string;
+    password?: string;
+    webhookSecret?: string;
+    webhook_secret?: string;
+}
+export interface LabsTelephonyConfig {
+    agencyId?: string;
+    agency_id?: string;
+    /** Default is Supafone-managed; developers do not need Twilio for this path. */
+    mode?: LabsTelephonyMode;
+    provider?: LabsTelephonyProvider;
+    label?: string;
+    credentials?: LabsTelephonyCredentials;
+    metadata?: Record<string, unknown>;
+}
+export interface LabsToolsConfig {
+    callRouting?: boolean;
+    call_routing?: boolean;
+    scheduling?: boolean;
+    sms?: boolean;
+    email?: boolean;
+    intakeForms?: boolean;
+    intake_forms?: boolean;
+    firmKnowledge?: boolean;
+    firm_knowledge?: boolean;
+    existingClientLookup?: boolean;
+    existing_client_lookup?: boolean;
+    voicemail?: boolean;
+    emergencyEscalation?: boolean;
+    emergency_escalation?: boolean;
+    customTools?: Array<Record<string, unknown>>;
+    custom_tools?: Array<Record<string, unknown>>;
+}
+export interface LabsWatcherConfig {
+    enabled?: boolean;
+    voiceWatcher?: boolean;
+    voice_watcher?: boolean;
+    model?: string;
+    label?: string;
+}
+export interface LabsUltravoxRuntime {
+    model?: string;
+    temperature?: number;
+    medium?: Record<string, unknown>;
+    vadSettings?: Record<string, unknown>;
+    vad_settings?: Record<string, unknown>;
+    speakerFirst?: boolean;
+    speaker_first?: boolean;
+    firstSpeaker?: string;
+    first_speaker?: string;
+    firstSpeakerSettings?: Record<string, unknown>;
+    first_speaker_settings?: Record<string, unknown>;
+    selectedTools?: Array<Record<string, unknown>>;
+    selected_tools?: Array<Record<string, unknown>>;
+    initialMessages?: Array<Record<string, unknown>>;
+    initial_messages?: Array<Record<string, unknown>>;
+    initialState?: Record<string, unknown>;
+    initial_state?: Record<string, unknown>;
+    initialOutputMedium?: string;
+    initial_output_medium?: string;
+    joinTimeout?: string;
+    join_timeout?: string;
+    maxDuration?: string;
+    max_duration?: string;
+    maxDurationSeconds?: number;
+    max_duration_seconds?: number;
+    timeExceededMessage?: string;
+    time_exceeded_message?: string;
+    inactivityMessages?: Array<Record<string, unknown>>;
+    inactivity_messages?: Array<Record<string, unknown>>;
+    dataConnection?: Record<string, unknown>;
+    data_connection?: Record<string, unknown>;
+    callbacks?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    experimentalSettings?: Record<string, unknown>;
+    experimental_settings?: Record<string, unknown>;
+    voiceOverrides?: Record<string, unknown>;
+    voice_overrides?: Record<string, unknown>;
+    retentionPolicy?: string;
+    retention_policy?: string;
+    callTemplate?: Record<string, unknown>;
+    call_template?: Record<string, unknown>;
+}
+export interface CreateLabsAgentRequest {
+    agencyId?: string;
+    agency_id?: string;
+    agentKey?: string;
+    agent_key?: string;
+    agentType?: LabsAgentType;
+    agent_type?: LabsAgentType;
+    /** inbound = receptionist/intake, outbound = sales/speed-to-lead/campaign. */
+    style?: LabsAgentStyle;
+    agentStyle?: LabsAgentStyle;
+    agent_style?: LabsAgentStyle;
+    name: string;
+    assistantName?: string;
+    assistant_name?: string;
+    businessName?: string;
+    business_name?: string;
+    industry?: string;
+    websiteUrl?: string;
+    website_url?: string;
+    phoneNumber?: string;
+    phone_number?: string;
+    direction?: string;
+    presetKey?: string;
+    preset_key?: string;
+    runtimeMode?: LabsRuntimeMode;
+    runtime_mode?: LabsRuntimeMode;
+    goal?: string;
+    greeting?: string;
+    systemPrompt?: string;
+    system_prompt?: string;
+    language?: string;
+    voice?: LabsVoiceSelection;
+    providerKeys?: LabsProviderKeys;
+    provider_keys?: LabsProviderKeys;
+    byok?: LabsProviderKeys;
+    telephony?: LabsTelephonyConfig;
+    tools?: LabsToolsConfig;
+    labs?: LabsWatcherConfig;
+    ultravox?: LabsUltravoxRuntime;
+    voiceWatcher?: boolean;
+    voice_watcher?: boolean;
+    voiceWatcherModel?: string;
+    voice_watcher_model?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ListLabsAgentsOptions {
+    agencyId?: string;
+    agentType?: LabsAgentType;
+    style?: LabsAgentStyle;
+}
+export interface GetLabsAgentOptions extends ListLabsAgentsOptions {
+}
+export interface LabsCapabilitiesResponse {
+    product: string;
+    api_namespace: string;
+    compatibility_namespace?: string;
+    default_agent_contract: Record<string, unknown>;
+    capabilities: Array<Record<string, unknown>>;
+    recommended_next_api_additions?: Array<Record<string, unknown>>;
+    [extra: string]: unknown;
+}
+export interface LabsPresetListResponse {
+    default_preset_key: string;
+    router_policies?: Record<string, string>;
+    presets: Array<Record<string, unknown>>;
+}
+export interface LabsToolListResponse {
+    tools: Array<Record<string, unknown>>;
+}
+export interface LabsVoiceListOptions {
+    provider?: string;
+}
+export interface LabsVoiceListResponse {
+    voices: Array<Record<string, unknown>>;
+    total: number;
+    providers: Array<Record<string, unknown>>;
+    provider_accounts?: Record<string, unknown>;
+    errors?: Record<string, string>;
+}
+export interface LabsPhoneNumberSearchOptions {
+    agencyId?: string;
+    agency_id?: string;
+    countryCode?: string;
+    country_code?: string;
+    areaCode?: string;
+    area_code?: string;
+    postalCode?: string;
+    postal_code?: string;
+    zipCode?: string;
+    zip_code?: string;
+    contains?: string;
+    numberType?: "local" | "toll_free" | "mobile" | string;
+    number_type?: string;
+    limit?: number;
+    capabilities?: string[];
+}
+export interface LabsPhoneNumberOption {
+    phone_number: string;
+    number_type?: string;
+    region?: string;
+    locality?: string;
+    monthly_cost?: number;
+    setup_cost?: number;
+    capabilities?: string[];
+    managed_by?: string;
+    telephony_mode?: LabsTelephonyMode | string;
+    [extra: string]: unknown;
+}
+export interface LabsPhoneNumberSearchResponse {
+    numbers: LabsPhoneNumberOption[];
+    search_context?: Record<string, unknown>;
+}
+export interface LabsPhoneNumberRecord {
+    number_id?: string;
+    phone_number?: string;
+    status?: string;
+    friendly_name?: string;
+    number_type?: string;
+    monthly_cost?: number;
+    provisioned_at?: string;
+    capabilities?: string[];
+    managed_by?: string;
+    telephony_mode?: LabsTelephonyMode | string;
+    [extra: string]: unknown;
+}
+export interface LabsPhoneNumberListOptions {
+    agencyId?: string;
+    activeOnly?: boolean;
+}
+export interface LabsPhoneNumberListResponse {
+    numbers: LabsPhoneNumberRecord[];
+    telephony?: Record<string, unknown>;
+}
+export interface LabsPhoneNumberProvisionRequest {
+    agencyId?: string;
+    agency_id?: string;
+    phoneNumber?: string;
+    phone_number?: string;
+    friendlyName?: string;
+    friendly_name?: string;
+    departmentId?: string;
+    department_id?: string;
+    agentKey?: string;
+    agent_key?: string;
+    agentId?: string;
+    agent_id?: string;
+    agentName?: string;
+    agent_name?: string;
+    presetKey?: string;
+    preset_key?: string;
+    style?: LabsAgentStyle;
+    agentStyle?: LabsAgentStyle;
+    agent_style?: LabsAgentStyle;
+    direction?: LabsAgentStyle;
+    telephony?: LabsTelephonyConfig;
+    metadata?: Record<string, unknown>;
+}
+export interface LabsPhoneNumberAssignRequest extends Omit<LabsPhoneNumberProvisionRequest, "phoneNumber" | "phone_number" | "departmentId" | "department_id"> {
+}
+export interface LabsPhoneNumberProvisionResponse {
+    success: boolean;
+    number: LabsPhoneNumberRecord;
+    assignment?: Record<string, unknown>;
+    telephony?: Record<string, unknown>;
+    [extra: string]: unknown;
+}
+export interface LabsPhoneNumberAssignResponse {
+    success: boolean;
+    number: LabsPhoneNumberRecord;
+    assignment?: Record<string, unknown>;
+}
+export interface LabsPhoneNumberBuyAndAssignRequest extends LabsPhoneNumberProvisionRequest {
+    search?: LabsPhoneNumberSearchOptions;
+}
+export interface LabsTelephonyResponse {
+    telephony: Record<string, unknown>;
+    default?: Record<string, unknown>;
+    byok?: Record<string, unknown>;
+}
+export interface LabsTelephonyConfigureResponse {
+    success: boolean;
+    telephony: Record<string, unknown>;
+}
+export interface CreateLabsAgentWithNumberRequest extends CreateLabsAgentRequest {
+    number?: LabsPhoneNumberBuyAndAssignRequest;
+}
+export interface CreateLabsAgentWithNumberResponse extends CreateLabsAgentResponse {
+    number?: LabsPhoneNumberProvisionResponse;
+}
+export interface LabsAgentResponse {
+    id?: string;
+    agency_id?: string;
+    agent_type?: LabsAgentType | string;
+    agent_key?: string;
+    source_id?: string;
+    display_name?: string;
+    runtime_mode?: string;
+    preset_key?: string;
+    profile?: Record<string, unknown>;
+    runtime?: Record<string, unknown>;
+    [extra: string]: unknown;
+}
+export interface CreateLabsAgentResponse {
+    success: boolean;
+    agent: LabsAgentResponse;
+    runtime: Record<string, unknown>;
+    widget?: {
+        widget_key?: string;
+        snippet?: string;
+        [extra: string]: unknown;
+    };
+    [extra: string]: unknown;
+}
+export interface ListLabsAgentsResponse {
+    agents: LabsAgentResponse[];
+    total: number;
+}
+export interface GetLabsAgentResponse {
+    agent: LabsAgentResponse;
+}
+export interface STTResult {
+    transcript: string;
+    languages: string[];
+    duration: number;
+    raw?: unknown;
+}
+/** A whisper/nudge event you log for the console feed + metrics (zero-billed). */
+export interface NudgeEvent {
+    text: string;
+    session_id?: string;
+    provider?: string;
+    confidence?: number;
+    injected?: boolean;
+    kind?: string;
+    language?: string;
+    emotion?: string;
+    intent?: string;
+    urgency?: number;
+    latency_ms?: number;
+    model?: string;
+    turns?: number;
+}
+/** A post-call report — the fuel the optimizer improves against. */
+export interface CallReportInput {
+    session_id?: string;
+    agent?: string;
+    score?: number;
+    outcome?: string;
+    summary?: string;
+    nudges?: number;
+    turns?: number;
+    language?: string;
+    [extra: string]: unknown;
+}
+export interface BuilderTurn {
+    role: "caller" | "agent" | "whisper";
+    text: string;
+}
+export interface BuilderChatResult {
+    whisper: string;
+    agent_reply: string;
+    emotion?: string;
+    language?: string;
+    intent?: string;
+    oracle_ms?: number;
+    standing_version?: number;
+}
+export interface QAResult {
+    agent: string;
+    turns: number;
+    results: Array<{
+        scenario: string;
+        title: string;
+        assertion: string;
+        unsupervised: {
+            passed: boolean;
+            score: number;
+            evidence: string;
+            whispers: number;
+        };
+        supervised: {
+            passed: boolean;
+            score: number;
+            evidence: string;
+            whispers: number;
+        };
+        lift: number;
+    }>;
+    summary: {
+        scenarios: number;
+        passed_supervised: number;
+        passed_unsupervised: number;
+        avg_lift: number;
+        oracle_calls_billed: number;
+    };
+}
+export declare class SupafoneLabsError extends Error {
+    readonly status?: number | undefined;
+    readonly body?: unknown | undefined;
+    constructor(message: string, status?: number | undefined, body?: unknown | undefined);
+}
+export declare class SupafoneLabs {
+    readonly baseUrl: string;
+    readonly supafoneApiBaseUrl: string;
+    private readonly apiKey;
+    private readonly supafoneApiKey;
+    private readonly timeoutMs;
+    private sessionToken?;
+    readonly labs: LabsNamespace;
+    readonly builder: BuilderNamespace;
+    readonly qa: QANamespace;
+    readonly optimizer: OptimizerNamespace;
+    constructor(opts: SupafoneLabsOptions);
+    /** True once login() (or a passed sessionToken) is in effect. */
+    get isLoggedIn(): boolean;
+    /**
+     * Exchange email/password for a console session. Required by the builder.*
+     * methods and qa.run (which are account/session-scoped, not key-scoped).
+     */
+    login(email: string, password: string): Promise<void>;
+    /** @internal Authenticated JSON request. `useSession` prefers the login token. */
+    request<T>(method: string, path: string, body?: unknown, useSession?: boolean): Promise<T>;
+    /** @internal Authenticated JSON request to the Supafone app API (`/api/v1supafone-labs/*`). */
+    requestSupafoneApi<T>(method: string, path: string, body?: unknown): Promise<T>;
+    /** Raw oracle completion — full control over messages and model. */
+    oracle(req: OracleRequest): Promise<OracleResult>;
+    /**
+     * The one-liner: hand it the running transcript, get back a silent directive
+     * (empty string when the agent is doing fine).
+     */
+    whisper(transcript: string, opts?: WhisperOptions): Promise<string>;
+    /** Hosted TTS — returns raw audio bytes (WAV/PCM per voice). */
+    tts(text: string, voice?: string): Promise<Uint8Array>;
+    /** Hosted STT for a finished audio clip — returns transcript + language tags. */
+    stt(audio: Uint8Array | ArrayBuffer, opts?: {
+        language?: string;
+        mimetype?: string;
+    }): Promise<STTResult>;
+    /**
+     * Open a live multilingual transcription socket. Feed PCM frames with
+     * `feed()`; language-tagged results arrive via `onResult`. Uses the global
+     * WebSocket (browser, Node 22+); pass one in `opts.WebSocketImpl` on older Node.
+     */
+    liveTranscribe(opts?: LiveTranscribeOptions): LiveTranscription;
+    /** Remaining prepaid balance. */
+    balance(): Promise<Balance>;
+    /** Today's usage against your plan caps (oracle/tts/stt/…). */
+    usage(): Promise<UsageToday>;
+    /** The auditable whisper/billing log. */
+    logs(limit?: number): Promise<{
+        logs: unknown[];
+    }>;
+    /** The structured whisper feed (what the console shows). */
+    nudges(limit?: number): Promise<{
+        nudges: unknown[];
+    }>;
+    /** Aggregated metrics — injection rate, latency, by-dimension breakdowns. */
+    metrics(days?: number): Promise<Record<string, unknown>>;
+    /** Log one whisper event (zero-billed) for the console feed + metrics. */
+    reportNudge(event: NudgeEvent): Promise<{
+        ok?: boolean;
+    }>;
+    /** File a post-call report — the fuel optimizer.improve() learns from. */
+    reportCall(report: CallReportInput): Promise<Record<string, unknown>>;
+    /** Available oracle model ids (live vendor catalog). */
+    models(): Promise<string[]>;
+    /** Available TTS voice ids. */
+    voices(): Promise<string[]>;
+}
+export interface LiveTranscribeOptions {
+    language?: string;
+    encoding?: string;
+    sampleRate?: number;
+    onResult?: (r: LiveResult) => void;
+    onError?: (e: unknown) => void;
+    onClose?: () => void;
+    /** Inject a WebSocket implementation for Node < 22 (e.g. `ws`). */
+    WebSocketImpl?: typeof WebSocket;
+}
+export interface LiveResult {
+    transcript: string;
+    languages: string[];
+    isFinal: boolean;
+}
+declare class LiveTranscription {
+    private ws;
+    constructor(sm: SupafoneLabs, opts: LiveTranscribeOptions);
+    /** Send one PCM audio frame. */
+    feed(frame: Uint8Array | ArrayBuffer): void;
+    /** Signal end-of-stream and close. */
+    close(): void;
+    get socket(): WebSocket;
+}
+/** Programmatic hosted Supafone agents, inside the Supafone API. */
+declare class LabsNamespace {
+    private sm;
+    readonly agents: LabsAgentsNamespace;
+    readonly presets: LabsPresetsNamespace;
+    readonly tools: LabsToolsNamespace;
+    readonly voices: LabsVoicesNamespace;
+    readonly phoneNumbers: LabsPhoneNumbersNamespace;
+    readonly telephony: LabsTelephonyNamespace;
+    constructor(sm: SupafoneLabs);
+    /** Discover the Supafone convenience layer over Ultravox. */
+    capabilities(): Promise<LabsCapabilitiesResponse>;
+}
+declare class LabsAgentsNamespace {
+    private sm;
+    constructor(sm: SupafoneLabs);
+    /** Spawn a durable hosted Supafone agent backed by Ultravox and Supafone-managed providers. */
+    create(input: CreateLabsAgentRequest): Promise<CreateLabsAgentResponse>;
+    /** Create an inbound receptionist/intake agent. No Twilio account is required. */
+    createInbound(input: CreateLabsAgentRequest): Promise<CreateLabsAgentResponse>;
+    /** Create an outbound sales/speed-to-lead/campaign agent. No Twilio account is required. */
+    createOutbound(input: CreateLabsAgentRequest): Promise<CreateLabsAgentResponse>;
+    /**
+     * Create an inbound agent, buy a Supafone-managed phone number, and assign it.
+     * This is the zero-Twilio-account happy path.
+     */
+    createInboundWithNumber(input: CreateLabsAgentWithNumberRequest): Promise<CreateLabsAgentWithNumberResponse>;
+    /**
+     * Create an outbound agent, buy a Supafone-managed caller ID, and assign it.
+     * For sales teams this is the easiest path: Supafone owns telephony setup.
+     */
+    createOutboundWithNumber(input: CreateLabsAgentWithNumberRequest): Promise<CreateLabsAgentWithNumberResponse>;
+    /** List durable agents created in the Supafone account tied to this API key. */
+    list(opts?: ListLabsAgentsOptions): Promise<ListLabsAgentsResponse>;
+    /** Fetch one durable agent by key. */
+    get(agentKey: string, opts?: GetLabsAgentOptions): Promise<GetLabsAgentResponse>;
+}
+declare class LabsPresetsNamespace {
+    private sm;
+    constructor(sm: SupafoneLabs);
+    /** Out-of-the-box multistage agent presets. */
+    list(): Promise<LabsPresetListResponse>;
+}
+declare class LabsToolsNamespace {
+    private sm;
+    constructor(sm: SupafoneLabs);
+    /** Built-in tools Supafone agents can use. */
+    list(): Promise<LabsToolListResponse>;
+}
+declare class LabsVoicesNamespace {
+    private sm;
+    constructor(sm: SupafoneLabs);
+    /** Supafone-managed Ultravox, Cartesia, Inworld, and ElevenLabs-compatible voices. */
+    list(opts?: LabsVoiceListOptions): Promise<LabsVoiceListResponse>;
+}
+declare class LabsPhoneNumbersNamespace {
+    private sm;
+    constructor(sm: SupafoneLabs);
+    /** List numbers already owned by this Supafone account. */
+    list(opts?: LabsPhoneNumberListOptions): Promise<LabsPhoneNumberListResponse>;
+    /** Search Supafone-managed inventory. This uses Supafone's master telephony account. */
+    search(opts?: LabsPhoneNumberSearchOptions): Promise<LabsPhoneNumberSearchResponse>;
+    /** Buy a Supafone-managed number. Developers do not need a Twilio account. */
+    buy(input: LabsPhoneNumberProvisionRequest): Promise<LabsPhoneNumberProvisionResponse>;
+    /** Attach an existing Supafone number to an inbound or outbound agent. */
+    assign(numberId: string, input?: LabsPhoneNumberAssignRequest): Promise<LabsPhoneNumberAssignResponse>;
+    /**
+     * 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.
+     */
+    buyAndAssign(input: LabsPhoneNumberBuyAndAssignRequest): Promise<LabsPhoneNumberProvisionResponse>;
+}
+declare class LabsTelephonyNamespace {
+    private sm;
+    constructor(sm: SupafoneLabs);
+    /** Read the account telephony contract. Defaults to Supafone-managed. */
+    get(opts?: {
+        agencyId?: string;
+    }): Promise<LabsTelephonyResponse>;
+    /** Configure advanced BYOK telephony, or reset back to Supafone-managed. */
+    configure(input: LabsTelephonyConfig): Promise<LabsTelephonyConfigureResponse>;
+    /** Reset to the seamless default where Supafone buys and routes numbers. */
+    useSupafoneManaged(agencyId?: string): Promise<LabsTelephonyConfigureResponse>;
+}
+/**
+ * The agent builder. These methods are account/session-scoped — call
+ * `login(email, password)` first, or the gateway returns 401 "Log in first".
+ */
+declare class BuilderNamespace {
+    private sm;
+    constructor(sm: SupafoneLabs);
+    /** One supervised builder turn: whisper + guided agent reply. */
+    chat(sessionId: string, messages: BuilderTurn[]): Promise<BuilderChatResult>;
+    /** End a test call: grades it and files a report for the optimizer. */
+    finish(sessionId: string, messages: BuilderTurn[]): Promise<{
+        score: number;
+        outcome: string;
+        summary: string;
+    }>;
+    config(): Promise<unknown>;
+    saveConfig(config: unknown): Promise<unknown>;
+}
+declare class QANamespace {
+    private sm;
+    constructor(sm: SupafoneLabs);
+    /**
+     * Run the adversarial QA suite, A/B (supervised vs unsupervised).
+     * Session-scoped — call login() first.
+     */
+    run(opts?: {
+        scenarios?: string[];
+        turns?: number;
+    }): Promise<QAResult>;
+    /** Past QA runs (works with the API key). */
+    history(agent?: string, limit?: number): Promise<unknown>;
+}
+declare class OptimizerNamespace {
+    private sm;
+    constructor(sm: SupafoneLabs);
+    /** Improve the standing directive from accumulated call reports (OPRO-style). */
+    improve(agent?: string): Promise<{
+        version: number;
+        text: string;
+        rationale: string;
+    }>;
+    /** Fetch the current standing directive. */
+    standing(agent?: string): Promise<{
+        version: number;
+        text: string;
+    }>;
+    /** List the post-call reports behind the optimizer. */
+    reports(agent?: string, limit?: number): Promise<{
+        reports: unknown[];
+    }>;
+}
+export { SupafoneLabs as Supafone };
+export default SupafoneLabs;