systemprompt_loader/lib.rs
1//! File and module discovery infrastructure for systemprompt.io.
2//!
3//! Reads the active services-config (with include resolution and
4//! deduplication), loads profile YAML, writes agent files, and discovers
5//! extension manifests under `extensions/`. Sits one level above
6//! [`systemprompt_config`] in the dependency graph so that domain crates
7//! never need to know how the on-disk layout is structured.
8//!
9//! # Modules
10//!
11//! - [`config_loader`] — loads and merges `services.yaml` and its includes.
12//! - [`config_writer`] — creates, edits, and deletes agent files.
13//! - [`extension_loader`] / [`extension_registry`] — discover extension
14//! manifests and resolve binary paths.
15//! - [`module_loader`] — `inventory`-driven extension discovery for the
16//! compiled-in extension trait registry.
17//! - [`profile_loader`] — reads, validates, and writes profile YAML.
18//! - [`bundle`] — signed services bundles: fetch, verify, compose, and the boot
19//! path that installs the active services root.
20//! - [`services_root`] — the process-wide cell naming the services root the
21//! instance actually runs, with its provenance.
22//! - [`services_bootstrap`] — the process-wide cell holding the loaded services
23//! config (provider catalog and gateway included), initialised right after
24//! the profile at boot.
25//! - [`error`] — public error types ([`ConfigLoadError`], [`ConfigWriteError`],
26//! [`ExtensionLoadError`]).
27//!
28//! # Feature flags
29//!
30//! - `expose-internals` — exposes test-only entry points (notably
31//! `ConfigLoader::load_from_content`) to dependent crates that exercise the
32//! loader from outside `cfg(test)`. Off by default.
33//!
34//! Copyright (c) systemprompt.io — Business Source License 1.1.
35//! See <https://systemprompt.io> for licensing details.
36
37pub mod bundle;
38pub mod config_loader;
39pub mod config_writer;
40pub mod error;
41pub mod extension_loader;
42pub mod extension_registry;
43pub mod module_loader;
44pub mod profile_loader;
45pub mod services_bootstrap;
46pub mod services_root;
47
48pub use bundle::{BundleError, BundleResult, ServicesSourceBootstrap};
49pub use config_loader::ConfigLoader;
50pub use config_writer::ConfigWriter;
51pub use error::{
52 ConfigLoadError, ConfigLoadResult, ConfigWriteError, ConfigWriteResult, ExtensionLoadError,
53 ExtensionLoadResult, ProfileLoadError, ProfileLoadResult,
54};
55pub use extension_loader::{ExtensionLoader, ExtensionValidationResult};
56pub use extension_registry::ExtensionRegistry;
57pub use module_loader::ModuleLoader;
58pub use profile_loader::ProfileLoader;
59pub use services_bootstrap::ServicesBootstrap;
60pub use services_root::{ActiveServicesRoot, ServicesProvenance, ServicesRootBootstrap};