"""Which agents a request is for (ADR-0003). It never guesses. In order: the work the caller named, an agent's or a sequence's; the only agent, when there is one and no sequence; otherwise none, with how to name the work. Reading a request by Jev is step F3, added to these rules rather than in place of them. """ from __future__ import annotations from collections.abc import Mapping from collections.abc import Sequence as Seq from dataclasses import dataclass from typing import Any from orchestration.agents import Agent, Sequence WORK = "work" # the metadata field a caller names the work in @dataclass(frozen=True) class Decision: agents: tuple[Agent, ...] # in the order they work; empty when none reason: str @property def agent(self) -> Agent | None: """The first agent, or None when nothing is to start.""" return self.agents[0] if self.agents else None def route( options: Mapping[str, Any], agents: Seq[Agent], sequences: Seq[Sequence] = (), ) -> Decision: named = options.get(WORK) offered = ", ".join([*(a.work for a in agents), *(s.work for s in sequences)]) if named: for agent in agents: if agent.work == named: return Decision((agent,), f"The caller named the work {named!r}.") for sequence in sequences: if sequence.work == named: return Decision( sequence.steps, f"The caller named the sequence {named!r}." ) return Decision( (), f"No agent here does the work {named!r}. The work it can name: {offered}.", ) if len(agents) == 1 and not sequences: return Decision((agents[0],), "It is the only agent.") return Decision( (), "Nothing was started: name the work this is, as `work` in the request's " f"metadata. The work it can name: {offered}.", )