sandbox-agent 0.0.1 → 0.1.0-test.5

package/dist/index.d.ts

@@ -0,0 +1,725 @@
+type SandboxAgentSpawnLogMode = "inherit" | "pipe" | "silent";
+type SandboxAgentSpawnOptions = {
+    enabled?: boolean;
+    host?: string;
+    port?: number;
+    token?: string;
+    binaryPath?: string;
+    timeoutMs?: number;
+    log?: SandboxAgentSpawnLogMode;
+    env?: Record<string, string>;
+};
+
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+interface paths {
+    "/v1/agents": {
+        get: operations["list_agents"];
+    };
+    "/v1/agents/{agent}/install": {
+        post: operations["install_agent"];
+    };
+    "/v1/agents/{agent}/modes": {
+        get: operations["get_agent_modes"];
+    };
+    "/v1/health": {
+        get: operations["get_health"];
+    };
+    "/v1/sessions": {
+        get: operations["list_sessions"];
+    };
+    "/v1/sessions/{session_id}": {
+        post: operations["create_session"];
+    };
+    "/v1/sessions/{session_id}/events": {
+        get: operations["get_events"];
+    };
+    "/v1/sessions/{session_id}/events/sse": {
+        get: operations["get_events_sse"];
+    };
+    "/v1/sessions/{session_id}/messages": {
+        post: operations["post_message"];
+    };
+    "/v1/sessions/{session_id}/messages/stream": {
+        post: operations["post_message_stream"];
+    };
+    "/v1/sessions/{session_id}/permissions/{permission_id}/reply": {
+        post: operations["reply_permission"];
+    };
+    "/v1/sessions/{session_id}/questions/{question_id}/reject": {
+        post: operations["reject_question"];
+    };
+    "/v1/sessions/{session_id}/questions/{question_id}/reply": {
+        post: operations["reply_question"];
+    };
+    "/v1/sessions/{session_id}/terminate": {
+        post: operations["terminate_session"];
+    };
+}
+interface components {
+    schemas: {
+        AgentCapabilities: {
+            commandExecution: boolean;
+            errorEvents: boolean;
+            fileAttachments: boolean;
+            fileChanges: boolean;
+            images: boolean;
+            itemStarted: boolean;
+            mcpTools: boolean;
+            permissions: boolean;
+            planMode: boolean;
+            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;
+            textMessages: boolean;
+            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"];
+            id: string;
+            installed: boolean;
+            path?: string | null;
+            serverStatus?: components["schemas"]["ServerStatusInfo"] | null;
+            version?: string | null;
+        };
+        AgentInstallRequest: {
+            reinstall?: boolean | null;
+        };
+        AgentListResponse: {
+            agents: components["schemas"]["AgentInfo"][];
+        };
+        AgentModeInfo: {
+            description: string;
+            id: string;
+            name: string;
+        };
+        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;
+            model?: string | null;
+            permissionMode?: 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";
+        HealthResponse: {
+            status: string;
+        };
+        ItemDeltaData: {
+            delta: string;
+            item_id: string;
+            native_item_id?: string | null;
+        };
+        ItemEventData: {
+            item: components["schemas"]["UniversalItem"];
+        };
+        /** @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";
+        MessageRequest: {
+            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" | "approved" | "denied";
+        ProblemDetails: {
+            detail?: string | null;
+            instance?: string | null;
+            /** Format: int32 */
+            status: number;
+            title: string;
+            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";
+        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: {
+            reason: components["schemas"]["SessionEndReason"];
+            terminated_by: components["schemas"]["TerminatedBy"];
+        };
+        SessionInfo: {
+            agent: string;
+            agentMode: string;
+            ended: boolean;
+            /** Format: int64 */
+            eventCount: number;
+            model?: string | null;
+            nativeSessionId?: string | null;
+            permissionMode: string;
+            sessionId: string;
+            variant?: string | null;
+        };
+        SessionListResponse: {
+            sessions: components["schemas"]["SessionInfo"][];
+        };
+        SessionStartedData: {
+            metadata?: unknown;
+        };
+        /** @enum {string} */
+        TerminatedBy: "agent" | "daemon";
+        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"]["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" | "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"];
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+interface operations {
+    list_agents: {
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["AgentListResponse"];
+                };
+            };
+        };
+    };
+    install_agent: {
+        parameters: {
+            path: {
+                /** @description Agent id */
+                agent: string;
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AgentInstallRequest"];
+            };
+        };
+        responses: {
+            /** @description Agent installed */
+            204: {
+                content: never;
+            };
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            500: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    get_agent_modes: {
+        parameters: {
+            path: {
+                /** @description Agent id */
+                agent: string;
+            };
+        };
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["AgentModesResponse"];
+                };
+            };
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    get_health: {
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["HealthResponse"];
+                };
+            };
+        };
+    };
+    list_sessions: {
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["SessionListResponse"];
+                };
+            };
+        };
+    };
+    create_session: {
+        parameters: {
+            path: {
+                /** @description Client session id */
+                session_id: string;
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateSessionRequest"];
+            };
+        };
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["CreateSessionResponse"];
+                };
+            };
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    get_events: {
+        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;
+            };
+        };
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["EventsResponse"];
+                };
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    get_events_sse: {
+        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;
+            };
+        };
+        responses: {
+            /** @description SSE event stream */
+            200: {
+                content: never;
+            };
+        };
+    };
+    post_message: {
+        parameters: {
+            path: {
+                /** @description Session id */
+                session_id: string;
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["MessageRequest"];
+            };
+        };
+        responses: {
+            /** @description Message accepted */
+            204: {
+                content: never;
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    post_message_stream: {
+        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"];
+            };
+        };
+        responses: {
+            /** @description SSE event stream */
+            200: {
+                content: never;
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    reply_permission: {
+        parameters: {
+            path: {
+                /** @description Session id */
+                session_id: string;
+                /** @description Permission id */
+                permission_id: string;
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PermissionReplyRequest"];
+            };
+        };
+        responses: {
+            /** @description Permission reply accepted */
+            204: {
+                content: never;
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    reject_question: {
+        parameters: {
+            path: {
+                /** @description Session id */
+                session_id: string;
+                /** @description Question id */
+                question_id: string;
+            };
+        };
+        responses: {
+            /** @description Question rejected */
+            204: {
+                content: never;
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    reply_question: {
+        parameters: {
+            path: {
+                /** @description Session id */
+                session_id: string;
+                /** @description Question id */
+                question_id: string;
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["QuestionReplyRequest"];
+            };
+        };
+        responses: {
+            /** @description Question answered */
+            204: {
+                content: never;
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+    terminate_session: {
+        parameters: {
+            path: {
+                /** @description Session id */
+                session_id: string;
+            };
+        };
+        responses: {
+            /** @description Session terminated */
+            204: {
+                content: never;
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ProblemDetails"];
+                };
+            };
+        };
+    };
+}
+
+type S = components["schemas"];
+type AgentCapabilities = S["AgentCapabilities"];
+type AgentInfo = S["AgentInfo"];
+type AgentInstallRequest = S["AgentInstallRequest"];
+type AgentListResponse = S["AgentListResponse"];
+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 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 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"];
+
+interface SandboxAgentConnectOptions {
+    baseUrl: string;
+    token?: string;
+    fetch?: typeof fetch;
+    headers?: HeadersInit;
+}
+interface SandboxAgentStartOptions {
+    spawn?: SandboxAgentSpawnOptions | boolean;
+    fetch?: typeof fetch;
+    headers?: HeadersInit;
+}
+declare class SandboxAgentError extends Error {
+    readonly status: number;
+    readonly problem?: ProblemDetails;
+    readonly response: Response;
+    constructor(status: number, problem: ProblemDetails | undefined, response: Response);
+}
+declare class SandboxAgent {
+    private readonly baseUrl;
+    private readonly token?;
+    private readonly fetcher;
+    private readonly defaultHeaders?;
+    private spawnHandle?;
+    private constructor();
+    static connect(options: SandboxAgentConnectOptions): Promise<SandboxAgent>;
+    static start(options?: SandboxAgentStartOptions): Promise<SandboxAgent>;
+    listAgents(): Promise<AgentListResponse>;
+    getHealth(): Promise<HealthResponse>;
+    installAgent(agent: string, request?: AgentInstallRequest): Promise<void>;
+    getAgentModes(agent: string): Promise<AgentModesResponse>;
+    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>;
+    dispose(): Promise<void>;
+    private requestJson;
+    private requestRaw;
+    private buildUrl;
+    private readProblem;
+    private parseSseStream;
+}
+
+export { type AgentCapabilities, type AgentInfo, type AgentInstallRequest, type AgentListResponse, type AgentModeInfo, type AgentModesResponse, type AgentUnparsedData, type ContentPart, type CreateSessionRequest, type CreateSessionResponse, type ErrorData, type EventSource, type EventsQuery, type EventsResponse, type FileAction, type HealthResponse, type ItemDeltaData, type ItemEventData, type ItemKind, type ItemRole, type ItemStatus, 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 TerminatedBy, type TurnStreamQuery, type UniversalEvent, type UniversalEventData, type UniversalEventType, type UniversalItem, type components, type paths };