pub struct RemoteNode { /* private fields */ }Expand description
A Node that executes its work on a remote worker over HTTP.
Registered in a graph exactly like a local node — this is the whole point
of the design: one Node trait, remote impls behind the same trait.
Error semantics across the wire. A worker-side failure arrives as a
plain message string and flattens to RustyError::Node — a hard,
non-retryable failure. Even when the remote failure originated in the
worker’s LLM or tool layer, that retryability does not survive the wire:
the executor’s retry classification (RustyError::Llm /
RustyError::Tool are the transient classes) only applies to
errors raised by local nodes, and RustyError::Node is never in
it. This client’s own retries cover transport-class failures only (see
the module-level reliability notes).
use std::time::Duration;
use rusty_agent_runtime::graph::GraphBuilder;
use rusty_agent_runtime::remote::RemoteNode;
let node = RemoteNode::new("doubler", "http://127.0.0.1:8200")
.with_timeout(Duration::from_secs(5))
.with_retries(2);
let mut builder = GraphBuilder::new();
builder.add_node("double", node);Implementations§
Source§impl RemoteNode
impl RemoteNode
Sourcepub fn new(node_name: impl Into<String>, base_url: impl Into<String>) -> Self
pub fn new(node_name: impl Into<String>, base_url: impl Into<String>) -> Self
A remote node dispatched to the worker handler node_name, served by
the worker at base_url (e.g. "http://127.0.0.1:8200").
A trailing / is trimmed and /execute appended. If base_url
already ends in /execute it is used verbatim.
Sourcepub fn with_timeout(self, timeout: Duration) -> Self
pub fn with_timeout(self, timeout: Duration) -> Self
Override the per-attempt timeout.
Sourcepub fn with_retries(self, max_retries: u32) -> Self
pub fn with_retries(self, max_retries: u32) -> Self
Override the number of retries after the initial attempt
(0 = single attempt, no retries).
Sourcepub fn with_backoff(self, base_backoff: Duration) -> Self
pub fn with_backoff(self, base_backoff: Duration) -> Self
Override the base backoff delay (attempt n waits roughly
base * 2^n, exponent capped and jittered).
Sourcepub fn execute_url(&self) -> &str
pub fn execute_url(&self) -> &str
The full execute-endpoint URL.
Trait Implementations§
Source§impl Clone for RemoteNode
impl Clone for RemoteNode
Source§impl Node for RemoteNode
impl Node for RemoteNode
Source§fn name(&self) -> &str
fn name(&self) -> &str
"anonymous";
the graph tracks nodes by the name given to add_node, which is the
authoritative identity.