athena-intelligence 0.1.40__py3-none-any.whl → 0.1.42__py3-none-any.whl

athena/__init__.py

@@ -2,20 +2,23 @@
 
 from .types import (
     Dataset,
+    Document,
+    ExcecuteToolFirstWorkflowOut,
     FirecrawlScrapeUrlDataReponseDto,
     FirecrawlScrapeUrlMetadata,
     GetDatasetsResponse,
     GetSnippetsResponse,
     HttpValidationError,
+    LangchainDocumentsRequestOut,
     MessageOut,
     MessageOutDto,
     Model,
     Report,
-    ScrapeMarkdownResult,
     Snippet,
     SqlResults,
     StatusEnum,
     StructuredParseResult,
+    ToolModels,
     Tools,
     UrlResult,
     ValidationError,
@@ -23,27 +26,30 @@ from .types import (
 )
 from .errors import UnprocessableEntityError
 from . import chain, dataset, message, query, report, search, snippet, tools
-from .chain import StructuredToolDataParsingModel
+from .chain import StructuredParseInParsingModel
 from .environment import AthenaEnvironment
 
 __all__ = [
     "AthenaEnvironment",
     "Dataset",
+    "Document",
+    "ExcecuteToolFirstWorkflowOut",
     "FirecrawlScrapeUrlDataReponseDto",
     "FirecrawlScrapeUrlMetadata",
     "GetDatasetsResponse",
     "GetSnippetsResponse",
     "HttpValidationError",
+    "LangchainDocumentsRequestOut",
     "MessageOut",
     "MessageOutDto",
     "Model",
     "Report",
-    "ScrapeMarkdownResult",
     "Snippet",
     "SqlResults",
     "StatusEnum",
+    "StructuredParseInParsingModel",
     "StructuredParseResult",
-    "StructuredToolDataParsingModel",
+    "ToolModels",
     "Tools",
     "UnprocessableEntityError",
     "UrlResult",

athena/chain/__init__.py

@@ -1,5 +1,5 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from .types import StructuredToolDataParsingModel
+from .types import StructuredParseInParsingModel
 
-__all__ = ["StructuredToolDataParsingModel"]
+__all__ = ["StructuredParseInParsingModel"]

athena/chain/client.py

@@ -12,7 +12,7 @@ from ..core.request_options import RequestOptions
 from ..errors.unprocessable_entity_error import UnprocessableEntityError
 from ..types.http_validation_error import HttpValidationError
 from ..types.structured_parse_result import StructuredParseResult
-from .types.structured_tool_data_parsing_model import StructuredToolDataParsingModel
+from .types.structured_parse_in_parsing_model import StructuredParseInParsingModel
 
 try:
     import pydantic.v1 as pydantic  # type: ignore
@@ -32,7 +32,7 @@ class ChainClient:
         *,
         text_input: str,
         custom_type_dict: typing.Dict[str, typing.Any],
-        parsing_model: typing.Optional[StructuredToolDataParsingModel] = OMIT,
+        parsing_model: typing.Optional[StructuredParseInParsingModel] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> StructuredParseResult:
         """
@@ -41,19 +41,19 @@ class ChainClient:
 
             - custom_type_dict: typing.Dict[str, typing.Any]. A dictionary of field names and their default values.
 
-            - parsing_model: typing.Optional[StructuredToolDataParsingModel]. The model to be used for parsing.
+            - parsing_model: typing.Optional[StructuredParseInParsingModel]. The model to be used for parsing.
 
             - request_options: typing.Optional[RequestOptions]. Request-specific configuration.
         ---
+        from athena import StructuredParseInParsingModel
         from athena.client import Athena
 
-        client = Athena(
-            api_key="YOUR_API_KEY",
-        )
-        client.chain.structured_parse(
-            text_input="text_input",
-            custom_type_dict={},
-        )
+        client = Athena(api_key="YOUR_API_KEY", )
+        client.chain.structured_parse(text_input='Athena is an AI-native analytics platform and artificial employee built to accelerate analytics workflows
+                        by offering enterprise teams co-pilot and auto-pilot modes. Athena learns your workflow as a co-pilot,
+                        allowing you to hand over controls to her for autonomous execution with confidence."
+
+                        Give me all of the modes Athena provides.', custom_type_dict={"modes": {}}, parsing_model=StructuredParseInParsingModel.GPT_4_TURBO, )
         """
         _request: typing.Dict[str, typing.Any] = {"text_input": text_input, "custom_type_dict": custom_type_dict}
         if parsing_model is not OMIT:
@@ -104,7 +104,7 @@ class AsyncChainClient:
         *,
         text_input: str,
         custom_type_dict: typing.Dict[str, typing.Any],
-        parsing_model: typing.Optional[StructuredToolDataParsingModel] = OMIT,
+        parsing_model: typing.Optional[StructuredParseInParsingModel] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> StructuredParseResult:
         """
@@ -113,19 +113,19 @@ class AsyncChainClient:
 
             - custom_type_dict: typing.Dict[str, typing.Any]. A dictionary of field names and their default values.
 
-            - parsing_model: typing.Optional[StructuredToolDataParsingModel]. The model to be used for parsing.
+            - parsing_model: typing.Optional[StructuredParseInParsingModel]. The model to be used for parsing.
 
             - request_options: typing.Optional[RequestOptions]. Request-specific configuration.
         ---
+        from athena import StructuredParseInParsingModel
         from athena.client import AsyncAthena
 
-        client = AsyncAthena(
-            api_key="YOUR_API_KEY",
-        )
-        await client.chain.structured_parse(
-            text_input="text_input",
-            custom_type_dict={},
-        )
+        client = AsyncAthena(api_key="YOUR_API_KEY", )
+        await client.chain.structured_parse(text_input='Athena is an AI-native analytics platform and artificial employee built to accelerate analytics workflows
+                        by offering enterprise teams co-pilot and auto-pilot modes. Athena learns your workflow as a co-pilot,
+                        allowing you to hand over controls to her for autonomous execution with confidence."
+
+                        Give me all of the modes Athena provides.', custom_type_dict={"modes": {}}, parsing_model=StructuredParseInParsingModel.GPT_4_TURBO, )
         """
         _request: typing.Dict[str, typing.Any] = {"text_input": text_input, "custom_type_dict": custom_type_dict}
         if parsing_model is not OMIT:

athena/chain/types/__init__.py

@@ -1,5 +1,5 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from .structured_tool_data_parsing_model import StructuredToolDataParsingModel
+from .structured_parse_in_parsing_model import StructuredParseInParsingModel
 
-__all__ = ["StructuredToolDataParsingModel"]
+__all__ = ["StructuredParseInParsingModel"]

athena/chain/types/{structured_tool_data_parsing_model.py → structured_parse_in_parsing_model.py}

@@ -6,7 +6,7 @@ import typing
 T_Result = typing.TypeVar("T_Result")
 
 
-class StructuredToolDataParsingModel(str, enum.Enum):
+class StructuredParseInParsingModel(str, enum.Enum):
     """
     The model to be used for parsing.
     """
@@ -33,21 +33,21 @@ class StructuredToolDataParsingModel(str, enum.Enum):
         claude_3_sonnet_20240229: typing.Callable[[], T_Result],
         claude_3_haiku_20240307: typing.Callable[[], T_Result],
     ) -> T_Result:
-        if self is StructuredToolDataParsingModel.GPT_4_TURBO:
+        if self is StructuredParseInParsingModel.GPT_4_TURBO:
             return gpt_4_turbo()
-        if self is StructuredToolDataParsingModel.GPT_4_TURBO_PREVIEW:
+        if self is StructuredParseInParsingModel.GPT_4_TURBO_PREVIEW:
             return gpt_4_turbo_preview()
-        if self is StructuredToolDataParsingModel.GPT_4:
+        if self is StructuredParseInParsingModel.GPT_4:
             return gpt_4()
-        if self is StructuredToolDataParsingModel.GPT_35_TURBO:
+        if self is StructuredParseInParsingModel.GPT_35_TURBO:
             return gpt_35_turbo()
-        if self is StructuredToolDataParsingModel.MIXTRAL_SMALL_8_X_7_B_0211:
+        if self is StructuredParseInParsingModel.MIXTRAL_SMALL_8_X_7_B_0211:
             return mixtral_small_8_x_7_b_0211()
-        if self is StructuredToolDataParsingModel.MISTRAL_LARGE_0224:
+        if self is StructuredParseInParsingModel.MISTRAL_LARGE_0224:
             return mistral_large_0224()
-        if self is StructuredToolDataParsingModel.CLAUDE_3_OPUS_20240229:
+        if self is StructuredParseInParsingModel.CLAUDE_3_OPUS_20240229:
             return claude_3_opus_20240229()
-        if self is StructuredToolDataParsingModel.CLAUDE_3_SONNET_20240229:
+        if self is StructuredParseInParsingModel.CLAUDE_3_SONNET_20240229:
             return claude_3_sonnet_20240229()
-        if self is StructuredToolDataParsingModel.CLAUDE_3_HAIKU_20240307:
+        if self is StructuredParseInParsingModel.CLAUDE_3_HAIKU_20240307:
             return claude_3_haiku_20240307()

athena/core/client_wrapper.py

@@ -16,7 +16,7 @@ class BaseClientWrapper:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "athena-intelligence",
-            "X-Fern-SDK-Version": "0.1.40",
+            "X-Fern-SDK-Version": "0.1.42",
         }
         headers["X-API-KEY"] = self.api_key
         return headers

athena/search/client.py

@@ -11,7 +11,6 @@ from ..core.remove_none_from_dict import remove_none_from_dict
 from ..core.request_options import RequestOptions
 from ..errors.unprocessable_entity_error import UnprocessableEntityError
 from ..types.http_validation_error import HttpValidationError
-from ..types.scrape_markdown_result import ScrapeMarkdownResult
 from ..types.url_result import UrlResult
 
 try:
@@ -60,9 +59,9 @@ class SearchClient:
             api_key="YOUR_API_KEY",
         )
         client.search.get_urls(
-            query="query",
-            num_urls=1,
-            tbs="tbs",
+            query="Dogs",
+            num_urls=10,
+            tbs="qdr:m",
         )
         """
         _request: typing.Dict[str, typing.Any] = {"query": query, "num_urls": num_urls, "tbs": tbs}
@@ -74,7 +73,7 @@ class SearchClient:
             _request["site"] = site
         _response = self._client_wrapper.httpx_client.request(
             "POST",
-            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v0/get-urls"),
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v0/tools/search/get-urls"),
             params=jsonable_encoder(
                 request_options.get("additional_query_parameters") if request_options is not None else None
             ),
@@ -108,60 +107,6 @@ class SearchClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def get_markdown(
-        self, *, url: str, request_options: typing.Optional[RequestOptions] = None
-    ) -> ScrapeMarkdownResult:
-        """
-        Parameters:
-            - url: str.
-
-            - request_options: typing.Optional[RequestOptions]. Request-specific configuration.
-        ---
-        from athena.client import Athena
-
-        client = Athena(
-            api_key="YOUR_API_KEY",
-        )
-        client.search.get_markdown(
-            url="url",
-        )
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            "POST",
-            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v0/get-markdown"),
-            params=jsonable_encoder(
-                request_options.get("additional_query_parameters") if request_options is not None else None
-            ),
-            json=jsonable_encoder({"url": url})
-            if request_options is None or request_options.get("additional_body_parameters") is None
-            else {
-                **jsonable_encoder({"url": url}),
-                **(jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {})))),
-            },
-            headers=jsonable_encoder(
-                remove_none_from_dict(
-                    {
-                        **self._client_wrapper.get_headers(),
-                        **(request_options.get("additional_headers", {}) if request_options is not None else {}),
-                    }
-                )
-            ),
-            timeout=request_options.get("timeout_in_seconds")
-            if request_options is not None and request_options.get("timeout_in_seconds") is not None
-            else 60,
-            retries=0,
-            max_retries=request_options.get("max_retries") if request_options is not None else 0,  # type: ignore
-        )
-        if 200 <= _response.status_code < 300:
-            return pydantic.parse_obj_as(ScrapeMarkdownResult, _response.json())  # type: ignore
-        if _response.status_code == 422:
-            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
-        try:
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
-
 
 class AsyncSearchClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
@@ -200,9 +145,9 @@ class AsyncSearchClient:
             api_key="YOUR_API_KEY",
         )
         await client.search.get_urls(
-            query="query",
-            num_urls=1,
-            tbs="tbs",
+            query="Dogs",
+            num_urls=10,
+            tbs="qdr:m",
         )
         """
         _request: typing.Dict[str, typing.Any] = {"query": query, "num_urls": num_urls, "tbs": tbs}
@@ -214,7 +159,7 @@ class AsyncSearchClient:
             _request["site"] = site
         _response = await self._client_wrapper.httpx_client.request(
             "POST",
-            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v0/get-urls"),
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v0/tools/search/get-urls"),
             params=jsonable_encoder(
                 request_options.get("additional_query_parameters") if request_options is not None else None
             ),
@@ -247,57 +192,3 @@ class AsyncSearchClient:
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
-
-    async def get_markdown(
-        self, *, url: str, request_options: typing.Optional[RequestOptions] = None
-    ) -> ScrapeMarkdownResult:
-        """
-        Parameters:
-            - url: str.
-
-            - request_options: typing.Optional[RequestOptions]. Request-specific configuration.
-        ---
-        from athena.client import AsyncAthena
-
-        client = AsyncAthena(
-            api_key="YOUR_API_KEY",
-        )
-        await client.search.get_markdown(
-            url="url",
-        )
-        """
-        _response = await self._client_wrapper.httpx_client.request(
-            "POST",
-            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v0/get-markdown"),
-            params=jsonable_encoder(
-                request_options.get("additional_query_parameters") if request_options is not None else None
-            ),
-            json=jsonable_encoder({"url": url})
-            if request_options is None or request_options.get("additional_body_parameters") is None
-            else {
-                **jsonable_encoder({"url": url}),
-                **(jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {})))),
-            },
-            headers=jsonable_encoder(
-                remove_none_from_dict(
-                    {
-                        **self._client_wrapper.get_headers(),
-                        **(request_options.get("additional_headers", {}) if request_options is not None else {}),
-                    }
-                )
-            ),
-            timeout=request_options.get("timeout_in_seconds")
-            if request_options is not None and request_options.get("timeout_in_seconds") is not None
-            else 60,
-            retries=0,
-            max_retries=request_options.get("max_retries") if request_options is not None else 0,  # type: ignore
-        )
-        if 200 <= _response.status_code < 300:
-            return pydantic.parse_obj_as(ScrapeMarkdownResult, _response.json())  # type: ignore
-        if _response.status_code == 422:
-            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
-        try:
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)

athena/tools/client.py

@@ -10,8 +10,11 @@ from ..core.jsonable_encoder import jsonable_encoder
 from ..core.remove_none_from_dict import remove_none_from_dict
 from ..core.request_options import RequestOptions
 from ..errors.unprocessable_entity_error import UnprocessableEntityError
+from ..types.excecute_tool_first_workflow_out import ExcecuteToolFirstWorkflowOut
 from ..types.firecrawl_scrape_url_data_reponse_dto import FirecrawlScrapeUrlDataReponseDto
 from ..types.http_validation_error import HttpValidationError
+from ..types.langchain_documents_request_out import LangchainDocumentsRequestOut
+from ..types.tool_models import ToolModels
 
 try:
     import pydantic.v1 as pydantic  # type: ignore
@@ -89,6 +92,151 @@ class ToolsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def langchain_documents(
+        self,
+        *,
+        document_id: str,
+        pagination_limit: typing.Optional[int] = OMIT,
+        pagination_offset: typing.Optional[int] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> LangchainDocumentsRequestOut:
+        """
+        Parameters:
+            - document_id: str.
+
+            - pagination_limit: typing.Optional[int].
+
+            - pagination_offset: typing.Optional[int].
+
+            - request_options: typing.Optional[RequestOptions]. Request-specific configuration.
+        ---
+        from athena.client import Athena
+
+        client = Athena(
+            api_key="YOUR_API_KEY",
+        )
+        client.tools.langchain_documents(
+            document_id="doc_9249292-d118-42d3-95b4-00eccfe0754f",
+            pagination_limit=250,
+            pagination_offset=0,
+        )
+        """
+        _request: typing.Dict[str, typing.Any] = {"document_id": document_id}
+        if pagination_limit is not OMIT:
+            _request["pagination_limit"] = pagination_limit
+        if pagination_offset is not OMIT:
+            _request["pagination_offset"] = pagination_offset
+        _response = self._client_wrapper.httpx_client.request(
+            "POST",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v0/tools/file/langchain-documents"),
+            params=jsonable_encoder(
+                request_options.get("additional_query_parameters") if request_options is not None else None
+            ),
+            json=jsonable_encoder(_request)
+            if request_options is None or request_options.get("additional_body_parameters") is None
+            else {
+                **jsonable_encoder(_request),
+                **(jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {})))),
+            },
+            headers=jsonable_encoder(
+                remove_none_from_dict(
+                    {
+                        **self._client_wrapper.get_headers(),
+                        **(request_options.get("additional_headers", {}) if request_options is not None else {}),
+                    }
+                )
+            ),
+            timeout=request_options.get("timeout_in_seconds")
+            if request_options is not None and request_options.get("timeout_in_seconds") is not None
+            else 60,
+            retries=0,
+            max_retries=request_options.get("max_retries") if request_options is not None else 0,  # type: ignore
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(LangchainDocumentsRequestOut, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    def tool_first_workflow(
+        self,
+        *,
+        model: typing.Optional[ToolModels] = OMIT,
+        tool_name: str,
+        content: str,
+        tool_kwargs: typing.Optional[typing.Dict[str, typing.Any]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ExcecuteToolFirstWorkflowOut:
+        """
+        Parameters:
+            - model: typing.Optional[ToolModels].
+
+            - tool_name: str.
+
+            - content: str.
+
+            - tool_kwargs: typing.Optional[typing.Dict[str, typing.Any]].
+
+            - request_options: typing.Optional[RequestOptions]. Request-specific configuration.
+        ---
+        from athena import ToolModels
+        from athena.client import Athena
+
+        client = Athena(
+            api_key="YOUR_API_KEY",
+        )
+        client.tools.tool_first_workflow(
+            model=ToolModels.MISTRAL_LARGE_0224,
+            tool_name="tavily_search",
+            content="summarize the website in one paragraph",
+            tool_kwargs={"query": "website: www.athenaintelligence.ai"},
+        )
+        """
+        _request: typing.Dict[str, typing.Any] = {"tool_name": tool_name, "content": content}
+        if model is not OMIT:
+            _request["model"] = model
+        if tool_kwargs is not OMIT:
+            _request["tool_kwargs"] = tool_kwargs
+        _response = self._client_wrapper.httpx_client.request(
+            "POST",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v0/tools/first-agent"),
+            params=jsonable_encoder(
+                request_options.get("additional_query_parameters") if request_options is not None else None
+            ),
+            json=jsonable_encoder(_request)
+            if request_options is None or request_options.get("additional_body_parameters") is None
+            else {
+                **jsonable_encoder(_request),
+                **(jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {})))),
+            },
+            headers=jsonable_encoder(
+                remove_none_from_dict(
+                    {
+                        **self._client_wrapper.get_headers(),
+                        **(request_options.get("additional_headers", {}) if request_options is not None else {}),
+                    }
+                )
+            ),
+            timeout=request_options.get("timeout_in_seconds")
+            if request_options is not None and request_options.get("timeout_in_seconds") is not None
+            else 60,
+            retries=0,
+            max_retries=request_options.get("max_retries") if request_options is not None else 0,  # type: ignore
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(ExcecuteToolFirstWorkflowOut, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
 
 class AsyncToolsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
@@ -156,3 +304,148 @@ class AsyncToolsClient:
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def langchain_documents(
+        self,
+        *,
+        document_id: str,
+        pagination_limit: typing.Optional[int] = OMIT,
+        pagination_offset: typing.Optional[int] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> LangchainDocumentsRequestOut:
+        """
+        Parameters:
+            - document_id: str.
+
+            - pagination_limit: typing.Optional[int].
+
+            - pagination_offset: typing.Optional[int].
+
+            - request_options: typing.Optional[RequestOptions]. Request-specific configuration.
+        ---
+        from athena.client import AsyncAthena
+
+        client = AsyncAthena(
+            api_key="YOUR_API_KEY",
+        )
+        await client.tools.langchain_documents(
+            document_id="doc_9249292-d118-42d3-95b4-00eccfe0754f",
+            pagination_limit=250,
+            pagination_offset=0,
+        )
+        """
+        _request: typing.Dict[str, typing.Any] = {"document_id": document_id}
+        if pagination_limit is not OMIT:
+            _request["pagination_limit"] = pagination_limit
+        if pagination_offset is not OMIT:
+            _request["pagination_offset"] = pagination_offset
+        _response = await self._client_wrapper.httpx_client.request(
+            "POST",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v0/tools/file/langchain-documents"),
+            params=jsonable_encoder(
+                request_options.get("additional_query_parameters") if request_options is not None else None
+            ),
+            json=jsonable_encoder(_request)
+            if request_options is None or request_options.get("additional_body_parameters") is None
+            else {
+                **jsonable_encoder(_request),
+                **(jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {})))),
+            },
+            headers=jsonable_encoder(
+                remove_none_from_dict(
+                    {
+                        **self._client_wrapper.get_headers(),
+                        **(request_options.get("additional_headers", {}) if request_options is not None else {}),
+                    }
+                )
+            ),
+            timeout=request_options.get("timeout_in_seconds")
+            if request_options is not None and request_options.get("timeout_in_seconds") is not None
+            else 60,
+            retries=0,
+            max_retries=request_options.get("max_retries") if request_options is not None else 0,  # type: ignore
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(LangchainDocumentsRequestOut, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def tool_first_workflow(
+        self,
+        *,
+        model: typing.Optional[ToolModels] = OMIT,
+        tool_name: str,
+        content: str,
+        tool_kwargs: typing.Optional[typing.Dict[str, typing.Any]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ExcecuteToolFirstWorkflowOut:
+        """
+        Parameters:
+            - model: typing.Optional[ToolModels].
+
+            - tool_name: str.
+
+            - content: str.
+
+            - tool_kwargs: typing.Optional[typing.Dict[str, typing.Any]].
+
+            - request_options: typing.Optional[RequestOptions]. Request-specific configuration.
+        ---
+        from athena import ToolModels
+        from athena.client import AsyncAthena
+
+        client = AsyncAthena(
+            api_key="YOUR_API_KEY",
+        )
+        await client.tools.tool_first_workflow(
+            model=ToolModels.MISTRAL_LARGE_0224,
+            tool_name="tavily_search",
+            content="summarize the website in one paragraph",
+            tool_kwargs={"query": "website: www.athenaintelligence.ai"},
+        )
+        """
+        _request: typing.Dict[str, typing.Any] = {"tool_name": tool_name, "content": content}
+        if model is not OMIT:
+            _request["model"] = model
+        if tool_kwargs is not OMIT:
+            _request["tool_kwargs"] = tool_kwargs
+        _response = await self._client_wrapper.httpx_client.request(
+            "POST",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v0/tools/first-agent"),
+            params=jsonable_encoder(
+                request_options.get("additional_query_parameters") if request_options is not None else None
+            ),
+            json=jsonable_encoder(_request)
+            if request_options is None or request_options.get("additional_body_parameters") is None
+            else {
+                **jsonable_encoder(_request),
+                **(jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {})))),
+            },
+            headers=jsonable_encoder(
+                remove_none_from_dict(
+                    {
+                        **self._client_wrapper.get_headers(),
+                        **(request_options.get("additional_headers", {}) if request_options is not None else {}),
+                    }
+                )
+            ),
+            timeout=request_options.get("timeout_in_seconds")
+            if request_options is not None and request_options.get("timeout_in_seconds") is not None
+            else 60,
+            retries=0,
+            max_retries=request_options.get("max_retries") if request_options is not None else 0,  # type: ignore
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(ExcecuteToolFirstWorkflowOut, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)

athena/types/__init__.py

@@ -1,20 +1,23 @@
 # This file was auto-generated by Fern from our API Definition.
 
 from .dataset import Dataset
+from .document import Document
+from .excecute_tool_first_workflow_out import ExcecuteToolFirstWorkflowOut
 from .firecrawl_scrape_url_data_reponse_dto import FirecrawlScrapeUrlDataReponseDto
 from .firecrawl_scrape_url_metadata import FirecrawlScrapeUrlMetadata
 from .get_datasets_response import GetDatasetsResponse
 from .get_snippets_response import GetSnippetsResponse
 from .http_validation_error import HttpValidationError
+from .langchain_documents_request_out import LangchainDocumentsRequestOut
 from .message_out import MessageOut
 from .message_out_dto import MessageOutDto
 from .model import Model
 from .report import Report
-from .scrape_markdown_result import ScrapeMarkdownResult
 from .snippet import Snippet
 from .sql_results import SqlResults
 from .status_enum import StatusEnum
 from .structured_parse_result import StructuredParseResult
+from .tool_models import ToolModels
 from .tools import Tools
 from .url_result import UrlResult
 from .validation_error import ValidationError
@@ -22,20 +25,23 @@ from .validation_error_loc_item import ValidationErrorLocItem
 
 __all__ = [
     "Dataset",
+    "Document",
+    "ExcecuteToolFirstWorkflowOut",
     "FirecrawlScrapeUrlDataReponseDto",
     "FirecrawlScrapeUrlMetadata",
     "GetDatasetsResponse",
     "GetSnippetsResponse",
     "HttpValidationError",
+    "LangchainDocumentsRequestOut",
     "MessageOut",
     "MessageOutDto",
     "Model",
     "Report",
-    "ScrapeMarkdownResult",
     "Snippet",
     "SqlResults",
     "StatusEnum",
     "StructuredParseResult",
+    "ToolModels",
     "Tools",
     "UrlResult",
     "ValidationError",

athena/types/document.py

@@ -0,0 +1,34 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+from ..core.datetime_utils import serialize_datetime
+
+try:
+    import pydantic.v1 as pydantic  # type: ignore
+except ImportError:
+    import pydantic  # type: ignore
+
+
+class Document(pydantic.BaseModel):
+    """
+    Class for storing a piece of text and associated metadata.
+    """
+
+    page_content: str
+    metadata: typing.Optional[typing.Dict[str, typing.Any]] = None
+    type: typing.Optional[typing.Literal["Document"]] = None
+
+    def json(self, **kwargs: typing.Any) -> str:
+        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
+        return super().json(**kwargs_with_defaults)
+
+    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
+        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
+        return super().dict(**kwargs_with_defaults)
+
+    class Config:
+        frozen = True
+        smart_union = True
+        json_encoders = {dt.datetime: serialize_datetime}

athena/types/{scrape_markdown_result.py → excecute_tool_first_workflow_out.py}

@@ -11,8 +11,8 @@ except ImportError:
     import pydantic  # type: ignore
 
 
-class ScrapeMarkdownResult(pydantic.BaseModel):
-    markdown: str
+class ExcecuteToolFirstWorkflowOut(pydantic.BaseModel):
+    output_message: str
 
     def json(self, **kwargs: typing.Any) -> str:
         kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}

athena/types/langchain_documents_request_out.py

@@ -0,0 +1,29 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+from ..core.datetime_utils import serialize_datetime
+from .document import Document
+
+try:
+    import pydantic.v1 as pydantic  # type: ignore
+except ImportError:
+    import pydantic  # type: ignore
+
+
+class LangchainDocumentsRequestOut(pydantic.BaseModel):
+    documents: typing.List[Document]
+
+    def json(self, **kwargs: typing.Any) -> str:
+        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
+        return super().json(**kwargs_with_defaults)
+
+    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
+        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
+        return super().dict(**kwargs_with_defaults)
+
+    class Config:
+        frozen = True
+        smart_union = True
+        json_encoders = {dt.datetime: serialize_datetime}

athena/types/tool_models.py

@@ -0,0 +1,49 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import enum
+import typing
+
+T_Result = typing.TypeVar("T_Result")
+
+
+class ToolModels(str, enum.Enum):
+    """
+    An enumeration.
+    """
+
+    GPT_4_TURBO = "gpt-4-turbo"
+    GPT_4_TURBO_PREVIEW = "gpt-4-turbo-preview"
+    GPT_4 = "gpt-4"
+    MIXTRAL_SMALL_8_X_7_B_0211 = "mixtral-small-8x7b-0211"
+    MISTRAL_LARGE_0224 = "mistral-large-0224"
+    CLAUDE_3_OPUS_20240229 = "claude-3-opus-20240229"
+    CLAUDE_3_SONNET_20240229 = "claude-3-sonnet-20240229"
+    CLAUDE_3_HAIKU_20240307 = "claude-3-haiku-20240307"
+
+    def visit(
+        self,
+        gpt_4_turbo: typing.Callable[[], T_Result],
+        gpt_4_turbo_preview: typing.Callable[[], T_Result],
+        gpt_4: typing.Callable[[], T_Result],
+        mixtral_small_8_x_7_b_0211: typing.Callable[[], T_Result],
+        mistral_large_0224: typing.Callable[[], T_Result],
+        claude_3_opus_20240229: typing.Callable[[], T_Result],
+        claude_3_sonnet_20240229: typing.Callable[[], T_Result],
+        claude_3_haiku_20240307: typing.Callable[[], T_Result],
+    ) -> T_Result:
+        if self is ToolModels.GPT_4_TURBO:
+            return gpt_4_turbo()
+        if self is ToolModels.GPT_4_TURBO_PREVIEW:
+            return gpt_4_turbo_preview()
+        if self is ToolModels.GPT_4:
+            return gpt_4()
+        if self is ToolModels.MIXTRAL_SMALL_8_X_7_B_0211:
+            return mixtral_small_8_x_7_b_0211()
+        if self is ToolModels.MISTRAL_LARGE_0224:
+            return mistral_large_0224()
+        if self is ToolModels.CLAUDE_3_OPUS_20240229:
+            return claude_3_opus_20240229()
+        if self is ToolModels.CLAUDE_3_SONNET_20240229:
+            return claude_3_sonnet_20240229()
+        if self is ToolModels.CLAUDE_3_HAIKU_20240307:
+            return claude_3_haiku_20240307()

{athena_intelligence-0.1.40.dist-info → athena_intelligence-0.1.42.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: athena-intelligence
-Version: 0.1.40
+Version: 0.1.42
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Programming Language :: Python :: 3

{athena_intelligence-0.1.40.dist-info → athena_intelligence-0.1.42.dist-info}/RECORD

@@ -1,13 +1,13 @@
-athena/__init__.py,sha256=6SG9UQ4iQ8rFALsqP-LPImAjHTKLpmUHeSUapfxvmMo,1341
+athena/__init__.py,sha256=uXIyAvCSPx3g5Y96sk21HkSjNLz4Hi4XIKncoAxNT90,1489
 athena/base_client.py,sha256=tvX2FKc9AnNBm0k64njjUCOt7dPxBBn6BpClJpcPqgc,5416
-athena/chain/__init__.py,sha256=Kv3-525ENLEbHHcRZLT-ioQrzUNmFH9e5mUkApSyvp8,161
-athena/chain/client.py,sha256=mF5A0sXw2GvZexy4bK9HPgDx7DMzWVSR7f0WuGbkAIg,7401
-athena/chain/types/__init__.py,sha256=la4c4cmiMbVbZpB_XqpBB2Rzgl2-xkEUVZrXDowr1lc,190
-athena/chain/types/structured_tool_data_parsing_model.py,sha256=H2Zhh3Sav6foUCyIQIrgIR9iaMjk9ZQNJfHfZgJa1uQ,2213
+athena/chain/__init__.py,sha256=I1CBCogKCvJBIPdXXFQWdGJyFs6pdp0_dp6rnybd5mI,159
+athena/chain/client.py,sha256=SdlDtNr1QBbDgZGBAFW-GNT0FqPdhvAUcrQaHcGuUds,8333
+athena/chain/types/__init__.py,sha256=s4rY--H5yj6slggsUnRQNrKBHZ3QGE9jQWopTCQOFpg,187
+athena/chain/types/structured_parse_in_parsing_model.py,sha256=tr6DLP2v71IUScCOeLrUjUtXrAr3WlaW0sSD3ns2r-Q,2203
 athena/client.py,sha256=8QypiDlbZ0C1YsJh6GzhylLVCZXDQc1MCJTURo2_vvI,3576
 athena/core/__init__.py,sha256=RWfyDqkzWsf8e3VGc3NV60MovfJbg5XWzNFGB2DZ0hA,790
 athena/core/api_error.py,sha256=RE8LELok2QCjABadECTvtDp7qejA1VmINCh6TbqPwSE,426
-athena/core/client_wrapper.py,sha256=MicE6puzRD25jmVhsLDi58I2wkLvm4_csCbMBH9vT38,1198
+athena/core/client_wrapper.py,sha256=coayF2VxKYBTqahtCxLUrG-2ksro8yQZgP2yiqSmnUg,1198
 athena/core/datetime_utils.py,sha256=nBys2IsYrhPdszxGKCNRPSOCwa-5DWOHG95FB8G9PKo,1047
 athena/core/file.py,sha256=sy1RUGZ3aJYuw998bZytxxo6QdgKmlnlgBaMvwEKCGg,1480
 athena/core/http_client.py,sha256=LI0yP3jUyE0Ue7oyBcI9nyo1pljOwh9Y5ycTeIpKwOg,4882
@@ -28,31 +28,34 @@ athena/query/client.py,sha256=UOx-Bq-xFFm-sTMTmJjWGrC6q_7vhVno3nYzmi81xwI,6243
 athena/report/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 athena/report/client.py,sha256=sGJDrgk_E1SPleRYNhvspmsz-G3FQwMW-3alFzZPquE,6528
 athena/search/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
-athena/search/client.py,sha256=DLfHjgflIXAff20yswQK1h4BNxvY4SjZzhsywpQOM-g,12391
+athena/search/client.py,sha256=zhE86fKD61gHQ1w45DYfWVHIZ1APGK6yUrWAHYi0OVM,7515
 athena/snippet/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 athena/snippet/client.py,sha256=D0rSpm6ql9cnUj-mMe3z8OHRgRQQuk3bBW2CZSRnyp4,6087
 athena/tools/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
-athena/tools/client.py,sha256=XCkyxX3rau3Xbppj74rni8bScZrTFlYDkep_c3u4kWU,6657
-athena/types/__init__.py,sha256=6TfFMQqEF5dfsRSFsoHdH-qgIm8qPrzEeFPBorEcVq8,1370
+athena/tools/client.py,sha256=qk9PJ70meZVKZXReLEsxp1woUMpZ6UPOcuLYqHhMt1Q,19643
+athena/types/__init__.py,sha256=ClUrCuQeInMWgv8vO1AGSV0rQEm51YABwBPvB250fno,1607
 athena/types/dataset.py,sha256=70OJPxKBAYu7xthGEgrUolSdyLqiyh6X49INw1oN0sA,1014
+athena/types/document.py,sha256=CAByS_smWjl-edYLCCc4fkdhZYXSVUKQqEamjbhpgU0,1081
+athena/types/excecute_tool_first_workflow_out.py,sha256=tGL6pNN4uhL_knWf-SQc-Z1IPJFNVsAmYtDI-VjXS2s,895
 athena/types/firecrawl_scrape_url_data_reponse_dto.py,sha256=LbJY-SC_WNQG3nbswG8NTfVl_u_tpV1HO7Y3MWCk5gc,1021
 athena/types/firecrawl_scrape_url_metadata.py,sha256=sqHTtq5_5vujsMixJBDJULPK7MrvxEpB2wGPwC-bTdM,1128
 athena/types/get_datasets_response.py,sha256=BCdT8yTLfOsXeyFadlyoas4zzseFWGPAdGpkgkOuaD8,989
 athena/types/get_snippets_response.py,sha256=Lpn7bHJLpPQozN93unCV-8eByAAfz1MhQWR3G3Z1vl4,989
 athena/types/http_validation_error.py,sha256=Fcv_CTMMrLvCeTHjF0n5xf5tskMDgt-J6H9gp654eQw,973
+athena/types/langchain_documents_request_out.py,sha256=P5Qq7BkCWILORC3yOkvt8pssdYgd_vnTTANNtrWF-l8,939
 athena/types/message_out.py,sha256=uvZY_Podv2XccEk8CICug9I_S2hFJTSzCBwcHiauW7A,865
 athena/types/message_out_dto.py,sha256=qgRibRbDNOWVnVGP7Rribh9WdoCT2CSiPUXeIWECqq4,1051
 athena/types/model.py,sha256=XbXkKXbmnfZ8bPTAn1xnWGjqKK1SVOLdxf1RGk5ON5k,2545
 athena/types/report.py,sha256=QVaqVfHMAV3s9_V2CqjIEMcRrbJhD8zmi82vrk2A8x0,946
-athena/types/scrape_markdown_result.py,sha256=uRpIxoLV9oyLdbJeehm3zmZk_qXZeYqYYcS2SeQmwbA,881
 athena/types/snippet.py,sha256=POIVJNV9iQxiVegB_qwQx-PZPPSyoIPhyxTsueNVUGA,1126
 athena/types/sql_results.py,sha256=pNH32nyf1bzoYJs3FgHctLdLO02oOjyGgLkHACACB6k,900
 athena/types/status_enum.py,sha256=0UZbhdAx215GHC-U53RS98mYHtn1N3On4VBe4j02Qtc,672
 athena/types/structured_parse_result.py,sha256=7I-w06OmtxXFY01k7FXFSNPe5PpM3z54xNUbs62lSv0,905
+athena/types/tool_models.py,sha256=ltl4RX0QhFIj_wsKLZMDip72_Ko7P-7v0aL9HACXVFo,1829
 athena/types/tools.py,sha256=mhRkKAwlsDud-fFOhsx2T3hBD-FAtuCnGHyU9cLPcGU,1422
 athena/types/url_result.py,sha256=zajsW46qJnD6GPimb5kHkUncjqBfzHUlGOcKuUGMX-E,893
 athena/types/validation_error.py,sha256=2JhGNJouo8QpfrMBoT_JCwYSn1nFN2Nnq0p9uPLDH-U,992
 athena/types/validation_error_loc_item.py,sha256=LAtjCHIllWRBFXvAZ5QZpp7CPXjdtN9EB7HrLVo6EP0,128
-athena_intelligence-0.1.40.dist-info/METADATA,sha256=hV93D3CuM01fBTO3fShNwAEURnu-rJbcCHdSju2SN_I,4738
-athena_intelligence-0.1.40.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-athena_intelligence-0.1.40.dist-info/RECORD,,
+athena_intelligence-0.1.42.dist-info/METADATA,sha256=oDpxo7eQ8WaMzSnp7O856K9siIIlLNS8lILnRJSIgUI,4738
+athena_intelligence-0.1.42.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+athena_intelligence-0.1.42.dist-info/RECORD,,