providers.hpp

Go to the documentation of this file.

// Copyright 2026 Aniket Kulkarni
// SPDX-License-Identifier: Apache-2.0
 
 
#pragma once
 
#include "neuralplus/client.hpp"
#include "neuralplus/export.hpp"
#include "neuralplus/transport.hpp"
#include "neuralplus/types.hpp"
 
#include <memory>
#include <optional>
#include <string>
#include <vector>
 
namespace neuralplus {
 
struct NEURALPLUS_API OpenAIConfig {
    explicit OpenAIConfig(std::string model_id);
 
    ModelDescriptor model;
 
    std::optional<std::string> api_key;
 
    std::string base_url{"https://api.openai.com/v1"};
 
    std::string organization;
 
    std::string project;
 
    std::vector<HttpHeader> extra_headers;
};
 
struct NEURALPLUS_API AnthropicConfig {
    explicit AnthropicConfig(std::string model_id);
 
    ModelDescriptor model;
 
    std::optional<std::string> api_key;
 
    std::string base_url{"https://api.anthropic.com"};
 
    std::string api_version{"2023-06-01"};
 
    std::size_t default_max_output_tokens{1024};
 
    std::vector<HttpHeader> extra_headers;
};
 
struct NEURALPLUS_API GeminiConfig {
    explicit GeminiConfig(std::string model_id);
 
    ModelDescriptor model;
 
    std::optional<std::string> api_key;
 
    std::string base_url{"https://generativelanguage.googleapis.com/v1beta"};
 
    std::vector<HttpHeader> extra_headers;
};
 
struct NEURALPLUS_API OpenAICompatibleConfig {
    OpenAICompatibleConfig(std::string model_id, std::string base_url);
 
    ModelDescriptor model;
 
    std::optional<std::string> api_key;
 
    std::optional<std::string> api_key_environment;
 
    std::string base_url;
 
    std::vector<HttpHeader> extra_headers;
};
 
class NEURALPLUS_API OpenAIClient final : public AIClient {
public:
    explicit OpenAIClient(OpenAIConfig config,
                          const ClientOptions& options = {});
    ~OpenAIClient() override;
 
private:
    OpenAIClient(const OpenAIClient&) = delete;
    OpenAIClient& operator=(const OpenAIClient&) = delete;
 
    AIResponse generate_once(const AIRequest& request) override;
 
    class Impl;
    std::unique_ptr<Impl> impl_;
};
 
class NEURALPLUS_API AnthropicClient final : public AIClient {
public:
    explicit AnthropicClient(AnthropicConfig config,
                             const ClientOptions& options = {});
    ~AnthropicClient() override;
 
private:
    AnthropicClient(const AnthropicClient&) = delete;
    AnthropicClient& operator=(const AnthropicClient&) = delete;
 
    AIResponse generate_once(const AIRequest& request) override;
 
    class Impl;
    std::unique_ptr<Impl> impl_;
};
 
class NEURALPLUS_API GeminiClient final : public AIClient {
public:
    explicit GeminiClient(GeminiConfig config,
                          const ClientOptions& options = {});
    ~GeminiClient() override;
 
private:
    GeminiClient(const GeminiClient&) = delete;
    GeminiClient& operator=(const GeminiClient&) = delete;
 
    AIResponse generate_once(const AIRequest& request) override;
 
    class Impl;
    std::unique_ptr<Impl> impl_;
};
 
class NEURALPLUS_API OpenAICompatibleClient final : public AIClient {
public:
    explicit OpenAICompatibleClient(OpenAICompatibleConfig config,
                                    const ClientOptions& options = {});
    ~OpenAICompatibleClient() override;
 
private:
    OpenAICompatibleClient(const OpenAICompatibleClient&) = delete;
    OpenAICompatibleClient& operator=(const OpenAICompatibleClient&) = delete;
 
    AIResponse generate_once(const AIRequest& request) override;
 
    class Impl;
    std::unique_ptr<Impl> impl_;
};
 
[[nodiscard]] NEURALPLUS_API std::unique_ptr<AIClient>
make_client(OpenAIConfig config, const ClientOptions& options = {});
 
[[nodiscard]] NEURALPLUS_API std::unique_ptr<AIClient>
make_client(AnthropicConfig config, const ClientOptions& options = {});
 
[[nodiscard]] NEURALPLUS_API std::unique_ptr<AIClient>
make_client(GeminiConfig config, const ClientOptions& options = {});
 
[[nodiscard]] NEURALPLUS_API std::unique_ptr<AIClient>
make_client(OpenAICompatibleConfig config,
            const ClientOptions& options = {});
 
}  // namespace neuralplus