@athenaintel/sdk 4.3.1157 → 4.3.1923

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

@@ -219,7 +219,7 @@ class ThreadsClient {
     /**
      * Check the status of a thread execution by thread ID. Returns thread status and associated conversation asset information for tracking progress.
      *
-     * @param {string} thread_id - The unique thread ID to check status for
+     * @param {AthenaIntelligence.GetStatusThreadsRequest} request
      * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.UnauthorizedError}
@@ -228,18 +228,21 @@ class ThreadsClient {
      * @throws {@link AthenaIntelligence.InternalServerError}
      *
      * @example
-     *     await client.threads.getStatus("thread_id")
+     *     await client.threads.getStatus({
+     *         thread_id: "thread_id"
+     *     })
      */
-    getStatus(thread_id, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__getStatus(thread_id, requestOptions));
+    getStatus(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getStatus(request, requestOptions));
     }
-    __getStatus(thread_id, requestOptions) {
+    __getStatus(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const { thread_id: threadId } = 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, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, `api/v0/threads/${core.url.encodePathParam(thread_id)}/status`),
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, `api/v0/threads/${core.url.encodePathParam(threadId)}/status`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -298,7 +301,7 @@ class ThreadsClient {
     /**
      * Stop a running thread execution. This will stop the thread if it is currently running and mark it as cancelled.
      *
-     * @param {string} thread_id - The unique thread ID to stop
+     * @param {AthenaIntelligence.StopThreadsRequest} request
      * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.BadRequestError}
@@ -309,18 +312,21 @@ class ThreadsClient {
      * @throws {@link AthenaIntelligence.InternalServerError}
      *
      * @example
-     *     await client.threads.stop("thread_id")
+     *     await client.threads.stop({
+     *         thread_id: "thread_id"
+     *     })
      */
-    stop(thread_id, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__stop(thread_id, requestOptions));
+    stop(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__stop(request, requestOptions));
     }
-    __stop(thread_id, requestOptions) {
+    __stop(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const { thread_id: threadId } = 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, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, `api/v0/threads/${core.url.encodePathParam(thread_id)}/stop`),
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, `api/v0/threads/${core.url.encodePathParam(threadId)}/stop`),
                 method: "POST",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,

package/dist/cjs/api/resources/threads/client/index.d.ts

@@ -1 +1 @@
-export {};
+export * from "./requests/index.js";

package/dist/cjs/api/resources/threads/client/index.js

@@ -1,2 +1,17 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests/index.js"), exports);

package/dist/cjs/api/resources/threads/client/requests/GetStatusThreadsRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         thread_id: "thread_id"
+ *     }
+ */
+export interface GetStatusThreadsRequest {
+    /** The unique thread ID to check status for */
+    thread_id: string;
+}

package/dist/cjs/api/resources/threads/client/requests/GetStatusThreadsRequest.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/threads/client/requests/StopThreadsRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         thread_id: "thread_id"
+ *     }
+ */
+export interface StopThreadsRequest {
+    /** The unique thread ID to stop */
+    thread_id: string;
+}

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

@@ -0,0 +1,2 @@
+export type { GetStatusThreadsRequest } from "./GetStatusThreadsRequest.js";
+export type { StopThreadsRequest } from "./StopThreadsRequest.js";

package/dist/cjs/api/resources/threads/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -26,6 +26,16 @@ export declare class ToolsClient {
     get sheets(): SheetsClient;
     get structuredDataExtractor(): StructuredDataExtractorClient;
     get tasks(): TasksClient;
+    /**
+     * List the read_asset capabilities for every supported asset type: available output formats, the default format, accepted and preferred anchors, and the pagination protocol. Static metadata; no asset access required.
+     *
+     * @param {ToolsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.tools.getAssetCapabilities()
+     */
+    getAssetCapabilities(requestOptions?: ToolsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.AssetCapabilitiesResponseOut>;
+    private __getAssetCapabilities;
     /**
      * Get the chunks of a file.
      *
@@ -46,7 +56,7 @@ export declare class ToolsClient {
     /**
      * Get the content of an asset.
      *
-     * @param {AthenaIntelligence.ToolsGetAssetContentRequest} request
+     * @param {AthenaIntelligence.GetAssetContentToolsRequest} request
      * @param {ToolsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.UnauthorizedError}
@@ -58,12 +68,28 @@ export declare class ToolsClient {
      *         asset_id: "asset_id"
      *     })
      */
-    getAssetContent(request: AthenaIntelligence.ToolsGetAssetContentRequest, requestOptions?: ToolsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.AssetContentRequestOut>;
+    getAssetContent(request: AthenaIntelligence.GetAssetContentToolsRequest, requestOptions?: ToolsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.AssetContentRequestOut>;
     private __getAssetContent;
+    /**
+     * Read one or more assets with citation-style anchors, output format selection (text/json/image), and pagination. Each result discloses the asset type's read capabilities and returns a structured teaching error when a read fails. Mirrors the agent's read_asset tool.
+     *
+     * @param {AthenaIntelligence.AssetReadRequestIn} request
+     * @param {ToolsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.tools.readAsset({
+     *         asset_ids: ["asset_9249292-d118-42d3-95b4-00eccfe0754f?anchor=page&page=1&format=text"]
+     *     })
+     */
+    readAsset(request: AthenaIntelligence.AssetReadRequestIn, requestOptions?: ToolsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.AssetReadResponseOut>;
+    private __readAsset;
     /**
      * Get a screenshot of a specific page from an asset.
      *
-     * @param {AthenaIntelligence.ToolsGetAssetScreenshotRequest} request
+     * @param {AthenaIntelligence.GetAssetScreenshotToolsRequest} request
      * @param {ToolsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.UnauthorizedError}
@@ -73,16 +99,15 @@ export declare class ToolsClient {
      *
      * @example
      *     await client.tools.getAssetScreenshot({
-     *         asset_id: "asset_id",
-     *         page_number: 1
+     *         asset_id: "asset_id"
      *     })
      */
-    getAssetScreenshot(request: AthenaIntelligence.ToolsGetAssetScreenshotRequest, requestOptions?: ToolsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.AssetScreenshotResponseOut>;
+    getAssetScreenshot(request: AthenaIntelligence.GetAssetScreenshotToolsRequest, requestOptions?: ToolsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.AssetScreenshotResponseOut>;
     private __getAssetScreenshot;
     /**
      * List contents of an asset (Folder, Collection, Project) or entire workspace in a tree structure.
      *
-     * @param {AthenaIntelligence.ToolsListContentsRequest} request
+     * @param {AthenaIntelligence.ListContentsToolsRequest} request
      * @param {ToolsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.BadRequestError}
@@ -91,16 +116,12 @@ export declare class ToolsClient {
      * @throws {@link AthenaIntelligence.UnprocessableEntityError}
      *
      * @example
-     *     await client.tools.listContents({
-     *         asset_id: "asset_id",
-     *         include_asset_details: true,
-     *         include_system_files: true
-     *     })
+     *     await client.tools.listContents()
      */
-    listContents(request?: AthenaIntelligence.ToolsListContentsRequest, requestOptions?: ToolsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.FolderResponse>;
+    listContents(request?: AthenaIntelligence.ListContentsToolsRequest, requestOptions?: ToolsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.FolderResponse>;
     private __listContents;
     /**
-     * @param {AthenaIntelligence.ToolsDataFrameRequest} request
+     * @param {AthenaIntelligence.DataFrameToolsRequest} request
      * @param {ToolsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.UnauthorizedError}
@@ -111,23 +132,19 @@ export declare class ToolsClient {
      *
      * @example
      *     await client.tools.dataFrame({
-     *         asset_id: "asset_id",
-     *         row_limit: 1,
-     *         index_column: 1,
-     *         sheet_name: "sheet_name",
-     *         separator: "separator"
+     *         asset_id: "asset_id"
      *     })
      */
-    dataFrame(request: AthenaIntelligence.ToolsDataFrameRequest, requestOptions?: ToolsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.DataFrameRequestOut>;
+    dataFrame(request: AthenaIntelligence.DataFrameToolsRequest, requestOptions?: ToolsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.DataFrameRequestOut>;
     private __dataFrame;
     /**
-     * Get the raw file data for given asset.
+     * Stream an asset's raw file data. Prefer GET /api/v0/assets/{asset_id}/download for downloads: it converts native collaborative assets to their canonical Office format (documents to .docx, spreadsheets to .xlsx, presentations to .pptx), prefers original over converted bytes, sets a Content-Disposition filename, and fails with an HTTP error instead of degrading to a text summary of the asset.
      * @throws {@link AthenaIntelligence.UnauthorizedError}
      * @throws {@link AthenaIntelligence.NotFoundError}
      * @throws {@link AthenaIntelligence.UnprocessableEntityError}
      * @throws {@link AthenaIntelligence.InternalServerError}
      */
-    rawData(request: AthenaIntelligence.ToolsRawDataRequest, requestOptions?: ToolsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    rawData(request: AthenaIntelligence.RawDataToolsRequest, requestOptions?: ToolsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
     private __rawData;
     /**
      * Save a file as an asset in the user's workspace.
@@ -142,8 +159,7 @@ export declare class ToolsClient {
      * @example
      *     import { createReadStream } from "fs";
      *     await client.tools.saveAsset({
-     *         file: fs.createReadStream("/path/to/your/file"),
-     *         parent_folder_id: "parent_folder_id"
+     *         file: fs.createReadStream("/path/to/your/file")
      *     })
      */
     saveAsset(request: AthenaIntelligence.BodySaveAssetApiV0ToolsFileSavePost, requestOptions?: ToolsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.SaveAssetRequestOut>;

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

@@ -80,6 +80,68 @@ class ToolsClient {
         var _a;
         return ((_a = this._tasks) !== null && _a !== void 0 ? _a : (this._tasks = new Client_js_5.TasksClient(this._options)));
     }
+    /**
+     * List the read_asset capabilities for every supported asset type: available output formats, the default format, accepted and preferred anchors, and the pagination protocol. Static metadata; no asset access required.
+     *
+     * @param {ToolsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.tools.getAssetCapabilities()
+     */
+    getAssetCapabilities(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getAssetCapabilities(requestOptions));
+    }
+    __getAssetCapabilities(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            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, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, "api/v0/tools/asset/capabilities"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                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/tools/asset/capabilities.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Get the chunks of a file.
      *
@@ -161,7 +223,7 @@ class ToolsClient {
     /**
      * Get the content of an asset.
      *
-     * @param {AthenaIntelligence.ToolsGetAssetContentRequest} request
+     * @param {AthenaIntelligence.GetAssetContentToolsRequest} request
      * @param {ToolsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.UnauthorizedError}
@@ -179,9 +241,12 @@ class ToolsClient {
     __getAssetContent(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { asset_id: assetId } = request;
+            const { asset_id: assetId, include_comments: includeComments } = request;
             const _queryParams = {};
             _queryParams.asset_id = assetId;
+            if (includeComments != null) {
+                _queryParams.include_comments = includeComments.toString();
+            }
             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, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
@@ -239,10 +304,88 @@ class ToolsClient {
             }
         });
     }
+    /**
+     * Read one or more assets with citation-style anchors, output format selection (text/json/image), and pagination. Each result discloses the asset type's read capabilities and returns a structured teaching error when a read fails. Mirrors the agent's read_asset tool.
+     *
+     * @param {AthenaIntelligence.AssetReadRequestIn} request
+     * @param {ToolsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.tools.readAsset({
+     *         asset_ids: ["asset_9249292-d118-42d3-95b4-00eccfe0754f?anchor=page&page=1&format=text"]
+     *     })
+     */
+    readAsset(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__readAsset(request, requestOptions));
+    }
+    __readAsset(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            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, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, "api/v0/tools/asset/read"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.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 422:
+                        throw new AthenaIntelligence.UnprocessableEntityError(_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/tools/asset/read.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Get a screenshot of a specific page from an asset.
      *
-     * @param {AthenaIntelligence.ToolsGetAssetScreenshotRequest} request
+     * @param {AthenaIntelligence.GetAssetScreenshotToolsRequest} request
      * @param {ToolsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.UnauthorizedError}
@@ -252,8 +395,7 @@ class ToolsClient {
      *
      * @example
      *     await client.tools.getAssetScreenshot({
-     *         asset_id: "asset_id",
-     *         page_number: 1
+     *         asset_id: "asset_id"
      *     })
      */
     getAssetScreenshot(request, requestOptions) {
@@ -330,7 +472,7 @@ class ToolsClient {
     /**
      * List contents of an asset (Folder, Collection, Project) or entire workspace in a tree structure.
      *
-     * @param {AthenaIntelligence.ToolsListContentsRequest} request
+     * @param {AthenaIntelligence.ListContentsToolsRequest} request
      * @param {ToolsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.BadRequestError}
@@ -339,11 +481,7 @@ class ToolsClient {
      * @throws {@link AthenaIntelligence.UnprocessableEntityError}
      *
      * @example
-     *     await client.tools.listContents({
-     *         asset_id: "asset_id",
-     *         include_asset_details: true,
-     *         include_system_files: true
-     *     })
+     *     await client.tools.listContents()
      */
     listContents(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__listContents(request, requestOptions));
@@ -353,7 +491,7 @@ class ToolsClient {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
             const { asset_id: assetId, include_asset_details: includeAssetDetails, include_system_files: includeSystemFiles, } = request;
             const _queryParams = {};
-            if (assetId != null) {
+            if (assetId !== undefined) {
                 _queryParams.asset_id = assetId;
             }
             if (includeAssetDetails != null) {
@@ -419,7 +557,7 @@ class ToolsClient {
         });
     }
     /**
-     * @param {AthenaIntelligence.ToolsDataFrameRequest} request
+     * @param {AthenaIntelligence.DataFrameToolsRequest} request
      * @param {ToolsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.UnauthorizedError}
@@ -430,11 +568,7 @@ class ToolsClient {
      *
      * @example
      *     await client.tools.dataFrame({
-     *         asset_id: "asset_id",
-     *         row_limit: 1,
-     *         index_column: 1,
-     *         sheet_name: "sheet_name",
-     *         separator: "separator"
+     *         asset_id: "asset_id"
      *     })
      */
     dataFrame(request, requestOptions) {
@@ -442,41 +576,36 @@ class ToolsClient {
     }
     __dataFrame(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
             const { asset_id: assetId, row_limit: rowLimit, index_column: indexColumn, columns, sheet_name: sheetName, separator, } = request;
             const _queryParams = {};
             _queryParams.asset_id = assetId;
-            if (rowLimit != null) {
-                _queryParams.row_limit = rowLimit.toString();
+            if (rowLimit !== undefined) {
+                _queryParams.row_limit = (_a = rowLimit === null || rowLimit === void 0 ? void 0 : rowLimit.toString()) !== null && _a !== void 0 ? _a : null;
             }
-            if (indexColumn != null) {
-                _queryParams.index_column = indexColumn.toString();
+            if (indexColumn !== undefined) {
+                _queryParams.index_column = (_b = indexColumn === null || indexColumn === void 0 ? void 0 : indexColumn.toString()) !== null && _b !== void 0 ? _b : null;
             }
-            if (columns != null) {
-                if (Array.isArray(columns)) {
-                    _queryParams.columns = columns.map((item) => (typeof item === "string" ? item : (0, json_js_1.toJson)(item)));
-                }
-                else {
-                    _queryParams.columns = typeof columns === "string" ? columns : (0, json_js_1.toJson)(columns);
-                }
+            if (columns !== undefined) {
+                _queryParams.columns = (0, json_js_1.toJson)(columns);
             }
-            if (sheetName != null) {
-                _queryParams.sheet_name = sheetName;
+            if (sheetName !== undefined) {
+                _queryParams.sheet_name = typeof sheetName === "string" ? sheetName : (0, json_js_1.toJson)(sheetName);
             }
-            if (separator != null) {
+            if (separator !== undefined) {
                 _queryParams.separator = separator;
             }
             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, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
-            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, "api/v0/tools/file/data-frame"),
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, 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/tools/file/data-frame"),
                 method: "GET",
                 headers: _headers,
                 queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
-                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
-                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                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: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
                 logging: this._options.logging,
             });
             if (_response.ok) {
@@ -528,7 +657,7 @@ class ToolsClient {
         });
     }
     /**
-     * Get the raw file data for given asset.
+     * Stream an asset's raw file data. Prefer GET /api/v0/assets/{asset_id}/download for downloads: it converts native collaborative assets to their canonical Office format (documents to .docx, spreadsheets to .xlsx, presentations to .pptx), prefers original over converted bytes, sets a Content-Disposition filename, and fails with an HTTP error instead of degrading to a text summary of the asset.
      * @throws {@link AthenaIntelligence.UnauthorizedError}
      * @throws {@link AthenaIntelligence.NotFoundError}
      * @throws {@link AthenaIntelligence.UnprocessableEntityError}
@@ -613,8 +742,7 @@ class ToolsClient {
      * @example
      *     import { createReadStream } from "fs";
      *     await client.tools.saveAsset({
-     *         file: fs.createReadStream("/path/to/your/file"),
-     *         parent_folder_id: "parent_folder_id"
+     *         file: fs.createReadStream("/path/to/your/file")
      *     })
      */
     saveAsset(request, requestOptions) {
@@ -624,7 +752,7 @@ class ToolsClient {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
             const _queryParams = {};
-            if (request.parent_folder_id != null) {
+            if (request.parent_folder_id !== undefined) {
                 _queryParams.parent_folder_id = request.parent_folder_id;
             }
             const _request = yield core.newFormData();

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

@@ -0,0 +1,12 @@
+/**
+ * @example
+ *     {
+ *         asset_ids: ["asset_9249292-d118-42d3-95b4-00eccfe0754f?anchor=page&page=1&format=text"]
+ *     }
+ */
+export interface AssetReadRequestIn {
+    /** 1-10 asset identifiers to read. Each id may carry inline read options using citation-style query syntax, e.g. 'asset_xxx?anchor=page&page=3&format=image'. Versioned ('asset_xxx@version') and live ('asset_xxx_providerId') ids are supported. */
+    asset_ids: string[];
+    /** Optional password for reading password-protected Office files. Applied to every asset in the request. */
+    password?: string | null;
+}

package/dist/cjs/api/resources/tools/client/requests/AssetReadRequestIn.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/tools/client/requests/BodySaveAssetApiV0ToolsFileSavePost.d.ts

@@ -2,12 +2,11 @@ import type * as core from "../../../../../core/index.js";
 /**
  * @example
  *     {
- *         file: fs.createReadStream("/path/to/your/file"),
- *         parent_folder_id: "parent_folder_id"
+ *         file: fs.createReadStream("/path/to/your/file")
  *     }
  */
 export interface BodySaveAssetApiV0ToolsFileSavePost {
     /** Identifier of the folder into which the asset should be saved */
-    parent_folder_id?: string;
+    parent_folder_id?: string | null;
     file: core.file.Uploadable;
 }