Expand description
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 |
Copyright (c) systemprompt.io — Business Source License 1.1. See https://systemprompt.io for licensing details.
Re-exports§
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;
Modules§
- managed
- Application-owned orchestration over the managed marketplace domain.
- reporting
- Analytics reporting lifecycle on the shared durable event outbox.
- services_
reconcile - Authz projection of a freshly fetched services composition, run once at boot.
- trace
- Trace query services backing the
logsCLI and audit surfaces.
Macros§
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 - Module
ApiRegistration - Module
ApiRegistry - Plugins
- Shutdown
Request - Handle used to ask the running process to drain and exit.
- Startup
Validator - Subsystems
- Well
Known Metadata - Well
Known Route
Enums§
Functions§
- collect_
manifest_ errors - discover_
models - display_
validation_ report - display_
validation_ warnings - get_
wellknown_ metadata - merge_
mcp_ errors - validate_
database_ path - validate_
extension_ configs - validate_
system