ainative-python 2.0.0__tar.gz → 3.1.0__tar.gz

{ainative_python-2.0.0 → ainative_python-3.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ainative-python
-Version: 2.0.0
+Version: 3.1.0
 Summary: Official Python SDK for AINative Studio APIs with ZeroDB Local support
 Home-page: https://github.com/ainative/ainative-python
 Author: AINative Team

{ainative_python-2.0.0 → ainative_python-3.1.0}/ainative/__init__.py

@@ -2,9 +2,14 @@
 AINative Python SDK
 
 Official Python SDK for AINative Studio APIs including ZeroDB and Agent Swarm operations.
+
+⚠️  BREAKING CHANGES IN v3.0.0:
+- All ZeroDB endpoint paths updated to canonical routes
+- table/memory/analytics methods now require project_id as first parameter
+- See CHANGELOG.md for migration guide
 """
 
-__version__ = "2.0.0"
+__version__ = "3.1.0"
 __author__ = "AINative Team"
 __email__ = "support@ainative.studio"
 

{ainative_python-2.0.0 → ainative_python-3.1.0}/ainative/auth.py

@@ -56,7 +56,7 @@ class APIKeyAuth:
         
         headers = {
             "X-API-Key": self.config.api_key,
-            "X-SDK-Version": "0.1.0",
+            "X-SDK-Version": "3.0.0",
             "X-SDK-Language": "Python",
         }
         

{ainative_python-2.0.0 → ainative_python-3.1.0}/ainative/zerodb/analytics.py

@@ -13,152 +13,139 @@ if TYPE_CHECKING:
 
 class AnalyticsClient:
     """Client for ZeroDB analytics operations."""
-    
+
     def __init__(self, client: "AINativeClient"):
         """
         Initialize analytics client.
-        
+
         Args:
             client: Parent AINative client instance
         """
         self.client = client
-        self.base_path = "/zerodb/analytics"
+        # Analytics are accessed via /projects/{project_id}/database/analytics/*
+        self.base_path = "/projects"
     
     def get_usage(
         self,
-        project_id: Optional[str] = None,
+        project_id: str,
         start_date: Optional[datetime] = None,
         end_date: Optional[datetime] = None,
         granularity: str = "daily",
     ) -> Dict[str, Any]:
         """
         Get usage analytics.
-        
+
         Args:
-            project_id: Optional project ID filter
+            project_id: Project ID (required)
             start_date: Start date for analytics
             end_date: End date for analytics
             granularity: Data granularity (hourly, daily, weekly, monthly)
-        
+
         Returns:
             Usage analytics data
         """
         params = {"granularity": granularity}
-        
-        if project_id:
-            params["project_id"] = project_id
+
         if start_date:
             params["start_date"] = start_date.isoformat()
         if end_date:
             params["end_date"] = end_date.isoformat()
-        
-        return self.client.get(f"{self.base_path}/usage", params=params)
+
+        return self.client.get(f"{self.base_path}/{project_id}/database/analytics/usage", params=params)
     
     def get_performance_metrics(
         self,
-        project_id: Optional[str] = None,
+        project_id: str,
         metric_type: str = "all",
     ) -> Dict[str, Any]:
         """
         Get performance metrics.
-        
+
         Args:
-            project_id: Optional project ID filter
+            project_id: Project ID (required)
             metric_type: Type of metrics (latency, throughput, errors, all)
-        
+
         Returns:
             Performance metrics data
         """
         params = {"metric_type": metric_type}
-        
-        if project_id:
-            params["project_id"] = project_id
-        
-        return self.client.get(f"{self.base_path}/performance", params=params)
+
+        return self.client.get(f"{self.base_path}/{project_id}/database/analytics/performance", params=params)
     
     def get_storage_stats(
         self,
-        project_id: Optional[str] = None,
+        project_id: str,
     ) -> Dict[str, Any]:
         """
         Get storage statistics.
-        
+
         Args:
-            project_id: Optional project ID filter
-        
+            project_id: Project ID (required)
+
         Returns:
             Storage statistics including size, vector count, etc.
         """
-        params = {}
-        if project_id:
-            params["project_id"] = project_id
-        
-        return self.client.get(f"{self.base_path}/storage", params=params)
+        return self.client.get(f"{self.base_path}/{project_id}/database/analytics/storage")
     
     def get_query_insights(
         self,
-        project_id: Optional[str] = None,
+        project_id: str,
         limit: int = 100,
     ) -> Dict[str, Any]:
         """
         Get query pattern insights.
-        
+
         Args:
-            project_id: Optional project ID filter
+            project_id: Project ID (required)
             limit: Maximum number of insights
-        
+
         Returns:
             Query insights and patterns
         """
         params = {"limit": limit}
-        
-        if project_id:
-            params["project_id"] = project_id
-        
-        return self.client.get(f"{self.base_path}/queries", params=params)
+
+        return self.client.get(f"{self.base_path}/{project_id}/database/analytics/queries", params=params)
     
     def get_cost_analysis(
         self,
-        project_id: Optional[str] = None,
+        project_id: str,
         start_date: Optional[datetime] = None,
         end_date: Optional[datetime] = None,
     ) -> Dict[str, Any]:
         """
         Get cost analysis and projections.
-        
+
         Args:
-            project_id: Optional project ID filter
+            project_id: Project ID (required)
             start_date: Start date for analysis
             end_date: End date for analysis
-        
+
         Returns:
             Cost analysis data
         """
         params = {}
-        
-        if project_id:
-            params["project_id"] = project_id
+
         if start_date:
             params["start_date"] = start_date.isoformat()
         if end_date:
             params["end_date"] = end_date.isoformat()
-        
-        return self.client.get(f"{self.base_path}/costs", params=params)
+
+        return self.client.get(f"{self.base_path}/{project_id}/database/analytics/costs", params=params)
     
     def get_trends(
         self,
+        project_id: str,
         metric: str,
-        project_id: Optional[str] = None,
         period: int = 30,
     ) -> List[Dict[str, Any]]:
         """
         Get trend data for specific metrics.
-        
+
         Args:
+            project_id: Project ID (required)
             metric: Metric name (vectors, queries, storage, errors)
-            project_id: Optional project ID filter
             period: Number of days to analyze
-        
+
         Returns:
             Trend data points
         """
@@ -166,54 +153,48 @@ class AnalyticsClient:
             "metric": metric,
             "period": period,
         }
-        
-        if project_id:
-            params["project_id"] = project_id
-        
-        response = self.client.get(f"{self.base_path}/trends", params=params)
+
+        response = self.client.get(f"{self.base_path}/{project_id}/database/analytics/trends", params=params)
         return response.get("data", [])
     
     def get_anomalies(
         self,
-        project_id: Optional[str] = None,
+        project_id: str,
         severity: str = "all",
     ) -> List[Dict[str, Any]]:
         """
         Get detected anomalies in usage patterns.
-        
+
         Args:
-            project_id: Optional project ID filter
+            project_id: Project ID (required)
             severity: Severity filter (low, medium, high, critical, all)
-        
+
         Returns:
             List of detected anomalies
         """
         params = {"severity": severity}
-        
-        if project_id:
-            params["project_id"] = project_id
-        
-        response = self.client.get(f"{self.base_path}/anomalies", params=params)
+
+        response = self.client.get(f"{self.base_path}/{project_id}/database/analytics/anomalies", params=params)
         return response.get("anomalies", [])
     
     def export_report(
         self,
+        project_id: str,
         report_type: str = "summary",
-        project_id: Optional[str] = None,
         format: str = "json",
         start_date: Optional[datetime] = None,
         end_date: Optional[datetime] = None,
     ) -> Dict[str, Any]:
         """
         Export analytics report.
-        
+
         Args:
+            project_id: Project ID (required)
             report_type: Type of report (summary, detailed, custom)
-            project_id: Optional project ID filter
             format: Export format (json, csv, pdf)
             start_date: Start date for report
             end_date: End date for report
-        
+
         Returns:
             Report data or download URL
         """
@@ -221,12 +202,10 @@ class AnalyticsClient:
             "report_type": report_type,
             "format": format,
         }
-        
-        if project_id:
-            data["project_id"] = project_id
+
         if start_date:
             data["start_date"] = start_date.isoformat()
         if end_date:
             data["end_date"] = end_date.isoformat()
-        
-        return self.client.post(f"{self.base_path}/export", data=data)
+
+        return self.client.post(f"{self.base_path}/{project_id}/database/analytics/export", data=data)

{ainative_python-2.0.0 → ainative_python-3.1.0}/ainative/zerodb/memory.py

@@ -26,39 +26,46 @@ class MemoryClient:
     def __init__(self, client: "AINativeClient"):
         """
         Initialize memory client.
-        
+
         Args:
             client: Parent AINative client instance
         """
         self.client = client
-        self.base_path = "/zerodb/memory"
+        self.base_path = "/projects"
     
     def create(
         self,
+        project_id: str,
         content: str,
         title: Optional[str] = None,
         tags: Optional[List[str]] = None,
         priority: MemoryPriority = MemoryPriority.MEDIUM,
         metadata: Optional[Dict[str, Any]] = None,
-        project_id: Optional[str] = None,
         user_id: Optional[str] = None,
         expires_at: Optional[datetime] = None,
     ) -> Dict[str, Any]:
         """
         Create a new memory entry.
-        
+
         Args:
+            project_id: Project ID (required)
             content: Memory content
             title: Memory title
             tags: List of tags
             priority: Memory priority level
             metadata: Additional metadata
-            project_id: Associated project ID
             user_id: Associated user ID
             expires_at: Expiration timestamp
-        
+
         Returns:
             Created memory details
+
+        Example:
+            >>> memory = client.zerodb.memory.create(
+            ...     PROJECT_ID,
+            ...     content="User prefers dark mode",
+            ...     tags=["preferences", "ui"]
+            ... )
         """
         data = {
             "content": content,
@@ -67,21 +74,19 @@ class MemoryClient:
             "priority": priority.value,
             "metadata": metadata or {},
         }
-        
-        if project_id:
-            data["project_id"] = project_id
+
         if user_id:
             data["user_id"] = user_id
         if expires_at:
             data["expires_at"] = expires_at.isoformat()
-        
-        return self.client.post(self.base_path, data=data)
+
+        return self.client.post(f"{self.base_path}/{project_id}/database/memory", data=data)
     
     def list(
         self,
+        project_id: str,
         limit: int = 100,
         offset: int = 0,
-        project_id: Optional[str] = None,
         user_id: Optional[str] = None,
         tags: Optional[List[str]] = None,
         priority: Optional[MemoryPriority] = None,
@@ -89,26 +94,27 @@ class MemoryClient:
     ) -> Dict[str, Any]:
         """
         List memory entries.
-        
+
         Args:
+            project_id: Project ID (required)
             limit: Maximum number of entries to return
             offset: Number of entries to skip
-            project_id: Filter by project ID
             user_id: Filter by user ID
             tags: Filter by tags
             priority: Filter by priority
             search: Search query
-        
+
         Returns:
             Dictionary containing memories list and pagination info
+
+        Example:
+            >>> memories = client.zerodb.memory.list(PROJECT_ID, limit=50)
         """
         params = {
             "limit": limit,
             "offset": offset,
         }
-        
-        if project_id:
-            params["project_id"] = project_id
+
         if user_id:
             params["user_id"] = user_id
         if tags:
@@ -117,23 +123,25 @@ class MemoryClient:
             params["priority"] = priority.value
         if search:
             params["search"] = search
-        
-        return self.client.get(f"{self.base_path}ies", params=params)
+
+        return self.client.get(f"{self.base_path}/{project_id}/database/memory", params=params)
     
-    def get(self, memory_id: str) -> Dict[str, Any]:
+    def get(self, project_id: str, memory_id: str) -> Dict[str, Any]:
         """
         Get a specific memory entry.
-        
+
         Args:
+            project_id: Project ID (required)
             memory_id: Memory ID
-        
+
         Returns:
             Memory details
         """
-        return self.client.get(f"{self.base_path}/{memory_id}")
+        return self.client.get(f"{self.base_path}/{project_id}/database/memory/{memory_id}")
     
     def update(
         self,
+        project_id: str,
         memory_id: str,
         content: Optional[str] = None,
         title: Optional[str] = None,
@@ -143,15 +151,16 @@ class MemoryClient:
     ) -> Dict[str, Any]:
         """
         Update a memory entry.
-        
+
         Args:
+            project_id: Project ID (required)
             memory_id: Memory ID
             content: New content
             title: New title
             tags: New tags
             priority: New priority
             metadata: New metadata
-        
+
         Returns:
             Updated memory details
         """
@@ -166,95 +175,100 @@ class MemoryClient:
             data["priority"] = priority.value
         if metadata is not None:
             data["metadata"] = metadata
-        
-        return self.client.patch(f"{self.base_path}/{memory_id}", data=data)
+
+        return self.client.patch(f"{self.base_path}/{project_id}/database/memory/{memory_id}", data=data)
     
-    def delete(self, memory_id: str) -> Dict[str, Any]:
+    def delete(self, project_id: str, memory_id: str) -> Dict[str, Any]:
         """
         Delete a memory entry.
-        
+
         Args:
+            project_id: Project ID (required)
             memory_id: Memory ID
-        
+
         Returns:
             Deletion confirmation
         """
-        return self.client.delete(f"{self.base_path}/{memory_id}")
+        return self.client.delete(f"{self.base_path}/{project_id}/database/memory/{memory_id}")
     
     def search(
         self,
+        project_id: str,
         query: str,
         limit: int = 10,
-        project_id: Optional[str] = None,
         user_id: Optional[str] = None,
         semantic: bool = True,
     ) -> List[Dict[str, Any]]:
         """
         Search memories using text or semantic search.
-        
+
         Args:
+            project_id: Project ID (required)
             query: Search query
             limit: Maximum number of results
-            project_id: Filter by project ID
             user_id: Filter by user ID
             semantic: Use semantic search (if False, uses text search)
-        
+
         Returns:
             List of matching memories
+
+        Example:
+            >>> results = client.zerodb.memory.search(
+            ...     PROJECT_ID,
+            ...     query="What does user prefer?",
+            ...     top_k=5
+            ... )
         """
         data = {
             "query": query,
             "limit": limit,
             "semantic": semantic,
         }
-        
-        if project_id:
-            data["project_id"] = project_id
+
         if user_id:
             data["user_id"] = user_id
-        
-        response = self.client.post(f"{self.base_path}/search", data=data)
+
+        response = self.client.post(f"{self.base_path}/{project_id}/database/memory/search", data=data)
         return response.get("results", [])
     
     def bulk_create(
         self,
+        project_id: str,
         memories: List[Dict[str, Any]],
-        project_id: Optional[str] = None,
     ) -> Dict[str, Any]:
         """
         Create multiple memory entries at once.
-        
+
         Args:
+            project_id: Project ID (required)
             memories: List of memory data dictionaries
-            project_id: Project ID for all memories
-        
+
         Returns:
             Bulk creation result
         """
         data = {
             "memories": memories,
         }
-        
-        if project_id:
-            data["project_id"] = project_id
-        
-        return self.client.post(f"{self.base_path}/bulk", data=data)
+
+        return self.client.post(f"{self.base_path}/{project_id}/database/memory/bulk", data=data)
     
     def get_related(
         self,
+        project_id: str,
         memory_id: str,
         limit: int = 5,
     ) -> List[Dict[str, Any]]:
         """
         Get memories related to a specific memory.
-        
+
         Args:
+            project_id: Project ID (required)
             memory_id: Memory ID
             limit: Maximum number of related memories
-        
+
         Returns:
             List of related memories
         """
         params = {"limit": limit}
-        response = self.client.get(f"{self.base_path}/{memory_id}/related", params=params)
+        response = self.client.get(f"{self.base_path}/{project_id}/database/memory/{memory_id}/related", params=params)
         return response.get("memories", [])

{ainative_python-2.0.0 → ainative_python-3.1.0}/ainative/zerodb/projects.py

@@ -26,12 +26,12 @@ class ProjectsClient:
     def __init__(self, client: "AINativeClient"):
         """
         Initialize projects client.
-        
+
         Args:
             client: Parent AINative client instance
         """
         self.client = client
-        self.base_path = "/zerodb/projects"
+        self.base_path = "/projects"
     
     def list(
         self,