Errors¶

AlpineAgentsError ¶

Bases: Exception

Common parent of the errors alpineagents raises itself.

The model API failed even after SDK retries. The original SDK exception is in __cause__.

The provider's rate limit (429).

The context is larger than the model's context window. Add a compaction block such as compact_if_full to the loop.

Authentication failed (missing API key, wrong key, no permission).

agent.ask(returns=...) did not get a well-formed answer, even after asking again.

The last validation error is in __cause__.

ask_human was called on an Agent with human=None.

Could not connect to an MCP server, or the connection was lost. The original exception is in __cause__.

Errors the server reports for a tool call (isError) go to the model as the result instead.