feat(api): add GET /extensions/{id_or_name}/metadata

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 120
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-ab4e7c50c41fefd891648fa84ba0258986f192ba1bde9f42cbdf487f64c4cc27.yml
-openapi_spec_hash: b4bcd6557f7045ecff30b01e02d28ac5
-config_hash: 03c7e57f268c750e2415831662e95969
+configured_endpoints: 121
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-bccc42bb10d1afe703f0374d11f33e775522069d69a13bb2345cc566a49ba4f3.yml
+openapi_spec_hash: 9f00975c0e741ed84011413674313be0
+config_hash: 3a50aee540dce69a53bb8942f5086f5e

api.md

@@ -342,7 +342,7 @@ Methods:
 Types:
 
 ```python
-from kernel.types import ExtensionListResponse, ExtensionUploadResponse
+from kernel.types import ExtensionListResponse, ExtensionGetResponse, ExtensionUploadResponse
 ```
 
 Methods:
@@ -351,6 +351,7 @@ Methods:
 - <code title="delete /extensions/{id_or_name}">client.extensions.<a href="./src/kernel/resources/extensions.py">delete</a>(id_or_name) -> None</code>
 - <code title="get /extensions/{id_or_name}">client.extensions.<a href="./src/kernel/resources/extensions.py">download</a>(id_or_name) -> BinaryAPIResponse</code>
 - <code title="get /extensions/from_chrome_store">client.extensions.<a href="./src/kernel/resources/extensions.py">download_from_chrome_store</a>(\*\*<a href="src/kernel/types/extension_download_from_chrome_store_params.py">params</a>) -> BinaryAPIResponse</code>
+- <code title="get /extensions/{id_or_name}/metadata">client.extensions.<a href="./src/kernel/resources/extensions.py">get</a>(id_or_name) -> <a href="./src/kernel/types/extension_get_response.py">ExtensionGetResponse</a></code>
 - <code title="post /extensions">client.extensions.<a href="./src/kernel/resources/extensions.py">upload</a>(\*\*<a href="src/kernel/types/extension_upload_params.py">params</a>) -> <a href="./src/kernel/types/extension_upload_response.py">ExtensionUploadResponse</a></code>
 
 # BrowserPools

src/kernel/resources/extensions.py

@@ -29,6 +29,7 @@
 )
 from ..pagination import SyncOffsetPagination, AsyncOffsetPagination
 from .._base_client import AsyncPaginator, make_request_options
+from ..types.extension_get_response import ExtensionGetResponse
 from ..types.extension_list_response import ExtensionListResponse
 from ..types.extension_upload_response import ExtensionUploadResponse
 
@@ -224,6 +225,40 @@ def download_from_chrome_store(
             cast_to=BinaryAPIResponse,
         )
 
+    def get(
+        self,
+        id_or_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,
+    ) -> ExtensionGetResponse:
+        """
+        Get an extension's metadata (name, size, timestamps) by ID or name, without
+        downloading the archive.
+
+        Args:
+          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._get(
+            path_template("/extensions/{id_or_name}/metadata", id_or_name=id_or_name),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ExtensionGetResponse,
+        )
+
     def upload(
         self,
         *,
@@ -466,6 +501,40 @@ async def download_from_chrome_store(
             cast_to=AsyncBinaryAPIResponse,
         )
 
+    async def get(
+        self,
+        id_or_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,
+    ) -> ExtensionGetResponse:
+        """
+        Get an extension's metadata (name, size, timestamps) by ID or name, without
+        downloading the archive.
+
+        Args:
+          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._get(
+            path_template("/extensions/{id_or_name}/metadata", id_or_name=id_or_name),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ExtensionGetResponse,
+        )
+
     async def upload(
         self,
         *,
@@ -537,6 +606,9 @@ def __init__(self, extensions: ExtensionsResource) -> None:
             extensions.download_from_chrome_store,
             BinaryAPIResponse,
         )
+        self.get = to_raw_response_wrapper(
+            extensions.get,
+        )
         self.upload = to_raw_response_wrapper(
             extensions.upload,
         )
@@ -560,6 +632,9 @@ def __init__(self, extensions: AsyncExtensionsResource) -> None:
             extensions.download_from_chrome_store,
             AsyncBinaryAPIResponse,
         )
+        self.get = async_to_raw_response_wrapper(
+            extensions.get,
+        )
         self.upload = async_to_raw_response_wrapper(
             extensions.upload,
         )
@@ -583,6 +658,9 @@ def __init__(self, extensions: ExtensionsResource) -> None:
             extensions.download_from_chrome_store,
             StreamedBinaryAPIResponse,
         )
+        self.get = to_streamed_response_wrapper(
+            extensions.get,
+        )
         self.upload = to_streamed_response_wrapper(
             extensions.upload,
         )
@@ -606,6 +684,9 @@ def __init__(self, extensions: AsyncExtensionsResource) -> None:
             extensions.download_from_chrome_store,
             AsyncStreamedBinaryAPIResponse,
         )
+        self.get = async_to_streamed_response_wrapper(
+            extensions.get,
+        )
         self.upload = async_to_streamed_response_wrapper(
             extensions.upload,
         )

src/kernel/types/__init__.py

@@ -53,6 +53,7 @@
 from .credential_list_params import CredentialListParams as CredentialListParams
 from .deployment_list_params import DeploymentListParams as DeploymentListParams
 from .deployment_state_event import DeploymentStateEvent as DeploymentStateEvent
+from .extension_get_response import ExtensionGetResponse as ExtensionGetResponse
 from .invocation_list_params import InvocationListParams as InvocationListParams
 from .invocation_state_event import InvocationStateEvent as InvocationStateEvent
 from .api_key_retrieve_params import APIKeyRetrieveParams as APIKeyRetrieveParams

src/kernel/types/extension_get_response.py

@@ -0,0 +1,30 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+
+from .._models import BaseModel
+
+__all__ = ["ExtensionGetResponse"]
+
+
+class ExtensionGetResponse(BaseModel):
+    """A browser extension uploaded to Kernel."""
+
+    id: str
+    """Unique identifier for the extension"""
+
+    created_at: datetime
+    """Timestamp when the extension was created"""
+
+    size_bytes: int
+    """Size of the extension archive in bytes"""
+
+    last_used_at: Optional[datetime] = None
+    """Timestamp when the extension was last used"""
+
+    name: Optional[str] = None
+    """Optional, easier-to-reference name for the extension.
+
+    Must be unique within the project.
+    """

tests/api_resources/test_extensions.py

@@ -12,6 +12,7 @@
 from kernel import Kernel, AsyncKernel
 from tests.utils import assert_matches_type
 from kernel.types import (
+    ExtensionGetResponse,
     ExtensionListResponse,
     ExtensionUploadResponse,
 )
@@ -214,6 +215,48 @@ def test_streaming_response_download_from_chrome_store(self, client: Kernel, res
 
         assert cast(Any, extension.is_closed) is True
 
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    def test_method_get(self, client: Kernel) -> None:
+        extension = client.extensions.get(
+            "id_or_name",
+        )
+        assert_matches_type(ExtensionGetResponse, extension, path=["response"])
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    def test_raw_response_get(self, client: Kernel) -> None:
+        response = client.extensions.with_raw_response.get(
+            "id_or_name",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        extension = response.parse()
+        assert_matches_type(ExtensionGetResponse, extension, path=["response"])
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    def test_streaming_response_get(self, client: Kernel) -> None:
+        with client.extensions.with_streaming_response.get(
+            "id_or_name",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            extension = response.parse()
+            assert_matches_type(ExtensionGetResponse, extension, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    def test_path_params_get(self, client: Kernel) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id_or_name` but received ''"):
+            client.extensions.with_raw_response.get(
+                "",
+            )
+
     @pytest.mark.skip(reason="Mock server tests are disabled")
     @parametrize
     def test_method_upload(self, client: Kernel) -> None:
@@ -454,6 +497,48 @@ async def test_streaming_response_download_from_chrome_store(
 
         assert cast(Any, extension.is_closed) is True
 
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    async def test_method_get(self, async_client: AsyncKernel) -> None:
+        extension = await async_client.extensions.get(
+            "id_or_name",
+        )
+        assert_matches_type(ExtensionGetResponse, extension, path=["response"])
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    async def test_raw_response_get(self, async_client: AsyncKernel) -> None:
+        response = await async_client.extensions.with_raw_response.get(
+            "id_or_name",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        extension = await response.parse()
+        assert_matches_type(ExtensionGetResponse, extension, path=["response"])
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    async def test_streaming_response_get(self, async_client: AsyncKernel) -> None:
+        async with async_client.extensions.with_streaming_response.get(
+            "id_or_name",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            extension = await response.parse()
+            assert_matches_type(ExtensionGetResponse, extension, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    async def test_path_params_get(self, async_client: AsyncKernel) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id_or_name` but received ''"):
+            await async_client.extensions.with_raw_response.get(
+                "",
+            )
+
     @pytest.mark.skip(reason="Mock server tests are disabled")
     @parametrize
     async def test_method_upload(self, async_client: AsyncKernel) -> None: