@athenaintel/sdk 4.3.1157 → 4.3.1923

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

@@ -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/esm/api/resources/tools/client/Client.mjs

@@ -44,6 +44,68 @@ export class ToolsClient {
         var _a;
         return ((_a = this._tasks) !== null && _a !== void 0 ? _a : (this._tasks = new 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 = 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.
      *
@@ -125,7 +187,7 @@ export 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}
@@ -143,9 +205,12 @@ export 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 = 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)({
@@ -203,10 +268,88 @@ export 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 = 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}
@@ -216,8 +359,7 @@ export class ToolsClient {
      *
      * @example
      *     await client.tools.getAssetScreenshot({
-     *         asset_id: "asset_id",
-     *         page_number: 1
+     *         asset_id: "asset_id"
      *     })
      */
     getAssetScreenshot(request, requestOptions) {
@@ -294,7 +436,7 @@ export 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}
@@ -303,11 +445,7 @@ export 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));
@@ -317,7 +455,7 @@ export 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) {
@@ -383,7 +521,7 @@ export class ToolsClient {
         });
     }
     /**
-     * @param {AthenaIntelligence.ToolsDataFrameRequest} request
+     * @param {AthenaIntelligence.DataFrameToolsRequest} request
      * @param {ToolsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.UnauthorizedError}
@@ -394,11 +532,7 @@ export 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) {
@@ -406,41 +540,36 @@ export 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 : toJson(item)));
-                }
-                else {
-                    _queryParams.columns = typeof columns === "string" ? columns : toJson(columns);
-                }
+            if (columns !== undefined) {
+                _queryParams.columns = toJson(columns);
             }
-            if (sheetName != null) {
-                _queryParams.sheet_name = sheetName;
+            if (sheetName !== undefined) {
+                _queryParams.sheet_name = typeof sheetName === "string" ? sheetName : toJson(sheetName);
             }
-            if (separator != null) {
+            if (separator !== undefined) {
                 _queryParams.separator = separator;
             }
             const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = 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 = 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) {
@@ -492,7 +621,7 @@ export 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}
@@ -577,8 +706,7 @@ export 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) {
@@ -588,7 +716,7 @@ export 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/esm/api/resources/tools/client/requests/AssetReadRequestIn.d.mts

@@ -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/esm/api/resources/tools/client/requests/AssetReadRequestIn.mjs

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

package/dist/esm/api/resources/tools/client/requests/BodySaveAssetApiV0ToolsFileSavePost.d.mts

@@ -2,12 +2,11 @@ import type * as core from "../../../../../core/index.mjs";
 /**
  * @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;
 }

package/dist/esm/api/resources/tools/client/requests/DataFrameToolsRequest.d.mts

@@ -0,0 +1,18 @@
+import type * as AthenaIntelligence from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_id"
+ *     }
+ */
+export interface DataFrameToolsRequest {
+    asset_id: string;
+    row_limit?: number | null;
+    index_column?: number | null;
+    /** should be a list of strings or a list of integers */
+    columns?: AthenaIntelligence.DataFrameToolsRequestColumnsItem[] | null;
+    /** only for excel files */
+    sheet_name?: AthenaIntelligence.DataFrameToolsRequestSheetName | null;
+    /** only for csv files */
+    separator?: string | null;
+}

package/dist/esm/api/resources/tools/client/requests/DataFrameToolsRequest.mjs

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

package/dist/esm/api/resources/tools/client/requests/GetAssetContentToolsRequest.d.mts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_id"
+ *     }
+ */
+export interface GetAssetContentToolsRequest {
+    asset_id: string;
+    include_comments?: boolean;
+}

package/dist/esm/api/resources/tools/client/requests/GetAssetContentToolsRequest.mjs

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

package/dist/esm/api/resources/tools/client/requests/GetAssetScreenshotToolsRequest.d.mts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_id"
+ *     }
+ */
+export interface GetAssetScreenshotToolsRequest {
+    asset_id: string;
+    page_number?: number;
+}

package/dist/esm/api/resources/tools/client/requests/GetAssetScreenshotToolsRequest.mjs

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

package/dist/esm/api/resources/tools/client/requests/ListContentsToolsRequest.d.mts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {}
+ */
+export interface ListContentsToolsRequest {
+    asset_id?: string | null;
+    include_asset_details?: boolean;
+    include_system_files?: boolean;
+}

package/dist/esm/api/resources/tools/client/requests/ListContentsToolsRequest.mjs

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

package/dist/esm/api/resources/tools/client/requests/RawDataToolsRequest.d.mts

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

package/dist/esm/api/resources/tools/client/requests/RawDataToolsRequest.mjs

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

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

@@ -1,7 +1,8 @@
+export type { AssetReadRequestIn } from "./AssetReadRequestIn.mjs";
 export type { BodySaveAssetApiV0ToolsFileSavePost } from "./BodySaveAssetApiV0ToolsFileSavePost.mjs";
+export type { DataFrameToolsRequest } from "./DataFrameToolsRequest.mjs";
 export type { FileChunkRequestIn } from "./FileChunkRequestIn.mjs";
-export type { ToolsDataFrameRequest } from "./ToolsDataFrameRequest.mjs";
-export type { ToolsGetAssetContentRequest } from "./ToolsGetAssetContentRequest.mjs";
-export type { ToolsGetAssetScreenshotRequest } from "./ToolsGetAssetScreenshotRequest.mjs";
-export type { ToolsListContentsRequest } from "./ToolsListContentsRequest.mjs";
-export type { ToolsRawDataRequest } from "./ToolsRawDataRequest.mjs";
+export type { GetAssetContentToolsRequest } from "./GetAssetContentToolsRequest.mjs";
+export type { GetAssetScreenshotToolsRequest } from "./GetAssetScreenshotToolsRequest.mjs";
+export type { ListContentsToolsRequest } from "./ListContentsToolsRequest.mjs";
+export type { RawDataToolsRequest } from "./RawDataToolsRequest.mjs";

package/dist/esm/api/resources/tools/resources/sheets/client/requests/DuplicateSheetRequest.d.mts

@@ -8,7 +8,7 @@ export interface DuplicateSheetRequest {
     /** The ID of the spreadsheet asset */
     asset_id: string;
     /** New sheet ID for the duplicated sheet (auto-generated if not provided) */
-    new_sheet_id?: number;
+    new_sheet_id?: number | null;
     /** Sheet ID to duplicate */
     sheet_id?: number;
 }

package/dist/esm/api/resources/tools/resources/sheets/client/requests/GetTableRequest.d.mts

@@ -9,7 +9,7 @@ export interface GetTableRequest {
     /** The ID of the spreadsheet asset */
     asset_id: string;
     /** Table ID to retrieve */
-    table_id?: string;
+    table_id?: string | null;
     /** Table name to retrieve */
     table_name: string;
 }

package/dist/esm/api/resources/tools/resources/sheets/client/requests/InsertTableRowRequest.d.mts

@@ -15,7 +15,7 @@ export interface InsertTableRowRequest {
     /** Array of row objects where keys are column names and values are cell values */
     row_data: AthenaIntelligence.TableRowData[];
     /** Table ID to insert row into */
-    table_id?: string;
+    table_id?: string | null;
     /** Table name to insert row into */
     table_name: string;
 }

package/dist/esm/api/resources/tools/resources/sheets/client/requests/UpdateSheetCellRequest.d.mts

@@ -16,6 +16,8 @@ export interface UpdateSheetCellRequest {
     row: number;
     /** Sheet ID (defaults to 1) */
     sheet_id?: number;
+    /** Store the value as text (plain-text cell format): no numeric coercion, leading zeros preserved, formula-looking input kept literal — like a text-formatted cell in Excel. */
+    treat_as_text?: boolean;
     /** Value to set in the cell */
     value: string;
 }