@keboola/api-client 31.0.0 → 33.0.0

package/dist/types-CNQdtffE.d.ts

@@ -0,0 +1,3454 @@
+import { c as OpenapiReturnType, o as OpenapiPathType, r as OpenapiBodyType, s as OpenapiQueryType } from "./index-DVhTNwvu.js";
+//#region src/clients/kaiAgent/__generated__/schema.d.ts
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+type paths = {
+  '/ping': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** Readiness probe */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Server is ready */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              /** Format: date-time */
+              timestamp: string;
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** Application info and health status */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Application info */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              /** Format: date-time */
+              timestamp: string;
+              uptime: number;
+              appName: string;
+              appVersion: string;
+              serverVersion: string;
+              connectedMcp: {
+                url: string;
+                /** @enum {string} */
+                status: 'ok' | 'error';
+                details?: unknown;
+                error?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/history': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get chat history
+     * @description Retrieve paginated list of user's chats
+     */
+    get: {
+      parameters: {
+        query?: {
+          limit?: number;
+          starting_after?: string;
+          ending_before?: string;
+        };
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description List of chats with pagination info */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              chats: {
+                /** Format: uuid */
+                id?: string;
+                title?: string;
+                userId?: string;
+                /** Format: date-time */
+                createdAt?: string;
+                /** Format: date-time */
+                lastMessageAt?: string;
+                /** @enum {string} */
+                visibility?: 'public' | 'private';
+                branchId?: number | null;
+              }[];
+              hasMore: boolean;
+            };
+          };
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/chat': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Send a message and get streaming SSE response
+     * @description Send a user message to the chat and receive a streaming Server-Sent Events response
+     */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          'application/json': {
+            /** Format: uuid */
+            id: string;
+            message: {
+              /** Format: uuid */
+              id: string;
+              /** @enum {string} */
+              role: 'user' | 'assistant';
+              parts: {
+                [key: string]: unknown;
+              }[];
+              metadata?: {
+                hidden?: boolean;
+                requestContext?: {
+                  path?: string;
+                  sqlEditorActive?: boolean;
+                };
+                tableContext?: {
+                  tableName: string;
+                  tableId: string;
+                  bucketId: string;
+                  fileName: string;
+                }[];
+              };
+            };
+            selectedChatModel?: string;
+            /** @enum {string} */
+            selectedVisibilityType?: 'public' | 'private';
+            branchId?: number;
+            toolRestrictions?: {
+              allowedTools?: string[];
+              disallowedTools?: string[];
+              readOnlyMode?: boolean;
+            };
+            telemetryMetadata?: {
+              [key: string]: string | number | boolean;
+            };
+            supportsApprovalRequestedEvent?: boolean;
+          };
+        };
+      };
+      responses: {
+        /** @description SSE stream of chat events */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'text/event-stream': unknown;
+          };
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description A message is already being processed in this chat */
+        409: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Rate limit exceeded */
+        429: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    /**
+     * Delete a chat
+     * @description Delete a chat by ID
+     */
+    delete: {
+      parameters: {
+        query: {
+          id: string;
+        };
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Chat deleted successfully */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              /** Format: uuid */
+              id?: string;
+              title?: string;
+              userId?: string;
+              /** Format: date-time */
+              createdAt?: string;
+              /** @enum {string} */
+              visibility?: 'public' | 'private';
+              branchId?: number | null;
+            };
+          };
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/chat/{id}/stream': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Reattach to the in-flight SSE stream for a chat
+     * @description Subscribe to the bus for a running or recently-completed assistant turn. Replays buffered events from the start of the run, then continues live (if the run is still in flight). Returns 404 if no run exists for this chat or its retention window has expired.
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          id: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description SSE stream of chat events */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'text/event-stream': unknown;
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description No stream for this chat — either never started or retention window expired */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/chat/{id}/stop': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Stop the in-flight assistant turn for a chat
+     * @description Signals the chat handler to abort the sandbox process. Idempotent — returns 200 even if no run is active.
+     */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          id: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Stop requested (or no run was active) */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              stopped: boolean;
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Chat not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/chat/{id}': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get chat details and message history
+     * @description Retrieve complete chat details including all messages in the conversation
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          id: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Chat details with message history */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              /** Format: uuid */
+              id: string;
+              title: string;
+              userId: string;
+              /** Format: date-time */
+              createdAt: string;
+              /** Format: date-time */
+              lastMessageAt: string;
+              /** @enum {string} */
+              visibility: 'public' | 'private';
+              branchId?: number | null;
+              contextWindow?: {
+                usedTokens: number;
+                maxTokens: number;
+                percentage: number;
+              } | null;
+              ppuUsed: number | null;
+              ppuPercentage: number | null;
+              messages: {
+                /** Format: uuid */
+                id: string;
+                /** @enum {string} */
+                role: 'user' | 'assistant';
+                parts: ({
+                  /** @enum {string} */
+                  type: 'text';
+                  text: string;
+                  /** @enum {string} */
+                  state?: 'done';
+                } | {
+                  /** @enum {string} */
+                  type: 'tool-result';
+                  toolCallId: string;
+                  toolName: string;
+                  result: string;
+                } | {
+                  /** @enum {string} */
+                  type: 'step-start';
+                } | {
+                  /** @enum {string} */
+                  type: 'data-compact-boundary';
+                  data: {
+                    /** @enum {string} */
+                    trigger: 'manual' | 'auto';
+                    preTokens: number;
+                    preservedSegment?: {
+                      /** Format: uuid */
+                      headUuid: string;
+                      /** Format: uuid */
+                      anchorUuid: string;
+                      /** Format: uuid */
+                      tailUuid: string;
+                    };
+                    summary: string;
+                    sdkSessionId: string;
+                  };
+                } | {
+                  type: string;
+                  toolCallId: string;
+                  /** @enum {string} */
+                  state: 'output-available' | 'output-error' | 'output-denied' | 'input-available' | 'input-streaming' | 'approval-requested' | 'approval-responded';
+                  input?: {
+                    [key: string]: unknown;
+                  };
+                  output?: unknown;
+                  errorText?: string;
+                  approval?: {
+                    id: string;
+                    approved: boolean;
+                    reason?: string;
+                  };
+                })[];
+                metadata?: {
+                  /** Format: date-time */
+                  createdAt?: string;
+                  hidden?: boolean;
+                  requestContext?: {
+                    path?: string;
+                    sqlEditorActive?: boolean;
+                  };
+                };
+                /** @enum {string} */
+                status?: 'pending' | 'completed' | 'interrupted' | 'failed';
+              }[];
+            };
+          };
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Chat not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/vote': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get votes for a chat
+     * @description Retrieve all votes for messages in a specific chat
+     */
+    get: {
+      parameters: {
+        query: {
+          chatId: string;
+        };
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description List of votes */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              /** Format: uuid */
+              chatId: string;
+              /** Format: uuid */
+              messageId: string;
+              isUpvoted: boolean;
+            }[];
+          };
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Chat not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    /**
+     * Vote on a message
+     * @description Add or update a vote on a specific message
+     */
+    patch: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          'application/json': {
+            /** Format: uuid */
+            chatId: string;
+            /** Format: uuid */
+            messageId: string;
+            /** @enum {string} */
+            type: 'up' | 'down';
+          };
+        };
+      };
+      responses: {
+        /** @description Vote recorded successfully */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content?: never;
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Chat not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    trace?: never;
+  };
+  '/api/chat/{id}/approval': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Approve or deny a pending tool execution
+     * @description Submit approval decision for a tool that requires human-in-the-loop confirmation
+     */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          id: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          'application/json': {
+            toolUseId: string;
+            approved: boolean;
+            reason?: string;
+            updatedInput?: {
+              [key: string]: unknown;
+            };
+            answers?: {
+              [key: string]: string;
+            };
+          };
+        };
+      };
+      responses: {
+        /** @description Approval processed */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              success: boolean;
+              toolUseId: string;
+              approved: boolean;
+            };
+          };
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Forbidden — approval belongs to different chat */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description No pending approval found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/chat/{id}/ui-tool-result': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Submit the result of a UI tool (e.g. SQL editor) invocation
+     * @description The frontend executes ui_sql_editor_* tools in the browser and returns the result here. The backend writes the result into the sandbox so the sandbox MCP server unblocks and returns it to the agent.
+     */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          id: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          'application/json': {
+            toolUseId: string;
+            output?: string;
+            errorText?: string;
+          };
+        };
+      };
+      responses: {
+        /** @description Result accepted */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              success: boolean;
+              toolUseId: string;
+            };
+          };
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Forbidden — request belongs to a different chat */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description No pending UI tool request found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/chat/{id}/sandbox/files': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List files in the data-app working directory of the chat sandbox
+     * @description Returns a single-level directory listing rooted at the data-app dir, scoped to the calling user + project. Hidden dirs (.git, node_modules, etc.) are filtered out.
+     */
+    get: {
+      parameters: {
+        query?: {
+          path?: string;
+        };
+        header?: never;
+        path: {
+          id: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Directory listing */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              entries: {
+                name: string;
+                path: string;
+                /** @enum {string} */
+                type: 'file' | 'dir';
+                size?: number;
+              }[];
+            };
+          };
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Chat or sandbox not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/chat/{id}/sandbox/file': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Read a file from the chat sandbox data-app directory
+     * @description Returns the text content of a file inside the data-app dir. Oversize files are truncated; binary files return an empty content string with encoding="binary".
+     */
+    get: {
+      parameters: {
+        query: {
+          path: string;
+        };
+        header?: never;
+        path: {
+          id: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description File content */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              content: string;
+              /** @enum {string} */
+              encoding: 'utf-8' | 'binary';
+              truncated: boolean;
+              size: number;
+            };
+          };
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Chat or sandbox not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/chat/{id}/sandbox/file/download': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Download a file from the chat sandbox data-app directory as raw bytes
+     * @description Returns the raw bytes of a file inside the data-app dir — the binary counterpart of `/sandbox/file`, for deliverables the agent rendered (a `.docx`, a `.pptx`) that the text preview cannot carry. The first binary response in this API: always served as `application/octet-stream` with `Content-Disposition: attachment` and `nosniff`, never with a sniffable type. Same path policy as the preview, plus download-only tightenings: `.env*` files are refused, and files over the size ceiling are refused (413) rather than truncated.
+     */
+    get: {
+      parameters: {
+        query: {
+          path: string;
+        };
+        header?: never;
+        path: {
+          id: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Raw file bytes */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/octet-stream': string;
+          };
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Chat or sandbox not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description File exceeds the download size ceiling */
+        413: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/chat/{id}/sandbox/git-branch': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get the current git branch of the chat sandbox data-app directory
+     * @description Runs `git rev-parse --abbrev-ref HEAD` inside the data-app dir. Returns `branch: null` when the directory has no git repo or the sandbox is unreachable.
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          id: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Current branch (or null) */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              branch: string | null;
+            };
+          };
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Chat or sandbox not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/usage': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get rate limit usage information
+     * @description Returns the current rate limit usage for the authenticated user in the current project.
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Rate limit usage information */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              messagesUsed: number;
+              messagesLimit: number | null;
+              ppuUsed: number;
+              ppuLimit: number | null;
+              /** @enum {string|null} */
+              ppuLimitScope: 'user' | 'project' | null;
+              projectPpuPercentage: number | null;
+              /** Format: date-time */
+              resetDate: string;
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Internal server error */
+        500: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/settings': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get project settings
+     * @description Retrieve project-level custom instructions
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Project settings */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              projectId: string;
+              customInstructions: string | null;
+              createdAt: string;
+              updatedAt: string;
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    /**
+     * Update project settings
+     * @description Update project-level custom instructions
+     */
+    patch: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          'application/json': {
+            customInstructions?: string | null;
+          };
+        };
+      };
+      responses: {
+        /** @description Updated project settings */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              projectId: string;
+              customInstructions: string | null;
+              createdAt: string;
+              updatedAt: string;
+            };
+          };
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Forbidden — the caller's project role cannot write project-wide Kai settings */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    trace?: never;
+  };
+  '/api/settings/user': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get user settings
+     * @description Retrieve user-level custom instructions and tool permissions
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description User settings */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              projectId: string;
+              userId: string;
+              customInstructions: string | null;
+              toolPermissions: {
+                [key: string]: 'always_allow' | 'always_ask' | 'blocked';
+              } | null;
+              createdAt: string;
+              updatedAt: string;
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    /**
+     * Update user settings
+     * @description Update user-level custom instructions and/or tool permissions. Tool permissions are merged with existing values.
+     */
+    patch: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          'application/json': {
+            customInstructions?: string | null;
+            toolPermissions?: {
+              [key: string]: 'always_allow' | 'always_ask' | 'blocked';
+            } | null;
+          };
+        };
+      };
+      responses: {
+        /** @description Updated user settings */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              projectId: string;
+              userId: string;
+              customInstructions: string | null;
+              toolPermissions: {
+                [key: string]: 'always_allow' | 'always_ask' | 'blocked';
+              } | null;
+              createdAt: string;
+              updatedAt: string;
+            };
+          };
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    trace?: never;
+  };
+  '/api/settings/spend-caps': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get Kai spend caps
+     * @description Retrieve the project cap, default per-user limit, and per-user overrides/usage. Readable by any project admin/share role; only an organization admin may write. `members[]` carries every member for an organization admin (`canWrite: true`); a non-org-admin caller sees only their own row, never another member's override/usage.
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Spend caps view */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              projectCapPpu: number | null;
+              effectiveProjectCapPpu: number;
+              defaultUserLimitPpu: number | null;
+              projectUsedPpu: number;
+              canWrite: boolean;
+              members: {
+                userId: string;
+                overrideLimitPpu: number | null;
+                effectiveLimitPpu: number | null;
+                usedPpu: number;
+                /** Format: date-time */
+                overrideUpdatedAt: string | null;
+                overrideUpdatedByUserId: string | null;
+              }[];
+              /** Format: date-time */
+              updatedAt: string | null;
+              updatedByUserId: string | null;
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Forbidden — the caller's project role cannot read Kai spend caps */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Not found — Kai spend caps do not apply to this project (e.g. it is PAYG) */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    /**
+     * Update the project cap and/or default per-user limit
+     * @description Organization-admin only. Rejects a value that would make an existing configuration unreachable.
+     */
+    patch: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          'application/json': {
+            projectCapPpu?: number | null;
+            defaultUserLimitPpu?: number | null;
+          };
+        };
+      };
+      responses: {
+        /** @description Updated spend caps view */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              projectCapPpu: number | null;
+              effectiveProjectCapPpu: number;
+              defaultUserLimitPpu: number | null;
+              projectUsedPpu: number;
+              canWrite: boolean;
+              members: {
+                userId: string;
+                overrideLimitPpu: number | null;
+                effectiveLimitPpu: number | null;
+                usedPpu: number;
+                /** Format: date-time */
+                overrideUpdatedAt: string | null;
+                overrideUpdatedByUserId: string | null;
+              }[];
+              /** Format: date-time */
+              updatedAt: string | null;
+              updatedByUserId: string | null;
+            };
+          };
+        };
+        /** @description Bad request — the new cap/default is unreachable */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Forbidden — only an organization admin may change Kai spend caps */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Not found — Kai spend caps do not apply to this project (e.g. it is PAYG) */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Conflict — the new project cap would make an existing per-user override unreachable */
+        409: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    trace?: never;
+  };
+  '/api/settings/spend-caps/users/{userId}': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    /**
+     * Set or clear one member's spend-cap override
+     * @description Organization-admin only. `overrideLimitPpu: null` clears the override (inherit the project default); `0` is a real value ("no Kai access").
+     */
+    put: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          userId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          'application/json': {
+            overrideLimitPpu: number | null;
+          };
+        };
+      };
+      responses: {
+        /** @description Updated member row */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              userId: string;
+              overrideLimitPpu: number | null;
+              effectiveLimitPpu: number | null;
+              usedPpu: number;
+              /** Format: date-time */
+              overrideUpdatedAt: string | null;
+              overrideUpdatedByUserId: string | null;
+            };
+          };
+        };
+        /** @description Bad request — the new override is unreachable */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Forbidden — only an organization admin may change Kai spend caps */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Not found — Kai spend caps do not apply to this project (e.g. it is PAYG) */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Conflict — too many per-user overrides already exist on this project */
+        409: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/suggestions': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Generate contextual suggestions
+     * @description Generate AI-powered contextual suggestions for dashboard, job-detail, or configuration-detail contexts
+     */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          'application/json': {
+            /** @enum {string} */
+            context: 'dashboard';
+            data: {
+              recentFailedJobs: {
+                id: string;
+                /** @enum {string} */
+                status: 'error' | 'warning';
+                component: string;
+                configId: string;
+                configName?: string;
+                createdTime: string;
+                durationSeconds?: number;
+                errorMessage?: string;
+              }[];
+              deprecatedComponents: {
+                id: string;
+                name: string;
+                type: string;
+                expiredOn: string;
+                configCount: number;
+              }[];
+              userRecentEdits: {
+                component: string;
+                configId: string;
+                configName: string;
+                lastEdited: string;
+              }[];
+              /** Format: email */
+              currentUserEmail: string;
+            };
+          } | {
+            /** @enum {string} */
+            context: 'job-detail';
+            data: {
+              job: {
+                id: string;
+                /** @enum {string} */
+                status: 'created' | 'waiting' | 'processing' | 'success' | 'error' | 'terminating' | 'terminated' | 'cancelled' | 'warning';
+                component: string;
+                configId?: string;
+                configName?: string;
+                createdTime: string;
+                startTime?: string;
+                endTime?: string;
+                durationSeconds?: number;
+                errorMessage?: string;
+                /** @enum {string} */
+                errorType?: 'user' | 'application';
+                backendSize?: string;
+              };
+              component?: {
+                id: string;
+                name: string;
+                type: string;
+              };
+              runtimeHistory?: {
+                averageDurationSeconds?: number;
+                minDurationSeconds?: number;
+                maxDurationSeconds?: number;
+                recentJobsCount: number;
+                isSlowerThanAverage?: boolean;
+                isFasterThanAverage?: boolean;
+                percentageDifference?: number;
+              };
+              /** Format: email */
+              currentUserEmail: string;
+            };
+          } | {
+            /** @enum {string} */
+            context: 'configuration-detail';
+            data: {
+              configuration: {
+                id: string;
+                name: string;
+                description?: string;
+                component: string;
+                hasRows: boolean;
+                rowCount?: number;
+                lastChangeDescription?: string;
+              };
+              component?: {
+                id: string;
+                name: string;
+                type: string;
+              };
+              latestJobs?: {
+                id: string;
+                /** @enum {string} */
+                status: 'created' | 'waiting' | 'processing' | 'success' | 'error' | 'terminating' | 'terminated' | 'cancelled' | 'warning';
+                durationSeconds?: number;
+                errorMessage?: string;
+                createdTime: string;
+              }[];
+              /** Format: email */
+              currentUserEmail: string;
+            };
+          };
+        };
+      };
+      responses: {
+        /** @description Suggestions generated successfully */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              suggestions: {
+                /** Format: uuid */
+                id: string;
+                label: string;
+                prompt: string;
+                priority: number;
+                /** @enum {string} */
+                category: 'error' | 'maintenance' | 'documentation';
+                reasoning: string;
+              }[];
+              /** Format: uuid */
+              suggestionSessionId: string;
+            };
+          };
+        };
+        /** @description Bad request */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/settings/tools': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List available tools
+     * @description List all available MCP tools with their metadata
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description List of available tools */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              tools: {
+                name: string;
+                description: string;
+                readOnly: boolean;
+              }[];
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+        /** @description Service unavailable — an upstream dependency (e.g. Storage API) is unreachable */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/skills': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List skills and built-in slash commands available to the agent
+     * @description Returns the items the chat UI lists in its slash-command menu: built-in slash commands kai-agent itself recognises (`/plan`, `/compact`, `/feedback`) plus the project-tagged skills uploaded to Keboola Storage. Skills bundled with the sandbox (first-party, vendored) are withheld — Claude still auto-invokes them, but they are not offered in the picker. Names and descriptions are normalised server-side — the UI does no merging, and lists whatever it is given.
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description List of skills */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              skills: {
+                name: string;
+                description: string | null;
+                /** @enum {string} */
+                source: 'first-party' | 'vendored' | 'project';
+              }[];
+              commands: {
+                name: string;
+                description: string;
+              }[];
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                /** @enum {string} */
+                type: 'bad_request' | 'unauthorized' | 'forbidden' | 'not_found' | 'conflict' | 'payload_too_large' | 'rate_limit' | 'offline' | 'bad_response' | 'internal';
+                /** @enum {string} */
+                surface: 'chat' | 'auth' | 'api' | 'stream' | 'database' | 'history' | 'vote';
+                message: string;
+                /** @enum {string} */
+                subtype?: 'burst' | 'monthly_messages' | 'monthly_credits_user' | 'monthly_credits_project';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+};
+//#endregion
+//#region src/clients/kaiAgent/types.d.ts
+type GetHistoryQuery = OpenapiQueryType<paths['/api/history']['get']>;
+type GetVotesQuery = OpenapiQueryType<paths['/api/vote']['get']>;
+type GetChatPath = OpenapiPathType<paths['/api/chat/{id}']['get']>;
+type ChatRequest = OpenapiBodyType<paths['/api/chat']['post']>;
+type VoteRequest = OpenapiBodyType<paths['/api/vote']['patch']>;
+type ApprovalBody = OpenapiBodyType<paths['/api/chat/{id}/approval']['post']>;
+type UsageResponse = OpenapiReturnType<paths['/api/usage']['get']>;
+type ChatWithMessages = OpenapiReturnType<paths['/api/chat/{id}']['get']>;
+//#endregion
+export { GetHistoryQuery as a, VoteRequest as c, GetChatPath as i, ChatRequest as n, GetVotesQuery as o, ChatWithMessages as r, UsageResponse as s, ApprovalBody as t };
+//# sourceMappingURL=types-CNQdtffE.d.ts.map