athena-intelligence 0.1.123__tar.gz → 0.1.124__tar.gz

{athena_intelligence-0.1.123 → athena_intelligence-0.1.124}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: athena-intelligence
-Version: 0.1.123
+Version: 0.1.124
 Summary: Athena Intelligence Python Library
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers

{athena_intelligence-0.1.123 → athena_intelligence-0.1.124}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "athena-intelligence"
-version = "0.1.123"
+version = "0.1.124"
 description = "Athena Intelligence Python Library"
 readme = "README.md"
 authors = []

{athena_intelligence-0.1.123 → athena_intelligence-0.1.124}/src/athena/__init__.py

@@ -1,6 +1,7 @@
 # This file was auto-generated by Fern from our API Definition.
 
 from .types import (
+    AssetNode,
     AssetNotFoundError,
     Chunk,
     ChunkContentItem,
@@ -18,6 +19,7 @@ from .types import (
     DriveAgentResponse,
     FileChunkRequestOut,
     FileTooLargeError,
+    FolderResponse,
     GeneralAgentConfig,
     GeneralAgentConfigEnabledToolsItem,
     GeneralAgentRequest,
@@ -49,6 +51,7 @@ from .tools import ToolsDataFrameRequestColumnsItem
 from .version import __version__
 
 __all__ = [
+    "AssetNode",
     "AssetNotFoundError",
     "AthenaEnvironment",
     "BadRequestError",
@@ -69,6 +72,7 @@ __all__ = [
     "DriveAgentResponse",
     "FileChunkRequestOut",
     "FileTooLargeError",
+    "FolderResponse",
     "GeneralAgentConfig",
     "GeneralAgentConfigEnabledToolsItem",
     "GeneralAgentRequest",

{athena_intelligence-0.1.123 → athena_intelligence-0.1.124}/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.123",
+            "X-Fern-SDK-Version": "0.1.124",
         }
         headers["X-API-KEY"] = self.api_key
         return headers

{athena_intelligence-0.1.123 → athena_intelligence-0.1.124}/src/athena/tools/client.py

@@ -20,6 +20,7 @@ from ..types.data_frame_request_out import DataFrameRequestOut
 from ..types.data_frame_unknown_format_error import DataFrameUnknownFormatError
 from ..types.file_chunk_request_out import FileChunkRequestOut
 from ..types.file_too_large_error import FileTooLargeError
+from ..types.folder_response import FolderResponse
 from ..types.parent_folder_error import ParentFolderError
 from ..types.save_asset_request_out import SaveAssetRequestOut
 from .calendar.client import AsyncCalendarClient, CalendarClient
@@ -94,6 +95,68 @@ class ToolsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def list_contents(
+        self,
+        *,
+        folder_id: typing.Optional[str] = None,
+        include_asset_details: typing.Optional[bool] = None,
+        include_system_files: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None
+    ) -> FolderResponse:
+        """
+        List contents of a folder or entire workspace in a tree structure.
+
+        Parameters
+        ----------
+        folder_id : typing.Optional[str]
+
+        include_asset_details : typing.Optional[bool]
+
+        include_system_files : typing.Optional[bool]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        FolderResponse
+            Successful Response
+
+        Examples
+        --------
+        from athena.client import Athena
+
+        client = Athena(
+            api_key="YOUR_API_KEY",
+        )
+        client.tools.list_contents()
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/v0/tools/contents",
+            method="GET",
+            params={
+                "folder_id": folder_id,
+                "include_asset_details": include_asset_details,
+                "include_system_files": include_system_files,
+            },
+            request_options=request_options,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic_v1.parse_obj_as(FolderResponse, _response.json())  # type: ignore
+        if _response.status_code == 400:
+            raise BadRequestError(pydantic_v1.parse_obj_as(ParentFolderError, _response.json()))  # type: ignore
+        if _response.status_code == 401:
+            raise UnauthorizedError(pydantic_v1.parse_obj_as(typing.Any, _response.json()))  # type: ignore
+        if _response.status_code == 404:
+            raise NotFoundError(pydantic_v1.parse_obj_as(AssetNotFoundError, _response.json()))  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic_v1.parse_obj_as(typing.Any, _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 data_frame(
         self,
         *,
@@ -347,6 +410,68 @@ class AsyncToolsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    async def list_contents(
+        self,
+        *,
+        folder_id: typing.Optional[str] = None,
+        include_asset_details: typing.Optional[bool] = None,
+        include_system_files: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None
+    ) -> FolderResponse:
+        """
+        List contents of a folder or entire workspace in a tree structure.
+
+        Parameters
+        ----------
+        folder_id : typing.Optional[str]
+
+        include_asset_details : typing.Optional[bool]
+
+        include_system_files : typing.Optional[bool]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        FolderResponse
+            Successful Response
+
+        Examples
+        --------
+        from athena.client import AsyncAthena
+
+        client = AsyncAthena(
+            api_key="YOUR_API_KEY",
+        )
+        await client.tools.list_contents()
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/v0/tools/contents",
+            method="GET",
+            params={
+                "folder_id": folder_id,
+                "include_asset_details": include_asset_details,
+                "include_system_files": include_system_files,
+            },
+            request_options=request_options,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic_v1.parse_obj_as(FolderResponse, _response.json())  # type: ignore
+        if _response.status_code == 400:
+            raise BadRequestError(pydantic_v1.parse_obj_as(ParentFolderError, _response.json()))  # type: ignore
+        if _response.status_code == 401:
+            raise UnauthorizedError(pydantic_v1.parse_obj_as(typing.Any, _response.json()))  # type: ignore
+        if _response.status_code == 404:
+            raise NotFoundError(pydantic_v1.parse_obj_as(AssetNotFoundError, _response.json()))  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic_v1.parse_obj_as(typing.Any, _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 data_frame(
         self,
         *,

{athena_intelligence-0.1.123 → athena_intelligence-0.1.124}/src/athena/tools/structured_data_extractor/client.py

@@ -36,7 +36,7 @@ class StructuredDataExtractorClient:
         tl;dr:
 
         - pass a valid JSON schema in `json_schema`
-        - pass the page chunks as a list of `Chunk` objects, by default: {"type": "text", "content": "..."}
+        - pass the page chunks as a list of `Chunk` objects, by default: `{"type": "text", "content": "..."}`
         - leave all other fields as default
 
         Detailed configuration (only relevant for complex use cases):
@@ -45,9 +45,12 @@ class StructuredDataExtractorClient:
         where the asset is divided into chunks, the schema is extracted from each chunk,
         and the chunks are then reduced to a single structured data object.
 
-        In some applications, you may not want to: - map (if your input asset is small enough) - reduce (if your output object is large enough that it will overflow the output length;
-        if you're extracting a long list of entities; if youre )
-        to extract all instances of the schema).
+        In some applications, you may not want to:
+
+        - map (if your input asset is small enough)
+        - reduce (if your output object is large enough that it will overflow the output length;
+          if you're extracting a long list of entities; if youre )
+          to extract all instances of the schema).
 
         You can configure these behaviors with the `map` and `reduce` fields.
 
@@ -160,7 +163,7 @@ class AsyncStructuredDataExtractorClient:
         tl;dr:
 
         - pass a valid JSON schema in `json_schema`
-        - pass the page chunks as a list of `Chunk` objects, by default: {"type": "text", "content": "..."}
+        - pass the page chunks as a list of `Chunk` objects, by default: `{"type": "text", "content": "..."}`
         - leave all other fields as default
 
         Detailed configuration (only relevant for complex use cases):
@@ -169,9 +172,12 @@ class AsyncStructuredDataExtractorClient:
         where the asset is divided into chunks, the schema is extracted from each chunk,
         and the chunks are then reduced to a single structured data object.
 
-        In some applications, you may not want to: - map (if your input asset is small enough) - reduce (if your output object is large enough that it will overflow the output length;
-        if you're extracting a long list of entities; if youre )
-        to extract all instances of the schema).
+        In some applications, you may not want to:
+
+        - map (if your input asset is small enough)
+        - reduce (if your output object is large enough that it will overflow the output length;
+          if you're extracting a long list of entities; if youre )
+          to extract all instances of the schema).
 
         You can configure these behaviors with the `map` and `reduce` fields.
 

{athena_intelligence-0.1.123 → athena_intelligence-0.1.124}/src/athena/types/__init__.py

@@ -1,5 +1,6 @@
 # This file was auto-generated by Fern from our API Definition.
 
+from .asset_node import AssetNode
 from .asset_not_found_error import AssetNotFoundError
 from .chunk import Chunk
 from .chunk_content_item import ChunkContentItem, ChunkContentItem_ImageUrl, ChunkContentItem_Text
@@ -15,6 +16,7 @@ from .document_chunk import DocumentChunk
 from .drive_agent_response import DriveAgentResponse
 from .file_chunk_request_out import FileChunkRequestOut
 from .file_too_large_error import FileTooLargeError
+from .folder_response import FolderResponse
 from .general_agent_config import GeneralAgentConfig
 from .general_agent_config_enabled_tools_item import GeneralAgentConfigEnabledToolsItem
 from .general_agent_request import GeneralAgentRequest
@@ -31,6 +33,7 @@ from .tool import Tool
 from .type import Type
 
 __all__ = [
+    "AssetNode",
     "AssetNotFoundError",
     "Chunk",
     "ChunkContentItem",
@@ -48,6 +51,7 @@ __all__ = [
     "DriveAgentResponse",
     "FileChunkRequestOut",
     "FileTooLargeError",
+    "FolderResponse",
     "GeneralAgentConfig",
     "GeneralAgentConfigEnabledToolsItem",
     "GeneralAgentRequest",

athena_intelligence-0.1.124/src/athena/types/asset_node.py

@@ -0,0 +1,42 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+
+import datetime as dt
+import typing
+
+from ..core.datetime_utils import serialize_datetime
+from ..core.pydantic_utilities import deep_union_pydantic_dicts, pydantic_v1
+
+
+class AssetNode(pydantic_v1.BaseModel):
+    """
+    Model representing a node in the folder tree.
+    """
+
+    children: typing.Optional[typing.Dict[str, typing.Optional[AssetNode]]] = None
+    id: str
+    media_type: str
+    name: str
+    type: str
+
+    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_exclude_unset: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
+        kwargs_with_defaults_exclude_none: typing.Any = {"by_alias": True, "exclude_none": True, **kwargs}
+
+        return deep_union_pydantic_dicts(
+            super().dict(**kwargs_with_defaults_exclude_unset), super().dict(**kwargs_with_defaults_exclude_none)
+        )
+
+    class Config:
+        frozen = True
+        smart_union = True
+        extra = pydantic_v1.Extra.allow
+        json_encoders = {dt.datetime: serialize_datetime}
+
+
+AssetNode.update_forward_refs()

athena_intelligence-0.1.124/src/athena/types/folder_response.py

@@ -0,0 +1,35 @@
+# 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 deep_union_pydantic_dicts, pydantic_v1
+from .asset_node import AssetNode
+
+
+class FolderResponse(pydantic_v1.BaseModel):
+    """
+    Combined response with tree data and visualization.
+    """
+
+    structure_tree_ascii: str
+    tree_data: typing.Dict[str, AssetNode]
+
+    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_exclude_unset: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
+        kwargs_with_defaults_exclude_none: typing.Any = {"by_alias": True, "exclude_none": True, **kwargs}
+
+        return deep_union_pydantic_dicts(
+            super().dict(**kwargs_with_defaults_exclude_unset), super().dict(**kwargs_with_defaults_exclude_none)
+        )
+
+    class Config:
+        frozen = True
+        smart_union = True
+        extra = pydantic_v1.Extra.allow
+        json_encoders = {dt.datetime: serialize_datetime}