everruns-host 0.19.0

Shared host orchestration for Everruns execution adapters
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

//! Backend-neutral mutation contract for session metadata.
//!
//! `SessionMutator` is the hosted control-plane service behind the `session`
//! capability's title and live-capability-reconfigure tools. It moved out of
//! `everruns-core` with EVE-897: the kernel never mutated a session itself, it
//! only carried the trait on `ToolContext` so a hosted capability could reach
//! it. That capability now resolves [`SessionMutatorExt`] from the type-keyed
//! extension bag instead.
//!
//! Mutations acknowledge with the refreshed portable
//! `everruns_core::ExecutionSession`, never a stored platform record (EVE-882).

use async_trait::async_trait;
use everruns_capability::CapabilityRef as AgentCapabilityConfig;
use everruns_core::ExecutionSession;
use everruns_provider::error::Result;
use everruns_provider::typed_id::SessionId;

/// Trait for updating mutable session metadata.
///
/// Mutations acknowledge with the refreshed portable execution view, never a
/// stored platform record (EVE-882).
#[async_trait]
pub trait SessionMutator: Send + Sync {
    /// Update a session's human-readable title.
    async fn update_session_title(
        &self,
        session_id: SessionId,
        title: String,
    ) -> Result<ExecutionSession>;

    /// Add or replace a session-scoped capability atomically.
    ///
    /// Session backends that support live capability reconfiguration override
    /// this method. The default keeps existing backends source-compatible and
    /// fails closed instead of pretending the capability was applied.
    async fn upsert_session_capability(
        &self,
        _session_id: SessionId,
        _capability: AgentCapabilityConfig,
    ) -> Result<ExecutionSession> {
        Err(everruns_provider::error::AgentLoopError::store(
            "session backend does not support live capability reconfiguration",
        ))
    }

    /// Remove a session-scoped capability atomically.
    async fn remove_session_capability(
        &self,
        _session_id: SessionId,
        _capability_id: &str,
    ) -> Result<ExecutionSession> {
        Err(everruns_provider::error::AgentLoopError::store(
            "session backend does not support live capability reconfiguration",
        ))
    }
}

#[async_trait]
impl<T: SessionMutator + ?Sized> SessionMutator for std::sync::Arc<T> {
    async fn update_session_title(
        &self,
        session_id: SessionId,
        title: String,
    ) -> Result<ExecutionSession> {
        (**self).update_session_title(session_id, title).await
    }

    async fn upsert_session_capability(
        &self,
        session_id: SessionId,
        capability: AgentCapabilityConfig,
    ) -> Result<ExecutionSession> {
        (**self)
            .upsert_session_capability(session_id, capability)
            .await
    }

    async fn remove_session_capability(
        &self,
        session_id: SessionId,
        capability_id: &str,
    ) -> Result<ExecutionSession> {
        (**self)
            .remove_session_capability(session_id, capability_id)
            .await
    }
}

/// Type-keyed wrapper installed on the tool context by hosted presets.
///
/// Core carries the generic extension bag but does not name this service.
#[derive(Clone)]
pub struct SessionMutatorExt(pub std::sync::Arc<dyn SessionMutator>);