Skip to content

exceptions

exceptions

Exception classes for Marianne execution errors.

Contains the exception hierarchy used across CLI, daemon, and execution layers for non-recoverable errors, rate limit exhaustion, and graceful shutdown.

Classes

FatalError

Bases: Exception

Non-recoverable error that should stop the job.

RateLimitExhaustedError 

RateLimitExhaustedError(message, resume_after=None, backend_type='unknown', quota_exhaustion=False)

Bases: FatalError

Rate limit or quota exhaustion — job should PAUSE, not FAIL.

Subclasses FatalError for backward compatibility: existing except FatalError blocks still catch it, but more specific except RateLimitExhaustedError blocks intercept first when ordered before except FatalError.

Attributes:

Name Type Description
resume_after

When the rate limit resets (ISO datetime), or None.
backend_type

Which backend hit the limit (e.g., "claude-cli").
quota_exhaustion

True if daily/monthly quota is exhausted, False if it's a per-minute rate limit.
Source code in src/marianne/core/errors/exceptions.py 
34
35
36
37
38
39
40
41
42
43
44
def __init__(
    self,
    message: str,
    resume_after: datetime | Any | None = None,
    backend_type: str = "unknown",
    quota_exhaustion: bool = False,
) -> None:
    super().__init__(message)
    self.resume_after = resume_after
    self.backend_type = backend_type
    self.quota_exhaustion = quota_exhaustion

GracefulShutdownError

Bases: Exception

Raised when Ctrl+C is pressed to trigger graceful shutdown.

This exception is caught by the runner to save state before exiting.