Expand description
systemprompt-runtime — application runtime services.
This crate hosts AppContext, the lifecycle AppContextBuilder,
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]; every variant
built from another error keeps it as its source.
§Feature flags
| Feature | Effect |
|---|---|
| (default) | Core context, builder, validation |
geolocation | Enables MaxMind GeoIP2 loading via maxminddb and pulls in systemprompt-analytics/geolocation |
Copyright (c) systemprompt.io — Business Source License 1.1. See https://systemprompt.io for licensing details.
Re-exports§
pub use schema_currency::assert_schema_current;pub use trace::AiRequestClientEvidence;pub use trace::AiRequestDetail;pub use trace::AiRequestFilter;pub use trace::AiRequestInfo;pub use trace::AiRequestListItem;pub use trace::AiRequestStats;pub use trace::AiRequestSummary;pub use trace::AiTraceService;pub use trace::AuditLookupResult;pub use trace::AuditPage;pub use trace::AuditToolCallRow;pub use trace::ConversationMessage;pub use trace::ExecutionStep;pub use trace::ExecutionStepSummary;pub use trace::LevelCount;pub use trace::LinkedMcpCall;pub use trace::LogSearchFilter;pub use trace::LogSearchItem;pub use trace::LogTimeRange;pub use trace::McpExecutionSummary;pub use trace::McpToolExecution;pub use trace::ModelStatsRow;pub use trace::ModuleCount;pub use trace::ProviderStatsRow;pub use trace::RequestCursor;pub use trace::RequestCursorError;pub use trace::TaskArtifact;pub use trace::TaskInfo;pub use trace::ToolExecutionFilter;pub use trace::ToolExecutionItem;pub use trace::ToolLogEntry;pub use trace::TraceError;pub use trace::TraceEvent;pub use trace::TraceListFilter;pub use trace::TraceListItem;pub use trace::TraceQueryService;pub use trace::TraceRepository;
Modules§
- managed
- Application-owned orchestration over the managed marketplace domain.
- schema_
currency - Boot-time refusal of a database the migration step has not reached.
- services_
reconcile - Authz projection of a freshly fetched services composition, run once at boot.
- storage
- File-storage composition: the profile’s
storage:section resolved to aFileStoragebackend, with the credential source the GCS backend needs. - trace
- Trace query services backing the
logsCLI and audit surfaces.
Structs§
- AppContext
- Application-wide runtime container shared across the HTTP server, the scheduler, and CLI commands.
- AppContext
Builder - Assembles an
AppContext, owning the bootstrap order described on the module. - Config
Plane - Data
Plane - Database pool and the data-access services layered on it.
- Database
Context - Extension
Config Outcome - A single extension’s resolved config-validation result.
- Files
Config Validator - Migration
Config - Plugins
- Shutdown
Request - Handle used to ask the running process to drain and exit.
- Startup
Validator - Subsystems
Enums§
Functions§
- collect_
manifest_ errors - discover_
vertex_ models - display_
validation_ report - display_
validation_ warnings - merge_
mcp_ errors - owner_
reassignments - validate_
database_ url - validate_
extension_ configs - validate_
system