relaxai 0.2.1__tar.gz → 0.3.0__tar.gz

relaxai-0.3.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.3.0"
+}

{relaxai-0.2.1 → relaxai-0.3.0}/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.3.0 (2025-10-15)
+
+Full Changelog: [v0.2.1...v0.3.0](https://github.com/relax-ai/python-sdk/compare/v0.2.1...v0.3.0)
+
+### Features
+
+* **api:** manual updates ([fb55fbb](https://github.com/relax-ai/python-sdk/commit/fb55fbbad43d0e9e451cd478fdc245c13ac902d5))
+* **api:** manual updates ([01862ef](https://github.com/relax-ai/python-sdk/commit/01862efe3dbab403d0b375368dfc1abe7da8c207))
+* **api:** manual updates ([a87f00a](https://github.com/relax-ai/python-sdk/commit/a87f00af92db246737d129211b1288624cc968fd))
+* improve future compat with pydantic v3 ([e6f68a5](https://github.com/relax-ai/python-sdk/commit/e6f68a526ac50b2a439770d778e1f7bf024614e2))
+* **types:** replace List[str] with SequenceNotStr in params ([151f372](https://github.com/relax-ai/python-sdk/commit/151f372fe9393e0a4d6e276a0590608730c7db31))
+
+
+### Chores
+
+* do not install brew dependencies in ./scripts/bootstrap by default ([4e5f72f](https://github.com/relax-ai/python-sdk/commit/4e5f72f42aa9931746d4883dc8fdcc0c458d5696))
+* **internal:** add Sequence related utils ([d2984db](https://github.com/relax-ai/python-sdk/commit/d2984db3cfd795659892617f88bc36e77f69d379))
+* **internal:** detect missing future annotations with ruff ([826ae50](https://github.com/relax-ai/python-sdk/commit/826ae504f63ac7182e4420547b83003e7d7edc34))
+* **internal:** move mypy configurations to `pyproject.toml` file ([466a932](https://github.com/relax-ai/python-sdk/commit/466a932633583de1e75b3d2574fd189c4997637e))
+* **internal:** update pydantic dependency ([453c07f](https://github.com/relax-ai/python-sdk/commit/453c07f92fa1f2a54c0d80b282d3404199d8e455))
+* **internal:** update pyright exclude list ([b38f5fa](https://github.com/relax-ai/python-sdk/commit/b38f5fafdf9a2ae1ce03e5750472582000289bc8))
+* **tests:** simplify `get_platform` test ([9c5443b](https://github.com/relax-ai/python-sdk/commit/9c5443be195c8eb14a40c211fe4ce25c4a701113))
+* **types:** change optional parameter type from NotGiven to Omit ([9fc9e2f](https://github.com/relax-ai/python-sdk/commit/9fc9e2fa695f30d157d2bae209b41ae2204076bb))
+
 ## 0.2.1 (2025-08-27)
 
 Full Changelog: [v0.2.0...v0.2.1](https://github.com/relax-ai/python-sdk/compare/v0.2.0...v0.2.1)

{relaxai-0.2.1 → relaxai-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: relaxai
-Version: 0.2.1
+Version: 0.3.0
 Summary: The official Python library for the relaxai API
 Project-URL: Homepage, https://github.com/relax-ai/python-sdk
 Project-URL: Repository, https://github.com/relax-ai/python-sdk

{relaxai-0.2.1 → relaxai-0.3.0}/api.md

@@ -60,3 +60,27 @@ Methods:
 
 - <code title="get /v1/models">client.models.<a href="./src/relaxai/resources/models.py">list_models</a>() -> <a href="./src/relaxai/types/model_list.py">ModelList</a></code>
 - <code title="get /v1/models/{model}">client.models.<a href="./src/relaxai/resources/models.py">retrieve_model</a>(model) -> <a href="./src/relaxai/types/model.py">Model</a></code>
+
+# Tools
+
+Types:
+
+```python
+from relaxai.types import ToolRequest, ToolResponse
+```
+
+Methods:
+
+- <code title="post /v1/tools/code">client.tools.<a href="./src/relaxai/resources/tools.py">execute_code</a>(\*\*<a href="src/relaxai/types/tool_execute_code_params.py">params</a>) -> None</code>
+
+# DeepResearch
+
+Types:
+
+```python
+from relaxai.types import DeepresearchRequest, DeepresearchResponse
+```
+
+Methods:
+
+- <code title="post /v1/deep-research">client.deep_research.<a href="./src/relaxai/resources/deep_research.py">create</a>(\*\*<a href="src/relaxai/types/deep_research_create_params.py">params</a>) -> None</code>

{relaxai-0.2.1 → relaxai-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "relaxai"
-version = "0.2.1"
+version = "0.3.0"
 description = "The official Python library for the relaxai API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -56,7 +56,6 @@ dev-dependencies = [
     "dirty-equals>=0.6.0",
     "importlib-metadata>=6.7.0",
     "rich>=13.7.1",
-    "nest_asyncio==1.6.0",
     "pytest-xdist>=3.6.1",
 ]
 
@@ -148,6 +147,7 @@ exclude = [
     "_dev",
     ".venv",
     ".nox",
+    ".git",
 ]
 
 reportImplicitOverride = true
@@ -156,6 +156,58 @@ reportOverlappingOverload = false
 reportImportCycles = false
 reportPrivateUsage = false
 
+[tool.mypy]
+pretty = true
+show_error_codes = true
+
+# Exclude _files.py because mypy isn't smart enough to apply
+# the correct type narrowing and as this is an internal module
+# it's fine to just use Pyright.
+#
+# We also exclude our `tests` as mypy doesn't always infer
+# types correctly and Pyright will still catch any type errors.
+exclude = ['src/relaxai/_files.py', '_dev/.*.py', 'tests/.*']
+
+strict_equality = true
+implicit_reexport = true
+check_untyped_defs = true
+no_implicit_optional = true
+
+warn_return_any = true
+warn_unreachable = true
+warn_unused_configs = true
+
+# Turn these options off as it could cause conflicts
+# with the Pyright options.
+warn_unused_ignores = false
+warn_redundant_casts = false
+
+disallow_any_generics = true
+disallow_untyped_defs = true
+disallow_untyped_calls = true
+disallow_subclassing_any = true
+disallow_incomplete_defs = true
+disallow_untyped_decorators = true
+cache_fine_grained = true
+
+# By default, mypy reports an error if you assign a value to the result
+# of a function call that doesn't return anything. We do this in our test
+# cases:
+# ```
+# result = ...
+# assert result is None
+# ```
+# Changing this codegen to make mypy happy would increase complexity
+# and would not be worth it.
+disable_error_code = "func-returns-value,overload-cannot-match"
+
+# https://github.com/python/mypy/issues/12162
+[[tool.mypy.overrides]]
+module = "black.files.*"
+ignore_errors = true
+ignore_missing_imports = true
+
+
 [tool.ruff]
 line-length = 120
 output-format = "grouped"
@@ -172,6 +224,8 @@ select = [
   "B",
   # remove unused imports
   "F401",
+  # check for missing future annotations
+  "FA102",
   # bare except statements
   "E722",
   # unused arguments
@@ -194,6 +248,8 @@ unfixable = [
   "T203",
 ]
 
+extend-safe-fixes = ["FA102"]
+
 [tool.ruff.lint.flake8-tidy-imports.banned-api]
 "functools.lru_cache".msg = "This function does not retain type information for the wrapped function's arguments; The `lru_cache` function from `_utils` should be used instead"
 

{relaxai-0.2.1 → relaxai-0.3.0}/requirements-dev.lock

@@ -75,7 +75,6 @@ multidict==6.4.4
 mypy==1.14.1
 mypy-extensions==1.0.0
     # via mypy
-nest-asyncio==1.6.0
 nodeenv==1.8.0
     # via pyright
 nox==2023.4.22
@@ -89,9 +88,9 @@ pluggy==1.5.0
 propcache==0.3.1
     # via aiohttp
     # via yarl
-pydantic==2.10.3
+pydantic==2.11.9
     # via relaxai
-pydantic-core==2.27.1
+pydantic-core==2.33.2
     # via pydantic
 pygments==2.18.0
     # via rich
@@ -127,6 +126,9 @@ typing-extensions==4.12.2
     # via pydantic-core
     # via pyright
     # via relaxai
+    # via typing-inspection
+typing-inspection==0.4.1
+    # via pydantic
 virtualenv==20.24.5
     # via nox
 yarl==1.20.0

{relaxai-0.2.1 → relaxai-0.3.0}/requirements.lock

@@ -55,9 +55,9 @@ multidict==6.4.4
 propcache==0.3.1
     # via aiohttp
     # via yarl
-pydantic==2.10.3
+pydantic==2.11.9
     # via relaxai
-pydantic-core==2.27.1
+pydantic-core==2.33.2
     # via pydantic
 sniffio==1.3.0
     # via anyio
@@ -68,5 +68,8 @@ typing-extensions==4.12.2
     # via pydantic
     # via pydantic-core
     # via relaxai
+    # via typing-inspection
+typing-inspection==0.4.1
+    # via pydantic
 yarl==1.20.0
     # via aiohttp

{relaxai-0.2.1 → relaxai-0.3.0}/src/relaxai/__init__.py

@@ -3,7 +3,7 @@
 import typing as _t
 
 from . import types
-from ._types import NOT_GIVEN, Omit, NoneType, NotGiven, Transport, ProxiesTypes
+from ._types import NOT_GIVEN, Omit, NoneType, NotGiven, Transport, ProxiesTypes, omit, not_given
 from ._utils import file_from_path
 from ._client import Client, Stream, Relaxai, Timeout, Transport, AsyncClient, AsyncStream, AsyncRelaxai, RequestOptions
 from ._models import BaseModel
@@ -38,7 +38,9 @@ __all__ = [
     "ProxiesTypes",
     "NotGiven",
     "NOT_GIVEN",
+    "not_given",
     "Omit",
+    "omit",
     "RelaxaiError",
     "APIError",
     "APIStatusError",

{relaxai-0.2.1 → relaxai-0.3.0}/src/relaxai/_base_client.py

@@ -42,7 +42,6 @@ from . import _exceptions
 from ._qs import Querystring
 from ._files import to_httpx_files, async_to_httpx_files
 from ._types import (
-    NOT_GIVEN,
     Body,
     Omit,
     Query,
@@ -57,9 +56,10 @@ from ._types import (
     RequestOptions,
     HttpxRequestFiles,
     ModelBuilderProtocol,
+    not_given,
 )
 from ._utils import is_dict, is_list, asyncify, is_given, lru_cache, is_mapping
-from ._compat import PYDANTIC_V2, model_copy, model_dump
+from ._compat import PYDANTIC_V1, model_copy, model_dump
 from ._models import GenericModel, FinalRequestOptions, validate_type, construct_type
 from ._response import (
     APIResponse,
@@ -145,9 +145,9 @@ class PageInfo:
     def __init__(
         self,
         *,
-        url: URL | NotGiven = NOT_GIVEN,
-        json: Body | NotGiven = NOT_GIVEN,
-        params: Query | NotGiven = NOT_GIVEN,
+        url: URL | NotGiven = not_given,
+        json: Body | NotGiven = not_given,
+        params: Query | NotGiven = not_given,
     ) -> None:
         self.url = url
         self.json = json
@@ -232,7 +232,7 @@ class BaseSyncPage(BasePage[_T], Generic[_T]):
         model: Type[_T],
         options: FinalRequestOptions,
     ) -> None:
-        if PYDANTIC_V2 and getattr(self, "__pydantic_private__", None) is None:
+        if (not PYDANTIC_V1) and getattr(self, "__pydantic_private__", None) is None:
             self.__pydantic_private__ = {}
 
         self._model = model
@@ -320,7 +320,7 @@ class BaseAsyncPage(BasePage[_T], Generic[_T]):
         client: AsyncAPIClient,
         options: FinalRequestOptions,
     ) -> None:
-        if PYDANTIC_V2 and getattr(self, "__pydantic_private__", None) is None:
+        if (not PYDANTIC_V1) and getattr(self, "__pydantic_private__", None) is None:
             self.__pydantic_private__ = {}
 
         self._model = model
@@ -595,7 +595,7 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
         # we internally support defining a temporary header to override the
         # default `cast_to` type for use with `.with_raw_response` and `.with_streaming_response`
         # see _response.py for implementation details
-        override_cast_to = headers.pop(OVERRIDE_CAST_TO_HEADER, NOT_GIVEN)
+        override_cast_to = headers.pop(OVERRIDE_CAST_TO_HEADER, not_given)
         if is_given(override_cast_to):
             options.headers = headers
             return cast(Type[ResponseT], override_cast_to)
@@ -825,7 +825,7 @@ class SyncAPIClient(BaseClient[httpx.Client, Stream[Any]]):
         version: str,
         base_url: str | URL,
         max_retries: int = DEFAULT_MAX_RETRIES,
-        timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | Timeout | None | NotGiven = not_given,
         http_client: httpx.Client | None = None,
         custom_headers: Mapping[str, str] | None = None,
         custom_query: Mapping[str, object] | None = None,
@@ -1356,7 +1356,7 @@ class AsyncAPIClient(BaseClient[httpx.AsyncClient, AsyncStream[Any]]):
         base_url: str | URL,
         _strict_response_validation: bool,
         max_retries: int = DEFAULT_MAX_RETRIES,
-        timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | Timeout | None | NotGiven = not_given,
         http_client: httpx.AsyncClient | None = None,
         custom_headers: Mapping[str, str] | None = None,
         custom_query: Mapping[str, object] | None = None,
@@ -1818,8 +1818,8 @@ def make_request_options(
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     idempotency_key: str | None = None,
-    timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    post_parser: PostParser | NotGiven = NOT_GIVEN,
+    timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    post_parser: PostParser | NotGiven = not_given,
 ) -> RequestOptions:
     """Create a dict of type RequestOptions without keys of NotGiven values."""
     options: RequestOptions = {}

{relaxai-0.2.1 → relaxai-0.3.0}/src/relaxai/_client.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 import os
-from typing import Any, Union, Mapping
+from typing import Any, Mapping
 from typing_extensions import Self, override
 
 import httpx
@@ -11,7 +11,6 @@ import httpx
 from . import _exceptions
 from ._qs import Querystring
 from ._types import (
-    NOT_GIVEN,
     Body,
     Omit,
     Query,
@@ -21,6 +20,7 @@ from ._types import (
     Transport,
     ProxiesTypes,
     RequestOptions,
+    not_given,
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
@@ -30,7 +30,7 @@ from ._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
-from .resources import chat, models, embeddings
+from .resources import chat, tools, models, embeddings, deep_research
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import RelaxaiError, APIStatusError
 from ._base_client import (
@@ -47,6 +47,8 @@ class Relaxai(SyncAPIClient):
     chat: chat.ChatResource
     embeddings: embeddings.EmbeddingsResource
     models: models.ModelsResource
+    tools: tools.ToolsResource
+    deep_research: deep_research.DeepResearchResource
     with_raw_response: RelaxaiWithRawResponse
     with_streaming_response: RelaxaiWithStreamedResponse
 
@@ -58,7 +60,7 @@ class Relaxai(SyncAPIClient):
         *,
         api_key: str | None = None,
         base_url: str | httpx.URL | None = None,
-        timeout: Union[float, Timeout, None, NotGiven] = NOT_GIVEN,
+        timeout: float | Timeout | None | NotGiven = not_given,
         max_retries: int = DEFAULT_MAX_RETRIES,
         default_headers: Mapping[str, str] | None = None,
         default_query: Mapping[str, object] | None = None,
@@ -107,6 +109,8 @@ class Relaxai(SyncAPIClient):
         self.chat = chat.ChatResource(self)
         self.embeddings = embeddings.EmbeddingsResource(self)
         self.models = models.ModelsResource(self)
+        self.tools = tools.ToolsResource(self)
+        self.deep_research = deep_research.DeepResearchResource(self)
         self.with_raw_response = RelaxaiWithRawResponse(self)
         self.with_streaming_response = RelaxaiWithStreamedResponse(self)
 
@@ -135,9 +139,9 @@ class Relaxai(SyncAPIClient):
         *,
         api_key: str | None = None,
         base_url: str | httpx.URL | None = None,
-        timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | Timeout | None | NotGiven = not_given,
         http_client: httpx.Client | None = None,
-        max_retries: int | NotGiven = NOT_GIVEN,
+        max_retries: int | NotGiven = not_given,
         default_headers: Mapping[str, str] | None = None,
         set_default_headers: Mapping[str, str] | None = None,
         default_query: Mapping[str, object] | None = None,
@@ -189,7 +193,7 @@ class Relaxai(SyncAPIClient):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> str:
         """Check the health of the service."""
         return self.get(
@@ -238,6 +242,8 @@ class AsyncRelaxai(AsyncAPIClient):
     chat: chat.AsyncChatResource
     embeddings: embeddings.AsyncEmbeddingsResource
     models: models.AsyncModelsResource
+    tools: tools.AsyncToolsResource
+    deep_research: deep_research.AsyncDeepResearchResource
     with_raw_response: AsyncRelaxaiWithRawResponse
     with_streaming_response: AsyncRelaxaiWithStreamedResponse
 
@@ -249,7 +255,7 @@ class AsyncRelaxai(AsyncAPIClient):
         *,
         api_key: str | None = None,
         base_url: str | httpx.URL | None = None,
-        timeout: Union[float, Timeout, None, NotGiven] = NOT_GIVEN,
+        timeout: float | Timeout | None | NotGiven = not_given,
         max_retries: int = DEFAULT_MAX_RETRIES,
         default_headers: Mapping[str, str] | None = None,
         default_query: Mapping[str, object] | None = None,
@@ -298,6 +304,8 @@ class AsyncRelaxai(AsyncAPIClient):
         self.chat = chat.AsyncChatResource(self)
         self.embeddings = embeddings.AsyncEmbeddingsResource(self)
         self.models = models.AsyncModelsResource(self)
+        self.tools = tools.AsyncToolsResource(self)
+        self.deep_research = deep_research.AsyncDeepResearchResource(self)
         self.with_raw_response = AsyncRelaxaiWithRawResponse(self)
         self.with_streaming_response = AsyncRelaxaiWithStreamedResponse(self)
 
@@ -326,9 +334,9 @@ class AsyncRelaxai(AsyncAPIClient):
         *,
         api_key: str | None = None,
         base_url: str | httpx.URL | None = None,
-        timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | Timeout | None | NotGiven = not_given,
         http_client: httpx.AsyncClient | None = None,
-        max_retries: int | NotGiven = NOT_GIVEN,
+        max_retries: int | NotGiven = not_given,
         default_headers: Mapping[str, str] | None = None,
         set_default_headers: Mapping[str, str] | None = None,
         default_query: Mapping[str, object] | None = None,
@@ -380,7 +388,7 @@ class AsyncRelaxai(AsyncAPIClient):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> str:
         """Check the health of the service."""
         return await self.get(
@@ -430,6 +438,8 @@ class RelaxaiWithRawResponse:
         self.chat = chat.ChatResourceWithRawResponse(client.chat)
         self.embeddings = embeddings.EmbeddingsResourceWithRawResponse(client.embeddings)
         self.models = models.ModelsResourceWithRawResponse(client.models)
+        self.tools = tools.ToolsResourceWithRawResponse(client.tools)
+        self.deep_research = deep_research.DeepResearchResourceWithRawResponse(client.deep_research)
 
         self.health = to_raw_response_wrapper(
             client.health,
@@ -441,6 +451,8 @@ class AsyncRelaxaiWithRawResponse:
         self.chat = chat.AsyncChatResourceWithRawResponse(client.chat)
         self.embeddings = embeddings.AsyncEmbeddingsResourceWithRawResponse(client.embeddings)
         self.models = models.AsyncModelsResourceWithRawResponse(client.models)
+        self.tools = tools.AsyncToolsResourceWithRawResponse(client.tools)
+        self.deep_research = deep_research.AsyncDeepResearchResourceWithRawResponse(client.deep_research)
 
         self.health = async_to_raw_response_wrapper(
             client.health,
@@ -452,6 +464,8 @@ class RelaxaiWithStreamedResponse:
         self.chat = chat.ChatResourceWithStreamingResponse(client.chat)
         self.embeddings = embeddings.EmbeddingsResourceWithStreamingResponse(client.embeddings)
         self.models = models.ModelsResourceWithStreamingResponse(client.models)
+        self.tools = tools.ToolsResourceWithStreamingResponse(client.tools)
+        self.deep_research = deep_research.DeepResearchResourceWithStreamingResponse(client.deep_research)
 
         self.health = to_streamed_response_wrapper(
             client.health,
@@ -463,6 +477,8 @@ class AsyncRelaxaiWithStreamedResponse:
         self.chat = chat.AsyncChatResourceWithStreamingResponse(client.chat)
         self.embeddings = embeddings.AsyncEmbeddingsResourceWithStreamingResponse(client.embeddings)
         self.models = models.AsyncModelsResourceWithStreamingResponse(client.models)
+        self.tools = tools.AsyncToolsResourceWithStreamingResponse(client.tools)
+        self.deep_research = deep_research.AsyncDeepResearchResourceWithStreamingResponse(client.deep_research)
 
         self.health = async_to_streamed_response_wrapper(
             client.health,