AgentDevelopmentSession.hpp

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include <cstdint>
#include <string>
#include <string_view>
#include <vector>
 
namespace eve::dev {
 
enum class AgentDevelopmentPhase { Discover, Modify, Run, Observe, Verify, Recover, Complete, Aborted };
 
struct AgentAcceptanceCriterion {
    std::string id;
    std::string description;
    bool        required = true;
    bool        passed   = false;
};
 
struct AgentDevelopmentEvidence {
    std::uint64_t sequence = 0;
    std::string   criterionId;
    std::string   kind;
    std::string   status;
    std::string   summary;
    std::string   artifact;
};
 
struct [[nodiscard]] AgentDevelopmentResult {
    std::string code;
    std::string message;
 
    bool isAccepted() const { return code == "applied"; }
};
 
class EVENGINE_API_FOUNDATION AgentDevelopmentSession final {
public:
    static AgentDevelopmentSession& instance();
 
    [[nodiscard]] AgentDevelopmentResult start(std::string objective,
                                               std::vector<AgentAcceptanceCriterion> criteria);
    [[nodiscard]] AgentDevelopmentResult advance(std::string_view sessionId, AgentDevelopmentPhase phase);
    [[nodiscard]] AgentDevelopmentResult record(std::string_view sessionId, AgentDevelopmentEvidence evidence);
    [[nodiscard]] AgentDevelopmentResult complete(std::string_view sessionId, std::string summary);
    [[nodiscard]] AgentDevelopmentResult abort(std::string_view sessionId, std::string reason);
    void reset();
 
    bool active() const;
    const std::string& sessionId() const { return sessionId_; }
    AgentDevelopmentPhase phase() const { return phase_; }
    const std::string& objective() const { return objective_; }
    const std::string& summary() const { return summary_; }
    const std::vector<AgentAcceptanceCriterion>& criteria() const { return criteria_; }
    const std::vector<AgentDevelopmentEvidence>& evidence() const { return evidence_; }
    bool readyToComplete() const;
 
private:
    AgentDevelopmentSession() = default;
 
    std::string                            sessionId_;
    std::string                            objective_;
    std::string                            summary_;
    AgentDevelopmentPhase                  phase_ = AgentDevelopmentPhase::Aborted;
    std::vector<AgentAcceptanceCriterion>  criteria_;
    std::vector<AgentDevelopmentEvidence>  evidence_;
    std::uint64_t                          nextSession_  = 1;
    std::uint64_t                          nextEvidence_ = 1;
};
 
EVENGINE_API_FOUNDATION std::string_view agentDevelopmentPhaseName(AgentDevelopmentPhase phase);
[[nodiscard]] AgentDevelopmentResult parseAgentDevelopmentPhase(std::string_view name,
                                                                AgentDevelopmentPhase* phase);
 
}  // namespace eve::dev