cortexdbai 0.4.2__tar.gz → 0.4.3__tar.gz

{cortexdbai-0.4.2 → cortexdbai-0.4.3}/.gitignore

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

{cortexdbai-0.4.2 → cortexdbai-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdbai
-Version: 0.4.2
+Version: 0.4.3
 Summary: The Long-Term Memory Layer for AI Systems
 Project-URL: Homepage, https://cortexdb.ai
 Project-URL: Documentation, https://docs.cortexdb.ai
@@ -234,6 +234,54 @@ with Cortex("http://localhost:3141") as c:
         print(f"API error [{e.status_code}]: {e}")
 ```
 
+## Integrations
+
+Framework and provider adapters ship as optional extras of the same
+`cortexdbai` package — there are no separate `cortexdb-<framework>` packages
+to install. Pick an extra and import from `cortexdb.integrations.<submodule>`:
+
+```bash
+pip install cortexdbai[langgraph]      # or crewai, llamaindex, autogen, …
+```
+
+```python
+from cortexdb.integrations.langgraph import CortexDBCheckpointer, cortexdb_memory_node
+```
+
+Available extras (`pip install cortexdbai[<extra>]`):
+
+| Extra | Import submodule |
+|-------|------------------|
+| `autogen` | `cortexdb.integrations.autogen` |
+| `beeai` | `cortexdb.integrations.beeai` |
+| `camel` | `cortexdb.integrations.camel` |
+| `controlflow` | `cortexdb.integrations.controlflow` |
+| `crewai` | `cortexdb.integrations.crewai` |
+| `dify` | `cortexdb.integrations.dify` |
+| `dspy` | `cortexdb.integrations.dspy` |
+| `flowise` | `cortexdb.integrations.flowise` |
+| `google-adk` | `cortexdb.integrations.google_adk` |
+| `hermes` | `cortexdb.integrations.hermes` |
+| `instructor` | `cortexdb.integrations.instructor` |
+| `langgraph` | `cortexdb.integrations.langgraph` |
+| `letta` | `cortexdb.integrations.letta` |
+| `llamaindex` | `cortexdb.integrations.llamaindex` |
+| `nemo-guardrails` | `cortexdb.integrations.nemo_guardrails` |
+| `openai-agents` | `cortexdb.integrations.openai_agents` |
+| `prefect` | `cortexdb.integrations.prefect` |
+| `pydanticai` | `cortexdb.integrations.pydanticai` |
+| `smolagents` | `cortexdb.integrations.smolagents` |
+| `temporal` | `cortexdb.integrations.temporal` |
+| `langchain` | `cortexdb.integrations.langchain` |
+| `ag2` | `cortexdb.integrations.ag2` |
+| `agno` | `cortexdb.integrations.agno` |
+| `groq` | `cortexdb.integrations.groq` |
+| `fireworks` | `cortexdb.integrations.fireworks` |
+| `together` | `cortexdb.integrations.together` |
+| `deepinfra` | `cortexdb.integrations.deepinfra` |
+| `ollama` | `cortexdb.integrations.ollama` |
+| `vllm` | `cortexdb.integrations.vllm` |
+
 ## Constructor
 
 | Parameter | Type | Default | Description |

{cortexdbai-0.4.2 → cortexdbai-0.4.3}/README.md

@@ -121,6 +121,54 @@ with Cortex("http://localhost:3141") as c:
         print(f"API error [{e.status_code}]: {e}")
 ```
 
+## Integrations
+
+Framework and provider adapters ship as optional extras of the same
+`cortexdbai` package — there are no separate `cortexdb-<framework>` packages
+to install. Pick an extra and import from `cortexdb.integrations.<submodule>`:
+
+```bash
+pip install cortexdbai[langgraph]      # or crewai, llamaindex, autogen, …
+```
+
+```python
+from cortexdb.integrations.langgraph import CortexDBCheckpointer, cortexdb_memory_node
+```
+
+Available extras (`pip install cortexdbai[<extra>]`):
+
+| Extra | Import submodule |
+|-------|------------------|
+| `autogen` | `cortexdb.integrations.autogen` |
+| `beeai` | `cortexdb.integrations.beeai` |
+| `camel` | `cortexdb.integrations.camel` |
+| `controlflow` | `cortexdb.integrations.controlflow` |
+| `crewai` | `cortexdb.integrations.crewai` |
+| `dify` | `cortexdb.integrations.dify` |
+| `dspy` | `cortexdb.integrations.dspy` |
+| `flowise` | `cortexdb.integrations.flowise` |
+| `google-adk` | `cortexdb.integrations.google_adk` |
+| `hermes` | `cortexdb.integrations.hermes` |
+| `instructor` | `cortexdb.integrations.instructor` |
+| `langgraph` | `cortexdb.integrations.langgraph` |
+| `letta` | `cortexdb.integrations.letta` |
+| `llamaindex` | `cortexdb.integrations.llamaindex` |
+| `nemo-guardrails` | `cortexdb.integrations.nemo_guardrails` |
+| `openai-agents` | `cortexdb.integrations.openai_agents` |
+| `prefect` | `cortexdb.integrations.prefect` |
+| `pydanticai` | `cortexdb.integrations.pydanticai` |
+| `smolagents` | `cortexdb.integrations.smolagents` |
+| `temporal` | `cortexdb.integrations.temporal` |
+| `langchain` | `cortexdb.integrations.langchain` |
+| `ag2` | `cortexdb.integrations.ag2` |
+| `agno` | `cortexdb.integrations.agno` |
+| `groq` | `cortexdb.integrations.groq` |
+| `fireworks` | `cortexdb.integrations.fireworks` |
+| `together` | `cortexdb.integrations.together` |
+| `deepinfra` | `cortexdb.integrations.deepinfra` |
+| `ollama` | `cortexdb.integrations.ollama` |
+| `vllm` | `cortexdb.integrations.vllm` |
+
 ## Constructor
 
 | Parameter | Type | Default | Description |

{cortexdbai-0.4.2 → cortexdbai-0.4.3}/cortexdb/__init__.py

@@ -1,71 +1,71 @@
-"""CortexDB Python SDK — the long-term memory layer for AI systems.
-
-The SDK is a thin HTTP client over the v1 API surface that cortexdb
-exposes by default on port 3141. The top-level :class:`Cortex` class
-(alias :class:`V1Client`) is what you should reach for.
-
-Quick start::
-
-    from cortexdb import Cortex
-
-    # Local docker run with no auth (CORTEX_API_KEY unset on the server):
-    with Cortex("http://localhost:3141") as c:
-        c.experience("ws:demo", text="Priya at Acme signed for 200 seats.")
-        pack = c.recall("ws:demo", query="How many seats did Acme sign for?")
-        print(pack)
-
-    # Hosted / multi-tenant deployment with PASETO bearer + actor header:
-    with Cortex(
-        "https://api-v1.cortexdb.ai",
-        actor="user:alice",
-        bearer="eyJ...",
-    ) as c:
-        out = c.answer(
-            "org:initech/user:alice",
-            question="What did Alice say about coffee?",
-        )
-
-Versions ≤ 0.2.x exposed a separate ``cortexdb.Cortex`` class targeting
-the legacy ``/v1/remember`` endpoints. That surface was retired in 0.3.0
-because the cortexdb binary's public port now only serves the v1 API;
-the legacy endpoints survive only as an internal bench-compat helper.
-If you need them, pin ``cortexdbai<0.3``.
-"""
-
-from cortexdb.v1 import V1Client, AsyncV1Client
-from cortexdb.v1.exceptions import (
-    V1APIError,
-    V1AuthError,
-    V1ConnectionError,
-    V1Error,
-    V1NotConfiguredError,
-    V1PolicyDeniedError,
-    V1RateLimitError,
-    V1TimeoutError,
-)
-from cortexdb import v1  # the explicit submodule namespace
-
-# Ergonomic top-level aliases. New code can write either form.
-Cortex = V1Client
-AsyncCortex = AsyncV1Client
-
-__version__ = "0.4.2"
-__all__ = [
-    # Clients (preferred top-level names)
-    "Cortex",
-    "AsyncCortex",
-    # Explicit v1 names (identical classes, kept for code that pinned them)
-    "V1Client",
-    "AsyncV1Client",
-    # Submodule
-    "v1",
-    # Exceptions
-    "V1Error",
-    "V1APIError",
-    "V1AuthError",
-    "V1ConnectionError",
-    "V1TimeoutError",
-    "V1RateLimitError",
-    "V1NotConfiguredError",
-    "V1PolicyDeniedError",
-]
+"""CortexDB Python SDK — the long-term memory layer for AI systems.
+
+The SDK is a thin HTTP client over the v1 API surface that cortexdb
+exposes by default on port 3141. The top-level :class:`Cortex` class
+(alias :class:`V1Client`) is what you should reach for.
+
+Quick start::
+
+    from cortexdb import Cortex
+
+    # Local docker run with no auth (CORTEX_API_KEY unset on the server):
+    with Cortex("http://localhost:3141") as c:
+        c.experience("ws:demo", text="Priya at Acme signed for 200 seats.")
+        pack = c.recall("ws:demo", query="How many seats did Acme sign for?")
+        print(pack)
+
+    # Hosted / multi-tenant deployment with PASETO bearer + actor header:
+    with Cortex(
+        "https://api-v1.cortexdb.ai",
+        actor="user:alice",
+        bearer="eyJ...",
+    ) as c:
+        out = c.answer(
+            "org:initech/user:alice",
+            question="What did Alice say about coffee?",
+        )
+
+Versions ≤ 0.2.x exposed a separate ``cortexdb.Cortex`` class targeting
+the legacy ``/v1/remember`` endpoints. That surface was retired in 0.3.0
+because the cortexdb binary's public port now only serves the v1 API;
+the legacy endpoints survive only as an internal bench-compat helper.
+If you need them, pin ``cortexdbai<0.3``.
+"""
+
+from cortexdb.v1 import V1Client, AsyncV1Client
+from cortexdb.v1.exceptions import (
+    V1APIError,
+    V1AuthError,
+    V1ConnectionError,
+    V1Error,
+    V1NotConfiguredError,
+    V1PolicyDeniedError,
+    V1RateLimitError,
+    V1TimeoutError,
+)
+from cortexdb import v1  # the explicit submodule namespace
+
+# Ergonomic top-level aliases. New code can write either form.
+Cortex = V1Client
+AsyncCortex = AsyncV1Client
+
+__version__ = "0.4.3"
+__all__ = [
+    # Clients (preferred top-level names)
+    "Cortex",
+    "AsyncCortex",
+    # Explicit v1 names (identical classes, kept for code that pinned them)
+    "V1Client",
+    "AsyncV1Client",
+    # Submodule
+    "v1",
+    # Exceptions
+    "V1Error",
+    "V1APIError",
+    "V1AuthError",
+    "V1ConnectionError",
+    "V1TimeoutError",
+    "V1RateLimitError",
+    "V1NotConfiguredError",
+    "V1PolicyDeniedError",
+]

{cortexdbai-0.4.2 → cortexdbai-0.4.3}/cortexdb/integrations/ag2/__init__.py

@@ -1,21 +1,21 @@
-"""CortexDB integration for AG2 (successor to AutoGen).
-
-Provides a memory-augmented agent mixin and callable tools that connect
-AG2's multi-agent framework to CortexDB's long-term memory system.
-"""
-
-from .agent import CortexDBAgent
-from .tools import (
-    cortexdb_forget_fn,
-    cortexdb_search_fn,
-    cortexdb_store_fn,
-    register_cortexdb_tools,
-)
-
-__all__ = [
-    "CortexDBAgent",
-    "cortexdb_search_fn",
-    "cortexdb_store_fn",
-    "cortexdb_forget_fn",
-    "register_cortexdb_tools",
-]
+"""CortexDB integration for AG2 (successor to AutoGen).
+
+Provides a memory-augmented agent mixin and callable tools that connect
+AG2's multi-agent framework to CortexDB's long-term memory system.
+"""
+
+from .agent import CortexDBAgent
+from .tools import (
+    cortexdb_forget_fn,
+    cortexdb_search_fn,
+    cortexdb_store_fn,
+    register_cortexdb_tools,
+)
+
+__all__ = [
+    "CortexDBAgent",
+    "cortexdb_search_fn",
+    "cortexdb_store_fn",
+    "cortexdb_forget_fn",
+    "register_cortexdb_tools",
+]

{cortexdbai-0.4.2 → cortexdbai-0.4.3}/cortexdb/integrations/agno/__init__.py

@@ -1,13 +1,13 @@
-"""CortexDB integration for Agno.
-
-Provides a memory backend and agent tools that allow Agno agents
-to use CortexDB as their long-term memory system.
-"""
-
-from .memory import CortexDBMemory
-from .tools import CortexDBTools
-
-__all__ = [
-    "CortexDBMemory",
-    "CortexDBTools",
-]
+"""CortexDB integration for Agno.
+
+Provides a memory backend and agent tools that allow Agno agents
+to use CortexDB as their long-term memory system.
+"""
+
+from .memory import CortexDBMemory
+from .tools import CortexDBTools
+
+__all__ = [
+    "CortexDBMemory",
+    "CortexDBTools",
+]

{cortexdbai-0.4.2 → cortexdbai-0.4.3}/cortexdb/integrations/langchain/__init__.py

@@ -1,29 +1,29 @@
-"""CortexDB integration for LangChain.
-
-Provides chat-message history, retrievers, and tools that connect LangChain
-applications to CortexDB's long-term memory system.
-"""
-
-from .memory import CortexDBChatMessageHistory
-from .retriever import CortexDBRetriever
-from .tools import (
-    CortexDBForgetTool,
-    CortexDBSearchTool,
-    CortexDBStoreTool,
-)
-
-__all__ = [
-    "CortexDBChatMessageHistory",
-    "CortexDBRetriever",
-    "CortexDBForgetTool",
-    "CortexDBSearchTool",
-    "CortexDBStoreTool",
-]
-
-# Legacy BaseMemory backend — only present on langchain-core < 1.0.
-try:
-    from .memory import CortexDBMemory  # noqa: F401
-
-    __all__.append("CortexDBMemory")
-except ImportError:
-    pass
+"""CortexDB integration for LangChain.
+
+Provides chat-message history, retrievers, and tools that connect LangChain
+applications to CortexDB's long-term memory system.
+"""
+
+from .memory import CortexDBChatMessageHistory
+from .retriever import CortexDBRetriever
+from .tools import (
+    CortexDBForgetTool,
+    CortexDBSearchTool,
+    CortexDBStoreTool,
+)
+
+__all__ = [
+    "CortexDBChatMessageHistory",
+    "CortexDBRetriever",
+    "CortexDBForgetTool",
+    "CortexDBSearchTool",
+    "CortexDBStoreTool",
+]
+
+# Legacy BaseMemory backend — only present on langchain-core < 1.0.
+try:
+    from .memory import CortexDBMemory  # noqa: F401
+
+    __all__.append("CortexDBMemory")
+except ImportError:
+    pass

{cortexdbai-0.4.2 → cortexdbai-0.4.3}/cortexdb/integrations/langchain/tools.py

@@ -1,121 +1,121 @@
-"""LangChain tools for interacting with CortexDB.
-
-Provides search, store, and forget tools that allow LangChain agents
-to interact with CortexDB's memory system as part of their tool-use
-capabilities.
-"""
-
-from __future__ import annotations
-
-from typing import Any, Optional, Type
-
-from langchain_core.callbacks import CallbackManagerForToolRun
-from langchain_core.tools import BaseTool
-from pydantic import BaseModel, Field
-
-from cortexdb import Cortex
-
-
-class _SearchInput(BaseModel):
-    query: str = Field(description="The search query to find relevant memories.")
-
-
-class CortexDBSearchTool(BaseTool):
-    """LangChain tool for searching memories in CortexDB."""
-
-    name: str = "cortexdb_search"
-    description: str = (
-        "Search CortexDB for relevant memories and past context. "
-        "Use this when you need to recall information from previous "
-        "conversations or stored knowledge."
-    )
-    args_schema: Type[BaseModel] = _SearchInput
-    scope: str = "user:default"
-
-    _client: Cortex
-
-    def __init__(self, client: Cortex, **kwargs: Any) -> None:
-        super().__init__(**kwargs)
-        self._client = client
-
-    def _run(
-        self,
-        query: str,
-        run_manager: Optional[CallbackManagerForToolRun] = None,
-    ) -> str:
-        result = self._client.recall(self.scope, query=query)
-
-        context = result.get("context_block", "")
-        if not context:
-            return "No relevant memories found."
-
-        return context
-
-
-class _StoreInput(BaseModel):
-    content: str = Field(description="The content to store as a memory.")
-
-
-class CortexDBStoreTool(BaseTool):
-    """LangChain tool for storing memories in CortexDB."""
-
-    name: str = "cortexdb_store"
-    description: str = (
-        "Store information in CortexDB's long-term memory. "
-        "Use this to save important facts, decisions, or context "
-        "that should be remembered for future interactions."
-    )
-    args_schema: Type[BaseModel] = _StoreInput
-    scope: str = "user:default"
-
-    _client: Cortex
-
-    def __init__(self, client: Cortex, **kwargs: Any) -> None:
-        super().__init__(**kwargs)
-        self._client = client
-
-    def _run(
-        self,
-        content: str,
-        run_manager: Optional[CallbackManagerForToolRun] = None,
-    ) -> str:
-        resp = self._client.experience(self.scope, text=content)
-        return f"Memory stored successfully (event_id: {resp.get('event_id')})."
-
-
-class _ForgetInput(BaseModel):
-    query: str = Field(description="Query identifying the memories to forget.")
-    reason: str = Field(description="The reason for forgetting these memories.")
-
-
-class CortexDBForgetTool(BaseTool):
-    """LangChain tool for forgetting memories in CortexDB."""
-
-    name: str = "cortexdb_forget"
-    description: str = (
-        "Forget or remove memories from CortexDB. "
-        "Use this when information should no longer be retained, "
-        "such as for privacy compliance or data correction."
-    )
-    args_schema: Type[BaseModel] = _ForgetInput
-    scope: str = "user:default"
-
-    _client: Cortex
-
-    def __init__(self, client: Cortex, **kwargs: Any) -> None:
-        super().__init__(**kwargs)
-        self._client = client
-
-    def _run(
-        self,
-        query: str,
-        reason: str,
-        run_manager: Optional[CallbackManagerForToolRun] = None,
-    ) -> str:
-        resp = self._client.forget(
-            self.scope,
-            confirm_all=True,
-            cascade="redact_events",
-            reason=reason,
-        )
-        return f"Forget request accepted (audit_id: {resp.get('audit_id')})."
+"""LangChain tools for interacting with CortexDB.
+
+Provides search, store, and forget tools that allow LangChain agents
+to interact with CortexDB's memory system as part of their tool-use
+capabilities.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+from pydantic import BaseModel, Field
+
+from cortexdb import Cortex
+
+
+class _SearchInput(BaseModel):
+    query: str = Field(description="The search query to find relevant memories.")
+
+
+class CortexDBSearchTool(BaseTool):
+    """LangChain tool for searching memories in CortexDB."""
+
+    name: str = "cortexdb_search"
+    description: str = (
+        "Search CortexDB for relevant memories and past context. "
+        "Use this when you need to recall information from previous "
+        "conversations or stored knowledge."
+    )
+    args_schema: Type[BaseModel] = _SearchInput
+    scope: str = "user:default"
+
+    _client: Cortex
+
+    def __init__(self, client: Cortex, **kwargs: Any) -> None:
+        super().__init__(**kwargs)
+        self._client = client
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        result = self._client.recall(self.scope, query=query)
+
+        context = result.get("context_block", "")
+        if not context:
+            return "No relevant memories found."
+
+        return context
+
+
+class _StoreInput(BaseModel):
+    content: str = Field(description="The content to store as a memory.")
+
+
+class CortexDBStoreTool(BaseTool):
+    """LangChain tool for storing memories in CortexDB."""
+
+    name: str = "cortexdb_store"
+    description: str = (
+        "Store information in CortexDB's long-term memory. "
+        "Use this to save important facts, decisions, or context "
+        "that should be remembered for future interactions."
+    )
+    args_schema: Type[BaseModel] = _StoreInput
+    scope: str = "user:default"
+
+    _client: Cortex
+
+    def __init__(self, client: Cortex, **kwargs: Any) -> None:
+        super().__init__(**kwargs)
+        self._client = client
+
+    def _run(
+        self,
+        content: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        resp = self._client.experience(self.scope, text=content)
+        return f"Memory stored successfully (event_id: {resp.get('event_id')})."
+
+
+class _ForgetInput(BaseModel):
+    query: str = Field(description="Query identifying the memories to forget.")
+    reason: str = Field(description="The reason for forgetting these memories.")
+
+
+class CortexDBForgetTool(BaseTool):
+    """LangChain tool for forgetting memories in CortexDB."""
+
+    name: str = "cortexdb_forget"
+    description: str = (
+        "Forget or remove memories from CortexDB. "
+        "Use this when information should no longer be retained, "
+        "such as for privacy compliance or data correction."
+    )
+    args_schema: Type[BaseModel] = _ForgetInput
+    scope: str = "user:default"
+
+    _client: Cortex
+
+    def __init__(self, client: Cortex, **kwargs: Any) -> None:
+        super().__init__(**kwargs)
+        self._client = client
+
+    def _run(
+        self,
+        query: str,
+        reason: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        resp = self._client.forget(
+            self.scope,
+            confirm_all=True,
+            cascade="redact_events",
+            reason=reason,
+        )
+        return f"Forget request accepted (audit_id: {resp.get('audit_id')})."