1 Commits
Author SHA1 Message Date
459a12a656 feat: implement real-time message steering for agents during execution (#1802)
* feat: implement real-time message steering for agents during execution

- Add MessageSteeringProtocol and AgentSteeringProtocol following protocol-driven architecture
- Implement MessageSteering class with priority-based message queuing
- Add SteeringMixin to Agent class with message_steering parameter
- Integrate steering checks into execution flow and tool execution
- Support mid-execution guidance with priority levels (normal, high, urgent, interrupt)
- Maintains backward compatibility with existing Agent API
- Zero overhead when message_steering=False (default)

Fixes #1799

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: praisonai-triage-agent[bot] <praisonai-triage-agent[bot]@users.noreply.github.com>

* fix: address critical bugs in message steering implementation

- Fix INTERRUPT detection in tool_execution.py (was using broken substring check)
- Fix rate limiter blocking urgent messages during tool execution
- Add INTERRUPT priority bypass in message queue (URGENT.value + 1)
- Add proper error handling in execution_mixin.py with graceful degradation
- Extend MessageSteeringProtocol with enabled property for contract compliance
- Move test file to proper tests/integration/ directory structure
- Add mandatory live agentic test with real LLM execution
- Improve prompt formatting with clear separators

Fixes critical bugs identified by Greptile, CodeRabbit reviewers.
All changes maintain backward compatibility.

Co-authored-by: Mervin Praison <[email protected]>

* fix: comprehensive message steering improvements

- Wire steering in ALL execution paths (run, chat, achat, streaming)
- Move protocols to agent/protocols.py per AGENTS.md convention
- Remove duplicate test file and enhance live test with actual validation
- Fix INTERRUPT marker mismatch between tool_execution and SteeringMixin
- Improve priority handling with distinct INTERRUPT formatting

Co-authored-by: Mervin Praison <[email protected]>

* feat: add CLI/YAML parity and examples for message steering

- Add --message-steering CLI flag support in wrapper package
- Add YAML agent config mapping (message_steering: true)
- Create comprehensive Python example showing all usage patterns
- Create YAML configuration example
- Implements AGENTS.md §7 requirement (Python + CLI + YAML support)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Claude <[email protected]>

---------

Co-authored-by: praisonai-triage-agent[bot] <272766704+praisonai-triage-agent[bot]@users.noreply.github.com>
Co-authored-by: praisonai-triage-agent[bot] <praisonai-triage-agent[bot]@users.noreply.github.com>
Co-authored-by: Mervin Praison <[email protected]>
Co-authored-by: Claude <[email protected]>
2026-06-12 21:05:11 +01:00