athena-intelligence 0.1.227__py3-none-any.whl → 0.1.357__py3-none-any.whl

athena/types/__init__.py

@@ -2,56 +2,172 @@
 
 # isort: skip_file
 
-from .aop_async_execute_response_out import AopAsyncExecuteResponseOut
-from .aop_execute_request_in import AopExecuteRequestIn
-from .aop_execute_response_out import AopExecuteResponseOut
-from .asset_content_request_out import AssetContentRequestOut
-from .asset_node import AssetNode
-from .asset_screenshot_response_out import AssetScreenshotResponseOut
-from .chunk import Chunk
-from .chunk_content_item import ChunkContentItem, ChunkContentItem_ImageUrl, ChunkContentItem_Text
-from .chunk_result import ChunkResult
-from .chunk_result_chunk_id import ChunkResultChunkId
-from .content import Content
-from .conversation_asset_info import ConversationAssetInfo
-from .create_new_sheet_tab_response import CreateNewSheetTabResponse
-from .custom_agent_response import CustomAgentResponse
-from .data_frame_request_out import DataFrameRequestOut
-from .data_frame_request_out_columns_item import DataFrameRequestOutColumnsItem
-from .data_frame_request_out_data_item_item import DataFrameRequestOutDataItemItem
-from .data_frame_request_out_index_item import DataFrameRequestOutIndexItem
-from .data_frame_unknown_format_error import DataFrameUnknownFormatError
-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
-from .general_agent_response import GeneralAgentResponse
-from .general_agent_response_message import GeneralAgentResponseMessage
-from .general_agent_response_message_kwargs import GeneralAgentResponseMessageKwargs
-from .get_table_response import GetTableResponse
-from .id import Id
-from .image_url_content import ImageUrlContent
-from .input_message import InputMessage
-from .input_message_content_item import (
-    InputMessageContentItem,
-    InputMessageContentItem_ImageUrl,
-    InputMessageContentItem_Text,
-)
-from .paginated_assets_out import PaginatedAssetsOut
-from .prompt_message import PromptMessage
-from .public_asset_out import PublicAssetOut
-from .research_agent_response import ResearchAgentResponse
-from .save_asset_request_out import SaveAssetRequestOut
-from .sheet_operation_response import SheetOperationResponse
-from .sql_agent_response import SqlAgentResponse
-from .structured_data_extractor_response import StructuredDataExtractorResponse
-from .text_content import TextContent
-from .thread_status_response_out import ThreadStatusResponseOut
-from .type import Type
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from .aop_async_execute_response_out import AopAsyncExecuteResponseOut
+    from .aop_execute_request_in import AopExecuteRequestIn
+    from .aop_execute_response_out import AopExecuteResponseOut
+    from .asset_content_request_out import AssetContentRequestOut
+    from .asset_node import AssetNode
+    from .asset_screenshot_response_out import AssetScreenshotResponseOut
+    from .border_model import BorderModel
+    from .border_style import BorderStyle
+    from .borders_model import BordersModel
+    from .cell_format import CellFormat
+    from .cell_format_horizontal_alignment import CellFormatHorizontalAlignment
+    from .cell_format_vertical_alignment import CellFormatVerticalAlignment
+    from .chunk import Chunk
+    from .chunk_content_item import ChunkContentItem, ChunkContentItem_ImageUrl, ChunkContentItem_Text
+    from .chunk_result import ChunkResult
+    from .chunk_result_chunk_id import ChunkResultChunkId
+    from .content import Content
+    from .conversation_asset_info import ConversationAssetInfo
+    from .conversation_message import ConversationMessage
+    from .conversation_result import ConversationResult
+    from .creatable_asset_type import CreatableAssetType
+    from .create_asset_response_out import CreateAssetResponseOut
+    from .create_new_sheet_tab_response import CreateNewSheetTabResponse
+    from .create_project_response_out import CreateProjectResponseOut
+    from .custom_agent_response import CustomAgentResponse
+    from .data_frame_request_out import DataFrameRequestOut
+    from .data_frame_request_out_columns_item import DataFrameRequestOutColumnsItem
+    from .data_frame_request_out_data_item_item import DataFrameRequestOutDataItemItem
+    from .data_frame_request_out_index_item import DataFrameRequestOutIndexItem
+    from .data_frame_unknown_format_error import DataFrameUnknownFormatError
+    from .dimension_properties import DimensionProperties
+    from .drive_agent_response import DriveAgentResponse
+    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
+    from .general_agent_response import GeneralAgentResponse
+    from .general_agent_response_message import GeneralAgentResponseMessage
+    from .general_agent_response_message_kwargs import GeneralAgentResponseMessageKwargs
+    from .get_table_response import GetTableResponse
+    from .grid_range import GridRange
+    from .id import Id
+    from .image_url_content import ImageUrlContent
+    from .input_message import InputMessage
+    from .input_message_content_item import (
+        InputMessageContentItem,
+        InputMessageContentItem_ImageUrl,
+        InputMessageContentItem_Text,
+    )
+    from .number_format_model import NumberFormatModel
+    from .number_format_type import NumberFormatType
+    from .paginated_assets_out import PaginatedAssetsOut
+    from .prompt_message import PromptMessage
+    from .public_asset_out import PublicAssetOut
+    from .research_agent_response import ResearchAgentResponse
+    from .save_asset_request_out import SaveAssetRequestOut
+    from .sheet import Sheet
+    from .sheet_operation_response import SheetOperationResponse
+    from .sql_agent_response import SqlAgentResponse
+    from .structured_data_extractor_response import StructuredDataExtractorResponse
+    from .table_row_data import TableRowData
+    from .text_content import TextContent
+    from .text_format_model import TextFormatModel
+    from .textrotation import Textrotation
+    from .theme_color import ThemeColor
+    from .thread_status_response_out import ThreadStatusResponseOut
+    from .type import Type
+    from .wrap_strategy import WrapStrategy
+_dynamic_imports: typing.Dict[str, str] = {
+    "AopAsyncExecuteResponseOut": ".aop_async_execute_response_out",
+    "AopExecuteRequestIn": ".aop_execute_request_in",
+    "AopExecuteResponseOut": ".aop_execute_response_out",
+    "AssetContentRequestOut": ".asset_content_request_out",
+    "AssetNode": ".asset_node",
+    "AssetScreenshotResponseOut": ".asset_screenshot_response_out",
+    "BorderModel": ".border_model",
+    "BorderStyle": ".border_style",
+    "BordersModel": ".borders_model",
+    "CellFormat": ".cell_format",
+    "CellFormatHorizontalAlignment": ".cell_format_horizontal_alignment",
+    "CellFormatVerticalAlignment": ".cell_format_vertical_alignment",
+    "Chunk": ".chunk",
+    "ChunkContentItem": ".chunk_content_item",
+    "ChunkContentItem_ImageUrl": ".chunk_content_item",
+    "ChunkContentItem_Text": ".chunk_content_item",
+    "ChunkResult": ".chunk_result",
+    "ChunkResultChunkId": ".chunk_result_chunk_id",
+    "Content": ".content",
+    "ConversationAssetInfo": ".conversation_asset_info",
+    "ConversationMessage": ".conversation_message",
+    "ConversationResult": ".conversation_result",
+    "CreatableAssetType": ".creatable_asset_type",
+    "CreateAssetResponseOut": ".create_asset_response_out",
+    "CreateNewSheetTabResponse": ".create_new_sheet_tab_response",
+    "CreateProjectResponseOut": ".create_project_response_out",
+    "CustomAgentResponse": ".custom_agent_response",
+    "DataFrameRequestOut": ".data_frame_request_out",
+    "DataFrameRequestOutColumnsItem": ".data_frame_request_out_columns_item",
+    "DataFrameRequestOutDataItemItem": ".data_frame_request_out_data_item_item",
+    "DataFrameRequestOutIndexItem": ".data_frame_request_out_index_item",
+    "DataFrameUnknownFormatError": ".data_frame_unknown_format_error",
+    "DimensionProperties": ".dimension_properties",
+    "DriveAgentResponse": ".drive_agent_response",
+    "FileTooLargeError": ".file_too_large_error",
+    "FolderResponse": ".folder_response",
+    "GeneralAgentConfig": ".general_agent_config",
+    "GeneralAgentConfigEnabledToolsItem": ".general_agent_config_enabled_tools_item",
+    "GeneralAgentRequest": ".general_agent_request",
+    "GeneralAgentResponse": ".general_agent_response",
+    "GeneralAgentResponseMessage": ".general_agent_response_message",
+    "GeneralAgentResponseMessageKwargs": ".general_agent_response_message_kwargs",
+    "GetTableResponse": ".get_table_response",
+    "GridRange": ".grid_range",
+    "Id": ".id",
+    "ImageUrlContent": ".image_url_content",
+    "InputMessage": ".input_message",
+    "InputMessageContentItem": ".input_message_content_item",
+    "InputMessageContentItem_ImageUrl": ".input_message_content_item",
+    "InputMessageContentItem_Text": ".input_message_content_item",
+    "NumberFormatModel": ".number_format_model",
+    "NumberFormatType": ".number_format_type",
+    "PaginatedAssetsOut": ".paginated_assets_out",
+    "PromptMessage": ".prompt_message",
+    "PublicAssetOut": ".public_asset_out",
+    "ResearchAgentResponse": ".research_agent_response",
+    "SaveAssetRequestOut": ".save_asset_request_out",
+    "Sheet": ".sheet",
+    "SheetOperationResponse": ".sheet_operation_response",
+    "SqlAgentResponse": ".sql_agent_response",
+    "StructuredDataExtractorResponse": ".structured_data_extractor_response",
+    "TableRowData": ".table_row_data",
+    "TextContent": ".text_content",
+    "TextFormatModel": ".text_format_model",
+    "Textrotation": ".textrotation",
+    "ThemeColor": ".theme_color",
+    "ThreadStatusResponseOut": ".thread_status_response_out",
+    "Type": ".type",
+    "WrapStrategy": ".wrap_strategy",
+}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        if module_name == f".{attr_name}":
+            return module
+        else:
+            return getattr(module, attr_name)
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
 
 __all__ = [
     "AopAsyncExecuteResponseOut",
@@ -60,6 +176,12 @@ __all__ = [
     "AssetContentRequestOut",
     "AssetNode",
     "AssetScreenshotResponseOut",
+    "BorderModel",
+    "BorderStyle",
+    "BordersModel",
+    "CellFormat",
+    "CellFormatHorizontalAlignment",
+    "CellFormatVerticalAlignment",
     "Chunk",
     "ChunkContentItem",
     "ChunkContentItem_ImageUrl",
@@ -68,16 +190,20 @@ __all__ = [
     "ChunkResultChunkId",
     "Content",
     "ConversationAssetInfo",
+    "ConversationMessage",
+    "ConversationResult",
+    "CreatableAssetType",
+    "CreateAssetResponseOut",
     "CreateNewSheetTabResponse",
+    "CreateProjectResponseOut",
     "CustomAgentResponse",
     "DataFrameRequestOut",
     "DataFrameRequestOutColumnsItem",
     "DataFrameRequestOutDataItemItem",
     "DataFrameRequestOutIndexItem",
     "DataFrameUnknownFormatError",
-    "DocumentChunk",
+    "DimensionProperties",
     "DriveAgentResponse",
-    "FileChunkRequestOut",
     "FileTooLargeError",
     "FolderResponse",
     "GeneralAgentConfig",
@@ -87,21 +213,30 @@ __all__ = [
     "GeneralAgentResponseMessage",
     "GeneralAgentResponseMessageKwargs",
     "GetTableResponse",
+    "GridRange",
     "Id",
     "ImageUrlContent",
     "InputMessage",
     "InputMessageContentItem",
     "InputMessageContentItem_ImageUrl",
     "InputMessageContentItem_Text",
+    "NumberFormatModel",
+    "NumberFormatType",
     "PaginatedAssetsOut",
     "PromptMessage",
     "PublicAssetOut",
     "ResearchAgentResponse",
     "SaveAssetRequestOut",
+    "Sheet",
     "SheetOperationResponse",
     "SqlAgentResponse",
     "StructuredDataExtractorResponse",
+    "TableRowData",
     "TextContent",
+    "TextFormatModel",
+    "Textrotation",
+    "ThemeColor",
     "ThreadStatusResponseOut",
     "Type",
+    "WrapStrategy",
 ]

athena/types/aop_execute_response_out.py

@@ -4,6 +4,7 @@ import typing
 
 import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .conversation_result import ConversationResult
 
 
 class AopExecuteResponseOut(UniversalBaseModel):
@@ -31,7 +32,7 @@ class AopExecuteResponseOut(UniversalBaseModel):
     Base prompt of the AOP before user inputs were added
     """
 
-    conversation: typing.Optional[typing.Optional[typing.Any]] = pydantic.Field(default=None)
+    conversation: typing.Optional[ConversationResult] = pydantic.Field(default=None)
     """
     The conversation result from the AOP execution
     """

athena/types/border_model.py

@@ -0,0 +1,32 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .border_style import BorderStyle
+from .theme_color import ThemeColor
+
+
+class BorderModel(UniversalBaseModel):
+    color_hex: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Border color as hex string (e.g., '#FF0000'). Use either color_hex or color_theme, not both.
+    """
+
+    color_theme: typing.Optional[ThemeColor] = pydantic.Field(default=None)
+    """
+    Border color as theme reference. Use either color_hex or color_theme, not both. Defaults to theme color 1 if neither is specified.
+    """
+
+    style: BorderStyle
+    width: int
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

athena/types/border_style.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+BorderStyle = typing.Union[
+    typing.Literal["dotted", "dashed", "solid", "solid_medium", "solid_thick", "double"], typing.Any
+]

athena/types/borders_model.py

@@ -0,0 +1,58 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .border_model import BorderModel
+
+
+class BordersModel(UniversalBaseModel):
+    """
+    Border configuration for spreadsheet cells. Set individual borders (top, right, bottom, left) to apply borders around cells.
+
+    Common border patterns:
+    - All borders: Set all four sides (top, right, bottom, left) to create borders around every cell
+    - Outer border only: For a range A1:C3, only the perimeter cells get borders (first row gets top, last row gets bottom, etc.)
+    - Inner borders only: Only borders between cells, not on the outer edges
+    - Horizontal lines: Set only top and/or bottom borders
+    - Vertical lines: Set only left and/or right borders
+    - Single side: Set only one border (e.g., just bottom for underline effect)
+
+    Note: Borders are applied per-cell. Each cell's border properties control which edges of that specific cell have borders. Overlapping borders between adjacent cells will appear as a single line.
+
+    Examples:
+    - Box around range: Set all four borders on all cells in the range
+    - Table with grid: Set all four borders to create a complete grid
+    - Underline header: Set only bottom border on header row
+    - Separate sections: Set bottom border to divide content
+    """
+
+    bottom: typing.Optional[BorderModel] = pydantic.Field(default=None)
+    """
+    Bottom border of the cell
+    """
+
+    left: typing.Optional[BorderModel] = pydantic.Field(default=None)
+    """
+    Left border of the cell
+    """
+
+    right: typing.Optional[BorderModel] = pydantic.Field(default=None)
+    """
+    Right border of the cell
+    """
+
+    top: typing.Optional[BorderModel] = pydantic.Field(default=None)
+    """
+    Top border of the cell
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

athena/types/cell_format.py

@@ -0,0 +1,60 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+import typing_extensions
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from ..core.serialization import FieldMetadata
+from .borders_model import BordersModel
+from .cell_format_horizontal_alignment import CellFormatHorizontalAlignment
+from .cell_format_vertical_alignment import CellFormatVerticalAlignment
+from .number_format_model import NumberFormatModel
+from .text_format_model import TextFormatModel
+from .textrotation import Textrotation
+from .theme_color import ThemeColor
+from .wrap_strategy import WrapStrategy
+
+
+class CellFormat(UniversalBaseModel):
+    background_color_hex: typing_extensions.Annotated[
+        typing.Optional[str], FieldMetadata(alias="backgroundColor_hex")
+    ] = pydantic.Field(default=None)
+    """
+    Background color as hex string (e.g., '#FF0000'). Use either backgroundColor_hex or backgroundColor_theme, not both.
+    """
+
+    background_color_theme: typing_extensions.Annotated[
+        typing.Optional[ThemeColor], FieldMetadata(alias="backgroundColor_theme")
+    ] = pydantic.Field(default=None)
+    """
+    Background color as theme reference. Use either backgroundColor_hex or backgroundColor_theme, not both.
+    """
+
+    borders: typing.Optional[BordersModel] = None
+    horizontal_alignment: typing_extensions.Annotated[
+        typing.Optional[CellFormatHorizontalAlignment], FieldMetadata(alias="horizontalAlignment")
+    ] = None
+    indent: typing.Optional[int] = None
+    number_format: typing_extensions.Annotated[
+        typing.Optional[NumberFormatModel], FieldMetadata(alias="numberFormat")
+    ] = None
+    text_format: typing_extensions.Annotated[typing.Optional[TextFormatModel], FieldMetadata(alias="textFormat")] = None
+    text_rotation: typing_extensions.Annotated[typing.Optional[Textrotation], FieldMetadata(alias="textRotation")] = (
+        None
+    )
+    vertical_alignment: typing_extensions.Annotated[
+        typing.Optional[CellFormatVerticalAlignment], FieldMetadata(alias="verticalAlignment")
+    ] = None
+    wrap_strategy: typing_extensions.Annotated[typing.Optional[WrapStrategy], FieldMetadata(alias="wrapStrategy")] = (
+        None
+    )
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

athena/types/cell_format_horizontal_alignment.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+CellFormatHorizontalAlignment = typing.Union[typing.Literal["left", "right", "center"], typing.Any]

athena/types/cell_format_vertical_alignment.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+CellFormatVerticalAlignment = typing.Union[typing.Literal["top", "middle", "bottom"], typing.Any]

athena/types/conversation_asset_info.py

@@ -4,6 +4,7 @@ import typing
 
 import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .conversation_message import ConversationMessage
 
 
 class ConversationAssetInfo(UniversalBaseModel):
@@ -36,12 +37,17 @@ class ConversationAssetInfo(UniversalBaseModel):
     User ID who created the conversation
     """
 
+    error: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Error details if the conversation execution failed
+    """
+
     last_channel: typing.Optional[str] = pydantic.Field(default=None)
     """
     Last active channel for the conversation
     """
 
-    last_message: typing.Optional[typing.Optional[typing.Any]] = pydantic.Field(default=None)
+    last_message: typing.Optional[ConversationMessage] = pydantic.Field(default=None)
     """
     Last message in the conversation
     """
@@ -60,7 +66,7 @@ class ConversationAssetInfo(UniversalBaseModel):
     List of linked project assets
     """
 
-    messages: typing.Optional[typing.List[typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    messages: typing.Optional[typing.List[ConversationMessage]] = pydantic.Field(default=None)
     """
     Complete list of messages in the conversation from checkpoints
     """

athena/types/conversation_message.py

@@ -0,0 +1,42 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .content import Content
+
+
+class ConversationMessage(UniversalBaseModel):
+    """
+    Model representing a single conversation message.
+    """
+
+    additional_kwargs: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Additional message metadata
+    """
+
+    content: Content = pydantic.Field()
+    """
+    Message content as text or structured content blocks
+    """
+
+    id: str = pydantic.Field()
+    """
+    Unique identifier for the message
+    """
+
+    role: str = pydantic.Field()
+    """
+    Role of the message sender (user, assistant, system)
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

athena/types/conversation_result.py

@@ -0,0 +1,67 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .conversation_message import ConversationMessage
+
+
+class ConversationResult(UniversalBaseModel):
+    """
+    Model representing the conversation result from task/AOP execution.
+    """
+
+    conversation_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    ID of the conversation asset
+    """
+
+    created_at: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    ISO timestamp when conversation was created
+    """
+
+    last_assistant_message: typing.Optional[ConversationMessage] = pydantic.Field(default=None)
+    """
+    The last message from the assistant
+    """
+
+    messages: typing.Optional[typing.List[ConversationMessage]] = pydantic.Field(default=None)
+    """
+    Complete list of messages in the conversation
+    """
+
+    messages_source: str = pydantic.Field()
+    """
+    Source of the messages (e.g., 'checkpoints')
+    """
+
+    metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Additional conversation metadata
+    """
+
+    num_messages: int = pydantic.Field()
+    """
+    Total number of messages in the conversation
+    """
+
+    title: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Title of the conversation
+    """
+
+    updated_at: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    ISO timestamp when conversation was last updated
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

athena/types/creatable_asset_type.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+CreatableAssetType = typing.Union[typing.Literal["spreadsheet", "document", "folder"], typing.Any]