rememhq 0.1.5__tar.gz

rememhq-0.1.5/.gitignore

@@ -0,0 +1,147 @@
+# ========================
+# Rust
+# ========================
+/target/
+**/*.rs.bk
+# Note: Cargo.lock is tracked intentionally — this workspace produces binary crates
+
+# ========================
+# C++ (libremem — v0.2+)
+# ========================
+/build/
+/libremem/build/
+*.o
+*.a
+*.so
+*.dylib
+*.dll
+*.lib
+*.exe
+cmake-build-*/
+CMakeFiles/
+CMakeCache.txt
+
+# ========================
+# Python SDK
+# ========================
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+.eggs/
+.venv/
+venv/
+ENV/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+htmlcov/
+.coverage
+.coverage.*
+*.cover
+
+# ========================
+# TypeScript SDK
+# ========================
+node_modules/
+dist/
+*.tsbuildinfo
+.turbo/
+coverage/
+*.js.map
+
+# ========================
+# Models (large binaries)
+# ========================
+models/*.gguf
+models/*.onnx
+models/*.bin
+models/*.safetensors
+
+# ========================
+# remem runtime data
+# ========================
+.remem/
+*.db
+*.db-wal
+*.db-shm
+*.index.json
+
+# ========================
+# Docker
+# ========================
+.docker/
+
+# ========================
+# IDE / Editor
+# ========================
+.vscode/
+!.vscode/settings.json
+!.vscode/extensions.json
+.idea/
+*.swp
+*.swo
+*~
+*.sublime-workspace
+*.sublime-project
+
+# ========================
+# OS generated
+# ========================
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+desktop.ini
+
+# ========================
+# Environment / Secrets
+# ========================
+.env
+.env.*
+!.env.example
+
+# ========================
+# Agent / AI tool configs
+# ========================
+.claude/**/*
+!.claude/config.json
+.codex/
+.gemini/
+.cursor/**/*
+!.cursor/hooks.json
+
+# ========================
+# Misc
+# ========================
+*.log
+*.tmp
+*.bak
+*.orig
+
+# ========================
+# Swift Package Manager
+# ========================
+bindings/swift/.build/
+bindings/swift/.swiftpm/
+bindings/swift/Package.resolved
+
+# ========================
+# React Native / Expo module (bindings/react-native)
+# ========================
+bindings/react-native/build/
+bindings/react-native/ios/Pods/
+bindings/react-native/ios/build/
+bindings/react-native/android/build/
+bindings/react-native/android/.gradle/
+bindings/react-native/android/.cxx/
+bindings/react-native/android/rust/target/
+bindings/react-native/example/node_modules/
+bindings/react-native/example/ios/
+bindings/react-native/example/android/
+bindings/react-native/example/.expo/

rememhq-0.1.5/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: rememhq
+Version: 0.1.5
+Summary: Reasoning memory layer for AI agents — Python SDK
+Project-URL: Homepage, https://github.com/remem-io/remem
+Project-URL: Repository, https://github.com/remem-io/remem
+Project-URL: Issues, https://github.com/remem-io/remem/issues
+Project-URL: Changelog, https://github.com/remem-io/remem/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/remem-io/remem/tree/main/sdk/python
+Author-email: remem-io <thrive-spectrexq@users.noreply.github.com>
+License-Expression: Apache-2.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Database
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Provides-Extra: autogen
+Requires-Dist: autogen-agentchat>=0.4; extra == 'autogen'
+Provides-Extra: crewai
+Requires-Dist: crewai>=0.80; extra == 'crewai'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.3; extra == 'langchain'
+Provides-Extra: llamaindex
+Requires-Dist: llama-index-core>=0.11; extra == 'llamaindex'
+Description-Content-Type: text/markdown
+
+# remem Python SDK
+
+This is the Python SDK for remem, providing a typed interface over the REST API.
+
+## Installation
+
+```bash
+pip install rememhq
+```
+
+## Quick Start
+
+```python
+from rememhq import Memory
+
+memory = Memory(base_url="http://localhost:7474")
+
+# Store a memory
+await memory.store("User prefers Python", tags=["language"])
+
+# Recall memories
+results = await memory.recall("what language does the user prefer?")
+for result in results:
+    print(f"Content: {result.content}")
+    print(f"Reasoning: {result.reasoning}")
+```
+
+## Development
+
+### Prerequisites
+
+- **Python** 3.11+
+- **pip** or **uv**
+
+### Setup
+
+```bash
+cd sdk/python
+
+# Install in development mode with dev dependencies
+pip install -e ".[dev]"
+```
+
+### Testing
+
+```bash
+# Run all tests
+pytest tests/ -v
+
+# Run with coverage
+pytest tests/ --cov=rememhq
+
+# Run specific test
+pytest tests/test_memory.py -v
+```
+
+### Code Quality
+
+```bash
+# Format code
+black rememhq/ tests/
+
+# Lint
+ruff check rememhq/ tests/
+
+# Type checking
+mypy rememhq/
+```
+
+### Building
+
+```bash
+# Build distribution
+python -m build
+
+# Install locally from build
+pip install dist/rememhq-*.whl
+```
+
+## Running the API Server
+
+Before using the SDK, start the remem API server from the repository root:
+
+```bash
+cargo run -p rememhq-api -- --project default
+```
+
+The API will be available at `http://localhost:7474` by default.
+
+## API Reference
+
+### Memory
+
+#### `store(content: str, tags: Optional[List[str]] = None, importance: Optional[float] = None) -> StoreResponse`
+
+Store a memory with optional tags and importance score.
+
+```python
+response = await memory.store(
+    "Production database is PostgreSQL 15",
+    tags=["infra", "database"],
+    importance=0.95
+)
+```
+
+#### `recall(query: str, limit: int = 8) -> List[RecallResult]`
+
+Retrieve memories most relevant to the query, with reasoning traces.
+
+```python
+results = await memory.recall("what database are we using?", limit=8)
+for result in results:
+    print(f"Content: {result.content}")
+    print(f"Score: {result.score}")
+    print(f"Reasoning: {result.reasoning}")
+```
+
+#### `search(query: str, limit: int = 10) -> List[SearchResult]`
+
+Full-text search over all memories.
+
+```python
+results = await memory.search("deployment", limit=10)
+```
+
+#### `update(memory_id: str, content: str) -> UpdateResponse`
+
+Update an existing memory's content.
+
+#### `forget(memory_id: str) -> ForgetResponse`
+
+Delete a memory.
+
+#### `consolidate(session_id: str) -> ConsolidateResponse`
+
+Consolidate session logs into durable facts.
+
+## Configuration
+
+Configure the SDK via constructor parameters or environment variables:
+
+```python
+from rememhq import Memory
+
+memory = Memory(
+    base_url="http://localhost:7474",
+    project="my-agent",
+    reasoning_model="claude-sonnet-4-6",
+    timeout=30.0
+)
+```
+
+**Environment variables:**
+- `REMEM_API_URL` — API server URL (default: `http://localhost:7474`)
+- `REMEM_PROJECT` — Project name (default: `default`)
+- `REMEM_REASONING_MODEL` — Reasoning model (default: `claude-sonnet-4-6`)
+- `REMEM_TIMEOUT` — Request timeout in seconds (default: `30`)
+
+## Examples
+
+Check the `examples/` directory for complete working scripts.
+
+## Contributing
+
+See [CONTRIBUTING.md](../../CONTRIBUTING.md) for guidelines on contributing to the Python SDK.
+
+## License
+
+Apache License 2.0 — See [LICENSE](../../LICENSE) for details.

rememhq-0.1.5/README.md

@@ -0,0 +1,169 @@
+# remem Python SDK
+
+This is the Python SDK for remem, providing a typed interface over the REST API.
+
+## Installation
+
+```bash
+pip install rememhq
+```
+
+## Quick Start
+
+```python
+from rememhq import Memory
+
+memory = Memory(base_url="http://localhost:7474")
+
+# Store a memory
+await memory.store("User prefers Python", tags=["language"])
+
+# Recall memories
+results = await memory.recall("what language does the user prefer?")
+for result in results:
+    print(f"Content: {result.content}")
+    print(f"Reasoning: {result.reasoning}")
+```
+
+## Development
+
+### Prerequisites
+
+- **Python** 3.11+
+- **pip** or **uv**
+
+### Setup
+
+```bash
+cd sdk/python
+
+# Install in development mode with dev dependencies
+pip install -e ".[dev]"
+```
+
+### Testing
+
+```bash
+# Run all tests
+pytest tests/ -v
+
+# Run with coverage
+pytest tests/ --cov=rememhq
+
+# Run specific test
+pytest tests/test_memory.py -v
+```
+
+### Code Quality
+
+```bash
+# Format code
+black rememhq/ tests/
+
+# Lint
+ruff check rememhq/ tests/
+
+# Type checking
+mypy rememhq/
+```
+
+### Building
+
+```bash
+# Build distribution
+python -m build
+
+# Install locally from build
+pip install dist/rememhq-*.whl
+```
+
+## Running the API Server
+
+Before using the SDK, start the remem API server from the repository root:
+
+```bash
+cargo run -p rememhq-api -- --project default
+```
+
+The API will be available at `http://localhost:7474` by default.
+
+## API Reference
+
+### Memory
+
+#### `store(content: str, tags: Optional[List[str]] = None, importance: Optional[float] = None) -> StoreResponse`
+
+Store a memory with optional tags and importance score.
+
+```python
+response = await memory.store(
+    "Production database is PostgreSQL 15",
+    tags=["infra", "database"],
+    importance=0.95
+)
+```
+
+#### `recall(query: str, limit: int = 8) -> List[RecallResult]`
+
+Retrieve memories most relevant to the query, with reasoning traces.
+
+```python
+results = await memory.recall("what database are we using?", limit=8)
+for result in results:
+    print(f"Content: {result.content}")
+    print(f"Score: {result.score}")
+    print(f"Reasoning: {result.reasoning}")
+```
+
+#### `search(query: str, limit: int = 10) -> List[SearchResult]`
+
+Full-text search over all memories.
+
+```python
+results = await memory.search("deployment", limit=10)
+```
+
+#### `update(memory_id: str, content: str) -> UpdateResponse`
+
+Update an existing memory's content.
+
+#### `forget(memory_id: str) -> ForgetResponse`
+
+Delete a memory.
+
+#### `consolidate(session_id: str) -> ConsolidateResponse`
+
+Consolidate session logs into durable facts.
+
+## Configuration
+
+Configure the SDK via constructor parameters or environment variables:
+
+```python
+from rememhq import Memory
+
+memory = Memory(
+    base_url="http://localhost:7474",
+    project="my-agent",
+    reasoning_model="claude-sonnet-4-6",
+    timeout=30.0
+)
+```
+
+**Environment variables:**
+- `REMEM_API_URL` — API server URL (default: `http://localhost:7474`)
+- `REMEM_PROJECT` — Project name (default: `default`)
+- `REMEM_REASONING_MODEL` — Reasoning model (default: `claude-sonnet-4-6`)
+- `REMEM_TIMEOUT` — Request timeout in seconds (default: `30`)
+
+## Examples
+
+Check the `examples/` directory for complete working scripts.
+
+## Contributing
+
+See [CONTRIBUTING.md](../../CONTRIBUTING.md) for guidelines on contributing to the Python SDK.
+
+## License
+
+Apache License 2.0 — See [LICENSE](../../LICENSE) for details.

rememhq-0.1.5/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "rememhq"
+version = "0.1.5"
+description = "Reasoning memory layer for AI agents — Python SDK"
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.11"
+authors = [
+    { name = "remem-io", email = "thrive-spectrexq@users.noreply.github.com" },
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Database",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx>=0.27",
+    "pydantic>=2.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/remem-io/remem"
+Repository = "https://github.com/remem-io/remem"
+Issues = "https://github.com/remem-io/remem/issues"
+Changelog = "https://github.com/remem-io/remem/blob/main/CHANGELOG.md"
+Documentation = "https://github.com/remem-io/remem/tree/main/sdk/python"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "pytest-cov>=5.0",
+    "respx>=0.21",
+]
+langchain = ["langchain-core>=0.3"]
+llamaindex = ["llama-index-core>=0.11"]
+autogen = ["autogen-agentchat>=0.4"]
+crewai = ["crewai>=0.80"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.sdist]
+include = ["rememhq/"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["rememhq"]

rememhq-0.1.5/rememhq/__init__.py

@@ -0,0 +1,7 @@
+"""remem — reasoning memory layer for AI agents."""
+
+from rememhq.client import Memory
+from rememhq.models import MemoryResult, ConsolidationReport, StoreResponse
+
+__all__ = ["Memory", "MemoryResult", "ConsolidationReport", "StoreResponse"]
+__version__ = "0.1.5"

rememhq-0.1.5/rememhq/client.py

@@ -0,0 +1,269 @@
+"""Async-first Python client for the remem REST API."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from uuid import UUID
+
+import httpx
+
+from rememhq.config import RememConfig
+from rememhq.models import (
+    ConsolidationReport,
+    CompactResponse,
+    ForgetMode,
+    MemoryResult,
+    MemoryType,
+    StoreResponse,
+    MemoryStoreRecord,
+    MemoryVersionRecord,
+)
+
+
+class Memory:
+    """Async client for remem — reasoning memory layer for AI agents.
+
+    Example:
+        >>> m = Memory(project="my-agent", reasoning_model="claude-sonnet-4-5")
+        >>> await m.store("User prefers dark mode", tags=["preferences"])
+        >>> results = await m.recall("what are the user's preferences?")
+    """
+
+    def __init__(
+        self,
+        project: str = "default",
+        reasoning_model: str = "claude-sonnet-4-5",
+        scoring_model: str = "claude-haiku-4-5",
+        base_url: str | None = None,
+        api_key: str | None = None,
+        timeout: float = 30.0,
+    ):
+        config = RememConfig(
+            project=project,
+            reasoning_model=reasoning_model,
+            scoring_model=scoring_model,
+            timeout=timeout,
+        )
+        if base_url:
+            config.base_url = base_url
+        if api_key:
+            config.api_key = api_key
+
+        self._config = config
+        headers: dict[str, str] = {"Content-Type": "application/json"}
+        if config.api_key:
+            headers["Authorization"] = f"Bearer {config.api_key}"
+
+        self._client = httpx.AsyncClient(
+            base_url=config.base_url,
+            headers=headers,
+            timeout=config.timeout,
+        )
+        self.stores = MemoryStoresClient(self._client)
+
+    async def store(
+        self,
+        content: str,
+        *,
+        tags: list[str] | None = None,
+        importance: float | None = None,
+        ttl_days: int | None = None,
+        memory_type: MemoryType = MemoryType.FACT,
+    ) -> StoreResponse:
+        """Store a new memory with automatic LLM importance scoring."""
+        payload: dict = {
+            "content": content,
+            "tags": tags or [],
+            "memory_type": memory_type.value,
+        }
+        if importance is not None:
+            payload["importance"] = importance
+        if ttl_days is not None:
+            payload["ttl_days"] = ttl_days
+
+        resp = await self._client.post("/v1/memories", json=payload)
+        resp.raise_for_status()
+        return StoreResponse.model_validate(resp.json())
+
+    async def recall(
+        self,
+        query: str,
+        *,
+        limit: int = 8,
+        filter_tags: list[str] | None = None,
+        since: datetime | None = None,
+        memory_type: MemoryType | None = None,
+    ) -> list[MemoryResult]:
+        """Guided recall — LLM re-ranks candidates for relevance."""
+        params: dict = {"q": query, "limit": limit}
+        if filter_tags:
+            params["filter_tags"] = ",".join(filter_tags)
+        if since:
+            params["since"] = since.isoformat()
+        if memory_type:
+            params["memory_type"] = memory_type.value
+
+        resp = await self._client.get("/v1/memories/recall", params=params)
+        resp.raise_for_status()
+        return [MemoryResult.model_validate(r) for r in resp.json()]
+
+    async def search(
+        self,
+        query: str,
+        *,
+        limit: int = 20,
+        filter_tags: list[str] | None = None,
+    ) -> list[MemoryResult]:
+        """Hybrid vector + keyword search without LLM re-ranking."""
+        params: dict = {"q": query, "limit": limit}
+        if filter_tags:
+            params["filter_tags"] = ",".join(filter_tags)
+
+        resp = await self._client.get("/v1/memories/search", params=params)
+        resp.raise_for_status()
+        return [MemoryResult.model_validate(r) for r in resp.json()]
+
+    async def update(
+        self,
+        id: UUID | str,
+        *,
+        content: str | None = None,
+        importance: float | None = None,
+        tags: list[str] | None = None,
+    ) -> dict:
+        """Update an existing memory."""
+        payload: dict = {}
+        if content is not None:
+            payload["content"] = content
+        if importance is not None:
+            payload["importance"] = importance
+        if tags is not None:
+            payload["tags"] = tags
+
+        resp = await self._client.patch(f"/v1/memories/{id}", json=payload)
+        resp.raise_for_status()
+        return resp.json()
+
+    async def forget(
+        self,
+        id: UUID | str,
+        *,
+        mode: ForgetMode = ForgetMode.DELETE,
+    ) -> dict:
+        """Delete, decay, or archive a memory."""
+        resp = await self._client.delete(
+            f"/v1/memories/{id}", params={"mode": mode.value}
+        )
+        resp.raise_for_status()
+        return resp.json()
+
+    async def consolidate(
+        self,
+        session_id: str,
+        *,
+        model: str | None = None,
+    ) -> ConsolidationReport:
+        """Trigger consolidation over a session's working memory."""
+        payload: dict = {}
+        if model:
+            payload["model"] = model
+
+        resp = await self._client.post(
+            f"/v1/sessions/{session_id}/consolidate", json=payload
+        )
+        resp.raise_for_status()
+        return ConsolidationReport.model_validate(resp.json())
+
+    async def decay(self, factor: float = 0.9) -> dict:
+        """Apply importance-weighted decay to all active memories."""
+        resp = await self._client.post("/v1/memories/decay", json={"factor": factor})
+        resp.raise_for_status()
+        return resp.json()
+
+    async def compact_context(
+        self,
+        conversation_text: str,
+        *,
+        focus_areas: list[str] | None = None,
+    ) -> CompactResponse:
+        """Compact a conversation trace to save context window tokens."""
+        payload: dict = {"conversation_text": conversation_text}
+        if focus_areas is not None:
+            payload["focus_areas"] = focus_areas
+
+        resp = await self._client.post("/v1/memories/compact", json=payload)
+        resp.raise_for_status()
+        return CompactResponse.model_validate(resp.json())
+
+    async def close(self) -> None:
+        """Close the HTTP client."""
+        await self._client.aclose()
+
+    async def __aenter__(self) -> "Memory":
+        return self
+
+    async def __aexit__(self, *args) -> None:
+        await self.close()
+
+class StoreMemoriesClient:
+    def __init__(self, client: httpx.AsyncClient):
+        self._client = client
+
+    async def list(self, store_id: str | UUID) -> list[MemoryResult]:
+        resp = await self._client.get(f"/v1/memory_stores/{store_id}/memories")
+        resp.raise_for_status()
+        return [MemoryResult.model_validate(r) for r in resp.json()]
+
+    async def create(self, store_id: str | UUID, path: str, content: str) -> MemoryResult:
+        resp = await self._client.post(
+            f"/v1/memory_stores/{store_id}/memories",
+            json={"path": path, "content": content}
+        )
+        resp.raise_for_status()
+        return MemoryResult.model_validate(resp.json())
+
+    async def get(self, store_id: str | UUID, path_or_id: str | UUID) -> MemoryResult:
+        resp = await self._client.get(f"/v1/memory_stores/{store_id}/memories/{path_or_id}")
+        resp.raise_for_status()
+        return MemoryResult.model_validate(resp.json())
+
+    async def update(self, store_id: str | UUID, path_or_id: str | UUID, content: str) -> MemoryResult:
+        resp = await self._client.post(
+            f"/v1/memory_stores/{store_id}/memories/{path_or_id}",
+            json={"content": content}
+        )
+        resp.raise_for_status()
+        return MemoryResult.model_validate(resp.json())
+        
+    async def list_versions(self, store_id: str | UUID, path_or_id: str | UUID) -> list[MemoryVersionRecord]:
+        resp = await self._client.get(f"/v1/memory_stores/{store_id}/memories/{path_or_id}/versions")
+        resp.raise_for_status()
+        return [MemoryVersionRecord.model_validate(r) for r in resp.json()]
+
+
+class MemoryStoresClient:
+    def __init__(self, client: httpx.AsyncClient):
+        self._client = client
+        self.memories = StoreMemoriesClient(client)
+
+    async def create(self, name: str, description: str | None = None) -> MemoryStoreRecord:
+        payload = {"name": name}
+        if description:
+            payload["description"] = description
+        resp = await self._client.post("/v1/memory_stores", json=payload)
+        resp.raise_for_status()
+        return MemoryStoreRecord.model_validate(resp.json())
+
+    async def list(self) -> list[MemoryStoreRecord]:
+        resp = await self._client.get("/v1/memory_stores")
+        resp.raise_for_status()
+        return [MemoryStoreRecord.model_validate(r) for r in resp.json()]
+
+    async def get(self, store_id: str | UUID) -> MemoryStoreRecord:
+        resp = await self._client.get(f"/v1/memory_stores/{store_id}")
+        resp.raise_for_status()
+        return MemoryStoreRecord.model_validate(resp.json())
+
+    async def archive(self, store_id: str | UUID) -> None:
+        resp = await self._client.post(f"/v1/memory_stores/{store_id}/archive")
+        resp.raise_for_status()

rememhq-0.1.5/rememhq/config.py

@@ -0,0 +1,32 @@
+"""Configuration for the remem Python SDK."""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass, field
+
+
+@dataclass
+class RememConfig:
+    """Configuration for connecting to a remem server."""
+
+    base_url: str = field(
+        default_factory=lambda: os.environ.get(
+            "REMEM_BASE_URL", "http://localhost:7474"
+        )
+    )
+    api_key: str | None = field(default_factory=lambda: os.environ.get("REMEM_API_KEY"))
+    project: str = field(
+        default_factory=lambda: os.environ.get("REMEM_PROJECT", "default")
+    )
+    reasoning_model: str = field(
+        default_factory=lambda: os.environ.get(
+            "REMEM_REASONING_MODEL", "claude-sonnet-4-5"
+        )
+    )
+    scoring_model: str = field(
+        default_factory=lambda: os.environ.get(
+            "REMEM_SCORING_MODEL", "claude-haiku-4-5"
+        )
+    )
+    timeout: float = 30.0

rememhq-0.1.5/rememhq/models.py

@@ -0,0 +1,90 @@
+"""Pydantic v2 models for the remem REST API."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from enum import Enum
+from typing import Optional
+from uuid import UUID
+
+from pydantic import BaseModel, Field
+
+
+class MemoryType(str, Enum):
+    FACT = "fact"
+    PROCEDURE = "procedure"
+    PREFERENCE = "preference"
+    DECISION = "decision"
+
+
+class ForgetMode(str, Enum):
+    DELETE = "delete"
+    DECAY = "decay"
+    ARCHIVE = "archive"
+
+
+class StoreResponse(BaseModel):
+    id: UUID
+    importance: float
+    tags: list[str]
+    created_at: datetime
+
+
+class CompactResponse(BaseModel):
+    compressed_context: str
+    original_length: int
+    compressed_length: int
+
+
+class MemoryResult(BaseModel):
+    id: UUID
+    content: str
+    importance: float
+    tags: list[str]
+    memory_type: MemoryType
+    created_at: datetime
+    source_session: Optional[str] = None
+    similarity: float = 0.0
+    decay_score: float = 1.0
+    reasoning: Optional[str] = None
+
+
+class ConsolidationReport(BaseModel):
+    session_id: str
+    new_facts: int
+    updated_facts: int
+    contradictions: list[Contradiction] = Field(default_factory=list)
+    knowledge_graph_updates: list[KnowledgeGraphUpdate] = Field(default_factory=list)
+
+
+class Contradiction(BaseModel):
+    existing_memory_id: UUID
+    new_content: str
+    existing_content: str
+    explanation: str
+
+
+class KnowledgeGraphUpdate(BaseModel):
+    subject: str
+    predicate: str
+    object: str
+
+
+# Fix forward references
+ConsolidationReport.model_rebuild()
+
+class MemoryStoreRecord(BaseModel):
+    id: str
+    name: str
+    description: Optional[str] = None
+    created_at: datetime
+    archived_at: Optional[datetime] = None
+
+class MemoryVersionRecord(BaseModel):
+    id: str
+    store_id: str
+    memory_id: UUID
+    operation: str
+    content: str
+    content_sha256: str
+    created_at: datetime