feat: Accept browser session name on all /browsers/{id_or_name} sub-resource routes

Stainless-Generated-From: c2d7f09673a4d607dd628011d15d4a531c152d8e

Author: kernel-internal[bot]

.stats.yml

@@ -1 +1 @@
-configured_endpoints: 145
+configured_endpoints: 147

api.md

@@ -16,6 +16,14 @@
     LogsResourceWithStreamingResponse,
     AsyncLogsResourceWithStreamingResponse,
 )
+from .webmcp import (
+    WebmcpResource,
+    AsyncWebmcpResource,
+    WebmcpResourceWithRawResponse,
+    AsyncWebmcpResourceWithRawResponse,
+    WebmcpResourceWithStreamingResponse,
+    AsyncWebmcpResourceWithStreamingResponse,
+)
 from .process import (
     ProcessResource,
     AsyncProcessResource,
@@ -108,6 +116,12 @@
     "AsyncPlaywrightResourceWithRawResponse",
     "PlaywrightResourceWithStreamingResponse",
     "AsyncPlaywrightResourceWithStreamingResponse",
+    "WebmcpResource",
+    "AsyncWebmcpResource",
+    "WebmcpResourceWithRawResponse",
+    "AsyncWebmcpResourceWithRawResponse",
+    "WebmcpResourceWithStreamingResponse",
+    "AsyncWebmcpResourceWithStreamingResponse",
     "BrowsersResource",
     "AsyncBrowsersResource",
     "BrowsersResourceWithRawResponse",

src/kernel/resources/browsers/__init__.py

@@ -24,6 +24,14 @@
     FsResourceWithStreamingResponse,
     AsyncFsResourceWithStreamingResponse,
 )
+from .webmcp import (
+    WebmcpResource,
+    AsyncWebmcpResource,
+    WebmcpResourceWithRawResponse,
+    AsyncWebmcpResourceWithRawResponse,
+    WebmcpResourceWithStreamingResponse,
+    AsyncWebmcpResourceWithStreamingResponse,
+)
 from ...types import (
     BrowserMemoryRequest,
     browser_curl_params,
@@ -148,6 +156,11 @@ def playwright(self) -> PlaywrightResource:
         """Execute Playwright code against the browser instance."""
         return PlaywrightResource(self._client)
 
+    @cached_property
+    def webmcp(self) -> WebmcpResource:
+        """Discover and invoke native page tools across the browser instance."""
+        return WebmcpResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> BrowsersResourceWithRawResponse:
         """
@@ -527,7 +540,7 @@ def list(
 
     def curl(
         self,
-        id: str,
+        id_or_name: str,
         *,
         url: str,
         body: str | Omit = omit,
@@ -568,10 +581,10 @@ def curl(
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        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}/curl", id=id),
+            path_template("/browsers/{id_or_name}/curl", id_or_name=id_or_name),
             body=maybe_transform(
                 {
                     "url": url,
@@ -683,7 +696,7 @@ def delete_by_id(
 
     def load_extensions(
         self,
-        id: str,
+        id_or_name: str,
         *,
         extensions: Iterable[browser_load_extensions_params.Extension],
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -708,8 +721,8 @@ def load_extensions(
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         body = deepcopy_with_paths({"extensions": extensions}, [["extensions", "<array>", "zip_file"]])
         files = extract_files(cast(Mapping[str, object], body), paths=[["extensions", "<array>", "zip_file"]])
@@ -718,7 +731,7 @@ def load_extensions(
         # multipart/form-data; boundary=---abc--
         extra_headers["Content-Type"] = "multipart/form-data"
         return self._post(
-            path_template("/browsers/{id}/extensions", id=id),
+            path_template("/browsers/{id_or_name}/extensions", id_or_name=id_or_name),
             body=maybe_transform(body, browser_load_extensions_params.BrowserLoadExtensionsParams),
             files=files,
             options=make_request_options(
@@ -768,6 +781,11 @@ def playwright(self) -> AsyncPlaywrightResource:
         """Execute Playwright code against the browser instance."""
         return AsyncPlaywrightResource(self._client)
 
+    @cached_property
+    def webmcp(self) -> AsyncWebmcpResource:
+        """Discover and invoke native page tools across the browser instance."""
+        return AsyncWebmcpResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> AsyncBrowsersResourceWithRawResponse:
         """
@@ -1147,7 +1165,7 @@ def list(
 
     async def curl(
         self,
-        id: str,
+        id_or_name: str,
         *,
         url: str,
         body: str | Omit = omit,
@@ -1188,10 +1206,10 @@ async def curl(
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        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}/curl", id=id),
+            path_template("/browsers/{id_or_name}/curl", id_or_name=id_or_name),
             body=await async_maybe_transform(
                 {
                     "url": url,
@@ -1303,7 +1321,7 @@ async def delete_by_id(
 
     async def load_extensions(
         self,
-        id: str,
+        id_or_name: str,
         *,
         extensions: Iterable[browser_load_extensions_params.Extension],
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -1328,8 +1346,8 @@ async def load_extensions(
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         body = deepcopy_with_paths({"extensions": extensions}, [["extensions", "<array>", "zip_file"]])
         files = extract_files(cast(Mapping[str, object], body), paths=[["extensions", "<array>", "zip_file"]])
@@ -1338,7 +1356,7 @@ async def load_extensions(
         # multipart/form-data; boundary=---abc--
         extra_headers["Content-Type"] = "multipart/form-data"
         return await self._post(
-            path_template("/browsers/{id}/extensions", id=id),
+            path_template("/browsers/{id_or_name}/extensions", id_or_name=id_or_name),
             body=await async_maybe_transform(body, browser_load_extensions_params.BrowserLoadExtensionsParams),
             files=files,
             options=make_request_options(
@@ -1411,6 +1429,11 @@ def playwright(self) -> PlaywrightResourceWithRawResponse:
         """Execute Playwright code against the browser instance."""
         return PlaywrightResourceWithRawResponse(self._browsers.playwright)
 
+    @cached_property
+    def webmcp(self) -> WebmcpResourceWithRawResponse:
+        """Discover and invoke native page tools across the browser instance."""
+        return WebmcpResourceWithRawResponse(self._browsers.webmcp)
+
 
 class AsyncBrowsersResourceWithRawResponse:
     def __init__(self, browsers: AsyncBrowsersResource) -> None:
@@ -1475,6 +1498,11 @@ def playwright(self) -> AsyncPlaywrightResourceWithRawResponse:
         """Execute Playwright code against the browser instance."""
         return AsyncPlaywrightResourceWithRawResponse(self._browsers.playwright)
 
+    @cached_property
+    def webmcp(self) -> AsyncWebmcpResourceWithRawResponse:
+        """Discover and invoke native page tools across the browser instance."""
+        return AsyncWebmcpResourceWithRawResponse(self._browsers.webmcp)
+
 
 class BrowsersResourceWithStreamingResponse:
     def __init__(self, browsers: BrowsersResource) -> None:
@@ -1539,6 +1567,11 @@ def playwright(self) -> PlaywrightResourceWithStreamingResponse:
         """Execute Playwright code against the browser instance."""
         return PlaywrightResourceWithStreamingResponse(self._browsers.playwright)
 
+    @cached_property
+    def webmcp(self) -> WebmcpResourceWithStreamingResponse:
+        """Discover and invoke native page tools across the browser instance."""
+        return WebmcpResourceWithStreamingResponse(self._browsers.webmcp)
+
 
 class AsyncBrowsersResourceWithStreamingResponse:
     def __init__(self, browsers: AsyncBrowsersResource) -> None:
@@ -1602,3 +1635,8 @@ def computer(self) -> AsyncComputerResourceWithStreamingResponse:
     def playwright(self) -> AsyncPlaywrightResourceWithStreamingResponse:
         """Execute Playwright code against the browser instance."""
         return AsyncPlaywrightResourceWithStreamingResponse(self._browsers.playwright)
+
+    @cached_property
+    def webmcp(self) -> AsyncWebmcpResourceWithStreamingResponse:
+        """Discover and invoke native page tools across the browser instance."""
+        return AsyncWebmcpResourceWithStreamingResponse(self._browsers.webmcp)