@archildata/api-types 0.0.14 → 0.0.15

package/index.d.ts

@@ -390,6 +390,35 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/sandboxes/{sid}/connections": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create a direct sandbox connection
+         * @description Returns a short-lived WebSocket URL for an interactive shell in a
+         *     running sandbox. Connecting starts `/bin/sh` with a PTY. The connection
+         *     has no stored history or reconnect support.
+         *
+         *     The URL contains a signed token that expires at `expires_at`. An open
+         *     WebSocket can remain connected after the token expires. Clients send
+         *     input as `{"type":"input","data":"..."}` and terminal size changes as
+         *     `{"type":"resize","rows":24,"cols":80}`. The server returns terminal
+         *     output as text frames. Closing the WebSocket ends the shell. Pausing or
+         *     stopping the sandbox also closes the connection.
+         */
+        post: operations["createSandboxConnection"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/sandboxes/{sid}/execs": {
         parameters: {
             query?: never;
@@ -669,6 +698,17 @@ export interface components {
             port: number;
             hostname: string;
         };
+        SandboxConnection: {
+            /** Format: uri */
+            url: string;
+            /** Format: date-time */
+            expires_at: string;
+        };
+        ApiResponse_SandboxConnection: {
+            /** @example true */
+            success: boolean;
+            data: components["schemas"]["SandboxConnection"];
+        };
         SandboxPortMapping: {
             container_port: number;
             /** @enum {string} */
@@ -2332,6 +2372,41 @@ export interface operations {
             500: components["responses"]["InternalError"];
         };
     };
+    createSandboxConnection: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Sandbox UUID */
+                sid: components["parameters"]["SandboxId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description A short-lived direct connection URL */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_SandboxConnection"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            /** @description The sandbox is not running */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            500: components["responses"]["InternalError"];
+        };
+    };
     listSandboxExecs: {
         parameters: {
             query?: never;

package/package.json

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