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

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

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdb-mcp
-Version: 0.3.2
+Version: 0.4.0
 Summary: MCP Server for CortexDB — expose memory operations to AI agents
 License-Expression: MIT
 Requires-Python: >=3.10
@@ -180,6 +180,16 @@ On Windows, MCP clients sometimes need the absolute path:
 | `entity_edges` | `GET /v1/facts?subject=…` | Predicate/object pairs for an entity. |
 | `entity_link` | `POST /v1/experience` | Store a sentence the extractor will turn into a fact. |
 
+### Bi-temporal Conflicts & Claim History
+
+| Tool | Maps to | Description |
+|------|---------|-------------|
+| `list_conflicts` | `GET /v1/conflicts` | Queue of contradicting values detected for the same claim. |
+| `resolve_conflict` | `POST /v1/conflicts/{id}/resolve` | Resolve: `pick` / `split` / `new_information` / `dismiss`. |
+| `claim_history` | `GET /v1/claims/history` | Full bi-temporal change-log of one claim (+ its conflicts). |
+
+Validity boundaries carry a basis: `stated` boundaries render as "since/until \<date\>"; `observed` boundaries are knowledge bounds and render as "by \<date\>" — never "on \<date\>".
+
 ### Admin & Observability
 
 | Tool | Maps to | Description |

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

@@ -167,6 +167,16 @@ On Windows, MCP clients sometimes need the absolute path:
 | `entity_edges` | `GET /v1/facts?subject=…` | Predicate/object pairs for an entity. |
 | `entity_link` | `POST /v1/experience` | Store a sentence the extractor will turn into a fact. |
 
+### Bi-temporal Conflicts & Claim History
+
+| Tool | Maps to | Description |
+|------|---------|-------------|
+| `list_conflicts` | `GET /v1/conflicts` | Queue of contradicting values detected for the same claim. |
+| `resolve_conflict` | `POST /v1/conflicts/{id}/resolve` | Resolve: `pick` / `split` / `new_information` / `dismiss`. |
+| `claim_history` | `GET /v1/claims/history` | Full bi-temporal change-log of one claim (+ its conflicts). |
+
+Validity boundaries carry a basis: `stated` boundaries render as "since/until \<date\>"; `observed` boundaries are knowledge bounds and render as "by \<date\>" — never "on \<date\>".
+
 ### Admin & Observability
 
 | Tool | Maps to | Description |

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

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

{cortexdb_mcp-0.3.2 → cortexdb_mcp-0.4.0}/cortexdb_mcp/config.py

@@ -59,6 +59,10 @@ 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.
+    view: str = "holistic"
     timeout: float = 30.0
 
     # Set by save_state() / from_env() when an anonymous signup happens; used
@@ -76,6 +80,8 @@ 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_TENANT_ID    -- Legacy tenant id (v0 callers only).
         CORTEXDB_TIMEOUT      -- Request timeout in seconds (default ``30.0``).
 
@@ -90,6 +96,7 @@ class CortexMCPConfig:
             actor=os.environ.get("CORTEXDB_ACTOR"),
             scope=os.environ.get("CORTEXDB_SCOPE"),
             tenant_id=os.environ.get("CORTEXDB_TENANT_ID"),
+            view=os.environ.get("CORTEXDB_VIEW", cls.view),
             timeout=float(os.environ.get("CORTEXDB_TIMEOUT", str(cls.timeout))),
         )