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
docs(agent): update harness references to channels runtime turn driver
Steven Enamakel6dae974b499c
diff --git a/crates/openhuman-core/src/agent/README.md b/crates/openhuman-core/src/agent/README.mdindex fca6624a94..558cdd9062 100644--- a/crates/openhuman-core/src/agent/README.md+++ b/crates/openhuman-core/src/agent/README.md@@ -24,7 +24,7 @@ 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 + harness/graph.rs |+ | agent/session_host/ agent/bus.rs + channels/runtime/turn_driver.rs || builder, hooks, codec, driver |+-----------------------------------------------------------------+| |@@ -150,8 +150,8 @@ 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 `harness::run_channel_turn_via_graph`-([`harness/graph.rs`](./harness/graph.rs)), which calls `TurnSpec::run`. There is+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 isno TinyAgents `Session`: the caller owns the history vector, and`ask_user_clarification` is an early-exit tool whose question becomes thereply.diff --git a/crates/openhuman-core/src/agent/harness/README.md b/crates/openhuman-core/src/agent/harness/README.mdindex 1b180cade9..c22c4a86e2 100644--- a/crates/openhuman-core/src/agent/harness/README.md+++ b/crates/openhuman-core/src/agent/harness/README.md@@ -2,10 +2,12 @@Product shell around the tinyagents tool loop. The model/tool iterationitself runs in `crate::agent::tinyagents` (via-`TurnSpec::run`); this module owns everything OpenHuman-layers on top: sub-agent definitions, post-turn memory/archival hooks, and-oversized-tool-result handling. Parent execution snapshots now live with the-sub-agent host in [`../subagent_host/fork_context.rs`](../subagent_host/fork_context.rs).+`TurnSpec::run`). This module owns sub-agent definitions, post-turn+memory/archival hooks, and oversized-tool-result handling. The channel/CLI+turn driver lives with channel runtime at+[`../../channels/runtime/turn_driver.rs`](../../channels/runtime/turn_driver.rs).+Parent execution snapshots live with the sub-agent host in+[`../subagent_host/fork_context.rs`](../subagent_host/fork_context.rs).`Agent`, its per-turn lifecycle, and transcript persistence live in[`../session_host/`](../session_host/), not here; this module supplies the definition/prompt data@@ -25,8 +27,6 @@ carried by the parent snapshot in [`../subagent_host/fork_context.rs`](../subage`../subagent_host/`, which implements the TinyAgents sub-agent lifecycletraits directly. This module does not export a compatibility runner of itsown.-- Run the channel/CLI turn graph ([`graph.rs`](./graph.rs)); all sub-agents use- the shared sub-agent turn graph.- Offload oversized worker artifacts to the filesystem, and persist oversizedtool results as action-workspace artifacts (`artifact_offload/`,`tool_result_artifacts/`).@@ -35,7 +35,6 @@ carried by the parent snapshot in [`../subagent_host/fork_context.rs`](../subage| Module | Role || --- | --- |-| `graph.rs` | `run_channel_turn_via_graph` (`pub(crate)`): the channel/CLI turn graph, thin over `TurnSpec::run`; called by the `agent.run_turn` native-bus handler in [`agent/bus.rs`](../bus.rs). || `artifact_offload/` | The `outputs/` / `workspace/` convention under `action_dir`: prompt half (`contract.rs`) and host policy half (`policy.rs`); mechanics (thresholds, path resolution, pointer rendering, the writer) live in `tinyagents_harness::artifacts` and are re-exported here. || `tool_result_artifacts/` | Wiring only: `new_tool_result_store` hands `tinyagents_harness::artifacts::tool_results` OpenHuman's redactor (`SanitizingRedactor`), `file_read`/`use_skill` names and `FileReadTool::MAX_FILE_SIZE_BYTES`. The store, `[tool_result_preview]` envelope, budgets and paged reads live in the crate. || `required_output.rs` | Pure validate/repair/synthesize primitives (issue #4117) that guarantee a required structured-output block (for example a `thoughts` JSON block) on every accepted turn. The orchestration that calls these lives on the session in [`../session_host/turn/`](../session_host/turn/). |@@ -85,8 +84,9 @@ turn lifecycle are in `../session_host/`; `OpenHumanSubagentHost`,- `../session_host/` and `../subagent_host/` build turns from thedefinitions and prompt data this module supplies; parent context types areowned by `../subagent_host/`.-- `agent/bus.rs` serves the `agent.run_turn` native request through- `run_channel_turn_via_graph`; channels reach the harness through that bus.+- `agent/bus.rs` serves the `agent.run_turn` native request through the+ driver in [`channels/runtime/turn_driver.rs`](../../channels/runtime/turn_driver.rs);+ channels reach it through that bus.- [`channels/runtime/dispatch/routing.rs`](../../channels/runtime/dispatch/routing.rs) consults`AgentDefinitionRegistry`/`ToolScope`.- `agent/tinyagents/middleware/credential_scrub.rs` callsdiff --git a/crates/openhuman-core/src/agent/tinyagents/README.md b/crates/openhuman-core/src/agent/tinyagents/README.mdindex 54226e61db..094f45785a 100644--- a/crates/openhuman-core/src/agent/tinyagents/README.md+++ b/crates/openhuman-core/src/agent/tinyagents/README.md@@ -100,7 +100,7 @@ Responses project the crate's own `AgentObservation` and `HarnessRunStatus` serd## Used by- [`agent/session_host/runtime_session/`](../session_host/runtime_session/): the chat-turn route into `TurnSpec::run`.-- [`agent/harness/graph.rs`](../harness/graph.rs): the channel/CLI bus turn route.+- [`channels/runtime/turn_driver.rs`](../../channels/runtime/turn_driver.rs): the channel/CLI bus turn route.- [`agent/subagent_host/`](../subagent_host/): the sub-agent spawn route. It and the session route both build their context-window summarizer through `TurnModelSource::build_summarizer`.- [`agent/session_host/builder/setters.rs`](../session_host/builder/setters.rs), `agent/subagent_host/ops/{provider,runner}.rs`, `channels/`: construct `TurnModelSource`.- [`agent/bus.rs`](../bus.rs): reads `TinyagentsTurnOutcome::resolved_route` after a turn.diff --git a/docs/gitbooks/en/developing/architecture/agent-harness.md b/docs/gitbooks/en/developing/architecture/agent-harness.mdindex cae28f9f2a..e50fe2c0f6 100644--- a/docs/gitbooks/en/developing/architecture/agent-harness.md+++ b/docs/gitbooks/en/developing/architecture/agent-harness.md@@ -622,7 +622,7 @@ The harness shell lives under `crates/openhuman-core/src/agent/`, with the tinya| `session_host/runtime_session.rs` | `Agent::turn`: the lifecycle described above; routes into the tinyagents runner via `tinyagents/turn_exec.rs`. || `tinyagents/mod.rs` | `TurnSpec::run`: the shared tinyagents harness assembly (the live loop). || `tinyagents/middleware.rs` | The named OpenHuman middleware stack (approval/security, tool policy, recovery, budgets, circuit breaker). |-| `harness/graph.rs` | The channel/CLI bus turn route into the tinyagents runner. |+| `../channels/runtime/turn_driver.rs` | The channel/CLI bus turn driver, placed with channel runtime and routed into the tinyagents runner. || `subagent_host/` | Direct OpenHuman planner/executor/persistence adapters for `tinyagents-orchestration::subagent`; product prompt/tool/model/security/artifact/progress behavior remains here. || `orchestration/subagent_sessions/` | Durable reusable sub-agent identity, compatibility matching, persisted status/history. || `../agent_registry/host_definition.rs` | Host extension and registry over `tinyagents_definition::AgentDefinition`. |