Includes the fixes previously planned for 1.16.1, which was not published. The previous published version is 1.16.0. Upgrade Notes Cached responses use new keys and isolated per-client namespaces. Existing cache entries will miss. Set the same explicit cache_namespace only when clients are intended to share results; keep accounts, endpoints, and tenants isolated. Response models with Instructor as…
Added Bedrock native structured outputs: Add explicit Mode.JSON_SCHEMA and Mode.TOOLS_STRICT support through Converse outputConfig.textFormat and strict tool schemas, with recursive schema normalization and a boto3 1.42.42 minimum. Model selection remains caller-controlled. (#2515, #2084, #2086) Validation retry budgets: Add positive cumulative token_budget limits for structured non-streaming retr…
What's Changed Instructor 1.15.4 is a patch release that consolidates the latest small fixes and docs cleanup after 1.15.3. Runtime Fixes Fixed v2 response-model preparation so list and primitive response models are normalized before provider handler dispatch. This fixes crashes such as AttributeError: type object 'list' has no attribute 'model_json_schema' for list[Model] and scalar response mode…
What's Changed fix(templating): skip non-text Parts in GENAI/VertexAI mode by @jxnl in #2259 chore(deps): bump the poetry group across 1 directory with 6 updates by @dependabot[bot] in #2258 fix: preserve descriptions in responses tools mode by @jxnl in #2261 test: cover partial streaming for PEP 604 unions by @jxnl in #2262 build(docs): use uv for pages deploy by @jxnl in #2266 fix(streaming): su…
Security Bedrock: Block remote HTTP(S) image URL fetching in _openai_image_part_to_bedrock — only data: URLs accepted, preventing SSRF via user-controlled image URLs Bedrock/PDF: Block remote URL and local file fetching in PDF.to_bedrock — only base64 data or s3:// sources supported, preventing SSRF and local file disclosure Added Hooks: completion:error and completion:last_attempt handlers now re…
What's Changed Validation: Fix Validator to require is_valid field (#2230) Gemini: Handle GEMINI_TOOLS in async streaming paths (#2135) CLI: Add --full-id flag to show complete batch IDs (#2068) Providers: Remove opinionated system prompt from JSON mode (#2069) Mode: Add missing GENAI and Responses modes to tool_modes() (#2072) xAI: Make xai-sdk optional at runtime (#2043, #2094) Docs: Add canonic…
Changes fix(metadata): populate author field for PyPI stats Separate author names from emails so hatchling populates the Author metadata field correctly. pypistats.org reads this field and was showing "None" because the names were only in author_email.
What's Changed refactor(json_tracker): simplify using sibling heuristic by @thomasnormal in #2000 Responses API validation error by @jxnl in #2002 GenAI config labels loss by @jxnl in #2005 GenAI SafetySettings image content by @jxnl in #2007 List object crashes fix by @jxnl in #2011 New release preparation by @jxnl in #2013 Full Changelog: v1.14.3...v1.14.4
Added Completeness-based validation for Partial streaming - only validates JSON structures that are structurally complete (#1999) New JsonCompleteness class in instructor/dsl/json_tracker.py for tracking JSON completeness during streaming (#1999) Fixed Fixed Stream objects crashing reask handlers when using streaming with max_retries > 1 (#1992) Field constraints (min_length, max_length, ge, le, e…
Fixed Fixed model validators crashing during partial streaming by skipping them until streaming completes (#1994) Fixed infinite recursion with self-referential models in Partial (e.g., TreeNode with children: List["TreeNode"]) (#1997) Added Added PartialLiteralMixin documentation for handling Literal/Enum types during streaming (#1994) Added final validation against original model after streaming…
What's Changed fix(genai): Support cached_content for Google context caching by @b-antosik-marcura in #1987 New Contributors @b-antosik-marcura made their first contribution in #1987 Full Changelog: v1.14.0...v1.14.1
What's Changed Audit and standardize exception handling in instructor library by @jxnl in #1897 Standardize provider imports in documentation by @jxnl in #1896 Fix the issue by @jxnl in #1914 Standardize provider factory methods in codebase by @jxnl in #1898 Update image base URL in ipnb tutorials by @jxnl in #1922 docs: comprehensive documentation audit and SEO optimization by @jxnl in #1944 Upda…