Agent Profiles Service Errors¶
consortium.server.exceptions.service_exceptions.agent_profiles_service_exceptions
¶
Exception hierarchy:
BaseServiceErrorAgentProfilesServiceErrorAgentProfileNotFoundErrorAgentProfileLoadingErrorInvalidAgentProfileManifestFileErrorInvalidAgentProfilePyProjectFileErrorInvalidAgentProfilePyProjectFileTOMLErrorInvalidAgentProfilePyProjectFileDependencyErrorInvalidAgentProfileDirectoryStructureErrorInvalidAgentProfileImplementationErrorIncompatibleAgentProfileFrameworkVersionErrorAgentProfileAlreadyRegisteredErrorDuplicateAgentProfileLabelError
AgentProfileDependencyErrorAgentProfileDiscoveryFileSystemError
The loading, dependency, and registry exceptions below carry no __init__ of their own: they
are constructed by the shared component loader/registry pipeline with the generic component
keyword arguments (component_directory, component_str, component_id, ...) inherited from
their components_service_exceptions base. AgentProfileDiscoveryFileSystemError also carries
no __init__ of its own: it inherits the operation/path/underlying_error constructor from
ComponentDiscoveryFileSystemError so it plugs directly into the shared
wrap_filesystem_errors helper.
AgentProfilesServiceError(message='', detail=None)
¶
Bases: BaseServiceError
Base exception for all errors that occur within the agent profiles service.
Attributes:
| Name | Type | Description |
|---|---|---|
code |
A stable machine-readable string identifying the specific error. |
|
message |
str
|
A human-readable description of what went wrong and, where possible, how to resolve it. |
detail |
dict[str, JsonValue] | None
|
Optional structured context about the error, or None when there is none. |
code = 'AGENT_PROFILES_SERVICE_ERROR'
class-attribute
instance-attribute
¶
AgentProfileNotFoundError(component_id)
¶
Bases: AgentProfilesServiceError, ComponentNotFoundError
Raised when the requested agent profile with the provided agent profile ID was not found in the agent profiles service.
code = 'AGENT_PROFILE_NOT_FOUND_ERROR'
class-attribute
instance-attribute
¶
AgentProfileLoadingError(**kwargs)
¶
Bases: AgentProfilesServiceError, ComponentLoadingError
Base exception for all errors that occur during the loading of an agent profile.
code = 'AGENT_PROFILE_LOADING_ERROR'
class-attribute
instance-attribute
¶
InvalidAgentProfileManifestFileError(**kwargs)
¶
Bases: AgentProfileLoadingError, InvalidComponentManifestFileError
Base exception for all errors that occur due to an invalid agent profile manifest file during agent profile loading.
code = 'INVALID_AGENT_PROFILE_MANIFEST_FILE_ERROR'
class-attribute
instance-attribute
¶
InvalidAgentProfileManifestFileJSONError(component_directory)
¶
Bases: InvalidAgentProfileManifestFileError, InvalidComponentManifestFileJSONError
Raised when the agent profile manifest file is not valid JSON during agent profile loading.
code = 'INVALID_AGENT_PROFILE_MANIFEST_FILE_JSON_ERROR'
class-attribute
instance-attribute
¶
InvalidAgentProfileManifestFileSchemaError(component_directory, json_schema_error_message)
¶
Bases: InvalidAgentProfileManifestFileError, InvalidComponentManifestFileSchemaError
Raised when the agent profile manifest file does not conform to the expected JSON schema during agent profile loading.
code = 'INVALID_AGENT_PROFILE_MANIFEST_FILE_SCHEMA_ERROR'
class-attribute
instance-attribute
¶
InvalidAgentProfilePyProjectFileError(**kwargs)
¶
Bases: AgentProfileLoadingError, InvalidComponentPyProjectFileError
Base exception for all errors that occur due to an invalid pyproject.toml file
during agent profile loading.
code = 'INVALID_AGENT_PROFILE_PYPROJECT_FILE_ERROR'
class-attribute
instance-attribute
¶
InvalidAgentProfilePyProjectFileTOMLError(component_directory)
¶
Bases: AgentProfileLoadingError, InvalidComponentPyProjectFileTOMLError
Raised when the pyproject.toml file is not a valid TOML file during agent profile
loading.
code = 'INVALID_AGENT_PROFILE_PYPROJECT_FILE_TOML_ERROR'
class-attribute
instance-attribute
¶
InvalidAgentProfilePyProjectFileDependencyError(component_directory, invalid_dependency_entry)
¶
Bases: AgentProfileLoadingError, InvalidComponentPyProjectFileDependencyError
Raised when the pyproject.toml file contains an invalid dependency entry during
agent profile loading.
code = 'INVALID_AGENT_PROFILE_PYPROJECT_FILE_DEPENDENCY_ERROR'
class-attribute
instance-attribute
¶
InvalidAgentProfileDirectoryStructureError(**kwargs)
¶
Bases: AgentProfileLoadingError, InvalidComponentDirectoryStructureError
Base exception for all errors that occur due to an invalid agent profile directory structure during agent profile loading.
code = 'INVALID_AGENT_PROFILE_DIRECTORY_STRUCTURE_ERROR'
class-attribute
instance-attribute
¶
AgentProfileManifestFileNotFoundError(component_directory)
¶
Bases: InvalidAgentProfileDirectoryStructureError, ComponentManifestFileNotFoundError
Raised when the agent profile manifest file is not found in the agent profile directory during agent profile loading.
code = 'AGENT_PROFILE_MANIFEST_FILE_NOT_FOUND_ERROR'
class-attribute
instance-attribute
¶
AgentProfileEntryPointModuleNotFoundError(component_directory, entry_point_module)
¶
Bases: InvalidAgentProfileDirectoryStructureError, ComponentEntryPointModuleNotFoundError
Raised when the agent profile entry point module specified in the manifest file is not found in the agent profile directory during agent profile loading.
code = 'AGENT_PROFILE_ENTRY_POINT_MODULE_NOT_FOUND_ERROR'
class-attribute
instance-attribute
¶
InvalidAgentProfileImplementationError(**kwargs)
¶
Bases: AgentProfileLoadingError, InvalidComponentImplementationError
Base exception for all errors that occur due to the agent profile not implementing the required interface during agent profile loading.
code = 'INVALID_AGENT_PROFILE_IMPLEMENTATION_ERROR'
class-attribute
instance-attribute
¶
AgentProfileSymbolNotFoundError(component_directory, entry_point_symbol, entry_point_module)
¶
Bases: InvalidAgentProfileImplementationError, ComponentSymbolNotFoundError
Raised when the agent profile symbol name specified in the manifest file is not found in the agent profile entry point module during agent profile loading.
code = 'AGENT_PROFILE_SYMBOL_NOT_FOUND_ERROR'
class-attribute
instance-attribute
¶
AgentProfileInterfaceError(component_directory, entry_point_symbol)
¶
Bases: InvalidAgentProfileImplementationError, ComponentInterfaceError
Raised when the agent profile class does not implement the required interface during agent profile loading.
code = 'AGENT_PROFILE_INTERFACE_ERROR'
class-attribute
instance-attribute
¶
InternalAgentProfileError(component_directory, internal_error_message)
¶
Bases: InvalidAgentProfileImplementationError, InternalComponentError
Raised when an unhandled exception from within the agent profile is raised during agent profile loading.
code = 'INTERNAL_AGENT_PROFILE_ERROR'
class-attribute
instance-attribute
¶
IncompatibleAgentProfileFrameworkVersionError(component_str, required_version, current_version)
¶
Bases: AgentProfileLoadingError, IncompatibleComponentFrameworkVersionError
Raised when an agent profile's required framework version is incompatible with the current framework version during agent profile loading.
code = 'INCOMPATIBLE_AGENT_PROFILE_FRAMEWORK_VERSION_ERROR'
class-attribute
instance-attribute
¶
AgentProfileAlreadyRegisteredError(component_str, component_id)
¶
Bases: AgentProfileLoadingError, ComponentAlreadyRegisteredError
Raised when an agent profile with the same ID is already registered in the agent profiles service during agent profile loading.
code = 'AGENT_PROFILE_ALREADY_REGISTERED_ERROR'
class-attribute
instance-attribute
¶
DuplicateAgentProfileLabelError(component_str, label)
¶
Bases: AgentProfileLoadingError, DuplicateComponentLabelError
Raised when the label provided in the agent profile's definition is already in use by another agent profile during agent profile loading.
code = 'DUPLICATE_AGENT_PROFILE_LABEL_ERROR'
class-attribute
instance-attribute
¶
AgentProfileDependencyError(**kwargs)
¶
Bases: AgentProfilesServiceError, ComponentDependencyError
Base exception for all errors that occur during the resolution of agent profile dependencies.
code = 'AGENT_PROFILE_DEPENDENCY_ERROR'
class-attribute
instance-attribute
¶
ThirdPartyDependencyNotFoundError(component_directory, third_party_dependency_name)
¶
Bases: AgentProfileDependencyError, ThirdPartyDependencyNotFoundError
Raised when a third-party dependency required by an agent profile is not installed during agent profile dependency resolution.
code = 'THIRD_PARTY_DEPENDENCY_NOT_FOUND_ERROR'
class-attribute
instance-attribute
¶
IncompatibleThirdPartyDependencyVersionError(component_directory, third_party_dependency_name, required_version, installed_version)
¶
Bases: AgentProfileDependencyError, IncompatibleThirdPartyDependencyVersionError
Raised when a third-party dependency's installed version is incompatible with the version required by the agent profile during agent profile dependency resolution.
code = 'INCOMPATIBLE_THIRD_PARTY_DEPENDENCY_VERSION_ERROR'
class-attribute
instance-attribute
¶
ComponentDependencyNotFoundError(component_str, missing_dependency)
¶
Bases: AgentProfileDependencyError, ComponentDependencyNotFoundError
Raised when a component dependency required by the agent profile is not found in the components service during agent profile dependency resolution.
code = 'COMPONENT_DEPENDENCY_NOT_FOUND_ERROR'
class-attribute
instance-attribute
¶
IncompatibleComponentDependencyVersionError(component_str, incompatible_dependency, required_version, installed_version)
¶
Bases: AgentProfileDependencyError, IncompatibleComponentDependencyVersionError
Raised when a component dependency's version is incompatible with the version required by the agent profile during agent profile dependency resolution.
code = 'INCOMPATIBLE_COMPONENT_DEPENDENCY_VERSION_ERROR'
class-attribute
instance-attribute
¶
AgentProfileDependsOnInvalidComponentDependencyError(component_str, invalid_dependency)
¶
Bases: AgentProfileDependencyError, ComponentDependsOnInvalidComponentDependencyError
Raised when an agent profile depends on another component dependency that itself has invalid dependencies during agent profile dependency resolution.
code = 'AGENT_PROFILE_DEPENDS_ON_INVALID_COMPONENT_DEPENDENCY_ERROR'
class-attribute
instance-attribute
¶
ComponentDependencyNotRunningError(component_str, not_running_dependency)
¶
Bases: AgentProfileDependencyError, ComponentDependencyNotRunningError
Raised when a component dependency required by the agent profile is present but not currently running during agent profile dependency resolution.
code = 'COMPONENT_DEPENDENCY_NOT_RUNNING_ERROR'
class-attribute
instance-attribute
¶
AgentProfileDiscoveryFileSystemError(operation, path, underlying_error)
¶
Bases: AgentProfilesServiceError, ComponentDiscoveryFileSystemError
Raised when a recursive filesystem scan for agent profiles fails at the filesystem level.