sandbox-agent 0.4.0 → 0.4.1

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 import { NewSessionRequest, SessionConfigOption, SessionModeState, AnyMessage, AcpEnvelopeDirection, RequestPermissionRequest, RequestPermissionResponse, NewSessionResponse, PermissionOptionKind, PromptRequest, PromptResponse, SetSessionModeResponse, SetSessionConfigOptionResponse } from 'acp-http-client';
 export { AcpRpcError } from 'acp-http-client';
-import { S as SandboxProvider } from './types-DLlJOfyX.js';
+import { S as SandboxProvider } from './types-DdcvY5CI.js';
 export { S as SandboxAgentSpawnLogMode, a as SandboxAgentSpawnOptions } from './spawn-76JDF5d3.js';
+export { SpritesClientOverrides, SpritesCreateOverrides, SpritesProviderOptions } from './providers/sprites.js';
+import '@fly/sprites';
 
 interface components {
     schemas: {
@@ -74,6 +76,255 @@ interface components {
         AgentListResponse: {
             agents: components["schemas"]["AgentInfo"][];
         };
+        DesktopActionResponse: {
+            ok: boolean;
+        };
+        DesktopClipboardQuery: {
+            selection?: string | null;
+        };
+        DesktopClipboardResponse: {
+            selection: string;
+            text: string;
+        };
+        DesktopClipboardWriteRequest: {
+            selection?: string | null;
+            text: string;
+        };
+        DesktopDisplayInfoResponse: {
+            display: string;
+            resolution: components["schemas"]["DesktopResolution"];
+        };
+        DesktopErrorInfo: {
+            code: string;
+            message: string;
+        };
+        DesktopKeyModifiers: {
+            alt?: boolean | null;
+            cmd?: boolean | null;
+            ctrl?: boolean | null;
+            shift?: boolean | null;
+        };
+        DesktopKeyboardDownRequest: {
+            key: string;
+        };
+        DesktopKeyboardPressRequest: {
+            key: string;
+            modifiers?: components["schemas"]["DesktopKeyModifiers"] | null;
+        };
+        DesktopKeyboardTypeRequest: {
+            /** Format: int32 */
+            delayMs?: number | null;
+            text: string;
+        };
+        DesktopKeyboardUpRequest: {
+            key: string;
+        };
+        DesktopLaunchRequest: {
+            app: string;
+            args?: string[] | null;
+            wait?: boolean | null;
+        };
+        DesktopLaunchResponse: {
+            /** Format: int32 */
+            pid?: number | null;
+            processId: string;
+            windowId?: string | null;
+        };
+        /** @enum {string} */
+        DesktopMouseButton: "left" | "middle" | "right";
+        DesktopMouseClickRequest: {
+            button?: components["schemas"]["DesktopMouseButton"] | null;
+            /** Format: int32 */
+            clickCount?: number | null;
+            /** Format: int32 */
+            x: number;
+            /** Format: int32 */
+            y: number;
+        };
+        DesktopMouseDownRequest: {
+            button?: components["schemas"]["DesktopMouseButton"] | null;
+            /** Format: int32 */
+            x?: number | null;
+            /** Format: int32 */
+            y?: number | null;
+        };
+        DesktopMouseDragRequest: {
+            button?: components["schemas"]["DesktopMouseButton"] | null;
+            /** Format: int32 */
+            endX: number;
+            /** Format: int32 */
+            endY: number;
+            /** Format: int32 */
+            startX: number;
+            /** Format: int32 */
+            startY: number;
+        };
+        DesktopMouseMoveRequest: {
+            /** Format: int32 */
+            x: number;
+            /** Format: int32 */
+            y: number;
+        };
+        DesktopMousePositionResponse: {
+            /** Format: int32 */
+            screen?: number | null;
+            window?: string | null;
+            /** Format: int32 */
+            x: number;
+            /** Format: int32 */
+            y: number;
+        };
+        DesktopMouseScrollRequest: {
+            /** Format: int32 */
+            deltaX?: number | null;
+            /** Format: int32 */
+            deltaY?: number | null;
+            /** Format: int32 */
+            x: number;
+            /** Format: int32 */
+            y: number;
+        };
+        DesktopMouseUpRequest: {
+            button?: components["schemas"]["DesktopMouseButton"] | null;
+            /** Format: int32 */
+            x?: number | null;
+            /** Format: int32 */
+            y?: number | null;
+        };
+        DesktopOpenRequest: {
+            target: string;
+        };
+        DesktopOpenResponse: {
+            /** Format: int32 */
+            pid?: number | null;
+            processId: string;
+        };
+        DesktopProcessInfo: {
+            logPath?: string | null;
+            name: string;
+            /** Format: int32 */
+            pid?: number | null;
+            running: boolean;
+        };
+        DesktopRecordingInfo: {
+            /** Format: int64 */
+            bytes: number;
+            endedAt?: string | null;
+            fileName: string;
+            id: string;
+            processId?: string | null;
+            startedAt: string;
+            status: components["schemas"]["DesktopRecordingStatus"];
+        };
+        DesktopRecordingListResponse: {
+            recordings: components["schemas"]["DesktopRecordingInfo"][];
+        };
+        DesktopRecordingStartRequest: {
+            /** Format: int32 */
+            fps?: number | null;
+        };
+        /** @enum {string} */
+        DesktopRecordingStatus: "recording" | "completed" | "failed";
+        DesktopRegionScreenshotQuery: {
+            format?: components["schemas"]["DesktopScreenshotFormat"] | null;
+            /** Format: int32 */
+            height: number;
+            /** Format: int32 */
+            quality?: number | null;
+            /** Format: float */
+            scale?: number | null;
+            showCursor?: boolean | null;
+            /** Format: int32 */
+            width: number;
+            /** Format: int32 */
+            x: number;
+            /** Format: int32 */
+            y: number;
+        };
+        DesktopResolution: {
+            /** Format: int32 */
+            dpi?: number | null;
+            /** Format: int32 */
+            height: number;
+            /** Format: int32 */
+            width: number;
+        };
+        /** @enum {string} */
+        DesktopScreenshotFormat: "png" | "jpeg" | "webp";
+        DesktopScreenshotQuery: {
+            format?: components["schemas"]["DesktopScreenshotFormat"] | null;
+            /** Format: int32 */
+            quality?: number | null;
+            /** Format: float */
+            scale?: number | null;
+            showCursor?: boolean | null;
+        };
+        DesktopStartRequest: {
+            /** Format: int32 */
+            displayNum?: number | null;
+            /** Format: int32 */
+            dpi?: number | null;
+            /** Format: int32 */
+            height?: number | null;
+            /** Format: int32 */
+            recordingFps?: number | null;
+            stateDir?: string | null;
+            streamAudioCodec?: string | null;
+            /** Format: int32 */
+            streamFrameRate?: number | null;
+            streamVideoCodec?: string | null;
+            webrtcPortRange?: string | null;
+            /** Format: int32 */
+            width?: number | null;
+        };
+        /** @enum {string} */
+        DesktopState: "inactive" | "install_required" | "starting" | "active" | "stopping" | "failed";
+        DesktopStatusResponse: {
+            display?: string | null;
+            installCommand?: string | null;
+            lastError?: components["schemas"]["DesktopErrorInfo"] | null;
+            missingDependencies?: string[];
+            processes?: components["schemas"]["DesktopProcessInfo"][];
+            resolution?: components["schemas"]["DesktopResolution"] | null;
+            runtimeLogPath?: string | null;
+            startedAt?: string | null;
+            state: components["schemas"]["DesktopState"];
+            /** @description Current visible windows (included when the desktop is active). */
+            windows?: components["schemas"]["DesktopWindowInfo"][];
+        };
+        DesktopStreamStatusResponse: {
+            active: boolean;
+            processId?: string | null;
+            windowId?: string | null;
+        };
+        DesktopWindowInfo: {
+            /** Format: int32 */
+            height: number;
+            id: string;
+            isActive: boolean;
+            title: string;
+            /** Format: int32 */
+            width: number;
+            /** Format: int32 */
+            x: number;
+            /** Format: int32 */
+            y: number;
+        };
+        DesktopWindowListResponse: {
+            windows: components["schemas"]["DesktopWindowInfo"][];
+        };
+        DesktopWindowMoveRequest: {
+            /** Format: int32 */
+            x: number;
+            /** Format: int32 */
+            y: number;
+        };
+        DesktopWindowResizeRequest: {
+            /** Format: int32 */
+            height: number;
+            /** Format: int32 */
+            width: number;
+        };
         /** @enum {string} */
         ErrorType: "invalid_request" | "conflict" | "unsupported_agent" | "agent_not_installed" | "install_failed" | "agent_process_exited" | "token_invalid" | "permission_denied" | "not_acceptable" | "unsupported_media_type" | "not_found" | "session_not_found" | "session_already_exists" | "mode_not_supported" | "stream_error" | "timeout";
         FsActionResponse: {
@@ -204,6 +455,7 @@ interface components {
             exitedAtMs?: number | null;
             id: string;
             interactive: boolean;
+            owner: components["schemas"]["ProcessOwner"];
             /** Format: int32 */
             pid?: number | null;
             status: components["schemas"]["ProcessState"];
@@ -216,6 +468,9 @@ interface components {
         ProcessInputResponse: {
             bytesWritten: number;
         };
+        ProcessListQuery: {
+            owner?: components["schemas"]["ProcessOwner"] | null;
+        };
         ProcessListResponse: {
             processes: components["schemas"]["ProcessInfo"][];
         };
@@ -242,6 +497,8 @@ interface components {
         };
         /** @enum {string} */
         ProcessLogsStream: "stdout" | "stderr" | "combined" | "pty";
+        /** @enum {string} */
+        ProcessOwner: "user" | "desktop" | "system";
         ProcessRunRequest: {
             args?: string[];
             command: string;
@@ -386,262 +643,1374 @@ interface operations {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
-            /** @description Unknown ACP server */
-            404: {
+            /** @description Unknown ACP server */
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Client does not accept JSON responses */
+            406: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description ACP server bound to different agent */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Unsupported media type */
+            415: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description ACP agent process response timeout */
+            504: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    delete_v1_acp: {
+        parameters: {
+            path: {
+                /** @description Client-defined ACP server id */
+                server_id: string;
+            };
+        };
+        responses: {
+            /** @description ACP server closed */
+            204: {
+                content: never;
+            };
+        };
+    };
+    get_v1_agents: {
+        parameters: {
+            query?: {
+                /** @description When true, include version/path/configOptions (slower) */
+                config?: boolean | null;
+                /** @description When true, bypass version cache */
+                no_cache?: boolean | null;
+            };
+        };
+        responses: {
+            /** @description List of v1 agents */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["AgentListResponse"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    get_v1_agent: {
+        parameters: {
+            query?: {
+                /** @description When true, include version/path/configOptions (slower) */
+                config?: boolean | null;
+                /** @description When true, bypass version cache */
+                no_cache?: boolean | null;
+            };
+            path: {
+                /** @description Agent id */
+                agent: string;
+            };
+        };
+        responses: {
+            /** @description Agent info */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["AgentInfo"];
+                };
+            };
+            /** @description Unknown agent */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    post_v1_agent_install: {
+        parameters: {
+            path: {
+                /** @description Agent id */
+                agent: string;
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AgentInstallRequest"];
+            };
+        };
+        responses: {
+            /** @description Agent install result */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["AgentInstallResponse"];
+                };
+            };
+            /** @description Invalid request */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Install failed */
+            500: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    get_v1_config_mcp: {
+        parameters: {
+            query: {
+                /** @description Target directory */
+                directory: string;
+                /** @description MCP entry name */
+                mcpName: string;
+            };
+        };
+        responses: {
+            /** @description MCP entry */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["McpServerConfig"];
+                };
+            };
+            /** @description Entry not found */
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    put_v1_config_mcp: {
+        parameters: {
+            query: {
+                /** @description Target directory */
+                directory: string;
+                /** @description MCP entry name */
+                mcpName: string;
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["McpServerConfig"];
+            };
+        };
+        responses: {
+            /** @description Stored */
+            204: {
+                content: never;
+            };
+        };
+    };
+    delete_v1_config_mcp: {
+        parameters: {
+            query: {
+                /** @description Target directory */
+                directory: string;
+                /** @description MCP entry name */
+                mcpName: string;
+            };
+        };
+        responses: {
+            /** @description Deleted */
+            204: {
+                content: never;
+            };
+        };
+    };
+    get_v1_config_skills: {
+        parameters: {
+            query: {
+                /** @description Target directory */
+                directory: string;
+                /** @description Skill entry name */
+                skillName: string;
+            };
+        };
+        responses: {
+            /** @description Skills entry */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["SkillsConfig"];
+                };
+            };
+            /** @description Entry not found */
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    put_v1_config_skills: {
+        parameters: {
+            query: {
+                /** @description Target directory */
+                directory: string;
+                /** @description Skill entry name */
+                skillName: string;
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SkillsConfig"];
+            };
+        };
+        responses: {
+            /** @description Stored */
+            204: {
+                content: never;
+            };
+        };
+    };
+    delete_v1_config_skills: {
+        parameters: {
+            query: {
+                /** @description Target directory */
+                directory: string;
+                /** @description Skill entry name */
+                skillName: string;
+            };
+        };
+        responses: {
+            /** @description Deleted */
+            204: {
+                content: never;
+            };
+        };
+    };
+    /**
+     * Read the desktop clipboard.
+     * @description Returns the current text content of the X11 clipboard.
+     */
+    get_v1_desktop_clipboard: {
+        parameters: {
+            query?: {
+                selection?: string | null;
+            };
+        };
+        responses: {
+            /** @description Clipboard contents */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopClipboardResponse"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Clipboard read failed */
+            500: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Write to the desktop clipboard.
+     * @description Sets the text content of the X11 clipboard.
+     */
+    post_v1_desktop_clipboard: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopClipboardWriteRequest"];
+            };
+        };
+        responses: {
+            /** @description Clipboard updated */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopActionResponse"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Clipboard write failed */
+            500: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Get desktop display information.
+     * @description Performs a health-gated display query against the managed desktop and
+     * returns the current display identifier and resolution.
+     */
+    get_v1_desktop_display_info: {
+        responses: {
+            /** @description Desktop display information */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopDisplayInfoResponse"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime health or display query failed */
+            503: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Press and hold a desktop keyboard key.
+     * @description Performs a health-gated `xdotool keydown` operation against the managed
+     * desktop.
+     */
+    post_v1_desktop_keyboard_down: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopKeyboardDownRequest"];
+            };
+        };
+        responses: {
+            /** @description Desktop keyboard action result */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopActionResponse"];
+                };
+            };
+            /** @description Invalid keyboard down request */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime health or input failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Press a desktop keyboard shortcut.
+     * @description Performs a health-gated `xdotool key` operation against the managed
+     * desktop.
+     */
+    post_v1_desktop_keyboard_press: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopKeyboardPressRequest"];
+            };
+        };
+        responses: {
+            /** @description Desktop keyboard action result */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopActionResponse"];
+                };
+            };
+            /** @description Invalid keyboard press request */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime health or input failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Type desktop keyboard text.
+     * @description Performs a health-gated `xdotool type` operation against the managed
+     * desktop.
+     */
+    post_v1_desktop_keyboard_type: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopKeyboardTypeRequest"];
+            };
+        };
+        responses: {
+            /** @description Desktop keyboard action result */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopActionResponse"];
+                };
+            };
+            /** @description Invalid keyboard type request */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime health or input failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Release a desktop keyboard key.
+     * @description Performs a health-gated `xdotool keyup` operation against the managed
+     * desktop.
+     */
+    post_v1_desktop_keyboard_up: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopKeyboardUpRequest"];
+            };
+        };
+        responses: {
+            /** @description Desktop keyboard action result */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopActionResponse"];
+                };
+            };
+            /** @description Invalid keyboard up request */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime health or input failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Launch a desktop application.
+     * @description Launches an application by name on the managed desktop, optionally waiting
+     * for its window to appear.
+     */
+    post_v1_desktop_launch: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopLaunchRequest"];
+            };
+        };
+        responses: {
+            /** @description Application launched */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopLaunchResponse"];
+                };
+            };
+            /** @description Application not found */
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Click on the desktop.
+     * @description Performs a health-gated pointer move and click against the managed desktop
+     * and returns the resulting mouse position.
+     */
+    post_v1_desktop_mouse_click: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopMouseClickRequest"];
+            };
+        };
+        responses: {
+            /** @description Desktop mouse position after click */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopMousePositionResponse"];
+                };
+            };
+            /** @description Invalid mouse click request */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime health or input failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Press and hold a desktop mouse button.
+     * @description Performs a health-gated optional pointer move followed by `xdotool mousedown`
+     * and returns the resulting mouse position.
+     */
+    post_v1_desktop_mouse_down: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopMouseDownRequest"];
+            };
+        };
+        responses: {
+            /** @description Desktop mouse position after button press */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopMousePositionResponse"];
+                };
+            };
+            /** @description Invalid mouse down request */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime health or input failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Drag the desktop mouse.
+     * @description Performs a health-gated drag gesture against the managed desktop and
+     * returns the resulting mouse position.
+     */
+    post_v1_desktop_mouse_drag: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopMouseDragRequest"];
+            };
+        };
+        responses: {
+            /** @description Desktop mouse position after drag */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopMousePositionResponse"];
+                };
+            };
+            /** @description Invalid mouse drag request */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime health or input failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Move the desktop mouse.
+     * @description Performs a health-gated absolute pointer move on the managed desktop and
+     * returns the resulting mouse position.
+     */
+    post_v1_desktop_mouse_move: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopMouseMoveRequest"];
+            };
+        };
+        responses: {
+            /** @description Desktop mouse position after move */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopMousePositionResponse"];
+                };
+            };
+            /** @description Invalid mouse move request */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime health or input failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Get the current desktop mouse position.
+     * @description Performs a health-gated mouse position query against the managed desktop.
+     */
+    get_v1_desktop_mouse_position: {
+        responses: {
+            /** @description Desktop mouse position */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopMousePositionResponse"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime health or input check failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Scroll the desktop mouse wheel.
+     * @description Performs a health-gated scroll gesture at the requested coordinates and
+     * returns the resulting mouse position.
+     */
+    post_v1_desktop_mouse_scroll: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopMouseScrollRequest"];
+            };
+        };
+        responses: {
+            /** @description Desktop mouse position after scroll */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopMousePositionResponse"];
+                };
+            };
+            /** @description Invalid mouse scroll request */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime health or input failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Release a desktop mouse button.
+     * @description Performs a health-gated optional pointer move followed by `xdotool mouseup`
+     * and returns the resulting mouse position.
+     */
+    post_v1_desktop_mouse_up: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopMouseUpRequest"];
+            };
+        };
+        responses: {
+            /** @description Desktop mouse position after button release */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopMousePositionResponse"];
+                };
+            };
+            /** @description Invalid mouse up request */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime health or input failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Open a file or URL with the default handler.
+     * @description Opens a file path or URL using xdg-open on the managed desktop.
+     */
+    post_v1_desktop_open: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopOpenRequest"];
+            };
+        };
+        responses: {
+            /** @description Target opened */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopOpenResponse"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Start desktop recording.
+     * @description Starts an ffmpeg x11grab recording against the managed desktop and returns
+     * the created recording metadata.
+     */
+    post_v1_desktop_recording_start: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopRecordingStartRequest"];
+            };
+        };
+        responses: {
+            /** @description Desktop recording started */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopRecordingInfo"];
+                };
+            };
+            /** @description Desktop runtime is not ready or a recording is already active */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop recording failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Stop desktop recording.
+     * @description Stops the active desktop recording and returns the finalized recording
+     * metadata.
+     */
+    post_v1_desktop_recording_stop: {
+        responses: {
+            /** @description Desktop recording stopped */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopRecordingInfo"];
+                };
+            };
+            /** @description No active desktop recording */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop recording stop failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * List desktop recordings.
+     * @description Returns the current desktop recording catalog.
+     */
+    get_v1_desktop_recordings: {
+        responses: {
+            /** @description Desktop recordings */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopRecordingListResponse"];
+                };
+            };
+            /** @description Desktop recordings query failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Get desktop recording metadata.
+     * @description Returns metadata for a single desktop recording.
+     */
+    get_v1_desktop_recording: {
+        parameters: {
+            path: {
+                /** @description Desktop recording ID */
+                id: string;
+            };
+        };
+        responses: {
+            /** @description Desktop recording metadata */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopRecordingInfo"];
+                };
+            };
+            /** @description Unknown desktop recording */
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Delete a desktop recording.
+     * @description Removes a completed desktop recording and its file from disk.
+     */
+    delete_v1_desktop_recording: {
+        parameters: {
+            path: {
+                /** @description Desktop recording ID */
+                id: string;
+            };
+        };
+        responses: {
+            /** @description Desktop recording deleted */
+            204: {
+                content: never;
+            };
+            /** @description Unknown desktop recording */
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop recording is still active */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Download a desktop recording.
+     * @description Serves the recorded MP4 bytes for a completed desktop recording.
+     */
+    get_v1_desktop_recording_download: {
+        parameters: {
+            path: {
+                /** @description Desktop recording ID */
+                id: string;
+            };
+        };
+        responses: {
+            /** @description Desktop recording as MP4 bytes */
+            200: {
+                content: never;
+            };
+            /** @description Unknown desktop recording */
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Capture a full desktop screenshot.
+     * @description Performs a health-gated full-frame screenshot of the managed desktop and
+     * returns the requested image bytes.
+     */
+    get_v1_desktop_screenshot: {
+        parameters: {
+            query?: {
+                format?: components["schemas"]["DesktopScreenshotFormat"] | null;
+                quality?: number | null;
+                scale?: number | null;
+                showCursor?: boolean | null;
+            };
+        };
+        responses: {
+            /** @description Desktop screenshot as image bytes */
+            200: {
+                content: never;
+            };
+            /** @description Invalid screenshot query */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime health or screenshot capture failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Capture a desktop screenshot region.
+     * @description Performs a health-gated screenshot crop against the managed desktop and
+     * returns the requested region image bytes.
+     */
+    get_v1_desktop_screenshot_region: {
+        parameters: {
+            query: {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+                format?: components["schemas"]["DesktopScreenshotFormat"] | null;
+                quality?: number | null;
+                scale?: number | null;
+                showCursor?: boolean | null;
+            };
+        };
+        responses: {
+            /** @description Desktop screenshot region as image bytes */
+            200: {
+                content: never;
+            };
+            /** @description Invalid screenshot region */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime health or screenshot capture failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    /**
+     * Start the private desktop runtime.
+     * @description Lazily launches the managed Xvfb/openbox stack, validates display health,
+     * and returns the resulting desktop status snapshot.
+     */
+    post_v1_desktop_start: {
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DesktopStartRequest"];
+            };
+        };
+        responses: {
+            /** @description Desktop runtime status after start */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopStatusResponse"];
+                };
+            };
+            /** @description Invalid desktop start request */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop runtime is already transitioning */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop API unsupported on this platform */
+            501: {
                 content: {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
-            /** @description Client does not accept JSON responses */
-            406: {
+            /** @description Desktop runtime could not be started */
+            503: {
                 content: {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
-            /** @description ACP server bound to different agent */
-            409: {
+        };
+    };
+    /**
+     * Get desktop runtime status.
+     * @description Returns the current desktop runtime state, dependency status, active
+     * display metadata, and supervised process information.
+     */
+    get_v1_desktop_status: {
+        responses: {
+            /** @description Desktop runtime status */
+            200: {
                 content: {
-                    "application/json": components["schemas"]["ProblemDetails"];
+                    "application/json": components["schemas"]["DesktopStatusResponse"];
                 };
             };
-            /** @description Unsupported media type */
-            415: {
+            /** @description Authentication required */
+            401: {
                 content: {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
-            /** @description ACP agent process response timeout */
-            504: {
+        };
+    };
+    /**
+     * Stop the private desktop runtime.
+     * @description Terminates the managed openbox/Xvfb/dbus processes owned by the desktop
+     * runtime and returns the resulting status snapshot.
+     */
+    post_v1_desktop_stop: {
+        responses: {
+            /** @description Desktop runtime status after stop */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopStatusResponse"];
+                };
+            };
+            /** @description Desktop runtime is already transitioning */
+            409: {
                 content: {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
         };
     };
-    delete_v1_acp: {
+    /**
+     * Open a desktop WebRTC signaling session.
+     * @description Upgrades the connection to a WebSocket used for WebRTC signaling between
+     * the browser client and the desktop streaming process. Also accepts mouse
+     * and keyboard input frames as a fallback transport.
+     */
+    get_v1_desktop_stream_ws: {
         parameters: {
-            path: {
-                /** @description Client-defined ACP server id */
-                server_id: string;
+            query?: {
+                /** @description Bearer token alternative for WS auth */
+                access_token?: string | null;
             };
         };
         responses: {
-            /** @description ACP server closed */
-            204: {
+            /** @description WebSocket upgraded */
+            101: {
                 content: never;
             };
-        };
-    };
-    get_v1_agents: {
-        parameters: {
-            query?: {
-                /** @description When true, include version/path/configOptions (slower) */
-                config?: boolean | null;
-                /** @description When true, bypass version cache */
-                no_cache?: boolean | null;
+            /** @description Desktop runtime or streaming session is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description Desktop stream failed */
+            502: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
             };
         };
+    };
+    /**
+     * Start desktop streaming.
+     * @description Enables desktop websocket streaming for the managed desktop.
+     */
+    post_v1_desktop_stream_start: {
         responses: {
-            /** @description List of v1 agents */
+            /** @description Desktop streaming started */
             200: {
                 content: {
-                    "application/json": components["schemas"]["AgentListResponse"];
+                    "application/json": components["schemas"]["DesktopStreamStatusResponse"];
                 };
             };
-            /** @description Authentication required */
-            401: {
+        };
+    };
+    /**
+     * Get desktop stream status.
+     * @description Returns the current state of the desktop WebRTC streaming session.
+     */
+    get_v1_desktop_stream_status: {
+        responses: {
+            /** @description Desktop stream status */
+            200: {
                 content: {
-                    "application/json": components["schemas"]["ProblemDetails"];
+                    "application/json": components["schemas"]["DesktopStreamStatusResponse"];
                 };
             };
         };
     };
-    get_v1_agent: {
-        parameters: {
-            query?: {
-                /** @description When true, include version/path/configOptions (slower) */
-                config?: boolean | null;
-                /** @description When true, bypass version cache */
-                no_cache?: boolean | null;
-            };
-            path: {
-                /** @description Agent id */
-                agent: string;
+    /**
+     * Stop desktop streaming.
+     * @description Disables desktop websocket streaming for the managed desktop.
+     */
+    post_v1_desktop_stream_stop: {
+        responses: {
+            /** @description Desktop streaming stopped */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopStreamStatusResponse"];
+                };
             };
         };
+    };
+    /**
+     * List visible desktop windows.
+     * @description Performs a health-gated visible-window enumeration against the managed
+     * desktop and returns the current window metadata.
+     */
+    get_v1_desktop_windows: {
         responses: {
-            /** @description Agent info */
+            /** @description Visible desktop windows */
             200: {
                 content: {
-                    "application/json": components["schemas"]["AgentInfo"];
+                    "application/json": components["schemas"]["DesktopWindowListResponse"];
                 };
             };
-            /** @description Unknown agent */
-            400: {
+            /** @description Desktop runtime is not ready */
+            409: {
                 content: {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
-            /** @description Authentication required */
-            401: {
+            /** @description Desktop runtime health or window query failed */
+            503: {
                 content: {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
         };
     };
-    post_v1_agent_install: {
-        parameters: {
-            path: {
-                /** @description Agent id */
-                agent: string;
-            };
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["AgentInstallRequest"];
-            };
-        };
+    /**
+     * Get the currently focused desktop window.
+     * @description Returns information about the window that currently has input focus.
+     */
+    get_v1_desktop_windows_focused: {
         responses: {
-            /** @description Agent install result */
+            /** @description Focused window info */
             200: {
                 content: {
-                    "application/json": components["schemas"]["AgentInstallResponse"];
+                    "application/json": components["schemas"]["DesktopWindowInfo"];
                 };
             };
-            /** @description Invalid request */
-            400: {
+            /** @description No window is focused */
+            404: {
                 content: {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
-            /** @description Install failed */
-            500: {
+            /** @description Desktop runtime is not ready */
+            409: {
                 content: {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
         };
     };
-    get_v1_config_mcp: {
+    /**
+     * Focus a desktop window.
+     * @description Brings the specified window to the foreground and gives it input focus.
+     */
+    post_v1_desktop_window_focus: {
         parameters: {
-            query: {
-                /** @description Target directory */
-                directory: string;
-                /** @description MCP entry name */
-                mcpName: string;
+            path: {
+                /** @description X11 window ID */
+                id: string;
             };
         };
         responses: {
-            /** @description MCP entry */
+            /** @description Window info after focus */
             200: {
                 content: {
-                    "application/json": components["schemas"]["McpServerConfig"];
+                    "application/json": components["schemas"]["DesktopWindowInfo"];
                 };
             };
-            /** @description Entry not found */
+            /** @description Window not found */
             404: {
                 content: {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
         };
     };
-    put_v1_config_mcp: {
+    /**
+     * Move a desktop window.
+     * @description Moves the specified window to the given position.
+     */
+    post_v1_desktop_window_move: {
         parameters: {
-            query: {
-                /** @description Target directory */
-                directory: string;
-                /** @description MCP entry name */
-                mcpName: string;
+            path: {
+                /** @description X11 window ID */
+                id: string;
             };
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["McpServerConfig"];
-            };
-        };
-        responses: {
-            /** @description Stored */
-            204: {
-                content: never;
-            };
-        };
-    };
-    delete_v1_config_mcp: {
-        parameters: {
-            query: {
-                /** @description Target directory */
-                directory: string;
-                /** @description MCP entry name */
-                mcpName: string;
-            };
-        };
-        responses: {
-            /** @description Deleted */
-            204: {
-                content: never;
-            };
-        };
-    };
-    get_v1_config_skills: {
-        parameters: {
-            query: {
-                /** @description Target directory */
-                directory: string;
-                /** @description Skill entry name */
-                skillName: string;
+                "application/json": components["schemas"]["DesktopWindowMoveRequest"];
             };
         };
         responses: {
-            /** @description Skills entry */
+            /** @description Window info after move */
             200: {
                 content: {
-                    "application/json": components["schemas"]["SkillsConfig"];
+                    "application/json": components["schemas"]["DesktopWindowInfo"];
                 };
             };
-            /** @description Entry not found */
+            /** @description Window not found */
             404: {
                 content: {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
         };
     };
-    put_v1_config_skills: {
+    /**
+     * Resize a desktop window.
+     * @description Resizes the specified window to the given dimensions.
+     */
+    post_v1_desktop_window_resize: {
         parameters: {
-            query: {
-                /** @description Target directory */
-                directory: string;
-                /** @description Skill entry name */
-                skillName: string;
+            path: {
+                /** @description X11 window ID */
+                id: string;
             };
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["SkillsConfig"];
+                "application/json": components["schemas"]["DesktopWindowResizeRequest"];
             };
         };
         responses: {
-            /** @description Stored */
-            204: {
-                content: never;
+            /** @description Window info after resize */
+            200: {
+                content: {
+                    "application/json": components["schemas"]["DesktopWindowInfo"];
+                };
             };
-        };
-    };
-    delete_v1_config_skills: {
-        parameters: {
-            query: {
-                /** @description Target directory */
-                directory: string;
-                /** @description Skill entry name */
-                skillName: string;
+            /** @description Window not found */
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
             };
-        };
-        responses: {
-            /** @description Deleted */
-            204: {
-                content: never;
+            /** @description Desktop runtime is not ready */
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
             };
         };
     };
@@ -800,6 +2169,11 @@ interface operations {
      * by the runtime, sorted by process ID.
      */
     get_v1_processes: {
+        parameters: {
+            query?: {
+                owner?: components["schemas"]["ProcessOwner"] | null;
+            };
+        };
         responses: {
             /** @description List processes */
             200: {
@@ -1280,6 +2654,46 @@ interface operations {
 
 type ProblemDetails = components["schemas"]["ProblemDetails"];
 type HealthResponse = JsonResponse<operations["get_v1_health"], 200>;
+type DesktopState = components["schemas"]["DesktopState"];
+type DesktopResolution = components["schemas"]["DesktopResolution"];
+type DesktopErrorInfo = components["schemas"]["DesktopErrorInfo"];
+type DesktopProcessInfo = components["schemas"]["DesktopProcessInfo"];
+type DesktopStatusResponse = JsonResponse<operations["get_v1_desktop_status"], 200>;
+type DesktopStartRequest = JsonRequestBody<operations["post_v1_desktop_start"]>;
+type DesktopScreenshotFormat = components["schemas"]["DesktopScreenshotFormat"];
+type DesktopScreenshotQuery = QueryParams<operations["get_v1_desktop_screenshot"]> extends never ? Record<string, never> : QueryParams<operations["get_v1_desktop_screenshot"]>;
+type DesktopRegionScreenshotQuery = QueryParams<operations["get_v1_desktop_screenshot_region"]>;
+type DesktopMousePositionResponse = JsonResponse<operations["get_v1_desktop_mouse_position"], 200>;
+type DesktopMouseButton = components["schemas"]["DesktopMouseButton"];
+type DesktopMouseMoveRequest = JsonRequestBody<operations["post_v1_desktop_mouse_move"]>;
+type DesktopMouseClickRequest = JsonRequestBody<operations["post_v1_desktop_mouse_click"]>;
+type DesktopMouseDownRequest = JsonRequestBody<operations["post_v1_desktop_mouse_down"]>;
+type DesktopMouseUpRequest = JsonRequestBody<operations["post_v1_desktop_mouse_up"]>;
+type DesktopMouseDragRequest = JsonRequestBody<operations["post_v1_desktop_mouse_drag"]>;
+type DesktopMouseScrollRequest = JsonRequestBody<operations["post_v1_desktop_mouse_scroll"]>;
+type DesktopKeyboardTypeRequest = JsonRequestBody<operations["post_v1_desktop_keyboard_type"]>;
+type DesktopKeyModifiers = components["schemas"]["DesktopKeyModifiers"];
+type DesktopKeyboardPressRequest = JsonRequestBody<operations["post_v1_desktop_keyboard_press"]>;
+type DesktopKeyboardDownRequest = JsonRequestBody<operations["post_v1_desktop_keyboard_down"]>;
+type DesktopKeyboardUpRequest = JsonRequestBody<operations["post_v1_desktop_keyboard_up"]>;
+type DesktopActionResponse = JsonResponse<operations["post_v1_desktop_keyboard_type"], 200>;
+type DesktopDisplayInfoResponse = JsonResponse<operations["get_v1_desktop_display_info"], 200>;
+type DesktopWindowInfo = components["schemas"]["DesktopWindowInfo"];
+type DesktopWindowListResponse = JsonResponse<operations["get_v1_desktop_windows"], 200>;
+type DesktopRecordingStartRequest = JsonRequestBody<operations["post_v1_desktop_recording_start"]>;
+type DesktopRecordingStatus = components["schemas"]["DesktopRecordingStatus"];
+type DesktopRecordingInfo = JsonResponse<operations["post_v1_desktop_recording_start"], 200>;
+type DesktopRecordingListResponse = JsonResponse<operations["get_v1_desktop_recordings"], 200>;
+type DesktopStreamStatusResponse = JsonResponse<operations["post_v1_desktop_stream_start"], 200>;
+type DesktopClipboardResponse = JsonResponse<operations["get_v1_desktop_clipboard"], 200>;
+type DesktopClipboardQuery = QueryParams<operations["get_v1_desktop_clipboard"]> extends never ? Record<string, never> : QueryParams<operations["get_v1_desktop_clipboard"]>;
+type DesktopClipboardWriteRequest = JsonRequestBody<operations["post_v1_desktop_clipboard"]>;
+type DesktopLaunchRequest = JsonRequestBody<operations["post_v1_desktop_launch"]>;
+type DesktopLaunchResponse = JsonResponse<operations["post_v1_desktop_launch"], 200>;
+type DesktopOpenRequest = JsonRequestBody<operations["post_v1_desktop_open"]>;
+type DesktopOpenResponse = JsonResponse<operations["post_v1_desktop_open"], 200>;
+type DesktopWindowMoveRequest = JsonRequestBody<operations["post_v1_desktop_window_move"]>;
+type DesktopWindowResizeRequest = JsonRequestBody<operations["post_v1_desktop_window_resize"]>;
 type AgentListResponse = JsonResponse<operations["get_v1_agents"], 200>;
 type AgentInfo = components["schemas"]["AgentInfo"];
 type AgentQuery = QueryParams<operations["get_v1_agents"]>;
@@ -1308,11 +2722,13 @@ type ProcessCreateRequest = JsonRequestBody<operations["post_v1_processes"]>;
 type ProcessInfo = components["schemas"]["ProcessInfo"];
 type ProcessInputRequest = JsonRequestBody<operations["post_v1_process_input"]>;
 type ProcessInputResponse = JsonResponse<operations["post_v1_process_input"], 200>;
+type ProcessListQuery = QueryParams<operations["get_v1_processes"]>;
 type ProcessListResponse = JsonResponse<operations["get_v1_processes"], 200>;
 type ProcessLogEntry = components["schemas"]["ProcessLogEntry"];
 type ProcessLogsQuery = QueryParams<operations["get_v1_process_logs"]>;
 type ProcessLogsResponse = JsonResponse<operations["get_v1_process_logs"], 200>;
 type ProcessLogsStream = components["schemas"]["ProcessLogsStream"];
+type ProcessOwner = components["schemas"]["ProcessOwner"];
 type ProcessRunRequest = JsonRequestBody<operations["post_v1_processes_run"]>;
 type ProcessRunResponse = JsonResponse<operations["post_v1_processes_run"], 200>;
 type ProcessSignalQuery = QueryParams<operations["post_v1_process_stop"]>;
@@ -1432,6 +2848,72 @@ type QueryParams<T> = T extends {
     };
 } ? Q : never;
 
+interface DesktopStreamReadyStatus {
+    type: "ready";
+    width: number;
+    height: number;
+}
+interface DesktopStreamErrorStatus {
+    type: "error";
+    message: string;
+}
+type DesktopStreamStatusMessage = DesktopStreamReadyStatus | DesktopStreamErrorStatus;
+interface DesktopStreamConnectOptions {
+    accessToken?: string;
+    WebSocket?: typeof WebSocket;
+    protocols?: string | string[];
+    RTCPeerConnection?: typeof RTCPeerConnection;
+    rtcConfig?: RTCConfiguration;
+}
+declare class DesktopStreamSession {
+    readonly socket: WebSocket;
+    readonly closed: Promise<void>;
+    private pc;
+    private dataChannel;
+    private mediaStream;
+    private connected;
+    private pendingCandidates;
+    private cachedReadyStatus;
+    private readonly readyListeners;
+    private readonly trackListeners;
+    private readonly connectListeners;
+    private readonly disconnectListeners;
+    private readonly errorListeners;
+    private closedResolve;
+    private readonly PeerConnection;
+    private readonly rtcConfig;
+    constructor(socket: WebSocket, options?: DesktopStreamConnectOptions);
+    onReady(listener: (status: DesktopStreamReadyStatus) => void): () => void;
+    onTrack(listener: (stream: MediaStream) => void): () => void;
+    onConnect(listener: () => void): () => void;
+    onDisconnect(listener: () => void): () => void;
+    onError(listener: (error: DesktopStreamErrorStatus | Error) => void): () => void;
+    /** @deprecated Use onDisconnect instead. */
+    onClose(listener: () => void): () => void;
+    /** @deprecated No longer emits JPEG frames. Use onTrack for WebRTC media. */
+    onFrame(_listener: (frame: Uint8Array) => void): () => void;
+    getMediaStream(): MediaStream | null;
+    /** Build a neko data channel message with the 3-byte header (event + length). */
+    private buildNekoMsg;
+    moveMouse(x: number, y: number): void;
+    mouseDown(button?: DesktopMouseButton, x?: number, y?: number): void;
+    mouseUp(button?: DesktopMouseButton, x?: number, y?: number): void;
+    scroll(x: number, y: number, deltaX?: number, deltaY?: number): void;
+    keyDown(key: string): void;
+    keyUp(key: string): void;
+    close(): void;
+    private handleMessage;
+    private handleNekoOffer;
+    private handleNekoCandidate;
+    private sendSignaling;
+    private sendDataChannel;
+    /** Tear down the peer connection, nullifying handlers first to prevent stale
+     *  callbacks. Matches the reference disconnect() pattern.
+     *  Ref: https://github.com/demodesk/neko-client/blob/37f93ea/src/component/internal/webrtc.ts#L321-L363 */
+    private teardownPeerConnection;
+    private emitError;
+}
+
 interface SandboxAgentHealthWaitOptions {
     timeoutMs?: number;
 }
@@ -1526,12 +3008,20 @@ interface ProcessTerminalConnectOptions extends ProcessTerminalWebSocketUrlOptio
     WebSocket?: typeof WebSocket;
 }
 type ProcessTerminalSessionOptions = ProcessTerminalConnectOptions;
+type DesktopStreamSessionOptions = DesktopStreamConnectOptions;
 declare class SandboxAgentError extends Error {
     readonly status: number;
     readonly problem?: ProblemDetails;
     readonly response: Response;
     constructor(status: number, problem: ProblemDetails | undefined, response: Response);
 }
+declare class SandboxDestroyedError extends Error {
+    readonly sandboxId: string;
+    readonly provider: string;
+    constructor(sandboxId: string, provider: string, options?: {
+        cause?: unknown;
+    });
+}
 declare class UnsupportedSessionCategoryError extends Error {
     readonly sessionId: string;
     readonly category: string;
@@ -1676,6 +3166,8 @@ declare class SandboxAgent {
     get inspectorUrl(): string;
     dispose(): Promise<void>;
     destroySandbox(): Promise<void>;
+    pauseSandbox(): Promise<void>;
+    killSandbox(): Promise<void>;
     listSessions(request?: ListPageRequest): Promise<ListPage<Session>>;
     getSession(id: string): Promise<Session | null>;
     getEvents(request: ListEventsRequest): Promise<ListPage<SessionEvent>>;
@@ -1714,6 +3206,41 @@ declare class SandboxAgent {
     respondPermission(permissionId: string, reply: PermissionReply): Promise<void>;
     rawRespondPermission(permissionId: string, response: RequestPermissionResponse): Promise<void>;
     getHealth(): Promise<HealthResponse>;
+    startDesktop(request?: DesktopStartRequest): Promise<DesktopStatusResponse>;
+    stopDesktop(): Promise<DesktopStatusResponse>;
+    getDesktopStatus(): Promise<DesktopStatusResponse>;
+    getDesktopDisplayInfo(): Promise<DesktopDisplayInfoResponse>;
+    takeDesktopScreenshot(query?: DesktopScreenshotQuery): Promise<Uint8Array>;
+    takeDesktopRegionScreenshot(query: DesktopRegionScreenshotQuery): Promise<Uint8Array>;
+    getDesktopMousePosition(): Promise<DesktopMousePositionResponse>;
+    moveDesktopMouse(request: DesktopMouseMoveRequest): Promise<DesktopMousePositionResponse>;
+    clickDesktop(request: DesktopMouseClickRequest): Promise<DesktopMousePositionResponse>;
+    mouseDownDesktop(request: DesktopMouseDownRequest): Promise<DesktopMousePositionResponse>;
+    mouseUpDesktop(request: DesktopMouseUpRequest): Promise<DesktopMousePositionResponse>;
+    dragDesktopMouse(request: DesktopMouseDragRequest): Promise<DesktopMousePositionResponse>;
+    scrollDesktop(request: DesktopMouseScrollRequest): Promise<DesktopMousePositionResponse>;
+    typeDesktopText(request: DesktopKeyboardTypeRequest): Promise<DesktopActionResponse>;
+    pressDesktopKey(request: DesktopKeyboardPressRequest): Promise<DesktopActionResponse>;
+    keyDownDesktop(request: DesktopKeyboardDownRequest): Promise<DesktopActionResponse>;
+    keyUpDesktop(request: DesktopKeyboardUpRequest): Promise<DesktopActionResponse>;
+    listDesktopWindows(): Promise<DesktopWindowListResponse>;
+    getDesktopFocusedWindow(): Promise<DesktopWindowInfo>;
+    focusDesktopWindow(windowId: string): Promise<DesktopWindowInfo>;
+    moveDesktopWindow(windowId: string, request: DesktopWindowMoveRequest): Promise<DesktopWindowInfo>;
+    resizeDesktopWindow(windowId: string, request: DesktopWindowResizeRequest): Promise<DesktopWindowInfo>;
+    getDesktopClipboard(query?: DesktopClipboardQuery): Promise<DesktopClipboardResponse>;
+    setDesktopClipboard(request: DesktopClipboardWriteRequest): Promise<DesktopActionResponse>;
+    launchDesktopApp(request: DesktopLaunchRequest): Promise<DesktopLaunchResponse>;
+    openDesktopTarget(request: DesktopOpenRequest): Promise<DesktopOpenResponse>;
+    getDesktopStreamStatus(): Promise<DesktopStreamStatusResponse>;
+    startDesktopRecording(request?: DesktopRecordingStartRequest): Promise<DesktopRecordingInfo>;
+    stopDesktopRecording(): Promise<DesktopRecordingInfo>;
+    listDesktopRecordings(): Promise<DesktopRecordingListResponse>;
+    getDesktopRecording(id: string): Promise<DesktopRecordingInfo>;
+    downloadDesktopRecording(id: string): Promise<Uint8Array>;
+    deleteDesktopRecording(id: string): Promise<void>;
+    startDesktopStream(): Promise<DesktopStreamStatusResponse>;
+    stopDesktopStream(): Promise<DesktopStreamStatusResponse>;
     listAgents(options?: AgentQueryOptions): Promise<AgentListResponse>;
     getAgent(agent: string, options?: AgentQueryOptions): Promise<AgentInfo>;
     installAgent(agent: string, request?: AgentInstallRequest): Promise<AgentInstallResponse>;
@@ -1736,7 +3263,7 @@ declare class SandboxAgent {
     setProcessConfig(config: ProcessConfig): Promise<ProcessConfig>;
     createProcess(request: ProcessCreateRequest): Promise<ProcessInfo>;
     runProcess(request: ProcessRunRequest): Promise<ProcessRunResponse>;
-    listProcesses(): Promise<ProcessListResponse>;
+    listProcesses(query?: ProcessListQuery): Promise<ProcessListResponse>;
     getProcess(id: string): Promise<ProcessInfo>;
     stopProcess(id: string, query?: ProcessSignalQuery): Promise<ProcessInfo>;
     killProcess(id: string, query?: ProcessSignalQuery): Promise<ProcessInfo>;
@@ -1748,6 +3275,9 @@ declare class SandboxAgent {
     buildProcessTerminalWebSocketUrl(id: string, options?: ProcessTerminalWebSocketUrlOptions): string;
     connectProcessTerminalWebSocket(id: string, options?: ProcessTerminalConnectOptions): WebSocket;
     connectProcessTerminal(id: string, options?: ProcessTerminalSessionOptions): ProcessTerminalSession;
+    buildDesktopStreamWebSocketUrl(options?: ProcessTerminalWebSocketUrlOptions): string;
+    connectDesktopStreamWebSocket(options?: DesktopStreamConnectOptions): WebSocket;
+    connectDesktopStream(options?: DesktopStreamSessionOptions): DesktopStreamSession;
     private getLiveConnection;
     private persistObservedEnvelope;
     private enqueueObservedEnvelopePersistence;
@@ -1792,4 +3322,4 @@ interface InspectorUrlOptions {
  */
 declare function buildInspectorUrl(options: InspectorUrlOptions): string;
 
-export { type AcpEnvelope, type AcpServerInfo, type AcpServerListResponse, type AgentInfo, type AgentInstallRequest, type AgentInstallResponse, type AgentListResponse, type AgentQuery, type AgentQueryOptions, type FsActionResponse, type FsDeleteQuery, type FsEntriesQuery, type FsEntry, type FsMoveRequest, type FsMoveResponse, type FsPathQuery, type FsStat, type FsUploadBatchQuery, type FsUploadBatchResponse, type FsWriteResponse, type HealthResponse, InMemorySessionPersistDriver, type InMemorySessionPersistDriverOptions, type InspectorUrlOptions, type ListEventsRequest, type ListPage, type ListPageRequest, LiveAcpConnection, type McpConfigQuery, type McpServerConfig, type PermissionReply, type PermissionRequestListener, type ProblemDetails, type ProcessConfig, type ProcessCreateRequest, type ProcessInfo, type ProcessInputRequest, type ProcessInputResponse, type ProcessListResponse, type ProcessLogEntry, type ProcessLogFollowQuery, type ProcessLogListener, type ProcessLogSubscription, type ProcessLogsQuery, type ProcessLogsResponse, type ProcessLogsStream, type ProcessRunRequest, type ProcessRunResponse, type ProcessSignalQuery, type ProcessState, type ProcessTerminalClientFrame, type ProcessTerminalConnectOptions, type ProcessTerminalErrorFrame, type ProcessTerminalExitFrame, type ProcessTerminalReadyFrame, type ProcessTerminalResizeRequest, type ProcessTerminalResizeResponse, type ProcessTerminalServerFrame, ProcessTerminalSession, type ProcessTerminalSessionOptions, type ProcessTerminalWebSocketUrlOptions, SandboxAgent, type SandboxAgentConnectOptions, SandboxAgentError, type SandboxAgentHealthWaitOptions, type SandboxAgentStartOptions, SandboxProvider, Session, type SessionCreateRequest, type SessionEvent, type SessionEventListener, type SessionPermissionRequest, type SessionPermissionRequestOption, type SessionPersistDriver, type SessionRecord, type SessionResumeOrCreateRequest, type SessionSendOptions, type SkillsConfig, type SkillsConfigQuery, type TerminalErrorStatus, type TerminalExitStatus, type TerminalReadyStatus, type TerminalResizePayload, type TerminalStatusMessage, UnsupportedPermissionReplyError, UnsupportedSessionCategoryError, UnsupportedSessionConfigOptionError, UnsupportedSessionValueError, buildInspectorUrl };
+export { type AcpEnvelope, type AcpServerInfo, type AcpServerListResponse, type AgentInfo, type AgentInstallRequest, type AgentInstallResponse, type AgentListResponse, type AgentQuery, type AgentQueryOptions, type DesktopActionResponse, type DesktopDisplayInfoResponse, type DesktopErrorInfo, type DesktopKeyModifiers, type DesktopKeyboardDownRequest, type DesktopKeyboardPressRequest, type DesktopKeyboardTypeRequest, type DesktopKeyboardUpRequest, type DesktopMouseButton, type DesktopMouseClickRequest, type DesktopMouseDownRequest, type DesktopMouseDragRequest, type DesktopMouseMoveRequest, type DesktopMousePositionResponse, type DesktopMouseScrollRequest, type DesktopMouseUpRequest, type DesktopProcessInfo, type DesktopRecordingInfo, type DesktopRecordingListResponse, type DesktopRecordingStartRequest, type DesktopRecordingStatus, type DesktopRegionScreenshotQuery, type DesktopResolution, type DesktopScreenshotFormat, type DesktopScreenshotQuery, type DesktopStartRequest, type DesktopState, type DesktopStatusResponse, type DesktopStreamConnectOptions, type DesktopStreamErrorStatus, type DesktopStreamReadyStatus, DesktopStreamSession, type DesktopStreamSessionOptions, type DesktopStreamStatusMessage, type DesktopStreamStatusResponse, type DesktopWindowInfo, type DesktopWindowListResponse, type FsActionResponse, type FsDeleteQuery, type FsEntriesQuery, type FsEntry, type FsMoveRequest, type FsMoveResponse, type FsPathQuery, type FsStat, type FsUploadBatchQuery, type FsUploadBatchResponse, type FsWriteResponse, type HealthResponse, InMemorySessionPersistDriver, type InMemorySessionPersistDriverOptions, type InspectorUrlOptions, type ListEventsRequest, type ListPage, type ListPageRequest, LiveAcpConnection, type McpConfigQuery, type McpServerConfig, type PermissionReply, type PermissionRequestListener, type ProblemDetails, type ProcessConfig, type ProcessCreateRequest, type ProcessInfo, type ProcessInputRequest, type ProcessInputResponse, type ProcessListQuery, type ProcessListResponse, type ProcessLogEntry, type ProcessLogFollowQuery, type ProcessLogListener, type ProcessLogSubscription, type ProcessLogsQuery, type ProcessLogsResponse, type ProcessLogsStream, type ProcessOwner, type ProcessRunRequest, type ProcessRunResponse, type ProcessSignalQuery, type ProcessState, type ProcessTerminalClientFrame, type ProcessTerminalConnectOptions, type ProcessTerminalErrorFrame, type ProcessTerminalExitFrame, type ProcessTerminalReadyFrame, type ProcessTerminalResizeRequest, type ProcessTerminalResizeResponse, type ProcessTerminalServerFrame, ProcessTerminalSession, type ProcessTerminalSessionOptions, type ProcessTerminalWebSocketUrlOptions, SandboxAgent, type SandboxAgentConnectOptions, SandboxAgentError, type SandboxAgentHealthWaitOptions, type SandboxAgentStartOptions, SandboxDestroyedError, SandboxProvider, Session, type SessionCreateRequest, type SessionEvent, type SessionEventListener, type SessionPermissionRequest, type SessionPermissionRequestOption, type SessionPersistDriver, type SessionRecord, type SessionResumeOrCreateRequest, type SessionSendOptions, type SkillsConfig, type SkillsConfigQuery, type TerminalErrorStatus, type TerminalExitStatus, type TerminalReadyStatus, type TerminalResizePayload, type TerminalStatusMessage, UnsupportedPermissionReplyError, UnsupportedSessionCategoryError, UnsupportedSessionConfigOptionError, UnsupportedSessionValueError, buildInspectorUrl };