Merge pull request opensandbox-group#1002 from ninan-nn/feature/update_generated_code_20260608

chore(sdks): update auto-generated code

Author: Pangjiping

sdks/sandbox/javascript/src/api/lifecycle.ts

@@ -689,14 +689,14 @@ export interface paths {
         get: {
             parameters: {
                 query?: {
-                    /** @description Whether to return a server-proxied URL */
+                    /** @description Whether to return a server-proxied URL. Cannot be combined with `expires`. */
                     use_server_proxy?: boolean;
                     /**
                      * @description Optional. When set, the server **issues a signed** access route (OSEP-0011). The value
                      *     is **Linux / Unix epoch seconds** — a decimal `uint64` count of **whole seconds** since
                      *     the Unix epoch (`1970-01-01 00:00:00` UTC, same as POSIX / `time(2)`), not
                      *     milliseconds. Normalized to `expires_b36` for the four-segment route token. Omit to
-                     *     get the unsigned/legacy response shape.
+                     *     get the unsigned/legacy response shape. Cannot be combined with `use_server_proxy=true`.
                      */
                     expires?: string;
                 };
@@ -1008,13 +1008,21 @@ export interface components {
             [key: string]: string | null;
         };
         /**
-         * @description Request to create a new sandbox from either a container image or a snapshot.
-         *     Exactly one of `image` or `snapshotId` must be provided.
+         * @description Request to create a new sandbox from either a container image, a snapshot,
+         *     or a pre-configured pool (via `extensions.poolRef`).
+         *
+         *     **Standard mode**: Exactly one of `image` or `snapshotId` must be provided,
+         *     and `resourceLimits` is required.
          *
          *     When `image` is provided, `entrypoint` is required. When `snapshotId` is
          *     provided, `entrypoint` is optional. If omitted, the server defaults the
          *     sandbox entrypoint to `["tail", "-f", "/dev/null"]`.
          *
+         *     **Pool mode**: When `extensions.poolRef` is set, the sandbox is created from
+         *     a pre-configured pool. In this case `image`, `entrypoint`, and
+         *     `resourceLimits` are all optional (defined by the Pool CRD template).
+         *     `snapshotId` must not be provided together with `poolRef`.
+         *
          *     **Note**: API Key authentication is required via the `OPEN-SANDBOX-API-KEY` header.
          */
         CreateSandboxRequest: {
@@ -1047,9 +1055,11 @@ export interface components {
             timeout?: number | null;
             /**
              * @description Runtime resource constraints for the sandbox instance.
+             *     Required when `extensions.poolRef` is not set.
+             *     Optional when using pool mode (resource limits are defined by the Pool CRD template).
              *     SDK clients should provide sensible defaults (e.g., cpu: "500m", memory: "512Mi").
              */
-            resourceLimits: components["schemas"]["ResourceLimits"];
+            resourceLimits?: components["schemas"]["ResourceLimits"];
             /**
              * @description Environment variables to inject into the sandbox runtime.
              * @example {

sdks/sandbox/python/src/opensandbox/api/lifecycle/api/sandboxes/post_sandboxes.py

@@ -116,14 +116,22 @@ def sync_detailed(
     - `OPEN-SANDBOX-API-KEY: <api-key>` header
 
     Args:
-        body (CreateSandboxRequest): Request to create a new sandbox from either a container image
-            or a snapshot.
-            Exactly one of `image` or `snapshotId` must be provided.
+        body (CreateSandboxRequest): Request to create a new sandbox from either a container
+            image, a snapshot,
+            or a pre-configured pool (via `extensions.poolRef`).
+
+            **Standard mode**: Exactly one of `image` or `snapshotId` must be provided,
+            and `resourceLimits` is required.
 
             When `image` is provided, `entrypoint` is required. When `snapshotId` is
             provided, `entrypoint` is optional. If omitted, the server defaults the
             sandbox entrypoint to `["tail", "-f", "/dev/null"]`.
 
+            **Pool mode**: When `extensions.poolRef` is set, the sandbox is created from
+            a pre-configured pool. In this case `image`, `entrypoint`, and
+            `resourceLimits` are all optional (defined by the Pool CRD template).
+            `snapshotId` must not be provided together with `poolRef`.
+
             **Note**: API Key authentication is required via the `OPEN-SANDBOX-API-KEY` header.
 
     Raises:
@@ -170,14 +178,22 @@ def sync(
     - `OPEN-SANDBOX-API-KEY: <api-key>` header
 
     Args:
-        body (CreateSandboxRequest): Request to create a new sandbox from either a container image
-            or a snapshot.
-            Exactly one of `image` or `snapshotId` must be provided.
+        body (CreateSandboxRequest): Request to create a new sandbox from either a container
+            image, a snapshot,
+            or a pre-configured pool (via `extensions.poolRef`).
+
+            **Standard mode**: Exactly one of `image` or `snapshotId` must be provided,
+            and `resourceLimits` is required.
 
             When `image` is provided, `entrypoint` is required. When `snapshotId` is
             provided, `entrypoint` is optional. If omitted, the server defaults the
             sandbox entrypoint to `["tail", "-f", "/dev/null"]`.
 
+            **Pool mode**: When `extensions.poolRef` is set, the sandbox is created from
+            a pre-configured pool. In this case `image`, `entrypoint`, and
+            `resourceLimits` are all optional (defined by the Pool CRD template).
+            `snapshotId` must not be provided together with `poolRef`.
+
             **Note**: API Key authentication is required via the `OPEN-SANDBOX-API-KEY` header.
 
     Raises:
@@ -219,14 +235,22 @@ async def asyncio_detailed(
     - `OPEN-SANDBOX-API-KEY: <api-key>` header
 
     Args:
-        body (CreateSandboxRequest): Request to create a new sandbox from either a container image
-            or a snapshot.
-            Exactly one of `image` or `snapshotId` must be provided.
+        body (CreateSandboxRequest): Request to create a new sandbox from either a container
+            image, a snapshot,
+            or a pre-configured pool (via `extensions.poolRef`).
+
+            **Standard mode**: Exactly one of `image` or `snapshotId` must be provided,
+            and `resourceLimits` is required.
 
             When `image` is provided, `entrypoint` is required. When `snapshotId` is
             provided, `entrypoint` is optional. If omitted, the server defaults the
             sandbox entrypoint to `["tail", "-f", "/dev/null"]`.
 
+            **Pool mode**: When `extensions.poolRef` is set, the sandbox is created from
+            a pre-configured pool. In this case `image`, `entrypoint`, and
+            `resourceLimits` are all optional (defined by the Pool CRD template).
+            `snapshotId` must not be provided together with `poolRef`.
+
             **Note**: API Key authentication is required via the `OPEN-SANDBOX-API-KEY` header.
 
     Raises:
@@ -271,14 +295,22 @@ async def asyncio(
     - `OPEN-SANDBOX-API-KEY: <api-key>` header
 
     Args:
-        body (CreateSandboxRequest): Request to create a new sandbox from either a container image
-            or a snapshot.
-            Exactly one of `image` or `snapshotId` must be provided.
+        body (CreateSandboxRequest): Request to create a new sandbox from either a container
+            image, a snapshot,
+            or a pre-configured pool (via `extensions.poolRef`).
+
+            **Standard mode**: Exactly one of `image` or `snapshotId` must be provided,
+            and `resourceLimits` is required.
 
             When `image` is provided, `entrypoint` is required. When `snapshotId` is
             provided, `entrypoint` is optional. If omitted, the server defaults the
             sandbox entrypoint to `["tail", "-f", "/dev/null"]`.
 
+            **Pool mode**: When `extensions.poolRef` is set, the sandbox is created from
+            a pre-configured pool. In this case `image`, `entrypoint`, and
+            `resourceLimits` are all optional (defined by the Pool CRD template).
+            `snapshotId` must not be provided together with `poolRef`.
+
             **Note**: API Key authentication is required via the `OPEN-SANDBOX-API-KEY` header.
 
     Raises:

sdks/sandbox/python/src/opensandbox/api/lifecycle/models/create_sandbox_request.py

@@ -40,25 +40,24 @@
 
 @_attrs_define
 class CreateSandboxRequest:
-    """Request to create a new sandbox from either a container image or a snapshot.
-    Exactly one of `image` or `snapshotId` must be provided.
+    """Request to create a new sandbox from either a container image, a snapshot,
+    or a pre-configured pool (via `extensions.poolRef`).
+
+    **Standard mode**: Exactly one of `image` or `snapshotId` must be provided,
+    and `resourceLimits` is required.
 
     When `image` is provided, `entrypoint` is required. When `snapshotId` is
     provided, `entrypoint` is optional. If omitted, the server defaults the
     sandbox entrypoint to `["tail", "-f", "/dev/null"]`.
 
+    **Pool mode**: When `extensions.poolRef` is set, the sandbox is created from
+    a pre-configured pool. In this case `image`, `entrypoint`, and
+    `resourceLimits` are all optional (defined by the Pool CRD template).
+    `snapshotId` must not be provided together with `poolRef`.
+
     **Note**: API Key authentication is required via the `OPEN-SANDBOX-API-KEY` header.
 
         Attributes:
-            resource_limits (ResourceLimits): Runtime resource constraints as key-value pairs. Similar to Kubernetes
-                resource specifications,
-                allows flexible definition of resource limits. Common resource types include:
-                - `cpu`: CPU allocation in millicores (e.g., "250m" for 0.25 CPU cores)
-                - `memory`: Memory allocation in bytes or human-readable format (e.g., "512Mi", "1Gi")
-                - `gpu`: Number of GPU devices (e.g., "1")
-
-                New resource types can be added without API changes.
-                 Example: {'cpu': '500m', 'memory': '512Mi', 'gpu': '1'}.
             image (ImageSpec | Unset): Container image specification for sandbox provisioning.
 
                 Supports public registry images and private registry images with authentication.
@@ -82,6 +81,15 @@ class CreateSandboxRequest:
                 Omit this field or set it to null to disable automatic expiration and require explicit cleanup.
                 Note: manual cleanup support is runtime-dependent; Kubernetes providers may reject
                 omitted or null timeout when the underlying workload provider does not support non-expiring sandboxes.
+            resource_limits (ResourceLimits | Unset): Runtime resource constraints as key-value pairs. Similar to Kubernetes
+                resource specifications,
+                allows flexible definition of resource limits. Common resource types include:
+                - `cpu`: CPU allocation in millicores (e.g., "250m" for 0.25 CPU cores)
+                - `memory`: Memory allocation in bytes or human-readable format (e.g., "512Mi", "1Gi")
+                - `gpu`: Number of GPU devices (e.g., "1")
+
+                New resource types can be added without API changes.
+                 Example: {'cpu': '500m', 'memory': '512Mi', 'gpu': '1'}.
             env (CreateSandboxRequestEnv | Unset): Environment variables to inject into the sandbox runtime. Example:
                 {'API_KEY': 'secret-key', 'DEBUG': 'true', 'LOG_LEVEL': 'info'}.
             metadata (CreateSandboxRequestMetadata | Unset): Custom key-value metadata for management, filtering, and
@@ -140,11 +148,11 @@ class CreateSandboxRequest:
                 via `validate_extensions` in server `src/extensions/validation.py`).
     """
 
-    resource_limits: ResourceLimits
     image: ImageSpec | Unset = UNSET
     snapshot_id: str | Unset = UNSET
     platform: PlatformSpec | Unset = UNSET
     timeout: int | None | Unset = UNSET
+    resource_limits: ResourceLimits | Unset = UNSET
     env: CreateSandboxRequestEnv | Unset = UNSET
     metadata: CreateSandboxRequestMetadata | Unset = UNSET
     entrypoint: list[str] | Unset = UNSET
@@ -155,8 +163,6 @@ class CreateSandboxRequest:
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
-        resource_limits = self.resource_limits.to_dict()
-
         image: dict[str, Any] | Unset = UNSET
         if not isinstance(self.image, Unset):
             image = self.image.to_dict()
@@ -173,6 +179,10 @@ def to_dict(self) -> dict[str, Any]:
         else:
             timeout = self.timeout
 
+        resource_limits: dict[str, Any] | Unset = UNSET
+        if not isinstance(self.resource_limits, Unset):
+            resource_limits = self.resource_limits.to_dict()
+
         env: dict[str, Any] | Unset = UNSET
         if not isinstance(self.env, Unset):
             env = self.env.to_dict()
@@ -204,11 +214,7 @@ def to_dict(self) -> dict[str, Any]:
 
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
-        field_dict.update(
-            {
-                "resourceLimits": resource_limits,
-            }
-        )
+        field_dict.update({})
         if image is not UNSET:
             field_dict["image"] = image
         if snapshot_id is not UNSET:
@@ -217,6 +223,8 @@ def to_dict(self) -> dict[str, Any]:
             field_dict["platform"] = platform
         if timeout is not UNSET:
             field_dict["timeout"] = timeout
+        if resource_limits is not UNSET:
+            field_dict["resourceLimits"] = resource_limits
         if env is not UNSET:
             field_dict["env"] = env
         if metadata is not UNSET:
@@ -246,8 +254,6 @@ def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
         from ..models.volume import Volume
 
         d = dict(src_dict)
-        resource_limits = ResourceLimits.from_dict(d.pop("resourceLimits"))
-
         _image = d.pop("image", UNSET)
         image: ImageSpec | Unset
         if isinstance(_image, Unset):
@@ -273,6 +279,13 @@ def _parse_timeout(data: object) -> int | None | Unset:
 
         timeout = _parse_timeout(d.pop("timeout", UNSET))
 
+        _resource_limits = d.pop("resourceLimits", UNSET)
+        resource_limits: ResourceLimits | Unset
+        if isinstance(_resource_limits, Unset):
+            resource_limits = UNSET
+        else:
+            resource_limits = ResourceLimits.from_dict(_resource_limits)
+
         _env = d.pop("env", UNSET)
         env: CreateSandboxRequestEnv | Unset
         if isinstance(_env, Unset):
@@ -315,11 +328,11 @@ def _parse_timeout(data: object) -> int | None | Unset:
             extensions = CreateSandboxRequestExtensions.from_dict(_extensions)
 
         create_sandbox_request = cls(
-            resource_limits=resource_limits,
             image=image,
             snapshot_id=snapshot_id,
             platform=platform,
             timeout=timeout,
+            resource_limits=resource_limits,
             env=env,
             metadata=metadata,
             entrypoint=entrypoint,