chore: Move HITL to underneath the Hooks module

[sjrl]

Related Issues

• fixes something I discussed with @julian-risch and @anakin87 about moving the Human in the Loop module to live inside of the Hooks module alongside the other pre-built Tool Result Offloading hook.

Proposed Changes:

• Move the HITL module to underneath the Hooks module.
• Update tests, reno to indicate the new import path, and the MIGRATION guide
• Update docs to reflect the new structure

How did you test it?

Existing tests

Notes for the reviewer

Checklist

• I have read the contributors guidelines and the code of conduct.
• I have updated the related issue with new insights and changes.
• I have added unit tests and updated the docstrings.
• I've used one of the conventional commit types for my PR title: fix:, feat:, build:, chore:, ci:, docs:, style:, refactor:, perf:, test: and added ! in case the PR includes breaking changes.
• I have documented my code.
• I have added a release note file, following the contributors guidelines.
• I have run pre-commit hooks and fixed any issue.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
haystack-docs	Ignored	Preview	Jul 13, 2026 9:03am

[anakin87]

Thank you!

The OpenAI fix is in #11978

[github-actions]

Coverage report

Click to see where and how coverage changed

File	Statements	Missing	Coverage	Coverage (new stmts)	Lines missing
haystack/hooks/human_in_the_loop
hooks.py
policies.py
strategies.py
user_interfaces.py
haystack/hooks/human_in_the_loop/types
protocol.py
Project Total

This report was generated by python-coverage-comment-action