Production infrastructure for AI agents

Website · Documentation · Guides · Core · Template · Discord

systemprompt-sync

Cloud sync services for systemprompt.io AI governance infrastructure. Provides file, database, and crate deployment synchronization across governance tenants — bidirectional sync between local and cloud environments.

Layer: App — orchestrates domain modules. Part of the systemprompt-core workspace.

Overview

Part of the App layer in the systemprompt.io architecture. Infrastructure · Self-Hosted Deployment

This crate provides bidirectional sync capabilities for:

• File Sync - Upload/download service configuration files (agents, skills, content, config) as gzipped tarballs
• Database Sync - Export/import contexts between local and cloud Postgres databases
• Local Sync - Synchronise content and access-control rules between disk and the local database
• Crate Deploy - Build and deploy Docker images to Fly.io
• Scheduled Jobs - Background sync jobs registered with the systemprompt scheduler

Architecture

src/
├── lib.rs                    # Crate root, SyncService, SyncConfig, SyncOpState, public exports
├── error.rs                  # SyncError enum and SyncResult alias
├── files.rs                  # FileSyncService - tarball creation, manifest, push/pull
├── file_bundler.rs           # Internal tarball assembly helper (private)
├── crate_deploy.rs           # CrateDeployService - Docker build and deploy
├── api_client/
│   ├── mod.rs                # SyncApiClient - direct-sync vs cloud-relay endpoint selection
│   ├── response.rs           # Typed JSON / binary response handling
│   └── retry.rs              # RetryConfig and exponential backoff
├── database/
│   ├── mod.rs                # DatabaseSyncService, ContextExport, DatabaseExport
│   └── upsert.rs             # Compile-time-checked context upserts
├── diff/
│   ├── mod.rs                # Diff module exports, compute_content_hash
│   └── content.rs            # ContentDiffCalculator - disk vs database content
├── export/
│   ├── mod.rs                # Export utilities, escape_yaml
│   └── content.rs            # Content markdown generation and file export
├── local/
│   ├── mod.rs                # Local sync drivers
│   ├── content_sync.rs       # ContentLocalSync - bidirectional content sync
│   └── access_control_sync.rs # AccessControlLocalSync - bidirectional ACL sync
├── jobs/
│   ├── mod.rs                # Scheduled jobs
│   ├── content_sync.rs       # ContentSyncJob
│   └── access_control_sync.rs # AccessControlSyncJob
└── models/
    ├── mod.rs                # Model exports
    └── local_sync.rs         # LocalSyncDirection, DiffStatus, diff items, result types

Module Details

Sync Directions

Local disk-database sync uses LocalSyncDirection (ToDisk, ToDatabase) on LocalSyncResult.

Operation State

SyncService::sync_all returns per-operation results with a SyncOpState:

Usage

[dependencies]
systemprompt-sync = "0.12.0"

use systemprompt_sync::{SyncConfig, SyncService, SyncDirection};

let config = SyncConfig::builder(
    "tenant-id",
    "https://api.systemprompt.io",
    "api-token",
    "./services",
)
.with_direction(SyncDirection::Push)
.with_dry_run(false)
.build();

let service = SyncService::new(config)?;
let results = service.sync_all().await?;

Error Handling

The crate uses SyncError for all error conditions:

• MissingConfig - Required configuration (e.g., DATABASE_URL) not set
• ApiError - HTTP API failures with status code and message
• Database - SQL/connection errors
• Io - File system errors
• Unauthorized - Authentication required
• CommandFailed - Shell command execution failures

Dependencies

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.

systemprompt.io · Documentation · Guides · Live Demo · Template · crates.io · docs.rs · Discord

App layer · Own how your organization uses AI.