feat: update deployments schemas to include volume versions

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 74
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai%2Ftogetherai-41003d5ea35fdc4ec5c03cd7933dc5fee020d818abb1ea71f1d20d767cce06a0.yml
-openapi_spec_hash: 651ade27191eb5ad232ec508418fe4cb
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai%2Ftogetherai-e5c92952e92ccb3c9c93ff9bcfe7ff7b781d30e459b16c6e7edc4dd19112ede1.yml
+openapi_spec_hash: 10014e35650093070d25bb2b0fc07640
 config_hash: b66198d27b4d5c152688ff6cccfdeab5

src/together/resources/beta/jig/volumes.py

@@ -61,7 +61,7 @@ def create(
         Create a new volume to preload files in deployments
 
         Args:
-          content: Content specifies the content configuration for this volume
+          content: Content specifies the new content that will be preloaded to this volume
 
           name: Name is the unique identifier for the volume within the project
 
@@ -270,7 +270,7 @@ async def create(
         Create a new volume to preload files in deployments
 
         Args:
-          content: Content specifies the content configuration for this volume
+          content: Content specifies the new content that will be preloaded to this volume
 
           name: Name is the unique identifier for the volume within the project
 

src/together/types/beta/deployment.py

@@ -88,6 +88,13 @@ class Volume(BaseModel):
     Must reference an existing volume by name or ID
     """
 
+    version: Optional[int] = None
+    """Version is the volume version to mount.
+
+    On create, defaults to the latest version. On update, defaults to the currently
+    mounted version.
+    """
+
 
 class Deployment(BaseModel):
     id: Optional[str] = None

src/together/types/beta/jig/volume.py

@@ -1,15 +1,46 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import Dict, List, Optional
 from typing_extensions import Literal
 
 from ...._models import BaseModel
 
-__all__ = ["Volume", "Content"]
+__all__ = ["Volume", "Content", "ContentFile", "VersionHistory", "VersionHistoryContent"]
+
+
+class ContentFile(BaseModel):
+    last_modified: Optional[str] = None
+    """LastModified is the timestamp when the file was last modified"""
+
+    name: Optional[str] = None
+    """Name is the filename including extension (e.g., "model_weights.bin")"""
+
+    size: Optional[int] = None
+    """Size is the file size in bytes"""
 
 
 class Content(BaseModel):
-    """Content specifies the content that will be preloaded to this volume"""
+    files: Optional[List[ContentFile]] = None
+    """
+    Files is the list of files that will be preloaded into the volume, if the volume
+    content type is "files"
+    """
+
+    source_prefix: Optional[str] = None
+    """
+    SourcePrefix is the file path prefix for the content to be preloaded into the
+    volume
+    """
+
+    type: Optional[Literal["files"]] = None
+    """
+    Type is the content type (currently only "files" is supported which allows
+    preloading files uploaded via Files API into the volume)
+    """
+
+
+class VersionHistoryContent(BaseModel):
+    """Content specifies the new content that will be preloaded to this volume"""
 
     source_prefix: Optional[str] = None
     """
@@ -24,24 +55,46 @@ class Content(BaseModel):
     """
 
 
+class VersionHistory(BaseModel):
+    content: Optional[VersionHistoryContent] = None
+    """Content specifies the new content that will be preloaded to this volume"""
+
+    mounted_by: Optional[List[str]] = None
+
+    version: Optional[int] = None
+
+
 class Volume(BaseModel):
     id: Optional[str] = None
     """ID is the unique identifier for this volume"""
 
     content: Optional[Content] = None
-    """Content specifies the content that will be preloaded to this volume"""
 
     created_at: Optional[str] = None
     """CreatedAt is the ISO8601 timestamp when this volume was created"""
 
+    current_version: Optional[int] = None
+    """CurrentVersion is the current version number of this volume"""
+
+    mounted_by: Optional[List[str]] = None
+    """
+    MountedBy is the list of deployment IDs currently mounting current volume
+    version
+    """
+
     name: Optional[str] = None
     """Name is the name of the volume"""
 
-    object: Optional[Literal["volume"]] = None
-    """The object type, which is always `volume`."""
+    object: Optional[str] = None
+    """Object is the type identifier for this response (always "volume")"""
 
     type: Optional[Literal["readOnly"]] = None
-    """Type is the volume type (e.g., "readOnly")"""
 
     updated_at: Optional[str] = None
     """UpdatedAt is the ISO8601 timestamp when this volume was last updated"""
+
+    version_history: Optional[Dict[str, VersionHistory]] = None
+    """
+    VersionHistory contains previous versions of this volume, keyed by version
+    number
+    """

src/together/types/beta/jig/volume_create_params.py

@@ -9,7 +9,7 @@
 
 class VolumeCreateParams(TypedDict, total=False):
     content: Required[Content]
-    """Content specifies the content configuration for this volume"""
+    """Content specifies the new content that will be preloaded to this volume"""
 
     name: Required[str]
     """Name is the unique identifier for the volume within the project"""
@@ -19,7 +19,7 @@ class VolumeCreateParams(TypedDict, total=False):
 
 
 class Content(TypedDict, total=False):
-    """Content specifies the content configuration for this volume"""
+    """Content specifies the new content that will be preloaded to this volume"""
 
     source_prefix: str
     """

src/together/types/beta/jig_deploy_params.py

@@ -148,3 +148,10 @@ class Volume(TypedDict, total=False):
 
     Must reference an existing volume by name or ID
     """
+
+    version: int
+    """Version is the volume version to mount.
+
+    On create, defaults to the latest version. On update, defaults to the currently
+    mounted version.
+    """

src/together/types/beta/jig_update_params.py

@@ -139,3 +139,10 @@ class Volume(TypedDict, total=False):
 
     Must reference an existing volume by name or ID
     """
+
+    version: int
+    """Version is the volume version to mount.
+
+    On create, defaults to the latest version. On update, defaults to the currently
+    mounted version.
+    """

tests/api_resources/beta/test_jig.py

@@ -97,6 +97,7 @@ def test_method_update_with_all_params(self, client: Together) -> None:
                 {
                     "mount_path": "mount_path",
                     "name": "name",
+                    "version": 0,
                 }
             ],
         )
@@ -197,6 +198,7 @@ def test_method_deploy_with_all_params(self, client: Together) -> None:
                 {
                     "mount_path": "mount_path",
                     "name": "name",
+                    "version": 0,
                 }
             ],
         )
@@ -396,6 +398,7 @@ async def test_method_update_with_all_params(self, async_client: AsyncTogether)
                 {
                     "mount_path": "mount_path",
                     "name": "name",
+                    "version": 0,
                 }
             ],
         )
@@ -496,6 +499,7 @@ async def test_method_deploy_with_all_params(self, async_client: AsyncTogether)
                 {
                     "mount_path": "mount_path",
                     "name": "name",
+                    "version": 0,
                 }
             ],
         )