> ## Documentation Index
> Fetch the complete documentation index at: https://docs.envole.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Error Handling

> Managing the primary error case: mixed abort states

## Primary Error: Mixed Abort States

The only specific error you need to handle when implementing Human-in-the-Loop approvals is attempting to mix `ABORTED_WITH_FEEDBACK` states with `APPROVED` or `DENIED` states in a single batch.

### Error Response

When you submit a batch with mixed abort states, you'll receive an error response through the normal agent response mechanism:

```json theme={null}
{
  "error": "Invalid approval batch: cannot mix ABORTED_WITH_FEEDBACK with other approval states",
  "batchId": "batch_456"
}
```

### Client-Side Prevention

The best approach is to prevent this error client-side through validation:

```typescript theme={null}
function validateBatchStates(decisions: Map<string, ApprovalState>): ValidationResult {
  const states = Array.from(decisions.values());
  const hasAbort = states.includes('ABORTED_WITH_FEEDBACK');
  const hasOtherStates = states.some(state => state !== 'ABORTED_WITH_FEEDBACK');
  
  if (hasAbort && hasOtherStates) {
    return {
      valid: false,
      error: 'Cannot mix ABORTED_WITH_FEEDBACK with APPROVED or DENIED states'
    };
  }
  
  return { valid: true };
}

function onSubmitBatch(batchId: string) {
  const decisions = getBatchDecisions(batchId);
  const validation = validateBatchStates(decisions);
  
  if (!validation.valid) {
    showError(validation.error);
    return;
  }
  
  submitBatch(batchId, decisions);
}
```

## Other Error Scenarios

All other error scenarios (network failures, missing fields, incomplete batches, etc.) are handled through the normal agent response system. The agent will communicate these errors to the user naturally through conversation rather than specific error codes.

### Network Connection Handling

For connection issues with the SSE stream, implement basic reconnection logic:

```typescript theme={null}
class ApprovalEventHandler {
  private eventSource: EventSource | null = null;
  private reconnectAttempts = 0;
  private maxReconnectAttempts = 3;
  
  connect(threadId: string) {
    this.eventSource = new EventSource(
      `${API_BASE_URL}/api/assistants/threads/${threadId}/stream`,
      { headers: { 'Authorization': `Bearer ${API_KEY}` } }
    );
    
    this.eventSource.onerror = () => {
      if (this.reconnectAttempts < this.maxReconnectAttempts) {
        this.reconnectAttempts++;
        setTimeout(() => this.connect(threadId), 1000 * this.reconnectAttempts);
      } else {
        showToast('Connection lost. Please refresh the page.', 'error');
      }
    };
    
    this.eventSource.onopen = () => {
      this.reconnectAttempts = 0;
    };
  }
}
```

## Next Steps

* See [Implementation Examples](/human-in-the-loop/examples/index) for complete error handling implementations
* Focus on client-side validation to prevent the mixed abort states error
* Let the agent handle all other error communication naturally