Skip to main content

What’s Fixed

v2.4.1 is a corrective patch release for the v2.4.0 cleanup line. It restores out-of-the-box provider configuration discovery when Instructor packages are used from another project. The v2.4.0 config cleanup made preset lookup depend too much on the consumer application’s base path, which meant common calls such as Inference::using('openai'), LLMProvider::using('openai'), and StructuredOutput::using('openai') could fail outside the monorepo unless the consuming project copied Instructor’s package configuration files. This release makes bundled package presets discoverable from the installed package again.

Structured Output Dependency

twig/twig is now declared as a runtime dependency of cognesy/instructor-struct, not only as a development dependency. This fixes structured prompt rendering in standalone consumer installs.

Release Validation

The public API surface remains compatible with v2.4.0. The patch also stabilizes the public API and response-model regression fixtures across supported PHP and Symfony dependency combinations, so the full CI matrix now passes before publication.

Upgrade Notes

No code changes are required. Upgrade all Instructor packages together to v2.4.1.