@simantic/cloud-sim 0.1.0

package/dist/generated/v1.d.ts

@@ -0,0 +1,1959 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/v1/mcus": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description The MCU catalog of the request's version (`Cloud-Sim-Version`, or the default). */
+        get: operations["mcus"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/runs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["list"];
+        put?: never;
+        post: operations["create"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/runs/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/runs/{id}/cancel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Cancels a run: a queued run at once; a starting or running one is stopped within seconds (`cancel_requested_at` meanwhile), keeping what it printed. A canceled run answers as it is. */
+        post: operations["cancel"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/runs/{id}/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description The run as server-sent events: `status` (the run, first on each connection and whenever it changes), `log` and `output` (`{"text", "next", "reset"}`), and `end` (the run) once it has finished; `error` (`{"error", "code"}`) if the API cannot read the run, before it closes. Each event's id is `<log>:<output>`; reconnect with `Last-Event-ID` to resume. A connection lasts at most 10 minutes. */
+        get: operations["events"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/runs/{id}/live": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description The run, and each stream from the byte offsets asked for (0 when left out), at most 256 KiB of each. Poll it from a queued run to its end, sending back each stream's `next`: the pages concatenate to the run's whole output, before it ends and after, unless a page says `reset`. */
+        get: operations["live"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/runs/{id}/log": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description The console of a finished run, as text. */
+        get: operations["log"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/runs/{id}/output": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description The UART records of a finished run, as text. */
+        get: operations["output"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/runs/{id}/result": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["result"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/versions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["versions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/versions/{version}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["version"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/versions/{version}/mcus": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["version_mcus"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /**
+         * @description How an engine's binary was built: a published release, or from source
+         *     (which may run MCUs a release refuses: quartz runs `incomplete` ones).
+         * @enum {string}
+         */
+        Build: "dev" | "release";
+        /** @description What a version changed against the one before it. */
+        Changes: {
+            engines_added: string[];
+            engines_removed: string[];
+            engines_repinned: components["schemas"]["Repin"][];
+            /** @description Per engine in both versions. */
+            mcus: {
+                [key: string]: components["schemas"]["McuChanges"];
+            };
+            /** @description The version before; null for the first. */
+            previous: string | null;
+        };
+        /**
+         * @description `POST /v1/runs` as JSON. A multipart request takes the same fields as
+         *     form fields, with the ELF as the file part `firmware` (`usb_cdc_consoles`
+         *     repeated for each name). Every option is optional; left out, each takes
+         *     its default. An engine that does not take an option refuses it set to
+         *     anything but the default (`option_not_supported`).
+         */
+        CreateRun: {
+            /** @description The engine to run it on; the version's default engine when left out. */
+            engine?: string | null;
+            firmware: components["schemas"]["FirmwareInput"];
+            /** @description The MCU to simulate, by canonical name (`GET /v1/mcus`). */
+            mcu: string;
+            /**
+             * Format: double
+             * @description Simulated seconds to run for: more than 0, at most 60 (or the
+             *     engine's own maximum). Default 10.
+             */
+            simulated_seconds?: number | null;
+            /**
+             * @description Answer a bus access that reaches no device with a bus error instead
+             *     of reading 0. Default false.
+             */
+            trap_unmapped?: boolean | null;
+            uart_encoding?: null | components["schemas"]["UartEncoding"];
+            /**
+             * @description Write each UART record without its timestamp and label. Default
+             *     false.
+             */
+            uart_messages_only?: boolean | null;
+            /**
+             * @description USB device peripherals (such as `USB`) to put a CDC-ACM console
+             *     host behind, whose traffic joins the UART records. At most 4.
+             */
+            usb_cdc_consoles?: string[] | null;
+        };
+        /**
+         * @description `POST /v1/runs` as multipart/form-data (the OpenAPI description of the
+         *     form; the handler reads it field by field).
+         */
+        CreateRunForm: {
+            engine?: string | null;
+            /**
+             * Format: binary
+             * @description The ELF, as a file part.
+             */
+            firmware: string;
+            mcu: string;
+            /** Format: double */
+            simulated_seconds?: number | null;
+            trap_unmapped?: boolean | null;
+            uart_encoding?: null | components["schemas"]["UartEncoding"];
+            uart_messages_only?: boolean | null;
+            /** @description Repeat the field for each name. */
+            usb_cdc_consoles?: string[] | null;
+        };
+        /** @description An engine as a version pins it. */
+        EngineView: {
+            build: components["schemas"]["Build"];
+            /** @description The source commit of the release. */
+            commit: string;
+            fingerprint: string;
+            limits: components["schemas"]["Limits"];
+            /** @description How many MCUs it runs. */
+            mcu_count: number;
+            name: string;
+            /** @description The run options this engine takes, with their defaults and bounds. */
+            options: {
+                [key: string]: components["schemas"]["OptionView"];
+            };
+            /** @description The engine's release name. */
+            release: string;
+            /**
+             * Format: date-time
+             * @description When the release was published.
+             */
+            released_at: string;
+            /** @description The engine's version (`sim version`). */
+            version: string;
+        };
+        /** @description Every error's body. */
+        Error: {
+            /**
+             * @description A stable name for programs. New codes may be added; a client treats
+             *     one it does not know by the HTTP status. The /v1 API's:
+             *
+             *     - 400 `version_unknown` (the `Cloud-Sim-Version` header names no
+             *       version), `engine_unknown`, `engine_not_in_version`,
+             *       `mcu_not_supported`, `mcu_not_runnable`, `option_not_supported`,
+             *       `firmware_missing`, `firmware_invalid`, `firmware_url_refused`,
+             *       `firmware_fetch_failed`, `invalid_request`;
+             *     - 401 `unauthorized`; 403 `forbidden`;
+             *     - 404 `run_not_found`, `version_unknown` (in the path), `not_found`;
+             *     - 409 `idempotency_key_reused`, `run_not_finished`, `run_finished`;
+             *     - 410 `version_retired`;
+             *     - 413 `firmware_too_large`, `payload_too_large`;
+             *     - 415 `unsupported_media_type`;
+             *     - 429 `too_many_runs` (the caller's unfinished runs are at the
+             *       limit; `Retry-After` says when to look again);
+             *     - 503 `unavailable` (a service the API relies on; `Retry-After`).
+             */
+            code: string;
+            /** @description A sentence for the person who made the request. */
+            error: string;
+            /** @description The request field at fault. */
+            param: string | null;
+            /** @description The request's `X-Request-Id`. */
+            request_id: string | null;
+        };
+        /** @description The firmware a run simulates. */
+        Firmware: {
+            /** @description Hex SHA-256 of the ELF. */
+            sha256: string;
+            /**
+             * Format: int64
+             * @description In bytes.
+             */
+            size: number;
+            source: components["schemas"]["FirmwareSource"];
+            /** @description The URL it was fetched from, for `url`. */
+            url: string | null;
+        };
+        /** @description The firmware: exactly one of `base64` and `url`. */
+        FirmwareInput: {
+            /** @description The ELF, base64-encoded (standard alphabet, padded). */
+            base64?: string | null;
+            /**
+             * @description An https URL the server fetches the ELF from when the run is
+             *     submitted (at most 24 MiB, within 20 seconds; never a private
+             *     address).
+             */
+            url?: string | null;
+        };
+        /**
+         * @description How a run's firmware came: a multipart file part, base64 in JSON, or
+         *     fetched by the server from a URL.
+         * @enum {string}
+         */
+        FirmwareSource: "upload" | "base64" | "url";
+        /**
+         * @description Where a version is in its life (index.toml `status`).
+         * @enum {string}
+         */
+        Lifecycle: "preview" | "stable" | "deprecated" | "retired";
+        /** @description What this server holds every run on the engine to. */
+        Limits: {
+            /**
+             * Format: int64
+             * @description The largest firmware, in bytes.
+             */
+            firmware_bytes: number;
+            /**
+             * Format: int64
+             * @description The most real seconds a run may take, whatever it simulates.
+             */
+            wall_seconds: number;
+        };
+        /**
+         * @description A run, and what it has printed of each stream from the offsets asked
+         *     for.
+         */
+        Live: {
+            /** @description The engine's console. */
+            log: components["schemas"]["LiveStream"];
+            /** @description The UART records. */
+            output: components["schemas"]["LiveStream"];
+            run: components["schemas"]["Run"];
+        };
+        /**
+         * @description Part of a stream: the text from the offset asked for, at most 256 KiB.
+         *     Pages concatenate to the stream's whole text, while it runs and after,
+         *     unless `reset` says to start over.
+         */
+        LiveStream: {
+            /** @description Whether more is already waiting past `next`. */
+            more: boolean;
+            /**
+             * Format: int64
+             * @description The byte offset to ask from next. A character cut off at the end of
+             *     what has arrived waits for the next read, so this can be short of
+             *     the end: send it back as it came.
+             */
+            next: number;
+            /**
+             * @description The run's final result differs from what it shipped while it ran,
+             *     at or before the offset asked for: this page starts over at 0, and
+             *     what was read before is to be dropped.
+             */
+            reset: boolean;
+            text: string;
+        };
+        McuChanges: {
+            /** @description Runnable now and not before. */
+            added: string[];
+            /** @description Runnable before and not now. */
+            removed: string[];
+            status_changed: components["schemas"]["StatusChange"][];
+        };
+        McuEngineView: {
+            /** @description The engine's own name for it. */
+            model: string;
+            /** @description Whether this engine's release runs it. */
+            runnable: boolean;
+            /** @description The first version this engine ran it in. */
+            since: string | null;
+            /** @description `not-modeled`, `incomplete`, `modeled` or `tested`. */
+            status: string;
+        };
+        /** @description A version's MCU catalog. */
+        McuList: {
+            mcus: components["schemas"]["McuView"][];
+            version: string;
+        };
+        /** @description One MCU, and what each of the version's engines makes of it. */
+        McuView: {
+            description: string;
+            /** @description By engine name: only the engines that know it. */
+            engines: {
+                [key: string]: components["schemas"]["McuEngineView"];
+            };
+            /** @description The canonical name a run gives. */
+            mcu: string;
+        };
+        /** @description One run option an engine takes. */
+        OptionView: {
+            /** @description The option's default: a number, a string, a boolean or an array. */
+            default: unknown;
+            /** Format: double */
+            exclusive_minimum?: number | null;
+            /** @description Whole numbers only. */
+            integer?: boolean | null;
+            max_items?: number | null;
+            /** Format: double */
+            maximum?: number | null;
+            values?: string[] | null;
+        };
+        Pin: {
+            release: string;
+            version: string;
+        };
+        Repin: {
+            engine: string;
+            from: components["schemas"]["Pin"];
+            to: components["schemas"]["Pin"];
+        };
+        /** @description A simulation run. */
+        Run: {
+            /**
+             * Format: date-time
+             * @description When its owner asked to cancel it, while it is being stopped.
+             */
+            cancel_requested_at: string | null;
+            /** Format: date-time */
+            created_at: string;
+            engine: null | components["schemas"]["RunEngine"];
+            /** @description Why the run failed or was canceled. */
+            error: string | null;
+            /**
+             * Format: int32
+             * @description The engine's exit code once it ran: 0 ok, 1 the simulation failed,
+             *     2 a usage error or an MCU the engine does not have.
+             */
+            exit_code: number | null;
+            /** Format: date-time */
+            finished_at: string | null;
+            firmware: null | components["schemas"]["Firmware"];
+            /** Format: uuid */
+            id: string;
+            /** @description The MCU it simulates, by its canonical name. */
+            mcu: string;
+            options: null | components["schemas"]["RunOptions"];
+            /** Format: date-time */
+            started_at: string | null;
+            status: components["schemas"]["RunStatus"];
+            /**
+             * @description The API version the run is bound to. Null for a run from before API
+             *     versions.
+             */
+            version: string | null;
+        };
+        /** @description An engine as a run is bound to it. */
+        RunEngine: {
+            /** @description Such as `quartz`. */
+            name: string;
+            /**
+             * @description The engine release the run's version pins, when this server still
+             *     serves that version.
+             */
+            release: string | null;
+            /** @description The engine's own version (`sim version`), likewise. */
+            version: string | null;
+        };
+        /** @description A page of the caller's runs, newest first. */
+        RunList: {
+            /**
+             * Format: uuid
+             * @description Pass as `before` for the next page; null on the last.
+             */
+            next: string | null;
+            runs: components["schemas"]["Run"][];
+        };
+        /**
+         * @description A run's options, engine-neutral, with every default filled in: what a
+         *     /v1 run records (`jobs.options`) and reports.
+         */
+        RunOptions: {
+            /** Format: double */
+            simulated_seconds: number;
+            trap_unmapped: boolean;
+            uart_encoding: components["schemas"]["UartEncoding"];
+            uart_messages_only: boolean;
+            usb_cdc_consoles: string[];
+        };
+        /** @description What a finished run produced. */
+        RunResult: {
+            /** Format: int32 */
+            exit_code: number | null;
+            /**
+             * @description The engine's console, each line starting with the UTC time it
+             *     appeared.
+             */
+            log: string | null;
+            /** @description The UART records. */
+            output: string | null;
+            /** @description Either stream reached its 1 MiB cap. */
+            truncated: boolean | null;
+        };
+        /**
+         * @description Where a run is. The set is fixed for v1: `canceled` is a run its owner
+         *     stopped.
+         * @enum {string}
+         */
+        RunStatus: "queued" | "starting" | "running" | "succeeded" | "failed" | "canceled";
+        StatusChange: {
+            from: string;
+            mcu: string;
+            to: string;
+        };
+        /**
+         * @description How UART bytes are written: hex rows (every engine's default) or text.
+         * @enum {string}
+         */
+        UartEncoding: "hex" | "ascii";
+        /** @description Every version this server serves. */
+        VersionList: {
+            /** @description What a request without `Cloud-Sim-Version` gets. */
+            default: string;
+            /** @description What the legacy /jobs API runs on. */
+            legacy: string;
+            /** @description Oldest first. */
+            versions: components["schemas"]["VersionView"][];
+        };
+        /** @description One API version: its lifecycle and the engines it binds. */
+        VersionView: {
+            /** @description What changed against the version before. */
+            changes: components["schemas"]["Changes"];
+            default_engine: string;
+            /** Format: date */
+            deprecated_at: string | null;
+            engines: components["schemas"]["EngineView"][];
+            /** @description `1.N` or `1.N-preview.M`. */
+            id: string;
+            notes: string;
+            /** Format: date */
+            released_at: string;
+            /** Format: date */
+            retired_at: string | null;
+            status: components["schemas"]["Lifecycle"];
+            /**
+             * Format: date
+             * @description When a deprecated version retires.
+             */
+            sunset_at: string | null;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    mcus: {
+        parameters: {
+            query?: {
+                /** @description Only this engine's MCUs. */
+                engine?: string;
+                /** @description Only MCUs that run (on `engine`, or on any engine). */
+                runnable?: boolean;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["McuList"];
+                };
+            };
+            400: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A service the API relies on is unavailable. */
+            503: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description Seconds to wait before trying again. */
+                    "Retry-After"?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    list: {
+        parameters: {
+            query?: {
+                /** @description 1 to 100, default 20. */
+                limit?: number;
+                /** @description A run of yours: the page starts after it (a page's `next`). */
+                before?: string;
+                /** @description Only runs on this engine. */
+                engine?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RunList"];
+                };
+            };
+            400: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            401: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A service the API relies on is unavailable. */
+            503: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description Seconds to wait before trying again. */
+                    "Retry-After"?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    create: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description The API version; the newest stable without it. */
+                "Cloud-Sim-Version"?: string | null;
+                /** @description Up to 255 printable ASCII characters: the same request again with it gets the same run. */
+                "Idempotency-Key"?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        /** @description The run: JSON (firmware as base64 or a URL) or multipart/form-data (firmware as the file part `firmware`). */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateRun"];
+                "multipart/form-data": components["schemas"]["CreateRunForm"];
+            };
+        };
+        responses: {
+            /** @description Already made under this Idempotency-Key. */
+            200: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description `true` on a 200: the run this Idempotency-Key made before. */
+                    "Idempotent-Replayed"?: string;
+                    /** @description The run's URL path. */
+                    Location?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Run"];
+                };
+            };
+            /** @description Queued; `Location` names it. */
+            201: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description `true` on a 200: the run this Idempotency-Key made before. */
+                    "Idempotent-Replayed"?: string;
+                    /** @description The run's URL path. */
+                    Location?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Run"];
+                };
+            };
+            /** @description The request does not fit the version, engine or MCU. */
+            400: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No valid credential. */
+            401: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description The Idempotency-Key was used for a different run. */
+            409: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description The version is retired. */
+            410: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description The body or the firmware is too large. */
+            413: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Neither JSON nor multipart/form-data. */
+            415: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description The caller has as many runs unfinished as allowed. */
+            429: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description Seconds to wait before trying again. */
+                    "Retry-After"?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A service it relies on is unavailable. */
+            503: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description Seconds to wait before trying again. */
+                    "Retry-After"?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Run"];
+                };
+            };
+            /** @description The request is not one the API takes (see `code`). */
+            400: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No valid credential. */
+            401: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            404: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A service the API relies on is unavailable. */
+            503: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description Seconds to wait before trying again. */
+                    "Retry-After"?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    cancel: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Run"];
+                };
+            };
+            /** @description The request is not one the API takes (see `code`). */
+            400: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No valid credential. */
+            401: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            404: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description The run had already finished. */
+            409: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A service the API relies on is unavailable. */
+            503: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description Seconds to wait before trying again. */
+                    "Retry-After"?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    events: {
+        parameters: {
+            query?: {
+                /** @description Byte offset to start the console at. */
+                log?: number;
+                /** @description Byte offset to start the UART records at. */
+                output?: number;
+            };
+            header?: {
+                /** @description `<log>:<output>`, from the last event received. */
+                "Last-Event-ID"?: string | null;
+            };
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/event-stream": string;
+                };
+            };
+            /** @description The request is not one the API takes (see `code`). */
+            400: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No valid credential. */
+            401: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            404: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A service the API relies on is unavailable. */
+            503: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description Seconds to wait before trying again. */
+                    "Retry-After"?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    live: {
+        parameters: {
+            query?: {
+                /** @description Byte offset into the console. */
+                log?: number;
+                /** @description Byte offset into the UART records. */
+                output?: number;
+            };
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Live"];
+                };
+            };
+            400: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No valid credential. */
+            401: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            404: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A service the API relies on is unavailable. */
+            503: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description Seconds to wait before trying again. */
+                    "Retry-After"?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    log: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description The request is not one the API takes (see `code`). */
+            400: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No valid credential. */
+            401: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            404: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            409: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A service the API relies on is unavailable. */
+            503: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description Seconds to wait before trying again. */
+                    "Retry-After"?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    output: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description The request is not one the API takes (see `code`). */
+            400: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No valid credential. */
+            401: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            404: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            409: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A service the API relies on is unavailable. */
+            503: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description Seconds to wait before trying again. */
+                    "Retry-After"?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    result: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RunResult"];
+                };
+            };
+            /** @description The request is not one the API takes (see `code`). */
+            400: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No valid credential. */
+            401: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            404: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description The run has not finished. */
+            409: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A service the API relies on is unavailable. */
+            503: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description Seconds to wait before trying again. */
+                    "Retry-After"?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    versions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VersionList"];
+                };
+            };
+            /** @description The request is not one the API takes (see `code`). */
+            400: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A service the API relies on is unavailable. */
+            503: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description Seconds to wait before trying again. */
+                    "Retry-After"?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    version: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Such as 1.0 or 1.0-preview.1. */
+                version: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VersionView"];
+                };
+            };
+            /** @description The request is not one the API takes (see `code`). */
+            400: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            404: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A service the API relies on is unavailable. */
+            503: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description Seconds to wait before trying again. */
+                    "Retry-After"?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    version_mcus: {
+        parameters: {
+            query?: {
+                /** @description Only this engine's MCUs. */
+                engine?: string;
+                /** @description Only MCUs that run (on `engine`, or on any engine). */
+                runnable?: boolean;
+            };
+            header?: never;
+            path: {
+                version: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["McuList"];
+                };
+            };
+            400: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            404: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A service the API relies on is unavailable. */
+            503: {
+                headers: {
+                    /** @description The API version that answered. */
+                    "Cloud-Sim-Version"?: string;
+                    /** @description For a deprecated version: `@` and the Unix time it was deprecated (RFC 9745). */
+                    Deprecation?: string;
+                    /** @description Seconds to wait before trying again. */
+                    "Retry-After"?: string;
+                    /** @description For a deprecated version with a sunset date: when it retires (RFC 8594). */
+                    Sunset?: string;
+                    /** @description The request's id, which an error's `request_id` repeats. */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+}