codex-agent-framework 0.1.19__tar.gz → 0.1.21__tar.gz

{codex_agent_framework-0.1.19 → codex_agent_framework-0.1.21}/CHANGELOG.md

@@ -4,6 +4,48 @@ All notable changes to this project will be documented in this file.
 
 This project loosely follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and uses semantic versioning where practical.
 
+## [0.1.21] - 2026-05-10
+### Added
+- Add the structured `AgentTurn` API: `agent(...)` and `AgentFuture.wait()` now return a turn object with `result`, `completed`, `reason`, `messages`, and `events`.
+- Add resumable non-terminal turns for `auto_proceed=False`; turns that need another model step pause with `reason="requires_next_step"` and continue through `agent.resume_turn(turn)`.
+- Add `agent.set_turn_result(data)` for tools/plugins that need to explicitly finish the current turn with a structured result.
+- Add the built-in `subagents` plugin with profile-based child agents, compact parent results, child-local `set_result`, `SubagentEvent` relay, and a packaged read-only `explorer` profile.
+- Add hierarchical `types` to messages and events while keeping `type` as the concrete computed type.
+- Add configurable `exclude_tools` matching by public or canonical plugin tool names.
+
+### Changed
+- Treat scheduled and post-restart wakeups as internal `DeveloperMessage` entries instead of user-authored messages.
+- Make `AssistantTurnEndEvent` expose a terminal `reason` rather than carrying a raw result payload.
+- Capture turn-local events and messages on `AgentTurn` so embedded callers can inspect what happened without replaying the whole session.
+- Include packaged subagent profile JSON files in distributions.
+- Refresh the packaged default system prompt around agent identity, clarification, durable fixes, and concise final reporting.
+
+### Fixed
+- Preserve coherent turn state across suspended/resumed turns, including stable turn IDs, non-terminal suspension without a turn-end event, and terminal completion on resume.
+
+### Tests
+- Validate the full suite at 483 passing tests.
+- Validate post-restart wakeups after a real server restart and smoke-test `auto_proceed=False` `AgentTurn` suspension/resume behavior.
+
+## [0.1.20] - 2026-05-09
+### Added
+- Make runtime plugins the single user-facing extension unit for tools, providers, commands, prompt sections, hooks, and events.
+- Add explicit `ToolsManager` and `ProvidersManager` ownership in `tool.py` and `provider.py`.
+
+### Changed
+- Move built-in tools and providers into built-in plugins so the core no longer special-cases `builtin_tools` or `builtin_providers` packages.
+- Keep SDK-style `agent.add_tool()` and `agent.add_provider()` while routing persistent runtime extensions through plugins.
+- Keep system-prompt templating on a small explicit namespace: `agent`, `os`, `runtime_join`, `root_join`, and `text_content`.
+- Refresh README extension, plugin, runtime, and project-layout documentation around the plugin-centric architecture.
+
+### Removed
+- Remove the old `RegistryManager` and `codex_agent/registry.py`.
+- Remove legacy direct runtime loading from `tools/` and `providers/` folders.
+- Remove the compatibility `codex_agent.builtin_tools` package, `codex_agent.builtin_providers` module, and related compatibility aliases.
+
+### Tests
+- Validate the full suite at 456 passing tests.
+
 ## [0.1.19] - 2026-05-08
 ### Changed
 - Compacting a session now purges compacted raw history from the active session file, keeping only the previous compaction anchor, the new compaction summary, and any unfinished remainder turn.