Agent

Five paths the server opens on an agent container: the agent registered, a loop run, the agent’s schema obtained, a message enqueued, and the queue emptied.

Five paths carry the exchanges of the server with the loop of an agent container. The server opens each path; the proxy answers.

Path	The server sends	The proxy sends
`/agent/register`	the agent, once	exactly one answer: registered, or an error
`/agent/run`	a prompt	the chunks of the loop, or an error
`/agent/schema`	nothing	exactly one answer: the JSON Schema of the agent, or an error
`/agent/enqueue`	a message for the queue	exactly one answer: its fate, sent when the fate is known
`/agent/dequeue`	nothing	exactly one answer: whether the queue held anything

The first binary message is the ask, on every path that has one, as JSON read as Notation provides. A close before it causes the proxy to close the connection with no message before the close.
On an agent container only. The server opens these paths only on a container whose entrypoint is an agent.
No repetition. An exchange whose path ended abruptly has failed: a loop cut short, a fate not heard, a registration not answered. No party retries it.

In this section

/agent/register — The agent, sent exactly once for the life of the container; the proxy sends exactly one answer, registered or an error, and closes the connection.
/agent/run — A prompt, and the loop that runs on it: the proxy sends zero or more chunks and closes the connection, or sends one error as its last message; the first message states whether a loop ran.
/agent/schema — The server sends nothing; the proxy sends exactly one answer, the JSON Schema of the agent value or an error, and closes the connection.
/agent/enqueue — A message for the queue of the loop; the proxy sends exactly one answer, the fate of the message, when the fate is known, and closes the connection.
/agent/dequeue — The server sends nothing; the proxy withdraws every message from the queue of the loop, sends exactly one answer stating whether the queue held anything, and closes the connection.