feat: Add name-only rename for profiles and proxies

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 125
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-db45aab5b114bc0848eab997c85bfc02a653be9f929f8d090ec24187462733ee.yml
-openapi_spec_hash: 82f4282312699f8d54bec207e981efe8
-config_hash: 06186eb40e0058a2a87ac251fc07415d
+configured_endpoints: 127
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-bc33d13e669972493e9ab0da82a71999822dc049eb14b113f446753c917ffcdb.yml
+openapi_spec_hash: 133a2e0d0cdc4023f98b3c2e589cf5d8
+config_hash: 77ee715aa17061166f9a02b264a21b8d

api.md

@@ -285,6 +285,7 @@ Methods:
 
 - <code title="post /profiles">client.profiles.<a href="./src/kernel/resources/profiles.py">create</a>(\*\*<a href="src/kernel/types/profile_create_params.py">params</a>) -> <a href="./src/kernel/types/profile.py">Profile</a></code>
 - <code title="get /profiles/{id_or_name}">client.profiles.<a href="./src/kernel/resources/profiles.py">retrieve</a>(id_or_name) -> <a href="./src/kernel/types/profile.py">Profile</a></code>
+- <code title="patch /profiles/{id_or_name}">client.profiles.<a href="./src/kernel/resources/profiles.py">update</a>(id_or_name, \*\*<a href="src/kernel/types/profile_update_params.py">params</a>) -> <a href="./src/kernel/types/profile.py">Profile</a></code>
 - <code title="get /profiles">client.profiles.<a href="./src/kernel/resources/profiles.py">list</a>(\*\*<a href="src/kernel/types/profile_list_params.py">params</a>) -> <a href="./src/kernel/types/profile.py">SyncOffsetPagination[Profile]</a></code>
 - <code title="delete /profiles/{id_or_name}">client.profiles.<a href="./src/kernel/resources/profiles.py">delete</a>(id_or_name) -> None</code>
 - <code title="get /profiles/{id_or_name}/download">client.profiles.<a href="./src/kernel/resources/profiles.py">download</a>(id_or_name) -> BinaryAPIResponse</code>
@@ -328,6 +329,7 @@ Types:
 from kernel.types import (
     ProxyCreateResponse,
     ProxyRetrieveResponse,
+    ProxyUpdateResponse,
     ProxyListResponse,
     ProxyCheckResponse,
 )
@@ -337,6 +339,7 @@ Methods:
 
 - <code title="post /proxies">client.proxies.<a href="./src/kernel/resources/proxies.py">create</a>(\*\*<a href="src/kernel/types/proxy_create_params.py">params</a>) -> <a href="./src/kernel/types/proxy_create_response.py">ProxyCreateResponse</a></code>
 - <code title="get /proxies/{id}">client.proxies.<a href="./src/kernel/resources/proxies.py">retrieve</a>(id) -> <a href="./src/kernel/types/proxy_retrieve_response.py">ProxyRetrieveResponse</a></code>
+- <code title="patch /proxies/{id}">client.proxies.<a href="./src/kernel/resources/proxies.py">update</a>(id, \*\*<a href="src/kernel/types/proxy_update_params.py">params</a>) -> <a href="./src/kernel/types/proxy_update_response.py">ProxyUpdateResponse</a></code>
 - <code title="get /proxies">client.proxies.<a href="./src/kernel/resources/proxies.py">list</a>(\*\*<a href="src/kernel/types/proxy_list_params.py">params</a>) -> <a href="./src/kernel/types/proxy_list_response.py">SyncOffsetPagination[ProxyListResponse]</a></code>
 - <code title="delete /proxies/{id}">client.proxies.<a href="./src/kernel/resources/proxies.py">delete</a>(id) -> None</code>
 - <code title="post /proxies/{id}/check">client.proxies.<a href="./src/kernel/resources/proxies.py">check</a>(id, \*\*<a href="src/kernel/types/proxy_check_params.py">params</a>) -> <a href="./src/kernel/types/proxy_check_response.py">ProxyCheckResponse</a></code>

src/kernel/resources/profiles.py

@@ -4,7 +4,7 @@
 
 import httpx
 
-from ..types import profile_list_params, profile_create_params
+from ..types import profile_list_params, profile_create_params, profile_update_params
 from .._types import Body, Omit, Query, Headers, NoneType, NotGiven, omit, not_given
 from .._utils import path_template, maybe_transform, async_maybe_transform
 from .._compat import cached_property
@@ -68,7 +68,9 @@ def create(
         sessions.
 
         Args:
-          name: Optional name of the profile. Must be unique within the project.
+          name: Optional name of the profile. Must be unique within the logical project; during
+              the default-project migration, unscoped profiles and profiles in the org default
+              project are treated as the same project.
 
           extra_headers: Send extra headers
 
@@ -120,6 +122,52 @@ def retrieve(
             cast_to=Profile,
         )
 
+    def update(
+        self,
+        id_or_name: str,
+        *,
+        name: str,
+        # 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,
+    ) -> Profile:
+        """Update a profile's name.
+
+        Names must be unique within the logical project; during
+        the default-project migration, unscoped profiles and profiles in the org default
+        project are treated as the same project. Duplicate-name conflicts are checked
+        before update but are best-effort because there is no backing unique index.
+        Renaming a profile while a browser session references it by name may prevent
+        that session's changes from saving; prefer renaming when the profile is not in
+        use.
+
+        Args:
+          name: New profile name. Must be unique within the logical project; during the
+              default-project migration, unscoped profiles and profiles in the org default
+              project are treated as the same project.
+
+          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._patch(
+            path_template("/profiles/{id_or_name}", id_or_name=id_or_name),
+            body=maybe_transform({"name": name}, profile_update_params.ProfileUpdateParams),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Profile,
+        )
+
     def list(
         self,
         *,
@@ -278,7 +326,9 @@ async def create(
         sessions.
 
         Args:
-          name: Optional name of the profile. Must be unique within the project.
+          name: Optional name of the profile. Must be unique within the logical project; during
+              the default-project migration, unscoped profiles and profiles in the org default
+              project are treated as the same project.
 
           extra_headers: Send extra headers
 
@@ -330,6 +380,52 @@ async def retrieve(
             cast_to=Profile,
         )
 
+    async def update(
+        self,
+        id_or_name: str,
+        *,
+        name: str,
+        # 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,
+    ) -> Profile:
+        """Update a profile's name.
+
+        Names must be unique within the logical project; during
+        the default-project migration, unscoped profiles and profiles in the org default
+        project are treated as the same project. Duplicate-name conflicts are checked
+        before update but are best-effort because there is no backing unique index.
+        Renaming a profile while a browser session references it by name may prevent
+        that session's changes from saving; prefer renaming when the profile is not in
+        use.
+
+        Args:
+          name: New profile name. Must be unique within the logical project; during the
+              default-project migration, unscoped profiles and profiles in the org default
+              project are treated as the same project.
+
+          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._patch(
+            path_template("/profiles/{id_or_name}", id_or_name=id_or_name),
+            body=await async_maybe_transform({"name": name}, profile_update_params.ProfileUpdateParams),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Profile,
+        )
+
     def list(
         self,
         *,
@@ -460,6 +556,9 @@ def __init__(self, profiles: ProfilesResource) -> None:
         self.retrieve = to_raw_response_wrapper(
             profiles.retrieve,
         )
+        self.update = to_raw_response_wrapper(
+            profiles.update,
+        )
         self.list = to_raw_response_wrapper(
             profiles.list,
         )
@@ -482,6 +581,9 @@ def __init__(self, profiles: AsyncProfilesResource) -> None:
         self.retrieve = async_to_raw_response_wrapper(
             profiles.retrieve,
         )
+        self.update = async_to_raw_response_wrapper(
+            profiles.update,
+        )
         self.list = async_to_raw_response_wrapper(
             profiles.list,
         )
@@ -504,6 +606,9 @@ def __init__(self, profiles: ProfilesResource) -> None:
         self.retrieve = to_streamed_response_wrapper(
             profiles.retrieve,
         )
+        self.update = to_streamed_response_wrapper(
+            profiles.update,
+        )
         self.list = to_streamed_response_wrapper(
             profiles.list,
         )
@@ -526,6 +631,9 @@ def __init__(self, profiles: AsyncProfilesResource) -> None:
         self.retrieve = async_to_streamed_response_wrapper(
             profiles.retrieve,
         )
+        self.update = async_to_streamed_response_wrapper(
+            profiles.update,
+        )
         self.list = async_to_streamed_response_wrapper(
             profiles.list,
         )

src/kernel/resources/proxies.py

@@ -6,7 +6,7 @@
 
 import httpx
 
-from ..types import proxy_list_params, proxy_check_params, proxy_create_params
+from ..types import proxy_list_params, proxy_check_params, proxy_create_params, proxy_update_params
 from .._types import Body, Omit, Query, Headers, NoneType, NotGiven, SequenceNotStr, omit, not_given
 from .._utils import path_template, maybe_transform, async_maybe_transform
 from .._compat import cached_property
@@ -22,6 +22,7 @@
 from ..types.proxy_list_response import ProxyListResponse
 from ..types.proxy_check_response import ProxyCheckResponse
 from ..types.proxy_create_response import ProxyCreateResponse
+from ..types.proxy_update_response import ProxyUpdateResponse
 from ..types.proxy_retrieve_response import ProxyRetrieveResponse
 
 __all__ = ["ProxiesResource", "AsyncProxiesResource"]
@@ -138,6 +139,48 @@ def retrieve(
             cast_to=ProxyRetrieveResponse,
         )
 
+    def update(
+        self,
+        id: str,
+        *,
+        name: str,
+        # 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,
+    ) -> ProxyUpdateResponse:
+        """Update a proxy's name.
+
+        Proxy names are not unique and are not ID-or-name
+        addressable on this endpoint; duplicate names are allowed. Name-based
+        session-create lookups can remain ambiguous until callers resolve proxies by ID
+        or the API adds a stronger uniqueness contract.
+
+        Args:
+          name: New proxy name. Proxy names are trimmed and length-checked only; duplicates are
+              allowed because proxies are updated by ID, not by name.
+
+          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:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._patch(
+            path_template("/proxies/{id}", id=id),
+            body=maybe_transform({"name": name}, proxy_update_params.ProxyUpdateParams),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ProxyUpdateResponse,
+        )
+
     def list(
         self,
         *,
@@ -390,6 +433,48 @@ async def retrieve(
             cast_to=ProxyRetrieveResponse,
         )
 
+    async def update(
+        self,
+        id: str,
+        *,
+        name: str,
+        # 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,
+    ) -> ProxyUpdateResponse:
+        """Update a proxy's name.
+
+        Proxy names are not unique and are not ID-or-name
+        addressable on this endpoint; duplicate names are allowed. Name-based
+        session-create lookups can remain ambiguous until callers resolve proxies by ID
+        or the API adds a stronger uniqueness contract.
+
+        Args:
+          name: New proxy name. Proxy names are trimmed and length-checked only; duplicates are
+              allowed because proxies are updated by ID, not by name.
+
+          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:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._patch(
+            path_template("/proxies/{id}", id=id),
+            body=await async_maybe_transform({"name": name}, proxy_update_params.ProxyUpdateParams),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ProxyUpdateResponse,
+        )
+
     def list(
         self,
         *,
@@ -541,6 +626,9 @@ def __init__(self, proxies: ProxiesResource) -> None:
         self.retrieve = to_raw_response_wrapper(
             proxies.retrieve,
         )
+        self.update = to_raw_response_wrapper(
+            proxies.update,
+        )
         self.list = to_raw_response_wrapper(
             proxies.list,
         )
@@ -562,6 +650,9 @@ def __init__(self, proxies: AsyncProxiesResource) -> None:
         self.retrieve = async_to_raw_response_wrapper(
             proxies.retrieve,
         )
+        self.update = async_to_raw_response_wrapper(
+            proxies.update,
+        )
         self.list = async_to_raw_response_wrapper(
             proxies.list,
         )
@@ -583,6 +674,9 @@ def __init__(self, proxies: ProxiesResource) -> None:
         self.retrieve = to_streamed_response_wrapper(
             proxies.retrieve,
         )
+        self.update = to_streamed_response_wrapper(
+            proxies.update,
+        )
         self.list = to_streamed_response_wrapper(
             proxies.list,
         )
@@ -604,6 +698,9 @@ def __init__(self, proxies: AsyncProxiesResource) -> None:
         self.retrieve = async_to_streamed_response_wrapper(
             proxies.retrieve,
         )
+        self.update = async_to_streamed_response_wrapper(
+            proxies.update,
+        )
         self.list = async_to_streamed_response_wrapper(
             proxies.list,
         )

src/kernel/types/__init__.py

@@ -38,6 +38,7 @@
 from .project_list_params import ProjectListParams as ProjectListParams
 from .proxy_create_params import ProxyCreateParams as ProxyCreateParams
 from .proxy_list_response import ProxyListResponse as ProxyListResponse
+from .proxy_update_params import ProxyUpdateParams as ProxyUpdateParams
 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
@@ -49,9 +50,11 @@
 from .browser_update_params import BrowserUpdateParams as BrowserUpdateParams
 from .extension_list_params import ExtensionListParams as ExtensionListParams
 from .profile_create_params import ProfileCreateParams as ProfileCreateParams
+from .profile_update_params import ProfileUpdateParams as ProfileUpdateParams
 from .project_create_params import ProjectCreateParams as ProjectCreateParams
 from .project_update_params import ProjectUpdateParams as ProjectUpdateParams
 from .proxy_create_response import ProxyCreateResponse as ProxyCreateResponse
+from .proxy_update_response import ProxyUpdateResponse as ProxyUpdateResponse
 from .credential_list_params import CredentialListParams as CredentialListParams
 from .deployment_list_params import DeploymentListParams as DeploymentListParams
 from .deployment_state_event import DeploymentStateEvent as DeploymentStateEvent

src/kernel/types/profile_create_params.py

@@ -9,4 +9,9 @@
 
 class ProfileCreateParams(TypedDict, total=False):
     name: str
-    """Optional name of the profile. Must be unique within the project."""
+    """Optional name of the profile.
+
+    Must be unique within the logical project; during the default-project migration,
+    unscoped profiles and profiles in the org default project are treated as the
+    same project.
+    """