cortexdb-mcp 0.4.0__tar.gz → 0.5.0__tar.gz

{cortexdb_mcp-0.4.0 → cortexdb_mcp-0.5.0}/.gitignore

@@ -77,6 +77,6 @@ blog/
 sales/
 videos/
 local-instance/
-
-# doc-claims verifier scratch output
-tools/verifier_out*/
+
+# doc-claims verifier scratch output
+tools/verifier_out*/

{cortexdb_mcp-0.4.0 → cortexdb_mcp-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdb-mcp
-Version: 0.4.0
+Version: 0.5.0
 Summary: MCP Server for CortexDB — expose memory operations to AI agents
 License-Expression: MIT
 Requires-Python: >=3.10
@@ -157,6 +157,7 @@ On Windows, MCP clients sometimes need the absolute path:
 | Tool | Maps to | Description |
 |------|---------|-------------|
 | `memory_store` | `POST /v1/experience` | Store a new memory. Source/tags/type become labels. |
+| `memory_status` | `GET /v1/experience/status` | Did a store land? Check by event ID or idempotency key after a timeout — "not found"/"failed" both mean re-storing is safe. |
 | `memory_search` | `POST /v1/recall` | Search memories using natural language. |
 | `memory_forget` | `POST /v1/forget` | Delete memories. With `query`, narrows by subject. |
 | `get_context` | `POST /v1/recall` (holistic) | Deep context with facts + beliefs. |

{cortexdb_mcp-0.4.0 → cortexdb_mcp-0.5.0}/README.md

@@ -144,6 +144,7 @@ On Windows, MCP clients sometimes need the absolute path:
 | Tool | Maps to | Description |
 |------|---------|-------------|
 | `memory_store` | `POST /v1/experience` | Store a new memory. Source/tags/type become labels. |
+| `memory_status` | `GET /v1/experience/status` | Did a store land? Check by event ID or idempotency key after a timeout — "not found"/"failed" both mean re-storing is safe. |
 | `memory_search` | `POST /v1/recall` | Search memories using natural language. |
 | `memory_forget` | `POST /v1/forget` | Delete memories. With `query`, narrows by subject. |
 | `get_context` | `POST /v1/recall` (holistic) | Deep context with facts + beliefs. |

{cortexdb_mcp-0.4.0 → cortexdb_mcp-0.5.0}/cortexdb_mcp/__init__.py

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

{cortexdb_mcp-0.4.0 → cortexdb_mcp-0.5.0}/cortexdb_mcp/server.py

@@ -253,6 +253,57 @@ async def memory_store(
     return f"Stored successfully. Event ID: {event_id}{warning_suffix}"
 
 
+@mcp.tool()
+async def memory_status(
+    event_id: str | None = None,
+    idempotency_key: str | None = None,
+) -> str:
+    """Check whether a stored memory landed and how far it has progressed,
+    via GET /v1/experience/status. Use this after a memory_store call timed
+    out or errored to decide whether to retry: "not found" or "failed" both
+    mean re-storing the same content is safe (it re-processes, never
+    duplicates).
+
+    Parameters
+    ----------
+    event_id:
+        The ``Event ID`` returned by ``memory_store``.
+    idempotency_key:
+        Alternatively, the idempotency key of the original write
+        (keys are kept for 24 hours).
+    """
+    if not event_id and not idempotency_key:
+        return "Pass event_id (from memory_store) or idempotency_key."
+    params: dict[str, Any] = {}
+    if event_id:
+        params["event_id"] = event_id
+    if idempotency_key:
+        params["idempotency_key"] = idempotency_key
+    result = await _request("GET", "/v1/experience/status", params=params)
+    if not result.get("found"):
+        return (
+            "Not found: never stored, expired (>24h), or failed and evicted. "
+            "Re-storing the same content is safe."
+        )
+    status = result.get("status", "unknown")
+    stages = ", ".join(result.get("stages_completed", [])) or "none"
+    line = (
+        f"Status: {status}. Event ID: {result.get('event_id', 'unknown')}. "
+        f"Stages completed: {stages}."
+    )
+    if status == "failed":
+        reason = result.get("failure_reason", "unknown")
+        line += (
+            f" Indexing failed ({reason}) — the memory is NOT searchable; "
+            "re-store the same content to re-process it."
+        )
+    elif status == "indexed":
+        line += " The memory is stored and searchable."
+    else:
+        line += " Accepted and durable; indexing still in progress."
+    return line
+
+
 @mcp.tool()
 async def memory_search(
     query: str,

{cortexdb_mcp-0.4.0 → cortexdb_mcp-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cortexdb-mcp"
-version = "0.4.0"
+version = "0.5.0"
 description = "MCP Server for CortexDB — expose memory operations to AI agents"
 requires-python = ">=3.10"
 license = "MIT"

{cortexdb_mcp-0.4.0 → cortexdb_mcp-0.5.0}/tests/test_integration.py

@@ -1,67 +1,67 @@
-"""Live-instance smoke test for the v1 MCP server.
-
-Hits a real CortexDB v1 deployment. Skipped by default — set
-``CORTEXDB_LIVE=1`` to run.
-
-Defaults to ``https://api-v1.cortexdb.ai`` and anonymous signup so the
-test needs no pre-existing API key. Override with the usual env vars
-(``CORTEXDB_URL``, ``CORTEXDB_API_KEY``, ``CORTEXDB_ACTOR``,
-``CORTEXDB_SCOPE``) when targeting a private deployment.
-"""
-
-from __future__ import annotations
-
-import os
-import time
-
-import pytest
-
-# Hard gate — never runs in normal CI.
-if not os.environ.get("CORTEXDB_LIVE"):
-    pytest.skip("set CORTEXDB_LIVE=1 to run", allow_module_level=True)
-
-# Stash a real API URL into env BEFORE importing the server module, since
-# `_config` is built at import time.
-os.environ.setdefault("CORTEXDB_URL", "https://api-v1.cortexdb.ai")
-
-from cortexdb_mcp.server import (  # noqa: E402
-    health_check,
-    memory_list,
-    memory_search,
-    memory_store,
-)
-
-
-@pytest.mark.asyncio
-async def test_health_check_returns_caller():
-    """Health check proves the bearer works AND the deployment is reachable."""
-    out = await health_check()
-    assert "caller" in out
-    assert "deployment_preset" in out
-
-
-@pytest.mark.asyncio
-async def test_store_then_search_roundtrip():
-    """Full happy path: store a memory, wait for indexing, search it back."""
-    marker = f"mcp-live-{int(time.time())}"
-    store_out = await memory_store(
-        content=f"MCP integration test event {marker}",
-        source="mcp-integration-test",
-    )
-    assert "Stored successfully" in store_out
-
-    # Give the v1 pipeline a beat to index. Async enrichment finishes
-    # in ~4-10s; 15s margin keeps the test stable.
-    time.sleep(15)
-
-    search_out = await memory_search(query=marker, max_results=5)
-    # The marker text should round-trip through recall.
-    assert marker in search_out or "No results" in search_out
-
-
-@pytest.mark.asyncio
-async def test_memory_list_returns_recent():
-    """List endpoint surfaces events the caller can see."""
-    out = await memory_list(limit=3)
-    # Either some events or the empty-list message — both are healthy.
-    assert isinstance(out, str)
+"""Live-instance smoke test for the v1 MCP server.
+
+Hits a real CortexDB v1 deployment. Skipped by default — set
+``CORTEXDB_LIVE=1`` to run.
+
+Defaults to ``https://api-v1.cortexdb.ai`` and anonymous signup so the
+test needs no pre-existing API key. Override with the usual env vars
+(``CORTEXDB_URL``, ``CORTEXDB_API_KEY``, ``CORTEXDB_ACTOR``,
+``CORTEXDB_SCOPE``) when targeting a private deployment.
+"""
+
+from __future__ import annotations
+
+import os
+import time
+
+import pytest
+
+# Hard gate — never runs in normal CI.
+if not os.environ.get("CORTEXDB_LIVE"):
+    pytest.skip("set CORTEXDB_LIVE=1 to run", allow_module_level=True)
+
+# Stash a real API URL into env BEFORE importing the server module, since
+# `_config` is built at import time.
+os.environ.setdefault("CORTEXDB_URL", "https://api-v1.cortexdb.ai")
+
+from cortexdb_mcp.server import (  # noqa: E402
+    health_check,
+    memory_list,
+    memory_search,
+    memory_store,
+)
+
+
+@pytest.mark.asyncio
+async def test_health_check_returns_caller():
+    """Health check proves the bearer works AND the deployment is reachable."""
+    out = await health_check()
+    assert "caller" in out
+    assert "deployment_preset" in out
+
+
+@pytest.mark.asyncio
+async def test_store_then_search_roundtrip():
+    """Full happy path: store a memory, wait for indexing, search it back."""
+    marker = f"mcp-live-{int(time.time())}"
+    store_out = await memory_store(
+        content=f"MCP integration test event {marker}",
+        source="mcp-integration-test",
+    )
+    assert "Stored successfully" in store_out
+
+    # Give the v1 pipeline a beat to index. Async enrichment finishes
+    # in ~4-10s; 15s margin keeps the test stable.
+    time.sleep(15)
+
+    search_out = await memory_search(query=marker, max_results=5)
+    # The marker text should round-trip through recall.
+    assert marker in search_out or "No results" in search_out
+
+
+@pytest.mark.asyncio
+async def test_memory_list_returns_recent():
+    """List endpoint surfaces events the caller can see."""
+    out = await memory_list(limit=3)
+    # Either some events or the empty-list message — both are healthy.
+    assert isinstance(out, str)

{cortexdb_mcp-0.4.0 → cortexdb_mcp-0.5.0}/tests/test_server.py

@@ -41,6 +41,7 @@ from cortexdb_mcp.server import (
     memory_get,
     memory_list,
     memory_search,
+    memory_status,
     memory_store,
     resolve_conflict,
 )
@@ -155,6 +156,55 @@ class TestMemoryStore:
         assert "observed_at" in body["context"]
         assert body["idempotency_key"].startswith("mcp-")
 
+    @pytest.mark.asyncio
+    async def test_memory_status_by_event_id(self):
+        patcher, mock = _mock_request(
+            {
+                "found": True,
+                "event_id": "evt_123",
+                "status": "indexed",
+                "stages_completed": ["captured", "indexed"],
+                "note": "stored and queryable",
+            }
+        )
+        with patcher:
+            result = await memory_status(event_id="evt_123")
+        assert "indexed" in result
+        assert "evt_123" in result
+        method, path = mock.call_args[0][:2]
+        assert method == "GET"
+        assert path == "/v1/experience/status"
+        assert mock.call_args[1]["params"] == {"event_id": "evt_123"}
+
+    @pytest.mark.asyncio
+    async def test_memory_status_failed_says_restore_is_safe(self):
+        patcher, _ = _mock_request(
+            {
+                "found": True,
+                "event_id": "evt_bad",
+                "status": "failed",
+                "stages_completed": ["captured"],
+                "failure_reason": "embedding provider unavailable",
+                "note": "…",
+            }
+        )
+        with patcher:
+            result = await memory_status(idempotency_key="k-1")
+        assert "failed" in result
+        assert "re-store" in result.lower()
+
+    @pytest.mark.asyncio
+    async def test_memory_status_not_found_is_safe_to_retry(self):
+        patcher, _ = _mock_request({"found": False, "note": "…"})
+        with patcher:
+            result = await memory_status(idempotency_key="never-sent")
+        assert "safe" in result.lower()
+
+    @pytest.mark.asyncio
+    async def test_memory_status_requires_an_argument(self):
+        result = await memory_status()
+        assert "event_id" in result
+
     @pytest.mark.asyncio
     async def test_source_and_tags_become_labels(self):
         patcher, mock = _mock_request({"event_id": "evt_456"})