Add the snapshot repository
Add the snapshot repository
Resolve
0.32.1-SNAPSHOT from the Central snapshot repository, with snapshots enabled:agent-client-claude supplies ClaudeClientProvider, the Claude Code lifecycle provider these examples run against.
See Using development snapshots from main for pinning one build and reading its provenance.Source on GitHub main
docs/examples/tutorials/ConversationInbox.java, compiled and run offline by the agent-client build- An input that arrives mid-turn waits its turn. Doug’s request arrives while Bob’s turn runs. It is queued, and it is sent only after Bob’s turn has ended.
- The queue advances on
termination(), not on the result. Cancel Bob’s turn and its result is done at once (isDone()is true), but its process may still be stopping. A next input sent at that moment would be refused.termination()completes when the turn has really ended. - An overlapping submit is refused
BUSY. Without the inbox, a second submit while a turn runs throwsAgentOperationExceptionwithfailure()BUSY, and nothing is sent. An endpoint that submits directly maps the refusal to an HTTP status:
CLEANUP_UNKNOWN, when a turn’s cleanup could not be confirmed and the conversation is
quarantined, and CLOSED, when the conversation has ended. A full inbox answers FULL (HTTP 429), so a burst of
inputs cannot grow the queue without bound.
The full class is ConversationInbox.java.
The build compiles this tutorial from docs/examples/tutorials and runs it against OfflineProvider, an offline
stand-in that makes no model call (agent-client-tutorials, ConversationInboxTest). A live Claude Code run is not part of the build.