Skip to content

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

docs(agent): document the {unix_ts}_{token}_{agent} session key

oxoxDeva65c1233cd30
diff --git a/crates/openhuman-core/src/agent/harness/fork_context.rs b/crates/openhuman-core/src/agent/harness/fork_context.rs
index cd0168cc8c..6ba6d3f228 100644
--- a/crates/openhuman-core/src/agent/harness/fork_context.rs
+++ b/crates/openhuman-core/src/agent/harness/fork_context.rs
@@ -126,8 +126,8 @@ pub struct ParentExecutionContext {
/// uncallable P-Format tool_call blocks.
pub tool_call_format: tinytools_agent::dialect::ToolCallFormat,
- /// Parent's own session-transcript key, formatted as
- /// `"{unix_ts}_{agent_id}"`. Sub-agents chain this (plus any
+ /// Parent's own session-transcript key, `{unix_ts}_{token}_{agent}`,
+ /// unique per session host. Sub-agents chain this (plus any
/// ancestor prefixes on the parent) into their own transcript
/// filename so the hierarchy `orchestrator → planner → critic`
/// lands on disk as a single flat file name —
diff --git a/crates/openhuman-core/src/agent/session_host/runtime/accessors/session.rs b/crates/openhuman-core/src/agent/session_host/runtime/accessors/session.rs
index 8736224e3b..3b03b3ab25 100644
--- a/crates/openhuman-core/src/agent/session_host/runtime/accessors/session.rs
+++ b/crates/openhuman-core/src/agent/session_host/runtime/accessors/session.rs
@@ -37,10 +37,10 @@ impl OpenHumanSessionHost {
&self.connected_integrations
}
- /// This session's transcript key — `"{unix_ts}_{agent_id}"`,
- /// generated once at build time. Sub-agents chain this into their
- /// own transcript filenames so the parent → child hierarchy is
- /// visible on disk.
+ /// This session's transcript key — `{unix_ts}_{token}_{agent}`, unique
+ /// per session host, generated once at build time. Sub-agents chain
+ /// this into their own transcript filenames so the parent → child
+ /// hierarchy is visible on disk.
pub fn session_key(&self) -> &str {
&self.session_key
}
diff --git a/crates/openhuman-core/src/agent/session_host/types.rs b/crates/openhuman-core/src/agent/session_host/types.rs
index 41573ce2cd..4cc15213be 100644
--- a/crates/openhuman-core/src/agent/session_host/types.rs
+++ b/crates/openhuman-core/src/agent/session_host/types.rs
@@ -353,8 +353,8 @@ pub struct OpenHumanSessionHost {
/// back the identical `Arc`.
pub(super) session_history_locator_memo:
std::sync::OnceLock<std::sync::Arc<dyn tinyagents_session::transcript::TranscriptLocator>>,
- /// Unique transcript key for this session, formatted as
- /// `"{unix_ts}_{agent_id}"`. Generated once at agent-build time so
+ /// Transcript key for this session, `{unix_ts}_{token}_{agent}`, unique
+ /// per session host. Generated once at agent-build time so
/// every transcript write in this session uses the same filename
/// stem. Sub-agents chain their parent's key into the transcript
/// directory to produce a hierarchical layout —