Class AgentHandle

src/server/server.py:56–68

Handle to a spawned agent subprocess (or test double). ``send_to_agent``: write a JSON-encoded SDK message into the agent's stdin (caller adds a trailing newline if needed). ``messages_from_agent``: async iterator yielding SDK message dicts parsed from the agent's stdout. ``shut

@dataclass
class AgentHandle:
    """Handle to a spawned agent subprocess (or test double).

    ``send_to_agent``: write a JSON-encoded SDK message into the agent's
    stdin (caller adds a trailing newline if needed).
    ``messages_from_agent``: async iterator yielding SDK message dicts
    parsed from the agent's stdout.
    ``shutdown``: terminate the agent and clean up.
    """

    send_to_agent: Callable[[dict], Awaitable[None]]
    messages_from_agent: Callable[[], AsyncIterator[dict]]
    shutdown: Callable[[], Awaitable[None]]


# ─── HTTP/1.1 minimal parser for POST /sessions ────────────────────────────