Namespace Nexus\Mcp\Core\Exception

Contract for SDK exceptions that translate to a JSON-RPC error response sent to a peer.

Marker for every exception thrown by this SDK.

Base for every JSON-RPC protocol-level failure raised by the SDK.

Thrown when an inbound request reuses an id whose handler coroutine is still running on the same session.

Thrown when the params payload of a known method fails the shape check the concrete request or notification class enforces in fromArray().

Thrown when the JSON-RPC envelope is structurally valid JSON but does not conform to the JSON-RPC shape (wrong version, missing fields, malformed response).

Developer-facing SDK misuse, surfaced at composition time and never sent to a peer.

Thrown when an inbound envelope's shape (request or notification) does not match the shape the method was registered under.

Thrown when no class or handler is registered for an inbound method.

Thrown when a transport cannot carry an outbound request to completion.

Thrown when an inbound-request handler invokes SenderInterface::sendRequest() on a sender that cannot carry server-to-client requests.

Thrown by the outbound-request await chain when the peer answers with a JsonRpcErrorResponse.

Thrown when an outbound request's deadline elapses before the peer answers it.

Thrown when a peer's response exceeds the byte cap the reader is willing to hold in memory.

Runtime failure whose message is the whole diagnostic, with no branch a consumer takes on the type.

Thrown when a supervised transport has spent its restart budget and stops respawning the peer.

Thrown when a transport operation is invoked on a closed transport.

Thrown when start() is called on a transport that is already running.

Thrown when a transport operation is invoked before start() has been called.

Thrown when an HTTP exchange answers with a status that carries no JSON-RPC payload settling the message the exchange was sent for.