clsplusplus 7.4.0__tar.gz → 7.19.0__tar.gz

{clsplusplus-7.4.0/src/clsplusplus.egg-info → clsplusplus-7.19.0}/PKG-INFO

@@ -1,18 +1,17 @@
 Metadata-Version: 2.4
 Name: clsplusplus
-Version: 7.4.0
+Version: 7.19.0
 Summary: Brain-inspired, model-agnostic persistent memory for LLMs. Learn, recall, forget — like a brain. Works with OpenAI, Claude, Gemini, Llama.
 Author-email: AlphaForge AI Labs <contact@alphaforge.ai>
 Maintainer-email: Rajamohan Jabbala <contact@alphaforge.ai>
 License: Apache-2.0
-Project-URL: Homepage, https://github.com/rajamohan1950/CLSplusplus
-Project-URL: Documentation, https://github.com/rajamohan1950/CLSplusplus/wiki
-Project-URL: Repository, https://github.com/rajamohan1950/CLSplusplus
-Project-URL: Bug Tracker, https://github.com/rajamohan1950/CLSplusplus/issues
-Project-URL: Changelog, https://github.com/rajamohan1950/CLSplusplus/releases
-Project-URL: API Reference, https://github.com/rajamohan1950/CLSplusplus/blob/main/docs/API_DOCUMENTATION.md
-Project-URL: Source Code, https://github.com/rajamohan1950/CLSplusplus/tree/main/src
-Project-URL: Download, https://github.com/rajamohan1950/CLSplusplus/releases
+Project-URL: Homepage, https://www.clsplusplus.com
+Project-URL: Documentation, https://www.clsplusplus.com/api-docs
+Project-URL: Repository, https://www.clsplusplus.com
+Project-URL: Bug Tracker, https://www.clsplusplus.com/tickets
+Project-URL: Changelog, https://www.clsplusplus.com
+Project-URL: API Reference, https://www.clsplusplus.com/api-docs
+Project-URL: Download, https://pypi.org/project/clsplusplus/
 Keywords: llm,memory,ai,persistent-memory,model-agnostic,brain,openai,anthropic,claude,gemini,langchain,continuous-learning,semantic-search,vector-database,conversational-ai,rag,context-window
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
@@ -72,7 +71,7 @@ Dynamic: license-file
 
 <!-- mcp-name: io.github.rajamohan1950/cls-memory -->
 <p align="center">
-  <img src="https://img.shields.io/badge/CLS%2B%2B-Memory%20for%20LLMs-6366f1?style=for-the-badge&logo=github" alt="CLS++" />
+  <img src="https://img.shields.io/badge/CLS%2B%2B-Memory%20for%20LLMs-6366f1?style=for-the-badge" alt="CLS++" />
 </p>
 
 <h1 align="center">CLS++ — Continuous Learning System++</h1>
@@ -81,11 +80,12 @@ Dynamic: license-file
 </p>
 
 <p align="center">
-  <a href="#-quick-start">Quick Start</a> •
-  <a href="#-architecture">Architecture</a> •
-  <a href="#-documentation">Documentation</a> •
-  <a href="#-deployment">Deployment</a> •
-  <a href="#-contributing">Contributing</a>
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#connect-via-mcp-claude-cursor-windsurf-chatgpt">MCP</a> •
+  <a href="#agent-framework-integrations">Integrations</a> •
+  <a href="#architecture">Architecture</a> •
+  <a href="#documentation">Documentation</a> •
+  <a href="#deployment">Deployment</a>
 </p>
 
 <p align="center">
@@ -93,8 +93,8 @@ Dynamic: license-file
   <a href="https://www.npmjs.com/package/clsplusplus"><img src="https://img.shields.io/npm/v/clsplusplus?style=flat-square&label=npm&color=cb3837" alt="npm" /></a>
   <a href="https://pypi.org/project/clsplusplus/"><img src="https://img.shields.io/pypi/pyversions/clsplusplus?style=flat-square" alt="Python" /></a>
   <a href="https://www.clsplusplus.com/docs"><img src="https://img.shields.io/badge/API-Live%20at%20www.clsplusplus.com-22c55e?style=flat-square" alt="API" /></a>
-  <a href="https://github.com/rajamohan1950/CLSplusplus/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square" alt="License" /></a>
-  <a href="https://github.com/rajamohan1950/CLSplusplus"><img src="https://img.shields.io/badge/Patent-Oct%202025-blue?style=flat-square" alt="Patent" /></a>
+  <a href="https://www.clsplusplus.com"><img src="https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square" alt="License" /></a>
+  <a href="https://www.clsplusplus.com"><img src="https://img.shields.io/badge/Patent-Oct%202025-blue?style=flat-square" alt="Patent" /></a>
 </p>
 
 ---
@@ -122,10 +122,24 @@ Memory is **external** to the model. **Switch models anytime.** No reset.
 ### Install
 
 ```bash
-pip install clsplusplus          # Python (lightweight: only httpx + pydantic)
-npm install clsplusplus          # JavaScript / TypeScript (zero dependencies)
+pip install clsplusplus          # Python SDK (lightweight: only httpx + pydantic)
+npm install clsplusplus          # JavaScript / TypeScript SDK (zero runtime deps)
 ```
 
+Optional Python extras pull in framework adapters or the full server:
+
+```bash
+pip install clsplusplus[server]      # run the FastAPI server yourself
+pip install clsplusplus[crewai]      # CrewAI memory adapter
+pip install clsplusplus[langgraph]   # LangGraph memory store
+pip install clsplusplus[llamaindex]  # LlamaIndex memory block
+pip install clsplusplus[autogen]     # Microsoft AutoGen memory provider
+```
+
+Both the PyPI and npm packages are named **`clsplusplus`** and ship the same
+`Brain` API. The npm package is a real TypeScript SDK (not just a CLI) — it
+mirrors the Python SDK method-for-method.
+
 ### Python SDK
 
 ```python
@@ -178,43 +192,128 @@ response = chat("You are a helpful assistant", "Help me with Python")
 # calls your LLM, learns from the exchange, returns response.
 ```
 
-### Full API
+### Full SDK API
+
+The `Brain` class is identical in the Python and JS/TS SDKs (the JS methods
+are `async`). Constructor: `Brain(user, api_key=None, url=None)` in Python,
+`new Brain(user, { apiKey, url })` in TypeScript. Both read `CLS_API_KEY` and
+`CLS_BASE_URL` from the environment when not passed; `url` defaults to
+`https://www.clsplusplus.com`.
 
 | Method | Description |
 |--------|-------------|
-| `brain.learn(fact)` | Teach a fact. Returns memory ID. |
-| `brain.ask(question)` | Query for relevant facts. Returns list. |
-| `brain.context(topic)` | Get LLM-ready context string. |
-| `brain.forget(fact)` | Forget by text or ID. |
-| `brain.absorb(text)` | Bulk-learn from document or conversation. |
-| `brain.who()` | Auto-generated user profile. |
-| `brain.correct(old, new)` | Update a belief. |
-| `brain.chat(message, llm)` | Full conversation handler with memory. |
-| `brain.teach(dict)` | Learn from structured data. |
-| `brain.watch(messages)` | Learn from chat message history. |
+| `brain.learn(fact, **meta)` | Teach a fact. Returns memory ID. |
+| `brain.ask(question, limit=5)` | Query for relevant facts. Returns list of strings. |
+| `brain.context(topic="", limit=8)` | Get LLM-ready context string. |
+| `brain.forget(fact_or_id)` | Forget by text or ID. Returns bool. |
+| `brain.absorb(content, source="document")` | Bulk-learn from document, conversation, or list. |
+| `brain.who()` | Auto-generated user profile dict. |
+| `brain.correct(wrong, right)` | Update a belief (forget + learn). |
+| `brain.chat(message, llm_fn=None)` | Full conversation handler with memory. |
+| `brain.teach(dict)` | Learn from structured key/value data. |
+| `brain.watch(messages)` | Learn from a list of chat messages. |
 | `brain.wrap(fn)` | Wrap any LLM function with auto-memory. |
+| `brain.all(limit=50)` / `brain.count()` | List / count what's stored. |
+
+Module-level one-liners (Python: `import clsplusplus as mem`; TS:
+`import { learn, ask } from "clsplusplus"`) wrap a per-user `Brain`:
+`learn(user, fact)`, `ask(user, question)`, `context(user, topic)`,
+`forget(user, fact_or_id)`.
 
-### Run the Full Server Locally
+A lower-level `CLSClient` (alias `CLS`) is also exported for direct
+`write` / `read` / `get_item` / `forget` / `sleep` / `health` calls against
+the REST API — see the [API Reference](docs/API_DOCUMENTATION.md).
+
+### Connect via MCP (Claude, Cursor, Windsurf, ChatGPT)
+
+CLS++ ships a [Model Context Protocol](https://modelcontextprotocol.io) server
+exposing three tools — `recall_memories`, `store_memory`, `who_am_i` — so any
+MCP client can read and write the same memory. Registry name:
+`io.github.rajamohan1950/cls-memory`.
+
+**Remote (hosted, OAuth)** — add `https://www.clsplusplus.com/mcp` as a custom
+connector. The OAuth 2.1 + PKCE + Dynamic Client Registration flow handles
+auth; no API key to paste.
+
+**Local (stdio)** — run the bundled server with an API key:
 
 ```bash
-git clone https://github.com/rajamohan1950/CLSplusplus.git
-cd CLSplusplus
-pip install -e ".[server]"
+pip install clsplusplus
+# one-line install for Claude Code:
+claude mcp add cls-memory \
+  --env CLS_API_URL=https://www.clsplusplus.com \
+  --env CLS_API_KEY=cls_live_xxx \
+  -- python3 -m clsplusplus.mcp_server
+```
+
+Or paste this into `.claude/settings.json` (Cursor/Windsurf use the same shape
+in their MCP config):
+
+```json
+{
+  "mcpServers": {
+    "cls-memory": {
+      "command": "python3",
+      "args": ["-m", "clsplusplus.mcp_server"],
+      "env": {
+        "CLS_API_URL": "https://www.clsplusplus.com",
+        "CLS_API_KEY": "cls_live_xxx"
+      }
+    }
+  }
+}
+```
+
+The dashboard's **Connect** button (`GET /v1/mcp/connect`) mints a fresh key and
+returns this exact block pre-filled. Create keys manually at
+<https://www.clsplusplus.com/profile#api-keys>.
+
+### Agent-framework integrations
+
+CLS++ ships native memory adapters for four agent frameworks. Each is an
+optional extra and lazily imported — the base package never requires the
+framework. Full setup in [docs/integrations](docs/integrations/).
 
-# Start infrastructure (Redis + PostgreSQL)
-docker compose up -d redis postgres
+| Framework | Install | Class | Plugs in as |
+|-----------|---------|-------|-------------|
+| **CrewAI** | `pip install clsplusplus[crewai]` | `clsplusplus.integrations.crewai.CLSMemoryStorage` | `ExternalMemory(storage=...)` — [docs](docs/integrations/crewai.md) |
+| **LangGraph** | `pip install clsplusplus[langgraph]` | `clsplusplus.integrations.langgraph.CLSMemoryStore` | `graph.compile(store=...)` — [docs](docs/integrations/langgraph.md) |
+| **LlamaIndex** | `pip install clsplusplus[llamaindex]` | `clsplusplus.integrations.llamaindex.CLSMemoryBlock` | `Memory.from_defaults(memory_blocks=[...])` — [docs](docs/integrations/llamaindex.md) |
+| **AutoGen** | `pip install clsplusplus[autogen]` | `clsplusplus.integrations.autogen.CLSMemory` | `AssistantAgent(memory=[...])` — [docs](docs/integrations/autogen.md) |
 
-# Start the API server
-uvicorn clsplusplus.api:create_app --factory --host 0.0.0.0 --port 8080
+```python
+# Example: CrewAI
+from crewai import Crew
+from crewai.memory.external.external_memory import ExternalMemory
+from clsplusplus.integrations.crewai import CLSMemoryStorage
+
+crew = Crew(
+    agents=[...], tasks=[...], memory=True,
+    external_memory=ExternalMemory(storage=CLSMemoryStorage(user="my-crew")),
+)
 ```
 
+Editor integrations (Cursor, Codex, n8n) also have guides under
+[docs/integrations](docs/integrations/).
+
+### Managed service
+
+CLS++ runs as a fully managed service — no infrastructure to host. Install the
+SDK and point it at the hosted API:
+
+```bash
+pip install clsplusplus       # or: npm install clsplusplus
+```
+
+Get an API key and start storing memory at **[clsplusplus.com](https://www.clsplusplus.com)**.
+
 ---
 
 ## Try It Live
 
 **[Try the demo](https://www.clsplusplus.com)** — Tell Claude something, ask OpenAI. Same memory. No sign-up.
 
-The Chrome extension (Web Store, v6.0.1) captures user messages from
+The Chrome extension (Web Store, v7.4.1) captures user messages from
 ChatGPT, Claude, and Gemini chat pages automatically and feeds them through
 the same memory pipeline. Host permissions: `chatgpt.com`,
 `chat.openai.com`, `claude.ai`, `gemini.google.com`. The Link Account popup
@@ -276,29 +375,32 @@ export CLS_ABUSE_WHITELIST_IPS=               # comma-separated operator IPs
 Requests carrying a valid API key are exempt from auth-fail flood counting
 (see `src/clsplusplus/abuse_guard.py`).
 
-Product endpoints: `POST /v1/memories/encode`, `POST /v1/memories/retrieve`, `DELETE /v1/memories/forget`, `GET /v1/health/score`. See [SaaS docs](docs/SAAS_MEMORY_AS_SERVICE.md).
+Product endpoints: `POST /v1/memories/encode`, `POST /v1/memories/retrieve`, `DELETE /v1/memories/forget`, `GET /v1/health/score`, `GET /v1/pricing`, `GET /v1/version`, plus the in-app support desk (`POST /v1/feedback`, `GET /v1/support/mine`, `POST /v1/support/{id}/rate`). See [SaaS docs](docs/SAAS_MEMORY_AS_SERVICE.md).
+
+> Memory reads/writes are bound to the caller's own namespace server-side
+> (`_owned_namespace_for` in `api.py`): a signed-in user can never read another
+> tenant's memories by passing a namespace.
 
 ### Pricing
 
-CLS++ launched in India and bills in **INR via Razorpay (UPI / QR)** — not
-USD, not Stripe. Tiers: **Pro ₹299**, **Business ₹999**, **Enterprise
-₹4,999**. The pricing control plane lives inside the CLS++ memory layer
-itself (reserved namespace `__cls_pricing__`) and is operator-tunable at
-runtime via `POST /admin/pricing/config`. The default config — currency,
-margin floor/target, infra spend, dynamic-demand toggle — is seeded by
-`src/clsplusplus/pricing_store.py` on first read. `GET /v1/pricing` is a
+CLS++ launched in India and bills via **Razorpay (UPI / QR)**. Pricing is
+**country-based** — Indian users are billed in **₹**, US in **$**, EU in **€**,
+resolved from the request's country (`src/clsplusplus/currency.py`). Published
+monthly tiers: **Pro ₹999 / $29**, **Business ₹3,999 / $99**, **Enterprise
+₹14,999 / $499**, plus a free tier. Per-tier feature bundles are optimized by
+the `bundle-pricing` agent and exposed on `GET /v1/pricing`. The pricing control
+plane lives inside the CLS++ memory layer itself (reserved namespace
+`__cls_pricing__`), operator-tunable at runtime via `POST /admin/pricing/config`;
+defaults are seeded by `src/clsplusplus/pricing_store.py`. `GET /v1/pricing` is a
 public, abuse-exempt endpoint.
 
 ---
 
 ## Deployment
 
-| Platform | Guide |
-|----------|-------|
-| **Render** (free tier) | [Deploy in 1 click](https://render.com/deploy?repo=https://github.com/rajamohan1950/CLSplusplus) • [Setup guide](docs/DEPLOY_RENDER.md) |
-| **AWS Free Tier** | [CloudFormation](infrastructure/aws/cloudformation-free-tier.yaml) • [Step-by-step](infrastructure/aws/FREE_TIER_GUIDE.md) |
-| **AWS** | [CloudFormation](infrastructure/aws/cloudformation.yaml) |
-| **Azure** | [ARM template](infrastructure/azure/arm-template.json) |
+CLS++ is a managed, hosted service — there's nothing to deploy. The production
+API runs at **[www.clsplusplus.com](https://www.clsplusplus.com)**; enterprise
+and on-prem options are available on request.
 
 ---
 
@@ -306,7 +408,9 @@ public, abuse-exempt endpoint.
 
 | Document | Description |
 |----------|-------------|
+| [Architecture Overview](docs/ARCHITECTURE.md) | Components, stores, data flow, MCP |
 | [API Reference](docs/API_DOCUMENTATION.md) | Endpoints, auth, examples |
+| [Integrations](docs/integrations/) | CrewAI, LangGraph, LlamaIndex, AutoGen, Cursor, Codex, n8n |
 | [API Blueprint](docs/API_BLUEPRINT.md) | SaaS API playbook (DX, security, billing) |
 | [SaaS Strategy](docs/SAAS_MEMORY_AS_SERVICE.md) | Memory-as-a-Service, pricing |
 | [Marketplace Integration](docs/MARKETPLACE_INTEGRATION.md) | AWS, Azure, GCP, OCI |
@@ -326,10 +430,16 @@ public, abuse-exempt endpoint.
 - [x] Reconsolidation gate
 - [x] API key auth + rate limiting
 - [x] SaaS product endpoints
-- [x] Chrome extension (v6.0.1) capturing ChatGPT / Claude / Gemini
+- [x] Chrome extension (v7.4.1) capturing ChatGPT / Claude / Gemini
+- [x] Remote MCP server (OAuth 2.1 + PKCE + DCR) + stdio MCP server
+- [x] Native CrewAI / LangGraph / LlamaIndex / AutoGen memory adapters
 - [x] Abuse-guard with env-tunable thresholds and operator IP whitelist
 - [x] PostHog Weblab — staged rollouts with auto-rollback (5xx > 2% or p95 > 3s)
-- [x] INR pricing (Razorpay / UPI) with memory-resident control plane
+- [x] Country-based pricing (₹ / $ / €) + agent-optimized feature bundles (Razorpay / UPI), memory-resident control plane
+- [x] In-app support desk ("Doctor") — agent-triaged feedback / bugs / questions with auto-resolution + per-user timeline
+- [x] Company agent platform — `doctor-*`, `dynamic-pricing`, `bundle-pricing`, `competitive-intel`, `marketing-growth`
+- [x] `cls bench` — runnable reliability reproductions (silent-loss, delete-on-conflict, dimension-switch, empty-extraction)
+- [x] Per-user memory isolation (server-side namespace binding)
 
 ## Recent Architectural Decisions
 
@@ -360,9 +470,9 @@ container ships operator scripts at `/app/scripts/` (see
 
 ---
 
-## Contributing
+## Support
 
-We welcome contributions. See [CONTRIBUTING.md](.github/CONTRIBUTING.md) and the [Wiki](https://github.com/rajamohan1950/CLSplusplus/wiki) for details.
+Questions or enterprise enquiries: **[clsplusplus.com](https://www.clsplusplus.com)** or open a ticket at [clsplusplus.com/tickets](https://www.clsplusplus.com/tickets).
 
 ---
 
@@ -373,5 +483,5 @@ Provisional patent filed October 2025. Apache 2.0 (see [LICENSE](LICENSE)).
 ---
 
 <p align="center">
-  <strong>AlphaForge AI Labs</strong> • <a href="https://github.com/rajamohan1950">Rajamohan Jabbala</a> • 2026
+  <strong>AlphaForge AI Labs</strong> • <a href="https://www.clsplusplus.com">clsplusplus.com</a> • 2026
 </p>

{clsplusplus-7.4.0 → clsplusplus-7.19.0}/README.md

@@ -1,6 +1,6 @@
 <!-- mcp-name: io.github.rajamohan1950/cls-memory -->
 <p align="center">
-  <img src="https://img.shields.io/badge/CLS%2B%2B-Memory%20for%20LLMs-6366f1?style=for-the-badge&logo=github" alt="CLS++" />
+  <img src="https://img.shields.io/badge/CLS%2B%2B-Memory%20for%20LLMs-6366f1?style=for-the-badge" alt="CLS++" />
 </p>
 
 <h1 align="center">CLS++ — Continuous Learning System++</h1>
@@ -9,11 +9,12 @@
 </p>
 
 <p align="center">
-  <a href="#-quick-start">Quick Start</a> •
-  <a href="#-architecture">Architecture</a> •
-  <a href="#-documentation">Documentation</a> •
-  <a href="#-deployment">Deployment</a> •
-  <a href="#-contributing">Contributing</a>
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#connect-via-mcp-claude-cursor-windsurf-chatgpt">MCP</a> •
+  <a href="#agent-framework-integrations">Integrations</a> •
+  <a href="#architecture">Architecture</a> •
+  <a href="#documentation">Documentation</a> •
+  <a href="#deployment">Deployment</a>
 </p>
 
 <p align="center">
@@ -21,8 +22,8 @@
   <a href="https://www.npmjs.com/package/clsplusplus"><img src="https://img.shields.io/npm/v/clsplusplus?style=flat-square&label=npm&color=cb3837" alt="npm" /></a>
   <a href="https://pypi.org/project/clsplusplus/"><img src="https://img.shields.io/pypi/pyversions/clsplusplus?style=flat-square" alt="Python" /></a>
   <a href="https://www.clsplusplus.com/docs"><img src="https://img.shields.io/badge/API-Live%20at%20www.clsplusplus.com-22c55e?style=flat-square" alt="API" /></a>
-  <a href="https://github.com/rajamohan1950/CLSplusplus/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square" alt="License" /></a>
-  <a href="https://github.com/rajamohan1950/CLSplusplus"><img src="https://img.shields.io/badge/Patent-Oct%202025-blue?style=flat-square" alt="Patent" /></a>
+  <a href="https://www.clsplusplus.com"><img src="https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square" alt="License" /></a>
+  <a href="https://www.clsplusplus.com"><img src="https://img.shields.io/badge/Patent-Oct%202025-blue?style=flat-square" alt="Patent" /></a>
 </p>
 
 ---
@@ -50,10 +51,24 @@ Memory is **external** to the model. **Switch models anytime.** No reset.
 ### Install
 
 ```bash
-pip install clsplusplus          # Python (lightweight: only httpx + pydantic)
-npm install clsplusplus          # JavaScript / TypeScript (zero dependencies)
+pip install clsplusplus          # Python SDK (lightweight: only httpx + pydantic)
+npm install clsplusplus          # JavaScript / TypeScript SDK (zero runtime deps)
 ```
 
+Optional Python extras pull in framework adapters or the full server:
+
+```bash
+pip install clsplusplus[server]      # run the FastAPI server yourself
+pip install clsplusplus[crewai]      # CrewAI memory adapter
+pip install clsplusplus[langgraph]   # LangGraph memory store
+pip install clsplusplus[llamaindex]  # LlamaIndex memory block
+pip install clsplusplus[autogen]     # Microsoft AutoGen memory provider
+```
+
+Both the PyPI and npm packages are named **`clsplusplus`** and ship the same
+`Brain` API. The npm package is a real TypeScript SDK (not just a CLI) — it
+mirrors the Python SDK method-for-method.
+
 ### Python SDK
 
 ```python
@@ -106,43 +121,128 @@ response = chat("You are a helpful assistant", "Help me with Python")
 # calls your LLM, learns from the exchange, returns response.
 ```
 
-### Full API
+### Full SDK API
+
+The `Brain` class is identical in the Python and JS/TS SDKs (the JS methods
+are `async`). Constructor: `Brain(user, api_key=None, url=None)` in Python,
+`new Brain(user, { apiKey, url })` in TypeScript. Both read `CLS_API_KEY` and
+`CLS_BASE_URL` from the environment when not passed; `url` defaults to
+`https://www.clsplusplus.com`.
 
 | Method | Description |
 |--------|-------------|
-| `brain.learn(fact)` | Teach a fact. Returns memory ID. |
-| `brain.ask(question)` | Query for relevant facts. Returns list. |
-| `brain.context(topic)` | Get LLM-ready context string. |
-| `brain.forget(fact)` | Forget by text or ID. |
-| `brain.absorb(text)` | Bulk-learn from document or conversation. |
-| `brain.who()` | Auto-generated user profile. |
-| `brain.correct(old, new)` | Update a belief. |
-| `brain.chat(message, llm)` | Full conversation handler with memory. |
-| `brain.teach(dict)` | Learn from structured data. |
-| `brain.watch(messages)` | Learn from chat message history. |
+| `brain.learn(fact, **meta)` | Teach a fact. Returns memory ID. |
+| `brain.ask(question, limit=5)` | Query for relevant facts. Returns list of strings. |
+| `brain.context(topic="", limit=8)` | Get LLM-ready context string. |
+| `brain.forget(fact_or_id)` | Forget by text or ID. Returns bool. |
+| `brain.absorb(content, source="document")` | Bulk-learn from document, conversation, or list. |
+| `brain.who()` | Auto-generated user profile dict. |
+| `brain.correct(wrong, right)` | Update a belief (forget + learn). |
+| `brain.chat(message, llm_fn=None)` | Full conversation handler with memory. |
+| `brain.teach(dict)` | Learn from structured key/value data. |
+| `brain.watch(messages)` | Learn from a list of chat messages. |
 | `brain.wrap(fn)` | Wrap any LLM function with auto-memory. |
+| `brain.all(limit=50)` / `brain.count()` | List / count what's stored. |
+
+Module-level one-liners (Python: `import clsplusplus as mem`; TS:
+`import { learn, ask } from "clsplusplus"`) wrap a per-user `Brain`:
+`learn(user, fact)`, `ask(user, question)`, `context(user, topic)`,
+`forget(user, fact_or_id)`.
 
-### Run the Full Server Locally
+A lower-level `CLSClient` (alias `CLS`) is also exported for direct
+`write` / `read` / `get_item` / `forget` / `sleep` / `health` calls against
+the REST API — see the [API Reference](docs/API_DOCUMENTATION.md).
+
+### Connect via MCP (Claude, Cursor, Windsurf, ChatGPT)
+
+CLS++ ships a [Model Context Protocol](https://modelcontextprotocol.io) server
+exposing three tools — `recall_memories`, `store_memory`, `who_am_i` — so any
+MCP client can read and write the same memory. Registry name:
+`io.github.rajamohan1950/cls-memory`.
+
+**Remote (hosted, OAuth)** — add `https://www.clsplusplus.com/mcp` as a custom
+connector. The OAuth 2.1 + PKCE + Dynamic Client Registration flow handles
+auth; no API key to paste.
+
+**Local (stdio)** — run the bundled server with an API key:
 
 ```bash
-git clone https://github.com/rajamohan1950/CLSplusplus.git
-cd CLSplusplus
-pip install -e ".[server]"
+pip install clsplusplus
+# one-line install for Claude Code:
+claude mcp add cls-memory \
+  --env CLS_API_URL=https://www.clsplusplus.com \
+  --env CLS_API_KEY=cls_live_xxx \
+  -- python3 -m clsplusplus.mcp_server
+```
+
+Or paste this into `.claude/settings.json` (Cursor/Windsurf use the same shape
+in their MCP config):
+
+```json
+{
+  "mcpServers": {
+    "cls-memory": {
+      "command": "python3",
+      "args": ["-m", "clsplusplus.mcp_server"],
+      "env": {
+        "CLS_API_URL": "https://www.clsplusplus.com",
+        "CLS_API_KEY": "cls_live_xxx"
+      }
+    }
+  }
+}
+```
+
+The dashboard's **Connect** button (`GET /v1/mcp/connect`) mints a fresh key and
+returns this exact block pre-filled. Create keys manually at
+<https://www.clsplusplus.com/profile#api-keys>.
+
+### Agent-framework integrations
+
+CLS++ ships native memory adapters for four agent frameworks. Each is an
+optional extra and lazily imported — the base package never requires the
+framework. Full setup in [docs/integrations](docs/integrations/).
 
-# Start infrastructure (Redis + PostgreSQL)
-docker compose up -d redis postgres
+| Framework | Install | Class | Plugs in as |
+|-----------|---------|-------|-------------|
+| **CrewAI** | `pip install clsplusplus[crewai]` | `clsplusplus.integrations.crewai.CLSMemoryStorage` | `ExternalMemory(storage=...)` — [docs](docs/integrations/crewai.md) |
+| **LangGraph** | `pip install clsplusplus[langgraph]` | `clsplusplus.integrations.langgraph.CLSMemoryStore` | `graph.compile(store=...)` — [docs](docs/integrations/langgraph.md) |
+| **LlamaIndex** | `pip install clsplusplus[llamaindex]` | `clsplusplus.integrations.llamaindex.CLSMemoryBlock` | `Memory.from_defaults(memory_blocks=[...])` — [docs](docs/integrations/llamaindex.md) |
+| **AutoGen** | `pip install clsplusplus[autogen]` | `clsplusplus.integrations.autogen.CLSMemory` | `AssistantAgent(memory=[...])` — [docs](docs/integrations/autogen.md) |
 
-# Start the API server
-uvicorn clsplusplus.api:create_app --factory --host 0.0.0.0 --port 8080
+```python
+# Example: CrewAI
+from crewai import Crew
+from crewai.memory.external.external_memory import ExternalMemory
+from clsplusplus.integrations.crewai import CLSMemoryStorage
+
+crew = Crew(
+    agents=[...], tasks=[...], memory=True,
+    external_memory=ExternalMemory(storage=CLSMemoryStorage(user="my-crew")),
+)
 ```
 
+Editor integrations (Cursor, Codex, n8n) also have guides under
+[docs/integrations](docs/integrations/).
+
+### Managed service
+
+CLS++ runs as a fully managed service — no infrastructure to host. Install the
+SDK and point it at the hosted API:
+
+```bash
+pip install clsplusplus       # or: npm install clsplusplus
+```
+
+Get an API key and start storing memory at **[clsplusplus.com](https://www.clsplusplus.com)**.
+
 ---
 
 ## Try It Live
 
 **[Try the demo](https://www.clsplusplus.com)** — Tell Claude something, ask OpenAI. Same memory. No sign-up.
 
-The Chrome extension (Web Store, v6.0.1) captures user messages from
+The Chrome extension (Web Store, v7.4.1) captures user messages from
 ChatGPT, Claude, and Gemini chat pages automatically and feeds them through
 the same memory pipeline. Host permissions: `chatgpt.com`,
 `chat.openai.com`, `claude.ai`, `gemini.google.com`. The Link Account popup
@@ -204,29 +304,32 @@ export CLS_ABUSE_WHITELIST_IPS=               # comma-separated operator IPs
 Requests carrying a valid API key are exempt from auth-fail flood counting
 (see `src/clsplusplus/abuse_guard.py`).
 
-Product endpoints: `POST /v1/memories/encode`, `POST /v1/memories/retrieve`, `DELETE /v1/memories/forget`, `GET /v1/health/score`. See [SaaS docs](docs/SAAS_MEMORY_AS_SERVICE.md).
+Product endpoints: `POST /v1/memories/encode`, `POST /v1/memories/retrieve`, `DELETE /v1/memories/forget`, `GET /v1/health/score`, `GET /v1/pricing`, `GET /v1/version`, plus the in-app support desk (`POST /v1/feedback`, `GET /v1/support/mine`, `POST /v1/support/{id}/rate`). See [SaaS docs](docs/SAAS_MEMORY_AS_SERVICE.md).
+
+> Memory reads/writes are bound to the caller's own namespace server-side
+> (`_owned_namespace_for` in `api.py`): a signed-in user can never read another
+> tenant's memories by passing a namespace.
 
 ### Pricing
 
-CLS++ launched in India and bills in **INR via Razorpay (UPI / QR)** — not
-USD, not Stripe. Tiers: **Pro ₹299**, **Business ₹999**, **Enterprise
-₹4,999**. The pricing control plane lives inside the CLS++ memory layer
-itself (reserved namespace `__cls_pricing__`) and is operator-tunable at
-runtime via `POST /admin/pricing/config`. The default config — currency,
-margin floor/target, infra spend, dynamic-demand toggle — is seeded by
-`src/clsplusplus/pricing_store.py` on first read. `GET /v1/pricing` is a
+CLS++ launched in India and bills via **Razorpay (UPI / QR)**. Pricing is
+**country-based** — Indian users are billed in **₹**, US in **$**, EU in **€**,
+resolved from the request's country (`src/clsplusplus/currency.py`). Published
+monthly tiers: **Pro ₹999 / $29**, **Business ₹3,999 / $99**, **Enterprise
+₹14,999 / $499**, plus a free tier. Per-tier feature bundles are optimized by
+the `bundle-pricing` agent and exposed on `GET /v1/pricing`. The pricing control
+plane lives inside the CLS++ memory layer itself (reserved namespace
+`__cls_pricing__`), operator-tunable at runtime via `POST /admin/pricing/config`;
+defaults are seeded by `src/clsplusplus/pricing_store.py`. `GET /v1/pricing` is a
 public, abuse-exempt endpoint.
 
 ---
 
 ## Deployment
 
-| Platform | Guide |
-|----------|-------|
-| **Render** (free tier) | [Deploy in 1 click](https://render.com/deploy?repo=https://github.com/rajamohan1950/CLSplusplus) • [Setup guide](docs/DEPLOY_RENDER.md) |
-| **AWS Free Tier** | [CloudFormation](infrastructure/aws/cloudformation-free-tier.yaml) • [Step-by-step](infrastructure/aws/FREE_TIER_GUIDE.md) |
-| **AWS** | [CloudFormation](infrastructure/aws/cloudformation.yaml) |
-| **Azure** | [ARM template](infrastructure/azure/arm-template.json) |
+CLS++ is a managed, hosted service — there's nothing to deploy. The production
+API runs at **[www.clsplusplus.com](https://www.clsplusplus.com)**; enterprise
+and on-prem options are available on request.
 
 ---
 
@@ -234,7 +337,9 @@ public, abuse-exempt endpoint.
 
 | Document | Description |
 |----------|-------------|
+| [Architecture Overview](docs/ARCHITECTURE.md) | Components, stores, data flow, MCP |
 | [API Reference](docs/API_DOCUMENTATION.md) | Endpoints, auth, examples |
+| [Integrations](docs/integrations/) | CrewAI, LangGraph, LlamaIndex, AutoGen, Cursor, Codex, n8n |
 | [API Blueprint](docs/API_BLUEPRINT.md) | SaaS API playbook (DX, security, billing) |
 | [SaaS Strategy](docs/SAAS_MEMORY_AS_SERVICE.md) | Memory-as-a-Service, pricing |
 | [Marketplace Integration](docs/MARKETPLACE_INTEGRATION.md) | AWS, Azure, GCP, OCI |
@@ -254,10 +359,16 @@ public, abuse-exempt endpoint.
 - [x] Reconsolidation gate
 - [x] API key auth + rate limiting
 - [x] SaaS product endpoints
-- [x] Chrome extension (v6.0.1) capturing ChatGPT / Claude / Gemini
+- [x] Chrome extension (v7.4.1) capturing ChatGPT / Claude / Gemini
+- [x] Remote MCP server (OAuth 2.1 + PKCE + DCR) + stdio MCP server
+- [x] Native CrewAI / LangGraph / LlamaIndex / AutoGen memory adapters
 - [x] Abuse-guard with env-tunable thresholds and operator IP whitelist
 - [x] PostHog Weblab — staged rollouts with auto-rollback (5xx > 2% or p95 > 3s)
-- [x] INR pricing (Razorpay / UPI) with memory-resident control plane
+- [x] Country-based pricing (₹ / $ / €) + agent-optimized feature bundles (Razorpay / UPI), memory-resident control plane
+- [x] In-app support desk ("Doctor") — agent-triaged feedback / bugs / questions with auto-resolution + per-user timeline
+- [x] Company agent platform — `doctor-*`, `dynamic-pricing`, `bundle-pricing`, `competitive-intel`, `marketing-growth`
+- [x] `cls bench` — runnable reliability reproductions (silent-loss, delete-on-conflict, dimension-switch, empty-extraction)
+- [x] Per-user memory isolation (server-side namespace binding)
 
 ## Recent Architectural Decisions
 
@@ -288,9 +399,9 @@ container ships operator scripts at `/app/scripts/` (see
 
 ---
 
-## Contributing
+## Support
 
-We welcome contributions. See [CONTRIBUTING.md](.github/CONTRIBUTING.md) and the [Wiki](https://github.com/rajamohan1950/CLSplusplus/wiki) for details.
+Questions or enterprise enquiries: **[clsplusplus.com](https://www.clsplusplus.com)** or open a ticket at [clsplusplus.com/tickets](https://www.clsplusplus.com/tickets).
 
 ---
 
@@ -301,5 +412,5 @@ Provisional patent filed October 2025. Apache 2.0 (see [LICENSE](LICENSE)).
 ---
 
 <p align="center">
-  <strong>AlphaForge AI Labs</strong> • <a href="https://github.com/rajamohan1950">Rajamohan Jabbala</a> • 2026
+  <strong>AlphaForge AI Labs</strong> • <a href="https://www.clsplusplus.com">clsplusplus.com</a> • 2026
 </p>