Experimental/1.2.0

[jolovicdev]

Summary

Major release with swarm mode, typed events, structured output improvements, and significant refactor of the orchestration layer.

Changes

New Features

• Swarm mode handoff tool - transfer_to_agent_tool() enables dynamic agent-to-agent transfers with context passing in Workforce swarm mode
• EventType enum - Typed event constants for IDE autocomplete and type safety (EventType.RUN_STARTED, EventType.TOOL_COMPLETED, etc.)
• Structured output fallback chain - Graceful degradation from json_schema → json_object → tools for providers with varying capabilities

Bug Fixes

• LiteLLM event loop lifecycle - Fixes "coroutine 'Logging.async_success_handler' was never awaited" warning by properly draining orphaned coroutines when event loops change
• Provider compatibility - Automatic detection and fallback for providers that don't support json_schema response format (e.g., DeepSeek)

Refactor

• Simplified worker and workforce orchestration (~1200 lines reduced)
• Cleaner separation between runner logic and coordination
• Improved RunConfig handling with proper deep copying for overrides

Documentation

• New docs/tutorials.md with tested examples
• Updated all core docs for EventType, RunConfig, swarm mode, handoff, and context compaction
• Added MkDocs llmstxt plugin integration for LLM-friendly docs

Examples

• Updated coding_agent example with --prompt, --swarm, --no-stream flags
• Demonstrates EventType usage, handoff handling, and non-interactive mode

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d2ccc533cb

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Preserve swarm history when handing off between workers

This path returns only the most recent worker report, so any earlier swarm legs are discarded after a handoff chain. In a run like A -> B where A executes tools before transferring, the final report from B no longer contains A's tool_calls, metrics, or errors, which makes completed runs look incomplete and can hide failed tool executions in earlier legs. The same overwrite pattern is also present in _aresume_swarm_stage.

Useful? React with 👍 / 👎.