ctxprotocol 0.19.0__tar.gz → 0.19.1__tar.gz

{ctxprotocol-0.19.0 → ctxprotocol-0.19.1}/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.19.1
+
+- Fixed `client.query.start()` returning `400 "Invalid query job request"` when called without explicit `tools`. The request body builder now omits optional fields (notably `tools`) when unset instead of serializing them as JSON `null`; the durable jobs endpoint's Zod schema rejects `null` for optional fields. `client.query.run()` and `client.query.stream()` were not failing (the `/api/v1/query` endpoint tolerates `null`), but are now consistent with the TS SDK and MCP behavior.
+
 ## 0.19.0
 
 - Fixed `client.query.run()`/`client.query.stream()` raising a `ValidationError` on queries that returned a rendered image artifact (e.g. server-rendered chart PNGs). `computedArtifacts` now accepts both `chart` (structured spec + data) and `image` (hosted URL) variants.

{ctxprotocol-0.19.0 → ctxprotocol-0.19.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctxprotocol
-Version: 0.19.0
+Version: 0.19.1
 Summary: Official Python SDK for the Context Protocol - Discover and execute AI tools programmatically
 Project-URL: Homepage, https://ctxprotocol.com
 Project-URL: Documentation, https://docs.ctxprotocol.com

{ctxprotocol-0.19.0 → ctxprotocol-0.19.1}/ctxprotocol/__init__.py

@@ -31,7 +31,7 @@ Example:
 For more information, visit: https://ctxprotocol.com
 """
 
-__version__ = "0.19.0"
+__version__ = "0.19.1"
 
 # Re-export everything from client module
 from ctxprotocol.client import (

{ctxprotocol-0.19.0 → ctxprotocol-0.19.1}/ctxprotocol/client/resources/query.py

@@ -62,8 +62,9 @@ class Query:
     ) -> dict[str, Any]:
         request_body: dict[str, Any] = {
             "query": query,
-            "tools": tools,
         }
+        if tools is not None:
+            request_body["tools"] = tools
         if stream is not None:
             request_body["stream"] = stream
         if resume_from is not None:
@@ -443,9 +444,10 @@ class Query:
         """
         request_body: dict[str, Any] = {
             "query": query,
-            "tools": tools,
             "stream": True,
         }
+        if tools is not None:
+            request_body["tools"] = tools
         if resume_from is not None:
             request_body["resumeFrom"] = (
                 resume_from.model_dump(by_alias=True, exclude_none=True)

{ctxprotocol-0.19.0 → ctxprotocol-0.19.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ctxprotocol"
-version = "0.19.0"
+version = "0.19.1"
 description = "Official Python SDK for the Context Protocol - Discover and execute AI tools programmatically"
 readme = "README.md"
 license = "MIT"

{ctxprotocol-0.19.0 → ctxprotocol-0.19.1}/tests/test_query.py

@@ -420,7 +420,6 @@ class TestQueryRun:
             method="POST",
             json_body={
                 "query": "What are the top whale movements?",
-                "tools": None,
                 "stream": True,
             },
             extra_headers=None,
@@ -480,7 +479,6 @@ class TestQueryRun:
             method="POST",
             json_body={
                 "query": "Analyze whale activity",
-                "tools": None,
                 "stream": True,
                 "agentModelId": "kimi-k2.6-model",
                 "responseShape": "answer_with_evidence",
@@ -1091,7 +1089,6 @@ class TestQueryStream:
             method="POST",
             json_body={
                 "query": "What are whale movements?",
-                "tools": None,
                 "stream": True,
             },
             extra_headers=None,
@@ -1534,7 +1531,6 @@ class TestQueryJobs:
             method="POST",
             json_body={
                 "query": "long query",
-                "tools": None,
                 "stream": False,
                 "responseShape": "evidence_only",
                 "includeDataUrl": True,
@@ -1544,6 +1540,39 @@ class TestQueryJobs:
             },
         )
 
+    async def test_start_omits_null_optional_fields(self) -> None:
+        """Regression: optional fields must be absent (not JSON null) in the job body.
+
+        The /api/v1/query/jobs endpoint validates the body with a Zod schema whose
+        optional fields accept `undefined`/absent but reject `null`. Sending
+        `"tools": null` (as the SDK previously did) made query.start() 400 with
+        "Invalid query job request". Optional fields must be omitted when unset,
+        matching the TS SDK (JSON.stringify drops undefined keys).
+        """
+        client = ContextClient(api_key="ctx_test_key_1234567890abcdef12345678")
+        payload = {
+            "status": "running",
+            "jobId": "11111111-1111-4111-8111-111111111111",
+            "pollingTool": "context_query_status",
+            "message": "running",
+            "progress": None,
+            "querySession": None,
+            "createdAt": "2026-06-14T00:00:00.000Z",
+            "updatedAt": "2026-06-14T00:00:00.000Z",
+        }
+
+        with patch.object(client, "fetch", new_callable=AsyncMock) as mock_fetch:
+            mock_fetch.return_value = payload
+            await client.query.start(query="long query")
+
+        body = mock_fetch.call_args.kwargs["json_body"]
+        # No optional field may serialize to JSON null.
+        assert all(value is not None for value in body.values()), body
+        # tools specifically must be omitted when not supplied (was the 400 trigger).
+        assert "tools" not in body, body
+        # query is always present and non-null.
+        assert body["query"] == "long query"
+
     async def test_get_status_fetches_query_job(self) -> None:
         client = ContextClient(api_key="ctx_test_key_1234567890abcdef12345678")
         payload = {

{ctxprotocol-0.19.0 → ctxprotocol-0.19.1}/uv.lock

@@ -205,7 +205,7 @@ wheels = [
 
 [[package]]
 name = "ctxprotocol"
-version = "0.19.0"
+version = "0.19.1"
 source = { editable = "." }
 dependencies = [
     { name = "cryptography" },