@athenaintel/sdk 4.3.2242 → 4.3.2244

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@athenaintel/sdk",
-        "X-Fern-SDK-Version": "4.3.2242",
-        "User-Agent": "@athenaintel/sdk/4.3.2242",
+        "X-Fern-SDK-Version": "4.3.2244",
+        "User-Agent": "@athenaintel/sdk/4.3.2244",
         "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/cjs/api/resources/assets/client/Client.d.ts

@@ -254,6 +254,26 @@ export declare class AssetsClient {
      */
     createCollabToken(request: AthenaIntelligence.CollabTokenRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.CollabTokenResponse>;
     private __createCollabToken;
+    /**
+     * Turn an uploaded HTML file into a user interface (an app) under its own id — the conversion the Athena app's Convert to user interface performs. The asset keeps its id, folder, links and sharing (its title drops the .html extension), and no second asset is created. An uploaded HTML file stays a file until a request like this one asks: nothing converts on its own. The switch is one-way; the original upload stays downloadable from the asset's Versions pane. Requires edit access to the file. Idempotent: an asset that already is a user interface is answered as it is, with converted false. A refused conversion answers with a detail object: code CONVERSION_REFUSED, the reason, and a message saying why.
+     *
+     * @param {AthenaIntelligence.ConvertToUserInterfaceAssetsRequest} request
+     * @param {AssetsClient.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.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.assets.convertToUserInterface({
+     *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+     *     })
+     */
+    convertToUserInterface(request: AthenaIntelligence.ConvertToUserInterfaceAssetsRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.ConvertToUserInterfaceResponseOut>;
+    private __convertToUserInterface;
     /**
      * Download an asset's file exactly as Athena stores or serves it — no type coercion, no pagination. Native collaborative assets are converted from live content to their canonical Office format: Athena documents download as .docx, spreadsheets as .xlsx (round-trip faithful — string identifiers, leading zeros, and number formats are preserved), PPTX Studio presentations and Word documents export their live studio content as .pptx/.docx. Uploaded files stream their original bytes. The response sets Content-Disposition with a filename derived from the asset title and media type. With `live_sync=true`, a spreadsheet's .xlsx, a PPTX Studio presentation's .pptx or a Word document's .docx also carries the Athena for Microsoft 365 add-in's link record, so opening it in Excel, PowerPoint or Word with the add-in installed starts syncing it with the asset; other asset types ignore the flag.
      * @throws {@link AthenaIntelligence.BadRequestError}

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

@@ -1138,6 +1138,96 @@ class AssetsClient {
             }
         });
     }
+    /**
+     * Turn an uploaded HTML file into a user interface (an app) under its own id — the conversion the Athena app's Convert to user interface performs. The asset keeps its id, folder, links and sharing (its title drops the .html extension), and no second asset is created. An uploaded HTML file stays a file until a request like this one asks: nothing converts on its own. The switch is one-way; the original upload stays downloadable from the asset's Versions pane. Requires edit access to the file. Idempotent: an asset that already is a user interface is answered as it is, with converted false. A refused conversion answers with a detail object: code CONVERSION_REFUSED, the reason, and a message saying why.
+     *
+     * @param {AthenaIntelligence.ConvertToUserInterfaceAssetsRequest} request
+     * @param {AssetsClient.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.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.assets.convertToUserInterface({
+     *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+     *     })
+     */
+    convertToUserInterface(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__convertToUserInterface(request, requestOptions));
+    }
+    __convertToUserInterface(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/assets/${core.url.encodePathParam(assetId)}/convert-to-user-interface`),
+                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 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/assets/{asset_id}/convert-to-user-interface.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Download an asset's file exactly as Athena stores or serves it — no type coercion, no pagination. Native collaborative assets are converted from live content to their canonical Office format: Athena documents download as .docx, spreadsheets as .xlsx (round-trip faithful — string identifiers, leading zeros, and number formats are preserved), PPTX Studio presentations and Word documents export their live studio content as .pptx/.docx. Uploaded files stream their original bytes. The response sets Content-Disposition with a filename derived from the asset title and media type. With `live_sync=true`, a spreadsheet's .xlsx, a PPTX Studio presentation's .pptx or a Word document's .docx also carries the Athena for Microsoft 365 add-in's link record, so opening it in Excel, PowerPoint or Word with the add-in installed starts syncing it with the asset; other asset types ignore the flag.
      * @throws {@link AthenaIntelligence.BadRequestError}

package/dist/cjs/api/resources/assets/client/requests/ConvertToUserInterfaceAssetsRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+ *     }
+ */
+export interface ConvertToUserInterfaceAssetsRequest {
+    /** ID of the uploaded HTML file to turn into a user interface */
+    asset_id: string;
+}

package/dist/cjs/api/resources/assets/client/requests/ConvertToUserInterfaceAssetsRequest.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/assets/client/requests/index.d.ts

@@ -2,6 +2,7 @@ export type { ArchiveAssetsRequest } from "./ArchiveAssetsRequest.js";
 export type { AssetActivityDeltaBatchRequestIn } from "./AssetActivityDeltaBatchRequestIn.js";
 export type { CollabTokenRequest } from "./CollabTokenRequest.js";
 export type { ConvertExcelToSheetRequestIn } from "./ConvertExcelToSheetRequestIn.js";
+export type { ConvertToUserInterfaceAssetsRequest } from "./ConvertToUserInterfaceAssetsRequest.js";
 export type { CreateAssetRequestIn } from "./CreateAssetRequestIn.js";
 export type { CreateProjectRequestIn } from "./CreateProjectRequestIn.js";
 export type { DownloadAssetsRequest } from "./DownloadAssetsRequest.js";

package/dist/cjs/api/resources/computer/client/Client.d.ts

@@ -69,7 +69,7 @@ export declare class ComputerClient {
     getSshAccess(request: AthenaIntelligence.GetSshAccessComputerRequest, requestOptions?: ComputerClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.SshAccessInfoOut>;
     private __getSshAccess;
     /**
-     * Generate a time-limited SSH access token for a computer asset. Returns a full SSH command and token that can be used to connect to the computer's underlying VM and run commands. The computer must support SSH access and be in a running state.
+     * Generate a time-limited SSH access token for a computer asset. Returns a full SSH command and token that can be used to connect to the computer's underlying VM and run commands. The computer must support SSH access. If it is stopped, this call starts it first and can take as long as `start_computer`; after an explicit Stop it returns 409 until you call `start_computer`. Use `get_status` to see whether the computer is ready.
      *
      * @param {AthenaIntelligence.CreateSshAccessRequestIn} request
      * @param {ComputerClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -147,7 +147,7 @@ export declare class ComputerClient {
     revokeSshAccessToken(request: AthenaIntelligence.RevokeSshAccessTokenComputerRequest, requestOptions?: ComputerClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.RevokeSshAccessResponseOut>;
     private __revokeSshAccessToken;
     /**
-     * Start a stopped computer's runtime and wait for it to come up — the same operation as the Start button in Athena. Idempotent for a running computer. Returns 409 when the computer's provider does not support lifecycle operations.
+     * Start a stopped computer's runtime and wait for it to come up — the same operation as the Start button in Athena. Idempotent for a running computer, and it clears an explicit stop. `state` is `started` once the runtime is up; the guest can need a few more seconds, so poll `get_status` until `ready` is true before you rely on commands or SSH. A proxy in front of the API can end this request after about 60 seconds while the start continues on the server; then poll `get_status`. Returns 409 when the computer's provider does not support lifecycle operations.
      *
      * @param {AthenaIntelligence.StartComputerComputerRequest} request
      * @param {ComputerClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -165,6 +165,34 @@ export declare class ComputerClient {
      */
     startComputer(request: AthenaIntelligence.StartComputerComputerRequest, requestOptions?: ComputerClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.ComputerLifecycleResponseOut>;
     private __startComputer;
+    /**
+     * Read an existing computer's live runtime state and whether it is ready, without starting, waking, or repairing it. Works for every computer, including those created before durable initialization (`get_initialization` reports creation-time progress only). Requires membership in the computer's workspace and VIEW access. This read does not count as activity, so polling it does not keep the computer awake.
+     *
+     * **Waiting for a computer.** Call `start_computer`, then poll this endpoint every few seconds until `ready` is true; stop polling when `not_ready_reason` is `launcher_outdated`. `start_computer` waits for the computer, but a proxy in front of the API can end a long request (about 60 seconds on Athena's ingress) while the start continues on the server. The server waits up to 210 seconds by default for the computer's runtime to boot before it reports a failure, and Athena alerts its operators when the 90th percentile of starts goes above 3 minutes.
+     *
+     * **Auto-stop.** A computer stops after its `auto_stop_minutes` of inactivity (60 minutes unless the computer or the deployment sets another value; 0 means it never stops on its own). Activity is work inside the computer — commands, terminal and SSH sessions, file operations — and requests to its deployed URLs. Status reads are not activity.
+     *
+     * **The asset record's `status`.** The computer's `status` in `GET /assets/{asset_id}` records the last lifecycle change Athena recorded (create, Start, Stop); it is not a live read. It can read `running` while the computer is stopped, for example after an idle auto-stop, or `stopped` after something woke it. Use this endpoint for the live state.
+     *
+     * Returns 403 when the caller is not a member of the computer's workspace, 409 while the computer is still being created or when its creation failed, 404 when the asset does not exist or its runtime is gone for good (stop polling), and 502 when the runtime could not be read (retry).
+     *
+     * @param {AthenaIntelligence.GetStatusComputerRequest} request
+     * @param {ComputerClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.ConflictError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.BadGatewayError}
+     *
+     * @example
+     *     await client.computer.getStatus({
+     *         asset_id: "asset_id"
+     *     })
+     */
+    getStatus(request: AthenaIntelligence.GetStatusComputerRequest, requestOptions?: ComputerClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.ComputerStatusResponseOut>;
+    private __getStatus;
     /**
      * Stop (suspend) a running computer's runtime — the same operation as the Stop button in Athena. The computer's files persist and it can be started again with `start_computer`. Returns 409 when the provider does not support lifecycle operations or when the stop was refused because the workspace could not be saved (the computer is left running; retry).
      *

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

@@ -325,7 +325,7 @@ class ComputerClient {
         });
     }
     /**
-     * Generate a time-limited SSH access token for a computer asset. Returns a full SSH command and token that can be used to connect to the computer's underlying VM and run commands. The computer must support SSH access and be in a running state.
+     * Generate a time-limited SSH access token for a computer asset. Returns a full SSH command and token that can be used to connect to the computer's underlying VM and run commands. The computer must support SSH access. If it is stopped, this call starts it first and can take as long as `start_computer`; after an explicit Stop it returns 409 until you call `start_computer`. Use `get_status` to see whether the computer is ready.
      *
      * @param {AthenaIntelligence.CreateSshAccessRequestIn} request
      * @param {ComputerClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -679,7 +679,7 @@ class ComputerClient {
         });
     }
     /**
-     * Start a stopped computer's runtime and wait for it to come up — the same operation as the Start button in Athena. Idempotent for a running computer. Returns 409 when the computer's provider does not support lifecycle operations.
+     * Start a stopped computer's runtime and wait for it to come up — the same operation as the Start button in Athena. Idempotent for a running computer, and it clears an explicit stop. `state` is `started` once the runtime is up; the guest can need a few more seconds, so poll `get_status` until `ready` is true before you rely on commands or SSH. A proxy in front of the API can end this request after about 60 seconds while the start continues on the server; then poll `get_status`. Returns 409 when the computer's provider does not support lifecycle operations.
      *
      * @param {AthenaIntelligence.StartComputerComputerRequest} request
      * @param {ComputerClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -765,6 +765,104 @@ class ComputerClient {
             }
         });
     }
+    /**
+     * Read an existing computer's live runtime state and whether it is ready, without starting, waking, or repairing it. Works for every computer, including those created before durable initialization (`get_initialization` reports creation-time progress only). Requires membership in the computer's workspace and VIEW access. This read does not count as activity, so polling it does not keep the computer awake.
+     *
+     * **Waiting for a computer.** Call `start_computer`, then poll this endpoint every few seconds until `ready` is true; stop polling when `not_ready_reason` is `launcher_outdated`. `start_computer` waits for the computer, but a proxy in front of the API can end a long request (about 60 seconds on Athena's ingress) while the start continues on the server. The server waits up to 210 seconds by default for the computer's runtime to boot before it reports a failure, and Athena alerts its operators when the 90th percentile of starts goes above 3 minutes.
+     *
+     * **Auto-stop.** A computer stops after its `auto_stop_minutes` of inactivity (60 minutes unless the computer or the deployment sets another value; 0 means it never stops on its own). Activity is work inside the computer — commands, terminal and SSH sessions, file operations — and requests to its deployed URLs. Status reads are not activity.
+     *
+     * **The asset record's `status`.** The computer's `status` in `GET /assets/{asset_id}` records the last lifecycle change Athena recorded (create, Start, Stop); it is not a live read. It can read `running` while the computer is stopped, for example after an idle auto-stop, or `stopped` after something woke it. Use this endpoint for the live state.
+     *
+     * Returns 403 when the caller is not a member of the computer's workspace, 409 while the computer is still being created or when its creation failed, 404 when the asset does not exist or its runtime is gone for good (stop polling), and 502 when the runtime could not be read (retry).
+     *
+     * @param {AthenaIntelligence.GetStatusComputerRequest} request
+     * @param {ComputerClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.ConflictError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.BadGatewayError}
+     *
+     * @example
+     *     await client.computer.getStatus({
+     *         asset_id: "asset_id"
+     *     })
+     */
+    getStatus(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getStatus(request, requestOptions));
+    }
+    __getStatus(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/computer/${core.url.encodePathParam(assetId)}/status`),
+                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 401:
+                        throw new AthenaIntelligence.UnauthorizedError(_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 502:
+                        throw new AthenaIntelligence.BadGatewayError(_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/computer/{asset_id}/status.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Stop (suspend) a running computer's runtime — the same operation as the Stop button in Athena. The computer's files persist and it can be started again with `start_computer`. Returns 409 when the provider does not support lifecycle operations or when the stop was refused because the workspace could not be saved (the computer is left running; retry).
      *

package/dist/cjs/api/resources/computer/client/requests/GetStatusComputerRequest.d.ts

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

package/dist/cjs/api/resources/computer/client/requests/GetStatusComputerRequest.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/computer/client/requests/index.d.ts

@@ -2,6 +2,7 @@ export type { CreateSshAccessRequestIn } from "./CreateSshAccessRequestIn.js";
 export type { DeployComputerRequestIn } from "./DeployComputerRequestIn.js";
 export type { GetInitializationComputerRequest } from "./GetInitializationComputerRequest.js";
 export type { GetSshAccessComputerRequest } from "./GetSshAccessComputerRequest.js";
+export type { GetStatusComputerRequest } from "./GetStatusComputerRequest.js";
 export type { ListSshAccessTokensComputerRequest } from "./ListSshAccessTokensComputerRequest.js";
 export type { RevokeSshAccessRequestIn } from "./RevokeSshAccessRequestIn.js";
 export type { RevokeSshAccessTokenComputerRequest } from "./RevokeSshAccessTokenComputerRequest.js";

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/ConvertToUserInterfaceResponseOut.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Response model for turning an uploaded HTML file into a user interface.
+ */
+export interface ConvertToUserInterfaceResponseOut {
+    /** ID of the user interface: the HTML file's own id, which it keeps (no second asset is created) */
+    asset_id: string;
+    /** Type of the asset after the request: user_interface */
+    asset_type: string;
+    /** True when this request converted the file; false when the asset already was a user interface, in which case nothing changed */
+    converted: boolean;
+    /** ID of the asset's parent folder, which the conversion keeps */
+    parent_folder_id?: string | null;
+    /** Title of the user interface */
+    title: string;
+    /** ID of the workspace that owns the asset */
+    workspace_id?: string | null;
+}

package/dist/cjs/api/types/ConvertToUserInterfaceResponseOut.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/index.d.ts

@@ -41,10 +41,12 @@ 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";
 export * from "./ConvertExcelToSheetResponseOut.js";
+export * from "./ConvertToUserInterfaceResponseOut.js";
 export * from "./CreatableAssetType.js";
 export * from "./CreateAssetResponseOut.js";
 export * from "./CreateNewSheetTabResponse.js";

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

@@ -57,10 +57,12 @@ __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);
 __exportStar(require("./ConvertExcelToSheetResponseOut.js"), exports);
+__exportStar(require("./ConvertToUserInterfaceResponseOut.js"), exports);
 __exportStar(require("./CreatableAssetType.js"), exports);
 __exportStar(require("./CreateAssetResponseOut.js"), exports);
 __exportStar(require("./CreateNewSheetTabResponse.js"), exports);

package/dist/cjs/version.d.ts

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

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.2242";
+exports.SDK_VERSION = "4.3.2244";

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.2242",
-        "User-Agent": "@athenaintel/sdk/4.3.2242",
+        "X-Fern-SDK-Version": "4.3.2244",
+        "User-Agent": "@athenaintel/sdk/4.3.2244",
         "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

@@ -254,6 +254,26 @@ export declare class AssetsClient {
      */
     createCollabToken(request: AthenaIntelligence.CollabTokenRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.CollabTokenResponse>;
     private __createCollabToken;
+    /**
+     * Turn an uploaded HTML file into a user interface (an app) under its own id — the conversion the Athena app's Convert to user interface performs. The asset keeps its id, folder, links and sharing (its title drops the .html extension), and no second asset is created. An uploaded HTML file stays a file until a request like this one asks: nothing converts on its own. The switch is one-way; the original upload stays downloadable from the asset's Versions pane. Requires edit access to the file. Idempotent: an asset that already is a user interface is answered as it is, with converted false. A refused conversion answers with a detail object: code CONVERSION_REFUSED, the reason, and a message saying why.
+     *
+     * @param {AthenaIntelligence.ConvertToUserInterfaceAssetsRequest} request
+     * @param {AssetsClient.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.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.assets.convertToUserInterface({
+     *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+     *     })
+     */
+    convertToUserInterface(request: AthenaIntelligence.ConvertToUserInterfaceAssetsRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.ConvertToUserInterfaceResponseOut>;
+    private __convertToUserInterface;
     /**
      * Download an asset's file exactly as Athena stores or serves it — no type coercion, no pagination. Native collaborative assets are converted from live content to their canonical Office format: Athena documents download as .docx, spreadsheets as .xlsx (round-trip faithful — string identifiers, leading zeros, and number formats are preserved), PPTX Studio presentations and Word documents export their live studio content as .pptx/.docx. Uploaded files stream their original bytes. The response sets Content-Disposition with a filename derived from the asset title and media type. With `live_sync=true`, a spreadsheet's .xlsx, a PPTX Studio presentation's .pptx or a Word document's .docx also carries the Athena for Microsoft 365 add-in's link record, so opening it in Excel, PowerPoint or Word with the add-in installed starts syncing it with the asset; other asset types ignore the flag.
      * @throws {@link AthenaIntelligence.BadRequestError}

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

@@ -1102,6 +1102,96 @@ export class AssetsClient {
             }
         });
     }
+    /**
+     * Turn an uploaded HTML file into a user interface (an app) under its own id — the conversion the Athena app's Convert to user interface performs. The asset keeps its id, folder, links and sharing (its title drops the .html extension), and no second asset is created. An uploaded HTML file stays a file until a request like this one asks: nothing converts on its own. The switch is one-way; the original upload stays downloadable from the asset's Versions pane. Requires edit access to the file. Idempotent: an asset that already is a user interface is answered as it is, with converted false. A refused conversion answers with a detail object: code CONVERSION_REFUSED, the reason, and a message saying why.
+     *
+     * @param {AthenaIntelligence.ConvertToUserInterfaceAssetsRequest} request
+     * @param {AssetsClient.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.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.assets.convertToUserInterface({
+     *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+     *     })
+     */
+    convertToUserInterface(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__convertToUserInterface(request, requestOptions));
+    }
+    __convertToUserInterface(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 = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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/assets/${core.url.encodePathParam(assetId)}/convert-to-user-interface`),
+                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 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/assets/{asset_id}/convert-to-user-interface.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Download an asset's file exactly as Athena stores or serves it — no type coercion, no pagination. Native collaborative assets are converted from live content to their canonical Office format: Athena documents download as .docx, spreadsheets as .xlsx (round-trip faithful — string identifiers, leading zeros, and number formats are preserved), PPTX Studio presentations and Word documents export their live studio content as .pptx/.docx. Uploaded files stream their original bytes. The response sets Content-Disposition with a filename derived from the asset title and media type. With `live_sync=true`, a spreadsheet's .xlsx, a PPTX Studio presentation's .pptx or a Word document's .docx also carries the Athena for Microsoft 365 add-in's link record, so opening it in Excel, PowerPoint or Word with the add-in installed starts syncing it with the asset; other asset types ignore the flag.
      * @throws {@link AthenaIntelligence.BadRequestError}

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

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+ *     }
+ */
+export interface ConvertToUserInterfaceAssetsRequest {
+    /** ID of the uploaded HTML file to turn into a user interface */
+    asset_id: string;
+}

package/dist/esm/api/resources/assets/client/requests/ConvertToUserInterfaceAssetsRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

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

@@ -2,6 +2,7 @@ export type { ArchiveAssetsRequest } from "./ArchiveAssetsRequest.mjs";
 export type { AssetActivityDeltaBatchRequestIn } from "./AssetActivityDeltaBatchRequestIn.mjs";
 export type { CollabTokenRequest } from "./CollabTokenRequest.mjs";
 export type { ConvertExcelToSheetRequestIn } from "./ConvertExcelToSheetRequestIn.mjs";
+export type { ConvertToUserInterfaceAssetsRequest } from "./ConvertToUserInterfaceAssetsRequest.mjs";
 export type { CreateAssetRequestIn } from "./CreateAssetRequestIn.mjs";
 export type { CreateProjectRequestIn } from "./CreateProjectRequestIn.mjs";
 export type { DownloadAssetsRequest } from "./DownloadAssetsRequest.mjs";

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

@@ -69,7 +69,7 @@ export declare class ComputerClient {
     getSshAccess(request: AthenaIntelligence.GetSshAccessComputerRequest, requestOptions?: ComputerClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.SshAccessInfoOut>;
     private __getSshAccess;
     /**
-     * Generate a time-limited SSH access token for a computer asset. Returns a full SSH command and token that can be used to connect to the computer's underlying VM and run commands. The computer must support SSH access and be in a running state.
+     * Generate a time-limited SSH access token for a computer asset. Returns a full SSH command and token that can be used to connect to the computer's underlying VM and run commands. The computer must support SSH access. If it is stopped, this call starts it first and can take as long as `start_computer`; after an explicit Stop it returns 409 until you call `start_computer`. Use `get_status` to see whether the computer is ready.
      *
      * @param {AthenaIntelligence.CreateSshAccessRequestIn} request
      * @param {ComputerClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -147,7 +147,7 @@ export declare class ComputerClient {
     revokeSshAccessToken(request: AthenaIntelligence.RevokeSshAccessTokenComputerRequest, requestOptions?: ComputerClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.RevokeSshAccessResponseOut>;
     private __revokeSshAccessToken;
     /**
-     * Start a stopped computer's runtime and wait for it to come up — the same operation as the Start button in Athena. Idempotent for a running computer. Returns 409 when the computer's provider does not support lifecycle operations.
+     * Start a stopped computer's runtime and wait for it to come up — the same operation as the Start button in Athena. Idempotent for a running computer, and it clears an explicit stop. `state` is `started` once the runtime is up; the guest can need a few more seconds, so poll `get_status` until `ready` is true before you rely on commands or SSH. A proxy in front of the API can end this request after about 60 seconds while the start continues on the server; then poll `get_status`. Returns 409 when the computer's provider does not support lifecycle operations.
      *
      * @param {AthenaIntelligence.StartComputerComputerRequest} request
      * @param {ComputerClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -165,6 +165,34 @@ export declare class ComputerClient {
      */
     startComputer(request: AthenaIntelligence.StartComputerComputerRequest, requestOptions?: ComputerClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.ComputerLifecycleResponseOut>;
     private __startComputer;
+    /**
+     * Read an existing computer's live runtime state and whether it is ready, without starting, waking, or repairing it. Works for every computer, including those created before durable initialization (`get_initialization` reports creation-time progress only). Requires membership in the computer's workspace and VIEW access. This read does not count as activity, so polling it does not keep the computer awake.
+     *
+     * **Waiting for a computer.** Call `start_computer`, then poll this endpoint every few seconds until `ready` is true; stop polling when `not_ready_reason` is `launcher_outdated`. `start_computer` waits for the computer, but a proxy in front of the API can end a long request (about 60 seconds on Athena's ingress) while the start continues on the server. The server waits up to 210 seconds by default for the computer's runtime to boot before it reports a failure, and Athena alerts its operators when the 90th percentile of starts goes above 3 minutes.
+     *
+     * **Auto-stop.** A computer stops after its `auto_stop_minutes` of inactivity (60 minutes unless the computer or the deployment sets another value; 0 means it never stops on its own). Activity is work inside the computer — commands, terminal and SSH sessions, file operations — and requests to its deployed URLs. Status reads are not activity.
+     *
+     * **The asset record's `status`.** The computer's `status` in `GET /assets/{asset_id}` records the last lifecycle change Athena recorded (create, Start, Stop); it is not a live read. It can read `running` while the computer is stopped, for example after an idle auto-stop, or `stopped` after something woke it. Use this endpoint for the live state.
+     *
+     * Returns 403 when the caller is not a member of the computer's workspace, 409 while the computer is still being created or when its creation failed, 404 when the asset does not exist or its runtime is gone for good (stop polling), and 502 when the runtime could not be read (retry).
+     *
+     * @param {AthenaIntelligence.GetStatusComputerRequest} request
+     * @param {ComputerClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.ConflictError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.BadGatewayError}
+     *
+     * @example
+     *     await client.computer.getStatus({
+     *         asset_id: "asset_id"
+     *     })
+     */
+    getStatus(request: AthenaIntelligence.GetStatusComputerRequest, requestOptions?: ComputerClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.ComputerStatusResponseOut>;
+    private __getStatus;
     /**
      * Stop (suspend) a running computer's runtime — the same operation as the Stop button in Athena. The computer's files persist and it can be started again with `start_computer`. Returns 409 when the provider does not support lifecycle operations or when the stop was refused because the workspace could not be saved (the computer is left running; retry).
      *

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

@@ -289,7 +289,7 @@ export class ComputerClient {
         });
     }
     /**
-     * Generate a time-limited SSH access token for a computer asset. Returns a full SSH command and token that can be used to connect to the computer's underlying VM and run commands. The computer must support SSH access and be in a running state.
+     * Generate a time-limited SSH access token for a computer asset. Returns a full SSH command and token that can be used to connect to the computer's underlying VM and run commands. The computer must support SSH access. If it is stopped, this call starts it first and can take as long as `start_computer`; after an explicit Stop it returns 409 until you call `start_computer`. Use `get_status` to see whether the computer is ready.
      *
      * @param {AthenaIntelligence.CreateSshAccessRequestIn} request
      * @param {ComputerClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -643,7 +643,7 @@ export class ComputerClient {
         });
     }
     /**
-     * Start a stopped computer's runtime and wait for it to come up — the same operation as the Start button in Athena. Idempotent for a running computer. Returns 409 when the computer's provider does not support lifecycle operations.
+     * Start a stopped computer's runtime and wait for it to come up — the same operation as the Start button in Athena. Idempotent for a running computer, and it clears an explicit stop. `state` is `started` once the runtime is up; the guest can need a few more seconds, so poll `get_status` until `ready` is true before you rely on commands or SSH. A proxy in front of the API can end this request after about 60 seconds while the start continues on the server; then poll `get_status`. Returns 409 when the computer's provider does not support lifecycle operations.
      *
      * @param {AthenaIntelligence.StartComputerComputerRequest} request
      * @param {ComputerClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -729,6 +729,104 @@ export class ComputerClient {
             }
         });
     }
+    /**
+     * Read an existing computer's live runtime state and whether it is ready, without starting, waking, or repairing it. Works for every computer, including those created before durable initialization (`get_initialization` reports creation-time progress only). Requires membership in the computer's workspace and VIEW access. This read does not count as activity, so polling it does not keep the computer awake.
+     *
+     * **Waiting for a computer.** Call `start_computer`, then poll this endpoint every few seconds until `ready` is true; stop polling when `not_ready_reason` is `launcher_outdated`. `start_computer` waits for the computer, but a proxy in front of the API can end a long request (about 60 seconds on Athena's ingress) while the start continues on the server. The server waits up to 210 seconds by default for the computer's runtime to boot before it reports a failure, and Athena alerts its operators when the 90th percentile of starts goes above 3 minutes.
+     *
+     * **Auto-stop.** A computer stops after its `auto_stop_minutes` of inactivity (60 minutes unless the computer or the deployment sets another value; 0 means it never stops on its own). Activity is work inside the computer — commands, terminal and SSH sessions, file operations — and requests to its deployed URLs. Status reads are not activity.
+     *
+     * **The asset record's `status`.** The computer's `status` in `GET /assets/{asset_id}` records the last lifecycle change Athena recorded (create, Start, Stop); it is not a live read. It can read `running` while the computer is stopped, for example after an idle auto-stop, or `stopped` after something woke it. Use this endpoint for the live state.
+     *
+     * Returns 403 when the caller is not a member of the computer's workspace, 409 while the computer is still being created or when its creation failed, 404 when the asset does not exist or its runtime is gone for good (stop polling), and 502 when the runtime could not be read (retry).
+     *
+     * @param {AthenaIntelligence.GetStatusComputerRequest} request
+     * @param {ComputerClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.ConflictError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.BadGatewayError}
+     *
+     * @example
+     *     await client.computer.getStatus({
+     *         asset_id: "asset_id"
+     *     })
+     */
+    getStatus(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getStatus(request, requestOptions));
+    }
+    __getStatus(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 = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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/computer/${core.url.encodePathParam(assetId)}/status`),
+                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 401:
+                        throw new AthenaIntelligence.UnauthorizedError(_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 502:
+                        throw new AthenaIntelligence.BadGatewayError(_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/computer/{asset_id}/status.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Stop (suspend) a running computer's runtime — the same operation as the Stop button in Athena. The computer's files persist and it can be started again with `start_computer`. Returns 409 when the provider does not support lifecycle operations or when the stop was refused because the workspace could not be saved (the computer is left running; retry).
      *

package/dist/esm/api/resources/computer/client/requests/GetStatusComputerRequest.d.mts

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

package/dist/esm/api/resources/computer/client/requests/GetStatusComputerRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/computer/client/requests/index.d.mts

@@ -2,6 +2,7 @@ export type { CreateSshAccessRequestIn } from "./CreateSshAccessRequestIn.mjs";
 export type { DeployComputerRequestIn } from "./DeployComputerRequestIn.mjs";
 export type { GetInitializationComputerRequest } from "./GetInitializationComputerRequest.mjs";
 export type { GetSshAccessComputerRequest } from "./GetSshAccessComputerRequest.mjs";
+export type { GetStatusComputerRequest } from "./GetStatusComputerRequest.mjs";
 export type { ListSshAccessTokensComputerRequest } from "./ListSshAccessTokensComputerRequest.mjs";
 export type { RevokeSshAccessRequestIn } from "./RevokeSshAccessRequestIn.mjs";
 export type { RevokeSshAccessTokenComputerRequest } from "./RevokeSshAccessTokenComputerRequest.mjs";

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

@@ -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/esm/api/types/ComputerStatusResponseOut.mjs

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

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

@@ -0,0 +1,17 @@
+/**
+ * Response model for turning an uploaded HTML file into a user interface.
+ */
+export interface ConvertToUserInterfaceResponseOut {
+    /** ID of the user interface: the HTML file's own id, which it keeps (no second asset is created) */
+    asset_id: string;
+    /** Type of the asset after the request: user_interface */
+    asset_type: string;
+    /** True when this request converted the file; false when the asset already was a user interface, in which case nothing changed */
+    converted: boolean;
+    /** ID of the asset's parent folder, which the conversion keeps */
+    parent_folder_id?: string | null;
+    /** Title of the user interface */
+    title: string;
+    /** ID of the workspace that owns the asset */
+    workspace_id?: string | null;
+}

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

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

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

@@ -41,10 +41,12 @@ export * from "./CollabAgentSendMessageResponseOut.mjs";
 export * from "./CollabTokenResponse.mjs";
 export * from "./ComputerInitializationResponse.mjs";
 export * from "./ComputerLifecycleResponseOut.mjs";
+export * from "./ComputerStatusResponseOut.mjs";
 export * from "./ConversationAssetInfo.mjs";
 export * from "./ConversationMessage.mjs";
 export * from "./ConversationResult.mjs";
 export * from "./ConvertExcelToSheetResponseOut.mjs";
+export * from "./ConvertToUserInterfaceResponseOut.mjs";
 export * from "./CreatableAssetType.mjs";
 export * from "./CreateAssetResponseOut.mjs";
 export * from "./CreateNewSheetTabResponse.mjs";

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

@@ -41,10 +41,12 @@ export * from "./CollabAgentSendMessageResponseOut.mjs";
 export * from "./CollabTokenResponse.mjs";
 export * from "./ComputerInitializationResponse.mjs";
 export * from "./ComputerLifecycleResponseOut.mjs";
+export * from "./ComputerStatusResponseOut.mjs";
 export * from "./ConversationAssetInfo.mjs";
 export * from "./ConversationMessage.mjs";
 export * from "./ConversationResult.mjs";
 export * from "./ConvertExcelToSheetResponseOut.mjs";
+export * from "./ConvertToUserInterfaceResponseOut.mjs";
 export * from "./CreatableAssetType.mjs";
 export * from "./CreateAssetResponseOut.mjs";
 export * from "./CreateNewSheetTabResponse.mjs";

package/dist/esm/version.d.mts

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

package/dist/esm/version.mjs

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

package/package.json

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

package/reference.md

@@ -1307,6 +1307,71 @@ await client.assets.createCollabToken({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.assets.<a href="/src/api/resources/assets/client/Client.ts">convertToUserInterface</a>({ ...params }) -> AthenaIntelligence.ConvertToUserInterfaceResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Turn an uploaded HTML file into a user interface (an app) under its own id — the conversion the Athena app's Convert to user interface performs. The asset keeps its id, folder, links and sharing (its title drops the .html extension), and no second asset is created. An uploaded HTML file stays a file until a request like this one asks: nothing converts on its own. The switch is one-way; the original upload stays downloadable from the asset's Versions pane. Requires edit access to the file. Idempotent: an asset that already is a user interface is answered as it is, with converted false. A refused conversion answers with a detail object: code CONVERSION_REFUSED, the reason, and a message saying why.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.assets.convertToUserInterface({
+    asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.ConvertToUserInterfaceAssetsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AssetsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -1926,7 +1991,7 @@ await client.computer.getSshAccess({
 <dl>
 <dd>
 
-Generate a time-limited SSH access token for a computer asset. Returns a full SSH command and token that can be used to connect to the computer's underlying VM and run commands. The computer must support SSH access and be in a running state.
+Generate a time-limited SSH access token for a computer asset. Returns a full SSH command and token that can be used to connect to the computer's underlying VM and run commands. The computer must support SSH access. If it is stopped, this call starts it first and can take as long as `start_computer`; after an explicit Stop it returns 409 until you call `start_computer`. Use `get_status` to see whether the computer is ready.
 </dd>
 </dl>
 </dd>
@@ -2189,7 +2254,7 @@ await client.computer.revokeSshAccessToken({
 <dl>
 <dd>
 
-Start a stopped computer's runtime and wait for it to come up — the same operation as the Start button in Athena. Idempotent for a running computer. Returns 409 when the computer's provider does not support lifecycle operations.
+Start a stopped computer's runtime and wait for it to come up — the same operation as the Start button in Athena. Idempotent for a running computer, and it clears an explicit stop. `state` is `started` once the runtime is up; the guest can need a few more seconds, so poll `get_status` until `ready` is true before you rely on commands or SSH. A proxy in front of the API can end this request after about 60 seconds while the start continues on the server; then poll `get_status`. Returns 409 when the computer's provider does not support lifecycle operations.
 </dd>
 </dl>
 </dd>
@@ -2238,6 +2303,79 @@ await client.computer.startComputer({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.computer.<a href="/src/api/resources/computer/client/Client.ts">getStatus</a>({ ...params }) -> AthenaIntelligence.ComputerStatusResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Read an existing computer's live runtime state and whether it is ready, without starting, waking, or repairing it. Works for every computer, including those created before durable initialization (`get_initialization` reports creation-time progress only). Requires membership in the computer's workspace and VIEW access. This read does not count as activity, so polling it does not keep the computer awake.
+
+**Waiting for a computer.** Call `start_computer`, then poll this endpoint every few seconds until `ready` is true; stop polling when `not_ready_reason` is `launcher_outdated`. `start_computer` waits for the computer, but a proxy in front of the API can end a long request (about 60 seconds on Athena's ingress) while the start continues on the server. The server waits up to 210 seconds by default for the computer's runtime to boot before it reports a failure, and Athena alerts its operators when the 90th percentile of starts goes above 3 minutes.
+
+**Auto-stop.** A computer stops after its `auto_stop_minutes` of inactivity (60 minutes unless the computer or the deployment sets another value; 0 means it never stops on its own). Activity is work inside the computer — commands, terminal and SSH sessions, file operations — and requests to its deployed URLs. Status reads are not activity.
+
+**The asset record's `status`.** The computer's `status` in `GET /assets/{asset_id}` records the last lifecycle change Athena recorded (create, Start, Stop); it is not a live read. It can read `running` while the computer is stopped, for example after an idle auto-stop, or `stopped` after something woke it. Use this endpoint for the live state.
+
+Returns 403 when the caller is not a member of the computer's workspace, 409 while the computer is still being created or when its creation failed, 404 when the asset does not exist or its runtime is gone for good (stop polling), and 502 when the runtime could not be read (retry).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.computer.getStatus({
+    asset_id: "asset_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.GetStatusComputerRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ComputerClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>