@athenaintel/sdk 4.3.2244 → 4.3.2245

package/dist/esm/api/types/DatabaseWakeResponseOut.mjs

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+export 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 || (DatabaseWakeResponseOut = {}));

package/dist/esm/api/types/index.d.mts

@@ -52,6 +52,7 @@ export * from "./CreateAssetResponseOut.mjs";
 export * from "./CreateNewSheetTabResponse.mjs";
 export * from "./CreateProjectResponseOut.mjs";
 export * from "./DatabaseColumnInfo.mjs";
+export * from "./DatabaseComputeSettingsResponseOut.mjs";
 export * from "./DatabaseDataResponse.mjs";
 export * from "./DatabaseMutationResponse.mjs";
 export * from "./DatabaseSqlResponse.mjs";
@@ -59,6 +60,7 @@ export * from "./DatabaseStatusResponse.mjs";
 export * from "./DatabaseTableInfo.mjs";
 export * from "./DatabaseTableSchemaResponse.mjs";
 export * from "./DatabaseTablesResponse.mjs";
+export * from "./DatabaseWakeResponseOut.mjs";
 export * from "./DataFrameRequestOut.mjs";
 export * from "./DataFrameUnknownFormatError.mjs";
 export * from "./DefaultVisibility.mjs";

package/dist/esm/api/types/index.mjs

@@ -52,6 +52,7 @@ export * from "./CreateAssetResponseOut.mjs";
 export * from "./CreateNewSheetTabResponse.mjs";
 export * from "./CreateProjectResponseOut.mjs";
 export * from "./DatabaseColumnInfo.mjs";
+export * from "./DatabaseComputeSettingsResponseOut.mjs";
 export * from "./DatabaseDataResponse.mjs";
 export * from "./DatabaseMutationResponse.mjs";
 export * from "./DatabaseSqlResponse.mjs";
@@ -59,6 +60,7 @@ export * from "./DatabaseStatusResponse.mjs";
 export * from "./DatabaseTableInfo.mjs";
 export * from "./DatabaseTableSchemaResponse.mjs";
 export * from "./DatabaseTablesResponse.mjs";
+export * from "./DatabaseWakeResponseOut.mjs";
 export * from "./DataFrameRequestOut.mjs";
 export * from "./DataFrameUnknownFormatError.mjs";
 export * from "./DefaultVisibility.mjs";

package/dist/esm/version.d.mts

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

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "4.3.2244";
+export const SDK_VERSION = "4.3.2245";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@athenaintel/sdk",
-    "version": "4.3.2244",
+    "version": "4.3.2245",
     "private": false,
     "repository": "github:Athena-Intel/athena-typescript",
     "type": "commonjs",

package/reference.md

@@ -648,7 +648,7 @@ await client.assets.convertExcelToSheet({
 <dl>
 <dd>
 
-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.
 </dd>
 </dl>
 </dd>
@@ -2462,10 +2462,13 @@ Check if a database is running, suspended, or starting up. Poll this endpoint to
 
 **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.
 </dd>
 </dl>
 </dd>
@@ -2962,6 +2965,141 @@ await client.databases.getTableSchema({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.databases.<a href="/src/api/resources/databases/client/Client.ts">getSettings</a>({ ...params }) -> AthenaIntelligence.DatabaseComputeSettingsResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+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.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.databases.getSettings({
+    asset_id: "asset_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.GetSettingsDatabasesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DatabasesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.databases.<a href="/src/api/resources/databases/client/Client.ts">updateSettings</a>({ ...params }) -> AthenaIntelligence.DatabaseComputeSettingsResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+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.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.databases.updateSettings({
+    asset_id: "asset_id",
+    suspend_timeout_seconds: 3600
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.DatabaseComputeSettingsUpdateRequestIn` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DatabasesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -3028,6 +3166,73 @@ await client.databases.executeSql({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.databases.<a href="/src/api/resources/databases/client/Client.ts">wake</a>({ ...params }) -> AthenaIntelligence.DatabaseWakeResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+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.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.databases.wake({
+    asset_id: "asset_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.WakeDatabasesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DatabasesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>