feat: expose smooth drag mouse movement via public API

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 103
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-bda5e58fa0bbd08761f27a1e0edbc602c44141ac9483bf6c96d52b7f4d10d9a7.yml
-openapi_spec_hash: 10833b36358e8cda023e5bb0abeab0ba
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-e6936890166ce5b11abaccd511a43a8807e2abf96c1f542d4f8d94655ef27d1f.yml
+openapi_spec_hash: 0146ecaea96d8136ef4a35cd04aacf22
 config_hash: cff4d43372b6fa66b64e2d4150f6aa76

src/kernel/resources/browsers/computer.py

@@ -213,7 +213,9 @@ def drag_mouse(
         path: Iterable[Iterable[int]],
         button: Literal["left", "middle", "right"] | Omit = omit,
         delay: int | Omit = omit,
+        duration_ms: int | Omit = omit,
         hold_keys: SequenceNotStr[str] | Omit = omit,
+        smooth: bool | Omit = omit,
         step_delay_ms: int | Omit = omit,
         steps_per_segment: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -234,8 +236,14 @@ def drag_mouse(
 
           delay: Delay in milliseconds between button down and starting to move along the path.
 
+          duration_ms: Target total duration in milliseconds for the entire drag movement when
+              smooth=true. Omit for automatic timing based on total path length.
+
           hold_keys: Modifier keys to hold during the drag
 
+          smooth: Use human-like Bezier curves between path waypoints instead of linear
+              interpolation. When true, steps_per_segment and step_delay_ms are ignored.
+
           step_delay_ms: Delay in milliseconds between relative steps while dragging (not the initial
               delay).
 
@@ -259,7 +267,9 @@ def drag_mouse(
                     "path": path,
                     "button": button,
                     "delay": delay,
+                    "duration_ms": duration_ms,
                     "hold_keys": hold_keys,
+                    "smooth": smooth,
                     "step_delay_ms": step_delay_ms,
                     "steps_per_segment": steps_per_segment,
                 },
@@ -804,7 +814,9 @@ async def drag_mouse(
         path: Iterable[Iterable[int]],
         button: Literal["left", "middle", "right"] | Omit = omit,
         delay: int | Omit = omit,
+        duration_ms: int | Omit = omit,
         hold_keys: SequenceNotStr[str] | Omit = omit,
+        smooth: bool | Omit = omit,
         step_delay_ms: int | Omit = omit,
         steps_per_segment: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -825,8 +837,14 @@ async def drag_mouse(
 
           delay: Delay in milliseconds between button down and starting to move along the path.
 
+          duration_ms: Target total duration in milliseconds for the entire drag movement when
+              smooth=true. Omit for automatic timing based on total path length.
+
           hold_keys: Modifier keys to hold during the drag
 
+          smooth: Use human-like Bezier curves between path waypoints instead of linear
+              interpolation. When true, steps_per_segment and step_delay_ms are ignored.
+
           step_delay_ms: Delay in milliseconds between relative steps while dragging (not the initial
               delay).
 
@@ -850,7 +868,9 @@ async def drag_mouse(
                     "path": path,
                     "button": button,
                     "delay": delay,
+                    "duration_ms": duration_ms,
                     "hold_keys": hold_keys,
+                    "smooth": smooth,
                     "step_delay_ms": step_delay_ms,
                     "steps_per_segment": steps_per_segment,
                 },

src/kernel/types/browsers/computer_batch_params.py

@@ -59,9 +59,21 @@ class ActionDragMouse(TypedDict, total=False):
     delay: int
     """Delay in milliseconds between button down and starting to move along the path."""
 
+    duration_ms: int
+    """
+    Target total duration in milliseconds for the entire drag movement when
+    smooth=true. Omit for automatic timing based on total path length.
+    """
+
     hold_keys: SequenceNotStr[str]
     """Modifier keys to hold during the drag"""
 
+    smooth: bool
+    """
+    Use human-like Bezier curves between path waypoints instead of linear
+    interpolation. When true, steps_per_segment and step_delay_ms are ignored.
+    """
+
     step_delay_ms: int
     """
     Delay in milliseconds between relative steps while dragging (not the initial

src/kernel/types/browsers/computer_drag_mouse_params.py

@@ -23,9 +23,21 @@ class ComputerDragMouseParams(TypedDict, total=False):
     delay: int
     """Delay in milliseconds between button down and starting to move along the path."""
 
+    duration_ms: int
+    """
+    Target total duration in milliseconds for the entire drag movement when
+    smooth=true. Omit for automatic timing based on total path length.
+    """
+
     hold_keys: SequenceNotStr[str]
     """Modifier keys to hold during the drag"""
 
+    smooth: bool
+    """
+    Use human-like Bezier curves between path waypoints instead of linear
+    interpolation. When true, steps_per_segment and step_delay_ms are ignored.
+    """
+
     step_delay_ms: int
     """
     Delay in milliseconds between relative steps while dragging (not the initial

tests/api_resources/browsers/test_computer.py

@@ -224,7 +224,9 @@ def test_method_drag_mouse_with_all_params(self, client: Kernel) -> None:
             path=[[0, 0], [0, 0]],
             button="left",
             delay=0,
+            duration_ms=50,
             hold_keys=["string"],
+            smooth=True,
             step_delay_ms=0,
             steps_per_segment=1,
         )
@@ -887,7 +889,9 @@ async def test_method_drag_mouse_with_all_params(self, async_client: AsyncKernel
             path=[[0, 0], [0, 0]],
             button="left",
             delay=0,
+            duration_ms=50,
             hold_keys=["string"],
+            smooth=True,
             step_delay_ms=0,
             steps_per_segment=1,
         )