@archildata/api-types 0.0.32 → 0.0.34

package/index.d.ts

@@ -412,6 +412,50 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/sandboxes/{sid}/ports": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List exposed sandbox ports
+         * @description Lists the explicitly exposed public ports for the sandbox.
+         */
+        get: operations["listSandboxPorts"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/sandboxes/{sid}/ports/{port}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Expose a sandbox port
+         * @description Creates or returns public access to a TCP port in the sandbox.
+         */
+        put: operations["exposeSandboxPort"];
+        post?: never;
+        /**
+         * Stop exposing a sandbox port
+         * @description Removes an explicitly exposed public port. An enabled sandbox service publishing the same TCP port remains publicly reachable.
+         */
+        delete: operations["deleteSandboxPort"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/sandboxes/{sid}/pause": {
         parameters: {
             query?: never;
@@ -691,7 +735,7 @@ export interface components {
             status: components["schemas"]["SandboxState"];
             vcpu_count: number;
             mem_size_mib: number;
-            /** @description Full lifetime budget applied independently to each powered-on session. Defaults to 24 hours and can be reset with the timeout endpoint. */
+            /** @description Lifetime budget applied independently to each powered-on session. Expiry pauses the sandbox, preserving memory and processes for resume. Defaults to 24 hours and can be reset with the timeout endpoint. */
             max_ttl_seconds: number;
             /** @description Maximum number of concurrently attached process sessions. Detached processes and one-shot process controls do not count. */
             max_concurrent_execs: number;
@@ -702,6 +746,7 @@ export interface components {
              * @enum {string}
              */
             platform?: "arm64" | "amd64";
+            /** @description Public hostnames published by enabled sandbox services. */
             endpoints?: components["schemas"]["SandboxEndpoint"][];
             /** Format: date-time */
             created_at: string;
@@ -722,6 +767,23 @@ export interface components {
             port: number;
             hostname: string;
         };
+        SandboxPort: {
+            port: number;
+            hostname: string;
+        };
+        SandboxPortList: {
+            ports: components["schemas"]["SandboxPort"][];
+        };
+        ApiResponse_SandboxPort: {
+            /** @example true */
+            success: boolean;
+            data: components["schemas"]["SandboxPort"];
+        };
+        ApiResponse_SandboxPortList: {
+            /** @example true */
+            success: boolean;
+            data: components["schemas"]["SandboxPortList"];
+        };
         SandboxConnection: {
             /** Format: uri */
             url: string;
@@ -733,11 +795,6 @@ export interface components {
             success: boolean;
             data: components["schemas"]["SandboxConnection"];
         };
-        SandboxPortMapping: {
-            container_port: number;
-            /** @enum {string} */
-            protocol: "tcp" | "udp";
-        };
         ApiResponse_Sandbox: {
             /** @example true */
             success: boolean;
@@ -760,14 +817,15 @@ export interface components {
              * @default ubuntu:26.04
              */
             base_image: string;
-            port_mappings?: components["schemas"]["SandboxPortMapping"][];
+            /** @description TCP ports to expose publicly when the sandbox is created. */
+            ports?: number[];
             /** @description Environment variables applied to every process */
             env?: {
                 [key: string]: string;
             };
             network?: components["schemas"]["SandboxNetwork"];
             /**
-             * @description Lifetime budget applied independently to each powered-on session
+             * @description Lifetime budget applied independently to each powered-on session. Expiry pauses the sandbox, preserving memory and processes for resume.
              * @default 86400
              */
             max_ttl_seconds: number;
@@ -2426,6 +2484,95 @@ export interface operations {
             500: components["responses"]["InternalError"];
         };
     };
+    listSandboxPorts: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Sandbox UUID */
+                sid: components["parameters"]["SandboxId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Exposed sandbox ports */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_SandboxPortList"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+        };
+    };
+    exposeSandboxPort: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Sandbox UUID */
+                sid: components["parameters"]["SandboxId"];
+                port: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Existing exposed port */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_SandboxPort"];
+                };
+            };
+            /** @description Port was exposed */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_SandboxPort"];
+                };
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+        };
+    };
+    deleteSandboxPort: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Sandbox UUID */
+                sid: components["parameters"]["SandboxId"];
+                port: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Sandbox port is no longer explicitly exposed */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+        };
+    };
     pauseSandbox: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archildata/api-types",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "description": "API types for the Archil control plane",
   "type": "module",
   "types": "index.d.ts",