feat(memory): add result_items provenance to MemoryQueryCompletedEvent

[maxpetrusenkoagent]

Summary

Adds structured per-item provenance to MemoryQueryCompletedEvent so benchmark runners can trace individual memory entries without leaking embedding vectors.

Problem

Issue #5800: Bench'd Independent Benchmark Results for CrewAI Memory showed that aggregate scores mask per-item failures. The MemoryQueryCompletedEvent emitted by Memory.remember() and Memory.recall() had no structured way to trace which specific memory entries were retrieved, their sources, scores, and match reasons.

Solution

Add result_items: list[dict[str, Any]] to MemoryQueryCompletedEvent. Each item contains:

Field	Description
record_id	Memory entry UUID
content	Text content (no embeddings)
scope	Hierarchical path
categories	Tags
metadata	Arbitrary metadata
source	Provenance (session/user ID)
private	Privacy flag
importance	Importance score
created_at	ISO timestamp
last_accessed	ISO timestamp
score	Composite relevance score
match_reasons	Why it matched (semantic, recency, etc.)
evidence_gaps	What the system looked for but missed

Embeddings are intentionally excluded from serialization to prevent vector data leakage into traces and benchmark reports.

Changes

• crewai/events/types/memory_events.py: Added result_items field to MemoryQueryCompletedEvent
• crewai/memory/unified_memory.py: Populate result_items at event emission time
• tests/memory/test_unified_memory.py: Tests for the new field

Verification

uv run pytest lib/crewai/tests/memory/test_unified_memory.py -k result_items -v

127 memory tests pass. ruff and mypy clean on changed files.

Closes #5800

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 42fb116f-509f-477f-8d85-0b64c2162e86

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}