Package dev.tachyonmcp.core.server.domain

Class ServerErrors

java.lang.Object

dev.tachyonmcp.core.server.domain.ServerErrors

public final class ServerErrors
extends Object

Factories for protocol-neutral server errors.

Method Summary

Modifier and Type	Method	Description
static ServerError	fromUnhandledException(Throwable cause, String internalErrorDetail)	Default mapping for an exception a handler didn't translate to a wire error itself.
static ServerError	headerMismatch(String detail)
static ServerError	internalError(String detail)
static ServerError	invalidParams(String detail)
static ServerError	invalidRequest(String detail)
static ServerError	methodNotFound(String detail)
static ServerError	missingRequiredClientCapability(String detail, Map<String,Object> requiredCapabilities)	error.data.requiredCapabilities is a ClientCapabilities-shaped map, not a name list.
static ServerError	parseError()
static ServerError	resourceNotFound(String detail)
static ServerError	resourceNotFound(String detail, Map<String,String> data)
static ServerError	unsupportedProtocolVersion(String detail, Map<String,Object> data)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

parseError

public static ServerError parseError()

invalidRequest

public static ServerError invalidRequest(String detail)

methodNotFound

public static ServerError methodNotFound(String detail)

invalidParams

public static ServerError invalidParams(String detail)

internalError

public static ServerError internalError(String detail)

fromUnhandledException

@InternalApi
public static ServerError fromUnhandledException(Throwable cause,
 String internalErrorDetail)

Default mapping for an exception a handler didn't translate to a wire error itself. A bare IllegalArgumentException is treated as bad input (INVALID_PARAMS) without echoing its message, which may originate from arbitrary library code and isn't vetted for sensitive content — unlike InvalidArgumentException, which handler authors throw deliberately with a message they control. MissingRequiredClientCapabilityException maps to its own wire error. Everything else is INTERNAL_ERROR.

resourceNotFound

public static ServerError resourceNotFound(String detail)

resourceNotFound

public static ServerError resourceNotFound(String detail,
 Map<String,String> data)

headerMismatch

public static ServerError headerMismatch(String detail)

missingRequiredClientCapability

public static ServerError missingRequiredClientCapability(String detail,
 Map<String,Object> requiredCapabilities)

error.data.requiredCapabilities is a ClientCapabilities-shaped map, not a name list.

unsupportedProtocolVersion

public static ServerError unsupportedProtocolVersion(String detail,
 Map<String,Object> data)