fix: finalize 1.15.5 correctness consolidation

[jxnl]

Included fixes

• Consolidates fix: add request timeouts to multimodal URL fetches #2507: adds the existing 30-second timeout to all remaining remote image, audio, and PDF fetches, with assertions for every changed request path.
• Consolidates fix(openai): route streaming retries through the streaming parser in TOOLS/JSON/MD_JSON #2508: keeps OpenAI TOOLS, JSON, JSON_SCHEMA, and MD_JSON retries on the streaming parser while consuming the one-shot model marker correctly.
• Consolidates fix(v2): parse PEP 604 unions in iterable streaming #2509: parses PEP 604 iterable unions member by member and keeps the regression suite collectable on Python 3.9.
• Makes contributor CI fork-safe by marking auto-client network tests and excluding llm tests from core, coverage, and release lanes.
• Moves these unreleased fixes into the still-unpublished 1.15.5 changelog section.

Superseded PRs/issues

• Supersedes fix: add request timeouts to multimodal URL fetches #2507, fix(openai): route streaming retries through the streaming parser in TOOLS/JSON/MD_JSON #2508, and fix(v2): parse PEP 604 unions in iterable streaming #2509 while preserving each contributor commit and authorship.
• docs: note OpenAI client base_url for multi-model gateways #2506 was closed separately as already consolidated by merged fix(release): finalize package metadata and gateway docs #2505.

Validation

• Focused regression suite: 224 passed, 1 skipped, 27 deselected
• Python 3.9 streaming compatibility: 11 passed, 1 skipped
• Exact guarded-release offline selection: 2020 passed, 144 skipped
• Release validator: 6 passed and generated 1.15.5 notes successfully
• Ruff check/format, source and test ty, uv lock --check, workflow YAML parse, pre-commit hooks, and git diff --check: passed

Skipped items

• Provider additions/upgrades, broad architecture/features, the 38-package dependency batch, security/product decisions, and substantial examples/docs remain open for dedicated review.
• No tag, GitHub release, PyPI publication, deployment, merge, or social post is performed by this PR.

---

Note

Medium Risk
Changes affect multimodal HTTP behavior, OpenAI streaming retry parsing, and iterable union validation on common response paths; risk is moderated by focused regression tests but still touches production parsing and network I/O.

Overview
This PR bundles unreleased 1.15.5 fixes: remote multimodal safety, OpenAI streaming retry parsing, iterable union streaming, and contributor CI that does not require provider secrets on fork PRs.

Remote multimodal fetches now pass a 30-second timeout on every requests.get / requests.head used to download or sniff image, audio, and PDF URLs across v2 core and OpenAI, Anthropic, and GenAI provider encoders, so hung hosts cannot block callers indefinitely.

OpenAI streaming retries route TOOLS, JSON, JSON_SCHEMA, and MD_JSON through a shared _should_parse_streaming check that still uses the streaming DSL parser when stream=True, even after the one-shot streaming model marker is consumed—so a corrected streamed retry can validate instead of falling back to one-shot parsing.

Iterable streaming treats PEP 604 unions (Weather | GoogleSearch, Iterable[Weather | GoogleSearch]) like typing.Union by validating each union member in extract_cls_task_type, with new streaming and prepare_response_model tests.

CI / changelog: Auto-client live network tests are marked llm and excluded from core, full coverage, and release pytest runs (-m 'not llm'); core tests no longer inject provider API keys into the environment. Changelog documents these items under 1.15.5 (dated 2026-08-07).

^{Reviewed by Cursor Bugbot for commit e92e3d6. Configure here.}

[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	e92e3d6	Commit Preview URL Branch Preview URL	Aug 08 2026, 12:54 AM