Iruka signal layer

Give agents one clean reason to wake up.

Iruka turns public data into saved signal contracts. Define when to wake, what to check, and where the result should land without asking every agent to run its own watcher.

contractsig_vault_exits
latest run
08:00 UTCwake scheduled
USDL vaultsupplier exit threshold crossed
agent inboxreason delivered with context
Why it exists

Monitoring belongs in a contract, not in every agent runtime.

Before

Every agent rebuilds the same monitoring loop.

Schedules, RPC reads, event backfills, repeat rules, and notification routing get buried inside local scripts.

Iruka

The wake-up rule becomes a shared contract.

Triggers, definitions, delivery, and metadata stay visible as one saved signal that humans can inspect and agents can reuse.

After

Agents receive the matched reason instead of a stream.

The notification includes context about what changed, so the next action starts from evidence rather than polling.

Public schema

Change the wake-up path without rewriting the condition.

The schema is small on purpose. Triggers decide when to run, the definition decides what to inspect, and delivery decides where the matched reason goes.

triggers[]when the signal wakes
definitionwhat condition must match
delivery[]where the reason lands
metadatahow repeats and descriptions behave
Schedule

Wake on interval or UTC cron.

signal.patch.json
What agents get

The parts of monitoring that should not live inside agent code.

Multiple ways to wake

Intervals, cron schedules, external calls, and upstream Iruka signals can sit in the same trigger array.

Data sources stay behind the rule

Onchain state, indexed history, raw events, and expressions are inputs to one readable condition.

Delivery includes context

Telegram messages carry the matched reason so an agent can decide what to do next.

Repeat behavior is explicit

Cooldowns, windows, and until-resolved policies live with the saved signal rather than hidden in glue code.

Ready signal

Save the rule once. Let the next agent start from evidence.