import type OpenAI from "openai";
import { type Reranker, type RetrievalModel, type RetrieverHit } from "@use-crux/core/retrieval";
import { OpenAIChatStream } from "./stream";
import type { OpenAIExtra } from "./types";
/** Configuration for `openai.retrievalModel()`. */
export interface OpenAIRetrievalModelConfig {
    model: string;
}
/** Configuration for `openai.reranker()`. */
export interface OpenAIRerankerConfig extends OpenAIRetrievalModelConfig {
    name?: string;
    topN?: number;
    document?: (hit: RetrieverHit) => string;
}
/**
 * Public OpenAI provider runtime.
 *
 * OpenAI is a single-turn provider: the SDK exposes one chat call or stream
 * per turn, while Crux owns prompt resolution, tool loops, validation retry,
 * safety, observability, and memory capture.
 */
export declare const openaiProviderRuntime: import("@use-crux/core/adapter").DefinedSingleTurnProviderRuntime<OpenAI, OpenAI.Chat.Completions.ChatCompletion, OpenAIChatStream, OpenAIExtra, Record<string, never>, {
    retrievalModel(config: OpenAIRetrievalModelConfig): RetrievalModel;
    reranker(config: OpenAIRerankerConfig): Reranker;
}, Readonly<{
    generateImage: import("@use-crux/core/adapter").BoundCompletedOperation<string, (Readonly<{
        n?: number;
        seed?: number;
        abortSignal?: AbortSignal;
        timeout?: import("@use-crux/core").OperationTimeout;
        guardrails?: readonly import("@use-crux/core").Guardrail[];
        safety?: import("@use-crux/core/safety").SafetyTuneOptions;
    }> & (Readonly<{
        size?: `${number}x${number}`;
        aspectRatio?: never;
    }> | Readonly<{
        size?: never;
        aspectRatio?: `${number}:${number}`;
    }>)) & (({
        readonly input?: undefined;
    } | {
        readonly input?: never;
    }) & {
        readonly model: string;
        readonly prompt: import("@use-crux/core").ImagePrompt;
        readonly extra?: import("./image-generation").OpenAIImageExtra | undefined;
    }), Omit<import("@use-crux/core/adapter").GenerateImagePayload<OpenAI.Images.ImagesResponse & {
        _request_id?: string | null;
    }, {
        size?: "1024x1024" | "1536x1024" | "1024x1536" | undefined;
        quality?: "high" | "medium" | "low" | undefined;
        background?: "opaque" | "transparent" | undefined;
        created: number;
    }, never>, "_meta"> & {
        readonly _meta: Readonly<Omit<Record<never, never>, keyof import("@use-crux/core").OperationResultMeta> & import("@use-crux/core").OperationResultMeta>;
    }>;
}> & Readonly<{
    transcribe: import("@use-crux/core/adapter").BoundCompletedOperation<string, import("./transcription").OpenAITranscriptionInput, Omit<import("@use-crux/core/adapter").TranscriptionPayload<OpenAI.Audio.Transcriptions.TranscriptionCreateResponse | OpenAI.Audio.Translations.TranslationCreateResponse, {
        usage: OpenAI.Audio.Transcriptions.Transcription.Tokens | OpenAI.Audio.Transcriptions.Transcription.Duration | OpenAI.Audio.Transcriptions.TranscriptionDiarized.Tokens | OpenAI.Audio.Transcriptions.TranscriptionDiarized.Duration | OpenAI.Audio.Transcriptions.TranscriptionVerbose.Usage;
    }, string>, "_meta"> & {
        readonly _meta: Readonly<Omit<Record<never, never>, keyof import("@use-crux/core").OperationResultMeta> & import("@use-crux/core").OperationResultMeta>;
    }>;
}> & Readonly<{
    generateSpeech: import("@use-crux/core/adapter").BoundCompletedOperation<string, Readonly<{
        model: string;
        text: string;
        voice?: string | OpenAI.Audio.Speech.SpeechCreateParams.ID | undefined;
        outputFormat?: string;
        instructions?: string;
        speed?: number;
        language?: string;
        abortSignal?: AbortSignal;
        timeout?: Readonly<{
            totalMs?: number;
            stepMs?: number;
        }> | undefined;
        guardrails?: readonly import("@use-crux/core").Guardrail[];
        safety?: import("@use-crux/core/safety").SafetyTuneOptions;
        extra?: import("./speech").OpenAISpeechExtra | undefined;
    }>, Omit<import("@use-crux/core/adapter").GenerateSpeechPayload<Response, unknown, never>, "_meta"> & {
        readonly _meta: Readonly<Omit<Record<never, never>, keyof import("@use-crux/core").OperationResultMeta> & import("@use-crux/core").OperationResultMeta>;
    }>;
}> & Readonly<{
    streamImage: import("@use-crux/core/adapter").BoundStreamingOperation<string, import("./image-streaming-options").OpenAIImageStreamInput, import("@use-crux/core").ImageStreamEvent, Omit<import("@use-crux/core/adapter").GenerateImagePayload<OpenAI.Images.ImageGenCompletedEvent, Readonly<{
        background: "transparent" | "opaque" | "auto";
        created_at: number;
        output_format: "png" | "webp" | "jpeg";
        quality: "low" | "medium" | "high" | "auto";
        size: "1024x1024" | "1024x1536" | "1536x1024" | "auto";
        usage: OpenAI.Images.ImageGenCompletedEvent.Usage;
    }>, never>, "_meta"> & {
        readonly _meta: Readonly<Omit<Record<never, never>, keyof import("@use-crux/core").OperationResultMeta> & import("@use-crux/core").OperationResultMeta>;
    }>;
}> & Readonly<{
    streamSpeech: import("@use-crux/core/adapter").BoundStreamingOperation<string, Readonly<{
        model: string;
        text: string;
        voice?: string | OpenAI.Audio.Speech.SpeechCreateParams.ID | undefined;
        outputFormat?: string;
        instructions?: string;
        speed?: number;
        language?: string;
        abortSignal?: AbortSignal;
        timeout?: Readonly<{
            totalMs?: number;
            stepMs?: number;
        }> | undefined;
        guardrails?: readonly import("@use-crux/core").Guardrail[];
        safety?: import("@use-crux/core/safety").SafetyTuneOptions;
        extra?: import("./speech").OpenAISpeechExtra | undefined;
    }>, import("@use-crux/core").SpeechStreamEvent, Omit<import("@use-crux/core/adapter").GenerateSpeechPayload<Response, unknown, never>, "_meta"> & {
        readonly _meta: Readonly<Omit<Record<never, never>, keyof import("@use-crux/core").OperationResultMeta> & import("@use-crux/core").OperationResultMeta>;
    }>;
}>>;
/** Create an OpenAI adapter bound to a client instance. */
export declare const createOpenAI: (client: OpenAI, deps?: Record<string, never> | undefined) => import("@use-crux/core/adapter/provider-runtime/runtime-types").SingleTurnProviderRuntime<OpenAI, OpenAI.Chat.Completions.ChatCompletion, OpenAIChatStream, OpenAIExtra> & Readonly<{
    generateImage: import("@use-crux/core/adapter").BoundCompletedOperation<string, (Readonly<{
        n?: number;
        seed?: number;
        abortSignal?: AbortSignal;
        timeout?: Readonly<{
            totalMs?: number;
            stepMs?: number;
        }>;
        guardrails?: readonly import("@use-crux/core").Guardrail[];
        safety?: import("@use-crux/core/safety").SafetyTuneOptions;
    }> & (Readonly<{
        size?: `${number}x${number}`;
        aspectRatio?: never;
    }> | Readonly<{
        size?: never;
        aspectRatio?: `${number}:${number}`;
    }>)) & (({
        readonly input?: undefined;
    } | {
        readonly input?: never;
    }) & {
        readonly model: string;
        readonly prompt: import("@use-crux/core").ImagePrompt;
        readonly extra?: import("./image-generation").OpenAIImageExtra | undefined;
    }), Omit<import("@use-crux/core/adapter").GenerateImagePayload<OpenAI.Images.ImagesResponse & {
        _request_id?: string | null;
    }, {
        size?: "1024x1024" | "1536x1024" | "1024x1536" | undefined;
        quality?: "high" | "medium" | "low" | undefined;
        background?: "opaque" | "transparent" | undefined;
        created: number;
    }, never>, "_meta"> & {
        readonly _meta: Readonly<Omit<Record<never, never>, keyof import("@use-crux/core").OperationResultMeta> & import("@use-crux/core").OperationResultMeta>;
    }>;
}> & Readonly<{
    transcribe: import("@use-crux/core/adapter").BoundCompletedOperation<string, import("./transcription").OpenAITranscriptionInput, Omit<import("@use-crux/core/adapter").TranscriptionPayload<OpenAI.Audio.Transcriptions.TranscriptionCreateResponse | OpenAI.Audio.Translations.TranslationCreateResponse, {
        usage: OpenAI.Audio.Transcriptions.Transcription.Tokens | OpenAI.Audio.Transcriptions.Transcription.Duration | OpenAI.Audio.Transcriptions.TranscriptionDiarized.Tokens | OpenAI.Audio.Transcriptions.TranscriptionDiarized.Duration | OpenAI.Audio.Transcriptions.TranscriptionVerbose.Usage;
    }, string>, "_meta"> & {
        readonly _meta: Readonly<Omit<Record<never, never>, keyof import("@use-crux/core").OperationResultMeta> & import("@use-crux/core").OperationResultMeta>;
    }>;
}> & Readonly<{
    generateSpeech: import("@use-crux/core/adapter").BoundCompletedOperation<string, Readonly<{
        model: string;
        text: string;
        voice?: string | OpenAI.Audio.Speech.SpeechCreateParams.ID | undefined;
        outputFormat?: string;
        instructions?: string;
        speed?: number;
        language?: string;
        abortSignal?: AbortSignal;
        timeout?: Readonly<{
            totalMs?: number;
            stepMs?: number;
        }> | undefined;
        guardrails?: readonly import("@use-crux/core").Guardrail[];
        safety?: import("@use-crux/core/safety").SafetyTuneOptions;
        extra?: import("./speech").OpenAISpeechExtra | undefined;
    }>, Omit<import("@use-crux/core/adapter").GenerateSpeechPayload<Response, unknown, never>, "_meta"> & {
        readonly _meta: Readonly<Omit<Record<never, never>, keyof import("@use-crux/core").OperationResultMeta> & import("@use-crux/core").OperationResultMeta>;
    }>;
}> & Readonly<{
    streamImage: import("@use-crux/core/adapter").BoundStreamingOperation<string, import("./image-streaming-options").OpenAIImageStreamInput, import("@use-crux/core").ImageStreamEvent, Omit<import("@use-crux/core/adapter").GenerateImagePayload<OpenAI.Images.ImageGenCompletedEvent, Readonly<{
        background: "transparent" | "opaque" | "auto";
        created_at: number;
        output_format: "png" | "webp" | "jpeg";
        quality: "low" | "medium" | "high" | "auto";
        size: "1024x1024" | "1024x1536" | "1536x1024" | "auto";
        usage: OpenAI.Images.ImageGenCompletedEvent.Usage;
    }>, never>, "_meta"> & {
        readonly _meta: Readonly<Omit<Record<never, never>, keyof import("@use-crux/core").OperationResultMeta> & import("@use-crux/core").OperationResultMeta>;
    }>;
}> & Readonly<{
    streamSpeech: import("@use-crux/core/adapter").BoundStreamingOperation<string, Readonly<{
        model: string;
        text: string;
        voice?: string | OpenAI.Audio.Speech.SpeechCreateParams.ID | undefined;
        outputFormat?: string;
        instructions?: string;
        speed?: number;
        language?: string;
        abortSignal?: AbortSignal;
        timeout?: Readonly<{
            totalMs?: number;
            stepMs?: number;
        }> | undefined;
        guardrails?: readonly import("@use-crux/core").Guardrail[];
        safety?: import("@use-crux/core/safety").SafetyTuneOptions;
        extra?: import("./speech").OpenAISpeechExtra | undefined;
    }>, import("@use-crux/core").SpeechStreamEvent, Omit<import("@use-crux/core/adapter").GenerateSpeechPayload<Response, unknown, never>, "_meta"> & {
        readonly _meta: Readonly<Omit<Record<never, never>, keyof import("@use-crux/core").OperationResultMeta> & import("@use-crux/core").OperationResultMeta>;
    }>;
}> & {
    retrievalModel(config: OpenAIRetrievalModelConfig): RetrievalModel;
    reranker(config: OpenAIRerankerConfig): Reranker;
};
/** Lightweight helper factory generated from the OpenAI provider runtime. */
export declare const openAIHelpers: import("@use-crux/core/adapter").NativeChatHelpers<OpenAI>;