package com.superbiz.agent.harness.contract;

/**
 * 单次工具调用在「证据语义」上的结果状态（工具契约 / 进度）。
 *
 * <p>与 {@link InvocationStatus} 分工：
 * <ul>
 *   <li>InvocationStatus：调用生命周期（投影中/就绪/错误）</li>
 *   <li>EvidenceStatus：这次调用有没有拿到可引用证据</li>
 * </ul>
 * NO_EVIDENCE 仍可能是 success 的工具执行（查了但空），常记为信息无增益。
 */
public enum EvidenceStatus {

    /** 返回了可被引用的证据块。 */
    EVIDENCE_FOUND,

    /** 执行完成但范围内无证据（空结果，不是必然系统故障）。 */
    NO_EVIDENCE,

    /** 工具侧错误或无法形成合法证据观察。 */
    ERROR
}