feat: add Presidio integration for PII detection and anonymization

[SyedShahmeerAli12]

Closes #3063

What this adds

Three new Haystack components using Microsoft Presidio:

• PresidioDocumentCleaner — anonymizes PII in list[Document], returns new Documents without mutating inputs
• PresidioTextCleaner — anonymizes PII in list[str], useful for sanitizing user queries before LLM calls
• PresidioEntityExtractor — detects PII entities and stores them in Document metadata under the "entities" key

Usage example

from haystack_integrations.components.preprocessors.presidio import PresidioDocumentCleaner
from haystack import Document

cleaner = PresidioDocumentCleaner()

result = cleaner.run(
    documents=[Document(content="My name is shahhmeer, email: ashahmeer73@gmail.com")]
)

# → "My name is <PERSON>, email: <EMAIL_ADDRESS>"

[sjrl]

@SyedShahmeerAli12 thanks for contributing! Please read the contribution guidelines here https://github.com/deepset-ai/haystack-core-integrations/blob/main/CONTRIBUTING.md#create-a-new-integration and run the scaffolding script to help fill in some missing aspects of your contribution.

Also make sure to run the linter and the tests

[SyedShahmeerAli12]

▎ Hello @sjrl I've implemented all three components proposed in this issue:

PresidioDocumentCleaner : anonymizes PII in list[Document]
PresidioTextCleaner : anonymizes PII in list[str] for query sanitization
PresidioEntityExtractor : detects PII entities and stores them in Document metadata

All CI checks are passing. Happy to make any changes based on your feedback

[sjrl]

@SyedShahmeerAli12 a few more high-level comments before I do an indepth review:

• Please add a new entry in .github/labeler.yml
• We recently add code coverage support so please add a new entry in .github/workflows/CI_coverage_comment.yml
• Add the new integration to the table in the root README.md https://github.com/deepset-ai/haystack-core-integrations/blob/main/README.md

[SyedShahmeerAli12]

Addressed all comments removed the ## Contributing header from README to match the pgvector format, fixed alphabetical ordering in both the root README table and CI_coverage_comment.yml. Python 3.14 was already in place.

[SyedShahmeerAli12]

• warm_up() — AnalyzerEngine/AnonymizerEngine do load spaCy ML models, so moved engine init into warm_up()
  across all three components. Updated integration tests accordingly.
• Keyword-only args — Added *, to all three init methods.
• Return types — Replaced dict[str, Any] with proper typed returns, removed unused Any import.
• dataclasses.replace() — Used in PresidioEntityExtractor instead of constructing a new Document.
• Doc links — Added https://microsoft.github.io/presidio/supported_languages/,
  https://microsoft.github.io/presidio/supported_entities/, and https://microsoft.github.io/presidio/analyzer/
  links to docstrings in all three components.

[sjrl]

This link leads to a 404

[SyedShahmeerAli12]

let me check

[sjrl]

We prefer to use the pattern

Suggested change

	if self._analyzer is None:
	self._analyzer = AnalyzerEngine()
	if self._anonymizer is None:
	self._anonymizer = AnonymizerEngine()
	if self._is_warmed_up:
	return
	self._analyzer = AnalyzerEngine()
	self._anonymizer = AnonymizerEngine()
	self._is_warmed_up = True

and then add self._is_warmed_up = False to the init method

[sjrl]

We auto-warm up our components at first run time.

Suggested change

	"""
	cleaned: list[Document] = []
	"""
	if not self._is_warmed_up:
	self.warm_up()
	cleaned: list[Document] = []

[sjrl]

Once this comment is addressed https://github.com/deepset-ai/haystack-core-integrations/pull/3075/changes#r3062974319 this should be dropped. Or updated to explain that the engines are loaded on first run.