3.1.0b1

What's Changed

This is a pre-release for 3.1.0.

Add tutorial for dspy-trusted-monitor using GEPA by @ZachParent in https://github.com/stanfordnlp/dspy/pull/8938
Update gepa[dspy] dependency version to 0.0.18 by @LakshyAAAgrawal in https://github.com/stanfordnlp/dspy/pull/8969
fix(MIPROv2): zero shot not taking .compile parameters into account before determining if the program was zero shot by @isaacbmiller in https://github.com/stanfordnlp/dspy/pull/8909
Update gepa[dspy] dependency version to 0.0.22 by @LakshyAAAgrawal in https://github.com/stanfordnlp/dspy/pull/9042
[docs] Add GEPA gepa_kwargs documentation by @GabrielLoiseau in https://github.com/stanfordnlp/dspy/pull/8998
Update optimizer overview to include the description of SIMBA by @TomeHirata in https://github.com/stanfordnlp/dspy/pull/9026
Enable callback logging only for full eval on GEPA by @TomeHirata in https://github.com/stanfordnlp/dspy/pull/9050
Update Arbor Tutorials by @Ziems in https://github.com/stanfordnlp/dspy/pull/9007
Update RL Tutorial by @Ziems in https://github.com/stanfordnlp/dspy/pull/9008

Add Disable Fallback Option in ChatAdapter by @Ziems in https://github.com/stanfordnlp/dspy/pull/8984
Add a method to extract system message based on adapter and signature by @chenmoneygithub in https://github.com/stanfordnlp/dspy/pull/9006
feat(File): add File type for handling file data by @TomeHirata in https://github.com/stanfordnlp/dspy/pull/9014
Allow stream listener to work on any type by @chenmoneygithub in https://github.com/stanfordnlp/dspy/pull/8833
fix(audio): Normalize 'x-wav' audio format to 'wav' by @akshatvishu in https://github.com/stanfordnlp/dspy/pull/9017
Support Python 3.14 by @TomeHirata in https://github.com/stanfordnlp/dspy/pull/9041
Introduce dspy.Reasoning to capture native reasoning from reasoning models by @chenmoneygithub in https://github.com/stanfordnlp/dspy/pull/8986

Add guards against loading pkl files by @isaacbmiller in https://github.com/stanfordnlp/dspy/pull/9048
Add param to load_memory_cache to stop pkl files without explicit loading by @isaacbmiller in https://github.com/stanfordnlp/dspy/pull/9055

Fix TypeError when tracking usage with Anthropic models returning Pydantic objects by @Copilot in https://github.com/stanfordnlp/dspy/pull/8978
Update old Anthropic model names by @TomeHirata in https://github.com/stanfordnlp/dspy/pull/8992
fix(XMLAdapter): Implement user message formatting by @BenMcH in https://github.com/stanfordnlp/dspy/pull/9003
Fix content input conversion for OpenAI Responses API by @Copilot in https://github.com/stanfordnlp/dspy/pull/8993
Refactor: update type hints for adapter and LM methods by @TomeHirata in https://github.com/stanfordnlp/dspy/pull/9025
fix(dspy): exclude gpt-5-chat from reasoning model classification by @mindful-time in https://github.com/stanfordnlp/dspy/pull/9033
fix(dspy): Example.toDict() fails to serialize dspy.History objects by @Copilot in https://github.com/stanfordnlp/dspy/pull/9047
Some continuous format fix by @chenmoneygithub in https://github.com/stanfordnlp/dspy/pull/8987

Add documentation for provider-side prompt caching with Anthropic and OpenAI by @Copilot in https://github.com/stanfordnlp/dspy/pull/8970
[docs] Add Google-style docstrings for dspy/evaluate/metrics.py by @eramis73 in https://github.com/stanfordnlp/dspy/pull/8954
fix: broken PyPI downloads badge from pepy.tech in README and docs home page by @dushmanta05 in https://github.com/stanfordnlp/dspy/pull/8995
Document ToolCall.execute() availability from dspy 3.0.4b2 by @Copilot in https://github.com/stanfordnlp/dspy/pull/9004
fix(docs): add python language id to code block by @Ahmad8864 in https://github.com/stanfordnlp/dspy/pull/9023
docs: add note on Python version for pre-commit by @akshatvishu in https://github.com/stanfordnlp/dspy/pull/9028
chore(docs): update dspy.settings.configure and dspy.settings.context to dspy.configure and dspy.context by @isaacbmiller in https://github.com/stanfordnlp/dspy/pull/9060
docs: add documentation for async tool usage and error handling by @TomeHirata in https://github.com/stanfordnlp/dspy/pull/9054

Remove unused notebook python file by @TomeHirata in https://github.com/stanfordnlp/dspy/pull/8971
Cache Ollama to speed up CI by @TomeHirata in https://github.com/stanfordnlp/dspy/pull/8972
Clean out unused deps by @isaacbmiller in https://github.com/stanfordnlp/dspy/pull/8968
docs: add note on Python version for pre-commit by @akshatvishu in https://github.com/stanfordnlp/dspy/pull/9028
Bump DSPy version by @chenmoneygithub in https://github.com/stanfordnlp/dspy/pull/9061

@ZachParent made their first contribution in https://github.com/stanfordnlp/dspy/pull/8938
@eramis73 made their first contribution in https://github.com/stanfordnlp/dspy/pull/8954
@dushmanta05 made their first contribution in https://github.com/stanfordnlp/dspy/pull/8995
@akshatvishu made their first contribution in https://github.com/stanfordnlp/dspy/pull/9017
@mindful-time made their first contribution in https://github.com/stanfordnlp/dspy/pull/9033
@GabrielLoiseau made their first contribution in https://github.com/stanfordnlp/dspy/pull/8998
@Ahmad8864 made their first contribution in https://github.com/stanfordnlp/dspy/pull/9023

Full Changelog: https://github.com/stanfordnlp/dspy/compare/3.0.4...3.1.0b1