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. Consumers can catch this interface to handle any SDK-originated error with a single catch block.

Base for every JSON-RPC protocol-level failure raised by the SDK. Concrete subclasses pin a JSON-RPC error category and may carry category-specific context.

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

Thrown when an outbound request reuses an id whose response is still pending.

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).

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 an inbound-request handler invokes the SenderInterface::sendRequest() stub before the corresponding outbound-request machinery has been implemented for the dispatching side.

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

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.