systemprompt-loader 0.57.0

File and module discovery infrastructure for systemprompt.io AI governance — manifests, schemas, and extension loading. Separates I/O from shared models in the MCP governance pipeline.
Documentation

systemprompt-loader

Crates.io Docs.rs codecov License: BSL-1.1

Loads and validates services configuration and catalog files and supports agent configuration persistence.

Layer: Infra. Infrastructure primitives consumed by the domain and application crates. Part of the systemprompt-core workspace.

What it does

The loader isolates file I/O from the shared model types. It sits one level above systemprompt-config in the dependency graph, so domain crates read services config, profiles, and extensions without knowing the on-disk structure. That boundary keeps file operations testable and the loaders reusable across the API and CLI entry points.

Modules

Module Purpose
config_loader ConfigLoader reads services.yaml, resolves includes: recursively with cycle detection (discovery.rs, includes.rs), deep-merges fragments (merge.rs), and validates against a strict schema.
config_writer ConfigWriter creates, edits, and deletes agent configuration files.
extension_loader ExtensionLoader discovers on-disk extensions by scanning for manifest.yaml, returning an ExtensionValidationResult.
extension_registry ExtensionRegistry maps binary names to extension metadata and resolves binary paths.
module_loader ModuleLoader wraps the inventory-driven registry: discover_extensions returns every compiled-in Extension, collect_extension_schemas flattens their SchemaDefinitions.
profile_loader ProfileLoader reads, validates, and writes profile YAML.
error ConfigLoadError, ConfigWriteError, ExtensionLoadError, ProfileLoadError and their result aliases.

Usage

[dependencies]
systemprompt-loader = "0.57"

Features

Feature Default Purpose
expose-internals off Exposes test-only entry points such as ConfigLoader::load_from_content to dependent crates outside cfg(test). 
use systemprompt_loader::{
    ConfigLoader, ProfileLoader,
    ExtensionLoader, ExtensionRegistry, ModuleLoader,
};

let config = ConfigLoader::load()?;

let loader = ConfigLoader::for_active_profile()?;

let profile = ProfileLoader::load_and_validate(services_path, "development")?;

let extensions = ModuleLoader::discover_extensions()?;
let schemas = ModuleLoader::collect_extension_schemas()?;

let discovered = ExtensionLoader::discover(project_root);

Dependencies

  • thiserror — typed error variants
  • serde / serde_yaml — serialisation
  • tracing — structured logging
  • systemprompt-config — profile and config primitives
  • systemprompt-extension — extension trait registry
  • systemprompt-models — shared model types

License

BSL-1.1 (Business Source License). Source-available for evaluation, testing, and non-production use. Production use requires a commercial license. Each version converts to Apache 2.0 four years after publication. See LICENSE.