agenticmem 0.1.0__tar.gz

agenticmem-0.1.0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.1
+Name: agenticmem
+Version: 0.1.0
+Summary: A Python client for the AgenticMem API
+License: MIT
+Author: AgenticMem Team
+Requires-Python: >=3.7,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Dist: pydantic (>=2.0.0,<3.0.0)
+Requires-Dist: python-dateutil (>=2.8.0,<3.0.0)
+Requires-Dist: requests (>=2.25.0,<3.0.0)
+Description-Content-Type: text/markdown
+
+# AgenticMem Python Client
+
+A Python client library for interacting with the AgenticMem API. This client provides easy-to-use interfaces for managing user interactions and profiles.
+
+## Installation
+
+```bash
+pip install agenticmem
+```
+
+## Quick Start
+
+```python
+from agenticmem import AgenticMemClient
+from agenticmem import UserActionType, InteractionRequest
+from datetime import datetime
+
+# Initialize the client
+client = AgenticMemClient(
+    api_key="your_api_key",
+)
+
+# Publish a user interaction
+interaction = InteractionRequest(
+    timestamp=datetime.now(),
+    text_interaction="User clicked on product X",
+    user_action=UserActionType.CLICK,
+    user_action_description="Clicked on product details button"
+)
+
+response = client.publish_interaction(
+    user_id="user123",
+    request_id="req456",
+    interaction_requests=[interaction]
+)
+print(f"Published interaction: {response.success} - {response.message}")
+
+# Search user profiles
+profiles = client.search_profiles(
+    user_id="user123",
+    query="recent interactions",
+    top_k=5
+)
+for profile in profiles:
+    print(f"Profile {profile.profile_id}: {profile.profile_content}")
+
+# Search interactions
+interactions = client.search_interactions(
+    user_id="user123",
+    start_time=datetime(2024, 1, 1),
+    end_time=datetime.now()
+)
+for interaction in interactions:
+    print(f"Interaction {interaction.interaction_id}: {interaction.text_interaction}")
+```
+
+## Features
+
+- User interaction management
+  - Publish user interactions
+  - Delete user interactions
+  - Search interactions
+- User profile management
+  - Search user profiles
+  - Delete user profiles
+
+## API Response Types
+
+All API methods return strongly-typed responses:
+
+- `publish_interaction()` returns `PublishUserInteractionResponse`
+- `search_interactions()` returns `List[Interaction]`
+- `search_profiles()` returns `List[UserProfile]`
+- `delete_profile()` returns `DeleteUserProfileResponse`
+- `delete_interaction()` returns `DeleteUserInteractionResponse`
+
+## Documentation
+
+For detailed documentation, please visit [docs link].
+
+## License
+
+MIT License 

agenticmem-0.1.0/README.md

@@ -0,0 +1,83 @@
+# AgenticMem Python Client
+
+A Python client library for interacting with the AgenticMem API. This client provides easy-to-use interfaces for managing user interactions and profiles.
+
+## Installation
+
+```bash
+pip install agenticmem
+```
+
+## Quick Start
+
+```python
+from agenticmem import AgenticMemClient
+from agenticmem import UserActionType, InteractionRequest
+from datetime import datetime
+
+# Initialize the client
+client = AgenticMemClient(
+    api_key="your_api_key",
+)
+
+# Publish a user interaction
+interaction = InteractionRequest(
+    timestamp=datetime.now(),
+    text_interaction="User clicked on product X",
+    user_action=UserActionType.CLICK,
+    user_action_description="Clicked on product details button"
+)
+
+response = client.publish_interaction(
+    user_id="user123",
+    request_id="req456",
+    interaction_requests=[interaction]
+)
+print(f"Published interaction: {response.success} - {response.message}")
+
+# Search user profiles
+profiles = client.search_profiles(
+    user_id="user123",
+    query="recent interactions",
+    top_k=5
+)
+for profile in profiles:
+    print(f"Profile {profile.profile_id}: {profile.profile_content}")
+
+# Search interactions
+interactions = client.search_interactions(
+    user_id="user123",
+    start_time=datetime(2024, 1, 1),
+    end_time=datetime.now()
+)
+for interaction in interactions:
+    print(f"Interaction {interaction.interaction_id}: {interaction.text_interaction}")
+```
+
+## Features
+
+- User interaction management
+  - Publish user interactions
+  - Delete user interactions
+  - Search interactions
+- User profile management
+  - Search user profiles
+  - Delete user profiles
+
+## API Response Types
+
+All API methods return strongly-typed responses:
+
+- `publish_interaction()` returns `PublishUserInteractionResponse`
+- `search_interactions()` returns `List[Interaction]`
+- `search_profiles()` returns `List[UserProfile]`
+- `delete_profile()` returns `DeleteUserProfileResponse`
+- `delete_interaction()` returns `DeleteUserInteractionResponse`
+
+## Documentation
+
+For detailed documentation, please visit [docs link].
+
+## License
+
+MIT License 

agenticmem-0.1.0/agenticmem/__init__.py

@@ -0,0 +1,29 @@
+from agenticmem.client import AgenticMemClient
+from server.api_schema.service_schemas import (
+    UserActionType,
+    ProfileTimeToLive,
+    InteractionRequest,
+    Interaction,
+    UserProfile,
+    PublishUserInteractionRequest,
+    PublishUserInteractionResponse,
+    DeleteUserProfileRequest,
+    DeleteUserProfileResponse,
+    DeleteUserInteractionRequest,
+    DeleteUserInteractionResponse,
+)
+
+__all__ = [
+    'AgenticMemClient',
+    'UserActionType',
+    'ProfileTimeToLive',
+    'InteractionRequest',
+    'Interaction',
+    'UserProfile',
+    'PublishUserInteractionRequest',
+    'PublishUserInteractionResponse',
+    'DeleteUserProfileRequest',
+    'DeleteUserProfileResponse',
+    'DeleteUserInteractionRequest',
+    'DeleteUserInteractionResponse',
+] 

agenticmem-0.1.0/agenticmem/client.py

@@ -0,0 +1,203 @@
+from typing import List, Optional
+from datetime import datetime
+import requests
+from urllib.parse import urljoin
+
+from server.api_schema.service_schemas import (
+    Interaction,
+    InteractionRequest,
+    UserProfile,
+    PublishUserInteractionRequest,
+    PublishUserInteractionResponse,
+    DeleteUserProfileRequest,
+    DeleteUserProfileResponse,
+    DeleteUserInteractionRequest,
+    DeleteUserInteractionResponse,
+)
+from server.api_schema.login_schema import Token
+
+
+class AgenticMemClient:
+    """Client for interacting with the AgenticMem API."""
+
+    def __init__(self, api_key: str):
+        """Initialize the AgenticMem client.
+
+        Args:
+            api_key (str): Your API key for authentication
+        """
+        self.api_key = api_key
+        self.base_url = "https://api.agenticmem.com"
+        self.session = requests.Session()
+        self.session.headers.update({
+            "Authorization": f"Bearer {api_key}",
+            "Content-Type": "application/json"
+        })
+
+    def _make_request(self, method: str, endpoint: str, **kwargs):
+        """Make an HTTP request to the API.
+
+        Args:
+            method (str): HTTP method (GET, POST, DELETE)
+            endpoint (str): API endpoint
+            **kwargs: Additional arguments to pass to requests
+
+        Returns:
+            dict: API response
+        """
+        url = urljoin(self.base_url, endpoint)
+        response = self.session.request(method, url, **kwargs)
+        response.raise_for_status()
+        return response.json()
+
+    def login(self, email: str, password: str) -> Token:
+        """Login to the AgenticMem API.
+
+        Args:
+            email (str): The user's email
+            password (str): The user's password
+
+        Returns:
+            Token: Response containing success status and message
+        """
+        response = self._make_request("POST", "/api/login", json={"email": email, "password": password})
+        return Token(**response)
+
+    def publish_interaction(
+        self,
+        user_id: str,
+        request_id: str,
+        interaction_requests: List[InteractionRequest]
+    ) -> PublishUserInteractionResponse:
+        """Publish user interactions.
+
+        Args:
+            user_id (str): The user ID
+            request_id (str): The request ID
+            interaction_requests (List[InteractionRequest]): List of interaction requests
+
+        Returns:
+            PublishUserInteractionResponse: Response containing success status and message
+        """
+        request = PublishUserInteractionRequest(
+            user_id=user_id,
+            request_id=request_id,
+            interaction_requests=interaction_requests
+        )
+        response = self._make_request("POST", "/api/interactions", json=request.model_dump())
+        return PublishUserInteractionResponse(**response)
+
+    def search_interactions(
+        self,
+        user_id: str,
+        request_id: Optional[str] = None,
+        query: Optional[str] = None,
+        start_time: Optional[datetime] = None,
+        end_time: Optional[datetime] = None,
+        most_recent_k: Optional[int] = None
+    ) -> List[Interaction]:
+        """Search for user interactions.
+
+        Args:
+            user_id (str): The user ID
+            request_id (Optional[str], optional): Filter by request ID
+            query (Optional[str], optional): Search query
+            start_time (Optional[datetime], optional): Start time filter
+            end_time (Optional[datetime], optional): End time filter
+            most_recent_k (Optional[int], optional): Limit to most recent K results
+
+        Returns:
+            List[Interaction]: List of matching interactions
+        """
+        params = {
+            "user_id": user_id,
+            "request_id": request_id,
+            "query": query,
+            "start_time": start_time,
+            "end_time": end_time,
+            "most_recent_k": most_recent_k
+        }
+        # Remove None values
+        params = {k: v for k, v in params.items() if v is not None}
+        response = self._make_request("GET", "/api/interactions/search", params=params)
+        return [Interaction(**interaction) for interaction in response.get("interactions", [])]
+
+    def search_profiles(
+        self,
+        user_id: str,
+        genered_from_request_id: Optional[str] = None,
+        query: Optional[str] = None,
+        start_time: Optional[datetime] = None,
+        end_time: Optional[datetime] = None,
+        top_k: Optional[int] = None
+    ) -> List[UserProfile]:
+        """Search for user profiles.
+
+        Args:
+            user_id (str): The user ID
+            genered_from_request_id (Optional[str], optional): Filter by request ID that generated the profile
+            query (Optional[str], optional): Search query
+            start_time (Optional[datetime], optional): Start time filter
+            end_time (Optional[datetime], optional): End time filter
+            top_k (Optional[int], optional): Limit to top K results
+
+        Returns:
+            List[UserProfile]: List of matching profiles
+        """
+        params = {
+            "user_id": user_id,
+            "genered_from_request_id": genered_from_request_id,
+            "query": query,
+            "start_time": start_time,
+            "end_time": end_time,
+            "top_k": top_k
+        }
+        # Remove None values
+        params = {k: v for k, v in params.items() if v is not None}
+        response = self._make_request("GET", "/api/profiles/search", params=params)
+        return [UserProfile(**profile) for profile in response.get("user_profiles", [])]
+
+    def delete_profile(
+        self,
+        user_id: str,
+        profile_id: str = "",
+        profile_search_query: str = ""
+    ) -> DeleteUserProfileResponse:
+        """Delete user profiles.
+
+        Args:
+            user_id (str): The user ID
+            profile_id (str, optional): Specific profile ID to delete
+            profile_search_query (str, optional): Query to match profiles for deletion
+
+        Returns:
+            DeleteUserProfileResponse: Response containing success status and message
+        """
+        request = DeleteUserProfileRequest(
+            user_id=user_id,
+            profile_id=profile_id,
+            profile_search_query=profile_search_query
+        )
+        response = self._make_request("DELETE", "/api/profiles", json=request.model_dump())
+        return DeleteUserProfileResponse(**response)
+
+    def delete_interaction(
+        self,
+        user_id: str,
+        interaction_id: str
+    ) -> DeleteUserInteractionResponse:
+        """Delete a user interaction.
+
+        Args:
+            user_id (str): The user ID
+            interaction_id (str): The interaction ID to delete
+
+        Returns:
+            DeleteUserInteractionResponse: Response containing success status and message
+        """
+        request = DeleteUserInteractionRequest(
+            user_id=user_id,
+            interaction_id=interaction_id
+        )
+        response = self._make_request("DELETE", "/api/interactions", json=request.model_dump())
+        return DeleteUserInteractionResponse(**response) 

agenticmem-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[tool.poetry]
+name = "agenticmem"
+version = "0.1.0"
+description = "A Python client for the AgenticMem API"
+authors = ["AgenticMem Team"]
+readme = "README.md"
+packages = [{include = "agenticmem"}]
+license = "MIT"
+
+[tool.poetry.dependencies]
+python = "^3.7"
+requests = "^2.25.0"
+pydantic = "^2.0.0"
+python-dateutil = "^2.8.0"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"