@agent-os-sdk/client 0.1.2 → 0.2.2

package/src/generated/openapi.ts

@@ -89,17 +89,23 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Import an agent bundle. */
+        /**
+         * Import an agent bundle.
+         * @description Imports an agent bundle into the current tenant/workspace.
+         *     The agent and all versions are created with new IDs to avoid conflicts.
+         *
+         *     **Security:**
+         *     - Tenant and workspace are resolved from the authenticated context
+         *     - Original IDs from the bundle are replaced with new GUIDs
+         */
         post: {
             parameters: {
                 query?: never;
-                header?: {
-                    "X-Tenant-Id"?: string;
-                    "X-Workspace-Id"?: string;
-                };
+                header?: never;
                 path?: never;
                 cookie?: never;
             };
+            /** @description The agent bundle to import. */
             requestBody?: {
                 content: {
                     "application/json": components["schemas"]["AgentBundle"];
@@ -108,13 +114,31 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description OK */
-                200: {
+                /** @description Agent imported successfully. */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Invalid bundle format. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+                /** @description Authentication required or missing workspace context. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -130,10 +154,21 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /**
+         * Lists all agents in the current workspace with pagination.
+         * @description Returns a paginated list of agents accessible to the current user within the specified workspace.
+         *     Results are ordered by creation date (newest first).
+         *
+         *     **Pagination:**
+         *     Use `skip` and `take` parameters to paginate through large result sets.
+         *     Default page size is 20, maximum is 100.
+         */
         get: {
             parameters: {
                 query?: {
+                    /** @description Number of records to skip for pagination. Default: 0. */
                     skip?: number;
+                    /** @description Maximum number of records to return. Default: 20, Max: 100. */
                     take?: number;
                 };
                 header?: never;
@@ -142,16 +177,48 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description OK */
+                /** @description Returns the list of agents. */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description X-Workspace-Id header is required. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+                /** @description Authentication required. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         put?: never;
+        /**
+         * Creates a new agent in the current workspace.
+         * @description Creates a new agent with the specified configuration. The agent is created in draft mode
+         *     and must have a version published before it can be used for runs.
+         *
+         *     **Example Request:**
+         *     ```json
+         *     {
+         *       "name": "customer-support-agent",
+         *       "description": "Handles customer inquiries and support tickets",
+         *       "graph_spec": { "nodes": [...], "edges": [...] }
+         *     }
+         *     ```
+         */
         post: {
             parameters: {
                 query?: never;
@@ -159,6 +226,7 @@ export interface paths {
                 path?: never;
                 cookie?: never;
             };
+            /** @description The agent creation request containing name, description, and optional graph specification. */
             requestBody?: {
                 content: {
                     "application/json": components["schemas"]["CreateAgentRequest"];
@@ -167,13 +235,40 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description OK */
-                200: {
+                /** @description Agent created successfully. Returns the new agent details. */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Invalid request body. Check required fields and data formats. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+                /** @description Authentication required. Provide a valid Bearer token. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+                /** @description An agent with this name already exists in the workspace. */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -189,64 +284,132 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Get agent by ID with tenant isolation (IDOR protected) */
+        /**
+         * Retrieves a specific agent by its unique identifier.
+         * @description Returns the full agent details including configuration, live version reference,
+         *     and metadata. Access is restricted to agents within your tenant (IDOR protected).
+         */
         get: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The unique identifier (GUID) of the agent to retrieve. */
                     id: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description OK */
+                /** @description Returns the agent details. */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Authentication required. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+                /** @description Agent not found or not accessible. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         put?: never;
         post?: never;
-        /** Delete agent by ID with tenant isolation (IDOR protected) */
+        /**
+         * Deletes an agent from the workspace.
+         * @description By default, performs a soft delete (marks as deleted but retains data).
+         *     Use `hardDelete=true` to permanently remove the agent and all associated data.
+         *
+         *     **Warning:** Hard delete is irreversible and will remove:
+         *     - All agent versions
+         *     - All associated runs and threads
+         *     - All credential bindings
+         */
         delete: {
             parameters: {
                 query?: {
+                    /** @description If true, permanently deletes the agent. Default: false (soft delete). */
                     hardDelete?: boolean;
                 };
                 header?: never;
                 path: {
+                    /** @description The unique identifier (GUID) of the agent to delete. */
                     id: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description OK */
-                200: {
+                /** @description Agent deleted successfully. */
+                204: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Authentication required. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+                /** @description Agent not found or not accessible. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         options?: never;
         head?: never;
-        /** Update agent by ID with tenant isolation (IDOR protected) */
+        /**
+         * Updates an existing agent's metadata and configuration.
+         * @description Performs a partial update (PATCH) on the agent. Only provided fields are updated.
+         *
+         *     **Note:** This updates the agent metadata, not the version. To update the agent's
+         *     behavior/graph, create a new version instead.
+         *
+         *     **Example Request:**
+         *     ```json
+         *     {
+         *       "name": "updated-agent-name",
+         *       "description": "New description for the agent"
+         *     }
+         *     ```
+         */
         patch: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The unique identifier (GUID) of the agent to update. */
                     id: string;
                 };
                 cookie?: never;
             };
+            /** @description The fields to update. Only non-null fields will be modified. */
             requestBody?: {
                 content: {
                     "application/json": components["schemas"]["UpdateAgentRequest"];
@@ -255,13 +418,40 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description OK */
+                /** @description Agent updated successfully. Returns updated agent. */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Invalid request body. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+                /** @description Authentication required. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+                /** @description Agent not found or not accessible. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         trace?: never;
@@ -273,25 +463,57 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Get Mermaid graph for the live version of an agent. */
+        /**
+         * Gets a Mermaid diagram representation of the agent's graph.
+         * @description Returns the agent's workflow as a Mermaid diagram string that can be rendered
+         *     in any Mermaid-compatible viewer. Uses the currently live version of the agent.
+         *
+         *     **Example Response:**
+         *     ```json
+         *     {
+         *       "mermaid": "graph TD\n    START --> LLM --> END",
+         *       "agent_id": "...",
+         *       "live_version_id": "..."
+         *     }
+         *     ```
+         */
         get: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The unique identifier (GUID) of the agent. */
                     id: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description OK */
+                /** @description Returns the Mermaid graph representation. */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Authentication required. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+                /** @description Agent not found or not accessible. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         put?: never;
@@ -383,38 +605,67 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List agent versions with tenant isolation (IDOR protected) */
+        /**
+         * Lists all versions for an agent.
+         * @description Returns all versions of the specified agent, ordered by creation date (newest first).
+         *     The response includes which version is currently set as "live".
+         */
         get: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The unique identifier of the agent. */
                     agentId: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description OK */
+                /** @description Returns the list of versions. */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Authentication required. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         put?: never;
-        /** Create agent version with tenant isolation (IDOR protected) */
+        /**
+         * Creates a new version for an agent.
+         * @description Creates an immutable snapshot of the agent's configuration. The new version
+         *     can optionally be marked as the live version immediately.
+         *
+         *     **Example Request:**
+         *     ```json
+         *     {
+         *       "version_tag": "v1.2.0",
+         *       "graph_spec": { "nodes": [...], "edges": [...] },
+         *       "set_live": true
+         *     }
+         *     ```
+         */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The unique identifier of the parent agent. */
                     agentId: string;
                 };
                 cookie?: never;
             };
+            /** @description The version creation request with graph specification. */
             requestBody?: {
                 content: {
                     "application/json": components["schemas"]["CreateAgentVersionRequest"];
@@ -423,13 +674,40 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description OK */
-                200: {
+                /** @description Version created successfully. */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Invalid request body or validation error. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+                /** @description Authentication required. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+                /** @description Parent agent not found. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -445,26 +723,50 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Get specific version with tenant isolation (IDOR protected) */
+        /**
+         * Retrieves a specific version by its identifier.
+         * @description Returns the full details of a specific agent version, including its
+         *     graph specification and all configuration settings.
+         */
         get: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The unique identifier of the parent agent. */
                     agentId: string;
+                    /** @description The unique identifier of the version to retrieve. */
                     versionId: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description OK */
+                /** @description Returns the version details. */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Authentication required. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+                /** @description Version not found. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         put?: never;
@@ -472,17 +774,29 @@ export interface paths {
         delete?: never;
         options?: never;
         head?: never;
-        /** Agent versions are immutable once published. Updates are not allowed. */
+        /**
+         * Updates are not allowed - versions are immutable.
+         * @description Agent versions are immutable by design. This endpoint always returns a 409 Conflict
+         *     to enforce this invariant. To change an agent's behavior, create a new version instead.
+         *
+         *     **Why immutability?**
+         *     - Reproducibility: Every run can be traced to an exact version
+         *     - Auditability: Version history provides a complete changelog
+         *     - Rollback: Easy to revert to any previous version
+         */
         patch: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The unique identifier of the parent agent. */
                     agentId: string;
+                    /** @description The unique identifier of the version. */
                     versionId: string;
                 };
                 cookie?: never;
             };
+            /** @description The update request (ignored - updates not allowed). */
             requestBody?: {
                 content: {
                     "application/json": unknown;
@@ -491,12 +805,14 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description OK */
-                200: {
+                /** @description Versions are immutable. Create a new version instead. */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
                 };
             };
         };
@@ -510,8 +826,9 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * List all API tokens for the current workspace.
-         *     Token secrets are never returned.
+         * Lists all API tokens for the current workspace.
+         * @description Returns token metadata without secrets. Token secrets are only
+         *     available at creation time and cannot be retrieved later.
          */
         get: {
             parameters: {
@@ -521,6 +838,44 @@ export interface paths {
                 cookie?: never;
             };
             requestBody?: never;
+            responses: {
+                /** @description Returns the list of tokens. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Workspace ID header is required. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        /**
+         * Create a new API token.
+         *     The token secret is only returned once on creation.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["CreateTokenRequest"];
+                    "text/json": components["schemas"]["CreateTokenRequest"];
+                    "application/*+json": components["schemas"]["CreateTokenRequest"];
+                };
+            };
             responses: {
                 /** @description OK */
                 200: {
@@ -531,25 +886,158 @@ export interface paths {
                 };
             };
         };
-        put?: never;
-        /**
-         * Create a new API token.
-         *     The token secret is only returned once on creation.
-         */
-        post: {
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/api/tokens/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Revoke an API token immediately. */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/api/tokens/{id}/rotate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Rotate an API token - revokes current and issues a new one.
+         *     The new token secret is only returned once.
+         * @description Rotation is useful for security hygiene (periodic credential rotation)
+         *     or when a token may have been compromised. The new token inherits
+         *     the same scopes and expiration policy as the original.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Token ID to rotate. */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Token rotated successfully, new secret returned. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Token not found or already revoked. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/api/workspaces/{workspaceId}/approvals": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List approvals for a workspace, optionally filtered by status. */
+        get: {
+            parameters: {
+                query?: {
+                    status?: string;
+                    limit?: number;
+                };
+                header?: never;
+                path: {
+                    workspaceId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/api/workspaces/{workspaceId}/approvals/{approvalId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get a specific approval by ID. */
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["CreateTokenRequest"];
-                    "text/json": components["schemas"]["CreateTokenRequest"];
-                    "application/*+json": components["schemas"]["CreateTokenRequest"];
+                path: {
+                    workspaceId: string;
+                    approvalId: string;
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
                 /** @description OK */
                 200: {
@@ -560,13 +1048,15 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/api/tokens/{id}": {
+    "/v1/api/workspaces/{workspaceId}/approvals/{approvalId}/decision": {
         parameters: {
             query?: never;
             header?: never;
@@ -575,18 +1065,27 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        post?: never;
-        /** Revoke an API token immediately. */
-        delete: {
+        /**
+         * Decide on an approval: approve or deny.
+         *     Idempotent: re-deciding returns 200 no-op.
+         */
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
-                    id: string;
+                    workspaceId: string;
+                    approvalId: string;
                 };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["ApprovalDecision"];
+                    "text/json": components["schemas"]["ApprovalDecision"];
+                    "application/*+json": components["schemas"]["ApprovalDecision"];
+                };
+            };
             responses: {
                 /** @description OK */
                 200: {
@@ -597,6 +1096,7 @@ export interface paths {
                 };
             };
         };
+        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
@@ -834,9 +1334,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["CheckpointListResponse"];
                         "application/json": components["schemas"]["CheckpointListResponse"];
-                        "text/json": components["schemas"]["CheckpointListResponse"];
                     };
                 };
                 /** @description Not Found */
@@ -845,9 +1343,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -878,9 +1374,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["CheckpointDetail"];
                         "application/json": components["schemas"]["CheckpointDetail"];
-                        "text/json": components["schemas"]["CheckpointDetail"];
                     };
                 };
             };
@@ -918,9 +1412,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["CheckpointDetail"];
                         "application/json": components["schemas"]["CheckpointDetail"];
-                        "text/json": components["schemas"]["CheckpointDetail"];
                     };
                 };
                 /** @description Not Found */
@@ -929,9 +1421,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -979,9 +1469,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ReplayResponse"];
                         "application/json": components["schemas"]["ReplayResponse"];
-                        "text/json": components["schemas"]["ReplayResponse"];
                     };
                 };
                 /** @description Not Found */
@@ -990,9 +1478,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -1010,38 +1496,55 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
+        /**
+         * Lists all credentials accessible to the current tenant/workspace.
+         * @description Returns credentials the user has access to. Does not expose the encrypted values,
+         *     only metadata like name, type, scope, and status.
+         */
         get: {
             parameters: {
                 query?: {
+                    /** @description Optional filter by workspace. */
                     workspaceId?: string;
                 };
-                header?: {
-                    "X-Tenant-Id"?: string;
-                };
+                header?: never;
                 path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description OK */
+                /** @description Returns the list of credentials. */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Authentication required. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         put?: never;
+        /**
+         * Creates a new credential.
+         * @description Creates a new encrypted credential for storing API keys or secrets.
+         *     The credential is encrypted at rest using workspace-specific keys.
+         */
         post: {
             parameters: {
                 query?: never;
-                header?: {
-                    "X-Member-Id"?: string;
-                };
+                header?: never;
                 path?: never;
                 cookie?: never;
             };
+            /** @description The credential configuration. */
             requestBody?: {
                 content: {
                     "application/json": components["schemas"]["CreateCredentialRequest"];
@@ -1050,13 +1553,31 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description OK */
-                200: {
+                /** @description Credential created successfully. */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Invalid request (missing TypeId or WorkspaceId). */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+                /** @description Authentication required. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -1078,17 +1599,18 @@ export interface paths {
         delete?: never;
         options?: never;
         head?: never;
+        /** Updates an existing credential. */
         patch: {
             parameters: {
                 query?: never;
-                header?: {
-                    "X-Member-Id"?: string;
-                };
+                header?: never;
                 path: {
+                    /** @description The credential ID. */
                     id: string;
                 };
                 cookie?: never;
             };
+            /** @description The update payload. */
             requestBody?: {
                 content: {
                     "application/json": components["schemas"]["UpdateCredentialRequest"];
@@ -1097,13 +1619,22 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description OK */
+                /** @description Credential updated successfully. */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Credential not found. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         trace?: never;
@@ -1117,17 +1648,18 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        /** Grants access to a credential for a workspace. */
         post: {
             parameters: {
                 query?: never;
-                header?: {
-                    "X-Member-Id"?: string;
-                };
+                header?: never;
                 path: {
+                    /** @description The credential ID. */
                     id: string;
                 };
                 cookie?: never;
             };
+            /** @description The grant configuration. */
             requestBody?: {
                 content: {
                     "application/json": components["schemas"]["GrantAccessRequest"];
@@ -1136,13 +1668,22 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description OK */
+                /** @description Access granted successfully. */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Credential not found. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -1161,26 +1702,35 @@ export interface paths {
         get?: never;
         put?: never;
         post?: never;
+        /** Revokes access to a credential. */
         delete: {
             parameters: {
                 query?: never;
-                header?: {
-                    "X-Member-Id"?: string;
-                };
+                header?: never;
                 path: {
+                    /** @description The access grant ID to revoke. */
                     accessId: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description OK */
-                200: {
+                /** @description Access revoked successfully. */
+                204: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Access grant not found. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         options?: never;
@@ -1886,9 +2436,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["PresignedUploadResponse"];
                         "application/json": components["schemas"]["PresignedUploadResponse"];
-                        "text/json": components["schemas"]["PresignedUploadResponse"];
                     };
                 };
                 /** @description Bad Request */
@@ -1897,9 +2445,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -1944,9 +2490,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["FileConfirmResponse"];
                         "application/json": components["schemas"]["FileConfirmResponse"];
-                        "text/json": components["schemas"]["FileConfirmResponse"];
                     };
                 };
                 /** @description Bad Request */
@@ -1955,9 +2499,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
                 /** @description Not Found */
@@ -1966,9 +2508,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -2005,9 +2545,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["PresignedDownloadResponse"];
                         "application/json": components["schemas"]["PresignedDownloadResponse"];
-                        "text/json": components["schemas"]["PresignedDownloadResponse"];
                     };
                 };
                 /** @description Not Found */
@@ -2016,9 +2554,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -2060,9 +2596,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["FileListItem"][];
                         "application/json": components["schemas"]["FileListItem"][];
-                        "text/json": components["schemas"]["FileListItem"][];
                     };
                 };
             };
@@ -2101,9 +2635,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["FileDetail"];
                         "application/json": components["schemas"]["FileDetail"];
-                        "text/json": components["schemas"]["FileDetail"];
                     };
                 };
                 /** @description Not Found */
@@ -2112,9 +2644,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -2147,9 +2677,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -3351,7 +3879,16 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Lists runs with optional filtering. */
+        /**
+         * Lists runs with optional filtering and pagination.
+         * @description Returns a paginated list of runs with filtering options. Results are ordered
+         *     by creation date (newest first).
+         *
+         *     **Filtering:**
+         *     - `agentId`: Show only runs for a specific agent
+         *     - `threadId`: Show only runs in a specific thread
+         *     - `status`: Filter by status (queued, running, completed, failed, canceled)
+         */
         get: {
             parameters: {
                 query?: {
@@ -3359,11 +3896,11 @@ export interface paths {
                     agentId?: string;
                     /** @description Optional filter by thread ID. */
                     threadId?: string;
-                    /** @description Optional filter by status. */
+                    /** @description Optional filter by status (queued, running, completed, failed, canceled). */
                     status?: string;
-                    /** @description Max results to return (default 20, max 100). */
+                    /** @description Max results to return. Default: 20, Max: 100. */
                     limit?: number;
-                    /** @description Pagination offset. */
+                    /** @description Number of records to skip for pagination. */
                     offset?: number;
                 };
                 header?: never;
@@ -3372,24 +3909,47 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description OK */
+                /** @description Returns the list of runs. */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["RunListResponse"];
                         "application/json": components["schemas"]["RunListResponse"];
-                        "text/json": components["schemas"]["RunListResponse"];
+                    };
+                };
+                /** @description Authentication required. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
         };
         put?: never;
         /**
-         * Starts a new agent run.
-         * @description Resolves or creates a thread and identifies the correct agent version before queuing the run.
-         *     Supports Idempotency-Key header for idempotent request handling.
+         * Starts a new agent run asynchronously.
+         * @description Creates a new run and queues it for execution. The run will be processed
+         *     by the data plane and its status can be monitored via polling or SSE.
+         *
+         *     **Thread Resolution:**
+         *     - If `thread.id` is provided, uses existing thread
+         *     - If `thread` is omitted, creates a new thread automatically
+         *
+         *     **Idempotency:**
+         *     Provide `Idempotency-Key` header to prevent duplicate runs.
+         *     If a run with the same key exists and is still valid, returns 200 instead of 201.
+         *
+         *     **Example Request:**
+         *     ```json
+         *     {
+         *       "agent_id": "...",
+         *       "input": { "messages": [{ "role": "user", "content": "Hello" }] }
+         *     }
+         *     ```
          */
         post: {
             parameters: {
@@ -3398,7 +3958,7 @@ export interface paths {
                 path?: never;
                 cookie?: never;
             };
-            /** @description The run request details. */
+            /** @description The run request with agent ID and input. */
             requestBody?: {
                 content: {
                     "application/json": components["schemas"]["CreateRunRequest"];
@@ -3407,26 +3967,40 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description Created */
+                /** @description Existing run returned (idempotent request). */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RunResponse"];
+                    };
+                };
+                /** @description Run created and queued successfully. */
                 201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["RunResponse"];
                         "application/json": components["schemas"]["RunResponse"];
-                        "text/json": components["schemas"]["RunResponse"];
                     };
                 };
-                /** @description Bad Request */
+                /** @description Invalid request (missing agent, invalid input). */
                 400: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+                /** @description Authentication required. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -3463,9 +4037,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["RunDetailResponse"];
                         "application/json": components["schemas"]["RunDetailResponse"];
-                        "text/json": components["schemas"]["RunDetailResponse"];
                     };
                 };
                 /** @description Not Found */
@@ -3474,9 +4046,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -3523,9 +4093,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["RunEventsResponse"];
                         "application/json": components["schemas"]["RunEventsResponse"];
-                        "text/json": components["schemas"]["RunEventsResponse"];
                     };
                 };
                 /** @description Not Found */
@@ -3534,9 +4102,68 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/api/runs/{runId}/events/stream": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Wave 1.0: Get run events for polling-based replay.
+         *     Returns events after a specific sequence number for incremental polling.
+         * @description This is the recommended endpoint for SDK/UI event consumption.
+         *     Events are ordered by sequence number (ascending) and limited to prevent
+         *     large responses. Use `next_after_seq` for pagination.
+         *
+         *     **Security:** Only returns events for runs in the caller's workspace.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Return events with seq greater than this value (default: 0 = all). */
+                    afterSeq?: number;
+                    /** @description Max events to return (default: 100, max: 500). */
+                    limit?: number;
+                };
+                header?: never;
+                path: {
+                    /** @description The unique ID of the run. */
+                    runId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RunEventsPollResponse"];
+                    };
+                };
+                /** @description Not Found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -3581,9 +4208,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["WaitRunResponse"];
                         "application/json": components["schemas"]["WaitRunResponse"];
-                        "text/json": components["schemas"]["WaitRunResponse"];
                     };
                 };
                 /** @description Bad Request */
@@ -3592,9 +4217,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
                 /** @description Request Timeout */
@@ -3603,9 +4226,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -3648,9 +4269,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["BatchRunResponse"];
                         "application/json": components["schemas"]["BatchRunResponse"];
-                        "text/json": components["schemas"]["BatchRunResponse"];
                     };
                 };
                 /** @description Bad Request */
@@ -3659,9 +4278,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -3718,7 +4335,29 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Starts a run and streams updates via SSE. */
+        /**
+         * Creates a run and streams real-time updates via Server-Sent Events (SSE).
+         * @description This is the recommended endpoint for interactive applications. It creates
+         *     a run and maintains an open SSE connection to stream events in real-time.
+         *
+         *     **SSE Events:**
+         *     - `start`: Run created and queued
+         *     - `update`: Run status changed
+         *     - `complete`: Run finished successfully (includes output)
+         *     - `error`: Run failed or was canceled (includes error details)
+         *
+         *     **Example Event Stream:**
+         *     ```
+         *     event: start
+         *     data: {"run_id": "...", "status": "queued"}
+         *
+         *     event: update
+         *     data: {"run_id": "...", "status": "running"}
+         *
+         *     event: complete
+         *     data: {"run_id": "...", "status": "completed", "output": {...}}
+         *     ```
+         */
         post: {
             parameters: {
                 query?: never;
@@ -3726,7 +4365,7 @@ export interface paths {
                 path?: never;
                 cookie?: never;
             };
-            /** @description The stream run request. */
+            /** @description The run request with agent ID and input. */
             requestBody?: {
                 content: {
                     "application/json": components["schemas"]["StreamRunRequest"];
@@ -3785,9 +4424,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["RerunResponse"];
                         "application/json": components["schemas"]["RerunResponse"];
-                        "text/json": components["schemas"]["RerunResponse"];
                     };
                 };
                 /** @description Not Found */
@@ -3796,9 +4433,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -3843,9 +4478,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ReplayResponse"];
                         "application/json": components["schemas"]["ReplayResponse"];
-                        "text/json": components["schemas"]["ReplayResponse"];
                     };
                 };
                 /** @description Not Found */
@@ -3854,9 +4487,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -3892,9 +4523,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["CheckpointIndexResponse"];
                         "application/json": components["schemas"]["CheckpointIndexResponse"];
-                        "text/json": components["schemas"]["CheckpointIndexResponse"];
                     };
                 };
                 /** @description Not Found */
@@ -3903,9 +4532,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -3951,9 +4578,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ResumeResponse"];
                         "application/json": components["schemas"]["ResumeResponse"];
-                        "text/json": components["schemas"]["ResumeResponse"];
                     };
                 };
                 /** @description Bad Request */
@@ -3962,9 +4587,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
                 /** @description Not Found */
@@ -3973,9 +4596,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -4019,9 +4640,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["CancelRunResponse"];
                         "application/json": components["schemas"]["CancelRunResponse"];
-                        "text/json": components["schemas"]["CancelRunResponse"];
                     };
                 };
                 /** @description Not Found */
@@ -4030,9 +4649,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -4370,7 +4987,19 @@ export interface paths {
             };
         };
         put?: never;
-        /** Create a new thread. */
+        /**
+         * Creates a new conversation thread.
+         * @description Creates an empty thread that can be used for agent runs. Threads persist
+         *     conversation state between multiple runs.
+         *
+         *     **Example Request:**
+         *     ```json
+         *     {
+         *       "channel": "http",
+         *       "metadata": { "user_id": "abc123" }
+         *     }
+         *     ```
+         */
         post: {
             parameters: {
                 query?: never;
@@ -4378,6 +5007,7 @@ export interface paths {
                 path?: never;
                 cookie?: never;
             };
+            /** @description Thread creation options including channel and metadata. */
             requestBody?: {
                 content: {
                     "application/json": components["schemas"]["CreateThreadRequest"];
@@ -4386,13 +5016,22 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description OK */
-                200: {
+                /** @description Thread created successfully. */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Authentication required. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -4408,25 +5047,39 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Get a thread by ID. */
+        /**
+         * Retrieves a thread by its unique identifier.
+         * @description Returns the thread details including channel, external ID, and metadata.
+         *     Access is restricted to threads within your tenant (IDOR protected).
+         */
         get: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The unique identifier of the thread. */
                     id: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description OK */
+                /** @description Returns the thread. */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Thread not found. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         put?: never;
@@ -4465,27 +5118,43 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get comprehensive thread state summary.
-         *     Returns last checkpoint, run status, message count, and pointers for UI.
+         * Gets a comprehensive state summary for a thread.
+         * @description Returns aggregated information about the thread including:
+         *     - Run count and status of the last run
+         *     - Last checkpoint information
+         *     - Message count
+         *     - Pointers to related endpoints (runs, messages, history)
+         *
+         *     This is the recommended endpoint for building thread detail UIs.
          */
         get: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The unique identifier of the thread. */
                     id: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description OK */
+                /** @description Returns the thread state summary. */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
+                /** @description Thread not found. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
             };
         };
         put?: never;
@@ -5617,24 +6286,33 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["VectorStoreResponse"][];
                         "application/json": components["schemas"]["VectorStoreResponse"][];
-                        "text/json": components["schemas"]["VectorStoreResponse"][];
                     };
                 };
             };
         };
         put?: never;
-        /** Create a new vector store. */
+        /**
+         * Creates a new vector store for semantic document search.
+         * @description Creates a vector store with the specified embedding configuration.
+         *     The store is ready to accept file attachments immediately after creation.
+         *
+         *     **Default Configuration:**
+         *     - Provider: `openai`
+         *     - Model: `text-embedding-3-small`
+         *     - Dimension: `1536`
+         */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The workspace to create the vector store in. */
                     workspaceId: string;
                 };
                 cookie?: never;
             };
+            /** @description Vector store configuration. */
             requestBody?: {
                 content: {
                     "application/json": components["schemas"]["CreateVectorStoreRequest"];
@@ -5643,15 +6321,22 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description Created */
+                /** @description Vector store created successfully. */
                 201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["VectorStoreResponse"];
                         "application/json": components["schemas"]["VectorStoreResponse"];
-                        "text/json": components["schemas"]["VectorStoreResponse"];
+                    };
+                };
+                /** @description Workspace not found. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -5688,9 +6373,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["VectorStoreResponse"];
                         "application/json": components["schemas"]["VectorStoreResponse"];
-                        "text/json": components["schemas"]["VectorStoreResponse"];
                     };
                 };
                 /** @description Not Found */
@@ -5699,9 +6382,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -5734,9 +6415,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -5780,9 +6459,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["VectorStoreFileResponse"];
                         "application/json": components["schemas"]["VectorStoreFileResponse"];
-                        "text/json": components["schemas"]["VectorStoreFileResponse"];
                     };
                 };
                 /** @description Not Found */
@@ -5791,9 +6468,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -5813,17 +6488,36 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Query the vector store using semantic search. */
+        /**
+         * Performs semantic similarity search against the vector store.
+         * @description Executes a cosine similarity search to find document chunks most relevant
+         *     to the query. Results are ranked by similarity score.
+         *
+         *     **Note:** The query is automatically embedded using the store's configured
+         *     embedding provider before search.
+         *
+         *     **Example Request:**
+         *     ```json
+         *     {
+         *       "query": "How do I configure authentication?",
+         *       "top_k": 5,
+         *       "min_score": 0.7
+         *     }
+         *     ```
+         */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The workspace containing the vector store. */
                     workspaceId: string;
+                    /** @description The vector store to query. */
                     vectorStoreId: string;
                 };
                 cookie?: never;
             };
+            /** @description Query parameters including text and result limits. */
             requestBody?: {
                 content: {
                     "application/json": components["schemas"]["VectorQueryRequest"];
@@ -5832,26 +6526,22 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description OK */
+                /** @description Returns matching results. */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["VectorQueryResponse"];
                         "application/json": components["schemas"]["VectorQueryResponse"];
-                        "text/json": components["schemas"]["VectorQueryResponse"];
                     };
                 };
-                /** @description Not Found */
+                /** @description Vector store not found. */
                 404: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -5903,9 +6593,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "text/plain": components["schemas"]["ProblemDetails"];
                         "application/json": components["schemas"]["ProblemDetails"];
-                        "text/json": components["schemas"]["ProblemDetails"];
                     };
                 };
             };
@@ -6179,6 +6867,10 @@ export interface components {
             /** Format: date-time */
             created_at?: string;
         };
+        ApprovalDecision: {
+            decision?: string | null;
+            comment?: string | null;
+        };
         AttachFileRequest: {
             /** Format: uuid */
             file_id?: string;
@@ -6648,6 +7340,18 @@ export interface components {
             /** Format: date-time */
             created_at?: string;
         };
+        RunEventDto: {
+            /** Format: uuid */
+            id?: string;
+            /** Format: int64 */
+            seq?: number;
+            type?: string | null;
+            /** Format: date-time */
+            timestamp?: string;
+            /** Format: uuid */
+            attempt_id?: string;
+            payload?: unknown;
+        };
         RunEventItem: {
             id?: string | null;
             type?: string | null;
@@ -6655,6 +7359,14 @@ export interface components {
             timestamp?: string;
             data?: unknown;
         };
+        RunEventsPollResponse: {
+            events?: components["schemas"]["RunEventDto"][] | null;
+            /** Format: int64 */
+            latest_seq?: number;
+            /** Format: int64 */
+            next_after_seq?: number;
+            has_more?: boolean;
+        };
         RunEventsResponse: {
             items?: components["schemas"]["RunEventItem"][] | null;
             /** Format: int32 */