remdb 0.3.122__tar.gz → 0.3.157__tar.gz

{remdb-0.3.122 → remdb-0.3.157}/.env.example

@@ -28,6 +28,13 @@ API__PORT=8000
 API__RELOAD=true
 API__LOG_LEVEL=info
 
+# --- API Key Authentication ---
+# Simple API key auth for programmatic access (independent of OAuth)
+# When enabled, all /api/v1/* requests must include X-API-Key header
+# Generate key: python -c "import secrets; print(secrets.token_urlsafe(32))"
+API__API_KEY_ENABLED=false
+API__API_KEY=
+
 # =============================================================================
 # LLM Provider Settings
 # =============================================================================
@@ -37,7 +44,7 @@ LLM__MAX_RETRIES=10
 
 # Optional: Override models for specific tasks
 # LLM__EVALUATOR_MODEL=gpt-4.1
-# LLM__QUERY_AGENT_MODEL=gpt-4o-mini
+# LLM__QUERY_AGENT_MODEL=gpt-4.1-mini
 
 # API Keys (required for LLM providers)
 LLM__OPENAI_API_KEY=
@@ -71,6 +78,20 @@ AUTH__MICROSOFT__CLIENT_SECRET=
 AUTH__MICROSOFT__REDIRECT_URI=http://localhost:8000/api/auth/microsoft/callback
 AUTH__MICROSOFT__TENANT=common
 
+# =============================================================================
+# Email Settings (Passwordless Login)
+# =============================================================================
+# Email login uses verification codes - no password required
+# Supports Gmail SMTP with App Passwords by default
+# Generate app password at: https://myaccount.google.com/apppasswords
+EMAIL__ENABLED=false
+EMAIL__SMTP_HOST=smtp.gmail.com
+EMAIL__SMTP_PORT=587
+EMAIL__SENDER_EMAIL=
+EMAIL__SENDER_NAME=REM
+EMAIL__APP_PASSWORD=
+EMAIL__LOGIN_CODE_EXPIRY_MINUTES=10
+
 # =============================================================================
 # OpenTelemetry Settings
 # =============================================================================

{remdb-0.3.122 → remdb-0.3.157}/.gitignore

@@ -101,6 +101,7 @@ secrets/
 *.key
 *.crt
 credentials.json
+.pypirc
 
 # Build artifacts
 *.pyc

remdb-0.3.157/.kreuzberg/mime/2470f3a5e2d1953b.msgpack

@@ -0,0 +1 @@
+��type�str�data�application/pdf�cached_at�A�L�#w��

remdb-0.3.157/.kreuzberg/mime/34f1cfc7a58e8b0c.msgpack

@@ -0,0 +1,2 @@
+��type�str�data�application/pdf�cached_at�A�L�h
+7i

remdb-0.3.157/.kreuzberg/mime/56bf449feab17e6d.msgpack

@@ -0,0 +1 @@
+��type�str�data�application/pdf�cached_at�A�L�#�K

remdb-0.3.157/.kreuzberg/mime/8cace0ec228b43d6.msgpack

@@ -0,0 +1 @@
+��type�str�data�application/pdf�cached_at�A�L,�E�$

remdb-0.3.157/.kreuzberg/mime/99f1579d6a6790ad.msgpack

@@ -0,0 +1 @@
+��type�str�data�application/pdf�cached_at�A�L,� ��

remdb-0.3.157/.kreuzberg/mime/a0d60cff1e5950a6.msgpack

@@ -0,0 +1 @@
+��type�str�data�application/pdf�cached_at�A�L�g�o

remdb-0.3.157/.kreuzberg/mime/b2b5204d4dfab9dc.msgpack

@@ -0,0 +1 @@
+��type�str�data�application/pdf�cached_at�A�L,a��:

remdb-0.3.157/.kreuzberg/mime/d1df948b17e4d9fc.msgpack

@@ -0,0 +1 @@
+��type�str�data�application/pdf�cached_at�A�L,a��

{remdb-0.3.122 → remdb-0.3.157}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: remdb
-Version: 0.3.122
+Version: 0.3.157
 Summary: Resources Entities Moments - Bio-inspired memory system for agentic AI workloads
 Project-URL: Homepage, https://github.com/Percolation-Labs/reminiscent
 Project-URL: Documentation, https://github.com/Percolation-Labs/reminiscent/blob/main/README.md
@@ -12,9 +12,11 @@ Keywords: agents,ai,mcp,memory,postgresql,vector-search
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: <3.13,>=3.12
+Requires-Python: <3.14,>=3.11
 Requires-Dist: aioboto3>=13.0.0
 Requires-Dist: arize-phoenix>=5.0.0
 Requires-Dist: asyncpg>=0.30.0
@@ -143,9 +145,9 @@ pip install "remdb[all]"
 git clone https://github.com/Percolation-Labs/remstack-lab.git
 cd remstack-lab
 
-# Start PostgreSQL with docker-compose
+# Start services (PostgreSQL, Phoenix observability)
 curl -O https://gist.githubusercontent.com/percolating-sirsh/d117b673bc0edfdef1a5068ccd3cf3e5/raw/docker-compose.prebuilt.yml
-docker compose -f docker-compose.prebuilt.yml up -d postgres
+docker compose -f docker-compose.prebuilt.yml up -d
 
 # Configure REM (creates ~/.rem/config.yaml and installs database schema)
 # Add --claude-desktop to register with Claude Desktop app
@@ -177,7 +179,7 @@ rem ask "What is the Bitcoin whitepaper about?"
 Once configured, you can also use the OpenAI-compatible chat completions API:
 
 ```bash
-# Start the API server (if not using docker-compose for API)
+# Start all services (PostgreSQL, Phoenix, API)
 docker compose -f docker-compose.prebuilt.yml up -d
 
 # Test the API
@@ -384,14 +386,6 @@ rem process ingest my-agent.yaml --user-id tenant-a --category agents
 rem ask my-agent "test" --user-id tenant-a
 ```
 
-### Advanced: Ontology Extractors
-
-Custom agents can also be used as **ontology extractors** to extract structured knowledge from files. See [CLAUDE.md](../CLAUDE.md#ontology-extraction-pattern) for details on:
-- Multi-provider testing (`provider_configs`)
-- Semantic search configuration (`embedding_fields`)
-- File matching rules (`OntologyConfig`)
-- Dreaming workflow integration
-
 ### Troubleshooting
 
 **Schema not found error:**
@@ -1440,45 +1434,156 @@ Successfully installed ... kreuzberg-4.0.0rc1 ... remdb-0.3.10
 
 REM wraps FastAPI - extend it exactly as you would any FastAPI app.
 
+### Recommended Project Structure
+
+REM auto-detects `./agents/` and `./models/` folders - no configuration needed:
+
+```
+my-rem-app/
+├── agents/                 # Auto-detected for agent schemas
+│   ├── my-agent.yaml       # Custom agent (rem ask my-agent "query")
+│   └── another-agent.yaml
+├── models/                 # Auto-detected if __init__.py exists
+│   └── __init__.py         # Register models with @rem.register_model
+├── routers/                # Custom FastAPI routers
+│   └── custom.py
+├── main.py                 # Entry point
+└── pyproject.toml
+```
+
+### Quick Start
+
 ```python
-import rem
+# main.py
 from rem import create_app
-from rem.models.core import CoreModel
+from fastapi import APIRouter
 
-# 1. Register models (for schema generation)
-rem.register_models(MyModel, AnotherModel)
+# Create REM app (auto-detects ./agents/ and ./models/)
+app = create_app()
 
-# 2. Register schema paths (for custom agents/evaluators)
-rem.register_schema_path("./schemas")
+# Add custom router
+router = APIRouter(prefix="/custom", tags=["custom"])
 
-# 3. Create app
-app = create_app()
+@router.get("/hello")
+async def hello():
+    return {"message": "Hello from custom router!"}
 
-# 4. Extend like normal FastAPI
-app.include_router(my_router)
+app.include_router(router)
 
+# Add custom MCP tool
 @app.mcp_server.tool()
 async def my_tool(query: str) -> dict:
-    """Custom MCP tool."""
+    """Custom MCP tool available to agents."""
     return {"result": query}
 ```
 
-### Project Structure
+### Custom Models (Auto-Detected)
+
+```python
+# models/__init__.py
+import rem
+from rem.models.core import CoreModel
+from pydantic import Field
 
+@rem.register_model
+class MyEntity(CoreModel):
+    """Custom entity - auto-registered for schema generation."""
+    name: str = Field(description="Entity name")
+    status: str = Field(default="active")
 ```
-my-rem-app/
-├── my_app/
-│   ├── main.py           # Entry point (create_app + extensions)
-│   ├── models.py         # Custom models (inherit CoreModel)
-│   └── routers/          # Custom FastAPI routers
-├── schemas/
-│   ├── agents/           # Custom agent YAML schemas
-│   └── evaluators/       # Custom evaluator schemas
-├── sql/migrations/       # Custom SQL migrations
-└── pyproject.toml
+
+Run `rem db schema generate` to include your models in the database schema.
+
+### Custom Agents (Auto-Detected)
+
+```yaml
+# agents/my-agent.yaml
+type: object
+description: |
+  You are a helpful assistant that...
+
+properties:
+  answer:
+    type: string
+    description: Your response
+
+required:
+  - answer
+
+json_schema_extra:
+  kind: agent
+  name: my-agent
+  version: "1.0.0"
+  tools:
+    - search_rem
 ```
 
-Generate this structure with: `rem scaffold my-app`
+Test with: `rem ask my-agent "Hello!"`
+
+### Example Custom Router
+
+```python
+# routers/analytics.py
+from fastapi import APIRouter, Depends
+from rem.services.postgres import get_postgres_service
+
+router = APIRouter(prefix="/analytics", tags=["analytics"])
+
+@router.get("/stats")
+async def get_stats():
+    """Get database statistics."""
+    db = get_postgres_service()
+    if not db:
+        return {"error": "Database not available"}
+
+    await db.connect()
+    try:
+        result = await db.execute(
+            "SELECT COUNT(*) as count FROM resources"
+        )
+        return {"resource_count": result[0]["count"]}
+    finally:
+        await db.disconnect()
+
+@router.get("/recent")
+async def get_recent(limit: int = 10):
+    """Get recent resources."""
+    db = get_postgres_service()
+    if not db:
+        return {"error": "Database not available"}
+
+    await db.connect()
+    try:
+        result = await db.execute(
+            f"SELECT label, category, created_at FROM resources ORDER BY created_at DESC LIMIT {limit}"
+        )
+        return {"resources": result}
+    finally:
+        await db.disconnect()
+```
+
+Include in main.py:
+
+```python
+from routers.analytics import router as analytics_router
+app.include_router(analytics_router)
+```
+
+### Running the App
+
+```bash
+# Development (auto-reload)
+uv run uvicorn main:app --reload --port 8000
+
+# Or use rem serve
+uv run rem serve --reload
+
+# Test agent
+uv run rem ask my-agent "What can you help me with?"
+
+# Test custom endpoint
+curl http://localhost:8000/analytics/stats
+```
 
 ### Extension Points
 

{remdb-0.3.122 → remdb-0.3.157}/README.md

@@ -57,9 +57,9 @@ pip install "remdb[all]"
 git clone https://github.com/Percolation-Labs/remstack-lab.git
 cd remstack-lab
 
-# Start PostgreSQL with docker-compose
+# Start services (PostgreSQL, Phoenix observability)
 curl -O https://gist.githubusercontent.com/percolating-sirsh/d117b673bc0edfdef1a5068ccd3cf3e5/raw/docker-compose.prebuilt.yml
-docker compose -f docker-compose.prebuilt.yml up -d postgres
+docker compose -f docker-compose.prebuilt.yml up -d
 
 # Configure REM (creates ~/.rem/config.yaml and installs database schema)
 # Add --claude-desktop to register with Claude Desktop app
@@ -91,7 +91,7 @@ rem ask "What is the Bitcoin whitepaper about?"
 Once configured, you can also use the OpenAI-compatible chat completions API:
 
 ```bash
-# Start the API server (if not using docker-compose for API)
+# Start all services (PostgreSQL, Phoenix, API)
 docker compose -f docker-compose.prebuilt.yml up -d
 
 # Test the API
@@ -298,14 +298,6 @@ rem process ingest my-agent.yaml --user-id tenant-a --category agents
 rem ask my-agent "test" --user-id tenant-a
 ```
 
-### Advanced: Ontology Extractors
-
-Custom agents can also be used as **ontology extractors** to extract structured knowledge from files. See [CLAUDE.md](../CLAUDE.md#ontology-extraction-pattern) for details on:
-- Multi-provider testing (`provider_configs`)
-- Semantic search configuration (`embedding_fields`)
-- File matching rules (`OntologyConfig`)
-- Dreaming workflow integration
-
 ### Troubleshooting
 
 **Schema not found error:**
@@ -1354,45 +1346,156 @@ Successfully installed ... kreuzberg-4.0.0rc1 ... remdb-0.3.10
 
 REM wraps FastAPI - extend it exactly as you would any FastAPI app.
 
+### Recommended Project Structure
+
+REM auto-detects `./agents/` and `./models/` folders - no configuration needed:
+
+```
+my-rem-app/
+├── agents/                 # Auto-detected for agent schemas
+│   ├── my-agent.yaml       # Custom agent (rem ask my-agent "query")
+│   └── another-agent.yaml
+├── models/                 # Auto-detected if __init__.py exists
+│   └── __init__.py         # Register models with @rem.register_model
+├── routers/                # Custom FastAPI routers
+│   └── custom.py
+├── main.py                 # Entry point
+└── pyproject.toml
+```
+
+### Quick Start
+
 ```python
-import rem
+# main.py
 from rem import create_app
-from rem.models.core import CoreModel
+from fastapi import APIRouter
 
-# 1. Register models (for schema generation)
-rem.register_models(MyModel, AnotherModel)
+# Create REM app (auto-detects ./agents/ and ./models/)
+app = create_app()
 
-# 2. Register schema paths (for custom agents/evaluators)
-rem.register_schema_path("./schemas")
+# Add custom router
+router = APIRouter(prefix="/custom", tags=["custom"])
 
-# 3. Create app
-app = create_app()
+@router.get("/hello")
+async def hello():
+    return {"message": "Hello from custom router!"}
 
-# 4. Extend like normal FastAPI
-app.include_router(my_router)
+app.include_router(router)
 
+# Add custom MCP tool
 @app.mcp_server.tool()
 async def my_tool(query: str) -> dict:
-    """Custom MCP tool."""
+    """Custom MCP tool available to agents."""
     return {"result": query}
 ```
 
-### Project Structure
+### Custom Models (Auto-Detected)
+
+```python
+# models/__init__.py
+import rem
+from rem.models.core import CoreModel
+from pydantic import Field
 
+@rem.register_model
+class MyEntity(CoreModel):
+    """Custom entity - auto-registered for schema generation."""
+    name: str = Field(description="Entity name")
+    status: str = Field(default="active")
 ```
-my-rem-app/
-├── my_app/
-│   ├── main.py           # Entry point (create_app + extensions)
-│   ├── models.py         # Custom models (inherit CoreModel)
-│   └── routers/          # Custom FastAPI routers
-├── schemas/
-│   ├── agents/           # Custom agent YAML schemas
-│   └── evaluators/       # Custom evaluator schemas
-├── sql/migrations/       # Custom SQL migrations
-└── pyproject.toml
+
+Run `rem db schema generate` to include your models in the database schema.
+
+### Custom Agents (Auto-Detected)
+
+```yaml
+# agents/my-agent.yaml
+type: object
+description: |
+  You are a helpful assistant that...
+
+properties:
+  answer:
+    type: string
+    description: Your response
+
+required:
+  - answer
+
+json_schema_extra:
+  kind: agent
+  name: my-agent
+  version: "1.0.0"
+  tools:
+    - search_rem
 ```
 
-Generate this structure with: `rem scaffold my-app`
+Test with: `rem ask my-agent "Hello!"`
+
+### Example Custom Router
+
+```python
+# routers/analytics.py
+from fastapi import APIRouter, Depends
+from rem.services.postgres import get_postgres_service
+
+router = APIRouter(prefix="/analytics", tags=["analytics"])
+
+@router.get("/stats")
+async def get_stats():
+    """Get database statistics."""
+    db = get_postgres_service()
+    if not db:
+        return {"error": "Database not available"}
+
+    await db.connect()
+    try:
+        result = await db.execute(
+            "SELECT COUNT(*) as count FROM resources"
+        )
+        return {"resource_count": result[0]["count"]}
+    finally:
+        await db.disconnect()
+
+@router.get("/recent")
+async def get_recent(limit: int = 10):
+    """Get recent resources."""
+    db = get_postgres_service()
+    if not db:
+        return {"error": "Database not available"}
+
+    await db.connect()
+    try:
+        result = await db.execute(
+            f"SELECT label, category, created_at FROM resources ORDER BY created_at DESC LIMIT {limit}"
+        )
+        return {"resources": result}
+    finally:
+        await db.disconnect()
+```
+
+Include in main.py:
+
+```python
+from routers.analytics import router as analytics_router
+app.include_router(analytics_router)
+```
+
+### Running the App
+
+```bash
+# Development (auto-reload)
+uv run uvicorn main:app --reload --port 8000
+
+# Or use rem serve
+uv run rem serve --reload
+
+# Test agent
+uv run rem ask my-agent "What can you help me with?"
+
+# Test custom endpoint
+curl http://localhost:8000/analytics/stats
+```
 
 ### Extension Points
 

{remdb-0.3.122 → remdb-0.3.157}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "remdb"
-version = "0.3.122"
+version = "0.3.157"
 description = "Resources Entities Moments - Bio-inspired memory system for agentic AI workloads"
 readme = "README.md"
 authors = [
@@ -12,10 +12,12 @@ classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: Scientific/Engineering :: Artificial Intelligence",
 ]
-requires-python = ">=3.12,<3.13"
+requires-python = ">=3.11,<3.14"
 
 dependencies = [
     # Core Framework
@@ -153,7 +155,7 @@ markers = [
 ]
 
 [tool.ruff]
-target-version = "py312"
+target-version = "py311"
 line-length = 100
 
 [tool.ruff.lint]
@@ -177,7 +179,7 @@ ignore = [
 
 [tool.mypy]
 plugins = ["pydantic.mypy"]
-python_version = "3.12"
+python_version = "3.11"
 strict = false
 
 # Pragmatic type checking - focus on real bugs, not noise

{remdb-0.3.122 → remdb-0.3.157}/src/rem/agentic/agents/__init__.py

@@ -6,6 +6,8 @@ Use create_agent_from_schema_file() to instantiate agents.
 
 The SSE Simulator is a special programmatic "agent" that generates
 scripted SSE events for testing and demonstration - it doesn't use an LLM.
+
+Agent Manager provides functions for saving/loading user-created agents.
 """
 
 from .sse_simulator import (
@@ -14,9 +16,23 @@ from .sse_simulator import (
     stream_error_demo,
 )
 
+from .agent_manager import (
+    save_agent,
+    get_agent,
+    list_agents,
+    delete_agent,
+    build_agent_spec,
+)
+
 __all__ = [
     # SSE Simulator (programmatic, no LLM)
     "stream_simulator_events",
     "stream_minimal_demo",
     "stream_error_demo",
+    # Agent Manager
+    "save_agent",
+    "get_agent",
+    "list_agents",
+    "delete_agent",
+    "build_agent_spec",
 ]