import type { Observable, Subject } from 'rxjs';
import type { Readable } from 'stream';
/**
 * Context passed to custom ASR/TTS factories from {@link defineMediaProviders}.
 * Populated by the host outside the script sandbox.
 */
export interface MediaConnectorContext {
    id: string;
    config: Record<string, string>;
    dialogUuid: string;
    role?: string;
    debug$: Subject<string>;
}
export interface ScriptAsrConnectorError {
    message: string;
    code?: number;
}
/**
 * Host ASR connector contract for custom providers (same surface as runtime AsrConnector).
 */
export interface ScriptAsrConnector {
    transcription$: Subject<{
        text: string;
        isFinal: boolean;
    }>;
    result$: Subject<string>;
    error$: Subject<ScriptAsrConnectorError>;
    isOpen(): boolean;
    send(audio: ArrayBufferLike): void;
    speech(active: boolean): void;
    finalize(): void;
    close(): void;
}
export type TtsSynthesisContext = {
    previousText?: string;
    nextText?: string;
};
/**
 * Unified TTS connector: batch HTTP + optional streaming WebSocket methods.
 */
export interface ScriptTtsConnector {
    supportsStreaming(): boolean;
    textToSpeechStream(rawtext: string, ctx?: TtsSynthesisContext): Promise<Readable>;
    readonly audio$: Subject<Buffer>;
    readonly done$: Subject<void>;
    open(): Promise<void>;
    startGeneration(): Promise<void>;
    sendText(chunk: string): void;
    flush(): void;
    sendSeparatorFlush?(): void;
    close(): void;
}
/** Optional session object shared by ASR and TTS factories for one dialog. */
export type MediaProviderShared = {
    dispose?: () => void;
    close?: () => void;
} & Record<string, unknown>;
export type AsrProviderFactory = (ctx: MediaConnectorContext, shared: MediaProviderShared | undefined) => ScriptAsrConnector;
export type TtsProviderFactory = (ctx: MediaConnectorContext, shared: MediaProviderShared | undefined) => ScriptTtsConnector;
export interface MediaProvidersDefinition {
    createShared?: (ctx: {
        dialogUuid: string;
        debug$: Subject<string>;
    }) => MediaProviderShared;
    asr?: Record<string, AsrProviderFactory>;
    tts?: Record<string, TtsProviderFactory>;
}
/**
 * Mark a named export as custom media providers (identity helper).
 *
 * Export from a sibling module (`media-providers/index.ts`), not from the
 * sandboxed script entry. The host loads this outside the VM.
 *
 * @example
 * ```ts
 * // media-providers/index.ts (host-only)
 * export const mediaProviders = defineMediaProviders({
 *   createShared: (ctx) => new MySession(ctx),
 *   asr: { 'my-asr': (ctx, shared) => new MyAsr(ctx, shared) },
 *   tts: { 'my-tts': (ctx, shared) => new MyTts(ctx, shared) },
 * });
 * ```
 */
export declare function defineMediaProviders(def: MediaProvidersDefinition): MediaProvidersDefinition;
/** @internal helper type for hosts that mirror connector subjects */
export type SubjectLike<T> = Subject<T> | Observable<T>;
//# sourceMappingURL=media-providers.d.ts.map