systemprompt-agent 0.64.0

Agent-to-Agent (A2A) protocol for systemprompt.io AI governance: streaming, JSON-RPC models, task lifecycle, .well-known discovery, and governed agent orchestration.
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

//! Agent process lifecycle: start, enable, disable, restart, and crash cleanup.
//!
//! [`AgentLifecycle`] owns the transitions for a single agent's worker process,
//! coordinating the database service and configured [`AppPaths`]. The free
//! functions are thin entry points that build a lifecycle for one operation;
//! the `operations` and `verification` submodules hold the spawn/teardown
//! logic and startup health-check probing.
//!
//! Copyright (c) systemprompt.io — Business Source License 1.1.
//! See <https://systemprompt.io> for licensing details.

mod operations;
mod verification;

use std::sync::Arc;
use systemprompt_config::paths::AppPaths;
use systemprompt_identifiers::AgentName;
use systemprompt_traits::StartupEventSender;

use crate::repository::agent_service::AgentServiceRepository;
use crate::services::agent_orchestration::OrchestrationResult;
use crate::services::agent_orchestration::database::AgentDatabaseService;

#[derive(Debug)]
pub struct AgentLifecycle {
    pub(crate) db_service: AgentDatabaseService,
    pub(crate) app_paths: Arc<AppPaths>,
}

impl AgentLifecycle {
    pub fn new(
        agent_service_repo: AgentServiceRepository,
        app_paths: Arc<AppPaths>,
    ) -> OrchestrationResult<Self> {
        let db_service = AgentDatabaseService::new(agent_service_repo)?;

        Ok(Self {
            db_service,
            app_paths,
        })
    }
}

pub async fn start_agent(
    agent_service_repo: AgentServiceRepository,
    app_paths: Arc<AppPaths>,
    agent_name: &AgentName,
    events: Option<&StartupEventSender>,
) -> OrchestrationResult<String> {
    let lifecycle = AgentLifecycle::new(agent_service_repo, app_paths)?;
    lifecycle.start_agent(agent_name, events).await
}

pub async fn enable_agent(
    agent_service_repo: AgentServiceRepository,
    app_paths: Arc<AppPaths>,
    agent_name: &AgentName,
    events: Option<&StartupEventSender>,
) -> OrchestrationResult<String> {
    let lifecycle = AgentLifecycle::new(agent_service_repo, app_paths)?;
    lifecycle.enable_agent(agent_name, events).await
}

pub async fn disable_agent(
    agent_service_repo: AgentServiceRepository,
    app_paths: Arc<AppPaths>,
    agent_name: &AgentName,
) -> OrchestrationResult<()> {
    let lifecycle = AgentLifecycle::new(agent_service_repo, app_paths)?;
    lifecycle.disable_agent(agent_name).await
}

pub async fn restart_agent(
    agent_service_repo: AgentServiceRepository,
    app_paths: Arc<AppPaths>,
    agent_name: &AgentName,
    events: Option<&StartupEventSender>,
) -> OrchestrationResult<String> {
    let lifecycle = AgentLifecycle::new(agent_service_repo, app_paths)?;
    lifecycle.restart_agent(agent_name, events).await
}