Agent Capabilities Framework Errors¶
consortium.framework._core.framework_exceptions.agent_capabilities_framework_exceptions
¶
AgentCapabilitiesFrameworkError(message='', detail=None)
¶
Bases: BaseFrameworkError
Base exception for all errors that occur within the agent capabilities framework.
code = 'AGENT_CAPABILITIES_FRAMEWORK_ERROR'
class-attribute
instance-attribute
¶
AgentCapabilityConfigurationError(message='', detail=None)
¶
Bases: AgentCapabilitiesFrameworkError
Base exception for all errors that occur during the configuration of a particular agent capability.
code = 'AGENT_CAPABILITY_CONFIGURATION_ERROR'
class-attribute
instance-attribute
¶
InvalidAgentCapabilityConfigurationParameterTypeError(agent_capability_str=None, parameter_name=None, parameter_type=None)
¶
Bases: AgentCapabilityConfigurationError
Raised when an agent capability's configuration parameter is not of the expected type during agent capability configuration.
code = 'INVALID_AGENT_CAPABILITY_CONFIGURATION_PARAMETER_TYPE_ERROR'
class-attribute
instance-attribute
¶
MissingAgentCapabilityConfigurationParameterError(agent_capability_filepath, parameter_name)
¶
Bases: AgentCapabilityConfigurationError
Raised when a required parameter is not declared in an agent capability's definition during agent capability configuration.
code = 'MISSING_AGENT_CAPABILITY_CONFIGURATION_PARAMETER_ERROR'
class-attribute
instance-attribute
¶
EmptyAgentCapabilityNameError(agent_capability_filepath)
¶
Bases: AgentCapabilityConfigurationError
Raised when an empty name is provided in an agent capability's definition during agent capability configuration.
code = 'EMPTY_AGENT_CAPABILITY_NAME_ERROR'
class-attribute
instance-attribute
¶
DuplicateAgentCapabilityOptionNameError(agent_capability_name, option_name)
¶
Bases: AgentCapabilityConfigurationError
Raised when duplicate option names are provided in an agent capability's definition during agent capability configuration.
code = 'DUPLICATE_AGENT_CAPABILITY_OPTION_NAME_ERROR'
class-attribute
instance-attribute
¶
CustomOSStringAlreadyRegisteredError(custom_os_str)
¶
Bases: AgentCapabilityConfigurationError
Raised when the provided custom OS string has already been registered in the agent capabilities framework during agent capability configuration.
code = 'CUSTOM_OS_STRING_ALREADY_REGISTERED_ERROR'
class-attribute
instance-attribute
¶
AgentCapabilityLaunchError(agent_capability_name, error_message, detail=None)
¶
Bases: AgentCapabilitiesFrameworkError
Raised when an agent capability is denied from launching.
This is the launch-time analogue of AgentCapabilityExecutionError: it reports a
task that never started because a pre-launch check (validation) failed, as opposed
to a task that failed while running.
code = 'AGENT_CAPABILITY_LAUNCH_ERROR'
class-attribute
instance-attribute
¶
AgentCapabilityExecutionError(agent_capability_name, error_message, detail=None)
¶
Bases: AgentCapabilitiesFrameworkError
Raised when an agent capability encounters an error during its execution.
code = 'AGENT_CAPABILITY_EXECUTION_ERROR'
class-attribute
instance-attribute
¶
AgentCapabilityFatalError(agent_capability_name, phase, underlying_exception)
¶
Bases: AgentCapabilitiesFrameworkError
Raised when an unexpected exception escapes an agent capability's hooks or its execution infrastructure, terminating the task fatally.
This is the agent capability analogue of ComponentFatalError. Unlike
AgentCapabilityLaunchError and AgentCapabilityExecutionError, which report the
capability's deliberate, typed failure paths, this reports an unhandled exception that
escaped on_launch, message dispatch, or on_execute. The phase identifies which of
those stages failed. The original exception is preserved as the cause when this error
is re-raised, so its traceback survives server side; only the type and message cross
the API boundary through detail.
code = 'AGENT_CAPABILITY_FATAL_ERROR'
class-attribute
instance-attribute
¶
AgentCapabilityTaskHandlerError(agent_capability_name, underlying_exception)
¶
Bases: AgentCapabilitiesFrameworkError
Raised when an unexpected exception escapes the task handler itself, outside the agent capability's execution contract.
AgentCapabilityFatalError covers the stages the handler can attribute to a
capability (launch, dispatch, execution), so it carries a phase. Reaching this
error instead means the failure happened in the handler surrounding those stages,
where no phase applies: it is a framework defect rather than a capability one. It is
recorded on the task so the task does not sit non-terminal forever rather than being
raised, so it carries no cause; the original exception's traceback is logged where it
is caught.
code = 'AGENT_CAPABILITY_TASK_HANDLER_ERROR'
class-attribute
instance-attribute
¶
PayloadTooLargeError(max_size)
¶
Bases: AgentCapabilitiesFrameworkError
Raised when a payload being received exceeds a maximum size its transport set.
The cap is opt in: Payload.from_async_iterable is uncapped by default and enforces
a bound only when a caller passes max_size, in which case it is enforced as the
source is consumed so an unbounded upload is rejected mid-stream rather than after
being fully buffered. This is the single place transports learn a payload was refused
for size, replacing the per-transport sentinels and cap loops each one used to carry.
code = 'PAYLOAD_TOO_LARGE_ERROR'
class-attribute
instance-attribute
¶
AgentCommunicationEndOfStreamError(agent_id, name, task_id, command)
¶
Bases: AgentCapabilitiesFrameworkError
Raised when a communicator reaches the end of a task's message stream.
A communicator is coordinated with the remote endpoint for the lifetime of a task, so it should never observe end of stream while waiting for a message from the agent. Observing it means the inbox was shut down out from under a coordinated read, which is a genuine error rather than the normal termination signal the outbox-side readers rely on.