title: 'v2.4.1'
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.