Forge documentation
Release reference

Errors and failure handling

Find language-specific errors and preserve the operation outcome.

Forge errors are defined at the package boundary. Core model failures, tool validation or execution failures, identity errors, authorization denials and lifecycle errors are different outcomes.

Find the exact type

Handle outcomes

Propagate errors using the language's result, exception or error-return convention. Preserve cancellation. Do not retry non-idempotent tool effects automatically after an uncertain result. Record a provider refusal, tool denial and transport failure separately. A partial stream is not a complete successful response.

On this page