Skip to content

Errors

Normalized public errors raised by gllm-memory.

BaseChatHistoryError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseMemoryError

Root of normalized errors raised by chat history management.

BaseMem0Error(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseMemoryProviderError

Root for normalized failures from the Mem0 integration.

BaseMemoryError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseError

Root of normalized public errors raised by gllm-memory.

BaseMemoryProviderError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseMemoryError

Root for one concrete memory-provider error family.

ChatHistoryConfigurationError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseChatHistoryError, ValueError

Raised when chat history processor configuration is invalid.

ChatHistoryInputError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseChatHistoryError, ValueError

Raised when a chat history request is missing valid input.

Mem0AuthError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseMem0Error

Raised when Mem0 rejects configured credentials.

Mem0OperationError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseMem0Error

Raised for an unclassified Mem0 integration failure.

Mem0RateLimitError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseMem0Error

Raised when Mem0 temporarily limits request throughput.

Mem0ResponseError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseMem0Error

Raised when Mem0 returns a response the SDK cannot process.

Mem0TimeoutError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseMem0Error

Raised when Mem0 does not respond before the configured timeout.

Mem0UnavailableError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseMem0Error

Raised when Mem0 cannot be reached or is temporarily unavailable.

MemoryConfigurationError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseMemoryError, ValueError, RuntimeError

Raised when gllm-memory configuration is invalid.

MemoryInputError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseMemoryError, ValueError

Raised when a memory request cannot be processed as valid input.

MemoryOperationError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseMemoryError

Raised for a library failure before a provider can be identified.

RecoveryInfo

Bases: TypedDict

Recovery guidance attached to a normalized error.

Attributes:

Name Type Description
retryable Required[bool]

Whether it is safe for a caller to retry the operation.

retry_after_seconds NotRequired[int]

Suggested retry delay when one is known.

escalate_when NotRequired[str]

Condition under which a caller should escalate the failure.