SummerServiceError

Class: SummerServiceError · Inherits: RefCounted Immutable versioned failure identity shared by Summer services. A service owns its family, family_version, and stable reason. Generic game flows can switch on category and retry_disposition without depending on product routes or one ever-growing global error-code list. Instances are constructed only by trusted native adapters and cannot be mutated or forged by scripts.

Properties

Property	Type	Access	Description
`category`	`SummerServiceError.Category`	read-only, `get_category()`	Cross-service failure category.
`family`	StringName	read-only, `get_family()`	Stable service-owned error family, such as `&"summer.economy"`.
`family_version`	int	read-only, `get_family_version()`	Positive version of the error-family contract.
`reason`	StringName	read-only, `get_reason()`	Stable family-specific reason. Human-readable text remains in `SummerResult.message`.
`retry_disposition`	`SummerServiceError.RetryDisposition`	read-only, `get_retry_disposition()`	Machine-readable retry instruction.

Enums and constants

Category

Name	Value	Description
`CATEGORY_CONFLICT`	`0`	The request conflicts with committed or in-flight state.
`CATEGORY_FENCED`	`1`	The caller’s capability, epoch, or lease is no longer current.
`CATEGORY_SCHEMA`	`2`	The request or response violates its declared schema.
`CATEGORY_QUOTA`	`3`	A declared resource or rate bound was reached.
`CATEGORY_UNAVAILABLE`	`4`	The service or adapter is temporarily unavailable.
`CATEGORY_TIMEOUT`	`5`	The bounded operation deadline elapsed.
`CATEGORY_INVALID`	`6`	The caller supplied an invalid argument or idempotency contract.
`CATEGORY_UNAUTHORIZED`	`7`	The verified execution context does not authorize the operation.
`CATEGORY_INTERNAL`	`8`	The service failed without a more specific safe category.

RetryDisposition

Name	Value	Description
`RETRY_NEVER`	`0`	Do not automatically retry.
`RETRY_SAFE`	`1`	An exact bounded retry is safe under the operation’s idempotency contract.
`RETRY_AFTER_REFRESH`	`2`	Refresh capability or context before retrying.

What is live on the platform today: platform capability status. Check availability at runtime before you offer a feature.

Overview

MCP tools

HTTP API

GDScript API

Migration and extensions

MCP

Properties

Enums and constants

Category

RetryDisposition

​Properties

​Enums and constants

​Category

​RetryDisposition

Properties

Enums and constants

Category

RetryDisposition