Module runtime 

Provides compiled artifacts and stateful matchers.

Structs

ArtifactCache

A thread-safe, byte-bounded cache of compiled artifacts keyed by [ArtifactKey]. Read-mostly after warm-up; once the budget is reached, further artifacts are built and returned but not

CachedExecutable

Cached executable plus its canonical IR identity for provenance and L2 keys.

CompiledArtifact

A byte engine bound to a vocabulary, shared by Arc across sequences and the FFI. Only mask_cache mutates after construction.

ExecutableCache

Exact-input, byte-bounded, single-flight cache of vocabulary-neutral executables.

ExecutableCacheStats

Snapshot of vocabulary-neutral cache traffic and retention.

Matcher

A position inside a CompiledArtifact. Owns the position, shares the artifact by Arc.

Enums

ExecutableSchema

Immutable compiled schema semantics with no vocabulary or mutable session state.

Constants

COMPILER_SEMANTICS_VERSION

Bumped whenever a change to IR-compile or bind semantics could make a previously-cached artifact for the same (ir_hash, vocab_fingerprint, mask_vocab_size, bind_mode) no longer equivalent to

EXECUTABLE_SEMANTICS_VERSION

Increment when vocabulary-neutral executable semantics change.

Functions

global_executable_cache

Process-wide bounded L1 cache. It contains no vocabulary or session state.

validate_token_bytes

Validates a vocabulary binds without ambiguity (the same id -> bytes indexing an artifact runs), so a handle checked here reuses across compilations without re-discovering a conflict.