slide-narrator 0.3.0__py3-none-any.whl → 1.0.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.3.0"
+__version__ = "1.0.0"
 __all__ = [
     "ThreadStore",
     "FileStore", 

{slide_narrator-0.3.0.dist-info → slide_narrator-1.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: slide-narrator
-Version: 0.3.0
+Version: 1.0.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.3.0.dist-info → slide_narrator-1.0.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-narrator/__init__.py,sha256=4nmJ9jvPYfcokkI4Ne76WA6CRAaKSiC0PzosSVX7Rhs,403
+narrator/__init__.py,sha256=3NsXekWzkpNumnCQ0AY0dHdpou_EaMJS_V4C7wZD2pg,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
@@ -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.3.0.dist-info/METADATA,sha256=G-E5PNy_NKWfT_Xrht5179aUIZTpuIXRzMbQMsMnals,15435
-slide_narrator-0.3.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-slide_narrator-0.3.0.dist-info/entry_points.txt,sha256=EaFuawrdPNFByqzAb17gkkDyj4FgelJqmII6ioD-i_I,59
-slide_narrator-0.3.0.dist-info/licenses/LICENSE,sha256=g6cGasroU9sqSOjThWg14w0BMlwZhgmOQQVTiu036ks,1068
-slide_narrator-0.3.0.dist-info/RECORD,,
+slide_narrator-1.0.0.dist-info/METADATA,sha256=W5-QQVHN3pY6JF1lCCWsTse4gGlGa9eQqux6JT3Al54,15194
+slide_narrator-1.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+slide_narrator-1.0.0.dist-info/entry_points.txt,sha256=EaFuawrdPNFByqzAb17gkkDyj4FgelJqmII6ioD-i_I,59
+slide_narrator-1.0.0.dist-info/licenses/LICENSE,sha256=g6cGasroU9sqSOjThWg14w0BMlwZhgmOQQVTiu036ks,1068
+slide_narrator-1.0.0.dist-info/RECORD,,