chore(release): verify integrated 1.16 queue

[jxnl]

Purpose

This PR consolidates the six independently reviewed and fully green 1.16 maintenance PRs into one integration merge while preserving their commit history.

Jason approved the fold-forward release history on 2026-08-09: standalone 1.15.5 will not be published, and its changelog will be folded into 1.16.0 by follow-up #2519. This PR lands the runtime, tests, dependency constraints, and contributor documentation; #2519 supplies the audited final 1.16 version metadata and changelog.

Components

• fix(validation): isolate llm validator prompt data #2511 - validator prompt-data isolation
• feat(retry): add cumulative token budgets #2512 - cumulative usage and retry budgets
• fix(mistral): support sdk v2 exports #2513 - Mistral SDK 2 compatibility
• fix(bedrock): parse reasoning-prefixed JSON #2514 - Bedrock reasoning-prefixed JSON
• feat(bedrock): add native structured outputs #2515 - Bedrock native structured outputs
• docs(contributing): align setup with uv workflow #2516 - contributor uv workflow docs

The branch starts from exact origin/main 1454af92b4012e679d8156ff4d16953301714e2e and applies those commits in that order. Conflict resolution was limited to additive changelog entries, preserving Mistral <3 with Bedrock boto3>=1.42.42, and retaining both Bedrock test groups.

Linked cleanup

Superseded source PRs closed: #2086, #2287, #2298, #2307, #2354, #2392.

Issues to close after this merge: #2056, #2076, #2084, #2365, #2391.

Held outside 1.16: provider additions #2283, #2306, #2322, #2384, #2423, #2435; architecture stack #2355-#2357; dependency batch #2433; mode policy #2394; memory/security product work #2321 and #2405; Bedrock auth #2409; product examples #2311 and #2468.

Validation

• focused combined regressions: 488 passed, 73 skipped
• exact GitHub core lane: 2076 passed, 148 skipped
• deterministic offline coverage: 764 passed, 92%
• full deterministic branch-coverage lane: 2964 passed, 199 skipped, 723 deselected; 99% with zero missing statements
• Ruff, format, full ty, uv lock --check, install/export checks, all pre-commit hooks, and git diff --check: pass
• clean MkDocs build: pass with three known Griffe warnings and unrelated stale anchors
• GitHub Ruff, ty, Test, and Release Readiness: fully green

No tag, GitHub release, PyPI publication, deployment, or social post is performed by this merge.

---

Note

Medium Risk
Touches core v2 retry/patch paths, Bedrock Converse request shapes, and validator prompt handling across providers; behavior is well-tested but spans security-sensitive validation and provider compatibility boundaries.

Overview
This merge folds six reviewed 1.16 maintenance PRs into one integration branch ahead of 1.16.0 metadata in follow-up work. Runtime and docs change; version/changelog publication stays separate.

Bedrock adds native Mode.JSON_SCHEMA and Mode.TOOLS_STRICT (Converse outputConfig / strict tools), recursive strict schema normalization, boto3 ≥1.42.42, and fixes for reasoning-prefixed JSON and non-mutating reask/message prep.

Retries introduce cumulative token_budget for structured non-streaming validation retries, completion:usage hooks, immutable usage snapshots on _total_usage, and TokenBudgetExceeded / TokenUsageUnavailableError when budgets cannot be enforced safely (xAI explicitly rejects token_budget).

Mistral loads mistralai.client.Mistral on 2.x (Python 3.10+) with 1.x fallback on 3.9; dependency range widens to mistralai<3.

Security: llm_validator sends rules and candidates as JSON with a fixed system instruction and raises ValueError instead of assertions.

Contributor/docs updates point repo links to 567-labs/instructor and standardize on uv sync / uv run workflows.

^{Reviewed by Cursor Bugbot for commit 0980b3d. 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	0980b3d	Commit Preview URL Branch Preview URL	Aug 08 2026, 08:26 PM

[jxnl]

Combined GitHub verification is complete at 0980b3da4e117a0977012cd52b00033be27c5d1e.

All workflows pass:

• Ruff
• ty
• Release Readiness, including artifact preparation and Python 3.9/3.13 wheel smokes; publication skipped
• Test, including Full Coverage, every Python 3.9-3.13 offline lane, Core Tests, all core provider groups, Auto Client, and every configured provider job

The umbrella remains draft and must not be merged while exact main at 1454af92 is still the unpublished 1.15.5 candidate.

[jxnl]

Versioned follow-up #2518 is now fully green at de3ceaf5. It declares 1.16.0, aligns distribution and runtime versions, strengthens release metadata validation, builds Twine-valid artifacts, passes clean Python 3.9/3.13 wheel smokes, and keeps publication skipped. #2518 remains stacked on this do-not-merge integration PR and assumes exact 1.15.5 is published first.

[jxnl]

Both version-sequencing paths are now prepared and independently validated: #2518 is the publish-1.15.5-first candidate, while #2519 folds the unpublished 1.15.5 payload into 1.16.0. Choose exactly one after explicit maintainer approval; neither draft publishes or merges anything by itself.

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{Bugbot Autofix is ON, but it could not run because the branch was deleted or merged before autofix could start.}

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

[cursor]

JSON schema skips reasoning strip

Medium Severity

Mode.JSON_SCHEMA validates the raw Bedrock text payload, while Mode.MD_JSON now runs the same text through extract_json_from_codeblock to take the final JSON after reasoning or <think> content. When a model returns thinking plus JSON in one text block, JSON schema parsing can fail or validate the wrong span even though MD JSON succeeds for the same response shape.

 

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