sandbox-agent 0.1.11 → 0.2.0

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+import { NewSessionRequest, AnyMessage, AcpEnvelopeDirection, NewSessionResponse, PromptRequest, PromptResponse } from 'acp-http-client';
+export { AcpRpcError } from 'acp-http-client';
+
 type SandboxAgentSpawnLogMode = "inherit" | "pipe" | "silent";
 type SandboxAgentSpawnOptions = {
     enabled?: boolean;
@@ -10,173 +13,28 @@ type SandboxAgentSpawnOptions = {
     env?: Record<string, string>;
 };
 
-/**
- * This file was auto-generated by openapi-typescript.
- * Do not make direct changes to the file.
- */
-interface paths {
-    "/v1/agents": {
-        /**
-         * List Agents
-         * @description Returns all available coding agents and their installation status.
-         */
-        get: operations["list_agents"];
-    };
-    "/v1/agents/{agent}/install": {
-        /**
-         * Install Agent
-         * @description Installs or updates a coding agent (e.g. claude, codex, opencode, amp).
-         */
-        post: operations["install_agent"];
-    };
-    "/v1/agents/{agent}/models": {
-        /**
-         * List Agent Models
-         * @description Returns the available LLM models for an agent.
-         */
-        get: operations["get_agent_models"];
-    };
-    "/v1/agents/{agent}/modes": {
-        /**
-         * List Agent Modes
-         * @description Returns the available interaction modes for an agent.
-         */
-        get: operations["get_agent_modes"];
-    };
-    "/v1/fs/entries": {
-        /**
-         * List Directory
-         * @description Lists files and directories at the given path.
-         */
-        get: operations["fs_entries"];
-    };
-    "/v1/fs/entry": {
-        /**
-         * Delete Entry
-         * @description Deletes a file or directory.
-         */
-        delete: operations["fs_delete_entry"];
-    };
-    "/v1/fs/file": {
-        /**
-         * Read File
-         * @description Reads the raw bytes of a file.
-         */
-        get: operations["fs_read_file"];
-        /**
-         * Write File
-         * @description Writes raw bytes to a file, creating it if it doesn't exist.
-         */
-        put: operations["fs_write_file"];
-    };
-    "/v1/fs/mkdir": {
-        /**
-         * Create Directory
-         * @description Creates a directory, including any missing parent directories.
-         */
-        post: operations["fs_mkdir"];
-    };
-    "/v1/fs/move": {
-        /**
-         * Move Entry
-         * @description Moves or renames a file or directory.
-         */
-        post: operations["fs_move"];
-    };
-    "/v1/fs/stat": {
-        /**
-         * Get File Info
-         * @description Returns metadata (size, timestamps, type) for a path.
-         */
-        get: operations["fs_stat"];
-    };
-    "/v1/fs/upload-batch": {
-        /**
-         * Upload Files
-         * @description Uploads a tar.gz archive and extracts it to the destination directory.
-         */
-        post: operations["fs_upload_batch"];
-    };
-    "/v1/health": {
-        /**
-         * Health Check
-         * @description Returns the server health status.
-         */
-        get: operations["get_health"];
-    };
-    "/v1/sessions": {
-        /**
-         * List Sessions
-         * @description Returns all active sessions.
-         */
-        get: operations["list_sessions"];
-    };
-    "/v1/sessions/{session_id}": {
-        /**
-         * Create Session
-         * @description Creates a new agent session with the given configuration.
-         */
-        post: operations["create_session"];
-    };
-    "/v1/sessions/{session_id}/events": {
-        /**
-         * Get Events
-         * @description Returns session events with optional offset-based pagination.
-         */
-        get: operations["get_events"];
-    };
-    "/v1/sessions/{session_id}/events/sse": {
-        /**
-         * Subscribe to Events (SSE)
-         * @description Opens an SSE stream for real-time session events.
-         */
-        get: operations["get_events_sse"];
-    };
-    "/v1/sessions/{session_id}/messages": {
-        /**
-         * Send Message
-         * @description Sends a message to a session and returns immediately.
-         */
-        post: operations["post_message"];
-    };
-    "/v1/sessions/{session_id}/messages/stream": {
-        /**
-         * Send Message (Streaming)
-         * @description Sends a message and returns an SSE event stream of the agent's response.
-         */
-        post: operations["post_message_stream"];
-    };
-    "/v1/sessions/{session_id}/permissions/{permission_id}/reply": {
-        /**
-         * Reply to Permission
-         * @description Approves or denies a permission request from the agent.
-         */
-        post: operations["reply_permission"];
-    };
-    "/v1/sessions/{session_id}/questions/{question_id}/reject": {
-        /**
-         * Reject Question
-         * @description Rejects a human-in-the-loop question from the agent.
-         */
-        post: operations["reject_question"];
-    };
-    "/v1/sessions/{session_id}/questions/{question_id}/reply": {
-        /**
-         * Reply to Question
-         * @description Replies to a human-in-the-loop question from the agent.
-         */
-        post: operations["reply_question"];
-    };
-    "/v1/sessions/{session_id}/terminate": {
-        /**
-         * Terminate Session
-         * @description Terminates a running session and cleans up resources.
-         */
-        post: operations["terminate_session"];
-    };
-}
 interface components {
     schemas: {
+        AcpEnvelope: {
+            error?: unknown;
+            id?: unknown;
+            jsonrpc: string;
+            method?: string | null;
+            params?: unknown;
+            result?: unknown;
+        };
+        AcpPostQuery: {
+            agent?: string | null;
+        };
+        AcpServerInfo: {
+            agent: string;
+            /** Format: int64 */
+            createdAtMs: number;
+            serverId: string;
+        };
+        AcpServerListResponse: {
+            servers: components["schemas"]["AcpServerInfo"][];
+        };
         AgentCapabilities: {
             commandExecution: boolean;
             errorEvents: boolean;
@@ -190,7 +48,6 @@ interface components {
             questions: boolean;
             reasoning: boolean;
             sessionLifecycle: boolean;
-            /** @description Whether this agent uses a shared long-running server process (vs per-turn subprocess) */
             sharedProcess: boolean;
             status: boolean;
             streamingDeltas: boolean;
@@ -198,16 +55,10 @@ interface components {
             toolCalls: boolean;
             toolResults: boolean;
         };
-        AgentError: {
-            agent?: string | null;
-            details?: unknown;
-            message: string;
-            session_id?: string | null;
-            type: components["schemas"]["ErrorType"];
-        };
         AgentInfo: {
             capabilities: components["schemas"]["AgentCapabilities"];
-            /** @description Whether the agent's required provider credentials are available */
+            configError?: string | null;
+            configOptions?: unknown[] | null;
             credentialsAvailable: boolean;
             id: string;
             installed: boolean;
@@ -215,128 +66,35 @@ interface components {
             serverStatus?: components["schemas"]["ServerStatusInfo"] | null;
             version?: string | null;
         };
+        AgentInstallArtifact: {
+            kind: string;
+            path: string;
+            source: string;
+            version?: string | null;
+        };
         AgentInstallRequest: {
+            agentProcessVersion?: string | null;
+            agentVersion?: string | null;
             reinstall?: boolean | null;
         };
+        AgentInstallResponse: {
+            already_installed: boolean;
+            artifacts: components["schemas"]["AgentInstallArtifact"][];
+        };
         AgentListResponse: {
             agents: components["schemas"]["AgentInfo"][];
         };
-        AgentModeInfo: {
-            description: string;
-            id: string;
-            name: string;
-        };
-        AgentModelInfo: {
-            defaultVariant?: string | null;
-            id: string;
-            name?: string | null;
-            variants?: string[] | null;
-        };
-        AgentModelsResponse: {
-            defaultModel?: string | null;
-            models: components["schemas"]["AgentModelInfo"][];
-        };
-        AgentModesResponse: {
-            modes: components["schemas"]["AgentModeInfo"][];
-        };
-        AgentUnparsedData: {
-            error: string;
-            location: string;
-            raw_hash?: string | null;
-        };
-        ContentPart: {
-            text: string;
-            /** @enum {string} */
-            type: "text";
-        } | {
-            json: unknown;
-            /** @enum {string} */
-            type: "json";
-        } | {
-            arguments: string;
-            call_id: string;
-            name: string;
-            /** @enum {string} */
-            type: "tool_call";
-        } | {
-            call_id: string;
-            output: string;
-            /** @enum {string} */
-            type: "tool_result";
-        } | ({
-            action: components["schemas"]["FileAction"];
-            diff?: string | null;
-            path: string;
-            /** @enum {string} */
-            type: "file_ref";
-        }) | {
-            text: string;
-            /** @enum {string} */
-            type: "reasoning";
-            visibility: components["schemas"]["ReasoningVisibility"];
-        } | ({
-            mime?: string | null;
-            path: string;
-            /** @enum {string} */
-            type: "image";
-        }) | ({
-            detail?: string | null;
-            label: string;
-            /** @enum {string} */
-            type: "status";
-        });
-        CreateSessionRequest: {
-            agent: string;
-            agentMode?: string | null;
-            agentVersion?: string | null;
-            directory?: string | null;
-            mcp?: {
-                [key: string]: components["schemas"]["McpServerConfig"];
-            } | null;
-            model?: string | null;
-            permissionMode?: string | null;
-            skills?: components["schemas"]["SkillsConfig"] | null;
-            title?: string | null;
-            variant?: string | null;
-        };
-        CreateSessionResponse: {
-            error?: components["schemas"]["AgentError"] | null;
-            healthy: boolean;
-            nativeSessionId?: string | null;
-        };
-        ErrorData: {
-            code?: string | null;
-            details?: unknown;
-            message: string;
-        };
-        /** @enum {string} */
-        ErrorType: "invalid_request" | "unsupported_agent" | "agent_not_installed" | "install_failed" | "agent_process_exited" | "token_invalid" | "permission_denied" | "session_not_found" | "session_already_exists" | "mode_not_supported" | "stream_error" | "timeout";
-        /** @enum {string} */
-        EventSource: "agent" | "daemon";
-        EventsQuery: {
-            includeRaw?: boolean | null;
-            /** Format: int64 */
-            limit?: number | null;
-            /** Format: int64 */
-            offset?: number | null;
-        };
-        EventsResponse: {
-            events: components["schemas"]["UniversalEvent"][];
-            hasMore: boolean;
-        };
         /** @enum {string} */
-        FileAction: "read" | "write" | "patch";
+        ErrorType: "invalid_request" | "conflict" | "unsupported_agent" | "agent_not_installed" | "install_failed" | "agent_process_exited" | "token_invalid" | "permission_denied" | "not_acceptable" | "unsupported_media_type" | "session_not_found" | "session_already_exists" | "mode_not_supported" | "stream_error" | "timeout";
         FsActionResponse: {
             path: string;
         };
         FsDeleteQuery: {
             path: string;
             recursive?: boolean | null;
-            sessionId?: string | null;
         };
         FsEntriesQuery: {
             path?: string | null;
-            sessionId?: string | null;
         };
         FsEntry: {
             entryType: components["schemas"]["FsEntryType"];
@@ -359,10 +117,6 @@ interface components {
         };
         FsPathQuery: {
             path: string;
-            sessionId?: string | null;
-        };
-        FsSessionQuery: {
-            sessionId?: string | null;
         };
         FsStat: {
             entryType: components["schemas"]["FsEntryType"];
@@ -373,7 +127,6 @@ interface components {
         };
         FsUploadBatchQuery: {
             path?: string | null;
-            sessionId?: string | null;
         };
         FsUploadBatchResponse: {
             paths: string[];
@@ -387,32 +140,13 @@ interface components {
         HealthResponse: {
             status: string;
         };
-        ItemDeltaData: {
-            delta: string;
-            item_id: string;
-            native_item_id?: string | null;
-        };
-        ItemEventData: {
-            item: components["schemas"]["UniversalItem"];
+        McpConfigQuery: {
+            directory: string;
+            mcpName: string;
         };
-        /** @enum {string} */
-        ItemKind: "message" | "tool_call" | "tool_result" | "system" | "status" | "unknown";
-        /** @enum {string} */
-        ItemRole: "user" | "assistant" | "system" | "tool";
-        /** @enum {string} */
-        ItemStatus: "in_progress" | "completed" | "failed";
-        McpCommand: string | string[];
-        McpOAuthConfig: {
-            clientId?: string | null;
-            clientSecret?: string | null;
-            scope?: string | null;
-        };
-        McpOAuthConfigOrDisabled: components["schemas"]["McpOAuthConfig"] | boolean;
-        /** @enum {string} */
-        McpRemoteTransport: "http" | "sse";
         McpServerConfig: ({
             args?: string[];
-            command: components["schemas"]["McpCommand"];
+            command: string;
             cwd?: string | null;
             enabled?: boolean | null;
             env?: {
@@ -431,36 +165,14 @@ interface components {
             headers?: {
                 [key: string]: string;
             } | null;
-            oauth?: components["schemas"]["McpOAuthConfigOrDisabled"] | null;
+            oauth?: Record<string, unknown> | null | null;
             /** Format: int64 */
             timeoutMs?: number | null;
-            transport?: components["schemas"]["McpRemoteTransport"] | null;
+            transport?: string | null;
             /** @enum {string} */
             type: "remote";
             url: string;
         });
-        MessageAttachment: {
-            filename?: string | null;
-            mime?: string | null;
-            path: string;
-        };
-        MessageRequest: {
-            attachments?: components["schemas"]["MessageAttachment"][];
-            message: string;
-        };
-        PermissionEventData: {
-            action: string;
-            metadata?: unknown;
-            permission_id: string;
-            status: components["schemas"]["PermissionStatus"];
-        };
-        /** @enum {string} */
-        PermissionReply: "once" | "always" | "reject";
-        PermissionReplyRequest: {
-            reply: components["schemas"]["PermissionReply"];
-        };
-        /** @enum {string} */
-        PermissionStatus: "requested" | "accept" | "accept_for_session" | "reject";
         ProblemDetails: {
             detail?: string | null;
             instance?: string | null;
@@ -470,76 +182,13 @@ interface components {
             type: string;
             [key: string]: unknown;
         };
-        QuestionEventData: {
-            options: string[];
-            prompt: string;
-            question_id: string;
-            response?: string | null;
-            status: components["schemas"]["QuestionStatus"];
-        };
-        QuestionReplyRequest: {
-            answers: string[][];
-        };
-        /** @enum {string} */
-        QuestionStatus: "requested" | "answered" | "rejected";
         /** @enum {string} */
-        ReasoningVisibility: "public" | "private";
-        /**
-         * @description Status of a shared server process for an agent
-         * @enum {string}
-         */
-        ServerStatus: "running" | "stopped" | "error";
+        ServerStatus: "running" | "stopped";
         ServerStatusInfo: {
-            baseUrl?: string | null;
-            lastError?: string | null;
-            /** Format: int64 */
-            restartCount: number;
             status: components["schemas"]["ServerStatus"];
             /** Format: int64 */
             uptimeMs?: number | null;
         };
-        /** @enum {string} */
-        SessionEndReason: "completed" | "error" | "terminated";
-        SessionEndedData: {
-            /**
-             * Format: int32
-             * @description Process exit code when reason is Error
-             */
-            exit_code?: number | null;
-            /** @description Error message when reason is Error */
-            message?: string | null;
-            reason: components["schemas"]["SessionEndReason"];
-            stderr?: components["schemas"]["StderrOutput"] | null;
-            terminated_by: components["schemas"]["TerminatedBy"];
-        };
-        SessionInfo: {
-            agent: string;
-            agentMode: string;
-            /** Format: int64 */
-            createdAt: number;
-            directory?: string | null;
-            ended: boolean;
-            /** Format: int64 */
-            eventCount: number;
-            mcp?: {
-                [key: string]: components["schemas"]["McpServerConfig"];
-            } | null;
-            model?: string | null;
-            nativeSessionId?: string | null;
-            permissionMode: string;
-            sessionId: string;
-            skills?: components["schemas"]["SkillsConfig"] | null;
-            title?: string | null;
-            /** Format: int64 */
-            updatedAt: number;
-            variant?: string | null;
-        };
-        SessionListResponse: {
-            sessions: components["schemas"]["SessionInfo"][];
-        };
-        SessionStartedData: {
-            metadata?: unknown;
-        };
         SkillSource: {
             ref?: string | null;
             skills?: string[] | null;
@@ -550,52 +199,9 @@ interface components {
         SkillsConfig: {
             sources: components["schemas"]["SkillSource"][];
         };
-        StderrOutput: {
-            /** @description First N lines of stderr (if truncated) or full stderr (if not truncated) */
-            head?: string | null;
-            /** @description Last N lines of stderr (only present if truncated) */
-            tail?: string | null;
-            /** @description Total number of lines in stderr */
-            total_lines?: number | null;
-            /** @description Whether the output was truncated */
-            truncated: boolean;
-        };
-        /** @enum {string} */
-        TerminatedBy: "agent" | "daemon";
-        TurnEventData: {
-            metadata?: unknown;
-            phase: components["schemas"]["TurnPhase"];
-            turn_id?: string | null;
-        };
-        /** @enum {string} */
-        TurnPhase: "started" | "ended";
-        TurnStreamQuery: {
-            includeRaw?: boolean | null;
-        };
-        UniversalEvent: {
-            data: components["schemas"]["UniversalEventData"];
-            event_id: string;
-            native_session_id?: string | null;
-            raw?: unknown;
-            /** Format: int64 */
-            sequence: number;
-            session_id: string;
-            source: components["schemas"]["EventSource"];
-            synthetic: boolean;
-            time: string;
-            type: components["schemas"]["UniversalEventType"];
-        };
-        UniversalEventData: components["schemas"]["TurnEventData"] | components["schemas"]["SessionStartedData"] | components["schemas"]["SessionEndedData"] | components["schemas"]["ItemEventData"] | components["schemas"]["ItemDeltaData"] | components["schemas"]["ErrorData"] | components["schemas"]["PermissionEventData"] | components["schemas"]["QuestionEventData"] | components["schemas"]["AgentUnparsedData"];
-        /** @enum {string} */
-        UniversalEventType: "session.started" | "session.ended" | "turn.started" | "turn.ended" | "item.started" | "item.delta" | "item.completed" | "error" | "permission.requested" | "permission.resolved" | "question.requested" | "question.resolved" | "agent.unparsed";
-        UniversalItem: {
-            content: components["schemas"]["ContentPart"][];
-            item_id: string;
-            kind: components["schemas"]["ItemKind"];
-            native_item_id?: string | null;
-            parent_id?: string | null;
-            role?: components["schemas"]["ItemRole"] | null;
-            status: components["schemas"]["ItemStatus"];
+        SkillsConfigQuery: {
+            directory: string;
+            skillName: string;
         };
     };
     responses: never;
@@ -605,39 +211,26 @@ interface components {
     pathItems: never;
 }
 interface operations {
-    /**
-     * List Agents
-     * @description Returns all available coding agents and their installation status.
-     */
-    list_agents: {
+    get_v1_acp_servers: {
         responses: {
-            /** @description List of available agents */
+            /** @description Active ACP server instances */
             200: {
                 content: {
-                    "application/json": components["schemas"]["AgentListResponse"];
+                    "application/json": components["schemas"]["AcpServerListResponse"];
                 };
             };
         };
     };
-    /**
-     * Install Agent
-     * @description Installs or updates a coding agent (e.g. claude, codex, opencode, amp).
-     */
-    install_agent: {
+    get_v1_acp: {
         parameters: {
             path: {
-                /** @description Agent id */
-                agent: string;
-            };
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["AgentInstallRequest"];
+                /** @description Client-defined ACP server id */
+                server_id: string;
             };
         };
         responses: {
-            /** @description Agent installed */
-            204: {
+            /** @description SSE stream of ACP envelopes */
+            200: {
                 content: never;
             };
             /** @description Invalid request */
@@ -646,686 +239,709 @@ interface operations {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
-            /** @description Agent not found */
+            /** @description Unknown ACP server */
             404: {
                 content: {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
-            /** @description Installation failed */
-            500: {
+            /** @description Client does not accept SSE responses */
+            406: {
                 content: {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
         };
     };
-    /**
-     * List Agent Models
-     * @description Returns the available LLM models for an agent.
-     */
-    get_agent_models: {
+    post_v1_acp: {
         parameters: {
+            query?: {
+                /** @description Agent id required for first POST */
+                agent?: string | null;
+            };
             path: {
-                /** @description Agent id */
-                agent: string;
+                /** @description Client-defined ACP server id */
+                server_id: string;
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AcpEnvelope"];
             };
         };
         responses: {
-            /** @description Available models */
+            /** @description JSON-RPC response envelope */
             200: {
                 content: {
-                    "application/json": components["schemas"]["AgentModelsResponse"];
+                    "application/json": components["schemas"]["AcpEnvelope"];
+                };
+            };
+            /** @description JSON-RPC notification accepted */
+            202: {
+                content: never;
+            };
+            /** @description Invalid ACP envelope */
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
-            /** @description Agent not found */
+            /** @description Unknown ACP server */
             404: {
                 content: {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
-        };
-    };
-    /**
-     * List Agent Modes
-     * @description Returns the available interaction modes for an agent.
-     */
-    get_agent_modes: {
-        parameters: {
-            path: {
-                /** @description Agent id */
-                agent: string;
+            /** @description Client does not accept JSON responses */
+            406: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
             };
-        };
-        responses: {
-            /** @description Available modes */
-            200: {
+            /** @description ACP server bound to different agent */
+            409: {
                 content: {
-                    "application/json": components["schemas"]["AgentModesResponse"];
+                    "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
-            /** @description Invalid request */
-            400: {
+            /** @description Unsupported media type */
+            415: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            /** @description ACP agent process response timeout */
+            504: {
                 content: {
                     "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
         };
     };
-    /**
-     * List Directory
-     * @description Lists files and directories at the given path.
-     */
-    fs_entries: {
+    delete_v1_acp: {
         parameters: {
-            query?: {
-                /** @description Path to list (relative or absolute) */
-                path?: string | null;
-                /** @description Session id for relative paths */
-                session_id?: string | null;
+            path: {
+                /** @description Client-defined ACP server id */
+                server_id: string;
             };
         };
         responses: {
-            /** @description Directory listing */
-            200: {
-                content: {
-                    "application/json": components["schemas"]["FsEntry"][];
-                };
+            /** @description ACP server closed */
+            204: {
+                content: never;
             };
         };
     };
-    /**
-     * Delete Entry
-     * @description Deletes a file or directory.
-     */
-    fs_delete_entry: {
+    get_v1_agents: {
         parameters: {
-            query: {
-                /** @description File or directory path */
-                path: string;
-                /** @description Session id for relative paths */
-                session_id?: string | null;
-                /** @description Delete directories recursively */
-                recursive?: boolean | null;
+            query?: {
+                /** @description When true, include version/path/configOptions (slower) */
+                config?: boolean | null;
+                /** @description When true, bypass version cache */
+                no_cache?: boolean | null;
             };
         };
         responses: {
-            /** @description Delete result */
+            /** @description List of v1 agents */
             200: {
                 content: {
-                    "application/json": components["schemas"]["FsActionResponse"];
+                    "application/json": components["schemas"]["AgentListResponse"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
         };
     };
-    /**
-     * Read File
-     * @description Reads the raw bytes of a file.
-     */
-    fs_read_file: {
+    get_v1_agent: {
         parameters: {
-            query: {
-                /** @description File path (relative or absolute) */
-                path: string;
-                /** @description Session id for relative paths */
-                session_id?: string | null;
+            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 File content */
+            /** @description Agent info */
             200: {
                 content: {
-                    "application/octet-stream": string;
+                    "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"];
                 };
             };
         };
     };
-    /**
-     * Write File
-     * @description Writes raw bytes to a file, creating it if it doesn't exist.
-     */
-    fs_write_file: {
+    post_v1_agent_install: {
         parameters: {
-            query: {
-                /** @description File path (relative or absolute) */
-                path: string;
-                /** @description Session id for relative paths */
-                session_id?: string | null;
+            path: {
+                /** @description Agent id */
+                agent: string;
             };
         };
         requestBody: {
             content: {
-                "application/octet-stream": string;
+                "application/json": components["schemas"]["AgentInstallRequest"];
             };
         };
         responses: {
-            /** @description Write result */
+            /** @description Agent install result */
             200: {
                 content: {
-                    "application/json": components["schemas"]["FsWriteResponse"];
+                    "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"];
                 };
             };
         };
     };
-    /**
-     * Create Directory
-     * @description Creates a directory, including any missing parent directories.
-     */
-    fs_mkdir: {
+    get_v1_config_mcp: {
         parameters: {
             query: {
-                /** @description Directory path to create */
-                path: string;
-                /** @description Session id for relative paths */
-                session_id?: string | null;
+                /** @description Target directory */
+                directory: string;
+                /** @description MCP entry name */
+                mcpName: string;
             };
         };
         responses: {
-            /** @description Directory created */
+            /** @description MCP entry */
             200: {
                 content: {
-                    "application/json": components["schemas"]["FsActionResponse"];
+                    "application/json": components["schemas"]["McpServerConfig"];
+                };
+            };
+            /** @description Entry not found */
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
         };
     };
-    /**
-     * Move Entry
-     * @description Moves or renames a file or directory.
-     */
-    fs_move: {
+    put_v1_config_mcp: {
         parameters: {
-            query?: {
-                /** @description Session id for relative paths */
-                session_id?: string | null;
+            query: {
+                /** @description Target directory */
+                directory: string;
+                /** @description MCP entry name */
+                mcpName: string;
             };
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["FsMoveRequest"];
+                "application/json": components["schemas"]["McpServerConfig"];
             };
         };
         responses: {
-            /** @description Move result */
-            200: {
-                content: {
-                    "application/json": components["schemas"]["FsMoveResponse"];
-                };
+            /** @description Stored */
+            204: {
+                content: never;
             };
         };
     };
-    /**
-     * Get File Info
-     * @description Returns metadata (size, timestamps, type) for a path.
-     */
-    fs_stat: {
+    delete_v1_config_mcp: {
         parameters: {
             query: {
-                /** @description Path to stat */
-                path: string;
-                /** @description Session id for relative paths */
-                session_id?: string | null;
+                /** @description Target directory */
+                directory: string;
+                /** @description MCP entry name */
+                mcpName: string;
             };
         };
         responses: {
-            /** @description File metadata */
-            200: {
-                content: {
-                    "application/json": components["schemas"]["FsStat"];
-                };
+            /** @description Deleted */
+            204: {
+                content: never;
             };
         };
     };
-    /**
-     * Upload Files
-     * @description Uploads a tar.gz archive and extracts it to the destination directory.
-     */
-    fs_upload_batch: {
+    get_v1_config_skills: {
         parameters: {
-            query?: {
-                /** @description Destination directory for extraction */
-                path?: string | null;
-                /** @description Session id for relative paths */
-                session_id?: string | null;
-            };
-        };
-        requestBody: {
-            content: {
-                "application/octet-stream": string;
-            };
-        };
-        responses: {
-            /** @description Upload result */
-            200: {
-                content: {
-                    "application/json": components["schemas"]["FsUploadBatchResponse"];
-                };
+            query: {
+                /** @description Target directory */
+                directory: string;
+                /** @description Skill entry name */
+                skillName: string;
             };
         };
-    };
-    /**
-     * Health Check
-     * @description Returns the server health status.
-     */
-    get_health: {
         responses: {
-            /** @description Server is healthy */
+            /** @description Skills entry */
             200: {
                 content: {
-                    "application/json": components["schemas"]["HealthResponse"];
+                    "application/json": components["schemas"]["SkillsConfig"];
                 };
             };
-        };
-    };
-    /**
-     * List Sessions
-     * @description Returns all active sessions.
-     */
-    list_sessions: {
-        responses: {
-            /** @description List of active sessions */
-            200: {
+            /** @description Entry not found */
+            404: {
                 content: {
-                    "application/json": components["schemas"]["SessionListResponse"];
+                    "application/json": components["schemas"]["ProblemDetails"];
                 };
             };
         };
     };
-    /**
-     * Create Session
-     * @description Creates a new agent session with the given configuration.
-     */
-    create_session: {
+    put_v1_config_skills: {
         parameters: {
-            path: {
-                /** @description Client session id */
-                session_id: string;
+            query: {
+                /** @description Target directory */
+                directory: string;
+                /** @description Skill entry name */
+                skillName: string;
             };
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CreateSessionRequest"];
+                "application/json": components["schemas"]["SkillsConfig"];
             };
         };
         responses: {
-            /** @description Session created */
-            200: {
-                content: {
-                    "application/json": components["schemas"]["CreateSessionResponse"];
-                };
+            /** @description Stored */
+            204: {
+                content: never;
             };
-            /** @description Invalid request */
-            400: {
-                content: {
-                    "application/json": components["schemas"]["ProblemDetails"];
-                };
+        };
+    };
+    delete_v1_config_skills: {
+        parameters: {
+            query: {
+                /** @description Target directory */
+                directory: string;
+                /** @description Skill entry name */
+                skillName: string;
             };
-            /** @description Session already exists */
-            409: {
-                content: {
-                    "application/json": components["schemas"]["ProblemDetails"];
-                };
+        };
+        responses: {
+            /** @description Deleted */
+            204: {
+                content: never;
             };
         };
     };
-    /**
-     * Get Events
-     * @description Returns session events with optional offset-based pagination.
-     */
-    get_events: {
+    get_v1_fs_entries: {
         parameters: {
             query?: {
-                /** @description Last seen event sequence (exclusive) */
-                offset?: number | null;
-                /** @description Max events to return */
-                limit?: number | null;
-                /** @description Include raw provider payloads */
-                include_raw?: boolean | null;
-            };
-            path: {
-                /** @description Session id */
-                session_id: string;
+                /** @description Directory path */
+                path?: string | null;
             };
         };
         responses: {
-            /** @description Session events */
+            /** @description Directory entries */
             200: {
                 content: {
-                    "application/json": components["schemas"]["EventsResponse"];
+                    "application/json": components["schemas"]["FsEntry"][];
                 };
             };
-            /** @description Session not found */
-            404: {
+        };
+    };
+    delete_v1_fs_entry: {
+        parameters: {
+            query: {
+                /** @description File or directory path */
+                path: string;
+                /** @description Delete directory recursively */
+                recursive?: boolean | null;
+            };
+        };
+        responses: {
+            /** @description Delete result */
+            200: {
                 content: {
-                    "application/json": components["schemas"]["ProblemDetails"];
+                    "application/json": components["schemas"]["FsActionResponse"];
                 };
             };
         };
     };
-    /**
-     * Subscribe to Events (SSE)
-     * @description Opens an SSE stream for real-time session events.
-     */
-    get_events_sse: {
+    get_v1_fs_file: {
         parameters: {
-            query?: {
-                /** @description Last seen event sequence (exclusive) */
-                offset?: number | null;
-                /** @description Include raw provider payloads */
-                include_raw?: boolean | null;
-            };
-            path: {
-                /** @description Session id */
-                session_id: string;
+            query: {
+                /** @description File path */
+                path: string;
             };
         };
         responses: {
-            /** @description SSE event stream */
+            /** @description File content */
             200: {
                 content: never;
             };
         };
     };
-    /**
-     * Send Message
-     * @description Sends a message to a session and returns immediately.
-     */
-    post_message: {
+    put_v1_fs_file: {
         parameters: {
-            path: {
-                /** @description Session id */
-                session_id: string;
+            query: {
+                /** @description File path */
+                path: string;
             };
         };
+        /** @description Raw file bytes */
         requestBody: {
             content: {
-                "application/json": components["schemas"]["MessageRequest"];
+                "text/plain": string;
             };
         };
         responses: {
-            /** @description Message accepted */
-            204: {
-                content: never;
-            };
-            /** @description Session not found */
-            404: {
+            /** @description Write result */
+            200: {
                 content: {
-                    "application/json": components["schemas"]["ProblemDetails"];
+                    "application/json": components["schemas"]["FsWriteResponse"];
                 };
             };
         };
     };
-    /**
-     * Send Message (Streaming)
-     * @description Sends a message and returns an SSE event stream of the agent's response.
-     */
-    post_message_stream: {
+    post_v1_fs_mkdir: {
         parameters: {
-            query?: {
-                /** @description Include raw provider payloads */
-                include_raw?: boolean | null;
-            };
-            path: {
-                /** @description Session id */
-                session_id: string;
-            };
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["MessageRequest"];
+            query: {
+                /** @description Directory path */
+                path: string;
             };
         };
         responses: {
-            /** @description SSE event stream */
+            /** @description Directory created */
             200: {
-                content: never;
-            };
-            /** @description Session not found */
-            404: {
                 content: {
-                    "application/json": components["schemas"]["ProblemDetails"];
+                    "application/json": components["schemas"]["FsActionResponse"];
                 };
             };
         };
     };
-    /**
-     * Reply to Permission
-     * @description Approves or denies a permission request from the agent.
-     */
-    reply_permission: {
-        parameters: {
-            path: {
-                /** @description Session id */
-                session_id: string;
-                /** @description Permission id */
-                permission_id: string;
-            };
-        };
+    post_v1_fs_move: {
         requestBody: {
             content: {
-                "application/json": components["schemas"]["PermissionReplyRequest"];
+                "application/json": components["schemas"]["FsMoveRequest"];
             };
         };
         responses: {
-            /** @description Permission reply accepted */
-            204: {
-                content: never;
-            };
-            /** @description Session or permission not found */
-            404: {
+            /** @description Move result */
+            200: {
                 content: {
-                    "application/json": components["schemas"]["ProblemDetails"];
+                    "application/json": components["schemas"]["FsMoveResponse"];
                 };
             };
         };
     };
-    /**
-     * Reject Question
-     * @description Rejects a human-in-the-loop question from the agent.
-     */
-    reject_question: {
+    get_v1_fs_stat: {
         parameters: {
-            path: {
-                /** @description Session id */
-                session_id: string;
-                /** @description Question id */
-                question_id: string;
+            query: {
+                /** @description Path to stat */
+                path: string;
             };
         };
         responses: {
-            /** @description Question rejected */
-            204: {
-                content: never;
-            };
-            /** @description Session or question not found */
-            404: {
+            /** @description Path metadata */
+            200: {
                 content: {
-                    "application/json": components["schemas"]["ProblemDetails"];
+                    "application/json": components["schemas"]["FsStat"];
                 };
             };
         };
     };
-    /**
-     * Reply to Question
-     * @description Replies to a human-in-the-loop question from the agent.
-     */
-    reply_question: {
+    post_v1_fs_upload_batch: {
         parameters: {
-            path: {
-                /** @description Session id */
-                session_id: string;
-                /** @description Question id */
-                question_id: string;
+            query?: {
+                /** @description Destination path */
+                path?: string | null;
             };
         };
+        /** @description tar archive body */
         requestBody: {
             content: {
-                "application/json": components["schemas"]["QuestionReplyRequest"];
+                "text/plain": string;
             };
         };
         responses: {
-            /** @description Question answered */
-            204: {
-                content: never;
-            };
-            /** @description Session or question not found */
-            404: {
+            /** @description Upload/extract result */
+            200: {
                 content: {
-                    "application/json": components["schemas"]["ProblemDetails"];
+                    "application/json": components["schemas"]["FsUploadBatchResponse"];
                 };
             };
         };
     };
-    /**
-     * Terminate Session
-     * @description Terminates a running session and cleans up resources.
-     */
-    terminate_session: {
-        parameters: {
-            path: {
-                /** @description Session id */
-                session_id: string;
-            };
-        };
+    get_v1_health: {
         responses: {
-            /** @description Session terminated */
-            204: {
-                content: never;
-            };
-            /** @description Session not found */
-            404: {
+            /** @description Service health response */
+            200: {
                 content: {
-                    "application/json": components["schemas"]["ProblemDetails"];
+                    "application/json": components["schemas"]["HealthResponse"];
                 };
             };
         };
     };
 }
 
-type S = components["schemas"];
-type AgentCapabilities = S["AgentCapabilities"];
-type AgentInfo = S["AgentInfo"];
-type AgentInstallRequest = S["AgentInstallRequest"];
-type AgentListResponse = S["AgentListResponse"];
-type AgentModelInfo = S["AgentModelInfo"];
-type AgentModelsResponse = S["AgentModelsResponse"];
-type AgentModeInfo = S["AgentModeInfo"];
-type AgentModesResponse = S["AgentModesResponse"];
-type AgentUnparsedData = S["AgentUnparsedData"];
-type ContentPart = S["ContentPart"];
-type CreateSessionRequest = S["CreateSessionRequest"];
-type CreateSessionResponse = S["CreateSessionResponse"];
-type ErrorData = S["ErrorData"];
-type EventSource = S["EventSource"];
-type EventsQuery = S["EventsQuery"];
-type EventsResponse = S["EventsResponse"];
-type FileAction = S["FileAction"];
-type FsActionResponse = S["FsActionResponse"];
-type FsDeleteQuery = S["FsDeleteQuery"];
-type FsEntriesQuery = S["FsEntriesQuery"];
-type FsEntry = S["FsEntry"];
-type FsEntryType = S["FsEntryType"];
-type FsMoveRequest = S["FsMoveRequest"];
-type FsMoveResponse = S["FsMoveResponse"];
-type FsPathQuery = S["FsPathQuery"];
-type FsSessionQuery = S["FsSessionQuery"];
-type FsStat = S["FsStat"];
-type FsUploadBatchQuery = S["FsUploadBatchQuery"];
-type FsUploadBatchResponse = S["FsUploadBatchResponse"];
-type FsWriteResponse = S["FsWriteResponse"];
-type HealthResponse = S["HealthResponse"];
-type ItemDeltaData = S["ItemDeltaData"];
-type ItemEventData = S["ItemEventData"];
-type ItemKind = S["ItemKind"];
-type ItemRole = S["ItemRole"];
-type ItemStatus = S["ItemStatus"];
-type MessageRequest = S["MessageRequest"];
-type MessageAttachment = S["MessageAttachment"];
-type PermissionEventData = S["PermissionEventData"];
-type PermissionReply = S["PermissionReply"];
-type PermissionReplyRequest = S["PermissionReplyRequest"];
-type PermissionStatus = S["PermissionStatus"];
-type ProblemDetails = S["ProblemDetails"];
-type QuestionEventData = S["QuestionEventData"];
-type QuestionReplyRequest = S["QuestionReplyRequest"];
-type QuestionStatus = S["QuestionStatus"];
-type ReasoningVisibility = S["ReasoningVisibility"];
-type SessionEndReason = S["SessionEndReason"];
-type SessionEndedData = S["SessionEndedData"];
-type SessionInfo = S["SessionInfo"];
-type SessionListResponse = S["SessionListResponse"];
-type SessionStartedData = S["SessionStartedData"];
-type TerminatedBy = S["TerminatedBy"];
-type TurnStreamQuery = S["TurnStreamQuery"];
-type UniversalEvent = S["UniversalEvent"];
-type UniversalEventData = S["UniversalEventData"];
-type UniversalEventType = S["UniversalEventType"];
-type UniversalItem = S["UniversalItem"];
-type McpServerConfig = S["McpServerConfig"];
-type McpCommand = S["McpCommand"];
-type McpRemoteTransport = S["McpRemoteTransport"];
-type McpOAuthConfig = S["McpOAuthConfig"];
-type McpOAuthConfigOrDisabled = S["McpOAuthConfigOrDisabled"];
-type SkillSource = S["SkillSource"];
-type SkillsConfig = S["SkillsConfig"];
+type ProblemDetails = components["schemas"]["ProblemDetails"];
+type HealthResponse = JsonResponse<operations["get_v1_health"], 200>;
+type AgentListResponse = JsonResponse<operations["get_v1_agents"], 200>;
+type AgentInfo = components["schemas"]["AgentInfo"];
+type AgentInstallRequest = JsonRequestBody<operations["post_v1_agent_install"]>;
+type AgentInstallResponse = JsonResponse<operations["post_v1_agent_install"], 200>;
+type AcpEnvelope = components["schemas"]["AcpEnvelope"];
+type AcpServerInfo = components["schemas"]["AcpServerInfo"];
+type AcpServerListResponse = JsonResponse<operations["get_v1_acp_servers"], 200>;
+type FsEntriesQuery = QueryParams<operations["get_v1_fs_entries"]>;
+type FsEntry = components["schemas"]["FsEntry"];
+type FsPathQuery = QueryParams<operations["get_v1_fs_file"]>;
+type FsDeleteQuery = QueryParams<operations["delete_v1_fs_entry"]>;
+type FsUploadBatchQuery = QueryParams<operations["post_v1_fs_upload_batch"]>;
+type FsWriteResponse = JsonResponse<operations["put_v1_fs_file"], 200>;
+type FsActionResponse = JsonResponse<operations["delete_v1_fs_entry"], 200>;
+type FsMoveRequest = JsonRequestBody<operations["post_v1_fs_move"]>;
+type FsMoveResponse = JsonResponse<operations["post_v1_fs_move"], 200>;
+type FsStat = JsonResponse<operations["get_v1_fs_stat"], 200>;
+type FsUploadBatchResponse = JsonResponse<operations["post_v1_fs_upload_batch"], 200>;
+type McpConfigQuery = QueryParams<operations["get_v1_config_mcp"]>;
+type McpServerConfig = components["schemas"]["McpServerConfig"];
+type SkillsConfigQuery = QueryParams<operations["get_v1_config_skills"]>;
+type SkillsConfig = components["schemas"]["SkillsConfig"];
+interface SessionRecord {
+    id: string;
+    agent: string;
+    agentSessionId: string;
+    lastConnectionId: string;
+    createdAt: number;
+    destroyedAt?: number;
+    sessionInit?: Omit<NewSessionRequest, "_meta">;
+}
+type SessionEventSender = "client" | "agent";
+interface SessionEvent {
+    id: string;
+    eventIndex: number;
+    sessionId: string;
+    createdAt: number;
+    connectionId: string;
+    sender: SessionEventSender;
+    payload: AnyMessage;
+}
+interface ListPageRequest {
+    cursor?: string;
+    limit?: number;
+}
+interface ListPage<T> {
+    items: T[];
+    nextCursor?: string;
+}
+interface ListEventsRequest extends ListPageRequest {
+    sessionId: string;
+}
+interface SessionPersistDriver {
+    getSession(id: string): Promise<SessionRecord | null>;
+    listSessions(request?: ListPageRequest): Promise<ListPage<SessionRecord>>;
+    updateSession(session: SessionRecord): Promise<void>;
+    listEvents(request: ListEventsRequest): Promise<ListPage<SessionEvent>>;
+    insertEvent(event: SessionEvent): Promise<void>;
+}
+interface InMemorySessionPersistDriverOptions {
+    maxSessions?: number;
+    maxEventsPerSession?: number;
+}
+declare class InMemorySessionPersistDriver implements SessionPersistDriver {
+    private readonly maxSessions;
+    private readonly maxEventsPerSession;
+    private readonly sessions;
+    private readonly eventsBySession;
+    constructor(options?: InMemorySessionPersistDriverOptions);
+    getSession(id: string): Promise<SessionRecord | null>;
+    listSessions(request?: ListPageRequest): Promise<ListPage<SessionRecord>>;
+    updateSession(session: SessionRecord): Promise<void>;
+    listEvents(request: ListEventsRequest): Promise<ListPage<SessionEvent>>;
+    insertEvent(event: SessionEvent): Promise<void>;
+}
+type ResponsesOf<T> = T extends {
+    responses: infer R;
+} ? R : never;
+type JsonResponse<T, StatusCode extends keyof ResponsesOf<T>> = ResponsesOf<T>[StatusCode] extends {
+    content: {
+        "application/json": infer B;
+    };
+} ? B : never;
+type JsonRequestBody<T> = T extends {
+    requestBody: {
+        content: {
+            "application/json": infer B;
+        };
+    };
+} ? B : never;
+type QueryParams<T> = T extends {
+    parameters: {
+        query: infer Q;
+    };
+} ? Q : T extends {
+    parameters: {
+        query?: infer Q;
+    };
+} ? Q : never;
 
 interface SandboxAgentConnectOptions {
     baseUrl: string;
     token?: string;
     fetch?: typeof fetch;
     headers?: HeadersInit;
+    persist?: SessionPersistDriver;
+    replayMaxEvents?: number;
+    replayMaxChars?: number;
 }
-interface SandboxAgentStartOptions {
+interface SandboxAgentStartOptions extends Omit<SandboxAgentConnectOptions, "baseUrl" | "token"> {
     spawn?: SandboxAgentSpawnOptions | boolean;
-    fetch?: typeof fetch;
-    headers?: HeadersInit;
 }
+interface SessionCreateRequest {
+    id?: string;
+    agent: string;
+    sessionInit?: Omit<NewSessionRequest, "_meta">;
+}
+interface SessionResumeOrCreateRequest {
+    id: string;
+    agent: string;
+    sessionInit?: Omit<NewSessionRequest, "_meta">;
+}
+interface SessionSendOptions {
+    notification?: boolean;
+}
+type SessionEventListener = (event: SessionEvent) => void;
 declare class SandboxAgentError extends Error {
     readonly status: number;
     readonly problem?: ProblemDetails;
     readonly response: Response;
     constructor(status: number, problem: ProblemDetails | undefined, response: Response);
 }
+declare class Session {
+    private record;
+    private readonly sandbox;
+    constructor(sandbox: SandboxAgent, record: SessionRecord);
+    get id(): string;
+    get agent(): string;
+    get agentSessionId(): string;
+    get lastConnectionId(): string;
+    get createdAt(): number;
+    get destroyedAt(): number | undefined;
+    refresh(): Promise<Session>;
+    send(method: string, params?: Record<string, unknown>, options?: SessionSendOptions): Promise<unknown>;
+    prompt(prompt: PromptRequest["prompt"]): Promise<PromptResponse>;
+    onEvent(listener: SessionEventListener): () => void;
+    toRecord(): SessionRecord;
+    apply(record: SessionRecord): void;
+}
+declare class LiveAcpConnection {
+    readonly connectionId: string;
+    readonly agent: string;
+    private readonly acp;
+    private readonly sessionByLocalId;
+    private readonly localByAgentSessionId;
+    private readonly pendingNewSessionLocals;
+    private readonly pendingRequestSessionById;
+    private readonly pendingReplayByLocalSessionId;
+    private readonly onObservedEnvelope;
+    private constructor();
+    static create(options: {
+        baseUrl: string;
+        token?: string;
+        fetcher: typeof fetch;
+        headers?: HeadersInit;
+        agent: string;
+        serverId: string;
+        onObservedEnvelope: (connection: LiveAcpConnection, envelope: AnyMessage, direction: AcpEnvelopeDirection, localSessionId: string | null) => void;
+    }): Promise<LiveAcpConnection>;
+    close(): Promise<void>;
+    hasBoundSession(localSessionId: string, agentSessionId?: string): boolean;
+    bindSession(localSessionId: string, agentSessionId: string): void;
+    queueReplay(localSessionId: string, replayText: string | null): void;
+    createRemoteSession(localSessionId: string, sessionInit: Omit<NewSessionRequest, "_meta">): Promise<NewSessionResponse>;
+    sendSessionMethod(localSessionId: string, method: string, params: Record<string, unknown>, options: SessionSendOptions): Promise<unknown>;
+    private handleEnvelope;
+    private resolveSessionId;
+    private localFromEnvelopeParams;
+}
 declare class SandboxAgent {
     private readonly baseUrl;
     private readonly token?;
     private readonly fetcher;
     private readonly defaultHeaders?;
+    private readonly persist;
+    private readonly replayMaxEvents;
+    private readonly replayMaxChars;
     private spawnHandle?;
-    private constructor();
+    private readonly liveConnections;
+    private readonly sessionHandles;
+    private readonly eventListeners;
+    private readonly nextSessionEventIndexBySession;
+    private readonly seedSessionEventIndexBySession;
+    constructor(options: SandboxAgentConnectOptions);
     static connect(options: SandboxAgentConnectOptions): Promise<SandboxAgent>;
     static start(options?: SandboxAgentStartOptions): Promise<SandboxAgent>;
-    listAgents(): Promise<AgentListResponse>;
+    dispose(): Promise<void>;
+    listSessions(request?: ListPageRequest): Promise<ListPage<Session>>;
+    getSession(id: string): Promise<Session | null>;
+    getEvents(request: ListEventsRequest): Promise<ListPage<SessionEvent>>;
+    createSession(request: SessionCreateRequest): Promise<Session>;
+    resumeSession(id: string): Promise<Session>;
+    resumeOrCreateSession(request: SessionResumeOrCreateRequest): Promise<Session>;
+    destroySession(id: string): Promise<Session>;
+    sendSessionMethod(sessionId: string, method: string, params: Record<string, unknown>, options?: SessionSendOptions): Promise<{
+        session: Session;
+        response: unknown;
+    }>;
+    onSessionEvent(sessionId: string, listener: SessionEventListener): () => void;
     getHealth(): Promise<HealthResponse>;
-    installAgent(agent: string, request?: AgentInstallRequest): Promise<void>;
-    getAgentModes(agent: string): Promise<AgentModesResponse>;
-    getAgentModels(agent: string): Promise<AgentModelsResponse>;
-    createSession(sessionId: string, request: CreateSessionRequest): Promise<CreateSessionResponse>;
-    listSessions(): Promise<SessionListResponse>;
-    postMessage(sessionId: string, request: MessageRequest): Promise<void>;
-    getEvents(sessionId: string, query?: EventsQuery): Promise<EventsResponse>;
-    getEventsSse(sessionId: string, query?: EventsQuery, signal?: AbortSignal): Promise<Response>;
-    postMessageStream(sessionId: string, request: MessageRequest, query?: TurnStreamQuery, signal?: AbortSignal): Promise<Response>;
-    streamEvents(sessionId: string, query?: EventsQuery, signal?: AbortSignal): AsyncGenerator<UniversalEvent, void, void>;
-    streamTurn(sessionId: string, request: MessageRequest, query?: TurnStreamQuery, signal?: AbortSignal): AsyncGenerator<UniversalEvent, void, void>;
-    replyQuestion(sessionId: string, questionId: string, request: QuestionReplyRequest): Promise<void>;
-    rejectQuestion(sessionId: string, questionId: string): Promise<void>;
-    replyPermission(sessionId: string, permissionId: string, request: PermissionReplyRequest): Promise<void>;
-    terminateSession(sessionId: string): Promise<void>;
+    listAgents(options?: {
+        config?: boolean;
+    }): Promise<AgentListResponse>;
+    getAgent(agent: string, options?: {
+        config?: boolean;
+    }): Promise<AgentInfo>;
+    installAgent(agent: string, request?: AgentInstallRequest): Promise<AgentInstallResponse>;
+    listAcpServers(): Promise<AcpServerListResponse>;
     listFsEntries(query?: FsEntriesQuery): Promise<FsEntry[]>;
     readFsFile(query: FsPathQuery): Promise<Uint8Array>;
     writeFsFile(query: FsPathQuery, body: BodyInit): Promise<FsWriteResponse>;
     deleteFsEntry(query: FsDeleteQuery): Promise<FsActionResponse>;
     mkdirFs(query: FsPathQuery): Promise<FsActionResponse>;
-    moveFs(request: FsMoveRequest, query?: FsSessionQuery): Promise<FsMoveResponse>;
+    moveFs(request: FsMoveRequest): Promise<FsMoveResponse>;
     statFs(query: FsPathQuery): Promise<FsStat>;
     uploadFsBatch(body: BodyInit, query?: FsUploadBatchQuery): Promise<FsUploadBatchResponse>;
-    dispose(): Promise<void>;
+    getMcpConfig(query: McpConfigQuery): Promise<McpServerConfig>;
+    setMcpConfig(query: McpConfigQuery, config: McpServerConfig): Promise<void>;
+    deleteMcpConfig(query: McpConfigQuery): Promise<void>;
+    getSkillsConfig(query: SkillsConfigQuery): Promise<SkillsConfig>;
+    setSkillsConfig(query: SkillsConfigQuery, config: SkillsConfig): Promise<void>;
+    deleteSkillsConfig(query: SkillsConfigQuery): Promise<void>;
+    private getLiveConnection;
+    private persistObservedEnvelope;
+    private allocateSessionEventIndex;
+    private ensureSessionEventIndexSeeded;
+    private findMaxPersistedSessionEventIndex;
+    private collectReplayEvents;
+    private upsertSessionHandle;
+    private requireSessionRecord;
     private requestJson;
     private requestRaw;
+    private buildHeaders;
     private buildUrl;
-    private readProblem;
-    private parseSseStream;
 }
 
 interface InspectorUrlOptions {
@@ -1349,4 +965,4 @@ interface InspectorUrlOptions {
  */
 declare function buildInspectorUrl(options: InspectorUrlOptions): string;
 
-export { type AgentCapabilities, type AgentInfo, type AgentInstallRequest, type AgentListResponse, type AgentModeInfo, type AgentModelInfo, type AgentModelsResponse, type AgentModesResponse, type AgentUnparsedData, type ContentPart, type CreateSessionRequest, type CreateSessionResponse, type ErrorData, type EventSource, type EventsQuery, type EventsResponse, type FileAction, type FsActionResponse, type FsDeleteQuery, type FsEntriesQuery, type FsEntry, type FsEntryType, type FsMoveRequest, type FsMoveResponse, type FsPathQuery, type FsSessionQuery, type FsStat, type FsUploadBatchQuery, type FsUploadBatchResponse, type FsWriteResponse, type HealthResponse, type InspectorUrlOptions, type ItemDeltaData, type ItemEventData, type ItemKind, type ItemRole, type ItemStatus, type McpCommand, type McpOAuthConfig, type McpOAuthConfigOrDisabled, type McpRemoteTransport, type McpServerConfig, type MessageAttachment, type MessageRequest, type PermissionEventData, type PermissionReply, type PermissionReplyRequest, type PermissionStatus, type ProblemDetails, type QuestionEventData, type QuestionReplyRequest, type QuestionStatus, type ReasoningVisibility, SandboxAgent, type SandboxAgentConnectOptions, SandboxAgentError, type SandboxAgentSpawnLogMode, type SandboxAgentSpawnOptions, type SandboxAgentStartOptions, type SessionEndReason, type SessionEndedData, type SessionInfo, type SessionListResponse, type SessionStartedData, type SkillSource, type SkillsConfig, type TerminatedBy, type TurnStreamQuery, type UniversalEvent, type UniversalEventData, type UniversalEventType, type UniversalItem, buildInspectorUrl, type components, type paths };
+export { type AcpEnvelope, type AcpServerInfo, type AcpServerListResponse, type AgentInfo, type AgentInstallRequest, type AgentInstallResponse, type AgentListResponse, 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 ProblemDetails, SandboxAgent, type SandboxAgentConnectOptions, SandboxAgentError, type SandboxAgentSpawnLogMode, type SandboxAgentSpawnOptions, type SandboxAgentStartOptions, Session, type SessionCreateRequest, type SessionEvent, type SessionEventListener, type SessionPersistDriver, type SessionRecord, type SessionResumeOrCreateRequest, type SessionSendOptions, type SkillsConfig, type SkillsConfigQuery, buildInspectorUrl };