TensorRT-LLMs/cpp/include/tensorrt_llm/batch_manager/trtGptModelOptionalParams.h

/*
 * SPDX-FileCopyrightText: Copyright (c) 2022-2024 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 * SPDX-License-Identifier: Apache-2.0
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#pragma once

#include "tensorrt_llm/batch_manager/kvCacheConfig.h"
#include "tensorrt_llm/batch_manager/peftCacheManagerConfig.h"
#include "tensorrt_llm/executor/executor.h"
#include "tensorrt_llm/runtime/common.h"

#include <cstdint>
#include <optional>
#include <utility>
#include <vector>

namespace tensorrt_llm::batch_manager
{

class TrtGptModelOptionalParams
{
    using KvCacheConfig = kv_cache_manager::KvCacheConfig;

public:
    using SizeType32 = tensorrt_llm::runtime::SizeType32;

    // 23 parameters, 23 items in initialization list
    explicit TrtGptModelOptionalParams(KvCacheConfig kvCacheConfig = KvCacheConfig{}, bool enableTrtOverlap = false,
        std::optional<std::vector<SizeType32>> deviceIds = std::nullopt, bool normalizeLogProbs = true,
        bool enableChunkedContext = true,
        PeftCacheManagerConfig const& peftCacheManagerConfig = PeftCacheManagerConfig{},
        executor::DecodingConfig decodingConfig = executor::DecodingConfig{}, bool useGpuDirectStorage = false,
        float gpuWeightsPercent = 1, std::optional<SizeType32> maxBeamWidth = std::nullopt,
        std::optional<SizeType32> maxBatchSize = std::nullopt, std::optional<SizeType32> maxNumTokens = std::nullopt,
        executor::SchedulerConfig schedulerConfig = executor::SchedulerConfig{},
        executor::ExtendedRuntimePerfKnobConfig const& extendedRuntimePerfKnobConfig
        = executor::ExtendedRuntimePerfKnobConfig{},
        std::optional<executor::DebugConfig> debugConfig = std::nullopt,
        uint64_t maxSeqIdleMicroseconds = executor::ExecutorConfig::kDefaultMaxSeqIdleMicroseconds,
        std::optional<executor::SpeculativeDecodingConfig> specDecConfig = std::nullopt,
        std::optional<executor::GuidedDecodingConfig> guidedDecodingConfig = std::nullopt,
        bool isLeaderInOrchMode = false,
        std::optional<std::vector<executor::AdditionalModelOutput>> additionalModelOutputs = std::nullopt,
        std::optional<executor::CacheTransceiverConfig> cacheTransceiverConfig = std::nullopt,
        bool gatherGenerationLogits = false, bool promptTableOffloading = false)
        : kvCacheConfig{std::move(kvCacheConfig)}
        , enableTrtOverlap{enableTrtOverlap}
        , deviceIds(std::move(deviceIds))
        , normalizeLogProbs{normalizeLogProbs}
        , enableChunkedContext{enableChunkedContext}
        , peftCacheManagerConfig(peftCacheManagerConfig)
        , decodingConfig(std::move(decodingConfig))
        , useGpuDirectStorage(useGpuDirectStorage)
        , gpuWeightsPercent(gpuWeightsPercent)
        , maxBeamWidth(maxBeamWidth)
        , maxBatchSize(maxBatchSize)
        , maxNumTokens(maxNumTokens)
        , schedulerConfig{std::move(schedulerConfig)}
        , extendedRuntimePerfKnobConfig(extendedRuntimePerfKnobConfig)
        , debugConfig{std::move(debugConfig)}
        , maxSeqIdleMicroseconds{maxSeqIdleMicroseconds}
        , speculativeDecodingConfig{specDecConfig}
        , guidedDecodingConfig{std::move(guidedDecodingConfig)}
        , isLeaderInOrchMode{isLeaderInOrchMode}
        , additionalModelOutputs{std::move(additionalModelOutputs)}
        , cacheTransceiverConfig{std::move(cacheTransceiverConfig)}
        , gatherGenerationLogits{gatherGenerationLogits}
        , promptTableOffloading{promptTableOffloading}
    {
        if (guidedDecodingConfig)
        {
            guidedDecodingConfig->validate();
        }
    }

    // 2 parameters, 23 items in initialization list
    explicit TrtGptModelOptionalParams(executor::ExecutorConfig const& executorConfig, bool isLeaderInOrchMode)
        : TrtGptModelOptionalParams(KvCacheConfig(executorConfig.getKvCacheConfig()),
            executorConfig.getEnableTrtOverlap(),
            executorConfig.getParallelConfig().value_or(executor::ParallelConfig()).getDeviceIds(),
            executorConfig.getNormalizeLogProbs(), executorConfig.getEnableChunkedContext(),
            PeftCacheManagerConfig(executorConfig.getPeftCacheConfig().value_or(executor::PeftCacheConfig())),
            executorConfig.getDecodingConfig().value_or(executor::DecodingConfig{}),
            executorConfig.getUseGpuDirectStorage(), executorConfig.getGpuWeightsPercent(),
            executorConfig.getMaxBeamWidth(), executorConfig.getMaxBatchSize(), executorConfig.getMaxNumTokens(),
            executorConfig.getSchedulerConfig(), executorConfig.getExtendedRuntimePerfKnobConfig(),
            executorConfig.getDebugConfig(), executorConfig.getMaxSeqIdleMicroseconds(),
            executorConfig.getSpecDecConfig(), executorConfig.getGuidedDecodingConfig(), isLeaderInOrchMode,
            executorConfig.getAdditionalModelOutputs(), executorConfig.getCacheTransceiverConfig(),
            executorConfig.getGatherGenerationLogits(), executorConfig.getPromptTableOffloading())
    {
    }

    friend std::ostream& operator<<(std::ostream& os, TrtGptModelOptionalParams const& self);

    KvCacheConfig kvCacheConfig;

    bool enableTrtOverlap;
    std::optional<std::vector<SizeType32>> deviceIds;
    bool normalizeLogProbs;
    bool enableChunkedContext;
    PeftCacheManagerConfig peftCacheManagerConfig;
    executor::DecodingConfig decodingConfig;
    // Use GDS to load the engines?
    bool useGpuDirectStorage;
    // Percentage of weights on the gpu at runtime
    float gpuWeightsPercent;
    std::optional<SizeType32> maxBeamWidth;
    std::optional<SizeType32> maxBatchSize;
    std::optional<SizeType32> maxNumTokens;
    executor::SchedulerConfig schedulerConfig;
    executor::ExtendedRuntimePerfKnobConfig extendedRuntimePerfKnobConfig;
    std::optional<executor::DebugConfig> debugConfig;
    // Sequence is considered idle if not updated for this amount of time.
    uint64_t maxSeqIdleMicroseconds;
    std::optional<executor::SpeculativeDecodingConfig> speculativeDecodingConfig;
    std::optional<executor::GuidedDecodingConfig> guidedDecodingConfig;
    // This rank is the leader worker in orchestrator mode
    bool isLeaderInOrchMode;
    std::optional<std::vector<executor::AdditionalModelOutput>> additionalModelOutputs;
    std::optional<executor::CacheTransceiverConfig> cacheTransceiverConfig;
    bool gatherGenerationLogits;
    // Whether to offload the prompt table to CPU and prefetching to GPU
    bool promptTableOffloading;
};

} // namespace tensorrt_llm::batch_manager