Skip to content

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

docs(core): update READMEs with triage flow details

Steven Enamakelf30916a8c2d2
diff --git a/crates/openhuman-core/src/agent/README.md b/crates/openhuman-core/src/agent/README.md
index 7ee59736dd..b644d96637 100644
--- a/crates/openhuman-core/src/agent/README.md
+++ b/crates/openhuman-core/src/agent/README.md
@@ -258,8 +258,8 @@ The caller wraps the event in a `TriggerEnvelope`, `run_triage` sends a
zero-tool `trigger_triage` turn over `agent.run_turn` (cloud first, one
retry, then a local model arm, else `Deferred`), and `apply_decision` acts
on the parsed `drop` / `acknowledge` / `react` / `escalate` decision.
-`react` and `escalate` pass the approval gate and then run `trigger_reactor`
-or `orchestrator` through `subagent_host::run_subagent`. Cron jobs do not go
+`react` and `escalate` pass the approval gate and run `trigger_reactor` or
+`orchestrator` as direct one-shot agent turns under the triage context. Cron jobs do not go
through triage. See [triage/README.md](triage/README.md).
## Layout
@@ -344,8 +344,8 @@ Persistence, setup and RPC:
- `ParentExecutionContext` ([`harness/fork_context.rs`](./harness/fork_context.rs)): explicit parent
state a sub-agent reads from the run context (`parent`); `orchestration::parent_context::build_root_parent`
builds one for runs with no parent turn.
-- `run_subagent`, `run_subagent_with_parent`, `SubagentRunOptions`
- ([`subagent_host/lifecycle.rs`](./subagent_host/lifecycle.rs), [`subagent_host/types.rs`](./subagent_host/types.rs)).
+- `OpenHumanSubagentHost`, `SubagentRunOptions`
+ ([`subagent_host/lifecycle.rs`](./subagent_host/lifecycle.rs), [`subagent_host/types.rs`](./subagent_host/types.rs)); async delegation is dispatched through the registered subagent tools.
- `run_triage`, `apply_decision`, `TriggerEnvelope` (`triage/`).
- `SystemPromptBuilder` ([`crate::prompts::composition`](../prompts/composition.rs)) is the product adapter over TinyAgents prompt composition.
- `AgentTurnOrigin` and `with_origin` (`turn_origin.rs`).
diff --git a/crates/openhuman-core/src/triage/README.md b/crates/openhuman-core/src/triage/README.md
index 563eeb5a11..279eb3520d 100644
--- a/crates/openhuman-core/src/triage/README.md
+++ b/crates/openhuman-core/src/triage/README.md
@@ -31,8 +31,8 @@ notification ingest); those build a `TriggerEnvelope` and call in.
work. `react`/`escalate` first pass `ApprovalGate::intercept_audited` with
tool key `triage.react` / `triage.escalate`, then build a root
`ParentExecutionContext` (`orchestration::parent_context::build_root_parent`)
- and dispatch `trigger_reactor` or `orchestrator` via
- `agent::subagent_host::run_subagent`.
+ and run `trigger_reactor` or `orchestrator` as a direct one-shot agent turn
+ under the triage context.
4. Origin ([`origin.rs`](./origin.rs)): every caller scopes an `AgentTurnOrigin` around
`apply_decision` because `AGENT_TURN_ORIGIN` is a task-local and none of
the callers inherit one; an unscoped call reads `Unknown` and the gate