slide-narrator 0.2.2__py3-none-any.whl → 0.4.0__py3-none-any.whl

narrator/__init__.py

@@ -8,7 +8,7 @@ from .models.thread import Thread
 from .models.message import Message
 from .models.attachment import Attachment
 
-__version__ = "0.2.2"
+__version__ = "0.4.0"
 __all__ = [
     "ThreadStore",
     "FileStore", 

narrator/database/storage_backend.py

@@ -1,6 +1,6 @@
 """Storage backend implementations for ThreadStore."""
 from abc import ABC, abstractmethod
-from typing import List, Optional, Dict, Any
+from typing import List, Optional, Dict, Any, Union
 from datetime import datetime, UTC
 import json
 import os
@@ -64,7 +64,7 @@ class StorageBackend(ABC):
         pass
 
     @abstractmethod
-    async def find_messages_by_attribute(self, path: str, value: Any) -> List[MessageRecord]:
+    async def find_messages_by_attribute(self, path: str, value: Any) -> Union[List[Message], List[MessageRecord]]:
         """
         Find messages that have a specific attribute at a given JSON path.
         Uses efficient SQL JSON path queries for PostgreSQL and falls back to
@@ -138,7 +138,7 @@ class MemoryBackend(StorageBackend):
             threads = threads[:limit]
         return threads
 
-    async def find_messages_by_attribute(self, path: str, value: Any) -> List[MessageRecord]:
+    async def find_messages_by_attribute(self, path: str, value: Any) -> List[Message]:
         """
         Check if any messages exist with a specific attribute at a given JSON path.
         
@@ -147,7 +147,7 @@ class MemoryBackend(StorageBackend):
             value: The value to search for
             
         Returns:
-            True if any messages match, False otherwise
+            List of messages matching the criteria (possibly empty)
         """
         # Traverse all threads and messages
         for thread in self._threads.values():
@@ -166,7 +166,9 @@ class MemoryBackend(StorageBackend):
                 
                 # Check if we found a match
                 if current == value:
-                    return [self._create_message_record(message, thread.id, 0)]
+                    # For MemoryBackend, we can't return MessageRecord objects
+                    # Return a list containing the message data that the ThreadStore can handle
+                    return [message]
         
         return []
 

narrator/database/thread_store.py

@@ -190,13 +190,15 @@ class ThreadStore:
         """
         await self._ensure_initialized()
         if hasattr(self._backend, 'find_messages_by_attribute'):
-            message_records = await self._backend.find_messages_by_attribute(path, value)
+            results = await self._backend.find_messages_by_attribute(path, value)
             
-            # Convert MessageRecord objects to Message objects
+            # Handle different return types from different backends
             messages = []
-            if hasattr(self._backend, '_create_message_from_record'):
-                for record in message_records:
-                    message = self._backend._create_message_from_record(record)
+            for item in results:
+                if hasattr(item, 'model_dump'):  # It's a Message object (from MemoryBackend)
+                    messages.append(item)
+                elif hasattr(self._backend, '_create_message_from_record'):  # It's a MessageRecord (from SQLBackend)
+                    message = self._backend._create_message_from_record(item)
                     messages.append(message)
             
             return messages

{slide_narrator-0.2.2.dist-info → slide_narrator-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: slide-narrator
-Version: 0.2.2
+Version: 0.4.0
 Summary: Thread and file storage components for conversational AI - the companion to Tyler AI framework
 Project-URL: Homepage, https://github.com/adamwdraper/slide
 Project-URL: Repository, https://github.com/adamwdraper/slide
@@ -35,14 +35,14 @@ Description-Content-Type: text/markdown
 
 # The Narrator
 
-Thread and file storage components for conversational AI - the companion to Tyler AI framework.
+Thread and file storage components for conversational AI - the storage foundation for the Slide ecosystem.
 
 ## Overview
 
-The Narrator provides robust, production-ready storage solutions for conversational AI applications. It includes:
+The Narrator provides robust, production-ready storage solutions for conversational AI applications, serving as the storage layer for Tyler and other Slide components. It includes:
 
 - **ThreadStore**: Persistent storage for conversation threads with support for both in-memory and SQL backends
-- **FileStore**: Secure file storage with automatic processing for various file types
+- **FileStore**: Secure file storage with automatic processing for various file types  
 - **Models**: Pydantic models for threads, messages, and attachments
 - **CLI Tools**: Command-line interface for database management and setup
 
@@ -52,10 +52,10 @@ The Narrator provides robust, production-ready storage solutions for conversatio
 - **Multiple Backends**: In-memory (development), SQLite (local), PostgreSQL (production)
 - **Async/Await Support**: Built for modern Python async applications
 - **Message Filtering**: Automatic handling of system vs. user messages
-- **Platform Integration**: Support for external platform references (Slack, etc.)
+- **Platform Integration**: Support for external platform references (Slack, Discord, etc.)
 - **Connection Pooling**: Production-ready database connection management
 
-### FileStore
+### FileStore  
 - **Secure Storage**: Automatic file validation and type checking
 - **Multiple Formats**: Support for documents, images, audio, and more
 - **Content Processing**: Automatic text extraction from PDFs, image analysis
@@ -65,7 +65,11 @@ The Narrator provides robust, production-ready storage solutions for conversatio
 ## Installation
 
 ```bash
-pip install the-narrator
+# Using uv (recommended)
+uv add slide-narrator
+
+# Using pip (fallback)
+pip install slide-narrator
 ```
 
 ## Setup
@@ -395,43 +399,13 @@ Available commands:
 - `narrator-db init` - Initialize database tables
 - `narrator-db status` - Check database connection and basic statistics
 
-## Migration from Tyler
-
-If you're migrating from the original Tyler package:
-
-1. **Update imports**:
-   ```python
-   # Before
-   from tyler import ThreadStore, FileStore, Thread, Message
-
-   # After
-   from narrator import ThreadStore, FileStore, Thread, Message
-   ```
-
-2. **Update environment variables**:
-   ```bash
-   # Before
-   TYLER_DB_POOL_SIZE=5
-   TYLER_FILE_STORAGE_PATH=/path/to/files
-
-   # After
-   NARRATOR_DB_POOL_SIZE=5
-   NARRATOR_FILE_STORAGE_PATH=/path/to/files
-   ```
-
-3. **Remove registry usage**:
-   ```python
-   # Before (with registry)
-   from tyler.utils.registry import register_thread_store, get_thread_store
-   register_thread_store("default", store)
-   store = get_thread_store("default")
-
-   # After (direct usage)
-   store = await ThreadStore.create("your-database-url")
-   # Use store directly
-   ```
+## Key Design Principles
 
-4. **Database compatibility**: The database schema is fully compatible, so existing data will work without changes.
+1. **Factory Pattern**: Use `await ThreadStore.create()` and `await FileStore.create()` for proper initialization and connection validation
+2. **Backend Agnostic**: Same API whether using in-memory, SQLite, or PostgreSQL storage
+3. **Production Ready**: Built-in connection pooling, error handling, and health checks
+4. **Tyler Integration**: Seamlessly integrates with Tyler agents for conversation persistence
+5. **Platform Support**: Native support for external platforms like Slack, Discord, and custom integrations
 
 ## API Reference
 

{slide_narrator-0.2.2.dist-info → slide_narrator-0.4.0.dist-info}/RECORD

@@ -1,9 +1,9 @@
-narrator/__init__.py,sha256=SOZ8kAAB9YOkje9RM_1woh7wQYfQQPH6sKRQhswOjss,403
+narrator/__init__.py,sha256=UAMzbmFCuOt2MMM9qz01m_6KzESSo3RFVCKWa1oUMx0,403
 narrator/database/__init__.py,sha256=UngOnFqImCeJiMZlMasm72mC4-UnJDDvfu1MNQLkRA8,189
 narrator/database/cli.py,sha256=Wi5kSXWFTkWBjZS1N9AuGEmTUrYjafUOTZUSO9cGfTM,1954
 narrator/database/models.py,sha256=wsG_5GrPo41hAcojjZTZmSx6bijea-Skan-DwzHs8os,2607
-narrator/database/storage_backend.py,sha256=JajlWQKbMn2OUQLHFfHkKV_sgnUISFMMuYv6Rc3N-Hk,25277
-narrator/database/thread_store.py,sha256=UrFZkBoIEFPBIMqcFkc8mdE6q1lu2VxSpZQ6S2LsZ6k,11136
+narrator/database/storage_backend.py,sha256=UeMgxW8h3ZNWORZNH_f-jZuHNjHpREBaOOAFPeEPlvA,25444
+narrator/database/thread_store.py,sha256=vMIPDdwuSpTyPogEUmxGcILxM_r1wxoQBUOn8XJpdqM,11301
 narrator/database/migrations/__init__.py,sha256=IqoSL8eCcbcOtn96u2_TTrNG0KN1Jn1yreDZEO4RsnM,173
 narrator/models/__init__.py,sha256=J8Rsv2lmfGR5QmUjoAPEFTSQt5TGtyrBynnp17HdZnU,179
 narrator/models/attachment.py,sha256=6fZnGla_Ahgc4Kro2bHBTWoF_Kr-mUBHzONizVH73oc,16129
@@ -13,8 +13,8 @@ narrator/storage/__init__.py,sha256=K4cxGITSQoQiw32QOWZsCBm11fwDTbsyzHGeAqcL6yY,
 narrator/storage/file_store.py,sha256=-k1ZYzKYioCMiP7KfWuuCmCeAzDqRv38ndpuM75yISY,20047
 narrator/utils/__init__.py,sha256=P4BhLvBJbBvb8qha2tTZPlYbjCRXth_K97f4vNc77UI,109
 narrator/utils/logging.py,sha256=K9EWI7lP4CNQpPwggiqzMex7oF6oyL3wIVLik2iuXd4,1983
-slide_narrator-0.2.2.dist-info/METADATA,sha256=EyaU7J59QZhyxqXyzDJlxHIHn5iVmeQKZFoWKdvB0Cc,15435
-slide_narrator-0.2.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-slide_narrator-0.2.2.dist-info/entry_points.txt,sha256=EaFuawrdPNFByqzAb17gkkDyj4FgelJqmII6ioD-i_I,59
-slide_narrator-0.2.2.dist-info/licenses/LICENSE,sha256=g6cGasroU9sqSOjThWg14w0BMlwZhgmOQQVTiu036ks,1068
-slide_narrator-0.2.2.dist-info/RECORD,,
+slide_narrator-0.4.0.dist-info/METADATA,sha256=d32N9g2Bp399aphM7GxuE4eDwglX20d4MWJD-JI1Dy0,15194
+slide_narrator-0.4.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+slide_narrator-0.4.0.dist-info/entry_points.txt,sha256=EaFuawrdPNFByqzAb17gkkDyj4FgelJqmII6ioD-i_I,59
+slide_narrator-0.4.0.dist-info/licenses/LICENSE,sha256=g6cGasroU9sqSOjThWg14w0BMlwZhgmOQQVTiu036ks,1068
+slide_narrator-0.4.0.dist-info/RECORD,,