Tier-specific model configuration. More...

#include <entropic/types/config.h>

Inheritance diagram for entropic::TierConfig:

Collaboration diagram for entropic::TierConfig:

Public Member Functions
bool	has_capability (const std::string &name) const
	Return true if this tier declares the named capability.

std::string	get_param (const std::string &param_name) const
	Get a named parameter derived from tier config fields.

Public Attributes
std::optional< std::filesystem::path >	identity
	Identity prompt path (nullopt = bundled)

bool	identity_disabled = false
	true if identity explicitly disabled

std::optional< std::filesystem::path >	grammar
	Grammar file path.

std::optional< std::string >	auto_chain
	Target tier name (nullopt = defer to identity)

std::optional< bool >	routable
	None = defer to identity frontmatter.

std::optional< std::filesystem::path >	adapter_path
	Optional path to LoRA adapter .gguf file.

float	adapter_scale = 1.0f
	LoRA scaling factor (0.0–2.0, default 1.0).

std::vector< std::string >	capabilities
	Declared tier capabilities (gh#41).

Public Attributes inherited from entropic::ModelConfig
std::filesystem::path	path
	Resolved model file path.

std::string	adapter = "qwen35"
	Chat adapter name.

int	context_length = 16384
	Context window size (512–131072)

int	gpu_layers = -1
	GPU offload layers (-1 = all)

bool	keep_warm = false
	Pre-warm model at startup.

bool	use_mlock = true
	Lock model in system RAM.

int	reasoning_budget = -1
	Think token budget (-1 = unlimited)

std::string	cache_type_k = "f16"
	KV cache key quantization type.

std::string	cache_type_v = "f16"
	KV cache value quantization type.

int	n_batch = 512
	Batch size for prompt processing.

int	n_threads = 0
	CPU threads (0 = auto-detect)

std::string	tensor_split
	Multi-GPU tensor split ratios (empty = single GPU)

bool	flash_attn = true
	Enable flash attention.

std::optional< std::vector< std::string > >	allowed_tools
	Tool whitelist (nullopt = all)

std::filesystem::path	mmproj_path
	Vision projector GGUF path.

std::string	model_format = "gguf"
	Expected model format.

Detailed Description

Tier-specific model configuration.

Extends ModelConfig with identity resolution and tier-specific behavioral fields. Identity prompt resolution: absent/nullopt → bundled default (ships with entropic-engine) disabled=true → disabled entirely path set → custom file (must exist, validated at load)

Version: 1.9.2 — added adapter_path, adapter_scale

Definition at line 286 of file config.h.

Member Function Documentation

◆ get_param()

std::string entropic::TierConfig::get_param ( const std::string & param_name ) const

inline

Get a named parameter derived from tier config fields.

Encapsulates policy mappings (e.g., auto_chain presence implies no explicit_completion). Keeps this logic on the data struct instead of in facade callbacks.

Parameters

param_name Parameter name (e.g., "explicit_completion").

Returns: Value string, or empty if unknown. @utility

Version: 2.0.1

Definition at line 344 of file config.h.

◆ has_capability()

bool entropic::TierConfig::has_capability ( const std::string & name ) const

inline

Return true if this tier declares the named capability.

Parameters

name	Lowercase capability name (e.g., "vision").

Returns: true if the capabilities vector contains name. @utility

Version: 2.1.8

Definition at line 325 of file config.h.

Member Data Documentation

◆ adapter_path

std::optional<std::filesystem::path> entropic::TierConfig::adapter_path

Optional path to LoRA adapter .gguf file.

If set, orchestrator loads and activates on tier transition.

Version: 1.9.2

Definition at line 296 of file config.h.

◆ adapter_scale

float entropic::TierConfig::adapter_scale = 1.0f

LoRA scaling factor (0.0–2.0, default 1.0).

Version: 1.9.2

Definition at line 300 of file config.h.

◆ auto_chain

std::optional<std::string> entropic::TierConfig::auto_chain

Target tier name (nullopt = defer to identity)

Definition at line 290 of file config.h.

◆ capabilities

std::vector<std::string> entropic::TierConfig::capabilities

Declared tier capabilities (gh#41).

Free-form lowercase strings — canonical values are "text" and "vision". Missing / empty in YAML resolves to {"text"} at config-load time so every pre-v2.1.8 tier config stays valid without modification. The orchestrator inspects this set when it sees a message with image content_parts; if no configured tier carries "vision", the run is rejected with ENTROPIC_ERROR_NO_VISION_TIER.

Order is not significant. Duplicates are tolerated but idiomatic configs deduplicate.

Version: 2.1.8

Definition at line 316 of file config.h.

◆ grammar

std::optional<std::filesystem::path> entropic::TierConfig::grammar

Grammar file path.

Definition at line 289 of file config.h.

◆ identity

std::optional<std::filesystem::path> entropic::TierConfig::identity

Identity prompt path (nullopt = bundled)

Definition at line 287 of file config.h.

◆ identity_disabled

bool entropic::TierConfig::identity_disabled = false

true if identity explicitly disabled

Definition at line 288 of file config.h.

◆ routable

std::optional<bool> entropic::TierConfig::routable

None = defer to identity frontmatter.

Definition at line 291 of file config.h.

The documentation for this struct was generated from the following file:

entropic/types/config.h

Public Member Functions

Public Attributes