import { AudioInput } from "../contracts/transcription-model.contract.mjs";

//#region ../ai/src/transcribe/audio-input.d.ts
/**
 * Resolve the audio media type from a filename's extension, or
 * `undefined` when the extension is unknown. Case-insensitive.
 *
 * @example
 * audioMediaTypeForFilename("voice-note.opus"); // "audio/ogg"
 */
declare function audioMediaTypeForFilename(filename: string): string | undefined;
/**
 * Package raw audio bytes as an {@link AudioInput} for `ai.transcribe()`.
 * Pure plumbing — no AI, no I/O. Use when you already hold the bytes
 * (an upload buffer, a downloaded blob).
 *
 * @example
 * const audio = audioFromBuffer(uploadBuffer, "audio/ogg", "note.ogg");
 * const { data } = await ai.transcribe({ model: openai.transcribe({ name: "whisper-1" }), audio });
 */
declare function audioFromBuffer(data: Uint8Array, mediaType: string, filename?: string): AudioInput;
/**
 * Read an audio file from disk and package it as an {@link AudioInput}
 * for `ai.transcribe()` — the one-line bridge from a file on disk
 * (WhatsApp `.ogg`/`.opus`, a meeting `.m4a`, a `.wav`) to the
 * transcription verb. **Pure utility — no AI here**; the actual text
 * extraction is the AI step (`ai.transcribe`).
 *
 * The media type is inferred from the file extension (override via
 * `options.mediaType` for extensionless or mislabeled files).
 *
 * @example
 * // WhatsApp voice note → text, end to end:
 * const audio = await audioFromFile("./voice-note.ogg");
 * const { data, error } = await ai.transcribe({
 *   model: openai.transcribe({ name: "whisper-1" }),
 *   audio,
 *   language: "en",
 * });
 * if (!error) console.log(data.text);
 */
declare function audioFromFile(filePath: string, options?: {
  mediaType?: string;
}): Promise<AudioInput>;
//#endregion
export { audioFromBuffer, audioFromFile, audioMediaTypeForFilename };
//# sourceMappingURL=audio-input.d.mts.map