"""可由入口层稳定映射的领域异常。"""


class DomainError(Exception):
    """所有可预期业务错误的基类。"""


class InvalidStateTransition(DomainError):
    """运行状态不允许执行目标转换。"""


class DuplicateOperation(DomainError):
    """同一幂等操作已经执行或正在执行。"""


class PermissionDenied(DomainError):
    """操作者无权执行领域命令。"""


class AgentConfigurationError(DomainError):
    """真实 Agent 执行所需配置缺失或不合法。"""


class ProviderConnectionError(DomainError):
    """模型服务商凭据验证失败；消息不得包含上游原始响应。"""

    def __init__(self, code: str, message: str):
        super().__init__(message)
        self.code = code