Emergency Stop Config • AI Agent SDK

EmergencyStopConfig: Configuration for the global operator emergency-stop brake (Issue #4220).

EmergencyStopConfig

Defined in the config module.

AI Agent

Configuration for the global operator emergency-stop brake (Issue #4220).

Selects the backend for the durable, fail-safe operator brake consulted at every new-work admission seam (WebSocket inbound, HTTP/MCP inbound, kanban dispatch, scheduler due-loop). The default `"off" backend engages a no-op brake so is_engaged() is always False — behaviour is byte-for-byte today's, no new dependency, no hot-path change. Selecting "file" persists the engaged state to a sentinel at path` so it survives a crash/restart and is shared across lanes; an unreadable/corrupt sentinel counts as engaged (fail-safe).

This maps onto the pure core :class:~praisonaiagents.gateway.protocols.EmergencyStopProtocol; :meth:to_estop builds the concrete brake.

Attributes: backend: `"off" (default, no-op) or "file" (durable sentinel). path: Sentinel location for the "file"` backend (required for it).

Properties

ResponseField str

No description available.

ResponseField Optional[str]

No description available.

Methods

enabled()

Whether a real (non-`off`) brake backend is selected.

to_estop()

Build the pure core emergency-stop brake this config describes.

Internal & Generic Methods

from_dict: Create from a parsed `gateway.control` mapping (tolerant of None).
to_dict: Convert to dictionary.

Source

View on GitHub

praisonaiagents/gateway/config.py at line 906

Emergency Stop Config • AI Agent SDK