handoff.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_HANDOFF_HPP
#define FORESTHUB_AGENT_HANDOFF_HPP

 
#include <memory>
#include <string>
#include <utility>
 
#include "foresthub/agent/agent.hpp"
#include "foresthub/core/model.hpp"
#include "foresthub/core/tools.hpp"
#include "foresthub/util/json.hpp"
 
namespace foresthub {
namespace agent {
 
using json = nlohmann::json;

class Handoff : public foresthub::core::ExternalToolBase {
public:
    std::shared_ptr<Agent> target_agent;  
    core::ModelID model;                  

    Handoff(std::string name, std::string description, std::shared_ptr<Agent> agent,
            foresthub::core::ModelID model = "")
        : target_agent(std::move(agent)), model(std::move(model)) {
        this->name = std::move(name);
        this->description = std::move(description);
 
        parameters = json{{"type", "object"}, {"properties", json::object()}};
    }

    core::ToolType GetToolType() const override { return core::ToolType::kHandoff; }
};

inline std::shared_ptr<Handoff> NewHandoff(std::string name, std::string description, std::shared_ptr<Agent> agent,
                                           core::ModelID model = "") {
    return std::make_shared<Handoff>(std::move(name), std::move(description), std::move(agent), std::move(model));
}
 
}  // namespace agent
}  // namespace foresthub
 
#endif  // FORESTHUB_AGENT_HANDOFF_HPP