agent-context 0.1.2

//! AgentContext → 请求者的通知消息。
//!
//! 这些消息由 `AgentContext` Actor 发出，通知订阅者或压缩消息或摘要后编辑者 Actor。

use crate::role::Role;

// ---------------------------------------------------------------------------
// NotifyChange
// ---------------------------------------------------------------------------

/// incremental 区的变更通知，通过 [`subscribe_change`](crate::AgentContext::subscribe_change) 发送给订阅者。
#[derive(Debug, Clone)]
pub enum NotifyChange<M> {
    /// 追加了一条消息
    Appended(M),
    /// 更新了指定索引的消息，同时给出旧值和新值
    Updated {
        /// incremental 区索引
        index: usize,
        /// 旧消息
        old: M,
        /// 新消息
        new: M,
    },
    /// 在指定索引插入了消息
    Inserted {
        /// incremental 区索引
        index: usize,
        /// 插入的消息
        message: M,
    },
    /// 移除了指定索引的消息
    Removed {
        /// incremental 区索引
        index: usize,
        /// 被移除的消息
        message: M,
    },
    /// 弹出了最后一条消息
    Popped(M),
    /// 按角色保留，其余消息被移除
    Retained {
        /// 保留的角色
        role: Role,
        /// 被移除的消息列表
        removed: Vec<M>,
    },
    /// 清空了整个 incremental 区
    Cleared {
        /// 被清空的所有消息
        removed: Vec<M>,
    },
}

// ---------------------------------------------------------------------------
// NotifyCompressedForReply
// ---------------------------------------------------------------------------

/// 压缩完成通知，通过 [`subscribe_compressed`](crate::AgentContext::subscribe_compressed) 注册的压缩消息或摘要后编辑者 Actor 处理。
///
/// `AgentContext` 压缩完成后将摘要和保留消息发送给压缩消息或摘要后编辑者 Actor，
/// 压缩消息或摘要后编辑者 Actor 返回修改后的 `(摘要, 保留)` 对，`AgentContext` 再写入对应区域。
#[derive(Debug, Clone)]
pub struct NotifyCompressedForReply<M> {
    /// LLM 生成的摘要消息
    pub summary: Vec<M>,
    /// 保留的最近消息
    pub kept: Vec<M>,
}