@shardflux/sdk 0.5.0

package/dist/generated/cell-api.d.ts

@@ -0,0 +1,1832 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/healthz": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Liveness */
+        get: operations["getHealthz"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/readyz": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Readiness (database reachable, schema at the required version, not draining) */
+        get: operations["getReadyz"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/meta": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Release identity */
+        get: operations["getMeta"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/exec": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Start a command (idempotent by session_id)
+         * @description Requires tool `exec`. argv is executed directly (no shell).
+         */
+        post: operations["execStart"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/exec/{session_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        /** Session status */
+        get: operations["execGet"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/exec/{session_id}/output": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        /**
+         * Read or stream output from byte offsets
+         * @description Streams `OutputEvent` objects as NDJSON (default) or Server-Sent
+         *     Events (`Accept: text/event-stream`). With `follow=true` (default) the
+         *     stream stays open until the session ends (a final `exit` event) or the
+         *     client disconnects; `heartbeat` events are sent every 15 s. With
+         *     `follow=false` it returns the output that exists and ends (plus `exit`
+         *     if the session already ended). Resume with the next offsets.
+         */
+        get: operations["execOutput"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/exec/{session_id}/attach": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        /**
+         * WebSocket attach (output with offsets; signal/cancel)
+         * @description WebSocket upgrade. Server messages are JSON `OutputEvent` text frames.
+         *     Client messages are JSON `ExecClientMessage`. Close codes: 1000 after
+         *     the `exit` event, 1001 on gateway shutdown (reconnect with offsets),
+         *     4401 unauthenticated, 4403 forbidden, 4409 stale epoch / workspace
+         *     busy / workspace not running, 4410 workspace gone, 4429 rate limited,
+         *     4500/4503/4504 internal/unavailable/timeout (4000 + HTTP status; see
+         *     "WebSocket close codes" above; the close reason is compact JSON with
+         *     the error `code`). A refused upgrade from an allowed Origin is
+         *     accepted and closed with these codes after one text frame that is
+         *     exactly the `ErrorBody`.
+         *     `signal`/`cancel` messages are refused with an `error` message
+         *     (`workspace_busy`) while a snapshot capture holds the gate.
+         */
+        get: operations["execAttach"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/exec/{session_id}/signal": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Send a signal to the session's process group */
+        post: operations["execSignal"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/exec/{session_id}/cancel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** SIGTERM the process group, SIGKILL after grace */
+        post: operations["execCancel"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/pty": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Open a PTY session (idempotent by session_id) */
+        post: operations["ptyOpen"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/pty/{session_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        /** PTY session status */
+        get: operations["ptyGet"];
+        put?: never;
+        post?: never;
+        /** Close (SIGHUP, then SIGKILL after grace) */
+        delete: operations["ptyClose"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/pty/{session_id}/resize": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Resize the terminal */
+        post: operations["ptyResize"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/pty/{session_id}/input": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Write input bytes (use the WebSocket for interactive use) */
+        post: operations["ptyInput"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/pty/{session_id}/attach": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        /**
+         * WebSocket attach (input, output with offsets, resize)
+         * @description Server messages: JSON `PtyServerMessage` text frames (`output` with the
+         *     byte offset of `data`, `exit`, `heartbeat`). Client messages: JSON
+         *     `PtyClientMessage` text frames or binary frames (raw input bytes).
+         *     Reconnect with `offset` = last offset + len(data) to resume. Close
+         *     codes and refused upgrades as for exec attach (4401, 4403, 4409, 4410,
+         *     4429, 4500, 4503, 4504; JSON close reason). Input and resize are
+         *     refused with an `error` message (`workspace_busy`) while a snapshot
+         *     capture holds the gate.
+         */
+        get: operations["ptyAttach"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/processes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        /** List guest processes */
+        get: operations["processList"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/processes/{pid}/signal": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                pid: number;
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Signal a guest process */
+        post: operations["processSignal"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/files": {
+        parameters: {
+            query: {
+                path: components["parameters"]["FilePath"];
+            };
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        /** Read a file (supports a single byte Range) */
+        get: operations["fileRead"];
+        /** Write a file (atomic replace or append) with a durable acknowledgement */
+        put: operations["fileWrite"];
+        post?: never;
+        /** Remove a file or directory */
+        delete: operations["fileRemove"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/files/stat": {
+        parameters: {
+            query: {
+                path: components["parameters"]["FilePath"];
+            };
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        /** Stat a path */
+        get: operations["fileStat"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/files/list": {
+        parameters: {
+            query: {
+                path: components["parameters"]["FilePath"];
+            };
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        /** List a directory */
+        get: operations["fileList"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/files/mkdir": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Create a directory */
+        post: operations["fileMkdir"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/files/move": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Move/rename a path */
+        post: operations["fileMove"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/git/clone": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** git clone (https URLs only; runs in the guest with explicit argv) */
+        post: operations["gitClone"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/git/status": {
+        parameters: {
+            query: {
+                path: components["schemas"]["GuestPath"];
+            };
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        /** git status (parsed porcelain v1 with branch) */
+        get: operations["gitStatus"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/git/commit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** git add + commit */
+        post: operations["gitCommit"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/browser/screenshot": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Navigate headless Chromium in the guest and capture a PNG */
+        post: operations["browserScreenshot"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/browser/content": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Navigate headless Chromium in the guest and return the rendered DOM */
+        post: operations["browserContent"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/keepalive": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Keep the workspace hot for a while without tool traffic
+         * @description Sets `keepalive_until = max(current keepalive_until, now + seconds)`:
+         *     a keepalive never shortens an earlier, longer one. `seconds` above the
+         *     cell's `KEEPALIVE_MAX_SECONDS` (default 43200) -> `422
+         *     validation_failed`. Any tool granted by the token authorizes the call;
+         *     the tool gate does not apply and the call is not tool activity.
+         */
+        post: operations["workspaceKeepalive"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/idle": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        /**
+         * Idle policy, activity and the projected automatic suspend
+         * @description `idle_since` = max(`last_tool_at`, `last_attach_at`, `keepalive_until`,
+         *     `running_since`) (null when none is known; in the future while a
+         *     keepalive is active). `suspend_at` = `idle_since` + `idle_minutes` when
+         *     the policy is `suspend_after` and automatic suspend is enabled, else
+         *     null. Activity lags tool traffic by up to `ACTIVITY_FLUSH_MS`. Any
+         *     tool granted by the token authorizes the call; the tool gate does not
+         *     apply and the call is not tool activity.
+         */
+        get: operations["workspaceIdle"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /** @enum {string} */
+        ErrorCode: "bad_request" | "unauthenticated" | "forbidden" | "not_found" | "conflict" | "stale_epoch" | "workspace_not_running" | "validation_failed" | "payload_too_large" | "range_not_satisfiable" | "rate_limited" | "capacity_pending" | "dependency_unavailable" | "timeout" | "internal_error" | "service_unavailable" | "workspace_busy";
+        ErrorBody: {
+            error: {
+                code: components["schemas"]["ErrorCode"];
+                message: string;
+                request_id: string;
+                retryable: boolean;
+                operation_id?: string;
+                details?: {
+                    [key: string]: unknown;
+                };
+            };
+        };
+        Health: {
+            /** @enum {string} */
+            status: "ok" | "ready";
+            schema_version?: number;
+        };
+        Meta: {
+            release_id: string;
+            git_sha: string;
+            image_digest?: string | null;
+            schema_version: number | null;
+            required_schema_version: number;
+            environment: string;
+            cell_id: string;
+            region: string;
+            roles?: string[];
+        };
+        SessionIdValue: string;
+        /** @description Absolute path inside the workspace (relative to the guest files root). */
+        GuestPath: string;
+        /** @enum {string} */
+        SessionState: "starting" | "running" | "exited" | "failed_to_start" | "lost";
+        ExecStartRequest: {
+            session_id?: components["schemas"]["SessionIdValue"];
+            argv: string[];
+            env?: {
+                [key: string]: string;
+            };
+            cwd?: string;
+            user?: string;
+            /** @description Written to stdin, which is then closed (max 1 MiB decoded). */
+            stdin?: string;
+            /** Format: int64 */
+            timeout_ms?: number;
+            /** Format: int64 */
+            kill_grace_ms?: number;
+            secret_refs?: components["schemas"]["SecretRefs"];
+        };
+        /** @description Names of customer secrets (contracts §17) to inject as environment variables NAME=value of this process only. The cell resolves them at session start through the API with the caller's tool token (permission-checked and audited by the API); values are never logged, persisted or returned by the cell. Any name the caller may not use (unknown, not permitted for this workspace/project/tool) refuses the whole start with 403 forbidden (details.reason secret_not_available, details.names); nothing is started. A name that is also a key of `env` is refused (422 validation_failed). Requires a workspace tool token (browser stream tickets cannot resolve secrets: 403, details.reason secret_refs_require_tool_token). Resolution failures: 401 (token revoked/expired), 409 stale_epoch, 429 rate_limited, 503 dependency_unavailable. A retried start with the same session_id re-resolves the names; if a value changed since the first start the host refuses the different request (409 conflict). */
+        SecretRefs: string[];
+        ExecSession: {
+            session_id: string;
+            state: components["schemas"]["SessionState"];
+            /** @description True only in the response to the call that created the session. */
+            created: boolean;
+            pid?: number;
+            /** @description Set when state is exited (-1 when terminated by a signal). */
+            exit_code?: number | null;
+            term_signal?: number | null;
+            timed_out?: boolean;
+            canceled?: boolean;
+            /**
+             * Format: int64
+             * @description Next stdout byte offset.
+             */
+            stdout_size: number;
+            /**
+             * Format: int64
+             * @description Next stderr byte offset.
+             */
+            stderr_size: number;
+            /** Format: date-time */
+            created_at?: string;
+            /** Format: date-time */
+            started_at?: string | null;
+            /** Format: date-time */
+            ended_at?: string | null;
+            error?: string;
+        };
+        OutputEvent: {
+            /** @enum {string} */
+            type: "output" | "exit" | "heartbeat" | "error";
+            /** @enum {string} */
+            stream?: "stdout" | "stderr";
+            /**
+             * Format: int64
+             * @description Byte offset of data[0] within its stream.
+             */
+            offset?: number;
+            data?: string;
+            session?: components["schemas"]["ExecSession"];
+            error?: components["schemas"]["ErrorBody"];
+        };
+        ExecClientMessage: {
+            /** @enum {string} */
+            type: "signal" | "cancel";
+            signal?: components["schemas"]["SignalValue"];
+            /** Format: int64 */
+            grace_ms?: number;
+        };
+        /** @description Signal number (1-64) or name (e.g. "SIGTERM", "TERM"). */
+        SignalValue: number | string;
+        SignalRequest: {
+            signal: components["schemas"]["SignalValue"];
+            /**
+             * @description Signal only the leader instead of the process group (exec only).
+             * @default false
+             */
+            only_leader?: boolean;
+        };
+        CancelRequest: {
+            /** Format: int64 */
+            grace_ms?: number;
+        };
+        PtyOpenRequest: {
+            session_id?: components["schemas"]["SessionIdValue"];
+            argv?: string[];
+            env?: {
+                [key: string]: string;
+            };
+            cwd?: string;
+            user?: string;
+            /** @default 24 */
+            rows?: number;
+            /** @default 80 */
+            cols?: number;
+            secret_refs?: components["schemas"]["SecretRefs"];
+        };
+        PtySession: {
+            session_id: string;
+            state: components["schemas"]["SessionState"];
+            created: boolean;
+            pid?: number;
+            exit_code?: number | null;
+            term_signal?: number | null;
+            rows: number;
+            cols: number;
+            /** Format: int64 */
+            output_size: number;
+            /** Format: date-time */
+            created_at?: string;
+            /** Format: date-time */
+            ended_at?: string | null;
+            error?: string;
+        };
+        PtyResizeRequest: {
+            rows: number;
+            cols: number;
+        };
+        PtyInputRequest: {
+            /** @description Max 1 MiB decoded. */
+            data: string;
+        };
+        PtyServerMessage: {
+            /** @enum {string} */
+            type: "output" | "exit" | "heartbeat" | "error";
+            /** Format: int64 */
+            offset?: number;
+            data?: string;
+            session?: components["schemas"]["PtySession"];
+            error?: components["schemas"]["ErrorBody"];
+        };
+        PtyClientMessage: {
+            /** @enum {string} */
+            type: "input" | "resize";
+            data?: string;
+            rows?: number;
+            cols?: number;
+        };
+        Process: {
+            pid: number;
+            ppid?: number;
+            pgid?: number;
+            uid?: number;
+            state?: string;
+            comm: string;
+            cmdline?: string[];
+            /** Format: int64 */
+            rss_bytes?: number;
+            /** Format: int64 */
+            cpu_user_ms?: number;
+            /** Format: int64 */
+            cpu_system_ms?: number;
+            /** Format: date-time */
+            started_at?: string | null;
+            session_id?: string;
+        };
+        ProcessList: {
+            data: components["schemas"]["Process"][];
+        };
+        /** @enum {string} */
+        FileType: "file" | "directory" | "symlink" | "other";
+        FileInfo: {
+            path: string;
+            name: string;
+            type: components["schemas"]["FileType"];
+            /** Format: int64 */
+            size: number;
+            /** @description Octal permission bits, e.g. "0644". */
+            mode: string;
+            /** Format: date-time */
+            modified_at: string;
+            uid?: number;
+            gid?: number;
+            symlink_target?: string;
+        };
+        FileList: {
+            entries: components["schemas"]["FileInfo"][];
+            truncated: boolean;
+        };
+        FileWriteResult: {
+            path: string;
+            /** Format: int64 */
+            bytes_written: number;
+            sha256: string;
+            /** @description The file and its parent directory were fsync'd before this reply. */
+            durable: boolean;
+            file?: components["schemas"]["FileInfo"];
+        };
+        MkdirRequest: {
+            path: components["schemas"]["GuestPath"];
+            /** @default false */
+            parents?: boolean;
+            mode?: string;
+        };
+        MoveRequest: {
+            from: components["schemas"]["GuestPath"];
+            to: components["schemas"]["GuestPath"];
+            /** @default false */
+            overwrite?: boolean;
+        };
+        GitCloneRequest: {
+            /** @description HTTPS remote only. */
+            url: string;
+            path: components["schemas"]["GuestPath"];
+            branch?: string;
+            depth?: number;
+            /**
+             * Format: int64
+             * @default 600000
+             */
+            timeout_ms?: number;
+        };
+        GitCommitRequest: {
+            path: components["schemas"]["GuestPath"];
+            message: string;
+            /**
+             * @description Stage all changes (git add -A) before committing.
+             * @default true
+             */
+            all?: boolean;
+            paths?: string[];
+            author_name?: string;
+            author_email?: string;
+        };
+        GitResult: {
+            session_id: string;
+            exit_code: number;
+            stdout: string;
+            stderr: string;
+            truncated: boolean;
+            commit?: string;
+        };
+        GitStatus: {
+            exit_code: number;
+            branch: string;
+            upstream?: string;
+            ahead?: number;
+            behind?: number;
+            clean: boolean;
+            entries: {
+                /** @description Two-letter porcelain status. */
+                xy: string;
+                path: string;
+                orig_path?: string;
+            }[];
+            stderr?: string;
+        };
+        BrowserScreenshotRequest: {
+            url: string;
+            /** @default 1280 */
+            width?: number;
+            /** @default 800 */
+            height?: number;
+            /**
+             * Format: int64
+             * @default 30000
+             */
+            timeout_ms?: number;
+        };
+        BrowserContentRequest: {
+            url: string;
+            /**
+             * @default html
+             * @enum {string}
+             */
+            format?: "html" | "text";
+            /**
+             * Format: int64
+             * @default 30000
+             */
+            timeout_ms?: number;
+        };
+        BrowserContent: {
+            url: string;
+            /** @enum {string} */
+            format: "html" | "text";
+            content: string;
+            truncated: boolean;
+        };
+        KeepaliveRequest: {
+            /** @description Keep the workspace hot for this many seconds from now (1..KEEPALIVE_MAX_SECONDS). */
+            seconds: number;
+        };
+        KeepaliveResult: {
+            /** Format: date-time */
+            keepalive_until: string;
+        };
+        IdlePolicy: {
+            /** @enum {string} */
+            mode: "hot" | "suspend_after";
+            /** @description Set when mode is suspend_after. */
+            idle_minutes: number | null;
+            /**
+             * @description workspace = the workspace's own policy; default = the cell default (IDLE_DEFAULT_MODE / IDLE_DEFAULT_MINUTES).
+             * @enum {string}
+             */
+            source: "workspace" | "default";
+        };
+        IdleAutoSuspend: {
+            /** @description Policy is suspend_after and automatic suspend was not disabled (e.g. after repeated failures). */
+            enabled: boolean;
+            disabled_reason: string | null;
+            /** @description Consecutive failed automatic suspend attempts. */
+            failures: number;
+            /** Format: date-time */
+            backoff_until: string | null;
+            /** Format: uuid */
+            last_operation_id: string | null;
+            /** @description Error of the last failed automatic suspend (ErrorBody.error shape). */
+            last_error: {
+                [key: string]: unknown;
+            } | null;
+        };
+        IdleStatus: {
+            policy: components["schemas"]["IdlePolicy"];
+            /** @description Workspace observed_state (contracts §9). */
+            observed_state: string;
+            /** Format: date-time */
+            last_tool_at: string | null;
+            /** Format: date-time */
+            last_attach_at: string | null;
+            /** Format: date-time */
+            keepalive_until: string | null;
+            /** Format: date-time */
+            running_since: string | null;
+            /** Format: date-time */
+            idle_since: string | null;
+            /** Format: date-time */
+            suspend_at: string | null;
+            auto_suspend: components["schemas"]["IdleAutoSuspend"];
+        };
+    };
+    responses: {
+        /** @description Error (contracts §3). */
+        Error: {
+            headers: {
+                "X-Request-Id"?: string;
+                "Retry-After"?: number;
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorBody"];
+            };
+        };
+    };
+    parameters: {
+        WorkspaceId: string;
+        SessionId: components["schemas"]["SessionIdValue"];
+        FilePath: components["schemas"]["GuestPath"];
+    };
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    getHealthz: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Process is alive. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Health"];
+                };
+            };
+        };
+    };
+    getReadyz: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Ready. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Health"];
+                };
+            };
+            503: components["responses"]["Error"];
+        };
+    };
+    getMeta: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Release identity of this replica. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Meta"];
+                };
+            };
+        };
+    };
+    execStart: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ExecStartRequest"];
+            };
+        };
+        responses: {
+            /** @description The session already existed; nothing was run again. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExecSession"];
+                };
+            };
+            /** @description Session created and started. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExecSession"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    execGet: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Session. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExecSession"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    execOutput: {
+        parameters: {
+            query?: {
+                stdout_offset?: number;
+                stderr_offset?: number;
+                follow?: boolean;
+            };
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Stream of OutputEvent. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/x-ndjson": components["schemas"]["OutputEvent"];
+                    "text/event-stream": string;
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    execAttach: {
+        parameters: {
+            query?: {
+                stdout_offset?: number;
+                stderr_offset?: number;
+                ticket?: string;
+            };
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Switching protocols. */
+            101: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    execSignal: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SignalRequest"];
+            };
+        };
+        responses: {
+            /** @description Session after signalling. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExecSession"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    execCancel: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["CancelRequest"];
+            };
+        };
+        responses: {
+            /** @description Session after cancellation was requested. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExecSession"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    ptyOpen: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PtyOpenRequest"];
+            };
+        };
+        responses: {
+            /** @description Already existed. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PtySession"];
+                };
+            };
+            /** @description Created. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PtySession"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    ptyGet: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Session. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PtySession"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    ptyClose: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Session after close was requested. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PtySession"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    ptyResize: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PtyResizeRequest"];
+            };
+        };
+        responses: {
+            /** @description Session. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PtySession"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    ptyInput: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PtyInputRequest"];
+            };
+        };
+        responses: {
+            /** @description Session. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PtySession"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    ptyAttach: {
+        parameters: {
+            query?: {
+                offset?: number;
+                ticket?: string;
+            };
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                session_id: components["parameters"]["SessionId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Switching protocols. */
+            101: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    processList: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Processes. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProcessList"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    processSignal: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                pid: number;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SignalRequest"];
+            };
+        };
+        responses: {
+            /** @description Signalled. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    fileRead: {
+        parameters: {
+            query: {
+                path: components["parameters"]["FilePath"];
+                offset?: number;
+                length?: number;
+            };
+            header?: {
+                Range?: string;
+            };
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description File content. */
+            200: {
+                headers: {
+                    /** @description File size when the read started. */
+                    "X-File-Size"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/octet-stream": string;
+                };
+            };
+            /** @description Partial content. */
+            206: {
+                headers: {
+                    "Content-Range"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/octet-stream": string;
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    fileWrite: {
+        parameters: {
+            query: {
+                path: components["parameters"]["FilePath"];
+                /** @description Octal permission bits for a new file. */
+                mode?: string;
+                create_parents?: boolean;
+                append?: boolean;
+            };
+            header?: {
+                "Idempotency-Key"?: string;
+            };
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/octet-stream": string;
+            };
+        };
+        responses: {
+            /** @description Written and fsync'd. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileWriteResult"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    fileRemove: {
+        parameters: {
+            query: {
+                path: components["parameters"]["FilePath"];
+                recursive?: boolean;
+            };
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Removed. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    fileStat: {
+        parameters: {
+            query: {
+                path: components["parameters"]["FilePath"];
+            };
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description File info. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileInfo"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    fileList: {
+        parameters: {
+            query: {
+                path: components["parameters"]["FilePath"];
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Entries. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileList"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    fileMkdir: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["MkdirRequest"];
+            };
+        };
+        responses: {
+            /** @description Directory info. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileInfo"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    fileMove: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["MoveRequest"];
+            };
+        };
+        responses: {
+            /** @description Info of the destination. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileInfo"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    gitClone: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["GitCloneRequest"];
+            };
+        };
+        responses: {
+            /** @description Command result (check exit_code). */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GitResult"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    gitStatus: {
+        parameters: {
+            query: {
+                path: components["schemas"]["GuestPath"];
+            };
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Repository status. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GitStatus"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    gitCommit: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["GitCommitRequest"];
+            };
+        };
+        responses: {
+            /** @description Command result (commit is set on success). */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GitResult"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    browserScreenshot: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BrowserScreenshotRequest"];
+            };
+        };
+        responses: {
+            /** @description PNG screenshot. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "image/png": string;
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    browserContent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BrowserContentRequest"];
+            };
+        };
+        responses: {
+            /** @description Rendered content. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BrowserContent"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    workspaceKeepalive: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["KeepaliveRequest"];
+            };
+        };
+        responses: {
+            /** @description Effective keepalive. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["KeepaliveResult"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    workspaceIdle: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Idle status. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IdleStatus"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+}