golem-fire-and-forget-ts

To trigger async agent calls without blocking, use the generated client method `.trigger()` instead of awaiting the invocation. This enqueues the target agent method and returns immediately, allowing your current agent to continue processing. It applies to TypeScript Golem projects.

Fire-and-forget invocation avoids deadlocks by enabling async callbacks where Agent A triggers Agent B and continues without waiting. This prevents cyclic waits, allowing event-driven workflows and parallel fan-out tasks to execute independently without coupling to downstream processing time.

The best way to perform parallel fan-out is using the `.trigger()` method on your target agents. By triggering multiple agent tasks in parallel, you enqueue work instantly without blocking the caller, enabling responsive event-driven workflows.

Yes, you can use the fire-and-forget trigger behavior from the command line. The `.trigger()` client method supports the enqueue behavior equivalent to the `golem agent invoke --enqueue` command, allowing you to queue agent work via CLI workflows.

You should not use fire-and-forget triggers when the current agent immediately depends on the result of the target agent method. Because `.trigger()` returns instantly without waiting, it is only suited for async callbacks and background work where the result is not needed right away.