Changelog¶

All notable changes to this project will be documented in this file.

This changelog is automatically generated by release-please.

0.3.5 (2026-01-28)¶

Bug Fixes¶

• api: propagate runner app_name to AgentExecutor (#240) (aa1102b), closes #239

0.3.4 (2026-01-27)¶

Features¶

• api: add multimodal input support for video files (#236) (d5f092e)

0.3.3 (2026-01-25)¶

Features¶

• api: add App/Runner pattern for evolution infrastructure integration (#232) (4ab4186)
• api: expose session_service parameter (#229) (0a7d64f)

Documentation¶

• audit static documentation for accuracy and consistency (#233) (3404b56)
• concepts: fix import paths and model patterns in code examples (3404b56)
• guides: rewrite single-agent, multi-agent, critic-agents, (3404b56)
• reference: fix StateGuard link path (3404b56)

0.3.2 (2026-01-24)¶

Features¶

• api: add round_robin flag to evolve_workflow() (#225) (7c97025), closes #214
• schema: add schema constraints for output schema evolution (#208) (505b2ab), closes #190
• workflow: preserve structure during evolution (#228) (62a210c)

Bug Fixes¶

• executor: add get-or-create session semantics (#222) (cb19b13)
• utils: return LAST final response in extract_final_output (#223) (25703f4)

Documentation¶

• concepts: add Diátaxis explanation section (#221) (643467d)

0.3.1 (2026-01-22)¶

Features¶

• engine: integrate stop_callbacks into AsyncGEPAEngine (#196) (#206) (50488e6)
• ports: add StopperProtocol for pluggable stop conditions (#198) (6a0c160)
• stoppers: add MaxEvaluationsStopper and FileStopper (#207) (86fcba7), closes #197
• stoppers: add SignalStopper for graceful Ctrl+C termination (#204) (2727d49), closes #194
• stoppers: implement CompositeStopper for combining stop conditions (#205) (f188ba9)
• stoppers: implement ScoreThresholdStopper (#203) (74c4be2)
• stoppers: implement TimeoutStopper (#192) (#200) (f44f605)

Bug Fixes¶

• tests: rename mock_ fixtures to test_ in multi-agent routing (#202) (9e1315a)

0.3.0 (2026-01-22)¶

⚠ BREAKING CHANGES¶

• adapter: evolve_group() now requires agents as dict[str, LlmAgent] instead of list[LlmAgent]. The evolved_components dict now uses qualified names (agent.component) instead of just agent names.

Features¶

• adapter: add per-agent component routing for multi-agent evolution (#178) (50bb4f3)
• adapter: implement per-agent trajectory extraction from SequentialAgent events (#187) (6a7b419), closes #46
• types: add multi-agent component addressing scheme (#176) (51a4469), closes #165

Bug Fixes¶

• adapter: wrap exceptions in EvaluationError per ADR-009 (#189) (10d0995)
• api: use component handlers for seed candidate building (#182) (ee01d04)
• api: wrap reflection_model with LiteLlm for non-native providers (#185) (6674885), closes #173
• tests: update assertions to use qualified component names (6674885)

Documentation¶

• adapter: clarify _build_pipeline execution flow (#183) (ac3317a)
• guides: add migration guide for multi-agent v0.3 API (50bb4f3)
• readme: streamline for lowest-friction usage (50bb4f3)

0.2.2 (2026-01-21)¶

Features¶

• handlers: add ComponentHandler protocol and registry for component management (#170) (bdd8489)
• handlers: add generate_content_config evolution support (#175) (e2472ac)
• reflection: add component-aware reflection with schema validation (#167) (31dd288), closes #83 #133
• utils: add validate_output_schema tool for reflection agents (31dd288)

Code Refactoring¶

• adapters: use ComponentHandler registry for candidate application (#174) (ebf219f)

Documentation¶

• guides: add schema evolution section to single-agent guide (31dd288)

0.2.1 (2026-01-20)¶

Features¶

• adapter: add unified AgentExecutor for consistent session management (#138) (bfa1fae)
• adapter: add unified executor to MultiAgentAdapter and evolve_group (#139) (8b042fb)
• adapters: standardize critic feedback schema with normalization (#160) (32e43e7), closes #141
• models: add evolved_components dictionary for multi-component tracking (#142) (a4eee45)
• schema: enable output_schema evolution as a component (#132) (9bfd3e3), closes #83
• tests: enhance contract tests for evolve_group() executor creation and logging (96faaef)

Bug Fixes¶

• api: wrap reflection model in LiteLlm for consistency (32e43e7)
• logging: standardize logger initialization to use name (#149) (1762b71)
• publish: update attestations action to use 'paths' instead of 'attestations' (aaf09d2)
• reflection: use REFLECTION_INSTRUCTION as default fallback (#158) (995287a)
• utils: add cross-platform encoding support for Windows consoles (#130) (75430c6)

Code Refactoring¶

• adapter: remove legacy execution paths and require AgentExecutor (#145) (9b8ebd9)
• reflection: deprecate direct LiteLLM reflection in favor of ADK agents (#151) (97b3819), closes #144
• reflection: remove deprecated LiteLLM reflection path (#156) (a4ef3cb)
• tests: consolidate MockAdapter variants into factory pattern (#153) (d4d4fc1), closes #147
• tests: consolidate MockScorer into shared fixture (#152) (af46a5c), closes #146
• tests: improve error message clarity in ADKAdapter reflection tests (5e2bb2a)
• trial-builder: consolidate trial-building logic into shared TrialBuilder class (#154) (a6567ef)

Documentation¶

• adr: document shared test utilities in ADR-005 (af46a5c)
• guides: add output schema evolution section to single-agent guide (9bfd3e3)

0.2.0 (2026-01-18)¶

⚠ BREAKING CHANGES¶

• engine: IterationRecord.instruction → component_text, EvolutionResult.evolved_instruction → evolved_component_text, MultiAgentEvolutionResult.evolved_instructions → evolved_components

Features¶

• docs: integrate mkdocs-ezglossary for cross-referenced glossary (#123) (8f01dac), closes #114
• engine: add ADK session state template substitution (#115) (d738b51)
• reflection: add ADK session state management for reflection agent (#128) (39baef5), closes #100

Bug Fixes¶

• tests: improve pytest marker and skip logic for external service tests (#126) (0b75304)

Code Refactoring¶

• api: fix line-too-long lint errors (055c8db)
• ci: replace deprecation detection workflow with pytest filterwarnings (#122) (b28cb17), closes #98
• docstrings: improve Note section clarity in changed files (d738b51)
• tests: clean up conftest.py warning handling (b28cb17)

Documentation¶

• contributing: add deprecation warning handling section (b28cb17)
• glossary: add ADK integration concepts and terminology scope (39baef5)
• index: add GEPA paper reference (8f01dac)
• reference: add glossary for terminology consistency (d738b51)
• security: add SECURITY.md (055c8db)

0.1.2 (2026-01-18)¶

Features¶

• engine: add ADK reflection agents with component_text/trials terminology (#101) (567a4ff)

Documentation¶

• update PR template to clarify scope formatting guidelines (116d8af)

0.1.1 (2026-01-17)¶

Features¶

• 032-reflection-prompt-config: add reflection_prompt configuration (#93) (ef9b369)
• adapters: wire reflection_model config to proposer (#92) (85eafbd)
• add changelog sections to release-please config (43326cd)
• add project management workflow documentation (a31ef68)
• ci: add maintainer guidance to issue templates (#91) (f92bcae)
• ci: add release-please for automated releases and changelogs (3c49646)
• utils: add shared extract_final_output utility for ADK event extraction (#96) (7f1d341)

Bug Fixes¶

• ensure 'include-component-in-tag' is set to false in release-please config (5760099)

[Unreleased]¶

See GitHub Releases for the latest changes.