golemcloud Fire-and-Forget Agent Invocation (Scala)
Overview
A fire-and-forget call enqueues a method invocation on the target agent and returns immediately without waiting for the result. The target agent processes the invocation asynchronously.
Usage
Access the .trigger() method on a per-method wrapper to call methods without awaiting:
val counter = CounterAgentClient.get("my-counter")
// Fire-and-forget — returns immediately
counter.increment.trigger()
// With arguments
val processor = DataProcessorAgentClient.get("pipeline-1")
processor.processBatch.trigger(batchData)
When to Use
- Breaking RPC cycles: If agent A calls agent B and B needs to call back to A, use
.triggerfor the callback to avoid deadlocks - Background work: Enqueue work on another agent without blocking the current agent
- Fan-out: Trigger work on many agents in parallel without waiting for all results
- Event-driven patterns: Notify other agents about events without coupling to their processing time
Example: Breaking a Deadlock
// In AgentA — calls AgentB and waits
val b = AgentBClient.get("b1")
val result = b.doWork(data) // OK: awaited call
// In AgentB — notifies AgentA without waiting (would deadlock if awaited)
val a = AgentAClient.get("a1")
a.onWorkDone.trigger(result) // OK: fire-and-forget
CLI Equivalent
From the command line, use --trigger:
golem agent invoke --trigger 'counter-agent("my-counter")' \
'my:comp/counter-agent.{increment}'