abstractcore 2.4.0__py3-none-any.whl → 2.4.1__py3-none-any.whl

abstractcore/exceptions/__init__.py

@@ -0,0 +1,125 @@
+"""
+Custom exceptions for AbstractCore.
+"""
+
+
+class AbstractCoreError(Exception):
+    """Base exception for AbstractCore"""
+    pass
+
+
+class ProviderError(AbstractCoreError):
+    """Base exception for provider-related errors"""
+    pass
+
+
+class ProviderAPIError(ProviderError):
+    """API call to provider failed"""
+    pass
+
+
+class AuthenticationError(ProviderError):
+    """Authentication with provider failed"""
+    pass
+
+
+# Alias for backward compatibility with old AbstractCore
+Authentication = AuthenticationError
+
+
+class RateLimitError(ProviderError):
+    """Rate limit exceeded"""
+    pass
+
+
+class InvalidRequestError(ProviderError):
+    """Invalid request to provider"""
+    pass
+
+
+class UnsupportedFeatureError(AbstractCoreError):
+    """Feature not supported by provider"""
+    pass
+
+
+class FileProcessingError(AbstractCoreError):
+    """Error processing file or media"""
+    pass
+
+
+class ToolExecutionError(AbstractCoreError):
+    """Error executing tool"""
+    pass
+
+
+class SessionError(AbstractCoreError):
+    """Error with session management"""
+    pass
+
+
+class ConfigurationError(AbstractCoreError):
+    """Invalid configuration"""
+    pass
+
+
+class ModelNotFoundError(ProviderError):
+    """Model not found or invalid model name"""
+    pass
+
+
+def format_model_error(provider: str, invalid_model: str, available_models: list) -> str:
+    """
+    Format a helpful error message for model not found errors.
+
+    Args:
+        provider: Provider name (e.g., "OpenAI", "Anthropic")
+        invalid_model: The model name that was not found
+        available_models: List of available model names
+
+    Returns:
+        Formatted error message string
+    """
+    message = f"❌ Model '{invalid_model}' not found for {provider} provider.\n"
+
+    if available_models:
+        message += f"\n✅ Available models ({len(available_models)}):\n"
+        for model in available_models[:30]:  # Show max 30
+            message += f"  • {model}\n"
+        if len(available_models) > 30:
+            message += f"  ... and {len(available_models) - 30} more\n"
+    else:
+        # Show provider documentation when we can't fetch models
+        doc_links = {
+            "anthropic": "https://docs.anthropic.com/en/docs/about-claude/models",
+            "openai": "https://platform.openai.com/docs/models",
+            "ollama": "https://ollama.com/library",
+            "huggingface": "https://huggingface.co/models",
+            "mlx": "https://huggingface.co/mlx-community"
+        }
+
+        provider_lower = provider.lower()
+        if provider_lower in doc_links:
+            message += f"\n📚 See available models: {doc_links[provider_lower]}\n"
+        else:
+            message += f"\n⚠️  Could not fetch available models for {provider}.\n"
+
+    return message.rstrip()
+
+
+# Export all exceptions for easy importing
+__all__ = [
+    'AbstractCoreError',
+    'ProviderError', 
+    'ProviderAPIError',
+    'AuthenticationError',
+    'Authentication',  # Backward compatibility alias
+    'RateLimitError',
+    'InvalidRequestError',
+    'UnsupportedFeatureError',
+    'FileProcessingError',
+    'ToolExecutionError',
+    'SessionError',
+    'ConfigurationError',
+    'ModelNotFoundError',
+    'format_model_error'
+]

abstractcore/media/__init__.py

@@ -0,0 +1,151 @@
+"""
+Media handling for different providers.
+"""
+
+import base64
+from pathlib import Path
+from typing import Union, Dict, Any, Optional
+from enum import Enum
+
+
+class MediaType(Enum):
+    """Supported media types"""
+    IMAGE = "image"
+    AUDIO = "audio"
+    VIDEO = "video"
+    DOCUMENT = "document"
+
+
+class MediaHandler:
+    """Base class for media handling"""
+
+    @staticmethod
+    def encode_image(image_path: Union[str, Path]) -> str:
+        """
+        Encode an image file to base64.
+
+        Args:
+            image_path: Path to the image file
+
+        Returns:
+            Base64 encoded string
+        """
+        with open(image_path, "rb") as image_file:
+            return base64.b64encode(image_file.read()).decode('utf-8')
+
+    @staticmethod
+    def format_for_openai(image_path: Union[str, Path]) -> Dict[str, Any]:
+        """
+        Format image for OpenAI API.
+
+        Args:
+            image_path: Path to the image
+
+        Returns:
+            Formatted content for OpenAI
+        """
+        base64_image = MediaHandler.encode_image(image_path)
+        return {
+            "type": "image_url",
+            "image_url": {
+                "url": f"data:image/jpeg;base64,{base64_image}"
+            }
+        }
+
+    @staticmethod
+    def format_for_anthropic(image_path: Union[str, Path]) -> Dict[str, Any]:
+        """
+        Format image for Anthropic API.
+
+        Args:
+            image_path: Path to the image
+
+        Returns:
+            Formatted content for Anthropic
+        """
+        base64_image = MediaHandler.encode_image(image_path)
+
+        # Detect image type
+        path = Path(image_path)
+        media_type = "image/jpeg"
+        if path.suffix.lower() == ".png":
+            media_type = "image/png"
+        elif path.suffix.lower() == ".gif":
+            media_type = "image/gif"
+        elif path.suffix.lower() == ".webp":
+            media_type = "image/webp"
+
+        return {
+            "type": "image",
+            "source": {
+                "type": "base64",
+                "media_type": media_type,
+                "data": base64_image
+            }
+        }
+
+    @staticmethod
+    def format_for_provider(image_path: Union[str, Path], provider: str) -> Optional[Dict[str, Any]]:
+        """
+        Format media for a specific provider.
+
+        Args:
+            image_path: Path to the media file
+            provider: Provider name
+
+        Returns:
+            Formatted content or None if not supported
+        """
+        provider_lower = provider.lower()
+
+        if provider_lower == "openai":
+            return MediaHandler.format_for_openai(image_path)
+        elif provider_lower == "anthropic":
+            return MediaHandler.format_for_anthropic(image_path)
+        else:
+            # Local providers typically don't support images directly
+            return None
+
+    @staticmethod
+    def is_image_file(path: Union[str, Path]) -> bool:
+        """
+        Check if a file is an image.
+
+        Args:
+            path: Path to check
+
+        Returns:
+            True if the file is an image
+        """
+        image_extensions = {'.jpg', '.jpeg', '.png', '.gif', '.bmp', '.webp', '.ico', '.tiff'}
+        return Path(path).suffix.lower() in image_extensions
+
+    @staticmethod
+    def get_media_type(path: Union[str, Path]) -> MediaType:
+        """
+        Determine the media type of a file.
+
+        Args:
+            path: Path to the file
+
+        Returns:
+            MediaType enum value
+        """
+        path = Path(path)
+        extension = path.suffix.lower()
+
+        image_extensions = {'.jpg', '.jpeg', '.png', '.gif', '.bmp', '.webp'}
+        audio_extensions = {'.mp3', '.wav', '.m4a', '.ogg', '.flac'}
+        video_extensions = {'.mp4', '.avi', '.mov', '.mkv', '.webm'}
+        document_extensions = {'.pdf', '.doc', '.docx', '.txt', '.md'}
+
+        if extension in image_extensions:
+            return MediaType.IMAGE
+        elif extension in audio_extensions:
+            return MediaType.AUDIO
+        elif extension in video_extensions:
+            return MediaType.VIDEO
+        elif extension in document_extensions:
+            return MediaType.DOCUMENT
+        else:
+            return MediaType.DOCUMENT  # Default to document

abstractcore/utils/version.py

@@ -11,4 +11,4 @@ including when the package is installed from PyPI where pyproject.toml is not av
 
 # Package version - update this when releasing new versions
 # This must be manually synchronized with the version in pyproject.toml
-__version__ = "2.4.0"
+__version__ = "2.4.1"

{abstractcore-2.4.0.dist-info → abstractcore-2.4.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractcore
-Version: 2.4.0
+Version: 2.4.1
 Summary: Unified interface to all LLM providers with essential infrastructure for tool calling, streaming, and model management
 Author-email: Laurent-Philippe Albou <contact@abstractcore.ai>
 Maintainer-email: Laurent-Philippe Albou <contact@abstractcore.ai>

{abstractcore-2.4.0.dist-info → abstractcore-2.4.1.dist-info}/RECORD

@@ -21,6 +21,8 @@ abstractcore/embeddings/__init__.py,sha256=hR3xZyqcRm4c2pq1dIa5lxj_-Bk70Zad802JQ
 abstractcore/embeddings/manager.py,sha256=QzDtSna4FDCPg1il7GGe_7p1VknuUHjXAFQa98PgU9A,50048
 abstractcore/embeddings/models.py,sha256=bsPAzL6gv57AVii8O15PT0kxfwRkOml3f3njJN4UDi4,4874
 abstractcore/events/__init__.py,sha256=UtbdTOeL05kvi7YP91yo4OEqs5UAbKylBvOOEkrUL5E,11065
+abstractcore/exceptions/__init__.py,sha256=h6y3sdZR6uFMh0iq7z85DfJi01zGQvjVOm1W7l86iVQ,3224
+abstractcore/media/__init__.py,sha256=BjWR8OIN2uxoOJBAlbM83VkyUtyDtiXM4AerYzhI9fU,4241
 abstractcore/processing/__init__.py,sha256=t6hiakQjcZROT4pw9ZFt2q6fF3vf5VpdMKG2EWlsFd8,540
 abstractcore/processing/basic_extractor.py,sha256=3x-3BdIHgLvqLnLF6K1-P4qVaLIpAnNIIutaJi7lDQM,49832
 abstractcore/processing/basic_judge.py,sha256=tKWJrg_tY4vCHzWgXxz0ZjgLXBYYfpMcpG7vl03hJcM,32218
@@ -53,10 +55,10 @@ abstractcore/utils/cli.py,sha256=8ua5Lu4bKSs9y1JB5W3kJ0OA-_dFpUHk6prH1U684xc,568
 abstractcore/utils/self_fixes.py,sha256=QEDwNTW80iQM4ftfEY3Ghz69F018oKwLM9yeRCYZOvw,5886
 abstractcore/utils/structured_logging.py,sha256=Y7TVkf1tP9BCOPNbBY1rQubBxcAxhhUOYMbrV2k50ZM,15830
 abstractcore/utils/token_utils.py,sha256=eLwFmJ68p9WMFD_MHLMmeJRW6Oqx_4hKELB8FNQ2Mnk,21097
-abstractcore/utils/version.py,sha256=IM2ECuDR2OHXGSdAqLdQib35efGRt7ZUzbD9SUnyky4,605
-abstractcore-2.4.0.dist-info/licenses/LICENSE,sha256=PI2v_4HMvd6050uDD_4AY_8PzBnu2asa3RKbdDjowTA,1078
-abstractcore-2.4.0.dist-info/METADATA,sha256=vqJTIn2uX7-YACF6DbTWCgZhDVCjMRR3VDuKf-HxdV4,19684
-abstractcore-2.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-abstractcore-2.4.0.dist-info/entry_points.txt,sha256=Ocy403YwzaOBT7D_vf7w6YFiIQ4nTbp0htjXfeI5IOo,315
-abstractcore-2.4.0.dist-info/top_level.txt,sha256=DiNHBI35SIawW3N9Z-z0y6cQYNbXd32pvBkW0RLfScs,13
-abstractcore-2.4.0.dist-info/RECORD,,
+abstractcore/utils/version.py,sha256=JrNRwMH_7TeJA9dClL5VSUDlkmqpSyPb0K4nPEHGWhM,605
+abstractcore-2.4.1.dist-info/licenses/LICENSE,sha256=PI2v_4HMvd6050uDD_4AY_8PzBnu2asa3RKbdDjowTA,1078
+abstractcore-2.4.1.dist-info/METADATA,sha256=BT2bJNHwvtFL842P1tWRYtjIaO0fIHiMiFn1QwJUviE,19684
+abstractcore-2.4.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+abstractcore-2.4.1.dist-info/entry_points.txt,sha256=Ocy403YwzaOBT7D_vf7w6YFiIQ4nTbp0htjXfeI5IOo,315
+abstractcore-2.4.1.dist-info/top_level.txt,sha256=DiNHBI35SIawW3N9Z-z0y6cQYNbXd32pvBkW0RLfScs,13
+abstractcore-2.4.1.dist-info/RECORD,,