ctxprotocol 0.18.0__tar.gz → 0.19.0__tar.gz

ctxprotocol-0.19.0/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## 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.
+- Added `QueryImageArtifact` (`kind: "image"` with `url`, `alt`, `title`, `content_hash`, `bytes`, `width`, `height`) and made `QueryComputedArtifact` a discriminated union over `kind`.
+- Exported `QueryImageArtifact` from the client entry point alongside `QueryChartArtifact`.
+
+## 0.18.0
+
+- Added durable async Query jobs with `client.query.start()`, `client.query.get_status()`, and `client.query.poll()`.
+- Exported `QueryJobStartResult`, `QueryJobStatusResult`, and `QueryJobStatus` from the root and client entry points.
+- Kept existing `client.query.run()` and `client.query.stream()` behavior unchanged.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctxprotocol
-Version: 0.18.0
+Version: 0.19.0
 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.18.0 → ctxprotocol-0.19.0}/ctxprotocol/__init__.py

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

{ctxprotocol-0.18.0 → ctxprotocol-0.19.0}/ctxprotocol/client/__init__.py

@@ -44,6 +44,7 @@ from ctxprotocol.client.types import (
     QueryChartType,
     QueryChartValueFormat,
     QueryComputedArtifact,
+    QueryImageArtifact,
     QueryCost,
     QueryCompletenessRepairEvent,
     QueryDeveloperTrace,
@@ -133,6 +134,7 @@ __all__ = [
     "QueryChartType",
     "QueryChartValueFormat",
     "QueryComputedArtifact",
+    "QueryImageArtifact",
     "QueryStreamToolStatusEvent",
     "QueryStreamTextDeltaEvent",
     "QueryStreamDeveloperTraceEvent",

{ctxprotocol-0.18.0 → ctxprotocol-0.19.0}/ctxprotocol/client/types.py

@@ -6,7 +6,7 @@ This module contains all Pydantic models and type definitions used by the client
 
 from __future__ import annotations
 
-from typing import Any, Literal, Union
+from typing import Annotated, Any, Literal, Union
 
 from pydantic import BaseModel, Field
 
@@ -929,7 +929,31 @@ class QueryChartArtifact(BaseModel):
     title: str | None = None
 
 
-QueryComputedArtifact = QueryChartArtifact
+class QueryImageArtifact(BaseModel):
+    """Rendered image artifact (e.g. a server-rendered chart PNG).
+
+    Emitted by the code interpreter alongside or instead of the structured
+    ``chart`` spec. ``url`` points at a hosted, already-rendered image so
+    consumers that cannot render a chart spec (image-first surfaces such as
+    social posting) can attach it directly.
+    """
+
+    kind: Literal["image"]
+    url: str
+    alt: str | None = None
+    title: str | None = None
+    content_hash: str | None = Field(default=None, alias="contentHash")
+    bytes: int | None = None
+    width: int | None = None
+    height: int | None = None
+
+    model_config = {"populate_by_name": True}
+
+
+QueryComputedArtifact = Annotated[
+    Union[QueryChartArtifact, QueryImageArtifact],
+    Field(discriminator="kind"),
+]
 
 
 class QueryToolCallFailureSample(BaseModel):

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

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

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

@@ -897,6 +897,41 @@ class TestQueryRun:
         assert mixed_axis.spec.series[1].y_axis == "right"
         assert mixed_axis.spec.series[1].satisfies == "volume"
 
+    async def test_parses_rendered_image_artifact(self) -> None:
+        """Rendered image artifacts (kind: image) deserialize without error."""
+        client = ContextClient(api_key="ctx_test_key_1234567890abcdef12345678")
+        response = {
+            **MOCK_SUCCESS_RESPONSE,
+            "computedArtifacts": [
+                {
+                    "kind": "image",
+                    "url": "https://blob.example.com/charts/abc123.png",
+                    "alt": "Sector ETF YTD normalized performance chart",
+                    "title": "Sector ETF YTD Performance",
+                    "contentHash": "abc123",
+                    "bytes": 320749,
+                    "width": 1926,
+                    "height": 1030,
+                },
+            ],
+        }
+        with patch.object(
+            client, "fetch_stream", new_callable=AsyncMock
+        ) as mock_stream:
+            mock_stream.return_value = _make_done_stream_response(response)
+            result = await client.query.run("Render a chart image")
+
+        assert result.computed_artifacts is not None
+        assert len(result.computed_artifacts) == 1
+        image = result.computed_artifacts[0]
+        assert image.kind == "image"
+        assert image.url == "https://blob.example.com/charts/abc123.png"
+        assert image.title == "Sector ETF YTD Performance"
+        assert image.content_hash == "abc123"
+        assert image.bytes == 320749
+        assert image.width == 1926
+        assert image.height == 1030
+
     async def test_parses_shared_ungrounded_capability_miss_fixture(self) -> None:
         """Ungrounded runtime outcomes deserialize as capability_miss."""
         client = ContextClient(api_key="ctx_test_key_1234567890abcdef12345678")

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

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

ctxprotocol-0.18.0/CHANGELOG.md

@@ -1,7 +0,0 @@
-# Changelog
-
-## 0.18.0
-
-- Added durable async Query jobs with `client.query.start()`, `client.query.get_status()`, and `client.query.poll()`.
-- Exported `QueryJobStartResult`, `QueryJobStatusResult`, and `QueryJobStatus` from the root and client entry points.
-- Kept existing `client.query.run()` and `client.query.stream()` behavior unchanged.