feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 25
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/nen-labs%2Fsteel-f81cef6f87adc0530d9bc21e8d47c95aadef9d5bc3c282837ae0ad41d7f71bac.yml
-openapi_spec_hash: 5b273b225abb80a969ea1485bf399745
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/nen-labs%2Fsteel-66afe0a182177367bf01aad9b294babf46ae37d0b9979556b5a8900b7a27e5e5.yml
+openapi_spec_hash: 6d355b69499416dc264c8a26966f5db6
 config_hash: 42515bf83f1e0e765071038fcf702122

src/steel/resources/sessions/sessions.py

@@ -65,6 +65,7 @@ def with_streaming_response(self) -> SessionsResourceWithStreamingResponse:
     def create(
         self,
         *,
+        advanced_stealth: bool | NotGiven = NOT_GIVEN,
         block_ads: bool | NotGiven = NOT_GIVEN,
         concurrency: int | NotGiven = NOT_GIVEN,
         credentials: session_create_params.Credentials | NotGiven = NOT_GIVEN,
@@ -77,7 +78,7 @@ def create(
         session_id: str | NotGiven = NOT_GIVEN,
         solve_captcha: bool | NotGiven = NOT_GIVEN,
         api_timeout: int | NotGiven = NOT_GIVEN,
-        use_proxy: bool | NotGiven = NOT_GIVEN,
+        use_proxy: session_create_params.UseProxy | NotGiven = NOT_GIVEN,
         user_agent: str | NotGiven = NOT_GIVEN,
         # 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.
@@ -90,6 +91,8 @@ def create(
         Creates a new session with the provided configuration.
 
         Args:
+          advanced_stealth: Enable advanced stealth mode for the browser session. Default is false.
+
           block_ads: Block ads in the browser session. Default is false.
 
           concurrency: Number of sessions to create concurrently (check your plan limit)
@@ -118,8 +121,8 @@ def create(
 
           api_timeout: Session timeout duration in milliseconds. Default is 300000 (5 minutes).
 
-          use_proxy: Enable Steel-provided residential proxy usage for the browser session. Default
-              is false, which routes requests through datacenter proxies.
+          use_proxy: Proxy configuration for the session. Can be a boolean or array of proxy
+              configurations
 
           user_agent: Custom user agent string for the browser session
 
@@ -135,6 +138,7 @@ def create(
             "/v1/sessions",
             body=maybe_transform(
                 {
+                    "advanced_stealth": advanced_stealth,
                     "block_ads": block_ads,
                     "concurrency": concurrency,
                     "credentials": credentials,
@@ -421,6 +425,7 @@ def with_streaming_response(self) -> AsyncSessionsResourceWithStreamingResponse:
     async def create(
         self,
         *,
+        advanced_stealth: bool | NotGiven = NOT_GIVEN,
         block_ads: bool | NotGiven = NOT_GIVEN,
         concurrency: int | NotGiven = NOT_GIVEN,
         credentials: session_create_params.Credentials | NotGiven = NOT_GIVEN,
@@ -433,7 +438,7 @@ async def create(
         session_id: str | NotGiven = NOT_GIVEN,
         solve_captcha: bool | NotGiven = NOT_GIVEN,
         api_timeout: int | NotGiven = NOT_GIVEN,
-        use_proxy: bool | NotGiven = NOT_GIVEN,
+        use_proxy: session_create_params.UseProxy | NotGiven = NOT_GIVEN,
         user_agent: str | NotGiven = NOT_GIVEN,
         # 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.
@@ -446,6 +451,8 @@ async def create(
         Creates a new session with the provided configuration.
 
         Args:
+          advanced_stealth: Enable advanced stealth mode for the browser session. Default is false.
+
           block_ads: Block ads in the browser session. Default is false.
 
           concurrency: Number of sessions to create concurrently (check your plan limit)
@@ -474,8 +481,8 @@ async def create(
 
           api_timeout: Session timeout duration in milliseconds. Default is 300000 (5 minutes).
 
-          use_proxy: Enable Steel-provided residential proxy usage for the browser session. Default
-              is false, which routes requests through datacenter proxies.
+          use_proxy: Proxy configuration for the session. Can be a boolean or array of proxy
+              configurations
 
           user_agent: Custom user agent string for the browser session
 
@@ -491,6 +498,7 @@ async def create(
             "/v1/sessions",
             body=await async_maybe_transform(
                 {
+                    "advanced_stealth": advanced_stealth,
                     "block_ads": block_ads,
                     "concurrency": concurrency,
                     "credentials": credentials,

src/steel/types/session.py

@@ -44,6 +44,9 @@ class Session(BaseModel):
     proxy_bytes_used: int = FieldInfo(alias="proxyBytesUsed")
     """Amount of data transmitted through the proxy"""
 
+    proxy_source: Optional[Literal["steel", "external"]] = FieldInfo(alias="proxySource", default=None)
+    """Source of the proxy used for the session"""
+
     session_viewer_url: str = FieldInfo(alias="sessionViewerUrl")
     """URL to view session details"""
 
@@ -56,12 +59,12 @@ class Session(BaseModel):
     websocket_url: str = FieldInfo(alias="websocketUrl")
     """URL for the session's WebSocket connection"""
 
+    advanced_stealth: Optional[bool] = FieldInfo(alias="advancedStealth", default=None)
+    """Indicates if advanced stealth mode is enabled"""
+
     is_selenium: Optional[bool] = FieldInfo(alias="isSelenium", default=None)
     """Indicates if Selenium is used in the session"""
 
-    proxy: Optional[str] = None
-    """Proxy server used for the session"""
-
     region: Optional[Literal["lax", "ord", "iad", "bom", "scl", "fra", "hkg"]] = None
     """The region where the session was created"""
 

src/steel/types/session_create_params.py

@@ -4,7 +4,7 @@
 
 from typing import Dict, Union, Iterable
 from datetime import datetime
-from typing_extensions import Literal, Required, Annotated, TypedDict
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
 
 from .._utils import PropertyInfo
 
@@ -19,10 +19,17 @@
     "SessionContextIndexedDBData",
     "SessionContextIndexedDBDataRecord",
     "SessionContextIndexedDBDataRecordBlobFile",
+    "UseProxy",
+    "UseProxyGeolocation",
+    "UseProxyGeolocationGeolocation",
+    "UseProxyServer",
 ]
 
 
 class SessionCreateParams(TypedDict, total=False):
+    advanced_stealth: Annotated[bool, PropertyInfo(alias="advancedStealth")]
+    """Enable advanced stealth mode for the browser session. Default is false."""
+
     block_ads: Annotated[bool, PropertyInfo(alias="blockAds")]
     """Block ads in the browser session. Default is false."""
 
@@ -69,10 +76,10 @@ class SessionCreateParams(TypedDict, total=False):
     api_timeout: Annotated[int, PropertyInfo(alias="timeout")]
     """Session timeout duration in milliseconds. Default is 300000 (5 minutes)."""
 
-    use_proxy: Annotated[bool, PropertyInfo(alias="useProxy")]
-    """Enable Steel-provided residential proxy usage for the browser session.
+    use_proxy: Annotated[UseProxy, PropertyInfo(alias="useProxy")]
+    """Proxy configuration for the session.
 
-    Default is false, which routes requests through datacenter proxies.
+    Can be a boolean or array of proxy configurations
     """
 
     user_agent: Annotated[str, PropertyInfo(alias="userAgent")]
@@ -209,3 +216,227 @@ class SessionContext(TypedDict, total=False):
 
     session_storage: Annotated[Dict[str, Dict[str, str]], PropertyInfo(alias="sessionStorage")]
     """Domain-specific sessionStorage items to initialize in the session"""
+
+
+class UseProxyGeolocationGeolocation(TypedDict, total=False):
+    country: Required[
+        Literal[
+            "US",
+            "CA",
+            "MX",
+            "GB",
+            "DE",
+            "FR",
+            "IT",
+            "ES",
+            "PL",
+            "NL",
+            "SE",
+            "NO",
+            "DK",
+            "FI",
+            "CH",
+            "AT",
+            "BE",
+            "IE",
+            "PT",
+            "GR",
+            "CZ",
+            "HU",
+            "RO",
+            "BG",
+            "SK",
+            "SI",
+            "HR",
+            "EE",
+            "LV",
+            "LT",
+            "LU",
+            "MT",
+            "CY",
+            "IS",
+            "LI",
+            "MC",
+            "SM",
+            "VA",
+            "JP",
+            "KR",
+            "CN",
+            "HK",
+            "TW",
+            "SG",
+            "AU",
+            "NZ",
+            "IN",
+            "TH",
+            "MY",
+            "PH",
+            "ID",
+            "VN",
+            "AF",
+            "BD",
+            "BN",
+            "KH",
+            "LA",
+            "LK",
+            "MM",
+            "NP",
+            "PK",
+            "FJ",
+            "PG",
+            "AE",
+            "SA",
+            "IL",
+            "TR",
+            "IR",
+            "IQ",
+            "JO",
+            "KW",
+            "LB",
+            "OM",
+            "QA",
+            "BH",
+            "YE",
+            "SY",
+            "ZA",
+            "EG",
+            "MA",
+            "NG",
+            "KE",
+            "DZ",
+            "AO",
+            "BW",
+            "ET",
+            "GH",
+            "CI",
+            "LY",
+            "MZ",
+            "RW",
+            "SN",
+            "TN",
+            "UG",
+            "ZM",
+            "ZW",
+            "TZ",
+            "MU",
+            "SC",
+            "BR",
+            "AR",
+            "CL",
+            "CO",
+            "PE",
+            "VE",
+            "EC",
+            "UY",
+            "PY",
+            "BO",
+            "CR",
+            "CU",
+            "DO",
+            "GT",
+            "HN",
+            "JM",
+            "NI",
+            "PA",
+            "SV",
+            "TT",
+            "BB",
+            "BZ",
+            "GY",
+            "SR",
+            "RU",
+            "UA",
+            "BY",
+            "KZ",
+            "UZ",
+            "AZ",
+            "GE",
+            "AM",
+            "MD",
+            "MK",
+            "AL",
+            "BA",
+            "RS",
+            "ME",
+            "XK",
+            "MN",
+            "KG",
+            "TJ",
+            "TM",
+        ]
+    ]
+    """Country code (e.g., 'US', 'GB', 'DE') - ISO 3166-1 alpha-2"""
+
+    city: str
+    """City name (e.g., 'NEW_YORK', 'LOS_ANGELES')"""
+
+    state: Literal[
+        "AL",
+        "AK",
+        "AZ",
+        "AR",
+        "CA",
+        "CO",
+        "CT",
+        "DE",
+        "FL",
+        "GA",
+        "HI",
+        "ID",
+        "IL",
+        "IN",
+        "IA",
+        "KS",
+        "KY",
+        "LA",
+        "ME",
+        "MD",
+        "MA",
+        "MI",
+        "MN",
+        "MS",
+        "MO",
+        "MT",
+        "NE",
+        "NV",
+        "NH",
+        "NJ",
+        "NM",
+        "NY",
+        "NC",
+        "ND",
+        "OH",
+        "OK",
+        "OR",
+        "PA",
+        "RI",
+        "SC",
+        "SD",
+        "TN",
+        "TX",
+        "UT",
+        "VT",
+        "VA",
+        "WA",
+        "WV",
+        "WI",
+        "WY",
+        "DC",
+        "PR",
+        "GU",
+        "VI",
+    ]
+    """State code (e.g., 'NY', 'CA') - US states only"""
+
+
+class UseProxyGeolocation(TypedDict, total=False):
+    geolocation: Required[UseProxyGeolocationGeolocation]
+    """Geographic location for the proxy"""
+
+
+class UseProxyServer(TypedDict, total=False):
+    server: Required[str]
+    """Proxy server URL"""
+
+
+UseProxy: TypeAlias = Union[bool, UseProxyGeolocation, UseProxyServer, object]