"""
Orchestrator stub — foundation for multi-agent scenarios.

When multi-agent support is needed:
1. Implement OrchestratorAgent that decomposes tasks into subtasks
2. Each subtask is dispatched to a worker Agent with a specialized profile
3. Workers communicate results via asyncio.Queue (local) or Redis Pub/Sub (distributed)
4. Orchestrator aggregates results and produces a final response

The existing Agent class requires no modification — orchestration is purely additive.
"""

from __future__ import annotations


class Orchestrator:
    """Placeholder for future multi-agent orchestration."""

    def __init__(self) -> None:
        raise NotImplementedError(
            "Multi-agent orchestration is not yet implemented. "
            "Use Agent directly for single-agent scenarios."
        )
