@keboola/api-client 12.0.0 → 13.0.0

package/dist/{types-BVldT2vs.d.cts → types-CD0r-1MV.d.cts}

@@ -1,4 +1,4 @@
-import { c as OpenapiQueryType, d as OpenapiPathType, b as OpenapiBodyType, a as OpenapiReturnType } from './types-jKnx7Tm_.cjs';
+import { d as OpenapiQueryType, c as OpenapiPathType, b as OpenapiBodyType, a as OpenapiReturnType } from './types-auVqO7UT.cjs';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/{types-CvHPHNH0.d.cts → types-CaoEwPpD.d.cts}

@@ -1,4 +1,4 @@
-import { b as OpenapiBodyType, a as OpenapiReturnType } from './types-jKnx7Tm_.cjs';
+import { b as OpenapiBodyType, a as OpenapiReturnType } from './types-auVqO7UT.cjs';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/{types-BxjcUj-y.d.cts → types-Coaofyh9.d.cts}

@@ -1,4 +1,4 @@
-import { d as OpenapiPathType, c as OpenapiQueryType, a as OpenapiReturnType } from './types-jKnx7Tm_.cjs';
+import { c as OpenapiPathType, d as OpenapiQueryType, a as OpenapiReturnType } from './types-auVqO7UT.cjs';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/{types-GmAeMsok.d.ts → types-Ct6wJf9k.d.ts}

@@ -1,5 +1,5 @@
 import { B as Backend, A as AdminRole } from './backends-BgUzAQul.js';
-import { a as OpenapiReturnType } from './types-jKnx7Tm_.js';
+import { a as OpenapiReturnType } from './types-auVqO7UT.js';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/{types-CS8MYc2k.d.ts → types-CyQJ4AXd.d.ts}

@@ -1,4 +1,4 @@
-import { c as OpenapiQueryType, d as OpenapiPathType, b as OpenapiBodyType, a as OpenapiReturnType } from './types-jKnx7Tm_.js';
+import { d as OpenapiQueryType, c as OpenapiPathType, b as OpenapiBodyType, a as OpenapiReturnType } from './types-auVqO7UT.js';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/{types-DFWnAftN.d.cts → types-DHA8WCNr.d.ts}

@@ -1,4 +1,4 @@
-import { c as OpenapiQueryType, b as OpenapiBodyType, a as OpenapiReturnType, A as ArrayElement } from './types-jKnx7Tm_.cjs';
+import { d as OpenapiQueryType, b as OpenapiBodyType, a as OpenapiReturnType, A as ArrayElement } from './types-auVqO7UT.js';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/{types-D64zThBJ.d.ts → types-DLUrR6Xu.d.ts}

@@ -1,5 +1,5 @@
 import { createEncryptionClient } from './encryption/index.js';
-import { P as ProjectId } from './types-GmAeMsok.js';
+import { P as ProjectId } from './types-Ct6wJf9k.js';
 import { createVaultClient } from './vault/index.js';
 
 type VaultClient = ReturnType<typeof createVaultClient>;

package/dist/{types-CFd7q2ed.d.ts → types-DLWBh7iV.d.ts}

@@ -1,4 +1,4 @@
-import { b as OpenapiBodyType, d as OpenapiPathType, c as OpenapiQueryType, a as OpenapiReturnType } from './types-jKnx7Tm_.js';
+import { b as OpenapiBodyType, c as OpenapiPathType, d as OpenapiQueryType, a as OpenapiReturnType } from './types-auVqO7UT.js';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/{types-CMEwVQ78.d.cts → types-DclddzzB.d.cts}

@@ -1,5 +1,5 @@
 import { B as Backend, A as AdminRole } from './backends-BgUzAQul.cjs';
-import { a as OpenapiReturnType } from './types-jKnx7Tm_.cjs';
+import { a as OpenapiReturnType } from './types-auVqO7UT.cjs';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/{types-Bc-H4gfv.d.cts → types-QLM97gSa.d.cts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { c as OpenapiQueryType, d as OpenapiPathType, b as OpenapiBodyType, a as OpenapiReturnType } from './types-jKnx7Tm_.cjs';
+import { d as OpenapiQueryType, c as OpenapiPathType, b as OpenapiBodyType, a as OpenapiReturnType } from './types-auVqO7UT.cjs';
 
 /**
  * This file was auto-generated by openapi-typescript.
@@ -1256,6 +1256,12 @@ type components = {
       visibility: 'public' | 'private';
       /** @description Keboola branch ID that the chat operates in */
       branchId?: number | null;
+      /** @description Latest context-window fill for this conversation (persisted at turn-end), for rehydrating the usage indicator on load. Null until the first turn. */
+      contextWindow?: {
+        usedTokens: number;
+        maxTokens: number;
+        percentage: number;
+      } | null;
       messages: components['schemas']['Message'][];
     };
     /** @description Streamed as an error event when the conversation is too long and compaction has been triggered. The client should poll the original chat for a compactedTo metadata message to discover the new chat ID. */

package/dist/{types-JvKRS8Qd.d.ts → types-R6KVJSvx.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { c as OpenapiQueryType, d as OpenapiPathType, b as OpenapiBodyType, a as OpenapiReturnType } from './types-jKnx7Tm_.js';
+import { d as OpenapiQueryType, c as OpenapiPathType, b as OpenapiBodyType, a as OpenapiReturnType } from './types-auVqO7UT.js';
 
 /**
  * This file was auto-generated by openapi-typescript.
@@ -1256,6 +1256,12 @@ type components = {
       visibility: 'public' | 'private';
       /** @description Keboola branch ID that the chat operates in */
       branchId?: number | null;
+      /** @description Latest context-window fill for this conversation (persisted at turn-end), for rehydrating the usage indicator on load. Null until the first turn. */
+      contextWindow?: {
+        usedTokens: number;
+        maxTokens: number;
+        percentage: number;
+      } | null;
       messages: components['schemas']['Message'][];
     };
     /** @description Streamed as an error event when the conversation is too long and compaction has been triggered. The client should poll the original chat for a compactedTo metadata message to discover the new chat ID. */

package/dist/{types-D3Kkh6yW.d.ts → types-_uKmxlZr.d.ts}

@@ -1,4 +1,4 @@
-import { b as OpenapiBodyType, a as OpenapiReturnType } from './types-jKnx7Tm_.js';
+import { b as OpenapiBodyType, a as OpenapiReturnType } from './types-auVqO7UT.js';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/{types-jKnx7Tm_.d.cts → types-auVqO7UT.d.cts}

@@ -61,4 +61,4 @@ type OpenapiSuccessType<T> = 200 extends keyof T ? T[200] : 201 extends keyof T
 type OpenapiReturnType<OP> = OpenapiSuccessType<OpenapiResponseTypes<OP>>;
 type ArrayElement<T> = T extends (infer U)[] ? U : never;
 
-export type { ArrayElement as A, OpenapiParametersType as O, OpenapiReturnType as a, OpenapiBodyType as b, OpenapiQueryType as c, OpenapiPathType as d };
+export type { ArrayElement as A, OpenapiParametersType as O, OpenapiReturnType as a, OpenapiBodyType as b, OpenapiPathType as c, OpenapiQueryType as d };

package/dist/{types-jKnx7Tm_.d.ts → types-auVqO7UT.d.ts}

@@ -61,4 +61,4 @@ type OpenapiSuccessType<T> = 200 extends keyof T ? T[200] : 201 extends keyof T
 type OpenapiReturnType<OP> = OpenapiSuccessType<OpenapiResponseTypes<OP>>;
 type ArrayElement<T> = T extends (infer U)[] ? U : never;
 
-export type { ArrayElement as A, OpenapiParametersType as O, OpenapiReturnType as a, OpenapiBodyType as b, OpenapiQueryType as c, OpenapiPathType as d };
+export type { ArrayElement as A, OpenapiParametersType as O, OpenapiReturnType as a, OpenapiBodyType as b, OpenapiPathType as c, OpenapiQueryType as d };

package/dist/{types-Dv3vN7M9.d.ts → types-kPz1WIPX.d.cts}

@@ -1,4 +1,4 @@
-import { c as OpenapiQueryType, b as OpenapiBodyType, a as OpenapiReturnType, A as ArrayElement } from './types-jKnx7Tm_.js';
+import { d as OpenapiQueryType, b as OpenapiBodyType, a as OpenapiReturnType, A as ArrayElement } from './types-auVqO7UT.cjs';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/{types-Mghz1gMD.d.ts → types-njJEULW3.d.ts}

@@ -1,4 +1,4 @@
-import { a as OpenapiReturnType, d as OpenapiPathType, b as OpenapiBodyType } from './types-jKnx7Tm_.js';
+import { a as OpenapiReturnType, c as OpenapiPathType, b as OpenapiBodyType } from './types-auVqO7UT.js';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/{types-DacFMc6L.d.ts → types-rgoWljL8.d.ts}

@@ -1,4 +1,4 @@
-import { d as OpenapiPathType, c as OpenapiQueryType, a as OpenapiReturnType } from './types-jKnx7Tm_.js';
+import { c as OpenapiPathType, d as OpenapiQueryType, a as OpenapiReturnType } from './types-auVqO7UT.js';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/{utils-Cl4emy8g.d.ts → utils-BcMjZotB.d.ts}

@@ -1,4 +1,4 @@
-import { d as OpenapiPathType, c as OpenapiQueryType, b as OpenapiBodyType, a as OpenapiReturnType } from './types-jKnx7Tm_.js';
+import { c as OpenapiPathType, d as OpenapiQueryType, b as OpenapiBodyType, a as OpenapiReturnType } from './types-auVqO7UT.js';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/{utils-JsCYFmHj.d.cts → utils-IEMDjlU4.d.cts}

@@ -1,4 +1,4 @@
-import { d as OpenapiPathType, c as OpenapiQueryType, b as OpenapiBodyType, a as OpenapiReturnType } from './types-jKnx7Tm_.cjs';
+import { c as OpenapiPathType, d as OpenapiQueryType, b as OpenapiBodyType, a as OpenapiReturnType } from './types-auVqO7UT.cjs';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/vault/index.d.cts

@@ -1,7 +1,7 @@
 import { C as ClientInitOptions } from '../types-BLJoO6YL.cjs';
 import { CreateVariableBody, DeleteVariablePath, VariableWithHash, GetVariablesQuery, GetVariablesByBranchId } from './types.cjs';
 import 'qs';
-import '../types-jKnx7Tm_.cjs';
+import '../types-auVqO7UT.cjs';
 
 declare const createVaultClient: ({ baseUrl, middlewares, token }: ClientInitOptions) => {
     createVariable: (body: CreateVariableBody, signal?: AbortSignal) => Promise<{

package/dist/vault/index.d.ts

@@ -1,7 +1,7 @@
 import { C as ClientInitOptions } from '../types-BLJoO6YL.js';
 import { CreateVariableBody, DeleteVariablePath, VariableWithHash, GetVariablesQuery, GetVariablesByBranchId } from './types.js';
 import 'qs';
-import '../types-jKnx7Tm_.js';
+import '../types-auVqO7UT.js';
 
 declare const createVaultClient: ({ baseUrl, middlewares, token }: ClientInitOptions) => {
     createVariable: (body: CreateVariableBody, signal?: AbortSignal) => Promise<{

package/dist/vault/types.d.cts

@@ -1,4 +1,4 @@
-import { b as OpenapiBodyType, A as ArrayElement, a as OpenapiReturnType, d as OpenapiPathType, c as OpenapiQueryType } from '../types-jKnx7Tm_.cjs';
+import { b as OpenapiBodyType, A as ArrayElement, a as OpenapiReturnType, c as OpenapiPathType, d as OpenapiQueryType } from '../types-auVqO7UT.cjs';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/vault/types.d.ts

@@ -1,4 +1,4 @@
-import { b as OpenapiBodyType, A as ArrayElement, a as OpenapiReturnType, d as OpenapiPathType, c as OpenapiQueryType } from '../types-jKnx7Tm_.js';
+import { b as OpenapiBodyType, A as ArrayElement, a as OpenapiReturnType, c as OpenapiPathType, d as OpenapiQueryType } from '../types-auVqO7UT.js';
 
 /**
  * This file was auto-generated by openapi-typescript.

package/dist/verify/index.d.cts

@@ -1,7 +1,7 @@
-import { S as StorageToken } from '../types-CMEwVQ78.cjs';
+import { S as StorageToken } from '../types-DclddzzB.cjs';
 import { ManagementToken } from './types.cjs';
 import '../backends-BgUzAQul.cjs';
-import '../types-jKnx7Tm_.cjs';
+import '../types-auVqO7UT.cjs';
 
 declare const createVerifyClient: () => {
     storageApiToken: (host: string, token: string, signal?: AbortSignal) => Promise<StorageToken>;

package/dist/verify/index.d.ts

@@ -1,7 +1,7 @@
-import { S as StorageToken } from '../types-GmAeMsok.js';
+import { S as StorageToken } from '../types-Ct6wJf9k.js';
 import { ManagementToken } from './types.js';
 import '../backends-BgUzAQul.js';
-import '../types-jKnx7Tm_.js';
+import '../types-auVqO7UT.js';
 
 declare const createVerifyClient: () => {
     storageApiToken: (host: string, token: string, signal?: AbortSignal) => Promise<StorageToken>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keboola/api-client",
-  "version": "12.0.0",
+  "version": "13.0.0",
   "description": "TypeScript SDK for Keboola APIs",
   "license": "MIT",
   "type": "module",
@@ -27,6 +27,12 @@
       "assets/types": [
         "./dist/assets/types.d.ts"
       ],
+      "auth": [
+        "./dist/auth/index.d.ts"
+      ],
+      "auth/types": [
+        "./dist/auth/types.d.ts"
+      ],
       "chat": [
         "./dist/chat/index.d.ts"
       ],
@@ -242,6 +248,26 @@
         "default": "./dist/assets/types.cjs"
       }
     },
+    "./auth": {
+      "import": {
+        "types": "./dist/auth/index.d.ts",
+        "default": "./dist/auth/index.js"
+      },
+      "require": {
+        "types": "./dist/auth/index.d.cts",
+        "default": "./dist/auth/index.cjs"
+      }
+    },
+    "./auth/types": {
+      "import": {
+        "types": "./dist/auth/types.d.ts",
+        "default": "./dist/auth/types.js"
+      },
+      "require": {
+        "types": "./dist/auth/types.d.cts",
+        "default": "./dist/auth/types.cjs"
+      }
+    },
     "./chat": {
       "import": {
         "types": "./dist/chat/index.d.ts",
@@ -715,14 +741,14 @@
     "esbuild": "^0.28.1",
     "msw": "^2.14.6",
     "openapi-typescript": "7.10.1",
-    "oxfmt": "^0.44.0",
-    "oxlint": "^1.56.0",
+    "oxfmt": "^0.57.0",
+    "oxlint": "^1.72.0",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
     "vite": "^8.0.16",
     "vitest": "^4.1.8",
     "yaml": "^2.8.3",
-    "@keboola/oxlint-config": "^2.0.0",
+    "@keboola/oxlint-config": "^2.0.1",
     "@keboola/tsconfig": "^0.1.2"
   },
   "scripts": {

package/surface/auth.md

@@ -0,0 +1,27 @@
+# `api.auth` — `@keboola/api-client` surface
+
+<!-- GENERATED FILE — do not edit by hand. Run `pnpm --filter @keboola/api-client surface` to regenerate. -->
+
+Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
+
+- `api.auth.approveDeviceAuthorization(body: { userCode: string; decision: "approve" | "deny"; }, signal?: AbortSignal | undefined): Promise<{ status: "approved" | "denied"; idempotent: boolean; decision: "approve" | "deny"; }>`
+- `api.auth.assertSaml(body: { samlResponse: string; requestHandle: string; customerSlug: string | null; }, signal?: AbortSignal | undefined): Promise<{ accessToken: string; refreshToken: string; tokenType: string; expiresIn: number; sessionId: string; user: { id: number; email: string; name: string; }; } | { mfaRequired: boolean; mfaType: string; mfaToken: string; expiresIn: number; allowedMethods: string[]; webauthn: Record<string, never> | null; }>`
+- `api.auth.createDeviceAuthorization(body: { clientId: string; scope: { credentialType?: "session" | undefined; }; requestedCredentialType: string; }, signal?: AbortSignal | undefined): Promise<{ deviceCode: string; userCode: string; verificationUri: string; verificationUriComplete: string; expiresIn: number; interval: number; }>`
+- `api.auth.createPat(body: { name: string; expiresIn: number | null; scope: { projects: string[] | null; readOnly: boolean | null; } | null; }, signal?: AbortSignal | undefined): Promise<{ accessToken: string; tokenType: string; expiresIn: number; pat: { id: string; name: string; scope: Record<string, never>; projects: { id: number; name: string | null; role: string | null; }[]; readOnly: boolean; parentTokenId?: string | null | undefined; parentTokenType?: "session" | "pat" | null | undefined; expiresAt: string; lastUsedAt?: string | null | undefined; createdAt: string; }; }>`
+- `api.auth.createSudoChallenge(signal?: AbortSignal | undefined): Promise<{ challengeToken: string; options: Record<string, never>; expiresIn: number; }>`
+- `api.auth.exchangePat(body?: { expiresIn: number | null; scope: { projects: string[] | null; readOnly: boolean | null; } | null; } | undefined, signal?: AbortSignal | undefined): Promise<{ accessToken: string; tokenType: string; expiresIn: number; scope: Record<string, never>; readOnly: boolean; parentTokenId: string; parentTokenType: "session" | "pat"; expiresAt: string; pat: { id: string; name: string; scope: Record<string, never>; projects: { id: number; name: string | null; role: string | null; }[]; readOnly: boolean; parentTokenId?: string | null | undefined; parentTokenType?: "session" | "pat" | null | undefined; expiresAt: string; lastUsedAt?: string | null | undefined; createdAt: string; }; }>`
+- `api.auth.getDeviceAuthorizationToken(body: { clientId: string; deviceCode: string; }, signal?: AbortSignal | undefined): Promise<{ accessToken: string; refreshToken: string; tokenType: string; expiresIn: number; sessionId: string; user: { id: number; email: string; name: string; }; }>`
+- `api.auth.getPkceToken(body: { clientId: string; code: string; redirectUri: string; state: string; codeVerifier: string; }, signal?: AbortSignal | undefined): Promise<{ accessToken: string; refreshToken: string; tokenType: string; expiresIn: number; sessionId: string; user: { id: number; email: string; name: string; }; }>`
+- `api.auth.initiateSaml(body?: { customerSlug: string | null; } | undefined, signal?: AbortSignal | undefined): Promise<{ ssoUrl: string; requestHandle: string; expiresIn: number; }>`
+- `api.auth.introspectToken(signal?: AbortSignal | undefined): Promise<{ sessionId: string; user: { id: number; email: string; name: string; }; grantType: string; sudoVerified: boolean; createdAt: string; expiresAt: string; lastUsedAt?: string | null | undefined; lastUsedIp?: string | null | undefined; userAgent?: string | null | undefined; projects: { id: number; name: string | null; role: string | null; }[]; }>`
+- `api.auth.listPats(signal?: AbortSignal | undefined): Promise<{ items: { id: string; name: string; scope: Record<string, never>; projects: { id: number; name: string | null; role: string | null; }[]; readOnly: boolean; parentTokenId?: string | null | undefined; parentTokenType?: "session" | "pat" | null | undefined; expiresAt: string; lastUsedAt?: string | null | undefined; createdAt: string; }[]; }>`
+- `api.auth.listSessions(signal?: AbortSignal | undefined): Promise<{ sessions?: { id: string; grantType: string; createdAt: string; lastUsedAt?: string | null | undefined; lastUsedIp?: string | null | undefined; userAgent?: string | null | undefined; accessTokenExpiresAt: string; refreshTokenExpiresAt: string; isCurrent: boolean; }[] | undefined; }>`
+- `api.auth.login(body: { grantType: "password" | "google" | "microsoft"; email: string | null; password: string | null; idToken: string | null; }, signal?: AbortSignal | undefined): Promise<{ accessToken: string; refreshToken: string; tokenType: string; expiresIn: number; sessionId: string; user: { id: number; email: string; name: string; }; } | { mfaRequired: boolean; mfaType: string; mfaToken: string; expiresIn: number; allowedMethods: string[]; webauthn: Record<string, never> | null; }>`
+- `api.auth.refreshToken(body: { refreshToken: string; }, signal?: AbortSignal | undefined): Promise<{ accessToken: string; refreshToken: string; tokenType: string; expiresIn: number; sessionId: string; user: { id: number; email: string; name: string; }; }>`
+- `api.auth.regenerateRecoveryCodes(signal?: AbortSignal | undefined): Promise<{ codes: string[]; }>`
+- `api.auth.revokeAllSessions(signal?: AbortSignal | undefined): Promise<void>`
+- `api.auth.revokePat(id: string, signal?: AbortSignal | undefined): Promise<void>`
+- `api.auth.revokeSession(sessionId: string, signal?: AbortSignal | undefined): Promise<void>`
+- `api.auth.revokeToken(body: { token: string; tokenTypeHint: "accessToken" | "refreshToken" | null; }, signal?: AbortSignal | undefined): Promise<void>`
+- `api.auth.sudo(body: { totpCode: string | null; recoveryCode: string | null; webauthnAssertion: string | null; challengeToken: string | null; type: string; }, signal?: AbortSignal | undefined): Promise<{ sudoVerified: boolean; sudoExpiresAt: string; sudoTimeoutSeconds: number; }>`
+- `api.auth.verifyMfa(body: { mfaToken: string; type: "totp" | "recovery_code" | "webauthn"; code: string | null; assertion: string | null; }, signal?: AbortSignal | undefined): Promise<{ accessToken: string; refreshToken: string; tokenType: string; expiresIn: number; sessionId: string; user: { id: number; email: string; name: string; }; }>`

package/surface/chat.md

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