systemprompt-runtime 0.53.0

Application runtime for systemprompt.io AI governance infrastructure. AppContext, lifecycle builder, extension registry, and module wiring for the MCP governance pipeline.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

//! `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.

mod builder;
mod context;
mod context_traits;
mod database_context;
mod error;
pub mod optimization;
mod registry;
pub mod reporting;
pub mod services_reconcile;
mod startup_validation;
pub mod trace;
mod validation;
mod wellknown;

pub use builder::{AppContextBuilder, discover_models};
pub use context::{AppContext, ConfigPlane, DataPlane, Plugins, ShutdownRequest, Subsystems};
pub use database_context::DatabaseContext;
pub use error::{RuntimeError, RuntimeResult};
pub use registry::{ModuleApiRegistration, ModuleApiRegistry, ModuleType, WellKnownRoute};
pub use startup_validation::{
    ExtensionConfigOutcome, FilesConfigValidator, StartupValidator, collect_manifest_errors,
    display_validation_report, display_validation_warnings, merge_mcp_errors,
    validate_extension_configs,
};
pub use systemprompt_database::MigrationConfig;
pub use trace::{
    AiRequestDetail, AiRequestFilter, AiRequestInfo, AiRequestListItem, AiRequestStats,
    AiRequestSummary, AiTraceService, AuditLookupResult, AuditPage, AuditToolCallRow,
    ConversationMessage, ExecutionStep, ExecutionStepSummary, LevelCount, LinkedMcpCall,
    LogSearchFilter, LogSearchItem, LogTimeRange, McpExecutionSummary, McpToolExecution,
    ModelStatsRow, ModuleCount, ProviderStatsRow, RequestCursor, RequestCursorError, TaskArtifact,
    TaskInfo, ToolExecutionFilter, ToolExecutionItem, ToolLogEntry, TraceError, TraceEvent,
    TraceListFilter, TraceListItem, TraceQueryService,
};
pub use validation::{validate_database_path, validate_system};
pub use wellknown::{WellKnownMetadata, get_wellknown_metadata};

pub use systemprompt_models::modules::ServiceCategory;

#[macro_export]
macro_rules! register_module_api {
    ($module_name:literal, $category:expr, $router_fn:expr, $auth_required:expr, $module_type:expr) => {
        inventory::submit! {
            $crate::ModuleApiRegistration {
                module_name: $module_name,
                category: $category,
                module_type: $module_type,
                router_fn: $router_fn,
                auth_required: $auth_required,
            }
        }
    };
    ($module_name:literal, $category:expr, $router_fn:expr, $auth_required:expr) => {
        inventory::submit! {
            $crate::ModuleApiRegistration {
                module_name: $module_name,
                category: $category,
                module_type: $crate::ModuleType::Regular,
                router_fn: $router_fn,
                auth_required: $auth_required,
            }
        }
    };
}

#[macro_export]
macro_rules! register_wellknown_route {
    ($path:literal, $handler:expr, $methods:expr, name: $name:literal, description: $desc:literal) => {
        inventory::submit! {
            $crate::WellKnownRoute {
                path: $path,
                handler_fn: $handler,
                methods: $methods,
            }
        }

        inventory::submit! {
            $crate::WellKnownMetadata::new($path, $name, $desc)
        }
    };

    ($path:literal, $handler:expr, $methods:expr) => {
        inventory::submit! {
            $crate::WellKnownRoute {
                path: $path,
                handler_fn: $handler,
                methods: $methods,
            }
        }
    };
}