File Emergency Stop • AI Agent SDK
FileEmergencyStop: Durable, fail-safe file-sentinel operator brake.
FileEmergencyStop
Defined in the protocols module.
AI Agent
Durable, fail-safe file-sentinel operator brake.
Engaging writes a small JSON sentinel at `path`; disengaging removes it. The engaged state therefore survives a crash/restart (durable) and is shared by every lane that consults the same path.
Fail-safe: any error reading the sentinel — a partially written file, corrupt JSON, a permission error — is treated as engaged. An ambiguous brake holds new work; it never silently falls open to “run freely”. The common, unambiguous case (sentinel simply absent) reports not-engaged.
Pure-stdlib (`os/json`): no new dependency, safe to live in core.
Constructor
strNo description available.
Methods
Instance method.
engage()Instance method.
disengage()Instance method.
state()Instance method.
Source
View on GitHubpraisonaiagents/gateway/protocols.py at line 8041