gpuai-sdk 0.3.7__tar.gz → 0.3.8__tar.gz

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gpuai-sdk
-Version: 0.3.7
+Version: 0.3.8
 Summary: GPU.ai Public Developer API
 Home-page: 
 Author: GPU.ai Support
@@ -26,7 +26,7 @@ the dashboard. See https://gpu.ai/docs for details.
 This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 1.0.0
-- Package version: 0.3.7
+- Package version: 0.3.8
 - Generator version: 7.24.0
 - Build package: org.openapitools.codegen.languages.PythonClientCodegen
 

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.8}/README.md

@@ -6,7 +6,7 @@ the dashboard. See https://gpu.ai/docs for details.
 This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 1.0.0
-- Package version: 0.3.7
+- Package version: 0.3.8
 - Generator version: 7.24.0
 - Build package: org.openapitools.codegen.languages.PythonClientCodegen
 

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.8}/gpuai_sdk/__init__.py

@@ -15,7 +15,7 @@
 """  # noqa: E501
 
 
-__version__ = "0.3.7"
+__version__ = "0.3.8"
 
 # Define package exports
 __all__ = [

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.8}/gpuai_sdk/api_client.py

@@ -92,7 +92,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/0.3.7/python'
+        self.user_agent = 'OpenAPI-Generator/0.3.8/python'
         self.client_side_validation = configuration.client_side_validation
 
     def __enter__(self):

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.8}/gpuai_sdk/configuration.py

@@ -552,7 +552,7 @@ class Configuration:
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 1.0.0\n"\
-               "SDK Package Version: 0.3.7".\
+               "SDK Package Version: 0.3.8".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]:

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.8}/gpuai_sdk/models/create_instance_request.py

@@ -42,13 +42,14 @@ class CreateInstanceRequest(BaseModel):
     environment: Optional[StrictStr] = Field(default=None, description="Launch environment. Omit for the provider default (the GPU.ai Certified Image where supported). Accepted values: `certified` (the GPU.ai Certified base image), `certified:<framework>` (a framework layer — see GET /v1/environments for the roster, e.g. `certified:pytorch`), `certified:<framework>@<version>` (a specific framework version, e.g. `certified:pytorch@2.13`), `raw_vm` (root VM, provider default OS), `raw_vm:<os>` (root VM with a chosen OS, e.g. `raw_vm:ubuntu-24.04`), or `provider_template` (the provider's own image). A well-formed value the placed machine can't serve returns 422 `environment_unavailable`.", json_schema_extra={"examples": ["certified:pytorch@2.13"]})
     offering_id: Optional[StrictStr] = Field(default=None, description="Pin the launch to one exact offering (from GET /v1/pricing) so the engine never substitutes a pricier one. If that offering is gone, the launch fails explicitly rather than silently placing elsewhere.")
     disk_gb: Optional[Annotated[int, Field(strict=True, ge=10)]] = Field(default=None, description="Requested instance filesystem size in GB. Omit for the platform default (100 GB), which never narrows placement. Setting it is a hard requirement: placement narrows to capacity that can honor it (see `disk_configurable` on GET /v1/pricing), and a request no offering of the gpu_type can honor returns 422 `disk_unavailable` rather than launching with a different size. When the launch also pins an exact `offering_id`, a disk_gb larger than that offering's displayed `storage_gb` returns 422 `disk_exceeds_offering` rather than launching with a clamped filesystem. Disk beyond the included allowance (100 GB) is billed at the offering's `disk_price_per_gb_hour` (GET /v1/pricing), folded into the instance's single hourly rate. Bounds: at least 10, at most the platform ceiling (currently 1000) — outside them returns 422 `validation_failed`.", json_schema_extra={"examples": [200]})
+    auto_terminate_hours: Optional[Annotated[int, Field(le=720, strict=True, ge=1)]] = Field(default=None, description="Terminate this instance automatically after this many hours of runtime. Omit for no limit (the default). The countdown starts when the instance reaches `running`, not when you call this — provisioning is neither billed nor counted against the limit — and the resolved deadline is returned as `auto_terminate_at` on every read. Enforcement is server-side and survives your process: this is the safety net for an unattended run whose client dies without cleaning up. When it fires the instance is terminated exactly as a DELETE would terminate it (billing stops, the `instance.terminated` webhook fires) and `status_reason` records that the limit was reached. Bounds: at least 1, at most 720 (30 days) — outside them returns 422 `validation_failed`. An explicit `0` is rejected rather than read as \"no limit\"; omit the field for that.", json_schema_extra={"examples": [8]})
     env: Optional[Dict[str, StrictStr]] = Field(default=None, description="Environment variables. With `template_id`: per-deploy overrides — only keys the template marks user_overridable are accepted (others 422), and secret values are redacted from operation metadata. With `image`: plain container env vars — keys must be POSIX names and the platform's reserved namespace (`PUBLIC_KEY`, `GPUAI_*`) is refused (422).")
     image: Optional[StrictStr] = Field(default=None, description="Launch from your own container image, e.g. `pytorch/pytorch:2.4.1-cuda12.4-cudnn9-devel` or `ghcr.io/acme/trainer:v1`. The image must be publicly pullable (private registries are not yet supported) and provide linux/amd64 — both are verified synchronously before anything is provisioned: an unknown image returns 422 `image_unavailable` and a registry outage 502 `registry_unreachable`, with no operation created and nothing billed. The launch is pinned to the exact manifest digest verified, so a tag re-push cannot change what boots. After SSH/tunnel setup the image's own ENTRYPOINT/CMD is started (its output is in /var/log/gpuai-entrypoint.log on the instance); an image with neither is a plain SSH environment. Placement prefers container-native capacity (the image runs natively; SSH lands inside it) and falls back to VM capacity (the image runs as a container beside the host's SSH — inspect with `docker logs gpuai-workload`); private images stay container-native. A gpu_type with no capable capacity returns 422 `image_unavailable`. Mutually exclusive with `template_id` and `environment` (422). A malformed reference (bad charset, localhost/private-IP registry) returns 400. On-demand only for now: `tier: spot` with `image` is refused (422 `validation_failed`) because a preemption re-route cannot yet carry a custom image.", json_schema_extra={"examples": ["ghcr.io/acme/trainer:v1"]})
     registry_credential_id: Optional[StrictStr] = Field(default=None, description="Stored registry-credential id (POST /v1/registry-credentials) for pulling a PRIVATE `image`. The credential's registry must match the image's registry (422 otherwise); wrong logins fail the pre-flight with 422 `image_unavailable` before anything is provisioned. Requires `image`.")
     entrypoint: Optional[List[StrictStr]] = Field(default=None, description="Override the image's ENTRYPOINT (docker semantics — also drops the image CMD unless `cmd` is given). Omit to use the image's own. At most 32 arguments / 4KB. Requires `image`.")
     cmd: Optional[List[StrictStr]] = Field(default=None, description="Override the image's CMD. Omit to use the image's own (or none, when `entrypoint` is overridden). Requires `image`.")
     ports: Optional[List[CreateInstanceRequestPortsInner]] = Field(default=None, description="Container ports to expose on a custom-image launch (at most 10; port 22 is reserved). At most one entry may be `primary` — it must be http and is served at the instance's app URL (`https://<id>.apps.gpu.ai`) behind the per-instance basic-auth login. Requires `image`.")
-    __properties: ClassVar[List[str]] = ["gpu_type", "gpu_count", "region", "tier", "ssh_key_ids", "name", "max_price_per_hour", "viewed_price_per_hour", "template_id", "environment", "offering_id", "disk_gb", "env", "image", "registry_credential_id", "entrypoint", "cmd", "ports"]
+    __properties: ClassVar[List[str]] = ["gpu_type", "gpu_count", "region", "tier", "ssh_key_ids", "name", "max_price_per_hour", "viewed_price_per_hour", "template_id", "environment", "offering_id", "disk_gb", "auto_terminate_hours", "env", "image", "registry_credential_id", "entrypoint", "cmd", "ports"]
 
     @field_validator('tier')
     def tier_validate_enum(cls, value):
@@ -127,6 +128,7 @@ class CreateInstanceRequest(BaseModel):
             "environment": obj.get("environment"),
             "offering_id": obj.get("offering_id"),
             "disk_gb": obj.get("disk_gb"),
+            "auto_terminate_hours": obj.get("auto_terminate_hours"),
             "env": obj.get("env"),
             "image": obj.get("image"),
             "registry_credential_id": obj.get("registry_credential_id"),

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.8}/gpuai_sdk/models/instance.py

@@ -42,13 +42,15 @@ class Instance(BaseModel):
     connection: Optional[InstanceConnection] = None
     disk_gb: Optional[StrictInt] = Field(default=None, description="Instance filesystem size in GB that the platform configured for this launch. Present only where the placed capacity honors a configured disk size; absent means the machine's disk is provider-determined (its own flavor volume).")
     image: Optional[StrictStr] = Field(default=None, description="The customer-supplied container image this instance was launched from, digest-pinned at verification time (e.g. `ghcr.io/acme/trainer:v1@sha256:…`). Present only on custom-image launches; template and certified launches never expose their images here.")
-    status_reason: Optional[StrictStr] = Field(default=None, description="Why the instance is in the error state, e.g. \"provisioning stalled: the instance started but never became reachable\". Present only on errored instances.")
+    auto_terminate_hours: Optional[StrictInt] = Field(default=None, description="The runtime limit this instance was launched with, in hours (the `auto_terminate_hours` you sent). Absent means the instance runs until something stops it. It stays present after the limit has fired, so a terminated instance still explains itself.", json_schema_extra={"examples": [8]})
+    auto_terminate_at: Optional[datetime] = Field(default=None, description="When the runtime limit expires and the platform terminates this instance. Computed when the instance became running (ready_at + auto_terminate_hours), so the countdown covers usable runtime, not the time spent provisioning. Absent when no limit was set, when the instance is not running yet, or once the platform has begun acting on an elapsed limit.")
+    status_reason: Optional[StrictStr] = Field(default=None, description="Why the instance stopped or failed, e.g. \"provisioning stalled: the instance started but never became reachable\", or — when a runtime limit fired — \"Terminated: this instance reached the 8-hour runtime limit set at launch\". Present only when the platform has something to explain.")
     created_at: datetime
     ready_at: Optional[datetime] = None
     terminated_at: Optional[datetime] = None
     last_reachable_at: Optional[datetime] = Field(default=None, description="Last time the platform verified the SSH path to this instance end-to-end through the tunnel. Absent means the instance has not been probed yet (freshly launched, or no tunnel) — it does NOT mean unreachable. An instance whose status is still \"running\" while this timestamp stops advancing is one whose SSH has died even though the machine is up.")
     unreachable_since: Optional[datetime] = Field(default=None, description="Start of the confirmed tunnel outage the instance is currently in. Present exactly when status is \"unreachable\", absent otherwise. It is the timestamp the auto-credit for the dead window is computed from, so a ledger credit can be reconciled against it.")
-    __properties: ClassVar[List[str]] = ["id", "name", "status", "gpu_type", "gpu_count", "region", "tier", "price_per_hour", "connection", "disk_gb", "image", "status_reason", "created_at", "ready_at", "terminated_at", "last_reachable_at", "unreachable_since"]
+    __properties: ClassVar[List[str]] = ["id", "name", "status", "gpu_type", "gpu_count", "region", "tier", "price_per_hour", "connection", "disk_gb", "image", "auto_terminate_hours", "auto_terminate_at", "status_reason", "created_at", "ready_at", "terminated_at", "last_reachable_at", "unreachable_since"]
 
     @field_validator('status')
     def status_validate_enum(cls, value):
@@ -129,6 +131,8 @@ class Instance(BaseModel):
             "connection": InstanceConnection.from_dict(obj["connection"]) if obj.get("connection") is not None else None,
             "disk_gb": obj.get("disk_gb"),
             "image": obj.get("image"),
+            "auto_terminate_hours": obj.get("auto_terminate_hours"),
+            "auto_terminate_at": obj.get("auto_terminate_at"),
             "status_reason": obj.get("status_reason"),
             "created_at": obj.get("created_at"),
             "ready_at": obj.get("ready_at"),

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.8}/gpuai_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gpuai-sdk
-Version: 0.3.7
+Version: 0.3.8
 Summary: GPU.ai Public Developer API
 Home-page: 
 Author: GPU.ai Support
@@ -26,7 +26,7 @@ the dashboard. See https://gpu.ai/docs for details.
 This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 1.0.0
-- Package version: 0.3.7
+- Package version: 0.3.8
 - Generator version: 7.24.0
 - Build package: org.openapitools.codegen.languages.PythonClientCodegen
 

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.8}/pyproject.toml

@@ -6,7 +6,7 @@ name = "gpuai-sdk"
 # injected tree. This file is ignore-protected (see .openapi-generator-ignore)
 # so the placeholder survives regeneration; sdk/release/assert-placeholder.sh
 # fails CI if a real version ever lands here.
-version = "0.3.7"
+version = "0.3.8"
 description = "GPU.ai Public Developer API"
 authors = [
   {name = "GPU.ai Support",email = "support@gpu.ai"},

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.8}/setup.py

@@ -20,7 +20,7 @@ from setuptools import setup, find_packages  # noqa: H301
 # prerequisite: setuptools
 # http://pypi.python.org/pypi/setuptools
 NAME = "gpuai-sdk"
-VERSION = "0.3.7"
+VERSION = "0.3.8"
 PYTHON_REQUIRES = ">= 3.10"
 REQUIRES = [
     "urllib3 >= 2.6.3, < 3.0.0",