import type { Message, UserMessageContent } from '@agforge/core';
/**
 * 将 parts 注入到 messages 的最后一条 user 消息中。
 *
 * - 若存在 user 消息，将 parts 合并到最后一条 user 消息的 content 中（由 position 决定前置或追加）
 * - 若不存在 user 消息，返回原始数组的副本（不做任何修改）
 *
 * 多个拦截器共享此逻辑：
 * - systemReminder：append（<system-reminder> 标签追加在 user 消息末尾）
 *
 * @param messages - 只读消息数组
 * @param parts - 要注入的 content part 或 part 数组
 * @param position - 注入位置：'prepend' 前置到 content 头部，'append' 追加到 content 末尾
 * @returns 新的消息数组（不修改原始数组）
 */
export declare const injectIntoLastUserMessage: (messages: ReadonlyArray<Message>, parts: UserMessageContent | Array<UserMessageContent>, position?: "prepend" | "append") => Array<Message>;