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

{abstractllm → abstractcore}/__init__.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-AbstractLLM - Unified interface to all LLM providers with essential infrastructure.
+AbstractCore - Unified interface to all LLM providers with essential infrastructure.
 
 Key Features:
 • Multi-provider support (OpenAI, Anthropic, Ollama, HuggingFace, MLX, LMStudio)
@@ -11,7 +11,7 @@ Key Features:
 • Event system for observability
 
 Quick Start:
-    from abstractllm import create_llm
+    from abstractcore import create_llm
 
     # Unified token management across all providers
     llm = create_llm(

abstractcore/apps/__init__.py

@@ -0,0 +1 @@
+# AbstractCore CLI Applications

{abstractllm → abstractcore}/apps/__main__.py

@@ -1,9 +1,9 @@
 #!/usr/bin/env python3
 """
-AbstractLLM Apps - Command-line interface launcher
+AbstractCore Apps - Command-line interface launcher
 
 Usage:
-    python -m abstractllm.apps <app_name> [options]
+    python -m abstractcore.apps <app_name> [options]
 
 Available apps:
     summarizer    - Document summarization tool
@@ -11,10 +11,10 @@ Available apps:
     judge         - Text evaluation and scoring tool
 
 Examples:
-    python -m abstractllm.apps summarizer document.txt
-    python -m abstractllm.apps extractor report.txt --format json-ld
-    python -m abstractllm.apps judge essay.txt --criteria clarity,accuracy
-    python -m abstractllm.apps <app> --help
+    python -m abstractcore.apps summarizer document.txt
+    python -m abstractcore.apps extractor report.txt --format json-ld
+    python -m abstractcore.apps judge essay.txt --criteria clarity,accuracy
+    python -m abstractcore.apps <app> --help
 """
 
 import sys

{abstractllm → abstractcore}/apps/extractor.py

@@ -1,9 +1,9 @@
 #!/usr/bin/env python3
 """
-AbstractLLM Entity Extractor CLI Application
+AbstractCore Entity Extractor CLI Application
 
 Usage:
-    python -m abstractllm.apps.extractor <file_path> [options]
+    python -m abstractcore.apps.extractor <file_path> [options]
 
 Options:
     --focus <focus>             Specific focus area for extraction (e.g., "technology", "business", "medical")
@@ -27,12 +27,12 @@ Options:
     --help                      Show this help message
 
 Examples:
-    python -m abstractllm.apps.extractor document.pdf
-    python -m abstractllm.apps.extractor report.txt --focus technology --style structured --verbose
-    python -m abstractllm.apps.extractor data.md --entity-types person,organization --output kg.jsonld
-    python -m abstractllm.apps.extractor large.txt --fast --minified --verbose  # Fast, compact output
-    python -m abstractllm.apps.extractor report.txt --length detailed --provider openai --model gpt-4o-mini
-    python -m abstractllm.apps.extractor doc.txt --iterate 3 --verbose  # 3 refinement passes for higher quality
+    python -m abstractcore.apps.extractor document.pdf
+    python -m abstractcore.apps.extractor report.txt --focus technology --style structured --verbose
+    python -m abstractcore.apps.extractor data.md --entity-types person,organization --output kg.jsonld
+    python -m abstractcore.apps.extractor large.txt --fast --minified --verbose  # Fast, compact output
+    python -m abstractcore.apps.extractor report.txt --length detailed --provider openai --model gpt-4o-mini
+    python -m abstractcore.apps.extractor doc.txt --iterate 3 --verbose  # 3 refinement passes for higher quality
 """
 
 import argparse
@@ -155,17 +155,17 @@ def parse_extraction_length(length_str: Optional[str]) -> str:
 def main():
     """Main CLI function"""
     parser = argparse.ArgumentParser(
-        description="AbstractLLM Entity & Relationship Extractor - Default: qwen3:4b-instruct-2507-q4_K_M (requires Ollama)",
+        description="AbstractCore Entity & Relationship Extractor - Default: qwen3:4b-instruct-2507-q4_K_M (requires Ollama)",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
-  python -m abstractllm.apps.extractor document.pdf
-  python -m abstractllm.apps.extractor report.txt --focus=technology --style=structured --verbose
-  python -m abstractllm.apps.extractor data.md --entity-types=person,organization --output=kg.jsonld
-  python -m abstractllm.apps.extractor large.txt --length=detailed --fast --minified --verbose
-  python -m abstractllm.apps.extractor doc.txt --iterate=3 --verbose  # Iterative refinement for quality
-  python -m abstractllm.apps.extractor doc.txt --format=triples --verbose  # RDF triples output
-  python -m abstractllm.apps.extractor doc.txt --format=triples --output=triples.txt  # Simple triples
+  python -m abstractcore.apps.extractor document.pdf
+  python -m abstractcore.apps.extractor report.txt --focus=technology --style=structured --verbose
+  python -m abstractcore.apps.extractor data.md --entity-types=person,organization --output=kg.jsonld
+  python -m abstractcore.apps.extractor large.txt --length=detailed --fast --minified --verbose
+  python -m abstractcore.apps.extractor doc.txt --iterate=3 --verbose  # Iterative refinement for quality
+  python -m abstractcore.apps.extractor doc.txt --format=triples --verbose  # RDF triples output
+  python -m abstractcore.apps.extractor doc.txt --format=triples --output=triples.txt  # Simple triples
 
 Supported file types: .txt, .md, .py, .js, .html, .json, .csv, and most text-based files
 

{abstractllm → abstractcore}/apps/judge.py

@@ -1,9 +1,9 @@
 #!/usr/bin/env python3
 """
-AbstractLLM Basic Judge CLI Application
+AbstractCore Basic Judge CLI Application
 
 Usage:
-    python -m abstractllm.apps.judge <file_path_or_text> [file2] [file3] ... [options]
+    python -m abstractcore.apps.judge <file_path_or_text> [file2] [file3] ... [options]
 
 Options:
     --context <context>             Evaluation context description (e.g., "code review", "documentation assessment")
@@ -25,18 +25,18 @@ Options:
 
 Examples:
     # Single file or text
-    python -m abstractllm.apps.judge "This code is well-structured and solves the problem efficiently."
-    python -m abstractllm.apps.judge document.py --context "code review" --criteria clarity,soundness,effectiveness
+    python -m abstractcore.apps.judge "This code is well-structured and solves the problem efficiently."
+    python -m abstractcore.apps.judge document.py --context "code review" --criteria clarity,soundness,effectiveness
 
     # Multiple files (evaluated sequentially to avoid context overflow)
-    python -m abstractllm.apps.judge file1.py file2.py file3.py --context "code review" --output assessments.json
-    python -m abstractllm.apps.judge *.py --context "Python code review" --format plain
-    python -m abstractllm.apps.judge docs/*.md --context "documentation review" --criteria clarity,completeness
+    python -m abstractcore.apps.judge file1.py file2.py file3.py --context "code review" --output assessments.json
+    python -m abstractcore.apps.judge *.py --context "Python code review" --format plain
+    python -m abstractcore.apps.judge docs/*.md --context "documentation review" --criteria clarity,completeness
 
     # Other options
-    python -m abstractllm.apps.judge proposal.md --focus "technical accuracy,completeness,examples" --output assessment.json
-    python -m abstractllm.apps.judge content.txt --reference ideal_solution.txt --format plain --verbose
-    python -m abstractllm.apps.judge text.md --provider openai --model gpt-4o-mini --temperature 0.05
+    python -m abstractcore.apps.judge proposal.md --focus "technical accuracy,completeness,examples" --output assessment.json
+    python -m abstractcore.apps.judge content.txt --reference ideal_solution.txt --format plain --verbose
+    python -m abstractcore.apps.judge text.md --provider openai --model gpt-4o-mini --temperature 0.05
 """
 
 import argparse
@@ -250,22 +250,22 @@ def format_assessment_plain(assessment: dict) -> str:
 def main():
     """Main CLI function"""
     parser = argparse.ArgumentParser(
-        description="AbstractLLM Basic Judge - LLM-as-a-judge for objective evaluation (Default: qwen3:4b-instruct-2507-q4_K_M)",
+        description="AbstractCore Basic Judge - LLM-as-a-judge for objective evaluation (Default: qwen3:4b-instruct-2507-q4_K_M)",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
   # Single file or text
-  python -m abstractllm.apps.judge "This code is well-structured."
-  python -m abstractllm.apps.judge document.py --context "code review" --criteria clarity,soundness
-  python -m abstractllm.apps.judge proposal.md --focus "technical accuracy,examples" --output assessment.json
+  python -m abstractcore.apps.judge "This code is well-structured."
+  python -m abstractcore.apps.judge document.py --context "code review" --criteria clarity,soundness
+  python -m abstractcore.apps.judge proposal.md --focus "technical accuracy,examples" --output assessment.json
 
   # Multiple files (evaluated sequentially)
-  python -m abstractllm.apps.judge file1.py file2.py file3.py --context "code review" --format json
-  python -m abstractllm.apps.judge docs/*.md --context "documentation review" --format plain
+  python -m abstractcore.apps.judge file1.py file2.py file3.py --context "code review" --format json
+  python -m abstractcore.apps.judge docs/*.md --context "documentation review" --format plain
 
   # Other options
-  python -m abstractllm.apps.judge content.txt --reference ideal.txt --format plain --verbose
-  python -m abstractllm.apps.judge text.md --provider openai --model gpt-4o-mini
+  python -m abstractcore.apps.judge content.txt --reference ideal.txt --format plain --verbose
+  python -m abstractcore.apps.judge text.md --provider openai --model gpt-4o-mini
 
 Available criteria:
   clarity, simplicity, actionability, soundness, innovation, effectiveness,

{abstractllm → abstractcore}/apps/summarizer.py

@@ -1,9 +1,9 @@
 #!/usr/bin/env python3
 """
-AbstractLLM Summarizer CLI Application
+AbstractCore Summarizer CLI Application
 
 Usage:
-    python -m abstractllm.apps.summarizer <file_path> [options]
+    python -m abstractcore.apps.summarizer <file_path> [options]
 
 Options:
     --style <style>         Summary style (structured, narrative, objective, analytical, executive, conversational)
@@ -19,10 +19,10 @@ Options:
     --help                 Show this help message
 
 Examples:
-    python -m abstractllm.apps.summarizer document.pdf
-    python -m abstractllm.apps.summarizer report.txt --style executive --length brief --verbose
-    python -m abstractllm.apps.summarizer data.md --focus "technical details" --output summary.txt
-    python -m abstractllm.apps.summarizer large.txt --chunk-size 15000 --provider openai --model gpt-4o-mini
+    python -m abstractcore.apps.summarizer document.pdf
+    python -m abstractcore.apps.summarizer report.txt --style executive --length brief --verbose
+    python -m abstractcore.apps.summarizer data.md --focus "technical details" --output summary.txt
+    python -m abstractcore.apps.summarizer large.txt --chunk-size 15000 --provider openai --model gpt-4o-mini
 """
 
 import argparse
@@ -156,14 +156,14 @@ def format_summary_output(result) -> str:
 def main():
     """Main CLI function"""
     parser = argparse.ArgumentParser(
-        description="AbstractLLM Document Summarizer - Default: gemma3:1b-it-qat (requires Ollama)",
+        description="AbstractCore Document Summarizer - Default: gemma3:1b-it-qat (requires Ollama)",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
-  python -m abstractllm.apps.summarizer document.pdf
-  python -m abstractllm.apps.summarizer report.txt --style executive --length brief --verbose
-  python -m abstractllm.apps.summarizer data.md --focus "technical details" --output summary.txt
-  python -m abstractllm.apps.summarizer large.txt --chunk-size 15000 --provider openai --model gpt-4o-mini
+  python -m abstractcore.apps.summarizer document.pdf
+  python -m abstractcore.apps.summarizer report.txt --style executive --length brief --verbose
+  python -m abstractcore.apps.summarizer data.md --focus "technical details" --output summary.txt
+  python -m abstractcore.apps.summarizer large.txt --chunk-size 15000 --provider openai --model gpt-4o-mini
 
 Supported file types: .txt, .md, .py, .js, .html, .json, .csv, and most text-based files
 

{abstractllm → abstractcore}/core/__init__.py

@@ -12,7 +12,7 @@ from .factory import create_llm
 from .session import BasicSession
 from .types import GenerateResponse, Message
 from .enums import ModelParameter, ModelCapability, MessageRole
-from .interface import AbstractLLMInterface
+from .interface import AbstractCoreInterface
 
 __all__ = [
     'create_llm',
@@ -22,5 +22,5 @@ __all__ = [
     'ModelParameter',
     'ModelCapability',
     'MessageRole',
-    'AbstractLLMInterface'
+    'AbstractCoreInterface'
 ]

{abstractllm → abstractcore}/core/enums.py

@@ -1,5 +1,5 @@
 """
-Enums for AbstractLLM.
+Enums for AbstractCore.
 """
 
 from enum import Enum

{abstractllm → abstractcore}/core/factory.py

@@ -3,11 +3,11 @@ Factory for creating LLM providers.
 """
 
 from typing import Optional
-from .interface import AbstractLLMInterface
+from .interface import AbstractCoreInterface
 from ..exceptions import ModelNotFoundError, AuthenticationError, ProviderAPIError
 
 
-def create_llm(provider: str, model: Optional[str] = None, **kwargs) -> AbstractLLMInterface:
+def create_llm(provider: str, model: Optional[str] = None, **kwargs) -> AbstractCoreInterface:
     """
     Create an LLM provider instance with unified token parameter support.
 
@@ -16,7 +16,7 @@ def create_llm(provider: str, model: Optional[str] = None, **kwargs) -> Abstract
         model: Model name (optional, will use provider default)
         **kwargs: Additional configuration including token parameters
 
-    Token Parameters (AbstractLLM Unified Standard):
+    Token Parameters (AbstractCore Unified Standard):
         max_tokens: Total context window budget (input + output combined)
         max_output_tokens: Maximum tokens reserved for generation (default: 2048)
         max_input_tokens: Maximum tokens for input (auto-calculated if not specified)
@@ -75,7 +75,7 @@ def create_llm(provider: str, model: Optional[str] = None, **kwargs) -> Abstract
             from ..providers.openai_provider import OpenAIProvider
             return OpenAIProvider(model=model or "gpt-5-nano-2025-08-07", **kwargs)
         except ImportError:
-            raise ImportError("OpenAI dependencies not installed. Install with: pip install abstractllm[openai]")
+            raise ImportError("OpenAI dependencies not installed. Install with: pip install abstractcore[openai]")
         except (ModelNotFoundError, AuthenticationError, ProviderAPIError) as e:
             # Re-raise provider exceptions cleanly
             raise e
@@ -85,7 +85,7 @@ def create_llm(provider: str, model: Optional[str] = None, **kwargs) -> Abstract
             from ..providers.anthropic_provider import AnthropicProvider
             return AnthropicProvider(model=model or "claude-3-5-haiku-latest", **kwargs)
         except ImportError:
-            raise ImportError("Anthropic dependencies not installed. Install with: pip install abstractllm[anthropic]")
+            raise ImportError("Anthropic dependencies not installed. Install with: pip install abstractcore[anthropic]")
         except (ModelNotFoundError, AuthenticationError, ProviderAPIError) as e:
             # Re-raise provider exceptions cleanly
             raise e
@@ -95,21 +95,21 @@ def create_llm(provider: str, model: Optional[str] = None, **kwargs) -> Abstract
             from ..providers.ollama_provider import OllamaProvider
             return OllamaProvider(model=model or "qwen3-coder:30b", **kwargs)
         except ImportError:
-            raise ImportError("Ollama dependencies not installed. Install with: pip install abstractllm[ollama]")
+            raise ImportError("Ollama dependencies not installed. Install with: pip install abstractcore[ollama]")
 
     elif provider.lower() == "huggingface":
         try:
             from ..providers.huggingface_provider import HuggingFaceProvider
             return HuggingFaceProvider(model=model or "Qwen/Qwen3-4B/", **kwargs)
         except ImportError:
-            raise ImportError("HuggingFace dependencies not installed. Install with: pip install abstractllm[huggingface]")
+            raise ImportError("HuggingFace dependencies not installed. Install with: pip install abstractcore[huggingface]")
 
     elif provider.lower() == "mlx":
         try:
             from ..providers.mlx_provider import MLXProvider
             return MLXProvider(model=model or "mlx-community/Qwen3-4B", **kwargs)
         except ImportError:
-            raise ImportError("MLX dependencies not installed. Install with: pip install abstractllm[mlx]")
+            raise ImportError("MLX dependencies not installed. Install with: pip install abstractcore[mlx]")
 
     elif provider.lower() == "lmstudio":
         try:

{abstractllm → abstractcore}/core/interface.py

@@ -7,11 +7,11 @@ from typing import List, Dict, Any, Optional, Union, Iterator
 from .types import GenerateResponse, Message
 
 
-class AbstractLLMInterface(ABC):
+class AbstractCoreInterface(ABC):
     """
     Abstract base class for all LLM providers.
 
-    AbstractLLM Token Parameter Vocabulary (Unified Standard):
+    AbstractCore Token Parameter Vocabulary (Unified Standard):
     =========================================================
 
     • max_tokens: Total context window budget (input + output combined) - YOUR BUDGET
@@ -57,7 +57,7 @@ class AbstractLLMInterface(ABC):
 
     Provider Abstraction:
     ===================
-    AbstractLLM handles provider-specific parameter mapping internally:
+    AbstractCore handles provider-specific parameter mapping internally:
     • OpenAI: max_tokens → max_completion_tokens (o1 models) or max_tokens (others)
     • Anthropic: max_output_tokens → max_tokens (output-focused API)
     • Google: max_output_tokens → max_output_tokens (direct mapping)

{abstractllm → abstractcore}/core/retry.py

@@ -1,5 +1,5 @@
 """
-Production-ready retry strategies for AbstractLLM Core.
+Production-ready retry strategies for AbstractCore.
 
 Implements SOTA exponential backoff with jitter and circuit breaker patterns
 based on 2025 best practices from AWS Architecture Blog, Tenacity principles,

{abstractllm → abstractcore}/core/session.py

@@ -10,7 +10,7 @@ import json
 import uuid
 from collections.abc import Generator
 
-from .interface import AbstractLLMInterface
+from .interface import AbstractCoreInterface
 from .types import GenerateResponse, Message
 from .enums import MessageRole
 
@@ -25,7 +25,7 @@ class BasicSession:
     """
 
     def __init__(self,
-                 provider: Optional[AbstractLLMInterface] = None,
+                 provider: Optional[AbstractCoreInterface] = None,
                  system_prompt: Optional[str] = None,
                  tools: Optional[List[Callable]] = None,
                  timeout: Optional[float] = None,
@@ -255,7 +255,7 @@ class BasicSession:
             json.dump(data, f, indent=2)
 
     @classmethod
-    def load(cls, filepath: Union[str, Path], provider: Optional[AbstractLLMInterface] = None,
+    def load(cls, filepath: Union[str, Path], provider: Optional[AbstractCoreInterface] = None,
              tools: Optional[List[Callable]] = None) -> 'BasicSession':
         """
         Load session from file with complete metadata restoration.
@@ -325,7 +325,7 @@ class BasicSession:
         }
 
     @classmethod
-    def from_dict(cls, data: Dict[str, Any], provider: Optional[AbstractLLMInterface] = None, 
+    def from_dict(cls, data: Dict[str, Any], provider: Optional[AbstractCoreInterface] = None, 
                   tools: Optional[List[Callable]] = None) -> 'BasicSession':
         """
         Create session from dictionary data (supports both new archive format and legacy format).
@@ -429,7 +429,7 @@ class BasicSession:
     def compact(self,
                 preserve_recent: int = 6,
                 focus: Optional[str] = None,
-                compact_provider: Optional[AbstractLLMInterface] = None,
+                compact_provider: Optional[AbstractCoreInterface] = None,
                 reason: str = "manual") -> 'BasicSession':
         """
         Compact chat history using SOTA 2025 best practices for conversation summarization.
@@ -675,7 +675,7 @@ class BasicSession:
         print(f"✅ Session compacted: {len(compacted.messages)} messages, ~{compacted.get_token_estimate()} tokens")
 
     def generate_summary(self, preserve_recent: int = 6, focus: Optional[str] = None, 
-                        compact_provider: Optional[AbstractLLMInterface] = None) -> Dict[str, Any]:
+                        compact_provider: Optional[AbstractCoreInterface] = None) -> Dict[str, Any]:
         """
         Generate a summary of the entire conversation and store it in session.summary.
         

{abstractllm → abstractcore}/core/types.py

@@ -1,5 +1,5 @@
 """
-Core types for AbstractLLM.
+Core types for AbstractCore.
 """
 
 from typing import Optional, Dict, List, Any

{abstractllm → abstractcore}/embeddings/__init__.py

@@ -1,5 +1,5 @@
 """
-Vector Embeddings for AbstractLLM Core
+Vector Embeddings for AbstractCore
 =====================================
 
 Provides efficient text embedding with SOTA open-source models.

{abstractllm → abstractcore}/embeddings/manager.py

@@ -44,7 +44,7 @@ def _suppress_onnx_warnings():
     This suppresses the CoreML and node assignment warnings commonly seen on macOS.
     These warnings are informational only and don't impact performance or quality.
     
-    To enable verbose ONNX logging for debugging, set: ABSTRACTLLM_ONNX_VERBOSE=1
+    To enable verbose ONNX logging for debugging, set: ABSTRACTCORE_ONNX_VERBOSE=1
     """
     with warnings.catch_warnings():
         # Suppress PyTorch ONNX registration warnings (harmless in PyTorch 2.8+)
@@ -73,8 +73,8 @@ def _suppress_onnx_warnings():
             import os
             
             # Allow users to enable verbose ONNX logging for debugging
-            # Set ABSTRACTLLM_ONNX_VERBOSE=1 to see ONNX warnings for debugging
-            if os.environ.get("ABSTRACTLLM_ONNX_VERBOSE", "0") != "1":
+            # Set ABSTRACTCORE_ONNX_VERBOSE=1 to see ONNX warnings for debugging
+            if os.environ.get("ABSTRACTCORE_ONNX_VERBOSE", "0") != "1":
                 # Suppress the CoreML and node assignment warnings you may see on macOS
                 # These are harmless informational messages that don't affect performance or quality:
                 # - CoreML partitioning warnings: Normal behavior when model ops aren't all CoreML-compatible
@@ -132,7 +132,7 @@ class EmbeddingManager:
             model: Model identifier (HuggingFace model ID for HF provider, model name for others).
             provider: Embedding provider ('huggingface', 'ollama', 'lmstudio'). Defaults to 'huggingface'.
             backend: Inference backend for HuggingFace ('auto', 'pytorch', 'onnx', 'openvino')
-            cache_dir: Directory for persistent cache. Defaults to ~/.abstractllm/embeddings
+            cache_dir: Directory for persistent cache. Defaults to ~/.abstractcore/embeddings
             cache_size: Maximum number of embeddings to cache in memory
             output_dims: Output dimensions for Matryoshka truncation (if supported by provider)
             trust_remote_code: Whether to trust remote code (HuggingFace only)
@@ -193,7 +193,7 @@ class EmbeddingManager:
                 logger.info(f"Initialized LMStudio embedding provider with model: {model}")
 
         # Common setup for all providers
-        self.cache_dir = Path(cache_dir) if cache_dir else Path.home() / ".abstractllm" / "embeddings"
+        self.cache_dir = Path(cache_dir) if cache_dir else Path.home() / ".abstractcore" / "embeddings"
         self.cache_dir.mkdir(parents=True, exist_ok=True)
         self.cache_size = cache_size
         self.output_dims = output_dims

{abstractllm → abstractcore}/events/__init__.py

@@ -1,5 +1,5 @@
 """
-Event system for AbstractLLM - OpenTelemetry compatible.
+Event system for AbstractCore - OpenTelemetry compatible.
 
 This module provides a comprehensive event system for tracking LLM operations,
 including generation, tool calls, structured output, and performance metrics.

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'
+]