Skip to content

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

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.md
index 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 / gotchas
diff --git a/crates/openhuman-core/src/agent/session_host/types.rs b/crates/openhuman-core/src/agent/session_host/types.rs
index 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 entire
diff --git a/crates/openhuman-core/src/agent_registry/agents/orchestrator/prompt.rs b/crates/openhuman-core/src/agent_registry/agents/orchestrator/prompt.rs
index 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 be
diff --git a/crates/openhuman-core/src/integrations/composio/README.md b/crates/openhuman-core/src/integrations/composio/README.md
index 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.rs
index 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 resolve
diff --git a/crates/openhuman-core/src/integrations/composio/connected_integrations/cache.rs b/crates/openhuman-core/src/integrations/composio/connected_integrations/cache.rs
index 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 {