import type { AgentRuntime, MediaAttachment } from "./types.js";
/** Result of partitioning media by runtime capability. */
export type MediaPartition = {
    /** Media the runtime can handle natively. */
    supported: MediaAttachment[];
    /** Media the runtime cannot handle. */
    unsupported: MediaAttachment[];
};
/**
 * Partition media attachments by whether the runtime accepts them.
 *
 * If the runtime does not declare `mediaCapabilities` at all, all media is
 * treated as supported (backwards-compatible — the runtime decides what to do).
 */
export declare function partitionMedia(runtime: AgentRuntime, media: MediaAttachment[]): MediaPartition;
/**
 * Format a user-facing warning for media the runtime cannot handle.
 *
 * Returns `undefined` when there are no unsupported attachments.
 */
export declare function formatUnsupportedMediaWarning(unsupported: MediaAttachment[], runtimeName: string): string | undefined;