The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.
Rust agent-orchestrationai-agentsai-assistantdesktopllmlocal-firstmcppersonal-aiprivacyrustsecond-braintauri
//! Startup reconciliation for orphaned agent runs.
//!
//! The sweep itself (`tinyagents_harness::observability::reap_orphaned_runs`)
//! lives upstream; this host adapter only opens the tenant's durable status
//! store. It is the one *writer* over the status seam that
//! [`crate::agent::tinyagents::journal`] exposes; the replay/status controllers
//! ([`super::replay`]) stay strictly read-only.
use std::path::Path;
/// Reap every run left non-terminal by a previous process, returning the number
/// of runs moved to `Cancelled`. Best-effort; never blocks boot.
///
/// Skipped on a storage backend other processes may share (MongoDB): there a
/// non-terminal status can belong to a run another replica is still driving,
/// and cancelling it would hide that run from active and late-attach status.
///
/// With a storage backend every agent keeps its own status store, so the
/// sweep visits `local` and then each known agent (`crate::storage::agents`).
pub(crate) async fn reap_orphaned_runs(workspace: &Path) -> usize {
let shared = crate::storage::installed_is_shared();
crate::storage::agents::for_each_scope(
&crate::core::runtime::DispatchCtx::host_default(),
"run reaper",
|_| reap_unless_shared(workspace, shared),
)
.await
.into_iter()
.map(|(_, reaped)| reaped)
.sum()
}
async fn reap_unless_shared(workspace: &Path, shared: bool) -> usize {
if shared {
log::info!("[agent] startup run sweep skipped: the storage backend is shared");
return 0;
}
log::debug!(
"[agent] startup run sweep workspace={}",
workspace.display()
);
// The status records live in the storage backend, in the calling
// tenant's scope: sweep the ones this process's own work wrote there.
let Some(store) = crate::storage::sessions::status_store_for(workspace) else {
log::warn!("[agent] startup run sweep skipped: no authorized status store");
return 0;
};
tinyagents_harness::observability::reap_orphaned_runs(&store).await
}
#[cfg(test)]
#[path = "reaper_tests.rs"]
mod tests;