vstorm-co / subagents-pydantic-ai / 31965355526

100%

push

github

feat: carry the exception behind a handle's error text (#80)

## What

`TaskHandle.exception` carries the underlying exception wherever `error`
embeds an exception's own text: a contained crash, an exhausted retry
budget, a usage limit in both dispatch modes, a propagated crash with
`contain_errors=False`, and each transient retry. `finish()` takes it as
a keyword and sets it unconditionally on the winning terminal
transition, so a completion clears whatever the retry recorder left
behind.

## Why

A host cannot safely render `error`: the embedded text is whatever the
delegate's model client raised, and a provider error routinely carries
the failing request URL — key included — for a profile on a custom
`base_url`. Until now the host's options were parsing the library's
formatted string or surfacing it verbatim (vstorm-co/agenticos#699 is
the second one happening). With the exception on the handle, the host
reads the class, composes its own sentence, and logs the original.

## Verification

- `make lint`, `make typecheck-both` (pyright + mypy strict) clean.
- 1186 tests, 100% branch coverage: identity assertions on every listed
site, plus the clearing behaviour on both eventual-success retry paths.
- `mkdocs build --strict` clean (`docs/concepts/types.md` gained the
field).

Ships as 0.2.19.

10 of 10 new or added lines in 2 files covered. (100.0%)

1598 of 1598 relevant lines covered (100.0%)

1.0 hits per line