@keboola/api-client 55.0.0 → 57.0.0

package/dist/validateConnectionStatus-DgJwuEy9.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateConnectionStatus-DgJwuEy9.js","names":[],"sources":["../src/errors/HtmlResponseError.ts","../src/utils/async/collectByCursor.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 * - An expired session 302s to the login page; `fetch` follows it to `200 text/html`.\n * - Constant message so Sentry groups it; `request`/`response` carry the detail.\n * - Opt-in per client: some APIs serve HTML from a 200 on purpose.\n */\nexport class HtmlResponseError extends ApiError {\n  constructor(res: ApiResponse) {\n    super(res);\n    this.name = 'HtmlResponseError';\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 { createAbortError } from '../createAbortError';\n\n/** One page of a cursor-paginated collection (`data` / `meta` / `links` envelope). */\nexport type CursorPage<T> = { data: T[]; links: { next: string | null } };\n\nexport type CollectByCursorOptions<T> = {\n  fetchFrom: (\n    after: string | undefined,\n    pageSize?: number,\n    signal?: AbortSignal,\n  ) => Promise<CursorPage<T>>;\n  pageSize?: number;\n  limit?: number;\n  signal?: AbortSignal;\n};\n\n/**\n * The `page[after]` cursor `links.next` carries; `undefined` on the last page.\n *\n * - Read from the link, not rebuilt from the last row, so the encoding stays the server's.\n * - Only the query is parsed, so a relative link works too.\n */\nexport const nextCursorOf = (next: string | null): string | undefined => {\n  if (next === null) return undefined;\n  const queryStart = next.indexOf('?');\n  if (queryStart === -1) return undefined;\n  const query = next.slice(queryStart + 1).split('#')[0];\n  return new URLSearchParams(query).get('page[after]') ?? undefined;\n};\n\n/**\n * Walks a cursor-paginated endpoint and yields each page's items as it arrives — up to `limit`, or all when it is omitted.\n *\n * - Calls `fetchFrom` sequentially with the cursor each `links.next` carries, and hands it `pageSize`.\n * - Ends on a `null` `links.next`, or on a link without a `page[after]`.\n * - A cursor seen before means the server is looping; the walk throws rather than spin.\n * - Stopping the iteration (`break`, `return`) requests no further page.\n */\nexport async function* iterateByCursor<T>({\n  fetchFrom,\n  pageSize,\n  limit,\n  signal,\n}: CollectByCursorOptions<T>): AsyncGenerator<T[], void, undefined> {\n  if (signal?.aborted) throw createAbortError(signal.reason);\n  if (limit !== undefined && limit < 0) throw new Error('Invalid collectByCursor limit');\n  if (pageSize !== undefined && pageSize < 1) throw new Error('Invalid collectByCursor pageSize');\n\n  if (limit === 0) return;\n\n  let after: string | undefined;\n  let count = 0;\n  const seen = new Set<string>();\n\n  do {\n    const page = await fetchFrom(after, pageSize, signal);\n\n    if (limit !== undefined && count + page.data.length >= limit) {\n      yield page.data.slice(0, limit - count);\n      return;\n    }\n\n    count += page.data.length;\n    yield page.data;\n\n    after = nextCursorOf(page.links.next);\n    if (after !== undefined) {\n      if (seen.has(after)) {\n        throw new Error(`collectByCursor: links.next repeats the cursor ${after}`);\n      }\n      seen.add(after);\n    }\n  } while (after !== undefined);\n}\n\n/** Collects every item `iterateByCursor` yields into one array; see it for paging, `limit` and abort. */\nexport const collectByCursor = async <T>(options: CollectByCursorOptions<T>): Promise<T[]> => {\n  const items: T[] = [];\n  for await (const page of iterateByCursor(options)) items.push(...page);\n  return items;\n};\n","import { HtmlResponseError } from '../errors';\nimport { defaultValidateStatus, type ValidateStatusFn } from '../fetchClient';\n\nimport { isLoginPageRedirect } from './isLoginPageRedirect';\n\n/**\n * Status validation for the APIs Connection serves off its own host — storage and auth.\n *\n * - Rejects a successful login 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 && isLoginPageRedirect(apiResponse)) {\n    return new HtmlResponseError(apiResponse);\n  }\n\n  return isValid;\n};\n"],"mappings":";;;;;;;;;;;AAWA,IAAa,oBAAb,cAAuC,SAAS;CAC9C,YAAY,KAAkB;EAC5B,MAAM,GAAG;EACT,KAAK,OAAO;EACZ,KAAK,UAAU;CACjB;AACF;AAEA,MAAa,uBAAuB,UAClC,iBAAiB;;;;;;;;ACEnB,MAAa,gBAAgB,SAA4C;CACvE,IAAI,SAAS,MAAM,OAAO,KAAA;CAC1B,MAAM,aAAa,KAAK,QAAQ,GAAG;CACnC,IAAI,eAAe,IAAI,OAAO,KAAA;CAC9B,MAAM,QAAQ,KAAK,MAAM,aAAa,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;CACpD,OAAO,IAAI,gBAAgB,KAAK,CAAC,CAAC,IAAI,aAAa,KAAK,KAAA;AAC1D;;;;;;;;;AAUA,gBAAuB,gBAAmB,EACxC,WACA,UACA,OACA,UACkE;CAClE,IAAI,QAAQ,SAAS,MAAM,iBAAiB,OAAO,MAAM;CACzD,IAAI,UAAU,KAAA,KAAa,QAAQ,GAAG,MAAM,IAAI,MAAM,+BAA+B;CACrF,IAAI,aAAa,KAAA,KAAa,WAAW,GAAG,MAAM,IAAI,MAAM,kCAAkC;CAE9F,IAAI,UAAU,GAAG;CAEjB,IAAI;CACJ,IAAI,QAAQ;CACZ,MAAM,uBAAO,IAAI,IAAY;CAE7B,GAAG;EACD,MAAM,OAAO,MAAM,UAAU,OAAO,UAAU,MAAM;EAEpD,IAAI,UAAU,KAAA,KAAa,QAAQ,KAAK,KAAK,UAAU,OAAO;GAC5D,MAAM,KAAK,KAAK,MAAM,GAAG,QAAQ,KAAK;GACtC;EACF;EAEA,SAAS,KAAK,KAAK;EACnB,MAAM,KAAK;EAEX,QAAQ,aAAa,KAAK,MAAM,IAAI;EACpC,IAAI,UAAU,KAAA,GAAW;GACvB,IAAI,KAAK,IAAI,KAAK,GAChB,MAAM,IAAI,MAAM,kDAAkD,OAAO;GAE3E,KAAK,IAAI,KAAK;EAChB;CACF,SAAS,UAAU,KAAA;AACrB;;AAGA,MAAa,kBAAkB,OAAU,YAAqD;CAC5F,MAAM,QAAa,CAAC;CACpB,WAAW,MAAM,QAAQ,gBAAgB,OAAO,GAAG,MAAM,KAAK,GAAG,IAAI;CACrE,OAAO;AACT;;;;;;;;;ACpEA,MAAa,4BAA8C,gBAAgB;CACzE,MAAM,UAAU,sBAAsB,WAAW;CAEjD,IAAI,WAAW,oBAAoB,WAAW,GAC5C,OAAO,IAAI,kBAAkB,WAAW;CAG1C,OAAO;AACT"}

package/dist/validateConnectionStatus-DpYRsU-e.cjs

@@ -0,0 +1,121 @@
+const require_createFetchClient = require("./createFetchClient-CDKSkd7i.cjs");
+const require_createAbortError = require("./createAbortError-Dzc9yObN.cjs");
+const require_isLoginPageRedirect = require("./isLoginPageRedirect-DUmsOC2o.cjs");
+// src/errors/HtmlResponseError.ts
+/**
+* A successful response that carried an HTML page instead of the endpoint's payload.
+*
+* - An expired session 302s to the login page; `fetch` follows it to `200 text/html`.
+* - Constant message so Sentry groups it; `request`/`response` carry the detail.
+* - Opt-in per client: some APIs serve HTML from a 200 on purpose.
+*/
+var HtmlResponseError = class extends require_createFetchClient.ApiError {
+	constructor(res) {
+		super(res);
+		this.name = "HtmlResponseError";
+		this.message = "Expected data, got an HTML page. The session has most likely expired.";
+	}
+};
+const isHtmlResponseError = (error) => error instanceof HtmlResponseError;
+// src/utils/async/collectByCursor.ts
+/**
+* The `page[after]` cursor `links.next` carries; `undefined` on the last page.
+*
+* - Read from the link, not rebuilt from the last row, so the encoding stays the server's.
+* - Only the query is parsed, so a relative link works too.
+*/
+const nextCursorOf = (next) => {
+	if (next === null) return void 0;
+	const queryStart = next.indexOf("?");
+	if (queryStart === -1) return void 0;
+	const query = next.slice(queryStart + 1).split("#")[0];
+	return new URLSearchParams(query).get("page[after]") ?? void 0;
+};
+/**
+* Walks a cursor-paginated endpoint and yields each page's items as it arrives — up to `limit`, or all when it is omitted.
+*
+* - Calls `fetchFrom` sequentially with the cursor each `links.next` carries, and hands it `pageSize`.
+* - Ends on a `null` `links.next`, or on a link without a `page[after]`.
+* - A cursor seen before means the server is looping; the walk throws rather than spin.
+* - Stopping the iteration (`break`, `return`) requests no further page.
+*/
+async function* iterateByCursor({ fetchFrom, pageSize, limit, signal }) {
+	if (signal?.aborted) throw require_createAbortError.createAbortError(signal.reason);
+	if (limit !== void 0 && limit < 0) throw new Error("Invalid collectByCursor limit");
+	if (pageSize !== void 0 && pageSize < 1) throw new Error("Invalid collectByCursor pageSize");
+	if (limit === 0) return;
+	let after;
+	let count = 0;
+	const seen = /* @__PURE__ */ new Set();
+	do {
+		const page = await fetchFrom(after, pageSize, signal);
+		if (limit !== void 0 && count + page.data.length >= limit) {
+			yield page.data.slice(0, limit - count);
+			return;
+		}
+		count += page.data.length;
+		yield page.data;
+		after = nextCursorOf(page.links.next);
+		if (after !== void 0) {
+			if (seen.has(after)) throw new Error(`collectByCursor: links.next repeats the cursor ${after}`);
+			seen.add(after);
+		}
+	} while (after !== void 0);
+}
+/** Collects every item `iterateByCursor` yields into one array; see it for paging, `limit` and abort. */
+const collectByCursor = async (options) => {
+	const items = [];
+	for await (const page of iterateByCursor(options)) items.push(...page);
+	return items;
+};
+// src/clients/validateConnectionStatus.ts
+/**
+* Status validation for the APIs Connection serves off its own host — storage and auth.
+*
+* - Rejects a successful login 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_isLoginPageRedirect.isLoginPageRedirect(apiResponse)) return new HtmlResponseError(apiResponse);
+	return isValid;
+};
+Object.defineProperty(exports, "HtmlResponseError", {
+	enumerable: true,
+	get: function() {
+		return HtmlResponseError;
+	}
+});
+Object.defineProperty(exports, "collectByCursor", {
+	enumerable: true,
+	get: function() {
+		return collectByCursor;
+	}
+});
+Object.defineProperty(exports, "isHtmlResponseError", {
+	enumerable: true,
+	get: function() {
+		return isHtmlResponseError;
+	}
+});
+Object.defineProperty(exports, "iterateByCursor", {
+	enumerable: true,
+	get: function() {
+		return iterateByCursor;
+	}
+});
+Object.defineProperty(exports, "nextCursorOf", {
+	enumerable: true,
+	get: function() {
+		return nextCursorOf;
+	}
+});
+Object.defineProperty(exports, "validateConnectionStatus", {
+	enumerable: true,
+	get: function() {
+		return validateConnectionStatus;
+	}
+});
+
+//# sourceMappingURL=validateConnectionStatus-DpYRsU-e.cjs.map

package/dist/validateConnectionStatus-DpYRsU-e.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateConnectionStatus-DpYRsU-e.cjs","names":["ApiError","createAbortError","defaultValidateStatus","isLoginPageRedirect"],"sources":["../src/errors/HtmlResponseError.ts","../src/utils/async/collectByCursor.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 * - An expired session 302s to the login page; `fetch` follows it to `200 text/html`.\n * - Constant message so Sentry groups it; `request`/`response` carry the detail.\n * - Opt-in per client: some APIs serve HTML from a 200 on purpose.\n */\nexport class HtmlResponseError extends ApiError {\n  constructor(res: ApiResponse) {\n    super(res);\n    this.name = 'HtmlResponseError';\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 { createAbortError } from '../createAbortError';\n\n/** One page of a cursor-paginated collection (`data` / `meta` / `links` envelope). */\nexport type CursorPage<T> = { data: T[]; links: { next: string | null } };\n\nexport type CollectByCursorOptions<T> = {\n  fetchFrom: (\n    after: string | undefined,\n    pageSize?: number,\n    signal?: AbortSignal,\n  ) => Promise<CursorPage<T>>;\n  pageSize?: number;\n  limit?: number;\n  signal?: AbortSignal;\n};\n\n/**\n * The `page[after]` cursor `links.next` carries; `undefined` on the last page.\n *\n * - Read from the link, not rebuilt from the last row, so the encoding stays the server's.\n * - Only the query is parsed, so a relative link works too.\n */\nexport const nextCursorOf = (next: string | null): string | undefined => {\n  if (next === null) return undefined;\n  const queryStart = next.indexOf('?');\n  if (queryStart === -1) return undefined;\n  const query = next.slice(queryStart + 1).split('#')[0];\n  return new URLSearchParams(query).get('page[after]') ?? undefined;\n};\n\n/**\n * Walks a cursor-paginated endpoint and yields each page's items as it arrives — up to `limit`, or all when it is omitted.\n *\n * - Calls `fetchFrom` sequentially with the cursor each `links.next` carries, and hands it `pageSize`.\n * - Ends on a `null` `links.next`, or on a link without a `page[after]`.\n * - A cursor seen before means the server is looping; the walk throws rather than spin.\n * - Stopping the iteration (`break`, `return`) requests no further page.\n */\nexport async function* iterateByCursor<T>({\n  fetchFrom,\n  pageSize,\n  limit,\n  signal,\n}: CollectByCursorOptions<T>): AsyncGenerator<T[], void, undefined> {\n  if (signal?.aborted) throw createAbortError(signal.reason);\n  if (limit !== undefined && limit < 0) throw new Error('Invalid collectByCursor limit');\n  if (pageSize !== undefined && pageSize < 1) throw new Error('Invalid collectByCursor pageSize');\n\n  if (limit === 0) return;\n\n  let after: string | undefined;\n  let count = 0;\n  const seen = new Set<string>();\n\n  do {\n    const page = await fetchFrom(after, pageSize, signal);\n\n    if (limit !== undefined && count + page.data.length >= limit) {\n      yield page.data.slice(0, limit - count);\n      return;\n    }\n\n    count += page.data.length;\n    yield page.data;\n\n    after = nextCursorOf(page.links.next);\n    if (after !== undefined) {\n      if (seen.has(after)) {\n        throw new Error(`collectByCursor: links.next repeats the cursor ${after}`);\n      }\n      seen.add(after);\n    }\n  } while (after !== undefined);\n}\n\n/** Collects every item `iterateByCursor` yields into one array; see it for paging, `limit` and abort. */\nexport const collectByCursor = async <T>(options: CollectByCursorOptions<T>): Promise<T[]> => {\n  const items: T[] = [];\n  for await (const page of iterateByCursor(options)) items.push(...page);\n  return items;\n};\n","import { HtmlResponseError } from '../errors';\nimport { defaultValidateStatus, type ValidateStatusFn } from '../fetchClient';\n\nimport { isLoginPageRedirect } from './isLoginPageRedirect';\n\n/**\n * Status validation for the APIs Connection serves off its own host — storage and auth.\n *\n * - Rejects a successful login 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 && isLoginPageRedirect(apiResponse)) {\n    return new HtmlResponseError(apiResponse);\n  }\n\n  return isValid;\n};\n"],"mappings":";;;;;;;;;;;AAWA,IAAa,oBAAb,cAAuCA,0BAAAA,SAAS;CAC9C,YAAY,KAAkB;EAC5B,MAAM,GAAG;EACT,KAAK,OAAO;EACZ,KAAK,UAAU;CACjB;AACF;AAEA,MAAa,uBAAuB,UAClC,iBAAiB;;;;;;;;ACEnB,MAAa,gBAAgB,SAA4C;CACvE,IAAI,SAAS,MAAM,OAAO,KAAA;CAC1B,MAAM,aAAa,KAAK,QAAQ,GAAG;CACnC,IAAI,eAAe,IAAI,OAAO,KAAA;CAC9B,MAAM,QAAQ,KAAK,MAAM,aAAa,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;CACpD,OAAO,IAAI,gBAAgB,KAAK,CAAC,CAAC,IAAI,aAAa,KAAK,KAAA;AAC1D;;;;;;;;;AAUA,gBAAuB,gBAAmB,EACxC,WACA,UACA,OACA,UACkE;CAClE,IAAI,QAAQ,SAAS,MAAMC,yBAAAA,iBAAiB,OAAO,MAAM;CACzD,IAAI,UAAU,KAAA,KAAa,QAAQ,GAAG,MAAM,IAAI,MAAM,+BAA+B;CACrF,IAAI,aAAa,KAAA,KAAa,WAAW,GAAG,MAAM,IAAI,MAAM,kCAAkC;CAE9F,IAAI,UAAU,GAAG;CAEjB,IAAI;CACJ,IAAI,QAAQ;CACZ,MAAM,uBAAO,IAAI,IAAY;CAE7B,GAAG;EACD,MAAM,OAAO,MAAM,UAAU,OAAO,UAAU,MAAM;EAEpD,IAAI,UAAU,KAAA,KAAa,QAAQ,KAAK,KAAK,UAAU,OAAO;GAC5D,MAAM,KAAK,KAAK,MAAM,GAAG,QAAQ,KAAK;GACtC;EACF;EAEA,SAAS,KAAK,KAAK;EACnB,MAAM,KAAK;EAEX,QAAQ,aAAa,KAAK,MAAM,IAAI;EACpC,IAAI,UAAU,KAAA,GAAW;GACvB,IAAI,KAAK,IAAI,KAAK,GAChB,MAAM,IAAI,MAAM,kDAAkD,OAAO;GAE3E,KAAK,IAAI,KAAK;EAChB;CACF,SAAS,UAAU,KAAA;AACrB;;AAGA,MAAa,kBAAkB,OAAU,YAAqD;CAC5F,MAAM,QAAa,CAAC;CACpB,WAAW,MAAM,QAAQ,gBAAgB,OAAO,GAAG,MAAM,KAAK,GAAG,IAAI;CACrE,OAAO;AACT;;;;;;;;;ACpEA,MAAa,4BAA8C,gBAAgB;CACzE,MAAM,UAAUC,0BAAAA,sBAAsB,WAAW;CAEjD,IAAI,WAAWC,4BAAAA,oBAAoB,WAAW,GAC5C,OAAO,IAAI,kBAAkB,WAAW;CAG1C,OAAO;AACT"}

package/dist/vault/index.d.cts

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

package/dist/vault/index.d.ts

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

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-B6f6LpZ_.cjs";
+import { a as GetVariablesQuery, i as GetVariablesByBranchId, n as CreateVariableBody, o as VariableWithHash, r as DeleteVariablePath, t as AnyVariable } from "../types-D4oIei5M.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-CTYTMXXj.js";
+import { a as GetVariablesQuery, i as GetVariablesByBranchId, n as CreateVariableBody, o as VariableWithHash, r as DeleteVariablePath, t as AnyVariable } from "../types-CnSBLcZB.js";
 export { AnyVariable, CreateVariableBody, DeleteVariablePath, GetVariablesByBranchId, GetVariablesQuery, VariableWithHash };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keboola/api-client",
-  "version": "55.0.0",
+  "version": "57.0.0",
   "description": "TypeScript SDK for Keboola APIs",
   "license": "MIT",
   "type": "module",
@@ -1035,7 +1035,7 @@
     "type-check": "tsc",
     "lint": "pnpm lint:format && pnpm lint:oxlint",
     "lint:fix": "oxlint --fix . && oxfmt",
-    "knip:check": "pnpm --dir ../.. exec knip --workspace packages/api-client",
+    "knip:check": "node ../../scripts/knip-check.mjs",
     "knip:fix": "pnpm --dir ../.. exec knip --workspace packages/api-client --fix-type types,exports,files",
     "lint:oxlint": "oxlint . --quiet",
     "lint:format": "oxfmt --check",

package/surface/apps.md

@@ -6,10 +6,13 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 
 - `api.apps.createApp(body: { branchId: string | null; name: string; type: "streamlit" | "python-js"; description?: string | null | undefined; config?: { [key: string]: unknown; } | undefined; useManagedGitRepo: boolean; }, options?: WriteOptions): Promise<{ id: string; projectId: string; componentId: string; branchId: string | null; configId: string; type?: "streamlit" | "python-js" | null | undefined; url: string | null; hasManagedGitRepo: boolean; production: { desiredDeploymentId?: string | null | undefined; actualDeploymentId?: string | null | undefined; desiredConfigVersion?: string | null | undefined; actualConfigVersion?: string | null | undefined; desiredCreatedAt?: string | null | undefined; }; state: "starting" | "running" | "notDeployed" | "suspended" | "disabled"; }>`
 - `api.apps.createAppGitRepoCredential(appId: string, body: { type: "ssh_key" | "http_token"; publicKey?: string | undefined; name: string; permissions: "readOnly" | "readWrite"; }, options?: WriteOptions): Promise<{ id: string; type: "ssh_key" | "http_token"; name: string; permissions: "readOnly" | "readWrite"; ownerAdminId: string; createdAt: string; } & { secret?: string | undefined; }>`
-- `api.apps.createDeployment(appId: string, body?: { promote: boolean; configVersion?: string | null | undefined; } | undefined, options?: WriteOptions): Promise<{ id: string; configVersion: string; gitCommitSha: string | null; runtimeSize?: "micro" | "tiny" | "small" | "medium" | "large" | "external" | null | undefined; buildState: "pending" | "failed" | "building" | "ready"; runState: "pending" | "starting" | "running" | "stopping" | "stopped" | "failed" | "neverRun"; archived: boolean; archivedAt: string | null; createdAt: string; }>`
+- `api.apps.createDeployment(appId: string, body?: { promote: boolean; configVersion?: string | null | undefined; } | undefined, options?: WriteOptions): Promise<{ id: string; configVersion: string; gitCommitSha: string | null; runtimeSize?: "micro" | "tiny" | "small" | "medium" | "large" | "external" | null | undefined; buildState: "failed" | "pending" | "building" | "ready"; runState: "starting" | "running" | "stopping" | "stopped" | "failed" | "pending" | "neverRun"; archived: boolean; archivedAt: string | null; createdAt: string; }>`
+- `api.apps.createDraft(appId: string, body: { gitBranch: string; }, options?: WriteOptions): Promise<{ id: string; url: string | null; gitBranch: string; runState: "starting" | "running" | "stopping" | "stopped" | "failed" | "pending" | "neverRun"; createdAt: string; }>`
+- `api.apps.createDraftPreviewLink(appId: string, draftId: string, signal?: AbortSignal | undefined): Promise<{ url: string; linkExpiresAt: string; }>`
 - `api.apps.deleteApp(appId: string, signal?: AbortSignal | undefined): Promise<void>`
 - `api.apps.deleteAppGitRepoCredential(appId: string, credentialId: string, signal?: AbortSignal | undefined): Promise<void>`
 - `api.apps.deleteDeployment(appId: string, deploymentId: string, signal?: AbortSignal | undefined): Promise<void>`
+- `api.apps.deleteDraft(appId: string, draftId: string, signal?: AbortSignal | undefined): Promise<void>`
 - `api.apps.getApp(appId: string, signal?: AbortSignal | undefined): Promise<{ id: string; projectId: string; componentId: string; branchId: string | null; configId: string; type?: "streamlit" | "python-js" | null | undefined; url: string | null; hasManagedGitRepo: boolean; production: { desiredDeploymentId?: string | null | undefined; actualDeploymentId?: string | null | undefined; desiredConfigVersion?: string | null | undefined; actualConfigVersion?: string | null | undefined; desiredCreatedAt?: string | null | undefined; }; state: "starting" | "running" | "notDeployed" | "suspended" | "disabled"; }>`
 - `api.apps.getAppGitRepo(appId: string, signal?: AbortSignal | undefined): Promise<{ sshUrl: string | null; httpsUrl: string | null; isManagedGitRepo: boolean; }>`
 - `api.apps.getAppGitRepoBranches(appId: string, signal?: AbortSignal | undefined): Promise<{ defaultBranch: string; branches: { name: string; sha: string; }[]; }>`
@@ -22,10 +25,12 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 - `api.apps.getAppRun(appId: string, runId: string, signal?: AbortSignal | undefined): Promise<{ id: string; appId: string; deploymentId: string | null; state?: "starting" | "running" | "failed" | "finished" | null | undefined; createdAt?: string | null | undefined; startedAt?: string | null | undefined; stoppedAt?: string | null | undefined; startupLogs?: string | null | undefined; runtimeSize?: string | null | undefined; runtimeBackendType?: string | null | undefined; configVersion?: string | null | undefined; imageVersion?: string | null | undefined; failureReason?: { reason?: string | null | undefined; message?: string | null | undefined; } | null | undefined; mode?: string | undefined; }>`
 - `api.apps.getAppRuns(appId: string, query?: { deploymentId?: string | undefined; since?: string | undefined; until?: string | undefined; offset?: number | undefined; limit?: number | undefined; }, signal?: AbortSignal | undefined): Promise<{ id: string; appId: string; deploymentId: string | null; state?: "starting" | "running" | "failed" | "finished" | null | undefined; createdAt?: string | null | undefined; startedAt?: string | null | undefined; stoppedAt?: string | null | undefined; startupLogs?: string | null | undefined; runtimeSize?: string | null | undefined; runtimeBackendType?: string | null | undefined; configVersion?: string | null | undefined; imageVersion?: string | null | undefined; failureReason?: { reason?: string | null | undefined; message?: string | null | undefined; } | null | undefined; mode?: string | undefined; }[]>`
 - `api.apps.getApps(query?: { offset?: number | undefined; limit?: number | undefined; }, signal?: AbortSignal | undefined): Promise<{ id: string; projectId: string; componentId: string; branchId: string | null; configId: string; type?: "streamlit" | "python-js" | null | undefined; url: string | null; hasManagedGitRepo: boolean; production: { desiredDeploymentId?: string | null | undefined; actualDeploymentId?: string | null | undefined; desiredConfigVersion?: string | null | undefined; actualConfigVersion?: string | null | undefined; desiredCreatedAt?: string | null | undefined; }; state: "starting" | "running" | "notDeployed" | "suspended" | "disabled"; }[]>`
-- `api.apps.getDeployment(appId: string, deploymentId: string, signal?: AbortSignal | undefined): Promise<{ id: string; configVersion: string; gitCommitSha: string | null; runtimeSize?: "micro" | "tiny" | "small" | "medium" | "large" | "external" | null | undefined; buildState: "pending" | "failed" | "building" | "ready"; runState: "pending" | "starting" | "running" | "stopping" | "stopped" | "failed" | "neverRun"; archived: boolean; archivedAt: string | null; createdAt: string; }>`
+- `api.apps.getDeployment(appId: string, deploymentId: string, signal?: AbortSignal | undefined): Promise<{ id: string; configVersion: string; gitCommitSha: string | null; runtimeSize?: "micro" | "tiny" | "small" | "medium" | "large" | "external" | null | undefined; buildState: "failed" | "pending" | "building" | "ready"; runState: "starting" | "running" | "stopping" | "stopped" | "failed" | "pending" | "neverRun"; archived: boolean; archivedAt: string | null; createdAt: string; }>`
 - `api.apps.getDeploymentLogsDownload(appId: string, deploymentId: string, signal?: AbortSignal | undefined): Promise<{ logs: string; fileName: string; }>`
 - `api.apps.getDeploymentLogsTail(appId: string, deploymentId: string, { query, signal }?: LogsTailOptions): Promise<{ entries: LogEntry[]; nextLogTimestamp: string | null; }>`
-- `api.apps.getDeployments(appId: string, query?: { archived?: boolean | undefined; offset?: number | undefined; limit?: number | undefined; }, signal?: AbortSignal | undefined): Promise<{ id: string; configVersion: string; gitCommitSha: string | null; runtimeSize?: "micro" | "tiny" | "small" | "medium" | "large" | "external" | null | undefined; buildState: "pending" | "failed" | "building" | "ready"; runState: "pending" | "starting" | "running" | "stopping" | "stopped" | "failed" | "neverRun"; archived: boolean; archivedAt: string | null; createdAt: string; }[]>`
+- `api.apps.getDeployments(appId: string, query?: { archived?: boolean | undefined; offset?: number | undefined; limit?: number | undefined; }, signal?: AbortSignal | undefined): Promise<{ id: string; configVersion: string; gitCommitSha: string | null; runtimeSize?: "micro" | "tiny" | "small" | "medium" | "large" | "external" | null | undefined; buildState: "failed" | "pending" | "building" | "ready"; runState: "starting" | "running" | "stopping" | "stopped" | "failed" | "pending" | "neverRun"; archived: boolean; archivedAt: string | null; createdAt: string; }[]>`
+- `api.apps.getDraft(appId: string, draftId: string, signal?: AbortSignal | undefined): Promise<{ id: string; url: string | null; gitBranch: string; runState: "starting" | "running" | "stopping" | "stopped" | "failed" | "pending" | "neverRun"; createdAt: string; }>`
+- `api.apps.getDrafts(appId: string, query?: { offset?: number | undefined; limit?: number | undefined; }, signal?: AbortSignal | undefined): Promise<{ id: string; url: string | null; gitBranch: string; runState: "starting" | "running" | "stopping" | "stopped" | "failed" | "pending" | "neverRun"; createdAt: string; }[]>`
 - `api.apps.healthCheck(signal?: AbortSignal | undefined): Promise<{ appName?: string | undefined; appVersion?: string | undefined; apiDocs?: string | undefined; }>`
 - `api.apps.promoteDeployment(appId: string, deploymentId: string, signal?: AbortSignal | undefined): Promise<{ id: string; projectId: string; componentId: string; branchId: string | null; configId: string; type?: "streamlit" | "python-js" | null | undefined; url: string | null; hasManagedGitRepo: boolean; production: { desiredDeploymentId?: string | null | undefined; actualDeploymentId?: string | null | undefined; desiredConfigVersion?: string | null | undefined; actualConfigVersion?: string | null | undefined; desiredCreatedAt?: string | null | undefined; }; state: "starting" | "running" | "notDeployed" | "suspended" | "disabled"; }>`
 - `api.apps.resetAppPassword(appId: string, signal?: AbortSignal | undefined): Promise<{ password: string; }>`

package/surface/auth.md

@@ -32,6 +32,7 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 - `api.auth.me.getMaintainers(query?: { page?: { after?: string | undefined; limit?: number | undefined; } | undefined; } | undefined, signal?: AbortSignal | undefined): Promise<{ data: Record<string, never>[]; meta: { total: number; limit: number; cursor: { param: string; encoding: string; fields: { name: string; type: "string" | "integer" | "date-time"; nullable: boolean; }[]; order: string; }; }; links: { self: string; first: string; next: string | null; }; } & { data?: { id: number; name: string | null; }[] | undefined; }>`
 - `api.auth.me.getOrganizations(query?: { page?: { after?: string | undefined; limit?: number | undefined; } | undefined; filter?: { maintainerId?: number | undefined; } | undefined; } | undefined, signal?: AbortSignal | undefined): Promise<{ data: Record<string, never>[]; meta: { total: number; limit: number; cursor: { param: string; encoding: string; fields: { name: string; type: "string" | "integer" | "date-time"; nullable: boolean; }[]; order: string; }; }; links: { self: string; first: string; next: string | null; }; } & { data?: { id: number; name: string; mfaRequired: boolean; maintainer: { id: number; name: string | null; }; isAdmin: boolean; hasAccess: boolean; canLeave: boolean; projectsCount: number; }[] | undefined; }>`
 - `api.auth.me.getProjects(query?: { page?: { after?: string | undefined; limit?: number | undefined; } | undefined; filter?: { organizationId?: number | undefined; name?: string | undefined; } | undefined; } | undefined, signal?: AbortSignal | undefined): Promise<{ data: Record<string, never>[]; meta: { total: number; limit: number; cursor: { param: string; encoding: string; fields: { name: string; type: "string" | "integer" | "date-time"; nullable: boolean; }[]; order: string; }; }; links: { self: string; first: string; next: string | null; }; } & { data?: { id: number; name: string; organizationId: number; role: string | null; isDisabled: boolean; disabledReason: string | null; }[] | undefined; }>`
+- `api.auth.me.update(input: { name: string; }, signal?: AbortSignal | undefined): Promise<{ user: { id: number; name: string; email: string; isSuperAdmin: boolean; hasMfaEnabled: boolean; features: string[]; }; }>`
 
 ### `api.auth.mfa`
 
@@ -69,7 +70,7 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 
 ### `api.auth.session`
 
-- `api.auth.session.getAll(signal?: AbortSignal | undefined): Promise<{ sessions?: { id: string; grantType: string; client: { id: string; name: string | null; } | null; allProjects: boolean; projects: { id: string; name: string | null; }[]; createdAt: string; lastUsedAt: string | null; lastUsedIp: string | null; userAgent: string | null; accessTokenExpiresAt: string; refreshTokenExpiresAt: string; isCurrent: boolean; }[] | undefined; oauthSessions?: { client: { id: string; name: string | null; }; project: { id: string; name: string | null; } | null; tokenId: number | null; allProjects: boolean; projects: { id: string; name: string | null; }[]; scopes: string[]; authorizedAt: string | null; expiresAt: string; }[] | undefined; }>`
+- `api.auth.session.getAll(signal?: AbortSignal | undefined): Promise<{ sessions?: { id: string; grantType: string; client: { id: string; name: string | null; } | null; allProjects: boolean; projects: { id: string; name: string | null; }[]; createdAt: string; lastUsedAt: string | null; lastUsedIp: string | null; userAgent: string | null; reportedClientName: string | null; accessTokenExpiresAt: string; refreshTokenExpiresAt: string; isCurrent: boolean; }[] | undefined; oauthSessions?: { client: { id: string; name: string | null; }; project: { id: string; name: string | null; } | null; tokenId: number | null; allProjects: boolean; projects: { id: string; name: string | null; }[]; scopes: string[]; authorizedAt: string | null; expiresAt: string; }[] | undefined; }>`
 - `api.auth.session.revoke(sessionId: string, signal?: AbortSignal | undefined): Promise<void>`
 - `api.auth.session.revokeAll(signal?: AbortSignal | undefined): Promise<void>`
 
@@ -83,7 +84,7 @@ 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; lastUsedIp: string | null; userAgent: string | null; projects: { id: number; name: string | null; role: string | null; }[]; }>`
 - `api.auth.token.refreshWithSession(input: { sessionId: string; }, signal?: AbortSignal | undefined): Promise<{ accessToken: string; refreshToken?: string | undefined; tokenType: string; expiresIn: number; sessionId: string; user: { id: number; email: string; name: string; }; }>`
 - `api.auth.token.refreshWithToken(input: { refreshToken: string; }, signal?: AbortSignal | undefined): Promise<{ accessToken: string; refreshToken?: string | undefined; 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.token.revoke(body: { token: string; tokenTypeHint: "refreshToken" | "accessToken" | null; }, signal?: AbortSignal | undefined): Promise<void>`
 
 ### `api.auth.webauthn`
 

package/surface/chat.md

@@ -4,12 +4,12 @@
 
 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?: "pending" | "failed" | "completed" | "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.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?: "failed" | "pending" | "completed" | "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<AgentSettings>`
-- `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?: "pending" | "failed" | "completed" | "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?: "failed" | "pending" | "completed" | "interrupted" | undefined; }[]; }>`
 - `api.chat.getHistory(params?: { limit?: number | undefined; starting_after?: string | undefined; ending_before?: string | undefined; } | undefined, signal?: AbortSignal | 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: "documentation" | "error" | "maintenance"; reasoning: string; id: string; }[]; suggestionSessionId: string; }>`
+- `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; }[]; }>`
 - `api.chat.getUsage(signal?: AbortSignal | undefined): Promise<{ messagesUsed: number; messagesLimit: number; resetDate: string; }>`
 - `api.chat.getUserAgentSettings(signal?: AbortSignal | undefined): Promise<UserAgentSettings>`

package/surface/dataScience.md

@@ -6,8 +6,8 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 
 - `api.dataScience.createAppPreviewLink(appId: string, signal?: AbortSignal | undefined): Promise<{ url: string; linkExpiresAt: string; }>`
 - `api.dataScience.deleteSandbox(appId: string, signal?: AbortSignal | undefined): Promise<ApiResponse<never>>`
-- `api.dataScience.getApp(appId: string, signal?: AbortSignal | undefined): Promise<{ id: string; type?: string | null | undefined; projectId: string; componentId: string; branchId: string | null; configId: string; configVersion: string; state: "created" | "starting" | "restarting" | "running" | "stopping" | "stopped" | "deleting" | "deleted"; desiredState: "running" | "stopped" | "deleted"; mode: "dev" | "prod"; lastRequestTimestamp: string | null; lastStartTimestamp?: string | null | undefined; url?: string | null | undefined; autoSuspendAfterSeconds?: number | undefined; autoRestartEnabled?: boolean | undefined; size?: string | null | undefined; hasManagedGitRepo?: boolean | undefined; }>`
-- `api.dataScience.getApps(query: { offset?: number | undefined; limit?: number | undefined; componentId?: string | undefined; type?: ("bigquery" | "python" | "r" | "snowflake" | "streamlit" | "python-js")[] | undefined; branchId?: string | undefined; }, signal?: AbortSignal | undefined): Promise<{ id: string; type?: string | null | undefined; projectId: string; componentId: string; branchId: string | null; configId: string; configVersion: string; state: "created" | "starting" | "restarting" | "running" | "stopping" | "stopped" | "deleting" | "deleted"; desiredState: "running" | "stopped" | "deleted"; mode: "dev" | "prod"; lastRequestTimestamp: string | null; lastStartTimestamp?: string | null | undefined; url?: string | null | undefined; autoSuspendAfterSeconds?: number | undefined; autoRestartEnabled?: boolean | undefined; size?: string | null | undefined; hasManagedGitRepo?: boolean | undefined; }[]>`
+- `api.dataScience.getApp(appId: string, signal?: AbortSignal | undefined): Promise<{ id: string; type?: string | null | undefined; projectId: string; componentId: string; branchId: string | null; configId: string; configVersion: string; state: "created" | "starting" | "restarting" | "running" | "stopping" | "stopped" | "deleting" | "deleted"; desiredState: "running" | "stopped" | "deleted"; mode: "prod" | "dev"; lastRequestTimestamp: string | null; lastStartTimestamp?: string | null | undefined; url?: string | null | undefined; autoSuspendAfterSeconds?: number | undefined; autoRestartEnabled?: boolean | undefined; size?: string | null | undefined; hasManagedGitRepo?: boolean | undefined; }>`
+- `api.dataScience.getApps(query: { offset?: number | undefined; limit?: number | undefined; componentId?: string | undefined; type?: ("bigquery" | "python" | "r" | "snowflake" | "streamlit" | "python-js")[] | undefined; branchId?: string | undefined; }, signal?: AbortSignal | undefined): Promise<{ id: string; type?: string | null | undefined; projectId: string; componentId: string; branchId: string | null; configId: string; configVersion: string; state: "created" | "starting" | "restarting" | "running" | "stopping" | "stopped" | "deleting" | "deleted"; desiredState: "running" | "stopped" | "deleted"; mode: "prod" | "dev"; lastRequestTimestamp: string | null; lastStartTimestamp?: string | null | undefined; url?: string | null | undefined; autoSuspendAfterSeconds?: number | undefined; autoRestartEnabled?: boolean | undefined; size?: string | null | undefined; hasManagedGitRepo?: boolean | undefined; }[]>`
 - `api.dataScience.getRuntimes(signal?: AbortSignal | undefined): Promise<{ description: string; type: string; isTypeDefault: boolean; releaseDate: string; endOfLifeDate?: string | null | undefined; imageName?: string | null | undefined; imageTag?: string | null | undefined; transformationComponentId?: string | null | undefined; transformationComponentTag?: string | null | undefined; sandboxImageName?: string | null | undefined; sandboxImageTag?: string | null | undefined; }[]>`
 - `api.dataScience.getSandbox(appId: string, signal?: AbortSignal | undefined): Promise<{ id?: string | undefined; projectId?: string | undefined; tokenId?: string | undefined; branchId?: string | null | undefined; configurationId?: string | undefined; physicalId?: string | undefined; type?: string | undefined; active?: boolean | undefined; createdTimestamp?: string | undefined; startTimestamp?: string | undefined; updatedTimestamp?: string | undefined; persistentStorage?: { pvcName?: string | null | undefined; k8sManifest?: string | null | undefined; isEnabled?: boolean | undefined; ready?: boolean | null | undefined; k8sStorageClassName?: string | null | undefined; } | undefined; shared?: boolean | undefined; componentId?: string | undefined; configurationVersion?: string | undefined; size?: string | null | undefined; lastAutosaveTimestamp?: string | null | undefined; expirationTimestamp?: string | null | undefined; autoSuspendAfterSeconds?: number | undefined; expirationAfterHours?: number | undefined; user?: string | null | undefined; url?: string | null | undefined; password?: string | null | undefined; autosaveTokenId?: string | null | undefined; host?: string | null | undefined; imageVersion?: string | null | undefined; packages?: string[] | null | undefined; sizeParameters?: unknown; stagingWorkspaceId?: unknown; stagingWorkspaceType?: unknown; workspaceDetails?: unknown; databricks?: unknown; credentials?: unknown; }>`
 - `api.dataScience.healthCheck(signal?: AbortSignal | undefined): Promise<unknown>`

package/surface/kaiAgent.md

@@ -5,19 +5,19 @@
 Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 
 - `api.kaiAgent.approveToolCall(chatId: string, body: { toolUseId: string; approved: boolean; reason?: string | undefined; dismissed?: boolean | 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; autoForwarded?: boolean | undefined; requestContext?: { path?: string | undefined; sqlEditorActive?: boolean | undefined; } | undefined; deployPreapproval?: { configurationId: string; } | undefined; tableContext?: { tableName: string; tableId: string; bucketId: string; fileName: string; }[] | undefined; previewSelections?: { source: string | null; sourceTrail: string[]; selector: string; tag: string; text: string; html: string; rect: { x: number; y: number; width: number; height: number; }; page: string; viewport: { width: number; height: number; }; area?: { inside: { source: string | null; tag: string; text: string; }[]; within: { source: string | null; tag: string; text: string; } | null; above: { source: string | null; tag: string; text: string; } | null; below: { source: string | null; tag: string; text: string; } | null; } | undefined; }[] | undefined; previewIntent?: "data-source" | undefined; } | undefined; }; selectedChatModel?: string | undefined; selectedVisibilityType?: "public" | "private" | undefined; branchId?: number | undefined; model?: string | undefined; toolRestrictions?: { allowedTools?: string[] | undefined; disallowedTools?: string[] | undefined; readOnlyMode?: boolean | undefined; } | undefined; telemetryMetadata?: { [key: string]: string | number | boolean; } | undefined; supportsApprovalRequestedEvent?: boolean | undefined; client?: "kbc-ui" | undefined; gitCredential?: { repository: string; token: string; } | undefined; }): Promise<Response>`
+- `api.kaiAgent.createChat(request: { id: string; message: { id: string; role: "user" | "assistant"; parts: { [key: string]: unknown; }[]; metadata?: { hidden?: boolean | undefined; autoForwarded?: boolean | undefined; requestContext?: { path?: string | undefined; sqlEditorActive?: boolean | undefined; } | undefined; deployPreapproval?: { configurationId: string; } | undefined; tableContext?: { tableName: string; tableId: string; bucketId: string; fileName: string; }[] | undefined; previewSelections?: { source: string | null; sourceTrail: string[]; selector: string; tag: string; text: string; html: string; rect: { x: number; y: number; width: number; height: number; }; page: string; viewport: { width: number; height: number; }; area?: { inside: { source: string | null; tag: string; text: string; }[]; within: { source: string | null; tag: string; text: string; } | null; above: { source: string | null; tag: string; text: string; } | null; below: { source: string | null; tag: string; text: string; } | null; } | undefined; }[] | undefined; previewIntent?: "data-source" | undefined; queuedContext?: { excerpt: string; } | undefined; } | undefined; }; selectedChatModel?: string | undefined; selectedVisibilityType?: "public" | "private" | undefined; branchId?: number | undefined; model?: string | undefined; toolRestrictions?: { allowedTools?: string[] | undefined; disallowedTools?: string[] | undefined; readOnlyMode?: boolean | undefined; } | undefined; telemetryMetadata?: { [key: string]: string | number | boolean; } | undefined; supportsApprovalRequestedEvent?: boolean | undefined; client?: "kbc-ui" | undefined; gitCredential?: { repository: string; token: string; } | undefined; projectIds?: string[] | 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.deleteUserMemory(memoryId: string, signal?: AbortSignal | undefined): Promise<void>`
 - `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; toolPermissions?: Record<string, ProjectToolPolicyValue> | null | undefined; canWriteToolPolicy?: boolean | undefined; }>`
 - `api.kaiAgent.getArtifact(artifactId: string, signal?: AbortSignal | undefined): Promise<{ id: string; chatId: string; messageId: string; kind: "table" | "chart" | "document"; title: string; summary: string | null; spec: { [key: string]: unknown; }; recipe: { [key: string]: unknown; }; createdAt: string; }>`
 - `api.kaiAgent.getArtifacts(chatId: string, signal?: AbortSignal | undefined): Promise<{ id: string; chatId: string; messageId: string; kind: "table" | "chart" | "document"; title: string; summary: string | null; spec: { [key: string]: unknown; }; recipe: { [key: string]: unknown; }; createdAt: 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; ppuUsed: number | null; ppuPercentage: number | null; model: string | null; effort: "medium" | "low" | "high" | "xhigh" | "max" | null; effectiveModel: string | null; 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: "auto" | "manual"; 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 | undefined; reason?: string | undefined; } | undefined; })[]; metadata?: { createdAt?: string | undefined; hidden?: boolean | undefined; autoForwarded?: boolean | undefined; pausedReason?: "turn-budget" | undefined; requestContext?: { path?: string | undefined; sqlEditorActive?: boolean | undefined; } | undefined; } | undefined; status?: "pending" | "failed" | "completed" | "interrupted" | undefined; }[]; }>`
+- `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; projectIds: string[]; activeProjectId: string; contextWindow?: { usedTokens: number; maxTokens: number; percentage: number; } | null | undefined; ppuUsed: number | null; ppuPercentage: number | null; model: string | null; effort: "medium" | "low" | "high" | "xhigh" | "max" | null; effectiveModel: string | null; 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: "auto" | "manual"; 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 | undefined; reason?: string | undefined; } | undefined; })[]; metadata?: { createdAt?: string | undefined; hidden?: boolean | undefined; autoForwarded?: boolean | undefined; pausedReason?: "turn-budget" | undefined; requestContext?: { path?: string | undefined; sqlEditorActive?: boolean | undefined; } | undefined; } | undefined; status?: "failed" | "pending" | "completed" | "interrupted" | undefined; }[]; }>`
 - `api.kaiAgent.getHistory(params?: { limit?: number | undefined; starting_after?: string | undefined; ending_before?: string | undefined; client?: "kbc-ui" | undefined; } | undefined, signal?: AbortSignal | 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; client?: "kbc-ui" | "business-chat" | null | undefined; }[]; hasMore: boolean; }>`
 - `api.kaiAgent.getSandboxGitBranch(chatId: string, signal?: AbortSignal | undefined): Promise<{ branch: string | null; }>`
 - `api.kaiAgent.getSkillsList(signal?: AbortSignal | undefined): Promise<{ skills: { name: string; description: string | null; source: "first-party" | "vendored" | "project"; }[]; commands: { name: string; description: string; }[]; }>`
 - `api.kaiAgent.getSpendCaps(signal?: AbortSignal | undefined): Promise<SpendCapsView>`
-- `api.kaiAgent.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: "documentation" | "error" | "maintenance"; reasoning: string; id: string; }[]; suggestionSessionId: string; }>`
+- `api.kaiAgent.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.kaiAgent.getToolsList(signal?: AbortSignal | undefined): Promise<{ tools: { name: string; description: string; readOnly: boolean; }[]; }>`
 - `api.kaiAgent.getUsage(signal?: AbortSignal | undefined): Promise<UsageResponse>`
 - `api.kaiAgent.getUserAgentSettings(signal?: AbortSignal | undefined): Promise<{ projectId: string; userId: string; customInstructions: string | null; toolPermissions: Record<string, "blocked" | "always_ask" | "always_allow"> | null; createdAt: string; updatedAt: string; projectToolPermissions?: Record<string, ProjectToolPolicyValue> | null | undefined; memorySaveMode?: "auto" | "ask" | undefined; }>`
@@ -32,6 +32,7 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 - `api.kaiAgent.submitToolOutput(chatId: string, body: { toolUseId: string; output?: string | undefined; errorText?: string | undefined; }): Promise<void>`
 - `api.kaiAgent.submitVote(params: { chatId: string; messageId: string; type: "up" | "down"; }): Promise<void>`
 - `api.kaiAgent.updateAgentSettings(request: UpdateAgentSettingsRequest, signal?: AbortSignal | undefined): Promise<{ projectId: string; customInstructions: string | null; createdAt: string; updatedAt: string; toolPermissions?: Record<string, ProjectToolPolicyValue> | null | undefined; canWriteToolPolicy?: boolean | undefined; }>`
+- `api.kaiAgent.updateChatProjects(chatId: string, body: { projectIds: string[]; activeProjectId: string; }): Promise<{ projectIds: string[]; activeProjectId: string; }>`
 - `api.kaiAgent.updateProjectToolPolicy(toolPermissions: ProjectToolPolicy, signal?: AbortSignal | undefined): Promise<{ projectId: string; customInstructions: string | null; createdAt: string; updatedAt: string; toolPermissions?: Record<string, ProjectToolPolicyValue> | null | undefined; canWriteToolPolicy?: boolean | undefined; }>`
 - `api.kaiAgent.updateSpendCaps(request: UpdateSpendCapsRequest, signal?: AbortSignal | undefined): Promise<SpendCapsView>`
 - `api.kaiAgent.updateTurnCredential(chatId: string): Promise<{ updated: boolean; }>`

package/surface/management.md

@@ -120,13 +120,13 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 
 ### `api.management.payAsYouGo`
 
-- `api.management.payAsYouGo.createPaymentRequest(body: { idProject: number; amount: number; saveCard?: boolean | null | undefined; } & { _token?: string | undefined; }): Promise<CreditPaymentRequest>`
+- `api.management.payAsYouGo.createPaymentRequest(body: { idProject: number; amount: number; saveCard?: boolean | null | undefined; }): Promise<CreditPaymentRequest>`
 - `api.management.payAsYouGo.getBillingConfiguration(signal?: AbortSignal | undefined): Promise<PayAsYouGoBillingConfiguration>`
 - `api.management.payAsYouGo.getCreditPurchases(idProject: number, signal?: AbortSignal | undefined): Promise<CreditPurchase[]>`
 - `api.management.payAsYouGo.getStripeCustomer(idProject: number, signal?: AbortSignal | undefined): Promise<{ email: string | null; name: string | null; address?: { line1?: string | null | undefined; line2?: string | null | undefined; city?: string | null | undefined; state?: string | null | undefined; postal_code?: string | null | undefined; country?: string | null | undefined; } | undefined; vat_id?: string | undefined; cards: { id: string; brand: string; exp_month: number; exp_year: number; last4: string; funding: string; }[]; } | null>`
 - `api.management.payAsYouGo.getTopUpSetting(projectId: number, signal?: AbortSignal | undefined): Promise<TopUpSetting>`
-- `api.management.payAsYouGo.updateStripeCustomer(body: { idProject: number; email?: string | null | undefined; name?: string | null | undefined; vatId?: string | null | undefined; addressLine1?: string | null | undefined; addressLine2?: string | null | undefined; addressCity?: string | null | undefined; addressState?: string | null | undefined; addressPostalCode?: string | null | undefined; addressCountry?: string | null | undefined; dropCardId?: string | null | undefined; } & { _token?: string | undefined; }): Promise<{ email: string | null; name: string | null; address?: { line1?: string | null | undefined; line2?: string | null | undefined; city?: string | null | undefined; state?: string | null | undefined; postal_code?: string | null | undefined; country?: string | null | undefined; } | undefined; vat_id?: string | undefined; cards: { id: string; brand: string; exp_month: number; exp_year: number; last4: string; funding: string; }[]; }>`
-- `api.management.payAsYouGo.updateTopUpSetting(body: { idProject: number; amount: number; limit: number; enabled: boolean; } & { _token?: string | undefined; }): Promise<void>`
+- `api.management.payAsYouGo.updateStripeCustomer(body: { idProject: number; email?: string | null | undefined; name?: string | null | undefined; vatId?: string | null | undefined; addressLine1?: string | null | undefined; addressLine2?: string | null | undefined; addressCity?: string | null | undefined; addressState?: string | null | undefined; addressPostalCode?: string | null | undefined; addressCountry?: string | null | undefined; dropCardId?: string | null | undefined; }): Promise<{ email: string | null; name: string | null; address?: { line1?: string | null | undefined; line2?: string | null | undefined; city?: string | null | undefined; state?: string | null | undefined; postal_code?: string | null | undefined; country?: string | null | undefined; } | undefined; vat_id?: string | undefined; cards: { id: string; brand: string; exp_month: number; exp_year: number; last4: string; funding: string; }[]; }>`
+- `api.management.payAsYouGo.updateTopUpSetting(body: { idProject: number; amount: number; limit: number; enabled: boolean; }): Promise<void>`
 
 ### `api.management.programmaticProjects`
 
@@ -155,7 +155,7 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 - `api.management.projects.getProjectTemplate(templateId: string, signal?: AbortSignal | undefined): Promise<{ id: string; name: string; description: string; expirationDays: number | null; billedMonthlyPrice: number | null; hasTryModeOn: boolean; defaultBackend: string; }>`
 - `api.management.projects.getProjectTemplateFeatures(templateId: string, signal?: AbortSignal | undefined): Promise<{ id?: number | undefined; name?: string | undefined; type?: string | undefined; title?: string | undefined; description?: string | undefined; created?: string | undefined; }[]>`
 - `api.management.projects.getProjectTemplates(signal?: AbortSignal | undefined): Promise<{ id: string; name: string; description: string; expirationDays: number | null; billedMonthlyPrice: number | null; hasTryModeOn: boolean; defaultBackend: string; }[]>`
-- `api.management.projects.getProjectUsers(projectId: string | number, signal?: AbortSignal | undefined): Promise<({ id: number; name: string; email: string; mfaEnabled: boolean; features: string[]; canAccessLogs: boolean; isSuperAdmin: boolean; } & { expires: string | null; created: string | null; reason: string | null; role: "readOnly" | "admin" | "guest" | "share" | "developer" | "reviewer" | "productionManager"; status: "active"; invitor: { id: number; name: string; email: string; } | null; approver: { id: number; name: string; email: string; } | null; canApproveMergeRequests: boolean; isOrganizationMember: boolean; })[]>`
+- `api.management.projects.getProjectUsers(projectId: string | number, signal?: AbortSignal | undefined): Promise<({ id: number; name: string; email: string; mfaEnabled: boolean; features: string[]; canAccessLogs: boolean; isSuperAdmin: boolean; } & { expires: string | null; created: string | null; reason: string | null; role: "readOnly" | "share" | "admin" | "guest" | "developer" | "reviewer" | "productionManager"; status: "active"; invitor: { id: number; name: string; email: string; } | null; approver: { id: number; name: string; email: string; } | null; canApproveMergeRequests: boolean; isOrganizationMember: boolean; })[]>`
 - `api.management.projects.joinProject({ projectId, ...body }: JoinProjectInput): Promise<void>`
 - `api.management.projects.moveProject({ projectId, organizationId }: MoveProjectInput): Promise<{ id: number; name: string; type: string; region: string; created: string | null; expires: string | null; features: string[]; dataSizeBytes: number; rowsCount: number; hasMysql: boolean; hasSynapse: boolean; hasSnowflake: boolean; hasExasol: boolean; hasTeradata: boolean; hasBigquery: boolean; defaultBackend: string; hasTryModeOn: string; limits: { [key: string]: { name: string; value: number; }; }; metrics: { [key: string]: { name: string; value: number; }; }; isDisabled: boolean; billedMonthlyPrice: number | null; dataRetentionTimeInDays: number; isBYODB: boolean; assignedBackends: string[]; fileStorageProvider?: string | undefined; usersCount: number; timezone: string | null; payAsYouGo?: { purchasedCredits: number; } | undefined; disabled?: { reason: string; estimatedEndTime: string | null; } | undefined; }>`
 - `api.management.projects.rejectProjectJoinRequest({ projectId, joinRequestId, }: { projectId: number; joinRequestId: number; }): Promise<null>`

package/surface/queue.md

@@ -4,12 +4,12 @@
 
 Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 
-- `api.queue.createJob(body: { component: string; mode?: "run" | "debug" | "forceRun" | undefined; config?: string | undefined; configRowIds?: string[] | undefined; configData?: Record<string, never> | undefined; tag?: string | undefined; branchId?: string | undefined; variableValuesId?: string | undefined; variableValuesData?: { values: { name: string; value: string; }[]; } | undefined; backend?: { type: "small" | "medium" | "large" | "xsmall"; context?: string | undefined; } | undefined; executor?: "dind" | "k8sContainers" | undefined; delayedStartTime?: string | undefined; delay?: number | undefined; onlyFlowTaskIds?: string[] | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; }, signal?: AbortSignal | undefined): Promise<{ id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }>`
-- `api.queue.getJob(jobId: string, signal?: AbortSignal | undefined): Promise<{ id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }>`
+- `api.queue.createJob(body: { component: string; mode?: "run" | "debug" | "forceRun" | undefined; config?: string | undefined; configRowIds?: string[] | undefined; configData?: Record<string, never> | undefined; tag?: string | undefined; branchId?: string | undefined; variableValuesId?: string | undefined; variableValuesData?: { values: { name: string; value: string; }[]; } | undefined; backend?: { type: "small" | "medium" | "large" | "xsmall"; context?: string | undefined; } | undefined; executor?: "dind" | "k8sContainers" | undefined; delayedStartTime?: string | undefined; delay?: number | undefined; runtimeTimezone?: string | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; }, signal?: AbortSignal | undefined): Promise<{ id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; runtimeTimezone?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }>`
+- `api.queue.getJob(jobId: string, signal?: AbortSignal | undefined): Promise<{ id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; runtimeTimezone?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }>`
 - `api.queue.getOrchestrationRerunPlan(jobId: string, signal?: AbortSignal | undefined): Promise<{ jobId?: string | undefined; configId?: string | null | undefined; matchedTasks?: { taskId?: string | undefined; matched?: boolean | undefined; jobId?: string | null | undefined; componentId?: string | null | undefined; configId?: string | null | undefined; status?: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled" | undefined; }[] | undefined; }>`
 - `api.queue.healthCheck(signal?: AbortSignal | undefined): Promise<unknown>`
-- `api.queue.killJob(jobId: string, signal?: AbortSignal | undefined): Promise<{ id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }>`
-- `api.queue.poller({ init, interval, maxAttempts, timeout, signal, }: QueueJobPollOptions & { init: JobRef | ((signal: AbortSignal) => Promise<JobRef>); }): Poller<{ id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }, { id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }>`
-- `api.queue.searchAllJobs(query: { type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; id?: string[] | undefined; branchId?: string[] | undefined; runId?: string[] | undefined; componentId?: string[] | undefined; configId?: string[] | undefined; mode?: ("run" | "debug")[] | undefined; config?: string[] | undefined; tokenId?: string[] | undefined; tokenDescription?: string[] | undefined; component?: string[] | undefined; configRowIds?: string[] | undefined; status?: ("error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled")[] | undefined; componentProps?: { type?: string | undefined; } | undefined; createdTimeFrom?: string | undefined; createdTimeTo?: string | undefined; startTimeFrom?: string | undefined; startTimeTo?: string | undefined; endTimeFrom?: string | undefined; endTimeTo?: string | undefined; durationSecondsFrom?: number | undefined; durationSecondsTo?: number | undefined; limit?: number | undefined; sortBy?: "id" | "branchId" | "runId" | "componentId" | "projectId" | "configId" | "tokenDescription" | "status" | "createdTime" | "durationSeconds" | "startTime" | "endTime" | "updatedTime" | undefined; sortOrder?: "asc" | "desc" | undefined; parentRunId?: string | undefined; }, signal?: AbortSignal | undefined): Promise<{ id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }[]>`
-- `api.queue.searchGroupedJobs(query: { groupBy: ("branchId" | "componentId" | "projectId" | "configId")[]; jobsPerGroup?: number | undefined; sortBy?: "id" | "branchId" | "runId" | "componentId" | "projectId" | "configId" | "tokenDescription" | "status" | "createdTime" | "durationSeconds" | "startTime" | "endTime" | "updatedTime" | undefined; sortOrder?: "asc" | "desc" | undefined; limit?: number | undefined; id?: number[] | undefined; runId?: string[] | undefined; branchId?: string[] | undefined; configId?: string[] | undefined; config?: string[] | undefined; configRowIds?: string[] | undefined; projectId?: string[] | undefined; tokenId?: string[] | undefined; tokenDescription?: string[] | undefined; componentId?: string[] | undefined; component?: string[] | undefined; status?: string[] | undefined; desiredStatus?: string[] | undefined; mode?: string[] | undefined; tag?: string[] | undefined; startTimeFrom?: string | undefined; startTimeTo?: string | undefined; createdTimeFrom?: string | undefined; createdTimeTo?: string | undefined; endTimeFrom?: string | undefined; endTimeTo?: string | undefined; durationSecondsFrom?: number | undefined; durationSecondsTo?: number | undefined; variableValuesId?: string[] | undefined; parentRunId?: string[] | undefined; type?: string[] | undefined; componentProps?: { type?: string | undefined; } | undefined; }, signal?: AbortSignal | undefined): Promise<{ group?: { [key: string]: string; } | undefined; jobs?: { id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }[] | undefined; }[]>`
-- `api.queue.searchJobs(query?: { id?: string[] | undefined; runId?: string[] | undefined; branchId?: string[] | undefined; tokenId?: string[] | undefined; tokenDescription?: string[] | undefined; componentId?: string[] | undefined; component?: string[] | undefined; configId?: string[] | undefined; config?: string[] | undefined; configRowIds?: string[] | undefined; mode?: ("run" | "debug")[] | undefined; status?: ("error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled")[] | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; componentProps?: { type?: string | undefined; } | undefined; createdTimeFrom?: string | undefined; createdTimeTo?: string | undefined; startTimeFrom?: string | undefined; startTimeTo?: string | undefined; endTimeFrom?: string | undefined; endTimeTo?: string | undefined; durationSecondsFrom?: number | undefined; durationSecondsTo?: number | undefined; offset?: number | undefined; limit?: number | undefined; sortBy?: "id" | "branchId" | "runId" | "componentId" | "projectId" | "configId" | "tokenDescription" | "status" | "createdTime" | "durationSeconds" | "startTime" | "endTime" | "updatedTime" | undefined; sortOrder?: "asc" | "desc" | undefined; parentRunId?: string | undefined; } | undefined, signal?: AbortSignal | undefined): Promise<{ id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }[]>`
+- `api.queue.killJob(jobId: string, signal?: AbortSignal | undefined): Promise<{ id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; runtimeTimezone?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }>`
+- `api.queue.poller({ init, interval, maxAttempts, timeout, signal, }: QueueJobPollOptions & { init: JobRef | ((signal: AbortSignal) => Promise<JobRef>); }): Poller<{ id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; runtimeTimezone?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }, { id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; runtimeTimezone?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }>`
+- `api.queue.searchAllJobs(query: { branchId?: string[] | undefined; runId?: string[] | undefined; componentId?: string[] | undefined; configId?: string[] | undefined; id?: string[] | undefined; mode?: ("run" | "debug")[] | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; config?: string[] | undefined; tokenId?: string[] | undefined; tokenDescription?: string[] | undefined; component?: string[] | undefined; configRowIds?: string[] | undefined; status?: ("error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled")[] | undefined; componentProps?: { type?: string | undefined; } | undefined; createdTimeFrom?: string | undefined; createdTimeTo?: string | undefined; startTimeFrom?: string | undefined; startTimeTo?: string | undefined; endTimeFrom?: string | undefined; endTimeTo?: string | undefined; durationSecondsFrom?: number | undefined; durationSecondsTo?: number | undefined; limit?: number | undefined; sortBy?: "branchId" | "runId" | "componentId" | "projectId" | "configId" | "id" | "tokenDescription" | "status" | "createdTime" | "durationSeconds" | "startTime" | "endTime" | "updatedTime" | undefined; sortOrder?: "asc" | "desc" | undefined; parentRunId?: string | undefined; }, signal?: AbortSignal | undefined): Promise<{ id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; runtimeTimezone?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }[]>`
+- `api.queue.searchGroupedJobs(query: { groupBy: ("branchId" | "componentId" | "projectId" | "configId")[]; jobsPerGroup?: number | undefined; sortBy?: "branchId" | "runId" | "componentId" | "projectId" | "configId" | "id" | "tokenDescription" | "status" | "createdTime" | "durationSeconds" | "startTime" | "endTime" | "updatedTime" | undefined; sortOrder?: "asc" | "desc" | undefined; limit?: number | undefined; id?: number[] | undefined; runId?: string[] | undefined; branchId?: string[] | undefined; configId?: string[] | undefined; config?: string[] | undefined; configRowIds?: string[] | undefined; projectId?: string[] | undefined; tokenId?: string[] | undefined; tokenDescription?: string[] | undefined; componentId?: string[] | undefined; component?: string[] | undefined; status?: string[] | undefined; desiredStatus?: string[] | undefined; mode?: string[] | undefined; tag?: string[] | undefined; startTimeFrom?: string | undefined; startTimeTo?: string | undefined; createdTimeFrom?: string | undefined; createdTimeTo?: string | undefined; endTimeFrom?: string | undefined; endTimeTo?: string | undefined; durationSecondsFrom?: number | undefined; durationSecondsTo?: number | undefined; variableValuesId?: string[] | undefined; parentRunId?: string[] | undefined; type?: string[] | undefined; componentProps?: { type?: string | undefined; } | undefined; }, signal?: AbortSignal | undefined): Promise<{ group?: { [key: string]: string; } | undefined; jobs?: { id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; runtimeTimezone?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }[] | undefined; }[]>`
+- `api.queue.searchJobs(query?: { id?: string[] | undefined; runId?: string[] | undefined; branchId?: string[] | undefined; tokenId?: string[] | undefined; tokenDescription?: string[] | undefined; componentId?: string[] | undefined; component?: string[] | undefined; configId?: string[] | undefined; config?: string[] | undefined; configRowIds?: string[] | undefined; mode?: ("run" | "debug")[] | undefined; status?: ("error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled")[] | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; componentProps?: { type?: string | undefined; } | undefined; createdTimeFrom?: string | undefined; createdTimeTo?: string | undefined; startTimeFrom?: string | undefined; startTimeTo?: string | undefined; endTimeFrom?: string | undefined; endTimeTo?: string | undefined; durationSecondsFrom?: number | undefined; durationSecondsTo?: number | undefined; offset?: number | undefined; limit?: number | undefined; sortBy?: "branchId" | "runId" | "componentId" | "projectId" | "configId" | "id" | "tokenDescription" | "status" | "createdTime" | "durationSeconds" | "startTime" | "endTime" | "updatedTime" | undefined; sortOrder?: "asc" | "desc" | undefined; parentRunId?: string | undefined; } | undefined, signal?: AbortSignal | undefined): Promise<{ id: string; runId: string; branchId?: string | undefined; project: { id: string; }; token: { id?: string | undefined; description?: string | undefined; }; status: "error" | "success" | "warning" | "created" | "waiting" | "processing" | "terminating" | "terminated" | "cancelled"; desiredStatus?: "processing" | "terminating" | null | undefined; component: string; mode: "run" | "debug"; tag?: string | null | undefined; config?: string | null | undefined; configRow?: string | null | undefined; configData?: Record<string, never> | null | undefined; result?: { images?: { digests?: string[] | undefined; id?: string | undefined; }[] | undefined; configVersion?: number | undefined; message?: string | undefined; } | null | undefined; createdTime: string; startTime?: string | null | undefined; endTime?: string | null | undefined; delayedStartTime?: string | null | undefined; durationSeconds?: number | null | undefined; isFinished: boolean; isSuccess: boolean | null; url: string; variableValuesId?: string | null | undefined; variableValuesData?: { values?: { name?: string | undefined; value?: string | undefined; }[] | undefined; } | null | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | null | undefined; metrics?: { storage?: { inputTablesBytesSum?: number | undefined; outputTablesBytesSum?: number | undefined; } | undefined; backend?: { type?: string | undefined; containerType?: string | undefined; context?: string | undefined; } | undefined; } | null | undefined; type?: "standard" | "container" | "phaseContainer" | "orchestrationContainer" | "retryContainer" | undefined; orchestrationTaskId?: string | null | undefined; previousJobId?: string | null | undefined; runtimeTimezone?: string | null | undefined; onlyOrchestrationTaskIds?: string[] | null | undefined; onlyFlowTaskIds?: string[] | null | undefined; }[]>`