import type { KlawConfig } from "../config/types.klaw.js";
import type { TalkTransport } from "./talk-events.js";
export type RealtimeVoiceProviderId = string;
export type RealtimeVoiceRole = "user" | "assistant";
export type RealtimeVoiceCloseReason = "completed" | "error";
export type RealtimeVoiceAudioFormat = {
    encoding: "g711_ulaw";
    sampleRateHz: 8000;
    channels: 1;
} | {
    encoding: "pcm16";
    sampleRateHz: 24000;
    channels: 1;
};
export declare const REALTIME_VOICE_AUDIO_FORMAT_G711_ULAW_8KHZ: RealtimeVoiceAudioFormat;
export declare const REALTIME_VOICE_AUDIO_FORMAT_PCM16_24KHZ: RealtimeVoiceAudioFormat;
export type RealtimeVoiceTool = {
    type: "function";
    name: string;
    description: string;
    parameters: {
        type: "object";
        properties: Record<string, unknown>;
        required?: string[];
    };
};
export type RealtimeVoiceToolCallEvent = {
    itemId: string;
    callId: string;
    name: string;
    args: unknown;
};
export type RealtimeVoiceToolResultOptions = {
    /**
     * Submit the tool result without prompting the realtime provider to generate a new assistant
     * response. Use when another channel has already delivered the user-visible answer.
     */
    suppressResponse?: boolean;
    willContinue?: boolean;
};
export type RealtimeVoiceBridgeEvent = {
    direction: "client" | "server";
    type: string;
    detail?: string;
};
export type RealtimeVoiceBridgeCallbacks = {
    onAudio: (audio: Buffer) => void;
    onClearAudio: () => void;
    onMark?: (markName: string) => void;
    onTranscript?: (role: RealtimeVoiceRole, text: string, isFinal: boolean) => void;
    onEvent?: (event: RealtimeVoiceBridgeEvent) => void;
    onToolCall?: (event: RealtimeVoiceToolCallEvent) => void;
    onReady?: () => void;
    onError?: (error: Error) => void;
    onClose?: (reason: RealtimeVoiceCloseReason) => void;
};
export type RealtimeVoiceProviderConfig = Record<string, unknown>;
export type RealtimeVoiceProviderCapabilities = {
    transports: TalkTransport[];
    inputAudioFormats: RealtimeVoiceAudioFormat[];
    outputAudioFormats: RealtimeVoiceAudioFormat[];
    supportsBrowserSession?: boolean;
    supportsBargeIn?: boolean;
    supportsToolCalls?: boolean;
    supportsVideoFrames?: boolean;
    supportsSessionResumption?: boolean;
};
export type RealtimeVoiceProviderResolveConfigContext = {
    cfg: KlawConfig;
    rawConfig: RealtimeVoiceProviderConfig;
};
export type RealtimeVoiceProviderConfiguredContext = {
    cfg?: KlawConfig;
    providerConfig: RealtimeVoiceProviderConfig;
};
export type RealtimeVoiceBridgeCreateRequest = RealtimeVoiceBridgeCallbacks & {
    cfg?: KlawConfig;
    providerConfig: RealtimeVoiceProviderConfig;
    audioFormat?: RealtimeVoiceAudioFormat;
    instructions?: string;
    autoRespondToAudio?: boolean;
    interruptResponseOnInputAudio?: boolean;
    tools?: RealtimeVoiceTool[];
};
export type RealtimeVoiceBrowserSessionCreateRequest = {
    cfg?: KlawConfig;
    providerConfig: RealtimeVoiceProviderConfig;
    instructions?: string;
    tools?: RealtimeVoiceTool[];
    model?: string;
    voice?: string;
    vadThreshold?: number;
    silenceDurationMs?: number;
    prefixPaddingMs?: number;
    reasoningEffort?: string;
};
export type RealtimeVoiceBrowserAudioContract = {
    inputEncoding: "pcm16" | "g711_ulaw";
    inputSampleRateHz: number;
    outputEncoding: "pcm16" | "g711_ulaw";
    outputSampleRateHz: number;
};
export type RealtimeVoiceBrowserWebRtcSdpSession = {
    provider: RealtimeVoiceProviderId;
    transport: "webrtc";
    clientSecret: string;
    offerUrl?: string;
    offerHeaders?: Record<string, string>;
    model?: string;
    voice?: string;
    expiresAt?: number;
};
export type RealtimeVoiceBrowserJsonPcmWebSocketSession = {
    provider: RealtimeVoiceProviderId;
    transport: "provider-websocket";
    protocol: string;
    clientSecret: string;
    websocketUrl: string;
    audio: RealtimeVoiceBrowserAudioContract;
    initialMessage?: unknown;
    model?: string;
    voice?: string;
    expiresAt?: number;
};
export type RealtimeVoiceBrowserGatewayRelaySession = {
    provider: RealtimeVoiceProviderId;
    transport: "gateway-relay";
    relaySessionId: string;
    audio: RealtimeVoiceBrowserAudioContract;
    model?: string;
    voice?: string;
    expiresAt?: number;
};
export type RealtimeVoiceBrowserManagedRoomSession = {
    provider: RealtimeVoiceProviderId;
    transport: "managed-room";
    roomUrl: string;
    token?: string;
    model?: string;
    voice?: string;
    expiresAt?: number;
};
export type RealtimeVoiceBrowserSession = RealtimeVoiceBrowserWebRtcSdpSession | RealtimeVoiceBrowserJsonPcmWebSocketSession | RealtimeVoiceBrowserGatewayRelaySession | RealtimeVoiceBrowserManagedRoomSession;
export type RealtimeVoiceBridge = {
    supportsToolResultContinuation?: boolean;
    connect(): Promise<void>;
    sendAudio(audio: Buffer): void;
    setMediaTimestamp(ts: number): void;
    sendUserMessage?(text: string): void;
    triggerGreeting?(instructions?: string): void;
    handleBargeIn?(options?: RealtimeVoiceBargeInOptions): void;
    submitToolResult(callId: string, result: unknown, options?: RealtimeVoiceToolResultOptions): void;
    acknowledgeMark(): void;
    close(): void;
    isConnected(): boolean;
};
export type RealtimeVoiceBargeInOptions = {
    /**
     * The caller has already confirmed assistant audio is still playing in its output sink.
     * This lets providers interrupt output even when the sink cannot provide real playback marks.
     */
    audioPlaybackActive?: boolean;
    /** Interrupt even when normal barge-in audio-duration guards would treat the event as echo. */
    force?: boolean;
};