memoryintelligence 1.0.0__tar.gz → 1.0.1__tar.gz

memoryintelligence-1.0.1/CHANGELOG.md

@@ -0,0 +1,52 @@
+# Changelog
+
+All notable changes to the Memory Intelligence Python SDK will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.1] - 2026-02-07
+
+### Fixed
+- Corrected `ProvenanceError` in `__all__` exports list (final typo fix)
+
+## [1.0.0] - 2026-02-07 [YANKED]
+
+### Added
+- **MemoryClient** with 6 core operations: process, search, match, explain, delete, verify_provenance
+- **EdgeClient** for on-premises HIPAA-compliant deployments
+- Privacy-first architecture with meaning-only retention (default)
+- Structured semantic extraction (entities, topics, SVO triples, key phrases)
+- Explainable search results with human + audit explanations
+- Cryptographic provenance tracking with hash chain verification
+- ULID-based identity firewall for cryptographic tenant isolation
+- Scope-based access control (user, team, client, organization)
+- PII detection and configurable handling (extract_and_redact, hash, reject)
+- Type-safe API with Pydantic models
+- Comprehensive error handling (7 exception types)
+- 30+ unit and integration tests
+
+### Known Limitations
+- Pagination not yet implemented (coming in v1.1.0)
+- Streaming search results not yet available
+- Temporal intelligence parameter present but not fully validated in tests
+
+### Fixed
+- Corrected `ProvenanceError` exception name (was misspelled as `ProvenenaceError`)
+
+## [Unreleased]
+
+### Planned for v1.1.0
+- Cursor-based pagination for search results
+- Enhanced temporal intelligence validation
+- Circuit breaker and retry logic
+- Performance benchmarks published
+
+### Planned for v2.0.0
+- Streaming search results
+- Batch processing operations
+- GraphQL API support
+- React hooks companion package (@memoryintelligence/react)
+
+[1.0.0]: https://github.com/memoryintelligence/sdk-python/releases/tag/v1.0.0
+[Unreleased]: https://github.com/memoryintelligence/sdk-python/compare/v1.0.0...HEAD

memoryintelligence-1.0.1/MANIFEST.in

@@ -0,0 +1,21 @@
+# Include essential files
+include README.md
+include LICENSE
+include CHANGELOG.md
+
+# Include package data
+recursive-include memoryintelligence *.py
+
+# Exclude development files
+exclude .gitignore
+exclude .env*
+recursive-exclude tests *
+recursive-exclude demos *
+recursive-exclude examples *
+recursive-exclude .venv *
+recursive-exclude __pycache__ *
+recursive-exclude *.egg-info *
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude *~
+global-exclude .DS_Store

memoryintelligence-1.0.1/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: memoryintelligence
+Version: 1.0.1
+Summary: Official Python SDK for Memory Intelligence - Verifiable meaning infrastructure for AI
+Author-email: Memory Intelligence Team <sdk@memoryintelligence.dev>
+Maintainer-email: Memory Intelligence Team <sdk@memoryintelligence.dev>
+License-Expression: MIT
+Project-URL: Homepage, https://memoryintelligence.dev
+Project-URL: Documentation, https://docs.memoryintelligence.dev
+Project-URL: Repository, https://github.com/memoryintelligence/sdk-python
+Project-URL: Changelog, https://github.com/memoryintelligence/sdk-python/blob/main/CHANGELOG.md
+Keywords: ai,llm,memory,rag,embeddings,nlp,privacy,compliance,hipaa,gdpr,provenance
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Dynamic: license-file
+
+# Memory Intelligence SDK
+
+The official Python SDK for Memory Intelligence - Verifiable meaning infrastructure for AI.
+
+[![PyPI](https://img.shields.io/pypi/v/memoryintelligence.svg)](https://pypi.org/project/memoryintelligence/)
+[![License](https://img.shields.io/pypi/l/memoryintelligence.svg)](https://pypi.org/project/memoryintelligence/)
+
+## Quick Start
+
+```python
+from memoryintelligence import MemoryClient
+
+# Initialize client
+mi = MemoryClient(api_key="mi_sk_...")
+
+# Process content → meaning
+umo = mi.process("Meeting notes from today", user_ulid="01ABC...")
+
+# Search meaning
+results = mi.search("What did we discuss?", user_ulid="01ABC...", explain=True)
+
+# Match for recommendations
+match = mi.match("01ABC...", "01XYZ...", explain=True)
+
+# Delete for GDPR
+mi.delete(user_ulid="01ABC...")
+```
+
+## Key Features
+
+- **Meaning-First Architecture**: Raw content discarded after processing
+- **Five Core Operations**: Process, Search, Match, Explain, Delete
+- **Provenance Tracking**: Cryptographic verification of content lineage
+- **GDPR Compliance**: One-call data deletion with audit proof
+- **Built-in Telemetry**: Debug logs for content processing
+- **Simplified API**: Only 12 essential exports
+
+## Usage Guide
+
+### Initialize the Client
+
+```python
+from memoryintelligence import MemoryClient
+
+# For production (API key required)
+mi = MemoryClient(api_key="mi_sk_prod_...")
+
+# For development
+mi = MemoryClient(api_key="mi_sk_dev_...")
+```
+
+### Process Content
+
+Convert raw content to meaning (discards raw content by default):
+
+```python
+umo = mi.process(
+    "Budget approved for Q3 initiatives",
+    user_ulid="01ABC...",
+    retention_policy="meaning_only"
+)
+```
+
+### Search for Meaning
+
+Find relevant memories with explanation:
+
+```python
+results = mi.search(
+    "Q3 budget decisions",
+    user_ulid="01ABC...",
+    explain=True,
+    limit=5
+)
+```
+
+### Match for Recommendations
+
+Compare two memories for relevance:
+
+```python
+match = mi.match(
+    source_ulid="01ABC...",
+    candidate_ulid="01XYZ...",
+    explain=True
+)
+```
+
+### Get Explanations
+
+Understand why content is relevant:
+
+```python
+explanation = mi.explain(umo.umo_id)
+print(explanation.human.summary)
+```
+
+### Delete Data
+
+GDPR-compliant data removal:
+
+```python
+result = mi.delete(user_ulid="01ABC...")
+print(f"Deleted {result.deleted_count} memories")
+```
+
+## Monitoring & Telemetry
+
+The SDK provides built-in telemetry for operational visibility:
+
+```python
+import logging
+logging.basicConfig(level=logging.DEBUG)
+```
+
+### Key Log Events:
+- `DEBUG`: Content processing metrics (size, time)
+- `INFO`: Operation completion with results
+- `WARNING`: PII detection events
+- `ERROR`: API and integration errors
+
+### Dashboard Setup
+
+1. Run the smoke test to generate sample telemetry:
+   ```bash
+   python sdk_smoke_test.py
+   ```
+2. Set up log collection with your monitoring system
+3. Import the included Grafana dashboard template:
+   ```bash
+   grafana-cli dashboard import grafana_dashboard.json
+   ```
+
+## Documentation
+
+Full documentation is available at:
+- [API Reference](https://docs.memoryintelligence.dev)
+- [Getting Started Guide](https://memoryintelligence.dev/docs/getting-started)
+
+## Support
+
+For SDK issues, please contact:
+- support@memoryintelligence.dev
+- GitHub Issues: [Create New Issue](https://github.com/memoryintelligence/sdk-python/issues/new)
+
+## License
+
+This SDK is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

memoryintelligence-1.0.1/README.md

@@ -0,0 +1,148 @@
+# Memory Intelligence SDK
+
+The official Python SDK for Memory Intelligence - Verifiable meaning infrastructure for AI.
+
+[![PyPI](https://img.shields.io/pypi/v/memoryintelligence.svg)](https://pypi.org/project/memoryintelligence/)
+[![License](https://img.shields.io/pypi/l/memoryintelligence.svg)](https://pypi.org/project/memoryintelligence/)
+
+## Quick Start
+
+```python
+from memoryintelligence import MemoryClient
+
+# Initialize client
+mi = MemoryClient(api_key="mi_sk_...")
+
+# Process content → meaning
+umo = mi.process("Meeting notes from today", user_ulid="01ABC...")
+
+# Search meaning
+results = mi.search("What did we discuss?", user_ulid="01ABC...", explain=True)
+
+# Match for recommendations
+match = mi.match("01ABC...", "01XYZ...", explain=True)
+
+# Delete for GDPR
+mi.delete(user_ulid="01ABC...")
+```
+
+## Key Features
+
+- **Meaning-First Architecture**: Raw content discarded after processing
+- **Five Core Operations**: Process, Search, Match, Explain, Delete
+- **Provenance Tracking**: Cryptographic verification of content lineage
+- **GDPR Compliance**: One-call data deletion with audit proof
+- **Built-in Telemetry**: Debug logs for content processing
+- **Simplified API**: Only 12 essential exports
+
+## Usage Guide
+
+### Initialize the Client
+
+```python
+from memoryintelligence import MemoryClient
+
+# For production (API key required)
+mi = MemoryClient(api_key="mi_sk_prod_...")
+
+# For development
+mi = MemoryClient(api_key="mi_sk_dev_...")
+```
+
+### Process Content
+
+Convert raw content to meaning (discards raw content by default):
+
+```python
+umo = mi.process(
+    "Budget approved for Q3 initiatives",
+    user_ulid="01ABC...",
+    retention_policy="meaning_only"
+)
+```
+
+### Search for Meaning
+
+Find relevant memories with explanation:
+
+```python
+results = mi.search(
+    "Q3 budget decisions",
+    user_ulid="01ABC...",
+    explain=True,
+    limit=5
+)
+```
+
+### Match for Recommendations
+
+Compare two memories for relevance:
+
+```python
+match = mi.match(
+    source_ulid="01ABC...",
+    candidate_ulid="01XYZ...",
+    explain=True
+)
+```
+
+### Get Explanations
+
+Understand why content is relevant:
+
+```python
+explanation = mi.explain(umo.umo_id)
+print(explanation.human.summary)
+```
+
+### Delete Data
+
+GDPR-compliant data removal:
+
+```python
+result = mi.delete(user_ulid="01ABC...")
+print(f"Deleted {result.deleted_count} memories")
+```
+
+## Monitoring & Telemetry
+
+The SDK provides built-in telemetry for operational visibility:
+
+```python
+import logging
+logging.basicConfig(level=logging.DEBUG)
+```
+
+### Key Log Events:
+- `DEBUG`: Content processing metrics (size, time)
+- `INFO`: Operation completion with results
+- `WARNING`: PII detection events
+- `ERROR`: API and integration errors
+
+### Dashboard Setup
+
+1. Run the smoke test to generate sample telemetry:
+   ```bash
+   python sdk_smoke_test.py
+   ```
+2. Set up log collection with your monitoring system
+3. Import the included Grafana dashboard template:
+   ```bash
+   grafana-cli dashboard import grafana_dashboard.json
+   ```
+
+## Documentation
+
+Full documentation is available at:
+- [API Reference](https://docs.memoryintelligence.dev)
+- [Getting Started Guide](https://memoryintelligence.dev/docs/getting-started)
+
+## Support
+
+For SDK issues, please contact:
+- support@memoryintelligence.dev
+- GitHub Issues: [Create New Issue](https://github.com/memoryintelligence/sdk-python/issues/new)
+
+## License
+
+This SDK is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

{memoryintelligence-1.0.0 → memoryintelligence-1.0.1}/memoryintelligence/__init__.py

@@ -45,7 +45,7 @@ Version: 1.0.0
 Author: Memory Intelligence Team
 """
 
-__version__ = "1.0.0"
+__version__ = "1.0.1"
 __author__ = "Memory Intelligence Team"
 
 # ============================================================================
@@ -54,7 +54,7 @@ __author__ = "Memory Intelligence Team"
 
 # Main clients
 from .memory_client import MemoryClient
-from .edge_client import EdgeClient, connect_edge
+from .edge_client import EdgeClient
 
 # Enums
 from .mi_types import (
@@ -98,7 +98,7 @@ from .mi_types import (
     ScopeViolationError,
     PIIViolationError,
     GovernanceError,
-    ProvenenaceError,
+    ProvenanceError,
 )
 
 # ============================================================================
@@ -112,7 +112,6 @@ __all__ = [
     # Clients
     "MemoryClient",
     "EdgeClient",
-    "connect_edge",
     
     # Enums
     "Scope",
@@ -149,5 +148,5 @@ __all__ = [
     "ScopeViolationError",
     "PIIViolationError",
     "GovernanceError",
-    "ProvenenaceError",
+    "ProvenanceError",
 ]

{memoryintelligence-1.0.0 → memoryintelligence-1.0.1}/memoryintelligence/memory_client.py

@@ -74,7 +74,7 @@ from .mi_types import (
     GovernanceError,
 )
 
-logger = logging.getLogger(__name__)
+logger = logging.getLogger('memoryintelligence')
 
 
 # ============================================================================
@@ -242,7 +242,9 @@ class MemoryClient:
         if self.org_ulid:
             payload["org_ulid"] = self.org_ulid
         
+        logger.debug("Processing content of length %d", len(content))
         response = self._request("POST", "/v1/process", json=payload)
+        logger.info("Successfully processed content")
         return self._parse_meaning_object(response)
     
     # ========================================================================

{memoryintelligence-1.0.0 → memoryintelligence-1.0.1}/memoryintelligence/mi_types.py

@@ -359,6 +359,6 @@ class GovernanceError(MIError):
     pass
 
 
-class ProvenenaceError(MIError):
+class ProvenanceError(MIError):
     """Provenance verification failed."""
     pass

memoryintelligence-1.0.1/memoryintelligence.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+CHANGELOG.md
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+memoryintelligence/__init__.py
+memoryintelligence/edge_client.py
+memoryintelligence/memory_client.py
+memoryintelligence/mi_types.py

{memoryintelligence-1.0.0 → memoryintelligence-1.0.1}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "memoryintelligence"
-version = "1.0.0"
+version = "1.0.1"
 description = "Official Python SDK for Memory Intelligence - Verifiable meaning infrastructure for AI"
 readme = "README.md"
-license = {text = "MIT"}
+license = "MIT"
 authors = [
     {name = "Memory Intelligence Team", email = "sdk@memoryintelligence.dev"}
 ]
@@ -30,7 +30,6 @@ keywords = [
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.9",
@@ -64,6 +63,7 @@ Changelog = "https://github.com/memoryintelligence/sdk-python/blob/main/CHANGELO
 [tool.setuptools.packages.find]
 where = ["."]
 include = ["memoryintelligence*"]
+exclude = ["tests*", "demos*", "examples*"]
 
 [tool.mypy]
 python_version = "3.9"