render 1.7.0__tar.gz → 1.8.0__tar.gz

{render-1.7.0 → render-1.8.0}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [1.8.0] - 2026-11-06
+
+### Added
+
+- (Sandboxes) Sandbox names: `sandboxes.create()` accepts `name`, a label like `my-agent`, and `sandboxes.list()` accepts `name` to return only sandboxes with exactly that name. `Sandbox.name` returns it. Names aren't unique, so use the sandbox ID to address one sandbox.
+- (Sandboxes) `sandboxes.delete_group()` deletes a sandbox group and terminates its sandboxes. It raises `SandboxGroupDefaultNotDeletableError` for the workspace's default group.
+- (Sandboxes) `sandboxes.set_default_group()` makes a sandbox group the workspace's default.
+- (Sandboxes) `SandboxGroupSuspendedError`, raised by `delete_group()` and `set_default_group()` for a suspended group.
+- `ErrorCode.DEFAULT_SANDBOX_GROUP_NOT_DELETABLE` and `ErrorCode.INVALID_SANDBOX_NAME` for the matching API error codes.
+- `default_version_id` on `Workflow`.
+
+### Fixed
+
+- (Workflows) A flow can catch the `StepError` from a step's final failed attempt and continue. An uncaught `StepError` fails the run with the last step error. Replay keeps the recorded attempt.
+- (Sandboxes) `sandboxes.create()` from a snapshot without `timeout_seconds` or `idle_timeout_seconds` keeps the source sandbox's timeouts. Before, the client always sent the 24-hour and 15-minute defaults.
+
 ## [1.7.0] - 2026-11-02
 
 ### Added

{render-1.7.0 → render-1.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: render
-Version: 1.7.0
+Version: 1.8.0
 Summary: Python SDK for Render Workflows
 Author-email: Render <support@render.com>
 License-File: LICENSE

{render-1.7.0 → render-1.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "render"
-version = "1.7.0"
+version = "1.8.0"
 description = "Python SDK for Render Workflows"
 authors = [{ name = "Render", email = "support@render.com" }]
 readme = "README.md"

{render-1.7.0 → render-1.8.0}/render/__init__.py

@@ -36,7 +36,7 @@ Async REST API access:
 # Must stay the first import: it records when SDK import began.
 from render import _startup
 
-__version__ = "1.7.0"
+__version__ = "1.8.0"
 
 # Render/RenderAsync are lazy-loaded so the workflow worker path stays fast.
 from typing import TYPE_CHECKING

{render-1.7.0 → render-1.8.0}/render/client/errors.py

@@ -6,7 +6,7 @@ if TYPE_CHECKING:
 
     # Type-only: the step models raise these errors, so a runtime import
     # would be circular.
-    from render.workflows._models.step import StepKey
+    from render.workflows._models.step import StepAttemptRecord, StepKey
     from render.workflows._models.task import DeterminismDetails
     from render.workflows.client import CallbackRequest
 
@@ -102,6 +102,10 @@ class ExecutionError(RenderError):
         self.session_id = session_id
         self.step_key = step_key
 
+    def to_step_completion(self) -> "StepAttemptRecord | None":
+        """The failed attempt to complete before exposing this error, if any."""
+        return None
+
     def to_callback_request(self) -> "CallbackRequest":
         """The error callback that reports this error as the task's failure."""
         # Imported here: the workflow client imports these errors.
@@ -136,9 +140,24 @@ class FlowRunError(RenderError):
         self.details = details
 
 
+class StepError(ExecutionError):
+    """A step failure that flow code can catch, including on replay."""
+
+    def __init__(
+        self,
+        *args: object,
+        completion: "StepAttemptRecord | None" = None,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(*args, **kwargs)
+        self._completion = completion
+
+    def to_step_completion(self) -> "StepAttemptRecord | None":
+        return self._completion
+
+
 class TerminalFlowError(ExecutionError):
-    """Exception for a flow step error that retrying won't fix. A step
-    that raises it fails without using its remaining retries."""
+    """Internal runtime error that stops the flow even if user code catches it."""
 
     def __init__(
         self,
@@ -281,10 +300,6 @@ class FlowHistoryErrorCode(str, Enum):
     """The steps' seqs don't count up from zero without skipping one."""
     AFTER_OPEN = "WFL-HIST-AFTER-OPEN"
     """A step comes after one that never finished."""
-    AFTER_TERMINAL = "WFL-HIST-AFTER-TERMINAL"
-    """A step comes after one that ended the run."""
-    TERMINAL = "WFL-HIST-TERMINAL"
-    """The last step ended the run, so there's nothing left to replay."""
     ATTEMPT_STEP = "WFL-HIST-ATTEMPT-STEP"
     """A failed attempt was made before its step started."""
     ATTEMPT_SEQ = "WFL-HIST-ATTEMPT-SEQ"

{render-1.7.0 → render-1.8.0}/render/experimental/sandbox/__init__.py

@@ -18,6 +18,8 @@ from render.experimental.sandbox.errors import (
     SandboxExecError,
     SandboxExecStreamError,
     SandboxFileNotFoundError,
+    SandboxGroupDefaultNotDeletableError,
+    SandboxGroupSuspendedError,
     SandboxNotFoundError,
     SandboxNotRunningError,
     SandboxWaitTimeoutError,
@@ -56,6 +58,7 @@ __all__ = [
     "BuildNotFoundError",
     "BuildNotReadyError",
     "BuildSource",
+    "SandboxGroupDefaultNotDeletableError",
     "EgressRule",
     "Image",
     "ImageClient",
@@ -79,6 +82,7 @@ __all__ = [
     "SandboxFileNotFoundError",
     "SandboxGroup",
     "SandboxGroupList",
+    "SandboxGroupSuspendedError",
     "SandboxList",
     "SandboxNotFoundError",
     "SandboxNotRunningError",

{render-1.7.0 → render-1.8.0}/render/experimental/sandbox/api.py

@@ -39,6 +39,8 @@ from render.experimental.sandbox.errors import (
     SandboxExecError,
     SandboxExecStreamError,
     SandboxFileNotFoundError,
+    SandboxGroupDefaultNotDeletableError,
+    SandboxGroupSuspendedError,
     SandboxNotFoundError,
     SnapshotNotFoundError,
     SnapshotNotReadyError,
@@ -76,6 +78,7 @@ from render.public_api.api.sandboxes import (
     create_sandbox_build,
     create_sandbox_group,
     create_sandbox_snapshot,
+    delete_sandbox_group,
     delete_sandbox_snapshot,
     list_sandbox_groups,
     list_sandbox_snapshots,
@@ -84,6 +87,7 @@ from render.public_api.api.sandboxes import (
     retrieve_sandbox_build,
     retrieve_sandbox_group,
     retrieve_sandbox_snapshot,
+    set_default_sandbox_group,
     terminate_sandbox,
     update_sandbox_group,
 )
@@ -138,6 +142,10 @@ _SNAPSHOT_PLAN_MISMATCH_CODE = "snapshot_plan_mismatch"
 # The API still calls images builds, in its paths and error codes.
 _IMAGE_NOT_FOUND_CODE = "build_not_found"
 _IMAGE_NOT_SUCCEEDED_CODE = "build_not_succeeded"
+_GROUP_CONFLICT_ERRORS: dict[str, type[ClientError]] = {
+    "default_sandbox_group_not_deletable": SandboxGroupDefaultNotDeletableError,
+    "sandbox_group_suspended": SandboxGroupSuspendedError,
+}
 
 # Aliased at module scope so the annotations on the _api_call methods resolve
 # the builtin list, not the SandboxApi.list method that shadows it in the class body.
@@ -195,6 +203,7 @@ def _to_sandbox(model: GeneratedSandbox) -> Sandbox:
     return Sandbox(
         id=model.id,
         sandbox_group_id=_set_or_none(model.sandbox_group_id),
+        name=_set_or_none(model.name),
         status=model.status.value,
         plan=str(model.plan),
         network_policy=_to_network_policy(model.network_policy),
@@ -325,6 +334,18 @@ def _handle_image_api_error(
     handle_api_error(response, operation)
 
 
+def _handle_group_api_error(response: Response[Any], operation: str) -> None:
+    if response.status_code == 409:
+        error = _error_body(response.content)
+        error_type = _GROUP_CONFLICT_ERRORS.get(error.code or "")
+        if error_type is not None:
+            message = f"{operation} failed"
+            if error.message:
+                message = f"{message}: {error.message}"
+            raise error_type(message, code=error.code, status_code=409)
+    handle_api_error(response, operation)
+
+
 class SandboxApi:
     """Typed wrapper over the generated sandbox endpoints."""
 
@@ -345,10 +366,13 @@ class SandboxApi:
         image_id: str | None = None,
         image_name: str | None = None,
         sandbox_group_id: str | None = None,
+        name: str | None = None,
     ) -> Sandbox:
         body = SandboxPOST(owner_id=owner_id)
         if sandbox_group_id is not None:
             body.sandbox_group_id = sandbox_group_id
+        if name is not None:
+            body.name = name
         if plan is not None:
             body.plan = plan
         if timeout_seconds is not None:
@@ -405,10 +429,11 @@ class SandboxApi:
         cursor: str | None,
         limit: int | None,
         sandbox_group_id: str | None = None,
+        name: str | None = None,
     ) -> SandboxList:
         statuses = _normalize_statuses(status, SandboxStatus)
         response = await self._list_api_call(
-            owner_id, statuses, cursor, limit, sandbox_group_id
+            owner_id, statuses, cursor, limit, sandbox_group_id, name
         )
         parsed = response.parsed
         if not isinstance(parsed, list):
@@ -425,6 +450,7 @@ class SandboxApi:
         cursor: str | None,
         limit: int | None,
         sandbox_group_id: str | None = None,
+        name: str | None = None,
     ) -> Response[Error | _SandboxWithCursorList]:
         return await list_sandboxes.asyncio_detailed(
             client=self.client,
@@ -433,6 +459,7 @@ class SandboxApi:
             sandbox_group_id=sandbox_group_id
             if sandbox_group_id is not None
             else UNSET,
+            name=name if name is not None else UNSET,
             cursor=cursor if cursor is not None else UNSET,
             limit=limit if limit is not None else UNSET,
         )
@@ -504,6 +531,25 @@ class SandboxApi:
             )
         return _to_sandbox_group(response.parsed)
 
+    async def delete_group(self, sandbox_group_id: str) -> None:
+        with request_errors("delete sandbox group"):
+            response = await delete_sandbox_group.asyncio_detailed(
+                sandbox_group_id, client=self.client
+            )
+        _handle_group_api_error(response, "delete sandbox group")
+
+    async def set_default_group(self, sandbox_group_id: str) -> SandboxGroup:
+        with request_errors("set default sandbox group"):
+            response = await set_default_sandbox_group.asyncio_detailed(
+                sandbox_group_id, client=self.client
+            )
+        _handle_group_api_error(response, "set default sandbox group")
+        if not isinstance(response.parsed, GeneratedSandboxGroup):
+            raise RenderError(
+                "Failed to set default sandbox group: unexpected response type"
+            )
+        return _to_sandbox_group(response.parsed)
+
     async def terminate(self, sandbox_id: str, owner_id: str) -> None:
         with request_errors("terminate sandbox"):
             response = await terminate_sandbox.asyncio_detailed(

{render-1.7.0 → render-1.8.0}/render/experimental/sandbox/api_sync.py

@@ -41,6 +41,8 @@ from render.experimental.sandbox.errors import (
     SandboxExecError,
     SandboxExecStreamError,
     SandboxFileNotFoundError,
+    SandboxGroupDefaultNotDeletableError,
+    SandboxGroupSuspendedError,
     SandboxNotFoundError,
     SnapshotNotFoundError,
     SnapshotNotReadyError,
@@ -78,6 +80,7 @@ from render.public_api.api.sandboxes import (
     create_sandbox_build,
     create_sandbox_group,
     create_sandbox_snapshot,
+    delete_sandbox_group,
     delete_sandbox_snapshot,
     list_sandbox_groups,
     list_sandbox_snapshots,
@@ -86,6 +89,7 @@ from render.public_api.api.sandboxes import (
     retrieve_sandbox_build,
     retrieve_sandbox_group,
     retrieve_sandbox_snapshot,
+    set_default_sandbox_group,
     terminate_sandbox,
     update_sandbox_group,
 )
@@ -140,6 +144,10 @@ _SNAPSHOT_PLAN_MISMATCH_CODE = "snapshot_plan_mismatch"
 # The API still calls images builds, in its paths and error codes.
 _IMAGE_NOT_FOUND_CODE = "build_not_found"
 _IMAGE_NOT_SUCCEEDED_CODE = "build_not_succeeded"
+_GROUP_CONFLICT_ERRORS: dict[str, type[ClientError]] = {
+    "default_sandbox_group_not_deletable": SandboxGroupDefaultNotDeletableError,
+    "sandbox_group_suspended": SandboxGroupSuspendedError,
+}
 
 # Aliased at module scope so the annotations on the _api_call methods resolve
 # the builtin list, not the SyncSandboxApi.list method that shadows it in the class body.
@@ -197,6 +205,7 @@ def _to_sandbox(model: GeneratedSandbox) -> Sandbox:
     return Sandbox(
         id=model.id,
         sandbox_group_id=_set_or_none(model.sandbox_group_id),
+        name=_set_or_none(model.name),
         status=model.status.value,
         plan=str(model.plan),
         network_policy=_to_network_policy(model.network_policy),
@@ -327,6 +336,18 @@ def _handle_image_api_error(
     handle_api_error(response, operation)
 
 
+def _handle_group_api_error(response: Response[Any], operation: str) -> None:
+    if response.status_code == 409:
+        error = _error_body(response.content)
+        error_type = _GROUP_CONFLICT_ERRORS.get(error.code or "")
+        if error_type is not None:
+            message = f"{operation} failed"
+            if error.message:
+                message = f"{message}: {error.message}"
+            raise error_type(message, code=error.code, status_code=409)
+    handle_api_error(response, operation)
+
+
 class SyncSandboxApi:
     """Typed wrapper over the generated sandbox endpoints."""
 
@@ -347,10 +368,13 @@ class SyncSandboxApi:
         image_id: str | None = None,
         image_name: str | None = None,
         sandbox_group_id: str | None = None,
+        name: str | None = None,
     ) -> Sandbox:
         body = SandboxPOST(owner_id=owner_id)
         if sandbox_group_id is not None:
             body.sandbox_group_id = sandbox_group_id
+        if name is not None:
+            body.name = name
         if plan is not None:
             body.plan = plan
         if timeout_seconds is not None:
@@ -405,10 +429,11 @@ class SyncSandboxApi:
         cursor: str | None,
         limit: int | None,
         sandbox_group_id: str | None = None,
+        name: str | None = None,
     ) -> SandboxList:
         statuses = _normalize_statuses(status, SandboxStatus)
         response = self._list_api_call(
-            owner_id, statuses, cursor, limit, sandbox_group_id
+            owner_id, statuses, cursor, limit, sandbox_group_id, name
         )
         parsed = response.parsed
         if not isinstance(parsed, list):
@@ -425,6 +450,7 @@ class SyncSandboxApi:
         cursor: str | None,
         limit: int | None,
         sandbox_group_id: str | None = None,
+        name: str | None = None,
     ) -> Response[Error | _SandboxWithCursorList]:
         return list_sandboxes.sync_detailed(
             client=self.client,
@@ -433,6 +459,7 @@ class SyncSandboxApi:
             sandbox_group_id=sandbox_group_id
             if sandbox_group_id is not None
             else UNSET,
+            name=name if name is not None else UNSET,
             cursor=cursor if cursor is not None else UNSET,
             limit=limit if limit is not None else UNSET,
         )
@@ -502,6 +529,25 @@ class SyncSandboxApi:
             )
         return _to_sandbox_group(response.parsed)
 
+    def delete_group(self, sandbox_group_id: str) -> None:
+        with request_errors("delete sandbox group"):
+            response = delete_sandbox_group.sync_detailed(
+                sandbox_group_id, client=self.client
+            )
+        _handle_group_api_error(response, "delete sandbox group")
+
+    def set_default_group(self, sandbox_group_id: str) -> SandboxGroup:
+        with request_errors("set default sandbox group"):
+            response = set_default_sandbox_group.sync_detailed(
+                sandbox_group_id, client=self.client
+            )
+        _handle_group_api_error(response, "set default sandbox group")
+        if not isinstance(response.parsed, GeneratedSandboxGroup):
+            raise RenderError(
+                "Failed to set default sandbox group: unexpected response type"
+            )
+        return _to_sandbox_group(response.parsed)
+
     def terminate(self, sandbox_id: str, owner_id: str) -> None:
         with request_errors("terminate sandbox"):
             response = terminate_sandbox.sync_detailed(

{render-1.7.0 → render-1.8.0}/render/experimental/sandbox/client.py

@@ -75,6 +75,7 @@ class SandboxClient:
         self,
         *,
         owner_id: str | None = None,
+        name: str | None = None,
         plan: SandboxPlan | str | None = None,
         timeout_seconds: int | None = None,
         idle_timeout_seconds: int | None = None,
@@ -99,6 +100,10 @@ class SandboxClient:
         sandbox_group_id defaults to the workspace's default group. The group
         determines placement; region is accepted for compatibility and ignored.
 
+        name is a label for the sandbox, like ``my-agent``. Names aren't
+        unique, so use the sandbox id to address it. At most 64 characters,
+        and it can't start with ``sbx-``.
+
         network_policy is a NetworkPolicy, or a policy type string as a
         shorthand for one without rules. To restrict outbound traffic to
         specific destinations, pass
@@ -169,6 +174,7 @@ class SandboxClient:
             image_id=image_id,
             image_name=image_name,
             sandbox_group_id=sandbox_group_id,
+            name=name,
         )
         if wait_settings is None:
             return sandbox
@@ -241,16 +247,18 @@ class SandboxClient:
         cursor: str | None = None,
         limit: int | None = None,
         sandbox_group_id: str | None = None,
+        name: str | None = None,
     ) -> SandboxList:
         """List sandboxes for a workspace.
 
         status filters by sandbox status, one or a sequence of them (each one
         of creating, running, suspended, resuming, errored, terminated). limit
-        is capped at 100 by the API.
+        is capped at 100 by the API. name returns only sandboxes with exactly
+        that name; names aren't unique, so it can match several.
         """
         resolved_owner_id = self._resolve_owner_id(owner_id)
         return await self.api.list(
-            resolved_owner_id, status, cursor, limit, sandbox_group_id
+            resolved_owner_id, status, cursor, limit, sandbox_group_id, name
         )
 
     async def list_groups(
@@ -287,6 +295,24 @@ class SandboxClient:
         """Set concurrency and return the effective limit after Render's cap."""
         return await self.api.update_group(sandbox_group_id, concurrency_limit)
 
+    async def delete_group(self, sandbox_group_id: str) -> None:
+        """Delete a group, terminating its sandboxes.
+
+        Its snapshots and credentials are deleted shortly after. Raises
+        SandboxGroupDefaultNotDeletableError for the workspace's default group;
+        make another group the default first with set_default_group. Raises
+        SandboxGroupSuspendedError for a suspended group.
+        """
+        await self.api.delete_group(sandbox_group_id)
+
+    async def set_default_group(self, sandbox_group_id: str) -> SandboxGroup:
+        """Make a group the workspace's default.
+
+        Setting the current default returns it unchanged. Raises
+        SandboxGroupSuspendedError for a suspended group.
+        """
+        return await self.api.set_default_group(sandbox_group_id)
+
     async def terminate(self, sandbox_id: str, *, owner_id: str | None = None) -> None:
         """Terminate a sandbox.
 

{render-1.7.0 → render-1.8.0}/render/experimental/sandbox/client_sync.py

@@ -77,6 +77,7 @@ class SyncSandboxClient:
         self,
         *,
         owner_id: str | None = None,
+        name: str | None = None,
         plan: SandboxPlan | str | None = None,
         timeout_seconds: int | None = None,
         idle_timeout_seconds: int | None = None,
@@ -101,6 +102,10 @@ class SyncSandboxClient:
         sandbox_group_id defaults to the workspace's default group. The group
         determines placement; region is accepted for compatibility and ignored.
 
+        name is a label for the sandbox, like ``my-agent``. Names aren't
+        unique, so use the sandbox id to address it. At most 64 characters,
+        and it can't start with ``sbx-``.
+
         network_policy is a NetworkPolicy, or a policy type string as a
         shorthand for one without rules. To restrict outbound traffic to
         specific destinations, pass
@@ -171,6 +176,7 @@ class SyncSandboxClient:
             image_id=image_id,
             image_name=image_name,
             sandbox_group_id=sandbox_group_id,
+            name=name,
         )
         if wait_settings is None:
             return sandbox
@@ -243,15 +249,19 @@ class SyncSandboxClient:
         cursor: str | None = None,
         limit: int | None = None,
         sandbox_group_id: str | None = None,
+        name: str | None = None,
     ) -> SandboxList:
         """List sandboxes for a workspace.
 
         status filters by sandbox status, one or a sequence of them (each one
         of creating, running, suspended, resuming, errored, terminated). limit
-        is capped at 100 by the API.
+        is capped at 100 by the API. name returns only sandboxes with exactly
+        that name; names aren't unique, so it can match several.
         """
         resolved_owner_id = self._resolve_owner_id(owner_id)
-        return self.api.list(resolved_owner_id, status, cursor, limit, sandbox_group_id)
+        return self.api.list(
+            resolved_owner_id, status, cursor, limit, sandbox_group_id, name
+        )
 
     def list_groups(
         self,
@@ -285,6 +295,24 @@ class SyncSandboxClient:
         """Set concurrency and return the effective limit after Render's cap."""
         return self.api.update_group(sandbox_group_id, concurrency_limit)
 
+    def delete_group(self, sandbox_group_id: str) -> None:
+        """Delete a group, terminating its sandboxes.
+
+        Its snapshots and credentials are deleted shortly after. Raises
+        SandboxGroupDefaultNotDeletableError for the workspace's default group;
+        make another group the default first with set_default_group. Raises
+        SandboxGroupSuspendedError for a suspended group.
+        """
+        self.api.delete_group(sandbox_group_id)
+
+    def set_default_group(self, sandbox_group_id: str) -> SandboxGroup:
+        """Make a group the workspace's default.
+
+        Setting the current default returns it unchanged. Raises
+        SandboxGroupSuspendedError for a suspended group.
+        """
+        return self.api.set_default_group(sandbox_group_id)
+
     def terminate(self, sandbox_id: str, *, owner_id: str | None = None) -> None:
         """Terminate a sandbox.
 

{render-1.7.0 → render-1.8.0}/render/experimental/sandbox/errors.py

@@ -31,6 +31,17 @@ class SnapshotPlanMismatchError(ClientError):
     a different plan. code is snapshot_plan_mismatch."""
 
 
+class SandboxGroupDefaultNotDeletableError(ClientError):
+    """Raised when a delete names the workspace's default sandbox group. Make
+    another group the default first with set_default_group. code is
+    default_sandbox_group_not_deletable."""
+
+
+class SandboxGroupSuspendedError(ClientError):
+    """Raised when the sandbox group is suspended. code is
+    sandbox_group_suspended."""
+
+
 class ImageNotFoundError(ClientError):
     """Raised when an image does not exist or belongs to another sandbox group."""