Prompt manager implementation — frontmatter parsing, identity loading. More...

#include <entropic/prompts/manager.h>
#include <entropic/types/logging.h>
#include "yaml_util.h"
#include <ryml.hpp>
#include <c4/std/string.hpp>

Include dependency graph for manager.cpp:

Go to the source code of this file.

Namespaces
namespace	entropic
	Activate model on GPU (WARM → ACTIVE).

Functions
static std::string	entropic::prompts::trim (const std::string &s)
	Trim leading and trailing whitespace from a string.

static std::string	entropic::prompts::parse_frontmatter (const std::string &content, const std::filesystem::path &path, ryml::Tree &tree, std::string &body)
	Parse YAML frontmatter from file content into a ryml tree.

ENTROPIC_EXPORT const char *	entropic::prompts::prompt_type_to_string (PromptType type)
	Convert PromptType to string.

static PromptType	entropic::prompts::prompt_type_from_string (const std::string &type_str, const std::filesystem::path &path, std::string &err)
	Map a frontmatter type string to a PromptType.

ENTROPIC_EXPORT std::string	entropic::prompts::parse_prompt_file (const std::filesystem::path &path, PromptType expected_type, ParsedPrompt &result)
	Parse a prompt file: validate frontmatter, return body.

static void	entropic::prompts::extract_phases (ryml::ConstNodeRef root, IdentityFrontmatter &fm)
	Extract phase configs from identity frontmatter.

static void	entropic::prompts::extract_benchmark (ryml::ConstNodeRef root, IdentityFrontmatter &fm)
	Extract benchmark config from identity frontmatter.

static void	entropic::prompts::extract_sampler_knobs (ryml::ConstNodeRef root, IdentityFrontmatter &fm)
	Extract identity-specific fields from a pre-parsed ryml tree.

static void	entropic::prompts::extract_identity_flags (ryml::ConstNodeRef root, IdentityFrontmatter &fm)
	Extract the scalar loop/flag fields of an identity.

static void	entropic::prompts::extract_identity_fields (ryml::ConstNodeRef root, IdentityFrontmatter &fm)
	Extract all identity frontmatter fields into the struct.

ENTROPIC_EXPORT std::string	entropic::prompts::load_identity (const std::filesystem::path &path, ParsedIdentity &identity)
	Load an identity file: parse frontmatter + body.

ENTROPIC_EXPORT std::string	entropic::prompts::load_constitution (const std::optional< std::filesystem::path > &constitution_path, bool disabled, const std::filesystem::path &data_dir, std::string &body)
	Load constitution prompt with tri-state resolution.

static std::string	entropic::prompts::load_app_context_file (const std::filesystem::path &app_context_path, const std::filesystem::path &data_dir, std::string &body)
	Read app_context from a file, resolving bare names as bundled.

ENTROPIC_EXPORT AppContextState	entropic::prompts::classify_app_context (const std::optional< std::filesystem::path > &app_context_path, const std::optional< std::string > &app_context_content, bool disabled)
	Classify the app_context configuration.

ENTROPIC_EXPORT const char *	entropic::prompts::app_context_state_message (AppContextState state)
	The log message describing one app_context state.

ENTROPIC_EXPORT std::string	entropic::prompts::load_app_context (const std::optional< std::filesystem::path > &app_context_path, const std::optional< std::string > &app_context_content, bool disabled, const std::filesystem::path &data_dir, std::string &body)
	Load app_context prompt with tri-state resolution.

ENTROPIC_EXPORT void	entropic::prompts::load_shared_prompt_sources (const entropic::ParsedConfig &config, const std::filesystem::path &data_dir, std::string &constitution, std::string &app_context)
	Load constitution + app_context, logging any failure.

static std::string	entropic::prompts::check_constitution_source (const entropic::ParsedConfig &config, const std::filesystem::path &data_dir)
	Check a configured constitution path loads.

static std::string	entropic::prompts::check_app_context_source (const entropic::ParsedConfig &config, const std::filesystem::path &data_dir)
	Check a configured app_context path loads.

ENTROPIC_EXPORT std::string	entropic::prompts::validate_configured_prompts (const entropic::ParsedConfig &config, const std::filesystem::path &data_dir)
	Check that every CONFIGURED prompt source can actually be loaded.

ENTROPIC_EXPORT ParsedIdentity	entropic::prompts::resolve_tier_identity_full (const entropic::TierConfig &tier_config, const std::string &tier_name, const std::filesystem::path &data_dir)
	Resolve full parsed identity (body + frontmatter) for a tier.

ENTROPIC_EXPORT std::string	entropic::prompts::resolve_tier_identity (const entropic::TierConfig &tier_config, const std::string &tier_name, const std::filesystem::path &data_dir)
	Resolve the system prompt body for a named tier.

ENTROPIC_EXPORT std::string	entropic::prompts::assemble (const entropic::ParsedConfig &config, const std::filesystem::path &data_dir)
	Assemble the full system prompt from config.

Variables
static auto	s_log = entropic::log::get("prompts")

Detailed Description

Prompt manager implementation — frontmatter parsing, identity loading.

Version: 1.8.2

Definition in file manager.cpp.

Function Documentation

◆ app_context_state_message()

const char * entropic::prompts::app_context_state_message ( AppContextState state )

The log message describing one app_context state.

For every state but INLINE this is why app_context contributed no body; for FROM_PATH it is the prefix used when the named path was rejected, since a path that loads needs no explanation.

Parameters

state State to describe.

Returns: A static, null-terminated message. Distinct per state.

Version: 2.13.0

Parameters

state State to describe.

Returns: A static message, distinct per state. @req REQ-TYPE-005

Version: 2.13.0

Definition at line 513 of file manager.cpp.

◆ assemble()

std::string entropic::prompts::assemble	(	const entropic::ParsedConfig &	config,
		const std::filesystem::path &	data_dir
	)

Assemble the full system prompt from config.

Loads constitution, app_context, and default tier identity, then concatenates them. Used by the facade during configure.

Parameters

config	Parsed engine config.
data_dir	Bundled data directory.

Returns: Assembled system prompt string (may be empty if all disabled).

Version: 2.0.1

Loads constitution, app_context, and default tier identity, then concatenates. The data_dir is used for bundled fallback paths.

Parameters

config	Parsed engine config.
data_dir	Bundled data directory.

Returns: Assembled system prompt string. @dg_internal

Version: 2.13.0

Definition at line 761 of file manager.cpp.

◆ check_app_context_source()

static std::string entropic::prompts::check_app_context_source	(	const entropic::ParsedConfig &	config,
		const std::filesystem::path &	data_dir
	)

static

Check a configured app_context path loads.

Inline content (gh#141) and app_context: false are never checked — neither touches the filesystem, and both must keep working untouched.

Parameters

config	Parsed engine config.
data_dir	Bundled data directory.

Returns: Empty string when unconfigured, disabled, inline, or loadable. @dg_internal

Version: 2.13.0

Definition at line 645 of file manager.cpp.

◆ check_constitution_source()

static std::string entropic::prompts::check_constitution_source	(	const entropic::ParsedConfig &	config,
		const std::filesystem::path &	data_dir
	)

static

Check a configured constitution path loads.

Parameters

config	Parsed engine config.
data_dir	Bundled data directory.

Returns: Empty string when unconfigured, disabled, or loadable. @dg_internal

Version: 2.13.0

Definition at line 615 of file manager.cpp.

◆ classify_app_context()

AppContextState entropic::prompts::classify_app_context	(	const std::optional< std::filesystem::path > &	app_context_path,
		const std::optional< std::string > &	app_context_content,
		bool	disabled
	)

Classify the app_context configuration.

An explicit opt-out wins over everything, then inline content, then a path — the same precedence load_app_context() applies.

Parameters

app_context_path	Configured path (nullopt = none).
app_context_content	Inline text (nullopt = none).
disabled	true when `app_context: false`.

Returns: The state this configuration is in.

Version: 2.13.0

Parameters

app_context_path	Configured path (nullopt = none).
app_context_content	Inline text (nullopt = none).
disabled	true when `app_context: false`.

Returns: The state this configuration is in. @req REQ-TYPE-005

Version: 2.13.0

Definition at line 488 of file manager.cpp.

◆ extract_benchmark()

static void entropic::prompts::extract_benchmark	(	ryml::ConstNodeRef	root,
		IdentityFrontmatter &	fm
	)

static

Extract benchmark config from identity frontmatter.

Parameters

	root	ryml root node.
[out]	fm	Output identity frontmatter.

Version: 1.8.2 @dg_internal

Definition at line 213 of file manager.cpp.

◆ extract_identity_fields()

static void entropic::prompts::extract_identity_fields	(	ryml::ConstNodeRef	root,
		IdentityFrontmatter &	fm
	)

static

Extract all identity frontmatter fields into the struct.

@dg_internal

Version: 2.3.7

Definition at line 305 of file manager.cpp.

◆ extract_identity_flags()

static void entropic::prompts::extract_identity_flags	(	ryml::ConstNodeRef	root,
		IdentityFrontmatter &	fm
	)

static

Extract the scalar loop/flag fields of an identity.

Parameters

	root	YAML root node.
[out]	fm	Identity frontmatter to populate. @utility

Version: 2.9.20

Definition at line 283 of file manager.cpp.

◆ extract_phases()

static void entropic::prompts::extract_phases	(	ryml::ConstNodeRef	root,
		IdentityFrontmatter &	fm
	)

static

Extract phase configs from identity frontmatter.

Parameters

	root	ryml root node.
[out]	fm	Output identity frontmatter.

Version: 1.8.2 @dg_internal

Definition at line 187 of file manager.cpp.

◆ extract_sampler_knobs()

static void entropic::prompts::extract_sampler_knobs	(	ryml::ConstNodeRef	root,
		IdentityFrontmatter &	fm
	)

static

Extract identity-specific fields from a pre-parsed ryml tree.

Parameters

	root	ryml root node of the frontmatter.
[out]	fm	Output identity frontmatter.

Version: 2.0.6-rc18 @dg_internal

Extract the per-tier sampler knobs (gh#82/gh#85/gh#86).

Each is optional — set only when the key is present so the orchestrator can distinguish a configured per-tier value from "not set" (and leave the GenerationParams default in place). Split from extract_identity_flags to keep both under the knots ABC gate.

Parameters

	root	YAML root node.
[out]	fm	Identity frontmatter to populate. @utility

Version: 2.5.4

Definition at line 258 of file manager.cpp.

◆ load_app_context()

std::string entropic::prompts::load_app_context	(	const std::optional< std::filesystem::path > &	app_context_path,
		const std::optional< std::string > &	app_context_content,
		bool	disabled,
		const std::filesystem::path &	data_dir,
		std::string &	body
	)

Load app_context prompt with tri-state resolution.

Load app_context from inline content or a path, with tri-state resolution.

Resolution order: if disabled or app_context_path is nullopt, body is left empty (no bundled fallback — app_context is opt-in). If a path is provided and is a bare filename, it is resolved relative to data_dir/prompts/. Absolute paths and paths with directory components are used as-is.

Parameters

	app_context_path	Custom path (nullopt = disabled by default).
	disabled	true if app_context explicitly disabled.
	data_dir	Bundled data directory used to resolve bare filenames.
[out]	body	Output app_context text (empty if disabled or nullopt).

Returns: Empty string on success, error on failure.

Version: 1.8.1

Resolution order (gh#141): an explicit opt-out wins over everything; then inline content, which is used without touching the filesystem; then a path. The state that produced no body is named in the log (gh#163).

Parameters

	app_context_path	Custom path (nullopt = none configured).
	app_context_content	Inline text (nullopt = none supplied).
	disabled	true if app_context explicitly disabled.
	data_dir	Bundled data directory.
[out]	body	Output app_context text; cleared whenever no body loads.

Returns: Empty string on success, error on failure. @req REQ-TYPE-005

Version: 2.13.0 @utility

Definition at line 546 of file manager.cpp.

◆ load_app_context_file()

static std::string entropic::prompts::load_app_context_file	(	const std::filesystem::path &	app_context_path,
		const std::filesystem::path &	data_dir,
		std::string &	body
	)

static

Read app_context from a file, resolving bare names as bundled.

Split out of load_app_context in v2.11.0: adding the inline-content branch (gh#141) pushed that function to the top of the complexity report, and the two sources are independent concerns.

Parameters

	app_context_path	Configured path; a bare filename resolves under data_dir/prompts/, anything with a directory component is used as-is.
	data_dir	Bundled data directory.
[out]	body	Receives the parsed prompt body.

Returns: Empty string on success, an error message otherwise. @dg_internal

Version: 2.11.0

Definition at line 449 of file manager.cpp.

◆ load_constitution()

std::string entropic::prompts::load_constitution	(	const std::optional< std::filesystem::path > &	constitution_path,
		bool	disabled,
		const std::filesystem::path &	data_dir,
		std::string &	body
	)

Load constitution prompt with tri-state resolution.

Parameters

	constitution_path	Custom path (nullopt = bundled).
	disabled	true if constitution explicitly disabled.
	data_dir	Bundled data directory for fallback.
[out]	body	Output constitution text (empty if disabled).

Returns: Empty string on success, error on failure.

Version: 1.8.1

Parameters

	constitution_path	Custom path (nullopt = bundled).
	disabled	true if constitution explicitly disabled.
	data_dir	Bundled data directory.
[out]	body	Output constitution text.

Returns: Empty string on success, error on failure.

Version: 2.13.0 @utility

Definition at line 394 of file manager.cpp.

◆ load_identity()

std::string entropic::prompts::load_identity	(	const std::filesystem::path &	path,
		ParsedIdentity &	identity
	)

Load an identity file: parse frontmatter + body.

Convenience wrapper that additionally parses all IdentityFrontmatter fields.

Parameters

	path	Path to identity .md file.
[out]	identity	Output parsed identity.

Returns: Empty string on success, error on failure.

Version: 1.8.1

Parameters

	path	Path to identity .md file.
[out]	identity	Output parsed identity.

Returns: Empty string on success, error on failure.

Version: 1.8.2 @utility

Definition at line 340 of file manager.cpp.

◆ load_shared_prompt_sources()

void entropic::prompts::load_shared_prompt_sources	(	const entropic::ParsedConfig &	config,
		const std::filesystem::path &	data_dir,
		std::string &	constitution,
		std::string &	app_context
	)

Load constitution + app_context, logging any failure.

Load both shared prompt sources, logging rather than discarding.

gh#156: every one of the three callers that needed both bodies called the two loaders and DISCARDED their error strings, so a prompt file the engine could not parse showed up only as a false in the assembly line. This is the shared entry point those callers use.

gh#163 moved the logging INTO each loader, which is the only layer that knows which state the config was in; a failure is therefore reported whoever calls, and the corresponding body is left empty. The fatal decision belongs to validate_configured_prompts(), which runs at configure time before anything expensive happens.

Parameters

	config	Parsed engine config.
	data_dir	Bundled data directory.
[out]	constitution	Receives the constitution body (empty on failure).
[out]	app_context	Receives the app_context body (empty on failure).

Version: 2.13.0

Parameters

	config	Parsed engine config.
	data_dir	Bundled data directory.
[out]	constitution	Constitution body (empty when it failed).
[out]	app_context	App context body (empty when it failed). @req REQ-TYPE-005

Version: 2.13.0 [reviewed]

Definition at line 586 of file manager.cpp.

◆ parse_frontmatter()

static std::string entropic::prompts::parse_frontmatter	(	const std::string &	content,
		const std::filesystem::path &	path,
		ryml::Tree &	tree,
		std::string &	body
	)

static

Parse YAML frontmatter from file content into a ryml tree.

Splits content on "---" delimiters, validates structure, and returns the parsed YAML tree plus the markdown body. Shared between parse_prompt_file() and load_identity() to avoid double file reads.

Parameters

	content	Full file content.
	path	File path (for error messages).
[out]	tree	Output ryml tree of frontmatter.
[out]	body	Output markdown body after frontmatter.

Returns: Empty string on success, error on failure.

Version: 1.8.2 @dg_internal

Definition at line 58 of file manager.cpp.

◆ parse_prompt_file()

std::string entropic::prompts::parse_prompt_file	(	const std::filesystem::path &	path,
		PromptType	expected_type,
		ParsedPrompt &	result
	)

Parse a prompt file: validate frontmatter, return body.

File format: YAML frontmatter between — delimiters, followed by markdown body.

Parameters

	path	Path to .md prompt file.
	expected_type	Expected frontmatter type.
[out]	result	Output: type, version, body.

Returns: Empty string on success, error on failure.

Version: 1.8.1

Parameters

	path	Path to .md prompt file.
	expected_type	Expected frontmatter type.
[out]	result	Output: type, version, body.

Returns: Empty string on success, error on failure.

Version: 2.3.7 @utility

Definition at line 134 of file manager.cpp.

◆ prompt_type_from_string()

static PromptType entropic::prompts::prompt_type_from_string	(	const std::string &	type_str,
		const std::filesystem::path &	path,
		std::string &	err
	)

static

Map a frontmatter type string to a PromptType.

Parameters

	type_str	Frontmatter "type" value.
	path	Prompt path (for the error message).
[out]	err	Set to a diagnostic on an unknown type.

Returns: The PromptType (default-constructed on unknown). @utility

Version: 2.3.7

Definition at line 108 of file manager.cpp.

◆ prompt_type_to_string()

const char * entropic::prompts::prompt_type_to_string ( PromptType type )

Convert PromptType to string.

Parameters

type	Prompt type.

Returns: String representation.

Version: 1.8.1

Parameters

type	Prompt type.

Returns: String representation.

Version: 1.8.2 @utility

Definition at line 92 of file manager.cpp.

◆ resolve_tier_identity()

std::string entropic::prompts::resolve_tier_identity	(	const entropic::TierConfig &	tier_config,
		const std::string &	tier_name,
		const std::filesystem::path &	data_dir
	)

Resolve the system prompt body for a named tier.

Body-only wrapper around resolve_tier_identity_full.

Looks up the tier in config, resolves the identity file path (explicit, bundled convention, or disabled), loads it, and returns the markdown body. Encapsulates the path convention "identity_{tier_name}.md" in one place.

Parameters

tier_config	Tier configuration.
tier_name	Tier name (for default path convention).
data_dir	Bundled data directory.

Returns: Identity body string (empty if disabled or not found).

Version: 2.0.1

Parameters

tier_config	Tier configuration.
tier_name	Tier name (for default path convention).
data_dir	Bundled data directory.

Returns: Identity body string (empty if disabled or not found). @utility

Version: 2.0.6-rc18

Definition at line 740 of file manager.cpp.

◆ resolve_tier_identity_full()

ParsedIdentity entropic::prompts::resolve_tier_identity_full	(	const entropic::TierConfig &	tier_config,
		const std::string &	tier_name,
		const std::filesystem::path &	data_dir
	)

Resolve full parsed identity (body + frontmatter) for a tier.

Resolve a full parsed identity (body + frontmatter) for a tier.

Same resolution rules as resolve_tier_identity() but returns the full ParsedIdentity so callers can read frontmatter fields (max_iterations, max_tool_calls_per_turn, etc.) that are discarded by the body-only variant. Returns an empty-body ParsedIdentity if no identity file is found. (E6, 2.0.6-rc18)

Parameters

tier_config	Tier configuration.
tier_name	Tier name (for default path convention).
data_dir	Bundled data directory.

Returns: ParsedIdentity; body is empty if disabled or not found.

Version: 2.0.6-rc18

Path convention:

If tier has explicit identity path → use it
If identity not disabled → data_dir/prompts/identity_{tier_name}.md
If disabled or not found → empty ParsedIdentity

Parameters

tier_config	Tier configuration.
tier_name	Tier name (for default path convention).
data_dir	Bundled data directory.

Returns: ParsedIdentity; body empty when no identity resolved. @utility

Version: 2.0.6-rc18

Definition at line 704 of file manager.cpp.

◆ trim()

static std::string entropic::prompts::trim ( const std::string & s )

static

Trim leading and trailing whitespace from a string.

Parameters

s	Input string.

Returns: Trimmed string.

Version: 1.8.2 @utility

Definition at line 33 of file manager.cpp.

◆ validate_configured_prompts()

std::string entropic::prompts::validate_configured_prompts	(	const entropic::ParsedConfig &	config,
		const std::filesystem::path &	data_dir
	)

Check that every CONFIGURED prompt source can actually be loaded.

Check every configured prompt source can be loaded.

gh#156: a consumer who names a path wanted that document. Silently running with a 17 KB smaller system prompt is not an acceptable outcome, so an unreadable / unparseable constitution or app_context path is a config error. Only explicitly configured sources are checked — the bundled constitution fallback, app_context: false, inline app_context: {content: ...} and an absent key all pass.

Parameters

config	Parsed engine config.
data_dir	Bundled data directory.

Returns: Empty string when every configured source loads, else an actionable message naming the path and the supported form.

Version: 2.13.0

Parameters

config	Parsed engine config.
data_dir	Bundled data directory.

Returns: Empty string on success, an actionable message otherwise. @req REQ-TYPE-005

Version: 2.13.0

Definition at line 678 of file manager.cpp.

Variable Documentation

◆ s_log

auto s_log = entropic::log::get("prompts")

static

Definition at line 15 of file manager.cpp.

Namespaces

Functions

Variables

Detailed Description

Function Documentation

◆ app_context_state_message()

◆ assemble()

◆ check_app_context_source()

◆ check_constitution_source()

◆ classify_app_context()

◆ extract_benchmark()

◆ extract_identity_fields()

◆ extract_identity_flags()

◆ extract_phases()

◆ extract_sampler_knobs()

◆ load_app_context()

◆ load_app_context_file()

◆ load_constitution()

◆ load_identity()

◆ load_shared_prompt_sources()

◆ parse_frontmatter()

◆ parse_prompt_file()

◆ prompt_type_from_string()

◆ prompt_type_to_string()

◆ resolve_tier_identity()

◆ resolve_tier_identity_full()

◆ trim()

◆ validate_configured_prompts()

Variable Documentation

◆ s_log