cortexdbai 0.5.0__tar.gz → 0.7.0__tar.gz

{cortexdbai-0.5.0 → cortexdbai-0.7.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*/

{cortexdbai-0.5.0 → cortexdbai-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdbai
-Version: 0.5.0
+Version: 0.7.0
 Summary: The Long-Term Memory Layer for AI Systems
 Project-URL: Homepage, https://cortexdb.ai
 Project-URL: Documentation, https://docs.cortexdb.ai
@@ -173,6 +173,12 @@ print(c.recall(c.actor, query="what did I say?")["context_block"])
 c.experience("ws:demo", text="Deployed payments-service v3.1 to prod.")
 c.experience("ws:demo", text="Rolled back auth-gateway.", wait="indexed")
 
+# Large content: wait="captured" returns at the durable accept point (~10ms);
+# poll write_status to see indexing progress. After a client timeout,
+# found=False or status="failed" both mean re-sending is safe (re-processes).
+c.experience("ws:demo", text=big_transcript, idempotency_key="k1", wait="captured")
+c.write_status(idempotency_key="k1")  # {found, status, stages_completed, ...}
+
 # Recall — returns a StratifiedPack { context_block, layers, provenance }.
 pack = c.recall("ws:demo", query="recent deploys", view="holistic")
 

{cortexdbai-0.5.0 → cortexdbai-0.7.0}/README.md

@@ -60,6 +60,12 @@ print(c.recall(c.actor, query="what did I say?")["context_block"])
 c.experience("ws:demo", text="Deployed payments-service v3.1 to prod.")
 c.experience("ws:demo", text="Rolled back auth-gateway.", wait="indexed")
 
+# Large content: wait="captured" returns at the durable accept point (~10ms);
+# poll write_status to see indexing progress. After a client timeout,
+# found=False or status="failed" both mean re-sending is safe (re-processes).
+c.experience("ws:demo", text=big_transcript, idempotency_key="k1", wait="captured")
+c.write_status(idempotency_key="k1")  # {found, status, stages_completed, ...}
+
 # Recall — returns a StratifiedPack { context_block, layers, provenance }.
 pack = c.recall("ws:demo", query="recent deploys", view="holistic")
 

{cortexdbai-0.5.0 → cortexdbai-0.7.0}/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.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",
-]
+"""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.7.0"
+__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.5.0 → cortexdbai-0.7.0}/cortexdb/v1/client.py

@@ -384,6 +384,28 @@ class V1Client:
         path = "/v1/experience" + (f"?wait={wait}" if wait else "")
         return self._post(path, env)
 
+    def write_status(
+        self,
+        *,
+        idempotency_key: Optional[str] = None,
+        event_id: Optional[str] = None,
+    ) -> dict:
+        """``GET /v1/experience/status`` — did a write land, and how far has
+        it progressed? The safe resume path after a client-side timeout, and
+        the poll target after ``experience(..., wait="captured")``.
+
+        Returns ``{found, event_id, status, stages_completed, note}`` where
+        ``status`` is ``"captured"`` / ``"indexed"`` / ``"failed"``.
+        ``found: False`` (or ``status: "failed"``) means re-sending the same
+        write with the same ``idempotency_key`` is safe — it re-processes
+        rather than replaying."""
+        params: dict = {}
+        if idempotency_key is not None:
+            params["idempotency_key"] = idempotency_key
+        if event_id is not None:
+            params["event_id"] = event_id
+        return self._get("/v1/experience/status", params=params)
+
     def upload_blob(
         self, data: bytes, content_type: str = "application/octet-stream"
     ) -> dict:
@@ -478,6 +500,8 @@ class V1Client:
         question_date: Optional[str] = None,
         answer_model: Optional[str] = None,
         answer_max_tokens: Optional[int] = None,
+        answer_instructions: Optional[str] = None,
+        cite_sources: bool = False,
         use_pack_id: Optional[str] = None,
         temporal: Optional[Mapping[str, Any]] = None,
         diagnostics: str = "none",
@@ -488,6 +512,12 @@ class V1Client:
         defaults to ``"none"`` so free-tier tokens don't hit the
         ``diagnostics.read`` gate. Pass ``"summary"`` or ``"full"`` when
         you hold the elevated capability.
+
+        ``answer_instructions`` is a prompt addendum appended to the server's
+        system prompt — control style, verbosity, and output format ("be
+        terse", "answer as markdown with curl examples", "respond in JSON").
+        It never affects retrieval. Max 4000 chars. Pair with
+        ``question_type="docs-assistant"`` for documentation-support answers.
         """
         body: dict = {
             "scope": scope,
@@ -503,6 +533,10 @@ class V1Client:
             body["answer_model"] = answer_model
         if answer_max_tokens is not None:
             body["answer_max_tokens"] = answer_max_tokens
+        if answer_instructions:
+            body["answer_instructions"] = answer_instructions
+        if cite_sources:
+            body["cite_sources"] = True
         if use_pack_id:
             body["use_pack_id"] = use_pack_id
         if temporal:
@@ -998,11 +1032,14 @@ class AsyncV1Client:
         *,
         question_type: Optional[str] = None,
         question_date: Optional[str] = None,
+        answer_instructions: Optional[str] = None,
+        cite_sources: bool = False,
         view: str = "holistic",
         diagnostics: str = "none",
     ) -> dict:
         """``POST /v1/answer``. ``diagnostics`` defaults to ``"none"`` so
-        free-tier tokens succeed (audit FRI-1)."""
+        free-tier tokens succeed (audit FRI-1). ``answer_instructions``:
+        see :meth:`V1Client.answer`."""
         body: dict = {
             "scope": scope,
             "view": view,
@@ -1013,6 +1050,10 @@ class AsyncV1Client:
             body["question_type"] = question_type
         if question_date:
             body["question_date"] = question_date
+        if answer_instructions:
+            body["answer_instructions"] = answer_instructions
+        if cite_sources:
+            body["cite_sources"] = True
         return await self._post("/v1/answer", body)
 
     # ── conflicts + bi-temporal claims ────────────────────────────────

{cortexdbai-0.5.0 → cortexdbai-0.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cortexdbai"
-version = "0.5.0"
+version = "0.7.0"
 description = "The Long-Term Memory Layer for AI Systems"
 readme = "README.md"
 license = "Apache-2.0"