feat: Add design proposal: Rosetta x86-64 emulation for vz Linux guests

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 52
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/hypeman-f9fed11ca56bb499302232ce70b65d8fa6c0f88c5274dbf16670283303449c63.yml
-openapi_spec_hash: 24530949a7f53ab57694443c45088190
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/hypeman-6c73c988bf5930a45cafe6d304d97479842354d4181bc77f2aa39838b531d431.yml
+openapi_spec_hash: 1bcecb92c1a31dcb09a659272be61633
 config_hash: 99e93e381d8384de5a44c6eeed4bd4b1

src/resources/images.ts

@@ -105,6 +105,11 @@ export interface Image {
    */
   error?: string | null;
 
+  /**
+   * Resolved image platform as os/arch[/variant] (e.g. "linux/amd64")
+   */
+  platform?: string;
+
   /**
    * Position in build queue (null if not queued)
    */
@@ -134,6 +139,14 @@ export interface ImageCreateParams {
    */
   name: string;
 
+  /**
+   * Target platform as os/arch[/variant] (e.g. "linux/amd64"), matching Docker
+   * --platform. Omit for the host platform. Not a fixed enum: the os/arch[/variant]
+   * grammar is validated server-side and invalid values return 400 invalid_platform.
+   * Only os "linux" with arch amd64 or arm64 is accepted today.
+   */
+  platform?: string;
+
   /**
    * User-defined key-value tags.
    */

src/resources/instances/instances.ts

@@ -548,6 +548,12 @@ export interface Instance {
    */
   phase_durations_ms?: { [key: string]: number };
 
+  /**
+   * Resolved image platform as os/arch[/variant] (e.g. "linux/amd64"). amd64 images
+   * on an arm64 host run under Rosetta emulation.
+   */
+  platform?: string;
+
   /**
    * Whole-instance restart supervision policy.
    */
@@ -1113,6 +1119,14 @@ export interface InstanceCreateParams {
    */
   overlay_size?: string;
 
+  /**
+   * Target platform as os/arch[/variant] (e.g. "linux/amd64"), matching Docker
+   * --platform. Omit for the host platform. Not a fixed enum: the os/arch[/variant]
+   * grammar is validated server-side and invalid values return 400 invalid_platform.
+   * Only os "linux" with arch amd64 or arm64 is accepted today.
+   */
+  platform?: string;
+
   /**
    * Whole-instance restart supervision policy.
    */

tests/api-resources/images.test.ts

@@ -24,6 +24,7 @@ describe('resource images', () => {
   test.skip('create: required and optional params', async () => {
     const response = await client.images.create({
       name: 'docker.io/library/nginx:latest',
+      platform: 'linux/amd64',
       tags: { team: 'backend', env: 'staging' },
     });
   });

tests/api-resources/instances/instances.test.ts

@@ -79,6 +79,7 @@ describe('resource instances', () => {
         enabled: true,
       },
       overlay_size: '20GB',
+      platform: 'linux/amd64',
       restart_policy: {
         backoff: '5s',
         max_attempts: 10,