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(composio): update stale orchestrator tool path references
Steven Enamakele23d4be76c72
diff --git a/crates/openhuman-core/src/agent/context/README.md b/crates/openhuman-core/src/agent/context/README.mdindex 1d030eaa50..b7ca313d4c 100644--- a/crates/openhuman-core/src/agent/context/README.md+++ b/crates/openhuman-core/src/agent/context/README.md@@ -69,7 +69,7 @@ No `store.rs`. State is per-session and in-memory:- `agent::tinyagents`: `turn_middleware.rs` reads `CLEARED_PLACEHOLDER` when configuring `MicrocompactMiddleware`; `payload_summarizer.rs` and `host/context_composer.rs` build `PromptContext`s through `agent::prompts`.- **`agent_registry::agents/*/prompt.rs`**, `skills/*/agent/*/prompt.rs`: archetype prompt modules pull prompt sections/builder through `agent::prompts`.- `channels`: [`channels/system_prompt.rs`](../../channels/system_prompt.rs) (`ChannelSystemPrompt`, used by [`channels/runtime/startup/start_channels.rs`](../../channels/runtime/startup/start_channels.rs)) calls `channels_prompt::build_system_prompt_with_identity`; [`channels/mod.rs`](../../channels/mod.rs) re-exports `build_system_prompt`; the `channels/tests/*` prompt/identity tests call it directly.-- `agent::triage`, `agent::debug`, `agent::orchestration::tools` (spawn_subagent and friends), `tools::orchestrator_tools`, `integrations::composio`: consume prompt types (`PromptContext`, `PromptSection`, `ToolCallFormat`, `ConnectedIntegration`, …) via `agent::prompts`.+- `agent::triage`, `agent::debug`, `agent::orchestration::tools` (spawn_subagent and friends), `integrations::composio`: consume prompt types (`PromptContext`, `PromptSection`, `ToolCallFormat`, `ConnectedIntegration`, …) via `agent::prompts`.## Notes / gotchasdiff --git a/crates/openhuman-core/src/agent/session_host/types.rs b/crates/openhuman-core/src/agent/session_host/types.rsindex b13e367d9d..54ee35eb81 100644--- a/crates/openhuman-core/src/agent/session_host/types.rs+++ b/crates/openhuman-core/src/agent/session_host/types.rs@@ -159,7 +159,7 @@ pub struct OpenHumanSessionHost {pub(super) tools: Arc<Vec<Box<dyn Tool>>>,/// The delegation tools synthesised for the current connection set —/// `delegate_<toolkit>` skill tools and archetype delegates, produced by- /// [`crate::tools::orchestrator_tools::collect_orchestrator_tools`].+ /// [`crate::integrations::composio::orchestrator_actions::collect_orchestrator_tools`].////// Held apart from [`Self::tools`] because it is the only part of the/// surface that changes mid-session, and `Box<dyn Tool>` is not cloneable:@@ -524,7 +524,7 @@ pub struct OpenHumanSessionHost {/// re-announced per turn. Seeded from the session-build catalogue.pub(super) announced_skills: std::collections::HashSet<String>,/// Names of every tool currently in [`OpenHumanSessionHost::synthesized_tools`] — those- /// produced by [`crate::tools::orchestrator_tools::collect_orchestrator_tools`]+ /// produced by [`crate::integrations::composio::orchestrator_actions::collect_orchestrator_tools`]/// (i.e. `delegate_<toolkit>` skill tools and archetype-delegation/// tools). Tracked so/// [`OpenHumanSessionHost::refresh_delegation_tools`] can drop the entirediff --git a/crates/openhuman-core/src/agent_registry/agents/orchestrator/prompt.rs b/crates/openhuman-core/src/agent_registry/agents/orchestrator/prompt.rsindex f019009980..c359043c56 100644--- a/crates/openhuman-core/src/agent_registry/agents/orchestrator/prompt.rs+++ b/crates/openhuman-core/src/agent_registry/agents/orchestrator/prompt.rs@@ -4,7 +4,7 @@//! cheap direct tools whenever possible, and delegate only for specialised//! execution. Connected Composio integrations are part of that direct//! surface: every connected toolkit's actions are registered as `Deferred`-//! tools (`orchestrator_tools::collect_deferred_integration_actions`), so+//! tools (`orchestrator_actions::collect_deferred_integration_actions`), so//! the `## Connected Integrations` block tells the model to `tool_search`//! for the action and call it — there is no integrations sub-agent to//! delegate to any more. That prose lives here (not in the shared prompts@@ -133,8 +133,8 @@ pub fn build(ctx: &PromptContext<'_>) -> Result<String> {/// none of it conditioned on the live tool set, and ten of those names were/// tools a pack had withheld: the prompt taught the model to call something it/// could not see, and nothing in the build compared the two. Deriving the rows-/// from the same registry `collect_orchestrator_tools` synthesises the-/// delegates from means a pack change moves both halves at once.+/// from the same registry `collect_orchestrator_tools` filters for the+/// orchestrator's skills wildcard, so a pack change moves both halves at once.////// **Advertised specialists are deliberately absent.** Their `when_to_use` is/// already their tool description on the wire, and restating it here would bediff --git a/crates/openhuman-core/src/integrations/composio/README.md b/crates/openhuman-core/src/integrations/composio/README.mdindex 67580d5e15..11d01f4523 100644--- a/crates/openhuman-core/src/integrations/composio/README.md+++ b/crates/openhuman-core/src/integrations/composio/README.md@@ -53,7 +53,7 @@ triggers) from a real transport failure.| `crates/openhuman-core/src/integrations/composio/module_client.rs` | The `tinyconnectors` module bridge: the one `modules`-feature `#[cfg]` switch, `methods` re-exported from `tinyconnectors_bus`, and member-failure classification (`is_unsupported_by_route`, error-prefix peeling). || [`crates/openhuman-core/src/integrations/composio/tools.rs`](./tools.rs) + `tools/` (`authorize.rs`, `connect.rs`, `list_connections.rs`, `list_toolkits.rs`, `list_tools.rs`, `execute.rs`, `registry.rs`, `visibility.rs`) | Agent tools (`ComposioListToolkitsTool`, `ComposioListConnectionsTool`, `ComposioAuthorizeTool`, `ComposioConnectTool`, `ComposioListToolsTool`, `ComposioExecuteTool`) + `all_composio_agent_tools`; scope/visibility gating (`resolve_action_scope`, `evaluate_tool_visibility`). || `crates/openhuman-core/src/integrations/composio/client/{credential,network,direct}.rs` | The direct (BYO-key) reads. `credential.rs` is the key plus a validated base URL (HTTPS-or-loopback guard); `network.rs` resolves the host's `tool.composio` proxy and TLS policy for the module; `direct.rs` calls the module's stateless `ListConnectionsDirect` / `ListToolsDirect` members (the credential rides on the request, so the configured route is untouched and an unsaved key can be probed) under the host's invalid-key gate (`direct_auth`). Redirects are refused and failures are rendered with the messages users see by the module; the v3 paths and reshaping are `tinyconnectors::client::DirectRoute`. |-| [`crates/openhuman-core/src/integrations/composio/action_tool.rs`](./action_tool.rs) | `ComposioActionTool`: a `Tool` wrapping exactly one Composio action, constructed as a `ToolExposure::Deferred` tool per action of every connected toolkit ([`tools/orchestrator_tools.rs`](../../tools/orchestrator_tools.rs), and [`integrations/recorded_tools.rs`](../../integrations/recorded_tools.rs) when a resumed thread rebuilds its recorded actions), reached by the orchestrator through `tool_search`. |+| [`crates/openhuman-core/src/integrations/composio/action_tool.rs`](./action_tool.rs) | `ComposioActionTool`: a `Tool` wrapping exactly one Composio action, constructed as a `ToolExposure::Deferred` tool per action of every connected toolkit ([`orchestrator_actions.rs`](./orchestrator_actions.rs), and [`recorded_tools.rs`](../recorded_tools.rs) when a resumed thread rebuilds its recorded actions), reached by the orchestrator through `tool_search`. || [`crates/openhuman-core/src/integrations/composio/contract_gate.rs`](./contract_gate.rs) | Late-bound action contract gate (#4853): on an action's first call this turn, surfaces the full live contract (via `catalog::fetch_live_toolkit_catalog`) as a recoverable tool error before executing, so the retry has the real schema in context. || [`crates/openhuman-core/src/integrations/composio/catalog.rs`](./catalog.rs) | Call surface over the module's `ListToolContracts` / `ProbeToolOutput` members (`fetch_live_toolkit_catalog`, `probe_tool_output_sample`, `ToolContract` = `tinyconnectors_bus::ComposioToolContract`). The module owns the live fetch, the 30-minute cache, the confirmed-Read probe and its overlay; unit tests seed contracts through the test-only `catalog_seed.rs`. || [`crates/openhuman-core/src/integrations/composio/connected_integrations.rs`](./connected_integrations.rs) + `connected_integrations/` (`cache.rs`, `fetch.rs`) | Process cache over the module's `ListConnectedIntegrations` (`cached_active_integrations`, `fetch_connected_integrations*`) reconciled against `list_connections`; `fetch.rs` picks the backend/direct mode and maps the reply to the prompt types. |diff --git a/crates/openhuman-core/src/integrations/composio/action_tool.rs b/crates/openhuman-core/src/integrations/composio/action_tool.rsindex 2a1dd75f9e..2e160eda4c 100644--- a/crates/openhuman-core/src/integrations/composio/action_tool.rs+++ b/crates/openhuman-core/src/integrations/composio/action_tool.rs@@ -11,7 +11,7 @@//! [`ComposioActionTool::deferred`] builds the same tool as a//! `ToolExposure::Deferred` registration for a parent session://! every action of every connected toolkit is synthesised beside the-//! delegation tools (`tools::orchestrator_tools`), stays off the wire, and+//! delegation tools (`integrations::composio::orchestrator_actions`), stays off the wire, and//! is found through the harness's `tool_search` bridge — so one clear action//! ("send Alex a Slack message") is a search and a call, not a sub-agent//! run. Those instances have no spawn-time config to anchor to and resolvediff --git a/crates/openhuman-core/src/integrations/composio/connected_integrations/cache.rs b/crates/openhuman-core/src/integrations/composio/connected_integrations/cache.rsindex 43635d4ec6..81cca0da22 100644--- a/crates/openhuman-core/src/integrations/composio/connected_integrations/cache.rs+++ b/crates/openhuman-core/src/integrations/composio/connected_integrations/cache.rs@@ -306,7 +306,7 @@ pub(crate) fn read_cached_integrations_from(/// hashes within one process lifetime.////// Only `connected == true` entries contribute. Unconnected toolkits are-/// stripped by [`crate::tools::orchestrator_tools::collect_orchestrator_tools`]+/// stripped by [`crate::integrations::composio::orchestrator_actions::collect_orchestrator_tools`]/// anyway, so churn among the unconnected set never changes the agent's/// surface and shouldn't trigger a refresh.pub fn connected_set_hash(integrations: &[ConnectedIntegration]) -> u64 {