export type ErrorCode = "AUTH_ERROR" | "RATE_LIMITED" | "NOT_FOUND" | "INVALID_INPUT" | "STARTGG_GRAPHQL_ERROR" | "NETWORK_ERROR" | "INTERNAL_ERROR";
/**
 * The only error type surfaced to MCP clients. Messages must be written for an
 * LLM to act on, and must never contain the API token or stack traces.
 */
export declare class StartggError extends Error {
    readonly code: ErrorCode;
    /** Small, safe-to-expose extras (e.g. httpStatus). Never secrets. */
    readonly details: Record<string, unknown> | undefined;
    constructor(code: ErrorCode, message: string, details?: Record<string, unknown>);
}
export declare function authError(message?: string): StartggError;
export declare function notFound(what: string): StartggError;
export declare function invalidInput(message: string): StartggError;
/** Coerce any thrown value into a StartggError without leaking internals. */
export declare function toStartggError(err: unknown): StartggError;