Rawresponse attribute error fix

[jxnl]

fix: Prevent AttributeError for List[Object] extractions

Describe your changes

This change resolves an AttributeError: 'list' object has no attribute 'rawresponse' that occurred when performing batch extractions (e.g., List[Object]). Previously, process_response would return a plain Python list for IterableBase and ParallelBase models, which could not store the _raw_response attribute expected by create_with_completion().

The fix introduces a new ListResponse class, a list subclass that can hold the _raw_response metadata. process_response and process_response_async are updated to return ListResponse for list-like outputs. Additionally, prepare_response_model now correctly handles List[T] and Iterable[T] (where T is a BaseModel) before simple type detection, ensuring they are properly wrapped as IterableModel.

Issue ticket number and link

Linear: 567-266
GitHub: instructor/issues/1303
Related PR: instructor/pull/1870

Checklist before requesting a review

• I have performed a self-review of my code
• If it is a core feature, I have added thorough tests.
• If it is a core feature, I have added documentation.

---

Linear Issue: 567-266

 

[cursor]

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
_{Learn more about Cursor Agents}

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	instructor	86278f6	Commit Preview URL Branch Preview URL	Jan 16 2026, 05:32 PM