Release 0.8.0b12

Author: fern-api[bot]

poetry.lock

@@ -941,6 +941,14 @@ client.prompts.upsert(
 <dl>
 <dd>
 
+**attributes:** `typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]` — Additional fields to describe the Prompt. Helpful to separate Prompt versions from each other with details on how they were created or used.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **commit_message:** `typing.Optional[str]` — Message describing the changes made.
 
 </dd>
@@ -2205,6 +2213,14 @@ client.tools.upsert(
 <dl>
 <dd>
 
+**attributes:** `typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]` — Additional fields to describe the Tool. Helpful to separate Tool versions from each other with details on how they were created or used.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **tool_type:** `typing.Optional[FilesToolType]` — Type of Tool.
 
 </dd>
@@ -3256,6 +3272,14 @@ If `"add"` or `"remove"`, one of the `version_id` or `environment` query paramet
 <dl>
 <dd>
 
+**attributes:** `typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]` — Additional fields to describe the Dataset. Helpful to separate Dataset versions from each other with details on how they were created or used.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **commit_message:** `typing.Optional[str]` — Message describing the changes made. If provided, a committed version of the Dataset is created. Otherwise, an uncommitted version is created.
 
 </dd>
@@ -4162,6 +4186,123 @@ client.datasets.list_environments(
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+## Files
+<details><summary><code>client.files.<a href="src/humanloop/files/client.py">list</a>(...)</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get a paginated list of files.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```python
+from humanloop import Humanloop
+
+client = Humanloop(
+    api_key="YOUR_API_KEY",
+)
+client.files.list()
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**page:** `typing.Optional[int]` — Page offset for pagination.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**size:** `typing.Optional[int]` — Page size for pagination. Number of files to fetch.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**name:** `typing.Optional[str]` — Case-insensitive filter for file name.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**type:** `typing.Optional[typing.Union[FileType, typing.Sequence[FileType]]]` — List of file types to filter for.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**environment:** `typing.Optional[str]` — Case-sensitive filter for files with a deployment in the specified environment. Requires the environment name.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**sort_by:** `typing.Optional[ProjectSortBy]` — Field to sort files by
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**order:** `typing.Optional[SortOrder]` — Direction to sort by.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>

reference.md

@@ -51,6 +51,7 @@
     FeedbackType,
     FileEnvironmentResponse,
     FileEnvironmentResponseFile,
+    FileType,
     FilesToolType,
     FunctionTool,
     FunctionToolChoice,
@@ -82,6 +83,8 @@
     PaginatedDataLogResponse,
     PaginatedDataPromptResponse,
     PaginatedDataToolResponse,
+    PaginatedDataUnionPromptResponseToolResponseDatasetResponseEvaluatorResponse,
+    PaginatedDataUnionPromptResponseToolResponseDatasetResponseEvaluatorResponseRecordsItem,
     PaginatedDatapointResponse,
     PaginatedDatasetResponse,
     PaginatedEvaluationResponse,
@@ -133,7 +136,7 @@
     VersionStatus,
 )
 from .errors import UnprocessableEntityError
-from . import datasets, evaluations, evaluators, logs, prompts, sessions, tools
+from . import datasets, evaluations, evaluators, files, logs, prompts, sessions, tools
 from .client import AsyncHumanloop, Humanloop
 from .environment import HumanloopEnvironment
 from .evaluators import (
@@ -222,6 +225,8 @@
     PaginatedDataLogResponseParams,
     PaginatedDataPromptResponseParams,
     PaginatedDataToolResponseParams,
+    PaginatedDataUnionPromptResponseToolResponseDatasetResponseEvaluatorResponseParams,
+    PaginatedDataUnionPromptResponseToolResponseDatasetResponseEvaluatorResponseRecordsItemParams,
     PaginatedDatapointResponseParams,
     PaginatedDatasetResponseParams,
     PaginatedEvaluationResponseParams,
@@ -361,6 +366,7 @@
     "FileEnvironmentResponseFile",
     "FileEnvironmentResponseFileParams",
     "FileEnvironmentResponseParams",
+    "FileType",
     "FilesToolType",
     "FunctionTool",
     "FunctionToolChoice",
@@ -418,6 +424,10 @@
     "PaginatedDataPromptResponseParams",
     "PaginatedDataToolResponse",
     "PaginatedDataToolResponseParams",
+    "PaginatedDataUnionPromptResponseToolResponseDatasetResponseEvaluatorResponse",
+    "PaginatedDataUnionPromptResponseToolResponseDatasetResponseEvaluatorResponseParams",
+    "PaginatedDataUnionPromptResponseToolResponseDatasetResponseEvaluatorResponseRecordsItem",
+    "PaginatedDataUnionPromptResponseToolResponseDatasetResponseEvaluatorResponseRecordsItemParams",
     "PaginatedDatapointResponse",
     "PaginatedDatapointResponseParams",
     "PaginatedDatasetResponse",
@@ -519,6 +529,7 @@
     "datasets",
     "evaluations",
     "evaluators",
+    "files",
     "logs",
     "prompts",
     "sessions",

src/humanloop/__init__.py

@@ -9,6 +9,7 @@
 from .prompts.client import PromptsClient
 from .tools.client import ToolsClient
 from .datasets.client import DatasetsClient
+from .files.client import FilesClient
 from .evaluations.client import EvaluationsClient
 from .evaluators.client import EvaluatorsClient
 from .logs.client import LogsClient
@@ -17,6 +18,7 @@
 from .prompts.client import AsyncPromptsClient
 from .tools.client import AsyncToolsClient
 from .datasets.client import AsyncDatasetsClient
+from .files.client import AsyncFilesClient
 from .evaluations.client import AsyncEvaluationsClient
 from .evaluators.client import AsyncEvaluatorsClient
 from .logs.client import AsyncLogsClient
@@ -88,6 +90,7 @@ def __init__(
         self.prompts = PromptsClient(client_wrapper=self._client_wrapper)
         self.tools = ToolsClient(client_wrapper=self._client_wrapper)
         self.datasets = DatasetsClient(client_wrapper=self._client_wrapper)
+        self.files = FilesClient(client_wrapper=self._client_wrapper)
         self.evaluations = EvaluationsClient(client_wrapper=self._client_wrapper)
         self.evaluators = EvaluatorsClient(client_wrapper=self._client_wrapper)
         self.logs = LogsClient(client_wrapper=self._client_wrapper)
@@ -159,6 +162,7 @@ def __init__(
         self.prompts = AsyncPromptsClient(client_wrapper=self._client_wrapper)
         self.tools = AsyncToolsClient(client_wrapper=self._client_wrapper)
         self.datasets = AsyncDatasetsClient(client_wrapper=self._client_wrapper)
+        self.files = AsyncFilesClient(client_wrapper=self._client_wrapper)
         self.evaluations = AsyncEvaluationsClient(client_wrapper=self._client_wrapper)
         self.evaluators = AsyncEvaluatorsClient(client_wrapper=self._client_wrapper)
         self.logs = AsyncLogsClient(client_wrapper=self._client_wrapper)

src/humanloop/client.py

@@ -151,6 +151,7 @@ def upsert(
         path: typing.Optional[str] = OMIT,
         id: typing.Optional[str] = OMIT,
         action: typing.Optional[UpdateDatesetAction] = OMIT,
+        attributes: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         commit_message: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> DatasetResponse:
@@ -199,6 +200,9 @@ def upsert(
 
             If `"add"` or `"remove"`, one of the `version_id` or `environment` query parameters may be provided.
 
+        attributes : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            Additional fields to describe the Dataset. Helpful to separate Dataset versions from each other with details on how they were created or used.
+
         commit_message : typing.Optional[str]
             Message describing the changes made. If provided, a committed version of the Dataset is created. Otherwise, an uncommitted version is created.
 
@@ -247,6 +251,7 @@ def upsert(
                     object_=datapoints, annotation=typing.Sequence[CreateDatapointRequestParams]
                 ),
                 "action": action,
+                "attributes": attributes,
                 "commit_message": commit_message,
             },
             request_options=request_options,
@@ -1151,6 +1156,7 @@ async def upsert(
         path: typing.Optional[str] = OMIT,
         id: typing.Optional[str] = OMIT,
         action: typing.Optional[UpdateDatesetAction] = OMIT,
+        attributes: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         commit_message: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> DatasetResponse:
@@ -1199,6 +1205,9 @@ async def upsert(
 
             If `"add"` or `"remove"`, one of the `version_id` or `environment` query parameters may be provided.
 
+        attributes : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            Additional fields to describe the Dataset. Helpful to separate Dataset versions from each other with details on how they were created or used.
+
         commit_message : typing.Optional[str]
             Message describing the changes made. If provided, a committed version of the Dataset is created. Otherwise, an uncommitted version is created.
 
@@ -1255,6 +1264,7 @@ async def main() -> None:
                     object_=datapoints, annotation=typing.Sequence[CreateDatapointRequestParams]
                 ),
                 "action": action,
+                "attributes": attributes,
                 "commit_message": commit_message,
             },
             request_options=request_options,

src/humanloop/datasets/client.py

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