/**
 * @file types.ts
 * @description 定义基于多级缓存记忆模型的核心领域对象。
 *
 * 该模型将 Agent 的记忆分为三个层级：
 * - L1 (工作记忆): 包含最近的、完整的交互轮次，是 Agent 进行即时响应的基础。
 * - L2 (语义索引): 由从 L1 中移出的交互轮次转化而来的、经过向量化的记忆片段，用于相关性检索。
 * - L3 (长期存档): 以“日记”形式存在的、对每日交互的高度概括和总结，提供长周期的时间感和叙事记忆。
 */
import { TableName } from "../../shared/constants";
import { Element, Session } from "koishi";
/**
 * `worldstate.members` 表的数据结构
 * 存储用户在一个特定服务器 (Guild) 内的身份信息
 */
export interface MemberData {
    pid: string;
    platform: string;
    guildId: string;
    name: string;
    roles?: string[];
    avatar?: string;
    joinedAt?: Date;
    lastActive: Date;
}
/** 消息的数据模型 */
export interface MessageData {
    id: string;
    platform: string;
    channelId: string;
    sender: {
        id: string;
        name?: string;
        roles?: string[];
    };
    timestamp: Date;
    content: string;
    quoteId?: string;
}
/** 系统事件的数据模型 */
export interface SystemEventData {
    id: string;
    platform: string;
    channelId: string;
    type: string;
    timestamp: Date;
    payload: object;
    message?: string;
}
/**
 * @description 从LLM响应中解析出的、尚未持久化的数据结构。
 * 这是 `HeartbeatProcessor` 内部流转的核心对象。
 */
export interface AgentResponse {
    thoughts: {
        observe: string;
        analyze_infer: string;
        plan: string;
    };
    actions: {
        function: string;
        params: Record<string, unknown>;
    }[];
    observations?: {
        function: string;
        status: "success" | "failed" | string;
        result?: any;
        error?: any;
    }[];
    request_heartbeat: boolean;
}
/** 交互日志中 Agent 思考事件的结构 */
export interface AgentThoughtLog {
    type: "agent_thought";
    id: string;
    turnId: string;
    timestamp: string;
    thoughts: {
        observe: string;
        analyze_infer: string;
        plan: string;
    };
}
/** 交互日志中 Agent 动作事件的结构 */
export interface AgentActionLog {
    type: "agent_action";
    id: string;
    turnId: string;
    timestamp: string;
    function: string;
    params: Record<string, unknown>;
}
/** 交互日志中 Agent 观察事件的结构 */
export interface AgentObservationLog {
    type: "agent_observation";
    id: string;
    turnId: string;
    actionId: string;
    timestamp: string;
    function: string;
    status: "success" | "failed" | string;
    result?: any;
    error?: any;
}
export interface AgentHeartbeatLog {
    type: "agent_heartbeat";
    id: string;
    turnId: string;
    timestamp: string;
    current: number;
    max: number;
}
export type AgentLogEntry = AgentThoughtLog | AgentActionLog | AgentObservationLog | AgentHeartbeatLog;
/** 交互日志中消息事件的结构 */
export interface MessageLog {
    type: "message";
    id: string;
    timestamp: string;
    sender: MessageData["sender"];
    content: string;
    quoteId?: string;
}
/** 交互日志中系统事件的结构 */
export interface SystemEventLog {
    type: "system_event";
    id: string;
    timestamp: string;
    eventType: string;
    message: string;
}
/** 写入日志文件的统一事件条目类型 */
export type InteractionLogEntry = AgentThoughtLog | AgentActionLog | AgentObservationLog | AgentHeartbeatLog | MessageLog | SystemEventLog;
/** L2 记忆片段的数据模型，存储在向量数据库中。 */
export interface MemoryChunkData {
    id: string;
    platform: string;
    channelId: string;
    content: string;
    embedding: number[];
    participantIds: string[];
    startTimestamp: Date;
    endTimestamp: Date;
}
/** L3 日记条目的数据模型 */
export interface DiaryEntryData {
    id: string;
    date: string;
    platform: string;
    channelId: string;
    content: string;
    keywords: string[];
    mentionedUserIds: string[];
}
/** 上下文中的消息对象 */
export interface ContextualMessage {
    id: string;
    sender: {
        id: string;
        name?: string;
        roles?: string[];
    };
    content: string;
    elements: Element[];
    timestamp: Date;
    quoteId?: string;
    is_new?: boolean;
}
/** 上下文中的系统事件对象 */
export interface ContextualSystemEvent {
    id: string;
    eventType: string;
    message: string;
    timestamp: Date;
    is_new?: boolean;
}
/** Agent 响应回合在上下文中的表现形式（支持优雅降级） */
/** 上下文中的 Agent 思考对象 */
export interface ContextualAgentThought {
    type: "agent_thought";
    turnId: string;
    timestamp: Date;
    observe: string;
    analyze_infer: string;
    plan: string;
    is_new?: boolean;
}
/** 上下文中的 Agent 动作对象 */
export interface ContextualAgentAction {
    type: "agent_action";
    turnId: string;
    timestamp: Date;
    function: string;
    params: Record<string, unknown>;
    is_new?: boolean;
}
/** 上下文中的 Agent 观察对象 */
export interface ContextualAgentObservation {
    type: "agent_observation";
    turnId: string;
    timestamp: Date;
    function: string;
    status: "success" | "failed" | string;
    result?: any;
    is_new?: boolean;
}
export interface AgentHeartbeat {
    type: "agent_heartbeat";
    turnId: string;
    timestamp: Date;
    current: number;
    max: number;
    is_new?: boolean;
}
/** L1 工作记忆中的单个事件条目 */
export type L1HistoryItem = ({
    type: "message";
} & ContextualMessage) | ContextualAgentThought | ContextualAgentAction | ContextualAgentObservation | AgentHeartbeat | ({
    type: "system_event";
} & ContextualSystemEvent);
/** 从 L2 语义索引中检索出的记忆片段 */
export interface RetrievedMemoryChunk {
    content: string;
    relevance: number;
    timestamp: Date;
}
/** Agent 感知到的世界状态快照，作为最终输入给 LLM 的上下文。 */
export interface WorldState {
    /** 触发本次心跳的直接原因 */
    triggerContext?: object;
    channel: {
        id: string;
        name: string;
        type: "guild" | "private";
        platform: string;
    };
    current_time: string;
    self: {
        id: string;
        name: string;
    };
    /** L1: 工作记忆，一个按时间顺序排列的线性事件流。 */
    l1_working_memory: {
        processed_events: L1HistoryItem[];
        new_events: L1HistoryItem[];
    };
    /** L2: 从海量历史中检索到的相关记忆片段 */
    l2_retrieved_memories?: RetrievedMemoryChunk[];
    /** L3: 相关的历史日记条目 */
    l3_diary_entries?: DiaryEntryData[];
    users?: {
        id: string;
        name: string;
        roles?: string[];
        description: string;
    }[];
}
/** 智能体接收到的刺激类型 */
export type StimulusType = "user_message" | "system_event" | "scheduled_task" | "background_task_completion";
/** 用户消息刺激的载荷 */
export interface UserMessagePayload {
    messageIds: string[];
}
/** 系统事件刺激的载荷 */
export interface SystemEventPayload {
    eventType: string;
    details: object;
    message: string;
}
/** Agent 接收到的外部刺激，是驱动其行为的入口。 */
export interface AgentStimulus<T> {
    type: StimulusType;
    channelCid: string;
    session: Session;
    priority: number;
    payload: T;
}
declare module "koishi" {
    interface Tables {
        [TableName.Members]: MemberData;
        [TableName.Messages]: MessageData;
        [TableName.SystemEvents]: SystemEventData;
        [TableName.L2Chunks]: MemoryChunkData;
        [TableName.L3Diaries]: DiaryEntryData;
    }
}