@athenaintel/sdk 4.3.2243 → 4.3.2245

package/dist/cjs/api/resources/databases/client/Client.js

@@ -70,10 +70,13 @@ class DatabasesClient {
      *
      * **Status Values:**
      * - `running` - Database is active and accepting connections
-     * - `suspended` - Database is suspended (scale-to-zero), will auto-resume on first query
-     * - `starting` - Database is waking up
-     * - `failed` - Database failed to start
-     * - `unknown` - Status could not be determined
+     * - `suspended` - Database is suspended (scale-to-zero). It wakes on `POST /databases/{asset_id}/wake` or on the first SQL request. When `reason` is `ComputeUnschedulable`, no node could host its compute size: waking it only restarts the same wait
+     * - `starting` - Database is waking up, or its compute is being recreated
+     * - `creating` - Database is being created; it has no compute yet
+     * - `failed` - Database failed to start, or its creation failed (`message` says which)
+     * - `unknown` - Status could not be determined (the control plane did not answer); retry
+     *
+     * A database suspends (scales to zero) after `suspend_timeout_seconds` without activity; `GET`/`PATCH /databases/{asset_id}/settings` read and set that window, and 0 keeps it running. Reading the compute status or the settings never wakes a suspended database. Two things do: `POST /databases/{asset_id}/wake`, which answers at once while the compute starts, or any request that runs SQL on it, such as `POST /databases/{asset_id}/sql`, which waits for the compute up to 120 seconds; if the compute is still starting then, the answer is 503 with `Retry-After` and the statement did not run. A cold start usually takes 30 seconds to 2 minutes.
      *
      * @param {AthenaIntelligence.GetStatusDatabasesRequest} request
      * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -793,6 +796,200 @@ class DatabasesClient {
             }
         });
     }
+    /**
+     * Read the database's auto-suspend window, the same setting as auto-suspend in the database's Settings in Athena. Reading never wakes the database.
+     *
+     * A database suspends (scales to zero) after `suspend_timeout_seconds` without activity; `GET`/`PATCH /databases/{asset_id}/settings` read and set that window, and 0 keeps it running. Reading the compute status or the settings never wakes a suspended database. Two things do: `POST /databases/{asset_id}/wake`, which answers at once while the compute starts, or any request that runs SQL on it, such as `POST /databases/{asset_id}/sql`, which waits for the compute up to 120 seconds; if the compute is still starting then, the answer is 503 with `Retry-After` and the statement did not run. A cold start usually takes 30 seconds to 2 minutes.
+     *
+     * @param {AthenaIntelligence.GetSettingsDatabasesRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.ConflictError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.NotImplementedError}
+     * @throws {@link AthenaIntelligence.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.databases.getSettings({
+     *         asset_id: "asset_id"
+     *     })
+     */
+    getSettings(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getSettings(request, requestOptions));
+    }
+    __getSettings(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+            const { asset_id: assetId } = request;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
+                "X-Athena-Session-Credential": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.sessionCredential) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.sessionCredential,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
+                url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.AthenaIntelligenceEnvironment.Production, `api/v0/databases/${core.url.encodePathParam(assetId)}/settings`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_j = (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.timeoutInSeconds) !== null && _j !== void 0 ? _j : 60) * 1000,
+                maxRetries: (_k = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _k !== void 0 ? _k : (_l = this._options) === null || _l === void 0 ? void 0 : _l.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new AthenaIntelligence.ConflictError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new AthenaIntelligence.NotImplementedError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new AthenaIntelligence.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AthenaIntelligenceError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling GET /api/v0/databases/{asset_id}/settings.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Set the database's auto-suspend window: 0 keeps the database running (it never suspends, and keeps using compute capacity), otherwise 60 to 86400 seconds. The same setting, values and edit-access rule as auto-suspend in the database's Settings in Athena; the change applies at once and does not restart or wake the database.
+     *
+     * A database suspends (scales to zero) after `suspend_timeout_seconds` without activity; `GET`/`PATCH /databases/{asset_id}/settings` read and set that window, and 0 keeps it running. Reading the compute status or the settings never wakes a suspended database. Two things do: `POST /databases/{asset_id}/wake`, which answers at once while the compute starts, or any request that runs SQL on it, such as `POST /databases/{asset_id}/sql`, which waits for the compute up to 120 seconds; if the compute is still starting then, the answer is 503 with `Retry-After` and the statement did not run. A cold start usually takes 30 seconds to 2 minutes.
+     *
+     * @param {AthenaIntelligence.DatabaseComputeSettingsUpdateRequestIn} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.ConflictError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.NotImplementedError}
+     * @throws {@link AthenaIntelligence.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.databases.updateSettings({
+     *         asset_id: "asset_id",
+     *         suspend_timeout_seconds: 3600
+     *     })
+     */
+    updateSettings(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__updateSettings(request, requestOptions));
+    }
+    __updateSettings(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+            const { asset_id: assetId } = request, _body = __rest(request, ["asset_id"]);
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
+                "X-Athena-Session-Credential": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.sessionCredential) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.sessionCredential,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
+                url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.AthenaIntelligenceEnvironment.Production, `api/v0/databases/${core.url.encodePathParam(assetId)}/settings`),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: _body,
+                timeoutMs: ((_j = (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.timeoutInSeconds) !== null && _j !== void 0 ? _j : 60) * 1000,
+                maxRetries: (_k = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _k !== void 0 ? _k : (_l = this._options) === null || _l === void 0 ? void 0 : _l.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new AthenaIntelligence.ConflictError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new AthenaIntelligence.NotImplementedError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new AthenaIntelligence.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AthenaIntelligenceError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling PATCH /api/v0/databases/{asset_id}/settings.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Execute a SQL statement against the database. SELECT queries return columns and rows. Non-SELECT statements (CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, etc.) return execution statuses.
      *
@@ -890,5 +1087,100 @@ class DatabasesClient {
             }
         });
     }
+    /**
+     * Start a suspended database's compute and answer at once, without waiting for it to run. Poll `GET /databases/{asset_id}/compute-status` until it reports `running`. Waking a running database resets its idle clock and answers 200 with `running`, so it is safe to call before every batch of work. The same action as Resume Database in Athena; it needs edit access to the database.
+     *
+     * A database suspends (scales to zero) after `suspend_timeout_seconds` without activity; `GET`/`PATCH /databases/{asset_id}/settings` read and set that window, and 0 keeps it running. Reading the compute status or the settings never wakes a suspended database. Two things do: `POST /databases/{asset_id}/wake`, which answers at once while the compute starts, or any request that runs SQL on it, such as `POST /databases/{asset_id}/sql`, which waits for the compute up to 120 seconds; if the compute is still starting then, the answer is 503 with `Retry-After` and the statement did not run. A cold start usually takes 30 seconds to 2 minutes.
+     *
+     * @param {AthenaIntelligence.WakeDatabasesRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.ConflictError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.NotImplementedError}
+     * @throws {@link AthenaIntelligence.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.databases.wake({
+     *         asset_id: "asset_id"
+     *     })
+     */
+    wake(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__wake(request, requestOptions));
+    }
+    __wake(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+            const { asset_id: assetId } = request;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
+                "X-Athena-Session-Credential": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.sessionCredential) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.sessionCredential,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
+                url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.AthenaIntelligenceEnvironment.Production, `api/v0/databases/${core.url.encodePathParam(assetId)}/wake`),
+                method: "POST",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_j = (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.timeoutInSeconds) !== null && _j !== void 0 ? _j : 60) * 1000,
+                maxRetries: (_k = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _k !== void 0 ? _k : (_l = this._options) === null || _l === void 0 ? void 0 : _l.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new AthenaIntelligence.ConflictError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new AthenaIntelligence.NotImplementedError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new AthenaIntelligence.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AthenaIntelligenceError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling POST /api/v0/databases/{asset_id}/wake.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
 }
 exports.DatabasesClient = DatabasesClient;

package/dist/cjs/api/resources/databases/client/requests/DatabaseComputeSettingsUpdateRequestIn.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_id",
+ *         suspend_timeout_seconds: 3600
+ *     }
+ */
+export interface DatabaseComputeSettingsUpdateRequestIn {
+    asset_id: string;
+    /** Seconds without activity after which the database suspends (scales to zero). 0 means it never suspends: the compute keeps running, and keeps using capacity, until you change this. Otherwise 60 to 86400 (24 hours). A new database starts with 1800 (30 minutes). The same setting as auto-suspend in the database's Settings in Athena. */
+    suspend_timeout_seconds: number;
+}

package/dist/cjs/api/resources/databases/client/requests/DatabaseComputeSettingsUpdateRequestIn.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/databases/client/requests/GetSettingsDatabasesRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_id"
+ *     }
+ */
+export interface GetSettingsDatabasesRequest {
+    asset_id: string;
+}

package/dist/cjs/api/resources/databases/client/requests/GetSettingsDatabasesRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/databases/client/requests/WakeDatabasesRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_id"
+ *     }
+ */
+export interface WakeDatabasesRequest {
+    asset_id: string;
+}

package/dist/cjs/api/resources/databases/client/requests/WakeDatabasesRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/databases/client/requests/index.d.ts

@@ -1,8 +1,11 @@
+export type { DatabaseComputeSettingsUpdateRequestIn } from "./DatabaseComputeSettingsUpdateRequestIn.js";
 export type { DatabaseSqlRequest } from "./DatabaseSqlRequest.js";
 export type { DeleteDatabasesRequest } from "./DeleteDatabasesRequest.js";
+export type { GetSettingsDatabasesRequest } from "./GetSettingsDatabasesRequest.js";
 export type { GetStatusDatabasesRequest } from "./GetStatusDatabasesRequest.js";
 export type { GetTableSchemaDatabasesRequest } from "./GetTableSchemaDatabasesRequest.js";
 export type { InsertDataRequest } from "./InsertDataRequest.js";
 export type { ListTablesDatabasesRequest } from "./ListTablesDatabasesRequest.js";
 export type { SelectDatabasesRequest } from "./SelectDatabasesRequest.js";
 export type { UpdateDataRequest } from "./UpdateDataRequest.js";
+export type { WakeDatabasesRequest } from "./WakeDatabasesRequest.js";

package/dist/cjs/api/resources/tools/resources/sheets/client/requests/UpdateSheetCellRequest.d.ts

@@ -1,3 +1,4 @@
+import type * as AthenaIntelligence from "../../../../../../index.js";
 /**
  * @example
  *     {
@@ -12,6 +13,8 @@ export interface UpdateSheetCellRequest {
     asset_id: string;
     /** 1-based column index (e.g., 1 = column A) */
     column: number;
+    /** Optional cell format (textFormat, backgroundColor, numberFormat, alignment, borders) applied in the same write as the value, like `formatting` on range/update. */
+    formatting?: AthenaIntelligence.CellFormat | null;
     /** 1-based row index (e.g., 1 = first row) */
     row: number;
     /** Sheet ID (defaults to 1) */

package/dist/cjs/api/types/ComputerStatusResponseOut.d.ts

@@ -0,0 +1,33 @@
+/**
+ * A computer's live runtime state, read without starting or waking it.
+ */
+export interface ComputerStatusResponseOut {
+    /** The computer asset id. */
+    asset_id: string;
+    /** Set when someone stopped the computer with Stop. While it is `stopping`, `stopped` or `uncertain`, implicit wakes are refused: minting SSH access answers 409 and an SSH connection does not start it. Call `start_computer` to clear it. `null` or `cleared` means no explicit stop is in force. */
+    explicit_stop?: ComputerStatusResponseOut.ExplicitStop | null;
+    /** Why `ready` is false; `null` when it is true. `not_started`: the computer is not running — call `start_computer`. `starting`: it is running and its guest is still coming up — keep polling. `unobservable`: readiness could not be read this time — keep polling. `launcher_outdated`: the computer runs an outdated runtime component that polling will not change — stop it and start it again to update it. */
+    not_ready_reason?: ComputerStatusResponseOut.NotReadyReason | null;
+    /** The computer's runtime provider (e.g. `talos_v2`). */
+    provider?: string | null;
+    /** Whether the computer serves work now: `state` is `started` and the guest answers ready (its workspace attached and its environment applied). Only then do commands, SSH sessions and deployed URLs reach the computer without first waiting for a start. `started` alone can come a few seconds before `ready`. */
+    ready: boolean;
+    /** The runtime's current state: `started` (running; check `ready`), `stopped` (suspended — by idle auto-stop or by Stop; files are kept), `restoring` (a start is in progress), `error` (the runtime failed; start or restart it), or `unknown` (the state could not be read this time; retry). `started`, `stopped` and `error` hold until something changes them; `restoring` and `unknown` are transient. */
+    state: string;
+}
+export declare namespace ComputerStatusResponseOut {
+    const ExplicitStop: {
+        readonly Stopping: "stopping";
+        readonly Stopped: "stopped";
+        readonly Uncertain: "uncertain";
+        readonly Cleared: "cleared";
+    };
+    type ExplicitStop = (typeof ExplicitStop)[keyof typeof ExplicitStop];
+    const NotReadyReason: {
+        readonly NotStarted: "not_started";
+        readonly Starting: "starting";
+        readonly LauncherOutdated: "launcher_outdated";
+        readonly Unobservable: "unobservable";
+    };
+    type NotReadyReason = (typeof NotReadyReason)[keyof typeof NotReadyReason];
+}

package/dist/cjs/api/types/ComputerStatusResponseOut.js

@@ -0,0 +1,19 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComputerStatusResponseOut = void 0;
+var ComputerStatusResponseOut;
+(function (ComputerStatusResponseOut) {
+    ComputerStatusResponseOut.ExplicitStop = {
+        Stopping: "stopping",
+        Stopped: "stopped",
+        Uncertain: "uncertain",
+        Cleared: "cleared",
+    };
+    ComputerStatusResponseOut.NotReadyReason = {
+        NotStarted: "not_started",
+        Starting: "starting",
+        LauncherOutdated: "launcher_outdated",
+        Unobservable: "unobservable",
+    };
+})(ComputerStatusResponseOut || (exports.ComputerStatusResponseOut = ComputerStatusResponseOut = {}));

package/dist/cjs/api/types/DatabaseComputeSettingsResponseOut.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The database's compute settings that the public API can read and set.
+ */
+export interface DatabaseComputeSettingsResponseOut {
+    /** The database asset ID */
+    asset_id: string;
+    /** Seconds without activity after which the database suspends (scales to zero). 0 means it never suspends: the compute keeps running, and keeps using capacity, until you change this. Otherwise 60 to 86400 (24 hours). A new database starts with 1800 (30 minutes). The same setting as auto-suspend in the database's Settings in Athena. */
+    suspend_timeout_seconds: number;
+}

package/dist/cjs/api/types/DatabaseComputeSettingsResponseOut.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/DatabaseStatusResponse.d.ts

@@ -11,6 +11,8 @@ export interface DatabaseStatusResponse {
     message?: string | null;
     /** Database provider ('kronos') */
     provider: string;
+    /** Why the compute is in this state, when the control plane says: `ComputeUnschedulable` on a `suspended` database means no node could host its compute size, so a wake only restarts the same wait; choose a smaller compute size in the database's Settings in Athena first. Absent on older control planes. */
+    reason?: string | null;
     /** Standardized database status */
     status: DatabaseStatusResponse.Status;
 }

package/dist/cjs/api/types/DatabaseWakeResponseOut.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Response for a wake request.
+ */
+export interface DatabaseWakeResponseOut {
+    /** The database asset ID */
+    asset_id: string;
+    /** Optional detail from the control plane */
+    message?: string | null;
+    /** `running`: the compute was already running; its idle clock was reset. `starting`: the compute is starting; poll `GET /databases/{asset_id}/compute-status` until it reports `running`. */
+    status: DatabaseWakeResponseOut.Status;
+}
+export declare namespace DatabaseWakeResponseOut {
+    /** `running`: the compute was already running; its idle clock was reset. `starting`: the compute is starting; poll `GET /databases/{asset_id}/compute-status` until it reports `running`. */
+    const Status: {
+        readonly Running: "running";
+        readonly Starting: "starting";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+}

package/dist/cjs/api/types/DatabaseWakeResponseOut.js

@@ -0,0 +1,12 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseWakeResponseOut = void 0;
+var DatabaseWakeResponseOut;
+(function (DatabaseWakeResponseOut) {
+    /** `running`: the compute was already running; its idle clock was reset. `starting`: the compute is starting; poll `GET /databases/{asset_id}/compute-status` until it reports `running`. */
+    DatabaseWakeResponseOut.Status = {
+        Running: "running",
+        Starting: "starting",
+    };
+})(DatabaseWakeResponseOut || (exports.DatabaseWakeResponseOut = DatabaseWakeResponseOut = {}));

package/dist/cjs/api/types/index.d.ts

@@ -41,6 +41,7 @@ export * from "./CollabAgentSendMessageResponseOut.js";
 export * from "./CollabTokenResponse.js";
 export * from "./ComputerInitializationResponse.js";
 export * from "./ComputerLifecycleResponseOut.js";
+export * from "./ComputerStatusResponseOut.js";
 export * from "./ConversationAssetInfo.js";
 export * from "./ConversationMessage.js";
 export * from "./ConversationResult.js";
@@ -51,6 +52,7 @@ export * from "./CreateAssetResponseOut.js";
 export * from "./CreateNewSheetTabResponse.js";
 export * from "./CreateProjectResponseOut.js";
 export * from "./DatabaseColumnInfo.js";
+export * from "./DatabaseComputeSettingsResponseOut.js";
 export * from "./DatabaseDataResponse.js";
 export * from "./DatabaseMutationResponse.js";
 export * from "./DatabaseSqlResponse.js";
@@ -58,6 +60,7 @@ export * from "./DatabaseStatusResponse.js";
 export * from "./DatabaseTableInfo.js";
 export * from "./DatabaseTableSchemaResponse.js";
 export * from "./DatabaseTablesResponse.js";
+export * from "./DatabaseWakeResponseOut.js";
 export * from "./DataFrameRequestOut.js";
 export * from "./DataFrameUnknownFormatError.js";
 export * from "./DefaultVisibility.js";

package/dist/cjs/api/types/index.js

@@ -57,6 +57,7 @@ __exportStar(require("./CollabAgentSendMessageResponseOut.js"), exports);
 __exportStar(require("./CollabTokenResponse.js"), exports);
 __exportStar(require("./ComputerInitializationResponse.js"), exports);
 __exportStar(require("./ComputerLifecycleResponseOut.js"), exports);
+__exportStar(require("./ComputerStatusResponseOut.js"), exports);
 __exportStar(require("./ConversationAssetInfo.js"), exports);
 __exportStar(require("./ConversationMessage.js"), exports);
 __exportStar(require("./ConversationResult.js"), exports);
@@ -67,6 +68,7 @@ __exportStar(require("./CreateAssetResponseOut.js"), exports);
 __exportStar(require("./CreateNewSheetTabResponse.js"), exports);
 __exportStar(require("./CreateProjectResponseOut.js"), exports);
 __exportStar(require("./DatabaseColumnInfo.js"), exports);
+__exportStar(require("./DatabaseComputeSettingsResponseOut.js"), exports);
 __exportStar(require("./DatabaseDataResponse.js"), exports);
 __exportStar(require("./DatabaseMutationResponse.js"), exports);
 __exportStar(require("./DatabaseSqlResponse.js"), exports);
@@ -74,6 +76,7 @@ __exportStar(require("./DatabaseStatusResponse.js"), exports);
 __exportStar(require("./DatabaseTableInfo.js"), exports);
 __exportStar(require("./DatabaseTableSchemaResponse.js"), exports);
 __exportStar(require("./DatabaseTablesResponse.js"), exports);
+__exportStar(require("./DatabaseWakeResponseOut.js"), exports);
 __exportStar(require("./DataFrameRequestOut.js"), exports);
 __exportStar(require("./DataFrameUnknownFormatError.js"), exports);
 __exportStar(require("./DefaultVisibility.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2243";
+export declare const SDK_VERSION = "4.3.2245";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "4.3.2243";
+exports.SDK_VERSION = "4.3.2245";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@athenaintel/sdk",
-        "X-Fern-SDK-Version": "4.3.2243",
-        "User-Agent": "@athenaintel/sdk/4.3.2243",
+        "X-Fern-SDK-Version": "4.3.2245",
+        "User-Agent": "@athenaintel/sdk/4.3.2245",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "X-Athena-Session-Credential": options === null || options === void 0 ? void 0 : options.sessionCredential,

package/dist/esm/api/resources/assets/client/Client.d.mts

@@ -50,7 +50,7 @@ export declare class AssetsClient {
     convertExcelToSheet(request: AthenaIntelligence.ConvertExcelToSheetRequestIn, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.ConvertExcelToSheetResponseOut>;
     private __convertExcelToSheet;
     /**
-     * Create a new asset such as a spreadsheet, document, folder, database, computer, user interface, skill, collab agent, or generic doc (admin-only) in your workspace with your current permissions. Computer assets return 202 after durable submission, which commits the asset and initialization delivery intent together. Runtime provisioning continues asynchronously. Inspect the returned asset ID for progress instead of repeating creation. Computers accept the same configuration as the Athena UI's creation dialog: template, provider, cpu, memory (GiB), disk (GiB) and env_vars. Sizes must be offered by the environment's computer resource policy, and only admins may pick a size other than the template default (403 otherwise). In capability enforce mode, computer creation requires computer.create and returns 403 when denied.
+     * Create a new asset such as a spreadsheet, document, folder, database, computer, user interface, skill, collab agent, or generic doc (admin-only) in your workspace with your current permissions. Computer assets return 202 after durable submission, which commits the asset and initialization delivery intent together. Runtime provisioning continues asynchronously. Inspect the returned asset ID for progress instead of repeating creation. Computers accept the same configuration as the Athena UI's creation dialog: template, provider, cpu, memory (GiB), disk (GiB) and env_vars. Sizes must be offered by the environment's computer resource policy, and only admins may pick a size other than the template default (403 otherwise). In capability enforce mode, computer creation requires computer.create and returns 403 when denied. Databases accept suspend_timeout_seconds, the auto-suspend window from the database's Settings in Athena: 0 keeps the database running (it never suspends, and keeps using capacity), otherwise 60 to 86400 seconds. A database is provisioned in the background: poll GET /api/v0/databases/{asset_id}/compute-status until it reports running or suspended.
      *
      * @param {AthenaIntelligence.CreateAssetRequestIn} request
      * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/assets/client/Client.mjs

@@ -216,7 +216,7 @@ export class AssetsClient {
         });
     }
     /**
-     * Create a new asset such as a spreadsheet, document, folder, database, computer, user interface, skill, collab agent, or generic doc (admin-only) in your workspace with your current permissions. Computer assets return 202 after durable submission, which commits the asset and initialization delivery intent together. Runtime provisioning continues asynchronously. Inspect the returned asset ID for progress instead of repeating creation. Computers accept the same configuration as the Athena UI's creation dialog: template, provider, cpu, memory (GiB), disk (GiB) and env_vars. Sizes must be offered by the environment's computer resource policy, and only admins may pick a size other than the template default (403 otherwise). In capability enforce mode, computer creation requires computer.create and returns 403 when denied.
+     * Create a new asset such as a spreadsheet, document, folder, database, computer, user interface, skill, collab agent, or generic doc (admin-only) in your workspace with your current permissions. Computer assets return 202 after durable submission, which commits the asset and initialization delivery intent together. Runtime provisioning continues asynchronously. Inspect the returned asset ID for progress instead of repeating creation. Computers accept the same configuration as the Athena UI's creation dialog: template, provider, cpu, memory (GiB), disk (GiB) and env_vars. Sizes must be offered by the environment's computer resource policy, and only admins may pick a size other than the template default (403 otherwise). In capability enforce mode, computer creation requires computer.create and returns 403 when denied. Databases accept suspend_timeout_seconds, the auto-suspend window from the database's Settings in Athena: 0 keeps the database running (it never suspends, and keeps using capacity), otherwise 60 to 86400 seconds. A database is provisioned in the background: poll GET /api/v0/databases/{asset_id}/compute-status until it reports running or suspended.
      *
      * @param {AthenaIntelligence.CreateAssetRequestIn} request
      * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/assets/client/requests/CreateAssetRequestIn.d.mts

@@ -28,6 +28,8 @@ export interface CreateAssetRequestIn {
     provider?: string | null;
     /** skill only. The skill's SKILL.md content. Created as a draft; publish it with POST /api/v0/assets/{asset_id}/publish. */
     skill_config?: AthenaIntelligence.PublicSkillConfigIn | null;
+    /** Database only. Seconds without activity after which the database suspends (scales to zero): 0 means it never suspends (the compute keeps running, and keeps using capacity), otherwise 60 to 86400 (24 hours). Defaults to 1800 (30 minutes). Applied while the database is provisioned; if it cannot be applied, the database is not created and compute-status reports failed. Read or change it later with GET/PATCH /api/v0/databases/{asset_id}/settings. */
+    suspend_timeout_seconds?: number | null;
     /** Computer only. Template key to create the computer from, as picked in the Athena UI's computer creation dialog (e.g. 'default'), or an 'environment:<asset_id>' reference to a saved environment. Defaults to the default template. Also accepted as 'snapshot'. */
     template?: string | null;
     /** Title for the new asset */