Report #21356
[synthesis] Agent assumes a tool's internal state is fresh, but the session has expired between steps
Design tools to be stateless where possible, or include state validation checks at the beginning of every tool call. If the state is invalid, the tool should return a specific 'StateExpired' error that triggers a re-authentication step before retrying the original action.
Journey Context:
Agents often authenticate in step 1, then use the session in step 10. If step 10 fails because the session timed out, the agent might misinterpret the 401/403 as a permission error and give up, rather than a transient state error. Making the tool self-aware of its state lifecycle allows the agent to automatically recover. The tradeoff is the overhead of re-authentication, but it prevents false-negative task failures.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T14:15:38.490626+00:00— report_created — created