@remotehost/sdk 0.1.1 → 0.3.0

package/dist/generated/schema.d.ts

@@ -423,6 +423,307 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/sandboxes/{sandboxId}/files/snapshot": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read a directory tree
+         * @description Returns directory entries grouped by parent path. This is a filesystem listing, not a persistent sandbox backup. Requires a running Firecracker sandbox and sandbox.files.read.
+         */
+        get: operations["snapshotSandboxFiles"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/me": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Read the authenticated caller's identity */
+        get: operations["getCurrentUser"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/orgs/{orgId}/usage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read machine-hour usage for the current billing period
+         * @description Requires billing.read. Optional filters attribute usage to a project or your own end user.
+         */
+        get: operations["getOrgUsage"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/orgs/{orgId}/usage/end-users": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read usage grouped by your end users
+         * @description Requires billing.read. Unattributed usage is excluded. Results are ordered by machine hours descending.
+         */
+        get: operations["getOrgUsageByEndUser"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/orgs/{orgId}/api-keys": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List API key metadata
+         * @description Requires a user session with api_keys.manage. API keys cannot call this operation. Secret tokens are never returned.
+         */
+        get: operations["listApiKeys"];
+        put?: never;
+        /**
+         * Mint an organization-bound API key
+         * @description Requires a user session with api_keys.manage. API keys cannot mint keys. Scopes narrow the creator's permissions; omitted or null means unscoped, while [] grants no permissions. Store the returned token securely: it is shown only once.
+         */
+        post: operations["createApiKey"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/orgs/{orgId}/api-keys/{keyId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Revoke an API key
+         * @description Requires a user session with api_keys.manage. API keys cannot call this operation.
+         */
+        delete: operations["revokeApiKey"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/me/agent-tokens": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["listAgentAccessTokens"];
+        put?: never;
+        /** @description User sign-in required. Explicit delegation across accessible organizations; does not alter organization API keys. sandbox.create permits waking existing sandboxes only. Token returned once. */
+        post: operations["createAgentAccessToken"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/me/agent-tokens/{tokenId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete: operations["revokeAgentAccessToken"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/agent-sessions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Discover registered sessions across accessible projects. Organization API keys retain their org limit; personal agent tokens span accessible orgs. New Codex terminals are registered; existing standalone and native Claude sessions are not attached. State is last known; read a session to refresh it. Pages are ordered by stable session ID, not activity. */
+        get: operations["discoverAgentSessions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/sandboxes/{sandboxId}/agent-sessions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Start a separate managed conversation using this running sandbox's configured agent. Does not attach to its native terminal conversation. Requires agent_session.send. */
+        post: operations["createAgentSession"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/projects/{projectId}/agent-sessions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["listAgentSessions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/agent-sessions/{sessionId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["getAgentSession"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/agent-sessions/{sessionId}/output": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["getAgentOutput"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/agent-sessions/{sessionId}/messages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["sendAgentMessage"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/agent-sessions/{sessionId}/answer": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["answerAgentPrompt"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/agent-sessions/{sessionId}/interrupt": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["interruptAgentTurn"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/agent-sessions/{sessionId}/recover": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Resume a saved managed Claude or Codex conversation, or a registered native Codex session. Requires agent_session.send and the original running sandbox with saved history. Already-ready sessions are unchanged; known live previous processes prevent restart. Queued work is never replayed; interrupted turns have uncertain prior effects. Native Claude attachment is not supported. */
+        post: operations["recoverAgentSession"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -721,14 +1022,99 @@ export interface components {
             } | null;
             memoryWarning: components["schemas"]["MemoryPressureWarning"];
         };
-    };
-    responses: never;
-    parameters: never;
-    requestBodies: never;
-    headers: never;
-    pathItems: never;
-}
-export type $defs = Record<string, never>;
+        Usage: {
+            /** @enum {string} */
+            plan: "individual" | "pro" | "max" | "team" | "enterprise";
+            projectId: string | null;
+            endUserId: string | null;
+            periodStartsAt: string;
+            periodEndsAt: string | null;
+            includedMachineHours: number | null;
+            sandboxMachineHourLimit: number | null;
+            sandboxMachineHourLimitOverride: number | null;
+            projectSandboxMachineHourLimit: number | null;
+            sandboxOverageEnabled: boolean;
+            usedMachineHours: number;
+            remainingMachineHours: number | null;
+            overageMachineHours: number;
+            overageCostUsd: number | null;
+            usageAlert: {
+                percentUsed: number | null;
+                /** @enum {string} */
+                status: "uncapped" | "normal" | "approaching" | "critical" | "exhausted";
+                message: string;
+            };
+        };
+        ApiKey: {
+            id: string;
+            org_id: string;
+            name: string;
+            key_prefix: string;
+            last_used_at: string | null;
+            created_at: string;
+            revoked_at: string | null;
+            expires_at: string | null;
+            scopes: string[] | null;
+        };
+        AgentSessionCommunication: {
+            /** @enum {string} */
+            status: "ready" | "starting" | "restart_required" | "setup_required" | "unavailable" | "unsupported";
+            capabilities: ("messages" | "output" | "approvals" | "interrupt" | "recover")[];
+            message: string | null;
+            requirements: {
+                code: string;
+                /** @enum {string} */
+                action: "restart" | "setup";
+                message: string;
+            }[];
+        };
+        AgentSessionState: {
+            id: string;
+            sessionId: string;
+            projectId: string;
+            sandboxId: string | null;
+            agent: string;
+            agentLabel: string;
+            communication: components["schemas"]["AgentSessionCommunication"];
+            requirements: {
+                code: string;
+                /** @enum {string} */
+                action: "restart" | "setup";
+                message: string;
+            }[];
+            /** @enum {string} */
+            surface: "terminal" | "managed";
+            /** @enum {string} */
+            status: "active" | "closed";
+            turnId: string | null;
+            /** @enum {string|null} */
+            turnState: "submitted" | "working" | "input-required" | "completed" | "failed" | "canceled" | null;
+            needsYou: boolean;
+            waitingOn: string | null;
+            pendingInput: {
+                requestId: string | number;
+                kind: string;
+                summary: string;
+            } | null;
+            error: string | null;
+            /** @enum {string|null} */
+            bridgeState: "starting" | "ready" | "closed" | null;
+            bridgeEventSeq: number | null;
+            drifted: boolean;
+            problems: {
+                seq: number;
+                event: string;
+                reason: string;
+            }[];
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
 export interface operations {
     listMyOrgs: {
         parameters: {
@@ -4213,5 +4599,2018 @@ export interface operations {
             };
         };
     };
+    snapshotSandboxFiles: {
+        parameters: {
+            query?: {
+                path?: string;
+                depth?: number;
+            };
+            header?: never;
+            path: {
+                sandboxId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Directory tree. Large trees may be truncated. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        path: string;
+                        truncated: boolean;
+                        directories: {
+                            [key: string]: components["schemas"]["FilesystemEntry"][];
+                        };
+                    };
+                };
+            };
+            /** @description Invalid path, provider, or sandbox state. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            /** @enum {string} */
+                            code?: "rate_limited" | "limit_reached" | "plan_required" | "snapshot_in_progress";
+                            limit?: number;
+                            /** @enum {string} */
+                            window?: "minute" | "hour" | "day";
+                            retryAfterSeconds?: number;
+                            resetsAt?: string;
+                            active?: number;
+                            includedLimit?: number | null;
+                            planMaximum?: number | null;
+                            profile?: string;
+                            minimumPlan?: string | null;
+                        };
+                    };
+                };
+            };
+            /** @description Permission sandbox.files.read is required. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            /** @enum {string} */
+                            code?: "rate_limited" | "limit_reached" | "plan_required" | "snapshot_in_progress";
+                            limit?: number;
+                            /** @enum {string} */
+                            window?: "minute" | "hour" | "day";
+                            retryAfterSeconds?: number;
+                            resetsAt?: string;
+                            active?: number;
+                            includedLimit?: number | null;
+                            planMaximum?: number | null;
+                            profile?: string;
+                            minimumPlan?: string | null;
+                        };
+                    };
+                };
+            };
+            /** @description Sandbox not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            /** @enum {string} */
+                            code?: "rate_limited" | "limit_reached" | "plan_required" | "snapshot_in_progress";
+                            limit?: number;
+                            /** @enum {string} */
+                            window?: "minute" | "hour" | "day";
+                            retryAfterSeconds?: number;
+                            resetsAt?: string;
+                            active?: number;
+                            includedLimit?: number | null;
+                            planMaximum?: number | null;
+                            profile?: string;
+                            minimumPlan?: string | null;
+                        };
+                    };
+                };
+            };
+            /** @description Filesystem operation failed. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            /** @enum {string} */
+                            code?: "rate_limited" | "limit_reached" | "plan_required" | "snapshot_in_progress";
+                            limit?: number;
+                            /** @enum {string} */
+                            window?: "minute" | "hour" | "day";
+                            retryAfterSeconds?: number;
+                            resetsAt?: string;
+                            active?: number;
+                            includedLimit?: number | null;
+                            planMaximum?: number | null;
+                            profile?: string;
+                            minimumPlan?: string | null;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    getCurrentUser: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description For an API key, the identity of its creator. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        id: string;
+                        email: string | null;
+                        displayName: string | null;
+                    };
+                };
+            };
+        };
+    };
+    getOrgUsage: {
+        parameters: {
+            query?: {
+                projectId?: string;
+                endUserId?: string;
+            };
+            header?: never;
+            path: {
+                orgId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Usage, caps, overage and alert state. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Usage"];
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            402: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    getOrgUsageByEndUser: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Current billing period and attributed usage. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        periodStartsAt: string;
+                        periodEndsAt: string | null;
+                        endUsers: {
+                            endUserId: string;
+                            machineHours: number;
+                            estimatedCogsUsd: number;
+                        }[];
+                    };
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            402: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    listApiKeys: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Keys, including expired and revoked keys, newest first. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        apiKeys: components["schemas"]["ApiKey"][];
+                    };
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    createApiKey: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    name: string;
+                    expiresInDays?: number | null;
+                    scopes?: string[] | null;
+                };
+            };
+        };
+        responses: {
+            /** @description Created key and its one-time secret token. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        apiKey: components["schemas"]["ApiKey"];
+                        token: string;
+                    };
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    revokeApiKey: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgId: string;
+                keyId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Key revoked. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        ok: boolean;
+                    };
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @description The request failed. Inspect error.message. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    listAgentAccessTokens: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The signed-in user's tokens. No token hashes or secrets. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        tokens: {
+                            /** Format: uuid */
+                            id: string;
+                            name: string;
+                            token_prefix: string;
+                            scopes: ("agent_session.read" | "agent_session.send" | "agent_session.approve" | "sandbox.create")[];
+                            created_at: string;
+                            expires_at: string;
+                            revoked_at: string | null;
+                        }[];
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    createAgentAccessToken: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    name: string;
+                    scopes: ("agent_session.read" | "agent_session.send" | "agent_session.approve" | "sandbox.create")[];
+                    expiresInDays?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description Personal token created. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        agentToken: {
+                            /** Format: uuid */
+                            id: string;
+                            name: string;
+                            token_prefix: string;
+                            scopes: ("agent_session.read" | "agent_session.send" | "agent_session.approve" | "sandbox.create")[];
+                            created_at: string;
+                            expires_at: string;
+                            revoked_at: string | null;
+                        };
+                        token: string;
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    revokeAgentAccessToken: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                tokenId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Revoked. User sign-in required. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        revoked: boolean;
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    discoverAgentSessions: {
+        parameters: {
+            query?: {
+                orgId?: string;
+                projectId?: string;
+                sandboxId?: string;
+                after?: string;
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Permission-filtered page. Follow nextCursor with after while hasMore is true. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        sessions: {
+                            id: string;
+                            org_id: string;
+                            project_id: string;
+                            sandbox_id: string | null;
+                            agent: string;
+                            agent_label: string;
+                            /** @enum {string} */
+                            status: "active" | "closed";
+                            last_activity_at: string;
+                            /** @enum {string} */
+                            surface: "terminal" | "managed";
+                            sandbox_status: string | null;
+                            turn_id: string | null;
+                            /** @enum {string|null} */
+                            turn_state: "submitted" | "working" | "input-required" | "completed" | "failed" | "canceled" | null;
+                            needs_you: boolean;
+                            permissions: ("agent_session.read" | "agent_session.send" | "agent_session.approve")[];
+                        }[];
+                        nextCursor: string | null;
+                        hasMore: boolean;
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    createAgentSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                sandboxId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Bridge ready. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AgentSessionState"];
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    listAgentSessions: {
+        parameters: {
+            query: {
+                orgId: string;
+            };
+            header?: never;
+            path: {
+                projectId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Most recent session index records. Read a session for reconciled turn state. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        sessions: ({
+                            id: string;
+                            org_id: string;
+                            project_id: string;
+                            sandbox_id: string | null;
+                            agent: string;
+                            agent_label: string;
+                            /** @enum {string} */
+                            status: "active" | "closed";
+                            vendor_session_id: string | null;
+                            last_activity_at: string;
+                        } & {
+                            [key: string]: unknown;
+                        })[];
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    getAgentSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Reconciled state, including the most recent completed turn or pending approval. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AgentSessionState"];
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    getAgentOutput: {
+        parameters: {
+            query?: {
+                after?: number | null;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Replies read in the guest; each reader keeps its own nextCursor. Unavailable while asleep. Pages contain at most 128 Ki UTF-16 code units of text; a larger individual reply is explicitly marked truncated. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        messages: {
+                            seq: number;
+                            turnId: string | null;
+                            at: string;
+                            text: string;
+                            truncated: boolean;
+                        }[];
+                        nextCursor: number;
+                        hasMore: boolean;
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    sendAgentMessage: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    text: string;
+                    /** @description Reuse the same key and text to retry without creating another turn. */
+                    requestKey?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Turn reserved and command enqueued. Poll getAgentSession and read replies with getAgentOutput. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        turnId: string;
+                        /** @enum {string} */
+                        state: "submitted" | "working" | "input-required" | "completed" | "failed" | "canceled";
+                        replayed?: boolean;
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    answerAgentPrompt: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    requestId: string | number;
+                    /** @enum {string} */
+                    decision: "accept" | "decline" | "cancel";
+                };
+            };
+        };
+        responses: {
+            /** @description Decision enqueued for this exact prompt. Requires agent_session.approve. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        accepted: boolean;
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    interruptAgentTurn: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Interrupt requested. Requires agent_session.send. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        accepted: boolean;
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    recoverAgentSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Saved conversation resumed. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AgentSessionState"];
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+            /** @description The operation could not be completed; inspect error.message and error.code. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            message: string;
+                            code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
+                        };
+                    };
+                };
+            };
+        };
+    };
 }
 //# sourceMappingURL=schema.d.ts.map