Skip to main content

Module handler

Module handler 

Source

Structs§

Handler
Core reactive messaging handler.
NameBindings
A block’s names, typed (identity M2, spec §4.4.2).
NudgeCounterState 🔒
Per-target-agent consecutive-nudge tracking for the Warden Supervisor guardrail. Keyed on the target agent’s lowercased name in Handler::nudge_counters.
RateLimiter 🔒
ReactiveHandler
Thread-safe wrapper around Handler.

Enums§

LookupOutcome
What a read-only name lookup found (identity M2) — see Handler::lookup_by_name.
TargetResolution 🔒
How inject_message_inner resolved its target (spec §4.4.3).
UnregisterOutcome
What a by-name unregister did (identity M2, spec §4.4.4 Q7). A name held by several live blocks is refused, never silently no-op’d as success.

Constants§

MAX_CONSECUTIVE_AUTO_CONTINUES 🔒
Max consecutive auto-continue nudges a Supervisor may send to the same target agent (within one registration / cooldown window) before record_supervisor_decision refuses and forces a decline instead. Bounds a runaway auto-continue loop — see docs/analysis/ANALYSIS_WARDEN_AUTO_CONTROLLER_CONTINUATION_WATCHER_2026_08_12.md.
NUDGE_COOLDOWN_RESET_MS 🔒
Gap since the last nudge after which the consecutive counter resets, on the theory that a long-idle target has effectively started a new work session even without a fresh registration_nonce.
NUDGE_MESSAGE 🔒
The one, fixed message a SupervisorAction::Nudge ever delivers. Deliberately not a parameter — see the doc on record_supervisor_decision’s Nudge arm for why a free-form message defeats the guardrail this exists for.

Statics§

GLOBAL_HANDLER 🔒
Global reactive handler singleton.

Functions§

describe_candidates 🔒
Human-readable candidate list for an ambiguity refusal — the §5.2 shape: enough for a model to retry by UID and for a human to act on.
get_global_handler
Get or initialize the global reactive handler.

Type Aliases§

NeedsReviewHook
See ReactiveHandler::add_needs_review_hook.