@athenaintel/sdk 4.3.2141 → 4.3.2142

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.2141",
-        "User-Agent": "@athenaintel/sdk/4.3.2141",
+        "X-Fern-SDK-Version": "4.3.2142",
+        "User-Agent": "@athenaintel/sdk/4.3.2142",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

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

@@ -48,7 +48,7 @@ export declare class AssetsClient {
     convertExcelToSheet(request: AthenaIntelligence.ConvertExcelToSheetRequestIn, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.ConvertExcelToSheetResponseOut>;
     private __convertExcelToSheet;
     /**
-     * Create a new asset such as a spreadsheet, document, folder, database, or computer in your workspace. This endpoint uses internal GraphQL mutations to create assets with proper permissions and workspace integration. Computer assets return 202 after the initializing asset is committed; runtime provisioning continues asynchronously.
+     * Create a new asset such as a spreadsheet, document, folder, database, computer, or generic doc (admin-only) in your workspace. This endpoint uses internal GraphQL mutations to create assets with proper permissions and workspace integration. Computer assets return 202 after the initializing asset is committed; runtime provisioning continues asynchronously.
      *
      * @param {AthenaIntelligence.CreateAssetRequestIn} request
      * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -235,6 +235,21 @@ export declare class AssetsClient {
      */
     archive(request: AthenaIntelligence.ArchiveAssetsRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.ArchiveAssetResponseOut>;
     private __archive;
+    /**
+     * Admin only. Mint a short-lived Keryx capability token for a Generic Doc asset, enabling live collaborative reads (and, with edit permission, writes) over WebSocket and REST. Only generic_doc assets are eligible — Athena-managed asset types are never reachable through this endpoint. The requested access is a ceiling clamped by the caller's permission on the asset.
+     *
+     * @param {AthenaIntelligence.CollabTokenRequest} request
+     * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.assets.createCollabToken({
+     *         asset_id: "asset_id"
+     *     })
+     */
+    createCollabToken(request: AthenaIntelligence.CollabTokenRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.CollabTokenResponse>;
+    private __createCollabToken;
     /**
      * 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.
      * @throws {@link AthenaIntelligence.BadRequestError}

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

@@ -244,7 +244,7 @@ class AssetsClient {
         });
     }
     /**
-     * Create a new asset such as a spreadsheet, document, folder, database, or computer in your workspace. This endpoint uses internal GraphQL mutations to create assets with proper permissions and workspace integration. Computer assets return 202 after the initializing asset is committed; runtime provisioning continues asynchronously.
+     * Create a new asset such as a spreadsheet, document, folder, database, computer, or generic doc (admin-only) in your workspace. This endpoint uses internal GraphQL mutations to create assets with proper permissions and workspace integration. Computer assets return 202 after the initializing asset is committed; runtime provisioning continues asynchronously.
      *
      * @param {AthenaIntelligence.CreateAssetRequestIn} request
      * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -1028,6 +1028,82 @@ class AssetsClient {
             }
         });
     }
+    /**
+     * Admin only. Mint a short-lived Keryx capability token for a Generic Doc asset, enabling live collaborative reads (and, with edit permission, writes) over WebSocket and REST. Only generic_doc assets are eligible — Athena-managed asset types are never reachable through this endpoint. The requested access is a ceiling clamped by the caller's permission on the asset.
+     *
+     * @param {AthenaIntelligence.CollabTokenRequest} request
+     * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.assets.createCollabToken({
+     *         asset_id: "asset_id"
+     *     })
+     */
+    createCollabToken(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createCollabToken(request, requestOptions));
+    }
+    __createCollabToken(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, _body = __rest(request, ["asset_id"]);
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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/assets/${core.url.encodePathParam(assetId)}/collab-token`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: _body,
+                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 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/assets/{asset_id}/collab-token.");
+                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.
      * @throws {@link AthenaIntelligence.BadRequestError}

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

@@ -0,0 +1,19 @@
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_id"
+ *     }
+ */
+export interface CollabTokenRequest {
+    asset_id: string;
+    /** Requested access ceiling. This is a ceiling, not a grant: 'edit' is clamped to read-only unless the caller has edit permission on the asset. */
+    access?: CollabTokenRequest.Access;
+}
+export declare namespace CollabTokenRequest {
+    /** Requested access ceiling. This is a ceiling, not a grant: 'edit' is clamped to read-only unless the caller has edit permission on the asset. */
+    const Access: {
+        readonly View: "view";
+        readonly Edit: "edit";
+    };
+    type Access = (typeof Access)[keyof typeof Access];
+}

package/dist/cjs/api/resources/assets/client/requests/CollabTokenRequest.js

@@ -0,0 +1,12 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollabTokenRequest = void 0;
+var CollabTokenRequest;
+(function (CollabTokenRequest) {
+    /** Requested access ceiling. This is a ceiling, not a grant: 'edit' is clamped to read-only unless the caller has edit permission on the asset. */
+    CollabTokenRequest.Access = {
+        View: "view",
+        Edit: "edit",
+    };
+})(CollabTokenRequest || (exports.CollabTokenRequest = CollabTokenRequest = {}));

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

@@ -1,5 +1,6 @@
 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 { CreateAssetRequestIn } from "./CreateAssetRequestIn.js";
 export type { CreateProjectRequestIn } from "./CreateProjectRequestIn.js";

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

@@ -0,0 +1,26 @@
+export interface CollabTokenResponse {
+    /** Granted access: r = read + live subscribe, rw = read-write. */
+    access_type: CollabTokenResponse.AccessType;
+    /** Document branch. */
+    branch?: string;
+    /** Keryx document id within the org. */
+    doc_id: string;
+    /** Token expiry in epoch milliseconds. Re-mint before this passes; the @athenaintel/react collab client does so automatically. */
+    expires_at_ms: number;
+    /** Keryx org (room namespace) for the document. */
+    org: string;
+    /** REST base URL. Endpoints follow {rest_url}/{name}/v1/{org}/{doc_id} (ydoc, activity, changeset). */
+    rest_url: string;
+    /** Keryx capability token (yauth). Pass as the yauth query parameter on the WebSocket upgrade and REST requests. Room-bound: valid only for this asset's document. */
+    token: string;
+    /** WebSocket base URL. Connect to {ws_url}/{org}/{doc_id}?yauth={token}. */
+    ws_url: string;
+}
+export declare namespace CollabTokenResponse {
+    /** Granted access: r = read + live subscribe, rw = read-write. */
+    const AccessType: {
+        readonly R: "r";
+        readonly Rw: "rw";
+    };
+    type AccessType = (typeof AccessType)[keyof typeof AccessType];
+}

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

@@ -0,0 +1,12 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollabTokenResponse = void 0;
+var CollabTokenResponse;
+(function (CollabTokenResponse) {
+    /** Granted access: r = read + live subscribe, rw = read-write. */
+    CollabTokenResponse.AccessType = {
+        R: "r",
+        Rw: "rw",
+    };
+})(CollabTokenResponse || (exports.CollabTokenResponse = CollabTokenResponse = {}));

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

@@ -5,5 +5,6 @@ export declare const CreatableAssetType: {
     readonly Folder: "folder";
     readonly Database: "database";
     readonly Computer: "computer";
+    readonly GenericDoc: "generic_doc";
 };
 export type CreatableAssetType = (typeof CreatableAssetType)[keyof typeof CreatableAssetType];

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

@@ -9,4 +9,5 @@ exports.CreatableAssetType = {
     Folder: "folder",
     Database: "database",
     Computer: "computer",
+    GenericDoc: "generic_doc",
 };

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

@@ -28,6 +28,7 @@ export * from "./Chunk.js";
 export * from "./ChunkContentItem.js";
 export * from "./ChunkResult.js";
 export * from "./CollabAgentSendMessageResponseOut.js";
+export * from "./CollabTokenResponse.js";
 export * from "./ConversationAssetInfo.js";
 export * from "./ConversationMessage.js";
 export * from "./ConversationResult.js";

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

@@ -44,6 +44,7 @@ __exportStar(require("./Chunk.js"), exports);
 __exportStar(require("./ChunkContentItem.js"), exports);
 __exportStar(require("./ChunkResult.js"), exports);
 __exportStar(require("./CollabAgentSendMessageResponseOut.js"), exports);
+__exportStar(require("./CollabTokenResponse.js"), exports);
 __exportStar(require("./ConversationAssetInfo.js"), exports);
 __exportStar(require("./ConversationMessage.js"), exports);
 __exportStar(require("./ConversationResult.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2141";
+export declare const SDK_VERSION = "4.3.2142";

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.2141";
+exports.SDK_VERSION = "4.3.2142";

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.2141",
-        "User-Agent": "@athenaintel/sdk/4.3.2141",
+        "X-Fern-SDK-Version": "4.3.2142",
+        "User-Agent": "@athenaintel/sdk/4.3.2142",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

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

@@ -48,7 +48,7 @@ export declare class AssetsClient {
     convertExcelToSheet(request: AthenaIntelligence.ConvertExcelToSheetRequestIn, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.ConvertExcelToSheetResponseOut>;
     private __convertExcelToSheet;
     /**
-     * Create a new asset such as a spreadsheet, document, folder, database, or computer in your workspace. This endpoint uses internal GraphQL mutations to create assets with proper permissions and workspace integration. Computer assets return 202 after the initializing asset is committed; runtime provisioning continues asynchronously.
+     * Create a new asset such as a spreadsheet, document, folder, database, computer, or generic doc (admin-only) in your workspace. This endpoint uses internal GraphQL mutations to create assets with proper permissions and workspace integration. Computer assets return 202 after the initializing asset is committed; runtime provisioning continues asynchronously.
      *
      * @param {AthenaIntelligence.CreateAssetRequestIn} request
      * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -235,6 +235,21 @@ export declare class AssetsClient {
      */
     archive(request: AthenaIntelligence.ArchiveAssetsRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.ArchiveAssetResponseOut>;
     private __archive;
+    /**
+     * Admin only. Mint a short-lived Keryx capability token for a Generic Doc asset, enabling live collaborative reads (and, with edit permission, writes) over WebSocket and REST. Only generic_doc assets are eligible — Athena-managed asset types are never reachable through this endpoint. The requested access is a ceiling clamped by the caller's permission on the asset.
+     *
+     * @param {AthenaIntelligence.CollabTokenRequest} request
+     * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.assets.createCollabToken({
+     *         asset_id: "asset_id"
+     *     })
+     */
+    createCollabToken(request: AthenaIntelligence.CollabTokenRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.CollabTokenResponse>;
+    private __createCollabToken;
     /**
      * 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.
      * @throws {@link AthenaIntelligence.BadRequestError}

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

@@ -208,7 +208,7 @@ export class AssetsClient {
         });
     }
     /**
-     * Create a new asset such as a spreadsheet, document, folder, database, or computer in your workspace. This endpoint uses internal GraphQL mutations to create assets with proper permissions and workspace integration. Computer assets return 202 after the initializing asset is committed; runtime provisioning continues asynchronously.
+     * Create a new asset such as a spreadsheet, document, folder, database, computer, or generic doc (admin-only) in your workspace. This endpoint uses internal GraphQL mutations to create assets with proper permissions and workspace integration. Computer assets return 202 after the initializing asset is committed; runtime provisioning continues asynchronously.
      *
      * @param {AthenaIntelligence.CreateAssetRequestIn} request
      * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -992,6 +992,82 @@ export class AssetsClient {
             }
         });
     }
+    /**
+     * Admin only. Mint a short-lived Keryx capability token for a Generic Doc asset, enabling live collaborative reads (and, with edit permission, writes) over WebSocket and REST. Only generic_doc assets are eligible — Athena-managed asset types are never reachable through this endpoint. The requested access is a ceiling clamped by the caller's permission on the asset.
+     *
+     * @param {AthenaIntelligence.CollabTokenRequest} request
+     * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.assets.createCollabToken({
+     *         asset_id: "asset_id"
+     *     })
+     */
+    createCollabToken(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createCollabToken(request, requestOptions));
+    }
+    __createCollabToken(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, _body = __rest(request, ["asset_id"]);
+            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/assets/${core.url.encodePathParam(assetId)}/collab-token`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: _body,
+                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 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/assets/{asset_id}/collab-token.");
+                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.
      * @throws {@link AthenaIntelligence.BadRequestError}

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

@@ -0,0 +1,19 @@
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_id"
+ *     }
+ */
+export interface CollabTokenRequest {
+    asset_id: string;
+    /** Requested access ceiling. This is a ceiling, not a grant: 'edit' is clamped to read-only unless the caller has edit permission on the asset. */
+    access?: CollabTokenRequest.Access;
+}
+export declare namespace CollabTokenRequest {
+    /** Requested access ceiling. This is a ceiling, not a grant: 'edit' is clamped to read-only unless the caller has edit permission on the asset. */
+    const Access: {
+        readonly View: "view";
+        readonly Edit: "edit";
+    };
+    type Access = (typeof Access)[keyof typeof Access];
+}

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

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+export var CollabTokenRequest;
+(function (CollabTokenRequest) {
+    /** Requested access ceiling. This is a ceiling, not a grant: 'edit' is clamped to read-only unless the caller has edit permission on the asset. */
+    CollabTokenRequest.Access = {
+        View: "view",
+        Edit: "edit",
+    };
+})(CollabTokenRequest || (CollabTokenRequest = {}));

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

@@ -1,5 +1,6 @@
 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 { CreateAssetRequestIn } from "./CreateAssetRequestIn.mjs";
 export type { CreateProjectRequestIn } from "./CreateProjectRequestIn.mjs";

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

@@ -0,0 +1,26 @@
+export interface CollabTokenResponse {
+    /** Granted access: r = read + live subscribe, rw = read-write. */
+    access_type: CollabTokenResponse.AccessType;
+    /** Document branch. */
+    branch?: string;
+    /** Keryx document id within the org. */
+    doc_id: string;
+    /** Token expiry in epoch milliseconds. Re-mint before this passes; the @athenaintel/react collab client does so automatically. */
+    expires_at_ms: number;
+    /** Keryx org (room namespace) for the document. */
+    org: string;
+    /** REST base URL. Endpoints follow {rest_url}/{name}/v1/{org}/{doc_id} (ydoc, activity, changeset). */
+    rest_url: string;
+    /** Keryx capability token (yauth). Pass as the yauth query parameter on the WebSocket upgrade and REST requests. Room-bound: valid only for this asset's document. */
+    token: string;
+    /** WebSocket base URL. Connect to {ws_url}/{org}/{doc_id}?yauth={token}. */
+    ws_url: string;
+}
+export declare namespace CollabTokenResponse {
+    /** Granted access: r = read + live subscribe, rw = read-write. */
+    const AccessType: {
+        readonly R: "r";
+        readonly Rw: "rw";
+    };
+    type AccessType = (typeof AccessType)[keyof typeof AccessType];
+}

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

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+export var CollabTokenResponse;
+(function (CollabTokenResponse) {
+    /** Granted access: r = read + live subscribe, rw = read-write. */
+    CollabTokenResponse.AccessType = {
+        R: "r",
+        Rw: "rw",
+    };
+})(CollabTokenResponse || (CollabTokenResponse = {}));

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

@@ -5,5 +5,6 @@ export declare const CreatableAssetType: {
     readonly Folder: "folder";
     readonly Database: "database";
     readonly Computer: "computer";
+    readonly GenericDoc: "generic_doc";
 };
 export type CreatableAssetType = (typeof CreatableAssetType)[keyof typeof CreatableAssetType];

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

@@ -6,4 +6,5 @@ export const CreatableAssetType = {
     Folder: "folder",
     Database: "database",
     Computer: "computer",
+    GenericDoc: "generic_doc",
 };

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

@@ -28,6 +28,7 @@ export * from "./Chunk.mjs";
 export * from "./ChunkContentItem.mjs";
 export * from "./ChunkResult.mjs";
 export * from "./CollabAgentSendMessageResponseOut.mjs";
+export * from "./CollabTokenResponse.mjs";
 export * from "./ConversationAssetInfo.mjs";
 export * from "./ConversationMessage.mjs";
 export * from "./ConversationResult.mjs";

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

@@ -28,6 +28,7 @@ export * from "./Chunk.mjs";
 export * from "./ChunkContentItem.mjs";
 export * from "./ChunkResult.mjs";
 export * from "./CollabAgentSendMessageResponseOut.mjs";
+export * from "./CollabTokenResponse.mjs";
 export * from "./ConversationAssetInfo.mjs";
 export * from "./ConversationMessage.mjs";
 export * from "./ConversationResult.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2141";
+export declare const SDK_VERSION = "4.3.2142";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "4.3.2141";
+export const SDK_VERSION = "4.3.2142";

package/package.json

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

package/reference.md

@@ -568,7 +568,7 @@ await client.assets.convertExcelToSheet({
 <dl>
 <dd>
 
-Create a new asset such as a spreadsheet, document, folder, database, or computer in your workspace. This endpoint uses internal GraphQL mutations to create assets with proper permissions and workspace integration. Computer assets return 202 after the initializing asset is committed; runtime provisioning continues asynchronously.
+Create a new asset such as a spreadsheet, document, folder, database, computer, or generic doc (admin-only) in your workspace. This endpoint uses internal GraphQL mutations to create assets with proper permissions and workspace integration. Computer assets return 202 after the initializing asset is committed; runtime provisioning continues asynchronously.
 </dd>
 </dl>
 </dd>
@@ -1162,6 +1162,71 @@ await client.assets.archive({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.assets.<a href="/src/api/resources/assets/client/Client.ts">createCollabToken</a>({ ...params }) -> AthenaIntelligence.CollabTokenResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Admin only. Mint a short-lived Keryx capability token for a Generic Doc asset, enabling live collaborative reads (and, with edit permission, writes) over WebSocket and REST. Only generic_doc assets are eligible — Athena-managed asset types are never reachable through this endpoint. The requested access is a ceiling clamped by the caller's permission on the asset.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.assets.createCollabToken({
+    asset_id: "asset_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.CollabTokenRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AssetsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>