export declare const AGENT_NATIVE_EMBED_PROTOCOL: "agent-native.embed";
export declare const AGENT_NATIVE_EMBED_VERSION: 1;
export declare const AGENT_NATIVE_EMBED_MESSAGE_TYPES: {
    readonly READY: "ready";
    readonly MESSAGE: "message";
    readonly REQUEST: "request";
    readonly RESPONSE: "response";
    readonly ERROR: "error";
};
export type AgentNativeEmbedMessageType = (typeof AGENT_NATIVE_EMBED_MESSAGE_TYPES)[keyof typeof AGENT_NATIVE_EMBED_MESSAGE_TYPES];
export interface AgentNativeEmbedErrorPayload {
    message: string;
    code?: string;
}
export interface AgentNativeEmbedEnvelope<TPayload = unknown> {
    protocol: typeof AGENT_NATIVE_EMBED_PROTOCOL;
    version: typeof AGENT_NATIVE_EMBED_VERSION;
    type: AgentNativeEmbedMessageType;
    name?: string;
    payload?: TPayload;
    requestId?: string;
    error?: AgentNativeEmbedErrorPayload;
}
export interface EmbeddedAppUrlOptions {
    /**
     * Add the framework's embedded route marker. Defaults to true.
     */
    embedded?: boolean;
    /**
     * Extra query params to include in the iframe URL.
     */
    params?: Record<string, string | number | boolean | null | undefined>;
}
export declare function isAgentNativeEmbedEnvelope(value: unknown): value is AgentNativeEmbedEnvelope;
export declare function createAgentNativeEmbedEnvelope<TPayload>(type: AgentNativeEmbedMessageType, options?: {
    name?: string;
    payload?: TPayload;
    requestId?: string;
    error?: AgentNativeEmbedErrorPayload;
}): AgentNativeEmbedEnvelope<TPayload>;
export declare function embeddedAppOrigin(url: string, base?: string): string | null;
export declare function isAllowedEmbeddedAppOrigin(origin: string, allowedOrigins: readonly string[] | undefined): boolean;
export declare function withEmbeddedAppParams(url: string, options?: EmbeddedAppUrlOptions): string;
export declare function createEmbeddedAppRequestId(): string;
export declare function messageErrorPayload(error: unknown): AgentNativeEmbedErrorPayload;
//# sourceMappingURL=protocol.d.ts.map