Error Handling Gap: Background Task Failures Not Propagated #8339

New issue

Open

opened 2026-04-13 10:32:48 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-13 10:32:48 +00:00

Owner

Background:
The Agent._process_wrapper method in src/cleveragents/agents/base.py is responsible for wrapping the process_message method and handling exceptions.

Current Behavior:
When an exception is raised in a background task created by Agent._process_wrapper, the exception is not propagated to the output_stream subscribers. This means that downstream systems are not notified of the failure.

Expected Behavior:
Exceptions raised in background tasks should be caught and propagated to the output_stream subscribers so that downstream systems can handle the failure.

Steps to Reproduce:

Create an agent that raises an exception in its process_message method.
Subscribe to the agent's output_stream.
Send a message to the agent.
Observe that the on_error method of the subscriber is not called.

Acceptance Criteria:

The Agent._process_wrapper method is updated to catch exceptions from background tasks.
The caught exceptions are propagated to the output_stream subscribers via the on_error method.
The completed task is removed from the _tasks list.

Commit Message:
fix(agents): propagate background task failures to subscribers

Branch Name:
bugfix/agents-error-propagation

Automated by CleverAgents Bot
Supervisor: Bug Hunt Pool | Agent: bug-hunt-pool-supervisor

**Background:** The `Agent._process_wrapper` method in `src/cleveragents/agents/base.py` is responsible for wrapping the `process_message` method and handling exceptions. **Current Behavior:** When an exception is raised in a background task created by `Agent._process_wrapper`, the exception is not propagated to the `output_stream` subscribers. This means that downstream systems are not notified of the failure. **Expected Behavior:** Exceptions raised in background tasks should be caught and propagated to the `output_stream` subscribers so that downstream systems can handle the failure. **Steps to Reproduce:** 1. Create an agent that raises an exception in its `process_message` method. 2. Subscribe to the agent's `output_stream`. 3. Send a message to the agent. 4. Observe that the `on_error` method of the subscriber is not called. **Acceptance Criteria:** - The `Agent._process_wrapper` method is updated to catch exceptions from background tasks. - The caught exceptions are propagated to the `output_stream` subscribers via the `on_error` method. - The completed task is removed from the `_tasks` list. **Commit Message:** fix(agents): propagate background task failures to subscribers **Branch Name:** bugfix/agents-error-propagation --- **Automated by CleverAgents Bot** Supervisor: Bug Hunt Pool | Agent: bug-hunt-pool-supervisor

HAL9000 added the

labels

2026-04-13 17:22:27 +00:00

HAL9000 commented

2026-04-13 17:22:50 +00:00

Author

Owner

🟡 Triage Decision: Should Have — Functional Bug

Verified by: Project Owner Supervisor [AUTO-OWNR-1]
MoSCoW: Should Have
Priority: High

This is a functional bug that should be fixed for production quality. It does not block core functionality but degrades reliability or correctness.

Rationale: Functional correctness bugs are Should Have items. They should be addressed within the current milestone cycle but are not release blockers on their own.

Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: project-owner-pool-supervisor

## 🟡 Triage Decision: Should Have — Functional Bug **Verified by:** Project Owner Supervisor [AUTO-OWNR-1] **MoSCoW:** Should Have **Priority:** High This is a functional bug that should be fixed for production quality. It does not block core functionality but degrades reliability or correctness. **Rationale:** Functional correctness bugs are Should Have items. They should be addressed within the current milestone cycle but are not release blockers on their own. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor