Repository navigation
Expand file tree
/
Copy pathexceptions.py
More file actions
243 lines (166 loc) · 5.81 KB
/
Copy pathexceptions.py
File metadata and controls
243 lines (166 loc) · 5.81 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
"""
exceptions.py - Custom Exceptions for Neuron Framework
This module defines a hierarchy of custom exceptions that provide informative
error messages and proper categorization of different error types that can
occur within the Neuron framework.
Having a well-structured exception hierarchy allows for precise error handling
and helps developers diagnose issues more effectively.
"""
class NeuronException(Exception):
"""
Base exception for all Neuron framework errors.
This serves as the parent class for all framework-specific exceptions,
allowing developers to catch all Neuron-related exceptions with a single
except clause if desired.
"""
pass
# Core System Exceptions
class ConfigurationError(NeuronException):
"""
Raised when there's an error in the framework configuration.
Examples include invalid configuration values, missing required
configuration parameters, or configuration that creates an invalid state.
"""
pass
class ValidationError(NeuronException):
"""
Raised when validation of any component, message, or structure fails.
This includes schema validation, format validation, and logical
validation of structures and connections.
"""
pass
# Agent-Related Exceptions
class AgentError(NeuronException):
"""Base class for all agent-related exceptions."""
pass
class AgentInitializationError(AgentError):
"""
Raised when an agent fails to initialize properly.
This could be due to missing dependencies, invalid configuration,
or failure to connect to required services.
"""
pass
class AgentProcessingError(AgentError):
"""
Raised when an agent encounters an error during message processing.
This is typically used when the agent's core processing logic fails,
but the agent itself is still functional.
"""
pass
class AgentCapabilityError(AgentError):
"""
Raised when an agent is asked to perform a capability it doesn't have.
This helps identify mismatches between expected and actual agent capabilities,
which is crucial for proper circuit design.
"""
pass
# Memory-Related Exceptions
class MemoryError(NeuronException):
"""Base class for all memory-related exceptions."""
pass
class MemoryAccessError(MemoryError):
"""
Raised when there's an error accessing memory.
Examples include attempting to access non-existent memory entries
or permission issues for protected memories.
"""
pass
class MemoryStorageError(MemoryError):
"""
Raised when there's an error storing information in memory.
This could happen due to validation failures, storage limits,
or backend storage issues.
"""
pass
# Communication-Related Exceptions
class CommunicationError(NeuronException):
"""Base class for all communication-related exceptions."""
pass
class SynapticBusError(CommunicationError):
"""
Raised when there's an error in the SynapticBus communication system.
This includes message routing errors, channel configuration issues,
and message delivery failures.
"""
pass
class MessageValidationError(CommunicationError):
"""
Raised when a message fails validation.
This helps identify malformed messages or messages with invalid content
before they propagate through the system.
"""
pass
class ChannelError(CommunicationError):
"""
Raised when there's an error with a specific communication channel.
Examples include channel creation failures, subscription issues,
and channel capacity problems.
"""
pass
# Circuit-Related Exceptions
class CircuitError(NeuronException):
"""Base class for all circuit-related exceptions."""
pass
class CircuitDesignerError(CircuitError):
"""
Raised when there's an error in circuit design or validation.
This helps identify issues with circuit structure, agent connections,
or other design-time problems.
"""
pass
class CircuitRuntimeError(CircuitError):
"""
Raised when a circuit encounters a runtime error.
This is used for errors that occur during circuit operation,
such as deadlocks, message flow issues, or agent failures.
"""
pass
# Monitoring-Related Exceptions
class MonitoringError(NeuronException):
"""
Raised when there's an error in the monitoring system.
This includes metric collection failures, visualization errors,
and alerting problems.
"""
pass
# Extension-Related Exceptions
class ExtensionError(NeuronException):
"""
Raised when there's an error loading or using a framework extension.
This helps identify compatibility issues or problems with
third-party extensions.
"""
pass
class PluginError(ExtensionError):
"""
Raised when there's an error with a specific plugin.
This includes plugin initialization failures, compatibility issues,
and plugin runtime errors.
"""
pass
# Integration-Related Exceptions
class IntegrationError(NeuronException):
"""
Raised when there's an error integrating with external systems.
This helps identify issues with external APIs, services,
or data sources that the framework interacts with.
"""
pass
# Resource-Related Exceptions
class ResourceError(NeuronException):
"""Base class for all resource-related exceptions."""
pass
class ResourceExhaustedError(ResourceError):
"""
Raised when a resource limit is reached.
Examples include memory limits, API rate limits,
or computational resource constraints.
"""
pass
class ResourceNotFoundError(ResourceError):
"""
Raised when a requested resource cannot be found.
This includes missing files, unavailable services,
or references to non-existent entities.
"""
pass