systemprompt-extension 0.24.0

Compile-time extension framework for systemprompt.io AI governance infrastructure. Built on the inventory crate — registers schemas, API routes, jobs, and providers in 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
116

//! Compile-time extension framework for systemprompt.io.
//!
//! Built on the [`inventory`] crate, this crate lets extension authors
//! declare schemas, API routes, scheduled jobs, and provider
//! implementations using the [`Extension`] trait and the
//! [`register_extension!`] macro. The runtime collects every registration
//! at startup, validates dependencies, and merges the resulting wiring
//! into the host application.
//!
//! # Authoring an extension
//!
//! ```ignore
//! use systemprompt_extension::prelude::*;
//!
//! #[derive(Default)]
//! struct MyExtension;
//!
//! impl Extension for MyExtension {
//!     fn metadata(&self) -> ExtensionMetadata {
//!         ExtensionMetadata { id: "my-ext", name: "My Extension", version: "0.1.0" }
//!     }
//! }
//!
//! register_extension!(MyExtension);
//! ```
//!
//! # Module map
//!
//! - [`metadata`], [`router`], [`migration`] — value types describing the
//!   extension surface.
//! - The `Extension` trait and the [`register_extension!`] macro form the core
//!   extensibility contract.
//! - [`build`] — build-script helper that generates `Extension::migrations()`
//!   from `schema/migrations/*.sql` files, paired with the
//!   [`extension_migrations!`] macro.
//! - [`registry`] — runtime store of registered extensions, built from
//!   `inventory` submissions at startup.
//! - [`capabilities`] — `Has*` capability traits and the [`CapabilityContext`]
//!   composition helper.
//! - [`error`] — typed error enums ([`LoaderError`], [`ConfigError`]) raised by
//!   the registry.
//!
//! # Feature flags
//!
//! This crate has no Cargo features; everything compiles into every build.
//!
//! Copyright (c) systemprompt.io — Business Source License 1.1.
//! See <https://systemprompt.io> for licensing details.

mod asset;
#[expect(
    clippy::panic,
    clippy::manual_assert,
    clippy::print_stdout,
    reason = "build-script support code: a panic is the correct way to abort a build, and \
              println! is how a build script emits cargo directives"
)]
pub mod build;
pub mod capabilities;
pub mod context;
pub mod error;
pub mod frame_options;
pub mod gateway_guard;
pub mod metadata;
pub mod migration;
pub mod registry;
pub mod router;
pub mod runtime_config;
pub mod seed;
mod traits;

pub use asset::{AssetDefinition, AssetDefinitionBuilder, AssetPaths, AssetType};
pub use context::{DynExtensionContext, ExtensionContext};
pub use error::{ConfigError, LoaderError};
pub use frame_options::{FrameOptions, FrameOptionsOverride, stamp_frame_options};
pub use gateway_guard::{
    GatewayDenyReason, GatewayRequestGuard, GatewayRequestGuardRegistration, run_gateway_guards,
};
pub use metadata::{ExtensionMetadata, ExtensionRole, SchemaDefinition};
pub use migration::Migration;
pub use registry::{ExtensionRegistration, ExtensionRegistry, RESERVED_PATHS};
pub use router::{ExtensionRouter, ExtensionRouterConfig, SiteAuthConfig};
pub use seed::Seed;
pub use traits::Extension;

pub use capabilities::{
    CapabilityContext, FullContext, HasAnalytics, HasConfig, HasDatabase, HasEventBus,
    HasFingerprint, HasHttpClient, HasRouteClassifier, HasUserService,
};

pub mod prelude {
    pub use crate::asset::{AssetDefinition, AssetDefinitionBuilder, AssetPaths, AssetType};
    pub use crate::context::{DynExtensionContext, ExtensionContext};
    pub use crate::error::{ConfigError, LoaderError};
    pub use crate::gateway_guard::{GatewayDenyReason, GatewayRequestGuard, run_gateway_guards};
    pub use crate::registry::ExtensionRegistry;
    pub use crate::seed::Seed;
    pub use crate::{
        Extension, ExtensionMetadata, ExtensionRole, ExtensionRouter, FrameOptions, Migration,
        SchemaDefinition, SiteAuthConfig, extension_migrations, register_extension,
        register_gateway_guard, stamp_frame_options,
    };

    pub use crate::capabilities::{
        CapabilityContext, FullContext, HasConfig, HasDatabase, HasEventBus, HasHttpClient,
    };

    pub use systemprompt_provider_contracts::{
        ComponentContext, ComponentRenderer, ContentDataContext, ContentDataProvider,
        FrontmatterContext, FrontmatterProcessor, PageContext, PageDataProvider,
        PagePrepareContext, PagePrerenderer, PageRenderSpec, PlaceholderMapping, RenderedComponent,
        RssFeedContext, RssFeedItem, RssFeedMetadata, RssFeedProvider, RssFeedSpec, SitemapContext,
        SitemapProvider, SitemapSourceSpec, SitemapUrlEntry, TemplateDataExtender,
        TemplateDefinition, TemplateProvider, TemplateSource,
    };
}