Skip to main content

systemprompt_runtime/
lib.rs

1//! `systemprompt-runtime` — application runtime services.
2//!
3//! This crate hosts [`AppContext`], the lifecycle [`AppContextBuilder`],
4//! per-module installation helpers, startup validation, and the typed
5//! [`RuntimeError`] / [`RuntimeResult`] error boundary used by all of
6//! the above.
7//!
8//! Public APIs return [`RuntimeResult<T>`]. [`RuntimeError`] composes
9//! upstream typed errors (`ConfigError`, `RepositoryError`,
10//! `FilesError`, `UserError`, `LoaderError`, `AnalyticsError`,
11//! `ProfileBootstrapError`, `PathError`) via `#[from]`; every variant
12//! built from another error keeps it as its source.
13//!
14//! # Feature flags
15//!
16//! | Feature       | Effect                                                          |
17//! |---------------|------------------------------------------------------------------|
18//! | (default)     | Core context, builder, validation                               |
19//! | `geolocation` | Enables `MaxMind` `GeoIP2` loading via `maxminddb` and pulls in `systemprompt-analytics/geolocation` |
20//!
21//! Copyright (c) systemprompt.io — Business Source License 1.1.
22//! See <https://systemprompt.io> for licensing details.
23
24mod builder;
25pub mod config_planes;
26mod context;
27mod context_traits;
28mod database_context;
29mod error;
30pub mod managed;
31pub mod schema_currency;
32pub mod services_reconcile;
33mod startup_validation;
34pub mod storage;
35pub mod trace;
36mod validation;
37
38pub use builder::{AppContextBuilder, discover_vertex_models, owner_reassignments};
39pub use config_planes::{ConfigPlaneSet, EffectiveAuthority};
40pub use context::{AppContext, ConfigPlane, DataPlane, Plugins, ShutdownRequest, Subsystems};
41pub use database_context::DatabaseContext;
42pub use error::{RuntimeError, RuntimeResult};
43pub use schema_currency::{SchemaState, assert_schema_current};
44pub use startup_validation::{
45    ExtensionConfigOutcome, FilesConfigValidator, StartupValidator, collect_manifest_errors,
46    display_validation_report, display_validation_warnings, merge_mcp_errors,
47    validate_extension_configs,
48};
49pub use systemprompt_database::MigrationConfig;
50pub use trace::{
51    AiRequestClientEvidence, AiRequestDetail, AiRequestFilter, AiRequestInfo, AiRequestListItem,
52    AiRequestStats, AiRequestSummary, AiTraceService, AuditLookupResult, AuditPage,
53    AuditToolCallRow, ConversationMessage, ExecutionStep, ExecutionStepSummary, LevelCount,
54    LinkedMcpCall, LogSearchFilter, LogSearchItem, LogTimeRange, McpExecutionSummary,
55    McpToolExecution, ModelStatsRow, ModuleCount, ProviderStatsRow, RequestCursor,
56    RequestCursorError, TaskArtifact, TaskInfo, ToolExecutionFilter, ToolExecutionItem,
57    ToolLogEntry, TraceError, TraceEvent, TraceListFilter, TraceListItem, TraceQueryService,
58    TraceRepository,
59};
60pub use validation::{validate_database_url, validate_system};
61
62pub use systemprompt_models::modules::ServiceCategory;