@remotehost/sdk 0.2.0 → 0.4.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,7 +589,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/agent-sessions/{sessionId}/recover": {
+    "/agent-sessions/{sessionId}/release": {
         parameters: {
             query?: never;
             header?: never;
@@ -553,14 +598,55 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** @description Resume a stopped managed bridge in the same running sandbox using its saved vendor conversation. Idempotent when already ready. Interrupted work and pending approvals are not replayed. Requires agent_session.send; cannot recover destroyed sandbox storage. */
-        post: operations["recoverAgentSession"];
+        /**
+         * 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;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List personal agent tokens */
+        get: operations["listAgentAccessTokens"];
+        put?: never;
+        /**
+         * 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;
         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;
+        /** Revoke a personal agent token */
+        delete: operations["revokeAgentAccessToken"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/agent-sessions": {
         parameters: {
             query?: never;
@@ -568,7 +654,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** @description Discover registered sessions across accessible projects. API keys retain their organization and permission limits. Native terminal sessions are not automatically registered. 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;
@@ -587,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;
@@ -602,6 +694,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /** List a project's agent sessions */
         get: operations["listAgentSessions"];
         put?: never;
         post?: never;
@@ -618,6 +711,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /** Retrieve an agent session */
         get: operations["getAgentSession"];
         put?: never;
         post?: never;
@@ -634,6 +728,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /** Read agent replies */
         get: operations["getAgentOutput"];
         put?: never;
         post?: never;
@@ -643,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;
@@ -652,6 +798,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        /** Send a message to an agent */
         post: operations["sendAgentMessage"];
         delete?: never;
         options?: never;
@@ -668,6 +815,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        /** Answer an agent's prompt */
         post: operations["answerAgentPrompt"];
         delete?: never;
         options?: never;
@@ -684,6 +832,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        /** Interrupt the current turn */
         post: operations["interruptAgentTurn"];
         delete?: never;
         options?: never;
@@ -691,6 +840,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/agent-sessions/{sessionId}/recover": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 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;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -1023,13 +1192,34 @@ export interface components {
             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" | "release")[];
+            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} */
-            agent: "claude" | "codex";
+            surface: "terminal" | "managed";
             /** @enum {string} */
             status: "active" | "closed";
             turnId: string | null;
@@ -1045,6 +1235,9 @@ export interface components {
             error: string | null;
             /** @enum {string|null} */
             bridgeState: "starting" | "ready" | "closed" | null;
+            released: boolean;
+            releasing: boolean;
+            bridgeEventSeq: number | null;
             drifted: boolean;
             problems: {
                 seq: number;
@@ -5031,7 +5224,7 @@ export interface operations {
             };
         };
     };
-    recoverAgentSession: {
+    releaseAgentSession: {
         parameters: {
             query?: never;
             header?: never;
@@ -5042,13 +5235,19 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Bridge ready with its saved conversation. */
+            /** @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"];
+                    "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. */
@@ -5061,6 +5260,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5075,6 +5276,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5089,6 +5292,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5103,6 +5308,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5117,6 +5324,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5131,53 +5340,40 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
             };
         };
     };
-    discoverAgentSessions: {
+    listAgentAccessTokens: {
         parameters: {
-            query?: {
-                orgId?: string;
-                projectId?: string;
-                sandboxId?: string;
-                after?: string;
-                limit?: number;
-            };
+            query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Permission-filtered page. Follow nextCursor with after while hasMore is true. */
+            /** @description The signed-in user's tokens. No token hashes or secrets. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        sessions: {
+                        tokens: {
+                            /** Format: uuid */
                             id: string;
-                            org_id: string;
-                            project_id: string;
-                            sandbox_id: string | null;
-                            /** @enum {string} */
-                            agent: "claude" | "codex";
-                            /** @enum {string} */
-                            status: "active" | "closed";
-                            last_activity_at: string;
-                            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")[];
+                            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;
                         }[];
-                        nextCursor: string | null;
-                        hasMore: boolean;
                     };
                 };
             };
@@ -5191,6 +5387,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5205,6 +5403,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5219,6 +5419,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5233,6 +5435,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5247,6 +5451,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5261,30 +5467,50 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
             };
         };
     };
-    createAgentSession: {
+    createAgentAccessToken: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                sandboxId: string;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": {
+                    name: string;
+                    scopes: ("agent_session.read" | "agent_session.send" | "agent_session.approve" | "sandbox.create")[];
+                    expiresInDays?: number;
+                };
+            };
+        };
         responses: {
-            /** @description Bridge ready. */
+            /** @description Personal token created. */
             201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["AgentSessionState"];
+                    "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. */
@@ -5297,6 +5523,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5311,6 +5539,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5325,6 +5555,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5339,6 +5571,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5353,6 +5587,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5367,46 +5603,33 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
             };
         };
     };
-    listAgentSessions: {
+    revokeAgentAccessToken: {
         parameters: {
-            query: {
-                orgId: string;
-            };
+            query?: never;
             header?: never;
             path: {
-                projectId: string;
+                tokenId: string;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Most recent session index records. Read a session for reconciled turn state. */
+            /** @description Revoked. User sign-in required. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        sessions: ({
-                            id: string;
-                            org_id: string;
-                            project_id: string;
-                            sandbox_id: string | null;
-                            /** @enum {string} */
-                            agent: "claude" | "codex";
-                            /** @enum {string} */
-                            status: "active" | "closed";
-                            vendor_session_id: string | null;
-                            last_activity_at: string;
-                        } & {
-                            [key: string]: unknown;
-                        })[];
+                        revoked: boolean;
                     };
                 };
             };
@@ -5420,6 +5643,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5434,6 +5659,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5448,6 +5675,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5462,6 +5691,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5476,6 +5707,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5490,30 +5723,58 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
             };
         };
     };
-    getAgentSession: {
+    discoverAgentSessions: {
         parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                sessionId: string;
+            query?: {
+                orgId?: string;
+                projectId?: string;
+                sandboxId?: string;
+                after?: string;
+                limit?: number;
             };
+            header?: never;
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Reconciled state, including the most recent completed turn or pending approval. */
+            /** @description Permission-filtered page. Follow nextCursor with after while hasMore is true. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["AgentSessionState"];
+                    "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. */
@@ -5526,6 +5787,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5540,6 +5803,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5554,6 +5819,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5568,6 +5835,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5582,6 +5851,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5596,43 +5867,32 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
             };
         };
     };
-    getAgentOutput: {
+    createAgentSession: {
         parameters: {
-            query?: {
-                after?: number | null;
-                limit?: number;
-            };
+            query?: never;
             header?: never;
             path: {
-                sessionId: string;
+                sandboxId: 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: {
+            /** @description Bridge ready. */
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        messages: {
-                            seq: number;
-                            turnId: string | null;
-                            at: string;
-                            text: string;
-                            truncated: boolean;
-                        }[];
-                        nextCursor: number;
-                        hasMore: boolean;
-                    };
+                    "application/json": components["schemas"]["AgentSessionState"];
                 };
             };
             /** @description The operation could not be completed; inspect error.message and error.code. */
@@ -5645,6 +5905,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5659,6 +5921,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5673,6 +5937,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5687,6 +5953,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5701,6 +5969,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5715,6 +5985,861 @@ export interface operations {
                         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"];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    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"];
                         };
                     };
                 };
@@ -5734,6 +6859,8 @@ export interface operations {
             content: {
                 "application/json": {
                     text: string;
+                    /** @description Reuse the same key and text to retry without creating another turn. */
+                    requestKey?: string;
                 };
             };
         };
@@ -5747,7 +6874,8 @@ export interface operations {
                     "application/json": {
                         turnId: string;
                         /** @enum {string} */
-                        state: "submitted";
+                        state: "submitted" | "working" | "input-required" | "completed" | "failed" | "canceled";
+                        replayed?: boolean;
                     };
                 };
             };
@@ -5761,6 +6889,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5775,6 +6905,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5789,6 +6921,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5803,6 +6937,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5817,6 +6953,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5831,6 +6969,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5877,6 +7017,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5891,6 +7033,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5905,6 +7049,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5919,6 +7065,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5933,6 +7081,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5947,6 +7097,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -5985,6 +7137,126 @@ export interface operations {
                         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"];
                         };
                     };
                 };
@@ -5999,6 +7271,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -6013,6 +7287,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -6027,6 +7303,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -6041,6 +7319,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };
@@ -6055,6 +7335,8 @@ export interface operations {
                         error: {
                             message: string;
                             code?: string;
+                            turnId?: string;
+                            communication?: components["schemas"]["AgentSessionCommunication"];
                         };
                     };
                 };