feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 4
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/the-san-francisco-compute-company%2Fsfc-nodes-73c29dd8765024819248125163d7c3e2d7dcdae819088fd7b1c3f0db5b3b89c0.yml
-openapi_spec_hash: 9a1923a47f368e9262d54060fe7f2a80
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/the-san-francisco-compute-company%2Fsfc-nodes-d41b5a590956acc71242ed938a212ee64655756fbd4c2af91db937f97f4fd4f5.yml
+openapi_spec_hash: 19777fc4ebc8a243cf8ce3a9ad0e1da4
 config_hash: e5ed8abf8452457d45fc10488ad15bd2

api.md

@@ -29,8 +29,12 @@ Types:
 
 - <code><a href="./src/resources/nodes.ts">AcceleratorType</a></code>
 - <code><a href="./src/resources/nodes.ts">CreateNodesRequest</a></code>
+- <code><a href="./src/resources/nodes.ts">ErrorContent</a></code>
 - <code><a href="./src/resources/nodes.ts">ErrorDetail</a></code>
+- <code><a href="./src/resources/nodes.ts">ErrorObject</a></code>
+- <code><a href="./src/resources/nodes.ts">ErrorType</a></code>
 - <code><a href="./src/resources/nodes.ts">ExtendNodeRequest</a></code>
+- <code><a href="./src/resources/nodes.ts">ListResponseNode</a></code>
 - <code><a href="./src/resources/nodes.ts">Node</a></code>
 - <code><a href="./src/resources/nodes.ts">NodeType</a></code>
 - <code><a href="./src/resources/nodes.ts">ProcurementStatus</a></code>

src/client.ts

@@ -19,8 +19,12 @@ import { APIPromise } from './core/api-promise';
 import {
   AcceleratorType,
   CreateNodesRequest,
+  ErrorContent,
   ErrorDetail,
+  ErrorObject,
+  ErrorType,
   ExtendNodeRequest,
+  ListResponseNode,
   Node,
   NodeType,
   Nodes,
@@ -752,8 +756,12 @@ export declare namespace SFCNodes {
     Nodes as Nodes,
     type AcceleratorType as AcceleratorType,
     type CreateNodesRequest as CreateNodesRequest,
+    type ErrorContent as ErrorContent,
     type ErrorDetail as ErrorDetail,
+    type ErrorObject as ErrorObject,
+    type ErrorType as ErrorType,
     type ExtendNodeRequest as ExtendNodeRequest,
+    type ListResponseNode as ListResponseNode,
     type Node as Node,
     type NodeType as NodeType,
     type ProcurementStatus as ProcurementStatus,

src/resources/index.ts

@@ -4,8 +4,12 @@ export {
   Nodes,
   type AcceleratorType,
   type CreateNodesRequest,
+  type ErrorContent,
   type ErrorDetail,
+  type ErrorObject,
+  type ErrorType,
   type ExtendNodeRequest,
+  type ListResponseNode,
   type Node,
   type NodeType,
   type ProcurementStatus,

src/resources/nodes.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
+import * as NodesAPI from './nodes';
 
 export class Nodes extends APIResource {}
 
@@ -9,16 +10,25 @@ export type AcceleratorType = 'H100' | 'H200';
 export interface CreateNodesRequest {
   desired_count: number;
 
-  max_price_per_hour: number;
+  /**
+   * Max price per hour for a node in cents
+   */
+  max_price_per_node_hour: number;
 
   /**
-   * End time as Unix timestamp in seconds
+   * Zone to create the nodes in. See Zone enum for valid values.
    */
-  end_at?: number;
+  zone: string;
+
+  /**
+   * End time as Unix timestamp in seconds. If provided, end time must be aligned to
+   * the hour. If not provided, the node will be created as an on-demand node.
+   */
+  end_at?: number | null;
 
   /**
-   * Custom node names. Names cannot follow the vm*id pattern vm*{16_hex_chars} as
-   * this is reserved for system-generated IDs.
+   * Custom node names. Names cannot follow the vm\_{alpha_numeric_chars} as this is
+   * reserved for system-generated IDs. Names cannot be numeric strings.
    */
   names?: Array<string>;
 
@@ -28,8 +38,14 @@ export interface CreateNodesRequest {
    * Start time as Unix timestamp in seconds
    */
   start_at?: number;
+}
+
+export interface ErrorContent {
+  message: string;
 
-  zone?: string;
+  type: ErrorType;
+
+  details?: Array<ErrorDetail>;
 }
 
 export interface ErrorDetail {
@@ -49,16 +65,95 @@ export interface ErrorDetail {
   field?: string | null;
 }
 
+export interface ErrorObject {
+  error: ErrorContent;
+}
+
+export type ErrorType =
+  | 'api_error'
+  | 'invalid_request_error'
+  | 'authentication_error'
+  | 'idempotency_error'
+  | 'conflict'
+  | 'not_found'
+  | 'request_timed_out'
+  | 'forbidden'
+  | 'not_implemented'
+  | 'upgrade_required'
+  | 'payment_required';
+
 export interface ExtendNodeRequest {
   /**
-   * Duration in seconds to extend the node by
+   * Duration in seconds to extend the node Must be at least 1 hour (3600 seconds)
+   * and a multiple of 1 hour.
    */
   duration_seconds: number;
 
   /**
    * Max price per hour for the extension in cents
    */
-  max_price_per_hour: number;
+  max_price_per_node_hour: number;
+}
+
+export interface ListResponseNode {
+  data: Array<ListResponseNode.Data>;
+
+  object: string;
+}
+
+export namespace ListResponseNode {
+  export interface Data {
+    id: string;
+
+    gpu_type: NodesAPI.AcceleratorType;
+
+    name: string;
+
+    node_type: NodesAPI.NodeType;
+
+    object: string;
+
+    owner: string;
+
+    /**
+     * Node Status
+     */
+    status: NodesAPI.Status;
+
+    /**
+     * Creation time as Unix timestamp in seconds
+     */
+    created_at?: number | null;
+
+    /**
+     * End time as Unix timestamp in seconds
+     */
+    end_at?: number | null;
+
+    /**
+     * Max price per hour you're willing to pay for a node in cents
+     */
+    max_price_per_node_hour?: number | null;
+
+    procurement_id?: string | null;
+
+    procurement_status?: NodesAPI.ProcurementStatus | null;
+
+    /**
+     * Start time as Unix timestamp in seconds
+     */
+    start_at?: number | null;
+
+    /**
+     * Last updated time as Unix timestamp in seconds
+     */
+    updated_at?: number | null;
+
+    /**
+     * Choose from these zones when creating a node
+     */
+    zone?: NodesAPI.Zone | null;
+  }
 }
 
 export interface Node {
@@ -70,47 +165,74 @@ export interface Node {
 
   node_type: NodeType;
 
+  object: string;
+
   owner: string;
 
+  /**
+   * Node Status
+   */
   status: Status;
 
+  /**
+   * Creation time as Unix timestamp in seconds
+   */
   created_at?: number | null;
 
+  /**
+   * End time as Unix timestamp in seconds
+   */
   end_at?: number | null;
 
-  max_price_per_hour?: number | null;
+  /**
+   * Max price per hour you're willing to pay for a node in cents
+   */
+  max_price_per_node_hour?: number | null;
 
   procurement_id?: string | null;
 
   procurement_status?: ProcurementStatus | null;
 
+  /**
+   * Start time as Unix timestamp in seconds
+   */
   start_at?: number | null;
 
+  /**
+   * Last updated time as Unix timestamp in seconds
+   */
   updated_at?: number | null;
 
   /**
-   * Possible zones to choose from when creating a node.
+   * Choose from these zones when creating a node
    */
   zone?: Zone | null;
 }
 
 export type NodeType = 'on_demand' | 'reserved';
 
-export type ProcurementStatus = 'Uninitialized' | 'Active' | 'Ended' | 'AwaitingCapacity';
+export type ProcurementStatus = 'uninitialized' | 'active' | 'ended' | 'awaiting_capacity';
 
-export type Status = 'Pending' | 'Running' | 'Terminated' | 'Failed' | 'Unknown';
+/**
+ * Node Status
+ */
+export type Status = 'pending' | 'running' | 'terminated' | 'failed' | 'unknown';
 
 /**
- * Possible zones to choose from when creating a node.
+ * Choose from these zones when creating a node
  */
 export type Zone = 'hayesvalley';
 
 export declare namespace Nodes {
   export {
     type AcceleratorType as AcceleratorType,
     type CreateNodesRequest as CreateNodesRequest,
+    type ErrorContent as ErrorContent,
     type ErrorDetail as ErrorDetail,
+    type ErrorObject as ErrorObject,
+    type ErrorType as ErrorType,
     type ExtendNodeRequest as ExtendNodeRequest,
+    type ListResponseNode as ListResponseNode,
     type Node as Node,
     type NodeType as NodeType,
     type ProcurementStatus as ProcurementStatus,