1 files changed, 62 insertions, 0 deletions
diff --git a/packages/openai-sdk-python/src/supermemory_openai/exceptions.py b/packages/openai-sdk-python/src/supermemory_openai/exceptions.py
new file mode 100644
index 00000000..e80b1aed
--- /dev/null
+++ b/packages/openai-sdk-python/src/supermemory_openai/exceptions.py
@@ -0,0 +1,62 @@
+"""Custom exceptions for Supermemory OpenAI middleware."""
+
+from typing import Optional
+
+
+class SupermemoryError(Exception):
+    """Base exception for all Supermemory-related errors."""
+
+    def __init__(self, message: str, original_error: Optional[Exception] = None):
+        super().__init__(message)
+        self.message = message
+        self.original_error = original_error
+
+    def __str__(self) -> str:
+        if self.original_error:
+            return f"{self.message}: {self.original_error}"
+        return self.message
+
+
+class SupermemoryConfigurationError(SupermemoryError):
+    """Raised when there are configuration issues (e.g., missing API key)."""
+    pass
+
+
+class SupermemoryAPIError(SupermemoryError):
+    """Raised when Supermemory API requests fail."""
+
+    def __init__(
+        self,
+        message: str,
+        status_code: Optional[int] = None,
+        response_text: Optional[str] = None,
+        original_error: Optional[Exception] = None,
+    ):
+        super().__init__(message, original_error)
+        self.status_code = status_code
+        self.response_text = response_text
+
+    def __str__(self) -> str:
+        parts = [self.message]
+        if self.status_code:
+            parts.append(f"Status: {self.status_code}")
+        if self.response_text:
+            parts.append(f"Response: {self.response_text}")
+        if self.original_error:
+            parts.append(f"Cause: {self.original_error}")
+        return " | ".join(parts)
+
+
+class SupermemoryMemoryOperationError(SupermemoryError):
+    """Raised when memory operations (search, add) fail."""
+    pass
+
+
+class SupermemoryTimeoutError(SupermemoryError):
+    """Raised when operations timeout."""
+    pass
+
+
+class SupermemoryNetworkError(SupermemoryError):
+    """Raised when network operations fail."""
+    pass
+\ No newline at end of file