feat: Mason/agent auth api

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 66
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-2af1b468584cb44aa9babbbfb82bff4055614fbb5c815084a6b7dacc1cf1a822.yml
-openapi_spec_hash: 891affa2849341ea01d62011125f7edc
-config_hash: 9421eb86b7f3f4b274f123279da3858e
+configured_endpoints: 71
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-bb3f37e55117a56e7a4208bd646d3a68adeb651ced8531e13fbfc1fc9dcb05a4.yml
+openapi_spec_hash: 7303ce8ce3130e16a6a5c2bb49e43e9b
+config_hash: be146470fb2d4583b6533859f0fa48f5

api.md

@@ -243,3 +243,38 @@ Methods:
 - <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="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>
+
+# Agents
+
+## Auth
+
+Types:
+
+```python
+from kernel.types.agents import (
+    AgentAuthDiscoverResponse,
+    AgentAuthRunResponse,
+    AgentAuthStartResponse,
+    AgentAuthSubmitResponse,
+    DiscoveredField,
+)
+```
+
+Methods:
+
+- <code title="post /agents/auth/start">client.agents.auth.<a href="./src/kernel/resources/agents/auth/auth.py">start</a>(\*\*<a href="src/kernel/types/agents/auth_start_params.py">params</a>) -> <a href="./src/kernel/types/agents/agent_auth_start_response.py">AgentAuthStartResponse</a></code>
+
+### Runs
+
+Types:
+
+```python
+from kernel.types.agents.auth import RunExchangeResponse
+```
+
+Methods:
+
+- <code title="get /agents/auth/runs/{run_id}">client.agents.auth.runs.<a href="./src/kernel/resources/agents/auth/runs.py">retrieve</a>(run_id) -> <a href="./src/kernel/types/agents/agent_auth_run_response.py">AgentAuthRunResponse</a></code>
+- <code title="post /agents/auth/runs/{run_id}/discover">client.agents.auth.runs.<a href="./src/kernel/resources/agents/auth/runs.py">discover</a>(run_id) -> <a href="./src/kernel/types/agents/agent_auth_discover_response.py">AgentAuthDiscoverResponse</a></code>
+- <code title="post /agents/auth/runs/{run_id}/exchange">client.agents.auth.runs.<a href="./src/kernel/resources/agents/auth/runs.py">exchange</a>(run_id, \*\*<a href="src/kernel/types/agents/auth/run_exchange_params.py">params</a>) -> <a href="./src/kernel/types/agents/auth/run_exchange_response.py">RunExchangeResponse</a></code>
+- <code title="post /agents/auth/runs/{run_id}/submit">client.agents.auth.runs.<a href="./src/kernel/resources/agents/auth/runs.py">submit</a>(run_id, \*\*<a href="src/kernel/types/agents/auth/run_submit_params.py">params</a>) -> <a href="./src/kernel/types/agents/agent_auth_submit_response.py">AgentAuthSubmitResponse</a></code>

src/kernel/_client.py

@@ -29,6 +29,7 @@
     SyncAPIClient,
     AsyncAPIClient,
 )
+from .resources.agents import agents
 from .resources.browsers import browsers
 
 __all__ = [
@@ -57,6 +58,7 @@ class Kernel(SyncAPIClient):
     profiles: profiles.ProfilesResource
     proxies: proxies.ProxiesResource
     extensions: extensions.ExtensionsResource
+    agents: agents.AgentsResource
     with_raw_response: KernelWithRawResponse
     with_streaming_response: KernelWithStreamedResponse
 
@@ -145,6 +147,7 @@ def __init__(
         self.profiles = profiles.ProfilesResource(self)
         self.proxies = proxies.ProxiesResource(self)
         self.extensions = extensions.ExtensionsResource(self)
+        self.agents = agents.AgentsResource(self)
         self.with_raw_response = KernelWithRawResponse(self)
         self.with_streaming_response = KernelWithStreamedResponse(self)
 
@@ -263,6 +266,7 @@ class AsyncKernel(AsyncAPIClient):
     profiles: profiles.AsyncProfilesResource
     proxies: proxies.AsyncProxiesResource
     extensions: extensions.AsyncExtensionsResource
+    agents: agents.AsyncAgentsResource
     with_raw_response: AsyncKernelWithRawResponse
     with_streaming_response: AsyncKernelWithStreamedResponse
 
@@ -351,6 +355,7 @@ def __init__(
         self.profiles = profiles.AsyncProfilesResource(self)
         self.proxies = proxies.AsyncProxiesResource(self)
         self.extensions = extensions.AsyncExtensionsResource(self)
+        self.agents = agents.AsyncAgentsResource(self)
         self.with_raw_response = AsyncKernelWithRawResponse(self)
         self.with_streaming_response = AsyncKernelWithStreamedResponse(self)
 
@@ -470,6 +475,7 @@ def __init__(self, client: Kernel) -> None:
         self.profiles = profiles.ProfilesResourceWithRawResponse(client.profiles)
         self.proxies = proxies.ProxiesResourceWithRawResponse(client.proxies)
         self.extensions = extensions.ExtensionsResourceWithRawResponse(client.extensions)
+        self.agents = agents.AgentsResourceWithRawResponse(client.agents)
 
 
 class AsyncKernelWithRawResponse:
@@ -481,6 +487,7 @@ def __init__(self, client: AsyncKernel) -> None:
         self.profiles = profiles.AsyncProfilesResourceWithRawResponse(client.profiles)
         self.proxies = proxies.AsyncProxiesResourceWithRawResponse(client.proxies)
         self.extensions = extensions.AsyncExtensionsResourceWithRawResponse(client.extensions)
+        self.agents = agents.AsyncAgentsResourceWithRawResponse(client.agents)
 
 
 class KernelWithStreamedResponse:
@@ -492,6 +499,7 @@ def __init__(self, client: Kernel) -> None:
         self.profiles = profiles.ProfilesResourceWithStreamingResponse(client.profiles)
         self.proxies = proxies.ProxiesResourceWithStreamingResponse(client.proxies)
         self.extensions = extensions.ExtensionsResourceWithStreamingResponse(client.extensions)
+        self.agents = agents.AgentsResourceWithStreamingResponse(client.agents)
 
 
 class AsyncKernelWithStreamedResponse:
@@ -503,6 +511,7 @@ def __init__(self, client: AsyncKernel) -> None:
         self.profiles = profiles.AsyncProfilesResourceWithStreamingResponse(client.profiles)
         self.proxies = proxies.AsyncProxiesResourceWithStreamingResponse(client.proxies)
         self.extensions = extensions.AsyncExtensionsResourceWithStreamingResponse(client.extensions)
+        self.agents = agents.AsyncAgentsResourceWithStreamingResponse(client.agents)
 
 
 Client = Kernel

src/kernel/resources/__init__.py

@@ -8,6 +8,14 @@
     AppsResourceWithStreamingResponse,
     AsyncAppsResourceWithStreamingResponse,
 )
+from .agents import (
+    AgentsResource,
+    AsyncAgentsResource,
+    AgentsResourceWithRawResponse,
+    AsyncAgentsResourceWithRawResponse,
+    AgentsResourceWithStreamingResponse,
+    AsyncAgentsResourceWithStreamingResponse,
+)
 from .proxies import (
     ProxiesResource,
     AsyncProxiesResource,
@@ -100,4 +108,10 @@
     "AsyncExtensionsResourceWithRawResponse",
     "ExtensionsResourceWithStreamingResponse",
     "AsyncExtensionsResourceWithStreamingResponse",
+    "AgentsResource",
+    "AsyncAgentsResource",
+    "AgentsResourceWithRawResponse",
+    "AsyncAgentsResourceWithRawResponse",
+    "AgentsResourceWithStreamingResponse",
+    "AsyncAgentsResourceWithStreamingResponse",
 ]

src/kernel/resources/agents/__init__.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .auth import (
+    AuthResource,
+    AsyncAuthResource,
+    AuthResourceWithRawResponse,
+    AsyncAuthResourceWithRawResponse,
+    AuthResourceWithStreamingResponse,
+    AsyncAuthResourceWithStreamingResponse,
+)
+from .agents import (
+    AgentsResource,
+    AsyncAgentsResource,
+    AgentsResourceWithRawResponse,
+    AsyncAgentsResourceWithRawResponse,
+    AgentsResourceWithStreamingResponse,
+    AsyncAgentsResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "AuthResource",
+    "AsyncAuthResource",
+    "AuthResourceWithRawResponse",
+    "AsyncAuthResourceWithRawResponse",
+    "AuthResourceWithStreamingResponse",
+    "AsyncAuthResourceWithStreamingResponse",
+    "AgentsResource",
+    "AsyncAgentsResource",
+    "AgentsResourceWithRawResponse",
+    "AsyncAgentsResourceWithRawResponse",
+    "AgentsResourceWithStreamingResponse",
+    "AsyncAgentsResourceWithStreamingResponse",
+]

src/kernel/resources/agents/agents.py

@@ -0,0 +1,102 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from ..._compat import cached_property
+from .auth.auth import (
+    AuthResource,
+    AsyncAuthResource,
+    AuthResourceWithRawResponse,
+    AsyncAuthResourceWithRawResponse,
+    AuthResourceWithStreamingResponse,
+    AsyncAuthResourceWithStreamingResponse,
+)
+from ..._resource import SyncAPIResource, AsyncAPIResource
+
+__all__ = ["AgentsResource", "AsyncAgentsResource"]
+
+
+class AgentsResource(SyncAPIResource):
+    @cached_property
+    def auth(self) -> AuthResource:
+        return AuthResource(self._client)
+
+    @cached_property
+    def with_raw_response(self) -> AgentsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/onkernel/kernel-python-sdk#accessing-raw-response-data-eg-headers
+        """
+        return AgentsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AgentsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/onkernel/kernel-python-sdk#with_streaming_response
+        """
+        return AgentsResourceWithStreamingResponse(self)
+
+
+class AsyncAgentsResource(AsyncAPIResource):
+    @cached_property
+    def auth(self) -> AsyncAuthResource:
+        return AsyncAuthResource(self._client)
+
+    @cached_property
+    def with_raw_response(self) -> AsyncAgentsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/onkernel/kernel-python-sdk#accessing-raw-response-data-eg-headers
+        """
+        return AsyncAgentsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncAgentsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/onkernel/kernel-python-sdk#with_streaming_response
+        """
+        return AsyncAgentsResourceWithStreamingResponse(self)
+
+
+class AgentsResourceWithRawResponse:
+    def __init__(self, agents: AgentsResource) -> None:
+        self._agents = agents
+
+    @cached_property
+    def auth(self) -> AuthResourceWithRawResponse:
+        return AuthResourceWithRawResponse(self._agents.auth)
+
+
+class AsyncAgentsResourceWithRawResponse:
+    def __init__(self, agents: AsyncAgentsResource) -> None:
+        self._agents = agents
+
+    @cached_property
+    def auth(self) -> AsyncAuthResourceWithRawResponse:
+        return AsyncAuthResourceWithRawResponse(self._agents.auth)
+
+
+class AgentsResourceWithStreamingResponse:
+    def __init__(self, agents: AgentsResource) -> None:
+        self._agents = agents
+
+    @cached_property
+    def auth(self) -> AuthResourceWithStreamingResponse:
+        return AuthResourceWithStreamingResponse(self._agents.auth)
+
+
+class AsyncAgentsResourceWithStreamingResponse:
+    def __init__(self, agents: AsyncAgentsResource) -> None:
+        self._agents = agents
+
+    @cached_property
+    def auth(self) -> AsyncAuthResourceWithStreamingResponse:
+        return AsyncAuthResourceWithStreamingResponse(self._agents.auth)

src/kernel/resources/agents/auth/__init__.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .auth import (
+    AuthResource,
+    AsyncAuthResource,
+    AuthResourceWithRawResponse,
+    AsyncAuthResourceWithRawResponse,
+    AuthResourceWithStreamingResponse,
+    AsyncAuthResourceWithStreamingResponse,
+)
+from .runs import (
+    RunsResource,
+    AsyncRunsResource,
+    RunsResourceWithRawResponse,
+    AsyncRunsResourceWithRawResponse,
+    RunsResourceWithStreamingResponse,
+    AsyncRunsResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "RunsResource",
+    "AsyncRunsResource",
+    "RunsResourceWithRawResponse",
+    "AsyncRunsResourceWithRawResponse",
+    "RunsResourceWithStreamingResponse",
+    "AsyncRunsResourceWithStreamingResponse",
+    "AuthResource",
+    "AsyncAuthResource",
+    "AuthResourceWithRawResponse",
+    "AsyncAuthResourceWithRawResponse",
+    "AuthResourceWithStreamingResponse",
+    "AsyncAuthResourceWithStreamingResponse",
+]