@keboola/api-client 1.0.0 → 2.0.0

package/dist/index.d.ts

@@ -9,7 +9,7 @@ import { c as OpenapiQueryType, d as OpenapiPathType, b as OpenapiBodyType, a as
 import { U as UploadFileParams, a as UploadedFile } from './types-Dg1tEsVR.js';
 import { D as DescribeConfigurationVersionBody, a as DescribeConfigurationMergeBody, E as ExplainErrorBody, b as DescribeConfigurationBody, S as SuggestComponentBody, c as components$4, F as FeedbackBody } from './types-B51cQMrX.js';
 import { SuggestionsRequestBody, SuggestionsApiResponse } from './chat/suggestions.js';
-import { G as GetHistoryQuery$1, c as components$3, a as GetChatPath$1, C as ChatRequest$1, b as GetVotesQuery$1, V as VoteRequest$1, U as UsageResponse$1, A as AgentSettings, d as UpdateAgentSettingsRequest, e as UserAgentSettings, f as UpdateUserAgentSettingsRequest, T as ToolsListResponse } from './types-BjrNNn5I.js';
+import { G as GetHistoryQuery$1, c as components$3, a as GetChatPath$1, C as ChatRequest$1, b as GetVotesQuery$1, V as VoteRequest$1, U as UsageResponse$1, A as AgentSettings, d as UpdateAgentSettingsRequest, e as UserAgentSettings, f as UpdateUserAgentSettingsRequest, T as ToolsListResponse } from './types-DzwzVgyG.js';
 import { G as GetQueueJobPath, c as components$2, S as SearchJobsQuery } from './types-cH0_hkCW.js';
 import { P as PostQueryPath, a as PostQueryBody, b as PostCancelQueryJobPath, G as GetQueryJobPath, c as components$1, d as GetQueryResultsPath, e as GetQueryResutsQuery, f as GetQueriesPath, g as GetQueriesHistoryQuery, h as GetExportResultsQuery, E as ExportResultsResponse } from './types-CGMJT3JL.js';
 import { CreateCredentialsBody, WorkspaceData } from './telemetry/types.js';
@@ -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, Service, StackComponent, GetBucketsQuery, Bucket, BucketDetail, CreateBucketBody, UpdateBucketBody, CreateScheduledRefreshPath, CreateScheduledRefreshBody, ScheduledTask, 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, Job, 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-C8LDO4gr.js';
-export { a as concurrent } from './storageClient-C8LDO4gr.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-CX03lGn-.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;
               };
             };
           };
@@ -684,6 +1059,25 @@ type paths = {
                       /** @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;
@@ -716,10 +1110,6 @@ type paths = {
                     path?: string;
                     sqlEditorActive?: boolean;
                   };
-                  /** Format: uuid */
-                  compactedTo?: string;
-                  /** Format: uuid */
-                  compactedFrom?: string;
                 };
                 /** @enum {string} */
                 status?: 'pending' | 'completed' | 'interrupted' | 'failed';
@@ -735,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;
               };
             };
           };
@@ -750,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;
               };
             };
           };
@@ -765,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;
               };
             };
           };
@@ -780,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;
               };
             };
           };
@@ -842,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;
               };
             };
           };
@@ -857,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;
               };
             };
           };
@@ -872,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;
               };
             };
           };
@@ -887,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;
               };
             };
           };
@@ -940,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;
               };
             };
           };
@@ -955,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;
               };
             };
           };
@@ -970,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;
               };
             };
           };
@@ -985,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;
               };
             };
           };
@@ -1055,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;
               };
             };
           };
@@ -1070,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;
               };
             };
           };
@@ -1085,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;
               };
             };
           };
@@ -1100,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;
               };
             };
           };
@@ -1167,9 +1917,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;
               };
             };
           };
@@ -1182,9 +1947,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;
               };
             };
           };
@@ -1197,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;
               };
             };
           };
@@ -1212,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;
@@ -1269,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;
               };
             };
           };
@@ -1284,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;
               };
             };
           };
@@ -1343,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;
               };
             };
           };
@@ -1398,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;
               };
             };
           };
@@ -1413,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;
               };
             };
           };
@@ -1470,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;
               };
             };
           };
@@ -1532,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;
               };
             };
           };
@@ -1547,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;
               };
             };
           };
@@ -1732,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;
               };
             };
           };
@@ -1747,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;
               };
             };
           };
@@ -1805,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;
               };
             };
           };
@@ -1864,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 = {
@@ -1906,6 +3634,143 @@ declare const createClients: ({ baseUrl, token, callbacks, assetsBaseUrl, status
                 maxAttempts?: number;
                 abortSignal?: AbortSignal;
             }) => Promise<TableExportJob>;
+            getBucketListing: (bucketId: string, signal?: AbortSignal) => Promise<BucketListing | null>;
+            listBucketListings: (signal?: AbortSignal) => Promise<BucketListing[]>;
+            createBucketListing: (bucketId: string, input: CreateBucketListingInput, options?: {
+                interval?: number;
+                maxAttempts?: number;
+                abortSignal?: AbortSignal;
+            }) => Promise<{
+                id: number;
+                tableId: string | null;
+                runId: string;
+                url: string;
+                createdTime: string;
+                creatorToken: {
+                    id: string;
+                    description: string;
+                };
+                endTime: string | null;
+                startTime: string | null;
+                operationName: "bucketListingCreate";
+                operationParams: {
+                    queue: string;
+                } & {
+                    bucketId: string;
+                };
+                metrics: {
+                    inCompressed: boolean;
+                    inBytes: number;
+                    inBytesUncompressed: number;
+                    outCompressed: boolean;
+                    outBytes: number;
+                    outBytesUncompressed: number;
+                };
+            } & ({
+                status: Exclude<"error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled", "success" | "error">;
+                results: null;
+            } | {
+                status: "error";
+                results: null;
+                error: {
+                    code: string;
+                    message: string;
+                    exceptionId?: string;
+                };
+            } | {
+                status: "success";
+                results: null;
+            })>;
+            updateBucketListing: (bucketId: string, input: UpdateBucketListingInput, options?: {
+                interval?: number;
+                maxAttempts?: number;
+                abortSignal?: AbortSignal;
+            }) => Promise<{
+                id: number;
+                tableId: string | null;
+                runId: string;
+                url: string;
+                createdTime: string;
+                creatorToken: {
+                    id: string;
+                    description: string;
+                };
+                endTime: string | null;
+                startTime: string | null;
+                operationName: "bucketListingUpdate";
+                operationParams: {
+                    queue: string;
+                } & {
+                    bucketId: string;
+                };
+                metrics: {
+                    inCompressed: boolean;
+                    inBytes: number;
+                    inBytesUncompressed: number;
+                    outCompressed: boolean;
+                    outBytes: number;
+                    outBytesUncompressed: number;
+                };
+            } & ({
+                status: Exclude<"error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled", "success" | "error">;
+                results: null;
+            } | {
+                status: "error";
+                results: null;
+                error: {
+                    code: string;
+                    message: string;
+                    exceptionId?: string;
+                };
+            } | {
+                status: "success";
+                results: null;
+            })>;
+            deleteBucketListing: (bucketId: string, options?: {
+                interval?: number;
+                maxAttempts?: number;
+                abortSignal?: AbortSignal;
+            }) => Promise<{
+                id: number;
+                tableId: string | null;
+                runId: string;
+                url: string;
+                createdTime: string;
+                creatorToken: {
+                    id: string;
+                    description: string;
+                };
+                endTime: string | null;
+                startTime: string | null;
+                operationName: "bucketListingDelete";
+                operationParams: {
+                    queue: string;
+                } & {
+                    bucketId: string;
+                };
+                metrics: {
+                    inCompressed: boolean;
+                    inBytes: number;
+                    inBytesUncompressed: number;
+                    outCompressed: boolean;
+                    outBytes: number;
+                    outBytesUncompressed: number;
+                };
+            } & ({
+                status: Exclude<"error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled", "success" | "error">;
+                results: null;
+            } | {
+                status: "error";
+                results: null;
+                error: {
+                    code: string;
+                    message: string;
+                    exceptionId?: string;
+                };
+            } | {
+                status: "success";
+                results: null;
+            })>;
         };
     };
     vault: {
@@ -2623,6 +4488,19 @@ declare const createClients: ({ baseUrl, token, callbacks, assetsBaseUrl, status
                     result: string;
                 } | {
                     type: "step-start";
+                } | {
+                    type: "data-compact-boundary";
+                    data: {
+                        trigger: "manual" | "auto";
+                        preTokens: number;
+                        preservedSegment?: {
+                            headUuid: string;
+                            anchorUuid: string;
+                            tailUuid: string;
+                        };
+                        summary: string;
+                        sdkSessionId: string;
+                    };
                 } | {
                     type: string;
                     toolCallId: string;
@@ -2645,8 +4523,6 @@ declare const createClients: ({ baseUrl, token, callbacks, assetsBaseUrl, status
                         path?: string;
                         sqlEditorActive?: boolean;
                     };
-                    compactedTo?: string;
-                    compactedFrom?: string;
                 };
                 status?: "pending" | "completed" | "interrupted" | "failed";
             }[];
@@ -2721,6 +4597,23 @@ declare const createClients: ({ baseUrl, token, callbacks, assetsBaseUrl, status
                 readOnly: boolean;
             }[];
         }>;
+        listSandboxFiles: (chatId: string, path?: string, signal?: AbortSignal) => Promise<{
+            entries: {
+                name: string;
+                path: string;
+                type: "file" | "dir";
+                size?: number | undefined;
+            }[];
+        }>;
+        readSandboxFile: (chatId: string, path: string, signal?: AbortSignal) => Promise<{
+            content: string;
+            encoding: "utf-8" | "binary";
+            truncated: boolean;
+            size: number;
+        }>;
+        getSandboxGitBranch: (chatId: string, signal?: AbortSignal) => Promise<{
+            branch: string | null;
+        }>;
         chatStreamUrl: string;
     };
     oauth: {
@@ -2811,6 +4704,11 @@ declare const createClients: ({ baseUrl, token, callbacks, assetsBaseUrl, status
             })>;
             createScheduledRefresh: (input: CreateScheduledRefreshPath & CreateScheduledRefreshBody) => Promise<ScheduledTask>;
             deleteScheduledTask: (taskId: string) => Promise<void>;
+            getListing: (bucketId: string, signal?: AbortSignal) => Promise<BucketListing | null>;
+            createListing: (bucketId: string, input: CreateBucketListingInput, signal?: AbortSignal) => Promise<Job<"bucketListingCreate">>;
+            updateListing: (bucketId: string, input: UpdateBucketListingInput, signal?: AbortSignal) => Promise<Job<"bucketListingUpdate">>;
+            deleteListing: (bucketId: string, signal?: AbortSignal) => Promise<Job<"bucketListingDelete">>;
+            listListings: (signal?: AbortSignal) => Promise<BucketListing[]>;
         };
         events: {
             getEvents: (query?: GetEventsQuery, signal?: AbortSignal) => Promise<StorageEvent[]>;
@@ -3042,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<{
@@ -3877,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 };