abstractcore 2.3.8__py3-none-any.whl → 2.4.0__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
@@ -52,6 +52,18 @@ from ..processing import BasicExtractor
 from ..core.factory import create_llm
 
 
+def timeout_type(value):
+    """Parse timeout value - accepts None, 'none', or float"""
+    if value is None:
+        return None
+    if isinstance(value, str) and value.lower() == 'none':
+        return None
+    try:
+        return float(value)
+    except ValueError:
+        raise argparse.ArgumentTypeError(f"Invalid timeout value: {value}. Use 'none' for unlimited or a number in seconds.")
+
+
 def read_file_content(file_path: str) -> str:
     """
     Read content from various file types
@@ -143,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
 
@@ -295,9 +307,9 @@ Default model setup:
 
     parser.add_argument(
         '--timeout',
-        type=float,
-        default=600.0,
-        help='HTTP request timeout in seconds for LLM providers (default: 300, i.e., 5 minutes). Increase for large models like 36B+ parameters'
+        type=timeout_type,
+        default=None,
+        help='HTTP request timeout in seconds for LLM providers (default: unlimited). Use "none" for unlimited timeout or specify seconds (e.g., 600 for 10 minutes)'
     )
 
     parser.add_argument(
@@ -342,13 +354,7 @@ Default model setup:
             sys.exit(1)
 
         # Validate timeout parameter
-        if args.timeout < 30.0:
-            print("Error: Timeout must be at least 30 seconds")
-            sys.exit(1)
 
-        if args.timeout > 7200.0:  # 2 hours
-            print("Error: Timeout cannot exceed 7200 seconds (2 hours)")
-            sys.exit(1)
 
         # Validate provider/model pair
         if args.provider and not args.model:
@@ -423,7 +429,8 @@ Default model setup:
                 llm=llm,
                 max_chunk_size=adjusted_chunk_size,
                 max_tokens=args.max_tokens,
-                max_output_tokens=args.max_output_tokens
+                max_output_tokens=args.max_output_tokens,
+                timeout=args.timeout
             )
         else:
             # Default configuration
@@ -434,7 +441,8 @@ Default model setup:
                 extractor = BasicExtractor(
                     max_chunk_size=args.chunk_size,
                     max_tokens=args.max_tokens,
-                    max_output_tokens=args.max_output_tokens
+                    max_output_tokens=args.max_output_tokens,
+                    timeout=args.timeout
                 )
             except RuntimeError as e:
                 # Handle default model not available

{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,
@@ -383,9 +383,8 @@ Default model setup:
 
     parser.add_argument(
         '--timeout',
-        type=float,
-        default=300.0,
-        help='HTTP request timeout in seconds for LLM providers (default: 300)'
+        default=None,
+        help='HTTP request timeout in seconds for LLM providers (default: None = infininity)'
     )
 
     # Parse arguments
@@ -398,9 +397,6 @@ Default model setup:
             sys.exit(1)
 
         # Validate timeout
-        if args.timeout < 30.0:
-            print("Error: Timeout must be at least 30 seconds")
-            sys.exit(1)
 
         # Validate provider/model pair
         if args.provider and not args.model:

{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
 
@@ -240,6 +240,12 @@ Default model setup:
         help='Show detailed progress information'
     )
 
+    parser.add_argument(
+        '--timeout',
+        default=None,
+        help='HTTP request timeout in seconds for LLM providers (default: None = unlimited)'
+    )
+
     # Parse arguments
     args = parser.parse_args()
 
@@ -286,12 +292,13 @@ Default model setup:
             if args.verbose:
                 print(f"Initializing summarizer ({args.provider}, {args.model}, {args.max_tokens} token context, {args.max_output_tokens} output tokens)...")
 
-            llm = create_llm(args.provider, model=args.model, max_tokens=args.max_tokens, max_output_tokens=args.max_output_tokens)
+            llm = create_llm(args.provider, model=args.model, max_tokens=args.max_tokens, max_output_tokens=args.max_output_tokens, timeout=args.timeout)
             summarizer = BasicSummarizer(
                 llm, 
                 max_chunk_size=args.chunk_size,
                 max_tokens=args.max_tokens,
-                max_output_tokens=args.max_output_tokens
+                max_output_tokens=args.max_output_tokens,
+                timeout=args.timeout
             )
         else:
             # Default configuration with chunk size override
@@ -302,12 +309,13 @@ Default model setup:
                     print(f"Initializing summarizer (ollama, gemma3:1b-it-qat, {args.max_tokens} token context, {args.max_output_tokens} output tokens, {args.chunk_size} chunk size)...")
 
                 try:
-                    llm = create_llm("ollama", model="gemma3:1b-it-qat", max_tokens=args.max_tokens, max_output_tokens=args.max_output_tokens)
+                    llm = create_llm("ollama", model="gemma3:1b-it-qat", max_tokens=args.max_tokens, max_output_tokens=args.max_output_tokens, timeout=args.timeout)
                     summarizer = BasicSummarizer(
                         llm, 
                         max_chunk_size=args.chunk_size,
                         max_tokens=args.max_tokens,
-                        max_output_tokens=args.max_output_tokens
+                        max_output_tokens=args.max_output_tokens,
+                        timeout=args.timeout
                     )
                 except Exception as e:
                     # Handle default model not available
@@ -327,7 +335,8 @@ Default model setup:
                     summarizer = BasicSummarizer(
                         max_chunk_size=args.chunk_size,
                         max_tokens=args.max_tokens,
-                        max_output_tokens=args.max_output_tokens
+                        max_output_tokens=args.max_output_tokens,
+                        timeout=args.timeout
                     )
                 except RuntimeError as e:
                     # Handle default model not available

{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.

{abstractllm → abstractcore}/processing/basic_extractor.py

@@ -13,7 +13,7 @@ import json
 import logging
 from pydantic import BaseModel, Field
 
-from ..core.interface import AbstractLLMInterface
+from ..core.interface import AbstractCoreInterface
 from ..core.factory import create_llm
 from ..structured.retry import FeedbackRetry
 from ..utils.structured_logging import get_logger
@@ -50,22 +50,24 @@ class BasicExtractor:
 
     def __init__(
         self,
-        llm: Optional[AbstractLLMInterface] = None,
+        llm: Optional[AbstractCoreInterface] = None,
         max_chunk_size: int = 8000,
         max_tokens: int = 32000,
-        max_output_tokens: int = 8000
+        max_output_tokens: int = 8000,
+        timeout: Optional[float] = None
     ):
         """Initialize the extractor
         
         Args:
-            llm: AbstractLLM instance (any provider). If None, uses default Ollama model
+            llm: AbstractCore instance (any provider). If None, uses default Ollama model
             max_chunk_size: Maximum characters per chunk for long documents (default 8000)
             max_tokens: Maximum total tokens for LLM context (default 32000)
             max_output_tokens: Maximum tokens for LLM output generation (default 8000)
+            timeout: HTTP request timeout in seconds. None for unlimited timeout (default None)
         """
         if llm is None:
             try:
-                self.llm = create_llm("ollama", model="qwen3:4b-instruct-2507-q4_K_M", max_tokens=max_tokens, max_output_tokens=max_output_tokens)
+                self.llm = create_llm("ollama", model="qwen3:4b-instruct-2507-q4_K_M", max_tokens=max_tokens, max_output_tokens=max_output_tokens, timeout=timeout)
             except Exception as e:
                 error_msg = (
                     f"❌ Failed to initialize default Ollama model 'qwen3:4b-instruct-2507-q4_K_M': {e}\n\n"
@@ -77,8 +79,8 @@ class BasicExtractor:
                     "   - qwen3-coder:30b (excellent for structured output, requires 32GB RAM)\n"
                     "   - gpt-oss:120b (highest quality, requires 120GB RAM)\n\n"
                     "🔧 Alternatively, provide a custom LLM instance:\n"
-                    "   from abstractllm import create_llm\n"
-                    "   from abstractllm.processing import BasicExtractor\n"
+                    "   from abstractcore import create_llm\n"
+                    "   from abstractcore.processing import BasicExtractor\n"
                     "   \n"
                     "   llm = create_llm('openai', model='gpt-4o-mini', max_tokens=32000, max_output_tokens=8000)\n"
                     "   extractor = BasicExtractor(llm)"