feat(api): enable typescript

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 170
+configured_endpoints: 173
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/digitalocean%2Fgradient-621c3ebf5011c5ca508f78fccbea17de4ca6b35bfe99578c1ae2265021578d6f.yml
 openapi_spec_hash: e29d14e3e4679fcf22b3e760e49931b1
-config_hash: 6e3aacb34562b5a1ef74bb279f55cbec
+config_hash: 3d425c415b7f7ab581418b43eb521cb3

api.md

@@ -51,6 +51,7 @@ from gradient.types import (
     AgentUpdateResponse,
     AgentListResponse,
     AgentDeleteResponse,
+    AgentRetrieveUsageResponse,
     AgentUpdateStatusResponse,
 )
 ```
@@ -62,6 +63,7 @@ Methods:
 - <code title="put /v2/gen-ai/agents/{uuid}">client.agents.<a href="./src/gradient/resources/agents/agents.py">update</a>(path_uuid, \*\*<a href="src/gradient/types/agent_update_params.py">params</a>) -> <a href="./src/gradient/types/agent_update_response.py">AgentUpdateResponse</a></code>
 - <code title="get /v2/gen-ai/agents">client.agents.<a href="./src/gradient/resources/agents/agents.py">list</a>(\*\*<a href="src/gradient/types/agent_list_params.py">params</a>) -> <a href="./src/gradient/types/agent_list_response.py">AgentListResponse</a></code>
 - <code title="delete /v2/gen-ai/agents/{uuid}">client.agents.<a href="./src/gradient/resources/agents/agents.py">delete</a>(uuid) -> <a href="./src/gradient/types/agent_delete_response.py">AgentDeleteResponse</a></code>
+- <code title="get /v2/gen-ai/agents/{uuid}/usage">client.agents.<a href="./src/gradient/resources/agents/agents.py">retrieve_usage</a>(uuid, \*\*<a href="src/gradient/types/agent_retrieve_usage_params.py">params</a>) -> <a href="./src/gradient/types/agent_retrieve_usage_response.py">AgentRetrieveUsageResponse</a></code>
 - <code title="put /v2/gen-ai/agents/{uuid}/deployment_visibility">client.agents.<a href="./src/gradient/resources/agents/agents.py">update_status</a>(path_uuid, \*\*<a href="src/gradient/types/agent_update_status_params.py">params</a>) -> <a href="./src/gradient/types/agent_update_status_response.py">AgentUpdateStatusResponse</a></code>
 
 ## APIKeys
@@ -214,6 +216,30 @@ Methods:
 - <code title="delete /v2/gen-ai/openai/keys/{api_key_uuid}">client.agents.evaluation_metrics.openai.keys.<a href="./src/gradient/resources/agents/evaluation_metrics/openai/keys.py">delete</a>(api_key_uuid) -> <a href="./src/gradient/types/agents/evaluation_metrics/openai/key_delete_response.py">KeyDeleteResponse</a></code>
 - <code title="get /v2/gen-ai/openai/keys/{uuid}/agents">client.agents.evaluation_metrics.openai.keys.<a href="./src/gradient/resources/agents/evaluation_metrics/openai/keys.py">list_agents</a>(uuid, \*\*<a href="src/gradient/types/agents/evaluation_metrics/openai/key_list_agents_params.py">params</a>) -> <a href="./src/gradient/types/agents/evaluation_metrics/openai/key_list_agents_response.py">KeyListAgentsResponse</a></code>
 
+### Oauth2
+
+Types:
+
+```python
+from gradient.types.agents.evaluation_metrics import Oauth2GenerateURLResponse
+```
+
+Methods:
+
+- <code title="get /v2/gen-ai/oauth2/url">client.agents.evaluation_metrics.oauth2.<a href="./src/gradient/resources/agents/evaluation_metrics/oauth2/oauth2.py">generate_url</a>(\*\*<a href="src/gradient/types/agents/evaluation_metrics/oauth2_generate_url_params.py">params</a>) -> <a href="./src/gradient/types/agents/evaluation_metrics/oauth2_generate_url_response.py">Oauth2GenerateURLResponse</a></code>
+
+#### Dropbox
+
+Types:
+
+```python
+from gradient.types.agents.evaluation_metrics.oauth2 import DropboxCreateTokensResponse
+```
+
+Methods:
+
+- <code title="post /v2/gen-ai/oauth2/dropbox/tokens">client.agents.evaluation_metrics.oauth2.dropbox.<a href="./src/gradient/resources/agents/evaluation_metrics/oauth2/dropbox.py">create_tokens</a>(\*\*<a href="src/gradient/types/agents/evaluation_metrics/oauth2/dropbox_create_tokens_params.py">params</a>) -> <a href="./src/gradient/types/agents/evaluation_metrics/oauth2/dropbox_create_tokens_response.py">DropboxCreateTokensResponse</a></code>
+
 ## EvaluationRuns
 
 Types:

src/gradient/resources/agents/agents.py

@@ -19,6 +19,7 @@
     agent_create_params,
     agent_update_params,
     agent_update_status_params,
+    agent_retrieve_usage_params,
 )
 from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven, SequenceNotStr
 from ..._utils import maybe_transform, async_maybe_transform
@@ -103,6 +104,7 @@
 from ...types.agent_retrieve_response import AgentRetrieveResponse
 from ...types.api_deployment_visibility import APIDeploymentVisibility
 from ...types.agent_update_status_response import AgentUpdateStatusResponse
+from ...types.agent_retrieve_usage_response import AgentRetrieveUsageResponse
 from .evaluation_metrics.evaluation_metrics import (
     EvaluationMetricsResource,
     AsyncEvaluationMetricsResource,
@@ -500,6 +502,59 @@ def delete(
             cast_to=AgentDeleteResponse,
         )
 
+    def retrieve_usage(
+        self,
+        uuid: str,
+        *,
+        start: str | NotGiven = NOT_GIVEN,
+        stop: str | NotGiven = NOT_GIVEN,
+        # 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,
+    ) -> AgentRetrieveUsageResponse:
+        """
+        To get agent usage, send a GET request to `/v2/gen-ai/agents/{uuid}/usage`.
+        Returns usage metrics for the specified agent within the provided time range.
+
+        Args:
+          start: Return all usage data from this date.
+
+          stop: Return all usage data up to this date, if omitted, will return up to the current
+              date.
+
+          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 uuid:
+            raise ValueError(f"Expected a non-empty value for `uuid` but received {uuid!r}")
+        return self._get(
+            f"/v2/gen-ai/agents/{uuid}/usage"
+            if self._client._base_url_overridden
+            else f"https://api.digitalocean.com/v2/gen-ai/agents/{uuid}/usage",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "start": start,
+                        "stop": stop,
+                    },
+                    agent_retrieve_usage_params.AgentRetrieveUsageParams,
+                ),
+            ),
+            cast_to=AgentRetrieveUsageResponse,
+        )
+
     def update_status(
         self,
         path_uuid: str,
@@ -943,6 +998,59 @@ async def delete(
             cast_to=AgentDeleteResponse,
         )
 
+    async def retrieve_usage(
+        self,
+        uuid: str,
+        *,
+        start: str | NotGiven = NOT_GIVEN,
+        stop: str | NotGiven = NOT_GIVEN,
+        # 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,
+    ) -> AgentRetrieveUsageResponse:
+        """
+        To get agent usage, send a GET request to `/v2/gen-ai/agents/{uuid}/usage`.
+        Returns usage metrics for the specified agent within the provided time range.
+
+        Args:
+          start: Return all usage data from this date.
+
+          stop: Return all usage data up to this date, if omitted, will return up to the current
+              date.
+
+          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 uuid:
+            raise ValueError(f"Expected a non-empty value for `uuid` but received {uuid!r}")
+        return await self._get(
+            f"/v2/gen-ai/agents/{uuid}/usage"
+            if self._client._base_url_overridden
+            else f"https://api.digitalocean.com/v2/gen-ai/agents/{uuid}/usage",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "start": start,
+                        "stop": stop,
+                    },
+                    agent_retrieve_usage_params.AgentRetrieveUsageParams,
+                ),
+            ),
+            cast_to=AgentRetrieveUsageResponse,
+        )
+
     async def update_status(
         self,
         path_uuid: str,
@@ -1020,6 +1128,9 @@ def __init__(self, agents: AgentsResource) -> None:
         self.delete = to_raw_response_wrapper(
             agents.delete,
         )
+        self.retrieve_usage = to_raw_response_wrapper(
+            agents.retrieve_usage,
+        )
         self.update_status = to_raw_response_wrapper(
             agents.update_status,
         )
@@ -1084,6 +1195,9 @@ def __init__(self, agents: AsyncAgentsResource) -> None:
         self.delete = async_to_raw_response_wrapper(
             agents.delete,
         )
+        self.retrieve_usage = async_to_raw_response_wrapper(
+            agents.retrieve_usage,
+        )
         self.update_status = async_to_raw_response_wrapper(
             agents.update_status,
         )
@@ -1148,6 +1262,9 @@ def __init__(self, agents: AgentsResource) -> None:
         self.delete = to_streamed_response_wrapper(
             agents.delete,
         )
+        self.retrieve_usage = to_streamed_response_wrapper(
+            agents.retrieve_usage,
+        )
         self.update_status = to_streamed_response_wrapper(
             agents.update_status,
         )
@@ -1212,6 +1329,9 @@ def __init__(self, agents: AsyncAgentsResource) -> None:
         self.delete = async_to_streamed_response_wrapper(
             agents.delete,
         )
+        self.retrieve_usage = async_to_streamed_response_wrapper(
+            agents.retrieve_usage,
+        )
         self.update_status = async_to_streamed_response_wrapper(
             agents.update_status,
         )

src/gradient/resources/agents/evaluation_metrics/__init__.py

@@ -8,6 +8,14 @@
     ModelsResourceWithStreamingResponse,
     AsyncModelsResourceWithStreamingResponse,
 )
+from .oauth2 import (
+    Oauth2Resource,
+    AsyncOauth2Resource,
+    Oauth2ResourceWithRawResponse,
+    AsyncOauth2ResourceWithRawResponse,
+    Oauth2ResourceWithStreamingResponse,
+    AsyncOauth2ResourceWithStreamingResponse,
+)
 from .openai import (
     OpenAIResource,
     AsyncOpenAIResource,
@@ -66,6 +74,12 @@
     "AsyncOpenAIResourceWithRawResponse",
     "OpenAIResourceWithStreamingResponse",
     "AsyncOpenAIResourceWithStreamingResponse",
+    "Oauth2Resource",
+    "AsyncOauth2Resource",
+    "Oauth2ResourceWithRawResponse",
+    "AsyncOauth2ResourceWithRawResponse",
+    "Oauth2ResourceWithStreamingResponse",
+    "AsyncOauth2ResourceWithStreamingResponse",
     "EvaluationMetricsResource",
     "AsyncEvaluationMetricsResource",
     "EvaluationMetricsResourceWithRawResponse",

src/gradient/resources/agents/evaluation_metrics/evaluation_metrics.py

@@ -22,6 +22,14 @@
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
+from .oauth2.oauth2 import (
+    Oauth2Resource,
+    AsyncOauth2Resource,
+    Oauth2ResourceWithRawResponse,
+    AsyncOauth2ResourceWithRawResponse,
+    Oauth2ResourceWithStreamingResponse,
+    AsyncOauth2ResourceWithStreamingResponse,
+)
 from .openai.openai import (
     OpenAIResource,
     AsyncOpenAIResource,
@@ -71,6 +79,10 @@ def anthropic(self) -> AnthropicResource:
     def openai(self) -> OpenAIResource:
         return OpenAIResource(self._client)
 
+    @cached_property
+    def oauth2(self) -> Oauth2Resource:
+        return Oauth2Resource(self._client)
+
     @cached_property
     def with_raw_response(self) -> EvaluationMetricsResourceWithRawResponse:
         """
@@ -180,6 +192,10 @@ def anthropic(self) -> AsyncAnthropicResource:
     def openai(self) -> AsyncOpenAIResource:
         return AsyncOpenAIResource(self._client)
 
+    @cached_property
+    def oauth2(self) -> AsyncOauth2Resource:
+        return AsyncOauth2Resource(self._client)
+
     @cached_property
     def with_raw_response(self) -> AsyncEvaluationMetricsResourceWithRawResponse:
         """
@@ -299,6 +315,10 @@ def anthropic(self) -> AnthropicResourceWithRawResponse:
     def openai(self) -> OpenAIResourceWithRawResponse:
         return OpenAIResourceWithRawResponse(self._evaluation_metrics.openai)
 
+    @cached_property
+    def oauth2(self) -> Oauth2ResourceWithRawResponse:
+        return Oauth2ResourceWithRawResponse(self._evaluation_metrics.oauth2)
+
 
 class AsyncEvaluationMetricsResourceWithRawResponse:
     def __init__(self, evaluation_metrics: AsyncEvaluationMetricsResource) -> None:
@@ -327,6 +347,10 @@ def anthropic(self) -> AsyncAnthropicResourceWithRawResponse:
     def openai(self) -> AsyncOpenAIResourceWithRawResponse:
         return AsyncOpenAIResourceWithRawResponse(self._evaluation_metrics.openai)
 
+    @cached_property
+    def oauth2(self) -> AsyncOauth2ResourceWithRawResponse:
+        return AsyncOauth2ResourceWithRawResponse(self._evaluation_metrics.oauth2)
+
 
 class EvaluationMetricsResourceWithStreamingResponse:
     def __init__(self, evaluation_metrics: EvaluationMetricsResource) -> None:
@@ -355,6 +379,10 @@ def anthropic(self) -> AnthropicResourceWithStreamingResponse:
     def openai(self) -> OpenAIResourceWithStreamingResponse:
         return OpenAIResourceWithStreamingResponse(self._evaluation_metrics.openai)
 
+    @cached_property
+    def oauth2(self) -> Oauth2ResourceWithStreamingResponse:
+        return Oauth2ResourceWithStreamingResponse(self._evaluation_metrics.oauth2)
+
 
 class AsyncEvaluationMetricsResourceWithStreamingResponse:
     def __init__(self, evaluation_metrics: AsyncEvaluationMetricsResource) -> None:
@@ -382,3 +410,7 @@ def anthropic(self) -> AsyncAnthropicResourceWithStreamingResponse:
     @cached_property
     def openai(self) -> AsyncOpenAIResourceWithStreamingResponse:
         return AsyncOpenAIResourceWithStreamingResponse(self._evaluation_metrics.openai)
+
+    @cached_property
+    def oauth2(self) -> AsyncOauth2ResourceWithStreamingResponse:
+        return AsyncOauth2ResourceWithStreamingResponse(self._evaluation_metrics.oauth2)

src/gradient/resources/agents/evaluation_metrics/oauth2/__init__.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .oauth2 import (
+    Oauth2Resource,
+    AsyncOauth2Resource,
+    Oauth2ResourceWithRawResponse,
+    AsyncOauth2ResourceWithRawResponse,
+    Oauth2ResourceWithStreamingResponse,
+    AsyncOauth2ResourceWithStreamingResponse,
+)
+from .dropbox import (
+    DropboxResource,
+    AsyncDropboxResource,
+    DropboxResourceWithRawResponse,
+    AsyncDropboxResourceWithRawResponse,
+    DropboxResourceWithStreamingResponse,
+    AsyncDropboxResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "DropboxResource",
+    "AsyncDropboxResource",
+    "DropboxResourceWithRawResponse",
+    "AsyncDropboxResourceWithRawResponse",
+    "DropboxResourceWithStreamingResponse",
+    "AsyncDropboxResourceWithStreamingResponse",
+    "Oauth2Resource",
+    "AsyncOauth2Resource",
+    "Oauth2ResourceWithRawResponse",
+    "AsyncOauth2ResourceWithRawResponse",
+    "Oauth2ResourceWithStreamingResponse",
+    "AsyncOauth2ResourceWithStreamingResponse",
+]