src/services/agents/context.py

"""
MediGuard AI — Agentic RAG Context

Runtime dependency injection dataclass — passed to every LangGraph node
so nodes can access services without globals.
"""

from __future__ import annotations

from dataclasses import dataclass
from typing import Any


@dataclass(frozen=True)
class AgenticContext:
    """Immutable runtime context for agentic RAG nodes."""

    llm: Any  # LangChain chat model
    embedding_service: Any  # EmbeddingService
    opensearch_client: Any  # OpenSearchClient
    cache: Any  # RedisCache
    tracer: Any  # LangfuseTracer
    guild: Any | None = None  # ClinicalInsightGuild (original workflow)
    retriever: Any | None = None  # BaseRetriever (FAISS or OpenSearch)