Tool reach
Which tools an agent can reach and what it did with them: the agent in the middle, every tool of the run around it with a wire where access exists, cards for used, busy, failed or unused, and each tool's calls one click away with a replay.
oxyn add tool-reachTool access
1 running6/9 tools · 7 callsShip the new pricing page and hook up the payment step
rsx! {
ToolReach {
tools: Some(run.tools()),
agents: Some(run.agents()),
now: clock.now(),
on_replay: move |(agent, tool, input)| run.replay(agent, tool, input),
}
}Rendered from Rust at build time · goes live when visible
When to use
- Show which of a run's tools each agent can reach and what it did with them, and let you read any tool's calls and replay one – unchanged or with an edited input.
When not to use
- An agent asks before it acts: use Approval Card instead.
- Several open requests in one card: use Approval pager instead.
- An agent's question in its own card above the composer: use Decision Card instead.
Installation
Tool reach is free and MIT. The oxyn CLI copies its code, and the components it needs, into src/oxyn/ of your Dioxus or GPUI project, so it is yours to change.
cargo install --git https://github.com/ismailqureshi72/Oxyn oxyn-cli
oxyn init
oxyn add tool-reachuse crate::oxyn::{ToolReach, STATUS_INDICATOR_CSS};Rather depend on the crate? cargo add oxyn-dioxus oxyn-core --git https://github.com/ismailqureshi72/Oxyn, then use oxyn_dioxus::{ToolReach, STATUS_INDICATOR_CSS};
Usage
rsx! {
ToolReach {
tools: Some(run.tools()),
agents: Some(run.agents()),
now: clock.now(),
on_replay: move |(agent, tool, input)| run.replay(agent, tool, input),
}
}Examples
Map
The builder agent in the middle: six of nine tools in reach, the shell busy with a build (its wire shimmers), the rest used once or more, and three tools it cannot touch.
Tool access
1 running6/9 tools · 7 callsShip the new pricing page and hook up the payment step
Code
rsx! {
ToolReach {
tools: Some(run.tools()),
agents: Some(run.agents()),
now: clock.now(),
on_replay: move |(agent, tool, input)| run.replay(agent, tool, input),
}
}Other agent
Another agent on the same layout: most cards drop to No access, a query is in flight and the last web search failed.
Tool access
1 running3/9 tools · 2 callsFind what people say about our prices in 80 support tickets
Code
rsx! {
ToolReach {
tools: Some(run.tools()),
agents: Some(run.agents()),
now: clock.now(),
on_replay: move |(agent, tool, input)| run.replay(agent, tool, input),
}
}Needs you
An agent waiting on a person: the amber Needs you badge on its card.
Tool access
3/9 tools · 1 callsWrite the launch note and post it once someone signs it off
Code
rsx! {
ToolReach {
tools: Some(run.tools()),
agents: Some(run.agents()),
now: clock.now(),
on_replay: move |(agent, tool, input)| run.replay(agent, tool, input),
}
}Calls
A tool opened: its calls newest first, the picked call's input and output, Edit input and Replay. Escape or the back arrow returns to the map.
Tool access
1 running6/9 tools · 7 calls{ "commit": "Wire the pay button", "files": 2 }{ "sha": "4b07d1f" }Code
rsx! {
ToolReach {
tools: Some(run.tools()),
agents: Some(run.agents()),
now: clock.now(),
on_replay: move |(agent, tool, input)| run.replay(agent, tool, input),
}
}Replaying
A replay in flight: the new call is marked Replay, the output waits and both buttons hold until it lands.
Tool access
2 running6/9 tools · 8 calls{ "pull_request": "Pricing v3", "base": "main" }Waiting for the result
Code
rsx! {
ToolReach {
tools: Some(run.tools()),
agents: Some(run.agents()),
now: clock.now(),
on_replay: move |(agent, tool, input)| run.replay(agent, tool, input),
}
}Editing
Editing the input before a replay: Cmd or Ctrl + Enter runs it.
Tool access
1 running6/9 tools · 7 calls{ "sha": "9c1e7a2" }Code
rsx! {
ToolReach {
tools: Some(run.tools()),
agents: Some(run.agents()),
now: clock.now(),
on_replay: move |(agent, tool, input)| run.replay(agent, tool, input),
}
}Failed
A failed call: the error text in red in the output.
Tool access
1 running3/9 tools · 2 calls{ "q": "pricing page conversion benchmarks" }Rate limited – try again in 30 s
Code
rsx! {
ToolReach {
tools: Some(run.tools()),
agents: Some(run.agents()),
now: clock.now(),
on_replay: move |(agent, tool, input)| run.replay(agent, tool, input),
}
}Narrow
Under 540 px the agent sits on top and the tools fall into two columns below; the wires go.
Tool access
1 running6/9 tools · 7 callsShip the new pricing page and hook up the payment step
Code
rsx! {
ToolReach {
tools: Some(run.tools()),
agents: Some(run.agents()),
now: clock.now(),
on_replay: move |(agent, tool, input)| run.replay(agent, tool, input),
}
}Classic
Classic style: one framed card with a header band and squarer cards.
Tool access
1 running6/9 tools · 7 callsShip the new pricing page and hook up the payment step
Code
rsx! {
ToolReach {
tools: Some(run.tools()),
agents: Some(run.agents()),
now: clock.now(),
on_replay: move |(agent, tool, input)| run.replay(agent, tool, input),
}
}API reference
ToolReach
| Prop | Type | Default | Description |
|---|---|---|---|
tools | Option<Vec<TmTool>> | Default::default() | Every tool of the run, in layout order (the demo's when `None`). |
agents | Option<Vec<TmAgent>> | Default::default() | The agents (the demo's when `None`). |
agent | Option<String> | Default::default() | The agent shown first (the first one when `None`). |
open | Option<String> | Default::default() | A tool whose calls are open from the start. |
call | Option<String> | Default::default() | The call picked in the calls view (the newest when `None`). |
editing | bool | Default::default() | Start with the input being edited. |
title | String | "Tool access" | Heading. |
nowrequired | ClockMs | — | The clock (replays settle with it). |
style | String | Default::default() | `clean`, `classic`, or empty to follow `data-cstyle`. |
on_agent_change | EventHandler<String> | — | Another agent was picked (id). |
on_replay | EventHandler<(String, String, String)> | — | A call was replayed: (agent, tool, input). |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| ←or→ | Moves between the agent tabs |
| TaborEnter | Through the tools; Enter opens a tool's calls |
| ↑or↓ | Moves through the calls (the list is one tab stop) |
| Escape | Back to the map |
| CmdorCtrlEnter | Runs the edited input |
Accessibility
- The agents are a tablist; each tool is a button named with its state and call count; tools out of reach are disabled.
- States are words (Running, Failed, Not used yet, No access), never colour alone; the counts are a status region.
- Reduced motion stops the wire shimmer and the slide-in.
Responsive behaviour
- Tool cards have one fixed size, so nothing shifts when a call starts, ends or fails.
- Below 540 px the agent card leads, two columns of tools follow with no wires, and the calls view stacks its list over the details.
Edge cases (spec)
Fixed card sizes. Under 540 px (container query) the agent card leads, the tools sit in two columns below with no wires, and the calls view stacks the list above the call.
Notes for AI
- Import
ToolReachfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
ToolReachElinoxyn_gpui. - Props to set first:
now. - It reads a clock (
now) for live timers; pass one clock for the whole page rather than one per component. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.