Centralized grammar registry for named GBNF grammars. More...

#include <entropic/inference/grammar_registry.h>

Public Member Functions
size_t	load_bundled (const std::filesystem::path &grammar_dir)
	Load all bundled grammars from a directory.

bool	register_grammar (const std::string &key, const std::string &gbnf_content, const std::string &source="runtime")
	Register a grammar by key with GBNF content string.

bool	register_from_file (const std::string &key, const std::filesystem::path &path)
	Register a grammar from a file path.

bool	deregister (const std::string &key)
	Remove a grammar from the registry.

std::string	get (const std::string &key) const
	Get GBNF content string for a grammar key.

bool	has (const std::string &key) const
	Check if a grammar key exists in the registry.

GrammarEntry	entry (const std::string &key) const
	Get full entry metadata for a grammar key.

std::vector< GrammarEntry >	list () const
	List all registered grammar keys.

size_t	size () const
	Number of registered grammars.

void	clear ()
	Remove all registered grammars.

Static Public Member Functions
static std::string	validate (const std::string &gbnf_content)
	Validate a GBNF grammar string.

Detailed Description

Centralized grammar registry for named GBNF grammars.

Single concrete class (no three-layer hierarchy — one implementation, like AdapterManager and HookRegistry).

Version: 1.9.3

Definition at line 45 of file grammar_registry.h.

Member Function Documentation

◆ clear()

void entropic::GrammarRegistry::clear ( )

Remove all registered grammars.

Version: 1.9.3

@dg_internal

Version: 1.9.3

Definition at line 298 of file grammar_registry.cpp.

◆ deregister()

bool entropic::GrammarRegistry::deregister ( const std::string & key )

Remove a grammar from the registry.

Parameters

key	Grammar name to remove.

Returns: true if removed. false if key not found.

Bundled grammars can be deregistered (allows overriding defaults).

Version: 1.9.3

Parameters

key	Grammar name to remove.

Returns: true if removed. false if key not found. @dg_internal

Version: 1.9.3

Definition at line 178 of file grammar_registry.cpp.

◆ entry()

GrammarEntry entropic::GrammarRegistry::entry ( const std::string & key ) const

Get full entry metadata for a grammar key.

Parameters

key	Grammar name.

Returns: GrammarEntry, or entry with empty key if not found.

Version: 1.9.3

Parameters

key	Grammar name.

Returns: GrammarEntry, or entry with empty key if not found. @dg_internal

Version: 1.9.3

Definition at line 224 of file grammar_registry.cpp.

◆ get()

std::string entropic::GrammarRegistry::get ( const std::string & key ) const

Get GBNF content string for a grammar key.

Parameters

key	Grammar name.

Returns: GBNF content string, or empty string if not found.

Returns content regardless of validation status.

Version: 1.9.3

Parameters

key	Grammar name.

Returns: GBNF content string, or empty string if not found. @dg_internal

Version: 1.9.3

Definition at line 196 of file grammar_registry.cpp.

◆ has()

bool entropic::GrammarRegistry::has ( const std::string & key ) const

Check if a grammar key exists in the registry.

Parameters

key	Grammar name.

Returns: true if registered.

Version: 1.9.3

Parameters

key	Grammar name.

Returns: true if registered. @dg_internal

Version: 1.9.3

Definition at line 212 of file grammar_registry.cpp.

◆ list()

std::vector< GrammarEntry > entropic::GrammarRegistry::list ( ) const

List all registered grammar keys.

Returns: Vector of GrammarEntry metadata (content omitted for efficiency).

Version: 1.9.3

Returns: Vector of GrammarEntry metadata (content omitted). @dg_internal

Version: 1.9.3

Definition at line 239 of file grammar_registry.cpp.

◆ load_bundled()

size_t entropic::GrammarRegistry::load_bundled ( const std::filesystem::path & grammar_dir )

Load all bundled grammars from a directory.

Load all bundled .gbnf grammars from a directory.

Parameters

grammar_dir Path to data/grammars/ directory.

Returns: Number of grammars loaded.

Scans for *.gbnf files. Each file's stem becomes the key (e.g., "compactor.gbnf" -> key "compactor"). Files are read, validated, and registered. Invalid files are logged as WARNING and still registered with error metadata.

Version: 1.9.3

Parameters

dir	Directory to scan.

Returns: Number of grammars loaded; each file's stem becomes its key. @req REQ-INFER-007

Version: 2.3.7

Definition at line 83 of file grammar_registry.cpp.

◆ register_from_file()

bool entropic::GrammarRegistry::register_from_file	(	const std::string &	key,
		const std::filesystem::path &	path
	)

Register a grammar from a file path.

Parameters

key	Unique grammar name (if empty, uses filename stem).
path	Path to .gbnf file.

Returns: true on success. false if file unreadable or key exists.

Version: 1.9.3

Parameters

key	Unique grammar name (if empty, uses filename stem).
path	Path to .gbnf file.

Returns: true on success; false when the file is unreadable or the key is already registered. An empty key takes the file stem. @req REQ-INFER-007

Version: 1.9.3

Definition at line 156 of file grammar_registry.cpp.

◆ register_grammar()

bool entropic::GrammarRegistry::register_grammar	(	const std::string &	key,
		const std::string &	gbnf_content,
		const std::string &	source = `"runtime"`
	)

Register a grammar by key with GBNF content string.

Parameters

key	Unique grammar name.
gbnf_content	Raw GBNF grammar string.
source	Origin tag ("runtime", "dynamic", "file").

Returns: true on success. false if key already exists.

The grammar is validated on registration. If validation fails, the grammar is still registered but entry.validated is false and entry.error is set.

Version: 1.9.3

Parameters

key	Unique grammar name.
gbnf_content	Raw GBNF grammar string.
source	Origin tag.

Returns: true on success; false when the key is already registered. An invalid GBNF is still registered, flagged via GrammarEntry::validated/error rather than silently dropped. @req REQ-INFER-007

Version: 1.9.3

Definition at line 122 of file grammar_registry.cpp.

◆ size()

size_t entropic::GrammarRegistry::size ( ) const

Number of registered grammars.

Returns: Count of registered grammars.

Version: 1.9.3

Returns: Count of registered grammars. @dg_internal

Version: 1.9.3

Definition at line 288 of file grammar_registry.cpp.

◆ validate()

std::string entropic::GrammarRegistry::validate ( const std::string & gbnf_content )

static

Validate a GBNF grammar string.

Parameters

gbnf_content Raw GBNF string to validate.

Returns: Empty string on success, error description on failure.

Parses the grammar using llama_sampler_init_grammar() with a throwaway sampler. Does not require a loaded model. This is a static utility — can be called without registering the grammar.

Version: 1.9.3

Parameters

gbnf_content Raw GBNF string to validate.

Returns: Empty string on success; an error description otherwise. Validation runs through a throwaway llama sampler, so a malformed grammar is caught at registration, not at decode. @req REQ-INFER-007

Version: 1.9.3

Definition at line 263 of file grammar_registry.cpp.

The documentation for this class was generated from the following files:

entropic/inference/grammar_registry.h
inference/grammar_registry.cpp

Public Member Functions

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ clear()

◆ deregister()

◆ entry()

◆ get()

◆ has()

◆ list()

◆ load_bundled()

◆ register_from_file()

◆ register_grammar()

◆ size()

◆ validate()