import type { InteractiveReply, MessagePresentation, ReplyPayloadDelivery } from "../interactive/payload.js";
export type ReplyPayload = {
    text?: string;
    mediaUrl?: string;
    mediaUrls?: string[];
    /** Internal-only trust signal for gateway webchat local media embedding. */
    trustedLocalMedia?: boolean;
    /** Treat media as live-only content and avoid persisting the underlying media reference. */
    sensitiveMedia?: boolean;
    /** Channel-agnostic rich presentation. Core degrades or asks the channel renderer to map it. */
    presentation?: MessagePresentation;
    /** Channel-agnostic delivery preferences, e.g. pin the sent message when supported. */
    delivery?: ReplyPayloadDelivery;
    /**
     * @deprecated Use presentation.
     *
     * Internal legacy representation used by existing approval/reply helpers during migration.
     */
    interactive?: InteractiveReply;
    btw?: {
        question: string;
    };
    replyToId?: string;
    replyToTag?: boolean;
    /** True when [[reply_to_current]] was present but not yet mapped to a message id. */
    replyToCurrent?: boolean;
    /** Send audio as voice message (bubble) instead of audio file. Defaults to false. */
    audioAsVoice?: boolean;
    /**
     * Text synthesized into an audio-only TTS payload. Exposed to hooks for
     * archival/search use when no visible channel text is sent.
     */
    spokenText?: string;
    /**
     * Marks a TTS media payload as supplemental audio for assistant text that is
     * already visible through streaming or transcript projection.
     */
    ttsSupplement?: ReplyPayloadTtsSupplement;
    isError?: boolean;
    /** Marks this payload as a reasoning/thinking block. Channels that do not
     *  have a dedicated reasoning lane (e.g. WhatsApp, web) should suppress it. */
    isReasoning?: boolean;
    /** Marks this payload as a compaction status notice (start/end).
     *  Should be excluded from TTS transcript accumulation so compaction
     *  status lines are not synthesised into the spoken assistant reply. */
    isCompactionNotice?: boolean;
    /** Marks this payload as a model-fallback transition/recovery notice. */
    isFallbackNotice?: boolean;
    /** Channel-specific payload data (per-channel envelope). */
    channelData?: Record<string, unknown>;
};
export type ReplyPayloadTtsSupplement = {
    spokenText: string;
    visibleTextAlreadyDelivered?: boolean;
};
export declare const REPLY_MEDIA_FAILURE_WARNING = "\u26A0\uFE0F Media failed.";
export declare function appendReplyMediaFailureWarning(text: string | undefined): string;
export declare function getReplyPayloadTtsSupplement(payload: Pick<ReplyPayload, "mediaUrl" | "mediaUrls" | "ttsSupplement">): ReplyPayloadTtsSupplement | undefined;
export declare function isReplyPayloadTtsSupplement(payload: Pick<ReplyPayload, "mediaUrl" | "mediaUrls" | "ttsSupplement">): boolean;
export declare function markReplyPayloadAsTtsSupplement<T extends ReplyPayload>(payload: T, spokenText?: string, options?: {
    visibleTextAlreadyDelivered?: boolean;
}): T;
export declare function buildTtsSupplementMediaPayload(payload: ReplyPayload): ReplyPayload;
export type ReplyPayloadMetadata = {
    assistantMessageIndex?: number;
    /**
     * Internal Klaw notices generated after a runtime/provider failure are
     * not assistant source replies. Dispatch may deliver them even when normal
     * assistant source replies are message-tool-only; sendPolicy deny still wins.
     */
    deliverDespiteSourceReplySuppression?: boolean;
    /**
     * A message-tool reply to the active internal UI source. The final payload is
     * still the live delivery vehicle; this mirror makes the reply durable for
     * chat.history and page reloads without turning the internal UI into an
     * outbound channel.
     */
    sourceReplyTranscriptMirror?: {
        sessionKey: string;
        agentId?: string;
        text?: string;
        mediaUrls?: string[];
        idempotencyKey?: string;
    };
    beforeAgentRunBlocked?: boolean;
};
export declare function setReplyPayloadMetadata<T extends object>(payload: T, metadata: ReplyPayloadMetadata): T;
export declare function getReplyPayloadMetadata(payload: object): ReplyPayloadMetadata | undefined;
export declare function copyReplyPayloadMetadata<T extends object>(source: object, payload: T): T;
export declare function markReplyPayloadForSourceSuppressionDelivery<T extends object>(payload: T): T;