Merge pull request #211 from scaleapi/release-please--branches--main--changes--next

release: 0.7.0

Author: gabrycina

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.6.7"
+  ".": "0.7.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 34
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp%2Fagentex-sdk-17022011bf153e3ac9e20d23c5dca8a3072b0e735b47bb391b6e35b00348d5a5.yml
-openapi_spec_hash: 0927cdce49a6e6915d6060c2ab43b0d0
-config_hash: 0197f86ba1a4b1b5ce813d0e62138588
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp%2Fagentex-sdk-00b021144c274cce2211ea6c6f90b60b6f88f33a7286a6bf38f4f803ae4c1643.yml
+openapi_spec_hash: d48de43356b6d0edc3f7a44b5980f7a0
+config_hash: 32eb65911c08ac84d117cecdf2759869

CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.7.0 (2025-12-09)
+
+Full Changelog: [v0.6.7...v0.7.0](https://github.com/scaleapi/scale-agentex-python/compare/v0.6.7...v0.7.0)
+
+### Features
+
+* **api:** add messages/paginated endpoint ([3e03aff](https://github.com/scaleapi/scale-agentex-python/commit/3e03aff8490e0556cb05052d385156eda8f28107))
+* **api:** add messages/paginated to stainless config ([2473ded](https://github.com/scaleapi/scale-agentex-python/commit/2473ded39274bcd0a16d7314667fcf7f55e829c2))
+* **api:** api update ([f6eccdf](https://github.com/scaleapi/scale-agentex-python/commit/f6eccdf975eaef9b257ef3f20f087f2f2f9b3665))
+* **api:** api update ([41067fb](https://github.com/scaleapi/scale-agentex-python/commit/41067fb79725787e0ceb20dcf16029998bcbca24))
+* **api:** api update ([cdc9c63](https://github.com/scaleapi/scale-agentex-python/commit/cdc9c636be6f26e84772d1d1ef9d47cddcd9dabc))
+* **api:** api update ([413d9c8](https://github.com/scaleapi/scale-agentex-python/commit/413d9c806d918d7c5da3d0249c0f11d4b9f0894e))
+* **api:** api update ([1b4bf7d](https://github.com/scaleapi/scale-agentex-python/commit/1b4bf7d3a11306a50ec0eb9c20764c585d0e98e4))
+* **api:** manual updates ([131e836](https://github.com/scaleapi/scale-agentex-python/commit/131e836b5bda8248f847b00308b6711a1ee84ee0))
+
+
+### Bug Fixes
+
+* ensure streams are always closed ([7bb9db8](https://github.com/scaleapi/scale-agentex-python/commit/7bb9db851a213d261e585cd2f156046f05cf85db))
+* **types:** allow pyright to infer TypedDict types within SequenceNotStr ([9cfc9d6](https://github.com/scaleapi/scale-agentex-python/commit/9cfc9d66579a11f3eaf248bafbfddb422e878a58))
+
+
+### Chores
+
+* add missing docstrings ([81f1fa9](https://github.com/scaleapi/scale-agentex-python/commit/81f1fa9b3c440d893b8ea8f773ab2592eb333d65))
+* **deps:** mypy 1.18.1 has a regression, pin to 1.17 ([e20aaa4](https://github.com/scaleapi/scale-agentex-python/commit/e20aaa495384f547dd18c8d31496f70b4a37e0dd))
+* **docs:** use environment variables for authentication in code snippets ([a30f6ae](https://github.com/scaleapi/scale-agentex-python/commit/a30f6aebca8de5be72eb7bcf7a3b3ccea28479bc))
+* update lockfile ([a3a2e4f](https://github.com/scaleapi/scale-agentex-python/commit/a3a2e4fbcf6e6e4bcbadab50c6b9236e4514dae2))
+
 ## 0.6.7 (2025-11-19)
 
 Full Changelog: [v0.6.6...v0.6.7](https://github.com/scaleapi/scale-agentex-python/compare/v0.6.6...v0.6.7)

README.md

@@ -113,14 +113,15 @@ pip install agentex-sdk[aiohttp]
 Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
 
 ```python
+import os
 import asyncio
 from agentex import DefaultAioHttpClient
 from agentex import AsyncAgentex
 
 
 async def main() -> None:
     async with AsyncAgentex(
-        api_key="My API Key",
+        api_key=os.environ.get("AGENTEX_SDK_API_KEY"),  # This is the default and can be omitted
         http_client=DefaultAioHttpClient(),
     ) as client:
         tasks = await client.tasks.list()

pyproject.toml

@@ -1,19 +1,20 @@
 [project]
 name = "agentex-sdk"
-version = "0.6.7"
+version = "0.7.0"
 description = "The official Python library for the agentex API"
 dynamic = ["readme"]
 license = "Apache-2.0"
 authors = [
 { name = "Agentex", email = "[email protected]" },
 ]
+
 dependencies = [
     "httpx>=0.27.2,<0.28",
     "pydantic>=2.0.0, <3",
-    "typing-extensions>=4.10, <5",
-    "anyio>=3.5.0, <5",
-    "distro>=1.7.0, <2",
-    "sniffio",
+  "typing-extensions>=4.10, <5",
+  "anyio>=3.5.0, <5",
+  "distro>=1.7.0, <2",
+  "sniffio",
     "typer>=0.16,<0.17",
     "questionary>=2.0.1,<3",
     "rich>=13.9.2,<14",
@@ -48,6 +49,7 @@ dependencies = [
     "claude-agent-sdk>=0.1.0",
     "anthropic>=0.40.0",
 ]
+
 requires-python = ">= 3.12,<4"
 classifiers = [
   "Typing :: Typed",
@@ -82,7 +84,7 @@ managed = true
 # version pins are in requirements-dev.lock
 dev-dependencies = [
     "pyright==1.1.399",
-    "mypy",
+    "mypy==1.17",
     "respx",
     "pytest",
     "pytest-asyncio",

requirements-dev.lock

@@ -12,13 +12,13 @@
 -e file:.
 aiohappyeyeballs==2.6.1
     # via aiohttp
-aiohttp==3.12.8
+aiohttp==3.13.2
     # via agentex-sdk
     # via httpx-aiohttp
     # via litellm
 aiosignal==1.3.2
     # via aiohttp
-annotated-types==0.6.0
+annotated-types==0.7.0
     # via pydantic
 anyio==4.10.0
     # via agentex-sdk
@@ -74,7 +74,7 @@ decorator==5.2.1
 dirty-equals==0.6.0
 distlib==0.3.7
     # via virtualenv
-distro==1.8.0
+distro==1.9.0
     # via agentex-sdk
     # via openai
     # via scale-gp
@@ -90,7 +90,7 @@ fastapi==0.115.14
 filelock==3.12.4
     # via huggingface-hub
     # via virtualenv
-frozenlist==1.6.2
+frozenlist==1.8.0
     # via aiohttp
     # via aiosignal
 fsspec==2025.7.0
@@ -175,11 +175,11 @@ mcp==1.12.4
     # via openai-agents
 mdurl==0.1.2
     # via markdown-it-py
-multidict==6.4.4
+multidict==6.7.0
     # via aiohttp
     # via yarl
-mypy==1.14.1
-mypy-extensions==1.0.0
+mypy==1.17.0
+mypy-extensions==1.1.0
     # via mypy
 nest-asyncio==1.6.0
     # via ipykernel
@@ -204,14 +204,16 @@ packaging==23.2
     # via ipykernel
     # via nox
     # via pytest
+pathspec==0.12.1
+    # via mypy
 parso==0.8.4
     # via jedi
 pexpect==4.9.0
     # via ipython
 platformdirs==3.11.0
     # via jupyter-core
     # via virtualenv
-pluggy==1.5.0
+pluggy==1.6.0
     # via pytest
 prompt-toolkit==3.0.51
     # via ipython
@@ -325,7 +327,7 @@ shellingham==1.5.4
 six==1.16.0
     # via kubernetes
     # via python-dateutil
-sniffio==1.3.0
+sniffio==1.3.1
     # via agentex-sdk
     # via anyio
     # via httpx
@@ -371,6 +373,7 @@ types-urllib3==1.26.25.14
     # via types-requests
 typing-extensions==4.12.2
     # via agentex-sdk
+    # via aiosignal
     # via anyio
     # via fastapi
     # via huggingface-hub
@@ -389,7 +392,8 @@ typing-extensions==4.12.2
     # via temporalio
     # via typer
     # via typing-inspection
-typing-inspection==0.4.1
+    # via virtualenv
+typing-inspection==0.4.2
     # via pydantic
     # via pydantic-settings
 tzdata==2025.2
@@ -414,5 +418,5 @@ wrapt==1.17.3
     # via ddtrace
 yarl==1.20.0
     # via aiohttp
-zipp==3.17.0
+zipp==3.23.0
     # via importlib-metadata

requirements.lock

@@ -12,13 +12,13 @@
 -e file:.
 aiohappyeyeballs==2.6.1
     # via aiohttp
-aiohttp==3.12.8
+aiohttp==3.13.2
     # via agentex-sdk
     # via httpx-aiohttp
     # via litellm
 aiosignal==1.3.2
     # via aiohttp
-annotated-types==0.6.0
+annotated-types==0.7.0
     # via pydantic
 anyio==4.10.0
     # via agentex-sdk
@@ -200,6 +200,9 @@ prompt-toolkit==3.0.51
 propcache==0.3.1
     # via aiohttp
     # via yarl
+pydantic==2.12.5
+    # via agentex-sdk
+pydantic-core==2.41.5
 protobuf==5.29.5
     # via ddtrace
     # via temporalio
@@ -214,18 +217,6 @@ pyasn1==0.6.1
     # via rsa
 pyasn1-modules==0.4.2
     # via google-auth
-pydantic==2.11.9
-    # via agentex-sdk
-    # via fastapi
-    # via litellm
-    # via mcp
-    # via openai
-    # via openai-agents
-    # via pydantic-settings
-    # via python-on-whales
-    # via scale-gp
-    # via scale-gp-beta
-pydantic-core==2.33.2
     # via pydantic
 pydantic-settings==2.10.1
     # via mcp
@@ -299,7 +290,7 @@ six==1.17.0
     # via python-dateutil
 sniffio==1.3.0
     # via agentex-sdk
-    # via anyio
+typing-extensions==4.15.0
     # via httpx
     # via openai
     # via scale-gp
@@ -340,8 +331,8 @@ types-requests==2.31.0.6
     # via openai-agents
 types-urllib3==1.26.25.14
     # via types-requests
-typing-extensions==4.12.2
     # via agentex-sdk
+    # via aiosignal
     # via anyio
     # via fastapi
     # via huggingface-hub
@@ -358,7 +349,7 @@ typing-extensions==4.12.2
     # via temporalio
     # via typer
     # via typing-inspection
-typing-inspection==0.4.1
+typing-inspection==0.4.2
     # via pydantic
     # via pydantic-settings
 tzdata==2025.2

src/agentex/_streaming.py

@@ -54,11 +54,12 @@ def __stream__(self) -> Iterator[_T]:
         process_data = self._client._process_response_data
         iterator = self._iter_events()
 
-        for sse in iterator:
-            yield process_data(data=sse.json(), cast_to=cast_to, response=response)
-
-        # As we might not fully consume the response stream, we need to close it explicitly
-        response.close()
+        try:
+            for sse in iterator:
+                yield process_data(data=sse.json(), cast_to=cast_to, response=response)
+        finally:
+            # Ensure the response is closed even if the consumer doesn't read all data
+            response.close()
 
     def __enter__(self) -> Self:
         return self
@@ -117,11 +118,12 @@ async def __stream__(self) -> AsyncIterator[_T]:
         process_data = self._client._process_response_data
         iterator = self._iter_events()
 
-        async for sse in iterator:
-            yield process_data(data=sse.json(), cast_to=cast_to, response=response)
-
-        # As we might not fully consume the response stream, we need to close it explicitly
-        await response.aclose()
+        try:
+            async for sse in iterator:
+                yield process_data(data=sse.json(), cast_to=cast_to, response=response)
+        finally:
+            # Ensure the response is closed even if the consumer doesn't read all data
+            await response.aclose()
 
     async def __aenter__(self) -> Self:
         return self

src/agentex/_types.py

@@ -243,6 +243,9 @@ class HttpxSendArgs(TypedDict, total=False):
 if TYPE_CHECKING:
     # This works because str.__contains__ does not accept object (either in typeshed or at runtime)
     # https://github.com/hauntsaninja/useful_types/blob/5e9710f3875107d068e7679fd7fec9cfab0eff3b/useful_types/__init__.py#L285
+    #
+    # Note: index() and count() methods are intentionally omitted to allow pyright to properly
+    # infer TypedDict types when dict literals are used in lists assigned to SequenceNotStr.
     class SequenceNotStr(Protocol[_T_co]):
         @overload
         def __getitem__(self, index: SupportsIndex, /) -> _T_co: ...
@@ -251,8 +254,6 @@ def __getitem__(self, index: slice, /) -> Sequence[_T_co]: ...
         def __contains__(self, value: object, /) -> bool: ...
         def __len__(self) -> int: ...
         def __iter__(self) -> Iterator[_T_co]: ...
-        def index(self, value: Any, start: int = 0, stop: int = ..., /) -> int: ...
-        def count(self, value: Any, /) -> int: ...
         def __reversed__(self) -> Iterator[_T_co]: ...
 else:
     # just point this to a normal `Sequence` at runtime to avoid having to special case

src/agentex/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "agentex"
-__version__ = "0.6.7"  # x-release-please-version
+__version__ = "0.7.0"  # x-release-please-version