# X_AGENT_DEADLINE

## Means

an agent ran past its declared deadline and was stopped

## Typical cause

an agent() declared `deadlineMs` and the run was still going when it elapsed: the model call in flight was aborted, each running tool's `ctx.signal` fired, and no further turn or tool was started. The run has no answer; tools that already ran keep their effects, and one that ignores its signal still finishes. Terminal: a job does not retry it

## Fix

`deadlineMs: 300_000` — on the agent, only once a trace shows the run converging; otherwise lower `maxTurns`, or shorten the slow tool the `agent.turn` span events name

[MCP and AI](/error-codes#mcp-and-ai)