import type { Message, SystemMessageContent } from '@agforge/core';
/**
 * 将 parts 注入到 messages 中第一个 system 消息。
 *
 * - 若已存在 system 消息，将 parts 合并到其 content 中（由 position 决定前置或追加）
 * - 若不存在 system 消息，在 messages 头部创建新的 system 消息
 *
 * 多个拦截器共享此逻辑：
 * - systemPrompt：prepend（确保系统提示词位于最前）
 * - iterationLimit：append（预警追加在 system 消息末尾）
 * - environmentInject（system 模式）：append（环境信息追加在 system 消息末尾）
 *
 * @param messages - 只读消息数组
 * @param parts - 要注入的 text part 或 part 数组
 * @param position - 注入位置：'prepend' 前置到 content 头部，'append' 追加到 content 末尾
 * @returns 新的消息数组（不修改原始数组）
 */
export declare const injectIntoFirstSystemMessage: (messages: ReadonlyArray<Message>, parts: SystemMessageContent | Array<SystemMessageContent>, position?: "prepend" | "append") => Array<Message>;