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 tinyagents crate references
Steven Enamakel4c06ba619f6e
diff --git a/crates/openhuman-core/src/agent/README.md b/crates/openhuman-core/src/agent/README.mdindex 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.mdindex 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 thismodule adapts rather than reimplements.## Further readingdiff --git a/crates/openhuman-core/src/agent/tinyagents/README.md b/crates/openhuman-core/src/agent/tinyagents/README.mdindex 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.rsindex 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 olderdiff --git a/crates/openhuman-core/src/core/events.rs b/crates/openhuman-core/src/core/events.rsindex 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.mdindex 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 theirlive updates stream over the web channel (`thread_goal_updated`,`thread_goal_cleared`, `thread_todos_changed`). There is no task-board ortodo-editing surface here.diff --git a/crates/openhuman-core/src/threads/ops/live_state.rs b/crates/openhuman-core/src/threads/ops/live_state.rsindex 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.rsindex 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