Worker Wedged Error • AI Agent SDK

WorkerWedgedError: Raised when a session's turn worker is wedged / unresponsive.

WorkerWedgedError

Defined in the protocols module.

Raised when a session’s turn worker is wedged / unresponsive.

Signals the gateway that the placement’s worker can no longer make progress (a wedged loop, an unresponsive subprocess/container, a lost remote worker). The gateway responds by tearing down only that placement (:meth:TurnExecutorProtocol.teardown) and re-placing the session, rather than the process-wide `os._exit` that a single shared loop forces today. Distinct from ordinary turn errors, which surface as the turn’s own exception and do not condemn the worker.

Source