API DOCUMENTATION

import requestsimport jsonfrom typing import Dict, List, Optional, Anyfrom datetime import datetimeclass StraylMemory:    def __init__(self, api_key: str):        self.api_key = api_key        self.base_url = "https://api.strayl.cloud/api"        self.headers = {            "Authorization": f"Bearer {api_key}",            "Content-Type": "application/json"        }        def _request(self, endpoint: str, data: Dict[str, Any]) -> Dict[str, Any]:        """Make API request with error handling"""        response = requests.post(            f"{self.base_url}{endpoint}",            headers=self.headers,            json=data        )                if not response.ok:            error_data = response.json() if response.content else {}            raise Exception(f"API Error: {error_data.get('error', response.status_text)}")                return response.json()        def save_memory(self, user_id: str, content: str,                    metadata: Optional[Dict] = None,                    tags: Optional[List[str]] = None,                   ttl_days: int = 7) -> Dict[str, Any]:        """Save memory with optional metadata, tags, and TTL"""        return self._request('/save-memory', {            'user_id': user_id,            'content': content,            'metadata': metadata or {},            'tags': tags or [],            'ttl_days': ttl_days        })        def search_memory(self, user_id: str, query: str,                     limit: int = 10,                     similarity_threshold: float = 0.7,                     max_tokens: Optional[int] = None,                     tags: Optional[List[str]] = None) -> Dict[str, Any]:        """Search memory with semantic similarity"""        data = {            'user_id': user_id,            'query': query,            'limit': limit,            'similarity_threshold': similarity_threshold        }                if max_tokens:            data['max_tokens'] = max_tokens        if tags:            data['tags'] = tags                    return self._request('/search-memory', data)        def read_memory(self, user_id: str,                   limit: int = 10,                   offset: int = 0,                   sort_by: str = 'created_at',                   sort_order: str = 'desc',                   tags: Optional[List[str]] = None,                   date_from: Optional[str] = None,                   date_to: Optional[str] = None,                   content_pattern: Optional[str] = None,                   include_metadata: bool = True,                   include_tags: bool = True,                   include_token_count: bool = True) -> Dict[str, Any]:        """Read memory with pagination and filters"""        data = {            'user_id': user_id,            'limit': limit,            'offset': offset,            'sort_by': sort_by,            'sort_order': sort_order,            'include_metadata': include_metadata,            'include_tags': include_tags,            'include_token_count': include_token_count        }                if tags:            data['tags'] = tags        if date_from:            data['date_from'] = date_from        if date_to:            data['date_to'] = date_to        if content_pattern:            data['content_pattern'] = content_pattern                    return self._request('/read-memory', data)        def delete_memory(self, user_id: str, delete_type: str,                     filters: Optional[Dict] = None,                     dry_run: bool = False,                     confirm: bool = False) -> Dict[str, Any]:        """Delete memory with different strategies"""        data = {            'user_id': user_id,            'delete_type': delete_type,            'filters': filters or {},            'dry_run': dry_run,            'confirm': confirm        }                return self._request('/delete-memory', data)# Usage Examplesmemory = StraylMemory("str_your_api_key_here")# Save different types of memory with TTLresult = memory.save_memory(    user_id="user123",    content="User prefers dark mode and uses Python for development",    metadata={        "source": "user_preferences",        "confidence": 0.9,        "priority": "high"    },    tags=["preferences", "ui", "programming"],    ttl_days=30)print("Memory saved:", result)# Save customer data with medium TTLcustomer_data = memory.save_memory(    user_id="customer456",    content="Customer has premium subscription and prefers email support",    metadata={        "source": "customer_support",        "category": "subscription",        "last_contact": "2025-01-15T10:30:00Z"    },    tags=["customer", "premium", "support", "email"],    ttl_days=90)# Save temporary data with short TTLtemp_data = memory.save_memory(    user_id="user123",    content="Temporary meeting notes - expires in 1 day",    metadata={        "source": "meeting",        "type": "temporary"    },    tags=["meeting", "temporary"],    ttl_days=1)# Save critical data with long TTLcritical_data = memory.save_memory(    user_id="user123",    content="Critical user preferences - keep for 1 year",    metadata={        "source": "user_profile",        "importance": "critical"    },    tags=["preferences", "critical", "long_term"],    ttl_days=365)# Search with different strategiessearch_results = memory.search_memory(    user_id="user123",    query="user interface preferences",    limit=5,    similarity_threshold=0.6,    max_tokens=2000,    tags=["preferences", "ui"])print(f"Found {len(search_results['results'])} results")# Read with paginationpage1 = memory.read_memory(    user_id="user123",    limit=20,    offset=0,    sort_by="created_at",    sort_order="desc")print(f"Page 1: {len(page1['data']['items'])} items")# Read with filtersfiltered_results = memory.read_memory(    user_id="customer456",    limit=10,    tags=["customer", "premium"],    date_from="2025-01-01T00:00:00Z",    content_pattern="subscription",    include_metadata=True)# Delete with dry run firstdry_run_result = memory.delete_memory(    user_id="user123",    delete_type="by_tags",    filters={"tags": ["old", "deprecated"]},    dry_run=True)print(f"Would delete: {dry_run_result['deleted_count']} items")# Actually delete if confirmedif dry_run_result['deleted_count'] > 0:    delete_result = memory.delete_memory(        user_id="user123",        delete_type="by_tags",        filters={"tags": ["old", "deprecated"]},        confirm=True    )    print(f"Deleted: {delete_result['deleted_count']} items")# Delete by date rangeold_data_deletion = memory.delete_memory(    user_id="user123",    delete_type="by_date",    filters={        "date_from": "2024-01-01T00:00:00Z",        "date_to": "2024-12-31T23:59:59Z"    },    dry_run=True,    confirm=True)# Delete specific items by IDspecific_deletion = memory.delete_memory(    user_id="user123",    delete_type="by_id",    filters={"ids": ["uuid1", "uuid2", "uuid3"]},    confirm=True)

# Read memory with pagination and filtersread_url = "https://api.strayl.cloud/api/read-memory"read_data = {    "user_id": "user123",    "limit": 10,    "offset": 0,    "sort_by": "created_at",    "sort_order": "desc",    "tags": ["preferences"],    "date_from": "2025-01-01T00:00:00Z",    "content_pattern": "dark mode"}read_response = requests.post(read_url, headers=headers, json=read_data)read_result = read_response.json()print("Memory items:", read_result)