athena-intelligence 0.1.60__tar.gz → 0.1.62__tar.gz

{athena_intelligence-0.1.60 → athena_intelligence-0.1.62}/PKG-INFO

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

{athena_intelligence-0.1.60 → athena_intelligence-0.1.62}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "athena-intelligence"
-version = "0.1.60"
+version = "0.1.62"
 description = ""
 readme = "README.md"
 authors = []

{athena_intelligence-0.1.60 → athena_intelligence-0.1.62}/src/athena/__init__.py

@@ -4,6 +4,7 @@ from .types import (
     Dataset,
     Document,
     ExcecuteToolFirstWorkflowOut,
+    FileDataResponse,
     FirecrawlScrapeUrlDataReponseDto,
     FirecrawlScrapeUrlMetadata,
     GetDatasetsResponse,
@@ -17,17 +18,19 @@ from .types import (
     MessageOutDto,
     Model,
     Report,
+    ResearcherOut,
     Snippet,
     SqlResults,
     StatusEnum,
     StructuredParseResult,
     Tools,
+    UploadDocumentsOut,
     UrlResult,
     ValidationError,
     ValidationErrorLocItem,
 )
 from .errors import UnprocessableEntityError
-from . import chain, dataset, message, query, report, search, snippet, tools
+from . import chain, dataset, message, query, report, search, snippet, tools, upload
 from .environment import AthenaEnvironment
 from .version import __version__
 
@@ -36,6 +39,7 @@ __all__ = [
     "Dataset",
     "Document",
     "ExcecuteToolFirstWorkflowOut",
+    "FileDataResponse",
     "FirecrawlScrapeUrlDataReponseDto",
     "FirecrawlScrapeUrlMetadata",
     "GetDatasetsResponse",
@@ -49,12 +53,14 @@ __all__ = [
     "MessageOutDto",
     "Model",
     "Report",
+    "ResearcherOut",
     "Snippet",
     "SqlResults",
     "StatusEnum",
     "StructuredParseResult",
     "Tools",
     "UnprocessableEntityError",
+    "UploadDocumentsOut",
     "UrlResult",
     "ValidationError",
     "ValidationErrorLocItem",
@@ -67,4 +73,5 @@ __all__ = [
     "search",
     "snippet",
     "tools",
+    "upload",
 ]

{athena_intelligence-0.1.60 → athena_intelligence-0.1.62}/src/athena/base_client.py

@@ -14,6 +14,7 @@ from .report.client import AsyncReportClient, ReportClient
 from .search.client import AsyncSearchClient, SearchClient
 from .snippet.client import AsyncSnippetClient, SnippetClient
 from .tools.client import AsyncToolsClient, ToolsClient
+from .upload.client import AsyncUploadClient, UploadClient
 
 
 class BaseAthena:
@@ -71,6 +72,7 @@ class BaseAthena:
         self.search = SearchClient(client_wrapper=self._client_wrapper)
         self.chain = ChainClient(client_wrapper=self._client_wrapper)
         self.tools = ToolsClient(client_wrapper=self._client_wrapper)
+        self.upload = UploadClient(client_wrapper=self._client_wrapper)
 
 
 class AsyncBaseAthena:
@@ -128,6 +130,7 @@ class AsyncBaseAthena:
         self.search = AsyncSearchClient(client_wrapper=self._client_wrapper)
         self.chain = AsyncChainClient(client_wrapper=self._client_wrapper)
         self.tools = AsyncToolsClient(client_wrapper=self._client_wrapper)
+        self.upload = AsyncUploadClient(client_wrapper=self._client_wrapper)
 
 
 def _get_base_url(*, base_url: typing.Optional[str] = None, environment: AthenaEnvironment) -> str:

{athena_intelligence-0.1.60 → athena_intelligence-0.1.62}/src/athena/core/client_wrapper.py

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

{athena_intelligence-0.1.60 → athena_intelligence-0.1.62}/src/athena/tools/client.py

@@ -16,6 +16,7 @@ from ..types.firecrawl_scrape_url_data_reponse_dto import FirecrawlScrapeUrlData
 from ..types.http_validation_error import HttpValidationError
 from ..types.langchain_documents_request_out import LangchainDocumentsRequestOut
 from ..types.llm_model import LlmModel
+from ..types.researcher_out import ResearcherOut
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -241,6 +242,77 @@ class ToolsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def researcher(
+        self,
+        *,
+        query: str,
+        max_sections: int,
+        guidelines: typing.Sequence[str],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ResearcherOut:
+        """
+        Parameters:
+            - query: str.
+
+            - max_sections: int.
+
+            - guidelines: typing.Sequence[str].
+
+            - request_options: typing.Optional[RequestOptions]. Request-specific configuration.
+        ---
+        from athena.client import Athena
+
+        client = Athena(
+            api_key="YOUR_API_KEY",
+        )
+        client.tools.researcher(
+            query="Write a report about the company Athena Intelligence.",
+            max_sections=10,
+            guidelines=[
+                "The report MUST be written in APA format",
+                "Each sub section MUST include supporting sources using hyperlinks. If none exist, erase the sub section or rewrite it to be a part of the previous section",
+                "The report MUST be written in english",
+            ],
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            method="POST",
+            url=urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v0/tools/researcher"),
+            params=jsonable_encoder(
+                request_options.get("additional_query_parameters") if request_options is not None else None
+            ),
+            json=jsonable_encoder({"query": query, "max_sections": max_sections, "guidelines": guidelines})
+            if request_options is None or request_options.get("additional_body_parameters") is None
+            else {
+                **jsonable_encoder({"query": query, "max_sections": max_sections, "guidelines": guidelines}),
+                **(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 self._client_wrapper.get_timeout(),
+            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_v1.parse_obj_as(ResearcherOut, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(
+                pydantic_v1.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):
@@ -461,3 +533,74 @@ 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 researcher(
+        self,
+        *,
+        query: str,
+        max_sections: int,
+        guidelines: typing.Sequence[str],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ResearcherOut:
+        """
+        Parameters:
+            - query: str.
+
+            - max_sections: int.
+
+            - guidelines: typing.Sequence[str].
+
+            - request_options: typing.Optional[RequestOptions]. Request-specific configuration.
+        ---
+        from athena.client import AsyncAthena
+
+        client = AsyncAthena(
+            api_key="YOUR_API_KEY",
+        )
+        await client.tools.researcher(
+            query="Write a report about the company Athena Intelligence.",
+            max_sections=10,
+            guidelines=[
+                "The report MUST be written in APA format",
+                "Each sub section MUST include supporting sources using hyperlinks. If none exist, erase the sub section or rewrite it to be a part of the previous section",
+                "The report MUST be written in english",
+            ],
+        )
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            method="POST",
+            url=urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v0/tools/researcher"),
+            params=jsonable_encoder(
+                request_options.get("additional_query_parameters") if request_options is not None else None
+            ),
+            json=jsonable_encoder({"query": query, "max_sections": max_sections, "guidelines": guidelines})
+            if request_options is None or request_options.get("additional_body_parameters") is None
+            else {
+                **jsonable_encoder({"query": query, "max_sections": max_sections, "guidelines": guidelines}),
+                **(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 self._client_wrapper.get_timeout(),
+            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_v1.parse_obj_as(ResearcherOut, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(
+                pydantic_v1.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_intelligence-0.1.60 → athena_intelligence-0.1.62}/src/athena/types/__init__.py

@@ -3,6 +3,7 @@
 from .dataset import Dataset
 from .document import Document
 from .excecute_tool_first_workflow_out import ExcecuteToolFirstWorkflowOut
+from .file_data_response import FileDataResponse
 from .firecrawl_scrape_url_data_reponse_dto import FirecrawlScrapeUrlDataReponseDto
 from .firecrawl_scrape_url_metadata import FirecrawlScrapeUrlMetadata
 from .get_datasets_response import GetDatasetsResponse
@@ -16,11 +17,13 @@ from .message_out import MessageOut
 from .message_out_dto import MessageOutDto
 from .model import Model
 from .report import Report
+from .researcher_out import ResearcherOut
 from .snippet import Snippet
 from .sql_results import SqlResults
 from .status_enum import StatusEnum
 from .structured_parse_result import StructuredParseResult
 from .tools import Tools
+from .upload_documents_out import UploadDocumentsOut
 from .url_result import UrlResult
 from .validation_error import ValidationError
 from .validation_error_loc_item import ValidationErrorLocItem
@@ -29,6 +32,7 @@ __all__ = [
     "Dataset",
     "Document",
     "ExcecuteToolFirstWorkflowOut",
+    "FileDataResponse",
     "FirecrawlScrapeUrlDataReponseDto",
     "FirecrawlScrapeUrlMetadata",
     "GetDatasetsResponse",
@@ -42,11 +46,13 @@ __all__ = [
     "MessageOutDto",
     "Model",
     "Report",
+    "ResearcherOut",
     "Snippet",
     "SqlResults",
     "StatusEnum",
     "StructuredParseResult",
     "Tools",
+    "UploadDocumentsOut",
     "UrlResult",
     "ValidationError",
     "ValidationErrorLocItem",

athena_intelligence-0.1.62/src/athena/types/file_data_response.py

@@ -0,0 +1,32 @@
+# 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 ..core.pydantic_utilities import pydantic_v1
+
+
+class FileDataResponse(pydantic_v1.BaseModel):
+    file: typing.Optional[str] = None
+    size: typing.Optional[int] = None
+    filename: typing.Optional[str] = None
+    content_type: typing.Optional[str] = None
+    status: typing.Optional[bool] = None
+    error: typing.Optional[str] = None
+    message: typing.Optional[str] = None
+    athena_doc_id: typing.Optional[str] = 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
+        extra = pydantic_v1.Extra.allow
+        json_encoders = {dt.datetime: serialize_datetime}

athena_intelligence-0.1.62/src/athena/types/researcher_out.py

@@ -0,0 +1,25 @@
+# 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 ..core.pydantic_utilities import pydantic_v1
+
+
+class ResearcherOut(pydantic_v1.BaseModel):
+    response: typing.Dict[str, typing.Any]
+
+    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
+        extra = pydantic_v1.Extra.allow
+        json_encoders = {dt.datetime: serialize_datetime}

athena_intelligence-0.1.62/src/athena/types/upload_documents_out.py

@@ -0,0 +1,27 @@
+# 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 ..core.pydantic_utilities import pydantic_v1
+from .file_data_response import FileDataResponse
+
+
+class UploadDocumentsOut(pydantic_v1.BaseModel):
+    success: bool
+    uploaded_documents: typing.Optional[typing.List[FileDataResponse]] = 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
+        extra = pydantic_v1.Extra.allow
+        json_encoders = {dt.datetime: serialize_datetime}

athena_intelligence-0.1.62/src/athena/upload/__init__.py

@@ -0,0 +1,2 @@
+# This file was auto-generated by Fern from our API Definition.
+

athena_intelligence-0.1.62/src/athena/upload/client.py

@@ -0,0 +1,139 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+import urllib.parse
+from json.decoder import JSONDecodeError
+
+from .. import core
+from ..core.api_error import ApiError
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.jsonable_encoder import jsonable_encoder
+from ..core.pydantic_utilities import pydantic_v1
+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.upload_documents_out import UploadDocumentsOut
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class UploadClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def upload_documents(
+        self, *, files: typing.List[core.File], request_options: typing.Optional[RequestOptions] = None
+    ) -> UploadDocumentsOut:
+        """
+        Parameters:
+            - files: typing.List[core.File]. See core.File for more documentation
+
+            - request_options: typing.Optional[RequestOptions]. Request-specific configuration.
+        ---
+        from athena.client import Athena
+
+        client = Athena(
+            api_key="YOUR_API_KEY",
+        )
+        client.upload.upload_documents()
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            method="POST",
+            url=urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v0/upload"),
+            params=jsonable_encoder(
+                request_options.get("additional_query_parameters") if request_options is not None else None
+            ),
+            data=jsonable_encoder(remove_none_from_dict({}))
+            if request_options is None or request_options.get("additional_body_parameters") is None
+            else {
+                **jsonable_encoder(remove_none_from_dict({})),
+                **(jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {})))),
+            },
+            files=core.convert_file_dict_to_httpx_tuples(remove_none_from_dict({"files": files})),
+            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 self._client_wrapper.get_timeout(),
+            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_v1.parse_obj_as(UploadDocumentsOut, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(
+                pydantic_v1.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 AsyncUploadClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def upload_documents(
+        self, *, files: typing.List[core.File], request_options: typing.Optional[RequestOptions] = None
+    ) -> UploadDocumentsOut:
+        """
+        Parameters:
+            - files: typing.List[core.File]. See core.File for more documentation
+
+            - request_options: typing.Optional[RequestOptions]. Request-specific configuration.
+        ---
+        from athena.client import AsyncAthena
+
+        client = AsyncAthena(
+            api_key="YOUR_API_KEY",
+        )
+        await client.upload.upload_documents()
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            method="POST",
+            url=urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v0/upload"),
+            params=jsonable_encoder(
+                request_options.get("additional_query_parameters") if request_options is not None else None
+            ),
+            data=jsonable_encoder(remove_none_from_dict({}))
+            if request_options is None or request_options.get("additional_body_parameters") is None
+            else {
+                **jsonable_encoder(remove_none_from_dict({})),
+                **(jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {})))),
+            },
+            files=core.convert_file_dict_to_httpx_tuples(remove_none_from_dict({"files": files})),
+            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 self._client_wrapper.get_timeout(),
+            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_v1.parse_obj_as(UploadDocumentsOut, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(
+                pydantic_v1.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)