import type { Context, ImageContent, Message, Model } from "@oh-my-pi/pi-ai";
import { type ImageResizeOptions } from "./image-resize.js";
export interface LoadImageInputOptions {
    path: string;
    cwd: string;
    autoResize: boolean;
    maxBytes?: number;
    resolvedPath?: string;
    detectedMimeType?: string;
    /** Force non-WebP output (e.g. for Ollama). Leave unset to honor `OMP_NO_WEBP`. */
    excludeWebP?: boolean;
}
/** Options for loading an in-memory chat image attachment as a vision-model input. */
export interface LoadImageAttachmentInputOptions {
    image: ImageContent;
    label: string;
    uri: string;
    autoResize: boolean;
    maxBytes?: number;
    /** Force non-WebP output (e.g. for Ollama). Leave unset to honor `OMP_NO_WEBP`. */
    excludeWebP?: boolean;
}
export interface LoadedImageInput {
    resolvedPath: string;
    mimeType: string;
    data: string;
    textNote: string;
    dimensionNote?: string;
    bytes: number;
}
export interface NormalizeModelContextImagesOptions {
    /** Model the images are bound for; used to derive encoder constraints (WebP exclusion for Ollama). */
    model?: Model;
    resize?: ImageResizeOptions;
}
/**
 * Normalize image blocks before they enter agent/model context. This keeps
 * provider request construction from having to resize an unbounded batch of
 * large images on the streaming hot path. Images are processed sequentially on
 * purpose: `resizeImage` may fan out multiple encoders for one image, so the
 * outer image batch must stay bounded.
 */
export declare function normalizeModelContextImages(images: ImageContent[] | undefined, options?: NormalizeModelContextImagesOptions): Promise<ImageContent[] | undefined>;
/**
 * Rewrites historical/resumed WebP blocks in the ephemeral provider request.
 * Persisted session messages remain untouched, while STB-backed local servers
 * never receive a format they cannot decode.
 */
export declare function normalizeModelContextMessages(messages: Message[], model: Model | undefined): Promise<Message[]>;
/** Normalizes historical image blocks in an ephemeral provider request. */
export declare function normalizeProviderContextImagesForModel(context: Context, model: Model): Promise<Context>;
export declare function loadImageInput(options: LoadImageInputOptions): Promise<LoadedImageInput | null>;
/** Rasterizes an explicitly selected local SVG/SVGZ into a vision-model image input. */
export declare function loadSvgImageInput(options: LoadImageInputOptions): Promise<LoadedImageInput | null>;
/** Decodes a local HEIC, HEIF or AVIF still image with ffmpeg into a vision-model image input. */
export declare function loadHeifImageInput(options: LoadImageInputOptions, signal?: AbortSignal): Promise<LoadedImageInput>;
/** Loads a chat attachment image through the same size and encoder policy as file-backed image inputs. */
export declare function loadImageAttachmentInput(options: LoadImageAttachmentInputOptions): Promise<LoadedImageInput | null>;