agent-runtime-core 0.1.5__py3-none-any.whl → 0.3.0__py3-none-any.whl

{agent_runtime → agent_runtime_core}/__init__.py

@@ -9,7 +9,7 @@ This package provides:
 - A runner for executing agent runs
 
 Example usage:
-    from agent_runtime import (
+    from agent_runtime_core import (
         AgentRuntime,
         RunContext,
         RunResult,
@@ -34,10 +34,10 @@ Example usage:
             return RunResult(final_output={"message": "Hello!"})
 """
 
-__version__ = "0.1.5"
+__version__ = "0.3.0"
 
 # Core interfaces
-from agent_runtime.interfaces import (
+from agent_runtime_core.interfaces import (
     AgentRuntime,
     EventType,
     ErrorInfo,
@@ -54,14 +54,14 @@ from agent_runtime.interfaces import (
 )
 
 # Configuration
-from agent_runtime.config import (
+from agent_runtime_core.config import (
     RuntimeConfig,
     configure,
     get_config,
 )
 
 # Registry
-from agent_runtime.registry import (
+from agent_runtime_core.registry import (
     register_runtime,
     get_runtime,
     list_runtimes,
@@ -70,7 +70,7 @@ from agent_runtime.registry import (
 )
 
 # Runner
-from agent_runtime.runner import (
+from agent_runtime_core.runner import (
     AgentRunner,
     RunnerConfig,
     RunContextImpl,
@@ -78,7 +78,7 @@ from agent_runtime.runner import (
 
 
 # Testing utilities
-from agent_runtime.testing import (
+from agent_runtime_core.testing import (
     MockRunContext,
     MockLLMClient,
     MockLLMResponse,
@@ -87,6 +87,34 @@ from agent_runtime.testing import (
     run_agent_test,
 )
 
+# Persistence (memory, conversations, tasks, preferences)
+from agent_runtime_core.persistence import (
+    # Abstract interfaces
+    MemoryStore,
+    ConversationStore,
+    TaskStore,
+    PreferencesStore,
+    Scope,
+    # Data classes
+    Conversation,
+    ConversationMessage,
+    ToolCall,
+    ToolResult,
+    TaskList,
+    Task,
+    TaskState,
+    # File implementations
+    FileMemoryStore,
+    FileConversationStore,
+    FileTaskStore,
+    FilePreferencesStore,
+    # Manager
+    PersistenceManager,
+    PersistenceConfig,
+    get_persistence_manager,
+    configure_persistence,
+)
+
 __all__ = [
     # Version
     "__version__",
@@ -125,4 +153,28 @@ __all__ = [
     "LLMEvaluator",
     "create_test_context",
     "run_agent_test",
+    # Persistence - Abstract interfaces
+    "MemoryStore",
+    "ConversationStore",
+    "TaskStore",
+    "PreferencesStore",
+    "Scope",
+    # Persistence - Data classes
+    "Conversation",
+    "ConversationMessage",
+    "ToolCall",
+    "ToolResult",
+    "TaskList",
+    "Task",
+    "TaskState",
+    # Persistence - File implementations
+    "FileMemoryStore",
+    "FileConversationStore",
+    "FileTaskStore",
+    "FilePreferencesStore",
+    # Persistence - Manager
+    "PersistenceManager",
+    "PersistenceConfig",
+    "get_persistence_manager",
+    "configure_persistence",
 ]

{agent_runtime → agent_runtime_core}/config.py

@@ -84,7 +84,7 @@ def configure(**kwargs) -> RuntimeConfig:
         The configured RuntimeConfig instance
         
     Example:
-        from agent_runtime import configure
+        from agent_runtime_core import configure
         
         configure(
             model_provider="openai",

{agent_runtime → agent_runtime_core}/events/__init__.py

@@ -9,8 +9,8 @@ Provides:
 - SQLiteEventBus: For persistent local storage
 """
 
-from agent_runtime.events.base import EventBus, Event
-from agent_runtime.events.memory import InMemoryEventBus
+from agent_runtime_core.events.base import EventBus, Event
+from agent_runtime_core.events.memory import InMemoryEventBus
 
 __all__ = [
     "EventBus",
@@ -31,7 +31,7 @@ def get_event_bus(backend: str = None, **kwargs) -> EventBus:
     Returns:
         EventBus instance
     """
-    from agent_runtime.config import get_config
+    from agent_runtime_core.config import get_config
     
     config = get_config()
     backend = backend or config.event_bus_backend
@@ -40,14 +40,14 @@ def get_event_bus(backend: str = None, **kwargs) -> EventBus:
         return InMemoryEventBus()
     
     elif backend == "redis":
-        from agent_runtime.events.redis import RedisEventBus
+        from agent_runtime_core.events.redis import RedisEventBus
         url = kwargs.get("url") or config.redis_url
         if not url:
             raise ValueError("redis_url is required for redis event bus backend")
         return RedisEventBus(url=url, **kwargs)
     
     elif backend == "sqlite":
-        from agent_runtime.events.sqlite import SQLiteEventBus
+        from agent_runtime_core.events.sqlite import SQLiteEventBus
         path = kwargs.get("path") or config.sqlite_path or "agent_runtime.db"
         return SQLiteEventBus(path=path)
     

{agent_runtime → agent_runtime_core}/events/memory.py

@@ -13,7 +13,7 @@ from datetime import datetime, timezone
 from typing import AsyncIterator, Optional
 from uuid import UUID
 
-from agent_runtime.events.base import EventBus, Event
+from agent_runtime_core.events.base import EventBus, Event
 
 
 class InMemoryEventBus(EventBus):

{agent_runtime → agent_runtime_core}/events/redis.py

@@ -12,7 +12,7 @@ import json
 from typing import AsyncIterator, Optional
 from uuid import UUID
 
-from agent_runtime.events.base import EventBus, Event
+from agent_runtime_core.events.base import EventBus, Event
 
 
 class RedisEventBus(EventBus):

{agent_runtime → agent_runtime_core}/events/sqlite.py

@@ -15,7 +15,7 @@ from datetime import datetime, timezone
 from typing import AsyncIterator, Optional
 from uuid import UUID
 
-from agent_runtime.events.base import EventBus, Event
+from agent_runtime_core.events.base import EventBus, Event
 
 
 class SQLiteEventBus(EventBus):

{agent_runtime → agent_runtime_core}/llm/__init__.py

@@ -8,7 +8,7 @@ Provides:
 - LiteLLMClient: LiteLLM adapter (optional)
 """
 
-from agent_runtime.interfaces import LLMClient, LLMResponse, LLMStreamChunk
+from agent_runtime_core.interfaces import LLMClient, LLMResponse, LLMStreamChunk
 
 __all__ = [
     "LLMClient",
@@ -48,7 +48,7 @@ def get_llm_client(provider: str = None, **kwargs) -> LLMClient:
         
     Example:
         # Using config (recommended)
-        from agent_runtime.config import configure
+        from agent_runtime_core.config import configure
         configure(model_provider="openai", openai_api_key="sk-...")
         llm = get_llm_client()
         
@@ -58,21 +58,21 @@ def get_llm_client(provider: str = None, **kwargs) -> LLMClient:
         # Or with a different provider
         llm = get_llm_client(provider='anthropic', api_key='sk-ant-...')
     """
-    from agent_runtime.config import get_config
+    from agent_runtime_core.config import get_config
 
     config = get_config()
     provider = provider or config.model_provider
 
     if provider == "openai":
-        from agent_runtime.llm.openai import OpenAIClient
+        from agent_runtime_core.llm.openai import OpenAIClient
         return OpenAIClient(**kwargs)
 
     elif provider == "anthropic":
-        from agent_runtime.llm.anthropic import AnthropicClient
+        from agent_runtime_core.llm.anthropic import AnthropicClient
         return AnthropicClient(**kwargs)
 
     elif provider == "litellm":
-        from agent_runtime.llm.litellm_client import LiteLLMClient
+        from agent_runtime_core.llm.litellm_client import LiteLLMClient
         return LiteLLMClient(**kwargs)
 
     else:

{agent_runtime → agent_runtime_core}/llm/anthropic.py

@@ -5,7 +5,7 @@ Anthropic API client implementation.
 import os
 from typing import AsyncIterator, Optional
 
-from agent_runtime.interfaces import (
+from agent_runtime_core.interfaces import (
     LLMClient,
     LLMResponse,
     LLMStreamChunk,
@@ -43,7 +43,7 @@ class AnthropicClient(LLMClient):
                 "Install it with: pip install agent-runtime-core[anthropic]"
             )
 
-        from agent_runtime.config import get_config
+        from agent_runtime_core.config import get_config
         config = get_config()
         
         self.default_model = default_model or config.default_model or "claude-sonnet-4-20250514"
@@ -56,7 +56,7 @@ class AnthropicClient(LLMClient):
                 "Anthropic API key is not configured.\n\n"
                 "Configure it using one of these methods:\n"
                 "  1. Use configure():\n"
-                "     from agent_runtime.config import configure\n"
+                "     from agent_runtime_core.config import configure\n"
                 "     configure(anthropic_api_key='sk-ant-...')\n\n"
                 "  2. Set the ANTHROPIC_API_KEY environment variable:\n"
                 "     export ANTHROPIC_API_KEY='sk-ant-...'\n\n"
@@ -81,7 +81,7 @@ class AnthropicClient(LLMClient):
         if explicit_key:
             return explicit_key
         
-        from agent_runtime.config import get_config
+        from agent_runtime_core.config import get_config
         config = get_config()
         settings_key = config.get_anthropic_api_key()
         if settings_key:

{agent_runtime → agent_runtime_core}/llm/litellm_client.py

@@ -7,7 +7,7 @@ This is an OPTIONAL adapter - the core runtime doesn't depend on it.
 
 from typing import AsyncIterator, Optional
 
-from agent_runtime.interfaces import (
+from agent_runtime_core.interfaces import (
     LLMClient,
     LLMResponse,
     LLMStreamChunk,
@@ -41,7 +41,7 @@ class LiteLLMClient(LLMClient):
                 "Install it with: pip install agent-runtime-core[litellm]"
             )
 
-        from agent_runtime.config import get_config
+        from agent_runtime_core.config import get_config
         config = get_config()
         
         self.default_model = default_model or config.default_model or "gpt-4o"

{agent_runtime → agent_runtime_core}/llm/openai.py

@@ -5,7 +5,7 @@ OpenAI API client implementation.
 import os
 from typing import AsyncIterator, Optional
 
-from agent_runtime.interfaces import (
+from agent_runtime_core.interfaces import (
     LLMClient,
     LLMResponse,
     LLMStreamChunk,
@@ -45,7 +45,7 @@ class OpenAIClient(LLMClient):
                 "Install it with: pip install agent-runtime-core[openai]"
             )
 
-        from agent_runtime.config import get_config
+        from agent_runtime_core.config import get_config
         config = get_config()
         
         self.default_model = default_model or config.default_model
@@ -66,7 +66,7 @@ class OpenAIClient(LLMClient):
                     "OpenAI API key is not configured.\n\n"
                     "Configure it using one of these methods:\n"
                     "  1. Use configure():\n"
-                    "     from agent_runtime.config import configure\n"
+                    "     from agent_runtime_core.config import configure\n"
                     "     configure(openai_api_key='sk-...')\n\n"
                     "  2. Set the OPENAI_API_KEY environment variable:\n"
                     "     export OPENAI_API_KEY='sk-...'\n\n"
@@ -87,7 +87,7 @@ class OpenAIClient(LLMClient):
         if explicit_key:
             return explicit_key
         
-        from agent_runtime.config import get_config
+        from agent_runtime_core.config import get_config
         config = get_config()
         settings_key = config.get_openai_api_key()
         if settings_key:

agent_runtime_core/persistence/__init__.py

@@ -0,0 +1,88 @@
+"""
+Persistence module for agent state, memory, and conversation history.
+
+This module provides pluggable storage backends for:
+- Memory (global and project-scoped key-value storage)
+- Conversation history (full conversation state including tool calls)
+- Task state (task lists and progress)
+- Preferences (user and agent configuration)
+
+Example usage:
+    from agent_runtime_core.persistence import (
+        MemoryStore,
+        ConversationStore,
+        FileMemoryStore,
+        FileConversationStore,
+        PersistenceManager,
+        Scope,
+    )
+    
+    # Use the high-level manager
+    manager = PersistenceManager()
+    
+    # Store global memory
+    await manager.memory.set("user_name", "Alice", scope=Scope.GLOBAL)
+    
+    # Store project-specific memory
+    await manager.memory.set("project_type", "python", scope=Scope.PROJECT)
+    
+    # Save a conversation
+    await manager.conversations.save(conversation)
+"""
+
+from agent_runtime_core.persistence.base import (
+    MemoryStore,
+    ConversationStore,
+    TaskStore,
+    PreferencesStore,
+    Scope,
+    Conversation,
+    ConversationMessage,
+    ToolCall,
+    ToolResult,
+    TaskList,
+    Task,
+    TaskState,
+)
+
+from agent_runtime_core.persistence.file import (
+    FileMemoryStore,
+    FileConversationStore,
+    FileTaskStore,
+    FilePreferencesStore,
+)
+
+from agent_runtime_core.persistence.manager import (
+    PersistenceManager,
+    PersistenceConfig,
+    get_persistence_manager,
+    configure_persistence,
+)
+
+__all__ = [
+    # Abstract interfaces
+    "MemoryStore",
+    "ConversationStore",
+    "TaskStore",
+    "PreferencesStore",
+    "Scope",
+    # Data classes
+    "Conversation",
+    "ConversationMessage",
+    "ToolCall",
+    "ToolResult",
+    "TaskList",
+    "Task",
+    "TaskState",
+    # File implementations
+    "FileMemoryStore",
+    "FileConversationStore",
+    "FileTaskStore",
+    "FilePreferencesStore",
+    # Manager
+    "PersistenceManager",
+    "PersistenceConfig",
+    "get_persistence_manager",
+    "configure_persistence",
+]
+