c63a5cfe-b235-4fbe-8bbb-82a9e02a482a-python 0.1.0a3__py3-none-any.whl

digitalocean_genai_sdk/resources/providers/openai/openai.py

@@ -0,0 +1,102 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .keys import (
+    KeysResource,
+    AsyncKeysResource,
+    KeysResourceWithRawResponse,
+    AsyncKeysResourceWithRawResponse,
+    KeysResourceWithStreamingResponse,
+    AsyncKeysResourceWithStreamingResponse,
+)
+from ...._compat import cached_property
+from ...._resource import SyncAPIResource, AsyncAPIResource
+
+__all__ = ["OpenAIResource", "AsyncOpenAIResource"]
+
+
+class OpenAIResource(SyncAPIResource):
+    @cached_property
+    def keys(self) -> KeysResource:
+        return KeysResource(self._client)
+
+    @cached_property
+    def with_raw_response(self) -> OpenAIResourceWithRawResponse:
+        """
+        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/digitalocean/genai-python#accessing-raw-response-data-eg-headers
+        """
+        return OpenAIResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> OpenAIResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/digitalocean/genai-python#with_streaming_response
+        """
+        return OpenAIResourceWithStreamingResponse(self)
+
+
+class AsyncOpenAIResource(AsyncAPIResource):
+    @cached_property
+    def keys(self) -> AsyncKeysResource:
+        return AsyncKeysResource(self._client)
+
+    @cached_property
+    def with_raw_response(self) -> AsyncOpenAIResourceWithRawResponse:
+        """
+        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/digitalocean/genai-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncOpenAIResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncOpenAIResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/digitalocean/genai-python#with_streaming_response
+        """
+        return AsyncOpenAIResourceWithStreamingResponse(self)
+
+
+class OpenAIResourceWithRawResponse:
+    def __init__(self, openai: OpenAIResource) -> None:
+        self._openai = openai
+
+    @cached_property
+    def keys(self) -> KeysResourceWithRawResponse:
+        return KeysResourceWithRawResponse(self._openai.keys)
+
+
+class AsyncOpenAIResourceWithRawResponse:
+    def __init__(self, openai: AsyncOpenAIResource) -> None:
+        self._openai = openai
+
+    @cached_property
+    def keys(self) -> AsyncKeysResourceWithRawResponse:
+        return AsyncKeysResourceWithRawResponse(self._openai.keys)
+
+
+class OpenAIResourceWithStreamingResponse:
+    def __init__(self, openai: OpenAIResource) -> None:
+        self._openai = openai
+
+    @cached_property
+    def keys(self) -> KeysResourceWithStreamingResponse:
+        return KeysResourceWithStreamingResponse(self._openai.keys)
+
+
+class AsyncOpenAIResourceWithStreamingResponse:
+    def __init__(self, openai: AsyncOpenAIResource) -> None:
+        self._openai = openai
+
+    @cached_property
+    def keys(self) -> AsyncKeysResourceWithStreamingResponse:
+        return AsyncKeysResourceWithStreamingResponse(self._openai.keys)

digitalocean_genai_sdk/resources/providers/providers.py

@@ -0,0 +1,134 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from ..._compat import cached_property
+from ..._resource import SyncAPIResource, AsyncAPIResource
+from .openai.openai import (
+    OpenAIResource,
+    AsyncOpenAIResource,
+    OpenAIResourceWithRawResponse,
+    AsyncOpenAIResourceWithRawResponse,
+    OpenAIResourceWithStreamingResponse,
+    AsyncOpenAIResourceWithStreamingResponse,
+)
+from .anthropic.anthropic import (
+    AnthropicResource,
+    AsyncAnthropicResource,
+    AnthropicResourceWithRawResponse,
+    AsyncAnthropicResourceWithRawResponse,
+    AnthropicResourceWithStreamingResponse,
+    AsyncAnthropicResourceWithStreamingResponse,
+)
+
+__all__ = ["ProvidersResource", "AsyncProvidersResource"]
+
+
+class ProvidersResource(SyncAPIResource):
+    @cached_property
+    def anthropic(self) -> AnthropicResource:
+        return AnthropicResource(self._client)
+
+    @cached_property
+    def openai(self) -> OpenAIResource:
+        return OpenAIResource(self._client)
+
+    @cached_property
+    def with_raw_response(self) -> ProvidersResourceWithRawResponse:
+        """
+        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/digitalocean/genai-python#accessing-raw-response-data-eg-headers
+        """
+        return ProvidersResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> ProvidersResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/digitalocean/genai-python#with_streaming_response
+        """
+        return ProvidersResourceWithStreamingResponse(self)
+
+
+class AsyncProvidersResource(AsyncAPIResource):
+    @cached_property
+    def anthropic(self) -> AsyncAnthropicResource:
+        return AsyncAnthropicResource(self._client)
+
+    @cached_property
+    def openai(self) -> AsyncOpenAIResource:
+        return AsyncOpenAIResource(self._client)
+
+    @cached_property
+    def with_raw_response(self) -> AsyncProvidersResourceWithRawResponse:
+        """
+        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/digitalocean/genai-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncProvidersResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncProvidersResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/digitalocean/genai-python#with_streaming_response
+        """
+        return AsyncProvidersResourceWithStreamingResponse(self)
+
+
+class ProvidersResourceWithRawResponse:
+    def __init__(self, providers: ProvidersResource) -> None:
+        self._providers = providers
+
+    @cached_property
+    def anthropic(self) -> AnthropicResourceWithRawResponse:
+        return AnthropicResourceWithRawResponse(self._providers.anthropic)
+
+    @cached_property
+    def openai(self) -> OpenAIResourceWithRawResponse:
+        return OpenAIResourceWithRawResponse(self._providers.openai)
+
+
+class AsyncProvidersResourceWithRawResponse:
+    def __init__(self, providers: AsyncProvidersResource) -> None:
+        self._providers = providers
+
+    @cached_property
+    def anthropic(self) -> AsyncAnthropicResourceWithRawResponse:
+        return AsyncAnthropicResourceWithRawResponse(self._providers.anthropic)
+
+    @cached_property
+    def openai(self) -> AsyncOpenAIResourceWithRawResponse:
+        return AsyncOpenAIResourceWithRawResponse(self._providers.openai)
+
+
+class ProvidersResourceWithStreamingResponse:
+    def __init__(self, providers: ProvidersResource) -> None:
+        self._providers = providers
+
+    @cached_property
+    def anthropic(self) -> AnthropicResourceWithStreamingResponse:
+        return AnthropicResourceWithStreamingResponse(self._providers.anthropic)
+
+    @cached_property
+    def openai(self) -> OpenAIResourceWithStreamingResponse:
+        return OpenAIResourceWithStreamingResponse(self._providers.openai)
+
+
+class AsyncProvidersResourceWithStreamingResponse:
+    def __init__(self, providers: AsyncProvidersResource) -> None:
+        self._providers = providers
+
+    @cached_property
+    def anthropic(self) -> AsyncAnthropicResourceWithStreamingResponse:
+        return AsyncAnthropicResourceWithStreamingResponse(self._providers.anthropic)
+
+    @cached_property
+    def openai(self) -> AsyncOpenAIResourceWithStreamingResponse:
+        return AsyncOpenAIResourceWithStreamingResponse(self._providers.openai)

digitalocean_genai_sdk/resources/regions.py

@@ -0,0 +1,191 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import httpx
+
+from ..types import region_list_params
+from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from .._utils import maybe_transform, async_maybe_transform
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .._base_client import make_request_options
+from ..types.region_list_response import RegionListResponse
+
+__all__ = ["RegionsResource", "AsyncRegionsResource"]
+
+
+class RegionsResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> RegionsResourceWithRawResponse:
+        """
+        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/digitalocean/genai-python#accessing-raw-response-data-eg-headers
+        """
+        return RegionsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> RegionsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/digitalocean/genai-python#with_streaming_response
+        """
+        return RegionsResourceWithStreamingResponse(self)
+
+    def list(
+        self,
+        *,
+        serves_batch: bool | NotGiven = NOT_GIVEN,
+        serves_inference: bool | 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,
+    ) -> RegionListResponse:
+        """
+        To list all datacenter regions, send a GET request to `/v2/gen-ai/regions`.
+
+        Args:
+          serves_batch: include datacenters that are capable of running batch jobs.
+
+          serves_inference: include datacenters that serve inference.
+
+          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
+        """
+        return self._get(
+            "/v2/genai/regions",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "serves_batch": serves_batch,
+                        "serves_inference": serves_inference,
+                    },
+                    region_list_params.RegionListParams,
+                ),
+            ),
+            cast_to=RegionListResponse,
+        )
+
+
+class AsyncRegionsResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncRegionsResourceWithRawResponse:
+        """
+        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/digitalocean/genai-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncRegionsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncRegionsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/digitalocean/genai-python#with_streaming_response
+        """
+        return AsyncRegionsResourceWithStreamingResponse(self)
+
+    async def list(
+        self,
+        *,
+        serves_batch: bool | NotGiven = NOT_GIVEN,
+        serves_inference: bool | 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,
+    ) -> RegionListResponse:
+        """
+        To list all datacenter regions, send a GET request to `/v2/gen-ai/regions`.
+
+        Args:
+          serves_batch: include datacenters that are capable of running batch jobs.
+
+          serves_inference: include datacenters that serve inference.
+
+          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
+        """
+        return await self._get(
+            "/v2/genai/regions",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "serves_batch": serves_batch,
+                        "serves_inference": serves_inference,
+                    },
+                    region_list_params.RegionListParams,
+                ),
+            ),
+            cast_to=RegionListResponse,
+        )
+
+
+class RegionsResourceWithRawResponse:
+    def __init__(self, regions: RegionsResource) -> None:
+        self._regions = regions
+
+        self.list = to_raw_response_wrapper(
+            regions.list,
+        )
+
+
+class AsyncRegionsResourceWithRawResponse:
+    def __init__(self, regions: AsyncRegionsResource) -> None:
+        self._regions = regions
+
+        self.list = async_to_raw_response_wrapper(
+            regions.list,
+        )
+
+
+class RegionsResourceWithStreamingResponse:
+    def __init__(self, regions: RegionsResource) -> None:
+        self._regions = regions
+
+        self.list = to_streamed_response_wrapper(
+            regions.list,
+        )
+
+
+class AsyncRegionsResourceWithStreamingResponse:
+    def __init__(self, regions: AsyncRegionsResource) -> None:
+        self._regions = regions
+
+        self.list = async_to_streamed_response_wrapper(
+            regions.list,
+        )

digitalocean_genai_sdk/types/__init__.py

@@ -0,0 +1,57 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .model import Model as Model
+from .api_agent import APIAgent as APIAgent
+from .api_model import APIModel as APIModel
+from .api_agreement import APIAgreement as APIAgreement
+from .api_indexing_job import APIIndexingJob as APIIndexingJob
+from .agent_list_params import AgentListParams as AgentListParams
+from .api_model_version import APIModelVersion as APIModelVersion
+from .api_knowledge_base import APIKnowledgeBase as APIKnowledgeBase
+from .region_list_params import RegionListParams as RegionListParams
+from .agent_create_params import AgentCreateParams as AgentCreateParams
+from .agent_list_response import AgentListResponse as AgentListResponse
+from .agent_update_params import AgentUpdateParams as AgentUpdateParams
+from .api_key_list_params import APIKeyListParams as APIKeyListParams
+from .model_list_response import ModelListResponse as ModelListResponse
+from .api_retrieval_method import APIRetrievalMethod as APIRetrievalMethod
+from .region_list_response import RegionListResponse as RegionListResponse
+from .agent_create_response import AgentCreateResponse as AgentCreateResponse
+from .agent_delete_response import AgentDeleteResponse as AgentDeleteResponse
+from .agent_update_response import AgentUpdateResponse as AgentUpdateResponse
+from .api_key_list_response import APIKeyListResponse as APIKeyListResponse
+from .api_agent_api_key_info import APIAgentAPIKeyInfo as APIAgentAPIKeyInfo
+from .agent_retrieve_response import AgentRetrieveResponse as AgentRetrieveResponse
+from .api_openai_api_key_info import APIOpenAIAPIKeyInfo as APIOpenAIAPIKeyInfo
+from .embedding_create_params import EmbeddingCreateParams as EmbeddingCreateParams
+from .indexing_job_list_params import IndexingJobListParams as IndexingJobListParams
+from .api_deployment_visibility import APIDeploymentVisibility as APIDeploymentVisibility
+from .embedding_create_response import EmbeddingCreateResponse as EmbeddingCreateResponse
+from .agent_update_status_params import AgentUpdateStatusParams as AgentUpdateStatusParams
+from .api_anthropic_api_key_info import APIAnthropicAPIKeyInfo as APIAnthropicAPIKeyInfo
+from .indexing_job_create_params import IndexingJobCreateParams as IndexingJobCreateParams
+from .indexing_job_list_response import IndexingJobListResponse as IndexingJobListResponse
+from .knowledge_base_list_params import KnowledgeBaseListParams as KnowledgeBaseListParams
+from .agent_update_status_response import AgentUpdateStatusResponse as AgentUpdateStatusResponse
+from .indexing_job_create_response import IndexingJobCreateResponse as IndexingJobCreateResponse
+from .knowledge_base_create_params import KnowledgeBaseCreateParams as KnowledgeBaseCreateParams
+from .knowledge_base_list_response import KnowledgeBaseListResponse as KnowledgeBaseListResponse
+from .knowledge_base_update_params import KnowledgeBaseUpdateParams as KnowledgeBaseUpdateParams
+from .chat_completion_token_logprob import ChatCompletionTokenLogprob as ChatCompletionTokenLogprob
+from .chat_create_completion_params import ChatCreateCompletionParams as ChatCreateCompletionParams
+from .indexing_job_retrieve_response import IndexingJobRetrieveResponse as IndexingJobRetrieveResponse
+from .knowledge_base_create_response import KnowledgeBaseCreateResponse as KnowledgeBaseCreateResponse
+from .knowledge_base_delete_response import KnowledgeBaseDeleteResponse as KnowledgeBaseDeleteResponse
+from .knowledge_base_update_response import KnowledgeBaseUpdateResponse as KnowledgeBaseUpdateResponse
+from .chat_create_completion_response import ChatCreateCompletionResponse as ChatCreateCompletionResponse
+from .knowledge_base_retrieve_response import KnowledgeBaseRetrieveResponse as KnowledgeBaseRetrieveResponse
+from .indexing_job_update_cancel_params import IndexingJobUpdateCancelParams as IndexingJobUpdateCancelParams
+from .indexing_job_update_cancel_response import IndexingJobUpdateCancelResponse as IndexingJobUpdateCancelResponse
+from .indexing_job_retrieve_data_sources_response import (
+    IndexingJobRetrieveDataSourcesResponse as IndexingJobRetrieveDataSourcesResponse,
+)
+from .chat_completion_request_message_content_part_text_param import (
+    ChatCompletionRequestMessageContentPartTextParam as ChatCompletionRequestMessageContentPartTextParam,
+)

digitalocean_genai_sdk/types/agent_create_params.py

@@ -0,0 +1,39 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List
+from typing_extensions import Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["AgentCreateParams"]
+
+
+class AgentCreateParams(TypedDict, total=False):
+    anthropic_key_uuid: str
+
+    description: str
+
+    instruction: str
+    """Agent instruction.
+
+    Instructions help your agent to perform its job effectively. See
+    [Write Effective Agent Instructions](https://docs.digitalocean.com/products/genai-platform/concepts/best-practices/#agent-instructions)
+    for best practices.
+    """
+
+    knowledge_base_uuid: List[str]
+
+    model_uuid: str
+    """Identifier for the foundation model."""
+
+    name: str
+
+    openai_key_uuid: Annotated[str, PropertyInfo(alias="open_ai_key_uuid")]
+
+    project_id: str
+
+    region: str
+
+    tags: List[str]

digitalocean_genai_sdk/types/agent_create_response.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+
+from .._models import BaseModel
+
+__all__ = ["AgentCreateResponse"]
+
+
+class AgentCreateResponse(BaseModel):
+    agent: Optional["APIAgent"] = None
+
+
+from .api_agent import APIAgent

digitalocean_genai_sdk/types/agent_delete_response.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+
+from .._models import BaseModel
+
+__all__ = ["AgentDeleteResponse"]
+
+
+class AgentDeleteResponse(BaseModel):
+    agent: Optional["APIAgent"] = None
+
+
+from .api_agent import APIAgent

digitalocean_genai_sdk/types/agent_list_params.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["AgentListParams"]
+
+
+class AgentListParams(TypedDict, total=False):
+    only_deployed: bool
+    """only list agents that are deployed."""
+
+    page: int
+    """page number."""
+
+    per_page: int
+    """items per page."""