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 with null, no retry guarantees
  • Enqueue (TriggerAction.Enqueue({ queue })): routes through a named queue with automatic retries and backoff, returns a messageReceiptId
  • 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
Installs
42
Repository
iii-hq/iii
GitHub Stars
15.6K
First Seen
Apr 6, 2026