Crate systemprompt_runtime 

systemprompt-runtime — application runtime services.

This crate hosts AppContext, the lifecycle AppContextBuilder, the inventory-driven module API and well-known route registries, per-module installation helpers, startup validation, and the typed RuntimeError / RuntimeResult error boundary used by all of the above.

Public APIs return RuntimeResult<T>. RuntimeError composes upstream typed errors (ConfigError, RepositoryError, FilesError, UserError, LoaderError, AnalyticsError, ProfileBootstrapError, PathError) via #[from] and absorbs untyped third-party errors into RuntimeError::Internal as strings.

Feature flags

Feature	Effect
(default)	Core context, builder, registries, validation
geolocation	Enables MaxMind GeoIP2 loading via maxminddb and pulls in systemprompt-analytics/geolocation

Macros

register_module_api

register_wellknown_route

Structs

AppContext

Application-wide runtime container shared across the HTTP server, the scheduler, and CLI commands.

AppContextBuilder

Assembles an AppContext, owning the bootstrap order described on the module.

ConfigPlane

Resolved configuration, on-disk paths, and the routing derived from them.

DataPlane

Database pool and the data-access services layered on it.

DatabaseContext

FilesConfigValidator

MigrationConfig

ModuleApiRegistration

ModuleApiRegistry

Plugins

Extension, module-API, MCP, and marketplace registries.

StartupValidator

Subsystems

Cross-cutting runtime subsystems: admin identity, authz hook, the event bridge handle, and the optional GeoIP reader.

WellKnownMetadata

WellKnownRoute

Enums

ModuleType

RuntimeError

ServiceCategory

Functions

create_request_span

display_validation_report

display_validation_warnings

get_wellknown_metadata

validate_database_path

validate_system

Type Aliases

RuntimeResult