Merge remote-tracking branch 'origin/main' into stlc/promote-next

Author: kernel-internal[bot]

.stats.yml

@@ -1 +1 @@
-configured_endpoints: 164
+configured_endpoints: 165

api.md

@@ -124,6 +124,11 @@ from kernel.types import (
     BrowserProxy,
     BrowserProxyConfig,
     BrowserProxyMode,
+    BrowserReplContent,
+    BrowserReplImageContent,
+    BrowserReplRequest,
+    BrowserReplResult,
+    BrowserReplTextContent,
     BrowserUsage,
     Profile,
     Tags,
@@ -145,6 +150,7 @@ Methods:
 - <code title="post /browsers/{id_or_name}/curl">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">curl</a>(id_or_name, \*\*<a href="src/kernel/types/browser_curl_params.py">params</a>) -> <a href="./src/kernel/types/browser_curl_response.py">BrowserCurlResponse</a></code>
 - <code title="delete /browsers/{id_or_name}">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">delete_by_id</a>(id_or_name) -> None</code>
 - <code title="post /browsers/{id_or_name}/extensions">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">load_extensions</a>(id_or_name, \*\*<a href="src/kernel/types/browser_load_extensions_params.py">params</a>) -> None</code>
+- <code title="post /browsers/{id_or_name}/repl">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">repl</a>(id_or_name, \*\*<a href="src/kernel/types/browser_repl_params.py">params</a>) -> <a href="./src/kernel/types/browser_repl_result.py">BrowserReplResult</a></code>
 
 ## Telemetry
 

src/kernel/_client.py

@@ -247,7 +247,6 @@ def config_registry(self) -> ConfigRegistryResource:
 
     @cached_property
     def browsers(self) -> BrowsersResource:
-        """Create and manage browser sessions."""
         from .resources.browsers import BrowsersResource
 
         return BrowsersResource(self)
@@ -652,7 +651,6 @@ def config_registry(self) -> AsyncConfigRegistryResource:
 
     @cached_property
     def browsers(self) -> AsyncBrowsersResource:
-        """Create and manage browser sessions."""
         from .resources.browsers import AsyncBrowsersResource
 
         return AsyncBrowsersResource(self)
@@ -959,7 +957,6 @@ def config_registry(self) -> config_registry.ConfigRegistryResourceWithRawRespon
 
     @cached_property
     def browsers(self) -> browsers.BrowsersResourceWithRawResponse:
-        """Create and manage browser sessions."""
         from .resources.browsers import BrowsersResourceWithRawResponse
 
         return BrowsersResourceWithRawResponse(self._client.browsers)
@@ -1098,7 +1095,6 @@ def config_registry(self) -> config_registry.AsyncConfigRegistryResourceWithRawR
 
     @cached_property
     def browsers(self) -> browsers.AsyncBrowsersResourceWithRawResponse:
-        """Create and manage browser sessions."""
         from .resources.browsers import AsyncBrowsersResourceWithRawResponse
 
         return AsyncBrowsersResourceWithRawResponse(self._client.browsers)
@@ -1237,7 +1233,6 @@ def config_registry(self) -> config_registry.ConfigRegistryResourceWithStreaming
 
     @cached_property
     def browsers(self) -> browsers.BrowsersResourceWithStreamingResponse:
-        """Create and manage browser sessions."""
         from .resources.browsers import BrowsersResourceWithStreamingResponse
 
         return BrowsersResourceWithStreamingResponse(self._client.browsers)
@@ -1376,7 +1371,6 @@ def config_registry(self) -> config_registry.AsyncConfigRegistryResourceWithStre
 
     @cached_property
     def browsers(self) -> browsers.AsyncBrowsersResourceWithStreamingResponse:
-        """Create and manage browser sessions."""
         from .resources.browsers import AsyncBrowsersResourceWithStreamingResponse
 
         return AsyncBrowsersResourceWithStreamingResponse(self._client.browsers)

src/kernel/resources/browsers/browsers.py

@@ -36,6 +36,7 @@
     BrowserMemoryRequest,
     browser_curl_params,
     browser_list_params,
+    browser_repl_params,
     browser_create_params,
     browser_update_params,
     browser_retrieve_params,
@@ -95,6 +96,7 @@
 from ...pagination import SyncOffsetPagination, AsyncOffsetPagination
 from ..._base_client import AsyncPaginator, make_request_options
 from ...types.tags_param import TagsParam
+from ...types.browser_repl_result import BrowserReplResult
 from ...types.browser_curl_response import BrowserCurlResponse
 from ...types.browser_list_response import BrowserListResponse
 from ...types.vault_reference_param import VaultReferenceParam
@@ -118,8 +120,6 @@
 
 
 class BrowsersResource(SyncAPIResource):
-    """Create and manage browser sessions."""
-
     @cached_property
     def telemetry(self) -> TelemetryResource:
         """
@@ -753,10 +753,75 @@ def load_extensions(
             cast_to=NoneType,
         )
 
+    def repl(
+        self,
+        id_or_name: str,
+        *,
+        code: str,
+        reset: bool | Omit = omit,
+        timeout_sec: int | 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> BrowserReplResult:
+        """
+        Execute JavaScript in a persistent Node.js runtime inside the browser VM.
+        Top-level bindings, closures, mutations, and dynamically imported modules
+        persist across calls until the REPL is reset or replaced. Start with
+        `repl.help()` to list available methods, or call `repl.help("click")` for
+        detailed help.
+
+        Expression values are ignored. Emit ordered text or image output with
+        `repl.write(...)`, console methods, or `repl.emitImage(...)`. The runtime also
+        exposes browser-control helpers, WebMCP, Patchright, Playwright, and raw CDP.
+
+        Executions are serialized. A timeout, crash, OOM, or protocol failure terminates
+        the REPL and changes its `repl_id`. This is unrestricted code execution inside
+        the browser VM and is not sandboxed.
+
+        Args:
+          code: JavaScript evaluated in a persistent Node.js runtime. Top-level bindings persist
+              until the browser VM's API process exits, the REPL is reset, or the REPL is
+              terminated after a crash or timeout. Static top-level imports are unsupported;
+              use dynamic `import()`. Expression values are ignored; emit output with
+              `repl.write(...)`, console methods, or `repl.emitImage(...)`. May be empty only
+              when `reset` is true.
+
+          reset: Terminate the current REPL, start a fresh one, and then evaluate code.
+
+          timeout_sec: Maximum execution time in seconds. Default is 60.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
+        return self._post(
+            path_template("/browsers/{id_or_name}/repl", id_or_name=id_or_name),
+            body=maybe_transform(
+                {
+                    "code": code,
+                    "reset": reset,
+                    "timeout_sec": timeout_sec,
+                },
+                browser_repl_params.BrowserReplParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrowserReplResult,
+        )
 
-class AsyncBrowsersResource(AsyncAPIResource):
-    """Create and manage browser sessions."""
 
+class AsyncBrowsersResource(AsyncAPIResource):
     @cached_property
     def telemetry(self) -> AsyncTelemetryResource:
         """
@@ -1390,6 +1455,73 @@ async def load_extensions(
             cast_to=NoneType,
         )
 
+    async def repl(
+        self,
+        id_or_name: str,
+        *,
+        code: str,
+        reset: bool | Omit = omit,
+        timeout_sec: int | 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> BrowserReplResult:
+        """
+        Execute JavaScript in a persistent Node.js runtime inside the browser VM.
+        Top-level bindings, closures, mutations, and dynamically imported modules
+        persist across calls until the REPL is reset or replaced. Start with
+        `repl.help()` to list available methods, or call `repl.help("click")` for
+        detailed help.
+
+        Expression values are ignored. Emit ordered text or image output with
+        `repl.write(...)`, console methods, or `repl.emitImage(...)`. The runtime also
+        exposes browser-control helpers, WebMCP, Patchright, Playwright, and raw CDP.
+
+        Executions are serialized. A timeout, crash, OOM, or protocol failure terminates
+        the REPL and changes its `repl_id`. This is unrestricted code execution inside
+        the browser VM and is not sandboxed.
+
+        Args:
+          code: JavaScript evaluated in a persistent Node.js runtime. Top-level bindings persist
+              until the browser VM's API process exits, the REPL is reset, or the REPL is
+              terminated after a crash or timeout. Static top-level imports are unsupported;
+              use dynamic `import()`. Expression values are ignored; emit output with
+              `repl.write(...)`, console methods, or `repl.emitImage(...)`. May be empty only
+              when `reset` is true.
+
+          reset: Terminate the current REPL, start a fresh one, and then evaluate code.
+
+          timeout_sec: Maximum execution time in seconds. Default is 60.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
+        return await self._post(
+            path_template("/browsers/{id_or_name}/repl", id_or_name=id_or_name),
+            body=await async_maybe_transform(
+                {
+                    "code": code,
+                    "reset": reset,
+                    "timeout_sec": timeout_sec,
+                },
+                browser_repl_params.BrowserReplParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrowserReplResult,
+        )
+
 
 class BrowsersResourceWithRawResponse:
     def __init__(self, browsers: BrowsersResource) -> None:
@@ -1416,6 +1548,9 @@ def __init__(self, browsers: BrowsersResource) -> None:
         self.load_extensions = to_raw_response_wrapper(
             browsers.load_extensions,
         )
+        self.repl = to_raw_response_wrapper(
+            browsers.repl,
+        )
 
     @cached_property
     def telemetry(self) -> TelemetryResourceWithRawResponse:
@@ -1485,6 +1620,9 @@ def __init__(self, browsers: AsyncBrowsersResource) -> None:
         self.load_extensions = async_to_raw_response_wrapper(
             browsers.load_extensions,
         )
+        self.repl = async_to_raw_response_wrapper(
+            browsers.repl,
+        )
 
     @cached_property
     def telemetry(self) -> AsyncTelemetryResourceWithRawResponse:
@@ -1554,6 +1692,9 @@ def __init__(self, browsers: BrowsersResource) -> None:
         self.load_extensions = to_streamed_response_wrapper(
             browsers.load_extensions,
         )
+        self.repl = to_streamed_response_wrapper(
+            browsers.repl,
+        )
 
     @cached_property
     def telemetry(self) -> TelemetryResourceWithStreamingResponse:
@@ -1623,6 +1764,9 @@ def __init__(self, browsers: AsyncBrowsersResource) -> None:
         self.load_extensions = async_to_streamed_response_wrapper(
             browsers.load_extensions,
         )
+        self.repl = async_to_streamed_response_wrapper(
+            browsers.repl,
+        )
 
     @cached_property
     def telemetry(self) -> AsyncTelemetryResourceWithStreamingResponse:

src/kernel/types/__init__.py

@@ -48,6 +48,8 @@
 from .api_key_list_params import APIKeyListParams as APIKeyListParams
 from .browser_curl_params import BrowserCurlParams as BrowserCurlParams
 from .browser_list_params import BrowserListParams as BrowserListParams
+from .browser_repl_params import BrowserReplParams as BrowserReplParams
+from .browser_repl_result import BrowserReplResult as BrowserReplResult
 from .credential_provider import CredentialProvider as CredentialProvider
 from .profile_list_params import ProfileListParams as ProfileListParams
 from .project_list_params import ProjectListParams as ProjectListParams
@@ -56,6 +58,7 @@
 from .proxy_update_params import ProxyUpdateParams as ProxyUpdateParams
 from .vault_upsert_params import VaultUpsertParams as VaultUpsertParams
 from .browser_proxy_config import BrowserProxyConfig as BrowserProxyConfig
+from .browser_repl_content import BrowserReplContent as BrowserReplContent
 from .proxy_check_response import ProxyCheckResponse as ProxyCheckResponse
 from .api_key_create_params import APIKeyCreateParams as APIKeyCreateParams
 from .api_key_rotate_params import APIKeyRotateParams as APIKeyRotateParams
@@ -104,12 +107,14 @@
 from .invocation_follow_params import InvocationFollowParams as InvocationFollowParams
 from .invocation_list_response import InvocationListResponse as InvocationListResponse
 from .invocation_update_params import InvocationUpdateParams as InvocationUpdateParams
+from .browser_repl_text_content import BrowserReplTextContent as BrowserReplTextContent
 from .browser_retrieve_response import BrowserRetrieveResponse as BrowserRetrieveResponse
 from .extension_upload_response import ExtensionUploadResponse as ExtensionUploadResponse
 from .browser_pool_create_params import BrowserPoolCreateParams as BrowserPoolCreateParams
 from .browser_pool_delete_params import BrowserPoolDeleteParams as BrowserPoolDeleteParams
 from .browser_pool_update_params import BrowserPoolUpdateParams as BrowserPoolUpdateParams
 from .browser_proxy_config_param import BrowserProxyConfigParam as BrowserProxyConfigParam
+from .browser_repl_image_content import BrowserReplImageContent as BrowserReplImageContent
 from .deployment_create_response import DeploymentCreateResponse as DeploymentCreateResponse
 from .deployment_follow_response import DeploymentFollowResponse as DeploymentFollowResponse
 from .invocation_create_response import InvocationCreateResponse as InvocationCreateResponse

src/kernel/types/browser_repl_content.py

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Union
+from typing_extensions import Annotated, TypeAlias
+
+from .._utils import PropertyInfo
+from .browser_repl_text_content import BrowserReplTextContent
+from .browser_repl_image_content import BrowserReplImageContent
+
+__all__ = ["BrowserReplContent"]
+
+BrowserReplContent: TypeAlias = Annotated[
+    Union[BrowserReplTextContent, BrowserReplImageContent], PropertyInfo(discriminator="type")
+]

src/kernel/types/browser_repl_image_content.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["BrowserReplImageContent"]
+
+
+class BrowserReplImageContent(BaseModel):
+    data_b64: str
+
+    mime_type: str
+
+    type: Literal["image"]

src/kernel/types/browser_repl_params.py

@@ -0,0 +1,25 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["BrowserReplParams"]
+
+
+class BrowserReplParams(TypedDict, total=False):
+    code: Required[str]
+    """JavaScript evaluated in a persistent Node.js runtime.
+
+    Top-level bindings persist until the browser VM's API process exits, the REPL is
+    reset, or the REPL is terminated after a crash or timeout. Static top-level
+    imports are unsupported; use dynamic `import()`. Expression values are ignored;
+    emit output with `repl.write(...)`, console methods, or `repl.emitImage(...)`.
+    May be empty only when `reset` is true.
+    """
+
+    reset: bool
+    """Terminate the current REPL, start a fresh one, and then evaluate code."""
+
+    timeout_sec: int
+    """Maximum execution time in seconds. Default is 60."""