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

#include <entropic/entropic_export.h>
#include <entropic/types/config.h>
#include <filesystem>
#include <optional>
#include <string>
#include <unordered_map>
#include <vector>

Include dependency graph for manager.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	entropic::prompts::BenchmarkPrompt
	A single benchmark prompt with quality checks. More...

struct	entropic::prompts::BenchmarkSpec
	Benchmark definition for an identity. More...

struct	entropic::prompts::IdentityFrontmatter
	Identity frontmatter — full tier identity metadata. More...

struct	entropic::prompts::ParsedPrompt
	Parsed prompt file result: type + version + body. More...

struct	entropic::prompts::ParsedIdentity
	Parsed identity file: frontmatter + body. More...

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

Typedefs
using	entropic::prompts::PhaseConfig = entropic::PhaseConfig
	Alias for PhaseConfig from types/ (canonical location).

Enumerations
enum class	entropic::prompts::PromptType { CONSTITUTION , APP_CONTEXT , IDENTITY }
	Prompt file type (frontmatter "type" field). More...

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

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.

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.

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

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 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::assemble (const entropic::ParsedConfig &config, const std::filesystem::path &data_dir)
	Assemble the full system prompt from config.

Detailed Description

Prompt manager — frontmatter parsing, identity loading, assembly.

Ports Python's PromptManager and parse_prompt_file(). Handles constitution, app_context, and per-tier identity prompt files.

Version: 1.8.1

Definition in file manager.h.

Typedef Documentation

◆ PhaseConfig

using entropic::prompts::PhaseConfig = typedef entropic::PhaseConfig

Alias for PhaseConfig from types/ (canonical location).

Version: 1.9.6

Definition at line 27 of file manager.h.

Enumeration Type Documentation

◆ PromptType

enum class entropic::prompts::PromptType

strong

Prompt file type (frontmatter "type" field).

Version: 1.8.1

Enumerator
CONSTITUTION	Constitution prompt.
APP_CONTEXT	Application context prompt.
IDENTITY	Tier identity prompt.

Definition at line 33 of file manager.h.

Function Documentation

◆ 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.

Definition at line 515 of file manager.cpp.

◆ load_app_context()

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

Load app_context prompt 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

Parameters

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

Returns: Empty string on success, error on failure.

Version: 1.8.2 @utility

Definition at line 406 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: 1.8.2 @utility

Definition at line 362 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 308 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_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 494 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 458 of file manager.cpp.

Classes

Namespaces

Typedefs

Enumerations

Functions

Detailed Description

Typedef Documentation

◆ PhaseConfig

Enumeration Type Documentation

◆ PromptType

Function Documentation

◆ assemble()

◆ load_app_context()

◆ load_constitution()

◆ load_identity()

◆ parse_prompt_file()

◆ prompt_type_to_string()

◆ resolve_tier_identity()

◆ resolve_tier_identity_full()