@gpuai/sdk 0.3.7 → 0.3.8

package/README.md

@@ -1,4 +1,4 @@
-# @gpuai/sdk@0.3.7
+# @gpuai/sdk@0.3.8
 
 A TypeScript SDK client for the api.gpu.ai API.
 
@@ -203,7 +203,7 @@ and 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.TypeScriptFetchClientCodegen`
 

package/dist/esm/models/CreateInstanceRequest.d.ts

@@ -88,6 +88,12 @@ export interface CreateInstanceRequest {
      * @memberof CreateInstanceRequest
      */
     diskGb?: number;
+    /**
+     * 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.
+     * @type {number}
+     * @memberof CreateInstanceRequest
+     */
+    autoTerminateHours?: number;
     /**
      * 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).
      * @type {{ [key: string]: string; }}

package/dist/esm/models/CreateInstanceRequest.js

@@ -51,6 +51,7 @@ export function CreateInstanceRequestFromJSONTyped(json, ignoreDiscriminator) {
         'environment': json['environment'] == null ? undefined : json['environment'],
         'offeringId': json['offering_id'] == null ? undefined : json['offering_id'],
         'diskGb': json['disk_gb'] == null ? undefined : json['disk_gb'],
+        'autoTerminateHours': json['auto_terminate_hours'] == null ? undefined : json['auto_terminate_hours'],
         'env': json['env'] == null ? undefined : json['env'],
         'image': json['image'] == null ? undefined : json['image'],
         'registryCredentialId': json['registry_credential_id'] == null ? undefined : json['registry_credential_id'],
@@ -79,6 +80,7 @@ export function CreateInstanceRequestToJSONTyped(value, ignoreDiscriminator = fa
         'environment': value['environment'],
         'offering_id': value['offeringId'],
         'disk_gb': value['diskGb'],
+        'auto_terminate_hours': value['autoTerminateHours'],
         'env': value['env'],
         'image': value['image'],
         'registry_credential_id': value['registryCredentialId'],

package/dist/esm/models/Instance.d.ts

@@ -83,7 +83,19 @@ export interface Instance {
      */
     image?: string;
     /**
-     * Why the instance is in the error state, e.g. "provisioning stalled: the instance started but never became reachable". Present only on errored instances.
+     * 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.
+     * @type {number}
+     * @memberof Instance
+     */
+    autoTerminateHours?: number;
+    /**
+     * 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.
+     * @type {Date}
+     * @memberof Instance
+     */
+    autoTerminateAt?: Date;
+    /**
+     * 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.
      * @type {string}
      * @memberof Instance
      */

package/dist/esm/models/Instance.js

@@ -73,6 +73,8 @@ export function InstanceFromJSONTyped(json, ignoreDiscriminator) {
         'connection': json['connection'] == null ? undefined : InstanceConnectionFromJSON(json['connection']),
         'diskGb': json['disk_gb'] == null ? undefined : json['disk_gb'],
         'image': json['image'] == null ? undefined : json['image'],
+        'autoTerminateHours': json['auto_terminate_hours'] == null ? undefined : json['auto_terminate_hours'],
+        'autoTerminateAt': json['auto_terminate_at'] == null ? undefined : (new Date(json['auto_terminate_at'])),
         'statusReason': json['status_reason'] == null ? undefined : json['status_reason'],
         'createdAt': (new Date(json['created_at'])),
         'readyAt': json['ready_at'] == null ? undefined : (new Date(json['ready_at'])),
@@ -100,6 +102,8 @@ export function InstanceToJSONTyped(value, ignoreDiscriminator = false) {
         'connection': InstanceConnectionToJSON(value['connection']),
         'disk_gb': value['diskGb'],
         'image': value['image'],
+        'auto_terminate_hours': value['autoTerminateHours'],
+        'auto_terminate_at': value['autoTerminateAt'] == null ? value['autoTerminateAt'] : value['autoTerminateAt'].toISOString(),
         'status_reason': value['statusReason'],
         'created_at': value['createdAt'].toISOString(),
         'ready_at': value['readyAt'] == null ? value['readyAt'] : value['readyAt'].toISOString(),

package/dist/models/CreateInstanceRequest.d.ts

@@ -88,6 +88,12 @@ export interface CreateInstanceRequest {
      * @memberof CreateInstanceRequest
      */
     diskGb?: number;
+    /**
+     * 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.
+     * @type {number}
+     * @memberof CreateInstanceRequest
+     */
+    autoTerminateHours?: number;
     /**
      * 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).
      * @type {{ [key: string]: string; }}

package/dist/models/CreateInstanceRequest.js

@@ -59,6 +59,7 @@ function CreateInstanceRequestFromJSONTyped(json, ignoreDiscriminator) {
         'environment': json['environment'] == null ? undefined : json['environment'],
         'offeringId': json['offering_id'] == null ? undefined : json['offering_id'],
         'diskGb': json['disk_gb'] == null ? undefined : json['disk_gb'],
+        'autoTerminateHours': json['auto_terminate_hours'] == null ? undefined : json['auto_terminate_hours'],
         'env': json['env'] == null ? undefined : json['env'],
         'image': json['image'] == null ? undefined : json['image'],
         'registryCredentialId': json['registry_credential_id'] == null ? undefined : json['registry_credential_id'],
@@ -87,6 +88,7 @@ function CreateInstanceRequestToJSONTyped(value, ignoreDiscriminator = false) {
         'environment': value['environment'],
         'offering_id': value['offeringId'],
         'disk_gb': value['diskGb'],
+        'auto_terminate_hours': value['autoTerminateHours'],
         'env': value['env'],
         'image': value['image'],
         'registry_credential_id': value['registryCredentialId'],

package/dist/models/Instance.d.ts

@@ -83,7 +83,19 @@ export interface Instance {
      */
     image?: string;
     /**
-     * Why the instance is in the error state, e.g. "provisioning stalled: the instance started but never became reachable". Present only on errored instances.
+     * 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.
+     * @type {number}
+     * @memberof Instance
+     */
+    autoTerminateHours?: number;
+    /**
+     * 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.
+     * @type {Date}
+     * @memberof Instance
+     */
+    autoTerminateAt?: Date;
+    /**
+     * 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.
      * @type {string}
      * @memberof Instance
      */

package/dist/models/Instance.js

@@ -81,6 +81,8 @@ function InstanceFromJSONTyped(json, ignoreDiscriminator) {
         'connection': json['connection'] == null ? undefined : (0, InstanceConnection_1.InstanceConnectionFromJSON)(json['connection']),
         'diskGb': json['disk_gb'] == null ? undefined : json['disk_gb'],
         'image': json['image'] == null ? undefined : json['image'],
+        'autoTerminateHours': json['auto_terminate_hours'] == null ? undefined : json['auto_terminate_hours'],
+        'autoTerminateAt': json['auto_terminate_at'] == null ? undefined : (new Date(json['auto_terminate_at'])),
         'statusReason': json['status_reason'] == null ? undefined : json['status_reason'],
         'createdAt': (new Date(json['created_at'])),
         'readyAt': json['ready_at'] == null ? undefined : (new Date(json['ready_at'])),
@@ -108,6 +110,8 @@ function InstanceToJSONTyped(value, ignoreDiscriminator = false) {
         'connection': (0, InstanceConnection_1.InstanceConnectionToJSON)(value['connection']),
         'disk_gb': value['diskGb'],
         'image': value['image'],
+        'auto_terminate_hours': value['autoTerminateHours'],
+        'auto_terminate_at': value['autoTerminateAt'] == null ? value['autoTerminateAt'] : value['autoTerminateAt'].toISOString(),
         'status_reason': value['statusReason'],
         'created_at': value['createdAt'].toISOString(),
         'ready_at': value['readyAt'] == null ? value['readyAt'] : value['readyAt'].toISOString(),

package/docs/CreateInstanceRequest.md

@@ -18,6 +18,7 @@ Name | Type
 `environment` | string
 `offeringId` | string
 `diskGb` | number
+`autoTerminateHours` | number
 `env` | { [key: string]: string; }
 `image` | string
 `registryCredentialId` | string
@@ -44,6 +45,7 @@ const example = {
   "environment": certified:pytorch@2.13,
   "offeringId": null,
   "diskGb": 200,
+  "autoTerminateHours": 8,
   "env": null,
   "image": ghcr.io/acme/trainer:v1,
   "registryCredentialId": null,

package/docs/Instance.md

@@ -17,6 +17,8 @@ Name | Type
 `connection` | [InstanceConnection](InstanceConnection.md)
 `diskGb` | number
 `image` | string
+`autoTerminateHours` | number
+`autoTerminateAt` | Date
 `statusReason` | string
 `createdAt` | Date
 `readyAt` | Date
@@ -42,6 +44,8 @@ const example = {
   "connection": null,
   "diskGb": null,
   "image": null,
+  "autoTerminateHours": 8,
+  "autoTerminateAt": null,
   "statusReason": null,
   "createdAt": null,
   "readyAt": null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gpuai/sdk",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "TypeScript SDK for the GPU.ai Public Developer API",
   "author": "GPU.ai Support <support@gpu.ai>",
   "repository": {

package/src/models/CreateInstanceRequest.ts

@@ -99,6 +99,12 @@ export interface CreateInstanceRequest {
      * @memberof CreateInstanceRequest
      */
     diskGb?: number;
+    /**
+     * 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.
+     * @type {number}
+     * @memberof CreateInstanceRequest
+     */
+    autoTerminateHours?: number;
     /**
      * 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).
      * @type {{ [key: string]: string; }}
@@ -180,6 +186,7 @@ export function CreateInstanceRequestFromJSONTyped(json: any, ignoreDiscriminato
         'environment': json['environment'] == null ? undefined : json['environment'],
         'offeringId': json['offering_id'] == null ? undefined : json['offering_id'],
         'diskGb': json['disk_gb'] == null ? undefined : json['disk_gb'],
+        'autoTerminateHours': json['auto_terminate_hours'] == null ? undefined : json['auto_terminate_hours'],
         'env': json['env'] == null ? undefined : json['env'],
         'image': json['image'] == null ? undefined : json['image'],
         'registryCredentialId': json['registry_credential_id'] == null ? undefined : json['registry_credential_id'],
@@ -212,6 +219,7 @@ export function CreateInstanceRequestToJSONTyped(value?: CreateInstanceRequest |
         'environment': value['environment'],
         'offering_id': value['offeringId'],
         'disk_gb': value['diskGb'],
+        'auto_terminate_hours': value['autoTerminateHours'],
         'env': value['env'],
         'image': value['image'],
         'registry_credential_id': value['registryCredentialId'],

package/src/models/Instance.ts

@@ -94,7 +94,19 @@ export interface Instance {
      */
     image?: string;
     /**
-     * Why the instance is in the error state, e.g. "provisioning stalled: the instance started but never became reachable". Present only on errored instances.
+     * 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.
+     * @type {number}
+     * @memberof Instance
+     */
+    autoTerminateHours?: number;
+    /**
+     * 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.
+     * @type {Date}
+     * @memberof Instance
+     */
+    autoTerminateAt?: Date;
+    /**
+     * 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.
      * @type {string}
      * @memberof Instance
      */
@@ -193,6 +205,8 @@ export function InstanceFromJSONTyped(json: any, ignoreDiscriminator: boolean):
         'connection': json['connection'] == null ? undefined : InstanceConnectionFromJSON(json['connection']),
         'diskGb': json['disk_gb'] == null ? undefined : json['disk_gb'],
         'image': json['image'] == null ? undefined : json['image'],
+        'autoTerminateHours': json['auto_terminate_hours'] == null ? undefined : json['auto_terminate_hours'],
+        'autoTerminateAt': json['auto_terminate_at'] == null ? undefined : (new Date(json['auto_terminate_at'])),
         'statusReason': json['status_reason'] == null ? undefined : json['status_reason'],
         'createdAt': (new Date(json['created_at'])),
         'readyAt': json['ready_at'] == null ? undefined : (new Date(json['ready_at'])),
@@ -224,6 +238,8 @@ export function InstanceToJSONTyped(value?: Instance | null, ignoreDiscriminator
         'connection': InstanceConnectionToJSON(value['connection']),
         'disk_gb': value['diskGb'],
         'image': value['image'],
+        'auto_terminate_hours': value['autoTerminateHours'],
+        'auto_terminate_at': value['autoTerminateAt'] == null ? value['autoTerminateAt'] : value['autoTerminateAt'].toISOString(),
         'status_reason': value['statusReason'],
         'created_at': value['createdAt'].toISOString(),
         'ready_at': value['readyAt'] == null ? value['readyAt'] : value['readyAt'].toISOString(),