@keboola/api-client 1.0.1 → 2.0.0

package/dist/index.d.ts

@@ -19,10 +19,10 @@ import { EncryptQuery } from './encryption/types.js';
 import { G as GetDataAppRunsPath, a as GetDataAppRunsQuery, b as GetDataAppRunPath, c as GetDataAppLogsDownloadPath, d as GetDataAppLogsTailPath, e as GetDataAppLogsTailQuery, L as LogEntry, f as GetAppsQuery, g as GetDataAppPath, C as CreateDataAppBody, P as PatchDataAppPath, h as PatchDataAppBody, D as DeleteDataAppPath, i as GetDataAppPasswordPath, R as ResetDataAppPasswordPath, j as GetSandboxPath } from './utils-BNQZiNOu.js';
 export { p as parseLogLines } from './utils-BNQZiNOu.js';
 import { CreateVariableBody, DeleteVariablePath, VariableWithHash, GetVariablesQuery, GetVariablesByBranchId } from './vault/types.js';
-import { ServiceId, CreateTableAsyncBody, TableCreateJob, TableImportAsyncBody, TableImportJob, TableExportAsyncBody, TableExportJob, BucketListing, CreateBucketListingInput, UpdateBucketListingInput, Service, StackComponent, GetBucketsQuery, Bucket, BucketDetail, CreateBucketBody, UpdateBucketBody, CreateScheduledRefreshPath, CreateScheduledRefreshBody, ScheduledTask, Job, GetEventsQuery, StorageEvent, CreateEventBody, File as File$1, GetFilesQuery, DeleteFileTagPath, PrepareFileBody, PreparedFile, GetTablesQuery, Table, TableDetail, GetDataPreview, PrevieData, DeleteTableRows, JobUnion, DevBranch, CreateDevBranchJobBody, DevBranchPath, BranchMetadata, BranchMetadataEntry, WorkspacePath, Workspace, WorkspacesPath, ResetWorkspacePassword, SetWorkspacePublicInput, GetWorkspaceSaml2LoginPath, WorkspaceSaml2Login, WorkspaceObject, DeleteWorkspaceObjectInput, MergeRequestDetail, MergeRequestDetailWithActivityLog, CreateMergeRequestParams, UpdateMergeRequestParams, JobOperation, GetJobPath, GetJobsQuery, GetComponentPath, Component, GetComponentsPath, GetComponentsQuery, GetSearchComponentConfigurationsPath, SearchComponentConfigurationsQuery, SearchComponentConfiguration, PartialKey, CreateConfigurationInput, BaseComponentConfig, ConfigType, ConfigurationPath, ComponentConfig, GetConfigurationsPath, CreateConfigurationRowInput, Row, CreateConfigurationRowsInput, CreateConfigurationRowBody, DeleteConfigurationRowInput, DeleteConfigurationRowsInput, CreateConfigurationWorkspaceBody, ConfigurationUseCaseType, ConfigurationVersionPath, ConfigurationVersion, ConfigurationVersionDetailPath, ConfigurationVersionDetail, GetStackInfoQuery, StackInfo } from './storage/types.js';
+import { ServiceId, CreateTableAsyncBody, TableCreateJob, TableImportAsyncBody, TableImportJob, TableExportAsyncBody, TableExportJob, BucketListing, CreateBucketListingInput, UpdateBucketListingInput, Service, StackComponent, GetBucketsQuery, Bucket, BucketDetail, CreateBucketBody, UpdateBucketBody, CreateScheduledRefreshPath, CreateScheduledRefreshBody, ScheduledTask, Job, GetEventsQuery, StorageEvent, CreateEventBody, File as File$1, GetFilesQuery, DeleteFileTagPath, PrepareFileBody, PreparedFile, GetTablesQuery, Table, TableDetail, GetDataPreview, PrevieData, DeleteTableRows, JobUnion, DevBranch, CreateDevBranchJobBody, DevBranchPath, BranchMetadata, BranchMetadataEntry, WorkspacePath, Workspace, WorkspacesPath, ResetWorkspacePassword, SetWorkspacePublicInput, GetWorkspaceSaml2LoginPath, WorkspaceSaml2Login, WorkspaceObject, DeleteWorkspaceObjectInput, UnloadWorkspaceInput, MergeRequestDetail, MergeRequestDetailWithActivityLog, CreateMergeRequestParams, UpdateMergeRequestParams, JobOperation, GetJobPath, GetJobsQuery, GetComponentPath, Component, GetComponentsPath, GetComponentsQuery, GetSearchComponentConfigurationsPath, SearchComponentConfigurationsQuery, SearchComponentConfiguration, PartialKey, CreateConfigurationInput, BaseComponentConfig, ConfigType, ConfigurationPath, ComponentConfig, GetConfigurationsPath, CreateConfigurationRowInput, Row, CreateConfigurationRowsInput, CreateConfigurationRowBody, DeleteConfigurationRowInput, DeleteConfigurationRowsInput, CreateConfigurationWorkspaceBody, ConfigurationUseCaseType, ConfigurationVersionPath, ConfigurationVersion, ConfigurationVersionDetailPath, ConfigurationVersionDetail, GetStackInfoQuery, StackInfo } from './storage/types.js';
 import { M as MetaObject } from './types-BY0tjg2Q.js';
-import { C as ConcurrentOptions, M as MiddlewareFn$1 } from './storageClient-DrYOs4Xm.js';
-export { a as concurrent } from './storageClient-DrYOs4Xm.js';
+import { C as ConcurrentOptions, M as MiddlewareFn$1 } from './storageClient-BicsbzZy.js';
+export { a as concurrent } from './storageClient-BicsbzZy.js';
 import { K as KeboolaObjectId } from './keboolaUID-D1DGSbge.js';
 export { k as keboolaUID } from './keboolaUID-D1DGSbge.js';
 import { TagWithBindings, TagData, CreateMetaObjectMetaDataInput, UpdateMetaObjectMetaDataInput } from './sdk/tag/types.js';
@@ -30,7 +30,7 @@ import { B as Backend, S as StorageToken } from './types-DYMMsuU0.js';
 export { c as createGenericFetchClient } from './createGenericFetchClient-DEakI3F1.js';
 export { M as ManagementClientAuthError, i as isManagementClientAuthError } from './authMiddleware-BTFSCMTE.js';
 import { ManagementToken } from './verify/types.js';
-export { c as createStorageSdk } from './storageSdk-ZVmKQQSl.js';
+export { c as createStorageSdk } from './storageSdk-DCcD68FQ.js';
 import 'qs';
 import './createOpenapiFetchClient-_sm4bchL.js';
 import './metastore/index.js';
@@ -205,9 +205,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -220,9 +235,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -306,9 +366,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -321,9 +396,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -336,9 +426,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -351,9 +456,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -402,9 +552,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -417,9 +582,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -432,9 +612,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -485,9 +710,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -500,9 +740,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -515,9 +770,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -575,9 +875,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -590,9 +905,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -605,9 +935,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -735,10 +1110,6 @@ type paths = {
                     path?: string;
                     sqlEditorActive?: boolean;
                   };
-                  /** Format: uuid */
-                  compactedTo?: string;
-                  /** Format: uuid */
-                  compactedFrom?: string;
                 };
                 /** @enum {string} */
                 status?: 'pending' | 'completed' | 'interrupted' | 'failed';
@@ -754,9 +1125,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -769,9 +1155,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -784,9 +1185,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -799,9 +1215,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -861,9 +1322,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -876,9 +1352,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -891,9 +1382,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -906,9 +1412,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -959,9 +1510,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -974,9 +1540,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -989,9 +1570,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -1004,9 +1600,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -1074,9 +1715,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -1089,9 +1745,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -1104,9 +1775,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -1119,9 +1805,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -1186,9 +1917,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -1201,9 +1947,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
-                message: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -1216,9 +1977,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -1231,15 +2007,563 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                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';
+                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';
+                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';
+                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';
+                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';
+                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';
+                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';
+                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';
+                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';
+                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';
+                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';
+                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';
+                exceptionId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
     delete?: never;
     options?: never;
     head?: never;
@@ -1288,9 +2612,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -1303,9 +2642,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -1362,9 +2746,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -1417,9 +2846,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -1432,9 +2876,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -1489,9 +2978,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -1551,9 +3085,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -1566,9 +3115,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -1751,9 +3345,24 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                exceptionId?: string;
               };
             };
           };
@@ -1766,9 +3375,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -1824,9 +3478,54 @@ type paths = {
           content: {
             'application/json': {
               error: {
-                type: string;
-                surface: string;
+                /** @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';
+                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';
+                exceptionId?: string;
               };
             };
           };
@@ -1883,6 +3582,16 @@ declare const generateUUID: () => `${string}-${string}-${string}-${string}-${str
  */
 declare const series: <T, R>(options: Omit<ConcurrentOptions<T, R>, "concurrency">) => Promise<R[]>;
 
+/**
+ * Strips trailing slashes from a base URL so concatenating a leading-slash
+ * path (e.g. `/v2/storage`) never produces a double slash.
+ *
+ * Without this, callers that pass `https://connection.keboola.com/` end up
+ * issuing requests to `https://connection.keboola.com//v2/storage/...`, which
+ * the Storage API rejects with a 404.
+ */
+declare const normalizeBaseUrl: (baseUrl: string) => string;
+
 type ServiceUrls = Partial<Record<ServiceId, (url: string) => string | undefined | null>>;
 
 type ApiClientOptions = {
@@ -2814,8 +4523,6 @@ declare const createClients: ({ baseUrl, token, callbacks, assetsBaseUrl, status
                         path?: string;
                         sqlEditorActive?: boolean;
                     };
-                    compactedTo?: string;
-                    compactedFrom?: string;
                 };
                 status?: "pending" | "completed" | "interrupted" | "failed";
             }[];
@@ -3233,6 +4940,7 @@ declare const createClients: ({ baseUrl, token, callbacks, assetsBaseUrl, status
                     exceptionId?: string;
                 };
             })>;
+            unloadWorkspace: ({ branchId, workspaceId, ...query }: UnloadWorkspaceInput) => Promise<unknown>;
         };
         mergeRequests: {
             getMergeRequests: (signal?: AbortSignal) => Promise<{
@@ -4068,4 +5776,4 @@ declare const createDevApiClient: () => {
     };
 };
 
-export { type ApiClient, type ApiClientOptions, ConcurrentOptions, HttpContentType, HttpHeader, KeboolaHttpHeader, KeboolaObjectId, type Log, type LogLevel, type Logger, type LoggingOptions, MiddlewareFn, PollException, type RequestLog, type ResponseLog, type RetryOptions, ServiceUnavailableError, UserError, assert, consoleLogger, createApiClient, createDevApiClient, createLoggingMiddleware, createRetryMiddleware, delay, generateUUID, poll, series };
+export { type ApiClient, type ApiClientOptions, ConcurrentOptions, HttpContentType, HttpHeader, KeboolaHttpHeader, KeboolaObjectId, type Log, type LogLevel, type Logger, type LoggingOptions, MiddlewareFn, PollException, type RequestLog, type ResponseLog, type RetryOptions, ServiceUnavailableError, UserError, assert, consoleLogger, createApiClient, createDevApiClient, createLoggingMiddleware, createRetryMiddleware, delay, generateUUID, normalizeBaseUrl, poll, series };