git:20260215.dd8de30 to git:20260716.7d6abf5

# CLAUDE.md - Team Human-in-the-Loop Cookbook

Instructions for Claude Code when testing the Team HITL cookbooks.

---

## Quick Reference

**Test Environment:**

```bash

# Virtual environment with all dependencies

.venvs/demo/bin/python

```

**Run a cookbook:**

```bash

.venvs/demo/bin/python cookbook/03_teams/20_human_in_the_loop/confirmation_required.py

.venvs/demo/bin/python cookbook/03_teams/20_human_in_the_loop/external_tool_execution.py

.venvs/demo/bin/python cookbook/03_teams/20_human_in_the_loop/user_input_required.py

```

**Test results file:**

```

cookbook/03_teams/20_human_in_the_loop/TEST_LOG.md

```

---

## Testing Workflow

### 1. Before Testing

- Ensure the virtual environment exists (run `./scripts/demo_setup.sh` if needed)

- Set `OPENAI_API_KEY` environment variable

### 2. Running Tests

Each script is interactive and requires terminal input:

- **confirmation_required.py** -- Prompts y/n to approve/deny a weather lookup

- **external_tool_execution.py** -- Prompts for the result of an external email send

- **user_input_required.py** -- Prompts for destination and budget values

### 3. Expected Behavior

All three examples follow the same pattern:

1. Team delegates task to a member agent

2. Member encounters a HITL tool and pauses

3. Pause propagates to the team level with member context

4. User resolves the requirement (confirm/reject, provide input, or provide result)

5. `team.continue_run()` routes the resolution back to the member and completes

### 4. Known Issues

- These examples use SQLite (`tmp/team_hitl.db`) for session persistence

- The `tmp/` directory must be writable (created automatically)

---

## Code Locations

| What | Where |

|------|-------|

| RunRequirement | `libs/agno/agno/run/requirement.py` |

| Team HITL pause handlers | `libs/agno/agno/team/_hooks.py` |

| Team continue_run dispatch | `libs/agno/agno/team/_run.py` |

| Member pause propagation | `libs/agno/agno/team/_tools.py` |

| Integration tests | `libs/agno/tests/integration/teams/human_in_the_loop/` |