release: 0.34.0

.github/workflows/ci.yml

@@ -61,14 +61,18 @@ jobs:
         run: rye build
 
       - name: Get GitHub OIDC Token
-        if: github.repository == 'stainless-sdks/hyperspell-python'
+        if: |-
+          github.repository == 'stainless-sdks/hyperspell-python' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
         uses: actions/github-script@v8
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
       - name: Upload tarball
-        if: github.repository == 'stainless-sdks/hyperspell-python'
+        if: |-
+          github.repository == 'stainless-sdks/hyperspell-python' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
         env:
           URL: https://pkg.stainless.com/s
           AUTH: ${{ steps.github-oidc.outputs.github_token }}

.github/workflows/publish-pypi.yml

@@ -12,6 +12,9 @@ jobs:
   publish:
     name: publish
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
 
     steps:
       - uses: actions/checkout@v6
@@ -27,5 +30,3 @@ jobs:
       - name: Publish to PyPI
         run: |
           bash ./bin/publish-pypi
-        env:
-          PYPI_TOKEN: ${{ secrets.HYPERSPELL_PYPI_TOKEN || secrets.PYPI_TOKEN }}

.github/workflows/release-doctor.yml

@@ -17,5 +17,3 @@ jobs:
       - name: Check release environment
         run: |
           bash ./bin/check-release-environment
-        env:
-          PYPI_TOKEN: ${{ secrets.HYPERSPELL_PYPI_TOKEN || secrets.PYPI_TOKEN }}

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.33.0"
+  ".": "0.34.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 23
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/hyperspell%2Fhyperspell-36cb6e2474f3fe09749b7a2f24409d48c8db332d624fa7eeb1ee6b6135774133.yml
-openapi_spec_hash: 339a1b55d6b1a55213d16bf336045d0d
-config_hash: 983708fc30c86269c2149a960d0bfec1
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/hyperspell%2Fhyperspell-e94268bb224f0aa46f151c81dba49c8def81c73b48da8a6f31b4f8a60aa5055c.yml
+openapi_spec_hash: 2e2f8148f72a724fbafd05c51b7a62c9
+config_hash: b387daed43fa717ef3ac5811ae06307c

CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.34.0 (2026-03-14)
+
+Full Changelog: [v0.33.0...v0.34.0](https://github.com/hyperspell/python-sdk/compare/v0.33.0...v0.34.0)
+
+### Features
+
+* **api:** api update ([f690c84](https://github.com/hyperspell/python-sdk/commit/f690c841ce28801b1511142026b62d7fcc2706ba))
+* **api:** api update ([784a11e](https://github.com/hyperspell/python-sdk/commit/784a11e826b748f682186bbb39e8f7580cb4d683))
+* **api:** api update ([0f66c9d](https://github.com/hyperspell/python-sdk/commit/0f66c9dfe8e50d22f1a66f6de9b3ee0f1a89ab38))
+* **api:** api update ([b76b873](https://github.com/hyperspell/python-sdk/commit/b76b873e4c01f4c9421cc6e452f216c19374b687))
+* **api:** api update ([b75e2b3](https://github.com/hyperspell/python-sdk/commit/b75e2b3bbb5a871a39d147e4cb0949d7279f3271))
+* **api:** api update ([d330dea](https://github.com/hyperspell/python-sdk/commit/d330deaec6f907f4abee6dd8fc786da018ea72a7))
+* **api:** api update ([e01d911](https://github.com/hyperspell/python-sdk/commit/e01d911cb400b1ee3827332299f054d278f867d4))
+* **api:** manual updates ([48f1e5b](https://github.com/hyperspell/python-sdk/commit/48f1e5b7a76e607c52a3a29c289352e07ca466c6))
+
+
+### Chores
+
+* **api:** python trusted publisher ([3d7a283](https://github.com/hyperspell/python-sdk/commit/3d7a283ebe54b78a23964a17a3167c50da0aeba2))
+* **ci:** skip uploading artifacts on stainless-internal branches ([2361dcb](https://github.com/hyperspell/python-sdk/commit/2361dcb5e76f8aeca00e12a4fcf6b912fca1084a))
+* **internal:** add request options to SSE classes ([6b5c9ad](https://github.com/hyperspell/python-sdk/commit/6b5c9ad8271ecb8887faf8cb678805e6d481459c))
+* **internal:** make `test_proxy_environment_variables` more resilient ([3cc3332](https://github.com/hyperspell/python-sdk/commit/3cc33321d35a6162c6c8540b571d4d3c2b63a022))
+* **internal:** make `test_proxy_environment_variables` more resilient to env ([2c99a7f](https://github.com/hyperspell/python-sdk/commit/2c99a7f619b2581f2bf7bc2bea4519fc1f6c5733))
+* **test:** do not count install time for mock server timeout ([ee29761](https://github.com/hyperspell/python-sdk/commit/ee29761e756adb19eb1f07232abde4e2a1e20d4f))
+* update placeholder string ([5608e0b](https://github.com/hyperspell/python-sdk/commit/5608e0bb6e840cd1b52b8ca79ec6042bc704de82))
+
 ## 0.33.0 (2026-02-20)
 
 Full Changelog: [v0.32.0...v0.33.0](https://github.com/hyperspell/python-sdk/compare/v0.32.0...v0.33.0)

README.md

@@ -134,9 +134,7 @@ client = Hyperspell()
 
 all_memories = []
 # Automatically fetches more pages as needed.
-for memory in client.memories.list(
-    collection="REPLACE_ME",
-):
+for memory in client.memories.list():
     # Do something with memory here
     all_memories.append(memory)
 print(all_memories)
@@ -154,9 +152,7 @@ client = AsyncHyperspell()
 async def main() -> None:
     all_memories = []
     # Iterate through items across all pages, issuing requests as needed.
-    async for memory in client.memories.list(
-        collection="REPLACE_ME",
-    ):
+    async for memory in client.memories.list():
         all_memories.append(memory)
     print(all_memories)
 
@@ -167,9 +163,7 @@ asyncio.run(main())
 Alternatively, you can use the `.has_next_page()`, `.next_page_info()`, or `.get_next_page()` methods for more granular control working with pages:
 
 ```python
-first_page = await client.memories.list(
-    collection="REPLACE_ME",
-)
+first_page = await client.memories.list()
 if first_page.has_next_page():
     print(f"will fetch next page using these details: {first_page.next_page_info()}")
     next_page = await first_page.get_next_page()
@@ -181,9 +175,7 @@ if first_page.has_next_page():
 Or just work directly with the returned data:
 
 ```python
-first_page = await client.memories.list(
-    collection="REPLACE_ME",
-)
+first_page = await client.memories.list()
 
 print(f"next page cursor: {first_page.next_cursor}")  # => "next page cursor: ..."
 for memory in first_page.items:

bin/check-release-environment

@@ -2,10 +2,6 @@
 
 errors=()
 
-if [ -z "${PYPI_TOKEN}" ]; then
-  errors+=("The PYPI_TOKEN secret has not been set. Please set it in either this repository's secrets or your organization secrets.")
-fi
-
 lenErrors=${#errors[@]}
 
 if [[ lenErrors -gt 0 ]]; then

bin/publish-pypi

@@ -3,4 +3,8 @@
 set -eux
 mkdir -p dist
 rye build --clean
-rye publish --yes --token=$PYPI_TOKEN
+if [ -n "${PYPI_TOKEN:-}" ]; then
+  rye publish --yes --token=$PYPI_TOKEN
+else
+  rye publish --yes
+fi

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hyperspell"
-version = "0.33.0"
+version = "0.34.0"
 description = "The official Python library for the hyperspell API"
 dynamic = ["readme"]
 license = "MIT"

scripts/mock

@@ -21,11 +21,22 @@ echo "==> Starting mock server with URL ${URL}"
 
 # Run prism mock on the given spec
 if [ "$1" == "--daemon" ]; then
+  # Pre-install the package so the download doesn't eat into the startup timeout
+  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism --version
+
   npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL" &> .prism.log &
 
-  # Wait for server to come online
+  # Wait for server to come online (max 30s)
   echo -n "Waiting for server"
+  attempts=0
   while ! grep -q "✖  fatal\|Prism is listening" ".prism.log" ; do
+    attempts=$((attempts + 1))
+    if [ "$attempts" -ge 300 ]; then
+      echo
+      echo "Timed out waiting for Prism server to start"
+      cat .prism.log
+      exit 1
+    fi
     echo -n "."
     sleep 0.1
   done

src/hyperspell/_response.py

@@ -152,6 +152,7 @@ def _parse(self, *, to: type[_T] | None = None) -> R | _T:
                         ),
                         response=self.http_response,
                         client=cast(Any, self._client),
+                        options=self._options,
                     ),
                 )
 
@@ -162,6 +163,7 @@ def _parse(self, *, to: type[_T] | None = None) -> R | _T:
                         cast_to=extract_stream_chunk_type(self._stream_cls),
                         response=self.http_response,
                         client=cast(Any, self._client),
+                        options=self._options,
                     ),
                 )
 
@@ -175,6 +177,7 @@ def _parse(self, *, to: type[_T] | None = None) -> R | _T:
                     cast_to=cast_to,
                     response=self.http_response,
                     client=cast(Any, self._client),
+                    options=self._options,
                 ),
             )
 

src/hyperspell/_streaming.py

@@ -4,7 +4,7 @@
 import json
 import inspect
 from types import TracebackType
-from typing import TYPE_CHECKING, Any, Generic, TypeVar, Iterator, AsyncIterator, cast
+from typing import TYPE_CHECKING, Any, Generic, TypeVar, Iterator, Optional, AsyncIterator, cast
 from typing_extensions import Self, Protocol, TypeGuard, override, get_origin, runtime_checkable
 
 import httpx
@@ -13,6 +13,7 @@
 
 if TYPE_CHECKING:
     from ._client import Hyperspell, AsyncHyperspell
+    from ._models import FinalRequestOptions
 
 
 _T = TypeVar("_T")
@@ -22,7 +23,7 @@ class Stream(Generic[_T]):
     """Provides the core interface to iterate over a synchronous stream response."""
 
     response: httpx.Response
-
+    _options: Optional[FinalRequestOptions] = None
     _decoder: SSEBytesDecoder
 
     def __init__(
@@ -31,6 +32,7 @@ def __init__(
         cast_to: type[_T],
         response: httpx.Response,
         client: Hyperspell,
+        options: Optional[FinalRequestOptions] = None,
         timeout: float | None = None,
     ) -> None:
         """Initialize the synchronous stream.
@@ -44,6 +46,7 @@ def __init__(
         self.response = response
         self._cast_to = cast_to
         self._client = client
+        self._options = options
         self._timeout = timeout
         self._decoder = client._make_sse_decoder()
         self._iterator = self.__stream__()
@@ -115,7 +118,7 @@ class AsyncStream(Generic[_T]):
     """Provides the core interface to iterate over an asynchronous stream response."""
 
     response: httpx.Response
-
+    _options: Optional[FinalRequestOptions] = None
     _decoder: SSEDecoder | SSEBytesDecoder
 
     def __init__(
@@ -124,6 +127,7 @@ def __init__(
         cast_to: type[_T],
         response: httpx.Response,
         client: AsyncHyperspell,
+        options: Optional[FinalRequestOptions] = None,
         timeout: float | None = None,
     ) -> None:
         """Initialize the asynchronous stream.
@@ -137,6 +141,7 @@ def __init__(
         self.response = response
         self._cast_to = cast_to
         self._client = client
+        self._options = options
         self._timeout = timeout
         self._decoder = client._make_sse_decoder()
         self._iterator = self.__stream__()

src/hyperspell/_version.py

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