import type { IMessage } from '@blueking/chat-helper';
/**
 * 消息基础接口，用于泛型约束
 */
interface IMessageLike {
    id?: number | string;
    role: string;
}
/**
 * 判断消息列表中是否存在「真实会话内容」。
 *
 * pause 预设消息（property.extra.pause）仅用于初始化展示，不算用户发起的真实对话；
 * 其余消息均视为真实内容。
 *
 * 这是「当前会话是否为空」的统一判断口径：sessionContentCount 是后端快照，聊天过程中
 * 不会更新，因此发消息后必须以实时消息列表为准。UI（hasSessionContents）与业务管理器
 * （createNewSession）都应使用此函数，避免两处判断不一致。
 *
 * @param messages 消息列表
 * @returns 是否存在真实会话内容
 */
export declare function hasRealMessageContent(messages: readonly IMessage[]): boolean;
/**
 * 在消息列表中查找目标消息之前最近的用户消息
 *
 * @description 遍历消息列表，找到目标消息之前最后一条 role 为 'user' 且有 id 的消息。
 * 常用于：
 * - 提交反馈时找到对应的用户消息 ID
 * - 删除 AI 消息组时找到关联的用户消息
 * - 重新生成时找到原始的用户消息
 *
 * @param messages - 完整的消息列表
 * @param targetMessage - 目标消息（通常是 AI 消息组的第一条）
 * @returns 用户消息，如果未找到则返回 null
 */
export declare function findLastUserMessageBefore<T extends IMessageLike>(messages: T[], targetMessage: T): null | T;
/**
 * 获取用户消息的数字 ID
 *
 * @description 便捷函数，组合 findLastUserMessageBefore 和 ID 提取
 *
 * @param messages - 完整的消息列表
 * @param targetMessage - 目标消息（通常是 AI 消息组的第一条）
 * @returns 用户消息的数字 ID，如果未找到则返回 undefined
 */
export declare function findLastUserMessageIdBefore<T extends IMessageLike>(messages: T[], targetMessage: T): number | undefined;
export {};
//# sourceMappingURL=message-utils.d.ts.map