agent.hpp

Go to the documentation of this file.

// SPDX-License-Identifier: AGPL-3.0-only
// Copyright (c) 2026 ForestHub. All rights reserved.
// For commercial licensing, visit https://github.com/ForestHubAI/fh-sdk
 
#ifndef FORESTHUB_AGENT_AGENT_HPP
#define FORESTHUB_AGENT_AGENT_HPP

 
#include <memory>
#include <string>
#include <vector>
 
#include "foresthub/core/options.hpp"
#include "foresthub/core/tools.hpp"
#include "foresthub/core/types.hpp"
#include "foresthub/util/optional.hpp"
 
namespace foresthub {
namespace agent {

class Runner;

class Agent {
public:
    explicit Agent(std::string name);

    Agent& WithInstructions(std::string instructions);

    Agent& WithResponseFormat(core::ResponseFormat format);

    Agent& WithOptions(core::Options options);

    Agent& WithTools(std::vector<std::shared_ptr<core::Tool>> tools);

    Agent& AddTool(std::shared_ptr<core::Tool> tool);

    std::shared_ptr<core::ExternalTool> FindExternalTool(const std::string& name) const;

    std::shared_ptr<core::Tool> AsTool(std::string tool_name, std::string description,
                                       const std::shared_ptr<Runner>& runner);

    const std::string& name() const { return name_; }
    const std::string& instructions() const { return instructions_; }
    const foresthub::Optional<core::ResponseFormat>& response_format() const { return response_format_; }
    const core::Options& options() const { return options_; }
    const std::vector<std::shared_ptr<core::Tool>>& tools() const { return tools_; }
 
private:
    std::string name_;                                           
    std::string instructions_;                                   
    foresthub::Optional<core::ResponseFormat> response_format_;  
    core::Options options_;                                      
    std::vector<std::shared_ptr<core::Tool>> tools_;             
};
 
}  // namespace agent
}  // namespace foresthub
 
#endif  // FORESTHUB_AGENT_AGENT_HPP