Skip to content

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

docs(agent): update tinyagents crate references

Steven Enamakel4c06ba619f6e
diff --git a/crates/openhuman-core/src/agent/README.md b/crates/openhuman-core/src/agent/README.md
index 1bf6c64178..7af7ad3bd2 100644
--- a/crates/openhuman-core/src/agent/README.md
+++ b/crates/openhuman-core/src/agent/README.md
@@ -42,7 +42,7 @@ is adapters that hand TinyAgents the things only OpenHuman knows.
| tinyagents-runtime Session: history, resume, commit |
| tinyagents-session SessionRef, transcripts, run ledger |
| tinyagents-harness AgentHarness loop, middleware, RunQueue |
- | tinyagents-graph / -orchestration delegation, sub-agents |
+ | tinyagents-orchestration delegation, sub-agents |
| tinytools, tinyinference Tool trait, ChatModel, providers |
+-----------------------------------------------------------------+
| |
diff --git a/crates/openhuman-core/src/agent/subagent_host/README.md b/crates/openhuman-core/src/agent/subagent_host/README.md
index 8c23927680..aa6251c327 100644
--- a/crates/openhuman-core/src/agent/subagent_host/README.md
+++ b/crates/openhuman-core/src/agent/subagent_host/README.md
@@ -59,8 +59,8 @@ survive that boundary on its own.
user-facing tools that call into this runner.
- `crate::agent::session_host` for the parent turn that sets up the
`ParentExecutionContext` a sub-agent reads.
-- [`vendor/tinyagents`](../../../../../vendor/tinyagents/) (`tinyagents-orchestration::subagent`,
- `tinyagents-graph`) for the lifecycle and delegation-graph mechanics this
+- [`vendor/tinyagents`](../../../../../vendor/tinyagents/) (`tinyagents-orchestration::subagent`)
+ for the lifecycle mechanics this
module adapts rather than reimplements.
## Further reading
diff --git a/crates/openhuman-core/src/agent/tinyagents/README.md b/crates/openhuman-core/src/agent/tinyagents/README.md
index 54226e61db..68c78ee281 100644
--- a/crates/openhuman-core/src/agent/tinyagents/README.md
+++ b/crates/openhuman-core/src/agent/tinyagents/README.md
@@ -38,7 +38,7 @@ The adapter seam between OpenHuman and the vendored [`tinyagents`](../../../../.
| [`tools.rs`](./tools.rs) | `CanonicalSharedToolAdapter`: resolves an OpenHuman shared tool registry and forwards the canonical `tinytools::Tool` contract; `EarlyExitHook` pauses successful `ask_user_clarification`-style calls. |
| `routes.rs` | the workload router projected from the upstream `WORKLOAD_ROUTES` table, `RequiredCapabilitiesMiddleware`, `FallbackObserverMiddleware`, `UsageCarryMiddleware`, and the per-model fallback policy. |
| [`observability.rs`](./observability.rs) + `observability/` | `event_bridge.rs`: `OpenhumanEventBridge`, translating crate `AgentEvent`s into `AgentProgress` and feeding per-call usage into `crate::platform::cost`. `event_projection.rs`: its `EventListener` impl. `bridge_types.rs`: `SubagentScope` and the shared bridge carries (the cap pauser itself is `tinyagents_harness::events::CapPauser`). |
-| [`host/steering.rs`](./host/steering.rs) | OpenHuman's steering allowlist and the shared `SteeringRegistry` for detached sub-agents. Task primitives are imported directly from `tinyagents_graph::orchestration`. |
+| [`host/steering.rs`](./host/steering.rs) | OpenHuman's steering allowlist and the shared `SteeringRegistry` for detached sub-agents. Task primitives come from `tinyagents_orchestration`. |
| [`payload_summarizer.rs`](./payload_summarizer.rs) | `PayloadSummarizer` trait, `SummarizeOutcome`/`UnavailableReason`, and the default `SubagentPayloadSummarizer` that compresses oversized tool results through the `summarizer` sub-agent instead of hard-truncating them. |
| [`policy_denial.rs`](./policy_denial.rs) | `maybe_enrich_policy_block`: rewrites `[policy-blocked]` tool results into structured what/why/workaround messages that tell the model to relay the denial rather than fabricate output. Called from `ToolOutcomeCaptureMiddleware`. |
| [`host/run_context.rs`](./host/run_context.rs) + typed tool dispatch | `OpenHumanRunContext` owns one root `CancellationToken`; child contexts share it and recursive tools receive it from their typed parent `RunContext`. |
@@ -90,7 +90,7 @@ Responses project the crate's own `AgentObservation` and `HarnessRunStatus` serd
## Dependencies
-- The vendored crates under [`vendor/tinyagents/`](../../../../../vendor/tinyagents/): `tinyagents-harness`, `tinyagents-graph`, `tinyagents-registry`, plus `tinyinference` and `tinytools` from [`vendor/tinyagents/vendor/`](../../../../../vendor/tinyagents/vendor/), all declared as path dependencies in [`crates/openhuman-core/Cargo.toml`](../../../Cargo.toml). Per AGENTS.md, use this vendored copy; a second path to the same crates creates incompatible Rust types.
+- The vendored crates under [`vendor/tinyagents/`](../../../../../vendor/tinyagents/): `tinyagents-harness`, `tinyagents-orchestration`, `tinyagents-registry`, plus `tinyinference` and `tinytools` from [`vendor/tinyagents/vendor/`](../../../../../vendor/tinyagents/vendor/), all declared as path dependencies in [`crates/openhuman-core/Cargo.toml`](../../../Cargo.toml). Per AGENTS.md, use this vendored copy; a second path to the same crates creates incompatible Rust types.
- `crate::agent::message_convert` for `TranscriptMessage` to/from crate `Message` conversion.
- `crate::agent::harness::{run_queue, tool_result_artifacts}` and `crate::agent::{messages, progress, stop_hooks, cost, hooks, subagent_host}`: the OpenHuman-side turn plumbing this seam plugs into.
- `crate::tools`: the canonical `tinytools::Tool` trait resolved by `CanonicalSharedToolAdapter`, and `tools::registry::denials` for recording policy blocks.
diff --git a/crates/openhuman-core/src/agent/tinyagents/middleware.rs b/crates/openhuman-core/src/agent/tinyagents/middleware.rs
index 00ffd02bcd..83699ab6b1 100644
--- a/crates/openhuman-core/src/agent/tinyagents/middleware.rs
+++ b/crates/openhuman-core/src/agent/tinyagents/middleware.rs
@@ -1,11 +1,11 @@
-//! openhuman context concerns expressed as tinyagents graph middlewares
+//! OpenHuman context concerns expressed as TinyAgents harness middlewares
//! (issue #4249).
//!
//! Historically these ran in the in-house engine's tool/prompt plumbing
//! (`agent_tool_exec`, the session context adapter). The tinyagents turn path bypassed
//! them, so they were effectively dead on the live loop. Re-expressing them as
//! [`Middleware`](tinyagents_harness::middleware::Middleware) hooks restores the
-//! behaviour and makes the graph the single place cross-cutting context
+//! behaviour and makes the harness the single place cross-cutting context
//! concerns live:
//!
//! - `MicrocompactMiddleware` (`before_model`) — clear the bodies of older
diff --git a/crates/openhuman-core/src/core/events.rs b/crates/openhuman-core/src/core/events.rs
index 2639488bd6..398080e0b4 100644
--- a/crates/openhuman-core/src/core/events.rs
+++ b/crates/openhuman-core/src/core/events.rs
@@ -1313,8 +1313,8 @@ pub enum DomainEvent {
thread_id: String,
goal_id: String,
status: String,
- /// Full goal snapshot (owned by `tinyagents-graph`'s goal shape, so
- /// kept as a raw `Value` rather than a typed field here). `None`
+ /// Full goal snapshot (kept as a raw `Value` rather than a typed
+ /// field to keep this event independent of the harness tool type). `None`
/// until the publish site is updated to pass it through.
#[serde(default, skip_serializing_if = "Option::is_none")]
goal: Option<serde_json::Value>,
@@ -1325,7 +1325,7 @@ pub enum DomainEvent {
/// or reordered). Drives the desktop todo drawer.
ThreadTodosChanged {
thread_id: String,
- /// Full todo-list snapshot, owned by `tinyagents-graph`'s todo shape.
+ /// Full todo-list snapshot, kept independent of the harness tool type.
todos: serde_json::Value,
},
// ── Plan mode ───────────────────────────────────────────────────────
diff --git a/crates/openhuman-core/src/threads/README.md b/crates/openhuman-core/src/threads/README.md
index 534e233a34..42fcaa82e9 100644
--- a/crates/openhuman-core/src/threads/README.md
+++ b/crates/openhuman-core/src/threads/README.md
@@ -198,7 +198,7 @@ through `all_threads_registered_controllers`:
| Live agent state | `goal_get`, `todos_get` |
`goal_get` and `todos_get` are read-only. Goals and todos are written by the
-agent (`agent::goals`, `agent::todos`, backed by `tinyagents_graph`) and their
+agent (`agent::goals`, `agent::todos`, backed by `tinyagents_harness_tools`) and their
live updates stream over the web channel (`thread_goal_updated`,
`thread_goal_cleared`, `thread_todos_changed`). There is no task-board or
todo-editing surface here.
diff --git a/crates/openhuman-core/src/threads/ops/live_state.rs b/crates/openhuman-core/src/threads/ops/live_state.rs
index 69d40ae117..d456ce4c2b 100644
--- a/crates/openhuman-core/src/threads/ops/live_state.rs
+++ b/crates/openhuman-core/src/threads/ops/live_state.rs
@@ -19,8 +19,8 @@ pub struct ThreadLiveStateRequest {
/// Response for [`goal_get`]: the thread's current goal, or `None` when the
/// thread has none. Mirrors the `goal` field on `ThreadGoalUpdated` /
-/// `thread_goal_updated` — a raw `Value` because `ThreadGoal` is owned by
-/// `tinyagents-graph`.
+/// `thread_goal_updated` — a raw `Value` to keep the RPC contract independent
+/// of the harness tool's internal goal type.
#[derive(Debug, Clone, serde::Serialize)]
pub struct ThreadGoalGetResponse {
pub goal: Option<serde_json::Value>,
diff --git a/crates/openhuman-core/src/web_chat/channel_event.rs b/crates/openhuman-core/src/web_chat/channel_event.rs
index 6a66d2866a..60634dba5f 100644
--- a/crates/openhuman-core/src/web_chat/channel_event.rs
+++ b/crates/openhuman-core/src/web_chat/channel_event.rs
@@ -218,8 +218,8 @@ pub struct WebChannelEvent {
#[serde(skip_serializing_if = "Option::is_none")]
pub queue_item: Option<QueueItemPayload>,
/// Session goal snapshot, carried on goal-lifecycle events. Left as a
- /// raw `Value` because the goal shape is owned by `tinyagents-graph`,
- /// not this crate.
+ /// raw `Value` so the wire event remains independent of the harness
+ /// tool's internal goal type.
#[serde(skip_serializing_if = "Option::is_none")]
pub goal: Option<serde_json::Value>,
/// Session todo-list snapshot, carried on todo-lifecycle events. Raw