iii-trigger-actions
Originally fromiii-hq/skills
Installation
SKILL.md
Trigger Actions
Comparable to: RPC vs message queue vs fire-and-forget patterns
Key Concepts
Use the concepts below when they fit the task. Not every invocation needs all three modes.
- Synchronous (default): caller blocks until the function returns a result or times out
- Void (
TriggerAction.Void()): fire-and-forget dispatch, returns immediately withnull, no retry guarantees - Enqueue (
TriggerAction.Enqueue({ queue })): routes through a named queue with automatic retries and backoff, returns amessageReceiptId - Decision guide: need the result? use sync. Must complete reliably? use enqueue. Optional side effect? use void.
Architecture
The caller invokes trigger() with an optional action parameter. Synchronous mode waits for the handler result. Void mode dispatches and returns null immediately. Enqueue mode places the payload on a named queue where a consumer processes it with retry guarantees.
iii Primitives Used
Related skills