Exceptions Reference¶

sumospace.exceptions ¶

ConsensusFailedError ¶

Bases: SumoSpaceError

Raised when the committee rejects an execution plan.

ExecutionHaltedError ¶

Bases: SumoSpaceError

Raised when a critical tool step fails.

IngestError ¶

Bases: SumoSpaceError

Raised during file ingestion.

KernelBootError ¶

Bases: SumoSpaceError

Raised when kernel fails to initialize.

ProviderError ¶

Bases: SumoSpaceError

Raised when a model provider call fails.

ProviderNotConfiguredError ¶

Bases: SumoSpaceError

Raised when a cloud provider is used without the required API key or package. Provides clear install + key setup instructions in the message.

QuotaExceededError ¶

QuotaExceededError(
    current: int, attempted: int, limit: int
)

Bases: SumoSpaceError

Raised when chunk ingestion would exceed the configured max_chunks quota. Contains current count, attempted addition, and the limit.

Source code in sumospace/exceptions.py

def __init__(self, current: int, attempted: int, limit: int):
    self.current = current
    self.attempted = attempted
    self.limit = limit
    super().__init__(
        f"Quota exceeded: collection has {current} chunks, "
        f"tried to add {attempted}, limit is {limit}"
    )

SumoSpaceError ¶

Bases: Exception

Base exception for all SumoSpace errors.

ToolError ¶

Bases: SumoSpaceError

Raised when a tool execution fails.