lash-core 0.1.0-alpha.36

Sans-IO turn machine and runtime kernel for the lash agent runtime.
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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

use super::*;

pub(in crate::runtime::session_manager) struct SessionCreatePlan {
    pub(in crate::runtime::session_manager) session_id: String,
    pub(in crate::runtime::session_manager) relation: SessionRelation,
    pub(in crate::runtime::session_manager) parent_session_id: Option<String>,
    pub(in crate::runtime::session_manager) policy: SessionPolicy,
    pub(in crate::runtime::session_manager) initial_runtime_state: RuntimeSessionState,
    pub(in crate::runtime::session_manager) plugin_authority:
        crate::plugin::SessionAuthorityContext,
    pub(in crate::runtime::session_manager) plugin_source: crate::SessionPluginSource,
    pub(in crate::runtime::session_manager) context_surface: crate::SessionContextSurface,
    pub(in crate::runtime::session_manager) protocol_request: SessionCreateRequest,
    pub(in crate::runtime::session_manager) usage_source: Option<String>,
}

pub(in crate::runtime::session_manager) async fn resolve_session_create_plan(
    managed: &ManagedSessionCapability,
    current: &CurrentSessionCapability,
    mut request: SessionCreateRequest,
) -> Result<SessionCreatePlan, crate::PluginError> {
    let session_id = request
        .session_id
        .take()
        .filter(|value| !value.is_empty())
        .unwrap_or_else(|| uuid::Uuid::new_v4().to_string());
    request.session_id = Some(session_id.clone());
    if session_id == current.session_id || managed.registry.lock().await.contains_key(&session_id) {
        return Err(crate::PluginError::Session(format!(
            "session `{session_id}` already exists"
        )));
    }

    let parent_session_id = request.relation.parent_session_id().map(ToOwned::to_owned);
    let start_state = resolve_start_state(managed, current, &request, &session_id).await?;
    let policy = resolve_session_policy(current, &request, &start_state, &session_id);
    request.policy = Some(policy.clone());
    let initial_runtime_state =
        build_runtime_state(session_id.clone(), &request, start_state, &policy);
    let plugin_authority = crate::plugin::SessionAuthorityContext {
        tool_access: request.tool_access.clone(),
        subagent: request.subagent.clone(),
    };

    Ok(SessionCreatePlan {
        session_id,
        relation: request.relation.clone(),
        parent_session_id,
        policy,
        initial_runtime_state,
        plugin_authority,
        plugin_source: request.plugin_source,
        context_surface: request.context_surface.clone(),
        usage_source: request.usage_source.clone(),
        protocol_request: request,
    })
}

async fn resolve_start_state(
    managed: &ManagedSessionCapability,
    current: &CurrentSessionCapability,
    request: &SessionCreateRequest,
    session_id: &str,
) -> Result<RuntimeSessionState, crate::PluginError> {
    match &request.start {
        SessionStartPoint::Empty => Ok(RuntimeSessionState {
            session_id: session_id.to_string(),
            ..Default::default()
        }),
        SessionStartPoint::CurrentSession => Ok(current.snapshot.to_runtime_state()),
        SessionStartPoint::ExistingSession { session_id } => current
            .snapshot_by_id(managed, session_id)
            .await
            .map(RuntimeSessionState::from_snapshot),
        SessionStartPoint::Snapshot { snapshot } => {
            Ok(RuntimeSessionState::from_snapshot((**snapshot).clone()))
        }
    }
}

fn resolve_session_policy(
    current: &CurrentSessionCapability,
    request: &SessionCreateRequest,
    start_state: &RuntimeSessionState,
    session_id: &str,
) -> SessionPolicy {
    let mut policy = request
        .policy
        .clone()
        .unwrap_or_else(|| match &request.start {
            SessionStartPoint::Empty => current.policy.clone(),
            _ => start_state.policy.clone(),
        });
    if request.relation.parent_session_id().is_some() {
        policy.session_id = Some(session_id.to_string());
    }
    policy
}

fn build_runtime_state(
    session_id: String,
    request: &SessionCreateRequest,
    mut base: RuntimeSessionState,
    policy: &SessionPolicy,
) -> RuntimeSessionState {
    normalize_session_graph(&mut base);
    base.session_id = session_id;
    base.policy = policy.clone();
    base.reset_initial_agent_frame(
        crate::AgentFrameAssignment::from_session_request(request, policy.clone()),
        base.protocol_turn_options.clone(),
    );
    append_session_nodes_to_state(&mut base, &request.initial_nodes);
    normalize_session_graph(&mut base);
    base
}