@keboola/api-client 29.0.0 → 32.0.0

package/dist/{types-BXK6Ebtm.d.ts → types-sVYo0o9_.d.ts}

@@ -1,5 +1,5 @@
-import { i as CreateMetaObjectInput, p as MetaObject } from "./types-Z-vUwgym.js";
-import { n as createMetastoreClient } from "./index-BthgbVdd.js";
+import { i as CreateMetaObjectInput, p as MetaObject } from "./types-BlCoTm7n.js";
+import { n as createMetastoreClient } from "./index-GDdFZCXp.js";
 //#region src/sdks/tag/types.d.ts
 type MetastoreClient = ReturnType<typeof createMetastoreClient>;
 type TagData = {
@@ -29,4 +29,4 @@ type UpdateMetaObjectMetaDataInput = {
 };
 //#endregion
 export { TagWithBindings as a, TagData as i, MetastoreClient as n, UpdateMetaObjectMetaDataInput as o, TagBindingData as r, CreateMetaObjectMetaDataInput as t };
-//# sourceMappingURL=types-BXK6Ebtm.d.ts.map
+//# sourceMappingURL=types-sVYo0o9_.d.ts.map

package/dist/{types-DgaYUtu_.d.cts → types-zA3H84SM.d.cts}

@@ -1,4 +1,4 @@
-import { c as OpenapiReturnType, o as OpenapiPathType, r as OpenapiBodyType } from "./index-CLPrlyIz.cjs";
+import { c as OpenapiReturnType, o as OpenapiPathType, r as OpenapiBodyType } from "./index-CQrKS7PV.cjs";
 //#region src/clients/oauth/__generated__/schema.d.ts
 /**
  * This file was auto-generated by openapi-typescript.
@@ -723,4 +723,4 @@ type CreateCredentialInput = ComponentPath & Omit<CreateCredentialBody, '#data'>
 };
 //#endregion
 export { CredentialInput as a, Credential as i, CreateCredentialBody as n, CredentialPath as o, CreateCredentialInput as r, GetCredentialsInput as s, ComponentPath as t };
-//# sourceMappingURL=types-DgaYUtu_.d.cts.map
+//# sourceMappingURL=types-zA3H84SM.d.cts.map

package/dist/validateConnectionStatus-BrLXkoSI.js

@@ -0,0 +1,38 @@
+import { c as isHtmlResponse, m as ApiError, s as defaultValidateStatus } from "./createFetchClient-BbG46bL0.js";
+//#region src/errors/HtmlResponseError.ts
+/**
+* A successful response that carried an HTML page instead of the endpoint's payload.
+*
+* - Connection answers an expired session with a 302 to the login screen, and `fetch` follows it,
+*   so the request resolves `200 text/html`.
+* - Without this the page reaches the caller as a string typed as the endpoint's DTO and fails much
+*   later, wherever the value is first read — an Immutable accessor on a string, modules away.
+* - The message stays constant so Sentry groups every occurrence together; `request` and `response`
+*   carry the per-request detail.
+* - Raised only by the clients that opt in: some APIs do serve HTML from a 200 on purpose.
+*/
+var HtmlResponseError = class extends ApiError {
+	constructor(res) {
+		super(res);
+		this.message = "Expected data, got an HTML page. The session has most likely expired.";
+	}
+};
+const isHtmlResponseError = (error) => error instanceof HtmlResponseError;
+//#endregion
+//#region src/clients/validateConnectionStatus.ts
+/**
+* Status validation for the APIs Connection serves off its own host — storage and auth.
+*
+* - Rejects a successful response carrying an HTML page; `HtmlResponseError` says why.
+* - HTML on a *failed* response is a real error page and stays an `ApiError`.
+* - Management answers the same condition with its own session-expiry error instead.
+*/
+const validateConnectionStatus = (apiResponse) => {
+	const isValid = defaultValidateStatus(apiResponse);
+	if (isValid && isHtmlResponse(apiResponse)) return new HtmlResponseError(apiResponse);
+	return isValid;
+};
+//#endregion
+export { HtmlResponseError as n, isHtmlResponseError as r, validateConnectionStatus as t };
+
+//# sourceMappingURL=validateConnectionStatus-BrLXkoSI.js.map

package/dist/validateConnectionStatus-BrLXkoSI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateConnectionStatus-BrLXkoSI.js","names":[],"sources":["../src/errors/HtmlResponseError.ts","../src/clients/validateConnectionStatus.ts"],"sourcesContent":["import type { ApiResponse } from '../fetchClient/createFetchClient/types';\n\nimport { ApiError } from './ApiError';\n\n/**\n * A successful response that carried an HTML page instead of the endpoint's payload.\n *\n * - Connection answers an expired session with a 302 to the login screen, and `fetch` follows it,\n *   so the request resolves `200 text/html`.\n * - Without this the page reaches the caller as a string typed as the endpoint's DTO and fails much\n *   later, wherever the value is first read — an Immutable accessor on a string, modules away.\n * - The message stays constant so Sentry groups every occurrence together; `request` and `response`\n *   carry the per-request detail.\n * - Raised only by the clients that opt in: some APIs do serve HTML from a 200 on purpose.\n */\nexport class HtmlResponseError extends ApiError {\n  constructor(res: ApiResponse) {\n    super(res);\n    this.message = 'Expected data, got an HTML page. The session has most likely expired.';\n  }\n}\n\nexport const isHtmlResponseError = (error: unknown): error is HtmlResponseError =>\n  error instanceof HtmlResponseError;\n","import { HtmlResponseError } from '../errors';\nimport { defaultValidateStatus, isHtmlResponse, type ValidateStatusFn } from '../fetchClient';\n\n/**\n * Status validation for the APIs Connection serves off its own host — storage and auth.\n *\n * - Rejects a successful response carrying an HTML page; `HtmlResponseError` says why.\n * - HTML on a *failed* response is a real error page and stays an `ApiError`.\n * - Management answers the same condition with its own session-expiry error instead.\n */\nexport const validateConnectionStatus: ValidateStatusFn = (apiResponse) => {\n  const isValid = defaultValidateStatus(apiResponse);\n\n  if (isValid && isHtmlResponse(apiResponse)) {\n    return new HtmlResponseError(apiResponse);\n  }\n\n  return isValid;\n};\n"],"mappings":";;;;;;;;;;;;;AAeA,IAAa,oBAAb,cAAuC,SAAS;CAC9C,YAAY,KAAkB;EAC5B,MAAM,GAAG;EACT,KAAK,UAAU;CACjB;AACF;AAEA,MAAa,uBAAuB,UAClC,iBAAiB;;;;;;;;;;ACbnB,MAAa,4BAA8C,gBAAgB;CACzE,MAAM,UAAU,sBAAsB,WAAW;CAEjD,IAAI,WAAW,eAAe,WAAW,GACvC,OAAO,IAAI,kBAAkB,WAAW;CAG1C,OAAO;AACT"}

package/dist/validateConnectionStatus-V9q6Nl6u.cjs

@@ -0,0 +1,55 @@
+const require_createFetchClient = require("./createFetchClient-BRfTjBLV.cjs");
+//#region src/errors/HtmlResponseError.ts
+/**
+* A successful response that carried an HTML page instead of the endpoint's payload.
+*
+* - Connection answers an expired session with a 302 to the login screen, and `fetch` follows it,
+*   so the request resolves `200 text/html`.
+* - Without this the page reaches the caller as a string typed as the endpoint's DTO and fails much
+*   later, wherever the value is first read — an Immutable accessor on a string, modules away.
+* - The message stays constant so Sentry groups every occurrence together; `request` and `response`
+*   carry the per-request detail.
+* - Raised only by the clients that opt in: some APIs do serve HTML from a 200 on purpose.
+*/
+var HtmlResponseError = class extends require_createFetchClient.ApiError {
+	constructor(res) {
+		super(res);
+		this.message = "Expected data, got an HTML page. The session has most likely expired.";
+	}
+};
+const isHtmlResponseError = (error) => error instanceof HtmlResponseError;
+//#endregion
+//#region src/clients/validateConnectionStatus.ts
+/**
+* Status validation for the APIs Connection serves off its own host — storage and auth.
+*
+* - Rejects a successful response carrying an HTML page; `HtmlResponseError` says why.
+* - HTML on a *failed* response is a real error page and stays an `ApiError`.
+* - Management answers the same condition with its own session-expiry error instead.
+*/
+const validateConnectionStatus = (apiResponse) => {
+	const isValid = require_createFetchClient.defaultValidateStatus(apiResponse);
+	if (isValid && require_createFetchClient.isHtmlResponse(apiResponse)) return new HtmlResponseError(apiResponse);
+	return isValid;
+};
+//#endregion
+Object.defineProperty(exports, "HtmlResponseError", {
+	enumerable: true,
+	get: function() {
+		return HtmlResponseError;
+	}
+});
+Object.defineProperty(exports, "isHtmlResponseError", {
+	enumerable: true,
+	get: function() {
+		return isHtmlResponseError;
+	}
+});
+Object.defineProperty(exports, "validateConnectionStatus", {
+	enumerable: true,
+	get: function() {
+		return validateConnectionStatus;
+	}
+});
+
+//# sourceMappingURL=validateConnectionStatus-V9q6Nl6u.cjs.map

package/dist/validateConnectionStatus-V9q6Nl6u.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateConnectionStatus-V9q6Nl6u.cjs","names":["ApiError","defaultValidateStatus","isHtmlResponse"],"sources":["../src/errors/HtmlResponseError.ts","../src/clients/validateConnectionStatus.ts"],"sourcesContent":["import type { ApiResponse } from '../fetchClient/createFetchClient/types';\n\nimport { ApiError } from './ApiError';\n\n/**\n * A successful response that carried an HTML page instead of the endpoint's payload.\n *\n * - Connection answers an expired session with a 302 to the login screen, and `fetch` follows it,\n *   so the request resolves `200 text/html`.\n * - Without this the page reaches the caller as a string typed as the endpoint's DTO and fails much\n *   later, wherever the value is first read — an Immutable accessor on a string, modules away.\n * - The message stays constant so Sentry groups every occurrence together; `request` and `response`\n *   carry the per-request detail.\n * - Raised only by the clients that opt in: some APIs do serve HTML from a 200 on purpose.\n */\nexport class HtmlResponseError extends ApiError {\n  constructor(res: ApiResponse) {\n    super(res);\n    this.message = 'Expected data, got an HTML page. The session has most likely expired.';\n  }\n}\n\nexport const isHtmlResponseError = (error: unknown): error is HtmlResponseError =>\n  error instanceof HtmlResponseError;\n","import { HtmlResponseError } from '../errors';\nimport { defaultValidateStatus, isHtmlResponse, type ValidateStatusFn } from '../fetchClient';\n\n/**\n * Status validation for the APIs Connection serves off its own host — storage and auth.\n *\n * - Rejects a successful response carrying an HTML page; `HtmlResponseError` says why.\n * - HTML on a *failed* response is a real error page and stays an `ApiError`.\n * - Management answers the same condition with its own session-expiry error instead.\n */\nexport const validateConnectionStatus: ValidateStatusFn = (apiResponse) => {\n  const isValid = defaultValidateStatus(apiResponse);\n\n  if (isValid && isHtmlResponse(apiResponse)) {\n    return new HtmlResponseError(apiResponse);\n  }\n\n  return isValid;\n};\n"],"mappings":";;;;;;;;;;;;;AAeA,IAAa,oBAAb,cAAuCA,0BAAAA,SAAS;CAC9C,YAAY,KAAkB;EAC5B,MAAM,GAAG;EACT,KAAK,UAAU;CACjB;AACF;AAEA,MAAa,uBAAuB,UAClC,iBAAiB;;;;;;;;;;ACbnB,MAAa,4BAA8C,gBAAgB;CACzE,MAAM,UAAUC,0BAAAA,sBAAsB,WAAW;CAEjD,IAAI,WAAWC,0BAAAA,eAAe,WAAW,GACvC,OAAO,IAAI,kBAAkB,WAAW;CAG1C,OAAO;AACT"}

package/dist/vault/index.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_UserError = require("../UserError-CSGO1qII.cjs");
-require("../createFetchClient-BsG719K1.cjs");
-const require_createGenericFetchClient = require("../createGenericFetchClient-DLbjX0eM.cjs");
-const require_createOpenapiFetchClient = require("../createOpenapiFetchClient-Cr90VXY4.cjs");
-const require_auth = require("../auth-5HCvCsZO.cjs");
+require("../createFetchClient-BRfTjBLV.cjs");
+const require_createGenericFetchClient = require("../createGenericFetchClient-DHs-i7_O.cjs");
+const require_createOpenapiFetchClient = require("../createOpenapiFetchClient-CyDUFxHB.cjs");
+const require_auth = require("../auth-DP-6TFiM.cjs");
 //#region src/clients/vault/vaultClient.ts
 const createVaultClient = ({ baseUrl, middlewares, auth }) => {
 	const client = require_createOpenapiFetchClient.createOpenapiFetchClient({

package/dist/vault/index.d.cts

@@ -1,2 +1,2 @@
-import { t as createVaultClient } from "../index-eEBVG5s3.cjs";
+import { t as createVaultClient } from "../index-C7e3wBt9.cjs";
 export { createVaultClient };

package/dist/vault/index.d.ts

@@ -1,2 +1,2 @@
-import { t as createVaultClient } from "../index-KKJkrxjx.js";
+import { t as createVaultClient } from "../index-Bc_hXWae.js";
 export { createVaultClient };

package/dist/vault/index.js

@@ -1,8 +1,8 @@
 import { t as UserError } from "../UserError-By_Zckmc.js";
-import "../createFetchClient-BK0TZK-U.js";
-import { t as createGenericFetchClient } from "../createGenericFetchClient-CVZYekDk.js";
-import { t as createOpenapiFetchClient } from "../createOpenapiFetchClient-B5U1fCHS.js";
-import { t as createAuthHeaders } from "../auth-D2jfNlpX.js";
+import "../createFetchClient-BbG46bL0.js";
+import { t as createGenericFetchClient } from "../createGenericFetchClient-BHYQLZhe.js";
+import { t as createOpenapiFetchClient } from "../createOpenapiFetchClient-Bn6_Pn0H.js";
+import { t as createAuthHeaders } from "../auth-DtbQaeDj.js";
 //#region src/clients/vault/vaultClient.ts
 const createVaultClient = ({ baseUrl, middlewares, auth }) => {
 	const client = createOpenapiFetchClient({

package/dist/vault/types.d.cts

@@ -1,2 +1,2 @@
-import { a as GetVariablesQuery, i as GetVariablesByBranchId, n as CreateVariableBody, o as VariableWithHash, r as DeleteVariablePath, t as AnyVariable } from "../types-CyRK5z-E.cjs";
+import { a as GetVariablesQuery, i as GetVariablesByBranchId, n as CreateVariableBody, o as VariableWithHash, r as DeleteVariablePath, t as AnyVariable } from "../types-CJHi0zdD.cjs";
 export { AnyVariable, CreateVariableBody, DeleteVariablePath, GetVariablesByBranchId, GetVariablesQuery, VariableWithHash };

package/dist/vault/types.d.ts

@@ -1,2 +1,2 @@
-import { a as GetVariablesQuery, i as GetVariablesByBranchId, n as CreateVariableBody, o as VariableWithHash, r as DeleteVariablePath, t as AnyVariable } from "../types-CjAia48k.js";
+import { a as GetVariablesQuery, i as GetVariablesByBranchId, n as CreateVariableBody, o as VariableWithHash, r as DeleteVariablePath, t as AnyVariable } from "../types-D-qI9ne4.js";
 export { AnyVariable, CreateVariableBody, DeleteVariablePath, GetVariablesByBranchId, GetVariablesQuery, VariableWithHash };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keboola/api-client",
-  "version": "29.0.0",
+  "version": "32.0.0",
   "description": "TypeScript SDK for Keboola APIs",
   "license": "MIT",
   "type": "module",
@@ -10,6 +10,7 @@
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "AGENTS.md",
     "API-SURFACE.md",
     "surface"
@@ -76,6 +77,12 @@
       "import": [
         "./dist/import/index.d.ts"
       ],
+      "kaiAgent": [
+        "./dist/kaiAgent/index.d.ts"
+      ],
+      "kaiAgent/types": [
+        "./dist/kaiAgent/types.d.ts"
+      ],
       "management": [
         "./dist/management/index.d.ts"
       ],
@@ -88,6 +95,12 @@
       "metastore/types": [
         "./dist/metastore/types.d.ts"
       ],
+      "microsoftGraph": [
+        "./dist/microsoftGraph/index.d.ts"
+      ],
+      "microsoftGraph/types": [
+        "./dist/microsoftGraph/types.d.ts"
+      ],
       "notifications": [
         "./dist/notifications/index.d.ts"
       ],
@@ -423,6 +436,26 @@
         "default": "./dist/import/index.cjs"
       }
     },
+    "./kaiAgent": {
+      "import": {
+        "types": "./dist/kaiAgent/index.d.ts",
+        "default": "./dist/kaiAgent/index.js"
+      },
+      "require": {
+        "types": "./dist/kaiAgent/index.d.cts",
+        "default": "./dist/kaiAgent/index.cjs"
+      }
+    },
+    "./kaiAgent/types": {
+      "import": {
+        "types": "./dist/kaiAgent/types.d.ts",
+        "default": "./dist/kaiAgent/types.js"
+      },
+      "require": {
+        "types": "./dist/kaiAgent/types.d.cts",
+        "default": "./dist/kaiAgent/types.cjs"
+      }
+    },
     "./management": {
       "import": {
         "types": "./dist/management/index.d.ts",
@@ -463,6 +496,26 @@
         "default": "./dist/metastore/types.cjs"
       }
     },
+    "./microsoftGraph": {
+      "import": {
+        "types": "./dist/microsoftGraph/index.d.ts",
+        "default": "./dist/microsoftGraph/index.js"
+      },
+      "require": {
+        "types": "./dist/microsoftGraph/index.d.cts",
+        "default": "./dist/microsoftGraph/index.cjs"
+      }
+    },
+    "./microsoftGraph/types": {
+      "import": {
+        "types": "./dist/microsoftGraph/types.d.ts",
+        "default": "./dist/microsoftGraph/types.js"
+      },
+      "require": {
+        "types": "./dist/microsoftGraph/types.d.cts",
+        "default": "./dist/microsoftGraph/types.cjs"
+      }
+    },
     "./notifications": {
       "import": {
         "types": "./dist/notifications/index.d.ts",
@@ -854,12 +907,12 @@
     "vite": "^8.1.5",
     "vitest": "^4.1.10",
     "yaml": "^2.8.3",
-    "@keboola/oxlint-config": "^10.0.1",
-    "@keboola/tsconfig": "^0.2.0",
+    "@keboola/oxlint-config": "^10.0.2",
+    "@keboola/tsconfig": "^0.2.1",
     "@keboola/vitest-config": "^1.0.0"
   },
   "scripts": {
-    "gen:types": "openapi-typescript --export-type",
+    "gen:types": "node scripts/gen-types.mjs",
     "type-check": "tsc",
     "lint": "pnpm lint:format && pnpm lint:oxlint",
     "lint:fix": "oxlint --fix . && oxfmt",

package/surface/auth.md

@@ -15,8 +15,8 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 ### `api.auth.login`
 
 - `api.auth.login.methods(signal?: AbortSignal | undefined): Promise<{ methods: ({ type: "password"; passwordResetEnabled: boolean; } | { type: "oidc"; provider: "google" | "microsoft"; clientId: string; } | { type: "saml"; customerSlug: string | null; displayName: string; })[]; restriction: "ssoEnforced" | "stackSsoOnly" | null; emailDiscoveryEnabled: boolean; signUpUrl: string | null; }>`
-- `api.auth.login.withOidc(input: { grantType: "google" | "microsoft"; idToken: string; }, signal?: AbortSignal | undefined): Promise<{ mfaRequired: false; accessToken: string; refreshToken: string; tokenType: string; expiresIn: number; sessionId: string; user: { id: number; email: string; name: string; }; } | { mfaRequired: true; mfaType: string; mfaToken: string; expiresIn: number; allowedMethods: string[]; }>`
-- `api.auth.login.withPassword(input: { email: string; password: string; }, signal?: AbortSignal | undefined): Promise<{ mfaRequired: false; accessToken: string; refreshToken: string; tokenType: string; expiresIn: number; sessionId: string; user: { id: number; email: string; name: string; }; } | { mfaRequired: true; mfaType: string; mfaToken: string; expiresIn: number; allowedMethods: string[]; }>`
+- `api.auth.login.withOidc(input: { grantType: "google" | "microsoft"; idToken: string; }, signal?: AbortSignal | undefined): Promise<{ mfaRequired: false; accessToken: string; refreshToken: string; tokenType: string; expiresIn: number; sessionId: string; user: { id: number; email: string; name: string; }; } | { mfaRequired: true; mfaType: string; mfaToken: string; expiresIn: number; allowedMethods: string[]; webauthn?: unknown; }>`
+- `api.auth.login.withPassword(input: { email: string; password: string; }, signal?: AbortSignal | undefined): Promise<{ mfaRequired: false; accessToken: string; refreshToken: string; tokenType: string; expiresIn: number; sessionId: string; user: { id: number; email: string; name: string; }; } | { mfaRequired: true; mfaType: string; mfaToken: string; expiresIn: number; allowedMethods: string[]; webauthn?: unknown; }>`
 
 ### `api.auth.mfa`
 
@@ -68,3 +68,10 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 - `api.auth.token.introspect(token?: string | undefined, signal?: AbortSignal | undefined): Promise<{ sessionId: string; user: { id: number; email: string; name: string; }; grantType: string; sudoVerified: boolean; createdAt: string; expiresAt: string; lastUsedAt?: string | null | undefined; lastUsedIp?: string | null | undefined; userAgent?: string | null | undefined; projects: { id: number; name: string | null; role: string | null; }[]; }>`
 - `api.auth.token.refresh(refreshToken: string, signal?: AbortSignal | undefined): Promise<{ accessToken: string; refreshToken: string; tokenType: string; expiresIn: number; sessionId: string; user: { id: number; email: string; name: string; }; }>`
 - `api.auth.token.revoke(body: { token: string; tokenTypeHint: "accessToken" | "refreshToken" | null; }, signal?: AbortSignal | undefined): Promise<void>`
+
+### `api.auth.webauthn`
+
+- `api.auth.webauthn.getAll(signal?: AbortSignal | undefined): Promise<{ webauthnCredentials?: { id: number; deviceName: string; created: string; }[] | undefined; }>`
+- `api.auth.webauthn.register({ credential, deviceName, revokeOtherSessions }: RegisterWebauthnInput, signal?: AbortSignal | undefined): Promise<{ id: number; deviceName: string; created: string; recoveryCodes?: string[] | null | undefined; }>`
+- `api.auth.webauthn.registerOptions(signal?: AbortSignal | undefined): Promise<RegisterWebauthnOptionsResult>`
+- `api.auth.webauthn.remove({ id, ...query }: RemoveWebauthnInput, signal?: AbortSignal | undefined): Promise<void>`

package/surface/chat.md

@@ -7,7 +7,7 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 - `api.chat.createChat(request: { id: string; message: { id: string; role: "user" | "assistant"; parts: ({ type: "text"; text: string; state?: "done" | undefined; } | { type: "tool-result"; toolCallId: string; toolName: string; result: string; } | { type: "step-start"; } | { type: string; toolCallId: string; state: "output-available" | "output-error" | "output-denied" | "input-available" | "input-streaming" | "approval-requested" | "approval-responded"; input?: { [key: string]: unknown; } | undefined; output?: unknown; errorText?: string | undefined; approval?: { id?: string | undefined; approved?: boolean | undefined; reason?: string | undefined; } | undefined; })[]; metadata?: { createdAt?: string | undefined; hidden?: boolean | undefined; requestContext?: { path?: string | undefined; sqlEditorActive?: boolean | undefined; } | undefined; compactedTo?: string | undefined; compactedFrom?: string | undefined; } | undefined; status?: "completed" | "failed" | "pending" | "interrupted" | undefined; }; selectedChatModel: "chat-model" | "chat-model-reasoning"; selectedVisibilityType: "public" | "private"; branchId?: number | undefined; telemetryMetadata?: { [key: string]: string | number | boolean; } | undefined; }): Promise<Response>`
 - `api.chat.deleteChat(chatId: string): Promise<{ id: string; title: string; userId: string; createdAt: string; lastMessageAt: string; visibility: "public" | "private"; branchId?: number | null | undefined; }>`
 - `api.chat.getAgentSettings(signal?: AbortSignal | undefined): Promise<{ projectId: string; customInstructions: string | null; createdAt: string; updatedAt: string; }>`
-- `api.chat.getChat(chatId: string, signal?: AbortSignal | undefined): Promise<{ id: string; title: string; userId: string; createdAt: string; lastMessageAt: string; visibility: "public" | "private"; branchId?: number | null | undefined; contextWindow?: { usedTokens: number; maxTokens: number; percentage: number; } | null | undefined; messages: { id: string; role: "user" | "assistant"; parts: ({ type: "text"; text: string; state?: "done" | undefined; } | { type: "tool-result"; toolCallId: string; toolName: string; result: string; } | { type: "step-start"; } | { type: string; toolCallId: string; state: "output-available" | "output-error" | "output-denied" | "input-available" | "input-streaming" | "approval-requested" | "approval-responded"; input?: { [key: string]: unknown; } | undefined; output?: unknown; errorText?: string | undefined; approval?: { id?: string | undefined; approved?: boolean | undefined; reason?: string | undefined; } | undefined; })[]; metadata?: { createdAt?: string | undefined; hidden?: boolean | undefined; requestContext?: { path?: string | undefined; sqlEditorActive?: boolean | undefined; } | undefined; compactedTo?: string | undefined; compactedFrom?: string | undefined; } | undefined; status?: "completed" | "failed" | "pending" | "interrupted" | undefined; }[]; }>`
+- `api.chat.getChat(chatId: string, signal?: AbortSignal | undefined): Promise<{ id: string; title: string; userId: string; createdAt: string; lastMessageAt: string; visibility: "public" | "private"; branchId?: number | null | undefined; messages: { id: string; role: "user" | "assistant"; parts: ({ type: "text"; text: string; state?: "done" | undefined; } | { type: "tool-result"; toolCallId: string; toolName: string; result: string; } | { type: "step-start"; } | { type: string; toolCallId: string; state: "output-available" | "output-error" | "output-denied" | "input-available" | "input-streaming" | "approval-requested" | "approval-responded"; input?: { [key: string]: unknown; } | undefined; output?: unknown; errorText?: string | undefined; approval?: { id?: string | undefined; approved?: boolean | undefined; reason?: string | undefined; } | undefined; })[]; metadata?: { createdAt?: string | undefined; hidden?: boolean | undefined; requestContext?: { path?: string | undefined; sqlEditorActive?: boolean | undefined; } | undefined; compactedTo?: string | undefined; compactedFrom?: string | undefined; } | undefined; status?: "completed" | "failed" | "pending" | "interrupted" | undefined; }[]; }>`
 - `api.chat.getHistory(params?: { limit?: number | undefined; starting_after?: string | undefined; ending_before?: string | undefined; } | undefined): Promise<{ chats: { id: string; title: string; userId: string; createdAt: string; lastMessageAt: string; visibility: "public" | "private"; branchId?: number | null | undefined; }[]; hasMore: boolean; }>`
 - `api.chat.getSuggestions(request: { context: "dashboard"; data: { recentFailedJobs: { id: string; status: "error" | "warning"; component: string; configId: string; createdTime: string; configName?: string | undefined; durationSeconds?: number | undefined; errorMessage?: string | undefined; }[]; deprecatedComponents: { id: string; name: string; type: string; expiredOn: string; configCount: number; }[]; userRecentEdits: { component: string; configId: string; configName: string; lastEdited: string; }[]; currentUserEmail: string; }; } | { context: "job-detail"; data: { job: { id: string; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; component: string; createdTime: string; configId?: string | undefined; configName?: string | undefined; startTime?: string | undefined; endTime?: string | undefined; durationSeconds?: number | undefined; errorMessage?: string | undefined; errorType?: "user" | "application" | undefined; backendSize?: string | undefined; }; currentUserEmail: string; component?: { id: string; name: string; type: string; } | undefined; runtimeHistory?: { recentJobsCount: number; averageDurationSeconds?: number | undefined; minDurationSeconds?: number | undefined; maxDurationSeconds?: number | undefined; isSlowerThanAverage?: boolean | undefined; isFasterThanAverage?: boolean | undefined; percentageDifference?: number | undefined; } | undefined; }; } | { context: "configuration-detail"; data: { configuration: { id: string; name: string; component: string; hasRows: boolean; description?: string | undefined; rowCount?: number | undefined; lastChangeDescription?: string | undefined; }; currentUserEmail: string; component?: { id: string; name: string; type: string; } | undefined; latestJobs?: { id: string; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; createdTime: string; durationSeconds?: number | undefined; errorMessage?: string | undefined; }[] | undefined; }; }, signal?: AbortSignal | undefined): Promise<{ suggestions: { label: string; prompt: string; priority: number; category: "error" | "maintenance" | "documentation"; reasoning: string; id: string; }[]; suggestionSessionId: string; }>`
 - `api.chat.getToolsList(signal?: AbortSignal | undefined): Promise<{ tools: { name: string; description: string; readOnly: boolean; }[]; }>`

package/surface/kaiAgent.md

@@ -7,6 +7,7 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 - `api.kaiAgent.approveToolCall(chatId: string, body: { toolUseId: string; approved: boolean; reason?: string | undefined; updatedInput?: { [key: string]: unknown; } | undefined; answers?: { [key: string]: string; } | undefined; }): Promise<void>`
 - `api.kaiAgent.createChat(request: { id: string; message: { id: string; role: "user" | "assistant"; parts: { [key: string]: unknown; }[]; metadata?: { hidden?: boolean | undefined; requestContext?: { path?: string | undefined; sqlEditorActive?: boolean | undefined; } | undefined; tableContext?: { tableName: string; tableId: string; bucketId: string; fileName: string; }[] | undefined; } | undefined; }; selectedChatModel?: string | undefined; selectedVisibilityType?: "public" | "private" | undefined; branchId?: number | undefined; toolRestrictions?: { allowedTools?: string[] | undefined; disallowedTools?: string[] | undefined; readOnlyMode?: boolean | undefined; } | undefined; telemetryMetadata?: { [key: string]: string | number | boolean; } | undefined; supportsApprovalRequestedEvent?: boolean | undefined; }): Promise<Response>`
 - `api.kaiAgent.deleteChat(chatId: string): Promise<{ id?: string | undefined; title?: string | undefined; userId?: string | undefined; createdAt?: string | undefined; visibility?: "public" | "private" | undefined; branchId?: number | null | undefined; }>`
+- `api.kaiAgent.downloadSandboxFile(chatId: string, path: string, signal?: AbortSignal | undefined): Promise<Blob>`
 - `api.kaiAgent.getAgentSettings(signal?: AbortSignal | undefined): Promise<{ projectId: string; customInstructions: string | null; createdAt: string; updatedAt: string; }>`
 - `api.kaiAgent.getChat(chatId: string, signal?: AbortSignal | undefined): Promise<{ id: string; title: string; userId: string; createdAt: string; lastMessageAt: string; visibility: "public" | "private"; branchId?: number | null | undefined; contextWindow?: { usedTokens: number; maxTokens: number; percentage: number; } | null | undefined; messages: { id: string; role: "user" | "assistant"; parts: ({ type: "text"; text: string; state?: "done" | undefined; } | { type: "tool-result"; toolCallId: string; toolName: string; result: string; } | { type: "step-start"; } | { type: "data-compact-boundary"; data: { trigger: "manual" | "auto"; preTokens: number; preservedSegment?: { headUuid: string; anchorUuid: string; tailUuid: string; } | undefined; summary: string; sdkSessionId: string; }; } | { type: string; toolCallId: string; state: "output-available" | "output-error" | "output-denied" | "input-available" | "input-streaming" | "approval-requested" | "approval-responded"; input?: { [key: string]: unknown; } | undefined; output?: unknown; errorText?: string | undefined; approval?: { id: string; approved: boolean; reason?: string | undefined; } | undefined; })[]; metadata?: { createdAt?: string | undefined; hidden?: boolean | undefined; requestContext?: { path?: string | undefined; sqlEditorActive?: boolean | undefined; } | undefined; } | undefined; status?: "completed" | "failed" | "pending" | "interrupted" | undefined; }[]; }>`
 - `api.kaiAgent.getHistory(params?: { limit?: number | undefined; starting_after?: string | undefined; ending_before?: string | undefined; } | undefined): Promise<{ chats: { id?: string | undefined; title?: string | undefined; userId?: string | undefined; createdAt?: string | undefined; lastMessageAt?: string | undefined; visibility?: "public" | "private" | undefined; branchId?: number | null | undefined; }[]; hasMore: boolean; }>`

package/surface/sdk.md

@@ -41,9 +41,9 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 - `api.sdk.storage.exportToFile(tableId: string, body?: TableExportAsyncBody | undefined, options?: Options | undefined): Promise<TableExportJob>`
 - `api.sdk.storage.forceUnlinkBucket(input: ForceUnlinkBucketInput, options?: Options | undefined): Promise<ForceUnlinkBucketJob>`
 - `api.sdk.storage.importFromFile(input: ImportAsyncInput, options?: Options | undefined): Promise<TableImportJob>`
-- `api.sdk.storage.pullTable(input: { branchId: string; id: string; }, options?: Options | undefined): Promise<PullTableJob>`
+- `api.sdk.storage.pullTable(input: PullTableAsyncPath, options?: Options | undefined): Promise<PullTableJob>`
 - `api.sdk.storage.refreshExternalBucket(bucketId: string, query?: RefreshExternalBucketQuery | undefined, options?: Options | undefined): Promise<RefreshBucketJob>`
-- `api.sdk.storage.registerBucket(body: RegisterBucketBody, options?: Options | undefined): Promise<RegisterBucketJob>`
+- `api.sdk.storage.registerBucket(body: { name: string; displayName?: string | null | undefined; stage: "out" | "in" | "sys"; backend?: "snowflake" | "bigquery" | null | undefined; description?: string | null | undefined; path: string[]; isSnowflakeSharedDatabase: boolean; }, options?: Options | undefined): Promise<RegisterBucketJob>`
 - `api.sdk.storage.removeTablePrimaryKey(input: { tableId: string; branchId: string; }, options?: Options | undefined): Promise<RemoveTablePrimaryKeyJob>`
 - `api.sdk.storage.shareBucketToOrganization(input: { bucketId: string; branchId: string; }, options?: Options | undefined): Promise<ShareBucketToOrganizationJob>`
 - `api.sdk.storage.shareBucketToOrganizationProject(input: { bucketId: string; branchId: string; }, options?: Options | undefined): Promise<ShareBucketToOrganizationProjectJob>`
@@ -66,8 +66,8 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 
 ### `api.sdk.variables`
 
-- `api.sdk.variables.copy({ variablesId, variablesValuesId, branchId, }: { variablesId: string; variablesValuesId?: string | undefined; branchId?: BranchId | undefined; }): Promise<VariablesRef>`
-- `api.sdk.variables.merge({ targetVariablesId, targetValuesId, sourceVariablesId, sourceValuesId, branchId, }: { targetVariablesId: string; targetValuesId?: string | undefined; sourceVariablesId: string; sourceValuesId?: string | undefined; branchId?: BranchId | undefined; }): Promise<VariablesRef>`
+- `api.sdk.variables.copy({ variablesId, variablesValuesId, branchId, }: { variablesId: string; variablesValuesId?: string | undefined; branchId?: string | undefined; }): Promise<VariablesRef>`
+- `api.sdk.variables.merge({ targetVariablesId, targetValuesId, sourceVariablesId, sourceValuesId, branchId, }: { targetVariablesId: string; targetValuesId?: string | undefined; sourceVariablesId: string; sourceValuesId?: string | undefined; branchId?: string | undefined; }): Promise<VariablesRef>`
 
 ### `api.sdk.vault`