Skip to content

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

4.2 KB
Raw Blame

docs/plans/

Cross-repository work plans for the agent-runtime migration, plus one dated measurement that was filed here by mistake. The normative boundary these plans implement is ../specs/agent-runtime-upstream-boundary.md.

A plan here exists because the work spans OpenHuman and one or more vendored submodules and cannot be owned accurately by a single source directory. Durable architecture belongs in docs/gitbooks/en/developing/architecture/ and in the beside-code crates/openhuman-core/src/<domain>/README.md (see crates/README.md), not here.

Status, verified 2026-10-07

Checked against the tree rather than against each plan's own status line, because several of those lines no longer hold.

Plan Status
extract-remaining-harness-session-and-subagent-runner.md Landed. agent/harness/{session,subagent_runner,run_queue}/ and agent/task_dispatcher/ are all deleted; agent/session_host/ and agent/subagent_host/ replaced them.
migrate-agent-sessions-to-tinyagents-session.md Landed. The transcript model and JSONL codec live in vendor/tinyagents/crates/tinyagents-session/src/transcript/.
migrate-agent-runtime-helper-packages.md Landed. All four slices are complete; what remains host-side is what the plan prescribes keeping.
migrate-agent-orchestration-to-tinyagents.md Landed except O6. tinyagents-orchestration/src/ holds subagent/, teams/ and workflow/; there is no parallel/.
migrate-agent-runtime-to-tinyagents.md Live. Task 4 is outstanding: 25 task_local! declarations remain in the core. Tasks 10 and 11 landed: harness_assembly.rs and turn_runner.rs are gone, replaced by turn_plan.rs, turn_middleware.rs and turn_exec.rs over the runtime TurnDriver.
migrate-agent-runtime-waves.md Live. Gate 4 is unmet: scripts/ci/agent-runtime-boundary-baseline.json is still checked in, with 213 baselined violations, and the gate requires it deleted.
jev-tool-search-baseline.md Not a plan. A dated measurement report (2026-09-22) for tool_search ranking. It is linked from the root README.md, crates/openhuman-tinyhumans/src/jev/README.md and docs/gitbooks/en/developing/jev.md, so its path is a contract; leave it where it is.

Delete the four landed plans, and the spec with them, once Task 4, Gate 4 and O6 are closed. Until then they are the record of what was moved and why, and the two live plans point at them.

Reproducing the status check

# landed trees are gone, their replacements are present
ls crates/openhuman-core/src/agent/harness/            # no session/ subagent_runner/ run_queue/
ls crates/openhuman-core/src/agent/session_host/ crates/openhuman-core/src/agent/subagent_host/

# O6
ls vendor/tinyagents/crates/tinyagents-orchestration/src/

# Task 4
grep -rn 'task_local!' crates/openhuman-core/src --include='*.rs' | grep -v _tests | wc -l

# Tasks 10 and 11 (both files are gone)
ls crates/openhuman-core/src/agent/tinyagents/turn_plan.rs \
   crates/openhuman-core/src/agent/tinyagents/turn_exec.rs

# Gate 4
python3 -c "import json;print(len(json.load(open('scripts/ci/agent-runtime-boundary-baseline.json'))))"

Further reading