Infrastructure · Primitives

Cooldown

Mandatory delay between repeated actions

Definition

Mechanism

Minimum Interval Enforcement: After action A, enforce minimum delay D before A can repeat. Attempts during cooldown rejected or queued. Cooldown timer starts on action completion. Different actions can have different cooldowns. It acts as the enforcement mechanism for Throttle policies, rejecting requests until the timer expires.

Preconditions

  1. Action executed
  2. Rate limit policy

Postconditions

  1. Ready state restored after delay

Invariants

  1. Action blocked until T_last + Duration
  2. Timer is monotonic

Risks

Failure modes

  1. Deadlock

    Critical action needed during cooldown period, system stuck waiting.

Relationships

Builds on

References

Throttle

Rate-limiting to prevent resource exhaustion

Used by

Composes with

Society

StateLock

Atomic coordination via temporary state fusion

Reference

Parameters

duration Duration, [1s, 1h]
Mandatory wait period
reset_trigger Enum, {Success, Failure, Any}
What resets the cooldown

Identity

Ref
Cooldown#c288
Sema ID
sema:Cooldown#mh:SHA-256:c288d88055cb0aae80c4b67ed62afcd3ebcc5de18749fc6efb15e9f8c529b9df
Ring
0
Tier
1
Updated
2026-11-11
Supersedes
  • sema:Cooldown#mh:SHA-256:0cde8197149b258f1e6126f179b30468c12cb5e35352fcd0a8ae0bce0823c8ac
  • sema:Cooldown#mh:SHA-256:6f56ea214e52eab81c0592d4b17ed3da9dc6cbcf3a496a512088c9bc63006f3b
  • sema:Cooldown#mh:SHA-256:878c03997b0670f8f217d6f26b6d2a583d15bf11e702346b4e317827dc7cb687