Skip to content

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

docs(agent): reflow architecture diagram and bus path prose

Steven Enamakeld002f46fec34
diff --git a/crates/openhuman-core/src/agent/README.md b/crates/openhuman-core/src/agent/README.md
index 558cdd9062..b1dd08cb35 100644
--- a/crates/openhuman-core/src/agent/README.md
+++ b/crates/openhuman-core/src/agent/README.md
@@ -24,8 +24,8 @@ is adapters that hand TinyAgents the things only OpenHuman knows.
| (stateful, per thread) | (stateless, caller owns history)
v v
+-----------------------------------------------------------------+
- | agent/session_host/ agent/bus.rs + channels/runtime/turn_driver.rs |
- | builder, hooks, codec, driver |
+ | agent/session_host/ agent/bus.rs + channels/runtime/ |
+ | builder, hooks, codec, driver turn_driver.rs |
+-----------------------------------------------------------------+
| |
v v
@@ -150,9 +150,11 @@ In order:
`AgentError`) and returns the final text.
The bus path is shorter. `bus.rs` scopes the origin, sandbox mode and file
-state agent id, then calls `channels::runtime::turn_driver::run_channel_turn_via_graph`
-([`../channels/runtime/turn_driver.rs`](../channels/runtime/turn_driver.rs)), which calls `TurnSpec::run`. There is
-no TinyAgents `Session`: the caller owns the history vector, and
+state agent id, then calls
+`channels::runtime::turn_driver::run_channel_turn_via_graph`
+([`../channels/runtime/turn_driver.rs`](../channels/runtime/turn_driver.rs)),
+which calls `TurnSpec::run`. There is no TinyAgents `Session`: the caller owns
+the history vector, and
`ask_user_clarification` is an early-exit tool whose question becomes the
reply.