@remotehost/sdk 0.3.0 → 0.5.0

package/dist/generated/schema.d.ts

@@ -10,6 +10,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /** List your organizations */
         get: operations["listMyOrgs"];
         put?: never;
         post?: never;
@@ -26,8 +27,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /** List projects */
         get: operations["listOrgProjects"];
         put?: never;
+        /** Create a project */
         post: operations["createProject"];
         delete?: never;
         options?: never;
@@ -48,6 +51,7 @@ export interface paths {
         delete?: never;
         options?: never;
         head?: never;
+        /** Update a project */
         patch: operations["updateProject"];
         trace?: never;
     };
@@ -58,6 +62,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /** List a project's repositories */
         get: operations["listProjectRepos"];
         put?: never;
         post?: never;
@@ -74,6 +79,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /** List a project's MCP connections */
         get: operations["listProjectMcpConnections"];
         put?: never;
         post?: never;
@@ -90,6 +96,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /** List a project's skill connections */
         get: operations["listProjectSkillConnections"];
         put?: never;
         post?: never;
@@ -106,6 +113,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /** List project members */
         get: operations["listProjectMembers"];
         put?: never;
         post?: never;
@@ -122,6 +130,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /** Read an organization's subscription */
         get: operations["getOrgSubscription"];
         put?: never;
         post?: never;
@@ -138,8 +147,16 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /**
+         * List sandboxes
+         * @description Newest first. Deleted sandboxes are excluded.
+         */
         get: operations["listOrgSandboxes"];
         put?: never;
+        /**
+         * Create a sandbox
+         * @description `agent` (`claude` or `codex`) and `projectId` are required; every other field falls back to the project's defaults, the selected profile, or a server-generated value. `profile` picks a workload shape (`auto`, `agent-small`, `agent-standard`, `build-heavy`, `browser-heavy`, `repo-large` or `long-running`), and `machineSize` overrides its initial machine tier. `region` picks where it runs; an unavailable region is refused rather than replaced. Infrastructure tier comes from the org's plan. `endUserId` and `metadata` attribute the sandbox to one of your own users. The sandbox is returned while it is still provisioning; poll GET /sandboxes/{sandboxId} until it is ready.
+         */
         post: operations["createSandbox"];
         delete?: never;
         options?: never;
@@ -156,6 +173,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        /**
+         * Put a sandbox to sleep
+         * @description Snapshots the sandbox, releases its machine and ends machine-time billing. A sleeping sandbox reports status `stopped` and keeps everything for wake. An ephemeral sandbox has no snapshot to keep, so sleeping ends it.
+         */
         post: operations["sleepSandbox"];
         delete?: never;
         options?: never;
@@ -173,6 +194,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
+         * Stop a sandbox
          * @deprecated
          * @description Deprecated: use POST /sandboxes/{sandboxId}/sleep.
          */
@@ -192,6 +214,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        /**
+         * Destroy a sandbox
+         * @description Permanently deletes the sandbox and its retained snapshot. Sleep it instead if you intend to come back to it.
+         */
         post: operations["destroySandbox"];
         delete?: never;
         options?: never;
@@ -208,6 +234,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        /**
+         * Renew an ephemeral sandbox
+         * @description Extends a running ephemeral sandbox's expiry by its configured TTL. The plan's session cap still applies; once it is exhausted the sandbox can no longer be renewed.
+         */
         post: operations["renewSandbox"];
         delete?: never;
         options?: never;
@@ -224,6 +254,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        /**
+         * Resize a sandbox
+         * @description Sets an exact allocation. A sleeping sandbox's allocation changes immediately. A running sandbox is resized live only when the provider can verify the change; otherwise the shape is stored as `pendingAllocation` and applied on the next wake.
+         */
         post: operations["resizeSandbox"];
         delete?: never;
         options?: never;
@@ -240,6 +274,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        /**
+         * Wake a sleeping sandbox
+         * @description Boots a sleeping sandbox from its own snapshot.
+         */
         post: operations["wakeSandbox"];
         delete?: never;
         options?: never;
@@ -257,6 +295,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
+         * Resume a sandbox
          * @deprecated
          * @description Deprecated: use POST /sandboxes/{sandboxId}/wake.
          */
@@ -274,7 +313,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Retrieve a sandbox */
+        /**
+         * Retrieve a sandbox
+         * @description Poll this to follow provisioning and lifecycle changes. The platform does not send lifecycle webhooks.
+         */
         get: operations["getSandbox"];
         put?: never;
         post?: never;
@@ -295,7 +337,7 @@ export interface paths {
         put?: never;
         /**
          * Run a command in a sandbox
-         * @description Runs a non-interactive command to completion. Standard output and error are each capped at 64 KiB; the tail is kept when either is truncated. The default timeout is 120 seconds.
+         * @description Runs a non-interactive command through /bin/sh in /code and waits for it to exit. The sandbox must be running or ready. Standard output and error are each capped at 64 KiB; the tail is kept when either is truncated. The default timeout is 120 seconds. A non-zero exitCode is still a successful request: the command ran and failed. A command that hits the timeout returns timedOut true and exitCode 124.
          */
         post: operations["execSandboxCommand"];
         delete?: never;
@@ -331,7 +373,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Read a sandbox file */
+        /**
+         * Read a sandbox file
+         * @description Returns the content as UTF-8, or as base64 for binary files, with its size in bytes. Relative paths resolve beneath /code.
+         */
         get: operations["readSandboxFile"];
         /**
          * Write a sandbox file
@@ -360,7 +405,7 @@ export interface paths {
         put?: never;
         /**
          * Create a sandbox preview
-         * @description A team preview (the default) is a signed URL for signed-in organization members. A public preview is a persistent, revocable link with its own expiry; it requires sandbox.preview.share.
+         * @description A team preview (the default) is a signed URL for signed-in organization members. A public preview is a persistent, revocable link that anyone holding the URL can open; it requires sandbox.preview.share and expires after expiresInSeconds (24 hours by default, 30 days at most).
          */
         post: operations["createSandboxPreview"];
         delete?: never;
@@ -544,6 +589,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/agent-sessions/{sessionId}/release": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Release a session to its native terminal
+         * @description Release an idle managed session to its native terminal without deleting its saved conversation. Requires agent_session.send and bridge v8. Refuses active turns; interrupt first. Returns resume arguments only after the bridge and agent processes exit. Retry on an uncertain response; repeated release is safe. Close manual CLI ownership before using recover to restore remote control. Native terminal surfaces are unsupported.
+         */
+        post: operations["releaseAgentSession"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/me/agent-tokens": {
         parameters: {
             query?: never;
@@ -551,9 +616,13 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /** List personal agent tokens */
         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. */
+        /**
+         * Create a personal agent token
+         * @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;
@@ -571,6 +640,7 @@ export interface paths {
         get?: never;
         put?: never;
         post?: never;
+        /** Revoke a personal agent token */
         delete: operations["revokeAgentAccessToken"];
         options?: never;
         head?: never;
@@ -584,7 +654,10 @@ export interface paths {
             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. */
+        /**
+         * Discover agent sessions
+         * @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;
@@ -603,7 +676,10 @@ export interface paths {
         };
         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. */
+        /**
+         * Start an agent session
+         * @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;
@@ -618,6 +694,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /** List a project's agent sessions */
         get: operations["listAgentSessions"];
         put?: never;
         post?: never;
@@ -634,6 +711,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /** Retrieve an agent session */
         get: operations["getAgentSession"];
         put?: never;
         post?: never;
@@ -650,6 +728,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /** Read agent replies */
         get: operations["getAgentOutput"];
         put?: never;
         post?: never;
@@ -659,6 +738,57 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/agent-sessions/{sessionId}/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Stream agent session events */
+        get: operations["streamAgentSessionEvents"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/agent-sessions/{sessionId}/transcript": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Read an agent session's conversation */
+        get: operations["getAgentTranscript"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/agent-sessions/{sessionId}/wait": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Wait for an agent session to change */
+        get: operations["waitForAgentSession"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/agent-sessions/{sessionId}/messages": {
         parameters: {
             query?: never;
@@ -668,6 +798,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        /** Send a message to an agent */
         post: operations["sendAgentMessage"];
         delete?: never;
         options?: never;
@@ -684,6 +815,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        /** Answer an agent's prompt */
         post: operations["answerAgentPrompt"];
         delete?: never;
         options?: never;
@@ -700,6 +832,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        /** Interrupt the current turn */
         post: operations["interruptAgentTurn"];
         delete?: never;
         options?: never;
@@ -716,7 +849,10 @@ export interface paths {
         };
         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. */
+        /**
+         * Recover an agent session
+         * @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;
@@ -870,6 +1006,7 @@ export interface components {
             allocated_memory_gb: number;
             allocated_disk_gb: number;
             end_user_id: string | null;
+            vm_lost_at: string | null;
             created_at: string;
             updated_at: string;
         };
@@ -1059,7 +1196,7 @@ export interface components {
         AgentSessionCommunication: {
             /** @enum {string} */
             status: "ready" | "starting" | "restart_required" | "setup_required" | "unavailable" | "unsupported";
-            capabilities: ("messages" | "output" | "approvals" | "interrupt" | "recover")[];
+            capabilities: ("messages" | "output" | "approvals" | "interrupt" | "recover" | "release")[];
             message: string | null;
             requirements: {
                 code: string;
@@ -1099,6 +1236,8 @@ export interface components {
             error: string | null;
             /** @enum {string|null} */
             bridgeState: "starting" | "ready" | "closed" | null;
+            released: boolean;
+            releasing: boolean;
             bridgeEventSeq: number | null;
             drifted: boolean;
             problems: {
@@ -2983,7 +3122,9 @@ export interface operations {
     };
     wakeSandbox: {
         parameters: {
-            query?: never;
+            query?: {
+                acknowledgeLostState?: "true" | "false";
+            };
             header?: never;
             path: {
                 sandboxId: string;
@@ -3182,7 +3323,9 @@ export interface operations {
     };
     resumeSandbox: {
         parameters: {
-            query?: never;
+            query?: {
+                acknowledgeLostState?: "true" | "false";
+            };
             header?: never;
             path: {
                 sandboxId: string;
@@ -5086,6 +5229,130 @@ export interface operations {
             };
         };
     };
+    releaseAgentSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Control released; resume in the same sandbox using the returned command, arguments and directory. Resume is null if no vendor conversation exists yet. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AgentSessionState"] & {
+                        resume: {
+                            command: string;
+                            args: string[];
+                            cwd: 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"];
+                        };
+                    };
+                };
+            };
+        };
+    };
     listAgentAccessTokens: {
         parameters: {
             query?: never;
@@ -6115,6 +6382,475 @@ export interface operations {
             };
         };
     };
+    streamAgentSessionEvents: {
+        parameters: {
+            query?: {
+                /** @description Output cursor to resume from when no Last-Event-ID header is sent. */
+                after?: number | null;
+            };
+            header?: {
+                /** @description The id of the last output event received; takes precedence over after. */
+                "last-event-id"?: string;
+            };
+            path: {
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Server-sent events. `ready` ({cursor}) opens the stream; `state` carries the same body as getAgentSession whenever it changes (always once on connect); `output` carries one reply (with itemId when it was streamed) and its id is the output cursor; `conversation` carries one conversation event (user.message, agent.delta, agent.thought, tool.started, tool.output, tool.completed; bridge v9+) under the same cursor; `reconnect` ({cursor, reason}) closes a rotated stream; `unavailable` ({code, message}) closes when the sandbox cannot be followed; `error` ({code, message}) closes on lost access. Streams rotate within four minutes; reconnect with Last-Event-ID to continue without gaps or repeats. Requires agent_session.read. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/event-stream": 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 Too many event streams are open for this credential. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            code: string;
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @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 Event streaming is not enabled on this API. */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            code: string;
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @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"];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    getAgentTranscript: {
+        parameters: {
+            query?: {
+                after?: number | null;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The conversation in order, read in the guest: user.message (origin caller or terminal), agent.message, agent.thought, tool.started, tool.completed (kind command | file_change | mcp | web_search | tool; status completed | failed | declined; bounded output tail and diff), plus turn and approval markers. Streaming deltas are folded into their final item; `partial` holds text still streaming when the page reaches the end of the log. Follow getAgentSessionEvents from nextCursor afterwards. Requires bridge v9 (409 session_transcript_upgrade_required otherwise) and agent_session.read. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        items: ({
+                            seq: number;
+                            at: string;
+                            type: string;
+                            turnId: string | null;
+                        } & {
+                            [key: string]: unknown;
+                        })[];
+                        partial: ({
+                            seq: number;
+                            type: string;
+                            itemId: string;
+                            text: string;
+                        } & {
+                            [key: string]: unknown;
+                        })[];
+                        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 Transcripts are not enabled on this API. */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            code: string;
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @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"];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    waitForAgentSession: {
+        parameters: {
+            query?: {
+                after?: number | null;
+                timeoutMs?: number;
+            };
+            header?: never;
+            path: {
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Long-poll for clients that cannot hold an event stream. Returns as soon as a reply, turn transition or approval request lands after `after`, or with changed: false at the timeout (default 25 s). `output` follows the same cursor and page bounds as getAgentOutput. Requires agent_session.read. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        changed: boolean;
+                        session: components["schemas"]["AgentSessionState"];
+                        output: {
+                            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 Too many waits or event streams are open for this credential. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            code: string;
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @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 Waiting is not enabled on this API. */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            code: string;
+                            message: string;
+                        };
+                    };
+                };
+            };
+            /** @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;