Metadata-Version: 2.4
Name: dreaming-memory
Version: 0.2.0
Summary: Agent-agnostic memory extension — Postgres-backed agent memory with Linear, Notion, and Cloudflare integrations
Project-URL: Homepage, https://github.com/OnlineChefGroep/cursor-dreaming-sdk
Project-URL: Documentation, https://github.com/OnlineChefGroep/cursor-dreaming-sdk/tree/main/docs
Project-URL: Repository, https://github.com/OnlineChefGroep/cursor-dreaming-sdk
Project-URL: Issues, https://github.com/OnlineChefGroep/cursor-dreaming-sdk/issues
Author: OnlineChefGroep
License: MIT
Keywords: agent-memory,dream-eval,linear,notion,postgres,postgrest
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT 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 :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Monitoring
Classifier: Typing :: Typed
Requires-Python: <3.15,>=3.11
Requires-Dist: httpx>=0.27
Requires-Dist: psycopg-pool>=3.1
Requires-Dist: psycopg[binary]>=3.2
Requires-Dist: pydantic>=2.13
Provides-Extra: all
Requires-Dist: boto3>=1.35; extra == 'all'
Requires-Dist: fastapi>=0.115; extra == 'all'
Requires-Dist: lancedb>=0.22; extra == 'all'
Requires-Dist: pyarrow>=18.0; extra == 'all'
Requires-Dist: sentry-sdk>=2.19; extra == 'all'
Requires-Dist: upstash-redis>=1.2; extra == 'all'
Requires-Dist: uvicorn[standard]>=0.30; extra == 'all'
Provides-Extra: dev
Requires-Dist: hypothesis>=6.100; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: pyyaml>=6.0; extra == 'dev'
Requires-Dist: ruff>=0.15; extra == 'dev'
Provides-Extra: prefect
Requires-Dist: prefect>=3.0; extra == 'prefect'
Provides-Extra: r2
Requires-Dist: boto3>=1.35; extra == 'r2'
Provides-Extra: redis
Requires-Dist: upstash-redis>=1.2; extra == 'redis'
Provides-Extra: semantic
Requires-Dist: lancedb>=0.22; extra == 'semantic'
Requires-Dist: pyarrow>=18.0; extra == 'semantic'
Provides-Extra: sentry
Requires-Dist: sentry-sdk>=2.19; extra == 'sentry'
Provides-Extra: web
Requires-Dist: fastapi>=0.115; extra == 'web'
Requires-Dist: uvicorn[standard]>=0.30; extra == 'web'
Description-Content-Type: text/markdown

# cursor-dreaming-memory

Lightweight agent memory extension for **cursor-dreaming-sdk** (Utrecht Data OS / CHEF-308).

## Install

```bash
cd python
uv sync --extra dev
uv run dream-memory init   # requires Postgres
```

Optional semantic layer:

```bash
uv sync --extra semantic
```

## Quick start

```python
from cursor_dreaming_memory import AgentMemory, SessionContext
from cursor_dreaming_memory.types import MemoryType, MemorySource

memory = AgentMemory()
memory.ensure_schema()

ctx = SessionContext.for_dream_eval("2026-06-15T09-00-00Z")
memory.remember(ctx, MemoryType.OBSERVATION, {"faithfulness": 0.63}, source=MemorySource.SDK)
```

## CLI

```bash
dream-memory init
dream-memory remember --session-id run-1 --content '{"note":"hello"}'
dream-memory recall --session-id run-1
dream-memory linear-ingest CHEF-308
dream-memory notion-ingest <page_id>
dream-memory export --session-id run-1 --output run-1.md
dream-memory slack-report --run-id run-1 --metrics-json metrics.json
dream-memory doctor
```

- `export` writes a session's memory records as Markdown (`--output` to a file, or stdout).
- `slack-report` posts an eval report to Slack via `SLACK_WEBHOOK_URL` (no-op if unset).
- `doctor` reports config presence plus Postgres, Linear, and Notion connectivity.

## Example flow

```bash
uv run python examples/linear_memory_flow.py --issue CHEF-308 --comment
```

See [docs/agent-memory.md](../docs/agent-memory.md) for architecture and OCI deployment.
