sovant 1.0.0__tar.gz → 1.0.4__tar.gz

{sovant-1.0.0 → sovant-1.0.4}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Sovant AI
+Copyright (c) 2025 Sovant
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

sovant-1.0.4/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: sovant
+Version: 1.0.4
+Summary: Sovant Memory-as-a-Service Python SDK
+Author: Sovant
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.8.2
+Dynamic: license-file
+
+# Sovant Python SDK
+
+**AI Infrastructure: Memory-as-a-Service for AI systems.**  
+The official Python client for the Sovant Memory API.
+
+[![PyPI version](https://img.shields.io/pypi/v/sovant)](https://pypi.org/project/sovant/)
+[![Documentation](https://img.shields.io/badge/docs-sovant.ai-blue)](https://sovant.ai/docs)
+[![GitHub](https://img.shields.io/badge/github-sovant-lightgrey)](https://github.com/sovant-ai/sovant)
+
+---
+
+## What is Sovant?
+
+Sovant is an **AI infrastructure company** providing the **memory layer for AI systems**.  
+Our platform makes it simple to persist, search, and manage conversational/context data securely across sessions, channels, and applications.
+
+- **Problem:** Most AI systems forget once a session ends → compliance risk, knowledge loss, poor UX.  
+- **Solution:** Sovant provides a **Memory-as-a-Service API** — store, retrieve, and search memories with audit-ready controls.  
+- **Built for:** Developers & enterprises building AI agents, copilots, or compliance-driven apps that need persistent context.
+
+---
+
+## Installation
+
+```bash
+pip install sovant
+```
+
+## 60-Second Quickstart
+
+```python
+from sovant import Sovant, MemoryCreate, SearchQuery
+
+client = Sovant(api_key="YOUR_API_KEY")
+
+# Create a memory (SDK uses 'data' field, automatically converts to 'content' for API)
+created = client.memory_create(MemoryCreate(
+    data="User prefers morning meetings",  # Note: 'data' field (not 'content')
+    type="preference",
+    tags=["customer:123"],
+    # metadata={"source": "crm"},
+    # thread_id="00000000-0000-0000-0000-000000000000",
+))
+print(created)
+
+# Search memories
+results = client.memory_search(SearchQuery(
+    query="meeting preferences",
+    topK=3,
+    # tags=["customer:123"],
+    # thread_id="...",
+))
+print(results)
+```
+
+## Features
+
+- **Memory CRUD** — create, retrieve, update (PATCH/PUT), delete
+- **Semantic Search** — full-text/semantic with topK and filters
+- **Threads** — group related memories via thread_id (REST API)
+- **Batch Operations (Beta)** — atomic multi-operation requests
+- **Compliance-ready** — audit trails, PDPA/GDPR-friendly design
+- **SDKs** — official Python & TypeScript clients + REST reference
+
+## SDKs & Documentation
+
+- **Python** (this package) on PyPI: https://pypi.org/project/sovant/
+- **TypeScript** on npm: https://www.npmjs.com/package/@sovant/sdk
+- **REST API Reference**: https://sovant.ai/docs/api
+- **Full Documentation**: https://sovant.ai/docs
+
+## API Overview
+
+### Endpoints Summary
+
+- `POST /api/v1/memory` — Create memory
+- `GET /api/v1/memory` — List memories
+- `GET /api/v1/memories/{id}` — Get by ID
+- `PATCH | PUT /api/v1/memories/{id}` — Update
+- `DELETE /api/v1/memories/{id}` — Delete
+- `GET /api/v1/memory/search` — Search
+- `POST /api/v1/memory/batch` — Batch (Beta)
+
+**Auth:** Bearer token in the `Authorization` header.
+
+## Field Mapping Note
+
+- **SDK uses:** `data` field in MemoryCreate (more intuitive for developers)
+- **API expects:** `content` field (SDK automatically converts `data` → `content`)
+- **Deprecated:** `subject` is ignored by the API. Use `thread_id`, `tags`, or `metadata` for grouping.
+
+## Status of Advanced Features
+
+- **Batch API:** Available, marked Beta (contract may evolve).
+- **Threads:** Fully supported via REST API.
+- **Webhooks / Personalization / Multi-Channel Sync:** Coming soon.
+
+## Versioning & Changelog
+
+- **Stable baseline:** 1.0.3
+- See [CHANGELOG.md](https://github.com/sovant-ai/sovant) in the repo for details.
+
+## License
+
+MIT © Sovant AI

sovant-1.0.4/README.md

@@ -0,0 +1,105 @@
+# Sovant Python SDK
+
+**AI Infrastructure: Memory-as-a-Service for AI systems.**  
+The official Python client for the Sovant Memory API.
+
+[![PyPI version](https://img.shields.io/pypi/v/sovant)](https://pypi.org/project/sovant/)
+[![Documentation](https://img.shields.io/badge/docs-sovant.ai-blue)](https://sovant.ai/docs)
+[![GitHub](https://img.shields.io/badge/github-sovant-lightgrey)](https://github.com/sovant-ai/sovant)
+
+---
+
+## What is Sovant?
+
+Sovant is an **AI infrastructure company** providing the **memory layer for AI systems**.  
+Our platform makes it simple to persist, search, and manage conversational/context data securely across sessions, channels, and applications.
+
+- **Problem:** Most AI systems forget once a session ends → compliance risk, knowledge loss, poor UX.  
+- **Solution:** Sovant provides a **Memory-as-a-Service API** — store, retrieve, and search memories with audit-ready controls.  
+- **Built for:** Developers & enterprises building AI agents, copilots, or compliance-driven apps that need persistent context.
+
+---
+
+## Installation
+
+```bash
+pip install sovant
+```
+
+## 60-Second Quickstart
+
+```python
+from sovant import Sovant, MemoryCreate, SearchQuery
+
+client = Sovant(api_key="YOUR_API_KEY")
+
+# Create a memory (SDK uses 'data' field, automatically converts to 'content' for API)
+created = client.memory_create(MemoryCreate(
+    data="User prefers morning meetings",  # Note: 'data' field (not 'content')
+    type="preference",
+    tags=["customer:123"],
+    # metadata={"source": "crm"},
+    # thread_id="00000000-0000-0000-0000-000000000000",
+))
+print(created)
+
+# Search memories
+results = client.memory_search(SearchQuery(
+    query="meeting preferences",
+    topK=3,
+    # tags=["customer:123"],
+    # thread_id="...",
+))
+print(results)
+```
+
+## Features
+
+- **Memory CRUD** — create, retrieve, update (PATCH/PUT), delete
+- **Semantic Search** — full-text/semantic with topK and filters
+- **Threads** — group related memories via thread_id (REST API)
+- **Batch Operations (Beta)** — atomic multi-operation requests
+- **Compliance-ready** — audit trails, PDPA/GDPR-friendly design
+- **SDKs** — official Python & TypeScript clients + REST reference
+
+## SDKs & Documentation
+
+- **Python** (this package) on PyPI: https://pypi.org/project/sovant/
+- **TypeScript** on npm: https://www.npmjs.com/package/@sovant/sdk
+- **REST API Reference**: https://sovant.ai/docs/api
+- **Full Documentation**: https://sovant.ai/docs
+
+## API Overview
+
+### Endpoints Summary
+
+- `POST /api/v1/memory` — Create memory
+- `GET /api/v1/memory` — List memories
+- `GET /api/v1/memories/{id}` — Get by ID
+- `PATCH | PUT /api/v1/memories/{id}` — Update
+- `DELETE /api/v1/memories/{id}` — Delete
+- `GET /api/v1/memory/search` — Search
+- `POST /api/v1/memory/batch` — Batch (Beta)
+
+**Auth:** Bearer token in the `Authorization` header.
+
+## Field Mapping Note
+
+- **SDK uses:** `data` field in MemoryCreate (more intuitive for developers)
+- **API expects:** `content` field (SDK automatically converts `data` → `content`)
+- **Deprecated:** `subject` is ignored by the API. Use `thread_id`, `tags`, or `metadata` for grouping.
+
+## Status of Advanced Features
+
+- **Batch API:** Available, marked Beta (contract may evolve).
+- **Threads:** Fully supported via REST API.
+- **Webhooks / Personalization / Multi-Channel Sync:** Coming soon.
+
+## Versioning & Changelog
+
+- **Stable baseline:** 1.0.3
+- See [CHANGELOG.md](https://github.com/sovant-ai/sovant) in the repo for details.
+
+## License
+
+MIT © Sovant AI

sovant-1.0.4/pyproject.toml

@@ -0,0 +1,13 @@
+[project]
+name = "sovant"
+version = "1.0.4"
+description = "Sovant Memory-as-a-Service Python SDK"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [{name = "Sovant"}]
+dependencies = ["httpx>=0.27.0","pydantic>=2.8.2"]
+
+[build-system]
+requires = ["setuptools>=68","wheel","build"]
+build-backend = "setuptools.build_meta"

sovant-1.0.4/src/sovant/__init__.py

@@ -0,0 +1,4 @@
+from .client import Sovant, SovantError
+from .models import MemoryCreate, MemoryResult, SearchQuery
+
+__version__ = "0.1.0"

sovant-1.0.4/src/sovant/client.py

@@ -0,0 +1,90 @@
+import os
+import json
+import httpx
+from typing import Any, Dict
+from .models import MemoryCreate, SearchQuery
+
+class SovantError(Exception):
+    def __init__(self, message: str, code: str, status: int | None = None, details: Any | None = None):
+        super().__init__(message)
+        self.code = code
+        self.status = status
+        self.details = details
+
+class Sovant:
+    def __init__(self, api_key: str | None = None, base_url: str | None = None, timeout: float = 30.0):
+        self.api_key = api_key or os.getenv("SOVANT_API_KEY")
+        if not self.api_key:
+            raise ValueError("Missing api_key")
+        self.base_url = (base_url or os.getenv("SOVANT_BASE_URL") or "https://sovant.ai").rstrip("/")
+        self.timeout = timeout
+        self._client = httpx.Client(
+            timeout=self.timeout,
+            headers={
+                "authorization": f"Bearer {self.api_key}",
+                "content-type": "application/json"
+            }
+        )
+
+    def _handle(self, r: httpx.Response):
+        if r.status_code >= 400:
+            try:
+                body = r.json()
+            except Exception:
+                body = {"message": r.text}
+            msg = body.get("message") or r.reason_phrase
+            code = body.get("code") or f"HTTP_{r.status_code}"
+            raise SovantError(msg, code, r.status_code, body)
+        if not r.text:
+            return None
+        try:
+            return r.json()
+        except Exception:
+            return r.text
+
+    def memory_create(self, create: MemoryCreate):
+        # Convert data field to content field for API
+        body = create.model_dump()
+        if 'data' in body:
+            body['content'] = json.dumps(body.pop('data')) if not isinstance(body.get('data'), str) else body.pop('data')
+        
+        # Ensure type has a default
+        if 'type' not in body or body['type'] is None:
+            body['type'] = 'journal'
+            
+        r = self._client.post(f"{self.base_url}/api/v1/memory", content=json.dumps(body))
+        return self._handle(r)
+
+    def memory_get(self, id: str):
+        r = self._client.get(f"{self.base_url}/api/v1/memories/{id}")
+        return self._handle(r)
+
+    def memory_search(self, q: SearchQuery):
+        params = {}
+        if q.query:
+            params['query'] = q.query
+        if q.type:
+            params['type'] = q.type
+        if q.tags:
+            params['tags'] = ','.join(q.tags)
+        if q.thread_id:
+            params['thread_id'] = q.thread_id
+        if q.limit:
+            params['limit'] = str(q.limit)
+        if q.from_date:
+            params['from_date'] = q.from_date
+        if q.to_date:
+            params['to_date'] = q.to_date
+        r = self._client.get(f"{self.base_url}/api/v1/memory/search", params=params)
+        return self._handle(r)
+
+    def memory_update(self, id: str, patch: Dict[str, Any]):
+        # Convert data field to content field if present
+        if 'data' in patch:
+            patch['content'] = json.dumps(patch.pop('data')) if not isinstance(patch.get('data'), str) else patch.pop('data')
+        r = self._client.patch(f"{self.base_url}/api/v1/memories/{id}", content=json.dumps(patch))
+        return self._handle(r)
+
+    def memory_delete(self, id: str):
+        r = self._client.delete(f"{self.base_url}/api/v1/memories/{id}")
+        return self._handle(r)

sovant-1.0.4/src/sovant/models.py

@@ -0,0 +1,30 @@
+from pydantic import BaseModel, Field
+from typing import Any, Dict, List, Optional, Literal
+
+class MemoryCreate(BaseModel):
+    data: Any
+    type: Optional[Literal['journal', 'insight', 'observation', 'task', 'preference']] = 'journal'
+    ttl: Optional[str] = None
+    tags: Optional[List[str]] = None
+    metadata: Optional[Dict[str, Any]] = None
+    thread_id: Optional[str] = None
+
+class MemoryResult(BaseModel):
+    id: str
+    content: str
+    type: str
+    ttl: Optional[str] = None
+    tags: Optional[List[str]] = None
+    metadata: Optional[Dict[str, Any]] = None
+    thread_id: Optional[str] = None
+    created_at: Optional[str] = None
+    updated_at: Optional[str] = None
+
+class SearchQuery(BaseModel):
+    query: Optional[str] = None
+    type: Optional[str] = None
+    tags: Optional[List[str]] = None
+    thread_id: Optional[str] = None
+    limit: Optional[int] = Field(default=10, ge=1, le=100)
+    from_date: Optional[str] = None
+    to_date: Optional[str] = None

sovant-1.0.4/src/sovant.egg-info/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: sovant
+Version: 1.0.4
+Summary: Sovant Memory-as-a-Service Python SDK
+Author: Sovant
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.8.2
+Dynamic: license-file
+
+# Sovant Python SDK
+
+**AI Infrastructure: Memory-as-a-Service for AI systems.**  
+The official Python client for the Sovant Memory API.
+
+[![PyPI version](https://img.shields.io/pypi/v/sovant)](https://pypi.org/project/sovant/)
+[![Documentation](https://img.shields.io/badge/docs-sovant.ai-blue)](https://sovant.ai/docs)
+[![GitHub](https://img.shields.io/badge/github-sovant-lightgrey)](https://github.com/sovant-ai/sovant)
+
+---
+
+## What is Sovant?
+
+Sovant is an **AI infrastructure company** providing the **memory layer for AI systems**.  
+Our platform makes it simple to persist, search, and manage conversational/context data securely across sessions, channels, and applications.
+
+- **Problem:** Most AI systems forget once a session ends → compliance risk, knowledge loss, poor UX.  
+- **Solution:** Sovant provides a **Memory-as-a-Service API** — store, retrieve, and search memories with audit-ready controls.  
+- **Built for:** Developers & enterprises building AI agents, copilots, or compliance-driven apps that need persistent context.
+
+---
+
+## Installation
+
+```bash
+pip install sovant
+```
+
+## 60-Second Quickstart
+
+```python
+from sovant import Sovant, MemoryCreate, SearchQuery
+
+client = Sovant(api_key="YOUR_API_KEY")
+
+# Create a memory (SDK uses 'data' field, automatically converts to 'content' for API)
+created = client.memory_create(MemoryCreate(
+    data="User prefers morning meetings",  # Note: 'data' field (not 'content')
+    type="preference",
+    tags=["customer:123"],
+    # metadata={"source": "crm"},
+    # thread_id="00000000-0000-0000-0000-000000000000",
+))
+print(created)
+
+# Search memories
+results = client.memory_search(SearchQuery(
+    query="meeting preferences",
+    topK=3,
+    # tags=["customer:123"],
+    # thread_id="...",
+))
+print(results)
+```
+
+## Features
+
+- **Memory CRUD** — create, retrieve, update (PATCH/PUT), delete
+- **Semantic Search** — full-text/semantic with topK and filters
+- **Threads** — group related memories via thread_id (REST API)
+- **Batch Operations (Beta)** — atomic multi-operation requests
+- **Compliance-ready** — audit trails, PDPA/GDPR-friendly design
+- **SDKs** — official Python & TypeScript clients + REST reference
+
+## SDKs & Documentation
+
+- **Python** (this package) on PyPI: https://pypi.org/project/sovant/
+- **TypeScript** on npm: https://www.npmjs.com/package/@sovant/sdk
+- **REST API Reference**: https://sovant.ai/docs/api
+- **Full Documentation**: https://sovant.ai/docs
+
+## API Overview
+
+### Endpoints Summary
+
+- `POST /api/v1/memory` — Create memory
+- `GET /api/v1/memory` — List memories
+- `GET /api/v1/memories/{id}` — Get by ID
+- `PATCH | PUT /api/v1/memories/{id}` — Update
+- `DELETE /api/v1/memories/{id}` — Delete
+- `GET /api/v1/memory/search` — Search
+- `POST /api/v1/memory/batch` — Batch (Beta)
+
+**Auth:** Bearer token in the `Authorization` header.
+
+## Field Mapping Note
+
+- **SDK uses:** `data` field in MemoryCreate (more intuitive for developers)
+- **API expects:** `content` field (SDK automatically converts `data` → `content`)
+- **Deprecated:** `subject` is ignored by the API. Use `thread_id`, `tags`, or `metadata` for grouping.
+
+## Status of Advanced Features
+
+- **Batch API:** Available, marked Beta (contract may evolve).
+- **Threads:** Fully supported via REST API.
+- **Webhooks / Personalization / Multi-Channel Sync:** Coming soon.
+
+## Versioning & Changelog
+
+- **Stable baseline:** 1.0.3
+- See [CHANGELOG.md](https://github.com/sovant-ai/sovant) in the repo for details.
+
+## License
+
+MIT © Sovant AI

{sovant-1.0.0 → sovant-1.0.4}/src/sovant.egg-info/SOURCES.txt

@@ -6,6 +6,7 @@ src/sovant/__init__.py
 src/sovant/base_client.py
 src/sovant/client.py
 src/sovant/exceptions.py
+src/sovant/models.py
 src/sovant/types.py
 src/sovant.egg-info/PKG-INFO
 src/sovant.egg-info/SOURCES.txt

sovant-1.0.4/src/sovant.egg-info/requires.txt

@@ -0,0 +1,2 @@
+httpx>=0.27.0
+pydantic>=2.8.2