cortexdbai 0.6.0__tar.gz → 0.7.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdbai
-Version: 0.6.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

{cortexdbai-0.6.0 → cortexdbai-0.7.0}/cortexdb/__init__.py

@@ -49,7 +49,7 @@ from cortexdb import v1  # the explicit submodule namespace
 Cortex = V1Client
 AsyncCortex = AsyncV1Client
 
-__version__ = "0.6.0"
+__version__ = "0.7.0"
 __all__ = [
     # Clients (preferred top-level names)
     "Cortex",

{cortexdbai-0.6.0 → cortexdbai-0.7.0}/cortexdb/v1/client.py

@@ -500,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",
@@ -510,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,
@@ -525,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:
@@ -1020,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,
@@ -1035,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.6.0 → cortexdbai-0.7.0}/pyproject.toml

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