Merge pull request #134 from steel-dev/release-please--branches--main--changes--next

release: 0.19.0

Author: fukouda

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.18.0"
+  ".": "0.19.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 39
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/nen-labs/steel-1adb331648e417385feb2f84de86b9e1a5440ff6f2c9182f14b25337c3ea5588.yml
-openapi_spec_hash: d9fe0172a42c9ebce9f339aefd93bcd5
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/nen-labs/steel-7dfdbffbc4a1b1f44637815cabdc6831ab00a3bbf5157cec73107b5f9d6be8df.yml
+openapi_spec_hash: 8d63332328e084a1f1be8d643ceaa685
 config_hash: dce4dea59023b0a00890fa654fbfffb4

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.19.0 (2026-06-23)
+
+Full Changelog: [v0.18.0...v0.19.0](https://github.com/steel-dev/steel-python/compare/v0.18.0...v0.19.0)
+
+### Features
+
+* **api:** api update ([a894084](https://github.com/steel-dev/steel-python/commit/a894084294c159526a3ef049289c2f611c88b368))
+* **api:** api update ([8d799e8](https://github.com/steel-dev/steel-python/commit/8d799e868c0ae347a7964150f6ee8068e06a9a68))
+
 ## 0.18.0 (2026-06-09)
 
 Full Changelog: [v0.17.0...v0.18.0](https://github.com/steel-dev/steel-python/compare/v0.17.0...v0.18.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "steel-sdk"
-version = "0.18.0"
+version = "0.19.0"
 description = "The official Python library for the steel API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/steel/_version.py

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

src/steel/resources/profiles.py

@@ -54,6 +54,7 @@ def create(
         dimensions: profile_create_params.Dimensions | Omit = omit,
         project_id: str | Omit = omit,
         proxy_url: str | Omit = omit,
+        use_proxy: str | Omit = omit,
         user_agent: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -74,6 +75,9 @@ def create(
 
           proxy_url: The proxy associated with the profile
 
+          use_proxy: JSON-encoded proxy configuration associated with the profile. For fixed IPs,
+              send {"type":"fixed","id":"fixed:<id>"}.
+
           user_agent: The user agent associated with the profile
 
           extra_headers: Send extra headers
@@ -90,6 +94,7 @@ def create(
                 "dimensions": dimensions,
                 "project_id": project_id,
                 "proxy_url": proxy_url,
+                "use_proxy": use_proxy,
                 "user_agent": user_agent,
             },
             [["userDataDir"]],
@@ -118,6 +123,7 @@ def update(
         dimensions: profile_update_params.Dimensions | Omit = omit,
         body_project_id: str | Omit = omit,
         proxy_url: str | Omit = omit,
+        use_proxy: str | Omit = omit,
         user_agent: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -140,6 +146,9 @@ def update(
 
           proxy_url: The proxy associated with the profile
 
+          use_proxy: JSON-encoded proxy configuration associated with the profile. For fixed IPs,
+              send {"type":"fixed","id":"fixed:<id>"}.
+
           user_agent: The user agent associated with the profile
 
           extra_headers: Send extra headers
@@ -158,6 +167,7 @@ def update(
                 "dimensions": dimensions,
                 "body_project_id": body_project_id,
                 "proxy_url": proxy_url,
+                "use_proxy": use_proxy,
                 "user_agent": user_agent,
             },
             [["userDataDir"]],
@@ -288,6 +298,7 @@ async def create(
         dimensions: profile_create_params.Dimensions | Omit = omit,
         project_id: str | Omit = omit,
         proxy_url: str | Omit = omit,
+        use_proxy: str | Omit = omit,
         user_agent: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -308,6 +319,9 @@ async def create(
 
           proxy_url: The proxy associated with the profile
 
+          use_proxy: JSON-encoded proxy configuration associated with the profile. For fixed IPs,
+              send {"type":"fixed","id":"fixed:<id>"}.
+
           user_agent: The user agent associated with the profile
 
           extra_headers: Send extra headers
@@ -324,6 +338,7 @@ async def create(
                 "dimensions": dimensions,
                 "project_id": project_id,
                 "proxy_url": proxy_url,
+                "use_proxy": use_proxy,
                 "user_agent": user_agent,
             },
             [["userDataDir"]],
@@ -352,6 +367,7 @@ async def update(
         dimensions: profile_update_params.Dimensions | Omit = omit,
         body_project_id: str | Omit = omit,
         proxy_url: str | Omit = omit,
+        use_proxy: str | Omit = omit,
         user_agent: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -374,6 +390,9 @@ async def update(
 
           proxy_url: The proxy associated with the profile
 
+          use_proxy: JSON-encoded proxy configuration associated with the profile. For fixed IPs,
+              send {"type":"fixed","id":"fixed:<id>"}.
+
           user_agent: The user agent associated with the profile
 
           extra_headers: Send extra headers
@@ -392,6 +411,7 @@ async def update(
                 "dimensions": dimensions,
                 "body_project_id": body_project_id,
                 "proxy_url": proxy_url,
+                "use_proxy": use_proxy,
                 "user_agent": user_agent,
             },
             [["userDataDir"]],

src/steel/types/profile_create_params.py

@@ -23,6 +23,12 @@ class ProfileCreateParams(TypedDict, total=False):
     proxy_url: Annotated[str, PropertyInfo(alias="proxyUrl")]
     """The proxy associated with the profile"""
 
+    use_proxy: Annotated[str, PropertyInfo(alias="useProxy")]
+    """JSON-encoded proxy configuration associated with the profile.
+
+    For fixed IPs, send {"type":"fixed","id":"fixed:<id>"}.
+    """
+
     user_agent: Annotated[str, PropertyInfo(alias="userAgent")]
     """The user agent associated with the profile"""
 

src/steel/types/profile_update_params.py

@@ -26,6 +26,12 @@ class ProfileUpdateParams(TypedDict, total=False):
     proxy_url: Annotated[str, PropertyInfo(alias="proxyUrl")]
     """The proxy associated with the profile"""
 
+    use_proxy: Annotated[str, PropertyInfo(alias="useProxy")]
+    """JSON-encoded proxy configuration associated with the profile.
+
+    For fixed IPs, send {"type":"fixed","id":"fixed:<id>"}.
+    """
+
     user_agent: Annotated[str, PropertyInfo(alias="userAgent")]
     """The user agent associated with the profile"""
 

src/steel/types/session.py

@@ -179,6 +179,28 @@ class Session(BaseModel):
     ] = None
     """The region where the session was created."""
 
+    release_reason: Optional[
+        Literal[
+            "user_requested",
+            "timeout",
+            "inactivity_timeout",
+            "creation_timeout",
+            "startup_failed",
+            "browser_closed",
+            "browser_crashed",
+        ]
+    ] = FieldInfo(alias="releaseReason", default=None)
+    """Why the session reached a terminal state.
+
+    Null while the session is live, or when the reason is unknown (e.g. sessions
+    created before this was tracked). One of: user_requested (released via the
+    API/SDK), timeout (hard `timeout` elapsed), inactivity_timeout (no activity for
+    the configured window), creation_timeout (never started in time), startup_failed
+    (could not be dispatched), browser_closed (the browser or agent closed itself —
+    not a crash), browser_crashed (the browser crashed or its machine became
+    unresponsive).
+    """
+
     solve_captcha: Optional[bool] = FieldInfo(alias="solveCaptcha", default=None)
     """Indicates if captcha solving is enabled"""
 

src/steel/types/session_create_params.py

@@ -29,6 +29,7 @@
     "UseProxyGeolocation",
     "UseProxyGeolocationGeolocation",
     "UseProxyServer",
+    "UseProxyUnionMember3",
 ]
 
 
@@ -1724,4 +1725,12 @@ class UseProxyServer(TypedDict, total=False):
     """Proxy server URL"""
 
 
-UseProxy: TypeAlias = Union[bool, UseProxyGeolocation, UseProxyServer, object]
+class UseProxyUnionMember3(TypedDict, total=False):
+    type: Required[Literal["fixed"]]
+    """Use Steel fixed IP proxies"""
+
+    id: str
+    """Specific fixed IP identifier. Omit to use any active fixed IP owned by the org."""
+
+
+UseProxy: TypeAlias = Union[bool, UseProxyGeolocation, UseProxyServer, UseProxyUnionMember3, object]