import type { ReceivingAdapter } from "./comms-receiving-types.js";
/** Bounds apply to a whole operation, including every page, message and download. */
export declare const AGENTMAIL_RECEIVING_LIMITS: Readonly<{
    timeoutMs: 30000;
    maxTimeoutMs: 60000;
    pages: 4;
    pageSize: 25;
    messages: 100;
    requests: 160;
    operationBytes: number;
    responseBytes: number;
    textBytes: number;
    downloadRedirects: 2;
}>;
export type AgentMailReceivingErrorCode = "agentmail_auth_rejected" | "agentmail_rate_limited" | "agentmail_unavailable" | "agentmail_timeout" | "agentmail_cancelled" | "agentmail_invalid_response" | "agentmail_ownership_mismatch" | "agentmail_not_found" | "agentmail_resource_deleting" | "agentmail_download_blocked" | "agentmail_size_limit" | "agentmail_invalid_input" | "agentmail_request_limit";
/** Safe for callers to report. Never retains the response body, URL, key or caught cause. */
export declare class AgentMailReceivingError extends Error {
    readonly code: AgentMailReceivingErrorCode;
    constructor(code: AgentMailReceivingErrorCode);
}
/** Host-only transport; the management credential is never sent to a desktop or download host. */
export declare function createAgentMailReceiver(options: {
    apiKey: string;
    fetch?: typeof globalThis.fetch;
}): ReceivingAdapter;