Relay tools — declaration-only
Elixir · package toolnexus · SPEC §10
Declare a tool the host executes, not the library: the call rides out on the suspension.
What to use instead
Section titled “What to use instead”There is no declaration-only relay tool in Elixir today — every tool the loop knows about is
executable in-process. The closest available shape is an ordinary tool whose execute itself
returns a §10 suspension (metadata.pending, see pending):
the model still calls it like a normal tool, but the call “rides out” as a Request for the host
to answer, exactly as a relay declaration would — the difference is Elixir’s version always runs
some code locally first (even if that code’s only job is to raise the suspension), where a true
relay tool is declared but never invoked by the library at all.
See also
Section titled “See also”Toolnexus.Client.create— The single hook where the host resolves a suspension — in-process prompt or durable queue, same contract.Toolnexus.Agents.Runtime.resume— The answer-carrying entry point: resume a parked run in a different process.