feat: Add customer-facing OTLP destination CRUD API

Stainless-Generated-From: fc9d70b47afce5656d62cc298600a5e249ea0d63

Author: kernel-internal[bot]

.stats.yml

@@ -1 +1 @@
-configured_endpoints: 134
+configured_endpoints: 139

api.md

@@ -342,6 +342,24 @@ Methods:
 - <code title="post /auth/connections/{id}/submit">client.auth.connections.<a href="./src/kernel/resources/auth/connections.py">submit</a>(id, \*\*<a href="src/kernel/types/auth/connection_submit_params.py">params</a>) -> <a href="./src/kernel/types/auth/submit_fields_response.py">SubmitFieldsResponse</a></code>
 - <code title="get /auth/connections/{id}/timeline">client.auth.connections.<a href="./src/kernel/resources/auth/connections.py">timeline</a>(id, \*\*<a href="src/kernel/types/auth/connection_timeline_params.py">params</a>) -> <a href="./src/kernel/types/auth/managed_auth_timeline_event.py">SyncOffsetPagination[ManagedAuthTimelineEvent]</a></code>
 
+# Telemetry
+
+## Destinations
+
+Types:
+
+```python
+from kernel.types.telemetry import OtlpDestination
+```
+
+Methods:
+
+- <code title="post /telemetry/destinations">client.telemetry.destinations.<a href="./src/kernel/resources/telemetry/destinations.py">create</a>(\*\*<a href="src/kernel/types/telemetry/destination_create_params.py">params</a>) -> <a href="./src/kernel/types/telemetry/otlp_destination.py">OtlpDestination</a></code>
+- <code title="get /telemetry/destinations/{id_or_name}">client.telemetry.destinations.<a href="./src/kernel/resources/telemetry/destinations.py">retrieve</a>(id_or_name) -> <a href="./src/kernel/types/telemetry/otlp_destination.py">OtlpDestination</a></code>
+- <code title="patch /telemetry/destinations/{id_or_name}">client.telemetry.destinations.<a href="./src/kernel/resources/telemetry/destinations.py">update</a>(id_or_name, \*\*<a href="src/kernel/types/telemetry/destination_update_params.py">params</a>) -> <a href="./src/kernel/types/telemetry/otlp_destination.py">OtlpDestination</a></code>
+- <code title="get /telemetry/destinations">client.telemetry.destinations.<a href="./src/kernel/resources/telemetry/destinations.py">list</a>(\*\*<a href="src/kernel/types/telemetry/destination_list_params.py">params</a>) -> <a href="./src/kernel/types/telemetry/otlp_destination.py">SyncOffsetPagination[OtlpDestination]</a></code>
+- <code title="delete /telemetry/destinations/{id_or_name}">client.telemetry.destinations.<a href="./src/kernel/resources/telemetry/destinations.py">delete</a>(id_or_name) -> None</code>
+
 # Proxies
 
 Types:

src/kernel/_client.py

@@ -54,6 +54,7 @@
         browsers,
         profiles,
         projects,
+        telemetry,
         audit_logs,
         extensions,
         credentials,
@@ -75,6 +76,7 @@
     from .resources.browser_pools import BrowserPoolsResource, AsyncBrowserPoolsResource
     from .resources.browsers.browsers import BrowsersResource, AsyncBrowsersResource
     from .resources.projects.projects import ProjectsResource, AsyncProjectsResource
+    from .resources.telemetry.telemetry import TelemetryResource, AsyncTelemetryResource
     from .resources.credential_providers import CredentialProvidersResource, AsyncCredentialProvidersResource
     from .resources.audit_logs.audit_logs import AuditLogsResource, AsyncAuditLogsResource
     from .resources.organization.organization import OrganizationResource, AsyncOrganizationResource
@@ -240,6 +242,12 @@ def auth(self) -> AuthResource:
 
         return AuthResource(self)
 
+    @cached_property
+    def telemetry(self) -> TelemetryResource:
+        from .resources.telemetry import TelemetryResource
+
+        return TelemetryResource(self)
+
     @cached_property
     def proxies(self) -> ProxiesResource:
         """Create and manage proxy configurations for routing browser traffic."""
@@ -603,6 +611,12 @@ def auth(self) -> AsyncAuthResource:
 
         return AsyncAuthResource(self)
 
+    @cached_property
+    def telemetry(self) -> AsyncTelemetryResource:
+        from .resources.telemetry import AsyncTelemetryResource
+
+        return AsyncTelemetryResource(self)
+
     @cached_property
     def proxies(self) -> AsyncProxiesResource:
         """Create and manage proxy configurations for routing browser traffic."""
@@ -870,6 +884,12 @@ def auth(self) -> auth.AuthResourceWithRawResponse:
 
         return AuthResourceWithRawResponse(self._client.auth)
 
+    @cached_property
+    def telemetry(self) -> telemetry.TelemetryResourceWithRawResponse:
+        from .resources.telemetry import TelemetryResourceWithRawResponse
+
+        return TelemetryResourceWithRawResponse(self._client.telemetry)
+
     @cached_property
     def proxies(self) -> proxies.ProxiesResourceWithRawResponse:
         """Create and manage proxy configurations for routing browser traffic."""
@@ -984,6 +1004,12 @@ def auth(self) -> auth.AsyncAuthResourceWithRawResponse:
 
         return AsyncAuthResourceWithRawResponse(self._client.auth)
 
+    @cached_property
+    def telemetry(self) -> telemetry.AsyncTelemetryResourceWithRawResponse:
+        from .resources.telemetry import AsyncTelemetryResourceWithRawResponse
+
+        return AsyncTelemetryResourceWithRawResponse(self._client.telemetry)
+
     @cached_property
     def proxies(self) -> proxies.AsyncProxiesResourceWithRawResponse:
         """Create and manage proxy configurations for routing browser traffic."""
@@ -1098,6 +1124,12 @@ def auth(self) -> auth.AuthResourceWithStreamingResponse:
 
         return AuthResourceWithStreamingResponse(self._client.auth)
 
+    @cached_property
+    def telemetry(self) -> telemetry.TelemetryResourceWithStreamingResponse:
+        from .resources.telemetry import TelemetryResourceWithStreamingResponse
+
+        return TelemetryResourceWithStreamingResponse(self._client.telemetry)
+
     @cached_property
     def proxies(self) -> proxies.ProxiesResourceWithStreamingResponse:
         """Create and manage proxy configurations for routing browser traffic."""
@@ -1212,6 +1244,12 @@ def auth(self) -> auth.AsyncAuthResourceWithStreamingResponse:
 
         return AsyncAuthResourceWithStreamingResponse(self._client.auth)
 
+    @cached_property
+    def telemetry(self) -> telemetry.AsyncTelemetryResourceWithStreamingResponse:
+        from .resources.telemetry import AsyncTelemetryResourceWithStreamingResponse
+
+        return AsyncTelemetryResourceWithStreamingResponse(self._client.telemetry)
+
     @cached_property
     def proxies(self) -> proxies.AsyncProxiesResourceWithStreamingResponse:
         """Create and manage proxy configurations for routing browser traffic."""

src/kernel/resources/__init__.py

@@ -56,6 +56,14 @@
     ProjectsResourceWithStreamingResponse,
     AsyncProjectsResourceWithStreamingResponse,
 )
+from .telemetry import (
+    TelemetryResource,
+    AsyncTelemetryResource,
+    TelemetryResourceWithRawResponse,
+    AsyncTelemetryResourceWithRawResponse,
+    TelemetryResourceWithStreamingResponse,
+    AsyncTelemetryResourceWithStreamingResponse,
+)
 from .audit_logs import (
     AuditLogsResource,
     AsyncAuditLogsResource,
@@ -158,6 +166,12 @@
     "AsyncAuthResourceWithRawResponse",
     "AuthResourceWithStreamingResponse",
     "AsyncAuthResourceWithStreamingResponse",
+    "TelemetryResource",
+    "AsyncTelemetryResource",
+    "TelemetryResourceWithRawResponse",
+    "AsyncTelemetryResourceWithRawResponse",
+    "TelemetryResourceWithStreamingResponse",
+    "AsyncTelemetryResourceWithStreamingResponse",
     "ProxiesResource",
     "AsyncProxiesResource",
     "ProxiesResourceWithRawResponse",

src/kernel/resources/browsers/browsers.py

@@ -113,7 +113,9 @@ class BrowsersResource(SyncAPIResource):
 
     @cached_property
     def telemetry(self) -> TelemetryResource:
-        """Stream live telemetry events from a browser session."""
+        """
+        Stream live telemetry events from a browser session, and manage the destinations sessions export them to.
+        """
         return TelemetryResource(self._client)
 
     @cached_property
@@ -731,7 +733,9 @@ class AsyncBrowsersResource(AsyncAPIResource):
 
     @cached_property
     def telemetry(self) -> AsyncTelemetryResource:
-        """Stream live telemetry events from a browser session."""
+        """
+        Stream live telemetry events from a browser session, and manage the destinations sessions export them to.
+        """
         return AsyncTelemetryResource(self._client)
 
     @cached_property
@@ -1372,7 +1376,9 @@ def __init__(self, browsers: BrowsersResource) -> None:
 
     @cached_property
     def telemetry(self) -> TelemetryResourceWithRawResponse:
-        """Stream live telemetry events from a browser session."""
+        """
+        Stream live telemetry events from a browser session, and manage the destinations sessions export them to.
+        """
         return TelemetryResourceWithRawResponse(self._browsers.telemetry)
 
     @cached_property
@@ -1434,7 +1440,9 @@ def __init__(self, browsers: AsyncBrowsersResource) -> None:
 
     @cached_property
     def telemetry(self) -> AsyncTelemetryResourceWithRawResponse:
-        """Stream live telemetry events from a browser session."""
+        """
+        Stream live telemetry events from a browser session, and manage the destinations sessions export them to.
+        """
         return AsyncTelemetryResourceWithRawResponse(self._browsers.telemetry)
 
     @cached_property
@@ -1496,7 +1504,9 @@ def __init__(self, browsers: BrowsersResource) -> None:
 
     @cached_property
     def telemetry(self) -> TelemetryResourceWithStreamingResponse:
-        """Stream live telemetry events from a browser session."""
+        """
+        Stream live telemetry events from a browser session, and manage the destinations sessions export them to.
+        """
         return TelemetryResourceWithStreamingResponse(self._browsers.telemetry)
 
     @cached_property
@@ -1558,7 +1568,9 @@ def __init__(self, browsers: AsyncBrowsersResource) -> None:
 
     @cached_property
     def telemetry(self) -> AsyncTelemetryResourceWithStreamingResponse:
-        """Stream live telemetry events from a browser session."""
+        """
+        Stream live telemetry events from a browser session, and manage the destinations sessions export them to.
+        """
         return AsyncTelemetryResourceWithStreamingResponse(self._browsers.telemetry)
 
     @cached_property

src/kernel/resources/browsers/telemetry.py

@@ -28,7 +28,9 @@
 
 
 class TelemetryResource(SyncAPIResource):
-    """Stream live telemetry events from a browser session."""
+    """
+    Stream live telemetry events from a browser session, and manage the destinations sessions export them to.
+    """
 
     @cached_property
     def with_raw_response(self) -> TelemetryResourceWithRawResponse:
@@ -202,7 +204,9 @@ def stream(
 
 
 class AsyncTelemetryResource(AsyncAPIResource):
-    """Stream live telemetry events from a browser session."""
+    """
+    Stream live telemetry events from a browser session, and manage the destinations sessions export them to.
+    """
 
     @cached_property
     def with_raw_response(self) -> AsyncTelemetryResourceWithRawResponse:

src/kernel/resources/telemetry/__init__.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .telemetry import (
+    TelemetryResource,
+    AsyncTelemetryResource,
+    TelemetryResourceWithRawResponse,
+    AsyncTelemetryResourceWithRawResponse,
+    TelemetryResourceWithStreamingResponse,
+    AsyncTelemetryResourceWithStreamingResponse,
+)
+from .destinations import (
+    DestinationsResource,
+    AsyncDestinationsResource,
+    DestinationsResourceWithRawResponse,
+    AsyncDestinationsResourceWithRawResponse,
+    DestinationsResourceWithStreamingResponse,
+    AsyncDestinationsResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "DestinationsResource",
+    "AsyncDestinationsResource",
+    "DestinationsResourceWithRawResponse",
+    "AsyncDestinationsResourceWithRawResponse",
+    "DestinationsResourceWithStreamingResponse",
+    "AsyncDestinationsResourceWithStreamingResponse",
+    "TelemetryResource",
+    "AsyncTelemetryResource",
+    "TelemetryResourceWithRawResponse",
+    "AsyncTelemetryResourceWithRawResponse",
+    "TelemetryResourceWithStreamingResponse",
+    "AsyncTelemetryResourceWithStreamingResponse",
+]