Skip to content

The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.

docs(storage): update import and journal comments

Steven Enamakelc3bd45422497
diff --git a/crates/openhuman-core/src/storage/import/session_db.rs b/crates/openhuman-core/src/storage/import/session_db.rs
index 56c2090e42..ef41af16ba 100644
--- a/crates/openhuman-core/src/storage/import/session_db.rs
+++ b/crates/openhuman-core/src/storage/import/session_db.rs
@@ -18,8 +18,8 @@ use tinyagents_session::{SessionMessage, SessionRecord, SessionToolCall};
use crate::storage::rusqlite::{self, types::ValueRef};
/// Typed rows from the historical session database, in deterministic source
-/// order. The owner import operation performs the destination preflight and
-/// checked batch write.
+/// order. The host passes these rows to TinyAgents' typed, idempotent import
+/// ports after reading the consistent snapshot.
#[derive(Debug, Default)]
pub(crate) struct SessionDatabase {
pub sessions: Vec<SessionRecord>,
diff --git a/crates/openhuman-core/src/storage/import/sessions.rs b/crates/openhuman-core/src/storage/import/sessions.rs
index 9ce2ece064..0ac28fbff7 100644
--- a/crates/openhuman-core/src/storage/import/sessions.rs
+++ b/crates/openhuman-core/src/storage/import/sessions.rs
@@ -188,7 +188,7 @@ fn import(backend: &Arc<dyn StorageBackend>, config: &Config) -> Result<Outcome>
})
}
-/// The native importer reports source rows per stored family. FTS rows are a
+/// The destination ports report source rows per stored family. FTS rows are a
/// derived index and do not represent additional legacy records.
fn database_totals(counts: [ImportCounts; 11]) -> (usize, usize) {
counts.into_iter().fold(
diff --git a/crates/openhuman-core/src/storage/journal_maintenance.rs b/crates/openhuman-core/src/storage/journal_maintenance.rs
index 8a54ef1386..1cc9520559 100644
--- a/crates/openhuman-core/src/storage/journal_maintenance.rs
+++ b/crates/openhuman-core/src/storage/journal_maintenance.rs
@@ -9,8 +9,7 @@ use std::collections::BTreeSet;
use std::sync::Arc;
use std::time::Duration;
-use tinyagents_harness::ids::ExecutionStatus;
-use tinyagents_harness::observability::{DriverStatusStore, HarnessStatusStore};
+use tinyagents_harness::observability::{is_active, DriverStatusStore, HarnessStatusStore};
use tinyagents_harness::store::DriverAppendStore;
use tinystoragedrivers::{CollectionSpec, ErrorKind, Precondition, StorageBackend};
@@ -292,12 +291,7 @@ async fn maintain_run_journals(
.get_status(run_id)
.await
.map_err(|error| crate::storage::StorageError::backend(error.to_string()))?;
- if backfill
- && !matches!(
- status.as_ref().map(|status| status.status),
- Some(ExecutionStatus::Running | ExecutionStatus::Pending)
- )
- {
+ if backfill && !status.as_ref().is_some_and(is_active) {
let already_sealed = streams
.info(&name)
.await?