cortexdb-mcp 0.7.2__tar.gz → 0.7.4__tar.gz

{cortexdb_mcp-0.7.2 → cortexdb_mcp-0.7.4}/.gitignore

@@ -1,101 +1,109 @@
-# Rust
-/target
-**/*.rs.bk
-
-# Environment / secrets
-.env
-.env.local
-.env*.local
-*.pem
-*.key
-.npmrc
-
-# SQLite database
-*.sqlite
-*.sqlite-wal
-*.sqlite-shm
-
-# OS
-.DS_Store
-Thumbs.db
-desktop.ini
-
-# IDE
-.idea/
-.vscode/
-*.swp
-*.swo
-
-# Data directories
-cortexdb_data*/
-/data/
-# Per-bench tenant stores (RocksDB + Tantivy + HNSW state; regeneratable per run)
-/data_*/
-# Experimental per-branch stores (not tracked on this branch but left gitignored
-# so checkout from other branches doesn't surface them in git status)
-/event_memory_store/
-/llm_cache/
-
-# Benchmark inputs and per-run outputs (kept local, regenerated each run)
-benchmarks/longmemeval/data/
-benchmarks/longmemeval/server_results/
-benchmarks/longmemeval/fast_results/
-benchmarks/longmemeval/micro_results/
-benchmarks/longmemeval/server_logs/
-benchmarks/longmemeval/*.log
-benchmarks/locomo/locomo_results*.json
-benchmarks/locomo/server_results/
-benchmarks/locomo/*.log
-/answer_out.json
-
-# Local Claude Code state
-.claude/
-.tmp/
-
-# Python
-__pycache__/
-*.pyc
-.venv/
-venv/
-
-# Node
-node_modules/
-dist/
-.next/
-
-# Egg info
-*.egg-info/
-
-# Scratch/debug text files at root
-/*.txt
-/*.log
-
-# Local debug / marketing / private content (not for repo)
-harness/.reports/
-harness_data_*/
-blog/
-sales/
-videos/
-local-instance/
-
-# doc-claims verifier scratch output
-tools/verifier_out*/
-
-# Generated benchmark / runtime data (audit M-10: hundreds of untracked
-# data dirs at the workspace root slow every git status/search and risk
-# being packaged; results JSONs are artifacts, never source)
-benchmarks/data_*/
-benchmarks/**/fast_results/
-data_*/
-*_data/
-*_data_20*/
-cortexdb_data*/
-server_results/
-*.log
-docker_build.log
-
-# local gate/bench data stores
-gate*_data_*/
-
-# Code-plane benchmark local run outputs (official results are committed deliberately)
-benchmarks/codeplane/runs/
+# Rust
+/target
+**/*.rs.bk
+
+# Environment / secrets
+.env
+.env.local
+.env*.local
+*.pem
+*.key
+.npmrc
+
+# SQLite database
+*.sqlite
+*.sqlite-wal
+*.sqlite-shm
+
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Data directories
+cortexdb_data*/
+/data/
+# Per-bench tenant stores (RocksDB + Tantivy + HNSW state; regeneratable per run)
+/data_*/
+# Experimental per-branch stores (not tracked on this branch but left gitignored
+# so checkout from other branches doesn't surface them in git status)
+/event_memory_store/
+/llm_cache/
+
+# Benchmark inputs and per-run outputs (kept local, regenerated each run)
+benchmarks/longmemeval/data/
+benchmarks/longmemeval/server_results/
+benchmarks/longmemeval/fast_results/
+benchmarks/longmemeval/micro_results/
+benchmarks/longmemeval/server_logs/
+benchmarks/longmemeval/*.log
+benchmarks/locomo/locomo_results*.json
+benchmarks/locomo/server_results/
+benchmarks/locomo/*.log
+/answer_out.json
+
+# Local Claude Code state
+.claude/
+.tmp/
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+venv/
+
+# Node
+node_modules/
+dist/
+.next/
+
+# Egg info
+*.egg-info/
+
+# Scratch/debug text files at root
+/*.txt
+/*.log
+
+# Local debug / marketing / private content (not for repo)
+harness/.reports/
+harness_data_*/
+blog/
+sales/
+videos/
+local-instance/
+
+# doc-claims verifier scratch output
+tools/verifier_out*/
+
+# Generated benchmark / runtime data (audit M-10: hundreds of untracked
+# data dirs at the workspace root slow every git status/search and risk
+# being packaged; results JSONs are artifacts, never source)
+benchmarks/data_*/
+benchmarks/**/fast_results/
+data_*/
+*_data/
+*_data_20*/
+cortexdb_data*/
+server_results/
+*.log
+docker_build.log
+
+# local gate/bench data stores
+gate*_data_*/
+
+# Code-plane benchmark local run outputs (official results are committed deliberately)
+benchmarks/codeplane/runs/
+
+# Deliberately untracked, four times over: `git add docs/` keeps sweeping the
+# investor deck sources and the 2.7 MB OpenClaw design PDF back in (7dda2a51,
+# 3a778b5e, then again in the 2026-09-09 checkpoint). They live on disk; they do
+# not belong in the repo. Stage explicit paths, never a directory.
+docs/investor_deck/
+docs/CORTEX_OPENCLAW_AGENT_OS_DESIGN.md
+docs/CORTEX_OPENCLAW_AGENT_OS_DESIGN.pdf

{cortexdb_mcp-0.7.2 → cortexdb_mcp-0.7.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cortexdb-mcp
-Version: 0.7.2
+Version: 0.7.4
 Summary: MCP Server for CortexDB — expose memory operations to AI agents
 License-Expression: MIT
 Requires-Python: >=3.10
@@ -9,6 +9,10 @@ Requires-Dist: httpx>=0.27
 Requires-Dist: mcp<2.0,>=1.0
 Requires-Dist: pydantic>=2.0
 Requires-Dist: uvicorn>=0.29
+Provides-Extra: test
+Requires-Dist: anyio<5,>=4.12; extra == 'test'
+Requires-Dist: pytest-asyncio<2,>=1.3; extra == 'test'
+Requires-Dist: pytest<10,>=9.0; extra == 'test'
 Description-Content-Type: text/markdown
 
 # CortexDB MCP Server
@@ -171,7 +175,7 @@ On Windows, MCP clients sometimes need the absolute path:
 | `memory_search` | `POST /v1/recall` | Search memories using natural language. |
 | `memory_forget` | `POST /v1/forget` | Delete memories. With `query`, narrows by subject. Accepts `from_preview_id` from `forget_preview`. |
 | `forget_preview` | `POST /v1/forget/preview` | Non-destructive dry run of a forget: per-layer estimated deletion counts + a `preview_id` for the safe two-phase flow. |
-| `get_context` | `POST /v1/recall` (holistic) | Deep context with facts + beliefs. |
+| `get_context` | `POST /v1/recall` (configured view; holistic by default) | By default, deep context across the requested scope, authorized ancestors, and authorized descendants—never siblings. |
 | `advanced_search` | `POST /v1/recall` + temporal | Search with structured filters (time / source / type). |
 
 ### Event CRUD
@@ -222,12 +226,8 @@ Resources provide read-only data that AI tools can access:
 | Resource URI | Description |
 |---|---|
 | `cortexdb://health` | Server health status |
-| `cortexdb://metrics` | Request metrics (total, active, errors, rate-limited) |
-| `cortexdb://usage` | Usage statistics and tier limits |
-| `cortexdb://episodes` | Recent 50 episodes |
-| `cortexdb://entities` | Top 100 knowledge graph entities |
+| `cortexdb://episodes` | Recent 50 events in the default scope |
 | `cortexdb://insights` | Proactive insights |
-| `cortexdb://ontology` | Entity and relationship type schema |
 
 ## Prompts
 
@@ -247,6 +247,10 @@ Pre-built prompt templates:
 |---|---|---|
 | `CORTEXDB_URL` | `https://api-v1.cortexdb.ai` | CortexDB server URL |
 | `CORTEXDB_API_KEY` | (none) | API key for authentication |
+| `CORTEXDB_ACTOR` | (from signup state) | Actor for `X-Cortex-Actor`; must match the token subject |
+| `CORTEXDB_SCOPE` | (from signup state) | Default scope for tool calls |
+| `CORTEXDB_VIEW` | `holistic` | Recall reach: `holistic` = self + authorized ancestors + authorized descendants (no siblings); `descend` = self + authorized descendants; `granular` = exact scope |
+| `CORTEXDB_TENANT_ID` | (none) | Legacy v0 tenant identifier |
 | `CORTEXDB_TIMEOUT` | `30.0` | HTTP request timeout (seconds) |
 
 ## Examples

{cortexdb_mcp-0.7.2 → cortexdb_mcp-0.7.4}/README.md

@@ -158,7 +158,7 @@ On Windows, MCP clients sometimes need the absolute path:
 | `memory_search` | `POST /v1/recall` | Search memories using natural language. |
 | `memory_forget` | `POST /v1/forget` | Delete memories. With `query`, narrows by subject. Accepts `from_preview_id` from `forget_preview`. |
 | `forget_preview` | `POST /v1/forget/preview` | Non-destructive dry run of a forget: per-layer estimated deletion counts + a `preview_id` for the safe two-phase flow. |
-| `get_context` | `POST /v1/recall` (holistic) | Deep context with facts + beliefs. |
+| `get_context` | `POST /v1/recall` (configured view; holistic by default) | By default, deep context across the requested scope, authorized ancestors, and authorized descendants—never siblings. |
 | `advanced_search` | `POST /v1/recall` + temporal | Search with structured filters (time / source / type). |
 
 ### Event CRUD
@@ -209,12 +209,8 @@ Resources provide read-only data that AI tools can access:
 | Resource URI | Description |
 |---|---|
 | `cortexdb://health` | Server health status |
-| `cortexdb://metrics` | Request metrics (total, active, errors, rate-limited) |
-| `cortexdb://usage` | Usage statistics and tier limits |
-| `cortexdb://episodes` | Recent 50 episodes |
-| `cortexdb://entities` | Top 100 knowledge graph entities |
+| `cortexdb://episodes` | Recent 50 events in the default scope |
 | `cortexdb://insights` | Proactive insights |
-| `cortexdb://ontology` | Entity and relationship type schema |
 
 ## Prompts
 
@@ -234,6 +230,10 @@ Pre-built prompt templates:
 |---|---|---|
 | `CORTEXDB_URL` | `https://api-v1.cortexdb.ai` | CortexDB server URL |
 | `CORTEXDB_API_KEY` | (none) | API key for authentication |
+| `CORTEXDB_ACTOR` | (from signup state) | Actor for `X-Cortex-Actor`; must match the token subject |
+| `CORTEXDB_SCOPE` | (from signup state) | Default scope for tool calls |
+| `CORTEXDB_VIEW` | `holistic` | Recall reach: `holistic` = self + authorized ancestors + authorized descendants (no siblings); `descend` = self + authorized descendants; `granular` = exact scope |
+| `CORTEXDB_TENANT_ID` | (none) | Legacy v0 tenant identifier |
 | `CORTEXDB_TIMEOUT` | `30.0` | HTTP request timeout (seconds) |
 
 ## Examples

cortexdb_mcp-0.7.4/cortexdb_mcp/__init__.py

@@ -0,0 +1,17 @@
+"""CortexDB MCP Server -- expose CortexDB memory operations to AI agents via MCP."""
+
+from importlib.metadata import PackageNotFoundError, version as _dist_version
+
+# Derived, never restated (KAN-152). A hand-maintained copy of the version
+# drifted the moment someone bumped pyproject.toml and not this file: the
+# published 0.7.2 distribution reported 0.7.1 from `--version` and from this
+# constant, so every version fact an agent could read disagreed with the
+# artifact it had installed. Reading the installed distribution's metadata
+# makes pyproject.toml the single source and removes the possibility of drift
+# rather than fixing one instance of it.
+try:
+    __version__ = _dist_version("cortexdb-mcp")
+except PackageNotFoundError:  # running from a source tree, not installed
+    __version__ = "0.0.0+unknown"
+
+__all__ = ["__version__"]

{cortexdb_mcp-0.7.2 → cortexdb_mcp-0.7.4}/cortexdb_mcp/config.py

@@ -59,9 +59,9 @@ class CortexMCPConfig:
     actor: str | None = None
     scope: str | None = None
     tenant_id: str | None = None
-    # Default recall reach. "holistic" = the scope + its parents (the server
-    # default); "descend" = the scope + all sub-scopes (e.g. query the org root
-    # and reach every per-source sub-scope at once); "granular" = exact scope.
+    # Default public-recall reach. "holistic" = the scope + authorized ancestors
+    # + authorized descendants, never siblings (the server default); "descend"
+    # = the scope + authorized descendants; "granular" = exact scope.
     view: str = "holistic"
     timeout: float = 30.0
 
@@ -80,8 +80,10 @@ class CortexMCPConfig:
         CORTEXDB_API_KEY      -- PASETO token (preferred) or legacy v0 key.
         CORTEXDB_ACTOR        -- ActorId for X-Cortex-Actor (e.g. ``user:alice``).
         CORTEXDB_SCOPE        -- Default scope path for tool calls.
-        CORTEXDB_VIEW         -- Default recall reach: ``holistic`` (default),
-                                 ``descend`` (scope + all sub-scopes), or ``granular``.
+        CORTEXDB_VIEW         -- Default public-recall reach: ``holistic``
+                                 (scope + authorized ancestors + authorized
+                                 descendants, never siblings), ``descend``
+                                 (scope + authorized descendants), or ``granular``.
         CORTEXDB_TENANT_ID    -- Legacy tenant id (v0 callers only).
         CORTEXDB_TIMEOUT      -- Request timeout in seconds (default ``30.0``).
 

{cortexdb_mcp-0.7.2 → cortexdb_mcp-0.7.4}/cortexdb_mcp/server.py

@@ -1409,7 +1409,7 @@ async def code_explore(
     else:
         path = "/v1/code/workspace/context"
         payload = {"repos": selected, "task": query, "token_budget": budget}
-    result = await _request("POST", path, json=payload)
+    result = await _request("POST", path, json_body=payload)
     envelope = result.get("envelope", {})
     items = envelope.get("items", [])
     if not items:
@@ -1428,7 +1428,7 @@ async def code_explore(
         f" files, {envelope.get('tokens_used', 0)}/{envelope.get('token_budget', budget)}"
         " tokens)"
     )
-    return "\\n".join(lines)
+    return "\n".join(lines)
 
 
 @mcp.tool(structured_output=False)
@@ -1472,7 +1472,7 @@ async def code_impact(
         )
     if result.get("truncated"):
         lines.append("(truncated at the row budget — narrow the depth)")
-    return "\\n".join(lines)
+    return "\n".join(lines)
 
 
 @mcp.tool(structured_output=False)
@@ -1534,7 +1534,7 @@ async def code_inventory(
         payload["cursor"] = max(0, int(cursor))
     if selected == "files" and path is not None:
         payload["path"] = path
-    result = await _request("POST", "/v1/code/inventory", json=payload)
+    result = await _request("POST", "/v1/code/inventory", json_body=payload)
     if selected == "stats":
         stats = result.get("stats", {})
         counts = stats.get("predicate_counts", {})
@@ -1587,7 +1587,7 @@ async def code_inventory(
     if result.get("truncated"):
         lines.append(f"(more rows available; next cursor: {result.get('next_cursor')})")
     lines.append(f"({result.get('scanned', len(rows))} catalog members scanned)")
-    return "\\n".join(lines)
+    return "\n".join(lines)
 
 
 @mcp.tool(structured_output=False)
@@ -1624,7 +1624,7 @@ async def code_graph(
         "max_nodes": max(1, min(int(max_nodes), 5000)),
         "max_edges": max(1, min(int(max_edges), 10000)),
     }
-    result = await _request("POST", "/v1/code/graph/query", json=payload)
+    result = await _request("POST", "/v1/code/graph/query", json_body=payload)
     nodes = {
         row.get("id"): row.get("label") or row.get("symbol") or f"node {row.get('id')}"
         for row in result.get("nodes", [])
@@ -1655,7 +1655,8 @@ async def code_graph(
     )
     if result.get("truncated"):
         lines.append("(truncated at the explicit node/edge budget — narrow the query)")
-    return "\\n".join(lines)
+    return "\n".join(lines)
+
 
 def main() -> None:
     """Run the CortexDB MCP server over stdio transport."""

{cortexdb_mcp-0.7.2 → cortexdb_mcp-0.7.4}/pyproject.toml

@@ -1,26 +1,37 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "cortexdb-mcp"
-version = "0.7.2"
-description = "MCP Server for CortexDB — expose memory operations to AI agents"
-requires-python = ">=3.10"
-license = "MIT"
-readme = "README.md"
-dependencies = [
-    # KAN-151: an unbounded `mcp>=1.0` resolved to mcp 2.0.0 on a fresh
-    # install, which removed/relocated `mcp.server.fastmcp` — every new
-    # install of cortexdb-mcp crashed with ModuleNotFoundError at import
-    # time, before main() ran. Bound the major until this server is
-    # migrated to the 2.x API.
-    "mcp>=1.0,<2.0",
-    "httpx>=0.27",
-    "pydantic>=2.0",
-    "fastapi>=0.110",
-    "uvicorn>=0.29",
-]
-
-[project.scripts]
-cortexdb-mcp = "cortexdb_mcp.server:main"
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "cortexdb-mcp"
+version = "0.7.4"
+description = "MCP Server for CortexDB — expose memory operations to AI agents"
+requires-python = ">=3.10"
+license = "MIT"
+readme = "README.md"
+dependencies = [
+    # KAN-151: an unbounded `mcp>=1.0` resolved to mcp 2.0.0 on a fresh
+    # install, which removed/relocated `mcp.server.fastmcp` — every new
+    # install of cortexdb-mcp crashed with ModuleNotFoundError at import
+    # time, before main() ran. Bound the major until this server is
+    # migrated to the 2.x API.
+    "mcp>=1.0,<2.0",
+    "httpx>=0.27",
+    "pydantic>=2.0",
+    "fastapi>=0.110",
+    "uvicorn>=0.29",
+]
+
+[project.optional-dependencies]
+# `pip install -e ".[test]"` then `python -m pytest -q`. Pinned to the
+# major lines the suite is verified against: pytest 9.x, pytest-asyncio 1.x
+# (strict mode, `@pytest.mark.asyncio`), anyio 4.x (the async backend mcp
+# and httpx run on; its pytest plugin must coexist with pytest-asyncio).
+test = [
+    "pytest>=9.0,<10",
+    "pytest-asyncio>=1.3,<2",
+    "anyio>=4.12,<5",
+]
+
+[project.scripts]
+cortexdb-mcp = "cortexdb_mcp.server:main"

{cortexdb_mcp-0.7.2 → cortexdb_mcp-0.7.4}/tests/test_server.py

@@ -9,7 +9,7 @@ here cover only the surface the server actually exposes.
 from __future__ import annotations
 
 from datetime import datetime, timedelta, timezone
-from unittest.mock import AsyncMock, patch
+from unittest.mock import create_autospec, patch
 
 import pytest
 
@@ -31,6 +31,7 @@ from cortexdb_mcp.server import (
     _is_synthetic_subject,
     _memories_from_context,
     _record_text,
+    _request,
     _typed_value_text,
     advanced_search,
     belief_declare,
@@ -62,8 +63,15 @@ from cortexdb_mcp.server import (
 
 
 def _mock_request(return_value: dict):
-    """Patch ``_request`` with an async mock returning ``return_value``."""
-    mock = AsyncMock(return_value=return_value)
+    """Patch ``_request`` with an awaitable mock returning ``return_value``.
+
+    The mock is autospecced from the real helper, so a tool that passes a
+    keyword ``_request`` does not accept (``json=`` where it takes
+    ``json_body=``) fails here with the same ``TypeError`` it raises in
+    production. A permissive ``AsyncMock`` hid exactly that for three of
+    the four code tools.
+    """
+    mock = create_autospec(_request, return_value=return_value)
     return patch("cortexdb_mcp.server._request", mock), mock
 
 
@@ -1254,6 +1262,8 @@ class TestGetInsightsTool:
 
 
 class TestCodeTools:
+    """T-905: focused read-only code tools, budget-enforced."""
+
     def test_code_tool_profile_is_exact_and_deterministic(self):
         available = ["memory_search", "code_impact", "code_explore", "entity_search"]
         assert _selected_tool_names("code", available) == ["code_explore", "code_impact"]
@@ -1267,8 +1277,6 @@ class TestCodeTools:
             tool = next(tool for tool in await srv.mcp.list_tools() if tool.name == name)
             assert tool.outputSchema is None
 
-    """T-905: focused read-only code tools, budget-enforced."""
-
     @pytest.mark.anyio
     async def test_code_explore_renders_envelope_with_warnings(self):
         patcher, mock = _mock_request(
@@ -1296,6 +1304,16 @@ class TestCodeTools:
         assert "WARNING: prior attempt" in out
         assert "NOTE: truncated" in out
         assert "1/3 files" in out
+        # One entry per line, joined with a real newline — the tool once
+        # joined with the two-character string backslash-n.
+        assert out.splitlines() == [
+            "// shop:core/billing.ts@abc123 [changed]",
+            "export function settle(i) {}",
+            "WARNING: prior attempt on `settle`: broke rounding",
+            "NOTE: truncated to fit budget: core/billing.ts",
+            "(1/3 files, 90/100 tokens)",
+        ]
+        assert "\\n" not in out
         # Read-only: the request was a context POST, nothing else.
         method, path = mock.call_args[0][0], mock.call_args[0][1]
         assert (method, path) == ("POST", "/v1/code/context")
@@ -1305,10 +1323,10 @@ class TestCodeTools:
         patcher, mock = _mock_request({"envelope": {"items": []}})
         with patcher:
             await code_explore("q", repo="shop", token_budget=999999)
-        assert mock.call_args.kwargs["json"]["token_budget"] == 8000
+        assert mock.call_args.kwargs["json_body"]["token_budget"] == 8000
         with patcher:
             await code_explore("q", repo="shop", token_budget=1)
-        assert mock.call_args.kwargs["json"]["token_budget"] == 100
+        assert mock.call_args.kwargs["json_body"]["token_budget"] == 100
 
     @pytest.mark.anyio
     async def test_code_explore_supports_one_budgeted_multi_repo_call(self):
@@ -1346,7 +1364,7 @@ class TestCodeTools:
             )
         assert "api:src/client.ts" in out and "worker:src/job.py" in out
         assert mock.call_args[0][:2] == ("POST", "/v1/code/workspace/context")
-        assert mock.call_args.kwargs["json"]["repos"] == ["api", "worker"]
+        assert mock.call_args.kwargs["json_body"]["repos"] == ["api", "worker"]
 
     @pytest.mark.anyio
     async def test_code_explore_without_repo_searches_visible_workspace(self):
@@ -1354,7 +1372,7 @@ class TestCodeTools:
         with patcher:
             await code_explore("find the owner")
         assert mock.call_args[0][:2] == ("POST", "/v1/code/workspace/context")
-        assert mock.call_args.kwargs["json"]["repos"] == []
+        assert mock.call_args.kwargs["json_body"]["repos"] == []
 
     @pytest.mark.anyio
     async def test_code_impact_reports_tiers_and_truncation(self):
@@ -1372,6 +1390,13 @@ class TestCodeTools:
         assert "sym-main" in out and "Compiler" in out
         assert "node 9" in out and "Syntax" in out
         assert "truncated" in out
+        assert out.splitlines() == [
+            "Impact of changing 'settle' (depth 6):",
+            "- sym-main (hops: 1, confidence: Compiler)",
+            "- node 9 (hops: 2, confidence: Syntax)",
+            "(truncated at the row budget — narrow the depth)",
+        ]
+        assert "\\n" not in out
         # Depth clamped to 6; read-only GET.
         assert mock.call_args.kwargs["params"]["depth"] == 6
         method, path = mock.call_args[0][0], mock.call_args[0][1]
@@ -1409,8 +1434,15 @@ class TestCodeTools:
             out = await code_inventory("routes", "shop", limit=99999)
         assert "configure -> /healthz [Syntax/Dynamic]" in out
         assert "next cursor: 17" in out
+        assert out.splitlines() == [
+            "Routes in 'shop':",
+            "- configure -> /healthz [Syntax/Dynamic]",
+            "(more rows available; next cursor: 17)",
+            "(1 catalog members scanned)",
+        ]
+        assert "\\n" not in out
         assert mock.call_args[0][:2] == ("POST", "/v1/code/inventory")
-        assert mock.call_args.kwargs["json"]["limit"] == 1000
+        assert mock.call_args.kwargs["json_body"]["limit"] == 1000
 
     @pytest.mark.anyio
     async def test_code_inventory_renders_stats_and_closed_predicate_schema(self):
@@ -1434,7 +1466,7 @@ class TestCodeTools:
         assert "calls=11, defines=8" in out
         assert "predicate schema: defines, calls, references" in out
         assert "freshness: ready, pending=0, strategy=unknown" in out
-        assert mock.call_args.kwargs["json"]["kind"] == "stats"
+        assert mock.call_args.kwargs["json_body"]["kind"] == "stats"
 
     @pytest.mark.anyio
     async def test_code_inventory_preserves_dead_code_uncertainty(self):
@@ -1485,7 +1517,7 @@ class TestCodeTools:
         with patcher:
             out = await code_inventory("files", "subject", path="src")
         assert "src/cypher [directory]" in out
-        assert mock.call_args.kwargs["json"]["path"] == "src"
+        assert mock.call_args.kwargs["json_body"]["path"] == "src"
 
     @pytest.mark.anyio
     async def test_code_graph_is_one_bounded_typed_query(self):
@@ -1526,7 +1558,132 @@ class TestCodeTools:
         assert "handler --handles_event[Syntax/Dynamic]--> invoice.created" in out
         assert "long-handler-identity" not in out
         assert "truncated" in out
+        assert out.splitlines() == [
+            "- handler --handles_event[Syntax/Dynamic]--> invoice.created (depth 1)",
+            "(2 nodes, 1 edges, generation 7, depth 1)",
+            "(truncated at the explicit node/edge budget — narrow the query)",
+        ]
+        assert "\\n" not in out
         assert mock.call_args[0][:2] == ("POST", "/v1/code/graph/query")
-        payload = mock.call_args.kwargs["json"]
+        payload = mock.call_args.kwargs["json_body"]
         assert payload["depth"] == 6
         assert payload["max_edges"] == 10000
+
+
+# ---------------------------------------------------------------------------
+# Code tools — wire contract with ``_request``. The helper's body keyword is
+# ``json_body`` (keyword-only); ``code_explore``, ``code_inventory`` and
+# ``code_graph`` once passed ``json=`` and raised TypeError on every call,
+# which the old permissive AsyncMock accepted. Each test pins the exact
+# positional args and kwargs the tool hands to the helper.
+# ---------------------------------------------------------------------------
+
+
+class TestCodeToolsWireContract:
+    def test_request_mock_rejects_kwargs_the_helper_does_not_accept(self):
+        # Guard on the guard: the harness must reproduce the production
+        # TypeError, or none of the assertions below could catch a regression.
+        _, mock = _mock_request({})
+        with pytest.raises(TypeError, match="json"):
+            mock("POST", "/v1/code/context", json={"repo": "shop"})
+        mock.assert_not_awaited()
+
+    @pytest.mark.anyio
+    async def test_code_explore_single_repo_passes_json_body(self):
+        patcher, mock = _mock_request({"envelope": {"items": []}})
+        with patcher:
+            await code_explore("how does settle work?", repo="shop", token_budget=250)
+        assert mock.await_count == 1
+        assert mock.call_args.args == ("POST", "/v1/code/context")
+        assert mock.call_args.kwargs == {
+            "json_body": {
+                "repo": "shop",
+                "task": "how does settle work?",
+                "token_budget": 250,
+            }
+        }
+
+    @pytest.mark.anyio
+    async def test_code_explore_workspace_passes_json_body(self):
+        patcher, mock = _mock_request({"envelope": {"items": []}})
+        with patcher:
+            await code_explore(
+                "trace the request", repo="api", repos=["worker", "api"], token_budget=250
+            )
+        assert mock.await_count == 1
+        assert mock.call_args.args == ("POST", "/v1/code/workspace/context")
+        assert mock.call_args.kwargs == {
+            "json_body": {
+                "repos": ["api", "worker"],
+                "task": "trace the request",
+                "token_budget": 250,
+            }
+        }
+
+    @pytest.mark.anyio
+    async def test_code_impact_passes_params_only(self):
+        patcher, mock = _mock_request({"reached": [], "identities": [{"id": 1}]})
+        with patcher:
+            await code_impact("settle", repo="shop", depth=2)
+        assert mock.await_count == 1
+        assert mock.call_args.args == ("GET", "/v1/code/impact")
+        assert mock.call_args.kwargs == {
+            "params": {"repo": "shop", "symbol": "settle", "depth": 2}
+        }
+
+    @pytest.mark.anyio
+    async def test_code_inventory_passes_json_body_with_cursor_and_path(self):
+        patcher, mock = _mock_request({"rows": [], "scanned": 0})
+        with patcher:
+            await code_inventory("files", "shop", limit=50, cursor=17, path="src")
+        assert mock.await_count == 1
+        assert mock.call_args.args == ("POST", "/v1/code/inventory")
+        assert mock.call_args.kwargs == {
+            "json_body": {
+                "repo": "shop",
+                "kind": "files",
+                "limit": 50,
+                "cursor": 17,
+                "path": "src",
+            }
+        }
+
+    @pytest.mark.anyio
+    async def test_code_inventory_symbol_search_passes_params_only(self):
+        patcher, mock = _mock_request({"matches": [], "truncated": False})
+        with patcher:
+            await code_inventory("symbols", "shop", prefix="cbm_", limit=50)
+        assert mock.await_count == 1
+        assert mock.call_args.args == ("GET", "/v1/code/symbol/search")
+        assert mock.call_args.kwargs == {
+            "params": {"repo": "shop", "prefix": "cbm_", "limit": 50}
+        }
+
+    @pytest.mark.anyio
+    async def test_code_graph_passes_json_body(self):
+        patcher, mock = _mock_request({"nodes": [], "edges": [], "resolutions": []})
+        with patcher:
+            await code_graph(
+                ["invoice.created"],
+                repo="shop",
+                predicates=["handles_event"],
+                direction="incoming",
+                depth=2,
+                include_dynamic=True,
+                max_nodes=10,
+                max_edges=20,
+            )
+        assert mock.await_count == 1
+        assert mock.call_args.args == ("POST", "/v1/code/graph/query")
+        assert mock.call_args.kwargs == {
+            "json_body": {
+                "repo": "shop",
+                "roots": ["invoice.created"],
+                "predicates": ["handles_event"],
+                "direction": "incoming",
+                "depth": 2,
+                "include_dynamic": True,
+                "max_nodes": 10,
+                "max_edges": 20,
+            }
+        }

cortexdb_mcp-0.7.2/cortexdb_mcp/__init__.py

@@ -1,3 +0,0 @@
-"""CortexDB MCP Server -- expose CortexDB memory operations to AI agents via MCP."""
-
-__version__ = "0.7.1"