feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 39
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/nen-labs/steel-a8cf8e70c6c352d4f7845225a991e29a67d1f2ec9b7bcd6e540fa27791733aa5.yml
-openapi_spec_hash: c8ea136263d712103781c0afd3b8ad3a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/nen-labs/steel-ece6adbbe9a1ff86c2b685f07b970163a96a98776c969a2f3fb10381ffe4f89d.yml
+openapi_spec_hash: 493c249a347997a9f6e599d0bae330c8
 config_hash: dce4dea59023b0a00890fa654fbfffb4

src/steel/resources/sessions/sessions.py

@@ -344,7 +344,7 @@ def computer(
         session_id: str,
         *,
         action: Literal["click_mouse"],
-        button: Literal["left", "right", "middle", "back", "forward"],
+        button: Literal["left", "right", "middle", "back", "forward"] | Omit = omit,
         click_type: Literal["down", "up", "click"] | Omit = omit,
         coordinates: Iterable[float] | Omit = omit,
         hold_keys: SequenceNotStr[str] | Omit = omit,
@@ -361,7 +361,7 @@ def computer(
         Execute computer actions like mouse movements, clicks, keyboard input, and more
 
         Args:
-          button: Mouse button to click
+          button: Mouse button to click. Defaults to 'left'
 
           click_type: Type of click (down, up, or click). Defaults to 'click'
 
@@ -622,9 +622,8 @@ def computer(
 
     @required_args(
         ["action", "coordinates"],
-        ["action", "button"],
-        ["action", "path"],
         ["action"],
+        ["action", "path"],
         ["action", "keys"],
         ["action", "text"],
         ["action", "duration"],
@@ -1157,7 +1156,7 @@ async def computer(
         session_id: str,
         *,
         action: Literal["click_mouse"],
-        button: Literal["left", "right", "middle", "back", "forward"],
+        button: Literal["left", "right", "middle", "back", "forward"] | Omit = omit,
         click_type: Literal["down", "up", "click"] | Omit = omit,
         coordinates: Iterable[float] | Omit = omit,
         hold_keys: SequenceNotStr[str] | Omit = omit,
@@ -1174,7 +1173,7 @@ async def computer(
         Execute computer actions like mouse movements, clicks, keyboard input, and more
 
         Args:
-          button: Mouse button to click
+          button: Mouse button to click. Defaults to 'left'
 
           click_type: Type of click (down, up, or click). Defaults to 'click'
 
@@ -1435,9 +1434,8 @@ async def computer(
 
     @required_args(
         ["action", "coordinates"],
-        ["action", "button"],
-        ["action", "path"],
         ["action"],
+        ["action", "path"],
         ["action", "keys"],
         ["action", "text"],
         ["action", "duration"],

src/steel/types/session.py

@@ -154,9 +154,27 @@ class Session(BaseModel):
     """The ID of the profile associated with the session"""
 
     region: Optional[
-        Literal["us-east", "us-west", "us-central", "eu-west", "eu-central", "ap-northeast", "ap-southeast", "sa-east"]
+        Literal[
+            "lax",
+            "ord",
+            "iad",
+            "scl",
+            "fra",
+            "nrt",
+            "us-east",
+            "us-west",
+            "us-central",
+            "eu-west",
+            "eu-central",
+            "ap-northeast",
+            "ap-southeast",
+            "sa-east",
+        ]
     ] = None
-    """The region where the session was created"""
+    """The region where the session was created.
+
+    Fly sessions return airport codes; multi-provider sessions return meta-regions.
+    """
 
     solve_captcha: Optional[bool] = FieldInfo(alias="solveCaptcha", default=None)
     """Indicates if captcha solving is enabled"""

src/steel/types/session_computer_params.py

@@ -37,8 +37,8 @@ class Variant0(TypedDict, total=False):
 class Variant1(TypedDict, total=False):
     action: Required[Literal["click_mouse"]]
 
-    button: Required[Literal["left", "right", "middle", "back", "forward"]]
-    """Mouse button to click"""
+    button: Literal["left", "right", "middle", "back", "forward"]
+    """Mouse button to click. Defaults to 'left'"""
 
     click_type: Literal["down", "up", "click"]
     """Type of click (down, up, or click). Defaults to 'click'"""

src/steel/types/sessionslist.py

@@ -162,9 +162,27 @@ class Session(BaseModel):
     """The ID of the profile associated with the session"""
 
     region: Optional[
-        Literal["us-east", "us-west", "us-central", "eu-west", "eu-central", "ap-northeast", "ap-southeast", "sa-east"]
+        Literal[
+            "lax",
+            "ord",
+            "iad",
+            "scl",
+            "fra",
+            "nrt",
+            "us-east",
+            "us-west",
+            "us-central",
+            "eu-west",
+            "eu-central",
+            "ap-northeast",
+            "ap-southeast",
+            "sa-east",
+        ]
     ] = None
-    """The region where the session was created"""
+    """The region where the session was created.
+
+    Fly sessions return airport codes; multi-provider sessions return meta-regions.
+    """
 
     solve_captcha: Optional[bool] = FieldInfo(alias="solveCaptcha", default=None)
     """Indicates if captcha solving is enabled"""

tests/api_resources/test_sessions.py

@@ -287,7 +287,6 @@ def test_method_computer_overload_2(self, client: Steel) -> None:
         session = client.sessions.computer(
             session_id="sessionId",
             action="click_mouse",
-            button="left",
         )
         assert_matches_type(SessionComputerResponse, session, path=["response"])
 
@@ -310,7 +309,6 @@ def test_raw_response_computer_overload_2(self, client: Steel) -> None:
         response = client.sessions.with_raw_response.computer(
             session_id="sessionId",
             action="click_mouse",
-            button="left",
         )
 
         assert response.is_closed is True
@@ -323,7 +321,6 @@ def test_streaming_response_computer_overload_2(self, client: Steel) -> None:
         with client.sessions.with_streaming_response.computer(
             session_id="sessionId",
             action="click_mouse",
-            button="left",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -339,7 +336,6 @@ def test_path_params_computer_overload_2(self, client: Steel) -> None:
             client.sessions.with_raw_response.computer(
                 session_id="",
                 action="click_mouse",
-                button="left",
             )
 
     @parametrize
@@ -1160,7 +1156,6 @@ async def test_method_computer_overload_2(self, async_client: AsyncSteel) -> Non
         session = await async_client.sessions.computer(
             session_id="sessionId",
             action="click_mouse",
-            button="left",
         )
         assert_matches_type(SessionComputerResponse, session, path=["response"])
 
@@ -1183,7 +1178,6 @@ async def test_raw_response_computer_overload_2(self, async_client: AsyncSteel)
         response = await async_client.sessions.with_raw_response.computer(
             session_id="sessionId",
             action="click_mouse",
-            button="left",
         )
 
         assert response.is_closed is True
@@ -1196,7 +1190,6 @@ async def test_streaming_response_computer_overload_2(self, async_client: AsyncS
         async with async_client.sessions.with_streaming_response.computer(
             session_id="sessionId",
             action="click_mouse",
-            button="left",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -1212,7 +1205,6 @@ async def test_path_params_computer_overload_2(self, async_client: AsyncSteel) -
             await async_client.sessions.with_raw_response.computer(
                 session_id="",
                 action="click_mouse",
-                button="left",
             )
 
     @parametrize