holon 0.14.1

A headless, event-driven runtime for long-lived agents
Documentation
use std::{
    collections::HashMap,
    path::{Path, PathBuf},
};

use anyhow::{anyhow, Result};

use crate::{
    storage::AppStorage,
    system::{
        EffectiveExecution, ExecutionProfile, ExecutionScopeKind, ExecutionSnapshot,
        WorkspaceAccessMode, WorkspaceProjectionKind, WorkspaceView,
    },
    types::{agent_home_workspace_id, AgentState, WorkspaceEntry, AGENT_HOME_WORKSPACE_ID},
};

pub(crate) fn build_execution_root_id(
    workspace_id: &str,
    projection_kind: WorkspaceProjectionKind,
    execution_root: &Path,
) -> Result<String> {
    Ok(match projection_kind {
        WorkspaceProjectionKind::CanonicalRoot => {
            format!("canonical_root:{workspace_id}")
        }
        WorkspaceProjectionKind::GitWorktreeRoot => format!(
            "git_worktree_root:{workspace_id}:{}",
            crate::system::workspace::normalize_path(execution_root)?.display()
        ),
    })
}

pub(crate) fn agent_home_workspace_entry(data_dir: &Path, agent_id: &str) -> WorkspaceEntry {
    let mut entry = WorkspaceEntry::new(
        agent_home_workspace_id(agent_id),
        data_dir.to_path_buf(),
        Some("AgentHome".into()),
    );
    entry.workspace_alias = Some(AGENT_HOME_WORKSPACE_ID.into());
    entry.workspace_kind = Some("agent_home".into());
    entry.owner_agent_id = Some(agent_id.to_string());
    entry
}

pub(crate) fn detached_execution_root(storage: &AppStorage) -> PathBuf {
    storage.data_dir().to_path_buf()
}

pub(crate) fn workspace_view_from_state(
    state: &AgentState,
    detached_execution_root: PathBuf,
) -> Result<WorkspaceView> {
    if let Some(entry) = state.active_workspace_entry.as_ref() {
        let worktree_root = (entry.projection_kind == WorkspaceProjectionKind::GitWorktreeRoot)
            .then(|| entry.execution_root.clone());
        return WorkspaceView::new(
            Some(entry.workspace_id.clone()),
            entry.workspace_anchor.clone(),
            entry.execution_root.clone(),
            entry.cwd.clone(),
            Some(entry.execution_root_id.clone()),
            Some(entry.access_mode),
            worktree_root,
        );
    }

    let execution_root = detached_execution_root;
    WorkspaceView::new(
        None,
        execution_root.clone(),
        execution_root.clone(),
        execution_root.clone(),
        None,
        Some(WorkspaceAccessMode::ExclusiveWrite),
        None,
    )
}

pub(crate) fn workspace_view_for_root(
    storage: &AppStorage,
    execution_root: PathBuf,
    cwd: PathBuf,
    worktree_root: Option<PathBuf>,
) -> Result<WorkspaceView> {
    let state = storage
        .read_agent()?
        .ok_or_else(|| anyhow!("agent state not found"))?;
    let workspace_id = state
        .active_workspace_entry
        .as_ref()
        .map(|entry| entry.workspace_id.clone());
    let workspace_anchor = state
        .active_workspace_entry
        .as_ref()
        .map(|entry| entry.workspace_anchor.clone())
        .unwrap_or_else(|| detached_execution_root(storage));
    let execution_root_id = state
        .active_workspace_entry
        .as_ref()
        .map(|entry| entry.execution_root_id.clone());
    let access_mode = state
        .active_workspace_entry
        .as_ref()
        .map(|entry| entry.access_mode);
    WorkspaceView::new(
        workspace_id,
        workspace_anchor,
        execution_root,
        cwd,
        execution_root_id,
        access_mode,
        worktree_root,
    )
}

pub(crate) fn load_attached_workspace_entries(
    storage: &AppStorage,
) -> Result<Vec<(String, PathBuf)>> {
    let entries = storage.latest_workspace_entries()?;
    Ok(entries
        .into_iter()
        .map(|entry| (entry.workspace_id, entry.workspace_anchor))
        .collect())
}

pub(crate) fn load_attached_workspace_entries_for(
    storage: &AppStorage,
    attached_workspace_ids: &[String],
    workspace: &WorkspaceView,
) -> Result<Vec<(String, PathBuf)>> {
    let known_entries = load_attached_workspace_entries(storage)?
        .into_iter()
        .collect::<HashMap<_, _>>();
    let active_workspace_id = workspace.workspace_id().map(ToString::to_string);
    let mut ordered_ids = Vec::new();

    if let Some(active_id) = active_workspace_id.as_ref() {
        if attached_workspace_ids.is_empty()
            || attached_workspace_ids.iter().any(|id| id == active_id)
        {
            ordered_ids.push(active_id.clone());
        }
    }

    for workspace_id in attached_workspace_ids {
        if !ordered_ids.iter().any(|id| id == workspace_id) {
            ordered_ids.push(workspace_id.clone());
        }
    }

    let mut resolved = Vec::new();
    for workspace_id in ordered_ids {
        if let Some(anchor) = known_entries.get(&workspace_id) {
            resolved.push((workspace_id, anchor.clone()));
        } else if active_workspace_id.as_deref() == Some(workspace_id.as_str()) {
            resolved.push((workspace_id, workspace.workspace_anchor().to_path_buf()));
        }
    }

    Ok(resolved)
}

pub(crate) fn execution_snapshot_for_view(
    profile: ExecutionProfile,
    workspace: &WorkspaceView,
    attached_workspace_ids: &[String],
    storage: &AppStorage,
) -> ExecutionSnapshot {
    let attached_workspaces =
        load_attached_workspace_entries_for(storage, attached_workspace_ids, workspace)
            .unwrap_or_else(|_| {
                workspace
                    .workspace_id()
                    .map(|id| (id.to_string(), workspace.workspace_anchor().to_path_buf()))
                    .into_iter()
                    .collect()
            });

    ExecutionSnapshot {
        policy: profile.policy_snapshot(),
        profile,
        attached_workspaces,
        workspace_id: workspace.workspace_id().map(ToString::to_string),
        workspace_anchor: workspace.workspace_anchor().to_path_buf(),
        execution_root: workspace.execution_root().to_path_buf(),
        cwd: workspace.cwd().to_path_buf(),
        execution_root_id: workspace.execution_root_id().map(ToString::to_string),
        projection_kind: if workspace.worktree_root().is_some() {
            Some(WorkspaceProjectionKind::GitWorktreeRoot)
        } else {
            Some(WorkspaceProjectionKind::CanonicalRoot)
        },
        access_mode: workspace.access_mode(),
        worktree_root: workspace.worktree_root().map(|path| path.to_path_buf()),
    }
}

pub(crate) fn build_effective_execution(
    storage: &AppStorage,
    scope: ExecutionScopeKind,
    profile: ExecutionProfile,
    workspace: WorkspaceView,
    attached_workspace_ids: &[String],
) -> EffectiveExecution {
    let attached_workspaces =
        load_attached_workspace_entries_for(storage, attached_workspace_ids, &workspace)
            .unwrap_or_else(|_| {
                workspace
                    .workspace_id()
                    .map(|id| (id.to_string(), workspace.workspace_anchor().to_path_buf()))
                    .into_iter()
                    .collect()
            });

    EffectiveExecution {
        profile,
        workspace,
        scope,
        attached_workspaces,
    }
}

pub(crate) fn workspace_anchor_for_state_ref<'a>(state: &'a AgentState) -> Option<&'a Path> {
    state
        .active_workspace_entry
        .as_ref()
        .map(|entry| entry.workspace_anchor.as_path())
}

pub(crate) fn execution_root_sync(storage: &AppStorage) -> PathBuf {
    storage
        .read_agent()
        .ok()
        .flatten()
        .and_then(|state| {
            state
                .active_workspace_entry
                .as_ref()
                .map(|entry| entry.execution_root.clone())
                .or_else(|| {
                    state
                        .worktree_session
                        .as_ref()
                        .map(|worktree| worktree.worktree_path.clone())
                })
        })
        .unwrap_or_else(|| detached_execution_root(storage))
}